@datamoc/mw_games 0.44.2 → 0.46.0

package/dist/audio/CoreHost.d.ts

@@ -1,114 +0,0 @@
-import { Signal } from '../core/Signal.ts';
-import type { MidiSynth } from './MidiSynth.ts';
-import type { BlockSource } from './StreamChannel.ts';
-/**
- * A synthesis core: whatever turns timed messages into audio, a `MidiSynth` or an adapter over a
- * chip player. The host runs one off the main thread and the rest of the game sees only a
- * `BlockSource`.
- */
-export type AudioCore = MidiSynth;
-export interface AudioCoreHostOptions {
-    /**
-     * Builds the core for a sample rate. It is shipped to the worker as text, so it must be
-     * self-contained: no closures, no imports, everything it needs inside its own body.
-     */
-    factory: (sampleRate: number) => AudioCore;
-    sampleRate: number;
-    /** `'auto'` tries a worker and falls back to the main thread; `'inline'` never uses one; `'worker'` fails instead of falling back. `'auto'` when omitted */
-    mode?: 'auto' | 'worker' | 'inline';
-    /** frames per render request; 1024 when omitted */
-    blockFrames?: number;
-    /** seconds of rendered audio kept ahead of the playhead; 0.3 when omitted, which is also the latency of a message sent now */
-    queueSeconds?: number;
-}
-export interface AudioCoreStats {
-    mode: 'worker' | 'inline';
-    /** why a worker was not used, when it was not */
-    fallbackReason?: string;
-    underruns: number;
-    /** frames rendered and waiting */
-    queuedFrames: number;
-    /** render time over audio time, smoothed: 1 means the core uses all of real time */
-    load: number;
-}
-/**
- * Runs a synthesis core on a worker and presents it as an endless `BlockSource`, so a
- * `StreamChannel` plays it like any stream while the render cost stays off the frame. Messages go
- * to the core stamped with an output frame and are applied at that frame; blocks come back
- * transferred, not copied, and wait in a short queue that `read` drains. When the queue runs dry
- * the missing frames are silence, the playhead moves on, and the underrun is counted and reported
- * (`onUnderrun`, `onAudioUnderrun`), so timing never drifts. Where no worker exists, or one dies,
- * the same runner runs on the main thread instead: slower for the frame, identical in sound.
- *
- * @example
- * ```ts
- * import { AudioCoreHost, StreamChannel, type AudioCore } from '@datamoc/mw_games/audio';
- *
- * declare const context: AudioContext;
- *
- * const host = new AudioCoreHost({
- * 	sampleRate: 44100,
- * 	factory: (rate): AudioCore => ({
- * 		sampleRate: rate,
- * 		event() {},
- * 		sysex() {},
- * 		render() {},
- * 		reset() {},
- * 	}),
- * });
- * new StreamChannel(context).play(host);
- * host.event(0x90, 60, 100);
- * console.log(host.stats().mode);
- * ```
- */
-export declare class AudioCoreHost implements BlockSource {
-    readonly sampleRate: number;
-    /** fires when a read found the queue short, with the seconds of silence it had to put in */
-    readonly onUnderrun: Signal<number>;
-    private readonly factorySource;
-    private readonly blockFrames;
-    private readonly queueFrames;
-    private readonly requested;
-    private link;
-    private runner;
-    private mode_;
-    private fallbackReason;
-    private warm;
-    /** why the core could not be built on this thread, when it could not */
-    private failure;
-    private disposed;
-    private readFrame;
-    private requestedUntil;
-    private blocks;
-    private underruns;
-    private load;
-    constructor(options: AudioCoreHostOptions);
-    /** `'worker'` while the core runs off the main thread, `'inline'` otherwise */
-    get mode(): 'worker' | 'inline';
-    stats(): AudioCoreStats;
-    /** sends a channel message; applied at `atFrame`, or at the start of the next block to be rendered when omitted */
-    event(status: number, data1: number, data2: number, atFrame?: number): void;
-    sysex(bytes: Uint8Array, atFrame?: number): void;
-    /** silences the core and discards everything rendered ahead of the playhead */
-    reset(): void;
-    /** moves the playhead; a different frame resets the core, the same frame leaves it playing */
-    seek(frame: number): void;
-    /**
-     * Asks the runner for whatever the queue is missing; called by every read and safe to call
-     * from a timer. A worker keeps `queueSeconds` rendered ahead of the playhead, hiding its
-     * latency from the game; the inline fallback renders just in time instead, since a queue on the
-     * thread that pays for it only moves the cost, and a message then lands on exactly its frame.
-     */
-    pump(needed?: number): void;
-    /** an endless source: fills `count` frames, with silence where the core was late, and always returns `count` */
-    read(left: Float32Array, right: Float32Array, start: number, count: number): number;
-    /** stops the worker and drops what is queued; the host cannot be used afterwards */
-    dispose(): void;
-    private openWorker;
-    private goInline;
-    private onWorkerMessage;
-    private noteLoad;
-    private send;
-    private post;
-}
-//# sourceMappingURL=CoreHost.d.ts.map

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

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

