@epam/ai-dial-chat-shared 1.3.0-dev.28 → 1.3.0-dev.288

package/file-manager/labels.d.ts

@@ -0,0 +1,177 @@
+import { DialFile, DialFileManager, DialFileManagerTabs } from '@epam/ai-dial-react-file-manager';
+import { TransferQueueLabels } from '@epam/ai-dial-ui-kit';
+import { ComponentProps, ReactNode } from 'react';
+import { FileUploadFailureReason } from './upload-batch';
+type DialFileManagerComponentProps = ComponentProps<typeof DialFileManager>;
+/** Options for the conflict-resolution popup shown during copy/move operations. */
+export type ConflictResolutionPopupOptions = NonNullable<DialFileManagerComponentProps['conflictResolutionPopupOptions']>;
+/** Validation messages shown during inline rename editing. */
+export type RenameValidationMessages = NonNullable<DialFileManagerComponentProps['renameValidationMessages']>;
+/** Configuration for the destination-folder picker popup. */
+export type DialFileManagerDestinationFolderPopupOptions = NonNullable<DialFileManagerComponentProps['destinationFolderPopupOptions']>;
+/** Title and description pair for an empty-state display. */
+export interface EmptyStateCopy {
+    /** Primary empty-state heading. */
+    title: string;
+    /** Secondary empty-state description text. */
+    description: string;
+}
+/**
+ * Pre-translated strings and resolved renderers the shell renders as-is.
+ * The shell never calls `useTranslation` — every host (the attach modal
+ * today; a future standalone page) resolves these via its own i18n.
+ */
+export interface DialFileManagerShellLabels {
+    /** Error message shown when the current folder listing fails. */
+    errorMessage: string;
+    /** Label for the retry button shown alongside the error message. */
+    retryLabel: string;
+    /** Label for the hidden-files toggle in the toolbar. */
+    hiddenFilesLabel: string;
+    /** Label shown when hidden files are currently visible. */
+    showHiddenFilesLabel: string;
+    /** Label shown when hidden files are currently hidden. */
+    hideHiddenFilesLabel: string;
+    /** Returns the text shown after the selection-count badge; the file manager renders the count itself, so omit it (e.g. "items selected"). */
+    getSelectionLabel: (count: number) => string;
+    /** Label for the "Upload files" action in the New menu. */
+    uploadFilesLabel: string;
+    /** Label for the "Upload archive" action in the New menu. */
+    uploadArchiveAction: string;
+    /** Label for the "New folder" action in the New menu. */
+    newFolderLabel: string;
+    /** Label for the Download action. */
+    downloadLabel: string;
+    /**
+     * Overlay label shown while a download was in progress.
+     * @deprecated Not read: downloads run as transfer-queue rows with no overlay.
+     */
+    downloadingLabel?: string;
+    /** Label for the Delete action. */
+    deleteLabel: string;
+    /** Overlay label shown while a delete operation is in progress. */
+    deletingLabel: string;
+    /** Label for the Rename action. */
+    renameLabel: string;
+    /** Overlay label shown while a rename operation is in progress. */
+    renamingLabel: string;
+    /** Label for the Copy action. */
+    copyLabel: string;
+    /** Label for the Move action. */
+    moveLabel: string;
+    /** Label for the Duplicate action. */
+    duplicateLabel: string;
+    /** Label for the "Add folder" button in the destination picker. */
+    addFolderLabel: string;
+    /** Label for the hidden-files toggle in the destination-folder picker. */
+    hiddenFilesSwitcherLabel: string;
+    /** Returns the header for the copy destination popup. */
+    getCopyHeader: (count: number, name?: string) => string;
+    /** Returns the header for the move destination popup. */
+    getMoveHeader: (count: number, name?: string) => string;
+    /** Tooltip shown on the disabled source folder in the destination picker. */
+    moveSourceDisabledTooltip: string;
+    /** Tooltip shown when the move destination is a moved folder or lies inside one. */
+    movedIntoItselfTooltip: string;
+    /** Tooltip shown when a destination folder is still loading. */
+    folderPickerLoadingTooltip: string;
+    /** Empty-state title in the destination-folder picker. */
+    folderPickerEmptyStateTitle: string;
+    /** Empty-state description in the destination-folder picker. */
+    folderPickerEmptyStateDescription: string;
+    /** Overlay text shown during a copy operation. */
+    copyingLabel: string;
+    /** Overlay text shown during a move operation. */
+    movingLabel: string;
+    /** Title for the copy operation loader modal. */
+    operationLoaderCopyTitle: string;
+    /** Title for the move operation loader modal. */
+    operationLoaderMoveTitle: string;
+    /** Cancel-button label in the operation loader modal. */
+    operationLoaderCancelLabel: string;
+    /** Returns the delete confirmation dialog title for the given item names and items; the items carry `nodeType`, so a folder and a file can be titled differently. */
+    deleteConfirmTitle: (names: string[], items: DialFile[]) => ReactNode;
+    /** Returns the delete confirmation dialog body for the given item names. */
+    deleteConfirmBody: (names: string[]) => ReactNode;
+    /** Confirm-button label in the delete confirmation dialog. */
+    deleteConfirmLabel: string;
+    /** Cancel-button label in the delete confirmation dialog. */
+    deleteCancelLabel: string;
+    /** Accessible name of the delete confirmation dialog's close control. Unset falls back to the file manager's English default. */
+    deleteCloseLabel?: string;
+    /** Returns the upload queue heading for the number of files in it (e.g. "Uploading 5 files"). */
+    getUploadQueueTitle: (count: number) => string;
+    /** Translated strings for the upload `TransferQueue`; unset ones fall back to the kit's English defaults. */
+    uploadQueueLabels?: Partial<TransferQueueLabels>;
+    /** Tooltip and accessible name of a failed upload or download row, per failure reason; a reason without one shows `uploadQueueLabels.failedMessage`. */
+    uploadFailureMessages?: Partial<Record<FileUploadFailureReason, string>>;
+    /** Returns the transfer queue heading from the number of upload and download rows; unset falls back to `getUploadQueueTitle` with the total. */
+    getTransferQueueTitle?: (counts: {
+        uploads: number;
+        downloads: number;
+    }) => string;
+    /** Download-row wording of the transfer queue (cancel and progress names, and the aggregate bar's name when only downloads run); unset ones use `uploadQueueLabels`. */
+    downloadQueueLabels?: Partial<Pick<TransferQueueLabels, 'cancelItemAriaLabel' | 'itemProgressAriaLabel' | 'queueProgressAriaLabel'>>;
+    /** Accessible name of the queue's aggregate progress bar while uploads and downloads both run; unset uses `uploadQueueLabels.queueProgressAriaLabel`. */
+    transferQueueProgressAriaLabel?: string;
+    /** Empty-state title when a search yields no results. */
+    searchEmptyStateTitle: string;
+    /** Empty-state title for an empty subfolder. */
+    folderEmptyStateTitle: string;
+    /** Tooltip explaining which symbols are forbidden in file names. */
+    forbiddenSymbolsTooltip: string;
+    /** Per-tab empty-state title and description. */
+    emptyStateByTab: Record<DialFileManagerTabs, EmptyStateCopy>;
+    /** Per-tab tree header label. */
+    treeHeaderByTab: Record<DialFileManagerTabs, string>;
+    /** Optional title rendered above the tabs. Omitted by default, so the tabs stand alone; the per-tab label above is then only used as the tabs' aria-label. */
+    treeHeader?: string;
+    /** Search field placeholder per source tab of the browsed folder; a tab without an entry keeps the file manager's default. */
+    searchPlaceholderByTab?: Partial<Record<DialFileManagerTabs, string>>;
+    /** Messages for inline rename validation. */
+    renameValidationMessages: RenameValidationMessages;
+    /** Options for the conflict resolution popup. */
+    conflictResolutionPopupOptions: ConflictResolutionPopupOptions;
+    /** Label for the Unshare action. */
+    unshareLabel: string;
+    /** Overlay label shown while an unshare operation is in progress. */
+    unsharingLabel: string;
+    /** Label for the Remove Access action. */
+    removeAccessLabel: string;
+    /** Overlay label shown while a remove-access operation is in progress. */
+    removingAccessLabel: string;
+    /** Label for the Info action. */
+    infoLabel: string;
+    /** Label for the Preview action. Omit to hide the action. */
+    previewLabel?: string;
+    /** Header for the metadata popup. */
+    metadataHeader: string;
+    /** Label for the file name in the metadata popup. */
+    metadataNameLabel: string;
+    /** Label for the file path in the metadata popup. */
+    metadataPathLabel: string;
+    /** Label for the modified date in the metadata popup. */
+    metadataModifiedDateLabel: string;
+    /** Label for the file size in the metadata popup. */
+    metadataSizeLabel: string;
+    /** Label for the author in the metadata popup. */
+    metadataAuthorLabel: string;
+}
+/**
+ * Labels for `FileManagerAttachModal`. Extends the shell labels with
+ * attach-specific strings.
+ *
+ * Declared here rather than beside the component so a host can type its label
+ * object from this package's root entry without reaching the `./file-manager`
+ * entry, which is the one that pulls in the grid.
+ */
+export interface FileManagerAttachModalLabels extends DialFileManagerShellLabels {
+    /** Title displayed in the Popup header. */
+    title: string;
+    /** Label for the primary Attach button. */
+    attachLabel: string;
+    /** Optional subtitle shown below the title (e.g. allowed types / size). Pass `null` to hide. */
+    headerDescription?: string | null;
+}
+export {};
+//# sourceMappingURL=labels.d.ts.map

