import * as React from 'react';
import type { AgChatStatus } from '../types.js';
import type { ChangeDetails } from '../../contracts/components.js';
import type { AttachmentReject } from './useAttachments.js';
import type { AiIconName } from '../icons/index.js';
export interface ComposerLabels {
    input?: string;
    submit?: string;
    stop?: string;
    attach?: string;
    /** Trigger of the narrow-container (<480 px) actions menu (REQ-SURF-119). */
    moreActions?: string;
    removeAttachment?: (name: string) => string;
    /** REQ-SURF-113: announced politely when `status` becomes `submitted`. */
    statusSending?: string;
    /** REQ-SURF-113: announced assertively when `status` becomes `error`. */
    statusError?: string;
}
export interface ComposerRootProps {
    /** Controlled draft text. Pair with `onValueChange`. */
    value?: string | undefined;
    /** Initial draft text when uncontrolled. */
    defaultValue?: string | undefined;
    /** Called with the new value whenever it changes. */
    onValueChange?: ((value: string, details: ChangeDetails) => void) | undefined;
    /** Chat status: 'submitted' and 'streaming' switch Send to Stop; 'error' is announced assertively. */
    status?: AgChatStatus | undefined;
    /** Called with the draft text and attached files when the user sends. */
    onSubmit?: ((detail: {
        text: string;
        files: File[];
    }) => void) | undefined;
    /** Called when the user stops an in-flight response. */
    onStop?: (() => void) | undefined;
    /** Disables the input, attachments and Send. */
    disabled?: boolean | undefined;
    /** Maximum draft length in characters. */
    maxLength?: number | undefined;
    /** Rows the textarea grows to before it scrolls. */
    maxRows?: number | undefined;
    /** Enter sends and Shift+Enter inserts a newline. */
    submitOnEnter?: boolean | undefined;
    /** Escape stops an in-flight response. */
    stopOnEscape?: boolean | undefined;
    /** Accepted attachment types, in the native `accept` attribute format. */
    accept?: string | undefined;
    /** Maximum number of attachments. */
    maxFiles?: number | undefined;
    /** Maximum size of one attachment, in bytes. */
    maxFileSize?: number | undefined;
    /** Called when an attachment is rejected (type, size or count), with the reason. */
    onAttachmentReject?: ((rej: AttachmentReject) => void) | undefined;
    /** Attachments present on mount (uncontrolled), e.g. a restored draft. */
    defaultFiles?: readonly File[] | undefined;
    /** Overrides for the built-in, localizable UI strings. */
    labels?: ComposerLabels | undefined;
    /** Class name merged onto the root element. */
    className?: string | undefined;
    /** Content rendered inside the component. */
    children?: React.ReactNode;
    /** Ref to the rendered root element. */
    ref?: React.Ref<HTMLFormElement>;
}
/** REQ-SURF-116..119: form root owning value/status/attachments context. */
export declare function ComposerRoot({ value: valueProp, defaultValue, onValueChange, status, onSubmit, onStop, disabled, maxLength, maxRows, submitOnEnter, stopOnEscape, accept, maxFiles, maxFileSize, onAttachmentReject, defaultFiles, labels, className, children, ref, }: ComposerRootProps): React.JSX.Element;
/**
 * REQ-SURF-116/119: Base UI Field (visually hidden `<label for>`) around the
 * textarea. Growth is `field-sizing: content` capped at `maxRows` lines by
 * ai.css; without field-sizing the height is measured from scrollHeight.
 */
export declare function ComposerTextarea({ maxRows, submitOnEnter, stopOnEscape, }: {
    maxRows?: number;
    submitOnEnter?: boolean;
    stopOnEscape?: boolean;
}): React.JSX.Element;
export declare function ComposerAttachments(): React.JSX.Element | null;
export declare function ComposerAction({ kind, icon, onClick, ...rest }: Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'onChange'> & {
    kind?: 'attach' | 'custom' | undefined;
    icon?: AiIconName;
}): React.JSX.Element;
/**
 * REQ-SURF-119: below a 480 px container the `Composer.Action` buttons are
 * hidden by ai.css and reached through this one leading CMP Menu instead;
 * Submit/Stop stay visible. Above 480 px the menu itself is hidden.
 */
export declare function ComposerMenu(): React.JSX.Element | null;
export declare function ComposerActions({ children }: {
    children?: React.ReactNode;
}): React.JSX.Element;
export declare function ComposerSubmit(props: Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'onChange'>): React.JSX.Element;
/** REQ-SURF-119: `{length}/{maxLength}`; speech goes only through the
    provider announcer, once at 90% and once at 100% (no own live region). */
export declare function ComposerCounter(): React.JSX.Element | null;
export interface ComposerComponent {
    (props: ComposerRootProps): React.ReactElement;
    Root: typeof ComposerRoot;
    Textarea: typeof ComposerTextarea;
    Attachments: typeof ComposerAttachments;
    Actions: typeof ComposerActions;
    Action: typeof ComposerAction;
    Menu: typeof ComposerMenu;
    Submit: typeof ComposerSubmit;
    Counter: typeof ComposerCounter;
}
export declare const Composer: ComposerComponent;
//# sourceMappingURL=Composer.d.ts.map