@gunkin/uiify 0.0.13-alpha → 0.0.15-alpha

package/agents/reference/components/tags-input.md

@@ -0,0 +1,123 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# tags-input
+
+- Import: `@gunkin/uiify/components/tags-input`
+- Tier 2 (Client component — pre-hydration SSR); state source none; native element `input`
+- Without JavaScript: pre-hydration-only
+- Types file: `dist/components/tags-input.d.ts`
+
+## Exports
+
+- Runtime: `TagsInput`, `TagsInputInput`, `TagsInputList`, `TagsInputRoot`, `TagsInputTag`, `TagsInputTagRemove`, `splitTags`
+- Types: `TagsInputInputOwnProps`, `TagsInputInputProps`, `TagsInputRootControlledOwnProps`, `TagsInputRootShellOwnProps`, `TagsInputRootShellProps`, `TagsInputRootProps`, `TagsInputTagOwnProps`, `TagsInputTagProps`, `TagsInputStore`
+
+## Props and shapes
+
+### TagsInputStoreOptions
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `allowDuplicates` | `boolean` | no |  |
+| `maxTags` | `number` | no |  |
+| `validate` | `(tag: string) => boolean` | no |  |
+
+### TagsInputStore
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `addTag` | `(tag: string) => boolean` | yes |  |
+| `addTags` | `(nextTags: readonly string[]) => void` | yes |  |
+| `getTags` | `() => string[]` | yes |  |
+| `removeAt` | `(index: number) => void` | yes |  |
+| `removeLast` | `() => void` | yes |  |
+| `setTags` | `(next: readonly string[]) => void` | yes |  |
+| `subscribe` | `(listener: () => void) => () => void` | yes |  |
+| `updateOptions` | `(next: TagsInputStoreOptions) => void` | yes |  |
+
+### TagsInputContextValue
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `addOnPaste` | `boolean` | yes |  |
+| `addTag` | `(tag: string) => void` | yes |  |
+| `delimiters` | `readonly string[]` | yes |  |
+| `disabled` | `boolean` | yes |  |
+| `inputId` | `string` | yes |  |
+| `inputValue` | `string` | yes |  |
+| `listId` | `string` | yes |  |
+| `removeAt` | `(index: number) => void` | yes |  |
+| `setInputValue` | `(value: string) => void` | yes |  |
+| `store` | `TagsInputStore` | yes |  |
+
+### TagsInputRootShellOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `className` | `string` | no |  |
+| `addOnPaste` | `boolean` | no |  |
+| `allowDuplicates` | `boolean` | no |  |
+| `defaultValue` | `readonly string[]` | no |  |
+| `delimiters` | `readonly string[]` | no |  |
+| `disabled` | `boolean` | no |  |
+| `id` | `string` | no |  |
+| `items` | `readonly string[]` | no |  |
+| `maxTags` | `number` | no |  |
+| `validate` | `(tag: string) => boolean` | no |  |
+
+### TagsInputRootControlledOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `onValueChange` | `(tags: string[]) => void` | no |  |
+| `value` | `readonly string[]` | no |  |
+
+### TagsInputRootShellProps
+
+Extends: `TagsInputRootShellOwnProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+
+### TagsInputRootProps
+
+Extends: `TagsInputRootShellOwnProps`, `TagsInputRootControlledOwnProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+
+### TagsInputInputOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `className` | `string` | no |  |
+| `placeholder` | `string` | no |  |
+
+### TagsInputListOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+
+### TagsInputTagOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+| `index` | `number` | yes |  |
+| `value` | `string` | yes |  |
+
+### TagsInputTagRemoveOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `className` | `string` | no |  |
+| `index` | `number` | yes |  |
+
+## Other types
+
+- `TagsInputInputProps<TAs>`: `RenderableProps<TAs, TagsInputInputOwnProps, { disabled: boolean }, HTMLInputElement>`
+- `TagsInputTagProps<TAs>`: `RenderableProps<TAs, TagsInputTagOwnProps, { current: boolean }, HTMLElement>`

package/agents/reference/components/textarea.md

