@openmixer/omx-contract 1.0.0 → 1.2.0

package/share/omx-contract/omx-contract.json

@@ -1,7 +1,25 @@
 {
   "name": "@openmixer/omx-contract",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "items": {
+    "PAN_RANGE": {
+      "rel": "data/kernels/balance.json",
+      "kind": "travels",
+      "doc": "The PAN travel — −1 (hard left) … 0 (center) … +1 (hard right). A property of the pan law itself, not of any desk, so it is declared once. Continuous: a pan position has no quantum, and panGains clamps to these bounds.",
+      "c": {
+        "alias": {
+          "fact": "pan",
+          "field": "pan"
+        }
+      },
+      "shape": "travel",
+      "value": {
+        "min": -1,
+        "max": 1,
+        "step": 0,
+        "unit": ""
+      }
+    },
     "CHORUS_SPREAD_RANGE": {
       "rel": "data/kernels/chorus.json",
       "kind": "travels",
@@ -16,6 +34,62 @@
         "defaultFrom": "desk"
       }
     },
+    "CHORUS_RATE_RANGE": {
+      "rel": "data/kernels/chorus.json",
+      "kind": "travels",
+      "doc": "The chorus sweep's speed (§3a). Above ~3 Hz it stops being a chorus and becomes a vibrato.",
+      "shape": "travel",
+      "value": {
+        "min": 0.05,
+        "max": 8,
+        "step": 0.01,
+        "unit": "Hz",
+        "default": 0.6,
+        "defaultFrom": "desk"
+      }
+    },
+    "CHORUS_DEPTH_RANGE": {
+      "rel": "data/kernels/chorus.json",
+      "kind": "travels",
+      "doc": "The chorus's peak-to-peak excursion above its declared 10 ms base (§3a).",
+      "shape": "travel",
+      "value": {
+        "min": 0,
+        "max": 12,
+        "step": 0.1,
+        "unit": "ms",
+        "default": 4,
+        "defaultFrom": "desk"
+      }
+    },
+    "CHORUS_VOICES_RANGE": {
+      "rel": "data/kernels/chorus.json",
+      "kind": "travels",
+      "doc": "The chorus's tap count — one oscillator read at k/N (§3a).",
+      "shape": "travel",
+      "value": {
+        "min": 1,
+        "max": 4,
+        "step": 1,
+        "unit": "",
+        "default": 3,
+        "defaultFrom": "desk"
+      }
+    },
+    "CHORUS_MIX_RANGE": {
+      "rel": "data/kernels/chorus.json",
+      "kind": "travels",
+      "doc": "The chorus's wet/dry, as an instance of DRIVE_MIX_RANGE — the same percent travel, its own come-up value: 35 %, a colour under the dry on a strip (§3a). The REVERB_LOWCUT_RANGE-over- REVERB_CUT_RANGE shape: one travel, one declared default per field that reads it.",
+      "shape": "travel",
+      "value": {
+        "min": 0,
+        "max": 100,
+        "step": 0.1,
+        "unit": "%",
+        "default": 35,
+        "defaultFrom": "desk"
+      }
+    },
     "COMP_LIMITS": {
       "rel": "data/kernels/comp.json",
       "kind": "travels",
@@ -97,6 +171,111 @@
         }
       }
     },
+    "DEESS_FREQ_RANGE": {
+      "rel": "data/kernels/deesser.json",
+      "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).",
+      "shape": "travel",
+      "value": {
+        "min": 2000,
+        "max": 16000,
+        "step": 10,
+        "unit": "Hz",
+        "default": 7000,
+        "defaultFrom": "desk"
+      }
+    },
+    "DEESS_WIDTH_RANGE": {
+      "rel": "data/kernels/deesser.json",
+      "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.",
+      "shape": "travel",
+      "value": {
+        "min": 0.25,
+        "max": 4,
+        "step": 0.05,
+        "unit": "oct",
+        "default": 1,
+        "defaultFrom": "desk"
+      }
+    },
+    "DEESS_THRESHOLD_RANGE": {
+      "rel": "data/kernels/deesser.json",
+      "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\".",
+      "shape": "travel",
+      "value": {
+        "min": -60,
+        "max": 0,
+        "step": 0.5,
+        "unit": "dB",
+        "default": -30,
+        "defaultFrom": "desk"
+      }
+    },
+    "DEESS_RATIO_RANGE": {
+      "rel": "data/kernels/deesser.json",
+      "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.",
+      "shape": "travel",
+      "value": {
+        "min": 1,
+        "max": 20,
+        "step": 0.1,
+        "unit": "",
+        "default": 4,
+        "defaultFrom": "desk"
+      }
+    },
+    "DEESS_RANGE_RANGE": {
+      "rel": "data/kernels/deesser.json",
+      "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.",
+      "shape": "travel",
+      "value": {
+        "min": -24,
+        "max": 0,
+        "step": 0.5,
+        "unit": "dB",
+        "default": -12,
+        "defaultFrom": "desk"
+      }
+    },
+    "DEESS_ATTACK_RANGE": {
+      "rel": "data/kernels/deesser.json",
+      "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.",
+      "shape": "travel",
+      "value": {
+        "min": 0.1,
+        "max": 50,
+        "step": 0.1,
+        "unit": "ms",
+        "default": 1,
+        "defaultFrom": "desk"
+      }
+    },
+    "DEESS_RELEASE_RANGE": {
+      "rel": "data/kernels/deesser.json",
+      "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.",
+      "shape": "travel",
+      "value": {
+        "min": 5,
+        "max": 500,
+        "step": 1,
+        "unit": "ms",
+        "default": 60,
+        "defaultFrom": "desk"
+      }
+    },
+    "DEESS_KNEE_DB": {
+      "rel": "data/kernels/deesser.json",
+      "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
+    },
     "FX_DELAY_TIME_RANGE": {
       "rel": "data/kernels/delay.json",
       "kind": "travels",
@@ -176,6 +355,106 @@
       "unit": "",
       "value": 0.7071067811865476
     },
