@epam/ai-dial-chat-hooks 1.2.0-dev.1 → 1.2.0-dev.102

package/file-manager.d.ts

@@ -1,5 +1,4 @@
 import { Annotation } from '@epam/ai-dial-chat-shared';
-import { AnnotationGroup } from '@epam/ai-dial-quotations';
 import { ArchiveItemDto } from '@epam/ai-dial-chat-api-client';
 import { Attachment } from '@epam/ai-dial-chat-shared';
 import { AttachmentDisplayResolvers } from '@epam/ai-dial-chat-shared';
@@ -8,8 +7,6 @@ import { CopyFilesResponseDto } from '@epam/ai-dial-chat-api-client';
 import { CopyItemDto } from '@epam/ai-dial-chat-api-client';
 import { CreateFolderDto } from '@epam/ai-dial-chat-api-client';
 import { CreateFolderResponseDto } from '@epam/ai-dial-chat-api-client';
-import { CustomVisualizer } from '@epam/ai-dial-chat-shared';
-import type { CustomVisualizerDataLayout } from '@epam/ai-dial-chat-shared';
 import { DeleteFilesResponseDto } from '@epam/ai-dial-chat-api-client';
 import { DeleteItemDto } from '@epam/ai-dial-chat-api-client';
 import { DialCopiedItem } from '@epam/ai-dial-react-file-manager';
@@ -27,15 +24,17 @@ import { DiscardSharedItemDto } from '@epam/ai-dial-chat-api-client';
 import { DiscardSharedResponseDto } from '@epam/ai-dial-chat-api-client';
 import { DisplayAttachment } from '@epam/ai-dial-chat-shared';
 import { FileManagerColumnKey } from '@epam/ai-dial-react-file-manager';
+import { FileManagerSelectableNode } from '@epam/ai-dial-chat-shared';
 import { FileMetadataResponseDto } from '@epam/ai-dial-chat-api-client';
 import { FilesApi } from '@epam/ai-dial-chat-api-client';
+import { FileTreeOptions } from '@epam/ai-dial-react-file-manager';
 import { FileUploadBatchState } from '@epam/ai-dial-chat-shared';
 import { FileUploadEntry } from '@epam/ai-dial-chat-shared';
 import { FileUploadResponseDto } from '@epam/ai-dial-chat-api-client';
 import { FileUploadStatus } from '@epam/ai-dial-chat-shared';
 import { FileUploadValidationResult } from '@epam/ai-dial-chat-shared';
+import { FilterChipItem } from '@epam/ai-dial-ui-kit';
 import { getParentFolderPath } from '@epam/ai-dial-chat-shared';
-import type { InputHighlightData } from '@epam/pdf-highlighter-kit';
 import { ListFilesItemDto } from '@epam/ai-dial-chat-api-client';
 import { ListFilesResponseDto } from '@epam/ai-dial-chat-api-client';
 import { ListPublicFilesRequest } from '@epam/ai-dial-chat-api-client';
@@ -48,8 +47,6 @@ import { RenameFilesResponseDto } from '@epam/ai-dial-chat-api-client';
 import { RenameItemDto } from '@epam/ai-dial-chat-api-client';
 import { RevokeAccessItemDto } from '@epam/ai-dial-chat-api-client';
 import { RevokeAccessResponseDto } from '@epam/ai-dial-chat-api-client';
-import { TabModel } from '@epam/ai-dial-ui-kit';
-import { ToolbarOptions } from '@epam/ai-dial-react-file-manager';
 import { UploadArchiveResponseDto } from '@epam/ai-dial-chat-api-client';
 import { useGridEditingScroll } from '@epam/ai-dial-chat-shared';
 import { UseGridEditingScrollOptions } from '@epam/ai-dial-chat-shared';
@@ -58,55 +55,6 @@ import { UseGridEditingScrollResult } from '@epam/ai-dial-chat-shared';
 /** Maps an annotation's source attachment to the display-only attachment model. */
 export declare const annotationToDisplayAttachment: (annotation: Annotation) => DisplayAttachment | null;
 
