@gunkin/uiify 0.0.22-alpha → 0.0.25-alpha

package/agents/reference/components/toast.md

@@ -6,10 +6,14 @@
 - Without JavaScript: degraded-documented
 - Types file: `dist/components/toast.d.ts`
 
+## Related knowledge
+
+- Recipe: [toast](../../../skills/uiify/references/elements/toast.md)
+
 ## Exports
 
 - Runtime: `Toast`, `ToastAction`, `ToastClose`, `ToastDescription`, `ToastProvider`, `ToastRoot`, `ToastTitle`, `ToastViewport`, `useToast`
-- Types: `ToastActionOwnProps`, `ToastActionProps`, `ToastCloseOwnProps`, `ToastCloseProps`, `ToastLabels`, `ToastDescriptionOwnProps`, `ToastProviderOwnProps`, `ToastRootOwnProps`, `ToastTitleOwnProps`, `ToastViewportOwnProps`, `ToastInput`, `ToastPriority`, `ToastRecord`, `ToastStore`
+- Types: `ToastActionOwnProps`, `ToastActionProps`, `ToastCloseOwnProps`, `ToastCloseProps`, `ToastLabels`, `ToastProviderSlotProps`, `ToastRootSlotProps`, `ToastViewportSlotProps`, `ToastItemSlotProps`, `ToastTitleSlotProps`, `ToastDescriptionSlotProps`, `ToastActionSlotProps`, `ToastCloseSlotProps`, `ToastDescriptionOwnProps`, `ToastProviderOwnProps`, `ToastRootOwnProps`, `ToastTitleOwnProps`, `ToastViewportOwnProps`, `ToastInput`, `ToastPriority`, `ToastRecord`, `ToastStore`
 
 ## Values
 
@@ -92,6 +96,30 @@
 | `store` | `ToastStore` | yes |  |
 | `labels` | `ToastLabels` | yes |  |
 
+### ToastRootSlotProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `title` | `ToastTitleSlotProps` | no |  |
+| `description` | `ToastDescriptionSlotProps` | no |  |
+| `action` | `ToastActionSlotProps` | no |  |
+| `close` | `ToastCloseSlotProps` | no |  |
+
+### ToastViewportSlotProps
+
+Extends: `ToastRootSlotProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `item` | `ToastItemSlotProps` | no |  |
+
+### ToastProviderSlotProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `politeLiveRegion` | `Omit<ComponentPropsWithRef<"span">, "children" \| "dangerouslySetInnerHTML" \| "aria-atomic" \| "aria-live"> & ConsumerDataAttributes` | no |  |
+| `assertiveLiveRegion` | `Omit<ComponentPropsWithRef<"span">, "children" \| "dangerouslySetInnerHTML" \| "aria-atomic" \| "aria-live"> & ConsumerDataAttributes` | no |  |
+
 ### ToastProviderOwnProps
 
 | Member | Type | Required | Description |
@@ -99,45 +127,57 @@
 | `children` | `ReactNode` | no |  |
 | `labels` | `Partial<ToastLabels>` | no |  |
 | `limit` | `number` | no |  |
+| `slotProps` | `ToastProviderSlotProps` | no |  |
 
 ### ToastViewportOwnProps
 
+Extends: `Omit<ComponentPropsWithRef<"section">, "children" | "dangerouslySetInnerHTML" | "popover" | "data-part" | "data-uiify-toast">`, `ConsumerDataAttributes`
+
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
-| `"aria-label"` | `string` | no |  |
+| `"data-part"` | `never` | no |  |
+| `"data-uiify-toast"` | `never` | no |  |
 | `children` | `ReactNode` | no |  |
-| `className` | `string` | no |  |
 | `labels` | `Partial<ToastLabels>` | 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 |  |
+| `slotProps` | `ToastViewportSlotProps` | no |  |
 
 ### ToastRootOwnProps
 
+Extends: `Omit<ComponentPropsWithRef<"div">, | "children" | "dangerouslySetInnerHTML" | "aria-label" | "data-part" | "data-state" | "data-uiify-toast" | "role" | "tabIndex">`, `ConsumerDataAttributes`
+
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
+| `"data-part"` | `never` | no |  |
+| `"data-state"` | `never` | no |  |
+| `"data-uiify-toast"` | `never` | no |  |
 | `labels` | `Partial<ToastLabels>` | no |  |
+| `slotProps` | `ToastRootSlotProps` | no |  |
 | `toast` | `ToastRecord` | yes |  |
 
 ### ToastTitleOwnProps
 
+Extends: `Omit<ComponentPropsWithRef<"div">, "children" | "dangerouslySetInnerHTML">`
+
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
 | `children` | `ReactNode` | no |  |
-| `className` | `string` | no |  |
 
 ### ToastDescriptionOwnProps
 
+Extends: `Omit<ComponentPropsWithRef<"div">, "children" | "dangerouslySetInnerHTML">`
+
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
 | `children` | `ReactNode` | no |  |
-| `className` | `string` | no |  |
 
 ### ToastActionOwnProps
 
+Extends: `Omit<ComponentPropsWithRef<"button">, "children" | "dangerouslySetInnerHTML">`
+
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
 | `children` | `ReactNode` | no |  |
-| `className` | `string` | no |  |
 
 ### ToastActionProps
 
@@ -145,14 +185,15 @@ Extends: `ToastActionOwnProps`
 
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
-| `onClick` | `(event: MouseEvent<HTMLButtonElement>) => void` | no |  |
+| `onClick` | `((event: MouseEvent<HTMLButtonElement>) => void) \| undefined` | no |  |
 
 ### ToastCloseOwnProps
 
+Extends: `Omit<ComponentPropsWithRef<"button">, "children" | "dangerouslySetInnerHTML">`
+
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
 | `children` | `ReactNode` | no |  |
-| `className` | `string` | no |  |
 | `labels` | `Partial<ToastLabels>` | no |  |
 
 ### ToastCloseProps
@@ -161,4 +202,12 @@ Extends: `ToastCloseOwnProps`
 
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
-| `onClick` | `(event: MouseEvent<HTMLButtonElement>) => void` | no |  |
+| `onClick` | `((event: MouseEvent<HTMLButtonElement>) => void) \| undefined` | no |  |
+
+## Other types
+
+- `ToastItemSlotProps`: `RepeatedSlotProps<Omit<ComponentPropsWithRef<"div">, | "children" | "dangerouslySetInnerHTML" | "data-part" | "data-state" | "data-uiify-toast" | "aria-label" | "role" | "tabIndex">, ToastItemOwnedAttributes>`
+- `ToastTitleSlotProps`: `RepeatedSlotProps<Omit<ComponentPropsWithRef<"div">, "children" | "dangerouslySetInnerHTML" | "data-part" | "data-uiify-toast">, ToastPartOwnedAttributes>`
+- `ToastDescriptionSlotProps`: `ToastTitleSlotProps`
+- `ToastActionSlotProps`: `RepeatedSlotProps<Omit<ComponentPropsWithRef<"button">, "children" | "dangerouslySetInnerHTML" | "type" | "data-part" | "data-uiify-toast">, ToastPartOwnedAttributes>`
+- `ToastCloseSlotProps`: `RepeatedSlotProps<Omit<ComponentPropsWithRef<"button">, | "children" | "dangerouslySetInnerHTML" | "type" | "aria-label" | "data-part" | "data-uiify-toast">, ToastPartOwnedAttributes & { readonly "aria-label"?: never }>`

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

@@ -5,17 +5,24 @@
 - 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`
