@datamoc/mw_games 0.44.2 → 0.46.0

package/dist/audio/DecoderGuard.js

@@ -1,208 +0,0 @@
-/**
- * The decoder limits every guard starts from, before a caller raises or lowers one.
- *
- * @example
- * ```ts
- * import { DEFAULT_DECODER_LIMITS } from '@datamoc/mw_games/audio';
- *
- * console.log(DEFAULT_DECODER_LIMITS.maxInputBytes); // 16777216
- * ```
- */
-export const DEFAULT_DECODER_LIMITS = Object.freeze({
-    maxInputBytes: 16 * 1024 * 1024,
-    maxOutputBytes: 64 * 1024 * 1024,
-    maxInstructionsPerSecond: 4_000_000,
-    maxSeconds: 3600,
-    maxRealtimeRatio: 1,
-    maxStarvedReads: 8,
-});
-/**
- * A decoder went past a limit; carries the limit's name so a game can say what to raise or
- * what to refuse.
- *
- * @example
- * ```ts
- * import { DecodeBudgetError } from '@datamoc/mw_games/audio';
- *
- * const error = new DecodeBudgetError('maxInputBytes', 'tune.nsf is larger than the limit');
- * console.log(error.limit); // 'maxInputBytes'
- * ```
- */
-export class DecodeBudgetError extends Error {
-    constructor(limit, message) {
-        super(message);
-        this.name = 'DecodeBudgetError';
-        this.limit = limit;
-    }
-}
-/**
- * Merges a partial override over the defaults and rejects values that cannot be limits.
- *
- * @example
- * ```ts
- * import { decoderLimits } from '@datamoc/mw_games/audio';
- *
- * console.log(decoderLimits({ maxSeconds: 600 }).maxSeconds); // 600
- * ```
- */
-export function decoderLimits(overrides = {}) {
-    const limits = { ...DEFAULT_DECODER_LIMITS, ...overrides };
-    for (const [name, value] of Object.entries(limits)) {
-        if (!(value > 0))
-            throw new Error(`decoder limit ${name} must be positive`);
-    }
-    return limits;
-}
-/**
- * Throws when input is bigger than `maxInputBytes`, before a decoder has touched it.
- *
- * @example
- * ```ts
- * import { assertInputSize } from '@datamoc/mw_games/audio';
- *
- * declare const bytes: Uint8Array;
- *
- * assertInputSize(bytes, { maxInputBytes: 1_000_000 }, 'tune.nsf');
- * ```
- */
-export function assertInputSize(input, limits = {}, label = 'input') {
-    const { maxInputBytes } = decoderLimits(limits);
-    if (input.byteLength > maxInputBytes) {
-        throw new DecodeBudgetError('maxInputBytes', `${label} is ${input.byteLength} bytes, over the ${maxInputBytes} byte limit`);
-    }
-}
-/**
- * A count of emulated instructions an emulator spends as it runs. The emulator calls `spend`
- * from its dispatch loop (once per instruction, or once per batch); past the allowance it
- * throws, so a tune that loops forever without producing sound ends the render instead of
- * hanging it.
- *
- * @example
- * ```ts
- * import { InstructionBudget } from '@datamoc/mw_games/audio';
- *
- * const budget = InstructionBudget.forSeconds(30);
- * function runFrame(cycles: number): void {
- * 	budget.spend(cycles);
- * }
- * runFrame(20000);
- * console.log(budget.remaining);
- * ```
- */
-export class InstructionBudget {
-    constructor(allowance) {
-        if (!(allowance > 0))
-            throw new Error('instruction allowance must be positive');
-        this.left = allowance;
-    }
-    /** the allowance for rendering this many seconds of sound under the limits' per-second rate */
-    static forSeconds(seconds, limits = {}) {
-        const { maxInstructionsPerSecond } = decoderLimits(limits);
-        return new InstructionBudget(Math.max(1, Math.ceil(seconds * maxInstructionsPerSecond)));
-    }
-    get remaining() {
-        return this.left;
-    }
-    spend(count = 1) {
-        this.left -= count;
-        if (this.left < 0) {
-            throw new DecodeBudgetError('maxInstructionsPerSecond', 'the emulated program ran past its instruction budget');
-        }
-    }
-}
-/**
- * Inflates a raw DEFLATE stream while counting the output, so a few kilobytes that expand into
- * gigabytes are refused after `maxOutputBytes`, not after they have filled memory.
- *
- * @example
- * ```ts
- * import { inflateBounded } from '@datamoc/mw_games/audio';
- *
- * declare const packed: Uint8Array;
- *
- * const bytes = await inflateBounded(packed, { maxOutputBytes: 1_000_000 });
- * ```
- */
-export async function inflateBounded(packed, limits = {}, format = 'deflate-raw') {
-    const { maxOutputBytes } = decoderLimits(limits);
-    const stream = new Blob([packed]).stream().pipeThrough(new DecompressionStream(format));
-    const reader = stream.getReader();
-    const chunks = [];
-    let total = 0;
-    for (;;) {
-        const { done, value } = await reader.read();
-        if (done)
-            break;
-        total += value.byteLength;
-        if (total > maxOutputBytes) {
-            await reader.cancel();
-            throw new DecodeBudgetError('maxOutputBytes', `inflated data passed the ${maxOutputBytes} byte limit`);
-        }
-        chunks.push(value);
-    }
-    const out = new Uint8Array(total);
-    let offset = 0;
-    for (const chunk of chunks) {
-        out.set(chunk, offset);
-        offset += chunk.byteLength;
-    }
-    return out;
-}
-/**
- * Wraps a `BlockSource` so a misbehaving decoder cannot hurt the game: a read that claims more
- * frames than it was given room for is an error, non-finite or wildly loud samples are zeroed
- * or clamped, the stream ends at `maxSeconds` whatever the file says, and a source that keeps
- * taking longer to produce audio than the audio lasts is cut after `maxStarvedReads` in a row
- * rather than being allowed to starve the page.
- *
- * @example
- * ```ts
- * import { guardBlockSource, type BlockSource } from '@datamoc/mw_games/audio';
- *
- * declare const untrusted: BlockSource;
- *
- * const safe = guardBlockSource(untrusted, { maxSeconds: 600 });
- * ```
- */
-export function guardBlockSource(source, overrides = {}, options = {}) {
-    const limits = decoderLimits(overrides);
-    const now = options.now ?? (() => performance.now());
-    const maxFrames = Math.floor(limits.maxSeconds * source.sampleRate);
-    let produced = 0;
-    let starved = 0;
-    return {
-        sampleRate: source.sampleRate,
-        get length() {
-            return source.length === undefined ? undefined : Math.min(source.length, maxFrames);
-        },
-        read(left, right, start, count) {
-            const allowed = Math.min(count, Math.max(0, maxFrames - produced));
-            if (allowed === 0)
-                return 0;
-            const before = now();
-            const got = source.read(left, right, start, allowed);
-            const elapsedMs = now() - before;
-            if (!(got >= 0) || got > allowed) {
-                throw new DecodeBudgetError('maxOutputBytes', `a source returned ${got} frames for a request of ${allowed}`);
-            }
-            for (let i = start; i < start + got; i++) {
-                const l = left[i];
-                const r = right[i];
-                left[i] = Number.isFinite(l) ? Math.max(-4, Math.min(4, l)) : 0;
-                right[i] = Number.isFinite(r) ? Math.max(-4, Math.min(4, r)) : 0;
-            }
-            produced += got;
-            const audioMs = (got / source.sampleRate) * 1000;
-            starved = got > 0 && elapsedMs > audioMs * limits.maxRealtimeRatio ? starved + 1 : 0;
-            if (starved >= limits.maxStarvedReads) {
-                throw new DecodeBudgetError('maxRealtimeRatio', `a source took longer than real time to render ${starved} reads in a row`);
-            }
-            return got;
-        },
-        seek(frame) {
-            source.seek(frame);
-            produced = Math.min(frame, maxFrames);
-        },
-    };
-}
-//# sourceMappingURL=DecoderGuard.js.map

