@assistant-ui/react/dist/unstable/useComposerInput.js

Open-source TypeScript/React library for building production-grade AI chat experiences

"use client";
import { useComposerInputDisabled, useComposerInputValue, useTriggerPopoverAriaProps } from "../primitives/composer/useComposerInputState.js";
import { useComposerSend } from "@assistant-ui/core/react";
import { useCallback } from "@assistant-ui/tap/react-shim";
import { useAui } from "@assistant-ui/store";
import { flushTapSync } from "@assistant-ui/tap";
// src/unstable/useComposerInput.ts
/**
* Headless bridge to the composer's text value and send action, for building a
* custom composer input without `ComposerPrimitive.Input`. It is a thin bridge,
* not a second input: it does not own keyboard behavior, autosize, IME or
* contentEditable sync, paste/drop attachments, focus management, or rich-text
* state. Spread `unstable_useTriggerPopoverAriaProps()` onto your element for
* trigger-popover combobox semantics.
*
* @deprecated Experimental since 2026-06-23. Not scheduled for removal; the API may change in any release.
*
* @example
* ```tsx
* const { value, setText, send, isDisabled, canSend } = unstable_useComposerInput();
* <textarea
*   value={value}
*   disabled={isDisabled}
*   onChange={(e) => setText(e.target.value)}
*   onKeyDown={(e) => {
*     if (e.nativeEvent.isComposing || e.keyCode === 229) return;
*
*     if (e.key === "Enter" && !e.shiftKey && canSend) {
*       e.preventDefault();
*       send();
*     }
*   }}
* />
* ```
*/
function unstable_useComposerInput(options) {
	const aui = useAui();
	const value = useComposerInputValue();
	const isDisabled = useComposerInputDisabled(options?.disabled);
	const setText = useCallback((text) => {
		if (!aui.composer.getState().isEditing) return;
		flushTapSync(() => {
			aui.composer.setText(text, { origin: "user" });
		});
	}, [aui]);
	const { send: rawSend, disabled: sendDisabled } = useComposerSend();
	const canSend = !sendDisabled && !isDisabled;
	return {
		value,
		setText,
		send: useCallback((sendOptions) => {
			if (!canSend) return;
			rawSend(sendOptions);
		}, [canSend, rawSend]),
		isDisabled,
		canSend
	};
}
/**
* ARIA combobox attributes for the focused element (typically the composer
* input) describing the open trigger popover, per the WAI-ARIA editable
* combobox pattern. Returns an empty object outside a `TriggerPopoverRoot` or
* when no popover is open. Spread these last so they take precedence over any
* matching ARIA props you set yourself, mirroring `ComposerPrimitive.Input`.
*
* @deprecated Experimental since 2026-06-23. Not scheduled for removal; the API may change in any release.
*
* @example
* ```tsx
* const aria = unstable_useTriggerPopoverAriaProps();
* <textarea {...aria} />
* ```
*/
function unstable_useTriggerPopoverAriaProps() {
	return useTriggerPopoverAriaProps();
}
export { unstable_useComposerInput, unstable_useTriggerPopoverAriaProps };

//# sourceMappingURL=useComposerInput.js.map