package/file-manager/labels.d.ts.map

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

package/file-manager/path.d.ts

@@ -0,0 +1,12 @@
+/** Returns true when any path segment starts with a dot (hidden file or folder). */
+export declare const isHiddenPath: (path: string) => boolean;
+/**
+ * Returns the parent folder of a path (virtual or API), always trailing-slashed.
+ *
+ * @example
+ * getParentFolderPath("reports/file.txt")      // "reports/"
+ * getParentFolderPath("/My files/reports/")     // "/My files/"
+ * getParentFolderPath("report.pdf")             // ""
+ */
+export declare const getParentFolderPath: (path: string) => string;
+//# sourceMappingURL=path.d.ts.map

package/file-manager/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/file-manager/path.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,OACgB,CAAC;AAE7D;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,KAAG,MAIlD,CAAC"}

package/file-manager/shell-styles.d.ts

@@ -0,0 +1,33 @@
+/** CSS custom-property overrides for `OperationLoaderModal`. */
+export interface OperationLoaderModalColors {
+    /** Text color of the progress line under the title. Defaults to `--text-secondary`. */
+    text?: string;
+}
+/** CSS custom-property overrides for `DialFileManagerShell`. */
+export interface DialFileManagerShellColors {
+    /** Background of the shell's surface. Defaults to `--bg-layer-base`. */
+    surface?: string;
+    /** Background of the folder tree in the attach variant. Defaults to `--bg-layer-raised`. */
+    treeBackground?: string;
+    /** Border color between the folder tree and the grid in the attach variant. Defaults to `--stroke-tertiary`. */
+    treeBorder?: string;
+    /** Scrim behind the spinner shown while an overlay operation runs. Defaults to `--bg-backdrop`. */
+    overlayBackdrop?: string;
+}
+/** Style overrides for `DialFileManagerShell`. */
+export interface DialFileManagerShellStyles {
+    /** Color overrides applied as CSS custom properties. */
+    colors?: DialFileManagerShellColors;
+    /** Color overrides forwarded to the copy/move `OperationLoaderModal`. */
+    operationLoader?: OperationLoaderModalColors;
+    /** Typography class of the copy/move `OperationLoaderModal` secondary text. Defaults to `'dial-small-text'`. */
+    operationLoaderTextClassName?: string;
+}
+/** CSS custom-property overrides for `FileManagerAttachModal`. */
+export interface FileManagerAttachModalColors {
+    /** Background of the dialog and of the file-manager surface inside it. Defaults to `--bg-layer-raised`. */
+    background?: string;
+    /** Text color of the title when a header description is shown. Defaults to `--text-primary`. */
+    title?: string;
+}
+//# sourceMappingURL=shell-styles.d.ts.map