+- Related native Element (manifest): [choice](../elements/choice.md)
 - Note: Built on @gunkin/uiify/elements/choice.
 
+## Related knowledge
+
+- Recipe: [toggle-group](../../../skills/uiify/references/elements/toggle-group.md)
+
 ## Exports
 
 - Runtime: `ToggleGroup`
-- Types: `ToggleGroupClientProps`, `ToggleGroupItem`, `ToggleGroupProps`
+- Types: `ToggleGroupClientProps`, `ToggleGroupItem`, `ToggleGroupProps`, `ToggleGroupSlotProps`
 
 ## Props and shapes
 
 ### ToggleGroupProps
 
+Extends: `ChoiceGroupRootProps`
+
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
 | `id` | `string` | yes |  |
@@ -26,8 +33,7 @@
 | `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 |  |
+| `slotProps` | `ToggleGroupSlotProps` | no |  |
 
 ### ToggleGroupClientProps
 
@@ -40,6 +46,7 @@ Extends: `ToggleGroupProps`
 
 ## Other types
 
+- `ToggleGroupSlotProps`: `ChoiceOptionSlotProps`
 - `ToggleGroupItem`: `ChoiceItem`
 
 ## Sub-entries

package/agents/reference/components/toggle.md

@@ -7,14 +7,25 @@
 - Types file: `dist/components/toggle.d.ts`
 - Note: Native checkbox + label toggle; browser owns pressed state.
 
+## Related knowledge
+
+- Recipe: [toggle](../../../skills/uiify/references/elements/toggle.md)
+
 ## Exports
 
 - Runtime: `Toggle`
-- Types: `ToggleProps`
+- Types: `ToggleControlSlotProps`, `ToggleLabelSlotProps`, `ToggleProps`, `ToggleSlotProps`
 
 ## Props and shapes
 
-### ToggleProps
+### ToggleSlotProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `control` | `ToggleControlSlotProps` | no |  |
+| `label` | `ToggleLabelSlotProps` | no |  |
+
+### ToggleOwnProps
 
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
@@ -23,4 +34,10 @@
 | `pressed` | `boolean` | no |  |
 | `defaultPressed` | `boolean` | no |  |
 | `disabled` | `boolean` | no |  |
-| `className` | `string` | no |  |
+| `slotProps` | `ToggleSlotProps` | no |  |
+
+## Other types
+
+- `ToggleControlSlotProps`: `Omit<ComponentPropsWithRef<"input">, | "aria-labelledby" | "checked" | "data-disabled" | "data-part" | "data-state" | "data-uiify-toggle" | "defaultChecked" | "disabled" | "id" | "type"> & ToggleControlOwnedAttributes & ConsumerDataAttributes`
+- `ToggleLabelSlotProps`: `Omit<ComponentPropsWithRef<"label">, "children" | "data-part" | "data-uiify-button" | "data-variant" | "htmlFor" | "id"> & ToggleLabelOwnedAttributes & ConsumerDataAttributes`
+- `ToggleProps`: `ToggleOwnProps & Omit<ComponentPropsWithRef<"div">, | keyof ToggleOwnProps | "children" | "dangerouslySetInnerHTML" | "data-disabled" | "data-uiify-toggle" | "id">`

package/agents/reference/components/toolbar.md

@@ -6,6 +6,10 @@
 - Without JavaScript: degraded-documented
 - Types file: `dist/components/toolbar.d.ts`
 
+## Related knowledge
+
+- Recipe: [toolbar](../../../skills/uiify/references/elements/toolbar.md)
+
 ## Exports
 
 - Runtime: `Toolbar`
@@ -23,7 +27,7 @@
 
 ### ToolbarRootProps
 
-Extends: `ToolbarRootOwnProps`, `Omit<HTMLAttributes<HTMLDivElement>, keyof ToolbarRootOwnProps>`
+Extends: `ToolbarRootOwnProps`, `Omit<ComponentPropsWithRef<"div">, keyof ToolbarRootOwnProps>`
 
 No own members.
 
@@ -38,7 +42,7 @@ No own members.
 
 ### ToolbarButtonProps
 
-Extends: `ToolbarButtonOwnProps`, `Omit<HTMLAttributes<HTMLButtonElement>, keyof ToolbarButtonOwnProps | "disabled">`
+Extends: `ToolbarButtonOwnProps`, `Omit<ComponentPropsWithRef<"button">, keyof ToolbarButtonOwnProps | "disabled">`
 
 No own members.
 
@@ -52,7 +56,7 @@ No own members.
 
 ### ToolbarLinkProps
 
-Extends: `ToolbarLinkOwnProps`, `Omit<HTMLAttributes<HTMLAnchorElement>, keyof ToolbarLinkOwnProps | "href">`
+Extends: `ToolbarLinkOwnProps`, `Omit<ComponentPropsWithRef<"a">, keyof ToolbarLinkOwnProps | "href">`
 
 No own members.
 
@@ -65,5 +69,5 @@ No own members.
 
 ## Other types
 
-- `ToolbarSeparatorProps`: `ToolbarSeparatorOwnProps & Omit<HTMLAttributes<HTMLHRElement>, keyof ToolbarSeparatorOwnProps>`
+- `ToolbarSeparatorProps`: `ToolbarSeparatorOwnProps & Omit<ComponentPropsWithRef<"hr">, keyof ToolbarSeparatorOwnProps>`
 - `ToolbarToggleGroupProps`: `ToggleGroupProps`

package/agents/reference/components/tooltip.md

@@ -6,6 +6,10 @@
 - Without JavaScript: degraded-documented
 - Types file: `dist/components/tooltip.d.ts`
 
+## Related knowledge
+
+- Recipe: [tooltip](../../../skills/uiify/references/elements/tooltip.md)
+
 ## Exports
 
 - Runtime: `Tooltip`, `TooltipContent`, `TooltipProvider`, `TooltipRoot`, `TooltipTrigger`

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

@@ -6,10 +6,14 @@
 - Without JavaScript: pre-hydration-only
 - Types file: `dist/components/virtual-scroll.d.ts`
 
+## Related knowledge
+
+- Recipe: [virtual-scroll](../../../skills/uiify/references/elements/virtual-scroll.md)
+
 ## 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`
