tuner-core 2026.4.2

package/dist/detectors/pyin.js

@@ -0,0 +1,205 @@
+import { frequencyToMidi, midiToFrequency } from '../notes.js';
+import { computeYinCmnd, yinAtTau } from './yin-cmnd.js';
+const LOG_FLOOR = -1e8;
+/**
+ * Probabilistic YIN–style observations + discrete-pitch HMM (Viterbi forward step).
+ * Stateful: call `reset()` when stopping capture so the Markov chain does not bridge sessions.
+ */
+export class PyinDetector {
+    minFrequency;
+    maxFrequency;
+    rmsThreshold;
+    yinSharpness;
+    transitionSigmaSemitones;
+    maxJumpSemitones;
+    logPitchToUv;
+    logUvToPitch;
+    logUvToUv;
+    firstDipSemitoneWeight;
+    firstDipThreshold;
+    midiMin;
+    midiMax;
+    nPitch;
+    uvIndex;
+    nStates;
+    prevLog;
+    hasPrev = false;
+    constructor(options = {}) {
+        this.minFrequency = options.minFrequency ?? 60;
+        this.maxFrequency = options.maxFrequency ?? 1400;
+        this.rmsThreshold = options.rmsThreshold ?? 0.01;
+        this.yinSharpness = options.yinSharpness ?? 12;
+        this.transitionSigmaSemitones = options.transitionSigmaSemitones ?? 1.35;
+        this.maxJumpSemitones = options.maxJumpSemitones ?? 10;
+        this.logPitchToUv = options.logPitchToUv ?? -3.2;
+        this.logUvToPitch = options.logUvToPitch ?? -2.8;
+        this.logUvToUv = options.logUvToUv ?? -0.15;
+        this.firstDipSemitoneWeight = options.firstDipSemitoneWeight ?? 0.14;
+        this.firstDipThreshold = options.firstDipThreshold ?? 0.18;
+        this.midiMin = Math.floor(frequencyToMidi(this.minFrequency));
+        this.midiMax = Math.ceil(frequencyToMidi(this.maxFrequency));
+        this.nPitch = this.midiMax - this.midiMin + 1;
+        this.uvIndex = this.nPitch;
+        this.nStates = this.nPitch + 1;
+        this.prevLog = new Float32Array(this.nStates);
+    }
+    reset() {
+        this.hasPrev = false;
+        this.prevLog.fill(0);
+    }
+    detect(samples, sampleRate) {
+        const cmnd = computeYinCmnd(samples, sampleRate, this.minFrequency, this.maxFrequency);
+        if (!cmnd) {
+            this.hasPrev = false;
+            return { frequency: null, confidence: 0 };
+        }
+        if (cmnd.rms < this.rmsThreshold) {
+            this.hasPrev = false;
+            return { frequency: null, confidence: 0 };
+        }
+        const { yin, tauMin, tauMax } = cmnd;
+        let yMin = 1;
+        for (let tau = tauMin; tau <= tauMax; tau++) {
+            yMin = Math.min(yMin, yin[tau] ?? 1);
+        }
+        const midiHint = firstDipMidiHint(yin, tauMin, tauMax, sampleRate, this.firstDipThreshold);
+        const emitPitch = new Float32Array(this.nPitch);
+        for (let i = 0; i < this.nPitch; i++) {
+            const midi = this.midiMin + i;
+            const f = midiToFrequency(midi);
+            if (f < this.minFrequency || f > this.maxFrequency) {
+                emitPitch[i] = LOG_FLOOR;
+                continue;
+            }
+            const tau = sampleRate / f;
+            if (tau < tauMin || tau > tauMax) {
+                emitPitch[i] = LOG_FLOOR;
+                continue;
+            }
+            const y = yinAtTau(yin, tauMax, tau);
+            let logP = -this.yinSharpness * y;
+            if (midiHint !== null) {
+                const dm = midi - midiHint;
+                logP -= this.firstDipSemitoneWeight * dm * dm;
+            }
+            emitPitch[i] = logP;
+        }
+        const emitUv = -this.yinSharpness * (0.35 + 0.65 * yMin);
+        const cur = new Float32Array(this.nStates);
+        const twoSigma2 = 2 * this.transitionSigmaSemitones * this.transitionSigmaSemitones;
+        if (!this.hasPrev) {
+            const uniform = -Math.log(this.nStates);
+            for (let j = 0; j < this.nPitch; j++) {
+                cur[j] = uniform + (emitPitch.at(j) ?? LOG_FLOOR);
+            }
+            cur[this.uvIndex] = uniform + emitUv;
+            this.hasPrev = true;
+        }
+        else {
+            for (let j = 0; j < this.nPitch; j++) {
+                let best = LOG_FLOOR;
+                const mj = this.midiMin + j;
+                for (let i = 0; i < this.nPitch; i++) {
+                    const mi = this.midiMin + i;
+                    const dj = Math.abs(mi - mj);
+                    if (dj > this.maxJumpSemitones) {
+                        continue;
+                    }
+                    const trans = -(dj * dj) / twoSigma2;
+                    const v = (this.prevLog.at(i) ?? LOG_FLOOR) + trans;
+                    if (v > best) {
+                        best = v;
+                    }
+                }
+                const fromUv = (this.prevLog.at(this.uvIndex) ?? LOG_FLOOR) + this.logUvToPitch;
+                if (fromUv > best) {
+                    best = fromUv;
+                }
+                cur[j] = best + (emitPitch.at(j) ?? LOG_FLOOR);
+            }
+            let bestUv = LOG_FLOOR;
+            for (let i = 0; i < this.nPitch; i++) {
+                const v = (this.prevLog.at(i) ?? LOG_FLOOR) + this.logPitchToUv;
+                if (v > bestUv) {
+                    bestUv = v;
+                }
+            }
+            const uvStay = (this.prevLog.at(this.uvIndex) ?? LOG_FLOOR) + this.logUvToUv;
+            if (uvStay > bestUv) {
+                bestUv = uvStay;
+            }
+            cur[this.uvIndex] = bestUv + emitUv;
+        }
+        let bestIdx = 0;
+        let bestVal = cur.at(0) ?? LOG_FLOOR;
+        for (let j = 1; j < this.nStates; j++) {
+            const cj = cur.at(j) ?? LOG_FLOOR;
+            if (cj > bestVal) {
+                bestVal = cj;
+                bestIdx = j;
+            }
+        }
+        for (let j = 0; j < this.nStates; j++) {
+            this.prevLog[j] = cur.at(j) ?? LOG_FLOOR;
+        }
+        if (bestIdx === this.uvIndex) {
+            const second = this.secondBestLog(cur, this.uvIndex);
+            const confidence = logProbToConfidence(bestVal, second);
+            return { frequency: null, confidence };
+        }
+        const midi = this.midiMin + bestIdx;
+        const frequency = midiToFrequency(midi);
+        const second = this.secondBestLog(cur, bestIdx);
+        const confidence = logProbToConfidence(bestVal, second);
+        return { frequency, confidence };
+    }
+    secondBestLog(cur, exclude) {
+        let s = LOG_FLOOR;
+        for (let j = 0; j < this.nStates; j++) {
+            if (j === exclude) {
+                continue;
+            }
+            const cj = cur.at(j) ?? LOG_FLOOR;
+            if (cj > s) {
+                s = cj;
+            }
+        }
+        return s;
+    }
+}
+function logProbToConfidence(best, second) {
+    const margin = best - second;
+    const c = 1 / (1 + Math.exp(-margin));
+    return Math.max(0, Math.min(1, c));
+}
+/** MIDI note at the first YIN dip (classic YIN τ pick), for a subharmonic-resistant hint */
+function firstDipMidiHint(yin, tauMin, tauMax, sampleRate, threshold) {
+    let bestTau = -1;
+    for (let tau = tauMin; tau <= tauMax; tau++) {
+        const y = yin[tau] ?? 1;
+        if (y < threshold) {
+            let t = tau;
+            while (t + 1 <= tauMax && (yin[t + 1] ?? 1) < (yin[t] ?? 1)) {
+                t++;
+            }
+            bestTau = t;
+            break;
+        }
+    }
+    if (bestTau < 0) {
+        return null;
+    }
+    let refinedTau = bestTau;
+    if (bestTau > 1 && bestTau < tauMax) {
+        const y0 = yin[bestTau - 1] ?? 1;
+        const y1 = yin[bestTau] ?? 1;
+        const y2 = yin[bestTau + 1] ?? 1;
+        const denom = y0 - 2 * y1 + y2;
+        if (Math.abs(denom) > 1e-14) {
+            const offset = (y0 - y2) / (2 * denom);
+            refinedTau = bestTau + Math.max(-1, Math.min(1, offset));
+        }
+    }
+    return frequencyToMidi(sampleRate / refinedTau);
+}
+//# sourceMappingURL=pyin.js.map

