@epam/ai-dial-chat-hooks 1.3.0-dev.10 → 1.3.0-dev.103

package/files/useDialFileListing/useDialFileListing.js

@@ -2,36 +2,36 @@ import { getApiErrorStatus as e } from "../../api-error/api-error.js";
 import { FileManagerNotificationReason as t } from "../dial-file-manager.types.js";
 import { buildSharedItemVirtualPath as n, dialCorePathToRelative as r, findFolderByVirtualPath as i, normalizeVirtualPath as a } from "../dial-file-manager-path.util.js";
 import { virtualPathToApiPath as o } from "../resolve-dial-file-api-path.js";
-import { buildFromCache as ee, fetchByTab as s, fetchForSearch as te, mapCorePermissions as ne, mapSearchItem as c, mergeCreatedFolderIntoCache as re } from "../dial-file-manager-mapping.util.js";
+import { buildFromCache as ee, buildSharedSearchScope as s, fetchByTab as c, fetchForSearch as te, mapCorePermissions as ne, mapSearchItem as l, mergeCreatedFolderIntoCache as re } from "../dial-file-manager-mapping.util.js";
 import { getParentFolderPath as ie } from "@epam/ai-dial-chat-shared";
-import { useCallback as l, useEffect as u, useMemo as d, useRef as f, useState as p } from "react";
-import { ListFilesItemDtoNodeTypeEnum as m } from "@epam/ai-dial-chat-api-client";
+import { useCallback as u, useEffect as d, useMemo as f, useRef as p, useState as m } from "react";
+import { ListFilesItemDtoNodeTypeEnum as ae } from "@epam/ai-dial-chat-api-client";
 import { NotificationVariant as h } from "@epam/ai-dial-ui-kit";
-import { DialFileManagerTabs as g, DialFileNodeType as ae } from "@epam/ai-dial-react-file-manager";
+import { DialFileManagerTabs as g, DialFileNodeType as oe } from "@epam/ai-dial-react-file-manager";
 //#region src/files/useDialFileListing/useDialFileListing.ts