package/file-manager/shell-styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-styles.d.ts","sourceRoot":"","sources":["../../src/file-manager/shell-styles.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,MAAM,WAAW,0BAA0B;IACzC,uFAAuF;IACvF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,gEAAgE;AAChE,MAAM,WAAW,0BAA0B;IACzC,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4FAA4F;IAC5F,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gHAAgH;IAChH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mGAAmG;IACnG,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,kDAAkD;AAClD,MAAM,WAAW,0BAA0B;IACzC,wDAAwD;IACxD,MAAM,CAAC,EAAE,0BAA0B,CAAC;IACpC,yEAAyE;IACzE,eAAe,CAAC,EAAE,0BAA0B,CAAC;IAC7C,gHAAgH;IAChH,4BAA4B,CAAC,EAAE,MAAM,CAAC;CACvC;AAED,kEAAkE;AAClE,MAAM,WAAW,4BAA4B;IAC3C,2GAA2G;IAC3G,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gGAAgG;IAChG,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/file-manager/upload-batch.d.ts

@@ -0,0 +1,75 @@
+/** Lifecycle status of a single file within an upload batch. */
+export declare enum FileUploadStatus {
+    Queued = "queued",
+    Uploading = "uploading",
+    Completed = "completed",
+    Failed = "failed",
+    Cancelled = "cancelled"
+}
+/** Why a file in an upload batch failed, derived from the upload response. */
+export declare enum FileUploadFailureReason {
+    /** A file with this name already exists at the destination (HTTP 409). */
+    Conflict = "conflict",
+    /** The file is larger than the server accepts (HTTP 413). */
+    TooLarge = "tooLarge",
+    /** The user may not write to the destination (HTTP 403). */
+    Forbidden = "forbidden",
+    /** The file service behind the API is unavailable (HTTP 502/503). */
+    Unavailable = "unavailable",
+    /** The request never got a response, e.g. the connection dropped. */
+    Network = "network",
+    /** Any other failure. */
+    Unknown = "unknown"
+}
+/** Progress state for a single file within an upload batch. */
+export interface FileUploadEntry {
+    /** Unique identifier of the file in the batch. */
+    id: string;
+    /** Display name of the file. */
+    name: string;
+    /** Current upload lifecycle status. */
+    status: FileUploadStatus;
+    /** 0–100 while uploading when the transport reports byte progress. */
+    percent?: number;
+    /** Why the upload failed; set only when `status` is `Failed`. */
+    failureReason?: FileUploadFailureReason;
+}
+/** State of the upload queue, as returned by `useDialFileUploadBatch`. */
+export interface FileUploadBatchState {
+    /** Every file uploaded since the queue was last cleared, settled ones included. */
+    files: FileUploadEntry[];
+    /** Whether the upload queue should be visible. */
+    isOpen: boolean;
+}
+/** Lifecycle status of a single download in the download batch. */
+export declare enum FileDownloadStatus {
+    Downloading = "downloading",
+    Completed = "completed",
+    Failed = "failed",
+    Cancelled = "cancelled"
+}
+/** Progress state for a single download: one file, or one archive of a selection. */
+export interface FileDownloadEntry {
+    /** Unique identifier of the download in the batch. */
+    id: string;
+    /** Display name: the file name, or the archive name (`<folder>.zip` / `files.zip`). */
+    name: string;
+    /** Current download lifecycle status. */
+    status: FileDownloadStatus;
+    /** 0–100 while downloading when the total size is known or estimated; unset otherwise. */
+    percent?: number;
+    /** Why the download failed; set only when `status` is `Failed`. Shares the upload reasons. */
+    failureReason?: FileUploadFailureReason;
+}
+/** State of the download batch kept by `useDialFileMutations`. */
+export interface FileDownloadBatchState {
+    /** Every download started since the batch was last cleared, settled ones included. */
+    files: FileDownloadEntry[];
+    /** Whether the download rows should be visible in the transfer queue. */
+    isOpen: boolean;
+}
+/** Returns whether any download in the batch is still in progress. */
+export declare const isDownloadInProgress: (batchState: FileDownloadBatchState | null) => boolean;
+/** Returns whether any file in the batch is still queued or uploading. */
+export declare const isUploadInProgress: (batchState: FileUploadBatchState | null) => boolean;
+//# sourceMappingURL=upload-batch.d.ts.map

