@flare-engine/dialogue 0.2.0 → 0.3.0

package/dist/index.js

@@ -1,257 +1,268 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  completeTextReveal: () => completeTextReveal,
-  createDialogueGraph: () => createDialogueGraph,
-  createDialogueRunner: () => createDialogueRunner,
-  createTextReveal: () => createTextReveal,
-  getNode: () => getNode,
-  interpolate: () => interpolate,
-  resetTextReveal: () => resetTextReveal,
-  updateTextReveal: () => updateTextReveal
-});
-module.exports = __toCommonJS(index_exports);
-
-// src/graph.ts
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _flare_engine_events = require("@flare-engine/events");
+//#region src/graph.ts
 function createDialogueGraph(id, start, nodes) {
-  return { id, start, nodes };
+	return {
+		id,
+		start,
+		nodes
+	};
 }
 function getNode(graph, nodeId) {
-  return graph.nodes[nodeId];
+	return Object.hasOwn(graph.nodes, nodeId) ? graph.nodes[nodeId] : void 0;
 }
-
-// src/runner.ts
-var import_events = require("@flare-engine/events");
+//#endregion
+//#region src/runner.ts
+/**
+* Dialogue runner — walks a DialogueGraph, evaluating conditions,
+* interpolating variables, and emitting signals for each step.
+*/
+var DialogueError = class extends Error {
+	code;
+	/** Source node whose transition triggered the error (or the entry id when there is no source). */
+	nodeId;
+	/** 'missing-node': the target id that could not be resolved. */
+	missingId;
+	/** 'cycle': the node-id chain walked before the step budget was exceeded. */
+	chain;
+	constructor(code, message, detail) {
+		super(message);
+		this.name = "DialogueError";
+		this.code = code;
+		this.nodeId = detail.nodeId;
+		this.missingId = detail.missingId;
+		this.chain = detail.chain;
+	}
+};
 function interpolate(template, vars) {
-  return template.replace(/\{(\w+)\}/g, (_match, key) => {
-    const val = vars[key];
-    return val !== void 0 ? String(val) : `{${key}}`;
-  });
+	return template.replace(/\{(\w+)\}/g, (_match, key) => {
+		const val = Object.hasOwn(vars, key) ? vars[key] : void 0;
+		return val !== void 0 ? String(val) : `{${key}}`;
+	});
 }
