@datamoc/mw_games 0.22.0 → 0.24.0

package/dist/audio/humanize/HumanizerFactory.d.ts

@@ -0,0 +1,68 @@
+import type { MidiFile } from '../Midi.ts';
+import { type HumanizationOptions, type HumanizerTier, type MidiHumanizerEngine } from './Humanize.ts';
+/**
+ * One entry point for "humanize this file", so a game never names the class that does the
+ * work. The tier decides the engine; everything else about the request is the same for
+ * both shipped tiers, which is why the request extends the options rather than wrapping
+ * them.
+ *
+ * The engines load on demand through dynamic import. That is a size decision, not a
+ * style one: `GrooveHumanizer`, the extractor and the converter are all reachable from a
+ * game that only ever wanted the lite tier, and none of them should be in the bundle
+ * merely for living in the same module. The magenta tier is the case where loading would
+ * never succeed at all: it needs `@magenta/music` and a PerformanceRNN checkpoint, and a
+ * `file://` build can fetch neither, so asking for it fails by name instead of hanging on
+ * a request that cannot resolve.
+ *
+ * @example
+ * ```ts
+ * import { HumanizerFactory, humanizeMidi, parseMidi } from '@datamoc/mw_games/audio';
+ *
+ * declare const midiBytes: ArrayBuffer;
+ *
+ * const file = parseMidi(midiBytes);
+ *
+ * //the convenience path: the tier follows from the request
+ * const lite = await humanizeMidi(file, { intensity: 0.5, seed: 1 });
+ *
+ * //or hold the engine, when several files go through the same one
+ * const engine = await HumanizerFactory.create('lite');
+ * const again = await engine.process(lite, { intensity: 0.5, seed: 2 });
+ *
+ * console.log(engine.tierName, engine.approximateSizeMb); // 'lite' 0.05
+ * ```
+ */
+export declare class HumanizerFactory {
+    /** resolves the engine for a tier and initializes it, so `process` can be called at once */
+    static create(tier: HumanizerTier): Promise<MidiHumanizerEngine>;
+    private static load;
+}
+export interface HumanizeRequest extends HumanizationOptions {
+    /**
+     * Which engine runs the request. Omitted, a request carrying a groove template picks
+     * `'groove'` and anything else picks `'lite'`, so the common case needs no tier at all.
+     */
+    tier?: HumanizerTier;
+}
+/**
+ * Humanizes in one call: resolves the tier, runs it, returns the new file.
+ *
+ * @example
+ * ```ts
+ * import { humanizeMidi, parseMidi, type GrooveTemplate } from '@datamoc/mw_games/audio';
+ *
+ * declare const midiBytes: ArrayBuffer;
+ * declare const template: GrooveTemplate;
+ *
+ * const file = parseMidi(midiBytes);
+ * const swung = await humanizeMidi(file, {
+ *   tier: 'groove',
+ *   intensity: 0.7,
+ *   grooveTemplate: template,
+ *   seed: 99,
+ *   onWarn: (message) => console.log(message), // a template from another tempo says so
+ * });
+ * ```
+ */
+export declare function humanizeMidi(midi: MidiFile, request: HumanizeRequest): Promise<MidiFile>;
+//# sourceMappingURL=HumanizerFactory.d.ts.map

package/dist/audio/humanize/HumanizerFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HumanizerFactory.d.ts","sourceRoot":"","sources":["../../../src/audio/humanize/HumanizerFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,KAAK,mBAAmB,EAAE,KAAK,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEvG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,gBAAgB;IAC5B,4FAA4F;IAC5F,OAAa,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAIrE;mBAEoB,IAAI;CAkBzB;AAED,MAAM,WAAW,eAAgB,SAAQ,mBAAmB;IAC3D;;;OAGG;IACH,IAAI,CAAC,EAAE,aAAa,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,CAK9F"}

package/dist/audio/humanize/HumanizerFactory.js

