@epam/ai-dial-chat-hooks 1.3.0-dev.33 → 1.3.0-dev.331

package/files/useDialFileManagerSections/useDialFileManagerSections.d.ts

@@ -0,0 +1,25 @@
+import { DialFileManagerTabs } from '@epam/ai-dial-react-file-manager';
+import { DialFileManagerSection } from '../dial-file-manager.model';
+import { UseDialFileManagerOptions, UseDialFileManagerResult } from '../dial-file-manager.types';
+/** Options accepted by `useDialFileManagerSections`. */
+export interface UseDialFileManagerSectionsOptions extends Omit<UseDialFileManagerOptions, 'activeTab' | 'rootLabel' | 'isActive' | 'sessionKey'> {
+    /** Active tab, including `DialFileManagerTabs.All`. */
+    activeTab: DialFileManagerTabs;
+    /** Enabled source tabs in display order, each with its translated top-level folder name. */
+    sections: DialFileManagerSection[];
+}
+/** Values returned by `useDialFileManagerSections`. */
+export interface UseDialFileManagerSectionsResult extends UseDialFileManagerResult {
+    /** Source tab of the browsed folder; never `DialFileManagerTabs.All`. */
+    sectionTab: DialFileManagerTabs;
+}
+/**
+ * Composes one `useDialFileManager` per source tab (My files, Shared,
+ * Organization) so the File storage page can offer an All tab without a
+ * second copy of the per-tab rules. On a single tab it returns that section's
+ * result; on All it merges the section roots into one tree and routes every
+ * callback to the section owning the path. Section availability and names
+ * arrive through `sections` — the hook reads no config, i18n, or context.
+ */
+export declare const useDialFileManagerSections: ({ activeTab, sections, ...managerOptions }: UseDialFileManagerSectionsOptions) => UseDialFileManagerSectionsResult;
+//# sourceMappingURL=useDialFileManagerSections.d.ts.map

package/files/useDialFileManagerSections/useDialFileManagerSections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDialFileManagerSections.d.ts","sourceRoot":"","sources":["../../../src/files/useDialFileManagerSections/useDialFileManagerSections.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AASvE,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC9B,MAAM,4BAA4B,CAAC;AAGpC,wDAAwD;AACxD,MAAM,WAAW,iCAAkC,SAAQ,IAAI,CAC7D,yBAAyB,EACzB,WAAW,GAAG,WAAW,GAAG,UAAU,GAAG,YAAY,CACtD;IACC,uDAAuD;IACvD,SAAS,EAAE,mBAAmB,CAAC;IAC/B,4FAA4F;IAC5F,QAAQ,EAAE,sBAAsB,EAAE,CAAC;CACpC;AAED,uDAAuD;AACvD,MAAM,WAAW,gCAAiC,SAAQ,wBAAwB;IAChF,yEAAyE;IACzE,UAAU,EAAE,mBAAmB,CAAC;CACjC;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,GAAI,4CAIxC,iCAAiC,KAAG,gCAgYtC,CAAC"}

package/files/useDialFileManagerSections/useDialFileManagerSections.js

@@ -25,80 +25,64 @@ var l = ({ activeTab: l, sections: u, ...d }) => {
 		}
 	}, [v, y] = o(null), [b, x] = o(null), [S, C] = o(l);
 	S !== l && (C(l), y(null), x(null));
