@bysages/react 0.2.0 → 0.2.2

package/dist/index.d.mts

@@ -4,8 +4,8 @@ import { Field as Field$1 } from "@ark-ui/react/field";
 import { Popover as Popover$1 } from "@ark-ui/react/popover";
 import { Collapsible as Collapsible$1 } from "@ark-ui/react/collapsible";
 import { AngleSlider as AngleSlider$1 } from "@ark-ui/react/angle-slider";
-import { CollectionItem, CollectionOptions, FilePathTreeNode, FlatTreeNode, GridCollection, GridCollectionOptions, ListCollection, TreeCollection, TreeCollectionOptions, TreeNode, UseAsyncListProps, UseAsyncListReturn, UseListCollectionProps, UseListCollectionReturn, UseListSelectionProps, UseListSelectionReturn, createFileTreeCollection, createGridCollection, createTreeCollection, useAsyncList, useListCollection, useListSelection } from "@ark-ui/react/collection";
-import { Combobox as Combobox$1 } from "@ark-ui/react/combobox";
+import { CollectionItem, CollectionItem as CollectionItem$1, CollectionOptions, FilePathTreeNode, FlatTreeNode, GridCollection, GridCollectionOptions, ListCollection, TreeCollection, TreeCollectionOptions, TreeNode, UseAsyncListProps, UseAsyncListReturn, UseListCollectionProps, UseListCollectionReturn, UseListSelectionProps, UseListSelectionReturn, createFileTreeCollection, createGridCollection, createTreeCollection, useAsyncList, useListCollection, useListSelection } from "@ark-ui/react/collection";
+import { Combobox as Combobox$1, ComboboxRootComponentProps } from "@ark-ui/react/combobox";
 import { Avatar as Avatar$1 } from "@ark-ui/react/avatar";
 import { DatePicker as DatePicker$1, DatePickerFocusChangeDetails, DatePickerOpenChangeDetails, DatePickerRootProps, DatePickerValueChangeDetails, DatePickerViewChangeDetails, DatePickerVisibleRangeChangeDetails } from "@ark-ui/react/date-picker";
 import { Carousel as Carousel$1 } from "@ark-ui/react/carousel";
@@ -26,7 +26,7 @@ import { Format as Format$1 } from "@ark-ui/react/format";
 import { HoverCard as HoverCard$1 } from "@ark-ui/react/hover-card";
 import { ImageCropper as ImageCropper$1 } from "@ark-ui/react/image-cropper";
 import { JsonTreeView as JsonTreeView$1 } from "@ark-ui/react/json-tree-view";
-import { Listbox as Listbox$1 } from "@ark-ui/react/listbox";
+import { Listbox as Listbox$1, ListboxRootComponentProps } from "@ark-ui/react/listbox";
 import { Marquee as Marquee$1 } from "@ark-ui/react/marquee";
 import { Menu as Menu$1 } from "@ark-ui/react/menu";
 import { NavigationMenu as NavigationMenu$1 } from "@ark-ui/react/navigation-menu";
@@ -41,7 +41,7 @@ import { RadioGroup as RadioGroup$1 } from "@ark-ui/react/radio-group";
 import { RatingGroup as RatingGroup$1 } from "@ark-ui/react/rating-group";
 import { ScrollArea as ScrollArea$1 } from "@ark-ui/react/scroll-area";
 import { SegmentGroup as SegmentGroup$1 } from "@ark-ui/react/segment-group";
-import { Select as Select$1 } from "@ark-ui/react/select";
+import { Select as Select$1, SelectRootComponentProps } from "@ark-ui/react/select";
 import { SignaturePad as SignaturePad$1 } from "@ark-ui/react/signature-pad";
 import { Slider as Slider$1 } from "@ark-ui/react/slider";
 import { Splitter as Splitter$1 } from "@ark-ui/react/splitter";
@@ -58,7 +58,7 @@ import { Toggle as Toggle$1 } from "@ark-ui/react/toggle";
 import { ToggleGroup as ToggleGroup$1 } from "@ark-ui/react/toggle-group";
 import { Tooltip as Tooltip$1 } from "@ark-ui/react/tooltip";
 import { Tour as Tour$1, TourInteractOutsideEvent, TourPointerDownOutsideEvent, TourStepDetails, useTour } from "@ark-ui/react/tour";
-import { TreeView as TreeView$1, TreeViewCheckedChangeDetails, TreeViewExpandedChangeDetails, TreeViewFocusChangeDetails, TreeViewSelectionChangeDetails } from "@ark-ui/react/tree-view";
+import { TreeView as TreeView$1, TreeViewRootComponentProps } from "@ark-ui/react/tree-view";
 import { JSONSchema7, JSONSchema7 as JSONSchema7$1 } from "json-schema";
 export * from "@bysages/core";
 //#endregion
@@ -154,6 +154,8 @@ export interface MentionEntry {
   value: string;
 }
 export interface MentionsVesselProps {
+  /** The host field's rung, so the rows keep the field's register. */
+  size?: "sm" | "md" | "lg";
   /** Whether the candidates are up. */
   open?: boolean;
   /** The candidates on offer. */
@@ -174,7 +176,7 @@ export interface MentionsVesselProps {
  * its own anatomy (the textarea rides where the host puts it) and the
  * vessel still points at the right place. Shares the detection state
  * with the host through `useMentions`. */
-export declare function MentionsVessel({ open, matches, active, anchor, onInsert, onActiveChange, onOpenChange }: MentionsVesselProps): import("react").JSX.Element;
+export declare function MentionsVessel({ size, open, matches, active, anchor, onInsert, onActiveChange, onOpenChange }: MentionsVesselProps): import("react").JSX.Element;
 /**
  * @-mentions: a plain textarea that, when the text before the caret ends
  * with the trigger character followed by a token, offers the matching
@@ -205,10 +207,12 @@ export interface MentionsProps extends HTMLAttributes<HTMLDivElement> {
   /** Standing alone, the field styles itself from this flag; inside a
    * `Field.Root` the field's own invalid state takes over. */
   invalid?: boolean;
+  /** One rung of the control-height ladder for the resting field. */
+  size?: "sm" | "md" | "lg";
   /** Reports the field's next text. */
   onValueChange?: (value: string) => void;
 }
-export declare function Mentions({ items, value, trigger, placeholder, autoresize, invalid, onValueChange, children, ...rest }: MentionsProps): import("react").JSX.Element;
+export declare function Mentions({ items, value, trigger, placeholder, autoresize, invalid, size, onValueChange, children, ...rest }: MentionsProps): import("react").JSX.Element;
 //#endregion
 //#region src/components/ai-prompt-input/index.d.ts
 /**
@@ -13544,11 +13548,18 @@ export declare const Alert: typeof AlertRoot & {
 };
 //#endregion
 //#region src/components/angle-slider/index.d.ts
+type AngleSliderRootProps = ComponentProps<typeof AngleSlider$1.Root> & {
+  /** One rung of the dial ladder — the diameter the needle sweeps. */
+  size?: "sm" | "md" | "lg";
+};
+declare function AngleSliderRoot({ size, ...rest }: AngleSliderRootProps): import("react").JSX.Element;
 /** Ark's AngleSlider, dressed in the paper-and-ink system: a flat paper dial
  * the thumb sweeps as a pigment needle over hairline degree ticks. The API
  * is Ark's own — Root, Label, ValueText, Control, Thumb, MarkerGroup,
  * Marker, HiddenInput. */
