@datamoc/mw_games 0.44.2 → 0.45.0

package/dist/assets/svg.d.ts

@@ -1,87 +0,0 @@
-/**
- * SVG as inbound data (roadmap 398): sanitization, named scale variants, and group-split
- * parts.
- *
- * An SVG is inbound data that can carry active content - `<script>`, event-handler
- * attributes, `foreignObject` - the same way a save slot or a replay file is inbound data.
- * `sanitizeSvg` refuses what it cannot prove inert, by name, conservatively: anything the
- * scan does not recognize as inert is an error, never a silent pass, and the posture is the
- * same one the saves and replay rules carry rather than a trust in the `file://` CSP to make
- * the question moot.
- *
- * `svgScaleVariants` rasterizes one source once per named scale (1x, 2x, 3x), so a game
- * picks the variant by device the way it picks an asset path, instead of every call site
- * re-deciding a resolution multiplier. `splitSvgGroups` loads an SVG authored with named
- * `<g>` groups as one standalone SVG per group - the natural authoring form for a skeletal
- * puppet: one drawing, one source of truth, split at load.
- *
- * All three are string processing with no renderer: they run headless, and the compiled
- * `data:` URI form is what they consume and produce.
- *
- * @example
- * ```ts
- * import { sanitizeSvg, splitSvgGroups } from '@datamoc/mw_games/assets';
- *
- * const puppet = '<svg><g id=\"arm\"><rect/></g></svg>';
- * const parts = splitSvgGroups(sanitizeSvg(puppet));
- * console.log(Object.keys(parts)); // ['arm']
- * ```
- */
-/**
- * Refuse an SVG that is not proven inert, by name. The scan is deliberately conservative:
- * it names what it refuses, and anything it cannot read as inert is an error rather than a
- * silent pass. The source is returned unchanged once proven inert - sanitization here is a
- * gate, not a rewrite; what a game authors is what a game gets.
- */
-export declare function sanitizeSvg(source: string): string;
-export interface ScaleVariant {
-    /** the name a game picks the variant by, the way it picks an asset path */
-    name: string;
-    /** the rasterization resolution multiple, so a device picks its sharpness at load */
-    resolution: number;
-}
-export interface SvgVariant {
-    name: string;
-    /** a `data:image/svg\+xml` URI ready for the asset loader */
-    src: string;
-    /** the loader's own resolution hint, carried from the named scale */
-    resolution: number;
-}
-/**
- * The `data:image/svg+xml` form of a source, ready for the loader.
- *
- * @example
- * ```ts
- * import { svgDataUri } from '@datamoc/mw_games/assets';
- *
- * console.log(svgDataUri('<svg/>').startsWith('data:image/svg+xml,')); // true
- * ```
- */
-export declare function svgDataUri(source: string): string;
-/**
- * One source, one variant per named scale. Each variant is the same proven-inert source at
- * its own resolution multiple, so the loader rasterizes each scale once and a game asks for
- * the variant by name instead of re-deciding a multiplier at every call site.
- */
-/**
- * One source, one variant per named scale.
- *
- * @example
- * ```ts
- * import { svgScaleVariants } from '@datamoc/mw_games/assets';
- *
- * const [sharp] = svgScaleVariants('<svg/>', [{ name: '3x', resolution: 3 }]);
- * console.log(sharp.resolution); // 3
- * ```
- */
-export declare function svgScaleVariants(source: string, scales: readonly ScaleVariant[]): SvgVariant[];
-/**
- * An SVG authored with named `<g id="...">` groups loads as one standalone SVG per group -
- * the natural authoring form for a skeletal puppet: one drawing, one source of truth for
- * palette and style, split at load. Each part keeps the original `<svg>` root attributes
- * (viewBox included) and carries exactly one group's children.
- *
- * Refused by name: an empty id, a duplicate id, and any group the scan cannot balance.
- */
-export declare function splitSvgGroups(source: string): Record<string, string>;
-//# sourceMappingURL=svg.d.ts.map

package/dist/assets/svg.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"svg.d.ts","sourceRoot":"","sources":["../../src/assets/svg.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAcH;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED,MAAM,WAAW,YAAY;IAC5B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,GAAG,EAAE,MAAM,CAAC;IACZ,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;GAIG;AACH;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,UAAU,EAAE,CAa9F;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA8CrE"}

