refactor: Introduce dedicated Document and Asset types and migrate codebase from DocumentLike.

frontend/src/detail/useDetailWorkspace.ts

@@ -7,13 +7,7 @@ import { getEntryId, isDocumentEntry } from '../app/entryKey';
 import type { DocumentInfoPanelProps } from '../documents/DocumentInfoPanel';
 import type { EnsureAssetUrl, GetDocumentAsset } from '../utils/ocr';
 import type { Identifier } from '../types/identifiers';
-
-interface DocumentLike {
-  id?: Identifier;
-  folder_id?: Identifier | 'root';
-  title?: string;
-  [key: string]: unknown;
-}
+import type { Document } from '../types/documents';
 
 interface FolderNode {
   id: Identifier | 'root';
@@ -22,10 +16,10 @@ interface FolderNode {
 }
 
 interface UseDetailWorkspaceArgs {
-  documents: DocumentLike[];
+  documents: Document[];
   selectionOrder: string[];
   selectedDocumentIds: Identifier[];
-  documentLookup: Map<Identifier, DocumentLike>;
+  documentLookup: Map<Identifier, Document>;
   folderNodes: Map<Identifier | 'root', FolderNode>;
   ensureFolderData: (folderId: Identifier | 'root', options?: { force?: boolean; includeDocuments?: boolean }) => Promise<void>;
   detailPanelControlRef: MutableRefObject<{ open?: (args?: { documentIds?: Identifier[] }) => void; close?: () => void } | null>;
@@ -35,7 +29,7 @@ interface UseDetailWorkspaceArgs {
   openDocumentPreview?: (args: { documentIds: Identifier[] }) => void;
   handleDocumentTitleUpdate?: (docId: Identifier, title: string) => Promise<boolean> | boolean;
   handleDocumentIssuedUpdate?: (docId: Identifier, issued: number | null) => Promise<boolean> | boolean;
-  handleDocumentTagAdd?: (doc: DocumentLike, value: string, context?: { option?: unknown }) => void;
+  handleDocumentTagAdd?: (doc: Document, value: string, context?: { option?: unknown }) => void;
   handleTagRemove?: (...args: unknown[]) => void;
   ensureAssetUrl?: EnsureAssetUrl;
   getDocumentAsset?: GetDocumentAsset;
@@ -55,8 +49,8 @@ interface UseDetailWorkspaceResult {
   handleDetailPanelClose: () => void;
   inspectDocument: (docId: Identifier | null) => void;
   previewActive: boolean;
-  previewWorkspaceDocument: DocumentLike | null;
-  resolveThumbnailUrlForDoc: (doc: DocumentLike | null) => string | null;
+  previewWorkspaceDocument: Document | null;
+  resolveThumbnailUrlForDoc: (doc: Document | null) => string | null;
   resolveFolderPath: (folderId?: Identifier | 'root') => Array<{ id: Identifier | 'root'; name: string }>;
 }