-/**
- * Builds an `OoxmlCanvasContent` for a DOCX/PPTX/XLSX citation annotation,
- * including highlights for every annotation sharing the clicked one's source
- * document. Returns `null` when the annotation has no source attachment,
- * the source is not a format `@silurus/ooxml` renders as DOCX/XLSX/PPTX (a
- * CSV source returns `null` — citation highlighting targets Office documents
- * only), or no URL resolves.
- */
-export declare const annotationToOoxmlCanvasContent: (annotation: Annotation, annotations: Annotation[], resolvers: AttachmentCanvasUrlResolvers) => OoxmlCanvasContent | null;
-
-/**
- * Builds a `PdfCanvasContent` for a PDF citation annotation, including highlights
- * for the clicked annotation's document within its citation group.
- * Returns `null` if the annotation has no PDF source attachment.
- */
-export declare const annotationToPdfCanvasContent: (annotation: Annotation, groups: AnnotationGroup[], resolvers: AttachmentCanvasUrlResolvers) => PdfCanvasContent | null;
-
-/**
- * DIAL-file URL resolution injected by the host into every attachment-canvas
- * content resolver below. Host-owned — encodes the app's own
- * file-download endpoint.
- */
-export declare interface AttachmentCanvasUrlResolvers {
-    /** Resolves a DIAL Core file id to a downloadable URL. */
-    resolveDialFileDownloadUrl: (fileId: string) => string | undefined;
-    /** Resolves the best downloadable DIAL-file URL from an attachment's `url` or `referenceUrl`. */
-    resolveDialUrl: (attachment: DisplayAttachment) => string | undefined;
-    /** Resolves a DIAL Core file id to a fetchable metadata URL (used for cache-freshness validation). */
-    resolveDialFileMetadataUrl: (fileId: string) => string | undefined;
-}
-
-/** The type of content the canvas can display. */
-declare enum AttachmentContentType {
-    PlainText = 'plain_text',
-    Image = 'image',
-    Audio = 'audio',
-    Markdown = 'markdown',
-    MarkdownTable = 'markdown_table',
-    Json = 'json',
-    Pdf = 'pdf',
-    Ooxml = 'ooxml',
-    Code = 'code',
-    Html = 'html',
-    Visualizer = 'visualizer',
-    McpApp = 'mcp_app',
-    Unsupported = 'unsupported',
-    Error = 'error',
-}
-
 /** Maps Chat API attachment DTOs to display-only attachment models. */
 export declare const attachmentDtosToDisplayAttachments: (dtos: MessageAttachment[] | undefined, resolvers: AttachmentDisplayResolvers) => DisplayAttachment[];
 
