@epam/ai-dial-chat-hooks 1.3.0-dev.7 → 1.3.0-dev.79

package/files/useDialFileManager/useDialFileManager.js

@@ -1,150 +1,158 @@
-import { COLUMNS_WITHOUT_AUTHOR as e, COLUMNS_WITH_AUTHOR as t, DATE_OPTIONS as n } from "../dial-file-manager.model.js";
-import { hasDialFileWritePermission as r, isCopyMoveDuplicateAllowed as i, isShareActionsAllowed as a } from "../dial-file-manager-path.util.js";
-import { deriveActionProfile as o } from "../file-manager-variant.js";
-import { useDialFileListing as s } from "../useDialFileListing/useDialFileListing.js";
-import { useDialFileMetadata as c } from "../useDialFileMetadata/useDialFileMetadata.js";
-import { useDialFileMutations as l } from "../useDialFileMutations/useDialFileMutations.js";
-import { useDialFileSharing as u } from "../useDialFileSharing/useDialFileSharing.js";
-import { useDialFileUploadBatch as d } from "../useDialFileUploadBatch/useDialFileUploadBatch.js";
-import { DialFileManagerActionProfile as f, DialFileManagerVariant as p, isUploadInProgress as m } from "@epam/ai-dial-chat-shared";
-import { useCallback as h, useMemo as g } from "react";
-import { DialFileManagerActions as _, DialFileManagerTabs as v } from "@epam/ai-dial-react-file-manager";
+import { COLUMNS_MY_FILES as e, COLUMNS_ORGANIZATION as t, COLUMNS_SHARED as n, DATE_OPTIONS as r } from "../dial-file-manager.model.js";
+import { hasDialFileWritePermission as i, isCopyMoveDuplicateAllowed as a, isShareActionsAllowed as o } from "../dial-file-manager-path.util.js";
+import { deriveActionProfile as s } from "../file-manager-variant.js";
+import { useDialFileListing as c } from "../useDialFileListing/useDialFileListing.js";
+import { useDialFileMetadata as l } from "../useDialFileMetadata/useDialFileMetadata.js";
+import { useDialFileMutations as u } from "../useDialFileMutations/useDialFileMutations.js";
+import { useDialFileSharing as d } from "../useDialFileSharing/useDialFileSharing.js";
+import { useDialFileUploadBatch as f } from "../useDialFileUploadBatch/useDialFileUploadBatch.js";
+import { DialFileManagerActionProfile as p, DialFileManagerVariant as m, isUploadInProgress as h } from "@epam/ai-dial-chat-shared";
+import { useCallback as g, useMemo as _ } from "react";
+import { DialFileManagerActions as v, DialFileManagerTabs as y } from "@epam/ai-dial-react-file-manager";
 //#region src/files/useDialFileManager/useDialFileManager.ts