package/dist/assets/svg.js

@@ -1,166 +0,0 @@
-/**
- * SVG as inbound data (roadmap 398): sanitization, named scale variants, and group-split
- * parts.
- *
- * An SVG is inbound data that can carry active content - `<script>`, event-handler
- * attributes, `foreignObject` - the same way a save slot or a replay file is inbound data.
- * `sanitizeSvg` refuses what it cannot prove inert, by name, conservatively: anything the
- * scan does not recognize as inert is an error, never a silent pass, and the posture is the
- * same one the saves and replay rules carry rather than a trust in the `file://` CSP to make
- * the question moot.
- *
- * `svgScaleVariants` rasterizes one source once per named scale (1x, 2x, 3x), so a game
- * picks the variant by device the way it picks an asset path, instead of every call site
- * re-deciding a resolution multiplier. `splitSvgGroups` loads an SVG authored with named
- * `<g>` groups as one standalone SVG per group - the natural authoring form for a skeletal
- * puppet: one drawing, one source of truth, split at load.
- *
- * All three are string processing with no renderer: they run headless, and the compiled
- * `data:` URI form is what they consume and produce.
- *
- * @example
- * ```ts
- * import { sanitizeSvg, splitSvgGroups } from '@datamoc/mw_games/assets';
- *
- * const puppet = '<svg><g id=\"arm\"><rect/></g></svg>';
- * const parts = splitSvgGroups(sanitizeSvg(puppet));
- * console.log(Object.keys(parts)); // ['arm']
- * ```
- */
-/** active shapes and attributes a name-based scan refuses, by name, conservatively */
-const REFUSED_PATTERNS = [
-    { name: '<script>', pattern: /<script[\s/>]/i },
-    { name: '<foreignObject>', pattern: /<foreignobject[\s/>]/i },
-    { name: '<iframe>', pattern: /<iframe[\s/>]/i },
-    { name: '<embed>', pattern: /<embed[\s/>]/i },
-    { name: '<object>', pattern: /<object[\s/>]/i },
-    { name: 'an event-handler attribute', pattern: /\son[a-z]+\s*=/i },
-    { name: 'a javascript: URL', pattern: /javascript\s*:/i },
-    { name: 'a data: URL of an active type', pattern: /data:(?:text\/html|application\/xml|image\/svg\+xml)/i },
-];
-/**
- * Refuse an SVG that is not proven inert, by name. The scan is deliberately conservative:
- * it names what it refuses, and anything it cannot read as inert is an error rather than a
- * silent pass. The source is returned unchanged once proven inert - sanitization here is a
- * gate, not a rewrite; what a game authors is what a game gets.
- */
-export function sanitizeSvg(source) {
-    for (const { name, pattern } of REFUSED_PATTERNS)
-        if (pattern.test(source))
-            throw new Error(`SVG refused: contains ${name}`);
-    return source;
-}
-/**
- * The `data:image/svg+xml` form of a source, ready for the loader.
- *
- * @example
- * ```ts
- * import { svgDataUri } from '@datamoc/mw_games/assets';
- *
- * console.log(svgDataUri('<svg/>').startsWith('data:image/svg+xml,')); // true
- * ```
- */
-export function svgDataUri(source) {
-    return `data:image/svg\+xml,${encodeURIComponent(source)}`;
-}
-/**
- * One source, one variant per named scale. Each variant is the same proven-inert source at
- * its own resolution multiple, so the loader rasterizes each scale once and a game asks for
- * the variant by name instead of re-deciding a multiplier at every call site.
- */
-/**
- * One source, one variant per named scale.
- *
- * @example
- * ```ts
- * import { svgScaleVariants } from '@datamoc/mw_games/assets';
- *
- * const [sharp] = svgScaleVariants('<svg/>', [{ name: '3x', resolution: 3 }]);
- * console.log(sharp.resolution); // 3
- * ```
- */
-export function svgScaleVariants(source, scales) {
-    const inert = sanitizeSvg(source);
-    if (scales.length === 0)
-        throw new Error('SVG scale variants need at least one named scale');
-    const seen = new Set();
-    for (const scale of scales) {
-        if (!scale.name)
-            throw new Error('an SVG scale variant needs a name');
-        if (!Number.isFinite(scale.resolution) || scale.resolution <= 0)
-            throw new Error(`SVG scale variant ${scale.name} needs a positive resolution`);
-        if (seen.has(scale.name))
-            throw new Error(`duplicate SVG scale variant ${scale.name}`);
-        seen.add(scale.name);
-    }
-    const src = svgDataUri(inert);
-    return scales.map((scale) => ({ name: scale.name, src, resolution: scale.resolution }));
-}
-/**
- * An SVG authored with named `<g id="...">` groups loads as one standalone SVG per group -
- * the natural authoring form for a skeletal puppet: one drawing, one source of truth for
- * palette and style, split at load. Each part keeps the original `<svg>` root attributes
- * (viewBox included) and carries exactly one group's children.
- *
- * Refused by name: an empty id, a duplicate id, and any group the scan cannot balance.
- */
-export function splitSvgGroups(source) {
-    const inert = sanitizeSvg(source);
-    const root = /^([\s\S]*?)<svg([^>]*)>/i.exec(inert);
-    const close = inert.lastIndexOf('</svg>');
-    if (!root || close < 0)
-        throw new Error('SVG group split needs an <svg> root');
-    const rawBody = inert.slice(root[0].length, close);
-    const shared = [...rawBody.matchAll(/<(defs|style)\b[^>]*>[\s\S]*?<\/\1\s*>/gi)].map((match) => match[0]).join('');
-    const body = rawBody.replace(/<(defs|style)\b[^>]*>[\s\S]*?<\/\1\s*>/gi, '');
-    const parts = Object.create(null);
-    let position = 0;
-    while (position < body.length) {
-        const open = /<g\b([^>]*?)(\/?)>/i.exec(body.slice(position));
-        if (!open)
-            break;
-        const attributes = open[1];
-        const id = /\bid\s*=\s*["']([^"']+)["']/i.exec(attributes)?.[1];
-        const contentStart = position + open.index + open[0].length;
-        if (open[2] === '/') {
-            //a self-closing group is an empty part, not a walk that never closes
-            if (!id)
-                throw new Error('SVG group split refuses a group with no id');
-            if (id in parts)
-                throw new Error(`SVG group split refuses a duplicate id ${id}`);
-            parts[id] = `${root[0]}${shared}${open[0]}</svg>`;
-            position = contentStart;
-            continue;
-        }
-        //walk forward balancing nested <g> opens against their closes
-        let depth = 1;
-        let cursor = contentStart;
-        let closer = '';
-        while (depth > 0 && cursor < body.length) {
-            const next = body.slice(cursor).match(/<g\b[^>]*>|<\/g\s*>/i);
-            if (!next)
-                throw new Error(`SVG group ${id ?? '<unnamed>'} never closes`);
-            if (next[0].startsWith('</')) {
-                depth--;
-                if (depth === 0)
-                    closer = next[0];
-            }
-            else if (!/\/\s*>$/.test(next[0]))
-                depth++;
-            cursor += next.index + next[0].length;
-        }
-        if (depth !== 0)
-            throw new Error(`SVG group ${id ?? '<unnamed>'} never closes`);
-        const content = body.slice(contentStart, cursor - closer.length);
-        position = cursor;
-        if (!id)
-            throw new Error('SVG group split refuses a group with no id');
-        if (id in parts)
-            throw new Error(`SVG group split refuses a duplicate id ${id}`);
-        parts[id] = `${root[0]}${shared}${open[0]}${content}</g></svg>`;
-    }
-    if (Object.keys(parts).length === 0)
-        throw new Error('SVG group split found no named groups');
-    return parts;
-}
-//# sourceMappingURL=svg.js.map

