melonjs 20.2.0 → 20.4.0

package/build/audio/backend.d.ts

@@ -1,140 +0,0 @@
-/**
- * Audio backend — the shared internal surface every other audio module
- * (procedural, playback) builds on. Keeps the Howler reference and the
- * cross-module mutable state in one place so the public surface modules
- * stay backend-agnostic.
- *
- * Not part of the public `me.audio.*` API — the two getters
- * `getAudioContext` / `getMasterGain` are re-exported from `audio.ts`
- * for end users; everything else (the `state` object, `soundLoadError`)
- * is internal.
- */
-import { Howl } from "howler";
-/**
- * Whether to stop on an audio loading error.
- *
- * When `true`, melonJS throws an exception and aborts loading.
- * When `false`, melonJS disables sound and logs a warning to the console.
- *
- * Read-only through the `me.audio` namespace (module namespace properties
- * can't be assigned) — change it with {@link setStopOnAudioError}.
- * @default true
- * @see setStopOnAudioError
- */
-export declare let stopOnAudioError: boolean;
-/**
- * Set the {@link stopOnAudioError} flag — whether an audio clip that still
- * fails after its retries throws (aborting loading) or just disables sound
- * with a console warning. This setter is the supported way to change the
- * flag: assigning `me.audio.stopOnAudioError = false` directly throws a
- * TypeError, because module namespace properties are read-only.
- * @param value - `true` to throw on a failed load, `false` to disable sound instead
- * @example
- * // don't abort the whole game when audio fails to load
- * me.audio.setStopOnAudioError(false);
- * @category Audio
- */
-export declare function setStopOnAudioError(value: boolean): void;
-/**
- * Cross-module mutable state. A single object so multiple consumers
- * can read and mutate the same fields without the "ESM `let` exports
- * don't share writes across modules" footgun.
- *
- * Fields:
- * - `tracks` — loaded Howl instances keyed by logical sound name.
- *   `Howl | undefined` because missing keys return undefined at runtime
- *   even though the type signature wouldn't normally admit it.
- * - `currentTrackId` — the name of the currently-playing track managed
- *   by the `playTrack` / `stopTrack` helpers.
- * - `retryCounters` — per-sound retry counters for `soundLoadError`'s
- *   back-off, keyed by sound name (a single shared counter let parallel
- *   loads steal each other's retry budget).
- * - `audioExts` — the active list of audio formats set by `init`.
- * @ignore
- */
-export declare const state: {
-    tracks: Record<string, Howl | undefined>;
-    currentTrackId: string | null;
-    retryCounters: Record<string, number>;
-    audioExts: string[];
-};
-/**
- * Look up a loaded `Howl` instance by logical name, or throw a
- * uniform "audio clip X does not exist" error if it isn't loaded.
- * Used by every per-clip helper across `playback.ts` / `audio.ts` so
- * the error contract stays identical across the whole surface.
- * @ignore
- */
-export declare function getSoundOrThrow(sound_name: string): Howl;
-/**
- * Event listener callback on load error. Retries the load up to 3
- * times, then either throws or disables audio (depending on the
- * `stopOnAudioError` flag re-exported from `audio.ts`).
- * @ignore
- */
-export declare const soundLoadError: (sound_name: string, onerror_cb?: () => void, stopOnError?: boolean) => void;
-/**
- * Returns the underlying WebAudio `AudioContext` used by the audio
- * module (the same one shared with file-based playback), or `null` if
- * audio is disabled or no compatible WebAudio implementation is
- * available.
- *
- * Use this when you need to build a custom WebAudio graph — procedural
- * SFX, custom filters / spatial nodes, audio analysis — without
- * spawning a second context. Browsers throttle or refuse multiple
- * `AudioContext` instances on the same page and each has its own
- * suspend-until-gesture state, so sharing matters.
- *
- * The context is lazily created on first access; the call also returns
- * the cached instance on every subsequent call.
- * @category Audio
- */
-export declare function getAudioContext(): AudioContext | null;
-/**
- * Return the audio module's master gain node — the single `GainNode`
- * every playback path runs through on its way to `ctx.destination`,
- * and the lever that {@link setVolume} / {@link muteAll} manipulate.
- *
- * Connect to this node (instead of `ctx.destination`) whenever you
- * build a custom WebAudio graph and want the result to respect the
- * engine's mute / volume state. Returns `null` when audio is disabled
- * or unavailable.
- * @category Audio
- */
-export declare function getMasterGain(): GainNode | null;
-/**
- * Get the audio module's global volume.
- * @ignore
- */
-export declare function getGlobalVolume(): number;
-/**
- * Set the audio module's global volume.
- * @ignore
- */
-export declare function setGlobalVolume(v: number): void;
-/**
- * Mute or unmute the audio module globally.
- * @ignore
- */
-export declare function setGlobalMuted(muted: boolean): void;
-/**
- * Whether the audio module is currently muted globally.
- * @ignore
- */
-export declare function isGlobalMuted(): boolean;
-/**
- * Stop every playing sound on every channel.
- * @ignore
- */
-export declare function stopAllPlayback(): void;
-/**
- * Whether the given audio codec is supported by the backend / browser.
- * @ignore
- */
-export declare function hasCodec(codec: string): boolean;
-/**
- * Whether at least one audio backend (HTML5 or WebAudio) is available.
- * @ignore
- */
-export declare function isAudioAvailable(): boolean;
-//# sourceMappingURL=backend.d.ts.map

