History

monkey-w1n5t0n 0d1a2102eb feat(manifold)!: P1 — retire playground/, manifold is the sole browser app Playground archived at branch archive/playground-solidjs (tag playground-solidjs-final) and deleted from main. Retargets: - run-all-tests.sh stage 5 → manifold (typecheck + bun test + build + playwright via non-snap node runner, BUILD-PLAN gotcha) - ci.yml playground-tests → manifold-tests; osc-bridge.yml → manifold/osc-bridge (was already broken: playground/osc-bridge no longer existed) - codegen: TS emission target removed (returns at P5 → manifold); golden test now C++-only; TS emitters retained dormant - .gitignore: manifold/osc-bridge paths; drop dead playground faust exception - docs: AGENTS.md gates, README quickstart, MAP.md, ALIGNMENT.md (C15 now archive-only — defect #1 updated), AGENT-REFERENCE.md, specs/MAIN.md Part of docs/specs/plans/one-core-engine-refactor.md P1.		2026-07-13 23:27:56 +02:00
..
templates	Add codegen tool: schemas -> C++ headers + TS modules	2026-04-29 15:29:08 +03:00
tests	feat(manifold)!: P1 — retire playground/, manifold is the sole browser app	2026-07-13 23:27:56 +02:00
.gitignore	Add codegen tool: schemas -> C++ headers + TS modules	2026-04-29 15:29:08 +03:00
generate-midi-devices.ts	feat(midi-devices): canonical external-synth CC templates + dual codegen	2026-06-28 20:03:17 +02:00
generate.ts	feat(manifold)!: P1 — retire playground/, manifold is the sole browser app	2026-07-13 23:27:56 +02:00
package.json	Add codegen tool: schemas -> C++ headers + TS modules	2026-04-29 15:29:08 +03:00
README.md	Add codegen tool: schemas -> C++ headers + TS modules	2026-04-29 15:29:08 +03:00
seed-midi-devices.ts	feat(midi-devices): canonical external-synth CC templates + dual codegen	2026-06-28 20:03:17 +02:00
tsconfig.json	Add codegen tool: schemas -> C++ headers + TS modules	2026-04-29 15:29:08 +03:00

README.md

MEMLNaut Mode-Schema Codegen

Bun + TypeScript tool that turns schemas/modes/*.json into:

C++ headers under nisps/modes/generated/<mode_id>_schema.hpp (constexpr data, no runtime cost).
TypeScript modules under playground/src/modes/generated/<mode_id>_schema.ts (typed ModeSchema objects).

The schemas are validated against schemas/schema.json (JSON Schema Draft 2020-12) on every run. Codegen exits non-zero if any schema fails validation.

Run

cd codegen
bun install        # one-shot, fetches ajv + types
bun run generate.ts   # or: bun run generate

The script writes everything into the two output dirs in one shot. Re-running with no schema changes is a no-op (byte-identical output).

Tests

tests/golden_test.ts regenerates from the live schemas into a temp dir and diffs against tests/golden/. The golden directory contains a snapshot of paf_synth_schema.{hpp,ts}. To refresh after intentional codegen changes:

bun run generate.ts
cp ../nisps/modes/generated/paf_synth_schema.hpp tests/golden/
cp ../playground/src/modes/generated/paf_synth_schema.ts tests/golden/

Run the test:

bun run test

Adding a new mode

Drop a new <mode_id>.json into schemas/modes/ (must validate against schemas/schema.json).
Run bun run generate.ts.
Commit the JSON + the regenerated C++/TS pair.

Layout

codegen/
├── package.json         # ajv (+ formats) + bun-types
├── tsconfig.json
├── generate.ts          # ~400 lines, single entrypoint
├── README.md            # this file
├── templates/           # reference templates (NOT consumed — for review)
│   ├── cpp_schema.hpp.template
│   └── ts_schema.ts.template
└── tests/
    ├── golden_test.ts   # diffs latest output against tests/golden/
    └── golden/
        ├── paf_synth_schema.hpp
        └── paf_synth_schema.ts

Conventions

C++ namespace: nisps::modes::generated. All generated symbols are inline constexpr so #include-ing the header in multiple TUs is safe.
C++ types: std::array, std::string_view, std::size_t. No std::vector, no heap.
Curve enum: declared in nisps/modes/generated/schema_types.hpp as a temporary local copy. Once stream 1 lands nisps/core/math.hpp, replace the local enum with an #include (search for TODO(stream-1) in the generated header).
Float literals: emitted with explicit .f suffix and decimal point, per the perf contract (architecture §3.3).
Order: schemas are processed in alphabetical order of mode_id so output is stable.
Naming: mode_id is snake_case in JSON; the generated C++ const prefix is k + PascalCase (e.g. kPafSynthParams); TS const is PascalCase + Schema (e.g. PafSynthSchema).