@@ -0,0 +1,31 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# textarea
+
+- Import: `@gunkin/uiify/components/textarea`
+- Tier 0 (RSC — zero client JavaScript); state source S1; native element `textarea`
+- Without JavaScript: full
+- Types file: `dist/components/textarea.d.ts`
+- Note: field-sizing:content replaces the auto-grow JS. Baseline since Firefox 152.
+
+## Exports
+
+- Runtime: `Textarea`
+- Types: `TextareaOwnProps`, `TextareaProps`
+
+## Props and shapes
+
+### TextareaOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `value` | `string` | no |  |
+| `defaultValue` | `string` | no |  |
+| `onValueChange` | `(value: string) => void` | no |  |
+| `autoSize` | `boolean` | no |  |
+| `disabled` | `boolean` | no |  |
+| `readOnly` | `boolean` | no |  |
+| `invalid` | `boolean` | no |  |
+
+## Other types
+
+- `TextareaProps<TAs>`: `RenderableProps<TAs, TextareaOwnProps, TextareaOwnProps, HTMLTextAreaElement>`

package/agents/reference/components/toast.md

@@ -0,0 +1,151 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# toast
+
+- Import: `@gunkin/uiify/components/toast`
+- Tier 1 (RSC shell + thin client island); state source S1; native element `[popover] + aria-live`
+- Without JavaScript: degraded-documented
+- Types file: `dist/components/toast.d.ts`
+
+## Exports
+
+- Runtime: `Toast`, `ToastAction`, `ToastClose`, `ToastDescription`, `ToastProvider`, `ToastRoot`, `ToastTitle`, `ToastViewport`, `useToast`
+- Types: `ToastActionOwnProps`, `ToastActionProps`, `ToastCloseOwnProps`, `ToastCloseProps`, `ToastDescriptionOwnProps`, `ToastProviderOwnProps`, `ToastRootOwnProps`, `ToastTitleOwnProps`, `ToastViewportOwnProps`, `ToastInput`, `ToastPriority`, `ToastRecord`, `ToastStore`
+
+## Values
+
+- `ToastPriority`: `"polite" | "assertive"`
+
+## Props and shapes
+
+### ToastAction
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `label` | `ReactNode` | yes |  |
+| `onClick` | `() => void` | yes |  |
+
+### ToastInput
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `action` | `ToastAction` | no |  |
+| `description` | `ReactNode` | no |  |
+| `duration` | `number` | no |  |
+| `id` | `string` | no |  |
+| `priority` | `ToastPriority` | no |  |
+| `title` | `ReactNode` | no |  |
+
+### ToastRecord
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `action` | `ToastAction` | no |  |
+| `description` | `ReactNode` | no |  |
+| `duration` | `number` | yes |  |
+| `id` | `string` | yes |  |
+| `priority` | `ToastPriority` | yes |  |
+| `title` | `ReactNode` | no |  |
+
+### TimerState
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `remaining` | `number` | yes |  |
+| `startedAt` | `number` | yes |  |
+| `timerId` | `ReturnType<typeof setTimeout> \| null` | yes |  |
+
+### ToastStoreOptions
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `limit` | `number` | no |  |
+
+### ToastStore
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `dismiss` | `(id: string) => void` | yes |  |
+| `enqueue` | `(input: ToastInput) => string` | yes |  |
+| `getAnnouncement` | `() => string` | yes |  |
+| `getAssertiveAnnouncement` | `() => string` | yes |  |
+| `getSnapshot` | `() => readonly ToastRecord[]` | yes |  |
+| `getServerSnapshot` | `() => readonly ToastRecord[]` | yes |  |
+| `pause` | `(id: string) => void` | yes |  |
+| `resume` | `(id: string) => void` | yes |  |
+| `subscribe` | `(listener: () => void) => () => void` | yes |  |
+
+### ToastContextValue
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `dismiss` | `(id: string) => void` | yes |  |
+| `pause` | `(id: string) => void` | yes |  |
+| `resume` | `(id: string) => void` | yes |  |
+| `store` | `ToastStore` | yes |  |
+
+### ToastProviderOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `limit` | `number` | no |  |
+
+### ToastViewportOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `"aria-label"` | `string` | no |  |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+| `popover` | `"manual"` | no | Set by the live client viewport (@gunkin/uiify/components/toast/Toast.js) to `"manual"` so the queue's rendered surface sits in the top layer. The structural shell (this file's own re-exported ToastViewport, used directly by "Toast server shell" tests and any no-JS render) leaves it unset, since there is no queue-driven show/hide to wire up there. |
+| `ref` | `Ref<HTMLElement>` | no |  |
+
+### ToastRootOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `toast` | `ToastRecord` | yes |  |
+
+### ToastTitleOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+
+### ToastDescriptionOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+
+### ToastActionOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+
+### ToastActionProps
+
+Extends: `ToastActionOwnProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `onClick` | `(event: MouseEvent<HTMLButtonElement>) => void` | no |  |
+
+### ToastCloseOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+
+### ToastCloseProps
+
+Extends: `ToastCloseOwnProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `onClick` | `(event: MouseEvent<HTMLButtonElement>) => void` | no |  |

