autoui-react 0.0.5-alpha → 0.1.0

package/dist/index.d.ts

@@ -4,85 +4,88 @@ import React from 'react';
 /**
  * Event types that can be triggered by UI elements
  */
-declare const uiEventType: z.ZodEnum<["INIT", "CLICK", "CHANGE", "SUBMIT", "MOUSEOVER", "MOUSEOUT", "FOCUS", "BLUR"]>;
+declare const uiEventType: z.ZodEnum<["CLICK", "CHANGE", "SUBMIT", "MOUSEOVER", "MOUSEOUT", "FOCUS", "BLUR"]>;
 type UIEventType = z.infer<typeof uiEventType>;
 /**
  * Event payload schema
  */
 declare const uiEvent: z.ZodObject<{
-    type: z.ZodEnum<["INIT", "CLICK", "CHANGE", "SUBMIT", "MOUSEOVER", "MOUSEOUT", "FOCUS", "BLUR"]>;
+    type: z.ZodEnum<["CLICK", "CHANGE", "SUBMIT", "MOUSEOVER", "MOUSEOUT", "FOCUS", "BLUR"]>;
     nodeId: z.ZodString;
-    timestamp: z.ZodNullable<z.ZodNumber>;
-    payload: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+    payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
 }, "strip", z.ZodTypeAny, {
-    type: "INIT" | "CLICK" | "CHANGE" | "SUBMIT" | "MOUSEOVER" | "MOUSEOUT" | "FOCUS" | "BLUR";
+    type: "CLICK" | "CHANGE" | "SUBMIT" | "MOUSEOVER" | "MOUSEOUT" | "FOCUS" | "BLUR";
     nodeId: string;
-    timestamp: number | null;
-    payload: Record<string, unknown> | null;
+    timestamp?: number | undefined;
+    payload?: Record<string, any> | undefined;
 }, {
-    type: "INIT" | "CLICK" | "CHANGE" | "SUBMIT" | "MOUSEOVER" | "MOUSEOUT" | "FOCUS" | "BLUR";
+    type: "CLICK" | "CHANGE" | "SUBMIT" | "MOUSEOVER" | "MOUSEOUT" | "FOCUS" | "BLUR";
     nodeId: string;
-    timestamp: number | null;
-    payload: Record<string, unknown> | null;
+    timestamp?: number | undefined;
+    payload?: Record<string, any> | undefined;
 }>;
 type UIEvent = z.infer<typeof uiEvent>;
