@flare-engine/dialogue 0.1.0

package/LICENSE

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

package/README.md

@@ -0,0 +1,34 @@
+# @flare-engine/dialogue
+
+Branching dialogue graphs — `LineNode` / `ChoiceNode` / `BranchNode` / `ActionNode` / `EndNode`. `DialogueRunner` advances the graph with caller-supplied `ConditionResolver` + `ActionHandler` + `VariableBag`. `interpolate` substitutes `{var}` tokens. `createTextReveal` is a typewriter state machine. No rendering — pair with `@flare-engine/ui` `DialoguePanel` for the view layer.
+
+## Install
+
+```sh
+bun add @flare-engine/dialogue
+```
+
+## Usage
+
+```ts
+import { createDialogueGraph, createDialogueRunner, createTextReveal } from '@flare-engine/dialogue';
+
+const graph = createDialogueGraph('start', new Map([
+  ['start', { kind: 'line', speaker: 'mage', text: 'Hello {playerName}.', next: 'choice' }],
+  ['choice', { kind: 'choice', options: [/* ... */] }],
+]));
+
+const runner = createDialogueRunner(graph, {
+  variables: { playerName: 'Twardowski' },
+  conditions: () => true,
+  actions: (id, args) => { /* ... */ },
+});
+
+const reveal = createTextReveal('Hello.', { cps: 30 });
+```
+
+See [API spec](../../docs/design/api-specs.md#flare-enginedialogue--5kb-gzip) and [skill reference](../../.github/skills/flare-dialogue/SKILL.md).
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,155 @@
+import { Signal } from '@flare-engine/events';
+
+/**
+ * Dialogue graph data types.
+ *
+ * A dialogue graph is a directed graph of nodes. Each node is one of:
+ * - `line`: NPC/character speaks. Optional `next` pointer.
+ * - `choice`: Player picks from options. Each option points to a node.
+ * - `branch`: Condition-based routing. First truthy condition wins.
+ * - `action`: Fires a callback, then advances to `next`.
+ * - `end`: Terminal node. Conversation stops.
+ *
+ * Graphs are plain JSON — no classes, no runtime coupling.
+ */
+interface LineNode {
+    readonly kind: 'line';
+    /** Speaker name / id. */
+    readonly speaker: string;
+    /**
+     * Optional portrait key resolved by the UI layer to an avatar image /
+     * shape / atlas frame. The dialogue runtime is portrait-agnostic — it
+     * forwards the key via `DialogueLineEvent.speakerPortraitKey`.
+     */
+    readonly speakerPortraitKey?: string;
+    /** Text template. Supports `{var}` interpolation via the runner's variable bag. */
+    readonly text: string;
+    /** Next node id, or null to end. */
+    readonly next: string | null;
+}
+interface ChoiceOption {
+    /** Display text. Supports `{var}` interpolation. */
+    readonly text: string;
+    /** Node id to jump to when selected. */
+    readonly next: string;
+    /** Optional condition key — option is hidden when condition returns false. */
+    readonly condition?: string;
+}
+interface ChoiceNode {
+    readonly kind: 'choice';
+    /** Optional prompt text before the choices. */
+    readonly prompt?: string;
+    /** Speaker for the prompt, if any. */
+    readonly speaker?: string;
+    readonly options: readonly ChoiceOption[];
+}
+interface BranchArm {
+    /** Condition key evaluated by the runner's condition resolver. */
+    readonly condition: string;
+    /** Node id to jump to when condition is true. */
+    readonly next: string;
+}
+interface BranchNode {
+    readonly kind: 'branch';
+    readonly arms: readonly BranchArm[];
+    /** Fallback node id if no arm matches. Null → end. */
+    readonly fallback: string | null;
+}
+interface ActionNode {
+    readonly kind: 'action';
+    /** Callback key. Runner looks this up in the action registry. */
+    readonly action: string;
+    /** Next node id after the action fires. */
+    readonly next: string | null;
+}
+interface EndNode {
+    readonly kind: 'end';
+}
+type DialogueNode = LineNode | ChoiceNode | BranchNode | ActionNode | EndNode;
+interface DialogueGraph {
+    /** Unique graph identifier. */
+    readonly id: string;
+    /** Node id to start from. */
+    readonly start: string;
+    /** All nodes keyed by id. */
+    readonly nodes: Record<string, DialogueNode>;
+}
+declare function createDialogueGraph(id: string, start: string, nodes: Record<string, DialogueNode>): DialogueGraph;
+declare function getNode(graph: DialogueGraph, nodeId: string): DialogueNode | undefined;
+
+/**
+ * Dialogue runner — walks a DialogueGraph, evaluating conditions,
+ * interpolating variables, and emitting signals for each step.
+ */
+
+type ConditionResolver = (key: string) => boolean;
+type ActionHandler = (key: string) => void | Promise<void>;
+type VariableBag = Record<string, string | number>;
+interface DialogueLineEvent {
+    readonly speaker: string;
+    /** Optional portrait key forwarded verbatim from the source LineNode. */
+    readonly speakerPortraitKey?: string;
+    readonly text: string;
+    readonly nodeId: string;
+}
+interface DialogueChoiceEvent {
+    readonly prompt: string | undefined;
+    readonly speaker: string | undefined;
+    readonly options: readonly ActiveOption[];
+    readonly nodeId: string;
+}
+interface ActiveOption {
+    readonly index: number;
+    readonly text: string;
+    readonly next: string;
+}
+type DialogueRunnerState = 'idle' | 'running' | 'waiting-choice' | 'ended';
+declare function interpolate(template: string, vars: VariableBag): string;
+interface DialogueRunner {
+    readonly onLine: Signal<DialogueLineEvent>;
+    readonly onChoice: Signal<DialogueChoiceEvent>;
+    readonly onAction: Signal<string>;
+    readonly onEnd: Signal<string>;
+    readonly state: DialogueRunnerState;
+    readonly currentNodeId: string | null;
+    readonly graphId: string | null;
+    start(graph: DialogueGraph, variables?: VariableBag): void;
+    advance(): void;
+    selectChoice(index: number): void;
+    stop(): void;
+}
+interface DialogueRunnerOptions {
+    conditions?: ConditionResolver;
+    actions?: ActionHandler;
+}
+declare function createDialogueRunner(options?: DialogueRunnerOptions): DialogueRunner;
+
+/**
+ * Text-over-time reveal hook for dialogue lines.
+ *
+ * Drives a typewriter effect: call `updateTextReveal(state, dt)` each frame
+ * and read `state.visibleText` for the currently revealed substring.
+ * Supports per-character speed, instant-complete, and pause-on-punctuation.
+ */
+interface TextRevealState {
+    /** Full text being revealed. */
+    readonly fullText: string;
+    /** Characters revealed so far. */
+    visibleText: string;
+    /** Whether the full text has been revealed. */
+    complete: boolean;
+    /** Internal fractional character cursor. */
+    _cursor: number;
+}
+interface TextRevealOptions {
+    /** Characters per second. Default: 30. */
+    speed?: number;
+    /** Extra delay (in seconds) after punctuation (.!?). Default: 0.15. */
+    punctuationDelay?: number;
+}
+declare function createTextReveal(text: string): TextRevealState;
+declare function updateTextReveal(state: TextRevealState, dt: number, options?: TextRevealOptions): void;
+declare function completeTextReveal(state: TextRevealState): void;
+declare function resetTextReveal(state: TextRevealState, newText?: string): void;
+
+export { type ActionHandler, type ActionNode, type ActiveOption, type BranchArm, type BranchNode, type ChoiceNode, type ChoiceOption, type ConditionResolver, type DialogueChoiceEvent, type DialogueGraph, type DialogueLineEvent, type DialogueNode, type DialogueRunner, type DialogueRunnerOptions, type DialogueRunnerState, type EndNode, type LineNode, type TextRevealOptions, type TextRevealState, type VariableBag, completeTextReveal, createDialogueGraph, createDialogueRunner, createTextReveal, getNode, interpolate, resetTextReveal, updateTextReveal };

package/dist/index.d.ts

@@ -0,0 +1,155 @@
+import { Signal } from '@flare-engine/events';
+
+/**
+ * Dialogue graph data types.
+ *
+ * A dialogue graph is a directed graph of nodes. Each node is one of:
+ * - `line`: NPC/character speaks. Optional `next` pointer.
+ * - `choice`: Player picks from options. Each option points to a node.
+ * - `branch`: Condition-based routing. First truthy condition wins.
+ * - `action`: Fires a callback, then advances to `next`.
+ * - `end`: Terminal node. Conversation stops.
+ *
+ * Graphs are plain JSON — no classes, no runtime coupling.
+ */
+interface LineNode {
+    readonly kind: 'line';
+    /** Speaker name / id. */
+    readonly speaker: string;
+    /**
+     * Optional portrait key resolved by the UI layer to an avatar image /
+     * shape / atlas frame. The dialogue runtime is portrait-agnostic — it
+     * forwards the key via `DialogueLineEvent.speakerPortraitKey`.
+     */
+    readonly speakerPortraitKey?: string;
+    /** Text template. Supports `{var}` interpolation via the runner's variable bag. */
+    readonly text: string;
+    /** Next node id, or null to end. */
+    readonly next: string | null;
+}
+interface ChoiceOption {
+    /** Display text. Supports `{var}` interpolation. */
+    readonly text: string;
+    /** Node id to jump to when selected. */
+    readonly next: string;
+    /** Optional condition key — option is hidden when condition returns false. */
+    readonly condition?: string;
+}
+interface ChoiceNode {
+    readonly kind: 'choice';
+    /** Optional prompt text before the choices. */
+    readonly prompt?: string;
+    /** Speaker for the prompt, if any. */
+    readonly speaker?: string;
+    readonly options: readonly ChoiceOption[];
+}
+interface BranchArm {
+    /** Condition key evaluated by the runner's condition resolver. */
+    readonly condition: string;
+    /** Node id to jump to when condition is true. */
+    readonly next: string;
+}
+interface BranchNode {
+    readonly kind: 'branch';
+    readonly arms: readonly BranchArm[];
+    /** Fallback node id if no arm matches. Null → end. */
+    readonly fallback: string | null;
+}
+interface ActionNode {
+    readonly kind: 'action';
+    /** Callback key. Runner looks this up in the action registry. */
+    readonly action: string;
+    /** Next node id after the action fires. */
+    readonly next: string | null;
+}
+interface EndNode {
+    readonly kind: 'end';
+}
+type DialogueNode = LineNode | ChoiceNode | BranchNode | ActionNode | EndNode;
+interface DialogueGraph {
+    /** Unique graph identifier. */
+    readonly id: string;
+    /** Node id to start from. */
+    readonly start: string;
+    /** All nodes keyed by id. */
+    readonly nodes: Record<string, DialogueNode>;
+}
+declare function createDialogueGraph(id: string, start: string, nodes: Record<string, DialogueNode>): DialogueGraph;
+declare function getNode(graph: DialogueGraph, nodeId: string): DialogueNode | undefined;
+
+/**
+ * Dialogue runner — walks a DialogueGraph, evaluating conditions,
+ * interpolating variables, and emitting signals for each step.
+ */
+
+type ConditionResolver = (key: string) => boolean;
+type ActionHandler = (key: string) => void | Promise<void>;
+type VariableBag = Record<string, string | number>;
+interface DialogueLineEvent {
+    readonly speaker: string;
+    /** Optional portrait key forwarded verbatim from the source LineNode. */
+    readonly speakerPortraitKey?: string;
+    readonly text: string;
+    readonly nodeId: string;
+}
+interface DialogueChoiceEvent {
+    readonly prompt: string | undefined;
+    readonly speaker: string | undefined;
+    readonly options: readonly ActiveOption[];
+    readonly nodeId: string;
+}
+interface ActiveOption {
+    readonly index: number;
+    readonly text: string;
+    readonly next: string;
+}
+type DialogueRunnerState = 'idle' | 'running' | 'waiting-choice' | 'ended';
+declare function interpolate(template: string, vars: VariableBag): string;
+interface DialogueRunner {
+    readonly onLine: Signal<DialogueLineEvent>;
+    readonly onChoice: Signal<DialogueChoiceEvent>;
+    readonly onAction: Signal<string>;
+    readonly onEnd: Signal<string>;
+    readonly state: DialogueRunnerState;
+    readonly currentNodeId: string | null;
+    readonly graphId: string | null;
+    start(graph: DialogueGraph, variables?: VariableBag): void;
+    advance(): void;
+    selectChoice(index: number): void;
+    stop(): void;
+}
+interface DialogueRunnerOptions {
+    conditions?: ConditionResolver;
+    actions?: ActionHandler;
+}
+declare function createDialogueRunner(options?: DialogueRunnerOptions): DialogueRunner;
+
+/**
+ * Text-over-time reveal hook for dialogue lines.
+ *
+ * Drives a typewriter effect: call `updateTextReveal(state, dt)` each frame
+ * and read `state.visibleText` for the currently revealed substring.
+ * Supports per-character speed, instant-complete, and pause-on-punctuation.
+ */
+interface TextRevealState {
+    /** Full text being revealed. */
+    readonly fullText: string;
+    /** Characters revealed so far. */
+    visibleText: string;
+    /** Whether the full text has been revealed. */
+    complete: boolean;
+    /** Internal fractional character cursor. */
+    _cursor: number;
+}
+interface TextRevealOptions {
+    /** Characters per second. Default: 30. */
+    speed?: number;
+    /** Extra delay (in seconds) after punctuation (.!?). Default: 0.15. */
+    punctuationDelay?: number;
+}
+declare function createTextReveal(text: string): TextRevealState;
+declare function updateTextReveal(state: TextRevealState, dt: number, options?: TextRevealOptions): void;
+declare function completeTextReveal(state: TextRevealState): void;
+declare function resetTextReveal(state: TextRevealState, newText?: string): void;
+
+export { type ActionHandler, type ActionNode, type ActiveOption, type BranchArm, type BranchNode, type ChoiceNode, type ChoiceOption, type ConditionResolver, type DialogueChoiceEvent, type DialogueGraph, type DialogueLineEvent, type DialogueNode, type DialogueRunner, type DialogueRunnerOptions, type DialogueRunnerState, type EndNode, type LineNode, type TextRevealOptions, type TextRevealState, type VariableBag, completeTextReveal, createDialogueGraph, createDialogueRunner, createTextReveal, getNode, interpolate, resetTextReveal, updateTextReveal };

package/dist/index.js

@@ -0,0 +1,257 @@
+"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
+function createDialogueGraph(id, start, nodes) {
+  return { id, start, nodes };
+}
+function getNode(graph, nodeId) {
+  return graph.nodes[nodeId];
+}
+
+// src/runner.ts
+var import_events = require("@flare-engine/events");
+function interpolate(template, vars) {
+  return template.replace(/\{(\w+)\}/g, (_match, key) => {
+    const val = vars[key];
+    return val !== void 0 ? String(val) : `{${key}}`;
+  });
+}
+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;
+}
+
+// src/text-reveal.ts
+var DEFAULT_SPEED = 30;
+var DEFAULT_PUNCT_DELAY = 0.15;
+var 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 };
+}
+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;
+  }
+}
+function completeTextReveal(state) {
+  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;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  completeTextReveal,
+  createDialogueGraph,
+  createDialogueRunner,
+  createTextReveal,
+  getNode,
+  interpolate,
+  resetTextReveal,
+  updateTextReveal
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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":[]}

package/dist/index.mjs

@@ -0,0 +1,223 @@
+// src/graph.ts
+function createDialogueGraph(id, start, nodes) {
+  return { id, start, nodes };
+}
+function getNode(graph, nodeId) {
+  return graph.nodes[nodeId];
+}
+
+// src/runner.ts
+import { Signal } from "@flare-engine/events";
+function interpolate(template, vars) {
+  return template.replace(/\{(\w+)\}/g, (_match, key) => {
+    const val = vars[key];
+    return val !== void 0 ? String(val) : `{${key}}`;
+  });
+}
+function createDialogueRunner(options) {
+  const onLine = new Signal();
+  const onChoice = new Signal();
+  const onAction = new Signal();
+  const onEnd = new 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;
+}
+
+// src/text-reveal.ts
+var DEFAULT_SPEED = 30;
+var DEFAULT_PUNCT_DELAY = 0.15;
+var 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 };
+}
+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;
+  }
+}
+function completeTextReveal(state) {
+  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;
+}
+export {
+  completeTextReveal,
+  createDialogueGraph,
+  createDialogueRunner,
+  createTextReveal,
+  getNode,
+  interpolate,
+  resetTextReveal,
+  updateTextReveal
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"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 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":[]}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@flare-engine/dialogue",
+  "version": "0.1.0",
+  "description": "Dialogue graph runtime — lines, choices, conditions, variables, text-over-time reveal",
+  "keywords": ["flare-engine", "dialogue", "narrative", "branching", "rpg"],
+  "license": "MIT",
+  "author": "Grzegorz Otto",
+  "homepage": "https://github.com/grzott/flare-engine#readme",
+  "bugs": {
+    "url": "https://github.com/grzott/flare-engine/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/grzott/flare-engine.git",
+    "directory": "packages/dialogue"
+  },
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": ["dist", "README.md", "LICENSE"],
+  "scripts": {
+    "build": "tsup",
+    "test": "bun test",
+    "lint": "biome check src/",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@flare-engine/events": "^0.1.0"
+  },
+  "publishConfig": {
+    "access": "restricted",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "sideEffects": false
+}