@allternit/ix 0.1.0 → 0.1.1

package/dist/sdk/react.d.ts.bak

@@ -1,63 +0,0 @@
-/**
- * A2R-IX React SDK
- *
- * React hooks and components for A2R-IX integration.
- */
-import React from 'react';
-import type { UIRoot } from '../types';
-import type { JSONPatch } from '../state/patch';
-import { IXCapsuleClient, type IXCapsuleClientConfig, type IXCapsuleEvent } from './api';
-interface IXContextValue {
-    client: IXCapsuleClient | null;
-    capsuleId: string | null;
-    state: Record<string, unknown>;
-    dispatch: (actionId: string, params?: Record<string, unknown>) => void;
-    applyPatch: (patch: JSONPatch) => void;
-}
-/**
- * Hook to use IX context
- */
-export declare function useIX(): IXContextValue;
-/**
- * Props for IXProvider
- */
-interface IXProviderProps {
-    /** API configuration */
-    config: IXCapsuleClientConfig;
-    /** Capsule ID (if already created) */
-    capsuleId?: string;
-    /** UI definition (for creating new capsule) */
-    ui?: UIRoot;
-    /** Children */
-    children: React.ReactNode;
-}
-/**
- * IX Provider component
- */
-export declare function IXProvider({ config, capsuleId: initialCapsuleId, ui, children }: IXProviderProps): React.ReactElement;
-/**
- * Props for IXRenderer
- */
-interface IXRendererProps {
-    /** Capsule ID (uses context if not provided) */
-    capsuleId?: string;
-    /** Custom component mapping */
-    components?: Record<string, React.ComponentType<unknown>>;
-}
-/**
- * IX Renderer component
- *
- * Renders an IX capsule UI using the React renderer.
- */
-export declare function IXRenderer({ capsuleId: propCapsuleId, components }: IXRendererProps): React.ReactElement | null;
-/**
- * Hook to use IX capsule state
- */
-export declare function useIXState<T>(path: string): [T | undefined, (value: T) => void];
-/**
- * Hook to dispatch IX actions
- */
-export declare function useIXAction(actionId: string): (params?: Record<string, unknown>) => void;
-export type { IXCapsuleClientConfig, IXCapsuleEvent, UIRoot, JSONPatch };
-export { IXCapsuleClient };
-//# sourceMappingURL=react.d.ts.map

package/dist/sdk/react.js.bak

@@ -1,161 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-/**
- * A2R-IX React SDK
- *
- * React hooks and components for A2R-IX integration.
- */
-import { useState, useEffect, useCallback, useRef, createContext, useContext } from 'react';
-import { createReactRenderer } from '../react/renderer';
-import { IXCapsuleClient } from './api';
-const IXContext = createContext(null);
-/**
- * Hook to use IX context
- */
-export function useIX() {
-    const context = useContext(IXContext);
-    if (!context) {
-        throw new Error('useIX must be used within IXProvider');
-    }
-    return context;
-}
-/**
- * IX Provider component
- */
-export function IXProvider({ config, capsuleId: initialCapsuleId, ui, children }) {
-    const [client] = useState(() => createIXClient(config));
-    const [capsuleId, setCapsuleId] = useState(initialCapsuleId || null);
-    const [state, setState] = useState({});
-    const eventHandlerRef = useRef();
-    // Create capsule if UI provided and no capsuleId
-    useEffect(() => {
-        if (!capsuleId && ui) {
-            client.createCapsule({ ui }).then((response) => {
-                setCapsuleId(response.capsule_id);
-            });
-        }
-    }, [client, capsuleId, ui]);
-    // Set up event handler
-    useEffect(() => {
-        eventHandlerRef.current = (event) => {
-            if (event.event_type === 'state-change' && event.state_update) {
-                setState((prev) => ({ ...prev, ...event.state_update }));
-            }
-        };
-    }, []);
-    // Update config onEvent handler
-    useEffect(() => {
-        const originalOnEvent = config.onEvent;
-        config.onEvent = (event) => {
-            eventHandlerRef.current?.(event);
-            originalOnEvent?.(event);
-        };
-    }, [config]);
-    // Fetch initial state
-    useEffect(() => {
-        if (capsuleId) {
-            client.getCapsule(capsuleId).then((capsule) => {
-                setState(capsule.state);
-            });
-        }
-    }, [client, capsuleId]);
-    // Cleanup on unmount
-    useEffect(() => {
-        return () => {
-            client.dispose();
-        };
-    }, [client]);
-    const dispatch = useCallback((actionId, params) => {
-        if (capsuleId) {
-            client.dispatchAction(capsuleId, { action_id: actionId, params });
-        }
-    }, [client, capsuleId]);
-    const applyPatch = useCallback((patch) => {
-        if (capsuleId) {
-            client.applyPatch(capsuleId, patch);
-        }
-    }, [client, capsuleId]);
-    const value = {
-        client,
-        capsuleId,
-        state,
-        dispatch,
-        applyPatch,
-    };
-    return (_jsx(IXContext.Provider, { value: value, children: children }));
-}
-/**
- * IX Renderer component
- *
- * Renders an IX capsule UI using the React renderer.
- */
-export function IXRenderer({ capsuleId: propCapsuleId, components }) {
-    const ix = useIX();
-    const capsuleId = propCapsuleId || ix.capsuleId;
-    const [ui, setUi] = useState(null);
-    const rendererRef = useRef(null);
-    // Create renderer
-    useEffect(() => {
-        rendererRef.current = createReactRenderer({
-            components,
-            stateStore: {
-                get: (path) => (path ? ix.state[path] : ix.state),
-                set: (path, value) => {
-                    ix.applyPatch([{ op: 'replace', path: `/${path.replace(/\./g, '/')}`, value }]);
-                },
-                subscribe: () => () => { },
-                batch: () => { },
-                snapshot: () => ix.state,
-                restore: () => { },
-                reset: () => { },
-                compute: () => { },
-                bind: () => { },
-                getBindings: () => [],
-            },
-            onEvent: (name, payload) => {
-                ix.dispatch(name, payload);
-            },
-        });
-        return () => {
-            rendererRef.current = null;
-        };
-    }, [ix, components]);
-    // Fetch UI when capsuleId changes
-    useEffect(() => {
-        if (capsuleId && ix.client) {
-            ix.client.getCapsule(capsuleId).then((capsule) => {
-                setUi(capsule.ui);
-            });
-        }
-    }, [capsuleId, ix.client]);
-    if (!ui || !rendererRef.current) {
-        return null;
-    }
-    const { UIRoot: UIRootComponent } = rendererRef.current;
-    return _jsx(UIRootComponent, { root: ui });
-}
-/**
- * Hook to use IX capsule state
- */
-export function useIXState(path) {
-    const ix = useIX();
-    const value = ix.state[path];
-    const setValue = useCallback((newValue) => {
-        ix.applyPatch([{ op: 'replace', path: `/${path.replace(/\./g, '/')}`, value: newValue }]);
-    }, [ix, path]);
-    return [value, setValue];
-}
-/**
- * Hook to dispatch IX actions
- */
-export function useIXAction(actionId) {
-    const ix = useIX();
-    return useCallback((params) => {
-        ix.dispatch(actionId, params);
-    }, [ix, actionId]);
-}
-// Helper function
-function createIXClient(config) {
-    return new IXCapsuleClient(config);
-}
-export { IXCapsuleClient };
-//# sourceMappingURL=react.js.map