+    "DRIVE_AMOUNT_RANGE": {
+      "rel": "data/kernels/drive.json",
+      "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.",
+      "c": {
+        "alias": {
+          "fact": "drive",
+          "field": "driveDb"
+        }
+      },
+      "shape": "travel",
+      "value": {
+        "min": 0,
+        "max": 36,
+        "step": 0.1,
+        "unit": "dB",
+        "default": 0,
+        "defaultFrom": "desk"
+      }
+    },
+    "DRIVE_CHARACTER_RANGE": {
+      "rel": "data/kernels/drive.json",
+      "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.",
+      "c": {
+        "alias": {
+          "fact": "drive",
+          "field": "character"
+        }
+      },
+      "shape": "travel",
+      "value": {
+        "min": -1,
+        "max": 1,
+        "step": 0.01,
+        "unit": "",
+        "default": 0,
+        "defaultFrom": "desk"
+      }
+    },
+    "DRIVE_BAND_FREQ_RANGE": {
+      "rel": "data/kernels/drive.json",
+      "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.",
+      "c": {
+        "alias": {
+          "fact": "drive",
+          "field": "bandHz"
+        }
+      },
+      "shape": "travel",
+      "value": {
+        "min": 20,
+        "max": 20000,
+        "step": 1,
+        "unit": "Hz",
+        "default": 2000,
+        "defaultFrom": "desk"
+      }
+    },
+    "DRIVE_MIX_RANGE": {
+      "rel": "data/kernels/drive.json",
+      "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.",
+      "c": {
+        "alias": {
+          "fact": "drive",
+          "field": "mix"
+        }
+      },
+      "shape": "travel",
+      "value": {
+        "min": 0,
+        "max": 100,
+        "step": 0.1,
+        "unit": "%",
+        "default": 100,
+        "defaultFrom": "desk"
+      }
+    },
+    "DRIVE_TRIM_RANGE": {
+      "rel": "data/kernels/drive.json",
+      "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.",
+      "c": {
+        "alias": {
+          "fact": "drive",
+          "field": "trimDb"
+        }
+      },
+      "shape": "travel",
+      "value": {
+        "min": -24,
+        "max": 12,
+        "step": 0.1,
+        "unit": "dB",
+        "default": 0,
+        "defaultFrom": "desk"
+      }
+    },
     "EQ_MAX_BANDS": {
       "rel": "data/kernels/eq.json",
       "kind": "scalar",
@@ -232,6 +511,134 @@
       "unit": "",
       "value": 31
     },
+    "EQ_FREQ_RANGE": {
+      "rel": "data/kernels/eq.json",
+      "kind": "travels",
+      "doc": "The frequency band a parametric band can be dragged across.",
+      "shape": "travel",
+      "value": {
+        "min": 20,
+        "max": 20000,
+        "step": 10,
+        "unit": "Hz"
+      }
+    },
+    "EQ_GAIN_RANGE": {
+      "rel": "data/kernels/eq.json",
+      "kind": "travels",
+      "doc": "The parametric-band gain travel, in dB. The ± scalar `clampEqGain` enforces is READ off this (`core/src/eq.ts` derives `EQ_GAIN_LIMIT_DB` from `max`), so the bound is stated once and a surface cannot draw a wider knob than the clamp will honour.",
+      "shape": "travel",
+      "value": {
+        "min": -15,
+        "max": 15,
+        "step": 0.5,
+        "unit": "dB"
+      }
+    },
+    "EQ_Q_RANGE": {
+      "rel": "data/kernels/eq.json",
+      "kind": "travels",
+      "doc": "The Q (resonance) extent of a parametric band.",
+      "shape": "travel",
+      "value": {
+        "min": 0.3,
+        "max": 8,
+        "step": 0.1,
+        "unit": ""
+      }
+    },
+    "EQ_NOTCH_Q_RANGE": {
+      "rel": "data/kernels/eq.json",
+      "kind": "travels",
+      "doc": "The Q extent of a NOTCH band. Wider than EQ_Q_RANGE on purpose (#116, operator decision): an ultra-narrow surgical cut is the notch shape's whole point — the FBS ring-out pool plants dbx-AFS-style ring killers at Q ≈ 116 (~1/80 octave), inaudible on program yet fatal to a single ringing frequency. Gain-carrying shapes stay bounded at EQ_Q_RANGE — a Q-116 bell is a resonator, not an EQ move.",
+      "shape": "travel",
+      "value": {
+        "min": 0.3,
+        "max": 116,
+        "step": 1,
+        "unit": ""
+      }
+    },
+    "HPF_FREQ_RANGE": {
+      "rel": "data/kernels/eq.json",
+      "kind": "travels",
+      "doc": "Where the HPF cutoff can sit (low end); mirrors the drawn low-frequency handle.",
+      "shape": "travel",
+      "value": {
+        "min": 20,
+        "max": 1000,
+        "step": 10,
+        "unit": "Hz"
+      }
+    },
+    "LPF_FREQ_RANGE": {
+      "rel": "data/kernels/eq.json",
+      "kind": "travels",
+      "doc": "Where the LPF cutoff can sit (high end).",
+      "shape": "travel",
+      "value": {
+        "min": 1000,
+        "max": 20000,
+        "step": 10,
+        "unit": "Hz"
+      }
+    },
+    "FLANGER_RATE_RANGE": {
+      "rel": "data/kernels/flanger.json",
+      "kind": "travels",
+      "doc": "The flanger's jet sweep (§3b).",
+      "shape": "travel",
+      "value": {
+        "min": 0.05,
+        "max": 5,
+        "step": 0.01,
+        "unit": "Hz",
+        "default": 0.25,
+        "defaultFrom": "desk"
+      }
+    },
+    "FLANGER_DEPTH_RANGE": {
+      "rel": "data/kernels/flanger.json",
+      "kind": "travels",
+      "doc": "The flanger's peak-to-peak excursion above its declared 0.5 ms base (§3b).",
+      "shape": "travel",
+      "value": {
+        "min": 0,
+        "max": 5,
+        "step": 0.1,
+        "unit": "ms",
+        "default": 2,
+        "defaultFrom": "desk"
+      }
+    },
+    "FLANGER_FEEDBACK_RANGE": {
+      "rel": "data/kernels/flanger.json",
+      "kind": "travels",
+      "doc": "The flanger's SIGNED resonance (§3b). The ±0.95 clamp is DECLARED here — a PATCH asking for 1.0 is answered by this travel — and the kernel's own clamp is the enforcement half.",
+      "shape": "travel",
+      "value": {
+        "min": -0.95,
+        "max": 0.95,
+        "step": 0.01,
+        "unit": "",
+        "default": 0.6,
+        "defaultFrom": "desk"
+      }
+    },
+    "FLANGER_MIX_RANGE": {
+      "rel": "data/kernels/flanger.json",
+      "kind": "travels",
+      "doc": "The flanger's wet/dry, as an instance of DRIVE_MIX_RANGE: 50 %, equal dry and wet, where the comb is deepest (§3b).",
+      "shape": "travel",
+      "value": {
+        "min": 0,
+        "max": 100,
+        "step": 0.1,
+        "unit": "%",
+        "default": 50,
+        "defaultFrom": "desk"
+      }
+    },
     "GATE_LIMITS": {
       "rel": "data/kernels/gate.json",
       "kind": "travels",
@@ -312,6 +719,41 @@
         }
       }
     },
