@magicborn/dialogue-forge 0.1.0

package/dist/examples/yarn-examples.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Inline Yarn file contents for examples
+ * This allows examples to be bundled and loaded synchronously
+ *
+ * To add a new example:
+ * 1. Create a .yarn file in the examples directory
+ * 2. Copy its content here as a string literal
+ * 3. Add it to the yarnExamplesContent object
+ */
+import { DialogueTree } from '../types';
+/**
+ * Load all examples synchronously
+ * This should be called once at initialization
+ */
+export declare function loadAllExamples(): Record<string, DialogueTree>;
+/**
+ * Get a loaded example dialogue
+ */
+export declare function getExampleDialogue(exampleId: string): DialogueTree | null;
+/**
+ * Get all loaded examples
+ */
+export declare function getAllExampleDialogues(): Record<string, DialogueTree>;
+/**
+ * Get flag schema for an example
+ */
+export declare function getExampleFlagSchema(exampleId: string): import("..").FlagSchema | null;
+/**
+ * Check if an example has Yarn content available
+ */
+export declare function hasExampleContent(exampleId: string): boolean;
+/**
+ * Get list of example IDs that have content available
+ */
+export declare function getAvailableExampleIds(): string[];

package/dist/examples/yarn-examples.js

@@ -0,0 +1,189 @@
+"use strict";
+/**
+ * Inline Yarn file contents for examples
+ * This allows examples to be bundled and loaded synchronously
+ *
+ * To add a new example:
+ * 1. Create a .yarn file in the examples directory
+ * 2. Copy its content here as a string literal
+ * 3. Add it to the yarnExamplesContent object
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadAllExamples = loadAllExamples;
+exports.getExampleDialogue = getExampleDialogue;
+exports.getAllExampleDialogues = getAllExampleDialogues;
+exports.getExampleFlagSchema = getExampleFlagSchema;
+exports.hasExampleContent = hasExampleContent;
+exports.getAvailableExampleIds = getAvailableExampleIds;
+const yarn_converter_1 = require("../lib/yarn-converter");
+const examples_registry_1 = require("./examples-registry");
+/**
+ * Map of example ID to Yarn file content
+ * All examples are stored as Yarn strings here for easy discovery and maintenance
+ */
+const yarnExamplesContent = {
+    'variable-operations': `title: merchant_shop
+---
+Merchant: Welcome to my shop, {$player_name}!
+Merchant: You currently have {$stat_gold} gold pieces.
+<<if $stat_gold >= 100>>
+    Merchant: You can afford the sword! It costs 100 gold.
+    -> Buy the sword
+        <<set $item_sword = true>>
+        <<set $stat_gold -= 100>>
+        Merchant: Thank you for your purchase! You now have {$stat_gold} gold.
+        <<jump after_purchase>>
+    -> Maybe later
+        Merchant: Come back anytime!
+        <<jump end>>
+<<elseif $stat_gold >= 50>>
+    Merchant: You can afford the potion! It costs 50 gold.
+    -> Buy the potion
+        <<set $item_potion = true>>
+        <<set $stat_gold -= 50>>
+        Merchant: Thank you! You now have {$stat_gold} gold.
+        <<jump after_purchase>>
+    -> Save up for the sword
+        Merchant: Wise choice! Come back when you have more gold.
+        <<jump end>>
+<<else>>
+    Merchant: I'm sorry, but you don't have enough gold for anything.
+    Merchant: Come back when you have at least 50 gold pieces.
+    <<jump end>>
+<<endif>>
+===
+
+title: after_purchase
+---
+Merchant: Is there anything else you'd like?
+<<set $stat_reputation += 5>>
+Merchant: Your reputation with me has increased! It's now {$stat_reputation}.
+-> Browse more
+    <<jump merchant_shop>>
+-> Leave
+    Merchant: Thanks for shopping!
+    <<jump end>>
+===
+
+title: quest_reward
+---
+QuestGiver: You've completed the quest! Here's your reward.
+<<set $stat_gold += 500>>
+<<set $stat_experience += 100>>
+<<set $quest_dragon_slayer = "complete">>
+QuestGiver: You received 500 gold and 100 experience!
+QuestGiver: You now have {$stat_gold} gold and {$stat_experience} experience points.
+<<jump end>>
+===
+
+title: stat_multiplier
+---
+Trainer: I can double your strength for a price.
+<<if $stat_gold >= 200>>
+    Trainer: For 200 gold, I'll double your strength stat.
+    -> Pay for training
+        <<set $stat_strength *= 2>>
+        <<set $stat_gold -= 200>>
+        Trainer: Your strength is now {$stat_strength}!
+        <<jump end>>
+    -> Not right now
+        Trainer: Come back when you're ready.
+        <<jump end>>
+<<else>>
+    Trainer: You need 200 gold for this training.
+    <<jump end>>
+<<endif>>
+===
+
+title: string_variables
+---
+NPC: Hello, {$player_name}! Welcome to {$location_name}.
+NPC: Your title is {$player_title}.
+<<set $greeting_count += 1>>
+NPC: I've greeted you {$greeting_count} times now.
+<<if $greeting_count >= 5>>
+    NPC: You're a regular here! Let me give you a discount.
+    <<set $stat_reputation += 10>>
+<<endif>>
+<<jump end>>
+===
+
+title: end
+---
+===
+`,
+    // Add more examples here as they're converted to Yarn format
+};
+/**
+ * Pre-loaded examples cache
+ */
+let examplesCache = {};
+/**
+ * Load all examples synchronously
+ * This should be called once at initialization
+ */
+function loadAllExamples() {
+    if (Object.keys(examplesCache).length > 0) {
+        return examplesCache;
+    }
+    const loaded = {};
+    for (const metadata of examples_registry_1.examplesRegistry) {
+        const yarnContent = yarnExamplesContent[metadata.id];
+        if (yarnContent) {
+            try {
+                const dialogue = (0, yarn_converter_1.importFromYarn)(yarnContent, metadata.title);
+                loaded[metadata.id] = dialogue;
+                metadata.nodeCount = Object.keys(dialogue.nodes).length;
+            }
+            catch (error) {
+                console.error(`Error loading example ${metadata.id}:`, error);
+            }
+        }
+    }
+    examplesCache = loaded;
+    return loaded;
+}
+// Pre-load examples when module is imported
+loadAllExamples();
+/**
+ * Get a loaded example dialogue
+ */
+function getExampleDialogue(exampleId) {
+    if (Object.keys(examplesCache).length === 0) {
+        loadAllExamples();
+    }
+    return examplesCache[exampleId] || null;
+}
+/**
+ * Get all loaded examples
+ */
+function getAllExampleDialogues() {
+    if (Object.keys(examplesCache).length === 0) {
+        loadAllExamples();
+    }
+    return examplesCache;
+}
+/**
+ * Get flag schema for an example
+ */
+function getExampleFlagSchema(exampleId) {
+    const metadata = examples_registry_1.examplesRegistry.find(ex => ex.id === exampleId);
+    if (!metadata) {
+        return null;
+    }
+    return examples_registry_1.exampleFlagSchemas[metadata.flagSchemaId] || null;
+}
+/**
+ * Check if an example has Yarn content available
+ */
+function hasExampleContent(exampleId) {
+    return exampleId in yarnExamplesContent;
+}
+/**
+ * Get list of example IDs that have content available
+ */
+function getAvailableExampleIds() {
+    return examples_registry_1.examplesRegistry
+        .filter(metadata => hasExampleContent(metadata.id))
+        .map(metadata => metadata.id);
+}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+export { DialogueEditorV2 } from './components/DialogueEditorV2';
+export { ScenePlayer } from './components/ScenePlayer';
+export type { ScenePlayerProps } from './components/ScenePlayer';
+export { ScenePlayer as DialogueSimulator } from './components/ScenePlayer';
+export { GuidePanel } from './components/GuidePanel';
+export { FlagSelector } from './components/FlagSelector';
+export { FlagManager } from './components/FlagManager';
+export { ZoomControls } from './components/ZoomControls';
+export { ExampleLoader } from './components/ExampleLoader';
+import './styles/scrollbar.css';
+import './styles/theme.css';
+export { exampleDialogues, demoFlagSchemas, getExampleDialogue, getDemoFlagSchema, listExamples, listDemoFlagSchemas } from './examples';
+export * from './types';
+export * from './types/flags';
+export * from './types/game-state';
+export * from './types/constants';
+export { flattenGameState, validateGameState, extractFlagsFromGameState, type FlattenConfig, type FlattenedState } from './utils/game-state-flattener';
+export { exportToYarn, importFromYarn } from './lib/yarn-converter';
+export { initializeFlags, mergeFlagUpdates, validateFlags, getFlagValue } from './lib/flag-manager';
+export * from './utils/node-helpers';
+export * from './utils/feature-flags';

