@dudousxd/nestjs-agent-react 0.13.0 → 0.14.0

package/dist/genui.cjs

@@ -0,0 +1,450 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/genui/index.ts
+var genui_exports = {};
+__export(genui_exports, {
+  GENUI_TREE_COMPONENT: () => GENUI_TREE_COMPONENT,
+  GenerativeUI: () => GenerativeUI,
+  GenerativeUIScope: () => GenerativeUIScope,
+  GenuiTree: () => GenuiTree,
+  toGenerativeUIItem: () => toGenerativeUIItem,
+  useGenerativeUI: () => useGenerativeUI
+});
+module.exports = __toCommonJS(genui_exports);
+
+// src/genui/generative-ui.tsx
+var import_react2 = require("react");
+
+// src/genui/use-generative-ui.ts
+var import_react = require("react");
+
+// src/genui/types.ts
+var GENUI_TREE_COMPONENT = "genui:tree";
+
+// src/genui/use-generative-ui.ts
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+__name(isRecord, "isRecord");
+function toGenerativeUIItem(part) {
+  if (!isRecord(part)) return null;
+  const source = part.type === "data-ui" && isRecord(part.data) ? part.data : part;
+  if (typeof source.component !== "string") return null;
+  const id = typeof source.id === "string" ? source.id : typeof part.id === "string" ? part.id : null;
+  if (id === null) return null;
+  return {
+    id,
+    component: source.component,
+    props: isRecord(source.props) ? source.props : {},
+    version: typeof source.version === "number" ? source.version : null,
+    toolCallId: typeof source.toolCallId === "string" ? source.toolCallId : null
+  };
+}
+__name(toGenerativeUIItem, "toGenerativeUIItem");
+var resolverCaches = /* @__PURE__ */ new WeakMap();
+function resolveCached(resolve, name, version) {
+  let cache = resolverCaches.get(resolve);
+  if (cache === void 0) {
+    cache = /* @__PURE__ */ new Map();
+    resolverCaches.set(resolve, cache);
+  }
+  const key = `${name}@${version ?? ""}`;
+  const hit = cache.get(key);
+  if (hit !== void 0) return hit;
+  let entry;
+  try {
+    const result = resolve(name, version);
+    if (result instanceof Promise) {
+      entry = {
+        resolution: {
+          status: "loading"
+        },
+        settled: null
+      };
+      entry.settled = result.then((Component2) => {
+        entry.resolution = Component2 ? {
+          status: "ready",
+          Component: Component2
+        } : {
+          status: "unknown"
+        };
+      }, (error) => {
+        entry.resolution = {
+          status: "error",
+          error
+        };
+      });
+    } else {
+      entry = {
+        resolution: result ? {
+          status: "ready",
+          Component: result
+        } : {
+          status: "unknown"
+        },
+        settled: null
+      };
+    }
+  } catch (error) {
+    entry = {
+      resolution: {
+        status: "error",
+        error
+      },
+      settled: null
+    };
+  }
+  cache.set(key, entry);
+  return entry;
+}
+__name(resolveCached, "resolveCached");
+function useResolvedComponent(name, version, registry, resolve, fallbackTree) {
+  const [, setTick] = (0, import_react.useState)(0);
+  const own = registry[name];
+  const entry = own !== void 0 || resolve === void 0 ? null : resolveCached(resolve, name, version);
+  const pending = entry?.resolution.status === "loading" ? entry.settled : null;
+  (0, import_react.useEffect)(() => {
+    if (pending === null) return;
+    let live = true;
+    void pending.then(() => {
+      if (live) setTick((tick) => tick + 1);
+    });
+    return () => {
+      live = false;
+    };
+  }, [
+    pending
+  ]);
+  if (own !== void 0) return {
+    status: "ready",
+    Component: own
+  };
+  if (entry !== null && entry.resolution.status !== "unknown") return entry.resolution;
+  if (name === GENUI_TREE_COMPONENT && fallbackTree !== void 0) {
+    return {
+      status: "ready",
+      Component: fallbackTree
+    };
+  }
+  return {
+    status: "unknown"
+  };
+}
+__name(useResolvedComponent, "useResolvedComponent");
+function useValidatedProps(catalog, name, props) {
+  const checked = catalog?.has(name) === true;
+  const immediate = (0, import_react.useMemo)(() => {
+    if (!checked || catalog === void 0) return {
+      status: "ok",
+      props
+    };
+    const result = catalog.validateSync?.(name, props);
+    if (result === void 0) return null;
+    return result.ok ? {
+      status: "ok",
+      props: result.value
+    } : {
+      status: "invalid",
+      issues: result.issues
+    };
+  }, [
+    checked,
+    catalog,
+    name,
+    props
+  ]);
+  const [late, setLate] = (0, import_react.useState)(null);
+  (0, import_react.useEffect)(() => {
+    if (immediate !== null || catalog === void 0) return;
+    let live = true;
+    catalog.validate(name, props).then((result) => {
+      if (!live) return;
+      setLate({
+        props,
+        result: result.ok ? {
+          status: "ok",
+          props: result.value
+        } : {
+          status: "invalid",
+          issues: result.issues
+        }
+      });
+    }, (error) => {
+      if (!live) return;
+      setLate({
+        props,
+        result: {
+          status: "invalid",
+          issues: [
+            {
+              path: [],
+              message: error instanceof Error ? error.message : String(error)
+            }
+          ]
+        }
+      });
+    });
+    return () => {
+      live = false;
+    };
+  }, [
+    immediate,
+    catalog,
+    name,
+    props
+  ]);
+  if (immediate !== null) return immediate;
+  return late !== null && late.props === props ? late.result : {
+    status: "pending"
+  };
+}
+__name(useValidatedProps, "useValidatedProps");
+function useGenerativeUIState(part, options, fallbackTree) {
+  const item = (0, import_react.useMemo)(() => toGenerativeUIItem(part), [
+    part
+  ]);
+  const name = item?.component ?? "";
+  const resolution = useResolvedComponent(name, item?.version ?? null, options.registry, item === null ? void 0 : options.resolveComponent, fallbackTree);
+  const empty = (0, import_react.useMemo)(() => ({}), []);
+  const validation = useValidatedProps(item === null || name === GENUI_TREE_COMPONENT ? void 0 : options.catalog, name, item?.props ?? empty);
+  if (item === null) return null;
+  if (resolution.status === "loading") return {
+    status: "loading",
+    item
+  };
+  if (resolution.status === "unknown") return {
+    status: "problem",
+    reason: "unknown",
+    item
+  };
+  if (resolution.status === "error") {
+    return {
+      status: "problem",
+      reason: "error",
+      item,
+      error: resolution.error
+    };
+  }
+  if (validation.status === "pending") return {
+    status: "loading",
+    item
+  };
+  if (validation.status === "invalid") {
+    return {
+      status: "problem",
+      reason: "invalid",
+      item,
+      issues: validation.issues
+    };
+  }
+  return {
+    status: "ready",
+    item,
+    Component: resolution.Component,
+    props: validation.props
+  };
+}
+__name(useGenerativeUIState, "useGenerativeUIState");
+
+// src/genui/generative-ui.tsx
+var TreeScopeContext = /* @__PURE__ */ (0, import_react2.createContext)(null);
+function renderFallback(fallback, problem) {
+  if (typeof fallback === "function") return fallback(problem);
+  return fallback ?? null;
+}
+__name(renderFallback, "renderFallback");
+var ItemBoundary = class ItemBoundary2 extends import_react2.Component {
+  static {
+    __name(this, "ItemBoundary");
+  }
+  state = {
+    error: void 0,
+    failed: false
+  };
+  static getDerivedStateFromError(error) {
+    return {
+      error,
+      failed: true
+    };
+  }
+  componentDidCatch(error, _info) {
+    this.props.onError?.(error, this.props.item);
+  }
+  componentDidUpdate(previous) {
+    if (this.state.failed && previous.item !== this.props.item) {
+      this.setState({
+        error: void 0,
+        failed: false
+      });
+    }
+  }
+  render() {
+    if (this.state.failed) {
+      return renderFallback(this.props.fallback, {
+        reason: "error",
+        item: this.props.item,
+        error: this.state.error
+      });
+    }
+    return this.props.children;
+  }
+};
+function nodeItem(node, id) {
+  return {
+    id,
+    component: node.type,
+    props: node.props ?? {},
+    version: null,
+    toolCallId: null
+  };
+}
+__name(nodeItem, "nodeItem");
+function TreeNode({ node, id }) {
+  const scope = (0, import_react2.useContext)(TreeScopeContext);
+  const item = (0, import_react2.useMemo)(() => nodeItem(node, id), [
+    node,
+    id
+  ]);
+  const resolution = useResolvedComponent(node.type, null, scope?.options.registry ?? {}, scope?.options.resolveComponent);
+  const validation = useValidatedProps(scope?.options.catalog, node.type, item.props);
+  if (scope === null) return null;
+  if (resolution.status === "loading" || validation.status === "pending") return scope.loading;
+  if (resolution.status === "unknown") {
+    return renderFallback(scope.fallback, {
+      reason: "unknown",
+      item
+    });
+  }
+  if (resolution.status === "error") {
+    return renderFallback(scope.fallback, {
+      reason: "error",
+      item,
+      error: resolution.error
+    });
+  }
+  if (validation.status === "invalid") {
+    return renderFallback(scope.fallback, {
+      reason: "invalid",
+      item,
+      issues: validation.issues
+    });
+  }
+  const Renderer = resolution.Component;
+  const children = Array.isArray(node.children) ? node.children : [];
+  return /* @__PURE__ */ React.createElement(Renderer, validation.props, children.length > 0 ? children.map((child, index) => {
+    const childId = `${id}.${index}`;
+    return /* @__PURE__ */ React.createElement(ItemBoundary, {
+      key: childId,
+      item: nodeItem(child, childId),
+      fallback: scope.fallback,
+      onError: scope.onError
+    }, /* @__PURE__ */ React.createElement(TreeNode, {
+      node: child,
+      id: childId
+    }));
+  }) : void 0);
+}
+__name(TreeNode, "TreeNode");
+function GenuiTree({ root }) {
+  if (root === void 0 || root === null || typeof root.type !== "string") return null;
+  return /* @__PURE__ */ React.createElement(TreeNode, {
+    node: root,
+    id: "root"
+  });
+}
+__name(GenuiTree, "GenuiTree");
+function GenerativeUIScope({ registry, catalog, resolveComponent, fallback, loading = null, onError, children }) {
+  const scope = (0, import_react2.useMemo)(() => ({
+    options: {
+      registry,
+      ...catalog !== void 0 ? {
+        catalog
+      } : {},
+      ...resolveComponent !== void 0 ? {
+        resolveComponent
+      } : {}
+    },
+    fallback,
+    loading,
+    onError
+  }), [
+    registry,
+    catalog,
+    resolveComponent,
+    fallback,
+    loading,
+    onError
+  ]);
+  return /* @__PURE__ */ React.createElement(TreeScopeContext.Provider, {
+    value: scope
+  }, children);
+}
+__name(GenerativeUIScope, "GenerativeUIScope");
+function useGenerativeUI(part, options) {
+  return useGenerativeUIState(part, options, GenuiTree);
+}
+__name(useGenerativeUI, "useGenerativeUI");
+function GenerativeUI({ part, registry, catalog, resolveComponent, fallback, loading = null, onError }) {
+  const options = (0, import_react2.useMemo)(() => ({
+    registry,
+    ...catalog !== void 0 ? {
+      catalog
+    } : {},
+    ...resolveComponent !== void 0 ? {
+      resolveComponent
+    } : {}
+  }), [
+    registry,
+    catalog,
+    resolveComponent
+  ]);
+  const state = useGenerativeUI(part, options);
+  if (state === null) return null;
+  if (state.status === "loading") return loading;
+  if (state.status === "problem") {
+    const { status: _status, ...problem } = state;
+    return renderFallback(fallback, problem);
+  }
+  const Renderer = state.Component;
+  return /* @__PURE__ */ React.createElement(GenerativeUIScope, {
+    ...options,
+    fallback,
+    loading,
+    ...onError !== void 0 ? {
+      onError
+    } : {}
+  }, /* @__PURE__ */ React.createElement(ItemBoundary, {
+    item: state.item,
+    fallback,
+    onError
+  }, /* @__PURE__ */ React.createElement(Renderer, state.props)));
+}
+__name(GenerativeUI, "GenerativeUI");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  GENUI_TREE_COMPONENT,
+  GenerativeUI,
+  GenerativeUIScope,
+  GenuiTree,
+  toGenerativeUIItem,
+  useGenerativeUI
+});
+//# sourceMappingURL=genui.cjs.map

