@datamoc/mw_games 0.43.0 → 0.44.2

package/dist/actors/Resource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Resource.d.ts","sourceRoot":"","sources":["../../src/actors/Resource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CACf;AAoBD,yFAAyF;AACzF,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,GAAG,SAAS,YAAY,EAAE,GAAG,OAAO,CAEjG;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,GAAG,SAAS,YAAY,EAAE,GAAG,OAAO,CAK7F;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,GAAG,SAAS,YAAY,EAAE,EAAE,QAAQ,SAAI,GAAG,IAAI,CAEzG;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7G"}
+{"version":3,"file":"Resource.d.ts","sourceRoot":"","sources":["../../src/actors/Resource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CACf;AAoBD,yFAAyF;AACzF,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,GAAG,SAAS,YAAY,EAAE,GAAG,OAAO,CAEjG;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,GAAG,SAAS,YAAY,EAAE,GAAG,OAAO,CAI7F;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,GAAG,SAAS,YAAY,EAAE,EAAE,QAAQ,SAAI,GAAG,IAAI,CAEzG;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7G"}

package/dist/actors/Resource.js

@@ -26,10 +26,9 @@ export function canAfford(stats, cost) {
  * this returns false. A zero cost is always affordable and deducts nothing.
  */
 export function spend(stats, cost) {
-    const combined = totals(all(cost));
-    if (![...combined].every(([stat, amount]) => stats.base(stat) >= amount))
+    if (!canAfford(stats, cost))
         return false;
-    for (const [stat, amount] of combined)
+    for (const [stat, amount] of totals(all(cost)))
         stats.setBase(stat, stats.base(stat) - amount);
     return true;
 }

package/dist/actors/Resource.js.map

@@ -1 +1 @@
-{"version":3,"file":"Resource.js","sourceRoot":"","sources":["../../src/actors/Resource.ts"],"names":[],"mappings":"AA8BA,SAAS,GAAG,CAAC,IAA4C;IACxD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACjD,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACtB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACjG,CAAC;IACF,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED,qFAAqF;AACrF,qFAAqF;AACrF,SAAS,MAAM,CAAC,IAA6B;IAC5C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,KAAK,MAAM,CAAC,IAAI,IAAI;QAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;IACzE,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,SAAS,CAAC,KAAgB,EAAE,IAA4C;IACvF,OAAO,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,CAAC;AACrF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,KAAK,CAAC,KAAgB,EAAE,IAA4C;IACnF,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACnC,IAAI,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IACvF,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,QAAQ;QAAE,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;IACtF,OAAO,IAAI,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,KAAgB,EAAE,IAA4C,EAAE,QAAQ,GAAG,CAAC;IAClG,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAAE,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAC;AAC3G,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAgB,EAAE,IAAkB,EAAE,OAAgB,EAAE,IAAY;IACpG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAClC,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;AACvD,CAAC"}
+{"version":3,"file":"Resource.js","sourceRoot":"","sources":["../../src/actors/Resource.ts"],"names":[],"mappings":"AA8BA,SAAS,GAAG,CAAC,IAA4C;IACxD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACjD,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACtB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACjG,CAAC;IACF,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED,qFAAqF;AACrF,qFAAqF;AACrF,SAAS,MAAM,CAAC,IAA6B;IAC5C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,KAAK,MAAM,CAAC,IAAI,IAAI;QAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;IACzE,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,SAAS,CAAC,KAAgB,EAAE,IAA4C;IACvF,OAAO,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,CAAC;AACrF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,KAAK,CAAC,KAAgB,EAAE,IAA4C;IACnF,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAAE,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;IAC/F,OAAO,IAAI,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,KAAgB,EAAE,IAA4C,EAAE,QAAQ,GAAG,CAAC;IAClG,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAAE,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAC;AAC3G,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAgB,EAAE,IAAkB,EAAE,OAAgB,EAAE,IAAY;IACpG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAClC,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;AACvD,CAAC"}

package/dist/audio/AdaptiveMusic.d.ts

@@ -0,0 +1,85 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,230 @@
+/**
+ * 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

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

package/dist/audio/AudioLoader.d.ts

@@ -1,3 +1,4 @@
+import { type BusBudgetPolicy } from './BusBudget.ts';
 import type { BusLoader } from './Channels.ts';
 import { type RenderMidiAsyncOptions } from './MidiRender.ts';
 export interface AudioLoaderOptions {
@@ -5,12 +6,16 @@ export interface AudioLoaderOptions {
     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;
- * a failed load can be retried. Returned buffers can also be used by a `MusicPlayer`.
+ * 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

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

@@ -1 +1 @@
-{"version":3,"file":"AudioLoader.d.ts","sourceRoot":"","sources":["../../src/audio/AudioLoader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,eAAe,CAAC;AAC5D,OAAO,EAA0C,KAAK,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAEtG,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;CAC9C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,GAAE,kBAAuB,GAAG,SAAS,CA2BxG"}
+{"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"}

package/dist/audio/AudioLoader.js

@@ -1,10 +1,14 @@
 import { getBinary, loadBinary } from '../assets/binary.js';
+import { TrackCache } from './BusBudget.js';
 import { renderMidiToBufferAsync, toAudioBuffer } from './MidiRender.js';
+import { fitToBudget } from './Resample.js';
 /**
  * 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;
- * a failed load can be retried. Returned buffers can also be used by a `MusicPlayer`.
+ * 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
@@ -19,32 +23,33 @@ import { renderMidiToBufferAsync, toAudioBuffer } from './MidiRender.js';
  * ```
  */
 export function createAudioLoader(context, options = {}) {
-    const pending = new Map();
+    const cache = new TrackCache(options.budget);
     const read = options.read ?? readAsset;
-    async function decode(path) {
+    async function decode(path, loadContext) {
+        loadContext?.progress(0);
         const bytes = await read(path);
+        if (loadContext?.signal.aborted)
+            return null;
+        loadContext?.progress(0.5);
         const header = new Uint8Array(bytes, 0, Math.min(4, bytes.byteLength));
+        let loaded;
         if (header[0] === 77 && header[1] === 84 && header[2] === 104 && header[3] === 100) {
-            const rendered = await renderMidiToBufferAsync(bytes, options.midi);
-            return {
+            let rendered = await renderMidiToBufferAsync(bytes, options.midi);
+            if (options.budget?.render)
+                rendered = fitToBudget(rendered, options.budget.render);
+            loaded = {
                 buffer: toAudioBuffer(context, rendered),
                 loop: { start: rendered.loopStart, end: rendered.loopEnd },
             };
         }
-        // decodeAudioData can detach its input; the asset cache still owns the original bytes.
-        return { buffer: await context.decodeAudioData(bytes.slice(0)) };
-    }
-    return (_kind, path) => {
-        let loaded = pending.get(path);
-        if (!loaded) {
-            loaded = decode(path).catch((error) => {
-                pending.delete(path);
-                throw error;
-            });
-            pending.set(path, loaded);
+        else {
+            // decodeAudioData can detach its input; the asset cache still owns the original bytes.
+            loaded = { buffer: await context.decodeAudioData(bytes.slice(0)) };
         }
+        loadContext?.progress(1);
         return loaded;
-    };
+    }
+    return (_kind, path, loadContext) => cache.load(path, () => decode(path, loadContext));
 }
 async function readAsset(path) {
     await loadBinary([path]);

package/dist/audio/AudioLoader.js.map

@@ -1 +1 @@
-{"version":3,"file":"AudioLoader.js","sourceRoot":"","sources":["../../src/audio/AudioLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAA+B,MAAM,iBAAiB,CAAC;AAStG;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAyB,EAAE,OAAO,GAAuB,EAAE;IAC5F,MAAM,OAAO,GAAG,IAAI,GAAG,EAAgC,CAAC;IACxD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,SAAS,CAAC;IACvC,KAAK,UAAU,MAAM,CAAC,IAAY;QACjC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;QACvE,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YACpF,MAAM,QAAQ,GAAG,MAAM,uBAAuB,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YACpE,OAAO;gBACN,MAAM,EAAE,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC;gBACxC,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE,QAAQ,CAAC,OAAO,EAAE;aAC1D,CAAC;QACH,CAAC;QACD,uFAAuF;QACvF,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,CAAC;IACD,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,IAAI,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,MAAM,EAAE,CAAC;YACb,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBAC9C,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBACrB,MAAM,KAAK,CAAC;YACb,CAAC,CAAC,CAAC;YACH,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,MAAM,CAAC;IACf,CAAC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACzB,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC"}
+{"version":3,"file":"AudioLoader.js","sourceRoot":"","sources":["../../src/audio/AudioLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAwB,MAAM,gBAAgB,CAAC;AAElE,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAA+B,MAAM,iBAAiB,CAAC;AACtG,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAW5C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAyB,EAAE,OAAO,GAAuB,EAAE;IAC5F,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,SAAS,CAAC;IACvC,KAAK,UAAU,MAAM,CAAC,IAAY,EAAE,WAA4B;QAC/D,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,WAAW,EAAE,MAAM,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC7C,WAAW,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC3B,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;QACvE,IAAI,MAAmB,CAAC;QACxB,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YACpF,IAAI,QAAQ,GAAG,MAAM,uBAAuB,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YAClE,IAAI,OAAO,CAAC,MAAM,EAAE,MAAM;gBAAE,QAAQ,GAAG,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACpF,MAAM,GAAG;gBACR,MAAM,EAAE,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC;gBACxC,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE,QAAQ,CAAC,OAAO,EAAE;aAC1D,CAAC;QACH,CAAC;aAAM,CAAC;YACP,uFAAuF;YACvF,MAAM,GAAG,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,CAAC;QACD,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;QACzB,OAAO,MAAM,CAAC;IACf,CAAC;IACD,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;AACxF,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACzB,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC"}

package/dist/audio/AudioViews.d.ts

@@ -0,0 +1,70 @@
+import { type MidiFile } from './Midi.ts';
+/** one bucket of a waveform view: the lowest and highest sample it covers */
+export interface WaveformBucket {
+    min: number;
+    max: number;
+}
+/**
+ * A waveform reduced to `buckets` min/max pairs, what an oscilloscope or overview strip
+ * draws: each bucket covers an equal span of the samples (the last may be shorter), so a
+ * peak that lasts one sample still shows, which a plain average would erase.
+ *
+ * @example
+ * ```ts
+ * import { waveformEnvelope } from '@datamoc/mw_games/audio';
+ *
+ * const view = waveformEnvelope(new Float32Array([0, 1, -1, 0.5]), 2);
+ * console.log(view); // [{ min: 0, max: 1 }, { min: -1, max: 0.5 }]
+ * ```
+ */
+export declare function waveformEnvelope(samples: Float32Array, buckets: number): WaveformBucket[];
+/**
+ * Per-channel waveform envelopes of stereo frames: channel 0 is the left, 1 the right,
+ * and a view asks each channel for the same number of buckets.
+ *
+ * @example
+ * ```ts
+ * import { channelEnvelopes } from '@datamoc/mw_games/audio';
+ *
+ * const [left] = channelEnvelopes(new Float32Array([1, -1]), new Float32Array([0.5, -0.5]), 1);
+ * console.log(left); // [{ min: -1, max: 1 }]
+ * ```
+ */
+export declare function channelEnvelopes(left: Float32Array, right: Float32Array, buckets: number): [WaveformBucket[], WaveformBucket[]];
+/**
+ * A MIDI note number as a tracker spells it: name and octave, middle C as C4.
+ *
+ * @example
+ * ```ts
+ * import { trackerNoteName } from '@datamoc/mw_games/audio';
+ *
+ * console.log(trackerNoteName(60)); // 'C4'
+ * console.log(trackerNoteName(61)); // 'C#4'
+ * ```
+ */
+export declare function trackerNoteName(note: number): string;
+/** one row of a tracker pattern: its step, and the note each channel starts on it (null for none) */
+export interface TrackerRow {
+    step: number;
+    /** seconds from the start, of the first note on the row (the previous note's time for an empty row) */
+    time: number;
+    notes: (string | null)[];
+}
+/**
+ * A MIDI file as tracker pattern rows: `stepsPerQuarter` rows per quarter note, one
+ * column per channel that plays, and a cell naming the note that starts on that row
+ * (the highest when a channel starts several at once, as a tracker cell holds one).
+ * Steps are counted in the file's own ticks, and a row's time follows its tempo map.
+ *
+ * @example
+ * ```ts
+ * import { trackerPattern, type MidiFile } from '@datamoc/mw_games/audio';
+ *
+ * declare const file: MidiFile;
+ *
+ * const rows = trackerPattern(file);
+ * console.log(rows[0].notes); // the first step's notes by channel, or nulls
+ * ```
+ */
+export declare function trackerPattern(file: MidiFile, stepsPerQuarter?: number): TrackerRow[];
+//# sourceMappingURL=AudioViews.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AudioViews.d.ts","sourceRoot":"","sources":["../../src/audio/AudioViews.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,QAAQ,EAAsB,MAAM,WAAW,CAAC;AAEjF,6EAA6E;AAC7E,MAAM,WAAW,cAAc;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACZ;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,CAezF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC/B,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,MAAM,GACb,CAAC,cAAc,EAAE,EAAE,cAAc,EAAE,CAAC,CAEtC;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,qGAAqG;AACrG,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,uGAAuG;IACvG,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;CACzB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,eAAe,SAAI,GAAG,UAAU,EAAE,CA8BhF"}