Files
feedBack/tests/js/tuning_display.test.js
T
9d0bf95716 refactor(ui)!: remove the classic v2 shell — v3 is the only UI (R3a) (#871)
* refactor(ui)!: remove the classic v2 shell — v3 is the only UI (R3a)

Deletes `static/index.html`, the `/v2` route, and the `FEEDBACK_UI` v2/legacy
opt-out. `/` and `/v3` both serve `static/v3/index.html`, which has been the
default since 0.3.0.

This is step 0 of the core-frontend ES-module migration (R3a). Both shells load
the same `static/app.js`, so every later step of that migration — exposing the
window contract, the `defer` ordering fix, the `type="module"` flips — would
otherwise have to be made and verified twice. Removing the fallback now halves
that surface before any of it is touched.

Incidentally fixes a latent bug in `index()`: its guard read
`if getenv_compat("FEEDBACK_UI") or getenv_compat("FEEDBACK_UI") in ("v2", "legacy")`,
whose left operand is truthy for *any* non-empty value — so `FEEDBACK_UI=v3`
actually served the **v2** shell.

- `static/tailwind.min.css` regenerated: the content globs scanned the deleted
  file, so v2-only utility classes are now purged (CI's tailwind-fresh job
  rebuilds and diffs it).
- Constitution amended to 1.3.0 — Principle II's frontend file list now names
  `static/v3/index.html`.
- Tests: 4 suites read the v2 shell (3 via a constructed `path.join` that a
  literal grep misses). Their v2 halves are paired duplicates of v3 tests that
  stay, so they are dropped; `alpha_warning_banner` and the capability-registry
  script-order test retarget to `static/v3/index.html`.

BREAKING CHANGE: `FEEDBACK_UI=v2` / `=legacy` and the `/v2` route are gone.
Unset the variable and use `/`. No chart, settings, or plugin data changes, and
no plugin API changes — v3 reuses the same engine.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* docs: drop the stale '/ is v2' plugin-verification guidance (CodeRabbit)

The v3-only rewrite updated the intro paragraphs but left three lines that
still instructed plugin authors to verify in 'both / (v2) and /v3' — now the
same shell. Historical 'in v2 it was X' contrasts are kept: they still orient
authors whose plugins also ship to users on older cores.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-11 16:33:03 +02:00

110 lines
4.5 KiB
JavaScript

'use strict';
const { test } = require('node:test');
const assert = require('node:assert/strict');
const fs = require('node:fs');
const path = require('node:path');
const vm = require('node:vm');
const APP_JS = path.join(__dirname, '..', '..', 'static', 'app.js');
const HIGHWAY_JS = path.join(__dirname, '..', '..', 'static', 'highway.js');
const V3_HTML = path.join(__dirname, '..', '..', 'static', 'v3', 'index.html');
function extractBlock(src, startMarker) {
const start = src.indexOf(startMarker);
if (start === -1) throw new Error(`extractBlock: '${startMarker}' not found`);
const openBrace = src.indexOf('{', start);
let depth = 1;
let i = openBrace + 1;
while (i < src.length && depth > 0) {
const ch = src[i];
if (ch === '{') depth++;
else if (ch === '}') depth--;
i++;
}
if (depth !== 0) throw new Error(`extractBlock: unbalanced braces after '${startMarker}'`);
return src.slice(start, i);
}
function loadTuningDisplayHelpers() {
const src = fs.readFileSync(APP_JS, 'utf8');
const block = [
extractBlock(src, 'function _looksLikeRawTuningOffsets('),
extractBlock(src, 'function _tuningNameFromOffsets('),
extractBlock(src, 'function parseRawTuningOffsets('),
extractBlock(src, 'function displayTuningName('),
].join('\n');
const sandbox = { window: { feedBack: {} }, exports: {} };
vm.createContext(sandbox);
vm.runInContext(block + '\nexports.displayTuningName = displayTuningName;', sandbox);
return sandbox.exports;
}
const TUNER_UI_JS = path.join(__dirname, '..', '..', 'plugins', 'tuner', 'utils', 'ui.js');
const { displayTuningName } = loadTuningDisplayHelpers();
test('displayTuningName passes through known labels', () => {
assert.equal(displayTuningName('E Standard'), 'E Standard');
assert.equal(displayTuningName('Drop D'), 'Drop D');
assert.equal(displayTuningName('Eb Standard'), 'Eb Standard');
});
test('displayTuningName sanitizes raw offset strings to Custom Tuning', () => {
assert.equal(displayTuningName('-2000-2'), 'Custom Tuning');
assert.equal(displayTuningName('-2 0 0 0 -2'), 'Custom Tuning');
assert.equal(displayTuningName('-3,-1,0,1,2,3'), 'Custom Tuning');
});
test('displayTuningName names a known raw offset string (feedBack#867)', () => {
// Now that the API serves raw offsets, a known tuning passed as a raw
// string must resolve to its real name, not collapse to Custom Tuning.
assert.equal(displayTuningName('-1 -1 -1 -1 -1 -1'), 'Eb Standard');
assert.equal(displayTuningName('-2 0 0 0 0 0'), 'Drop D');
assert.equal(displayTuningName('-2,0,0,0,-2,0'), 'DADGAD');
// Genuinely custom offsets still read Custom Tuning.
assert.equal(displayTuningName('-2 0 0 0 -2 1'), 'Custom Tuning');
});
test('displayTuningName recognizes 4/5-string uniform standard (feedBack#867)', () => {
// A normal 4-string bass [0,0,0,0] must not fall through to Custom Tuning.
assert.equal(displayTuningName(null, [0, 0, 0, 0]), 'E Standard');
assert.equal(displayTuningName(null, [-2, -2, -2, -2]), 'D Standard');
assert.equal(displayTuningName('0 0 0 0'), 'E Standard');
});
test('displayTuningName derives readable names from offsets when value missing', () => {
assert.equal(displayTuningName(null, [0, 0, 0, 0, 0, 0]), 'E Standard');
assert.equal(displayTuningName('', [0, 0, 0, 0, 0, 0]), 'E Standard');
assert.equal(displayTuningName(undefined, [-2, 0, 0, 0, 0, 0]), 'Drop D');
});
test('displayTuningName returns Custom Tuning for unknown offsets', () => {
assert.equal(displayTuningName(null, [-2, 0, 0, 0, -2]), 'Custom Tuning');
assert.equal(displayTuningName('-2 0 0 0 -2', [-2, 0, 0, 0, -2]), 'Custom Tuning');
});
test('displayTuningName returns empty when nothing usable', () => {
assert.equal(displayTuningName(''), '');
assert.equal(displayTuningName(null), '');
assert.equal(displayTuningName('Unknown'), '');
assert.equal(displayTuningName(null, []), '');
});
test('V3 index.html defines hud-tuning', () => {
const html = fs.readFileSync(V3_HTML, 'utf8');
assert.match(html, /id="hud-tuning"/);
});
test('highway.js updates hud-tuning from song_info tuning offsets', () => {
const src = fs.readFileSync(HIGHWAY_JS, 'utf8');
assert.match(src, /getElementById\('hud-tuning'\)/);
assert.match(src, /displayTuningName\(null, msg\.tuning\)/);
assert.match(src, /Tuning: /);
});
test('V3 index.html defines hud-tuning-targets', () => {
const html = fs.readFileSync(V3_HTML, 'utf8');
assert.match(html, /id="hud-tuning-targets"/);
});