Clean release snapshot

2026-08-18 22:42:25 +00:00 · 2026-06-16 18:47:13 +02:00
commit 6c110398b4
574 changed files with 162566 additions and 0 deletions
@@ -0,0 +1,80 @@
+// Pins the fret-row label visibility and color rules in
+// plugins/highway_3d/screen.js.
+//
+// Rules:
+//   1. Only main frets (DOTS: 3,5,7,9,12,…) show a gray label by default.
+//      Non-dot frets outside the anchor range are skipped entirely.
+//   2. Every fret inside the active anchor range [f0, f1] shows a gold label,
+//      even if it is not a dot fret.
+//      f0 = anchor.fret,  f1 = anchor.fret + anchor.width - 1
+//      e.g. { fret:3, width:4 } → 3,4,5,6 gold (4 is not a dot fret).
+//
+// Source-level regex checks — no Three.js or DOM required.
+
+const { test } = require('node:test');
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const path = require('node:path');
+
+const SCREEN_JS = path.join(__dirname, '..', '..', 'plugins', 'highway_3d', 'screen.js');
+
+let _src;
+function src() {
+    if (!_src) _src = fs.readFileSync(SCREEN_JS, 'utf8');
+    return _src;
+}
+
+test('fret row uses anchorPlayedFretSpanAt to get anchor range [f0, f1]', () => {
+    // anchorPlayedFretSpanAt returns { f0: anchor.fret, f1: anchor.fret+width-1 }.
+    // This is the correct span for note labels (the played zone), distinct from
+    // the wire span used by fret wires (anchorLaneBoundsAt: dMin=fret-1, dMax=fret+width-1).
+    assert.match(
+        src(),
+        /anchorPlayedFretSpanAt\(\s*anchors\s*,\s*now\s*\)/,
+        'fret row must call anchorPlayedFretSpanAt(anchors, now)',
+    );
+});
+
+test('non-main frets outside anchor range are skipped (continue)', () => {
+    // The loop must skip frets that are neither in the anchor range nor a
+    // DOTS (main) fret, so non-dot frets never show a gray ghost label.
+    assert.match(
+        src(),
+        /if\s*\(\s*!isInAnchor\s*&&\s*!isMainFret\s*\)\s*continue\s*;/,
+        'fret row loop must skip non-anchor non-dot frets with: if (!isInAnchor && !isMainFret) continue',
+    );
+});
+
+test('in-anchor frets use FRET_LABEL_GOLD_HEX color', () => {
+    assert.match(
+        src(),
+        /isInAnchor\s*\?\s*FRET_LABEL_GOLD_HEX\s*:\s*FRET_LABEL_IDLE_HEX/,
+        'fret row color must be FRET_LABEL_GOLD_HEX when in anchor, FRET_LABEL_IDLE_HEX otherwise',
+    );
+});
+
+test('in-anchor frets use opacity 1.0, idle frets use opacity 0.55', () => {
+    assert.match(
+        src(),
+        /lb\.material\.opacity\s*=\s*isInAnchor\s*\?\s*1\.0\s*:\s*0\.55\s*;/,
+        'fret row opacity must be 1.0 in anchor and 0.55 idle',
+    );
+});
+
+test('isMainFret uses DOTS.includes(f) — same dot positions as fret wires and inlays', () => {
+    // Main frets are the dot-inlay positions (3,5,7,9,12,15,17,19,21,24).
+    // Reusing DOTS keeps the visible set consistent across all fret indicators.
+    assert.match(
+        src(),
+        /const\s+isMainFret\s*=\s*DOTS\.includes\(\s*f\s*\)/,
+        'isMainFret must be defined as DOTS.includes(f)',
+    );
+});
+
+test('isInAnchor checks anchorSpan.f0 and anchorSpan.f1 inclusive bounds', () => {
+    assert.match(
+        src(),
+        /f\s*>=\s*anchorSpan\.f0\s*&&\s*f\s*<=\s*anchorSpan\.f1/,
+        'isInAnchor must check f >= anchorSpan.f0 && f <= anchorSpan.f1',
+    );
+});