package/dist/audio/CoreHost.js

@@ -1,335 +0,0 @@
-import { Signal } from '../core/Signal.js';
-import { openWorker } from '../threads/spawn.js';
-import { onAudioUnderrun } from './Underrun.js';
-/**
- * The part that touches the core: it holds the core, the events not yet due, and the frame it has
- * rendered up to, and answers a render request with exactly that many frames, applying each event
- * at its own frame inside the block. **Self-contained by construction**, like `workerMain`: the
- * worker gets this function as text, so it may use nothing outside its own body. The inline
- * fallback calls the very same function, which is why the two paths cannot disagree.
- */
-function createCoreRunner(factorySource, sampleRate) {
-    const core = new Function(`return (${factorySource});`)()(sampleRate);
-    let position = 0;
-    let pending = [];
-    const now = () => (typeof performance === 'undefined' ? Date.now() : performance.now());
-    const apply = (event) => {
-        if (event.sysex)
-            core.sysex(event.sysex);
-        else
-            core.event(event.status, event.data1, event.data2);
-    };
-    return {
-        handle(message) {
-            if (message.type === 'events') {
-                pending = pending.concat(message.events).sort((a, b) => a.frame - b.frame);
-                return null;
-            }
-            if (message.type === 'reset') {
-                core.reset();
-                pending = [];
-                position = message.frame;
-                return null;
-            }
-            const frames = message.frames;
-            const left = new Float32Array(frames);
-            const right = new Float32Array(frames);
-            const began = now();
-            const start = position;
-            const end = start + frames;
-            let done = 0;
-            let used = 0;
-            //events already late are applied at the top of the block, in order
-            while (used < pending.length && pending[used].frame < end) {
-                const at = Math.max(0, pending[used].frame - start);
-                if (at > done) {
-                    core.render(left, right, done, at - done);
-                    done = at;
-                }
-                apply(pending[used++]);
-            }
-            pending = pending.slice(used);
-            if (done < frames)
-                core.render(left, right, done, frames - done);
-            position = end;
-            return { type: 'block', start, left, right, renderMs: now() - began };
-        },
-    };
-}
-/**
- * The worker half: builds the runner when told to, then answers each message. Self-contained for
- * the same reason as `createCoreRunner`, which is passed in because a stringified function cannot
- * reach its sibling. The same body runs under a browser worker and under Node's `worker_threads`.
- */
-function coreWorkerMain(buildRunner) {
-    const nodePort = globalThis.process?.getBuiltinModule?.('node:worker_threads')?.parentPort ?? null;
-    const scope = globalThis;
-    const send = (message, transfer = []) => {
-        if (nodePort)
-            nodePort.postMessage(message, transfer);
-        else
-            scope.postMessage(message, transfer);
-    };
-    let runner = null;
-    const onMessage = (message) => {
-        try {
-            if (message.type === 'init') {
-                runner = buildRunner(message.factory, message.sampleRate);
-                send({ type: 'ready' });
-                return;
-            }
-            const block = runner?.handle(message);
-            if (block)
-                send(block, [block.left.buffer, block.right.buffer]);
-        }
-        catch (error) {
-            send({ type: 'error', message: String(error?.message ?? error) });
-        }
-    };
-    if (nodePort)
-        nodePort.on('message', (message) => onMessage(message));
-    else
-        scope.onmessage = (event) => onMessage(event.data);
-}
-/**
- * Runs a synthesis core on a worker and presents it as an endless `BlockSource`, so a
- * `StreamChannel` plays it like any stream while the render cost stays off the frame. Messages go
- * to the core stamped with an output frame and are applied at that frame; blocks come back
- * transferred, not copied, and wait in a short queue that `read` drains. When the queue runs dry
- * the missing frames are silence, the playhead moves on, and the underrun is counted and reported
- * (`onUnderrun`, `onAudioUnderrun`), so timing never drifts. Where no worker exists, or one dies,
- * the same runner runs on the main thread instead: slower for the frame, identical in sound.
- *
- * @example
- * ```ts
- * import { AudioCoreHost, StreamChannel, type AudioCore } from '@datamoc/mw_games/audio';
- *
- * declare const context: AudioContext;
- *
- * const host = new AudioCoreHost({
- * 	sampleRate: 44100,
- * 	factory: (rate): AudioCore => ({
- * 		sampleRate: rate,
- * 		event() {},
- * 		sysex() {},
- * 		render() {},
- * 		reset() {},
- * 	}),
- * });
- * new StreamChannel(context).play(host);
- * host.event(0x90, 60, 100);
- * console.log(host.stats().mode);
- * ```
- */
-export class AudioCoreHost {
-    constructor(options) {
-        /** fires when a read found the queue short, with the seconds of silence it had to put in */
-        this.onUnderrun = new Signal();
-        this.link = null;
-        this.runner = null;
-        this.mode_ = 'inline';
-        //no underrun is reported before the first block has arrived: that wait is start-up latency, not a dropout
-        this.warm = false;
-        /** why the core could not be built on this thread, when it could not */
-        this.failure = null;
-        this.disposed = false;
-        this.readFrame = 0;
-        this.requestedUntil = 0;
-        this.blocks = [];
-        this.underruns = 0;
-        this.load = 0;
-        if (!(options.sampleRate > 0))
-            throw new Error('core host sample rate must be positive');
-        this.sampleRate = options.sampleRate;
-        this.factorySource = options.factory.toString();
-        this.blockFrames = Math.max(64, Math.floor(options.blockFrames ?? 1024));
-        this.queueFrames = Math.max(this.blockFrames, Math.floor((options.queueSeconds ?? 0.3) * options.sampleRate));
-        this.requested = options.mode ?? 'auto';
-        if (this.requested !== 'inline')
-            this.openWorker();
-        if (!this.link) {
-            if (this.requested === 'worker')
-                throw new Error(`the core host needs a worker: ${this.fallbackReason}`);
-            this.goInline(this.fallbackReason ?? 'inline mode was requested');
-            //the first failure of a core that cannot be built at all belongs to the caller
-            if (!this.runner && this.failure)
-                throw this.failure;
-        }
-        this.pump(0);
-    }
-    /** `'worker'` while the core runs off the main thread, `'inline'` otherwise */
-    get mode() {
-        return this.mode_;
-    }
-    stats() {
-        return {
-            mode: this.mode_,
-            ...(this.fallbackReason ? { fallbackReason: this.fallbackReason } : {}),
-            underruns: this.underruns,
-            queuedFrames: this.blocks.reduce((total, block) => total + block.left.length, 0),
-            load: this.load,
-        };
-    }
-    /** sends a channel message; applied at `atFrame`, or at the start of the next block to be rendered when omitted */
-    event(status, data1, data2, atFrame) {
-        this.send({ frame: atFrame ?? this.requestedUntil, status, data1, data2 });
-    }
-    sysex(bytes, atFrame) {
-        this.send({ frame: atFrame ?? this.requestedUntil, status: 0xf0, data1: 0, data2: 0, sysex: bytes });
-    }
-    /** silences the core and discards everything rendered ahead of the playhead */
-    reset() {
-        this.blocks = [];
-        this.requestedUntil = this.readFrame;
-        this.post({ type: 'reset', frame: this.readFrame });
-        this.pump(0);
-    }
-    /** moves the playhead; a different frame resets the core, the same frame leaves it playing */
-    seek(frame) {
-        const target = Math.max(0, Math.floor(frame));
-        if (target === this.readFrame)
-            return;
-        this.readFrame = target;
-        this.reset();
-    }
-    /**
-     * Asks the runner for whatever the queue is missing; called by every read and safe to call
-     * from a timer. A worker keeps `queueSeconds` rendered ahead of the playhead, hiding its
-     * latency from the game; the inline fallback renders just in time instead, since a queue on the
-     * thread that pays for it only moves the cost, and a message then lands on exactly its frame.
-     */
-    pump(needed = 0) {
-        if (this.disposed)
-            return;
-        const lead = this.mode_ === 'worker' ? Math.max(this.queueFrames, needed) : needed;
-        const queuedUntil = this.readFrame + lead;
-        while (this.requestedUntil < queuedUntil) {
-            this.requestedUntil += this.blockFrames;
-            this.post({ type: 'render', frames: this.blockFrames });
-        }
-    }
-    /** an endless source: fills `count` frames, with silence where the core was late, and always returns `count` */
-    read(left, right, start, count) {
-        this.pump(count);
-        const wantedFrom = this.readFrame;
-        const wantedTo = wantedFrom + count;
-        let filled = 0;
-        this.blocks = this.blocks.filter((block) => block.start + block.left.length > wantedFrom);
-        for (const block of this.blocks) {
-            const from = Math.max(block.start, wantedFrom + filled);
-            if (from >= wantedTo)
-                break;
-            if (from > wantedFrom + filled)
-                break;
-            const offset = from - block.start;
-            const take = Math.min(block.left.length - offset, wantedTo - from);
-            left.set(block.left.subarray(offset, offset + take), start + filled);
-            right.set(block.right.subarray(offset, offset + take), start + filled);
-            filled += take;
-        }
-        if (filled < count) {
-            left.fill(0, start + filled, start + count);
-            right.fill(0, start + filled, start + count);
-            if (this.warm) {
-                this.underruns++;
-                const lateSeconds = (count - filled) / this.sampleRate;
-                this.onUnderrun.dispatch(lateSeconds);
-                onAudioUnderrun.dispatch({ source: 'core', lateSeconds });
-            }
-        }
-        this.readFrame = wantedTo;
-        this.pump(0);
-        return count;
-    }
-    /** stops the worker and drops what is queued; the host cannot be used afterwards */
-    dispose() {
-        this.disposed = true;
-        this.link?.terminate();
-        this.link = null;
-        this.blocks = [];
-    }
-    openWorker() {
-        const source = `const createCoreRunner = ${createCoreRunner.toString()};` +
-            `(${coreWorkerMain.toString()})(createCoreRunner);`;
-        try {
-            this.link = openWorker(source, {
-                message: (data) => this.onWorkerMessage(data),
-                fail: (error) => {
-                    if (this.disposed)
-                        return;
-                    this.link?.terminate();
-                    this.link = null;
-                    this.goInline(error.message);
-                },
-            });
-        }
-        catch (error) {
-            this.link = null;
-            this.fallbackReason = error instanceof Error ? error.message : String(error);
-            return;
-        }
-        if (!this.link) {
-            this.fallbackReason = 'no Web Worker or worker_threads here';
-            return;
-        }
-        this.mode_ = 'worker';
-        this.link.post({ type: 'init', factory: this.factorySource, sampleRate: this.sampleRate });
-    }
-    goInline(reason) {
-        this.mode_ = 'inline';
-        this.fallbackReason = reason;
-        try {
-            this.runner = createCoreRunner(this.factorySource, this.sampleRate);
-        }
-        catch (error) {
-            //a core that fails to build anywhere leaves the host silent rather than throwing from a worker callback
-            this.runner = null;
-            this.failure = error instanceof Error ? error : new Error(String(error));
-            this.fallbackReason = `${reason}; the core also failed here: ${this.failure.message}`;
-            return;
-        }
-        //whatever the dead worker had not delivered is rendered again, from the playhead
-        this.blocks = [];
-        this.runner.handle({ type: 'reset', frame: this.readFrame });
-        this.requestedUntil = this.readFrame;
-    }
-    onWorkerMessage(message) {
-        if (message.type === 'ready')
-            return;
-        if (message.type === 'error') {
-            this.link?.terminate();
-            this.link = null;
-            this.goInline(String(message.message));
-            return;
-        }
-        if (message.type === 'block') {
-            const block = message;
-            this.noteLoad(block);
-            this.blocks.push(block);
-            this.warm = true;
-        }
-    }
-    noteLoad(block) {
-        const audioMs = (block.left.length / this.sampleRate) * 1000;
-        const ratio = block.renderMs / audioMs;
-        this.load = this.load === 0 ? ratio : this.load * 0.9 + ratio * 0.1;
-    }
-    send(event) {
-        this.post({ type: 'events', events: [event] });
-    }
-    post(message) {
-        if (this.disposed)
-            return;
-        if (this.mode_ === 'worker' && this.link) {
-            this.link.post(message, []);
-            return;
-        }
-        const block = this.runner?.handle(message);
-        if (block) {
-            this.noteLoad(block);
-            this.blocks.push(block);
-            this.warm = true;
-        }
-    }
-}
-//# sourceMappingURL=CoreHost.js.map

