import { useCallback, type MutableRefObject } from "react"; import { deleteExternalConflictSnapshot, loadExternalConflictSnapshot, persistExternalConflictSnapshot, persistExternalFailureSnapshot, } from "../utils/externalConflictStorage"; import { notifyExternalFileReload } from "./externalFileReloadBus"; import { useExternalFileChangeCoordinator } from "./useExternalFileChangeCoordinator"; import type { useFileManager } from "./useFileManager"; import type { usePreviewPersistence } from "./usePreviewPersistence"; type FileManager = Pick< ReturnType, | "editingFile" | "flushPendingSourceSave" | "discardPendingSourceSave" | "getPendingSourceCandidate" | "overwriteExternalConflict" | "readProjectFile" | "updateEditingFileContent" >; type PreviewPersistence = Pick< ReturnType, "drainPendingDomEditSaves" | "resetDomEditSaveQueueBreaker" >; interface UseStudioExternalFileChangesOptions { projectId: string | null; activeCompPath: string | null; masterCompPath: string | null; fileManager: FileManager; previewPersistence: PreviewPersistence; pendingTimelineEditPathRef: MutableRefObject>; reloadPreview: () => void; } /** Connects the app's save queues, recovery storage, and reload surfaces to one owner. */ export function useStudioExternalFileChanges({ projectId, activeCompPath, masterCompPath, fileManager, previewPersistence, pendingTimelineEditPathRef, reloadPreview, }: UseStudioExternalFileChangesOptions) { const { flushPendingSourceSave, discardPendingSourceSave } = fileManager; const { drainPendingDomEditSaves, resetDomEditSaveQueueBreaker } = previewPersistence; const drainPendingChanges = useCallback(async () => { const source = await flushPendingSourceSave(); if (source.status !== "clean") return source; return drainPendingDomEditSaves(); }, [drainPendingDomEditSaves, flushPendingSourceSave]); const discardPendingChanges = useCallback(() => { discardPendingSourceSave(); resetDomEditSaveQueueBreaker(); }, [discardPendingSourceSave, resetDomEditSaveQueueBreaker]); return useExternalFileChangeCoordinator({ projectId, activeCompPath, recoveryFilePath: fileManager.editingFile?.path ?? activeCompPath ?? masterCompPath, pendingTimelineEditPathRef, drainPendingChanges, getPendingCandidate: fileManager.getPendingSourceCandidate, discardPendingChanges, reloadPreview, reloadSdkSession: notifyExternalFileReload, persistConflictSnapshot: persistExternalConflictSnapshot, persistFailureSnapshot: persistExternalFailureSnapshot, loadConflictSnapshot: loadExternalConflictSnapshot, deleteConflictSnapshot: deleteExternalConflictSnapshot, overwriteConflict: fileManager.overwriteExternalConflict, readProjectFile: fileManager.readProjectFile, onUseExternalFile: fileManager.updateEditingFileContent, resetSaveQueues: resetDomEditSaveQueueBreaker, }); }