@particle-academy/react-fancy 5.68.0 → 5.70.0

package/dist/command.js

@@ -1,6 +1,7 @@
-export { Command, useCommand } from './chunk-ARO2DNGS.js';
+export { Command, useCommand } from './chunk-EZZKHMR4.js';
 import './chunk-5U2DZ7AV.js';
 import './chunk-3K2CEAI7.js';
+import './chunk-S42OGG43.js';
 import './chunk-5VMILVWD.js';
 import './chunk-RBCMKPBX.js';
 import './chunk-YX6FTJ6N.js';

package/dist/composer.cjs

@@ -1,9 +1,12 @@
 'use strict';
 
-var chunk7FYRFNPX_cjs = require('./chunk-7FYRFNPX.cjs');
-var chunkHFK5SBNM_cjs = require('./chunk-HFK5SBNM.cjs');
+var chunkLBSAWRFT_cjs = require('./chunk-LBSAWRFT.cjs');
+require('./chunk-XNHAJQRF.cjs');
+var chunkKKYILQTG_cjs = require('./chunk-KKYILQTG.cjs');
 require('./chunk-MKGWHSNV.cjs');
+require('./chunk-2C64OVOZ.cjs');
 require('./chunk-J2DI6RMR.cjs');
+require('./chunk-6V44RRSB.cjs');
 require('./chunk-MKHYENKR.cjs');
 require('./chunk-TI7D4QDM.cjs');
 require('./chunk-57FQGQJK.cjs');
@@ -15,11 +18,11 @@ require('./chunk-ZU5Q77OT.cjs');
 
 Object.defineProperty(exports, "Composer", {
   enumerable: true,
-  get: function () { return chunk7FYRFNPX_cjs.Composer; }
+  get: function () { return chunkLBSAWRFT_cjs.Composer; }
 });
 Object.defineProperty(exports, "pasteMarker", {
   enumerable: true,
-  get: function () { return chunkHFK5SBNM_cjs.pasteMarker; }
+  get: function () { return chunkKKYILQTG_cjs.pasteMarker; }
 });
 //# sourceMappingURL=composer.cjs.map
 //# sourceMappingURL=composer.cjs.map

package/dist/composer.d.cts

@@ -2,6 +2,8 @@ import * as react from 'react';
 import { ReactNode } from 'react';
 import { H as HeldImage, C as ComposerPastePreview, a as ComposerPasteClassNames, b as HeldPaste } from './PastePills.types-CpXzsuwJ.cjs';
 export { p as pasteMarker } from './PastePills.types-CpXzsuwJ.cjs';
