qnce-engine 0.1.0 → 1.2.1

package/dist/narrative/branching/models.d.ts.map

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

package/dist/narrative/branching/models.js

@@ -0,0 +1,6 @@
+"use strict";
+// QNCE Branching System - Platform Data Model (PDM)
+// Sprint #3 - Advanced Narrative & AI Integration
+Object.defineProperty(exports, "__esModule", { value: true });
+// All interfaces are exported above and ready for engine integration
+//# sourceMappingURL=models.js.map

package/dist/narrative/branching/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../../src/narrative/branching/models.ts"],"names":[],"mappings":";AAAA,oDAAoD;AACpD,kDAAkD;;AAuRlD,qEAAqE"}

package/dist/performance/HotReloadDelta.d.ts

@@ -0,0 +1,124 @@
+import { NarrativeNode, StoryData } from '../engine/core';
+export interface Asset {
+    id: string;
+    type: 'image' | 'audio' | 'video';
+    src: string;
+    size?: number;
+}
+export interface StoryDelta {
+    nodeChanges: NodeDelta[];
+    assetChanges: AssetDelta[];
+    timestamp: number;
+}
+export interface NodeDelta {
+    nodeId: string;
+    changeType: 'added' | 'modified' | 'removed';
+    oldNode?: NarrativeNode;
+    newNode?: NarrativeNode;
+    affectedFields: (keyof NarrativeNode | '*')[];
+}
+export interface AssetDelta {
+    assetId: string;
+    changeType: 'added' | 'modified' | 'removed';
+    oldAsset?: Asset;
+    newAsset?: Asset;
+    sizeChange: number;
+}
+interface PatchableEngine {
+    storyData: StoryData;
+    getState(): {
+        currentNodeId: string;
+    };
+}
+export interface ExtendedStoryData extends StoryData {
+    assets?: Asset[];
+}
+/**
+ * Delta Comparison Engine for Hot-Reload Story Updates
+ * Identifies minimal changes needed to update narrative content
+ */
+export declare class StoryDeltaComparator {
+    /**
+     * Compare two story configurations and generate delta
+     */
+    compareStories(oldStory: ExtendedStoryData, newStory: ExtendedStoryData): StoryDelta;
+    /**
+     * Deep comparison of narrative nodes
+     */
+    private compareNodes;
+    /**
+     * Compare assets (future: images, audio, etc.)
+     */
+    private compareAssets;
+    /**
+     * Fine-grained field comparison for nodes
+     */
+    private findChangedFields;
+    /**
+     * Asset comparison logic
+     */
+    private assetsAreDifferent;
+    /**
+     * Deep equality check for objects
+     */
+    private deepEqual;
+}
+/**
+ * Hot-Reload Delta Patcher
+ * Applies story deltas with minimal engine disruption
+ */
+export declare class StoryDeltaPatcher {
+    private engine;
+    constructor(engine: PatchableEngine);
+    /**
+     * Apply delta patch to running engine
+     * Target: <2ms frame stall for hot-reload
+     */
+    applyDelta(delta: StoryDelta): Promise<PatchResult>;
+    /**
+     * Validate delta is safe to apply
+     */
+    private validateDelta;
+    /**
+     * Apply node changes to story data
+     */
+    private applyNodeChanges;
+    /**
+     * Fast synchronous node changes for small deltas (no async overhead)
+     */
+    private applyNodeChangesFast;
+    /**
+     * Apply asset changes (placeholder for future implementation)
+     */
+    private applyAssetChanges;
+    /**
+     * Batch node changes by type for efficient processing
+     */
+    private batchNodeChanges;
+    /**
+     * Process a batch of node changes
+     */
+    private processBatch;
+    /**
+     * Apply individual node change
+     */
+    private applyNodeChange;
+    /**
+     * Refresh engine state after patch
+     */
+    private refreshEngineState;
+}
+export interface PatchResult {
+    success: boolean;
+    patchId: string;
+    duration: number;
+    nodesChanged?: number;
+    assetsChanged?: number;
+    error?: string;
+}
+export declare function createDeltaTools(engine: PatchableEngine): {
+    comparator: StoryDeltaComparator;
+    patcher: StoryDeltaPatcher;
+};
+export {};
+//# sourceMappingURL=HotReloadDelta.d.ts.map

