@datamoc/mw_games 0.20.0 → 0.23.0

package/dist/audio/humanize/Onsets.js

@@ -0,0 +1,164 @@
+/**
+ * Onset detection, for the audio path of `GrooveExtractor`: when a groove has to come
+ * from a recording rather than from a pair of MIDI files, something has to find the hits
+ * first. Spectral flux over a short sliding window is the usual measure (what aubio and
+ * Essentia reach for), and it is cheap enough to hand-roll: a radix-2 FFT, the rise in
+ * magnitude bin by bin, then a local threshold with a minimum gap so one attack is not
+ * reported again by its own decay.
+ *
+ * The timings are what a groove lives or dies on, so the frame geometry is worth stating.
+ * Frames are padded by half a window either side, which is what lets a hit at sample 0 be
+ * measured with the window's full weight instead of its zeroed edge. A Hann window makes
+ * flux peak a quarter of a window plus half a hop after the hit it is reacting to; the
+ * detector subtracts that constant, leaving only the half-hop of frame quantization.
+ *
+ * Flux alone is not enough to call something an onset, which is what `ENERGY_RISE` below
+ * is for: everything else in this file is about locating a hit, that gate is about
+ * refusing to find one where there is none.
+ */
+const FRAME = 256;
+const HOP = 64;
+/** frames either side of a peak that make up its local mean and spread */
+const NEIGHBOURHOOD = 10;
+/**
+ * How far above its neighbourhood a peak has to sit. Two is the balance point: an attack
+ * lands well above it however loud the rest of the file is, while three lets the
+ * neighbourhood of a sparse attack (mostly zeros) put the peak back within reach.
+ */
+const FLUX_SIGMAS = 2;
+/**
+ * An onset has to multiply its frame's energy by this much. This is what tells a hit apart
+ * from a sustained note: flux alone reports the beating of a steady tone as a train of
+ * onsets, because the tone's energy sloshes between bins while its own envelope is flat. A
+ * real onset multiplies the frame's energy many times over; a steady tone moves it by a
+ * couple of per cent. The previous frame may carry the rise, since flux compares against
+ * the frame it came from and so trails the energy by up to one frame.
+ */
+const ENERGY_RISE = 0.05;
+/** minimum gap between two onsets, in frames: one attack, not its own ringing */
+const MIN_GAP_FRAMES = 4;
+/** where a Hann window's derivative puts the flux peak behind the hit: FRAME/4 + HOP/2 */
+const FLUX_PEAK_DELAY = FRAME / 4 + HOP / 2;
+/** in-place iterative radix-2 FFT; `real` and `imaginary` must be a power of two long */
+function fft(real, imaginary) {
+    const length = real.length;
+    let j = 0;
+    for (let i = 1; i < length; i++) {
+        let bit = length >> 1;
+        while (j & bit) {
+            j ^= bit;
+            bit >>= 1;
+        }
+        j ^= bit;
+        if (i < j) {
+            let swap = real[i];
+            real[i] = real[j];
+            real[j] = swap;
+            swap = imaginary[i];
+            imaginary[i] = imaginary[j];
+            imaginary[j] = swap;
+        }
+    }
+    for (let size = 2; size <= length; size <<= 1) {
+        const angle = (-2 * Math.PI) / size;
+        const stepReal = Math.cos(angle);
+        const stepImaginary = Math.sin(angle);
+        const half = size >> 1;
+        for (let start = 0; start < length; start += size) {
+            let weightReal = 1;
+            let weightImaginary = 0;
+            for (let k = 0; k < half; k++) {
+                const even = start + k;
+                const odd = even + half;
+                const oddReal = real[odd] * weightReal - imaginary[odd] * weightImaginary;
+                const oddImaginary = real[odd] * weightImaginary + imaginary[odd] * weightReal;
+                real[odd] = real[even] - oddReal;
+                imaginary[odd] = imaginary[even] - oddImaginary;
+                real[even] += oddReal;
+                imaginary[even] += oddImaginary;
+                const nextReal = weightReal * stepReal - weightImaginary * stepImaginary;
+                weightImaginary = weightReal * stepImaginary + weightImaginary * stepReal;
+                weightReal = nextReal;
+            }
+        }
+    }
+}
+/**
+ * When each onset in a mono signal happens, in seconds from its start.
+ *
+ * Returns an empty array rather than throwing when there is nothing to find; the caller
+ * decides whether silence is a valid extraction result (it is not, and it says so).
+ */
+export function detectOnsets(samples, sampleRate) {
+    if (samples.length === 0 || sampleRate <= 0)
+        return [];
+    const pad = FRAME / 2;
+    const padded = new Float32Array(samples.length + pad * 2);
+    padded.set(samples, pad);
+    const window = new Float64Array(FRAME);
+    for (let i = 0; i < FRAME; i++)
+        window[i] = 0.5 - 0.5 * Math.cos((2 * Math.PI * i) / (FRAME - 1));
+    const real = new Float64Array(FRAME);
+    const imaginary = new Float64Array(FRAME);
+    const previous = new Float64Array(FRAME / 2);
+    const flux = [];
+    const energyRise = [];
+    let previousEnergy = 0;
+    for (let start = 0; start + FRAME <= padded.length; start += HOP) {
+        let energy = 0;
+        for (let i = 0; i < FRAME; i++) {
+            real[i] = padded[start + i] * window[i];
+            imaginary[i] = 0;
+            energy += real[i] * real[i];
+        }
+        //nothing against nothing is no change, but a frame that finally carries signal is
+        //an unbounded one, which is what the first frame of any file is
+        energyRise.push(previousEnergy === 0 ? (energy === 0 ? 0 : Infinity) : energy / previousEnergy - 1);
+        previousEnergy = energy;
+        fft(real, imaginary);
+        let rise = 0;
+        for (let k = 0; k < FRAME / 2; k++) {
+            const magnitude = Math.hypot(real[k], imaginary[k]);
+            const difference = magnitude - previous[k];
+            if (difference > 0)
+                rise += difference;
+            previous[k] = magnitude;
+        }
+        flux.push(rise);
+    }
+    const onsets = [];
+    let lastFrame = -Infinity;
+    for (let i = 0; i < flux.length; i++) {
+        const from = Math.max(0, i - NEIGHBOURHOOD);
+        const to = Math.min(flux.length - 1, i + NEIGHBOURHOOD);
+        const span = to - from + 1;
+        let mean = 0;
+        for (let k = from; k <= to; k++)
+            mean += flux[k];
+        mean /= span;
+        let variance = 0;
+        for (let k = from; k <= to; k++)
+            variance += (flux[k] - mean) ** 2;
+        const threshold = mean + FLUX_SIGMAS * Math.sqrt(variance / span);
+        //`<= 0` first: a silent file has flux of exactly zero everywhere, and its last
+        //frame would otherwise pass every later test and report an onset at the end
+        if (flux[i] <= 0 || flux[i] < threshold)
+            continue;
+        //and an attack has to have moved the envelope, not just the bin balance
+        if (energyRise[i] < ENERGY_RISE && (i === 0 || energyRise[i - 1] < ENERGY_RISE))
+            continue;
+        // the last frame of a flat top wins, so the plateau an impulse leaves behind
+        // resolves to one onset rather than the first frame of the plateau
+        if (i > 0 && flux[i - 1] > flux[i])
+            continue;
+        if (i + 1 < flux.length && flux[i + 1] >= flux[i])
+            continue;
+        if (i - lastFrame < MIN_GAP_FRAMES)
+            continue;
+        const time = (i * HOP + pad - FLUX_PEAK_DELAY) / sampleRate;
+        onsets.push(Math.max(0, time));
+        lastFrame = i;
+    }
+    return onsets;
+}
+//# sourceMappingURL=Onsets.js.map

