@epam/ai-dial-chat-hooks 1.3.0-dev.9 → 1.3.0-dev.90

package/files/dial-file-manager-mapping.util.js

@@ -1,54 +1,55 @@
-import { CORE_PERMISSION_MAP as e } from "./dial-file-manager.model.js";
-import { buildSharedItemVirtualPath as t, dialCorePathToRelative as n } from "./dial-file-manager-path.util.js";
-import { ListFilesItemDtoNodeTypeEnum as r } from "@epam/ai-dial-chat-api-client";
-import { DialFileManagerTabs as i, DialFileNodeType as a } from "@epam/ai-dial-react-file-manager";
+import { safeDecodeURI as e } from "../shared/string-utils.js";
+import { CORE_PERMISSION_MAP as t } from "./dial-file-manager.model.js";
+import { buildSharedItemVirtualPath as n, dialCorePathToRelative as r } from "./dial-file-manager-path.util.js";
+import { ListFilesItemDtoNodeTypeEnum as i } from "@epam/ai-dial-chat-api-client";
+import { DialFileManagerTabs as a, DialFileNodeType as o } from "@epam/ai-dial-react-file-manager";
 //#region src/files/dial-file-manager-mapping.util.ts
-var o = (t) => {
-	if (!t?.length) return;
-	let n = t.map((t) => e[t.toUpperCase()]).filter((e) => e != null);
+var s = (e) => {
+	if (!e?.length) return;
+	let n = e.map((e) => t[e.toUpperCase()]).filter((e) => e != null);
 	return n.length > 0 ? n : void 0;
-}, s = (e, t) => {
+}, c = (e, t) => {
 	let n = t.find((e) => e.success);
 	if (n != null) return e.find(({ dto: e }) => e.sourcePath === n.sourcePath && e.destinationPath === n.destinationPath) ?? e.find(({ dto: e }) => e.destinationPath === n.destinationPath) ?? e[0];
-}, c = (e, t, n, i, s) => {
-	let l = e.get(n);
-	if (l == null) return [];
-	let u = i.replace(/\/$/, "");
-	return l.map((l) => {
-		let d = l.nodeType === r.Folder, f = l.name, p = d ? `${u}/${f}/` : `${u}/${f}`, m = {
-			id: l.path,
+}, l = (e, t, n, r, a) => {
+	let c = e.get(n);
+	if (c == null) return [];
+	let u = r.replace(/\/$/, "");
+	return c.map((c) => {
+		let d = c.nodeType === i.Folder, f = c.name, p = d ? `${u}/${f}/` : `${u}/${f}`, m = {
+			id: c.path,
 			name: f,
 			path: p,
-			url: l.url,
-			parentPath: i,
-			nodeType: d ? a.FOLDER : a.ITEM,
-			folderId: s,
-			bucket: l.bucket,
-			author: l.author,
-			resourceType: l.resourceType,
-			contentLength: l.contentLength,
-			contentType: l.contentType,
-			updatedAt: l.updatedAt ? new Date(l.updatedAt).toISOString() : void 0
+			url: c.url,
+			parentPath: r,
+			nodeType: d ? o.FOLDER : o.ITEM,
+			folderId: a,
+			bucket: c.bucket,
+			author: c.author,
+			resourceType: c.resourceType,
+			contentLength: c.contentLength,
+			contentType: c.contentType,
+			updatedAt: c.updatedAt ? new Date(c.updatedAt).toISOString() : void 0
 		};
 		if (d) {
 			let r = `${n}${f}/`;
-			m.permissions = o(l.permissions) ?? o(t.get(r)), m.items = c(e, t, r, p, l.path);
+			m.permissions = s(c.permissions) ?? s(t.get(r)), m.items = l(e, t, r, p, c.path);
 		}
 		return m;
 	});
-}, l = (e, t, n, i) => {
+}, u = (e, t, n, r) => {
 	let a = new Map(e), o = [...a.get(t) ?? []], s = {
 		name: n.name,
 		path: n.path,
 		folderId: n.folderId,
-		nodeType: r.Folder,
+		nodeType: i.Folder,
 		bucket: n.bucket,
 		parentPath: n.parentPath || void 0,
 		url: n.path,
-		permissions: i
+		permissions: r
 	};
 	return o.some((e) => e.name.toLowerCase() === n.name.toLowerCase()) || o.push(s), a.set(t, o), a;
-}, u = (e, t, n) => {
+}, d = (e, t, n) => {
 	if (!e) return e;
 	let r = typeof n == "string" ? { status: n } : n, i = e.files.map((e) => e.id === t ? {
 		...e,
@@ -58,16 +59,16 @@ var o = (t) => {
 		...e,
 		files: i
 	};
-}, d = (e, t, r, a, o) => {
-	if (t === i.All) return Promise.reject(/* @__PURE__ */ Error("fetchByTab cannot list the All tab; list each section instead"));
-	if (t === i.Shared) {
-		if (a === "") return e.listSharedFiles({ path: void 0 }).then((e) => ({ items: e.items }));
-		let t = a.indexOf("/"), r = t === -1 ? a : a.slice(0, t), i = o.get(r);
-		if (i) {
-			let r = n(i.dialCorePath, i.bucket) + (t === -1 ? "" : a.slice(t + 1));
+}, f = (e, t, n, i, o) => {
+	if (t === a.All) return Promise.reject(/* @__PURE__ */ Error("fetchByTab cannot list the All tab; list each section instead"));
+	if (t === a.Shared) {
+		if (i === "") return e.listSharedFiles({ path: void 0 }).then((e) => ({ items: e.items }));
+		let t = i.indexOf("/"), n = t === -1 ? i : i.slice(0, t), a = o.get(n);
+		if (a) {
+			let n = r(a.dialCorePath, a.bucket) + (t === -1 ? "" : i.slice(t + 1));
 			return e.listFiles({
-				bucket: i.bucket,
-				path: r,
+				bucket: a.bucket,
+				path: n,
 				permissions: !0
 			}).then((e) => ({
 				items: e.items,
@@ -76,66 +77,80 @@ var o = (t) => {
 		}
 		return Promise.resolve({ items: [] });
 	}
-	return t === i.Organization ? e.listPublicFiles({ path: a || void 0 }).then((e) => ({ items: e.items })) : e.listFiles({
-		bucket: r,
-		path: a,
+	return t === a.Organization ? e.listPublicFiles({ path: i || void 0 }).then((e) => ({ items: e.items })) : e.listFiles({
+		bucket: n,
+		path: i,
 		permissions: !0
 	}).then((e) => ({
 		items: e.items,
 		permissions: e.permissions
 	}));
-}, f = async (e, t, r, a, o) => {
-	if (t === i.Shared) {
-		let t = a.indexOf("/"), r = t === -1 ? a : a.slice(0, t), i = o.get(r);
-		if (!i) return { items: [] };
-		let s = n(i.dialCorePath, i.bucket) + (t === -1 ? "" : a.slice(t + 1)), { items: c } = await e.listFiles({
-			bucket: i.bucket,
+}, p = async (e, t, n, i, o) => {
+	if (t === a.Shared) {
+		let t = i.indexOf("/"), n = t === -1 ? i : i.slice(0, t), a = o.get(n);
+		if (!a) return { items: [] };
+		let s = r(a.dialCorePath, a.bucket) + (t === -1 ? "" : i.slice(t + 1)), { items: c } = await e.listFiles({
+			bucket: a.bucket,
 			path: s,
 			permissions: !0,
 			recursive: !0
 		});
 		return { items: c };
 	}
-	if (t === i.Organization) {
+	if (t === a.Organization) {
 		let { items: t } = await e.listPublicFiles({
-			path: a || void 0,
+			path: i || void 0,
 			recursive: !0
 		});
 		return { items: t };
 	}
 	let { items: s } = await e.listFiles({
-		bucket: r,
-		path: a,
+		bucket: n,
+		path: i,
 		permissions: !0,
 		recursive: !0
 	});
 	return { items: s };
-}, p = (e, i, o) => {
-	let s = e.nodeType === r.Folder, c = e.name, l = e.bucket ?? i, u = n(e.url ?? e.path ?? "", l).replace(/\/$/, ""), d = u.lastIndexOf("/"), f = t(d > 0 ? u.slice(0, d) : "", o, !1), p = s ? `${f}/${c}/` : `${f}/${c}`;
+}, m = (e, t, n) => {
+	if (t === "") return { virtualRoot: `/${e}` };
+	let i = t.indexOf("/"), a = i === -1 ? t : t.slice(0, i), o = n.get(a);
+	if (!o) return;
+	let s = i === -1 ? "" : t.slice(i + 1);
+	return {
+		virtualRoot: `/${e}/${t.replace(/\/$/, "")}`,
+		apiRoot: r(o.dialCorePath, o.bucket) + s
+	};
+}, h = (t) => t.split("/").filter(Boolean).map(e), g = (e, t, a, s) => {
+	let c = e.nodeType === i.Folder, l = e.name, u = e.bucket ?? t, d = r(e.url ?? e.path ?? "", u).replace(/\/$/, ""), f = d.lastIndexOf("/"), p = f > 0 ? d.slice(0, f) : "", m;
+	if (s) {
+		let e = s.apiRoot ? h(p).slice(h(s.apiRoot).length) : [];
+		m = [s.virtualRoot, ...e].join("/");
+	} else m = n(p, a, !1);
+	let g = c ? `${m}/${l}/` : `${m}/${l}`;
 	return {
 		id: e.path,
-		name: c,
-		path: p,
+		name: l,
+		path: g,
 		url: e.url,
-		parentPath: f,
-		nodeType: s ? a.FOLDER : a.ITEM,
+		parentPath: m,
+		nodeType: c ? o.FOLDER : o.ITEM,
 		folderId: e.folderId,
-		bucket: l,
+		bucket: u,
 		author: e.author,
 		contentLength: e.contentLength,
 		contentType: e.contentType,
 		updatedAt: e.updatedAt ? new Date(e.updatedAt).toISOString() : void 0
 	};
-}, m = (e, t) => ({
+}, _ = (e, t) => ({
 	...t,
 	bucket: e.bucket ?? t.bucket,
 	author: e.author,
 	contentLength: e.contentLength,
 	contentType: e.contentType,
 	resourceType: e.resourceType ?? t.resourceType,
-	permissions: o(e.permissions) ?? t.permissions,
+	permissions: s(e.permissions) ?? t.permissions,
 	updatedAt: e.updatedAt ? new Date(e.updatedAt).toISOString() : t.updatedAt,
 	createdAt: e.createdAt ? new Date(e.createdAt).toISOString() : t.createdAt
 });
 //#endregion
-export { c as buildFromCache, d as fetchByTab, f as fetchForSearch, s as findFirstSuccessfulCopyMoveItem, o as mapCorePermissions, m as mapFileMetadataToDialFile, p as mapSearchItem, l as mergeCreatedFolderIntoCache, u as updateEntry };
+export { l as buildFromCache, m as buildSharedSearchScope, f as fetchByTab, p as fetchForSearch, c as findFirstSuccessfulCopyMoveItem, s as mapCorePermissions, _ as mapFileMetadataToDialFile, g as mapSearchItem, u as mergeCreatedFolderIntoCache, d as updateEntry };

package/files/dial-file-manager-path.util.d.ts

@@ -0,0 +1,48 @@
+import { DialFileManagerActionProfile } from '@epam/ai-dial-chat-shared';
+import { DialFile } from '@epam/ai-dial-react-file-manager';
+import { DialFileManagerSection, SharedRootMeta } from './dial-file-manager.model';
+export declare const hasForbiddenNameSymbols: (name: string, forbiddenSymbolsRegExp?: RegExp) => boolean;
+export declare const normalizeVirtualPath: (value: string) => string;
+export declare const getVirtualPathName: (virtualPath: string, fallback: string) => string;
+export declare const formatOperationFolderName: (destinationFolder: string, rootLabel: string) => string;
+export declare const findFolderByVirtualPath: (nodes: DialFile[], virtualPath: string) => DialFile | undefined;
+export declare const hasDialFileWritePermission: (folder?: DialFile) => boolean;
+export declare const findDialFileByPath: (nodes: DialFile[], targetPath: string) => DialFile | undefined;
+/** Copy/Move/Duplicate are Browse/Full-only — the attach picker excludes them. */
+export declare const isCopyMoveDuplicateAllowed: (actionProfile: DialFileManagerActionProfile) => boolean;
+/** Share/Unshare/Remove access are Full-only — Browse and Attach never expose them. */
+export declare const isShareActionsAllowed: (actionProfile: DialFileManagerActionProfile) => boolean;
+export declare const parseNewFolderVirtualPath: (newFolderVirtualPath: string, rootLabel: string) => {
+    parentVirtualPath: string;
+    name: string;
+};
+/** Strip the "files/{bucket}/" prefix from a DIAL Core URL to get the path within the bucket. */
+export declare const dialCorePathToRelative: (dialCorePath: string, bucket: string) => string;
+/**
+ * Converts a bucket-relative path (e.g. "reports/q1.pdf") to the virtual
+ * DialFile.path format ("/My files/reports/q1.pdf") that ui-kit compares
+ * row items against for `sharedByMePaths`/`sharedWithMeIds` gating — the
+ * DIAL Core resource path ("files/{bucket}/...") is a different identifier
+ * space and never matches. The input comes from a percent-encoded DIAL Core
+ * url, so each segment is decoded independently to reach the same decoded
+ * space the listing rows live in.
+ */
+export declare const buildSharedItemVirtualPath: (relativePath: string, rootLabel: string, isFolder: boolean) => string;
+/**
+ * Resolves the effective bucket and path for a write operation on the Shared tab.
+ * For Shared tab items, the first segment of apiPath is the shared root folder name
+ * whose owner bucket is stored in sharedRootMeta.
+ */
+export declare const resolveOwnerCoords: (apiPath: string, sharedRootMeta: Map<string, SharedRootMeta>, fallbackBucket: string) => {
+    bucket: string;
+    path: string;
+};
+/** Returns the section whose root label is the first segment of `virtualPath`, or `undefined` when none matches. */
+export declare const resolveSectionByPath: <TSection extends DialFileManagerSection>(virtualPath: string, sections: readonly TSection[]) => TSection | undefined;
+/** Returns a new set containing every path from each of `pathSets`. */
+export declare const unionPathSets: (pathSets: readonly ReadonlySet<string>[]) => Set<string>;
+/** Returns `true` when both sets contain exactly the same paths. */
+export declare const hasSamePaths: (a: ReadonlySet<string>, b: ReadonlySet<string>) => boolean;
+/** Returns `sections` with every root label usable as a unique first path segment, falling back to the tab id. */
+export declare const withRoutableRootLabels: <TSection extends DialFileManagerSection>(sections: readonly TSection[]) => TSection[];
+//# sourceMappingURL=dial-file-manager-path.util.d.ts.map

package/files/dial-file-manager-path.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dial-file-manager-path.util.d.ts","sourceRoot":"","sources":["../../src/files/dial-file-manager-path.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAMjE,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAEnC,eAAO,MAAM,uBAAuB,GAClC,MAAM,MAAM,EACZ,yBAAyB,MAAM,KAC9B,OAQF,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,OAAO,MAAM,KAAG,MAEpD,CAAC;AAOF,eAAO,MAAM,kBAAkB,GAC7B,aAAa,MAAM,EACnB,UAAU,MAAM,KACf,MAGF,CAAC;AAEF,eAAO,MAAM,yBAAyB,GACpC,mBAAmB,MAAM,EACzB,WAAW,MAAM,KAChB,MAIa,CAAC;AAEjB,eAAO,MAAM,uBAAuB,GAClC,OAAO,QAAQ,EAAE,EACjB,aAAa,MAAM,KAClB,QAAQ,GAAG,SASb,CAAC;AAEF,eAAO,MAAM,0BAA0B,GAAI,SAAS,QAAQ,KAAG,OACG,CAAC;AAEnE,eAAO,MAAM,kBAAkB,GAC7B,OAAO,QAAQ,EAAE,EACjB,YAAY,MAAM,KACjB,QAAQ,GAAG,SAOb,CAAC;AAEF,kFAAkF;AAClF,eAAO,MAAM,0BAA0B,GACrC,eAAe,4BAA4B,KAC1C,OAYF,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,qBAAqB,GAChC,eAAe,4BAA4B,KAC1C,OAA8D,CAAC;AAElE,eAAO,MAAM,yBAAyB,GACpC,sBAAsB,MAAM,EAC5B,WAAW,MAAM,KAChB;IAAE,iBAAiB,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAa3C,CAAC;AAEF,iGAAiG;AACjG,eAAO,MAAM,sBAAsB,GACjC,cAAc,MAAM,EACpB,QAAQ,MAAM,KACb,MAKF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,GACrC,cAAc,MAAM,EACpB,WAAW,MAAM,EACjB,UAAU,OAAO,KAChB,MASF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAC7B,SAAS,MAAM,EACf,gBAAgB,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,EAC3C,gBAAgB,MAAM,KACrB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAahC,CAAC;AAEF,oHAAoH;AACpH,eAAO,MAAM,oBAAoB,GAAI,QAAQ,SAAS,sBAAsB,EAC1E,aAAa,MAAM,EACnB,UAAU,SAAS,QAAQ,EAAE,KAC5B,QAAQ,GAAG,SAQb,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,aAAa,GACxB,UAAU,SAAS,WAAW,CAAC,MAAM,CAAC,EAAE,KACvC,GAAG,CAAC,MAAM,CAIZ,CAAC;AAEF,oEAAoE;AACpE,eAAO,MAAM,YAAY,GACvB,GAAG,WAAW,CAAC,MAAM,CAAC,EACtB,GAAG,WAAW,CAAC,MAAM,CAAC,KACrB,OAMF,CAAC;AAEF,kHAAkH;AAClH,eAAO,MAAM,sBAAsB,GAAI,QAAQ,SAAS,sBAAsB,EAC5E,UAAU,SAAS,QAAQ,EAAE,KAC5B,QAAQ,EAYV,CAAC"}

package/files/dial-file-manager.model.d.ts

@@ -0,0 +1,36 @@
+import { DialFileManagerTabs, DialFilePermission, FileManagerColumnKey } from '@epam/ai-dial-react-file-manager';
+/** Max number of files uploaded concurrently within a single upload batch. */
+export declare const UPLOAD_CONCURRENCY = 3;
+/** Name reserved for the hidden marker file used to create empty folders. */
+export declare const RESERVED_MARKER_NAME = ".dial_folder";
+export declare const PATH_SEPARATOR_REGEXP: RegExp;
+export declare const DATE_OPTIONS: Intl.DateTimeFormatOptions;
+export declare const COLUMNS_MY_FILES: FileManagerColumnKey[];
+export declare const COLUMNS_SHARED: FileManagerColumnKey[];
+export declare const COLUMNS_ORGANIZATION: FileManagerColumnKey[];
+export declare const CORE_PERMISSION_MAP: Record<string, DialFilePermission>;
+/** Owner-bucket resolution metadata for a Shared-tab root folder, keyed by its display name. */
+export interface SharedRootMeta {
+    bucket: string;
+    /** DIAL Core URL of the shared root item, e.g. "files/owner-bucket/some-folder/" */
+    dialCorePath: string;
+}
+/** Source tabs `useDialFileManagerSections` can merge into the All tab, in display order. */
+export declare const DIAL_FILE_MANAGER_SECTION_TABS: readonly DialFileManagerTabs[];
+/** One source tab rendered as a top-level folder of the All view. */
+export interface DialFileManagerSection {
+    /** Source tab backing this section — `MyFiles`, `Shared` or `Organization`. */
+    tab: DialFileManagerTabs;
+    /** Display name of the section's top-level folder; also the first segment of its virtual paths. An empty, slash-containing or repeated label is replaced by the tab id. */
+    rootLabel: string;
+}
+export interface PreparedCopyMoveItem<TDto> {
+    dto: TDto;
+    destinationName: string;
+}
+export interface CopyMoveResult {
+    success?: boolean;
+    sourcePath?: string;
+    destinationPath?: string;
+}
+//# sourceMappingURL=dial-file-manager.model.d.ts.map

package/files/dial-file-manager.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dial-file-manager.model.d.ts","sourceRoot":"","sources":["../../src/files/dial-file-manager.model.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,kCAAkC,CAAC;AAE1C,8EAA8E;AAC9E,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,6EAA6E;AAC7E,eAAO,MAAM,oBAAoB,iBAAc,CAAC;AAEhD,eAAO,MAAM,qBAAqB,QAAU,CAAC;AAQ7C,eAAO,MAAM,YAAY,EAAE,IAAI,CAAC,qBAO/B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,oBAAoB,EAKlD,CAAC;AAGF,eAAO,MAAM,cAAc,EAAE,oBAAoB,EAIhD,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,oBAAoB,EAMtD,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAIlE,CAAC;AAEF,gGAAgG;AAChG,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,6FAA6F;AAC7F,eAAO,MAAM,8BAA8B,EAAE,SAAS,mBAAmB,EAIxE,CAAC;AAEF,qEAAqE;AACrE,MAAM,WAAW,sBAAsB;IACrC,+EAA+E;IAC/E,GAAG,EAAE,mBAAmB,CAAC;IACzB,2KAA2K;IAC3K,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB,CAAC,IAAI;IACxC,GAAG,EAAE,IAAI,CAAC;IACV,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/files/dial-file-manager.types.d.ts

@@ -0,0 +1,327 @@
+import { DialFileManagerActionProfile, DialFileManagerVariant, FileUploadValidationResult, FileUploadBatchState } from '@epam/ai-dial-chat-shared';
+import { DialCopiedItem, DialDeletedItem, DialFile, DialFileManagerActions, DialFileManagerTabs, DialUploadFileItem, FileManagerColumnKey } from '@epam/ai-dial-react-file-manager';
+import { NotificationVariant } from '@epam/ai-dial-ui-kit';
+import { DialFilesApi } from './dial-files-api';
+import { DownloadDestinationHandlers } from './download-destination';
+/**
+ * Library-owned identifier for why a file-manager hook is surfacing an
+ * `onNotification` event, replacing a pre-translated toast message. The host
+ * maps each reason to its own translated string.
+ */
+export declare enum FileManagerNotificationReason {
+    /** A folder listing fetch (initial load, expand, invalidate-refetch, or popup preload) failed. */
+    FolderLoadFailed = "folderLoadFailed",
+    /** A single-file/folder metadata fetch (`onGetInfo`) failed. */
+    MetadataLoadFailed = "metadataLoadFailed",
+    /** `onCreateFolder`'s `createFolder` call failed. */
+    FolderCreateFailed = "folderCreateFailed",
+    /** `onDownloadFiles` failed for a single file/folder selection. */
+    DownloadFileFailed = "downloadFileFailed",
+    /** `onDownloadFiles` failed for a multi-item selection. */
+    DownloadFilesFailed = "downloadFilesFailed",
+    /** `onDeleteFiles` deleted at least one item successfully; `count`/`name`/`folder` describe the result. */
+    FilesDeleted = "filesDeleted",
+    /** `onDeleteFiles` completed with at least one failure alongside a success; `names`/`restCount` list the failures. */
+    FilesDeletePartiallyFailed = "filesDeletePartiallyFailed",
+    /** `onDeleteFiles`'s `deleteFiles` request itself rejected. */
+    DeleteFailed = "deleteFailed",
+    /** `onMoveToFiles`'s rename branch failed for every item in the batch. */
+    RenameFailed = "renameFailed",
+    /** `onMoveToFiles`'s rename branch failed for some items; `count` is the failed count. */
+    RenamePartiallyFailed = "renamePartiallyFailed",
+    /** `onMoveToFiles`'s move branch failed for every item in the batch. */
+    MoveFailed = "moveFailed",
+    /** `onMoveToFiles`'s move branch failed for some items; `count` is the failed count. */
+    MovePartiallyFailed = "movePartiallyFailed",
+    /** `onCopyFiles` failed for every item in the batch. */
+    CopyFailed = "copyFailed",
+    /** `onCopyFiles` failed for some items; `count` is the failed count. */
+    CopyPartiallyFailed = "copyPartiallyFailed",
+    /** `useDialFileSharing`'s `onUnshareFiles` request failed. */
+    UnshareFailed = "unshareFailed",
+    /** `useDialFileSharing`'s `onRemoveFilesAccess` request failed. */
+    RemoveAccessFailed = "removeAccessFailed",
+    /** `useDialFileUploadBatch`'s plain-file batch had zero successful uploads. */
+    UploadFailed = "uploadFailed",
+    /** `useDialFileUploadBatch`'s plain-file batch completed (fully or partially successful), or `onUploadArchive` extracted every entry successfully. */
+    UploadCompleted = "uploadCompleted",
+    /** `onUploadArchive` extracted zero entries successfully; `names`/`restCount` list the failures. */
+    UploadArchiveFailed = "uploadArchiveFailed",
+    /** `onUploadArchive` extracted some entries successfully and some failed; `count`/`names`/`restCount` describe the failures. */
+    UploadArchivePartiallyFailed = "uploadArchivePartiallyFailed",
+    /** `onUploadArchive`'s `uploadArchive` request itself rejected. */
+    UploadArchiveRequestFailed = "uploadArchiveRequestFailed",
+    /** A copy/move targeted a destination in a different All-view section from its source items; no request was made. */
+    CrossSectionTransferUnsupported = "crossSectionTransferUnsupported"
+}
+/**
+ * Structured toast event emitted by file-manager hooks. `reason` carries a
+ * library-owned identifier the host translates; `message` is an optional
+ * pre-rendered fallback for notifications a hook composes without a `reason`
+ * (e.g. hosts still authoring their own text for hooks not yet covered by a
+ * `FileManagerNotificationReason` member). The remaining fields carry the
+ * data a host needs to interpolate its translated string for reasons whose
+ * wording depends on more than the reason itself.
+ */
+export interface FileManagerNotification {
+    variant: NotificationVariant;
+    title?: string;
+    message?: string;
+    reason?: FileManagerNotificationReason;
+    /** Number of items the notification covers (e.g. a partial-failure count). */
+    count?: number;
+    /** Name of the affected entity or first successfully affected item. */
+    name?: string;
+    /** Source or destination folder name the notification refers to. */
+    folder?: string;
+    /** Up to the first 5 names affected by a partial/full failure list (e.g. archive extraction, delete). */
+    names?: string[];
+    /** Count of additional affected items beyond `names`' limit. */
+    restCount?: number;
+}
+/**
+ * Reason a file/folder name failed `onCreateFolderValidate`/
+ * `onRenameValidate`'s validation, used as the discriminant of
+ * `FileNameValidationError`.
+ */
+export declare enum FileNameValidationErrorReason {
+    Empty = "empty",
+    ForbiddenSymbols = "forbiddenSymbols",
+    ReservedName = "reservedName",
+    TooLong = "tooLong",
+    DuplicateName = "duplicateName"
+}
+/**
+ * Discriminated validation failure returned by `onCreateFolderValidate`/
+ * `onRenameValidate` instead of a pre-translated message; `null` means the
+ * name is valid. The host maps each `reason` to its own translated string.
+ */
+export type FileNameValidationError = {
+    reason: FileNameValidationErrorReason.Empty;
+} | {
+    reason: FileNameValidationErrorReason.ForbiddenSymbols;
+    symbols: string;
+} | {
+    reason: FileNameValidationErrorReason.ReservedName;
+} | {
+    reason: FileNameValidationErrorReason.TooLong;
+    maxLength: number;
+} | {
+    reason: FileNameValidationErrorReason.DuplicateName;
+    existingName: string;
+};
+/**
+ * Kind of mutation `useDialFileMutations` just completed successfully, for
+ * `onOperationSuccess`. Delete has no member here — its success feedback
+ * stays a structured `onNotification` event since it needs a count/folder,
+ * not a single named entity.
+ */
+export declare enum FileOperationKind {
+    FolderCreated = "folderCreated",
+    FileRenamed = "fileRenamed",
+    FileDownloaded = "fileDownloaded",
+    FilesDownloaded = "filesDownloaded",
+    FileCopied = "fileCopied",
+    FilesCopied = "filesCopied",
+    FileMoved = "fileMoved",
+    FilesMoved = "filesMoved",
+    /** A copy whose every item landed in its own source folder (Duplicate). */
+    FileDuplicated = "fileDuplicated",
+    FilesDuplicated = "filesDuplicated",
+    /** One or more shared-with-me items were removed from the Shared tab. */
+    FilesUnshared = "filesUnshared"
+}
+/**
+ * Structured success event `useDialFileMutations` emits through
+ * `onOperationSuccess` instead of calling an application notification
+ * service directly.
+ */
+export interface FileOperationSuccessEvent {
+    /** Which mutation just succeeded. */
+    kind: FileOperationKind;
+    /** Name of the affected entity or first successfully affected item, when applicable. */
+    name?: string;
+    /** Number of items the operation covered, when applicable. */
+    count?: number;
+    /**
+     * Destination folder as a slash-joined virtual path starting at the root
+     * label (e.g. `My files/reports`), for copy/move/duplicate operations.
+     */
+    destinationFolderName?: string;
+    /**
+     * Whether the affected item is a folder rather than a file. Set for rename,
+     * copy, move, and duplicate events; on a multi-item event it describes the
+     * first successfully affected item (the one `name` refers to).
+     */
+    isFolder?: boolean;
+}
+export interface UseDialFileManagerOptions {
+    /** Injected operation port used for every file-manager network call. */
+    filesApi: DialFilesApi;
+    /** DIAL Core bucket to browse (used only for my_files tab). */
+    bucket: string;
+    /** Display name for the root folder node. Defaults to `'My files'`. */
+    rootLabel?: string;
+    /** Active tab — drives listing source and per-tab options. Defaults to MyFiles. */
+    activeTab?: DialFileManagerTabs;
+    /** When false, the listing issues no `DialFilesApi` call and reports `isLoading: false`. Defaults to `true`. */
+    isActive?: boolean;
+    /** Changing this value resets cache and navigation exactly like an `activeTab` change. Defaults to `undefined`. */
+    sessionKey?: string;
+    /** Called when a file-manager action 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;
+    /** Regexp of characters forbidden in file/folder names (e.g. NOT_ALLOWED_SYMBOLS_REGEXP). */
+    forbiddenSymbolsRegExp?: RegExp;
+    /** Which host is driving this hook instance. Defaults to `Attach`. */
+    variant?: DialFileManagerVariant;
+    /** Gates which actions are exposed. Defaults to the value derived from `variant`. */
+    actionProfile?: DialFileManagerActionProfile;
+    /**
+     * Host-supplied action label text, keyed by `DialFileManagerActions`. The
+     * hook computes which actions are visible/enabled per tab/variant/
+     * actionProfile and intersects that gating with this map — an action the
+     * gating allows but this map omits is left out of `actionLabels`.
+     */
+    labels: Partial<Record<DialFileManagerActions, string>>;
+    /** BCP-47 locale string for date formatting, replacing `i18n.language`. */
+    locale: string;
+    /** Translated tooltip shown on the disabled New/Upload button. */
+    disabledNewButtonTooltip: string;
+    /** Host-injected browser "Save As"/auto-download seam for `onDownloadFiles`. */
+    downloadDestination: DownloadDestinationHandlers;
+    /**
+     * Builds a translated message from a structured validation-error reason,
+     * for `onCreateFolderValidate`/`onRenameValidate`. `item` is passed for a
+     * rename (so the host can distinguish file vs. folder wording) and
+     * omitted for folder creation.
+     */
+    buildValidationErrorMessage: (error: FileNameValidationError, item?: DialFile) => string;
+}
+export interface UseDialFileManagerResult {
+    /** Hierarchical items for DialFileManager's `items` prop. */
+    items: DialFile[];
+    /** True while the current folder is loading. */
+    isLoading: boolean;
+    /** Non-null when the last fetch failed. */
+    error: string | null;
+    /** Current path in DialFileManager format (e.g. `"/My files"`, `"/My files/reports/"`). */
+    path: string;
+    /** Pass directly to DialFileManager's `onPathChange`. */
+    onPathChange: (nextPath?: string) => void;
+    /** Re-runs the fetch for the current `folderPath`. */
+    retry: () => void;
+    /**
+     * Search: called by DialFileManager when the user types in the search box.
+     * `folder` is accepted for API parity with DialFileManager but is intentionally
+     * unused — this hook always searches from the active-tab root stored in
+     * `folderPath`, not from the passed-in `folder` (see design decision D3).
+     */
+    onSearchFiles: (folder: string, query: string) => void;
+    /** Search: true while a search request is in flight. */
+    isSearching: boolean;
+    /** Search: flat, unfiltered recursive listing of the current folder, or null when search is not active. */
+    searchResults: DialFile[] | null;
+    /** Search: clears results and exits search mode. */
+    clearSearchResults: () => void;
+    /** Tree: controlled set of expanded folder virtual paths. */
+    expandedPaths: Set<string>;
+    /** Tree: expanded or destination-popup virtual paths whose children are already cached. */
+    loadedPaths: Set<string>;
+    /** Tree: called by DialFileManager when a folder is expanded/collapsed. */
+    onExpandedPathsChange: (paths: Set<string>) => void;
+    /** Destination folder popup: preloads the browsed folder without changing the outer grid path. */
+    onFolderPopupPathChange: (nextPath?: string) => void;
+    /** Destination folder popup: normalized virtual paths currently being preloaded. */
+    folderPopupLoadingPaths: Set<string>;
+    /** Upload: start a new batch. */
+    onUploadFiles: (files: DialUploadFileItem[], destinationFolder: string) => void;
+    /** Upload: extracts and uploads a ZIP archive's entries to the destination folder. */
+    onUploadArchive: (file: File, name: string, destinationFolder: string) => void;
+    /** Upload: validate file names before upload (called by DialFileManager). */
+    onValidateUpload: (files: DialUploadFileItem[], existingFiles: DialFile[], destinationFolder: string) => Promise<FileUploadValidationResult>;
+    /** Upload: current batch state (null when idle). */
+    uploadBatchState: FileUploadBatchState | null;
+    /** Upload: abort all in-flight and queued uploads. */
+    cancelUpload: () => void;
+    /** Upload: abort one queued or in-flight upload by its entry id. */
+    cancelUploadFile: (id: string) => void;
+    /** Upload: empty the upload queue. */
+    clearUploadBatch: () => void;
+    /** Folder creation: called when user confirms a new folder name. */
+    onCreateFolder: (file: DialUploadFileItem, folderPath: string, fileId: string) => Promise<void>;
+    /** Folder creation: inline synchronous validation (returns error message or null). */
+    onCreateFolderValidate: (name: string, parentFolder: DialFile) => string | null;
+    /** True while a folder creation request is in flight. */
+    isCreatingFolder: boolean;
+    /** Download: called when user triggers download on one or more items. */
+    onDownloadFiles: (dialFiles: DialFile[]) => void;
+    /** True while a download is in progress. */
+    isDownloading: boolean;
+    /** Delete: called when user confirms deletion of one or more items. */
+    onDeleteFiles: (items: DialDeletedItem[], sourceFolder: string) => void;
+    /** True while a delete request is in flight. */
+    isDeleting: boolean;
+    /** Rename: inline validation — returns error string or null. */
+    onRenameValidate: (value: string, item: DialFile) => string | null;
+    /** Rename: called when user confirms an inline rename. Also dispatches cross-folder move (see D3). */
+    onMoveToFiles: (items: DialCopiedItem[], sourceFolder: string, destinationFolder: string) => void;
+    /** True while a rename request is in flight. */
+    isRenaming: boolean;
+    /** Copy: called when user confirms a copy-paste. */
+    onCopyFiles: (items: DialCopiedItem[], destinationFolder: string) => void;
+    /** True while a copy request is in flight. */
+    isCopying: boolean;
+    /** True while the cross-folder-move branch of onMoveToFiles is in flight. */
+    isMoving: boolean;
+    /** Aborts whichever of copy/move is currently in flight. */
+    cancelCopyMove: () => void;
+    /** True when the current folder grants WRITE (upload + new folder). */
+    uploadEnabled: boolean;
+    /** True when Upload/New must be disabled. */
+    isNewButtonDisabled: boolean;
+    /** Tooltip for disabled New/Upload when `isNewButtonDisabled` is true. */
+    disabledNewButtonTooltip: string;
+    /** Columns to show in the grid — tab-dependent. */
+    visibleColumns: FileManagerColumnKey[];
+    /** BCP-47 locale string for date formatting, sourced from i18n.language. */
+    dateLocale: string;
+    /** Fixed date format options for the UpdatedAt column. */
+    dateOptions: Intl.DateTimeFormatOptions;
+    /** Action labels for grid/tree/bulk — Delete present only on my_files tab. */
+    actionLabels: Partial<Record<DialFileManagerActions, string>>;
+    /** Root-level shared item paths, populated only on the Shared tab. */
+    sharedWithMeIds: string[] | undefined;
+    /** Share: paths the user has shared with others, populated only on my_files tab. */
+    sharedByMePaths: Set<string>;
+    /** Unshare: called when user removes a shared-with-me item (Shared tab only). */
+    onUnshareFiles: (files: DialFile[]) => void;
+    /** True while an unshare request is in flight. */
+    isUnsharing: boolean;
+    /** Remove access: called when user revokes access to an owned shared item (my_files tab only). */
+    onRemoveFilesAccess: (files: DialFile[]) => void;
+    /** True while a remove-access request is in flight. */
+    isRemovingAccess: boolean;
+    /** Metadata: populated once onGetInfo resolves; passed to fileMetadataPopupOptions.fileMetadata. */
+    fileMetadata: DialFile | undefined;
+    /** True while a metadata request is in flight. */
+    isFileMetadataLoading: boolean;
+    /** Metadata: called by DialFileManager.onGetInfo to fetch and display a file's details. */
+    onGetInfo: (file: DialFile) => void;
+    /** Metadata: resets fileMetadata/isFileMetadataLoading; passed to fileMetadataPopupOptions.clearMetadata. */
+    clearMetadata: () => void;
+    /**
+     * True while any mutating file-manager operation is in flight: the OR of
+     * `isCreatingFolder`, `isDownloading`, `isDeleting`, `isRenaming`, `isCopying`,
+     * `isMoving`, `isUnsharing`, `isRemovingAccess`, and any upload still queued or running.
+     *
+     * Deliberately excludes three flags, each already fully contained by its own
+     * scoped loading UI:
+     * - `isLoading` — a read (listing fetch), not a mutation.
+     * - `isSearching` — scoped to ui-kit's own search-progress UI.
+     * - `isFileMetadataLoading` — has its own `loading` state in `fileMetadataPopupOptions`.
+     */
+    isAnyOperationInProgress: boolean;
+}
+//# sourceMappingURL=dial-file-manager.types.d.ts.map