Files
feedBack/tests/js/highway_3d_fret_label_render_order.test.js
T
2026-06-16 18:47:13 +02:00

87 lines
3.7 KiB
JavaScript

// Pins the renderOrder of fret-number labels and connector/drop lines in
// plugins/highway_3d/screen.js.
//
// The 3D highway uses depth-proportional renderOrder values so near entities
// paint over far entities while same-depth sublayers stay deterministic. Fret
// numbers must be labels, not gem peers: they render above the note symbols so
// incoming gems never partially cover the digits.
//
// Same-note ordering:
// renderOrderForLayerAtZ(z, CHORD_FRAME) chord frame edge
// renderOrderForLayerAtZ(noteZ, CONNECTOR_LINE) connector / drop line
// renderOrderForLayerAtZ(noteZ, NOTE_OUTLINE) gem outline
// renderOrderForLayerAtZ(noteZ, NOTE_CORE) gem core
// renderOrderForLayerAtZ(noteZ, TECHNIQUE_MARKER) technique marker
// renderOrderForLayerAtZ(noteZ, NOTE_FRET_LABEL) primary fret number
// renderOrderForLayerAtZ(noteZ, ARP_NOTE_FRET_LABEL) arpeggio fret-number tie-breaker
//
// 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;
/** Returns the cached 3D highway screen source under test. */
function src() {
if (!_src) _src = fs.readFileSync(SCREEN_JS, 'utf8');
return _src;
}
test('connector line uses the named connector layer', () => {
assert.match(
src(),
/line\.renderOrder\s*=\s*renderOrderForLayerAtZ\(\s*noteZ\s*,\s*_isArpNote\s*\?\s*'ARP_CONNECTOR_LINE'\s*:\s*'CONNECTOR_LINE'\s*\)\s*;/,
'pConnectorLine renderOrder must use the connector layer names',
);
});
test('primary fret label renders above gem core and technique markers', () => {
assert.match(
src(),
/fretLabel\.renderOrder\s*=\s*renderOrderForLayerAtZ\(\s*noteZ\s*,\s*_isArpNote\s*\?\s*'ARP_NOTE_FRET_LABEL'\s*:\s*'NOTE_FRET_LABEL'\s*\)\s*;/,
'pNoteFretLabel renderOrder must use the fret-label layer names',
);
});
test('synthetic chord fret label uses the same label layer as primary labels', () => {
assert.match(
src(),
/fl2\.renderOrder\s*=\s*renderOrderForLayerAtZ\(\s*noteZ\s*,\s*_isArp2\s*\?\s*'ARP_NOTE_FRET_LABEL'\s*:\s*'NOTE_FRET_LABEL'\s*\)\s*;/,
'fl2 renderOrder must use the same fret-label layer names',
);
});
test('drop line uses the named connector layer below gems', () => {
assert.match(
src(),
/dl\.renderOrder\s*=\s*renderOrderForLayerAtZ\(\s*noteZ\s*,\s*'CONNECTOR_LINE'\s*\)\s*;/,
'pDropLine renderOrder must use CONNECTOR_LINE',
);
});
test('chord-loop fret labels render above same-depth gem symbols', () => {
assert.match(
src(),
/lbl\.renderOrder\s*=\s*renderOrderForLayerAtZ\(\s*z\s*,\s*'CHORD_FRET_LABEL'\s*\)\s*;/,
'chord-loop fret label must use CHORD_FRET_LABEL',
);
});
test('chord frame and note outline use named depth-layer helper calls', () => {
assert.match(src(), /const\s+chordFrameRenderOrder\s*=\s*renderOrderForLayerAtZ\(\s*z\s*,\s*'CHORD_FRAME'\s*\)\s*;/);
assert.match(src(), /outline\.renderOrder\s*=\s*renderOrderForLayerAtZ\(\s*noteZ\s*,\s*'NOTE_OUTLINE'\s*\)\s*;/);
});
test('no fixed low renderOrder assignments remain for affected label paths', () => {
const s = src();
assert.doesNotMatch(s, /fretLabel\.renderOrder\s*=\s*(?:16|23)\s*;/);
assert.doesNotMatch(s, /fl2\.renderOrder\s*=\s*(?:16|23)\s*;/);
assert.doesNotMatch(s, /lbl\.renderOrder\s*=\s*21\s*;/);
assert.doesNotMatch(s, /line\.renderOrder\s*=\s*_isArpNote\s*\?\s*22\s*:\s*15\s*;/);
assert.doesNotMatch(s, /dl\.renderOrder\s*=\s*22\s*;/);
});