@zovaris/sephiro 0.7.0 → 0.8.0

package/dist/index.d.ts

@@ -1,161 +1,186 @@
-import * as react from 'react';
-import { HTMLAttributes, ButtonHTMLAttributes, InputHTMLAttributes, TextareaHTMLAttributes, RefObject, TableHTMLAttributes } from 'react';
-import { ExternalToast, ToasterProps } from 'sonner';
-export { toast } from 'sonner';
-
+import { ButtonHTMLAttributes, HTMLAttributes, InputHTMLAttributes, RefObject, TableHTMLAttributes, TextareaHTMLAttributes, TimeHTMLAttributes, useLayoutEffect } from "react";
+import { ExternalToast, ToasterProps, toast } from "sonner";
+//#region src/atoms/AnimatedNumber/index.d.ts
+type AnimatedNumberProps = Omit<HTMLAttributes<HTMLSpanElement>, "children"> & {
+  value: number;
+  from?: number;
+  duration?: number;
+  format?: (value: number) => string;
+};
+export declare function AnimatedNumber({ value, from, duration, format, className, ...props }: AnimatedNumberProps): import("react").JSX.Element;
+//#endregion
+//#region src/lib/control.d.ts
 type ControlSize = "sm" | "md" | "lg";
-
+//#endregion
+//#region src/atoms/Avatar/index.d.ts
 type AvatarStatus = "online" | "offline" | "busy" | "away";
 type AvatarProps = Omit<HTMLAttributes<HTMLSpanElement>, "children"> & {
-    /** Image URL. Falls back to `name` initials when it fails to load. */
-    src?: string;
-    name?: string;
-    size?: ControlSize;
-    status?: AvatarStatus;
-};
-declare function Avatar({ src, name, size, status, className, ...props }: AvatarProps): react.JSX.Element;
-
+  /** Image URL. Falls back to `name` initials when it fails to load. */
+  src?: string;
+  name?: string;
+  size?: ControlSize;
+  status?: AvatarStatus;
+};
+export declare function Avatar({ src, name, size, status, className, ...props }: AvatarProps): import("react").JSX.Element;
+//#endregion
+//#region src/lib/node.d.ts
 type RenderableElement = {
-    type: any;
-    props: any;
-    key?: any;
+  type: any;
+  props: any;
+  key?: any;
 };
 type Renderable = string | number | boolean | null | undefined | Iterable<Renderable> | RenderableElement;
-
+//#endregion
+//#region src/atoms/Badge/index.d.ts
 type BadgeProps = Omit<HTMLAttributes<HTMLSpanElement>, "children"> & {
-    variant?: "neutral" | "accent" | "success" | "warning" | "danger";
-    size?: ControlSize;
-    children?: Renderable;
+  variant?: "neutral" | "accent" | "success" | "warning" | "danger";
+  size?: ControlSize;
+  children?: Renderable;
 };
-declare function Badge({ variant, size, className, children, ...props }: BadgeProps): react.JSX.Element;
-
+export declare function Badge({ variant, size, className, children, ...props }: BadgeProps): import("react").JSX.Element;
+//#endregion
+//#region src/atoms/Button/index.d.ts
 type ButtonProps = Omit<ButtonHTMLAttributes<HTMLButtonElement>, "children"> & {
-    variant?: "primary" | "secondary" | "quiet";
-    size?: ControlSize;
-    loading?: boolean;
-    children?: Renderable;
+  variant?: "primary" | "secondary" | "quiet";
+  size?: ControlSize;
+  loading?: boolean;
+  children?: Renderable;
 };
-declare function Button({ variant, size, loading, disabled, className, type, children, "aria-busy": ariaBusy, ...props }: ButtonProps): react.JSX.Element;
-
+export declare function Button({ variant, size, loading, disabled, className, type, children, onClick, "aria-busy": ariaBusy, "aria-disabled": ariaDisabled, ...props }: ButtonProps): import("react").JSX.Element;
+//#endregion
+//#region src/atoms/Checkbox/index.d.ts
 type CheckboxProps = Omit<InputHTMLAttributes<HTMLInputElement>, "size"> & {
-    label?: Renderable;
-    size?: ControlSize;
-    invalid?: boolean;
+  label?: Renderable;
+  size?: ControlSize;
+  invalid?: boolean;
 };
-declare function Checkbox({ label, size, invalid, className, ...props }: CheckboxProps): react.JSX.Element;
-
+export declare function Checkbox({ label, size, invalid, className, ...props }: CheckboxProps): import("react").JSX.Element;
+//#endregion
+//#region src/atoms/IconButton/index.d.ts
 type IconButtonProps = Omit<ButtonHTMLAttributes<HTMLButtonElement>, "children"> & {
-    icon: Renderable;
-    label: string;
-    size?: ControlSize;
-    variant?: "ghost" | "solid" | "outline";
-    loading?: boolean;
-};
-declare function IconButton({ icon, label, size, variant, loading, disabled, className, type, ...props }: IconButtonProps): react.JSX.Element;
-
+  icon: Renderable;
+  label: string;
+  size?: ControlSize;
+  variant?: "ghost" | "solid" | "outline";
+  loading?: boolean;
+};
+export declare function IconButton({ icon, label, size, variant, loading, disabled, className, type, onClick, ...props }: IconButtonProps): import("react").JSX.Element;
+//#endregion
+//#region src/atoms/Input/index.d.ts
 type InputProps = Omit<InputHTMLAttributes<HTMLInputElement>, "size"> & {
-    invalid?: boolean;
-    size?: ControlSize;
+  invalid?: boolean;
+  size?: ControlSize;
 };
-declare function Input({ invalid, size, className, "aria-invalid": ariaInvalid, ...props }: InputProps): react.JSX.Element;
-
+export declare function Input({ invalid, size, className, "aria-invalid": ariaInvalid, ...props }: InputProps): import("react").JSX.Element;
+//#endregion
+//#region src/atoms/Kbd/index.d.ts
 type KbdProps = {
-    /**
-     * Key caps to render. An array draws one cap per entry (`["⌘", "K"]`);
-     * a single value draws one cap (`"Esc"`).
-     */
-    keys: Renderable;
-    className?: string;
-};
-declare function Kbd({ keys, className }: KbdProps): react.JSX.Element;
-
+  /**
+   * Key caps to render. An array draws one cap per entry (`["⌘", "K"]`);
+   * a single value draws one cap (`"Esc"`).
+   */
+  keys: Renderable;
+  className?: string;
+};
+export declare function Kbd({ keys, className }: KbdProps): import("react").JSX.Element;
+//#endregion
+//#region src/atoms/Progress/index.d.ts
 type ProgressProps = Omit<HTMLAttributes<HTMLDivElement>, "children"> & {
-    /** Completion from 0 to 100. Omit it for the indeterminate sweep. */
-    value?: number;
-    label?: string;
-    size?: ControlSize;
+  /** Completion from 0 to 100. Omit it for the indeterminate sweep. */
+  value?: number;
+  label?: string;
+  size?: ControlSize;
 };
-declare function Progress({ value, label, size, className, ...props }: ProgressProps): react.JSX.Element;
-
+export declare function Progress({ value, label, size, className, ...props }: ProgressProps): import("react").JSX.Element;
+//#endregion
+//#region src/atoms/ScrollArea/index.d.ts
 type ScrollAreaProps = Omit<HTMLAttributes<HTMLDivElement>, "children"> & {
-    orientation?: "vertical" | "horizontal" | "both";
-    children?: Renderable;
+  orientation?: "vertical" | "horizontal" | "both";
+  children?: Renderable;
 };
-declare function ScrollArea({ orientation, className, children, ...props }: ScrollAreaProps): react.JSX.Element;
-
+export declare function ScrollArea({ orientation, className, children, ...props }: ScrollAreaProps): import("react").JSX.Element;
+//#endregion
+//#region src/atoms/Separator/index.d.ts
 type SeparatorProps = Omit<HTMLAttributes<HTMLHRElement>, "children"> & {
-    orientation?: "horizontal" | "vertical";
-    decorative?: boolean;
+  orientation?: "horizontal" | "vertical";
+  decorative?: boolean;
 };
-declare function Separator({ orientation, decorative, className, ...props }: SeparatorProps): react.JSX.Element;
-
+export declare function Separator({ orientation, decorative, className, ...props }: SeparatorProps): import("react").JSX.Element;
+//#endregion
+//#region src/atoms/Skeleton/index.d.ts
 type SkeletonProps = HTMLAttributes<HTMLSpanElement> & {
-    width?: string | number;
-    height?: string | number;
+  width?: string | number;
+  height?: string | number;
 };