+const STEP_BUDGET = 1e3;
 function createDialogueRunner(options) {
-  const onLine = new import_events.Signal();
-  const onChoice = new import_events.Signal();
-  const onAction = new import_events.Signal();
-  const onEnd = new import_events.Signal();
-  const conditions = options?.conditions ?? (() => true);
-  const actions = options?.actions;
-  let _state = "idle";
-  let _graph = null;
-  let _currentNodeId = null;
-  let _vars = {};
-  let _activeOptions = [];
-  function setState(s) {
-    _state = s;
-  }
-  function processNode(nodeId) {
-    if (!_graph) return;
-    const node = getNode(_graph, nodeId);
-    if (!node) {
-      end();
-      return;
-    }
-    _currentNodeId = nodeId;
-    switch (node.kind) {
-      case "line":
-        processLine(node, nodeId);
-        break;
-      case "choice":
-        processChoice(node, nodeId);
-        break;
-      case "branch":
-        processBranch(node);
-        break;
-      case "action":
-        processAction(node);
-        break;
-      case "end":
-        end();
-        break;
-    }
-  }
-  function processLine(node, nodeId) {
-    setState("running");
-    const text = interpolate(node.text, _vars);
-    onLine.emit({
-      speaker: node.speaker,
-      speakerPortraitKey: node.speakerPortraitKey,
-      text,
-      nodeId
-    });
-  }
-  function processChoice(node, nodeId) {
-    _activeOptions = [];
-    for (let i = 0; i < node.options.length; i++) {
-      const opt = node.options[i];
-      if (opt.condition && !conditions(opt.condition)) continue;
-      _activeOptions.push({
-        index: _activeOptions.length,
-        text: interpolate(opt.text, _vars),
-        next: opt.next
-      });
-    }
-    if (_activeOptions.length === 0) {
-      end();
-      return;
-    }
-    setState("waiting-choice");
-    onChoice.emit({
-      prompt: node.prompt ? interpolate(node.prompt, _vars) : void 0,
-      speaker: node.speaker,
-      options: _activeOptions,
-      nodeId
-    });
-  }
-  function processBranch(node) {
-    for (let i = 0; i < node.arms.length; i++) {
-      const arm = node.arms[i];
-      if (conditions(arm.condition)) {
-        processNode(arm.next);
-        return;
-      }
-    }
-    if (node.fallback) {
-      processNode(node.fallback);
-    } else {
-      end();
-    }
-  }
-  function processAction(node) {
-    onAction.emit(node.action);
-    actions?.(node.action);
-    if (node.next) {
-      processNode(node.next);
-    } else {
-      end();
-    }
-  }
-  function end() {
-    setState("ended");
-    const graphId = _graph?.id ?? "";
-    _currentNodeId = null;
-    onEnd.emit(graphId);
-  }
-  const runner = {
-    onLine,
-    onChoice,
-    onAction,
-    onEnd,
-    get state() {
-      return _state;
-    },
-    get currentNodeId() {
-      return _currentNodeId;
-    },
-    get graphId() {
-      return _graph?.id ?? null;
-    },
-    start(graph, variables) {
-      _graph = graph;
-      _vars = variables ?? {};
-      _activeOptions = [];
-      setState("running");
-      processNode(graph.start);
-    },
-    advance() {
-      if (_state !== "running" || !_graph || !_currentNodeId) return;
-      const node = getNode(_graph, _currentNodeId);
-      if (!node || node.kind !== "line") return;
-      if (node.next) {
-        processNode(node.next);
-      } else {
-        end();
-      }
-    },
-    selectChoice(index) {
-      if (_state !== "waiting-choice") return;
-      const opt = _activeOptions[index];
-      if (!opt) return;
-      _activeOptions = [];
-      setState("running");
-      processNode(opt.next);
-    },
-    stop() {
-      setState("idle");
-      _graph = null;
-      _currentNodeId = null;
-      _vars = {};
-      _activeOptions = [];
-    }
-  };
-  return runner;
+	const onLine = new _flare_engine_events.Signal();
+	const onChoice = new _flare_engine_events.Signal();
+	const onAction = new _flare_engine_events.Signal();
+	const onEnd = new _flare_engine_events.Signal();
+	const conditions = options?.conditions ?? (() => true);
+	const actions = options?.actions;
+	const onError = options?.onError;
+	let _state = "idle";
+	let _graph = null;
+	let _currentNodeId = null;
+	let _vars = {};
+	let _activeOptions = [];
+	function setState(s) {
+		_state = s;
+	}
+	function end() {
+		setState("ended");
+		const graphId = _graph?.id ?? "";
+		_currentNodeId = null;
+		onEnd.emit(graphId);
+	}
+	function reportMissing(fromNodeId, missingId) {
+		const err = new DialogueError("missing-node", `Dialogue '${_graph?.id ?? ""}' references missing node '${missingId}'${fromNodeId ? ` from node '${fromNodeId}'` : " as its start node"} — ending conversation.`, {
+			nodeId: fromNodeId ?? missingId,
+			missingId
+		});
+		if (onError) onError(err);
+		else console.warn(err.message);
+	}
+	function processLine(node, nodeId) {
+		setState("running");
+		const text = interpolate(node.text, _vars);
+		onLine.emit({
+			speaker: node.speaker,
+			speakerPortraitKey: node.speakerPortraitKey,
+			text,
+			nodeId
+		});
+	}
+	function processChoice(node, nodeId) {
+		_activeOptions = [];
+		for (let i = 0; i < node.options.length; i++) {
+			const opt = node.options[i];
+			if (opt.condition && !conditions(opt.condition)) continue;
+			_activeOptions.push({
+				index: _activeOptions.length,
+				text: interpolate(opt.text, _vars),
+				next: opt.next
+			});
+		}
+		if (_activeOptions.length === 0) {
+			end();
+			return;
+		}
+		setState("waiting-choice");
+		onChoice.emit({
+			prompt: node.prompt ? interpolate(node.prompt, _vars) : void 0,
+			speaker: node.speaker,
+			options: _activeOptions,
+			nodeId
+		});
+	}
+	function run(entryId, fromNodeId) {
+		if (!_graph) return;
+		let currentId = entryId;
+		let from = fromNodeId;
+		const chain = [];
+		let steps = 0;
+		while (currentId !== null) {
+			const nodeId = currentId;
+			const node = getNode(_graph, nodeId);
+			if (!node) {
+				reportMissing(from, nodeId);
+				end();
+				return;
+			}
+			chain.push(nodeId);
+			if (++steps > STEP_BUDGET) throw new DialogueError("cycle", `Dialogue '${_graph.id}' cycle detected — step budget exceeded (chain: …${chain.slice(-12).join("→")})`, {
+				nodeId,
+				chain: chain.slice()
+			});
+			_currentNodeId = nodeId;
+			from = nodeId;
+			switch (node.kind) {
+				case "line":
+					processLine(node, nodeId);
+					return;
+				case "choice":
+					processChoice(node, nodeId);
+					return;
+				case "branch": {
+					let next = node.fallback;
+					for (const arm of node.arms) if (conditions(arm.condition)) {
+						next = arm.next;
+						break;
+					}
+					currentId = next;
+					break;
+				}
+				case "action":
+					onAction.emit(node.action);
+					actions?.(node.action);
+					currentId = node.next;
+					break;
+				case "end":
+					end();
+					return;
+			}
+		}
+		end();
+	}
+	return {
+		onLine,
+		onChoice,
+		onAction,
+		onEnd,
+		get state() {
+			return _state;
+		},
+		get currentNodeId() {
+			return _currentNodeId;
+		},
+		get graphId() {
+			return _graph?.id ?? null;
+		},
+		start(graph, variables) {
+			_graph = graph;
+			_vars = variables ?? {};
+			_activeOptions = [];
+			setState("running");
+			run(graph.start, null);
+		},
+		advance() {
+			if (_state !== "running" || !_graph || !_currentNodeId) return;
+			const node = getNode(_graph, _currentNodeId);
+			if (node?.kind !== "line") return;
+			if (node.next) run(node.next, _currentNodeId);
+			else end();
+		},
+		selectChoice(index) {
+			if (_state !== "waiting-choice") return;
+			const opt = _activeOptions[index];
+			if (!opt) return;
+			_activeOptions = [];
+			setState("running");
+			run(opt.next, _currentNodeId);
+		},
+		stop() {
+			setState("idle");
+			_graph = null;
+			_currentNodeId = null;
+			_vars = {};
+			_activeOptions = [];
+		}
+	};
 }