@@ -0,0 +1,84 @@
+import {} from './Humanize.js';
+/**
+ * One entry point for "humanize this file", so a game never names the class that does the
+ * work. The tier decides the engine; everything else about the request is the same for
+ * both shipped tiers, which is why the request extends the options rather than wrapping
+ * them.
+ *
+ * The engines load on demand through dynamic import. That is a size decision, not a
+ * style one: `GrooveHumanizer`, the extractor and the converter are all reachable from a
+ * game that only ever wanted the lite tier, and none of them should be in the bundle
+ * merely for living in the same module. The magenta tier is the case where loading would
+ * never succeed at all: it needs `@magenta/music` and a PerformanceRNN checkpoint, and a
+ * `file://` build can fetch neither, so asking for it fails by name instead of hanging on
+ * a request that cannot resolve.
+ *
+ * @example
+ * ```ts
+ * import { HumanizerFactory, humanizeMidi, parseMidi } from '@datamoc/mw_games/audio';
+ *
+ * declare const midiBytes: ArrayBuffer;
+ *
+ * const file = parseMidi(midiBytes);
+ *
+ * //the convenience path: the tier follows from the request
+ * const lite = await humanizeMidi(file, { intensity: 0.5, seed: 1 });
+ *
+ * //or hold the engine, when several files go through the same one
+ * const engine = await HumanizerFactory.create('lite');
+ * const again = await engine.process(lite, { intensity: 0.5, seed: 2 });
+ *
+ * console.log(engine.tierName, engine.approximateSizeMb); // 'lite' 0.05
+ * ```
+ */
+export class HumanizerFactory {
+    /** resolves the engine for a tier and initializes it, so `process` can be called at once */
+    static async create(tier) {
+        const engine = await HumanizerFactory.load(tier);
+        await engine.initialize();
+        return engine;
+    }
+    static async load(tier) {
+        switch (tier) {
+            case 'lite': {
+                const module = await import('./LiteHumanizer.js');
+                return new module.LiteHumanizer();
+            }
+            case 'groove': {
+                const module = await import('./GrooveHumanizer.js');
+                return new module.GrooveHumanizer();
+            }
+            case 'magenta':
+                throw new Error("the 'magenta' tier is not shipped: it needs @magenta/music and a PerformanceRNN checkpoint, and neither can be fetched from a file:// build");
+            default:
+                throw new Error(`unknown humanizer tier: ${String(tier)}`);
+        }
+    }
+}
+/**
+ * Humanizes in one call: resolves the tier, runs it, returns the new file.
+ *
+ * @example
+ * ```ts
+ * import { humanizeMidi, parseMidi, type GrooveTemplate } from '@datamoc/mw_games/audio';
+ *
+ * declare const midiBytes: ArrayBuffer;
+ * declare const template: GrooveTemplate;
+ *
+ * const file = parseMidi(midiBytes);
+ * const swung = await humanizeMidi(file, {
+ *   tier: 'groove',
+ *   intensity: 0.7,
+ *   grooveTemplate: template,
+ *   seed: 99,
+ *   onWarn: (message) => console.log(message), // a template from another tempo says so
+ * });
+ * ```
+ */
+export async function humanizeMidi(midi, request) {
+    const { tier, ...options } = request;
+    const chosen = tier ?? (options.grooveTemplate ? 'groove' : 'lite');
+    const engine = await HumanizerFactory.create(chosen);
+    return engine.process(midi, options);
+}
+//# sourceMappingURL=HumanizerFactory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HumanizerFactory.js","sourceRoot":"","sources":["../../../src/audio/humanize/HumanizerFactory.ts"],"names":[],"mappings":"AACA,OAAO,EAA0E,MAAM,eAAe,CAAC;AAEvG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,OAAO,gBAAgB;IAC5B,4FAA4F;IAC5F,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAmB;QACtC,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC;IACf,CAAC;IAEO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAmB;QAC5C,QAAQ,IAAI,EAAE,CAAC;YACd,KAAK,MAAM,EAAE,CAAC;gBACb,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;gBAClD,OAAO,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;YACnC,CAAC;YACD,KAAK,QAAQ,EAAE,CAAC;gBACf,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;gBACpD,OAAO,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;YACrC,CAAC;YACD,KAAK,SAAS;gBACb,MAAM,IAAI,KAAK,CACd,6IAA6I,CAC7I,CAAC;YACH;gBACC,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC7D,CAAC;IACF,CAAC;CACD;AAUD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAc,EAAE,OAAwB;IAC1E,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACrD,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACtC,CAAC"}

package/dist/audio/humanize/LiteHumanizer.d.ts

