@gunkin/uiify 0.0.25-alpha → 0.0.27-alpha

package/README.md

@@ -32,6 +32,65 @@ export function SaveButton() {
 Use focused `@gunkin/uiify/components/*`, `@gunkin/uiify/elements/*`, `@gunkin/uiify/core/*`, or `@gunkin/uiify/hooks` imports in
 Server Components so client boundaries remain explicit.
 
+## UI documents (`@gunkin/uiify/ai`)
+
+A UI document is a JSON tree of UIify parts: `{ type, props, children }`, with no styling and no
+code. An agent writes it in your repository, or an LLM in your product stores it in a database;
+`UiDocument` renders it in Server Components, with SSR and hydration, and without JavaScript in
+the browser.
+
+Ask your agent, for example `/uiify Add a status filter above the orders table at /orders`.
+The result is an ordinary component:
+
+```tsx
+import { Suspense } from "react";
+import { UiDocument, type UiNodeInput } from "@gunkin/uiify/ai";
+
+const filter = {
+  type: "form",
+  props: { method: "get", role: "search" },
+  children: [
+    { type: "label", props: { htmlFor: "status" }, children: ["Status"] },
+    {
+      type: "Select.Root",
+      props: { id: "status", name: "status" },
+      children: [
+        { type: "Select.Item", props: { value: "open" }, children: ["Open"] },
+        { type: "Select.Item", props: { value: "closed" }, children: ["Closed"] },
+      ],
+    },
+    { type: "Button", props: { type: "submit" }, children: ["Apply"] },
+  ],
+} satisfies UiNodeInput;
+
+export function OrdersFilter() {
+  return (
+    <Suspense>
+      <UiDocument node={filter} />
+    </Suspense>
+  );
+}
+```
+
+`satisfies UiNodeInput` makes TypeScript reject an unknown part, prop or value at the line that is
+wrong. For a document from a database, validate it before saving; `UiDocument` validates again
+before rendering and never renders an invalid document:
+
+```ts
+import { validateDocument } from "@gunkin/uiify/ai";
+
+const result = validateDocument(JSON.parse(body));
+if (!result.ok) return Response.json(result.issues, { status: 422 });
+// result.issues[0] for `variant: "primary"`:
+// { breadcrumb: "form › Stack › Button.props.variant",
+//   message: "\"primary\" is not allowed; use one of \"secondary\", \"outline\", …" }
+await db.pages.save(result.document);
+```
+
+Interactivity is native: links, `GET`/`POST` forms and invoker commands (`commandfor`). Parts
+documents cannot use yet are listed in `uiUnavailableParts`; `uiDocumentSchema` is the JSON Schema
+to give your own LLM.
+
 ## AI coding agents
 
 `@gunkin/uiify` ships rules, a component index and per-component references that match the

package/agents/components.md

@@ -4,6 +4,8 @@
 Rules and anti-patterns: [index.md](./index.md). Each entry links to a generated reference with
 its exports, props and shapes; exact types are in the `.d.ts` file listed in the Types column.
 
+UI documents (`@gunkin/uiify/ai`) use many of these components as parts; the part types are in `dist/ai/catalog.generated.d.ts`.
+
 ## Tiers
 
 | Tier | Meaning | Client JavaScript | Without JavaScript |

package/agents/index.md

@@ -186,6 +186,7 @@ With that order in place, rules in the `app` layer win over the library:
 
 - `@gunkin/uiify/components/<name>`: components (names in `components.md`)
 - `@gunkin/uiify/elements/<name>`: native-element primitives for building your own anatomy
+- `@gunkin/uiify/ai`: render JSON UI documents with `UiDocument` and check them with `validateDocument`; the version-matched catalog of part types and TSDoc is `dist/ai/catalog.generated.d.ts`
 - `@gunkin/uiify/hooks`: hooks
 - `@gunkin/uiify/core/<name>`: React-agnostic stores and render helpers
 - `@gunkin/uiify/components/behavior.css`: required behavior CSS, no visual styles

package/agents/reference/components/accordion.md

@@ -49,7 +49,7 @@ No own members.
 
 ## Other types
 
-- `AccordionItemSlotProps`: `RepeatedSlotProps<Omit<ComponentPropsWithRef<"details">, | "name" | "open" | "children" | "dangerouslySetInnerHTML" | "data-part" | "data-uiify-details" | "data-uiify-accordion" | "disabled">, AccordionOwnedSlotAttributes>`
-- `AccordionTriggerSlotProps`: `RepeatedSlotProps<Omit<ComponentPropsWithRef<"summary">, | "children" | "dangerouslySetInnerHTML" | "data-part" | "data-uiify-details" | "data-uiify-accordion" | "disabled" | "part">, AccordionOwnedSlotAttributes>`
-- `AccordionPanelSlotProps`: `RepeatedSlotProps<Omit<ComponentPropsWithRef<"div">, | "children" | "dangerouslySetInnerHTML" | "data-part" | "data-uiify-details" | "data-uiify-accordion" | "part">, AccordionOwnedSlotAttributes>`
-- `AccordionProps`: `AccordionOwnProps & Omit<ComponentPropsWithRef<"div">, keyof AccordionOwnProps | "children" | "dangerouslySetInnerHTML" | "data-uiify-accordion">`
+- `AccordionItemSlotProps`: `RepeatedSlotProps<SlotProps<"details">>` — Native props for each repeated details item.
+- `AccordionTriggerSlotProps`: `RepeatedSlotProps<Omit<SlotProps<"summary">, "part">>`
+- `AccordionPanelSlotProps`: `RepeatedSlotProps<Omit<SlotProps<"div">, "part">>`
+- `AccordionProps`: `AccordionOwnProps & Omit<ComponentPropsWithRef<"div">, keyof AccordionOwnProps | "children" | "dangerouslySetInnerHTML">`

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

@@ -38,11 +38,11 @@
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
 | `trigger` | `AlertModalInvokerSlotProps` | no |  |
-| `content` | `AlertModalSlotElementProps<"dialog", \| "id" \| "role" \| "open" \| "popover" \| "aria-describedby" \| "aria-labelledby" \| "data-part" \| "data-uiify-alert-modal">` | no |  |
-| `title` | `AlertModalSlotElementProps<"h2", "id" \| "data-part" \| "data-uiify-alert-modal">` | no |  |
-| `description` | `AlertModalSlotElementProps<"p", "id" \| "data-part" \| "data-uiify-alert-modal">` | no |  |
-| `cancel` | `AlertModalChoiceSlotProps` | no |  |
-| `action` | `AlertModalChoiceSlotProps` | no |  |
+| `content` | `Omit<SlotProps<"dialog">, "id" \| "open" \| "popover">` | no |  |
+| `title` | `SlotProps<"h2">` | no |  |
+| `description` | `SlotProps<"p">` | no |  |
+| `cancel` | `AlertModalInvokerSlotProps` | no |  |
+| `action` | `AlertModalInvokerSlotProps` | no |  |
 
 ### AlertModalTriggerOwnProps
 
@@ -74,8 +74,8 @@
 
 ## Other types
 
-- `AlertModalProps`: `AlertModalOwnProps & Omit<AlertModalSlotElementProps<"div", "data-part" | "data-uiify-alert-modal">, keyof AlertModalOwnProps>`
-- `AlertModalTriggerProps<TAs>`: `Omit<NativeButtonProps<TAs, AlertModalTriggerOwnProps>, "dangerouslySetInnerHTML"> & ConsumerDataAttributes & { readonly "data-part"?: never; readonly "data-uiify-button"?: never; readonly "data-uiify-alert-modal"?: never; }`
-- `AlertModalActionProps<TAs>`: `Omit<NativeButtonProps<TAs, AlertModalActionOwnProps>, "dangerouslySetInnerHTML"> & ConsumerDataAttributes & { readonly "data-part"?: never; readonly "data-variant"?: never; readonly "data-uiify-button"?: never; readonly "data-uiify-alert-modal"?: never; }`
-- `AlertModalCancelProps<TAs>`: `Omit<NativeButtonProps<TAs, AlertModalCancelOwnProps>, "dangerouslySetInnerHTML"> & ConsumerDataAttributes & { readonly "data-part"?: never; readonly "data-variant"?: never; readonly "data-uiify-button"?: never; readonly "data-uiify-alert-modal"?: never; }`
-- `AlertModalContentProps`: `AlertModalContentOwnProps & Omit<ComponentPropsWithRef<"dialog">, keyof AlertModalContentOwnProps | "open" | "popover" | "role" | "dangerouslySetInnerHTML"> & ConsumerDataAttributes & { readonly "data-part"?: never; readonly "data-uiify-alert-modal"?: never; }` — `<dialog role="alertdialog">`; `role`, `open` and `popover` belong to the part.
+- `AlertModalProps`: `AlertModalOwnProps & Omit<SlotProps<"div">, keyof AlertModalOwnProps>`
+- `AlertModalTriggerProps<TAs>`: `NativeButtonProps<TAs, AlertModalTriggerOwnProps> & ConsumerDataAttributes`
+- `AlertModalActionProps<TAs>`: `NativeButtonProps<TAs, AlertModalActionOwnProps> & ConsumerDataAttributes`
+- `AlertModalCancelProps<TAs>`: `NativeButtonProps<TAs, AlertModalCancelOwnProps> & ConsumerDataAttributes`
+- `AlertModalContentProps`: `AlertModalContentOwnProps & Omit<ComponentPropsWithRef<"dialog">, keyof AlertModalContentOwnProps | "open" | "popover" | "dangerouslySetInnerHTML"> & ConsumerDataAttributes` — `<dialog role="alertdialog">`; `open` and `popover` use the native modal contract.

package/agents/reference/components/alert.md

@@ -53,4 +53,4 @@
 - `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>`
-- `AlertSymbolSlotProps`: `Omit<ComponentPropsWithRef<"span">, "aria-hidden" | "children" | "dangerouslySetInnerHTML" | "data-part" | "data-uiify-alert"> & { readonly "aria-hidden"?: never; readonly "data-part"?: never; readonly "data-uiify-alert"?: never; } & ConsumerDataAttributes`
+- `AlertSymbolSlotProps`: `SlotProps<"span">`

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

@@ -35,4 +35,4 @@
 ## Other types
 
 - `AspectRatioProps<TAs>`: `RenderableProps<TAs, AspectRatioOwnProps, Record<string, never>, HTMLElement>`
-- `AspectRatioContentSlotProps`: `Omit<ComponentPropsWithRef<"div">, "children" | "dangerouslySetInnerHTML" | "data-part" | "data-uiify-aspect-ratio"> & { readonly "data-part"?: never; readonly "data-uiify-aspect-ratio"?: never; } & ConsumerDataAttributes`
+- `AspectRatioContentSlotProps`: `SlotProps<"div">`

package/agents/reference/components/avatar.md

@@ -42,5 +42,5 @@
 ## Other types
 
 - `AvatarProps<TAs>`: `RenderableProps<TAs, AvatarOwnProps, Record<string, never>, HTMLElement>`
-- `AvatarImageSlotProps`: `Omit<ComponentPropsWithRef<"img">, "alt" | "children" | "dangerouslySetInnerHTML" | "data-part" | "data-uiify-avatar" | "src"> & AvatarImageOwnedAttributes & ConsumerDataAttributes`
-- `AvatarFallbackSlotProps`: `Omit<ComponentPropsWithRef<"span">, "aria-hidden" | "children" | "dangerouslySetInnerHTML" | "data-part" | "data-uiify-avatar"> & AvatarFallbackOwnedAttributes & ConsumerDataAttributes`
+- `AvatarImageSlotProps`: `SlotProps<"img">`
+- `AvatarFallbackSlotProps`: `SlotProps<"span">`

package/agents/reference/components/breadcrumb.md

@@ -30,7 +30,6 @@
 
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
-| `"aria-label"` | `string` | no |  |
 | `labels` | `Partial<BreadcrumbLabels>` | no |  |
 
 ### BreadcrumbItemData
@@ -41,7 +40,7 @@ One logical breadcrumb entry. Used by `BreadcrumbList`'s `items` prop — the da
 | --- | --- | --- | --- |
 | `key` | `string` | yes |  |
 | `current` | `boolean` | no |  |
-| `href` | `string` | no |  |
+| `href` | `string \| undefined` | no |  |
 | `label` | `ReactNode` | yes |  |
 
 ### BreadcrumbListOwnProps
@@ -61,12 +60,12 @@ One logical breadcrumb entry. Used by `BreadcrumbList`'s `items` prop — the da
 
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
-| `item` | `BreadcrumbRepeatedSlotProps<"li">` | no | Generated item wrappers and links use `byItemValue[item.key]`. |
-| `link` | `BreadcrumbLinkSlotProps` | no |  |
-| `ellipsisItem` | `BreadcrumbDirectSlotProps<"li">` | no |  |
-| `ellipsis` | `BreadcrumbDirectSlotProps<"details", { readonly "data-uiify-breadcrumb"?: never; readonly "data-uiify-details"?: never }>` | no |  |
-| `ellipsisTrigger` | `BreadcrumbDirectSlotProps<"summary", { readonly "aria-label"?: never }>` | no |  |
-| `ellipsisContent` | `BreadcrumbDirectSlotProps<"ol", { readonly "data-uiify-details"?: never }>` | no |  |
+| `item` | `RepeatedSlotProps<SlotProps<"li">>` | no |  |
+| `link` | `RepeatedSlotProps<SlotProps<"a">>` | no |  |
+| `ellipsisItem` | `SlotProps<"li">` | no |  |
+| `ellipsis` | `SlotProps<"details">` | no |  |
+| `ellipsisTrigger` | `SlotProps<"summary">` | no |  |
+| `ellipsisContent` | `SlotProps<"ol">` | no |  |
 
 ### BreadcrumbLinkOwnProps
 
@@ -74,7 +73,7 @@ One logical breadcrumb entry. Used by `BreadcrumbList`'s `items` prop — the da
 | --- | --- | --- | --- |
 | `children` | `ReactNode` | no |  |
 | `current` | `boolean` | no |  |
-| `href` | `string` | no |  |
+| `href` | `string \| undefined` | no |  |
 
 ### BreadcrumbSeparatorOwnProps
 
@@ -95,7 +94,7 @@ One logical breadcrumb entry. Used by `BreadcrumbList`'s `items` prop — the da
 
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
-| `slotProps` | `{ readonly item?: BreadcrumbDirectSlotProps<"li">; readonly ellipsis?: BreadcrumbDirectSlotProps<"span">; }` | no |  |
+| `slotProps` | `{ readonly item?: SlotProps<"li">; readonly ellipsis?: SlotProps<"span">; }` | no |  |
 
 ## Other types
 

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

@@ -22,43 +22,43 @@
 
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
-| `caption` | `CandleChartPartSlotProps<"figcaption">` | no |  |
-| `readout` | `CandleChartPartSlotProps<"div", { readonly "aria-live"?: never; readonly "data-part"?: never }>` | no |  |
-| `readoutTime` | `CandleChartPartSlotProps<"span">` | no |  |
-| `readoutOpen` | `CandleChartPartSlotProps<"span">` | no |  |
-| `readoutHigh` | `CandleChartPartSlotProps<"span">` | no |  |
-| `readoutLow` | `CandleChartPartSlotProps<"span">` | no |  |
-| `readoutClose` | `CandleChartPartSlotProps<"span">` | no |  |
-| `plot` | `CandleChartPartSlotProps<"div", { readonly "aria-hidden"?: never; readonly "data-part"?: never }>` | no |  |
-| `scrollViewport` | `CandleChartPartSlotProps<"div">` | no |  |
-| `canvas` | `CandleChartPartSlotProps<"div">` | no |  |
-| `viewport` | `CandleChartPartSlotProps<"div">` | no |  |
-| `candles` | `CandleChartPartSlotProps<"ol", { readonly "aria-label"?: never; readonly "data-part"?: never }>` | no |  |
-| `candle` | `CandleChartIndexedSlotProps<CandleChartCandleElementProps, CandleChartCandleOwnedProps>` | no |  |
-| `candleHit` | `CandleChartRepeatedSlotProps<"button", { readonly "aria-label"?: never; readonly "aria-pressed"?: never; readonly "data-part"?: never; readonly type?: never; }>` | no |  |
-| `crosshair` | `CandleChartPartSlotProps<"div", { readonly "aria-hidden"?: never; readonly "data-part"?: never }>` | no |  |
-| `crosshairMarker` | `CandleChartPartSlotProps<"span">` | no |  |
-| `timeViewport` | `CandleChartPartSlotProps<"div">` | no |  |
-| `timeAxis` | `CandleChartPartSlotProps<"ol", { readonly "aria-label"?: never; readonly "data-axis"?: never; readonly "data-part"?: never }>` | no |  |
+| `caption` | `SlotProps<"figcaption">` | no |  |
+| `readout` | `SlotProps<"div">` | no |  |
+| `readoutTime` | `SlotProps<"span">` | no |  |
+| `readoutOpen` | `SlotProps<"span">` | no |  |
+| `readoutHigh` | `SlotProps<"span">` | no |  |
+| `readoutLow` | `SlotProps<"span">` | no |  |
+| `readoutClose` | `SlotProps<"span">` | no |  |
+| `plot` | `SlotProps<"div">` | no |  |
+| `scrollViewport` | `SlotProps<"div">` | no |  |
+| `canvas` | `SlotProps<"div">` | no |  |
+| `viewport` | `SlotProps<"div">` | no |  |
+| `candles` | `SlotProps<"ol">` | no |  |
+| `candle` | `CandleChartIndexedSlotProps<CandleChartCandleElementProps>` | no |  |
+| `candleHit` | `CandleChartRepeatedSlotProps<"button">` | no |  |
+| `crosshair` | `SlotProps<"div">` | no |  |
+| `crosshairMarker` | `SlotProps<"span">` | no |  |
+| `timeViewport` | `SlotProps<"div">` | no |  |
+| `timeAxis` | `SlotProps<"ol">` | no |  |
 | `timeAxisLabel` | `CandleChartRepeatedSlotProps<"li">` | no |  |
-| `crosshairTime` | `CandleChartPartSlotProps<"li">` | no |  |
-| `priceAxis` | `CandleChartPartSlotProps<"ol", { readonly "aria-label"?: never; readonly "data-axis"?: never; readonly "data-part"?: never }>` | no |  |
+| `crosshairTime` | `SlotProps<"li">` | no |  |
+| `priceAxis` | `SlotProps<"ol">` | no |  |
 | `priceAxisLabel` | `CandleChartRepeatedSlotProps<"li">` | no |  |
-| `crosshairPrice` | `CandleChartPartSlotProps<"li">` | no |  |
-| `liveScrollport` | `CandleChartPartSlotProps<"div", { readonly "data-dynamic-layout"?: never; readonly "data-orientation"?: never; readonly "data-part"?: never; readonly "data-uiify-virtual-scroll"?: never; readonly role?: never; }>` | no |  |
-| `liveSpacer` | `CandleChartPartSlotProps<"div">` | no |  |
-| `liveCandleRow` | `CandleChartLiveRowSlotProps` | no |  |
-| `dataTable` | `CandleChartPartSlotProps<"table", { readonly "aria-label"?: never; readonly "data-part"?: never }>` | no |  |
-| `dataTableHead` | `CandleChartPartSlotProps<"thead">` | no |  |
-| `dataTableHeaderRow` | `CandleChartPartSlotProps<"tr">` | no |  |
-| `dataTableTimeHeader` | `CandleChartPartSlotProps<"th", { readonly scope?: never; readonly "data-part"?: never }>` | no |  |
-| `dataTableOpenHeader` | `CandleChartPartSlotProps<"th", { readonly scope?: never; readonly "data-part"?: never }>` | no |  |
-| `dataTableHighHeader` | `CandleChartPartSlotProps<"th", { readonly scope?: never; readonly "data-part"?: never }>` | no |  |
-| `dataTableLowHeader` | `CandleChartPartSlotProps<"th", { readonly scope?: never; readonly "data-part"?: never }>` | no |  |
-| `dataTableCloseHeader` | `CandleChartPartSlotProps<"th", { readonly scope?: never; readonly "data-part"?: never }>` | no |  |
-| `dataTableBody` | `CandleChartPartSlotProps<"tbody">` | no |  |
+| `crosshairPrice` | `SlotProps<"li">` | no |  |
+| `liveScrollport` | `SlotProps<"div">` | no |  |
+| `liveSpacer` | `SlotProps<"div">` | no |  |
+| `liveCandleRow` | `CandleChartRepeatedSlotProps<"div">` | no |  |
+| `dataTable` | `SlotProps<"table">` | no |  |
+| `dataTableHead` | `SlotProps<"thead">` | no |  |
+| `dataTableHeaderRow` | `SlotProps<"tr">` | no |  |
+| `dataTableTimeHeader` | `SlotProps<"th">` | no |  |
+| `dataTableOpenHeader` | `SlotProps<"th">` | no |  |
+| `dataTableHighHeader` | `SlotProps<"th">` | no |  |
+| `dataTableLowHeader` | `SlotProps<"th">` | no |  |
+| `dataTableCloseHeader` | `SlotProps<"th">` | no |  |
+| `dataTableBody` | `SlotProps<"tbody">` | no |  |
 | `dataTableRow` | `CandleChartRepeatedSlotProps<"tr">` | no |  |
-| `dataTableTimeCell` | `CandleChartRepeatedSlotProps<"th", { readonly scope?: never }>` | no |  |
+| `dataTableTimeCell` | `CandleChartRepeatedSlotProps<"th">` | no |  |
 | `dataTableOpenCell` | `CandleChartRepeatedSlotProps<"td">` | no |  |
 | `dataTableHighCell` | `CandleChartRepeatedSlotProps<"td">` | no |  |
 | `dataTableLowCell` | `CandleChartRepeatedSlotProps<"td">` | no |  |
@@ -92,7 +92,7 @@
 
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
-| `"aria-label"` | `string` | no |  |
+| `"aria-label"` | `string \| undefined` | no |  |
 | `labels` | `Partial<CandleChartLabels>` | no |  |
 | `activeCandleIndex` | `number` | no |  |
 | `cursorY` | `number` | no |  |

package/agents/reference/components/carousel.md

@@ -67,26 +67,22 @@ Extends: `CSSProperties`
 
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
-| `viewport` | `Omit<ComponentPropsWithRef<"div">, "aria-label" \| "children" \| "dangerouslySetInnerHTML" \| "data-part" \| "id" \| "role" \| "tabIndex"> & ConsumerDataAttributes & { readonly "aria-label"?: never; readonly "data-part"?: never; readonly id?: never; readonly role?: never; readonly tabIndex?: never; }` | no |  |
-| `slide` | `CarouselRepeatedSlotProps<"div", { readonly "aria-hidden"?: never; readonly "aria-label"?: never; readonly "aria-roledescription"?: never; readonly "data-carousel-index"?: never; readonly "data-part"?: never; readonly "data-state"?: never; readonly id?: never; readonly inert?: never; readonly role?: never; }>` | no |  |
-| `slideContent` | `CarouselRepeatedSlotProps<"div", { readonly "data-part"?: never }>` | no |  |
-| `rotationControl` | `CarouselRepeatedSlotProps<"button", { readonly "aria-label"?: never; readonly "data-carousel-action"?: never; readonly "data-part"?: never; readonly "data-size"?: never; readonly "data-uiify-button"?: never; readonly "data-variant"?: never; readonly disabled?: never; readonly hidden?: never; readonly type?: never; }>` | no |  |
-| `previousControl` | `CarouselRepeatedSlotProps<"button", { readonly "aria-label"?: never; readonly "data-carousel-action"?: never; readonly "data-part"?: never; readonly "data-size"?: never; readonly "data-uiify-button"?: never; readonly "data-variant"?: never; readonly disabled?: never; readonly hidden?: never; readonly type?: never; }>` | no |  |
-| `nextControl` | `CarouselRepeatedSlotProps<"button", { readonly "aria-label"?: never; readonly "data-carousel-action"?: never; readonly "data-part"?: never; readonly "data-size"?: never; readonly "data-uiify-button"?: never; readonly "data-variant"?: never; readonly disabled?: never; readonly hidden?: never; readonly type?: never; }>` | no |  |
-| `dots` | `Omit<ComponentPropsWithRef<"nav">, "aria-label" \| "children" \| "dangerouslySetInnerHTML" \| "data-part"> & ConsumerDataAttributes & { readonly "aria-label"?: never; readonly "data-part"?: never; }` | no |  |
-| `dot` | `CarouselRepeatedSlotProps<"a", { readonly "aria-current"?: never; readonly "aria-label"?: never; readonly "data-carousel-index"?: never; readonly "data-part"?: never; readonly href?: never; }>` | no |  |
-| `status` | `Omit<ComponentPropsWithRef<"div">, "aria-atomic" \| "aria-live" \| "children" \| "dangerouslySetInnerHTML" \| "data-part"> & ConsumerDataAttributes & { readonly "aria-atomic"?: never; readonly "aria-live"?: never; readonly "data-part"?: never; }` | no |  |
+| `viewport` | `SlotProps<"div">` | no |  |
+| `slide` | `RepeatedSlotProps<SlotProps<"div">>` | no |  |
+| `slideContent` | `RepeatedSlotProps<SlotProps<"div">>` | no |  |
+| `rotationControl` | `RepeatedSlotProps<SlotProps<"button">>` | no |  |
+| `previousControl` | `RepeatedSlotProps<SlotProps<"button">>` | no |  |
+| `nextControl` | `RepeatedSlotProps<SlotProps<"button">>` | no |  |
+| `dots` | `SlotProps<"nav">` | no |  |
+| `dot` | `RepeatedSlotProps<SlotProps<"a">>` | no |  |
+| `status` | `SlotProps<"div">` | no |  |
 
 ### CarouselProps
 
-Extends: `Omit<ComponentPropsWithoutRef<"section">, | "aria-label" | "children" | "className" | "data-axis" | "data-enhanced" | "data-mode" | "data-uiify-carousel" | "dangerouslySetInnerHTML" | "defaultValue" | "dir" | "id" | "autoplay" | "afterChange" | "beforeChange" | "mouseDrag" | "onSelect" | "onSwipe" | "rewind" | "swipe" | "style" | "value">`, `ConsumerDataAttributes`
+Extends: `Omit<ComponentPropsWithoutRef<"section">, | "aria-label" | "children" | "className" | "dangerouslySetInnerHTML" | "defaultValue" | "dir" | "id" | "autoplay" | "afterChange" | "beforeChange" | "mouseDrag" | "onSelect" | "onSwipe" | "rewind" | "swipe" | "style" | "value">`, `ConsumerDataAttributes`
 
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
-| `"data-axis"` | `never` | no |  |
-| `"data-enhanced"` | `never` | no |  |
-| `"data-mode"` | `never` | no |  |
-| `"data-uiify-carousel"` | `never` | no |  |
 | `id` | `string` | yes |  |
 | `items` | `readonly CarouselItem[]` | yes |  |
 | `"aria-label"` | `string` | yes |  |

package/agents/reference/components/collapsible.md

@@ -39,6 +39,6 @@
 
 ## Other types
 
-- `CollapsibleTriggerSlotProps`: `Omit<ComponentPropsWithRef<"summary">, | "aria-disabled" | "children" | "dangerouslySetInnerHTML" | "data-part" | "data-uiify-details" | "disabled" | "part" | "tabIndex"> & CollapsibleTriggerOwnedAttributes & ConsumerDataAttributes`
-- `CollapsiblePanelSlotProps`: `Omit<ComponentPropsWithRef<"div">, "children" | "dangerouslySetInnerHTML" | "data-part" | "data-uiify-details" | "part"> & CollapsiblePanelOwnedAttributes & ConsumerDataAttributes`
-- `CollapsibleProps`: `CollapsibleOwnProps & Omit<ComponentPropsWithRef<"details">, | keyof CollapsibleOwnProps | "children" | "dangerouslySetInnerHTML" | "data-disabled" | "data-uiify-collapsible" | "data-uiify-details" | "open" | "name">`
+- `CollapsibleTriggerSlotProps`: `Omit<SlotProps<"summary">, "part">`
+- `CollapsiblePanelSlotProps`: `Omit<SlotProps<"div">, "part">`
+- `CollapsibleProps`: `CollapsibleOwnProps & Omit<ComponentPropsWithRef<"details">, keyof CollapsibleOwnProps | "children" | "dangerouslySetInnerHTML">`

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

@@ -45,9 +45,9 @@
 
 ## Other types
 
-- `ColorPickerFieldSlotProps`: `Omit<ComponentPropsWithRef<"div">, | "children" | "dangerouslySetInnerHTML" | "data-disabled" | "data-invalid" | "data-part" | "data-required" | "data-uiify-color-picker" | "data-uiify-field" | "id"> & ConsumerDataAttributes & ColorPickerFieldOwnedAttributes`
-- `ColorPickerLabelSlotProps`: `Omit<ComponentPropsWithRef<"label">, | "children" | "dangerouslySetInnerHTML" | "id" | "htmlFor" | "data-disabled" | "data-part" | "data-required" | "data-uiify-color-picker"> & ConsumerDataAttributes & ColorPickerLabelOwnedAttributes`
-- `ColorPickerSurfaceSlotProps`: `Omit<ComponentPropsWithRef<"div">, "children" | "dangerouslySetInnerHTML" | "data-part" | "data-uiify-color-picker" | "data-value"> & ConsumerDataAttributes & ColorPickerSurfaceOwnedAttributes`
-- `ColorPickerControlSlotProps`: `Omit<ComponentPropsWithRef<"input">, | "children" | "dangerouslySetInnerHTML" | "aria-describedby" | "aria-hidden" | "aria-invalid" | "aria-labelledby" | "aria-required" | "disabled" | "defaultValue" | "id" | "name" | "readOnly" | "required" | "tabIndex" | "type" | "value" | "data-disabled" | "data-invalid" | "data-part" | "data-required" | "data-uiify-color-picker" | "data-uiify-input"> & ConsumerDataAttributes & ColorPickerControlOwnedAttributes`
-- `ColorPickerInputSlotProps`: `Omit<ComponentPropsWithRef<"input">, | "children" | "dangerouslySetInnerHTML" | "aria-invalid" | "aria-label" | "aria-labelledby" | "disabled" | "id" | "type" | "value" | "alpha" | "colorspace" | "defaultValue" | "data-part" | "data-uiify-color-picker" | "required"> & ConsumerDataAttributes & ColorPickerPartOwnedAttributes`
-- `ColorPickerProps`: `Omit<ComponentPropsWithRef<"input">, | "alpha" | "className" | "colorSpace" | "defaultValue" | "onChange" | "ref" | "style" | "type" | "value"> & ColorPickerOwnProps & { readonly className?: string; readonly onChange?: ChangeEventHandler<HTMLInputElement>; readonly ref?: Ref<HTMLInputElement>; readonly style?: CSSProperties; } & { readonly "data-uiify-color-picker"?: never; readonly "data-uiify-field"?: never; }`
+- `ColorPickerFieldSlotProps`: `Omit<SlotProps<"div">, "id">` — The field id is the required Field.Root wiring input; use ColorPicker.id.
+- `ColorPickerLabelSlotProps`: `SlotProps<"label">`
+- `ColorPickerSurfaceSlotProps`: `SlotProps<"div">`
+- `ColorPickerControlSlotProps`: `SlotProps<"input">`
+- `ColorPickerInputSlotProps`: `SlotProps<"input"> & { readonly alpha?: string | undefined; readonly colorspace?: ColorSpace | undefined; }`
+- `ColorPickerProps`: `Omit<ComponentPropsWithRef<"input">, "alpha" | "className" | "colorSpace" | "defaultValue" | "onChange" | "ref" | "style" | "value"> & ColorPickerOwnProps & { readonly className?: string; readonly onChange?: ChangeEventHandler<HTMLInputElement>; readonly ref?: Ref<HTMLInputElement>; readonly style?: CSSProperties; } & ConsumerDataAttributes`

package/agents/reference/components/combobox.md

@@ -94,6 +94,7 @@ Extends: `Omit<ComponentPropsWithRef<"div">, "children">`
 | `defaultValue` | `string` | no |  |
 | `filterFn` | `ComboboxFilterFn` | no |  |
 | `items` | `readonly ComboboxItemData[]` | yes |  |
+| `size` | `ControlSize` | no | Sets the control's height and text size; `md` is the default. |
 
 ### ComboboxRootControlledOwnProps
 
@@ -157,8 +158,8 @@ Extends: `Omit<ComboboxRootShellOwnProps, "defaultValue">`, `Omit<ComboboxRootCo
 
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
-| `tag` | `ComboboxRepeatedSlotProps<"span">` | no |  |
-| `remove` | `ComboboxRepeatedSlotProps<"button", { readonly "aria-label"?: never; readonly type?: never }>` | no |  |
+| `tag` | `RepeatedSlotProps<SlotProps<"span">>` | no |  |
+| `remove` | `RepeatedSlotProps<SlotProps<"button">>` | no |  |
 
 ### ComboboxInputOwnProps
 
@@ -175,28 +176,17 @@ Extends: `Omit<ComboboxRootShellOwnProps, "defaultValue">`, `Omit<ComboboxRootCo
 
 ### ComboboxItemOwnProps
 
-Extends: `Omit<ComponentPropsWithRef<"div">, | "aria-disabled" | "aria-selected" | "children" | "data-disabled" | "data-highlighted" | "data-part" | "data-selected" | "dangerouslySetInnerHTML" | "id" | "role">`, `ConsumerDataAttributes`
+Extends: `SlotProps<"div">`
 
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
-| `"aria-disabled"` | `never` | no |  |
-| `"aria-selected"` | `never` | no |  |
-| `className` | `string` | no |  |
-| `"data-disabled"` | `never` | no |  |
-| `"data-highlighted"` | `never` | no |  |
-| `"data-part"` | `never` | no |  |
-| `"data-selected"` | `never` | no |  |
 | `item` | `ComboboxItemData` | yes |  |
 
 ### ComboboxEmptyOwnProps
 
-Extends: `Omit<ComponentPropsWithRef<"div">, "children" | "data-part" | "dangerouslySetInnerHTML" | "role">`, `ConsumerDataAttributes`
+Extends: `Omit<ComponentPropsWithRef<"div">, "dangerouslySetInnerHTML">`, `ConsumerDataAttributes`
 
-| Member | Type | Required | Description |
-| --- | --- | --- | --- |
-| `children` | `ReactNode` | no |  |
-| `className` | `string` | no |  |
-| `"data-part"` | `never` | no |  |
+No own members.
 
 ## Other types
 
@@ -206,4 +196,4 @@ Extends: `Omit<ComponentPropsWithRef<"div">, "children" | "data-part" | "dangero
 - `ComboboxTagsProps<TAs>`: `RenderableProps<TAs, ComboboxTagsOwnProps, Record<string, never>, HTMLElement>`
 - `ComboboxInputProps<TAs>`: `RenderableProps<TAs, ComboboxInputOwnProps, { open: boolean }, HTMLInputElement>`
 - `ComboboxTriggerProps<TAs>`: `RenderableProps<TAs, ComboboxTriggerOwnProps, { open: boolean }, HTMLElement>`
-- `ComboboxContentOwnProps`: `Omit<ComponentPropsWithRef<"div">, | "aria-multiselectable" | "children" | "className" | "data-align" | "data-part" | "data-side" | "data-state" | "dangerouslySetInnerHTML" | "id" | "role"> & ConsumerDataAttributes & { readonly "aria-multiselectable"?: never; readonly "data-align"?: never; readonly "data-part"?: never; readonly "data-side"?: never; readonly "data-state"?: never; readonly align?: AnchorAlign; readonly children: (filteredItems: ComboboxItemData[]) => ReactNode; readonly className?: string; readonly side?: AnchorSide; }`
+- `ComboboxContentOwnProps`: `SlotProps<"div"> & { readonly align?: AnchorAlign; readonly children: (filteredItems: ComboboxItemData[]) => ReactNode; readonly side?: AnchorSide; }`

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

@@ -39,7 +39,7 @@ Extends: `UseMenuSurfaceReturn`
 
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
-| `virtualAnchor` | `Omit<ComponentPropsWithRef<"span">, \| "aria-hidden" \| "children" \| "dangerouslySetInnerHTML" \| "data-anchor" \| "data-virtual-anchor" \| "data-uiify-menu"> & ConsumerDataAttributes & { readonly "data-anchor"?: never; readonly "data-uiify-menu"?: never; readonly "data-virtual-anchor"?: never; }` | no |  |
+| `virtualAnchor` | `SlotProps<"span">` | no |  |
 
 ### ContextMenuRootControlledOwnProps
 
@@ -90,7 +90,7 @@ Extends: `ContextMenuRootShellOwnProps`, `ContextMenuRootControlledOwnProps`
 
 ### ContextMenuCheckboxItemOwnProps
 
-Extends: `Omit<ComponentPropsWithRef<"div">, | "aria-checked" | "children" | "data-disabled" | "data-part" | "data-state" | "data-uiify-menu" | "dangerouslySetInnerHTML" | "role">`, `ConsumerDataAttributes`
+Extends: `Omit<ComponentPropsWithRef<"div">, "children" | "dangerouslySetInnerHTML">`, `ConsumerDataAttributes`
 
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
@@ -99,16 +99,10 @@ Extends: `Omit<ComponentPropsWithRef<"div">, | "aria-checked" | "children" | "da
 | `disabled` | `boolean` | no |  |
 | `onCheckedChange` | `(checked: boolean) => void` | no |  |
 | `textValue` | `string` | no |  |
-| `"aria-checked"` | `never` | no |  |
-| `"data-disabled"` | `never` | no |  |
-| `"data-part"` | `never` | no |  |
-| `"data-state"` | `never` | no |  |
-| `"data-uiify-menu"` | `never` | no |  |
-| `role` | `never` | no |  |
 
 ### ContextMenuRadioItemOwnProps
 
-Extends: `Omit<ComponentPropsWithRef<"div">, | "aria-checked" | "children" | "data-disabled" | "data-part" | "data-state" | "data-uiify-menu" | "dangerouslySetInnerHTML" | "role">`, `ConsumerDataAttributes`
+Extends: `Omit<ComponentPropsWithRef<"div">, "children" | "dangerouslySetInnerHTML">`, `ConsumerDataAttributes`
 
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
@@ -116,12 +110,6 @@ Extends: `Omit<ComponentPropsWithRef<"div">, | "aria-checked" | "children" | "da
 | `disabled` | `boolean` | no |  |
 | `textValue` | `string` | no |  |
 | `value` | `string` | yes |  |
-| `"aria-checked"` | `never` | no |  |
-| `"data-disabled"` | `never` | no |  |
-| `"data-part"` | `never` | no |  |
-| `"data-state"` | `never` | no |  |
-| `"data-uiify-menu"` | `never` | no |  |
-| `role` | `never` | no |  |
 
 ### ContextMenuSubOwnProps
 
@@ -131,30 +119,21 @@ Extends: `Omit<ComponentPropsWithRef<"div">, | "aria-checked" | "children" | "da
 
 ### ContextMenuSubTriggerOwnProps
 
-Extends: `Omit<ComponentPropsWithRef<"div">, | "aria-expanded" | "aria-haspopup" | "children" | "data-part" | "data-uiify-menu" | "dangerouslySetInnerHTML" | "role">`, `ConsumerDataAttributes`
+Extends: `Omit<ComponentPropsWithRef<"div">, "children" | "dangerouslySetInnerHTML">`, `ConsumerDataAttributes`
 
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
 | `children` | `ReactNode` | no |  |
 | `disabled` | `boolean` | no |  |
 | `textValue` | `string` | no |  |
-| `"aria-expanded"` | `never` | no |  |
-| `"aria-haspopup"` | `never` | no |  |
-| `"data-part"` | `never` | no |  |
-| `"data-uiify-menu"` | `never` | no |  |
-| `role` | `never` | no |  |
 
 ### ContextMenuSubContentOwnProps
 
-Extends: `Omit<ComponentPropsWithRef<"div">, | "children" | "data-part" | "data-state" | "data-uiify-menu" | "dangerouslySetInnerHTML" | "hidden" | "role">`, `ConsumerDataAttributes`
+Extends: `Omit<ComponentPropsWithRef<"div">, "children" | "dangerouslySetInnerHTML">`, `ConsumerDataAttributes`
 
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
 | `children` | `ReactNode` | no |  |
-| `"data-part"` | `never` | no |  |
-| `"data-state"` | `never` | no |  |
-| `"data-uiify-menu"` | `never` | no |  |
-| `role` | `never` | no |  |
 
 ## Other types
 

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

@@ -20,8 +20,9 @@
 
 ### DatePickerProps
 
-Extends: `Omit<ComponentPropsWithRef<"input">, "type">`
+Extends: `Omit<ComponentPropsWithRef<"input">, "type" | "size">`
 
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
 | `invalid` | `boolean` | no |  |
+| `size` | `ControlSize` | no | Sets the control's height and text size; `md` is the default. |