+- Types: `VirtualScrollAnchor`, `VirtualScrollHandle`, `VirtualScrollItem`, `VirtualScrollListRole`, `VirtualScrollOrientation`, `VirtualScrollOwnProps`, `VirtualScrollRangeChange`, `VirtualScrollRowSlot`, `VirtualScrollRowSlotProps`, `VirtualScrollScrollAlign`, `VirtualScrollScrollBehavior`, `VirtualScrollScrollBehaviorOptions`, `VirtualScrollScrollState`, `VirtualScrollScrollToIndexOptions`, `VirtualScrollSpacerSlotProps`, `VirtualScrollSlotProps`
 
 ## Values
 
@@ -27,6 +31,13 @@
 | --- | --- | --- | --- |
 | `id` | `string` | yes |  |
 
+### VirtualScrollSlotProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `row` | `VirtualScrollRowSlotProps` | no |  |
+| `spacer` | `VirtualScrollSpacerSlotProps` | no |  |
+
 ### VirtualScrollScrollBehaviorOptions
 
 | Member | Type | Required | Description |
@@ -71,12 +82,13 @@ Extends: `Omit<ComponentPropsWithoutRef<"div">, "children" | "role">`
 
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
+| `ref` | `Ref<HTMLDivElement>` | no |  |
 | `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 |  |
+| `className` | `string \| undefined` | no |  |
 | `testId` | `string` | no |  |
 | `renderRow` | `(item: T, index: number) => ReactNode` | yes |  |
 | `scrollRef` | `Ref<VirtualScrollHandle>` | no |  |
@@ -87,6 +99,22 @@ Extends: `Omit<ComponentPropsWithoutRef<"div">, "children" | "role">`
 | `followAppend` | `boolean \| "smooth"` | no |  |
 | `onScrollStateChange` | `(state: VirtualScrollScrollState) => void` | no |  |
 | `isScrollingResetDelay` | `number` | no |  |
+| `slotProps` | `VirtualScrollSlotProps` | no |  |
+
+### VirtualScrollRowShellProps
+
+Extends: `Omit<ComponentPropsWithRef<"div">, | "aria-posinset" | "aria-setsize" | "children" | "data-dynamic-row" | "data-part" | "data-row-index" | "dangerouslySetInnerHTML" | "role">`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | yes |  |
+| `dynamicLayout` | `boolean` | yes |  |
+| `index` | `number` | yes |  |
+| `itemCount` | `number` | yes |  |
+| `listRole` | `VirtualScrollListRole` | yes |  |
+| `rowOffset` | `number` | no |  |
+| `rowHeight` | `number` | no |  |
+| `slotIndex` | `number` | yes |  |
 
 ### VirtualScrollRowSlot
 
@@ -95,3 +123,8 @@ Extends: `Omit<ComponentPropsWithoutRef<"div">, "children" | "role">`
 | `slotIndex` | `number` | yes |  |
 | `index` | `number` | yes |  |
 | `item` | `T \| null` | yes |  |
+
+## Other types
+
+- `VirtualScrollRowSlotProps`: `RepeatedSlotProps<VirtualScrollRowNativeProps, VirtualScrollRowOwnedProps> & { readonly byItemIndex?: Readonly<Record<number, VirtualScrollRowNativeProps & ConsumerDataAttributes & VirtualScrollRowOwnedProps>>; }`
+- `VirtualScrollSpacerSlotProps`: `Omit<ComponentPropsWithRef<"div">, "children" | "dangerouslySetInnerHTML" | "data-part"> & { readonly "data-part"?: never; } & ConsumerDataAttributes`

package/agents/reference/elements/choice.md

@@ -4,13 +4,13 @@
 - 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
+- Used by: [radio-group](../components/radio-group.md), [tabs](../components/tabs.md), [toggle-group](../components/toggle-group.md), [segmented-control](../components/segmented-control.md), [rating](../components/rating.md)
 - Types file: `dist/elements/choice.d.ts`
 
 ## Exports
 
 - Runtime: `Choice`, `ChoiceGroup`, `ChoiceItem`, `choiceGroupName`, `choiceIds`
-- Types: `ChoiceGroupOwnProps`, `ChoiceGroupProps`, `ChoiceItemOwnProps`, `ChoiceItemProps`, `ChoiceKind`, `ChoiceOrientation`
+- Types: `ChoiceGroupOwnProps`, `ChoiceGroupProps`, `ChoiceInputSlotProps`, `ChoiceItemOwnProps`, `ChoiceItemProps`, `ChoiceItemSlotProps`, `ChoiceKind`, `ChoiceLabelSlotProps`, `ChoiceOrientation`, `ChoicePanelSlotProps`
 
 ## Values
 
@@ -19,6 +19,10 @@
 
 ## Props and shapes
 
+### ConsumerDataAttributes
+
+No own members.
+
 ### ChoiceGroupOwnProps
 
 | Member | Type | Required | Description |
@@ -29,6 +33,14 @@
 | `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. |
 
+### ChoiceItemSlotProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `input` | `ChoiceInputSlotProps` | no |  |
+| `label` | `ChoiceLabelSlotProps` | no |  |
+| `panel` | `ChoicePanelSlotProps` | no |  |
+
 ### ChoiceItemOwnProps
 
 | Member | Type | Required | Description |
@@ -43,13 +55,14 @@
 | `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>`. |
+| `labelPart` | `boolean \| string` | no | Adds an owned `data-part` marker to the `<label>`; `true` means `"label"`. |
+| `slotProps` | `ChoiceItemSlotProps` | no | Native props for the generated input, label and optional panel. |
 | `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">`
+- `ChoiceGroupProps`: `ChoiceGroupOwnProps & Omit<ComponentPropsWithRef<"div">, keyof ChoiceGroupOwnProps | "dangerouslySetInnerHTML">`
+- `ChoiceInputSlotProps`: `Omit<ComponentPropsWithRef<"input">, | "children" | "dangerouslySetInnerHTML" | "aria-labelledby" | "checked" | "defaultChecked" | "disabled" | "id" | "name" | "type" | "value" | "data-part" | "data-uiify-choice" | "data-uiify-radio"> & ConsumerDataAttributes & { readonly "data-part"?: never; readonly "data-uiify-choice"?: never; readonly "data-uiify-radio"?: never; }`
+- `ChoiceLabelSlotProps`: `Omit<ComponentPropsWithRef<"label">, "children" | "dangerouslySetInnerHTML" | "htmlFor" | "id" | "data-part"> & ConsumerDataAttributes & { readonly "data-part"?: never }`
+- `ChoicePanelSlotProps`: `Omit<ComponentPropsWithRef<"div">, "children" | "dangerouslySetInnerHTML" | "id" | "data-part"> & ConsumerDataAttributes & { readonly "data-part"?: never }`
+- `ChoiceItemProps`: `ChoiceItemOwnProps & Omit<ComponentPropsWithRef<"div">, keyof ChoiceItemOwnProps | "children" | "dangerouslySetInnerHTML">`