@@ -0,0 +1,30 @@
+import type { MidiFile } from '../Midi.ts';
+import { type HumanizationOptions, type MidiHumanizerEngine } from './Humanize.ts';
+/**
+ * Tier 1: every note gets a seeded gaussian nudge plus a slow correlated drift, and
+ * nothing else. No grid, no model, no I/O - which is exactly why it is the tier a shipped
+ * game can afford to call, and why it has to refuse a groove template rather than quietly
+ * ignore one: a template passed here is a caller who picked the wrong tier.
+ *
+ * @example
+ * ```ts
+ * import { parseMidi, LiteHumanizer } from '@datamoc/mw_games/audio';
+ *
+ * declare const midiBytes: ArrayBuffer;
+ *
+ * const file = parseMidi(midiBytes);
+ * const humanized = await new LiteHumanizer().process(file, {
+ *   intensity: 0.6,
+ *   timingVarianceMs: 6,
+ *   seed: 42, // the same seed gives back the same performance every time
+ * });
+ * ```
+ */
+export declare class LiteHumanizer implements MidiHumanizerEngine {
+    readonly tierName = "lite";
+    readonly approximateSizeMb = 0.05;
+    /** nothing heavy to load: the tier is the pass, already in the bundle */
+    initialize(): Promise<void>;
+    process(midi: MidiFile, options: HumanizationOptions): Promise<MidiFile>;
+}
+//# sourceMappingURL=LiteHumanizer.d.ts.map

package/dist/audio/humanize/LiteHumanizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiteHumanizer.d.ts","sourceRoot":"","sources":["../../../src/audio/humanize/LiteHumanizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAqB,KAAK,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEtG;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,aAAc,YAAW,mBAAmB;IACxD,QAAQ,CAAC,QAAQ,UAAU;IAC3B,QAAQ,CAAC,iBAAiB,QAAQ;IAElC,yEAAyE;IACnE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAG;IAE9B,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAM7E;CACD"}

package/dist/audio/humanize/LiteHumanizer.js

@@ -0,0 +1,35 @@
+import { applyHumanization } from './Humanize.js';
+/**
+ * Tier 1: every note gets a seeded gaussian nudge plus a slow correlated drift, and
+ * nothing else. No grid, no model, no I/O - which is exactly why it is the tier a shipped
+ * game can afford to call, and why it has to refuse a groove template rather than quietly
+ * ignore one: a template passed here is a caller who picked the wrong tier.
+ *
+ * @example
+ * ```ts
+ * import { parseMidi, LiteHumanizer } from '@datamoc/mw_games/audio';
+ *
+ * declare const midiBytes: ArrayBuffer;
+ *
+ * const file = parseMidi(midiBytes);
+ * const humanized = await new LiteHumanizer().process(file, {
+ *   intensity: 0.6,
+ *   timingVarianceMs: 6,
+ *   seed: 42, // the same seed gives back the same performance every time
+ * });
+ * ```
+ */
+export class LiteHumanizer {
+    constructor() {
+        this.tierName = 'lite';
+        this.approximateSizeMb = 0.05;
+    }
+    /** nothing heavy to load: the tier is the pass, already in the bundle */
+    async initialize() { }
+    async process(midi, options) {
+        if (options.grooveTemplate)
+            throw new Error('the lite tier applies no groove grid: ask HumanizerFactory for "groove" when a template is in play');
+        return applyHumanization(midi, options, 'lite');
+    }
+}
+//# sourceMappingURL=LiteHumanizer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LiteHumanizer.js","sourceRoot":"","sources":["../../../src/audio/humanize/LiteHumanizer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAsD,MAAM,eAAe,CAAC;AAEtG;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,aAAa;IAA1B;QACU,aAAQ,GAAG,MAAM,CAAC;QAClB,sBAAiB,GAAG,IAAI,CAAC;IAYnC,CAAC;IAVA,yEAAyE;IACzE,KAAK,CAAC,UAAU,KAAmB,CAAC;IAEpC,KAAK,CAAC,OAAO,CAAC,IAAc,EAAE,OAA4B;QACzD,IAAI,OAAO,CAAC,cAAc;YACzB,MAAM,IAAI,KAAK,CACd,oGAAoG,CACpG,CAAC;QACH,OAAO,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACjD,CAAC;CACD"}

