@gunkin/uiify 0.0.13-alpha → 0.0.15-alpha

package/agents/reference/components/hover-card.md

@@ -0,0 +1,54 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# hover-card
+
+- Import: `@gunkin/uiify/components/hover-card`
+- Tier 1 (RSC shell + thin client island); state source S1; native element `[popover]`
+- Without JavaScript: degraded-documented
+- Types file: `dist/components/hover-card.d.ts`
+
+## Exports
+
+- Runtime: `HoverCard`
+- Types: `HoverCardContentOwnProps`, `HoverCardContentProps`, `HoverCardRootOwnProps`, `HoverCardRootProps`, `HoverCardTriggerOwnProps`, `HoverCardTriggerProps`
+
+## Props and shapes
+
+### HoverCardRootOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `closeDelay` | `number` | no |  |
+| `defaultOpen` | `boolean` | no |  |
+| `id` | `string` | no |  |
+| `onOpenChange` | `PopoverChangeHandler` | no |  |
+| `open` | `boolean` | no |  |
+| `openDelay` | `number` | no |  |
+
+### HoverCardRootProps
+
+Extends: `HoverCardRootOwnProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+
+### HoverCardTriggerOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+
+### HoverCardContentOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `align` | `AnchorAlign` | no |  |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+| `side` | `AnchorSide` | no |  |
+
+## Other types
+
+- `HoverCardTriggerProps<TAs>`: `RenderableProps<TAs, HoverCardTriggerOwnProps, { open: boolean; positioning: "native" }, HTMLElement>`
+- `HoverCardContentProps<TAs>`: `RenderableProps<TAs, HoverCardContentOwnProps, { open: boolean; positioning: "native" }, HTMLElement>`

package/agents/reference/components/input.md

@@ -0,0 +1,29 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# input
+
+- Import: `@gunkin/uiify/components/input`
+- Tier 0 (RSC — zero client JavaScript); state source S1; native element `input`
+- Without JavaScript: full
+- Types file: `dist/components/input.d.ts`
+
+## Exports
+
+- Runtime: `Input`
+- Types: `InputOwnProps`, `InputProps`
+
+## Props and shapes
+
+### InputOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `value` | `string` | no |  |
+| `defaultValue` | `string` | no |  |
+| `onValueChange` | `(value: string) => void` | no |  |
+| `disabled` | `boolean` | no |  |
+| `readOnly` | `boolean` | no |  |
+| `invalid` | `boolean` | no |  |
+
+## Other types
+
+- `InputProps<TAs>`: `RenderableProps<TAs, InputOwnProps, InputOwnProps, HTMLInputElement>`

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

@@ -0,0 +1,104 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# line-chart
+
+- Import: `@gunkin/uiify/components/line-chart`
+- Tier 0 (RSC — zero client JavaScript); state source none; native element `figure>ol>li`
+- Without JavaScript: full
+- Types file: `dist/components/line-chart.d.ts`
+- Note: Static line segments are computed during render and expressed as percentage CSS custom properties; the decorative CSS line has an accessible table fallback.
+
+## Exports
+
+- Runtime: `LineChart`
+- Types: `LineChartAxisLabel`, `LineChartData`, `LineChartOwnProps`, `LineChartPointerPosition`, `LineChartProps`
+
+## Props and shapes
+
+### LineChartData
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `time` | `string \| number` | yes |  |
+| `value` | `number` | yes |  |
+
+### LineChartAxisLabel
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `label` | `ReactNode` | yes |  |
+| `position` | `number` | yes | Position on the axis as a percentage from 0 to 100. |
+
+### LineChartPointerPosition
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `index` | `number` | yes |  |
+| `offsetY` | `number` | yes | Pointer offset inside the point hit area, in CSS pixels. |
+
+### LineChartOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `"aria-label"` | `string` | no |  |
+| `activePointIndex` | `number` | no |  |
+| `cursorY` | `number` | no |  |
+| `data` | `readonly LineChartData[]` | yes |  |
+| `interactive` | `boolean` | no |  |
+| `onPointClick` | `(index: number) => void` | no |  |
+| `onPointPointerLeave` | `() => void` | no |  |
+| `onPointPointerMove` | `(position: LineChartPointerPosition) => void` | no |  |
+| `selectedPointIndex` | `number` | no |  |
+| `xAxis` | `readonly LineChartAxisLabel[]` | no |  |
+| `yAxis` | `readonly LineChartAxisLabel[]` | no |  |
+
+### LineChartClientOwnProps
+
+Extends: `LineChartOwnProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `visibleCount` | `number` | no | Live mode: sizes point slots so `visibleCount` fill the viewport and virtualizes the full history with a horizontal VirtualScroll. The chart follows new points while the reader is at the newest one; the value scale, axes, readout, and data table follow the visible points. Zoom is disabled. |
+
+### LineChartViewProps
+
+Internal props the client entry passes to `LineChart`; not part of the public API.
+
+Extends: `LineChartOwnProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `pointLayer` | `ReactNode` | no | Replaces the static point list (e.g. with a virtualized layer). |
+| `announceReadout` | `boolean` | no | Announce readout changes; off for streaming data. Defaults to `true`. |
+| `slotCount` | `number` | no | Point slots across the content. When set, the crosshair sits at slot centers — `(slotOffset + index + 0.5) / slotCount` — instead of spreading `data` edge to edge. |
+| `slotOffset` | `number` | no | Slot of `data[0]` when `data` is a slice. Defaults to `0`. |
+
+### LineChartPointProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `as` | `"div" \| "li"` | yes |  |
+| `point` | `LineChartData` | yes |  |
+| `previousPoint` | `LineChartData \| undefined` | yes |  |
+| `index` | `number` | yes | Index reported to the pointer and click callbacks, and used for x in the static list. |
+| `count` | `number` | yes |  |
+| `min` | `number` | yes |  |
+| `max` | `number` | yes |  |
+| `interactive` | `boolean` | yes |  |
+| `isActive` | `boolean` | yes |  |
+| `isSelected` | `boolean` | yes |  |
+| `cursorY` | `number \| undefined` | no |  |
+| `onPointClick` | `((index: number) => void) \| undefined` | no |  |
+| `onPointPointerLeave` | `(() => void) \| undefined` | no |  |
+| `onPointPointerMove` | `((position: LineChartPointerPosition) => void) \| undefined` | no |  |
+
+## Other types
+
+- `LineChartProps<TAs>`: `RenderableProps<TAs, LineChartOwnProps, Record<string, never>, HTMLElement>`
+- `LineChartClientProps<TAs>`: `RenderableProps<TAs, LineChartClientOwnProps, Record<string, never>, HTMLElement>`
+
+## Sub-entries
+
+### `@gunkin/uiify/components/line-chart/client`
+
+- Runtime: `LineChartClient`
+- Types: `LineChartAxisLabel`, `LineChartClientOwnProps`, `LineChartClientProps`, `LineChartData`, `LineChartOwnProps`, `LineChartPointerPosition`, `LineChartProps`

package/agents/reference/components/modal.md

@@ -0,0 +1,106 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# modal
+
+- Import: `@gunkin/uiify/components/modal`
+- Tier 0 (RSC — zero client JavaScript); state source S1; native element `dialog + command=show-modal`
+- Without JavaScript: full
+- Types file: `dist/components/modal.d.ts`
+- Note: True modal via show-modal/request-close; the browser owns inertness, Escape and focus return. Controlled/initially open state lives in @gunkin/uiify/components/modal/client. Trigger/Close built on @gunkin/uiify/elements/dialog. Backdrop tap and swipe-down are optional UIEnhance improvements; without them the modal still closes by icon, Escape and (Chrome/Firefox) backdrop tap.
+
+## Exports
+
+- Runtime: `Modal`, `ModalBody`, `ModalClose`, `ModalContent`, `ModalDescription`, `ModalFooter`, `ModalGrabber`, `ModalHeader`, `ModalTitle`, `ModalTrigger`
+- Types: `ModalAlign`, `ModalAppearanceProps`, `ModalBackdrop`, `ModalBodyProps`, `ModalCloseOwnProps`, `ModalCloseProps`, `ModalContentOwnProps`, `ModalContentProps`, `ModalDescriptionProps`, `ModalDismiss`, `ModalFooterProps`, `ModalGrabberProps`, `ModalHeaderProps`, `ModalProps`, `ModalSize`, `ModalTitleProps`, `ModalTriggerOwnProps`, `ModalTriggerProps`
+
+## Values
+
+- `ModalSize`: `"sm" | "md" | "lg" | "full"`
+- `ModalAlign`: `"center" | "start"`
+- `ModalDismiss`: `"any" | "closerequest" | "none"`
+- `ModalBackdrop`: `"opaque" | "blur" | "none"`
+
+## Props and shapes
+
+### ModalAppearanceProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `size` | `ModalSize \| undefined` | no | Width step; `full` fills the viewport. Default `md`. |
+| `align` | `ModalAlign \| undefined` | no | Vertical position on tablet and desktop; phones get a bottom sheet unless `size` is `full`. Default `center`. |
+| `dismiss` | `ModalDismiss \| undefined` | no | Native `closedby`: `any` also closes on a backdrop tap, `closerequest` on Escape only, `none` only through your own controls. Default `any`. Engines without `closedby` (Safari) ignore it: Escape still closes the dialog there, and `UIEnhance` honours it only for its own backdrop tap (`any` only) and sheet swipe (off for `none`). |
+| `backdrop` | `ModalBackdrop \| undefined` | no | Backdrop treatment. Default `opaque`. |
+
+### ModalProps
+
+Extends: `ModalAppearanceProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `id` | `string` | yes |  |
+| `trigger` | `ReactNode` | yes |  |
+| `title` | `ReactNode` | yes |  |
+| `description` | `ReactNode` | no |  |
+| `children` | `ReactNode` | no |  |
+| `closeLabel` | `string` | no | Accessible name of the header close icon. |
+| `footer` | `ReactNode` | no | Actions row pinned under the body. |
+| `className` | `string` | no |  |
+
+### ModalTriggerOwnProps
+
+Own props of the native `show-modal` invoker.
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `target` | `string` | yes | `id` of the `ModalContent` this button opens; the browser resolves it at click time. |
+
+### ModalCloseOwnProps
+
+Own props of the native `request-close` invoker.
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `target` | `string` | yes | `id` of the `ModalContent` this button closes. |
+
+### ModalContentOwnProps
+
+Extends: `ModalAppearanceProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `id` | `string` | yes | Unique id supplied by the consumer; referenced by trigger and close `target`. |
+
+### ModalClientContentOwnProps
+
+Extends: `ModalAppearanceProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `defaultOpen` | `boolean` | no | Uncontrolled initial state, applied with `showModal()` after hydration; SSR markup stays closed. |
+| `id` | `string` | yes |  |
+| `onOpenChange` | `(open: boolean) => void` | no | Fires once per native or programmatic change with the state the element just entered. Also fires once at mount if the browser opened the dialog natively before hydration. Not reported: a pre-hydration open→close cycle that nets back to closed — the DOM retains no `toggle` history, so there is no evidence left that a transition happened at all. |
+| `onOpenChangeComplete` | `(open: boolean) => void` | no | Fires once per open or close transition, after the dialog's CSS transitions have finished (immediately when there are none). This includes the transition that applies `defaultOpen` after hydration; it does not fire for a dialog that never changes state. |
+| `open` | `boolean` | no | Controlled state, authoritative after hydration. |
+
+## Other types
+
+- `ModalTriggerProps<TAs>`: `NativeButtonProps<TAs, ModalTriggerOwnProps>`
+- `ModalCloseProps<TAs>`: `NativeButtonProps<TAs, ModalCloseOwnProps>`
+- `ModalContentProps`: `ModalContentOwnProps & Omit<ComponentPropsWithRef<"dialog">, keyof ModalContentOwnProps | "open" | "popover" | "closedby">` — A plain, initially closed `<dialog>`: `open` and `popover` are not part of the native contract.
+- `ModalClientContentProps`: `ModalClientContentOwnProps & Omit<ComponentPropsWithRef<"dialog">, keyof ModalClientContentOwnProps | "popover" | "closedby">` — Props of the client adapter; `popover` is excluded because the adapter is always modal.
+- `ModalHeaderProps`: `ComponentPropsWithRef<"div">`
+- `ModalTitleProps`: `ComponentPropsWithRef<"h2">`
+- `ModalDescriptionProps`: `ComponentPropsWithRef<"p">`
+- `ModalBodyProps`: `ComponentPropsWithRef<"div">`
+- `ModalFooterProps`: `ComponentPropsWithRef<"div">`
+- `ModalGrabberProps`: `Omit<ComponentPropsWithRef<"div">, "children">`
+
+## Sub-entries
+
+### `@gunkin/uiify/components/modal/client`
+
+- Runtime: `ModalClientContent`
+- Types: `ModalClientContentOwnProps`, `ModalClientContentProps`