package/dist/audio/DecoderGuard.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"DecoderGuard.js","sourceRoot":"","sources":["../../src/audio/DecoderGuard.ts"],"names":[],"mappings":"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"}

package/dist/audio/Fft.d.ts

@@ -1,3 +0,0 @@
-/** in-place iterative radix-2 FFT; `real` and `imaginary` must be a power of two long */
-export declare function fft(real: Float64Array, imaginary: Float64Array): void;
-//# sourceMappingURL=Fft.d.ts.map

package/dist/audio/Fft.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Fft.d.ts","sourceRoot":"","sources":["../../src/audio/Fft.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,wBAAgB,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,GAAG,IAAI,CA6CrE"}

package/dist/audio/Fft.js

@@ -1,45 +0,0 @@
-/** in-place iterative radix-2 FFT; `real` and `imaginary` must be a power of two long */
-export function fft(real, imaginary) {
-    const length = real.length;
-    let j = 0;
-    for (let i = 1; i < length; i++) {
-        let bit = length >> 1;
-        while (j & bit) {
-            j ^= bit;
-            bit >>= 1;
-        }
-        j ^= bit;
-        if (i < j) {
-            let swap = real[i];
-            real[i] = real[j];
-            real[j] = swap;
-            swap = imaginary[i];
-            imaginary[i] = imaginary[j];
-            imaginary[j] = swap;
-        }
-    }
-    for (let size = 2; size <= length; size <<= 1) {
-        const angle = (-2 * Math.PI) / size;
-        const stepReal = Math.cos(angle);
-        const stepImaginary = Math.sin(angle);
-        const half = size >> 1;
-        for (let start = 0; start < length; start += size) {
-            let weightReal = 1;
-            let weightImaginary = 0;
-            for (let k = 0; k < half; k++) {
-                const even = start + k;
-                const odd = even + half;
-                const oddReal = real[odd] * weightReal - imaginary[odd] * weightImaginary;
-                const oddImaginary = real[odd] * weightImaginary + imaginary[odd] * weightReal;
-                real[odd] = real[even] - oddReal;
-                imaginary[odd] = imaginary[even] - oddImaginary;
-                real[even] += oddReal;
-                imaginary[even] += oddImaginary;
-                const nextReal = weightReal * stepReal - weightImaginary * stepImaginary;
-                weightImaginary = weightReal * stepImaginary + weightImaginary * stepReal;
-                weightReal = nextReal;
-            }
-        }
-    }
-}
-//# sourceMappingURL=Fft.js.map