-declare function Skeleton({ width, height, className, style, "aria-label": ariaLabel, ...props }: SkeletonProps): react.JSX.Element;
-
+export declare function Skeleton({ width, height, className, style, "aria-label": ariaLabel, ...props }: SkeletonProps): import("react").JSX.Element;
+//#endregion
+//#region src/atoms/Slider/index.d.ts
 type SliderProps = Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "type" | "value" | "defaultValue" | "onChange" | "children" | "min" | "max" | "step"> & {
-    value: number;
-    onValueChange: (value: number) => void;
-    label: Renderable;
-    min?: number;
-    max?: number;
-    step?: number;
-    size?: ControlSize;
-    valueLabel?: Renderable;
-    invalid?: boolean;
-};
-declare function Slider({ value, onValueChange, label, min, max, step, size, valueLabel, invalid, className, disabled, style, id, "aria-label": ariaLabel, "aria-valuetext": ariaValueText, "aria-invalid": ariaInvalid, ...props }: SliderProps): react.JSX.Element;
-
+  value: number;
+  onValueChange: (value: number) => void;
+  label: Renderable;
+  min?: number;
+  max?: number;
+  step?: number;
+  size?: ControlSize;
+  valueLabel?: Renderable;
+  invalid?: boolean;
+};
+export declare function Slider({ value, onValueChange, label, min, max, step, size, valueLabel, invalid, className, disabled, style, id, "aria-label": ariaLabel, "aria-valuetext": ariaValueText, "aria-invalid": ariaInvalid, ...props }: SliderProps): import("react").JSX.Element;
+//#endregion
+//#region src/atoms/Spinner/index.d.ts
 type SpinnerProps = HTMLAttributes<HTMLSpanElement> & {
-    size?: ControlSize;
-    label?: string;
+  size?: ControlSize;
+  label?: string;
 };
-declare function Spinner({ size, label, className, ...props }: SpinnerProps): react.JSX.Element;
-
+export declare function Spinner({ size, label, className, ...props }: SpinnerProps): import("react").JSX.Element;
+//#endregion
+//#region src/atoms/Surface/index.d.ts
 type SurfaceProps = Omit<HTMLAttributes<HTMLDivElement>, "children"> & {
-    children?: Renderable;
-    tone?: "base" | "elevated" | "raised";
-    padding?: "none" | "sm" | "md" | "lg";
+  children?: Renderable;
+  tone?: "base" | "elevated" | "raised";
+  padding?: "none" | "sm" | "md" | "lg";
 };
-declare function Surface({ tone, padding, className, children, ...props }: SurfaceProps): react.JSX.Element;
-
+export declare function Surface({ tone, padding, className, children, ...props }: SurfaceProps): import("react").JSX.Element;
+//#endregion
+//#region src/atoms/Textarea/index.d.ts
 type TextareaProps = TextareaHTMLAttributes<HTMLTextAreaElement> & {
-    invalid?: boolean;
-    size?: ControlSize;
+  invalid?: boolean;
+  size?: ControlSize;
 };
-declare function Textarea({ invalid, size, className, "aria-invalid": ariaInvalid, ...props }: TextareaProps): react.JSX.Element;
-
+export declare function Textarea({ invalid, size, className, "aria-invalid": ariaInvalid, ...props }: TextareaProps): import("react").JSX.Element;
+//#endregion
+//#region src/atoms/Toggle/index.d.ts
 type ToggleProps = Omit<ButtonHTMLAttributes<HTMLButtonElement>, "onChange" | "onClick"> & {
-    checked: boolean;
-    onCheckedChange: (checked: boolean) => void;
-    label: string;
-    size?: ControlSize;
-    onClick?: (event: {
-        preventDefault(): void;
-    }) => void;
-};
-declare function Toggle({ checked, onCheckedChange, label, className, disabled, onClick, size, "aria-checked": ariaChecked, "aria-label": ariaLabel, ...props }: ToggleProps): react.JSX.Element;
-
+  checked: boolean;
+  onCheckedChange: (checked: boolean) => void;
+  label: string;
+  size?: ControlSize;
+  onClick?: (event: {
+    preventDefault(): void;
+  }) => void;
+};
+export declare function Toggle({ checked, onCheckedChange, label, className, disabled, onClick, size, "aria-checked": ariaChecked, "aria-label": ariaLabel, ...props }: ToggleProps): import("react").JSX.Element;
+//#endregion
+//#region src/lib/presence.d.ts
 type MotionSpeed = "fast" | "normal" | "slow";
 /** Parses a CSS time string ("180ms", "0.18s", "0ms") into milliseconds. */
-declare function parseDurationMs(value: string): number;
+export declare function parseDurationMs(value: string): number;
 /**
  * Reads the motion token in effect for an element, honouring theme
  * overrides, `prefers-reduced-motion`, and `data-sephiro-motion="off"`.
  * Returns 0 when there is nothing to wait for.
  */
-declare function motionDurationMs(element: HTMLElement | null, speed: MotionSpeed): number;
+export declare function motionDurationMs(element: HTMLElement | null, speed: MotionSpeed): number;
 type Presence<E extends HTMLElement = HTMLElement> = {
-    /** Keep rendering the overlay while its exit animation plays. */
-    present: boolean;
-    /** True once the overlay has begun leaving; drive exit styles with it. */
-    leaving: boolean;
-    /** `open` while settled, `closed` once leaving. */
-    state: "open" | "closed";
-    /** Attach to the overlay element so its exit duration can be measured. */
-    ref: RefObject<E | null>;
+  /** Keep rendering the overlay while its exit animation plays. */
+  present: boolean;
+  /** True once the overlay has begun leaving; drive exit styles with it. */
+  leaving: boolean;
+  /** `open` while settled, `closed` once leaving. */
+  state: "open" | "closed";
+  /** Attach to the overlay element so its exit duration can be measured. */
+  ref: RefObject<E | null>;
 };
 /**
  * Holds an overlay mounted for exactly as long as its exit animation runs.
@@ -168,421 +193,1011 @@ type Presence<E extends HTMLElement = HTMLElement> = {
  * return present ? <div ref={ref} data-state={state} /> : null;
  * ```
  */
-declare function usePresence<E extends HTMLElement = HTMLElement>(open: boolean, speed?: MotionSpeed): Presence<E>;
-
+export declare function usePresence<E extends HTMLElement = HTMLElement>(open: boolean, speed?: MotionSpeed): Presence<E>;
+//#endregion
+//#region src/molecules/Accordion/index.d.ts
+type AccordionItem = {
+  /** Identifies the panel across `value` and `defaultValue`. */
+  value: string;
+  trigger: Renderable;
+  children?: Renderable;
+  disabled?: boolean;
+};
+type AccordionProps = Omit<HTMLAttributes<HTMLDivElement>, "children" | "value" | "defaultValue"> & {
+  items: AccordionItem[];
+  /** `single` (default) keeps one panel open; `multiple` allows many. */
+  type?: "single" | "multiple";
+  /** Controlled set of open panels. */
+  value?: string[];
+  /** Panels open on first render. */
+  defaultValue?: string[];
+  onValueChange?: (value: string[]) => void;
+};
+export declare function Accordion({ items, type, value, defaultValue, onValueChange, className, ...props }: AccordionProps): import("react").JSX.Element;
+//#endregion
+//#region src/molecules/Alert/index.d.ts
 type AlertProps = Omit<HTMLAttributes<HTMLDivElement>, "children" | "title"> & {
-    variant?: "info" | "success" | "warning" | "danger";
-    title?: Renderable;
-    children?: Renderable;
-    dismissible?: boolean;
-    onDismiss?: () => void;
-};
-declare function Alert({ variant, title, children, dismissible, onDismiss, className, role, ...props }: AlertProps): react.JSX.Element | null;
-declare const Notice: typeof Alert;
+  variant?: "info" | "success" | "warning" | "danger";
+  title?: Renderable;
+  children?: Renderable;
+  dismissible?: boolean;
+  onDismiss?: () => void;
+};
+export declare function Alert({ variant, title, children, dismissible, onDismiss, className, role, ...props }: AlertProps): import("react").JSX.Element | null;
+export declare const Notice: typeof Alert;
 type NoticeProps = AlertProps;
-
+//#endregion
+//#region src/molecules/Attachment/index.d.ts
+type AttachmentStatus = "uploading" | "done" | "error";
+type AttachmentFile = {
+  id: string;
+  name: string;
+  size: string;
+  status?: AttachmentStatus;
+  progress?: number;
+  hint?: string;
+  href?: string;
+};
+type AttachmentProps = {
+  files: AttachmentFile[];
+  onRemove?: (id: string) => void;
+  ariaLabel?: string;
+  className?: string;
+};
+/** Exit delay that lets the leave transition run before the row unmounts. */
+export declare function Attachment({ files, onRemove, ariaLabel, className }: AttachmentProps): import("react").JSX.Element;
+//#endregion
+//#region src/molecules/AvatarGroup/index.d.ts
 type AvatarGroupItem = Pick<AvatarProps, "src" | "name" | "status">;
 type AvatarGroupProps = Omit<HTMLAttributes<HTMLSpanElement>, "children"> & {
-    avatars: AvatarGroupItem[];
-    /** Avatars shown before collapsing the rest into a `+N` chip. */
-    max?: number;
-    size?: ControlSize;
+  avatars: AvatarGroupItem[];
+  /** Avatars shown before collapsing the rest into a `+N` chip. */
+  max?: number;
+  size?: ControlSize;
 };
