autoui-react 0.0.3-alpha → 0.0.4-alpha

package/dist/index.d.ts

@@ -12,80 +12,77 @@ type UIEventType = z.infer<typeof uiEventType>;
 declare const uiEvent: z.ZodObject<{
     type: z.ZodEnum<["CLICK", "CHANGE", "SUBMIT", "MOUSEOVER", "MOUSEOUT", "FOCUS", "BLUR"]>;
     nodeId: z.ZodString;
-    timestamp: z.ZodOptional<z.ZodNumber>;
-    payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    timestamp: z.ZodNullable<z.ZodNumber>;
+    payload: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
     type: "CLICK" | "CHANGE" | "SUBMIT" | "MOUSEOVER" | "MOUSEOUT" | "FOCUS" | "BLUR";
     nodeId: string;
-    timestamp?: number | undefined;
-    payload?: Record<string, any> | undefined;
+    timestamp: number | null;
+    payload: Record<string, unknown> | null;
 }, {
     type: "CLICK" | "CHANGE" | "SUBMIT" | "MOUSEOVER" | "MOUSEOUT" | "FOCUS" | "BLUR";
     nodeId: string;
-    timestamp?: number | undefined;
-    payload?: Record<string, any> | undefined;
+    timestamp: number | null;
+    payload: Record<string, unknown> | null;
 }>;
 type UIEvent = z.infer<typeof uiEvent>;
