@openmixer/omx-contract 2.0.0 → 2.1.0

package/README.md

@@ -13,6 +13,7 @@ RTA constants, the EQ band budget, the choice enums (as the `set` kind), the EQ
 one rule that gives a fresh EQ its bands, the measurement rate sets and the bus input cap. What is
 declared here is declared nowhere else: the EQ band budget that 1.2.0 left in openmixer is here too.
 2.0.0 changes how a kernel file is written, not what it declares: every render is the same.
+2.1.0 adds each kernel's ordered controls to the JSON render, and a control's `rearms` flag.
 
 ```
 data/                        the declaration, one file per group, edited by hand
@@ -54,7 +55,10 @@ A kernel file, `data/kernels/<kernel>.json`, holds four sections and nothing els
 - `controls`, in order: a `travel` (one travel) or a `choice` (ordered `ids`, an optional `default` and `labels`).
   Its item name is `<KERNEL>_<NAME>_RANGE` for a travel and `<KERNEL>_<NAME>S` for a choice (`depth` in
   tremolo.json is `TREMOLO_DEPTH_RANGE`, `mode` is `TREMOLO_MODES`); `global` names it when it is anything else.
-  A control with a `table` is one field of that table.
+  A control with a `table` is one field of that table. `"rearms": true` marks a control whose change re-arms the
+  kernel's state, so it is not a smooth parameter (the limiter's `lookaheadMs`: omx-dsp's limiter face re-arms
+  the state and restarts the gain at unity when the look-ahead moves by a frame). It is a boolean, only on a
+  control; it is no item, so the C and TypeScript renders do not carry it.
 - `tables`: a travels table whose fields are the controls that name it, in control order (`GATE_LIMITS`).
 - `aggregates`: a travels table whose fields are references to controls declared once above, listed by name.
 - `constants`: scalars, lists and sheets, as items.
@@ -62,6 +66,36 @@ A kernel file, `data/kernels/<kernel>.json`, holds four sections and nothing els
 `omx-contract validate` refuses any other key, a constant that is a travel or a set, and a kernel file written
 as a flat item map (the 1.x shape). `rates.json` and `primitives.json` stay item maps.
 
+## The JSON render's kernels
+
+Beside `items`, `share/omx-contract/omx-contract.json` carries `kernels`: for every kernel file, its controls in
+the order the file declares them. A consumer reads control order and kinds here, never from a kernel file.
+
+```json
+"kernels": {
+  "limiter": {
+    "controls": [
+      { "name": "ceilingDb", "kind": "travel", "global": "LIMITER_LIMITS", "table": "LIMITER_LIMITS" },
+      { "name": "lookaheadMs", "kind": "travel", "global": "LIMITER_LIMITS", "table": "LIMITER_LIMITS", "rearms": true },
+      { "name": "releaseMs", "kind": "travel", "global": "LIMITER_LIMITS", "table": "LIMITER_LIMITS" }
+    ]
+  },
+  "tremolo": {
+    "controls": [
+      { "name": "rateHz", "kind": "travel", "global": "TREMOLO_RATE_RANGE" },
+      { "name": "mode", "kind": "choice", "global": "TREMOLO_MODES" }
+    ]
+  }
+}
+```
+
+- `kind`: `travel` or `choice`.
+- `global`: the item the control's value lives in: `items[global].value` for a travel or a choice, and
+  `items[global].value[name]` for a field of a table, when `table` (the same item) is present.
+- `rearms`: present, and `true`, only on a control that declares it.
+
+A kernel with no controls (fbs, mixmatrix, rta) is listed with an empty `controls`.
+
 ## The CLI
 
 ```
