Class Monogatari

src/monogatari.ts:158–2495

* Every Monogatari Game is composed mainly of the following items: * * Actions: The list of capabilities a Monogatari script can run. * * Components: The list of screens and other HTML elements available in the game. * * State: The current state of the game, this simple object contains the cur

 *
 */
class Monogatari {

  /**
   * Returns the class typed as VisualNovelEngine.
   * This enables type-safe access while allowing external users to extend
   * the VisualNovelEngine interface via declaration merging.
   *
   * @internal
   */
  private static asEngine(): VisualNovelEngine {
    return this as unknown as VisualNovelEngine;
  }

  static _languageMetadata: Record<string, { code: string; icon: string }> = {};
  static _events: Record<string, unknown> = {};

  static _selector = '#monogatari';

  static _actions: StaticAction[] = [];
  static _components: StaticComponent[] = [];
  static _translations: Record<string, Record<string, string>> = {};
  static _script: Record<string, unknown> = {};
  static _characters: Record<string, Character> = {};
  static _storage: Record<string, unknown> = {};

  // Web Audio API context for audio playback with effects
  static audioContext: AudioContext | undefined;

  // Asset caches for decoded audio and images
  static _audioBufferCache: Map<string, AudioBuffer> = new Map();
  static _imageCache: Map<string, HTMLImageElement> = new Map();

  // Persistent audio buffer storage
  static _audioBufferSpace: Space | null = null;

  // Save screenshot storage (IndexedDB, out-of-line keys; holds raw Blobs)
  static _screenshotSpace: Space | null = null;

  // Track IndexedDB availability: null = not checked, true = available, false = unavailable
  static _indexedDBAvailable: boolean | null = null;

  // Whether the developer has overridden the default onSaveScreenshot callback
  static _hasCustomSaveScreenshot = false;

  // Screenshot of the game screen captured when the save screen is opened, before
  // the game screen is hidden. Consumed by saveTo() for manual-save thumbnails.
  static _pendingScreenshot: Promise<Blob | null> | null = null;

  static Storage: StorageInterface = new Space () as unknown as StorageInterface;

  // Read a stored screenshot Blob into a data-URL string for display.
  private static _blobToDataURL (blob: Blob): Promise<string> {
    return new Promise ((resolve, reject) => {
      const reader = new FileReader ();
      reader.onload = () => resolve (reader.result as string);
      reader.onerror = () => reject (reader.error ?? new Error ('Failed to read screenshot blob'));
      reader.readAsDataURL (blob);
    });