package/dist/genui.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/genui/index.ts","../src/genui/generative-ui.tsx","../src/genui/use-generative-ui.ts","../src/genui/types.ts"],"sourcesContent":["export {\n  GenerativeUI,\n  type GenerativeUIFallback,\n  type GenerativeUIProps,\n  GenerativeUIScope,\n  type GenerativeUIScopeProps,\n  GenuiTree,\n  useGenerativeUI,\n} from './generative-ui.js';\nexport {\n  GENUI_TREE_COMPONENT,\n  type GenerativeUIElement,\n  type GenerativeUIItem,\n  type GenerativeUIOptions,\n  type GenerativeUIProblem,\n  type GenerativeUIState,\n  type GenuiCatalogLike,\n  type GenuiIssueLike,\n  type GenuiRegistry,\n  type GenuiRenderer,\n  type ResolveComponent,\n} from './types.js';\nexport { toGenerativeUIItem } from './use-generative-ui.js';\n","import {\n  Component,\n  type ErrorInfo,\n  type ReactNode,\n  createContext,\n  useContext,\n  useMemo,\n} from 'react';\nimport type { TranscriptUiBlock } from '../transcript/model.js';\nimport type {\n  GenerativeUIElement,\n  GenerativeUIItem,\n  GenerativeUIOptions,\n  GenerativeUIProblem,\n  GenerativeUIState,\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  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  return fallback ?? 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 resolution = useResolvedComponent(\n    node.type,\n    null,\n    scope?.options.registry ?? {},\n    scope?.options.resolveComponent,\n  );\n  const validation = useValidatedProps(scope?.options.catalog, node.type, item.props);\n  if (scope === null) return null;\n  if (resolution.status === 'loading' || validation.status === 'pending') return scope.loading;\n  if (resolution.status === 'unknown') {\n    return renderFallback(scope.fallback, { reason: 'unknown', item });\n  }\n  if (resolution.status === 'error') {\n    return renderFallback(scope.fallback, { reason: 'error', item, error: resolution.error });\n  }\n  if (validation.status === 'invalid') {\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            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 the registry\n * overrides `genui:tree` (e.g. with the json-render adapter).\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  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  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      loading,\n      onError,\n    }),\n    [registry, catalog, resolveComponent, fallback, loading, onError],\n  );\n  return <TreeScopeContext.Provider value={scope}>{children}</TreeScopeContext.Provider>;\n}\n\n/** The headless half of {@link GenerativeUI}: what to draw for one pushed component, or `null` when `part` is not one. */\nexport function useGenerativeUI(\n  part: unknown,\n  options: GenerativeUIOptions,\n): GenerativeUIState | null {\n  return useGenerativeUIState(part, options, GenuiTree as GenuiRenderer);\n}\n\nexport interface GenerativeUIProps extends 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: nothing. */\n  fallback?: GenerativeUIFallback;\n  /** Drawn while a resolver or an async validation is pending. Default: 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).\n *\n * ```tsx\n * <MessageItem message={m} renderUi={(block) => (\n *   <GenerativeUI part={block} registry={registry} catalog={catalog} fallback={({ item }) => <Unknown name={item.component} />} />\n * )} />\n * ```\n */\nexport function GenerativeUI({\n  part,\n  registry,\n  catalog,\n  resolveComponent,\n  fallback,\n  loading = null,\n  onError,\n}: GenerativeUIProps) {\n  const options = useMemo<GenerativeUIOptions>(\n    () => ({\n      registry,\n      ...(catalog !== undefined ? { catalog } : {}),\n      ...(resolveComponent !== undefined ? { resolveComponent } : {}),\n    }),\n    [registry, catalog, resolveComponent],\n  );\n  const state = useGenerativeUI(part, options);\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      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 { 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    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 resolution = useResolvedComponent(\n    name,\n    item?.version ?? null,\n    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 ? undefined : options.catalog,\n    name,\n    item?.props ?? empty,\n  );\n  if (item === null) return null;\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 (`@dudousxd/nestjs-agent-genui`'s `GENUI_TREE_COMPONENT`). */\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  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\n * `@dudousxd/nestjs-agent-genui` `Catalog` satisfies it; declared structurally so this subpath does\n * not depend on that package.\n */\nexport interface GenuiCatalogLike {\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\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":["import_react","GENUI_TREE_COMPONENT","isRecord","value","Array","isArray","toGenerativeUIItem","part","source","type","data","component","id","props","version","toolCallId","resolverCaches","WeakMap","resolveCached","resolve","name","cache","get","undefined","Map","set","key","hit","entry","result","Promise","resolution","status","settled","then","Component","error","useResolvedComponent","registry","fallbackTree","setTick","useState","own","pending","useEffect","live","tick","GENUI_TREE_COMPONENT","useValidatedProps","catalog","checked","has","immediate","useMemo","validateSync","ok","issues","late","setLate","validate","path","message","Error","String","useGenerativeUIState","options","item","resolveComponent","empty","validation","reason","TreeScopeContext","createContext","renderFallback","fallback","problem","ItemBoundary","Component","state","error","undefined","failed","getDerivedStateFromError","componentDidCatch","_info","props","onError","item","componentDidUpdate","previous","setState","render","reason","children","nodeItem","node","id","component","type","version","toolCallId","TreeNode","scope","useContext","useMemo","resolution","useResolvedComponent","options","registry","resolveComponent","validation","useValidatedProps","catalog","status","loading","issues","Renderer","Array","isArray","length","map","child","index","childId","key","GenuiTree","root","GenerativeUIScope","Provider","value","useGenerativeUI","part","useGenerativeUIState","GenerativeUI","_status"]}

package/dist/genui.d.cts

@@ -0,0 +1,62 @@
+import * as React from 'react';
+import { ReactNode } from 'react';
+import { T as TranscriptUiBlock } from './model-CMNhyau6.cjs';
+import { G as GenerativeUIOptions, a as GenerativeUIItem, b as GenerativeUIProblem, c as GenerativeUIElement, d as GenerativeUIState } from './types-DFD-soWU.cjs';
+export { e as GENUI_TREE_COMPONENT, f as GenuiCatalogLike, g as GenuiIssueLike, h as GenuiRegistry, i as GenuiRenderer, R as ResolveComponent } from './types-DFD-soWU.cjs';
+import '@dudousxd/nestjs-agent-core';
+import 'ai';
+
+/** What to draw instead of a component that did not render. Default: nothing. */
+type GenerativeUIFallback = ReactNode | ((problem: GenerativeUIProblem) => ReactNode);
+/**
+ * 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 the registry
+ * overrides `genui:tree` (e.g. with the json-render adapter).
+ */
+declare function GenuiTree({ root }: {
+    root?: GenerativeUIElement;
+}): React.JSX.Element | null;
+interface GenerativeUIScopeProps extends GenerativeUIOptions {
+    fallback?: GenerativeUIFallback;
+    loading?: ReactNode;
+    onError?: (error: unknown, item: GenerativeUIItem) => void;
+    children?: ReactNode;
+}
+/**
+ * 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, loading, onError, children, }: GenerativeUIScopeProps): React.JSX.Element;
+/** The headless half of {@link GenerativeUI}: what to draw for one pushed component, or `null` when `part` is not one. */
+declare function useGenerativeUI(part: unknown, options: GenerativeUIOptions): GenerativeUIState | null;
+interface GenerativeUIProps extends GenerativeUIOptions {
+    /** A transcript `ui` block, a `data-ui` message part, or a stored `{ id, component, props, version? }`. */
+    part: TranscriptUiBlock | GenerativeUIItem | unknown;
+    /** Drawn for an unknown component, invalid props, or a renderer that threw. Default: nothing. */
+    fallback?: GenerativeUIFallback;
+    /** Drawn while a resolver or an async validation is pending. Default: nothing. */
+    loading?: ReactNode;
+    /** A renderer threw (the item shows `fallback`). */
+    onError?: (error: unknown, item: GenerativeUIItem) => void;
+}
+/**
+ * Draws one server-pushed component with the app's own renderer. Headless: it adds no element and
+ * no style of its own — only what the registry's component renders (and whatever `fallback` /
+ * `loading` you pass).
+ *
+ * ```tsx
+ * <MessageItem message={m} renderUi={(block) => (
+ *   <GenerativeUI part={block} registry={registry} catalog={catalog} fallback={({ item }) => <Unknown name={item.component} />} />
+ * )} />
+ * ```
+ */
+declare function GenerativeUI({ part, registry, catalog, resolveComponent, fallback, loading, onError, }: 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;
+
+/**
+ * Normalize whatever carries a pushed component: a transcript `ui` block, a `data-ui` message part
+ * (`{ type: 'data-ui', id, data }`), a stored `{ id, component, props, version? }` entry. `null` for
+ * anything else.
+ */
+declare function toGenerativeUIItem(part: unknown): GenerativeUIItem | null;
+
+export { GenerativeUI, GenerativeUIElement, type GenerativeUIFallback, GenerativeUIItem, GenerativeUIOptions, GenerativeUIProblem, type GenerativeUIProps, GenerativeUIScope, type GenerativeUIScopeProps, GenerativeUIState, GenuiTree, toGenerativeUIItem, useGenerativeUI };

package/dist/genui.d.ts

@@ -0,0 +1,62 @@
+import * as React from 'react';
+import { ReactNode } from 'react';
+import { T as TranscriptUiBlock } from './model-CMNhyau6.js';
+import { G as GenerativeUIOptions, a as GenerativeUIItem, b as GenerativeUIProblem, c as GenerativeUIElement, d as GenerativeUIState } from './types-DFD-soWU.js';
+export { e as GENUI_TREE_COMPONENT, f as GenuiCatalogLike, g as GenuiIssueLike, h as GenuiRegistry, i as GenuiRenderer, R as ResolveComponent } from './types-DFD-soWU.js';
+import '@dudousxd/nestjs-agent-core';
+import 'ai';
+
+/** What to draw instead of a component that did not render. Default: nothing. */
+type GenerativeUIFallback = ReactNode | ((problem: GenerativeUIProblem) => ReactNode);
+/**
+ * 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 the registry
+ * overrides `genui:tree` (e.g. with the json-render adapter).
+ */
+declare function GenuiTree({ root }: {
+    root?: GenerativeUIElement;
+}): React.JSX.Element | null;
+interface GenerativeUIScopeProps extends GenerativeUIOptions {
+    fallback?: GenerativeUIFallback;
+    loading?: ReactNode;
+    onError?: (error: unknown, item: GenerativeUIItem) => void;
+    children?: ReactNode;
+}
+/**
+ * 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, loading, onError, children, }: GenerativeUIScopeProps): React.JSX.Element;
+/** The headless half of {@link GenerativeUI}: what to draw for one pushed component, or `null` when `part` is not one. */
+declare function useGenerativeUI(part: unknown, options: GenerativeUIOptions): GenerativeUIState | null;
+interface GenerativeUIProps extends GenerativeUIOptions {
+    /** A transcript `ui` block, a `data-ui` message part, or a stored `{ id, component, props, version? }`. */
+    part: TranscriptUiBlock | GenerativeUIItem | unknown;
+    /** Drawn for an unknown component, invalid props, or a renderer that threw. Default: nothing. */
+    fallback?: GenerativeUIFallback;
+    /** Drawn while a resolver or an async validation is pending. Default: nothing. */
+    loading?: ReactNode;
+    /** A renderer threw (the item shows `fallback`). */
+    onError?: (error: unknown, item: GenerativeUIItem) => void;
+}
+/**
+ * Draws one server-pushed component with the app's own renderer. Headless: it adds no element and
+ * no style of its own — only what the registry's component renders (and whatever `fallback` /
+ * `loading` you pass).
+ *
+ * ```tsx
+ * <MessageItem message={m} renderUi={(block) => (
+ *   <GenerativeUI part={block} registry={registry} catalog={catalog} fallback={({ item }) => <Unknown name={item.component} />} />
+ * )} />
+ * ```
+ */
+declare function GenerativeUI({ part, registry, catalog, resolveComponent, fallback, loading, onError, }: 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;
+
+/**
+ * Normalize whatever carries a pushed component: a transcript `ui` block, a `data-ui` message part
+ * (`{ type: 'data-ui', id, data }`), a stored `{ id, component, props, version? }` entry. `null` for
+ * anything else.
+ */
+declare function toGenerativeUIItem(part: unknown): GenerativeUIItem | null;
+
+export { GenerativeUI, GenerativeUIElement, type GenerativeUIFallback, GenerativeUIItem, GenerativeUIOptions, GenerativeUIProblem, type GenerativeUIProps, GenerativeUIScope, type GenerativeUIScopeProps, GenerativeUIState, GenuiTree, toGenerativeUIItem, useGenerativeUI };