package/dist/performance/HotReloadDelta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HotReloadDelta.d.ts","sourceRoot":"","sources":["../../src/performance/HotReloadDelta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAK1D,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,SAAS,EAAE,CAAC;IACzB,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;IAC7C,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,cAAc,EAAE,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC,EAAE,CAAC;CAC/C;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,eAAe;IACvB,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,IAAI;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;CACvC;AAED,MAAM,WAAW,iBAAkB,SAAQ,SAAS;IAClD,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,qBAAa,oBAAoB;IAE/B;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,iBAAiB,EAAE,QAAQ,EAAE,iBAAiB,GAAG,UAAU;IAUpF;;OAEG;IACH,OAAO,CAAC,YAAY;IA+CpB;;OAEG;IACH,OAAO,CAAC,aAAa;IA4CrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAazB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAK1B;;OAEG;IACH,OAAO,CAAC,SAAS;CAuBlB;AAED;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAkB;gBAEpB,MAAM,EAAE,eAAe;IAInC;;;OAGG;IACG,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IAmDzD;;OAEG;IACH,OAAO,CAAC,aAAa;IAgBrB;;OAEG;YACW,gBAAgB;IAS9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAM5B;;OAEG;YACW,iBAAiB;IAK/B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;OAEG;YACW,YAAY;IAY1B;;OAEG;IACH,OAAO,CAAC,eAAe;IA8BvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAI3B;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAGD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe;;;EAKvD"}

package/dist/performance/HotReloadDelta.js