package/dist/audio/humanize/Onsets.js.map

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

package/dist/audio/index.d.ts

@@ -17,8 +17,21 @@ export type { RenderMidiOptions, RenderMidiAsyncOptions, RenderedMidi } from './
 export { collectSoundFontUsage, parseSoundFont, subsetSoundFont } from './SoundFont.ts';
 export type { SoundFont, SoundFontProgram, SoundFontSample, SoundFontVoice } from './SoundFont.ts';
 export { Channel, AudioBus } from './Channels.ts';
-export type { LoopRegion, ChannelPlayOptions, ChannelState } from './Channels.ts';
+export { parseVorbisLoopTags, loopRegionFromTags } from './LoopTags.ts';
+export type { VorbisLoopTags } from './LoopTags.ts';
+export type { LoopRegion, ChannelPlayOptions, ChannelState, BusMixerLevel } from './Channels.ts';
 export type { BusKind, BusTrack, SavedBusTrack, LoadedTrack, BusLoader, BusSnapshot, AudioBusOptions, } from './Channels.ts';
 export { AudioListener, SoundSource, audioGain, audioPan } from './Positional.ts';
 export type { AudioPoint, AudioFalloff, SoundSourceOptions } from './Positional.ts';
+export { subdivisionCount, assertGrooveTemplate } from './humanize/Groove.ts';
+export type { GridSubdivision, GrooveOffset, GrooveTemplate } from './humanize/Groove.ts';
+export { LiteHumanizer } from './humanize/LiteHumanizer.ts';
+export { GrooveHumanizer } from './humanize/GrooveHumanizer.ts';
+export { GrooveExtractor } from './humanize/GrooveExtractor.ts';
+export type { GrooveExtractorEngine } from './humanize/GrooveExtractor.ts';
+export { GrooveConverter } from './humanize/GrooveConverter.ts';
+export type { GrooveConverterEngine, GrooveFormat } from './humanize/GrooveConverter.ts';
+export { HumanizerFactory, humanizeMidi } from './humanize/HumanizerFactory.ts';
+export type { HumanizeRequest } from './humanize/HumanizerFactory.ts';
+export type { HumanizationOptions, HumanizeStyle, HumanizerTier, MidiHumanizerEngine } from './humanize/Humanize.ts';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/audio/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtD,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAChG,YAAY,EACX,QAAQ,EACR,SAAS,EACT,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,SAAS,EACT,aAAa,EACb,iBAAiB,GACjB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,YAAY,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/F,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACxF,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACnG,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAClD,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClF,YAAY,EACX,OAAO,EACP,QAAQ,EACR,aAAa,EACb,WAAW,EACX,SAAS,EACT,WAAW,EACX,eAAe,GACf,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAClF,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/audio/index.ts"],"names":[],"mappings":"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"}