-declare function AvatarGroup({ avatars, max, size, className, ...props }: AvatarGroupProps): react.JSX.Element;
-
+export declare function AvatarGroup({ avatars, max, size, className, ...props }: AvatarGroupProps): import("react").JSX.Element;
+//#endregion
+//#region src/molecules/Breadcrumb/index.d.ts
+type BreadcrumbItem = {
+  label: Renderable;
+  /** Renders the crumb as a link. Wins over `onClick`. */
+  href?: string;
+  /** Renders the crumb as a button when there is no `href`. */
+  onClick?: () => void;
+  /** Leading icon shown before the label. */
+  icon?: Renderable;
+};
+type BreadcrumbProps = Omit<HTMLAttributes<HTMLElement>, "children"> & {
+  items: BreadcrumbItem[];
+  /** Separator drawn between crumbs. Defaults to a caret. */
+  separator?: Renderable;
+  /** Accessible name for the navigation landmark. */
+  label?: string;
+};
+export declare function Breadcrumb({ items, separator, label, className, ...props }: BreadcrumbProps): import("react").JSX.Element;
+//#endregion
+//#region src/molecules/Calendar/index.d.ts
+type CalendarRange = {
+  start: string | null;
+  end: string | null;
+};
+type CalendarProps = {
+  /** Selected day as `YYYY-MM-DD`. */
+  value?: string;
+  onValueChange?: (value: string) => void;
+  /** Displayed month as `YYYY-MM`. Uncontrolled pages keep their own state. */
+  month?: string;
+  onMonthChange?: (month: string) => void;
+  /** Earliest / latest selectable day (inclusive), as `YYYY-MM-DD`. */
+  min?: string;
+  max?: string;
+  /** First weekday: 0 = Sunday, 1 = Monday. Defaults to Monday. */
+  weekStartsOn?: 0 | 1;
+  mode?: "single" | "range";
+  range?: CalendarRange;
+  defaultRange?: CalendarRange;
+  onRangeChange?: (range: CalendarRange) => void;
+  months?: 1 | 2;
+  ariaLabel?: string;
+  className?: string;
+};
+export declare function Calendar({ value, onValueChange, month, onMonthChange, min, max, weekStartsOn, mode, range, defaultRange, onRangeChange, months, ariaLabel, className }: CalendarProps): import("react").JSX.Element;
+//#endregion
+//#region src/molecules/Card/index.d.ts
 type CardProps = Omit<HTMLAttributes<HTMLElement>, "children" | "title"> & {
-    title?: Renderable;
-    description?: Renderable;
-    header?: Renderable;
-    footer?: Renderable;
-    children?: Renderable;
-    interactive?: boolean;
-    selected?: boolean;
-};
-declare function Card({ title, description, header, footer, children, interactive, selected, className, ...props }: CardProps): react.JSX.Element;
-
+  title?: Renderable;
+  description?: Renderable;
+  header?: Renderable;
+  footer?: Renderable;
+  children?: Renderable;
+  interactive?: boolean;
+  selected?: boolean;
+};
+export declare function Card({ title, description, header, footer, children, interactive, selected, className, ...props }: CardProps): import("react").JSX.Element;
+//#endregion
+//#region src/molecules/Collapsible/index.d.ts
 type CollapsibleProps = Omit<HTMLAttributes<HTMLDivElement>, "children"> & {
-    trigger: Renderable;
-    children?: Renderable;
-    open?: boolean;
-    defaultOpen?: boolean;
-    onOpenChange?: (open: boolean) => void;
-    disabled?: boolean;
-};
-declare function Collapsible({ trigger, children, open, defaultOpen, onOpenChange, disabled, className, ...props }: CollapsibleProps): react.JSX.Element;
-
+  trigger: Renderable;
+  children?: Renderable;
+  open?: boolean;
+  defaultOpen?: boolean;
+  onOpenChange?: (open: boolean) => void;
+  disabled?: boolean;
+};
+export declare function Collapsible({ trigger, children, open, defaultOpen, onOpenChange, disabled, className, ...props }: CollapsibleProps): import("react").JSX.Element;
+//#endregion
+//#region src/molecules/Combobox/index.d.ts
 type ComboboxOption = {
-    value: string;
-    label: Renderable;
-    disabled?: boolean;
-    /** Groups options under a heading; ungrouped options come first. */
-    group?: string;
-    /** Extra terms matched by the filter but never highlighted. */
-    keywords?: string;
+  value: string;
+  label: Renderable;
+  disabled?: boolean;
+  /** Groups options under a heading; ungrouped options come first. */
+  group?: string;
+  /** Extra terms matched by the filter but never highlighted. */
+  keywords?: string;
 };
 type ComboboxProps = {
-    options: ComboboxOption[];
-    /** Single-select value. Omit it and pass `values` for multi-select. */
-    value?: string;
-    /** Multi-select values; selecting keeps the popup open. */
-    values?: string[];
-    onValueChange?: (value: string) => void;
-    onValuesChange?: (values: string[]) => void;
-    placeholder?: Renderable;
-    searchPlaceholder?: string;
-    emptyMessage?: Renderable;
-    disabled?: boolean;
-    size?: ControlSize;
-    id?: string;
-    ariaLabel?: string;
-    className?: string;
-};
-declare function Combobox({ options, value, values, onValueChange, onValuesChange, placeholder, searchPlaceholder, emptyMessage, disabled, size, id, ariaLabel, className, }: ComboboxProps): react.JSX.Element;
-
+  options: ComboboxOption[];
+  /** Single-select value. Omit it and pass `values` for multi-select. */
+  value?: string;
+  /** Multi-select values; selecting keeps the popup open. */
+  values?: string[];
+  onValueChange?: (value: string) => void;
+  onValuesChange?: (values: string[]) => void;
+  placeholder?: Renderable;
+  searchPlaceholder?: string;
+  emptyMessage?: Renderable;
+  disabled?: boolean;
+  size?: ControlSize;
+  id?: string;
+  ariaLabel?: string;
+  className?: string;
+};
+export declare function Combobox({ options, value, values, onValueChange, onValuesChange, placeholder, searchPlaceholder, emptyMessage, disabled, size, id, ariaLabel, className }: ComboboxProps): import("react").JSX.Element;
+//#endregion
+//#region src/molecules/Menu/MenuContent.d.ts
+type MenuItem = {
+  value?: string;
+  label?: Renderable;
+  icon?: Renderable;
+  shortcut?: Renderable;
+  disabled?: boolean;
+  danger?: boolean;
+  separator?: boolean;
+};
+//#endregion
+//#region src/molecules/ContextMenu/index.d.ts
+type ContextMenuProps = Omit<HTMLAttributes<HTMLDivElement>, "children" | "onContextMenu" | "onSelect"> & {
+  children: Renderable;
+  items: MenuItem[];
+  onSelect?: (value: string) => void;
+  disabled?: boolean;
+  label?: string;
+};
+/**
+ * A menu that opens under the pointer: right-click (or the ContextMenu key)
+ * on the surface, the popup clamps itself to the viewport and hands focus to
+ * its first item. Escape and selection return focus to the surface.
+ */
+export declare function ContextMenu({ children, items, onSelect, disabled, label, className, ...props }: ContextMenuProps): import("react").JSX.Element;
+//#endregion
+//#region src/molecules/Dialog/index.d.ts
 type DialogProps = {
-    open: boolean;
-    onClose: () => void;
-    title: Renderable;
-    description?: Renderable;
-    children?: Renderable;
-    footer?: Renderable;
-    closeLabel?: string;
-    closeOnOverlayClick?: boolean;
-    className?: string;
-};
-declare function Dialog({ open, onClose, title, description, children, footer, closeLabel, closeOnOverlayClick, className, }: DialogProps): react.JSX.Element | null;
-
+  open: boolean;
+  onClose: () => void;
+  title: Renderable;
+  description?: Renderable;
+  children?: Renderable;
+  footer?: Renderable;
+  closeLabel?: string;
+  closeOnOverlayClick?: boolean;
+  closeOnEscape?: boolean;
+  initialFocus?: () => HTMLElement | null;
+  returnFocus?: boolean | (() => HTMLElement | null);
+  className?: string;
+};
+export declare function Dialog({ open, onClose, title, description, children, footer, closeLabel, closeOnOverlayClick, closeOnEscape, initialFocus, returnFocus, className }: DialogProps): import("react").JSX.Element | null;
+//#endregion
+//#region src/molecules/Drawer/index.d.ts
 type DrawerSide = "left" | "right" | "bottom";
 type DrawerProps = {
-    open: boolean;
-    onClose: () => void;
-    title: Renderable;
-    description?: Renderable;
-    children?: Renderable;
-    footer?: Renderable;
-    side?: DrawerSide;
-    size?: "sm" | "md" | "lg";
-    closeLabel?: string;
-    closeOnOverlayClick?: boolean;
-    className?: string;
-};
-declare function Drawer({ open, onClose, title, description, children, footer, side, size, closeLabel, closeOnOverlayClick, className, }: DrawerProps): react.JSX.Element | null;
-
+  open: boolean;
+  onClose: () => void;
+  title: Renderable;
+  description?: Renderable;
+  children?: Renderable;
+  footer?: Renderable;
+  side?: DrawerSide;
+  size?: "sm" | "md" | "lg";
+  closeLabel?: string;
+  closeOnOverlayClick?: boolean;
+  closeOnEscape?: boolean;
+  initialFocus?: () => HTMLElement | null;
+  returnFocus?: boolean | (() => HTMLElement | null);
+  className?: string;
+};
+export declare function Drawer({ open, onClose, title, description, children, footer, side, size, closeLabel, closeOnOverlayClick, closeOnEscape, initialFocus, returnFocus, className }: DrawerProps): import("react").JSX.Element | null;
+//#endregion
+//#region src/molecules/FieldMessage/index.d.ts
 type FieldMessageProps = Omit<HTMLAttributes<HTMLParagraphElement>, "children"> & {
-    variant?: "hint" | "error" | "success";
-    children?: Renderable;
+  variant?: "hint" | "error" | "success";
+  children?: Renderable;
 };