@@ -0,0 +1,328 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StoryDeltaPatcher = exports.StoryDeltaComparator = void 0;
+exports.createDeltaTools = createDeltaTools;
+/**
+ * Delta Comparison Engine for Hot-Reload Story Updates
+ * Identifies minimal changes needed to update narrative content
+ */
+class StoryDeltaComparator {
+    /**
+     * Compare two story configurations and generate delta
+     */
+    compareStories(oldStory, newStory) {
+        const timestamp = performance.now();
+        return {
+            nodeChanges: this.compareNodes(oldStory.nodes || [], newStory.nodes || []),
+            assetChanges: this.compareAssets(oldStory.assets || [], newStory.assets || []),
+            timestamp
+        };
+    }
+    /**
+     * Deep comparison of narrative nodes
+     */
+    compareNodes(oldNodes, newNodes) {
+        const deltas = [];
+        const oldNodeMap = new Map(oldNodes.map(n => [n.id, n]));
+        const newNodeMap = new Map(newNodes.map(n => [n.id, n]));
+        // Check for removed nodes
+        for (const [nodeId, oldNode] of oldNodeMap) {
+            if (!newNodeMap.has(nodeId)) {
+                deltas.push({
+                    nodeId,
+                    changeType: 'removed',
+                    oldNode,
+                    affectedFields: ['*']
+                });
+            }
+        }
+        // Check for added and modified nodes
+        for (const [nodeId, newNode] of newNodeMap) {
+            const oldNode = oldNodeMap.get(nodeId);
+            if (!oldNode) {
+                // New node
+                deltas.push({
+                    nodeId,
+                    changeType: 'added',
+                    newNode,
+                    affectedFields: ['*']
+                });
+            }
+            else {
+                // Check for modifications
+                const affectedFields = this.findChangedFields(oldNode, newNode);
+                if (affectedFields.length > 0) {
+                    deltas.push({
+                        nodeId,
+                        changeType: 'modified',
+                        oldNode,
+                        newNode,
+                        affectedFields
+                    });
+                }
+            }
+        }
+        return deltas;
+    }
+    /**
+     * Compare assets (future: images, audio, etc.)
+     */
+    compareAssets(oldAssets, newAssets) {
+        const deltas = [];
+        const oldAssetMap = new Map(oldAssets.map(a => [a.id, a]));
+        const newAssetMap = new Map(newAssets.map(a => [a.id, a]));
+        // Check for removed assets
+        for (const [assetId, oldAsset] of oldAssetMap) {
+            if (!newAssetMap.has(assetId)) {
+                deltas.push({
+                    assetId,
+                    changeType: 'removed',
+                    oldAsset,
+                    sizeChange: -(oldAsset.size || 0)
+                });
+            }
+        }
+        // Check for added and modified assets
+        for (const [assetId, newAsset] of newAssetMap) {
+            const oldAsset = oldAssetMap.get(assetId);
+            if (!oldAsset) {
+                // New asset
+                deltas.push({
+                    assetId,
+                    changeType: 'added',
+                    newAsset,
+                    sizeChange: newAsset.size || 0
+                });
+            }
+            else if (this.assetsAreDifferent(oldAsset, newAsset)) {
+                // Modified asset
+                deltas.push({
+                    assetId,
+                    changeType: 'modified',
+                    oldAsset,
+                    newAsset,
+                    sizeChange: (newAsset.size || 0) - (oldAsset.size || 0)
+                });
+            }
+        }
+        return deltas;
+    }
+    /**
+     * Fine-grained field comparison for nodes
+     */
+    findChangedFields(oldNode, newNode) {
+        const changedFields = [];
+        const allFields = new Set([...Object.keys(oldNode), ...Object.keys(newNode)]);
+        for (const field of allFields) {
+            if (!this.deepEqual(oldNode[field], newNode[field])) {
+                changedFields.push(field);
+            }
+        }
+        return changedFields;
+    }
+    /**
+     * Asset comparison logic
+     */
+    assetsAreDifferent(oldAsset, newAsset) {
+        // Simple comparison - in practice, would use checksums/hashes
+        return JSON.stringify(oldAsset) !== JSON.stringify(newAsset);
+    }
+    /**
+     * Deep equality check for objects
+     */
+    deepEqual(a, b) {
+        if (a === b)
+            return true;
+        if (a === null || b === null)
+            return false;
+        if (typeof a !== typeof b)
+            return false;
+        if (typeof a === 'object') {
+            if (Array.isArray(a) !== Array.isArray(b))
+                return false;
+            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;
+        }
+        return false;
+    }
+}
+exports.StoryDeltaComparator = StoryDeltaComparator;
+/**
+ * Hot-Reload Delta Patcher
+ * Applies story deltas with minimal engine disruption
+ */
+class StoryDeltaPatcher {
+    engine;
+    constructor(engine) {
+        this.engine = engine;
+    }
+    /**
+     * Apply delta patch to running engine
+     * Target: <2ms frame stall for hot-reload
+     */
+    async applyDelta(delta) {
+        const startTime = performance.now();
+        const patchId = `patch-${Date.now()}`;
+        try {
+            // Phase 1: Validate delta can be applied safely (sync, fast)
+            const validation = this.validateDelta(delta);
+            if (!validation.safe) {
+                return {
+                    success: false,
+                    patchId,
+                    duration: performance.now() - startTime,
+                    error: validation.error
+                };
+            }
+            // Phase 2: Apply changes synchronously for speed
+            // For small deltas (<10 changes), apply immediately
+            // For larger deltas, use optimized batch processing
+            if (delta.nodeChanges.length <= 10) {
+                this.applyNodeChangesFast(delta.nodeChanges);
+            }
+            else {
+                await this.applyNodeChanges(delta.nodeChanges);
+            }
+            // Phase 3: Skip asset changes for now (async operation)
+            // Assets can be updated in background without frame stall
+            // Phase 4: Minimal state refresh
+            this.refreshEngineState();
+            const duration = performance.now() - startTime;
+            return {
+                success: true,
+                patchId,
+                duration,
+                nodesChanged: delta.nodeChanges.length,
+                assetsChanged: delta.assetChanges.length
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                patchId,
+                duration: performance.now() - startTime,
+                error: error instanceof Error ? error.message : 'Unknown error'
+            };
+        }
+    }
+    /**
+     * Validate delta is safe to apply
+     */
+    validateDelta(delta) {
+        // Check if current node would be affected
+        const currentNodeId = this.engine.getState().currentNodeId;
+        const currentNodeChange = delta.nodeChanges.find(c => c.nodeId === currentNodeId);
+        if (currentNodeChange && currentNodeChange.changeType === 'removed') {
+            return {
+                safe: false,
+                error: 'Cannot remove currently active node'
+            };
+        }
+        // Additional safety checks could go here
+        return { safe: true };
+    }
+    /**
+     * Apply node changes to story data
+     */
+    async applyNodeChanges(nodeChanges) {
+        // Batch node changes to minimize engine updates
+        const batches = this.batchNodeChanges(nodeChanges);
+        for (const batch of batches) {
+            await this.processBatch(batch);
+        }
+    }
+    /**
+     * Fast synchronous node changes for small deltas (no async overhead)
+     */
+    applyNodeChangesFast(nodeChanges) {
+        for (const change of nodeChanges) {
+            this.applyNodeChange(change);
+        }
+    }
+    /**
+     * Apply asset changes (placeholder for future implementation)
+     */
+    async applyAssetChanges(assetChanges) {
+        // Future: Implement asset hot-reload
+        console.log(`Would apply ${assetChanges.length} asset changes`);
+    }
+    /**
+     * Batch node changes by type for efficient processing
+     */
+    batchNodeChanges(nodeChanges) {
+        const batches = [];
+        const batchSize = 25; // Larger batch size for efficiency
+        for (let i = 0; i < nodeChanges.length; i += batchSize) {
+            batches.push(nodeChanges.slice(i, i + batchSize));
+        }
+        return batches;
+    }
+    /**
+     * Process a batch of node changes
+     */
+    async processBatch(batch) {
+        // Use requestAnimationFrame or setTimeout to yield control
+        return new Promise(resolve => {
+            setTimeout(() => {
+                for (const change of batch) {
+                    this.applyNodeChange(change);
+                }
+                resolve();
+            }, 0);
+        });
+    }
+    /**
+     * Apply individual node change
+     */
+    applyNodeChange(change) {
+        // Access engine's internal story data
+        const storyData = this.engine.storyData;
+        switch (change.changeType) {
+            case 'added': {
+                if (change.newNode) {
+                    storyData.nodes.push(change.newNode);
+                }
+                break;
+            }
+            case 'removed': {
+                const removeIndex = storyData.nodes.findIndex((n) => n.id === change.nodeId);
+                if (removeIndex >= 0) {
+                    storyData.nodes.splice(removeIndex, 1);
+                }
+                break;
+            }
+            case 'modified':
+                const modifyIndex = storyData.nodes.findIndex((n) => n.id === change.nodeId);
+                if (modifyIndex >= 0 && change.newNode) {
+                    // For simplicity, always replace the entire node
+                    storyData.nodes[modifyIndex] = change.newNode;
+                }
+                break;
+        }
+    }
+    /**
+     * Refresh engine state after patch
+     */
+    refreshEngineState() {
+        // Minimal state refresh - avoid full reinitialization
+        // Future: Could trigger cache invalidation, UI updates, etc.
+    }
+}
+exports.StoryDeltaPatcher = StoryDeltaPatcher;
+// Factory function for creating delta tools
+function createDeltaTools(engine) {
+    return {
+        comparator: new StoryDeltaComparator(),
+        patcher: new StoryDeltaPatcher(engine)
+    };
+}
+//# sourceMappingURL=HotReloadDelta.js.map

