astralis-ui 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,3533 @@
+import { ButtonHTMLAttributes } from 'react';
+import { ClassProp } from 'class-variance-authority/types';
+import { ComponentPropsWithoutRef } from 'react';
+import { CSSProperties } from 'react';
+import { ElementType } from 'react';
+import { ForwardRefExoticComponent } from 'react';
+import { HTMLAttributes } from 'react';
+import { InputHTMLAttributes } from 'react';
+import { JSX } from 'react/jsx-runtime';
+import { JSXElementConstructor } from 'react';
+import { LabelHTMLAttributes } from 'react';
+import { ReactElement } from 'react';
+import { ReactNode } from 'react';
+import { ReactPortal } from 'react';
+import { Ref } from 'react';
+import { RefAttributes } from 'react';
+import { TdHTMLAttributes } from 'react';
+import { TextareaHTMLAttributes } from 'react';
+import { ThHTMLAttributes } from 'react';
+import { VariantProps } from 'class-variance-authority';
+
+/** Compound API — `Accordion` is the root; parts hang off it. */
+export declare const Accordion: typeof AccordionRoot & {
+    Item: typeof AccordionItem;
+    Trigger: typeof AccordionTrigger;
+    Content: typeof AccordionContent;
+};
+
+/**
+ * Smoothly collapsing region. The outer grid animates `grid-template-rows`
+ * from `0fr` → `1fr` (a JS-measurement-free height transition); the inner
+ * wrapper clips the overflow. Content mounts lazily on first open (unless
+ * `keepMounted`) and stays mounted afterwards so the collapse still animates.
+ */
+export declare function AccordionContent({ children, className }: AccordionContentProps): JSX.Element;
+
+export declare interface AccordionContentProps {
+    children?: ReactNode;
+    className?: string;
+}
+
+export declare type AccordionHeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
+
+export declare type AccordionIndicatorPosition = "start" | "end";
+
+export declare function AccordionItem({ children, value, disabled, className }: AccordionItemProps): JSX.Element;
+
+export declare interface AccordionItemProps {
+    children?: ReactNode;
+    value: string;
+    disabled?: boolean;
+    className?: string;
+}
+
+export declare interface AccordionProps {
+    children?: ReactNode;
+    /** `single` keeps one item open; `multiple` allows many. */
+    type?: AccordionType;
+    variant?: AccordionVariant;
+    size?: AccordionSize;
+    /** Hue for the focus ring and the `subtle` variant's open fill. Defaults to `gray`. */
+    colorScheme?: ColorScheme;
+    /** Controlled open value(s) — string for `single`, string[] for `multiple`. */
+    value?: string | string[];
+    defaultValue?: string | string[];
+    /** `single` only: allow closing the open item (open nothing). */
+    collapsible?: boolean;
+    /** Disable the whole accordion. */
+    disabled?: boolean;
+    /** Render content even before its first open (otherwise it mounts lazily). */
+    keepMounted?: boolean;
+    /** Custom indicator node, replacing the default chevron for every trigger. */
+    indicator?: ReactNode;
+    indicatorPosition?: AccordionIndicatorPosition;
+    hideIndicator?: boolean;
+    /** Heading level the trigger is wrapped in, for document outline. Defaults to 3. */
+    headingLevel?: AccordionHeadingLevel;
+    onValueChange?: (value: string | string[]) => void;
+    className?: string;
+}
+
+declare function AccordionRoot({ children, type, variant, size, colorScheme, value, defaultValue, collapsible, disabled, keepMounted, indicator, indicatorPosition, hideIndicator, headingLevel, onValueChange, className, }: AccordionProps): JSX.Element;
+
+export declare type AccordionSize = "sm" | "md" | "lg";
+
+export declare function AccordionTrigger({ children, indicator: indicatorProp, hideIndicator: hideIndicatorProp, className, }: AccordionTriggerProps): JSX.Element;
+
+export declare interface AccordionTriggerProps {
+    children?: ReactNode;
+    /** Per-trigger indicator override. */
+    indicator?: ReactNode;
+    hideIndicator?: boolean;
+    className?: string;
+}
+
+export declare type AccordionType = "single" | "multiple";
+
+export declare type AccordionVariant = "enclosed" | "outline" | "separated" | "subtle" | "plain";
+
+export declare const Alert: typeof AlertRoot & {
+    Title: typeof AlertTitle;
+    Description: typeof AlertDescription;
+};
+
+declare function AlertDescription({ className, children, ...rest }: AlertSectionProps): JSX.Element;
+
+declare namespace AlertDescription {
+    var displayName: string;
+}
+
+export declare interface AlertProps extends ComponentPropsWithoutRef<"div"> {
+    /** Meaning of the alert — picks the icon, hue and ARIA role. @default "info" */
+    status?: AlertStatus;
+    /** Fill treatment. @default "subtle" */
+    variant?: AlertVariant;
+    /**
+     * Hue override (via the accent channel). Defaults to the hue mapped from
+     * `status` — info→blue, success→green, warning→orange, error→red.
+     */
+    colorScheme?: ColorScheme;
+    /** Replace the status icon, or pass `false` to hide it. */
+    icon?: ReactNode | false;
+    /** Renders a dismiss button that calls this handler. */
+    onClose?: () => void;
+    children: ReactNode;
+}
+
+declare function AlertRoot({ status, variant, colorScheme, icon, onClose, className, children, ref, ...rest }: AlertProps & {
+    ref?: Ref<HTMLDivElement>;
+}): JSX.Element;
+
+declare namespace AlertRoot {
+    var displayName: string;
+}
+
+export declare interface AlertSectionProps extends ComponentPropsWithoutRef<"div"> {
+    children: ReactNode;
+}
+
+export declare type AlertStatus = FeedbackStatus;
+
+declare function AlertTitle({ className, children, ...rest }: AlertSectionProps): JSX.Element;
+
+declare namespace AlertTitle {
+    var displayName: string;
+}
+
+export declare type AlertVariant = "subtle" | "solid" | "outline" | "left-accent";
+
+declare type Align = "start" | "center" | "end";
+
+export declare const AspectRatio: AspectRatioComponent;
+
+declare type AspectRatioComponent = <T extends ElementType = "div">(props: AspectRatioProps<T> & {
+    ref?: Ref<any>;
+}) => ReactNode;
+
+/** `ratio` accepts a scalar aspect token or a responsive map. */
+declare type AspectRatioCustomProps = Responsive<VariantProps<typeof aspectRatioVariants>>;
+
+export declare type AspectRatioProps<T extends ElementType = "div"> = BoxProps<T> & AspectRatioCustomProps;
+
+declare const aspectRatioVariants: (props?: ({
+    readonly ratio?: "auto" | "square" | "wide" | "landscape" | "portrait" | "ultrawide" | "golden" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare function AstralisProvider({ children, defaultTheme, storageKey, className, tokens, }: ThemeProviderProps): JSX.Element;
+
+/** Compound API — `Avatar` is the root; parts hang off it. */
+export declare const Avatar: typeof AvatarRoot & {
+    Group: typeof AvatarGroup;
+    Badge: typeof AvatarBadge;
+};
+
+/** A status dot pinned to the avatar's bottom-right corner. */
+export declare function AvatarBadge({ status, color, size, className, style }: AvatarBadgeProps): JSX.Element;
+
+export declare namespace AvatarBadge {
+    var displayName: string;
+}
+
+export declare interface AvatarBadgeProps {
+    status?: AvatarStatus;
+    /** Custom dot colour, overriding `status`. */
+    color?: string;
+    size?: AvatarSize;
+    className?: string;
+    style?: CSSProperties;
+}
+
+export declare function AvatarGroup({ children, max, spacing, size, className, style }: AvatarGroupProps): JSX.Element;
+
+export declare namespace AvatarGroup {
+    var displayName: string;
+}
+
+export declare interface AvatarGroupProps {
+    children: ReactNode;
+    /** Cap the number shown; the rest collapse into a "+N" chip. */
+    max?: number;
+    size?: AvatarSize;
+    /** Overlap between avatars, px (negative overlaps). @default -8 */
+    spacing?: number;
+    className?: string;
+    style?: CSSProperties;
+}
+
+export declare interface AvatarProps {
+    src?: string;
+    alt?: string;
+    /** Name — used for initials and (unless `colorScheme` is set) a deterministic hue. */
+    name?: string;
+    /** Fallback node when there's no image or name. */
+    icon?: ReactNode;
+    size?: AvatarSize;
+    shape?: AvatarShape;
+    /** Override the auto hue derived from `name`. */
+    colorScheme?: ColorScheme;
+    /** Ring separating overlapping avatars (auto-on inside `Avatar.Group`). */
+    ring?: boolean;
+    /** e.g. an `Avatar.Badge`. */
+    children?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+}
+
+declare function AvatarRoot({ src, alt, name, icon, size, shape, colorScheme, ring, children, className, style, }: AvatarProps): JSX.Element;
+
+declare namespace AvatarRoot {
+    var displayName: string;
+}
+
+export declare type AvatarShape = "circle" | "rounded" | "square";
+
+export declare type AvatarSize = "xs" | "sm" | "md" | "lg" | "xl" | "2xl";
+
+export declare type AvatarStatus = "online" | "away" | "busy" | "offline";
+
+/**
+ * A small label chip for statuses, counts, and categories. `variant` picks the
+ * fill treatment and `colorScheme` the hue (via the accent channel).
+ */
+export declare function Badge({ children, variant, colorScheme, size, className, ...rest }: BadgeProps): JSX.Element;
+
+export declare namespace Badge {
+    var displayName: string;
+}
+
+export declare interface BadgeProps extends Omit<ComponentPropsWithoutRef<"span">, "color"> {
+    children?: ReactNode;
+    variant?: BadgeVariant;
+    /** Hue the badge paints with. @default "gray" */
+    colorScheme?: ColorScheme;
+    size?: BadgeSize;
+    className?: string;
+}
+
+export declare type BadgeSize = "xs" | "sm" | "md" | "lg";
+
+export declare type BadgeVariant = "solid" | "subtle" | "surface" | "outline";
+
+/** A quotation block with a leading accent rule and optional `<cite>` attribution. */
+export declare const Blockquote: BlockquoteComponent;
+
+declare type BlockquoteBaseProps = BlockquoteCustomProps & Responsive<VariantProps<typeof blockquoteVariants>>;
+
+declare type BlockquoteComponent = <T extends ElementType = "blockquote">(props: BlockquoteProps<T> & {
+    ref?: Ref<any>;
+}) => ReactNode;
+
+declare interface BlockquoteCustomProps {
+    /** Visible attribution, rendered beneath the quote as a `<cite>` line. */
+    cite?: ReactNode;
+    /** URL of the source, set as the native `cite` attribute on the element. */
+    citeUrl?: string;
+}
+
+export declare type BlockquoteProps<T extends ElementType = "blockquote"> = Omit<BoxProps<T>, keyof BlockquoteBaseProps> & BlockquoteBaseProps;
+
+declare const blockquoteVariants: (props?: ({
+    readonly variant?: "subtle" | "plain" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare const Box: BoxComponent;
+
+declare type BoxBaseProps<T extends ElementType = "div"> = BoxCustomProps<T> & BoxStyleProps;
+
+declare type BoxComponent = <T extends ElementType = "div">(props: BoxProps<T> & {
+    ref?: Ref<any>;
+}) => ReactNode;
+
+declare interface BoxCustomProps<T extends ElementType = "div"> {
+    as?: T;
+    children?: ReactNode;
+    className?: string;
+}
+
+export declare type BoxProps<T extends ElementType = "div"> = BoxBaseProps<T> & Omit<ComponentPropsWithoutRef<T>, keyof BoxBaseProps<T>>;
+
+/** Every Box style prop accepts a scalar token or a responsive map. */
+declare type BoxStyleProps = Responsive<VariantProps<typeof boxVariants>>;
+
+declare const boxVariants: (props?: ({
+    readonly p?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | "12" | "10" | "11" | "8" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | null | undefined;
+    readonly py?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | "12" | "10" | "11" | "8" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | null | undefined;
+    readonly px?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | "12" | "10" | "11" | "8" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | null | undefined;
+    readonly pt?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | "12" | "10" | "11" | "8" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | null | undefined;
+    readonly pb?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | "12" | "10" | "11" | "8" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | null | undefined;
+    readonly pl?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | "12" | "10" | "11" | "8" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | null | undefined;
+    readonly pr?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | "12" | "10" | "11" | "8" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | null | undefined;
+    readonly m?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | "12" | "10" | "11" | "8" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | null | undefined;
+    readonly my?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | "12" | "10" | "11" | "8" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | null | undefined;
+    readonly mx?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | "12" | "10" | "11" | "8" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | null | undefined;
+    readonly mt?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | "12" | "10" | "11" | "8" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | null | undefined;
+    readonly mb?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | "12" | "10" | "11" | "8" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | null | undefined;
+    readonly ml?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | "12" | "10" | "11" | "8" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | null | undefined;
+    readonly mr?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | "12" | "10" | "11" | "8" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | null | undefined;
+    readonly h?: "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "full" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "auto" | "12" | "10" | "screen" | "max" | "min" | "11" | "8" | "3xl" | "4xl" | "5xl" | "6xl" | "7xl" | "8xl" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | "3xs" | "2xs" | "1/2" | "1/3" | "2/3" | "1/4" | "3/4" | "1/5" | "2/5" | "3/5" | "4/5" | "1/6" | "2/6" | "3/6" | "4/6" | "5/6" | "1/12" | "2/12" | "3/12" | "4/12" | "5/12" | "6/12" | "7/12" | "8/12" | "9/12" | "10/12" | "11/12" | "fit" | "dvh" | "svh" | "lvh" | "vh" | null | undefined;
+    readonly minH?: "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "full" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "auto" | "12" | "10" | "screen" | "max" | "min" | "11" | "8" | "3xl" | "4xl" | "5xl" | "6xl" | "7xl" | "8xl" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | "3xs" | "2xs" | "1/2" | "1/3" | "2/3" | "1/4" | "3/4" | "1/5" | "2/5" | "3/5" | "4/5" | "1/6" | "2/6" | "3/6" | "4/6" | "5/6" | "1/12" | "2/12" | "3/12" | "4/12" | "5/12" | "6/12" | "7/12" | "8/12" | "9/12" | "10/12" | "11/12" | "fit" | "dvh" | "svh" | "lvh" | "vh" | null | undefined;
+    readonly maxH?: "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "full" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "auto" | "12" | "10" | "screen" | "max" | "min" | "11" | "8" | "3xl" | "4xl" | "5xl" | "6xl" | "7xl" | "8xl" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | "3xs" | "2xs" | "1/2" | "1/3" | "2/3" | "1/4" | "3/4" | "1/5" | "2/5" | "3/5" | "4/5" | "1/6" | "2/6" | "3/6" | "4/6" | "5/6" | "1/12" | "2/12" | "3/12" | "4/12" | "5/12" | "6/12" | "7/12" | "8/12" | "9/12" | "10/12" | "11/12" | "fit" | "dvh" | "svh" | "lvh" | "vh" | null | undefined;
+    readonly w?: "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "full" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "auto" | "12" | "10" | "screen" | "max" | "min" | "11" | "8" | "3xl" | "4xl" | "5xl" | "6xl" | "7xl" | "8xl" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | "3xs" | "2xs" | "1/2" | "1/3" | "2/3" | "1/4" | "3/4" | "1/5" | "2/5" | "3/5" | "4/5" | "1/6" | "2/6" | "3/6" | "4/6" | "5/6" | "1/12" | "2/12" | "3/12" | "4/12" | "5/12" | "6/12" | "7/12" | "8/12" | "9/12" | "10/12" | "11/12" | "fit" | "dvw" | "svw" | "lvw" | "vw" | "prose" | null | undefined;
+    readonly minW?: "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "full" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "auto" | "12" | "10" | "screen" | "max" | "min" | "11" | "8" | "3xl" | "4xl" | "5xl" | "6xl" | "7xl" | "8xl" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | "3xs" | "2xs" | "1/2" | "1/3" | "2/3" | "1/4" | "3/4" | "1/5" | "2/5" | "3/5" | "4/5" | "1/6" | "2/6" | "3/6" | "4/6" | "5/6" | "1/12" | "2/12" | "3/12" | "4/12" | "5/12" | "6/12" | "7/12" | "8/12" | "9/12" | "10/12" | "11/12" | "fit" | "dvw" | "svw" | "lvw" | "vw" | "prose" | null | undefined;
+    readonly maxW?: "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "full" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "12" | "10" | "screen" | "max" | "min" | "11" | "8" | "3xl" | "4xl" | "5xl" | "6xl" | "7xl" | "8xl" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | "3xs" | "2xs" | "1/2" | "1/3" | "2/3" | "1/4" | "3/4" | "1/5" | "2/5" | "3/5" | "4/5" | "1/6" | "2/6" | "3/6" | "4/6" | "5/6" | "1/12" | "2/12" | "3/12" | "4/12" | "5/12" | "6/12" | "7/12" | "8/12" | "9/12" | "10/12" | "11/12" | "fit" | "dvw" | "svw" | "lvw" | "vw" | "prose" | null | undefined;
+    readonly inline?: "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "full" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "auto" | "12" | "10" | "screen" | "max" | "min" | "11" | "8" | "3xl" | "4xl" | "5xl" | "6xl" | "7xl" | "8xl" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | "3xs" | "2xs" | "1/2" | "1/3" | "2/3" | "1/4" | "3/4" | "1/5" | "2/5" | "3/5" | "4/5" | "1/6" | "2/6" | "3/6" | "4/6" | "5/6" | "1/12" | "2/12" | "3/12" | "4/12" | "5/12" | "6/12" | "7/12" | "8/12" | "9/12" | "10/12" | "11/12" | "fit" | "dvw" | "svw" | "lvw" | "vw" | "prose" | null | undefined;
+    readonly minInline?: "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "full" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "auto" | "12" | "10" | "screen" | "max" | "min" | "11" | "8" | "3xl" | "4xl" | "5xl" | "6xl" | "7xl" | "8xl" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | "3xs" | "2xs" | "1/2" | "1/3" | "2/3" | "1/4" | "3/4" | "1/5" | "2/5" | "3/5" | "4/5" | "1/6" | "2/6" | "3/6" | "4/6" | "5/6" | "1/12" | "2/12" | "3/12" | "4/12" | "5/12" | "6/12" | "7/12" | "8/12" | "9/12" | "10/12" | "11/12" | "fit" | "dvw" | "svw" | "lvw" | "vw" | "prose" | null | undefined;
+    readonly maxInline?: "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "full" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "12" | "10" | "screen" | "max" | "min" | "11" | "8" | "3xl" | "4xl" | "5xl" | "6xl" | "7xl" | "8xl" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | "3xs" | "2xs" | "1/2" | "1/3" | "2/3" | "1/4" | "3/4" | "1/5" | "2/5" | "3/5" | "4/5" | "1/6" | "2/6" | "3/6" | "4/6" | "5/6" | "1/12" | "2/12" | "3/12" | "4/12" | "5/12" | "6/12" | "7/12" | "8/12" | "9/12" | "10/12" | "11/12" | "fit" | "dvw" | "svw" | "lvw" | "vw" | "prose" | null | undefined;
+    readonly block?: "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "full" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "auto" | "12" | "10" | "screen" | "max" | "min" | "11" | "8" | "3xl" | "4xl" | "5xl" | "6xl" | "7xl" | "8xl" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | "3xs" | "2xs" | "1/2" | "1/3" | "2/3" | "1/4" | "3/4" | "1/5" | "2/5" | "3/5" | "4/5" | "1/6" | "2/6" | "3/6" | "4/6" | "5/6" | "1/12" | "2/12" | "3/12" | "4/12" | "5/12" | "6/12" | "7/12" | "8/12" | "9/12" | "10/12" | "11/12" | "fit" | "dvh" | "svh" | "lvh" | "vh" | null | undefined;
+    readonly minBlock?: "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "full" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "auto" | "12" | "10" | "screen" | "max" | "min" | "11" | "8" | "3xl" | "4xl" | "5xl" | "6xl" | "7xl" | "8xl" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | "3xs" | "2xs" | "1/2" | "1/3" | "2/3" | "1/4" | "3/4" | "1/5" | "2/5" | "3/5" | "4/5" | "1/6" | "2/6" | "3/6" | "4/6" | "5/6" | "1/12" | "2/12" | "3/12" | "4/12" | "5/12" | "6/12" | "7/12" | "8/12" | "9/12" | "10/12" | "11/12" | "fit" | "dvh" | "svh" | "lvh" | "vh" | null | undefined;
+    readonly maxBlock?: "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "full" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "12" | "10" | "screen" | "max" | "min" | "11" | "8" | "3xl" | "4xl" | "5xl" | "6xl" | "7xl" | "8xl" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | "3xs" | "2xs" | "1/2" | "1/3" | "2/3" | "1/4" | "3/4" | "1/5" | "2/5" | "3/5" | "4/5" | "1/6" | "2/6" | "3/6" | "4/6" | "5/6" | "1/12" | "2/12" | "3/12" | "4/12" | "5/12" | "6/12" | "7/12" | "8/12" | "9/12" | "10/12" | "11/12" | "fit" | "dvh" | "svh" | "lvh" | "vh" | null | undefined;
+    readonly size?: "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "full" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "auto" | "12" | "10" | "max" | "min" | "11" | "8" | "3xl" | "4xl" | "5xl" | "6xl" | "7xl" | "8xl" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | "3xs" | "2xs" | "1/2" | "1/3" | "2/3" | "1/4" | "3/4" | "1/5" | "2/5" | "3/5" | "4/5" | "1/6" | "2/6" | "3/6" | "4/6" | "5/6" | "1/12" | "2/12" | "3/12" | "4/12" | "5/12" | "6/12" | "7/12" | "8/12" | "9/12" | "10/12" | "11/12" | "fit" | "dvh" | "svh" | "lvh" | "dvw" | "svw" | "lvw" | null | undefined;
+    readonly display?: "table" | "flex" | "hidden" | "grid" | "inline" | "block" | "flow-root" | "table-caption" | "table-cell" | "table-column" | "table-column-group" | "table-footer-group" | "table-header-group" | "table-row" | "table-row-group" | "inline-block" | "inline-flex" | "inline-grid" | "inline-table" | "contents" | "list-item" | null | undefined;
+    readonly opacity?: "moderate" | "high" | "low" | "max" | "lowest" | "lower" | "higher" | "highest" | null | undefined;
+    readonly zIndex?: "moderate" | "high" | "low" | "max" | "lowest" | "lower" | "higher" | "highest" | null | undefined;
+    readonly position?: "fixed" | "absolute" | "relative" | "static" | "sticky" | null | undefined;
+    readonly inset?: "full" | "0" | "1" | "2" | "3" | "4" | "px" | "5" | "6" | "auto" | "12" | "10" | "8" | "0.5" | "1.5" | "2.5" | "3.5" | "16" | "20" | "24" | "32" | "40" | "48" | "56" | "64" | "1/2" | "1/3" | "2/3" | "1/4" | "3/4" | null | undefined;
+    readonly top?: "full" | "0" | "1" | "2" | "3" | "4" | "px" | "5" | "6" | "auto" | "12" | "10" | "8" | "0.5" | "1.5" | "2.5" | "3.5" | "16" | "20" | "24" | "32" | "40" | "48" | "56" | "64" | "1/2" | "1/3" | "2/3" | "1/4" | "3/4" | null | undefined;
+    readonly right?: "full" | "0" | "1" | "2" | "3" | "4" | "px" | "5" | "6" | "auto" | "12" | "10" | "8" | "0.5" | "1.5" | "2.5" | "3.5" | "16" | "20" | "24" | "32" | "40" | "48" | "56" | "64" | "1/2" | "1/3" | "2/3" | "1/4" | "3/4" | null | undefined;
+    readonly bottom?: "full" | "0" | "1" | "2" | "3" | "4" | "px" | "5" | "6" | "auto" | "12" | "10" | "8" | "0.5" | "1.5" | "2.5" | "3.5" | "16" | "20" | "24" | "32" | "40" | "48" | "56" | "64" | "1/2" | "1/3" | "2/3" | "1/4" | "3/4" | null | undefined;
+    readonly left?: "full" | "0" | "1" | "2" | "3" | "4" | "px" | "5" | "6" | "auto" | "12" | "10" | "8" | "0.5" | "1.5" | "2.5" | "3.5" | "16" | "20" | "24" | "32" | "40" | "48" | "56" | "64" | "1/2" | "1/3" | "2/3" | "1/4" | "3/4" | null | undefined;
+    readonly overflow?: "hidden" | "auto" | "scroll" | "visible" | "clip" | null | undefined;
+    readonly overflowX?: "hidden" | "auto" | "scroll" | "visible" | "clip" | null | undefined;
+    readonly overflowY?: "hidden" | "auto" | "scroll" | "visible" | "clip" | null | undefined;
+    readonly cursor?: "text" | "none" | "progress" | "auto" | "default" | "move" | "grab" | "grabbing" | "help" | "not-allowed" | "pointer" | "wait" | null | undefined;
+    readonly pointerEvents?: "none" | "auto" | null | undefined;
+    readonly aspectRatio?: "auto" | "square" | "wide" | "landscape" | "portrait" | "ultrawide" | "golden" | null | undefined;
+    readonly shadow?: "xs" | "sm" | "md" | "lg" | "xl" | "none" | "2xl" | "inner" | null | undefined;
+    readonly border?: "normal" | "moderate" | "thick" | "thicker" | "thickest" | null | undefined;
+    readonly borderStyle?: "solid" | "none" | "hidden" | "dashed" | "dotted" | "double" | null | undefined;
+    readonly rounded?: "xs" | "sm" | "md" | "lg" | "xl" | "none" | "2xl" | "full" | "3xl" | "4xl" | "2xs" | null | undefined;
+    readonly roundedT?: "xs" | "sm" | "md" | "lg" | "xl" | "none" | "2xl" | "full" | "3xl" | "4xl" | "2xs" | null | undefined;
+    readonly roundedR?: "xs" | "sm" | "md" | "lg" | "xl" | "none" | "2xl" | "full" | "3xl" | "4xl" | "2xs" | null | undefined;
+    readonly roundedB?: "xs" | "sm" | "md" | "lg" | "xl" | "none" | "2xl" | "full" | "3xl" | "4xl" | "2xs" | null | undefined;
+    readonly roundedL?: "xs" | "sm" | "md" | "lg" | "xl" | "none" | "2xl" | "full" | "3xl" | "4xl" | "2xs" | null | undefined;
+    readonly roundedTl?: "xs" | "sm" | "md" | "lg" | "xl" | "none" | "2xl" | "full" | "3xl" | "4xl" | "2xs" | null | undefined;
+    readonly roundedTr?: "xs" | "sm" | "md" | "lg" | "xl" | "none" | "2xl" | "full" | "3xl" | "4xl" | "2xs" | null | undefined;
+    readonly roundedBr?: "xs" | "sm" | "md" | "lg" | "xl" | "none" | "2xl" | "full" | "3xl" | "4xl" | "2xs" | null | undefined;
+    readonly roundedBl?: "xs" | "sm" | "md" | "lg" | "xl" | "none" | "2xl" | "full" | "3xl" | "4xl" | "2xs" | null | undefined;
+    readonly bg?: "subtle" | "base" | "inherit" | "current" | "error" | "muted" | "emphasized" | "black" | "white" | "transparent" | "inverted" | "warning" | "success" | "info" | "gray-50" | "gray-100" | "gray-200" | "gray-300" | "gray-400" | "gray-500" | "gray-600" | "gray-700" | "gray-800" | "gray-900" | "gray-950" | "red-50" | "red-100" | "red-200" | "red-300" | "red-400" | "red-500" | "red-600" | "red-700" | "red-800" | "red-900" | "red-950" | "orange-50" | "orange-100" | "orange-200" | "orange-300" | "orange-400" | "orange-500" | "orange-600" | "orange-700" | "orange-800" | "orange-900" | "orange-950" | "yellow-50" | "yellow-100" | "yellow-200" | "yellow-300" | "yellow-400" | "yellow-500" | "yellow-600" | "yellow-700" | "yellow-800" | "yellow-900" | "yellow-950" | "green-50" | "green-100" | "green-200" | "green-300" | "green-400" | "green-500" | "green-600" | "green-700" | "green-800" | "green-900" | "green-950" | "teal-50" | "teal-100" | "teal-200" | "teal-300" | "teal-400" | "teal-500" | "teal-600" | "teal-700" | "teal-800" | "teal-900" | "teal-950" | "blue-50" | "blue-100" | "blue-200" | "blue-300" | "blue-400" | "blue-500" | "blue-600" | "blue-700" | "blue-800" | "blue-900" | "blue-950" | "cyan-50" | "cyan-100" | "cyan-200" | "cyan-300" | "cyan-400" | "cyan-500" | "cyan-600" | "cyan-700" | "cyan-800" | "cyan-900" | "cyan-950" | "purple-50" | "purple-100" | "purple-200" | "purple-300" | "purple-400" | "purple-500" | "purple-600" | "purple-700" | "purple-800" | "purple-900" | "purple-950" | "pink-50" | "pink-100" | "pink-200" | "pink-300" | "pink-400" | "pink-500" | "pink-600" | "pink-700" | "pink-800" | "pink-900" | "pink-950" | "brand-50" | "brand-100" | "brand-200" | "brand-300" | "brand-400" | "brand-500" | "brand-600" | "brand-700" | "brand-800" | "brand-900" | "gray-solid" | "red-solid" | "orange-solid" | "yellow-solid" | "green-solid" | "teal-solid" | "blue-solid" | "cyan-solid" | "purple-solid" | "pink-solid" | "brand-solid" | "panel" | "gray-subtle" | "gray-muted" | "gray-emphasized" | "red-subtle" | "red-muted" | "red-emphasized" | "orange-subtle" | "orange-muted" | "orange-emphasized" | "yellow-subtle" | "yellow-muted" | "yellow-emphasized" | "green-subtle" | "green-muted" | "green-emphasized" | "teal-subtle" | "teal-muted" | "teal-emphasized" | "blue-subtle" | "blue-muted" | "blue-emphasized" | "cyan-subtle" | "cyan-muted" | "cyan-emphasized" | "purple-subtle" | "purple-muted" | "purple-emphasized" | "pink-subtle" | "pink-muted" | "pink-emphasized" | "brand-subtle" | "brand-muted" | "brand-emphasized" | null | undefined;
+    readonly color?: "subtle" | "base" | "inherit" | "current" | "error" | "muted" | "black" | "white" | "transparent" | "inverted" | "warning" | "success" | "info" | "gray-50" | "gray-100" | "gray-200" | "gray-300" | "gray-400" | "gray-500" | "gray-600" | "gray-700" | "gray-800" | "gray-900" | "gray-950" | "red-50" | "red-100" | "red-200" | "red-300" | "red-400" | "red-500" | "red-600" | "red-700" | "red-800" | "red-900" | "red-950" | "orange-50" | "orange-100" | "orange-200" | "orange-300" | "orange-400" | "orange-500" | "orange-600" | "orange-700" | "orange-800" | "orange-900" | "orange-950" | "yellow-50" | "yellow-100" | "yellow-200" | "yellow-300" | "yellow-400" | "yellow-500" | "yellow-600" | "yellow-700" | "yellow-800" | "yellow-900" | "yellow-950" | "green-50" | "green-100" | "green-200" | "green-300" | "green-400" | "green-500" | "green-600" | "green-700" | "green-800" | "green-900" | "green-950" | "teal-50" | "teal-100" | "teal-200" | "teal-300" | "teal-400" | "teal-500" | "teal-600" | "teal-700" | "teal-800" | "teal-900" | "teal-950" | "blue-50" | "blue-100" | "blue-200" | "blue-300" | "blue-400" | "blue-500" | "blue-600" | "blue-700" | "blue-800" | "blue-900" | "blue-950" | "cyan-50" | "cyan-100" | "cyan-200" | "cyan-300" | "cyan-400" | "cyan-500" | "cyan-600" | "cyan-700" | "cyan-800" | "cyan-900" | "cyan-950" | "purple-50" | "purple-100" | "purple-200" | "purple-300" | "purple-400" | "purple-500" | "purple-600" | "purple-700" | "purple-800" | "purple-900" | "purple-950" | "pink-50" | "pink-100" | "pink-200" | "pink-300" | "pink-400" | "pink-500" | "pink-600" | "pink-700" | "pink-800" | "pink-900" | "pink-950" | "brand-50" | "brand-100" | "brand-200" | "brand-300" | "brand-400" | "brand-500" | "brand-600" | "brand-700" | "brand-800" | "brand-900" | "gray-solid" | "gray-contrast" | "gray-label" | "red-solid" | "red-contrast" | "red-label" | "orange-solid" | "orange-contrast" | "orange-label" | "yellow-solid" | "yellow-contrast" | "yellow-label" | "green-solid" | "green-contrast" | "green-label" | "teal-solid" | "teal-contrast" | "teal-label" | "blue-solid" | "blue-contrast" | "blue-label" | "cyan-solid" | "cyan-contrast" | "cyan-label" | "purple-solid" | "purple-contrast" | "purple-label" | "pink-solid" | "pink-contrast" | "pink-label" | "brand-solid" | "brand-contrast" | "brand-label" | null | undefined;
+    readonly borderColor?: "subtle" | "base" | "inherit" | "current" | "error" | "muted" | "emphasized" | "black" | "white" | "transparent" | "inverted" | "warning" | "success" | "info" | "gray-50" | "gray-100" | "gray-200" | "gray-300" | "gray-400" | "gray-500" | "gray-600" | "gray-700" | "gray-800" | "gray-900" | "gray-950" | "red-50" | "red-100" | "red-200" | "red-300" | "red-400" | "red-500" | "red-600" | "red-700" | "red-800" | "red-900" | "red-950" | "orange-50" | "orange-100" | "orange-200" | "orange-300" | "orange-400" | "orange-500" | "orange-600" | "orange-700" | "orange-800" | "orange-900" | "orange-950" | "yellow-50" | "yellow-100" | "yellow-200" | "yellow-300" | "yellow-400" | "yellow-500" | "yellow-600" | "yellow-700" | "yellow-800" | "yellow-900" | "yellow-950" | "green-50" | "green-100" | "green-200" | "green-300" | "green-400" | "green-500" | "green-600" | "green-700" | "green-800" | "green-900" | "green-950" | "teal-50" | "teal-100" | "teal-200" | "teal-300" | "teal-400" | "teal-500" | "teal-600" | "teal-700" | "teal-800" | "teal-900" | "teal-950" | "blue-50" | "blue-100" | "blue-200" | "blue-300" | "blue-400" | "blue-500" | "blue-600" | "blue-700" | "blue-800" | "blue-900" | "blue-950" | "cyan-50" | "cyan-100" | "cyan-200" | "cyan-300" | "cyan-400" | "cyan-500" | "cyan-600" | "cyan-700" | "cyan-800" | "cyan-900" | "cyan-950" | "purple-50" | "purple-100" | "purple-200" | "purple-300" | "purple-400" | "purple-500" | "purple-600" | "purple-700" | "purple-800" | "purple-900" | "purple-950" | "pink-50" | "pink-100" | "pink-200" | "pink-300" | "pink-400" | "pink-500" | "pink-600" | "pink-700" | "pink-800" | "pink-900" | "pink-950" | "brand-50" | "brand-100" | "brand-200" | "brand-300" | "brand-400" | "brand-500" | "brand-600" | "brand-700" | "brand-800" | "brand-900" | "gray-stroke" | "red-stroke" | "orange-stroke" | "yellow-stroke" | "green-stroke" | "teal-stroke" | "blue-stroke" | "cyan-stroke" | "purple-stroke" | "pink-stroke" | "brand-stroke" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare const Breadcrumb: typeof BreadcrumbRoot & {
+    Item: typeof BreadcrumbItem;
+    Link: typeof BreadcrumbLink;
+};
+
+declare function BreadcrumbItem({ className, children, ...rest }: BreadcrumbItemProps): JSX.Element;
+
+declare namespace BreadcrumbItem {
+    var displayName: string;
+}
+
+export declare interface BreadcrumbItemProps extends ComponentPropsWithoutRef<"li"> {
+    children: ReactNode;
+}
+
+declare function BreadcrumbLink<T extends ElementType = "a">({ as, isCurrent, className, children, ...rest }: BreadcrumbLinkProps<T>): JSX.Element;
+
+declare namespace BreadcrumbLink {
+    var displayName: string;
+}
+
+export declare type BreadcrumbLinkProps<T extends ElementType = "a"> = {
+    /** Render as a router link component (e.g. Next's `Link`). */
+    as?: T;
+    /** Marks the current page: renders non-interactive with `aria-current="page"`. */
+    isCurrent?: boolean;
+    className?: string;
+    children: ReactNode;
+} & Omit<ComponentPropsWithoutRef<T>, "as" | "children" | "className">;
+
+export declare interface BreadcrumbProps extends ComponentPropsWithoutRef<"nav"> {
+    /** Glyph between items. @default chevron */
+    separator?: ReactNode;
+    children: ReactNode;
+}
+
+declare function BreadcrumbRoot({ separator, className, children, ref, ...rest }: BreadcrumbProps & {
+    ref?: Ref<HTMLElement>;
+}): JSX.Element;
+
+declare namespace BreadcrumbRoot {
+    var displayName: string;
+}
+
+declare type Breakpoint = (typeof BREAKPOINTS)[number];
+
+/** Ordered breakpoints. `base` is the unprefixed/mobile-first value. */
+declare const BREAKPOINTS: readonly ["sm", "md", "lg", "xl"];
+
+export declare const Button: ButtonComponent & {
+    displayName?: string;
+};
+
+declare const BUTTON_VARIANTS: readonly ["solid", "subtle", "surface", "outline", "text", "link"];
+
+export declare type ButtonColorScheme = ColorScheme;
+
+declare type ButtonComponent = <T extends ElementType = "button">(props: ButtonProps<T> & {
+    ref?: Ref<any>;
+}) => ReactNode;
+
+/**
+ * Groups related buttons and shares `size`/`variant`/`colorScheme`/`disabled`
+ * down to them via context. With `attached`, the buttons render as one segmented
+ * control (collapsed inner radii, merged borders).
+ */
+export declare function ButtonGroup({ children, orientation, attached, spacing, size, variant, colorScheme, disabled, className, role, ref, ...props }: ButtonGroupProps & {
+    ref?: Ref<HTMLDivElement>;
+}): JSX.Element;
+
+export declare namespace ButtonGroup {
+    var displayName: string;
+}
+
+export declare interface ButtonGroupProps extends Omit<HTMLAttributes<HTMLDivElement>, "color">, VariantProps<typeof buttonGroupVariants> {
+    children?: ReactNode;
+    /** Shared size applied to every child Button (each can still override). */
+    size?: ButtonSize;
+    /** Shared visual style applied to every child Button. */
+    variant?: ButtonVariant;
+    /** Shared hue applied to every child Button. */
+    colorScheme?: ButtonColorScheme;
+    /** Disable every child Button at once. */
+    disabled?: boolean;
+}
+
+/**
+ * Layout for a row/column of related buttons.
+ *
+ * - `attached` welds them into a single segmented control: zero gap, inner radii
+ *   collapsed, and adjacent borders merged (negative margin) so shared edges don't
+ *   double up. The child-targeting utilities are safelisted in tailwind-entry.css.
+ * - Otherwise the buttons are spaced by `spacing`.
+ */
+declare const buttonGroupVariants: (props?: ({
+    orientation?: "horizontal" | "vertical" | null | undefined;
+    attached?: boolean | null | undefined;
+    spacing?: "sm" | "md" | "lg" | "none" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare type ButtonLoaderPlacement = "start" | "end";
+
+/**
+ * Props owned by Button. Everything else is forwarded to the rendered element,
+ * whose attribute set is derived from `as` (defaults to `"button"`).
+ */
+declare interface ButtonOwnProps extends Omit<VariantProps<typeof buttonVariants>, "isDisabledOrLoading" | "isIconOnly"> {
+    /** Visual style. `surface` is the bordered sibling of `subtle`; `text` is the ghost style. */
+    variant?: ButtonVariant;
+    /** Hue the variant paints with. Defaults to `brand`; use `gray` for a neutral button. */
+    colorScheme?: ButtonColorScheme;
+    children?: ReactNode;
+    disabled?: boolean;
+    loading?: boolean;
+    /** Replaces the label while `loading` (e.g. "Saving…"); the spinner still shows. */
+    loadingText?: ReactNode;
+    loaderPlacement?: ButtonLoaderPlacement;
+    loader?: ReactNode;
+    leftIcon?: ReactNode;
+    rightIcon?: ReactNode;
+    className?: string;
+}
+
+/**
+ * Polymorphic Button. `as` swaps the underlying element (e.g. `"a"`, a router
+ * `Link`); the forwarded HTML props follow that element automatically. Defaults
+ * to a native `<button>`.
+ */
+export declare type ButtonProps<T extends ElementType = "button"> = {
+    as?: T;
+} & ButtonOwnProps & Omit<ComponentPropsWithoutRef<T>, keyof ButtonOwnProps | "as">;
+
+declare type ButtonSize = NonNullable<VariantProps<typeof buttonVariants>["size"]>;
+
+export declare type ButtonVariant = (typeof BUTTON_VARIANTS)[number];
+
+declare const buttonVariants: (props?: ({
+    size?: "xs" | "sm" | "md" | "lg" | "xl" | null | undefined;
+    rounded?: "sm" | "md" | "lg" | "xl" | "none" | "2xl" | "full" | null | undefined;
+    fullWidth?: boolean | null | undefined;
+    isDisabledOrLoading?: boolean | null | undefined;
+    isIconOnly?: boolean | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare const Calendar: typeof CalendarRoot & {
+    Root: typeof CalendarRoot;
+    Header: typeof CalendarHeader;
+    PrevTrigger: typeof CalendarPrevTrigger;
+    ViewTrigger: typeof CalendarViewTrigger;
+    NextTrigger: typeof CalendarNextTrigger;
+    Weekdays: typeof CalendarWeekdays;
+    Grid: typeof CalendarGrid;
+    Cell: typeof CalendarCell;
+};
+
+export declare function CalendarCell({ date, className, children, onClick, ref, ...props }: CalendarCellProps & {
+    ref?: Ref<HTMLButtonElement>;
+}): JSX.Element;
+
+export declare namespace CalendarCell {
+    var displayName: string;
+}
+
+export declare interface CalendarCellProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    date: Date;
+}
+
+export declare function CalendarGrid({ className, ref, ...props }: CalendarGridProps & {
+    ref?: Ref<HTMLDivElement>;
+}): JSX.Element;
+
+export declare namespace CalendarGrid {
+    var displayName: string;
+}
+
+export declare interface CalendarGridProps extends HTMLAttributes<HTMLDivElement> {
+}
+
+export declare function CalendarHeader({ className, ref, ...props }: CalendarHeaderProps & {
+    ref?: Ref<HTMLDivElement>;
+}): JSX.Element;
+
+export declare namespace CalendarHeader {
+    var displayName: string;
+}
+
+export declare interface CalendarHeaderProps extends HTMLAttributes<HTMLDivElement> {
+}
+
+export declare function CalendarNextTrigger({ className, onClick, children, ref, ...props }: CalendarTriggerProps & {
+    ref?: Ref<HTMLButtonElement>;
+}): JSX.Element;
+
+export declare namespace CalendarNextTrigger {
+    var displayName: string;
+}
+
+export declare function CalendarPrevTrigger({ className, onClick, children, ref, ...props }: CalendarTriggerProps & {
+    ref?: Ref<HTMLButtonElement>;
+}): JSX.Element;
+
+export declare namespace CalendarPrevTrigger {
+    var displayName: string;
+}
+
+export declare type CalendarRangeValue = {
+    start: Date | null;
+    end: Date | null;
+};
+
+export declare function CalendarRoot({ selectionMode, value, defaultValue, onValueChange, defaultMonth, locale, firstDayOfWeek, showOutsideDays, minDate, maxDate, isDateUnavailable, size, className, style, children, ref, ...props }: CalendarRootProps & {
+    ref?: Ref<HTMLDivElement>;
+}): JSX.Element;
+
+export declare namespace CalendarRoot {
+    var displayName: string;
+}
+
+export declare interface CalendarRootProps extends Omit<HTMLAttributes<HTMLDivElement>, "defaultValue"> {
+    selectionMode?: CalendarSelectionMode;
+    value?: CalendarValue;
+    defaultValue?: CalendarValue;
+    onValueChange?: (value: CalendarValue) => void;
+    defaultMonth?: Date;
+    locale?: string;
+    firstDayOfWeek?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    showOutsideDays?: boolean;
+    minDate?: Date;
+    maxDate?: Date;
+    isDateUnavailable?: (date: Date) => boolean;
+    size?: CalendarSize;
+    className?: string;
+    style?: CSSProperties;
+    children?: ReactNode;
+}
+
+export declare type CalendarSelectionMode = "single" | "multiple" | "range";
+
+export declare type CalendarSize = "sm" | "md" | "lg";
+
+export declare interface CalendarTriggerProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+}
+
+export declare type CalendarValue = Date | Date[] | CalendarRangeValue | null;
+
+export declare function CalendarViewTrigger({ className, children, ref, ...props }: CalendarTriggerProps & {
+    ref?: Ref<HTMLButtonElement>;
+}): JSX.Element;
+
+export declare namespace CalendarViewTrigger {
+    var displayName: string;
+}
+
+export declare function CalendarWeekdays({ className, ref, ...props }: CalendarWeekdaysProps & {
+    ref?: Ref<HTMLDivElement>;
+}): JSX.Element;
+
+export declare namespace CalendarWeekdays {
+    var displayName: string;
+}
+
+export declare interface CalendarWeekdaysProps extends HTMLAttributes<HTMLDivElement> {
+}
+
+export declare const Card: typeof CardRoot & {
+    Root: typeof CardRoot;
+    Header: typeof CardHeader;
+    Title: typeof CardTitle;
+    Description: typeof CardDescription;
+    Body: typeof CardBody;
+    Footer: typeof CardFooter;
+};
+
+export declare function CardBody({ className, style, children, ref, ...rest }: CardBodyProps & {
+    ref?: Ref<HTMLDivElement>;
+}): JSX.Element;
+
+export declare namespace CardBody {
+    var displayName: string;
+}
+
+export declare interface CardBodyProps extends HTMLAttributes<HTMLDivElement> {
+    className?: string;
+    style?: CSSProperties;
+    children?: ReactNode;
+}
+
+export declare function CardDescription({ className, style, children, ref, ...rest }: CardDescriptionProps & {
+    ref?: Ref<HTMLParagraphElement>;
+}): JSX.Element;
+
+export declare namespace CardDescription {
+    var displayName: string;
+}
+
+export declare interface CardDescriptionProps extends HTMLAttributes<HTMLParagraphElement> {
+    className?: string;
+    style?: CSSProperties;
+    children?: ReactNode;
+}
+
+export declare function CardFooter({ className, style, children, ref, ...rest }: CardFooterProps & {
+    ref?: Ref<HTMLDivElement>;
+}): JSX.Element;
+
+export declare namespace CardFooter {
+    var displayName: string;
+}
+
+export declare interface CardFooterProps extends HTMLAttributes<HTMLDivElement> {
+    className?: string;
+    style?: CSSProperties;
+    children?: ReactNode;
+}
+
+export declare function CardHeader({ extra, className, style, children, ref, ...rest }: CardHeaderProps & {
+    ref?: Ref<HTMLDivElement>;
+}): JSX.Element;
+
+export declare namespace CardHeader {
+    var displayName: string;
+}
+
+export declare interface CardHeaderProps extends HTMLAttributes<HTMLDivElement> {
+    /** Content rendered in the trailing slot (e.g. a button or link) */
+    extra?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+    children?: ReactNode;
+}
+
+export declare function CardRoot({ variant, size, hoverable, className, style, children, ref, ...rest }: CardRootProps & {
+    ref?: Ref<HTMLDivElement>;
+}): JSX.Element;
+
+export declare namespace CardRoot {
+    var displayName: string;
+}
+
+export declare interface CardRootProps extends HTMLAttributes<HTMLDivElement> {
+    /** Visual style of the card */
+    variant?: CardVariant;
+    /** Controls padding and border-radius */
+    size?: CardSize;
+    /** Lift card on hover */
+    hoverable?: boolean;
+    className?: string;
+    style?: CSSProperties;
+    children?: ReactNode;
+}
+
+export declare type CardSize = "sm" | "md" | "lg";
+
+export declare function CardTitle({ className, style, children, ref, ...rest }: CardTitleProps & {
+    ref?: Ref<HTMLHeadingElement>;
+}): JSX.Element;
+
+export declare namespace CardTitle {
+    var displayName: string;
+}
+
+export declare interface CardTitleProps extends HTMLAttributes<HTMLHeadingElement> {
+    className?: string;
+    style?: CSSProperties;
+    children?: ReactNode;
+}
+
+export declare type CardVariant = "elevated" | "outline" | "filled" | "unstyled";
+
+/** Compound API — `Carousel` is the root; parts hang off it. */
+export declare const Carousel: typeof CarouselRoot & {
+    Track: typeof CarouselTrack;
+    Slide: typeof CarouselSlide;
+    Control: typeof CarouselControl;
+    Prev: typeof CarouselPrev;
+    Next: typeof CarouselNext;
+    Indicator: typeof CarouselIndicator;
+    Indicators: typeof CarouselIndicators;
+    ProgressText: typeof CarouselProgressText;
+    AutoPlayTrigger: typeof CarouselAutoPlayTrigger;
+};
+
+export declare type CarouselAnimation = "slide" | "fade";
+
+export declare function CarouselAutoPlayTrigger({ className, children }: CarouselAutoPlayTriggerProps): JSX.Element;
+
+export declare interface CarouselAutoPlayTriggerProps {
+    className?: string;
+    children?: (isPlaying: boolean) => ReactNode;
+}
+
+/**
+ * Lays out the carousel's navigation controls so consumers never hand-roll the
+ * arrangement. Reads orientation from context: a centered bar under the slides
+ * when horizontal, a full-height column beside them when vertical.
+ */
+export declare function CarouselControl({ children, className }: CarouselControlGroupProps): JSX.Element;
+
+/** Lays out the navigation controls (Prev/Next/Indicators/etc.); orientation-aware. */
+export declare interface CarouselControlGroupProps {
+    children: ReactNode;
+    className?: string;
+}
+
+export declare interface CarouselControlProps {
+    /** Override the default chevron icon. */
+    icon?: ReactNode;
+    className?: string;
+}
+
+/** A single dot bound to one slide index — for hand-composed indicator rows. */
+export declare function CarouselIndicator({ index, className }: CarouselIndicatorProps): JSX.Element;
+
+export declare interface CarouselIndicatorProps {
+    index: number;
+    className?: string;
+}
+
+export declare function CarouselIndicators({ className, variant }: CarouselIndicatorsProps): JSX.Element | null;
+
+export declare interface CarouselIndicatorsProps {
+    className?: string;
+    /** @default "dot" */
+    variant?: CarouselIndicatorVariant;
+}
+
+export declare type CarouselIndicatorVariant = "dot" | "line" | "number";
+
+export declare function CarouselNext({ icon, className }: CarouselControlProps): JSX.Element;
+
+export declare type CarouselOrientation = "horizontal" | "vertical";
+
+export declare function CarouselPrev({ icon, className }: CarouselControlProps): JSX.Element;
+
+export declare function CarouselProgressText({ className, format }: CarouselProgressTextProps): JSX.Element;
+
+export declare interface CarouselProgressTextProps {
+    className?: string;
+    format?: (index: number, total: number) => ReactNode;
+}
+
+export declare interface CarouselProps {
+    /** Active leading-slide index (controlled). */
+    index?: number;
+    /** Initial index when uncontrolled. @default 0 */
+    defaultIndex?: number;
+    onIndexChange?: (index: number) => void;
+    beforeChange?: (from: number, to: number) => void;
+    afterChange?: (current: number) => void;
+    /** Slides visible at once. Fractional values (e.g. 1.2) peek the next slide. @default 1 */
+    slidesPerView?: number;
+    /** Slides advanced per Prev/Next/swipe step. @default 1 */
+    slidesToScroll?: number;
+    /** Gap between slides, in pixels. @default 0 */
+    slideGap?: number;
+    /** Wrap from last step to first (and back). @default false */
+    loop?: boolean;
+    autoPlay?: boolean;
+    autoPlayInterval?: number;
+    pauseOnHover?: boolean;
+    /** `slide` translates the track; `fade` cross-fades stacked slides (single view). @default "slide" */
+    animation?: CarouselAnimation;
+    orientation?: CarouselOrientation;
+    /** Transition duration in ms. @default 300 */
+    speed?: number;
+    easing?: string;
+    disabled?: boolean;
+    swipeable?: boolean;
+    draggable?: boolean;
+    /** Sizing of the built-in controls and indicators. @default "md" */
+    size?: CarouselSize;
+    /** Hue for active indicators and focus rings. @default "brand" */
+    colorScheme?: ColorScheme;
+    className?: string;
+    style?: CSSProperties;
+    children: ReactNode;
+}
+
+declare function CarouselRoot({ index: controlledIndex, defaultIndex, onIndexChange, beforeChange, afterChange, slidesPerView, slidesToScroll, slideGap, loop, autoPlay, autoPlayInterval, pauseOnHover, animation, orientation, speed, easing, disabled, swipeable, draggable, size, colorScheme, className, style, children, }: CarouselProps): JSX.Element;
+
+export declare type CarouselSize = "sm" | "md" | "lg";
+
+export declare function CarouselSlide({ children, className }: CarouselSlideProps): JSX.Element;
+
+export declare interface CarouselSlideProps {
+    children: ReactNode;
+    className?: string;
+}
+
+export declare function CarouselTrack({ children, className }: CarouselTrackProps): JSX.Element;
+
+export declare interface CarouselTrackProps {
+    children: ReactNode;
+    className?: string;
+}
+
+/** Centers its children on both axes (flex + items/justify center). Carries all Box props. */
+export declare const Center: CenterComponent;
+
+declare type CenterComponent = <T extends ElementType = "div">(props: CenterProps<T> & {
+    ref?: Ref<any>;
+}) => ReactNode;
+
+/** Center adds no custom props — it's a Box that centers its children on both axes. */
+export declare type CenterProps<T extends ElementType = "div"> = BoxProps<T>;
+
+/** A selectable tag — solid/brand when checked, subtle/gray when not. */
+export declare function CheckableTag({ children, checked, onChange, colorScheme, size, startElement, endElement, className, ref, ...rest }: CheckableTagProps & {
+    ref?: Ref<HTMLSpanElement>;
+}): JSX.Element;
+
+export declare namespace CheckableTag {
+    var displayName: string;
+}
+
+/** Renders a set of CheckableTags with single- or multi-select behaviour. */
+export declare function CheckableTagGroup({ value, onChange, options, multiple, size, colorScheme, className, style, ...rest }: CheckableTagGroupProps): JSX.Element;
+
+export declare namespace CheckableTagGroup {
+    var displayName: string;
+}
+
+export declare interface CheckableTagGroupProps extends Omit<ComponentPropsWithoutRef<"div">, "onChange" | "defaultValue"> {
+    value?: (string | number)[];
+    onChange?: (value: (string | number)[]) => void;
+    options: TagOption[] | (string | number)[];
+    multiple?: boolean;
+    size?: TagSize;
+    colorScheme?: ColorScheme;
+    className?: string;
+    style?: CSSProperties;
+}
+
+export declare interface CheckableTagProps extends Omit<TagProps, "variant" | "colorScheme" | "closable" | "onClose" | "onChange"> {
+    /** Selected state. */
+    checked?: boolean;
+    onChange?: (checked: boolean) => void;
+    /** Hue used when checked. @default "brand" */
+    colorScheme?: ColorScheme;
+}
+
+export declare const Checkbox: typeof CheckboxBase & {
+    Group: typeof CheckboxGroup;
+};
+
+export declare function CheckboxBase({ children, size, colorScheme, indeterminate, invalid: invalidProp, disabled: disabledProp, checked: checkedProp, defaultChecked, onChange: onChangeProp, readOnly: readOnlyProp, value, className, id, ref, ...props }: CheckboxProps & {
+    ref?: Ref<HTMLInputElement>;
+}): JSX.Element;
+
+export declare namespace CheckboxBase {
+    var displayName: string;
+}
+
+export declare function CheckboxGroup({ value, defaultValue, onChange, disabled, colorScheme, orientation, children, className, ...rest }: CheckboxGroupProps): JSX.Element;
+
+export declare namespace CheckboxGroup {
+    var displayName: string;
+}
+
+export declare interface CheckboxGroupContextValue {
+    groupValue: string[];
+    toggleValue: (val: string) => void;
+    disabled?: boolean;
+    colorScheme?: ColorScheme;
+}
+
+export declare interface CheckboxGroupProps extends Omit<ComponentPropsWithoutRef<"div">, "onChange" | "defaultValue"> {
+    /** Controlled selected values */
+    value?: string[];
+    /** Default selected values (uncontrolled) */
+    defaultValue?: string[];
+    /** Callback fired when selection changes */
+    onChange?: (value: string[]) => void;
+    /** Disables all checkboxes in the group */
+    disabled?: boolean;
+    /** Hue applied to every checkbox in the group (each can still override). */
+    colorScheme?: ColorScheme;
+    /** Layout direction */
+    orientation?: "horizontal" | "vertical";
+    children: ReactNode;
+}
+
+export declare interface CheckboxProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "type"> {
+    /** Whether the checkbox is checked (controlled) */
+    checked?: boolean;
+    /** Default checked state (uncontrolled) */
+    defaultChecked?: boolean;
+    /** Visual size */
+    size?: CheckboxSize;
+    /** Hue the checked box paints with (via the accent channel). @default "brand" */
+    colorScheme?: ColorScheme;
+    /** Indeterminate state — visually shows a dash instead of check */
+    indeterminate?: boolean;
+    /** Label content rendered next to the checkbox */
+    children?: ReactNode;
+    /** Invalid/error state */
+    invalid?: boolean;
+    /** Read-only state */
+    readOnly?: boolean;
+}
+
+export declare type CheckboxSize = "sm" | "md" | "lg";
+
+/** Inline code — a monospace `<code>` chip for snippets inside prose. */
+export declare const Code: CodeComponent;
+
+export declare const CodeBlock: CodeBlockComponent;
+
+declare type CodeBlockBaseProps = CodeBlockCustomProps & Responsive<VariantProps<typeof codeBlockVariants>> & Responsive<VariantProps<typeof codeBlockBodyVariants>>;
+
+declare const codeBlockBodyVariants: (props?: ({
+    readonly size?: "sm" | "md" | "lg" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+declare type CodeBlockComponent = <T extends ElementType = "div">(props: CodeBlockProps<T> & {
+    ref?: Ref<any>;
+}) => ReactNode;
+
+declare interface CodeBlockCustomProps {
+    /** Optional language tag rendered as a small header above the code. */
+    language?: ReactNode;
+    /** Show macOS-style window dots in the header (works with any variant). */
+    windowControls?: boolean;
+    /**
+     * Opt-in syntax-highlighting slot. Pass pre-tokenized HTML (e.g. the output of
+     * Shiki/Prism in the consumer app) and it renders raw inside `<code>`, bypassing
+     * `children`. The library stays dependency-free; highlighting is the consumer's call.
+     */
+    highlightedHtml?: string;
+}
+
+export declare type CodeBlockProps<T extends ElementType = "div"> = Omit<BoxProps<T>, keyof CodeBlockBaseProps> & CodeBlockBaseProps;
+
+declare const codeBlockVariants: (props?: ({
+    readonly variant?: "solid" | "subtle" | "outline" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+declare type CodeComponent = <T extends ElementType = "code">(props: CodeProps<T> & {
+    ref?: Ref<any>;
+}) => ReactNode;
+
+/** `variant` and `size` each accept a scalar token or a responsive map. */
+declare type CodeCustomProps = Responsive<VariantProps<typeof codeVariants>>;
+
+export declare type CodeProps<T extends ElementType = "code"> = BoxProps<T> & CodeCustomProps;
+
+declare const codeVariants: (props?: ({
+    readonly variant?: "solid" | "subtle" | "outline" | null | undefined;
+    readonly size?: "sm" | "md" | "lg" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+/**
+ * The library-wide `colorScheme` palette. Any component that paints with the
+ * `accent-*` utilities can expose `colorScheme` by applying `accentClass(scheme)` —
+ * the scope class that rebinds the accent channel to a real hue (see accent.css).
+ *
+ * Add a hue here AND a matching `.astralis-accent-{hue}` block in accent.css to
+ * make it available everywhere at once.
+ */
+declare const COLOR_SCHEMES: readonly ["brand", "gray", "red", "orange", "yellow", "green", "teal", "blue", "cyan", "purple", "pink"];
+
+declare type ColorScheme = (typeof COLOR_SCHEMES)[number];
+
+/**
+ * A filterable single-value picker on the ARIA combobox pattern: type to
+ * filter, arrows to move the active option, Enter to commit, Escape to
+ * revert. Built from the same shared option machinery as Select/MultiSelect.
+ */
+export declare const Combobox: ForwardRefExoticComponent<ComboboxProps & RefAttributes<HTMLInputElement>>;
+
+export declare interface ComboboxOptionGroup {
+    group: string;
+    options: ComboboxOptionItem[];
+}
+
+export declare interface ComboboxOptionItem {
+    label: string;
+    value: string | number;
+    disabled?: boolean;
+}
+
+export declare type ComboboxOptionOrGroup = ComboboxOptionItem | ComboboxOptionGroup;
+
+export declare interface ComboboxProps {
+    options?: ComboboxOptionOrGroup[];
+    /** Controlled selected value; `null` = nothing selected. */
+    value?: string | number | null;
+    defaultValue?: string | number | null;
+    /** Fires when a selection commits (pick or clear). */
+    onChange?: (value: string | number | null) => void;
+    /** Fires on every keystroke in the filter text. */
+    onInputChange?: (text: string) => void;
+    placeholder?: string;
+    size?: InputSize;
+    variant?: InputVariant;
+    /** Hue for focus ring and active option (via the accent channel). @default "brand" */
+    colorScheme?: ColorScheme;
+    disabled?: boolean;
+    invalid?: boolean;
+    readOnly?: boolean;
+    /** Show a clear button when a value is selected. */
+    clearable?: boolean;
+    loading?: boolean;
+    /** Text shown when nothing matches the filter. */
+    emptyText?: string;
+    /** Form field name — renders a hidden input for native submission. */
+    name?: string;
+    className?: string;
+    id?: string;
+}
+
+/**
+ * Container centers its content horizontally (`margin-inline: auto`) up to a max
+ * width, with default horizontal padding. `maxW` and `px` are Box props with sane
+ * defaults — override them like any style prop. `centerContent` stacks children
+ * in a centered column.
+ */
+export declare const Container: ContainerComponent;
+
+declare type ContainerComponent = <T extends ElementType = "div">(props: ContainerProps<T> & {
+    ref?: Ref<any>;
+}) => ReactNode;
+
+declare interface ContainerCustomProps {
+    /** When true, lays children out in a centered column. */
+    centerContent?: boolean;
+}
+
+export declare type ContainerProps<T extends ElementType = "div"> = BoxProps<T> & ContainerCustomProps;
+
+export declare const DataList: typeof DataListRoot & {
+    Item: typeof DataListItem;
+    Label: typeof DataListLabel;
+    Value: typeof DataListValue;
+};
+
+export declare function DataListItem({ children, className }: DataListItemProps): JSX.Element;
+
+export declare interface DataListItemProps {
+    children: ReactNode;
+    className?: string;
+}
+
+export declare function DataListLabel({ children, className }: DataListLabelProps): JSX.Element;
+
+export declare interface DataListLabelProps {
+    children: ReactNode;
+    className?: string;
+}
+
+declare type DataListOrientation = "horizontal" | "vertical";
+
+export declare interface DataListProps {
+    children: ReactNode;
+    /** `horizontal` lays label + value side by side; `vertical` stacks them. @default "horizontal" */
+    orientation?: DataListOrientation;
+    size?: DataListSize;
+    className?: string;
+}
+
+declare function DataListRoot({ children, orientation, size, className }: DataListProps): JSX.Element;
+
+declare type DataListSize = "sm" | "md" | "lg";
+
+export declare function DataListValue({ children, className }: DataListValueProps): JSX.Element;
+
+export declare interface DataListValueProps {
+    children: ReactNode;
+    className?: string;
+}
+
+/** Flips `open` so the exit transition plays; the Toaster removes it after. */
+declare function dismissToast(id?: string): void;
+
+/** Compound API — `Drawer` is the root; parts hang off it. */
+export declare const Drawer: typeof DrawerRoot & {
+    Trigger: typeof DrawerTrigger;
+    Content: typeof DrawerContent;
+    Header: typeof DrawerHeader;
+    Body: typeof DrawerBody;
+    Footer: typeof DrawerFooter;
+    Title: typeof DrawerTitle;
+    Description: typeof DrawerDescription;
+    Close: typeof DrawerClose;
+    CloseButton: typeof DrawerCloseButton;
+};
+
+export declare function DrawerBody({ children, className }: DrawerSectionProps): JSX.Element;
+
+export declare function DrawerClose({ children }: DrawerSlotProps): ReactElement<any, string | JSXElementConstructor<any>>;
+
+export declare function DrawerCloseButton({ className }: {
+    className?: string;
+}): JSX.Element;
+
+export declare function DrawerContent({ children, className, ...rest }: DrawerContentProps): JSX.Element | null;
+
+export declare interface DrawerContentProps extends ComponentPropsWithoutRef<"div"> {
+    children: ReactNode;
+    className?: string;
+}
+
+export declare function DrawerDescription({ children, className }: DrawerSectionProps): JSX.Element;
+
+export declare function DrawerFooter({ children, className }: DrawerSectionProps): JSX.Element;
+
+export declare function DrawerHeader({ children, className }: DrawerSectionProps): JSX.Element;
+
+export declare type DrawerPlacement = "left" | "right" | "top" | "bottom";
+
+export declare interface DrawerProps {
+    children: ReactNode;
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** Edge the drawer slides in from. @default "right" */
+    placement?: DrawerPlacement;
+    size?: DrawerSize;
+    closeOnOverlayClick?: boolean;
+    closeOnEsc?: boolean;
+}
+
+declare function DrawerRoot({ children, open: openProp, defaultOpen, onOpenChange, placement, size, closeOnOverlayClick, closeOnEsc, }: DrawerProps): JSX.Element;
+
+export declare interface DrawerSectionProps {
+    children: ReactNode;
+    className?: string;
+}
+
+export declare type DrawerSize = "sm" | "md" | "lg" | "xl" | "full";
+
+export declare interface DrawerSlotProps {
+    children: ReactElement<any>;
+}
+
+export declare function DrawerTitle({ children, className }: DrawerSectionProps): JSX.Element;
+
+export declare function DrawerTrigger({ children }: DrawerSlotProps): ReactElement<any, string | JSXElementConstructor<any>>;
+
+/** The shared status vocabulary for feedback components (Alert, Toast). */
+declare type FeedbackStatus = "info" | "success" | "warning" | "error";
+
+export declare const Field: typeof FieldRoot & {
+    Label: typeof FieldLabel;
+    HelpText: typeof FieldHelpText;
+    ErrorText: typeof FieldErrorText;
+};
+
+export declare interface FieldContextValue {
+    /** Auto-generated or user-provided id wired to the input */
+    id: string;
+    /** Whether the field is in an invalid/error state */
+    invalid?: boolean;
+    /** Whether the field is disabled */
+    disabled?: boolean;
+    /** Whether the field is required */
+    required?: boolean;
+    /** Whether the field is read-only */
+    readOnly?: boolean;
+    /** Stable id Field.HelpText renders with (`{id}-help`) */
+    helpTextId: string;
+    /** Stable id Field.ErrorText renders with (`{id}-error`) */
+    errorTextId: string;
+    /**
+     * Space-separated ids of the help/error text currently rendered — inputs
+     * pass this straight to aria-describedby so screen readers announce the
+     * descriptions together with the control. Undefined when neither part is
+     * mounted.
+     */
+    describedBy?: string;
+    /** Registration hooks called by HelpText/ErrorText on mount/unmount. */
+    setHasHelpText: (present: boolean) => void;
+    setHasErrorText: (present: boolean) => void;
+}
+
+export declare function FieldErrorText({ children, className, ref, ...props }: FieldErrorTextProps & {
+    ref?: Ref<HTMLParagraphElement>;
+}): JSX.Element;
+
+export declare namespace FieldErrorText {
+    var displayName: string;
+}
+
+export declare interface FieldErrorTextProps extends HTMLAttributes<HTMLParagraphElement> {
+}
+
+export declare function FieldHelpText({ children, className, ref, ...props }: FieldHelpTextProps & {
+    ref?: Ref<HTMLParagraphElement>;
+}): JSX.Element;
+
+export declare namespace FieldHelpText {
+    var displayName: string;
+}
+
+export declare interface FieldHelpTextProps extends HTMLAttributes<HTMLParagraphElement> {
+}
+
+export declare function FieldLabel({ children, className, ref, ...props }: FieldLabelProps & {
+    ref?: Ref<HTMLLabelElement>;
+}): JSX.Element;
+
+export declare namespace FieldLabel {
+    var displayName: string;
+}
+
+export declare interface FieldLabelProps extends LabelHTMLAttributes<HTMLLabelElement> {
+}
+
+/**
+ * Groups a control with its label, help text, and error text — sharing state
+ * (id, invalid, disabled, required, readOnly) with descendants via context.
+ */
+export declare function FieldRoot({ children, invalid, disabled, required, readOnly, id: userProvidedId, className, ...props }: FieldRootProps): JSX.Element;
+
+export declare namespace FieldRoot {
+    var displayName: string;
+}
+
+export declare interface FieldRootProps extends HTMLAttributes<HTMLDivElement> {
+    /** Marks the field as invalid — turns border red, shows error text */
+    invalid?: boolean;
+    /** Disables the entire field and its children */
+    disabled?: boolean;
+    /** Marks the field as required — shows * in label */
+    required?: boolean;
+    /** Marks the field as read-only */
+    readOnly?: boolean;
+    /** Explicit id for the input; auto-generated if not provided */
+    id?: string;
+}
+
+export declare const Flex: (<T extends ElementType = "div">(props: FlexProps<T> & {
+    ref?: Ref<any>;
+}) => ReactNode) & {
+    Item: <T extends ElementType = "div">(props: FlexItemProps<T> & {
+        ref?: Ref<any>;
+    }) => ReactNode;
+};
+
+/** Flex container layout props — each accepts a scalar token or a responsive map. */
+declare type FlexCustomProps = Responsive<VariantProps<typeof flexVariants>>;
+
+export declare const FlexItem: FlexItemComponent;
+
+declare type FlexItemComponent = <T extends ElementType = "div">(props: FlexItemProps<T> & {
+    ref?: Ref<any>;
+}) => ReactNode;
+
+/** Flex item self-alignment/sizing props — each responsive. */
+declare type FlexItemCustomProps = Responsive<VariantProps<typeof flexItemVariants>>;
+
+export declare type FlexItemProps<T extends ElementType = "div"> = BoxProps<T> & FlexItemCustomProps;
+
+declare const flexItemVariants: (props?: ({
+    readonly basis?: "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "full" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "auto" | "12" | "10" | "max" | "min" | "11" | "8" | "3xl" | "4xl" | "5xl" | "6xl" | "7xl" | "8xl" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | "3xs" | "2xs" | "1/2" | "1/3" | "2/3" | "1/4" | "3/4" | "1/5" | "2/5" | "3/5" | "4/5" | "1/6" | "2/6" | "3/6" | "4/6" | "5/6" | "1/12" | "2/12" | "3/12" | "4/12" | "5/12" | "6/12" | "7/12" | "8/12" | "9/12" | "10/12" | "11/12" | "fit" | null | undefined;
+    readonly flex?: "none" | "1" | "auto" | "initial" | null | undefined;
+    readonly grow?: boolean | "0" | "1" | null | undefined;
+    readonly shrink?: boolean | "0" | "1" | null | undefined;
+    readonly order?: "none" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "12" | "10" | "first" | "last" | "11" | "8" | "9" | null | undefined;
+    readonly alignSelf?: "start" | "end" | "center" | "auto" | "baseline" | "stretch" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare type FlexProps<T extends ElementType = "div"> = BoxProps<T> & FlexCustomProps;
+
+declare const flexVariants: (props?: ({
+    readonly direction?: "row" | "column" | "column-reverse" | "row-reverse" | null | undefined;
+    readonly justifyContent?: "start" | "end" | "center" | "between" | "around" | "evenly" | null | undefined;
+    readonly alignItems?: "start" | "end" | "center" | "baseline" | "stretch" | null | undefined;
+    readonly alignContent?: "start" | "end" | "center" | "stretch" | "between" | "around" | "evenly" | null | undefined;
+    readonly placeContent?: "start" | "end" | "center" | "stretch" | "between" | "around" | "evenly" | null | undefined;
+    readonly wrap?: "wrap" | "nowrap" | "wrap-reverse" | null | undefined;
+    readonly gap?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | "12" | "10" | "11" | "8" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | null | undefined;
+    readonly rowGap?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | "12" | "10" | "11" | "8" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | null | undefined;
+    readonly columnGap?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | "12" | "10" | "11" | "8" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+/**
+ * Float positions its content at the edge/corner of the nearest positioned
+ * ancestor — wrap it in a `position="relative"` Box. Ideal for badges, dots,
+ * and close buttons overlaid on a container.
+ */
+export declare const Float: FloatComponent;
+
+declare type FloatComponent = <T extends ElementType = "div">(props: FloatProps<T> & {
+    ref?: Ref<any>;
+}) => ReactNode;
+
+/** `placement` accepts a scalar token or a responsive map. */
+declare type FloatCustomProps = Responsive<VariantProps<typeof floatVariants>>;
+
+export declare type FloatProps<T extends ElementType = "div"> = BoxProps<T> & FloatCustomProps;
+
+declare const floatVariants: (props?: ({
+    readonly placement?: "top-start" | "top-center" | "top-end" | "bottom-start" | "bottom-center" | "bottom-end" | "middle-start" | "middle-center" | "middle-end" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+/**
+ * Runtime CSS variables for the 10 brand shades, injected as inline styles on
+ * the provider div, overriding the CSS defaults in semantic.css.
+ *
+ * NOTE: keys must match the primitive layer the semantic tokens read from
+ * (--astralis-color-brand-*), which @theme maps to --color-brand-*.
+ */
+export declare function generateBrandShades(brandColor: string | undefined): CSSProperties;
+
+/**
+ * Shades PLUS the brand/accent ROLE tokens, per theme.
+ *
+ * Overriding only the primitive shades is not enough: role tokens like
+ * --astralis-color-brand-solid are declared at :root, where their var()
+ * references are substituted ONCE against the default palette — descendants
+ * inherit that already-resolved value, so a subtree shade override never
+ * reaches components that paint with roles (i.e. nearly all of them). The
+ * roles must be re-declared alongside the shades, with the same per-theme
+ * formulas as semantic.css. The accent channel defaults to brand at :root
+ * and is baked the same way, so it gets re-declared too.
+ */
+export declare function generateBrandTokens(brandColor: string | undefined, mode: "light" | "dark"): CSSProperties;
+
+export declare const Grid: (<T extends ElementType = "div">(props: GridProps<T> & {
+    ref?: Ref<any>;
+}) => ReactNode) & {
+    Item: <T extends ElementType = "div">(props: GridItemProps<T> & {
+        ref?: Ref<any>;
+    }) => ReactNode;
+};
+
+/** Grid container layout props — each accepts a scalar token or a responsive map. */
+declare type GridCustomProps = Responsive<VariantProps<typeof gridVariants>> & {
+    /** Raw `grid-template-columns` escape hatch for arbitrary tracks, e.g. "200px 1fr". */
+    templateColumns?: string;
+    /** Raw `grid-template-rows` escape hatch for arbitrary tracks. */
+    templateRows?: string;
+    /** Raw `grid-template-areas` string, e.g. `'"head head" "nav main"'`. */
+    templateAreas?: string;
+};
+
+export declare const GridItem: GridItemComponent;
+
+declare type GridItemComponent = <T extends ElementType = "div">(props: GridItemProps<T> & {
+    ref?: Ref<any>;
+}) => ReactNode;
+
+/** Grid item placement props — each responsive. */
+declare type GridItemCustomProps = Responsive<VariantProps<typeof gridItemVariants>> & {
+    /** Named grid area (`grid-area`) matching a Grid `templateAreas` cell. */
+    area?: string;
+};
+
+export declare type GridItemProps<T extends ElementType = "div"> = BoxProps<T> & GridItemCustomProps;
+
+declare const gridItemVariants: (props?: ({
+    readonly colSpan?: "full" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "12" | "10" | "11" | "8" | "9" | null | undefined;
+    readonly colStart?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | "auto" | "12" | "10" | "11" | "8" | "9" | "13" | null | undefined;
+    readonly colEnd?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | "auto" | "12" | "10" | "11" | "8" | "9" | "13" | null | undefined;
+    readonly rowSpan?: "full" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "12" | "10" | "11" | "8" | "9" | null | undefined;
+    readonly rowStart?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | "auto" | "12" | "10" | "11" | "8" | "9" | "13" | null | undefined;
+    readonly rowEnd?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | "auto" | "12" | "10" | "11" | "8" | "9" | "13" | null | undefined;
+    readonly order?: "none" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "12" | "10" | "first" | "last" | "11" | "8" | "9" | null | undefined;
+    readonly alignSelf?: "start" | "end" | "center" | "auto" | "baseline" | "stretch" | null | undefined;
+    readonly justifySelf?: "start" | "end" | "center" | "auto" | "stretch" | null | undefined;
+    readonly placeSelf?: "start" | "end" | "center" | "auto" | "stretch" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare type GridProps<T extends ElementType = "div"> = BoxProps<T> & GridCustomProps;
+
+declare const gridVariants: (props?: ({
+    readonly columns?: "none" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "12" | "10" | "11" | "8" | "9" | null | undefined;
+    readonly rows?: "none" | "1" | "2" | "3" | "4" | "5" | "6" | null | undefined;
+    readonly flow?: "col" | "row" | "dense" | "col-dense" | null | undefined;
+    readonly autoColumns?: "auto" | "max" | "min" | "fr" | null | undefined;
+    readonly autoRows?: "auto" | "max" | "min" | "fr" | null | undefined;
+    readonly justifyItems?: "start" | "end" | "center" | "stretch" | null | undefined;
+    readonly alignItems?: "start" | "end" | "center" | "baseline" | "stretch" | null | undefined;
+    readonly justifyContent?: "start" | "end" | "center" | "between" | "around" | "evenly" | null | undefined;
+    readonly alignContent?: "start" | "end" | "center" | "stretch" | "between" | "around" | "evenly" | null | undefined;
+    readonly placeContent?: "start" | "end" | "center" | "stretch" | "between" | "around" | "evenly" | null | undefined;
+    readonly placeItems?: "start" | "end" | "center" | "stretch" | null | undefined;
+    readonly gap?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | "12" | "10" | "11" | "8" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | null | undefined;
+    readonly rowGap?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | "12" | "10" | "11" | "8" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | null | undefined;
+    readonly columnGap?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | "12" | "10" | "11" | "8" | "0.5" | "1.5" | "2.5" | "3.5" | "4.5" | "9" | "14" | "16" | "20" | "24" | "28" | "32" | "36" | "40" | "44" | "48" | "52" | "56" | "60" | "64" | "72" | "80" | "96" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare const Heading: HeadingComponent;
+
+declare type HeadingComponent = <T extends HeadingElement = "h2">(props: HeadingProps<T> & {
+    ref?: Ref<any>;
+}) => ReactNode;
+
+declare type HeadingElement = "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
+
+export declare type HeadingProps<T extends HeadingElement = "h2"> = Omit<TextProps<T>, "as" | "paragraph"> & {
+    as?: T;
+};
+
+/**
+ * Highlight wraps every occurrence of `query` within its text in a styled `<mark>`.
+ * It renders inline, so it can live inside a `<Text>` or any prose.
+ */
+declare function Highlight_2({ children, query, ignoreCase, variant, markClassName, className, ref, ...props }: HighlightProps & {
+    ref?: Ref<HTMLSpanElement>;
+}): JSX.Element;
+
+declare namespace Highlight_2 {
+    var displayName: string;
+}
+export { Highlight_2 as Highlight }
+
+declare interface HighlightCustomProps {
+    /** The full text to scan. Highlight operates on a plain string. */
+    children: string;
+    /** One or more substrings to wrap in `<mark>`. */
+    query: string | string[];
+    /** Match case-insensitively (default `true`). */
+    ignoreCase?: boolean;
+    /** Extra className applied to each matched `<mark>`. */
+    markClassName?: string;
+}
+
+declare const highlightMarkVariants: (props?: ({
+    readonly variant?: "solid" | "subtle" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare type HighlightProps = HighlightCustomProps & VariantProps<typeof highlightMarkVariants> & Omit<ComponentPropsWithoutRef<"span">, keyof HighlightCustomProps>;
+
+export declare const HStack: StackPresetComponent;
+
+/**
+ * Icon — a bring-your-own-icon wrapper. It standardizes size (our sizing tokens),
+ * colour (semantic tokens, inherited via `currentColor`), and stroke width, then
+ * renders the icon you supply via `as` (an icon component) or `children` (a raw
+ * `<svg>`). The library bundles NO icon set, so consumers ship only what they use.
+ *
+ * Decorative by default (`aria-hidden`); pass `aria-label` to expose it to AT.
+ */
+export declare function Icon({ as: As, children, size, color, strokeWidth, className, style, ref, ...rest }: IconProps & {
+    ref?: Ref<SVGSVGElement>;
+}): JSX.Element | null;
+
+export declare namespace Icon {
+    var displayName: string;
+}
+
+/** Any semantic text-colour token (icons inherit colour via `currentColor`). */
+export declare type IconColor = keyof typeof textColors;
+
+export declare interface IconProps extends Omit<ComponentPropsWithoutRef<"svg">, "color"> {
+    /** Render this icon component (e.g. a Lucide / Heroicons component, or your own). */
+    as?: ElementType;
+    /** …or pass a raw `<svg>` as children. */
+    children?: ReactNode;
+    /** Token (`xs`–`xl`) or an explicit pixel number. */
+    size?: IconSize;
+    /** A semantic text-colour token; omit to inherit the surrounding text colour. */
+    color?: IconColor;
+    strokeWidth?: number;
+}
+
+export declare type IconSize = "xs" | "sm" | "md" | "lg" | "xl" | number;
+
+declare const Image_2: typeof ImageRoot & {
+    Group: typeof ImageGroup;
+};
+export { Image_2 as Image }
+
+export declare type ImageAspectRatio = "square" | "video" | "portrait" | "wide" | (string & {});
+
+export declare function ImageGroup({ items, columns, gap, rounded, objectFit, className, style, }: ImageGroupProps): JSX.Element;
+
+export declare namespace ImageGroup {
+    var displayName: string;
+}
+
+export declare interface ImageGroupItem {
+    src: string;
+    alt: string;
+    caption?: ReactNode;
+}
+
+export declare interface ImageGroupProps {
+    items: ImageGroupItem[];
+    columns?: 2 | 3 | 4;
+    gap?: "sm" | "md" | "lg";
+    rounded?: ImageRounded;
+    objectFit?: ImageObjectFit;
+    className?: string;
+    style?: CSSProperties;
+}
+
+export declare type ImageObjectFit = "contain" | "cover" | "fill" | "none" | "scale-down";
+
+export declare interface ImageProps {
+    src: string;
+    alt: string;
+    className?: string;
+    style?: CSSProperties;
+    width?: number | string;
+    height?: number | string;
+    objectFit?: ImageObjectFit;
+    loading?: "eager" | "lazy";
+    srcset?: string;
+    sizes?: string;
+    /** A blurred low-res URL shown while loading, or "blur" for the default shimmer */
+    placeholder?: "blur" | "empty" | string;
+    rounded?: ImageRounded;
+    /** Fixed aspect-ratio wrapper: "square"=1/1, "video"=16/9, "portrait"=3/4, "wide"=21/9, or any CSS ratio e.g. "4/3" */
+    aspectRatio?: ImageAspectRatio;
+    /** Fallback element shown when the image fails to load */
+    fallback?: ReactNode;
+    /** Short text shown below the image in a <figcaption> */
+    caption?: ReactNode;
+    /** Enables click-to-preview lightbox */
+    preview?: boolean;
+    onLoad?: () => void;
+    onError?: () => void;
+    ariaLabel?: string;
+}
+
+export declare function ImageRoot({ src, alt, className, style, width, height, objectFit, loading, srcset, sizes, placeholder, rounded, aspectRatio, fallback, caption, preview, onLoad, onError, ariaLabel, ref, }: ImageProps & {
+    ref?: Ref<HTMLImageElement>;
+}): JSX.Element;
+
+export declare namespace ImageRoot {
+    var displayName: string;
+}
+
+export declare type ImageRounded = "none" | "sm" | "md" | "lg" | "xl" | "2xl" | "3xl" | "full";
+
+export declare const Input: typeof InputBase & {
+    Password: typeof InputPassword;
+    Search: typeof InputSearch;
+    TextArea: typeof InputTextarea;
+};
+
+export declare function InputBase({ size, variant, invalid: invalidProp, disabled: disabledProp, readOnly: readOnlyProp, className, id: idProp, ref, ...props }: InputProps & {
+    ref?: Ref<HTMLInputElement>;
+}): JSX.Element;
+
+export declare namespace InputBase {
+    var displayName: string;
+}
+
+/**
+ * Wraps an Input with prefix/suffix slots. Uses context so the child Input can
+ * self-apply the correct start/end padding.
+ */
+export declare function InputGroup({ prefix, suffix, children, className }: InputGroupProps): JSX.Element;
+
+export declare namespace InputGroup {
+    var displayName: string;
+}
+
+export declare interface InputGroupProps {
+    /** Icon or element rendered at the start of the input */
+    prefix?: ReactNode;
+    /** Icon or element rendered at the end of the input */
+    suffix?: ReactNode;
+    children: ReactNode;
+    className?: string;
+}
+
+export declare function InputPassword({ className, disabled, ref, ...props }: InputPasswordProps & {
+    ref?: Ref<HTMLInputElement>;
+}): JSX.Element;
+
+export declare namespace InputPassword {
+    var displayName: string;
+}
+
+export declare interface InputPasswordProps extends Omit<InputProps, "type"> {
+}
+
+export declare interface InputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "size"> {
+    /** Visual size of the input */
+    size?: InputSize;
+    /** Visual variant */
+    variant?: InputVariant;
+    /** Marks the input as invalid. Can also be inherited from Field context */
+    invalid?: boolean;
+    /** Extra class names */
+    className?: string;
+}
+
+export declare function InputSearch({ onSearch, showSearchButton, className, onKeyDown, ref, ...props }: InputSearchProps & {
+    ref?: Ref<HTMLInputElement>;
+}): JSX.Element;
+
+export declare namespace InputSearch {
+    var displayName: string;
+}
+
+export declare interface InputSearchProps extends Omit<InputProps, "type"> {
+    /** Callback fired when the search is submitted (Enter key or button click) */
+    onSearch?: (value: string) => void;
+    /** Whether to show the search button */
+    showSearchButton?: boolean;
+}
+
+export declare type InputSize = "sm" | "md" | "lg";
+
+declare function InputTextarea({ size, variant, invalid: invalidProp, disabled: disabledProp, readOnly: readOnlyProp, showCount, maxLength, value, defaultValue, className, id: idProp, rows, ref, ...props }: InputTextareaProps & {
+    ref?: Ref<HTMLTextAreaElement>;
+}): JSX.Element;
+
+declare namespace InputTextarea {
+    var displayName: string;
+}
+export { InputTextarea }
+export { InputTextarea as Textarea }
+
+declare interface InputTextareaProps extends Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, "size"> {
+    /** Visual size */
+    size?: InputSize;
+    /** Visual variant */
+    variant?: InputVariant;
+    /** Marks the textarea as invalid */
+    invalid?: boolean;
+    /** Shows a character counter below the textarea */
+    showCount?: boolean;
+    /** Extra class names */
+    className?: string;
+}
+export { InputTextareaProps }
+export { InputTextareaProps as TextareaProps }
+
+export declare type InputVariant = "outline" | "filled" | "underline" | "unstyled";
+
+/** A keyboard-key cap: `<Kbd>⌘</Kbd> <Kbd>K</Kbd>`. Renders a semantic `<kbd>`. */
+export declare function Kbd({ size, className, children, ref, ...rest }: KbdProps & {
+    ref?: Ref<HTMLElement>;
+}): JSX.Element;
+
+export declare namespace Kbd {
+    var displayName: string;
+}
+
+export declare interface KbdProps extends ComponentPropsWithoutRef<"kbd">, VariantProps<typeof kbdVariants> {
+}
+
+export declare const kbdVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+/** An inline text link with accent-channel coloring and external-link handling. */
+export declare function Link<T extends ElementType = "a">({ as, variant, colorScheme, external, className, ref, children, ...rest }: LinkProps<T>): JSX.Element;
+
+export declare namespace Link {
+    var displayName: string;
+}
+
+export declare type LinkProps<T extends ElementType = "a"> = {
+    /** Render as a router link component (e.g. Next's `Link`). */
+    as?: T;
+    /** Hue (via the accent channel). @default "brand" */
+    colorScheme?: ColorScheme;
+    /** Opens in a new tab with `rel="noopener noreferrer"` and an ↗ marker. */
+    external?: boolean;
+    className?: string;
+    /** React 19: ref is a regular prop — no forwardRef, no polymorphic cast. */
+    ref?: Ref<HTMLElement>;
+    children: ReactNode;
+} & VariantProps<typeof linkVariants> & Omit<ComponentPropsWithoutRef<T>, "as" | "children" | "className" | "ref">;
+
+export declare const linkVariants: (props?: ({
+    variant?: "underline" | "plain" | "hover" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare const List: (<T extends ElementType = "ul">(props: ListProps<T> & {
+    ref?: Ref<any>;
+}) => ReactNode) & {
+    Item: <T extends ElementType = "li">(props: ListItemProps<T> & {
+        ref?: Ref<any>;
+    }) => ReactNode;
+};
+
+/** `styleType` and `spacing` each accept a scalar token or a responsive map. */
+declare type ListCustomProps = Responsive<VariantProps<typeof listVariants>>;
+
+/** A single `<li>`. With `icon`, it suppresses the native marker and renders the icon inline. */
+export declare const ListItem: ListItemComponent;
+
+declare type ListItemComponent = <T extends ElementType = "li">(props: ListItemProps<T> & {
+    ref?: Ref<any>;
+}) => ReactNode;
+
+declare interface ListItemCustomProps {
+    /** Optional leading icon; suppresses the native marker and aligns content beside it. */
+    icon?: ReactNode;
+}
+
+export declare type ListItemProps<T extends ElementType = "li"> = Omit<BoxProps<T>, keyof ListItemCustomProps> & ListItemCustomProps;
+
+export declare type ListProps<T extends ElementType = "ul"> = BoxProps<T> & ListCustomProps;
+
+declare const listVariants: (props?: ({
+    readonly styleType?: "none" | "circle" | "square" | "decimal" | "disc" | "lower-alpha" | "upper-roman" | null | undefined;
+    readonly spacing?: "0" | "1" | "2" | "3" | "4" | "5" | "6" | "8" | "1.5" | "2.5" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare const Marquee: typeof MarqueeRoot & {
+    Item: typeof MarqueeItem;
+};
+
+export declare type MarqueeDirection = "left" | "right" | "up" | "down";
+
+export declare function MarqueeItem({ className, style, children, ref, ...rest }: MarqueeItemProps & {
+    ref?: Ref<HTMLDivElement>;
+}): JSX.Element;
+
+export declare namespace MarqueeItem {
+    var displayName: string;
+}
+
+export declare interface MarqueeItemProps extends HTMLAttributes<HTMLDivElement> {
+    className?: string;
+    style?: CSSProperties;
+    children?: ReactNode;
+}
+
+export declare function MarqueeRoot({ direction, speed, gap, pauseOnHover, pauseOnFocus, reverse, gradient, gradientColor, gradientWidth, loopCount, className, style, children, ref, ...rest }: MarqueeRootProps & {
+    ref?: Ref<HTMLDivElement>;
+}): JSX.Element;
+
+export declare namespace MarqueeRoot {
+    var displayName: string;
+}
+
+export declare interface MarqueeRootProps extends HTMLAttributes<HTMLDivElement> {
+    /** Scroll direction */
+    direction?: MarqueeDirection;
+    /** Scroll speed in pixels per second */
+    speed?: number;
+    /** Gap between repeated items */
+    gap?: string;
+    /** Pause scrolling when the user hovers over the element */
+    pauseOnHover?: boolean;
+    /** Pause scrolling when the user focuses an element within */
+    pauseOnFocus?: boolean;
+    /** Reverse the scroll direction */
+    reverse?: boolean;
+    /** Show fade-out gradient at both edges */
+    gradient?: boolean;
+    /** The colour used for the gradient overlay (defaults to bg colour) */
+    gradientColor?: string;
+    /** Width of the gradient overlay (default: 10%) */
+    gradientWidth?: string;
+    /** Number of loops before stopping (0 = infinite) */
+    loopCount?: number;
+    className?: string;
+    style?: CSSProperties;
+    children?: ReactNode;
+}
+
+/**
+ * An action menu (dropdown) on the APG menu-button pattern: roving focus,
+ * typeahead, hover-follows-focus, Escape/outside dismissal via the shared
+ * overlay stack, and anchor positioning.
+ */
+export declare const Menu: typeof MenuRoot & {
+    Trigger: typeof MenuTrigger;
+    Content: typeof MenuContent;
+    Item: typeof MenuItem;
+    Label: typeof MenuLabel;
+    Separator: typeof MenuSeparator;
+    Group: typeof MenuGroup;
+};
+
+declare function MenuContent({ className, children, onKeyDown, ...rest }: MenuContentProps): JSX.Element | null;
+
+declare namespace MenuContent {
+    var displayName: string;
+}
+
+export declare interface MenuContentProps extends ComponentPropsWithoutRef<"div"> {
+    children: ReactNode;
+}
+
+declare function MenuGroup({ className, children, ...rest }: MenuSectionProps): JSX.Element;
+
+declare namespace MenuGroup {
+    var displayName: string;
+}
+
+declare function MenuItem({ onSelect, disabled, danger, icon, shortcut, closeOnSelect, className, children, ...rest }: MenuItemProps): JSX.Element;
+
+declare namespace MenuItem {
+    var displayName: string;
+}
+
+export declare interface MenuItemProps extends Omit<ComponentPropsWithoutRef<"div">, "onSelect"> {
+    /** Runs on activation (click / Enter / Space). */
+    onSelect?: () => void;
+    disabled?: boolean;
+    /** Destructive styling (delete, remove, …). */
+    danger?: boolean;
+    /** Leading glyph slot. */
+    icon?: ReactNode;
+    /** Trailing hint slot (e.g. a Kbd shortcut). */
+    shortcut?: ReactNode;
+    /** Override the menu-level closeOnSelect for this item. */
+    closeOnSelect?: boolean;
+    children: ReactNode;
+}
+
+declare function MenuLabel({ className, children, ...rest }: MenuSectionProps): JSX.Element;
+
+declare namespace MenuLabel {
+    var displayName: string;
+}
+
+export declare interface MenuProps {
+    children: ReactNode;
+    /** Controlled open state. */
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** Preferred side of the trigger. @default "bottom" */
+    side?: Side;
+    /** Alignment along the trigger. @default "start" */
+    align?: Align;
+    /** Gap between trigger and menu, px. @default 6 */
+    sideOffset?: number;
+    /** Close the menu after an item is selected. @default true */
+    closeOnSelect?: boolean;
+}
+
+declare function MenuRoot({ children, open: openProp, defaultOpen, onOpenChange, side, align, sideOffset, closeOnSelect, }: MenuProps): JSX.Element;
+
+export declare interface MenuSectionProps extends ComponentPropsWithoutRef<"div"> {
+    children?: ReactNode;
+}
+
+declare function MenuSeparator({ className, ...rest }: MenuSectionProps): JSX.Element;
+
+declare namespace MenuSeparator {
+    var displayName: string;
+}
+
+declare function MenuTrigger({ children }: MenuTriggerProps): ReactElement<Record<string, unknown>, string | JSXElementConstructor<any>>;
+
+declare namespace MenuTrigger {
+    var displayName: string;
+}
+
+export declare interface MenuTriggerProps {
+    /** A single focusable element (e.g. a Button); the menu wires it up via props. */
+    children: ReactElement<Record<string, unknown>>;
+}
+
+/** Compound API — `Modal` is the root; parts hang off it. */
+export declare const Modal: typeof ModalRoot & {
+    Trigger: typeof ModalTrigger;
+    Content: typeof ModalContent;
+    Header: typeof ModalHeader;
+    Body: typeof ModalBody;
+    Footer: typeof ModalFooter;
+    Title: typeof ModalTitle;
+    Description: typeof ModalDescription;
+    Close: typeof ModalClose;
+    CloseButton: typeof ModalCloseButton;
+};
+
+export declare function ModalBody({ children, className }: ModalSectionProps): JSX.Element;
+
+/** Wraps a single element and closes the modal on click. */
+export declare function ModalClose({ children }: ModalSlotProps): ReactElement<any, string | JSXElementConstructor<any>>;
+
+/** The corner ✕ button — place inside a Header. */
+export declare function ModalCloseButton({ className }: {
+    className?: string;
+}): JSX.Element;
+
+export declare function ModalContent({ children, className, ...rest }: ModalContentProps): JSX.Element | null;
+
+export declare interface ModalContentProps extends ComponentPropsWithoutRef<"div"> {
+    children: ReactNode;
+    className?: string;
+}
+
+export declare function ModalDescription({ children, className }: ModalSectionProps): JSX.Element;
+
+export declare function ModalFooter({ children, className }: ModalSectionProps): JSX.Element;
+
+export declare function ModalHeader({ children, className }: ModalSectionProps): JSX.Element;
+
+export declare interface ModalProps {
+    children: ReactNode;
+    /** Controlled open state. */
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    size?: ModalSize;
+    /** Vertically centre the panel (otherwise it sits toward the top). @default true */
+    centered?: boolean;
+    closeOnOverlayClick?: boolean;
+    closeOnEsc?: boolean;
+}
+
+declare function ModalRoot({ children, open: openProp, defaultOpen, onOpenChange, size, centered, closeOnOverlayClick, closeOnEsc, }: ModalProps): JSX.Element;
+
+export declare interface ModalSectionProps {
+    children: ReactNode;
+    className?: string;
+}
+
+export declare type ModalSize = "sm" | "md" | "lg" | "xl" | "full";
+
+/** Trigger/Close wrap a single element and augment it (asChild-style). */
+export declare interface ModalSlotProps {
+    children: ReactElement<any>;
+}
+
+export declare function ModalTitle({ children, className }: ModalSectionProps): JSX.Element;
+
+/** Wraps a single element and opens the modal on click (asChild-style). */
+export declare function ModalTrigger({ children }: ModalSlotProps): ReactElement<any, string | JSXElementConstructor<any>>;
+
+export declare const MultiSelect: ForwardRefExoticComponent<MultiSelectProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface MultiSelectOptionGroup {
+    group: string;
+    options: MultiSelectOptionItem[];
+}
+
+export declare interface MultiSelectOptionItem {
+    value: string | number;
+    label: ReactNode;
+    /** Label used for search filtering (plain string fallback when label is JSX) */
+    searchLabel?: string;
+    disabled?: boolean;
+}
+
+export declare type MultiSelectOptionOrGroup = MultiSelectOptionItem | MultiSelectOptionGroup;
+
+export declare interface MultiSelectProps {
+    options?: MultiSelectOptionOrGroup[];
+    /** Controlled array of selected values */
+    value?: Array<string | number>;
+    /** Default selected values for uncontrolled usage */
+    defaultValue?: Array<string | number>;
+    /** Fires whenever the selection changes */
+    onChange?: (values: Array<string | number>) => void;
+    placeholder?: string;
+    size?: MultiSelectSize;
+    variant?: MultiSelectVariant;
+    /** Hue for focus ring, selected tags, and highlighted options (via the accent channel). @default "brand" */
+    colorScheme?: ColorScheme;
+    disabled?: boolean;
+    invalid?: boolean;
+    /** Marks the multi-select as read-only */
+    readOnly?: boolean;
+    /** Show a button to clear all selections */
+    clearable?: boolean;
+    /** Maximum number of items that can be selected */
+    max?: number;
+    /** Text shown when no options match the search */
+    emptyText?: string;
+    /** Shows a loading state */
+    loading?: boolean;
+    /**
+     * Form field name. When set, one hidden input per selected value is
+     * rendered (repeated name, the standard multi-value convention) so the
+     * MultiSelect participates in native <form> submission.
+     */
+    name?: string;
+    className?: string;
+    id?: string;
+}
+
+export declare type MultiSelectSize = "sm" | "md" | "lg";
+
+export declare type MultiSelectVariant = "outline" | "filled";
+
+/**
+ * A numeric field with steppers and full spinbutton keyboard support.
+ * Typing is free-form; the value parses, clamps and rounds on commit
+ * (blur / Enter / steppers).
+ */
+export declare function NumberInput({ value: valueProp, defaultValue, onChange, min, max, step, precision, size, variant, invalid: invalidProp, disabled: disabledProp, readOnly: readOnlyProp, hideSteppers, className, id: idProp, onKeyDown, onBlur, ref, ...rest }: NumberInputProps & {
+    ref?: Ref<HTMLInputElement>;
+}): JSX.Element;
+
+export declare namespace NumberInput {
+    var displayName: string;
+}
+
+export declare interface NumberInputProps extends Omit<ComponentPropsWithoutRef<"input">, "size" | "value" | "defaultValue" | "onChange" | "min" | "max" | "step"> {
+    /** Controlled numeric value; `null` = empty. */
+    value?: number | null;
+    defaultValue?: number | null;
+    /** Fires with the parsed (and clamped) number, or `null` when cleared. */
+    onChange?: (value: number | null) => void;
+    min?: number;
+    max?: number;
+    /** Increment applied by the steppers and arrow keys. @default 1 */
+    step?: number;
+    /** Round committed values to this many decimal places. */
+    precision?: number;
+    size?: InputSize;
+    variant?: InputVariant;
+    invalid?: boolean;
+    /** Hide the increment/decrement buttons. */
+    hideSteppers?: boolean;
+}
+
+/** Compound API — `Pagination` is the root; parts hang off it. */
+export declare const Pagination: typeof PaginationRoot & {
+    List: typeof PaginationList;
+    Item: typeof PaginationItem;
+    Pages: typeof PaginationPages;
+    Ellipsis: typeof PaginationEllipsis;
+    Prev: typeof PaginationPrev;
+    Next: typeof PaginationNext;
+    First: typeof PaginationFirst;
+    Last: typeof PaginationLast;
+    PageText: typeof PaginationPageText;
+    Jumper: typeof PaginationJumper;
+};
+
+export declare interface PaginationControlProps {
+    /** Override the default chevron with any node. */
+    icon?: ReactNode;
+    className?: string;
+}
+
+export declare function PaginationEllipsis(): JSX.Element;
+
+export declare function PaginationFirst(props: PaginationControlProps): JSX.Element;
+
+export declare function PaginationItem({ page, children, className }: PaginationItemProps): JSX.Element;
+
+export declare interface PaginationItemProps {
+    page: number;
+    children: ReactNode;
+    className?: string;
+}
+
+/** A quick-jump input (Ant's showQuickJumper). Press Enter to jump. */
+export declare function PaginationJumper({ className, label }: PaginationJumperProps): JSX.Element;
+
+export declare interface PaginationJumperProps {
+    className?: string;
+    /** Label before the input. @default "Go to" */
+    label?: ReactNode;
+}
+
+export declare function PaginationLast(props: PaginationControlProps): JSX.Element;
+
+export declare function PaginationList({ children, className }: PaginationListProps): JSX.Element;
+
+export declare interface PaginationListProps {
+    children: ReactNode;
+    className?: string;
+}
+
+export declare function PaginationNext(props: PaginationControlProps): JSX.Element;
+
+/**
+ * Renders the page-number buttons with ellipses — `boundaryCount` pages pinned
+ * at each end and `siblings` pages on each side of the current page (the MUI model).
+ */
+export declare function PaginationPages({ siblings, boundaryCount }: PaginationPagesProps): JSX.Element;
+
+export declare interface PaginationPagesProps {
+    /** Pages shown on each side of the current page. @default 1 */
+    siblings?: number;
+    /** Pages pinned at the start and end. @default 1 */
+    boundaryCount?: number;
+}
+
+/** A live text readout of the current page (Chakra's PageText / Ant's showTotal). */
+export declare function PaginationPageText({ className, format }: PaginationPageTextProps): JSX.Element;
+
+export declare interface PaginationPageTextProps {
+    className?: string;
+    /** Custom text; receives the pagination state. Defaults to "Page X of Y". */
+    format?: (state: {
+        page: number;
+        totalPages: number;
+        count?: number;
+        pageSize?: number;
+    }) => ReactNode;
+}
+
+export declare function PaginationPrev(props: PaginationControlProps): JSX.Element;
+
+export declare interface PaginationProps {
+    /** Current page (controlled). */
+    page?: number;
+    /** Initial page when uncontrolled. @default 1 */
+    defaultPage?: number;
+    /** Total number of pages. Provide this OR `count` + `pageSize`. */
+    totalPages?: number;
+    /** Total item count — with `pageSize`, pages are derived as `ceil(count / pageSize)`. */
+    count?: number;
+    /** Items per page, used with `count`. @default 10 */
+    pageSize?: number;
+    onPageChange?: (page: number) => void;
+    /** Visual style of page items. @default "solid" */
+    variant?: PaginationVariant;
+    size?: PaginationSize;
+    rounded?: PaginationRounded;
+    /** Hue of the active page and focus rings. @default "brand" */
+    colorScheme?: ColorScheme;
+    disabled?: boolean;
+    className?: string;
+    children: ReactNode;
+}
+
+declare function PaginationRoot({ page: controlledPage, defaultPage, totalPages, count, pageSize, onPageChange, variant, size, rounded, colorScheme, disabled, className, children, }: PaginationProps): JSX.Element;
+
+export declare type PaginationRounded = "none" | "sm" | "md" | "lg" | "xl" | "2xl" | "full";
+
+export declare type PaginationSize = "xs" | "sm" | "md" | "lg";
+
+export declare type PaginationVariant = "solid" | "outline" | "subtle" | "plain";
+
+export declare function PinInput({ length, value, defaultValue, onChange, onComplete, type, mask, size, variant, disabled: disabledProp, invalid: invalidProp, readOnly: readOnlyProp, placeholder, autoFocus, className, id: idProp, }: PinInputProps): JSX.Element;
+
+export declare namespace PinInput {
+    var displayName: string;
+}
+
+export declare interface PinInputProps {
+    /** Number of individual boxes (default 4) */
+    length?: number;
+    /** Controlled value — the full combined string */
+    value?: string;
+    /** Default value for uncontrolled usage */
+    defaultValue?: string;
+    /** Fires whenever any box changes; receives the full combined string */
+    onChange?: (value: string) => void;
+    /** Fires when every box has been filled */
+    onComplete?: (value: string) => void;
+    /** Character type validation */
+    type?: PinInputType;
+    /** Masks characters like a password field */
+    mask?: boolean;
+    size?: PinInputSize;
+    variant?: PinInputVariant;
+    disabled?: boolean;
+    invalid?: boolean;
+    /** Marks the pin input as read-only */
+    readOnly?: boolean;
+    /** Placeholder character shown in empty boxes */
+    placeholder?: string;
+    /** Auto-focus the first box on mount */
+    autoFocus?: boolean;
+    className?: string;
+    id?: string;
+}
+
+export declare type PinInputSize = "sm" | "md" | "lg";
+
+export declare type PinInputType = "numeric" | "alphanumeric" | "alpha";
+
+export declare type PinInputVariant = "outline" | "filled";
+
+/** Compound API — `Popover` is the root; parts hang off it. */
+export declare const Popover: typeof PopoverRoot & {
+    Trigger: typeof PopoverTrigger;
+    Content: typeof PopoverContent;
+    Title: typeof PopoverTitle;
+    Description: typeof PopoverDescription;
+    Close: typeof PopoverClose;
+};
+
+export declare function PopoverClose({ children }: PopoverSlotProps): ReactElement<any, string | JSXElementConstructor<any>>;
+
+export declare function PopoverContent({ children, className, withArrow, ...rest }: PopoverContentProps): JSX.Element | null;
+
+export declare interface PopoverContentProps extends ComponentPropsWithoutRef<"div"> {
+    children: ReactNode;
+    className?: string;
+    /** Render the arrow pointing at the trigger. @default false */
+    withArrow?: boolean;
+}
+
+export declare function PopoverDescription({ children, className }: PopoverSectionProps): JSX.Element;
+
+export declare interface PopoverProps {
+    children: ReactNode;
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** Preferred side of the trigger. @default "bottom" */
+    side?: Side;
+    /** Alignment along that side. @default "center" */
+    align?: Align;
+    sideOffset?: number;
+    alignOffset?: number;
+    /** Flip/shift to stay in view. @default true */
+    avoidCollisions?: boolean;
+    closeOnEsc?: boolean;
+    closeOnOutsidePointer?: boolean;
+}
+
+declare function PopoverRoot({ children, open: openProp, defaultOpen, onOpenChange, side, align, sideOffset, alignOffset, avoidCollisions, closeOnEsc, closeOnOutsidePointer, }: PopoverProps): JSX.Element;
+
+export declare interface PopoverSectionProps {
+    children: ReactNode;
+    className?: string;
+}
+
+export declare interface PopoverSlotProps {
+    children: ReactElement<any>;
+}
+
+export declare function PopoverTitle({ children, className }: PopoverSectionProps): JSX.Element;
+
+export declare function PopoverTrigger({ children }: PopoverSlotProps): ReactElement<any, string | JSXElementConstructor<any>>;
+
+/** Renders children into `document.body` (after mount, so it's SSR-safe). */
+export declare function Portal({ children, container }: {
+    children: ReactNode;
+    container?: HTMLElement;
+}): ReactPortal | null;
+
+/**
+ * Determinate or indeterminate progress, as a linear bar or a circular ring.
+ * Omitting `value` switches to the indeterminate animation.
+ */
+export declare function Progress({ value, max, shape, size, colorScheme, showValueLabel, className, ref, ...rest }: ProgressProps & {
+    ref?: Ref<HTMLDivElement>;
+}): JSX.Element;
+
+export declare namespace Progress {
+    var displayName: string;
+}
+
+export declare interface ProgressProps extends ComponentPropsWithoutRef<"div"> {
+    /**
+     * Current progress. Omit it entirely for an indeterminate animation
+     * (unknown duration).
+     */
+    value?: number;
+    /** The value that counts as 100%. @default 100 */
+    max?: number;
+    /** Linear bar or circular ring. @default "line" */
+    shape?: ProgressShape;
+    size?: ProgressSize;
+    /** Hue of the filled portion (via the accent channel). @default "brand" */
+    colorScheme?: ColorScheme;
+    /** Render the percentage as text (beside the bar / inside the ring). */
+    showValueLabel?: boolean;
+}
+
+export declare type ProgressShape = "line" | "circle";
+
+export declare type ProgressSize = "sm" | "md" | "lg";
+
+export declare const QrCode: typeof QrCodeRoot;
+
+export declare type QrCodeErrorLevel = "L" | "M" | "Q" | "H";
+
+export declare function QrCodeRoot({ value, size, pixelSize, errorLevel, color, bgColor, overlay, overlaySize, status, onRefresh, downloadable, downloadFileName, className, style, }: QrCodeRootProps): JSX.Element;
+
+export declare namespace QrCodeRoot {
+    var displayName: string;
+}
+
+export declare interface QrCodeRootProps {
+    /** The string value to encode in the QR code */
+    value: string;
+    /** Preset size */
+    size?: QrCodeSize;
+    /** Explicit pixel size (overrides `size`) */
+    pixelSize?: number;
+    /** Error correction level */
+    errorLevel?: QrCodeErrorLevel;
+    /** Foreground / dot colour */
+    color?: string;
+    /** Background colour */
+    bgColor?: string;
+    /** A node to render as an overlay in the centre (e.g. a logo) */
+    overlay?: ReactNode;
+    /** Size of the overlay as a percentage of the QR code total size (default 20) */
+    overlaySize?: number;
+    /** Status overlay to display over the QR code */
+    status?: QrCodeStatus;
+    /** Called when the user clicks "Refresh" on an expired code */
+    onRefresh?: () => void;
+    /** Render a download button below the QR code */
+    downloadable?: boolean;
+    /** File name for the downloaded SVG (without extension) */
+    downloadFileName?: string;
+    className?: string;
+    style?: CSSProperties;
+}
+
+export declare type QrCodeSize = "sm" | "md" | "lg" | "xl";
+
+export declare type QrCodeStatus = "active" | "loading" | "expired" | "scanned";
+
+export declare const Radio: typeof RadioBase & {
+    Group: typeof RadioGroup;
+};
+
+export declare function RadioBase({ children, size, colorScheme, invalid: invalidProp, disabled: disabledProp, checked: checkedProp, defaultChecked, onChange: onChangeProp, readOnly: readOnlyProp, value, name: nameProp, className, ref, ...props }: RadioProps & {
+    ref?: Ref<HTMLInputElement>;
+}): JSX.Element;
+
+export declare namespace RadioBase {
+    var displayName: string;
+}
+
+export declare function RadioGroup({ value, defaultValue, onChange, name: nameProp, disabled, colorScheme, orientation, children, className, ...rest }: RadioGroupProps): JSX.Element;
+
+export declare namespace RadioGroup {
+    var displayName: string;
+}
+
+export declare interface RadioGroupContextValue {
+    groupValue: string;
+    selectValue: (val: string) => void;
+    name: string;
+    disabled?: boolean;
+    colorScheme?: ColorScheme;
+}
+
+export declare interface RadioGroupProps extends Omit<ComponentPropsWithoutRef<"div">, "onChange" | "defaultValue"> {
+    /** Controlled selected value */
+    value?: string;
+    /** Default value (uncontrolled) */
+    defaultValue?: string;
+    /** Callback when selection changes */
+    onChange?: (value: string) => void;
+    /** Name attribute applied to all radio inputs in the group */
+    name?: string;
+    /** Disables all radios in the group */
+    disabled?: boolean;
+    /** Hue applied to every radio in the group (each can still override). */
+    colorScheme?: ColorScheme;
+    /** Layout direction */
+    orientation?: "horizontal" | "vertical";
+    children: ReactNode;
+}
+
+export declare interface RadioProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "type"> {
+    /** Visual size */
+    size?: RadioSize;
+    /** Hue the selected radio paints with (via the accent channel). @default "brand" */
+    colorScheme?: ColorScheme;
+    /** Label content */
+    children?: ReactNode;
+    /** Invalid/error state */
+    invalid?: boolean;
+    /** Read-only state */
+    readOnly?: boolean;
+}
+
+export declare type RadioSize = "sm" | "md" | "lg";
+
+export declare function RangeSlider({ min, max, step, value: valueProp, defaultValue, onChange, size, colorScheme, showTooltip, marks, disabled: disabledProp, invalid: invalidProp, readOnly: readOnlyProp, className, ref, }: RangeSliderProps & {
+    ref?: Ref<HTMLDivElement>;
+}): JSX.Element;
+
+export declare namespace RangeSlider {
+    var displayName: string;
+}
+
+export declare interface RangeSliderProps {
+    min?: number;
+    max?: number;
+    step?: number;
+    /** Controlled value as [start, end] */
+    value?: [number, number];
+    defaultValue?: [number, number];
+    onChange?: (value: [number, number]) => void;
+    size?: SliderSize;
+    /** Hue for the filled track and thumbs (via the accent channel). @default "brand" */
+    colorScheme?: ColorScheme;
+    showTooltip?: boolean;
+    marks?: boolean | SliderMark[];
+    disabled?: boolean;
+    invalid?: boolean;
+    /** Marks the range slider as read-only */
+    readOnly?: boolean;
+    className?: string;
+}
+
+/** Wraps every key of a CVA variant-props object so each accepts responsive input. */
+declare type Responsive<T> = {
+    [K in keyof T]: ResponsiveProp<NonNullable<T[K]>>;
+};
+
+declare type ResponsiveKey = "base" | Breakpoint;
+
+/** A prop value: either a raw token, or a per-breakpoint map of tokens. */
+declare type ResponsiveProp<Value> = Value | Partial<Record<ResponsiveKey, Value>>;
+
+export declare const Select: ForwardRefExoticComponent<SelectProps & RefAttributes<HTMLButtonElement>>;
+
+export declare interface SelectOptionGroup {
+    group: string;
+    options: SelectOptionItem[];
+}
+
+export declare interface SelectOptionItem {
+    value: string | number;
+    label: ReactNode;
+    disabled?: boolean;
+}
+
+export declare type SelectOptionOrGroup = SelectOptionItem | SelectOptionGroup;
+
+export declare interface SelectProps {
+    /** List of options or option groups */
+    options?: SelectOptionOrGroup[];
+    /** Controlled selected value */
+    value?: string | number | null;
+    /** Uncontrolled default value */
+    defaultValue?: string | number | null;
+    /** Called when selection changes; receives `null` when cleared */
+    onChange?: (value: string | number | null) => void;
+    /** Called when selection is explicitly cleared */
+    onClear?: () => void;
+    placeholder?: string;
+    size?: SelectSize;
+    variant?: SelectVariant;
+    /** Hue for focus ring and selected-option highlight (via the accent channel). @default "brand" */
+    colorScheme?: ColorScheme;
+    disabled?: boolean;
+    invalid?: boolean;
+    /** Marks the select as read-only */
+    readOnly?: boolean;
+    /** Show a clear button when a value is selected */
+    clearable?: boolean;
+    /** Show search input inside the dropdown */
+    searchable?: boolean;
+    /** Shows a loading spinner instead of the chevron */
+    loading?: boolean;
+    /** Text shown when no options match */
+    emptyText?: string;
+    /**
+     * Form field name. When set, a hidden input carrying the selected value is
+     * rendered so the Select participates in native <form> submission.
+     */
+    name?: string;
+    className?: string;
+    id?: string;
+}
+
+export declare type SelectSize = "sm" | "md" | "lg";
+
+export declare type SelectVariant = "outline" | "filled";
+
+export declare const Separator: SeparatorComponent;
+
+declare type SeparatorComponent = <T extends ElementType = "div">(props: SeparatorProps<T> & {
+    ref?: Ref<any>;
+}) => ReactNode;
+
+/** `orientation` and `variant` each accept a scalar token or a responsive map. */
+declare type SeparatorCustomProps = Responsive<VariantProps<typeof separatorVariants>>;
+
+export declare type SeparatorProps<T extends ElementType = "div"> = BoxProps<T> & SeparatorCustomProps;
+
+declare const separatorVariants: (props?: ({
+    readonly orientation?: "horizontal" | "vertical" | null | undefined;
+    readonly variant?: "solid" | "dashed" | "dotted" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+declare type Side = "top" | "right" | "bottom" | "left";
+
+/**
+ * A pulsing placeholder that holds space while content loads. Hidden from
+ * assistive tech (`aria-hidden`) — pair the surrounding region with
+ * `aria-busy` or a Spinner if the loading state itself must be announced.
+ */
+export declare function Skeleton({ variant, animated, loaded, className, children, ref, ...rest }: SkeletonProps & {
+    ref?: Ref<HTMLDivElement>;
+}): JSX.Element;
+
+export declare namespace Skeleton {
+    var displayName: string;
+}
+
+export declare interface SkeletonProps extends ComponentPropsWithoutRef<"div"> {
+    /**
+     * Placeholder shape: `text` is a line the height of body text, `circle`
+     * suits avatars (size it square via className/style), `rect` is a generic
+     * rounded block.
+     * @default "text"
+     */
+    variant?: SkeletonVariant;
+    /** Disable the pulse (it also pauses automatically under prefers-reduced-motion). */
+    animated?: boolean;
+    /**
+     * Render children instead of the placeholder once loading is done —
+     * `<Skeleton loaded={!!data}>…</Skeleton>` keeps layout stable.
+     */
+    loaded?: boolean;
+}
+
+export declare type SkeletonVariant = "text" | "circle" | "rect";
+
+export declare function Slider({ min, max, step, value: valueProp, defaultValue, onChange, size, colorScheme, showTooltip, marks, disabled: disabledProp, invalid: invalidProp, readOnly: readOnlyProp, className, id: idProp, ref, }: SliderProps & {
+    ref?: Ref<HTMLDivElement>;
+}): JSX.Element;
+
+export declare namespace Slider {
+    var displayName: string;
+}
+
+export declare interface SliderMark {
+    value: number;
+    label?: string;
+}
+
+export declare interface SliderProps {
+    min?: number;
+    max?: number;
+    step?: number;
+    /** Controlled value */
+    value?: number;
+    defaultValue?: number;
+    onChange?: (value: number) => void;
+    size?: SliderSize;
+    /** Hue for the filled track and thumb (via the accent channel). @default "brand" */
+    colorScheme?: ColorScheme;
+    /** Show value tooltip on the thumb. Default true */
+    showTooltip?: boolean;
+    /** true = auto-marks at each step; array = custom marks */
+    marks?: boolean | SliderMark[];
+    disabled?: boolean;
+    invalid?: boolean;
+    /** Marks the slider as read-only */
+    readOnly?: boolean;
+    className?: string;
+    id?: string;
+}
+
+export declare type SliderSize = "sm" | "md" | "lg";
+
+/**
+ * An indeterminate loading indicator. Announces itself as a live status
+ * region with a visually-hidden label; the arc stays animated under
+ * prefers-reduced-motion because it conveys state, not decoration.
+ */
+export declare function Spinner({ size, colorScheme, label, className, ref, ...rest }: SpinnerProps & {
+    ref?: Ref<HTMLSpanElement>;
+}): JSX.Element;
+
+export declare namespace Spinner {
+    var displayName: string;
+}
+
+export declare interface SpinnerProps extends ComponentPropsWithoutRef<"span"> {
+    size?: SpinnerSize;
+    /** Hue of the spinning arc (via the accent channel). @default "brand" */
+    colorScheme?: ColorScheme;
+    /**
+     * Accessible loading text announced to screen readers (visually hidden).
+     * @default "Loading…"
+     */
+    label?: string;
+}
+
+export declare type SpinnerSize = "xs" | "sm" | "md" | "lg" | "xl";
+
+export declare const Stack: StackComponent;
+
+declare type StackComponent = <T extends ElementType = "div">(props: StackProps<T> & {
+    ref?: Ref<any>;
+}) => ReactNode;
+
+declare interface StackCustomProps {
+    direction?: "horizontal" | "vertical";
+}
+
+/** HStack/VStack are presets — `direction` is fixed, so it's omitted from their props. */
+declare type StackPresetComponent = <T extends ElementType = "div">(props: Omit<StackProps<T>, "direction"> & {
+    ref?: Ref<any>;
+}) => ReactNode;
+
+export declare type StackProps<T extends ElementType = "div"> = StackCustomProps & Omit<FlexProps<T>, "direction">;
+
+export declare const Stat: typeof StatRoot & {
+    Label: typeof StatLabel;
+    Value: typeof StatValue;
+    HelpText: typeof StatHelpText;
+    Indicator: typeof StatIndicator;
+};
+
+export declare function StatHelpText({ children, className }: StatHelpTextProps): JSX.Element;
+
+export declare interface StatHelpTextProps {
+    children: ReactNode;
+    className?: string;
+}
+
+export declare function StatIndicator({ type, children, className }: StatIndicatorProps): JSX.Element;
+
+export declare interface StatIndicatorProps {
+    type?: "increase" | "decrease";
+    children?: ReactNode;
+    className?: string;
+}
+
+export declare function StatLabel({ children, className }: StatLabelProps): JSX.Element;
+
+export declare interface StatLabelProps {
+    children: ReactNode;
+    className?: string;
+}
+
+export declare interface StatProps {
+    children: ReactNode;
+    className?: string;
+}
+
+declare function StatRoot({ children, className }: StatProps): JSX.Element;
+
+declare type StatusShorthand = (title: ToastOptions["title"], options?: Omit<ToastOptions, "title" | "status">) => string;
+
+export declare function StatValue({ children, className }: StatValueProps): JSX.Element;
+
+export declare interface StatValueProps {
+    children: ReactNode;
+    className?: string;
+}
+
+export declare const Steps: typeof StepsRoot & {
+    List: typeof StepsList;
+    Item: typeof StepsItem;
+    Indicator: typeof StepsIndicator;
+    Title: typeof StepsTitle;
+    Description: typeof StepsDescription;
+    Content: typeof StepsContent;
+    Completed: typeof StepsCompleted;
+    Prev: typeof StepsPrev;
+    Next: typeof StepsNext;
+};
+
+/** Steps.Completed — renders once every step is done (`step === count`). */
+export declare function StepsCompleted({ children, className, ...rest }: StepsCompletedProps): JSX.Element | null;
+
+export declare namespace StepsCompleted {
+    var displayName: string;
+}
+
+export declare interface StepsCompletedProps extends ComponentPropsWithoutRef<"div"> {
+    children: ReactNode;
+}
+
+/** Steps.Content — renders only when its `index` matches the active step. */
+export declare function StepsContent({ index, children, className, ...rest }: StepsContentProps): JSX.Element | null;
+
+export declare namespace StepsContent {
+    var displayName: string;
+}
+
+export declare interface StepsContentProps extends ComponentPropsWithoutRef<"div"> {
+    /** Show this content only when it is the active step. */
+    index: number;
+    children: ReactNode;
+}
+
+/** Steps.Description — secondary text beneath the title. Always muted. */
+export declare function StepsDescription({ children, className }: StepsDescriptionProps): JSX.Element;
+
+export declare namespace StepsDescription {
+    var displayName: string;
+}
+
+export declare interface StepsDescriptionProps {
+    children: ReactNode;
+    className?: string;
+}
+
+/**
+ * Steps.Indicator — the circle (solid/subtle) or dot. Defaults to the step number,
+ * a check when completed, or "!" on error; override by passing children.
+ */
+export declare function StepsIndicator({ children, className, ...rest }: StepsIndicatorProps): JSX.Element;
+
+export declare namespace StepsIndicator {
+    var displayName: string;
+}
+
+export declare interface StepsIndicatorProps extends ComponentPropsWithoutRef<"span"> {
+    /** Override the default content (number / check / "!"). */
+    children?: ReactNode;
+}
+
+/**
+ * Steps.Item — derives this step's status from the active step, exposes it via
+ * the item context, and lays out the indicator + label + connector for all three
+ * modes (horizontal inline, labelPlacement="bottom", vertical).
+ */
+export declare function StepsItem({ children, index, disabled: disabledProp, error, className, ...rest }: StepsItemProps): JSX.Element;
+
+export declare namespace StepsItem {
+    var displayName: string;
+}
+
+export declare interface StepsItemProps extends Omit<ComponentPropsWithoutRef<"li">, "title"> {
+    /** Injected by Steps.List — its position in the list. */
+    index?: number;
+    /** Prevent navigation to this step. */
+    disabled?: boolean;
+    /** Force the error status on this step. */
+    error?: boolean;
+    children: ReactNode;
+}
+
+/** Where the title/description sit relative to the indicator (horizontal only). */
+export declare type StepsLabelPlacement = "inline" | "bottom";
+
+/**
+ * Steps.List — the ordered list of steps. It counts its Item children (feeding
+ * `count` back to the context) and injects each item's `index`. Connectors are
+ * drawn by each Item itself, so the list stays a simple flex container.
+ */
+export declare function StepsList({ children, className, ...rest }: StepsListProps): JSX.Element;
+
+export declare namespace StepsList {
+    var displayName: string;
+}
+
+export declare interface StepsListProps extends ComponentPropsWithoutRef<"ol"> {
+    children: ReactNode;
+}
+
+export declare interface StepsNavProps extends ComponentPropsWithoutRef<"button"> {
+    children?: ReactNode;
+}
+
+/** Steps.Next — steps forward (up to `count`, which marks completion). */
+export declare function StepsNext({ children, className, disabled, onClick, ...rest }: StepsNavProps): JSX.Element;
+
+export declare namespace StepsNext {
+    var displayName: string;
+}
+
+export declare type StepsOrientation = "horizontal" | "vertical";
+
+/** Steps.Prev — steps backward. Auto-disabled at the first step. */
+export declare function StepsPrev({ children, className, disabled, onClick, ...rest }: StepsNavProps): JSX.Element;
+
+export declare namespace StepsPrev {
+    var displayName: string;
+}
+
+export declare interface StepsProps extends Omit<ComponentPropsWithoutRef<"div">, "onChange"> {
+    /** Controlled active step index (0-based). */
+    step?: number;
+    /** Uncontrolled initial step index. */
+    defaultStep?: number;
+    /** Fires with the next step index whenever navigation occurs. */
+    onStepChange?: (step: number) => void;
+    /** Total steps. Optional — Steps.List counts its children automatically. */
+    count?: number;
+    orientation?: StepsOrientation;
+    variant?: StepsVariant;
+    size?: StepsSize;
+    /** Restrict navigation to the next step only (no skipping ahead). */
+    linear?: boolean;
+    /** Horizontal only — `"bottom"` centers titles beneath the indicators (default `"inline"`). */
+    labelPlacement?: StepsLabelPlacement;
+    /** Make each indicator a button that jumps to its step. */
+    clickable?: boolean;
+    children: ReactNode;
+}
+
+/**
+ * Steps.Root — owns the step state machine and shares it via context so the
+ * sub-parts never prop-drill. Supports controlled (`step`) and uncontrolled
+ * (`defaultStep`) usage. The context value is memoized so static parts (titles,
+ * descriptions) don't re-render unless something they read actually changes.
+ */
+declare function StepsRoot({ step: stepProp, defaultStep, onStepChange, count: countProp, orientation, variant, size, linear, labelPlacement, clickable, className, children, ...rest }: StepsProps): JSX.Element;
+
+declare namespace StepsRoot {
+    var displayName: string;
+}
+
+export declare type StepsSize = "sm" | "md" | "lg";
+
+/** The resolved status of a single step. */
+export declare type StepStatus = "upcoming" | "active" | "completed" | "error";
+
+/** Steps.Title — the step's heading. Composes our Text primitive; colour tracks status. */
+export declare function StepsTitle({ children, className }: StepsTitleProps): JSX.Element;
+
+export declare namespace StepsTitle {
+    var displayName: string;
+}
+
+export declare interface StepsTitleProps {
+    children: ReactNode;
+    className?: string;
+}
+
+export declare type StepsVariant = "solid" | "subtle" | "dot";
+
+export declare function Switch({ size, children, colorScheme, invalid: invalidProp, disabled: disabledProp, checked: checkedProp, defaultChecked, onChange: onChangeProp, readOnly: readOnlyProp, className, id: idProp, ref, ...props }: SwitchProps & {
+    ref?: Ref<HTMLInputElement>;
+}): JSX.Element;
+
+export declare namespace Switch {
+    var displayName: string;
+}
+
+export declare interface SwitchProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "type"> {
+    /** Visual size of the toggle */
+    size?: SwitchSize;
+    /** Hue the "on" track paints with (via the accent channel). @default "brand" */
+    colorScheme?: ColorScheme;
+    /** Label rendered beside the switch */
+    children?: ReactNode;
+    /** Marks the switch as invalid */
+    invalid?: boolean;
+    /** Read-only state */
+    readOnly?: boolean;
+}
+
+export declare type SwitchSize = "sm" | "md" | "lg";
+
+/** Compound API — `Table` is the root; parts hang off it. */
+export declare const Table: typeof TableRoot & {
+    Header: typeof TableHeader;
+    Body: typeof TableBody;
+    Footer: typeof TableFooter;
+    Row: typeof TableRow;
+    Head: typeof TableHead;
+    Cell: typeof TableCell;
+    Caption: typeof TableCaption;
+};
+
+export declare function TableBody({ children, className, ...rest }: TableSectionProps): JSX.Element;
+
+export declare function TableCaption({ className, placement, ref, ...rest }: TableCaptionProps & {
+    ref?: Ref<HTMLTableCaptionElement>;
+}): JSX.Element;
+
+export declare namespace TableCaption {
+    var displayName: string;
+}
+
+export declare interface TableCaptionProps extends HTMLAttributes<HTMLTableCaptionElement> {
+    placement?: "top" | "bottom";
+    className?: string;
+}
+
+export declare function TableCell({ children, className, ...rest }: TableCellProps): JSX.Element;
+
+export declare interface TableCellProps extends TdHTMLAttributes<HTMLTableCellElement> {
+    children?: ReactNode;
+    className?: string;
+}
+
+export declare function TableFooter({ children, className, ...rest }: TableSectionProps): JSX.Element;
+
+export declare function TableHead({ children, className, scope, ...rest }: TableHeadProps): JSX.Element;
+
+export declare function TableHeader({ children, className, ...rest }: TableSectionProps): JSX.Element;
+
+export declare interface TableHeadProps extends ThHTMLAttributes<HTMLTableCellElement> {
+    children?: ReactNode;
+    className?: string;
+}
+
+export declare interface TableProps extends HTMLAttributes<HTMLTableElement> {
+    children: ReactNode;
+    variant?: TableVariant;
+    size?: TableSize;
+    /** Zebra-stripe the body rows. */
+    striped?: boolean;
+    /** Highlight rows on hover. */
+    interactive?: boolean;
+    /** Pin the header while the body scrolls. */
+    stickyHeader?: boolean;
+    className?: string;
+}
+
+declare function TableRoot({ children, variant, size, striped, interactive, stickyHeader, className, ...rest }: TableProps): JSX.Element;
+
+export declare function TableRow({ children, className, ...rest }: TableRowProps): JSX.Element;
+
+export declare interface TableRowProps extends HTMLAttributes<HTMLTableRowElement> {
+    children: ReactNode;
+    className?: string;
+}
+
+export declare interface TableSectionProps extends HTMLAttributes<HTMLTableSectionElement> {
+    children: ReactNode;
+    className?: string;
+}
+
+export declare type TableSize = "sm" | "md" | "lg";
+
+export declare type TableVariant = "line" | "outline";
+
+export declare const Tabs: typeof TabsRoot & {
+    List: typeof TabsList;
+    Trigger: typeof TabsTrigger;
+    Content: typeof TabsContent;
+};
+
+/** automatic = arrow keys select on focus; manual = arrow moves focus, Enter/Space selects. */
+export declare type TabsActivationMode = "automatic" | "manual";
+
+/**
+ * Tabs.Content — the panel for one tab. Unmounted when inactive, unless the Root
+ * sets `keepMounted` (then it stays mounted but `hidden`, preserving its state).
+ */
+export declare function TabsContent({ value, className, children, ...rest }: TabsContentProps): JSX.Element | null;
+
+export declare namespace TabsContent {
+    var displayName: string;
+}
+
+export declare interface TabsContentProps extends ComponentPropsWithoutRef<"div"> {
+    /** Matches the trigger's `value`. */
+    value: string;
+    children: ReactNode;
+}
+
+/**
+ * Tabs.List — the tablist. For the `line` variant it renders a single indicator
+ * that slides to the active trigger (measured from the DOM, recomputed on value
+ * change and on resize), giving the animated ink-bar effect.
+ */
+export declare function TabsList({ children, className, ...rest }: TabsListProps): JSX.Element;
+
+export declare namespace TabsList {
+    var displayName: string;
+}
+
+export declare interface TabsListProps extends ComponentPropsWithoutRef<"div"> {
+    children: ReactNode;
+}
+
+export declare type TabsOrientation = "horizontal" | "vertical";
+
+export declare interface TabsProps extends Omit<ComponentPropsWithoutRef<"div">, "onChange"> {
+    /** Controlled active value. */
+    value?: string;
+    /** Uncontrolled initial value. */
+    defaultValue?: string;
+    onValueChange?: (value: string) => void;
+    orientation?: TabsOrientation;
+    variant?: TabsVariant;
+    /** Hue for the active tab, indicator and focus rings (via the accent channel). @default "brand" */
+    colorScheme?: ColorScheme;
+    size?: TabsSize;
+    /** Stretch triggers to fill the list width. */
+    fitted?: boolean;
+    /** Apply pill/rounded radii to applicable variants (subtle/segmented/outline). */
+    rounded?: boolean;
+    /** `"automatic"` (default) selects on focus; `"manual"` selects on Enter/Space. */
+    activationMode?: TabsActivationMode;
+    /** Keep inactive panels mounted (hidden) rather than unmounting them. */
+    keepMounted?: boolean;
+    /** Wrap focus around the ends during arrow-key navigation (default true). */
+    loop?: boolean;
+    children: ReactNode;
+}
+
+/**
+ * Tabs.Root — owns the active-value state (controlled or uncontrolled) and shares
+ * it + config via a memoized context. Renders a flex container that stacks the
+ * list and panels (column for horizontal tabs, row for vertical).
+ */
+declare function TabsRoot({ value: valueProp, defaultValue, onValueChange, orientation, variant, colorScheme, size, fitted, rounded, activationMode, keepMounted, loop, className, children, ...rest }: TabsProps): JSX.Element;
+
+declare namespace TabsRoot {
+    var displayName: string;
+}
+
+export declare type TabsSize = "sm" | "md" | "lg";
+
+/**
+ * Tabs.Trigger — a single tab button. Implements the ARIA tabs keyboard pattern:
+ * roving tabindex (only the selected tab is in the tab order), arrow keys move
+ * focus along the orientation, Home/End jump to ends, and `activationMode`
+ * decides whether arrowing also selects (automatic) or just moves focus (manual).
+ */
+export declare function TabsTrigger({ value, disabled, className, children, onClick, onKeyDown, ...rest }: TabsTriggerProps): JSX.Element;
+
+export declare namespace TabsTrigger {
+    var displayName: string;
+}
+
+export declare interface TabsTriggerProps extends Omit<ComponentPropsWithoutRef<"button">, "value"> {
+    /** Unique value linking this trigger to its Content. */
+    value: string;
+    disabled?: boolean;
+    children: ReactNode;
+}
+
+export declare type TabsVariant = "line" | "subtle" | "segmented" | "outline" | "plain";
+
+export declare const Tag: typeof TagRoot & {
+    Checkable: typeof CheckableTag;
+    Group: typeof CheckableTagGroup;
+};
+
+export declare type TagColorScheme = ColorScheme;
+
+export declare interface TagOption {
+    label: ReactNode;
+    value: string | number;
+}
+
+export declare interface TagProps extends Omit<HTMLAttributes<HTMLSpanElement>, "color"> {
+    children?: ReactNode;
+    size?: TagSize;
+    variant?: TagVariant;
+    /** Hue the tag paints with. @default "gray" */
+    colorScheme?: TagColorScheme;
+    /** Element before the label (icon, avatar…). */
+    startElement?: ReactNode;
+    /** Element after the label (icon…). */
+    endElement?: ReactNode;
+    /** Show a remove button that calls `onClose`. */
+    closable?: boolean;
+    onClose?: () => void;
+    className?: string;
+    style?: CSSProperties;
+}
+
+export declare function TagRoot({ children, size, variant, colorScheme, startElement, endElement, closable, onClose, className, style, ref, ...rest }: TagProps & {
+    ref?: Ref<HTMLSpanElement>;
+}): JSX.Element;
+
+export declare namespace TagRoot {
+    var displayName: string;
+}
+
+export declare type TagSize = "xs" | "sm" | "md" | "lg";
+
+export declare type TagVariant = "solid" | "subtle" | "surface" | "outline";
+
+declare const Text_2: TextComponent;
+export { Text_2 as Text }
+
+declare type TextBaseProps<C extends ElementType = "p"> = TextCustomProps<C> & Responsive<Omit<VariantProps<typeof textVariants>, "lineClamp">>;
+
+declare const textColors: {
+    base: string;
+    muted: string;
+    subtle: string;
+    inverted: string;
+    warning: string;
+    error: string;
+    success: string;
+    info: string;
+    transparent: string;
+    current: string;
+    inherit: string;
+    black: string;
+    white: string;
+    "gray-50": string;
+    "gray-100": string;
+    "gray-200": string;
+    "gray-300": string;
+    "gray-400": string;
+    "gray-500": string;
+    "gray-600": string;
+    "gray-700": string;
+    "gray-800": string;
+    "gray-900": string;
+    "gray-950": string;
+    "red-50": string;
+    "red-100": string;
+    "red-200": string;
+    "red-300": string;
+    "red-400": string;
+    "red-500": string;
+    "red-600": string;
+    "red-700": string;
+    "red-800": string;
+    "red-900": string;
+    "red-950": string;
+    "orange-50": string;
+    "orange-100": string;
+    "orange-200": string;
+    "orange-300": string;
+    "orange-400": string;
+    "orange-500": string;
+    "orange-600": string;
+    "orange-700": string;
+    "orange-800": string;
+    "orange-900": string;
+    "orange-950": string;
+    "yellow-50": string;
+    "yellow-100": string;
+    "yellow-200": string;
+    "yellow-300": string;
+    "yellow-400": string;
+    "yellow-500": string;
+    "yellow-600": string;
+    "yellow-700": string;
+    "yellow-800": string;
+    "yellow-900": string;
+    "yellow-950": string;
+    "green-50": string;
+    "green-100": string;
+    "green-200": string;
+    "green-300": string;
+    "green-400": string;
+    "green-500": string;
+    "green-600": string;
+    "green-700": string;
+    "green-800": string;
+    "green-900": string;
+    "green-950": string;
+    "teal-50": string;
+    "teal-100": string;
+    "teal-200": string;
+    "teal-300": string;
+    "teal-400": string;
+    "teal-500": string;
+    "teal-600": string;
+    "teal-700": string;
+    "teal-800": string;
+    "teal-900": string;
+    "teal-950": string;
+    "blue-50": string;
+    "blue-100": string;
+    "blue-200": string;
+    "blue-300": string;
+    "blue-400": string;
+    "blue-500": string;
+    "blue-600": string;
+    "blue-700": string;
+    "blue-800": string;
+    "blue-900": string;
+    "blue-950": string;
+    "cyan-50": string;
+    "cyan-100": string;
+    "cyan-200": string;
+    "cyan-300": string;
+    "cyan-400": string;
+    "cyan-500": string;
+    "cyan-600": string;
+    "cyan-700": string;
+    "cyan-800": string;
+    "cyan-900": string;
+    "cyan-950": string;
+    "purple-50": string;
+    "purple-100": string;
+    "purple-200": string;
+    "purple-300": string;
+    "purple-400": string;
+    "purple-500": string;
+    "purple-600": string;
+    "purple-700": string;
+    "purple-800": string;
+    "purple-900": string;
+    "purple-950": string;
+    "pink-50": string;
+    "pink-100": string;
+    "pink-200": string;
+    "pink-300": string;
+    "pink-400": string;
+    "pink-500": string;
+    "pink-600": string;
+    "pink-700": string;
+    "pink-800": string;
+    "pink-900": string;
+    "pink-950": string;
+    "brand-50": string;
+    "brand-100": string;
+    "brand-200": string;
+    "brand-300": string;
+    "brand-400": string;
+    "brand-500": string;
+    "brand-600": string;
+    "brand-700": string;
+    "brand-800": string;
+    "brand-900": string;
+    "gray-solid": string;
+    "gray-contrast": string;
+    "gray-label": string;
+    "red-solid": string;
+    "red-contrast": string;
+    "red-label": string;
+    "orange-solid": string;
+    "orange-contrast": string;
+    "orange-label": string;
+    "yellow-solid": string;
+    "yellow-contrast": string;
+    "yellow-label": string;
+    "green-solid": string;
+    "green-contrast": string;
+    "green-label": string;
+    "teal-solid": string;
+    "teal-contrast": string;
+    "teal-label": string;
+    "blue-solid": string;
+    "blue-contrast": string;
+    "blue-label": string;
+    "cyan-solid": string;
+    "cyan-contrast": string;
+    "cyan-label": string;
+    "purple-solid": string;
+    "purple-contrast": string;
+    "purple-label": string;
+    "pink-solid": string;
+    "pink-contrast": string;
+    "pink-label": string;
+    "brand-solid": string;
+    "brand-contrast": string;
+    "brand-label": string;
+};
+
+declare type TextComponent = <C extends ElementType = "p">(props: TextProps<C> & {
+    ref?: Ref<any>;
+}) => ReactNode;
+
+declare interface TextCustomProps<C extends ElementType = "p"> {
+    children?: ReactNode;
+    as?: C;
+    className?: string;
+    lineClamp?: ResponsiveProp<TextLineClamp>;
+}
+
+export declare type TextLineClamp = "1" | "2" | "3" | "4" | "5" | "6";
+
+export declare type TextProps<C extends ElementType = "p"> = TextBaseProps<C> & Omit<ComponentPropsWithoutRef<C>, keyof TextBaseProps<C>>;
+
+export declare type TextSize = NonNullable<VariantProps<typeof textVariants>["size"]>;
+
+declare const textVariants: (props?: ({
+    readonly size?: "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "3xl" | "4xl" | "5xl" | "6xl" | "7xl" | "8xl" | "9xl" | null | undefined;
+    readonly weight?: "bold" | "normal" | "light" | "black" | "medium" | "thin" | "extralight" | "semibold" | "extrabold" | null | undefined;
+    readonly align?: "center" | "left" | "right" | "justify" | null | undefined;
+    readonly color?: "subtle" | "base" | "inherit" | "current" | "error" | "muted" | "black" | "white" | "transparent" | "inverted" | "warning" | "success" | "info" | "gray-50" | "gray-100" | "gray-200" | "gray-300" | "gray-400" | "gray-500" | "gray-600" | "gray-700" | "gray-800" | "gray-900" | "gray-950" | "red-50" | "red-100" | "red-200" | "red-300" | "red-400" | "red-500" | "red-600" | "red-700" | "red-800" | "red-900" | "red-950" | "orange-50" | "orange-100" | "orange-200" | "orange-300" | "orange-400" | "orange-500" | "orange-600" | "orange-700" | "orange-800" | "orange-900" | "orange-950" | "yellow-50" | "yellow-100" | "yellow-200" | "yellow-300" | "yellow-400" | "yellow-500" | "yellow-600" | "yellow-700" | "yellow-800" | "yellow-900" | "yellow-950" | "green-50" | "green-100" | "green-200" | "green-300" | "green-400" | "green-500" | "green-600" | "green-700" | "green-800" | "green-900" | "green-950" | "teal-50" | "teal-100" | "teal-200" | "teal-300" | "teal-400" | "teal-500" | "teal-600" | "teal-700" | "teal-800" | "teal-900" | "teal-950" | "blue-50" | "blue-100" | "blue-200" | "blue-300" | "blue-400" | "blue-500" | "blue-600" | "blue-700" | "blue-800" | "blue-900" | "blue-950" | "cyan-50" | "cyan-100" | "cyan-200" | "cyan-300" | "cyan-400" | "cyan-500" | "cyan-600" | "cyan-700" | "cyan-800" | "cyan-900" | "cyan-950" | "purple-50" | "purple-100" | "purple-200" | "purple-300" | "purple-400" | "purple-500" | "purple-600" | "purple-700" | "purple-800" | "purple-900" | "purple-950" | "pink-50" | "pink-100" | "pink-200" | "pink-300" | "pink-400" | "pink-500" | "pink-600" | "pink-700" | "pink-800" | "pink-900" | "pink-950" | "brand-50" | "brand-100" | "brand-200" | "brand-300" | "brand-400" | "brand-500" | "brand-600" | "brand-700" | "brand-800" | "brand-900" | "gray-solid" | "gray-contrast" | "gray-label" | "red-solid" | "red-contrast" | "red-label" | "orange-solid" | "orange-contrast" | "orange-label" | "yellow-solid" | "yellow-contrast" | "yellow-label" | "green-solid" | "green-contrast" | "green-label" | "teal-solid" | "teal-contrast" | "teal-label" | "blue-solid" | "blue-contrast" | "blue-label" | "cyan-solid" | "cyan-contrast" | "cyan-label" | "purple-solid" | "purple-contrast" | "purple-label" | "pink-solid" | "pink-contrast" | "pink-label" | "brand-solid" | "brand-contrast" | "brand-label" | null | undefined;
+    readonly casing?: "normal" | "capitalize" | "lowercase" | "uppercase" | null | undefined;
+    readonly fontFamily?: "body" | "heading" | "serif" | "sans" | "mono" | null | undefined;
+    readonly fontStyle?: "normal" | "italic" | null | undefined;
+    readonly textDecoration?: "none" | "line-through" | "overline" | "underline" | null | undefined;
+    readonly lineHeight?: "none" | "normal" | "loose" | "tight" | "snug" | "relaxed" | null | undefined;
+    readonly letterSpacing?: "normal" | "tight" | "tighter" | "wide" | "wider" | "widest" | null | undefined;
+    readonly lineClamp?: "1" | "2" | "3" | "4" | "5" | "6" | null | undefined;
+    readonly gutterBottom?: boolean | null | undefined;
+    readonly paragraph?: boolean | null | undefined;
+    readonly truncate?: boolean | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare type TextWeight = NonNullable<VariantProps<typeof textVariants>["weight"]>;
+
+export declare type Theme = "light" | "dark" | "system";
+
+declare interface ThemeProviderProps {
+    children: ReactNode;
+    defaultTheme?: Theme;
+    storageKey?: string;
+    className?: string;
+    tokens?: ThemeTokens;
+}
+
+declare interface ThemeProviderState {
+    theme: Theme;
+    setTheme: (theme: Theme) => void;
+    resolvedTheme: "light" | "dark";
+    tokens?: ThemeTokens;
+}
+
+/**
+ * ThemeToggle — a ready-made light/dark switch built on Button, so it inherits
+ * every variant, size, and `colorScheme`. The sun and moon are stacked and
+ * cross-fade with a quarter-turn rotation as the resolved theme changes.
+ */
+export declare function ThemeToggle({ variant, size, showLabel, className, ref, ...props }: ThemeToggleProps & {
+    ref?: Ref<HTMLButtonElement>;
+}): JSX.Element;
+
+export declare namespace ThemeToggle {
+    var displayName: string;
+}
+
+export declare interface ThemeToggleProps extends Omit<ButtonProps, "children" | "onClick"> {
+    /**
+     * If true, displays the text label next to the icon (e.g., "Light Mode" or "Dark Mode").
+     * @default false
+     */
+    showLabel?: boolean;
+}
+
+declare type ThemeTokens = {
+    brandColor?: string;
+};
+
+/** Compound API — `Timeline` is the root; parts hang off it. */
+export declare const Timeline: typeof TimelineRoot & {
+    Item: typeof TimelineItem;
+    Indicator: typeof TimelineIndicator;
+    Content: typeof TimelineContent;
+    Title: typeof TimelineTitle;
+    Description: typeof TimelineDescription;
+};
+
+export declare function TimelineContent({ children, className }: TimelineContentProps): JSX.Element;
+
+export declare namespace TimelineContent {
+    var displayName: string;
+}
+
+export declare interface TimelineContentProps {
+    children: ReactNode;
+    className?: string;
+}
+
+export declare function TimelineDescription({ children, className }: TimelineTextProps): JSX.Element;
+
+export declare namespace TimelineDescription {
+    var displayName: string;
+}
+
+export declare function TimelineIndicator({ children, colorScheme, className }: TimelineIndicatorProps): JSX.Element;
+
+export declare namespace TimelineIndicator {
+    var displayName: string;
+}
+
+export declare interface TimelineIndicatorProps {
+    children?: ReactNode;
+    /** Override the item's hue (e.g. green for done, red for error). */
+    colorScheme?: ColorScheme;
+    className?: string;
+}
+
+/**
+ * Lays out one entry: an indicator column with the connecting line drawn beneath
+ * it (hidden on the last item), and the content beside it. Splits its children
+ * into the Indicator and everything else by displayName.
+ */
+export declare function TimelineItem({ children, className }: TimelineItemProps): JSX.Element;
+
+export declare interface TimelineItemProps {
+    children: ReactNode;
+    className?: string;
+}
+
+export declare interface TimelineProps {
+    children: ReactNode;
+    size?: TimelineSize;
+    variant?: TimelineVariant;
+    /** Default hue for indicators. @default "brand" */
+    colorScheme?: ColorScheme;
+    className?: string;
+}
+
+declare function TimelineRoot({ children, size, variant, colorScheme, className }: TimelineProps): JSX.Element;
+
+export declare type TimelineSize = "sm" | "md" | "lg";
+
+export declare interface TimelineTextProps {
+    children: ReactNode;
+    className?: string;
+}
+
+export declare function TimelineTitle({ children, className }: TimelineTextProps): JSX.Element;
+
+export declare namespace TimelineTitle {
+    var displayName: string;
+}
+
+export declare type TimelineVariant = "solid" | "subtle" | "outline";
+
+/**
+ * Fire a toast imperatively: `toast({ title })`, or via the status
+ * shorthands `toast.success("Saved")`. Requires a `<Toaster />` mounted
+ * once near the app root. Returns the toast id; `toast.dismiss(id)` closes
+ * one, `toast.dismiss()` closes all.
+ */
+export declare const toast: ((options: ToastOptions) => string) & {
+    info: StatusShorthand;
+    success: StatusShorthand;
+    warning: StatusShorthand;
+    error: StatusShorthand;
+    dismiss: typeof dismissToast;
+};
+
+export declare interface ToastData extends ToastOptions {
+    id: string;
+    /** false while the exit transition plays, then the toast is removed. */
+    open: boolean;
+}
+
+/**
+ * The toast outlet — mount ONE near the app root (inside AstralisProvider),
+ * then fire notifications from anywhere with `toast(...)`.
+ */
+export declare function Toaster({ placement, max }: ToasterProps): JSX.Element;
+
+export declare type ToasterPlacement = "top-start" | "top-center" | "top-end" | "bottom-start" | "bottom-center" | "bottom-end";
+
+export declare interface ToasterProps {
+    /** Screen corner/edge the stack grows from. @default "bottom-end" */
+    placement?: ToasterPlacement;
+    /** Newest-first cap on simultaneously shown toasts. @default 5 */
+    max?: number;
+}
+
+export declare interface ToastOptions {
+    title: ReactNode;
+    description?: ReactNode;
+    /** Picks the icon, hue and ARIA role. @default "info" */
+    status?: ToastStatus;
+    /** Hue override (via the accent channel); defaults from `status`. */
+    colorScheme?: ColorScheme;
+    /**
+     * Auto-dismiss delay in ms; pass `null` to keep the toast until dismissed.
+     * @default 5000
+     */
+    duration?: number | null;
+    /** Hide the ✕ button. */
+    closable?: boolean;
+    /** Optional action button rendered after the text. */
+    action?: {
+        label: string;
+        onClick: () => void;
+    };
+}
+
+export declare type ToastStatus = FeedbackStatus;
+
+/** Compound API — `Tooltip` is the root; parts hang off it. */
+export declare const Tooltip: typeof TooltipRoot & {
+    Trigger: typeof TooltipTrigger;
+    Content: typeof TooltipContent;
+};
+
+export declare function TooltipContent({ children, className, withArrow }: TooltipContentProps): JSX.Element | null;
+
+export declare interface TooltipContentProps {
+    children: ReactNode;
+    className?: string;
+    /** Render an arrow pointing at the trigger. @default false */
+    withArrow?: boolean;
+}
+
+export declare interface TooltipProps {
+    children: ReactNode;
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** Preferred side of the trigger. @default "top" */
+    side?: Side;
+    align?: Align;
+    sideOffset?: number;
+    /** Delay before showing on hover, ms. @default 300 */
+    delay?: number;
+    avoidCollisions?: boolean;
+}
+
+declare function TooltipRoot({ children, open: openProp, defaultOpen, onOpenChange, side, align, sideOffset, delay, avoidCollisions, }: TooltipProps): JSX.Element;
+
+export declare function TooltipTrigger({ children }: TooltipTriggerProps): ReactElement<any, string | JSXElementConstructor<any>>;
+
+export declare interface TooltipTriggerProps {
+    children: ReactElement<any>;
+}
+
+/**
+ * Returns Field context. Returns null instead of throwing
+ * so inputs can be used standalone (outside a Field).
+ */
+export declare function useFieldContext(): FieldContextValue | null;
+
+export declare const useTheme: () => ThemeProviderState;
+
+export declare const VStack: StackPresetComponent;
+
+export { }