Method preload

src/monogatari.ts:1511–1698

* Preload game assets

()

   * Preload game assets
   */
  static preload () {
    // Check if asset preloading is enabled. Preloading will not be done in
    // electron or cordova since the assets are expected to be available
    // locally.
    const preloadEnabled = this.setting ('Preload') && !Platform.desktopApp && !Platform.cordova && location.protocol.indexOf ('file') < 0;

    if (!preloadEnabled) {
      return Promise.resolve ();
    }

    const promises: Promise<void>[] = [];

    this.trigger('willPreloadAssets');

    const assetsPath = this.setting('AssetsPath');

    // Check if Preload action has a 'default' block configured
    const preloadAction = this.action('Preload') as typeof PreloadAction | undefined;
    const blocks = preloadAction?.blocks?.();
    const defaultBlock = blocks?.['default'];

    if (defaultBlock && preloadAction) {
      // Use the registry-based preloading for the 'default' block
      for (const [category, assets] of Object.entries(defaultBlock)) {
        // Handle characters separately (nested structure)
        if (category === 'characters' && typeof assets === 'object' && !Array.isArray(assets)) {
          for (const [charId, sprites] of Object.entries(assets as Record<string, string[]>)) {
            const character = this.character(charId);
            if (!character) continue;

            let directory = character.directory ? `${character.directory}/` : '';
            directory = `${assetsPath.root}/${assetsPath.characters}/${directory}`;

            for (const spriteName of sprites) {
              const spriteFile = character.sprites?.[spriteName];
              if (!spriteFile || typeof spriteFile !== 'string') continue;

              const url = `${directory}${spriteFile}`;
              promises.push(
                Preload.image(url).then((img) => {
                  this.imageCache(`characters/${charId}/${spriteName}`, img);
                  this.trigger('assetLoaded', { name: spriteName, type: 'image', category: 'characters' });
                })
              );
              this.trigger('assetQueued');
            }
          }
          continue;
        }

        if (!Array.isArray(assets)) continue;

        // Use the Preload action's registry to determine how to load this category
        const loaderType = preloadAction.getLoaderType(category);
        if (!loaderType) {
          console.warn(`Preload: No loader registered for category "${category}" in default block`);
          continue;
        }