@epam/ai-dial-chat-hooks 1.2.0-dev.3 → 1.2.0-dev.300

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,16 @@ 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 { getParentFolderPath } from '@epam/ai-dial-chat-shared';
-import type { InputHighlightData } from '@epam/pdf-highlighter-kit';
+import { FilterChipItem } from '@epam/ai-dial-ui-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 +46,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 +54,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 +62,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 +75,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[];
@@ -196,12 +122,19 @@ export declare const DATE_OPTIONS: Intl.DateTimeFormatOptions;
 
 export declare const deriveActionProfile: (variant: DialFileManagerVariant) => DialFileManagerActionProfile;
 
+/** Source tabs `useDialFileManagerSections` can merge into the All tab, in display order. */
+export declare const DIAL_FILE_MANAGER_SECTION_TABS: readonly DialFileManagerTabs[];
+
 /** Strip the "files/{bucket}/" prefix from a DIAL Core URL to get the path within the bucket. */
 export declare const dialCorePathToRelative: (dialCorePath: string, bucket: string) => string;
 
-export { DialFileManagerActionProfile }
-
-export { DialFileManagerVariant }
+/** One source tab rendered as a top-level folder of the All view. */
+export declare interface DialFileManagerSection {
+    /** Source tab backing this section — `MyFiles`, `Shared` or `Organization`. */
+    tab: DialFileManagerTabs;
+    /** Display name of the section's top-level folder; also the first segment of its virtual paths. An empty, slash-containing or repeated label is replaced by the tab id. */
+    rootLabel: string;
+}
 
 /**
  * Operation port every file-manager hook that performs network I/O accepts as
@@ -335,18 +268,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[];
@@ -429,7 +350,9 @@ export declare enum FileManagerNotificationReason {
     /** `onUploadArchive` extracted some entries successfully and some failed; `count`/`names`/`restCount` describe the failures. */
     UploadArchivePartiallyFailed = "uploadArchivePartiallyFailed",
     /** `onUploadArchive`'s `uploadArchive` request itself rejected. */
-    UploadArchiveRequestFailed = "uploadArchiveRequestFailed"
+    UploadArchiveRequestFailed = "uploadArchiveRequestFailed",
+    /** A copy/move targeted a destination in a different All-view section from its source items; no request was made. */
+    CrossSectionTransferUnsupported = "crossSectionTransferUnsupported"
 }
 
 /**
@@ -450,8 +373,6 @@ export declare type FileNameValidationError = {
 } | {
     reason: FileNameValidationErrorReason.DuplicateName;
     existingName: string;
-} | {
-    reason: FileNameValidationErrorReason.LeadingDot;
 };
 
 /**
@@ -464,8 +385,7 @@ export declare enum FileNameValidationErrorReason {
     ForbiddenSymbols = "forbiddenSymbols",
     ReservedName = "reservedName",
     TooLong = "tooLong",
-    DuplicateName = "duplicateName",
-    LeadingDot = "leadingDot"
+    DuplicateName = "duplicateName"
 }
 
 /**
@@ -482,7 +402,10 @@ export declare enum FileOperationKind {
     FileCopied = "fileCopied",
     FilesCopied = "filesCopied",
     FileMoved = "fileMoved",
-    FilesMoved = "filesMoved"
+    FilesMoved = "filesMoved",
+    /** A copy whose every item landed in its own source folder (Duplicate). */
+    FileDuplicated = "fileDuplicated",
+    FilesDuplicated = "filesDuplicated"
 }
 
 /**
@@ -497,13 +420,15 @@ export declare interface FileOperationSuccessEvent {
     name?: string;
     /** Number of items the operation covered, when applicable. */
     count?: number;
-    /** Destination folder name, for copy/move operations. */
+    /**
+     * Destination folder as a slash-joined virtual path starting at the root
+     * label (e.g. `My files/reports`), for copy/move/duplicate operations.
+     */
     destinationFolderName?: string;
     /**
-     * Whether the affected item is a folder rather than a file. Only set for
-     * `fileRenamed`, since it is the only kind whose current wording depends
-     * on the item's node type (a rename toast reads "Folder renamed" vs.
-     * "File renamed").
+     * Whether the affected item is a folder rather than a file. Set for rename,
+     * copy, move, and duplicate events; on a multi-item event it describes the
+     * first successfully affected item (the one `name` refers to).
      */
     isFolder?: boolean;
 }
