@gunkin/uiify 0.0.20-alpha → 0.0.24-alpha

package/agents/components.md

@@ -68,6 +68,19 @@ its exports, props and shapes; exact types are in the `.d.ts` file listed in the
 | [color-picker](./reference/components/color-picker.md) | `@gunkin/uiify/components/color-picker` | 1 | S1 | `input[type=color]` | `dist/components/color-picker.d.ts` |  |
 | [virtual-scroll](./reference/components/virtual-scroll.md) | `@gunkin/uiify/components/virtual-scroll` | 2 | none | `div[overflow]` | `dist/components/virtual-scroll.d.ts` |  |
 | [table-of-contents](./reference/components/table-of-contents.md) | `@gunkin/uiify/components/table-of-contents` | 2 | S1 | `nav + button[popovertarget] + [popover] + a[href]` | `dist/components/table-of-contents.d.ts` | Base entry is a server-pure native navigation shell; /client adds enhancements. Native links and popover invocation/dismissal work without JavaScript. |
+| [aspect-ratio](./reference/components/aspect-ratio.md) | `@gunkin/uiify/components/aspect-ratio` | 0 | none | `div` | `dist/components/aspect-ratio.d.ts` | Static layout component; native CSS aspect-ratio isolates child intrinsic sizing. |
+| [badge](./reference/components/badge.md) | `@gunkin/uiify/components/badge` | 0 | none | `span` | `dist/components/badge.d.ts` |  |
+| [card](./reference/components/card.md) | `@gunkin/uiify/components/card` | 0 | none | `div` | `dist/components/card.d.ts` |  |
+| [progress](./reference/components/progress.md) | `@gunkin/uiify/components/progress` | 0 | S1 | `progress` | `dist/components/progress.d.ts` |  |
+| [avatar](./reference/components/avatar.md) | `@gunkin/uiify/components/avatar` | 0 | none | `span` | `dist/components/avatar.d.ts` |  |
+| [alert](./reference/components/alert.md) | `@gunkin/uiify/components/alert` | 0 | none | `div` | `dist/components/alert.d.ts` |  |
+| [input-group](./reference/components/input-group.md) | `@gunkin/uiify/components/input-group` | 0 | none | `div + native controls` | `dist/components/input-group.d.ts` | Static form component; keeps independently labeled native input and action. |
+| [empty](./reference/components/empty.md) | `@gunkin/uiify/components/empty` | 0 | none | `section` | `dist/components/empty.d.ts` |  |
+| [item](./reference/components/item.md) | `@gunkin/uiify/components/item` | 0 | none | `li` | `dist/components/item.d.ts` |  |
+| [date-picker](./reference/components/date-picker.md) | `@gunkin/uiify/components/date-picker` | 0 | native | `input[type=date]` | `dist/components/date-picker.d.ts` | Native date picker; stylesheet styles the outer input only. |
+| [fieldset](./reference/components/fieldset.md) | `@gunkin/uiify/components/fieldset` | 0 | native | `fieldset + legend` | `dist/components/fieldset.d.ts` |  |
+| [form-error-summary](./reference/components/form-error-summary.md) | `@gunkin/uiify/components/form-error-summary` | 0 | none | `section + heading + ul + links` | `dist/components/form-error-summary.d.ts` | Static server-rendered error links; no alert or focus script. |
+| [description-list](./reference/components/description-list.md) | `@gunkin/uiify/components/description-list` | 0 | none | `dl + dt + dd` | `dist/components/description-list.d.ts` |  |
 
 ## Elements
 

package/agents/index.md

@@ -61,6 +61,19 @@ export function RemoveButton() {
 }
 ```
 
+`Alert` supplies a decorative text symbol from its variant. Use the published parts for its
+content; the optional stylesheet owns their layout. Set `symbol={false}` to hide the symbol.
+Static initial content has no live role by default.
+
+```tsx
+import { Alert, AlertDescription, AlertTitle } from "@gunkin/uiify/components/alert";
+
+<Alert variant="warning">
+  <AlertTitle>Browser support is incomplete</AlertTitle>
+  <AlertDescription>Check the support matrix before release.</AlertDescription>
+</Alert>;
+```
+
 `as` swaps the rendered element and keeps the component's behavior:
 
 ```tsx
