@gunkin/uiify 0.0.25-alpha → 0.0.27-alpha

package/agents/reference/components/toggle.md

@@ -33,11 +33,12 @@
 | `label` | `ReactNode` | yes |  |
 | `pressed` | `boolean` | no |  |
 | `defaultPressed` | `boolean` | no |  |
+| `onPressedChange` | `(pressed: boolean) => void` | no |  |
 | `disabled` | `boolean` | no |  |
 | `slotProps` | `ToggleSlotProps` | no |  |
 
 ## Other types
 
-- `ToggleControlSlotProps`: `Omit<ComponentPropsWithRef<"input">, | "aria-labelledby" | "checked" | "data-disabled" | "data-part" | "data-state" | "data-uiify-toggle" | "defaultChecked" | "disabled" | "id" | "type"> & ToggleControlOwnedAttributes & ConsumerDataAttributes`
-- `ToggleLabelSlotProps`: `Omit<ComponentPropsWithRef<"label">, "children" | "data-part" | "data-uiify-button" | "data-variant" | "htmlFor" | "id"> & ToggleLabelOwnedAttributes & ConsumerDataAttributes`
-- `ToggleProps`: `ToggleOwnProps & Omit<ComponentPropsWithRef<"div">, | keyof ToggleOwnProps | "children" | "dangerouslySetInnerHTML" | "data-disabled" | "data-uiify-toggle" | "id">`
+- `ToggleControlSlotProps`: `SlotProps<"input">`
+- `ToggleLabelSlotProps`: `SlotProps<"label">`
+- `ToggleProps`: `ToggleOwnProps & Omit<ComponentPropsWithRef<"div">, keyof ToggleOwnProps | "children" | "dangerouslySetInnerHTML" | "id">`

package/agents/reference/components/virtual-scroll.md

@@ -78,7 +78,7 @@ Extends: `VirtualScrollScrollBehaviorOptions`
 
 ### VirtualScrollOwnProps
 
-Extends: `Omit<ComponentPropsWithoutRef<"div">, "children" | "role">`
+Extends: `Omit<ComponentPropsWithoutRef<"div">, "children">`, `ConsumerDataAttributes`
 
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
@@ -94,7 +94,6 @@ Extends: `Omit<ComponentPropsWithoutRef<"div">, "children" | "role">`
 | `scrollRef` | `Ref<VirtualScrollHandle>` | no |  |
 | `estimateRowHeight` | `(index: number) => number` | no |  |
 | `onRangeChange` | `(range: VirtualScrollRangeChange) => void` | no |  |
-| `role` | `VirtualScrollListRole` | no |  |
 | `anchor` | `VirtualScrollAnchor` | no |  |
 | `followAppend` | `boolean \| "smooth"` | no |  |
 | `onScrollStateChange` | `(state: VirtualScrollScrollState) => void` | no |  |
@@ -103,7 +102,7 @@ Extends: `Omit<ComponentPropsWithoutRef<"div">, "children" | "role">`
 
 ### VirtualScrollRowShellProps
 
-Extends: `Omit<ComponentPropsWithRef<"div">, | "aria-posinset" | "aria-setsize" | "children" | "data-dynamic-row" | "data-part" | "data-row-index" | "dangerouslySetInnerHTML" | "role">`
+Extends: `SlotProps<"div">`
 
 | Member | Type | Required | Description |
 | --- | --- | --- | --- |
