@gunkin/uiify 0.0.14-alpha → 0.0.16-alpha

package/agents/reference/components/drawer.md

@@ -0,0 +1,215 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# drawer
+
+- Import: `@gunkin/uiify/components/drawer`
+- 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`
+- Note: DrawerPanel native shell + compound Drawer.* client API; snap-point drag on client entry.
+
+## 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`
+
+## Values
+
+- `DrawerSide`: `"top" | "right" | "bottom" | "left"`
+
+## Props and shapes
+
+### DrawerAppearanceProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `size` | `"sm" \| "md" \| "lg" \| "full"` | no |  |
+| `dismiss` | `"any" \| "closerequest" \| "none"` | no |  |
+| `backdrop` | `"opaque" \| "transparent"` | no |  |
+
+### DrawerProps
+
+Extends: `DrawerAppearanceProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `id` | `string` | yes |  |
+| `trigger` | `ReactNode` | yes |  |
+| `title` | `ReactNode` | yes |  |
+| `description` | `ReactNode` | no |  |
+| `children` | `ReactNode` | no |  |
+| `closeLabel` | `string` | no |  |
+| `footer` | `ReactNode` | no |  |
+| `side` | `DrawerSide` | no |  |
+| `className` | `string` | no |  |
+
+### DrawerNativeContentProps
+
+Extends: `Omit<ComponentPropsWithRef<"dialog">, "open" | "popover" | "closedby">`, `DrawerAppearanceProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `id` | `string` | yes |  |
+| `side` | `DrawerSide` | no |  |
+
+### DrawerNativeInvokerProps
+
+Extends: `Omit<ComponentPropsWithRef<"button">, "command" | "commandFor">`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `target` | `string` | yes |  |
+
+### DrawerStoreOptions
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `activeSnapPoint` | `number` | no |  |
+| `defaultActiveSnapPoint` | `number` | no |  |
+| `dismissible` | `boolean` | no |  |
+| `onDismiss` | `() => void` | no |  |
+| `onSnapChange` | `(snap: number) => void` | no |  |
+| `side` | `DrawerSide` | yes |  |
+| `snapPoints` | `readonly number[]` | no |  |
+
+### DrawerStore
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `endDrag` | `() => void` | yes |  |
+| `getActiveSnapPoint` | `() => number` | yes |  |
+| `getDragOffset` | `() => number` | yes |  |
+| `getTransform` | `() => string` | yes |  |
+| `isDragging` | `() => boolean` | yes |  |
+| `moveDrag` | `(clientCoord: number) => void` | yes |  |
+| `setSide` | `(side: DrawerSide) => void` | yes |  |
+| `setContainerSize` | `(size: number) => void` | yes |  |
+| `startDrag` | `(clientCoord: number) => void` | yes |  |
+| `subscribe` | `(listener: () => void) => () => void` | yes |  |
+| `syncActiveSnapPoint` | `(snap: number) => void` | yes |  |
+
+### DrawerContextValue
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `close` | `(returnValue?: string) => void` | yes |  |
+| `contentId` | `string` | yes |  |
+| `descriptionId` | `string \| undefined` | yes |  |
+| `dialogProps` | `UseDialogReturn["dialogProps"]` | yes |  |
+| `dialogRef` | `UseDialogReturn["dialogRef"]` | yes |  |
+| `dismissible` | `boolean` | yes |  |
+| `closeOnOverlayClick` | `boolean` | yes |  |
+| `labelId` | `string \| undefined` | yes |  |
+| `modal` | `boolean` | yes |  |
+| `open` | `boolean` | yes |  |
+| `openDialog` | `() => void` | yes |  |
+| `setDescriptionId` | `(id: string \| undefined) => void` | yes |  |
+| `setLabelId` | `(id: string \| undefined) => void` | yes |  |
+| `side` | `DrawerSide` | yes |  |
+| `snapEnabled` | `boolean` | yes |  |
+| `store` | `DrawerStore` | yes |  |
+| `triggerRef` | `RefObject<HTMLButtonElement \| null>` | yes |  |
+
+### DrawerRootOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `activeSnapPoint` | `number` | no |  |
+| `closeOnOverlayClick` | `boolean` | no |  |
+| `defaultActiveSnapPoint` | `number` | no |  |
+| `defaultOpen` | `boolean` | no |  |
+| `dismissible` | `boolean` | no |  |
+| `modal` | `boolean` | no |  |
+| `onOpenChange` | `DialogChangeHandler` | no |  |
+| `onSnapChange` | `(snap: number) => void` | no |  |
+| `open` | `boolean` | no |  |
+| `side` | `DrawerSide` | no |  |
+| `snapPoints` | `readonly number[]` | no |  |
+
+### DrawerRootProps
+
+Extends: `DrawerRootOwnProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+
+### DrawerTriggerOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+
+### DrawerTriggerProps
+
+Extends: `DrawerTriggerOwnProps`, `Omit<ComponentPropsWithRef<"button">, "type" | keyof DrawerTriggerOwnProps>`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `onClick` | `(event: MouseEvent<HTMLButtonElement>) => void` | no |  |
+| `ref` | `Ref<HTMLButtonElement>` | no |  |
+
+### DrawerContentOwnProps
+
+Extends: `DrawerAppearanceProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+| `style` | `CSSProperties` | no |  |
+
+### DrawerContentProps
+
+Extends: `DrawerContentOwnProps`, `Omit<ComponentPropsWithRef<"dialog">, "id" | "open" | "closedby" | keyof DrawerContentOwnProps>`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `onCancel` | `DrawerContextValue["dialogProps"]["onCancel"]` | no |  |
+| `onClose` | `DrawerContextValue["dialogProps"]["onClose"]` | no |  |
+| `ref` | `Ref<HTMLDialogElement>` | no |  |
+
+### DrawerTitleOwnProps
+
+Extends: `Omit<ComponentPropsWithRef<"h2">, "id">`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+
+### DrawerDescriptionOwnProps
+
+Extends: `Omit<ComponentPropsWithRef<"p">, "id">`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+
+### DrawerCloseOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+
+### DrawerCloseProps
+
+Extends: `DrawerCloseOwnProps`, `Omit<ComponentPropsWithRef<"button">, "type" | keyof DrawerCloseOwnProps>`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `onClick` | `(event: MouseEvent<HTMLButtonElement>) => void` | no |  |
+
+### DrawerHandleOwnProps
+
+Extends: `ComponentPropsWithRef<"div">`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `className` | `string` | no |  |
+| `onPointerCancel` | `(event: PointerEvent<HTMLDivElement>) => void` | no |  |
+| `onPointerDown` | `(event: PointerEvent<HTMLDivElement>) => void` | no |  |
+| `onPointerMove` | `(event: PointerEvent<HTMLDivElement>) => void` | no |  |
+| `onPointerUp` | `(event: PointerEvent<HTMLDivElement>) => void` | no |  |

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

