memlnaut-nisps/codegen/lib.ts

52 lines
1.7 KiB
TypeScript
Raw Permalink Normal View History

refactor(codegen): codegen owns mode identity, per-mode schemas and net dims Phase 3 (S1, S5, S6, S25, L11, L37, ST11, ST12). Behaviour-preserving by construction: the diff on the generated directories is PURELY ADDITIVE (217 insertions, 0 deletions), so no emitted constant changed value. This moves where truth lives; it does not change what truth says. - S5: nine mode headers each carried a mechanically identical 12-field positional ParamSchema aggregate. codegen now emits one `inline constexpr ParamSchema k<Mode>Schema` per mode, and the struct itself moved into generated/schema_types.hpp. Each param_schema() is a one-line return. - S6 + S25: every mode hand-typed its net shape a second time as MLP template args, duplicating the schema's own dims. codegen emits a `<Mode>MLP` alias built from the already-emitted constants (not re-literalled), and all nine modes use it. NMaxExamples still defaults from kDefaultMaxExamples (Phase 2). - S1: model.ts hand-imported all nine schemas by name and hand-paired each with its overlay — so the SET of modes was hand-maintained and could silently drift from codegen. codegen now emits ALL_MODE_SCHEMAS; SCHEMA_MODE_OVERLAYS is purely display truth (label/glyph/css/order), which stays hand-curated. - L37: deleted the hand-written modeEngineId switch, which duplicated schema.engine_id and silently defaulted unknown modes to 'thru'. Routes on MFMode.engineId with exactly one documented exception: sound_analysis_midi declares engine_id 'thru' because its ModeBase audio slot really is NoOpEngine, while it separately drives the real AnalysisEngine. - L11: ExternalSynthMIDIMode's shape was literal in two places; now named once in an ext_synth_defaults namespace with an ExtSynthMIDIMLP alias. Full folding into the JSON pipeline is NOT done and the reason is recorded in-file: it is a template family over an externally-supplied Device and variable NOut, with no single (device, NOut) schema to author. - ST12: extracted codegen/lib.ts for the helpers both generators duplicated, and corrected the comment that claimed they had to be separate. Proof the extraction was behaviour-free: regenerating the MIDI-device outputs produces a byte-identical tree. - ST11: deleted codegen/templates/ — dead "reference" files no generator reads, already drifted from the real emitters. Gates: run-all-tests.sh ALL GREEN; codegen idempotent (re-running both generators yields no further diff), which is what CI's dirty-diff gate checks.
2026-07-21 14:02:23 +02:00
/**
* Shared helpers for the two codegen drivers (generate.ts mode schemas
* and generate-midi-devices.ts MIDI device templates).
*
* The two drivers stay separate FILES on purpose: they read different schema
* directories, validate against different meta-schemas, write to different
* output dirs, and generate.ts's golden test (codegen/tests/golden_test.ts)
* must not depend on MIDI-device schema state. None of that requires
* duplicating these small string/fs helpers they carry no per-driver
* behaviour, so they live here once (ST12, simplification 2026-07).
*/
import { readFileSync, existsSync, mkdirSync } from "node:fs";
/** Create a directory (and parents) if it doesn't already exist. */
export function ensureDir(d: string): void {
if (!existsSync(d)) {
mkdirSync(d, { recursive: true });
}
}
/** Read and JSON-parse a file. */
export function readJSON<T>(path: string): T {
return JSON.parse(readFileSync(path, "utf8")) as T;
}
/**
* Convert snake_case to PascalCase.
* "paf_synth" -> "PafSynth", "memlcelium" -> "Memlcelium"
*/
export function toPascalCase(snake: string): string {
return snake
.split("_")
.map(s => (s.length === 0 ? s : s[0].toUpperCase() + s.slice(1)))
.join("");
}
/**
* Escape a string literal for embedding into a C++ string.
* We expect ASCII identifiers + label text only; quote and backslash are escaped.
*/
export function cppStringLit(s: string): string {
return '"' + s.replace(/\\/g, "\\\\").replace(/"/g, '\\"') + '"';
}
/**
* Escape a string for a TS single-line single-quoted literal.
*/
export function tsStringLit(s: string): string {
return "'" + s.replace(/\\/g, "\\\\").replace(/'/g, "\\'") + "'";
}