package/agents/reference/components/number-field.md

@@ -0,0 +1,60 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# number-field
+
+- Import: `@gunkin/uiify/components/number-field`
+- Tier 1 (RSC shell + thin client island); state source S1; native element `input[type=number]`
+- Without JavaScript: degraded-documented
+- Types file: `dist/components/number-field.d.ts`
+
+## Exports
+
+- Runtime: `NumberField`, `NumberFieldDecrement`, `NumberFieldGroup`, `NumberFieldIncrement`, `NumberFieldInput`, `NumberFieldRoot`
+- Types: `NumberFieldDecrementProps`, `NumberFieldGroupProps`, `NumberFieldIncrementProps`, `NumberFieldInputProps`, `NumberFieldRootOwnProps`, `NumberFieldRootProps`
+
+## Props and shapes
+
+### NumberFieldContextValue
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `clampValueOnBlur` | `boolean` | yes |  |
+| `commitInput` | `(raw: string) => void` | yes |  |
+| `decrement` | `(multiplier?: number) => void` | yes |  |
+| `disabled` | `boolean` | yes |  |
+| `displayValue` | `string` | yes |  |
+| `formatter` | `Intl.NumberFormat` | yes |  |
+| `increment` | `(multiplier?: number) => void` | yes |  |
+| `inputId` | `string` | yes |  |
+| `inputRef` | `RefObject<HTMLInputElement \| null>` | yes |  |
+| `max` | `number \| undefined` | no |  |
+| `min` | `number \| undefined` | no |  |
+| `numericValue` | `number \| undefined` | yes |  |
+| `readOnly` | `boolean` | yes |  |
+| `required` | `boolean` | yes |  |
+| `setDisplayValue` | `(next: string) => void` | yes |  |
+| `setEditing` | `(next: boolean) => void` | yes |  |
+
+### NumberFieldRootOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `allowWheel` | `boolean` | no |  |
+| `clampValueOnBlur` | `boolean` | no |  |
+| `defaultValue` | `number` | no |  |
+| `disabled` | `boolean` | no |  |
+| `formatOptions` | `Intl.NumberFormatOptions` | no |  |
+| `max` | `number` | no |  |
+| `min` | `number` | no |  |
+| `onValueChange` | `(value: number \| undefined) => void` | no |  |
+| `readOnly` | `boolean` | no |  |
+| `required` | `boolean` | no |  |
+| `step` | `number` | no |  |
+| `value` | `number` | no |  |
+
+## Other types
+
+- `NumberFieldRootProps<TAs>`: `RenderableProps<TAs, NumberFieldRootOwnProps, NumberFieldRootOwnProps, HTMLElement>`
+- `NumberFieldGroupProps<TAs>`: `RenderableProps<TAs, { readonly children?: ReactNode }, { disabled: boolean }, HTMLElement>`
+- `NumberFieldInputProps<TAs>`: `RenderableProps<TAs, Record<string, never>, { disabled: boolean; readOnly: boolean; required: boolean }, HTMLInputElement>`
+- `NumberFieldIncrementProps<TAs>`: `RenderableProps<TAs, { readonly children?: ReactNode }, { disabled: boolean }, HTMLButtonElement>`
+- `NumberFieldDecrementProps<TAs>`: `RenderableProps<TAs, { readonly children?: ReactNode }, { disabled: boolean }, HTMLButtonElement>`