-export declare const AngleSlider: typeof AngleSlider$1;
+export declare const AngleSlider: Omit<typeof AngleSlider$1, "Root"> & {
+  Root: typeof AngleSliderRoot;
+};
 //#endregion
 //#region src/components/aspect-ratio/index.d.ts
 /** A frame that keeps its shape: the box holds the given ratio whatever
@@ -13573,9 +13584,11 @@ export interface AutoCompleteProps extends Omit<HTMLAttributes<HTMLDivElement>,
   placeholder?: string;
   /** Field text to match against; defaults to the item itself. */
   filter?: (item: string, input: string) => boolean;
+  /** One rung of the control-height ladder for the field row. */
+  size?: "sm" | "md" | "lg";
   onValueChange?: (value: string) => void;
 }
-export declare function AutoComplete({ value, items, placeholder, filter, onValueChange, ...rest }: AutoCompleteProps): import("react").JSX.Element;
+export declare function AutoComplete({ value, items, placeholder, filter, size, onValueChange, ...rest }: AutoCompleteProps): import("react").JSX.Element;
 //#endregion
 //#region src/components/avatar/index.d.ts
 /** Avatar, dressed in the paper-and-ink system: a circular seal on
@@ -13598,8 +13611,12 @@ export declare const Avatar: typeof Avatar$1 & {
 //#region src/components/avatar-group/index.d.ts
 /** Avatars overlapping one row, each rimmed in the ground so the pile
  * stays legible. */
-export type AvatarGroupProps = HTMLAttributes<HTMLDivElement>;
-export declare function AvatarGroup({ children, ...rest }: AvatarGroupProps): import("react").JSX.Element;
+export interface AvatarGroupProps extends HTMLAttributes<HTMLDivElement> {
+  /** One register for every seal: falls onto data-size for the
+   * stylesheet to re-point the avatars' measure. */
+  size?: "sm" | "md" | "lg";
+}
+export declare function AvatarGroup({ size, children, ...rest }: AvatarGroupProps): import("react").JSX.Element;
 //#endregion
 //#region src/components/back-top/index.d.ts
 export interface BackTopProps extends HTMLAttributes<HTMLButtonElement> {
@@ -13824,9 +13841,11 @@ export interface CascadeSelectProps extends HTMLAttributes<HTMLDivElement> {
   filterable?: boolean;
   multiple?: boolean;
   disabled?: boolean;
+  /** One rung of the control-height ladder for the trigger. */
+  size?: "sm" | "md" | "lg";
   onValueChange?: (value: string[][]) => void;
 }
-export declare function CascadeSelect({ value, data, placeholder, highlightTrigger, filterable, multiple, disabled, onValueChange, ...rest }: CascadeSelectProps): import("react").JSX.Element;
+export declare function CascadeSelect({ value, data, placeholder, highlightTrigger, filterable, multiple, disabled, size, onValueChange, ...rest }: CascadeSelectProps): import("react").JSX.Element;
 //#endregion
 //#region src/components/carousel/index.d.ts
 /** Ark's Carousel, dressed in the paper-and-ink system: slides ride in one
@@ -13837,11 +13856,18 @@ export declare function CascadeSelect({ value, data, placeholder, highlightTrigg
 export declare const Carousel: typeof Carousel$1;
 //#endregion
 //#region src/components/checkbox/index.d.ts
+type CheckboxRootProps = ComponentProps<typeof Checkbox$1.Root> & {
+  /** One rung for the control's box: the tick scales with it. */
+  size?: "sm" | "md" | "lg";
+};
+declare function CheckboxRoot({ size, ...rest }: CheckboxRootProps): import("react").JSX.Element;
 /** Ark's Checkbox, dressed in the paper-and-ink system: a square-cut seal
  * that fills flat with primary ink when ticked, the mark springing into
  * place. The API is Ark's own — Root, Label, Control, Indicator,
  * HiddenInput. */