package/agents/reference/components/toggle-group.md

@@ -0,0 +1,50 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# toggle-group
+
+- Import: `@gunkin/uiify/components/toggle-group`
+- Tier 0 (RSC — zero client JavaScript); state source S1; native element `input[type=radio|checkbox]`
+- Without JavaScript: full
+- Types file: `dist/components/toggle-group.d.ts`
+- Note: Built on @gunkin/uiify/elements/choice.
+
+## Exports
+
+- Runtime: `ToggleGroup`
+- Types: `ToggleGroupClientProps`, `ToggleGroupItem`, `ToggleGroupProps`
+
+## Props and shapes
+
+### ToggleGroupProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `id` | `string` | yes |  |
+| `type` | `"single" \| "multiple"` | no |  |
+| `items` | `readonly ToggleGroupItem[]` | yes |  |
+| `defaultValue` | `string \| readonly string[]` | no |  |
+| `disabled` | `boolean` | no |  |
+| `orientation` | `ChoiceOrientation` | no |  |
+| `size` | `"sm" \| "md" \| "lg"` | no | Button size of each item; `md` metrics when omitted. |
+| `className` | `string` | no |  |
+| `"aria-label"` | `string` | no |  |
+| `"aria-labelledby"` | `string` | no |  |
+
+### ToggleGroupClientProps
+
+Extends: `ToggleGroupProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `value` | `string \| readonly string[]` | no |  |
+| `onValueChange` | `(value: string \| readonly string[]) => void` | no |  |
+
+## Other types
+
+- `ToggleGroupItem`: `ChoiceItem`
+
+## Sub-entries
+
+### `@gunkin/uiify/components/toggle-group/client`
+
+- Runtime: `ToggleGroupClient`
+- Types: `ToggleGroupClientProps`

package/agents/reference/components/toggle.md

@@ -0,0 +1,26 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# toggle
+
+- Import: `@gunkin/uiify/components/toggle`
+- Tier 0 (RSC — zero client JavaScript); state source S1; native element `input[type=checkbox]`
+- Without JavaScript: full
+- Types file: `dist/components/toggle.d.ts`
+- Note: Native checkbox + label toggle; browser owns pressed state.
+
+## Exports
+
+- Runtime: `Toggle`
+- Types: `ToggleProps`
+
+## Props and shapes
+
+### ToggleProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `id` | `string` | yes |  |
+| `label` | `ReactNode` | yes |  |
+| `pressed` | `boolean` | no |  |
+| `defaultPressed` | `boolean` | no |  |
+| `disabled` | `boolean` | no |  |
+| `className` | `string` | no |  |

package/agents/reference/components/toolbar.md

@@ -0,0 +1,69 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# toolbar
+
+- Import: `@gunkin/uiify/components/toolbar`
+- Tier 1 (RSC shell + thin client island); state source none; native element `div[role=toolbar]`
+- Without JavaScript: degraded-documented
+- Types file: `dist/components/toolbar.d.ts`
+
+## Exports
+
+- Runtime: `Toolbar`
+- Types: `ToolbarButtonOwnProps`, `ToolbarButtonProps`, `ToolbarLinkOwnProps`, `ToolbarLinkProps`, `ToolbarRootOwnProps`, `ToolbarRootProps`, `ToolbarSeparatorOwnProps`, `ToolbarSeparatorProps`, `ToolbarToggleGroupProps`
+
+## Props and shapes
+
+### ToolbarRootOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `dir` | `Direction` | no |  |
+| `loop` | `boolean` | no |  |
+| `orientation` | `RovingFocusOrientation` | no |  |
+
+### ToolbarRootProps
+
+Extends: `ToolbarRootOwnProps`, `Omit<HTMLAttributes<HTMLDivElement>, keyof ToolbarRootOwnProps>`
+
+No own members.
+
+### ToolbarButtonOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `selected` | `boolean` | no | Toggle state of the button: reported as aria-pressed and styled as selected. |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+| `disabled` | `boolean` | no |  |
+
+### ToolbarButtonProps
+
+Extends: `ToolbarButtonOwnProps`, `Omit<HTMLAttributes<HTMLButtonElement>, keyof ToolbarButtonOwnProps | "disabled">`
+
+No own members.
+
+### ToolbarLinkOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+| `href` | `string` | yes |  |
+
+### ToolbarLinkProps
+
+Extends: `ToolbarLinkOwnProps`, `Omit<HTMLAttributes<HTMLAnchorElement>, keyof ToolbarLinkOwnProps | "href">`
+
+No own members.
+
+### ToolbarSeparatorOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `className` | `string` | no |  |
+| `orientation` | `"horizontal" \| "vertical"` | no |  |
+
+## Other types
+
+- `ToolbarSeparatorProps`: `ToolbarSeparatorOwnProps & Omit<HTMLAttributes<HTMLHRElement>, keyof ToolbarSeparatorOwnProps>`
+- `ToolbarToggleGroupProps`: `ToggleGroupProps`

package/agents/reference/components/tooltip.md

@@ -0,0 +1,76 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# tooltip
+
+- Import: `@gunkin/uiify/components/tooltip`
+- Tier 1 (RSC shell + thin client island); state source S1; native element `[popover]`
+- Without JavaScript: degraded-documented
+- Types file: `dist/components/tooltip.d.ts`
+
+## Exports
+
+- Runtime: `Tooltip`, `TooltipContent`, `TooltipProvider`, `TooltipRoot`, `TooltipTrigger`
+- Types: `TooltipContentOwnProps`, `TooltipContentProps`, `TooltipProviderOwnProps`, `TooltipRootOwnProps`, `TooltipRootProps`, `TooltipTriggerOwnProps`, `TooltipTriggerProps`
+
+## Props and shapes
+
+### TooltipProviderOptions
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `delayDuration` | `number` | yes |  |
+| `skipDelayDuration` | `number` | yes |  |
+
+### TooltipProviderStore
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `getDelayDuration` | `() => number` | yes |  |
+| `markOpened` | `() => void` | yes |  |
+| `shouldSkipDelay` | `() => boolean` | yes |  |
+| `updateOptions` | `(next: TooltipProviderOptions) => void` | yes |  |
+
+### TooltipProviderOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `delayDuration` | `number` | no |  |
+| `skipDelayDuration` | `number` | no |  |
+
+### TooltipRootOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `defaultOpen` | `boolean` | no |  |
+| `id` | `string` | no |  |
+| `onOpenChange` | `PopoverChangeHandler` | no |  |
+| `open` | `boolean` | no |  |
+
+### TooltipRootProps
+
+Extends: `TooltipRootOwnProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+
+### TooltipTriggerOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+
+### TooltipContentOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `align` | `AnchorAlign` | no |  |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+| `side` | `AnchorSide` | no |  |
+
+## Other types
+
+- `TooltipTriggerProps<TAs>`: `RenderableProps<TAs, TooltipTriggerOwnProps, { open: boolean }, HTMLElement>`
+- `TooltipContentProps<TAs>`: `RenderableProps<TAs, TooltipContentOwnProps, { open: boolean; positioning: "native" }, HTMLElement>`