package/dist/audio/index.js

@@ -8,5 +8,12 @@ export { parseMidi, scheduleMidi, noteToFrequency, midiLoopStart, MidiPlayer } f
 export { renderMidiToBuffer, renderMidiToBufferAsync } from './MidiRender.js';
 export { collectSoundFontUsage, parseSoundFont, subsetSoundFont } from './SoundFont.js';
 export { Channel, AudioBus } from './Channels.js';
+export { parseVorbisLoopTags, loopRegionFromTags } from './LoopTags.js';
 export { AudioListener, SoundSource, audioGain, audioPan } from './Positional.js';
+export { subdivisionCount, assertGrooveTemplate } from './humanize/Groove.js';
+export { LiteHumanizer } from './humanize/LiteHumanizer.js';
+export { GrooveHumanizer } from './humanize/GrooveHumanizer.js';
+export { GrooveExtractor } from './humanize/GrooveExtractor.js';
+export { GrooveConverter } from './humanize/GrooveConverter.js';
+export { HumanizerFactory, humanizeMidi } from './humanize/HumanizerFactory.js';
 //# sourceMappingURL=index.js.map

package/dist/audio/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/audio/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAahG,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE9E,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAExF,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAWlD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/audio/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAahG,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE9E,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAExF,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAYxE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAElF,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE9E,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/board/bitboard.d.ts