package/agents/reference/components/otp-input.md

@@ -0,0 +1,68 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# otp-input
+
+- Import: `@gunkin/uiify/components/otp-input`
+- Tier 2 (Client component — pre-hydration SSR); state source none; native element `input`
+- Without JavaScript: pre-hydration-only
+- Types file: `dist/components/otp-input.d.ts`
+
+## Exports
+
+- Runtime: `OtpInput`, `OtpInputHiddenInput`, `OtpInputRoot`, `OtpInputSlot`
+- Types: `OtpInputHiddenInputProps`, `OtpInputRootControlledOwnProps`, `OtpInputRootShellOwnProps`, `OtpInputRootShellProps`, `OtpInputRootProps`, `OtpInputSlotOwnProps`, `OtpInputSlotProps`
+
+## Values
+
+- `OtpInputType`: `"numeric" | "alphanumeric"`
+
+## Props and shapes
+
+### OtpInputContextValue
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `activeIndex` | `number` | yes |  |
+| `autoFocus` | `boolean` | yes |  |
+| `disabled` | `boolean` | yes |  |
+| `hiddenInputRef` | `React.RefObject<HTMLInputElement \| null>` | yes |  |
+| `length` | `number` | yes |  |
+| `mask` | `boolean` | yes |  |
+| `type` | `OtpInputType` | yes |  |
+| `updateValue` | `(raw: string) => void` | yes |  |
+| `value` | `string` | yes |  |
+| `onHiddenBlur` | `() => void` | yes |  |
+| `onHiddenFocus` | `() => void` | yes |  |
+
+### OtpInputRootShellOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `autoFocus` | `boolean` | no |  |
+| `defaultValue` | `string` | no |  |
+| `disabled` | `boolean` | no |  |
+| `id` | `string` | no |  |
+| `length` | `number` | no |  |
+| `mask` | `boolean` | no |  |
+| `pattern` | `string` | no |  |
+| `type` | `OtpInputType` | no |  |
+
+### OtpInputRootControlledOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `onValueChange` | `(value: string) => void` | no |  |
+| `onComplete` | `(value: string) => void` | no |  |
+| `value` | `string` | no |  |
+
+### OtpInputSlotOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `index` | `number` | yes |  |
+
+## Other types
+
+- `OtpInputRootShellProps<TAs>`: `RenderableProps<TAs, OtpInputRootShellOwnProps, OtpInputRootShellOwnProps, HTMLElement>`
+- `OtpInputRootProps<TAs>`: `RenderableProps<TAs, OtpInputRootShellOwnProps & OtpInputRootControlledOwnProps, OtpInputRootShellOwnProps & OtpInputRootControlledOwnProps, HTMLElement>`
+- `OtpInputSlotProps<TAs>`: `RenderableProps<TAs, OtpInputSlotOwnProps, { active: boolean; filled: boolean }, HTMLElement>`
+- `OtpInputHiddenInputProps<TAs>`: `RenderableProps<TAs, { readonly autoFocus?: boolean }, { disabled: boolean }, HTMLInputElement>`