package/dist/audio/humanize/Onsets.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 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.
+ */
+/**
+ * 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 declare function detectOnsets(samples: Float32Array, sampleRate: number): number[];
+//# sourceMappingURL=Onsets.d.ts.map

package/dist/audio/humanize/Onsets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Onsets.d.ts","sourceRoot":"","sources":["../../../src/audio/humanize/Onsets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA0EH;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAwEhF"}

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":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,KAAK,GAAG,GAAG,CAAC;AAClB,MAAM,GAAG,GAAG,EAAE,CAAC;AACf,0EAA0E;AAC1E,MAAM,aAAa,GAAG,EAAE,CAAC;AACzB;;;;GAIG;AACH,MAAM,WAAW,GAAG,CAAC,CAAC;AACtB;;;;;;;GAOG;AACH,MAAM,WAAW,GAAG,IAAI,CAAC;AACzB,iFAAiF;AACjF,MAAM,cAAc,GAAG,CAAC,CAAC;AACzB,0FAA0F;AAC1F,MAAM,eAAe,GAAG,KAAK,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;AAE5C,yFAAyF;AACzF,SAAS,GAAG,CAAC,IAAkB,EAAE,SAAuB;IACvD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAE3B,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACjC,IAAI,GAAG,GAAG,MAAM,IAAI,CAAC,CAAC;QACtB,OAAO,CAAC,GAAG,GAAG,EAAE,CAAC;YAChB,CAAC,IAAI,GAAG,CAAC;YACT,GAAG,KAAK,CAAC,CAAC;QACX,CAAC;QACD,CAAC,IAAI,GAAG,CAAC;QACT,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACX,IAAI,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACnB,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;YACf,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YACpB,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YAC5B,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;QACrB,CAAC;IACF,CAAC;IAED,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,MAAM,EAAE,IAAI,KAAK,CAAC,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC;QACvB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,EAAE,KAAK,IAAI,IAAI,EAAE,CAAC;YACnD,IAAI,UAAU,GAAG,CAAC,CAAC;YACnB,IAAI,eAAe,GAAG,CAAC,CAAC;YACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC/B,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC;gBACvB,MAAM,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;gBACxB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC;gBAC1E,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,eAAe,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;gBAC/E,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;gBACjC,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC;gBAChD,IAAI,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC;gBACtB,SAAS,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC;gBAEhC,MAAM,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,eAAe,GAAG,aAAa,CAAC;gBACzE,eAAe,GAAG,UAAU,GAAG,aAAa,GAAG,eAAe,GAAG,QAAQ,CAAC;gBAC1E,UAAU,GAAG,QAAQ,CAAC;YACvB,CAAC;QACF,CAAC;IACF,CAAC;AACF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,OAAqB,EAAE,UAAkB;IACrE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,UAAU,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAEvD,MAAM,GAAG,GAAG,KAAK,GAAG,CAAC,CAAC;IACtB,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC;IAC1D,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAEzB,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC;IACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE;QAAE,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;IAElG,MAAM,IAAI,GAAG,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,cAAc,GAAG,CAAC,CAAC;IAEvB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,GAAG,EAAE,CAAC;QAClE,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAChC,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YACxC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACjB,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QACD,kFAAkF;QAClF,gEAAgE;QAChE,UAAU,CAAC,IAAI,CAAC,cAAc,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,cAAc,GAAG,CAAC,CAAC,CAAC;QACpG,cAAc,GAAG,MAAM,CAAC;QAExB,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAErB,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;YACpD,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC3C,IAAI,UAAU,GAAG,CAAC;gBAAE,IAAI,IAAI,UAAU,CAAC;YACvC,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;QACzB,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IAED,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,SAAS,GAAG,CAAC,QAAQ,CAAC;IAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC;QAC5C,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC;QACxD,MAAM,IAAI,GAAG,EAAE,GAAG,IAAI,GAAG,CAAC,CAAC;QAE3B,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,KAAK,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE;YAAE,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;QACjD,IAAI,IAAI,IAAI,CAAC;QAEb,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,KAAK,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE;YAAE,QAAQ,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;QACnE,MAAM,SAAS,GAAG,IAAI,GAAG,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;QAElE,+EAA+E;QAC/E,4EAA4E;QAC5E,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,SAAS;YAAE,SAAS;QAClD,wEAAwE;QACxE,IAAI,UAAU,CAAC,CAAC,CAAC,GAAG,WAAW,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,WAAW,CAAC;YAAE,SAAS;QAC1F,6EAA6E;QAC7E,mEAAmE;QACnE,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;YAAE,SAAS;QAC7C,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;YAAE,SAAS;QAC5D,IAAI,CAAC,GAAG,SAAS,GAAG,cAAc;YAAE,SAAS;QAE7C,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,eAAe,CAAC,GAAG,UAAU,CAAC;QAC5D,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;QAC/B,SAAS,GAAG,CAAC,CAAC;IACf,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/audio/index.d.ts

@@ -23,4 +23,15 @@ export type { LoopRegion, ChannelPlayOptions, ChannelState, BusMixerLevel } from
 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,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACjG,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

@@ -10,4 +10,10 @@ export { collectSoundFontUsage, parseSoundFont, subsetSoundFont } from './SoundF
 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;AAClD,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAYxE,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/tourney.d.ts

@@ -23,6 +23,11 @@ export interface TourneyResult {
     nodes: number;
     /** the deepest fully completed iteration */
     depth: number;
