yarn-spinner-runner-ts 0.1.0

package/README.md

@@ -0,0 +1,180 @@
+# yarn-spinner-ts
+
+TypeScript parser, compiler, and runtime for Yarn Spinner 3.x, with a React adapter.
+
+## References
+
+- Old JS parser: `bondage.js` (Yarn 2.x) — [GitHub](https://github.com/mnbroatch/bondage.js/tree/master/src)
+- Official compiler (C#): YarnSpinner.Compiler — [GitHub](https://github.com/YarnSpinnerTool/YarnSpinner/tree/main/YarnSpinner.Compiler)
+- Existing dialogue runner API: YarnBound — [GitHub](https://github.com/mnbroatch/yarn-bound?tab=readme-ov-file)
+
+## Features
+
+- ✅ Full Yarn Spinner 3.x syntax support
+- ✅ Parser for `.yarn` files → AST
+- ✅ Compiler: AST → Intermediate Representation (IR)
+- ✅ Runtime with `YarnRunner` class
+- ✅ React hook: `useYarnRunner()`
+- ✅ React component: `<DialogueView />`
+- ✅ Expression evaluator for conditions
+- ✅ Command system with built-in handlers (`<<set>>`, etc.)
+- ✅ Support for:
+  - Lines with speakers
+  - Options with indented bodies
+  - `{if}/{else if}/{else}/{endif}` blocks
+  - `<<once>>...<<endonce>>` blocks
+  - `<<jump NodeName>>` commands
+  - `<<detour NodeName>>` commands
+  - Variables and functions
+  - Custom commands
+
+## Installation
+
+```bash
+npm install
+npm run build
+```
+
+## Quick Start
+
+### Basic Usage
+
+```typescript
+import { parseYarn } from "yarn-spinner-ts";
+import { compile } from "yarn-spinner-ts";
+import { YarnRunner } from "yarn-spinner-ts";
+
+const yarnText = `
+title: Start
+---
+Narrator: Hello!
+-> Option 1
+    Narrator: You chose option 1.
+-> Option 2
+    Narrator: You chose option 2.
+===
+`;
+
+const ast = parseYarn(yarnText);
+const program = compile(ast);
+const runner = new YarnRunner(program, {
+  startAt: "Start",
+  variables: { score: 10 },
+  functions: {
+    add: (a: number, b: number) => a + b,
+  },
+  handleCommand: (cmd, parsed) => {
+    console.log("Command:", cmd);
+  },
+});
+
+// Get current result
+console.log(runner.currentResult); // TextResult, OptionsResult, or CommandResult
+
+// Advance dialogue
+runner.advance(); // Continue text
+runner.advance(0); // Choose option 0
+```
+
+### React Usage
+
+```tsx
+import { parseYarn, compile, useYarnRunner, DialogueView } from "yarn-spinner-ts";
+
+function MyDialogue() {
+  const [program] = useState(() => {
+    const ast = parseYarn(yarnText);
+    return compile(ast);
+  });
+
+  const { result, advance } = useYarnRunner(program, {
+    startAt: "Start",
+    variables: { score: 10 },
+  });
+
+  return <DialogueView result={result} onAdvance={advance} />;
+}
+```
+
+### Or use the example component:
+
+```tsx
+import { DialogueExample } from "yarn-spinner-ts";
+
+function App() {
+  return <DialogueExample />;
+}
+```
+
+## API Reference
+
+### Parser
+
+- `parseYarn(text: string): YarnDocument` — Parse Yarn script text into AST
+
+### Compiler
+
+- `compile(doc: YarnDocument, opts?: CompileOptions): IRProgram` — Compile AST to IR
+
+### Runtime
+
+- `YarnRunner(program: IRProgram, options: RunnerOptions)` — Dialogue runner class
+  - `currentResult: RuntimeResult | null` — Current dialogue state
+  - `advance(optionIndex?: number): void` — Advance dialogue
+  - `getVariable(name: string): unknown` — Get variable value
+  - `setVariable(name: string, value: unknown): void` — Set variable value
+  - `getVariables(): Readonly<Record<string, unknown>>` — Get all variables
+
+### React
+
+- `useYarnRunner(program: IRProgram, options: RunnerOptions)` — React hook
+- `<DialogueView result={...} onAdvance={...} />` — Ready-to-use component
+
+### Expression Evaluator
+
+- `ExpressionEvaluator(variables, functions)` — Safe expression evaluator
+  - Supports: `===`, `!==`, `<`, `>`, `<=`, `>=`, `&&`, `||`, `!`
+  - Function calls: `functionName(arg1, arg2)`
+  - Variables, numbers, strings, booleans
+
+### Commands
+
+- `CommandHandler` — Command handler registry
+  - Built-in: `<<set variable value>>`
+  - Register custom handlers: `handler.register("mycommand", (args) => { ... })`
+
+## Example Yarn Script
+
+```yarn
+title: Start
+---
+Narrator: Welcome!
+<<set score = 10>>
+{if score >= 10}
+    Narrator: High score!
+{else}
+    Narrator: Low score.
+{endif}
+-> Ask about features
+    Player: What can this do?
+    Narrator: Lots of things!
+-> Ask about commands
+    Player: Tell me about commands.
+    Narrator: Commands modify state.
+<<once>>
+    Narrator: This only shows once!
+<<endonce>>
+===
+```
+
+## Development
+
+```bash
+npm run build     # Build TypeScript
+npm run dev       # Watch mode
+npm test          # Run tests
+```
+
+## License
+
+MIT

package/dist/compile/compiler.d.ts

@@ -0,0 +1,9 @@
+import type { YarnDocument } from "../model/ast";
+import type { IRProgram } from "./ir";
+export interface CompileOptions {
+    generateOnceIds?: (ctx: {
+        node: string;
+        index: number;
+    }) => string;
+}
+export declare function compile(doc: YarnDocument, opts?: CompileOptions): IRProgram;

package/dist/compile/compiler.js

@@ -0,0 +1,172 @@
+export function compile(doc, opts = {}) {
+    const program = { enums: {}, nodes: {} };
+    // Store enum definitions
+    for (const enumDef of doc.enums) {
+        program.enums[enumDef.name] = enumDef.cases;
+    }
+    const genOnce = opts.generateOnceIds ?? ((x) => `${x.node}#once#${x.index}`);
+    let globalLineCounter = 0;
+    function ensureLineId(tags) {
+        const t = tags ? [...tags] : [];
+        if (!t.some((x) => x.startsWith("line:"))) {
+            t.push(`line:${(globalLineCounter++).toString(16)}`);
+        }
+        return t;
+    }
+    // Group nodes by title to handle node groups
+    const nodesByTitle = new Map();
+    for (const node of doc.nodes) {
+        if (!nodesByTitle.has(node.title)) {
+            nodesByTitle.set(node.title, []);
+        }
+        nodesByTitle.get(node.title).push(node);
+    }
+    for (const [title, nodesWithSameTitle] of nodesByTitle) {
+        // If only one node with this title, treat as regular node
+        if (nodesWithSameTitle.length === 1) {
+            const node = nodesWithSameTitle[0];
+            const instructions = [];
+            let onceCounter = 0;
+            function emitBlock(stmts) {
+                const block = [];
+                for (const s of stmts) {
+                    switch (s.type) {
+                        case "Line":
+                            {
+                                const line = s;
+                                block.push({ op: "line", speaker: line.speaker, text: line.text, tags: ensureLineId(line.tags) });
+                            }
+                            break;
+                        case "Command":
+                            block.push({ op: "command", content: s.content });
+                            break;
+                        case "Jump":
+                            block.push({ op: "jump", target: s.target });
+                            break;
+                        case "Detour":
+                            block.push({ op: "detour", target: s.target });
+                            break;
+                        case "OptionGroup": {
+                            // Add #lastline tag to the most recent line, if present
+                            for (let i = block.length - 1; i >= 0; i--) {
+                                const ins = block[i];
+                                if (ins.op === "line") {
+                                    const tags = new Set(ins.tags ?? []);
+                                    if (![...tags].some((x) => x === "lastline" || x === "#lastline")) {
+                                        tags.add("lastline");
+                                    }
+                                    ins.tags = Array.from(tags);
+                                    break;
+                                }
+                                if (ins.op !== "command")
+                                    break; // stop if non-line non-command before options
+                            }
+                            block.push({
+                                op: "options",
+                                options: s.options.map((o) => ({ text: o.text, tags: ensureLineId(o.tags), block: emitBlock(o.body) })),
+                            });
+                            break;
+                        }
+                        case "If":
+                            block.push({
+                                op: "if",
+                                branches: s.branches.map((b) => ({ condition: b.condition, block: emitBlock(b.body) })),
+                            });
+                            break;
+                        case "Once":
+                            block.push({ op: "once", id: genOnce({ node: node.title, index: onceCounter++ }), block: emitBlock(s.body) });
+                            break;
+                        case "Enum":
+                            // Enums are metadata, skip during compilation (already stored in program.enums)
+                            break;
+                    }
+                }
+                return block;
+            }
+            instructions.push(...emitBlock(node.body));
+            const irNode = {
+                title: node.title,
+                instructions,
+                when: node.when,
+                css: node.css
+            };
+            program.nodes[node.title] = irNode;
+        }
+        else {
+            // Multiple nodes with same title - create node group
+            const groupNodes = [];
+            for (const node of nodesWithSameTitle) {
+                const instructions = [];
+                let onceCounter = 0;
+                function emitBlock(stmts) {
+                    const block = [];
+                    for (const s of stmts) {
+                        switch (s.type) {
+                            case "Line":
+                                {
+                                    const line = s;
+                                    block.push({ op: "line", speaker: line.speaker, text: line.text, tags: ensureLineId(line.tags) });
+                                }
+                                break;
+                            case "Command":
+                                block.push({ op: "command", content: s.content });
+                                break;
+                            case "Jump":
+                                block.push({ op: "jump", target: s.target });
+                                break;
+                            case "Detour":
+                                block.push({ op: "detour", target: s.target });
+                                break;
+                            case "OptionGroup": {
+                                for (let i = block.length - 1; i >= 0; i--) {
+                                    const ins = block[i];
+                                    if (ins.op === "line") {
+                                        const tags = new Set(ins.tags ?? []);
+                                        if (![...tags].some((x) => x === "lastline" || x === "#lastline")) {
+                                            tags.add("lastline");
+                                        }
+                                        ins.tags = Array.from(tags);
+                                        break;
+                                    }
+                                    if (ins.op !== "command")
+                                        break;
+                                }
+                                block.push({
+                                    op: "options",
+                                    options: s.options.map((o) => ({ text: o.text, tags: ensureLineId(o.tags), css: o.css, block: emitBlock(o.body) })),
+                                });
+                                break;
+                            }
+                            case "If":
+                                block.push({
+                                    op: "if",
+                                    branches: s.branches.map((b) => ({ condition: b.condition, block: emitBlock(b.body) })),
+                                });
+                                break;
+                            case "Once":
+                                block.push({ op: "once", id: genOnce({ node: node.title, index: onceCounter++ }), block: emitBlock(s.body) });
+                                break;
+                            case "Enum":
+                                break;
+                        }
+                    }
+                    return block;
+                }
+                instructions.push(...emitBlock(node.body));
+                groupNodes.push({
+                    title: node.title,
+                    instructions,
+                    when: node.when,
+                    css: node.css
+                });
+            }
+            const group = {
+                title,
+                nodes: groupNodes
+            };
+            program.nodes[title] = group;
+        }
+    }
+    return program;
+}
+//# sourceMappingURL=compiler.js.map

package/dist/compile/compiler.js.map

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

package/dist/compile/ir.d.ts

@@ -0,0 +1,47 @@
+export type IRProgram = {
+    enums: Record<string, string[]>;
+    nodes: Record<string, IRNode | IRNodeGroup>;
+};
+export type IRNode = {
+    title: string;
+    instructions: IRInstruction[];
+    when?: string[];
+    css?: string;
+};
+export type IRNodeGroup = {
+    title: string;
+    nodes: IRNode[];
+};
+export type IRInstruction = {
+    op: "line";
+    speaker?: string;
+    text: string;
+    tags?: string[];
+} | {
+    op: "command";
+    content: string;
+} | {
+    op: "jump";
+    target: string;
+} | {
+    op: "detour";
+    target: string;
+} | {
+    op: "options";
+    options: Array<{
+        text: string;
+        tags?: string[];
+        css?: string;
+        block: IRInstruction[];
+    }>;
+} | {
+    op: "if";
+    branches: Array<{
+        condition: string | null;
+        block: IRInstruction[];
+    }>;
+} | {
+    op: "once";
+    id: string;
+    block: IRInstruction[];
+};

package/dist/compile/ir.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ir.js.map

package/dist/compile/ir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ir.js","sourceRoot":"","sources":["../../src/compile/ir.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from "./model/ast.js";
+export * from "./parse/lexer.js";
+export * from "./parse/parser.js";
+export * from "./compile/ir.js";
+export * from "./compile/compiler.js";
+export * from "./runtime/results.js";
+export * from "./runtime/evaluator.js";
+export * from "./runtime/commands.js";
+export * from "./runtime/runner.js";
+export * from "./types.js";

package/dist/index.js

@@ -0,0 +1,11 @@
+export * from "./model/ast.js";
+export * from "./parse/lexer.js";
+export * from "./parse/parser.js";
+export * from "./compile/ir.js";
+export * from "./compile/compiler.js";
+export * from "./runtime/results.js";
+export * from "./runtime/evaluator.js";
+export * from "./runtime/commands.js";
+export * from "./runtime/runner.js";
+export * from "./types.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,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC"}

package/dist/model/ast.d.ts

@@ -0,0 +1,72 @@
+export type Position = {
+    line: number;
+    column: number;
+};
+export interface NodeHeaderMap {
+    [key: string]: string;
+}
+export interface YarnDocument {
+    type: "Document";
+    enums: EnumDefinition[];
+    nodes: YarnNode[];
+}
+export interface EnumDefinition {
+    type: "Enum";
+    name: string;
+    cases: string[];
+}
+export interface YarnNode {
+    type: "Node";
+    title: string;
+    headers: NodeHeaderMap;
+    nodeTags?: string[];
+    when?: string[];
+    css?: string;
+    body: Statement[];
+}
+export type Statement = Line | Command | OptionGroup | IfBlock | OnceBlock | Jump | Detour | EnumBlock;
+export interface Line {
+    type: "Line";
+    speaker?: string;
+    text: string;
+    tags?: string[];
+}
+export interface Command {
+    type: "Command";
+    content: string;
+}
+export interface Jump {
+    type: "Jump";
+    target: string;
+}
+export interface Detour {
+    type: "Detour";
+    target: string;
+}
+export interface OptionGroup {
+    type: "OptionGroup";
+    options: Option[];
+}
+export interface Option {
+    type: "Option";
+    text: string;
+    body: Statement[];
+    tags?: string[];
+    css?: string;
+}
+export interface IfBlock {
+    type: "If";
+    branches: Array<{
+        condition: string | null;
+        body: Statement[];
+    }>;
+}
+export interface OnceBlock {
+    type: "Once";
+    body: Statement[];
+}
+export interface EnumBlock {
+    type: "Enum";
+    name: string;
+    cases: string[];
+}

package/dist/model/ast.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ast.js.map

package/dist/model/ast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.js","sourceRoot":"","sources":["../../src/model/ast.ts"],"names":[],"mappings":""}

package/dist/parse/lexer.d.ts

@@ -0,0 +1,7 @@
+export interface Token {
+    type: "HEADER_KEY" | "HEADER_VALUE" | "NODE_START" | "NODE_END" | "OPTION" | "COMMAND" | "TEXT" | "EMPTY" | "INDENT" | "DEDENT" | "EOF";
+    text: string;
+    line: number;
+    column: number;
+}
+export declare function lex(input: string): Token[];

package/dist/parse/lexer.js

@@ -0,0 +1,78 @@
+// Minimal indentation-sensitive lexer to support options and their bodies.
+export function lex(input) {
+    const lines = input.replace(/\r\n?/g, "\n").split("\n");
+    const tokens = [];
+    const indentStack = [0];
+    let inHeaders = true;
+    function push(type, text, line, column) {
+        tokens.push({ type, text, line, column });
+    }
+    for (let i = 0; i < lines.length; i++) {
+        const raw = lines[i];
+        const lineNum = i + 1;
+        const indent = raw.match(/^[ \t]*/)?.[0] ?? "";
+        const content = raw.slice(indent.length);
+        // Manage indentation tokens only within node bodies
+        if (!inHeaders) {
+            const prev = indentStack[indentStack.length - 1];
+            if (indent.length > prev) {
+                indentStack.push(indent.length);
+                push("INDENT", "", lineNum, 1);
+            }
+            else if (indent.length < prev) {
+                while (indentStack.length && indent.length < indentStack[indentStack.length - 1]) {
+                    indentStack.pop();
+                    push("DEDENT", "", lineNum, 1);
+                }
+            }
+        }
+        if (content.trim() === "") {
+            push("EMPTY", "", lineNum, 1);
+            continue;
+        }
+        if (content === "---") {
+            inHeaders = false;
+            push("NODE_START", content, lineNum, indent.length + 1);
+            continue;
+        }
+        if (content === "===") {
+            inHeaders = true;
+            // flush indentation to root
+            while (indentStack.length > 1) {
+                indentStack.pop();
+                push("DEDENT", "", lineNum, 1);
+            }
+            push("NODE_END", content, lineNum, indent.length + 1);
+            continue;
+        }
+        // Header: key: value (only valid while inHeaders)
+        if (inHeaders) {
+            const m = content.match(/^([A-Za-z_][A-Za-z0-9_]*)\s*:\s*(.*)$/);
+            if (m) {
+                push("HEADER_KEY", m[1], lineNum, indent.length + 1);
+                push("HEADER_VALUE", m[2], lineNum, indent.length + 1 + m[0].indexOf(m[2]));
+                continue;
+            }
+        }
+        if (content.startsWith("->")) {
+            push("OPTION", content.slice(2).trim(), lineNum, indent.length + 1);
+            continue;
+        }
+        // Commands like <<...>> (single line)
+        const cmd = content.match(/^<<(.+?)>>\s*$/);
+        if (cmd) {
+            push("COMMAND", cmd[1].trim(), lineNum, indent.length + 1);
+            continue;
+        }
+        // Plain text line
+        push("TEXT", content, lineNum, indent.length + 1);
+    }
+    // close remaining indentation at EOF
+    while (indentStack.length > 1) {
+        indentStack.pop();
+        tokens.push({ type: "DEDENT", text: "", line: lines.length, column: 1 });
+    }
+    tokens.push({ type: "EOF", text: "", line: lines.length + 1, column: 1 });
+    return tokens;
+}
+//# sourceMappingURL=lexer.js.map

package/dist/parse/lexer.js.map

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

package/dist/parse/parser.d.ts

@@ -0,0 +1,4 @@
+import type { YarnDocument } from "../model/ast";
+export declare class ParseError extends Error {
+}
+export declare function parseYarn(text: string): YarnDocument;