@openmixer/omx-contract 0.0.0 → 1.1.0

package/dist/ts/omx-contract.js

@@ -0,0 +1,1117 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+// GENERATED by `omx-contract render --target ts` from FreeMixer/omx-contract's data/ — do not edit.
+
+/**
+ * The chorus's right-leg phase offset, in TURNS of its one oscillator (§2, §3a; the native-FX catalogue's M32 Dimension row). The right leg's voice k reads the LFO at k/N + spread: 0 is both legs one phase (the stage without the field, bit for bit), 0.25 quadrature, 0.5 the Dimension's opposed sweep. A fraction of a cycle carries no engineering symbol, so the unit is ''.
+ * @see data/kernels/chorus.json
+ */
+export const CHORUS_SPREAD_RANGE = {
+  "min": 0,
+  "max": 0.5,
+  "step": 0.01,
+  "unit": "",
+  "default": 0,
+  "defaultFrom": "desk"
+};
+
+/**
+ * The legal range of each compressor field (engineering units). The widget clamps drags to these, `normalizeComp` enforces them, the row's codec refuses by them and the travel sheet publishes them. `default`/`defaultFrom` are the come-up values `defaultCompState` seeds a fresh strip with, read BACK from here rather than restated there.
+ * @see data/kernels/comp.json
+ */
+export const COMP_LIMITS = {
+  "thresholdDb": {
+    "min": -60,
+    "max": 0,
+    "step": 1,
+    "unit": "dB",
+    "default": -18,
+    "defaultFrom": "desk"
+  },
+  "ratio": {
+    "min": 1,
+    "max": 20,
+    "step": 0.5,
+    "unit": "",
+    "default": 4,
+    "defaultFrom": "desk"
+  },
+  "kneeDb": {
+    "min": 0,
+    "max": 24,
+    "step": 0.5,
+    "unit": "dB",
+    "default": 6,
+    "defaultFrom": "desk"
+  },
+  "attackMs": {
+    "min": 0.1,
+    "max": 100,
+    "step": 1,
+    "unit": "ms",
+    "default": 5,
+    "defaultFrom": "desk"
+  },
+  "releaseMs": {
+    "min": 5,
+    "max": 3000,
+    "step": 10,
+    "unit": "ms",
+    "default": 200,
+    "defaultFrom": "desk"
+  },
+  "makeupDb": {
+    "min": 0,
+    "max": 24,
+    "step": 0.5,
+    "unit": "dB",
+    "default": 0,
+    "defaultFrom": "desk"
+  },
+  "mixPct": {
+    "min": 0,
+    "max": 100,
+    "step": 5,
+    "unit": "%",
+    "default": 100,
+    "defaultFrom": "desk"
+  }
+};
+
+/**
+ * The program-dependent release's model constants — the LA-2A's opto cell as DATA (`docs/design/specs/2026-09-26-compressor-models.md` §3b). `chargeMs`/`dischargeMs` are the word's memory constants, shared by every profile; each profile's `fastMs`, `slowMinMs`, `slowMaxMs` and `share` fit the unit's published two-stage recovery. Not operator controls: generated into `omx_contract_limits.h` as `OMX_PROGRAM_RELEASE_*`, which libomxdsp's `omx_env_program_release` reads.
+ * @see data/kernels/comp.json
+ */
+export const PROGRAM_RELEASE = {
+  "chargeMs": 1000,
+  "dischargeMs": 5000,
+  "profiles": {
+    "opto": {
+      "fastMs": 70,
+      "slowMinMs": 110,
+      "slowMaxMs": 1100,
+      "share": 0.5
+    }
+  }
+};
+
+/**
+ * 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).
+ * @see data/kernels/deesser.json
+ */
+export const DEESS_FREQ_RANGE = {
+  "min": 2000,
+  "max": 16000,
+  "step": 10,
+  "unit": "Hz",
+  "default": 7000,
+  "defaultFrom": "desk"
+};
+
+/**
+ * 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.
+ * @see data/kernels/deesser.json
+ */
+export const DEESS_WIDTH_RANGE = {
+  "min": 0.25,
+  "max": 4,
+  "step": 0.05,
+  "unit": "oct",
+  "default": 1,
+  "defaultFrom": "desk"
+};
+
+/**
+ * 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".
+ * @see data/kernels/deesser.json
+ */
+export const DEESS_THRESHOLD_RANGE = {
+  "min": -60,
+  "max": 0,
+  "step": 0.5,
+  "unit": "dB",
+  "default": -30,
+  "defaultFrom": "desk"
+};
+
+/**
+ * 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.
+ * @see data/kernels/deesser.json
+ */
+export const DEESS_RATIO_RANGE = {
+  "min": 1,
+  "max": 20,
+  "step": 0.1,
+  "unit": "",
+  "default": 4,
+  "defaultFrom": "desk"
+};
+
+/**
+ * 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.
+ * @see data/kernels/deesser.json
+ */
+export const DEESS_RANGE_RANGE = {
+  "min": -24,
+  "max": 0,
+  "step": 0.5,
+  "unit": "dB",
+  "default": -12,
+  "defaultFrom": "desk"
+};
+
+/**
+ * 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.
+ * @see data/kernels/deesser.json
+ */
+export const DEESS_ATTACK_RANGE = {
+  "min": 0.1,
+  "max": 50,
+  "step": 0.1,
+  "unit": "ms",
+  "default": 1,
+  "defaultFrom": "desk"
+};
+
+/**
+ * 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.
+ * @see data/kernels/deesser.json
+ */
+export const DEESS_RELEASE_RANGE = {
+  "min": 5,
+  "max": 500,
+  "step": 1,
+  "unit": "ms",
+  "default": 60,
+  "defaultFrom": "desk"
+};
+
+/**
+ * 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.
+ * @see data/kernels/deesser.json
+ */
+export const DEESS_KNEE_DB = 6;
+
+/**
+ * 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.
+ * @see data/kernels/delay.json
+ */
+export const FX_DELAY_TIME_RANGE = {
+  "min": 0,
+  "max": 2000,
+  "step": 1,
+  "unit": "ms",
+  "default": 300,
+  "defaultFrom": "desk"
+};
+
+/**
+ * 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.
+ * @see data/kernels/delay.json
+ */
+export const FX_DELAY_FEEDBACK_RANGE = {
+  "min": 0,
+  "max": 0.99,
+  "step": 0,
+  "unit": "",
+  "default": 0.3,
+  "defaultFrom": "desk"
+};
+
+/**
+ * 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.
+ * @see data/kernels/delay.json
+ */
+export const DELAY_TONE_RANGE = {
+  "min": 0,
+  "max": 1,
+  "step": 0,
+  "unit": "",
+  "default": 0.3,
+  "defaultFrom": "desk"
+};
+
+/**
+ * The FX DELAY's wet/dry — the same split as REVERB_MIX_RANGE, its own declaration.
+ * @see data/kernels/delay.json
+ */
+export const DELAY_MIX_RANGE = {
+  "min": 0,
+  "max": 1,
+  "step": 0,
+  "unit": "",
+  "default": 0.3,
+  "defaultFrom": "desk",
+  "byKind": {
+    "fxReturn": 1
+  }
+};
+
+/**
+ * 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.
+ * @see data/kernels/delay.json
+ */
+export const FX_DELAY_PINGPONG_DEFAULT = false;
+
+/**
+ * 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.
+ * @see data/kernels/drive.json
+ */
+export const DRIVE_BIAS_MAX = 0.7071067811865476;
+
+/**
+ * The maximum number of parametric bands a channel EQ may hold — the operator can add up to this many. Generated into `omx_contract_limits.h` as `OMX_EQ_MAX_BANDS`, which `omx_biquad.h` reads (`output-delay-ceiling.test.ts` reads the header): the native lane allocates exactly this many biquad slots per channel and silently clamps above it, so the model, the wire, and the DSP agree by test, not by memory.
+ * @see data/kernels/eq.json
+ */
+export const EQ_MAX_BANDS = 24;
+
+/**
+ * The standard ISO 266 one-third-octave centre frequencies, 20 Hz–20 kHz (31 bands) — the classic 31-band graphic-EQ layout's centres.
+ * @see data/kernels/eq.json
+ */
+export const ISO_THIRD_OCTAVE_CENTRES_HZ = [
+  20,
+  25,
+  31.5,
+  40,
+  50,
+  63,
+  80,
+  100,
+  125,
+  160,
+  200,
+  250,
+  315,
+  400,
+  500,
+  630,
+  800,
+  1000,
+  1250,
+  1600,
+  2000,
+  2500,
+  3150,
+  4000,
+  5000,
+  6300,
+  8000,
+  10000,
+  12500,
+  16000,
+  20000
+];
+
+/**
+ * The graphic EQ's section count: DERIVED from ISO_THIRD_OCTAVE_CENTRES_HZ, never a second literal. Generated into `omx_contract_limits.h` as `OMX_GEQ_BANDS`, which sizes `mix_geq.h`'s section array — its OWN budget, never a claimant on EQ_MAX_BANDS (graphic-eq-31 spec §3, roster ruling 3).
+ * @see data/kernels/eq.json
+ */
+export const GEQ_BANDS = 31;
+
+/**
+ * The flanger's jet sweep (§3b).
+ * @see data/kernels/flanger.json
+ */
+export const FLANGER_RATE_RANGE = {
+  "min": 0.05,
+  "max": 5,
+  "step": 0.01,
+  "unit": "Hz",
+  "default": 0.25,
+  "defaultFrom": "desk"
+};
+
+/**
+ * The flanger's peak-to-peak excursion above its declared 0.5 ms base (§3b).
+ * @see data/kernels/flanger.json
+ */
+export const FLANGER_DEPTH_RANGE = {
+  "min": 0,
+  "max": 5,
+  "step": 0.1,
+  "unit": "ms",
+  "default": 2,
+  "defaultFrom": "desk"
+};
+
+/**
+ * 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.
+ * @see data/kernels/flanger.json
+ */
+export const FLANGER_FEEDBACK_RANGE = {
+  "min": -0.95,
+  "max": 0.95,
+  "step": 0.01,
+  "unit": "",
+  "default": 0.6,
+  "defaultFrom": "desk"
+};
+
+/**
+ * The flanger's wet/dry, as an instance of DRIVE_MIX_RANGE: 50 %, equal dry and wet, where the comb is deepest (§3b).
+ * @see data/kernels/flanger.json
+ */
+export const FLANGER_MIX_RANGE = {
+  "min": 0,
+  "max": 100,
+  "step": 0.1,
+  "unit": "%",
+  "default": 50,
+  "defaultFrom": "desk"
+};
+
+/**
+ * The legal range of each gate field (engineering units). The widget clamps drags to these, `normalizeGate` enforces them, the row's codec refuses by them and the travel sheet publishes them — one source of truth. `rangeDb` reaches GATE_RANGE_FLOOR_DB, shown as "−∞" in readouts (a gate fully closed is silence).
+ * @see data/kernels/gate.json
+ */
+export const GATE_LIMITS = {
+  "thresholdDb": {
+    "min": -80,
+    "max": 0,
+    "step": 1,
+    "unit": "dB",
+    "default": -40,
+    "defaultFrom": "desk"
+  },
+  "rangeDb": {
+    "min": -90,
+    "max": 0,
+    "step": 1,
+    "unit": "dB",
+    "default": -90,
+    "defaultFrom": "desk"
+  },
+  "kneeStartDb": {
+    "min": -80,
+    "max": 0,
+    "step": 1,
+    "unit": "dB",
+    "default": -43,
+    "defaultFrom": "desk"
+  },
+  "kneeEndDb": {
+    "min": -80,
+    "max": 0,
+    "step": 1,
+    "unit": "dB",
+    "default": -37,
+    "defaultFrom": "desk"
+  },
+  "attackMs": {
+    "min": 0,
+    "max": 500,
+    "step": 0.5,
+    "unit": "ms",
+    "default": 1,
+    "defaultFrom": "desk"
+  },
+  "holdMs": {
+    "min": 0,
+    "max": 2000,
+    "step": 5,
+    "unit": "ms",
+    "default": 10,
+    "defaultFrom": "desk"
+  },
+  "releaseMs": {
+    "min": 0,
+    "max": 5000,
+    "step": 10,
+    "unit": "ms",
+    "default": 100,
+    "defaultFrom": "desk"
+  },
+  "hysteresisDb": {
+    "min": 0,
+    "max": 24,
+    "step": 0.5,
+    "unit": "dB",
+    "default": 3,
+    "defaultFrom": "desk"
+  },
+  "ratio": {
+    "min": 1,
+    "max": 100,
+    "step": 1,
+    "unit": "",
+    "default": 16,
+    "defaultFrom": "desk"
+  }
+};
+
+/**
+ * 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).
+ * @see data/kernels/geq.json
+ */
+export const GEQ_BAND_RANGE = {
+  "min": -15,
+  "max": 15,
+  "step": 0.5,
+  "unit": "dB",
+  "default": 0,
+  "defaultFrom": "desk"
+};
+
+/**
+ * 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).
+ * @see data/kernels/geq.json
+ */
+export const GEQ_BAND_Q = 4.3;
+
+/**
+ * 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.
+ * @see data/kernels/geq.json
+ */
+export const GEQ_PROTO_DB = 12;
+
+/**
+ * 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.
+ * @see data/kernels/geq.json
+ */
+export const GEQ_DESIGN_GAIN_MAX_DB = 30;
+
+/**
+ * The precision limiter's travels (`2026-09-27-precision-limiter.md` §2), rendered into `omx_contract_limits.h` as `OMX_LIMITER_*` by `harness/contract-limits-gen.mjs`, so `mix_limiter.h` reads them and never restates one (R-094). The ceiling is a TRUE peak in dBFS (the ×4 detector); the look-ahead sets the declared latency; the release is the envelope's time constant on the gain depth.
+ * @see data/kernels/limiter.json
+ */
+export const LIMITER_LIMITS = {
+  "ceilingDb": {
+    "min": -12,
+    "max": 0,
+    "step": 0.1,
+    "unit": "dBFS",
+    "default": -1,
+    "defaultFrom": "desk"
+  },
+  "lookaheadMs": {
+    "min": 0.5,
+    "max": 5,
+    "step": 0.1,
+    "unit": "ms",
+    "default": 1.5,
+    "defaultFrom": "desk"
+  },
+  "releaseMs": {
+    "min": 1,
+    "max": 1000,
+    "step": 1,
+    "unit": "ms",
+    "default": 50,
+    "defaultFrom": "desk"
+  }
+};
+
+/**
+ * The phaser's sweep speed (§3). `omx_lfo_inc` freezes at Nyquist; this travel stays far below.
+ * @see data/kernels/phaser.json
+ */
+export const PHASER_RATE_RANGE = {
+  "min": 0.05,
+  "max": 5,
+  "step": 0.01,
+  "unit": "Hz",
+  "default": 0.5,
+  "defaultFrom": "desk"
+};
+
+/**
+ * The phaser's lowest centre frequency; the sweep runs upward from it (§3).
+ * @see data/kernels/phaser.json
+ */
+export const PHASER_BASE_RANGE = {
+  "min": 50,
+  "max": 2000,
+  "step": 1,
+  "unit": "Hz",
+  "default": 200,
+  "defaultFrom": "desk"
+};
+
+/**
+ * The sweep's span above `base`, in octaves; 0 is a static phaser at `base` (§3).
+ * @see data/kernels/phaser.json
+ */
+export const PHASER_DEPTH_RANGE = {
+  "min": 0,
+  "max": 6,
+  "step": 0.1,
+  "unit": "oct",
+  "default": 4,
+  "defaultFrom": "desk"
+};
+
+/**
+ * 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.
+ * @see data/kernels/phaser.json
+ */
+export const PHASER_STAGES_RANGE = {
+  "min": 2,
+  "max": 12,
+  "step": 2,
+  "unit": "",
+  "default": 6,
+  "defaultFrom": "desk"
+};
+
+/**
+ * The member set the `stages` field accepts: PHASER_STAGES_RANGE walked by its step.
+ * @see data/kernels/phaser.json
+ */
+export const PHASER_STAGE_COUNTS = [
+  2,
+  4,
+  6,
+  8,
+  10,
+  12
+];
+
+/**
+ * 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.
+ * @see data/kernels/phaser.json
+ */
+export const PHASER_FEEDBACK_RANGE = {
+  "min": -0.9,
+  "max": 0.9,
+  "step": 0.01,
+  "unit": "",
+  "default": 0.4,
+  "defaultFrom": "desk"
+};
+
+/**
+ * The phaser's wet/dry, as an instance of DRIVE_MIX_RANGE: 50 %, where the notch is complete (§3).
+ * @see data/kernels/phaser.json
+ */
+export const PHASER_MIX_RANGE = {
+  "min": 0,
+  "max": 100,
+  "step": 0.1,
+  "unit": "%",
+  "default": 50,
+  "defaultFrom": "desk"
+};
+
+/**
+ * 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.
+ * @see data/kernels/phaser.json
+ */
+export const PHASER_TRAVELS = {
+  "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, moved from openmixer.
+ * @see data/kernels/pitch.json
+ */
+export const PITCH_LIMITS = {
+  "semitones": {
+    "min": -12,
+    "max": 12,
+    "default": 0
+  },
+  "cents": {
+    "min": -50,
+    "max": 50,
+    "default": 0
+  },
+  "mix": {
+    "min": 0,
+    "max": 100,
+    "default": 100
+  }
+};
+
+/**
+ * PITCH_KERNEL, moved from openmixer.
+ * @see data/kernels/pitch.json
+ */
+export const PITCH_KERNEL = {
+  "windowMs": 40,
+  "prefilterCeilingHz": 20000,
+  "prefilterQ": 0.7071067811865476
+};
+
+/**
+ * PLATE's tank MODULATION DEPTH, in percent of Dattorro's own excursion (±8 samples at his 29 761 Hz tuning rate, scaled to the live rate the way the tank lengths are). 100 is the depth the plate has always run at, so the come-up is bit-identical to the plate before the field; 0 brings back the unmodulated tank's ring; 400 is the wide, chorused EMT-style swing. The rate stays 1 Hz. Only PLATE reads it (`2026-09-26-native-fx-catalogue.md` §2, Reverb).
+ * @see data/kernels/reverb.json
+ */
+export const REVERB_PLATE_MOD_DEPTH_RANGE = {
+  "min": 0,
+  "max": 400,
+  "step": 1,
+  "unit": "%",
+  "default": 100,
+  "defaultFrom": "desk"
+};
+
+/**
+ * The horn's chorale (slow) rate, Hz.
+ * @see data/kernels/rotary.json
+ */
+export const ROTARY_HORN_SLOW_RANGE = {
+  "min": 0.1,
+  "max": 2,
+  "step": 0.01,
+  "unit": "Hz",
+  "default": 0.8,
+  "defaultFrom": "desk"
+};
+
+/**
+ * The horn's tremolo (fast) rate, Hz.
+ * @see data/kernels/rotary.json
+ */
+export const ROTARY_HORN_FAST_RANGE = {
+  "min": 3,
+  "max": 10,
+  "step": 0.01,
+  "unit": "Hz",
+  "default": 6.8,
+  "defaultFrom": "desk"
+};
+
+/**
+ * The drum's chorale (slow) rate, Hz.
+ * @see data/kernels/rotary.json
+ */
+export const ROTARY_DRUM_SLOW_RANGE = {
+  "min": 0.1,
+  "max": 2,
+  "step": 0.01,
+  "unit": "Hz",
+  "default": 0.7,
+  "defaultFrom": "desk"
+};
+
+/**
+ * The drum's tremolo (fast) rate, Hz.
+ * @see data/kernels/rotary.json
+ */
+export const ROTARY_DRUM_FAST_RANGE = {
+  "min": 3,
+  "max": 10,
+  "step": 0.01,
+  "unit": "Hz",
+  "default": 5.9,
+  "defaultFrom": "desk"
+};
+
+/**
+ * The scale on every speed-change time constant (`ROTARY_*_ACCEL_MS`/`_DECEL_MS`): 2 is twice as slow.
+ * @see data/kernels/rotary.json
+ */
+export const ROTARY_ACCEL_RANGE = {
+  "min": 0.25,
+  "max": 4,
+  "step": 0.01,
+  "unit": "x",
+  "default": 1,
+  "defaultFrom": "desk"
+};
+
+/**
+ * The drum/horn balance, percent: −100 drum only, +100 horn only; the law attenuates, never boosts.
+ * @see data/kernels/rotary.json
+ */
+export const ROTARY_BALANCE_RANGE = {
+  "min": -100,
+  "max": 100,
+  "step": 1,
+  "unit": "%",
+  "default": 0,
+  "defaultFrom": "desk"
+};
+
+/**
+ * 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).
+ * @see data/kernels/rotary.json
+ */
+export const ROTARY_MIX_RANGE = {
+  "min": 0,
+  "max": 100,
+  "step": 0.1,
+  "unit": "%",
+  "default": 100,
+  "defaultFrom": "desk"
+};
+
+/**
+ * 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).
+ * @see data/kernels/rotary.json
+ */
+export const ROTARY_TRAVELS = {
+  "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"
+  }
+};
+
+/**
+ * The complementary split's low-pass corner, Hz: the Leslie 122's passive crossover.
+ * @see data/kernels/rotary.json
+ */
+export const ROTARY_CROSSOVER_HZ = 800;
+
+/**
+ * The shortest Doppler read, ms — above the order-3 read's one-sample reach at every rate.
+ * @see data/kernels/rotary.json
+ */
+export const ROTARY_BASE_MS = 0.1;
+
+/**
+ * The horn's Doppler excursion `D_horn`, ms: a 0.15 m radius over 343 m/s.
+ * @see data/kernels/rotary.json
+ */
+export const ROTARY_HORN_DOPPLER_MS = 0.44;
+
+/**
+ * The drum's Doppler excursion `D_drum`, ms: its baffle turns over a fixed woofer.
+ * @see data/kernels/rotary.json
+ */
+export const ROTARY_DRUM_DOPPLER_MS = 0.29;
+
+/**
+ * The horn's amplitude swing `m_horn` (a −6 dB directivity dip), a ratio.
+ * @see data/kernels/rotary.json
+ */
+export const ROTARY_HORN_AM = 0.5;
+
+/**
+ * The drum baffle's amplitude swing `m_drum`, a ratio.
+ * @see data/kernels/rotary.json
+ */
+export const ROTARY_DRUM_AM = 0.3;
+
+/**
+ * The horn rotor's speed-up time constant, ms (at `accel` 1).
+ * @see data/kernels/rotary.json
+ */
+export const ROTARY_HORN_ACCEL_MS = 330;
+
+/**
+ * The horn rotor's slow-down time constant, ms (at `accel` 1).
+ * @see data/kernels/rotary.json
+ */
+export const ROTARY_HORN_DECEL_MS = 500;
+
+/**
+ * The drum rotor's speed-up time constant, ms (at `accel` 1).
+ * @see data/kernels/rotary.json
+ */
+export const ROTARY_DRUM_ACCEL_MS = 1700;
+
+/**
+ * The drum rotor's slow-down time constant, ms (at `accel` 1).
+ * @see data/kernels/rotary.json
+ */
+export const ROTARY_DRUM_DECEL_MS = 1800;
+
+/**
+ * Below this rate, Hz, a rotor coasting toward `stop` is snapped to exactly 0.
+ * @see data/kernels/rotary.json
+ */
+export const ROTARY_STOP_EPS = 0.0001;
+
+/**
+ * One inline ring per rotor per leg, floats — at least the 192 kHz need of the horn's sweep.
+ * @see data/kernels/rotary.json
+ */
+export const ROTARY_RING_FLOATS = 256;
+
+/**
+ * The legal range of each transient-designer field (engineering units), transient spec §3. Every kind comes up flat: no per-kind default differs. `harness/contract-limits-gen.mjs` emits each as `OMX_TRANSIENT_<FIELD>_{MIN,MAX,DEFAULT}` for `mix_transient.h`'s resolve; the row publishes them on OPTIONS when it lands (issue #921).
+ * @see data/kernels/transient.json
+ */
+export const TRANSIENT_LIMITS = {
+  "attackDb": {
+    "min": -24,
+    "max": 24,
+    "step": 0.1,
+    "unit": "dB",
+    "default": 0,
+    "defaultFrom": "desk"
+  },
+  "sustainDb": {
+    "min": -24,
+    "max": 24,
+    "step": 0.1,
+    "unit": "dB",
+    "default": 0,
+    "defaultFrom": "desk"
+  },
+  "attackTimeMs": {
+    "min": 2,
+    "max": 50,
+    "step": 0.1,
+    "unit": "ms",
+    "default": 10,
+    "defaultFrom": "desk"
+  },
+  "sustainTimeMs": {
+    "min": 50,
+    "max": 2000,
+    "step": 1,
+    "unit": "ms",
+    "default": 250,
+    "defaultFrom": "desk"
+  },
+  "outputDb": {
+    "min": -24,
+    "max": 12,
+    "step": 0.1,
+    "unit": "dB",
+    "default": 0,
+    "defaultFrom": "desk"
+  }
+};
+
+/**
+ * The fast follower's attack, ms: exactly the dynamics detector's no-oversampling line (transient spec §3, L7).
+ * @see data/kernels/transient.json
+ */
+export const TRANSIENT_FAST_ATTACK_MS = 0.5;
+
+/**
+ * The fast follower's release, ms: one 50 Hz cycle held, a 180 bpm sixteenth forgotten (transient spec §3).
+ * @see data/kernels/transient.json
+ */
+export const TRANSIENT_FAST_RELEASE_MS = 20;
+
+/**
+ * The contrast, dB, at which a knob reaches its full value (transient spec §2, §3).
+ * @see data/kernels/transient.json
+ */
+export const TRANSIENT_REF_DB = 6;
+
+/**
+ * The detector floor, linear (−100 dBFS): below it both envelopes read the floor and the stage is unity (transient spec §3).
+ * @see data/kernels/transient.json
+ */
+export const TRANSIENT_FLOOR_LIN = 0.00001;
+
+/**
+ * The tremolo's LFO rate (the catalogue row's 0.1..20 Hz); 4 Hz is the classic amp tremolo.
+ * @see data/kernels/tremolo.json
+ */
+export const TREMOLO_RATE_RANGE = {
+  "min": 0.1,
+  "max": 20,
+  "step": 0.01,
+  "unit": "Hz",
+  "default": 4,
+  "defaultFrom": "desk"
+};
+
+/**
+ * The tremolo's modulation depth: the gain's trough is `1 − mix·depth`.
+ * @see data/kernels/tremolo.json
+ */
+export const TREMOLO_DEPTH_RANGE = {
+  "min": 0,
+  "max": 100,
+  "step": 0.1,
+  "unit": "%",
+  "default": 50,
+  "defaultFrom": "desk"
+};
+
+/**
+ * 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).
+ * @see data/kernels/tremolo.json
+ */
+export const TREMOLO_MIX_RANGE = {
+  "min": 0,
+  "max": 100,
+  "step": 0.1,
+  "unit": "%",
+  "default": 100,
+  "defaultFrom": "desk"
+};
+
+/**
+ * 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).
+ * @see data/kernels/tremolo.json
+ */
+export const TREMOLO_TRAVELS = {
+  "rateHz": {
+    "min": 0.1,
+    "max": 20,
+    "step": 0.01,
+    "unit": "Hz",
+    "default": 4,
+    "defaultFrom": "desk"
+  },
+  "depth": {
+    "min": 0,
+    "max": 100,
+    "step": 0.1,
+    "unit": "%",
+    "default": 50,
+    "defaultFrom": "desk"
+  },
+  "mix": {
+    "min": 0,
+    "max": 100,
+    "step": 0.1,
+    "unit": "%",
+    "default": 100,
+    "defaultFrom": "desk"
+  }
+};
+
+/**
+ * The Q of a second-order Butterworth section, 1/√2 — maximally flat, the one value every Butterworth biquad in the tree designs at: the LR4 crossover section, the pitch pre-filter and the drive's tilt / band / HF sections, in TS and (as `OMX_BUTTERWORTH_Q`) in C (§7, the scalar door).
+ * @see data/primitives.json
+ */
+export const BUTTERWORTH_Q = 0.7071067811865476;
+
+/**
+ * ALLPASS_LIMITS, moved from openmixer.
+ * @see data/primitives.json
+ */
+export const ALLPASS_LIMITS = {
+  "unityTolerance": 0.0001
+};
+
+/**
+ * XOVER_LIMITS, moved from openmixer.
+ * @see data/primitives.json
+ */
+export const XOVER_LIMITS = {
+  "lr2SectionQ": 0.5,
+  "lr4SectionQ": 0.7071067811865476,
+  "partitionTolerance": 0.00001
+};
+
+/**
+ * The order the chorus and flanger construct their lines with (four taps; the fdelay spec §1).
+ * @see data/primitives.json
+ */
+export const FDELAY_MOD_READ_ORDER = 3;
+
+/**
+ * `Λ` for the chorus/flanger read — ONE value; the header and every law read this.
+ * @see data/primitives.json
+ */
+export const FDELAY_READ_L1_NORM = 1.25;
+
+/**
+ * The standard sample rates (Hz) the desk recognises — the pro-audio superset. One source of truth for the clock controller's `clock.allowed-rates` seed, the force row's validation ceiling and the device-rate probe fallback. What the operator is OFFERED is always the DEVICE's own `supportedRates` (`2026-07-15-clock-rate-honest-force-rate.md`) — this is the ceiling a write is refused by, never a menu.
+ * @see data/rates.json
+ */
+export const STANDARD_SAMPLE_RATES = [
+  44100,
+  48000,
+  88200,
+  96000,
+  176400,
+  192000
+];
+
+/**
+ * THE declaration: 192 kHz at quantum 128.
+ * @see data/rates.json
+ */
+export const RT_HARD_TARGET = {
+  "rate": 192000,
+  "quantum": 128
+};
+
+/**
+ * The rate a unit-range DSP knob is quoted at (R-058): the rate this desk runs (ruling 2026-09-14). A kernel raises the knob to `REF / sr`, so at this rate the exponent is exactly 1 and the response is bit-for-bit the one cut before the law. Emitted to C as `OMX_DSP_KNOB_REFERENCE_RATE`; the reverb damping and FX-delay tone references `#define` from it.
+ * @see data/rates.json
+ */
+export const DSP_KNOB_REFERENCE_RATE = 96000;