@epam/ai-dial-chat-hooks 1.1.0-dev.267 → 1.1.0-dev.268

package/files/dial-file-manager-copy-move.util.d.ts

@@ -0,0 +1,15 @@
+import { CopyItemDto, MoveItemDto, RenameItemDto } from '@epam/ai-dial-chat-api-client';
+import { DialCopiedItem } from '@epam/ai-dial-react-file-manager';
+import { PreparedCopyMoveItem } from './dial-file-manager.model';
+/** Builds the `copyFiles` DTOs (with their destination display name) for `onCopyFiles`. */
+export declare const prepareCopyItems: (copiedItems: DialCopiedItem[], bucket: string, rootLabel: string) => PreparedCopyMoveItem<CopyItemDto>[];
+/**
+ * Rename-vs-move disambiguation (design.md D3): entries whose parent folder
+ * is unchanged become `renameDtos`; entries whose parent folder changed
+ * become `preparedMoveItems`.
+ */
+export declare const prepareMoveRenameItems: (copiedItems: DialCopiedItem[], bucket: string, rootLabel: string) => {
+    renameDtos: RenameItemDto[];
+    preparedMoveItems: PreparedCopyMoveItem<MoveItemDto>[];
+};
+//# sourceMappingURL=dial-file-manager-copy-move.util.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dial-file-manager-copy-move.util.d.ts","sourceRoot":"","sources":["../../src/files/dial-file-manager-copy-move.util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,aAAa,EACd,MAAM,+BAA+B,CAAC;AAMvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAGvE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAMtE,2FAA2F;AAC3F,eAAO,MAAM,gBAAgB,GAC3B,aAAa,cAAc,EAAE,EAC7B,QAAQ,MAAM,EACd,WAAW,MAAM,KAChB,oBAAoB,CAAC,WAAW,CAAC,EAkChC,CAAC;AAaL;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GACjC,aAAa,cAAc,EAAE,EAC7B,QAAQ,MAAM,EACd,WAAW,MAAM,KAChB;IACD,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,iBAAiB,EAAE,oBAAoB,CAAC,WAAW,CAAC,EAAE,CAAC;CAiExD,CAAC"}

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

