@erdoai/ui 0.1.35 → 0.1.37

package/dist/index.d.cts

@@ -755,13 +755,13 @@ declare class ErrorBoundary extends React__default.Component<{
 }
 
 /**
- * Spinning loader shown while content is being written/generated.
+ * Bouncing dots loader shown while text is streaming.
  */
 declare function WritingLoader(): react_jsx_runtime.JSX.Element;
 /**
- * Bouncing dots loader shown while streaming content is being parsed.
+ * Centered spinner loader for charts/tables loading.
  */
-declare function StreamingLoader(): react_jsx_runtime.JSX.Element;
+declare function Loader(): react_jsx_runtime.JSX.Element;
 /** Props passed to all content components */
 interface ContentComponentProps {
     content: ContentItem;
@@ -1179,6 +1179,93 @@ interface DatasetDownloadProps {
  */
 declare function DatasetDownload({ slug, invocationId: _invocationId, threadId: threadIdProp, className, }: DatasetDownloadProps): react_jsx_runtime.JSX.Element | null;
 
+/** Node structure from UI generation content */
+interface UINode {
+    _type: string;
+    content?: Record<string, unknown>;
+}
+/** Props passed to node renderer components */
+interface NodeRendererProps {
+    node: UINode;
+    index: number;
+    className?: string;
+    invocationId?: string;
+    onSuggestionClick?: (suggestion: string) => void;
+}
+/** Chart node content structure */
+interface ChartNodeContent {
+    chart_type: string;
+    chart_title: string;
+    x_axis: ContentChartConfig['x_axis'];
+    y_axes: ContentChartConfig['y_axes'];
+    series: ContentChartConfig['series'];
+    data_reduction?: ContentChartConfig['data_reduction'];
+    stacked?: boolean;
+    sort?: ContentChartConfig['sort'];
+}
+/** Table node content structure */
+interface TableNodeContent {
+    table_title: string;
+    dataset_slug?: string;
+    columns: TableColumn[];
+}
+/** Text markdown node content structure */
+interface TextMarkdownNodeContent {
+    text?: string;
+}
+/** Download button node content structure */
+interface DownloadButtonNodeContent {
+    dataset_slug?: string;
+}
+/** Suggestions node content structure */
+interface SuggestionsNodeContent {
+    suggestions?: string[];
+}
+/** Default Chart node renderer */
+declare function DefaultChartNode({ node, index, className, invocationId }: NodeRendererProps): react_jsx_runtime.JSX.Element | null;
+/** Default Table node renderer */
+declare function DefaultTableNode({ node, index, className, invocationId }: NodeRendererProps): react_jsx_runtime.JSX.Element | null;
+/** Default TextMarkdown node renderer */
+declare function DefaultTextMarkdownNode({ node, index, className }: NodeRendererProps): react_jsx_runtime.JSX.Element;
+/** Default DownloadButton node renderer */
+declare function DefaultDownloadButtonNode({ node, index, className, invocationId }: NodeRendererProps): react_jsx_runtime.JSX.Element | null;
+/** Default Suggestions node renderer */
+declare function DefaultSuggestionsNode({ node, index, onSuggestionClick }: NodeRendererProps): react_jsx_runtime.JSX.Element | null;
+/** Default node components map */
+declare const defaultNodeComponents: Record<string, React__default.ComponentType<NodeRendererProps>>;
+interface UIGenerationNodesProps {
+    /** Array of UI nodes to render */
+    nodes: unknown[];
+    /** Optional class name for styling */
+    className?: string;
+    /** Invocation ID for dataset downloads */
+    invocationId?: string;
+    /** Callback when a suggestion is clicked */
+    onSuggestionClick?: (suggestion: string) => void;
+    /** Override default node renderers by type */
+    nodeComponents?: Record<string, React__default.ComponentType<NodeRendererProps>>;
+}
+/**
+ * Renders UI generation nodes with support for custom node renderers.
+ *
+ * @example
+ * ```tsx
+ * // Using default renderers
+ * <UIGenerationNodes nodes={content.children} invocationId={id} />
+ *
+ * // With custom chart renderer
+ * <UIGenerationNodes
+ *   nodes={content.children}
+ *   invocationId={id}
+ *   nodeComponents={{
+ *     Chart: MyCustomChartNode,
+ *     Table: MyCustomTableNode,
+ *   }}
+ * />
+ * ```
+ */
+declare function UIGenerationNodes({ nodes, className, invocationId, onSuggestionClick, nodeComponents, }: UIGenerationNodesProps): react_jsx_runtime.JSX.Element | null;
+
 interface ZoomState {
     refAreaLeft: number | null;
     refAreaRight: number | null;
@@ -1264,8 +1351,8 @@ interface UseThreadOptions {
     botKey?: string;
     /** Called for each SSE event received during streaming */
     onEvent?: (event: SSEEvent) => void;
-    /** Called when a message completes successfully */
-    onFinish?: () => void;
+    /** Called when a message completes successfully, with the final contents */
+    onFinish?: (contents: ContentItem[]) => void;
     /** Called if an error occurs */
     onError?: (error: Error) => void;
 }
@@ -1319,9 +1406,9 @@ interface UseThreadReturn {
  * ```tsx
  * const { streamingContents, sendMessage } = useThread({
  *   botKey: 'org.my-bot',
- *   onFinish: () => {
+ *   onFinish: (finalContents) => {
  *     // Save to your database when message completes
- *     await saveMessageToDb(threadId, streamingContents);
+ *     await saveMessageToDb(threadId, finalContents);
  *   },
  * });
  *
@@ -1352,7 +1439,7 @@ interface UseThreadReturn {
  * function MyChat() {
  *   const { isStreaming, streamingContents, sendMessage } = useThread({
  *     botKey: 'org.my-bot',
- *     onFinish: () => console.log('Message complete'),
+ *     onFinish: (finalContents) => console.log('Message complete with', finalContents.length, 'items'),
  *   });
  *
  *   return (
@@ -1500,4 +1587,4 @@ declare function handleIncrementalMixedJsonParsing(outputContent: MessageContent
  */
 declare function handleSSEEvent(eventType: string, event: SSEEventData, path: string[], threadID: string, activeMessagesByID: Record<string, MessageWithContents>, currentEntity?: Entity | null, parents?: Entity[], entityIds?: Record<string, string>): Entity | null;
 
-export { BarChart, type BaseChartProps, type BotInvocation, BotInvocationContent, type BotInvocationContentData, type BotInvocationContentProps, type BotInvocationData, type BotInvocationEventInfo, type BotInvocationStatusInfo, Chart, type ChartConfig, ChartContainer, ChartContent, type ChartContentProps, ChartLegend, ChartLegendContent, ChartStyle, ChartTooltip, ChartTooltipContent, CodeexecContent, type CodeexecContentProps, CodegenContent, type CodegenContentProps, CollapsibleCodeBlock, type CollapsibleCodeBlockProps, Content, type ContentChartConfig, type ContentChunk, type ContentComponentProps, type ContentProps, type ContentType, type DataFetcher, DatasetChart, type DatasetChartProps, type DatasetDetails, DatasetDownload, type DatasetDownloadProps, DatasetTable, type DatasetTableProps, type Entity, type EntityType, ErdoProvider, type ErdoProviderConfig, type ErdoProviderProps, ErdoUI, type ErdoUIProps, ErrorBoundary, ExecutionStatus, ExpandableOutputContent, type ExpandableOutputContentProps, HeatmapChart, InvocationEvent, type InvocationEventProps, InvocationEvents, type InvocationEventsProps, InvocationStatus, JSONStreamParser, type JSONValue, JsonContent, type JsonContentProps, LineChart, Log, LogContent, type LogContentProps, type LogProps, MarkdownContent, type MarkdownContentProps, type Message, type MessageContent, type MessageStreamingState, type MessageWithContents, type NullString, Output, type OutputContent, type OutputProps, type OutputWithContents, PieChart, type ResolvedBotInvocation, type ResultHandler, type SSEEventData, ScatterChart, type SpinnerStatus, SqlContent, type SqlContentProps, type Status, type StatusEvent, StatusSpinner, type StatusSpinnerProps, StderrText, StdoutText, StdwarnText, type Step, StepInvocation, type StepInvocationProps, StepInvocationStatus, type StepInvocationStatusProps, StreamingLoader, TableContent, type TableContentProps, TextContent, type TextContentProps, ThinkingContent, type ThinkingContentProps, ToolGroupContent, type ToolGroupContentProps, type UseThreadOptions, type UseThreadReturn, WebParseContent, type WebParseContentProps, WebSearchContent, type WebSearchContentProps, type WrapperType, WritingLoader, cn, extractContentItems, formatValue, handleIncrementalMixedJsonParsing, handleSSEEvent, isJsonLike, isNullString, isParsingComplete, isParsingInProgress, isWhitespaceChar, parseCompleteJson, parseMixedJson, parseToDate, resolveKeyFromData, toSnakeCase, unwrapNullString, unwrapNullStringOr, useChartZoom, useDatasetContents, useErdoConfig, useErdoConfigOptional, useMultipleDatasetContents, useThread };
+export { BarChart, type BaseChartProps, type BotInvocation, BotInvocationContent, type BotInvocationContentData, type BotInvocationContentProps, type BotInvocationData, type BotInvocationEventInfo, type BotInvocationStatusInfo, Chart, type ChartConfig, ChartContainer, ChartContent, type ChartContentProps, ChartLegend, ChartLegendContent, type ChartNodeContent, ChartStyle, ChartTooltip, ChartTooltipContent, CodeexecContent, type CodeexecContentProps, CodegenContent, type CodegenContentProps, CollapsibleCodeBlock, type CollapsibleCodeBlockProps, Content, type ContentChartConfig, type ContentChunk, type ContentComponentProps, type ContentProps, type ContentType, type DataFetcher, DatasetChart, type DatasetChartProps, type DatasetDetails, DatasetDownload, type DatasetDownloadProps, DatasetTable, type DatasetTableProps, DefaultChartNode, DefaultDownloadButtonNode, DefaultSuggestionsNode, DefaultTableNode, DefaultTextMarkdownNode, type DownloadButtonNodeContent, type Entity, type EntityType, ErdoProvider, type ErdoProviderConfig, type ErdoProviderProps, ErdoUI, type ErdoUIProps, ErrorBoundary, ExecutionStatus, ExpandableOutputContent, type ExpandableOutputContentProps, HeatmapChart, InvocationEvent, type InvocationEventProps, InvocationEvents, type InvocationEventsProps, InvocationStatus, JSONStreamParser, type JSONValue, JsonContent, type JsonContentProps, LineChart, Loader, Log, LogContent, type LogContentProps, type LogProps, MarkdownContent, type MarkdownContentProps, type Message, type MessageContent, type MessageStreamingState, type MessageWithContents, type NodeRendererProps, type NullString, Output, type OutputContent, type OutputProps, type OutputWithContents, PieChart, type ResolvedBotInvocation, type ResultHandler, type SSEEventData, ScatterChart, type SpinnerStatus, SqlContent, type SqlContentProps, type Status, type StatusEvent, StatusSpinner, type StatusSpinnerProps, StderrText, StdoutText, StdwarnText, type Step, StepInvocation, type StepInvocationProps, StepInvocationStatus, type StepInvocationStatusProps, type SuggestionsNodeContent, TableContent, type TableContentProps, type TableNodeContent, TextContent, type TextContentProps, type TextMarkdownNodeContent, ThinkingContent, type ThinkingContentProps, ToolGroupContent, type ToolGroupContentProps, UIGenerationNodes, type UIGenerationNodesProps, type UINode, type UseThreadOptions, type UseThreadReturn, WebParseContent, type WebParseContentProps, WebSearchContent, type WebSearchContentProps, type WrapperType, WritingLoader, cn, defaultNodeComponents, extractContentItems, formatValue, handleIncrementalMixedJsonParsing, handleSSEEvent, isJsonLike, isNullString, isParsingComplete, isParsingInProgress, isWhitespaceChar, parseCompleteJson, parseMixedJson, parseToDate, resolveKeyFromData, toSnakeCase, unwrapNullString, unwrapNullStringOr, useChartZoom, useDatasetContents, useErdoConfig, useErdoConfigOptional, useMultipleDatasetContents, useThread };

package/dist/index.d.ts

@@ -755,13 +755,13 @@ declare class ErrorBoundary extends React__default.Component<{
 }
 
 /**
- * Spinning loader shown while content is being written/generated.
+ * Bouncing dots loader shown while text is streaming.
  */
 declare function WritingLoader(): react_jsx_runtime.JSX.Element;
 /**
- * Bouncing dots loader shown while streaming content is being parsed.
+ * Centered spinner loader for charts/tables loading.
  */
-declare function StreamingLoader(): react_jsx_runtime.JSX.Element;
+declare function Loader(): react_jsx_runtime.JSX.Element;
 /** Props passed to all content components */
 interface ContentComponentProps {
     content: ContentItem;
@@ -1179,6 +1179,93 @@ interface DatasetDownloadProps {
  */
 declare function DatasetDownload({ slug, invocationId: _invocationId, threadId: threadIdProp, className, }: DatasetDownloadProps): react_jsx_runtime.JSX.Element | null;
 
+/** Node structure from UI generation content */
+interface UINode {
+    _type: string;
+    content?: Record<string, unknown>;
+}
+/** Props passed to node renderer components */
+interface NodeRendererProps {
+    node: UINode;
+    index: number;
+    className?: string;
+    invocationId?: string;
+    onSuggestionClick?: (suggestion: string) => void;
+}
+/** Chart node content structure */
+interface ChartNodeContent {
+    chart_type: string;
+    chart_title: string;
+    x_axis: ContentChartConfig['x_axis'];
+    y_axes: ContentChartConfig['y_axes'];
+    series: ContentChartConfig['series'];
+    data_reduction?: ContentChartConfig['data_reduction'];
+    stacked?: boolean;
+    sort?: ContentChartConfig['sort'];
+}
+/** Table node content structure */
+interface TableNodeContent {
+    table_title: string;
+    dataset_slug?: string;
+    columns: TableColumn[];
+}
+/** Text markdown node content structure */
+interface TextMarkdownNodeContent {
+    text?: string;
+}
+/** Download button node content structure */
+interface DownloadButtonNodeContent {
+    dataset_slug?: string;
+}
+/** Suggestions node content structure */
+interface SuggestionsNodeContent {
+    suggestions?: string[];
+}
+/** Default Chart node renderer */
+declare function DefaultChartNode({ node, index, className, invocationId }: NodeRendererProps): react_jsx_runtime.JSX.Element | null;
+/** Default Table node renderer */
+declare function DefaultTableNode({ node, index, className, invocationId }: NodeRendererProps): react_jsx_runtime.JSX.Element | null;
+/** Default TextMarkdown node renderer */
+declare function DefaultTextMarkdownNode({ node, index, className }: NodeRendererProps): react_jsx_runtime.JSX.Element;
+/** Default DownloadButton node renderer */
+declare function DefaultDownloadButtonNode({ node, index, className, invocationId }: NodeRendererProps): react_jsx_runtime.JSX.Element | null;
+/** Default Suggestions node renderer */
+declare function DefaultSuggestionsNode({ node, index, onSuggestionClick }: NodeRendererProps): react_jsx_runtime.JSX.Element | null;
+/** Default node components map */
+declare const defaultNodeComponents: Record<string, React__default.ComponentType<NodeRendererProps>>;
+interface UIGenerationNodesProps {
+    /** Array of UI nodes to render */
+    nodes: unknown[];
+    /** Optional class name for styling */
+    className?: string;
+    /** Invocation ID for dataset downloads */
+    invocationId?: string;
+    /** Callback when a suggestion is clicked */
+    onSuggestionClick?: (suggestion: string) => void;
+    /** Override default node renderers by type */
+    nodeComponents?: Record<string, React__default.ComponentType<NodeRendererProps>>;
+}
+/**
+ * Renders UI generation nodes with support for custom node renderers.
+ *
+ * @example
+ * ```tsx
+ * // Using default renderers
+ * <UIGenerationNodes nodes={content.children} invocationId={id} />
+ *
+ * // With custom chart renderer
+ * <UIGenerationNodes
+ *   nodes={content.children}
+ *   invocationId={id}
+ *   nodeComponents={{
+ *     Chart: MyCustomChartNode,
+ *     Table: MyCustomTableNode,
+ *   }}
+ * />
+ * ```
+ */
+declare function UIGenerationNodes({ nodes, className, invocationId, onSuggestionClick, nodeComponents, }: UIGenerationNodesProps): react_jsx_runtime.JSX.Element | null;
+
 interface ZoomState {
     refAreaLeft: number | null;
     refAreaRight: number | null;
@@ -1264,8 +1351,8 @@ interface UseThreadOptions {
     botKey?: string;
     /** Called for each SSE event received during streaming */
     onEvent?: (event: SSEEvent) => void;
-    /** Called when a message completes successfully */
-    onFinish?: () => void;
+    /** Called when a message completes successfully, with the final contents */
+    onFinish?: (contents: ContentItem[]) => void;
     /** Called if an error occurs */
     onError?: (error: Error) => void;
 }
@@ -1319,9 +1406,9 @@ interface UseThreadReturn {
  * ```tsx
  * const { streamingContents, sendMessage } = useThread({
  *   botKey: 'org.my-bot',
- *   onFinish: () => {
+ *   onFinish: (finalContents) => {
  *     // Save to your database when message completes
- *     await saveMessageToDb(threadId, streamingContents);
+ *     await saveMessageToDb(threadId, finalContents);
  *   },
  * });
  *
@@ -1352,7 +1439,7 @@ interface UseThreadReturn {
  * function MyChat() {
  *   const { isStreaming, streamingContents, sendMessage } = useThread({
  *     botKey: 'org.my-bot',
- *     onFinish: () => console.log('Message complete'),
+ *     onFinish: (finalContents) => console.log('Message complete with', finalContents.length, 'items'),
  *   });
  *
  *   return (
@@ -1500,4 +1587,4 @@ declare function handleIncrementalMixedJsonParsing(outputContent: MessageContent
  */
 declare function handleSSEEvent(eventType: string, event: SSEEventData, path: string[], threadID: string, activeMessagesByID: Record<string, MessageWithContents>, currentEntity?: Entity | null, parents?: Entity[], entityIds?: Record<string, string>): Entity | null;
 
-export { BarChart, type BaseChartProps, type BotInvocation, BotInvocationContent, type BotInvocationContentData, type BotInvocationContentProps, type BotInvocationData, type BotInvocationEventInfo, type BotInvocationStatusInfo, Chart, type ChartConfig, ChartContainer, ChartContent, type ChartContentProps, ChartLegend, ChartLegendContent, ChartStyle, ChartTooltip, ChartTooltipContent, CodeexecContent, type CodeexecContentProps, CodegenContent, type CodegenContentProps, CollapsibleCodeBlock, type CollapsibleCodeBlockProps, Content, type ContentChartConfig, type ContentChunk, type ContentComponentProps, type ContentProps, type ContentType, type DataFetcher, DatasetChart, type DatasetChartProps, type DatasetDetails, DatasetDownload, type DatasetDownloadProps, DatasetTable, type DatasetTableProps, type Entity, type EntityType, ErdoProvider, type ErdoProviderConfig, type ErdoProviderProps, ErdoUI, type ErdoUIProps, ErrorBoundary, ExecutionStatus, ExpandableOutputContent, type ExpandableOutputContentProps, HeatmapChart, InvocationEvent, type InvocationEventProps, InvocationEvents, type InvocationEventsProps, InvocationStatus, JSONStreamParser, type JSONValue, JsonContent, type JsonContentProps, LineChart, Log, LogContent, type LogContentProps, type LogProps, MarkdownContent, type MarkdownContentProps, type Message, type MessageContent, type MessageStreamingState, type MessageWithContents, type NullString, Output, type OutputContent, type OutputProps, type OutputWithContents, PieChart, type ResolvedBotInvocation, type ResultHandler, type SSEEventData, ScatterChart, type SpinnerStatus, SqlContent, type SqlContentProps, type Status, type StatusEvent, StatusSpinner, type StatusSpinnerProps, StderrText, StdoutText, StdwarnText, type Step, StepInvocation, type StepInvocationProps, StepInvocationStatus, type StepInvocationStatusProps, StreamingLoader, TableContent, type TableContentProps, TextContent, type TextContentProps, ThinkingContent, type ThinkingContentProps, ToolGroupContent, type ToolGroupContentProps, type UseThreadOptions, type UseThreadReturn, WebParseContent, type WebParseContentProps, WebSearchContent, type WebSearchContentProps, type WrapperType, WritingLoader, cn, extractContentItems, formatValue, handleIncrementalMixedJsonParsing, handleSSEEvent, isJsonLike, isNullString, isParsingComplete, isParsingInProgress, isWhitespaceChar, parseCompleteJson, parseMixedJson, parseToDate, resolveKeyFromData, toSnakeCase, unwrapNullString, unwrapNullStringOr, useChartZoom, useDatasetContents, useErdoConfig, useErdoConfigOptional, useMultipleDatasetContents, useThread };
+export { BarChart, type BaseChartProps, type BotInvocation, BotInvocationContent, type BotInvocationContentData, type BotInvocationContentProps, type BotInvocationData, type BotInvocationEventInfo, type BotInvocationStatusInfo, Chart, type ChartConfig, ChartContainer, ChartContent, type ChartContentProps, ChartLegend, ChartLegendContent, type ChartNodeContent, ChartStyle, ChartTooltip, ChartTooltipContent, CodeexecContent, type CodeexecContentProps, CodegenContent, type CodegenContentProps, CollapsibleCodeBlock, type CollapsibleCodeBlockProps, Content, type ContentChartConfig, type ContentChunk, type ContentComponentProps, type ContentProps, type ContentType, type DataFetcher, DatasetChart, type DatasetChartProps, type DatasetDetails, DatasetDownload, type DatasetDownloadProps, DatasetTable, type DatasetTableProps, DefaultChartNode, DefaultDownloadButtonNode, DefaultSuggestionsNode, DefaultTableNode, DefaultTextMarkdownNode, type DownloadButtonNodeContent, type Entity, type EntityType, ErdoProvider, type ErdoProviderConfig, type ErdoProviderProps, ErdoUI, type ErdoUIProps, ErrorBoundary, ExecutionStatus, ExpandableOutputContent, type ExpandableOutputContentProps, HeatmapChart, InvocationEvent, type InvocationEventProps, InvocationEvents, type InvocationEventsProps, InvocationStatus, JSONStreamParser, type JSONValue, JsonContent, type JsonContentProps, LineChart, Loader, Log, LogContent, type LogContentProps, type LogProps, MarkdownContent, type MarkdownContentProps, type Message, type MessageContent, type MessageStreamingState, type MessageWithContents, type NodeRendererProps, type NullString, Output, type OutputContent, type OutputProps, type OutputWithContents, PieChart, type ResolvedBotInvocation, type ResultHandler, type SSEEventData, ScatterChart, type SpinnerStatus, SqlContent, type SqlContentProps, type Status, type StatusEvent, StatusSpinner, type StatusSpinnerProps, StderrText, StdoutText, StdwarnText, type Step, StepInvocation, type StepInvocationProps, StepInvocationStatus, type StepInvocationStatusProps, type SuggestionsNodeContent, TableContent, type TableContentProps, type TableNodeContent, TextContent, type TextContentProps, type TextMarkdownNodeContent, ThinkingContent, type ThinkingContentProps, ToolGroupContent, type ToolGroupContentProps, UIGenerationNodes, type UIGenerationNodesProps, type UINode, type UseThreadOptions, type UseThreadReturn, WebParseContent, type WebParseContentProps, WebSearchContent, type WebSearchContentProps, type WrapperType, WritingLoader, cn, defaultNodeComponents, extractContentItems, formatValue, handleIncrementalMixedJsonParsing, handleSSEEvent, isJsonLike, isNullString, isParsingComplete, isParsingInProgress, isWhitespaceChar, parseCompleteJson, parseMixedJson, parseToDate, resolveKeyFromData, toSnakeCase, unwrapNullString, unwrapNullStringOr, useChartZoom, useDatasetContents, useErdoConfig, useErdoConfigOptional, useMultipleDatasetContents, useThread };