package/file-manager/upload-batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-batch.d.ts","sourceRoot":"","sources":["../../src/file-manager/upload-batch.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,oBAAY,gBAAgB;IAC1B,MAAM,WAAW;IACjB,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,SAAS,cAAc;CACxB;AAED,8EAA8E;AAC9E,oBAAY,uBAAuB;IACjC,0EAA0E;IAC1E,QAAQ,aAAa;IACrB,6DAA6D;IAC7D,QAAQ,aAAa;IACrB,4DAA4D;IAC5D,SAAS,cAAc;IACvB,qEAAqE;IACrE,WAAW,gBAAgB;IAC3B,qEAAqE;IACrE,OAAO,YAAY;IACnB,yBAAyB;IACzB,OAAO,YAAY;CACpB;AAED,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,MAAM,EAAE,gBAAgB,CAAC;IACzB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,aAAa,CAAC,EAAE,uBAAuB,CAAC;CACzC;AAED,0EAA0E;AAC1E,MAAM,WAAW,oBAAoB;IACnC,mFAAmF;IACnF,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,kDAAkD;IAClD,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,mEAAmE;AACnE,oBAAY,kBAAkB;IAC5B,WAAW,gBAAgB;IAC3B,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,SAAS,cAAc;CACxB;AAED,qFAAqF;AACrF,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAC;IACX,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,0FAA0F;IAC1F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8FAA8F;IAC9F,aAAa,CAAC,EAAE,uBAAuB,CAAC;CACzC;AAED,kEAAkE;AAClE,MAAM,WAAW,sBAAsB;IACrC,sFAAsF;IACtF,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,yEAAyE;IACzE,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,sEAAsE;AACtE,eAAO,MAAM,oBAAoB,GAC/B,YAAY,sBAAsB,GAAG,IAAI,KACxC,OAGS,CAAC;AAEb,0EAA0E;AAC1E,eAAO,MAAM,kBAAkB,GAC7B,YAAY,oBAAoB,GAAG,IAAI,KACtC,OAKS,CAAC"}