@@ -0,0 +1,35 @@
+import { CreateFolderResponseDto, FileMetadataResponseDto, ListFilesItemDto } from '@epam/ai-dial-chat-api-client';
+import { DialFile, DialFileManagerTabs } from '@epam/ai-dial-react-file-manager';
+import { PreparedCopyMoveItem, SharedRootMeta } from './dial-file-manager.model';
+import { DialFilesApi } from './dial-files-api';
+import { FileUploadBatchState, FileUploadEntry, FileUploadStatus } from './upload-batch.types';
+export declare const mapCorePermissions: (permissions?: string[]) => DialFile["permissions"] | undefined;
+export declare const findFirstSuccessfulCopyMoveItem: <TDto extends {
+    success?: boolean;
+    sourcePath?: string;
+    destinationPath?: string;
+}>(items: PreparedCopyMoveItem<TDto>[], results: {
+    success?: boolean;
+    sourcePath?: string;
+    destinationPath?: string;
+}[]) => PreparedCopyMoveItem<TDto> | undefined;
+export declare const buildFromCache: (cache: Map<string, ListFilesItemDto[]>, listingPermissionsCache: Map<string, string[] | undefined>, apiPath: string, virtualBasePath: string, folderId: string) => DialFile[];
+export declare const mergeCreatedFolderIntoCache: (cache: Map<string, ListFilesItemDto[]>, parentApiPath: string, created: CreateFolderResponseDto, inheritedPermissions?: string[]) => Map<string, ListFilesItemDto[]>;
+export declare const updateEntry: (prev: FileUploadBatchState | null, index: number, patch: FileUploadStatus | Partial<Pick<FileUploadEntry, "status" | "percent">>) => FileUploadBatchState | null;
+export declare const fetchByTab: (filesApi: DialFilesApi, tab: DialFileManagerTabs, bucket: string, folderPath: string, sharedRootMeta: Map<string, SharedRootMeta>) => Promise<{
+    items: ListFilesItemDto[];
+    permissions?: string[];
+}>;
+export declare const fetchForSearch: (filesApi: DialFilesApi, tab: DialFileManagerTabs, bucket: string, folderPath: string, sharedRootMeta: Map<string, SharedRootMeta>) => Promise<{
+    items: ListFilesItemDto[];
+}>;
+export declare const mapSearchItem: (item: ListFilesItemDto, fallbackBucket: string, rootLabel: string) => DialFile;
+/**
+ * Overlays a `FileMetadataResponseDto` response onto the clicked grid row so
+ * `fileMetadataPopupOptions.fileMetadata` receives a value structurally
+ * consistent with any other `DialFile` — the row already carries the correct
+ * virtual `path`/`id`/`name`/`nodeType`/`folderId`, while size/date/author/
+ * permissions are refreshed from the just-fetched server response.
+ */
+export declare const mapFileMetadataToDialFile: (metadata: FileMetadataResponseDto, original: DialFile) => DialFile;
+//# sourceMappingURL=dial-file-manager-mapping.util.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dial-file-manager-mapping.util.d.ts","sourceRoot":"","sources":["../../src/files/dial-file-manager-mapping.util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EACvB,gBAAgB,EACjB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EACL,mBAAmB,EAEpB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,KAAK,EACV,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAE9B,eAAO,MAAM,kBAAkB,GAC7B,cAAc,MAAM,EAAE,KACrB,QAAQ,CAAC,aAAa,CAAC,GAAG,SAS5B,CAAC;AAEF,eAAO,MAAM,+BAA+B,GAC1C,IAAI,SAAS;IACX,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,EAED,OAAO,oBAAoB,CAAC,IAAI,CAAC,EAAE,EACnC,SAAS;IACP,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,EAAE,KACF,oBAAoB,CAAC,IAAI,CAAC,GAAG,SAgB/B,CAAC;AAEF,eAAO,MAAM,cAAc,GACzB,OAAO,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,EACtC,yBAAyB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,EAC1D,SAAS,MAAM,EACf,iBAAiB,MAAM,EACvB,UAAU,MAAM,KACf,QAAQ,EA+CV,CAAC;AAEF,eAAO,MAAM,2BAA2B,GACtC,OAAO,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,EACtC,eAAe,MAAM,EACrB,SAAS,uBAAuB,EAChC,uBAAuB,MAAM,EAAE,KAC9B,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAwBhC,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,MAAM,oBAAoB,GAAG,IAAI,EACjC,OAAO,MAAM,EACb,OACI,gBAAgB,GAChB,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC,KACvD,oBAAoB,GAAG,IAOzB,CAAC;AAEF,eAAO,MAAM,UAAU,GACrB,UAAU,YAAY,EACtB,KAAK,mBAAmB,EACxB,QAAQ,MAAM,EACd,YAAY,MAAM,EAClB,gBAAgB,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,KAC1C,OAAO,CAAC;IAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CA4C/D,CAAC;AAEF,eAAO,MAAM,cAAc,GACzB,UAAU,YAAY,EACtB,KAAK,mBAAmB,EACxB,QAAQ,MAAM,EACd,YAAY,MAAM,EAClB,gBAAgB,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,KAC1C,OAAO,CAAC;IAAE,KAAK,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAuCvC,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,MAAM,gBAAgB,EACtB,gBAAgB,MAAM,EACtB,WAAW,MAAM,KAChB,QAiCF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GACpC,UAAU,uBAAuB,EACjC,UAAU,QAAQ,KACjB,QAgBD,CAAC"}

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

@@ -0,0 +1,39 @@
+import { DialFile } from '@epam/ai-dial-react-file-manager';
+import { SharedRootMeta } from './dial-file-manager.model';
+import { DialFileManagerActionProfile } from './file-manager-variant';
+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. Decodes each path segment independently, matching
+ * how buildFromCache derives virtual paths.
+ */
+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;
+};
+//# 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,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAKjE,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAGtE,eAAO,MAAM,uBAAuB,GAClC,MAAM,MAAM,EACZ,yBAAyB,MAAM,KAC9B,OAQF,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,OAAO,MAAM,KAAG,MAGpD,CAAC;AAEF,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;;;;;;;GAOG;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"}

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

@@ -0,0 +1,26 @@
+import { 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_WITHOUT_AUTHOR: FileManagerColumnKey[];
+export declare const COLUMNS_WITH_AUTHOR: 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;
+}
+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,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;AAE7C,eAAO,MAAM,YAAY,EAAE,IAAI,CAAC,qBAI/B,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,oBAAoB,EAKxD,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,oBAAoB,EAMrD,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,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,320 @@
+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';
+import { DialFileManagerActionProfile, DialFileManagerVariant } from './file-manager-variant';
+import { FileUploadBatchState } from './upload-batch.types';
+export interface FileUploadValidationResult {
+    valid: boolean;
+    message?: string;
+}
+/**
+ * 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). */
+    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"
+}
+/**
+ * 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",
+    LeadingDot = "leadingDot"
+}
+/**
+ * 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;
+} | {
+    reason: FileNameValidationErrorReason.LeadingDot;
+};
+/**
+ * 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"
+}
+/**
+ * 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 name, for copy/move operations. */
+    destinationFolderName?: string;
+    /**
+     * Whether the affected item is a folder rather than a file. Only set for
+     * `fileRenamed`, since it is the only kind whose current wording depends
+     * on the item's node type (a rename toast reads "Folder renamed" vs.
+     * "File renamed").
+     */
+    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;
+    /** 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 list of matching files, 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: virtual paths whose children are already in the cache (derived). */
+    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: dismiss the progress modal after the batch has settled. */
+    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 `uploadBatchState != null`.
+     *
+     * 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

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

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