package/dist/performance/HotReloadDelta.js.map

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

package/dist/performance/ObjectPool.d.ts

@@ -0,0 +1,150 @@
+export interface Poolable {
+    reset(): void;
+    isInUse(): boolean;
+    setInUse(inUse: boolean): void;
+}
+export interface PoolableConstructor<T extends Poolable> {
+    new (): T;
+}
+/**
+ * Generic Object Pool for QNCE narrative objects
+ * Reduces GC pressure by reusing objects instead of creating new ones
+ */
+export declare class ObjectPool<T extends Poolable> {
+    private pool;
+    private createFn;
+    private maxSize;
+    private created;
+    private borrowed;
+    private returned;
+    constructor(createFn: () => T, initialSize?: number, maxSize?: number);
+    /**
+     * Borrow an object from the pool
+     */
+    borrow(): T;
+    /**
+     * Return an object to the pool
+     */
+    return(obj: T): void;
+    /**
+     * Get pool statistics for monitoring
+     */
+    getStats(): {
+        poolSize: number;
+        maxSize: number;
+        created: number;
+        borrowed: number;
+        returned: number;
+        inUse: number;
+        hitRate: number;
+    };
+    /**
+     * Clear the pool (useful for testing)
+     */
+    clear(): void;
+    /**
+     * Resize the pool
+     */
+    resize(newSize: number): void;
+}
+/**
+ * Pooled Flow object for narrative state management
+ */
+export declare class PooledFlow implements Poolable {
+    private _inUse;
+    nodeId: string;
+    timestamp: number;
+    metadata: Record<string, unknown>;
+    transitions: string[];
+    constructor();
+    reset(): void;
+    isInUse(): boolean;
+    setInUse(inUse: boolean): void;
+    initialize(nodeId: string, metadata?: Record<string, unknown>): void;
+    addTransition(fromNodeId: string, toNodeId: string): void;
+    getDuration(): number;
+}
+/**
+ * Pooled Node object for narrative content
+ */
+export declare class PooledNode implements Poolable {
+    private _inUse;
+    id: string;
+    text: string;
+    choices: unknown[];
+    flags: Record<string, unknown>;
+    lastAccessed: number;
+    constructor();
+    reset(): void;
+    isInUse(): boolean;
+    setInUse(inUse: boolean): void;
+    initialize(id: string, text: string, choices?: unknown[]): void;
+    touch(): void;
+}
+/**
+ * Pooled Asset object for narrative resources
+ */
+export declare class PooledAsset implements Poolable {
+    private _inUse;
+    id: string;
+    type: string;
+    data: unknown;
+    size: number;
+    loaded: boolean;
+    constructor();
+    reset(): void;
+    isInUse(): boolean;
+    setInUse(inUse: boolean): void;
+    initialize(id: string, type: string, data: unknown): void;
+    private calculateSize;
+}
+/**
+ * Pool Manager - Centralized management of all object pools
+ */
+export declare class PoolManager {
+    private static instance;
+    private flowPool;
+    private nodePool;
+    private assetPool;
+    private constructor();
+    static getInstance(): PoolManager;
+    borrowFlow(): PooledFlow;
+    returnFlow(flow: PooledFlow): void;
+    borrowNode(): PooledNode;
+    returnNode(node: PooledNode): void;
+    borrowAsset(): PooledAsset;
+    returnAsset(asset: PooledAsset): void;
+    getAllStats(): {
+        flows: {
+            poolSize: number;
+            maxSize: number;
+            created: number;
+            borrowed: number;
+            returned: number;
+            inUse: number;
+            hitRate: number;
+        };
+        nodes: {
+            poolSize: number;
+            maxSize: number;
+            created: number;
+            borrowed: number;
+            returned: number;
+            inUse: number;
+            hitRate: number;
+        };
+        assets: {
+            poolSize: number;
+            maxSize: number;
+            created: number;
+            borrowed: number;
+            returned: number;
+            inUse: number;
+            hitRate: number;
+        };
+    };
+    getGCPressureReduction(): number;
+    clearAllPools(): void;
+}
+export declare const poolManager: PoolManager;
+//# sourceMappingURL=ObjectPool.d.ts.map

package/dist/performance/ObjectPool.d.ts.map

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