package/agents/reference/components/virtual-scroll.md

@@ -0,0 +1,97 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# virtual-scroll
+
+- Import: `@gunkin/uiify/components/virtual-scroll`
+- Tier 2 (Client component — pre-hydration SSR); state source none; native element `div[overflow]`
+- Without JavaScript: pre-hydration-only
+- Types file: `dist/components/virtual-scroll.d.ts`
+
+## Exports
+
+- Runtime: `VirtualScroll`, `VIRTUAL_SCROLL_ANCHOR_THRESHOLD`, `VIRTUAL_SCROLL_OVERSCAN`, `VIRTUAL_SCROLL_ROW_HEIGHT`, `VIRTUAL_SCROLL_SCROLL_RESET_DELAY`
+- Types: `VirtualScrollAnchor`, `VirtualScrollHandle`, `VirtualScrollItem`, `VirtualScrollListRole`, `VirtualScrollOrientation`, `VirtualScrollOwnProps`, `VirtualScrollRangeChange`, `VirtualScrollRowSlot`, `VirtualScrollScrollAlign`, `VirtualScrollScrollBehavior`, `VirtualScrollScrollBehaviorOptions`, `VirtualScrollScrollState`, `VirtualScrollScrollToIndexOptions`
+
+## Values
+
+- `VirtualScrollListRole`: `"list" | "grid"`
+- `VirtualScrollAnchor`: `"start" | "end"`
+- `VirtualScrollOrientation`: `"vertical" | "horizontal"` — Scroll axis. Row size props (`rowHeight`, `estimateRowHeight`) measure along this axis.
+- `VirtualScrollScrollAlign`: `"start" | "center" | "end" | "auto"`
+- `VirtualScrollScrollBehavior`: `"auto" | "instant" | "smooth"`
+
+## Props and shapes
+
+### VirtualScrollItem
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `id` | `string` | yes |  |
+
+### VirtualScrollScrollBehaviorOptions
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `behavior` | `VirtualScrollScrollBehavior` | no |  |
+
+### VirtualScrollScrollToIndexOptions
+
+Extends: `VirtualScrollScrollBehaviorOptions`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `align` | `VirtualScrollScrollAlign` | no |  |
+
+### VirtualScrollRangeChange
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `startIndex` | `number` | yes | First visible row index (no overscan). |
+| `endIndex` | `number` | yes | Last visible row index, inclusive (no overscan). |
+| `overscanStart` | `number` | yes | First rendered row index including overscan. |
+| `overscanEnd` | `number` | yes | Last rendered row index, inclusive, including overscan. |
+
+### VirtualScrollScrollState
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `isScrolling` | `boolean` | yes |  |
+
+### VirtualScrollHandle
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `element` | `HTMLDivElement \| null` | yes |  |
+| `scrollToIndex` | `scrollToIndex(index: number, options?: VirtualScrollScrollToIndexOptions): void` | yes |  |
+| `scrollToOffset` | `scrollToOffset(offset: number, options?: VirtualScrollScrollBehaviorOptions): void` | yes |  |
+| `scrollToEnd` | `scrollToEnd(options?: VirtualScrollScrollBehaviorOptions): void` | yes |  |
+
+### VirtualScrollOwnProps
+
+Extends: `Omit<ComponentPropsWithoutRef<"div">, "children" | "role">`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `items` | `readonly T[]` | yes |  |
+| `height` | `number` | no | Scrollport height; also the viewport extent used before the first resize measurement. |
+| `rowHeight` | `number` | no | Fixed item size along the scroll axis — row height when vertical, item width when horizontal. |
+| `orientation` | `VirtualScrollOrientation` | no |  |
+| `overscan` | `number` | no |  |
+| `className` | `string` | no |  |
+| `testId` | `string` | no |  |
+| `renderRow` | `(item: T, index: number) => ReactNode` | yes |  |
+| `scrollRef` | `Ref<VirtualScrollHandle>` | no |  |
+| `estimateRowHeight` | `(index: number) => number` | no |  |
+| `onRangeChange` | `(range: VirtualScrollRangeChange) => void` | no |  |
+| `role` | `VirtualScrollListRole` | no |  |
+| `anchor` | `VirtualScrollAnchor` | no |  |
+| `followAppend` | `boolean \| "smooth"` | no |  |
+| `onScrollStateChange` | `(state: VirtualScrollScrollState) => void` | no |  |
+| `isScrollingResetDelay` | `number` | no |  |
+
+### VirtualScrollRowSlot
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `slotIndex` | `number` | yes |  |
+| `index` | `number` | yes |  |
+| `item` | `T \| null` | yes |  |