package/file-manager/upload-batch.js

@@ -1,6 +1,10 @@
 //#region src/file-manager/upload-batch.ts
 var e = /* @__PURE__ */ function(e) {
 	return e.Queued = "queued", e.Uploading = "uploading", e.Completed = "completed", e.Failed = "failed", e.Cancelled = "cancelled", e;
-}({}), t = (e) => e?.files.some((e) => e.status === "queued" || e.status === "uploading") ?? !1;
+}({}), t = /* @__PURE__ */ function(e) {
+	return e.Conflict = "conflict", e.TooLarge = "tooLarge", e.Forbidden = "forbidden", e.Unavailable = "unavailable", e.Network = "network", e.Unknown = "unknown", e;
+}({}), n = /* @__PURE__ */ function(e) {
+	return e.Downloading = "downloading", e.Completed = "completed", e.Failed = "failed", e.Cancelled = "cancelled", e;
+}({}), r = (e) => e?.files.some((e) => e.status === "downloading") ?? !1, i = (e) => e?.files.some((e) => e.status === "queued" || e.status === "uploading") ?? !1;
 //#endregion
-export { e as FileUploadStatus, t as isUploadInProgress };
+export { n as FileDownloadStatus, t as FileUploadFailureReason, e as FileUploadStatus, r as isDownloadInProgress, i as isUploadInProgress };