package/dist/audio/Fft.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Fft.js","sourceRoot":"","sources":["../../src/audio/Fft.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,MAAM,UAAU,GAAG,CAAC,IAAkB,EAAE,SAAuB;IAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAE3B,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACjC,IAAI,GAAG,GAAG,MAAM,IAAI,CAAC,CAAC;QACtB,OAAO,CAAC,GAAG,GAAG,EAAE,CAAC;YAChB,CAAC,IAAI,GAAG,CAAC;YACT,GAAG,KAAK,CAAC,CAAC;QACX,CAAC;QACD,CAAC,IAAI,GAAG,CAAC;QACT,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACX,IAAI,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACnB,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;YACf,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YACpB,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YAC5B,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;QACrB,CAAC;IACF,CAAC;IAED,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,MAAM,EAAE,IAAI,KAAK,CAAC,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC;QACvB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,EAAE,KAAK,IAAI,IAAI,EAAE,CAAC;YACnD,IAAI,UAAU,GAAG,CAAC,CAAC;YACnB,IAAI,eAAe,GAAG,CAAC,CAAC;YACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC/B,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC;gBACvB,MAAM,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;gBACxB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC;gBAC1E,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,eAAe,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;gBAC/E,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;gBACjC,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC;gBAChD,IAAI,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC;gBACtB,SAAS,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC;gBAEhC,MAAM,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,eAAe,GAAG,aAAa,CAAC;gBACzE,eAAe,GAAG,UAAU,GAAG,aAAa,GAAG,eAAe,GAAG,QAAQ,CAAC;gBAC1E,UAAU,GAAG,QAAQ,CAAC;YACvB,CAAC;QACF,CAAC;IACF,CAAC;AACF,CAAC"}

