@allternit/ix 0.1.0

package/dist/adapters/json-render.d.ts.bak

@@ -0,0 +1,211 @@
+/**
+ * Vercel Labs json-render Adapter
+ *
+ * Converts between A2R-IX UI IR and Vercel Labs json-render format.
+ *
+ * json-render is a declarative UI format where components are expressed as JSON.
+ * This adapter enables A2R-IX to render UIs generated by LLMs trained on
+ * json-render patterns.
+ *
+ * @see https://github.com/vercel-labs/json-render
+ */
+import type { UIRoot } from '../types';
+/**
+ * json-render node format
+ */
+export interface JsonRenderNode {
+    /** Component type */
+    type: string;
+    /** Component props */
+    props?: Record<string, unknown>;
+    /** Child nodes */
+    children?: JsonRenderNode[];
+    /** Text content (for text nodes) */
+    text?: string;
+}
+/**
+ * json-render component registry entry
+ */
+export interface JsonRenderComponent {
+    /** Component name */
+    name: string;
+    /** React component or element type */
+    component: string;
+    /** Prop mapping (json-render prop -> component prop) */
+    propMapping?: Record<string, string>;
+    /** Transform props before passing */
+    transformProps?: (props: Record<string, unknown>) => Record<string, unknown>;
+    /** Whether component accepts children */
+    acceptsChildren?: boolean;
+}
+/**
+ * json-render schema
+ */
+export interface JsonRenderSchema {
+    /** Schema version */
+    version: string;
+    /** Component tree */
+    root: JsonRenderNode;
+    /** State definitions */
+    state?: Record<string, {
+        type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+        default?: unknown;
+    }>;
+    /** Event handlers */
+    events?: Record<string, {
+        type: string;
+        target?: string;
+        payload?: unknown;
+    }>;
+}
+/**
+ * Custom handler function type
+ */
+export type CustomHandlerFn = (context: {
+    state: Record<string, unknown>;
+    params?: Record<string, unknown>;
+    event?: unknown;
+}) => void | Promise<void>;
+/**
+ * Handler registry entry metadata
+ */
+export interface HandlerRegistryEntry {
+    /** Handler name/identifier */
+    name: string;
+    /** Handler function */
+    handler: CustomHandlerFn;
+    /** Handler description */
+    description?: string;
+    /** Handler version */
+    version?: string;
+    /** Handler tags for discovery */
+    tags?: string[];
+    /** Input schema for validation */
+    inputSchema?: Record<string, unknown>;
+    /** Output schema */
+    outputSchema?: Record<string, unknown>;
+}
+/**
+ * Global handler registry for custom action handlers
+ *
+ * GAP-59: Custom Handler System
+ * Implements a singleton registry for dynamic handler registration
+ */
+declare class HandlerRegistry {
+    private handlers;
+    private tagsIndex;
+    /**
+     * Register a custom handler
+     * @param entry Handler registry entry
+     */
+    register(entry: HandlerRegistryEntry): void;
+    /**
+     * Unregister a handler
+     * @param name Handler name
+     */
+    unregister(name: string): boolean;
+    /**
+     * Get a handler by name
+     * @param name Handler name
+     */
+    get(name: string): HandlerRegistryEntry | undefined;
+    /**
+     * Check if a handler exists
+     * @param name Handler name
+     */
+    has(name: string): boolean;
+    /**
+     * Execute a handler by name
+     * @param name Handler name
+     * @param context Execution context
+     */
+    execute(name: string, context: {
+        state: Record<string, unknown>;
+        params?: Record<string, unknown>;
+        event?: unknown;
+    }): Promise<void>;
+    /**
+     * GAP-61: Handler Discovery
+     * Find handlers by tags
+     * @param tags Tags to search for
+     */
+    findByTags(tags: string[]): HandlerRegistryEntry[];
+    /**
+     * GAP-61: Handler Discovery
+     * Search handlers by name pattern or description
+     * @param query Search query
+     */
+    search(query: string): HandlerRegistryEntry[];
+    /**
+     * Get all registered handlers
+     */
+    listAll(): HandlerRegistryEntry[];
+    /**
+     * Get all available tags
+     */
+    getAllTags(): string[];
+    /**
+     * Clear all handlers
+     */
+    clear(): void;
+    /**
+     * Get registry statistics
+     */
+    getStats(): {
+        total: number;
+        tags: number;
+    };
+}
+/** Global handler registry instance */
+export declare const globalHandlerRegistry: HandlerRegistry;
+/**
+ * Convert A2R-IX UIRoot to json-render format
+ */
+export declare function convertToJsonRender(root: UIRoot): JsonRenderSchema;
+/**
+ * Convert json-render format to A2R-IX UIRoot
+ */
+export declare function convertFromJsonRender(schema: JsonRenderSchema): UIRoot;
+/**
+ * json-render adapter configuration
+ */
+export declare const jsonRenderAdapter: {
+    name: string;
+    version: string;
+    /**
+     * Standard json-render components mapped to A2R-IX catalog
+     */
+    components: Record<string, string>;
+    /**
+     * Convert from json-render
+     */
+    fromJsonRender: typeof convertFromJsonRender;
+    /**
+     * Convert to json-render
+     */
+    toJsonRender: typeof convertToJsonRender;
+    /**
+     * Check if value is a valid json-render schema
+     */
+    isValidSchema(value: unknown): value is JsonRenderSchema;
+    /**
+     * Check if node is a valid json-render node
+     */
+    isValidNode(value: unknown): value is JsonRenderNode;
+    /**
+     * GAP-59/61: Handler Registry Access
+     * Get the global handler registry for custom action handlers
+     */
+    readonly handlerRegistry: HandlerRegistry;
+    /**
+     * GAP-60: Execute custom handler
+     * Execute a registered custom handler by name
+     */
+    executeHandler(name: string, context: {
+        state: Record<string, unknown>;
+        params?: Record<string, unknown>;
+        event?: unknown;
+    }): Promise<void>;
+};
+export {};
+//# sourceMappingURL=json-render.d.ts.map

package/dist/adapters/json-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-render.d.ts","sourceRoot":"","sources":["../../src/adapters/json-render.ts"],"names":[],"mappings":"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"}