package/dist/detectors/pyin.js.map

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

package/dist/detectors/yin-cmnd.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Shared YIN cumulative mean normalized difference (Cheveigné & Kawahara).
+ * Used by YinDetector and PyinDetector.
+ */
+export interface YinCmndBuffer {
+    yin: Float32Array;
+    tauMin: number;
+    tauMax: number;
+    rms: number;
+}
+export declare function computeYinCmnd(samples: Float32Array, sampleRate: number, minFrequency: number, maxFrequency: number): YinCmndBuffer | null;
+export declare function yinAtTau(yin: Float32Array, tauMax: number, tau: number): number;
+//# sourceMappingURL=yin-cmnd.d.ts.map

package/dist/detectors/yin-cmnd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yin-cmnd.d.ts","sourceRoot":"","sources":["../../src/detectors/yin-cmnd.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,YAAY,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,YAAY,EACrB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,GACnB,aAAa,GAAG,IAAI,CAwCtB;AAED,wBAAgB,QAAQ,CACtB,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,MAAM,CAWR"}

package/dist/detectors/yin-cmnd.js

@@ -0,0 +1,53 @@
+/**
+ * Shared YIN cumulative mean normalized difference (Cheveigné & Kawahara).
+ * Used by YinDetector and PyinDetector.
+ */
+export function computeYinCmnd(samples, sampleRate, minFrequency, maxFrequency) {
+    const n = samples.length;
+    if (n < 4) {
+        return null;
+    }
+    let rms = 0;
+    for (let i = 0; i < n; i++) {
+        const v = samples[i] ?? 0;
+        rms += v * v;
+    }
+    rms = Math.sqrt(rms / n);
+    const tauMin = Math.max(1, Math.ceil(sampleRate / maxFrequency));
+    const tauMaxFreq = Math.floor(sampleRate / minFrequency);
+    const tauMaxWin = Math.floor(n / 2) - 1;
+    const tauMax = Math.min(tauMaxFreq, tauMaxWin);
+    if (tauMin > tauMax) {
+        return null;
+    }
+    const d = new Float32Array(tauMax + 1);
+    for (let tau = 1; tau <= tauMax; tau++) {
+        let sum = 0;
+        for (let j = 0; j < n - tau; j++) {
+            const diff = (samples[j] ?? 0) - (samples[j + tau] ?? 0);
+            sum += diff * diff;
+        }
+        d[tau] = sum;
+    }
+    const yin = new Float32Array(tauMax + 1);
+    yin[0] = 1;
+    let running = 0;
+    for (let tau = 1; tau <= tauMax; tau++) {
+        running += d[tau] ?? 0;
+        yin[tau] = running > 0 ? ((d[tau] ?? 0) * tau) / running : 1;
+    }
+    return { yin, tauMin, tauMax, rms };
+}
+export function yinAtTau(yin, tauMax, tau) {
+    if (tau <= 1) {
+        return yin[1] ?? 1;
+    }
+    if (tau >= tauMax) {
+        return yin[tauMax] ?? 1;
+    }
+    const t0 = Math.floor(tau);
+    const t1 = t0 + 1;
+    const f = tau - t0;
+    return (yin[t0] ?? 1) * (1 - f) + (yin[t1] ?? 1) * f;
+}
+//# sourceMappingURL=yin-cmnd.js.map