@@ -0,0 +1,132 @@
+import { type ChessSide, type ChessState, type PromotionKind } from './chess.ts';
+/**
+ * Chess on bitboards: the first slice of the tournament engine (item 390).
+ *
+ * Twelve 64-bit boards (`pieces[color * 6 + kind]`, white 0-5, black 6-11, square 0 is
+ * a1 exactly like `chess.ts`), side to move, castling rights, en passant square, the
+ * halfmove clock and both king squares. Everything in it is plain data (`bigint`
+ * included), so a position structured-clones into a worker untouched.
+ *
+ * Two implementations of the rules now exist on purpose: `chess.ts` is the readable
+ * reference a minigame runs directly, this one is the fast mutable board a search
+ * makes and unmakes millions of times. `tests/board-bitboard.test.ts` keeps them
+ * honest two ways: every legal move of one is a legal move of the other on a suite of
+ * positions, and perft counts match the published node counts.
+ */
+export interface BitboardState {
+    /** twelve bitboards: white pawn..king, then black pawn..king */
+    pieces: bigint[];
+    turn: ChessSide;
+    /** castling rights as a mask: 1 white kingside, 2 white queenside, 4 black kingside, 8 black queenside */
+    castling: number;
+    /** a square a pawn could capture onto, left behind by a double push */
+    enPassant: number | null;
+    halfmove: number;
+    /** king squares, white then black: maintained on every move, so checks never scan */
+    kings: [number, number];
+}
+export interface BitboardMove {
+    from: number;
+    to: number;
+    promotion?: PromotionKind;
+}
+/** everything `makeMove` changes besides the moved piece, handed back to `unmakeMove` */
+export interface BitboardUndo {
+    captured: {
+        color: 0 | 1;
+        kind: number;
+    } | null;
+    castling: number;
+    enPassant: number | null;
+    halfmove: number;
+    kingSquare: number;
+}
+/**
+ * Reads a `chess.ts` position onto bitboards: the bridge the differential tests cross
+ * in both directions, and the way a FEN reaches the fast board.
+ *
+ * @example
+ * ```ts
+ * import { bitboardFromChess, bitboardMoves, startingChess } from '@datamoc/mw_games/board';
+ *
+ * const moves = bitboardMoves(bitboardFromChess(startingChess()));
+ * console.log(moves.length); // 20 - the opening position's own count
+ * ```
+ */
+export declare function bitboardFromChess(state: ChessState): BitboardState;
+/**
+ * The standard opening array on bitboards, white to move with every right intact.
+ *
+ * @example
+ * ```ts
+ * import { bitboardMoves, startingBitboard } from '@datamoc/mw_games/board';
+ *
+ * console.log(bitboardMoves(startingBitboard()).length); // 20 - 16 pawn moves, 4 knight moves
+ * ```
+ */
+export declare function startingBitboard(): BitboardState;
+/**
+ * Every legal move for the side to play, in stable square order: pseudo-moves that leave
+ * their own king safe, each tried with `makeMove` and taken back with `unmakeMove`.
+ * Castling needs its rights, an empty passage and no check on the way over; en passant
+ * pins fall out of the make-and-test filter rather than special-casing.
+ *
+ * @example
+ * ```ts
+ * import { bitboardMoves, startingBitboard } from '@datamoc/mw_games/board';
+ *
+ * const moves = bitboardMoves(startingBitboard());
+ * console.log(moves.every((move) => move.from >= 0 && move.to < 64)); // true
+ * ```
+ */
+export declare function bitboardMoves(board: BitboardState): BitboardMove[];
+/**
+ * Plays a move, mutating the position, and returns what `unmakeMove` needs to take it
+ * back. Special moves are read off the position rather than flagged on the move: a pawn
+ * onto the en passant square captures the pawn behind it, a king stepping two squares
+ * swings its rook, a pawn stride of sixteen leaves a square behind it.
+ *
+ * @example
+ * ```ts
+ * import { bitboardMoves, makeMove, startingBitboard, unmakeMove } from '@datamoc/mw_games/board';
+ *
+ * const board = startingBitboard();
+ * const move = bitboardMoves(board)[0];
+ * const undo = makeMove(board, move);
+ * console.log(board.turn); // 'black' - the move is played
+ * unmakeMove(board, move, undo);
+ * ```
+ */
+export declare function makeMove(board: BitboardState, move: BitboardMove): BitboardUndo;
+/**
+ * Takes back exactly what `makeMove` played: the mover returns, the taken piece (or the
+ * en passant pawn behind the landing square) is restored, and rights, en passant
+ * square, halfmove clock and king square come back from the undo.
+ *
+ * @example
+ * ```ts
+ * import { bitboardMoves, makeMove, startingBitboard, unmakeMove } from '@datamoc/mw_games/board';
+ *
+ * const board = startingBitboard();
+ * const move = bitboardMoves(board)[0];
+ * const undo = makeMove(board, move);
+ * unmakeMove(board, move, undo);
+ * console.log(board.turn, bitboardMoves(board).length); // 'white' 20 - taken back whole
+ * ```
+ */
+export declare function unmakeMove(board: BitboardState, move: BitboardMove, undo: BitboardUndo): void;
+/**
+ * Move-generation node count: 1 at depth 0, else the sum over every legal move. The
+ * position is played and taken back as it goes, so it reads identical afterwards.
+ * Counts match the published perft numbers, which is the whole point: a wrong move
+ * generator cannot hide from them.
+ *
+ * @example
+ * ```ts
+ * import { perft, startingBitboard } from '@datamoc/mw_games/board';
+ *
+ * console.log(perft(startingBitboard(), 2)); // 400 - the opening's two-ply count
+ * ```
+ */
+export declare function perft(board: BitboardState, depth: number): number;
+//# sourceMappingURL=bitboard.d.ts.map

package/dist/board/bitboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitboard.d.ts","sourceRoot":"","sources":["../../src/board/bitboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhH;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,aAAa;IAC7B,gEAAgE;IAChE,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,EAAE,SAAS,CAAC;IAChB,0GAA0G;IAC1G,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,qFAAqF;IACrF,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,aAAa,CAAC;CAC1B;AAED,yFAAyF;AACzF,MAAM,WAAW,YAAY;IAC5B,QAAQ,EAAE;QAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACnB;AA6HD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,aAAa,CAsBlE;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,YAAY,EAAE,CA0BlE;AAyHD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,YAAY,GAAG,YAAY,CAyD/E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAiC7F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAUjE"}