@@ -0,0 +1,178 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# dropdown-menu
+
+- Import: `@gunkin/uiify/components/dropdown-menu`
+- Tier 2 (Client component — pre-hydration SSR); state source S2; native element `[popover]+commandfor`
+- Without JavaScript: pre-hydration-only
+- Types file: `dist/components/dropdown-menu.d.ts`
+
+## Exports
+
+- Runtime: `DropdownMenu`, `DropdownMenuCheckboxItem`, `DropdownMenuContent`, `DropdownMenuGroup`, `DropdownMenuItem`, `DropdownMenuItemDescription`, `DropdownMenuItemIcon`, `DropdownMenuItemIndicator`, `DropdownMenuItemText`, `DropdownMenuLabel`, `DropdownMenuRadioGroup`, `DropdownMenuRadioItem`, `DropdownMenuRoot`, `DropdownMenuSeparator`, `DropdownMenuShortcut`, `DropdownMenuSub`, `DropdownMenuSubContent`, `DropdownMenuSubTrigger`, `DropdownMenuTrigger`, `DropdownMenuBar`
+- Types: `MenuSelectEvent`, `DropdownMenuBarOwnProps`, `DropdownMenuBarProps`, `DropdownMenuContentOwnProps`, `DropdownMenuContentProps`, `DropdownMenuCheckedState`, `DropdownMenuCheckboxItemOwnProps`, `DropdownMenuCheckboxItemProps`, `DropdownMenuGroupOwnProps`, `DropdownMenuItemDescriptionProps`, `DropdownMenuItemIconProps`, `DropdownMenuItemIndicatorProps`, `DropdownMenuItemOwnProps`, `DropdownMenuItemProps`, `DropdownMenuItemTextProps`, `DropdownMenuLabelOwnProps`, `DropdownMenuOpenChangeDetails`, `DropdownMenuOpenChangeReason`, `DropdownMenuPartOwnProps`, `DropdownMenuPartProps`, `DropdownMenuRadioGroupOwnProps`, `DropdownMenuRadioGroupProps`, `DropdownMenuRadioItemOwnProps`, `DropdownMenuRadioItemProps`, `DropdownMenuRootControlledOwnProps`, `DropdownMenuRootShellOwnProps`, `DropdownMenuRootShellProps`, `DropdownMenuRootOwnProps`, `DropdownMenuRootProps`, `DropdownMenuSeparatorOwnProps`, `DropdownMenuShortcutProps`, `DropdownMenuSubContentProps`, `DropdownMenuSubOwnProps`, `DropdownMenuSubProps`, `DropdownMenuSubTriggerOwnProps`, `DropdownMenuSubTriggerProps`, `DropdownMenuTriggerOwnProps`, `DropdownMenuTriggerProps`
+
+## Values
+
+- `DropdownMenuOpenChangeReason`: `"trigger-press" | "item-select" | "escape" | "focus-out" | "outside-press" | "programmatic"`
+
+## Props and shapes
+
+### DropdownMenuOpenChangeDetails
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `event` | `Event \| null` | yes |  |
+| `reason` | `DropdownMenuOpenChangeReason` | yes |  |
+
+### DropdownMenuContextValue
+
+Extends: `UseMenuSurfaceReturn`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `cancelHoverClose` | `() => void` | yes |  |
+| `dir` | `Direction` | yes |  |
+| `disabled` | `boolean` | yes |  |
+| `hoverEnabledRef` | `RefObject<boolean>` | yes |  |
+| `loop` | `boolean` | yes |  |
+| `scheduleHoverClose` | `() => void` | yes |  |
+
+### DropdownMenuBarOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+| `dir` | `Direction` | no |  |
+| `loop` | `boolean` | no |  |
+
+### DropdownMenuRootOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `className` | `string` | no |  |
+| `children` | `ReactNode` | no |  |
+| `defaultOpen` | `boolean` | no |  |
+| `dir` | `Direction` | no |  |
+| `disabled` | `boolean` | no |  |
+| `id` | `string` | no |  |
+| `loop` | `boolean` | no |  |
+| `onOpenChange` | `(open: boolean, details: DropdownMenuOpenChangeDetails) => void` | no |  |
+| `open` | `boolean` | no |  |
+
+### DropdownMenuTriggerOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+| `openOnHover` | `boolean` | no |  |
+
+### DropdownMenuContentOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `align` | `AnchorAlign` | no |  |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+| `side` | `AnchorSide` | no |  |
+
+### DropdownMenuItemOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+| `closeOnSelect` | `boolean` | no |  |
+| `disabled` | `boolean` | no |  |
+| `onSelect` | `(event: MenuSelectEvent) => void` | no |  |
+| `textValue` | `string` | no |  |
+
+### DropdownMenuCheckboxItemOwnProps
+
+Extends: `DropdownMenuItemOwnProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `checked` | `DropdownMenuCheckedState` | no |  |
+| `defaultChecked` | `DropdownMenuCheckedState` | no |  |
+| `onCheckedChange` | `(checked: boolean) => void` | no |  |
+
+### DropdownMenuRadioGroupOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+| `defaultValue` | `string` | no |  |
+| `onValueChange` | `(value: string) => void` | no |  |
+| `value` | `string` | no |  |
+
+### DropdownMenuRadioItemOwnProps
+
+Extends: `DropdownMenuItemOwnProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `value` | `string` | yes |  |
+
+### DropdownMenuSubOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `defaultOpen` | `boolean` | no |  |
+| `onOpenChange` | `(open: boolean, details: DropdownMenuOpenChangeDetails) => void` | no |  |
+| `open` | `boolean` | no |  |
+
+### DropdownMenuSubTriggerOwnProps
+
+Extends: `DropdownMenuItemOwnProps`
+
+No own members.
+
+### DropdownMenuPartOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+
+### DropdownMenuSubContextValue
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `contentRef` | `RefObject<HTMLElement \| null>` | yes |  |
+| `open` | `boolean` | yes |  |
+| `setOpen` | `(open: boolean, reason: DropdownMenuOpenChangeReason, event?: Event \| null) => void` | yes |  |
+| `triggerRef` | `RefObject<HTMLElement \| null>` | yes |  |
+
+## Other types
+
+- `DropdownMenuCheckedState`: `boolean | "indeterminate"`
+- `DropdownMenuBarProps`: `DropdownMenuBarOwnProps`
+- `DropdownMenuRootProps`: `DropdownMenuRootOwnProps`
+- `DropdownMenuRootShellOwnProps`: `DropdownMenuRootOwnProps`
+- `DropdownMenuRootControlledOwnProps`: `Pick<DropdownMenuRootOwnProps, "onOpenChange" | "open">`
+- `DropdownMenuRootShellProps`: `DropdownMenuRootOwnProps`
+- `DropdownMenuTriggerProps<TAs>`: `RenderableProps<TAs, DropdownMenuTriggerOwnProps, { open: boolean }, HTMLElement>`
+- `DropdownMenuContentProps<TAs>`: `RenderableProps<TAs, DropdownMenuContentOwnProps, { open: boolean }, HTMLElement>`
+- `DropdownMenuItemProps<TAs>`: `RenderableProps<TAs, DropdownMenuItemOwnProps, { disabled: boolean }, HTMLElement>`
+- `DropdownMenuCheckboxItemProps<TAs>`: `RenderableProps<TAs, DropdownMenuCheckboxItemOwnProps, { checked: DropdownMenuCheckedState; disabled: boolean }, HTMLElement>`
+- `DropdownMenuRadioGroupProps<TAs>`: `RenderableProps<TAs, DropdownMenuRadioGroupOwnProps, { value: string | undefined }, HTMLElement>`
+- `DropdownMenuRadioItemProps<TAs>`: `RenderableProps<TAs, DropdownMenuRadioItemOwnProps, { checked: boolean; disabled: boolean }, HTMLElement>`
+- `DropdownMenuSubProps`: `DropdownMenuSubOwnProps`
+- `DropdownMenuSubTriggerProps<TAs>`: `RenderableProps<TAs, DropdownMenuSubTriggerOwnProps, { disabled: boolean; open: boolean }, HTMLElement>`
+- `DropdownMenuSubContentProps<TAs>`: `RenderableProps<TAs, DropdownMenuContentOwnProps, { open: boolean }, HTMLElement>`
+- `DropdownMenuPartProps<TAs>`: `RenderableProps<TAs, DropdownMenuPartOwnProps, Record<string, never>, HTMLElement>`
+- `DropdownMenuGroupOwnProps`: `DropdownMenuPartOwnProps`
+- `DropdownMenuLabelOwnProps`: `DropdownMenuPartOwnProps`
+- `DropdownMenuSeparatorOwnProps`: `Omit<DropdownMenuPartOwnProps, "children">`
+- `DropdownMenuGroupProps<TAs>`: `MenuGroupProps<TAs>`
+- `DropdownMenuLabelProps<TAs>`: `MenuLabelProps<TAs>`
+- `DropdownMenuSeparatorProps<TAs>`: `MenuSeparatorProps<TAs>`
+- `DropdownMenuItemIconProps<TAs>`: `DropdownMenuPartProps<TAs>`
+- `DropdownMenuItemTextProps<TAs>`: `DropdownMenuPartProps<TAs>`
+- `DropdownMenuItemDescriptionProps<TAs>`: `DropdownMenuPartProps<TAs>`
+- `DropdownMenuShortcutProps<TAs>`: `DropdownMenuPartProps<TAs>`
+- `DropdownMenuItemIndicatorProps<TAs>`: `DropdownMenuPartProps<TAs>`