package/agents/reference/elements/details.md

@@ -4,7 +4,7 @@
 - Import: `@gunkin/uiify/elements/details`
 - Native mechanism: details/summary
 - Parts: `Details.Root`, `Details.Summary`, `Details.Content`
-- Used by: accordion, collapsible, breadcrumb
+- Used by: [accordion](../components/accordion.md), [collapsible](../components/collapsible.md), [breadcrumb](../components/breadcrumb.md)
 - Types file: `dist/elements/details.d.ts`
 
 ## Exports

package/agents/reference/elements/dialog.md

@@ -4,7 +4,7 @@
 - Import: `@gunkin/uiify/elements/dialog`
 - Native mechanism: dialog + command=show-modal
 - Parts: `Dialog.Trigger`, `Dialog.Content`, `Dialog.Close`
-- Used by: modal, alert-modal, drawer
+- Used by: [modal](../components/modal.md), [alert-modal](../components/alert-modal.md), [drawer](../components/drawer.md)
 - Types file: `dist/elements/dialog.d.ts`
 
 ## Exports

package/agents/reference/elements/invoker.md

@@ -4,7 +4,7 @@
 - Import: `@gunkin/uiify/elements/invoker`
 - Native mechanism: command/commandfor attributes
 - Parts: `Invoker`
-- Used by: dialog
+- Used by: [dialog](../elements/dialog.md)
 - Types file: `dist/elements/invoker.d.ts`
 
 ## Exports

package/agents/reference/elements/popover.md

@@ -4,7 +4,7 @@
 - Import: `@gunkin/uiify/elements/popover`
 - Native mechanism: [popover] + popovertarget
 - Parts: `Popover.Trigger`, `Popover.Surface`, `Popover.Close`
-- Used by: popup
+- Used by: [popup](../components/popup.md)
 - Types file: `dist/elements/popover.d.ts`
 
 ## Exports

package/dist/components/accordion/Accordion.d.ts

@@ -6,7 +6,7 @@ import type { AccordionProps } from "./types.js";
  * `aria-disabled`/`tabIndex`. This component adds its own identity/anatomy markers and the
  * `name`/`defaultOpen` wiring that makes single-select exclusive.
  */
-export declare function Accordion({ id, items, type, defaultValue, className, }: AccordionProps): ReactElement;
+export declare function Accordion({ id, items, type, defaultValue, slotProps, ...rootProps }: AccordionProps): ReactElement;
 export declare namespace Accordion {
     var displayName: string;
 }