package/dist/audio/CoreHost.js.map

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

package/dist/audio/DecoderGuard.d.ts

@@ -1,139 +0,0 @@
-import type { BlockSource } from './StreamChannel.ts';
-/**
- * Guards for decoders of formats that carry machine code or compressed payloads (NSF, SID, SPC,
- * a tracker with a packed sample bank, an LHA or DEFLATE archive): all of them are untrusted
- * input, and "it ran a long time" or "it grew enormous" is a failure the format itself cannot
- * be asked to prevent. Every limit is named, defaulted and raised by the caller, and every
- * breach is one `DecodeBudgetError` that says which limit and why, never a hang or a crash.
- */
-export interface DecoderLimits {
-    /** refuse input larger than this many bytes; 16 MiB */
-    maxInputBytes: number;
-    /** refuse to inflate past this many bytes of output, the bound on a zip bomb; 64 MiB */
-    maxOutputBytes: number;
-    /** emulated instructions allowed per second of sound produced; 4 million */
-    maxInstructionsPerSecond: number;
-    /** stop a stream after this many seconds of output, whatever the file says; 3600 */
-    maxSeconds: number;
-    /** a read that takes longer than this multiple of the audio it produced counts as starved; 1 */
-    maxRealtimeRatio: number;
-    /** consecutive starved reads before the stream is cut; 8 */
-    maxStarvedReads: number;
-}
-/**
- * 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 declare const DEFAULT_DECODER_LIMITS: Readonly<DecoderLimits>;
-/** which limit a `DecodeBudgetError` is about */
-export type DecoderLimitName = keyof DecoderLimits;
-/**
- * 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 declare class DecodeBudgetError extends Error {
-    readonly limit: DecoderLimitName;
-    constructor(limit: DecoderLimitName, message: string);
-}
-/**
- * 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 declare function decoderLimits(overrides?: Partial<DecoderLimits>): DecoderLimits;
-/**
- * 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 declare function assertInputSize(input: {
-    byteLength: number;
-}, limits?: Partial<DecoderLimits>, label?: string): void;
-/**
- * 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 declare class InstructionBudget {
-    private left;
-    constructor(allowance: number);
-    /** the allowance for rendering this many seconds of sound under the limits' per-second rate */
-    static forSeconds(seconds: number, limits?: Partial<DecoderLimits>): InstructionBudget;
-    get remaining(): number;
-    spend(count?: number): void;
-}
-/**
- * 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 declare function inflateBounded(packed: Uint8Array, limits?: Partial<DecoderLimits>, format?: 'deflate-raw' | 'deflate' | 'gzip'): Promise<Uint8Array>;
-export interface GuardOptions {
-    /** replaces `performance.now` so a test controls the clock */
-    now?: () => number;
-}
-/**
- * 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 declare function guardBlockSource(source: BlockSource, overrides?: Partial<DecoderLimits>, options?: GuardOptions): BlockSource;
-//# sourceMappingURL=DecoderGuard.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"DecoderGuard.d.ts","sourceRoot":"","sources":["../../src/audio/DecoderGuard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC7B,uDAAuD;IACvD,aAAa,EAAE,MAAM,CAAC;IACtB,wFAAwF;IACxF,cAAc,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,wBAAwB,EAAE,MAAM,CAAC;IACjC,oFAAoF;IACpF,UAAU,EAAE,MAAM,CAAC;IACnB,gGAAgG;IAChG,gBAAgB,EAAE,MAAM,CAAC;IACzB,4DAA4D;IAC5D,eAAe,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,aAAa,CAOzD,CAAC;AAEH,iDAAiD;AACjD,MAAM,MAAM,gBAAgB,GAAG,MAAM,aAAa,CAAC;AAEnD;;;;;;;;;;;GAWG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IAEjC,YAAY,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAInD;CACD;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,SAAS,GAAE,OAAO,CAAC,aAAa,CAAM,GAAG,aAAa,CAMnF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC9B,KAAK,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,EAC7B,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM,EACnC,KAAK,SAAU,GACb,IAAI,CAQN;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,IAAI,CAAS;IAErB,YAAY,SAAS,EAAE,MAAM,EAG5B;IAED,+FAA+F;IAC/F,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM,GAAG,iBAAiB,CAGzF;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,KAAK,CAAC,KAAK,SAAI,GAAG,IAAI,CAQrB;CACD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CACnC,MAAM,EAAE,UAAU,EAClB,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM,EACnC,MAAM,GAAE,aAAa,GAAG,SAAS,GAAG,MAAsB,GACxD,OAAO,CAAC,UAAU,CAAC,CAuBrB;AAED,MAAM,WAAW,YAAY;IAC5B,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAC/B,MAAM,EAAE,WAAW,EACnB,SAAS,GAAE,OAAO,CAAC,aAAa,CAAM,EACtC,OAAO,GAAE,YAAiB,GACxB,WAAW,CA6Cb"}