@dudousxd/nestjs-agent-react 0.34.4 → 0.35.0

package/dist/{generative-ui-DdUZPCXX.d.ts → generative-ui-ClYT7OgL.d.cts}

@@ -2,7 +2,7 @@ import * as React from 'react';
 import { ReactNode } from 'react';
 import { ActionProposalView, StoredMessage, ElicitationQuestion, ElicitationInputType, ToolPresentation, ToolCatalogEntry, ToolResultField, ToolResultView, ToolPresentationTone, ToolConfirmation, ElicitationInput } from '@dudousxd/nestjs-agent-core';
 import { UIMessage, ToolUIPart, DynamicToolUIPart } from 'ai';
-import { c as GenerativeUIOptions, G as GenerativeUIItem, d as GenerativeUIProblem, b as GenerativeUIElement, e as GenerativeUIState } from './types-DZtFsWec.js';
+import { c as GenerativeUIOptions, G as GenerativeUIItem, d as GenerativeUIProblem, i as GenuiPlaceholder, b as GenerativeUIElement, e as GenerativeUIState, h as GenuiNodeState } from './types-COuArD3c.cjs';
 
 type ApprovalTarget = {
     kind: 'legacy';
@@ -393,6 +393,11 @@ interface TranscriptUiBlock {
     componentVersions?: Record<string, number>;
     /** The tool call that pushed it (`ctx.emitUi`); `null` for a component pushed outside a tool. */
     toolCallId: string | null;
+    /**
+     * A preview drawn while the model writes the call's arguments (genui `streaming: 'partial'`):
+     * unvalidated, replaced in place by the final push. Absent on a final component.
+     */
+    partial?: true;
 }
 /** One choice a question offers, with its live selection state. */
 interface TranscriptQuestionOption {
@@ -598,6 +603,19 @@ declare function formatRelativeTime(date: Date): string;
 
 /** What to draw instead of a component that did not render. Default: nothing. */
 type GenerativeUIFallback = ReactNode | ((problem: GenerativeUIProblem) => ReactNode);
+/**
+ * The tree node being rendered — read it in a renderer to draw a skeleton while the model is still
+ * writing the node (`incomplete`), e.g. a chart's axes before its data. `null` outside a tree.
+ *
+ * ```tsx
+ * function Chart(props: ChartProps) {
+ *   const node = useGenuiNode();
+ *   if (node?.incomplete && !props.data?.length) return <ChartSkeleton title={props.title} />;
+ *   return <BarChart {...props} />;
+ * }
+ * ```
+ */
+declare function useGenuiNode(): GenuiNodeState | null;
 /**
  * Renders a `genui:tree` frame's `{ root }` node by node through the same registry, catalog and
  * resolver as top-level components. Used automatically for tree frames unless a `treeRenderer`
@@ -611,6 +629,8 @@ interface GenerativeUIScopeProps extends GenerativeUIOptions {
     componentVersions?: Record<string, number>;
     fallback?: GenerativeUIFallback;
     loading?: ReactNode;
+    /** Drawn for a tree node held back while the model writes it. Default: `loading`. */
+    placeholder?: GenuiPlaceholder;
     onError?: (error: unknown, item: GenerativeUIItem) => void;
     children?: ReactNode;
 }
@@ -618,11 +638,13 @@ interface GenerativeUIScopeProps extends GenerativeUIOptions {
  * The registry, catalog and fallbacks tree nodes render with. `<GenerativeUI>` provides it; wrap
  * your own chrome in it when you draw `useGenerativeUI`'s `Component` yourself and it may be a tree.
  */
-declare function GenerativeUIScope({ registry, catalog, resolveComponent, fallback, fallbackText, componentVersions, loading, onError, children, }: GenerativeUIScopeProps): React.JSX.Element;
+declare function GenerativeUIScope({ registry, catalog, resolveComponent, fallback, fallbackText, componentVersions, loading, placeholder, onError, children, }: GenerativeUIScopeProps): React.JSX.Element;
 /** What `<GenuiProvider>` hands every `<GenerativeUI>` / `useGenerativeUI` below it. */
 interface GenuiProviderValue extends Partial<GenerativeUIOptions> {
     fallback?: GenerativeUIFallback;
     loading?: ReactNode;
+    /** Drawn for a tree node held back while the model writes it (`streaming: 'complete'`). */
+    placeholder?: GenuiPlaceholder;
     onError?: (error: unknown, item: GenerativeUIItem) => void;
 }
 /** The enclosing `<GenuiProvider>`'s settings, or `null` outside one. */
@@ -642,7 +664,7 @@ interface GenuiProviderProps extends GenuiProviderValue {
  * </GenuiProvider>
  * ```
  */
-declare function GenuiProvider({ registry, catalog, resolveComponent, treeRenderer, fallback, loading, onError, children, }: GenuiProviderProps): React.JSX.Element;
+declare function GenuiProvider({ registry, catalog, resolveComponent, treeRenderer, fallback, loading, placeholder, onError, children, }: GenuiProviderProps): React.JSX.Element;
 /**
  * The headless half of {@link GenerativeUI}: what to draw for one pushed component, or `null` when
  * `part` is not one. Options default to the enclosing `<GenuiProvider>`'s.
@@ -655,6 +677,11 @@ interface GenerativeUIProps extends Partial<GenerativeUIOptions> {
     fallback?: GenerativeUIFallback;
     /** Drawn while a resolver or an async validation is pending. Default: the provider's, else nothing. */
     loading?: ReactNode;
+    /**
+     * Drawn for a tree node held back while the model writes it (its component streams `complete`).
+     * Default: the provider's, else `loading`.
+     */
+    placeholder?: GenuiPlaceholder;
     /** A renderer threw (the item shows `fallback`). */
     onError?: (error: unknown, item: GenerativeUIItem) => void;
 }
@@ -667,6 +694,6 @@ interface GenerativeUIProps extends Partial<GenerativeUIOptions> {
  * <GenerativeUI part={block} />
  * ```
  */
-declare function GenerativeUI({ part, registry, catalog, resolveComponent, treeRenderer, fallback: ownFallback, loading: ownLoading, onError: ownOnError, }: GenerativeUIProps): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | React.JSX.Element | null | undefined;
+declare function GenerativeUI({ part, registry, catalog, resolveComponent, treeRenderer, fallback: ownFallback, loading: ownLoading, placeholder: ownPlaceholder, onError: ownOnError, }: GenerativeUIProps): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | React.JSX.Element | null | undefined;
 
-export { correctedCallIds as $, type ApproveOptions as A, type BuildBlocksOptions as B, type ChatStatus as C, type DescribeToolCallOptions as D, type ElicitationBlockOptions as E, type TranscriptApproval as F, GenerativeUI as G, type TranscriptApprovalStatus as H, type TranscriptElicitationBlock as I, type TranscriptElicitationOutcome as J, type TranscriptFilesBlock as K, type TranscriptQuestion as L, type MessageUsageInfo as M, type TranscriptQuestionOption as N, type TranscriptReasoningBlock as O, type TranscriptSettleState as P, type TranscriptSource as Q, type RawAnswer as R, type SettleAction as S, type TranscriptUiBlock as T, type UsageSummary as U, type TranscriptSourcesBlock as V, type TranscriptTextBlock as W, type TranscriptToolBlock as X, type TranscriptToolCall as Y, buildTranscriptBlocks as Z, coerceAnswer as _, type GenerativeUIFallback as a, describeTimestamp as a0, describeToolCall as a1, describeUsage as a2, extractMessageText as a3, fillTemplate as a4, formatRelativeTime as a5, groupToolActivity as a6, inferResultView as a7, isActionCall as a8, phraseFor as a9, proposalNeedsPolling as aa, readPath as ab, reconcileProposalMessages as ac, resolveResultView as ad, toolCallState as ae, toolCatalogFrom as af, type GenerativeUIProps as b, GenerativeUIScope as c, type GenerativeUIScopeProps as d, GenuiProvider as e, type GenuiProviderProps as f, type GenuiProviderValue as g, GenuiTree as h, useGenuiProvider as i, type ApprovalTarget as j, type TranscriptBlock as k, type TimestampInfo as l, type TranscriptFile as m, type ToolCatalog as n, type AnyToolUIPart as o, type ApprovalBlockOptions as p, type CoercibleQuestion as q, type GroupToolActivityOptions as r, type ResolvedReading as s, type ResolvedResultView as t, useGenerativeUI as u, type RetrievedPassage as v, type ToolActivityGroup as w, type ToolCallDescription as x, type ToolCallState as y, type ToolCallStatus as z };
+export { coerceAnswer as $, type ApproveOptions as A, type BuildBlocksOptions as B, type ChatStatus as C, type DescribeToolCallOptions as D, type ElicitationBlockOptions as E, type ToolCallStatus as F, GenerativeUI as G, type TranscriptApproval as H, type TranscriptApprovalStatus as I, type TranscriptElicitationBlock as J, type TranscriptElicitationOutcome as K, type TranscriptFilesBlock as L, type MessageUsageInfo as M, type TranscriptQuestion as N, type TranscriptQuestionOption as O, type TranscriptReasoningBlock as P, type TranscriptSettleState as Q, type RawAnswer as R, type SettleAction as S, type TranscriptUiBlock as T, type UsageSummary as U, type TranscriptSource as V, type TranscriptSourcesBlock as W, type TranscriptTextBlock as X, type TranscriptToolBlock as Y, type TranscriptToolCall as Z, buildTranscriptBlocks as _, type GenerativeUIFallback as a, correctedCallIds as a0, describeTimestamp as a1, describeToolCall as a2, describeUsage as a3, extractMessageText as a4, fillTemplate as a5, formatRelativeTime as a6, groupToolActivity as a7, inferResultView as a8, isActionCall as a9, phraseFor as aa, proposalNeedsPolling as ab, readPath as ac, reconcileProposalMessages as ad, resolveResultView as ae, toolCallState as af, toolCatalogFrom as ag, type GenerativeUIProps as b, GenerativeUIScope as c, type GenerativeUIScopeProps as d, GenuiProvider as e, type GenuiProviderProps as f, type GenuiProviderValue as g, GenuiTree as h, useGenuiNode as i, useGenuiProvider as j, type ApprovalTarget as k, type TranscriptBlock as l, type TimestampInfo as m, type TranscriptFile as n, type ToolCatalog as o, type AnyToolUIPart as p, type ApprovalBlockOptions as q, type CoercibleQuestion as r, type GroupToolActivityOptions as s, type ResolvedReading as t, useGenerativeUI as u, type ResolvedResultView as v, type RetrievedPassage as w, type ToolActivityGroup as x, type ToolCallDescription as y, type ToolCallState as z };

package/dist/{generative-ui-CyHY8Lh1.d.cts → generative-ui-D1efzu_K.d.ts}

@@ -2,7 +2,7 @@ import * as React from 'react';
 import { ReactNode } from 'react';
 import { ActionProposalView, StoredMessage, ElicitationQuestion, ElicitationInputType, ToolPresentation, ToolCatalogEntry, ToolResultField, ToolResultView, ToolPresentationTone, ToolConfirmation, ElicitationInput } from '@dudousxd/nestjs-agent-core';
 import { UIMessage, ToolUIPart, DynamicToolUIPart } from 'ai';
-import { c as GenerativeUIOptions, G as GenerativeUIItem, d as GenerativeUIProblem, b as GenerativeUIElement, e as GenerativeUIState } from './types-DZtFsWec.cjs';
+import { c as GenerativeUIOptions, G as GenerativeUIItem, d as GenerativeUIProblem, i as GenuiPlaceholder, b as GenerativeUIElement, e as GenerativeUIState, h as GenuiNodeState } from './types-COuArD3c.js';
 
 type ApprovalTarget = {
     kind: 'legacy';
@@ -393,6 +393,11 @@ interface TranscriptUiBlock {
     componentVersions?: Record<string, number>;
     /** The tool call that pushed it (`ctx.emitUi`); `null` for a component pushed outside a tool. */
     toolCallId: string | null;
+    /**
+     * A preview drawn while the model writes the call's arguments (genui `streaming: 'partial'`):
+     * unvalidated, replaced in place by the final push. Absent on a final component.
+     */
+    partial?: true;
 }
 /** One choice a question offers, with its live selection state. */
 interface TranscriptQuestionOption {
@@ -598,6 +603,19 @@ declare function formatRelativeTime(date: Date): string;
 
 /** What to draw instead of a component that did not render. Default: nothing. */
 type GenerativeUIFallback = ReactNode | ((problem: GenerativeUIProblem) => ReactNode);
+/**
+ * The tree node being rendered — read it in a renderer to draw a skeleton while the model is still
+ * writing the node (`incomplete`), e.g. a chart's axes before its data. `null` outside a tree.
+ *
+ * ```tsx
+ * function Chart(props: ChartProps) {
+ *   const node = useGenuiNode();
+ *   if (node?.incomplete && !props.data?.length) return <ChartSkeleton title={props.title} />;
+ *   return <BarChart {...props} />;
+ * }
+ * ```
+ */
+declare function useGenuiNode(): GenuiNodeState | null;
 /**
  * Renders a `genui:tree` frame's `{ root }` node by node through the same registry, catalog and
  * resolver as top-level components. Used automatically for tree frames unless a `treeRenderer`
@@ -611,6 +629,8 @@ interface GenerativeUIScopeProps extends GenerativeUIOptions {
     componentVersions?: Record<string, number>;
     fallback?: GenerativeUIFallback;
     loading?: ReactNode;
+    /** Drawn for a tree node held back while the model writes it. Default: `loading`. */
+    placeholder?: GenuiPlaceholder;
     onError?: (error: unknown, item: GenerativeUIItem) => void;
     children?: ReactNode;
 }
@@ -618,11 +638,13 @@ interface GenerativeUIScopeProps extends GenerativeUIOptions {
  * The registry, catalog and fallbacks tree nodes render with. `<GenerativeUI>` provides it; wrap
  * your own chrome in it when you draw `useGenerativeUI`'s `Component` yourself and it may be a tree.
  */
-declare function GenerativeUIScope({ registry, catalog, resolveComponent, fallback, fallbackText, componentVersions, loading, onError, children, }: GenerativeUIScopeProps): React.JSX.Element;
+declare function GenerativeUIScope({ registry, catalog, resolveComponent, fallback, fallbackText, componentVersions, loading, placeholder, onError, children, }: GenerativeUIScopeProps): React.JSX.Element;
 /** What `<GenuiProvider>` hands every `<GenerativeUI>` / `useGenerativeUI` below it. */
 interface GenuiProviderValue extends Partial<GenerativeUIOptions> {
     fallback?: GenerativeUIFallback;
     loading?: ReactNode;
+    /** Drawn for a tree node held back while the model writes it (`streaming: 'complete'`). */
+    placeholder?: GenuiPlaceholder;
     onError?: (error: unknown, item: GenerativeUIItem) => void;
 }
 /** The enclosing `<GenuiProvider>`'s settings, or `null` outside one. */
@@ -642,7 +664,7 @@ interface GenuiProviderProps extends GenuiProviderValue {
  * </GenuiProvider>
  * ```
  */
-declare function GenuiProvider({ registry, catalog, resolveComponent, treeRenderer, fallback, loading, onError, children, }: GenuiProviderProps): React.JSX.Element;
+declare function GenuiProvider({ registry, catalog, resolveComponent, treeRenderer, fallback, loading, placeholder, onError, children, }: GenuiProviderProps): React.JSX.Element;
 /**
  * The headless half of {@link GenerativeUI}: what to draw for one pushed component, or `null` when
  * `part` is not one. Options default to the enclosing `<GenuiProvider>`'s.
@@ -655,6 +677,11 @@ interface GenerativeUIProps extends Partial<GenerativeUIOptions> {
     fallback?: GenerativeUIFallback;
     /** Drawn while a resolver or an async validation is pending. Default: the provider's, else nothing. */
     loading?: ReactNode;
+    /**
+     * Drawn for a tree node held back while the model writes it (its component streams `complete`).
+     * Default: the provider's, else `loading`.
+     */
+    placeholder?: GenuiPlaceholder;
     /** A renderer threw (the item shows `fallback`). */
     onError?: (error: unknown, item: GenerativeUIItem) => void;
 }
@@ -667,6 +694,6 @@ interface GenerativeUIProps extends Partial<GenerativeUIOptions> {
  * <GenerativeUI part={block} />
  * ```
  */
-declare function GenerativeUI({ part, registry, catalog, resolveComponent, treeRenderer, fallback: ownFallback, loading: ownLoading, onError: ownOnError, }: GenerativeUIProps): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | React.JSX.Element | null | undefined;
+declare function GenerativeUI({ part, registry, catalog, resolveComponent, treeRenderer, fallback: ownFallback, loading: ownLoading, placeholder: ownPlaceholder, onError: ownOnError, }: GenerativeUIProps): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | React.JSX.Element | null | undefined;
 
-export { correctedCallIds as $, type ApproveOptions as A, type BuildBlocksOptions as B, type ChatStatus as C, type DescribeToolCallOptions as D, type ElicitationBlockOptions as E, type TranscriptApproval as F, GenerativeUI as G, type TranscriptApprovalStatus as H, type TranscriptElicitationBlock as I, type TranscriptElicitationOutcome as J, type TranscriptFilesBlock as K, type TranscriptQuestion as L, type MessageUsageInfo as M, type TranscriptQuestionOption as N, type TranscriptReasoningBlock as O, type TranscriptSettleState as P, type TranscriptSource as Q, type RawAnswer as R, type SettleAction as S, type TranscriptUiBlock as T, type UsageSummary as U, type TranscriptSourcesBlock as V, type TranscriptTextBlock as W, type TranscriptToolBlock as X, type TranscriptToolCall as Y, buildTranscriptBlocks as Z, coerceAnswer as _, type GenerativeUIFallback as a, describeTimestamp as a0, describeToolCall as a1, describeUsage as a2, extractMessageText as a3, fillTemplate as a4, formatRelativeTime as a5, groupToolActivity as a6, inferResultView as a7, isActionCall as a8, phraseFor as a9, proposalNeedsPolling as aa, readPath as ab, reconcileProposalMessages as ac, resolveResultView as ad, toolCallState as ae, toolCatalogFrom as af, type GenerativeUIProps as b, GenerativeUIScope as c, type GenerativeUIScopeProps as d, GenuiProvider as e, type GenuiProviderProps as f, type GenuiProviderValue as g, GenuiTree as h, useGenuiProvider as i, type ApprovalTarget as j, type TranscriptBlock as k, type TimestampInfo as l, type TranscriptFile as m, type ToolCatalog as n, type AnyToolUIPart as o, type ApprovalBlockOptions as p, type CoercibleQuestion as q, type GroupToolActivityOptions as r, type ResolvedReading as s, type ResolvedResultView as t, useGenerativeUI as u, type RetrievedPassage as v, type ToolActivityGroup as w, type ToolCallDescription as x, type ToolCallState as y, type ToolCallStatus as z };
+export { coerceAnswer as $, type ApproveOptions as A, type BuildBlocksOptions as B, type ChatStatus as C, type DescribeToolCallOptions as D, type ElicitationBlockOptions as E, type ToolCallStatus as F, GenerativeUI as G, type TranscriptApproval as H, type TranscriptApprovalStatus as I, type TranscriptElicitationBlock as J, type TranscriptElicitationOutcome as K, type TranscriptFilesBlock as L, type MessageUsageInfo as M, type TranscriptQuestion as N, type TranscriptQuestionOption as O, type TranscriptReasoningBlock as P, type TranscriptSettleState as Q, type RawAnswer as R, type SettleAction as S, type TranscriptUiBlock as T, type UsageSummary as U, type TranscriptSource as V, type TranscriptSourcesBlock as W, type TranscriptTextBlock as X, type TranscriptToolBlock as Y, type TranscriptToolCall as Z, buildTranscriptBlocks as _, type GenerativeUIFallback as a, correctedCallIds as a0, describeTimestamp as a1, describeToolCall as a2, describeUsage as a3, extractMessageText as a4, fillTemplate as a5, formatRelativeTime as a6, groupToolActivity as a7, inferResultView as a8, isActionCall as a9, phraseFor as aa, proposalNeedsPolling as ab, readPath as ac, reconcileProposalMessages as ad, resolveResultView as ae, toolCallState as af, toolCatalogFrom as ag, type GenerativeUIProps as b, GenerativeUIScope as c, type GenerativeUIScopeProps as d, GenuiProvider as e, type GenuiProviderProps as f, type GenuiProviderValue as g, GenuiTree as h, useGenuiNode as i, useGenuiProvider as j, type ApprovalTarget as k, type TranscriptBlock as l, type TimestampInfo as m, type TranscriptFile as n, type ToolCatalog as o, type AnyToolUIPart as p, type ApprovalBlockOptions as q, type CoercibleQuestion as r, type GroupToolActivityOptions as s, type ResolvedReading as t, useGenerativeUI as u, type ResolvedResultView as v, type RetrievedPassage as w, type ToolActivityGroup as x, type ToolCallDescription as y, type ToolCallState as z };

package/dist/genui-json-render.cjs

@@ -71,7 +71,8 @@ function toGenerativeUIItem(part) {
     ...typeof source.fallbackText === "string" ? { fallbackText: source.fallbackText } : {},
     props: isRecord(source.props) ? source.props : {},
     version: typeof source.version === "number" ? source.version : null,
-    toolCallId: typeof source.toolCallId === "string" ? source.toolCallId : null
+    toolCallId: typeof source.toolCallId === "string" ? source.toolCallId : null,
+    ...source.partial === true ? { partial: true } : {}
   };
 }
 var resolverCaches = /* @__PURE__ */ new WeakMap();
@@ -190,6 +191,7 @@ function useGenerativeUIState(part, options, fallbackTree) {
     item?.props ?? empty
   );
   if (item === null) return null;
+  if (item.partial === true && Object.keys(item.props).length === 0) return null;
   if (name === GENUI_TREE_COMPONENT && item.fallbackText !== void 0 && (!isRecord(item.props.root) || typeof item.props.root.type !== "string"))
     return {
       status: "problem",
@@ -212,6 +214,14 @@ function useGenerativeUIState(part, options, fallbackTree) {
 // src/genui/generative-ui.tsx
 var import_jsx_runtime = require("react/jsx-runtime");
 var TreeScopeContext = (0, import_react3.createContext)(null);
+var GenuiNodeContext = sharedContext(
+  "@dudousxd/nestjs-agent-react:genui-node"
+);
+function renderPlaceholder(scope, node) {
+  const { placeholder } = scope;
+  if (typeof placeholder === "function") return placeholder(node);
+  return placeholder !== void 0 ? placeholder : scope.loading;
+}
 function renderFallback(fallback, problem) {
   if (typeof fallback === "function") return fallback(problem);
   if (fallback !== void 0) return fallback;
@@ -247,6 +257,12 @@ function nodeItem(node, id) {
 function TreeNode({ node, id }) {
   const scope = (0, import_react3.useContext)(TreeScopeContext);
   const item = (0, import_react3.useMemo)(() => nodeItem(node, id), [node, id]);
+  const incomplete = node.incomplete === true;
+  const held = node.held === true;
+  const state = (0, import_react3.useMemo)(
+    () => ({ id, type: node.type, incomplete, held }),
+    [id, node.type, incomplete, held]
+  );
   const storedVersion = scope?.componentVersions?.[node.type];
   const definition = scope?.options.catalog?.get?.(node.type);
   const incompatible = storedVersion !== void 0 && definition !== void 0 && storedVersion !== (definition.version ?? 1);
@@ -257,11 +273,14 @@ function TreeNode({ node, id }) {
     scope?.options.resolveComponent
   );
   const validation = useValidatedProps(
-    incompatible ? void 0 : scope?.options.catalog,
+    incompatible || incomplete ? void 0 : scope?.options.catalog,
     node.type,
     item.props
   );
   if (scope === null) return null;
+  if (held) {
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(GenuiNodeContext.Provider, { value: state, children: renderPlaceholder(scope, state) });
+  }
   if (resolution.status === "loading" || validation.status === "pending") return scope.loading;
   if (resolution.status === "unknown") {
     if (scope.fallback === void 0 && scope.fallbackText !== void 0)
@@ -279,7 +298,7 @@ function TreeNode({ node, id }) {
   }
   const Renderer2 = resolution.Component;
   const children = Array.isArray(node.children) ? node.children : [];
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Renderer2, { ...validation.props, children: children.length > 0 ? children.map((child, index) => {
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(GenuiNodeContext.Provider, { value: state, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Renderer2, { ...validation.props, children: children.length > 0 ? children.map((child, index) => {
     const childId = `${id}.${index}`;
     if (scope.fallback === void 0 && scope.fallbackText !== void 0)
       return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(TreeNode, { node: child, id: childId }, childId);
@@ -293,7 +312,7 @@ function TreeNode({ node, id }) {
       },
       childId
     );
-  }) : void 0 });
+  }) : void 0 }) });
 }
 function GenuiTree({ root }) {
   if (root === void 0 || root === null || typeof root.type !== "string") return null;
@@ -307,6 +326,7 @@ function GenerativeUIScope({
   fallbackText,
   componentVersions,
   loading = null,
+  placeholder,
   onError,
   children
 }) {
@@ -321,6 +341,7 @@ function GenerativeUIScope({
       ...componentVersions !== void 0 ? { componentVersions } : {},
       ...fallbackText !== void 0 ? { fallbackText } : {},
       loading,
+      placeholder,
       onError
     }),
     [
@@ -331,6 +352,7 @@ function GenerativeUIScope({
       fallbackText,
       componentVersions,
       loading,
+      placeholder,
       onError
     ]
   );
@@ -346,6 +368,7 @@ function GenuiProvider({
   treeRenderer,
   fallback,
   loading,
+  placeholder,
   onError,
   children
 }) {
@@ -357,9 +380,10 @@ function GenuiProvider({
       ...treeRenderer !== void 0 ? { treeRenderer } : {},
       ...fallback !== void 0 ? { fallback } : {},
       ...loading !== void 0 ? { loading } : {},
+      ...placeholder !== void 0 ? { placeholder } : {},
       ...onError !== void 0 ? { onError } : {}
     }),
-    [registry, catalog, resolveComponent, treeRenderer, fallback, loading, onError]
+    [registry, catalog, resolveComponent, treeRenderer, fallback, loading, placeholder, onError]
   );
   const renderUi = (0, import_react3.useCallback)((block) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(GenerativeUI, { part: block }), []);
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(GenuiContext.Provider, { value, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(AmbientRenderUiContext.Provider, { value: renderUi, children }) });
@@ -389,11 +413,13 @@ function GenerativeUI({
   treeRenderer,
   fallback: ownFallback,
   loading: ownLoading,
+  placeholder: ownPlaceholder,
   onError: ownOnError
 }) {
   const provided = (0, import_react3.useContext)(GenuiContext);
   const fallback = ownFallback !== void 0 ? ownFallback : provided?.fallback;
   const loading = ownLoading ?? provided?.loading ?? null;
+  const placeholder = ownPlaceholder !== void 0 ? ownPlaceholder : provided?.placeholder;
   const onError = ownOnError ?? provided?.onError;
   const options = useMergedOptions({
     ...registry !== void 0 ? { registry } : {},
@@ -421,6 +447,7 @@ function GenerativeUI({
       ...state.item.fallbackText !== void 0 ? { fallbackText: state.item.fallbackText } : {},
       fallback,
       loading,
+      ...placeholder !== void 0 ? { placeholder } : {},
       ...onError !== void 0 ? { onError } : {},
       children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(ItemBoundary, { item: state.item, fallback, onError, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Renderer2, { ...state.props }) })
     }
@@ -436,7 +463,8 @@ function treeToJsonRenderSpec(root) {
     const id = `el-${next++}`;
     const entry = { type: node.type, props: node.props ?? {}, children: [] };
     elements[id] = entry;
-    for (const child of node.children ?? []) entry.children.push(visit(child));
+    for (const child of node.children ?? [])
+      if (child.held !== true) entry.children.push(visit(child));
     return id;
   };
   return { root: visit(root), elements };

package/dist/genui-json-render.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/genui/json-render.tsx","../src/genui/generative-ui.tsx","../src/components/ambient-ui.ts","../src/genui/use-generative-ui.ts","../src/genui/types.ts"],"sourcesContent":["/**\n * Optional json-render adapter for tree frames (`@dudousxd/nestjs-agent-react/genui/json-render`).\n * Needs the optional peer `@json-render/react` (>= 0.21). Use it when your app already renders\n * json-render specs and wants tree frames to go through the same `Renderer` (its state, actions and\n * visibility machinery); otherwise `<GenerativeUI>` renders trees natively.\n *\n * ```tsx\n * import { GenuiProvider } from '@dudousxd/nestjs-agent-react/genui/json-render';\n *\n * <GenuiProvider registry={registry} catalog={catalog} jsonRender>…</GenuiProvider>\n * ```\n */\nimport { type ComponentRegistry, JSONUIProvider, Renderer } from '@json-render/react';\nimport { type ReactNode, useMemo } from 'react';\nimport {\n  GenuiProvider as BaseGenuiProvider,\n  type GenuiProviderProps as BaseGenuiProviderProps,\n} from './generative-ui.js';\nimport type { GenerativeUIElement, GenuiRegistry, GenuiRenderer } from './types.js';\n\n/** A json-render flat spec: `{ root, elements: { [id]: { type, props, children } } }`. */\nexport interface JsonRenderFlatSpec {\n  root: string;\n  elements: Record<string, { type: string; props: Record<string, unknown>; children: string[] }>;\n}\n\n/** A tree frame's `root` as a json-render flat spec (ids `el-0`, `el-1`, … depth first). */\nexport function treeToJsonRenderSpec(root: GenerativeUIElement): JsonRenderFlatSpec {\n  const elements: JsonRenderFlatSpec['elements'] = {};\n  let next = 0;\n  const visit = (node: GenerativeUIElement): string => {\n    const id = `el-${next++}`;\n    const entry = { type: node.type, props: node.props ?? {}, children: [] as string[] };\n    elements[id] = entry;\n    for (const child of node.children ?? []) entry.children.push(visit(child));\n    return id;\n  };\n  return { root: visit(root), elements };\n}\n\n/**\n * Adapt a genui registry (renderers taking props + `children`) to a json-render registry (renderers\n * taking `{ element, children }`), so one set of components serves both.\n */\nexport function toJsonRenderRegistry(registry: GenuiRegistry): ComponentRegistry {\n  return Object.fromEntries(\n    Object.entries(registry).map(([name, Renderer]) => [\n      name,\n      ({ element, children }: { element: { props?: unknown }; children?: ReactNode }) => (\n        <Renderer {...((element.props ?? {}) as Record<string, unknown>)}>{children}</Renderer>\n      ),\n    ]),\n  );\n}\n\nexport interface JsonRenderTreeProps {\n  root?: GenerativeUIElement;\n  registry: ComponentRegistry;\n  /** json-render state the spec's `$state` expressions read. */\n  initialState?: Record<string, unknown>;\n}\n\n/** Render a tree frame's `root` with json-render. */\nexport function JsonRenderTree({ root, registry, initialState }: JsonRenderTreeProps) {\n  const spec = useMemo(() => (root === undefined ? null : treeToJsonRenderSpec(root)), [root]);\n  if (spec === null) return null;\n  return (\n    <JSONUIProvider registry={registry} {...(initialState !== undefined ? { initialState } : {})}>\n      <Renderer spec={spec as never} registry={registry} />\n    </JSONUIProvider>\n  );\n}\n\n/** A registry entry for `genui:tree` that renders through json-render with `registry`. */\nexport function jsonRenderTree(registry: ComponentRegistry): GenuiRenderer<{\n  root?: GenerativeUIElement;\n}> {\n  return function JsonRenderTreeFrame({ root }: { root?: GenerativeUIElement }) {\n    return <JsonRenderTree registry={registry} {...(root !== undefined ? { root } : {})} />;\n  };\n}\n\nexport interface GenuiProviderProps extends BaseGenuiProviderProps {\n  /**\n   * Draw composed tree frames through json-render: pass your json-render registry, or `true` to\n   * derive one from `registry` ({@link toJsonRenderRegistry}). Omitted → trees render natively.\n   * An explicit `treeRenderer` wins over it.\n   */\n  jsonRender?: ComponentRegistry | true;\n}\n\n/** `GenuiProvider` from `/genui`, plus the {@link GenuiProviderProps.jsonRender} option. */\nexport function GenuiProvider({ jsonRender, treeRenderer, registry, ...rest }: GenuiProviderProps) {\n  const derived = useMemo(() => {\n    if (jsonRender === undefined) return undefined;\n    return jsonRenderTree(jsonRender === true ? toJsonRenderRegistry(registry ?? {}) : jsonRender);\n  }, [jsonRender, registry]);\n  const tree = treeRenderer ?? derived;\n  return (\n    <BaseGenuiProvider\n      {...rest}\n      {...(registry !== undefined ? { registry } : {})}\n      {...(tree !== undefined ? { treeRenderer: tree } : {})}\n    />\n  );\n}\n","import {\n  Component,\n  type Context,\n  type ErrorInfo,\n  type ReactNode,\n  createContext,\n  useCallback,\n  useContext,\n  useMemo,\n} from 'react';\nimport { AmbientRenderUiContext, sharedContext } from '../components/ambient-ui.js';\nimport type { TranscriptUiBlock } from '../transcript/model.js';\nimport type {\n  GenerativeUIElement,\n  GenerativeUIItem,\n  GenerativeUIOptions,\n  GenerativeUIProblem,\n  GenerativeUIState,\n  GenuiRegistry,\n  GenuiRenderer,\n} from './types.js';\nimport {\n  useGenerativeUIState,\n  useResolvedComponent,\n  useValidatedProps,\n} from './use-generative-ui.js';\n\n/** What to draw instead of a component that did not render. Default: nothing. */\nexport type GenerativeUIFallback = ReactNode | ((problem: GenerativeUIProblem) => ReactNode);\n\ninterface TreeScope {\n  fallbackText?: string;\n  componentVersions?: Record<string, number>;\n  options: GenerativeUIOptions;\n  fallback: GenerativeUIFallback | undefined;\n  loading: ReactNode;\n  onError: ((error: unknown, item: GenerativeUIItem) => void) | undefined;\n}\n\nconst TreeScopeContext = createContext<TreeScope | null>(null);\n\nfunction renderFallback(fallback: GenerativeUIFallback | undefined, problem: GenerativeUIProblem) {\n  if (typeof fallback === 'function') return fallback(problem);\n  if (fallback !== undefined) return fallback;\n  return problem.item.fallbackText !== undefined ? (\n    <span style={{ whiteSpace: 'pre-wrap' }}>{problem.item.fallbackText}</span>\n  ) : null;\n}\n\ninterface BoundaryProps {\n  item: GenerativeUIItem;\n  fallback: GenerativeUIFallback | undefined;\n  onError: ((error: unknown, item: GenerativeUIItem) => void) | undefined;\n  children: ReactNode;\n}\n\n/** One failing renderer takes down its own item, never the message around it. */\nclass ItemBoundary extends Component<BoundaryProps, { error: unknown; failed: boolean }> {\n  override state = { error: undefined as unknown, failed: false };\n\n  static getDerivedStateFromError(error: unknown) {\n    return { error, failed: true };\n  }\n\n  override componentDidCatch(error: unknown, _info: ErrorInfo) {\n    this.props.onError?.(error, this.props.item);\n  }\n\n  override componentDidUpdate(previous: BoundaryProps) {\n    // New props for the same item (a streamed update) get a fresh chance to render.\n    if (this.state.failed && previous.item !== this.props.item) {\n      this.setState({ error: undefined, failed: false });\n    }\n  }\n\n  override render() {\n    if (this.state.failed) {\n      return renderFallback(this.props.fallback, {\n        reason: 'error',\n        item: this.props.item,\n        error: this.state.error,\n      });\n    }\n    return this.props.children;\n  }\n}\n\nfunction nodeItem(node: GenerativeUIElement, id: string): GenerativeUIItem {\n  return { id, component: node.type, props: node.props ?? {}, version: null, toolCallId: null };\n}\n\n/** One tree node: resolved and validated like a top-level item, children rendered as its `children`. */\nfunction TreeNode({ node, id }: { node: GenerativeUIElement; id: string }) {\n  const scope = useContext(TreeScopeContext);\n  const item = useMemo(() => nodeItem(node, id), [node, id]);\n  const storedVersion = scope?.componentVersions?.[node.type];\n  const definition = scope?.options.catalog?.get?.(node.type);\n  const incompatible =\n    storedVersion !== undefined &&\n    definition !== undefined &&\n    storedVersion !== (definition.version ?? 1);\n  const resolution = useResolvedComponent(\n    node.type,\n    storedVersion ?? null,\n    incompatible ? {} : (scope?.options.registry ?? {}),\n    scope?.options.resolveComponent,\n  );\n  const validation = useValidatedProps(\n    incompatible ? undefined : scope?.options.catalog,\n    node.type,\n    item.props,\n  );\n  if (scope === null) return null;\n  if (resolution.status === 'loading' || validation.status === 'pending') return scope.loading;\n  if (resolution.status === 'unknown') {\n    if (scope.fallback === undefined && scope.fallbackText !== undefined)\n      throw new Error('Unknown tree component');\n    return renderFallback(scope.fallback, { reason: 'unknown', item });\n  }\n  if (resolution.status === 'error') {\n    if (scope.fallback === undefined && scope.fallbackText !== undefined) throw resolution.error;\n    return renderFallback(scope.fallback, { reason: 'error', item, error: resolution.error });\n  }\n  if (validation.status === 'invalid') {\n    if (scope.fallback === undefined && scope.fallbackText !== undefined)\n      throw new Error('Invalid tree component');\n    return renderFallback(scope.fallback, { reason: 'invalid', item, issues: validation.issues });\n  }\n  const Renderer = resolution.Component;\n  const children = Array.isArray(node.children) ? node.children : [];\n  return (\n    <Renderer {...validation.props}>\n      {children.length > 0\n        ? children.map((child, index) => {\n            const childId = `${id}.${index}`;\n            if (scope.fallback === undefined && scope.fallbackText !== undefined)\n              return <TreeNode key={childId} node={child} id={childId} />;\n            return (\n              <ItemBoundary\n                key={childId}\n                item={nodeItem(child, childId)}\n                fallback={scope.fallback}\n                onError={scope.onError}\n              >\n                <TreeNode node={child} id={childId} />\n              </ItemBoundary>\n            );\n          })\n        : undefined}\n    </Renderer>\n  );\n}\n\n/**\n * Renders a `genui:tree` frame's `{ root }` node by node through the same registry, catalog and\n * resolver as top-level components. Used automatically for tree frames unless a `treeRenderer`\n * (e.g. the json-render one) or a registry entry for `genui:tree` takes over.\n */\nexport function GenuiTree({ root }: { root?: GenerativeUIElement }) {\n  if (root === undefined || root === null || typeof root.type !== 'string') return null;\n  return <TreeNode node={root} id=\"root\" />;\n}\n\nexport interface GenerativeUIScopeProps extends GenerativeUIOptions {\n  fallbackText?: string;\n  componentVersions?: Record<string, number>;\n  fallback?: GenerativeUIFallback;\n  loading?: ReactNode;\n  onError?: (error: unknown, item: GenerativeUIItem) => void;\n  children?: ReactNode;\n}\n\n/**\n * The registry, catalog and fallbacks tree nodes render with. `<GenerativeUI>` provides it; wrap\n * your own chrome in it when you draw `useGenerativeUI`'s `Component` yourself and it may be a tree.\n */\nexport function GenerativeUIScope({\n  registry,\n  catalog,\n  resolveComponent,\n  fallback,\n  fallbackText,\n  componentVersions,\n  loading = null,\n  onError,\n  children,\n}: GenerativeUIScopeProps) {\n  const scope = useMemo<TreeScope>(\n    () => ({\n      options: {\n        registry,\n        ...(catalog !== undefined ? { catalog } : {}),\n        ...(resolveComponent !== undefined ? { resolveComponent } : {}),\n      },\n      fallback,\n      ...(componentVersions !== undefined ? { componentVersions } : {}),\n      ...(fallbackText !== undefined ? { fallbackText } : {}),\n      loading,\n      onError,\n    }),\n    [\n      registry,\n      catalog,\n      resolveComponent,\n      fallback,\n      fallbackText,\n      componentVersions,\n      loading,\n      onError,\n    ],\n  );\n  return <TreeScopeContext.Provider value={scope}>{children}</TreeScopeContext.Provider>;\n}\n\n/** What `<GenuiProvider>` hands every `<GenerativeUI>` / `useGenerativeUI` below it. */\nexport interface GenuiProviderValue extends Partial<GenerativeUIOptions> {\n  fallback?: GenerativeUIFallback;\n  loading?: ReactNode;\n  onError?: (error: unknown, item: GenerativeUIItem) => void;\n}\n\n// Shared by key: `/genui` and `/genui/json-render` are separate bundles, and a provider from one\n// must reach a `<GenerativeUI>` from the other.\nconst GenuiContext: Context<GenuiProviderValue | null> = sharedContext<GenuiProviderValue>(\n  '@dudousxd/nestjs-agent-react:genui-provider',\n);\n\n/** The enclosing `<GenuiProvider>`'s settings, or `null` outside one. */\nexport function useGenuiProvider(): GenuiProviderValue | null {\n  return useContext(GenuiContext);\n}\n\nexport interface GenuiProviderProps extends GenuiProviderValue {\n  children?: ReactNode;\n}\n\n/**\n * Set generative UI up once, at the app root: the registry of your renderers, the catalog to\n * validate against, a resolver for components the registry lacks, and what to draw when one does\n * not render. Every `<GenerativeUI>` below reads it (its own props still win), and `MessageItem` /\n * `MessageList` draw pushed components with it — no `renderUi` per message.\n *\n * ```tsx\n * <GenuiProvider registry={registry} catalog={catalog} fallback={({ item }) => <Unknown name={item.component} />}>\n *   <App />\n * </GenuiProvider>\n * ```\n */\nexport function GenuiProvider({\n  registry,\n  catalog,\n  resolveComponent,\n  treeRenderer,\n  fallback,\n  loading,\n  onError,\n  children,\n}: GenuiProviderProps) {\n  const value = useMemo<GenuiProviderValue>(\n    () => ({\n      ...(registry !== undefined ? { registry } : {}),\n      ...(catalog !== undefined ? { catalog } : {}),\n      ...(resolveComponent !== undefined ? { resolveComponent } : {}),\n      ...(treeRenderer !== undefined ? { treeRenderer } : {}),\n      ...(fallback !== undefined ? { fallback } : {}),\n      ...(loading !== undefined ? { loading } : {}),\n      ...(onError !== undefined ? { onError } : {}),\n    }),\n    [registry, catalog, resolveComponent, treeRenderer, fallback, loading, onError],\n  );\n  const renderUi = useCallback((block: TranscriptUiBlock) => <GenerativeUI part={block} />, []);\n  return (\n    <GenuiContext.Provider value={value}>\n      <AmbientRenderUiContext.Provider value={renderUi}>{children}</AmbientRenderUiContext.Provider>\n    </GenuiContext.Provider>\n  );\n}\n\nconst NO_REGISTRY: GenuiRegistry = {};\n\n/** Provider settings overlaid with explicit ones (explicit wins), memoized on their parts. */\nfunction useMergedOptions(own: Partial<GenerativeUIOptions>): GenerativeUIOptions {\n  const provided = useContext(GenuiContext);\n  const registry = own.registry ?? provided?.registry ?? NO_REGISTRY;\n  const catalog = own.catalog ?? provided?.catalog;\n  const resolveComponent = own.resolveComponent ?? provided?.resolveComponent;\n  const treeRenderer = own.treeRenderer ?? provided?.treeRenderer;\n  return useMemo(\n    () => ({\n      registry,\n      ...(catalog !== undefined ? { catalog } : {}),\n      ...(resolveComponent !== undefined ? { resolveComponent } : {}),\n      ...(treeRenderer !== undefined ? { treeRenderer } : {}),\n    }),\n    [registry, catalog, resolveComponent, treeRenderer],\n  );\n}\n\n/**\n * The headless half of {@link GenerativeUI}: what to draw for one pushed component, or `null` when\n * `part` is not one. Options default to the enclosing `<GenuiProvider>`'s.\n */\nexport function useGenerativeUI(\n  part: unknown,\n  options: Partial<GenerativeUIOptions> = {},\n): GenerativeUIState | null {\n  const merged = useMergedOptions(options);\n  return useGenerativeUIState(part, merged, merged.treeRenderer ?? (GenuiTree as GenuiRenderer));\n}\n\nexport interface GenerativeUIProps extends Partial<GenerativeUIOptions> {\n  /** A transcript `ui` block, a `data-ui` message part, or a stored `{ id, component, props, version? }`. */\n  part: TranscriptUiBlock | GenerativeUIItem | unknown;\n  /** Drawn for an unknown component, invalid props, or a renderer that threw. Default: the provider's, then the item's persisted text. */\n  fallback?: GenerativeUIFallback;\n  /** Drawn while a resolver or an async validation is pending. Default: the provider's, else nothing. */\n  loading?: ReactNode;\n  /** A renderer threw (the item shows `fallback`). */\n  onError?: (error: unknown, item: GenerativeUIItem) => void;\n}\n\n/**\n * Draws one server-pushed component with the app's own renderer. Headless: it adds no element and\n * no style of its own — only what the registry's component renders (and whatever `fallback` /\n * `loading` you pass). Everything but `part` defaults to the enclosing `<GenuiProvider>`.\n *\n * ```tsx\n * <GenerativeUI part={block} />\n * ```\n */\nexport function GenerativeUI({\n  part,\n  registry,\n  catalog,\n  resolveComponent,\n  treeRenderer,\n  fallback: ownFallback,\n  loading: ownLoading,\n  onError: ownOnError,\n}: GenerativeUIProps) {\n  const provided = useContext(GenuiContext);\n  const fallback = ownFallback !== undefined ? ownFallback : provided?.fallback;\n  const loading = ownLoading ?? provided?.loading ?? null;\n  const onError = ownOnError ?? provided?.onError;\n  const options = useMergedOptions({\n    ...(registry !== undefined ? { registry } : {}),\n    ...(catalog !== undefined ? { catalog } : {}),\n    ...(resolveComponent !== undefined ? { resolveComponent } : {}),\n    ...(treeRenderer !== undefined ? { treeRenderer } : {}),\n  });\n  const state = useGenerativeUIState(\n    part,\n    options,\n    options.treeRenderer ?? (GenuiTree as GenuiRenderer),\n  );\n  if (state === null) return null;\n  if (state.status === 'loading') return loading;\n  if (state.status === 'problem') {\n    const { status: _status, ...problem } = state;\n    return renderFallback(fallback, problem);\n  }\n  const Renderer = state.Component;\n  return (\n    <GenerativeUIScope\n      {...options}\n      {...(state.item.componentVersions !== undefined\n        ? { componentVersions: state.item.componentVersions }\n        : {})}\n      {...(state.item.fallbackText !== undefined ? { fallbackText: state.item.fallbackText } : {})}\n      fallback={fallback}\n      loading={loading}\n      {...(onError !== undefined ? { onError } : {})}\n    >\n      <ItemBoundary item={state.item} fallback={fallback} onError={onError}>\n        <Renderer {...state.props} />\n      </ItemBoundary>\n    </GenerativeUIScope>\n  );\n}\n","import { type Context, type ReactNode, createContext, useContext } from 'react';\nimport type { TranscriptUiBlock } from '../transcript/model.js';\n\n/** Draws a server-pushed component block. */\nexport type AmbientRenderUi = (block: TranscriptUiBlock) => ReactNode;\n\n/**\n * A context stored on `globalThis` under a registered symbol. Each entry point (`.`, `/genui`,\n * `/genui/json-render`) is its own bundle with its own copy of every module, so a context one entry\n * provides and another reads has to be found by key, not by module identity.\n */\nexport function sharedContext<T>(key: string): Context<T | null> {\n  const symbol = Symbol.for(key);\n  const holder = globalThis as Record<symbol, Context<T | null> | undefined>;\n  const existing = holder[symbol];\n  if (existing !== undefined) return existing;\n  const created = createContext<T | null>(null);\n  holder[symbol] = created;\n  return created;\n}\n\n/**\n * How pushed components are drawn when no `renderUi` is passed — set by `<GenuiProvider>` (the\n * `/genui` subpath) and read by `MessageItem`.\n */\nexport const AmbientRenderUiContext: Context<AmbientRenderUi | null> =\n  sharedContext<AmbientRenderUi>('@dudousxd/nestjs-agent-react:ambient-render-ui');\n\n/**\n * The renderer `<GenuiProvider>` installed for pushed components, or `null` outside one. For a\n * custom transcript built on `useTranscriptItem`: draw a `ui` block with it and you get what\n * `MessageItem` draws.\n */\nexport function useAmbientRenderUi(): AmbientRenderUi | null {\n  return useContext(AmbientRenderUiContext);\n}\n","import { useEffect, useMemo, useState } from 'react';\nimport {\n  GENUI_TREE_COMPONENT,\n  type GenerativeUIItem,\n  type GenerativeUIOptions,\n  type GenerativeUIState,\n  type GenuiCatalogLike,\n  type GenuiIssueLike,\n  type GenuiRegistry,\n  type GenuiRenderer,\n  type ResolveComponent,\n} from './types.js';\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/**\n * Normalize whatever carries a pushed component: a transcript `ui` block, a `data-ui` message part\n * (`{ type: 'data-ui', id, data }`), a stored `{ id, component, props, version? }` entry. `null` for\n * anything else.\n */\nexport function toGenerativeUIItem(part: unknown): GenerativeUIItem | null {\n  if (!isRecord(part)) return null;\n  const source = part.type === 'data-ui' && isRecord(part.data) ? part.data : part;\n  if (typeof source.component !== 'string') return null;\n  const id =\n    typeof source.id === 'string' ? source.id : typeof part.id === 'string' ? part.id : null;\n  if (id === null) return null;\n  return {\n    id,\n    component: source.component,\n    ...(isRecord(source.componentVersions) &&\n    Object.values(source.componentVersions).every(\n      (version) => typeof version === 'number' && Number.isSafeInteger(version) && version > 0,\n    )\n      ? { componentVersions: { ...source.componentVersions } as Record<string, number> }\n      : {}),\n    ...(typeof source.fallbackText === 'string' ? { fallbackText: source.fallbackText } : {}),\n    props: isRecord(source.props) ? source.props : {},\n    version: typeof source.version === 'number' ? source.version : null,\n    toolCallId: typeof source.toolCallId === 'string' ? source.toolCallId : null,\n  };\n}\n\ntype Resolution =\n  | { status: 'ready'; Component: GenuiRenderer }\n  | { status: 'loading' }\n  | { status: 'unknown' }\n  | { status: 'error'; error: unknown };\n\ninterface CacheEntry {\n  resolution: Resolution;\n  settled: Promise<void> | null;\n}\n\nconst resolverCaches = new WeakMap<ResolveComponent, Map<string, CacheEntry>>();\n\nfunction resolveCached(\n  resolve: ResolveComponent,\n  name: string,\n  version: number | null,\n): CacheEntry {\n  let cache = resolverCaches.get(resolve);\n  if (cache === undefined) {\n    cache = new Map();\n    resolverCaches.set(resolve, cache);\n  }\n  const key = `${name}@${version ?? ''}`;\n  const hit = cache.get(key);\n  if (hit !== undefined) return hit;\n  let entry: CacheEntry;\n  try {\n    const result = resolve(name, version);\n    if (result instanceof Promise) {\n      entry = { resolution: { status: 'loading' }, settled: null };\n      entry.settled = result.then(\n        (Component) => {\n          entry.resolution = Component ? { status: 'ready', Component } : { status: 'unknown' };\n        },\n        (error: unknown) => {\n          entry.resolution = { status: 'error', error };\n        },\n      );\n    } else {\n      entry = {\n        resolution: result ? { status: 'ready', Component: result } : { status: 'unknown' },\n        settled: null,\n      };\n    }\n  } catch (error) {\n    entry = { resolution: { status: 'error', error }, settled: null };\n  }\n  cache.set(key, entry);\n  return entry;\n}\n\n/**\n * Which renderer draws `name`: the registry first, then `resolveComponent` (cached; async results\n * re-render the caller when they land). `fallbackTree` answers the tree component when the\n * registry does not override it.\n */\nexport function useResolvedComponent(\n  name: string,\n  version: number | null,\n  registry: GenuiRegistry,\n  resolve: ResolveComponent | undefined,\n  fallbackTree?: GenuiRenderer,\n): Resolution {\n  const [, setTick] = useState(0);\n  const own = registry[name];\n  const entry =\n    own !== undefined || resolve === undefined ? null : resolveCached(resolve, name, version);\n  const pending = entry?.resolution.status === 'loading' ? entry.settled : null;\n  useEffect(() => {\n    if (pending === null) return;\n    let live = true;\n    void pending.then(() => {\n      if (live) setTick((tick) => tick + 1);\n    });\n    return () => {\n      live = false;\n    };\n  }, [pending]);\n  if (own !== undefined) return { status: 'ready', Component: own };\n  if (entry !== null && entry.resolution.status !== 'unknown') return entry.resolution;\n  if (name === GENUI_TREE_COMPONENT && fallbackTree !== undefined) {\n    return { status: 'ready', Component: fallbackTree };\n  }\n  return { status: 'unknown' };\n}\n\ntype Validation =\n  | { status: 'ok'; props: Record<string, unknown> }\n  | { status: 'pending' }\n  | { status: 'invalid'; issues: GenuiIssueLike[] };\n\n/**\n * Props checked against the catalog: synchronously when the catalog can (`validateSync`), else\n * after the async check settles. A component the catalog does not know passes through unchecked.\n */\nexport function useValidatedProps(\n  catalog: GenuiCatalogLike | undefined,\n  name: string,\n  props: Record<string, unknown>,\n): Validation {\n  const checked = catalog?.has(name) === true;\n  const immediate = useMemo<Validation | null>(() => {\n    if (!checked || catalog === undefined) return { status: 'ok', props };\n    const result = catalog.validateSync?.(name, props);\n    if (result === undefined) return null;\n    return result.ok\n      ? { status: 'ok', props: result.value }\n      : { status: 'invalid', issues: result.issues };\n  }, [checked, catalog, name, props]);\n  const [late, setLate] = useState<{ props: Record<string, unknown>; result: Validation } | null>(\n    null,\n  );\n  useEffect(() => {\n    if (immediate !== null || catalog === undefined) return;\n    let live = true;\n    catalog.validate(name, props).then(\n      (result) => {\n        if (!live) return;\n        setLate({\n          props,\n          result: result.ok\n            ? { status: 'ok', props: result.value }\n            : { status: 'invalid', issues: result.issues },\n        });\n      },\n      (error: unknown) => {\n        if (!live) return;\n        setLate({\n          props,\n          result: {\n            status: 'invalid',\n            issues: [{ path: [], message: error instanceof Error ? error.message : String(error) }],\n          },\n        });\n      },\n    );\n    return () => {\n      live = false;\n    };\n  }, [immediate, catalog, name, props]);\n  if (immediate !== null) return immediate;\n  return late !== null && late.props === props ? late.result : { status: 'pending' };\n}\n\n/** {@link import('./generative-ui.js').useGenerativeUI}, with the tree renderer handed in (avoids an import cycle). */\nexport function useGenerativeUIState(\n  part: unknown,\n  options: GenerativeUIOptions,\n  fallbackTree: GenuiRenderer | undefined,\n): GenerativeUIState | null {\n  const item = useMemo(() => toGenerativeUIItem(part), [part]);\n  const name = item?.component ?? '';\n  const definition = options.catalog?.get?.(name);\n  const incompatible =\n    item?.fallbackText !== undefined &&\n    item.version !== null &&\n    definition !== undefined &&\n    item.version !== (definition.version ?? 1);\n  const resolution = useResolvedComponent(\n    name,\n    item?.version ?? null,\n    incompatible ? {} : options.registry,\n    item === null ? undefined : options.resolveComponent,\n    fallbackTree,\n  );\n  const empty = useMemo<Record<string, unknown>>(() => ({}), []);\n  // A tree is validated node by node as it renders, not as one component.\n  const validation = useValidatedProps(\n    item === null || name === GENUI_TREE_COMPONENT || incompatible ? undefined : options.catalog,\n    name,\n    item?.props ?? empty,\n  );\n  if (item === null) return null;\n  if (\n    name === GENUI_TREE_COMPONENT &&\n    item.fallbackText !== undefined &&\n    (!isRecord(item.props.root) || typeof item.props.root.type !== 'string')\n  )\n    return {\n      status: 'problem',\n      reason: 'invalid',\n      item,\n      issues: [{ path: ['root'], message: 'Invalid UI tree root' }],\n    };\n  if (resolution.status === 'loading') return { status: 'loading', item };\n  if (resolution.status === 'unknown') return { status: 'problem', reason: 'unknown', item };\n  if (resolution.status === 'error') {\n    return { status: 'problem', reason: 'error', item, error: resolution.error };\n  }\n  if (validation.status === 'pending') return { status: 'loading', item };\n  if (validation.status === 'invalid') {\n    return { status: 'problem', reason: 'invalid', item, issues: validation.issues };\n  }\n  return { status: 'ready', item, Component: resolution.Component, props: validation.props };\n}\n","import type { ComponentType, ReactNode } from 'react';\n\n/** The `ui` frame component a composed tree is pushed under (`GENUI_TREE_COMPONENT` of `@dudousxd/nestjs-agent-core/genui`). */\nexport const GENUI_TREE_COMPONENT = 'genui:tree';\n\n/** One pushed component, normalized from whatever carried it (a transcript block, a `data-ui` part, a stored entry). */\nexport interface GenerativeUIItem {\n  fallbackText?: string;\n  componentVersions?: Record<string, number>;\n  id: string;\n  component: string;\n  props: Record<string, unknown>;\n  version: number | null;\n  toolCallId: string | null;\n}\n\n/** A node of a composed tree (`genui:tree` frames): `{ type, props, children? }`. */\nexport interface GenerativeUIElement {\n  type: string;\n  props: Record<string, unknown>;\n  children?: GenerativeUIElement[];\n}\n\n/**\n * An app's renderer for one component: it receives the component's props spread, plus `children`\n * when it is a layout node in a tree. Any React component — the library never styles anything.\n */\nexport type GenuiRenderer<P = any> = ComponentType<P & { children?: ReactNode }>;\n\n/** Component name → the app's renderer. */\nexport type GenuiRegistry = Record<string, GenuiRenderer>;\n\n/**\n * Resolve a component the registry does not have — typically a tenant's own component, fetched for\n * the exact `version` a message was rendered with. Return `null`/`undefined` for \"no such\n * component\". May be async; results are cached per resolver, name and version.\n */\nexport type ResolveComponent = (\n  name: string,\n  version: number | null,\n) => GenuiRenderer | null | undefined | Promise<GenuiRenderer | null | undefined>;\n\nexport interface GenuiIssueLike {\n  path: (string | number)[];\n  message: string;\n}\n\ntype ValidationLike =\n  | { ok: true; value: Record<string, unknown> }\n  | { ok: false; issues: GenuiIssueLike[] };\n\n/**\n * What the renderer needs from a catalog to validate props before drawing them. A `Catalog` from\n * `@dudousxd/nestjs-agent-core/genui` satisfies it; declared structurally so any catalog-shaped\n * object does too.\n */\nexport interface GenuiCatalogLike {\n  get?(name: string): { version?: number } | undefined;\n  has(name: string): boolean;\n  validate(name: string, props: unknown): Promise<ValidationLike>;\n  validateSync?(name: string, props: unknown): ValidationLike | undefined;\n}\n\nexport interface GenerativeUIOptions {\n  registry: GenuiRegistry;\n  /** Validate props against it before rendering. Components the catalog does not know render unvalidated. */\n  catalog?: GenuiCatalogLike;\n  resolveComponent?: ResolveComponent;\n  /**\n   * Draws a composed tree frame (`genui:tree`) whole — e.g. through json-render (see the\n   * `/genui/json-render` subpath's `GenuiProvider`). Omitted → trees render node by node through\n   * `registry`.\n   */\n  treeRenderer?: GenuiRenderer<{ root?: GenerativeUIElement }>;\n}\n\n/** Why an item did not render. */\nexport type GenerativeUIProblem =\n  | { reason: 'unknown'; item: GenerativeUIItem }\n  | { reason: 'invalid'; item: GenerativeUIItem; issues: GenuiIssueLike[] }\n  | { reason: 'error'; item: GenerativeUIItem; error: unknown };\n\nexport type GenerativeUIState =\n  | {\n      status: 'ready';\n      item: GenerativeUIItem;\n      Component: GenuiRenderer;\n      props: Record<string, unknown>;\n    }\n  | { status: 'loading'; item: GenerativeUIItem }\n  | ({ status: 'problem' } & GenerativeUIProblem);\n"],"mappings":"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","names":["GenuiProvider","import_react","import_react","import_react","Component","Renderer","Renderer","import_jsx_runtime","Renderer","GenuiProvider"]}
+{"version":3,"sources":["../src/genui/json-render.tsx","../src/genui/generative-ui.tsx","../src/components/ambient-ui.ts","../src/genui/use-generative-ui.ts","../src/genui/types.ts"],"sourcesContent":["/**\n * Optional json-render adapter for tree frames (`@dudousxd/nestjs-agent-react/genui/json-render`).\n * Needs the optional peer `@json-render/react` (>= 0.21). Use it when your app already renders\n * json-render specs and wants tree frames to go through the same `Renderer` (its state, actions and\n * visibility machinery); otherwise `<GenerativeUI>` renders trees natively.\n *\n * ```tsx\n * import { GenuiProvider } from '@dudousxd/nestjs-agent-react/genui/json-render';\n *\n * <GenuiProvider registry={registry} catalog={catalog} jsonRender>…</GenuiProvider>\n * ```\n */\nimport { type ComponentRegistry, JSONUIProvider, Renderer } from '@json-render/react';\nimport { type ReactNode, useMemo } from 'react';\nimport {\n  GenuiProvider as BaseGenuiProvider,\n  type GenuiProviderProps as BaseGenuiProviderProps,\n} from './generative-ui.js';\nimport type { GenerativeUIElement, GenuiRegistry, GenuiRenderer } from './types.js';\n\n/** A json-render flat spec: `{ root, elements: { [id]: { type, props, children } } }`. */\nexport interface JsonRenderFlatSpec {\n  root: string;\n  elements: Record<string, { type: string; props: Record<string, unknown>; children: string[] }>;\n}\n\n/** A tree frame's `root` as a json-render flat spec (ids `el-0`, `el-1`, … depth first). */\nexport function treeToJsonRenderSpec(root: GenerativeUIElement): JsonRenderFlatSpec {\n  const elements: JsonRenderFlatSpec['elements'] = {};\n  let next = 0;\n  const visit = (node: GenerativeUIElement): string => {\n    const id = `el-${next++}`;\n    const entry = { type: node.type, props: node.props ?? {}, children: [] as string[] };\n    elements[id] = entry;\n    // A node held back while the model writes it (`streaming: 'complete'`) has no props to draw yet.\n    for (const child of node.children ?? [])\n      if (child.held !== true) entry.children.push(visit(child));\n    return id;\n  };\n  return { root: visit(root), elements };\n}\n\n/**\n * Adapt a genui registry (renderers taking props + `children`) to a json-render registry (renderers\n * taking `{ element, children }`), so one set of components serves both.\n */\nexport function toJsonRenderRegistry(registry: GenuiRegistry): ComponentRegistry {\n  return Object.fromEntries(\n    Object.entries(registry).map(([name, Renderer]) => [\n      name,\n      ({ element, children }: { element: { props?: unknown }; children?: ReactNode }) => (\n        <Renderer {...((element.props ?? {}) as Record<string, unknown>)}>{children}</Renderer>\n      ),\n    ]),\n  );\n}\n\nexport interface JsonRenderTreeProps {\n  root?: GenerativeUIElement;\n  registry: ComponentRegistry;\n  /** json-render state the spec's `$state` expressions read. */\n  initialState?: Record<string, unknown>;\n}\n\n/** Render a tree frame's `root` with json-render. */\nexport function JsonRenderTree({ root, registry, initialState }: JsonRenderTreeProps) {\n  const spec = useMemo(() => (root === undefined ? null : treeToJsonRenderSpec(root)), [root]);\n  if (spec === null) return null;\n  return (\n    <JSONUIProvider registry={registry} {...(initialState !== undefined ? { initialState } : {})}>\n      <Renderer spec={spec as never} registry={registry} />\n    </JSONUIProvider>\n  );\n}\n\n/** A registry entry for `genui:tree` that renders through json-render with `registry`. */\nexport function jsonRenderTree(registry: ComponentRegistry): GenuiRenderer<{\n  root?: GenerativeUIElement;\n}> {\n  return function JsonRenderTreeFrame({ root }: { root?: GenerativeUIElement }) {\n    return <JsonRenderTree registry={registry} {...(root !== undefined ? { root } : {})} />;\n  };\n}\n\nexport interface GenuiProviderProps extends BaseGenuiProviderProps {\n  /**\n   * Draw composed tree frames through json-render: pass your json-render registry, or `true` to\n   * derive one from `registry` ({@link toJsonRenderRegistry}). Omitted → trees render natively.\n   * An explicit `treeRenderer` wins over it.\n   */\n  jsonRender?: ComponentRegistry | true;\n}\n\n/** `GenuiProvider` from `/genui`, plus the {@link GenuiProviderProps.jsonRender} option. */\nexport function GenuiProvider({ jsonRender, treeRenderer, registry, ...rest }: GenuiProviderProps) {\n  const derived = useMemo(() => {\n    if (jsonRender === undefined) return undefined;\n    return jsonRenderTree(jsonRender === true ? toJsonRenderRegistry(registry ?? {}) : jsonRender);\n  }, [jsonRender, registry]);\n  const tree = treeRenderer ?? derived;\n  return (\n    <BaseGenuiProvider\n      {...rest}\n      {...(registry !== undefined ? { registry } : {})}\n      {...(tree !== undefined ? { treeRenderer: tree } : {})}\n    />\n  );\n}\n","import {\n  Component,\n  type Context,\n  type ErrorInfo,\n  type ReactNode,\n  createContext,\n  useCallback,\n  useContext,\n  useMemo,\n} from 'react';\nimport { AmbientRenderUiContext, sharedContext } from '../components/ambient-ui.js';\nimport type { TranscriptUiBlock } from '../transcript/model.js';\nimport type {\n  GenerativeUIElement,\n  GenerativeUIItem,\n  GenerativeUIOptions,\n  GenerativeUIProblem,\n  GenerativeUIState,\n  GenuiNodeState,\n  GenuiPlaceholder,\n  GenuiRegistry,\n  GenuiRenderer,\n} from './types.js';\nimport {\n  useGenerativeUIState,\n  useResolvedComponent,\n  useValidatedProps,\n} from './use-generative-ui.js';\n\n/** What to draw instead of a component that did not render. Default: nothing. */\nexport type GenerativeUIFallback = ReactNode | ((problem: GenerativeUIProblem) => ReactNode);\n\ninterface TreeScope {\n  fallbackText?: string;\n  componentVersions?: Record<string, number>;\n  options: GenerativeUIOptions;\n  fallback: GenerativeUIFallback | undefined;\n  loading: ReactNode;\n  placeholder: GenuiPlaceholder | undefined;\n  onError: ((error: unknown, item: GenerativeUIItem) => void) | undefined;\n}\n\nconst TreeScopeContext = createContext<TreeScope | null>(null);\n\n// Shared by key, like the provider's: a renderer imports the hook from `/genui` while the tree may\n// be drawn by the `/genui/json-render` bundle's copy of this module.\nconst GenuiNodeContext: Context<GenuiNodeState | null> = sharedContext<GenuiNodeState>(\n  '@dudousxd/nestjs-agent-react:genui-node',\n);\n\n/**\n * The tree node being rendered — read it in a renderer to draw a skeleton while the model is still\n * writing the node (`incomplete`), e.g. a chart's axes before its data. `null` outside a tree.\n *\n * ```tsx\n * function Chart(props: ChartProps) {\n *   const node = useGenuiNode();\n *   if (node?.incomplete && !props.data?.length) return <ChartSkeleton title={props.title} />;\n *   return <BarChart {...props} />;\n * }\n * ```\n */\nexport function useGenuiNode(): GenuiNodeState | null {\n  return useContext(GenuiNodeContext);\n}\n\nfunction renderPlaceholder(scope: TreeScope, node: GenuiNodeState): ReactNode {\n  const { placeholder } = scope;\n  if (typeof placeholder === 'function') return placeholder(node);\n  return placeholder !== undefined ? placeholder : scope.loading;\n}\n\nfunction renderFallback(fallback: GenerativeUIFallback | undefined, problem: GenerativeUIProblem) {\n  if (typeof fallback === 'function') return fallback(problem);\n  if (fallback !== undefined) return fallback;\n  return problem.item.fallbackText !== undefined ? (\n    <span style={{ whiteSpace: 'pre-wrap' }}>{problem.item.fallbackText}</span>\n  ) : null;\n}\n\ninterface BoundaryProps {\n  item: GenerativeUIItem;\n  fallback: GenerativeUIFallback | undefined;\n  onError: ((error: unknown, item: GenerativeUIItem) => void) | undefined;\n  children: ReactNode;\n}\n\n/** One failing renderer takes down its own item, never the message around it. */\nclass ItemBoundary extends Component<BoundaryProps, { error: unknown; failed: boolean }> {\n  override state = { error: undefined as unknown, failed: false };\n\n  static getDerivedStateFromError(error: unknown) {\n    return { error, failed: true };\n  }\n\n  override componentDidCatch(error: unknown, _info: ErrorInfo) {\n    this.props.onError?.(error, this.props.item);\n  }\n\n  override componentDidUpdate(previous: BoundaryProps) {\n    // New props for the same item (a streamed update) get a fresh chance to render.\n    if (this.state.failed && previous.item !== this.props.item) {\n      this.setState({ error: undefined, failed: false });\n    }\n  }\n\n  override render() {\n    if (this.state.failed) {\n      return renderFallback(this.props.fallback, {\n        reason: 'error',\n        item: this.props.item,\n        error: this.state.error,\n      });\n    }\n    return this.props.children;\n  }\n}\n\nfunction nodeItem(node: GenerativeUIElement, id: string): GenerativeUIItem {\n  return { id, component: node.type, props: node.props ?? {}, version: null, toolCallId: null };\n}\n\n/** One tree node: resolved and validated like a top-level item, children rendered as its `children`. */\nfunction TreeNode({ node, id }: { node: GenerativeUIElement; id: string }) {\n  const scope = useContext(TreeScopeContext);\n  const item = useMemo(() => nodeItem(node, id), [node, id]);\n  // A node of a preview the model is still writing: its props are half there, so they are not\n  // validated (the final frame is) — the renderer is told instead, through `useGenuiNode`.\n  const incomplete = node.incomplete === true;\n  const held = node.held === true;\n  const state = useMemo<GenuiNodeState>(\n    () => ({ id, type: node.type, incomplete, held }),\n    [id, node.type, incomplete, held],\n  );\n  const storedVersion = scope?.componentVersions?.[node.type];\n  const definition = scope?.options.catalog?.get?.(node.type);\n  const incompatible =\n    storedVersion !== undefined &&\n    definition !== undefined &&\n    storedVersion !== (definition.version ?? 1);\n  const resolution = useResolvedComponent(\n    node.type,\n    storedVersion ?? null,\n    incompatible ? {} : (scope?.options.registry ?? {}),\n    scope?.options.resolveComponent,\n  );\n  const validation = useValidatedProps(\n    incompatible || incomplete ? undefined : scope?.options.catalog,\n    node.type,\n    item.props,\n  );\n  if (scope === null) return null;\n  if (held) {\n    return (\n      <GenuiNodeContext.Provider value={state}>\n        {renderPlaceholder(scope, state)}\n      </GenuiNodeContext.Provider>\n    );\n  }\n  if (resolution.status === 'loading' || validation.status === 'pending') return scope.loading;\n  if (resolution.status === 'unknown') {\n    if (scope.fallback === undefined && scope.fallbackText !== undefined)\n      throw new Error('Unknown tree component');\n    return renderFallback(scope.fallback, { reason: 'unknown', item });\n  }\n  if (resolution.status === 'error') {\n    if (scope.fallback === undefined && scope.fallbackText !== undefined) throw resolution.error;\n    return renderFallback(scope.fallback, { reason: 'error', item, error: resolution.error });\n  }\n  if (validation.status === 'invalid') {\n    if (scope.fallback === undefined && scope.fallbackText !== undefined)\n      throw new Error('Invalid tree component');\n    return renderFallback(scope.fallback, { reason: 'invalid', item, issues: validation.issues });\n  }\n  const Renderer = resolution.Component;\n  const children = Array.isArray(node.children) ? node.children : [];\n  return (\n    <GenuiNodeContext.Provider value={state}>\n      <Renderer {...validation.props}>\n        {children.length > 0\n          ? children.map((child, index) => {\n              const childId = `${id}.${index}`;\n              if (scope.fallback === undefined && scope.fallbackText !== undefined)\n                return <TreeNode key={childId} node={child} id={childId} />;\n              return (\n                <ItemBoundary\n                  key={childId}\n                  item={nodeItem(child, childId)}\n                  fallback={scope.fallback}\n                  onError={scope.onError}\n                >\n                  <TreeNode node={child} id={childId} />\n                </ItemBoundary>\n              );\n            })\n          : undefined}\n      </Renderer>\n    </GenuiNodeContext.Provider>\n  );\n}\n\n/**\n * Renders a `genui:tree` frame's `{ root }` node by node through the same registry, catalog and\n * resolver as top-level components. Used automatically for tree frames unless a `treeRenderer`\n * (e.g. the json-render one) or a registry entry for `genui:tree` takes over.\n */\nexport function GenuiTree({ root }: { root?: GenerativeUIElement }) {\n  if (root === undefined || root === null || typeof root.type !== 'string') return null;\n  return <TreeNode node={root} id=\"root\" />;\n}\n\nexport interface GenerativeUIScopeProps extends GenerativeUIOptions {\n  fallbackText?: string;\n  componentVersions?: Record<string, number>;\n  fallback?: GenerativeUIFallback;\n  loading?: ReactNode;\n  /** Drawn for a tree node held back while the model writes it. Default: `loading`. */\n  placeholder?: GenuiPlaceholder;\n  onError?: (error: unknown, item: GenerativeUIItem) => void;\n  children?: ReactNode;\n}\n\n/**\n * The registry, catalog and fallbacks tree nodes render with. `<GenerativeUI>` provides it; wrap\n * your own chrome in it when you draw `useGenerativeUI`'s `Component` yourself and it may be a tree.\n */\nexport function GenerativeUIScope({\n  registry,\n  catalog,\n  resolveComponent,\n  fallback,\n  fallbackText,\n  componentVersions,\n  loading = null,\n  placeholder,\n  onError,\n  children,\n}: GenerativeUIScopeProps) {\n  const scope = useMemo<TreeScope>(\n    () => ({\n      options: {\n        registry,\n        ...(catalog !== undefined ? { catalog } : {}),\n        ...(resolveComponent !== undefined ? { resolveComponent } : {}),\n      },\n      fallback,\n      ...(componentVersions !== undefined ? { componentVersions } : {}),\n      ...(fallbackText !== undefined ? { fallbackText } : {}),\n      loading,\n      placeholder,\n      onError,\n    }),\n    [\n      registry,\n      catalog,\n      resolveComponent,\n      fallback,\n      fallbackText,\n      componentVersions,\n      loading,\n      placeholder,\n      onError,\n    ],\n  );\n  return <TreeScopeContext.Provider value={scope}>{children}</TreeScopeContext.Provider>;\n}\n\n/** What `<GenuiProvider>` hands every `<GenerativeUI>` / `useGenerativeUI` below it. */\nexport interface GenuiProviderValue extends Partial<GenerativeUIOptions> {\n  fallback?: GenerativeUIFallback;\n  loading?: ReactNode;\n  /** Drawn for a tree node held back while the model writes it (`streaming: 'complete'`). */\n  placeholder?: GenuiPlaceholder;\n  onError?: (error: unknown, item: GenerativeUIItem) => void;\n}\n\n// Shared by key: `/genui` and `/genui/json-render` are separate bundles, and a provider from one\n// must reach a `<GenerativeUI>` from the other.\nconst GenuiContext: Context<GenuiProviderValue | null> = sharedContext<GenuiProviderValue>(\n  '@dudousxd/nestjs-agent-react:genui-provider',\n);\n\n/** The enclosing `<GenuiProvider>`'s settings, or `null` outside one. */\nexport function useGenuiProvider(): GenuiProviderValue | null {\n  return useContext(GenuiContext);\n}\n\nexport interface GenuiProviderProps extends GenuiProviderValue {\n  children?: ReactNode;\n}\n\n/**\n * Set generative UI up once, at the app root: the registry of your renderers, the catalog to\n * validate against, a resolver for components the registry lacks, and what to draw when one does\n * not render. Every `<GenerativeUI>` below reads it (its own props still win), and `MessageItem` /\n * `MessageList` draw pushed components with it — no `renderUi` per message.\n *\n * ```tsx\n * <GenuiProvider registry={registry} catalog={catalog} fallback={({ item }) => <Unknown name={item.component} />}>\n *   <App />\n * </GenuiProvider>\n * ```\n */\nexport function GenuiProvider({\n  registry,\n  catalog,\n  resolveComponent,\n  treeRenderer,\n  fallback,\n  loading,\n  placeholder,\n  onError,\n  children,\n}: GenuiProviderProps) {\n  const value = useMemo<GenuiProviderValue>(\n    () => ({\n      ...(registry !== undefined ? { registry } : {}),\n      ...(catalog !== undefined ? { catalog } : {}),\n      ...(resolveComponent !== undefined ? { resolveComponent } : {}),\n      ...(treeRenderer !== undefined ? { treeRenderer } : {}),\n      ...(fallback !== undefined ? { fallback } : {}),\n      ...(loading !== undefined ? { loading } : {}),\n      ...(placeholder !== undefined ? { placeholder } : {}),\n      ...(onError !== undefined ? { onError } : {}),\n    }),\n    [registry, catalog, resolveComponent, treeRenderer, fallback, loading, placeholder, onError],\n  );\n  const renderUi = useCallback((block: TranscriptUiBlock) => <GenerativeUI part={block} />, []);\n  return (\n    <GenuiContext.Provider value={value}>\n      <AmbientRenderUiContext.Provider value={renderUi}>{children}</AmbientRenderUiContext.Provider>\n    </GenuiContext.Provider>\n  );\n}\n\nconst NO_REGISTRY: GenuiRegistry = {};\n\n/** Provider settings overlaid with explicit ones (explicit wins), memoized on their parts. */\nfunction useMergedOptions(own: Partial<GenerativeUIOptions>): GenerativeUIOptions {\n  const provided = useContext(GenuiContext);\n  const registry = own.registry ?? provided?.registry ?? NO_REGISTRY;\n  const catalog = own.catalog ?? provided?.catalog;\n  const resolveComponent = own.resolveComponent ?? provided?.resolveComponent;\n  const treeRenderer = own.treeRenderer ?? provided?.treeRenderer;\n  return useMemo(\n    () => ({\n      registry,\n      ...(catalog !== undefined ? { catalog } : {}),\n      ...(resolveComponent !== undefined ? { resolveComponent } : {}),\n      ...(treeRenderer !== undefined ? { treeRenderer } : {}),\n    }),\n    [registry, catalog, resolveComponent, treeRenderer],\n  );\n}\n\n/**\n * The headless half of {@link GenerativeUI}: what to draw for one pushed component, or `null` when\n * `part` is not one. Options default to the enclosing `<GenuiProvider>`'s.\n */\nexport function useGenerativeUI(\n  part: unknown,\n  options: Partial<GenerativeUIOptions> = {},\n): GenerativeUIState | null {\n  const merged = useMergedOptions(options);\n  return useGenerativeUIState(part, merged, merged.treeRenderer ?? (GenuiTree as GenuiRenderer));\n}\n\nexport interface GenerativeUIProps extends Partial<GenerativeUIOptions> {\n  /** A transcript `ui` block, a `data-ui` message part, or a stored `{ id, component, props, version? }`. */\n  part: TranscriptUiBlock | GenerativeUIItem | unknown;\n  /** Drawn for an unknown component, invalid props, or a renderer that threw. Default: the provider's, then the item's persisted text. */\n  fallback?: GenerativeUIFallback;\n  /** Drawn while a resolver or an async validation is pending. Default: the provider's, else nothing. */\n  loading?: ReactNode;\n  /**\n   * Drawn for a tree node held back while the model writes it (its component streams `complete`).\n   * Default: the provider's, else `loading`.\n   */\n  placeholder?: GenuiPlaceholder;\n  /** A renderer threw (the item shows `fallback`). */\n  onError?: (error: unknown, item: GenerativeUIItem) => void;\n}\n\n/**\n * Draws one server-pushed component with the app's own renderer. Headless: it adds no element and\n * no style of its own — only what the registry's component renders (and whatever `fallback` /\n * `loading` you pass). Everything but `part` defaults to the enclosing `<GenuiProvider>`.\n *\n * ```tsx\n * <GenerativeUI part={block} />\n * ```\n */\nexport function GenerativeUI({\n  part,\n  registry,\n  catalog,\n  resolveComponent,\n  treeRenderer,\n  fallback: ownFallback,\n  loading: ownLoading,\n  placeholder: ownPlaceholder,\n  onError: ownOnError,\n}: GenerativeUIProps) {\n  const provided = useContext(GenuiContext);\n  const fallback = ownFallback !== undefined ? ownFallback : provided?.fallback;\n  const loading = ownLoading ?? provided?.loading ?? null;\n  const placeholder = ownPlaceholder !== undefined ? ownPlaceholder : provided?.placeholder;\n  const onError = ownOnError ?? provided?.onError;\n  const options = useMergedOptions({\n    ...(registry !== undefined ? { registry } : {}),\n    ...(catalog !== undefined ? { catalog } : {}),\n    ...(resolveComponent !== undefined ? { resolveComponent } : {}),\n    ...(treeRenderer !== undefined ? { treeRenderer } : {}),\n  });\n  const state = useGenerativeUIState(\n    part,\n    options,\n    options.treeRenderer ?? (GenuiTree as GenuiRenderer),\n  );\n  if (state === null) return null;\n  if (state.status === 'loading') return loading;\n  if (state.status === 'problem') {\n    const { status: _status, ...problem } = state;\n    return renderFallback(fallback, problem);\n  }\n  const Renderer = state.Component;\n  return (\n    <GenerativeUIScope\n      {...options}\n      {...(state.item.componentVersions !== undefined\n        ? { componentVersions: state.item.componentVersions }\n        : {})}\n      {...(state.item.fallbackText !== undefined ? { fallbackText: state.item.fallbackText } : {})}\n      fallback={fallback}\n      loading={loading}\n      {...(placeholder !== undefined ? { placeholder } : {})}\n      {...(onError !== undefined ? { onError } : {})}\n    >\n      <ItemBoundary item={state.item} fallback={fallback} onError={onError}>\n        <Renderer {...state.props} />\n      </ItemBoundary>\n    </GenerativeUIScope>\n  );\n}\n","import { type Context, type ReactNode, createContext, useContext } from 'react';\nimport type { TranscriptUiBlock } from '../transcript/model.js';\n\n/** Draws a server-pushed component block. */\nexport type AmbientRenderUi = (block: TranscriptUiBlock) => ReactNode;\n\n/**\n * A context stored on `globalThis` under a registered symbol. Each entry point (`.`, `/genui`,\n * `/genui/json-render`) is its own bundle with its own copy of every module, so a context one entry\n * provides and another reads has to be found by key, not by module identity.\n */\nexport function sharedContext<T>(key: string): Context<T | null> {\n  const symbol = Symbol.for(key);\n  const holder = globalThis as Record<symbol, Context<T | null> | undefined>;\n  const existing = holder[symbol];\n  if (existing !== undefined) return existing;\n  const created = createContext<T | null>(null);\n  holder[symbol] = created;\n  return created;\n}\n\n/**\n * How pushed components are drawn when no `renderUi` is passed — set by `<GenuiProvider>` (the\n * `/genui` subpath) and read by `MessageItem`.\n */\nexport const AmbientRenderUiContext: Context<AmbientRenderUi | null> =\n  sharedContext<AmbientRenderUi>('@dudousxd/nestjs-agent-react:ambient-render-ui');\n\n/**\n * The renderer `<GenuiProvider>` installed for pushed components, or `null` outside one. For a\n * custom transcript built on `useTranscriptItem`: draw a `ui` block with it and you get what\n * `MessageItem` draws.\n */\nexport function useAmbientRenderUi(): AmbientRenderUi | null {\n  return useContext(AmbientRenderUiContext);\n}\n","import { useEffect, useMemo, useState } from 'react';\nimport {\n  GENUI_TREE_COMPONENT,\n  type GenerativeUIItem,\n  type GenerativeUIOptions,\n  type GenerativeUIState,\n  type GenuiCatalogLike,\n  type GenuiIssueLike,\n  type GenuiRegistry,\n  type GenuiRenderer,\n  type ResolveComponent,\n} from './types.js';\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/**\n * Normalize whatever carries a pushed component: a transcript `ui` block, a `data-ui` message part\n * (`{ type: 'data-ui', id, data }`), a stored `{ id, component, props, version? }` entry. `null` for\n * anything else.\n */\nexport function toGenerativeUIItem(part: unknown): GenerativeUIItem | null {\n  if (!isRecord(part)) return null;\n  const source = part.type === 'data-ui' && isRecord(part.data) ? part.data : part;\n  if (typeof source.component !== 'string') return null;\n  const id =\n    typeof source.id === 'string' ? source.id : typeof part.id === 'string' ? part.id : null;\n  if (id === null) return null;\n  return {\n    id,\n    component: source.component,\n    ...(isRecord(source.componentVersions) &&\n    Object.values(source.componentVersions).every(\n      (version) => typeof version === 'number' && Number.isSafeInteger(version) && version > 0,\n    )\n      ? { componentVersions: { ...source.componentVersions } as Record<string, number> }\n      : {}),\n    ...(typeof source.fallbackText === 'string' ? { fallbackText: source.fallbackText } : {}),\n    props: isRecord(source.props) ? source.props : {},\n    version: typeof source.version === 'number' ? source.version : null,\n    toolCallId: typeof source.toolCallId === 'string' ? source.toolCallId : null,\n    ...(source.partial === true ? { partial: true as const } : {}),\n  };\n}\n\ntype Resolution =\n  | { status: 'ready'; Component: GenuiRenderer }\n  | { status: 'loading' }\n  | { status: 'unknown' }\n  | { status: 'error'; error: unknown };\n\ninterface CacheEntry {\n  resolution: Resolution;\n  settled: Promise<void> | null;\n}\n\nconst resolverCaches = new WeakMap<ResolveComponent, Map<string, CacheEntry>>();\n\nfunction resolveCached(\n  resolve: ResolveComponent,\n  name: string,\n  version: number | null,\n): CacheEntry {\n  let cache = resolverCaches.get(resolve);\n  if (cache === undefined) {\n    cache = new Map();\n    resolverCaches.set(resolve, cache);\n  }\n  const key = `${name}@${version ?? ''}`;\n  const hit = cache.get(key);\n  if (hit !== undefined) return hit;\n  let entry: CacheEntry;\n  try {\n    const result = resolve(name, version);\n    if (result instanceof Promise) {\n      entry = { resolution: { status: 'loading' }, settled: null };\n      entry.settled = result.then(\n        (Component) => {\n          entry.resolution = Component ? { status: 'ready', Component } : { status: 'unknown' };\n        },\n        (error: unknown) => {\n          entry.resolution = { status: 'error', error };\n        },\n      );\n    } else {\n      entry = {\n        resolution: result ? { status: 'ready', Component: result } : { status: 'unknown' },\n        settled: null,\n      };\n    }\n  } catch (error) {\n    entry = { resolution: { status: 'error', error }, settled: null };\n  }\n  cache.set(key, entry);\n  return entry;\n}\n\n/**\n * Which renderer draws `name`: the registry first, then `resolveComponent` (cached; async results\n * re-render the caller when they land). `fallbackTree` answers the tree component when the\n * registry does not override it.\n */\nexport function useResolvedComponent(\n  name: string,\n  version: number | null,\n  registry: GenuiRegistry,\n  resolve: ResolveComponent | undefined,\n  fallbackTree?: GenuiRenderer,\n): Resolution {\n  const [, setTick] = useState(0);\n  const own = registry[name];\n  const entry =\n    own !== undefined || resolve === undefined ? null : resolveCached(resolve, name, version);\n  const pending = entry?.resolution.status === 'loading' ? entry.settled : null;\n  useEffect(() => {\n    if (pending === null) return;\n    let live = true;\n    void pending.then(() => {\n      if (live) setTick((tick) => tick + 1);\n    });\n    return () => {\n      live = false;\n    };\n  }, [pending]);\n  if (own !== undefined) return { status: 'ready', Component: own };\n  if (entry !== null && entry.resolution.status !== 'unknown') return entry.resolution;\n  if (name === GENUI_TREE_COMPONENT && fallbackTree !== undefined) {\n    return { status: 'ready', Component: fallbackTree };\n  }\n  return { status: 'unknown' };\n}\n\ntype Validation =\n  | { status: 'ok'; props: Record<string, unknown> }\n  | { status: 'pending' }\n  | { status: 'invalid'; issues: GenuiIssueLike[] };\n\n/**\n * Props checked against the catalog: synchronously when the catalog can (`validateSync`), else\n * after the async check settles. A component the catalog does not know passes through unchecked.\n */\nexport function useValidatedProps(\n  catalog: GenuiCatalogLike | undefined,\n  name: string,\n  props: Record<string, unknown>,\n): Validation {\n  const checked = catalog?.has(name) === true;\n  const immediate = useMemo<Validation | null>(() => {\n    if (!checked || catalog === undefined) return { status: 'ok', props };\n    const result = catalog.validateSync?.(name, props);\n    if (result === undefined) return null;\n    return result.ok\n      ? { status: 'ok', props: result.value }\n      : { status: 'invalid', issues: result.issues };\n  }, [checked, catalog, name, props]);\n  const [late, setLate] = useState<{ props: Record<string, unknown>; result: Validation } | null>(\n    null,\n  );\n  useEffect(() => {\n    if (immediate !== null || catalog === undefined) return;\n    let live = true;\n    catalog.validate(name, props).then(\n      (result) => {\n        if (!live) return;\n        setLate({\n          props,\n          result: result.ok\n            ? { status: 'ok', props: result.value }\n            : { status: 'invalid', issues: result.issues },\n        });\n      },\n      (error: unknown) => {\n        if (!live) return;\n        setLate({\n          props,\n          result: {\n            status: 'invalid',\n            issues: [{ path: [], message: error instanceof Error ? error.message : String(error) }],\n          },\n        });\n      },\n    );\n    return () => {\n      live = false;\n    };\n  }, [immediate, catalog, name, props]);\n  if (immediate !== null) return immediate;\n  return late !== null && late.props === props ? late.result : { status: 'pending' };\n}\n\n/** {@link import('./generative-ui.js').useGenerativeUI}, with the tree renderer handed in (avoids an import cycle). */\nexport function useGenerativeUIState(\n  part: unknown,\n  options: GenerativeUIOptions,\n  fallbackTree: GenuiRenderer | undefined,\n): GenerativeUIState | null {\n  const item = useMemo(() => toGenerativeUIItem(part), [part]);\n  const name = item?.component ?? '';\n  const definition = options.catalog?.get?.(name);\n  const incompatible =\n    item?.fallbackText !== undefined &&\n    item.version !== null &&\n    definition !== undefined &&\n    item.version !== (definition.version ?? 1);\n  const resolution = useResolvedComponent(\n    name,\n    item?.version ?? null,\n    incompatible ? {} : options.registry,\n    item === null ? undefined : options.resolveComponent,\n    fallbackTree,\n  );\n  const empty = useMemo<Record<string, unknown>>(() => ({}), []);\n  // A tree is validated node by node as it renders, not as one component.\n  const validation = useValidatedProps(\n    item === null || name === GENUI_TREE_COMPONENT || incompatible ? undefined : options.catalog,\n    name,\n    item?.props ?? empty,\n  );\n  if (item === null) return null;\n  // A withdrawn preview (partial, nothing to draw): the call will not replace it.\n  if (item.partial === true && Object.keys(item.props).length === 0) return null;\n  if (\n    name === GENUI_TREE_COMPONENT &&\n    item.fallbackText !== undefined &&\n    (!isRecord(item.props.root) || typeof item.props.root.type !== 'string')\n  )\n    return {\n      status: 'problem',\n      reason: 'invalid',\n      item,\n      issues: [{ path: ['root'], message: 'Invalid UI tree root' }],\n    };\n  if (resolution.status === 'loading') return { status: 'loading', item };\n  if (resolution.status === 'unknown') return { status: 'problem', reason: 'unknown', item };\n  if (resolution.status === 'error') {\n    return { status: 'problem', reason: 'error', item, error: resolution.error };\n  }\n  if (validation.status === 'pending') return { status: 'loading', item };\n  if (validation.status === 'invalid') {\n    return { status: 'problem', reason: 'invalid', item, issues: validation.issues };\n  }\n  return { status: 'ready', item, Component: resolution.Component, props: validation.props };\n}\n","import type { ComponentType, ReactNode } from 'react';\n\n/** The `ui` frame component a composed tree is pushed under (`GENUI_TREE_COMPONENT` of `@dudousxd/nestjs-agent-core/genui`). */\nexport const GENUI_TREE_COMPONENT = 'genui:tree';\n\n/** One pushed component, normalized from whatever carried it (a transcript block, a `data-ui` part, a stored entry). */\nexport interface GenerativeUIItem {\n  fallbackText?: string;\n  componentVersions?: Record<string, number>;\n  id: string;\n  component: string;\n  props: Record<string, unknown>;\n  version: number | null;\n  toolCallId: string | null;\n  /**\n   * A preview drawn while the model is still writing the call (genui `streaming: 'partial'`):\n   * unvalidated, and replaced in place by the final frame under the same `id`.\n   */\n  partial?: true;\n}\n\n/** A node of a composed tree (`genui:tree` frames): `{ type, props, children? }`. */\nexport interface GenerativeUIElement {\n  type: string;\n  props: Record<string, unknown>;\n  children?: GenerativeUIElement[];\n  /**\n   * The node's position (`root`, `root.0`, `root.0.2`), carried by partial frames. Stable as the\n   * tree grows, and the same rule names the final tree's nodes.\n   */\n  id?: string;\n  /** Partial frames only: the model has not finished writing this node. */\n  incomplete?: true;\n  /** Partial frames only: a `streaming: 'complete'` component held back until it closes (no props). */\n  held?: true;\n}\n\n/**\n * What a tree node's renderer can learn about its node ({@link useGenuiNode}): which node it is,\n * and whether the model is still writing it. Room is left for more states (data a node is bound\n * to, loading) as separate fields — `incomplete` only ever means \"still being written\".\n */\nexport interface GenuiNodeState {\n  /** The node's position id (`root`, `root.1.0`): stable from the first preview to the final frame. */\n  id: string;\n  type: string;\n  /** The model has not finished writing this node: props (and children) may still grow. */\n  incomplete: boolean;\n  /** The node is a placeholder for a component that is only drawn whole (`streaming: 'complete'`). */\n  held: boolean;\n}\n\n/**\n * An app's renderer for one component: it receives the component's props spread, plus `children`\n * when it is a layout node in a tree. Any React component — the library never styles anything.\n */\nexport type GenuiRenderer<P = any> = ComponentType<P & { children?: ReactNode }>;\n\n/** Component name → the app's renderer. */\nexport type GenuiRegistry = Record<string, GenuiRenderer>;\n\n/**\n * Resolve a component the registry does not have — typically a tenant's own component, fetched for\n * the exact `version` a message was rendered with. Return `null`/`undefined` for \"no such\n * component\". May be async; results are cached per resolver, name and version.\n */\nexport type ResolveComponent = (\n  name: string,\n  version: number | null,\n) => GenuiRenderer | null | undefined | Promise<GenuiRenderer | null | undefined>;\n\nexport interface GenuiIssueLike {\n  path: (string | number)[];\n  message: string;\n}\n\ntype ValidationLike =\n  | { ok: true; value: Record<string, unknown> }\n  | { ok: false; issues: GenuiIssueLike[] };\n\n/**\n * What the renderer needs from a catalog to validate props before drawing them. A `Catalog` from\n * `@dudousxd/nestjs-agent-core/genui` satisfies it; declared structurally so any catalog-shaped\n * object does too.\n */\nexport interface GenuiCatalogLike {\n  get?(name: string): { version?: number } | undefined;\n  has(name: string): boolean;\n  validate(name: string, props: unknown): Promise<ValidationLike>;\n  validateSync?(name: string, props: unknown): ValidationLike | undefined;\n}\n\nexport interface GenerativeUIOptions {\n  registry: GenuiRegistry;\n  /** Validate props against it before rendering. Components the catalog does not know render unvalidated. */\n  catalog?: GenuiCatalogLike;\n  resolveComponent?: ResolveComponent;\n  /**\n   * Draws a composed tree frame (`genui:tree`) whole — e.g. through json-render (see the\n   * `/genui/json-render` subpath's `GenuiProvider`). Omitted → trees render node by node through\n   * `registry`.\n   */\n  treeRenderer?: GenuiRenderer<{ root?: GenerativeUIElement }>;\n}\n\n/**\n * Drawn in place of a tree node that is not drawable yet — a `held` node (its component streams\n * `complete`) while the model writes it. Default: the `loading` element.\n */\nexport type GenuiPlaceholder = ReactNode | ((node: GenuiNodeState) => ReactNode);\n\n/** Why an item did not render. */\nexport type GenerativeUIProblem =\n  | { reason: 'unknown'; item: GenerativeUIItem }\n  | { reason: 'invalid'; item: GenerativeUIItem; issues: GenuiIssueLike[] }\n  | { reason: 'error'; item: GenerativeUIItem; error: unknown };\n\nexport type GenerativeUIState =\n  | {\n      status: 'ready';\n      item: GenerativeUIItem;\n      Component: GenuiRenderer;\n      props: Record<string, unknown>;\n    }\n  | { status: 'loading'; item: GenerativeUIItem }\n  | ({ status: 'problem' } & GenerativeUIProblem);\n"],"mappings":"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","names":["GenuiProvider","import_react","import_react","import_react","Component","Renderer","Renderer","import_jsx_runtime","Renderer","GenuiProvider"]}

package/dist/genui-json-render.d.cts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import { ComponentRegistry } from '@json-render/react';
-import { f as GenuiProviderProps$1 } from './generative-ui-CyHY8Lh1.cjs';
-import { b as GenerativeUIElement, i as GenuiRenderer, h as GenuiRegistry } from './types-DZtFsWec.cjs';
+import { f as GenuiProviderProps$1 } from './generative-ui-ClYT7OgL.cjs';
+import { b as GenerativeUIElement, k as GenuiRenderer, j as GenuiRegistry } from './types-COuArD3c.cjs';
 import '@dudousxd/nestjs-agent-core';
 import 'ai';
 

package/dist/genui-json-render.d.ts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import { ComponentRegistry } from '@json-render/react';
-import { f as GenuiProviderProps$1 } from './generative-ui-DdUZPCXX.js';
-import { b as GenerativeUIElement, i as GenuiRenderer, h as GenuiRegistry } from './types-DZtFsWec.js';
+import { f as GenuiProviderProps$1 } from './generative-ui-D1efzu_K.js';
+import { b as GenerativeUIElement, k as GenuiRenderer, j as GenuiRegistry } from './types-COuArD3c.js';
 import '@dudousxd/nestjs-agent-core';
 import 'ai';