-
-// src/text-reveal.ts
-var DEFAULT_SPEED = 30;
-var DEFAULT_PUNCT_DELAY = 0.15;
-var PUNCTUATION = /* @__PURE__ */ new Set([".", "!", "?", ":", ";"]);
+//#endregion
+//#region src/text-reveal.ts
+const DEFAULT_SPEED = 30;
+const DEFAULT_PUNCT_DELAY = .15;
+const PUNCTUATION = /* @__PURE__ */ new Set([
+	".",
+	"!",
+	"?",
+	":",
+	";"
+]);
 function createTextReveal(text) {
-  if (text.length === 0) {
-    return { fullText: text, visibleText: text, complete: true, _cursor: 0 };
-  }
-  return { fullText: text, visibleText: "", complete: false, _cursor: 0 };
+	if (text.length === 0) return {
+		fullText: text,
+		visibleText: text,
+		complete: true,
+		_cursor: 0
+	};
+	return {
+		fullText: text,
+		visibleText: "",
+		complete: false,
+		_cursor: 0
+	};
 }
 function updateTextReveal(state, dt, options) {
-  if (state.complete) return;
-  const speed = options?.speed ?? DEFAULT_SPEED;
-  const punctDelay = options?.punctuationDelay ?? DEFAULT_PUNCT_DELAY;
-  const len = state.fullText.length;
-  const prevCharIdx = Math.floor(state._cursor) - 1;
-  let effectiveSpeed = speed;
-  if (prevCharIdx >= 0 && prevCharIdx < len) {
-    const prevChar = state.fullText[prevCharIdx];
-    if (PUNCTUATION.has(prevChar)) {
-      effectiveSpeed = punctDelay > 0 ? 1 / punctDelay : speed;
-    }
-  }
-  state._cursor += effectiveSpeed * dt;
-  const charCount = Math.min(Math.floor(state._cursor), len);
-  state.visibleText = state.fullText.slice(0, charCount);
-  if (charCount >= len) {
-    state.visibleText = state.fullText;
-    state.complete = true;
-  }
+	if (state.complete) return;
+	const speed = options?.speed ?? DEFAULT_SPEED;
+	const punctDelay = options?.punctuationDelay ?? DEFAULT_PUNCT_DELAY;
+	const len = state.fullText.length;
+	const prevCharIdx = Math.floor(state._cursor) - 1;
+	let effectiveSpeed = speed;
+	if (prevCharIdx >= 0 && prevCharIdx < len) {
+		const prevChar = state.fullText[prevCharIdx];
+		if (PUNCTUATION.has(prevChar)) effectiveSpeed = punctDelay > 0 ? 1 / punctDelay : speed;
+	}
+	state._cursor += effectiveSpeed * dt;
+	const charCount = Math.min(Math.floor(state._cursor), len);
+	state.visibleText = state.fullText.slice(0, charCount);
+	if (charCount >= len) {
+		state.visibleText = state.fullText;
+		state.complete = true;
+	}
 }
 function completeTextReveal(state) {
-  state.visibleText = state.fullText;
-  state._cursor = state.fullText.length;
-  state.complete = true;
+	state.visibleText = state.fullText;
+	state._cursor = state.fullText.length;
+	state.complete = true;
 }
 function resetTextReveal(state, newText) {
-  const text = newText ?? state.fullText;
-  state.fullText = text;
-  state.visibleText = "";
-  state._cursor = 0;
-  state.complete = text.length === 0;
+	const text = newText ?? state.fullText;
+	state.fullText = text;
+	state.visibleText = "";
+	state._cursor = 0;
+	state.complete = text.length === 0;
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  completeTextReveal,
-  createDialogueGraph,
-  createDialogueRunner,
-  createTextReveal,
-  getNode,
-  interpolate,
-  resetTextReveal,
-  updateTextReveal
-});
+//#endregion
+exports.DialogueError = DialogueError;
+exports.completeTextReveal = completeTextReveal;
+exports.createDialogueGraph = createDialogueGraph;
+exports.createDialogueRunner = createDialogueRunner;
+exports.createTextReveal = createTextReveal;
+exports.getNode = getNode;
+exports.interpolate = interpolate;
+exports.resetTextReveal = resetTextReveal;
+exports.updateTextReveal = updateTextReveal;
+
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/graph.ts","../src/runner.ts","../src/text-reveal.ts"],"sourcesContent":["export {\n  type LineNode,\n  type ChoiceOption,\n  type ChoiceNode,\n  type BranchArm,\n  type BranchNode,\n  type ActionNode,\n  type EndNode,\n  type DialogueNode,\n  type DialogueGraph,\n  createDialogueGraph,\n  getNode,\n} from './graph.js';\n\nexport {\n  type ConditionResolver,\n  type ActionHandler,\n  type VariableBag,\n  type DialogueLineEvent,\n  type DialogueChoiceEvent,\n  type ActiveOption,\n  type DialogueRunnerState,\n  type DialogueRunner,\n  type DialogueRunnerOptions,\n  createDialogueRunner,\n  interpolate,\n} from './runner.js';\n\nexport {\n  type TextRevealState,\n  type TextRevealOptions,\n  createTextReveal,\n  updateTextReveal,\n  completeTextReveal,\n  resetTextReveal,\n} from './text-reveal.js';\n","/**\n * Dialogue graph data types.\n *\n * A dialogue graph is a directed graph of nodes. Each node is one of:\n * - `line`: NPC/character speaks. Optional `next` pointer.\n * - `choice`: Player picks from options. Each option points to a node.\n * - `branch`: Condition-based routing. First truthy condition wins.\n * - `action`: Fires a callback, then advances to `next`.\n * - `end`: Terminal node. Conversation stops.\n *\n * Graphs are plain JSON — no classes, no runtime coupling.\n */\n\n// ─── Node types ──────────────────────────────────────────────────\n\nexport interface LineNode {\n  readonly kind: 'line';\n  /** Speaker name / id. */\n  readonly speaker: string;\n  /**\n   * Optional portrait key resolved by the UI layer to an avatar image /\n   * shape / atlas frame. The dialogue runtime is portrait-agnostic — it\n   * forwards the key via `DialogueLineEvent.speakerPortraitKey`.\n   */\n  readonly speakerPortraitKey?: string;\n  /** Text template. Supports `{var}` interpolation via the runner's variable bag. */\n  readonly text: string;\n  /** Next node id, or null to end. */\n  readonly next: string | null;\n}\n\nexport interface ChoiceOption {\n  /** Display text. Supports `{var}` interpolation. */\n  readonly text: string;\n  /** Node id to jump to when selected. */\n  readonly next: string;\n  /** Optional condition key — option is hidden when condition returns false. */\n  readonly condition?: string;\n}\n\nexport interface ChoiceNode {\n  readonly kind: 'choice';\n  /** Optional prompt text before the choices. */\n  readonly prompt?: string;\n  /** Speaker for the prompt, if any. */\n  readonly speaker?: string;\n  readonly options: readonly ChoiceOption[];\n}\n\nexport interface BranchArm {\n  /** Condition key evaluated by the runner's condition resolver. */\n  readonly condition: string;\n  /** Node id to jump to when condition is true. */\n  readonly next: string;\n}\n\nexport interface BranchNode {\n  readonly kind: 'branch';\n  readonly arms: readonly BranchArm[];\n  /** Fallback node id if no arm matches. Null → end. */\n  readonly fallback: string | null;\n}\n\nexport interface ActionNode {\n  readonly kind: 'action';\n  /** Callback key. Runner looks this up in the action registry. */\n  readonly action: string;\n  /** Next node id after the action fires. */\n  readonly next: string | null;\n}\n\nexport interface EndNode {\n  readonly kind: 'end';\n}\n\nexport type DialogueNode = LineNode | ChoiceNode | BranchNode | ActionNode | EndNode;\n\n// ─── Graph ───────────────────────────────────────────────────────\n\nexport interface DialogueGraph {\n  /** Unique graph identifier. */\n  readonly id: string;\n  /** Node id to start from. */\n  readonly start: string;\n  /** All nodes keyed by id. */\n  readonly nodes: Record<string, DialogueNode>;\n}\n\nexport function createDialogueGraph(\n  id: string,\n  start: string,\n  nodes: Record<string, DialogueNode>,\n): DialogueGraph {\n  return { id, start, nodes };\n}\n\nexport function getNode(graph: DialogueGraph, nodeId: string): DialogueNode | undefined {\n  return graph.nodes[nodeId];\n}\n","/**\n * Dialogue runner — walks a DialogueGraph, evaluating conditions,\n * interpolating variables, and emitting signals for each step.\n */\n\nimport { Signal } from '@flare-engine/events';\nimport type { ChoiceNode, DialogueGraph, LineNode } from './graph.js';\nimport { getNode } from './graph.js';\n\n// ─── Types ───────────────────────────────────────────────────────\n\nexport type ConditionResolver = (key: string) => boolean;\nexport type ActionHandler = (key: string) => void | Promise<void>;\nexport type VariableBag = Record<string, string | number>;\n\nexport interface DialogueLineEvent {\n  readonly speaker: string;\n  /** Optional portrait key forwarded verbatim from the source LineNode. */\n  readonly speakerPortraitKey?: string;\n  readonly text: string;\n  readonly nodeId: string;\n}\n\nexport interface DialogueChoiceEvent {\n  readonly prompt: string | undefined;\n  readonly speaker: string | undefined;\n  readonly options: readonly ActiveOption[];\n  readonly nodeId: string;\n}\n\nexport interface ActiveOption {\n  readonly index: number;\n  readonly text: string;\n  readonly next: string;\n}\n\nexport type DialogueRunnerState = 'idle' | 'running' | 'waiting-choice' | 'ended';\n\n// ─── Interpolation ───────────────────────────────────────────────\n\nexport function interpolate(template: string, vars: VariableBag): string {\n  return template.replace(/\\{(\\w+)\\}/g, (_match, key: string) => {\n    const val = vars[key];\n    return val !== undefined ? String(val) : `{${key}}`;\n  });\n}\n\n// ─── Runner ──────────────────────────────────────────────────────\n\nexport interface DialogueRunner {\n  readonly onLine: Signal<DialogueLineEvent>;\n  readonly onChoice: Signal<DialogueChoiceEvent>;\n  readonly onAction: Signal<string>;\n  readonly onEnd: Signal<string>;\n\n  readonly state: DialogueRunnerState;\n  readonly currentNodeId: string | null;\n  readonly graphId: string | null;\n\n  start(graph: DialogueGraph, variables?: VariableBag): void;\n  advance(): void;\n  selectChoice(index: number): void;\n  stop(): void;\n}\n\nexport interface DialogueRunnerOptions {\n  conditions?: ConditionResolver;\n  actions?: ActionHandler;\n}\n\nexport function createDialogueRunner(options?: DialogueRunnerOptions): DialogueRunner {\n  const onLine = new Signal<DialogueLineEvent>();\n  const onChoice = new Signal<DialogueChoiceEvent>();\n  const onAction = new Signal<string>();\n  const onEnd = new Signal<string>();\n\n  const conditions = options?.conditions ?? (() => true);\n  const actions = options?.actions;\n\n  let _state: DialogueRunnerState = 'idle';\n  let _graph: DialogueGraph | null = null;\n  let _currentNodeId: string | null = null;\n  let _vars: VariableBag = {};\n  let _activeOptions: ActiveOption[] = [];\n\n  function setState(s: DialogueRunnerState): void {\n    _state = s;\n  }\n\n  function processNode(nodeId: string): void {\n    if (!_graph) return;\n    const node = getNode(_graph, nodeId);\n    if (!node) {\n      end();\n      return;\n    }\n    _currentNodeId = nodeId;\n\n    switch (node.kind) {\n      case 'line':\n        processLine(node, nodeId);\n        break;\n      case 'choice':\n        processChoice(node, nodeId);\n        break;\n      case 'branch':\n        processBranch(node);\n        break;\n      case 'action':\n        processAction(node);\n        break;\n      case 'end':\n        end();\n        break;\n    }\n  }\n\n  function processLine(node: LineNode, nodeId: string): void {\n    setState('running');\n    const text = interpolate(node.text, _vars);\n    onLine.emit({\n      speaker: node.speaker,\n      speakerPortraitKey: node.speakerPortraitKey,\n      text,\n      nodeId,\n    });\n  }\n\n  function processChoice(node: ChoiceNode, nodeId: string): void {\n    // Filter options by condition\n    _activeOptions = [];\n    for (let i = 0; i < node.options.length; i++) {\n      const opt = node.options[i]!;\n      if (opt.condition && !conditions(opt.condition)) continue;\n      _activeOptions.push({\n        index: _activeOptions.length,\n        text: interpolate(opt.text, _vars),\n        next: opt.next,\n      });\n    }\n\n    if (_activeOptions.length === 0) {\n      // No valid options — treat as end\n      end();\n      return;\n    }\n\n    setState('waiting-choice');\n    onChoice.emit({\n      prompt: node.prompt ? interpolate(node.prompt, _vars) : undefined,\n      speaker: node.speaker,\n      options: _activeOptions,\n      nodeId,\n    });\n  }\n\n  function processBranch(node: {\n    arms: readonly { condition: string; next: string }[];\n    fallback: string | null;\n  }): void {\n    for (let i = 0; i < node.arms.length; i++) {\n      const arm = node.arms[i]!;\n      if (conditions(arm.condition)) {\n        processNode(arm.next);\n        return;\n      }\n    }\n    if (node.fallback) {\n      processNode(node.fallback);\n    } else {\n      end();\n    }\n  }\n\n  function processAction(node: { action: string; next: string | null }): void {\n    onAction.emit(node.action);\n    actions?.(node.action);\n    if (node.next) {\n      processNode(node.next);\n    } else {\n      end();\n    }\n  }\n\n  function end(): void {\n    setState('ended');\n    const graphId = _graph?.id ?? '';\n    _currentNodeId = null;\n    onEnd.emit(graphId);\n  }\n\n  const runner: DialogueRunner = {\n    onLine,\n    onChoice,\n    onAction,\n    onEnd,\n\n    get state() {\n      return _state;\n    },\n    get currentNodeId() {\n      return _currentNodeId;\n    },\n    get graphId() {\n      return _graph?.id ?? null;\n    },\n\n    start(graph: DialogueGraph, variables?: VariableBag): void {\n      _graph = graph;\n      _vars = variables ?? {};\n      _activeOptions = [];\n      setState('running');\n      processNode(graph.start);\n    },\n\n    advance(): void {\n      if (_state !== 'running' || !_graph || !_currentNodeId) return;\n      const node = getNode(_graph, _currentNodeId);\n      if (!node || node.kind !== 'line') return;\n      if (node.next) {\n        processNode(node.next);\n      } else {\n        end();\n      }\n    },\n\n    selectChoice(index: number): void {\n      if (_state !== 'waiting-choice') return;\n      const opt = _activeOptions[index];\n      if (!opt) return;\n      _activeOptions = [];\n      setState('running');\n      processNode(opt.next);\n    },\n\n    stop(): void {\n      setState('idle');\n      _graph = null;\n      _currentNodeId = null;\n      _vars = {};\n      _activeOptions = [];\n    },\n  };\n\n  return runner;\n}\n","/**\n * Text-over-time reveal hook for dialogue lines.\n *\n * Drives a typewriter effect: call `updateTextReveal(state, dt)` each frame\n * and read `state.visibleText` for the currently revealed substring.\n * Supports per-character speed, instant-complete, and pause-on-punctuation.\n */\n\n// ─── Types ───────────────────────────────────────────────────────\n\nexport interface TextRevealState {\n  /** Full text being revealed. */\n  readonly fullText: string;\n  /** Characters revealed so far. */\n  visibleText: string;\n  /** Whether the full text has been revealed. */\n  complete: boolean;\n  /** Internal fractional character cursor. */\n  _cursor: number;\n}\n\nexport interface TextRevealOptions {\n  /** Characters per second. Default: 30. */\n  speed?: number;\n  /** Extra delay (in seconds) after punctuation (.!?). Default: 0.15. */\n  punctuationDelay?: number;\n}\n\nconst DEFAULT_SPEED = 30;\nconst DEFAULT_PUNCT_DELAY = 0.15;\n\nconst PUNCTUATION = new Set(['.', '!', '?', ':', ';']);\n\n// ─── API ─────────────────────────────────────────────────────────\n\nexport function createTextReveal(text: string): TextRevealState {\n  if (text.length === 0) {\n    return { fullText: text, visibleText: text, complete: true, _cursor: 0 };\n  }\n  return { fullText: text, visibleText: '', complete: false, _cursor: 0 };\n}\n\nexport function updateTextReveal(\n  state: TextRevealState,\n  dt: number,\n  options?: TextRevealOptions,\n): void {\n  if (state.complete) return;\n\n  const speed = options?.speed ?? DEFAULT_SPEED;\n  const punctDelay = options?.punctuationDelay ?? DEFAULT_PUNCT_DELAY;\n  const len = state.fullText.length;\n\n  // Determine effective speed — slow down after punctuation\n  const prevCharIdx = Math.floor(state._cursor) - 1;\n  let effectiveSpeed = speed;\n  if (prevCharIdx >= 0 && prevCharIdx < len) {\n    const prevChar = state.fullText[prevCharIdx]!;\n    if (PUNCTUATION.has(prevChar)) {\n      // Slow down: treat the punctuation gap as taking `punctDelay` seconds\n      // Effective speed = 1 / punctDelay so cursor advances ~1 char in punctDelay time\n      effectiveSpeed = punctDelay > 0 ? 1 / punctDelay : speed;\n    }\n  }\n\n  state._cursor += effectiveSpeed * dt;\n  const charCount = Math.min(Math.floor(state._cursor), len);\n  state.visibleText = state.fullText.slice(0, charCount);\n\n  if (charCount >= len) {\n    state.visibleText = state.fullText;\n    state.complete = true;\n  }\n}\n\nexport function completeTextReveal(state: TextRevealState): void {\n  state.visibleText = state.fullText;\n  state._cursor = state.fullText.length;\n  state.complete = true;\n}\n\nexport function resetTextReveal(state: TextRevealState, newText?: string): void {\n  const text = newText ?? state.fullText;\n  (state as { fullText: string }).fullText = text;\n  state.visibleText = '';\n  state._cursor = 0;\n  state.complete = text.length === 0;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"file":"index.js","names":["Signal"],"sources":["../src/graph.ts","../src/runner.ts","../src/text-reveal.ts"],"sourcesContent":["/**\n * Dialogue graph data types.\n *\n * A dialogue graph is a directed graph of nodes. Each node is one of:\n * - `line`: NPC/character speaks. Optional `next` pointer.\n * - `choice`: Player picks from options. Each option points to a node.\n * - `branch`: Condition-based routing. First truthy condition wins.\n * - `action`: Fires a callback, then advances to `next`.\n * - `end`: Terminal node. Conversation stops.\n *\n * Graphs are plain JSON — no classes, no runtime coupling.\n */\n\n// ─── Node types ──────────────────────────────────────────────────\n\nexport interface LineNode {\n  readonly kind: 'line';\n  /** Speaker name / id. */\n  readonly speaker: string;\n  /**\n   * Optional portrait key resolved by the UI layer to an avatar image /\n   * shape / atlas frame. The dialogue runtime is portrait-agnostic — it\n   * forwards the key via `DialogueLineEvent.speakerPortraitKey`.\n   */\n  readonly speakerPortraitKey?: string;\n  /** Text template. Supports `{var}` interpolation via the runner's variable bag. */\n  readonly text: string;\n  /** Next node id, or null to end. */\n  readonly next: string | null;\n}\n\nexport interface ChoiceOption {\n  /** Display text. Supports `{var}` interpolation. */\n  readonly text: string;\n  /** Node id to jump to when selected. */\n  readonly next: string;\n  /** Optional condition key — option is hidden when condition returns false. */\n  readonly condition?: string;\n}\n\nexport interface ChoiceNode {\n  readonly kind: 'choice';\n  /** Optional prompt text before the choices. */\n  readonly prompt?: string;\n  /** Speaker for the prompt, if any. */\n  readonly speaker?: string;\n  readonly options: readonly ChoiceOption[];\n}\n\nexport interface BranchArm {\n  /** Condition key evaluated by the runner's condition resolver. */\n  readonly condition: string;\n  /** Node id to jump to when condition is true. */\n  readonly next: string;\n}\n\nexport interface BranchNode {\n  readonly kind: 'branch';\n  readonly arms: readonly BranchArm[];\n  /** Fallback node id if no arm matches. Null → end. */\n  readonly fallback: string | null;\n}\n\nexport interface ActionNode {\n  readonly kind: 'action';\n  /** Callback key. Runner looks this up in the action registry. */\n  readonly action: string;\n  /** Next node id after the action fires. */\n  readonly next: string | null;\n}\n\nexport interface EndNode {\n  readonly kind: 'end';\n}\n\nexport type DialogueNode = LineNode | ChoiceNode | BranchNode | ActionNode | EndNode;\n\n// ─── Graph ───────────────────────────────────────────────────────\n\nexport interface DialogueGraph {\n  /** Unique graph identifier. */\n  readonly id: string;\n  /** Node id to start from. */\n  readonly start: string;\n  /** All nodes keyed by id. */\n  readonly nodes: Record<string, DialogueNode>;\n}\n\nexport function createDialogueGraph(\n  id: string,\n  start: string,\n  nodes: Record<string, DialogueNode>,\n): DialogueGraph {\n  return { id, start, nodes };\n}\n\nexport function getNode(graph: DialogueGraph, nodeId: string): DialogueNode | undefined {\n  return Object.hasOwn(graph.nodes, nodeId) ? graph.nodes[nodeId] : undefined;\n}\n","/**\n * Dialogue runner — walks a DialogueGraph, evaluating conditions,\n * interpolating variables, and emitting signals for each step.\n */\n\nimport { Signal } from '@flare-engine/events';\nimport type { ChoiceNode, DialogueGraph, LineNode } from './graph.js';\nimport { getNode } from './graph.js';\n\n// ─── Error ───────────────────────────────────────────────────────\n\nexport type DialogueErrorCode = 'missing-node' | 'cycle';\n\nexport class DialogueError extends Error {\n  readonly code: DialogueErrorCode;\n  /** Source node whose transition triggered the error (or the entry id when there is no source). */\n  readonly nodeId: string;\n  /** 'missing-node': the target id that could not be resolved. */\n  readonly missingId?: string;\n  /** 'cycle': the node-id chain walked before the step budget was exceeded. */\n  readonly chain?: readonly string[];\n\n  constructor(\n    code: DialogueErrorCode,\n    message: string,\n    detail: { nodeId: string; missingId?: string; chain?: readonly string[] },\n  ) {\n    super(message);\n    this.name = 'DialogueError';\n    this.code = code;\n    this.nodeId = detail.nodeId;\n    this.missingId = detail.missingId;\n    this.chain = detail.chain;\n  }\n}\n\n// ─── Types ───────────────────────────────────────────────────────\n\nexport type ConditionResolver = (key: string) => boolean;\nexport type ActionHandler = (key: string) => void | Promise<void>;\nexport type VariableBag = Record<string, string | number>;\n\nexport interface DialogueLineEvent {\n  readonly speaker: string;\n  /** Optional portrait key forwarded verbatim from the source LineNode. */\n  readonly speakerPortraitKey?: string;\n  readonly text: string;\n  readonly nodeId: string;\n}\n\nexport interface DialogueChoiceEvent {\n  readonly prompt: string | undefined;\n  readonly speaker: string | undefined;\n  readonly options: readonly ActiveOption[];\n  readonly nodeId: string;\n}\n\nexport interface ActiveOption {\n  readonly index: number;\n  readonly text: string;\n  readonly next: string;\n}\n\nexport type DialogueRunnerState = 'idle' | 'running' | 'waiting-choice' | 'ended';\n\n// ─── Interpolation ───────────────────────────────────────────────\n\nexport function interpolate(template: string, vars: VariableBag): string {\n  return template.replace(/\\{(\\w+)\\}/g, (_match, key: string) => {\n    const val = Object.hasOwn(vars, key) ? vars[key] : undefined;\n    return val !== undefined ? String(val) : `{${key}}`;\n  });\n}\n\n// ─── Runner ──────────────────────────────────────────────────────\n\nexport interface DialogueRunner {\n  readonly onLine: Signal<DialogueLineEvent>;\n  readonly onChoice: Signal<DialogueChoiceEvent>;\n  readonly onAction: Signal<string>;\n  readonly onEnd: Signal<string>;\n\n  readonly state: DialogueRunnerState;\n  readonly currentNodeId: string | null;\n  readonly graphId: string | null;\n\n  start(graph: DialogueGraph, variables?: VariableBag): void;\n  advance(): void;\n  selectChoice(index: number): void;\n  stop(): void;\n}\n\nexport interface DialogueRunnerOptions {\n  conditions?: ConditionResolver;\n  actions?: ActionHandler;\n  /**\n   * Invoked on a recoverable dialogue error — currently a transition to a\n   * missing node. Default (no hook): logs a console.warn, then ends.\n   */\n  onError?: (err: DialogueError) => void;\n}\n\nconst STEP_BUDGET = 1000;\n\nexport function createDialogueRunner(options?: DialogueRunnerOptions): DialogueRunner {\n  const onLine = new Signal<DialogueLineEvent>();\n  const onChoice = new Signal<DialogueChoiceEvent>();\n  const onAction = new Signal<string>();\n  const onEnd = new Signal<string>();\n\n  const conditions = options?.conditions ?? (() => true);\n  const actions = options?.actions;\n  const onError = options?.onError;\n\n  let _state: DialogueRunnerState = 'idle';\n  let _graph: DialogueGraph | null = null;\n  let _currentNodeId: string | null = null;\n  let _vars: VariableBag = {};\n  let _activeOptions: ActiveOption[] = [];\n\n  function setState(s: DialogueRunnerState): void {\n    _state = s;\n  }\n\n  function end(): void {\n    setState('ended');\n    const graphId = _graph?.id ?? '';\n    _currentNodeId = null;\n    onEnd.emit(graphId);\n  }\n\n  function reportMissing(fromNodeId: string | null, missingId: string): void {\n    const graphId = _graph?.id ?? '';\n    const from = fromNodeId ? ` from node '${fromNodeId}'` : ' as its start node';\n    const err = new DialogueError(\n      'missing-node',\n      `Dialogue '${graphId}' references missing node '${missingId}'${from} — ending conversation.`,\n      { nodeId: fromNodeId ?? missingId, missingId },\n    );\n    if (onError) onError(err);\n    else console.warn(err.message);\n  }\n\n  function processLine(node: LineNode, nodeId: string): void {\n    setState('running');\n    const text = interpolate(node.text, _vars);\n    onLine.emit({\n      speaker: node.speaker,\n      speakerPortraitKey: node.speakerPortraitKey,\n      text,\n      nodeId,\n    });\n  }\n\n  function processChoice(node: ChoiceNode, nodeId: string): void {\n    _activeOptions = [];\n    for (let i = 0; i < node.options.length; i++) {\n      const opt = node.options[i]!;\n      if (opt.condition && !conditions(opt.condition)) continue;\n      _activeOptions.push({\n        index: _activeOptions.length,\n        text: interpolate(opt.text, _vars),\n        next: opt.next,\n      });\n    }\n\n    if (_activeOptions.length === 0) {\n      end();\n      return;\n    }\n\n    setState('waiting-choice');\n    onChoice.emit({\n      prompt: node.prompt ? interpolate(node.prompt, _vars) : undefined,\n      speaker: node.speaker,\n      options: _activeOptions,\n      nodeId,\n    });\n  }\n\n  function run(entryId: string, fromNodeId: string | null): void {\n    if (!_graph) return;\n\n    let currentId: string | null = entryId;\n    let from: string | null = fromNodeId;\n    const chain: string[] = [];\n    let steps = 0;\n\n    while (currentId !== null) {\n      const nodeId = currentId;\n      const node = getNode(_graph, nodeId);\n\n      if (!node) {\n        reportMissing(from, nodeId);\n        end();\n        return;\n      }\n\n      chain.push(nodeId);\n      if (++steps > STEP_BUDGET) {\n        throw new DialogueError(\n          'cycle',\n          `Dialogue '${_graph.id}' cycle detected — step budget exceeded (chain: …${chain.slice(-12).join('→')})`,\n          { nodeId, chain: chain.slice() },\n        );\n      }\n\n      _currentNodeId = nodeId;\n      from = nodeId;\n\n      switch (node.kind) {\n        case 'line':\n          processLine(node, nodeId);\n          return;\n        case 'choice':\n          processChoice(node, nodeId);\n          return;\n        case 'branch': {\n          let next: string | null = node.fallback;\n          for (const arm of node.arms) {\n            if (conditions(arm.condition)) {\n              next = arm.next;\n              break;\n            }\n          }\n          currentId = next;\n          break;\n        }\n        case 'action':\n          onAction.emit(node.action);\n          actions?.(node.action);\n          currentId = node.next;\n          break;\n        case 'end':\n          end();\n          return;\n      }\n    }\n\n    end();\n  }\n\n  const runner: DialogueRunner = {\n    onLine,\n    onChoice,\n    onAction,\n    onEnd,\n\n    get state() {\n      return _state;\n    },\n    get currentNodeId() {\n      return _currentNodeId;\n    },\n    get graphId() {\n      return _graph?.id ?? null;\n    },\n\n    start(graph: DialogueGraph, variables?: VariableBag): void {\n      _graph = graph;\n      _vars = variables ?? {};\n      _activeOptions = [];\n      setState('running');\n      run(graph.start, null);\n    },\n\n    advance(): void {\n      if (_state !== 'running' || !_graph || !_currentNodeId) return;\n      const node = getNode(_graph, _currentNodeId);\n      if (node?.kind !== 'line') return;\n      if (node.next) {\n        run(node.next, _currentNodeId);\n      } else {\n        end();\n      }\n    },\n\n    selectChoice(index: number): void {\n      if (_state !== 'waiting-choice') return;\n      const opt = _activeOptions[index];\n      if (!opt) return;\n      _activeOptions = [];\n      setState('running');\n      run(opt.next, _currentNodeId);\n    },\n\n    stop(): void {\n      setState('idle');\n      _graph = null;\n      _currentNodeId = null;\n      _vars = {};\n      _activeOptions = [];\n    },\n  };\n\n  return runner;\n}\n","/**\n * Text-over-time reveal hook for dialogue lines.\n *\n * Drives a typewriter effect: call `updateTextReveal(state, dt)` each frame\n * and read `state.visibleText` for the currently revealed substring.\n * Supports per-character speed, instant-complete, and pause-on-punctuation.\n */\n\n// ─── Types ───────────────────────────────────────────────────────\n\nexport interface TextRevealState {\n  /** Full text being revealed. */\n  readonly fullText: string;\n  /** Characters revealed so far. */\n  visibleText: string;\n  /** Whether the full text has been revealed. */\n  complete: boolean;\n  /** Internal fractional character cursor. */\n  _cursor: number;\n}\n\nexport interface TextRevealOptions {\n  /** Characters per second. Default: 30. */\n  speed?: number;\n  /** Extra delay (in seconds) after punctuation (.!?). Default: 0.15. */\n  punctuationDelay?: number;\n}\n\nconst DEFAULT_SPEED = 30;\nconst DEFAULT_PUNCT_DELAY = 0.15;\n\nconst PUNCTUATION = new Set(['.', '!', '?', ':', ';']);\n\n// ─── API ─────────────────────────────────────────────────────────\n\nexport function createTextReveal(text: string): TextRevealState {\n  if (text.length === 0) {\n    return { fullText: text, visibleText: text, complete: true, _cursor: 0 };\n  }\n  return { fullText: text, visibleText: '', complete: false, _cursor: 0 };\n}\n\nexport function updateTextReveal(\n  state: TextRevealState,\n  dt: number,\n  options?: TextRevealOptions,\n): void {\n  if (state.complete) return;\n\n  const speed = options?.speed ?? DEFAULT_SPEED;\n  const punctDelay = options?.punctuationDelay ?? DEFAULT_PUNCT_DELAY;\n  const len = state.fullText.length;\n\n  // Determine effective speed — slow down after punctuation\n  const prevCharIdx = Math.floor(state._cursor) - 1;\n  let effectiveSpeed = speed;\n  if (prevCharIdx >= 0 && prevCharIdx < len) {\n    const prevChar = state.fullText[prevCharIdx]!;\n    if (PUNCTUATION.has(prevChar)) {\n      // Slow down: treat the punctuation gap as taking `punctDelay` seconds\n      // Effective speed = 1 / punctDelay so cursor advances ~1 char in punctDelay time\n      effectiveSpeed = punctDelay > 0 ? 1 / punctDelay : speed;\n    }\n  }\n\n  state._cursor += effectiveSpeed * dt;\n  const charCount = Math.min(Math.floor(state._cursor), len);\n  state.visibleText = state.fullText.slice(0, charCount);\n\n  if (charCount >= len) {\n    state.visibleText = state.fullText;\n    state.complete = true;\n  }\n}\n\nexport function completeTextReveal(state: TextRevealState): void {\n  state.visibleText = state.fullText;\n  state._cursor = state.fullText.length;\n  state.complete = true;\n}\n\nexport function resetTextReveal(state: TextRevealState, newText?: string): void {\n  const text = newText ?? state.fullText;\n  (state as { fullText: string }).fullText = text;\n  state.visibleText = '';\n  state._cursor = 0;\n  state.complete = text.length === 0;\n}\n"],"mappings":"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"}