aeon-ui-engine 1.3.1 → 1.4.0

package/packages/react/dist/index.d.ts

@@ -1,11 +1,11 @@
 import * as react from 'react';
 import { ButtonHTMLAttributes, ReactNode, HTMLAttributes, InputHTMLAttributes, LabelHTMLAttributes, TextareaHTMLAttributes, RefObject, ImgHTMLAttributes, FormHTMLAttributes } from 'react';
-import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as xstate from 'xstate';
 import { AnyStateMachine } from 'xstate';
+import { useMachine } from '@xstate/react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 import { AsyncContext, ContentRegionState, AppNavChild, StickyBarState } from '@aeon-ui/primitives';
 export { AppNavChild, AppNavContext, createAsyncMachine, fieldMachine } from '@aeon-ui/primitives';
-import { useMachine } from '@xstate/react';
 import { fieldFace, AeonColorMode, ResponsiveLayoutSpec, LayoutMode, LayoutCompositionSpec } from '@aeon-ui/core';
 export { AeonColorMode as AeonMode } from '@aeon-ui/core';
 
@@ -16,6 +16,11 @@ interface ButtonRootProps extends ButtonHTMLAttributes<HTMLButtonElement> {
     size?: 'xs' | 'sm' | 'md' | 'lg';
     /** Machine-aligned lifecycle; `disabled` prop overrides to `disabled`. */
     status?: ButtonStatus;
+    /**
+     * Merge button attrs onto a single child (e.g. Next.js `<Link>` / `<a>`).
+     * Child must be one React element.
+     */
+    asChild?: boolean;
     children?: ReactNode;
 }
 declare const Button: {
@@ -104,6 +109,9 @@ declare const Prompt: {
     Eyebrow: react.ForwardRefExoticComponent<HTMLAttributes<HTMLParagraphElement> & react.RefAttributes<HTMLParagraphElement>>;
     Meta: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDListElement> & react.RefAttributes<HTMLDListElement>>;
     Amount: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Verb: react.ForwardRefExoticComponent<HTMLAttributes<HTMLParagraphElement> & react.RefAttributes<HTMLParagraphElement>>;
+    Recipient: react.ForwardRefExoticComponent<HTMLAttributes<HTMLParagraphElement> & react.RefAttributes<HTMLParagraphElement>>;
+    Effect: react.ForwardRefExoticComponent<HTMLAttributes<HTMLParagraphElement> & react.RefAttributes<HTMLParagraphElement>>;
     Actions: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
     Primary: react.ForwardRefExoticComponent<ButtonHTMLAttributes<HTMLButtonElement> & react.RefAttributes<HTMLButtonElement>>;
     Secondary: react.ForwardRefExoticComponent<ButtonHTMLAttributes<HTMLButtonElement> & react.RefAttributes<HTMLButtonElement>>;
@@ -205,6 +213,67 @@ declare const Slider: {
     ValueText: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
 };
 
+type ThumbIndex = 0 | 1;
+interface RangeSliderRootProps {
+    value?: [number, number];
+    defaultValue?: [number, number];
+    min?: number;
+    max?: number;
+    step?: number;
+    minStepsBetween?: number;
+    disabled?: boolean;
+    onValueChange?: (value: [number, number]) => void;
+    children?: ReactNode;
+    className?: string;
+}
+interface RangeSliderThumbProps extends HTMLAttributes<HTMLSpanElement> {
+    index: ThumbIndex;
+}
+declare const RangeSlider: {
+    Root: react.ForwardRefExoticComponent<RangeSliderRootProps & react.RefAttributes<HTMLDivElement>>;
+    Track: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Range: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Thumb: react.ForwardRefExoticComponent<RangeSliderThumbProps & react.RefAttributes<HTMLSpanElement>>;
+    ValueText: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+};
+
+/** Bridge executable statecharts to React — UI = f(snapshot). */
+declare function useAeonMachine<M extends AnyStateMachine>(machine: M, options?: Parameters<typeof useMachine<M>>[1]): [xstate.StateFrom<M>, (event: xstate.EventFromLogic<M>) => void, xstate.Actor<M>];
+
+interface FileUploadContextValue {
+    phase: 'idle' | 'dragging' | 'rejected';
+    accept: string;
+    disabled: boolean;
+    file: File | null;
+    inputId: string;
+    inputRef: React.RefObject<HTMLInputElement | null>;
+    send: ReturnType<typeof useAeonMachine<typeof fileUploadMachine>>[1];
+    selectFile: (file: File | null) => void;
+    clear: () => void;
+    openPicker: () => void;
+}
+declare function useFileUploadCtx(): FileUploadContextValue;
+interface FileUploadRootProps {
+    accept?: string;
+    disabled?: boolean;
+    /** Controlled selected file (bytes stay outside the machine). */
+    file?: File | null;
+    defaultFile?: File | null;
+    onFileSelect?: (file: File | null) => void;
+    children?: ReactNode;
+    className?: string;
+}
+declare const FileUpload: {
+    Root: react.ForwardRefExoticComponent<FileUploadRootProps & react.RefAttributes<HTMLDivElement>>;
+    Label: react.ForwardRefExoticComponent<HTMLAttributes<HTMLLabelElement> & react.RefAttributes<HTMLLabelElement>>;
+    Dropzone: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Input: react.ForwardRefExoticComponent<InputHTMLAttributes<HTMLInputElement> & react.RefAttributes<HTMLInputElement>>;
+    Hint: react.ForwardRefExoticComponent<HTMLAttributes<HTMLParagraphElement> & react.RefAttributes<HTMLParagraphElement>>;
+    Preview: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    ClearTrigger: react.ForwardRefExoticComponent<HTMLAttributes<HTMLButtonElement> & react.RefAttributes<HTMLButtonElement>>;
+    RejectionMessage: react.ForwardRefExoticComponent<HTMLAttributes<HTMLParagraphElement> & react.RefAttributes<HTMLParagraphElement>>;
+};
+
 interface PinInputRootProps {
     length?: number;
     value?: string;
@@ -275,9 +344,6 @@ interface AsyncRootProps extends HTMLAttributes<HTMLDivElement> {
 }
 declare const AsyncRoot: react.ForwardRefExoticComponent<AsyncRootProps & react.RefAttributes<HTMLDivElement>>;
 
-/** Bridge executable statecharts to React — UI = f(snapshot). */
-declare function useAeonMachine<M extends AnyStateMachine>(machine: M, options?: Parameters<typeof useMachine<M>>[1]): [xstate.StateFrom<M>, (event: xstate.EventFromLogic<M>) => void, xstate.Actor<M>];
-
 declare const defaultMachine: xstate.StateMachine<AsyncContext<unknown>, {
     type: "FETCH";
 } | {
@@ -703,40 +769,40 @@ declare const Entry: {
     List: react.ForwardRefExoticComponent<EntryListProps & react.RefAttributes<HTMLDivElement>>;
     Root: react.ForwardRefExoticComponent<EntryRootProps & react.RefAttributes<HTMLElement>>;
     Header: react.ForwardRefExoticComponent<HTMLAttributes<HTMLElement> & {
-        as?: "span" | "div" | "footer" | "header" | "p";
+        as?: "div" | "footer" | "header" | "p" | "span";
     } & react.RefAttributes<HTMLElement>>;
     Leading: react.ForwardRefExoticComponent<HTMLAttributes<HTMLElement> & {
-        as?: "span" | "div" | "footer" | "header" | "p";
+        as?: "div" | "footer" | "header" | "p" | "span";
     } & react.RefAttributes<HTMLElement>>;
     Heading: react.ForwardRefExoticComponent<HTMLAttributes<HTMLElement> & {
-        as?: "span" | "div" | "footer" | "header" | "p";
+        as?: "div" | "footer" | "header" | "p" | "span";
     } & react.RefAttributes<HTMLElement>>;
     Title: react.ForwardRefExoticComponent<HTMLAttributes<HTMLElement> & {
-        as?: "span" | "div" | "footer" | "header" | "p";
+        as?: "div" | "footer" | "header" | "p" | "span";
     } & react.RefAttributes<HTMLElement>>;
     Subtitle: react.ForwardRefExoticComponent<HTMLAttributes<HTMLElement> & {
-        as?: "span" | "div" | "footer" | "header" | "p";
+        as?: "div" | "footer" | "header" | "p" | "span";
     } & react.RefAttributes<HTMLElement>>;
     Meta: react.ForwardRefExoticComponent<HTMLAttributes<HTMLElement> & {
-        as?: "span" | "div" | "footer" | "header" | "p";
+        as?: "div" | "footer" | "header" | "p" | "span";
     } & react.RefAttributes<HTMLElement>>;
     Media: react.ForwardRefExoticComponent<HTMLAttributes<HTMLElement> & {
-        as?: "span" | "div" | "footer" | "header" | "p";
+        as?: "div" | "footer" | "header" | "p" | "span";
     } & react.RefAttributes<HTMLElement>>;
     Body: react.ForwardRefExoticComponent<HTMLAttributes<HTMLElement> & {
-        as?: "span" | "div" | "footer" | "header" | "p";
+        as?: "div" | "footer" | "header" | "p" | "span";
     } & react.RefAttributes<HTMLElement>>;
     Values: react.ForwardRefExoticComponent<HTMLAttributes<HTMLElement> & {
-        as?: "span" | "div" | "footer" | "header" | "p";
+        as?: "div" | "footer" | "header" | "p" | "span";
     } & react.RefAttributes<HTMLElement>>;
     Value: react.ForwardRefExoticComponent<HTMLAttributes<HTMLElement> & {
-        as?: "span" | "div" | "footer" | "header" | "p";
+        as?: "div" | "footer" | "header" | "p" | "span";
     } & react.RefAttributes<HTMLElement>>;
     Actions: react.ForwardRefExoticComponent<HTMLAttributes<HTMLElement> & {
-        as?: "span" | "div" | "footer" | "header" | "p";
+        as?: "div" | "footer" | "header" | "p" | "span";
     } & react.RefAttributes<HTMLElement>>;
     Footer: react.ForwardRefExoticComponent<HTMLAttributes<HTMLElement> & {
-        as?: "span" | "div" | "footer" | "header" | "p";
+        as?: "div" | "footer" | "header" | "p" | "span";
     } & react.RefAttributes<HTMLElement>>;
 };
 
@@ -759,12 +825,15 @@ declare const Conversation: {
     Badge: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
 };
 
+/** Base alignment / delivery states. */
 type ThreadMessageState = 'mine' | 'theirs' | 'pending' | 'failed';
+/** Structured in-thread faces (space-combinable with mine/theirs). */
+type ThreadItemFace = 'command-result' | 'payment-card' | 'request-card';
 interface ThreadRootProps extends HTMLAttributes<HTMLElement> {
     children?: ReactNode;
 }
 interface ThreadItemProps extends HTMLAttributes<HTMLDivElement> {
-    state?: ThreadMessageState | `${ThreadMessageState} ${string}`;
+    state?: ThreadMessageState | ThreadItemFace | `${ThreadMessageState} ${ThreadItemFace}` | string;
 }
 declare const Thread: {
     Root: react.ForwardRefExoticComponent<ThreadRootProps & react.RefAttributes<HTMLElement>>;
@@ -773,9 +842,21 @@ declare const Thread: {
     Bubble: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
     Meta: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
     Day: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Bind: react.ForwardRefExoticComponent<ButtonHTMLAttributes<HTMLButtonElement> & react.RefAttributes<HTMLButtonElement>>;
+    Card: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    CardTitle: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    CardBody: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    CardActions: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
 };
 
-type ComposerState = 'idle' | 'sending' | 'disabled' | 'error';
+/**
+ * Composer root states.
+ * - chat: plain message compose
+ * - command: local slash input (BRC-218) — never from received text
+ * - lookup: non-confirming verbs (/whois, /help)
+ * - idle | sending | disabled | error: transport chrome
+ */
+type ComposerState = 'idle' | 'sending' | 'disabled' | 'error' | 'chat' | 'command' | 'lookup';
 interface ComposerRootProps extends FormHTMLAttributes<HTMLFormElement> {
     state?: ComposerState;
     children?: ReactNode;
@@ -785,6 +866,9 @@ declare const Composer: {
     Input: react.ForwardRefExoticComponent<TextareaHTMLAttributes<HTMLTextAreaElement> & react.RefAttributes<HTMLTextAreaElement>>;
     Actions: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
     Send: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+    Toolbar: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Suggestions: react.ForwardRefExoticComponent<HTMLAttributes<HTMLUListElement> & react.RefAttributes<HTMLUListElement>>;
+    Suggestion: react.ForwardRefExoticComponent<ButtonHTMLAttributes<HTMLButtonElement> & react.RefAttributes<HTMLButtonElement>>;
 };
 
 interface ProfileHeaderRootProps extends HTMLAttributes<HTMLElement> {
@@ -888,19 +972,19 @@ interface AppShellRootProps extends HTMLAttributes<HTMLDivElement> {
 declare const AppShell: {
     Root: react.ForwardRefExoticComponent<AppShellRootProps & react.RefAttributes<HTMLDivElement>>;
     Header: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & {
-        as?: "main" | "div" | "aside" | "footer" | "header";
+        as?: "aside" | "div" | "footer" | "header" | "main";
     } & react.RefAttributes<HTMLDivElement>>;
     Subheader: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & {
-        as?: "main" | "div" | "aside" | "footer" | "header";
+        as?: "aside" | "div" | "footer" | "header" | "main";
     } & react.RefAttributes<HTMLDivElement>>;
     Content: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & {
-        as?: "main" | "div" | "aside" | "footer" | "header";
+        as?: "aside" | "div" | "footer" | "header" | "main";
     } & react.RefAttributes<HTMLDivElement>>;
     Aside: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & {
-        as?: "main" | "div" | "aside" | "footer" | "header";
+        as?: "aside" | "div" | "footer" | "header" | "main";
     } & react.RefAttributes<HTMLDivElement>>;
     Footer: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & {
-        as?: "main" | "div" | "aside" | "footer" | "header";
+        as?: "aside" | "div" | "footer" | "header" | "main";
     } & react.RefAttributes<HTMLDivElement>>;
     Dock: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
     Scrim: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
@@ -1080,4 +1164,12 @@ type FitTextOptions = {
  */
 declare function useFitText(slotRef: RefObject<HTMLElement | null>, contentRef: RefObject<HTMLElement | null>, opts?: FitTextOptions): void;
 
-export { Accordion, type AccordionItemContentProps, type AccordionItemProps, type AccordionItemTriggerProps, type AccordionRootProps, AppNav, type AppNavBreadcrumbProps, type AppNavRootProps, type AppNavSectionProps, AppShell, type AppShellRootProps, Async, AsyncActions, AsyncProvider, AsyncReadout, AsyncRoot, AsyncTrack, Avatar, type AvatarRootProps, type AvatarStatus, Bar, type BarRootProps, Button, type ButtonRootProps, type ButtonStatus, Checkbox, type CheckboxRootProps, Combobox, type ComboboxItemProps, type ComboboxRootProps, Composer, type ComposerRootProps, type ComposerState, Content, type ContentRootProps, Conversation, type ConversationItemProps, type ConversationItemState, type ConversationRootProps, Dialog, type DialogPortalProps, type DialogRootProps, Entry, type EntryListProps, type EntryRootProps, type EntryState, Field, type FieldControlProps, type FieldRootProps, type FieldTextareaProps, Identity, type IdentityRootProps, ListRow, type ListRowRootProps, Menu, type MenuItemProps, type MenuPositionerProps, type MenuRootProps, MetricStrip, type MetricStripRootProps, Nav, type NavItemProps, type NavRootProps, Panel, type PanelContentProps, type PanelGroupProps, type PanelLabelProps, type PanelRootProps, type PanelTriggerProps, PinInput, type PinInputInputProps, type PinInputRootProps, Popover, type PopoverPositionerProps, type PopoverRootProps, type PresenceState, ProfileHeader, type ProfileHeaderRootProps, Progress, type ProgressRootProps, Prompt, type PromptRootProps, type PromptStatus, RadioGroup, type RadioGroupItemProps, type RadioGroupRootProps, Scroll, type ScrollRootProps, type ScrollViewportProps, Select, type SelectContentProps, type SelectItemProps, type SelectPositionerProps, type SelectRootProps, Separator, type SeparatorRootProps, Slider, type SliderRootProps, StatusBanner, type StatusBannerRootProps, type StatusBannerTone, StickyBar, type StickyBarRootProps, Switch, type SwitchRootProps, Tabs, type TabsContentProps, type TabsRootProps, type TabsTriggerProps, ThemeSwitcher, type ThemeSwitcherModeBtnProps, type ThemeSwitcherModesProps, type ThemeSwitcherRootProps, type ThemeSwitcherThemeSelectProps, Thread, type ThreadItemProps, type ThreadMessageState, type ThreadRootProps, Toast, ToastItem, type ToastPlacement, type ToastProviderProps, type ToastPublishOptions, type ToastRecord, type ToastRootProps, type ToastStore, type ToastViewportProps, Tooltip, type TooltipPositionerProps, type TooltipRootProps, asyncStatusToContentState, useAeonMachine, useAppNav, useAppNavMachine, useAppShellContext, useAsyncContext, useContentContext, useFieldContext, useFitText, useLayoutMode, useScrollContext, useScrollState, useStickyBarContext, useToast, useToastStore };
+/**
+ * Radix-style Slot — merges Aeon attrs onto a single child element
+ * (e.g. Next.js Link) instead of rendering a wrapper.
+ */
+declare const Slot: react.ForwardRefExoticComponent<HTMLAttributes<HTMLElement> & {
+    children?: ReactNode;
+} & react.RefAttributes<HTMLElement>>;
+
+export { Accordion, type AccordionItemContentProps, type AccordionItemProps, type AccordionItemTriggerProps, type AccordionRootProps, AppNav, type AppNavBreadcrumbProps, type AppNavRootProps, type AppNavSectionProps, AppShell, type AppShellRootProps, Async, AsyncActions, AsyncProvider, AsyncReadout, AsyncRoot, AsyncTrack, Avatar, type AvatarRootProps, type AvatarStatus, Bar, type BarRootProps, Button, type ButtonRootProps, type ButtonStatus, Checkbox, type CheckboxRootProps, Combobox, type ComboboxItemProps, type ComboboxRootProps, Composer, type ComposerRootProps, type ComposerState, Content, type ContentRootProps, Conversation, type ConversationItemProps, type ConversationItemState, type ConversationRootProps, Dialog, type DialogPortalProps, type DialogRootProps, Entry, type EntryListProps, type EntryRootProps, type EntryState, Field, type FieldControlProps, type FieldRootProps, type FieldTextareaProps, FileUpload, type FileUploadRootProps, Identity, type IdentityRootProps, ListRow, type ListRowRootProps, Menu, type MenuItemProps, type MenuPositionerProps, type MenuRootProps, MetricStrip, type MetricStripRootProps, Nav, type NavItemProps, type NavRootProps, Panel, type PanelContentProps, type PanelGroupProps, type PanelLabelProps, type PanelRootProps, type PanelTriggerProps, PinInput, type PinInputInputProps, type PinInputRootProps, Popover, type PopoverPositionerProps, type PopoverRootProps, type PresenceState, ProfileHeader, type ProfileHeaderRootProps, Progress, type ProgressRootProps, Prompt, type PromptRootProps, type PromptStatus, RadioGroup, type RadioGroupItemProps, type RadioGroupRootProps, RangeSlider, type RangeSliderRootProps, type RangeSliderThumbProps, Scroll, type ScrollRootProps, type ScrollViewportProps, Select, type SelectContentProps, type SelectItemProps, type SelectPositionerProps, type SelectRootProps, Separator, type SeparatorRootProps, Slider, type SliderRootProps, Slot, StatusBanner, type StatusBannerRootProps, type StatusBannerTone, StickyBar, type StickyBarRootProps, Switch, type SwitchRootProps, Tabs, type TabsContentProps, type TabsRootProps, type TabsTriggerProps, ThemeSwitcher, type ThemeSwitcherModeBtnProps, type ThemeSwitcherModesProps, type ThemeSwitcherRootProps, type ThemeSwitcherThemeSelectProps, Thread, type ThreadItemFace, type ThreadItemProps, type ThreadMessageState, type ThreadRootProps, Toast, ToastItem, type ToastPlacement, type ToastProviderProps, type ToastPublishOptions, type ToastRecord, type ToastRootProps, type ToastStore, type ToastViewportProps, Tooltip, type TooltipPositionerProps, type TooltipRootProps, asyncStatusToContentState, useAeonMachine, useAppNav, useAppNavMachine, useAppShellContext, useAsyncContext, useContentContext, useFieldContext, useFileUploadCtx as useFileUpload, useFitText, useLayoutMode, useScrollContext, useScrollState, useStickyBarContext, useToast, useToastStore };