@assistant-ui/react-generative-ui 0.0.18 → 0.0.20

package/dist/types.d.ts

@@ -1,7 +1,6 @@
-import { Action, NormalizedUIElement } from "./ir.js";
-import { ReactNode } from "react";
-import { ZodType } from "zod";
-//#region src/types.d.ts
+import type { ReactNode } from "react";
+import type { ZodType } from "zod";
+import type { Action, NormalizedUIElement } from "./ir.js";
 /**
  * The canonical generative-ui element, normalized from the flat `$type` shape
  * or the legacy `component` shape (see {@link normalizeUINode}). `children` is
@@ -9,25 +8,25 @@ import { ZodType } from "zod";
  * `props`. Alias of {@link NormalizedUIElement}; kept under its old name so the
  * package's public surface stays append-only.
  */
-type GenerativeUIElement = NormalizedUIElement;
-type GenerativeUIProps = NormalizedUIElement["props"];
+export type GenerativeUIElement = NormalizedUIElement;
+export type GenerativeUIProps = NormalizedUIElement["props"];
 /**
  * Anything renderable as generative UI — mirrors React's `ReactNode`: an
  * element, primitive text, a list of nodes, or nothing. Widened beyond the
  * model payload (a {@link GenerativeUIElement}) with the renderer's
  * null/boolean/undefined inputs.
  */
-type GenerativeUINode = GenerativeUIElement | string | number | boolean | null | undefined | GenerativeUINode[];
-type GenerativeUIAction = Action;
+export type GenerativeUINode = GenerativeUIElement | string | number | boolean | null | undefined | GenerativeUINode[];
+export type GenerativeUIAction = Action;
 /** Whether a node's props are still streaming in or have fully arrived. */
-type GenerativeUIStatus = "streaming" | "done";
+export type GenerativeUIStatus = "streaming" | "done";
 /** The dispatcher an interactive component calls to fire its `$action`. */
-type GenerativeUIDispatch = (action: Action) => unknown;
+export type GenerativeUIDispatch = (action: Action) => unknown;
 /** The render context threaded through {@link renderGenerativeUI}. */
