416 lines
16 KiB
TypeScript
416 lines
16 KiB
TypeScript
import { useTechLogCopy } from "../studio-copy.ts";
|
||
import { studioRoutes } from "../studio-routes.ts";
|
||
import { DestructiveConfirmDialog } from "./destructive-confirm-dialog.tsx";
|
||
import { useAssetLibraryController } from "../controllers/use-asset-library-controller.ts";
|
||
|
||
import type { Asset, AssetDetail } from "../../../contracts/studio/contract.ts";
|
||
|
||
type AssetKind = Asset["kind"];
|
||
import {
|
||
Button,
|
||
Checkbox,
|
||
SearchFilterToolbar,
|
||
Select,
|
||
TextArea,
|
||
TextField,
|
||
} from "../../../../../presentation/design-system/index.ts";
|
||
import { Form } from "../../../../../presentation/forms/index.ts";
|
||
|
||
/** 관리 상태. 화면에 영문 상수가 그대로 나오던 자리다. */
|
||
const ASSET_STATUS_LABELS: Record<Asset["managementStatus"], string> = {
|
||
READY: "사용 가능",
|
||
ARCHIVED: "보관됨",
|
||
REJECTED: "거부됨",
|
||
QUARANTINED: "검사 보류",
|
||
};
|
||
|
||
/** 사람이 고를 때 실제로 보는 사실들 — 무엇이고, 얼마나 크고, 몇 바이트인가. */
|
||
function assetFacts(asset: Asset): string {
|
||
const parts = [asset.mediaType.replace(/^image\//u, "").toUpperCase()];
|
||
// 치수를 모르는 자료가 있다(첨부파일, 처리 중). 모르면 적지 않는다 — 0×0 은 거짓이다.
|
||
if (asset.width && asset.height) parts.push(`${asset.width}×${asset.height}`);
|
||
parts.push(byteLabel(asset.byteSize));
|
||
return parts.join(" · ");
|
||
}
|
||
|
||
function byteLabel(bytes: number): string {
|
||
if (bytes < 1024) return `${bytes} B`;
|
||
if (bytes < 1024 * 1024) return `${Math.round(bytes / 1024)} KB`;
|
||
return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
|
||
}
|
||
|
||
/**
|
||
* 공개 이력이 있거나 사용 중인 Asset은 hard delete하지 않는다. 서버도 같은
|
||
* 규칙으로 `ASSET_IN_USE`를 던지므로 화면은 시도 자체를 막아 왕복을 줄인다.
|
||
*/
|
||
export function canHardDelete(detail: AssetDetail): boolean {
|
||
return (
|
||
!detail.hasPublicationHistory &&
|
||
detail.usages.length === 0 &&
|
||
detail.asset.usageCount === 0
|
||
);
|
||
}
|
||
|
||
export function AssetLibrary() {
|
||
const copy = useTechLogCopy();
|
||
const {
|
||
assets,
|
||
assetResultCount,
|
||
altDraft,
|
||
archive,
|
||
closeDetail,
|
||
confirmDelete,
|
||
decorativeDraft,
|
||
detailHeadingRef,
|
||
kindFilter,
|
||
listStatus,
|
||
loadMore,
|
||
morePending,
|
||
nextCursor,
|
||
notice,
|
||
openDetail,
|
||
pageHeadingRef,
|
||
pending,
|
||
q,
|
||
remove,
|
||
resetFilters,
|
||
rowRefs,
|
||
saveAltText,
|
||
searchDraft,
|
||
selected,
|
||
setAltDraft,
|
||
setConfirmDelete,
|
||
setDecorativeDraft,
|
||
setKindFilter,
|
||
setSearchDraft,
|
||
setUsageFilter,
|
||
submitSearch,
|
||
usageFilter,
|
||
visibleAssets,
|
||
} = useAssetLibraryController();
|
||
|
||
return (
|
||
<div className="studio-page studio-assets-page">
|
||
<header className="studio-page-heading">
|
||
<p className="studio-eyebrow">ASSET LIBRARY</p>
|
||
<h1 ref={pageHeadingRef} tabIndex={-1}>Asset</h1>
|
||
<p>
|
||
업로드한 Asset을 검색하고 사용처를 확인하며, 사용하지 않는 Asset을
|
||
정리합니다.
|
||
</p>
|
||
</header>
|
||
|
||
<SearchFilterToolbar
|
||
className="studio-asset-tools"
|
||
label="Asset 검색 도구"
|
||
onReset={resetFilters}
|
||
resetLabel={copy("techLog.action.resetFilters")}
|
||
resultCount={assetResultCount}
|
||
search={
|
||
<Form pending={false} role="search" onSubmit={submitSearch}>
|
||
<div className="studio-asset-search">
|
||
<TextField
|
||
className="studio-tool-field"
|
||
label="Asset 검색"
|
||
placeholder="Asset 키, 파일 이름"
|
||
type="search"
|
||
value={searchDraft}
|
||
onChange={(event) => setSearchDraft(event.currentTarget.value)}
|
||
/>
|
||
<Button type="submit" variant="ghost">
|
||
{copy("techLog.action.search")}
|
||
</Button>
|
||
</div>
|
||
</Form>
|
||
}
|
||
filters={
|
||
<div className="studio-asset-filters">
|
||
<Select
|
||
className="studio-tool-field"
|
||
label="종류"
|
||
options={[
|
||
{ value: "", label: "전체" },
|
||
{ value: "IMAGE", label: "이미지" },
|
||
{ value: "DIAGRAM", label: "도식" },
|
||
{ value: "ATTACHMENT", label: "첨부" },
|
||
]}
|
||
value={kindFilter}
|
||
onChange={(event) =>
|
||
setKindFilter(event.currentTarget.value as AssetKind | "")
|
||
}
|
||
/>
|
||
<Select
|
||
className="studio-tool-field"
|
||
description={
|
||
usageFilter ? "불러온 목록 안에서만 거릅니다." : undefined
|
||
}
|
||
label="쓰임"
|
||
options={[
|
||
{ value: "", label: "전체" },
|
||
{ value: "USED", label: "쓰이는 것" },
|
||
{ value: "UNUSED", label: "쓰이지 않는 것" },
|
||
]}
|
||
value={usageFilter}
|
||
onChange={(event) =>
|
||
setUsageFilter(
|
||
event.currentTarget.value as "" | "USED" | "UNUSED",
|
||
)
|
||
}
|
||
/>
|
||
</div>
|
||
}
|
||
/>
|
||
|
||
{/*
|
||
확인 창이 열려 있는 동안에는 같은 문구를 창 안에서만 말한다. 두 벌이 화면에 남으면 읽는
|
||
사람은 무엇이 방금 일어난 일인지 고르게 된다.
|
||
*/}
|
||
<p role="status" aria-live="polite">
|
||
{confirmDelete ? "" : notice}
|
||
</p>
|
||
|
||
{listStatus === "LOADING" ? (
|
||
<p className="studio-loading" role="status">
|
||
{copy("techLog.state.assetListLoading")}
|
||
</p>
|
||
) : null}
|
||
{listStatus === "ERROR" ? (
|
||
<p className="studio-screen-error" role="alert">
|
||
{copy("techLog.state.assetListLoadFailed")}
|
||
</p>
|
||
) : null}
|
||
{listStatus === "READY" && assets.length === 0 ? (
|
||
<section className="studio-empty-state">
|
||
{q ? (
|
||
<>
|
||
<h2>{copy("techLog.state.emptyAssetSearch")}</h2>
|
||
<p>{copy("techLog.state.emptyAssetSearchHint")}</p>
|
||
</>
|
||
) : (
|
||
<>
|
||
<h2>{copy("techLog.state.emptyAssetLibrary")}</h2>
|
||
<p>{copy("techLog.state.emptyAssetLibraryHint")}</p>
|
||
</>
|
||
)}
|
||
</section>
|
||
) : null}
|
||
|
||
{visibleAssets.length > 0 ? (
|
||
<ul className="asset-library-list">
|
||
{visibleAssets.map((asset) => (
|
||
<li key={asset.id}>
|
||
{/*
|
||
key 만 있던 동안 이 목록은 "무엇을 고르는지" 를 말해 주지 못했다. Asset 이 스무
|
||
개면 key 스무 줄이고, 그중 어느 것이 찾던 도식인지는 눌러 봐야 알았다.
|
||
썸네일은 그 왕복을 없앤다.
|
||
|
||
주소가 없거나(업로드 처리 중) 그림이 아닌 것(첨부파일)에는 자리를 만들지 않는다 —
|
||
빈 상자가 남으면 목록이 어긋나 보인다.
|
||
*/}
|
||
{asset.publicPath && asset.mediaType.startsWith("image/") ? (
|
||
<img src={asset.publicPath} alt="" loading="lazy" />
|
||
) : (
|
||
<span className="asset-library-list__glyph" aria-hidden="true">
|
||
{asset.kind === "ATTACHMENT" ? "파일" : "—"}
|
||
</span>
|
||
)}
|
||
{/*
|
||
사람이 고르는 이름은 파일 이름이다. 목록이 `assetKey` 를 앞세우던 동안 작성자는
|
||
해시 같은 문자열 스무 줄에서 찾던 도식을 눈으로 골라야 했다 — key 는 본문이
|
||
가리키는 불변 식별자이지 사람이 기억하는 이름이 아니다. 이름을 앞에 두고 key 는
|
||
아래에 작게 남긴다.
|
||
*/}
|
||
<Button
|
||
type="button"
|
||
variant="ghost"
|
||
ref={(node) => {
|
||
const rows = rowRefs.current;
|
||
if (node) rows.set(asset.id, node);
|
||
else rows.delete(asset.id);
|
||
}}
|
||
aria-current={selected?.asset.id === asset.id ? "true" : undefined}
|
||
aria-label={asset.originalFilename || asset.assetKey}
|
||
onClick={(event) => openDetail(asset, event.currentTarget)}
|
||
>
|
||
<strong>{asset.originalFilename || asset.assetKey}</strong>
|
||
<small>{assetFacts(asset)}</small>
|
||
<small className="asset-library-list__key">{asset.assetKey}</small>
|
||
</Button>
|
||
<span>{ASSET_STATUS_LABELS[asset.managementStatus]}</span>
|
||
{/*
|
||
쓰이지 않는 자료는 지워도 되는 것이고, 쓰이는 자료는 지우면 화면이 깨진다. 그
|
||
차이가 숫자 하나로만 표시되던 동안 「사용 0건」과 「사용 3건」이 같은 회색으로
|
||
나란했다.
|
||
*/}
|
||
<span className={asset.usageCount === 0 ? "asset-usage asset-usage--none" : "asset-usage"}>
|
||
{asset.usageCount === 0 ? "쓰이지 않음" : `${asset.usageCount}곳에서 사용`}
|
||
</span>
|
||
</li>
|
||
))}
|
||
</ul>
|
||
) : null}
|
||
|
||
{nextCursor && listStatus === "READY" ? (
|
||
<Button
|
||
className="studio-secondary-button"
|
||
type="button"
|
||
disabled={morePending}
|
||
pending={morePending}
|
||
pendingLabel={copy("techLog.action.loading")}
|
||
variant="ghost"
|
||
onClick={loadMore}
|
||
>
|
||
{copy("techLog.action.more")}
|
||
</Button>
|
||
) : null}
|
||
|
||
{selected ? (
|
||
<div
|
||
className="asset-detail"
|
||
aria-label={`${selected.asset.originalFilename || selected.asset.assetKey} 상세`}
|
||
>
|
||
<h2 ref={detailHeadingRef} tabIndex={-1}>
|
||
{selected.asset.originalFilename || selected.asset.assetKey}
|
||
</h2>
|
||
{/*
|
||
큰 그림. 목록의 썸네일은 "이게 그건가"를 가리는 데 쓰고, 여기서는 실제로 무엇이
|
||
그려져 있는지 읽어야 한다 — 바꾸거나 지우기 전에 확인하는 자리다.
|
||
*/}
|
||
{selected.asset.publicPath && selected.asset.mediaType.startsWith("image/") ? (
|
||
<img
|
||
className="asset-detail-preview"
|
||
src={selected.asset.publicPath}
|
||
alt={selected.asset.decorative ? "" : (selected.asset.altText ?? "")}
|
||
/>
|
||
) : null}
|
||
<dl className="asset-detail-facts">
|
||
<div><dt>상태</dt><dd>{ASSET_STATUS_LABELS[selected.asset.managementStatus]}</dd></div>
|
||
<div><dt>파일</dt><dd>{assetFacts(selected.asset)}</dd></div>
|
||
{/* 본문이 가리키는 불변 식별자. 사람이 기억하는 이름이 아니라 복사해 쓰는 값이다. */}
|
||
<div><dt>Key</dt><dd><code>{selected.asset.assetKey}</code></dd></div>
|
||
</dl>
|
||
{/*
|
||
대체 텍스트는 이 자료의 성질이므로 여기서 고친다. 예전에는 업로드할 때 한 번 적고
|
||
끝이라, 나중에 잘못 적은 것을 알아도 고칠 자리가 없었다 — 그 글은 그림을 못 보는
|
||
사람에게는 그림 자체다.
|
||
|
||
설명(caption)은 여기 없다. 같은 그림을 다른 기록에서 다른 말로 설명할 수 있어서
|
||
자료가 아니라 본문이 갖는 값이다(`:::evidence caption=…`).
|
||
*/}
|
||
<Form
|
||
className="asset-detail-alt"
|
||
pending={pending}
|
||
onSubmit={(event) => {
|
||
event.preventDefault();
|
||
void saveAltText();
|
||
}}
|
||
>
|
||
<TextArea
|
||
className="asset-detail-alt-field"
|
||
disabled={pending}
|
||
label="대체 텍스트"
|
||
maxLength={1000}
|
||
rows={2}
|
||
value={altDraft}
|
||
onChange={(event) => setAltDraft(event.currentTarget.value)}
|
||
/>
|
||
<Checkbox
|
||
checked={decorativeDraft}
|
||
disabled={pending}
|
||
fieldClassName="asset-detail-decorative"
|
||
label="장식용입니다 (읽어 줄 내용이 없음)"
|
||
onChange={(event) =>
|
||
setDecorativeDraft(event.currentTarget.checked)
|
||
}
|
||
/>
|
||
<Button
|
||
className="studio-secondary-button"
|
||
disabled={pending}
|
||
pending={pending}
|
||
pendingLabel={copy("techLog.action.savingBeforeNavigate")}
|
||
type="submit"
|
||
variant="ghost"
|
||
>
|
||
{copy("techLog.action.saveAltText")}
|
||
</Button>
|
||
</Form>
|
||
{/*
|
||
바꾸거나 지우기 전에 어디에 쓰이는지 전부 보여야 한다. 숫자만으로는 무엇이 깨질지
|
||
알 수 없다.
|
||
*/}
|
||
<h3 className="asset-detail-usage-title">쓰이는 곳</h3>
|
||
{selected.usages.length > 0 ? (
|
||
<ul>
|
||
{selected.usages.map((usage) => (
|
||
<li key={usage.documentId}>
|
||
{/*
|
||
평범한 링크다. 이 화면은 Studio 컨텍스트를 받지 않고 게이트웨이 하나만 받아
|
||
혼자 설 수 있게 되어 있고, 여기서 떠날 때 지킬 편집 상태도 없다.
|
||
*/}
|
||
<a href={studioRoutes.documentEdit(usage.documentId)}>
|
||
{usage.title || "제목 없는 작업본"}
|
||
</a>
|
||
</li>
|
||
))}
|
||
</ul>
|
||
) : (
|
||
<p>아직 어느 기록도 이 자료를 쓰지 않습니다.</p>
|
||
)}
|
||
{/*
|
||
쓰이는 자료를 지우면 그 기록들의 그림 자리가 통째로 빈다. 지우기 전에 무엇이 깨질지
|
||
수가 아니라 이름으로 보여야 한다 — 위의 「쓰이는 곳」이 그 목록이고, 여기서는 그
|
||
사실을 동작 옆에 한 번 더 못 박는다.
|
||
*/}
|
||
{selected.usages.length > 0 ? (
|
||
<p className="asset-detail-warning" role="status">
|
||
{`${selected.usages.length}개 기록이 이 자료를 쓰고 있습니다. 지우면 그 자리가 빕니다.`}
|
||
</p>
|
||
) : null}
|
||
<div className="asset-detail-actions">
|
||
{/*
|
||
삭제는 되돌릴 수 없다. 보관은 목록에서 내리는 것뿐이라 묻지 않는다 — 둘을 같은
|
||
무게로 다루면 확인 창이 곧 습관이 되어 진짜 삭제도 그냥 지나간다.
|
||
*/}
|
||
{canHardDelete(selected) ? (
|
||
<Button
|
||
type="button"
|
||
disabled={pending}
|
||
variant="ghost"
|
||
onClick={() => setConfirmDelete(true)}
|
||
>
|
||
{copy("techLog.action.delete")}
|
||
</Button>
|
||
) : (
|
||
<Button
|
||
type="button"
|
||
disabled={pending}
|
||
variant="ghost"
|
||
onClick={() => void archive(selected)}
|
||
>
|
||
{copy("techLog.action.archive")}
|
||
</Button>
|
||
)}
|
||
<Button type="button" variant="ghost" onClick={closeDetail}>
|
||
{copy("techLog.action.close")}
|
||
</Button>
|
||
</div>
|
||
</div>
|
||
) : null}
|
||
<DestructiveConfirmDialog
|
||
open={confirmDelete && selected !== null}
|
||
pending={pending}
|
||
title="Asset을 삭제합니다"
|
||
targetName={selected?.asset.assetKey ?? ""}
|
||
description="본문이 이 key로 가리키던 그림 자리는 빈 채로 남습니다."
|
||
// 닫혀 있을 때도 children 은 DOM 에 남는다. 화면의 알림과 같은 문구가 두 벌 생기지
|
||
// 않도록 열려 있을 때만 넘긴다.
|
||
error={confirmDelete ? notice : ""}
|
||
onCancel={() => setConfirmDelete(false)}
|
||
onConfirm={() => {
|
||
if (selected) void remove(selected);
|
||
}}
|
||
/>
|
||
</div>
|
||
);
|
||
}
|