-/**
- * Core UI specification node
- * Represents a single element in the UI tree
- */
-declare const uiSpecNode: z.ZodType<UISpecNode>;
-type UISpecNode = {
+interface UISpecNodeInterface {
     id: string;
-    type: string;
-    props?: Record<string, any> | undefined;
-    bindings?: Record<string, any> | undefined;
-    events?: Record<string, {
+    node_type: string;
+    props: Record<string, any> | null;
+    bindings: Record<string, any> | null;
+    events: Record<string, {
         action: string;
-        target?: string | undefined;
-        payload?: Record<string, any> | undefined;
-    }> | undefined;
-    children?: UISpecNode[] | undefined;
-};
+        target: string;
+        payload: Record<string, any> | null;
+    }> | null;
+    children: UISpecNodeInterface[] | null;
+}
+declare const uiSpecNode: z.ZodType<UISpecNodeInterface>;
+type UISpecNode = z.infer<typeof uiSpecNode>;
 /**
  * Application state for the UI engine
  */
 declare const uiState: z.ZodObject<{
-    layout: z.ZodOptional<z.ZodType<UISpecNode, z.ZodTypeDef, UISpecNode>>;
+    layout: z.ZodNullable<z.ZodType<UISpecNodeInterface, z.ZodTypeDef, UISpecNodeInterface>>;
     loading: z.ZodBoolean;
     history: z.ZodArray<z.ZodObject<{
         type: z.ZodEnum<["CLICK", "CHANGE", "SUBMIT", "MOUSEOVER", "MOUSEOUT", "FOCUS", "BLUR"]>;
         nodeId: z.ZodString;
-        timestamp: z.ZodOptional<z.ZodNumber>;
-        payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        timestamp: z.ZodNullable<z.ZodNumber>;
+        payload: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strip", z.ZodTypeAny, {
         type: "CLICK" | "CHANGE" | "SUBMIT" | "MOUSEOVER" | "MOUSEOUT" | "FOCUS" | "BLUR";
         nodeId: string;
-        timestamp?: number | undefined;
-        payload?: Record<string, any> | undefined;
+        timestamp: number | null;
+        payload: Record<string, unknown> | null;
     }, {
         type: "CLICK" | "CHANGE" | "SUBMIT" | "MOUSEOVER" | "MOUSEOUT" | "FOCUS" | "BLUR";
         nodeId: string;
-        timestamp?: number | undefined;
-        payload?: Record<string, any> | undefined;
+        timestamp: number | null;
+        payload: Record<string, unknown> | null;
     }>, "many">;
-    error: z.ZodOptional<z.ZodString>;
+    error: z.ZodNullable<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
+    layout: UISpecNodeInterface | null;
     loading: boolean;
     history: {
         type: "CLICK" | "CHANGE" | "SUBMIT" | "MOUSEOVER" | "MOUSEOUT" | "FOCUS" | "BLUR";
         nodeId: string;
-        timestamp?: number | undefined;
-        payload?: Record<string, any> | undefined;
+        timestamp: number | null;
+        payload: Record<string, unknown> | null;
     }[];
-    layout?: UISpecNode | undefined;
-    error?: string | undefined;
+    error: string | null;
 }, {
+    layout: UISpecNodeInterface | null;
     loading: boolean;
     history: {
         type: "CLICK" | "CHANGE" | "SUBMIT" | "MOUSEOVER" | "MOUSEOUT" | "FOCUS" | "BLUR";
         nodeId: string;
-        timestamp?: number | undefined;
-        payload?: Record<string, any> | undefined;
+        timestamp: number | null;
+        payload: Record<string, unknown> | null;
     }[];
-    layout?: UISpecNode | undefined;
-    error?: string | undefined;
+    error: string | null;
 }>;
 type UIState = z.infer<typeof uiState>;
 /**
@@ -94,43 +91,43 @@ type UIState = z.infer<typeof uiState>;
 declare const plannerInput: z.ZodObject<{
     schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     goal: z.ZodString;
-    history: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    history: z.ZodNullable<z.ZodArray<z.ZodObject<{
         type: z.ZodEnum<["CLICK", "CHANGE", "SUBMIT", "MOUSEOVER", "MOUSEOUT", "FOCUS", "BLUR"]>;
         nodeId: z.ZodString;
-        timestamp: z.ZodOptional<z.ZodNumber>;
-        payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        timestamp: z.ZodNullable<z.ZodNumber>;
+        payload: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strip", z.ZodTypeAny, {
         type: "CLICK" | "CHANGE" | "SUBMIT" | "MOUSEOVER" | "MOUSEOUT" | "FOCUS" | "BLUR";
         nodeId: string;
-        timestamp?: number | undefined;
-        payload?: Record<string, any> | undefined;
+        timestamp: number | null;
+        payload: Record<string, unknown> | null;
     }, {
         type: "CLICK" | "CHANGE" | "SUBMIT" | "MOUSEOVER" | "MOUSEOUT" | "FOCUS" | "BLUR";
         nodeId: string;
-        timestamp?: number | undefined;
-        payload?: Record<string, any> | undefined;
+        timestamp: number | null;
+        payload: Record<string, unknown> | null;
     }>, "many">>;
-    userContext: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    userContext: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
 }, "strip", z.ZodTypeAny, {
-    schema: Record<string, unknown>;
-    goal: string;
-    history?: {
+    history: {
         type: "CLICK" | "CHANGE" | "SUBMIT" | "MOUSEOVER" | "MOUSEOUT" | "FOCUS" | "BLUR";
         nodeId: string;
-        timestamp?: number | undefined;
-        payload?: Record<string, any> | undefined;
-    }[] | undefined;
-    userContext?: Record<string, unknown> | undefined;
-}, {
+        timestamp: number | null;
+        payload: Record<string, unknown> | null;
+    }[] | null;
     schema: Record<string, unknown>;
     goal: string;
-    history?: {
+    userContext?: Record<string, unknown> | null | undefined;
+}, {
+    history: {
         type: "CLICK" | "CHANGE" | "SUBMIT" | "MOUSEOVER" | "MOUSEOUT" | "FOCUS" | "BLUR";
         nodeId: string;
-        timestamp?: number | undefined;
-        payload?: Record<string, any> | undefined;
-    }[] | undefined;
-    userContext?: Record<string, unknown> | undefined;
+        timestamp: number | null;
+        payload: Record<string, unknown> | null;
+    }[] | null;
+    schema: Record<string, unknown>;
+    goal: string;
+    userContext?: Record<string, unknown> | null | undefined;
 }>;
 type PlannerInput = z.infer<typeof plannerInput>;
 
@@ -190,7 +187,7 @@ declare class ActionRouter {
      * @param dataContext - Current data context
      * @returns Route resolution or null if no match
      */
-    resolveRoute(event: UIEvent, schema: Record<string, unknown>, layout: UISpecNode | undefined, dataContext: DataContext, goal: string, userContext?: Record<string, unknown>): RouteResolution | null;
+    resolveRoute(event: UIEvent, schema: Record<string, unknown>, layout: UISpecNode | null, dataContext: DataContext, goal: string, userContext?: Record<string, unknown>): RouteResolution | null;
     /**
      * Process a prompt template with variables
      * @param template - Template string with ${var} placeholders
@@ -229,7 +226,7 @@ type EventHook = (context: EventHookContext) => void | Promise<void>;
  * });
  * ```
  */
-declare function createEventHook(eventTypes: UIEventType[] | 'all', hook: EventHook, options?: EventHookOptions): EventHook;
+declare function createEventHook(eventTypes: UIEventType[] | "all", hook: EventHook, options?: EventHookOptions): EventHook;
 
 /**
  * System event types that represent the internal AutoUI lifecycle
@@ -370,7 +367,7 @@ declare const systemEvents: SystemEventManager;
  */
 declare function createSystemEvent<T extends SystemEventType>(type: T, data: Omit<Extract<AnySystemEvent, {
     type: T;
-}>, 'type' | 'timestamp'>): Extract<AnySystemEvent, {
+}>, "type" | "timestamp">): Extract<AnySystemEvent, {
     type: T;
 }>;
 