package/file-manager/upload-queue.d.ts

@@ -0,0 +1,45 @@
+import { TransferQueueItem, TransferQueueLabels } from '@epam/ai-dial-ui-kit';
+import { FileDownloadBatchState, FileUploadBatchState, FileUploadEntry, FileUploadFailureReason } from './upload-batch';
+/** Maps upload entries onto the UI kit's `TransferQueue` rows; a failed row's `message` is the host text for its reason, when there is one. */
+export declare const toUploadQueueItems: (files: FileUploadEntry[], failureMessages?: Partial<Record<FileUploadFailureReason, string>>) => TransferQueueItem[];
+/** Kind of a transfer-queue row, carried as its id prefix so cancel routes to the right batch. */
+export declare enum TransferQueueRowKind {
+    Upload = "upload",
+    Download = "download"
+}
+/** Builds the id of a transfer-queue row from its kind and its batch entry id. */
+export declare const toTransferQueueRowId: (kind: TransferQueueRowKind, entryId: string) => string;
+/** Splits a transfer-queue row id back into its kind and batch entry id; `undefined` for an id of neither kind. */
+export declare const parseTransferQueueRowId: (rowId: string) => {
+    kind: TransferQueueRowKind;
+    entryId: string;
+} | undefined;
+/**
+ * Maps the upload and download batches onto one UI kit `TransferQueue`:
+ * upload rows first, then download rows, each id prefixed by its kind.
+ */
+export declare const toTransferQueueItems: (uploadBatch: FileUploadBatchState | null, downloadBatch: FileDownloadBatchState | null, failureMessages?: Partial<Record<FileUploadFailureReason, string>>) => TransferQueueItem[];
+/** Row wording for a download row, as `DialFileManagerShellLabels.downloadQueueLabels` carries it. */
+type DownloadRowLabels = Partial<Pick<TransferQueueLabels, 'cancelItemAriaLabel' | 'itemProgressAriaLabel' | 'queueProgressAriaLabel'>>;
+/** Inputs of {@link buildTransferQueueLabels}. */
+interface TransferQueueLabelSources {
+    /** The upload queue's labels, used for every upload row and as the base. */
+    uploadLabels?: Partial<TransferQueueLabels>;
+    /** Download-row wording; without it the queue keeps the upload labels. */
+    downloadLabels?: DownloadRowLabels;
+    /** Name of the aggregate bar while both kinds run. */
+    mixedProgressLabel?: string;
+    /** File names of the upload rows. */
+    uploadNames: ReadonlySet<string>;
+    /** File names of the download rows. */
+    downloadNames: ReadonlySet<string>;
+}
+/**
+ * The queue's labels with each row's cancel and progress names worded for its
+ * own kind (uploading / downloading), since the kit labels a whole queue
+ * rather than a row. A name present in both kinds keeps the upload wording.
+ * The aggregate bar is named for downloads, uploads, or both.
+ */
+export declare const buildTransferQueueLabels: ({ uploadLabels, downloadLabels, mixedProgressLabel, uploadNames, downloadNames, }: TransferQueueLabelSources) => Partial<TransferQueueLabels> | undefined;
+export {};
+//# sourceMappingURL=upload-queue.d.ts.map