package/dist/detectors/yin-cmnd.js.map

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

package/dist/detectors/yin.d.ts

@@ -0,0 +1,20 @@
+import type { PitchDetection, PitchDetector } from '../types.js';
+/**
+ * YIN pitch estimator (Cheveigné & Kawahara).
+ * Generally more robust than raw autocorrelation on real signals, especially low notes.
+ */
+export declare class YinDetector implements PitchDetector {
+    private readonly minFrequency;
+    private readonly maxFrequency;
+    /** Cumulative mean normalized difference; typical 0.10–0.20 */
+    private readonly threshold;
+    private readonly rmsThreshold;
+    constructor({ minFrequency, maxFrequency, threshold, rmsThreshold, }?: {
+        minFrequency?: number | undefined;
+        maxFrequency?: number | undefined;
+        threshold?: number | undefined;
+        rmsThreshold?: number | undefined;
+    });
+    detect(samples: Float32Array, sampleRate: number): PitchDetection;
+}
+//# sourceMappingURL=yin.d.ts.map

package/dist/detectors/yin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yin.d.ts","sourceRoot":"","sources":["../../src/detectors/yin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAGhE;;;GAGG;AACH,qBAAa,WAAY,YAAW,aAAa;IAC/C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;IACrC,+DAA+D;IAC/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;gBAEzB,EACV,YAAiB,EACjB,YAAmB,EACnB,SAAgB,EAChB,YAAmB,GACpB;;;;;KAAK;IAON,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc;CA0DlE"}

