@dudousxd/nestjs-agent-react 0.34.5 → 0.35.1

package/dist/{react-registry-z9GFbTm9.d.ts → react-registry-CC84Jm3U.d.ts}

@@ -1,7 +1,7 @@
 import * as _dudousxd_nestjs_agent_core_genui from '@dudousxd/nestjs-agent-core/genui';
 import { CatalogOptions, ComponentPresentation, ComponentDefinition } from '@dudousxd/nestjs-agent-core/genui';
 import { ComponentType, ReactNode } from 'react';
-import { h as GenuiRegistry } from './types-DZtFsWec.js';
+import { j as GenuiRegistry } from './types-COuArD3c.js';
 
 interface ReactComponentRenderers<P extends object> {
     react?: ComponentType<P>;

package/dist/{react-registry-Di4IVrw-.d.cts → react-registry-R0eFtDCG.d.cts}

@@ -1,7 +1,7 @@
 import * as _dudousxd_nestjs_agent_core_genui from '@dudousxd/nestjs-agent-core/genui';
 import { CatalogOptions, ComponentPresentation, ComponentDefinition } from '@dudousxd/nestjs-agent-core/genui';
 import { ComponentType, ReactNode } from 'react';
-import { h as GenuiRegistry } from './types-DZtFsWec.cjs';
+import { j as GenuiRegistry } from './types-COuArD3c.cjs';
 
 interface ReactComponentRenderers<P extends object> {
     react?: ComponentType<P>;

package/dist/{types-DZtFsWec.d.cts → types-COuArD3c.d.cts}

@@ -11,12 +11,40 @@ interface GenerativeUIItem {
     props: Record<string, unknown>;
     version: number | null;
     toolCallId: string | null;
+    /**
+     * A preview drawn while the model is still writing the call (genui `streaming: 'partial'`):
+     * unvalidated, and replaced in place by the final frame under the same `id`.
+     */
+    partial?: true;
 }
 /** A node of a composed tree (`genui:tree` frames): `{ type, props, children? }`. */
 interface GenerativeUIElement {
     type: string;
     props: Record<string, unknown>;
     children?: GenerativeUIElement[];
+    /**
+     * The node's position (`root`, `root.0`, `root.0.2`), carried by partial frames. Stable as the
+     * tree grows, and the same rule names the final tree's nodes.
+     */
+    id?: string;
+    /** Partial frames only: the model has not finished writing this node. */
+    incomplete?: true;
+    /** Partial frames only: a `streaming: 'complete'` component held back until it closes (no props). */
+    held?: true;
+}
+/**
+ * What a tree node's renderer can learn about its node ({@link useGenuiNode}): which node it is,
+ * and whether the model is still writing it. Room is left for more states (data a node is bound
+ * to, loading) as separate fields — `incomplete` only ever means "still being written".
+ */
+interface GenuiNodeState {
+    /** The node's position id (`root`, `root.1.0`): stable from the first preview to the final frame. */
+    id: string;
+    type: string;
+    /** The model has not finished writing this node: props (and children) may still grow. */
+    incomplete: boolean;
+    /** The node is a placeholder for a component that is only drawn whole (`streaming: 'complete'`). */
+    held: boolean;
 }
 /**
  * An app's renderer for one component: it receives the component's props spread, plus `children`
@@ -71,6 +99,11 @@ interface GenerativeUIOptions {
         root?: GenerativeUIElement;
     }>;
 }
+/**
+ * Drawn in place of a tree node that is not drawable yet — a `held` node (its component streams
+ * `complete`) while the model writes it. Default: the `loading` element.
+ */
+type GenuiPlaceholder = ReactNode | ((node: GenuiNodeState) => ReactNode);
 /** Why an item did not render. */
 type GenerativeUIProblem = {
     reason: 'unknown';
@@ -96,4 +129,4 @@ type GenerativeUIState = {
     status: 'problem';
 } & GenerativeUIProblem);
 
-export { type GenerativeUIItem as G, type ResolveComponent as R, GENUI_TREE_COMPONENT as a, type GenerativeUIElement as b, type GenerativeUIOptions as c, type GenerativeUIProblem as d, type GenerativeUIState as e, type GenuiCatalogLike as f, type GenuiIssueLike as g, type GenuiRegistry as h, type GenuiRenderer as i };
+export { type GenerativeUIItem as G, type ResolveComponent as R, GENUI_TREE_COMPONENT as a, type GenerativeUIElement as b, type GenerativeUIOptions as c, type GenerativeUIProblem as d, type GenerativeUIState as e, type GenuiCatalogLike as f, type GenuiIssueLike as g, type GenuiNodeState as h, type GenuiPlaceholder as i, type GenuiRegistry as j, type GenuiRenderer as k };

package/dist/{types-DZtFsWec.d.ts → types-COuArD3c.d.ts}

@@ -11,12 +11,40 @@ interface GenerativeUIItem {
     props: Record<string, unknown>;
     version: number | null;
     toolCallId: string | null;
+    /**
+     * A preview drawn while the model is still writing the call (genui `streaming: 'partial'`):
+     * unvalidated, and replaced in place by the final frame under the same `id`.
+     */
+    partial?: true;
 }
 /** A node of a composed tree (`genui:tree` frames): `{ type, props, children? }`. */
 interface GenerativeUIElement {
     type: string;
     props: Record<string, unknown>;
     children?: GenerativeUIElement[];
+    /**
+     * The node's position (`root`, `root.0`, `root.0.2`), carried by partial frames. Stable as the
+     * tree grows, and the same rule names the final tree's nodes.
+     */
+    id?: string;
+    /** Partial frames only: the model has not finished writing this node. */
+    incomplete?: true;
+    /** Partial frames only: a `streaming: 'complete'` component held back until it closes (no props). */
+    held?: true;
+}
+/**
+ * What a tree node's renderer can learn about its node ({@link useGenuiNode}): which node it is,
+ * and whether the model is still writing it. Room is left for more states (data a node is bound
+ * to, loading) as separate fields — `incomplete` only ever means "still being written".
+ */
+interface GenuiNodeState {
+    /** The node's position id (`root`, `root.1.0`): stable from the first preview to the final frame. */
+    id: string;
+    type: string;
+    /** The model has not finished writing this node: props (and children) may still grow. */
+    incomplete: boolean;
+    /** The node is a placeholder for a component that is only drawn whole (`streaming: 'complete'`). */
+    held: boolean;
 }
 /**
  * An app's renderer for one component: it receives the component's props spread, plus `children`
@@ -71,6 +99,11 @@ interface GenerativeUIOptions {
         root?: GenerativeUIElement;
     }>;
 }
+/**
+ * Drawn in place of a tree node that is not drawable yet — a `held` node (its component streams
+ * `complete`) while the model writes it. Default: the `loading` element.
+ */
+type GenuiPlaceholder = ReactNode | ((node: GenuiNodeState) => ReactNode);
 /** Why an item did not render. */
 type GenerativeUIProblem = {
     reason: 'unknown';
@@ -96,4 +129,4 @@ type GenerativeUIState = {
     status: 'problem';
 } & GenerativeUIProblem);
 
-export { type GenerativeUIItem as G, type ResolveComponent as R, GENUI_TREE_COMPONENT as a, type GenerativeUIElement as b, type GenerativeUIOptions as c, type GenerativeUIProblem as d, type GenerativeUIState as e, type GenuiCatalogLike as f, type GenuiIssueLike as g, type GenuiRegistry as h, type GenuiRenderer as i };
+export { type GenerativeUIItem as G, type ResolveComponent as R, GENUI_TREE_COMPONENT as a, type GenerativeUIElement as b, type GenerativeUIOptions as c, type GenerativeUIProblem as d, type GenerativeUIState as e, type GenuiCatalogLike as f, type GenuiIssueLike as g, type GenuiNodeState as h, type GenuiPlaceholder as i, type GenuiRegistry as j, type GenuiRenderer as k };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dudousxd/nestjs-agent-react",
-  "version": "0.34.5",
+  "version": "0.35.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/DavideCarvalho/nestjs-agent.git",
@@ -103,7 +103,7 @@
     "dist"
   ],
   "dependencies": {
-    "@dudousxd/nestjs-agent-core": "0.44.1"
+    "@dudousxd/nestjs-agent-core": "0.45.1"
   },
   "peerDependencies": {
     "@ai-sdk/react": "^4.0.0",