+    "GEQ_BAND_RANGE": {
+      "rel": "data/kernels/geq.json",
+      "kind": "travels",
+      "doc": "One graphic-EQ fader's travel: EQ_GAIN_RANGE by reference (a graphic fader is an EQ gain), with the come-up value it needs as a row field — flat, 0 dB (graphic-eq-31 spec §3).",
+      "shape": "travel",
+      "value": {
+        "min": -15,
+        "max": 15,
+        "step": 0.5,
+        "unit": "dB",
+        "default": 0,
+        "defaultFrom": "desk"
+      }
+    },
+    "GEQ_BAND_Q": {
+      "rel": "data/kernels/geq.json",
+      "kind": "scalar",
+      "doc": "The graphic EQ's band Q: the ISO third-octave bandwidth, `2^(1/6)/(2^(1/3) − 1) ≈ 4.318`, to one decimal as the M32 GEQ carries it. Read by the `geq31` preset and the graphic EQ's section design (graphic-eq-31 spec §3).",
+      "unit": "",
+      "value": 4.3
+    },
+    "GEQ_PROTO_DB": {
+      "rel": "data/kernels/geq.json",
+      "kind": "scalar",
+      "doc": "The prototype gain the `true` solve's first interaction matrix is evaluated at (spec §2, §3): the middle of the travel's magnitude, where a matched-Z section's dB response per dB of gain is closest to its average.",
+      "unit": "dB",
+      "value": 12
+    },
+    "GEQ_DESIGN_GAIN_MAX_DB": {
+      "rel": "data/kernels/geq.json",
+      "kind": "scalar",
+      "doc": "The ceiling on a section gain the `true` solve may ask for (spec §3): above the travel's worst case (26.0 dB, the alternating ±15 set) with margin. A solve past it clamps and the row says so (`designClamped`), never silently.",
+      "unit": "dB",
+      "value": 30
+    },
     "LIMITER_LIMITS": {
       "rel": "data/kernels/limiter.json",
       "kind": "travels",
@@ -344,17 +786,163 @@
         }
       }
     },