-export declare const Checkbox: typeof Checkbox$1;
+export declare const Checkbox: Omit<typeof Checkbox$1, "Root"> & {
+  Root: typeof CheckboxRoot;
+};
 //#endregion
 //#region src/components/checkbox-group/index.d.ts
 export interface CheckboxOption {
@@ -13853,6 +13879,9 @@ export interface CheckboxGroupProps extends HTMLAttributes<HTMLDivElement> {
   value?: string[];
   options: CheckboxOption[];
   layout?: "vertical" | "horizontal";
+  /** One register for every box: falls onto each root's data-size for
+   * the stylesheet to retune. */
+  size?: "sm" | "md" | "lg";
   invalid?: boolean;
   disabled?: boolean;
   onValueChange?: (value: string[]) => void;
@@ -13865,7 +13894,7 @@ export interface CheckboxGroupProps extends HTMLAttributes<HTMLDivElement> {
  * the field context, so the invalid and disabled states a Form routes to
  * its name dress every box at once.
  */
-export declare function CheckboxGroup({ value, options, layout, invalid, disabled, onValueChange, ...rest }: CheckboxGroupProps): import("react").JSX.Element;
+export declare function CheckboxGroup({ value, options, layout, size, invalid, disabled, onValueChange, ...rest }: CheckboxGroupProps): import("react").JSX.Element;
 //#endregion
 //#region src/components/chip/index.d.ts
 /** A counting coin: the numeric value, capped at `max` with an ellipsis
@@ -13883,7 +13912,15 @@ export declare function Chip({ value, max, tone, variant, ...rest }: ChipProps):
  * field beside an icon-sized copy trigger whose ink turns bamboo while the
  * copy is confirmed. The API is Ark's own — Root, Label, Control, Input,
  * Trigger, Indicator, Context, HiddenInput. */
-export declare const Clipboard: typeof Clipboard$1;
+type ClipboardRootProps = ComponentProps<typeof Clipboard$1.Root> & {
+  /** One rung of the control-height ladder for the value field and
+   * its copy seal. */
+  size?: "sm" | "md" | "lg";
+};
+declare function ClipboardRoot({ size, ...rest }: ClipboardRootProps): import("react").JSX.Element;
+export declare const Clipboard: Omit<typeof Clipboard$1, "Root"> & {
+  Root: typeof ClipboardRoot;
+};
 //#endregion
 //#region src/components/collapsible/index.d.ts
 /** Ark's Collapsible, dressed in the paper-and-ink system: one control on
@@ -13892,6 +13929,11 @@ export declare const Clipboard: typeof Clipboard$1;
 export declare const Collapsible: typeof Collapsible$1;
 //#endregion
 //#region src/components/color-picker/index.d.ts
+type ColorPickerRootProps = ComponentProps<typeof ColorPicker$1.Root> & {
+  /** One rung of the control-height ladder for the swatch seal. */
+  size?: "sm" | "md" | "lg";
+};
+declare function ColorPickerRoot({ size, ...rest }: ColorPickerRootProps): import("react").JSX.Element;
 /** Ark's ColorPicker, dressed in the paper-and-ink system: a seal-sized swatch
  * on the paper, opening into an area and channel sliders where pigment is
  * picked. The API is Ark's own — Root, Label, Control, Trigger, Positioner,
@@ -13900,7 +13942,9 @@ export declare const Collapsible: typeof Collapsible$1;
  * ChannelSliderValueText, ChannelInput, TransparencyGrid, SwatchGroup,
  * SwatchTrigger, SwatchIndicator, Swatch, EyeDropperTrigger, FormatTrigger,
  * FormatSelect, HiddenInput, Context. */
-export declare const ColorPicker: typeof ColorPicker$1;
+export declare const ColorPicker: Omit<typeof ColorPicker$1, "Root"> & {
+  Root: typeof ColorPickerRoot;
+};
 //#endregion
 //#region src/components/combobox/index.d.ts
 /** Ark's Combobox, dressed in the paper-and-ink system: the field carries
@@ -13908,7 +13952,14 @@ export declare const ColorPicker: typeof ColorPicker$1;
  * checked row taking the flat ink fill. The API is Ark's own — Root, Label,
  * Control, Input, Trigger, ClearTrigger, Positioner, Content, List, Empty,
  * Item, ItemText, ItemIndicator, ItemGroup, ItemGroupLabel. */
-export declare const Combobox: typeof Combobox$1;
+type ComboboxOwnProps = {
+  /** One rung of the control-height ladder for the field row. */
+  size?: "sm" | "md" | "lg";
+};
+declare function ComboboxRoot<T extends CollectionItem$1>(props: ComboboxRootComponentProps<T, ComboboxOwnProps>): import("react").JSX.Element;
+export declare const Combobox: Omit<typeof Combobox$1, "Root"> & {
+  Root: typeof ComboboxRoot;
+};
 //#endregion
 //#region src/components/command/index.d.ts
 export interface CommandEntry {
@@ -14020,20 +14071,34 @@ export interface ContainerProps extends HTMLAttributes<HTMLDivElement> {
 export declare function Container({ size, padding, ...rest }: ContainerProps): import("react").JSX.Element;
 //#endregion
 //#region src/components/date-input/index.d.ts
+type DateInputRootProps = ComponentProps<typeof DateInput$1.Root> & {
+  /** One rung of the control-height ladder for the segmented field. */
+  size?: "sm" | "md" | "lg";
+};
+declare function DateInputRoot({ size, ...rest }: DateInputRootProps): import("react").JSX.Element;
 /** Ark's DateInput, dressed in the paper-and-ink system: a segmented
  * field where the focused segment takes the flat ink fill. The API is
  * Ark's own — Root, Label, Control, SegmentGroup, Segment, SegmentContext,
  * HiddenInput. */
-export declare const DateInput: typeof DateInput$1;
+export declare const DateInput: Omit<typeof DateInput$1, "Root"> & {
+  Root: typeof DateInputRoot;
+};
 //#endregion
 //#region src/components/date-picker/index.d.ts
+type DatePickerRootProps$1 = ComponentProps<typeof DatePicker$1.Root> & {
+  /** One rung of the control-height ladder for the field row. */
+  size?: "sm" | "md" | "lg";
+};
+declare function DatePickerRoot({ size, ...rest }: DatePickerRootProps$1): import("react").JSX.Element;
 /** Ark's DatePicker, dressed in the paper-and-ink system: the popup
  * dissolves in on elevation, selected days take the flat ink fill, and
  * range middles run subtle with cut corners. The API is Ark's own —
  * Root, Label, Control, Input, Trigger, ClearTrigger, Positioner,
  * Content, View, ViewControl, ViewTrigger, RangeText, PrevTrigger,
  * NextTrigger, Table*, MonthSelect, YearSelect, PresetTrigger. */
-export declare const DatePicker: typeof DatePicker$1;
+export declare const DatePicker: Omit<typeof DatePicker$1, "Root"> & {
+  Root: typeof DatePickerRoot;
+};
 //#endregion
 //#region src/components/descriptions/index.d.ts
 /** A ledger laid flat: term and detail pairs in one quiet grid. The
@@ -14087,6 +14152,8 @@ export interface DynamicInputProps extends HTMLAttributes<HTMLDivElement> {
   addLabel?: string;
   disabled?: boolean;
   invalid?: boolean;
+  /** One rung of the ladder, handed to every row's field and seals. */
+  size?: "sm" | "md" | "lg";
   onValueChange?: (value: string[]) => void;
 }
 /**
@@ -14097,14 +14164,21 @@ export interface DynamicInputProps extends HTMLAttributes<HTMLDivElement> {
  * grows past `max`, and the group always keeps one row: an entry list
  * that emptied itself would leave the reader no place to type.
  */
-export declare function DynamicInput({ value, min, max, placeholder, addLabel, disabled, invalid, onValueChange, children: _children, ...rest }: DynamicInputProps): import("react").JSX.Element;
+export declare function DynamicInput({ value, min, max, placeholder, addLabel, disabled, invalid, size, onValueChange, children: _children, ...rest }: DynamicInputProps): import("react").JSX.Element;
 //#endregion
 //#region src/components/editable/index.d.ts
 /** Ark's Editable, dressed in the paper-and-ink system: bare ink while
  * reading, the full field recipe while editing. The API is Ark's own —
  * Root, Area, Label, Preview, Input, EditTrigger, SubmitTrigger,
  * CancelTrigger, Control. */
-export declare const Editable: typeof Editable$1;
+type EditableRootProps = ComponentProps<typeof Editable$1.Root> & {
+  /** One rung of the control-height ladder for the editing field. */
+  size?: "sm" | "md" | "lg";
+};
+declare function EditableRoot({ size, ...rest }: EditableRootProps): import("react").JSX.Element;
+export declare const Editable: Omit<typeof Editable$1, "Root"> & {
+  Root: typeof EditableRoot;
+};
 //#endregion
 //#region src/components/ellipsis/index.d.ts
 /** The overflow knife: text cut at one line, or held to N lines. The
@@ -14156,19 +14230,30 @@ export declare const Field: typeof Field$1;
 export declare const Fieldset: typeof Fieldset$1;
 //#endregion
 //#region src/components/file-upload/index.d.ts
+type FileUploadRootProps = ComponentProps<typeof FileUpload$1.Root> & {
+  /** One rung of the control-height ladder for the trigger. */
+  size?: "sm" | "md" | "lg";
+};
+declare function FileUploadRoot({ size, ...rest }: FileUploadRootProps): import("react").JSX.Element;
 /** Ark's FileUpload, dressed in the paper-and-ink system: a dashed
  * dropzone that floods with subtle light on drag-over, and accepted files
  * as loose hairline slips. The API is Ark's own — Root, Label, Trigger,
  * Dropzone, HiddenInput, ItemGroup, Item, ItemName, ItemSizeText,
  * ItemPreview, ItemPreviewImage, ItemDeleteTrigger, ClearTrigger,
  * Context. */
-export declare const FileUpload: typeof FileUpload$1;
+export declare const FileUpload: Omit<typeof FileUpload$1, "Root"> & {
+  Root: typeof FileUploadRoot;
+};
 //#endregion
 //#region src/components/float-button/index.d.ts
 export type FloatButtonPlacement = "bottom-end" | "bottom-start" | "top-end" | "top-start";
+export type FloatButtonSize = "sm" | "md" | "lg";
 /** The group's openness, shared from the mooring to its parts. */
 export interface FloatButtonContextValue {
   open: boolean;
+  /** The group's button rung; the trigger takes it whole, the items
+   * step down one. */
+  size: FloatButtonSize;
   toggle: () => void;
   /** Folds the fan — an Item calls this once its action fires, the way
    * a speed dial closes after a choice. */
@@ -14184,6 +14269,8 @@ export interface FloatButtonRootProps extends HTMLAttributes<HTMLDivElement> {
   open?: boolean;
   /** Which corner the group moors at. */
   placement?: FloatButtonPlacement;
+  /** One rung of the button ladder for the whole group. */
+  size?: FloatButtonSize;
   onOpenChange?: (open: boolean) => void;
   children?: ReactNode;
 }
@@ -14196,7 +14283,7 @@ export interface FloatButtonRootProps extends HTMLAttributes<HTMLDivElement> {
  * (vessels here: round); this family owns only the mooring, the fan
  * and the fold.
  */
-declare function Root$2({ open: openProp, placement, onOpenChange, children, ...rest }: FloatButtonRootProps): import("react").JSX.Element;
+declare function Root$2({ open: openProp, placement, size, onOpenChange, children, ...rest }: FloatButtonRootProps): import("react").JSX.Element;
 declare function Trigger({ label, children }: {
   label?: string;
   children?: ReactNode;
@@ -14343,7 +14430,8 @@ export declare const HoverCard: typeof HoverCard$1;
 //#region src/components/icon/index.d.ts
 /** The inkwell: a standard box that keeps any inline svg at its optical
  * measure and in the text's own ink — the icon carries no pigment and no
- * size of its own. Bring the glyph; it ships no set. */
+ * size of its own. Bring a glyph through `name` from the registry, or
+ * bring your own; the well renders either. */
 export interface IconProps extends HTMLAttributes<HTMLSpanElement> {
   /** Size steps follow the surrounding font size; `inherit` is the
    * default — one em of the text the icon sits in. */
@@ -14351,8 +14439,11 @@ export interface IconProps extends HTMLAttributes<HTMLSpanElement> {
   /** The accessible name. Without it the icon is presentation-only and
    * hidden from the accessibility tree. */
   label?: string;
+  /** A glyph from the registry. Ignored when children are given — an
+   * explicit glyph always wins over the registry. */
+  name?: string;
 }
-export declare function Icon({ size, label, children, ...rest }: IconProps): import("react").JSX.Element;
+export declare function Icon({ size, label, name, children, ...rest }: IconProps): import("react").JSX.Element;
 //#endregion
 //#region src/components/image/index.d.ts
 /** A framed picture: while the source loads, the frame keeps the
@@ -14552,7 +14643,14 @@ export declare const List: typeof Root & {
  * Ark's own — Root, Label, Input, Content, Empty, Item, ItemText,
  * ItemIndicator, ItemGroup, ItemGroupLabel, ValueText, plus
  * createListCollection. */
-export declare const Listbox: typeof Listbox$1;
+type ListboxOwnProps = {
+  /** One rung of the ladder for the row register and the filter field. */
+  size?: "sm" | "md" | "lg";
+};
+declare function ListboxRoot<T extends CollectionItem$1>(props: ListboxRootComponentProps<T, ListboxOwnProps>): import("react").JSX.Element;
+export declare const Listbox: Omit<typeof Listbox$1, "Root"> & {
+  Root: typeof ListboxRoot;
+};
 //#endregion
 //#region src/components/marquee/index.d.ts
 /** Ark's Marquee, dressed in the paper-and-ink system: a linear ribbon of
@@ -14571,12 +14669,23 @@ export interface MasonryProps extends HTMLAttributes<HTMLDivElement> {
 export declare function Masonry({ columns, gap, ...rest }: MasonryProps): import("react").JSX.Element;
 //#endregion
 //#region src/components/menu/index.d.ts
+type MenuRootProps = Parameters<typeof Menu$1.Root>[0] & {
+  /** One rung of the control-height ladder for the vessel's rows. */
+  size?: "sm" | "md" | "lg";
+};
+declare function MenuRoot({ size, ...rest }: MenuRootProps): import("react").JSX.Element;
+declare function MenuContent(props: Parameters<typeof Menu$1.Content>[0]): import("react").JSX.Element;
 /** Ark's Menu, dressed in the paper-and-ink system: a quiet paper vessel on
  * elevation, hover as light on the row, checked items as the flat ink fill.
- * The API is Ark's own — Root, Trigger, ContextTrigger, Indicator, Positioner,
+ * The parts — Root, Trigger, ContextTrigger, Indicator, Positioner,
  * Content, Item, ItemText, ItemIndicator, ItemGroup, ItemGroupLabel,
- * TriggerItem, Separator, Arrow, ArrowTip. */
-export declare const Menu: typeof Menu$1;
+ * TriggerItem, Separator, Arrow, ArrowTip. Ark's namespace is frozen —
+ * spread copies the members so Root and Content can be the sized
+ * wrappers while the rest stay Ark's own parts. */
+export declare const Menu: Omit<typeof Menu$1, "Root" | "Content"> & {
+  Root: typeof MenuRoot;
+  Content: typeof MenuContent;
+};
 //#endregion
 //#region src/components/menubar/index.d.ts
 export interface MenubarEntry {
@@ -14617,10 +14726,12 @@ export interface MeterRootProps extends HTMLAttributes<HTMLElement> {
   max?: number;
   /** The pigment the ink rides: primary unless a threshold is crossed. */
   level?: "normal" | "success" | "warning" | "danger";
+  /** One rung of the groove ladder — the track's thickness. */
+  size?: "sm" | "md" | "lg";
   label?: string;
 }
-export declare const Meter: (({ value, min, max, level, label, children, ...rest }: MeterRootProps) => import("react").JSX.Element) & {
-  Root: ({ value, min, max, level, label, children, ...rest }: MeterRootProps) => import("react").JSX.Element;
+export declare const Meter: (({ value, min, max, level, size, label, children, ...rest }: MeterRootProps) => import("react").JSX.Element) & {
+  Root: ({ value, min, max, level, size, label, children, ...rest }: MeterRootProps) => import("react").JSX.Element;
   Label: {
     ({ children, ...rest }: HTMLAttributes<HTMLElement>): import("react").JSX.Element;
     displayName: string;
@@ -14640,33 +14751,61 @@ export declare const Meter: (({ value, min, max, level, label, children, ...rest
 export declare const NavigationMenu: typeof NavigationMenu$1;
 //#endregion
 //#region src/components/number-input/index.d.ts
+type NumberInputRootProps = ComponentProps<typeof NumberInput$1.Root> & {
+  /** One rung of the control-height ladder for the field and its stepper. */
+  size?: "sm" | "md" | "lg";
+};
+declare function NumberInputRoot({ size, ...rest }: NumberInputRootProps): import("react").JSX.Element;
 /** Ark's NumberInput, dressed in the paper-and-ink system: the stepper
  * rides inside the field as one seal split by a hairline, numbers set in
  * tabular figures. The API is Ark's own — Root, Label, Control, Input,
  * ValueText, IncrementTrigger, DecrementTrigger, Scrubber. */
-export declare const NumberInput: typeof NumberInput$1;
+export declare const NumberInput: Omit<typeof NumberInput$1, "Root"> & {
+  Root: typeof NumberInputRoot;
+};
 //#endregion
 //#region src/components/pagination/index.d.ts
+type PaginationRootProps = ComponentProps<typeof Pagination$1.Root> & {
+  /** One rung of the control-height ladder every page seal shares. */
+  size?: "sm" | "md" | "lg";
+};
+declare function PaginationRoot({ size, ...rest }: PaginationRootProps): import("react").JSX.Element;
 /**
  * Pagination — paged navigation.
  *
  * Parts: Root, Item (page seals), Ellipsis, PrevTrigger, NextTrigger,
  * FirstTrigger, LastTrigger. Items carry data-selected.
  */
-export declare const Pagination: typeof Pagination$1;
+export declare const Pagination: Omit<typeof Pagination$1, "Root"> & {
+  Root: typeof PaginationRoot;
+};
 //#endregion
 //#region src/components/password-input/index.d.ts
+type PasswordInputRootProps = ComponentProps<typeof PasswordInput$1.Root> & {
+  /** One rung of the control-height ladder for the field and its eye. */
+  size?: "sm" | "md" | "lg";
+};
+declare function PasswordInputRoot({ size, ...rest }: PasswordInputRootProps): import("react").JSX.Element;
 /** Ark's PasswordInput, dressed in the paper-and-ink system: the reveal
  * eye sits quiet at the field's edge and swaps in place — no shift, no
  * noise. The API is Ark's own — Root, Label, Control, Input, Indicator,
  * VisibilityTrigger. */
-export declare const PasswordInput: typeof PasswordInput$1;
+export declare const PasswordInput: Omit<typeof PasswordInput$1, "Root"> & {
+  Root: typeof PasswordInputRoot;
+};
 //#endregion
 //#region src/components/pin-input/index.d.ts
+type PinInputRootProps = ComponentProps<typeof PinInput$1.Root> & {
+  /** One rung of the control-height ladder each seal stands on. */
+  size?: "sm" | "md" | "lg";
+};
+declare function PinInputRoot({ size, ...rest }: PinInputRootProps): import("react").JSX.Element;
 /** Ark's PinInput, dressed in the paper-and-ink system: one character per
  * square-cut seal, centered ink in tabular figures. The API is Ark's own —
  * Root, Label, Control, Input, HiddenInput. */
-export declare const PinInput: typeof PinInput$1;
+export declare const PinInput: Omit<typeof PinInput$1, "Root"> & {
+  Root: typeof PinInputRoot;
+};
 //#endregion
 //#region src/components/popconfirm/index.d.ts
 /**
@@ -14695,11 +14834,18 @@ export declare function Popconfirm({ message, confirmText, cancelText, children,
 export declare const Popover: typeof Popover$1;
 //#endregion
 //#region src/components/progress/index.d.ts
+type ProgressRootProps = ComponentProps<typeof Progress$1.Root> & {
+  /** One rung of the groove ladder — the track's thickness. */
+  size?: "sm" | "md" | "lg";
+};
+declare function ProgressRoot({ size, ...rest }: ProgressRootProps): import("react").JSX.Element;
 /** Ark's Progress, dressed in the paper-and-ink system: a quiet hairline
  * groove that the primary ink fills at the machine's pace. The API is
  * Ark's own — Root, Label, ValueText, Track, Range, View, Circle,
  * CircleTrack, CircleRange. */
-export declare const Progress: typeof Progress$1;
+export declare const Progress: Omit<typeof Progress$1, "Root"> & {
+  Root: typeof ProgressRoot;
+};
 //#endregion
 //#region src/components/progress-group/index.d.ts
 /** One verdict on the bar. */
@@ -14730,18 +14876,32 @@ export declare function ProgressGroup({ segments, max, showLegend, ...rest }: Pr
 export declare const QrCode: typeof QrCode$1;
 //#endregion
 //#region src/components/radio-group/index.d.ts
+type RadioGroupRootProps = ComponentProps<typeof RadioGroup$1.Root> & {
+  /** One rung for the dial; the chosen dot rides it. */
+  size?: "sm" | "md" | "lg";
+};
+declare function RadioGroupRoot({ size, ...rest }: RadioGroupRootProps): import("react").JSX.Element;
 /** Ark's RadioGroup, dressed in the paper-and-ink system: a column of
  * full-circle seals that fill flat with primary ink when chosen, the dot
  * punched through as paper. The API is Ark's own — Root, Label, Item,
  * ItemText, ItemControl, Indicator, ItemHiddenInput. */
-export declare const RadioGroup: typeof RadioGroup$1;
+export declare const RadioGroup: Omit<typeof RadioGroup$1, "Root"> & {
+  Root: typeof RadioGroupRoot;
+};
 //#endregion
 //#region src/components/rating-group/index.d.ts
+type RatingGroupRootProps = ComponentProps<typeof RatingGroup$1.Root> & {
+  /** One rung of the control-height ladder every seal stands on. */
+  size?: "sm" | "md" | "lg";
+};
+declare function RatingGroupRoot({ size, ...rest }: RatingGroupRootProps): import("react").JSX.Element;
 /** Ark's RatingGroup, dressed in the paper-and-ink system: a row of quiet
  * seals whose glyphs take the primary pigment as they light up. The API is
  * Ark's own — Root, Label, Control, Item, HiddenInput (plus the Context and
  * ItemContext render helpers). */
-export declare const RatingGroup: typeof RatingGroup$1;
+export declare const RatingGroup: Omit<typeof RatingGroup$1, "Root"> & {
+  Root: typeof RatingGroupRoot;
+};
 //#endregion
 //#region src/components/scroll-area/index.d.ts
 /** Ark's ScrollArea, dressed in the paper-and-ink system: native bars
@@ -14750,11 +14910,20 @@ export declare const RatingGroup: typeof RatingGroup$1;
 export declare const ScrollArea: typeof ScrollArea$1;
 //#endregion
 //#region src/components/segment-group/index.d.ts
-/** Ark's SegmentGroup, dressed in the paper-and-ink system: a hairline tray
- * where one flat ink plate travels beneath the checked seal. The API is
- * Ark's own — Root, Label, Indicator, Item, ItemText, ItemControl,
+type SegmentGroupRootProps = ComponentProps<typeof SegmentGroup$1.Root> & {
+  /** One rung of the control-height ladder for the segments. The
+   * family keeps its compact register, so the rungs sit one notch
+   * below the global ladder - the default md rests at the small
+   * height. */
+  size?: "sm" | "md" | "lg";
+};
+declare function SegmentGroupRoot({ size, ...rest }: SegmentGroupRootProps): import("react").JSX.Element;
+/** SegmentGroup, dressed in the paper-and-ink system: a hairline tray
+ * where one flat ink plate travels beneath the checked seal. The parts - Root, Label, Indicator, Item, ItemText, ItemControl,
  * ItemHiddenInput. */
-export declare const SegmentGroup: typeof SegmentGroup$1;
+export declare const SegmentGroup: Omit<typeof SegmentGroup$1, "Root"> & {
+  Root: typeof SegmentGroupRoot;
+};
 //#endregion
 //#region src/components/select/index.d.ts
 /** Ark's Select, dressed in the paper-and-ink system: the trigger is the
@@ -14762,7 +14931,14 @@ export declare const SegmentGroup: typeof SegmentGroup$1;
  * row taking the flat ink fill. The API is Ark's own — Root, Label, Control,
  * Trigger, ValueText, Indicator, ClearTrigger, HiddenSelect, Positioner,
  * Content, List, Item, ItemText, ItemIndicator, ItemGroup, ItemGroupLabel. */
-export declare const Select: typeof Select$1;
+type SelectOwnProps = {
+  /** One rung of the control-height ladder for the trigger. */
+  size?: "sm" | "md" | "lg";
+};
+declare function SelectRoot<T extends CollectionItem$1>(props: SelectRootComponentProps<T, SelectOwnProps>): import("react").JSX.Element;
+export declare const Select: Omit<typeof Select$1, "Root"> & {
+  Root: typeof SelectRoot;
+};
 //#endregion
 //#region src/components/separator/index.d.ts
 /** The paper-ink hairline as a component: a named rule between sections.
@@ -14788,11 +14964,18 @@ export type SkeletonProps = HTMLAttributes<HTMLDivElement>;
 export declare function Skeleton({ ...rest }: SkeletonProps): import("react").JSX.Element;
 //#endregion
 //#region src/components/slider/index.d.ts
+type SliderRootProps = ComponentProps<typeof Slider$1.Root> & {
+  /** One rung of the part-size ladder for the thumb seal. */
+  size?: "sm" | "md" | "lg";
+};
+declare function SliderRoot({ size, ...rest }: SliderRootProps): import("react").JSX.Element;
 /** Ark's Slider, dressed in the paper-and-ink system: a recessed track the
  * primary ink runs along, a paper-seal thumb, and hairline tick markers.
  * The API is Ark's own — Root, Label, ValueText, Control, Track, Range,
  * Thumb, MarkerGroup, Marker, DraggingIndicator, HiddenInput. */
-export declare const Slider: typeof Slider$1;
+export declare const Slider: Omit<typeof Slider$1, "Root"> & {
+  Root: typeof SliderRoot;
+};
 //#endregion
 //#region src/components/split-button/index.d.ts
 export interface SplitButtonEntry {
@@ -14913,6 +15096,11 @@ export declare const Stat: {
 };
 //#endregion
 //#region src/components/steps/index.d.ts
+type StepsRootProps = ComponentProps<typeof Steps$1.Root> & {
+  /** One rung of the control-height ladder every indicator stands on. */
+  size?: "sm" | "md" | "lg";
+};
+declare function StepsRoot({ size, ...rest }: StepsRootProps): import("react").JSX.Element;
 /**
  * Steps — linear progress through a sequence.
  *
@@ -14920,7 +15108,9 @@ export declare const Stat: {
  * PrevTrigger, NextTrigger, Progress. Indicator and Separator carry
  * data-complete / data-current / data-incomplete.
  */
-export declare const Steps: typeof Steps$1;
+export declare const Steps: Omit<typeof Steps$1, "Root"> & {
+  Root: typeof StepsRoot;
+};
 //#endregion
 //#region src/components/swap/index.d.ts
 /** Ark's Swap, dressed in the paper-and-ink system: two impressions
@@ -14930,28 +15120,49 @@ export declare const Steps: typeof Steps$1;
 export declare const Swap: typeof Swap$1;
 //#endregion
 //#region src/components/switch/index.d.ts
+type SwitchRootProps = ComponentProps<typeof Switch$1.Root> & {
+  /** One rung for the thumb; the track travels with it. */
+  size?: "sm" | "md" | "lg";
+};
+declare function SwitchRoot({ size, ...rest }: SwitchRootProps): import("react").JSX.Element;
 /** Ark's Switch, dressed in the paper-and-ink system: a track that rests
  * in the inset shade of the paper and fills flat with primary ink when on,
  * the thumb sliding on the spring. The API is Ark's own — Root, Label,
  * Control, Thumb, HiddenInput. */
-export declare const Switch: typeof Switch$1;
+export declare const Switch: Omit<typeof Switch$1, "Root"> & {
+  Root: typeof SwitchRoot;
+};
 //#endregion
 //#region src/components/tabs/index.d.ts
+type TabsRootProps = ComponentProps<typeof Tabs$1.Root> & {
+  /** One rung of the control-height ladder for the tab rows. */
+  size?: "sm" | "md" | "lg";
+};
+declare function TabsRoot({ size, ...rest }: TabsRootProps): import("react").JSX.Element;
 /**
  * Tabs — tabbed navigation.
  *
  * Parts: Root, List, Trigger, Content, Indicator (machine-positioned ink
  * bar on the list rule).
  */
-export declare const Tabs: typeof Tabs$1;
+export declare const Tabs: Omit<typeof Tabs$1, "Root"> & {
+  Root: typeof TabsRoot;
+};
 //#endregion
 //#region src/components/tags-input/index.d.ts
+type TagsInputRootProps = ComponentProps<typeof TagsInput$1.Root> & {
+  /** One rung of the control-height ladder for the vessel at rest. */
+  size?: "sm" | "md" | "lg";
+};
+declare function TagsInputRoot({ size, ...rest }: TagsInputRootProps): import("react").JSX.Element;
 /** Ark's TagsInput, dressed in the paper-and-ink system: one field vessel
  * whose chips rest as quiet ink and lift only a tone when edited. The API
  * is Ark's own — Root, Label, Control, Input, ClearTrigger, Item,
  * ItemPreview, ItemText, ItemInput, ItemDeleteTrigger, HiddenInput,
  * Context. */
-export declare const TagsInput: typeof TagsInput$1;
+export declare const TagsInput: Omit<typeof TagsInput$1, "Root"> & {
+  Root: typeof TagsInputRoot;
+};
 //#endregion
 //#region src/components/table/index.d.ts
 /** Column metadata understood by this table: mark columns whose values
@@ -15125,10 +15336,17 @@ export declare const Typography: {
 };
 //#endregion
 //#region src/components/toggle-group/index.d.ts
+type ToggleGroupRootProps = ComponentProps<typeof ToggleGroup$1.Root> & {
+  /** One rung of the control-height ladder for the items. */
+  size?: "sm" | "md" | "lg";
+};
+declare function ToggleGroupRoot({ size, ...rest }: ToggleGroupRootProps): import("react").JSX.Element;
 /** Ark's ToggleGroup, dressed in the paper-and-ink system: a hairline tray
  * of quiet seals where the pressed item takes the flat ink fill. The API is
  * Ark's own — Root, Item. */
-export declare const ToggleGroup: typeof ToggleGroup$1;
+export declare const ToggleGroup: Omit<typeof ToggleGroup$1, "Root"> & {
+  Root: typeof ToggleGroupRoot;
+};
 //#endregion
 //#region src/components/tooltip/index.d.ts
 /** Ark's Tooltip, dressed in the paper-and-ink system: the smallest
@@ -15187,9 +15405,12 @@ export interface TreeSelectProps extends HTMLAttributes<HTMLDivElement> {
   placeholder?: string;
   filterable?: boolean;
   disabled?: boolean;
+  /** One rung of the ladder: the trigger height and the vessel's row
+   * register follow it together. */
+  size?: "sm" | "md" | "lg";
   onValueChange?: (value: string) => void;
 }
-export declare function TreeSelect({ value, data, placeholder, filterable, disabled, onValueChange, ...rest }: TreeSelectProps): import("react").JSX.Element;
+export declare function TreeSelect({ value, data, placeholder, filterable, disabled, size, onValueChange, ...rest }: TreeSelectProps): import("react").JSX.Element;
 //#endregion
 //#region src/components/tree-view/index.d.ts
 /** Ark's TreeView, dressed in the paper-and-ink system: quiet rows where
@@ -15199,7 +15420,14 @@ export declare function TreeSelect({ value, data, placeholder, filterable, disab
  * BranchTrigger, BranchIndicator, BranchText, BranchContent,
  * BranchIndentGuide, Item, ItemText, ItemIndicator, NodeCheckbox,
  * NodeRenameInput, plus createTreeCollection. */
-export declare const TreeView: typeof TreeView$1;
+type TreeViewOwnProps = {
+  /** One rung of the row register: the rows' breathing room follows it. */
+  size?: "sm" | "md" | "lg";
+};
+declare function TreeViewRoot<T extends CollectionItem$1>(props: TreeViewRootComponentProps<T, TreeViewOwnProps>): import("react").JSX.Element;
+export declare const TreeView: Omit<typeof TreeView$1, "Root"> & {
+  Root: typeof TreeViewRoot;
+};
 //#endregion
 //#region src/components/watermark/index.d.ts
 export interface WatermarkProps extends HTMLAttributes<HTMLDivElement> {
@@ -15216,4 +15444,4 @@ export interface WatermarkProps extends HTMLAttributes<HTMLDivElement> {
  */
 export declare function Watermark({ content, opacity, rotate, fontSize, children, ...rest }: WatermarkProps): import("react").JSX.Element;
 //#endregion
-export { Action as AiAction, Attachment as AiAttachment, Attachments as AiAttachments, Message as AiMessage, PromptInput as AiPromptInput, Reasoning as AiReasoning, Response$1 as AiResponse, Response$1 as Response, Source as AiSource, Sources as AiSources, Suggestion as AiSuggestion, Tool as AiTool, Card$1 as Card, ClientOnly, type ClientOnlyProps, type CollectionItem, type CollectionOptions, type ColumnDef, type CreateToasterReturn, type DataUIPart, type DateInputFocusChangeDetails, type DateInputValueChangeDetails, type DatePickerFocusChangeDetails, type DatePickerOpenChangeDetails, type DatePickerValueChangeDetails, type DatePickerViewChangeDetails, type DatePickerVisibleRangeChangeDetails, type DialogOpenChangeDetails, DownloadTrigger, type DownloadTriggerBaseProps, type DownloadTriggerProps, type DownloadableData, type FilePathTreeNode, type FileUIPart, type FlatTreeNode, FlexRender, FocusTrap, type FocusTrapBaseProps, type FocusTrapProps, type GridCollection, type GridCollectionOptions, type ListCollection, Presence, type PresenceBaseProps, type PresenceProps, PresenceProvider, type ReasoningUIPart, type SortingState, type SourceDocumentUIPart, type SourceUrlUIPart, type StepStartUIPart, type TextUIPart, type ToolUIPart, type TourInteractOutsideEvent, type TourPointerDownOutsideEvent, type TourStepDetails, type TreeCollection, type TreeCollectionOptions, type TreeNode, type TreeViewCheckedChangeDetails, type TreeViewExpandedChangeDetails, type TreeViewFocusChangeDetails, type TreeViewSelectionChangeDetails, type UIMessage, type UIMessagePart, type UseAsyncListProps, type UseAsyncListReturn, type UseDownloadProps, type UseDownloadReturn, type UseListCollectionProps, type UseListCollectionReturn, type UseListSelectionProps, type UseListSelectionReturn, type UseMentionsHandlers, type UseMentionsOptions, type UsePresenceContext, type UsePresenceProps, type UsePresenceReturn, createColumnHelper, createFileTreeCollection, createGridCollection, createToaster, createTreeCollection, useAsyncList, useDownload, useListCollection, useListSelection, usePresence, usePresenceContext, useTour };
+export { Action as AiAction, Attachment as AiAttachment, Attachments as AiAttachments, Message as AiMessage, PromptInput as AiPromptInput, Reasoning as AiReasoning, Response$1 as AiResponse, Response$1 as Response, Source as AiSource, Sources as AiSources, Suggestion as AiSuggestion, Tool as AiTool, Card$1 as Card, ClientOnly, type ClientOnlyProps, type CollectionItem, type CollectionOptions, type ColumnDef, type CreateToasterReturn, type DataUIPart, type DateInputFocusChangeDetails, type DateInputValueChangeDetails, type DatePickerFocusChangeDetails, type DatePickerOpenChangeDetails, type DatePickerValueChangeDetails, type DatePickerViewChangeDetails, type DatePickerVisibleRangeChangeDetails, type DialogOpenChangeDetails, DownloadTrigger, type DownloadTriggerBaseProps, type DownloadTriggerProps, type DownloadableData, type FilePathTreeNode, type FileUIPart, type FlatTreeNode, FlexRender, FocusTrap, type FocusTrapBaseProps, type FocusTrapProps, type GridCollection, type GridCollectionOptions, type ListCollection, Presence, type PresenceBaseProps, type PresenceProps, PresenceProvider, type ReasoningUIPart, type SortingState, type SourceDocumentUIPart, type SourceUrlUIPart, type StepStartUIPart, type TextUIPart, type ToolUIPart, type TourInteractOutsideEvent, type TourPointerDownOutsideEvent, type TourStepDetails, type TreeCollection, type TreeCollectionOptions, type TreeNode, type UIMessage, type UIMessagePart, type UseAsyncListProps, type UseAsyncListReturn, type UseDownloadProps, type UseDownloadReturn, type UseListCollectionProps, type UseListCollectionReturn, type UseListSelectionProps, type UseListSelectionReturn, type UseMentionsHandlers, type UseMentionsOptions, type UsePresenceContext, type UsePresenceProps, type UsePresenceReturn, createColumnHelper, createFileTreeCollection, createGridCollection, createToaster, createTreeCollection, useAsyncList, useDownload, useListCollection, useListSelection, usePresence, usePresenceContext, useTour };