-var _ = ({ filesApi: _, bucket: v, rootLabel: y, activeTab: b, onNotification: x, isActive: S = !0, sessionKey: oe }) => {
-	let [C, w] = p(""), [T, E] = p(() => /* @__PURE__ */ new Map()), D = f(T);
-	u(() => {
+var _ = ({ filesApi: _, bucket: v, rootLabel: y, activeTab: b, onNotification: x, isActive: S = !0, sessionKey: se }) => {
+	let [C, w] = m(""), [T, E] = m(() => /* @__PURE__ */ new Map()), D = p(T);
+	d(() => {
 		D.current = T;
 	}, [T]);
-	let [O, k] = p(() => /* @__PURE__ */ new Map()), [se, A] = p(S), [ce, le] = p(S);
-	ce !== S && (le(S), A(S));
-	let [ue, j] = p(null), [M, N] = p(0), [P, F] = p(void 0), [de, I] = p(() => /* @__PURE__ */ new Set()), L = f(/* @__PURE__ */ new Map()), [fe, R] = p(!1), [pe, z] = p(null), B = f(null), V = f(null), H = f(/* @__PURE__ */ new Set()), U = f(/* @__PURE__ */ new Set()), [W, G] = p(() => /* @__PURE__ */ new Set()), [me, K] = p(() => /* @__PURE__ */ new Set()), [q, J] = p(() => /* @__PURE__ */ new Set()), Y = `${b}|${oe ?? ""}`, X = f(Y);
-	u(() => {
+	let [O, k] = m(() => /* @__PURE__ */ new Map()), [ce, A] = m(S), [le, ue] = m(S);
+	le !== S && (ue(S), A(S));
+	let [de, j] = m(null), [M, N] = m(0), [P, F] = m(void 0), [fe, I] = m(() => /* @__PURE__ */ new Set()), L = p(/* @__PURE__ */ new Map()), [pe, R] = m(!1), [me, z] = m(null), B = p(null), V = p(null), H = p(/* @__PURE__ */ new Set()), U = p(/* @__PURE__ */ new Set()), [W, G] = m(() => /* @__PURE__ */ new Set()), [he, K] = m(() => /* @__PURE__ */ new Set()), [q, J] = m(() => /* @__PURE__ */ new Set()), Y = `${b}|${se ?? ""}`, X = p(Y);
+	d(() => {
 		X.current !== Y && (X.current = Y, E(/* @__PURE__ */ new Map()), k(/* @__PURE__ */ new Map()), w(""), F(void 0), L.current = /* @__PURE__ */ new Map(), H.current = /* @__PURE__ */ new Set(), U.current = /* @__PURE__ */ new Set(), K(/* @__PURE__ */ new Set()), J(/* @__PURE__ */ new Set()), B.current != null && (clearTimeout(B.current), B.current = null), V.current?.(), V.current = null, z(null), R(!1), G(/* @__PURE__ */ new Set()), N((e) => e + 1));
-	}, [Y]), u(() => () => {
+	}, [Y]), d(() => () => {
 		B.current != null && clearTimeout(B.current), V.current?.();
-	}, []), u(() => {
+	}, []), d(() => {
 		if (!S) {
 			A(!1);
 			return;
 		}
 		let t = !1;
-		return A(!0), j(null), s(_, b, v, C, L.current).then(({ items: e, permissions: n }) => {
+		return A(!0), j(null), c(_, b, v, C, L.current).then(({ items: e, permissions: n }) => {
 			t || (E((t) => {
 				let n = new Map(t);
 				return n.set(C, e), n;
-			}), k((e) => new Map(e).set(C, n)), b === g.Shared && C === "" && (F(e.map((e) => e.nodeType === m.Folder ? `/${y}/${e.name}/` : `/${y}/${e.name}`)), L.current = new Map(e.map((e) => [e.name, {
+			}), k((e) => new Map(e).set(C, n)), b === g.Shared && C === "" && (F(e.map((e) => e.nodeType === ae.Folder ? `/${y}/${e.name}/` : `/${y}/${e.name}`)), L.current = new Map(e.map((e) => [e.name, {
 				bucket: e.bucket ?? "",
 				dialCorePath: e.path
 			}]))));
@@ -56,14 +56,14 @@ var _ = ({ filesApi: _, bucket: v, rootLabel: y, activeTab: b, onNotification: x
 		S,
 		M,
 		y
-	]), u(() => {
+	]), d(() => {
 		if (!S || b !== g.MyFiles) {
 			I(/* @__PURE__ */ new Set());
 			return;
 		}
 		let e = !1;
 		return _.listSharedByMe(v).then((t) => {
-			e || I(new Set(t.items.map((e) => n(r(e.path, v), y, e.nodeType === m.Folder))));
+			e || I(new Set(t.items.map((e) => n(r(e.path, v), y, e.nodeType === ae.Folder))));
 		}).catch(() => {
 			e || I(/* @__PURE__ */ new Set());
 		}), () => {
@@ -77,12 +77,12 @@ var _ = ({ filesApi: _, bucket: v, rootLabel: y, activeTab: b, onNotification: x
 		M,
 		y
 	]);
-	let Z = d(() => [{
+	let Z = f(() => [{
 		id: v,
 		name: y,
 		path: `/${y}`,
 		parentPath: "",
-		nodeType: ae.FOLDER,
+		nodeType: oe.FOLDER,
 		folderId: v,
 		permissions: ne(O.get("")),
 		items: ee(T, O, "", `/${y}`, v)
@@ -91,7 +91,7 @@ var _ = ({ filesApi: _, bucket: v, rootLabel: y, activeTab: b, onNotification: x
 		O,
 		y,
 		v
-	]), he = l((e) => {
+	]), ge = u((e) => {
 		if (e == null) {
 			w("");
 			return;
@@ -109,9 +109,9 @@ var _ = ({ filesApi: _, bucket: v, rootLabel: y, activeTab: b, onNotification: x
 			r = t.startsWith(n) ? t.slice(n.length) : t;
 		}
 		w(r && !r.endsWith("/") ? `${r}/` : r);
-	}, [y]), Q = l(() => {
+	}, [y]), Q = u(() => {
 		N((e) => e + 1);
-	}, []), ge = Q, _e = l((e) => {
+	}, []), _e = Q, ve = u((e) => {
 		if (e.length === 0) return;
 		let n = new Set([...W].map((e) => o(e, y))), r = (e) => e === C || C.startsWith(e) || n.has(e), i = e.filter((e) => !r(e)), a = e.filter((e) => r(e) && e !== C);
 		i.length > 0 && (E((e) => {
@@ -123,7 +123,7 @@ var _ = ({ filesApi: _, bucket: v, rootLabel: y, activeTab: b, onNotification: x
 		})), a.forEach((e) => {
 			(async () => {
 				try {
-					let { items: t, permissions: n } = await s(_, b, v, e, L.current);
+					let { items: t, permissions: n } = await c(_, b, v, e, L.current);
 					E((n) => new Map(n).set(e, t)), n != null && k((t) => new Map(t).set(e, n));
 				} catch {
 					x?.({
@@ -141,9 +141,18 @@ var _ = ({ filesApi: _, bucket: v, rootLabel: y, activeTab: b, onNotification: x
 		W,
 		y,
 		x
-	]), ve = l((e, t, n) => {
+	]), ye = u((e, t, n) => {
 		E((r) => re(r, e, t, n));
-	}, []), ye = l((e) => {
+	}, []), be = u((e) => {
+		if (e.length === 0) return;
+		let t = new Set(e);
+		E((e) => {
+			let n = e.get("");
+			if (n == null) return e;
+			let r = new Map(e);
+			return r.set("", n.filter((e) => !t.has(e.name))), r;
+		}), F((t) => t?.filter((t) => !e.some((e) => t === `/${y}/${e}`)));
+	}, [y]), xe = u((e) => {
 		if (!S) return;
 		let n = e == null ? "" : o(e, y), r = e ?? `/${y}`;
 		if (J((e) => {
@@ -163,7 +172,7 @@ var _ = ({ filesApi: _, bucket: v, rootLabel: y, activeTab: b, onNotification: x
 				return t.add(r), t;
 			}), (async () => {
 				try {
-					let { items: e, permissions: t } = await s(_, b, v, n, L.current);
+					let { items: e, permissions: t } = await c(_, b, v, n, L.current);
 					E((t) => new Map(t).set(n, e)), t != null && k((e) => new Map(e).set(n, t)), U.current.delete(n);
 				} catch {
 					x?.({
@@ -185,7 +194,7 @@ var _ = ({ filesApi: _, bucket: v, rootLabel: y, activeTab: b, onNotification: x
 		S,
 		x,
 		y
-	]), be = d(() => {
+	]), Se = f(() => {
 		let e = /* @__PURE__ */ new Set(), t = new Set([...W, ...q]);
 		for (let n of t) {
 			let t = o(n, y);
@@ -197,7 +206,7 @@ var _ = ({ filesApi: _, bucket: v, rootLabel: y, activeTab: b, onNotification: x
 		q,
 		T,
 		y
-	]), xe = l((e) => {
+	]), Ce = u((e) => {
 		S && (W.forEach((t) => {
 			e.has(t) || U.current.delete(o(t, y));
 		}), G(e), [...e].filter((e) => {
@@ -207,7 +216,7 @@ var _ = ({ filesApi: _, bucket: v, rootLabel: y, activeTab: b, onNotification: x
 			let n = o(e, y);
 			H.current.add(n), (async () => {
 				try {
-					let { items: e, permissions: t } = await s(_, b, v, n, L.current);
+					let { items: e, permissions: t } = await c(_, b, v, n, L.current);
 					E((t) => new Map(t).set(n, e)), t != null && k((e) => new Map(e).set(n, t));
 				} catch {
 					U.current.add(n), x?.({
@@ -230,9 +239,9 @@ var _ = ({ filesApi: _, bucket: v, rootLabel: y, activeTab: b, onNotification: x
 		S,
 		x,
 		y
-	]), Se = l(() => {
+	]), we = u(() => {
 		B.current != null && (clearTimeout(B.current), B.current = null), V.current?.(), V.current = null, z(null), R(!1);
-	}, []), Ce = l((e, t) => {
+	}, []), Te = u((e, t) => {
 		if (S) {
 			if (B.current != null && (clearTimeout(B.current), B.current = null), V.current?.(), V.current = null, !t.trim()) {
 				z(null), R(!1);
@@ -240,7 +249,9 @@ var _ = ({ filesApi: _, bucket: v, rootLabel: y, activeTab: b, onNotification: x
 			}
 			B.current = setTimeout(() => {
 				if (B.current = null, b === g.Shared && C === "") {
-					V.current?.(), V.current = null, R(!0), z((T.get("") ?? []).map((e) => c(e, e.bucket ?? v, y))), R(!1);
+					V.current?.(), V.current = null, R(!0);
+					let e = T.get("") ?? [], t = s(y, "", /* @__PURE__ */ new Map());
+					z(e.map((e) => l(e, e.bucket ?? v, y, t))), R(!1);
 					return;
 				}
 				let e = !1;
@@ -250,7 +261,8 @@ var _ = ({ filesApi: _, bucket: v, rootLabel: y, activeTab: b, onNotification: x
 					try {
 						let { items: t } = await te(_, b, v, C, L.current);
 						if (e) return;
-						z(t.map((e) => c(e, e.bucket ?? v, y)));
+						let n = b === g.Shared ? s(y, C, L.current) : void 0;
+						z(t.map((e) => l(e, e.bucket ?? v, y, n)));
 					} catch {
 						e || z([]);
 					} finally {
@@ -267,7 +279,7 @@ var _ = ({ filesApi: _, bucket: v, rootLabel: y, activeTab: b, onNotification: x
 		C,
 		S,
 		y
-	]), $ = C ? `/${y}/${C}` : `/${y}`, we = d(() => {
+	]), $ = C ? `/${y}/${C}` : `/${y}`, Ee = f(() => {
 		let e = Z[0];
 		if (e) return a($) === a(`/${y}`) ? e : i(e.items ?? [], $);
 	}, [
@@ -277,31 +289,32 @@ var _ = ({ filesApi: _, bucket: v, rootLabel: y, activeTab: b, onNotification: x
 	]);
 	return {
 		items: Z,
-		isLoading: se,
-		error: ue,
+		isLoading: ce,
+		error: de,
 		path: $,
 		folderPath: C,
-		onPathChange: he,
+		onPathChange: ge,
 		retry: Q,
-		onSearchFiles: Ce,
-		isSearching: fe,
-		searchResults: pe,
-		clearSearchResults: Se,
+		onSearchFiles: Te,
+		isSearching: pe,
+		searchResults: me,
+		clearSearchResults: we,
 		expandedPaths: W,
-		loadedPaths: be,
-		onExpandedPathsChange: xe,
-		onFolderPopupPathChange: ye,
-		folderPopupLoadingPaths: me,
-		sharedWithMeIds: d(() => b === g.Shared ? P : void 0, [b, P]),
-		sharedByMePaths: de,
-		currentFolder: we,
+		loadedPaths: Se,
+		onExpandedPathsChange: Ce,
+		onFolderPopupPathChange: xe,
+		folderPopupLoadingPaths: he,
+		sharedWithMeIds: f(() => b === g.Shared ? P : void 0, [b, P]),
+		sharedByMePaths: fe,
+		currentFolder: Ee,
 		cache: T,
 		listingPermissionsCache: O,
 		sharedRootMetaRef: L,
 		setFolderPath: w,
-		invalidateFolders: _e,
-		mergeCreatedFolder: ve,
-		bumpRetry: ge
+		invalidateFolders: ve,
+		mergeCreatedFolder: ye,
+		bumpRetry: _e,
+		removeSharedRootItems: be
 	};
 };
 //#endregion

package/files/useDialFileManager/useDialFileManager.d.ts

@@ -0,0 +1,16 @@
+import { UseDialFileManagerOptions, UseDialFileManagerResult } from '../dial-file-manager.types';
+export type { UseDialFileManagerOptions, UseDialFileManagerResult, } from '../dial-file-manager.types';
+/**
+ * Composes the five file-manager sub-hooks — listing/navigation, upload
+ * batches, CRUD mutations, sharing, and metadata — into the single flat
+ * result `DialFileManagerShell`/`DialFileManagerModal`/`DialFileManagerPage`
+ * consume. Cache ownership and cross-hook invalidation stay inside
+ * `useDialFileListing`; this composer only wires that hook's
+ * `invalidateFolders`/`bumpRetry` into its siblings and derives the handful
+ * of tab/actionProfile UI fields that read outputs from more than one
+ * sub-hook. Imports neither `react-i18next` nor any application context —
+ * every translated string reaches it through `labels`,
+ * `disabledNewButtonTooltip`, and `buildValidationErrorMessage`.
+ */
+export declare const useDialFileManager: ({ filesApi, bucket, rootLabel, activeTab, isActive, sessionKey, onNotification, onOperationSuccess, forbiddenSymbolsRegExp, variant, actionProfile, labels, locale, disabledNewButtonTooltip, downloadDestination, buildValidationErrorMessage, }: UseDialFileManagerOptions) => UseDialFileManagerResult;
+//# sourceMappingURL=useDialFileManager.d.ts.map

package/files/useDialFileManager/useDialFileManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDialFileManager.d.ts","sourceRoot":"","sources":["../../../src/files/useDialFileManager/useDialFileManager.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EACV,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,4BAA4B,CAAC;AAQpC,YAAY,EACV,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,4BAA4B,CAAC;AAEpC;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,GAAI,mPAiBhC,yBAAyB,KAAG,wBAsN9B,CAAC"}

package/files/useDialFileManager/useDialFileManager.js

@@ -51,7 +51,9 @@ var b = ({ filesApi: b, bucket: x, rootLabel: S = "My files", activeTab: C = y.M
 		bucket: x,
 		rootLabel: S,
 		bumpRetry: L.bumpRetry,
-		onNotification: E
+		onNotification: E,
+		onOperationSuccess: D,
+		removeSharedRootItems: L.removeSharedRootItems
 	}), V = l({
 		filesApi: b,
 		bucket: x,

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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"}

package/files/useDialFileSharing/useDialFileSharing.d.ts

@@ -0,0 +1,34 @@
+import { DialFile } from '@epam/ai-dial-react-file-manager';
+import { FileManagerNotification, FileOperationSuccessEvent } from '../dial-file-manager.types';
+import { DialFilesApi } from '../dial-files-api';
+/** Options accepted by `useDialFileSharing`. */
+export interface UseDialFileSharingOptions {
+    /** Injected operation port used for every sharing 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;
+    /** Forces `useDialFileListing`'s fetch effect to re-run after a mutation settles. */
+    bumpRetry: () => void;
+    /** Called when a sharing mutation fails and should surface a toast notification. */
+    onNotification?: (notification: FileManagerNotification) => void;
+    /** Called with a structured event once an unshare succeeds, so the host can show its success toast. */
+    onOperationSuccess?: (event: FileOperationSuccessEvent) => void;
+    /** Removes the unshared root rows from the cached Shared listing ahead of the refetch. */
+    removeSharedRootItems?: (names: string[]) => void;
+}
+/** Values returned by `useDialFileSharing`. */
+export interface UseDialFileSharingResult {
+    isUnsharing: boolean;
+    isRemovingAccess: boolean;
+    onUnshareFiles: (files: DialFile[]) => void;
+    onRemoveFilesAccess: (files: DialFile[]) => void;
+}
+/**
+ * Manages the unshare/remove-access mutations. Bumps `useDialFileListing`'s
+ * shared retry counter after each mutation settles rather than holding its
+ * own cache copy.
+ */
+export declare const useDialFileSharing: ({ filesApi, bucket, rootLabel, bumpRetry, onNotification, onOperationSuccess, removeSharedRootItems, }: UseDialFileSharingOptions) => UseDialFileSharingResult;
+//# sourceMappingURL=useDialFileSharing.d.ts.map

package/files/useDialFileSharing/useDialFileSharing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDialFileSharing.d.ts","sourceRoot":"","sources":["../../../src/files/useDialFileSharing/useDialFileSharing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAOjE,OAAO,KAAK,EACV,uBAAuB,EACvB,yBAAyB,EAC1B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD,gDAAgD;AAChD,MAAM,WAAW,yBAAyB;IACxC,mEAAmE;IACnE,QAAQ,EAAE,YAAY,CAAC;IACvB,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,qFAAqF;IACrF,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,oFAAoF;IACpF,cAAc,CAAC,EAAE,CAAC,YAAY,EAAE,uBAAuB,KAAK,IAAI,CAAC;IACjE,uGAAuG;IACvG,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,IAAI,CAAC;IAChE,0FAA0F;IAC1F,qBAAqB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CACnD;AAED,+CAA+C;AAC/C,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC;IAC5C,mBAAmB,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC;CAClD;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,wGAQhC,yBAAyB,KAAG,wBAsF9B,CAAC"}

package/files/useDialFileSharing/useDialFileSharing.js

@@ -1,70 +1,76 @@
-import { FileManagerNotificationReason as e } from "../dial-file-manager.types.js";
-import { resolveDialFileApiPath as t } from "../resolve-dial-file-api-path.js";
-import { useCallback as n, useState as r } from "react";
-import { NotificationVariant as i } from "@epam/ai-dial-ui-kit";
+import { FileManagerNotificationReason as e, FileOperationKind as t } from "../dial-file-manager.types.js";
+import { resolveDialFileApiPath as n } from "../resolve-dial-file-api-path.js";
+import { useCallback as r, useState as i } from "react";
+import { NotificationVariant as a } from "@epam/ai-dial-ui-kit";
 //#region src/files/useDialFileSharing/useDialFileSharing.ts
-var a = ({ filesApi: a, bucket: o, rootLabel: s, bumpRetry: c, onNotification: l }) => {
-	let [u, d] = r(!1), [f, p] = r(!1);
+var o = ({ filesApi: o, bucket: s, rootLabel: c, bumpRetry: l, onNotification: u, onOperationSuccess: d, removeSharedRootItems: f }) => {
+	let [p, m] = i(!1), [h, g] = i(!1);
 	return {
-		isUnsharing: u,
-		isRemovingAccess: f,
-		onUnshareFiles: n((n) => {
-			n.length !== 0 && (async () => {
-				d(!0);
-				let r = n.map((e) => {
-					let n = e.bucket ?? o;
+		isUnsharing: p,
+		isRemovingAccess: h,
+		onUnshareFiles: r((r) => {
+			r.length !== 0 && (async () => {
+				m(!0);
+				let i = r.map((e) => {
+					let t = e.bucket ?? s;
 					return {
-						bucket: n,
-						path: t(e, n, s)
+						bucket: t,
+						path: n(e, t, c)
 					};
 				});
 				try {
-					await a.discardShared(r), c();
+					await o.discardShared(i), f?.(r.map((e) => e.name)), d?.({
+						kind: t.FilesUnshared,
+						name: r[0].name,
+						count: r.length
+					}), l();
 				} catch {
-					l?.({
-						variant: i.Error,
+					u?.({
+						variant: a.Error,
 						reason: e.UnshareFailed
 					});
 				} finally {
-					d(!1);
+					m(!1);
 				}
 			})();
 		}, [
-			o,
 			s,
-			l,
-			a,
-			c
+			c,
+			u,
+			d,
+			f,
+			o,
+			l
 		]),
-		onRemoveFilesAccess: n((n) => {
-			n.length !== 0 && (async () => {
-				p(!0);
-				let r = n.map((e) => {
-					let n = e.bucket ?? o;
+		onRemoveFilesAccess: r((t) => {
+			t.length !== 0 && (async () => {
+				g(!0);
+				let r = t.map((e) => {
+					let t = e.bucket ?? s;
 					return {
-						bucket: n,
-						path: t(e, n, s)
+						bucket: t,
+						path: n(e, t, c)
 					};
 				});
 				try {
-					await a.revokeAccess(r), c();
+					await o.revokeAccess(r), l();
 				} catch {
-					l?.({
-						variant: i.Error,
+					u?.({
+						variant: a.Error,
 						reason: e.RemoveAccessFailed
 					});
 				} finally {
-					p(!1);
+					g(!1);
 				}
 			})();
 		}, [
-			o,
 			s,
-			l,
-			a,
-			c
+			c,
+			u,
+			o,
+			l
 		])
 	};
 };
 //#endregion
-export { a as useDialFileSharing };
+export { o as useDialFileSharing };