-declare function FieldMessage({ variant, className, children, ...props }: FieldMessageProps): react.JSX.Element | null;
-
+export declare function FieldMessage({ variant, className, children, ...props }: FieldMessageProps): import("react").JSX.Element | null;
+//#endregion
+//#region src/molecules/Field/index.d.ts
 type FieldProps = {
-    label?: Renderable;
-    htmlFor?: string;
-    description?: Renderable;
-    message?: Renderable;
-    messageType?: FieldMessageProps["variant"];
-    required?: boolean;
-    className?: string;
-    children?: Renderable;
-};
-declare function Field({ label, htmlFor, description, message, messageType, required, className, children, }: FieldProps): react.JSX.Element;
-
+  label?: Renderable;
+  htmlFor?: string;
+  description?: Renderable;
+  message?: Renderable;
+  messageType?: FieldMessageProps["variant"];
+  required?: boolean;
+  className?: string;
+  children?: Renderable;
+};
+export declare function Field({ label, htmlFor, description, message, messageType, required, className, children }: FieldProps): import("react").JSX.Element;
+//#endregion
+//#region src/lib/overlay.d.ts
 type OverlaySide = "top" | "bottom" | "left" | "right";
-
+//#endregion
+//#region src/molecules/HoverCard/index.d.ts
 type HoverCardProps = {
-    trigger: Renderable;
-    children: Renderable;
-    /** Grace before opening, so passing the trigger never flickers. */
-    openDelay?: number;
-    /** Grace before closing, so the pointer can travel into the card. */
-    closeDelay?: number;
-    placement?: OverlaySide;
-    ariaLabel?: string;
-    className?: string;
-};
-declare function HoverCard({ trigger, children, openDelay, closeDelay, placement, ariaLabel, className, }: HoverCardProps): react.JSX.Element;
-
-type MenuItem = {
-    value?: string;
-    label?: Renderable;
-    icon?: Renderable;
-    shortcut?: Renderable;
-    disabled?: boolean;
-    danger?: boolean;
-    separator?: boolean;
+  trigger: Renderable;
+  children: Renderable;
+  /** Grace before opening, so passing the trigger never flickers. */
+  openDelay?: number;
+  /** Grace before closing, so the pointer can travel into the card. */
+  closeDelay?: number;
+  placement?: OverlaySide;
+  ariaLabel?: string;
+  asChild?: boolean;
+  className?: string;
 };
+export declare function HoverCard({ trigger, children, openDelay, closeDelay, placement, ariaLabel, asChild, className }: HoverCardProps): import("react").JSX.Element;
+//#endregion
+//#region src/molecules/Menu/index.d.ts
 type MenuProps = {
-    trigger: Renderable;
-    items: MenuItem[];
-    onSelect?: (value: string) => void;
-    label?: string;
-    align?: "start" | "end";
-    disabled?: boolean;
-    className?: string;
-};
-declare function Menu({ trigger, items, onSelect, label, align, disabled, className, }: MenuProps): react.JSX.Element;
-
+  trigger: Renderable;
+  items: MenuItem[];
+  onSelect?: (value: string) => void;
+  /** Controlled open state. */
+  open?: boolean;
+  /** Fires whenever the menu asks to open or close. */
+  onOpenChange?: (open: boolean) => void;
+  label?: string;
+  align?: "start" | "end";
+  disabled?: boolean;
+  asChild?: boolean;
+  className?: string;
+};
+export declare function Menu({ trigger, items, onSelect, label, align, open: openProp, onOpenChange, disabled, asChild, className }: MenuProps): import("react").JSX.Element;
+//#endregion
+//#region src/molecules/OTPInput/index.d.ts
+type OTPPattern = "numeric" | "alphanumeric" | RegExp;
+type OTPState = "idle" | "verifying" | "success" | "error";
+type OTPInputProps = {
+  /** The full code, owned by the parent. */
+  value: string;
+  onChange?: (value: string) => void;
+  /** Fires once when the last cell fills. */
+  onComplete?: (value: string) => void;
+  /** Number of cells. Defaults to 6. */
+  length?: number;
+  groups?: number[];
+  pattern?: OTPPattern;
+  state?: OTPState;
+  placeholder?: string;
+  clearOnError?: boolean;
+  disabled?: boolean;
+  invalid?: boolean;
+  autoFocus?: boolean;
+  ariaLabel?: string;
+  id?: string;
+  name?: string;
+  "aria-describedby"?: string;
+  className?: string;
+};
+export declare function OTPInput({ value, onChange, onComplete, length, groups, pattern, state, placeholder, clearOnError, disabled, invalid, autoFocus, ariaLabel, id, name, "aria-describedby": describedBy, className }: OTPInputProps): import("react").JSX.Element;
+//#endregion
+//#region src/molecules/Pagination/index.d.ts
+type PaginationProps = Omit<HTMLAttributes<HTMLElement>, "onChange"> & {
+  /** Current page, 1-based. */
+  page: number;
+  pageCount: number;
+  onPageChange?: (page: number) => void;
+  /** Numbers shown either side of the current page. Default 1. */
+  siblings?: number;
+  /** Readout drawn on the right: "1–20 of 340". */
+  status?: Renderable;
+  /** Accessible name for the nav landmark. */
+  label?: string;
+};
+export declare function Pagination({ page, pageCount, onPageChange, siblings, status, label, className, ...props }: PaginationProps): import("react").JSX.Element | null;
+//#endregion
+//#region src/molecules/Popover/index.d.ts
 type PopoverProps = {
-    trigger: Renderable;
-    children: Renderable;
-    open?: boolean;
-    defaultOpen?: boolean;
-    onOpenChange?: (open: boolean) => void;
-    ariaLabel?: string;
-    placement?: "start" | "end";
-    disabled?: boolean;
-    className?: string;
-};
-declare function Popover({ trigger, children, open, defaultOpen, onOpenChange, ariaLabel, placement, disabled, className, }: PopoverProps): react.JSX.Element;
-
+  trigger: Renderable;
+  children: Renderable;
+  open?: boolean;
+  defaultOpen?: boolean;
+  onOpenChange?: (open: boolean) => void;
+  ariaLabel?: string;
+  placement?: "start" | "end";
+  disabled?: boolean;
+  asChild?: boolean;
+  className?: string;
+};
+export declare function Popover({ trigger, children, open, defaultOpen, onOpenChange, ariaLabel, placement, disabled, asChild, className }: PopoverProps): import("react").JSX.Element;
+//#endregion
+//#region src/molecules/QuestionCard/index.d.ts
+type QuestionOption = {
+  value: string;
+  label: Renderable;
+  /** Secondary line under the label. */
+  hint?: Renderable;
+  disabled?: boolean;
+};
+type QuestionCardProps = Omit<HTMLAttributes<HTMLDivElement>, "children" | "value" | "defaultValue"> & {
+  question: Renderable;
+  /** Helper line under the question. */
+  description?: Renderable;
+  options: QuestionOption[];
+  /** Controlled selected option. */
+  value?: string;
+  /** Selected option on first render. */
+  defaultValue?: string;
+  onValueChange?: (value: string) => void;
+  /** Correct option. Setting it locks the card and shows the verdict. */
+  answer?: string;
+  /** Row under the options: submit buttons, hints, score. */
+  footer?: Renderable;
+  disabled?: boolean;
+};
+export declare function QuestionCard({ question, description, options, value, defaultValue, onValueChange, answer, footer, disabled, className, ...props }: QuestionCardProps): import("react").JSX.Element;
+//#endregion
+//#region src/molecules/RadioGroup/index.d.ts
 type RadioOption = {
-    value: string;
-    label: Renderable;
-    description?: Renderable;
-    disabled?: boolean;
+  value: string;
+  label: Renderable;
+  description?: Renderable;
+  disabled?: boolean;
 };
 type RadioGroupProps = {
-    value: string;
-    options: RadioOption[];
-    onValueChange: (value: string) => void;
-    name: string;
-    label?: Renderable;
-    description?: Renderable;
-    size?: ControlSize;
-    orientation?: "horizontal" | "vertical";
-    disabled?: boolean;
-    className?: string;
-};
-declare function RadioGroup({ value, options, onValueChange, name, label, description, size, orientation, disabled, className, }: RadioGroupProps): react.JSX.Element;
-
+  value: string;
+  options: RadioOption[];
+  onValueChange: (value: string) => void;
+  name: string;
+  label?: Renderable;
+  description?: Renderable;
+  size?: ControlSize;
+  orientation?: "horizontal" | "vertical";
+  disabled?: boolean;
+  className?: string;
+};
+export declare function RadioGroup({ value, options, onValueChange, name, label, description, size, orientation, disabled, className }: RadioGroupProps): import("react").JSX.Element;
+//#endregion
+//#region src/molecules/Reveal/index.d.ts
+type RevealProps = Omit<HTMLAttributes<HTMLDivElement>, "children"> & {
+  children: Renderable;
+  trigger?: "mount" | "scroll";
+  direction?: "up" | "down" | "left" | "right" | "none";
+  distance?: number;
+  delay?: number;
+  speed?: MotionSpeed;
+  once?: boolean;
+};
+export declare function Reveal({ children, trigger, direction, distance, delay, speed, once, className, style, ...props }: RevealProps): import("react").JSX.Element;
+//#endregion
+//#region src/molecules/Select/index.d.ts
 type SelectOption = {
-    value: string;
-    label: Renderable;
-    disabled?: boolean;
+  value: string;
+  label: Renderable;
+  disabled?: boolean;
 };
 type SelectProps = {
-    value: string;
-    options: SelectOption[];
-    onValueChange: (value: string) => void;
-    id?: string;
-    className?: string;
-    placeholder?: Renderable;
-    ariaLabel?: string;
-    ariaLabelledBy?: string;
-    disabled?: boolean;
-    size?: ControlSize;
-};
-declare function Select({ value, options, onValueChange, id, className, placeholder, ariaLabel, ariaLabelledBy, disabled, size, }: SelectProps): react.JSX.Element;
-
+  value: string;
+  options: SelectOption[];
+  onValueChange: (value: string) => void;
+  id?: string;
+  className?: string;
+  placeholder?: Renderable;
+  ariaLabel?: string;
+  ariaLabelledBy?: string;
+  disabled?: boolean;
+  size?: ControlSize;
+};
+export declare function Select({ value, options, onValueChange, id, className, placeholder, ariaLabel, ariaLabelledBy, disabled, size }: SelectProps): import("react").JSX.Element;
+//#endregion
+//#region src/molecules/Stat/index.d.ts
+type StatProps = Omit<HTMLAttributes<HTMLDivElement>, "children"> & {
+  label: Renderable;
+  value: Renderable;
+  hint?: Renderable;
+};
+export declare function Stat({ label, value, hint, className, ...props }: StatProps): import("react").JSX.Element;
+type StatGroupProps = Omit<HTMLAttributes<HTMLDivElement>, "children"> & {
+  children: Renderable;
+  columns?: number;
+};
+export declare function StatGroup({ children, columns, className, style, ...props }: StatGroupProps): import("react").JSX.Element;
+type DeltaProps = Omit<HTMLAttributes<HTMLSpanElement>, "children" | "title"> & {
+  value: number;
+  format?: (value: number) => string;
+};
+export declare function Delta({ value, format, className, ...props }: DeltaProps): import("react").JSX.Element;
+//#endregion
+//#region src/molecules/Tabs/index.d.ts
 type TabItem = {
-    value: string;
-    label: Renderable;
-    disabled?: boolean;
-    content?: Renderable;
+  value: string;
+  label: Renderable;
+  disabled?: boolean;
+  content?: Renderable;
 };
 type TabsProps = {
-    items: TabItem[];
-    value?: string;
-    defaultValue?: string;
-    onValueChange?: (value: string) => void;
-    children?: Renderable;
-    ariaLabel?: string;
-    orientation?: "horizontal" | "vertical";
-    className?: string;
-};
-declare function Tabs({ items, value, defaultValue, onValueChange, children, ariaLabel, orientation, className, }: TabsProps): react.JSX.Element;
-
+  items: TabItem[];
+  value?: string;
+  defaultValue?: string;
+  onValueChange?: (value: string) => void;
+  children?: Renderable;
+  ariaLabel?: string;
+  orientation?: "horizontal" | "vertical";
+  className?: string;
+};
+export declare function Tabs({ items, value, defaultValue, onValueChange, children, ariaLabel, orientation, className }: TabsProps): import("react").JSX.Element;
+//#endregion
+//#region src/molecules/TaskList/index.d.ts
+type TaskState = "todo" | "doing" | "done";
+type TaskListItem = {
+  /** Stable id reported back through `onStateChange`. */
+  id: string;
+  label: Renderable;
+  state?: TaskState;
+  /** Trailing meta: due date, assignee, counters. */
+  meta?: Renderable;
+  disabled?: boolean;
+};
+type TaskListProps = Omit<HTMLAttributes<HTMLUListElement>, "children" | "onChange"> & {
+  items: TaskListItem[];
+  /**
+   * Fires with the next state when a row's check is pressed:
+   * todo → doing → done → todo.
+   */
+  onStateChange?: (id: string, state: TaskState) => void;
+  /** Accessible name for the list. */
+  label?: string;
+};
+export declare function TaskList({ items, onStateChange, label, className, ...props }: TaskListProps): import("react").JSX.Element;
+//#endregion
+//#region src/molecules/Timeline/index.d.ts
+type TimelineItem = {
+  /** Event title. */
+  title: Renderable;
+  /** Body rendered under the head. */
+  children?: Renderable;
+  /** Right-aligned time or meta. */
+  timestamp?: Renderable;
+  /** Leading icon in place of the default dot. */
+  icon?: Renderable;
+  tone?: "default" | "accent" | "success" | "danger";
+  /** Marks the latest event: its marker keeps breathing. */
+  current?: boolean;
+};
+type TimelineProps = Omit<HTMLAttributes<HTMLElement>, "children"> & {
+  items: TimelineItem[];
+  /** Accessible name for the list. */
+  label?: string;
+};
+export declare function Timeline({ items, label, className, ...props }: TimelineProps): import("react").JSX.Element;
+//#endregion
+//#region src/molecules/Toast/index.d.ts
 type ToastProps = {
-    open?: boolean;
-    id?: string | number;
-    title: Renderable;
-    description?: Renderable;
-    variant?: "neutral" | "success" | "warning" | "danger";
-    action?: ExternalToast["action"];
-    duration?: number;
-    closeButton?: boolean;
-    className?: string;
-};
-declare function Toast({ open, id, title, description, variant, action, duration, closeButton, className, }: ToastProps): null;
+  open?: boolean;
+  id?: string | number;
+  title: Renderable;
+  description?: Renderable;
+  variant?: "neutral" | "success" | "warning" | "danger";
+  action?: ExternalToast["action"];
+  duration?: number;
+  closeButton?: boolean;
+  className?: string;
+};
+export declare function Toast({ open, id, title, description, variant, action, duration, closeButton, className }: ToastProps): null;
 type ToastViewportProps = Omit<ToasterProps, "className" | "containerAriaLabel" | "icons" | "toastOptions"> & {
-    label?: string;
-    className?: string;
-    toastOptions?: ToasterProps["toastOptions"];
+  label?: string;
+  className?: string;
+  toastOptions?: ToasterProps["toastOptions"];
 };
