import { type SendShortcut } from '../../core';
import type { ComponentSize, ThemeColor, VisualVariant } from '../../types';
import '../../content/icon/icon';
import '../button/button';
export type { SendShortcut } from '../../core';
/** Events emitted by the message composer */
export type OreMessageComposerEvents = {
    input: InputEvent;
    /**
     * Fired for a send attempt (the resolved `send-shortcut` or the send button) while the
     * composer isn't blank/disabled/loading. Cancelable — call `preventDefault()` to keep the
     * current text in the field instead of the default clear + refocus.
     */
    send: {
        originalEvent: KeyboardEvent | MouseEvent;
        value: string;
    };
};
/** Message composer properties */
export type OreMessageComposerProps = {
    /** Clear the value and refocus after a non-cancelled `send` (default `true`) */
    'clear-on-send'?: boolean;
    /** Theme color (card focus ring + default send button color) */
    color?: ThemeColor;
    /** Disable the whole composer (field, slots, and send action) */
    disabled?: boolean;
    /** Error message shown below the field */
    error?: string;
    /** Stretch the composer to the full width of its container */
    fullwidth?: boolean;
    /** Helper text shown below the field */
    helper?: string;
    /** Accessible name for the field — never rendered visually, only as `aria-label` */
    label?: string;
    /** Blocks further sends (e.g. a send is already in flight) without disabling editing */
    loading?: boolean;
    /** Maximum character count; shows a counter */
    maxlength?: number;
    /** Form field name */
    name?: string;
    /** Placeholder text */
    placeholder?: string;
    /** Make the field read-only */
    readonly?: boolean;
    /**
     * JS-only callback fired with the inner `<textarea>` element when it mounts, and with
     * `null` when it unmounts. Set as a JS property: `composer.ref = (el) => { ... }`.
     */
    ref?: ((el: HTMLTextAreaElement | null) => void) | null;
    /** Require a non-blank value for native form validation */
    required?: boolean;
    /** Number of visible rows before auto-resize grows the field */
    rows?: number;
    /** Lucide icon name for the default send button (default `'arrow-up'`) */
    'send-icon'?: string;
    /** Accessible label for the send button (default `'Send message'`) */
    'send-label'?: string;
    /** Keyboard shortcut that sends: 'enter' (Shift+Enter for a newline) or 'mod+enter' (Enter always inserts a newline; Ctrl/Cmd+Enter sends) */
    'send-shortcut'?: SendShortcut;
    /** Component size */
    size?: ComponentSize;
    /**
     * Shows an inline green check icon inside the field to confirm the value has
     * passed validation. Ignored while `error` is set — an error always wins.
     */
    success?: boolean;
    /** Current text value */
    value?: string;
    /** Visual variant of the card — same variant set as `ore-textarea`, applied to the card. */
    variant?: Exclude<VisualVariant, 'frost' | 'text'>;
};
/**
 * A message/comment composer — a card with an auto-resizing field on top and a toolbar row
 * below it, built directly on the same core primitives as `ore-textarea` (`createTextField`,
 * `createAutoResize`) rather than composing `ore-textarea` itself. Nesting a fully-styled sibling
 * component and suppressing most of its chrome (as an earlier version of this component did) is
 * a leaky composition — this owns its single `<textarea>` outright, so there's exactly one
 * implementation of the field's appearance to reason about, not two fighting each other.
 *
 * Handles the send gesture (Enter to send, Shift+Enter for a newline, or a Ctrl/Cmd+Enter
 * alternative), IME-safe composition, and clear-and-refocus after sending.
 *
 * @element ore-message-composer
 *
 * @attr {string} value - Current text value
 * @attr {string} placeholder - Placeholder text
 * @attr {string} label - Accessible name for the field (not rendered visually)
 * @attr {string} name - Form field name
 * @attr {string} helper - Helper text shown below the field
 * @attr {string} error - Error message shown below the field
 * @attr {boolean} success - Show an inline success check icon (suppressed while `error` is set)
 * @attr {boolean} disabled - Disable the whole composer
 * @attr {boolean} readonly - Read-only mode
 * @attr {boolean} required - Require a non-blank value for native form validation
 * @attr {boolean} loading - Blocks further sends without disabling editing
 * @attr {number} maxlength - Max character count; shows a counter
 * @attr {number} rows - Visible rows before auto-resize grows the field (default 1)
 * @attr {string} color - Theme color: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'
 * @attr {string} variant - Visual variant of the card: 'solid' | 'flat' | 'bordered' | 'outline' | 'ghost'
 * @attr {string} size - 'sm' | 'md' | 'lg'
 * @attr {boolean} fullwidth - Stretch to the full width of the container
 * @attr {string} send-icon - Lucide icon name for the default send button (default 'arrow-up')
 * @attr {string} send-label - Accessible label for the send button (default 'Send message')
 * @attr {string} send-shortcut - 'enter' (default) | 'mod+enter'
 * @attr {boolean} clear-on-send - Clear the value and refocus after a non-cancelled send (default true)
 *
 * @fires input - Fired on every keystroke. detail: { value, originalEvent }
 * @fires send - Fired on a send attempt. Cancelable. detail: { value, originalEvent }
 *
 * @slot prefix - Content at the start of the toolbar row (e.g. an attach menu)
 * @slot suffix - Content at the end of the toolbar row, before the send button (e.g. a model picker)
 * @slot send - Replaces the default send button entirely — the only supported way to customize it
 *
 * @cssprop --message-composer-bg - Card background color
 * @cssprop --message-composer-border-color - Card border color
 * @cssprop --message-composer-radius - Card border radius
 * @cssprop --message-composer-padding - Card inner padding
 * @cssprop --message-composer-gap - Gap between the field/toolbar rows and between toolbar items
 * @cssprop --message-composer-placeholder-color - Field placeholder text color
 * @cssprop --message-composer-min-height - Minimum field height (default one line)
 * @cssprop --message-composer-hover-bg - Card background on hover (flat/ghost variants)
 * @cssprop --message-composer-hover-border-color - Card border on hover (flat/bordered variants)
 * @cssprop --message-composer-focus-bg - Card background when focused (flat variant)
 * @cssprop --message-composer-focus-border-color - Card border when focused (flat variant)
 *
 * @part composer - Root card container
 * @part field - The native `<textarea>` element
 * @part status-icon - The inline error/success icon shown inside the field
 * @part helper - Helper text element
 * @part error - Error text element (`role="alert"`)
 * @part toolbar - Toolbar row below the field
 * @part toolbar-start - Toolbar group holding the `prefix` slot
 * @part toolbar-end - Toolbar group holding the `suffix` slot and the send button
 * @part send-button - The default send button (absent when the `send` slot is used)
 *
 * @example
 * ```html
 * <ore-message-composer placeholder="Message…" send-shortcut="mod+enter"></ore-message-composer>
 * ```
 */
export declare const MESSAGE_COMPOSER_TAG: "ore-message-composer";
//# sourceMappingURL=message-composer.d.ts.map