-	let w = (e) => f.some((t) => t.tab === e), ae = f[0]?.tab ?? c.MyFiles, T = v != null && w(v) ? v : ae, oe = b != null && w(b) ? b : T, E = (e) => e == null ? void 0 : r(e, f)?.tab, D = (e) => _(E(e) ?? T), O = (e, t) => {
+	let w = (e) => f.some((t) => t.tab === e), T = f[0]?.tab ?? c.MyFiles, E = v != null && w(v) ? v : T, ae = b != null && w(b) ? b : E, D = (e) => e == null ? void 0 : r(e, f)?.tab, O = (e) => _(D(e) ?? E), k = (e, t) => {
 		let n = /* @__PURE__ */ new Map();
 		return e.forEach((e) => {
-			let r = E(t(e)) ?? T;
+			let r = D(t(e)) ?? E;
 			n.set(r, [...n.get(r) ?? [], e]);
 		}), [...n];
-	}, { onNotification: k } = d, A = re(/* @__PURE__ */ new Set());
+	}, { onNotification: A } = d, j = re(/* @__PURE__ */ new Set()), M = f.map(({ tab: e }) => `${e}:${_(e).error ?? ""}`).join("|");
 	te(() => {
-		let t = A.current;
-		if (!p) {
-			t.clear();
-			return;
-		}
-		f.forEach(({ tab: n }) => {
-			if (_(n).error == null) {
-				t.delete(n);
-				return;
-			}
-			t.has(n) || (t.add(n), n !== T && k?.({
+		let t = j.current;
+		p ? f.forEach(({ tab: n }) => {
+			_(n).error == null ? t.delete(n) : t.has(n) || (t.add(n), n !== E && A?.({
 				variant: s.Error,
 				reason: e.FolderLoadFailed
 			}));
-		});
+		}) : t.clear();
 	}, [
-		f.map(({ tab: e }) => `${e}:${_(e).error ?? ""}`).join("|"),
+		M,
 		p,
-		T,
-		k
+		E,
+		A
 	]);
-	let j = () => {
-		k?.({
+	let N = () => {
+		A?.({
 			variant: s.Warning,
 			reason: e.CrossSectionTransferUnsupported
 		});
-	}, M = (e, t) => {
-		let n = new Set(e.map(E));
+	}, P = (e, t) => {
+		let n = new Set(e.map(D));
 		if (n.size !== 1) return;
 		let [r] = n;
-		if (r != null) return (t ? E(t) : r) === r ? r : void 0;
-	}, N = (e) => {
+		if (r != null) return (t ? D(t) : r) === r ? r : void 0;
+	}, F = (e) => {
 		if (e == null) {
-			_(T).onPathChange();
+			_(E).onPathChange();
 			return;
 		}
-		let t = E(e);
+		let t = D(e);
 		t != null && (y(t), _(t).onPathChange(e));
-	}, P = (e) => {
+	}, I = (e) => {
 		f.forEach(({ tab: t }) => {
-			let r = _(t), i = new Set([...e].filter((e) => E(e) === t));
+			let r = _(t), i = new Set([...e].filter((e) => D(e) === t));
 			n(i, r.expandedPaths) || r.onExpandedPathsChange(i);
 		});
-	}, F = (e) => D(e).onFolderPopupPathChange(e), I = (e, t) => D(t).onUploadFiles(e, t), L = (e, t, n) => D(n).onUploadArchive(e, t, n), R = (e, t, n) => D(n).onValidateUpload(e, t, n), z = (e, t, n) => D(t).onCreateFolder(e, t, n), B = (e, t) => D(t.path).onCreateFolderValidate(e, t), V = (e) => O(e, (e) => e.path).forEach(([e, t]) => _(e).onDownloadFiles(t)), H = (e, t) => {
-		let n = E(t);
-		O(e, (e) => e.sourceUrl ?? t).forEach(([e, r]) => _(e).onDeleteFiles(r, e === n ? t : ""));
-	}, U = (e, t) => D(t.path).onRenameValidate(e, t), W = (e) => O(e, (e) => e.path).forEach(([e, t]) => _(e).onUnshareFiles(t)), G = (e) => O(e, (e) => e.path).forEach(([e, t]) => _(e).onRemoveFilesAccess(t)), K = (e) => {
-		let t = E(e.path) ?? T;
+	}, L = (e) => O(e).onFolderPopupPathChange(e), R = (e, t) => O(t).onUploadFiles(e, t), z = (e, t, n) => O(n).onUploadArchive(e, t, n), B = (e, t, n) => O(n).onValidateUpload(e, t, n), V = (e, t, n) => O(t).onCreateFolder(e, t, n), H = (e, t) => O(t.path).onCreateFolderValidate(e, t), U = (e) => k(e, (e) => e.path).forEach(([e, t]) => _(e).onDownloadFiles(t)), W = (e, t) => {
+		let n = D(t);
+		k(e, (e) => e.sourceUrl ?? t).forEach(([e, r]) => _(e).onDeleteFiles(r, e === n ? t : ""));
+	}, G = (e, t) => O(t.path).onRenameValidate(e, t), K = (e) => k(e, (e) => e.path).forEach(([e, t]) => _(e).onUnshareFiles(t)), q = (e) => k(e, (e) => e.path).forEach(([e, t]) => _(e).onRemoveFilesAccess(t)), oe = (e) => {
+		let t = D(e.path) ?? E;
 		x(t), _(t).onGetInfo(e);
-	}, q = (e, t) => {
+	}, se = (e, t) => {
 		if (e.length === 0) return;
-		let n = M(e.map((e) => e.sourceUrl), t);
-		if (n == null) {
-			j();
-			return;
-		}
-		_(n).onCopyFiles(e, t);
-	}, se = (e, t, n) => {
+		let n = P(e.map((e) => e.sourceUrl), t);
+		n == null ? N() : _(n).onCopyFiles(e, t);
+	}, ce = (e, t, n) => {
 		if (e.length === 0) return;
-		let r = M(e.map((e) => e.sourceUrl ?? t), n);
-		if (r == null) {
-			j();
-			return;
-		}
-		_(r).onMoveToFiles(e, t, n);
-	}, ce = () => f.forEach(({ tab: e }) => _(e).cancelCopyMove());
+		let r = P(e.map((e) => e.sourceUrl ?? t), n);
+		r == null ? N() : _(r).onMoveToFiles(e, t, n);
+	}, le = () => f.forEach(({ tab: e }) => _(e).cancelCopyMove());
 	if (!p) {
 		let e = t.includes(l) ? l : c.MyFiles;
 		return {
@@ -106,49 +90,56 @@ var l = ({ activeTab: l, sections: u, ...d }) => {
 			sectionTab: e
 		};
 	}
-	let J = f.map(({ tab: e }) => _(e)), Y = _(T), X = _(oe), Z = [Y, ...J].find((e) => e.uploadBatchState != null) ?? Y, Q = (e) => J.some(e), $ = J.map((e) => e.sharedWithMeIds).filter((e) => e != null), le = new Set(f.filter(({ tab: e }) => e !== T && _(e).isLoading).map(({ tab: e }) => _(e).path));
+	let J = f.map(({ tab: e }) => _(e)), Y = _(E), X = _(ae), Z = [Y, ...J].find((e) => e.uploadBatchState != null) ?? Y, ue = J.flatMap((e) => e.downloadBatchState?.files ?? []), de = J.some((e) => e.downloadBatchState?.isOpen) ? {
+		isOpen: !0,
+		files: ue
+	} : null, Q = (e) => J.some(e), $ = J.map((e) => e.sharedWithMeIds).filter((e) => e != null), fe = new Set(f.filter(({ tab: e }) => e !== E && _(e).isLoading).map(({ tab: e }) => _(e).path));
 	return {
 		...Y,
 		items: J.map((e) => e.items[0]).filter((e) => e != null),
-		onPathChange: N,
+		onPathChange: F,
 		expandedPaths: i(J.map((e) => e.expandedPaths)),
 		loadedPaths: i(J.map((e) => e.loadedPaths)),
-		onExpandedPathsChange: P,
-		onFolderPopupPathChange: F,
-		folderPopupLoadingPaths: i([...J.map((e) => e.folderPopupLoadingPaths), le]),
-		onUploadFiles: I,
-		onUploadArchive: L,
-		onValidateUpload: R,
+		onExpandedPathsChange: I,
+		onFolderPopupPathChange: L,
+		folderPopupLoadingPaths: i([...J.map((e) => e.folderPopupLoadingPaths), fe]),
+		onUploadFiles: R,
+		onUploadArchive: z,
+		onValidateUpload: B,
 		uploadBatchState: Z.uploadBatchState,
 		cancelUpload: Z.cancelUpload,
 		cancelUploadFile: Z.cancelUploadFile,
 		clearUploadBatch: Z.clearUploadBatch,
-		onCreateFolder: z,
-		onCreateFolderValidate: B,
+		onCreateFolder: V,
+		onCreateFolderValidate: H,
 		isCreatingFolder: Q((e) => e.isCreatingFolder),
-		onDownloadFiles: V,
+		onDownloadFiles: U,
 		isDownloading: Q((e) => e.isDownloading),
-		onDeleteFiles: H,
+		downloadBatchState: de,
+		cancelDownloadFile: (e) => J.forEach((t) => t.cancelDownloadFile(e)),
+		cancelAllDownloads: () => J.forEach((e) => e.cancelAllDownloads()),
+		clearDownloadBatch: () => J.forEach((e) => e.clearDownloadBatch()),
+		onDeleteFiles: W,
 		isDeleting: Q((e) => e.isDeleting),
-		onRenameValidate: U,
-		onMoveToFiles: se,
+		onRenameValidate: G,
+		onMoveToFiles: ce,
 		isRenaming: Q((e) => e.isRenaming),
-		onCopyFiles: q,
+		onCopyFiles: se,
 		isCopying: Q((e) => e.isCopying),
 		isMoving: Q((e) => e.isMoving),
-		cancelCopyMove: ce,
+		cancelCopyMove: le,
 		sharedWithMeIds: $.length > 0 ? $.flat() : void 0,
 		sharedByMePaths: i(J.map((e) => e.sharedByMePaths)),
-		onUnshareFiles: W,
+		onUnshareFiles: K,
 		isUnsharing: Q((e) => e.isUnsharing),
-		onRemoveFilesAccess: G,
+		onRemoveFilesAccess: q,
 		isRemovingAccess: Q((e) => e.isRemovingAccess),
 		fileMetadata: X.fileMetadata,
 		isFileMetadataLoading: X.isFileMetadataLoading,
-		onGetInfo: K,
+		onGetInfo: oe,
 		clearMetadata: X.clearMetadata,
 		isAnyOperationInProgress: Q((e) => e.isAnyOperationInProgress),
-		sectionTab: T
+		sectionTab: E
 	};
 };
 //#endregion

package/files/useDialFileManagerTabConfig/useDialFileManagerTabConfig.d.ts

@@ -0,0 +1,15 @@
+import { DialFileManagerTabs, FileTreeOptions } from '@epam/ai-dial-react-file-manager';
+import { FilterChipItem } from '@epam/ai-dial-ui-kit';
+/** Values returned by `useDialFileManagerTabConfig`. */
+export interface UseDialFileManagerTabConfigResult {
+    tabs: FileTreeOptions['tabs'];
+}
+/**
+ * Filters the file-manager's tab list down to the host's configured set and
+ * resets `activeTab` to the highest-priority still-enabled tab when the
+ * current one becomes excluded. A `fileManagerTabs` of `undefined` means no
+ * restriction — every tab in `allTabs` stays enabled and no reset ever fires.
+ * The All tab is kept only while at least two source tabs are enabled.
+ */
+export declare const useDialFileManagerTabConfig: (activeTab: DialFileManagerTabs, onTabChange: (tab: DialFileManagerTabs) => void, allTabs: FilterChipItem<DialFileManagerTabs>[] | undefined, fileManagerTabs: string[] | undefined) => UseDialFileManagerTabConfigResult;
+//# sourceMappingURL=useDialFileManagerTabConfig.d.ts.map

package/files/useDialFileManagerTabConfig/useDialFileManagerTabConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDialFileManagerTabConfig.d.ts","sourceRoot":"","sources":["../../../src/files/useDialFileManagerTabConfig/useDialFileManagerTabConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,KAAK,eAAe,EACrB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAI3D,wDAAwD;AACxD,MAAM,WAAW,iCAAiC;IAChD,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;CAC/B;AAiBD;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,GACtC,WAAW,mBAAmB,EAC9B,aAAa,CAAC,GAAG,EAAE,mBAAmB,KAAK,IAAI,EAC/C,SAAS,cAAc,CAAC,mBAAmB,CAAC,EAAE,GAAG,SAAS,EAC1D,iBAAiB,MAAM,EAAE,GAAG,SAAS,KACpC,iCA+BF,CAAC"}

package/files/useDialFileManagerTabConfig/useDialFileManagerTabConfig.js

@@ -10,7 +10,7 @@ var a = [
 ], o = 2, s = (s, c, l, u) => {
 	let d = t((t) => {
 		let n = (e) => u == null || u.includes(e);
-		return n(t) ? t === i.All ? e.filter((e) => n(e)).length >= o : !0 : !1;
+		return n(t) ? t !== i.All || e.filter((e) => n(e)).length >= o : !1;
 	}, [u]), f = r(() => l?.filter((e) => d(e.value)), [l, d]);
 	return n(() => {
 		d(s) || c(a.find((e) => d(e)) ?? i.MyFiles);

package/files/useDialFileMetadata/useDialFileMetadata.d.ts

@@ -0,0 +1,28 @@
+import { DialFile } from '@epam/ai-dial-react-file-manager';
+import { FileManagerNotification } from '../dial-file-manager.types';
+import { DialFilesApi } from '../dial-files-api';
+/** Options accepted by `useDialFileMetadata`. */
+export interface UseDialFileMetadataOptions {
+    /** Injected operation port used for the metadata network call. */
+    filesApi: DialFilesApi;
+    /** DIAL Core bucket the current user browses (used only for my_files items). */
+    bucket: string;
+    /** Display name of the root folder node, used to resolve virtual paths back to API paths. */
+    rootLabel: string;
+    /** Called with a structured event when the metadata fetch fails. */
+    onNotification?: (notification: FileManagerNotification) => void;
+}
+/** Values returned by `useDialFileMetadata`. */
+export interface UseDialFileMetadataResult {
+    fileMetadata: DialFile | undefined;
+    isFileMetadataLoading: boolean;
+    onGetInfo: (file: DialFile) => void;
+    clearMetadata: () => void;
+}
+/**
+ * Fetches and holds single-file metadata for `fileMetadataPopupOptions` —
+ * the only sub-hook with no interaction with the shared listing cache, since
+ * viewing metadata never mutates listing state.
+ */
+export declare const useDialFileMetadata: ({ filesApi, bucket, rootLabel, onNotification, }: UseDialFileMetadataOptions) => UseDialFileMetadataResult;
+//# sourceMappingURL=useDialFileMetadata.d.ts.map

package/files/useDialFileMetadata/useDialFileMetadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDialFileMetadata.d.ts","sourceRoot":"","sources":["../../../src/files/useDialFileMetadata/useDialFileMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAIjE,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD,iDAAiD;AACjD,MAAM,WAAW,0BAA0B;IACzC,kEAAkE;IAClE,QAAQ,EAAE,YAAY,CAAC;IACvB,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC;IACf,6FAA6F;IAC7F,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,cAAc,CAAC,EAAE,CAAC,YAAY,EAAE,uBAAuB,KAAK,IAAI,CAAC;CAClE;AAED,gDAAgD;AAChD,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,QAAQ,GAAG,SAAS,CAAC;IACnC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,SAAS,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IACpC,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,kDAKjC,0BAA0B,KAAG,yBA2C/B,CAAC"}

package/files/useDialFileMetadata/useDialFileMetadata.js

@@ -13,11 +13,11 @@ var o = ({ filesApi: o, bucket: s, rootLabel: c, onNotification: l }) => {
 			(async () => {
 				p(!0);
 				try {
-					let e = r.bucket ?? s, i = t(r, e, c);
-					d(n(await o.getFileMetadata({
+					let e = r.bucket ?? s, i = t(r, e, c), a = await o.getFileMetadata({
 						bucket: e,
 						path: i
-					}), r));
+					});
+					d(n(a, r));
 				} catch {
 					l?.({
 						variant: a.Error,

package/files/useDialFileMutations/useDialFileMutations.d.ts

@@ -0,0 +1,77 @@
+import { CreateFolderResponseDto } from '@epam/ai-dial-chat-api-client';
+import { FileDownloadBatchState } from '@epam/ai-dial-chat-shared';
+import { DialCopiedItem, DialDeletedItem, DialFile, DialUploadFileItem, DialFileManagerTabs } from '@epam/ai-dial-react-file-manager';
+import { SharedRootMeta } from '../dial-file-manager.model';
+import { FileManagerNotification, FileNameValidationError, FileOperationSuccessEvent } from '../dial-file-manager.types';
+import { DialFilesApi } from '../dial-files-api';
+import { DownloadDestinationHandlers } from '../download-destination';
+/** Options accepted by `useDialFileMutations`. */
+export interface UseDialFileMutationsOptions {
+    /** Injected operation port used for every mutation network call. */
+    filesApi: DialFilesApi;
+    /** DIAL Core bucket to browse (used only for the my_files tab). */
+    bucket: string;
+    /** Display name for the root folder node. */
+    rootLabel: string;
+    /** Active tab — drives owner-bucket resolution for the Shared tab. */
+    activeTab: DialFileManagerTabs;
+    /** Bucket-relative path of the currently browsed folder, owned by `useDialFileListing`. */
+    folderPath: string;
+    /** Currently browsed folder node, owned by `useDialFileListing`. */
+    currentFolder: DialFile | undefined;
+    /** Owner-bucket resolution metadata for the Shared tab, owned by `useDialFileListing`. */
+    sharedRootMetaRef: React.RefObject<Map<string, SharedRootMeta>>;
+    /** Read-only snapshot of `useDialFileListing`'s per-folder permissions cache. */
+    listingPermissionsCache: Map<string, string[] | undefined>;
+    /** Deletes the given API-path cache keys so the next fetch re-fetches them. */
+    invalidateFolders: (apiPaths: string[]) => void;
+    /** Forces `useDialFileListing`'s fetch effect to re-run. */
+    bumpRetry: () => void;
+    /** Merges a newly created folder into its parent's cache entry, owned by `useDialFileListing`. */
+    mergeCreatedFolder: (parentApiPath: string, created: CreateFolderResponseDto, inheritedPermissions?: string[]) => void;
+    /** Imperatively navigates the current folder after a rename/delete of the browsed folder. */
+    setFolderPath: React.Dispatch<React.SetStateAction<string>>;
+    /** Called when a mutation should surface a toast notification. */
+    onNotification?: (notification: FileManagerNotification) => void;
+    /** Called when a mutation succeeds, instead of invoking an application notification service directly. */
+    onOperationSuccess?: (event: FileOperationSuccessEvent) => void;
+    /** Host-injected browser "Save As"/auto-download seam for `onDownloadFiles`. */
+    downloadDestination: DownloadDestinationHandlers;
+    /** Regexp of characters forbidden in file/folder names beyond the path separator. */
+    forbiddenSymbolsRegExp?: RegExp;
+}
+/** Values returned by `useDialFileMutations`. */
+export interface UseDialFileMutationsResult {
+    isCreatingFolder: boolean;
+    isDownloading: boolean;
+    isDeleting: boolean;
+    isRenaming: boolean;
+    isCopying: boolean;
+    isMoving: boolean;
+    onCreateFolder: (file: DialUploadFileItem, folderPath: string, fileId: string) => Promise<void>;
+    onCreateFolderValidate: (name: string, parentFolder: DialFile) => FileNameValidationError | null;
+    onDownloadFiles: (dialFiles: DialFile[]) => void;
+    /** Every download since the batch was last cleared; `null` when idle. */
+    downloadBatchState: FileDownloadBatchState | null;
+    /** Aborts one in-flight download by its entry id. */
+    cancelDownloadFile: (id: string) => void;
+    /** Aborts every in-flight download. */
+    cancelAllDownloads: () => void;
+    /** Empties the download batch. */
+    clearDownloadBatch: () => void;
+    onDeleteFiles: (items: DialDeletedItem[], sourceFolder: string) => void;
+    onRenameValidate: (value: string, item: DialFile) => FileNameValidationError | null;
+    onMoveToFiles: (items: DialCopiedItem[], sourceFolder: string, destinationFolder: string) => void;
+    onCopyFiles: (items: DialCopiedItem[], destinationFolder: string) => void;
+    cancelCopyMove: () => void;
+}
+/**
+ * Manages create-folder, download, delete, rename, copy, and move mutations.
+ * Every mutation invalidates the shared listing cache for its affected
+ * folders through `invalidateFolders`/`bumpRetry` rather than holding its own
+ * cache copy; create-folder additionally uses `mergeCreatedFolder` so a newly
+ * created folder appears immediately even when created from a
+ * destination-folder popup browsing a different folder than the outer grid.
+ */
+export declare const useDialFileMutations: ({ filesApi, bucket, rootLabel, activeTab, folderPath, currentFolder, sharedRootMetaRef, listingPermissionsCache, invalidateFolders, bumpRetry, mergeCreatedFolder, setFolderPath, onNotification, onOperationSuccess, downloadDestination, forbiddenSymbolsRegExp, }: UseDialFileMutationsOptions) => UseDialFileMutationsResult;
+//# sourceMappingURL=useDialFileMutations.d.ts.map

package/files/useDialFileMutations/useDialFileMutations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDialFileMutations.d.ts","sourceRoot":"","sources":["../../../src/files/useDialFileMutations/useDialFileMutations.ts"],"names":[],"mappings":"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"}