package/dist/components/accordion/Accordion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Accordion.d.ts","sourceRoot":"","sources":["../../../src/components/accordion/Accordion.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,YAAY,CAAC;AAWhE;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,EACxB,EAAE,EACF,KAAK,EACL,IAAe,EACf,YAAY,EACZ,SAAS,GACV,EAAE,cAAc,GAAG,YAAY,CAmB/B;yBAzBe,SAAS"}
+{"version":3,"file":"Accordion.d.ts","sourceRoot":"","sources":["../../../src/components/accordion/Accordion.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAG1C,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,YAAY,CAAC;AAWhE;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,EACxB,EAAE,EACF,KAAK,EACL,IAAe,EACf,YAAY,EACZ,SAAS,EACT,GAAG,SAAS,EACb,EAAE,cAAc,GAAG,YAAY,CAuD/B;yBA9De,SAAS"}

package/dist/components/accordion/Accordion.js

@@ -1,5 +1,7 @@
-import { jsx, jsxs } from "react/jsx-runtime";
+import { jsx } from "react/jsx-runtime";
+import { createElement } from "react";
 import { DetailsContent, DetailsRoot, DetailsSummary } from "../../elements/details/index.js";
+import { omitProps, resolveRepeatedSlotProps } from "../../core/slot-props.js";
 function isDefaultOpen(type, defaultValue, itemValue) {
   if (type === "single") return defaultValue === itemValue;
   return Array.isArray(defaultValue) && defaultValue.includes(itemValue);
@@ -9,22 +11,67 @@ function Accordion({
   items,
   type = "single",
   defaultValue,
-  className
+  slotProps,
+  ...rootProps
 }) {
-  return /* @__PURE__ */ jsx("div", { className, "data-kind": type, "data-uiify-accordion": "", children: items.map((item) => /* @__PURE__ */ jsxs(
-    DetailsRoot,
+  return /* @__PURE__ */ jsx(
+    "div",
     {
-      "data-part": "item",
-      defaultOpen: isDefaultOpen(type, defaultValue, item.value),
-      disabled: item.disabled ?? false,
-      ...type === "single" ? { name: id } : {},
-      children: [
-        /* @__PURE__ */ jsx(DetailsSummary, { disabled: item.disabled ?? false, part: "trigger", children: item.label }),
-        /* @__PURE__ */ jsx(DetailsContent, { part: "panel", children: item.panel })
-      ]
-    },
-    item.value
-  )) });
+      ...omitProps(rootProps, ["children", "dangerouslySetInnerHTML"]),
+      id,
+      "data-kind": type,
+      "data-uiify-accordion": "",
+      children: items.map((item) => {
+        const disabled = item.disabled ?? false;
+        return /* @__PURE__ */ createElement(
+          DetailsRoot,
+          {
+            ...resolveRepeatedSlotProps(slotProps?.item, item.value, [
+              "name",
+              "open",
+              "disabled",
+              "data-part",
+              "data-uiify-details",
+              "data-uiify-accordion"
+            ]),
+            "data-part": "item",
+            defaultOpen: isDefaultOpen(type, defaultValue, item.value),
+            disabled,
+            key: item.value,
+            ...type === "single" ? { name: id } : {}
+          },
+          /* @__PURE__ */ jsx(
+            DetailsSummary,
+            {
+              ...resolveRepeatedSlotProps(slotProps?.trigger, item.value, [
+                "disabled",
+                "part",
+                "data-part",
+                "data-uiify-details",
+                "data-uiify-accordion"
+              ]),
+              disabled,
+              part: "trigger",
+              children: item.label
+            }
+          ),
+          /* @__PURE__ */ jsx(
+            DetailsContent,
+            {
+              ...resolveRepeatedSlotProps(slotProps?.panel, item.value, [
+                "part",
+                "data-part",
+                "data-uiify-details",
+                "data-uiify-accordion"
+              ]),
+              part: "panel",
+              children: item.panel
+            }
+          )
+        );
+      })
+    }
+  );
 }
 Accordion.displayName = "Accordion";
 export {

package/dist/components/accordion/Accordion.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/components/accordion/Accordion.tsx"],"sourcesContent":["import type { ReactElement } from \"react\";\nimport { DetailsContent, DetailsRoot, DetailsSummary } from \"../../elements/details/index.js\";\nimport type { AccordionProps, AccordionType } from \"./types.js\";\n\nfunction isDefaultOpen(\n  type: AccordionType,\n  defaultValue: string | readonly string[] | undefined,\n  itemValue: string,\n): boolean {\n  if (type === \"single\") return defaultValue === itemValue;\n  return Array.isArray(defaultValue) && defaultValue.includes(itemValue);\n}\n\n/**\n * Built on `@gunkin/uiify/elements/details`: `Details.Root` already owns `data-disabled` (from its own\n * `disabled` prop) and `data-uiify-details`; `Details.Summary`'s `disabled` prop already owns\n * `aria-disabled`/`tabIndex`. This component adds its own identity/anatomy markers and the\n * `name`/`defaultOpen` wiring that makes single-select exclusive.\n */\nexport function Accordion({\n  id,\n  items,\n  type = \"single\",\n  defaultValue,\n  className,\n}: AccordionProps): ReactElement {\n  return (\n    <div className={className} data-kind={type} data-uiify-accordion=\"\">\n      {items.map((item) => (\n        <DetailsRoot\n          data-part=\"item\"\n          defaultOpen={isDefaultOpen(type, defaultValue, item.value)}\n          disabled={item.disabled ?? false}\n          key={item.value}\n          {...(type === \"single\" ? { name: id } : {})}\n        >\n          <DetailsSummary disabled={item.disabled ?? false} part=\"trigger\">\n            {item.label}\n          </DetailsSummary>\n          <DetailsContent part=\"panel\">{item.panel}</DetailsContent>\n        </DetailsRoot>\n      ))}\n    </div>\n  );\n}\nAccordion.displayName = \"Accordion\";\n"],"mappings":"AA6BQ,SAOE,KAPF;AA5BR,SAAS,gBAAgB,aAAa,sBAAsB;AAG5D,SAAS,cACP,MACA,cACA,WACS;AACT,MAAI,SAAS,SAAU,QAAO,iBAAiB;AAC/C,SAAO,MAAM,QAAQ,YAAY,KAAK,aAAa,SAAS,SAAS;AACvE;AAQO,SAAS,UAAU;AAAA,EACxB;AAAA,EACA;AAAA,EACA,OAAO;AAAA,EACP;AAAA,EACA;AACF,GAAiC;AAC/B,SACE,oBAAC,SAAI,WAAsB,aAAW,MAAM,wBAAqB,IAC9D,gBAAM,IAAI,CAAC,SACV;AAAA,IAAC;AAAA;AAAA,MACC,aAAU;AAAA,MACV,aAAa,cAAc,MAAM,cAAc,KAAK,KAAK;AAAA,MACzD,UAAU,KAAK,YAAY;AAAA,MAE1B,GAAI,SAAS,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;AAAA,MAEzC;AAAA,4BAAC,kBAAe,UAAU,KAAK,YAAY,OAAO,MAAK,WACpD,eAAK,OACR;AAAA,QACA,oBAAC,kBAAe,MAAK,SAAS,eAAK,OAAM;AAAA;AAAA;AAAA,IANpC,KAAK;AAAA,EAOZ,CACD,GACH;AAEJ;AACA,UAAU,cAAc;","names":[]}
+{"version":3,"sources":["../../../src/components/accordion/Accordion.tsx"],"sourcesContent":["import type { ReactElement } from \"react\";\nimport { DetailsContent, DetailsRoot, DetailsSummary } from \"../../elements/details/index.js\";\nimport { omitProps, resolveRepeatedSlotProps } from \"../../core/slot-props.js\";\nimport type { AccordionProps, AccordionType } from \"./types.js\";\n\nfunction isDefaultOpen(\n  type: AccordionType,\n  defaultValue: string | readonly string[] | undefined,\n  itemValue: string,\n): boolean {\n  if (type === \"single\") return defaultValue === itemValue;\n  return Array.isArray(defaultValue) && defaultValue.includes(itemValue);\n}\n\n/**\n * Built on `@gunkin/uiify/elements/details`: `Details.Root` already owns `data-disabled` (from its own\n * `disabled` prop) and `data-uiify-details`; `Details.Summary`'s `disabled` prop already owns\n * `aria-disabled`/`tabIndex`. This component adds its own identity/anatomy markers and the\n * `name`/`defaultOpen` wiring that makes single-select exclusive.\n */\nexport function Accordion({\n  id,\n  items,\n  type = \"single\",\n  defaultValue,\n  slotProps,\n  ...rootProps\n}: AccordionProps): ReactElement {\n  return (\n    <div\n      {...omitProps(rootProps, [\"children\", \"dangerouslySetInnerHTML\"])}\n      id={id}\n      data-kind={type}\n      data-uiify-accordion=\"\"\n    >\n      {items.map((item) => {\n        const disabled = item.disabled ?? false;\n        return (\n          <DetailsRoot\n            {...resolveRepeatedSlotProps(slotProps?.item, item.value, [\n              \"name\",\n              \"open\",\n              \"disabled\",\n              \"data-part\",\n              \"data-uiify-details\",\n              \"data-uiify-accordion\",\n            ])}\n            data-part=\"item\"\n            defaultOpen={isDefaultOpen(type, defaultValue, item.value)}\n            disabled={disabled}\n            key={item.value}\n            {...(type === \"single\" ? { name: id } : {})}\n          >\n            <DetailsSummary\n              {...resolveRepeatedSlotProps(slotProps?.trigger, item.value, [\n                \"disabled\",\n                \"part\",\n                \"data-part\",\n                \"data-uiify-details\",\n                \"data-uiify-accordion\",\n              ])}\n              disabled={disabled}\n              part=\"trigger\"\n            >\n              {item.label}\n            </DetailsSummary>\n            <DetailsContent\n              {...resolveRepeatedSlotProps(slotProps?.panel, item.value, [\n                \"part\",\n                \"data-part\",\n                \"data-uiify-details\",\n                \"data-uiify-accordion\",\n              ])}\n              part=\"panel\"\n            >\n              {item.panel}\n            </DetailsContent>\n          </DetailsRoot>\n        );\n      })}\n    </div>\n  );\n}\nAccordion.displayName = \"Accordion\";\n"],"mappings":"AAqDY;AAfF;AArCV,SAAS,gBAAgB,aAAa,sBAAsB;AAC5D,SAAS,WAAW,gCAAgC;AAGpD,SAAS,cACP,MACA,cACA,WACS;AACT,MAAI,SAAS,SAAU,QAAO,iBAAiB;AAC/C,SAAO,MAAM,QAAQ,YAAY,KAAK,aAAa,SAAS,SAAS;AACvE;AAQO,SAAS,UAAU;AAAA,EACxB;AAAA,EACA;AAAA,EACA,OAAO;AAAA,EACP;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAiC;AAC/B,SACE;AAAA,IAAC;AAAA;AAAA,MACE,GAAG,UAAU,WAAW,CAAC,YAAY,yBAAyB,CAAC;AAAA,MAChE;AAAA,MACA,aAAW;AAAA,MACX,wBAAqB;AAAA,MAEpB,gBAAM,IAAI,CAAC,SAAS;AACnB,cAAM,WAAW,KAAK,YAAY;AAClC,eACE;AAAA,UAAC;AAAA;AAAA,YACE,GAAG,yBAAyB,WAAW,MAAM,KAAK,OAAO;AAAA,cACxD;AAAA,cACA;AAAA,cACA;AAAA,cACA;AAAA,cACA;AAAA,cACA;AAAA,YACF,CAAC;AAAA,YACD,aAAU;AAAA,YACV,aAAa,cAAc,MAAM,cAAc,KAAK,KAAK;AAAA,YACzD;AAAA,YACA,KAAK,KAAK;AAAA,YACT,GAAI,SAAS,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;AAAA;AAAA,UAEzC;AAAA,YAAC;AAAA;AAAA,cACE,GAAG,yBAAyB,WAAW,SAAS,KAAK,OAAO;AAAA,gBAC3D;AAAA,gBACA;AAAA,gBACA;AAAA,gBACA;AAAA,gBACA;AAAA,cACF,CAAC;AAAA,cACD;AAAA,cACA,MAAK;AAAA,cAEJ,eAAK;AAAA;AAAA,UACR;AAAA,UACA;AAAA,YAAC;AAAA;AAAA,cACE,GAAG,yBAAyB,WAAW,OAAO,KAAK,OAAO;AAAA,gBACzD;AAAA,gBACA;AAAA,gBACA;AAAA,gBACA;AAAA,cACF,CAAC;AAAA,cACD,MAAK;AAAA,cAEJ,eAAK;AAAA;AAAA,UACR;AAAA,QACF;AAAA,MAEJ,CAAC;AAAA;AAAA,EACH;AAEJ;AACA,UAAU,cAAc;","names":[]}