-declare function ToastViewport({ label, className, toastOptions, theme, position, closeButton, expand, ...props }: ToastViewportProps): react.JSX.Element;
-
+export declare function ToastViewport({ label, className, toastOptions, theme, position, closeButton, expand, ...props }: ToastViewportProps): import("react").JSX.Element;
+//#endregion
+//#region src/molecules/Toolbar/index.d.ts
 type ToolbarProps = Omit<HTMLAttributes<HTMLDivElement>, "children"> & {
-    label?: string;
-    orientation?: "horizontal" | "vertical";
-    size?: ControlSize;
-    start?: Renderable;
-    end?: Renderable;
-    children?: Renderable;
-};
-declare function Toolbar({ label, orientation, size, start, end, children, className, ...props }: ToolbarProps): react.JSX.Element;
-
+  label?: string;
+  orientation?: "horizontal" | "vertical";
+  size?: ControlSize;
+  start?: Renderable;
+  end?: Renderable;
+  children?: Renderable;
+};
+export declare function Toolbar({ label, orientation, size, start, end, children, className, ...props }: ToolbarProps): import("react").JSX.Element;
+//#endregion
+//#region src/molecules/Tooltip/index.d.ts
 type TooltipProps = {
-    content: Renderable;
-    children: Renderable;
-    side?: "top" | "right" | "bottom" | "left";
-    delay?: number;
-    disabled?: boolean;
-    className?: string;
-};
-declare function Tooltip({ content, children, side, delay, disabled, className, }: TooltipProps): react.JSX.Element;
-
+  content: Renderable;
+  children: Renderable;
+  side?: "top" | "right" | "bottom" | "left";
+  delay?: number;
+  disabled?: boolean;
+  className?: string;
+};
+type TooltipGroupProps = {
+  delay?: number;
+  skipDelay?: number;
+  children?: Renderable;
+};
+export declare function TooltipGroup({ delay, skipDelay, children }: TooltipGroupProps): import("react").JSX.Element;
+export declare function Tooltip({ content, children, side, delay, disabled, className }: TooltipProps): import("react").JSX.Element;
+//#endregion
+//#region src/organisms/Chart/index.d.ts
+type ChartSeries = {
+  name: string;
+  /** One entry per category; `null` breaks the line into segments. */
+  values: (number | null)[];
+  tone?: "accent" | "success" | "danger" | "muted";
+};
+type ChartProps = Omit<HTMLAttributes<HTMLElement>, "children"> & {
+  /** Labels along the x-axis. */
+  categories: string[];
+  series: ChartSeries[];
+  /** Marks drawn on the plot. Default "line". */
+  variant?: "line" | "bar" | "area";
+  /** Plot height in pixels. Default 160. */
+  height?: number;
+  /** Curve the line (Catmull-Rom). Default false. */
+  smooth?: boolean;
+  /** Target y-axis ticks; nice numbers win. Default 4. */
+  ticks?: number;
+  /** Formats axis and tooltip values. Trims decimals by default. */
+  format?: (value: number) => string;
+  /** Show the legend. Defaults to shown for more than one series. */
+  legend?: boolean;
+  /** Accessible summary for the plot. */
+  label?: string;
+};
+export declare function Chart({ categories, series, variant, height, smooth, ticks, format, legend, label, className, ...props }: ChartProps): import("react").JSX.Element;
+//#endregion
+//#region src/organisms/CommandPalette/index.d.ts
 type CommandItem = {
-    id?: string;
-    label: Renderable;
-    /** Value reported to `onSelect` when omitted (falls back to the label). */
-    value?: string;
-    icon?: Renderable;
-    /** Groups options under a heading; ungrouped options always come first. */
-    group?: string;
-    /** Muted text trailing the option (chevrons are drawn for parents). */
-    hint?: Renderable;
-    badge?: Renderable;
-    shortcut?: string[];
-    /** Extra terms matched by the filter but never highlighted. */
-    keywords?: string;
-    disabled?: boolean;
-    /** Sub-options: activating this option drills into a new level. */
-    children?: CommandItem[];
+  id?: string;
+  label: Renderable;
+  /** Value reported to `onSelect` when omitted (falls back to the label). */
+  value?: string;
+  icon?: Renderable;
+  /** Groups options under a heading; ungrouped options always come first. */
+  group?: string;
+  /** Muted text trailing the option (chevrons are drawn for parents). */
+  hint?: Renderable;
+  badge?: Renderable;
+  shortcut?: string[];
+  /** Extra terms matched by the filter but never highlighted. */
+  keywords?: string;
+  disabled?: boolean;
+  /** Sub-options: activating this option drills into a new level. */
+  children?: CommandItem[];
 };
 type CommandPaletteProps = {
-    open: boolean;
-    onOpenChange: (open: boolean) => void;
-    items: CommandItem[];
-    onSelect?: (item: CommandItem) => void;
-    placeholder?: string;
-    emptyMessage?: Renderable;
-    /** Label of the breadcrumb that returns to the root level. */
-    homeLabel?: string;
-    ariaLabel?: string;
-    /** Bind Cmd/Ctrl+K to toggle the palette. Default: true. */
-    hotkey?: boolean;
-    className?: string;
-};
-declare function CommandPalette({ open, onOpenChange, items, onSelect, placeholder, emptyMessage, homeLabel, ariaLabel, hotkey, className, }: CommandPaletteProps): react.ReactPortal | null;
-
+  open: boolean;
+  onOpenChange: (open: boolean) => void;
+  items: CommandItem[];
+  onSelect?: (item: CommandItem) => void;
+  placeholder?: string;
+  emptyMessage?: Renderable;
+  /** Label of the breadcrumb that returns to the root level. */
+  homeLabel?: string;
+  ariaLabel?: string;
+  /** Bind Cmd/Ctrl+K to toggle the palette. Default: false. */
+  hotkey?: boolean;
+  className?: string;
+};
+export declare function CommandPalette({ open, onOpenChange, items, onSelect, placeholder, emptyMessage, homeLabel, ariaLabel, hotkey, className }: CommandPaletteProps): import("react").ReactPortal | null;
+//#endregion
+//#region src/organisms/EmptyState/index.d.ts
 type EmptyStateProps = Omit<HTMLAttributes<HTMLElement>, "children" | "title"> & {
-    title: Renderable;
-    description?: Renderable;
-    icon?: Renderable;
-    action?: Renderable;
-    compact?: boolean;
-};
-declare function EmptyState({ title, description, icon, action, compact, className, ...props }: EmptyStateProps): react.JSX.Element;
-
+  title: Renderable;
+  description?: Renderable;
+  icon?: Renderable;
+  action?: Renderable;
+  compact?: boolean;
+};
+export declare function EmptyState({ title, description, icon, action, compact, className, ...props }: EmptyStateProps): import("react").JSX.Element;
+//#endregion
+//#region src/organisms/MagneticDropzone/index.d.ts
+type DropzoneRejectReason = "type" | "size" | "count";
+type DropzoneFileLike = {
+  name: string;
+  type: string;
+  size: number;
+};
+type DropzoneValidation = {
+  accept?: string;
+  multiple?: boolean;
+  maxFiles?: number;
+  maxSize?: number;
+};
+type DropzoneValidationResult<T extends DropzoneFileLike> = {
+  accepted: T[];
+  rejected: {
+    reason: DropzoneRejectReason;
+    files: T[];
+  }[];
+};
 type MagneticDropzoneProps = Omit<React.HTMLAttributes<HTMLDivElement>, "onDrop" | "onDragOver" | "children"> & {
-    /** Idle content: an icon, instructions, a choose-file button. */
-    children?: Renderable;
-    /** Replaces `children` while files hover over the zone. */
-    activeContent?: Renderable;
-    onFiles?: (files: File[]) => void;
-    /** Forwarded to the hidden file input, e.g. "image/*,.pdf". */
-    accept?: string;
-    multiple?: boolean;
-    disabled?: boolean;
-    className?: string;
+  /** Idle content: an icon, instructions, a choose-file button. */
+  children?: Renderable;
+  /** Replaces `children` while files hover over the zone. */
+  activeContent?: Renderable;
+  onFiles?: (files: File[]) => void;
+  onReject?: (files: File[], reason: DropzoneRejectReason) => void;
+  /** Forwarded to the hidden file input, e.g. "image/*,.pdf". */
+  accept?: string;
+  multiple?: boolean;
+  maxFiles?: number;
+  maxSize?: number;
+  disabled?: boolean;
+  label?: string;
+  trigger?: "zone" | "children";
+  className?: string;
 };