package/dist/index.js

@@ -0,0 +1,66 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFlagValue = exports.validateFlags = exports.mergeFlagUpdates = exports.initializeFlags = exports.importFromYarn = exports.exportToYarn = exports.extractFlagsFromGameState = exports.validateGameState = exports.flattenGameState = exports.listDemoFlagSchemas = exports.listExamples = exports.getDemoFlagSchema = exports.getExampleDialogue = exports.demoFlagSchemas = exports.exampleDialogues = exports.ExampleLoader = exports.ZoomControls = exports.FlagManager = exports.FlagSelector = exports.GuidePanel = exports.DialogueSimulator = exports.ScenePlayer = exports.DialogueEditorV2 = void 0;
+var DialogueEditorV2_1 = require("./components/DialogueEditorV2");
+Object.defineProperty(exports, "DialogueEditorV2", { enumerable: true, get: function () { return DialogueEditorV2_1.DialogueEditorV2; } });
+var ScenePlayer_1 = require("./components/ScenePlayer");
+Object.defineProperty(exports, "ScenePlayer", { enumerable: true, get: function () { return ScenePlayer_1.ScenePlayer; } });
+// Legacy export for backward compatibility
+var ScenePlayer_2 = require("./components/ScenePlayer");
+Object.defineProperty(exports, "DialogueSimulator", { enumerable: true, get: function () { return ScenePlayer_2.ScenePlayer; } });
+var GuidePanel_1 = require("./components/GuidePanel");
+Object.defineProperty(exports, "GuidePanel", { enumerable: true, get: function () { return GuidePanel_1.GuidePanel; } });
+var FlagSelector_1 = require("./components/FlagSelector");
+Object.defineProperty(exports, "FlagSelector", { enumerable: true, get: function () { return FlagSelector_1.FlagSelector; } });
+var FlagManager_1 = require("./components/FlagManager");
+Object.defineProperty(exports, "FlagManager", { enumerable: true, get: function () { return FlagManager_1.FlagManager; } });
+var ZoomControls_1 = require("./components/ZoomControls");
+Object.defineProperty(exports, "ZoomControls", { enumerable: true, get: function () { return ZoomControls_1.ZoomControls; } });
+var ExampleLoader_1 = require("./components/ExampleLoader");
+Object.defineProperty(exports, "ExampleLoader", { enumerable: true, get: function () { return ExampleLoader_1.ExampleLoader; } });
+// Export styles
+require("./styles/scrollbar.css");
+require("./styles/theme.css");
+// Export examples
+var examples_1 = require("./examples");
+Object.defineProperty(exports, "exampleDialogues", { enumerable: true, get: function () { return examples_1.exampleDialogues; } });
+Object.defineProperty(exports, "demoFlagSchemas", { enumerable: true, get: function () { return examples_1.demoFlagSchemas; } });
+Object.defineProperty(exports, "getExampleDialogue", { enumerable: true, get: function () { return examples_1.getExampleDialogue; } });
+Object.defineProperty(exports, "getDemoFlagSchema", { enumerable: true, get: function () { return examples_1.getDemoFlagSchema; } });
+Object.defineProperty(exports, "listExamples", { enumerable: true, get: function () { return examples_1.listExamples; } });
+Object.defineProperty(exports, "listDemoFlagSchemas", { enumerable: true, get: function () { return examples_1.listDemoFlagSchemas; } });
+// Export all types
+__exportStar(require("./types"), exports);
+__exportStar(require("./types/flags"), exports);
+__exportStar(require("./types/game-state"), exports);
+__exportStar(require("./types/constants"), exports);
+// Export game state utilities
+var game_state_flattener_1 = require("./utils/game-state-flattener");
+Object.defineProperty(exports, "flattenGameState", { enumerable: true, get: function () { return game_state_flattener_1.flattenGameState; } });
+Object.defineProperty(exports, "validateGameState", { enumerable: true, get: function () { return game_state_flattener_1.validateGameState; } });
+Object.defineProperty(exports, "extractFlagsFromGameState", { enumerable: true, get: function () { return game_state_flattener_1.extractFlagsFromGameState; } });
+// Export utilities
+var yarn_converter_1 = require("./lib/yarn-converter");
+Object.defineProperty(exports, "exportToYarn", { enumerable: true, get: function () { return yarn_converter_1.exportToYarn; } });
+Object.defineProperty(exports, "importFromYarn", { enumerable: true, get: function () { return yarn_converter_1.importFromYarn; } });
+var flag_manager_1 = require("./lib/flag-manager");
+Object.defineProperty(exports, "initializeFlags", { enumerable: true, get: function () { return flag_manager_1.initializeFlags; } });
+Object.defineProperty(exports, "mergeFlagUpdates", { enumerable: true, get: function () { return flag_manager_1.mergeFlagUpdates; } });
+Object.defineProperty(exports, "validateFlags", { enumerable: true, get: function () { return flag_manager_1.validateFlags; } });
+Object.defineProperty(exports, "getFlagValue", { enumerable: true, get: function () { return flag_manager_1.getFlagValue; } });
+__exportStar(require("./utils/node-helpers"), exports);
+__exportStar(require("./utils/feature-flags"), exports);