package/dist/assets/svg.js.map

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

package/dist/audio/AdaptiveMusic.d.ts

@@ -1,85 +0,0 @@
-import type { LoopRegion } from './Channels.ts';
-/** a set of stems that line up: same length, same rate, so they can be mixed and swapped in step */
-export type StemSet = Readonly<Record<string, AudioBuffer>>;
-export interface AdaptiveMusicOptions {
-    destination?: AudioNode;
-    /** seconds of fade for a level change or a version switch when the call gives none; 1 when omitted */
-    fadeSeconds?: number;
-}
-export interface AdaptiveLoadOptions {
-    /** names a group of stems so one call sets them all: `{ combat: ['drums', 'brass'] }` */
-    groups?: Readonly<Record<string, readonly string[]>>;
-    /** the region the whole set repeats; the whole buffer when omitted */
-    loop?: LoopRegion | null;
-}
-export interface AdaptivePlayOptions {
-    /** the version to start with; the first one loaded when omitted */
-    version?: string;
-    /** start offset in seconds */
-    pos?: number;
-    /** starting level of each stem or group, 0 to 1; a stem not named starts at 0 */
-    levels?: Readonly<Record<string, number>>;
-}
-/**
- * Adaptive music from stems that play in lockstep: every stem of a version starts on the same
- * clock tick at the same offset, each through its own gain, so raising or lowering a stem (or a
- * named group of them) with a fade changes the intensity without changing the file or losing the
- * beat. Several versions of the arrangement can be loaded; switching between them crossfades at
- * the same position, counted in frames, so a calm version and a combat version stay in step. Stems
- * come from `renderMidiStems` or from separately recorded layers; all stems of a version must have
- * the same length and sample rate, and versions must agree on the sample rate.
- *
- * @example
- * ```ts
- * import { AdaptiveMusic, renderMidiStems, parseMidi, toAudioBuffer } from '@datamoc/mw_games/audio';
- *
- * declare const context: AudioContext;
- * declare const midiBytes: ArrayBuffer;
- *
- * const rendered = renderMidiStems(parseMidi(midiBytes), { rhythm: [9], melody: [0], pads: [1] });
- * const stems = Object.fromEntries(Object.entries(rendered).map(([name, r]) => [name, toAudioBuffer(context, r)]));
- *
- * const music = new AdaptiveMusic(context);
- * music.load('calm', stems, { groups: { intensity: ['rhythm', 'melody'] } });
- * music.play({ levels: { pads: 1 } });
- * music.setLevel('intensity', 1, 2); // fade the fight in over two seconds
- * ```
- */
-export declare class AdaptiveMusic {
-    private readonly context;
-    private readonly destination;
-    private readonly defaultFade;
-    private readonly versions;
-    private running;
-    private startedAt;
-    private offsetFrames;
-    private levels_;
-    constructor(context: AudioContext, options?: AdaptiveMusicOptions);
-    get isPlaying(): boolean;
-    /** the version that sounds now, or null */
-    get version(): string | null;
-    /** loads one arrangement under a name; throws when its stems do not line up */
-    load(name: string, stems: StemSet, options?: AdaptiveLoadOptions): void;
-    /** starts the set from the beginning, or from `pos` */
-    play(options?: AdaptivePlayOptions): void;
-    /** sets a stem's or group's level (0 to 1), fading over `fadeSeconds` */
-    setLevel(target: string, level: number, fadeSeconds?: number): void;
-    /** the level each stem is heading to */
-    levels(): Record<string, number>;
-    /** frame position inside the buffers, wrapping inside the loop region */
-    positionFrames(): number;
-    position(): number;
-    /**
-     * Crossfades to another loaded version at the position the current one has reached, in
-     * frames, so the beat carries over. Levels carry over too: a stem or group of the same name
-     * keeps the level it had.
-     */
-    switchVersion(name: string, fadeSeconds?: number): void;
-    /** stops every stem, fading over `fadeSeconds` first when positive; the position is forgotten */
-    stop(fadeSeconds?: number): void;
-    private startVersion;
-    private membersOf;
-    private ramp;
-    private stopAt;
-}
-//# sourceMappingURL=AdaptiveMusic.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"AdaptiveMusic.d.ts","sourceRoot":"","sources":["../../src/audio/AdaptiveMusic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,oGAAoG;AACpG,MAAM,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;AAE5D,MAAM,WAAW,oBAAoB;IACpC,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,sGAAsG;IACtG,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IACnC,yFAAyF;IACzF,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;IACrD,sEAAsE;IACtE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IACnC,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC1C;AAqBD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,aAAa;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAY;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IACvD,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,OAAO,CAA8B;IAE7C,YAAY,OAAO,EAAE,YAAY,EAAE,OAAO,GAAE,oBAAyB,EAIpE;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,2CAA2C;IAC3C,IAAI,OAAO,IAAI,MAAM,GAAG,IAAI,CAE3B;IAED,+EAA+E;IAC/E,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,mBAAwB,GAAG,IAAI,CA8B1E;IAED,uDAAuD;IACvD,IAAI,CAAC,OAAO,GAAE,mBAAwB,GAAG,IAAI,CAU5C;IAED,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAYlE;IAED,wCAAwC;IACxC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE/B;IAED,yEAAyE;IACzE,cAAc,IAAI,MAAM,CASvB;IAED,QAAQ,IAAI,MAAM,CAGjB;IAED;;;;OAIG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAetD;IAED,iGAAiG;IACjG,IAAI,CAAC,WAAW,SAAI,GAAG,IAAI,CAS1B;IAED,OAAO,CAAC,YAAY;IAyCpB,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,IAAI;IAWZ,OAAO,CAAC,MAAM;CAOd"}

