aeon-ui-engine 1.0.2 → 1.1.0

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

@@ -0,0 +1,951 @@
+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 { AsyncContext, ContentRegionState, StickyBarState } from '@aeon-ui/primitives';
+export { 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';
+
+/** Action button lifecycle — see STATES.md and `buttonLifecycleMachine`. */
+type ButtonStatus = 'idle' | 'pending' | 'success' | 'failure' | 'disabled';
+interface ButtonRootProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    variant?: 'solid' | 'outline' | 'ghost';
+    size?: 'xs' | 'sm' | 'md' | 'lg';
+    /** Machine-aligned lifecycle; `disabled` prop overrides to `disabled`. */
+    status?: ButtonStatus;
+    children?: ReactNode;
+}
+declare const Button: {
+    Root: react.ForwardRefExoticComponent<ButtonRootProps & react.RefAttributes<HTMLButtonElement>>;
+    Label: react.ForwardRefExoticComponent<ButtonHTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+    Icon: react.ForwardRefExoticComponent<ButtonHTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+    Group: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+};
+
+interface SwitchRootProps {
+    checked?: boolean;
+    defaultChecked?: boolean;
+    disabled?: boolean;
+    onCheckedChange?: (checked: boolean) => void;
+    children?: ReactNode;
+    className?: string;
+}
+declare const Switch: {
+    Root: react.ForwardRefExoticComponent<SwitchRootProps & react.RefAttributes<HTMLLabelElement>>;
+    Control: react.ForwardRefExoticComponent<ButtonHTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+    Thumb: react.ForwardRefExoticComponent<ButtonHTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+    Label: react.ForwardRefExoticComponent<ButtonHTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+    HiddenInput: react.ForwardRefExoticComponent<InputHTMLAttributes<HTMLInputElement> & react.RefAttributes<HTMLInputElement>>;
+};
+
+interface CheckboxRootProps {
+    checked?: boolean;
+    defaultChecked?: boolean;
+    disabled?: boolean;
+    onCheckedChange?: (checked: boolean) => void;
+    children?: ReactNode;
+    className?: string;
+}
+declare const Checkbox: {
+    Root: react.ForwardRefExoticComponent<CheckboxRootProps & react.RefAttributes<HTMLLabelElement>>;
+    Control: react.ForwardRefExoticComponent<ButtonHTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+    Indicator: react.ForwardRefExoticComponent<ButtonHTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+    Label: react.ForwardRefExoticComponent<ButtonHTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+    HiddenInput: react.ForwardRefExoticComponent<InputHTMLAttributes<HTMLInputElement> & react.RefAttributes<HTMLInputElement>>;
+};
+
+interface DialogRootProps {
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    children?: ReactNode;
+    className?: string;
+}
+interface DialogPortalProps extends HTMLAttributes<HTMLDivElement> {
+    /** Mount overlay in document.body (default true). */
+    portalled?: boolean;
+    children?: ReactNode;
+}
+declare const Dialog: {
+    Root: react.ForwardRefExoticComponent<DialogRootProps & react.RefAttributes<HTMLDivElement>>;
+    Trigger: react.ForwardRefExoticComponent<ButtonHTMLAttributes<HTMLButtonElement> & react.RefAttributes<HTMLButtonElement>>;
+    Portal: react.ForwardRefExoticComponent<DialogPortalProps & react.RefAttributes<HTMLDivElement>>;
+    Backdrop: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Positioner: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Content: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Title: react.ForwardRefExoticComponent<HTMLAttributes<HTMLHeadingElement> & react.RefAttributes<HTMLHeadingElement>>;
+    Description: react.ForwardRefExoticComponent<HTMLAttributes<HTMLParagraphElement> & react.RefAttributes<HTMLParagraphElement>>;
+    CloseTrigger: react.ForwardRefExoticComponent<ButtonHTMLAttributes<HTMLButtonElement> & react.RefAttributes<HTMLButtonElement>>;
+};
+
+interface TabsRootProps {
+    value?: string;
+    defaultValue?: string;
+    onValueChange?: (value: string) => void;
+    children?: ReactNode;
+    className?: string;
+}
+interface TabsTriggerProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    value: string;
+}
+interface TabsContentProps extends HTMLAttributes<HTMLDivElement> {
+    value: string;
+}
+declare const Tabs: {
+    Root: react.ForwardRefExoticComponent<TabsRootProps & react.RefAttributes<HTMLDivElement>>;
+    List: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Trigger: react.ForwardRefExoticComponent<TabsTriggerProps & react.RefAttributes<HTMLButtonElement>>;
+    Content: react.ForwardRefExoticComponent<TabsContentProps & react.RefAttributes<HTMLDivElement>>;
+    Indicator: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+};
+
+interface SeparatorRootProps extends HTMLAttributes<HTMLDivElement> {
+    orientation?: 'horizontal' | 'vertical';
+}
+declare const Separator: {
+    Root: react.ForwardRefExoticComponent<SeparatorRootProps & react.RefAttributes<HTMLDivElement>>;
+};
+
+interface ProgressRootProps extends HTMLAttributes<HTMLDivElement> {
+    value?: number;
+    max?: number;
+    indeterminate?: boolean;
+    children?: ReactNode;
+    className?: string;
+}
+declare const Progress: {
+    Root: react.ForwardRefExoticComponent<ProgressRootProps & react.RefAttributes<HTMLDivElement>>;
+    Track: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Range: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Label: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+};
+
+interface RadioGroupRootProps {
+    value?: string;
+    defaultValue?: string;
+    onValueChange?: (value: string) => void;
+    children?: ReactNode;
+    className?: string;
+}
+interface RadioGroupItemProps extends HTMLAttributes<HTMLDivElement> {
+    value: string;
+}
+declare const RadioGroup: {
+    Root: react.ForwardRefExoticComponent<RadioGroupRootProps & react.RefAttributes<HTMLDivElement>>;
+    Item: react.ForwardRefExoticComponent<RadioGroupItemProps & react.RefAttributes<HTMLDivElement>>;
+    ItemControl: react.ForwardRefExoticComponent<ButtonHTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+    ItemIndicator: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+    ItemLabel: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+};
+
+interface SliderRootProps {
+    value?: number;
+    defaultValue?: number;
+    min?: number;
+    max?: number;
+    step?: number;
+    disabled?: boolean;
+    onValueChange?: (value: number) => void;
+    children?: ReactNode;
+    className?: string;
+}
+declare const Slider: {
+    Root: react.ForwardRefExoticComponent<SliderRootProps & react.RefAttributes<HTMLDivElement>>;
+    Track: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Range: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Thumb: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+    ValueText: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+};
+
+interface PinInputRootProps {
+    length?: number;
+    value?: string;
+    defaultValue?: string;
+    disabled?: boolean;
+    onValueChange?: (value: string) => void;
+    onComplete?: (value: string) => void;
+    type?: 'numeric' | 'alphanumeric';
+    children?: ReactNode;
+    className?: string;
+}
+interface PinInputInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'value' | 'onChange'> {
+    index: number;
+    onChange?: InputHTMLAttributes<HTMLInputElement>['onChange'];
+}
+declare const PinInput: {
+    Root: react.ForwardRefExoticComponent<PinInputRootProps & react.RefAttributes<HTMLDivElement>>;
+    Input: react.ForwardRefExoticComponent<PinInputInputProps & react.RefAttributes<HTMLInputElement>>;
+    Group: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & {
+        inputClassName?: string;
+    } & react.RefAttributes<HTMLDivElement>>;
+};
+
+interface AccordionRootProps {
+    value?: string[];
+    defaultValue?: string[];
+    multiple?: boolean;
+    collapsible?: boolean;
+    onValueChange?: (value: string[]) => void;
+    children?: ReactNode;
+    className?: string;
+}
+interface AccordionItemProps extends HTMLAttributes<HTMLDivElement> {
+    value: string;
+}
+interface AccordionItemTriggerProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    value: string;
+}
+interface AccordionItemContentProps extends HTMLAttributes<HTMLDivElement> {
+    value: string;
+}
+declare const Accordion: {
+    Root: react.ForwardRefExoticComponent<AccordionRootProps & react.RefAttributes<HTMLDivElement>>;
+    Item: react.ForwardRefExoticComponent<AccordionItemProps & react.RefAttributes<HTMLDivElement>>;
+    ItemTrigger: react.ForwardRefExoticComponent<AccordionItemTriggerProps & react.RefAttributes<HTMLButtonElement>>;
+    ItemContent: react.ForwardRefExoticComponent<AccordionItemContentProps & react.RefAttributes<HTMLDivElement>>;
+    ItemIndicator: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+};
+
+interface AsyncActionsProps extends HTMLAttributes<HTMLDivElement> {
+    children: ReactNode;
+}
+declare const AsyncActions: react.ForwardRefExoticComponent<AsyncActionsProps & react.RefAttributes<HTMLDivElement>>;
+
+interface AsyncReadoutProps extends HTMLAttributes<HTMLDivElement> {
+    children?: ReactNode;
+}
+declare const AsyncReadout: react.ForwardRefExoticComponent<AsyncReadoutProps & react.RefAttributes<HTMLDivElement>>;
+
+interface AsyncTrackProps extends HTMLAttributes<HTMLDivElement> {
+    states?: readonly string[];
+}
+declare const AsyncTrack: react.ForwardRefExoticComponent<AsyncTrackProps & react.RefAttributes<HTMLDivElement>>;
+
+interface AsyncRootProps extends HTMLAttributes<HTMLDivElement> {
+    children: ReactNode;
+    className?: string;
+}
+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";
+} | {
+    type: "REJECT";
+    error: string;
+} | {
+    type: "RESET";
+} | {
+    type: "STALE";
+} | {
+    type: "REFRESH";
+} | {
+    type: "RESOLVE";
+    data: unknown;
+}, {}, never, {
+    type: "resolve";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "clear";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "markStale";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "clearStale";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "reject";
+    params: xstate.NonReducibleUnknown;
+}, never, never, "idle" | "success" | "failure" | "loading" | "empty", string, xstate.NonReducibleUnknown, xstate.NonReducibleUnknown, xstate.EventObject, xstate.MetaObject, {
+    id: "async";
+    states: {
+        readonly idle: {};
+        readonly loading: {};
+        readonly empty: {};
+        readonly success: {};
+        readonly failure: {};
+    };
+}>;
+interface AsyncProviderValue {
+    status: string;
+    data: unknown;
+    error: string | null;
+    stale: boolean;
+    stateAttr: string;
+    send: ReturnType<typeof useAeonMachine<typeof defaultMachine>>[1];
+}
+declare function useAsyncContext(): AsyncProviderValue;
+interface AsyncProviderProps {
+    children: ReactNode;
+    machine?: typeof defaultMachine;
+}
+declare function AsyncProvider({ children, machine }: AsyncProviderProps): react_jsx_runtime.JSX.Element;
+
+/** Map async machine leaf → Content face (product UI — not Track). */
+declare function asyncStatusToContentState(status: string): ContentRegionState;
+
+/**
+ * Async — fetch lifecycle driver (`createAsyncMachine`).
+ * Product UI: project status with Content slots via `asyncStatusToContentState`.
+ * `Track` is a totality/debug rail — not Instant default (see docs/PRIMITIVE_COVERAGE.md).
+ */
+declare const Async: {
+    Root: react.ForwardRefExoticComponent<AsyncRootProps & react.RefAttributes<HTMLDivElement>>;
+    Provider: typeof AsyncProvider;
+    Track: react.ForwardRefExoticComponent<AsyncTrackProps & react.RefAttributes<HTMLDivElement>>;
+    Readout: react.ForwardRefExoticComponent<AsyncReadoutProps & react.RefAttributes<HTMLDivElement>>;
+    Actions: react.ForwardRefExoticComponent<AsyncActionsProps & react.RefAttributes<HTMLDivElement>>;
+};
+
+interface FieldContextValue {
+    /** Primary visual face — idle | dirty | invalid | pending (same hierarchy as Button). */
+    face: ReturnType<typeof fieldFace>;
+    /** @deprecated Use `face` — kept as an alias for older callers. */
+    stateAttr: string;
+    interaction: string;
+    validation: string;
+    submission: string;
+    send: ReturnType<typeof useAeonMachine<typeof fieldMachine>>[1];
+    invalid: boolean;
+    pending: boolean;
+}
+declare function useFieldContext(): FieldContextValue;
+interface FieldRootProps {
+    children: ReactNode;
+    className?: string;
+    id?: string;
+}
+interface FieldControlProps extends InputHTMLAttributes<HTMLInputElement> {
+    validate?: (value: string) => boolean;
+}
+interface FieldTextareaProps extends TextareaHTMLAttributes<HTMLTextAreaElement> {
+    validate?: (value: string) => boolean;
+}
+declare const Field: {
+    Root: react.ForwardRefExoticComponent<FieldRootProps & react.RefAttributes<HTMLDivElement>>;
+    Label: react.ForwardRefExoticComponent<LabelHTMLAttributes<HTMLLabelElement> & react.RefAttributes<HTMLLabelElement>>;
+    Control: react.ForwardRefExoticComponent<FieldControlProps & react.RefAttributes<HTMLInputElement>>;
+    Input: react.ForwardRefExoticComponent<FieldControlProps & react.RefAttributes<HTMLInputElement>>;
+    Textarea: react.ForwardRefExoticComponent<FieldTextareaProps & react.RefAttributes<HTMLTextAreaElement>>;
+    Message: react.ForwardRefExoticComponent<react.HTMLAttributes<HTMLParagraphElement> & react.RefAttributes<HTMLParagraphElement>>;
+    Hint: react.ForwardRefExoticComponent<react.HTMLAttributes<HTMLParagraphElement> & react.RefAttributes<HTMLParagraphElement>>;
+};
+
+/** Subscribe to scroll + resize; returns data-aeon-state value for a viewport. */
+declare function useScrollState(ref: RefObject<HTMLElement | null>): string;
+
+interface ScrollContextValue {
+    stateAttr: string;
+}
+declare function useScrollContext(): ScrollContextValue;
+interface ScrollRootProps extends HTMLAttributes<HTMLDivElement> {
+    children: ReactNode;
+}
+interface ScrollViewportProps extends HTMLAttributes<HTMLDivElement> {
+    children: ReactNode;
+}
+declare const Scroll: {
+    Root: react.ForwardRefExoticComponent<ScrollRootProps & react.RefAttributes<HTMLDivElement>>;
+    Viewport: react.ForwardRefExoticComponent<ScrollViewportProps & react.RefAttributes<HTMLDivElement>>;
+    Content: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+};
+
+interface SelectRootProps {
+    value: string;
+    onValueChange?: (value: string) => void;
+    children: ReactNode;
+    className?: string;
+    disabled?: boolean;
+}
+interface SelectPositionerProps extends HTMLAttributes<HTMLDivElement> {
+    /** Mount listbox in document.body (default true). */
+    portalled?: boolean;
+    children?: ReactNode;
+}
+interface SelectContentProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * When `Select.Content` is not wrapped in `Select.Positioner`, portal to body (default true).
+     * Ignored when a `Select.Positioner` ancestor is present.
+     */
+    portalled?: boolean;
+}
+interface SelectItemProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    value: string;
+    disabled?: boolean;
+}
+declare const Select: {
+    Root: react.ForwardRefExoticComponent<SelectRootProps & react.RefAttributes<HTMLDivElement>>;
+    Trigger: react.ForwardRefExoticComponent<ButtonHTMLAttributes<HTMLButtonElement> & react.RefAttributes<HTMLButtonElement>>;
+    ValueText: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+    Positioner: react.ForwardRefExoticComponent<SelectPositionerProps & react.RefAttributes<HTMLDivElement>>;
+    Content: react.ForwardRefExoticComponent<SelectContentProps & react.RefAttributes<HTMLDivElement>>;
+    Item: react.ForwardRefExoticComponent<SelectItemProps & react.RefAttributes<HTMLButtonElement>>;
+};
+
+interface ComboboxRootProps {
+    value: string;
+    onValueChange?: (value: string) => void;
+    children: ReactNode;
+    className?: string;
+    disabled?: boolean;
+}
+interface ComboboxItemProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    value: string;
+    /** Used for typeahead filter when children are not plain text. */
+    textValue?: string;
+}
+declare const Combobox: {
+    Root: react.ForwardRefExoticComponent<ComboboxRootProps & react.RefAttributes<HTMLDivElement>>;
+    Input: react.ForwardRefExoticComponent<InputHTMLAttributes<HTMLInputElement> & react.RefAttributes<HTMLInputElement>>;
+    Content: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Item: react.ForwardRefExoticComponent<ComboboxItemProps & react.RefAttributes<HTMLButtonElement>>;
+    Empty: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+};
+
+type AnchorPlacement = 'bottom-start' | 'top-start';
+
+interface PopoverRootProps {
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    children?: ReactNode;
+    className?: string;
+}
+interface PopoverPositionerProps extends HTMLAttributes<HTMLDivElement> {
+    /** Mount panel in document.body (default true). */
+    portalled?: boolean;
+    placement?: AnchorPlacement;
+    children?: ReactNode;
+}
+declare const Popover: {
+    Root: react.ForwardRefExoticComponent<PopoverRootProps & react.RefAttributes<HTMLDivElement>>;
+    Trigger: react.ForwardRefExoticComponent<ButtonHTMLAttributes<HTMLButtonElement> & react.RefAttributes<HTMLButtonElement>>;
+    Positioner: react.ForwardRefExoticComponent<PopoverPositionerProps & react.RefAttributes<HTMLDivElement>>;
+    Content: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Arrow: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    CloseTrigger: react.ForwardRefExoticComponent<ButtonHTMLAttributes<HTMLButtonElement> & react.RefAttributes<HTMLButtonElement>>;
+};
+
+interface MenuRootProps {
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    children?: ReactNode;
+    className?: string;
+}
+interface MenuPositionerProps extends HTMLAttributes<HTMLDivElement> {
+    /** Mount menu in document.body (default true). */
+    portalled?: boolean;
+    placement?: AnchorPlacement;
+    children?: ReactNode;
+}
+interface MenuItemProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    /** Close menu after selection (default true). */
+    closeOnSelect?: boolean;
+}
+declare const Menu: {
+    Root: react.ForwardRefExoticComponent<MenuRootProps & react.RefAttributes<HTMLDivElement>>;
+    Trigger: react.ForwardRefExoticComponent<ButtonHTMLAttributes<HTMLButtonElement> & react.RefAttributes<HTMLButtonElement>>;
+    Positioner: react.ForwardRefExoticComponent<MenuPositionerProps & react.RefAttributes<HTMLDivElement>>;
+    Content: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Item: react.ForwardRefExoticComponent<MenuItemProps & react.RefAttributes<HTMLButtonElement>>;
+    Separator: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+};
+
+interface TooltipRootProps {
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    openDelay?: number;
+    closeDelay?: number;
+    /** Auto-hide on touch devices after open (0 = until outside tap). Default 5000. */
+    touchDurationMs?: number;
+    /** Ignore outside-dismiss briefly after touch open (ghost-click guard). */
+    touchOutsideGraceMs?: number;
+    /** Focus after click/tap can leave tooltips open; disable for dense click targets. */
+    showOnFocus?: boolean;
+    children?: ReactNode;
+    className?: string;
+}
+interface TooltipPositionerProps extends HTMLAttributes<HTMLDivElement> {
+    /** Mount tooltip in document.body (default true). */
+    portalled?: boolean;
+    placement?: AnchorPlacement;
+    children?: ReactNode;
+}
+declare const Tooltip: {
+    Root: react.ForwardRefExoticComponent<TooltipRootProps & react.RefAttributes<HTMLDivElement>>;
+    Trigger: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+    Positioner: react.ForwardRefExoticComponent<TooltipPositionerProps & react.RefAttributes<HTMLDivElement>>;
+    Content: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Arrow: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+};
+
+interface ToastRootProps {
+    durationMs?: number;
+    defaultVisible?: boolean;
+    onVisibleChange?: (visible: boolean) => void;
+    children?: ReactNode;
+    className?: string;
+}
+/** Programmatically show a declarative Toast.Root instance. */
+declare function Show({ durationMs }: {
+    durationMs?: number;
+}): null;
+
+type ToastPublishOptions = {
+    id?: string;
+    title?: ReactNode;
+    description?: ReactNode;
+    /** Auto-dismiss after ms (0 = no auto dismiss). Default 5000. */
+    durationMs?: number;
+};
+type ToastRecord = ToastPublishOptions & {
+    id: string;
+};
+type ToastStore = {
+    items: ToastRecord[];
+    publish: (options: ToastPublishOptions) => string;
+    dismiss: (id: string) => void;
+    dismissAll: () => void;
+};
+declare function useToastStore(): ToastStore;
+
+type ToastPlacement = 'top-start' | 'top-end' | 'bottom-start' | 'bottom-end';
+interface ToastProviderProps {
+    children?: ReactNode;
+    /** Max simultaneous toasts (oldest removed). Default 5. */
+    limit?: number;
+}
+declare function ToastProvider({ children, limit }: ToastProviderProps): react_jsx_runtime.JSX.Element;
+interface ToastViewportProps extends HTMLAttributes<HTMLDivElement> {
+    placement?: ToastPlacement;
+}
+declare function ToastViewport({ placement, className, ...rest }: ToastViewportProps): react.ReactPortal | null;
+/** Imperative toast API — requires `Toast.Provider` ancestor. */
+declare function useToast(): {
+    publish: (options: ToastPublishOptions) => string;
+    dismiss: (id: string) => void;
+    dismissAll: () => void;
+};
+
+declare const ToastItem: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & {
+    item: ToastRecord;
+    onExited: (id: string) => void;
+} & react.RefAttributes<HTMLDivElement>>;
+
+declare const Toast: {
+    Provider: typeof ToastProvider;
+    Viewport: typeof ToastViewport;
+    Root: react.ForwardRefExoticComponent<ToastRootProps & react.RefAttributes<HTMLDivElement>>;
+    Title: react.ForwardRefExoticComponent<react.HTMLAttributes<HTMLParagraphElement> & react.RefAttributes<HTMLParagraphElement>>;
+    Description: react.ForwardRefExoticComponent<react.HTMLAttributes<HTMLParagraphElement> & react.RefAttributes<HTMLParagraphElement>>;
+    CloseTrigger: react.ForwardRefExoticComponent<react.ButtonHTMLAttributes<HTMLButtonElement> & react.RefAttributes<HTMLButtonElement>>;
+    Show: typeof Show;
+};
+
+interface ThemeSwitcherRootProps extends HTMLAttributes<HTMLDivElement> {
+    /** Initial theme — overridden by localStorage / system preference. */
+    defaultTheme?: string;
+    /** Initial mode — overridden by localStorage / system preference. */
+    defaultMode?: AeonColorMode;
+    /** Called when theme or mode changes. */
+    onThemeChange?: (themeId: string, mode: AeonColorMode) => void;
+}
+interface ThemeSwitcherModesProps extends HTMLAttributes<HTMLDivElement> {
+}
+interface ThemeSwitcherModeBtnProps extends HTMLAttributes<HTMLButtonElement> {
+    mode: AeonColorMode;
+    active: boolean;
+}
+interface ThemeSwitcherThemeSelectProps extends HTMLAttributes<HTMLDivElement> {
+}
+/**
+ * ThemeSwitcher — headless compound component for theme + mode control.
+ *
+ * Uses `initAeonTheme()` on mount to read localStorage / system preference.
+ * All state changes call `applyAeonTheme()` to update `<html>` dataset attrs.
+ *
+ * @example
+ * <ThemeSwitcher.Root>
+ *   <ThemeSwitcher.Modes>
+ *     <ThemeSwitcher.ModeBtn mode="light" active={mode === 'light'} />
+ *     <ThemeSwitcher.ModeBtn mode="dark" active={mode === 'dark'} />
+ *   </ThemeSwitcher.Modes>
+ *   <ThemeSwitcher.ThemeSelect>
+ *     <ThemeSwitcher.ThemeTrigger />
+ *   </ThemeSwitcher.ThemeSelect>
+ * </ThemeSwitcher.Root>
+ */
+declare const ThemeSwitcher: {
+    Root: react.ForwardRefExoticComponent<ThemeSwitcherRootProps & react.RefAttributes<HTMLDivElement>>;
+    Modes: react.ForwardRefExoticComponent<ThemeSwitcherModesProps & react.RefAttributes<HTMLDivElement>>;
+    ModeBtn: react.ForwardRefExoticComponent<ThemeSwitcherModeBtnProps & react.RefAttributes<HTMLButtonElement>>;
+    ThemeSelect: react.ForwardRefExoticComponent<ThemeSwitcherThemeSelectProps & react.RefAttributes<HTMLDivElement>>;
+    ThemeTrigger: react.ForwardRefExoticComponent<HTMLAttributes<HTMLButtonElement> & react.RefAttributes<HTMLButtonElement>>;
+};
+
+type AvatarStatus = 'idle' | 'loading' | 'loaded' | 'error';
+interface AvatarRootProps extends HTMLAttributes<HTMLSpanElement> {
+    children?: ReactNode;
+    className?: string;
+}
+type PresenceState = 'idle' | 'active' | 'away' | 'busy' | 'offline';
+declare const Avatar: {
+    Root: react.ForwardRefExoticComponent<AvatarRootProps & react.RefAttributes<HTMLSpanElement>>;
+    Image: react.ForwardRefExoticComponent<ImgHTMLAttributes<HTMLImageElement> & react.RefAttributes<HTMLImageElement>>;
+    Fallback: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+    Badge: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & {
+        presence?: PresenceState;
+    } & react.RefAttributes<HTMLSpanElement>>;
+};
+
+interface IdentityRootProps extends HTMLAttributes<HTMLElement> {
+    as?: 'div' | 'a' | 'button';
+    size?: 'sm' | 'md' | 'lg';
+    children?: ReactNode;
+}
+declare const Identity: {
+    Root: react.ForwardRefExoticComponent<IdentityRootProps & react.RefAttributes<HTMLElement>>;
+    Avatar: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+    Title: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+    Subtitle: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+    Meta: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+    Trailing: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+};
+
+interface MetricStripRootProps extends HTMLAttributes<HTMLElement> {
+    /** cluster = ultra-dense chips; loose = columnar stats */
+    density?: 'cluster' | 'loose';
+    children?: ReactNode;
+}
+declare const MetricStrip: {
+    Root: react.ForwardRefExoticComponent<MetricStripRootProps & react.RefAttributes<HTMLElement>>;
+    Chip: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+    Value: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+    Label: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+};
+
+interface ListRowRootProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    as?: 'button' | 'div' | 'a';
+    children?: ReactNode;
+}
+declare const ListRow: {
+    Root: react.ForwardRefExoticComponent<ListRowRootProps & react.RefAttributes<HTMLElement>>;
+    Leading: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+    Label: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+    Description: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+    Trailing: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+};
+
+/** Card face — idle resting · selected highlight · muted de-emphasized. */
+type EntryState = 'idle' | 'selected' | 'muted';
+interface EntryListProps extends HTMLAttributes<HTMLDivElement> {
+    children?: ReactNode;
+}
+interface EntryRootProps extends HTMLAttributes<HTMLElement> {
+    as?: 'article' | 'div' | 'li' | 'section';
+    state?: EntryState;
+    children?: ReactNode;
+}
+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";
+    } & react.RefAttributes<HTMLElement>>;
+    Leading: react.ForwardRefExoticComponent<HTMLAttributes<HTMLElement> & {
+        as?: "span" | "div" | "footer" | "header" | "p";
+    } & react.RefAttributes<HTMLElement>>;
+    Heading: react.ForwardRefExoticComponent<HTMLAttributes<HTMLElement> & {
+        as?: "span" | "div" | "footer" | "header" | "p";
+    } & react.RefAttributes<HTMLElement>>;
+    Title: react.ForwardRefExoticComponent<HTMLAttributes<HTMLElement> & {
+        as?: "span" | "div" | "footer" | "header" | "p";
+    } & react.RefAttributes<HTMLElement>>;
+    Subtitle: react.ForwardRefExoticComponent<HTMLAttributes<HTMLElement> & {
+        as?: "span" | "div" | "footer" | "header" | "p";
+    } & react.RefAttributes<HTMLElement>>;
+    Meta: react.ForwardRefExoticComponent<HTMLAttributes<HTMLElement> & {
+        as?: "span" | "div" | "footer" | "header" | "p";
+    } & react.RefAttributes<HTMLElement>>;
+    Media: react.ForwardRefExoticComponent<HTMLAttributes<HTMLElement> & {
+        as?: "span" | "div" | "footer" | "header" | "p";
+    } & react.RefAttributes<HTMLElement>>;
+    Body: react.ForwardRefExoticComponent<HTMLAttributes<HTMLElement> & {
+        as?: "span" | "div" | "footer" | "header" | "p";
+    } & react.RefAttributes<HTMLElement>>;
+    Values: react.ForwardRefExoticComponent<HTMLAttributes<HTMLElement> & {
+        as?: "span" | "div" | "footer" | "header" | "p";
+    } & react.RefAttributes<HTMLElement>>;
+    Value: react.ForwardRefExoticComponent<HTMLAttributes<HTMLElement> & {
+        as?: "span" | "div" | "footer" | "header" | "p";
+    } & react.RefAttributes<HTMLElement>>;
+    Actions: react.ForwardRefExoticComponent<HTMLAttributes<HTMLElement> & {
+        as?: "span" | "div" | "footer" | "header" | "p";
+    } & react.RefAttributes<HTMLElement>>;
+    Footer: react.ForwardRefExoticComponent<HTMLAttributes<HTMLElement> & {
+        as?: "span" | "div" | "footer" | "header" | "p";
+    } & react.RefAttributes<HTMLElement>>;
+};
+
+type ConversationItemState = 'idle' | 'unread' | 'selected';
+interface ConversationRootProps extends HTMLAttributes<HTMLElement> {
+    children?: ReactNode;
+}
+interface ConversationItemProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    state?: ConversationItemState;
+    as?: 'button' | 'div' | 'a';
+}
+declare const Conversation: {
+    Root: react.ForwardRefExoticComponent<ConversationRootProps & react.RefAttributes<HTMLElement>>;
+    Item: react.ForwardRefExoticComponent<ConversationItemProps & react.RefAttributes<HTMLElement>>;
+    Leading: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+    Body: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+    Title: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+    Preview: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+    Meta: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+    Badge: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+};
+
+type ThreadMessageState = 'mine' | 'theirs' | 'pending' | 'failed';
+interface ThreadRootProps extends HTMLAttributes<HTMLElement> {
+    children?: ReactNode;
+}
+interface ThreadItemProps extends HTMLAttributes<HTMLDivElement> {
+    state?: ThreadMessageState | `${ThreadMessageState} ${string}`;
+}
+declare const Thread: {
+    Root: react.ForwardRefExoticComponent<ThreadRootProps & react.RefAttributes<HTMLElement>>;
+    List: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Item: react.ForwardRefExoticComponent<ThreadItemProps & react.RefAttributes<HTMLDivElement>>;
+    Bubble: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Meta: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+    Day: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+};
+
+type ComposerState = 'idle' | 'sending' | 'disabled' | 'error';
+interface ComposerRootProps extends FormHTMLAttributes<HTMLFormElement> {
+    state?: ComposerState;
+    children?: ReactNode;
+}
+declare const Composer: {
+    Root: react.ForwardRefExoticComponent<ComposerRootProps & react.RefAttributes<HTMLFormElement>>;
+    Input: react.ForwardRefExoticComponent<TextareaHTMLAttributes<HTMLTextAreaElement> & react.RefAttributes<HTMLTextAreaElement>>;
+    Actions: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Send: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+};
+
+interface ProfileHeaderRootProps extends HTMLAttributes<HTMLElement> {
+    children?: ReactNode;
+}
+declare const ProfileHeader: {
+    Root: react.ForwardRefExoticComponent<ProfileHeaderRootProps & react.RefAttributes<HTMLElement>>;
+    Media: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Identity: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Metrics: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Actions: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Body: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+};
+
+interface BarRootProps extends HTMLAttributes<HTMLDivElement> {
+    /** HTML element to render — defaults to `'header'`. */
+    as?: 'header' | 'nav' | 'footer' | 'div';
+    /** Flex gap between zones. */
+    gap?: string;
+}
+interface ZoneProps extends HTMLAttributes<HTMLDivElement> {
+    /** Which zone — controls flex behavior. */
+    zone: Zone;
+}
+type Zone = 'leading' | 'center' | 'trailing';
+declare const Zone: react.ForwardRefExoticComponent<ZoneProps & react.RefAttributes<HTMLDivElement>>;
+/**
+ * Bar — horizontal layout primitive for toolbars, headers, footers.
+ *
+ * Guarantees no overlap by enforcing a three-zone flex contract:
+ * - **Leading** — `flex: 0 1 auto`, shrinks before overflowing.
+ * - **Center** — `flex: 1 1 0`, absorbs available space, truncates.
+ * - **Trailing** — `flex: 0 1 auto`, shrinks before overflowing.
+ *
+ * The root is always `display: flex; flex-wrap: nowrap` with
+ * `overflow: hidden` so children can never escape the bar boundary.
+ * Responsive collapse is handled by the Panda recipe (min-widths, wrap
+ * at breakpoints) — never by ad-hoc CSS.
+ */
+declare const Bar: {
+    Root: react.ForwardRefExoticComponent<BarRootProps & react.RefAttributes<HTMLDivElement>>;
+    Leading: react.ForwardRefExoticComponent<Omit<ZoneProps, "zone"> & react.RefAttributes<HTMLDivElement>>;
+    Center: react.ForwardRefExoticComponent<Omit<ZoneProps, "zone"> & react.RefAttributes<HTMLDivElement>>;
+    Trailing: react.ForwardRefExoticComponent<Omit<ZoneProps, "zone"> & react.RefAttributes<HTMLDivElement>>;
+};
+
+interface PanelGroupProps extends HTMLAttributes<HTMLDivElement> {
+    orientation?: 'horizontal' | 'vertical';
+    children?: ReactNode;
+}
+interface PanelRootProps extends HTMLAttributes<HTMLDivElement> {
+    /** Accessible name; also the collapsed vertical rail text. */
+    label: string;
+    /** Start expanded (default true). */
+    defaultExpanded?: boolean;
+    /** Controlled expanded state. */
+    expanded?: boolean;
+    /** Whether the panel can collapse (default true). */
+    collapsible?: boolean;
+    onExpandedChange?: (expanded: boolean) => void;
+    children?: ReactNode;
+}
+interface PanelTriggerProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+}
+interface PanelLabelProps extends HTMLAttributes<HTMLSpanElement> {
+    /** Override root label text. */
+    children?: ReactNode;
+}
+interface PanelContentProps extends HTMLAttributes<HTMLDivElement> {
+    /** Prefer Scroll.Root inside for overflow regions. */
+    children?: ReactNode;
+}
+declare const Panel: {
+    Group: react.ForwardRefExoticComponent<PanelGroupProps & react.RefAttributes<HTMLDivElement>>;
+    Root: react.ForwardRefExoticComponent<PanelRootProps & react.RefAttributes<HTMLDivElement>>;
+    Trigger: react.ForwardRefExoticComponent<PanelTriggerProps & react.RefAttributes<HTMLButtonElement>>;
+    Label: react.ForwardRefExoticComponent<PanelLabelProps & react.RefAttributes<HTMLSpanElement>>;
+    Content: react.ForwardRefExoticComponent<PanelContentProps & react.RefAttributes<HTMLDivElement>>;
+};
+
+type AppShellChrome = 'idle' | 'overlayOpen';
+interface AppShellContextValue {
+    chrome: AppShellChrome;
+    dockVisible: boolean;
+    overlayOpen: boolean;
+    send: ReturnType<typeof useAeonMachine<typeof appShellMachine>>[1];
+}
+declare function useAppShellContext(): AppShellContextValue;
+interface AppShellRootProps extends HTMLAttributes<HTMLDivElement> {
+    /** Initial dock visibility when uncontrolled. */
+    defaultDockVisible?: boolean;
+    /** Controlled dock visibility — syncs into the shell machine. */
+    dockVisible?: boolean;
+    children?: ReactNode;
+}
+/**
+ * AppShell — application chrome frame.
+ * Machine: idle | overlayOpen (+ dockVisible context).
+ * UI = f(snapshot): content dims / scrim when overlayOpen; dock hides when dockVisible=false.
+ */
+declare const AppShell: {
+    Root: react.ForwardRefExoticComponent<AppShellRootProps & react.RefAttributes<HTMLDivElement>>;
+    Header: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & {
+        as?: "main" | "div" | "aside" | "footer" | "header";
+    } & react.RefAttributes<HTMLDivElement>>;
+    Subheader: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & {
+        as?: "main" | "div" | "aside" | "footer" | "header";
+    } & react.RefAttributes<HTMLDivElement>>;
+    Content: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & {
+        as?: "main" | "div" | "aside" | "footer" | "header";
+    } & react.RefAttributes<HTMLDivElement>>;
+    Aside: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & {
+        as?: "main" | "div" | "aside" | "footer" | "header";
+    } & react.RefAttributes<HTMLDivElement>>;
+    Footer: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & {
+        as?: "main" | "div" | "aside" | "footer" | "header";
+    } & react.RefAttributes<HTMLDivElement>>;
+    Dock: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Scrim: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+};
+
+interface ContentContextValue {
+    state: ContentRegionState;
+    error: string | null;
+    send: ReturnType<typeof useAeonMachine<typeof contentRegionMachine>>[1];
+}
+declare function useContentContext(): ContentContextValue;
+interface ContentRootProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * Controlled face — projects parent/app machine onto Content slots
+     * (same pattern as Button `status`). When set, slot visibility uses this
+     * value instead of the internal contentRegionMachine leaf.
+     */
+    state?: ContentRegionState;
+    children?: ReactNode;
+}
+/**
+ * Content — status-slotted region. Machine totality maps 1:1 onto parts.
+ * States: idle | pending | empty | error | ready | loadingMore | success
+ * Drive via contentRegionMachine events, or project with Root `state` prop.
+ */
+declare const Content: {
+    Root: react.ForwardRefExoticComponent<ContentRootProps & react.RefAttributes<HTMLDivElement>>;
+    Toolbar: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Body: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Pending: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Empty: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Error: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Success: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Sentinel: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+};
+
+interface NavRootProps extends HTMLAttributes<HTMLElement> {
+    defaultValue?: string;
+    value?: string;
+    onValueChange?: (value: string) => void;
+    as?: 'nav' | 'div';
+    orientation?: 'horizontal' | 'vertical';
+    children?: ReactNode;
+}
+interface NavItemProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    value: string;
+}
+/**
+ * Nav — navigational collection (top links, bottom tabs, side rail).
+ * Selection: tabsMachine. Item states: inactive | active | disabled.
+ */
+declare const Nav: {
+    Root: react.ForwardRefExoticComponent<NavRootProps & react.RefAttributes<HTMLElement>>;
+    Item: react.ForwardRefExoticComponent<NavItemProps & react.RefAttributes<HTMLButtonElement>>;
+    Indicator: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+    Label: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+    Icon: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+    Badge: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & react.RefAttributes<HTMLSpanElement>>;
+};
+
+interface StickyBarContextValue {
+    state: StickyBarState;
+    offsetPx: number;
+    send: ReturnType<typeof useAeonMachine<typeof stickyBarMachine>>[1];
+}
+declare function useStickyBarContext(): StickyBarContextValue;
+interface StickyBarRootProps extends HTMLAttributes<HTMLElement> {
+    as?: 'header' | 'nav' | 'footer' | 'div';
+    /** Placement — top | bottom | inline (CSS contract). */
+    placement?: 'top' | 'bottom' | 'inline';
+    /** Initial machine state. */
+    defaultState?: StickyBarState;
+    children?: ReactNode;
+}
+/**
+ * StickyBar — sticky/fixed chrome band with machine totality.
+ * States: floating | docked | collapsed | hidden
+ * Zones reuse bar anatomy (leading / center / trailing / seam).
+ */
+declare const StickyBar: {
+    Root: react.ForwardRefExoticComponent<StickyBarRootProps & react.RefAttributes<HTMLElement>>;
+    Leading: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Center: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Trailing: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+    Seam: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & react.RefAttributes<HTMLDivElement>>;
+};
+
+declare function useLayoutMode(spec: ResponsiveLayoutSpec): {
+    mode: LayoutMode;
+    composition: LayoutCompositionSpec;
+};
+
+export { Accordion, type AccordionItemContentProps, type AccordionItemProps, type AccordionItemTriggerProps, type AccordionRootProps, 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, 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, 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, useAppShellContext, useAsyncContext, useContentContext, useFieldContext, useLayoutMode, useScrollContext, useScrollState, useStickyBarContext, useToast, useToastStore };