@@ -78,9 +112,9 @@ share/omx-contract` and `render --target ts --out test/golden/ts`; CI holds all
 
 ## Consuming it
 
-Pin one version (`omx-contract 2.0.0` in `.github/pins.txt`) and build against its renders, committing
+Pin one version (`omx-contract 2.1.0` in `.github/pins.txt`) and build against its renders, committing
 none: the installed `omx-contract-devel` / `libomx-contract-dev` at exactly that version
-(`pkg-config --exact-version=2.0.0 omx-contract`), else the release's npm tarball, unpacked, and
+(`pkg-config --exact-version=2.1.0 omx-contract`), else the release's npm tarball, unpacked, and
 `omx-contract render --target c --out build/omx-contract/include`. Include
 `<omxcontract/omx_contract_limits.h>`. A plugin's parameter header is rendered by omx-plugins from its
 declaration, by reference to the kernel travels here (since 1.1.0).

package/data/kernels/limiter.json

@@ -18,6 +18,7 @@
       "name": "lookaheadMs",
       "kind": "travel",
       "table": "LIMITER_LIMITS",
+      "rearms": true,
       "travel": {
         "min": 0.5,
         "max": 5,

package/lib/data.mjs

@@ -70,7 +70,7 @@ export function entriesOf(rel, doc) {
   const controls = Array.isArray(doc.controls) ? doc.controls : [];
   const tables = new Map(Object.entries(doc.tables ?? {}).map(([n, meta]) => [n, { kind: 'travels', ...meta, fields: {} }]));
   for (const c of controls) {
-    const { name, kind, global, table, ...rest } = c;
+    const { name, kind, global, table, rearms, ...rest } = c;
     if (table) {
       if (!tables.has(table)) throw new Error(`${rel}: control ${name} names table ${table}, which is not declared`);
       tables.get(table).fields[name] = rest.travel;
@@ -91,6 +91,33 @@ export function entriesOf(rel, doc) {
   return out;
 }
 
+/** A kernel's name, read off its file name: `kernels/band_dyn.json` is band_dyn. */
+export const kernelName = (rel) => rel.replace(/^.*\//, '').replace(/\.json$/, '');
+
+/**
+ * Every kernel's controls, in its file's order: `{ <kernel>: { controls: [{ name, kind, global, table?, rearms? }] } }`,
+ * kernels in file order. `global` is the item the control's value lives in: its own travel or set, or, for a field of
+ * a table, the table (`table` names it too, and the field is the control's name). `rearms` is carried only when true:
+ * changing the control re-arms the kernel's state, it is not a smooth parameter.
+ */
+export function kernelControls(data) {
+  const out = {};
+  for (const f of data.files) {
+    if (!isKernelFile(f.rel)) continue;
+    const controls = Array.isArray(f.doc.controls) ? f.doc.controls : [];
+    out[kernelName(f.rel)] = {
+      controls: controls.map((c) => ({
+        name: c.name,
+        kind: c.kind,
+        global: c.table ?? controlGlobal(f.rel, c),
+        ...(c.table ? { table: c.table } : {}),
+        ...(c.rearms === true ? { rearms: true } : {}),
+      })),
+    };
+  }
+  return out;
+}
+
 const isWholeRef = (v) => typeof v === 'object' && v !== null && Object.keys(v).length === 1 && typeof v.ref === 'string' && !v.ref.includes('.');
 
 /**
@@ -213,7 +240,8 @@ const isObj = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
 
 /**
  * Resolve every item: `{ name, rel, kind, doc, why?, unit?, c?, shape?, default?, labels?, value }` (default and labels: a set's), where `value` has
- * every `{ref}` and `{derive}` evaluated.
+ * every `{ref}` and `{derive}` evaluated. The returned map also carries `kernels`, every kernel's ordered controls
+ * (kernelControls), which the json render publishes beside the items.
  * @throws naming the item: a reference that does not resolve, a cycle, an unknown derivation.
  */
 export function resolveData(data) {
@@ -262,6 +290,7 @@ export function resolveData(data) {
   }
   const out = new Map();
   for (const name of data.items.keys()) out.set(name, resolveItem(name));
+  out.kernels = kernelControls(data);
   return out;
 }
 

package/lib/fmt.mjs

@@ -8,7 +8,7 @@
  */
 
 const ORDER = {
-  control: ['name', 'kind', 'global', 'table', 'since', 'doc', 'why', 'unit', 'ids', 'default', 'labels', 'travel', 'c'],
+  control: ['name', 'kind', 'global', 'table', 'rearms', 'since', 'doc', 'why', 'unit', 'ids', 'default', 'labels', 'travel', 'c'],
   sections: ['controls', 'tables', 'aggregates', 'constants'],
   item: ['kind', 'since', 'doc', 'why', 'unit', 'value', 'values', 'ids', 'default', 'labels', 'fields', 'travel', 'c'],
   travel: ['min', 'max', 'step', 'unit', 'default', 'defaultFrom', 'scale', 'byKind', 'doc', 'why'],

package/lib/validate.mjs

@@ -18,7 +18,7 @@ let compiled;
 /**
  * The kernel-file shape (2.0.0), which the item schema cannot see: only the four sections at the top; every control
  * named, of kind travel or choice, unique by name, a travel carrying a `travel` and a choice its `ids`; a control's
- * `table` declared under `tables`; an aggregate's fields naming controls; a constant a scalar, a list or a sheet.
+ * `table` declared under `tables`; `rearms` a boolean, and only on a control; an aggregate's fields naming controls; a constant a scalar, a list or a sheet.
  * A kernel file written as a flat item map (the 1.x shape) is refused as a whole. Any other data file returns [].
  */
 export function shapeProblems(rel, doc) {
@@ -41,6 +41,10 @@ export function shapeProblems(rel, doc) {
     else if (c.kind === 'choice' && !Array.isArray(c.ids)) out.push(`controls[${i}] ${c.name}: a choice without "ids"`);
     else if (c.kind !== 'travel' && c.kind !== 'choice') out.push(`controls[${i}] ${c.name}: kind ${JSON.stringify(c.kind)} is neither travel nor choice`);
     if (c.table && !(doc.tables && c.table in doc.tables)) out.push(`controls[${i}] ${c.name}: table ${c.table} is not declared`);
+    if ('rearms' in c && typeof c.rearms !== 'boolean') out.push(`controls[${i}] ${c.name}: rearms ${JSON.stringify(c.rearms)} is not a boolean`);
+  }
+  for (const s of ['tables', 'aggregates', 'constants']) {
+    for (const [n, it] of Object.entries(doc[s] ?? {})) if (it && typeof it === 'object' && 'rearms' in it) out.push(`${s} ${n}: rearms is a control's flag, never a ${s.slice(0, -1)}'s`);
   }
   for (const [n, a] of Object.entries(doc.aggregates ?? {})) for (const f of a.fields ?? []) if (!seen.has(f)) out.push(`aggregate ${n}: field ${f} names no control`);
   for (const [n, it] of Object.entries(doc.constants ?? {})) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openmixer/omx-contract",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "The FreeMixer declarations as data: a JSON Schema, the data, and one CLI that renders them into C, TypeScript and JSON",
   "type": "module",
   "license": "GPL-3.0-or-later",

package/render/json.mjs

@@ -2,7 +2,9 @@
 // Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
 /**
  * The `json` target: the resolved data (every reference and derivation evaluated) for readers in
- * other languages, which need no resolver of their own.
+ * other languages, which need no resolver of their own. Beside the items, `kernels` lists each
+ * kernel's controls in their declared order (name, kind, the global each resolves to, the table of a
+ * table field, `rearms` when changing it re-arms the kernel's state), so a reader needs no kernel file.
  */
 
 /** Every file of the `json` target: `[{ path, text }]`. */
@@ -12,5 +14,7 @@ export function renderJson(resolved, version) {
     const { name, ...rest } = r;
     items[name] = rest;
   }
-  return [{ path: 'omx-contract.json', text: `${JSON.stringify({ name: '@openmixer/omx-contract', version, items }, null, 2)}\n` }];
+  const doc = { name: '@openmixer/omx-contract', version, items };
+  if (resolved.kernels) doc.kernels = resolved.kernels;
+  return [{ path: 'omx-contract.json', text: `${JSON.stringify(doc, null, 2)}\n` }];
 }

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

@@ -1,6 +1,6 @@
 {
   "name": "@openmixer/omx-contract",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "items": {
     "PAN_RANGE": {
       "rel": "data/kernels/balance.json",
@@ -2369,5 +2369,640 @@
         192000
       ]
     }
+  },
+  "kernels": {
+    "balance": {
+      "controls": [
+        {
+          "name": "pan",
+          "kind": "travel",
+          "global": "PAN_RANGE"
+        }
+      ]
+    },
+    "band_dyn": {
+      "controls": [
+        {
+          "name": "mode",
+          "kind": "choice",
+          "global": "BAND_DYN_MODES"
+        },
+        {
+          "name": "threshold",
+          "kind": "travel",
+          "global": "BAND_DYN_THRESHOLD_RANGE"
+        },
+        {
+          "name": "ratio",
+          "kind": "travel",
+          "global": "BAND_DYN_RATIO_RANGE"
+        },
+        {
+          "name": "range",
+          "kind": "travel",
+          "global": "BAND_DYN_RANGE_RANGE"
+        },
+        {
+          "name": "attack",
+          "kind": "travel",
+          "global": "BAND_DYN_ATTACK_RANGE"
+        },
+        {
+          "name": "release",
+          "kind": "travel",
+          "global": "BAND_DYN_RELEASE_RANGE"
+        }
+      ]
+    },
+    "chorus": {
+      "controls": [
+        {
+          "name": "spread",
+          "kind": "travel",
+          "global": "CHORUS_SPREAD_RANGE"
+        },
+        {
+          "name": "rate",
+          "kind": "travel",
+          "global": "CHORUS_RATE_RANGE"
+        },
+        {
+          "name": "depth",
+          "kind": "travel",
+          "global": "CHORUS_DEPTH_RANGE"
+        },
+        {
+          "name": "voices",
+          "kind": "travel",
+          "global": "CHORUS_VOICES_RANGE"
+        },
+        {
+          "name": "mix",
+          "kind": "travel",
+          "global": "CHORUS_MIX_RANGE"
+        }
+      ]
+    },
+    "comp": {
+      "controls": [
+        {
+          "name": "thresholdDb",
+          "kind": "travel",
+          "global": "COMP_LIMITS",
+          "table": "COMP_LIMITS"
+        },
+        {
+          "name": "ratio",
+          "kind": "travel",
+          "global": "COMP_LIMITS",
+          "table": "COMP_LIMITS"
+        },
+        {
+          "name": "kneeDb",
+          "kind": "travel",
+          "global": "COMP_LIMITS",
+          "table": "COMP_LIMITS"
+        },
+        {
+          "name": "attackMs",
+          "kind": "travel",
+          "global": "COMP_LIMITS",
+          "table": "COMP_LIMITS"
+        },
+        {
+          "name": "releaseMs",
+          "kind": "travel",
+          "global": "COMP_LIMITS",
+          "table": "COMP_LIMITS"
+        },
+        {
+          "name": "makeupDb",
+          "kind": "travel",
+          "global": "COMP_LIMITS",
+          "table": "COMP_LIMITS"
+        },
+        {
+          "name": "mixPct",
+          "kind": "travel",
+          "global": "COMP_LIMITS",
+          "table": "COMP_LIMITS"
+        }
+      ]
+    },
+    "deesser": {
+      "controls": [
+        {
+          "name": "deessFreq",
+          "kind": "travel",
+          "global": "DEESS_FREQ_RANGE"
+        },
+        {
+          "name": "deessWidth",
+          "kind": "travel",
+          "global": "DEESS_WIDTH_RANGE"
+        },
+        {
+          "name": "deessThreshold",
+          "kind": "travel",
+          "global": "DEESS_THRESHOLD_RANGE"
+        },
+        {
+          "name": "deessRatio",
+          "kind": "travel",
+          "global": "DEESS_RATIO_RANGE"
+        },
+        {
+          "name": "deessRange",
+          "kind": "travel",
+          "global": "DEESS_RANGE_RANGE"
+        },
+        {
+          "name": "deessAttack",
+          "kind": "travel",
+          "global": "DEESS_ATTACK_RANGE"
+        },
+        {
+          "name": "deessRelease",
+          "kind": "travel",
+          "global": "DEESS_RELEASE_RANGE"
+        },
+        {
+          "name": "deessMode",
+          "kind": "choice",
+          "global": "DEESS_MODES"
+        }
+      ]
+    },
+    "delay": {
+      "controls": [
+        {
+          "name": "fxDelayTime",
+          "kind": "travel",
+          "global": "FX_DELAY_TIME_RANGE"
+        },
+        {
+          "name": "fxDelayFeedback",
+          "kind": "travel",
+          "global": "FX_DELAY_FEEDBACK_RANGE"
+        },
+        {
+          "name": "tone",
+          "kind": "travel",
+          "global": "DELAY_TONE_RANGE"
+        },
+        {
+          "name": "mix",
+          "kind": "travel",
+          "global": "DELAY_MIX_RANGE"
+        }
+      ]
+    },
+    "drive": {
+      "controls": [
+        {
+          "name": "amount",
+          "kind": "travel",
+          "global": "DRIVE_AMOUNT_RANGE"
+        },
+        {
+          "name": "character",
+          "kind": "travel",
+          "global": "DRIVE_CHARACTER_RANGE"
+        },
+        {
+          "name": "bandFreq",
+          "kind": "travel",
+          "global": "DRIVE_BAND_FREQ_RANGE"
+        },
+        {
+          "name": "mix",
+          "kind": "travel",
+          "global": "DRIVE_MIX_RANGE"
+        },
+        {
+          "name": "trim",
+          "kind": "travel",
+          "global": "DRIVE_TRIM_RANGE"
+        },
+        {
+          "name": "curve",
+          "kind": "choice",
+          "global": "DRIVE_CURVES"
+        },
+        {
+          "name": "band",
+          "kind": "choice",
+          "global": "DRIVE_BANDS"
+        }
+      ]
+    },
+    "eq": {
+      "controls": [
+        {
+          "name": "freq",
+          "kind": "travel",
+          "global": "EQ_FREQ_RANGE"
+        },
+        {
+          "name": "gain",
+          "kind": "travel",
+          "global": "EQ_GAIN_RANGE"
+        },
+        {
+          "name": "q",
+          "kind": "travel",
+          "global": "EQ_Q_RANGE"
+        },
+        {
+          "name": "notchQ",
+          "kind": "travel",
+          "global": "EQ_NOTCH_Q_RANGE"
+        },
+        {
+          "name": "hpfFreq",
+          "kind": "travel",
+          "global": "HPF_FREQ_RANGE"
+        },
+        {
+          "name": "lpfFreq",
+          "kind": "travel",
+          "global": "LPF_FREQ_RANGE"
+        },
+        {
+          "name": "bandType",
+          "kind": "choice",
+          "global": "EQ_BAND_TYPES"
+        },
+        {
+          "name": "filterSlope",
+          "kind": "choice",
+          "global": "FILTER_SLOPES"
+        }
+      ]
+    },
+    "fbs": {
+      "controls": []
+    },
+    "flanger": {
+      "controls": [
+        {
+          "name": "rate",
+          "kind": "travel",
+          "global": "FLANGER_RATE_RANGE"
+        },
+        {
+          "name": "depth",
+          "kind": "travel",
+          "global": "FLANGER_DEPTH_RANGE"
+        },
+        {
+          "name": "feedback",
+          "kind": "travel",
+          "global": "FLANGER_FEEDBACK_RANGE"
+        },
+        {
+          "name": "mix",
+          "kind": "travel",
+          "global": "FLANGER_MIX_RANGE"
+        }
+      ]
+    },
+    "gate": {
+      "controls": [
+        {
+          "name": "keySource",
+          "kind": "choice",
+          "global": "GATE_KEY_SOURCES"
+        },
+        {
+          "name": "thresholdDb",
+          "kind": "travel",
+          "global": "GATE_LIMITS",
+          "table": "GATE_LIMITS"
+        },
+        {
+          "name": "rangeDb",
+          "kind": "travel",
+          "global": "GATE_LIMITS",
+          "table": "GATE_LIMITS"
+        },
+        {
+          "name": "kneeStartDb",
+          "kind": "travel",
+          "global": "GATE_LIMITS",
+          "table": "GATE_LIMITS"
+        },
+        {
+          "name": "kneeEndDb",
+          "kind": "travel",
+          "global": "GATE_LIMITS",
+          "table": "GATE_LIMITS"
+        },
+        {
+          "name": "attackMs",
+          "kind": "travel",
+          "global": "GATE_LIMITS",
+          "table": "GATE_LIMITS"
+        },
+        {
+          "name": "holdMs",
+          "kind": "travel",
+          "global": "GATE_LIMITS",
+          "table": "GATE_LIMITS"
+        },
+        {
+          "name": "releaseMs",
+          "kind": "travel",
+          "global": "GATE_LIMITS",
+          "table": "GATE_LIMITS"
+        },
+        {
+          "name": "hysteresisDb",
+          "kind": "travel",
+          "global": "GATE_LIMITS",
+          "table": "GATE_LIMITS"
+        },
+        {
+          "name": "ratio",
+          "kind": "travel",
+          "global": "GATE_LIMITS",
+          "table": "GATE_LIMITS"
+        }
+      ]
+    },
+    "geq": {
+      "controls": [
+        {
+          "name": "band",
+          "kind": "travel",
+          "global": "GEQ_BAND_RANGE"
+        }
+      ]
+    },
+    "hrp": {
+      "controls": [
+        {
+          "name": "amount",
+          "kind": "travel",
+          "global": "HRP_AMOUNT_RANGE"
+        }
+      ]
+    },
+    "limiter": {
+      "controls": [
+        {
+          "name": "ceilingDb",
+          "kind": "travel",
+          "global": "LIMITER_LIMITS",
+          "table": "LIMITER_LIMITS"
+        },
+        {
+          "name": "lookaheadMs",
+          "kind": "travel",
+          "global": "LIMITER_LIMITS",
+          "table": "LIMITER_LIMITS",
+          "rearms": true
+        },
+        {
+          "name": "releaseMs",
+          "kind": "travel",
+          "global": "LIMITER_LIMITS",
+          "table": "LIMITER_LIMITS"
+        }
+      ]
+    },
+    "mixmatrix": {
+      "controls": []
+    },
+    "phaser": {
+      "controls": [
+        {
+          "name": "rateHz",
+          "kind": "travel",
+          "global": "PHASER_RATE_RANGE"
+        },
+        {
+          "name": "baseHz",
+          "kind": "travel",
+          "global": "PHASER_BASE_RANGE"
+        },
+        {
+          "name": "depthOct",
+          "kind": "travel",
+          "global": "PHASER_DEPTH_RANGE"
+        },
+        {
+          "name": "stages",
+          "kind": "travel",
+          "global": "PHASER_STAGES_RANGE"
+        },
+        {
+          "name": "feedback",
+          "kind": "travel",
+          "global": "PHASER_FEEDBACK_RANGE"
+        },
+        {
+          "name": "mix",
+          "kind": "travel",
+          "global": "PHASER_MIX_RANGE"
+        }
+      ]
+    },
+    "pitch": {
+      "controls": [
+        {
+          "name": "semitones",
+          "kind": "travel",
+          "global": "PITCH_LIMITS",
+          "table": "PITCH_LIMITS"
+        },
+        {
+          "name": "cents",
+          "kind": "travel",
+          "global": "PITCH_LIMITS",
+          "table": "PITCH_LIMITS"
+        },
+        {
+          "name": "mix",
+          "kind": "travel",
+          "global": "PITCH_LIMITS",
+          "table": "PITCH_LIMITS"
+        }
+      ]
+    },
+    "reverb": {
+      "controls": [
+        {
+          "name": "plateModDepth",
+          "kind": "travel",
+          "global": "REVERB_PLATE_MOD_DEPTH_RANGE"
+        },
+        {
+          "name": "mix",
+          "kind": "travel",
+          "global": "REVERB_MIX_RANGE"
+        },
+        {
+          "name": "size",
+          "kind": "travel",
+          "global": "REVERB_SIZE_RANGE"
+        },
+        {
+          "name": "damping",
+          "kind": "travel",
+          "global": "REVERB_DAMPING_RANGE"
+        },
+        {
+          "name": "width",
+          "kind": "travel",
+          "global": "REVERB_WIDTH_RANGE"
+        },
+        {
+          "name": "predelay",
+          "kind": "travel",
+          "global": "REVERB_PREDELAY_RANGE"
+        },
+        {
+          "name": "lowcut",
+          "kind": "travel",
+          "global": "REVERB_LOWCUT_RANGE"
+        },
+        {
+          "name": "highcut",
+          "kind": "travel",
+          "global": "REVERB_HIGHCUT_RANGE"
+        },
+        {
+          "name": "reverse",
+          "kind": "travel",
+          "global": "REVERB_REVERSE_RANGE"
+        },
+        {
+          "name": "hold",
+          "kind": "travel",
+          "global": "REVERB_HOLD_RANGE"
+        },
+        {
+          "name": "release",
+          "kind": "travel",
+          "global": "REVERB_RELEASE_RANGE"
+        },
+        {
+          "name": "gateThreshold",
+          "kind": "travel",
+          "global": "REVERB_GATE_THRESHOLD_RANGE"
+        },
+        {
+          "name": "algorithm",
+          "kind": "choice",
+          "global": "REVERB_ALGORITHMS"
+        }
+      ]
+    },
+    "rotary": {
+      "controls": [
+        {
+          "name": "hornSlowHz",
+          "kind": "travel",
+          "global": "ROTARY_HORN_SLOW_RANGE"
+        },
+        {
+          "name": "hornFastHz",
+          "kind": "travel",
+          "global": "ROTARY_HORN_FAST_RANGE"
+        },
+        {
+          "name": "drumSlowHz",
+          "kind": "travel",
+          "global": "ROTARY_DRUM_SLOW_RANGE"
+        },
+        {
+          "name": "drumFastHz",
+          "kind": "travel",
+          "global": "ROTARY_DRUM_FAST_RANGE"
+        },
+        {
+          "name": "accel",
+          "kind": "travel",
+          "global": "ROTARY_ACCEL_RANGE"
+        },
+        {
+          "name": "balance",
+          "kind": "travel",
+          "global": "ROTARY_BALANCE_RANGE"
+        },
+        {
+          "name": "mix",
+          "kind": "travel",
+          "global": "ROTARY_MIX_RANGE"
+        },
+        {
+          "name": "speed",
+          "kind": "choice",
+          "global": "ROTARY_SPEEDS"
+        }
+      ]
+    },
+    "rta": {
+      "controls": []
+    },
+    "transient": {
+      "controls": [
+        {
+          "name": "attackDb",
+          "kind": "travel",
+          "global": "TRANSIENT_LIMITS",
+          "table": "TRANSIENT_LIMITS"
+        },
+        {
+          "name": "sustainDb",
+          "kind": "travel",
+          "global": "TRANSIENT_LIMITS",
+          "table": "TRANSIENT_LIMITS"
+        },
+        {
+          "name": "attackTimeMs",
+          "kind": "travel",
+          "global": "TRANSIENT_LIMITS",
+          "table": "TRANSIENT_LIMITS"
+        },
+        {
+          "name": "sustainTimeMs",
+          "kind": "travel",
+          "global": "TRANSIENT_LIMITS",
+          "table": "TRANSIENT_LIMITS"
+        },
+        {
+          "name": "outputDb",
+          "kind": "travel",
+          "global": "TRANSIENT_LIMITS",
+          "table": "TRANSIENT_LIMITS"
+        }
+      ]
+    },
+    "tremolo": {
+      "controls": [
+        {
+          "name": "rateHz",
+          "kind": "travel",
+          "global": "TREMOLO_RATE_RANGE"
+        },
+        {
+          "name": "depth",
+          "kind": "travel",
+          "global": "TREMOLO_DEPTH_RANGE"
+        },
+        {
+          "name": "mix",
+          "kind": "travel",
+          "global": "TREMOLO_MIX_RANGE"
+        },
+        {
+          "name": "mode",
+          "kind": "choice",
+          "global": "TREMOLO_MODES"
+        }
+      ]
+    }
   }
 }