@epam/ai-dial-chat-hooks 1.3.0-dev.5 → 1.3.0-dev.55

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

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":"AAAA,OAAO,KAAK,EACV,4BAA4B,EAC5B,sBAAsB,EACtB,0BAA0B,EAC1B,oBAAoB,EACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,QAAQ,EACR,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAE1E;;;;GAIG;AACH,oBAAY,6BAA6B;IACvC,kGAAkG;IAClG,gBAAgB,qBAAqB;IACrC,gEAAgE;IAChE,kBAAkB,uBAAuB;IACzC,qDAAqD;IACrD,kBAAkB,uBAAuB;IACzC,mEAAmE;IACnE,kBAAkB,uBAAuB;IACzC,2DAA2D;IAC3D,mBAAmB,wBAAwB;IAC3C,2GAA2G;IAC3G,YAAY,iBAAiB;IAC7B,sHAAsH;IACtH,0BAA0B,+BAA+B;IACzD,+DAA+D;IAC/D,YAAY,iBAAiB;IAC7B,0EAA0E;IAC1E,YAAY,iBAAiB;IAC7B,0FAA0F;IAC1F,qBAAqB,0BAA0B;IAC/C,wEAAwE;IACxE,UAAU,eAAe;IACzB,wFAAwF;IACxF,mBAAmB,wBAAwB;IAC3C,wDAAwD;IACxD,UAAU,eAAe;IACzB,wEAAwE;IACxE,mBAAmB,wBAAwB;IAC3C,8DAA8D;IAC9D,aAAa,kBAAkB;IAC/B,mEAAmE;IACnE,kBAAkB,uBAAuB;IACzC,+EAA+E;IAC/E,YAAY,iBAAiB;IAC7B,sJAAsJ;IACtJ,eAAe,oBAAoB;IACnC,oGAAoG;IACpG,mBAAmB,wBAAwB;IAC3C,gIAAgI;IAChI,4BAA4B,iCAAiC;IAC7D,mEAAmE;IACnE,0BAA0B,+BAA+B;IACzD,qHAAqH;IACrH,+BAA+B,oCAAoC;CACpE;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,6BAA6B,CAAC;IACvC,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yGAAyG;IACzG,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,oBAAY,6BAA6B;IACvC,KAAK,UAAU;IACf,gBAAgB,qBAAqB;IACrC,YAAY,iBAAiB;IAC7B,OAAO,YAAY;IACnB,aAAa,kBAAkB;CAChC;AAED;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAC/B;IAAE,MAAM,EAAE,6BAA6B,CAAC,KAAK,CAAA;CAAE,GAC/C;IACE,MAAM,EAAE,6BAA6B,CAAC,gBAAgB,CAAC;IACvD,OAAO,EAAE,MAAM,CAAC;CACjB,GACD;IAAE,MAAM,EAAE,6BAA6B,CAAC,YAAY,CAAA;CAAE,GACtD;IAAE,MAAM,EAAE,6BAA6B,CAAC,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACpE;IACE,MAAM,EAAE,6BAA6B,CAAC,aAAa,CAAC;IACpD,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEN;;;;;GAKG;AACH,oBAAY,iBAAiB;IAC3B,aAAa,kBAAkB;IAC/B,WAAW,gBAAgB;IAC3B,cAAc,mBAAmB;IACjC,eAAe,oBAAoB;IACnC,UAAU,eAAe;IACzB,WAAW,gBAAgB;IAC3B,SAAS,cAAc;IACvB,UAAU,eAAe;IACzB,2EAA2E;IAC3E,cAAc,mBAAmB;IACjC,eAAe,oBAAoB;IACnC,yEAAyE;IACzE,aAAa,kBAAkB;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,qCAAqC;IACrC,IAAI,EAAE,iBAAiB,CAAC;IACxB,wFAAwF;IACxF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,wEAAwE;IACxE,QAAQ,EAAE,YAAY,CAAC;IACvB,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mFAAmF;IACnF,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,gHAAgH;IAChH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mHAAmH;IACnH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,cAAc,CAAC,EAAE,CAAC,YAAY,EAAE,uBAAuB,KAAK,IAAI,CAAC;IACjE,yGAAyG;IACzG,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,IAAI,CAAC;IAChE,6FAA6F;IAC7F,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,sEAAsE;IACtE,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,qFAAqF;IACrF,aAAa,CAAC,EAAE,4BAA4B,CAAC;IAC7C;;;;;OAKG;IACH,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,sBAAsB,EAAE,MAAM,CAAC,CAAC,CAAC;IACxD,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,wBAAwB,EAAE,MAAM,CAAC;IACjC,gFAAgF;IAChF,mBAAmB,EAAE,2BAA2B,CAAC;IACjD;;;;;OAKG;IACH,2BAA2B,EAAE,CAC3B,KAAK,EAAE,uBAAuB,EAC9B,IAAI,CAAC,EAAE,QAAQ,KACZ,MAAM,CAAC;CACb;AAED,MAAM,WAAW,wBAAwB;IACvC,6DAA6D;IAC7D,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,gDAAgD;IAChD,SAAS,EAAE,OAAO,CAAC;IACnB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,2FAA2F;IAC3F,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,YAAY,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,sDAAsD;IACtD,KAAK,EAAE,MAAM,IAAI,CAAC;IAElB;;;;;OAKG;IACH,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvD,wDAAwD;IACxD,WAAW,EAAE,OAAO,CAAC;IACrB,2GAA2G;IAC3G,aAAa,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IACjC,oDAAoD;IACpD,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAE/B,6DAA6D;IAC7D,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,2FAA2F;IAC3F,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,2EAA2E;IAC3E,qBAAqB,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IACpD,kGAAkG;IAClG,uBAAuB,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,oFAAoF;IACpF,uBAAuB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAErC,iCAAiC;IACjC,aAAa,EAAE,CACb,KAAK,EAAE,kBAAkB,EAAE,EAC3B,iBAAiB,EAAE,MAAM,KACtB,IAAI,CAAC;IACV,sFAAsF;IACtF,eAAe,EAAE,CACf,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,MAAM,EACZ,iBAAiB,EAAE,MAAM,KACtB,IAAI,CAAC;IACV,6EAA6E;IAC7E,gBAAgB,EAAE,CAChB,KAAK,EAAE,kBAAkB,EAAE,EAC3B,aAAa,EAAE,QAAQ,EAAE,EACzB,iBAAiB,EAAE,MAAM,KACtB,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACzC,oDAAoD;IACpD,gBAAgB,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC9C,sDAAsD;IACtD,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,oEAAoE;IACpE,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,sCAAsC;IACtC,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAE7B,oEAAoE;IACpE,cAAc,EAAE,CACd,IAAI,EAAE,kBAAkB,EACxB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,KACX,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,sFAAsF;IACtF,sBAAsB,EAAE,CACtB,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,QAAQ,KACnB,MAAM,GAAG,IAAI,CAAC;IACnB,yDAAyD;IACzD,gBAAgB,EAAE,OAAO,CAAC;IAE1B,yEAAyE;IACzE,eAAe,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC;IACjD,4CAA4C;IAC5C,aAAa,EAAE,OAAO,CAAC;IAEvB,uEAAuE;IACvE,aAAa,EAAE,CAAC,KAAK,EAAE,eAAe,EAAE,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IACxE,gDAAgD;IAChD,UAAU,EAAE,OAAO,CAAC;IAEpB,gEAAgE;IAChE,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,KAAK,MAAM,GAAG,IAAI,CAAC;IACnE,sGAAsG;IACtG,aAAa,EAAE,CACb,KAAK,EAAE,cAAc,EAAE,EACvB,YAAY,EAAE,MAAM,EACpB,iBAAiB,EAAE,MAAM,KACtB,IAAI,CAAC;IACV,gDAAgD;IAChD,UAAU,EAAE,OAAO,CAAC;IAEpB,oDAAoD;IACpD,WAAW,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,iBAAiB,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1E,8CAA8C;IAC9C,SAAS,EAAE,OAAO,CAAC;IACnB,6EAA6E;IAC7E,QAAQ,EAAE,OAAO,CAAC;IAClB,4DAA4D;IAC5D,cAAc,EAAE,MAAM,IAAI,CAAC;IAE3B,uEAAuE;IACvE,aAAa,EAAE,OAAO,CAAC;IACvB,6CAA6C;IAC7C,mBAAmB,EAAE,OAAO,CAAC;IAC7B,0EAA0E;IAC1E,wBAAwB,EAAE,MAAM,CAAC;IAEjC,mDAAmD;IACnD,cAAc,EAAE,oBAAoB,EAAE,CAAC;IACvC,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,WAAW,EAAE,IAAI,CAAC,qBAAqB,CAAC;IACxC,8EAA8E;IAC9E,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,sBAAsB,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9D,sEAAsE;IACtE,eAAe,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAEtC,oFAAoF;IACpF,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAE7B,iFAAiF;IACjF,cAAc,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC;IAC5C,kDAAkD;IAClD,WAAW,EAAE,OAAO,CAAC;IACrB,kGAAkG;IAClG,mBAAmB,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC;IACjD,uDAAuD;IACvD,gBAAgB,EAAE,OAAO,CAAC;IAE1B,oGAAoG;IACpG,YAAY,EAAE,QAAQ,GAAG,SAAS,CAAC;IACnC,kDAAkD;IAClD,qBAAqB,EAAE,OAAO,CAAC;IAC/B,2FAA2F;IAC3F,SAAS,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IACpC,6GAA6G;IAC7G,aAAa,EAAE,MAAM,IAAI,CAAC;IAE1B;;;;;;;;;;OAUG;IACH,wBAAwB,EAAE,OAAO,CAAC;CACnC"}