@@ -453,10 +450,10 @@ interface SchemaAdapter {
  * Schema adapter options union type
  */
 type SchemaAdapterOptions = {
-    type: 'drizzle';
+    type: "drizzle";
     options: DrizzleAdapterOptions$1;
 } | {
-    type: 'custom';
+    type: "custom";
     adapter: SchemaAdapter;
 };
 /**
@@ -469,14 +466,14 @@ interface DrizzleAdapterOptions {
 }
 interface AutoUIProps {
     schema: Record<string, unknown> | {
-        type: 'drizzle';
+        type: "drizzle";
         options: DrizzleAdapterOptions;
     } | {
-        type: 'custom';
+        type: "custom";
         adapter: SchemaAdapter;
     };
     goal: string;
-    componentAdapter?: 'shadcn';
+    componentAdapter?: "shadcn";
     userContext?: Record<string, unknown>;
     onEvent?: (evt: UIEvent) => void;
     eventHooks?: {
@@ -494,13 +491,13 @@ interface AutoUIProps {
         enableFormNavigation?: boolean;
     };
     integration?: {
-        mode?: 'standalone' | 'component';
+        mode?: "standalone" | "component";
         className?: string;
         style?: React.CSSProperties;
         id?: string;
     };
     scope?: {
-        type?: 'form' | 'list' | 'detail' | 'dashboard' | 'full-page' | 'card';
+        type?: "form" | "list" | "detail" | "dashboard" | "full-page" | "card";
         focus?: string;
     };
     debugMode?: boolean;
@@ -533,14 +530,39 @@ interface AutoUIProps {
 declare const AutoUI: React.FC<AutoUIProps>;
 
 /**
- * Example function to generate text using the AI SDK
- *
- * Note: You need to set OPENAI_API_KEY environment variable
- * or use another supported provider
+ * AI Utilities for AutoUI React
+ * Provides AI-powered UI generation functionality
  */
-declare function generateComponent(schema: any): Promise<string>;
+/**
+ * Generates a component using AI
+ */
+declare const generateComponent: (prompt: string) => Promise<string>;
+/**
+ * Generates a UI description using AI
+ */
+declare const generateUIDescription: (prompt: string) => Promise<string>;
+/**
+ * Generates a UI component using AI
+ */
+declare const generateUIComponent: (prompt: string) => Promise<string>;
 
-declare function generateUIDescription(schema: any): Promise<string>;
-declare function generateUIComponent(schema: any): Promise<string>;
+interface UsePlannerOptions {
+    goal: string;
+    schema: Record<string, unknown>;
+    userContext?: Record<string, unknown>;
+    router?: ActionRouter;
+    modelProvider?: unknown;
+}
+interface UsePlannerResult {
+    layout: UISpecNode | undefined;
+    loading: boolean;
+    error: Error | null;
+    handleEvent: (event: UIEvent) => Promise<void>;
+    generateInitialLayout: () => Promise<void>;
+}
+/**
+ * React hook for utilizing the AI planner functionality
+ */
+declare function usePlanner(options: UsePlannerOptions): UsePlannerResult;
 
-export { ActionRouteConfig, ActionRouter, ActionType, AnySystemEvent, AutoUI, AutoUIProps, DrizzleAdapter, DrizzleAdapterOptions$1 as DrizzleAdapterOptions, EventHook, EventHookContext, EventHookOptions, PlannerInput, SchemaAdapter, SchemaAdapterOptions, SystemEventHook, SystemEventType, UIEvent, UIEventType, UISpecNode, UIState, createDefaultRouter, createEventHook, createSchemaAdapter, createSystemEvent, generateComponent, generateUIComponent, generateUIDescription, systemEvents, uiEvent, uiEventType, uiSpecNode };
+export { ActionRouteConfig, ActionRouter, ActionType, AnySystemEvent, AutoUI, AutoUIProps, DrizzleAdapter, DrizzleAdapterOptions$1 as DrizzleAdapterOptions, EventHook, EventHookContext, EventHookOptions, PlannerInput, SchemaAdapter, SchemaAdapterOptions, SystemEventHook, SystemEventType, UIEvent, UIEventType, UISpecNode, UIState, createDefaultRouter, createEventHook, createSchemaAdapter, createSystemEvent, generateComponent, generateUIComponent, generateUIDescription, systemEvents, uiEvent, uiEventType, uiSpecNode, usePlanner };