-type GenerativeUIRenderContext = {
-  /** Whether the tool call's arguments are still streaming or are complete. */
-  status: GenerativeUIStatus;
-  dispatch?: GenerativeUIDispatch;
+export type GenerativeUIRenderContext = {
+    /** Whether the tool call's arguments are still streaming or are complete. */
+    status: GenerativeUIStatus;
+    dispatch?: GenerativeUIDispatch;
 };
 /**
  * Props a component's `render` receives: its model props, rendered `children`,
@@ -39,22 +38,22 @@ type GenerativeUIRenderContext = {
  * collide with a real `status`/`action`/`dispatch` prop.
  */
 type StreamingRenderProps<P> = (Partial<P> & {
-  children?: ReactNode;
-  $status: "streaming";
-  $action?: Action;
-  $dispatch?: GenerativeUIDispatch;
+    children?: ReactNode;
+    $status: "streaming";
+    $action?: Action;
+    $dispatch?: GenerativeUIDispatch;
 }) | (P & {
-  children?: ReactNode;
-  $status: "done";
-  $action?: Action;
-  $dispatch?: GenerativeUIDispatch;
+    children?: ReactNode;
+    $status: "done";
+    $action?: Action;
+    $dispatch?: GenerativeUIDispatch;
 });
 /** Props for a component that only renders once complete — `$status` is always `"done"`. */
 type StaticRenderProps<P> = P & {
-  children?: ReactNode;
-  $status: "done";
-  $action?: Action;
-  $dispatch?: GenerativeUIDispatch;
+    children?: ReactNode;
+    $status: "done";
+    $action?: Action;
+    $dispatch?: GenerativeUIDispatch;
 };
 /**
  * A component the model is allowed to render, with the schema for its props.
@@ -68,25 +67,25 @@ type StaticRenderProps<P> = P & {
  * fine (each node is mounted on its own fiber), but a given node must keep its
  * `type` across renders for hook identity to be stable.
  */
-type GenerativeUIComponent<P = any> = {
-  /** Natural-language description shown to the model when selecting the component. */
-  description: string;
-  /** Schema for the props the model must provide. Drives the tool parameters. */
-  properties: ZodType<P>;
-  /**
-   * Render from partially-streamed props. Widened to `boolean | undefined`
-   * so a non-literal value (e.g. a variable) still resolves to this branch
-   * cleanly rather than matching neither; the strict `false | undefined`
-   * branch below is the only one that promises complete props.
-   */
-  streamProperties: boolean | undefined;
-  render: (props: StreamingRenderProps<P>) => ReactNode;
+export type GenerativeUIComponent<P = any> = {
+    /** Natural-language description shown to the model when selecting the component. */
+    description: string;
+    /** Schema for the props the model must provide. Drives the tool parameters. */
+    properties: ZodType<P>;
+    /**
+     * Render from partially-streamed props. Widened to `boolean | undefined`
+     * so a non-literal value (e.g. a variable) still resolves to this branch
+     * cleanly rather than matching neither; the strict `false | undefined`
+     * branch below is the only one that promises complete props.
+     */
+    streamProperties: boolean | undefined;
+    render: (props: StreamingRenderProps<P>) => ReactNode;
 } | {
-  description: string;
-  properties: ZodType<P>;
-  /** Render only once props are complete (the default). */
-  streamProperties?: false | undefined;
-  render: (props: StaticRenderProps<P>) => ReactNode;
+    description: string;
+    properties: ZodType<P>;
+    /** Render only once props are complete (the default). */
+    streamProperties?: false | undefined;
+    render: (props: StaticRenderProps<P>) => ReactNode;
 };
 /**
  * The consumer-provided allowlist of components the model is permitted to
@@ -95,7 +94,6 @@ type GenerativeUIComponent<P = any> = {
  *
  * This registry is the security boundary — any `type` not present is rejected.
  */
-type GenerativeUILibrary = Record<string, GenerativeUIComponent>;
-//#endregion
-export { GenerativeUIAction, GenerativeUIComponent, GenerativeUIDispatch, GenerativeUIElement, GenerativeUILibrary, GenerativeUINode, GenerativeUIProps, GenerativeUIRenderContext, GenerativeUIStatus };
+export type GenerativeUILibrary = Record<string, GenerativeUIComponent>;
+export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"mappings":";;;;;;;;;;;KAWY,sBAAsB;KAEtB,oBAAoB;;;;;;;KAQpB,mBACR,qEAMA;KAEQ,qBAAqB;;KAGrB;;KAGA,wBAAwB,QAAQ;;KAGhC;;EAEV,QAAQ;EACR,WAAW;;;;;;;;;;;KAYR,qBAAqB,MACrB,QAAQ;EACP,WAAW;EACX;EACA,UAAU;EACV,YAAY;MAEb;EACC,WAAW;EACX;EACA,UAAU;EACV,YAAY;;;KAIb,kBAAkB,KAAK;EAC1B,WAAW;EACX;EACA,UAAU;EACV,YAAY;;;;;;;;;;;;;;KAeF,sBAAsB;;EAG5B;;EAEA,YAAY,QAAQ;;;;;;;EAOpB;EACA,SAAS,OAAO,qBAAqB,OAAO;;EAG5C;EACA,YAAY,QAAQ;;EAEpB;EACA,SAAS,OAAO,kBAAkB,OAAO;;;;;;;;;KAUnC,sBAAsB,eAAe"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AACnC,OAAO,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,gBAAa;AAExD;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,CAAC;AAEtD,MAAM,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GACxB,mBAAmB,GACnB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,gBAAgB,EAAE,CAAC;AAEvB,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAExC,2EAA2E;AAC3E,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,MAAM,CAAC;AAEtD,2EAA2E;AAC3E,MAAM,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;AAE/D,sEAAsE;AACtE,MAAM,MAAM,yBAAyB,GAAG;IACtC,6EAA6E;IAC7E,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,CAAC,EAAE,oBAAoB,CAAC;CACjC,CAAC;AAEF;;;;;;;;GAQG;AACH,KAAK,oBAAoB,CAAC,CAAC,IACvB,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;IACZ,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,oBAAoB,CAAC;CAClC,CAAC,GACF,CAAC,CAAC,GAAG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,oBAAoB,CAAC;CAClC,CAAC,CAAC;AAEP,4FAA4F;AAC5F,KAAK,iBAAiB,CAAC,CAAC,IAAI,CAAC,GAAG;IAC9B,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,oBAAoB,CAAC;CAClC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,qBAAqB,CAAC,CAAC,GAAG,GAAG,IACrC;IACE,oFAAoF;IACpF,WAAW,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACvB;;;;;OAKG;IACH,gBAAgB,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,MAAM,EAAE,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC;CACvD,GACD;IACE,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACvB,yDAAyD;IACzD,gBAAgB,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IACrC,MAAM,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC;CACpD,CAAC;AAEN;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC"}

package/dist/vocabulary/alert.d.ts

@@ -1,28 +1,25 @@
 import { z } from "zod";
-//#region src/vocabulary/alert.d.ts
-declare const alertVocabulary: {
-  Alert: {
-    description: string;
-    properties: z.ZodObject<{
-      title: z.ZodOptional<z.ZodString>;
-      description: z.ZodOptional<z.ZodString>;
-      tone: z.ZodOptional<z.ZodEnum<{
-        success: "success";
-        info: "info";
-        warning: "warning";
-        danger: "danger";
-      }>>;
-    }, z.core.$strip>;
-    render: ({ title, description, tone, children }: any) => import("react").JSX.Element;
-  };
-  Carousel: {
-    description: string;
-    properties: z.ZodObject<{
-      label: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>;
-    render: ({ label, children }: any) => import("react").JSX.Element;
-  };
+export declare const alertVocabulary: {
+    Alert: {
+        description: string;
+        properties: z.ZodObject<{
+            title: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            tone: z.ZodOptional<z.ZodEnum<{
+                danger: "danger";
+                info: "info";
+                success: "success";
+                warning: "warning";
+            }>>;
+        }, z.core.$strip>;
+        render: ({ title, description, tone, children }: any) => import("react").JSX.Element;
+    };
+    Carousel: {
+        description: string;
+        properties: z.ZodObject<{
+            label: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        render: ({ label, children }: any) => import("react").JSX.Element;
+    };
 };
-//#endregion
-export { alertVocabulary };
 //# sourceMappingURL=alert.d.ts.map

package/dist/vocabulary/alert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"alert.d.ts","names":[],"sources":["../../src/vocabulary/alert.tsx"],"mappings":";;cAQa"}
+{"version":3,"file":"alert.d.ts","sourceRoot":"","sources":["../../src/vocabulary/alert.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;CAkEG,CAAC"}

package/dist/vocabulary/collectFormValues.d.ts

@@ -1,23 +1,22 @@
-import { FormEvent } from "react";
-//#region src/vocabulary/collectFormValues.d.ts
+import type { FormEvent } from "react";
 /**
  * The subset of `HTMLInputElement`/`HTMLSelectElement`/`HTMLTextAreaElement` that {@link collectFormValues} reads. A structural type rather than the DOM interfaces themselves, so a plain object can stand in for a form control in tests.
  */
-type FormControlElementLike = {
-  readonly name: string;
-  readonly type: string;
-  readonly value: string;
-  readonly checked?: boolean;
-  readonly disabled: boolean;
+export type FormControlElementLike = {
+    readonly name: string;
+    readonly type: string;
+    readonly value: string;
+    readonly checked?: boolean;
+    readonly disabled: boolean;
+    readonly hasAttribute: (name: string) => boolean;
+    readonly matches?: ((selector: string) => boolean) | undefined;
 };
 /**
- * Collects a submitted form's named control values into a plain object, keyed by `name`, in document order. Reads each control's live DOM state rather than `FormData`, so a checkbox resolves to its `checked` boolean instead of an on/off string. A radio group resolves to its checked option's `value`, or `undefined` if none is checked. Any other repeated `name` resolves to an array of its controls' values, in document order. Controls without a `name`, or that are `disabled`, are skipped entirely.
+ * Collects a submitted form's named control values into a plain object, keyed by `name`, in document order. Reads each control's live DOM state rather than `FormData`, so a checkbox resolves to its `checked` boolean instead of an on/off string. A radio group resolves to its checked option's `value`, or `undefined` if none is checked. Any other repeated `name` resolves to an array of its controls' values, in document order. Controls without a `name`, that carry `data-aui-generated-name`, or that are effectively disabled, including through an ancestor disabled fieldset outside its first legend, are skipped entirely.
  */
-declare function collectFormValues(elements: ArrayLike<FormControlElementLike>): Record<string, unknown>;
+export declare function collectFormValues(elements: ArrayLike<FormControlElementLike>): Record<string, unknown>;
 /**
  * Convenience wrapper around {@link collectFormValues} for a native form submit event; the cast from `HTMLFormControlsCollection` to `ArrayLike<FormControlElementLike>` lives here once instead of at every call site.
  */
-declare function collectFormValuesFromEvent(event: FormEvent<HTMLFormElement>): Record<string, unknown>;
-//#endregion
-export { FormControlElementLike, collectFormValues, collectFormValuesFromEvent };
+export declare function collectFormValuesFromEvent(event: FormEvent<HTMLFormElement>): Record<string, unknown>;
 //# sourceMappingURL=collectFormValues.d.ts.map

package/dist/vocabulary/collectFormValues.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collectFormValues.d.ts","names":[],"sources":["../../src/vocabulary/collectFormValues.ts"],"mappings":";;;;;KAKY;WACD;WACA;WACA;WACA;WACA;;;;;iBAMK,kBACd,UAAU,UAAU,0BACnB;;;;iBAgCa,2BACd,OAAO,UAAU,mBAChB"}
+{"version":3,"file":"collectFormValues.d.ts","sourceRoot":"","sources":["../../src/vocabulary/collectFormValues.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACjD,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;CAChE,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,SAAS,CAAC,sBAAsB,CAAC,GAC1C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiCzB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,SAAS,CAAC,eAAe,CAAC,GAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzB"}

package/dist/vocabulary/collectFormValues.js

@@ -1,12 +1,13 @@
+import "../constants.js";
 //#region src/vocabulary/collectFormValues.ts
 /**
-* Collects a submitted form's named control values into a plain object, keyed by `name`, in document order. Reads each control's live DOM state rather than `FormData`, so a checkbox resolves to its `checked` boolean instead of an on/off string. A radio group resolves to its checked option's `value`, or `undefined` if none is checked. Any other repeated `name` resolves to an array of its controls' values, in document order. Controls without a `name`, or that are `disabled`, are skipped entirely.
+* Collects a submitted form's named control values into a plain object, keyed by `name`, in document order. Reads each control's live DOM state rather than `FormData`, so a checkbox resolves to its `checked` boolean instead of an on/off string. A radio group resolves to its checked option's `value`, or `undefined` if none is checked. Any other repeated `name` resolves to an array of its controls' values, in document order. Controls without a `name`, that carry `data-aui-generated-name`, or that are effectively disabled, including through an ancestor disabled fieldset outside its first legend, are skipped entirely.
 */
 function collectFormValues(elements) {
 	const values = Object.create(null);
 	for (const element of Array.from(elements)) {
 		const { name, disabled } = element;
-		if (!name || disabled) continue;
+		if (!name || disabled || element.hasAttribute("data-aui-generated-name") || element.matches?.(":disabled")) continue;
 		if (element.type === "radio") {
 			if (element.checked) values[name] = element.value;
 			else if (!Object.hasOwn(values, name)) values[name] = void 0;

package/dist/vocabulary/collectFormValues.js.map

@@ -1 +1 @@
-{"version":3,"file":"collectFormValues.js","names":[],"sources":["../../src/vocabulary/collectFormValues.ts"],"sourcesContent":["import type { FormEvent } from \"react\";\n\n/**\n * The subset of `HTMLInputElement`/`HTMLSelectElement`/`HTMLTextAreaElement` that {@link collectFormValues} reads. A structural type rather than the DOM interfaces themselves, so a plain object can stand in for a form control in tests.\n */\nexport type FormControlElementLike = {\n  readonly name: string;\n  readonly type: string;\n  readonly value: string;\n  readonly checked?: boolean;\n  readonly disabled: boolean;\n};\n\n/**\n * Collects a submitted form's named control values into a plain object, keyed by `name`, in document order. Reads each control's live DOM state rather than `FormData`, so a checkbox resolves to its `checked` boolean instead of an on/off string. A radio group resolves to its checked option's `value`, or `undefined` if none is checked. Any other repeated `name` resolves to an array of its controls' values, in document order. Controls without a `name`, or that are `disabled`, are skipped entirely.\n */\nexport function collectFormValues(\n  elements: ArrayLike<FormControlElementLike>,\n): Record<string, unknown> {\n  const values: Record<string, unknown> = Object.create(null);\n\n  for (const element of Array.from(elements)) {\n    const { name, disabled } = element;\n    if (!name || disabled) continue;\n\n    if (element.type === \"radio\") {\n      if (element.checked) values[name] = element.value;\n      else if (!Object.hasOwn(values, name)) values[name] = undefined;\n      continue;\n    }\n\n    const value: string | boolean =\n      element.type === \"checkbox\" ? (element.checked ?? false) : element.value;\n\n    if (Object.hasOwn(values, name)) {\n      const existing = values[name];\n      values[name] = Array.isArray(existing)\n        ? [...existing, value]\n        : [existing, value];\n    } else {\n      values[name] = value;\n    }\n  }\n\n  return values;\n}\n\n/**\n * Convenience wrapper around {@link collectFormValues} for a native form submit event; the cast from `HTMLFormControlsCollection` to `ArrayLike<FormControlElementLike>` lives here once instead of at every call site.\n */\nexport function collectFormValuesFromEvent(\n  event: FormEvent<HTMLFormElement>,\n): Record<string, unknown> {\n  return collectFormValues(\n    event.currentTarget\n      .elements as unknown as ArrayLike<FormControlElementLike>,\n  );\n}\n"],"mappings":";;;;AAgBA,SAAgB,kBACd,UACyB;CACzB,MAAM,SAAkC,OAAO,OAAO,IAAI;CAE1D,KAAK,MAAM,WAAW,MAAM,KAAK,QAAQ,GAAG;EAC1C,MAAM,EAAE,MAAM,aAAa;EAC3B,IAAI,CAAC,QAAQ,UAAU;EAEvB,IAAI,QAAQ,SAAS,SAAS;GAC5B,IAAI,QAAQ,SAAS,OAAO,QAAQ,QAAQ;QACvC,IAAI,CAAC,OAAO,OAAO,QAAQ,IAAI,GAAG,OAAO,QAAQ,KAAA;GACtD;EACF;EAEA,MAAM,QACJ,QAAQ,SAAS,aAAc,QAAQ,WAAW,QAAS,QAAQ;EAErE,IAAI,OAAO,OAAO,QAAQ,IAAI,GAAG;GAC/B,MAAM,WAAW,OAAO;GACxB,OAAO,QAAQ,MAAM,QAAQ,QAAQ,IACjC,CAAC,GAAG,UAAU,KAAK,IACnB,CAAC,UAAU,KAAK;EACtB,OACE,OAAO,QAAQ;CAEnB;CAEA,OAAO;AACT;;;;AAKA,SAAgB,2BACd,OACyB;CACzB,OAAO,kBACL,MAAM,cACH,QACL;AACF"}
+{"version":3,"file":"collectFormValues.js","names":[],"sources":["../../src/vocabulary/collectFormValues.ts"],"sourcesContent":["import type { FormEvent } from \"react\";\nimport { GENERATED_NAME_ATTR } from \"../constants\";\n\n/**\n * The subset of `HTMLInputElement`/`HTMLSelectElement`/`HTMLTextAreaElement` that {@link collectFormValues} reads. A structural type rather than the DOM interfaces themselves, so a plain object can stand in for a form control in tests.\n */\nexport type FormControlElementLike = {\n  readonly name: string;\n  readonly type: string;\n  readonly value: string;\n  readonly checked?: boolean;\n  readonly disabled: boolean;\n  readonly hasAttribute: (name: string) => boolean;\n  readonly matches?: ((selector: string) => boolean) | undefined;\n};\n\n/**\n * Collects a submitted form's named control values into a plain object, keyed by `name`, in document order. Reads each control's live DOM state rather than `FormData`, so a checkbox resolves to its `checked` boolean instead of an on/off string. A radio group resolves to its checked option's `value`, or `undefined` if none is checked. Any other repeated `name` resolves to an array of its controls' values, in document order. Controls without a `name`, that carry `data-aui-generated-name`, or that are effectively disabled, including through an ancestor disabled fieldset outside its first legend, are skipped entirely.\n */\nexport function collectFormValues(\n  elements: ArrayLike<FormControlElementLike>,\n): Record<string, unknown> {\n  const values: Record<string, unknown> = Object.create(null);\n\n  for (const element of Array.from(elements)) {\n    const { name, disabled } = element;\n    if (\n      !name ||\n      disabled ||\n      element.hasAttribute(GENERATED_NAME_ATTR) ||\n      element.matches?.(\":disabled\")\n    )\n      continue;\n\n    if (element.type === \"radio\") {\n      if (element.checked) values[name] = element.value;\n      else if (!Object.hasOwn(values, name)) values[name] = undefined;\n      continue;\n    }\n\n    const value: string | boolean =\n      element.type === \"checkbox\" ? (element.checked ?? false) : element.value;\n\n    if (Object.hasOwn(values, name)) {\n      const existing = values[name];\n      values[name] = Array.isArray(existing)\n        ? [...existing, value]\n        : [existing, value];\n    } else {\n      values[name] = value;\n    }\n  }\n\n  return values;\n}\n\n/**\n * Convenience wrapper around {@link collectFormValues} for a native form submit event; the cast from `HTMLFormControlsCollection` to `ArrayLike<FormControlElementLike>` lives here once instead of at every call site.\n */\nexport function collectFormValuesFromEvent(\n  event: FormEvent<HTMLFormElement>,\n): Record<string, unknown> {\n  return collectFormValues(\n    event.currentTarget\n      .elements as unknown as ArrayLike<FormControlElementLike>,\n  );\n}\n"],"mappings":";;;;;AAmBA,SAAgB,kBACd,UACyB;CACzB,MAAM,SAAkC,OAAO,OAAO,IAAI;CAE1D,KAAK,MAAM,WAAW,MAAM,KAAK,QAAQ,GAAG;EAC1C,MAAM,EAAE,MAAM,aAAa;EAC3B,IACE,CAAC,QACD,YACA,QAAQ,aAAA,yBAAgC,KACxC,QAAQ,UAAU,WAAW,GAE7B;EAEF,IAAI,QAAQ,SAAS,SAAS;GAC5B,IAAI,QAAQ,SAAS,OAAO,QAAQ,QAAQ;QACvC,IAAI,CAAC,OAAO,OAAO,QAAQ,IAAI,GAAG,OAAO,QAAQ,KAAA;GACtD;EACF;EAEA,MAAM,QACJ,QAAQ,SAAS,aAAc,QAAQ,WAAW,QAAS,QAAQ;EAErE,IAAI,OAAO,OAAO,QAAQ,IAAI,GAAG;GAC/B,MAAM,WAAW,OAAO;GACxB,OAAO,QAAQ,MAAM,QAAQ,QAAQ,IACjC,CAAC,GAAG,UAAU,KAAK,IACnB,CAAC,UAAU,KAAK;EACtB,OACE,OAAO,QAAQ;CAEnB;CAEA,OAAO;AACT;;;;AAKA,SAAgB,2BACd,OACyB;CACzB,OAAO,kBACL,MAAM,cACH,QACL;AACF"}

package/dist/vocabulary/data.d.ts

@@ -1,52 +1,49 @@
 import { z } from "zod";
-//#region src/vocabulary/data.d.ts
-declare const dataVocabulary: {
-  Table: {
-    description: string;
-    properties: z.ZodObject<{
-      columns: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        label: z.ZodString;
-      }, z.core.$strip>>>;
-      rows: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>>;
-    }, z.core.$strip>;
-    render: ({ columns, rows, children }: any) => import("react").JSX.Element;
-  };
-  Markdown: {
-    description: string;
-    properties: z.ZodObject<{
-      value: z.ZodString;
-    }, z.core.$strip>;
-    streamProperties: true;
-    render: ({ value, children }: any) => import("react").JSX.Element;
-  };
-  Chart: {
-    description: string;
-    properties: z.ZodObject<{
-      variant: z.ZodEnum<{
-        bar: "bar";
-        line: "line";
-        sparkline: "sparkline";
-        area: "area";
-      }>;
-      data: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        label: z.ZodOptional<z.ZodString>;
-        value: z.ZodNumber;
-      }, z.core.$strip>>>;
-      series: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        label: z.ZodOptional<z.ZodString>;
-        data: z.ZodArray<z.ZodObject<{
-          label: z.ZodOptional<z.ZodString>;
-          value: z.ZodNumber;
-        }, z.core.$strip>>;
-      }, z.core.$strip>>>;
-      stacked: z.ZodOptional<z.ZodBoolean>;
-      showAxis: z.ZodOptional<z.ZodBoolean>;
-      showLegend: z.ZodOptional<z.ZodBoolean>;
-      color: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>;
-    render: ({ variant, data, series, stacked, showAxis, showLegend, color }: any) => import("react").JSX.Element;
-  };
+export declare const dataVocabulary: {
+    Table: {
+        description: string;
+        properties: z.ZodObject<{
+            columns: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+            }, z.core.$strip>>>;
+            rows: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>>;
+        }, z.core.$strip>;
+        render: ({ columns, rows, children }: any) => import("react").JSX.Element;
+    };
+    Markdown: {
+        description: string;
+        properties: z.ZodObject<{
+            value: z.ZodString;
+        }, z.core.$strip>;
+        streamProperties: true;
+        render: ({ value, children }: any) => import("react").JSX.Element;
+    };
+    Chart: {
+        description: string;
+        properties: z.ZodObject<{
+            variant: z.ZodEnum<{
+                bar: "bar";
+                line: "line";
+                sparkline: "sparkline";
+                area: "area";
+            }>;
+            data: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                label: z.ZodOptional<z.ZodString>;
+                value: z.ZodNumber;
+            }, z.core.$strip>>>;
+            series: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                label: z.ZodOptional<z.ZodString>;
+                data: z.ZodArray<z.ZodObject<{
+                    label: z.ZodOptional<z.ZodString>;
+                    value: z.ZodNumber;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>>;
+            stacked: z.ZodOptional<z.ZodBoolean>;
+            showAxis: z.ZodOptional<z.ZodBoolean>;
+            showLegend: z.ZodOptional<z.ZodBoolean>;
+            color: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        render: ({ variant, data, series, stacked, showAxis, showLegend, color, }: any) => import("react").JSX.Element;
+    };
 };
-//#endregion
-export { dataVocabulary };
 //# sourceMappingURL=data.d.ts.map

package/dist/vocabulary/data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data.d.ts","names":[],"sources":["../../src/vocabulary/data.tsx"],"mappings":";;cAmSa"}
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../src/vocabulary/data.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmSxB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqOI,CAAC"}

package/dist/vocabulary/dispatch.d.ts

@@ -1,11 +1,8 @@
-import { Action } from "../ir.js";
-import { GenerativeUIDispatch } from "../types.js";
-//#region src/vocabulary/dispatch.d.ts
-declare const actionAttr: (a: Action | undefined) => string | undefined;
+import type { Action } from "../ir.js";
+import type { GenerativeUIDispatch } from "../types.js";
+export declare const actionAttr: (a: Action | undefined) => string | undefined;
 /**
  * Fires `$action` through `$dispatch` when both are present, merging a runtime value into the payload under the reserved `$input` key (not `value`) so the user's input never clobbers a model-supplied `value` field. No-op when no registry is wired. The returned promise from an async handler is caught and re-thrown on a microtask so rejections surface rather than going unhandled.
  */
-declare const fire: ($action: Action | undefined, $dispatch: GenerativeUIDispatch | undefined, input?: unknown) => void;
-//#endregion
-export { actionAttr, fire };
+export declare const fire: ($action: Action | undefined, $dispatch: GenerativeUIDispatch | undefined, input?: unknown) => void;
 //# sourceMappingURL=dispatch.d.ts.map

package/dist/vocabulary/dispatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dispatch.d.ts","names":[],"sources":["../../src/vocabulary/dispatch.ts"],"mappings":";;;cAGa,aAAc,GAAG;;;;cAMjB,OACX,SAAS,oBACT,WAAW,kCACX"}
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/vocabulary/dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,iBAAc;AACpC,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAiB;AAErD,eAAO,MAAM,UAAU,GAAI,GAAG,MAAM,GAAG,SAAS,KAAG,MAAM,GAAG,SACzB,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,IAAI,GACf,SAAS,MAAM,GAAG,SAAS,EAC3B,WAAW,oBAAoB,GAAG,SAAS,EAC3C,QAAQ,OAAO,SAShB,CAAC"}

package/dist/vocabulary/fact.d.ts

@@ -1,15 +1,12 @@
 import { z } from "zod";
-//#region src/vocabulary/fact.d.ts
-declare const factVocabulary: {
-  Fact: {
-    description: string;
-    properties: z.ZodObject<{
-      label: z.ZodString;
-      value: z.ZodString;
-    }, z.core.$strip>;
-    render: ({ label, value, children }: any) => import("react").JSX.Element;
-  };
+export declare const factVocabulary: {
+    Fact: {
+        description: string;
+        properties: z.ZodObject<{
+            label: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>;
+        render: ({ label, value, children }: any) => import("react").JSX.Element;
+    };
 };
-//#endregion
-export { factVocabulary };
 //# sourceMappingURL=fact.d.ts.map

package/dist/vocabulary/fact.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fact.d.ts","names":[],"sources":["../../src/vocabulary/fact.tsx"],"mappings":";;cAIa"}
+{"version":3,"file":"fact.d.ts","sourceRoot":"","sources":["../../src/vocabulary/fact.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,cAAc;;;;;;;;;CAkBI,CAAC"}

package/dist/vocabulary/form.d.ts

@@ -1,14 +1,11 @@
 import { z } from "zod";
-//#region src/vocabulary/form.d.ts
-declare const formVocabulary: {
-  Form: {
-    description: string;
-    properties: z.ZodObject<{
-      gap: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>;
-    render: ({ gap, $action, $dispatch, children }: any) => import("react").JSX.Element;
-  };
+export declare const formVocabulary: {
+    Form: {
+        description: string;
+        properties: z.ZodObject<{
+            gap: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+        render: ({ gap, $action, $dispatch, children }: any) => import("react").JSX.Element;
+    };
 };
-//#endregion
-export { formVocabulary };
 //# sourceMappingURL=form.d.ts.map

package/dist/vocabulary/form.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form.d.ts","names":[],"sources":["../../src/vocabulary/form.tsx"],"mappings":";;cAKa"}
+{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../../src/vocabulary/form.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,cAAc;;;;;;;;CA4BI,CAAC"}

package/dist/vocabulary/icon.d.ts

@@ -1,44 +1,41 @@
 import { z } from "zod";
-//#region src/vocabulary/icon.d.ts
-declare const iconVocabulary: {
-  Icon: {
-    description: string;
-    properties: z.ZodObject<{
-      name: z.ZodEnum<{
-        search: "search";
-        check: "check";
-        sun: "sun";
-        moon: "moon";
-        cloud: "cloud";
-        rain: "rain";
-        snow: "snow";
-        wind: "wind";
-        play: "play";
-        pause: "pause";
-        x: "x";
-        star: "star";
-        heart: "heart";
-        "arrow-right": "arrow-right";
-        "arrow-up-right": "arrow-up-right";
-        "chevron-right": "chevron-right";
-        calendar: "calendar";
-        clock: "clock";
-        "map-pin": "map-pin";
-        plane: "plane";
-        truck: "truck";
-        "credit-card": "credit-card";
-        user: "user";
-        bell: "bell";
-      }>;
-      size: z.ZodOptional<z.ZodEnum<{
-        sm: "sm";
-        md: "md";
-        lg: "lg";
-      }>>;
-    }, z.core.$strip>;
-    render: ({ name, size }: any) => import("react").JSX.Element | null;
-  };
+export declare const iconVocabulary: {
+    Icon: {
+        description: string;
+        properties: z.ZodObject<{
+            name: z.ZodEnum<{
+                sun: "sun";
+                moon: "moon";
+                cloud: "cloud";
+                rain: "rain";
+                snow: "snow";
+                wind: "wind";
+                play: "play";
+                pause: "pause";
+                check: "check";
+                x: "x";
+                star: "star";
+                heart: "heart";
+                "arrow-right": "arrow-right";
+                "arrow-up-right": "arrow-up-right";
+                "chevron-right": "chevron-right";
+                calendar: "calendar";
+                clock: "clock";
+                "map-pin": "map-pin";
+                plane: "plane";
+                truck: "truck";
+                "credit-card": "credit-card";
+                user: "user";
+                search: "search";
+                bell: "bell";
+            }>;
+            size: z.ZodOptional<z.ZodEnum<{
+                sm: "sm";
+                md: "md";
+                lg: "lg";
+            }>>;
+        }, z.core.$strip>;
+        render: ({ name, size }: any) => import("react").JSX.Element | null;
+    };
 };
-//#endregion
-export { iconVocabulary };
 //# sourceMappingURL=icon.d.ts.map

package/dist/vocabulary/icon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"icon.d.ts","names":[],"sources":["../../src/vocabulary/icon.tsx"],"mappings":";;cAyIa"}
+{"version":3,"file":"icon.d.ts","sourceRoot":"","sources":["../../src/vocabulary/icon.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAwIxB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCI,CAAC"}

package/dist/vocabulary/index.d.ts

@@ -1,5 +1,4 @@
-import { GenerativeUILibrary } from "../types.js";
-//#region src/vocabulary/index.d.ts
+import type { GenerativeUILibrary } from "../types.js";
 /**
  * The closed generative-ui vocabulary the factory ships: a fixed set of
  * intrinsic components the model may render, each a zod `properties` schema
@@ -9,7 +8,5 @@ import { GenerativeUILibrary } from "../types.js";
  * `new JSONGenerativeUI({ library: defaultGenerativeUILibrary })`, and override
  * or extend entries with their own `defineGenerativeComponents`.
  */
-declare const defaultGenerativeUILibrary: GenerativeUILibrary;
-//#endregion
-export { defaultGenerativeUILibrary };
+export declare const defaultGenerativeUILibrary: GenerativeUILibrary;
 //# sourceMappingURL=index.d.ts.map

package/dist/vocabulary/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/vocabulary/index.ts"],"mappings":";;;;;;;;;;;cAqBa,4BAA4B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vocabulary/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAiB;AAYpD;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,EAAE,mBAWxC,CAAC"}