@@ -115,14 +63,6 @@ export declare const attachmentDtosToDisplayAttachments: (dtos: MessageAttachmen
  */
 export declare const attachmentDtoToDisplayAttachment: (dto: MessageAttachment, resolvers: AttachmentDisplayResolvers) => DisplayAttachment;
 
-/** The kind of failure that produced an `ErrorCanvasContent`. */
-declare enum AttachmentErrorType {
-    /** The file failed to load (network error or a non-`403` non-OK response). */
-    LoadFailed = 'load_failed',
-    /** The file request failed with HTTP `403` — the user lacks permission to access it. */
-    Forbidden = 'forbidden',
-}
-
 export declare const buildFromCache: (cache: Map<string, ListFilesItemDto[]>, listingPermissionsCache: Map<string, string[] | undefined>, apiPath: string, virtualBasePath: string, folderId: string) => DialFile[];
 
 /**
@@ -136,19 +76,6 @@ export declare const buildFromCache: (cache: Map<string, ListFilesItemDto[]>, li
  */
 export declare const buildSharedItemVirtualPath: (relativePath: string, rootLabel: string, isFolder: boolean) => string;
 
-/** Clears all cached fetch results. Call this when leaving a conversation. */
-export declare const clearAttachmentCache: () => void;
-
-/** Content payload for syntax-highlighted source-code or text file attachments. */
-declare interface CodeCanvasContent {
-    /** Discriminates the content type to select the correct renderer. */
-    type: AttachmentContentType.Code;
-    /** The raw source text to display. */
-    text: string;
-    /** `react-syntax-highlighter` language identifier (e.g. `'typescript'`). `undefined` renders plain monospace. */
-    language?: string;
-}
-
 export declare const COLUMNS_WITH_AUTHOR: FileManagerColumnKey[];
 
 export declare const COLUMNS_WITHOUT_AUTHOR: FileManagerColumnKey[];
@@ -335,18 +262,6 @@ export declare enum DownloadDestinationType {
     Cancelled = "cancelled"
 }
 
-/** Content payload for attachments whose file failed to load or that the user cannot access. */
-declare interface ErrorCanvasContent {
-    /** Discriminates the content type to select the correct renderer. */
-    type: AttachmentContentType.Error;
-    /** The kind of failure that occurred. */
-    errorType: AttachmentErrorType;
-    /** Remote URL of the file, if known. Ignored for download purposes when `errorType` is `Forbidden`. */
-    url?: string;
-    /** Overrides the default `loadErrorLabel`/`forbiddenErrorLabel` message, for callers whose failed content isn't a generic "file" (e.g. an MCP App). */
-    label?: string;
-}
-
 export declare const fetchByTab: (filesApi: DialFilesApi, tab: DialFileManagerTabs, bucket: string, folderPath: string, sharedRootMeta: Map<string, SharedRootMeta>) => Promise<{
     items: ListFilesItemDto[];
     permissions?: string[];
@@ -570,36 +485,10 @@ export declare const getUrlFileName: (url: string) => string;
 
 export declare const getVirtualPathName: (virtualPath: string, fallback: string) => string;
 
-/**
- * Whether the attachment carries text `resolveAttachmentText` can resolve —
- * inline data, a DIAL download URL, or a locally-picked file. Mirrors that
- * function's source list, so a `null` resolver result can be read as "the text
- * was fetched and rejected" rather than "there was no text to fetch".
- */
-export declare const hasAttachmentTextSource: (attachment: DisplayAttachment, resolvers: AttachmentCanvasUrlResolvers) => boolean;
-
 export declare const hasDialFileWritePermission: (folder?: DialFile) => boolean;
 
 export declare const hasForbiddenNameSymbols: (name: string, forbiddenSymbolsRegExp?: RegExp) => boolean;
 
-/** Content payload for HTML file attachments or external HTML URL sources. */
-declare interface HtmlCanvasContent {
-    /** Discriminates the content type to select the correct renderer. */
-    type: AttachmentContentType.Html;
-    /** Full HTML text rendered via `srcdoc` in a sandboxed iframe. Used for file attachments. */
-    srcdoc?: string;
-    /** External URL rendered via `src` in a sandboxed iframe. Used for external link sources. */
-    url?: string;
-}
-
-/** Content payload for image attachments. */
-declare interface ImageCanvasContent {
-    /** Discriminates the content type to select the correct renderer. */
-    type: AttachmentContentType.Image;
-    /** URL of the image to display (object URL or resolved download URL). */
-    url: string;
-}
-
 /** Copy/Move/Duplicate are Browse/Full-only — the attach picker excludes them. */
 export declare const isCopyMoveDuplicateAllowed: (actionProfile: DialFileManagerActionProfile) => boolean;
 
@@ -615,14 +504,6 @@ export declare const isExternalSourcePreviewable: (contentType: string, url: str
 /** Share/Unshare/Remove access are Full-only — Browse and Attach never expose them. */
 export declare const isShareActionsAllowed: (actionProfile: DialFileManagerActionProfile) => boolean;
 
-/** Content payload for JSON file attachments. */
-declare interface JsonCanvasContent {
-    /** Discriminates the content type to select the correct renderer. */
-    type: AttachmentContentType.Json;
-    /** Already-parsed JSON value. The lib never calls JSON.parse. */
-    value: unknown;
-}
-
 export declare const mapCorePermissions: (permissions?: string[]) => DialFile["permissions"] | undefined;
 
 /**
@@ -636,20 +517,19 @@ export declare const mapFileMetadataToDialFile: (metadata: FileMetadataResponseD
 
 export declare const mapSearchItem: (item: ListFilesItemDto, fallbackBucket: string, rootLabel: string) => DialFile;
 
-/** Content payload for Markdown file attachments. */
-declare interface MarkdownCanvasContent {
-    /** Discriminates the content type to select the correct renderer. */
-    type: AttachmentContentType.Markdown;
-    /** Raw Markdown string to render. */
-    text: string;
-}
-
 export declare const mergeCreatedFolderIntoCache: (cache: Map<string, ListFilesItemDto[]>, parentApiPath: string, created: CreateFolderResponseDto, inheritedPermissions?: string[]) => Map<string, ListFilesItemDto[]>;
 
 /** Formats MIME types as a human-readable, comma-separated list of dotted extensions (or the MIME type itself for wildcards). */
 export declare const mimeTypesToAttachmentExtensionLabels: (types: string[]) => string;
 
-/** Normalizes `*` to the all-files wildcard and drops any value that is not a valid `DialFileAcceptType`. */
+/**
+ * Normalizes `*` to the all-files wildcard, canonicalizes MIME aliases, and drops
+ * any value that is not a valid `DialFileAcceptType`.
+ *
+ * Aliases are resolved because a file picker matches an `accept` entry against its
+ * own MIME table: a declared `text/json` offers no `.json` file, while the
+ * `application/json` it denotes does.
+ */
 export declare const mimeTypesToDialFileAcceptTypes: (types?: string[]) => DialFileAcceptType[] | undefined;
 
 /**
@@ -661,104 +541,6 @@ export declare const mimeTypesToFileAccept: (types?: string[]) => string | undef
 
 export declare const normalizeVirtualPath: (value: string) => string;
 
-/** Content payload for OOXML document and CSV spreadsheet attachments. */
-declare interface OoxmlCanvasContent {
-    /** Discriminates the content type to select the correct renderer. */
-    type: AttachmentContentType.Ooxml;
-    /** Resolved download URL or object URL for the source file. */
-    url: string;
-    /** The document format used to select and configure the format-specific renderer. */
-    format: OoxmlFileType;
-    /** Cited locations to draw over the document. Omitted, never `[]`, when there is nothing to highlight. */
-    highlights?: OoxmlHighlight[];
-    /** Id of the highlight to navigate to and emphasise. Omitted when the clicked citation resolved to no location. */
-    selectedHighlightId?: string;
-}
-
-/** A 1-based cell address, matching `@silurus/ooxml`'s own `CellAddress`. */
-declare interface OoxmlCellAddress {
-    /** 1-based row number. */
-    row: number;
-    /** 1-based column number. */
-    col: number;
-}
-
-/** A cited character range inside a DOCX story, addressed by story name and source-tree path. */
-declare interface OoxmlDocxHighlightLocation {
-    /** Discriminates this location within `OoxmlHighlightLocation`. */
-    kind: OoxmlHighlightKind.DocxTextRange;
-    /** Name of the DOCX story the range lives in, as an opaque string (only `'body'` is confirmed upstream). */
-    story: string;
-    /** Source-tree element indices identifying the paragraph, matched element-wise. */
-    path: number[];
-    /** Inclusive start character offset within the story's matched text. */
-    start: number;
-    /** Exclusive end character offset, already converted from the wire's inclusive `end`. */
-    endExclusive: number;
-    /** The cited text, compared against the text resolved over `[start, endExclusive)`. */
-    text: string;
-}
-
-/** Supported document formats rendered by the bundled `@silurus/ooxml` runtime. */
-declare enum OoxmlFileType {
-    Docx = 'docx',
-    Xlsx = 'xlsx',
-    Pptx = 'pptx',
-    Csv = 'csv',
-}
-
-/** One citation's highlight: the locations it resolved to, under a stable id. */
-declare interface OoxmlHighlight {
-    /** Stable id, used to mark exactly one highlight selected. */
-    id: string;
-    /** One or more locations — a single citation may carry several selectors. */
-    locations: OoxmlHighlightLocation[];
-}
-
-/** Discriminates the Office highlight location descriptors an `OoxmlCanvasContent` can carry. */
-declare enum OoxmlHighlightKind {
-    /** A character range inside a DOCX story, addressed by story name and source-tree path. */
-    DocxTextRange = 'docxTextRange',
-    /** A character range inside a single PPTX shape on one slide. */
-    PptxTextRange = 'pptxTextRange',
-    /** One cell, or a contiguous same-row cell range, on a named XLSX sheet. */
-    XlsxCellRange = 'xlsxCellRange',
-}
-
-/** A cited location inside an Office document, in document coordinates. */
-declare type OoxmlHighlightLocation =
-| OoxmlDocxHighlightLocation
-| OoxmlPptxHighlightLocation
-| OoxmlXlsxHighlightLocation;
-
-/** A cited character range inside a single shape on one PPTX slide. */
-declare interface OoxmlPptxHighlightLocation {
-    /** Discriminates this location within `OoxmlHighlightLocation`. */
-    kind: OoxmlHighlightKind.PptxTextRange;
-    /** 1-based slide number. */
-    slide: number;
-    /** Shape identifier, compared as a string against the run's own `shapeId`. */
-    shapeId: string;
-    /** Inclusive start character offset within the shape's matched text. */
-    start: number;
-    /** Exclusive end character offset, already converted from the wire's inclusive `end`. */
-    endExclusive: number;
-    /** The cited text, compared against the text resolved over `[start, endExclusive)`. */
-    text: string;
-}
-
-/** A cited cell, or contiguous same-row cell range, on a named XLSX sheet. */
-declare interface OoxmlXlsxHighlightLocation {
-    /** Discriminates this location within `OoxmlHighlightLocation`. */
-    kind: OoxmlHighlightKind.XlsxCellRange;
-    /** Sheet name, matched exactly against the workbook's own sheet names. */
-    sheet: string;
-    /** First cell of the range. 1-based, passed to the viewer unconverted. */
-    start: OoxmlCellAddress;
-    /** Last cell of the range, on the same row as `start`. Omitted for a single cell. */
-    end?: OoxmlCellAddress;
-}
-
 /**
  * Opens a cited/referenced attachment: triggers a browser download for
  * DIAL-hosted files (`files/...` ids) via the injected `resolveDownloadUrl`,
@@ -774,28 +556,6 @@ export declare const parseNewFolderVirtualPath: (newFolderVirtualPath: string, r
 
 export declare const PATH_SEPARATOR_REGEXP: RegExp;
 
-/** Content payload for PDF file attachments. */
-declare interface PdfCanvasContent {
-    /** Discriminates the content type to select the correct renderer. */
-    type: AttachmentContentType.Pdf;
-    /** Resolved download URL or object URL for the PDF file. */
-    url: string;
-    /** Highlight regions to render over the PDF pages. */
-    highlights?: InputHighlightData[];
-    /** ID of the highlight to scroll to and select on initial load. */
-    selectedHighlightId?: string;
-    /** 1-based page to navigate to on initial load, independent of highlight geometry. */
-    page?: number;
-}
-
-/** Content payload for plain-text attachments. */
-declare interface PlainTextCanvasContent {
-    /** Discriminates the content type to select the correct renderer. */
-    type: AttachmentContentType.PlainText;
-    /** The raw text to display. */
-    text: string;
-}
-
 /** Builds the `copyFiles` DTOs (with their destination display name) for `onCopyFiles`. */
 export declare const prepareCopyItems: (copiedItems: DialCopiedItem[], bucket: string, rootLabel: string) => PreparedCopyMoveItem<CopyItemDto>[];
 
@@ -821,21 +581,9 @@ export declare const prepareMoveRenameItems: (copiedItems: DialCopiedItem[], buc
     preparedMoveItems: PreparedCopyMoveItem<MoveItemDto>[];
 };
 
-/**
- * Builds a `PdfCanvasContent` for a reference-only attachment whose
- * `reference_url` points at a PDF file (optionally with a `#page=N`
- * fragment), so it can be opened in the canvas and scrolled to the
- * referenced page the same way a regular PDF citation is. Returns `null`
- * when the attachment's `url` does not target a PDF.
- */
-export declare const referenceAttachmentToPdfCanvasContent: (attachment: AttachmentResource, resolvers: AttachmentCanvasUrlResolvers) => PdfCanvasContent | null;
-
 /** Name reserved for the hidden marker file used to create empty folders. */
 export declare const RESERVED_MARKER_NAME = ".dial_folder";
 
-/** Resolves a syntax-highlighted code canvas content payload from a DisplayAttachment, or `null` if unavailable. */
-export declare const resolveCodeCanvasContent: (attachment: DisplayAttachment, resolvers: AttachmentCanvasUrlResolvers, language?: string) => Promise<CodeCanvasContent | ErrorCanvasContent | null>;
-
 /**
  * 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.
@@ -870,35 +618,6 @@ declare type ResolveDownloadUrl = (fileId: string) => string | undefined;
  */
 export declare const resolveExternalSourceContentType: (contentType: string, url: string) => string;
 
-/**
- * Resolves an HTML canvas content payload from a DisplayAttachment.
- * Fetches and inlines the HTML as `srcdoc` when the attachment has a download URL or inline data.
- * Returns `null` if no source is available, or an `ErrorCanvasContent` on fetch failure.
- * Rejects `srcdoc` payloads larger than 1 MiB to prevent browser truncation.
- */
-export declare const resolveHtmlCanvasContent: (attachment: DisplayAttachment, resolvers: AttachmentCanvasUrlResolvers) => Promise<HtmlCanvasContent | ErrorCanvasContent | null>;
-
-/**
- * Resolves an image canvas content payload from a DisplayAttachment without
- * fetching — returns the BFF download URL (or a local/inline blob URL)
- * directly so the browser cache can be shared with the conversation view's
- * `<img>` element. Error detection is delegated to `<img onError>` in the
- * canvas renderer. Returns `null` if no URL source is available.
- */
-export declare const resolveImageCanvasContent: (attachment: DisplayAttachment, resolvers: AttachmentCanvasUrlResolvers) => ImageCanvasContent | null;
-
-/**
- * Resolves a JSON canvas content payload from a DisplayAttachment, or `null` if unavailable.
- * Falls back to `PlainTextCanvasContent` when the fetched text is not valid JSON.
- */
-export declare const resolveJsonCanvasContent: (attachment: DisplayAttachment, resolvers: AttachmentCanvasUrlResolvers) => Promise<JsonCanvasContent | PlainTextCanvasContent | ErrorCanvasContent | null>;
-
-/** Resolves a Markdown canvas content payload from a DisplayAttachment, or `null` if unavailable. */
-export declare const resolveMarkdownCanvasContent: (attachment: DisplayAttachment, resolvers: AttachmentCanvasUrlResolvers) => Promise<MarkdownCanvasContent | ErrorCanvasContent | null>;
-
-/** Resolves an OOXML or CSV renderer payload from a DisplayAttachment, or `null` if unavailable. */
-export declare const resolveOoxmlCanvasContent: (attachment: DisplayAttachment, resolvers: AttachmentCanvasUrlResolvers, format: OoxmlFileType) => Promise<OoxmlCanvasContent | ErrorCanvasContent | null>;
-
 /**
  * Resolves the effective bucket and path for a write operation on the Shared tab.
  * For Shared tab items, the first segment of apiPath is the shared root folder name
@@ -909,30 +628,12 @@ export declare const resolveOwnerCoords: (apiPath: string, sharedRootMeta: Map<s
     path: string;
 };
 
-/** Resolves a PDF canvas content payload from a DisplayAttachment, or `null` if unavailable. */
-export declare const resolvePdfCanvasContent: (attachment: DisplayAttachment, resolvers: AttachmentCanvasUrlResolvers) => Promise<PdfCanvasContent | ErrorCanvasContent | null>;
-
 /**
  * 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;
 
-/** Resolves a plain-text canvas content payload from a DisplayAttachment, or `null` if unavailable. */
-export declare const resolveTextCanvasContent: (attachment: DisplayAttachment, resolvers: AttachmentCanvasUrlResolvers) => Promise<PlainTextCanvasContent | ErrorCanvasContent | null>;
-
-/**
- * Fetches the attachment payload and builds a `VisualizerCanvasContent` for the
- * given registry entry and theme. Returns `null` when the payload cannot be
- * fetched (caller should fall through to default content-type handling).
- *
- * Only JSON payloads are parsed into `data`. Non-JSON payloads (plain text,
- * CSV, binary, …) resolve with `data: {}` — the visualizer still receives
- * `mimeType` and `layout`, just no payload body. This is intentional: only
- * JSON attachment content is forwarded to visualizers in this version.
- */
-export declare const resolveVisualizerCanvasContent: (attachment: DisplayAttachment, resolvers: AttachmentCanvasUrlResolvers, entry: CustomVisualizer, themeId: string) => Promise<VisualizerCanvasContent | null>;
-
 /**
  * Sanitizes a filename for upload by replacing forbidden characters with `_`,
  * trimming trailing dots/whitespace from the base name, and capping the result
@@ -1240,11 +941,11 @@ export declare interface UseDialFileManagerResult {
  * current one becomes excluded. A `fileManagerTabs` of `undefined` means no
  * restriction — every tab in `allTabs` stays enabled and no reset ever fires.
  */
-export declare const useDialFileManagerTabConfig: (activeTab: DialFileManagerTabs, onTabChange: (tab: DialFileManagerTabs) => void, allTabs: TabModel[] | undefined, fileManagerTabs: string[] | undefined) => UseDialFileManagerTabConfigResult;
+export declare const useDialFileManagerTabConfig: (activeTab: DialFileManagerTabs, onTabChange: (tab: DialFileManagerTabs) => void, allTabs: FilterChipItem<DialFileManagerTabs>[] | undefined, fileManagerTabs: string[] | undefined) => UseDialFileManagerTabConfigResult;
 
 /** Values returned by `useDialFileManagerTabConfig`. */
 export declare interface UseDialFileManagerTabConfigResult {
-    tabs: ToolbarOptions['tabs'];
+    tabs: FileTreeOptions['tabs'];
 }
 
 /**
@@ -1408,6 +1109,64 @@ export declare interface UseDialFileUploadBatchResult {
     clearUploadBatch: () => void;
 }
 
+/**
+ * Composes the file-manager tab/listing hooks into the stateful part of an attachment picker:
+ * active tab, selected paths, and hidden-path/MIME/size/folder row eligibility. Returns the
+ * existing `useDialFileManager` controller unchanged and the selection/tab/eligibility fields
+ * `FileManagerAttachModal` already consumes — it composes that modal, it does not replace it.
+ * Final attachment filtering, deduplication, and count enforcement stay owned by the modal.
+ */
+export declare const useFileAttachmentPicker: ({ fileManagerOptions, bucket, forbiddenSymbolsRegExp, tabLabels, allowedTabs, initialTab, allowedTypes, maxSelectableFileSize, canAttachFolders, }: UseFileAttachmentPickerOptions) => UseFileAttachmentPickerResult;
+
+/** Options accepted by {@link useFileAttachmentPicker}. */
+export declare interface UseFileAttachmentPickerOptions {
+    /**
+     * Configured `useDialFileManager` options besides the values this hook derives:
+     * `bucket`, `activeTab`, `rootLabel`, `variant`, and `forbiddenSymbolsRegExp`.
+     */
+    fileManagerOptions: Omit<UseDialFileManagerOptions, 'bucket' | 'activeTab' | 'rootLabel' | 'variant' | 'forbiddenSymbolsRegExp'>;
+    /** DIAL Core bucket to browse. */
+    bucket: string;
+    /** Regexp of characters forbidden in file/folder names, forwarded to `useDialFileManager`. */
+    forbiddenSymbolsRegExp?: RegExp;
+    /** Host-translated label per tab; also supplies the active tab's root-folder label. */
+    tabLabels: Record<DialFileManagerTabs, string>;
+    /** Tab ids the host's configuration allows. `undefined` allows every tab. */
+    allowedTabs?: string[];
+    /** Initial active tab. Defaults to `DialFileManagerTabs.MyFiles`. */
+    initialTab?: DialFileManagerTabs;
+    /** MIME types eligible for selection/upload. Empty or absent allows every type. */
+    allowedTypes?: string[];
+    /** Files at or below this size (bytes) remain eligible; absent allows any size. */
+    maxSelectableFileSize?: number;
+    /** Whether folder rows are eligible for selection. Defaults to `false`. */
+    canAttachFolders?: boolean;
+}
+
+/** Result returned by {@link useFileAttachmentPicker}. */
+export declare interface UseFileAttachmentPickerResult {
+    /** The composed file-manager controller; forward to `FileManagerAttachModal`'s `controller` prop. */
+    controller: UseDialFileManagerResult;
+    /** Active tab. */
+    activeTab: DialFileManagerTabs;
+    /** Tab list filtered to `allowedTabs`; forward to `FileManagerAttachModal`'s `tabs` prop. */
+    tabs: FileTreeOptions['tabs'];
+    /** Switches the active tab and clears the current selection. */
+    onTabChange: (tab: DialFileManagerTabs) => void;
+    /** Currently selected paths. */
+    selectedPaths: Set<string>;
+    /** Replaces the selection with a defensive copy of the given set. */
+    onSelectedPathsChange: (paths: Set<string>) => void;
+    /** Row eligibility predicate; forward to `FileManagerAttachModal`'s `isRowSelectable` prop. */
+    isRowSelectable: (node: {
+        data?: FileManagerSelectableNode | null;
+    }) => boolean;
+    /** MIME eligibility predicate; forward to `FileManagerAttachModal`'s `isFileTypeAllowed` prop. */
+    isFileTypeAllowed: (contentType: string) => boolean;
+    /** Accepted upload MIME types; forward to `FileManagerAttachModal`'s `allowedFileTypes` prop. */
+    allowedFileTypes: DialFileAcceptType[] | undefined;
+}
+
 export { useGridEditingScroll }
 
 export { UseGridEditingScrollOptions }
@@ -1420,22 +1179,4 @@ export { UseGridEditingScrollResult }
  */
 export declare const virtualPathToApiPath: (virtualPath: string, rootLabel: string) => string;
 
-/** Content payload for a custom-visualizer attachment rendered inside a sandboxed iframe. */
-declare interface VisualizerCanvasContent {
-    /** Discriminates the content type to select the correct renderer. */
-    type: AttachmentContentType.Visualizer;
-    /** Iframe `src`, resolved from the matching registry entry's `url`. */
-    url: string;
-    /** The attachment's own MIME type (not the registry entry's raw, possibly comma-separated, `contentType`). */
-    mimeType: string;
-    /** Opaque attachment payload consumed by the visualizer. */
-    data: unknown;
-    /** Presentation layout hints (`themeId`, `width`, `height`, `mobileHeight`). */
-    layout: CustomVisualizerDataLayout;
-    /** postMessage protocol namespace — MUST equal the registry entry's `title`, or the iframe never receives data. */
-    visualizerName: string;
-    /** Milliseconds to wait for a `send()` request's response before rejecting. From the registry entry; does NOT bound the handshake. */
-    requestTimeout?: number;
-}
-
 export { }

package/file-manager.js

@@ -12,18 +12,18 @@ import { buildFromCache as H, fetchByTab as U, fetchForSearch as W, findFirstSuc
 import { createFilesApiClient as Z } from "./files/create-files-api.js";
 import { createUploadFileWithProgress as Q } from "./files/create-upload-file-with-progress.js";
 import { openAnnotationAttachment as $ } from "./files/annotation.js";
-import { annotationToOoxmlCanvasContent as ee, annotationToPdfCanvasContent as te, clearAttachmentCache as ne, hasAttachmentTextSource as re, referenceAttachmentToPdfCanvasContent as ie, resolveCodeCanvasContent as ae, resolveHtmlCanvasContent as oe, resolveImageCanvasContent as se, resolveJsonCanvasContent as ce, resolveMarkdownCanvasContent as le, resolveOoxmlCanvasContent as ue, resolvePdfCanvasContent as de, resolveTextCanvasContent as fe, resolveVisualizerCanvasContent as pe } from "./files/attachment-canvas.js";
-import { getUrlFileName as me, isExternalSourcePreviewable as he, resolveExternalSourceContentType as ge } from "./files/source-content.js";
-import { annotationToDisplayAttachment as _e, attachmentDtoToDisplayAttachment as ve, attachmentDtosToDisplayAttachments as ye } from "./files/attachment-dto-to-display.js";
-import { dialFileToAttachment as be, dialFilesToAttachments as xe, dialFolderPathToAttachment as Se } from "./files/dial-file-to-attachment.js";
-import { DownloadDestinationType as Ce } from "./files/download-destination.js";
-import { prepareDownloadDestination as we } from "./files/prepare-download-destination.js";
-import { useDialFileListing as Te } from "./files/useDialFileListing/useDialFileListing.js";
-import { useDialFileMetadata as Ee } from "./files/useDialFileMetadata/useDialFileMetadata.js";
-import { useDialFileMutations as De } from "./files/useDialFileMutations/useDialFileMutations.js";
-import { useDialFileSharing as Oe } from "./files/useDialFileSharing/useDialFileSharing.js";
-import { useDialFileUploadBatch as ke } from "./files/useDialFileUploadBatch/useDialFileUploadBatch.js";
-import { useDialFileManager as Ae } from "./files/useDialFileManager/useDialFileManager.js";
-import { useDialFileManagerTabConfig as je } from "./files/useDialFileManagerTabConfig/useDialFileManagerTabConfig.js";
-import { useGridEditingScroll as Me } from "@epam/ai-dial-chat-shared";
-export { m as COLUMNS_WITHOUT_AUTHOR, h as COLUMNS_WITH_AUTHOR, g as CORE_PERMISSION_MAP, _ as DATE_OPTIONS, x as DialFileManagerActionProfile, S as DialFileManagerVariant, u as DialFilesApiUploadMode, Ce as DownloadDestinationType, d as FileManagerNotificationReason, f as FileNameValidationErrorReason, p as FileOperationKind, v as PATH_SEPARATOR_REGEXP, y as RESERVED_MARKER_NAME, b as UPLOAD_CONCURRENCY, _e as annotationToDisplayAttachment, ee as annotationToOoxmlCanvasContent, te as annotationToPdfCanvasContent, ve as attachmentDtoToDisplayAttachment, ye as attachmentDtosToDisplayAttachments, H as buildFromCache, w as buildSharedItemVirtualPath, ne as clearAttachmentCache, Z as createFilesApiClient, Q as createUploadFileWithProgress, C as deriveActionProfile, T as dialCorePathToRelative, be as dialFileToAttachment, xe as dialFilesToAttachments, Se as dialFolderPathToAttachment, U as fetchByTab, W as fetchForSearch, E as findDialFileByPath, G as findFirstSuccessfulCopyMoveItem, D as findFolderByVirtualPath, O as formatOperationFolderName, L as getParentFolderPath, me as getUrlFileName, k as getVirtualPathName, re as hasAttachmentTextSource, A as hasDialFileWritePermission, j as hasForbiddenNameSymbols, M as isCopyMoveDuplicateAllowed, r as isDialFileAcceptType, e as isDialFileId, he as isExternalSourcePreviewable, N as isShareActionsAllowed, K as mapCorePermissions, q as mapFileMetadataToDialFile, J as mapSearchItem, Y as mergeCreatedFolderIntoCache, i as mimeTypesToAttachmentExtensionLabels, a as mimeTypesToDialFileAcceptTypes, o as mimeTypesToFileAccept, P as normalizeVirtualPath, $ as openAnnotationAttachment, F as parseNewFolderVirtualPath, B as prepareCopyItems, we as prepareDownloadDestination, V as prepareMoveRenameItems, ie as referenceAttachmentToPdfCanvasContent, ae as resolveCodeCanvasContent, R as resolveDialFileApiPath, t as resolveDialFileBucketAndPath, ge as resolveExternalSourceContentType, oe as resolveHtmlCanvasContent, se as resolveImageCanvasContent, ce as resolveJsonCanvasContent, le as resolveMarkdownCanvasContent, ue as resolveOoxmlCanvasContent, I as resolveOwnerCoords, de as resolvePdfCanvasContent, n as resolveRelativeDialFilePath, fe as resolveTextCanvasContent, pe as resolveVisualizerCanvasContent, s as sanitizeFileName, c as splitFileNameExtension, l as trimFileNameToByteLimit, X as updateEntry, Te as useDialFileListing, Ae as useDialFileManager, je as useDialFileManagerTabConfig, Ee as useDialFileMetadata, De as useDialFileMutations, Oe as useDialFileSharing, ke as useDialFileUploadBatch, Me as useGridEditingScroll, z as virtualPathToApiPath };
+import { getUrlFileName as ee, isExternalSourcePreviewable as te, resolveExternalSourceContentType as ne } from "./files/source-content.js";
+import { annotationToDisplayAttachment as re, attachmentDtoToDisplayAttachment as ie, attachmentDtosToDisplayAttachments as ae } from "./files/attachment-dto-to-display.js";
+import { dialFileToAttachment as oe, dialFilesToAttachments as se, dialFolderPathToAttachment as ce } from "./files/dial-file-to-attachment.js";
+import { DownloadDestinationType as le } from "./files/download-destination.js";
+import { prepareDownloadDestination as ue } from "./files/prepare-download-destination.js";
+import { useDialFileListing as de } from "./files/useDialFileListing/useDialFileListing.js";
+import { useDialFileMetadata as fe } from "./files/useDialFileMetadata/useDialFileMetadata.js";
+import { useDialFileMutations as pe } from "./files/useDialFileMutations/useDialFileMutations.js";
+import { useDialFileSharing as me } from "./files/useDialFileSharing/useDialFileSharing.js";
+import { useDialFileUploadBatch as he } from "./files/useDialFileUploadBatch/useDialFileUploadBatch.js";
+import { useDialFileManager as ge } from "./files/useDialFileManager/useDialFileManager.js";
+import { useDialFileManagerTabConfig as _e } from "./files/useDialFileManagerTabConfig/useDialFileManagerTabConfig.js";
+import { useFileAttachmentPicker as ve } from "./files/useFileAttachmentPicker/useFileAttachmentPicker.js";
+import { useGridEditingScroll as ye } from "@epam/ai-dial-chat-shared";
+export { m as COLUMNS_WITHOUT_AUTHOR, h as COLUMNS_WITH_AUTHOR, g as CORE_PERMISSION_MAP, _ as DATE_OPTIONS, x as DialFileManagerActionProfile, S as DialFileManagerVariant, u as DialFilesApiUploadMode, le as DownloadDestinationType, d as FileManagerNotificationReason, f as FileNameValidationErrorReason, p as FileOperationKind, v as PATH_SEPARATOR_REGEXP, y as RESERVED_MARKER_NAME, b as UPLOAD_CONCURRENCY, re as annotationToDisplayAttachment, ie as attachmentDtoToDisplayAttachment, ae as attachmentDtosToDisplayAttachments, H as buildFromCache, w as buildSharedItemVirtualPath, Z as createFilesApiClient, Q as createUploadFileWithProgress, C as deriveActionProfile, T as dialCorePathToRelative, oe as dialFileToAttachment, se as dialFilesToAttachments, ce as dialFolderPathToAttachment, U as fetchByTab, W as fetchForSearch, E as findDialFileByPath, G as findFirstSuccessfulCopyMoveItem, D as findFolderByVirtualPath, O as formatOperationFolderName, L as getParentFolderPath, ee as getUrlFileName, k as getVirtualPathName, A as hasDialFileWritePermission, j as hasForbiddenNameSymbols, M as isCopyMoveDuplicateAllowed, r as isDialFileAcceptType, e as isDialFileId, te as isExternalSourcePreviewable, N as isShareActionsAllowed, K as mapCorePermissions, q as mapFileMetadataToDialFile, J as mapSearchItem, Y as mergeCreatedFolderIntoCache, i as mimeTypesToAttachmentExtensionLabels, a as mimeTypesToDialFileAcceptTypes, o as mimeTypesToFileAccept, P as normalizeVirtualPath, $ as openAnnotationAttachment, F as parseNewFolderVirtualPath, B as prepareCopyItems, ue as prepareDownloadDestination, V as prepareMoveRenameItems, R as resolveDialFileApiPath, t as resolveDialFileBucketAndPath, ne as resolveExternalSourceContentType, I as resolveOwnerCoords, n as resolveRelativeDialFilePath, s as sanitizeFileName, c as splitFileNameExtension, l as trimFileNameToByteLimit, X as updateEntry, de as useDialFileListing, ge as useDialFileManager, _e as useDialFileManagerTabConfig, fe as useDialFileMetadata, pe as useDialFileMutations, me as useDialFileSharing, he as useDialFileUploadBatch, ve as useFileAttachmentPicker, ye as useGridEditingScroll, z as virtualPathToApiPath };