package/build/audio/backend.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/audio/backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,IAAI,EAAU,MAAM,QAAQ,CAAC;AAEtC;;;;;;;;;;GAUG;AACH,eAAO,IAAI,gBAAgB,EAAE,OAAc,CAAC;AAE5C;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAExD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,KAAK;YACH,MAAM,CAAC,MAAM,EAAE,IAAI,GAAG,SAAS,CAAC;oBACtB,MAAM,GAAG,IAAI;mBAChB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;eAC1B,MAAM,EAAE;CACzB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAMxD;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAC1B,YAAY,MAAM,EAClB,aAAa,MAAM,IAAI,EACvB,cAAa,OAAc,KACzB,IAqBF,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,IAAI,YAAY,GAAG,IAAI,CAmBrD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,IAAI,QAAQ,GAAG,IAAI,CAS/C;AAUD;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAE/C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAEnD;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAKvC;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAO/C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C"}

package/build/loader/parsers/fetchdata.d.ts

@@ -1,32 +0,0 @@
-/**
- * Whether `url` must be loaded over the `file:` scheme — either an absolute
- * `file://` URL, or a relative URL resolved against a `file:` document (the
- * case for a Cordova/Capacitor build packaged into an APK, where the app runs
- * from `file://`). `fetch()` cannot load such URLs in several WebView contexts
- * (it rejects with an opaque network error), whereas `XMLHttpRequest` can. The
- * document `protocol` is injectable so the relative-URL branch is unit-testable
- * (`location` is non-configurable in a real browser).
- * @param {string} url
- * @param {string} [protocol] - the hosting document's protocol
- * @returns {boolean}
- * @ignore
- */
-export function isFileProtocol(url: string, protocol?: string): boolean;
-/**
- * Fetches data from the specified URL.
- * @param {string} url - The URL to fetch the data from.
- * @param {string} responseType - The type of response expected ('json', 'text', 'blob', 'arrayBuffer').
- * @param {Object} [settings] - custom settings to apply to the request (@link https://developer.mozilla.org/en-US/docs/Web/API/fetch#options)
- * @returns {Promise} A promise that resolves with the fetched data or rejects with an error.
- * @ignore
- * @example
- * fetchData('https://api.example.com/data', 'json')
- *     .then(data => {
- *         // Handle the fetched JSON data
- *     })
- *     .catch(error => {
- *         // Handle the error
- *     });
- */
-export function fetchData(url: string, responseType: string, settings?: Object): Promise<any>;
-//# sourceMappingURL=fetchdata.d.ts.map

package/build/loader/parsers/fetchdata.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fetchdata.d.ts","sourceRoot":"","sources":["../../../src/loader/parsers/fetchdata.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,oCALW,MAAM,aACN,MAAM,GACJ,OAAO,CAKnB;AA2DD;;;;;;;;;;;;;;;GAeG;AACH,+BAdW,MAAM,gBACN,MAAM,aACN,MAAM,gBAkDhB"}