-interface UISpecNodeInterface {
+/**
+ * Core UI specification node
+ * Represents a single element in the UI tree
+ */
+declare const uiSpecNode: z.ZodType<UISpecNode>;
+type UISpecNode = {
     id: string;
-    node_type: string;
-    props: Record<string, any> | null;
-    bindings: Record<string, any> | null;
-    events: Record<string, {
+    type: string;
+    props?: Record<string, any> | undefined;
+    bindings?: Record<string, any> | undefined;
+    events?: Record<string, {
         action: string;
-        target: string;
-        payload: Record<string, any> | null;
-    }> | null;
-    children: UISpecNodeInterface[] | null;
-}
-declare const uiSpecNode: z.ZodType<UISpecNodeInterface>;
-type UISpecNode = z.infer<typeof uiSpecNode>;
+        target?: string | undefined;
+        payload?: Record<string, any> | undefined;
+    }> | undefined;
+    children?: UISpecNode[] | undefined;
+};
 /**
  * Application state for the UI engine
  */
 declare const uiState: z.ZodObject<{
-    layout: z.ZodNullable<z.ZodType<UISpecNodeInterface, z.ZodTypeDef, UISpecNodeInterface>>;
+    layout: z.ZodOptional<z.ZodType<UISpecNode, z.ZodTypeDef, UISpecNode>>;
     loading: z.ZodBoolean;
     history: z.ZodArray<z.ZodObject<{
-        type: z.ZodEnum<["INIT", "CLICK", "CHANGE", "SUBMIT", "MOUSEOVER", "MOUSEOUT", "FOCUS", "BLUR"]>;
+        type: z.ZodEnum<["CLICK", "CHANGE", "SUBMIT", "MOUSEOVER", "MOUSEOUT", "FOCUS", "BLUR"]>;
         nodeId: z.ZodString;
-        timestamp: z.ZodNullable<z.ZodNumber>;
-        payload: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        timestamp: z.ZodOptional<z.ZodNumber>;
+        payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
     }, "strip", z.ZodTypeAny, {
-        type: "INIT" | "CLICK" | "CHANGE" | "SUBMIT" | "MOUSEOVER" | "MOUSEOUT" | "FOCUS" | "BLUR";
+        type: "CLICK" | "CHANGE" | "SUBMIT" | "MOUSEOVER" | "MOUSEOUT" | "FOCUS" | "BLUR";
         nodeId: string;
-        timestamp: number | null;
-        payload: Record<string, unknown> | null;
+        timestamp?: number | undefined;
+        payload?: Record<string, any> | undefined;
     }, {
-        type: "INIT" | "CLICK" | "CHANGE" | "SUBMIT" | "MOUSEOVER" | "MOUSEOUT" | "FOCUS" | "BLUR";
+        type: "CLICK" | "CHANGE" | "SUBMIT" | "MOUSEOVER" | "MOUSEOUT" | "FOCUS" | "BLUR";
         nodeId: string;
-        timestamp: number | null;
-        payload: Record<string, unknown> | null;
+        timestamp?: number | undefined;
+        payload?: Record<string, any> | undefined;
     }>, "many">;
-    error: z.ZodNullable<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    layout: UISpecNodeInterface | null;
     loading: boolean;
     history: {
-        type: "INIT" | "CLICK" | "CHANGE" | "SUBMIT" | "MOUSEOVER" | "MOUSEOUT" | "FOCUS" | "BLUR";
+        type: "CLICK" | "CHANGE" | "SUBMIT" | "MOUSEOVER" | "MOUSEOUT" | "FOCUS" | "BLUR";
         nodeId: string;
-        timestamp: number | null;
-        payload: Record<string, unknown> | null;
+        timestamp?: number | undefined;
+        payload?: Record<string, any> | undefined;
     }[];
-    error: string | null;
+    layout?: UISpecNode | undefined;
+    error?: string | undefined;
 }, {
-    layout: UISpecNodeInterface | null;
     loading: boolean;
     history: {
-        type: "INIT" | "CLICK" | "CHANGE" | "SUBMIT" | "MOUSEOVER" | "MOUSEOUT" | "FOCUS" | "BLUR";
+        type: "CLICK" | "CHANGE" | "SUBMIT" | "MOUSEOVER" | "MOUSEOUT" | "FOCUS" | "BLUR";
         nodeId: string;
-        timestamp: number | null;
-        payload: Record<string, unknown> | null;
+        timestamp?: number | undefined;
+        payload?: Record<string, any> | undefined;
     }[];
-    error: string | null;
+    layout?: UISpecNode | undefined;
+    error?: string | undefined;
 }>;
 type UIState = z.infer<typeof uiState>;
 /**
@@ -91,43 +94,43 @@ type UIState = z.infer<typeof uiState>;
 declare const plannerInput: z.ZodObject<{
     schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     goal: z.ZodString;
-    history: z.ZodNullable<z.ZodArray<z.ZodObject<{
-        type: z.ZodEnum<["INIT", "CLICK", "CHANGE", "SUBMIT", "MOUSEOVER", "MOUSEOUT", "FOCUS", "BLUR"]>;
+    history: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<["CLICK", "CHANGE", "SUBMIT", "MOUSEOVER", "MOUSEOUT", "FOCUS", "BLUR"]>;
         nodeId: z.ZodString;
-        timestamp: z.ZodNullable<z.ZodNumber>;
-        payload: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        timestamp: z.ZodOptional<z.ZodNumber>;
+        payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
     }, "strip", z.ZodTypeAny, {
-        type: "INIT" | "CLICK" | "CHANGE" | "SUBMIT" | "MOUSEOVER" | "MOUSEOUT" | "FOCUS" | "BLUR";
+        type: "CLICK" | "CHANGE" | "SUBMIT" | "MOUSEOVER" | "MOUSEOUT" | "FOCUS" | "BLUR";
         nodeId: string;
-        timestamp: number | null;
-        payload: Record<string, unknown> | null;
+        timestamp?: number | undefined;
+        payload?: Record<string, any> | undefined;
     }, {
-        type: "INIT" | "CLICK" | "CHANGE" | "SUBMIT" | "MOUSEOVER" | "MOUSEOUT" | "FOCUS" | "BLUR";
+        type: "CLICK" | "CHANGE" | "SUBMIT" | "MOUSEOVER" | "MOUSEOUT" | "FOCUS" | "BLUR";
         nodeId: string;
-        timestamp: number | null;
-        payload: Record<string, unknown> | null;
+        timestamp?: number | undefined;
+        payload?: Record<string, any> | undefined;
     }>, "many">>;
-    userContext: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    userContext: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
-    history: {
-        type: "INIT" | "CLICK" | "CHANGE" | "SUBMIT" | "MOUSEOVER" | "MOUSEOUT" | "FOCUS" | "BLUR";
-        nodeId: string;
-        timestamp: number | null;
-        payload: Record<string, unknown> | null;
-    }[] | null;
     schema: Record<string, unknown>;
     goal: string;
-    userContext?: Record<string, unknown> | null | undefined;
-}, {
-    history: {
-        type: "INIT" | "CLICK" | "CHANGE" | "SUBMIT" | "MOUSEOVER" | "MOUSEOUT" | "FOCUS" | "BLUR";
+    history?: {
+        type: "CLICK" | "CHANGE" | "SUBMIT" | "MOUSEOVER" | "MOUSEOUT" | "FOCUS" | "BLUR";
         nodeId: string;
-        timestamp: number | null;
-        payload: Record<string, unknown> | null;
-    }[] | null;
+        timestamp?: number | undefined;
+        payload?: Record<string, any> | undefined;
+    }[] | undefined;
+    userContext?: Record<string, unknown> | undefined;
+}, {
     schema: Record<string, unknown>;
     goal: string;
-    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;
 }>;
 type PlannerInput = z.infer<typeof plannerInput>;
 
@@ -143,7 +146,7 @@ interface DataContext {
  */
 declare enum ActionType {
     FULL_REFRESH = "FULL_REFRESH",// Generate a completely new UI
-    UPDATE_NODE = "UPDATE_NODE",// Update a specific node, potentially with new children
+    UPDATE_NODE = "UPDATE_NODE",// Update a specific node
     ADD_DROPDOWN = "ADD_DROPDOWN",// Add a dropdown to a specific node
     SHOW_DETAIL = "SHOW_DETAIL",// Show a detail view
     HIDE_DETAIL = "HIDE_DETAIL",// Hide a detail view
@@ -156,8 +159,8 @@ declare enum ActionType {
  */
 interface ActionRouteConfig {
     actionType: ActionType;
-    targetNodeId?: string;
-    promptTemplate?: string;
+    targetNodeId: string;
+    promptTemplate: string;
     contextKeys?: string[];
 }
 /**
@@ -187,7 +190,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 | null, dataContext: DataContext, goal: string, userContext?: Record<string, unknown>): RouteResolution | null;
+    resolveRoute(event: UIEvent, schema: Record<string, unknown>, layout: UISpecNode | undefined, dataContext: DataContext, goal: string, userContext?: Record<string, unknown>): RouteResolution | null;
     /**
      * Process a prompt template with variables
      * @param template - Template string with ${var} placeholders
@@ -198,22 +201,6 @@ declare class ActionRouter {
 }
 declare function createDefaultRouter(): ActionRouter;
 
-interface UseUIStateEngineOptions {
-    schema: Record<string, unknown>;
-    goal: string;
-    openaiApiKey?: string | undefined;
-    userContext?: Record<string, unknown> | undefined;
-    mockMode?: boolean | undefined;
-    planningConfig?: {
-        prefetchDepth?: number;
-        temperature?: number;
-        streaming?: boolean;
-    } | undefined;
-    router?: ActionRouter | undefined;
-    dataContext?: Record<string, unknown> | undefined;
-    enablePartialUpdates?: boolean | undefined;
-}
-
 interface EventHookOptions {
     preventDefault?: boolean;
     stopPropagation?: boolean;
@@ -242,7 +229,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
@@ -383,7 +370,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;
 }>;
 
@@ -466,10 +453,10 @@ interface SchemaAdapter {
  * Schema adapter options union type
  */
 type SchemaAdapterOptions = {
-    type: "drizzle";
+    type: 'drizzle';
     options: DrizzleAdapterOptions$1;
 } | {
-    type: "custom";
+    type: 'custom';
     adapter: SchemaAdapter;
 };
 /**
@@ -480,16 +467,16 @@ declare function createSchemaAdapter(options: SchemaAdapterOptions): SchemaAdapt
 interface DrizzleAdapterOptions {
     schema: Record<string, unknown>;
 }
-interface AutoUIProps extends Omit<UseUIStateEngineOptions, "router" | "dataContext"> {
+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?: {
@@ -507,13 +494,13 @@ interface AutoUIProps extends Omit<UseUIStateEngineOptions, "router" | "dataCont
         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;
@@ -524,14 +511,13 @@ interface AutoUIProps extends Omit<UseUIStateEngineOptions, "router" | "dataCont
         temperature?: number;
         streaming?: boolean;
     };
-    openaiApiKey?: string;
 }
 /**
  * AutoUI - Main component for generating goal-oriented UIs
  *
  * @example
  * ```tsx
- * import { AutoUI } from 'autoui-react';
+ * import { AutoUI } from '@autoui/react';
  * import { emailsTable, usersTable } from './schema';
  *
  * function MyApp() {
@@ -546,43 +532,4 @@ interface AutoUIProps extends Omit<UseUIStateEngineOptions, "router" | "dataCont
  */
 declare const AutoUI: React.FC<AutoUIProps>;
 
-/**
- * AI Utilities for AutoUI React
- * Provides AI-powered UI generation functionality
- */
-/**
- * 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>;
-
-interface UsePlannerOptions {
-    goal: string;
-    schema: Record<string, unknown>;
-    openaiApiKey?: string;
-    userContext?: Record<string, unknown>;
-    router?: ActionRouter;
-    modelProvider?: unknown;
-    initialLayout?: UISpecNode;
-    mockMode?: boolean;
-}
-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, usePlanner };
+export { type ActionRouteConfig, ActionRouter, ActionType, type AnySystemEvent, AutoUI, type AutoUIProps, DrizzleAdapter, type DrizzleAdapterOptions$1 as DrizzleAdapterOptions, type EventHook, type EventHookContext, type EventHookOptions, type PlannerInput, type SchemaAdapter, type SchemaAdapterOptions, type SystemEventHook, SystemEventType, type UIEvent, type UIEventType, type UISpecNode, type UIState, createDefaultRouter, createEventHook, createSchemaAdapter, createSystemEvent, systemEvents, uiEvent, uiEventType, uiSpecNode };