qnce-engine 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 ByteSower
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,225 @@
+# QNCE Engine
+
+**Quantum Narrative Convergence Engine** - A framework-agnostic TypeScript library for creating interactive narrative experiences with quantum-inspired mechanics.
+
+## Core Concepts
+
+- **Superposition:** Multiple narrative outcomes exist simultaneously until a choice is made
+- **Collapse:** Player choices "collapse" the narrative to a specific path, updating state and flags
+- **Entanglement:** Early decisions affect later outcomes, enabling complex, interconnected stories
+
+## Installation
+
+```bash
+npm install qnce-engine
+```
+
+## Quick Start
+
+```typescript
+import { createQNCEEngine, DEMO_STORY } from 'qnce-engine';
+
+// Create engine instance with demo story
+const engine = createQNCEEngine(DEMO_STORY);
+
+// Get current narrative state
+const currentNode = engine.getCurrentNode();
+console.log(currentNode.text);
+
+// Get available choices
+const choices = engine.getAvailableChoices();
+console.log(choices);
+
+// Make a choice
+if (choices.length > 0) {
+  engine.selectChoice(choices[0]);
+}
+
+// Check narrative flags
+const flags = engine.getFlags();
+console.log('Current flags:', flags);
+```
+
+## Core API
+
+### QNCEEngine Class
+
+The main engine class for managing narrative state.
+
+#### Methods
+
+- `getCurrentNode()`: Get the current narrative node
+- `getState()`: Get the complete engine state
+- `getFlags()`: Get current narrative flags
+- `getHistory()`: Get choice history
+- `selectChoice(choice)`: Make a narrative choice
+- `resetNarrative()`: Reset to initial state
+- `loadState(state)`: Load a saved state
+- `checkFlag(name, value?)`: Check flag conditions
+- `getAvailableChoices()`: Get filtered available choices
+
+### Factory Functions
+
+- `createQNCEEngine(storyData, initialState?)`: Create a new engine instance
+- `loadStoryData(jsonData)`: Load and validate story data from JSON
+
+## Story Format
+
+Stories are defined using JSON with the following structure:
+
+```json
+{
+  "initialNodeId": "start",
+  "nodes": [
+    {
+      "id": "start",
+      "text": "You stand at a crossroads...",
+      "choices": [
+        {
+          "text": "Go left",
+          "nextNodeId": "left_path",
+          "flagEffects": { "direction": "left" }
+        }
+      ]
+    }
+  ]
+}
+```
+
+## CLI Tools
+
+### qnce-audit
+
+Validate your story structure:
+
+```bash
+qnce-audit story.json
+```
+
+Features:
+- Checks for missing node references
+- Identifies unreachable nodes
+- Finds dead ends
+- Validates story structure
+
+### qnce-init
+
+Scaffold a new QNCE project:
+
+```bash
+qnce-init my-story
+```
+
+Creates:
+- Basic story template
+- package.json with QNCE dependencies
+- README with usage instructions
+
+## Integration Examples
+
+### React Hook
+
+```typescript
+import { createQNCEEngine } from 'qnce-engine';
+import { useState, useEffect } from 'react';
+
+function useQNCE(storyData) {
+  const [engine] = useState(() => createQNCEEngine(storyData));
+  const [currentNode, setCurrentNode] = useState(engine.getCurrentNode());
+  const [flags, setFlags] = useState(engine.getFlags());
+
+  const selectChoice = (choice) => {
+    engine.selectChoice(choice);
+    setCurrentNode(engine.getCurrentNode());
+    setFlags(engine.getFlags());
+  };
+
+  return { currentNode, flags, selectChoice };
+}
+```
+
+### Vue Composition API
+
+```typescript
+import { createQNCEEngine } from 'qnce-engine';
+import { ref, reactive } from 'vue';
+
+export function useQNCE(storyData) {
+  const engine = createQNCEEngine(storyData);
+  const currentNode = ref(engine.getCurrentNode());
+  const flags = reactive(engine.getFlags());
+
+  const selectChoice = (choice) => {
+    engine.selectChoice(choice);
+    currentNode.value = engine.getCurrentNode();
+    Object.assign(flags, engine.getFlags());
+  };
+
+  return { currentNode, flags, selectChoice };
+}
+```
+
+### Node.js CLI
+
+```typescript
+import { createQNCEEngine, loadStoryData } from 'qnce-engine';
+import { readFileSync } from 'fs';
+import * as readline from 'readline';
+
+const storyData = loadStoryData(JSON.parse(readFileSync('story.json', 'utf-8')));
+const engine = createQNCEEngine(storyData);
+
+async function playStory() {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+
+  while (true) {
+    const node = engine.getCurrentNode();
+    console.log('\n' + node.text);
+    
+    if (node.choices.length === 0) break;
+    
+    node.choices.forEach((choice, i) => {
+      console.log(`${i + 1}. ${choice.text}`);
+    });
+    
+    // Get user input and make choice...
+  }
+}
+```
+
+## Development
+
+```bash
+# Clone and setup
+git clone https://github.com/ByteSower/qnce-engine.git
+cd qnce-engine
+npm install
+
+# Build
+npm run build
+
+# Watch mode
+npm run build:watch
+
+# Lint
+npm run lint
+```
+
+## License
+
+MIT - See LICENSE file for details.
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests if applicable
+5. Submit a pull request
+
+---
+
+**QNCE Engine** - Empowering interactive narratives with quantum-inspired mechanics.

