@gunkin/uiify 0.0.14-alpha → 0.0.16-alpha

package/agents/reference/components/table.md

@@ -0,0 +1,189 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# table
+
+- Import: `@gunkin/uiify/components/table`
+- Tier 0 (RSC — zero client JavaScript); state source none; native element `table`
+- Without JavaScript: full
+- Types file: `dist/components/table.d.ts`
+- Note: Native semantic Table parts; selection, sorting and expansion use the explicit /client entry.
+
+## Exports
+
+- Runtime: `Table`, `TableFooter`, `TableRowHeader`, `TableBody`, `TableCaption`, `TableCell`, `TableColumnHeader`, `TableHeader`, `TableRoot`, `TableRow`
+- Types: `TableFooterProps`, `TableRowHeaderProps`, `TableStickySectionOwnProps`, `TableStickyCellOwnProps`, `TableBodyProps`, `TableCaptionProps`, `TableCellProps`, `TableColumnHeaderOwnProps`, `TableColumnHeaderProps`, `TableContextValue`, `TableInteractiveRootOwnProps`, `TableHeaderProps`, `TableRowSelectOwnProps`, `TableRowOwnProps`, `TableRowProps`, `TableStore`, `TableStoreOptions`, `TableRootProps`, `SelectionMode`, `SortDescriptor`, `SortDirection`
+
+## Values
+
+- `SortDirection`: `"ascending" | "descending"`
+- `SelectionMode`: `"none" | "single" | "multiple"`
+- `SelectionBehavior`: `"toggle" | "replace"`
+
+## Props and shapes
+
+### SortDescriptor
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `column` | `string` | yes |  |
+| `direction` | `SortDirection` | yes |  |
+
+### TableStoreOptions
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `defaultSelectedKeys` | `Iterable<string>` | no |  |
+| `defaultSortDescriptor` | `SortDescriptor \| null` | no |  |
+| `onSelectionChange` | `((selectedKeys: Set<string>) => void) \| undefined` | no |  |
+| `onSortChange` | `((descriptor: SortDescriptor \| null) => void) \| undefined` | no |  |
+| `selectedKeys` | `Iterable<string>` | no |  |
+| `selectionBehavior` | `SelectionBehavior` | no |  |
+| `selectionMode` | `SelectionMode` | no |  |
+| `sortDescriptor` | `SortDescriptor \| null` | no |  |
+
+### TableStore
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `getRowIds` | `() => string[]` | yes |  |
+| `getSelectedKeys` | `() => Set<string>` | yes |  |
+| `getSelectionState` | `() => "none" \| "some" \| "all"` | yes |  |
+| `getServerSelectedSnapshot` | `() => Set<string>` | yes |  |
+| `getServerSortSnapshot` | `() => SortDescriptor \| null` | yes |  |
+| `getSortSnapshot` | `() => SortDescriptor \| null` | yes |  |
+| `isRowSelected` | `(id: string) => boolean` | yes |  |
+| `registerRow` | `(id: string) => () => void` | yes |  |
+| `setRowDisabled` | `(id: string, disabled: boolean) => void` | yes |  |
+| `setRowIds` | `(ids: readonly string[]) => void` | yes |  |
+| `setSelectedKeys` | `(keys: Iterable<string>) => void` | yes |  |
+| `setSortDescriptor` | `(descriptor: SortDescriptor \| null) => void` | yes |  |
+| `subscribe` | `(listener: () => void) => () => void` | yes |  |
+| `subscribeRow` | `(id: string, listener: () => void) => () => void` | yes |  |
+| `subscribeSelection` | `(listener: () => void) => () => void` | yes |  |
+| `subscribeSort` | `(listener: () => void) => () => void` | yes |  |
+| `syncSelectedKeys` | `(keys: Iterable<string>) => void` | yes |  |
+| `syncSortDescriptor` | `(descriptor: SortDescriptor \| null) => void` | yes |  |
+| `toggleRow` | `(id: string, toggleOptions?: { readonly disabled?: boolean; readonly metaKey?: boolean; readonly shiftKey?: boolean; }) => void` | yes |  |
+| `toggleSelectAll` | `() => void` | yes |  |
+| `toggleSort` | `(column: string) => void` | yes |  |
+| `updateOptions` | `(nextOptions: TableStoreOptions) => void` | yes |  |
+
+### TableContextValue
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `inBody` | `boolean` | yes |  |
+| `interactive` | `boolean` | yes |  |
+| `instanceId` | `string` | yes |  |
+| `expandedKeys` | `Set<string>` | yes |  |
+| `toggleExpanded` | `(id: string) => void` | yes |  |
+| `store` | `TableStore` | yes |  |
+
+### TableRootOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `"aria-label"` | `string` | no |  |
+| `"aria-labelledby"` | `string` | no |  |
+| `layout` | `"auto" \| "fixed"` | no |  |
+| `size` | `"sm" \| "md" \| "lg"` | no |  |
+| `variant` | `"solid" \| "outline" \| "ghost"` | no |  |
+
+### TableInteractiveRootOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `defaultSelectedKeys` | `Iterable<string>` | no |  |
+| `onSelectionChange` | `(selectedKeys: Set<string>) => void` | no |  |
+| `onSortChange` | `(descriptor: SortDescriptor \| null) => void` | no |  |
+| `selectedKeys` | `Iterable<string>` | no |  |
+| `selectionBehavior` | `SelectionBehavior` | no |  |
+| `selectionMode` | `SelectionMode` | no |  |
+
+### TableRowOwnProps
+
+Extends: `TableStickySectionOwnProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `disabled` | `boolean` | no |  |
+| `id` | `string` | yes |  |
+| `selected` | `boolean` | no |  |
+
+### TableColumnHeaderOwnProps
+
+Extends: `TableStickyCellOwnProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `allowsSorting` | `boolean` | no |  |
+| `children` | `ReactNode` | no |  |
+| `id` | `string` | yes |  |
+| `onClick` | `React.MouseEventHandler<HTMLTableCellElement>` | no |  |
+| `sortDirection` | `SortDescriptor["direction"] \| null` | no |  |
+
+### TableRowSelectOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `rowId` | `string` | yes |  |
+
+### TableClientRootOwnProps
+
+Extends: `TableRootOwnProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `defaultSelectedKeys` | `Iterable<string>` | no |  |
+| `defaultSortDescriptor` | `SortDescriptor \| null` | no |  |
+| `onSelectionChange` | `(selectedKeys: Set<string>) => void` | no |  |
+| `onSortChange` | `(descriptor: SortDescriptor \| null) => void` | no |  |
+| `selectedKeys` | `Iterable<string>` | no |  |
+| `selectionBehavior` | `SelectionBehavior` | no |  |
+| `selectionMode` | `SelectionMode` | no |  |
+| `sortDescriptor` | `SortDescriptor \| null` | no |  |
+| `expandedKeys` | `Iterable<string>` | no |  |
+| `defaultExpandedKeys` | `Iterable<string>` | no |  |
+| `onExpandedChange` | `(keys: Set<string>) => void` | no |  |
+
+### TableStickySectionOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `sticky` | `boolean` | no |  |
+
+### TableStickyCellOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `align` | `"start" \| "center" \| "end"` | no |  |
+| `sticky` | `"start" \| "end"` | no |  |
+| `children` | `ReactNode` | no |  |
+
+### TableExpandTriggerProps
+
+Extends: `Omit<ComponentPropsWithRef<"button">, "aria-expanded" | "aria-controls">`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `rowId` | `string` | yes |  |
+
+### TableExpandedRowProps
+
+Extends: `Omit<ComponentPropsWithRef<"tr">, "hidden" | "id">`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `rowId` | `string` | yes |  |
+
+## Other types
+
+- `TableRootProps<TAs>`: `RenderableProps<TAs, TableRootOwnProps, Record<string, never>, HTMLTableElement>`
+- `TableHeaderProps<TAs>`: `RenderableProps<TAs, TableStickySectionOwnProps, Record<string, never>, HTMLTableSectionElement>`
+- `TableBodyProps<TAs>`: `RenderableProps<TAs, { readonly children?: ReactNode }, Record<string, never>, HTMLTableSectionElement>`
+- `TableRowProps<TAs>`: `RenderableProps<TAs, TableRowOwnProps, { selected: boolean }, HTMLTableRowElement>`
+- `TableColumnHeaderProps<TAs>`: `RenderableProps<TAs, TableColumnHeaderOwnProps, Record<string, never>, HTMLTableCellElement>`
+- `TableCellProps<TAs>`: `RenderableProps<TAs, TableStickyCellOwnProps, Record<string, never>, HTMLTableCellElement>`
+- `TableCaptionProps<TAs>`: `RenderableProps<TAs, { readonly children?: ReactNode }, Record<string, never>, HTMLTableCaptionElement>`
+- `TableClientRootProps<TAs>`: `RenderableProps<TAs, TableClientRootOwnProps, Record<string, never>, HTMLTableElement>`
+- `TableFooterProps<TAs>`: `RenderableProps<TAs, TableStickySectionOwnProps, Record<string, never>, HTMLTableSectionElement>`
+- `TableRowHeaderProps<TAs>`: `RenderableProps<TAs, TableStickyCellOwnProps, Record<string, never>, HTMLTableCellElement>`

package/agents/reference/components/tabs.md

@@ -0,0 +1,42 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# tabs
+
+- Import: `@gunkin/uiify/components/tabs`
+- Tier 0 (RSC — zero client JavaScript); state source S1; native element `input[type=radio]`
+- Without JavaScript: full
+- Types file: `dist/components/tabs.d.ts`
+- Note: Data-driven native radio switcher; CSS-only panels. Built on @gunkin/uiify/elements/choice.
+
+## Exports
+
+- Runtime: `Tabs`
+- Types: `TabsItem`, `TabsProps`
+
+## Props and shapes
+
+### TabsStore
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `getValue` | `() => string \| undefined` | yes |  |
+| `isSelected` | `(itemValue: string) => boolean` | yes |  |
+| `setValue` | `(next: string \| undefined) => void` | yes |  |
+| `subscribe` | `(listener: () => void) => () => void` | yes |  |
+| `subscribeItem` | `(itemValue: string, listener: () => void) => () => void` | yes |  |
+
+### TabsItem
+
+Extends: `ChoicePanelItem`
+
+No own members.
+
+### TabsProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `id` | `string` | yes |  |
+| `items` | `readonly TabsItem[]` | yes |  |
+| `defaultValue` | `string` | no |  |
+| `orientation` | `ChoiceOrientation` | no |  |
+| `className` | `string` | no |  |
+| `append` | `ReactNode` | no | Optional control rendered at the end of the tab bar. |

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`