package/agents/reference/elements/choice.md

@@ -0,0 +1,55 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# choice
+
+- Import: `@gunkin/uiify/elements/choice`
+- Native mechanism: input[type=radio|checkbox] + label
+- Parts: `Choice.Group`, `Choice.Item`
+- Used by: radio-group, tabs, toggle-group, segmented-control, rating
+- Types file: `dist/elements/choice.d.ts`
+
+## Exports
+
+- Runtime: `Choice`, `ChoiceGroup`, `ChoiceItem`, `choiceGroupName`, `choiceIds`
+- Types: `ChoiceGroupOwnProps`, `ChoiceGroupProps`, `ChoiceItemOwnProps`, `ChoiceItemProps`, `ChoiceKind`, `ChoiceOrientation`
+
+## Values
+
+- `ChoiceKind`: `"single" | "multiple"` — `"single"` renders `type="radio"`; `"multiple"` renders `type="checkbox"`.
+- `ChoiceOrientation`: `"horizontal" | "vertical"`
+
+## Props and shapes
+
+### ChoiceGroupOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `id` | `string` | yes | Seeds every child `Choice.Item`'s derived ids and form-control name — pass the same value to each item's own `groupId`. Tier 0 bans `useContext`, so there is no implicit injection from Group to Item; this id is the explicit wiring, the same pattern `@gunkin/uiify/elements/dialog`'s `target` prop uses. |
+| `kind` | `ChoiceKind` | yes |  |
+| `orientation` | `ChoiceOrientation` | no |  |
+| `name` | `string` | no | Documents the derived `choiceGroupName(id, kind)` override every child `Choice.Item` should also receive as its own `name` — not read by `Choice.Group` itself (there is nowhere to inject it to without context), but declaring it here keeps the two in sync for anyone reading the JSX. |
+
+### ChoiceItemOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `value` | `string` | yes |  |
+| `label` | `ReactNode` | yes | Rendered inside the `<label>`. |
+| `panel` | `ReactNode` | no | When present, renders `<div data-part="panel">` as a sibling after the label. |
+| `groupId` | `string` | yes | The `Choice.Group.id` this item belongs to — see `ChoiceGroupOwnProps.id`. |
+| `kind` | `ChoiceKind` | yes |  |
+| `name` | `string` | no | Overrides the derived `choiceGroupName(groupId, kind)` form-control name. |
+| `defaultChecked` | `boolean` | no | The browser owns the state after first render. |
+| `checked` | `boolean` | no | Controlled checked state for client-enhanced choice groups. |
+| `disabled` | `boolean` | no |  |
+| `part` | `string` | no | Wrapper `data-part`. Defaults to `"item"`. |
+| `labelPart` | `boolean` | no | Adds `data-part="label"` to the `<label>`. |
+| `inputProps` | `Record<string, unknown>` | no | Escape hatch: extra attributes spread onto the `<input>` (for example, `data-part="control"`). |
+| `labelProps` | `Record<string, unknown>` | no | Escape hatch: extra attributes spread onto the `<label>`. |
+| `panelProps` | `Record<string, unknown>` | no | Escape hatch: extra attributes spread onto the panel `<div>`. |
+| `onValueChange` | `(value: string) => void` | no | Client-only: attaches to the input's native `change`. Passing it does not make this element a client component — the *caller* must already be one. Omitted by every uncontrolled (server) caller, so the server output stays handler-free. |
+
+## Other types
+
+- `ChoiceGroupProps`: `ChoiceGroupOwnProps & Omit<ComponentPropsWithRef<"div">, keyof ChoiceGroupOwnProps>`
+- `ChoiceItemProps`: `ChoiceItemOwnProps & Omit<ComponentPropsWithRef<"div">, keyof ChoiceItemOwnProps | "children">`