@gunkin/uiify 0.0.14-alpha → 0.0.16-alpha

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

@@ -0,0 +1,37 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# radio-group
+
+- Import: `@gunkin/uiify/components/radio-group`
+- Tier 0 (RSC — zero client JavaScript); state source S1; native element `input[type=radio]`
+- Without JavaScript: full
+- Types file: `dist/components/radio-group.d.ts`
+- Note: Data-driven native radio group; browser owns selection. Built on @gunkin/uiify/elements/choice.
+
+## Exports
+
+- Runtime: `RadioGroup`
+- Types: `RadioGroupItem`, `RadioGroupProps`
+
+## Props and shapes
+
+### RadioGroupItem
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `value` | `string` | yes |  |
+| `label` | `ReactNode` | yes |  |
+| `disabled` | `boolean` | no |  |
+| `className` | `string` | no |  |
+
+### RadioGroupProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `id` | `string` | yes |  |
+| `items` | `readonly RadioGroupItem[]` | yes |  |
+| `defaultValue` | `string` | no |  |
+| `name` | `string` | no |  |
+| `disabled` | `boolean` | no |  |
+| `orientation` | `"horizontal" \| "vertical"` | no |  |
+| `className` | `string` | no |  |
+| `"aria-label"` | `string` | no |  |

package/agents/reference/components/rating.md

@@ -0,0 +1,43 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# rating
+
+- Import: `@gunkin/uiify/components/rating`
+- Tier 0 (RSC — zero client JavaScript); state source S1; native element `input[type=radio]`
+- Without JavaScript: full
+- Types file: `dist/components/rating.d.ts`
+- Note: Native radio group; hover preview and persisted selection are pure CSS (:checked/:hover sibling rules), no JS. Controlled value/onValueChange lives in the separate rating/client entry. Built on @gunkin/uiify/elements/choice.
+
+## Exports
+
+- Runtime: `Rating`
+- Types: `RatingProps`
+
+## Props and shapes
+
+### RatingProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `id` | `string` | yes |  |
+| `defaultValue` | `number` | no |  |
+| `max` | `number` | no |  |
+| `readOnly` | `boolean` | no |  |
+| `disabled` | `boolean` | no |  |
+| `className` | `string` | no |  |
+| `"aria-label"` | `string` | no |  |
+
+### RatingClientProps
+
+Extends: `RatingProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `value` | `number` | no |  |
+| `onValueChange` | `(value: number) => void` | no |  |
+
+## Sub-entries
+
+### `@gunkin/uiify/components/rating/client`
+
+- Runtime: `RatingClient`
+- Types: `RatingClientProps`

package/agents/reference/components/segmented-control.md

@@ -0,0 +1,51 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# segmented-control
+
+- Import: `@gunkin/uiify/components/segmented-control`
+- Tier 0 (RSC — zero client JavaScript); state source S1; native element `input[type=radio]`
+- Without JavaScript: full
+- Types file: `dist/components/segmented-control.d.ts`
+- Note: Built on @gunkin/uiify/elements/choice.
+
+## Exports
+
+- Runtime: `SegmentedControl`
+- Types: `SegmentedControlClientProps`, `SegmentedControlItem`, `SegmentedControlProps`
+
+## Props and shapes
+
+### SegmentedControlItem
+
+Extends: `ChoiceItem`
+
+No own members.
+
+### SegmentedControlProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `id` | `string` | yes |  |
+| `items` | `readonly SegmentedControlItem[]` | yes |  |
+| `defaultValue` | `string` | no |  |
+| `disabled` | `boolean` | no |  |
+| `orientation` | `ChoiceOrientation` | no |  |
+| `fullWidth` | `boolean` | no |  |
+| `className` | `string` | no |  |
+| `"aria-label"` | `string` | no |  |
+| `"aria-labelledby"` | `string` | no |  |
+
+### SegmentedControlClientProps
+
+Extends: `SegmentedControlProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `value` | `string` | no |  |
+| `onValueChange` | `(value: string) => void` | no |  |
+
+## Sub-entries
+
+### `@gunkin/uiify/components/segmented-control/client`
+
+- Runtime: `SegmentedControlClient`
+- Types: `SegmentedControlClientProps`

