@olundot/ui 0.20.0-next.3 → 0.20.0-next.5

package/dist/index.d.ts

@@ -3,9 +3,9 @@ import * as class_variance_authority_types from 'class-variance-authority/types'
 import * as React from 'react';
 import { HTMLAttributes, ReactNode, SVGProps } from 'react';
 import { VariantProps } from 'class-variance-authority';
-import { LucideIcon } from 'lucide-react';
 import { Select as Select$1, Label as Label$1, Switch as Switch$1, Tabs as Tabs$1, Dialog as Dialog$1, DropdownMenu as DropdownMenu$1, Separator as Separator$1, Avatar as Avatar$1, Tooltip as Tooltip$1, Popover as Popover$1, Checkbox as Checkbox$1, RadioGroup as RadioGroup$1, ScrollArea as ScrollArea$1 } from 'radix-ui';
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import { LucideIcon } from 'lucide-react';
 
 declare function cn(...inputs: ClassValue[]): string;
 
@@ -31,80 +31,74 @@ declare function useOlunTheme(): UseOlunThemeValue;
 
 type SurfaceLevel = "surface" | "canvas" | "raised";
 
-type ActionAppearance = 'filled' | 'outline' | 'ghost';
 type ActionTone = 'primary' | 'neutral' | 'danger';
 type FilledDefaultActionStyle = {
     appearance?: 'filled';
     tone?: ActionTone;
 } | {
-    appearance: 'outline' | 'ghost';
+    appearance: 'outline';
+    tone?: 'neutral' | 'danger';
+} | {
+    appearance: 'ghost';
     tone?: 'neutral';
 };