package/files/dial-files-api.d.ts

@@ -0,0 +1,71 @@
+import { ArchiveItemDto, CopyFilesResponseDto, CopyItemDto, CreateFolderDto, CreateFolderResponseDto, DeleteFilesResponseDto, DeleteItemDto, DiscardSharedItemDto, DiscardSharedResponseDto, FileMetadataResponseDto, FileUploadResponseDto, ListFilesResponseDto, ListPublicFilesRequest, ListSharedFilesRequest, MoveFilesResponseDto, MoveItemDto, RenameFilesResponseDto, RenameItemDto, RevokeAccessItemDto, RevokeAccessResponseDto, UploadArchiveResponseDto } from '@epam/ai-dial-chat-api-client';
+/** Upload mode passed through to `DialFilesApi.uploadFile` — mirrors the BFF's `uploadMode` form field. */
+export declare enum DialFilesApiUploadMode {
+    Overwrite = "overwrite",
+    CreateOnly = "create-only"
+}
+/** Options accepted by `DialFilesApi.uploadFile` beyond an already-created `AbortSignal`. */
+export interface DialFilesApiUploadOptions {
+    /** Aborts the in-flight upload when triggered. */
+    signal?: AbortSignal;
+    /** Called with the 0–100 upload progress percentage when the transport reports byte progress. */
+    onProgress?: (percent: number) => void;
+    /** Controls create-only vs. overwrite semantics for the destination path. */
+    uploadMode?: DialFilesApiUploadMode;
+}
+/**
+ * Operation port every file-manager hook that performs network I/O accepts as
+ * a parameter, replacing direct `server-api/files.api` access. Mirrors
+ * `apps/chat/src/server-api/files.api.ts`'s exact function signatures — not
+ * the generated client's own method shapes — since that file wraps
+ * `uploadFile`/`uploadArchive` with custom XHR-based progress/cancellation
+ * that has no equivalent in the generated client.
+ */
+export interface DialFilesApi {
+    /** Lists files/folders directly under `params.path` within `params.bucket`. */
+    listFiles(params: {
+        bucket: string;
+        path?: string;
+        token?: string;
+        limit?: number;
+        recursive?: boolean;
+        permissions?: boolean;
+    }, signal?: AbortSignal): Promise<ListFilesResponseDto>;
+    /** Lists files/folders under the organization's public root. */
+    listPublicFiles(params: ListPublicFilesRequest): Promise<ListFilesResponseDto>;
+    /** Lists files/folders shared with the current user. */
+    listSharedFiles(params: ListSharedFilesRequest): Promise<ListFilesResponseDto>;
+    /** Lists items the current user has shared with others, from their own bucket. */
+    listSharedByMe(bucket: string): Promise<ListFilesResponseDto>;
+    /** Fetches metadata for a single file or folder. */
+    getFileMetadata(params: {
+        bucket: string;
+        path: string;
+    }): Promise<FileMetadataResponseDto>;
+    /**
+     * Uploads a file, reporting progress via `options.onProgress` when supplied
+     * and honoring cancellation via `options.signal` or a bare `AbortSignal`.
+     */
+    uploadFile(bucket: string, path: string, file: File, options?: AbortSignal | DialFilesApiUploadOptions): Promise<FileUploadResponseDto>;
+    /** Uploads a ZIP archive and extracts its entries under `destinationPath`. */
+    uploadArchive(file: File, bucket: string, destinationPath: string): Promise<UploadArchiveResponseDto>;
+    /** Creates a new folder. */
+    createFolder(params: CreateFolderDto): Promise<CreateFolderResponseDto>;
+    /** Deletes one or more files/folders. */
+    deleteFiles(items: DeleteItemDto[]): Promise<DeleteFilesResponseDto>;
+    /** Renames one or more files/folders in place (same parent folder). */
+    renameFiles(items: RenameItemDto[]): Promise<RenameFilesResponseDto>;
+    /** Copies one or more files/folders to a destination path. */
+    copyFiles(items: CopyItemDto[], signal?: AbortSignal): Promise<CopyFilesResponseDto>;
+    /** Moves one or more files/folders to a destination path (different parent folder). */
+    moveFiles(items: MoveItemDto[], signal?: AbortSignal): Promise<MoveFilesResponseDto>;
+    /** Downloads a single file, returning the raw fetch `Response`. */
+    downloadFile(bucket: string, path: string, signal?: AbortSignal): Promise<Response>;
+    /** Downloads a ZIP archive of the given items, returning the raw fetch `Response`. */
+    downloadArchive(items: ArchiveItemDto[]): Promise<Response>;
+    /** Revokes access previously granted on the given owned items. */
+    revokeAccess(items: RevokeAccessItemDto[]): Promise<RevokeAccessResponseDto>;
+    /** Discards items shared with the current user. */
+    discardShared(items: DiscardSharedItemDto[]): Promise<DiscardSharedResponseDto>;
+}
+//# sourceMappingURL=dial-files-api.d.ts.map