-    "PITCH_LIMITS": {
-      "rel": "data/kernels/pitch.json",
+    "PHASER_RATE_RANGE": {
+      "rel": "data/kernels/phaser.json",
       "kind": "travels",
-      "doc": "PITCH_LIMITS, moved from openmixer.",
-      "shape": "table",
+      "doc": "The phaser's sweep speed (§3). `omx_lfo_inc` freezes at Nyquist; this travel stays far below.",
+      "shape": "travel",
       "value": {
-        "semitones": {
-          "min": -12,
-          "max": 12,
-          "default": 0
-        },
+        "min": 0.05,
+        "max": 5,
+        "step": 0.01,
+        "unit": "Hz",
+        "default": 0.5,
+        "defaultFrom": "desk"
+      }
+    },
+    "PHASER_BASE_RANGE": {
+      "rel": "data/kernels/phaser.json",
+      "kind": "travels",
+      "doc": "The phaser's lowest centre frequency; the sweep runs upward from it (§3).",
+      "shape": "travel",
+      "value": {
+        "min": 50,
+        "max": 2000,
+        "step": 1,
+        "unit": "Hz",
+        "default": 200,
+        "defaultFrom": "desk"
+      }
+    },
+    "PHASER_DEPTH_RANGE": {
+      "rel": "data/kernels/phaser.json",
+      "kind": "travels",
+      "doc": "The sweep's span above `base`, in octaves; 0 is a static phaser at `base` (§3).",
+      "shape": "travel",
+      "value": {
+        "min": 0,
+        "max": 6,
+        "step": 0.1,
+        "unit": "oct",
+        "default": 4,
+        "defaultFrom": "desk"
+      }
+    },
+    "PHASER_STAGES_RANGE": {
+      "rel": "data/kernels/phaser.json",
+      "kind": "travels",
+      "doc": "The phaser's section count per leg — EVEN, 2 … 12 (§2: two sections per notch). Its ends are the kernel's state capacity (`OMX_PHASER_MAX_STAGES` reads `OMX_PHASER_STAGES_RANGE_MAX`); the row moves it through the closed member set PHASER_STAGE_COUNTS, which is derived from it.",
+      "shape": "travel",
+      "value": {
+        "min": 2,
+        "max": 12,
+        "step": 2,
+        "unit": "",
+        "default": 6,
+        "defaultFrom": "desk"
+      }
+    },
+    "PHASER_STAGE_COUNTS": {
+      "rel": "data/kernels/phaser.json",
+      "kind": "list",
+      "doc": "The member set the `stages` field accepts: PHASER_STAGES_RANGE walked by its step.",
+      "unit": "",
+      "value": [
+        2,
+        4,
+        6,
+        8,
+        10,
+        12
+      ]
+    },
+    "PHASER_FEEDBACK_RANGE": {
+      "rel": "data/kernels/phaser.json",
+      "kind": "travels",
+      "doc": "The phaser's SIGNED resonance (§3). ±0.9, tighter than the flanger's ±0.95: the loop runs through a time-varying chain. Declared here (the refusal half); the kernel's clamp is the enforcement half.",
+      "shape": "travel",
+      "value": {
+        "min": -0.9,
+        "max": 0.9,
+        "step": 0.01,
+        "unit": "",
+        "default": 0.4,
+        "defaultFrom": "desk"
+      }
+    },
+    "PHASER_MIX_RANGE": {
+      "rel": "data/kernels/phaser.json",
+      "kind": "travels",
+      "doc": "The phaser's wet/dry, as an instance of DRIVE_MIX_RANGE: 50 %, where the notch is complete (§3).",
+      "shape": "travel",
+      "value": {
+        "min": 0,
+        "max": 100,
+        "step": 0.1,
+        "unit": "%",
+        "default": 50,
+        "defaultFrom": "desk"
+      }
+    },
+    "PHASER_TRAVELS": {
+      "rel": "data/kernels/phaser.json",
+      "kind": "travels",
+      "doc": "The phaser's continuous travels by row field — the ONE map its control bounds and its row travels both read (§3). `stages` is not here: it moves through PHASER_STAGE_COUNTS.",
+      "shape": "table",
+      "value": {
+        "rateHz": {
+          "min": 0.05,
+          "max": 5,
+          "step": 0.01,
+          "unit": "Hz",
+          "default": 0.5,
+          "defaultFrom": "desk"
+        },
+        "baseHz": {
+          "min": 50,
+          "max": 2000,
+          "step": 1,
+          "unit": "Hz",
+          "default": 200,
+          "defaultFrom": "desk"
+        },
+        "depthOct": {
+          "min": 0,
+          "max": 6,
+          "step": 0.1,
+          "unit": "oct",
+          "default": 4,
+          "defaultFrom": "desk"
+        },
+        "feedback": {
+          "min": -0.9,
+          "max": 0.9,
+          "step": 0.01,
+          "unit": "",
+          "default": 0.4,
+          "defaultFrom": "desk"
+        },
+        "mix": {
+          "min": 0,
+          "max": 100,
+          "step": 0.1,
+          "unit": "%",
+          "default": 50,
+          "defaultFrom": "desk"
+        }
+      }
+    },
+    "PITCH_LIMITS": {
+      "rel": "data/kernels/pitch.json",
+      "kind": "travels",
+      "doc": "PITCH_LIMITS, moved from openmixer.",
+      "shape": "table",
+      "value": {
+        "semitones": {
+          "min": -12,
+          "max": 12,
+          "default": 0
+        },
         "cents": {
           "min": -50,
           "max": 50,
@@ -391,6 +979,409 @@
         "defaultFrom": "desk"
       }
     },
+    "REVERB_MIX_RANGE": {
+      "rel": "data/kernels/reverb.json",
+      "kind": "travels",
+      "doc": "The REVERB's wet/dry. An insert keeps the dry signal (0.3); an `fxReturn` is wet-only (1), so the return carries only the effect. Both numbers live HERE and nowhere else: the row's `mix` limit, `ReverbController`'s seed and its fresh state read them through limitForKind.",
+      "shape": "travel",
+      "value": {
+        "min": 0,
+        "max": 1,
+        "step": 0,
+        "unit": "",
+        "default": 0.3,
+        "defaultFrom": "desk",
+        "byKind": {
+          "fxReturn": 1
+        }
+      }
+    },
+    "REVERB_SIZE_RANGE": {
+      "rel": "data/kernels/reverb.json",
+      "kind": "travels",
+      "doc": "The reverb's SIZE/DAMPING/WIDTH — each a NORMALIZED_RANGE instance with its own come-up value, matching `DEFAULT_REVERB_STATE`. Three separate constants rather than one shared default on `NORMALIZED_RANGE`: that range is the bare 0..1 REPRESENTATION, reused by fields across the whole console whose come-up values disagree (a fader position is not a reverb's damping), so a default belongs on the NAMED field, never on the shape it borrows.",
+      "shape": "travel",
+      "value": {
+        "min": 0,
+        "max": 1,
+        "step": 0,
+        "unit": "",
+        "default": 0.7,
+        "defaultFrom": "desk"
+      }
+    },
+    "REVERB_DAMPING_RANGE": {
+      "rel": "data/kernels/reverb.json",
+      "kind": "travels",
+      "doc": "The reverb's DAMPING — a NORMALIZED_RANGE instance with its own come-up value, matching `DEFAULT_REVERB_STATE`. Declared with SIZE and WIDTH (see REVERB_SIZE_RANGE for why each is a named constant rather than a default on the shared 0..1 shape).",
+      "shape": "travel",
+      "value": {
+        "min": 0,
+        "max": 1,
+        "step": 0,
+        "unit": "",
+        "default": 0.5,
+        "defaultFrom": "desk"
+      }
+    },
+    "REVERB_WIDTH_RANGE": {
+      "rel": "data/kernels/reverb.json",
+      "kind": "travels",
+      "doc": "The reverb's stereo WIDTH — a NORMALIZED_RANGE instance with its own come-up value, matching `DEFAULT_REVERB_STATE`. Declared with SIZE and DAMPING (see REVERB_SIZE_RANGE for why each is a named constant rather than a default on the shared 0..1 shape).",
+      "shape": "travel",
+      "value": {
+        "min": 0,
+        "max": 1,
+        "step": 0,
+        "unit": "",
+        "default": 1,
+        "defaultFrom": "desk"
+      }
+    },
+    "REVERB_PREDELAY_RANGE": {
+      "rel": "data/kernels/reverb.json",
+      "kind": "travels",
+      "doc": "The reverb's PRE-DELAY travel — the gap before the first reflection, in milliseconds. Declared here so the unit crosses with the bounds: a `finiteNumber(0, 100)` codec publishes `unit: ''`, and a surface binding that draws a millisecond control it cannot label. The panel knowing better than the wire is the wrong way round.",
+      "shape": "travel",
+      "value": {
+        "min": 0,
+        "max": 100,
+        "step": 1,
+        "unit": "ms",
+        "default": 0,
+        "defaultFrom": "desk"
+      }
+    },
+    "REVERB_LOWCUT_RANGE": {
+      "rel": "data/kernels/reverb.json",
+      "kind": "travels",
+      "doc": "The reverb's LOW cut, as an instance of REVERB_CUT_RANGE — same bounds, its own come-up value. `0` reads as \"none\" (`mix_reverb.h`), which is also `DEFAULT_REVERB_STATE`'s seed, so a fresh reverb's low cut and its declared default are the same fact stated once. Split from REVERB_CUT_RANGE rather than adding `default` there: the low and high cut share ONE travel (the C imposes one constraint on both) but do NOT share one come-up value, and a `default` on the shared range could only be honest for one of the two fields that read it.",
+      "shape": "travel",
+      "value": {
+        "min": 0,
+        "max": 20000,
+        "step": 10,
+        "unit": "Hz",
+        "default": 0,
+        "defaultFrom": "desk"
+      }
+    },
+    "REVERB_HIGHCUT_RANGE": {
+      "rel": "data/kernels/reverb.json",
+      "kind": "travels",
+      "doc": "The reverb's HIGH cut, as an instance of REVERB_CUT_RANGE — same bounds, its own come-up value. The top of the travel reads as \"open\" (`mix_reverb.h`), matching `DEFAULT_REVERB_STATE`'s seed.",
+      "shape": "travel",
+      "value": {
+        "min": 0,
+        "max": 20000,
+        "step": 10,
+        "unit": "Hz",
+        "default": 20000,
+        "defaultFrom": "desk"
+      }
+    },
+    "REVERB_REVERSE_RANGE": {
+      "rel": "data/kernels/reverb.json",
+      "kind": "travels",
+      "doc": "REVERSE's MIRROR WINDOW — how long a slice of the wet is played backward, in milliseconds (`2026-07-15-native-delay-reverb.md`, Amendment 2026-09-17 §B). A DECLARED travel and never derived from `size`'s RT60: an RT60 of seconds cannot be buffered at 192 kHz, and a window silently clamped to fit is the silent-clamp defect. The ceiling is what `mix_reverb.h`'s pool budgets a ring for (`OMX_REVERB_REVERSE_MAX_MS`), so the console offers exactly the travel the kernel accepts — nothing wider, nothing narrower.",
+      "shape": "travel",
+      "value": {
+        "min": 50,
+        "max": 500,
+        "step": 10,
+        "unit": "ms",
+        "default": 300,
+        "defaultFrom": "desk"
+      }
+    },
+    "REVERB_HOLD_RANGE": {
+      "rel": "data/kernels/reverb.json",
+      "kind": "travels",
+      "doc": "GATED's HOLD — how long the wet stays at full level after the key falls away, in milliseconds. The Phil-Collins tail is cut where the operator puts the cut, so this is the control that decides the effect's length; `size` still decides what is being cut off.",
+      "shape": "travel",
+      "value": {
+        "min": 10,
+        "max": 2000,
+        "step": 10,
+        "unit": "ms",
+        "default": 120,
+        "defaultFrom": "desk"
+      }
+    },
+    "REVERB_RELEASE_RANGE": {
+      "rel": "data/kernels/reverb.json",
+      "kind": "travels",
+      "doc": "GATED's RELEASE — how long the held wet takes to reach zero, in milliseconds. A straight line down, short by design: a long release is a reverb tail again, which is the thing a gated reverb exists to remove.",
+      "shape": "travel",
+      "value": {
+        "min": 1,
+        "max": 500,
+        "step": 1,
+        "unit": "ms",
+        "default": 20,
+        "defaultFrom": "desk"
+      }
+    },
+    "REVERB_GATE_THRESHOLD_RANGE": {
+      "rel": "data/kernels/reverb.json",
+      "kind": "travels",
+      "doc": "GATED's ARM THRESHOLD — the level the reverb's own mono feed must reach to arm the hold, in dBFS. Declared, because the alternative is a hidden onset detector: the kernel compares `|input|` against exactly this number and nothing else.",
+      "shape": "travel",
+      "value": {
+        "min": -80,
+        "max": 0,
+        "step": 1,
+        "unit": "dBFS",
+        "default": -40,
+        "defaultFrom": "desk"
+      }
+    },
+    "ROTARY_HORN_SLOW_RANGE": {
+      "rel": "data/kernels/rotary.json",
+      "kind": "travels",
+      "doc": "The horn's chorale (slow) rate, Hz.",
+      "shape": "travel",
+      "value": {
+        "min": 0.1,
+        "max": 2,
+        "step": 0.01,
+        "unit": "Hz",
+        "default": 0.8,
+        "defaultFrom": "desk"
+      }
+    },
+    "ROTARY_HORN_FAST_RANGE": {
+      "rel": "data/kernels/rotary.json",
+      "kind": "travels",
+      "doc": "The horn's tremolo (fast) rate, Hz.",
+      "shape": "travel",
+      "value": {
+        "min": 3,
+        "max": 10,
+        "step": 0.01,
+        "unit": "Hz",
+        "default": 6.8,
+        "defaultFrom": "desk"
+      }
+    },
+    "ROTARY_DRUM_SLOW_RANGE": {
+      "rel": "data/kernels/rotary.json",
+      "kind": "travels",
+      "doc": "The drum's chorale (slow) rate, Hz.",
+      "shape": "travel",
+      "value": {
+        "min": 0.1,
+        "max": 2,
+        "step": 0.01,
+        "unit": "Hz",
+        "default": 0.7,
+        "defaultFrom": "desk"
+      }
+    },
+    "ROTARY_DRUM_FAST_RANGE": {
+      "rel": "data/kernels/rotary.json",
+      "kind": "travels",
+      "doc": "The drum's tremolo (fast) rate, Hz.",
+      "shape": "travel",
+      "value": {
+        "min": 3,
+        "max": 10,
+        "step": 0.01,
+        "unit": "Hz",
+        "default": 5.9,
+        "defaultFrom": "desk"
+      }
+    },
+    "ROTARY_ACCEL_RANGE": {
+      "rel": "data/kernels/rotary.json",
+      "kind": "travels",
+      "doc": "The scale on every speed-change time constant (`ROTARY_*_ACCEL_MS`/`_DECEL_MS`): 2 is twice as slow.",
+      "shape": "travel",
+      "value": {
+        "min": 0.25,
+        "max": 4,
+        "step": 0.01,
+        "unit": "x",
+        "default": 1,
+        "defaultFrom": "desk"
+      }
+    },
+    "ROTARY_BALANCE_RANGE": {
+      "rel": "data/kernels/rotary.json",
+      "kind": "travels",
+      "doc": "The drum/horn balance, percent: −100 drum only, +100 horn only; the law attenuates, never boosts.",
+      "shape": "travel",
+      "value": {
+        "min": -100,
+        "max": 100,
+        "step": 1,
+        "unit": "%",
+        "default": 0,
+        "defaultFrom": "desk"
+      }
+    },
+    "ROTARY_MIX_RANGE": {
+      "rel": "data/kernels/rotary.json",
+      "kind": "travels",
+      "doc": "The rotary's wet/dry, as an instance of DRIVE_MIX_RANGE: 100 %, because a rotary on an insert IS the sound (it replaces the cabinet) and an `fxReturn` wants it wet too (§3).",
+      "shape": "travel",
+      "value": {
+        "min": 0,
+        "max": 100,
+        "step": 0.1,
+        "unit": "%",
+        "default": 100,
+        "defaultFrom": "desk"
+      }
+    },
+    "ROTARY_TRAVELS": {
+      "rel": "data/kernels/rotary.json",
+      "kind": "travels",
+      "doc": "The rotary's numeric travels, field → declaration: the ONE map the row's state, its bounds, its OPTIONS and its controller read (`speed` is a member set, ROTARY_SPEEDS, beside it).",
+      "shape": "table",
+      "value": {
+        "hornSlowHz": {
+          "min": 0.1,
+          "max": 2,
+          "step": 0.01,
+          "unit": "Hz",
+          "default": 0.8,
+          "defaultFrom": "desk"
+        },
+        "hornFastHz": {
+          "min": 3,
+          "max": 10,
+          "step": 0.01,
+          "unit": "Hz",
+          "default": 6.8,
+          "defaultFrom": "desk"
+        },
+        "drumSlowHz": {
+          "min": 0.1,
+          "max": 2,
+          "step": 0.01,
+          "unit": "Hz",
+          "default": 0.7,
+          "defaultFrom": "desk"
+        },
+        "drumFastHz": {
+          "min": 3,
+          "max": 10,
+          "step": 0.01,
+          "unit": "Hz",
+          "default": 5.9,
+          "defaultFrom": "desk"
+        },
+        "accel": {
+          "min": 0.25,
+          "max": 4,
+          "step": 0.01,
+          "unit": "x",
+          "default": 1,
+          "defaultFrom": "desk"
+        },
+        "balance": {
+          "min": -100,
+          "max": 100,
+          "step": 1,
+          "unit": "%",
+          "default": 0,
+          "defaultFrom": "desk"
+        },
+        "mix": {
+          "min": 0,
+          "max": 100,
+          "step": 0.1,
+          "unit": "%",
+          "default": 100,
+          "defaultFrom": "desk"
+        }
+      }
+    },
+    "ROTARY_CROSSOVER_HZ": {
+      "rel": "data/kernels/rotary.json",
+      "kind": "scalar",
+      "doc": "The complementary split's low-pass corner, Hz: the Leslie 122's passive crossover.",
+      "unit": "Hz",
+      "value": 800
+    },
+    "ROTARY_BASE_MS": {
+      "rel": "data/kernels/rotary.json",
+      "kind": "scalar",
+      "doc": "The shortest Doppler read, ms — above the order-3 read's one-sample reach at every rate.",
+      "unit": "ms",
+      "value": 0.1
+    },
+    "ROTARY_HORN_DOPPLER_MS": {
+      "rel": "data/kernels/rotary.json",
+      "kind": "scalar",
+      "doc": "The horn's Doppler excursion `D_horn`, ms: a 0.15 m radius over 343 m/s.",
+      "unit": "ms",
+      "value": 0.44
+    },
+    "ROTARY_DRUM_DOPPLER_MS": {
+      "rel": "data/kernels/rotary.json",
+      "kind": "scalar",
+      "doc": "The drum's Doppler excursion `D_drum`, ms: its baffle turns over a fixed woofer.",
+      "unit": "ms",
+      "value": 0.29
+    },
+    "ROTARY_HORN_AM": {
+      "rel": "data/kernels/rotary.json",
+      "kind": "scalar",
+      "doc": "The horn's amplitude swing `m_horn` (a −6 dB directivity dip), a ratio.",
+      "unit": "",
+      "value": 0.5
+    },
+    "ROTARY_DRUM_AM": {
+      "rel": "data/kernels/rotary.json",
+      "kind": "scalar",
+      "doc": "The drum baffle's amplitude swing `m_drum`, a ratio.",
+      "unit": "",
+      "value": 0.3
+    },
+    "ROTARY_HORN_ACCEL_MS": {
+      "rel": "data/kernels/rotary.json",
+      "kind": "scalar",
+      "doc": "The horn rotor's speed-up time constant, ms (at `accel` 1).",
+      "unit": "ms",
+      "value": 330
+    },
+    "ROTARY_HORN_DECEL_MS": {
+      "rel": "data/kernels/rotary.json",
+      "kind": "scalar",
+      "doc": "The horn rotor's slow-down time constant, ms (at `accel` 1).",
+      "unit": "ms",
+      "value": 500
+    },
+    "ROTARY_DRUM_ACCEL_MS": {
+      "rel": "data/kernels/rotary.json",
+      "kind": "scalar",
+      "doc": "The drum rotor's speed-up time constant, ms (at `accel` 1).",
+      "unit": "ms",
+      "value": 1700
+    },
+    "ROTARY_DRUM_DECEL_MS": {
+      "rel": "data/kernels/rotary.json",
+      "kind": "scalar",
+      "doc": "The drum rotor's slow-down time constant, ms (at `accel` 1).",
+      "unit": "ms",
+      "value": 1800
+    },
+    "ROTARY_STOP_EPS": {
+      "rel": "data/kernels/rotary.json",
+      "kind": "scalar",
+      "doc": "Below this rate, Hz, a rotor coasting toward `stop` is snapped to exactly 0.",
+      "unit": "",
+      "value": 0.0001
+    },
+    "ROTARY_RING_FLOATS": {
+      "rel": "data/kernels/rotary.json",
+      "kind": "scalar",
+      "doc": "One inline ring per rotor per leg, floats — at least the 192 kHz need of the horn's sweep.",
+      "unit": "",
+      "value": 256
+    },
     "TRANSIENT_LIMITS": {
       "rel": "data/kernels/transient.json",
       "kind": "travels",
@@ -467,62 +1458,79 @@
       "unit": "",
       "value": 0.00001
     },
-    "DELAY_PLUGIN": {
-      "rel": "data/plugins/delay.json",
-      "kind": "plugin",
-      "doc": "The delay plugin's parameters, in append-only order: DPF's parameter index is the CLAP param id and the LV2 port order (omx-plugins-dpf §3b). Moved from openmixer's packages/omx-plugins/tools/params-gen.mjs PLUGINS.delay.",
-      "why": "mix is per instance on the desk (insert or fxReturn); a plugin racked in a foreign host is an INSERT, so it reads the input kind's default (omx-plugins-dpf §3a).",
-      "plugin": "delay",
-      "header": "omx_delay_params.h",
-      "prefix": "OMX_DELAY",
-      "source": "FX_DELAY_TIME_RANGE, FX_DELAY_FEEDBACK_RANGE, DELAY_MIX_RANGE for kind input, DELAY_TONE_RANGE, FX_DELAY_PINGPONG_DEFAULT",
-      "value": [
-        {
-          "symbol": "timeMs",
-          "min": 0,
-          "max": 2000,
-          "def": 300,
-          "step": 1,
-          "unit": "ms",
-          "toggle": false
-        },
-        {
-          "symbol": "feedback",
-          "min": 0,
-          "max": 0.99,
-          "def": 0.3,
-          "step": 0,
-          "unit": "",
-          "toggle": false
-        },
-        {
-          "symbol": "mix",
-          "min": 0,
-          "max": 1,
-          "def": 0.3,
-          "step": 0,
-          "unit": "",
-          "toggle": false
+    "TREMOLO_RATE_RANGE": {
+      "rel": "data/kernels/tremolo.json",
+      "kind": "travels",
+      "doc": "The tremolo's LFO rate (the catalogue row's 0.1..20 Hz); 4 Hz is the classic amp tremolo.",
+      "shape": "travel",
+      "value": {
+        "min": 0.1,
+        "max": 20,
+        "step": 0.01,
+        "unit": "Hz",
+        "default": 4,
+        "defaultFrom": "desk"
+      }
+    },
+    "TREMOLO_DEPTH_RANGE": {
+      "rel": "data/kernels/tremolo.json",
+      "kind": "travels",
+      "doc": "The tremolo's modulation depth: the gain's trough is `1 − mix·depth`.",
+      "shape": "travel",
+      "value": {
+        "min": 0,
+        "max": 100,
+        "step": 0.1,
+        "unit": "%",
+        "default": 50,
+        "defaultFrom": "desk"
+      }
+    },
+    "TREMOLO_MIX_RANGE": {
+      "rel": "data/kernels/tremolo.json",
+      "kind": "travels",
+      "doc": "The tremolo's wet/dry, as an instance of DRIVE_MIX_RANGE: 100 %. The kernel folds the wet/dry into its one gain, so a strip tremolo IS the sound (as the rotary's mix 100 % is).",
+      "shape": "travel",
+      "value": {
+        "min": 0,
+        "max": 100,
+        "step": 0.1,
+        "unit": "%",
+        "default": 100,
+        "defaultFrom": "desk"
+      }
+    },
+    "TREMOLO_TRAVELS": {
+      "rel": "data/kernels/tremolo.json",
+      "kind": "travels",
+      "doc": "The tremolo's numeric travels, field → declaration: the ONE map the row's state, its bounds, its OPTIONS and its controller read (`mode` is a member set, TREMOLO_MODES, beside it).",
+      "shape": "table",
+      "value": {
+        "rateHz": {
+          "min": 0.1,
+          "max": 20,
+          "step": 0.01,
+          "unit": "Hz",
+          "default": 4,
+          "defaultFrom": "desk"
         },
-        {
-          "symbol": "tone",
+        "depth": {
           "min": 0,
-          "max": 1,
-          "def": 0.3,
-          "step": 0,
-          "unit": "",
-          "toggle": false
+          "max": 100,
+          "step": 0.1,
+          "unit": "%",
+          "default": 50,
+          "defaultFrom": "desk"
         },
-        {
-          "symbol": "pingpong",
+        "mix": {
           "min": 0,
-          "max": 1,
-          "def": 0,
-          "step": 1,
-          "unit": "",
-          "toggle": true
+          "max": 100,
+          "step": 0.1,
+          "unit": "%",
+          "default": 100,
+          "defaultFrom": "desk"
         }
-      ]
+      }
     },
     "BUTTERWORTH_Q": {
       "rel": "data/primitives.json",
@@ -563,6 +1571,86 @@
       "unit": "",
       "value": 1.25
     },
+    "GATE_CONTINUOUS_TRAVELS": {
+      "rel": "data/primitives.json",
+      "kind": "travels",
+      "doc": "The gate's threshold, range, release and ratio as a plugin host draws them: GATE_LIMITS' bounds, units and defaults with no step. The console's row quantises these four to whole steps (1 dB, 10 ms, 1:1), and a travel whose step is 1 or more reads as an integer control; the omx-strip plugin has always offered them continuous, so it reads this table instead. Every number but the step is GATE_LIMITS', held equal by test/continuous-travels.test.mjs. Not rendered to C: no C reader needs a second spelling of the gate's bounds.",
+      "shape": "table",
+      "value": {
+        "thresholdDb": {
+          "min": -80,
+          "max": 0,
+          "step": 0,
+          "unit": "dB",
+          "default": -40,
+          "defaultFrom": "desk"
+        },
+        "rangeDb": {
+          "min": -90,
+          "max": 0,
+          "step": 0,
+          "unit": "dB",
+          "default": -90,
+          "defaultFrom": "desk"
+        },
+        "releaseMs": {
+          "min": 0,
+          "max": 5000,
+          "step": 0,
+          "unit": "ms",
+          "default": 100,
+          "defaultFrom": "desk"
+        },
+        "ratio": {
+          "min": 1,
+          "max": 100,
+          "step": 0,
+          "unit": "",
+          "default": 16,
+          "defaultFrom": "desk"
+        }
+      }
+    },
+    "COMP_CONTINUOUS_TRAVELS": {
+      "rel": "data/primitives.json",
+      "kind": "travels",
+      "doc": "The compressor's threshold and release as a plugin host draws them: COMP_LIMITS' bounds, units and defaults with no step. The console's row quantises them to whole steps (1 dB, 10 ms), and a travel whose step is 1 or more reads as an integer control; the omx-strip plugin has always offered them continuous, so it reads this table instead. Every number but the step is COMP_LIMITS', held equal by test/continuous-travels.test.mjs. Not rendered to C: no C reader needs a second spelling of the compressor's bounds.",
+      "shape": "table",
+      "value": {
+        "thresholdDb": {
+          "min": -60,
+          "max": 0,
+          "step": 0,
+          "unit": "dB",
+          "default": -18,
+          "defaultFrom": "desk"
+        },
+        "releaseMs": {
+          "min": 5,
+          "max": 3000,
+          "step": 0,
+          "unit": "ms",
+          "default": 200,
+          "defaultFrom": "desk"
+        }
+      }
+    },
+    "TRIM_TRAVELS": {
+      "rel": "data/primitives.json",
+      "kind": "travels",
+      "doc": "The digital input trim as a travel: openmixer's TRIM_RANGE (packages/declarations, -24..+24 dB in 0.1 dB steps, spelled minDb/maxDb/stepDb there and OMX_TRIM_RANGE_*_DB in omx-dsp's header), coming up at 0 dB, the trim a channel has when none is set. The omx-strip plugin's trim reads it. A table with the one field `trimDb`, the name the trim row and the plugin store; not rendered to C, which already spells TRIM_RANGE its own way.",
+      "shape": "table",
+      "value": {
+        "trimDb": {
+          "min": -24,
+          "max": 24,
+          "step": 0.1,
+          "unit": "dB",
+          "default": 0,
+          "defaultFrom": "desk"
+        }
+      }
+    },
     "STANDARD_SAMPLE_RATES": {
       "rel": "data/rates.json",
       "kind": "list",