+export declare function validateDropzoneFiles<T extends DropzoneFileLike>(files: readonly T[], { accept, multiple, maxFiles, maxSize }?: DropzoneValidation): DropzoneValidationResult<T>;
+export declare function describeDropzoneResult(result: DropzoneValidationResult<DropzoneFileLike>): string;
 /**
  * A drop zone whose content leans toward the pointer while files hover —
  * the pull is a CSS variable updated on dragover, so the attraction stays
  * cheap and collapses with the motion tokens.
  */
-declare function MagneticDropzone({ children, activeContent, onFiles, accept, multiple, disabled, className, ...props }: MagneticDropzoneProps): react.JSX.Element;
-
+export declare function MagneticDropzone({ children, activeContent, onFiles, onReject, accept, multiple, maxFiles, maxSize, disabled, label, trigger, className, "aria-label": ariaLabel, "aria-describedby": ariaDescribedBy, onPaste, ...props }: MagneticDropzoneProps): import("react").JSX.Element;
+//#endregion
+//#region src/organisms/Menubar/index.d.ts
+type MenubarMenu = {
+  /** Accessible name for the menu and its trigger. */
+  label: string;
+  /** Rich trigger content; falls back to the label. */
+  trigger?: Renderable;
+  items: MenuItem[];
+  disabled?: boolean;
+};
+type MenubarProps = Omit<HTMLAttributes<HTMLDivElement>, "children" | "onSelect"> & {
+  menus: MenubarMenu[];
+  onSelect?: (value: string) => void;
+  /** Accessible name for the bar itself. */
+  label?: string;
+};
+/**
+ * The classic application menu bar. Menus run controlled off a single
+ * `openIndex`: hovering a closed bar opens after a short intent delay, an
+ * already-open bar slides straight across, and the arrow keys walk the
+ * triggers with wrap-around.
+ */
+export declare function Menubar({ menus, onSelect, label, className, ...props }: MenubarProps): import("react").JSX.Element;
+//#endregion
+//#region src/organisms/ReasoningSteps/index.d.ts
 type ReasoningStep = {
-    id?: string;
-    title: Renderable;
-    detail?: Renderable;
-    status?: "pending" | "active" | "done";
+  id?: string;
+  title: Renderable;
+  detail?: Renderable;
+  status?: "pending" | "active" | "done";
 };
 type ReasoningStepsProps = {
-    steps: ReasoningStep[];
-    /** Header label. Default: "Reasoning". */
-    label?: Renderable;
-    open?: boolean;
-    defaultOpen?: boolean;
-    onOpenChange?: (open: boolean) => void;
-    className?: string;
-};
-declare function ReasoningSteps({ steps, label, open, defaultOpen, onOpenChange, className, }: ReasoningStepsProps): react.JSX.Element;
-
+  steps: ReasoningStep[];
+  label?: Renderable;
+  open?: boolean;
+  defaultOpen?: boolean;
+  onOpenChange?: (open: boolean) => void;
+  className?: string;
+};
+export declare function ReasoningSteps({ steps, label, open, defaultOpen, onOpenChange, className }: ReasoningStepsProps): import("react").JSX.Element;
+//#endregion
+//#region src/organisms/Resizable/index.d.ts
 type ResizableProps = Omit<HTMLAttributes<HTMLDivElement>, "children"> & {
-    /** The panes, in visual order. A handle is rendered between each pair. */
-    panes: Renderable[];
-    direction?: "horizontal" | "vertical";
-    /** Controlled pane sizes in percent; they should sum to 100. */
-    sizes?: number[];
-    defaultSizes?: number[];
-    onSizesChange?: (sizes: number[]) => void;
-    /** Smallest share a pane may keep, in percent. Default: 10. */
-    min?: number;
-    handleLabel?: string;
-};
-declare function Resizable({ panes, direction, sizes, defaultSizes, onSizesChange, min, handleLabel, className, ...props }: ResizableProps): react.JSX.Element;
-
+  /** The panes, in visual order. A handle is rendered between each pair. */
+  panes: Renderable[];
+  direction?: "horizontal" | "vertical";
+  /** Controlled pane sizes in percent; they should sum to 100. */
+  sizes?: number[];
+  defaultSizes?: number[];
+  onSizesChange?: (sizes: number[]) => void;
+  /** Smallest share a pane may keep, in percent. Default: 10. */
+  min?: number;
+  handleLabel?: string;
+};
+export declare function Resizable({ panes, direction, sizes, defaultSizes, onSizesChange, min, handleLabel, className, ...props }: ResizableProps): import("react").JSX.Element;
+//#endregion
+//#region src/organisms/Sidebar/index.d.ts
 type SidebarItem = {
-    value: string;
-    label: Renderable;
-    icon?: Renderable;
-    badge?: Renderable;
-    disabled?: boolean;
+  value: string;
+  label: Renderable;
+  icon?: Renderable;
+  badge?: Renderable;
+  disabled?: boolean;
 };
 type SidebarSection = {
-    title?: string;
-    items: SidebarItem[];
+  title?: string;
+  items: SidebarItem[];
 };
 type SidebarProps = Omit<HTMLAttributes<HTMLElement>, "children" | "onSelect"> & {
-    sections: SidebarSection[];
-    /** Controlled active item. */
-    value?: string;
-    defaultValue?: string;
-    onSelect?: (value: string) => void;
-    header?: Renderable;
-    footer?: Renderable;
-    /** Show the collapse toggle. Default: false. */
-    collapsible?: boolean;
-    collapsed?: boolean;
-    defaultCollapsed?: boolean;
-    onCollapsedChange?: (collapsed: boolean) => void;
-    ariaLabel?: string;
-};
-declare function Sidebar({ sections, value, defaultValue, onSelect, header, footer, collapsible, collapsed, defaultCollapsed, onCollapsedChange, ariaLabel, className, ...props }: SidebarProps): react.JSX.Element;
-
+  sections: SidebarSection[];
+  /** Controlled active item. */
+  value?: string;
+  defaultValue?: string;
+  onSelect?: (value: string) => void;
+  header?: Renderable;
+  footer?: Renderable;
+  /** Show the collapse toggle. Default: false. */
+  collapsible?: boolean;
+  collapsed?: boolean;
+  defaultCollapsed?: boolean;
+  onCollapsedChange?: (collapsed: boolean) => void;
+  ariaLabel?: string;
+};
+export declare function Sidebar({ sections, value, defaultValue, onSelect, header, footer, collapsible, collapsed, defaultCollapsed, onCollapsedChange, ariaLabel, className, ...props }: SidebarProps): import("react").JSX.Element;
+//#endregion
+//#region src/organisms/StreamingText/index.d.ts
 type StreamingTextProps = Omit<HTMLAttributes<HTMLDivElement>, "children"> & {
-    text: string;
-    /** Delay between word entrances, in ms. Default: 30. */
-    speed?: number;
-    /** Reveal words progressively. Default: true. */
-    animated?: boolean;
+  text: string;
+  /** Delay between word entrances, in ms. Default: 30. */
+  speed?: number;
+  /** Reveal words progressively. Default: true. */
+  animated?: boolean;
 };
 /**
  * Words arrive one at a time — and because each word animates only when it
  * mounts, appending to `text` streams naturally without any JS timing: the
  * new words cascade in while finished ones stay put.
  */