package/agents/reference/components/pagination.md

@@ -0,0 +1,112 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# pagination
+
+- Import: `@gunkin/uiify/components/pagination`
+- Tier 0 (RSC — zero client JavaScript); state source none; native element `nav>ol>a`
+- Without JavaScript: full
+- Types file: `dist/components/pagination.d.ts`
+
+## Exports
+
+- Runtime: `buildPaginationItems`, `Pagination`, `PaginationEllipsis`, `PaginationItem`, `PaginationLink`, `PaginationList`, `PaginationRoot`
+- Types: `PaginationItemDescriptor`, `PaginationItemType`, `UsePaginationParams`, `PaginationEllipsisProps`, `PaginationEllipsisOwnProps`, `PaginationItemProps`, `PaginationItemOwnProps`, `PaginationLinkOwnProps`, `PaginationLinkProps`, `PaginationListOwnProps`, `PaginationListProps`, `PaginationRootOwnProps`, `PaginationRootProps`
+
+## Values
+
+- `PaginationItemType`: `"page" | "ellipsis" | "previous" | "next" | "first" | "last"`
+
+## Props and shapes
+
+### PaginationPageItem
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `disabled` | `boolean` | yes |  |
+| `page` | `number` | yes |  |
+| `selected` | `boolean` | yes |  |
+| `type` | `"page"` | yes |  |
+
+### PaginationControlItem
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `disabled` | `boolean` | yes |  |
+| `page` | `number` | no |  |
+| `selected` | `false` | yes |  |
+| `type` | `Exclude<PaginationItemType, "page">` | yes |  |
+
+### UsePaginationParams
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `boundaryCount` | `number` | no |  |
+| `count` | `number` | yes |  |
+| `defaultPage` | `number` | no |  |
+| `disabled` | `boolean` | no |  |
+| `onPageChange` | `(page: number) => void` | no |  |
+| `page` | `number` | no |  |
+| `showFirstLast` | `boolean` | no |  |
+| `siblingCount` | `number` | no |  |
+
+### UsePaginationReturn
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `items` | `readonly PaginationItem[]` | yes |  |
+| `page` | `number` | yes |  |
+| `setPage` | `(page: number) => void` | yes |  |
+
+### PaginationContextValue
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `count` | `number` | yes |  |
+| `items` | `readonly PaginationItem[]` | yes |  |
+| `page` | `number` | yes |  |
+| `setPage` | `(page: number) => void` | yes |  |
+
+### PaginationRootOwnProps
+
+Extends: `UsePaginationParams`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `"aria-label"` | `string` | no |  |
+| `children` | `ReactNode` | no |  |
+| `getPageHref` | `(page: number) => string` | no |  |
+
+### PaginationListOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+
+### PaginationItemOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+
+### PaginationLinkOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `disabled` | `boolean` | no |  |
+| `getPageHref` | `(page: number) => string` | no |  |
+| `page` | `number` | yes |  |
+| `selected` | `boolean` | no |  |
+
+### PaginationEllipsisOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+
+## Other types
+
+- `PaginationItem`: `PaginationPageItem | PaginationControlItem`
+- `PaginationRootProps<TAs>`: `RenderableProps<TAs, PaginationRootOwnProps, { page: number }, HTMLElement>`
+- `PaginationListProps<TAs>`: `RenderableProps<TAs, PaginationListOwnProps, Record<string, never>, HTMLOListElement>`
+- `PaginationItemProps<TAs>`: `RenderableProps<TAs, PaginationItemOwnProps, Record<string, never>, HTMLLIElement>`
+- `PaginationLinkProps<TAs>`: `RenderableProps<TAs, PaginationLinkOwnProps, { selected: boolean }, HTMLElement>`
+- `PaginationEllipsisProps<TAs>`: `RenderableProps<TAs, PaginationEllipsisOwnProps, Record<string, never>, HTMLElement>`

