typescript

2025-11-13 01:07:55 +01:00
parent b812d748ea
commit ada089c05b
147 changed files with 7427 additions and 2534 deletions
@@ -1,5 +1,36 @@
 import { useCallback } from 'react';

+export type Identifier = string | number;
+
+type ApiClient = {
+  post: <T = { data: unknown }>(url: string, payload: unknown) => Promise<{ data: T } | T>;
+  delete: (url: string) => Promise<unknown>;
+};
+
+type BulkAssignmentResponse = {
+  assigned?: number;
+  removed?: number;
+};
+
+type CorrespondentAssignment = {
+  correspondent_id?: Identifier;
+};
+
+interface UseBulkDocumentActionsArgs {
+  api: ApiClient;
+  resolveTargetDocumentIds: (ids?: Identifier[] | null) => Identifier[];
+  correspondentLookupByName: Map<string, { id?: Identifier }>;
+  handleCorrespondentCreate: (payload: { name: string }) => Promise<{ id?: Identifier } | null>;
+  refreshCurrentFolder: () => Promise<void> | void;
+  setStatusMessage: (message: string, variant?: string) => void;
+  selectedDocumentIds?: Identifier[];
+  selectedFolderIds?: Identifier[];
+  handleDocumentsDelete: (ids: Identifier[], options?: { showMessage?: boolean; manageLoading?: boolean }) => Promise<boolean>;
+  handleFolderDelete: (id: Identifier, options?: { showMessage?: boolean; manageLoading?: boolean }) => Promise<boolean>;
+  clearDocumentSelection: () => void;
+  setLoading: (value: boolean) => void;
+}
+
 const useBulkDocumentActions = ({
  api,
  resolveTargetDocumentIds,
@@ -13,9 +44,9 @@ const useBulkDocumentActions = ({
  handleFolderDelete,
  clearDocumentSelection,
  setLoading,
-}) => {
+}: UseBulkDocumentActionsArgs) => {
  const handleBulkCorrespondentAdd = useCallback(
-    async ({ name, input, documentIds }) => {
+    async ({ name, input, documentIds }: { name?: string; input?: HTMLInputElement | null; documentIds?: Identifier[] }) => {
      const trimmed = name?.trim?.() || '';
      if (!trimmed) {
        setStatusMessage('Correspondent name is required.', 'error');
@@ -41,7 +72,7 @@ const useBulkDocumentActions = ({
        return;
      }

-      const response = await api.post('/documents/bulk/correspondents', {
+      const response = await api.post<BulkAssignmentResponse>('/documents/bulk/correspondents', {
        document_ids: targets,
        assignments: [
          {
@@ -51,7 +82,7 @@ const useBulkDocumentActions = ({
        action: 'add',
      });

-      const { assigned = 0, removed = 0 } = response.data || {};
+      const { assigned = 0, removed = 0 } = 'data' in response ? response.data : response;

      await refreshCurrentFolder();
      const assignedSuffix = assigned === 1 ? '' : 's';
@@ -83,7 +114,7 @@ const useBulkDocumentActions = ({
  );

  const handleBulkCorrespondentRemove = useCallback(
-    async ({ assignments = [], documentIds }) => {
+    async ({ assignments = [], documentIds }: { assignments?: CorrespondentAssignment[]; documentIds?: Identifier[] }) => {
      if (!assignments.length) {
        setStatusMessage('Select a correspondent to remove.', 'error');
        return;
@@ -100,13 +131,13 @@ const useBulkDocumentActions = ({
        correspondent_id: entry.correspondent_id,
      }));

-      const response = await api.post('/documents/bulk/correspondents', {
+      const response = await api.post<BulkAssignmentResponse>('/documents/bulk/correspondents', {
        document_ids: targets,
        assignments: normalizedAssignments,
        action: 'remove',
      });

-      const { assigned = 0, removed = 0 } = response.data || {};
+      const { assigned = 0, removed = 0 } = 'data' in response ? response.data : response;
      await refreshCurrentFolder();

      if (removed > 0) {
@@ -1,176 +0,0 @@
-import { useMemo } from 'react';
-
-const useDocumentsPanelProps = ({
-  currentFolderName,
-  breadcrumbs,
-  refreshCurrentFolder,
-  currentSubfolders,
-  documents,
-  searchResults,
-  isFilterActive,
-  folderClickHandlers,
-  selectFolder,
-  handleFolderDragStart,
-  handleFolderDragEnd,
-  draggedFolderId,
-  handleFolderRename,
-  openDocumentPreview,
-  handleDocumentTitleUpdate,
-  selectedDocumentIds,
-  selectedFolderIds,
-  focusedRowKey,
-  draggedDocumentIds,
-  handleDocumentDragStart,
-  handleDocumentDragEnd,
-  searchLoading,
-  tagLookupById,
-  activeCorrespondentFilters,
-  selectedEntries,
-  setFocusedRowKey,
-  ensureAssetUrl,
-  getDocumentAsset,
-  toggleTagFilter,
-  toggleCorrespondentFilter,
-  handleDocumentTagDrop,
-  documentsViewMode,
-  documentsSortField,
-  documentsSortDirection,
-  handleDocumentsSortFieldChange,
-  handleDocumentsSortDirectionToggle,
-  searchIncludeDescendants,
-  toggleSearchIncludeDescendants,
-  handleDocumentsViewModeChange,
-  clearDocumentSelection,
-  handleDeleteSelection,
-  handleEntryPointerCore,
-  inspectDocument,
-  handleEntrySelection,
-  tags,
-  correspondents,
-  documentLookup,
-  handleBulkTagAddFromDetail,
-  handleBulkTagRemoveFromDetail,
-  handleBulkCorrespondentAdd,
-  handleBulkCorrespondentRemove,
-  handleBulkSelectionReanalyze,
-  folderOptions,
-  moveDocumentsToFolder,
-}) =>
-  useMemo(
-    () => ({
-      currentFolderName,
-      breadcrumbs,
-      onRefresh: refreshCurrentFolder,
-      subfolders: currentSubfolders,
-      documents,
-      searchResults,
-      isFilterActive,
-      onFolderSelect: selectFolder,
-      onFolderDrop: folderClickHandlers.onDrop,
-      onFolderDragOver: folderClickHandlers.onDragOver,
-      onFolderDragLeave: folderClickHandlers.onDragLeave,
-      onFolderDragStart: handleFolderDragStart,
-      onFolderDragEnd: handleFolderDragEnd,
-      draggedFolderId,
-      onFolderRename: handleFolderRename,
-      onDocumentOpen: openDocumentPreview,
-      onDocumentRename: handleDocumentTitleUpdate,
-      selectedDocumentIds,
-      selectedFolderIds,
-      focusedRowKey,
-      draggingDocumentIds: draggedDocumentIds,
-      onDocumentDragStart: handleDocumentDragStart,
-      onDocumentDragEnd: handleDocumentDragEnd,
-      isSearchLoading: searchLoading,
-      tagLookupById,
-      activeCorrespondentIds: activeCorrespondentFilters,
-      selectedEntries,
-      onFocusedRowChange: setFocusedRowKey,
-      ensureAssetUrl,
-      getDocumentAsset,
-      onTagClick: toggleTagFilter,
-      onCorrespondentClick: toggleCorrespondentFilter,
-      onDocumentTagDrop: handleDocumentTagDrop,
-      viewMode: documentsViewMode,
-      sortField: documentsSortField,
-      sortDirection: documentsSortDirection,
-      onSortFieldChange: handleDocumentsSortFieldChange,
-      onSortDirectionToggle: handleDocumentsSortDirectionToggle,
-      searchIncludeDescendants,
-      onToggleSearchIncludeDescendants: toggleSearchIncludeDescendants,
-      onViewModeChange: handleDocumentsViewModeChange,
-      onClearSelection: clearDocumentSelection,
-      onDeleteSelection: handleDeleteSelection,
-      onEntryPointer: handleEntryPointerCore,
-      onInspectDocument: inspectDocument,
-      onEntrySelection: handleEntrySelection,
-      tags,
-      correspondents,
-      documentLookup,
-      onBulkTagAdd: handleBulkTagAddFromDetail,
-      onBulkTagRemove: handleBulkTagRemoveFromDetail,
-      onBulkCorrespondentAdd: handleBulkCorrespondentAdd,
-      onBulkCorrespondentRemove: handleBulkCorrespondentRemove,
-      onBulkReanalyze: handleBulkSelectionReanalyze,
-      folderOptions,
-      onMoveDocumentsToFolder: moveDocumentsToFolder,
-    }),
-    [
-      activeCorrespondentFilters,
-      breadcrumbs,
-      clearDocumentSelection,
-      correspondents,
-      currentFolderName,
-      currentSubfolders,
-      documents,
-      documentsSortDirection,
-      documentsSortField,
-      documentsViewMode,
-      documentLookup,
-      draggedDocumentIds,
-      draggedFolderId,
-      focusedRowKey,
-      folderClickHandlers,
-      handleBulkCorrespondentAdd,
-      handleBulkCorrespondentRemove,
-      handleBulkSelectionReanalyze,
-      handleBulkTagAddFromDetail,
-      handleBulkTagRemoveFromDetail,
-      handleDeleteSelection,
-      handleDocumentDragEnd,
-      handleDocumentDragStart,
-      handleDocumentTagDrop,
-      handleDocumentTitleUpdate,
-      handleDocumentsSortDirectionToggle,
-      handleDocumentsSortFieldChange,
-      handleDocumentsViewModeChange,
-      handleEntryPointerCore,
-      handleEntrySelection,
-      handleFolderDragEnd,
-      handleFolderDragStart,
-      handleFolderRename,
-      inspectDocument,
-      isFilterActive,
-      moveDocumentsToFolder,
-      openDocumentPreview,
-      refreshCurrentFolder,
-      searchIncludeDescendants,
-      searchLoading,
-      searchResults,
-      selectedDocumentIds,
-      selectedEntries,
-      selectedFolderIds,
-      selectFolder,
-      setFocusedRowKey,
-      tagLookupById,
-      tags,
-      toggleCorrespondentFilter,
-      toggleSearchIncludeDescendants,
-      toggleTagFilter,
-      ensureAssetUrl,
-      getDocumentAsset,
-      folderOptions,
-    ],
-  );
-
-export default useDocumentsPanelProps;
@@ -0,0 +1,253 @@
+import { useMemo } from 'react';
+
+type Identifier = string | number;
+
+export interface Breadcrumb {
+  id?: Identifier;
+  name?: string;
+  label?: string;
+  title?: string;
+}
+
+export interface FolderClickHandlers {
+  onDrop?: (...args: unknown[]) => void;
+  onDragOver?: (...args: unknown[]) => void;
+  onDragLeave?: (...args: unknown[]) => void;
+}
+
+export interface UseDocumentsPanelPropsArgs {
+  currentFolderName?: string | null;
+  breadcrumbs?: Breadcrumb[];
+  refreshCurrentFolder?: () => void | Promise<void>;
+  currentSubfolders?: unknown[];
+  documents?: unknown[];
+  searchResults?: unknown[] | null;
+  isFilterActive?: boolean;
+  folderClickHandlers: FolderClickHandlers;
+  selectFolder?: (...args: unknown[]) => void;
+  handleFolderDragStart?: (...args: unknown[]) => void;
+  handleFolderDragEnd?: (...args: unknown[]) => void;
+  draggedFolderId?: Identifier | null;
+  handleFolderRename?: (...args: unknown[]) => void;
+  openDocumentPreview?: (...args: unknown[]) => void;
+  handleDocumentTitleUpdate?: (...args: unknown[]) => void;
+  selectedDocumentIds?: Identifier[];
+  selectedFolderIds?: Identifier[];
+  focusedRowKey?: Identifier | string | null;
+  draggedDocumentIds?: Identifier[];
+  handleDocumentDragStart?: (...args: unknown[]) => void;
+  handleDocumentDragEnd?: (...args: unknown[]) => void;
+  searchLoading?: boolean;
+  tagLookupById?: unknown;
+  activeCorrespondentFilters?: Identifier[];
+  selectedEntries?: unknown[];
+  setFocusedRowKey?: (key: Identifier | string | null) => void;
+  ensureAssetUrl?: (...args: unknown[]) => void;
+  getDocumentAsset?: (...args: unknown[]) => unknown;
+  toggleTagFilter?: (...args: unknown[]) => void;
+  toggleCorrespondentFilter?: (...args: unknown[]) => void;
+  handleDocumentTagDrop?: (...args: unknown[]) => void;
+  documentsViewMode?: string;
+  documentsSortField?: string;
+  documentsSortDirection?: string;
+  handleDocumentsSortFieldChange?: (field: string) => void;
+  handleDocumentsSortDirectionToggle?: () => void;
+  searchIncludeDescendants?: boolean;
+  toggleSearchIncludeDescendants?: () => void;
+  handleDocumentsViewModeChange?: (mode: string) => void;
+  clearDocumentSelection?: () => void;
+  handleDeleteSelection?: () => void;
+  handleEntryPointerCore?: (...args: unknown[]) => void;
+  inspectDocument?: (...args: unknown[]) => void;
+  handleEntrySelection?: (...args: unknown[]) => void;
+  tags?: unknown[];
+  correspondents?: unknown[];
+  documentLookup?: unknown;
+  handleBulkTagAddFromDetail?: (...args: unknown[]) => void;
+  handleBulkTagRemoveFromDetail?: (...args: unknown[]) => void;
+  handleBulkCorrespondentAdd?: (...args: unknown[]) => void;
+  handleBulkCorrespondentRemove?: (...args: unknown[]) => void;
+  handleBulkSelectionReanalyze?: (...args: unknown[]) => void;
+  folderOptions?: unknown[];
+  moveDocumentsToFolder?: (...args: unknown[]) => void;
+}
+
+export type DocumentsPanelProps = ReturnType<typeof useDocumentsPanelProps>;
+
+const useDocumentsPanelProps = (props: UseDocumentsPanelPropsArgs) => {
+  const {
+    currentFolderName,
+    breadcrumbs,
+    refreshCurrentFolder,
+    currentSubfolders,
+    documents,
+    searchResults,
+    isFilterActive,
+    folderClickHandlers,
+    selectFolder,
+    handleFolderDragStart,
+    handleFolderDragEnd,
+    draggedFolderId,
+    handleFolderRename,
+    openDocumentPreview,
+    handleDocumentTitleUpdate,
+    selectedDocumentIds,
+    selectedFolderIds,
+    focusedRowKey,
+    draggedDocumentIds,
+    handleDocumentDragStart,
+    handleDocumentDragEnd,
+    searchLoading,
+    tagLookupById,
+    activeCorrespondentFilters,
+    selectedEntries,
+    setFocusedRowKey,
+    ensureAssetUrl,
+    getDocumentAsset,
+    toggleTagFilter,
+    toggleCorrespondentFilter,
+    handleDocumentTagDrop,
+    documentsViewMode,
+    documentsSortField,
+    documentsSortDirection,
+    handleDocumentsSortFieldChange,
+    handleDocumentsSortDirectionToggle,
+    searchIncludeDescendants,
+    toggleSearchIncludeDescendants,
+    handleDocumentsViewModeChange,
+    clearDocumentSelection,
+    handleDeleteSelection,
+    handleEntryPointerCore,
+    inspectDocument,
+    handleEntrySelection,
+    tags,
+    correspondents,
+    documentLookup,
+    handleBulkTagAddFromDetail,
+    handleBulkTagRemoveFromDetail,
+    handleBulkCorrespondentAdd,
+    handleBulkCorrespondentRemove,
+    handleBulkSelectionReanalyze,
+    folderOptions,
+    moveDocumentsToFolder,
+  } = props;
+
+  return useMemo(
+    () => ({
+      currentFolderName,
+      breadcrumbs,
+      onRefresh: refreshCurrentFolder,
+      subfolders: currentSubfolders,
+      documents,
+      searchResults,
+      isFilterActive,
+      onFolderSelect: selectFolder,
+      onFolderDrop: folderClickHandlers.onDrop,
+      onFolderDragOver: folderClickHandlers.onDragOver,
+      onFolderDragLeave: folderClickHandlers.onDragLeave,
+      onFolderDragStart: handleFolderDragStart,
+      onFolderDragEnd: handleFolderDragEnd,
+      draggedFolderId,
+      onFolderRename: handleFolderRename,
+      onDocumentOpen: openDocumentPreview,
+      onDocumentRename: handleDocumentTitleUpdate,
+      selectedDocumentIds,
+      selectedFolderIds,
+      focusedRowKey,
+      draggingDocumentIds: draggedDocumentIds,
+      onDocumentDragStart: handleDocumentDragStart,
+      onDocumentDragEnd: handleDocumentDragEnd,
+      isSearchLoading: searchLoading,
+      tagLookupById,
+      activeCorrespondentIds: activeCorrespondentFilters,
+      selectedEntries,
+      onFocusedRowChange: setFocusedRowKey,
+      ensureAssetUrl,
+      getDocumentAsset,
+      onTagClick: toggleTagFilter,
+      onCorrespondentClick: toggleCorrespondentFilter,
+      onDocumentTagDrop: handleDocumentTagDrop,
+      viewMode: documentsViewMode,
+      sortField: documentsSortField,
+      sortDirection: documentsSortDirection,
+      onSortFieldChange: handleDocumentsSortFieldChange,
+      onSortDirectionToggle: handleDocumentsSortDirectionToggle,
+      searchIncludeDescendants,
+      onToggleSearchIncludeDescendants: toggleSearchIncludeDescendants,
+      onViewModeChange: handleDocumentsViewModeChange,
+      onClearSelection: clearDocumentSelection,
+      onDeleteSelection: handleDeleteSelection,
+      onEntryPointer: handleEntryPointerCore,
+      onInspectDocument: inspectDocument,
+      onEntrySelection: handleEntrySelection,
+      tags,
+      correspondents,
+      documentLookup,
+      onBulkTagAdd: handleBulkTagAddFromDetail,
+      onBulkTagRemove: handleBulkTagRemoveFromDetail,
+      onBulkCorrespondentAdd: handleBulkCorrespondentAdd,
+      onBulkCorrespondentRemove: handleBulkCorrespondentRemove,
+      onBulkReanalyze: handleBulkSelectionReanalyze,
+      folderOptions,
+      onMoveDocumentsToFolder: moveDocumentsToFolder,
+    }),
+    [
+      activeCorrespondentFilters,
+      breadcrumbs,
+      clearDocumentSelection,
+      correspondents,
+      currentFolderName,
+      currentSubfolders,
+      documents,
+      documentsSortDirection,
+      documentsSortField,
+      documentsViewMode,
+      documentLookup,
+      draggedDocumentIds,
+      draggedFolderId,
+      focusedRowKey,
+      folderClickHandlers,
+      handleBulkCorrespondentAdd,
+      handleBulkCorrespondentRemove,
+      handleBulkSelectionReanalyze,
+      handleBulkTagAddFromDetail,
+      handleBulkTagRemoveFromDetail,
+      handleDeleteSelection,
+      handleDocumentDragEnd,
+      handleDocumentDragStart,
+      handleDocumentTagDrop,
+      handleDocumentTitleUpdate,
+      handleDocumentsSortDirectionToggle,
+      handleDocumentsSortFieldChange,
+      handleDocumentsViewModeChange,
+      handleEntryPointerCore,
+      handleEntrySelection,
+      handleFolderDragEnd,
+      handleFolderDragStart,
+      handleFolderRename,
+      inspectDocument,
+      isFilterActive,
+      moveDocumentsToFolder,
+      openDocumentPreview,
+      refreshCurrentFolder,
+      searchIncludeDescendants,
+      searchLoading,
+      searchResults,
+      selectedDocumentIds,
+      selectedEntries,
+      selectedFolderIds,
+      selectFolder,
+      setFocusedRowKey,
+      tagLookupById,
+      tags,
+      toggleCorrespondentFilter,
+      toggleSearchIncludeDescendants,
+      toggleTagFilter,
+      ensureAssetUrl,
+      getDocumentAsset,
+      folderOptions,
+    ],
+  );
+};
+
+export default useDocumentsPanelProps;
@@ -1,5 +1,41 @@
 import { useCallback, useEffect, useMemo, useRef } from 'react';

+interface FolderEntry {
+  id: string | number;
+  [key: string]: unknown;
+}
+
+interface DocumentEntry {
+  id: string | number;
+  [key: string]: unknown;
+}
+
+interface NavigableRow {
+  key: string;
+  type: 'folder' | 'document';
+  id: string | number;
+}
+
+interface UseDocumentsSelectionOptions {
+  showingSearchResults: boolean;
+  currentSubfolders: FolderEntry[];
+  visibleDocuments: DocumentEntry[];
+  resolveFolderRowKey: (id: string | number) => string | null | undefined;
+  resolveDocumentRowKey: (id: string | number) => string | null | undefined;
+  configureSelectionEnvironment: (config: { visibleRowKeySet: Set<string>; navigableRowKeys: string[] }) => void;
+  visibleRowKeySet: Set<string>;
+  selectedEntries: string[];
+  selectionAnchorRef: { current: string | null };
+  promoteSelectionOrderRaw: (id: string | number) => void;
+  setFocusedDocumentId: (id: string | number | null) => void;
+  setActivePreviewId: (id: string | number | null) => void;
+  clearSelection: () => void;
+  focusedDocumentId: string | number | null;
+  setFocusedRowKey: (value: string | null | ((current: string | null) => string | null)) => void;
+  focusedRowKey: string | null;
+  isFolderRowKey: (key: string | null) => boolean;
+}
+
 const useDocumentsSelection = ({
  showingSearchResults,
  currentSubfolders,
@@ -18,9 +54,9 @@ const useDocumentsSelection = ({
  setFocusedRowKey,
  focusedRowKey,
  isFolderRowKey,
-}) => {
-  const navigableRows = useMemo(() => {
-    const entries = [];
+}: UseDocumentsSelectionOptions) => {
+  const navigableRows = useMemo<NavigableRow[]>(() => {
+    const entries: NavigableRow[] = [];
    if (!showingSearchResults) {
      currentSubfolders.forEach((folder) => {
        const key = resolveFolderRowKey(folder.id);
@@ -51,7 +87,7 @@ const useDocumentsSelection = ({
  }, [configureSelectionEnvironment, visibleRowKeySet, navigableRowKeys]);

  const promoteSelectionOrder = useCallback(
-    (docId) => {
+    (docId: string | number | null) => {
      if (!docId) return;
      promoteSelectionOrderRaw(docId);
      const rowKey = resolveDocumentRowKey(docId);
@@ -68,7 +104,7 @@ const useDocumentsSelection = ({
    clearSelection();
  }, [clearSelection]);

-  const prevFocusedDocIdRef = useRef(focusedDocumentId);
+  const prevFocusedDocIdRef = useRef<string | number | null>(focusedDocumentId);
  useEffect(() => {
    const previous = prevFocusedDocIdRef.current;
    if (previous === focusedDocumentId) {