package/dist/audio/LoopTags.d.ts

@@ -1,55 +0,0 @@
-import type { LoopRegion } from './Channels.ts';
-/** loop points a Vorbis file declares, in samples */
-export interface VorbisLoopTags {
-    loopStart: number;
-    /** null when the file names a start but no length: the loop runs to the end */
-    loopLength: number | null;
-}
-/**
- * Reads the `LOOPSTART` and `LOOPLENGTH` comments (samples) that RPG-style Ogg Vorbis
- * music carries, or null when the file names no loop. Walks the Ogg pages to the Vorbis
- * comment packet rather than scanning for text, and never reads past the first 64 KiB, so
- * a hostile file costs a bounded, quick scan. Malformed input returns null, never throws.
- *
- * @example
- * ```ts
- * import { parseVorbisLoopTags } from '@datamoc/mw_games/audio';
- *
- * declare const oggBytes: Uint8Array;
- *
- * console.log(parseVorbisLoopTags(oggBytes)); // { loopStart, loopLength } or null
- * ```
- */
-export declare function parseVorbisLoopTags(bytes: Uint8Array): VorbisLoopTags | null;
-/**
- * The loop region in seconds for decoded audio, from a file's declared tags: the start,
- * and the start plus the length (or the end of the buffer when no length is declared).
- * Null when the tags name no usable region inside the buffer.
- *
- * @example
- * ```ts
- * import { loopRegionFromTags } from '@datamoc/mw_games/audio';
- *
- * console.log(loopRegionFromTags({ loopStart: 44100, loopLength: 44100 }, 44100, 10)); // { start: 1, end: 2 }
- * ```
- */
-export declare function loopRegionFromTags(tags: VorbisLoopTags | null, sampleRate: number, duration: number): LoopRegion | null;
-/**
- * The loop region a track's own file declares, as the default when the game gives none: the
- * region from `loopStartSeconds` to the end (or to `loopEndSeconds` when the file has one),
- * null when the file declares no loop or the declaration falls outside the track. Retro formats
- * such as MWA carry their loop point this way, so a game need not repeat it.
- *
- * @example
- * ```ts
- * import { loopRegionFromFile } from '@datamoc/mw_games/audio';
- *
- * console.log(loopRegionFromFile({ loopStartSeconds: 8, durationSeconds: 60 })); // { start: 8, end: 60 }
- * ```
- */
-export declare function loopRegionFromFile(file: {
-    loopStartSeconds?: number | null;
-    loopEndSeconds?: number | null;
-    durationSeconds: number;
-}): LoopRegion | null;
-//# sourceMappingURL=LoopTags.d.ts.map

package/dist/audio/LoopTags.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"LoopTags.d.ts","sourceRoot":"","sources":["../../src/audio/LoopTags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAKD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc,GAAG,IAAI,CAmC5E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CACjC,IAAI,EAAE,cAAc,GAAG,IAAI,EAC3B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACd,UAAU,GAAG,IAAI,CAKnB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACxC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,eAAe,EAAE,MAAM,CAAC;CACxB,GAAG,UAAU,GAAG,IAAI,CAKpB"}

package/dist/audio/LoopTags.js

