@obinexusltd/obix-sdk-core 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * OBIX Core - Runtime engine for Heart/Soul UI/UX SDK
+ * Data-oriented component lifecycle management with intelligent state halting
+ */
+export type { StateHaltConfig, LifecycleHandler, PolicyResult, Policy, Action, RenderFn, ComponentDefinition, ComponentLogic, ComponentInstance, HaltRecommendation } from "./types.js";
+export { LifecycleHook } from "./types.js";
+export { ObixRuntime } from "./runtime.js";
+export { StateHaltEngine } from "./state-halting.js";
+export { PolicyEngine } from "./policy.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,MAAM,EACN,MAAM,EACN,QAAQ,EACR,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * OBIX Core - Runtime engine for Heart/Soul UI/UX SDK
+ * Data-oriented component lifecycle management with intelligent state halting
+ */
+export { LifecycleHook } from "./types.js";
+export { ObixRuntime } from "./runtime.js";
+export { StateHaltEngine } from "./state-halting.js";
+export { PolicyEngine } from "./policy.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAeH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/policy.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Policy Engine
+ * Enforces policies on component instances
+ * Built-in policies prevent invalid component configurations
+ */
+import { ComponentInstance, Policy, PolicyResult } from "./types.js";
+/**
+ * PolicyEngine manages and enforces policies
+ */
+export declare class PolicyEngine {
+    private policies;
+    constructor();
+    /**
+     * Register a custom policy
+     */
+    register<S = any>(policy: Policy<S>): void;
+    /**
+     * Enforce all applicable policies on an instance
+     */
+    enforce<S = any>(instance: ComponentInstance<S>): PolicyResult;
+    /**
+     * Register built-in policies
+     */
+    private registerBuiltInPolicies;
+    /**
+     * Calculate maximum depth of an object
+     */
+    private getObjectDepth;
+}
+//# sourceMappingURL=policy.d.ts.map

package/dist/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,iBAAiB,EACjB,MAAM,EACN,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAkC;;IAOlD;;OAEG;IACH,QAAQ,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI;IAI1C;;OAEG;IACH,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,YAAY;IAgB9D;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA8D/B;;OAEG;IACH,OAAO,CAAC,cAAc;CAqBvB"}

package/dist/policy.js

@@ -0,0 +1,119 @@
+/**
+ * Policy Engine
+ * Enforces policies on component instances
+ * Built-in policies prevent invalid component configurations
+ */
+/**
+ * PolicyEngine manages and enforces policies
+ */
+export class PolicyEngine {
+    policies = new Map();
+    constructor() {
+        // Register built-in policies
+        this.registerBuiltInPolicies();
+    }
+    /**
+     * Register a custom policy
+     */
+    register(policy) {
+        this.policies.set(policy.name, policy);
+    }
+    /**
+     * Enforce all applicable policies on an instance
+     */
+    enforce(instance) {
+        const violations = [];
+        for (const [, policy] of this.policies) {
+            const result = policy.enforce(instance);
+            if (!result.passed) {
+                violations.push(...result.violations);
+            }
+        }
+        return {
+            passed: violations.length === 0,
+            violations
+        };
+    }
+    /**
+     * Register built-in policies
+     */
+    registerBuiltInPolicies() {
+        // Require component to have a render function
+        this.register({
+            name: "RequireRender",
+            enforce: (instance) => {
+                const hasFn = typeof instance.definition.render === "function";
+                return {
+                    passed: hasFn,
+                    violations: hasFn
+                        ? []
+                        : [
+                            {
+                                policy: "RequireRender",
+                                message: "Component must define a render function"
+                            }
+                        ]
+                };
+            }
+        });
+        // Require component to have a name
+        this.register({
+            name: "RequireName",
+            enforce: (instance) => {
+                const hasName = typeof instance.definition.name === "string" && instance.definition.name.length > 0;
+                return {
+                    passed: hasName,
+                    violations: hasName
+                        ? []
+                        : [
+                            {
+                                policy: "RequireName",
+                                message: "Component must define a non-empty name"
+                            }
+                        ]
+                };
+            }
+        });
+        // Limit state object depth to prevent circular references
+        this.register({
+            name: "MaxStateDepth",
+            enforce: (instance) => {
+                const maxDepth = 10;
+                const depth = this.getObjectDepth(instance.currentState);
+                const passed = depth <= maxDepth;
+                return {
+                    passed,
+                    violations: passed
+                        ? []
+                        : [
+                            {
+                                policy: "MaxStateDepth",
+                                message: `State depth ${depth} exceeds maximum ${maxDepth}`
+                            }
+                        ]
+                };
+            }
+        });
+    }
+    /**
+     * Calculate maximum depth of an object
+     */
+    getObjectDepth(obj, visited = new WeakSet()) {
+        if (obj === null || typeof obj !== "object") {
+            return 0;
+        }
+        if (visited.has(obj)) {
+            return 0; // Circular reference
+        }
+        visited.add(obj);
+        let maxDepth = 0;
+        for (const key in obj) {
+            if (Object.prototype.hasOwnProperty.call(obj, key)) {
+                const childDepth = 1 + this.getObjectDepth(obj[key], visited);
+                maxDepth = Math.max(maxDepth, childDepth);
+            }
+        }
+        return maxDepth;
+    }
+}
+//# sourceMappingURL=policy.js.map

