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 = { 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 (

ASSET LIBRARY

Asset

업로드한 Asset을 검색하고 사용처를 확인하며, 사용하지 않는 Asset을 정리합니다.

setSearchDraft(event.currentTarget.value)} />
} filters={
setUsageFilter( event.currentTarget.value as "" | "USED" | "UNUSED", ) } />
} /> {/* 확인 창이 열려 있는 동안에는 같은 문구를 창 안에서만 말한다. 두 벌이 화면에 남으면 읽는 사람은 무엇이 방금 일어난 일인지 고르게 된다. */}

{confirmDelete ? "" : notice}

{listStatus === "LOADING" ? (

{copy("techLog.state.assetListLoading")}

) : null} {listStatus === "ERROR" ? (

{copy("techLog.state.assetListLoadFailed")}

) : null} {listStatus === "READY" && assets.length === 0 ? (
{q ? ( <>

{copy("techLog.state.emptyAssetSearch")}

{copy("techLog.state.emptyAssetSearchHint")}

) : ( <>

{copy("techLog.state.emptyAssetLibrary")}

{copy("techLog.state.emptyAssetLibraryHint")}

)}
) : null} {visibleAssets.length > 0 ? (
    {visibleAssets.map((asset) => (
  • {/* key 만 있던 동안 이 목록은 "무엇을 고르는지" 를 말해 주지 못했다. Asset 이 스무 개면 key 스무 줄이고, 그중 어느 것이 찾던 도식인지는 눌러 봐야 알았다. 썸네일은 그 왕복을 없앤다. 주소가 없거나(업로드 처리 중) 그림이 아닌 것(첨부파일)에는 자리를 만들지 않는다 — 빈 상자가 남으면 목록이 어긋나 보인다. */} {asset.publicPath && asset.mediaType.startsWith("image/") ? ( ) : ( )} {/* 사람이 고르는 이름은 파일 이름이다. 목록이 `assetKey` 를 앞세우던 동안 작성자는 해시 같은 문자열 스무 줄에서 찾던 도식을 눈으로 골라야 했다 — key 는 본문이 가리키는 불변 식별자이지 사람이 기억하는 이름이 아니다. 이름을 앞에 두고 key 는 아래에 작게 남긴다. */} {ASSET_STATUS_LABELS[asset.managementStatus]} {/* 쓰이지 않는 자료는 지워도 되는 것이고, 쓰이는 자료는 지우면 화면이 깨진다. 그 차이가 숫자 하나로만 표시되던 동안 「사용 0건」과 「사용 3건」이 같은 회색으로 나란했다. */} {asset.usageCount === 0 ? "쓰이지 않음" : `${asset.usageCount}곳에서 사용`}
  • ))}
) : null} {nextCursor && listStatus === "READY" ? ( ) : null} {selected ? (

{selected.asset.originalFilename || selected.asset.assetKey}

{/* 큰 그림. 목록의 썸네일은 "이게 그건가"를 가리는 데 쓰고, 여기서는 실제로 무엇이 그려져 있는지 읽어야 한다 — 바꾸거나 지우기 전에 확인하는 자리다. */} {selected.asset.publicPath && selected.asset.mediaType.startsWith("image/") ? ( {selected.asset.decorative ) : null}
상태
{ASSET_STATUS_LABELS[selected.asset.managementStatus]}
파일
{assetFacts(selected.asset)}
{/* 본문이 가리키는 불변 식별자. 사람이 기억하는 이름이 아니라 복사해 쓰는 값이다. */}
Key
{selected.asset.assetKey}
{/* 대체 텍스트는 이 자료의 성질이므로 여기서 고친다. 예전에는 업로드할 때 한 번 적고 끝이라, 나중에 잘못 적은 것을 알아도 고칠 자리가 없었다 — 그 글은 그림을 못 보는 사람에게는 그림 자체다. 설명(caption)은 여기 없다. 같은 그림을 다른 기록에서 다른 말로 설명할 수 있어서 자료가 아니라 본문이 갖는 값이다(`:::evidence caption=…`). */}
{ event.preventDefault(); void saveAltText(); }} >