package/agents/reference/components/popup.md

@@ -0,0 +1,111 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# popup
+
+- Import: `@gunkin/uiify/components/popup`
+- Tier 0 (RSC — zero client JavaScript); state source S1; native element `[popover]+popovertarget`
+- Without JavaScript: full
+- Types file: `dist/components/popup.d.ts`
+- Note: Native parts anchor to their invoker (implicit anchor) and carry no aria-expanded; Chromium exposes expanded through the accessibility tree, other engines are unmeasured. The legacy Popup.Root compound keeps UIEnhance for its DOM attribute. Trigger/Content/Close built on @gunkin/uiify/elements/popover.
+
+## Exports
+
+- Runtime: `Popup`, `PopupClose`, `PopupContent`, `PopupTrigger`
+- Types: `AnchorAlign`, `AnchorSide`, `PopupCloseOwnProps`, `PopupCloseProps`, `PopupContentOwnProps`, `PopupContentProps`, `PopupMode`, `PopupRootCloseOwnProps`, `PopupRootCloseProps`, `PopupRootContentOwnProps`, `PopupRootContentProps`, `PopupRootOwnProps`, `PopupRootProps`, `PopupRootTriggerOwnProps`, `PopupRootTriggerProps`, `PopupSurfaceMode`, `PopupTriggerOwnProps`, `PopupTriggerProps`
+
+## Values
+
+- `PopupMode`: `"auto" | "manual" | "hint"` — Legacy compound modes; `hint` is not part of the native parts API.
+- `PopupSurfaceMode`: `"auto" | "manual"` — Native parts surface modes — the cross-engine baseline.
+- `AnchorSide`: `"top" | "right" | "bottom" | "left"`
+- `AnchorAlign`: `"start" | "center" | "end"`
+- `PopupPartName`: `"trigger" | "content" | "close"`
+
+## Props and shapes
+
+### PopupInjectedProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `__mode` | `PopupMode` | no |  |
+| `__popupId` | `string` | no |  |
+
+### PopupContextValue
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `id` | `string` | yes |  |
+| `mode` | `PopupMode` | yes |  |
+
+### PopupRootOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+| `id` | `string` | yes | Stable id for the popover surface and invoker commands. Required. |
+| `mode` | `PopupMode` | no |  |
+
+### PopupRootProps
+
+Extends: `PopupRootOwnProps`, `Omit<HTMLAttributes<HTMLDivElement>, keyof PopupRootOwnProps>`
+
+No own members.
+
+### PopupRootTriggerOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+
+### PopupRootContentOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `align` | `AnchorAlign` | no |  |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+| `side` | `AnchorSide` | no |  |
+
+### PopupRootCloseOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+
+### PopupTriggerOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `target` | `string` | yes | `id` of the `PopupContent` this button toggles. |
+
+### PopupCloseOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `target` | `string` | yes | `id` of the `PopupContent` this button hides. |
+
+### PopupContentOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `align` | `AnchorAlign` | no |  |
+| `children` | `ReactNode` | no |  |
+| `id` | `string` | yes | Unique id supplied by the consumer; referenced by trigger and close `target`. |
+| `mode` | `PopupSurfaceMode` | no |  |
+| `side` | `AnchorSide` | no |  |
+
+## Other types
+
+- `PopupRootTriggerProps`: `PopupRootTriggerOwnProps & Omit<HTMLAttributes<HTMLButtonElement>, keyof PopupRootTriggerOwnProps>`
+- `PopupTriggerInternalProps`: `PopupRootTriggerProps & PopupInjectedProps`
+- `PopupRootContentProps`: `PopupRootContentOwnProps & Omit<HTMLAttributes<HTMLDivElement>, keyof PopupRootContentOwnProps>`
+- `PopupContentInternalProps`: `PopupRootContentProps & PopupInjectedProps`
+- `PopupRootCloseProps`: `PopupRootCloseOwnProps & Omit<HTMLAttributes<HTMLButtonElement>, keyof PopupRootCloseOwnProps>`
+- `PopupCloseInternalProps`: `PopupRootCloseProps & PopupInjectedProps`
+- `PopupTriggerProps<TAs>`: `NativeButtonProps<TAs, PopupTriggerOwnProps>`
+- `PopupCloseProps<TAs>`: `NativeButtonProps<TAs, PopupCloseOwnProps>`
+- `PopupContentProps`: `PopupContentOwnProps & Omit<ComponentPropsWithRef<"div">, keyof PopupContentOwnProps | "popover">`