package/file-manager/upload-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-queue.d.ts","sourceRoot":"","sources":["../../src/file-manager/upload-queue.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,iBAAiB,EAEtB,KAAK,mBAAmB,EACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,sBAAsB,EAG3B,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAE7B,MAAM,gBAAgB,CAAC;AAexB,+IAA+I;AAC/I,eAAO,MAAM,kBAAkB,GAC7B,OAAO,eAAe,EAAE,EACxB,kBAAkB,OAAO,CAAC,MAAM,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC,KACjE,iBAAiB,EAWf,CAAC;AAYN,kGAAkG;AAClG,oBAAY,oBAAoB;IAC9B,MAAM,WAAW;IACjB,QAAQ,aAAa;CACtB;AAED,kFAAkF;AAClF,eAAO,MAAM,oBAAoB,GAC/B,MAAM,oBAAoB,EAC1B,SAAS,MAAM,KACd,MAA8B,CAAC;AAElC,mHAAmH;AACnH,eAAO,MAAM,uBAAuB,GAClC,OAAO,MAAM,KACZ;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,SAUpD,CAAC;AAgBF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAC/B,aAAa,oBAAoB,GAAG,IAAI,EACxC,eAAe,sBAAsB,GAAG,IAAI,EAC5C,kBAAkB,OAAO,CAAC,MAAM,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC,KACjE,iBAAiB,EAUnB,CAAC;AAEF,sGAAsG;AACtG,KAAK,iBAAiB,GAAG,OAAO,CAC9B,IAAI,CACF,mBAAmB,EACnB,qBAAqB,GAAG,uBAAuB,GAAG,wBAAwB,CAC3E,CACF,CAAC;AAEF,kDAAkD;AAClD,UAAU,yBAAyB;IACjC,4EAA4E;IAC5E,YAAY,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC5C,0EAA0E;IAC1E,cAAc,CAAC,EAAE,iBAAiB,CAAC;IACnC,sDAAsD;IACtD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qCAAqC;IACrC,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC,uCAAuC;IACvC,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACpC;AAED;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GAAI,mFAMtC,yBAAyB,KAAG,OAAO,CAAC,mBAAmB,CAAC,GAAG,SAoC7D,CAAC"}

package/file-manager/upload-queue.js

@@ -1,17 +1,49 @@
-import { FileUploadStatus as e } from "./upload-batch.js";
-import { TransferQueueItemStatus as t } from "@epam/ai-dial-ui-kit";
+import { FileDownloadStatus as e, FileUploadStatus as t } from "./upload-batch.js";
+import { TransferQueueItemStatus as n } from "@epam/ai-dial-ui-kit";
 //#region src/file-manager/upload-queue.ts
-var n = {
-	[e.Queued]: t.InProgress,
-	[e.Uploading]: t.InProgress,
-	[e.Completed]: t.Success,
-	[e.Failed]: t.Failed,
-	[e.Cancelled]: t.Canceled
-}, r = (e) => e.map((e) => ({
+var r = {
+	[t.Queued]: n.InProgress,
+	[t.Uploading]: n.InProgress,
+	[t.Completed]: n.Success,
+	[t.Failed]: n.Failed,
+	[t.Cancelled]: n.Canceled
+}, i = (e, n) => e.map((e) => ({
 	id: e.id,
 	name: e.name,
-	status: n[e.status],
-	percent: e.percent
-}));
+	status: r[e.status],
+	percent: e.percent,
+	message: e.status === t.Failed && e.failureReason != null ? n?.[e.failureReason] : void 0
+})), a = {
+	[e.Downloading]: n.InProgress,
+	[e.Completed]: n.Success,
+	[e.Failed]: n.Failed,
+	[e.Cancelled]: n.Canceled
+}, o = /* @__PURE__ */ function(e) {
+	return e.Upload = "upload", e.Download = "download", e;
+}({}), s = (e, t) => `${e}:${t}`, c = (e) => {
+	let t = e.indexOf(":"), n = e.slice(0, t);
+	if (n === "upload" || n === "download") return {
+		kind: n,
+		entryId: e.slice(t + 1)
+	};
+}, l = (t, n) => ({
+	id: s("download", t.id),
+	name: t.name,
+	status: a[t.status],
+	percent: t.percent,
+	message: t.status === e.Failed && t.failureReason != null ? n?.[t.failureReason] : void 0
+}), u = (e, t, n) => [...i(e?.files ?? [], n).map((e) => ({
+	...e,
+	id: s("upload", e.id)
+})), ...(t?.files ?? []).map((e) => l(e, n))], d = ({ uploadLabels: e, downloadLabels: t, mixedProgressLabel: n, uploadNames: r, downloadNames: i }) => {
+	if (!t || i.size === 0) return e;
+	let a = (e) => i.has(e) && !r.has(e), o = (e, t) => e && t ? (n) => a(n) ? t(n) : e(n) : e ?? t, s = r.size === 0 ? t.queueProgressAriaLabel ?? e?.queueProgressAriaLabel : n ?? e?.queueProgressAriaLabel, c = o(e?.cancelItemAriaLabel, t.cancelItemAriaLabel), l = o(e?.itemProgressAriaLabel, t.itemProgressAriaLabel);
+	return {
+		...e,
+		...c ? { cancelItemAriaLabel: c } : {},
+		...l ? { itemProgressAriaLabel: l } : {},
+		...s ? { queueProgressAriaLabel: s } : {}
+	};
+};
 //#endregion