package/agents/reference/components/field.md

@@ -0,0 +1,76 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# field
+
+- Import: `@gunkin/uiify/components/field`
+- Tier 0 (RSC — zero client JavaScript); state source none; native element `div:has(input)`
+- Without JavaScript: full
+- Types file: `dist/components/field.d.ts`
+- Note: :user-invalid + :has() reveals the error message
+
+## Exports
+
+- Runtime: `Field`, `FieldControl`, `FieldDescription`, `FieldError`, `FieldLabel`, `FieldRoot`
+- Types: `FieldControlProps`, `FieldDescriptionProps`, `FieldErrorProps`, `FieldLabelProps`, `FieldRootOwnProps`, `FieldRootProps`
+
+## Props and shapes
+
+### FieldRootOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `id` | `string` | yes | Stable id for deterministic label/control/error wiring. Required. |
+| `invalid` | `boolean` | no |  |
+| `required` | `boolean` | no |  |
+| `disabled` | `boolean` | no |  |
+| `name` | `string` | no |  |
+
+### FieldPartOwnProps
+
+Every part connects to Field.Root by this one explicit prop — the same `id` passed to Root — instead of props injected via child traversal.
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `fieldId` | `string` | yes |  |
+
+### FieldLabelOwnProps
+
+Extends: `FieldPartOwnProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `disabled` | `boolean` | no |  |
+| `required` | `boolean` | no |  |
+
+### FieldControlOwnProps
+
+Extends: `FieldPartOwnProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `disabled` | `boolean` | no |  |
+| `invalid` | `boolean` | no |  |
+| `required` | `boolean` | no |  |
+
+### FieldDescriptionOwnProps
+
+Extends: `FieldPartOwnProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `disabled` | `boolean` | no |  |
+
+### FieldErrorOwnProps
+
+Extends: `FieldPartOwnProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `invalid` | `boolean` | no |  |
+
+## Other types
+
+- `FieldRootProps<TAs>`: `RenderableProps<TAs, FieldRootOwnProps, FieldRootOwnProps, HTMLElement>`
+- `FieldLabelProps`: `FieldLabelOwnProps & Omit<HTMLAttributes<HTMLLabelElement>, "htmlFor" | keyof FieldLabelOwnProps>`
+- `FieldControlProps<TAs>`: `RenderableProps<TAs, FieldControlOwnProps, { disabled: boolean; invalid: boolean; required: boolean }, HTMLElement>`
+- `FieldDescriptionProps`: `FieldDescriptionOwnProps & Omit<HTMLAttributes<HTMLElement>, keyof FieldDescriptionOwnProps>`
+- `FieldErrorProps`: `FieldErrorOwnProps & Omit<HTMLAttributes<HTMLElement>, keyof FieldErrorOwnProps>`

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