package/dist/state/index.d.ts.bak

@@ -1,8 +0,0 @@
-/**
- * State Module
- *
- * JSON Patch engine (RFC 6902) and state store for A2R-IX.
- */
-export { createStateStore, getStateStore, clearStateStore, type StateStore, type StateStoreConfig, } from './store';
-export { applyPatch, applyPatchToStore, applyOperation, generatePatch, invertPatch, validatePatch, validateOperation, getValueAtPath, setValueAtPath, decodeJsonPointer, encodeJsonPointer, type JSONPatch, type JSONPatchOperation, type PatchResult, } from './patch';
-//# sourceMappingURL=index.d.ts.map

package/dist/state/index.js.bak

@@ -1,8 +0,0 @@
-/**
- * State Module
- *
- * JSON Patch engine (RFC 6902) and state store for A2R-IX.
- */
-export { createStateStore, getStateStore, clearStateStore, } from './store';
-export { applyPatch, applyPatchToStore, applyOperation, generatePatch, invertPatch, validatePatch, validateOperation, getValueAtPath, setValueAtPath, decodeJsonPointer, encodeJsonPointer, } from './patch';
-//# sourceMappingURL=index.js.map

package/dist/state/patch.d.ts.bak

@@ -1,73 +0,0 @@
-/**
- * JSON Patch Engine (RFC 6902)
- *
- * Implements JSON Patch operations for state synchronization.
- */
-import type { StateStore } from './store';
-export interface JSONPatchOperation {
-    op: 'add' | 'remove' | 'replace' | 'move' | 'copy' | 'test';
-    path: string;
-    value?: unknown;
-    from?: string;
-}
-export type JSONPatch = JSONPatchOperation[];
-export interface PatchResult {
-    success: boolean;
-    operations: JSONPatchOperation[];
-    failedAt?: number;
-    error?: string;
-    newState?: Record<string, unknown>;
-}
-/**
- * JSON Pointer helpers
- */
-export declare function decodeJsonPointer(pointer: string): string[];
-export declare function encodeJsonPointer(segments: string[]): string;
-/**
- * Get value at JSON Pointer path
- */
-export declare function getValueAtPath(obj: unknown, pointer: string): unknown;
-/**
- * Set value at JSON Pointer path
- */
-export declare function setValueAtPath(obj: unknown, pointer: string, value: unknown, operation: 'add' | 'replace' | 'remove'): unknown;
-/**
- * Apply single patch operation
- */
-export declare function applyOperation(state: Record<string, unknown>, operation: JSONPatchOperation): {
-    success: boolean;
-    newState: Record<string, unknown>;
-    error?: string;
-};
-/**
- * Apply JSON Patch to state
- */
-export declare function applyPatch(state: Record<string, unknown>, patch: JSONPatch): PatchResult;
-/**
- * Apply patch to state store
- */
-export declare function applyPatchToStore(store: StateStore, patch: JSONPatch): PatchResult;
-/**
- * Generate JSON Patch from two objects (diff)
- */
-export declare function generatePatch(from: unknown, to: unknown, path?: string): JSONPatch;
-/**
- * Invert a patch for undo functionality
- */
-export declare function invertPatch(patch: JSONPatch, state: Record<string, unknown>): JSONPatch;
-/**
- * Validate patch operation
- */
-export declare function validateOperation(op: JSONPatchOperation): {
-    valid: boolean;
-    error?: string;
-};
-/**
- * Validate entire patch
- */
-export declare function validatePatch(patch: JSONPatch): {
-    valid: boolean;
-    error?: string;
-    index?: number;
-};
-//# sourceMappingURL=patch.d.ts.map