package/files/dial-files-api.d.ts.map

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

package/files/download-destination.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Where a downloaded file's bytes should be written. Mirrors the host's own
+ * "Save As" vs. blob-download vs. cancelled-picker outcomes without the lib
+ * depending on the host's browser-API implementation.
+ */
+export declare enum DownloadDestinationType {
+    Blob = "blob",
+    Stream = "stream",
+    Cancelled = "cancelled"
+}
+/** Discriminated destination a host resolves for a download, passed back into `triggerDownload`. */
+export type DownloadDestination = {
+    type: DownloadDestinationType.Blob;
+} | {
+    type: DownloadDestinationType.Stream;
+    writable: WritableStream<Uint8Array>;
+} | {
+    type: DownloadDestinationType.Cancelled;
+};
+/**
+ * Host-injected seam for `useDialFileMutations.onDownloadFiles`, replacing a
+ * direct import of the app's browser "Save As" / auto-download utilities —
+ * that behavior is desktop/web-shell-specific, not file-manager domain logic.
+ */
+export interface DownloadDestinationHandlers {
+    /** Resolves where a download with the given file name/MIME type should be written. */
+    resolveDestination(filename: string, mimeType: string): Promise<DownloadDestination>;
+    /** Writes `response` to `destination` and returns the name it was saved under. */
+    triggerDownload(response: Response, fallbackName: string, destination: DownloadDestination): Promise<string>;
+}
+//# sourceMappingURL=download-destination.d.ts.map

package/files/download-destination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-destination.d.ts","sourceRoot":"","sources":["../../src/files/download-destination.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,oBAAY,uBAAuB;IACjC,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,SAAS,cAAc;CACxB;AAED,oGAAoG;AACpG,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,uBAAuB,CAAC,IAAI,CAAA;CAAE,GACtC;IACE,IAAI,EAAE,uBAAuB,CAAC,MAAM,CAAC;IACrC,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;CACtC,GACD;IAAE,IAAI,EAAE,uBAAuB,CAAC,SAAS,CAAA;CAAE,CAAC;AAEhD;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC1C,sFAAsF;IACtF,kBAAkB,CAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAChC,kFAAkF;IAClF,eAAe,CACb,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,mBAAmB,GAC/B,OAAO,CAAC,MAAM,CAAC,CAAC;CACpB"}

package/files/file-manager-variant.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Identifies which host is driving `useDialFileManager` / `DialFileManagerShell`.
+ * `FolderPicker` is a reserved value with no implemented UI yet (#7503+).
+ */
+export declare enum DialFileManagerVariant {
+    Attach = "attach",
+    Standalone = "standalone",
+    FolderPicker = "folder-picker"
+}
+/**
+ * Gates which actions `useDialFileManager` exposes per tab. `Attach` excludes
+ * Copy/Move/Duplicate (it is a file picker, not a management surface); `Browse`
+ * exposes the full #7503 action set. `Full` is reserved for
+ * `DialFileManagerVariant.FolderPicker` (#7503+).
+ */
+export declare enum DialFileManagerActionProfile {
+    Attach = "attach",
+    Browse = "browse",
+    Full = "full"
+}
+export declare const deriveActionProfile: (variant: DialFileManagerVariant) => DialFileManagerActionProfile;
+//# sourceMappingURL=file-manager-variant.d.ts.map

package/files/file-manager-variant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-manager-variant.d.ts","sourceRoot":"","sources":["../../src/files/file-manager-variant.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,sBAAsB;IAChC,MAAM,WAAW;IACjB,UAAU,eAAe;IACzB,YAAY,kBAAkB;CAC/B;AAED;;;;;GAKG;AACH,oBAAY,4BAA4B;IACtC,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,IAAI,SAAS;CACd;AAED,eAAO,MAAM,mBAAmB,GAC9B,SAAS,sBAAsB,KAC9B,4BASF,CAAC"}