yarn-spinner-runner-ts 0.1.0

package/dist/runtime/evaluator.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Safe expression evaluator for Yarn Spinner conditions.
+ * Supports variables, functions, comparisons, and logical operators.
+ */
+export declare class ExpressionEvaluator {
+    private variables;
+    private functions;
+    private enums;
+    private smartVariables;
+    constructor(variables?: Record<string, unknown>, functions?: Record<string, (...args: unknown[]) => unknown>, enums?: Record<string, string[]>);
+    /**
+     * Evaluate a condition expression and return a boolean result.
+     * Supports: variables, literals (numbers, strings, booleans), comparisons, logical ops, function calls.
+     */
+    evaluate(expr: string): boolean;
+    /**
+     * Evaluate an expression that can return any value (not just boolean).
+     */
+    evaluateExpression(expr: string): unknown;
+    private preprocess;
+    private evaluateFunctionCall;
+    private parseArguments;
+    private containsComparison;
+    private evaluateComparison;
+    private evaluateLogical;
+    private resolveValue;
+    /**
+     * Resolve shorthand enum (.CaseName) when setting a variable with known enum type
+     */
+    resolveEnumValue(expr: string, enumName?: string): string;
+    /**
+     * Get enum type for a variable (if it was declared with enum type)
+     */
+    getEnumTypeForVariable(varName: string): string | undefined;
+    private deepEquals;
+    /**
+     * Update variables. Can be used to mutate state during dialogue.
+     */
+    setVariable(name: string, value: unknown): void;
+    /**
+     * Register a smart variable (variable with expression that recalculates on access).
+     */
+    setSmartVariable(name: string, expression: string): void;
+    /**
+     * Check if a variable is a smart variable.
+     */
+    isSmartVariable(name: string): boolean;
+    /**
+     * Get variable value.
+     */
+    getVariable(name: string): unknown;
+}

package/dist/runtime/evaluator.js