package/files/dial-file-manager.types.js

@@ -4,7 +4,7 @@ var e = /* @__PURE__ */ function(e) {
 }({}), t = /* @__PURE__ */ function(e) {
 	return e.Empty = "empty", e.ForbiddenSymbols = "forbiddenSymbols", e.ReservedName = "reservedName", e.TooLong = "tooLong", e.DuplicateName = "duplicateName", e;
 }({}), n = /* @__PURE__ */ function(e) {
-	return e.FolderCreated = "folderCreated", e.FileRenamed = "fileRenamed", e.FileDownloaded = "fileDownloaded", e.FilesDownloaded = "filesDownloaded", e.FileCopied = "fileCopied", e.FilesCopied = "filesCopied", e.FileMoved = "fileMoved", e.FilesMoved = "filesMoved", e.FileDuplicated = "fileDuplicated", e.FilesDuplicated = "filesDuplicated", e;
+	return e.FolderCreated = "folderCreated", e.FileRenamed = "fileRenamed", e.FileDownloaded = "fileDownloaded", e.FilesDownloaded = "filesDownloaded", e.FileCopied = "fileCopied", e.FilesCopied = "filesCopied", e.FileMoved = "fileMoved", e.FilesMoved = "filesMoved", e.FileDuplicated = "fileDuplicated", e.FilesDuplicated = "filesDuplicated", e.FilesUnshared = "filesUnshared", e;
 }({});
 //#endregion
 export { e as FileManagerNotificationReason, t as FileNameValidationErrorReason, n as FileOperationKind };

