import type { ActionEvent, OpenUIError, ParseResult, ToolProvider } from '@openuidev/lang-core'; import type React from 'react'; import type { OpenUIContextValue } from '../context.jsx'; import type { Library } from '../library.jsx'; /** Prefetched Query results keyed by Query assignment name (statement ID). */ export type InitialQueryResults = Readonly>; /** Inputs used to parse OpenUI text and build renderer state. */ export interface UseOpenUIStateOptions { response: string | null; library: Library; isStreaming: boolean; onAction?: (event: ActionEvent) => void; onStateUpdate?: (state: Record) => void; initialState?: Record; /** * Prefetched Query results keyed by the Query assignment name (statement ID). * They are available during the initial render and act as fallbacks while an * optional tool provider revalidates them after commit. */ initialQueryResults?: InitialQueryResults; /** ToolProvider for Query data fetching — MCP, REST, GraphQL, or any backend. */ toolProvider?: ToolProvider | null; /** Callback for structured, LLM-friendly errors. See OpenUIError type. */ onError?: (errors: OpenUIError[]) => void; } /** * Derived OpenUI renderer state returned by `useOpenUIState`. */ export interface OpenUIState { /** Evaluated result (props resolved to concrete values). Used by Renderer. */ result: ParseResult | null; /** Raw parse result (AST nodes in props). Used by onParseResult callback. */ parseResult: ParseResult | null; contextValue: OpenUIContextValue; /** Whether any Query is currently fetching data. */ isQueryLoading: boolean; } /** * Core state hook — extracts all form state, action handling, parser * management, and context assembly out of the Renderer component. * * Store holds everything: $bindings as top-level keys, form fields nested * under formName as plain values. */ export declare function useOpenUIState({ response, library, isStreaming, onAction, onStateUpdate, initialState, initialQueryResults, toolProvider, onError, }: UseOpenUIStateOptions, renderDeep: (value: unknown) => React.ReactNode): OpenUIState;