@openmixer/omx-contract 1.3.0 → 2.0.0

package/data/kernels/deesser.json

@@ -1,101 +1,121 @@
 {
   "$schema": "../../schema/omx-contract.schema.json",
-  "DEESS_FREQ_RANGE": {
-    "kind": "travels",
-    "doc": "The detector band's CENTRE, in Hz. Sibilance lives at 5–10 kHz on most voices; 7 kHz with the default width covers 4 950–9 900 Hz, which is where an \"s\" and a \"t\" sit on a close vocal mic. The travel is wider than the come-up on both sides on purpose: a bright female vocal wants the band up near 9 kHz and a chesty male one down at 5, and a surface narrower than the row removes reach the console genuinely has (the same reasoning core's `REVERB_CUT_RANGE` records).",
-    "travel": {
-      "min": 2000,
-      "max": 16000,
-      "step": 10,
-      "unit": "Hz",
-      "default": 7000,
-      "defaultFrom": "desk"
+  "controls": [
+    {
+      "name": "deessFreq",
+      "kind": "travel",
+      "global": "DEESS_FREQ_RANGE",
+      "doc": "The detector band's CENTRE, in Hz. Sibilance lives at 5–10 kHz on most voices; 7 kHz with the default width covers 4 950–9 900 Hz, which is where an \"s\" and a \"t\" sit on a close vocal mic. The travel is wider than the come-up on both sides on purpose: a bright female vocal wants the band up near 9 kHz and a chesty male one down at 5, and a surface narrower than the row removes reach the console genuinely has (the same reasoning core's `REVERB_CUT_RANGE` records).",
+      "travel": {
+        "min": 2000,
+        "max": 16000,
+        "step": 10,
+        "unit": "Hz",
+        "default": 7000,
+        "defaultFrom": "desk"
+      }
+    },
+    {
+      "name": "deessWidth",
+      "kind": "travel",
+      "global": "DEESS_WIDTH_RANGE",
+      "doc": "The band's WIDTH, in OCTAVES around the centre: the edges are `f / 2^(w/2)` and `f · 2^(w/2)`, which is what makes the centre the geometric middle at every width. Octaves and not a Q, because a Q is a property of one section and this band is TWO (a highpass and a lowpass, `mix_deesser.h`) — an operator asked to dial a Q would be dialling a number neither filter carries. One octave is the classic de-esser band: wide enough for a sibilant that moves with the vowel, narrow enough that a 1 kHz vowel sits 27.8 dB down the skirt.",
+      "travel": {
+        "min": 0.25,
+        "max": 4,
+        "step": 0.05,
+        "unit": "oct",
+        "default": 1,
+        "defaultFrom": "desk"
+      }
+    },
+    {
+      "name": "deessThreshold",
+      "kind": "travel",
+      "global": "DEESS_THRESHOLD_RANGE",
+      "doc": "Where reduction starts — the level of the BAND, not of the strip, which is why the come-up is so much lower than the compressor's. A vocal peaking −12 dBFS carries roughly −30 dBFS in a one-octave band at 7 kHz on its sibilants and under −40 on its vowels, so −30 sits between the two and the stage opens on an \"s\" and stays shut on an \"ah\".",
+      "travel": {
+        "min": -60,
+        "max": 0,
+        "step": 0.5,
+        "unit": "dB",
+        "default": -30,
+        "defaultFrom": "desk"
+      }
+    },
+    {
+      "name": "deessRatio",
+      "kind": "travel",
+      "global": "DEESS_RATIO_RANGE",
+      "doc": "How hard the band is held once it is over the threshold. 4:1 is the textbook de-esser ratio: firm on the \"s\", short of a limiter.",
+      "travel": {
+        "min": 1,
+        "max": 20,
+        "step": 0.1,
+        "unit": "",
+        "default": 4,
+        "defaultFrom": "desk"
+      }
+    },
+    {
+      "name": "deessRange",
+      "kind": "travel",
+      "global": "DEESS_RANGE_RANGE",
+      "doc": "The FLOOR on the reduction, in dB and never positive — the deepest cut the stage may reach however loud the sibilant is (`mix_deesser.h`'s clamp, §4c). 12 dB tames a hard sibilant; past that a voice starts to lisp, and a de-esser with NO floor turns a shouted \"s\" into a hole. The ceiling is 0, which switches the reduction off without switching the stage off — a legitimate thing to want while dialling the band in by ear.",
+      "travel": {
+        "min": -24,
+        "max": 0,
+        "step": 0.5,
+        "unit": "dB",
+        "default": -12,
+        "defaultFrom": "desk"
+      }
+    },
+    {
+      "name": "deessAttack",
+      "kind": "travel",
+      "global": "DEESS_ATTACK_RANGE",
+      "doc": "The detector's ATTACK, in ms. A sibilant's onset is a few milliseconds; 1 ms catches it without the detector chattering on the band's own waveform.",
+      "travel": {
+        "min": 0.1,
+        "max": 50,
+        "step": 0.1,
+        "unit": "ms",
+        "default": 1,
+        "defaultFrom": "desk"
+      }
+    },
+    {
+      "name": "deessRelease",
+      "kind": "travel",
+      "global": "DEESS_RELEASE_RANGE",
+      "doc": "The detector's RELEASE, in ms. 60 ms is long enough not to modulate inside one \"s\" and short enough to be open again for the next syllable.",
+      "travel": {
+        "min": 5,
+        "max": 500,
+        "step": 1,
+        "unit": "ms",
+        "default": 60,
+        "defaultFrom": "desk"
+      }
+    },
+    {
+      "name": "deessMode",
+      "kind": "choice",
+      "global": "DEESS_MODES",
+      "doc": "The de-esser's modes, in the order of the integer the kernel reads: split attenuates the detected band only, wideband the whole signal while the sibilance lasts.",
+      "ids": [
+        "split",
+        "wideband"
+      ]
     }
-  },
-  "DEESS_WIDTH_RANGE": {
-    "kind": "travels",
-    "doc": "The band's WIDTH, in OCTAVES around the centre: the edges are `f / 2^(w/2)` and `f · 2^(w/2)`, which is what makes the centre the geometric middle at every width. Octaves and not a Q, because a Q is a property of one section and this band is TWO (a highpass and a lowpass, `mix_deesser.h`) — an operator asked to dial a Q would be dialling a number neither filter carries. One octave is the classic de-esser band: wide enough for a sibilant that moves with the vowel, narrow enough that a 1 kHz vowel sits 27.8 dB down the skirt.",
-    "travel": {
-      "min": 0.25,
-      "max": 4,
-      "step": 0.05,
-      "unit": "oct",
-      "default": 1,
-      "defaultFrom": "desk"
-    }
-  },
-  "DEESS_THRESHOLD_RANGE": {
-    "kind": "travels",
-    "doc": "Where reduction starts — the level of the BAND, not of the strip, which is why the come-up is so much lower than the compressor's. A vocal peaking −12 dBFS carries roughly −30 dBFS in a one-octave band at 7 kHz on its sibilants and under −40 on its vowels, so −30 sits between the two and the stage opens on an \"s\" and stays shut on an \"ah\".",
-    "travel": {
-      "min": -60,
-      "max": 0,
-      "step": 0.5,
-      "unit": "dB",
-      "default": -30,
-      "defaultFrom": "desk"
-    }
-  },
-  "DEESS_RATIO_RANGE": {
-    "kind": "travels",
-    "doc": "How hard the band is held once it is over the threshold. 4:1 is the textbook de-esser ratio: firm on the \"s\", short of a limiter.",
-    "travel": {
-      "min": 1,
-      "max": 20,
-      "step": 0.1,
-      "unit": "",
-      "default": 4,
-      "defaultFrom": "desk"
-    }
-  },
-  "DEESS_RANGE_RANGE": {
-    "kind": "travels",
-    "doc": "The FLOOR on the reduction, in dB and never positive — the deepest cut the stage may reach however loud the sibilant is (`mix_deesser.h`'s clamp, §4c). 12 dB tames a hard sibilant; past that a voice starts to lisp, and a de-esser with NO floor turns a shouted \"s\" into a hole. The ceiling is 0, which switches the reduction off without switching the stage off — a legitimate thing to want while dialling the band in by ear.",
-    "travel": {
-      "min": -24,
-      "max": 0,
-      "step": 0.5,
+  ],
+  "constants": {
+    "DEESS_KNEE_DB": {
+      "kind": "scalar",
+      "doc": "The knee, in dB — a CONSTANT of the stage and not a row field (`2026-09-22-native-deesser-stage.md` §4b): a de-esser without a soft knee latches audibly on the first sibilant of a phrase, and no other value of this number is a de-esser anyone would dial. The controller pushes it to the node and this is the same number; a second spelling would be a picture that disagrees with the audio about where the reduction starts.",
       "unit": "dB",
-      "default": -12,
-      "defaultFrom": "desk"
-    }
-  },
-  "DEESS_ATTACK_RANGE": {
-    "kind": "travels",
-    "doc": "The detector's ATTACK, in ms. A sibilant's onset is a few milliseconds; 1 ms catches it without the detector chattering on the band's own waveform.",
-    "travel": {
-      "min": 0.1,
-      "max": 50,
-      "step": 0.1,
-      "unit": "ms",
-      "default": 1,
-      "defaultFrom": "desk"
-    }
-  },
-  "DEESS_RELEASE_RANGE": {
-    "kind": "travels",
-    "doc": "The detector's RELEASE, in ms. 60 ms is long enough not to modulate inside one \"s\" and short enough to be open again for the next syllable.",
-    "travel": {
-      "min": 5,
-      "max": 500,
-      "step": 1,
-      "unit": "ms",
-      "default": 60,
-      "defaultFrom": "desk"
+      "value": 6
     }
-  },
-  "DEESS_KNEE_DB": {
-    "kind": "scalar",
-    "doc": "The knee, in dB — a CONSTANT of the stage and not a row field (`2026-09-22-native-deesser-stage.md` §4b): a de-esser without a soft knee latches audibly on the first sibilant of a phrase, and no other value of this number is a de-esser anyone would dial. The controller pushes it to the node and this is the same number; a second spelling would be a picture that disagrees with the audio about where the reduction starts.",
-    "unit": "dB",
-    "value": 6
-  },
-  "DEESS_MODES": {
-    "kind": "set",
-    "doc": "The de-esser's modes, in the order of the integer the kernel reads: split attenuates the detected band only, wideband the whole signal while the sibilance lasts.",
-    "ids": [
-      "split",
-      "wideband"
-    ]
   }
 }

package/data/kernels/delay.json

@@ -1,66 +1,76 @@
 {
   "$schema": "../../schema/omx-contract.schema.json",
-  "FX_DELAY_TIME_RANGE": {
-    "kind": "travels",
-    "doc": "The FX delay's time travel. `max` is the NATIVE ring's ceiling — the same number as `OMX_FXDELAY_MAX_MS` in `omx_delay.h`, pinned to it by `output-delay-ceiling.test.ts`. Distinct from the per-route ALIGNMENT delay (`OUTPUT_DELAY_RANGE`, 1 s, `OMX_DELAY_MAX_MS`): one is a musical echo with feedback and mix, the other is a pure latency. Two facts, two rings, two ceilings — sharing the word \"delay\" is why they keep being confused for each other.",
-    "travel": {
-      "min": 0,
-      "max": 2000,
-      "step": 1,
-      "unit": "ms",
-      "default": 300,
-      "defaultFrom": "desk"
+  "controls": [
+    {
+      "name": "fxDelayTime",
+      "kind": "travel",
+      "global": "FX_DELAY_TIME_RANGE",
+      "doc": "The FX delay's time travel. `max` is the NATIVE ring's ceiling — the same number as `OMX_FXDELAY_MAX_MS` in `omx_delay.h`, pinned to it by `output-delay-ceiling.test.ts`. Distinct from the per-route ALIGNMENT delay (`OUTPUT_DELAY_RANGE`, 1 s, `OMX_DELAY_MAX_MS`): one is a musical echo with feedback and mix, the other is a pure latency. Two facts, two rings, two ceilings — sharing the word \"delay\" is why they keep being confused for each other.",
+      "travel": {
+        "min": 0,
+        "max": 2000,
+        "step": 1,
+        "unit": "ms",
+        "default": 300,
+        "defaultFrom": "desk"
+      },
+      "c": {
+        "alias": {
+          "fact": "delay",
+          "field": "timeMs"
+        }
+      }
     },
-    "c": {
-      "alias": {
-        "fact": "delay",
-        "field": "timeMs"
+    {
+      "name": "fxDelayFeedback",
+      "kind": "travel",
+      "global": "FX_DELAY_FEEDBACK_RANGE",
+      "doc": "The FX delay's REGENERATION travel — how much of the wet tail feeds back in. Stops short of 1: unity feedback is a runaway the kernel hard-clamps anyway, so offering it would draw travel the DSP refuses. Not NORMALIZED_RANGE for exactly that reason — it is a 0..1 quantity whose top the DSP does not accept, and a control must not offer a value its actuator will eat.",
+      "travel": {
+        "min": 0,
+        "max": 0.99,
+        "step": 0,
+        "unit": "",
+        "default": 0.3,
+        "defaultFrom": "desk"
+      }
+    },
+    {
+      "name": "tone",
+      "kind": "travel",
+      "doc": "The FX delay's TONE — a NORMALIZED_RANGE instance with its own come-up value, matching `DEFAULT_DELAY_STATE.tone`. See REVERB_SIZE_RANGE for why this is a named constant rather than a default on the shared shape.",
+      "travel": {
+        "min": 0,
+        "max": 1,
+        "step": 0,
+        "unit": "",
+        "default": 0.3,
+        "defaultFrom": "desk"
+      }
+    },
+    {
+      "name": "mix",
+      "kind": "travel",
+      "doc": "The FX DELAY's wet/dry — the same split as REVERB_MIX_RANGE, its own declaration.",
+      "travel": {
+        "min": 0,
+        "max": 1,
+        "step": 0,
+        "unit": "",
+        "default": 0.3,
+        "defaultFrom": "desk",
+        "byKind": {
+          "fxReturn": 1
+        }
       }
     }
-  },
-  "FX_DELAY_FEEDBACK_RANGE": {
-    "kind": "travels",
-    "doc": "The FX delay's REGENERATION travel — how much of the wet tail feeds back in. Stops short of 1: unity feedback is a runaway the kernel hard-clamps anyway, so offering it would draw travel the DSP refuses. Not NORMALIZED_RANGE for exactly that reason — it is a 0..1 quantity whose top the DSP does not accept, and a control must not offer a value its actuator will eat.",
-    "travel": {
-      "min": 0,
-      "max": 0.99,
-      "step": 0,
-      "unit": "",
-      "default": 0.3,
-      "defaultFrom": "desk"
-    }
-  },
-  "DELAY_TONE_RANGE": {
-    "kind": "travels",
-    "doc": "The FX delay's TONE — a NORMALIZED_RANGE instance with its own come-up value, matching `DEFAULT_DELAY_STATE.tone`. See REVERB_SIZE_RANGE for why this is a named constant rather than a default on the shared shape.",
-    "travel": {
-      "min": 0,
-      "max": 1,
-      "step": 0,
-      "unit": "",
-      "default": 0.3,
-      "defaultFrom": "desk"
-    }
-  },
-  "DELAY_MIX_RANGE": {
-    "kind": "travels",
-    "doc": "The FX DELAY's wet/dry — the same split as REVERB_MIX_RANGE, its own declaration.",
-    "travel": {
-      "min": 0,
-      "max": 1,
-      "step": 0,
+  ],
+  "constants": {
+    "FX_DELAY_PINGPONG_DEFAULT": {
+      "kind": "scalar",
+      "doc": "The FX delay's PING-PONG come-up value — a toggle, so it has no travel, only this. Declared here rather than as a literal in the server's `DEFAULT_DELAY_STATE` (which now reads it) so the DPF plugin generator (`packages/omx-plugins/tools/params-gen.mjs`, `2026-09-25-omx-plugins-dpf.md` §3a) reads the same fact the desk seeds a fresh strip with.",
       "unit": "",
-      "default": 0.3,
-      "defaultFrom": "desk",
-      "byKind": {
-        "fxReturn": 1
-      }
+      "value": false
     }
-  },
-  "FX_DELAY_PINGPONG_DEFAULT": {
-    "kind": "scalar",
-    "doc": "The FX delay's PING-PONG come-up value — a toggle, so it has no travel, only this. Declared here rather than as a literal in the server's `DEFAULT_DELAY_STATE` (which now reads it) so the DPF plugin generator (`packages/omx-plugins/tools/params-gen.mjs`, `2026-09-25-omx-plugins-dpf.md` §3a) reads the same fact the desk seeds a fresh strip with.",
-    "unit": "",
-    "value": false
   }
 }

package/data/kernels/drive.json

@@ -1,122 +1,133 @@
 {
   "$schema": "../../schema/omx-contract.schema.json",
-  "DRIVE_BIAS_MAX": {
-    "kind": "scalar",
-    "doc": "The bias at `character = +1`, in the SHAPER's own input units — `OMX_DRIVE_BIAS_MAX`. DERIVED, not chosen (§4b). In the saturating limit every knee tends to `sgn`, the output is a rectangular wave of duty `d = ½ + asin(b)/π`, and its `n`th harmonic goes as `sin(nπd)/n` — so `|H2|` is maximal at `d = ¾`, which is `b = sin(π/4) = 1/√2` exactly. Measured too: the H2-maximising bias for a full-scale sine at unity drive is 0.712 (soft), 0.658 (tape), 0.645 (tube), and this one value costs 0.000 / 0.035 / 0.088 dB of H2 against each curve's own optimum. ONE normalised bias for all three knees, not three.",
-    "unit": "",
-    "value": {
-      "derive": "sqrt",
-      "of": 0.5
-    }
-  },
-  "DRIVE_AMOUNT_RANGE": {
-    "kind": "travels",
-    "doc": "The PRE-CURVE gain, in dB. 0 dB is unity into the curve, so a stage switched on at its defaults changes almost nothing — which is what an `on` switch should mean. The ceiling is where every curve is saturating hard on any signal a console carries.",
-    "travel": {
-      "min": 0,
-      "max": 36,
-      "step": 0.1,
-      "unit": "dB",
-      "default": 0,
-      "defaultFrom": "desk"
+  "controls": [
+    {
+      "name": "amount",
+      "kind": "travel",
+      "doc": "The PRE-CURVE gain, in dB. 0 dB is unity into the curve, so a stage switched on at its defaults changes almost nothing — which is what an `on` switch should mean. The ceiling is where every curve is saturating hard on any signal a console carries.",
+      "travel": {
+        "min": 0,
+        "max": 36,
+        "step": 0.1,
+        "unit": "dB",
+        "default": 0,
+        "defaultFrom": "desk"
+      },
+      "c": {
+        "alias": {
+          "fact": "drive",
+          "field": "driveDb"
+        }
+      }
     },
-    "c": {
-      "alias": {
-        "fact": "drive",
-        "field": "driveDb"
+    {
+      "name": "character",
+      "kind": "travel",
+      "doc": "The EVEN/ODD harmonic balance. −1 is pure odd (the curve itself), +1 is pure even, 0 an equal blend — the kernel splits its own distortion residue into an odd and an even half and fades between them, so the two ends are exact rather than approximate (`mix_drive.h`, measured: H2 at −317 dBc at −1, H3 at −118 dBc at +1). Unitless, and signed by construction. NOT NORMALIZED_RANGE: this is a BALANCE with a meaningful centre, and a 0..1 travel would put its centre at 0.5 and its neutral nowhere.",
+      "travel": {
+        "min": -1,
+        "max": 1,
+        "step": 0.01,
+        "unit": "",
+        "default": 0,
+        "defaultFrom": "desk"
+      },
+      "c": {
+        "alias": {
+          "fact": "drive",
+          "field": "character"
+        }
       }
-    }
-  },
-  "DRIVE_CHARACTER_RANGE": {
-    "kind": "travels",
-    "doc": "The EVEN/ODD harmonic balance. −1 is pure odd (the curve itself), +1 is pure even, 0 an equal blend — the kernel splits its own distortion residue into an odd and an even half and fades between them, so the two ends are exact rather than approximate (`mix_drive.h`, measured: H2 at −317 dBc at −1, H3 at −118 dBc at +1). Unitless, and signed by construction. NOT NORMALIZED_RANGE: this is a BALANCE with a meaningful centre, and a 0..1 travel would put its centre at 0.5 and its neutral nowhere.",
-    "travel": {
-      "min": -1,
-      "max": 1,
-      "step": 0.01,
-      "unit": "",
-      "default": 0,
-      "defaultFrom": "desk"
     },
-    "c": {
-      "alias": {
-        "fact": "drive",
-        "field": "character"
+    {
+      "name": "bandFreq",
+      "kind": "travel",
+      "doc": "The band split / tilt corner, in Hz. ONE travel for all three band modes, because the C imposes one constraint on all of them: it is the corner of a single biquad, and the split's other half is `x − LP(x)`. The full audio band, not the channel filters' narrower HPF/LPF pair — the same reasoning REVERB_CUT_RANGE records: a surface narrower than the row removes reach the console genuinely has.",
+      "travel": {
+        "min": 20,
+        "max": 20000,
+        "step": 1,
+        "unit": "Hz",
+        "default": 2000,
+        "defaultFrom": "desk"
+      },
+      "c": {
+        "alias": {
+          "fact": "drive",
+          "field": "bandHz"
+        }
       }
-    }
-  },
-  "DRIVE_BAND_FREQ_RANGE": {
-    "kind": "travels",
-    "doc": "The band split / tilt corner, in Hz. ONE travel for all three band modes, because the C imposes one constraint on all of them: it is the corner of a single biquad, and the split's other half is `x − LP(x)`. The full audio band, not the channel filters' narrower HPF/LPF pair — the same reasoning REVERB_CUT_RANGE records: a surface narrower than the row removes reach the console genuinely has.",
-    "travel": {
-      "min": 20,
-      "max": 20000,
-      "step": 1,
-      "unit": "Hz",
-      "default": 2000,
-      "defaultFrom": "desk"
     },
-    "c": {
-      "alias": {
-        "fact": "drive",
-        "field": "bandHz"
+    {
+      "name": "mix",
+      "kind": "travel",
+      "doc": "The wet/dry, as a PERCENT — the unit a drive control is read in on every desk that has one. Deliberately not NORMALIZED_RANGE (which is unitless 0..1): a mix a surface must label \"0.35\" when the operator thinks in \"35 %\" is a control whose declaration is fighting its reader. The kernel divides by 100 where it resolves the atom, in one place. The come-up is 100 %, not the reverb's modest 30: a saturator's insert use is IN the path. The `exciter` curve seeds itself lower (DRIVE_EXCITER_SEED), because that is a property of the TOPOLOGY and not of the travel.",
+      "travel": {
+        "min": 0,
+        "max": 100,
+        "step": 0.1,
+        "unit": "%",
+        "default": 100,
+        "defaultFrom": "desk"
+      },
+      "c": {
+        "alias": {
+          "fact": "drive",
+          "field": "mix"
+        }
       }
-    }
-  },
-  "DRIVE_MIX_RANGE": {
-    "kind": "travels",
-    "doc": "The wet/dry, as a PERCENT — the unit a drive control is read in on every desk that has one. Deliberately not NORMALIZED_RANGE (which is unitless 0..1): a mix a surface must label \"0.35\" when the operator thinks in \"35 %\" is a control whose declaration is fighting its reader. The kernel divides by 100 where it resolves the atom, in one place. The come-up is 100 %, not the reverb's modest 30: a saturator's insert use is IN the path. The `exciter` curve seeds itself lower (DRIVE_EXCITER_SEED), because that is a property of the TOPOLOGY and not of the travel.",
-    "travel": {
-      "min": 0,
-      "max": 100,
-      "step": 0.1,
-      "unit": "%",
-      "default": 100,
-      "defaultFrom": "desk"
     },
-    "c": {
-      "alias": {
-        "fact": "drive",
-        "field": "mix"
+    {
+      "name": "trim",
+      "kind": "travel",
+      "doc": "The POST-stage make-up, in dB. Symmetric enough either way that an operator can null the stage in and out against the bypass, which is how a colour stage is actually judged.",
+      "travel": {
+        "min": -24,
+        "max": 12,
+        "step": 0.1,
+        "unit": "dB",
+        "default": 0,
+        "defaultFrom": "desk"
+      },
+      "c": {
+        "alias": {
+          "fact": "drive",
+          "field": "trimDb"
+        }
       }
-    }
-  },
-  "DRIVE_TRIM_RANGE": {
-    "kind": "travels",
-    "doc": "The POST-stage make-up, in dB. Symmetric enough either way that an operator can null the stage in and out against the bypass, which is how a colour stage is actually judged.",
-    "travel": {
-      "min": -24,
-      "max": 12,
-      "step": 0.1,
-      "unit": "dB",
-      "default": 0,
-      "defaultFrom": "desk"
     },
-    "c": {
-      "alias": {
-        "fact": "drive",
-        "field": "trimDb"
+    {
+      "name": "curve",
+      "kind": "choice",
+      "doc": "The drive's shaper curves, in the order of the integer the kernel reads. Exciter runs the soft shape in a parallel-sum topology.",
+      "ids": [
+        "soft",
+        "tape",
+        "tube",
+        "exciter"
+      ]
+    },
+    {
+      "name": "band",
+      "kind": "choice",
+      "doc": "Which part of the spectrum the drive's curve is fed, in the order of the integer the kernel reads. The split is complementary, so mix 0 stays bit-identical to the dry signal.",
+      "ids": [
+        "full",
+        "low",
+        "high",
+        "tilt"
+      ]
+    }
+  ],
+  "constants": {
+    "DRIVE_BIAS_MAX": {
+      "kind": "scalar",
+      "doc": "The bias at `character = +1`, in the SHAPER's own input units — `OMX_DRIVE_BIAS_MAX`. DERIVED, not chosen (§4b). In the saturating limit every knee tends to `sgn`, the output is a rectangular wave of duty `d = ½ + asin(b)/π`, and its `n`th harmonic goes as `sin(nπd)/n` — so `|H2|` is maximal at `d = ¾`, which is `b = sin(π/4) = 1/√2` exactly. Measured too: the H2-maximising bias for a full-scale sine at unity drive is 0.712 (soft), 0.658 (tape), 0.645 (tube), and this one value costs 0.000 / 0.035 / 0.088 dB of H2 against each curve's own optimum. ONE normalised bias for all three knees, not three.",
+      "unit": "",
+      "value": {
+        "derive": "sqrt",
+        "of": 0.5
       }
     }
-  },
-  "DRIVE_CURVES": {
-    "kind": "set",
-    "doc": "The drive's shaper curves, in the order of the integer the kernel reads. Exciter runs the soft shape in a parallel-sum topology.",
-    "ids": [
-      "soft",
-      "tape",
-      "tube",
-      "exciter"
-    ]
-  },
-  "DRIVE_BANDS": {
-    "kind": "set",
-    "doc": "Which part of the spectrum the drive's curve is fed, in the order of the integer the kernel reads. The split is complementary, so mix 0 stays bit-identical to the dry signal.",
-    "ids": [
-      "full",
-      "low",
-      "high",
-      "tilt"
-    ]
   }
 }