package/dist/audio/AdaptiveMusic.js

@@ -1,230 +0,0 @@
-/**
- * Adaptive music from stems that play in lockstep: every stem of a version starts on the same
- * clock tick at the same offset, each through its own gain, so raising or lowering a stem (or a
- * named group of them) with a fade changes the intensity without changing the file or losing the
- * beat. Several versions of the arrangement can be loaded; switching between them crossfades at
- * the same position, counted in frames, so a calm version and a combat version stay in step. Stems
- * come from `renderMidiStems` or from separately recorded layers; all stems of a version must have
- * the same length and sample rate, and versions must agree on the sample rate.
- *
- * @example
- * ```ts
- * import { AdaptiveMusic, renderMidiStems, parseMidi, toAudioBuffer } from '@datamoc/mw_games/audio';
- *
- * declare const context: AudioContext;
- * declare const midiBytes: ArrayBuffer;
- *
- * const rendered = renderMidiStems(parseMidi(midiBytes), { rhythm: [9], melody: [0], pads: [1] });
- * const stems = Object.fromEntries(Object.entries(rendered).map(([name, r]) => [name, toAudioBuffer(context, r)]));
- *
- * const music = new AdaptiveMusic(context);
- * music.load('calm', stems, { groups: { intensity: ['rhythm', 'melody'] } });
- * music.play({ levels: { pads: 1 } });
- * music.setLevel('intensity', 1, 2); // fade the fight in over two seconds
- * ```
- */
-export class AdaptiveMusic {
-    constructor(context, options = {}) {
-        this.versions = new Map();
-        this.running = null;
-        this.startedAt = 0;
-        this.offsetFrames = 0;
-        this.levels_ = {};
-        this.context = context;
-        this.destination = options.destination ?? context.destination;
-        this.defaultFade = Math.max(0, options.fadeSeconds ?? 1);
-    }
-    get isPlaying() {
-        return this.running !== null;
-    }
-    /** the version that sounds now, or null */
-    get version() {
-        return this.running?.version ?? null;
-    }
-    /** loads one arrangement under a name; throws when its stems do not line up */
-    load(name, stems, options = {}) {
-        const names = Object.keys(stems);
-        if (names.length === 0)
-            throw new Error(`adaptive version "${name}" has no stems`);
-        const first = stems[names[0]];
-        for (const stem of names) {
-            const buffer = stems[stem];
-            if (buffer.length !== first.length || buffer.sampleRate !== first.sampleRate) {
-                throw new Error(`stem "${stem}" of "${name}" differs in length or sample rate from "${names[0]}"`);
-            }
-        }
-        const other = [...this.versions.values()][0];
-        if (other && other.sampleRate !== first.sampleRate) {
-            throw new Error(`version "${name}" is at ${first.sampleRate} Hz but the others are at ${other.sampleRate} Hz`);
-        }
-        const groups = options.groups ?? {};
-        for (const [group, members] of Object.entries(groups)) {
-            const missing = members.find((member) => !(member in stems));
-            if (missing !== undefined)
-                throw new Error(`group "${group}" names stem "${missing}", which "${name}" lacks`);
-            if (group in stems)
-                throw new Error(`group "${group}" has the name of a stem`);
-        }
-        this.versions.set(name, {
-            stems,
-            groups,
-            loop: options.loop ?? null,
-            frames: first.length,
-            sampleRate: first.sampleRate,
-        });
-    }
-    /** starts the set from the beginning, or from `pos` */
-    play(options = {}) {
-        this.stop();
-        const name = options.version ?? [...this.versions.keys()][0];
-        const version = name === undefined ? undefined : this.versions.get(name);
-        if (!version || name === undefined)
-            throw new Error(`no adaptive version "${options.version ?? ''}" is loaded`);
-        this.levels_ = {};
-        const offset = Math.min(Math.max(0, Math.floor((options.pos ?? 0) * version.sampleRate)), version.frames - 1);
-        this.offsetFrames = offset;
-        this.startedAt = this.context.currentTime;
-        this.running = this.startVersion(name, version, offset, options.levels ?? {}, 0);
-    }
-    /** sets a stem's or group's level (0 to 1), fading over `fadeSeconds` */
-    setLevel(target, level, fadeSeconds) {
-        const running = this.running;
-        if (!running)
-            throw new Error('adaptive music is not playing');
-        const version = this.versions.get(running.version);
-        const members = this.membersOf(version, target);
-        const value = Math.min(1, Math.max(0, level));
-        const fade = Math.max(0, fadeSeconds ?? this.defaultFade);
-        for (const member of members) {
-            this.levels_[member] = value;
-            const gain = running.voices.get(member)?.gain.gain;
-            if (gain)
-                this.ramp(gain, value, fade);
-        }
-    }
-    /** the level each stem is heading to */
-    levels() {
-        return { ...this.levels_ };
-    }
-    /** frame position inside the buffers, wrapping inside the loop region */
-    positionFrames() {
-        const running = this.running;
-        if (!running)
-            return 0;
-        const version = this.versions.get(running.version);
-        let frame = this.offsetFrames + Math.max(0, this.context.currentTime - this.startedAt) * version.sampleRate;
-        const start = version.loop ? Math.floor(version.loop.start * version.sampleRate) : 0;
-        const end = version.loop ? Math.floor(version.loop.end * version.sampleRate) : version.frames;
-        if (end > start && frame >= end)
-            frame = start + ((frame - start) % (end - start));
-        return Math.floor(frame);
-    }
-    position() {
-        const running = this.running;
-        return running ? this.positionFrames() / this.versions.get(running.version).sampleRate : 0;
-    }
-    /**
-     * Crossfades to another loaded version at the position the current one has reached, in
-     * frames, so the beat carries over. Levels carry over too: a stem or group of the same name
-     * keeps the level it had.
-     */
-    switchVersion(name, fadeSeconds) {
-        const running = this.running;
-        if (!running)
-            throw new Error('adaptive music is not playing');
-        const next = this.versions.get(name);
-        if (!next)
-            throw new Error(`no adaptive version "${name}" is loaded`);
-        if (name === running.version)
-            return;
-        const fade = Math.max(0, fadeSeconds ?? this.defaultFade);
-        const frame = this.positionFrames();
-        const retired = running;
-        const now = this.context.currentTime;
-        this.ramp(retired.master.gain, 0, fade);
-        for (const { source } of retired.voices.values())
-            this.stopAt(source, now + fade + 0.05);
-        this.offsetFrames = Math.min(frame, next.frames - 1);
-        this.startedAt = now;
-        this.running = this.startVersion(name, next, this.offsetFrames, this.levels_, fade);
-    }
-    /** stops every stem, fading over `fadeSeconds` first when positive; the position is forgotten */
-    stop(fadeSeconds = 0) {
-        const running = this.running;
-        this.running = null;
-        this.levels_ = {};
-        if (!running)
-            return;
-        const now = this.context.currentTime;
-        if (fadeSeconds > 0)
-            this.ramp(running.master.gain, 0, fadeSeconds);
-        for (const { source } of running.voices.values())
-            this.stopAt(source, fadeSeconds > 0 ? now + fadeSeconds + 0.05 : undefined);
-    }
-    startVersion(name, version, offsetFrames, levels, fadeInSeconds) {
-        const master = this.context.createGain();
-        master.gain.value = fadeInSeconds > 0 ? 0 : 1;
-        master.connect(this.destination);
-        if (fadeInSeconds > 0)
-            this.ramp(master.gain, 1, fadeInSeconds);
-        const voices = new Map();
-        const when = this.context.currentTime;
-        const offset = offsetFrames / version.sampleRate;
-        //levels given by group name apply to every member; a stem named directly overrides its group
-        const resolved = {};
-        for (const [target, level] of Object.entries(levels)) {
-            if (target in version.groups)
-                for (const member of version.groups[target])
-                    resolved[member] = level;
-        }
-        for (const [target, level] of Object.entries(levels))
-            if (target in version.stems)
-                resolved[target] = level;
-        for (const [stem, buffer] of Object.entries(version.stems)) {
-            const gain = this.context.createGain();
-            const level = Math.min(1, Math.max(0, resolved[stem] ?? 0));
-            gain.gain.value = level;
-            this.levels_[stem] = level;
-            gain.connect(master);
-            const source = this.context.createBufferSource();
-            source.buffer = buffer;
-            source.loop = true;
-            if (version.loop) {
-                source.loopStart = version.loop.start;
-                source.loopEnd = version.loop.end;
-            }
-            source.connect(gain);
-            //every stem on the same tick at the same offset is what keeps them in step
-            source.start(when, offset);
-            voices.set(stem, { source, gain });
-        }
-        return { version: name, voices, master };
-    }
-    membersOf(version, target) {
-        if (target in version.stems)
-            return [target];
-        const group = version.groups[target];
-        if (!group)
-            throw new Error(`"${target}" is neither a stem nor a group of "${this.running?.version}"`);
-        return group;
-    }
-    ramp(param, value, seconds) {
-        if (seconds <= 0) {
-            param.value = value;
-            return;
-        }
-        const now = this.context.currentTime;
-        param.cancelScheduledValues(now);
-        param.setValueAtTime(param.value, now);
-        param.linearRampToValueAtTime(value, now + seconds);
-    }
-    stopAt(source, when) {
-        try {
-            source.stop(when);
-        }
-        catch {
-            //already stopped
-        }
-    }
-}
-//# sourceMappingURL=AdaptiveMusic.js.map