package/files/dial-file-to-attachment.d.ts

@@ -0,0 +1,26 @@
+import { Attachment } from '@epam/ai-dial-chat-shared';
+import { DialFile } from '@epam/ai-dial-ui-kit';
+/** Options for {@link dialFileToAttachment} and {@link dialFilesToAttachments}. */
+export interface DialFileToAttachmentOptions {
+    /**
+     * Resolves an image attachment's `previewUrl` from its DIAL resource URL.
+     * Left unset, image attachments get no `previewUrl`. The host owns bucket/
+     * icon-path REST construction — this hook never builds those URLs itself.
+     */
+    resolvePreviewUrl?: (url: string) => string | undefined;
+}
+/**
+ * Converts a selected ui-kit file into the generic attachment contract.
+ * DIAL storage identifiers are resolved at the app edge so the input library
+ * remains unaware of buckets, server routes, and external file systems.
+ */
+export declare const dialFileToAttachment: (file: DialFile, bucket: string, options?: DialFileToAttachmentOptions) => Attachment | null;
+/** Maps a batch of selected DIAL files to attachments, dropping folders and unresolvable entries. */
+export declare const dialFilesToAttachments: (files: DialFile[], bucket: string, options?: DialFileToAttachmentOptions) => Attachment[];
+/**
+ * Converts a DIAL Core folder path (e.g. `files/{bucket}/{path}/`) into an
+ * attachment. DIAL Core resolves folder contents server-side when the path is
+ * sent as an attachment URL.
+ */
+export declare const dialFolderPathToAttachment: (folderPath: string) => Attachment;
+//# sourceMappingURL=dial-file-to-attachment.d.ts.map