package/dist/cli/audit.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=audit.d.ts.map

package/dist/cli/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/cli/audit.ts"],"names":[],"mappings":""}

package/dist/cli/audit.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+import { readFileSync } from 'fs';
+import { loadStoryData } from '../engine/core.js';
+/**
+ * QNCE Audit CLI Tool
+ * Validates narrative structure and checks for loops, dead ends, etc.
+ */
+function auditStory(filePath) {
+    try {
+        console.log(`🔍 Auditing QNCE story: ${filePath}`);
+        const jsonData = JSON.parse(readFileSync(filePath, 'utf-8'));
+        const storyData = loadStoryData(jsonData);
+        // Basic validation
+        console.log(`📖 Story contains ${storyData.nodes.length} nodes`);
+        console.log(`🚀 Initial node: ${storyData.initialNodeId}`);
+        // Check for missing nodes
+        const nodeIds = new Set(storyData.nodes.map(n => n.id));
+        const referencedIds = new Set();
+        storyData.nodes.forEach(node => {
+            node.choices.forEach(choice => {
+                referencedIds.add(choice.nextNodeId);
+            });
+        });
+        // Find dead ends
+        const deadEnds = storyData.nodes.filter(node => node.choices.length === 0);
+        console.log(`🔚 Dead ends found: ${deadEnds.length}`);
+        deadEnds.forEach(node => console.log(`   - ${node.id}: "${node.text.slice(0, 50)}..."`));
+        // Find missing node references
+        const missingNodes = Array.from(referencedIds).filter(id => !nodeIds.has(id));
+        if (missingNodes.length > 0) {
+            console.log(`❌ Missing nodes referenced:`);
+            missingNodes.forEach(id => console.log(`   - ${id}`));
+        }
+        else {
+            console.log(`✅ All node references are valid`);
+        }
+        // Find unreachable nodes
+        const reachableIds = new Set();
+        const toVisit = [storyData.initialNodeId];
+        while (toVisit.length > 0) {
+            const currentId = toVisit.pop();
+            if (reachableIds.has(currentId))
+                continue;
+            reachableIds.add(currentId);
+            const node = storyData.nodes.find(n => n.id === currentId);
+            if (node) {
+                node.choices.forEach(choice => {
+                    if (!reachableIds.has(choice.nextNodeId)) {
+                        toVisit.push(choice.nextNodeId);
+                    }
+                });
+            }
+        }
+        const unreachableNodes = storyData.nodes.filter(node => !reachableIds.has(node.id));
+        if (unreachableNodes.length > 0) {
+            console.log(`⚠️  Unreachable nodes found: ${unreachableNodes.length}`);
+            unreachableNodes.forEach(node => console.log(`   - ${node.id}`));
+        }
+        else {
+            console.log(`✅ All nodes are reachable`);
+        }
+        console.log(`✨ Audit complete!`);
+    }
+    catch (error) {
+        console.error(`❌ Error auditing story:`, error);
+        process.exit(1);
+    }
+}
+// CLI entry point
+const filePath = process.argv[2];
+if (!filePath) {
+    console.log('Usage: qnce-audit <story-file.json>');
+    process.exit(1);
+}
+auditStory(filePath);
+//# sourceMappingURL=audit.js.map