@@ -1,136 +0,0 @@
-//The comment header sits in the first pages of a file; scanning further would only read audio.
-const SCAN_LIMIT = 64 * 1024;
-/**
- * Reads the `LOOPSTART` and `LOOPLENGTH` comments (samples) that RPG-style Ogg Vorbis
- * music carries, or null when the file names no loop. Walks the Ogg pages to the Vorbis
- * comment packet rather than scanning for text, and never reads past the first 64 KiB, so
- * a hostile file costs a bounded, quick scan. Malformed input returns null, never throws.
- *
- * @example
- * ```ts
- * import { parseVorbisLoopTags } from '@datamoc/mw_games/audio';
- *
- * declare const oggBytes: Uint8Array;
- *
- * console.log(parseVorbisLoopTags(oggBytes)); // { loopStart, loopLength } or null
- * ```
- */
-export function parseVorbisLoopTags(bytes) {
-    const data = bytes.subarray(0, SCAN_LIMIT);
-    const comment = findCommentPacket(data);
-    if (!comment)
-        return null;
-    const view = new DataView(comment.buffer, comment.byteOffset, comment.byteLength);
-    const decoder = new TextDecoder('utf-8');
-    let at = 7; //packet type 3 plus "vorbis"
-    const readLength = () => {
-        if (at + 4 > comment.length)
-            return null;
-        const value = view.getUint32(at, true);
-        at += 4;
-        return at + value <= comment.length ? value : null;
-    };
-    const vendor = readLength();
-    if (vendor === null)
-        return null;
-    at += vendor;
-    if (at + 4 > comment.length)
-        return null;
-    const count = view.getUint32(at, true);
-    at += 4;
-    let start = null;
-    let length = null;
-    for (let index = 0; index < count; index++) {
-        const size = readLength();
-        if (size === null)
-            break;
-        const text = decoder.decode(comment.subarray(at, at + size));
-        at += size;
-        const separator = text.indexOf('=');
-        if (separator < 0)
-            continue;
-        const key = text.slice(0, separator).toUpperCase();
-        const value = /^\d+$/.test(text.slice(separator + 1)) ? Number(text.slice(separator + 1)) : null;
-        if (value === null)
-            continue;
-        if (key === 'LOOPSTART')
-            start = value;
-        else if (key === 'LOOPLENGTH')
-            length = value;
-    }
-    return start === null ? null : { loopStart: start, loopLength: length };
-}
-/**
- * The loop region in seconds for decoded audio, from a file's declared tags: the start,
- * and the start plus the length (or the end of the buffer when no length is declared).
- * Null when the tags name no usable region inside the buffer.
- *
- * @example
- * ```ts
- * import { loopRegionFromTags } from '@datamoc/mw_games/audio';
- *
- * console.log(loopRegionFromTags({ loopStart: 44100, loopLength: 44100 }, 44100, 10)); // { start: 1, end: 2 }
- * ```
- */
-export function loopRegionFromTags(tags, sampleRate, duration) {
-    if (!tags || !(sampleRate > 0))
-        return null;
-    const start = tags.loopStart / sampleRate;
-    const end = tags.loopLength ? (tags.loopStart + tags.loopLength) / sampleRate : duration;
-    return start >= 0 && end > start && start < duration ? { start, end: Math.min(end, duration) } : null;
-}
-/**
- * The loop region a track's own file declares, as the default when the game gives none: the
- * region from `loopStartSeconds` to the end (or to `loopEndSeconds` when the file has one),
- * null when the file declares no loop or the declaration falls outside the track. Retro formats
- * such as MWA carry their loop point this way, so a game need not repeat it.
- *
- * @example
- * ```ts
- * import { loopRegionFromFile } from '@datamoc/mw_games/audio';
- *
- * console.log(loopRegionFromFile({ loopStartSeconds: 8, durationSeconds: 60 })); // { start: 8, end: 60 }
- * ```
- */
-export function loopRegionFromFile(file) {
-    const start = file.loopStartSeconds;
-    if (start === undefined || start === null || !(start >= 0))
-        return null;
-    const end = Math.min(file.loopEndSeconds ?? file.durationSeconds, file.durationSeconds);
-    return end > start && start < file.durationSeconds ? { start, end } : null;
-}
-/** the first packet starting with the Vorbis comment marker, reassembled across Ogg pages */
-function findCommentPacket(data) {
-    const marker = [3, 0x76, 0x6f, 0x72, 0x62, 0x69, 0x73];
-    let packet = [];
-    let offset = 0;
-    while (offset + 27 <= data.length) {
-        if (data[offset] !== 0x4f ||
-            data[offset + 1] !== 0x67 ||
-            data[offset + 2] !== 0x67 ||
-            data[offset + 3] !== 0x53) {
-            return null;
-        }
-        const segments = data[offset + 26];
-        const tableEnd = offset + 27 + segments;
-        if (tableEnd > data.length)
-            return null;
-        let body = tableEnd;
-        for (let index = 0; index < segments; index++) {
-            const size = data[offset + 27 + index];
-            if (body + size > data.length)
-                return null;
-            for (let i = 0; i < size; i++)
-                packet.push(data[body + i]);
-            body += size;
-            if (size < 255) {
-                if (marker.every((byte, i) => packet[i] === byte))
-                    return Uint8Array.from(packet);
-                packet = [];
-            }
-        }
-        offset = body;
-    }
-    return null;
-}
-//# sourceMappingURL=LoopTags.js.map