@@ -0,0 +1,309 @@
+/**
+ * Safe expression evaluator for Yarn Spinner conditions.
+ * Supports variables, functions, comparisons, and logical operators.
+ */
+export class ExpressionEvaluator {
+    constructor(variables = {}, functions = {}, enums = {} // enum name -> cases
+    ) {
+        this.variables = variables;
+        this.functions = functions;
+        this.enums = enums;
+        this.smartVariables = {}; // variable name -> expression
+    }
+    /**
+     * Evaluate a condition expression and return a boolean result.
+     * Supports: variables, literals (numbers, strings, booleans), comparisons, logical ops, function calls.
+     */
+    evaluate(expr) {
+        try {
+            const result = this.evaluateExpression(expr);
+            return !!result;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Evaluate an expression that can return any value (not just boolean).
+     */
+    evaluateExpression(expr) {
+        const trimmed = this.preprocess(expr.trim());
+        if (!trimmed)
+            return false;
+        // Handle function calls like `functionName(arg1, arg2)`
+        if (trimmed.includes("(") && trimmed.includes(")")) {
+            return this.evaluateFunctionCall(trimmed);
+        }
+        // Handle comparisons
+        if (this.containsComparison(trimmed)) {
+            return this.evaluateComparison(trimmed);
+        }
+        // Handle logical operators
+        if (trimmed.includes("&&") || trimmed.includes("||")) {
+            return this.evaluateLogical(trimmed);
+        }
+        // Handle negation
+        if (trimmed.startsWith("!")) {
+            return !this.evaluateExpression(trimmed.slice(1).trim());
+        }
+        // Simple variable or literal
+        return this.resolveValue(trimmed);
+    }
+    preprocess(expr) {
+        // Normalize operator word aliases to JS-like symbols
+        // Whole word replacements only
+        return expr
+            .replace(/\bnot\b/gi, "!")
+            .replace(/\band\b/gi, "&&")
+            .replace(/\bor\b/gi, "||")
+            .replace(/\bxor\b/gi, "^")
+            .replace(/\beq\b|\bis\b/gi, "==")
+            .replace(/\bneq\b/gi, "!=")
+            .replace(/\bgte\b/gi, ">=")
+            .replace(/\blte\b/gi, "<=")
+            .replace(/\bgt\b/gi, ">")
+            .replace(/\blt\b/gi, "<");
+    }
+    evaluateFunctionCall(expr) {
+        const match = expr.match(/^([a-zA-Z_][a-zA-Z0-9_]*)\s*\((.*)\)$/);
+        if (!match)
+            throw new Error(`Invalid function call: ${expr}`);
+        const [, name, argsStr] = match;
+        const func = this.functions[name];
+        if (!func)
+            throw new Error(`Function not found: ${name}`);
+        const args = this.parseArguments(argsStr);
+        const evaluatedArgs = args.map((arg) => this.evaluateExpression(arg.trim()));
+        return func(...evaluatedArgs);
+    }
+    parseArguments(argsStr) {
+        if (!argsStr.trim())
+            return [];
+        const args = [];
+        let depth = 0;
+        let current = "";
+        for (const char of argsStr) {
+            if (char === "(")
+                depth++;
+            else if (char === ")")
+                depth--;
+            else if (char === "," && depth === 0) {
+                args.push(current.trim());
+                current = "";
+                continue;
+            }
+            current += char;
+        }
+        if (current.trim())
+            args.push(current.trim());
+        return args;
+    }
+    containsComparison(expr) {
+        return /[<>=!]/.test(expr);
+    }
+    evaluateComparison(expr) {
+        // Match comparison operators (avoid matching !=, <=, >=)
+        const match = expr.match(/^(.+?)\s*(===|!==|<=|>=|<|>)\s*(.+)$/);
+        if (!match)
+            throw new Error(`Invalid comparison: ${expr}`);
+        const [, left, op, right] = match;
+        const leftVal = this.evaluateExpression(left.trim());
+        const rightVal = this.evaluateExpression(right.trim());
+        switch (op) {
+            case "===":
+            case "==":
+                return this.deepEquals(leftVal, rightVal);
+            case "!==":
+            case "!=":
+                return !this.deepEquals(leftVal, rightVal);
+            case "<":
+                return Number(leftVal) < Number(rightVal);
+            case ">":
+                return Number(leftVal) > Number(rightVal);
+            case "<=":
+                return Number(leftVal) <= Number(rightVal);
+            case ">=":
+                return Number(leftVal) >= Number(rightVal);
+            default:
+                throw new Error(`Unknown operator: ${op}`);
+        }
+    }
+    evaluateLogical(expr) {
+        // Split by && or ||, respecting parentheses
+        const parts = [];
+        let depth = 0;
+        let current = "";
+        let lastOp = null;
+        for (const char of expr) {
+            if (char === "(")
+                depth++;
+            else if (char === ")")
+                depth--;
+            else if (depth === 0 && expr.includes(char === "&" ? "&&" : char === "|" ? "||" : "")) {
+                // Check for && or ||
+                const remaining = expr.slice(expr.indexOf(char));
+                if (remaining.startsWith("&&")) {
+                    if (current.trim()) {
+                        parts.push({ expr: current.trim(), op: lastOp });
+                        current = "";
+                    }
+                    lastOp = "&&";
+                    // skip &&
+                    continue;
+                }
+                else if (remaining.startsWith("||")) {
+                    if (current.trim()) {
+                        parts.push({ expr: current.trim(), op: lastOp });
+                        current = "";
+                    }
+                    lastOp = "||";
+                    // skip ||
+                    continue;
+                }
+            }
+            current += char;
+        }
+        if (current.trim())
+            parts.push({ expr: current.trim(), op: lastOp });
+        // Simple case: single expression
+        if (parts.length === 0)
+            return !!this.evaluateExpression(expr);
+        // Evaluate parts (supports &&, ||, ^ as xor)
+        let result = this.evaluateExpression(parts[0].expr);
+        for (let i = 1; i < parts.length; i++) {
+            const part = parts[i];
+            const val = this.evaluateExpression(part.expr);
+            if (part.op === "&&") {
+                result = result && val;
+            }
+            else if (part.op === "||") {
+                result = result || val;
+            }
+        }
+        return !!result;
+    }
+    resolveValue(expr) {
+        // Try enum syntax: EnumName.CaseName or .CaseName
+        const enumMatch = expr.match(/^\.?([A-Za-z_][A-Za-z0-9_]*)\.([A-Za-z_][A-Za-z0-9_]*)$/);
+        if (enumMatch) {
+            const [, enumName, caseName] = enumMatch;
+            if (this.enums[enumName] && this.enums[enumName].includes(caseName)) {
+                return `${enumName}.${caseName}`; // Store as "EnumName.CaseName" string
+            }
+        }
+        // Try shorthand enum: .CaseName (requires context from variables)
+        if (expr.startsWith(".") && expr.length > 1) {
+            const caseName = expr.slice(1);
+            // Try to infer enum from variable types - for now, return as-is and let validation handle it
+            return expr;
+        }
+        // Try as variable first
+        const key = expr.startsWith("$") ? expr.slice(1) : expr;
+        // Check if this is a smart variable (has stored expression)
+        if (Object.prototype.hasOwnProperty.call(this.smartVariables, key)) {
+            // Re-evaluate the expression each time it's accessed
+            return this.evaluateExpression(this.smartVariables[key]);
+        }
+        if (Object.prototype.hasOwnProperty.call(this.variables, key)) {
+            return this.variables[key];
+        }
+        // Try as number
+        const num = Number(expr);
+        if (!isNaN(num) && expr.trim() === String(num)) {
+            return num;
+        }
+        // Try as boolean
+        if (expr === "true")
+            return true;
+        if (expr === "false")
+            return false;
+        // Try as string (quoted)
+        if ((expr.startsWith('"') && expr.endsWith('"')) || (expr.startsWith("'") && expr.endsWith("'"))) {
+            return expr.slice(1, -1);
+        }
+        // Default: treat as variable (may be undefined)
+        return this.variables[key];
+    }
+    /**
+     * Resolve shorthand enum (.CaseName) when setting a variable with known enum type
+     */
+    resolveEnumValue(expr, enumName) {
+        if (expr.startsWith(".") && enumName) {
+            const caseName = expr.slice(1);
+            if (this.enums[enumName] && this.enums[enumName].includes(caseName)) {
+                return `${enumName}.${caseName}`;
+            }
+            throw new Error(`Invalid enum case ${caseName} for enum ${enumName}`);
+        }
+        // Check if it's already EnumName.CaseName format
+        const match = expr.match(/^([A-Za-z_][A-Za-z0-9_]*)\.([A-Za-z_][A-Za-z0-9_]*)$/);
+        if (match) {
+            const [, name, caseName] = match;
+            if (this.enums[name] && this.enums[name].includes(caseName)) {
+                return expr;
+            }
+            throw new Error(`Invalid enum case ${caseName} for enum ${name}`);
+        }
+        return expr;
+    }
+    /**
+     * Get enum type for a variable (if it was declared with enum type)
+     */
+    getEnumTypeForVariable(varName) {
+        // Check if variable value matches EnumName.CaseName pattern
+        const key = varName.startsWith("$") ? varName.slice(1) : varName;
+        const value = this.variables[key];
+        if (typeof value === "string") {
+            const match = value.match(/^([A-Za-z_][A-Za-z0-9_]*)\./);
+            if (match) {
+                return match[1];
+            }
+        }
+        return undefined;
+    }
+    deepEquals(a, b) {
+        if (a === b)
+            return true;
+        if (a == null || b == null)
+            return a === b;
+        if (typeof a !== typeof b)
+            return false;
+        if (typeof a === "object") {
+            return JSON.stringify(a) === JSON.stringify(b);
+        }
+        return false;
+    }
+    /**
+     * Update variables. Can be used to mutate state during dialogue.
+     */
+    setVariable(name, value) {
+        // If setting a smart variable, remove it (converting to regular variable)
+        if (Object.prototype.hasOwnProperty.call(this.smartVariables, name)) {
+            delete this.smartVariables[name];
+        }
+        this.variables[name] = value;
+    }
+    /**
+     * Register a smart variable (variable with expression that recalculates on access).
+     */
+    setSmartVariable(name, expression) {
+        // Remove from regular variables if it exists
+        if (Object.prototype.hasOwnProperty.call(this.variables, name)) {
+            delete this.variables[name];
+        }
+        this.smartVariables[name] = expression;
+    }
+    /**
+     * Check if a variable is a smart variable.
+     */
+    isSmartVariable(name) {
+        return Object.prototype.hasOwnProperty.call(this.smartVariables, name);
+    }
+    /**
+     * Get variable value.
+     */
+    getVariable(name) {
+        return this.variables[name];
+    }
+}
+//# sourceMappingURL=evaluator.js.map

package/dist/runtime/evaluator.js.map

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

package/dist/runtime/results.d.ts

@@ -0,0 +1,22 @@
+export type TextResult = {
+    type: "text";
+    text: string;
+    speaker?: string;
+    tags?: string[];
+    isDialogueEnd: boolean;
+};
+export type OptionsResult = {
+    type: "options";
+    options: {
+        text: string;
+        tags?: string[];
+        css?: string;
+    }[];
+    isDialogueEnd: boolean;
+};
+export type CommandResult = {
+    type: "command";
+    command: string;
+    isDialogueEnd: boolean;
+};
+export type RuntimeResult = TextResult | OptionsResult | CommandResult;

package/dist/runtime/results.js

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

package/dist/runtime/results.js.map

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

package/dist/runtime/runner.d.ts

@@ -0,0 +1,63 @@
+import type { IRProgram } from "../compile/ir";
+import type { RuntimeResult } from "./results.js";
+import { CommandHandler, parseCommand } from "./commands.js";
+export interface RunnerOptions {
+    startAt: string;
+    variables?: Record<string, unknown>;
+    functions?: Record<string, (...args: unknown[]) => unknown>;
+    handleCommand?: (command: string, parsed?: ReturnType<typeof parseCommand>) => void;
+    commandHandler?: CommandHandler;
+}
+export declare class YarnRunner {
+    private readonly program;
+    private readonly variables;
+    private readonly functions;
+    private readonly handleCommand?;
+    private readonly commandHandler;
+    private readonly evaluator;
+    private readonly onceSeen;
+    private readonly nodeGroupOnceSeen;
+    private readonly visitCounts;
+    private nodeTitle;
+    private ip;
+    private currentNodeIndex;
+    private callStack;
+    currentResult: RuntimeResult | null;
+    history: RuntimeResult[];
+    constructor(program: IRProgram, opts: RunnerOptions);
+    /**
+     * Get the current node title (may resolve to a node group).
+     */
+    getCurrentNodeTitle(): string;
+    /**
+     * Resolve a node title to an actual node (handling node groups).
+     */
+    private resolveNode;
+    /**
+     * Evaluate when conditions for a node in a group.
+     */
+    private evaluateWhenConditions;
+    /**
+     * Mark a node group node as seen (for "once" condition).
+     */
+    private markNodeGroupOnceSeen;
+    advance(optionIndex?: number): void;
+    private interpolate;
+    private resumeBlock;
+    private step;
+    private executeBlock;
+    private lookaheadIsEnd;
+    private emit;
+    /**
+     * Get the current variable store (read-only view).
+     */
+    getVariables(): Readonly<Record<string, unknown>>;
+    /**
+     * Get variable value.
+     */
+    getVariable(name: string): unknown;
+    /**
+     * Set variable value.
+     */
+    setVariable(name: string, value: unknown): void;
+}