-export { r as toUploadQueueItems };
+export { o as TransferQueueRowKind, d as buildTransferQueueLabels, c as parseTransferQueueRowId, u as toTransferQueueItems, s as toTransferQueueRowId, i as toUploadQueueItems };

package/file-manager/useGridEditingScroll/useGridEditingScroll.d.ts

@@ -0,0 +1,27 @@
+import { FileManagerGridRow } from '@epam/ai-dial-react-file-manager';
+import { GridApi, IRowNode } from 'ag-grid-community';
+/** Options accepted by `useGridEditingScroll`. */
+export interface UseGridEditingScrollOptions {
+    /** Picks the row to scroll to among the rows newly added since the last `rowDataUpdated`. Defaults to the first row flagged `isTemporary`, or the first new row. */
+    resolveTargetNode?: (newNodes: IRowNode<FileManagerGridRow>[]) => IRowNode<FileManagerGridRow> | null;
+}
+/** Values returned by `useGridEditingScroll`. */
+export interface UseGridEditingScrollResult {
+    /** Pass to `DialFileManager`'s `onGridApiChange` prop. */
+    handleGridApiChange: (api: GridApi<FileManagerGridRow>) => void;
+    /** Re-seeds the known-row-id set without scrolling — call on a data-source change such as a tab switch. */
+    reset: () => void;
+}
+/**
+ * `@epam/ai-dial-react-file-manager`'s `GridOptions` type does not forward raw AG Grid
+ * event callbacks (`onCellEditingStarted`/`onRowDataUpdated`), so this hook
+ * binds directly to the `GridApi` obtained via `DialFileManager`'s
+ * `onGridApiChange` prop and uses AG Grid's own `addEventListener` instead of
+ * a `gridOptions` fragment. Scrolls a newly inline-edited or newly-inserted
+ * row into view. `handleGridApiChange` takes the raw `GridApi` only to bind
+ * to `onGridApiChange` — the narrow AGENTS.md D9 exception for this hook —
+ * and never renders, themes, or otherwise exposes AG Grid beyond that one
+ * event-binding parameter.
+ */
+export declare const useGridEditingScroll: ({ resolveTargetNode, }?: UseGridEditingScrollOptions) => UseGridEditingScrollResult;
+//# sourceMappingURL=useGridEditingScroll.d.ts.map

package/file-manager/useGridEditingScroll/useGridEditingScroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGridEditingScroll.d.ts","sourceRoot":"","sources":["../../../src/file-manager/useGridEditingScroll/useGridEditingScroll.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,KAAK,EAEV,OAAO,EACP,QAAQ,EAET,MAAM,mBAAmB,CAAC;AAmC3B,kDAAkD;AAClD,MAAM,WAAW,2BAA2B;IAC1C,oKAAoK;IACpK,iBAAiB,CAAC,EAAE,CAClB,QAAQ,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,KACrC,QAAQ,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC;CAC1C;AAOD,iDAAiD;AACjD,MAAM,WAAW,0BAA0B;IACzC,0DAA0D;IAC1D,mBAAmB,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,kBAAkB,CAAC,KAAK,IAAI,CAAC;IAChE,2GAA2G;IAC3G,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,GAAI,yBAElC,2BAAgC,KAAG,0BAiFrC,CAAC"}