@@ -86,7 +99,7 @@ export function EmailField({ invalid }: { readonly invalid: boolean }) {
       <Field.Label fieldId="email" required>
         Email
       </Field.Label>
-      <Field.Control as="input" fieldId="email" type="email" invalid={invalid} required />
+      <Field.Control as="input" fieldId="email" name="email" type="email" invalid={invalid} required />
       <Field.Description fieldId="email">We only use it to send receipts.</Field.Description>
       <Field.Error fieldId="email" invalid={invalid}>
         Enter a valid email address
@@ -96,6 +109,23 @@ export function EmailField({ invalid }: { readonly invalid: boolean }) {
 }
 ```
 
+`Field.Label` connects to `Field.Control`, not a standalone Select. For a select, wrap the
+control in a native label (or match native `htmlFor` to an explicit unique select `id`):
+
+```tsx
+import { Select } from "@gunkin/uiify/components/select";
+
+<label>
+  Delivery frequency
+  <Select.Root name="frequency" defaultValue="weekly">
+    <Select.Content>
+      <Select.Item value="daily">Daily</Select.Item>
+      <Select.Item value="weekly">Weekly</Select.Item>
+    </Select.Content>
+  </Select.Root>
+</label>;
+```
+
 A trigger and its close button reference the dialog by `id` and `target`:
 
 ```tsx

package/agents/reference/components/accordion.md

@@ -5,8 +5,13 @@
 - Tier 0 (RSC — zero client JavaScript); state source S1; native element `details[name]`
 - Without JavaScript: full
 - Types file: `dist/components/accordion.d.ts`
+- Related native Element (manifest): [details](../elements/details.md)
 - Note: Native details/summary disclosure; name groups single-open items. Built on @gunkin/uiify/elements/details.
 
+## Related knowledge
+
+- Recipe: [accordion](../../../skills/uiify/references/elements/accordion.md)
+
 ## Exports
 
 - Runtime: `Accordion`

package/agents/reference/components/alert-modal.md

@@ -5,8 +5,14 @@
 - Tier 0 (RSC — zero client JavaScript); state source S1; native element `dialog[role=alertdialog] + command=show-modal`
 - Without JavaScript: full
 - Types file: `dist/components/alert-modal.d.ts`
+- Related native Element (manifest): [dialog](../elements/dialog.md)
 - Note: Native modal alertdialog via show-modal; Cancel/Action are request-close invokers. Baseline Chrome 139 / Firefox 147 / Safari 26.2; below it UIEnhance's invoker fallback runs the command after hydration.
 
+## Related knowledge
+
+- Recipe: [alert-modal](../../../skills/uiify/references/elements/alert-modal.md)
+- Example: [alert-confirmation](../../../skills/uiify/references/examples/alert-confirmation.md)
+
 ## Exports
 
 - Runtime: `AlertModal`, `AlertModalAction`, `AlertModalCancel`, `AlertModalContent`, `AlertModalTrigger`

package/agents/reference/components/alert.md

@@ -0,0 +1,48 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# alert
+
+- Import: `@gunkin/uiify/components/alert`
+- Tier 0 (RSC — zero client JavaScript); state source none; native element `div`
+- Without JavaScript: full
+- Types file: `dist/components/alert.d.ts`
+
+## Related knowledge
+
+- Recipe: [inline-alert](../../../skills/uiify/references/elements/inline-alert.md)
+
+## Exports
+
+- Runtime: `Alert`, `AlertDescription`, `AlertTitle`
+- Types: `AlertDescriptionOwnProps`, `AlertDescriptionProps`, `AlertOwnProps`, `AlertProps`, `AlertTitleOwnProps`, `AlertTitleProps`, `AlertVariant`
+
+## Values
+
+- `AlertVariant`: `"secondary" | "success" | "warning" | "destructive"`
+
+## Props and shapes
+
+### AlertOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `variant` | `AlertVariant` | no | Visual status. Defaults to secondary without adding a live role. |
+| `symbol` | `string \| false` | no | Override the decorative text symbol, or hide it with false. |
+
+### AlertTitleOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+
+### AlertDescriptionOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+
+## Other types
+
+- `AlertProps<TAs>`: `RenderableProps<TAs, AlertOwnProps, Record<string, never>, HTMLElement>`
+- `AlertTitleProps<TAs>`: `RenderableProps<TAs, AlertTitleOwnProps, Record<string, never>, HTMLElement>`
+- `AlertDescriptionProps<TAs>`: `RenderableProps<TAs, AlertDescriptionOwnProps, Record<string, never>, HTMLElement>`

package/agents/reference/components/aspect-ratio.md

@@ -0,0 +1,30 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# aspect-ratio
+
+- Import: `@gunkin/uiify/components/aspect-ratio`
+- Tier 0 (RSC — zero client JavaScript); state source none; native element `div`
+- Without JavaScript: full
+- Types file: `dist/components/aspect-ratio.d.ts`
+- Note: Static layout component; native CSS aspect-ratio isolates child intrinsic sizing.
+
+## Related knowledge
+
+- Recipe: [aspect-ratio](../../../skills/uiify/references/elements/aspect-ratio.md)
+
+## Exports
+
+- Runtime: `AspectRatio`
+- Types: `AspectRatioOwnProps`, `AspectRatioProps`
+
+## Props and shapes
+
+### AspectRatioOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `ratio` | `number` | no | Positive finite width / height ratio. Omit to use the CSS default (square). |
+| `children` | `ReactNode` | no |  |
+
+## Other types
+
+- `AspectRatioProps<TAs>`: `RenderableProps<TAs, AspectRatioOwnProps, Record<string, never>, HTMLElement>`

package/agents/reference/components/avatar.md

@@ -0,0 +1,36 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# avatar
+
+- Import: `@gunkin/uiify/components/avatar`
+- Tier 0 (RSC — zero client JavaScript); state source none; native element `span`
+- Without JavaScript: full
+- Types file: `dist/components/avatar.d.ts`
+
+## Related knowledge
+
+- Recipe: [avatar](../../../skills/uiify/references/elements/avatar.md)
+
+## Exports
+
+- Runtime: `Avatar`
+- Types: `AvatarOwnProps`, `AvatarProps`, `AvatarSize`
+
+## Values
+
+- `AvatarSize`: `"sm" | "md" | "lg"`
+
+## Props and shapes
+
+### AvatarOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `name` | `string` | yes |  |
+| `fallback` | `string` | yes |  |
+| `src` | `string` | no |  |
+| `size` | `AvatarSize` | no |  |
+| `children` | `never` | no |  |
+
+## Other types
+
+- `AvatarProps<TAs>`: `RenderableProps<TAs, AvatarOwnProps, Record<string, never>, HTMLElement>`

package/agents/reference/components/badge.md

@@ -0,0 +1,35 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# badge
+
+- Import: `@gunkin/uiify/components/badge`
+- Tier 0 (RSC — zero client JavaScript); state source none; native element `span`
+- Without JavaScript: full
+- Types file: `dist/components/badge.d.ts`
+
+## Related knowledge
+
+- Recipe: [badge](../../../skills/uiify/references/elements/badge.md)
+
+## Exports
+
+- Runtime: `Badge`
+- Types: `BadgeOwnProps`, `BadgeProps`, `BadgeSize`, `BadgeVariant`
+
+## Values
+
+- `BadgeVariant`: `"secondary" | "success" | "warning" | "destructive"`
+- `BadgeSize`: `"sm" | "md" | "lg"`
+
+## Props and shapes
+
+### BadgeOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `size` | `BadgeSize` | no |  |
+| `variant` | `BadgeVariant` | no |  |
+
+## Other types
+
+- `BadgeProps<TAs>`: `RenderableProps<TAs, BadgeOwnProps, Record<string, never>, HTMLElement>`

package/agents/reference/components/breadcrumb.md

@@ -5,8 +5,13 @@
 - Tier 0 (RSC — zero client JavaScript); state source none; native element `nav>ol`
 - Without JavaScript: full
 - Types file: `dist/components/breadcrumb.d.ts`
+- Related native Element (manifest): [details](../elements/details.md)
 - Note: Ellipsis expand/collapse is a native details/summary disclosure, built on @gunkin/uiify/elements/details.
 
+## Related knowledge
+
+- Recipe: [breadcrumb](../../../skills/uiify/references/elements/breadcrumb.md)
+
 ## Exports
 
 - Runtime: `Breadcrumb`, `BreadcrumbEllipsis`, `BreadcrumbItem`, `BreadcrumbLink`, `BreadcrumbList`, `BreadcrumbRoot`, `BreadcrumbSeparator`

package/agents/reference/components/button.md

@@ -6,6 +6,10 @@
 - Without JavaScript: full
 - Types file: `dist/components/button.d.ts`
 
+## Related knowledge
+
+- Recipe: [button](../../../skills/uiify/references/elements/button.md)
+
 ## Exports
 
 - Runtime: `Button`

package/agents/reference/components/candle-chart.md

@@ -7,6 +7,10 @@
 - Types file: `dist/components/candle-chart.d.ts`
 - Note: Static OHLC geometry is computed during render and expressed as percentage CSS custom properties; the decorative candle glyphs have an accessible table fallback.
 
+## Related knowledge
+
+- Recipe: [candle-chart](../../../skills/uiify/references/elements/candle-chart.md)
+
 ## Exports
 
 - Runtime: `CandleChart`

package/agents/reference/components/card.md

@@ -0,0 +1,28 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# card
+
+- Import: `@gunkin/uiify/components/card`
+- Tier 0 (RSC — zero client JavaScript); state source none; native element `div`
+- Without JavaScript: full
+- Types file: `dist/components/card.d.ts`
+
+## Related knowledge
+
+- Recipe: [card](../../../skills/uiify/references/elements/card.md)
+
+## Exports
+
+- Runtime: `Card`
+- Types: `CardOwnProps`, `CardProps`
+
+## Props and shapes
+
+### CardOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+
+## Other types
+
+- `CardProps<TAs>`: `RenderableProps<TAs, CardOwnProps, Record<string, never>, HTMLElement>`

package/agents/reference/components/carousel.md

@@ -7,6 +7,10 @@
 - Types file: `dist/components/carousel.d.ts`
 - Note: The documented interactive carousel uses /client and requires hydration for synchronized controls. The base entry remains a native no-JS scroller with CSS Scroll Snap and fragment navigation; /fade adds client-driven CSS transitions.
 
+## Related knowledge
+
+- Recipe: [carousel](../../../skills/uiify/references/elements/carousel.md)
+
 ## Exports
 
 - Runtime: `Carousel`

package/agents/reference/components/checkbox.md

@@ -7,6 +7,10 @@
 - Types file: `dist/components/checkbox.d.ts`
 - Note: Native checkbox + label; default entry ships controlled callbacks with use client.
 
+## Related knowledge
+
+- Recipe: [checkbox](../../../skills/uiify/references/elements/checkbox.md)
+
 ## Exports
 
 - Runtime: `Checkbox`
@@ -23,6 +27,8 @@
 | `checked` | `CheckedState` | no |  |
 | `defaultChecked` | `boolean` | no |  |
 | `disabled` | `boolean` | no |  |
+| `name` | `string` | no |  |
+| `value` | `string` | no |  |
 | `className` | `string` | no |  |
 | `onCheckedChange` | `(checked: boolean) => void` | no |  |
 | `"aria-label"` | `string` | no |  |

package/agents/reference/components/collapsible.md

@@ -5,8 +5,13 @@
 - Tier 0 (RSC — zero client JavaScript); state source S1; native element `details`
 - Without JavaScript: full
 - Types file: `dist/components/collapsible.d.ts`
+- Related native Element (manifest): [details](../elements/details.md)
 - Note: Native details/summary disclosure. Built on @gunkin/uiify/elements/details.
 
+## Related knowledge
+
+- Recipe: [collapsible](../../../skills/uiify/references/elements/collapsible.md)
+
 ## Exports
 
 - Runtime: `Collapsible`

package/agents/reference/components/color-picker.md

@@ -6,6 +6,10 @@
 - Without JavaScript: degraded-documented
 - Types file: `dist/components/color-picker.d.ts`
 
+## Related knowledge
+
+- Recipe: [color-picker](../../../skills/uiify/references/elements/color-picker.md)
+
 ## Exports
 
 - Runtime: `ColorPicker`

package/agents/reference/components/combobox.md

@@ -6,6 +6,10 @@
 - Without JavaScript: pre-hydration-only
 - Types file: `dist/components/combobox.d.ts`
 
+## Related knowledge
+
+- Recipe: [combobox](../../../skills/uiify/references/elements/combobox.md)
+
 ## Exports
 
 - Runtime: `Combobox`, `ComboboxControl`, `ComboboxContent`, `ComboboxEmpty`, `ComboboxInput`, `ComboboxItem`, `ComboboxRoot`, `ComboboxTags`, `ComboboxTrigger`

package/agents/reference/components/context-menu.md

@@ -6,6 +6,10 @@
 - Without JavaScript: pre-hydration-only
 - Types file: `dist/components/context-menu.d.ts`
 
+## Related knowledge
+
+- Recipe: [context-menu](../../../skills/uiify/references/elements/context-menu.md)
+
 ## Exports
 
 - Runtime: `ContextMenu`, `ContextMenuCheckboxItem`, `ContextMenuContent`, `ContextMenuItem`, `ContextMenuLabel`, `ContextMenuRadioItem`, `ContextMenuRoot`, `ContextMenuSeparator`, `ContextMenuSub`, `ContextMenuSubContent`, `ContextMenuSubTrigger`, `ContextMenuTrigger`

package/agents/reference/components/date-picker.md

@@ -0,0 +1,27 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# date-picker
+
+- Import: `@gunkin/uiify/components/date-picker`
+- Tier 0 (RSC — zero client JavaScript); state source native; native element `input[type=date]`
+- Without JavaScript: full
+- Types file: `dist/components/date-picker.d.ts`
+- Note: Native date picker; stylesheet styles the outer input only.
+
+## Related knowledge
+
+- Recipe: [date-picker](../../../skills/uiify/references/elements/date-picker.md)
+
+## Exports
+
+- Runtime: `DatePicker`
+- Types: `DatePickerProps`
+
+## Props and shapes
+
+### DatePickerProps
+
+Extends: `Omit<ComponentPropsWithRef<"input">, "type">`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `invalid` | `boolean` | no |  |

package/agents/reference/components/description-list.md

@@ -0,0 +1,42 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# description-list
+
+- Import: `@gunkin/uiify/components/description-list`
+- Tier 0 (RSC — zero client JavaScript); state source none; native element `dl + dt + dd`
+- Without JavaScript: full
+- Types file: `dist/components/description-list.d.ts`
+
+## Related knowledge
+
+- Recipe: [description-list](../../../skills/uiify/references/elements/description-list.md)
+
+## Exports
+
+- Runtime: `DescriptionDetails`, `DescriptionList`, `DescriptionTerm`
+- Types: `DescriptionDetailsOwnProps`, `DescriptionDetailsProps`, `DescriptionListOwnProps`, `DescriptionListProps`, `DescriptionTermOwnProps`, `DescriptionTermProps`
+
+## Props and shapes
+
+### DescriptionListOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+
+### DescriptionTermOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+
+### DescriptionDetailsOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+
+## Other types
+
+- `DescriptionListProps<TAs>`: `RenderableProps<TAs, DescriptionListOwnProps, Record<string, never>, HTMLElement>`
+- `DescriptionTermProps<TAs>`: `RenderableProps<TAs, DescriptionTermOwnProps, Record<string, never>, HTMLElement>`
+- `DescriptionDetailsProps<TAs>`: `RenderableProps<TAs, DescriptionDetailsOwnProps, Record<string, never>, HTMLElement>`

package/agents/reference/components/drawer.md

@@ -5,8 +5,13 @@
 - Tier 0 (RSC — zero client JavaScript); state source S1; native element `dialog + command=show-modal`
 - Without JavaScript: full
 - Types file: `dist/components/drawer.d.ts`
+- Related native Element (manifest): [dialog](../elements/dialog.md)
 - Note: DrawerPanel native shell + compound Drawer.* client API; snap-point drag on client entry.
 
+## Related knowledge
+
+- Recipe: [drawer](../../../skills/uiify/references/elements/drawer.md)
+
 ## Exports
 
 - Runtime: `Drawer`, `DrawerClose`, `DrawerContent`, `DrawerDescription`, `DrawerHandle`, `DrawerRoot`, `DrawerTitle`, `DrawerTrigger`, `DrawerPanel`, `DrawerNativeTrigger`, `DrawerNativeClose`, `DrawerNativeContent`

package/agents/reference/components/dropdown-menu.md

@@ -6,6 +6,10 @@
 - Without JavaScript: pre-hydration-only
 - Types file: `dist/components/dropdown-menu.d.ts`
 
+## Related knowledge
+
+- Recipe: [dropdown-menu](../../../skills/uiify/references/elements/dropdown-menu.md)
+
 ## Exports
 
 - Runtime: `DropdownMenu`, `DropdownMenuCheckboxItem`, `DropdownMenuContent`, `DropdownMenuGroup`, `DropdownMenuItem`, `DropdownMenuItemDescription`, `DropdownMenuItemIcon`, `DropdownMenuItemIndicator`, `DropdownMenuItemText`, `DropdownMenuLabel`, `DropdownMenuRadioGroup`, `DropdownMenuRadioItem`, `DropdownMenuRoot`, `DropdownMenuSeparator`, `DropdownMenuShortcut`, `DropdownMenuSub`, `DropdownMenuSubContent`, `DropdownMenuSubTrigger`, `DropdownMenuTrigger`, `DropdownMenuBar`

package/agents/reference/components/empty.md

@@ -0,0 +1,49 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# empty
+
+- Import: `@gunkin/uiify/components/empty`
+- Tier 0 (RSC — zero client JavaScript); state source none; native element `section`
+- Without JavaScript: full
+- Types file: `dist/components/empty.d.ts`
+
+## Related knowledge
+
+- Recipe: [empty-state](../../../skills/uiify/references/elements/empty-state.md)
+
+## Exports
+
+- Runtime: `Empty`, `EmptyContent`, `EmptyDescription`, `EmptyTitle`
+- Types: `EmptyContentOwnProps`, `EmptyContentProps`, `EmptyDescriptionOwnProps`, `EmptyDescriptionProps`, `EmptyOwnProps`, `EmptyProps`, `EmptyTitleOwnProps`, `EmptyTitleProps`
+
+## Props and shapes
+
+### EmptyOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+
+### EmptyTitleOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+
+### EmptyDescriptionOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+
+### EmptyContentOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+
+## Other types
+
+- `EmptyProps<TAs>`: `RenderableProps<TAs, EmptyOwnProps, Record<string, never>, HTMLElement>`
+- `EmptyTitleProps<TAs>`: `RenderableProps<TAs, EmptyTitleOwnProps, Record<string, never>, HTMLElement>`
+- `EmptyDescriptionProps<TAs>`: `RenderableProps<TAs, EmptyDescriptionOwnProps, Record<string, never>, HTMLElement>`
+- `EmptyContentProps<TAs>`: `RenderableProps<TAs, EmptyContentOwnProps, Record<string, never>, HTMLElement>`

package/agents/reference/components/field.md

@@ -7,6 +7,11 @@
 - Types file: `dist/components/field.d.ts`
 - Note: :user-invalid + :has() reveals the error message
 
+## Related knowledge
+
+- Recipe: [field](../../../skills/uiify/references/elements/field.md)
+- Example: [field-validation](../../../skills/uiify/references/examples/field-validation.md)
+
 ## Exports
 
 - Runtime: `Field`, `FieldControl`, `FieldDescription`, `FieldError`, `FieldLabel`, `FieldRoot`

package/agents/reference/components/fieldset.md

@@ -0,0 +1,35 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# fieldset
+
+- Import: `@gunkin/uiify/components/fieldset`
+- Tier 0 (RSC — zero client JavaScript); state source native; native element `fieldset + legend`
+- Without JavaScript: full
+- Types file: `dist/components/fieldset.d.ts`
+
+## Related knowledge
+
+- Recipe: [fieldset](../../../skills/uiify/references/elements/fieldset.md)
+
+## Exports
+
+- Runtime: `Fieldset`, `FieldsetLegend`
+- Types: `FieldsetLegendProps`, `FieldsetRootProps`
+
+## Props and shapes
+
+### FieldsetRootOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+
+### FieldsetLegendOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+
+## Other types
+
+- `FieldsetRootProps<TAs>`: `RenderableProps<TAs, FieldsetRootOwnProps, Record<string, never>, HTMLFieldSetElement>`
+- `FieldsetLegendProps<TAs>`: `RenderableProps<TAs, FieldsetLegendOwnProps, Record<string, never>, HTMLLegendElement>`

package/agents/reference/components/file-upload.md

@@ -6,6 +6,10 @@
 - Without JavaScript: degraded-documented
 - Types file: `dist/components/file-upload.d.ts`
 
+## Related knowledge
+
+- Recipe: [file-upload](../../../skills/uiify/references/elements/file-upload.md)
+
 ## Exports
 
 - Runtime: `FileUpload`, `FileUploadDropzone`, `FileUploadHiddenInput`, `FileUploadItem`, `FileUploadItemRemove`, `FileUploadList`, `FileUploadRoot`, `FileUploadTrigger`, `validateFiles`

package/agents/reference/components/form-error-summary.md

@@ -0,0 +1,37 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# form-error-summary
+
+- Import: `@gunkin/uiify/components/form-error-summary`
+- Tier 0 (RSC — zero client JavaScript); state source none; native element `section + heading + ul + links`
+- Without JavaScript: full
+- Types file: `dist/components/form-error-summary.d.ts`
+- Note: Static server-rendered error links; no alert or focus script.
+
+## Related knowledge
+
+- Recipe: [form-error-summary](../../../skills/uiify/references/elements/form-error-summary.md)
+
+## Exports
+
+- Runtime: `FormErrorSummary`
+- Types: `FormErrorSummaryError`, `FormErrorSummaryOwnProps`, `FormErrorSummaryProps`
+
+## Props and shapes
+
+### FormErrorSummaryError
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `href` | `string` | yes |  |
+| `message` | `ReactNode` | yes |  |
+
+### FormErrorSummaryOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `title` | `ReactNode` | yes |  |
+| `errors` | `readonly FormErrorSummaryError[]` | yes |  |
+
+## Other types
+
+- `FormErrorSummaryProps<TAs>`: `RenderableProps<TAs, FormErrorSummaryOwnProps, Record<string, never>, HTMLElement>`