package/dist/audio/AdaptiveMusic.js.map

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

package/dist/audio/AudioLoader.d.ts

@@ -1,33 +0,0 @@
-import { type BusBudgetPolicy } from './BusBudget.ts';
-import type { BusLoader } from './Channels.ts';
-import { type RenderMidiAsyncOptions } from './MidiRender.ts';
-export interface AudioLoaderOptions {
-    /** MIDI rendering settings, including optional SoundFont bytes. */
-    midi?: RenderMidiAsyncOptions;
-    /** Reads embedded assets by default; inject a byte source for a custom archive or a test. */
-    read?: (path: string) => Promise<ArrayBuffer>;
-    /** keeps decoded tracks inside a memory budget, evicting the least recently used; every track stays cached when omitted */
-    budget?: BusBudgetPolicy;
-}
-/**
- * One loader for `AudioBus` music, jingles and effects: MIDI is rendered on a worker,
- * other formats use the browser's audio decoder. MIDI detection uses the file header,
- * so an archive alias does not need a filename extension. Results are cached by path
- * (under `budget` when one is given, which also caps and shrinks rendered MIDI); a failed
- * load can be retried. A load reports 0, 0.5 and 1 through the bus's progress context, and
- * skips its render when the request was replaced before the bytes arrived. Returned buffers can also be used by a `MusicPlayer`.
- *
- * @example
- * ```ts
- * import { AudioBus, createAudioLoader } from '@datamoc/mw_games/audio';
- * declare const context: AudioContext;
- * declare const soundFontBytes: ArrayBuffer;
- * const bus = new AudioBus(context, {
- *   load: createAudioLoader(context, { midi: { soundFontBytes, missingProgram: 'synth' } }),
- * });
- * await bus.playBgm({ name: 'music/theme.mid', volume: 80, pitch: 100, pan: 0 });
- * await bus.playSe({ name: 'sounds/hit.wav', volume: 80, pitch: 110, pan: 20 });
- * ```
- */
-export declare function createAudioLoader(context: BaseAudioContext, options?: AudioLoaderOptions): BusLoader;
-//# sourceMappingURL=AudioLoader.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"AudioLoader.d.ts","sourceRoot":"","sources":["../../src/audio/AudioLoader.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,KAAK,EAAkB,SAAS,EAAe,MAAM,eAAe,CAAC;AAC5E,OAAO,EAA0C,KAAK,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAGtG,MAAM,WAAW,kBAAkB;IAClC,mEAAmE;IACnE,IAAI,CAAC,EAAE,sBAAsB,CAAC;IAC9B,6FAA6F;IAC7F,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9C,2HAA2H;IAC3H,MAAM,CAAC,EAAE,eAAe,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,GAAE,kBAAuB,GAAG,SAAS,CAyBxG"}