@gunkin/uiify 0.0.19-alpha → 0.0.22-alpha

package/agents/components.md

@@ -55,7 +55,7 @@ its exports, props and shapes; exact types are in the `.d.ts` file listed in the
 | [tooltip](./reference/components/tooltip.md) | `@gunkin/uiify/components/tooltip` | 1 | S1 | `[popover]` | `dist/components/tooltip.d.ts` |  |
 | [hover-card](./reference/components/hover-card.md) | `@gunkin/uiify/components/hover-card` | 1 | S1 | `[popover]` | `dist/components/hover-card.d.ts` |  |
 | [toast](./reference/components/toast.md) | `@gunkin/uiify/components/toast` | 1 | S1 | `[popover] + aria-live` | `dist/components/toast.d.ts` |  |
-| [number-field](./reference/components/number-field.md) | `@gunkin/uiify/components/number-field` | 1 | S1 | `input[type=number]` | `dist/components/number-field.d.ts` |  |
+| [number-field](./reference/components/number-field.md) | `@gunkin/uiify/components/number-field` | 1 | S1 | `input[type=text][role=spinbutton]` | `dist/components/number-field.d.ts` |  |
 | [toolbar](./reference/components/toolbar.md) | `@gunkin/uiify/components/toolbar` | 1 | none | `div[role=toolbar]` | `dist/components/toolbar.d.ts` |  |
 | [file-upload](./reference/components/file-upload.md) | `@gunkin/uiify/components/file-upload` | 1 | S1 | `input[type=file]` | `dist/components/file-upload.d.ts` |  |
 | [header](./reference/components/header.md) | `@gunkin/uiify/components/header` | 0 | S1 | `header` | `dist/components/header.d.ts` | Semantic header root; compose native navigation with Modal. Full functionality without JavaScript; optional header/client adds scroll hide/reveal. |
@@ -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

@@ -20,6 +20,7 @@ exist here.
 | `className={(state) => ...}` | A plain string `className`; select state with `[data-state]`, `[data-disabled]` and friends | `className` is never a function. |
 | `contentClassName`, `triggerClassName`, `itemClassName`, `contentStyle` | `className` / `style` on the part itself | Every public part takes its own `className`. |
 | `onChange={(value) => ...}` on a root or control | `onValueChange`, `onOpenChange`, `onCheckedChange`, `onPageChange` | `onChange` is the native DOM `change` event and receives the event. |
+| English built-in labels in a non-English UI | `labels` and `locale` props; set `lang` and `dir` on `<html>` | Labels are serializable string values; locale formats embedded numbers. |
 | `isOpen`, `isDisabled`, `isChecked` | `open`, `disabled`, `checked` | No `is` prefix. |
 | `placement="bottom-start"` | `side="bottom" align="start"` | One vocabulary for popups. |
 | `data-open` | `data-state="open"` | Open state is `data-state`; there is no `data-open`. |
@@ -60,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
@@ -85,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
@@ -95,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/alert.md