-var y = ({ filesApi: y, bucket: b, rootLabel: x = "My files", activeTab: S = v.MyFiles, isActive: C, sessionKey: w, onNotification: T, onOperationSuccess: E, forbiddenSymbolsRegExp: D, variant: O = p.Attach, actionProfile: k, labels: A, locale: j, disabledNewButtonTooltip: M, downloadDestination: N, buildValidationErrorMessage: P }) => {
-	let F = k ?? o(O), I = s({
-		filesApi: y,
-		bucket: b,
-		rootLabel: x,
-		activeTab: S,
-		onNotification: T,
-		isActive: C,
-		sessionKey: w
-	}), L = d({
-		filesApi: y,
-		bucket: b,
-		rootLabel: x,
-		activeTab: S,
-		cache: I.cache,
-		sharedRootMetaRef: I.sharedRootMetaRef,
-		invalidateFolders: I.invalidateFolders,
-		bumpRetry: I.bumpRetry,
-		onNotification: T
-	}), R = l({
-		filesApi: y,
-		bucket: b,
-		rootLabel: x,
-		activeTab: S,
-		folderPath: I.folderPath,
-		currentFolder: I.currentFolder,
-		sharedRootMetaRef: I.sharedRootMetaRef,
-		listingPermissionsCache: I.listingPermissionsCache,
-		invalidateFolders: I.invalidateFolders,
-		bumpRetry: I.bumpRetry,
-		mergeCreatedFolder: I.mergeCreatedFolder,
-		setFolderPath: I.setFolderPath,
-		onNotification: T,
-		onOperationSuccess: E,
-		downloadDestination: N,
-		forbiddenSymbolsRegExp: D
+var b = ({ filesApi: b, bucket: x, rootLabel: S = "My files", activeTab: C = y.MyFiles, isActive: w, sessionKey: T, onNotification: E, onOperationSuccess: D, forbiddenSymbolsRegExp: O, variant: k = m.Attach, actionProfile: A, labels: j, locale: M, disabledNewButtonTooltip: N, downloadDestination: P, buildValidationErrorMessage: F }) => {
+	let I = A ?? s(k), L = c({
+		filesApi: b,
+		bucket: x,
+		rootLabel: S,
+		activeTab: C,
+		onNotification: E,
+		isActive: w,
+		sessionKey: T
+	}), R = f({
+		filesApi: b,
+		bucket: x,
+		rootLabel: S,
+		activeTab: C,
+		cache: L.cache,
+		sharedRootMetaRef: L.sharedRootMetaRef,
+		invalidateFolders: L.invalidateFolders,
+		bumpRetry: L.bumpRetry,
+		onNotification: E
 	}), z = u({
-		filesApi: y,
-		bucket: b,
-		rootLabel: x,
-		bumpRetry: I.bumpRetry,
-		onNotification: T
-	}), B = c({
-		filesApi: y,
-		bucket: b,
-		rootLabel: x,
-		onNotification: T
-	}), V = r(I.currentFolder), H = g(() => S === v.Organization || S === v.Shared && I.folderPath === "" ? !1 : V, [
-		S,
-		I.folderPath,
-		V
-	]), U = g(() => S === v.Shared ? t : e, [S]), W = g(() => {
+		filesApi: b,
+		bucket: x,
+		rootLabel: S,
+		activeTab: C,
+		folderPath: L.folderPath,
+		currentFolder: L.currentFolder,
+		sharedRootMetaRef: L.sharedRootMetaRef,
+		listingPermissionsCache: L.listingPermissionsCache,
+		invalidateFolders: L.invalidateFolders,
+		bumpRetry: L.bumpRetry,
+		mergeCreatedFolder: L.mergeCreatedFolder,
+		setFolderPath: L.setFolderPath,
+		onNotification: E,
+		onOperationSuccess: D,
+		downloadDestination: P,
+		forbiddenSymbolsRegExp: O
+	}), B = d({
+		filesApi: b,
+		bucket: x,
+		rootLabel: S,
+		bumpRetry: L.bumpRetry,
+		onNotification: E,
+		onOperationSuccess: D,
+		removeSharedRootItems: L.removeSharedRootItems
+	}), V = l({
+		filesApi: b,
+		bucket: x,
+		rootLabel: S,
+		onNotification: E
+	}), H = i(L.currentFolder), U = _(() => C === y.Organization || C === y.Shared && L.folderPath === "" ? !1 : H, [
+		C,
+		L.folderPath,
+		H
+	]), W = _(() => {
+		switch (C) {
+			case y.Shared: return n;
+			case y.Organization: return t;
+			default: return e;
+		}
+	}, [C]), G = _(() => {
 		let e = {}, t = (t) => {
-			let n = A[t];
+			let n = j[t];
 			n != null && (e[t] = n);
 		};
-		return t(_.Download), S === v.MyFiles ? (t(_.Delete), H && (t(_.Rename), i(F) && (t(_.Copy), t(_.Move), t(_.Duplicate))), a(F) && t(_.RemoveAccess)) : S === v.Shared && a(F) && t(_.Unshare), F === f.Full && t(_.Info), e;
+		return t(v.Download), C === y.MyFiles ? (t(v.Delete), U && (t(v.Rename), a(I) && (t(v.Copy), t(v.Move), t(v.Duplicate))), o(I) && t(v.RemoveAccess)) : C === y.Shared && o(I) && t(v.Unshare), I === p.Full && t(v.Info), e;
 	}, [
-		S,
-		H,
-		F,
-		A
-	]), G = g(() => R.isCreatingFolder || R.isDownloading || R.isDeleting || R.isRenaming || R.isCopying || R.isMoving || z.isUnsharing || z.isRemovingAccess || m(L.uploadBatchState), [
-		R.isCreatingFolder,
-		R.isDownloading,
-		R.isDeleting,
-		R.isRenaming,
-		R.isCopying,
-		R.isMoving,
-		z.isUnsharing,
-		z.isRemovingAccess,
-		L.uploadBatchState
-	]), K = h((e, t) => {
-		let n = R.onCreateFolderValidate(e, t);
-		return n ? P(n) : null;
-	}, [R, P]), q = h((e, t) => {
-		let n = R.onRenameValidate(e, t);
-		return n ? P(n, t) : null;
-	}, [R, P]);
+		C,
+		U,
+		I,
+		j
+	]), K = _(() => z.isCreatingFolder || z.isDownloading || z.isDeleting || z.isRenaming || z.isCopying || z.isMoving || B.isUnsharing || B.isRemovingAccess || h(R.uploadBatchState), [
+		z.isCreatingFolder,
+		z.isDownloading,
+		z.isDeleting,
+		z.isRenaming,
+		z.isCopying,
+		z.isMoving,
+		B.isUnsharing,
+		B.isRemovingAccess,
+		R.uploadBatchState
+	]), q = g((e, t) => {
+		let n = z.onCreateFolderValidate(e, t);
+		return n ? F(n) : null;
+	}, [z, F]), J = g((e, t) => {
+		let n = z.onRenameValidate(e, t);
+		return n ? F(n, t) : null;
+	}, [z, F]);
 	return {
-		items: I.items,
-		isLoading: I.isLoading,
-		error: I.error,
-		path: I.path,
-		onPathChange: I.onPathChange,
-		retry: I.retry,
-		onSearchFiles: I.onSearchFiles,
-		isSearching: I.isSearching,
-		searchResults: I.searchResults,
-		clearSearchResults: I.clearSearchResults,
-		expandedPaths: I.expandedPaths,
-		loadedPaths: I.loadedPaths,
-		onExpandedPathsChange: I.onExpandedPathsChange,
-		onFolderPopupPathChange: I.onFolderPopupPathChange,
-		folderPopupLoadingPaths: I.folderPopupLoadingPaths,
-		onUploadFiles: L.onUploadFiles,
-		onUploadArchive: L.onUploadArchive,
-		onValidateUpload: L.onValidateUpload,
-		uploadBatchState: L.uploadBatchState,
-		cancelUpload: L.cancelUpload,
-		cancelUploadFile: L.cancelUploadFile,
-		clearUploadBatch: L.clearUploadBatch,
-		onCreateFolder: R.onCreateFolder,
-		onCreateFolderValidate: K,
-		isCreatingFolder: R.isCreatingFolder,
-		onDownloadFiles: R.onDownloadFiles,
-		isDownloading: R.isDownloading,
-		onDeleteFiles: R.onDeleteFiles,
-		isDeleting: R.isDeleting,
-		onRenameValidate: q,
-		onMoveToFiles: R.onMoveToFiles,
-		isRenaming: R.isRenaming,
-		onCopyFiles: R.onCopyFiles,
-		isCopying: R.isCopying,
-		isMoving: R.isMoving,
-		cancelCopyMove: R.cancelCopyMove,
-		uploadEnabled: H,
-		isNewButtonDisabled: !H,
-		disabledNewButtonTooltip: M,
-		visibleColumns: U,
-		dateLocale: j,
-		dateOptions: n,
-		actionLabels: W,
-		sharedWithMeIds: I.sharedWithMeIds,
-		sharedByMePaths: I.sharedByMePaths,
-		onUnshareFiles: z.onUnshareFiles,
-		isUnsharing: z.isUnsharing,
-		onRemoveFilesAccess: z.onRemoveFilesAccess,
-		isRemovingAccess: z.isRemovingAccess,
-		fileMetadata: B.fileMetadata,
-		isFileMetadataLoading: B.isFileMetadataLoading,
-		onGetInfo: B.onGetInfo,
-		clearMetadata: B.clearMetadata,
-		isAnyOperationInProgress: G
+		items: L.items,
+		isLoading: L.isLoading,
+		error: L.error,
+		path: L.path,
+		onPathChange: L.onPathChange,
+		retry: L.retry,
+		onSearchFiles: L.onSearchFiles,
+		isSearching: L.isSearching,
+		searchResults: L.searchResults,
+		clearSearchResults: L.clearSearchResults,
+		expandedPaths: L.expandedPaths,
+		loadedPaths: L.loadedPaths,
+		onExpandedPathsChange: L.onExpandedPathsChange,
+		onFolderPopupPathChange: L.onFolderPopupPathChange,
+		folderPopupLoadingPaths: L.folderPopupLoadingPaths,
+		onUploadFiles: R.onUploadFiles,
+		onUploadArchive: R.onUploadArchive,
+		onValidateUpload: R.onValidateUpload,
+		uploadBatchState: R.uploadBatchState,
+		cancelUpload: R.cancelUpload,
+		cancelUploadFile: R.cancelUploadFile,
+		clearUploadBatch: R.clearUploadBatch,
+		onCreateFolder: z.onCreateFolder,
+		onCreateFolderValidate: q,
+		isCreatingFolder: z.isCreatingFolder,
+		onDownloadFiles: z.onDownloadFiles,
+		isDownloading: z.isDownloading,
+		onDeleteFiles: z.onDeleteFiles,
+		isDeleting: z.isDeleting,
+		onRenameValidate: J,
+		onMoveToFiles: z.onMoveToFiles,
+		isRenaming: z.isRenaming,
+		onCopyFiles: z.onCopyFiles,
+		isCopying: z.isCopying,
+		isMoving: z.isMoving,
+		cancelCopyMove: z.cancelCopyMove,
+		uploadEnabled: U,
+		isNewButtonDisabled: !U,
+		disabledNewButtonTooltip: N,
+		visibleColumns: W,
+		dateLocale: M,
+		dateOptions: r,
+		actionLabels: G,
+		sharedWithMeIds: L.sharedWithMeIds,
+		sharedByMePaths: L.sharedByMePaths,
+		onUnshareFiles: B.onUnshareFiles,
+		isUnsharing: B.isUnsharing,
+		onRemoveFilesAccess: B.onRemoveFilesAccess,
+		isRemovingAccess: B.isRemovingAccess,
+		fileMetadata: V.fileMetadata,
+		isFileMetadataLoading: V.isFileMetadataLoading,
+		onGetInfo: V.onGetInfo,
+		clearMetadata: V.clearMetadata,
+		isAnyOperationInProgress: K
 	};
 };
 //#endregion
-export { y as useDialFileManager };
+export { b as useDialFileManager };

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,gCAgXtC,CAAC"}

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/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/useDialFileMutations/useDialFileMutations.d.ts

@@ -0,0 +1,68 @@
+import { CreateFolderResponseDto } from '@epam/ai-dial-chat-api-client';
+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;
+    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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"}