package/dist/components/accordion/index.d.ts

@@ -1,3 +1,3 @@
 export { Accordion } from "./Accordion.js";
-export type { AccordionItem, AccordionProps, AccordionType } from "./types.js";
+export type { AccordionItem, AccordionItemSlotProps, AccordionPanelSlotProps, AccordionProps, AccordionSlotProps, AccordionTriggerSlotProps, AccordionType, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/components/accordion/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/accordion/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/accordion/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EACV,aAAa,EACb,sBAAsB,EACtB,uBAAuB,EACvB,cAAc,EACd,kBAAkB,EAClB,yBAAyB,EACzB,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/components/accordion/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/components/accordion/index.ts"],"sourcesContent":["export { Accordion } from \"./Accordion.js\";\nexport type { AccordionItem, AccordionProps, AccordionType } from \"./types.js\";\n"],"mappings":"AAAA,SAAS,iBAAiB;","names":[]}
+{"version":3,"sources":["../../../src/components/accordion/index.ts"],"sourcesContent":["export { Accordion } from \"./Accordion.js\";\nexport type {\n  AccordionItem,\n  AccordionItemSlotProps,\n  AccordionPanelSlotProps,\n  AccordionProps,\n  AccordionSlotProps,\n  AccordionTriggerSlotProps,\n  AccordionType,\n} from \"./types.js\";\n"],"mappings":"AAAA,SAAS,iBAAiB;","names":[]}

