@epam/ai-dial-chat-shared 1.2.0-dev.21 → 1.2.0-dev.217

package/index.d.ts

@@ -20,6 +20,7 @@ import { IRowNode } from 'ag-grid-community';
 import { Options } from 'react-markdown';
 import { ReactNode } from 'react';
 import { RefObject } from 'react';
+import { TransferQueueLabels } from '@epam/ai-dial-ui-kit';
 
 /** A single annotation attached to an assistant message, optionally citing a source document. */
 export declare interface Annotation {
@@ -70,6 +71,57 @@ export declare interface AnnotationTarget {
     selector?: AnnotationSelector;
 }
 
+/**
+ * A single application → grouped visualizer mapping from the
+ * `APPLICATION_VISUALIZERS` registry. Field semantics are fixed by
+ * already-deployed visualizer applications and operator configurations
+ * carried over from legacy Chat 0.x, which is why `contentType` is optional
+ * here while `CustomVisualizer.contentType` is required.
+ */
+export declare interface ApplicationVisualizer {
+    /**
+     * The postMessage protocol namespace, NOT a display label. Every message
+     * exchanged with the iframe is prefixed `${title}/…`, and the iframe-side
+     * visualizer application must be constructed with this identical string
+     * as its `appName`. A mismatch is a silent failure — the iframe loads but
+     * never receives data. Also used as the inline frame's header text.
+     */
+    title: string;
+    /** Human-readable description of the visualizer. Accepted for operator-configuration parity; not consumed by host logic. */
+    description?: string;
+    /** Icon URL or identifier for the visualizer. Accepted for operator-configuration parity; not consumed by host logic. */
+    icon?: string;
+    /**
+     * Comma-separated list of MIME types this entry claims (e.g.
+     * `'application/vnd.plotly.v1+json'` or
+     * `'application/vnd.plotly.v1+json, application/vnd.vega.v5+json'`).
+     * Stored verbatim; splitting happens at lookup time. When omitted, the
+     * entry claims every attachment that carries a URL.
+     */
+    contentType?: string;
+    /** Absolute HTTP(S) URL of the visualizer iframe. */
+    url: string;
+    /** Milliseconds to wait for a `send()` request's `/RESPONSE` before rejecting. Defaults to `10000`. Does NOT bound the initial handshake. */
+    requestTimeout?: number;
+    /** Suggested initial width of the visualizer surface in pixels. Forwarded as-is in `CustomVisualizerDataLayout`. */
+    width?: number;
+    /** Suggested initial height of the visualizer surface in pixels. Forwarded as-is in `CustomVisualizerDataLayout`, and used by the host to size the inline frame. */
+    height?: number;
+    /** Suggested height on mobile viewports in pixels. Forwarded as-is in `CustomVisualizerDataLayout`, and used by the host to size the inline frame on mobile. */
+    mobileHeight?: number;
+    /** Whether the host should pass auth info to the visualizer. Accepted for operator-configuration parity; inert, because 1.0 auth is server-side and the browser holds no access token. */
+    passAuthInfo?: boolean;
+    /** Whether the host should pass an explicit access token. Accepted for operator-configuration parity; inert, because 1.0 auth is server-side and the browser holds no access token. */
+    passExplicitToken?: boolean;
+    /** When `true`, the host renders the inline frame without its border, rounded corners, background, and header divider. */
+    borderless?: boolean;
+    /** When `true`, the host hides the inline frame's header title text; the header actions stay visible. */
+    withoutTitle?: boolean;
+}
+
+/** The `APPLICATION_VISUALIZERS` registry: application id → grouped visualizer entry. */
+export declare type ApplicationVisualizerRegistry = Record<string, ApplicationVisualizer>;
+
 /** Attachment selected locally by the user before it is sent to the backend. */
 export declare interface Attachment extends DisplayAttachment {
     /** The underlying browser `File` object selected by the user. */
@@ -93,7 +145,9 @@ export declare enum AttachmentErrorReason {
     /** Upload failed because the device was offline. */
     Network = "network",
     /** File MIME type is not in the deployment's inputAttachmentTypes list. */
-    UnsupportedType = "unsupported-type"
+    UnsupportedType = "unsupported-type",
+    /** File size exceeds the configured maximum attachment size. */
+    FileTooLarge = "file-too-large"
 }
 
 /** A file attachment referenced by a citation — same shape as `MessageAttachment` but scoped to annotations. */
@@ -174,6 +228,19 @@ export declare enum CatalogEntityType {
     Prompt = "PROMPT"
 }
 
+export declare const CHAT_SHARED_CLASS: {
+    /** The bordered container of a fenced code block. */
+    readonly codeBlock: "dial-chat-shared-code-block";
+    /** The code block's sticky header, holding the language label and actions. */
+    readonly codeBlockHeader: "dial-chat-shared-code-block-header";
+    /** The bordered container of a Markdown table. */
+    readonly table: "dial-chat-shared-table";
+    /** The scrolling box around a Markdown table, which owns its overflow. */
+    readonly tableScroll: "dial-chat-shared-table-scroll";
+    /** The scrolling box around a display-math block. */
+    readonly mathBlock: "dial-chat-shared-math-block";
+};
+
 /** Color theme for syntax highlighting. */
 export declare enum CodeBlockTheme {
     /** Dark syntax-highlighting theme. */
@@ -222,6 +289,8 @@ export declare interface Conversation {
     assistantModelId: string;
     /** Response format used when rendering messages. */
     responseFormat?: ResponseFormat;
+    /** Open, feature-keyed container for conversation-level view state. This change owns only the `annotations` key; any other key is opaque and preserved as-is. */
+    customViewState?: Record<string, unknown>;
 }
 
 /** Metadata returned by the DIAL file/conversation listing API for a single resource node. */
@@ -276,6 +345,8 @@ export declare interface ConversationTransferJob {
      * {@link ConversationTransferJobStatus.Warning}.
      */
     warningCode?: ConversationTransferWarningCode;
+    /** Untranslated names of skipped attachments, when available for this warning. */
+    warningNames?: string[];
 }
 
 /** Lifecycle status of a queued export/import job. */
@@ -611,7 +682,7 @@ export declare interface DialFileManagerShellLabels {
     showHiddenFilesLabel: string;
     /** Label shown when hidden files are currently hidden. */
     hideHiddenFilesLabel: string;
-    /** Returns a bulk-selection count label (e.g. "3 selected"). */
+    /** 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;
@@ -671,12 +742,10 @@ export declare interface DialFileManagerShellLabels {
     deleteConfirmLabel: string;
     /** Cancel-button label in the delete confirmation dialog. */
     deleteCancelLabel: string;
-    /** Title for the upload progress modal. */
-    uploadProgressTitle: string;
-    /** Cancel-button label in the upload progress modal. */
-    cancelLabel: string;
-    /** Returns upload progress text (e.g. "3 of 5 uploaded"). */
-    getUploadProgressText: (done: number, total: number) => 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. */
@@ -687,6 +756,8 @@ export declare interface DialFileManagerShellLabels {
     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. */
@@ -811,6 +882,15 @@ export declare interface EmptyStateCopy {
  */
 export declare const ensureDownloadFilename: (name: string, url: string | undefined, contentType: string | undefined) => string;
 
+/** Maximum length of an entity's description. */
+export declare const ENTITY_DESCRIPTION_MAX_LENGTH = 2000;
+
+/** Maximum length of an entity's instructions (prompt body, system prompt, skill instructions). */
+export declare const ENTITY_INSTRUCTIONS_MAX_LENGTH = 50000;
+
+/** Maximum length of an entity's name or display name. */
+export declare const ENTITY_NAME_MAX_LENGTH = 256;
+
 /** Background color per entity type — used for the featured chip surface. */
 export declare const ENTITY_TYPE_BG_COLOR: Record<CatalogEntityType, string>;
 
@@ -881,6 +961,9 @@ export declare interface EntityTypeLabelProps {
     className?: string;
 }
 
+/** Whether `value` is longer than `maxLength` characters. */
+export declare const exceedsMaxLength: (value: string, maxLength: number) => boolean;
+
 /** A 1-based cell address on an XLSX sheet. */
 export declare interface ExcelCellAddress {
     /** 1-based row number. */
@@ -1005,7 +1088,7 @@ export declare interface FileManagerController {
     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;
@@ -1029,7 +1112,9 @@ export declare interface FileManagerController {
     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>;
@@ -1091,6 +1176,8 @@ export declare interface FileManagerController {
     onGetInfo: (file: DialFile) => void;
     /** Metadata: resets fileMetadata/isFileMetadataLoading; passed to fileMetadataPopupOptions.clearMetadata. */
     clearMetadata: () => void;
+    /** Source tab of the browsed folder, never `All`; omitted by single-source controllers. */
+    sectionTab?: DialFileManagerTabs;
 }
 
 /**
@@ -1109,11 +1196,11 @@ export declare interface FileManagerSelectableNode {
     contentLength?: number;
 }
 
-/** State of an in-progress or just-settled upload batch, as returned by `useDialFileUploadBatch`. */
+/** State of the upload queue, as returned by `useDialFileUploadBatch`. */
 export declare interface FileUploadBatchState {
-    /** Individual file entries in this batch. */
+    /** Every file uploaded since the queue was last cleared, settled ones included. */
     files: FileUploadEntry[];
-    /** Whether the upload progress modal should be visible. */
+    /** Whether the upload queue should be visible. */
     isOpen: boolean;
 }
 
@@ -1176,6 +1263,9 @@ export declare const generateUUID: () => string;
 /** Classifies a MIME type into an `AttachmentType` by prefix (`image/*` / `audio/*`), defaulting to `File`. */
 export declare const getAttachmentTypeFromMime: (mimeType: string | undefined) => AttachmentType;
 
+/** Lowercases a MIME type and strips its parameters, e.g. `'Application/JSON; charset=utf-8'` -> `'application/json'`. */
+export declare const getBaseMimeType: (mimeType: string) => string;
+
 /** Returns the file extension (without a leading dot) for a fenced-code-block language identifier, defaulting to `txt`. */
 export declare const getFileExtensionForLanguage: (language: string) => string;
 
@@ -1192,6 +1282,27 @@ export declare const getParentFolderPath: (path: string) => string;
 /** Returns the UTF-8 byte length of `str`. */
 export declare const getUtf8ByteLength: (str: string) => number;
 
+/** A single attachment handed to a grouped visualizer inside `SEND_GROUPED_VISUALIZE_DATA`. */
+export declare interface GroupedAttachmentItem {
+    /** Absolute URL of the attachment, resolved by the host before sending. */
+    url: string;
+    /** The attachment's own MIME type. */
+    mimeType: string;
+    /** Presentation layout plus the opaque per-attachment payload. */
+    visualizerData: CustomVisualizerData;
+}
+
+/** Payload of a `SEND_GROUPED_VISUALIZE_DATA` request: every claimed attachment plus the shared presentation layout. */
+export declare interface GroupedAttachmentsData {
+    /** One item per claimed attachment, in the message's attachment order. */
+    attachments: GroupedAttachmentItem[];
+    /** Presentation layout hints shared by every item. */
+    layout: CustomVisualizerDataLayout;
+}
+
+/** Whether `value` contains a control character (line break, tab, NUL, …) that a single-line name must not carry. */
+export declare const hasControlCharacters: (value: string) => boolean;
+
 /** Minimal hast shapes this plugin reads and writes. */
 declare interface HastNode {
     type: string;
@@ -1245,9 +1356,15 @@ export declare const isAudioTranscriptionSupported: (types?: string[]) => boolea
 /** Returns true when any path segment starts with a dot (hidden file or folder). */
 export declare const isHiddenPath: (path: string) => boolean;
 
+/** Whether a selected skill lacks explicitly confirmed support. */
+export declare const isSkillSelectionUnsupported: (skillUrl: string | null | undefined, isSkillsSupported: boolean | undefined) => boolean;
+
 /** Returns `true` when `msg` is a `StatusMessage`. */
 export declare const isStatusMessage: (msg: Message | StatusMessage) => msg is StatusMessage;
 
+/** Returns whether any file in the batch is still queued or uploading. */
+export declare const isUploadInProgress: (batchState: FileUploadBatchState | null) => boolean;
+
 /** Item title header with optional numeric or string postfix and trailing slot. */
 export declare const ItemHeader: FC<ItemHeaderProps>;
 
@@ -1285,7 +1402,29 @@ export declare interface ItemHeaderProps {
     shouldTruncateTitle?: boolean;
 }
 
-export declare const MARKDOWN_EDITOR_MAX_HEIGHT_CLASS_NAME = "[&_.w-md-editor]:max-h-[var(--resizable-field-max-height,70vh)]";
+/** A selectable language option for an additional-locale row. */
+export declare interface LocaleOption {
+    /** Locale code (e.g. `'de'`). */
+    code: string;
+    /** Display label for the option (e.g. `'DE'`). */
+    label: string;
+}
+
+/** One additional (non-primary) locale's translation of an entity's name and description. */
+export declare interface LocalizedTextEntry {
+    /** Stable client-side id for list rendering; not part of the persisted locale map. */
+    id: string;
+    /** Locale code this entry translates into (e.g. `'de'`). */
+    language: string;
+    /** Translated name for this locale. */
+    name: string;
+    /** Translated description for this locale. */
+    description: string;
+}
+
+export declare const MARKDOWN_EDITOR_FILL_HEIGHT_CLASS_NAME = "[&_.w-md-editor:not(.w-md-editor-fullscreen)]:!h-[var(--resizable-field-max-height,70vh)] [&_.w-md-editor-bar]:hidden";
+
+export declare const MARKDOWN_EDITOR_MAX_HEIGHT_CLASS_NAME = "[&_.w-md-editor:not(.w-md-editor-fullscreen)]:max-h-[var(--resizable-field-max-height,70vh)]";
 
 export declare const MARKDOWN_EDITOR_PREVIEW_LIST_CLASS_NAME = "[&_.wmde-markdown>ol]:list-decimal [&_.wmde-markdown_ul]:list-disc [&_.wmde-markdown_ul_ul]:list-[circle] [&_.wmde-markdown_ul_ul_ul]:list-[square]";
 
@@ -1487,9 +1626,7 @@ export declare interface MarkdownRendererProps {
 export declare const MarkdownTable: FC<MarkdownTableProps>;
 
 export declare interface MarkdownTableActionLabels {
-    copyCsvLabel?: string;
-    copyTxtLabel?: string;
-    copyMarkdownLabel?: string;
+    copyLabel?: string;
     copiedLabel?: string;
     downloadCsvLabel?: string;
     openInCanvasLabel?: string;
@@ -1515,19 +1652,16 @@ export declare interface MarkdownTableColors {
     fade?: string;
     /** Divider color between rows. Defaults to `--stroke-tertiary`. */
     rowDivider?: string;
-    /** Background of even-indexed body rows. Defaults to `--bg-layer-base`. */
-    rowZebraBackground?: string;
     /** Background of a body row on hover. Defaults to `--bg-control-accent-alpha-hover`. */
     rowHoverBackground?: string;
 }
 
 export declare enum MarkdownTableCopyFormat {
     Csv = "csv",
-    Txt = "txt",
     Markdown = "markdown"
 }
 
-/** A table header action rendered as an icon button. */
+/** A table action rendered as an icon button. */
 export declare interface MarkdownTableHeaderAction {
     /** Stable accessible name and tooltip text. */
     label: string;
@@ -1578,13 +1712,20 @@ export declare interface MarkdownWithPlaceholdersProps {
     headingClassName?: string;
 }
 
-/** Renders assistant message content as formatted markdown. */
+/** Renders assistant message content as formatted markdown, or as escaped plain text when `isPlainText` is set. */
 export declare const MDMessageViewer: FC<MDMessageViewerProps>;
 
 /** Props for the {@link MDMessageViewer} markdown renderer. */
 declare interface MDMessageViewerProps {
     /** Raw markdown string to render. */
     content: string;
+    /**
+     * Renders `content` verbatim as escaped plain text instead of running the
+     * Markdown pipeline — the conversation's `plain_text` response format.
+     * Markdown-only props (`components`, `urlTransform`, the code-block and
+     * table labels) do not apply while it is set. Defaults to `false`.
+     */
+    isPlainText?: boolean;
     /** Enables gradual reveal for appended streaming content. */
     isStreaming?: boolean;
     /**
@@ -1753,6 +1894,21 @@ export declare interface MessageState {
     tool_execution_history?: ToolExecutionHistoryMessage[];
 }
 
+/**
+ * Maps non-canonical MIME type spellings to the canonical type they denote.
+ *
+ * Deployments declare their `inputAttachmentTypes` by hand, while DIAL Core
+ * stores the content type a browser or an upload client reported, so the two
+ * sides routinely disagree on which of several equivalent spellings to use for
+ * the same format (`text/json` vs `application/json`). Resolving both through
+ * this map before comparing them keeps a declared type matching the files it
+ * is meant to describe.
+ *
+ * Only aliases for one and the same format belong here — never a pair of
+ * distinct formats that happen to share an extension.
+ */
+export declare const MIME_TYPE_ALIASES: Record<string, string>;
+
 /** MIME type prefix shared by all audio content types. */
 export declare const MIME_TYPE_AUDIO_PREFIX = "audio/";
 
@@ -1822,6 +1978,14 @@ export declare const MOBILE_MAX_WIDTH_PX: number;
 /** `matchMedia` query matching the mobile/tablet band (up to 1279px). */
 export declare const MOBILE_MEDIA_QUERY = "(max-width: 1279px)";
 
+/**
+ * Returns the canonical spelling of a MIME type: parameters stripped, lowercased,
+ * and known aliases resolved through `MIME_TYPE_ALIASES` (`'text/json'` ->
+ * `'application/json'`). Wildcards and unrecognized types are returned unchanged
+ * apart from that normalization.
+ */
+export declare const normalizeMimeType: (mimeType: string) => string;
+
 /**
  * Repairs persisted `html_tag` annotations created by older normalizers that
  * defaulted every non-HTML source to PDF. An explicit, recognized file
@@ -1917,6 +2081,44 @@ export declare interface PdfBBoxSelector {
 /** Returns a deterministic colour-pair for the given display name. */
 export declare const pickAvatarColor: (name: string) => AvatarColorEntry;
 
+/**
+ * Renders message text as plain text: no Markdown pipeline, no raw HTML, no
+ * syntax highlighting. The text is a React text child, so it is escaped by
+ * construction — a table, a heading, or `**bold**` reaches the reader exactly
+ * as the model emitted it, which is what a conversation's `plain_text`
+ * response format promises.
+ *
+ * Lives beside {@link MarkdownRenderer} because it is the other half of the
+ * same choice: both render an assistant message body, and both are selected
+ * by `MDMessageViewer` from the conversation's response format.
+ */
+export declare const PlainTextRenderer: FC<PlainTextRendererProps>;
+
+/** Props for {@link PlainTextRenderer}. */
+export declare interface PlainTextRendererProps {
+    /** Message text. Rendered verbatim — never parsed as Markdown or HTML. */
+    content: string;
+    /** Classes applied to the renderer root. */
+    containerClassName?: string;
+    /** When true, appended content is revealed gradually for smoother streaming updates. */
+    isStreaming?: boolean;
+    /** Reveal speed used while `isStreaming` is true. Defaults to 120 characters per second. */
+    streamCharactersPerSecond?: number;
+    /**
+     * Typography classes. Only `p` is read — the single paragraph the renderer
+     * emits — so the same object a Markdown message is styled with keeps both
+     * formats on one type scale.
+     */
+    classNames?: Pick<MarkdownRendererClassNames, 'p'>;
+    /**
+     * Label shown with a shimmer animation while `isStreaming` is true and no
+     * content has arrived yet. Defaults to `'Thinking'`.
+     */
+    thinkingLabel?: string;
+    /** Color overrides applied as CSS custom properties. */
+    colors?: Pick<MarkdownRendererColors, 'thinkingPrimary' | 'thinkingSecondary'>;
+}
+
 /**
  * Selector that targets a character range inside a single shape on one PPTX
  * slide. Confirmed against captured DIAL Core responses: unlike
@@ -1980,6 +2182,9 @@ export declare interface ProviderInfo {
     label: string;
 }
 
+/** DIAL Core bucket that holds published (organization-wide) resources, readable by every user. */
+export declare const PUBLIC_BUCKET = "public";
+
 /**
  * Rehype plugin that wraps every `{{name}}` placeholder in a span so it can be
  * styled apart from the surrounding prose. Placeholders inside code are left
@@ -2265,6 +2470,84 @@ export declare interface TextCharacterRangeSelector {
     end: number;
 }
 
+/** Asynchronous rewriting callback supplied by the consuming host. */
+export declare type TextRefinementCallback = (value: string, signal: AbortSignal) => Promise<string>;
+
+/** Label row with Refine/Undo actions and live feedback around one refinable field. */
+export declare const TextRefinementField: FC<TextRefinementFieldProps>;
+
+/** Props for `TextRefinementField`. */
+export declare interface TextRefinementFieldProps {
+    /** When false, renders `children` alone — no label row, actions, or feedback. */
+    isEnabled: boolean;
+    /** Id of the labelled control; also the prefix for the label and error ids. */
+    fieldId: string;
+    /** Visible field label; names the group. */
+    label: string;
+    /** Class applied to the `<label>`, after the kit `Label` defaults. */
+    labelClassName?: string;
+    /** Marks the label as required. */
+    required?: boolean;
+    /** Action, status, and error copy. */
+    labels?: TextRefinementLabels;
+    /** The field's `useTextRefinement` result. */
+    refinement: TextRefinementResult;
+    /** Disables both actions. */
+    disabled: boolean;
+    /** Class applied to the status message and the error message. */
+    feedbackClassName?: string;
+    /** Class applied to the error message, after `feedbackClassName`. */
+    errorClassName?: string;
+    /** The refinable control, whose id must equal `fieldId`. */
+    children: ReactNode;
+}
+
+/** Translatable copy for `TextRefinementField`; every key has an English default. */
+export declare interface TextRefinementLabels {
+    /** Refinement copy. Defaults to 'Refine with AI'. */
+    refineWithAiLabel?: string;
+    /** Refinement copy. Defaults to 'Undo'. */
+    refineUndoLabel?: string;
+    /** Refinement copy. Defaults to 'Could not refine this text. Please try again.'. */
+    refineErrorLabel?: string;
+    /** Refinement copy. Defaults to 'Refining text'. */
+    refinePendingAriaLabel?: string;
+    /** Refinement copy. Defaults to 'Text refined. Undo is available.'. */
+    refineSuccessAriaLabel?: string;
+    /** Refinement copy. Defaults to 'Original text restored.'. */
+    refineUndoAriaLabel?: string;
+    /** Refinement copy. Defaults to 'No changes were needed.'. */
+    refineUnchangedAriaLabel?: string;
+}
+
+/** Controls and feedback for a single field. */
+export declare interface TextRefinementResult {
+    /** Current field-local feedback state. */
+    state: TextRefinementState;
+    /** Whether this field has a request in progress. */
+    isPending: boolean;
+    /** Whether the current value can be refined. */
+    canRefine: boolean;
+    /** Whether an original baseline can be restored. */
+    canUndo: boolean;
+    /** Refines the latest committed value; duplicate activation is ignored. */
+    refine: () => Promise<void>;
+    /** Restores the baseline from before the first successful refinement. */
+    undo: () => void;
+    /** Cancels work and clears feedback and Undo without modifying the value. */
+    reset: () => void;
+}
+
+/** Field-local refinement feedback state. */
+export declare enum TextRefinementState {
+    Idle = "idle",
+    Pending = "pending",
+    Success = "success",
+    Error = "error",
+    Restored = "restored",
+    Unchanged = "unchanged"
+}
+
 /** A single selectable UI theme. */
 export declare interface Theme {
     /** Unique theme identifier (e.g. `'dark'`, `'light'`). */
@@ -2371,23 +2654,6 @@ export declare interface UploadedAttachmentResult {
     name: string;
 }
 
-/** Modal showing per-file upload progress with a cancel action. */
-export declare const UploadProgressModal: FC<UploadProgressModalProps>;
-
-/** Props for the upload-progress modal. */
-export declare interface UploadProgressModalProps {
-    /** Current batch state with per-file entries and open flag. */
-    batchState: FileUploadBatchState;
-    /** Title shown in the modal header (e.g. "Uploading files"). */
-    uploadProgressTitle: string;
-    /** Summary text below the title (e.g. "3 of 5 uploaded"). */
-    uploadProgressText: string;
-    /** Label for the cancel button. */
-    cancelLabel: string;
-    /** Called when the user clicks Cancel. */
-    onCancel: () => void;
-}
-
 /**
  * Writes the height still available below an element into a CSS custom
  * property, so a user-resizable control inside it can be capped at the space
@@ -2502,4 +2768,21 @@ export declare interface UserProfile {
     isAdmin: boolean;
 }
 
+/** Preserves an author's draft and Undo baseline across asynchronous controlled updates. */
+export declare const useTextRefinement: (options: UseTextRefinementOptions) => TextRefinementResult;
+
+/** Controlled value and lifecycle inputs for one refinable field. */
+export declare interface UseTextRefinementOptions {
+    /** Current controlled field value. */
+    value: string;
+    /** Host rewriting callback. Omission disables refinement and clears its state. */
+    onRefine?: TextRefinementCallback;
+    /** Publishes a successful result or the original Undo baseline. */
+    onChange: (value: string) => void;
+    /** Disables refinement and cancels active work when true. Defaults to false. */
+    disabled?: boolean;
+    /** Draft identity; changing it resets state even when text is equal. */
+    resetKey?: unknown;
+}
+
 export { }