package/dist/detectors/yin.js

@@ -0,0 +1,66 @@
+import { computeYinCmnd } from './yin-cmnd.js';
+/**
+ * YIN pitch estimator (Cheveigné & Kawahara).
+ * Generally more robust than raw autocorrelation on real signals, especially low notes.
+ */
+export class YinDetector {
+    minFrequency;
+    maxFrequency;
+    /** Cumulative mean normalized difference; typical 0.10–0.20 */
+    threshold;
+    rmsThreshold;
+    constructor({ minFrequency = 60, maxFrequency = 1400, threshold = 0.15, rmsThreshold = 0.01, } = {}) {
+        this.minFrequency = minFrequency;
+        this.maxFrequency = maxFrequency;
+        this.threshold = threshold;
+        this.rmsThreshold = rmsThreshold;
+    }
+    detect(samples, sampleRate) {
+        const cmnd = computeYinCmnd(samples, sampleRate, this.minFrequency, this.maxFrequency);
+        if (!cmnd || cmnd.rms < this.rmsThreshold) {
+            return { frequency: null, confidence: 0 };
+        }
+        const { yin, tauMin, tauMax } = cmnd;
+        let bestTau = -1;
+        let bestVal = 1;
+        for (let tau = tauMin; tau <= tauMax; tau++) {
+            const y = yin[tau] ?? 1;
+            if (y < this.threshold) {
+                let t = tau;
+                while (t + 1 <= tauMax && (yin[t + 1] ?? 1) < (yin[t] ?? 1)) {
+                    t++;
+                }
+                bestTau = t;
+                bestVal = yin[t] ?? 1;
+                break;
+            }
+        }
+        if (bestTau < 0 || bestVal >= this.threshold || !Number.isFinite(bestVal)) {
+            const confidence = Number.isFinite(bestVal)
+                ? Math.max(0, Math.min(1, 1 - bestVal))
+                : 0;
+            return { frequency: null, confidence };
+        }
+        let refinedTau = bestTau;
+        if (bestTau > 1 && bestTau < tauMax) {
+            const y0 = yin[bestTau - 1] ?? 1;
+            const y1 = yin[bestTau] ?? 1;
+            const y2 = yin[bestTau + 1] ?? 1;
+            const denom = y0 - 2 * y1 + y2;
+            if (Math.abs(denom) > 1e-14) {
+                const offset = (y0 - y2) / (2 * denom);
+                refinedTau = bestTau + Math.max(-1, Math.min(1, offset));
+            }
+        }
+        const frequency = sampleRate / refinedTau;
+        if (frequency < this.minFrequency || frequency > this.maxFrequency) {
+            return {
+                frequency: null,
+                confidence: Math.max(0, Math.min(1, 1 - bestVal)),
+            };
+        }
+        const confidence = Math.max(0, Math.min(1, 1 - bestVal));
+        return { frequency, confidence };
+    }
+}
+//# sourceMappingURL=yin.js.map

package/dist/detectors/yin.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export type { AudioProvider, PitchDetection, PitchDetector, StringDef, Tuning, Instrument, ClosestString, TunerResult, HapticsProvider, UserPreferences, PreferencesProvider, TunerEventMap, TunerEventListener, } from './types.js';
+export { TunerSession } from './session.js';
+export { frequencyToMidi, midiToFrequency, midiToNote, midiToOctave, getCents, getCentsFromTarget, } from './notes.js';
+export { AutocorrelationDetector } from './detectors/autocorrelation.js';
+export { YinDetector } from './detectors/yin.js';
+export { PyinDetector } from './detectors/pyin.js';
+export { MpmDetector } from './detectors/mpm.js';
+export { createPitchDetector } from './detectors/create-pitch-detector.js';
+export { INSTRUMENTS, findInstrument, findTuning } from './tunings.js';
+export { DEFAULT_PREFERENCES } from './preferences.js';
+export type { TunerSettings, DetectorSettings, PitchDetectorKind, PyinHMMSettings, } from './tuner-settings.js';
+export { DEFAULT_TUNER_SETTINGS, mergeTunerSettings, applySettingsPatch, } from './tuner-settings.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,aAAa,EACb,cAAc,EACd,aAAa,EACb,SAAS,EACT,MAAM,EACN,UAAU,EACV,aAAa,EACb,WAAW,EACX,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,kBAAkB,GACnB,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAG3C,OAAO,EACL,eAAe,EACf,eAAe,EACf,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,kBAAkB,GACnB,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAA;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAA;AAG1E,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAGtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAGtD,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,GAChB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,qBAAqB,CAAA"}