@@ -0,0 +1,44 @@
+<!-- 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`
+
+## 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,26 @@
+<!-- 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.
+
+## 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,32 @@
+<!-- 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`
+
+## 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,31 @@
+<!-- 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`
+
+## 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

@@ -10,15 +10,23 @@
 ## Exports
 
 - Runtime: `Breadcrumb`, `BreadcrumbEllipsis`, `BreadcrumbItem`, `BreadcrumbLink`, `BreadcrumbList`, `BreadcrumbRoot`, `BreadcrumbSeparator`
-- Types: `BreadcrumbItemData`, `BreadcrumbItemProps`, `BreadcrumbLinkOwnProps`, `BreadcrumbLinkProps`, `BreadcrumbListOwnProps`, `BreadcrumbListProps`, `BreadcrumbRootOwnProps`, `BreadcrumbRootProps`, `BreadcrumbSeparatorOwnProps`, `BreadcrumbSeparatorProps`
+- Types: `BreadcrumbItemData`, `BreadcrumbLabels`, `BreadcrumbItemProps`, `BreadcrumbLinkOwnProps`, `BreadcrumbLinkProps`, `BreadcrumbListOwnProps`, `BreadcrumbListProps`, `BreadcrumbRootOwnProps`, `BreadcrumbRootProps`, `BreadcrumbSeparatorOwnProps`, `BreadcrumbSeparatorProps`
 
 ## Props and shapes
 
+### BreadcrumbLabels
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `root` | `string` | yes |  |
+| `showCollapsed` | `string` | yes |  |
+
 ### BreadcrumbRootOwnProps
 
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
 | `"aria-label"` | `string` | no |  |
+| `labels` | `Partial<BreadcrumbLabels>` | no |  |
 
 ### BreadcrumbItemData
 
@@ -36,6 +44,7 @@ One logical breadcrumb entry. Used by `BreadcrumbList`'s `items` prop — the da
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
 | `children` | `ReactNode` | no |  |
+| `labels` | `Partial<BreadcrumbLabels>` | no |  |
 | `items` | `readonly BreadcrumbItemData[]` | no | Data-driven items, required to use `maxItems`. Filtering children by element type (`isValidElement` + a type check) can't see through a Fragment-free `.map()` over route data into a custom wrapper component — a real element only becomes visible to a parent's child introspection once React actually renders it, which hasn't happened yet when `BreadcrumbList` itself runs. An explicit array has no such blind spot. |
 | `itemsAfterCollapse` | `number` | no |  |
 | `itemsBeforeCollapse` | `number` | no |  |
@@ -61,6 +70,7 @@ One logical breadcrumb entry. Used by `BreadcrumbList`'s `items` prop — the da
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
 | `hiddenItems` | `readonly BreadcrumbItemData[]` | yes |  |
+| `labels` | `BreadcrumbLabels` | yes |  |
 | `separator` | `ReactNode` | no |  |
 
 ## Other types

package/agents/reference/components/button.md

@@ -22,11 +22,11 @@
 
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
-| `disabled` | `boolean` | no |  |
+| `disabled` | `boolean` | no | Prevents activation and exposes the disabled state to assistive technology. |
 | `selected` | `boolean` | no | Marks the button as the chosen one of a set, or a toggle that is on. |
-| `type` | `"button" \| "submit" \| "reset"` | no |  |
-| `size` | `ButtonSize` | no |  |
-| `variant` | `ButtonVariant` | no |  |
+| `type` | `"button" \| "submit" \| "reset"` | no | Sets the native button action; defaults to `button`. Set `submit` or `reset` explicitly when needed. |
+| `size` | `ButtonSize` | no | Sets the control's height and, for icon sizes, its width. |
+| `variant` | `ButtonVariant` | no | Sets the visual treatment without changing the control's semantics. |
 
 ### ButtonState
 

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

@@ -10,7 +10,7 @@
 ## Exports
 
 - Runtime: `CandleChart`
-- Types: `CandleChartAxisLabel`, `CandleChartData`, `CandleChartOwnProps`, `CandleChartPointerPosition`, `CandleChartProps`
+- Types: `CandleChartAxisLabel`, `CandleChartLabels`, `CandleChartData`, `CandleChartOwnProps`, `CandleChartPointerPosition`, `CandleChartProps`
 
 ## Props and shapes
 
@@ -43,10 +43,12 @@
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
 | `"aria-label"` | `string` | no |  |
+| `labels` | `Partial<CandleChartLabels>` | no |  |
 | `activeCandleIndex` | `number` | no |  |
 | `cursorY` | `number` | no |  |
 | `data` | `readonly CandleChartData[]` | yes |  |
 | `interactive` | `boolean` | no |  |
+| `locale` | `string` | no | BCP 47 locale for default axis labels. Defaults to `"en-US"`. |
 | `onCandleClick` | `(index: number) => void` | no |  |
 | `onCandlePointerLeave` | `() => void` | no |  |
 | `onCandlePointerMove` | `(position: CandleChartPointerPosition) => void` | no |  |
@@ -54,6 +56,22 @@
 | `xAxis` | `readonly CandleChartAxisLabel[]` | no |  |
 | `yAxis` | `readonly CandleChartAxisLabel[]` | no |  |
 
+### CandleChartLabels
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `chart` | `string` | yes |  |
+| `candle` | `string` | yes |  |
+| `candles` | `string` | yes |  |
+| `months` | `string` | yes |  |
+| `prices` | `string` | yes |  |
+| `data` | `string` | yes |  |
+| `time` | `string` | yes |  |
+| `open` | `string` | yes |  |
+| `high` | `string` | yes |  |
+| `low` | `string` | yes |  |
+| `close` | `string` | yes |  |
+
 ### CandleChartClientOwnProps
 
 Extends: `CandleChartOwnProps`
@@ -81,6 +99,7 @@ Extends: `CandleChartOwnProps`
 | --- | --- | --- | --- |
 | `as` | `"div" \| "li"` | yes |  |
 | `candle` | `CandleChartData` | yes |  |
+| `hitLabel` | `string` | yes |  |
 | `index` | `number` | yes | Index reported to the pointer and click callbacks. |
 | `x` | `number` | yes | Candle position and width, as percentages of the candle layer. |
 | `slot` | `number` | yes |  |

package/agents/reference/components/card.md

@@ -0,0 +1,24 @@
+<!-- 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`
+
+## 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