package/agents/reference/components/select.md

@@ -0,0 +1,60 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# select
+
+- Import: `@gunkin/uiify/components/select`
+- Tier 0 (RSC — zero client JavaScript); state source S1; native element `select`
+- Without JavaScript: full
+- Types file: `dist/components/select.d.ts`
+- Note: Native text-only select; appearance:base-select is a Chrome+Safari cosmetic enhancement and Firefox keeps the OS picker.
+
+## Exports
+
+- Runtime: `Select`, `SelectContent`, `SelectGroup`, `SelectItem`, `SelectRoot`, `SelectSeparator`
+- Types: `SelectContentOwnProps`, `SelectGroupOwnProps`, `SelectGroupProps`, `SelectItemOwnProps`, `SelectItemProps`, `SelectRootOwnProps`, `SelectRootProps`, `SelectSeparatorOwnProps`, `SelectSeparatorProps`
+
+## Props and shapes
+
+### SelectRootOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `value` | `string` | no |  |
+| `defaultValue` | `string` | no |  |
+| `onValueChange` | `(value: string) => void` | no |  |
+| `name` | `string` | no |  |
+| `disabled` | `boolean` | no |  |
+
+### SelectContentOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+
+### SelectItemOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `disabled` | `boolean` | no |  |
+| `value` | `string` | yes |  |
+
+### SelectGroupOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `label` | `string` | yes |  |
+
+### SelectSeparatorOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `never` | no |  |
+
+## Other types
+
+- `SelectRootProps<TAs>`: `RenderableProps<TAs, SelectRootOwnProps, SelectRootOwnProps, HTMLSelectElement>`
+- `SelectItemProps<TAs>`: `RenderableProps<TAs, SelectItemOwnProps, { disabled: boolean }, HTMLOptionElement>`
+- `SelectGroupProps<TAs>`: `RenderableProps<TAs, SelectGroupOwnProps, SelectGroupOwnProps, HTMLOptGroupElement>`
+- `SelectSeparatorProps<TAs>`: `RenderableProps<TAs, SelectSeparatorOwnProps, Record<string, never>, HTMLHRElement>`

package/agents/reference/components/skeleton.md

@@ -0,0 +1,29 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# skeleton
+
+- Import: `@gunkin/uiify/components/skeleton`
+- Tier 0 (RSC — zero client JavaScript); state source none; native element `div`
+- Without JavaScript: full
+- Types file: `dist/components/skeleton.d.ts`
+
+## Exports
+
+- Runtime: `Skeleton`
+- Types: `SkeletonOwnProps`, `SkeletonProps`
+
+## Props and shapes
+
+### SkeletonOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `circle` | `boolean` | no |  |
+| `height` | `number \| string` | no |  |
+| `loading` | `boolean` | no |  |
+| `variant` | `"pulse" \| "shimmer" \| "none"` | no |  |
+| `width` | `number \| string` | no |  |
+| `children` | `ReactNode` | no |  |
+
+## Other types
+
+- `SkeletonProps<TAs>`: `RenderableProps<TAs, SkeletonOwnProps, { loading: boolean }, HTMLElement>`

package/agents/reference/components/slider.md