package/dist/index.js

@@ -0,0 +1,16 @@
+// Session
+export { TunerSession } from './session.js';
+// Note utilities
+export { frequencyToMidi, midiToFrequency, midiToNote, midiToOctave, getCents, getCentsFromTarget, } from './notes.js';
+// Detectors
+export { AutocorrelationDetector } from './detectors/autocorrelation.js';
+export { YinDetector } from './detectors/yin.js';
+export { PyinDetector } from './detectors/pyin.js';
+export { MpmDetector } from './detectors/mpm.js';
+export { createPitchDetector } from './detectors/create-pitch-detector.js';
+// Tuning data
+export { INSTRUMENTS, findInstrument, findTuning } from './tunings.js';
+// Preferences
+export { DEFAULT_PREFERENCES } from './preferences.js';
+export { DEFAULT_TUNER_SETTINGS, mergeTunerSettings, applySettingsPatch, } from './tuner-settings.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiBA,UAAU;AACV,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAE3C,iBAAiB;AACjB,OAAO,EACL,eAAe,EACf,eAAe,EACf,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,kBAAkB,GACnB,MAAM,YAAY,CAAA;AAEnB,YAAY;AACZ,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAA;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAA;AAE1E,cAAc;AACd,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEtE,cAAc;AACd,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAStD,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,qBAAqB,CAAA"}

package/dist/notes.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Convert a frequency in Hz to a MIDI note number (float).
+ */
+export declare function frequencyToMidi(frequency: number): number;
+/**
+ * Convert a MIDI note number to frequency in Hz.
+ */
+export declare function midiToFrequency(midi: number): number;
+/**
+ * Get the note name for a MIDI note number.
+ */
+export declare function midiToNote(midi: number): string;
+/**
+ * Get the octave for a MIDI note number.
+ */
+export declare function midiToOctave(midi: number): number;
+/**
+ * Get cents deviation from the nearest semitone (-50 to +50).
+ */
+export declare function getCents(frequency: number): number;
+/**
+ * Get cents deviation between a detected frequency and a target frequency.
+ */
+export declare function getCentsFromTarget(detected: number, target: number): number;
+//# sourceMappingURL=notes.d.ts.map

package/dist/notes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notes.d.ts","sourceRoot":"","sources":["../src/notes.ts"],"names":[],"mappings":"AAkBA;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE3E"}

package/dist/notes.js

@@ -0,0 +1,56 @@
+const NOTE_NAMES = [
+    'C',
+    'C#',
+    'D',
+    'D#',
+    'E',
+    'F',
+    'F#',
+    'G',
+    'G#',
+    'A',
+    'A#',
+    'B',
+];
+const A4_FREQUENCY = 440;
+const A4_MIDI = 69;
+/**
+ * Convert a frequency in Hz to a MIDI note number (float).
+ */
+export function frequencyToMidi(frequency) {
+    return 12 * Math.log2(frequency / A4_FREQUENCY) + A4_MIDI;
+}
+/**
+ * Convert a MIDI note number to frequency in Hz.
+ */
+export function midiToFrequency(midi) {
+    return A4_FREQUENCY * 2 ** ((midi - A4_MIDI) / 12);
+}
+/**
+ * Get the note name for a MIDI note number.
+ */
+export function midiToNote(midi) {
+    const name = NOTE_NAMES[Math.round(midi) % 12];
+    return name ?? 'A';
+}
+/**
+ * Get the octave for a MIDI note number.
+ */
+export function midiToOctave(midi) {
+    return Math.floor(Math.round(midi) / 12) - 1;
+}
+/**
+ * Get cents deviation from the nearest semitone (-50 to +50).
+ */
+export function getCents(frequency) {
+    const midi = frequencyToMidi(frequency);
+    const nearestMidi = Math.round(midi);
+    return Math.round((midi - nearestMidi) * 100);
+}
+/**
+ * Get cents deviation between a detected frequency and a target frequency.
+ */
+export function getCentsFromTarget(detected, target) {
+    return Math.round(1200 * Math.log2(detected / target));
+}
+//# sourceMappingURL=notes.js.map