package/dist/lib/flag-manager.d.ts

@@ -0,0 +1,21 @@
+import { GameFlagState } from '../types/game-state';
+import { FlagSchema } from '../types/flags';
+/**
+ * Initialize game flags from schema with default values
+ */
+export declare function initializeFlags(schema: FlagSchema): GameFlagState;
+/**
+ * Merge current flags with updates from dialogue
+ */
+export declare function mergeFlagUpdates(currentFlags: GameFlagState, updates: string[], schema?: FlagSchema): GameFlagState;
+/**
+ * Validate flags against schema
+ */
+export declare function validateFlags(flags: GameFlagState, schema: FlagSchema): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Get flag value with type safety
+ */
+export declare function getFlagValue(flags: GameFlagState, flagId: string, defaultValue?: boolean | number | string): boolean | number | string;

package/dist/lib/flag-manager.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initializeFlags = initializeFlags;
+exports.mergeFlagUpdates = mergeFlagUpdates;
+exports.validateFlags = validateFlags;
+exports.getFlagValue = getFlagValue;
+const constants_1 = require("../types/constants");
+/**
+ * Initialize game flags from schema with default values
+ */
+function initializeFlags(schema) {
+    const flags = {};
+    schema.flags.forEach(flag => {
+        if (flag.defaultValue !== undefined) {
+            flags[flag.id] = flag.defaultValue;
+        }
+        else if (flag.valueType === 'number') {
+            flags[flag.id] = 0;
+        }
+        else if (flag.valueType === 'string') {
+            flags[flag.id] = '';
+        }
+        else {
+            flags[flag.id] = false;
+        }
+    });
+    return flags;
+}
+/**
+ * Merge current flags with updates from dialogue
+ */
+function mergeFlagUpdates(currentFlags, updates, schema) {
+    const newFlags = { ...currentFlags };
+    updates.forEach(flagId => {
+        const flagDef = schema?.flags.find(f => f.id === flagId);
+        if (flagDef) {
+            // Use default value or increment if number
+            if (flagDef.valueType === 'number' && typeof newFlags[flagId] === 'number') {
+                newFlags[flagId] = newFlags[flagId] + 1;
+            }
+            else if (flagDef.valueType === constants_1.FLAG_VALUE_TYPE.STRING) {
+                // For string flags, use smart defaults based on type
+                if (flagDef.type === constants_1.FLAG_TYPE.QUEST) {
+                    // Quest flags: if not set, mark as "started", otherwise keep current value
+                    newFlags[flagId] = newFlags[flagId] || 'started';
+                }
+                else {
+                    // Other string flags: use default or empty string
+                    newFlags[flagId] = flagDef.defaultValue !== undefined ? flagDef.defaultValue : '';
+                }
+            }
+            else if (flagDef.defaultValue !== undefined) {
+                newFlags[flagId] = flagDef.defaultValue;
+            }
+            else {
+                newFlags[flagId] = true;
+            }
+        }
+        else {
+            // Default to true if not in schema
+            newFlags[flagId] = true;
+        }
+    });
+    return newFlags;
+}
+/**
+ * Validate flags against schema
+ */
+function validateFlags(flags, schema) {
+    const errors = [];
+    Object.keys(flags).forEach(flagId => {
+        const flagDef = schema.flags.find(f => f.id === flagId);
+        if (!flagDef) {
+            errors.push(`Unknown flag: ${flagId}`);
+        }
+        else if (flagDef.valueType) {
+            const value = flags[flagId];
+            if (flagDef.valueType === constants_1.FLAG_VALUE_TYPE.NUMBER && typeof value !== 'number') {
+                errors.push(`Flag ${flagId} should be a number, got ${typeof value}`);
+            }
+            else if (flagDef.valueType === constants_1.FLAG_VALUE_TYPE.STRING && typeof value !== 'string') {
+                errors.push(`Flag ${flagId} should be a string, got ${typeof value}`);
+            }
+            else if (flagDef.valueType === constants_1.FLAG_VALUE_TYPE.BOOLEAN && typeof value !== 'boolean') {
+                errors.push(`Flag ${flagId} should be a boolean, got ${typeof value}`);
+            }
+        }
+    });
+    return {
+        valid: errors.length === 0,
+        errors
+    };
+}
+/**
+ * Get flag value with type safety
+ */
+function getFlagValue(flags, flagId, defaultValue) {
+    return flags[flagId] ?? defaultValue ?? false;
+}