package/files/dial-file-to-attachment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dial-file-to-attachment.d.ts","sourceRoot":"","sources":["../../src/files/dial-file-to-attachment.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAoB,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAkBvE,mFAAmF;AACnF,MAAM,WAAW,2BAA2B;IAC1C;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CACzD;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,MAAM,QAAQ,EACd,QAAQ,MAAM,EACd,UAAU,2BAA2B,KACpC,UAAU,GAAG,IAoBf,CAAC;AAEF,qGAAqG;AACrG,eAAO,MAAM,sBAAsB,GACjC,OAAO,QAAQ,EAAE,EACjB,QAAQ,MAAM,EACd,UAAU,2BAA2B,KACpC,UAAU,EAG4D,CAAC;AAE1E;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,GAAI,YAAY,MAAM,KAAG,UAa/D,CAAC"}

package/files/dial-file.d.ts

@@ -0,0 +1,17 @@
+/** True when `url` looks like a DIAL Core file id (`files/{bucket}/{path}`). */
+export declare const isDialFileId: (url: string) => boolean;
+/**
+ * Converts a DIAL file ID or full resource path to the relative bucket path
+ * expected by the files download API.
+ */
+export declare const resolveRelativeDialFilePath: (pathOrFileId: string, bucket: string) => string;
+/**
+ * Extracts the bucket and decoded relative path from a DIAL file ID
+ * (`files/{bucket}/{path}`). Returns `undefined` if the input does not start
+ * with `files/` or has no path segment after the bucket.
+ */
+export declare const resolveDialFileBucketAndPath: (fileId: string) => {
+    bucket: string;
+    path: string;
+} | undefined;
+//# sourceMappingURL=dial-file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dial-file.d.ts","sourceRoot":"","sources":["../../src/files/dial-file.ts"],"names":[],"mappings":"AAEA,gFAAgF;AAChF,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,KAAG,OAAmC,CAAC;AAE/E;;;GAGG;AACH,eAAO,MAAM,2BAA2B,GACtC,cAAc,MAAM,EACpB,QAAQ,MAAM,KACb,MAmBF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,GACvC,QAAQ,MAAM,KACb;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAcrC,CAAC"}

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,3 @@
+import { DialFileManagerActionProfile, DialFileManagerVariant } from '@epam/ai-dial-chat-shared';
+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,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,EACvB,MAAM,2BAA2B,CAAC;AAEnC,eAAO,MAAM,mBAAmB,GAC9B,SAAS,sBAAsB,KAC9B,4BASF,CAAC"}

package/files/file-name.d.ts

@@ -0,0 +1,19 @@
+/** Splits a file name into its base and extension, using only the last dot. */
+export declare const splitFileNameExtension: (fileName: string) => {
+    base: string;
+    extension: string;
+};
+export declare const trimFileNameToByteLimit: (name: string, limit?: number) => string;
+/**
+ * Sanitizes a filename for upload by replacing forbidden characters with `_`,
+ * trimming trailing dots/whitespace from the base name, and capping the result
+ * to 255 UTF-8 bytes.
+ *
+ * Mutates nothing — returns a new string. The caller (onValidateUpload) is
+ * responsible for writing the result back to DialUploadFileItem.name so the
+ * ui-kit's subsequent conflict detection sees the sanitized name.
+ *
+ * If the base name is empty after sanitization, returns the original name unchanged.
+ */
+export declare const sanitizeFileName: (name: string) => string;
+//# sourceMappingURL=file-name.d.ts.map

package/files/file-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-name.d.ts","sourceRoot":"","sources":["../../src/files/file-name.ts"],"names":[],"mappings":"AAMA,+EAA+E;AAC/E,eAAO,MAAM,sBAAsB,GACjC,UAAU,MAAM,KACf;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAOnC,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,MAAM,MAAM,EAAE,cAAW,KAAG,MAYnE,CAAC;AAiBF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,MAY/C,CAAC"}

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

