Method setup

src/actions/Preload.ts:67–142

* Setup default loaders for built-in asset types. * Runs during setup() phase to ensure loaders are available before scripts execute.

()

	 * Runs during setup() phase to ensure loaders are available before scripts execute.
	 */
	static override async setup(): Promise<void> {
		// Register default audio loader with IndexedDB persistence
		if (!this._loaders.has('audio')) {
			this.registerLoader('audio', {
				loader: async (url: string, eng: VisualNovelEngine) => {
					// Try to load from IndexedDB first (fast path - no network, no decode)
					const cacheKey = url; // URL is used as key for persistent storage
					const persistedBuffer = await eng.getAudioBufferPersistent(cacheKey);
					if (persistedBuffer) {
						return persistedBuffer;
					}

					// Not in IndexedDB, fetch and decode from network
					const buffer = await ArtemisPreload.audio(url, eng.audioContext);

					// Store in IndexedDB for future sessions (async, don't wait)
					eng.storeAudioBufferPersistent(cacheKey, buffer).catch(() => {
						// Silently ignore storage failures
					});

					return buffer;
				},
				cache: {
					get: (eng: VisualNovelEngine, key: string) => eng.audioBufferCache(key),
					set: (eng: VisualNovelEngine, key: string, value: AudioBuffer) => eng.audioBufferCache(key, value),
					delete: (eng: VisualNovelEngine, key: string) => eng.audioBufferUncache(key),
					clear: (eng: VisualNovelEngine, prefix: string) => eng.audioBufferClearCache(prefix),
				}
			});
		}

		// Register default image loader
		if (!this._loaders.has('image')) {
			this.registerLoader('image', {
				loader: async (url: string) => {
					return ArtemisPreload.image(url);
				},
				cache: {
					get: (eng: VisualNovelEngine, key: string) => eng.imageCache(key),
					set: (eng: VisualNovelEngine, key: string, value: HTMLImageElement) => eng.imageCache(key, value),
					delete: (eng: VisualNovelEngine, key: string) => eng.imageUncache(key),
					clear: (eng: VisualNovelEngine, prefix: string) => eng.imageClearCache(prefix),
				}
			});
		}

		// Register default category mappings (using plural names as assets are registered)
		const defaultAudioCategories = ['music', 'sounds', 'voices'];
		const defaultImageCategories = ['scenes', 'images', 'characters'];

		for (const category of defaultAudioCategories) {
			if (!this._categoryLoaderMap.has(category)) {
				this.registerCategory(category, 'audio');
			}
		}

		for (const category of defaultImageCategories) {
			if (!this._categoryLoaderMap.has(category)) {