@epam/ai-dial-chat-shared 1.2.0-rc.6 → 1.2.0-rc.8

package/file-manager/labels.d.ts

@@ -0,0 +1,156 @@
+import { DialFile, DialFileManager, DialFileManagerTabs } from '@epam/ai-dial-react-file-manager';
+import { TransferQueueLabels } from '@epam/ai-dial-ui-kit';
+import { ComponentProps, ReactNode } from 'react';
+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 is in progress. */
+    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 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>;
+    /** 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>;
+    /** 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;
+    /** 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/upload-batch.d.ts

@@ -0,0 +1,29 @@
+/** Lifecycle status of a single file within an upload batch. */
+export declare enum FileUploadStatus {
+    Queued = "queued",
+    Uploading = "uploading",
+    Completed = "completed",
+    Failed = "failed",
+    Cancelled = "cancelled"
+}
+/** 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;
+}
+/** 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;
+}
+/** 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,+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;CAClB;AAED,0EAA0E;AAC1E,MAAM,WAAW,oBAAoB;IACnC,mFAAmF;IACnF,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,kDAAkD;IAClD,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,0EAA0E;AAC1E,eAAO,MAAM,kBAAkB,GAC7B,YAAY,oBAAoB,GAAG,IAAI,KACtC,OAKS,CAAC"}

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

@@ -0,0 +1,5 @@
+import { TransferQueueItem } from '@epam/ai-dial-ui-kit';
+import { FileUploadEntry } from './upload-batch';
+/** Maps upload entries onto the UI kit's `TransferQueue` rows. */
+export declare const toUploadQueueItems: (files: FileUploadEntry[]) => TransferQueueItem[];
+//# 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,EAEvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,KAAK,eAAe,EAAoB,MAAM,gBAAgB,CAAC;AAexE,kEAAkE;AAClE,eAAO,MAAM,kBAAkB,GAC7B,OAAO,eAAe,EAAE,KACvB,iBAAiB,EAMf,CAAC"}

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