-declare function StreamingText({ text, speed, animated, className, ...props }: StreamingTextProps): react.JSX.Element;
-
+export declare function StreamingText({ text, speed, animated, className, ...props }: StreamingTextProps): import("react").JSX.Element;
+//#endregion
+//#region src/organisms/Table/rows.d.ts
+type TableSortDirection = "asc" | "desc";
+type TableSort = {
+  key: string;
+  direction: TableSortDirection;
+};
+//#endregion
+//#region src/organisms/Table/index.d.ts
 type TableColumn<Row extends Record<string, unknown> = Record<string, unknown>> = {
-    key: string;
-    label: Renderable;
-    align?: "start" | "center" | "end";
-    width?: string;
-    render?: (row: Row, index: number) => Renderable;
+  key: string;
+  label: Renderable;
+  align?: "start" | "center" | "end";
+  width?: string;
+  render?: (row: Row, index: number) => Renderable;
+  sortable?: boolean;
+  sortValue?: (row: Row) => unknown;
+  compare?: (a: Row, b: Row) => number;
 };
 type TableProps<Row extends Record<string, unknown> = Record<string, unknown>> = Omit<TableHTMLAttributes<HTMLTableElement>, "children" | "rows" | "className" | "cellPadding" | "cellSpacing"> & {
-    columns: TableColumn<Row>[];
-    rows: Row[];
-    caption?: Renderable;
-    emptyMessage?: Renderable;
-    rowKey?: keyof Row & string;
-    density?: "compact" | "comfortable";
-    striped?: boolean;
-    stickyHeader?: boolean;
-    className?: string;
-};
-declare function Table<Row extends Record<string, unknown> = Record<string, unknown>>({ columns, rows, caption, emptyMessage, rowKey, density, striped, stickyHeader, className, ...props }: TableProps<Row>): react.JSX.Element;
-
-export { Alert, type AlertProps, Avatar, AvatarGroup, type AvatarGroupItem, type AvatarGroupProps, type AvatarProps, type AvatarStatus, Badge, type BadgeProps, Button, type ButtonProps, Card, type CardProps, Checkbox, type CheckboxProps, Collapsible, type CollapsibleProps, Combobox, type ComboboxOption, type ComboboxProps, type CommandItem, CommandPalette, type CommandPaletteProps, type ControlSize, Dialog, type DialogProps, Drawer, type DrawerProps, type DrawerSide, EmptyState, type EmptyStateProps, Field, FieldMessage, type FieldMessageProps, type FieldProps, HoverCard, type HoverCardProps, IconButton, type IconButtonProps, Input, type InputProps, Kbd, type KbdProps, MagneticDropzone, type MagneticDropzoneProps, Menu, type MenuItem, type MenuProps, type MotionSpeed, Notice, type NoticeProps, Popover, type PopoverProps, type Presence, Progress, type ProgressProps, RadioGroup, type RadioGroupProps, type RadioOption, type ReasoningStep, ReasoningSteps, type ReasoningStepsProps, type Renderable, type RenderableElement, Resizable, type ResizableProps, ScrollArea, type ScrollAreaProps, Select, type SelectOption, type SelectProps, Separator, type SeparatorProps, Sidebar, type SidebarItem, type SidebarProps, type SidebarSection, Skeleton, type SkeletonProps, Slider, type SliderProps, Spinner, type SpinnerProps, StreamingText, type StreamingTextProps, Surface, type SurfaceProps, type TabItem, Table, type TableColumn, type TableProps, Tabs, type TabsProps, Textarea, type TextareaProps, Toast, type ToastProps, ToastViewport, type ToastViewportProps, Toggle, type ToggleProps, Toolbar, type ToolbarProps, Tooltip, type TooltipProps, motionDurationMs, parseDurationMs, usePresence };
+  columns: TableColumn<Row>[];
+  rows: Row[];
+  caption?: Renderable;
+  emptyMessage?: Renderable;
+  rowKey?: keyof Row & string;
+  getRowId?: (row: Row, index: number) => string;
+  density?: "compact" | "comfortable";
+  striped?: boolean;
+  stickyHeader?: boolean;
+  stickyFirstColumn?: boolean;
+  sort?: TableSort[];
+  defaultSort?: TableSort[];
+  onSortChange?: (sort: TableSort[]) => void;
+  multiSort?: boolean;
+  manualSort?: boolean;
+  selectable?: boolean;
+  selected?: ReadonlySet<string> | readonly string[];
+  defaultSelected?: ReadonlySet<string> | readonly string[];
+  onSelectedChange?: (selected: string[]) => void;
+  rowLabel?: (row: Row, index: number) => string;
+  selectAllLabel?: string;
+  className?: string;
+};
+export declare function Table<Row extends Record<string, unknown> = Record<string, unknown>>({ columns, rows, caption, emptyMessage, rowKey, getRowId, density, striped, stickyHeader, stickyFirstColumn, sort, defaultSort, onSortChange, multiSort, manualSort, selectable, selected, defaultSelected, onSelectedChange, rowLabel, selectAllLabel, className, ...props }: TableProps<Row>): import("react").JSX.Element;
+//#endregion
+//#region src/atoms/StatusMark/index.d.ts
+type StatusMarkState = "idle" | "running" | "progress" | "success" | "error";
+type StatusMarkProps = Omit<HTMLAttributes<HTMLSpanElement>, "children" | "role" | "aria-label"> & {
+  state?: StatusMarkState;
+  value?: number;
+  label: string;
+  size?: ControlSize;
+  className?: string;
+};
+export declare function StatusMark({ state, value, label, size, className, style, ...props }: StatusMarkProps): import("react").JSX.Element;
+//#endregion
+//#region src/atoms/Timestamp/index.d.ts
+type TimestampFormat = "relative" | "absolute" | "auto";
+type TimestampProps = Omit<TimeHTMLAttributes<HTMLTimeElement>, "children" | "dateTime"> & {
+  date: Date | string | number;
+  format?: TimestampFormat;
+  locale?: string | string[];
+  absoluteOptions?: Intl.DateTimeFormatOptions;
+  live?: boolean;
+  now?: Date | number;
+};
+export declare function Timestamp({ date, format, locale, absoluteOptions, live, now, className, ...props }: TimestampProps): import("react").JSX.Element;
+//#endregion
+//#region src/atoms/NumberInput/index.d.ts
+type NumberInputProps = Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "type" | "value" | "defaultValue" | "onChange" | "min" | "max" | "step" | "children"> & {
+  value?: number | null;
+  defaultValue?: number | null;
+  onValueChange?: (value: number | null) => void;
+  min?: number;
+  max?: number;
+  step?: number;
+  largeStep?: number;
+  precision?: number;
+  format?: Intl.NumberFormatOptions;
+  locale?: string;
+  size?: ControlSize;
+  invalid?: boolean;
+  scrub?: boolean;
+  label?: string;
+  decrementLabel?: string;
+  incrementLabel?: string;
+};
+export declare function NumberInput({ value, defaultValue, onValueChange, min, max, step, largeStep, precision, format, locale, size, invalid, disabled, readOnly, scrub, label, decrementLabel, incrementLabel, className, style, name, onKeyDown, onBlur, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, "aria-invalid": ariaInvalid, ...props }: NumberInputProps): import("react").JSX.Element;
+//#endregion
+//#region src/atoms/HoldButton/index.d.ts
+type HoldButtonProps = Omit<ButtonHTMLAttributes<HTMLButtonElement>, "children" | "type"> & {
+  onConfirm: () => void;
+  children?: Renderable;
+  holdLabel?: Renderable;
+  confirmedLabel?: Renderable;
+  hint?: string;
+  duration?: number;
+  variant?: "danger" | "primary" | "secondary";
+  size?: ControlSize;
+};
+export declare function HoldButton({ onConfirm, children, holdLabel, confirmedLabel, hint, duration, variant, size, disabled, className, style, onPointerDown, onPointerUp, onPointerCancel, onPointerMove, onKeyDown, onKeyUp, onBlur, onContextMenu, onClick, "aria-describedby": ariaDescribedBy, ...props }: HoldButtonProps): import("react").JSX.Element;
+//#endregion
+//#region src/molecules/SegmentedControl/index.d.ts
+type SegmentedOption = {
+  value: string;
+  label: Renderable;
+  icon?: Renderable;
+  disabled?: boolean;
+};
+type SegmentedControlProps = {
+  options: SegmentedOption[];
+  ariaLabel: string;
+  value?: string;
+  defaultValue?: string;
+  onValueChange?: (value: string) => void;
+  size?: ControlSize;
+  fullWidth?: boolean;
+  disabled?: boolean;
+  className?: string;
+};
+export declare function SegmentedControl({ options, ariaLabel, value, defaultValue, onValueChange, size, fullWidth, disabled, className }: SegmentedControlProps): import("react").JSX.Element;
+//#endregion
+//#region src/molecules/Stepper/index.d.ts
+type StepperStep = {
+  id?: string;
+  label: Renderable;
+  description?: Renderable;
+};
+type StepperProps = {
+  steps: StepperStep[];
+  current: number;
+  orientation?: "horizontal" | "vertical";
+  size?: ControlSize;
+  onStepSelect?: (index: number) => void;
+  ariaLabel?: string;
+  completedLabel?: string;
+  className?: string;
+};
+export declare function Stepper({ steps, current, orientation, size, onStepSelect, ariaLabel, completedLabel, className }: StepperProps): import("react").JSX.Element;
+//#endregion
+//#region src/molecules/MetadataList/index.d.ts
+type MetadataEntry = {
+  label: Renderable;
+  value: Renderable;
+  hint?: Renderable;
+  id?: string;
+};
+type MetadataListLayout = "columns" | "stacked" | "inline";
+type MetadataListProps = Omit<HTMLAttributes<HTMLDListElement>, "children"> & {
+  items: MetadataEntry[];
+  layout?: MetadataListLayout;
+  size?: ControlSize;
+  dividers?: boolean;
+};
+export declare function MetadataList({ items, layout, size, dividers, className, ...props }: MetadataListProps): import("react").JSX.Element;
+//#endregion
+//#region src/molecules/OverflowList/index.d.ts
+type OverflowCollapse = "end" | "start";
+type OverflowListProps<T = unknown> = Omit<HTMLAttributes<HTMLUListElement>, "children"> & {
+  items: T[];
+  renderItem: (item: T, index: number) => Renderable;
+  renderOverflow?: (hidden: T[]) => Renderable;
+  renderOverflowItem?: (item: T, index: number) => Renderable;
+  getKey?: (item: T, index: number) => string | number;
+  minVisible?: number;
+  collapseFrom?: OverflowCollapse;
+  overflowLabel?: (count: number) => string;
+};
+export declare function OverflowList<T>({ items, renderItem, renderOverflow, renderOverflowItem, getKey, minVisible, collapseFrom, overflowLabel, className, ...props }: OverflowListProps<T>): import("react").JSX.Element;
+//#endregion
+//#region src/molecules/Citation/index.d.ts
+type CitationSource = {
+  title: string;
+  url?: string;
+  site?: string;
+  snippet?: string;
+  favicon?: string;
+};
+type CitationProps = {
+  sources: CitationSource[];
+  index?: number;
+  max?: number;
+  placement?: OverlaySide;
+  openDelay?: number;
+  closeDelay?: number;
+  className?: string;
+};
+export declare function Citation({ sources, index, max, placement, openDelay, closeDelay, className }: CitationProps): import("react").JSX.Element | null;
+//#endregion
+//#region src/molecules/ToolCalls/index.d.ts
+type ToolCall = {
+  id: string;
+  name: string;
+  title?: Renderable;
+  state: StatusMarkState;
+  input?: Renderable;
+  output?: Renderable;
+  duration?: number;
+};
+type ToolCallsProps = Omit<HTMLAttributes<HTMLDivElement>, "children"> & {
+  calls: ToolCall[];
+  open?: boolean;
+  defaultOpen?: boolean;
+  onOpenChange?: (open: boolean) => void;
+  label?: Renderable;
+};
+export declare function ToolCalls({ calls, open, defaultOpen, onOpenChange, label, className, ...props }: ToolCallsProps): import("react").JSX.Element;
+//#endregion
+//#region src/molecules/PlanCard/index.d.ts
+type PlanStep = {
+  id: string;
+  label: Renderable;
+  detail?: Renderable;
+  state?: StatusMarkState;
+};
+type PlanCardState = "pending" | "approved" | "rejected" | "running";
+type PlanCardProps = Omit<HTMLAttributes<HTMLDivElement>, "children" | "title"> & {
+  title: Renderable;
+  description?: Renderable;
+  steps: PlanStep[];
+  editable?: boolean;
+  onApprove: (steps: PlanStep[]) => void;
+  onReject?: () => void;
+  approveLabel?: Renderable;
+  rejectLabel?: Renderable;
+  state?: PlanCardState;
+  hotkey?: boolean;
+  autoFocus?: boolean;
+};
+export declare function PlanCard({ title, description, steps, editable, onApprove, onReject, approveLabel, rejectLabel, state, hotkey, autoFocus, className, ...props }: PlanCardProps): import("react").JSX.Element;
+//#endregion
+//#region src/organisms/ChatScroller/index.d.ts
+type ChatScrollerProps = Omit<HTMLAttributes<HTMLDivElement>, "children"> & {
+  children?: Renderable;
+  itemCount?: number;
+  newCount?: number;
+  threshold?: number;
+  ariaLabel?: string;
+  jumpLabel?: string;
+  contentClassName?: string;
+  onPinnedChange?: (pinned: boolean) => void;
+};
+export declare function ChatScroller({ children, itemCount, newCount, threshold, ariaLabel, jumpLabel, contentClassName, onPinnedChange, className, ...props }: ChatScrollerProps): import("react").JSX.Element;
+//#endregion
+export { type AccordionItem, type AccordionProps, type AlertProps, type AnimatedNumberProps, type AttachmentFile, type AttachmentProps, type AvatarGroupItem, type AvatarGroupProps, type AvatarProps, type AvatarStatus, type BadgeProps, type BreadcrumbItem, type BreadcrumbProps, type ButtonProps, type CalendarProps, type CalendarRange, type CardProps, type ChartProps, type ChartSeries, type ChatScrollerProps, type CheckboxProps, type CitationProps, type CitationSource, type CollapsibleProps, type ComboboxOption, type ComboboxProps, type CommandItem, type CommandPaletteProps, type ContextMenuProps, type ControlSize, type DeltaProps, type DialogProps, type DrawerProps, type DrawerSide, type DropzoneRejectReason, type DropzoneValidation, type DropzoneValidationResult, type EmptyStateProps, type FieldMessageProps, type FieldProps, type HoldButtonProps, type HoverCardProps, type IconButtonProps, type InputProps, type KbdProps, type MagneticDropzoneProps, type MenuItem, type MenuProps, type MenubarMenu, type MenubarProps, type MetadataEntry, type MetadataListLayout, type MetadataListProps, type MotionSpeed, type NoticeProps, type NumberInputProps, type OTPInputProps, type OTPPattern, type OTPState, type OverflowListProps, type PaginationProps, type PlanCardProps, type PlanCardState, type PlanStep, type PopoverProps, type Presence, type ProgressProps, type QuestionCardProps, type QuestionOption, type RadioGroupProps, type RadioOption, type ReasoningStep, type ReasoningStepsProps, type Renderable, type RenderableElement, type ResizableProps, type RevealProps, type ScrollAreaProps, type SegmentedControlProps, type SegmentedOption, type SelectOption, type SelectProps, type SeparatorProps, type SidebarItem, type SidebarProps, type SidebarSection, type SkeletonProps, type SliderProps, type SpinnerProps, type StatGroupProps, type StatProps, type StatusMarkProps, type StatusMarkState, type StepperProps, type StepperStep, type StreamingTextProps, type SurfaceProps, type TabItem, type TableColumn, type TableProps, type TableSort, type TableSortDirection, type TabsProps, type TaskListItem, type TaskListProps, type TaskState, type TextareaProps, type TimelineItem, type TimelineProps, type TimestampFormat, type TimestampProps, type ToastProps, type ToastViewportProps, type ToggleProps, type ToolCall, type ToolCallsProps, type ToolbarProps, type TooltipGroupProps, type TooltipProps, toast };
+//# sourceMappingURL=index.d.ts.map