@refraction-ui/react 0.16.2 → 0.17.1

package/dist/internal/react-composer/index.d.ts

@@ -0,0 +1,131 @@
+import * as React from 'react';
+import { ComposerTrigger, ComposerCandidate, ComposerAttachmentDraft, ComposerDraftStore, ComposerValidator, ComposerSubmission, ComposerAttachment, ComposerEvent, ComposerAPI, ComposerState, ComposerConfig } from '../composer/index.js';
+export { ComposerAPI, ComposerAttachment, ComposerAttachmentDraft, ComposerAttachmentKind, ComposerAttachmentStatus, ComposerCandidate, ComposerConfig, ComposerDraft, ComposerDraftStore, ComposerEvent, ComposerMode, ComposerOutput, ComposerSelection, ComposerState, ComposerSubmission, ComposerToken, ComposerTrigger, ComposerTriggerResolver, ComposerTriggerScope, ComposerValidationResult, ComposerValidator, CounterState, EnterResult, PlacedToken, ResolvedToken, SuggestionState, composerAttachmentChipVariants, composerCounterVariants, composerFieldClass, composerMenuClass, composerMenuItemVariants, composerPrimaryActionVariants, composerSurfaceVariants, composerTokenPillClass, composerTrayClass, createComposer, toMessageAttachment } from '../composer/index.js';
+
+/** All user-facing text; every entry is overridable via the `strings` prop. */
+interface RefractionComposerStrings {
+    /** Accessible name of the whole composer landmark. */
+    composerLabel: string;
+    /** Accessible name of the message textarea (independent of the placeholder). */
+    messageLabel: string;
+    sendLabel: string;
+    stopLabel: string;
+    attachLabel: string;
+    removeAttachmentLabel: (name: string) => string;
+    /** Accessible name of the suggestion listbox. */
+    suggestionsLabel: string;
+    noMatchesLabel: (query: string) => string;
+    loadingLabel: string;
+    retryLabel: string;
+    trimmedNotice: string;
+    counterLabel: (remaining: number) => string;
+    editingLabel: string;
+    cancelEditLabel: string;
+    /** Live-region announcement while the suggestion menu shows results. */
+    resultsAnnouncement: (count: number) => string;
+}
+declare const DEFAULT_COMPOSER_STRINGS: RefractionComposerStrings;
+interface PrimaryActionContext {
+    hasText: boolean;
+    canSend: boolean;
+    busy: boolean;
+}
+interface SuggestionRenderContext {
+    active: boolean;
+    index: number;
+}
+interface RefractionComposerProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue' | 'onSubmit' | 'onError' | 'content' | 'placeholder' | 'dir'> {
+    /** Controlled value. When set, the prop wins over internal edits. */
+    value?: string;
+    /** Initial value for uncontrolled usage. */
+    defaultValue?: string;
+    /** Fired with the new text after every user-driven change (incl. submit clearing). */
+    onChange?: (value: string) => void;
+    placeholder?: string;
+    /** Distinct placeholder shown while disabled. Falls back to `placeholder`. */
+    disabledPlaceholder?: string;
+    /** Rows shown when empty. Default 1. */
+    minLines?: number;
+    /** Auto-grow ceiling; the field scrolls internally beyond it. Default 6. */
+    maxLines?: number;
+    /** Grapheme-cluster budget (not UTF-16 units). Fixed at mount. */
+    maxLength?: number;
+    maxAttachments?: number;
+    disabled?: boolean;
+    readOnly?: boolean;
+    /** Busy/streaming: swaps the default send button for a stop button. */
+    busy?: boolean;
+    onStop?: () => void;
+    autoFocus?: boolean;
+    dir?: 'ltr' | 'rtl' | 'auto';
+    /** Trigger configs (mention '@', slash '/', emoji ':', …). Fixed at mount. */
+    triggers?: ComposerTrigger[];
+    /**
+     * Whether a plain Enter submits. Defaults to true (SSR-deterministic);
+     * after mount a coarse pointer (`(pointer: coarse)`) flips the default to
+     * false. An explicit prop always wins.
+     */
+    submitOnEnter?: boolean;
+    strings?: Partial<RefractionComposerStrings>;
+    /** Rendered at the start of the action row (e.g. an attach button). */
+    leading?: React.ReactNode;
+    /** Rendered at the end of the action row, before the primary action. */
+    trailing?: React.ReactNode;
+    /** Replaces the built-in send/stop primary action. */
+    primaryAction?: (context: PrimaryActionContext) => React.ReactNode;
+    /** Custom row content for suggestion menu items. */
+    renderSuggestion?: (candidate: ComposerCandidate, context: SuggestionRenderContext) => React.ReactNode;
+    /** Attachments staged at creation (SSR-deterministic, e.g. restored drafts). */
+    initialAttachments?: ComposerAttachmentDraft[];
+    draftStore?: ComposerDraftStore;
+    draftKey?: string;
+    validator?: ComposerValidator;
+    replyToMessageId?: string;
+    onSubmit?: (submission: ComposerSubmission) => void;
+    /** ArrowUp on an empty field (desktop edit-last affordance). */
+    onEditLastRequested?: () => void;
+    /** Escape pressed while in edit mode (after the core restores the draft). */
+    onEditCancel?: () => void;
+    /** Throttled typing signal (core-owned leading-edge throttle). */
+    onTypingActivity?: () => void;
+    onAttachmentAdd?: (attachment: ComposerAttachment) => void;
+    onAttachmentRejected?: (event: Extract<ComposerEvent, {
+        type: 'attachment-rejected';
+    }>) => void;
+    /** Raw core notice channel ('paste-trimmed', 'insert-rejected', …). */
+    onEvent?: (event: ComposerEvent) => void;
+    /** Receives the composer core for imperative use (beginEdit, addAttachment, …). */
+    apiRef?: React.Ref<ComposerAPI>;
+    id?: string;
+}
+/**
+ * RefractionComposer — the chat message composer.
+ *
+ * Wraps the headless `@refraction-ui/composer` core: flat value + selection,
+ * atomic inline tokens (mention/slash/emoji triggers), attachments, drafts,
+ * busy/stop, edit-in-place, and one optimistic submit. `ref` targets the
+ * textarea; the core is reachable through `apiRef`.
+ */
+declare const RefractionComposer: React.ForwardRefExoticComponent<RefractionComposerProps & React.RefAttributes<HTMLTextAreaElement>>;
+
+interface UseComposerResult {
+    /** Live core snapshot (re-renders on change). */
+    state: ComposerState;
+    /** The underlying composer core, for imperative use (beginEdit, addAttachment, …). */
+    api: ComposerAPI;
+}
+/**
+ * useComposer — binds the headless `createComposer` core to React via
+ * `useSyncExternalStore`. The core is created once with the config of the
+ * first render (the core reads `maxLength`/`maxAttachments`/`validator`/
+ * `replyToMessageId`/draft fields lazily, so callers may mutate a stable
+ * config object to keep those live). The core is destroyed on unmount and
+ * lazily recreated if React StrictMode re-subscribes after that dev-only
+ * unmount/remount cycle.
+ *
+ * @param init Optional one-time initializer invoked right after creation and
+ *   before the first snapshot (e.g. to seed attachments SSR-deterministically).
+ */
+declare function useComposer(config?: ComposerConfig, init?: (api: ComposerAPI) => void): UseComposerResult;
+
+export { DEFAULT_COMPOSER_STRINGS, type PrimaryActionContext, RefractionComposer, type RefractionComposerProps, type RefractionComposerStrings, type SuggestionRenderContext, type UseComposerResult, useComposer };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@refraction-ui/react",
-  "version": "0.16.2",
+  "version": "0.17.1",
   "description": "All Refraction UI React components in one package — headless, accessible, zero-dependency",
   "type": "module",
   "main": "./dist/index.js",
@@ -80,6 +80,7 @@
     "@refraction-ui/react-combobox": "workspace:*",
     "@refraction-ui/react-command": "workspace:*",
     "@refraction-ui/react-command-input": "workspace:*",
+    "@refraction-ui/react-composer": "workspace:*",
     "@refraction-ui/react-content-protection": "workspace:*",
     "@refraction-ui/react-conversation": "workspace:*",
     "@refraction-ui/react-cookie-consent": "workspace:*",