@epam/ai-dial-conversation-input 1.2.0-dev.3 → 1.2.0-dev.303

package/models/ConversationInput.d.ts

@@ -1,6 +1,7 @@
+import { AttachmentTrayStyles } from '@epam/ai-dial-attachment-input';
 import { Attachment, AttachmentErrorReason, DeploymentItem, DisplayAttachment, ToolMenuItem, UploadedAttachmentResult } from '@epam/ai-dial-chat-shared';
 import { ReactNode } from 'react';
-import { ChatSettingsConfig, CommandMenuConfig, InputColors, InputTypography, MenuOverlayConfig, ModelSelectorLabels, SendOnEnter, TextInsertion, ToolsChipLabels } from './Input';
+import { ActionRowLayout, ChatSettingsConfig, CommandMenuConfig, HighlightedTextRange, InputColors, InputTypography, MenuOverlayConfig, ModelMenuStyles, ModelSelectorLabels, SendOnEnter, TextInsertion, ToolsChipLabels } from './Input';
 import { TranscribeAudio } from './Voice';
 /** CSS custom-property overrides for the `ConversationInput` component. */
 export interface ConversationInputColors {
@@ -26,23 +27,71 @@ export interface ConversationInputStyles {
     colors?: ConversationInputColors;
     /** Typography overrides for the welcome heading and input. */
     typography?: ConversationInputTypography;
+    /**
+     * Style overrides for the composer's attachment tray. Its `card` slot
+     * carries `AttachmentCardStyles` through to every tile, which is how a host
+     * sizes a tile or restyles its meta line without a descendant selector on
+     * `ATTACHMENT_INPUT_CLASS`.
+     */
+    attachmentTray?: AttachmentTrayStyles;
+    /**
+     * Styling hooks for the model menu in both presentations — the desktop
+     * dropdown and the mobile sheet — so a host restyles its panel, search row
+     * and selected row without a descendant selector on
+     * `CONVERSATION_INPUT_CLASS.modelMenu*`.
+     */
+    modelMenu?: ModelMenuStyles;
 }
 /** Props accepted by the `EditMessageInput` component. */
 export interface EditMessageInputProps {
     /** Initial message text pre-populated in the textarea. */
     message?: string;
     /**
-     * Host-supplied content rendered inside the text area at its inline-start;
-     * typed text starts after it on the first line and wraps at full width
-     * below. Forwarded to the inner `Input`.
+     * Optional token that forces the textarea to resync from `message`, even
+     * when `message` itself is the same string as before (e.g. the host
+     * spliced a mention into its own copy of the draft at a known position and
+     * needs the textarea to adopt it). Forwarded to the inner `Input`.
+     */
+    messageRevision?: number;
+    /**
+     * Called with the textarea's current value on every change (typing,
+     * deleting, pasting, undo/redo) — not only on save. A host tracking live
+     * state derived from the draft (e.g. skill-mention anchors that must
+     * reconcile as the user edits around them) wires this; omit it to ignore
+     * keystrokes between saves.
      */
-    inlineStartSlot?: ReactNode;
+    onChange?: (message: string) => void;
     /**
-     * Called when Backspace is pressed with the caret collapsed at position 0
-     * while `inlineStartSlot` content is shown (the slot's remove gesture).
+     * Ranges of `message` rendered as highlighted runs (e.g. a restored skill
+     * mention). Forwarded to the inner `Input`.
+     */
+    activeMentions?: HighlightedTextRange[];
+    /**
+     * Called on Backspace with the caret collapsed at some position, to ask
+     * whether a tracked range ends exactly there — see `Input`'s prop of the
+     * same name. Forwarded to the inner `Input`.
+     */
+    onBackspaceAtCaret?: (caretPosition: number) => HighlightedTextRange | undefined;
+    /**
+     * One-shot caret placement applied whenever the internal message resyncs
+     * from a new `message` value (e.g. right after inserting a mention).
      * Forwarded to the inner `Input`.
      */
-    onInlineStartRemove?: () => void;
+    caretPositionOverride?: number;
+    /**
+     * Host-injected slash-command menu, forwarded to the inner `Input` — see
+     * `Input`'s prop of the same name. Absent disables the mechanism during
+     * edit.
+     */
+    commandMenu?: CommandMenuConfig;
+    /**
+     * Host-injected overlay entries for the `+` menu. `EditMessageInput` hides
+     * the inner `Input`'s own footer (`hideActionBar`) and renders its own
+     * external `AddAttachmentButton` instead, so these entries are forwarded to
+     * that button, not to `Input`. Absent renders no add-menu overlay entries
+     * during edit.
+     */
+    menuOverlays?: MenuOverlayConfig[];
     /** Pre-existing attachments from the original message, shown in the attachment tray. */
     initialAttachments?: DisplayAttachment[];
     /** Called when the user clicks the Cancel button. */
@@ -63,6 +112,10 @@ export interface EditMessageInputProps {
     retryLabel?: string;
     /** Accessible label for each attachment card's in-progress upload progress bar. Defaults to `'Uploading'`. */
     uploadingLabel?: string;
+    /** Accessible name of each pasted-text attachment card, which expands its text back into the composer when activated. Defaults to `'Expand pasted text'`. */
+    expandLabel?: string;
+    /** Accessible name of each non-pasted attachment card when `onAttachmentClick` makes it interactive. Name it after what the host handler does (e.g. opening the attachment in a canvas). When omitted, the card default applies (`'Open attachment'` on image tiles, `'Download attachment'` on file and link tiles). Pasted-text cards keep `expandLabel`. */
+    clickLabel?: string;
     /** Accessible label for the add-menu trigger button. */
     addMenuTitle?: string;
     /** Label for the attach-file menu item. */
@@ -149,8 +202,25 @@ export interface EditMessageInputProps {
 }
 /** Props accepted by the `ConversationInput` component. */
 export interface ConversationInputProps {
+    /** Changing this token requests textarea focus without altering its value or caret. */
+    focusRequestId?: number;
     /** Placeholder text shown inside the textarea when empty. */
     placeholder?: string;
+    /**
+     * How the action row arranges the textarea and the controls around it.
+     * Defaults to `ActionRowLayout.Stacked`. `ActionRowLayout.Inline` applies
+     * from the desktop breakpoint (1280px) up, unless
+     * `isInlineActionRowAllowedBelowDesktop` opts the narrower widths in.
+     */
+    actionRowLayout?: ActionRowLayout;
+    /**
+     * When `true`, `ActionRowLayout.Inline` also applies below the desktop
+     * breakpoint (1280px). Set it when the embedded composer is wide enough
+     * there — a phone-width one is not. Affects the action row alone: the add
+     * menu and model picker keep their bottom-sheet presentation. Defaults to
+     * `false`.
+     */
+    isInlineActionRowAllowedBelowDesktop?: boolean;
     /**
      * Message value. Sets the initial textarea content on mount and syncs the
      * textarea whenever the value changes.
@@ -161,6 +231,14 @@ export interface ConversationInputProps {
      * when `message` itself is the same string as before.
      */
     messageRevision?: number;
+    /**
+     * Called with the textarea's current value on every change (typing,
+     * deleting, pasting, undo/redo) — not only on send. A host tracking live
+     * state derived from the draft (e.g. skill-mention anchors that must
+     * reconcile as the user edits around them) wires this; omit it to ignore
+     * keystrokes between sends, as before this prop existed.
+     */
+    onChange?: (message: string) => void;
     /**
      * Text inserted at the caret each time its `revision` changes, leaving the
      * surrounding draft intact. Unlike `message`, this never replaces what the
@@ -172,6 +250,8 @@ export interface ConversationInputProps {
     welcomeText?: string;
     /** Optional description text rendered below the welcome heading. Ignored when `welcomeText` is absent. */
     descriptionText?: string;
+    /** Slot rendered between the welcome heading and the input, e.g. conversation starters. */
+    belowWelcomeSlot?: ReactNode;
     /** Called when the user submits a message (Enter or send button). Receives the current local attachments as the second argument. */
     onSend?: (message: string, attachments: Attachment[]) => void;
     /** Called immediately after an attachment is added. Returns the uploaded attachment URL and stored name. */
@@ -219,7 +299,9 @@ export interface ConversationInputProps {
     /** Accessible label for the send button. */
     sendLabel?: string;
     /** Tooltip shown on hover over the send button. */
-    sendTitle?: string;
+    sendTooltip?: string;
+    /** Tooltip for an empty composer (no text, attachments, or inline-start slot). Defaults to sendTooltip. */
+    emptyMessageTooltip?: string;
     /** Accessible label for the stop button. */
     stopLabel?: string;
     /** Accessible label for each attachment card's remove button. Defaults to `'Remove attachment'`. */
@@ -228,7 +310,17 @@ export interface ConversationInputProps {
     retryLabel?: string;
     /** Accessible label for each attachment card's in-progress upload progress bar. Defaults to `'Uploading'`. */
     uploadingLabel?: string;
-    /** When `true`, blocks all text input, send, attach, and drop interactions. Starter/action buttons and the model selector remain usable. Defaults to `false`. */
+    /** Accessible name of each pasted-text attachment card, which expands its text back into the composer when activated. Defaults to `'Expand pasted text'`. */
+    expandLabel?: string;
+    /** Accessible name of each non-pasted attachment card when `onAttachmentClick` makes it interactive. Name it after what the host handler does (e.g. opening the attachment in a canvas). When omitted, the card default applies (`'Open attachment'` on image tiles, `'Download attachment'` on file and link tiles). Pasted-text cards keep `expandLabel`. */
+    clickLabel?: string;
+    /**
+     * When `true`, blocks typing, the attach menu, dictation, Enter-to-send,
+     * and dropped files (`pendingDropFiles` are consumed and discarded, never
+     * added to the tray). The send button still submits a message that is
+     * already populated (e.g. by a starter). Starter/action buttons and the
+     * model selector remain usable. Defaults to `false`.
+     */
     isInputDisabled?: boolean;
     /**
      * When `true`, the model selector renders in a disabled, non-interactive
@@ -379,17 +471,22 @@ export interface ConversationInputProps {
      */
     menuOverlays?: MenuOverlayConfig[];
     /**
-     * Host-supplied content rendered inside the text area at its inline-start;
-     * typed text starts after it on the first line and wraps at full width
-     * below. Forwarded to the inner `Input`.
+     * Ranges of `message` rendered as highlighted runs (e.g. a tracked skill
+     * mention). Forwarded to the inner `Input`.
      */
-    inlineStartSlot?: ReactNode;
+    activeMentions?: HighlightedTextRange[];
     /**
-     * Called when Backspace is pressed with the caret collapsed at position 0
-     * while `inlineStartSlot` is present (the slot's remove gesture). Forwarded
-     * to the inner `Input`.
+     * Called on Backspace with the caret collapsed at some position, to ask
+     * whether a tracked range ends exactly there — see `Input`'s prop of the
+     * same name. Forwarded to the inner `Input`.
+     */
+    onBackspaceAtCaret?: (caretPosition: number) => HighlightedTextRange | undefined;
+    /**
+     * One-shot caret placement applied whenever the internal message resyncs
+     * from a new `message` value (e.g. right after inserting a mention).
+     * Forwarded to the inner `Input`.
      */
-    onInlineStartRemove?: () => void;
+    caretPositionOverride?: number;
     /**
      * Host-injected slash-command menu: typing `triggerPrefix` as the first
      * character of an empty textarea — or pasting into an empty textarea a

package/models/ConversationInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConversationInput.d.ts","sourceRoot":"","sources":["../../src/models/ConversationInput.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ConversationInput.d.ts","sourceRoot":"","sources":["../../src/models/ConversationInput.ts"],"names":[],"mappings":"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"}

package/models/Input.d.ts

@@ -1,3 +1,4 @@
+import { AttachmentTrayStyles } from '@epam/ai-dial-attachment-input';
 import { Attachment, AttachmentErrorReason, DeploymentFeatures, DeploymentItem, DisplayAttachment, ResponseFormat, ToolMenuItem, UploadedAttachmentResult } from '@epam/ai-dial-chat-shared';
 import { ReactNode } from 'react';
 import { TranscribeAudio } from './Voice';
@@ -8,6 +9,13 @@ export declare enum SendOnEnter {
     /** ⌘+Enter (macOS) / Ctrl+Enter (Windows/Linux) submits; bare Enter inserts a newline. */
     MetaEnter = "meta-enter"
 }
+/** Controls how the `Input` component arranges the textarea and the controls around it. */
+export declare enum ActionRowLayout {
+    /** Textarea occupies its own line; the add button, tool chips, and footer actions wrap below it. */
+    Stacked = "stacked",
+    /** Add button, textarea, and footer actions share one line; tool chips move to their own row above. Applies below the desktop breakpoint only when the host opts in. */
+    Inline = "inline"
+}
 /** CSS custom-property overrides for the `Input` component. */
 export interface InputColors {
     /** Input area background color. */
@@ -32,12 +40,18 @@ export interface InputColors {
     modelSelectorName?: string;
     /** Model-selector chip version text color (desktop only). Defaults to `--text-secondary`. */
     modelSelectorVersion?: string;
-    /** Voice bar error border/icon color. Defaults to `--stroke-error`/`--text-error`. */
-    voiceError?: string;
-    /** Voice bar waveform and timer text color. Defaults to `--text-primary`. */
+    /** Voice bar waveform color. Defaults to `--text-primary`. */
     voiceWaveform?: string;
-    /** Voice bar stop button and recording-dot accent color. Defaults to `--text-error`. */
+    /** Voice bar recording-dot color. Defaults to `--text-error`. */
     voiceAccent?: string;
+    /** Background color of a tracked skill mention's highlighted run. Defaults to `--bg-control-accent-alpha`. */
+    mentionHighlightBg?: string;
+    /** Text color of a tracked skill mention's highlighted run. Defaults to `--text-accent`. */
+    mentionHighlightText?: string;
+    /** Background color of a tracked skill mention's highlighted run while unsupported. Defaults to `--bg-error`. */
+    mentionHighlightUnsupportedBg?: string;
+    /** Text color of a tracked skill mention's highlighted run while unsupported. Defaults to `--text-error`. */
+    mentionHighlightUnsupportedText?: string;
 }
 /** Typography overrides for the `Input` component. */
 export interface InputTypography {
@@ -61,10 +75,51 @@ export interface ModelSelectorLabels {
     /** Tooltip shown when the selected deployment is no longer available (e.g. removed from the catalog). Defaults to `'This deployment is no longer available'`. */
     unavailableTooltip?: string;
 }
+/** Color overrides for the model menu, applied as CSS custom properties. */
+export interface ModelMenuColors {
+    /**
+     * Background of the search row above the deployment list. Defaults to
+     * `--bg-layer-raised` in the desktop dropdown, where the row is sticky over
+     * scrolling items, and to transparent in the mobile sheet.
+     */
+    searchHeaderBackground?: string;
+    /** Label and icon color of every deployment row. Defaults to `--text-primary`. */
+    itemText?: string;
+    /** Background of a hovered deployment row. Defaults to `--bg-control-accent-alpha-hover` on desktop and `--bg-layer-raised` in the sheet. */
+    itemHoverBackground?: string;
+    /** Background of the selected deployment row at rest. Defaults to none. */
+    selectedItemBackground?: string;
+    /** Label color of the selected deployment row. Defaults to `itemText`. */
+    selectedItemText?: string;
+    /** Color of the check mark on the selected row. Defaults to the row's text color on desktop and `--text-accent` in the sheet. */
+    checkIcon?: string;
+}
+/**
+ * Styling hooks for the model menu, applied in both presentations: the desktop
+ * dropdown and the mobile bottom sheet. Every class is merged after the
+ * component's own, so a conflicting utility replaces the default rather than
+ * landing beside it.
+ */
+export interface ModelMenuStyles {
+    /** Class on the menu panel: the dropdown overlay on desktop, the sheet on mobile. Also applied when `modelPickerOverlay` supplies the content. */
+    className?: string;
+    /** Class on the search row above the deployment list. */
+    searchHeaderClassName?: string;
+    /** Class on every deployment row. */
+    itemClassName?: string;
+    /** Class on the currently selected deployment row, additive to `itemClassName`. */
+    selectedItemClassName?: string;
+    /** Color overrides applied as CSS custom properties. */
+    colors?: ModelMenuColors;
+}
 /** Labels for the tool chips rendered in the conversation input. */
 export interface ToolsChipLabels {
     /** Returns the accessible label for a chip's × button, which drops the tool from the input. Receives the tool label. Defaults to `"Remove {toolLabel}"`. */
     removeLabel?: (toolLabel: string) => string;
+    /** Visible state text shown after the tool label while the tool is on, e.g. `"ON"`. Renders only when `stateOffLabel` is also set. */
+    stateOnLabel?: string;
+    /** Visible state text shown after the tool label while the tool is off, e.g. `"OFF"`. Renders only when `stateOnLabel` is also set. */
+    stateOffLabel?: string;
 }
 /** A host-injected overlay entry for the `+` menu: a menu item whose submenu renders host-owned content. */
 export interface MenuOverlayConfig {
@@ -74,8 +129,18 @@ export interface MenuOverlayConfig {
     title: string;
     /** Icon node rendered to the left of the menu-item label. */
     icon: ReactNode;
-    /** Renders the overlay panel content. Receives a callback the panel calls to close the whole menu once selection is complete. */
-    renderOverlay: (onClose: () => void) => ReactNode;
+    /**
+     * Renders the overlay panel content. Receives a callback the panel calls to
+     * close the whole menu once selection is complete, and the textarea's
+     * caret offset at the moment the overlay opened (0 when it cannot be
+     * determined) — e.g. so a selection made here can splice text in at that
+     * exact position via `message`/`messageRevision`/`caretPositionOverride`.
+     * The content is mounted inside a `role="menu"` container — the desktop
+     * submenu panel or the mobile sheet's wrapper — so selectable rows should
+     * be `role="menuitem"`: those are the rows the desktop submenu's
+     * ArrowUp/ArrowDown/Home/End navigation moves between.
+     */
+    renderOverlay: (onClose: () => void, caretPosition: number) => ReactNode;
     /** Accessible label for the back arrow in the mobile stacked bottom sheet. Defaults to `'Back'`. */
     backLabel?: string;
 }
@@ -83,18 +148,44 @@ export interface MenuOverlayConfig {
 export interface CommandMenuContext {
     /** Current query: the value typed after the trigger prefix, with no whitespace or second prefix character. */
     query: string;
+    /** Character offset where the triggering word (prefix + query) starts in the textarea's current value. */
+    caretPosition: number;
     /**
-     * Closes the menu. Pass `{ consumeQuery: true }` to also remove the trigger
-     * prefix and query from the textarea (the selection path — the `/query`
-     * text is never sent); the default close leaves the text untouched.
+     * Closes the menu. `{ consumeQuery: true }` also removes the trigger
+     * prefix and query from the textarea; `{ returnFocus: false }` skips
+     * refocusing the textarea (see the host's own doc for when to use it).
      */
     close: (options?: {
         consumeQuery?: boolean;
+        returnFocus?: boolean;
     }) => void;
+    /**
+     * Id the menu puts on its `role="listbox"` element. The textarea references
+     * it through `aria-controls` while the menu is open.
+     */
+    listboxId: string;
+    /**
+     * Id of the option the keyboard currently has active, or `null` when none
+     * is. The textarea moves it through the menu's `role="option"` elements
+     * with ArrowDown/ArrowUp (wrapping at the ends) and exposes it through
+     * `aria-activedescendant`; the menu marks the matching option with
+     * `aria-selected="true"` and a visible highlight. Enter clicks the active
+     * option, so an option's `onClick` is its selection path for mouse and
+     * keyboard alike. Options must carry unique `id`s; one with
+     * `aria-disabled="true"` is skipped. Reset whenever the query changes.
+     */
+    activeOptionId: string | null;
 }
-/** Host-injected slash-command menu: an overlay opened by entering a trigger prefix into an empty textarea — typed or pasted. */
+/**
+ * Host-injected slash-command menu: an overlay opened by entering a trigger
+ * prefix as its own word anywhere in the textarea. While it is open the
+ * textarea drives it as a list autocomplete: ArrowDown/ArrowUp move the
+ * active option (instead of navigating message history), Enter takes the
+ * active option and never sends the message, and Escape closes the menu
+ * keeping the text.
+ */
 export interface CommandMenuConfig {
-    /** Prefix that opens the menu when entered into an empty textarea (e.g. `'/'`) — typed as its first character, or arriving in a paste whose result is the prefix alone or with a whitespace-free query. */
+    /** Prefix that opens the menu when it starts a whitespace-delimited word (e.g. `'/'`) — typed as the word's first character, or arriving in a paste that produces such a word. */
     triggerPrefix: string;
     /** Renders the menu content for the current query. */
     renderMenu: (ctx: CommandMenuContext) => ReactNode;
@@ -107,6 +198,35 @@ export interface CommandMenuConfig {
     /** Accessible name for the menu region. When absent, the content is rendered without a labeled wrapper. */
     menuLabel?: string;
 }
+/**
+ * A range within `Input`'s current `message` text, rendered as a highlighted
+ * run (e.g. a skill mention's `/{name}` text). Positional only — beyond
+ * placement, `Input` attaches no meaning to what a range represents.
+ */
+export interface HighlightedTextRange {
+    /** Character offset where the highlighted run starts. */
+    start: number;
+    /** Length of the highlighted run. */
+    length: number;
+    /**
+     * Renders the run in its error styling instead of the default highlight
+     * (e.g. a skill mention selected on a deployment that doesn't support
+     * skills). Ignored when `render` is provided — the renderer owns its own
+     * error styling. Defaults to `false`.
+     */
+    isUnsupported?: boolean;
+    /**
+     * Renders this range as host-owned content (e.g. `ChatSkill`, the same
+     * interactive chip a sent message renders it as) instead of the default
+     * highlight span. Unlike the rest of the mirror — which duplicates the
+     * textarea's own text purely for visual highlighting and stays inert
+     * (`pointer-events: none`, `aria-hidden`) — the returned node is rendered
+     * with real pointer events and outside `aria-hidden`, so hover/focus/click
+     * (a tooltip, a "View details" action) work exactly as they do once the
+     * mention is part of sent history.
+     */
+    render?: () => ReactNode;
+}
 /** One-shot text hand-off that the `Input` inserts at the caret. */
 export interface TextInsertion {
     /** Text inserted at the caret, replacing whatever is selected. */
@@ -114,8 +234,20 @@ export interface TextInsertion {
     /** Token that performs the insertion; bump it to insert the same text again. */
     revision: number;
 }
+/**
+ * Imperative handle exposed by `Input` via `ref`. Lets a host that renders
+ * its own UI outside `Input` (e.g. `EditMessageInput`'s external add-menu
+ * button, which sits alongside `Input` rather than inside it) read the live
+ * caret position without owning the textarea itself.
+ */
+export interface InputHandle {
+    /** The textarea's current caret offset (its `selectionStart`), or the message's length when it cannot be read. */
+    getCaretPosition: () => number;
+}
 /** Props accepted by the `Input` component. */
 export interface InputProps {
+    /** Changing this token requests textarea focus without altering its value or caret. */
+    focusRequestId?: number;
     /**
      * Message value. Sets the initial textarea content on mount and syncs the
      * textarea whenever the value changes.
@@ -129,8 +261,9 @@ export interface InputProps {
     /**
      * Text inserted at the caret each time its `revision` changes, leaving the
      * surrounding draft intact. Unlike `message`, this never replaces what the
-     * user has written, and it is made through the browser's editing pipeline so
-     * the native undo shortcut reverts it.
+     * user has written, and `Ctrl`/`Cmd`+`Z` undoes it. The insert lands one
+     * microtask after the render that requests it, and leaves the caret after
+     * the inserted text.
      */
     textInsertion?: TextInsertion;
     /** Called on every keystroke with the current textarea value. */
@@ -153,6 +286,13 @@ export interface InputProps {
     colors?: InputColors;
     /** Typography overrides applied as CSS custom properties. */
     typography?: InputTypography;
+    /**
+     * Style overrides for the attachment tray inside the composer and, through
+     * its `card` slot, for every tile in it.
+     */
+    attachmentTray?: AttachmentTrayStyles;
+    /** Styling hooks for the model menu: its panel, search row and deployment rows. */
+    modelMenu?: ModelMenuStyles;
     /** Label for the attach-file menu item. */
     attachLabel?: string;
     /**
@@ -171,10 +311,16 @@ export interface InputProps {
     retryLabel?: string;
     /** Accessible label for each attachment card's in-progress upload progress bar. Defaults to `'Uploading'`. */
     uploadingLabel?: string;
+    /** Accessible name of each pasted-text attachment card, which expands its text back into the composer when activated. Defaults to `'Expand pasted text'`. */
+    expandLabel?: string;
+    /** Accessible name of each non-pasted attachment card when `onAttachmentClick` makes it interactive. Name it after what the host handler does (e.g. opening the attachment in a canvas). When omitted, the card default applies (`'Open attachment'` on image tiles, `'Download attachment'` on file and link tiles). Pasted-text cards keep `expandLabel`. */
+    clickLabel?: string;
     /** Accessible label for the send button. */
     sendLabel?: string;
     /** Tooltip shown on hover over the send button. */
-    sendTitle?: string;
+    sendTooltip?: string;
+    /** Tooltip for an empty composer (no text, attachments, or inline-start slot). Defaults to sendTooltip. */
+    emptyMessageTooltip?: string;
     /** Accessible label for the stop button. */
     stopLabel?: string;
     /** Extra class name(s) merged onto the root wrapper element. */
@@ -253,6 +399,21 @@ export interface InputProps {
      * `EditMessageInput` where the action row lives outside the bordered box.
      */
     hideActionBar?: boolean;
+    /**
+     * How the action row arranges the textarea and the controls around it.
+     * Defaults to `ActionRowLayout.Stacked`. `ActionRowLayout.Inline` applies
+     * from the desktop breakpoint (1280px) up, unless
+     * `isInlineActionRowAllowedBelowDesktop` opts the narrower widths in.
+     */
+    actionRowLayout?: ActionRowLayout;
+    /**
+     * When `true`, `ActionRowLayout.Inline` also applies below the desktop
+     * breakpoint (1280px). Set it when the embedded composer is wide enough
+     * there — a phone-width one is not. Affects the action row alone: the add
+     * menu and model picker keep their bottom-sheet presentation. Defaults to
+     * `false`.
+     */
+    isInlineActionRowAllowedBelowDesktop?: boolean;
     /**
      * When provided, replaces the default send/stop/model-selector area with custom content.
      * Receives `canSend` (textarea has non-empty trimmed content) and `onSend` (triggers the
@@ -262,7 +423,13 @@ export interface InputProps {
         canSend: boolean;
         onSend: () => void;
     }) => ReactNode;
-    /** When `true`, blocks all text input, send, attach, and drop interactions. Starter/action buttons and the model selector remain usable. Defaults to `false`. */
+    /**
+     * When `true`, blocks typing, the attach menu, dictation, Enter-to-send,
+     * and dropped files (`pendingDropFiles` are consumed and discarded, never
+     * added to the tray). The send button still submits a message that is
+     * already populated (e.g. by a starter). Starter/action buttons and the
+     * model selector remain usable. Defaults to `false`.
+     */
     isInputDisabled?: boolean;
     /**
      * When `true`, the model selector renders in a disabled, non-interactive
@@ -339,21 +506,33 @@ export interface InputProps {
      */
     menuOverlays?: MenuOverlayConfig[];
     /**
-     * Host-supplied content rendered inside the text area at its inline-start;
-     * typed text starts after it on the first line and wraps at full width
-     * below. The slot's width is measured and the first text line indents past
-     * it, and the placeholder is suppressed. Absent renders the text area
-     * unchanged.
+     * Ranges of `message` rendered as highlighted runs — e.g. a host-tracked
+     * skill mention's `/{name}` text. The textarea's own text is rendered
+     * transparent (its caret stays visible and normally colored) and a
+     * non-interactive mirror underneath renders the same text with each range
+     * wrapped in a highlight span, so the highlighted text stays pixel-aligned
+     * with the real, editable characters underneath it. Carries no semantic
+     * meaning to `Input` beyond where to draw a highlight. Absent (or empty)
+     * renders the text area unchanged, with normal (non-transparent) text.
+     */
+    activeMentions?: HighlightedTextRange[];
+    /**
+     * Called on Backspace with the caret collapsed at some position, to ask the
+     * host whether a tracked range ends exactly there. Returning a range makes
+     * `Input` delete that whole range in one native edit (preserving undo)
+     * instead of the browser's default single-character deletion; returning
+     * `undefined` leaves Backspace unhandled. Absent disables the mechanism
+     * entirely (ordinary Backspace behavior).
      */
-    inlineStartSlot?: ReactNode;
+    onBackspaceAtCaret?: (caretPosition: number) => HighlightedTextRange | undefined;
     /**
-     * Called when Backspace is pressed with the caret collapsed at position 0
-     * while `inlineStartSlot` is present — the slot's remove gesture (there is
-     * nothing to delete backwards at position 0, so the keypress is redirected
-     * to the slot and suppressed). Absent leaves Backspace with no slot-side
-     * behavior.
+     * One-shot caret placement applied whenever `messageRevision` changes (e.g.
+     * right after the host pushes a new `message` that inserted a mention at a
+     * known position) — moves the caret there once, after the value updates.
+     * Absent leaves the caret wherever the browser puts it after the value
+     * change.
      */
-    onInlineStartRemove?: () => void;
+    caretPositionOverride?: number;
     /**
      * Host-injected slash-command menu. When provided, typing `triggerPrefix`
      * as the first character of an empty textarea — or pasting into an empty
@@ -361,13 +540,19 @@ export interface InputProps {
      * whitespace-free, prefix-free query — opens an overlay above the input;
      * it stays open while the value keeps matching the prefix followed by a
      * query with no whitespace or second prefix character, and closes on
-     * unmatch, Escape, or an outside click (a dismissed menu reopens only
-     * after the value stops matching and the trigger is typed or pasted
-     * again). Any other pasted value, and any paste into a non-empty
-     * textarea, inserts as a regular paste and opens nothing. Selection
-     * typically goes through `ctx.close({ consumeQuery: true })`, which
-     * removes the `/query` text from the textarea. Absent disables the
-     * mechanism.
+     * unmatch, Escape, or an outside click. Escape is the one dismissal that
+     * latches: the menu stays closed over that same word until the value stops
+     * matching and the trigger is typed or pasted again. An outside click only
+     * closes it for the moment — typing/deleting within the same still-matching
+     * word, or moving the caret back into it (a click, or refocusing the
+     * textarea), reopens it with no need to retype the trigger. A message can
+     * hold more than one command-shaped word at once; the menu always tracks
+     * whichever one the caret is actually in, re-evaluated on every such caret
+     * move rather than assumed from whichever word was active before. Any other
+     * pasted value, and any paste into a non-empty textarea, inserts as a
+     * regular paste and opens nothing. Selection typically goes through
+     * `ctx.close({ consumeQuery: true })`, which removes the `/query` text from
+     * the textarea. Absent disables the mechanism.
      */
     commandMenu?: CommandMenuConfig;
     /** When `true`, focuses the textarea on mount. Defaults to `false`. */