@@ -0,0 +1,8 @@
+import { DownloadDestination } from './download-destination';
+/**
+ * Resolves where a download should be written: the browser's native "Save
+ * As" picker when available (`window.showSaveFilePicker`), otherwise a
+ * plain blob download. Returns `Cancelled` if the user dismisses the picker.
+ */
+export declare const prepareDownloadDestination: (filename: string, mimeType?: string) => Promise<DownloadDestination>;
+//# sourceMappingURL=prepare-download-destination.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prepare-download-destination.d.ts","sourceRoot":"","sources":["../../src/files/prepare-download-destination.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,wBAAwB,CAAC;AAchC;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,GACrC,UAAU,MAAM,EAChB,iBAAqC,KACpC,OAAO,CAAC,mBAAmB,CAkC7B,CAAC"}

package/files/resolve-dial-file-api-path.d.ts

@@ -0,0 +1,12 @@
+import { DialFile } from '@epam/ai-dial-react-file-manager';
+/**
+ * Converts a DialFileManager virtual path to an API folder path.
+ * e.g. "/My files" → "", "/My files/reports/" → "reports/"
+ */
+export declare const virtualPathToApiPath: (virtualPath: string, rootLabel: string) => string;
+/**
+ * Resolves a DialFile to the bucket-relative API path used by files BFF endpoints.
+ * Prefers DIAL resource ids when present; otherwise converts DialFile.path virtual paths.
+ */
+export declare const resolveDialFileApiPath: (file: DialFile, bucket: string, rootLabel: string) => string;
+//# sourceMappingURL=resolve-dial-file-api-path.d.ts.map

package/files/resolve-dial-file-api-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-dial-file-api-path.d.ts","sourceRoot":"","sources":["../../src/files/resolve-dial-file-api-path.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAoCjE;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAC/B,aAAa,MAAM,EACnB,WAAW,MAAM,KAChB,MAiCF,CAAC;AAOF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GACjC,MAAM,QAAQ,EACd,QAAQ,MAAM,EACd,WAAW,MAAM,KAChB,MAkBF,CAAC"}

package/files/source-content.d.ts

@@ -0,0 +1,28 @@
+/** Pure source classification. Keep MIME values aligned with attachment-canvas
+ * without importing its renderer dependency graph into this entry point. */
+/**
+ * Returns the last path segment of `url` — its file name — for both absolute
+ * URLs and DIAL-relative resource paths such as
+ * `files/<bucket>/qa-routed-source.html`. Any query string or hash is dropped
+ * and percent escapes are decoded. Returns an empty string when no segment can
+ * be extracted. Used to classify a resource by extension when its display name
+ * is a citation title rather than a file name.
+ */
+export declare const getUrlFileName: (url: string) => string;
+/**
+ * Returns the content type to trust for an external citation source: `contentType`
+ * unchanged when it is already an image/audio/PDF/document-renderer marker,
+ * otherwise the type implied by `url`'s path extension (`application/pdf` for
+ * `.pdf`, the canonical MIME for `.docx`/`.xlsx`/`.pptx`/`.csv`) when that
+ * extension is recognized, otherwise `contentType` unchanged.
+ *
+ * Web-search grounding APIs label every reference — PDFs and Office documents
+ * included — as `text/markdown`, so a mislabeled `contentType` must not win
+ * over a recognized URL extension: doing so previously sent a PDF's raw bytes
+ * into the markdown/text canvas viewer, rendering garbled text instead of
+ * opening the PDF/OOXML viewer.
+ */
+export declare const resolveExternalSourceContentType: (contentType: string, url: string) => string;
+/** Returns true when an external (non-DIAL) source URL should be opened in the canvas rather than a new browser tab. */
+export declare const isExternalSourcePreviewable: (contentType: string, url: string) => boolean;
+//# sourceMappingURL=source-content.d.ts.map

package/files/source-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-content.d.ts","sourceRoot":"","sources":["../../src/files/source-content.ts"],"names":[],"mappings":"AAAA;4EAC4E;AA8E5E;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GAAI,KAAK,MAAM,KAAG,MAiB5C,CAAC;AAcF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gCAAgC,GAC3C,aAAa,MAAM,EACnB,KAAK,MAAM,KACV,MASF,CAAC;AAEF,wHAAwH;AACxH,eAAO,MAAM,2BAA2B,GACtC,aAAa,MAAM,EACnB,KAAK,MAAM,KACV,OAQF,CAAC"}