package/dist/audio/LoopTags.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"LoopTags.js","sourceRoot":"","sources":["../../src/audio/LoopTags.ts"],"names":[],"mappings":"AASA,+FAA+F;AAC/F,MAAM,UAAU,GAAG,EAAE,GAAG,IAAI,CAAC;AAE7B;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAiB;IACpD,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAClF,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,6BAA6B;IACzC,MAAM,UAAU,GAAG,GAAkB,EAAE;QACtC,IAAI,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACvC,EAAE,IAAI,CAAC,CAAC;QACR,OAAO,EAAE,GAAG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IACpD,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACjC,EAAE,IAAI,MAAM,CAAC;IACb,IAAI,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACvC,EAAE,IAAI,CAAC,CAAC;IACR,IAAI,KAAK,GAAkB,IAAI,CAAC;IAChC,IAAI,MAAM,GAAkB,IAAI,CAAC;IACjC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;QAC1B,IAAI,IAAI,KAAK,IAAI;YAAE,MAAM;QACzB,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;QAC7D,EAAE,IAAI,IAAI,CAAC;QACX,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,SAAS,GAAG,CAAC;YAAE,SAAS;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QACnD,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACjG,IAAI,KAAK,KAAK,IAAI;YAAE,SAAS;QAC7B,IAAI,GAAG,KAAK,WAAW;YAAE,KAAK,GAAG,KAAK,CAAC;aAClC,IAAI,GAAG,KAAK,YAAY;YAAE,MAAM,GAAG,KAAK,CAAC;IAC/C,CAAC;IACD,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;AACzE,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB,CACjC,IAA2B,EAC3B,UAAkB,EAClB,QAAgB;IAEhB,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC;IAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC;IACzF,OAAO,KAAK,IAAI,CAAC,IAAI,GAAG,GAAG,KAAK,IAAI,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACvG,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAIlC;IACA,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC;IACpC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACxE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;IACxF,OAAO,GAAG,GAAG,KAAK,IAAI,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5E,CAAC;AAED,6FAA6F;AAC7F,SAAS,iBAAiB,CAAC,IAAgB;IAC1C,MAAM,MAAM,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACvD,IAAI,MAAM,GAAa,EAAE,CAAC;IAC1B,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,OAAO,MAAM,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QACnC,IACC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI;YACrB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,IAAI;YACzB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,IAAI;YACzB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,IAAI,EACxB,CAAC;YACF,OAAO,IAAI,CAAC;QACb,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;QACnC,MAAM,QAAQ,GAAG,MAAM,GAAG,EAAE,GAAG,QAAQ,CAAC;QACxC,IAAI,QAAQ,GAAG,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACxC,IAAI,IAAI,GAAG,QAAQ,CAAC;QACpB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,QAAQ,EAAE,KAAK,EAAE,EAAE,CAAC;YAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;YACvC,IAAI,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,MAAM;gBAAE,OAAO,IAAI,CAAC;YAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE;gBAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;YAC3D,IAAI,IAAI,IAAI,CAAC;YACb,IAAI,IAAI,GAAG,GAAG,EAAE,CAAC;gBAChB,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;oBAAE,OAAO,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAClF,MAAM,GAAG,EAAE,CAAC;YACb,CAAC;QACF,CAAC;QACD,MAAM,GAAG,IAAI,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC"}