package/dist/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH;;GAEG;AACH,MAAM,OAAO,YAAY;IACf,QAAQ,GAAwB,IAAI,GAAG,EAAE,CAAC;IAElD;QACE,6BAA6B;QAC7B,IAAI,CAAC,uBAAuB,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,QAAQ,CAAU,MAAiB;QACjC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,OAAO,CAAU,QAA8B;QAC7C,MAAM,UAAU,GAA+C,EAAE,CAAC;QAElE,KAAK,MAAM,CAAC,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACvC,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACxC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBACnB,UAAU,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;QAED,OAAO;YACL,MAAM,EAAE,UAAU,CAAC,MAAM,KAAK,CAAC;YAC/B,UAAU;SACX,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,uBAAuB;QAC7B,8CAA8C;QAC9C,IAAI,CAAC,QAAQ,CAAM;YACjB,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,CAAC,QAAQ,EAAgB,EAAE;gBAClC,MAAM,KAAK,GAAG,OAAO,QAAQ,CAAC,UAAU,CAAC,MAAM,KAAK,UAAU,CAAC;gBAC/D,OAAO;oBACL,MAAM,EAAE,KAAK;oBACb,UAAU,EAAE,KAAK;wBACf,CAAC,CAAC,EAAE;wBACJ,CAAC,CAAC;4BACE;gCACE,MAAM,EAAE,eAAe;gCACvB,OAAO,EAAE,yCAAyC;6BACnD;yBACF;iBACN,CAAC;YACJ,CAAC;SACF,CAAC,CAAC;QAEH,mCAAmC;QACnC,IAAI,CAAC,QAAQ,CAAM;YACjB,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,CAAC,QAAQ,EAAgB,EAAE;gBAClC,MAAM,OAAO,GAAG,OAAO,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,QAAQ,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;gBACpG,OAAO;oBACL,MAAM,EAAE,OAAO;oBACf,UAAU,EAAE,OAAO;wBACjB,CAAC,CAAC,EAAE;wBACJ,CAAC,CAAC;4BACE;gCACE,MAAM,EAAE,aAAa;gCACrB,OAAO,EAAE,wCAAwC;6BAClD;yBACF;iBACN,CAAC;YACJ,CAAC;SACF,CAAC,CAAC;QAEH,0DAA0D;QAC1D,IAAI,CAAC,QAAQ,CAAM;YACjB,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,CAAC,QAAQ,EAAgB,EAAE;gBAClC,MAAM,QAAQ,GAAG,EAAE,CAAC;gBACpB,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;gBACzD,MAAM,MAAM,GAAG,KAAK,IAAI,QAAQ,CAAC;gBAEjC,OAAO;oBACL,MAAM;oBACN,UAAU,EAAE,MAAM;wBAChB,CAAC,CAAC,EAAE;wBACJ,CAAC,CAAC;4BACE;gCACE,MAAM,EAAE,eAAe;gCACvB,OAAO,EAAE,eAAe,KAAK,oBAAoB,QAAQ,EAAE;6BAC5D;yBACF;iBACN,CAAC;YACJ,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,GAAQ,EAAE,OAAO,GAAG,IAAI,OAAO,EAAE;QACtD,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5C,OAAO,CAAC,CAAC;QACX,CAAC;QAED,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO,CAAC,CAAC,CAAC,qBAAqB;QACjC,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEjB,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;YACtB,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;gBACnD,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;gBAC9D,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/dist/runtime.d.ts