+    /** async search only: every legal root move and its score from the side to move's view, in root order */
+    rootScores?: Array<{
+        move: BitboardMove;
+        score: number;
+    }>;
 }
 /**
  * The tournament engine's serializable task: a full iterative-deepening search over a
@@ -75,7 +80,9 @@ export declare function searchTourney(state: ChessState | BitboardState, options
  * is a self-contained `tourneyThink` task over a structured-cloned bitboard, scored
  * concurrently down a capped lane queue; the best child score from the opponent's
  * view is the worst for us, so the root plays the move whose child scored lowest,
- * with ties going to the earlier root move. An aborting signal rejects through
+ * with ties going to the earlier root move. `rootScores` exposes every candidate so
+ * games can choose near-best moves without repeating the search on the UI thread.
+ * An aborting signal rejects through
  * `threads.spawn` and terminates the workers.
  *
  * @example

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

@@ -1 +1 @@
-{"version":3,"file":"tourney.d.ts","sourceRoot":"","sources":["../../src/board/tourney.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C,MAAM,WAAW,cAAc;IAC9B,wFAAwF;IACxF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sFAAsF;IACtF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yFAAyF;IACzF,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,mBAAoB,SAAQ,cAAc;IAC1D,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC7B,sDAAsD;IACtD,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IAC1B,6FAA6F;IAC7F,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAC3B,QAAQ,EAAE,aAAa,EACvB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GACxF,aAAa,CAo0Bf;AAcD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,aAAa,EAAE,OAAO,GAAE,cAAmB,GAAG,aAAa,CAO5G;AAuBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,kBAAkB,CACvC,KAAK,EAAE,UAAU,GAAG,aAAa,EACjC,OAAO,GAAE,mBAAwB,GAC/B,OAAO,CAAC,aAAa,CAAC,CA+CxB"}
+{"version":3,"file":"tourney.d.ts","sourceRoot":"","sources":["../../src/board/tourney.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C,MAAM,WAAW,cAAc;IAC9B,wFAAwF;IACxF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sFAAsF;IACtF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yFAAyF;IACzF,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,mBAAoB,SAAQ,cAAc;IAC1D,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC7B,sDAAsD;IACtD,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IAC1B,6FAA6F;IAC7F,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,yGAAyG;IACzG,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,YAAY,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAC3B,QAAQ,EAAE,aAAa,EACvB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GACxF,aAAa,CAo0Bf;AAcD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,aAAa,EAAE,OAAO,GAAE,cAAmB,GAAG,aAAa,CAO5G;AAuBD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,kBAAkB,CACvC,KAAK,EAAE,UAAU,GAAG,aAAa,EACjC,OAAO,GAAE,mBAAwB,GAC/B,OAAO,CAAC,aAAa,CAAC,CAmDxB"}

package/dist/board/tourney.js

@@ -952,7 +952,9 @@ function defaultTourneyJobs() {
  * is a self-contained `tourneyThink` task over a structured-cloned bitboard, scored
  * concurrently down a capped lane queue; the best child score from the opponent's
  * view is the worst for us, so the root plays the move whose child scored lowest,
- * with ties going to the earlier root move. An aborting signal rejects through
+ * with ties going to the earlier root move. `rootScores` exposes every candidate so
+ * games can choose near-best moves without repeating the search on the UI thread.
+ * An aborting signal rejects through
  * `threads.spawn` and terminates the workers.
  *
  * @example
@@ -974,7 +976,7 @@ export async function searchTourneyAsync(state, options = {}) {
     const root = toBitboard(state);
     const moves = bitboardMoves(root);
     if (!moves.length)
-        return tourneyThink(root, { depth, maxNodes });
+        return { ...tourneyThink(root, { depth, maxNodes }), rootScores: [] };
     //one chain per lane over the shared move queue, the tools/compress-dist.mjs shape:
     //scores land by index, so ties break in root order no matter who finishes first
     const lanes = Math.max(1, Math.min(jobs, moves.length));
@@ -1008,6 +1010,10 @@ export async function searchTourneyAsync(state, options = {}) {
         score: scores[bestIndex] ?? 0,
         nodes,
         depth,
+        rootScores: moves.map((move, index) => ({
+            move: { from: move.from, to: move.to, ...(move.promotion ? { promotion: move.promotion } : {}) },
+            score: scores[index] ?? 0,
+        })),
     };
 }
 //# sourceMappingURL=tourney.js.map