package/dist/notes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notes.js","sourceRoot":"","sources":["../src/notes.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,GAAG;IACjB,GAAG;IACH,IAAI;IACJ,GAAG;IACH,IAAI;IACJ,GAAG;IACH,GAAG;IACH,IAAI;IACJ,GAAG;IACH,IAAI;IACJ,GAAG;IACH,IAAI;IACJ,GAAG;CACK,CAAA;AAEV,MAAM,YAAY,GAAG,GAAG,CAAA;AACxB,MAAM,OAAO,GAAG,EAAE,CAAA;AAElB;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,YAAY,CAAC,GAAG,OAAO,CAAA;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,YAAY,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA;IAC9C,OAAO,IAAI,IAAI,GAAG,CAAA;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAA;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,SAAiB;IACxC,MAAM,IAAI,GAAG,eAAe,CAAC,SAAS,CAAC,CAAA;IACvC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACpC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,WAAW,CAAC,GAAG,GAAG,CAAC,CAAA;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,MAAc;IACjE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAA;AACxD,CAAC"}

package/dist/preferences.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Persisted app choices (instrument, tuning, cents threshold, custom tunings) — the kind of data
+ * a `PreferencesProvider` loads/saves. This is not engine configuration; for buffer size, detector
+ * kind, and smoothing see `tuner-settings.ts` and `TunerSettings`.
+ */
+import type { UserPreferences } from './types.js';
+export declare const DEFAULT_PREFERENCES: UserPreferences;
+//# sourceMappingURL=preferences.d.ts.map

package/dist/preferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.d.ts","sourceRoot":"","sources":["../src/preferences.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD,eAAO,MAAM,mBAAmB,EAAE,eAKjC,CAAA"}

package/dist/preferences.js

@@ -0,0 +1,7 @@
+export const DEFAULT_PREFERENCES = {
+    centsThreshold: 5,
+    customTunings: [],
+    lastInstrumentId: null,
+    lastTuningId: null,
+};
+//# sourceMappingURL=preferences.js.map

package/dist/preferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.js","sourceRoot":"","sources":["../src/preferences.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,mBAAmB,GAAoB;IAClD,cAAc,EAAE,CAAC;IACjB,aAAa,EAAE,EAAE;IACjB,gBAAgB,EAAE,IAAI;IACtB,YAAY,EAAE,IAAI;CACnB,CAAA"}

package/dist/session.d.ts

@@ -0,0 +1,25 @@
+import type { TunerSettings } from './tuner-settings.js';
+import type { AudioProvider, PitchDetector, TunerEventListener, TunerEventMap, Tuning, UserPreferences } from './types.js';
+export declare class TunerSession {
+    private readonly audio;
+    private readonly detector;
+    private readonly settings;
+    private activeTuning;
+    private centsThreshold;
+    private running;
+    private freqWindow;
+    private lastHeldHz;
+    private listeners;
+    constructor(audio: AudioProvider, detector: PitchDetector, settings?: Partial<TunerSettings>);
+    setTuning(tuning: Tuning | null): void;
+    applyPreferences(prefs: Partial<UserPreferences>): void;
+    start(): Promise<void>;
+    stop(): void;
+    get isRunning(): boolean;
+    on<K extends keyof TunerEventMap>(event: K, listener: TunerEventListener<K>): void;
+    off<K extends keyof TunerEventMap>(event: K, listener: TunerEventListener<K>): void;
+    private emit;
+    private processFrame;
+    private findClosestString;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExD,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,aAAa,EAEb,MAAM,EACN,eAAe,EAChB,MAAM,YAAY,CAAA;AASnB,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,cAAc,CAAkC;IACxD,OAAO,CAAC,OAAO,CAAQ;IAEvB,OAAO,CAAC,UAAU,CAAe;IACjC,OAAO,CAAC,UAAU,CAAsB;IAExC,OAAO,CAAC,SAAS,CAKhB;gBAGC,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,aAAa,EACvB,QAAQ,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC;IASnC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAItC,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAQjD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAY5B,IAAI,IAAI,IAAI;IAUZ,IAAI,SAAS,IAAI,OAAO,CAEvB;IAID,EAAE,CAAC,CAAC,SAAS,MAAM,aAAa,EAC9B,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC9B,IAAI;IAIP,GAAG,CAAC,CAAC,SAAS,MAAM,aAAa,EAC/B,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC9B,IAAI;IAIP,OAAO,CAAC,IAAI;IAWZ,OAAO,CAAC,YAAY;IAyCpB,OAAO,CAAC,iBAAiB;CAsB1B"}