package/dist/cli/audit.js.map

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

package/dist/cli/init.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":""}

package/dist/cli/init.js

@@ -0,0 +1,136 @@
+#!/usr/bin/env node
+import { writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+/**
+ * QNCE Init CLI Tool
+ * Scaffolds a new QNCE story project
+ */
+function initProject(projectName) {
+    try {
+        console.log(`🚀 Initializing QNCE project: ${projectName}`);
+        // Create project directory
+        mkdirSync(projectName, { recursive: true });
+        // Create basic story template
+        const storyTemplate = {
+            initialNodeId: 'start',
+            nodes: [
+                {
+                    id: 'start',
+                    text: 'Welcome to your QNCE story! This is the beginning.',
+                    choices: [
+                        {
+                            text: 'Continue',
+                            nextNodeId: 'middle',
+                            flagEffects: { started: true }
+                        }
+                    ]
+                },
+                {
+                    id: 'middle',
+                    text: 'You are now in the middle of your story. Where do you want to go next?',
+                    choices: [
+                        {
+                            text: 'Go to the ending',
+                            nextNodeId: 'end',
+                            flagEffects: { visitedMiddle: true }
+                        },
+                        {
+                            text: 'Go back to start',
+                            nextNodeId: 'start',
+                            flagEffects: { wentBack: true }
+                        }
+                    ]
+                },
+                {
+                    id: 'end',
+                    text: 'Congratulations! You have reached the end of your story.',
+                    choices: []
+                }
+            ]
+        };
+        // Write story file
+        const storyPath = join(projectName, 'story.json');
+        writeFileSync(storyPath, JSON.stringify(storyTemplate, null, 2));
+        // Create package.json
+        const packageJson = {
+            name: projectName,
+            version: '1.0.0',
+            description: 'A QNCE interactive narrative',
+            main: 'story.json',
+            scripts: {
+                audit: 'qnce-audit story.json'
+            },
+            dependencies: {
+                'qnce-engine': '^0.1.0'
+            }
+        };
+        const packagePath = join(projectName, 'package.json');
+        writeFileSync(packagePath, JSON.stringify(packageJson, null, 2));
+        // Create README
+        const readme = `# ${projectName}
+
+A QNCE (Quantum Narrative Convergence Engine) interactive story.
+
+## Getting Started
+
+1. Install dependencies:
+   \`\`\`bash
+   npm install
+   \`\`\`
+
+2. Edit your story in \`story.json\`
+
+3. Audit your story for issues:
+   \`\`\`bash
+   npm run audit
+   \`\`\`
+
+## Story Structure
+
+Your story is defined in \`story.json\` with the following structure:
+
+- \`initialNodeId\`: The starting node of your story
+- \`nodes\`: Array of narrative nodes, each with:
+  - \`id\`: Unique identifier
+  - \`text\`: The narrative text
+  - \`choices\`: Array of choices leading to other nodes
+
+## Using QNCE Engine
+
+\`\`\`javascript
+import { createQNCEEngine, loadStoryData } from 'qnce-engine';
+import storyData from './story.json';
+
+const engine = createQNCEEngine(storyData);
+const currentNode = engine.getCurrentNode();
+console.log(currentNode.text);
+\`\`\`
+
+Happy storytelling!
+`;
+        const readmePath = join(projectName, 'README.md');
+        writeFileSync(readmePath, readme);
+        console.log(`✅ Project created successfully!`);
+        console.log(`📁 Files created:`);
+        console.log(`   - ${storyPath}`);
+        console.log(`   - ${packagePath}`);
+        console.log(`   - ${readmePath}`);
+        console.log('');
+        console.log(`🎯 Next steps:`);
+        console.log(`   cd ${projectName}`);
+        console.log(`   npm install`);
+        console.log(`   npm run audit`);
+    }
+    catch (error) {
+        console.error(`❌ Error creating project:`, error);
+        process.exit(1);
+    }
+}
+// CLI entry point
+const projectName = process.argv[2];
+if (!projectName) {
+    console.log('Usage: qnce-init <project-name>');
+    process.exit(1);
+}
+initProject(projectName);
+//# sourceMappingURL=init.js.map

package/dist/cli/init.js.map

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

package/dist/engine/core.d.ts

@@ -0,0 +1,46 @@
+export interface Choice {
+    text: string;
+    nextNodeId: string;
+    flagEffects?: Record<string, any>;
+}
+export interface NarrativeNode {
+    id: string;
+    text: string;
+    choices: Choice[];
+}
+export interface QNCEState {
+    currentNodeId: string;
+    flags: Record<string, any>;
+    history: string[];
+}
+export interface StoryData {
+    nodes: NarrativeNode[];
+    initialNodeId: string;
+}
+/**
+ * QNCE Engine - Core narrative state management
+ * Framework agnostic implementation
+ */
+export declare class QNCEEngine {
+    private state;
+    private storyData;
+    constructor(storyData: StoryData, initialState?: Partial<QNCEState>);
+    getCurrentNode(): NarrativeNode;
+    getState(): QNCEState;
+    getFlags(): Record<string, any>;
+    getHistory(): string[];
+    selectChoice(choice: Choice): void;
+    resetNarrative(): void;
+    loadState(state: QNCEState): void;
+    checkFlag(flagName: string, expectedValue?: any): boolean;
+    getAvailableChoices(): Choice[];
+}
+/**
+ * Factory function to create a QNCE engine instance
+ */
+export declare function createQNCEEngine(storyData: StoryData, initialState?: Partial<QNCEState>): QNCEEngine;
+/**
+ * Load story data from JSON
+ */
+export declare function loadStoryData(jsonData: any): StoryData;
+//# sourceMappingURL=core.d.ts.map

package/dist/engine/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/engine/core.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB;AAUD;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,SAAS,CAAY;gBAEjB,SAAS,EAAE,SAAS,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC;IASnE,cAAc,IAAI,aAAa;IAI/B,QAAQ,IAAI,SAAS;IAIrB,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAI/B,UAAU,IAAI,MAAM,EAAE;IAItB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IASlC,cAAc,IAAI,IAAI;IAMtB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAKjC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,GAAG,GAAG,OAAO;IAQzD,mBAAmB,IAAI,MAAM,EAAE;CAOhC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,UAAU,CAEpG;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,GAAG,GAAG,SAAS,CAGtD"}

package/dist/engine/core.js

@@ -0,0 +1,81 @@
+// QNCE Core Engine - Framework Agnostic
+// Quantum Narrative Convergence Engine
+// Demo narrative data moved to demo-story.ts
+function findNode(nodes, id) {
+    const node = nodes.find(n => n.id === id);
+    if (!node)
+        throw new Error(`Node not found: ${id}`);
+    return node;
+}
+/**
+ * QNCE Engine - Core narrative state management
+ * Framework agnostic implementation
+ */
+export class QNCEEngine {
+    state;
+    storyData;
+    constructor(storyData, initialState) {
+        this.storyData = storyData;
+        this.state = {
+            currentNodeId: initialState?.currentNodeId || storyData.initialNodeId,
+            flags: initialState?.flags || {},
+            history: initialState?.history || [storyData.initialNodeId],
+        };
+    }
+    getCurrentNode() {
+        return findNode(this.storyData.nodes, this.state.currentNodeId);
+    }
+    getState() {
+        return { ...this.state };
+    }
+    getFlags() {
+        return { ...this.state.flags };
+    }
+    getHistory() {
+        return [...this.state.history];
+    }
+    selectChoice(choice) {
+        this.state.currentNodeId = choice.nextNodeId;
+        this.state.history.push(choice.nextNodeId);
+        if (choice.flagEffects) {
+            this.state.flags = { ...this.state.flags, ...choice.flagEffects };
+        }
+    }
+    resetNarrative() {
+        this.state.currentNodeId = this.storyData.initialNodeId;
+        this.state.flags = {};
+        this.state.history = [this.storyData.initialNodeId];
+    }
+    loadState(state) {
+        this.state = { ...state };
+    }
+    // Utility method for checking flag conditions
+    checkFlag(flagName, expectedValue) {
+        if (expectedValue === undefined) {
+            return this.state.flags[flagName] !== undefined;
+        }
+        return this.state.flags[flagName] === expectedValue;
+    }
+    // Get available choices (with potential flag-based filtering)
+    getAvailableChoices() {
+        const currentNode = this.getCurrentNode();
+        return currentNode.choices.filter(choice => {
+            // Future: Add flag-based choice filtering logic here
+            return true;
+        });
+    }
+}
+/**
+ * Factory function to create a QNCE engine instance
+ */
+export function createQNCEEngine(storyData, initialState) {
+    return new QNCEEngine(storyData, initialState);
+}
+/**
+ * Load story data from JSON
+ */
+export function loadStoryData(jsonData) {
+    // Add validation here in the future
+    return jsonData;
+}
+//# sourceMappingURL=core.js.map

package/dist/engine/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../src/engine/core.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,uCAAuC;AA0BvC,6CAA6C;AAE7C,SAAS,QAAQ,CAAC,KAAsB,EAAE,EAAU;IAClD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1C,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;IACpD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,UAAU;IACb,KAAK,CAAY;IACjB,SAAS,CAAY;IAE7B,YAAY,SAAoB,EAAE,YAAiC;QACjE,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG;YACX,aAAa,EAAE,YAAY,EAAE,aAAa,IAAI,SAAS,CAAC,aAAa;YACrE,KAAK,EAAE,YAAY,EAAE,KAAK,IAAI,EAAE;YAChC,OAAO,EAAE,YAAY,EAAE,OAAO,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC;SAC5D,CAAC;IACJ,CAAC;IAED,cAAc;QACZ,OAAO,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAClE,CAAC;IAED,QAAQ;QACN,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED,QAAQ;QACN,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACjC,CAAC;IAED,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,YAAY,CAAC,MAAc;QACzB,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,MAAM,CAAC,UAAU,CAAC;QAC7C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAE3C,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QACpE,CAAC;IACH,CAAC;IAED,cAAc;QACZ,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC;QACxD,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC;QACtB,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IACtD,CAAC;IAED,SAAS,CAAC,KAAgB;QACxB,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED,8CAA8C;IAC9C,SAAS,CAAC,QAAgB,EAAE,aAAmB;QAC7C,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,SAAS,CAAC;QAClD,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,aAAa,CAAC;IACtD,CAAC;IAED,8DAA8D;IAC9D,mBAAmB;QACjB,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QAC1C,OAAO,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;YACzC,qDAAqD;YACrD,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAoB,EAAE,YAAiC;IACtF,OAAO,IAAI,UAAU,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,QAAa;IACzC,oCAAoC;IACpC,OAAO,QAAqB,CAAC;AAC/B,CAAC"}

package/dist/engine/demo-story.d.ts

@@ -0,0 +1,3 @@
+import { StoryData } from './core.js';
+export declare const DEMO_STORY: StoryData;
+//# sourceMappingURL=demo-story.d.ts.map

package/dist/engine/demo-story.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo-story.d.ts","sourceRoot":"","sources":["../../src/engine/demo-story.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,eAAO,MAAM,UAAU,EAAE,SA6GxB,CAAC"}

package/dist/engine/demo-story.js

@@ -0,0 +1,112 @@
+// Demo narrative data for QNCE Engine
+export const DEMO_STORY = {
+    initialNodeId: 'start',
+    nodes: [
+        {
+            id: 'start',
+            text: 'You stand at a crossroads. Do you go left or right?',
+            choices: [
+                { text: 'Left', nextNodeId: 'river', flagEffects: { wentLeft: true } },
+                { text: 'Right', nextNodeId: 'mountain', flagEffects: { wentLeft: false } },
+            ],
+        },
+        {
+            id: 'river',
+            text: 'You encounter a river. Do you swim or build a raft?',
+            choices: [
+                { text: 'Swim', nextNodeId: 'swim', flagEffects: { gotWet: true } },
+                { text: 'Build a raft', nextNodeId: 'raft', flagEffects: { gotWet: false } },
+            ],
+        },
+        {
+            id: 'mountain',
+            text: 'You find a mountain. Do you climb or go around?',
+            choices: [
+                { text: 'Climb', nextNodeId: 'climb', flagEffects: { climbed: true } },
+                { text: 'Go around', nextNodeId: 'village', flagEffects: { climbed: false } },
+            ],
+        },
+        // --- Expanded Narrative Branches ---
+        {
+            id: 'swim',
+            text: 'You swim across and reach the other side, but you are soaked and cold. Ahead, you see a cave and a campfire.',
+            choices: [
+                { text: 'Warm up by the campfire', nextNodeId: 'campfire', flagEffects: { warmedUp: true } },
+                { text: 'Explore the cave', nextNodeId: 'cave', flagEffects: { exploredCave: true } },
+            ],
+        },
+        {
+            id: 'raft',
+            text: 'You build a raft and float safely. On the far bank, a merchant greets you.',
+            choices: [
+                { text: 'Trade with the merchant', nextNodeId: 'merchant', flagEffects: { metMerchant: true } },
+                { text: 'Ignore and continue', nextNodeId: 'forest', flagEffects: { metMerchant: false } },
+            ],
+        },
+        {
+            id: 'climb',
+            text: 'You climb and see a vast land. The wind is strong. Do you signal for help or descend?',
+            choices: [
+                { text: 'Signal for help', nextNodeId: 'signal', flagEffects: { signaled: true } },
+                { text: 'Descend', nextNodeId: 'forest', flagEffects: { signaled: false } },
+            ],
+        },
+        {
+            id: 'village',
+            text: 'You go around and find a village. The villagers are wary. Do you introduce yourself or sneak past?',
+            choices: [
+                { text: 'Introduce yourself', nextNodeId: 'welcome', flagEffects: { welcomed: true } },
+                { text: 'Sneak past', nextNodeId: 'forest', flagEffects: { welcomed: false } },
+            ],
+        },
+        // --- New Unique Outcomes & Entanglement ---
+        {
+            id: 'campfire',
+            text: 'You warm up by the fire. A traveler offers you advice. (Success!)',
+            choices: [],
+        },
+        {
+            id: 'cave',
+            text: 'Inside the cave, you find ancient markings. Suddenly, you slip and must return to the river bank. (Loop)',
+            choices: [
+                { text: 'Return to river', nextNodeId: 'river', flagEffects: { slipped: true } },
+            ],
+        },
+        {
+            id: 'merchant',
+            text: 'The merchant gives you a mysterious key. (Reward!)',
+            choices: [],
+        },
+        {
+            id: 'forest',
+            text: 'You enter a dense forest. If you met the merchant, you can unlock a shortcut.',
+            choices: [
+                { text: 'Use the key (if you have it)', nextNodeId: 'shortcut', flagEffects: { usedKey: true } },
+                { text: 'Push through the forest', nextNodeId: 'lost', flagEffects: { usedKey: false } },
+            ],
+        },
+        {
+            id: 'signal',
+            text: 'Your signal is seen! A rescue party arrives. (Success!)',
+            choices: [],
+        },
+        {
+            id: 'welcome',
+            text: 'The villagers welcome you and offer food. (Success!)',
+            choices: [],
+        },
+        {
+            id: 'shortcut',
+            text: 'You use the key to unlock a hidden path and escape the forest. (Success!)',
+            choices: [],
+        },
+        {
+            id: 'lost',
+            text: 'You get lost in the forest. (Failure/Loop)',
+            choices: [
+                { text: 'Try to find your way back', nextNodeId: 'forest', flagEffects: { triedAgain: true } },
+            ],
+        },
+    ],
+};
+//# sourceMappingURL=demo-story.js.map

package/dist/engine/demo-story.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './engine/core.js';
+export { DEMO_STORY } from './engine/demo-story.js';
+export { QNCEEngine, createQNCEEngine, loadStoryData, type Choice, type NarrativeNode, type QNCEState, type StoryData } from './engine/core.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":"AACA,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGpD,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,KAAK,MAAM,EACX,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+// QNCE Engine - Main Export
+export * from './engine/core.js';
+export { DEMO_STORY } from './engine/demo-story.js';
+// Re-export for convenience
+export { QNCEEngine, createQNCEEngine, loadStoryData } from './engine/core.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,4BAA4B;AAC5B,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,4BAA4B;AAC5B,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,aAAa,EAKd,MAAM,kBAAkB,CAAC"}

package/examples/quantum-garden.js

@@ -0,0 +1,99 @@
+// Example: Complete QNCE Engine Integration
+import { createQNCEEngine } from '../dist/index.js';
+
+// Define a custom story
+const customStory = {
+  initialNodeId: "garden_entrance",
+  nodes: [
+    {
+      id: "garden_entrance",
+      text: "You approach a shimmering garden where flowers exist in quantum superposition, both blooming and wilted until observed. What do you do?",
+      choices: [
+        {
+          text: "Observe the flowers carefully",
+          nextNodeId: "collapsed_garden",
+          flagEffects: { flowersObserved: true }
+        },
+        {
+          text: "Enter with eyes closed",
+          nextNodeId: "superposition_garden",
+          flagEffects: { preservedSuperposition: true }
+        }
+      ]
+    },
+    {
+      id: "collapsed_garden",
+      text: "Your observation collapses the quantum state. The flowers are now definitively wilted, their beauty lost to the measurement.",
+      choices: [
+        {
+          text: "Plant new seeds",
+          nextNodeId: "rebirth",
+          flagEffects: { plantedSeeds: true }
+        }
+      ]
+    },
+    {
+      id: "superposition_garden",
+      text: "Moving blindly, you preserve the flowers' superposition. You feel their quantum essence - simultaneously beautiful and decayed.",
+      choices: [
+        {
+          text: "Meditate in the quantum space",
+          nextNodeId: "enlightenment",
+          flagEffects: { achievedEnlightenment: true }
+        }
+      ]
+    },
+    {
+      id: "rebirth",
+      text: "Your seeds grow instantly, creating new quantum flowers. The cycle begins anew.",
+      choices: []
+    },
+    {
+      id: "enlightenment",
+      text: "You achieve quantum consciousness, understanding that observation and preservation can coexist.",
+      choices: []
+    }
+  ]
+};
+
+// Create and use the engine
+const engine = createQNCEEngine(customStory);
+
+// Interactive session example
+function playSession() {
+  console.log(`🌟 Welcome to "The Quantum Garden"`);
+  console.log(`📖 A tale of superposition and choice\n`);
+  
+  while (true) {
+    const node = engine.getCurrentNode();
+    console.log(`📍 ${node.text}\n`);
+    
+    const choices = engine.getAvailableChoices();
+    if (choices.length === 0) {
+      console.log("🏁 Story Complete!");
+      console.log("Final state:", engine.getFlags());
+      break;
+    }
+    
+    // Display choices
+    choices.forEach((choice, index) => {
+      console.log(`${index + 1}. ${choice.text}`);
+    });
+    
+    // For demo, select first choice
+    const selected = choices[0];
+    console.log(`\n➡️  Selecting: "${selected.text}"\n`);
+    engine.selectChoice(selected);
+    
+    // Show state changes
+    const flags = engine.getFlags();
+    if (Object.keys(flags).length > 0) {
+      console.log("🏷️  Updated flags:", flags, "\n");
+    }
+    
+    console.log("---\n");
+  }
+}
+
+// Run the demo
+playSession();

package/examples/quantum-garden.ts

@@ -0,0 +1,99 @@
+// Example: Complete QNCE Engine Integration (TypeScript)
+import { createQNCEEngine, type StoryData } from 'qnce-engine';
+
+// Define a custom story
+const customStory: StoryData = {
+  initialNodeId: "garden_entrance",
+  nodes: [
+    {
+      id: "garden_entrance",
+      text: "You approach a shimmering garden where flowers exist in quantum superposition, both blooming and wilted until observed. What do you do?",
+      choices: [
+        {
+          text: "Observe the flowers carefully",
+          nextNodeId: "collapsed_garden",
+          flagEffects: { flowersObserved: true }
+        },
+        {
+          text: "Enter with eyes closed",
+          nextNodeId: "superposition_garden",
+          flagEffects: { preservedSuperposition: true }
+        }
+      ]
+    },
+    {
+      id: "collapsed_garden",
+      text: "Your observation collapses the quantum state. The flowers are now definitively wilted, their beauty lost to the measurement.",
+      choices: [
+        {
+          text: "Plant new seeds",
+          nextNodeId: "rebirth",
+          flagEffects: { plantedSeeds: true }
+        }
+      ]
+    },
+    {
+      id: "superposition_garden",
+      text: "Moving blindly, you preserve the flowers' superposition. You feel their quantum essence - simultaneously beautiful and decayed.",
+      choices: [
+        {
+          text: "Meditate in the quantum space",
+          nextNodeId: "enlightenment",
+          flagEffects: { achievedEnlightenment: true }
+        }
+      ]
+    },
+    {
+      id: "rebirth",
+      text: "Your seeds grow instantly, creating new quantum flowers. The cycle begins anew.",
+      choices: []
+    },
+    {
+      id: "enlightenment",
+      text: "You achieve quantum consciousness, understanding that observation and preservation can coexist.",
+      choices: []
+    }
+  ]
+};
+
+// Create and use the engine
+const engine = createQNCEEngine(customStory);
+
+// Interactive session example
+function playSession(): void {
+  console.log(`🌟 Welcome to "The Quantum Garden"`);
+  console.log(`📖 A tale of superposition and choice\n`);
+  
+  while (true) {
+    const node = engine.getCurrentNode();
+    console.log(`📍 ${node.text}\n`);
+    
+    const choices = engine.getAvailableChoices();
+    if (choices.length === 0) {
+      console.log("🏁 Story Complete!");
+      console.log("Final state:", engine.getFlags());
+      break;
+    }
+    
+    // Display choices
+    choices.forEach((choice, index) => {
+      console.log(`${index + 1}. ${choice.text}`);
+    });
+    
+    // For demo, select first choice
+    const selected = choices[0];
+    console.log(`\n➡️  Selecting: "${selected.text}"\n`);
+    engine.selectChoice(selected);
+    
+    // Show state changes
+    const flags = engine.getFlags();
+    if (Object.keys(flags).length > 0) {
+      console.log("🏷️  Updated flags:", flags, "\n");
+    }
+    
+    console.log("---\n");
+  }
+}
+
+// Run the demo
+playSession();

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "qnce-engine",
+  "version": "0.1.0",
+  "description": "Core QNCE (Quantum Narrative Convergence Engine) - Framework agnostic narrative engine",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "bin": {
+    "qnce-audit": "dist/cli/audit.js",
+    "qnce-init": "dist/cli/init.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "lint": "eslint .",
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "narrative",
+    "interactive-fiction",
+    "quantum-narrative",
+    "story-engine",
+    "choice-based",
+    "typescript"
+  ],
+  "author": "ByteSower",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ByteSower/qnce-engine.git"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "~5.8.3"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE",
+    "examples/**/*"
+  ]
+}