-type GhostDefaultActionStyle = {
+type OutlineDefaultActionStyle = {
     appearance: 'filled';
     tone?: ActionTone;
 } | {
-    appearance: 'outline' | 'ghost';
+    appearance?: 'outline';
+    tone?: 'neutral' | 'danger';
+} | {
+    appearance: 'ghost';
     tone?: 'neutral';
+};
+type GhostDefaultActionStyle = {
+    appearance: 'filled';
+    tone?: ActionTone;
 } | {
-    appearance?: never;
-    tone: 'neutral';
+    appearance: 'outline';
+    tone?: 'neutral' | 'danger';
+} | {
+    appearance?: 'ghost';
+    tone?: 'neutral';
 };
 
 declare const buttonCva: (props?: ({
-    size?: "default" | "md" | "xs" | "sm" | "lg" | "xl" | "icon" | "icon-xs" | null | undefined;
-    appearance?: "filled" | "outline" | "ghost" | null | undefined;
+    appearance?: "filled" | "outline" | "ghost" | "link" | null | undefined;
     tone?: "primary" | "neutral" | "danger" | null | undefined;
-    variant?: "default" | "outline" | "ghost" | "primary" | "danger" | "emergency" | "subtle" | "destructive" | "secondary" | "link" | null | undefined;
+    size?: "default" | "md" | "xs" | "sm" | "lg" | "xl" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type ButtonVariantsOptions = Parameters<typeof buttonCva>[0];
 declare function buttonVariants(options?: ButtonVariantsOptions): string;
-type ButtonVariant = NonNullable<VariantProps<typeof buttonVariants>['variant']>;
 type ButtonSize = NonNullable<VariantProps<typeof buttonVariants>['size']>;
-type ButtonStyleProps = (FilledDefaultActionStyle & {
-    /**
-     * @deprecated Use `appearance` × `tone` instead. Removed in 0.20.
-     */
-    variant?: never;
-}) | {
-    /**
-     * @deprecated Use `appearance` × `tone`: `primary`/`default` → filled + primary ·
-     * `secondary`/`outline`/`subtle` → outline + neutral · `ghost` → ghost + neutral ·
-     * `danger`/`destructive`/`emergency` → filled + danger · `link` → no Button replacement
-     * (a link component is planned). Removed in 0.20.
-     */
-    variant?: ButtonVariant | null;
+type ButtonStyleProps = FilledDefaultActionStyle | {
+    appearance: 'link';
+    tone?: 'primary' | 'danger';
 };
 type ButtonProps = React.ButtonHTMLAttributes<HTMLButtonElement> & ButtonStyleProps & {
-    /** `icon`·`icon-xs` are deprecated — use IconButton (`lg`·`md`). */
     size?: ButtonSize | null;
+    /**
+     * Renders the single child element (e.g. Next `Link`) instead of a `<button>`. Ref, `href` and
+     * anchor-typed events belong on that child; Button's own ref and handlers stay typed for
+     * `HTMLButtonElement`. Disabled or loading, the child stays in place with its `href` but takes
+     * `aria-disabled`, leaves the tab order and swallows clicks.
+     */
     asChild?: boolean;
-    /** @deprecated Use IconButton with `label` (or children). Removed in 0.20. */
-    leadingIcon?: LucideIcon;
-    /** @deprecated Use IconButton with `label` and `iconPosition="end"`. Removed in 0.20. */
-    trailingIcon?: LucideIcon;
     loading?: boolean;
+    /** Trailing ▾ for a menu trigger. The trigger (DropdownMenu etc.) supplies `aria-haspopup`. */
+    menuIndicator?: boolean;
 };
 declare const Button: React.ForwardRefExoticComponent<ButtonProps & React.RefAttributes<HTMLButtonElement>>;
 
-type CopyButtonProps = Omit<ButtonProps, 'children' | 'leadingIcon' | 'loading' | 'size' | 'trailingIcon' | 'variant'> & {
+type CopyButtonProps = Omit<ButtonProps, 'appearance' | 'children' | 'loading' | 'size' | 'tone' | 'variant'> & OutlineDefaultActionStyle & {
     value: string;
     label?: React.ReactNode;
     copiedLabel?: React.ReactNode;
     onCopied?: () => void;
     size?: ButtonSize;
-    variant?: ButtonVariant;
     duration?: number;
 };
-declare const CopyButton: React.ForwardRefExoticComponent<Omit<ButtonProps, "size" | "variant" | "children" | "leadingIcon" | "trailingIcon" | "loading"> & {
-    value: string;
-    label?: React.ReactNode;
-    copiedLabel?: React.ReactNode;
-    onCopied?: () => void;
-    size?: ButtonSize;
-    variant?: ButtonVariant;
-    duration?: number;
-} & React.RefAttributes<HTMLButtonElement>>;
+declare const CopyButton: React.ForwardRefExoticComponent<CopyButtonProps & React.RefAttributes<HTMLButtonElement>>;
 
 declare const inputVariants: (props?: ({
     size?: "md" | "sm" | "lg" | null | undefined;
@@ -690,11 +684,11 @@ declare const FormLayout: React.ForwardRefExoticComponent<FormLayoutProps & Reac
 type OverlayScrim = "blur" | "dim";
 
 /**
- * @deprecated The structured Dialog (`title`) is a bottom sheet below 900px on its own.
+ * @deprecated The structured Dialog (`title`) is a bottom sheet below 1024px on its own.
  *
- * Where a dialog sits below 900px (the DS mobile band, same as Sheet `mobileSide`).
+ * Where a dialog sits below 1024px (the DS mobile band, same as Sheet `mobileSide`).
  * - `"center"` (default): the centered card at every width.
- * - `"sheet"`: a bottom sheet below 900px — pinned to the bottom edge, full width, top corners
+ * - `"sheet"`: a bottom sheet below 1024px — pinned to the bottom edge, full width, top corners
  *   rounded, height capped with its own scroll, sliding in on the Sheet bottom keyframes.
  *   Pure CSS, so SSR and hydration render the same tree at every width (no matchMedia swap).
  */
@@ -704,7 +698,7 @@ type DialogSize = "sm" | "md" | "lg";
 /**
  * Structured Dialog (spec §3.2): a center window for forms, pickers and long content. X + footer,
  * outside click does not close, Escape does (not while submitting), the body scrolls inside the max
- * height, a bottom sheet below 900px (OVERLAY_POLICY.dialog).
+ * height, a bottom sheet below 1024px (OVERLAY_POLICY.dialog).
  */
 interface DialogProps {
     open: boolean;
@@ -755,9 +749,9 @@ declare const DialogOverlay: React.ForwardRefExoticComponent<Omit<Dialog$1.Dialo
 declare const DialogContent: React.ForwardRefExoticComponent<Omit<Dialog$1.DialogContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & {
     showCloseButton?: boolean;
     /**
-     * @deprecated The structured Dialog (`title`) is a bottom sheet below 900px on its own.
+     * @deprecated The structured Dialog (`title`) is a bottom sheet below 1024px on its own.
      *
-     * Below 900px: `"center"` card (default) or `"sheet"` — see {@link DialogMobilePresentation}.
+     * Below 1024px: `"center"` card (default) or `"sheet"` — see {@link DialogMobilePresentation}.
      */
     mobilePresentation?: DialogMobilePresentation;
     /** Scrim preset; wins over `<html data-scrim>`. Default: the root preset, else `--scrim`. */
@@ -809,7 +803,7 @@ interface FormModalProps {
     /** Rendered at the top of the body. */
     status?: React.ReactNode;
     /**
-     * @deprecated Ignored. Dialog is a bottom sheet below 900px on its own.
+     * @deprecated Ignored. Dialog is a bottom sheet below 1024px on its own.
      */
     mobilePresentation?: DialogMobilePresentation;
 }
@@ -832,7 +826,7 @@ interface InfoModalProps {
     /** @deprecated Ignored. Content that needs the wide box belongs in Dialog. */
     width?: "default" | "wide";
     footer?: React.ReactNode;
-    /** @deprecated Ignored. AlertDialog stays a centered card below 900px. */
+    /** @deprecated Ignored. AlertDialog stays a centered card below 1024px. */
     mobilePresentation?: DialogMobilePresentation;
 }
 /**
@@ -856,6 +850,95 @@ interface FilterToolbarProps extends React.HTMLAttributes<HTMLDivElement> {
 }
 declare const FilterToolbar: React.ForwardRefExoticComponent<FilterToolbarProps & React.RefAttributes<HTMLDivElement>>;
 
+/** Props an item icon receives: a Lucide icon or any component taking `size` and `strokeWidth`. */
+type ActionMenuIconProps = {
+    size?: number | string;
+    strokeWidth?: number | string;
+    className?: string;
+    "aria-hidden"?: boolean;
+};
+interface ActionMenuItem {
+    id: string;
+    label: string;
+    /** Leading icon. */
+    icon?: React.ComponentType<ActionMenuIconProps>;
+    /** Secondary line under the label (menu sheet only). */
+    description?: string;
+    /** Danger color (DropdownMenuItem `variant="destructive"`, the sheet row's error color). */
+    destructive?: boolean;
+    disabled?: boolean;
+    /** Runs after the menu has closed and focus is back on the trigger. */
+    onSelect: () => void;
+}
+interface ActionMenuGroup {
+    id: string;
+    /** Group heading. */
+    label?: string;
+    items: ActionMenuItem[];
+}
+interface ActionMenuBaseProps {
+    /** The button that opens the menu, e.g. an IconButton with an `aria-label`. */
+    trigger: React.ReactElement;
+    /** Heading of the menu sheet below 1024px (also its accessible name). The dropdown shows none. */
+    title?: string;
+    /** Line under the heading, menu sheet only (from ActionSheet). */
+    description?: string;
+    /** Controlled open state (optional). */
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** Accessible name of the menu sheet's screen-reader-only close button. Default '닫기'. */
+    closeLabel?: string;
+}
+type ActionMenuProps = ActionMenuBaseProps & ({
+    items: ActionMenuItem[];
+    groups?: never;
+} | {
+    /** Items in groups, with a separator between groups. Use instead of `items`. */
+    groups: ActionMenuGroup[];
+    items?: never;
+});
+declare function ActionMenu({ trigger, title, description, open: openProp, onOpenChange, closeLabel, items, groups, }: ActionMenuProps): react_jsx_runtime.JSX.Element;
+
+/** The card's ⋮ menu: the same items as the desktop row menu. */
+interface ListCardActions {
+    items: readonly ActionMenuItem[];
+    /** Accessible name of the ⋮ button, e.g. the desktop ⋮ label. */
+    label: string;
+}
+interface ListCardProps {
+    title: React.ReactNode;
+    /**
+     * Up to two meta groups; each is one node or a list of values. A group is one line with its
+     * values 12px apart; values wrap to the next line whole.
+     */
+    meta?: readonly [React.ReactNode, React.ReactNode?];
+    /** One status badge at the bottom row's left. */
+    status?: React.ReactNode;
+    /** On the bottom row, after `status` or alone at its left. */
+    caption?: React.ReactNode;
+    leading?: React.ReactNode;
+    /** Optional value (score, count) at the right of the top line, before the ⋮ or the chevron. */
+    value?: React.ReactNode;
+    /**
+     * The icon at the top right. With `actions` it moves to the bottom right and the card is at
+     * least 84px tall, so the two 44px hit areas do not overlap.
+     */
+    trailing?: 'chevron' | 'none' | React.ReactNode;
+    /**
+     * ⋮ menu at the top right. With `href` or `onClick` the title becomes the link or button and
+     * its ::after covers the card, so the ⋮ button is never inside it.
+     */
+    actions?: ListCardActions;
+    href?: string;
+    linkComponent?: React.ElementType;
+    linkProps?: Record<string, unknown>;
+    onClick?: () => void;
+    /** Prefix for the `data-slot` of each part (`<slot>-title`, `<slot>-meta1`, …). */
+    slot?: string;
+    className?: string;
+}
+declare function ListCard({ title, meta, status, caption, leading, value, trailing, actions, href, linkComponent, linkProps, onClick, slot, className, }: ListCardProps): react_jsx_runtime.JSX.Element;
+
 declare const dataTableVariants: (props?: ({
     density?: "compact" | "standard" | null | undefined;
     surface?: SurfaceLevel | null | undefined;
@@ -908,10 +991,46 @@ interface DataTableSort {
     key: string;
     dir: 'asc' | 'desc';
 }
+/** One card meta group: up to two values on one line, 12px apart. */
+type DataTableMobileMetaLine = readonly [React.ReactNode, React.ReactNode?];
+type DataTableMobileCardName = {
+    title: string | number;
+    /** Accessible name of the card (`listitem`). Defaults to the title text. */
+    ariaLabel?: string;
+} | {
+    title: React.ReactNode;
+    /** Accessible name of the card (`listitem`). */
+    ariaLabel: string;
+};
+/** What one row shows as a card below the table breakpoint. */
+type DataTableMobileCardContent = DataTableMobileCardName & {
+    leading?: React.ReactNode;
+    /** Up to two meta groups under the title, one line each. */
+    meta?: readonly [DataTableMobileMetaLine, DataTableMobileMetaLine?];
+    /** One status badge at the bottom row's left. */
+    status?: React.ReactNode;
+    /** On the bottom row, after `status` or alone at its left. */
+    date?: React.ReactNode;
+    /** Optional value at the right of the card's top line, before the ⋮ or the chevron. */
+    value?: React.ReactNode;
+    /**
+     * ⋮ menu at the card's top right (a menu sheet below 1024px). `label` names the ⋮ button —
+     * pass the desktop ⋮ label. On a navigating card the chevron moves to the bottom right.
+     */
+    actions?: ListCardActions;
+};
 interface DataTableProps<T> extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children'>, VariantProps<typeof dataTableVariants> {
     columns: DataTableColumn<T>[];
     data: T[];
     keyField: keyof T;
+    /**
+     * Maps a row to its card below the table breakpoint. Navigation, selection and the
+     * chevron come from the table (`rowHref`, `linkComponent`, `onRowClick`, `selectable`):
+     * the card title becomes the link or button and its ::after covers the card, so the
+     * checkbox and the ⋮ stay beside it, never inside.
+     * With `virtual`, keep it stable (module function or `useCallback`) like `columns`.
+     */
+    getMobileCardContent: (row: T) => DataTableMobileCardContent;
     selectable?: boolean;
     selectedIds?: Set<string>;
     onSelectionChange?: (ids: Set<string>) => void;
@@ -946,10 +1065,11 @@ interface DataTableProps<T> extends Omit<React.HTMLAttributes<HTMLDivElement>, '
     onRowClick?: (row: T, event: React.MouseEvent<HTMLElement> | React.KeyboardEvent<HTMLElement>) => void;
     skeletonRowCount?: number;
     /**
-     * Virtual scrolling for long, continuously loaded lists (opt-in). Rows must
-     * share one fixed height (measured from the first rendered row). Only the
-     * visible layout — table or cards — renders rows, and only those near the
-     * viewport; rows are memoized. Works with any scroll container (window or an
+     * Virtual scrolling for long, continuously loaded lists (opt-in). Table rows must
+     * share one fixed height (measured from the first rendered row); cards are
+     * measured one by one, and unmeasured cards are estimated from the measured
+     * average. Only the visible layout — table or cards — renders rows, and only
+     * those near the viewport; rows are memoized. Works with any scroll container (window or an
      * app-shell `overflow-y-auto` main). Header "select all" still covers every
      * loaded row. Browser find (Ctrl+F) cannot see rows outside the window.
      */
@@ -1089,7 +1209,7 @@ interface ConfirmDialogProps {
     /** Keeps the confirm button disabled (e.g. until the typed count matches). */
     confirmDisabled?: boolean;
     /**
-     * @deprecated Ignored. AlertDialog stays a centered card below 900px.
+     * @deprecated Ignored. AlertDialog stays a centered card below 1024px.
      */
     mobilePresentation?: DialogMobilePresentation;
     /** Scrim preset; wins over `<html data-scrim>`. Default: the root preset, else `--scrim`. */
@@ -1097,7 +1217,7 @@ interface ConfirmDialogProps {
 }
 /**
  * @deprecated Use AlertDialog. ConfirmDialog is a thin wrapper over it: the surface has role
- * `alertdialog`, an outside click does not close it, and it stays a centered card below 900px.
+ * `alertdialog`, an outside click does not close it, and it stays a centered card below 1024px.
  */
 declare function ConfirmDialog({ open, onOpenChange, title, description, tone, confirmLabel, cancelLabel, onConfirm, loading, children, confirmDisabled, scrim, }: ConfirmDialogProps): react_jsx_runtime.JSX.Element;
 
@@ -1176,11 +1296,11 @@ type SheetMotionConfig = {
     duration?: SheetMotionDuration;
     easing?: SheetMotionEasing;
 };
-/** Structured Sheet width from 900px: 480 · 720 · viewport minus `--space-8`. */
+/** Structured Sheet width from 1024px: 480 · 720 · viewport minus `--space-8`. */
 type SheetSize = "md" | "lg" | "full";
 /**
  * Structured Sheet (spec §3.3): a side surface for supporting work without leaving the page. X,
- * outside click and Escape close, the body scrolls, a bottom sheet below 900px (OVERLAY_POLICY.sheet).
+ * outside click and Escape close, the body scrolls, a bottom sheet below 1024px (OVERLAY_POLICY.sheet).
  */
 interface SheetProps {
     open: boolean;
@@ -1193,9 +1313,9 @@ interface SheetProps {
     caption?: React.ReactNode;
     /** Header controls before the X, e.g. an expand toggle. */
     headerActions?: React.ReactNode;
-    /** Edge from 900px. Default `"right"`. Below 900px it is a bottom sheet. */
+    /** Edge from 1024px. Default `"right"`. Below 1024px it is a bottom sheet. */
     side?: "right" | "left";
-    /** Width from 900px. Default `"md"`. */
+    /** Width from 1024px. Default `"md"`. */
     size?: SheetSize;
     /** Body. Scrolls inside the sheet. */
     children: React.ReactNode;
@@ -1203,7 +1323,7 @@ interface SheetProps {
     footer?: React.ReactNode;
     /** Accessible name of the X. Default '닫기'. */
     closeLabel?: string;
-    /** Side panel motion from 900px (`false`: none). Same as SheetContent `motion`. */
+    /** Side panel motion from 1024px (`false`: none). Same as SheetContent `motion`. */
     motion?: SheetMotionConfig | false;
     /** Scrim preset; wins over `<html data-scrim>`. */
     scrim?: OverlayScrim;
@@ -1223,10 +1343,10 @@ declare function SheetClose({ ...props }: React.ComponentProps<typeof Dialog$1.C
 declare function SheetContent({ className, children, side, mobileSide, motion, showCloseButton, scrim, style, onOpenAutoFocus, onCloseAutoFocus, ...props }: React.ComponentProps<typeof Dialog$1.Content> & {
     /**
      * Edge. `"top"` and `"bottom"` are deprecated: the structured Sheet takes `"right"` or `"left"`
-     * from 900px and is a bottom sheet below.
+     * from 1024px and is a bottom sheet below.
      */
     side?: "top" | "right" | "bottom" | "left";
-    /** @deprecated The structured Sheet is a bottom sheet below 900px by rule. */
+    /** @deprecated The structured Sheet is a bottom sheet below 1024px by rule. */
     mobileSide?: "top" | "right" | "bottom" | "left";
     motion?: SheetMotionConfig | false;
     showCloseButton?: boolean;
@@ -1300,60 +1420,11 @@ interface ActionSheetProps {
     closeLabel?: string;
 }
 /**
- * @deprecated Use ActionMenu: the same items become a DropdownMenu from 900px and this menu sheet
+ * @deprecated Use ActionMenu: the same items become a DropdownMenu from 1024px and this menu sheet
  * below, from one trigger.
  */
 declare function ActionSheet({ open, onOpenChange, title, description, items, closeLabel, }: ActionSheetProps): react_jsx_runtime.JSX.Element;
 
-/** Props an item icon receives: a Lucide icon or any component taking `size` and `strokeWidth`. */
-type ActionMenuIconProps = {
-    size?: number | string;
-    strokeWidth?: number | string;
-    className?: string;
-    "aria-hidden"?: boolean;
-};
-interface ActionMenuItem {
-    id: string;
-    label: string;
-    /** Leading icon. */
-    icon?: React.ComponentType<ActionMenuIconProps>;
-    /** Secondary line under the label (menu sheet only). */
-    description?: string;
-    /** Danger color (DropdownMenuItem `variant="destructive"`, the sheet row's error color). */
-    destructive?: boolean;
-    disabled?: boolean;
-    /** Runs after the menu has closed and focus is back on the trigger. */
-    onSelect: () => void;
-}
-interface ActionMenuGroup {
-    id: string;
-    /** Group heading. */
-    label?: string;
-    items: ActionMenuItem[];
-}
-interface ActionMenuBaseProps {
-    /** The button that opens the menu, e.g. an IconButton with an `aria-label`. */
-    trigger: React.ReactElement;
-    /** Heading of the menu sheet below 900px (also its accessible name). The dropdown shows none. */
-    title?: string;
-    /** Line under the heading, menu sheet only (from ActionSheet). */
-    description?: string;
-    /** Controlled open state (optional). */
-    open?: boolean;
-    onOpenChange?: (open: boolean) => void;
-    /** Accessible name of the menu sheet's screen-reader-only close button. Default '닫기'. */
-    closeLabel?: string;
-}
-type ActionMenuProps = ActionMenuBaseProps & ({
-    items: ActionMenuItem[];
-    groups?: never;
-} | {
-    /** Items in groups, with a separator between groups. Use instead of `items`. */
-    groups: ActionMenuGroup[];
-    items?: never;
-});
-declare function ActionMenu({ trigger, title, description, open: openProp, onOpenChange, closeLabel, items, groups, }: ActionMenuProps): react_jsx_runtime.JSX.Element;
-
 declare function TooltipProvider({ delayDuration, ...props }: React.ComponentProps<typeof Tooltip$1.Provider>): react_jsx_runtime.JSX.Element;
 interface TooltipProps extends React.ComponentProps<typeof Tooltip$1.Root> {
     /**
@@ -1591,28 +1662,17 @@ interface SpinnerProps extends React.HTMLAttributes<HTMLSpanElement> {
 declare const Spinner: React.ForwardRefExoticComponent<SpinnerProps & React.RefAttributes<HTMLSpanElement>>;
 
 declare const iconButtonCva: (props?: ({
-    size?: "md" | "sm" | "lg" | null | undefined;
+    size?: "md" | "xs" | "sm" | "lg" | "xl" | null | undefined;
     pressed?: boolean | null | undefined;
     appearance?: "filled" | "outline" | "ghost" | null | undefined;
     tone?: "primary" | "neutral" | "danger" | null | undefined;
-    variant?: "outline" | "ghost" | "danger" | "subtle" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
-type IconButtonAxisSize = "xs" | "sm" | "md" | "lg" | "xl";
-type IconButtonCvaOptions = NonNullable<Parameters<typeof iconButtonCva>[0]>;
-type IconButtonVariantsOptions = (IconButtonCvaOptions & {
-    appearance?: null;
-    tone?: null;
-}) | (Omit<IconButtonCvaOptions, "size"> & {
-    appearance?: ActionAppearance | null;
-    tone?: ActionTone | null;
-    size?: IconButtonAxisSize | null;
-});
+type IconButtonSize = NonNullable<VariantProps<typeof iconButtonCva>["size"]>;
+type IconButtonVariantsOptions = NonNullable<Parameters<typeof iconButtonCva>[0]>;
 declare function iconButtonVariants(options?: IconButtonVariantsOptions): string;
 declare const iconButtonBadgeVariants: (props?: ({
     tone?: "error" | "info" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
-type IconButtonVariant = NonNullable<VariantProps<typeof iconButtonCva>["variant"]>;
-type IconButtonSize = NonNullable<VariantProps<typeof iconButtonCva>["size"]>;
 type IconButtonBadgeTone = NonNullable<VariantProps<typeof iconButtonBadgeVariants>["tone"]>;
 type IconButtonIcon = React.ComponentType<React.SVGProps<SVGSVGElement> & {
     size?: number | string;
@@ -1629,34 +1689,26 @@ type IconButtonOptionalName = {
     "aria-label"?: string;
     "aria-labelledby"?: string;
 };
+type IconButtonTextEnd = {
+    iconPosition?: "start" | "end";
+    menuIndicator?: false;
+} | {
+    iconPosition?: "start";
+    menuIndicator: true;
+};
 type IconButtonContent = (IconButtonAccessibleName & {
     label?: never;
     children?: never;
+    menuIndicator?: never;
 }) | (IconButtonOptionalName & {
     label: React.ReactNode;
     children?: never;
-}) | (IconButtonOptionalName & {
+} & IconButtonTextEnd) | (IconButtonOptionalName & {
     children: React.ReactNode;
     label?: never;
-});
-type IconButtonStyleProps = (GhostDefaultActionStyle & {
-    /**
-     * @deprecated Use `appearance` × `tone` instead. Removed in 0.20.
-     */
-    variant?: never;
+} & IconButtonTextEnd);
+type IconButtonStyleProps = GhostDefaultActionStyle & {
     /** Button's scale: `xs` 28 · `sm` 30 · `md` 32 · `lg` 36 · `xl` 40. */
-    size?: IconButtonAxisSize | null;
-}) | {
-    /**
-     * @deprecated Use `appearance` × `tone`: `ghost` → ghost + neutral · `outline` →
-     * outline + neutral · `subtle` → filled + neutral · `danger` → filled + danger
-     * (solid red; `danger` keeps its light red until removal). When moving to the new axes,
-     * `size` follows Button's scale: `sm` → `xs`, `lg` → `xl` (`md` stays). Removed in 0.20.
-     */
-    variant?: IconButtonVariant | null;
-    appearance?: never;
-    tone?: never;
-    /** Legacy scale without `appearance`/`tone`: `sm` 28 · `md` 32 · `lg` 40. */
     size?: IconButtonSize | null;
 };
 type IconButtonProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "aria-label" | "aria-labelledby" | "children" | "color"> & IconButtonStyleProps & IconButtonContent & {
@@ -1666,6 +1718,13 @@ type IconButtonProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "aria
     badgeTone?: IconButtonBadgeTone;
     /** Icon side when the button has text. */
     iconPosition?: "start" | "end";
+    /** Like Button: the spinner takes the icon's place and the button is disabled. */
+    loading?: boolean;
+    /**
+     * Trailing ▾ for a menu trigger, with text and a start icon only. The trigger (DropdownMenu
+     * etc.) supplies `aria-haspopup`.
+     */
+    menuIndicator?: boolean;
 };
 declare const IconButton: React.ForwardRefExoticComponent<IconButtonProps & React.RefAttributes<HTMLButtonElement>>;
 
@@ -1759,16 +1818,15 @@ interface ActionFooterStatus {
     kind: 'saving' | 'saved' | 'error';
     lastSavedAt?: Date;
 }
-interface ActionFooterAction {
+type ActionFooterAction = FilledDefaultActionStyle & {
     id?: string;
     label: string;
-    variant?: ButtonVariant;
     onClick: () => void;
     disabled?: boolean;
     loading?: boolean;
     permission?: string;
     leadingIcon?: LucideIcon;
-}
+};
 interface ActionFooterProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children'>, VariantProps<typeof actionFooterVariants> {
     status?: ActionFooterStatus;
     actions: ActionFooterAction[];
@@ -2107,4 +2165,4 @@ interface OrganizationLogoProps extends Omit<SVGProps<SVGSVGElement>, "width" |
 }
 declare function OrganizationLogo({ organization, size, className, style, role, "aria-label": ariaLabel, "aria-hidden": ariaHidden, ...props }: OrganizationLogoProps): react_jsx_runtime.JSX.Element;
 
-export { ActionFooter, type ActionFooterAction, type ActionFooterProps, type ActionFooterStatus, ActionMenu, type ActionMenuGroup, type ActionMenuItem, type ActionMenuProps, ActionSheet, type ActionSheetIconProps, type ActionSheetItem, type ActionSheetProps, Alert, AlertDialog, type AlertDialogProps, type AlertDialogTone, type AlertEmphasis, type AlertProps, type AlertVariant, Avatar, AvatarFallback, type AvatarFallbackProps, AvatarImage, Badge, type BadgeProps, type BadgeTone, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, BulkActionBar, type BulkActionBarAction, type BulkActionBarProps, Button, type ButtonProps, type ButtonSize, type ButtonVariant, Card, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, CardProse, CardTitle, type CardVariant, type CardVariantOptions, Checkbox, type CheckboxCheckedState, CheckboxGroup, type CheckboxGroupAppearance, type CheckboxGroupColumns, CheckboxGroupContext, type CheckboxGroupContextValue, type CheckboxGroupDensity, type CheckboxGroupOrientation, type CheckboxGroupProps, type CheckboxProps, type CheckboxSize, Chip, type ChipProps, type ChipSize, type ChipTone, type ChipVariant, ConfirmDialog, type ConfirmDialogProps, ContextMenu, type ContextMenuPosition, type ContextMenuProps, CopyButton, type CopyButtonProps, DataLayout, type DataLayoutProps, DataTable, type DataTableColumn, type DataTableLinkProps, type DataTableProps, type DataTableSort, type DataTableVirtualHandle, type DataTableVirtualOptions, type DataTableVirtualRange, DetailLayout, type DetailLayoutProps, Dialog, DialogClose, DialogContent, DialogDescription, DialogEyebrow, DialogFooter, DialogHeader, type DialogMobilePresentation, DialogOverlay, DialogPortal, type DialogProps, DialogRawContent, type DialogSize, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmptyState, type EmptyStateProps, type EmptyStateSize, type EmptyStateTone, type EmptyStateVariantOptions, ErrorState, type ErrorStateProps, FileUploadZone, type FileUploadZoneProps, FilterToolbar, type FilterToolbarCollapseBelow, type FilterToolbarProps, FormField, type FormFieldProps, type FormFieldRenderProps, FormLayout, type FormLayoutProps, type FormLayoutSection, FormModal, type FormModalProps, IconButton, type IconButtonBadgeTone, type IconButtonProps, type IconButtonSize, type IconButtonVariant, InfoModal, type InfoModalProps, InlineAlert, type InlineAlertProps, type InlineAlertSurface, Input, type InputProps, type InputSize, type InputSizeLegacy, type InputState, Label, type LabelProps, ModeToggle, type ModeToggleOption, type ModeToggleProps, NotificationBadge, type NotificationBadgePlacement, type NotificationBadgeProps, type NotificationBadgeSize, OTPField, type OTPFieldProps, type OTPFieldSize, OlunLogo, OlunSymbol, type OlunTheme, type OlunThemeDuration, type OlunThemeState, OrganizationLogo, type OrganizationLogoId, type OrganizationLogoProps, type OverlayScrim, PageHeader, type PageHeaderProps, PageSizeSelect, type PageSizeSelectProps, type PageSizeSelectSize, Pagination, type PaginationProps, type PaginationSize, PermissionContext, type PermissionEvaluator, type PermissionFallback, PermissionGuard, type PermissionGuardProps, PermissionProvider, type PermissionProviderProps, type PermissionScope, type PermissionState, Popover, PopoverAnchor, PopoverArrow, PopoverClose, PopoverContent, type PopoverContentProps, type PopoverProps, PopoverTrigger, Progress, type ProgressProps, type ProgressStatus, Radio, RadioGroup, type RadioGroupAppearance, type RadioGroupColumns, type RadioGroupDensity, type RadioGroupOrientation, type RadioGroupProps, type RadioProps, ScrollArea, ScrollBar, SearchField, type SearchFieldProps, type SearchFieldSize, Select, type SelectAppearance, type SelectOption, type SelectProps, type SelectSize, type SelectState, type SelectVariant, type SemanticRole, Separator, type SetOlunThemeOptions, Sheet, SheetBody, SheetClose, SheetContent, SheetDescription, SheetDrawer, type SheetDrawerProps, SheetFooter, SheetHeader, type SheetMotionConfig, type SheetMotionDuration, type SheetMotionEasing, type SheetMotionType, type SheetProps, type SheetSize, SheetTitle, SheetTrigger, Skeleton, type SkeletonProps, SkeletonRow, type SkeletonRowColumn, type SkeletonRowProps, SkeletonText, type SkeletonTextProps, Spinner, type SpinnerProps, StatusBadge, type StatusBadgeEmphasis, type StatusBadgeProps, type StatusBadgeSize, type StatusBadgeStatus, StatusDot, type StatusDotProps, type StatusDotTone, type SurfaceLevel, Switch, type SwitchProps, type TabItem, Tabs, TabsContent, type TabsProps, type TabsVariant, Textarea, type TextareaProps, type TextareaSize, type TextareaSizeLegacy, type TextareaState, ThemeFab, type ThemeFabProps, ThemeToggle, Toast, type ToastAction, type ToastItem, type ToastOptions, ToastProvider, ToastRoot, type ToastVariant, ToastViewport, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type TreeItemRowVariantProps, type TreeItemState, type TreeNode, TreeView, type TreeViewProps, TwoTierBadge, type TwoTierBadgeEmphasis, type TwoTierBadgeProps, type TwoTierBadgeSize, type TwoTierBadgeTone, type UseOlunThemeValue, WizardLayout, type WizardLayoutProps, type WizardStep, type WizardStepState, actionFooterStatusVariants, actionFooterVariants, buttonVariants, cardVariants, checkboxBoxVariants, checkboxFieldVariants, checkboxGroupBoxVariants, checkboxGroupItemVariants, checkboxGroupVariants, checkboxRootVariants, checkboxVariants, chipCountVariants, chipVariants, cn, dataTableRowVariants, dataTableVariants, emptyStateIconVariants, emptyStateVariants, errorStateVariants, evaluatePermission, fileUploadIconVariants, fileUploadZoneVariants, formFieldControlStackClassName, formFieldDescriptionClassName, formFieldErrorClassName, formFieldLabelClassName, formFieldRequiredClassName, formFieldVariants, getOlunThemeState, getToastDuration, iconButtonBadgeVariants, iconButtonVariants, inputMessageVariants, inputVariants, limitToasts, modeToggleItemVariants, modeToggleVariants, notificationBadgeVariants, otpCellVariants, otpFieldGroupVariants, otpFieldMessageVariants, otpFieldVariants, paginationControlVariants, paginationVariants, radioControlVariants, radioGroupVariants, radioVariants, searchFieldInputVariants, searchFieldVariants, selectMessageVariants, selectVariants, setOlunTheme, skeletonVariants, spinnerVariants, tabsBadgeVariants, tabsListVariants, tabsRootVariants, tabsTriggerVariants, textareaMessageVariants, textareaVariants, toast, toastVariants, toastViewportVariants, treeItemRowVariants, treeViewVariants, useOlunTheme, usePermission };
+export { ActionFooter, type ActionFooterAction, type ActionFooterProps, type ActionFooterStatus, ActionMenu, type ActionMenuGroup, type ActionMenuItem, type ActionMenuProps, ActionSheet, type ActionSheetIconProps, type ActionSheetItem, type ActionSheetProps, Alert, AlertDialog, type AlertDialogProps, type AlertDialogTone, type AlertEmphasis, type AlertProps, type AlertVariant, Avatar, AvatarFallback, type AvatarFallbackProps, AvatarImage, Badge, type BadgeProps, type BadgeTone, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, BulkActionBar, type BulkActionBarAction, type BulkActionBarProps, Button, type ButtonProps, type ButtonSize, Card, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, CardProse, CardTitle, type CardVariant, type CardVariantOptions, Checkbox, type CheckboxCheckedState, CheckboxGroup, type CheckboxGroupAppearance, type CheckboxGroupColumns, CheckboxGroupContext, type CheckboxGroupContextValue, type CheckboxGroupDensity, type CheckboxGroupOrientation, type CheckboxGroupProps, type CheckboxProps, type CheckboxSize, Chip, type ChipProps, type ChipSize, type ChipTone, type ChipVariant, ConfirmDialog, type ConfirmDialogProps, ContextMenu, type ContextMenuPosition, type ContextMenuProps, CopyButton, type CopyButtonProps, DataLayout, type DataLayoutProps, DataTable, type DataTableColumn, type DataTableLinkProps, type DataTableMobileCardContent, type DataTableMobileMetaLine, type DataTableProps, type DataTableSort, type DataTableVirtualHandle, type DataTableVirtualOptions, type DataTableVirtualRange, DetailLayout, type DetailLayoutProps, Dialog, DialogClose, DialogContent, DialogDescription, DialogEyebrow, DialogFooter, DialogHeader, type DialogMobilePresentation, DialogOverlay, DialogPortal, type DialogProps, DialogRawContent, type DialogSize, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmptyState, type EmptyStateProps, type EmptyStateSize, type EmptyStateTone, type EmptyStateVariantOptions, ErrorState, type ErrorStateProps, FileUploadZone, type FileUploadZoneProps, FilterToolbar, type FilterToolbarCollapseBelow, type FilterToolbarProps, FormField, type FormFieldProps, type FormFieldRenderProps, FormLayout, type FormLayoutProps, type FormLayoutSection, FormModal, type FormModalProps, IconButton, type IconButtonBadgeTone, type IconButtonProps, type IconButtonSize, InfoModal, type InfoModalProps, InlineAlert, type InlineAlertProps, type InlineAlertSurface, Input, type InputProps, type InputSize, type InputSizeLegacy, type InputState, Label, type LabelProps, ListCard, type ListCardActions, type ListCardProps, ModeToggle, type ModeToggleOption, type ModeToggleProps, NotificationBadge, type NotificationBadgePlacement, type NotificationBadgeProps, type NotificationBadgeSize, OTPField, type OTPFieldProps, type OTPFieldSize, OlunLogo, OlunSymbol, type OlunTheme, type OlunThemeDuration, type OlunThemeState, OrganizationLogo, type OrganizationLogoId, type OrganizationLogoProps, type OverlayScrim, PageHeader, type PageHeaderProps, PageSizeSelect, type PageSizeSelectProps, type PageSizeSelectSize, Pagination, type PaginationProps, type PaginationSize, PermissionContext, type PermissionEvaluator, type PermissionFallback, PermissionGuard, type PermissionGuardProps, PermissionProvider, type PermissionProviderProps, type PermissionScope, type PermissionState, Popover, PopoverAnchor, PopoverArrow, PopoverClose, PopoverContent, type PopoverContentProps, type PopoverProps, PopoverTrigger, Progress, type ProgressProps, type ProgressStatus, Radio, RadioGroup, type RadioGroupAppearance, type RadioGroupColumns, type RadioGroupDensity, type RadioGroupOrientation, type RadioGroupProps, type RadioProps, ScrollArea, ScrollBar, SearchField, type SearchFieldProps, type SearchFieldSize, Select, type SelectAppearance, type SelectOption, type SelectProps, type SelectSize, type SelectState, type SelectVariant, type SemanticRole, Separator, type SetOlunThemeOptions, Sheet, SheetBody, SheetClose, SheetContent, SheetDescription, SheetDrawer, type SheetDrawerProps, SheetFooter, SheetHeader, type SheetMotionConfig, type SheetMotionDuration, type SheetMotionEasing, type SheetMotionType, type SheetProps, type SheetSize, SheetTitle, SheetTrigger, Skeleton, type SkeletonProps, SkeletonRow, type SkeletonRowColumn, type SkeletonRowProps, SkeletonText, type SkeletonTextProps, Spinner, type SpinnerProps, StatusBadge, type StatusBadgeEmphasis, type StatusBadgeProps, type StatusBadgeSize, type StatusBadgeStatus, StatusDot, type StatusDotProps, type StatusDotTone, type SurfaceLevel, Switch, type SwitchProps, type TabItem, Tabs, TabsContent, type TabsProps, type TabsVariant, Textarea, type TextareaProps, type TextareaSize, type TextareaSizeLegacy, type TextareaState, ThemeFab, type ThemeFabProps, ThemeToggle, Toast, type ToastAction, type ToastItem, type ToastOptions, ToastProvider, ToastRoot, type ToastVariant, ToastViewport, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type TreeItemRowVariantProps, type TreeItemState, type TreeNode, TreeView, type TreeViewProps, TwoTierBadge, type TwoTierBadgeEmphasis, type TwoTierBadgeProps, type TwoTierBadgeSize, type TwoTierBadgeTone, type UseOlunThemeValue, WizardLayout, type WizardLayoutProps, type WizardStep, type WizardStepState, actionFooterStatusVariants, actionFooterVariants, buttonVariants, cardVariants, checkboxBoxVariants, checkboxFieldVariants, checkboxGroupBoxVariants, checkboxGroupItemVariants, checkboxGroupVariants, checkboxRootVariants, checkboxVariants, chipCountVariants, chipVariants, cn, dataTableRowVariants, dataTableVariants, emptyStateIconVariants, emptyStateVariants, errorStateVariants, evaluatePermission, fileUploadIconVariants, fileUploadZoneVariants, formFieldControlStackClassName, formFieldDescriptionClassName, formFieldErrorClassName, formFieldLabelClassName, formFieldRequiredClassName, formFieldVariants, getOlunThemeState, getToastDuration, iconButtonBadgeVariants, iconButtonVariants, inputMessageVariants, inputVariants, limitToasts, modeToggleItemVariants, modeToggleVariants, notificationBadgeVariants, otpCellVariants, otpFieldGroupVariants, otpFieldMessageVariants, otpFieldVariants, paginationControlVariants, paginationVariants, radioControlVariants, radioGroupVariants, radioVariants, searchFieldInputVariants, searchFieldVariants, selectMessageVariants, selectVariants, setOlunTheme, skeletonVariants, spinnerVariants, tabsBadgeVariants, tabsListVariants, tabsRootVariants, tabsTriggerVariants, textareaMessageVariants, textareaVariants, toast, toastVariants, toastViewportVariants, treeItemRowVariants, treeViewVariants, useOlunTheme, usePermission };