1bb0ec5eed
JSON Schema Draft 2020-12 meta-schema (schemas/schema.json) plus 8 per-mode schemas authored against the firmware sources: - paf_synth (33 params, 7 voice spaces) - channel_strip (24 params, 6 voice spaces) - xiasri (24 params, direct mapping) - verb_fx (47 params, 12 voice spaces) - memlcelium (56 params, sequencer + dual PAF) - breakor (56 params, 8-track ratio sequencer) - elysiamorf (40 params, 8-track FM/CC sequencer) - sound_analysis_midi (8 params, audio-feature -> MIDI CC) schemas/modes/params_notes.md captures provenance and judgement calls for each mode.
111 lines
3.7 KiB
JSON
111 lines
3.7 KiB
JSON
{
|
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
"$id": "https://memlnaut/schemas/mode.schema.json",
|
|
"title": "MEMLNaut Mode Schema",
|
|
"description": "Describes the parameter contract, ML config, and UI hints for one MEMLNaut mode. Authoritative source: firmware C++ code under modes/ and voicespaces/. Codegen consumes this to emit C++ headers and TypeScript types.",
|
|
"type": "object",
|
|
"required": [
|
|
"mode_id",
|
|
"engine_id",
|
|
"ml",
|
|
"params",
|
|
"voice_spaces",
|
|
"ui"
|
|
],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"$schema": { "type": "string" },
|
|
"_note": {
|
|
"type": "string",
|
|
"description": "Free-text note from the schema author (e.g. about ranges that were guessed)."
|
|
},
|
|
"mode_id": {
|
|
"type": "string",
|
|
"pattern": "^[a-z][a-z0-9_]*$",
|
|
"description": "snake_case identifier for the mode. Must be unique."
|
|
},
|
|
"engine_id": {
|
|
"type": "string",
|
|
"pattern": "^[a-z][a-z0-9_]*$",
|
|
"description": "snake_case identifier for the audio engine the mode uses."
|
|
},
|
|
"ml": {
|
|
"type": "object",
|
|
"required": [
|
|
"input_channels",
|
|
"input_size",
|
|
"hidden_layers",
|
|
"output_size",
|
|
"default_spread",
|
|
"default_learning_rate",
|
|
"default_max_iterations"
|
|
],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"input_channels": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string",
|
|
"pattern": "^[a-z][a-z0-9_]*$"
|
|
},
|
|
"minItems": 1,
|
|
"description": "Names of abstract input channels (e.g. joy_x, midi_velocity, audio_pitch)."
|
|
},
|
|
"input_size": { "type": "integer", "minimum": 1 },
|
|
"hidden_layers": {
|
|
"type": "array",
|
|
"items": { "type": "integer", "minimum": 1 },
|
|
"minItems": 1
|
|
},
|
|
"output_size": { "type": "integer", "minimum": 1 },
|
|
"default_spread": { "type": "number", "minimum": 0.0, "maximum": 1.0 },
|
|
"default_learning_rate": { "type": "number", "exclusiveMinimum": 0.0 },
|
|
"default_max_iterations": { "type": "integer", "minimum": 1 }
|
|
}
|
|
},
|
|
"params": {
|
|
"type": "array",
|
|
"minItems": 1,
|
|
"items": {
|
|
"type": "object",
|
|
"required": ["name", "label", "min", "max", "default", "curve", "group"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"name": {
|
|
"type": "string",
|
|
"pattern": "^[a-z][a-z0-9_]*$",
|
|
"description": "snake_case identifier; unique within this mode."
|
|
},
|
|
"label": { "type": "string" },
|
|
"min": { "type": "number" },
|
|
"max": { "type": "number" },
|
|
"default": { "type": "number" },
|
|
"curve": {
|
|
"type": "string",
|
|
"enum": ["linear", "exp", "log", "square", "sqrt", "sigmoid", "cubic"]
|
|
},
|
|
"group": { "type": "string" },
|
|
"_note": { "type": "string" }
|
|
}
|
|
}
|
|
},
|
|
"voice_spaces": {
|
|
"type": "array",
|
|
"items": { "type": "string" },
|
|
"description": "Names of C++ voice space lambdas the mode supports. May be empty for engines with no voice spaces (e.g. sequencers)."
|
|
},
|
|
"ui": {
|
|
"type": "object",
|
|
"required": ["primary_input", "show_voice_space_selector", "show_synth_visualizer"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"primary_input": {
|
|
"type": "string",
|
|
"enum": ["xy_pad", "joystick", "sliders", "audio_in", "midi_in", "none"]
|
|
},
|
|
"show_voice_space_selector": { "type": "boolean" },
|
|
"show_synth_visualizer": { "type": "boolean" }
|
|
}
|
|
}
|
|
}
|
|
}
|