NarrativeEngine class

NarrativeEngine - Core processor for in-game sentence execution

This class is responsible for executing in-game sentences one by one, enabling narration, player interaction, and navigation control.

It uses a ListQueue to manage upcoming sentences and exposes processed ones through callbacks for display. Each sentence is delegated to a NarrativeInterpreter for instruction parsing.

Key Responsibilities:

• Manage sentence queue (enqueue, process, clear)
• Control execution flow (pause, resume, cancel, complete)
• Support external stream listeners for engine status updates
• Integrate blocking flow (e.g., wait for user tap)
• Deduplicate writing using external SafeNarrativeWriter

Usage Example:

final engine = NarrativeEngine(
  onStatusChange: (status) => print('Status: $status'),
  onSentencesChanged: (sentences) => setState(() {}),
);
engine.registerInterpreter(myInterpreter);
engine.enqueue(sentences);
engine.process(onComplete: () => print("Done"));