@@ -0,0 +1,68 @@
+/**
+ * OBIX Runtime Engine
+ * Manages component lifecycle, state updates, and halting
+ * Data-oriented: accepts pure objects, not class instances
+ */
+import { ComponentDefinition, ComponentInstance, LifecycleHandler, StateHaltConfig, Policy } from "./types.js";
+/**
+ * ObixRuntime - Core runtime engine for OBIX components
+ */
+export declare class ObixRuntime {
+    private registry;
+    private instances;
+    private lifecycleHandlers;
+    private stateHaltEngine;
+    private policyEngine;
+    private haltConfig;
+    private nextInstanceId;
+    constructor(haltConfig?: Partial<StateHaltConfig>, initialPolicies?: Policy[]);
+    /**
+     * Register a component definition
+     */
+    register<S = any>(definition: ComponentDefinition<S>): void;
+    /**
+     * Create an instance of a registered component
+     */
+    create<S = any>(componentName: string, initialState?: Partial<S>): ComponentInstance<S>;
+    /**
+     * Update instance state by applying an action
+     */
+    update<S = any, A extends any[] = any[]>(instanceId: string, actionName: string, ...args: A): ComponentInstance<S> | null;
+    /**
+     * Manually halt a component
+     */
+    halt(instanceId: string, reason?: string): ComponentInstance<any> | null;
+    /**
+     * Resume a halted component
+     */
+    resume(instanceId: string): ComponentInstance<any> | null;
+    /**
+     * Destroy a component instance
+     */
+    destroy(instanceId: string): void;
+    /**
+     * Subscribe to lifecycle events
+     */
+    onLifecycle(handler: LifecycleHandler): void;
+    /**
+     * Get an instance by ID
+     */
+    getInstance<S = any>(instanceId: string): ComponentInstance<S> | null;
+    /**
+     * Get all active instances
+     */
+    getInstances<S = any>(): ComponentInstance<S>[];
+    /**
+     * Get all registered components
+     */
+    getRegistered(): ComponentDefinition<any>[];
+    /**
+     * Check if instance state has stabilized and halt if needed
+     */
+    private checkStateStability;
+    /**
+     * Fire lifecycle hook to all subscribers
+     */
+    private fireLifecycleHook;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EAEjB,gBAAgB,EAChB,eAAe,EACf,MAAM,EACP,MAAM,YAAY,CAAC;AAapB;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAoD;IACpE,OAAO,CAAC,SAAS,CAAkD;IACnE,OAAO,CAAC,iBAAiB,CAA0B;IACnD,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,cAAc,CAAa;gBAGjC,UAAU,GAAE,OAAO,CAAC,eAAe,CAAM,EACzC,eAAe,GAAE,MAAM,EAAO;IAehC;;OAEG;IACH,QAAQ,CAAC,CAAC,GAAG,GAAG,EAAE,UAAU,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,IAAI;IAO3D;;OAEG;IACH,MAAM,CAAC,CAAC,GAAG,GAAG,EACZ,aAAa,EAAE,MAAM,EACrB,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GACxB,iBAAiB,CAAC,CAAC,CAAC;IA0CvB;;OAEG;IACH,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,EACrC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,GAAG,IAAI,EAAE,CAAC,GACT,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI;IAiD9B;;OAEG;IACH,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,GAAE,MAAsB,GAAG,iBAAiB,CAAC,GAAG,CAAC,GAAG,IAAI;IAavF;;OAEG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,GAAG,IAAI;IAazD;;OAEG;IACH,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAWjC;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAI5C;;OAEG;IACH,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,UAAU,EAAE,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI;IAKrE;;OAEG;IACH,YAAY,CAAC,CAAC,GAAG,GAAG,KAAK,iBAAiB,CAAC,CAAC,CAAC,EAAE;IAI/C;;OAEG;IACH,aAAa,IAAI,mBAAmB,CAAC,GAAG,CAAC,EAAE;IAI3C;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAoB1B"}

package/dist/runtime.js

@@ -0,0 +1,223 @@
+/**
+ * OBIX Runtime Engine
+ * Manages component lifecycle, state updates, and halting
+ * Data-oriented: accepts pure objects, not class instances
+ */
+import { LifecycleHook } from "./types.js";
+import { StateHaltEngine } from "./state-halting.js";
+import { PolicyEngine } from "./policy.js";
+/**
+ * Default state halt configuration
+ */
+const DEFAULT_HALT_CONFIG = {
+    maxRevisions: 100,
+    stabilityThreshold: 3,
+    haltOnPolicyViolation: true
+};
+/**
+ * ObixRuntime - Core runtime engine for OBIX components
+ */
+export class ObixRuntime {
+    registry = new Map();
+    instances = new Map();
+    lifecycleHandlers = [];
+    stateHaltEngine;
+    policyEngine;
+    haltConfig;
+    nextInstanceId = 0;
+    constructor(haltConfig = {}, initialPolicies = []) {
+        this.haltConfig = { ...DEFAULT_HALT_CONFIG, ...haltConfig };
+        this.stateHaltEngine = new StateHaltEngine(this.haltConfig.maxRevisions, this.haltConfig.stabilityThreshold);
+        this.policyEngine = new PolicyEngine();
+        // Register custom policies
+        for (const policy of initialPolicies) {
+            this.policyEngine.register(policy);
+        }
+    }
+    /**
+     * Register a component definition
+     */
+    register(definition) {
+        if (!definition.name) {
+            throw new Error("Component definition must have a name");
+        }
+        this.registry.set(definition.name, definition);
+    }
+    /**
+     * Create an instance of a registered component
+     */
+    create(componentName, initialState) {
+        const definition = this.registry.get(componentName);
+        if (!definition) {
+            throw new Error(`Component '${componentName}' not registered`);
+        }
+        const instanceId = `${componentName}-${++this.nextInstanceId}`;
+        // Merge initial state with definition state
+        const currentState = {
+            ...definition.state,
+            ...(initialState || {})
+        };
+        const instance = {
+            id: instanceId,
+            definition,
+            currentState,
+            halted: false,
+            revision: 0,
+            createdAt: Date.now(),
+            lastUpdatedAt: Date.now()
+        };
+        this.instances.set(instanceId, instance);
+        this.stateHaltEngine.record(instanceId, currentState, 0);
+        // Enforce policies and fire lifecycle hook
+        const policyResult = this.policyEngine.enforce(instance);
+        if (!policyResult.passed) {
+            instance.policyViolations = policyResult.violations;
+            if (this.haltConfig.haltOnPolicyViolation) {
+                instance.halted = true;
+                instance.haltReason = "Policy violations on creation";
+            }
+        }
+        this.fireLifecycleHook(LifecycleHook.CREATED, instanceId, instance);
+        return instance;
+    }
+    /**
+     * Update instance state by applying an action
+     */
+    update(instanceId, actionName, ...args) {
+        const instance = this.instances.get(instanceId);
+        if (!instance) {
+            throw new Error(`Instance '${instanceId}' not found`);
+        }
+        if (instance.halted) {
+            console.warn(`Instance '${instanceId}' is halted, skipping update`);
+            return instance;
+        }
+        const action = instance.definition.actions[actionName];
+        if (!action) {
+            throw new Error(`Action '${actionName}' not found on component`);
+        }
+        // Apply action to get state delta
+        const stateDelta = action(...args);
+        const newState = {
+            ...instance.currentState,
+            ...stateDelta
+        };
+        // Update instance
+        instance.currentState = newState;
+        instance.revision++;
+        instance.lastUpdatedAt = Date.now();
+        // Record state for halting detection
+        this.stateHaltEngine.record(instanceId, newState, instance.revision);
+        // Check for state stability and halt if needed
+        this.checkStateStability(instanceId);
+        // Enforce policies
+        const policyResult = this.policyEngine.enforce(instance);
+        instance.policyViolations = policyResult.violations;
+        if (!policyResult.passed && this.haltConfig.haltOnPolicyViolation) {
+            instance.halted = true;
+            instance.haltReason = "Policy violation detected";
+            this.fireLifecycleHook(LifecycleHook.HALTED, instanceId, instance);
+        }
+        else {
+            this.fireLifecycleHook(LifecycleHook.UPDATED, instanceId, instance);
+        }
+        return instance;
+    }
+    /**
+     * Manually halt a component
+     */
+    halt(instanceId, reason = "Manual halt") {
+        const instance = this.instances.get(instanceId);
+        if (!instance) {
+            throw new Error(`Instance '${instanceId}' not found`);
+        }
+        instance.halted = true;
+        instance.haltReason = reason;
+        this.fireLifecycleHook(LifecycleHook.HALTED, instanceId, instance);
+        return instance;
+    }
+    /**
+     * Resume a halted component
+     */
+    resume(instanceId) {
+        const instance = this.instances.get(instanceId);
+        if (!instance) {
+            throw new Error(`Instance '${instanceId}' not found`);
+        }
+        instance.halted = false;
+        instance.haltReason = undefined;
+        this.stateHaltEngine.clear(instanceId);
+        return instance;
+    }
+    /**
+     * Destroy a component instance
+     */
+    destroy(instanceId) {
+        const instance = this.instances.get(instanceId);
+        if (!instance) {
+            throw new Error(`Instance '${instanceId}' not found`);
+        }
+        this.fireLifecycleHook(LifecycleHook.DESTROYED, instanceId, instance);
+        this.instances.delete(instanceId);
+        this.stateHaltEngine.clear(instanceId);
+    }
+    /**
+     * Subscribe to lifecycle events
+     */
+    onLifecycle(handler) {
+        this.lifecycleHandlers.push(handler);
+    }
+    /**
+     * Get an instance by ID
+     */
+    getInstance(instanceId) {
+        const instance = this.instances.get(instanceId);
+        return instance ? instance : null;
+    }
+    /**
+     * Get all active instances
+     */
+    getInstances() {
+        return Array.from(this.instances.values());
+    }
+    /**
+     * Get all registered components
+     */
+    getRegistered() {
+        return Array.from(this.registry.values());
+    }
+    /**
+     * Check if instance state has stabilized and halt if needed
+     */
+    checkStateStability(instanceId) {
+        const instance = this.instances.get(instanceId);
+        if (!instance || instance.halted)
+            return;
+        const recommendation = this.stateHaltEngine.getHaltRecommendation(instanceId);
+        if (recommendation.shouldHalt) {
+            instance.halted = true;
+            instance.haltReason = recommendation.reason;
+            this.fireLifecycleHook(LifecycleHook.HALTED, instanceId, instance);
+        }
+    }
+    /**
+     * Fire lifecycle hook to all subscribers
+     */
+    fireLifecycleHook(hook, instanceId, instance) {
+        const timestamp = Date.now();
+        for (const handler of this.lifecycleHandlers) {
+            try {
+                handler({
+                    hook,
+                    instanceId,
+                    instance,
+                    timestamp
+                });
+            }
+            catch (error) {
+                console.error(`Error in lifecycle handler for ${hook}:`, error);
+            }
+        }
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/dist/state-halting.d.ts

@@ -0,0 +1,44 @@
+/**
+ * State Halting Engine
+ * Implements intelligent caching through state stability detection
+ * Stops processing when component state is stable enough
+ */
+import { HaltRecommendation } from "./types.js";
+/**
+ * StateHaltEngine tracks state history and determines stability
+ */
+export declare class StateHaltEngine {
+    private stateHistory;
+    private readonly maxHistoryDepth;
+    private readonly stabilityThreshold;
+    constructor(maxHistoryDepth?: number, stabilityThreshold?: number);
+    /**
+     * Record a state snapshot for an instance
+     */
+    record<S>(instanceId: string, state: S, revision: number): void;
+    /**
+     * Check if state has stabilized for an instance
+     */
+    isStable<S>(instanceId: string): boolean;
+    /**
+     * Get halt recommendation for an instance
+     */
+    getHaltRecommendation(instanceId: string): HaltRecommendation;
+    /**
+     * Clear history for an instance
+     */
+    clear(instanceId: string): void;
+    /**
+     * Clear all history
+     */
+    clearAll(): void;
+    /**
+     * Deep equality check for state objects
+     */
+    private deepEqual;
+    /**
+     * Deep clone state object
+     */
+    private deepClone;
+}
+//# sourceMappingURL=state-halting.d.ts.map

package/dist/state-halting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-halting.d.ts","sourceRoot":"","sources":["../src/state-halting.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAQhD;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,YAAY,CAA2C;IAC/D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;gBAEhC,eAAe,GAAE,MAAW,EAAE,kBAAkB,GAAE,MAAU;IAKxE;;OAEG;IACH,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAkB/D;;OAEG;IACH,QAAQ,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAexC;;OAEG;IACH,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB;IAiC7D;;OAEG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,QAAQ,IAAI,IAAI;IAIhB;;OAEG;IACH,OAAO,CAAC,SAAS;IAoBjB;;OAEG;IACH,OAAO,CAAC,SAAS;CAYlB"}

package/dist/state-halting.js

@@ -0,0 +1,132 @@
+/**
+ * State Halting Engine
+ * Implements intelligent caching through state stability detection
+ * Stops processing when component state is stable enough
+ */
+/**
+ * StateHaltEngine tracks state history and determines stability
+ */
+export class StateHaltEngine {
+    stateHistory = new Map();
+    maxHistoryDepth;
+    stabilityThreshold;
+    constructor(maxHistoryDepth = 10, stabilityThreshold = 3) {
+        this.maxHistoryDepth = maxHistoryDepth;
+        this.stabilityThreshold = stabilityThreshold;
+    }
+    /**
+     * Record a state snapshot for an instance
+     */
+    record(instanceId, state, revision) {
+        if (!this.stateHistory.has(instanceId)) {
+            this.stateHistory.set(instanceId, []);
+        }
+        const history = this.stateHistory.get(instanceId);
+        history.push({
+            state: this.deepClone(state),
+            revision,
+            timestamp: Date.now()
+        });
+        // Keep history within max depth
+        if (history.length > this.maxHistoryDepth) {
+            history.shift();
+        }
+    }
+    /**
+     * Check if state has stabilized for an instance
+     */
+    isStable(instanceId) {
+        const history = this.stateHistory.get(instanceId);
+        if (!history || history.length < this.stabilityThreshold) {
+            return false;
+        }
+        // Check last N states are identical (deep compare)
+        const recentStates = history.slice(-this.stabilityThreshold);
+        const firstState = recentStates[0].state;
+        return recentStates.every(snapshot => this.deepEqual(snapshot.state, firstState));
+    }
+    /**
+     * Get halt recommendation for an instance
+     */
+    getHaltRecommendation(instanceId) {
+        const history = this.stateHistory.get(instanceId);
+        if (!history || history.length === 0) {
+            return {
+                shouldHalt: false,
+                stableForRevisions: 0
+            };
+        }
+        if (this.isStable(instanceId)) {
+            // Count how many revisions are stable
+            const firstStableIndex = history.length - 1;
+            for (let i = history.length - 1; i >= 0; i--) {
+                if (!this.deepEqual(history[i].state, history[history.length - 1].state)) {
+                    break;
+                }
+            }
+            const stableCount = history.length > 0 ? history.length : 0;
+            return {
+                shouldHalt: true,
+                reason: "State has stabilized - no changes detected",
+                stableForRevisions: stableCount
+            };
+        }
+        return {
+            shouldHalt: false,
+            stableForRevisions: 0
+        };
+    }
+    /**
+     * Clear history for an instance
+     */
+    clear(instanceId) {
+        this.stateHistory.delete(instanceId);
+    }
+    /**
+     * Clear all history
+     */
+    clearAll() {
+        this.stateHistory.clear();
+    }
+    /**
+     * Deep equality check for state objects
+     */
+    deepEqual(a, b) {
+        if (a === b)
+            return true;
+        if (a == null || b == null)
+            return a === b;
+        if (typeof a !== typeof b)
+            return false;
+        if (typeof a !== "object")
+            return a === b;
+        const keysA = Object.keys(a);
+        const keysB = Object.keys(b);
+        if (keysA.length !== keysB.length)
+            return false;
+        for (const key of keysA) {
+            if (!keysB.includes(key))
+                return false;
+            if (!this.deepEqual(a[key], b[key]))
+                return false;
+        }
+        return true;
+    }
+    /**
+     * Deep clone state object
+     */
+    deepClone(obj) {
+        if (obj === null || typeof obj !== "object")
+            return obj;
+        if (Array.isArray(obj))
+            return obj.map(item => this.deepClone(item));
+        const cloned = {};
+        for (const key in obj) {
+            if (Object.prototype.hasOwnProperty.call(obj, key)) {
+                cloned[key] = this.deepClone(obj[key]);
+            }
+        }
+        return cloned;
+    }
+}
+//# sourceMappingURL=state-halting.js.map

package/dist/state-halting.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Core type definitions for OBIX runtime engine
+ * Implements data-oriented component lifecycle management
+ */
+/**
+ * Configuration for state halting behavior
+ */
+export interface StateHaltConfig {
+    /** Maximum number of revisions to track before mandatory halt */
+    maxRevisions: number;
+    /** Number of identical states needed to determine stability (deep compare) */
+    stabilityThreshold: number;
+    /** Whether to halt component if policy enforcement fails */
+    haltOnPolicyViolation: boolean;
+}
+/**
+ * Lifecycle event types
+ */
+export declare enum LifecycleHook {
+    CREATED = "CREATED",
+    MOUNTED = "MOUNTED",
+    UPDATED = "UPDATED",
+    HALTED = "HALTED",
+    DESTROYED = "DESTROYED"
+}
+/**
+ * Lifecycle event handler callback
+ */
+export type LifecycleHandler<S = any> = (event: {
+    hook: LifecycleHook;
+    instanceId: string;
+    instance?: ComponentInstance<S>;
+    timestamp: number;
+}) => void | Promise<void>;
+/**
+ * Policy enforcement result
+ */
+export interface PolicyResult {
+    passed: boolean;
+    violations: Array<{
+        policy: string;
+        message: string;
+    }>;
+}
+/**
+ * Named policy that can be enforced on component instances
+ */
+export interface Policy<S = any> {
+    name: string;
+    enforce: (instance: ComponentInstance<S>) => PolicyResult;
+}
+/**
+ * Plain object action that modifies component state
+ */
+export interface Action<S = any, A extends any[] = any[]> {
+    (...args: A): Partial<S>;
+}
+/**
+ * Render function for component UI representation
+ */
+export type RenderFn<S = any> = (state: S) => any;
+/**
+ * Component definition - plain data object describing component structure
+ * Data-oriented: no classes, pure configuration
+ */
+export interface ComponentDefinition<S = any> {
+    name: string;
+    state: S;
+    actions: Record<string, Action<S, any>>;
+    render: RenderFn<S>;
+    policies?: Policy<S>[];
+}
+/**
+ * Active instance of a component with runtime state
+ */
+export interface ComponentInstance<S = any> {
+    id: string;
+    definition: ComponentDefinition<S>;
+    currentState: S;
+    halted: boolean;
+    haltReason?: string;
+    revision: number;
+    createdAt: number;
+    lastUpdatedAt: number;
+    policyViolations?: Array<{
+        policy: string;
+        message: string;
+    }>;
+}
+/**
+ * Component logic - alias for ComponentDefinition used in adapter/component contexts
+ * Represents the pure data description of a component's behavior
+ */
+export type ComponentLogic<S = any> = ComponentDefinition<S>;
+/**
+ * State stability recommendation from state halt engine
+ */
+export interface HaltRecommendation {
+    shouldHalt: boolean;
+    reason?: string;
+    stableForRevisions: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,YAAY,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,kBAAkB,EAAE,MAAM,CAAC;IAC3B,4DAA4D;IAC5D,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAED;;GAEG;AACH,oBAAY,aAAa;IACvB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,SAAS,cAAc;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE;IAC9C,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE3B;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,KAAK,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,MAAM,CAAC,CAAC,GAAG,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,KAAK,YAAY,CAAC;CAC3D;AAED;;GAEG;AACH,MAAM,WAAW,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE;IACtD,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,GAAG,CAAC;AAElD;;;GAGG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,GAAG;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,CAAC,CAAC;IACT,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IACxC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,GAAG;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC;IACnC,YAAY,EAAE,CAAC,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,KAAK,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACJ;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,GAAG,IAAI,mBAAmB,CAAC,CAAC,CAAC,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,MAAM,CAAC;CAC5B"}

package/dist/types.js

@@ -0,0 +1,16 @@
+/**
+ * Core type definitions for OBIX runtime engine
+ * Implements data-oriented component lifecycle management
+ */
+/**
+ * Lifecycle event types
+ */
+export var LifecycleHook;
+(function (LifecycleHook) {
+    LifecycleHook["CREATED"] = "CREATED";
+    LifecycleHook["MOUNTED"] = "MOUNTED";
+    LifecycleHook["UPDATED"] = "UPDATED";
+    LifecycleHook["HALTED"] = "HALTED";
+    LifecycleHook["DESTROYED"] = "DESTROYED";
+})(LifecycleHook || (LifecycleHook = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH;;GAEG;AACH,MAAM,CAAN,IAAY,aAMX;AAND,WAAY,aAAa;IACvB,oCAAmB,CAAA;IACnB,oCAAmB,CAAA;IACnB,oCAAmB,CAAA;IACnB,kCAAiB,CAAA;IACjB,wCAAuB,CAAA;AACzB,CAAC,EANW,aAAa,KAAb,aAAa,QAMxB"}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@obinexusltd/obix-sdk-core",
+  "version": "0.1.0",
+  "description": "OBIX Heart/Soul UI/UX runtime engine - component lifecycle, state halting, data-oriented architecture",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "license": "MIT",
+  "author": "OBINexus <okpalan@protonmail.com>",
+  "publishConfig": {
+    "access": "public"
+  }
+}