@@ -0,0 +1,71 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# slider
+
+- Import: `@gunkin/uiify/components/slider`
+- Tier 0 (RSC — zero client JavaScript); state source S1; native element `input[type=range]`
+- Without JavaScript: full
+- Types file: `dist/components/slider.d.ts`
+
+## Exports
+
+- Runtime: `Slider`
+- Types: `SliderOwnProps`, `SliderProps`
+
+## Props and shapes
+
+### SliderMark
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `value` | `number` | yes |  |
+| `label` | `ReactNode` | no |  |
+
+### SliderOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `value` | `number` | no |  |
+| `defaultValue` | `number` | no |  |
+| `onValueChange` | `(value: number) => void` | no |  |
+| `min` | `number` | no |  |
+| `max` | `number` | no |  |
+| `step` | `number` | no |  |
+| `disabled` | `boolean` | no |  |
+
+### SliderClientOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `value` | `SliderClientValue` | no |  |
+| `defaultValue` | `SliderClientValue` | no |  |
+| `onValueChange` | `(value: SliderClientValue) => void` | no |  |
+| `min` | `number` | no |  |
+| `max` | `number` | no |  |
+| `step` | `number \| null` | no |  |
+| `disabled` | `boolean` | no |  |
+| `orientation` | `"horizontal" \| "vertical"` | no |  |
+| `marks` | `readonly SliderMark[]` | no |  |
+| `thumbLabels` | `readonly [string, string]` | no |  |
+| `"aria-label"` | `string` | no |  |
+| `"aria-labelledby"` | `string` | no |  |
+
+### SliderClientRenderState
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `disabled` | `boolean` | yes |  |
+| `orientation` | `"horizontal" \| "vertical"` | yes |  |
+| `value` | `SliderClientValue` | yes |  |
+
+## Other types
+
+- `SliderClientValue`: `number | readonly [number, number]`
+- `SliderClientProps<TAs>`: `RenderableProps<TAs, SliderClientOwnProps, SliderClientRenderState, HTMLDivElement>`
+- `SliderProps<TAs>`: `RenderableProps<TAs, SliderOwnProps, SliderOwnProps, HTMLInputElement>`
+
+## Sub-entries
+
+### `@gunkin/uiify/components/slider/client`
+
+- Runtime: `SliderClient`
+- Types: `SliderClientOwnProps`, `SliderClientProps`, `SliderClientRenderState`, `SliderClientValue`, `SliderMark`

package/agents/reference/components/spinner.md

@@ -0,0 +1,34 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# spinner
+
+- Import: `@gunkin/uiify/components/spinner`
+- Tier 0 (RSC — zero client JavaScript); state source none; native element `div`
+- Without JavaScript: full
+- Types file: `dist/components/spinner.d.ts`
+
+## Exports
+
+- Runtime: `Spinner`
+- Types: `SpinnerAlign`, `SpinnerOwnProps`, `SpinnerProps`, `SpinnerSize`
+
+## Values
+
+- `SpinnerAlign`: `"center" | "fixed" | "absolute"`
+- `SpinnerSize`: `"sm" | "md" | "lg"`
+
+## Props and shapes
+
+### SpinnerOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `align` | `SpinnerAlign` | no |  |
+| `children` | `ReactNode` | no |  |
+| `delay` | `number` | no |  |
+| `label` | `string` | no |  |
+| `showLabel` | `boolean` | no |  |
+| `size` | `SpinnerSize` | no |  |
+
+## Other types
+
+- `SpinnerProps<TAs>`: `RenderableProps<TAs, SpinnerOwnProps, { visible: boolean }, HTMLElement>`

package/agents/reference/components/switch.md

@@ -0,0 +1,27 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# switch
+
+- Import: `@gunkin/uiify/components/switch`
+- Tier 0 (RSC — zero client JavaScript); state source S1; native element `input[type=checkbox]`
+- Without JavaScript: full
+- Types file: `dist/components/switch.d.ts`
+
+## Exports
+
+- Runtime: `Switch`
+- Types: `SwitchOwnProps`, `SwitchProps`
+
+## Props and shapes
+
+### SwitchOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `checked` | `boolean` | no |  |
+| `defaultChecked` | `boolean` | no |  |
+| `onCheckedChange` | `(checked: boolean) => void` | no |  |
+| `disabled` | `boolean` | no |  |
+
+## Other types
+
+- `SwitchProps<TAs>`: `RenderableProps<TAs, SwitchOwnProps, SwitchOwnProps, HTMLInputElement>`