@@ -0,0 +1,131 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# file-upload
+
+- Import: `@gunkin/uiify/components/file-upload`
+- Tier 1 (RSC shell + thin client island); state source S1; native element `input[type=file]`
+- Without JavaScript: degraded-documented
+- Types file: `dist/components/file-upload.d.ts`
+
+## 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`
+
+## Props and shapes
+
+### FileRejection
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `file` | `File` | yes |  |
+| `reason` | `"accept" \| "max-size" \| "max-files"` | yes |  |
+
+### FileUploadStoreOptions
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `accept` | `readonly string[]` | no |  |
+| `maxFiles` | `number` | no |  |
+| `maxSize` | `number` | no |  |
+| `minSize` | `number` | no |  |
+| `multiple` | `boolean` | no |  |
+
+### FileUploadStore
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `addFiles` | `(next: readonly File[]) => void` | yes |  |
+| `clear` | `() => void` | yes |  |
+| `getFiles` | `() => File[]` | yes |  |
+| `removeAt` | `(index: number) => void` | yes |  |
+| `setFiles` | `(next: readonly File[]) => void` | yes |  |
+| `subscribe` | `(listener: () => void) => () => void` | yes |  |
+
+### FileUploadContextValue
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `accept` | `readonly string[]` | yes |  |
+| `disabled` | `boolean` | yes |  |
+| `hiddenInputRef` | `RefObject<HTMLInputElement \| null>` | yes |  |
+| `inputId` | `string` | yes |  |
+| `multiple` | `boolean` | yes |  |
+| `openPicker` | `() => void` | yes |  |
+| `processFiles` | `(list: FileList \| readonly File[]) => void` | yes |  |
+| `removeAt` | `(index: number) => void` | yes |  |
+| `reset` | `() => void` | yes |  |
+| `files` | `readonly File[]` | yes |  |
+
+### FileUploadRootOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `className` | `string` | no |  |
+| `accept` | `readonly string[]` | no |  |
+| `defaultValue` | `readonly File[]` | no |  |
+| `disabled` | `boolean` | no |  |
+| `maxFiles` | `number` | no |  |
+| `maxSize` | `number` | no |  |
+| `minSize` | `number` | no |  |
+| `multiple` | `boolean` | no |  |
+| `onValueChange` | `(files: File[]) => void` | no |  |
+| `onReject` | `(rejections: FileRejection[]) => void` | no |  |
+| `value` | `readonly File[]` | no |  |
+
+### FileUploadRootProps
+
+Extends: `FileUploadRootOwnProps`, `Omit<ComponentPropsWithRef<"div">, keyof FileUploadRootOwnProps | "defaultValue">`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+
+### FileUploadHiddenInputOwnProps
+
+Extends: `Omit<ComponentPropsWithRef<"input">, "type" | "value" | "defaultValue" | "accept" | "multiple" | "disabled">`
+
+No own members.
+
+### FileUploadTriggerOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+
+### FileUploadDropzoneOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+
+### FileUploadListOwnProps
+
+Extends: `Omit<ComponentPropsWithRef<"ul">, "children">`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode \| ((files: readonly File[]) => ReactNode)` | no |  |
+
+### FileUploadItemOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+| `index` | `number` | yes |  |
+
+### FileUploadItemRemoveOwnProps
+
+Extends: `ComponentPropsWithRef<"button">`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `index` | `number` | yes |  |
+
+## Other types
+
+- `FileUploadTriggerProps<TAs>`: `RenderableProps<TAs, FileUploadTriggerOwnProps, { disabled: boolean }, HTMLElement>`
+- `FileUploadDropzoneProps<TAs>`: `RenderableProps<TAs, FileUploadDropzoneOwnProps, { disabled: boolean }, HTMLElement>`
+- `FileUploadItemProps<TAs>`: `RenderableProps<TAs, FileUploadItemOwnProps, { index: number }, HTMLElement>`

package/agents/reference/components/form.md

@@ -0,0 +1,28 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# form
+
+- Import: `@gunkin/uiify/components/form`
+- Tier 0 (RSC — zero client JavaScript); state source none; native element `form`
+- Without JavaScript: full
+- Types file: `dist/components/form.d.ts`
+
+## Exports
+
+- Runtime: `Form`
+- Types: `FormOwnProps`, `FormProps`, `ValidationBehavior`
+
+## Values
+
+- `ValidationBehavior`: `"native" | "aria"`
+
+## Props and shapes
+
+### FormOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `validationBehavior` | `ValidationBehavior` | no |  |
+
+## Other types
+
+- `FormProps<TAs>`: `RenderableProps<TAs, FormOwnProps, FormOwnProps, HTMLFormElement>`

package/agents/reference/components/header.md

@@ -0,0 +1,44 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# header
+
+- Import: `@gunkin/uiify/components/header`
+- Tier 0 (RSC — zero client JavaScript); state source S1; native element `header`
+- Without JavaScript: full
+- Types file: `dist/components/header.d.ts`
+- Note: Semantic header root; compose native navigation with Modal. Full functionality without JavaScript; optional header/client adds scroll hide/reveal.
+
+## Exports
+
+- Runtime: `Header`, `HeaderRoot`
+- Types: `HeaderClientProps`, `HeaderClientState`, `HeaderPlacement`, `HeaderRootProps`
+
+## Values
+
+- `HeaderPlacement`: `"static" | "sticky"`
+- `HeaderClientState`: `"top" | "visible" | "hidden"`
+
+## Props and shapes
+
+### HeaderRootProps
+
+Extends: `ComponentPropsWithRef<"header">`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `placement` | `HeaderPlacement` | no |  |
+
+### HeaderClientProps
+
+Extends: `HeaderRootProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `hideOnScroll` | `boolean` | no |  |
+| `scrollTarget` | `string` | no |  |
+
+## Sub-entries
+
+### `@gunkin/uiify/components/header/client`
+
+- Runtime: `HeaderClient`
+- Types: `HeaderClientProps`, `HeaderClientState`