+import { a as SubmitResult } from './use-acknowledged-submit-7nC0vSCP.cjs';
+export { S as SubmitRejection } from './use-acknowledged-submit-7nC0vSCP.cjs';
 
 interface ComposerSubmitExtras {
     /**
@@ -18,11 +20,51 @@ interface ComposerProps {
     /**
      * The second argument only ever carries anything with `pasteImages` on. A
      * one-argument handler stays valid.
+     *
+     * **Return nothing and the message clears at once, as it always has.**
+     *
+     * Return a Promise to make the send acknowledged: the text and held pastes
+     * stay, the send button is disabled and `aria-busy`, and a second send is
+     * refused until it settles. The text stays editable meanwhile.
+     *
+     * - Resolves (to anything but `{ ok: false }`) → the message clears, unless the
+     *   person edited it while it was in flight; their newer text is kept.
+     * - Rejects, or resolves `{ ok: false, error? }` → everything is kept,
+     *   `onSubmitError` is called and the failure is announced to screen readers.
+     *
+     * With a controlled `value` the clear is an `onChange("")` like any other; the
+     * host decides whether to apply it.
+     */
+    onSubmit?: (value: string, extras: ComposerSubmitExtras) => void | Promise<SubmitResult>;
+    /**
+     * Called when a Promise from `onSubmit` rejects (with the reason) or resolves
+     * `{ ok: false }` (with its `error`, or `undefined`). The message is kept.
      */
-    onSubmit?: (value: string, extras: ComposerSubmitExtras) => void;
+    onSubmitError?: (error: unknown) => void;
     placeholder?: string;
     actions?: ReactNode;
+    /** Disables the text, the pills and the send. */
     disabled?: boolean;
+    /**
+     * Disables only the send: the text stays editable, Enter does not send. For
+     * "the agent is still answering, but you can write the next message".
+     */
+    sendDisabled?: boolean;
+    /**
+     * Form field name for the text. On the textarea itself; with
+     * `pastePlacement="inline"` on a hidden input carrying the expanded text,
+     * since a contenteditable is not a form field. With the default placement,
+     * held pastes are NOT in the textarea's value — read `onSubmit` for those.
+     */
+    name?: string;
+    /**
+     * `id` of the text field (textarea or inline editor), for a `<label htmlFor>`
+     * or an agent. In either mode it is the one handle that does not change with
+     * `pastePlacement`. Without it the field is found by
+     * `data-react-fancy-composer-textarea` (default placement) or
+     * `data-react-fancy-composer-input` (inline).
+     */
+    inputId?: string;
     className?: string;
     /**
      * Hold a paste of at least this many characters as a pill, instead of inserting
@@ -94,4 +136,4 @@ interface ComposerProps {
 
 declare const Composer: react.ForwardRefExoticComponent<ComposerProps & react.RefAttributes<HTMLDivElement>>;
 
-export { Composer, ComposerPasteClassNames, ComposerPastePreview, type ComposerProps, type ComposerSubmitExtras, HeldImage, HeldPaste };
+export { Composer, ComposerPasteClassNames, ComposerPastePreview, type ComposerProps, type ComposerSubmitExtras, HeldImage, HeldPaste, SubmitResult };

package/dist/composer.d.ts

@@ -2,6 +2,8 @@ import * as react from 'react';
 import { ReactNode } from 'react';
 import { H as HeldImage, C as ComposerPastePreview, a as ComposerPasteClassNames, b as HeldPaste } from './PastePills.types-CpXzsuwJ.js';
 export { p as pasteMarker } from './PastePills.types-CpXzsuwJ.js';
+import { a as SubmitResult } from './use-acknowledged-submit-7nC0vSCP.js';
+export { S as SubmitRejection } from './use-acknowledged-submit-7nC0vSCP.js';
 
 interface ComposerSubmitExtras {
     /**
@@ -18,11 +20,51 @@ interface ComposerProps {
     /**
      * The second argument only ever carries anything with `pasteImages` on. A
      * one-argument handler stays valid.
+     *
+     * **Return nothing and the message clears at once, as it always has.**
+     *
+     * Return a Promise to make the send acknowledged: the text and held pastes
+     * stay, the send button is disabled and `aria-busy`, and a second send is
+     * refused until it settles. The text stays editable meanwhile.
+     *
+     * - Resolves (to anything but `{ ok: false }`) → the message clears, unless the
+     *   person edited it while it was in flight; their newer text is kept.
+     * - Rejects, or resolves `{ ok: false, error? }` → everything is kept,
+     *   `onSubmitError` is called and the failure is announced to screen readers.
+     *
+     * With a controlled `value` the clear is an `onChange("")` like any other; the
+     * host decides whether to apply it.
+     */
+    onSubmit?: (value: string, extras: ComposerSubmitExtras) => void | Promise<SubmitResult>;
+    /**
+     * Called when a Promise from `onSubmit` rejects (with the reason) or resolves
+     * `{ ok: false }` (with its `error`, or `undefined`). The message is kept.
      */
-    onSubmit?: (value: string, extras: ComposerSubmitExtras) => void;
+    onSubmitError?: (error: unknown) => void;
     placeholder?: string;
     actions?: ReactNode;
+    /** Disables the text, the pills and the send. */
     disabled?: boolean;
+    /**
+     * Disables only the send: the text stays editable, Enter does not send. For
+     * "the agent is still answering, but you can write the next message".
+     */
+    sendDisabled?: boolean;
+    /**
+     * Form field name for the text. On the textarea itself; with
+     * `pastePlacement="inline"` on a hidden input carrying the expanded text,
+     * since a contenteditable is not a form field. With the default placement,
+     * held pastes are NOT in the textarea's value — read `onSubmit` for those.
+     */
+    name?: string;
+    /**
+     * `id` of the text field (textarea or inline editor), for a `<label htmlFor>`
+     * or an agent. In either mode it is the one handle that does not change with
+     * `pastePlacement`. Without it the field is found by
+     * `data-react-fancy-composer-textarea` (default placement) or
+     * `data-react-fancy-composer-input` (inline).
+     */
+    inputId?: string;
     className?: string;
     /**
      * Hold a paste of at least this many characters as a pill, instead of inserting
@@ -94,4 +136,4 @@ interface ComposerProps {
 
 declare const Composer: react.ForwardRefExoticComponent<ComposerProps & react.RefAttributes<HTMLDivElement>>;
 
-export { Composer, ComposerPasteClassNames, ComposerPastePreview, type ComposerProps, type ComposerSubmitExtras, HeldImage, HeldPaste };
+export { Composer, ComposerPasteClassNames, ComposerPastePreview, type ComposerProps, type ComposerSubmitExtras, HeldImage, HeldPaste, SubmitResult };

package/dist/composer.js

@@ -1,7 +1,10 @@
-export { Composer } from './chunk-QSGAFKK2.js';
-export { pasteMarker } from './chunk-YIKXJWO4.js';
+export { Composer } from './chunk-HN5J7TK6.js';
+import './chunk-AC3W3TIV.js';
+export { pasteMarker } from './chunk-6PRXG7L6.js';
 import './chunk-QTS4Q2NK.js';
+import './chunk-I3LAFKJU.js';
 import './chunk-MQ6VGG62.js';
+import './chunk-S42OGG43.js';
 import './chunk-5VMILVWD.js';
 import './chunk-RBCMKPBX.js';
 import './chunk-RGANGU7X.js';

package/dist/content-renderer.cjs

@@ -1,7 +1,8 @@
 'use strict';
 
 require('./chunk-S3TRSECD.cjs');
-var chunk464QSZ4A_cjs = require('./chunk-464QSZ4A.cjs');
+var chunkR3EJNGJV_cjs = require('./chunk-R3EJNGJV.cjs');
+require('./chunk-2C64OVOZ.cjs');
 require('./chunk-3U7PUZLI.cjs');
 require('./chunk-XCZZVRBY.cjs');
 require('./chunk-MXWR3T3N.cjs');
@@ -11,15 +12,15 @@ require('./chunk-ZU5Q77OT.cjs');
 
 Object.defineProperty(exports, "ContentRenderer", {
   enumerable: true,
-  get: function () { return chunk464QSZ4A_cjs.ContentRenderer; }
+  get: function () { return chunkR3EJNGJV_cjs.ContentRenderer; }
 });
 Object.defineProperty(exports, "registerExtension", {
   enumerable: true,
-  get: function () { return chunk464QSZ4A_cjs.registerExtension; }
+  get: function () { return chunkR3EJNGJV_cjs.registerExtension; }
 });
 Object.defineProperty(exports, "registerExtensions", {
   enumerable: true,
-  get: function () { return chunk464QSZ4A_cjs.registerExtensions; }
+  get: function () { return chunkR3EJNGJV_cjs.registerExtensions; }
 });
 //# sourceMappingURL=content-renderer.cjs.map
 //# sourceMappingURL=content-renderer.cjs.map

package/dist/content-renderer.js

@@ -1,5 +1,6 @@
 import './chunk-AUTW5O4W.js';
-export { ContentRenderer, registerExtension, registerExtensions } from './chunk-2LQR4EAN.js';
+export { ContentRenderer, registerExtension, registerExtensions } from './chunk-NAYXNVNU.js';
+import './chunk-I3LAFKJU.js';
 import './chunk-OXERDFFF.js';
 import './chunk-45BBNJQD.js';
 import './chunk-J3A4Z2P7.js';

package/dist/editor.cjs

@@ -1,15 +1,16 @@
 'use strict';
 
-var chunkE4DXICU3_cjs = require('./chunk-E4DXICU3.cjs');
+var chunk5YRSYS2F_cjs = require('./chunk-5YRSYS2F.cjs');
 require('./chunk-A2JUTNE6.cjs');
 require('./chunk-T6YELZPJ.cjs');
 require('./chunk-VQJ5LJJH.cjs');
 require('./chunk-4GOOSZEK.cjs');
-require('./chunk-464QSZ4A.cjs');
+require('./chunk-R3EJNGJV.cjs');
 require('./chunk-AIA5UNQ5.cjs');
 require('./chunk-G7227RTY.cjs');
 require('./chunk-TXTRTTG7.cjs');
 require('./chunk-FQZE5N2N.cjs');
+require('./chunk-2C64OVOZ.cjs');
 require('./chunk-L3V3BYVS.cjs');
 require('./chunk-J2DI6RMR.cjs');
 require('./chunk-TI7D4QDM.cjs');
@@ -25,11 +26,11 @@ require('./chunk-ZU5Q77OT.cjs');
 
 Object.defineProperty(exports, "Editor", {
   enumerable: true,
-  get: function () { return chunkE4DXICU3_cjs.Editor; }
+  get: function () { return chunk5YRSYS2F_cjs.Editor; }
 });
 Object.defineProperty(exports, "useEditor", {
   enumerable: true,
-  get: function () { return chunkE4DXICU3_cjs.useEditor; }
+  get: function () { return chunk5YRSYS2F_cjs.useEditor; }
 });
 //# sourceMappingURL=editor.cjs.map
 //# sourceMappingURL=editor.cjs.map

package/dist/editor.js

@@ -1,13 +1,14 @@
-export { Editor, useEditor } from './chunk-TQ77ZWBD.js';
+export { Editor, useEditor } from './chunk-F4GMOMUT.js';
 import './chunk-2BXMMVQS.js';
 import './chunk-CPY7NHXM.js';
 import './chunk-RP43ZFZP.js';
 import './chunk-ZQ3VXRUY.js';
-import './chunk-2LQR4EAN.js';
+import './chunk-NAYXNVNU.js';
 import './chunk-TJ66S5K6.js';
 import './chunk-FBWUXSKH.js';
 import './chunk-5U2DZ7AV.js';
 import './chunk-3K2CEAI7.js';
+import './chunk-I3LAFKJU.js';
 import './chunk-NRXK42LO.js';
 import './chunk-MQ6VGG62.js';
 import './chunk-RBCMKPBX.js';

package/dist/file-browser.cjs

@@ -1,6 +1,7 @@
 'use strict';
 
-var chunkG5DMYAWL_cjs = require('./chunk-G5DMYAWL.cjs');
+var chunkO5ORO2RX_cjs = require('./chunk-O5ORO2RX.cjs');
+require('./chunk-6V44RRSB.cjs');
 require('./chunk-SNHU2AI4.cjs');
 require('./chunk-ZU5Q77OT.cjs');
 
@@ -8,19 +9,19 @@ require('./chunk-ZU5Q77OT.cjs');
 
 Object.defineProperty(exports, "FileBrowser", {
   enumerable: true,
-  get: function () { return chunkG5DMYAWL_cjs.FileBrowser; }
+  get: function () { return chunkO5ORO2RX_cjs.FileBrowser; }
 });
 Object.defineProperty(exports, "FileBrowserNewFolder", {
   enumerable: true,
-  get: function () { return chunkG5DMYAWL_cjs.FileBrowserNewFolder; }
+  get: function () { return chunkO5ORO2RX_cjs.FileBrowserNewFolder; }
 });
 Object.defineProperty(exports, "useFileBrowser", {
   enumerable: true,
-  get: function () { return chunkG5DMYAWL_cjs.useFileBrowser; }
+  get: function () { return chunkO5ORO2RX_cjs.useFileBrowser; }
 });
 Object.defineProperty(exports, "validateFolderName", {
   enumerable: true,
-  get: function () { return chunkG5DMYAWL_cjs.validateFolderName; }
+  get: function () { return chunkO5ORO2RX_cjs.validateFolderName; }
 });
 //# sourceMappingURL=file-browser.cjs.map
 //# sourceMappingURL=file-browser.cjs.map

package/dist/file-browser.js

@@ -1,4 +1,5 @@
-export { FileBrowser, FileBrowserNewFolder, useFileBrowser, validateFolderName } from './chunk-XS3EIQFP.js';
+export { FileBrowser, FileBrowserNewFolder, useFileBrowser, validateFolderName } from './chunk-WZAKEJDL.js';
+import './chunk-S42OGG43.js';
 import './chunk-EDYAXGUM.js';
 import './chunk-MMW2JGKZ.js';
 //# sourceMappingURL=file-browser.js.map

package/dist/{index-XR5t8bTq.d.ts → index-BAtF94lw.d.ts}

@@ -1,5 +1,6 @@
 import * as react from 'react';
 import { HTMLAttributes, ReactNode } from 'react';
+import { a as SubmitResult } from './use-acknowledged-submit-7nC0vSCP.js';
 import { C as ComposerPastePreview, a as ComposerPasteClassNames } from './PastePills.types-CpXzsuwJ.js';
 
 /**
@@ -68,6 +69,21 @@ interface PromptSetDraftOptions {
      * (genie#1235 was exactly that).
      */
     focus?: boolean;
+    /**
+     * With `focus: true`: whether the browser may scroll to reveal the composer.
+     * Default `true` (no scrolling): a bare `el.focus()` scrolls EVERY scrollable
+     * ancestor up to the document, which scrolled a whole host window
+     * (genie#1290). Pass `false` to let it scroll.
+     */
+    preventScroll?: boolean;
+}
+/** Options for `PromptInputHandle.focus()`. Mirrors the DOM's `FocusOptions`. */
+interface PromptFocusOptions {
+    /**
+     * Default `true`: focusing never scrolls the page or any ancestor
+     * (genie#1290). Pass `false` to let the browser scroll the composer into view.
+     */
+    preventScroll?: boolean;
 }
 /** The imperative handle a `ref` on `PromptInput` receives. */
 interface PromptInputHandle {
@@ -79,8 +95,11 @@ interface PromptInputHandle {
      * A draft whose `v` this release does not know is refused with a warning.
      */
     setDraft(draft: PromptDraft, options?: PromptSetDraftOptions): void;
-    /** Focus the composer, caret at the end. */
-    focus(): void;
+    /**
+     * Focus the composer, caret at the end. Does not scroll anything unless
+     * `{ preventScroll: false }`.
+     */
+    focus(options?: PromptFocusOptions): void;
 }
 /**
  * Read a File as a `data:` URL. Pass it as `persistAttachment` to keep the bytes
@@ -275,8 +294,53 @@ interface PromptInputProps extends Omit<HTMLAttributes<HTMLDivElement>, "onSubmi
      * true key gets named.
      */
     platform?: FancyPlatform;
-    /** Called on ⌘/Ctrl+Enter or send button. */
-    onSubmit: (text: string, attachments: PromptAttachment[]) => void;
+    /**
+     * Called on ⌘/Ctrl+Enter or send button.
+     *
+     * **Return nothing and the draft empties at once, as it always has.**
+     *
+     * Return a Promise to make the send acknowledged: the text, pills and
+     * attachments stay, the send button is disabled and `aria-busy`, and a second
+     * send is refused until it settles. The text stays editable meanwhile.
+     *
+     * - Resolves (to anything but `{ ok: false }`) → the draft empties in one
+     *   commit, unless the person changed it while the send was in flight; their
+     *   newer draft is kept.
+     * - Rejects, or resolves `{ ok: false, error? }` → the draft is kept,
+     *   `onSubmitError` is called and the failure is announced to screen readers.
+     *
+     * With a controlled `value` or `draft` the reset reaches the host through
+     * `onChange("")` / `onDraftChange(empty)` like any other change, and the host
+     * decides whether to apply it.
+     */
+    onSubmit: (text: string, attachments: PromptAttachment[]) => void | Promise<SubmitResult>;
+    /**
+     * Called when a Promise from `onSubmit` rejects (with the reason) or resolves
+     * `{ ok: false }` (with its `error`, or `undefined`). The draft is kept.
+     */
+    onSubmitError?: (error: unknown) => void;
+    /** Disables the text, attaching, dropping and the send. */
+    disabled?: boolean;
+    /**
+     * Disables only the send: the text stays editable and attachable, and
+     * ⌘/Ctrl+Enter does not send. For "the agent is still answering, but you can
+     * write the next message".
+     */
+    sendDisabled?: boolean;
+    /**
+     * Form field name for the text. On the textarea itself; with inline pills on
+     * (`pasteThreshold` / `pasteImages`), on a hidden input carrying the expanded
+     * text, since a contenteditable is not a form field.
+     */
+    name?: string;
+    /**
+     * `id` of the text field (textarea or inline editor). `id` itself names the
+     * root, as it always has. It is the one handle that does not change when inline
+     * pills switch the field type. Without it the field is found by
+     * `data-react-fancy-prompt-input-textarea` or, with inline pills,
+     * `data-react-fancy-composer-input`.
+     */
+    inputId?: string;
     /**
      * Placeholder text. Defaults to a hint naming the modifier THIS platform
      * actually has, so leaving it unset is the better option — a hardcoded
@@ -348,4 +412,4 @@ interface PromptInputProps extends Omit<HTMLAttributes<HTMLDivElement>, "onSubmi
 }
 declare const PromptInput: react.ForwardRefExoticComponent<PromptInputProps & react.RefAttributes<PromptInputHandle>>;
 
-export { type FancyPlatform as F, type PlatformHints as P, type PromptAttachment as a, type PromptCmd as b, type PromptDraft as c, type PromptDraftFile as d, type PromptDraftPill as e, PromptInput as f, type PromptInputHandle as g, type PromptInputProps as h, type PromptMention as i, type PromptSetDraftOptions as j, browserPlatformHints as k, detectPlatform as l, modifierKeyLabel as m, promptFileToDataUrl as n, promptDataUrlToFile as p };
+export { type FancyPlatform as F, type PlatformHints as P, type PromptAttachment as a, type PromptCmd as b, type PromptDraft as c, type PromptDraftFile as d, type PromptDraftPill as e, type PromptFocusOptions as f, PromptInput as g, type PromptInputHandle as h, type PromptInputProps as i, type PromptMention as j, type PromptSetDraftOptions as k, browserPlatformHints as l, detectPlatform as m, modifierKeyLabel as n, promptFileToDataUrl as o, promptDataUrlToFile as p };

package/dist/{index-DWtSViJ3.d.cts → index-xwL2MACB.d.cts}

@@ -1,5 +1,6 @@
 import * as react from 'react';
 import { HTMLAttributes, ReactNode } from 'react';
+import { a as SubmitResult } from './use-acknowledged-submit-7nC0vSCP.cjs';
 import { C as ComposerPastePreview, a as ComposerPasteClassNames } from './PastePills.types-CpXzsuwJ.cjs';
 
 /**
@@ -68,6 +69,21 @@ interface PromptSetDraftOptions {
      * (genie#1235 was exactly that).
      */
     focus?: boolean;
+    /**
+     * With `focus: true`: whether the browser may scroll to reveal the composer.
+     * Default `true` (no scrolling): a bare `el.focus()` scrolls EVERY scrollable
+     * ancestor up to the document, which scrolled a whole host window
+     * (genie#1290). Pass `false` to let it scroll.
+     */
+    preventScroll?: boolean;
+}
+/** Options for `PromptInputHandle.focus()`. Mirrors the DOM's `FocusOptions`. */
+interface PromptFocusOptions {
+    /**
+     * Default `true`: focusing never scrolls the page or any ancestor
+     * (genie#1290). Pass `false` to let the browser scroll the composer into view.
+     */
+    preventScroll?: boolean;
 }
 /** The imperative handle a `ref` on `PromptInput` receives. */
 interface PromptInputHandle {
@@ -79,8 +95,11 @@ interface PromptInputHandle {
      * A draft whose `v` this release does not know is refused with a warning.
      */
     setDraft(draft: PromptDraft, options?: PromptSetDraftOptions): void;
-    /** Focus the composer, caret at the end. */
-    focus(): void;
+    /**
+     * Focus the composer, caret at the end. Does not scroll anything unless
+     * `{ preventScroll: false }`.
+     */
+    focus(options?: PromptFocusOptions): void;
 }
 /**
  * Read a File as a `data:` URL. Pass it as `persistAttachment` to keep the bytes
@@ -275,8 +294,53 @@ interface PromptInputProps extends Omit<HTMLAttributes<HTMLDivElement>, "onSubmi
      * true key gets named.
      */
     platform?: FancyPlatform;
-    /** Called on ⌘/Ctrl+Enter or send button. */
-    onSubmit: (text: string, attachments: PromptAttachment[]) => void;
+    /**
+     * Called on ⌘/Ctrl+Enter or send button.
+     *
+     * **Return nothing and the draft empties at once, as it always has.**
+     *
+     * Return a Promise to make the send acknowledged: the text, pills and
+     * attachments stay, the send button is disabled and `aria-busy`, and a second
+     * send is refused until it settles. The text stays editable meanwhile.
+     *
+     * - Resolves (to anything but `{ ok: false }`) → the draft empties in one
+     *   commit, unless the person changed it while the send was in flight; their
+     *   newer draft is kept.
+     * - Rejects, or resolves `{ ok: false, error? }` → the draft is kept,
+     *   `onSubmitError` is called and the failure is announced to screen readers.
+     *
+     * With a controlled `value` or `draft` the reset reaches the host through
+     * `onChange("")` / `onDraftChange(empty)` like any other change, and the host
+     * decides whether to apply it.
+     */
+    onSubmit: (text: string, attachments: PromptAttachment[]) => void | Promise<SubmitResult>;
+    /**
+     * Called when a Promise from `onSubmit` rejects (with the reason) or resolves
+     * `{ ok: false }` (with its `error`, or `undefined`). The draft is kept.
+     */
+    onSubmitError?: (error: unknown) => void;
+    /** Disables the text, attaching, dropping and the send. */
+    disabled?: boolean;
+    /**
+     * Disables only the send: the text stays editable and attachable, and
+     * ⌘/Ctrl+Enter does not send. For "the agent is still answering, but you can
+     * write the next message".
+     */
+    sendDisabled?: boolean;
+    /**
+     * Form field name for the text. On the textarea itself; with inline pills on
+     * (`pasteThreshold` / `pasteImages`), on a hidden input carrying the expanded
+     * text, since a contenteditable is not a form field.
+     */
+    name?: string;
+    /**
+     * `id` of the text field (textarea or inline editor). `id` itself names the
+     * root, as it always has. It is the one handle that does not change when inline
+     * pills switch the field type. Without it the field is found by
+     * `data-react-fancy-prompt-input-textarea` or, with inline pills,
+     * `data-react-fancy-composer-input`.
+     */
+    inputId?: string;
     /**
      * Placeholder text. Defaults to a hint naming the modifier THIS platform
      * actually has, so leaving it unset is the better option — a hardcoded
@@ -348,4 +412,4 @@ interface PromptInputProps extends Omit<HTMLAttributes<HTMLDivElement>, "onSubmi
 }
 declare const PromptInput: react.ForwardRefExoticComponent<PromptInputProps & react.RefAttributes<PromptInputHandle>>;
 
-export { type FancyPlatform as F, type PlatformHints as P, type PromptAttachment as a, type PromptCmd as b, type PromptDraft as c, type PromptDraftFile as d, type PromptDraftPill as e, PromptInput as f, type PromptInputHandle as g, type PromptInputProps as h, type PromptMention as i, type PromptSetDraftOptions as j, browserPlatformHints as k, detectPlatform as l, modifierKeyLabel as m, promptFileToDataUrl as n, promptDataUrlToFile as p };
+export { type FancyPlatform as F, type PlatformHints as P, type PromptAttachment as a, type PromptCmd as b, type PromptDraft as c, type PromptDraftFile as d, type PromptDraftPill as e, type PromptFocusOptions as f, PromptInput as g, type PromptInputHandle as h, type PromptInputProps as i, type PromptMention as j, type PromptSetDraftOptions as k, browserPlatformHints as l, detectPlatform as m, modifierKeyLabel as n, promptFileToDataUrl as o, promptDataUrlToFile as p };