dialogue

@motioneffector/dialogue

A lightweight, type-safe branching dialogue system for games and interactive fiction.

Features

Branching Dialogue Trees - Complex conversation flows with multiple paths
Conditional Logic - Show or hide choices based on flags
Flag System - Game-wide and conversation-specific state tracking
Action System - Execute callbacks and modify flags on events
Text Interpolation - Dynamic text replacement from flags or functions
State Management - History tracking, undo, save and restore
Event Hooks - React to node transitions and choice selection
I18n Support - Built-in internationalization adapter interface
Validation - Comprehensive dialogue structure checking

Quick Start

import { createDialogueRunner } from '@motioneffector/dialogue'

const dialogue = {
  id: 'greeting',
  startNode: 'start',
  nodes: {
    start: {
      text: 'Hello! How can I help you?',
      choices: [
        { text: 'Tell me more', next: 'about' },
        { text: 'Goodbye', next: 'end' }
      ]
    },
    about: { text: 'I am a dialogue system.', next: 'start' },
    end: { text: 'Farewell!', isEnd: true }
  }
}

const runner = createDialogueRunner()
runner.start(dialogue)
runner.choose(0) // Select first choice

Testing & Validation

Comprehensive test suite - 255 unit tests covering core functionality
Fuzz tested - Randomized input testing to catch edge cases
Strict TypeScript - Full type coverage with no any types
Zero dependencies - No supply chain risk

License

This site is open source. Improve this page.