package/dist/components/accordion/types.d.ts

@@ -1,12 +1,33 @@
+import type { ComponentPropsWithRef } from "react";
 import type { ChoicePanelItem } from "../internal/choice-family/types.js";
+import type { RepeatedSlotProps } from "../../core/slot-props.js";
 export type AccordionType = "single" | "multiple";
 export interface AccordionItem extends ChoicePanelItem {
 }
-export interface AccordionProps {
+type AccordionOwnedSlotAttributes = {
+    readonly name?: never;
+    readonly open?: never;
+    readonly disabled?: never;
+    readonly part?: never;
+    readonly "data-part"?: never;
+    readonly "data-uiify-details"?: never;
+    readonly "data-uiify-accordion"?: never;
+};
+export type AccordionItemSlotProps = RepeatedSlotProps<Omit<ComponentPropsWithRef<"details">, "name" | "open" | "children" | "dangerouslySetInnerHTML" | "data-part" | "data-uiify-details" | "data-uiify-accordion" | "disabled">, AccordionOwnedSlotAttributes>;
+export type AccordionTriggerSlotProps = RepeatedSlotProps<Omit<ComponentPropsWithRef<"summary">, "children" | "dangerouslySetInnerHTML" | "data-part" | "data-uiify-details" | "data-uiify-accordion" | "disabled" | "part">, AccordionOwnedSlotAttributes>;
+export type AccordionPanelSlotProps = RepeatedSlotProps<Omit<ComponentPropsWithRef<"div">, "children" | "dangerouslySetInnerHTML" | "data-part" | "data-uiify-details" | "data-uiify-accordion" | "part">, AccordionOwnedSlotAttributes>;
+export interface AccordionSlotProps {
+    readonly item?: AccordionItemSlotProps;
+    readonly trigger?: AccordionTriggerSlotProps;
+    readonly panel?: AccordionPanelSlotProps;
+}
+export interface AccordionOwnProps {
     readonly id: string;
     readonly items: readonly AccordionItem[];
     readonly type?: AccordionType;
     readonly defaultValue?: string | readonly string[];
-    readonly className?: string;
+    readonly slotProps?: AccordionSlotProps;
 }
+export type AccordionProps = AccordionOwnProps & Omit<ComponentPropsWithRef<"div">, keyof AccordionOwnProps | "children" | "dangerouslySetInnerHTML" | "data-uiify-accordion">;
+export {};
 //# sourceMappingURL=types.d.ts.map