@@ -34,11 +34,11 @@
 | --- | --- | --- | --- |
 | `previous` | `string` | yes |  |
 | `next` | `string` | yes |  |
-| `goTo` | `string` | yes |  |
+| `goToSlide` | `string` | yes |  |
 | `navigation` | `string` | yes |  |
 | `start` | `string` | yes |  |
 | `stop` | `string` | yes |  |
-| `of` | `string` | yes |  |
+| `slide` | `string` | yes |  |
 
 ### CarouselIcons
 
@@ -68,6 +68,7 @@ Extends: `CSSProperties`
 | `"aria-label"` | `string` | yes |  |
 | `axis` | `CarouselAxis` | no |  |
 | `dir` | `"ltr" \| "rtl"` | no |  |
+| `locale` | `string` | no |  |
 | `navigation` | `boolean` | no |  |
 | `pagination` | `boolean` | no |  |
 | `className` | `string` | no |  |

package/agents/reference/components/checkbox.md

@@ -23,6 +23,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/combobox.md

@@ -80,6 +80,8 @@
 
 ### ComboboxRootShellOwnProps
 
+Extends: `Omit<ComponentPropsWithRef<"div">, "children">`
+
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
 | `className` | `string` | no |  |
@@ -87,7 +89,6 @@
 | `defaultOpen` | `boolean` | no |  |
 | `defaultValue` | `string` | no |  |
 | `filterFn` | `ComboboxFilterFn` | no |  |
-| `id` | `string` | no |  |
 | `items` | `readonly ComboboxItemData[]` | yes |  |
 
 ### ComboboxRootControlledOwnProps

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

