Files
tech-log-frontend/src/features/tech-log/presentation/studio/components/asset-library.tsx
T

416 lines
16 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
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>
);
}