package/agents/reference/components/table-of-contents.md

@@ -0,0 +1,185 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# table-of-contents
+
+- Import: `@gunkin/uiify/components/table-of-contents`
+- Tier 2 (Client component — pre-hydration SSR); state source S1; native element `nav + button[popovertarget] + [popover] + a[href]`
+- Without JavaScript: pre-hydration-only
+- Types file: `dist/components/table-of-contents.d.ts`
+- Note: Base entry is a server-pure native navigation shell; /client adds enhancements. Native links and popover invocation/dismissal work without JavaScript.
+
+## Exports
+
+- Runtime: `TableOfContents`, `TableOfContentsRoot`, `TableOfContentsTrigger`, `TableOfContentsRail`, `TableOfContentsIndicator`, `TableOfContentsContent`, `TableOfContentsList`, `TableOfContentsLink`
+- Types: `TableOfContentsLevel`, `TableOfContentsRootOwnProps`, `TableOfContentsRootProps`, `TableOfContentsTriggerOwnProps`, `TableOfContentsTriggerProps`, `TableOfContentsRailOwnProps`, `TableOfContentsRailProps`, `TableOfContentsIndicatorOwnProps`, `TableOfContentsIndicatorProps`, `TableOfContentsContentOwnProps`, `TableOfContentsContentProps`, `TableOfContentsListOwnProps`, `TableOfContentsListProps`, `TableOfContentsLinkOwnProps`, `TableOfContentsLinkProps`
+
+## Values
+
+- `TableOfContentsLevel`: `1 | 2 | 3 | 4 | 5 | 6`
+
+## Props and shapes
+
+### TableOfContentsRootOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+
+### TableOfContentsTriggerOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `target` | `string` | yes |  |
+
+### TableOfContentsRailOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+
+### TableOfContentsIndicatorOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `ref` | `Ref<HTMLElement>` | no |  |
+| `style` | `CSSProperties` | no |  |
+| `children` | `ReactNode` | no |  |
+| `value` | `string` | yes | Stable target ID matching a Link fragment. |
+| `level` | `TableOfContentsLevel` | no |  |
+| `selected` | `boolean` | no |  |
+
+### TableOfContentsContentOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `id` | `string` | yes |  |
+| `side` | `AnchorSide` | no |  |
+| `align` | `AnchorAlign` | no |  |
+
+### TableOfContentsListOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+
+### TableOfContentsLinkOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `style` | `CSSProperties` | no |  |
+| `"aria-current"` | `AriaAttributes["aria-current"]` | no |  |
+| `children` | `ReactNode` | no |  |
+| `href` | `string` | yes | Native same-page anchor; external URLs are not tracked by scrollspy. |
+| `level` | `TableOfContentsLevel` | no |  |
+| `selected` | `boolean` | no |  |
+
+### TableOfContentsTargetSnapshot
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `value` | `string` | yes |  |
+| `start` | `number` | yes |  |
+| `visible` | `boolean` | yes |  |
+
+### TableOfContentsScrollSnapshot
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `targets` | `readonly TableOfContentsTargetSnapshot[]` | yes |  |
+| `viewportStart` | `number` | yes |  |
+| `viewportEnd` | `number` | yes |  |
+| `offset` | `number` | yes |  |
+| `contentEnd` | `number \| null` | yes |  |
+
+### TableOfContentsObserverOptions
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `root` | `HTMLElement` | yes |  |
+| `scrollTarget` | `string \| undefined` | no |  |
+| `contentTarget` | `string \| undefined` | no |  |
+| `offset` | `number` | yes |  |
+| `onValueChange` | `(value: string \| null) => void` | yes |  |
+
+### TableOfContentsObserver
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `refresh` | `() => void` | yes |  |
+| `destroy` | `() => void` | yes |  |
+
+### TableOfContentsClientRootOwnProps
+
+Extends: `TableOfContentsRootOwnProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `ref` | `Ref<HTMLElement>` | no |  |
+| `className` | `string` | no |  |
+| `style` | `CSSProperties` | no |  |
+| `onClick` | `MouseEventHandler<HTMLElement>` | no |  |
+| `scrollSpy` | `boolean` | no |  |
+| `scrollTarget` | `string` | no | Scroll-container element ID; omitted tracks the owning window. |
+| `contentTarget` | `string` | no | Content element ID used for target scope and end-of-content selection. |
+| `offset` | `number` | no |  |
+| `value` | `string \| null` | no |  |
+| `defaultValue` | `string \| null` | no |  |
+| `onValueChange` | `(value: string \| null) => void` | no |  |
+| `open` | `boolean` | no |  |
+| `defaultOpen` | `boolean` | no | Applied after hydration; the native SSR surface starts closed. |
+| `onOpenChange` | `(open: boolean) => void` | no |  |
+| `openOnHover` | `boolean` | no |  |
+| `openDelay` | `number` | no |  |
+| `closeDelay` | `number` | no |  |
+
+### TableOfContentsClientContextValue
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `value` | `string \| null` | yes |  |
+| `open` | `boolean` | yes |  |
+| `documentUrl` | `string \| undefined` | yes |  |
+
+### TableOfContentsInteractionOptions
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `root` | `HTMLElement` | yes |  |
+| `getOpen` | `() => boolean` | yes |  |
+| `requestOpen` | `(open: boolean) => void` | yes |  |
+| `controlled` | `boolean` | yes |  |
+| `openOnHover` | `boolean` | yes |  |
+| `openDelay` | `number` | yes |  |
+| `closeDelay` | `number` | yes |  |
+
+### TableOfContentsInteractions
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `click` | `(event: MouseEvent) => void` | yes |  |
+| `destroy` | `() => void` | yes |  |
+
+### TableOfContentsPointerOptions
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `root` | `HTMLElement` | yes |  |
+
+## Other types
+
+- `TableOfContentsRootProps<TAs>`: `RenderableProps<TAs, TableOfContentsRootOwnProps, Record<string, never>, HTMLElement>`
+- `TableOfContentsTriggerProps<TAs>`: `NativeButtonProps<TAs, TableOfContentsTriggerOwnProps>`
+- `TableOfContentsRailProps<TAs>`: `RenderableProps<TAs, TableOfContentsRailOwnProps, Record<string, never>, HTMLElement>`
+- `TableOfContentsIndicatorProps<TAs>`: `RenderableProps<TAs, TableOfContentsIndicatorOwnProps, { selected: boolean }, HTMLElement>`
+- `TableOfContentsContentProps<TAs>`: `RenderableProps<TAs, TableOfContentsContentOwnProps, Record<string, never>, HTMLElement>`
+- `TableOfContentsListProps<TAs>`: `RenderableProps<TAs, TableOfContentsListOwnProps, Record<string, never>, HTMLElement>`
+- `TableOfContentsLinkProps<TAs>`: `RenderableProps<TAs, TableOfContentsLinkOwnProps, { selected: boolean }, HTMLAnchorElement>`
+- `TableOfContentsClientRootProps<TAs>`: `RenderableProps<TAs, TableOfContentsClientRootOwnProps, { value: string | null; open: boolean }, HTMLElement>`
+
+## Sub-entries
+
+### `@gunkin/uiify/components/table-of-contents/client`
+
+- Runtime: `TableOfContents`, `TableOfContentsRoot`, `TableOfContentsTrigger`, `TableOfContentsContent`, `TableOfContentsLink`, `TableOfContentsIndicator`, `TableOfContentsRail`, `TableOfContentsList`
+- Types: `TableOfContentsClientRootOwnProps`, `TableOfContentsClientRootProps`, `TableOfContentsLevel`, `TableOfContentsTriggerProps`, `TableOfContentsRailProps`, `TableOfContentsContentProps`, `TableOfContentsListProps`, `TableOfContentsLinkProps`, `TableOfContentsIndicatorProps`