@mieweb/ui 0.8.0-dev.17 → 0.8.0-dev.19

package/dist/index.d.cts

@@ -3250,6 +3250,11 @@ interface ChatComposerHandle {
     addFiles: (files: File[]) => void;
     /** Focus the text input. */
     focus: () => void;
+    /**
+     * The underlying textarea element, for host integrations that need caret
+     * access (e.g. mention insertion via `setSelectionRange`).
+     */
+    getTextarea: () => HTMLTextAreaElement | null;
 }
 /** Structured context passed to `onError` so hosts can localize by reason. */
 interface ChatComposerError {
@@ -3280,6 +3285,27 @@ interface ChatComposerProps {
     maxLength?: number;
     /** Show a character counter (requires `maxLength`). */
     showCharacterCount?: boolean;
+    /**
+     * Allow sending while the composer itself is empty (e.g. when the host
+     * stages attachments outside the composer). The host receives a message
+     * with empty `content` and no attachments and owns any further guarding.
+     * @default false
+     */
+    canSendWhenEmpty?: boolean;
+    /**
+     * Maximum height of the auto-growing input: a pixel number or any CSS
+     * length (e.g. `'40vh'`).
+     * @default 160
+     */
+    maxHeight?: number | string;
+    /**
+     * Extra props spread onto the underlying textarea. Event handlers run
+     * before the composer's built-in handlers; call `event.preventDefault()`
+     * in `onKeyDown` / `onPaste` to claim that event (e.g. for a mention
+     * menu's arrow/Enter navigation). `className` and `style` are merged
+     * with the composer's own.
+     */
+    textareaProps?: Omit<React$1.TextareaHTMLAttributes<HTMLTextAreaElement>, 'value' | 'defaultValue'>;
     /** Extra entries for the `+` menu, rendered after the built-in items. */
     addMenuItems?: ChatComposerMenuItem[];
     /** Enable file attachments (built-in "Attach files" menu item, paste-to-attach, chips). @default true */
@@ -3296,8 +3322,10 @@ interface ChatComposerProps {
     onMicClick?: () => void;
     /**
      * Custom node rendered in place of the built-in mic button (e.g.
-     * `RecordButton`). Rendered as-is: pass your own disabled state when the
-     * composer is `disabled`.
+     * `RecordButton`). The slot is wrapped in a 32px-tall (`h-8`) flex row so it
+     * aligns with the other composer controls; taller content overflows and
+     * stays vertically centered without inflating the row. Interaction state is
+     * not managed: pass your own disabled state when the composer is `disabled`.
      */
     micSlot?: React$1.ReactNode;
     /** When to show the mic: always, or only while the composer is empty. @default 'always' */
@@ -3350,9 +3378,10 @@ interface ChatComposerProps {
     className?: string;
 }
 /**
- * Standardized chat input: an always-available text area on top, a quiet icon
- * toolbar below it (`+` menu, mic, send/stop), and an optional bottom row with
- * agent and model selectors.
+ * Standardized chat input. At `md+` it renders as a single-row pill — `+`
+ * menu, text input and actions (mic, send/stop) side by side; below `md` the
+ * input stacks above the icon row. The optional agent/model selector row
+ * hangs below the card on the page background.
  */
 declare const ChatComposer: React$1.ForwardRefExoticComponent<ChatComposerProps & React$1.RefAttributes<ChatComposerHandle>>;
 

package/dist/index.d.ts

@@ -3250,6 +3250,11 @@ interface ChatComposerHandle {
     addFiles: (files: File[]) => void;
     /** Focus the text input. */
     focus: () => void;
+    /**
+     * The underlying textarea element, for host integrations that need caret
+     * access (e.g. mention insertion via `setSelectionRange`).
+     */
+    getTextarea: () => HTMLTextAreaElement | null;
 }
 /** Structured context passed to `onError` so hosts can localize by reason. */
 interface ChatComposerError {
@@ -3280,6 +3285,27 @@ interface ChatComposerProps {
     maxLength?: number;
     /** Show a character counter (requires `maxLength`). */
     showCharacterCount?: boolean;
+    /**
+     * Allow sending while the composer itself is empty (e.g. when the host
+     * stages attachments outside the composer). The host receives a message
+     * with empty `content` and no attachments and owns any further guarding.
+     * @default false
+     */
+    canSendWhenEmpty?: boolean;
+    /**
+     * Maximum height of the auto-growing input: a pixel number or any CSS
+     * length (e.g. `'40vh'`).
+     * @default 160
+     */
+    maxHeight?: number | string;
+    /**
+     * Extra props spread onto the underlying textarea. Event handlers run
+     * before the composer's built-in handlers; call `event.preventDefault()`
+     * in `onKeyDown` / `onPaste` to claim that event (e.g. for a mention
+     * menu's arrow/Enter navigation). `className` and `style` are merged
+     * with the composer's own.
+     */
+    textareaProps?: Omit<React$1.TextareaHTMLAttributes<HTMLTextAreaElement>, 'value' | 'defaultValue'>;
     /** Extra entries for the `+` menu, rendered after the built-in items. */
     addMenuItems?: ChatComposerMenuItem[];
     /** Enable file attachments (built-in "Attach files" menu item, paste-to-attach, chips). @default true */
@@ -3296,8 +3322,10 @@ interface ChatComposerProps {
     onMicClick?: () => void;
     /**
      * Custom node rendered in place of the built-in mic button (e.g.
-     * `RecordButton`). Rendered as-is: pass your own disabled state when the
-     * composer is `disabled`.
+     * `RecordButton`). The slot is wrapped in a 32px-tall (`h-8`) flex row so it
+     * aligns with the other composer controls; taller content overflows and
+     * stays vertically centered without inflating the row. Interaction state is
+     * not managed: pass your own disabled state when the composer is `disabled`.
      */
     micSlot?: React$1.ReactNode;
     /** When to show the mic: always, or only while the composer is empty. @default 'always' */
@@ -3350,9 +3378,10 @@ interface ChatComposerProps {
     className?: string;
 }
 /**
- * Standardized chat input: an always-available text area on top, a quiet icon
- * toolbar below it (`+` menu, mic, send/stop), and an optional bottom row with
- * agent and model selectors.
+ * Standardized chat input. At `md+` it renders as a single-row pill — `+`
+ * menu, text input and actions (mic, send/stop) side by side; below `md` the
+ * input stacks above the icon row. The optional agent/model selector row
+ * hangs below the card on the page background.
  */
 declare const ChatComposer: React$1.ForwardRefExoticComponent<ChatComposerProps & React$1.RefAttributes<ChatComposerHandle>>;