tuner-cli 2026.4.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tuner contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,101 @@
+# tuner-cli
+
+Chromatic **instrument tuner** in the terminal: live pitch from your microphone, needle-style cents display, and optional string hints. Built with **[tuner-core](https://www.npmjs.com/package/tuner-core)** (detectors + session) and **[decibri](https://www.npmjs.com/package/decibri)** (PortAudio capture).
+
+![A guitar tuner in your terminal](docs/cli.gif)
+
+## Requirements
+
+- **Node.js 20+**
+- A **microphone** and an OS where **decibri** can open an input (prebuilt binaries when available; otherwise a local build toolchain may be needed for that package)
+
+## Install
+
+```bash
+npm install -g tuner-cli
+```
+
+Run **`tuner`** on your `PATH`. To try without a global install:
+
+```bash
+npx tuner-cli
+```
+
+
+## Usage
+
+Start the tuner with defaults (guitar, host default input, 48 kHz):
+
+```bash
+tuner
+```
+
+Discover inputs and built-in instruments:
+
+```bash
+tuner --list-devices
+tuner --list-instruments
+tuner --list-tunings guitar
+```
+
+Point at a specific input and instrument:
+
+```bash
+tuner --device 1 --instrument bass --tuning bass-standard
+tuner --rate 44100 --detector pyin --verbose
+```
+
+Use `-h` / `--help` for full CLI text and more examples.
+
+## Options
+
+| Flag | Description |
+|------|-------------|
+| `-h`, `--help` | Help |
+| `-v`, `--verbose` | Print resolved config on **stderr** before audio starts |
+| `--list-devices` | List audio inputs |
+| `--list-instruments` | List instrument ids |
+| `--list-tunings <id>` | List tunings for an instrument |
+| `--device …` | Input device: numeric index or substring of the device name |
+| `--rate <hz>` | Sample rate (default `48000`) |
+| `--instrument <id>` | Instrument (default `guitar`) |
+| `--tuning <id>` | Tuning (default: first for that instrument) |
+| `--detector <kind>` | `yin`, `pyin`, `mpm`, `autocorrelation` (default `yin`) |
+| `--cents-threshold <n>` | In-tune window for the string hint (default `5`) |
+| `--style <name>` | `standard`, `colors`, `ansi` |
+| `--color <mode>` | `auto`, `always`, `never` (honours `NO_COLOR` / `FORCE_COLOR` when `auto`) |
+
+## Interactive terminal
+
+If stdin and stdout are a TTY, you can change settings without restarting the whole program:
+
+| Key | Action |
+|-----|--------|
+| **i** | Instrument |
+| **t** | Tuning |
+| **s** | Display style |
+| **a** | Advanced (detector, rate, device, cents, color, style) |
+| **q**, **Esc**, **←** | Quit (when no menu is open; in lists, **Esc** / **←** goes back) |
+| **Ctrl+C** | Quit |
+
+In lists: **↑** / **↓** (or **j** / **k**) move; **Enter** or **→** (or **l**) select; **Esc** or **←** (or **h**) cancel. Changing detector, rate, or device in **Advanced** restarts the audio stream.
+
+## Developing
+
+This package lives in the **[Tuner](https://github.com/mducharme/Tuner)** monorepo.
+
+```bash
+git clone https://github.com/mducharme/Tuner.git
+cd Tuner
+pnpm install
+pnpm dev:cli          # run from source via tsx
+pnpm --filter tuner-cli build
+pnpm --filter tuner-cli test
+pnpm --filter tuner-cli run package:assert
+```
+
+Releases and versioning are handled in the monorepo (see the root **README** and [CHANGELOG](../../CHANGELOG.md)).
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/dist/ansi.js

@@ -0,0 +1,92 @@
+/** Minimal ANSI SGR helpers; gated by {@link resolveColorMode}. */
+export function resolveColorMode(choice, isTTY, env) {
+    if (choice === 'never')
+        return false;
+    if (choice === 'always')
+        return true;
+    if (env.NO_COLOR !== undefined && env.NO_COLOR !== '')
+        return false;
+    if (env.FORCE_COLOR !== undefined && env.FORCE_COLOR !== '0')
+        return true;
+    return isTTY;
+}
+const SGR = {
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+    dim: '\x1b[2m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    red: '\x1b[31m',
+    cyan: '\x1b[36m',
+    magenta: '\x1b[35m',
+    white: '\x1b[37m',
+};
+/** Match ANSI SGR sequences (CSI … m). Built without `\x1b` in the pattern for tooling rules. */
+const ANSI_SGR_PATTERN = new RegExp(`${String.fromCharCode(27)}\\[[0-9;]*m`, 'g');
+export function stripAnsi(s) {
+    return s.replace(ANSI_SGR_PATTERN, '');
+}
+/** Chromatic cents: green near 0, yellow mid, red far. */
+export function styleCents(color, cents) {
+    if (!color)
+        return { open: '', close: '' };
+    const a = Math.abs(cents);
+    if (a <= 5)
+        return { open: SGR.green, close: SGR.reset };
+    if (a <= 20)
+        return { open: SGR.yellow, close: SGR.reset };
+    return { open: SGR.red, close: SGR.reset };
+}
+export function styleNote(color) {
+    if (!color)
+        return { open: '', close: '' };
+    return { open: SGR.bold, close: SGR.reset };
+}
+export function styleDim(color) {
+    if (!color)
+        return { open: '', close: '' };
+    return { open: SGR.dim, close: SGR.reset };
+}
+export function styleInTune(color) {
+    if (!color)
+        return { open: '', close: '' };
+    return { open: SGR.green, close: SGR.reset };
+}
+/** Marker on gauge: green when string is in tune; else cents-based. */
+export function styleGaugeMarker(color, cents, stringInTune) {
+    if (!color)
+        return { open: '', close: '' };
+    if (stringInTune)
+        return { open: SGR.green, close: SGR.reset };
+    return styleCents(color, cents);
+}
+/** One inactive track cell: slight flat / sharp tint by side of center. */
+export function formatTrackCell(color, idx, centerIdx) {
+    if (!color)
+        return '·';
+    if (idx < centerIdx) {
+        return `${SGR.dim}${SGR.cyan}·${SGR.reset}`;
+    }
+    if (idx > centerIdx) {
+        return `${SGR.dim}${SGR.magenta}·${SGR.reset}`;
+    }
+    return `${SGR.dim}${SGR.white}·${SGR.reset}`;
+}
+export function formatMarkerCell(color, open, close) {
+    if (!color)
+        return '█';
+    return `${open}${SGR.bold}█${close}`;
+}
+/** Tinted track cell using shade blocks (fancy bar). */
+export function formatTrackShade(color, idx, centerIdx, ch) {
+    if (!color)
+        return ch;
+    if (idx < centerIdx) {
+        return `${SGR.dim}${SGR.cyan}${ch}${SGR.reset}`;
+    }
+    if (idx > centerIdx) {
+        return `${SGR.dim}${SGR.magenta}${ch}${SGR.reset}`;
+    }
+    return `${SGR.dim}${SGR.white}${ch}${SGR.reset}`;
+}
+//# sourceMappingURL=ansi.js.map

package/dist/ansi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ansi.js","sourceRoot":"","sources":["../src/ansi.ts"],"names":[],"mappings":"AAAA,mEAAmE;AAInE,MAAM,UAAU,gBAAgB,CAC9B,MAAmB,EACnB,KAAc,EACd,GAAsB;IAEtB,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,KAAK,CAAA;IACpC,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IACpC,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,GAAG,CAAC,QAAQ,KAAK,EAAE;QAAE,OAAO,KAAK,CAAA;IACnE,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,GAAG,CAAC,WAAW,KAAK,GAAG;QAAE,OAAO,IAAI,CAAA;IACzE,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,GAAG,GAAG;IACV,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,GAAG,EAAE,SAAS;IACd,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,GAAG,EAAE,UAAU;IACf,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,UAAU;IACnB,KAAK,EAAE,UAAU;CACT,CAAA;AAEV,iGAAiG;AACjG,MAAM,gBAAgB,GAAG,IAAI,MAAM,CACjC,GAAG,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,aAAa,EACvC,GAAG,CACJ,CAAA;AAED,MAAM,UAAU,SAAS,CAAC,CAAS;IACjC,OAAO,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAA;AACxC,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,UAAU,CACxB,KAAc,EACd,KAAa;IAEb,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;IAC1C,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACzB,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAA;IACxD,IAAI,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAA;IAC1D,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAA;AAC5C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;IAC1C,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAA;AAC7C,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;IAC1C,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAA;AAC5C,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;IAC1C,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAA;AAC9C,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,gBAAgB,CAC9B,KAAc,EACd,KAAa,EACb,YAAqB;IAErB,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;IAC1C,IAAI,YAAY;QAAE,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAA;IAC9D,OAAO,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;AACjC,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,eAAe,CAC7B,KAAc,EACd,GAAW,EACX,SAAiB;IAEjB,IAAI,CAAC,KAAK;QAAE,OAAO,GAAG,CAAA;IACtB,IAAI,GAAG,GAAG,SAAS,EAAE,CAAC;QACpB,OAAO,GAAG,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,KAAK,EAAE,CAAA;IAC7C,CAAC;IACD,IAAI,GAAG,GAAG,SAAS,EAAE,CAAC;QACpB,OAAO,GAAG,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,KAAK,EAAE,CAAA;IAChD,CAAC;IACD,OAAO,GAAG,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK,EAAE,CAAA;AAC9C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,KAAc,EACd,IAAY,EACZ,KAAa;IAEb,IAAI,CAAC,KAAK;QAAE,OAAO,GAAG,CAAA;IACtB,OAAO,GAAG,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,KAAK,EAAE,CAAA;AACtC,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,gBAAgB,CAC9B,KAAc,EACd,GAAW,EACX,SAAiB,EACjB,EAAU;IAEV,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAA;IACrB,IAAI,GAAG,GAAG,SAAS,EAAE,CAAC;QACpB,OAAO,GAAG,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,GAAG,CAAC,KAAK,EAAE,CAAA;IACjD,CAAC;IACD,IAAI,GAAG,GAAG,SAAS,EAAE,CAAC;QACpB,OAAO,GAAG,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,OAAO,GAAG,EAAE,GAAG,GAAG,CAAC,KAAK,EAAE,CAAA;IACpD,CAAC;IACD,OAAO,GAAG,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,KAAK,GAAG,EAAE,GAAG,GAAG,CAAC,KAAK,EAAE,CAAA;AAClD,CAAC"}

package/dist/cli-lists.js

@@ -0,0 +1,31 @@
+import Decibri from 'decibri';
+import { INSTRUMENTS, findInstrument } from 'tuner-core';
+export function listAudioDevices() {
+    const devices = Decibri.devices();
+    if (devices.length === 0) {
+        console.log('No input devices found.');
+        return;
+    }
+    for (const d of devices) {
+        const def = d.isDefault ? ' (default)' : '';
+        console.log(`  [${d.index}] ${d.name}${def}  ${d.defaultSampleRate} Hz`);
+    }
+}
+export function listInstruments() {
+    for (const inst of INSTRUMENTS) {
+        console.log(`  ${inst.id}  ${inst.name}`);
+    }
+}
+/** @returns false if instrument id is unknown */
+export function listTunings(instrumentId) {
+    const inst = findInstrument(instrumentId);
+    if (!inst) {
+        console.error(`Unknown instrument: ${instrumentId}`);
+        return false;
+    }
+    for (const t of inst.tunings) {
+        console.log(`  ${t.id}  ${t.name}`);
+    }
+    return true;
+}
+//# sourceMappingURL=cli-lists.js.map

package/dist/cli-lists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-lists.js","sourceRoot":"","sources":["../src/cli-lists.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAA;AAC7B,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAExD,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAA;IACjC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAA;QACtC,OAAM;IACR,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAA;QAC3C,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,IAAI,GAAG,GAAG,KAAK,CAAC,CAAC,iBAAiB,KAAK,CAAC,CAAA;IAC1E,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;IAC3C,CAAC;AACH,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,WAAW,CAAC,YAAoB;IAC9C,MAAM,IAAI,GAAG,cAAc,CAAC,YAAY,CAAC,CAAA;IACzC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,KAAK,CAAC,uBAAuB,YAAY,EAAE,CAAC,CAAA;QACpD,OAAO,KAAK,CAAA;IACd,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;IACrC,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/decibri-audio.js

@@ -0,0 +1,78 @@
+import Decibri from 'decibri';
+/**
+ * Bridges decibri mic capture to {@link AudioProvider}: fixed-size float frames
+ * for {@link TunerSession}.
+ */
+export class DecibriAudioProvider {
+    sampleRate;
+    frameSamples;
+    device;
+    onStreamError;
+    mic = null;
+    frameCallback = null;
+    accumulator;
+    accWrite = 0;
+    constructor(sampleRate, frameSamples, options) {
+        this.sampleRate = sampleRate;
+        this.frameSamples = frameSamples;
+        this.device = options?.device;
+        this.onStreamError = options?.onStreamError;
+        this.accumulator = new Float32Array(frameSamples);
+    }
+    getSampleRate() {
+        return this.sampleRate;
+    }
+    onFrame(callback) {
+        this.frameCallback = callback;
+    }
+    async start() {
+        if (this.mic)
+            return;
+        const framesPerBuffer = Math.min(8192, Math.max(256, Math.floor(this.frameSamples / 2)));
+        const mic = new Decibri({
+            sampleRate: this.sampleRate,
+            channels: 1,
+            format: 'float32',
+            framesPerBuffer,
+            ...(this.device !== undefined ? { device: this.device } : {}),
+        });
+        this.mic = mic;
+        this.accWrite = 0;
+        mic.on('data', (chunk) => {
+            this.pushPcm(chunk);
+        });
+        mic.on('error', (err) => {
+            this.onStreamError?.(err);
+        });
+        mic.resume();
+    }
+    stop() {
+        if (!this.mic)
+            return;
+        this.mic.removeAllListeners('data');
+        this.mic.removeAllListeners('error');
+        this.mic.stop();
+        this.mic = null;
+        this.accWrite = 0;
+        this.accumulator.fill(0);
+    }
+    pushPcm(chunk) {
+        const sampleCount = chunk.length >> 2;
+        const f32 = new Float32Array(sampleCount);
+        for (let i = 0; i < sampleCount; i++) {
+            f32[i] = chunk.readFloatLE(i * 4);
+        }
+        let offset = 0;
+        while (offset < f32.length) {
+            const take = Math.min(this.frameSamples - this.accWrite, f32.length - offset);
+            this.accumulator.set(f32.subarray(offset, offset + take), this.accWrite);
+            this.accWrite += take;
+            offset += take;
+            if (this.accWrite >= this.frameSamples) {
+                this.frameCallback?.(Float32Array.from(this.accumulator));
+                this.accWrite = 0;
+            }
+        }
+    }
+}
+//# sourceMappingURL=decibri-audio.js.map

package/dist/decibri-audio.js.map

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

package/dist/display/styles.js

@@ -0,0 +1,41 @@
+import { resolveColorMode, stripAnsi } from '../ansi.js';
+import { COLOR_BAR_SLOTS, FANCY_BAR_SLOTS, buildFancyGaugeBar, buildGaugeBar, fitOneTTYLine, formatInfoLine, } from '../format-line.js';
+const STYLE_LABELS = {
+    standard: 'Standard',
+    colors: 'Colors',
+    ansi: 'ANSI',
+};
+export function displayStyleLabel(style) {
+    return STYLE_LABELS[style];
+}
+export const DISPLAY_STYLES = ['standard', 'colors', 'ansi'];
+/**
+ * Default when --style is omitted: ANSI if color mode would be on (rich escapes),
+ * else Colors on a TTY (layout with optional color when --color allows), else Standard.
+ */
+export function defaultDisplayStyle(isTTY, env) {
+    if (isTTY && resolveColorMode('auto', isTTY, env))
+        return 'ansi';
+    if (isTTY)
+        return 'colors';
+    return 'standard';
+}
+function effectiveColor(ctx) {
+    if (ctx.style === 'standard')
+        return false;
+    return resolveColorMode(ctx.colorChoice, ctx.isTTY, ctx.env);
+}
+/** One physical line: info + bar; no wrap past terminal width. */
+export function renderTunerLine(result, ctx) {
+    const cols = Math.max(20, ctx.termWidth);
+    const color = effectiveColor(ctx);
+    if (ctx.style === 'ansi') {
+        const bar = buildFancyGaugeBar(result.cents, FANCY_BAR_SLOTS, color, result.closestString?.inTune ?? false);
+        const line = `${formatInfoLine(result, color)}  ${bar}`;
+        return fitOneTTYLine(line, cols);
+    }
+    const bar = buildGaugeBar(result.cents, COLOR_BAR_SLOTS, color, result.closestString?.inTune ?? false);
+    const line = `${formatInfoLine(result, color)}  ${bar}`;
+    return fitOneTTYLine(line, cols);
+}
+//# sourceMappingURL=styles.js.map

package/dist/display/styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.js","sourceRoot":"","sources":["../../src/display/styles.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,gBAAgB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAC1E,OAAO,EACL,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,cAAc,GACf,MAAM,mBAAmB,CAAA;AAI1B,MAAM,YAAY,GAAiC;IACjD,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;CACb,CAAA;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAmB;IACnD,OAAO,YAAY,CAAC,KAAK,CAAC,CAAA;AAC5B,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAmB,CAAC,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;AAE5E;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAc,EACd,GAAsB;IAEtB,IAAI,KAAK,IAAI,gBAAgB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC;QAAE,OAAO,MAAM,CAAA;IAChE,IAAI,KAAK;QAAE,OAAO,QAAQ,CAAA;IAC1B,OAAO,UAAU,CAAA;AACnB,CAAC;AAUD,SAAS,cAAc,CAAC,GAAkB;IACxC,IAAI,GAAG,CAAC,KAAK,KAAK,UAAU;QAAE,OAAO,KAAK,CAAA;IAC1C,OAAO,gBAAgB,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,CAAA;AAC9D,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,eAAe,CAC7B,MAAmB,EACnB,GAAkB;IAElB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,SAAS,CAAC,CAAA;IACxC,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,CAAA;IAEjC,IAAI,GAAG,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,kBAAkB,CAC5B,MAAM,CAAC,KAAK,EACZ,eAAe,EACf,KAAK,EACL,MAAM,CAAC,aAAa,EAAE,MAAM,IAAI,KAAK,CACtC,CAAA;QACD,MAAM,IAAI,GAAG,GAAG,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,GAAG,EAAE,CAAA;QACvD,OAAO,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IAClC,CAAC;IAED,MAAM,GAAG,GAAG,aAAa,CACvB,MAAM,CAAC,KAAK,EACZ,eAAe,EACf,KAAK,EACL,MAAM,CAAC,aAAa,EAAE,MAAM,IAAI,KAAK,CACtC,CAAA;IACD,MAAM,IAAI,GAAG,GAAG,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,GAAG,EAAE,CAAA;IACvD,OAAO,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;AAClC,CAAC"}

package/dist/format-line.js

@@ -0,0 +1,115 @@
+import { formatMarkerCell, formatTrackCell, formatTrackShade, stripAnsi, styleCents, styleDim, styleGaugeMarker, styleInTune, styleNote, } from './ansi.js';
+export const COLOR_BAR_SLOTS = 17;
+export const FANCY_BAR_SLOTS = 28;
+const SHADE_LIGHT = '░';
+const SHADE_MID = '▒';
+const SHADE_HEAVY = '▓';
+function clampCents(cents) {
+    return Math.max(-50, Math.min(50, cents));
+}
+function centsToMarkerIndex(cents, barLen) {
+    const c = clampCents(cents);
+    const t = (c + 50) / 100;
+    return Math.round(t * (barLen - 1));
+}
+export function buildGaugeBar(cents, barLen, color, stringInTune) {
+    const c = clampCents(cents);
+    const markerIdx = centsToMarkerIndex(c, barLen);
+    const centerIdx = (barLen - 1) / 2;
+    const mk = styleGaugeMarker(color, c, stringInTune);
+    let s = '';
+    for (let i = 0; i < barLen; i++) {
+        if (i === markerIdx) {
+            s += formatMarkerCell(color, mk.open, mk.close);
+        }
+        else {
+            s += formatTrackCell(color, i, centerIdx);
+        }
+    }
+    return s;
+}
+/**
+ * Finer cents resolution: shade falloff around needle; tinted track when color is on.
+ */
+export function buildFancyGaugeBar(cents, barLen, color, stringInTune) {
+    const c = clampCents(cents);
+    const pos = (c + 50) / 100;
+    const centerIdx = (barLen - 1) / 2;
+    const mk = styleGaugeMarker(color, c, stringInTune);
+    let s = '';
+    for (let i = 0; i < barLen; i++) {
+        const cellCenter = (i + 0.5) / barLen;
+        const dist = Math.abs(cellCenter - pos) * barLen;
+        let ch;
+        if (dist < 0.2) {
+            s += formatMarkerCell(color, mk.open, mk.close);
+            continue;
+        }
+        if (dist < 0.55) {
+            ch = SHADE_HEAVY;
+        }
+        else if (dist < 1.0) {
+            ch = SHADE_MID;
+        }
+        else {
+            ch = SHADE_LIGHT;
+        }
+        if (!color) {
+            s += ch;
+            continue;
+        }
+        if (dist < 1.0) {
+            const tint = styleGaugeMarker(color, c, stringInTune);
+            s += `${tint.open}${ch}${tint.close}`;
+        }
+        else {
+            s += formatTrackShade(color, i, centerIdx, ch);
+        }
+    }
+    return s;
+}
+/** Fixed width so the following gauge column does not drift (−50…+50, one decimal). */
+const CHROMATIC_CENTS_FIELD = 6;
+/** e.g. 1234.5 Hz — pad so bar starts at same column. */
+const HZ_FIELD = 8;
+/** String-target cents (integer), signed; keeps │ block width stable. */
+const STRING_CENTS_OFF_FIELD = 5;
+function formatSignedOneDecimal(value, fieldWidth) {
+    const sign = value >= 0 ? '+' : '-';
+    const abs = Math.abs(value).toFixed(1);
+    return `${sign}${abs}`.padStart(fieldWidth, ' ');
+}
+function formatHzField(hz) {
+    return `${hz.toFixed(1).padStart(HZ_FIELD, ' ')} Hz`;
+}
+function formatStringCentsOff(off) {
+    const s = off >= 0 ? `+${off.toFixed(0)}` : off.toFixed(0);
+    return s.padStart(STRING_CENTS_OFF_FIELD, ' ');
+}
+/** Info field: note, Hz, cents, optional string row (shared by all styles). */
+export function formatInfoLine(result, color) {
+    const centsStr = formatSignedOneDecimal(result.cents, CHROMATIC_CENTS_FIELD);
+    const n = styleNote(color);
+    const dim = styleDim(color);
+    const ct = styleCents(color, result.cents);
+    let line = `${n.open}${result.note}${result.octave}${n.close}` +
+        `  ${dim.open}${formatHzField(result.frequency)}${dim.close}` +
+        `  ${ct.open}${centsStr}¢${ct.close}`;
+    const cs = result.closestString;
+    if (cs) {
+        const off = formatStringCentsOff(cs.centsOff);
+        const ok = styleInTune(color);
+        const mark = cs.inTune ? `${ok.open} ✓${ok.close}` : '';
+        line += `  │ ${cs.name} ${off}¢${mark}`;
+    }
+    return line;
+}
+export function fitOneTTYLine(ansiLine, maxCols) {
+    const plain = stripAnsi(ansiLine);
+    if (plain.length <= maxCols)
+        return ansiLine;
+    const ell = '…';
+    const cut = Math.max(1, maxCols - ell.length);
+    return plain.slice(0, cut) + ell;
+}
+//# sourceMappingURL=format-line.js.map

package/dist/format-line.js.map

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

package/dist/index.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+import process from 'node:process';
+import { listAudioDevices, listInstruments, listTunings } from './cli-lists.js';
+import { createCliCommand, parseCliRuntime } from './parse-args.js';
+import { runTunerSession } from './run-tuner-session.js';
+/** Full help including `addHelpText('after', …)` (not just `helpInformation()`). */
+function printProgramHelp() {
+    const cmd = createCliCommand();
+    const parts = [];
+    cmd.configureOutput({
+        writeOut: (s) => parts.push(s),
+        writeErr: (s) => parts.push(s),
+    });
+    cmd.outputHelp();
+    process.stdout.write(parts.join(''));
+}
+async function main() {
+    let parsed;
+    try {
+        parsed = parseCliRuntime(process.argv);
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        console.error(msg);
+        printProgramHelp();
+        process.exitCode = 1;
+        return;
+    }
+    if (parsed.kind === 'help') {
+        printProgramHelp();
+        return;
+    }
+    if (parsed.kind === 'list-devices') {
+        listAudioDevices();
+        return;
+    }
+    if (parsed.kind === 'list-instruments') {
+        listInstruments();
+        return;
+    }
+    if (parsed.kind === 'list-tunings') {
+        if (!listTunings(parsed.instrumentId)) {
+            process.exitCode = 1;
+        }
+        return;
+    }
+    await runTunerSession(parsed.args);
+}
+void main().catch((e) => {
+    console.error(e instanceof Error ? e.message : e);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,OAAO,MAAM,cAAc,CAAA;AAClC,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC/E,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEnE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAExD,oFAAoF;AACpF,SAAS,gBAAgB;IACvB,MAAM,GAAG,GAAG,gBAAgB,EAAE,CAAA;IAC9B,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,GAAG,CAAC,eAAe,CAAC;QAClB,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9B,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;KAC/B,CAAC,CAAA;IACF,GAAG,CAAC,UAAU,EAAE,CAAA;IAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;AACtC,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,IAAI,MAAiB,CAAA;IACrB,IAAI,CAAC;QACH,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IACxC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;QACtD,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAClB,gBAAgB,EAAE,CAAA;QAClB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;QACpB,OAAM;IACR,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC3B,gBAAgB,EAAE,CAAA;QAClB,OAAM;IACR,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;QACnC,gBAAgB,EAAE,CAAA;QAClB,OAAM;IACR,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;QACvC,eAAe,EAAE,CAAA;QACjB,OAAM;IACR,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;QACnC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;YACtC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;QACtB,CAAC;QACD,OAAM;IACR,CAAC;IAED,MAAM,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;AACpC,CAAC;AAED,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;IACtB,OAAO,CAAC,KAAK,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACjD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;AACtB,CAAC,CAAC,CAAA"}

package/dist/input/keys.js

@@ -0,0 +1,88 @@
+import readline from 'node:readline';
+function isLetterChar(c) {
+    return (c >= 'a' && c <= 'z') || (c >= 'A' && c <= 'Z');
+}
+/**
+ * Decode readline keypress; Windows/ConPTY often differs from macOS/Linux (name vs sequence).
+ */
+export function parseMenuKey(key) {
+    if (!key)
+        return null;
+    const seq = key.sequence ?? '';
+    // Ctrl+C sends ETX in raw mode (especially Windows); does not always set key.name === 'c'
+    if (seq === '\u0003' || seq === '\x03') {
+        return { kind: 'ctrl-c' };
+    }
+    if (key.ctrl && (key.name === 'c' || seq === '\u0003')) {
+        return { kind: 'ctrl-c' };
+    }
+    if (key.name === 'up' || key.name === 'k')
+        return { kind: 'up' };
+    if (key.name === 'down' || key.name === 'j')
+        return { kind: 'down' };
+    if (key.name === 'left' || key.name === 'h')
+        return { kind: 'left' };
+    if (key.name === 'right' || key.name === 'l')
+        return { kind: 'right' };
+    if (key.name === 'return' || key.name === 'enter')
+        return { kind: 'enter' };
+    if (key.name === 'escape')
+        return { kind: 'escape' };
+    if (!key.ctrl && !key.meta) {
+        const name = key.name ?? '';
+        if (name.length === 1 && isLetterChar(name)) {
+            return { kind: 'letter', ch: name.toLowerCase() };
+        }
+        if (seq.length === 1) {
+            const ch0 = seq[0];
+            if (ch0 !== undefined && isLetterChar(ch0)) {
+                return { kind: 'letter', ch: ch0.toLowerCase() };
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Raw stdin + keypress events. Uninstall restores prior rawMode when possible.
+ */
+export function installKeypress(stdin) {
+    const listeners = new Set();
+    if (!stdin.isTTY) {
+        return {
+            onKey(fn) {
+                listeners.add(fn);
+            },
+            uninstall: () => {
+                listeners.clear();
+            },
+        };
+    }
+    readline.emitKeypressEvents(stdin);
+    stdin.setRawMode(true);
+    stdin.resume();
+    const handler = (_s, key) => {
+        const mk = parseMenuKey(key);
+        if (!mk)
+            return;
+        for (const fn of listeners) {
+            fn(mk);
+        }
+    };
+    stdin.on('keypress', handler);
+    return {
+        onKey(fn) {
+            listeners.add(fn);
+        },
+        uninstall() {
+            stdin.off('keypress', handler);
+            try {
+                stdin.setRawMode(false);
+            }
+            catch {
+                /* ignore */
+            }
+            listeners.clear();
+        },
+    };
+}
+//# sourceMappingURL=keys.js.map