@@ -538,8 +463,6 @@ export declare interface FilesApiClient {
     listSharedByMe: (bucket: string) => Promise<ListFilesResponseDto>;
 }
 
-export { FileUploadValidationResult }
-
 export declare const findDialFileByPath: (nodes: DialFile[], targetPath: string) => DialFile | undefined;
 
 export declare const findFirstSuccessfulCopyMoveItem: <TDto extends {
@@ -556,8 +479,6 @@ export declare const findFolderByVirtualPath: (nodes: DialFile[], virtualPath: s
 
 export declare const formatOperationFolderName: (destinationFolder: string, rootLabel: string) => string;
 
-export { getParentFolderPath }
-
 /**
  * Returns the last path segment of `url` — its file name — for both absolute
  * URLs and DIAL-relative resource paths such as
@@ -570,35 +491,12 @@ 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;
-}
+/** Returns `true` when both sets contain exactly the same paths. */
+export declare const hasSamePaths: (a: ReadonlySet<string>, b: ReadonlySet<string>) => boolean;
 
 /** Copy/Move/Duplicate are Browse/Full-only — the attach picker excludes them. */
 export declare const isCopyMoveDuplicateAllowed: (actionProfile: DialFileManagerActionProfile) => boolean;
@@ -615,14 +513,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 +526,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 +550,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 +565,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>[];
 
@@ -812,7 +581,7 @@ export declare interface PreparedCopyMoveItem<TDto> {
 export declare const prepareDownloadDestination: (filename: string, mimeType?: string) => Promise<DownloadDestination>;
 
 /**
- * Rename-vs-move disambiguation (design.md D3): entries whose parent folder
+ * Rename-vs-move disambiguation (`openspec/changes/archive/2026-07-21-split-use-dial-file-manager/design.md` D3): entries whose parent folder
  * is unchanged become `renameDtos`; entries whose parent folder changed
  * become `preparedMoveItems`.
  */
@@ -821,21 +590,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 +627,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,29 +637,14 @@ 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>;
+/** Returns the section whose root label is the first segment of `virtualPath`, or `undefined` when none matches. */
+export declare const resolveSectionByPath: <TSection extends DialFileManagerSection>(virtualPath: string, sections: readonly TSection[]) => TSection | undefined;
 
 /**
  * Sanitizes a filename for upload by replacing forbidden characters with `_`,
@@ -961,7 +674,10 @@ export declare const splitFileNameExtension: (fileName: string) => {
 
 export declare const trimFileNameToByteLimit: (name: string, limit?: number) => string;
 
-export declare const updateEntry: (prev: FileUploadBatchState | null, index: number, patch: FileUploadStatus | Partial<Pick<FileUploadEntry, "status" | "percent">>) => FileUploadBatchState | null;
+/** Returns a new set containing every path from each of `pathSets`. */
+export declare const unionPathSets: (pathSets: readonly ReadonlySet<string>[]) => Set<string>;
+
+export declare const updateEntry: (prev: FileUploadBatchState | null, id: string, patch: FileUploadStatus | Partial<Pick<FileUploadEntry, "status" | "percent">>) => FileUploadBatchState | null;
 
 /** Max number of files uploaded concurrently within a single upload batch. */
 export declare const UPLOAD_CONCURRENCY = 3;
@@ -990,14 +706,14 @@ export declare type UploadMode = 'overwrite' | 'create-only';
  * tree's expand/collapse state, search, and the shared per-folder cache that
  * `useDialFileUploadBatch`/`useDialFileMutations`/`useDialFileSharing` invalidate
  * through `invalidateFolders`/`bumpRetry` after their own mutations settle
- * (design.md D1) — this hook is the sole owner/writer of that cache.
+ * (`openspec/changes/archive/2026-07-21-split-use-dial-file-manager/design.md` D1) — this hook is the sole owner/writer of that cache.
  *
  * Supports three listing sources via `activeTab`:
  * - my_files: user's own bucket via `DialFilesApi.listFiles`
  * - shared: files shared with the user via `DialFilesApi.listSharedFiles`
  * - organization: public bucket via `DialFilesApi.listPublicFiles`
  */
-export declare const useDialFileListing: ({ filesApi, bucket, rootLabel, activeTab, onNotification, }: UseDialFileListingOptions) => UseDialFileListingResult;
+export declare const useDialFileListing: ({ filesApi, bucket, rootLabel, activeTab, onNotification, isActive, sessionKey, }: UseDialFileListingOptions) => UseDialFileListingResult;
 
 /** Options accepted by `useDialFileListing`. */
 export declare interface UseDialFileListingOptions {
@@ -1011,6 +727,10 @@ export declare interface UseDialFileListingOptions {
     activeTab: DialFileManagerTabs;
     /** Called with a structured event when a folder-load operation fails. */
     onNotification?: (notification: FileManagerNotification) => void;
+    /** When false, the hook issues no `DialFilesApi` call and reports `isLoading: false`. Defaults to `true`. */
+    isActive?: boolean;
+    /** Changing this value resets cache and navigation exactly like an `activeTab` change. Defaults to `undefined`. */
+    sessionKey?: string;
 }
 
 /** Values returned by `useDialFileListing`. */
@@ -1046,7 +766,7 @@ export declare interface UseDialFileListingResult {
     /**
      * Deletes the given API-path cache keys so the next listing fetch/expand for
      * that folder re-fetches from the server. The only way sibling sub-hooks may
-     * invalidate the shared cache (design.md D1).
+     * invalidate the shared cache (`openspec/changes/archive/2026-07-21-split-use-dial-file-manager/design.md` D1).
      */
     invalidateFolders: (apiPaths: string[]) => void;
     /** Merges a just-created folder into its parent's cache entry (optimistic display for create-folder). */
@@ -1067,7 +787,7 @@ export declare interface UseDialFileListingResult {
  * every translated string reaches it through `labels`,
  * `disabledNewButtonTooltip`, and `buildValidationErrorMessage`.
  */
-export declare const useDialFileManager: ({ filesApi, bucket, rootLabel, activeTab, onNotification, onOperationSuccess, forbiddenSymbolsRegExp, variant, actionProfile, labels, locale, disabledNewButtonTooltip, downloadDestination, buildValidationErrorMessage, }: UseDialFileManagerOptions) => UseDialFileManagerResult;
+export declare const useDialFileManager: ({ filesApi, bucket, rootLabel, activeTab, isActive, sessionKey, onNotification, onOperationSuccess, forbiddenSymbolsRegExp, variant, actionProfile, labels, locale, disabledNewButtonTooltip, downloadDestination, buildValidationErrorMessage, }: UseDialFileManagerOptions) => UseDialFileManagerResult;
 
 export declare interface UseDialFileManagerOptions {
     /** Injected operation port used for every file-manager network call. */
@@ -1078,6 +798,10 @@ export declare interface UseDialFileManagerOptions {
     rootLabel?: string;
     /** Active tab — drives listing source and per-tab options. Defaults to MyFiles. */
     activeTab?: DialFileManagerTabs;
+    /** When false, the listing issues no `DialFilesApi` call and reports `isLoading: false`. Defaults to `true`. */
+    isActive?: boolean;
+    /** Changing this value resets cache and navigation exactly like an `activeTab` change. Defaults to `undefined`. */
+    sessionKey?: string;
     /** Called when a file-manager action should surface a toast notification. */
     onNotification?: (notification: FileManagerNotification) => void;
     /** Called when a mutation succeeds, instead of invoking an application notification service directly. */
@@ -1132,7 +856,7 @@ export declare interface UseDialFileManagerResult {
     onSearchFiles: (folder: string, query: string) => void;
     /** Search: true while a search request is in flight. */
     isSearching: boolean;
-    /** Search: flat list of matching files, or null when search is not active. */
+    /** Search: flat, unfiltered recursive listing of the current folder, or null when search is not active. */
     searchResults: DialFile[] | null;
     /** Search: clears results and exits search mode. */
     clearSearchResults: () => void;
@@ -1156,7 +880,9 @@ export declare interface UseDialFileManagerResult {
     uploadBatchState: FileUploadBatchState | null;
     /** Upload: abort all in-flight and queued uploads. */
     cancelUpload: () => void;
-    /** Upload: dismiss the progress modal after the batch has settled. */
+    /** Upload: abort one queued or in-flight upload by its entry id. */
+    cancelUploadFile: (id: string) => void;
+    /** Upload: empty the upload queue. */
     clearUploadBatch: () => void;
     /** Folder creation: called when user confirms a new folder name. */
     onCreateFolder: (file: DialUploadFileItem, folderPath: string, fileId: string) => Promise<void>;
@@ -1223,7 +949,7 @@ export declare interface UseDialFileManagerResult {
     /**
      * True while any mutating file-manager operation is in flight: the OR of
      * `isCreatingFolder`, `isDownloading`, `isDeleting`, `isRenaming`, `isCopying`,
-     * `isMoving`, `isUnsharing`, `isRemovingAccess`, and `uploadBatchState != null`.
+     * `isMoving`, `isUnsharing`, `isRemovingAccess`, and any upload still queued or running.
      *
      * Deliberately excludes three flags, each already fully contained by its own
      * scoped loading UI:
@@ -1234,17 +960,42 @@ export declare interface UseDialFileManagerResult {
     isAnyOperationInProgress: boolean;
 }
 
+/**
+ * Composes one `useDialFileManager` per source tab (My files, Shared,
+ * Organization) so the File storage page can offer an All tab without a
+ * second copy of the per-tab rules. On a single tab it returns that section's
+ * result; on All it merges the section roots into one tree and routes every
+ * callback to the section owning the path. Section availability and names
+ * arrive through `sections` — the hook reads no config, i18n, or context.
+ */
+export declare const useDialFileManagerSections: ({ activeTab, sections, ...managerOptions }: UseDialFileManagerSectionsOptions) => UseDialFileManagerSectionsResult;
+
+/** Options accepted by `useDialFileManagerSections`. */
+export declare interface UseDialFileManagerSectionsOptions extends Omit<UseDialFileManagerOptions, 'activeTab' | 'rootLabel' | 'isActive' | 'sessionKey'> {
+    /** Active tab, including `DialFileManagerTabs.All`. */
+    activeTab: DialFileManagerTabs;
+    /** Enabled source tabs in display order, each with its translated top-level folder name. */
+    sections: DialFileManagerSection[];
+}
+
+/** Values returned by `useDialFileManagerSections`. */
+export declare interface UseDialFileManagerSectionsResult extends UseDialFileManagerResult {
+    /** Source tab of the browsed folder; never `DialFileManagerTabs.All`. */
+    sectionTab: DialFileManagerTabs;
+}
+
 /**
  * Filters the file-manager's tab list down to the host's configured set and
  * resets `activeTab` to the highest-priority still-enabled tab when the
  * current one becomes excluded. A `fileManagerTabs` of `undefined` means no
  * restriction — every tab in `allTabs` stays enabled and no reset ever fires.
+ * The All tab is kept only while at least two source tabs are enabled.
  */
-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'];
 }
 
 /**
@@ -1369,10 +1120,11 @@ export declare interface UseDialFileSharingResult {
 
 /**
  * Manages upload batches (single-file and ZIP-archive extraction), including
- * concurrency-limited progress tracking and abort. Invalidates the shared
- * listing cache for the destination folder through `invalidateFolders`/
- * `bumpRetry` after a batch settles — it never holds its own copy of the
- * cache.
+ * concurrency-limited progress tracking and per-file abort. A batch started
+ * while another is on screen is appended to it, and settled entries stay in
+ * `uploadBatchState` until `clearUploadBatch`. Invalidates the shared listing
+ * cache for the destination folder through `invalidateFolders`/`bumpRetry`
+ * after a batch settles — it never holds its own copy of the cache.
  */
 export declare const useDialFileUploadBatch: ({ filesApi, bucket, rootLabel, activeTab, cache, sharedRootMetaRef, invalidateFolders, bumpRetry, onNotification, }: UseDialFileUploadBatchOptions) => UseDialFileUploadBatchResult;
 
@@ -1405,9 +1157,68 @@ export declare interface UseDialFileUploadBatchResult {
     onValidateUpload: (files: DialUploadFileItem[], existingFiles: DialFile[], destinationFolder: string) => Promise<FileUploadValidationResult>;
     uploadBatchState: FileUploadBatchState | null;
     cancelUpload: () => void;
+    cancelUploadFile: (id: string) => void;
     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 +1231,7 @@ 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;
-}
+/** Returns `sections` with every root label usable as a unique first path segment, falling back to the tab id. */
+export declare const withRoutableRootLabels: <TSection extends DialFileManagerSection>(sections: readonly TSection[]) => TSection[];
 
 export { }