@epam/ai-dial-chat-shared 1.3.0-dev.14 → 1.3.0-dev.142

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