@@ -0,0 +1,23 @@
+<!-- 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.
+
+## 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,38 @@
+<!-- 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`
+
+## 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

@@ -10,7 +10,7 @@
 ## Exports
 
 - Runtime: `Drawer`, `DrawerClose`, `DrawerContent`, `DrawerDescription`, `DrawerHandle`, `DrawerRoot`, `DrawerTitle`, `DrawerTrigger`, `DrawerPanel`, `DrawerNativeTrigger`, `DrawerNativeClose`, `DrawerNativeContent`
-- Types: `DrawerCloseOwnProps`, `DrawerCloseProps`, `DrawerContentOwnProps`, `DrawerContentProps`, `DrawerDescriptionOwnProps`, `DrawerHandleOwnProps`, `DrawerRootOwnProps`, `DrawerRootProps`, `DrawerTitleOwnProps`, `DrawerTriggerOwnProps`, `DrawerTriggerProps`, `DrawerProps`, `DrawerSide`, `DrawerAppearanceProps`, `DrawerNativeContentProps`, `DrawerNativeInvokerProps`
+- Types: `DrawerCloseOwnProps`, `DrawerCloseProps`, `DrawerContentOwnProps`, `DrawerContentProps`, `DrawerDescriptionOwnProps`, `DrawerHandleOwnProps`, `DrawerRootOwnProps`, `DrawerRootProps`, `DrawerTitleOwnProps`, `DrawerTriggerOwnProps`, `DrawerTriggerProps`, `DrawerProps`, `DrawerLabels`, `DrawerSide`, `DrawerAppearanceProps`, `DrawerNativeContentProps`, `DrawerNativeInvokerProps`
 
 ## Values
 
@@ -38,10 +38,17 @@ Extends: `DrawerAppearanceProps`
 | `description` | `ReactNode` | no |  |
 | `children` | `ReactNode` | no |  |
 | `closeLabel` | `string` | no |  |
+| `labels` | `Partial<DrawerLabels>` | no |  |
 | `footer` | `ReactNode` | no |  |
 | `side` | `DrawerSide` | no |  |
 | `className` | `string` | no |  |
 
+### DrawerLabels
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `close` | `string` | yes |  |
+
 ### DrawerNativeContentProps
 
 Extends: `Omit<ComponentPropsWithRef<"dialog">, "open" | "popover" | "closedby">`, `DrawerAppearanceProps`

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

@@ -31,7 +31,7 @@ Extends: `UseMenuSurfaceReturn`
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
 | `cancelHoverClose` | `() => void` | yes |  |
-| `dir` | `Direction` | yes |  |
+| `dir` | `Direction` | no |  |
 | `disabled` | `boolean` | yes |  |
 | `hoverEnabledRef` | `RefObject<boolean>` | yes |  |
 | `loop` | `boolean` | yes |  |

package/agents/reference/components/empty.md

@@ -0,0 +1,45 @@
+<!-- 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`
+
+## 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/fieldset.md

@@ -0,0 +1,31 @@
+<!-- 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`
+
+## 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

@@ -9,7 +9,7 @@
 ## Exports
 
 - Runtime: `FileUpload`, `FileUploadDropzone`, `FileUploadHiddenInput`, `FileUploadItem`, `FileUploadItemRemove`, `FileUploadList`, `FileUploadRoot`, `FileUploadTrigger`, `validateFiles`
-- Types: `FileUploadDropzoneOwnProps`, `FileUploadDropzoneProps`, `FileUploadHiddenInputOwnProps`, `FileUploadListOwnProps`, `FileUploadItemRemoveOwnProps`, `FileUploadItemOwnProps`, `FileUploadItemProps`, `FileUploadRootOwnProps`, `FileUploadRootProps`, `FileUploadTriggerOwnProps`, `FileUploadTriggerProps`, `FileRejection`, `FileUploadStore`
+- Types: `FileUploadDropzoneOwnProps`, `FileUploadDropzoneProps`, `FileUploadHiddenInputOwnProps`, `FileUploadLabels`, `FileUploadListOwnProps`, `FileUploadItemRemoveOwnProps`, `FileUploadItemOwnProps`, `FileUploadItemProps`, `FileUploadRootOwnProps`, `FileUploadRootProps`, `FileUploadTriggerOwnProps`, `FileUploadTriggerProps`, `FileRejection`, `FileUploadStore`
 
 ## Props and shapes
 
@@ -20,6 +20,14 @@
 | `file` | `File` | yes |  |
 | `reason` | `"accept" \| "max-size" \| "max-files"` | yes |  |
 
+### FileUploadLabels
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `dropzone` | `string` | yes |  |
+| `remove` | `string` | yes |  |
+| `removeFallback` | `string` | yes |  |
+
 ### FileUploadStoreOptions
 
 | Member | Type | Required | Description |
@@ -55,6 +63,8 @@
 | `removeAt` | `(index: number) => void` | yes |  |
 | `reset` | `() => void` | yes |  |
 | `files` | `readonly File[]` | yes |  |
+| `labels` | `FileUploadLabels` | yes |  |
+| `removeLabel` | `string` | no |  |
 
 ### FileUploadRootOwnProps
 
@@ -66,6 +76,7 @@
 | `disabled` | `boolean` | no |  |
 | `maxFiles` | `number` | no |  |
 | `maxSize` | `number` | no |  |
+| `labels` | `Partial<FileUploadLabels>` | no |  |
 | `minSize` | `number` | no |  |
 | `multiple` | `boolean` | no |  |
 | `onValueChange` | `(files: File[]) => void` | no |  |