package/dist/lib/yarn-converter/__tests__/round-trip.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/yarn-converter/__tests__/round-trip.test.js

@@ -0,0 +1,171 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const yarn_converter_1 = require("../../yarn-converter");
+/**
+ * Test round-trip conversion: Yarn → DialogueTree → Yarn
+ * This ensures we can import and export without data loss
+ */
+(0, vitest_1.describe)('Yarn Round-Trip Conversion', () => {
+    const testCases = [
+        {
+            name: 'Basic dialogue with choices',
+            yarn: `title: start
+---
+NPC: Hello! How can I help you?
+-> Option 1
+    <<jump option1>>
+-> Option 2
+    <<jump option2>>
+===
+
+title: option1
+---
+NPC: You chose option 1!
+===
+
+title: option2
+---
+NPC: You chose option 2!
+===
+`
+        },
+        {
+            name: 'Dialogue with flags',
+            yarn: `title: start
+---
+NPC: Welcome!
+<<set $flag1 = true>>
+<<set $flag2 = true>>
+-> Continue
+    <<set $flag3 = true>>
+    <<jump next>>
+===
+
+title: next
+---
+NPC: Flags have been set!
+===
+`
+        },
+        {
+            name: 'Conditional blocks',
+            yarn: `title: start
+---
+<<if $has_key>>
+    Guard: The door is unlocked.
+<<else>>
+    Guard: The door is locked.
+<<endif>>
+===
+`
+        },
+        {
+            name: 'Variable operations',
+            yarn: `title: merchant
+---
+Merchant: You have {$stat_gold} gold.
+<<set $stat_gold += 100>>
+Merchant: Now you have {$stat_gold} gold!
+-> Buy item
+    <<set $stat_gold -= 50>>
+    <<set $item_sword = true>>
+    Merchant: You bought a sword! You have {$stat_gold} gold left.
+    <<jump end>>
+===
+
+title: end
+---
+===
+`
+        },
+        {
+            name: 'Complex conditional with multiple blocks',
+            yarn: `title: start
+---
+<<if $stat_gold >= 100>>
+    Merchant: You can afford the sword!
+<<elseif $stat_gold >= 50>>
+    Merchant: You can afford the potion!
+<<else>>
+    Merchant: You don't have enough gold.
+<<endif>>
+===
+`
+        }
+    ];
+    testCases.forEach(({ name, yarn }) => {
+        (0, vitest_1.it)(`should round-trip: ${name}`, () => {
+            // Import Yarn to DialogueTree
+            const dialogue = (0, yarn_converter_1.importFromYarn)(yarn, 'Test Dialogue');
+            // Export DialogueTree back to Yarn
+            const exportedYarn = (0, yarn_converter_1.exportToYarn)(dialogue);
+            // Import the exported Yarn again
+            const reimportedDialogue = (0, yarn_converter_1.importFromYarn)(exportedYarn, 'Test Dialogue');
+            // Verify structure is preserved
+            (0, vitest_1.expect)(reimportedDialogue.nodes).toBeDefined();
+            (0, vitest_1.expect)(Object.keys(reimportedDialogue.nodes).length).toBeGreaterThan(0);
+            // Verify all nodes are present
+            const originalNodeIds = Object.keys(dialogue.nodes);
+            const reimportedNodeIds = Object.keys(reimportedDialogue.nodes);
+            (0, vitest_1.expect)(reimportedNodeIds.length).toBe(originalNodeIds.length);
+            // Verify node types are preserved
+            originalNodeIds.forEach(nodeId => {
+                const original = dialogue.nodes[nodeId];
+                const reimported = reimportedDialogue.nodes[nodeId];
+                (0, vitest_1.expect)(reimported).toBeDefined();
+                (0, vitest_1.expect)(reimported.type).toBe(original.type);
+            });
+        });
+    });
+    (0, vitest_1.it)('should preserve variable operations', () => {
+        const yarn = `title: test
+---
+NPC: Test
+<<set $stat_gold += 100>>
+<<set $stat_gold -= 50>>
+<<set $stat_strength *= 2>>
+===
+`;
+        const dialogue = (0, yarn_converter_1.importFromYarn)(yarn, 'Test');
+        const exported = (0, yarn_converter_1.exportToYarn)(dialogue);
+        // Verify operations are in exported Yarn
+        (0, vitest_1.expect)(exported).toContain('<<set $stat_gold += 100>>');
+        (0, vitest_1.expect)(exported).toContain('<<set $stat_gold -= 50>>');
+        (0, vitest_1.expect)(exported).toContain('<<set $stat_strength *= 2>>');
+    });
+    (0, vitest_1.it)('should preserve variable interpolation', () => {
+        const yarn = `title: test
+---
+NPC: Hello {$player_name}! You have {$stat_gold} gold.
+===
+`;
+        const dialogue = (0, yarn_converter_1.importFromYarn)(yarn, 'Test');
+        const exported = (0, yarn_converter_1.exportToYarn)(dialogue);
+        // Variable interpolation should be preserved in content
+        (0, vitest_1.expect)(dialogue.nodes.test.content).toContain('{$player_name}');
+        (0, vitest_1.expect)(dialogue.nodes.test.content).toContain('{$stat_gold}');
+    });
+    (0, vitest_1.it)('should preserve conditional choices', () => {
+        const yarn = `title: start
+---
+<<if $has_key>>
+    -> Use key
+        <<jump unlocked>>
+<<endif>>
+-> Try to force
+    <<jump forced>>
+===
+`;
+        const dialogue = (0, yarn_converter_1.importFromYarn)(yarn, 'Test');
+        const exported = (0, yarn_converter_1.exportToYarn)(dialogue);
+        // Verify conditional choice structure
+        const playerNode = dialogue.nodes.start;
+        (0, vitest_1.expect)(playerNode.type).toBe('player');
+        (0, vitest_1.expect)(playerNode.choices).toBeDefined();
+        (0, vitest_1.expect)(playerNode.choices.length).toBeGreaterThan(0);
+        // Verify conditions are exported
+        (0, vitest_1.expect)(exported).toContain('<<if');
+        (0, vitest_1.expect)(exported).toContain('<<endif>>');
+    });
+});

package/dist/lib/yarn-converter.d.ts

@@ -0,0 +1,17 @@
+import { DialogueTree } from '../types';
+/**
+ * Convert DialogueTree to Yarn Spinner format
+ *
+ * Flags are converted to Yarn variables ($variable).
+ * Variables are NOT stored in the .yarn file - they're managed by
+ * Yarn Spinner's Variable Storage at runtime.
+ *
+ * The .yarn file contains commands like:
+ * - <<set $flag_name = value>> - Sets variable in Variable Storage
+ * - <<if $flag_name>> - Checks variable in Variable Storage
+ */
+export declare function exportToYarn(tree: DialogueTree): string;
+/**
+ * Parse Yarn Spinner format to DialogueTree
+ */
+export declare function importFromYarn(yarnContent: string, title?: string): DialogueTree;