tuner-core 2026.4.2

package/dist/session.js

@@ -0,0 +1,131 @@
+import { frequencyToMidi, getCents, getCentsFromTarget, midiToNote, midiToOctave, } from './notes.js';
+import { mergeTunerSettings } from './tuner-settings.js';
+import { median } from './utils/median.js';
+const DEFAULT_CENTS_THRESHOLD = 5;
+export class TunerSession {
+    audio;
+    detector;
+    settings;
+    activeTuning = null;
+    centsThreshold = DEFAULT_CENTS_THRESHOLD;
+    running = false;
+    freqWindow = [];
+    lastHeldHz = null;
+    listeners = {
+        result: new Set(),
+        started: new Set(),
+        stopped: new Set(),
+        error: new Set(),
+    };
+    constructor(audio, detector, settings) {
+        this.audio = audio;
+        this.detector = detector;
+        this.settings = mergeTunerSettings(settings);
+    }
+    // ─── Configuration ──────────────────────────────────────────────────────────
+    setTuning(tuning) {
+        this.activeTuning = tuning;
+    }
+    applyPreferences(prefs) {
+        if (prefs.centsThreshold !== undefined) {
+            this.centsThreshold = prefs.centsThreshold;
+        }
+    }
+    // ─── Lifecycle ───────────────────────────────────────────────────────────────
+    async start() {
+        if (this.running)
+            return;
+        try {
+            this.audio.onFrame((samples) => this.processFrame(samples));
+            await this.audio.start();
+            this.running = true;
+            this.emit('started', undefined);
+        }
+        catch (err) {
+            this.emit('error', err instanceof Error ? err : new Error(String(err)));
+        }
+    }
+    stop() {
+        if (!this.running)
+            return;
+        this.audio.stop();
+        this.running = false;
+        this.freqWindow = [];
+        this.lastHeldHz = null;
+        this.detector.reset?.();
+        this.emit('stopped', undefined);
+    }
+    get isRunning() {
+        return this.running;
+    }
+    // ─── Events ──────────────────────────────────────────────────────────────────
+    on(event, listener) {
+        ;
+        this.listeners[event].add(listener);
+    }
+    off(event, listener) {
+        ;
+        this.listeners[event].delete(listener);
+    }
+    emit(event, payload) {
+        for (const listener of this.listeners[event]) {
+            ;
+            listener(payload);
+        }
+    }
+    // ─── Processing ──────────────────────────────────────────────────────────────
+    processFrame(samples) {
+        const sampleRate = this.audio.getSampleRate();
+        const { frequency: rawHz, confidence } = this.detector.detect(samples, sampleRate);
+        if (rawHz === null) {
+            this.freqWindow = [];
+            return;
+        }
+        const w = this.settings.medianWindowSize;
+        const windowSize = w < 1 ? 1 : w;
+        this.freqWindow.push(rawHz);
+        while (this.freqWindow.length > windowSize) {
+            this.freqWindow.shift();
+        }
+        const medianHz = median(this.freqWindow);
+        let displayHz;
+        if (confidence >= this.settings.minConfidence) {
+            this.lastHeldHz = medianHz;
+            displayHz = medianHz;
+        }
+        else {
+            displayHz = this.lastHeldHz ?? medianHz;
+        }
+        const midi = frequencyToMidi(displayHz);
+        const result = {
+            frequency: displayHz,
+            note: midiToNote(midi),
+            octave: midiToOctave(midi),
+            cents: getCents(displayHz),
+            closestString: this.findClosestString(displayHz),
+            tuningStrings: this.activeTuning ? [...this.activeTuning.strings] : null,
+        };
+        this.emit('result', result);
+    }
+    findClosestString(frequency) {
+        if (!this.activeTuning)
+            return null;
+        let closest = null;
+        let minAbsCents = Number.POSITIVE_INFINITY;
+        for (const string of this.activeTuning.strings) {
+            const centsOff = getCentsFromTarget(frequency, string.frequency);
+            const absCents = Math.abs(centsOff);
+            if (absCents < minAbsCents) {
+                minAbsCents = absCents;
+                closest = {
+                    name: string.name,
+                    targetFrequency: string.frequency,
+                    centsOff,
+                    inTune: absCents <= this.centsThreshold,
+                };
+            }
+        }
+        return closest;
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/tuner-settings.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Engine / pipeline knobs: audio frame size, pitch detector choice, frequency smoothing
+ * (`medianWindowSize`), confidence gating, and per-detector parameters (bands, thresholds,
+ * PYIN HMM). These affect latency vs stability and how `TunerSession` interprets audio — not
+ * persisted “user preferences” like last selected instrument (see `UserPreferences` in
+ * `types.ts` and `DEFAULT_PREFERENCES` in `preferences.ts`).
+ *
+ * Tune defaults here when experimenting globally; apps can merge overrides via
+ * `mergeTunerSettings` / `applySettingsPatch`.
+ */
+export type PitchDetectorKind = 'mpm' | 'pyin' | 'yin' | 'autocorrelation';
+/** HMM / observation shaping for {@link PyinDetector} */
+export interface PyinHMMSettings {
+    yinSharpness: number;
+    transitionSigmaSemitones: number;
+    maxJumpSemitones: number;
+    logPitchToUv: number;
+    logUvToPitch: number;
+    logUvToUv: number;
+    /**
+     * Penalty (per semitone²) tying observations to the first YIN CMND dip
+     * (same idea as classic YIN’s “first τ below threshold”) to avoid subharmonics.
+     */
+    firstDipSemitoneWeight: number;
+    /** CMND level used to locate that first dip for the hint */
+    firstDipThreshold: number;
+}
+export interface DetectorSettings {
+    minFrequency: number;
+    maxFrequency: number;
+    /** Autocorrelation: minimum normalized clarity */
+    clarityThreshold: number;
+    /** YIN: cumulative mean normalized difference gate (typ. 0.10–0.20) */
+    yinThreshold: number;
+    /** MPM: minimum NSDF peak height before accepting a period (typ. 0.85–0.95) */
+    mpmPeakThreshold: number;
+    pyin: PyinHMMSettings;
+}
+export interface TunerSettings {
+    /**
+     * Samples per analysis frame (web/Capacitor capture buffer).
+     * Larger → better low-string resolution, more latency (~ frame / sampleRate).
+     */
+    audioFrameSamples: number;
+    /** How many recent raw frequencies feed the median filter; 1 disables smoothing */
+    medianWindowSize: number;
+    /**
+     * 0…1 from the detector; below this the session keeps emitting the last confident pitch.
+     */
+    minConfidence: number;
+    pitchDetector: PitchDetectorKind;
+    detector: DetectorSettings;
+}
+export declare const DEFAULT_TUNER_SETTINGS: TunerSettings;
+export declare function mergeTunerSettings(overrides?: Partial<TunerSettings>): TunerSettings;
+/** Merge a partial update into the current settings (preserves unspecified nested keys). */
+export declare function applySettingsPatch(current: TunerSettings, patch: Partial<TunerSettings>): TunerSettings;
+//# sourceMappingURL=tuner-settings.d.ts.map

package/dist/tuner-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tuner-settings.d.ts","sourceRoot":"","sources":["../src/tuner-settings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,iBAAiB,CAAA;AAE1E,yDAAyD;AACzD,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAA;IACpB,wBAAwB,EAAE,MAAM,CAAA;IAChC,gBAAgB,EAAE,MAAM,CAAA;IACxB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,sBAAsB,EAAE,MAAM,CAAA;IAC9B,4DAA4D;IAC5D,iBAAiB,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,kDAAkD;IAClD,gBAAgB,EAAE,MAAM,CAAA;IACxB,uEAAuE;IACvE,YAAY,EAAE,MAAM,CAAA;IACpB,+EAA+E;IAC/E,gBAAgB,EAAE,MAAM,CAAA;IACxB,IAAI,EAAE,eAAe,CAAA;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,iBAAiB,EAAE,MAAM,CAAA;IACzB,mFAAmF;IACnF,gBAAgB,EAAE,MAAM,CAAA;IACxB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,iBAAiB,CAAA;IAChC,QAAQ,EAAE,gBAAgB,CAAA;CAC3B;AAcD,eAAO,MAAM,sBAAsB,EAAE,aAapC,CAAA;AAED,wBAAgB,kBAAkB,CAChC,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GACjC,aAAa,CAgBf;AAED,4FAA4F;AAC5F,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,GAC5B,aAAa,CAcf"}

package/dist/tuner-settings.js

@@ -0,0 +1,69 @@
+/**
+ * Engine / pipeline knobs: audio frame size, pitch detector choice, frequency smoothing
+ * (`medianWindowSize`), confidence gating, and per-detector parameters (bands, thresholds,
+ * PYIN HMM). These affect latency vs stability and how `TunerSession` interprets audio — not
+ * persisted “user preferences” like last selected instrument (see `UserPreferences` in
+ * `types.ts` and `DEFAULT_PREFERENCES` in `preferences.ts`).
+ *
+ * Tune defaults here when experimenting globally; apps can merge overrides via
+ * `mergeTunerSettings` / `applySettingsPatch`.
+ */
+/** Defaults tuned for monophonic instrument tuning (stable needle, few false subharmonics). */
+const DEFAULT_PYIN_HMM = {
+    yinSharpness: 12,
+    transitionSigmaSemitones: 1.35,
+    maxJumpSemitones: 10,
+    logPitchToUv: -3.2,
+    logUvToPitch: -2.8,
+    logUvToUv: -0.15,
+    firstDipSemitoneWeight: 0.14,
+    firstDipThreshold: 0.18,
+};
+export const DEFAULT_TUNER_SETTINGS = {
+    audioFrameSamples: 4096,
+    medianWindowSize: 7,
+    minConfidence: 0.28,
+    pitchDetector: 'yin',
+    detector: {
+        minFrequency: 60,
+        maxFrequency: 1400,
+        clarityThreshold: 0.2,
+        yinThreshold: 0.15,
+        mpmPeakThreshold: 0.88,
+        pyin: { ...DEFAULT_PYIN_HMM },
+    },
+};
+export function mergeTunerSettings(overrides) {
+    const base = DEFAULT_TUNER_SETTINGS;
+    const det = overrides?.detector;
+    const py = det?.pyin;
+    return {
+        ...base,
+        ...overrides,
+        detector: {
+            ...base.detector,
+            ...det,
+            pyin: {
+                ...base.detector.pyin,
+                ...py,
+            },
+        },
+    };
+}
+/** Merge a partial update into the current settings (preserves unspecified nested keys). */
+export function applySettingsPatch(current, patch) {
+    const det = patch.detector;
+    return {
+        ...current,
+        ...patch,
+        detector: {
+            ...current.detector,
+            ...det,
+            pyin: {
+                ...current.detector.pyin,
+                ...(det?.pyin ?? {}),
+            },
+        },
+    };
+}
+//# sourceMappingURL=tuner-settings.js.map

package/dist/tuner-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tuner-settings.js","sourceRoot":"","sources":["../src/tuner-settings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAiDH,+FAA+F;AAC/F,MAAM,gBAAgB,GAAoB;IACxC,YAAY,EAAE,EAAE;IAChB,wBAAwB,EAAE,IAAI;IAC9B,gBAAgB,EAAE,EAAE;IACpB,YAAY,EAAE,CAAC,GAAG;IAClB,YAAY,EAAE,CAAC,GAAG;IAClB,SAAS,EAAE,CAAC,IAAI;IAChB,sBAAsB,EAAE,IAAI;IAC5B,iBAAiB,EAAE,IAAI;CACxB,CAAA;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAkB;IACnD,iBAAiB,EAAE,IAAI;IACvB,gBAAgB,EAAE,CAAC;IACnB,aAAa,EAAE,IAAI;IACnB,aAAa,EAAE,KAAK;IACpB,QAAQ,EAAE;QACR,YAAY,EAAE,EAAE;QAChB,YAAY,EAAE,IAAI;QAClB,gBAAgB,EAAE,GAAG;QACrB,YAAY,EAAE,IAAI;QAClB,gBAAgB,EAAE,IAAI;QACtB,IAAI,EAAE,EAAE,GAAG,gBAAgB,EAAE;KAC9B;CACF,CAAA;AAED,MAAM,UAAU,kBAAkB,CAChC,SAAkC;IAElC,MAAM,IAAI,GAAG,sBAAsB,CAAA;IACnC,MAAM,GAAG,GAAG,SAAS,EAAE,QAAQ,CAAA;IAC/B,MAAM,EAAE,GAAG,GAAG,EAAE,IAAI,CAAA;IACpB,OAAO;QACL,GAAG,IAAI;QACP,GAAG,SAAS;QACZ,QAAQ,EAAE;YACR,GAAG,IAAI,CAAC,QAAQ;YAChB,GAAG,GAAG;YACN,IAAI,EAAE;gBACJ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI;gBACrB,GAAG,EAAE;aACN;SACF;KACF,CAAA;AACH,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,kBAAkB,CAChC,OAAsB,EACtB,KAA6B;IAE7B,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAA;IAC1B,OAAO;QACL,GAAG,OAAO;QACV,GAAG,KAAK;QACR,QAAQ,EAAE;YACR,GAAG,OAAO,CAAC,QAAQ;YACnB,GAAG,GAAG;YACN,IAAI,EAAE;gBACJ,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI;gBACxB,GAAG,CAAC,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC;aACrB;SACF;KACF,CAAA;AACH,CAAC"}

package/dist/tunings.d.ts

@@ -0,0 +1,5 @@
+import type { Instrument } from './types.js';
+export declare const INSTRUMENTS: Instrument[];
+export declare function findInstrument(id: string): Instrument | null;
+export declare function findTuning(instrumentId: string, tuningId: string): import("./types.js").Tuning | null;
+//# sourceMappingURL=tunings.d.ts.map

package/dist/tunings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tunings.d.ts","sourceRoot":"","sources":["../src/tunings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,eAAO,MAAM,WAAW,EAAE,UAAU,EA+NnC,CAAA;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAE5D;AAED,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,sCAIhE"}

package/dist/tunings.js

@@ -0,0 +1,231 @@
+export const INSTRUMENTS = [
+    {
+        id: 'guitar',
+        name: 'Guitar',
+        tunings: [
+            {
+                id: 'guitar-standard',
+                name: 'Standard (EADGBe)',
+                strings: [
+                    { name: 'E2', frequency: 82.41 },
+                    { name: 'A2', frequency: 110.0 },
+                    { name: 'D3', frequency: 146.83 },
+                    { name: 'G3', frequency: 196.0 },
+                    { name: 'B3', frequency: 246.94 },
+                    { name: 'E4', frequency: 329.63 },
+                ],
+            },
+            {
+                id: 'guitar-drop-d',
+                name: 'Drop D (DADGBe)',
+                strings: [
+                    { name: 'D2', frequency: 73.42 },
+                    { name: 'A2', frequency: 110.0 },
+                    { name: 'D3', frequency: 146.83 },
+                    { name: 'G3', frequency: 196.0 },
+                    { name: 'B3', frequency: 246.94 },
+                    { name: 'E4', frequency: 329.63 },
+                ],
+            },
+            {
+                id: 'guitar-drop-c',
+                name: 'Drop C (CGCFAd)',
+                strings: [
+                    { name: 'C2', frequency: 65.41 },
+                    { name: 'G2', frequency: 98.0 },
+                    { name: 'C3', frequency: 130.81 },
+                    { name: 'F3', frequency: 174.61 },
+                    { name: 'A3', frequency: 220.0 },
+                    { name: 'D4', frequency: 293.66 },
+                ],
+            },
+            {
+                id: 'guitar-half-step-down',
+                name: 'Half Step Down (Eb)',
+                strings: [
+                    { name: 'Eb2', frequency: 77.78 },
+                    { name: 'Ab2', frequency: 103.83 },
+                    { name: 'Db3', frequency: 138.59 },
+                    { name: 'Gb3', frequency: 185.0 },
+                    { name: 'Bb3', frequency: 233.08 },
+                    { name: 'Eb4', frequency: 311.13 },
+                ],
+            },
+            {
+                id: 'guitar-open-g',
+                name: 'Open G (DGDGBd)',
+                strings: [
+                    { name: 'D2', frequency: 73.42 },
+                    { name: 'G2', frequency: 98.0 },
+                    { name: 'D3', frequency: 146.83 },
+                    { name: 'G3', frequency: 196.0 },
+                    { name: 'B3', frequency: 246.94 },
+                    { name: 'D4', frequency: 293.66 },
+                ],
+            },
+            {
+                id: 'guitar-open-d',
+                name: 'Open D (DADf#ad)',
+                strings: [
+                    { name: 'D2', frequency: 73.42 },
+                    { name: 'A2', frequency: 110.0 },
+                    { name: 'D3', frequency: 146.83 },
+                    { name: 'F#3', frequency: 185.0 },
+                    { name: 'A3', frequency: 220.0 },
+                    { name: 'D4', frequency: 293.66 },
+                ],
+            },
+            {
+                id: 'guitar-dadgad',
+                name: 'DADGAD',
+                strings: [
+                    { name: 'D2', frequency: 73.42 },
+                    { name: 'A2', frequency: 110.0 },
+                    { name: 'D3', frequency: 146.83 },
+                    { name: 'G3', frequency: 196.0 },
+                    { name: 'A3', frequency: 220.0 },
+                    { name: 'D4', frequency: 293.66 },
+                ],
+            },
+        ],
+    },
+    {
+        id: 'bass',
+        name: 'Bass',
+        tunings: [
+            {
+                id: 'bass-standard-4',
+                name: 'Standard 4-string (EADg)',
+                strings: [
+                    { name: 'E1', frequency: 41.2 },
+                    { name: 'A1', frequency: 55.0 },
+                    { name: 'D2', frequency: 73.42 },
+                    { name: 'G2', frequency: 98.0 },
+                ],
+            },
+            {
+                id: 'bass-standard-5',
+                name: 'Standard 5-string (BEADg)',
+                strings: [
+                    { name: 'B0', frequency: 30.87 },
+                    { name: 'E1', frequency: 41.2 },
+                    { name: 'A1', frequency: 55.0 },
+                    { name: 'D2', frequency: 73.42 },
+                    { name: 'G2', frequency: 98.0 },
+                ],
+            },
+            {
+                id: 'bass-drop-d',
+                name: 'Drop D (DADg)',
+                strings: [
+                    { name: 'D1', frequency: 36.71 },
+                    { name: 'A1', frequency: 55.0 },
+                    { name: 'D2', frequency: 73.42 },
+                    { name: 'G2', frequency: 98.0 },
+                ],
+            },
+        ],
+    },
+    {
+        id: 'ukulele',
+        name: 'Ukulele',
+        tunings: [
+            {
+                id: 'ukulele-standard',
+                name: 'Standard (GCEA)',
+                strings: [
+                    { name: 'G4', frequency: 392.0 },
+                    { name: 'C4', frequency: 261.63 },
+                    { name: 'E4', frequency: 329.63 },
+                    { name: 'A4', frequency: 440.0 },
+                ],
+            },
+            {
+                id: 'ukulele-low-g',
+                name: 'Low G (GCEA)',
+                strings: [
+                    { name: 'G3', frequency: 196.0 },
+                    { name: 'C4', frequency: 261.63 },
+                    { name: 'E4', frequency: 329.63 },
+                    { name: 'A4', frequency: 440.0 },
+                ],
+            },
+            {
+                id: 'ukulele-baritone',
+                name: 'Baritone (DGBE)',
+                strings: [
+                    { name: 'D3', frequency: 146.83 },
+                    { name: 'G3', frequency: 196.0 },
+                    { name: 'B3', frequency: 246.94 },
+                    { name: 'E4', frequency: 329.63 },
+                ],
+            },
+        ],
+    },
+    {
+        id: 'violin',
+        name: 'Violin',
+        tunings: [
+            {
+                id: 'violin-standard',
+                name: 'Standard (GDAE)',
+                strings: [
+                    { name: 'G3', frequency: 196.0 },
+                    { name: 'D4', frequency: 293.66 },
+                    { name: 'A4', frequency: 440.0 },
+                    { name: 'E5', frequency: 659.25 },
+                ],
+            },
+        ],
+    },
+    {
+        id: 'mandolin',
+        name: 'Mandolin',
+        tunings: [
+            {
+                id: 'mandolin-standard',
+                name: 'Standard (GDAE)',
+                strings: [
+                    { name: 'G3', frequency: 196.0 },
+                    { name: 'D4', frequency: 293.66 },
+                    { name: 'A4', frequency: 440.0 },
+                    { name: 'E5', frequency: 659.25 },
+                ],
+            },
+        ],
+    },
+    {
+        id: 'banjo',
+        name: 'Banjo',
+        tunings: [
+            {
+                id: 'banjo-standard-5',
+                name: 'Standard 5-string (gDGBD)',
+                strings: [
+                    { name: 'G4', frequency: 392.0 },
+                    { name: 'D3', frequency: 146.83 },
+                    { name: 'G3', frequency: 196.0 },
+                    { name: 'B3', frequency: 246.94 },
+                    { name: 'D4', frequency: 293.66 },
+                ],
+            },
+            {
+                id: 'banjo-tenor',
+                name: 'Tenor (CGDA)',
+                strings: [
+                    { name: 'C3', frequency: 130.81 },
+                    { name: 'G3', frequency: 196.0 },
+                    { name: 'D4', frequency: 293.66 },
+                    { name: 'A4', frequency: 440.0 },
+                ],
+            },
+        ],
+    },
+];
+export function findInstrument(id) {
+    return INSTRUMENTS.find((i) => i.id === id) ?? null;
+}
+export function findTuning(instrumentId, tuningId) {
+    return (findInstrument(instrumentId)?.tunings.find((t) => t.id === tuningId) ?? null);
+}
+//# sourceMappingURL=tunings.js.map

package/dist/tunings.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,68 @@
+export interface AudioProvider {
+    getSampleRate(): number;
+    onFrame(callback: (samples: Float32Array) => void): void;
+    start(): Promise<void>;
+    stop(): void;
+}
+/** Optional tactile feedback; core may call through a host-provided instance. */
+export interface HapticsProvider {
+    inTune(): void;
+    close(): void;
+}
+/** Detector output; `confidence` is 0…1 (0 when no pitch). */
+export interface PitchDetection {
+    frequency: number | null;
+    confidence: number;
+}
+export interface PitchDetector {
+    detect(samples: Float32Array, sampleRate: number): PitchDetection;
+    /** Clear temporal state (e.g. PYIN HMM). Optional. */
+    reset?(): void;
+}
+export interface StringDef {
+    name: string;
+    frequency: number;
+}
+export interface Tuning {
+    id: string;
+    name: string;
+    strings: StringDef[];
+}
+export interface Instrument {
+    id: string;
+    name: string;
+    tunings: Tuning[];
+}
+export interface ClosestString {
+    name: string;
+    targetFrequency: number;
+    centsOff: number;
+    inTune: boolean;
+}
+export interface TunerResult {
+    frequency: number;
+    note: string;
+    octave: number;
+    cents: number;
+    closestString: ClosestString | null;
+    /** Active tuning courses for UI; null when no tuning is selected. */
+    tuningStrings: StringDef[] | null;
+}
+export interface UserPreferences {
+    centsThreshold: number;
+    customTunings: Tuning[];
+    lastInstrumentId: string | null;
+    lastTuningId: string | null;
+}
+export interface PreferencesProvider {
+    load(): Promise<UserPreferences>;
+    save(prefs: UserPreferences): Promise<void>;
+}
+export type TunerEventMap = {
+    result: TunerResult;
+    started: undefined;
+    stopped: undefined;
+    error: Error;
+};
+export type TunerEventListener<K extends keyof TunerEventMap> = (payload: TunerEventMap[K]) => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,aAAa,IAAI,MAAM,CAAA;IACvB,OAAO,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI,CAAA;IACxD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,IAAI,IAAI,IAAI,CAAA;CACb;AAED,iFAAiF;AACjF,MAAM,WAAW,eAAe;IAC9B,MAAM,IAAI,IAAI,CAAA;IACd,KAAK,IAAI,IAAI,CAAA;CACd;AAID,8DAA8D;AAC9D,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc,CAAA;IACjE,sDAAsD;IACtD,KAAK,CAAC,IAAI,IAAI,CAAA;CACf;AAID,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,SAAS,EAAE,CAAA;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAID,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,eAAe,EAAE,MAAM,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,aAAa,EAAE,aAAa,GAAG,IAAI,CAAA;IACnC,qEAAqE;IACrE,aAAa,EAAE,SAAS,EAAE,GAAG,IAAI,CAAA;CAClC;AAID,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAA;IACtB,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC,CAAA;IAChC,IAAI,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5C;AAID,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,WAAW,CAAA;IACnB,OAAO,EAAE,SAAS,CAAA;IAClB,OAAO,EAAE,SAAS,CAAA;IAClB,KAAK,EAAE,KAAK,CAAA;CACb,CAAA;AAED,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,MAAM,aAAa,IAAI,CAC9D,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,KACtB,IAAI,CAAA"}

package/dist/types.js

@@ -0,0 +1,3 @@
+// ─── Host / platform (injected by app — web, Capacitor, CLI, tests) ─────────
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+EAA+E"}

package/dist/utils/median.d.ts

@@ -0,0 +1,3 @@
+/** Median of a non-empty list (copies and sorts). */
+export declare function median(values: readonly number[]): number;
+//# sourceMappingURL=median.d.ts.map

package/dist/utils/median.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"median.d.ts","sourceRoot":"","sources":["../../src/utils/median.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,wBAAgB,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAYxD"}

package/dist/utils/median.js

@@ -0,0 +1,15 @@
+/** Median of a non-empty list (copies and sorts). */
+export function median(values) {
+    if (values.length === 0) {
+        throw new Error('median requires at least one value');
+    }
+    const sorted = [...values].sort((a, b) => a - b);
+    const mid = Math.floor(sorted.length / 2);
+    if (sorted.length % 2 === 1) {
+        return sorted[mid] ?? 0;
+    }
+    const a = sorted[mid - 1] ?? 0;
+    const b = sorted[mid] ?? 0;
+    return (a + b) / 2;
+}
+//# sourceMappingURL=median.js.map

package/dist/utils/median.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"median.js","sourceRoot":"","sources":["../../src/utils/median.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,MAAM,UAAU,MAAM,CAAC,MAAyB;IAC9C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAA;IACvD,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;IAChD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACzC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IACD,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,CAAA;IAC9B,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC1B,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAA;AACpB,CAAC"}