folder in summary

frontend/src/folders/FolderManagerContext.tsx

@@ -0,0 +1,59 @@
+import React, { createContext, useContext, useMemo, type ReactNode } from 'react';
+import { DEFAULT_FOLDER_NAME } from '../app/appLayoutUtils';
+
+type FolderId = string | null;
+
+export interface FolderManager {
+  getNameSync: (folderId: FolderId) => string | null;
+  resolveName: (folderId: FolderId) => Promise<string>;
+}
+
+const defaultManager: FolderManager = {
+  getNameSync: (folderId) => (folderId == null ? DEFAULT_FOLDER_NAME : `Folder ${folderId}`),
+  resolveName: async (folderId) => (folderId == null ? DEFAULT_FOLDER_NAME : `Folder ${folderId}`),
+};
+
+const FolderManagerContext = createContext<FolderManager>(defaultManager);
+
+interface FolderManagerProviderProps {
+  folderNodes?: Map<string | 'root', { name?: string | null }>;
+  ensureFolderData?: (folderId: string | 'root', options?: { force?: boolean; includeDocuments?: boolean }) => Promise<void>;
+  children: ReactNode;
+}
+
+export const FolderManagerProvider: React.FC<FolderManagerProviderProps> = ({
+  folderNodes,
+  ensureFolderData,
+  children,
+}) => {
+  const value = useMemo<FolderManager>(() => {
+    if (!folderNodes || !ensureFolderData) {
+      return defaultManager;
+    }
+
+    const getNameSync = (folderId: FolderId) => {
+      if (folderId == null) return DEFAULT_FOLDER_NAME;
+      return folderNodes.get(folderId)?.name ?? null;
+    };
+
+    const resolveName = async (folderId: FolderId) => {
+      const cached = getNameSync(folderId);
+      if (cached) return cached;
+      if (folderId == null) return DEFAULT_FOLDER_NAME;
+      await ensureFolderData(folderId, { includeDocuments: false });
+      return getNameSync(folderId) ?? `Folder ${folderId}`;
+    };
+
+    return { getNameSync, resolveName };
+  }, [folderNodes, ensureFolderData]);
+
+  return (
+    <FolderManagerContext.Provider value={value}>
+      {children}
+    </FolderManagerContext.Provider>
+  );
+};
+
+export const useFolderManager = (): FolderManager => useContext(FolderManagerContext);
+
+export default FolderManagerContext;