@@ -126,5 +125,5 @@ Extends: `Omit<ComponentPropsWithRef<"div">, | "aria-posinset" | "aria-setsize"
 
 ## Other types
 
-- `VirtualScrollRowSlotProps`: `RepeatedSlotProps<VirtualScrollRowNativeProps, VirtualScrollRowOwnedProps> & { readonly byItemIndex?: Readonly<Record<number, VirtualScrollRowNativeProps & ConsumerDataAttributes & VirtualScrollRowOwnedProps>>; }`
-- `VirtualScrollSpacerSlotProps`: `Omit<ComponentPropsWithRef<"div">, "children" | "dangerouslySetInnerHTML" | "data-part"> & { readonly "data-part"?: never; } & ConsumerDataAttributes`
+- `VirtualScrollRowSlotProps`: `RepeatedSlotProps<SlotProps<"div">> & { readonly byItemIndex?: Readonly<Record<number, SlotProps<"div">>>; }`
+- `VirtualScrollSpacerSlotProps`: `SlotProps<"div">`

package/agents/reference/elements/choice.md

@@ -62,7 +62,7 @@ No own members.
 ## Other types
 
 - `ChoiceGroupProps`: `ChoiceGroupOwnProps & Omit<ComponentPropsWithRef<"div">, keyof ChoiceGroupOwnProps | "dangerouslySetInnerHTML">`
-- `ChoiceInputSlotProps`: `Omit<ComponentPropsWithRef<"input">, | "children" | "dangerouslySetInnerHTML" | "aria-labelledby" | "checked" | "defaultChecked" | "disabled" | "id" | "name" | "type" | "value" | "data-part" | "data-uiify-choice" | "data-uiify-radio"> & ConsumerDataAttributes & { readonly "data-part"?: never; readonly "data-uiify-choice"?: never; readonly "data-uiify-radio"?: never; }`
-- `ChoiceLabelSlotProps`: `Omit<ComponentPropsWithRef<"label">, "children" | "dangerouslySetInnerHTML" | "htmlFor" | "id" | "data-part"> & ConsumerDataAttributes & { readonly "data-part"?: never }`
-- `ChoicePanelSlotProps`: `Omit<ComponentPropsWithRef<"div">, "children" | "dangerouslySetInnerHTML" | "id" | "data-part"> & ConsumerDataAttributes & { readonly "data-part"?: never }`
+- `ChoiceInputSlotProps`: `Omit<ComponentPropsWithRef<"input">, "children" | "dangerouslySetInnerHTML"> & ConsumerDataAttributes` — Native props of the generated input; consumer values replace the defaults.
+- `ChoiceLabelSlotProps`: `Omit<ComponentPropsWithRef<"label">, "children" | "dangerouslySetInnerHTML"> & ConsumerDataAttributes`
+- `ChoicePanelSlotProps`: `Omit<ComponentPropsWithRef<"div">, "children" | "dangerouslySetInnerHTML"> & ConsumerDataAttributes`
 - `ChoiceItemProps`: `ChoiceItemOwnProps & Omit<ComponentPropsWithRef<"div">, keyof ChoiceItemOwnProps | "children" | "dangerouslySetInnerHTML">`

package/agents/reference/elements/details.md

@@ -20,7 +20,7 @@
 | --- | --- | --- | --- |
 | `children` | `ReactNode` | no |  |
 | `defaultOpen` | `boolean` | no | Applies the native `open` attribute on first render. |
-| `name` | `string` | no | Groups sibling `<details name>` into an exclusive, single-open set — the browser enforces it, no JS. Must be unique per group and stable across SSR. |
+| `name` | `string \| undefined` | no | Groups sibling `<details name>` into an exclusive, single-open set — the browser enforces it, no JS. Must be unique per group and stable across SSR. |
 | `disabled` | `boolean` | no |  |
 
 ### DetailsSummaryOwnProps
@@ -40,6 +40,6 @@
 
 ## Other types
 
-- `DetailsRootProps`: `DetailsRootOwnProps & Omit<ComponentPropsWithRef<"details">, keyof DetailsRootOwnProps | "open">` — `open` is not part of the contract — use `defaultOpen`; the browser owns state after that.
+- `DetailsRootProps`: `DetailsRootOwnProps & Omit<ComponentPropsWithRef<"details">, keyof DetailsRootOwnProps>` — Native props may override the initial open state.
 - `DetailsSummaryProps`: `DetailsSummaryOwnProps & Omit<ComponentPropsWithRef<"summary">, keyof DetailsSummaryOwnProps>`
 - `DetailsContentProps<TAs>`: `RenderableProps<TAs, DetailsContentOwnProps, Record<string, never>, HTMLElement>`

package/agents/reference/elements/popover.md

@@ -48,6 +48,6 @@
 
 ## Other types
 
-- `PopoverTriggerProps<TAs>`: `NativeButtonProps<TAs, PopoverTriggerOwnProps>`
-- `PopoverCloseProps<TAs>`: `NativeButtonProps<TAs, PopoverCloseOwnProps>`
-- `PopoverSurfaceProps`: `PopoverSurfaceOwnProps & Omit<ComponentPropsWithRef<"div">, keyof PopoverSurfaceOwnProps | "popover">` — `popover`, `data-side`, `data-align` and `data-positioning` are owned by the element.
+- `PopoverTriggerProps<TAs>`: `NativeButtonProps<TAs, PopoverTriggerOwnProps & PopoverInvokerNativeProps>`
+- `PopoverCloseProps<TAs>`: `NativeButtonProps<TAs, PopoverCloseOwnProps & PopoverInvokerNativeProps>`
+- `PopoverSurfaceProps`: `PopoverSurfaceOwnProps & Omit<ComponentPropsWithRef<"div">, keyof PopoverSurfaceOwnProps>` — Native props can override the surface defaults.

package/dist/ai/UiDocument.d.ts

@@ -0,0 +1,16 @@
+import type { ReactElement } from "react";
+import type { UiDocumentProps } from "./types.js";
+/**
+ * Renders an untrusted UI document. It validates first and throws `UiDocumentError` instead of
+ * rendering a partial guess, then renders each part with its UIify component. It uses no state
+ * or context, so it runs in a Server Component and hydrates on the client; wrap it in `Suspense`.
+ *
+ * Documents are immutable: the first render of a `node` object validates and renders a frozen
+ * copy of it (see `loadDocument`), and later changes to that object are ignored. Pass a new
+ * object to render a changed document.
+ */
+export declare function UiDocument({ node }: UiDocumentProps): ReactElement;
+export declare namespace UiDocument {
+    var displayName: string;
+}
+//# sourceMappingURL=UiDocument.d.ts.map

package/dist/ai/UiDocument.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UiDocument.d.ts","sourceRoot":"","sources":["../../src/ai/UiDocument.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiB,YAAY,EAAa,MAAM,OAAO,CAAC;AAIpE,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,YAAY,CAAC;AAkClE;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,EAAE,IAAI,EAAE,EAAE,eAAe,GAAG,YAAY,CAGlE;yBAHe,UAAU"}

package/dist/ai/UiDocument.js

@@ -0,0 +1,33 @@
+import { createElement, use } from "react";
+import { uiParts } from "./catalog.generated.js";
+import { assertDocument, childrenOf, loadDocument } from "./load.js";
+const loads = /* @__PURE__ */ new WeakMap();
+function loadOnce(node) {
+  if (typeof node !== "object" || node === null) {
+    assertDocument(node);
+    return loadDocument(node);
+  }
+  let load = loads.get(node);
+  if (!load) {
+    load = loadDocument(node);
+    loads.set(node, load);
+  }
+  return load;
+}
+function renderNode(node, components, key) {
+  const type = uiParts[node.type].kind === "native" ? node.type : components.get(node.type);
+  if (type === void 0) throw new Error(`UI part type ${node.type} was not loaded`);
+  const children = childrenOf(node).map(
+    (child, index) => typeof child === "string" ? child : renderNode(child, components, index)
+  );
+  return createElement(type, key === void 0 ? node.props : { ...node.props, key }, ...children);
+}
+function UiDocument({ node }) {
+  const { root, components } = use(loadOnce(node));
+  return renderNode(root, components);
+}
+UiDocument.displayName = "UiDocument";
+export {
+  UiDocument
+};
+//# sourceMappingURL=UiDocument.js.map

package/dist/ai/UiDocument.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/ai/UiDocument.tsx"],"sourcesContent":["import { createElement, use } from \"react\";\nimport type { ComponentType, ReactElement, ReactNode } from \"react\";\nimport type { UiChild, UiNode, UiType } from \"./catalog.generated.js\";\nimport { uiParts } from \"./catalog.generated.js\";\nimport { assertDocument, childrenOf, loadDocument } from \"./load.js\";\nimport type { LoadedDocument, UiDocumentProps } from \"./types.js\";\n\n// One load per document object, so every render of the same `node` hands `use()` the same promise.\nconst loads = new WeakMap<object, Promise<LoadedDocument>>();\n\nfunction loadOnce(node: unknown): Promise<LoadedDocument> {\n  if (typeof node !== \"object\" || node === null) {\n    // A primitive cannot key the WeakMap and is never a valid document: throw its issues now.\n    assertDocument(node);\n    return loadDocument(node);\n  }\n  let load = loads.get(node);\n  if (!load) {\n    load = loadDocument(node);\n    loads.set(node, load);\n  }\n  return load;\n}\n\nfunction renderNode(\n  node: UiNode,\n  // oxlint-disable-next-line typescript/no-explicit-any -- each part takes its own props\n  components: ReadonlyMap<UiType, ComponentType<any>>,\n  key?: number,\n): ReactElement {\n  const type = uiParts[node.type].kind === \"native\" ? node.type : components.get(node.type);\n  if (type === undefined) throw new Error(`UI part type ${node.type} was not loaded`);\n  const children = childrenOf(node).map(\n    (child: UiChild, index: number): ReactNode =>\n      typeof child === \"string\" ? child : renderNode(child, components, index),\n  );\n  return createElement(type, key === undefined ? node.props : { ...node.props, key }, ...children);\n}\n\n/**\n * Renders an untrusted UI document. It validates first and throws `UiDocumentError` instead of\n * rendering a partial guess, then renders each part with its UIify component. It uses no state\n * or context, so it runs in a Server Component and hydrates on the client; wrap it in `Suspense`.\n *\n * Documents are immutable: the first render of a `node` object validates and renders a frozen\n * copy of it (see `loadDocument`), and later changes to that object are ignored. Pass a new\n * object to render a changed document.\n */\nexport function UiDocument({ node }: UiDocumentProps): ReactElement {\n  const { root, components } = use(loadOnce(node));\n  return renderNode(root, components);\n}\nUiDocument.displayName = \"UiDocument\";\n"],"mappings":"AAAA,SAAS,eAAe,WAAW;AAGnC,SAAS,eAAe;AACxB,SAAS,gBAAgB,YAAY,oBAAoB;AAIzD,MAAM,QAAQ,oBAAI,QAAyC;AAE3D,SAAS,SAAS,MAAwC;AACxD,MAAI,OAAO,SAAS,YAAY,SAAS,MAAM;AAE7C,mBAAe,IAAI;AACnB,WAAO,aAAa,IAAI;AAAA,EAC1B;AACA,MAAI,OAAO,MAAM,IAAI,IAAI;AACzB,MAAI,CAAC,MAAM;AACT,WAAO,aAAa,IAAI;AACxB,UAAM,IAAI,MAAM,IAAI;AAAA,EACtB;AACA,SAAO;AACT;AAEA,SAAS,WACP,MAEA,YACA,KACc;AACd,QAAM,OAAO,QAAQ,KAAK,IAAI,EAAE,SAAS,WAAW,KAAK,OAAO,WAAW,IAAI,KAAK,IAAI;AACxF,MAAI,SAAS,OAAW,OAAM,IAAI,MAAM,gBAAgB,KAAK,IAAI,iBAAiB;AAClF,QAAM,WAAW,WAAW,IAAI,EAAE;AAAA,IAChC,CAAC,OAAgB,UACf,OAAO,UAAU,WAAW,QAAQ,WAAW,OAAO,YAAY,KAAK;AAAA,EAC3E;AACA,SAAO,cAAc,MAAM,QAAQ,SAAY,KAAK,QAAQ,EAAE,GAAG,KAAK,OAAO,IAAI,GAAG,GAAG,QAAQ;AACjG;AAWO,SAAS,WAAW,EAAE,KAAK,GAAkC;AAClE,QAAM,EAAE,MAAM,WAAW,IAAI,IAAI,SAAS,IAAI,CAAC;AAC/C,SAAO,WAAW,MAAM,UAAU;AACpC;AACA,WAAW,cAAc;","names":[]}