@openmixer/omx-contract 1.2.1 → 1.3.0

package/include/omxcontract/omx_contract_limits.h

@@ -2,6 +2,7 @@
 // Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
 #ifndef OMX_CONTRACT_LIMITS_H
 #define OMX_CONTRACT_LIMITS_H
+#include <math.h>
 /*
  * GENERATED — DO NOT EDIT BY HAND.
  * Produced by `omx-contract render --target c` from FreeMixer/omx-contract's data/, the declaration
@@ -128,13 +129,16 @@
  * is an integer literal, any other a float literal AND its OMX_<macro>_DOUBLE spelling. */
 #define OMX_ALLPASS_UNITY_TOLERANCE 0.0001f
 #define OMX_ALLPASS_UNITY_TOLERANCE_DOUBLE 0.0001
+#define OMX_BUS_INPUT_CAP 128
 #define OMX_BUTTERWORTH_Q 0.7071067811865476f
 #define OMX_BUTTERWORTH_Q_DOUBLE 0.7071067811865476
+#define OMX_CHORUS_BASE_MS 10
 #define OMX_CHORUS_DEPTH_RANGE_DEFAULT 4
 #define OMX_CHORUS_DEPTH_RANGE_MAX 12
 #define OMX_CHORUS_DEPTH_RANGE_MIN 0
 #define OMX_CHORUS_DEPTH_RANGE_STEP 0.1f
 #define OMX_CHORUS_DEPTH_RANGE_STEP_DOUBLE 0.1
+#define OMX_CHORUS_MAX_MS 22
 #define OMX_CHORUS_MIX_RANGE_DEFAULT 35
 #define OMX_CHORUS_MIX_RANGE_MAX 100
 #define OMX_CHORUS_MIX_RANGE_MIN 0
@@ -157,6 +161,7 @@
 #define OMX_CHORUS_VOICES_RANGE_MAX 4
 #define OMX_CHORUS_VOICES_RANGE_MIN 1
 #define OMX_CHORUS_VOICES_RANGE_STEP 1
+#define OMX_DEEP_PLATEAU_FRAMES 20
 #define OMX_DEESS_ATTACK_RANGE_DEFAULT 1
 #define OMX_DEESS_ATTACK_RANGE_MAX 50
 #define OMX_DEESS_ATTACK_RANGE_MIN 0.1f
@@ -193,6 +198,20 @@
 #define OMX_DEESS_WIDTH_RANGE_MIN_DOUBLE 0.25
 #define OMX_DEESS_WIDTH_RANGE_STEP 0.05f
 #define OMX_DEESS_WIDTH_RANGE_STEP_DOUBLE 0.05
+#define OMX_DEFAULT_THRESHOLDS_GROWTH_CONFIRM_FRAMES 2
+#define OMX_DEFAULT_THRESHOLDS_GROWTH_MAX_DIP_DB 0.5f
+#define OMX_DEFAULT_THRESHOLDS_GROWTH_MAX_DIP_DB_DOUBLE 0.5
+#define OMX_DEFAULT_THRESHOLDS_GROWTH_MAX_SINGLE_FRAME_SHARE 0.5f
+#define OMX_DEFAULT_THRESHOLDS_GROWTH_MAX_SINGLE_FRAME_SHARE_DOUBLE 0.5
+#define OMX_DEFAULT_THRESHOLDS_GROWTH_MIN_DB_PER_FRAME 0.8f
+#define OMX_DEFAULT_THRESHOLDS_GROWTH_MIN_DB_PER_FRAME_DOUBLE 0.8
+#define OMX_DEFAULT_THRESHOLDS_GROWTH_MIN_TOTAL_RISE_DB 6
+#define OMX_DEFAULT_THRESHOLDS_PAPR_DB 18
+#define OMX_DEFAULT_THRESHOLDS_PERSIST_FRAMES 5
+#define OMX_DEFAULT_THRESHOLDS_PHPR_DB 9
+#define OMX_DEFAULT_THRESHOLDS_PNPR_DB 12
+#define OMX_DEFAULT_THRESHOLDS_PSHR_MIN_DB 10
+#define OMX_DEFAULT_THRESHOLDS_SUB_CLEAN_FRAMES 5
 #define OMX_DELAY_MIX_RANGE_BY_KIND_FX_RETURN 1
 #define OMX_DELAY_MIX_RANGE_DEFAULT 0.3f
 #define OMX_DELAY_MIX_RANGE_DEFAULT_DOUBLE 0.3
@@ -231,6 +250,18 @@
 #define OMX_DRIVE_TRIM_RANGE_STEP 0.1f
 #define OMX_DRIVE_TRIM_RANGE_STEP_DOUBLE 0.1
 #define OMX_DSP_KNOB_REFERENCE_RATE 96000
+#define OMX_EQ_BAND_COUNTS_CHANNEL_DEFAULT 4
+#define OMX_EQ_BAND_COUNTS_CHANNEL_MAX 24
+#define OMX_EQ_BAND_COUNTS_EQ16_DEFAULT 16
+#define OMX_EQ_BAND_COUNTS_EQ16_MAX 16
+#define OMX_EQ_BAND_COUNTS_EQ32_DEFAULT 32
+#define OMX_EQ_BAND_COUNTS_EQ32_MAX 32
+#define OMX_EQ_BAND_COUNTS_EQ8_DEFAULT 8
+#define OMX_EQ_BAND_COUNTS_EQ8_MAX 8
+#define OMX_EQ_BAND_COUNTS_STRIP_DEFAULT 4
+#define OMX_EQ_BAND_COUNTS_STRIP_MAX 4
+#define OMX_EQ_BAND_DEFAULTS_GAIN_DB 0
+#define OMX_EQ_BAND_DEFAULTS_Q 1
 #define OMX_EQ_FREQ_RANGE_MAX 20000
 #define OMX_EQ_FREQ_RANGE_MIN 20
 #define OMX_EQ_FREQ_RANGE_STEP 10
@@ -243,14 +274,29 @@
 #define OMX_EQ_NOTCH_Q_RANGE_MIN 0.3f
 #define OMX_EQ_NOTCH_Q_RANGE_MIN_DOUBLE 0.3
 #define OMX_EQ_NOTCH_Q_RANGE_STEP 1
+#define OMX_EQ_PASS_FILTER_DEFAULTS_HPF_FREQ_HZ 80
+#define OMX_EQ_PASS_FILTER_DEFAULTS_LPF_FREQ_HZ 18000
 #define OMX_EQ_Q_RANGE_MAX 8
 #define OMX_EQ_Q_RANGE_MIN 0.3f
 #define OMX_EQ_Q_RANGE_MIN_DOUBLE 0.3
 #define OMX_EQ_Q_RANGE_STEP 0.1f
 #define OMX_EQ_Q_RANGE_STEP_DOUBLE 0.1
+#define OMX_FBS_DEFAULT_MAX_AUTO_BANDS 6
+#define OMX_FBS_DEFAULT_NOTCH_Q 116
+#define OMX_FBS_FLOOR_LIN 1e-12f
+#define OMX_FBS_FLOOR_LIN_DOUBLE 1e-12
+#define OMX_FBS_MAX_NOTCH_DEPTH_DB 18
+#define OMX_FBS_PAPR_GUARD_BINS 2
+#define OMX_FBS_PHPR_HARMONICS 3
+#define OMX_FBS_PNPR_GUARD_BINS 1
+#define OMX_FBS_PNPR_RADIUS_BINS 3
+#define OMX_FBS_PSHR_SELF_SKIP_BINS 3
+#define OMX_FBS_TRACK_SLOTS 512
 #define OMX_FDELAY_MOD_READ_ORDER 3
 #define OMX_FDELAY_READ_L1_NORM 1.25f
 #define OMX_FDELAY_READ_L1_NORM_DOUBLE 1.25
+#define OMX_FLANGER_BASE_MS 0.5f
+#define OMX_FLANGER_BASE_MS_DOUBLE 0.5
 #define OMX_FLANGER_DEPTH_RANGE_DEFAULT 2
 #define OMX_FLANGER_DEPTH_RANGE_MAX 5
 #define OMX_FLANGER_DEPTH_RANGE_MIN 0
@@ -264,6 +310,7 @@
 #define OMX_FLANGER_FEEDBACK_RANGE_MIN_DOUBLE -0.95
 #define OMX_FLANGER_FEEDBACK_RANGE_STEP 0.01f
 #define OMX_FLANGER_FEEDBACK_RANGE_STEP_DOUBLE 0.01
+#define OMX_FLANGER_MAX_MS 6
 #define OMX_FLANGER_MIX_RANGE_DEFAULT 50
 #define OMX_FLANGER_MIX_RANGE_MAX 100
 #define OMX_FLANGER_MIX_RANGE_MIN 0
@@ -296,12 +343,35 @@
 #define OMX_GEQ_BAND_RANGE_STEP_DOUBLE 0.5
 #define OMX_GEQ_DESIGN_GAIN_MAX_DB 30
 #define OMX_GEQ_PROTO_DB 12
+#define OMX_GROWTH_CONFIRM_FRAMES 2
+#define OMX_GROWTH_MAX_DIP_DB 0.5f
+#define OMX_GROWTH_MAX_DIP_DB_DOUBLE 0.5
+#define OMX_GROWTH_MAX_SINGLE_FRAME_SHARE 0.5f
+#define OMX_GROWTH_MAX_SINGLE_FRAME_SHARE_DOUBLE 0.5
+#define OMX_GROWTH_MIN_DB_PER_FRAME 0.8f
+#define OMX_GROWTH_MIN_DB_PER_FRAME_DOUBLE 0.8
+#define OMX_GROWTH_MIN_TOTAL_RISE_DB 6
+#define OMX_GROWTH_WINDOW_FRAMES 5
 #define OMX_HPF_FREQ_RANGE_MAX 1000
 #define OMX_HPF_FREQ_RANGE_MIN 20
 #define OMX_HPF_FREQ_RANGE_STEP 10
+#define OMX_HRP_AMOUNT_RANGE_DEFAULT 0.5f
+#define OMX_HRP_AMOUNT_RANGE_DEFAULT_DOUBLE 0.5
+#define OMX_HRP_AMOUNT_RANGE_MAX 1
+#define OMX_HRP_AMOUNT_RANGE_MIN 0
+#define OMX_HRP_AMOUNT_RANGE_STEP 0
+#define OMX_HRP_ATTRIBUTION_CENTS 60
+#define OMX_HRP_BAND_Q 5
+#define OMX_HRP_COLLISION_CENTS 100
+#define OMX_HRP_DEFAULT_MAX_AUTO_BANDS 8
+#define OMX_HRP_EXCESS_THRESHOLD_DB 3
+#define OMX_HRP_GAIN_STEP_DB 2
+#define OMX_HRP_MAX_CUT_DB 6
+#define OMX_HRP_MAX_VOICES 8
 #define OMX_LPF_FREQ_RANGE_MAX 20000
 #define OMX_LPF_FREQ_RANGE_MIN 1000
 #define OMX_LPF_FREQ_RANGE_STEP 10
+#define OMX_OPERATOR_EQ_BANDS_RESERVE 9
 #define OMX_PAN_RANGE_MAX 1
 #define OMX_PAN_RANGE_MIN -1
 #define OMX_PAN_RANGE_STEP 0
@@ -322,6 +392,7 @@
 #define OMX_PHASER_FEEDBACK_RANGE_MIN_DOUBLE -0.9
 #define OMX_PHASER_FEEDBACK_RANGE_STEP 0.01f
 #define OMX_PHASER_FEEDBACK_RANGE_STEP_DOUBLE 0.01
+#define OMX_PHASER_F_TOP_HZ 16000
 #define OMX_PHASER_MIX_RANGE_DEFAULT 50
 #define OMX_PHASER_MIX_RANGE_MAX 100
 #define OMX_PHASER_MIX_RANGE_MIN 0
@@ -349,11 +420,14 @@
 #define OMX_PROGRAM_RELEASE_PROFILES_OPTO_SHARE_DOUBLE 0.5
 #define OMX_PROGRAM_RELEASE_PROFILES_OPTO_SLOW_MAX_MS 1100
 #define OMX_PROGRAM_RELEASE_PROFILES_OPTO_SLOW_MIN_MS 110
+#define OMX_PSHR_MIN_DB 10
 #define OMX_REVERB_DAMPING_RANGE_DEFAULT 0.5f
 #define OMX_REVERB_DAMPING_RANGE_DEFAULT_DOUBLE 0.5
 #define OMX_REVERB_DAMPING_RANGE_MAX 1
 #define OMX_REVERB_DAMPING_RANGE_MIN 0
 #define OMX_REVERB_DAMPING_RANGE_STEP 0
+#define OMX_REVERB_GATE_ATTACK_MS 1.5f
+#define OMX_REVERB_GATE_ATTACK_MS_DOUBLE 1.5
 #define OMX_REVERB_GATE_THRESHOLD_RANGE_DEFAULT -40
 #define OMX_REVERB_GATE_THRESHOLD_RANGE_MAX 0
 #define OMX_REVERB_GATE_THRESHOLD_RANGE_MIN -80
@@ -460,8 +534,12 @@
 #define OMX_ROTARY_RING_FLOATS 256
 #define OMX_ROTARY_STOP_EPS 0.0001f
 #define OMX_ROTARY_STOP_EPS_DOUBLE 0.0001
+#define OMX_RTA_FFT_SIZE_MAX 32768
+#define OMX_RTA_TARGET_BIN_HZ 5.9f
+#define OMX_RTA_TARGET_BIN_HZ_DOUBLE 5.9
 #define OMX_RT_HARD_TARGET_QUANTUM 128
 #define OMX_RT_HARD_TARGET_RATE 192000
+#define OMX_SUBHARMONIC_RADIUS_BINS 2
 #define OMX_TRANSIENT_FAST_ATTACK_MS 0.5f
 #define OMX_TRANSIENT_FAST_ATTACK_MS_DOUBLE 0.5
 #define OMX_TRANSIENT_FAST_RELEASE_MS 20
@@ -492,11 +570,131 @@
 #define OMX_XOVER_PARTITION_TOLERANCE_DOUBLE 0.00001
 
 /* Every list rendered to C, sorted by list: OMX_<LIST>_COUNT and OMX_<LIST>_INIT { a, b, … }. */
+#define OMX_EQ_CENTRE_SERIES_R20_HZ_COUNT 61u
+#define OMX_EQ_CENTRE_SERIES_R20_HZ_INIT { 20, 22.4f, 25, 28, 31.5f, 35.5f, 40, 45, 50, 56, 63, 71, 80, 90, 100, 112, 125, 140, 160, 180, 200, 224, 250, 280, 315, 355, 400, 450, 500, 560, 630, 710, 800, 900, 1000, 1120, 1250, 1400, 1600, 1800, 2000, 2240, 2500, 2800, 3150, 3550, 4000, 4500, 5000, 5600, 6300, 7100, 8000, 9000, 10000, 11200, 12500, 14000, 16000, 18000, 20000 }
+#define OMX_EQ_DEFAULT_CENTRES_FOUR_BAND_HZ_COUNT 4u
+#define OMX_EQ_DEFAULT_CENTRES_FOUR_BAND_HZ_INIT { 100, 400, 2000, 8000 }
+#define OMX_ISO_THIRD_OCTAVE_CENTRES_HZ_COUNT 31u
+#define OMX_ISO_THIRD_OCTAVE_CENTRES_HZ_INIT { 20, 25, 31.5f, 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 }
+#define OMX_ORACLE_FLOOR_RATES_COUNT 4u
+#define OMX_ORACLE_FLOOR_RATES_INIT { 44100, 48000, 96000, 192000 }
 #define OMX_PHASER_STAGE_COUNTS_COUNT 6u
 #define OMX_PHASER_STAGE_COUNTS_INIT { 2, 4, 6, 8, 10, 12 }
+#define OMX_RME_RATES_COUNT 9u
+#define OMX_RME_RATES_INIT { 32000, 44100, 48000, 64000, 88200, 96000, 128000, 176400, 192000 }
 #define OMX_STANDARD_SAMPLE_RATES_COUNT 6u
 #define OMX_STANDARD_SAMPLE_RATES_INIT { 44100, 48000, 88200, 96000, 176400, 192000 }
 
+/* Every set rendered to C, sorted by set: an enum of the ids (a named id's position, or a numeric id's number), `OMX_<SET>_COUNT` and,
+ * where the set names a default, `OMX_<SET>_DEFAULT`. */
+enum omx_deess_modes {
+  OMX_DEESS_MODES_SPLIT = 0,
+  OMX_DEESS_MODES_WIDEBAND = 1,
+};
+#define OMX_DEESS_MODES_COUNT 2u
+enum omx_drive_bands {
+  OMX_DRIVE_BANDS_FULL = 0,
+  OMX_DRIVE_BANDS_LOW = 1,
+  OMX_DRIVE_BANDS_HIGH = 2,
+  OMX_DRIVE_BANDS_TILT = 3,
+};
+#define OMX_DRIVE_BANDS_COUNT 4u
+enum omx_drive_curves {
+  OMX_DRIVE_CURVES_SOFT = 0,
+  OMX_DRIVE_CURVES_TAPE = 1,
+  OMX_DRIVE_CURVES_TUBE = 2,
+  OMX_DRIVE_CURVES_EXCITER = 3,
+};
+#define OMX_DRIVE_CURVES_COUNT 4u
+enum omx_eq_band_types {
+  OMX_EQ_BAND_TYPES_BELL = 0,
+  OMX_EQ_BAND_TYPES_LOW_SHELF = 1,
+  OMX_EQ_BAND_TYPES_HIGH_SHELF = 2,
+  OMX_EQ_BAND_TYPES_NOTCH = 3,
+  OMX_EQ_BAND_TYPES_ALLPASS1 = 4,
+  OMX_EQ_BAND_TYPES_ALLPASS2 = 5,
+};
+#define OMX_EQ_BAND_TYPES_COUNT 6u
+#define OMX_EQ_BAND_TYPES_DEFAULT OMX_EQ_BAND_TYPES_BELL
+enum omx_filter_slopes {
+  OMX_FILTER_SLOPES_12 = 12,
+  OMX_FILTER_SLOPES_24 = 24,
+};
+#define OMX_FILTER_SLOPES_COUNT 2u
+#define OMX_FILTER_SLOPES_DEFAULT OMX_FILTER_SLOPES_12
+enum omx_gate_key_sources {
+  OMX_GATE_KEY_SOURCES_SELF = 0,
+  OMX_GATE_KEY_SOURCES_SIDECHAIN = 1,
+};
+#define OMX_GATE_KEY_SOURCES_COUNT 2u
+enum omx_param_scales {
+  OMX_PARAM_SCALES_LINEAR = 0,
+  OMX_PARAM_SCALES_LOG = 1,
+  OMX_PARAM_SCALES_STEPPED = 2,
+};
+#define OMX_PARAM_SCALES_COUNT 3u
+#define OMX_PARAM_SCALES_DEFAULT OMX_PARAM_SCALES_LINEAR
+enum omx_reverb_algorithms {
+  OMX_REVERB_ALGORITHMS_ROOM = 0,
+  OMX_REVERB_ALGORITHMS_PLATE = 1,
+  OMX_REVERB_ALGORITHMS_HALL = 2,
+  OMX_REVERB_ALGORITHMS_REVERSE = 3,
+  OMX_REVERB_ALGORITHMS_GATED = 4,
+};
+#define OMX_REVERB_ALGORITHMS_COUNT 5u
+enum omx_rotary_speeds {
+  OMX_ROTARY_SPEEDS_STOP = 0,
+  OMX_ROTARY_SPEEDS_SLOW = 1,
+  OMX_ROTARY_SPEEDS_FAST = 2,
+};
+#define OMX_ROTARY_SPEEDS_COUNT 3u
+enum omx_tremolo_modes {
+  OMX_TREMOLO_MODES_TREMOLO = 0,
+  OMX_TREMOLO_MODES_PAN = 1,
+};
+#define OMX_TREMOLO_MODES_COUNT 2u
+#define OMX_TREMOLO_MODES_DEFAULT OMX_TREMOLO_MODES_TREMOLO
+
+/* The default bands of an EQ with `count` bands: THE one rule, for every strip, host and count (omx-contract's
+ * lib/eq-defaults.mjs; the ts render exports the same as eqDefaultCentres and eqDefaultTypes). Needs -lm. */
+static inline unsigned omx_eq_default_centres(unsigned count, float *out) {
+  static const double r10[] = OMX_ISO_THIRD_OCTAVE_CENTRES_HZ_INIT;
+  static const double r20[] = OMX_EQ_CENTRE_SERIES_R20_HZ_INIT;
+  static const double four[] = OMX_EQ_DEFAULT_CENTRES_FOUR_BAND_HZ_INIT;
+  if (count == 0) return 0;
+  if (count == 4) {
+    for (unsigned i = 0; i < 4; i++) out[i] = (float)four[i];
+    return 4;
+  }
+  const double lo = log((double)OMX_EQ_FREQ_RANGE_MIN);
+  const double span = log((double)OMX_EQ_FREQ_RANGE_MAX / (double)OMX_EQ_FREQ_RANGE_MIN);
+  for (unsigned s = 0; s < 2; s++) {
+    const double *series = s ? r20 : r10;
+    const unsigned n = s ? OMX_EQ_CENTRE_SERIES_R20_HZ_COUNT : OMX_ISO_THIRD_OCTAVE_CENTRES_HZ_COUNT;
+    int distinct = count <= n;
+    for (unsigned i = 0; distinct && i < count; i++) {
+      const double t = lo + span * ((double)i + 0.5) / (double)count;
+      unsigned best = 0;
+      double best_d = 1e300;
+      for (unsigned k = 0; k < n; k++) {
+        const double d = fabs(log(series[k]) - t);
+        if (d < best_d) { best_d = d; best = k; }
+      }
+      out[i] = (float)series[best];
+      if (i > 0 && out[i] == out[i - 1]) distinct = 0;
+    }
+    if (distinct) return count;
+  }
+  return 0;
+}
+
+/* The default type of band `index` of an EQ with `count` bands: a low shelf first, a high shelf last, bells
+ * between (a single band is a bell). An OMX_EQ_BAND_TYPES_* member. */
+static inline int omx_eq_default_type(unsigned index, unsigned count) {
+  if (count < 2) return OMX_EQ_BAND_TYPES_BELL;
+  return index == 0 ? OMX_EQ_BAND_TYPES_LOW_SHELF : index == count - 1 ? OMX_EQ_BAND_TYPES_HIGH_SHELF : OMX_EQ_BAND_TYPES_BELL;
+}
+
 #endif /* OMX_CONTRACT_LIMITS_H */
 
 /* The sample rates the console declares (core's STANDARD_SAMPLE_RATES, row-codecs.ts): the set a

package/lib/data.mjs

@@ -50,6 +50,7 @@ export function rawValue(item) {
     case 'travels': return item.fields ?? item.travel;
     case 'sheet': return item.value;
     case 'list': return item.values;
+    case 'set': return item.ids;
     default: return undefined;
   }
 }
@@ -66,6 +67,11 @@ export const DERIVATIONS = {
     if (typeof v !== 'number' || v < 0) throw new Error(`sqrt: ${JSON.stringify(d.of)} is not a non-negative number`);
     return Math.sqrt(v);
   },
+  ceilSum: (d, val) => {
+    const terms = d.of.map((x) => val(x));
+    if (!terms.every((t) => typeof t === 'number' && Number.isFinite(t))) throw new Error(`ceilSum: ${JSON.stringify(d.of)} holds a term that is not a finite number`);
+    return Math.ceil(terms.reduce((a, t) => a + t, 0));
+  },
   lagrangeReadL1: (d, val) => {
     const order = val(d.order);
     if (!Number.isInteger(order) || order < 1) throw new Error(`lagrangeReadL1: order ${order} is not a positive integer`);
@@ -104,7 +110,7 @@ export function lagrangeReadL1(order) {
 const isObj = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
 
 /**
- * Resolve every item: `{ name, rel, kind, doc, why?, unit?, c?, shape?, value }`, where `value` has
+ * 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.
  * @throws naming the item: a reference that does not resolve, a cycle, an unknown derivation.
  */
@@ -142,6 +148,10 @@ export function resolveData(data) {
     if (item.why !== undefined) r.why = item.why;
     if (item.unit !== undefined) r.unit = item.unit;
     if (item.c !== undefined) r.c = item.c;
+    if (item.kind === 'set') {
+      if (item.default !== undefined) r.default = item.default;
+      if (item.labels !== undefined) r.labels = item.labels;
+    }
     if (item.kind === 'travels') r.shape = item.fields ? 'table' : 'travel';
     r.value = val(rawValue(item), name);
     busy.delete(name);

package/lib/eq-defaults.mjs

@@ -0,0 +1,87 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+/**
+ * THE default rule for the bands of a fresh EQ, whatever the strip, the host or the band count: one
+ * rule, no override, for the console, omx-plugins and any other host. Per strip type the contract
+ * declares only the band counts (EQ_BAND_COUNTS: default and maximum); the bands come from here.
+ *
+ * Types   the first band is a low shelf and the last a high shelf (each switchable to a bell by the
+ *         operator); every band between is a bell. A single band is a bell.
+ * Gain, Q every band is EQ_BAND_DEFAULTS.gainDb and .q.
+ * Centres
+ *   4 bands   the declared four (EQ_DEFAULT_CENTRES_FOUR_BAND_HZ): 100, 400, 2000, 8000 Hz,
+ *             ISO 266 preferred values.
+ *   N bands   N slots of equal width on a log axis across EQ_FREQ_RANGE; band i sits in the
+ *             middle of slot i (lo * (hi / lo) ** ((i + 0.5) / N)) and takes the nearest preferred
+ *             frequency on that axis, from the ISO 266 R10 series (ISO_THIRD_OCTAVE_CENTRES_HZ);
+ *             when two bands would share a value in R10 the same is done on its R20 refinement
+ *             (EQ_CENTRE_SERIES_R20_HZ). Never a repeated centre: more bands than R20 holds is an
+ *             error.
+ *
+ * The same functions are exported by the ts render (`eqDefaultCentres`, `eqDefaultTypes`,
+ * `eqDefaultBands`) and the c render (`omx_eq_default_centres`, `omx_eq_default_type`); test/eq-defaults.test.mjs holds the three equal for every count.
+ * This file is the one JavaScript spelling: the ts render embeds its source.
+ */
+
+/**
+ * The default band centres (Hz) of an EQ with `count` bands.
+ * @param {number} count how many bands the strip's EQ starts with, a positive integer.
+ * @param {{ four: number[], series: number[][], lo: number, hi: number }} p the declared four-band
+ *   set, the preferred-frequency series from coarsest to finest, and the band frequency travel.
+ * @returns {number[]}
+ */
+export function eqDefaultCentres(count, p) {
+  if (!Number.isInteger(count) || count < 1) throw new RangeError(`eqDefaultCentres: ${count} is not a band count`);
+  if (count === 4) return [...p.four];
+  const targets = [];
+  for (let i = 0; i < count; i++) targets.push(Math.log(p.lo) + (Math.log(p.hi / p.lo) * (i + 0.5)) / count);
+  for (const series of p.series) {
+    const out = targets.map((t) => {
+      let best = series[0];
+      let bestD = Infinity;
+      for (const f of series) {
+        const d = Math.abs(Math.log(f) - t);
+        if (d < bestD) { bestD = d; best = f; }
+      }
+      return best;
+    });
+    if (new Set(out).size === out.length) return out;
+  }
+  throw new RangeError(`eqDefaultCentres: ${count} bands have no distinct preferred centres across ${p.lo}..${p.hi} Hz`);
+}
+
+/**
+ * The band types of an EQ with `count` bands, by EQ_BAND_TYPES id: a low shelf, bells, a high shelf.
+ * @param {number} count
+ * @returns {string[]}
+ */
+export function eqDefaultTypes(count) {
+  if (!Number.isInteger(count) || count < 1) throw new RangeError(`eqDefaultTypes: ${count} is not a band count`);
+  return Array.from({ length: count }, (_, i) => (count === 1 ? 'bell' : i === 0 ? 'lowShelf' : i === count - 1 ? 'highShelf' : 'bell'));
+}
+
+/**
+ * Every default band of an EQ with `count` bands.
+ * @param {number} count
+ * @param {{ four: number[], series: number[][], lo: number, hi: number, gainDb: number, q: number }} p
+ * @returns {{ type: string, freqHz: number, gainDb: number, q: number }[]}
+ */
+export function eqDefaultBands(count, p) {
+  const types = eqDefaultTypes(count);
+  return eqDefaultCentres(count, p).map((freqHz, i) => ({ type: types[i], freqHz, gainDb: p.gainDb, q: p.q }));
+}
+
+/** The parameters of the rule, read off the resolved items. */
+export function eqDefaultParams(resolved) {
+  const v = (name) => {
+    const r = resolved.get(name);
+    if (!r) throw new Error(`the default centre rule needs ${name}`);
+    return r.value;
+  };
+  const range = v('EQ_FREQ_RANGE');
+  const band = v('EQ_BAND_DEFAULTS');
+  return {
+    four: v('EQ_DEFAULT_CENTRES_FOUR_BAND_HZ'), series: [v('ISO_THIRD_OCTAVE_CENTRES_HZ'), v('EQ_CENTRE_SERIES_R20_HZ')],
+    lo: range.min, hi: range.max, gainDb: band.gainDb, q: band.q,
+  };
+}

package/lib/fmt.mjs

@@ -7,8 +7,8 @@
  */
 
 const ORDER = {
-  item: ['kind', 'doc', 'why', 'unit', 'value', 'values', 'fields', 'travel', 'c'],
-  travel: ['min', 'max', 'step', 'unit', 'default', 'defaultFrom', 'byKind', 'doc', 'why'],
+  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'],
   c: ['alias', 'render'],
   alias: ['fact', 'field'],
   number: ['ref', 'derive', 'of', 'order'],

package/lib/semver.mjs

@@ -7,8 +7,8 @@
  *   major  a field or alias removed; an item removed (MINOR in the development phase, below); a
  *          unit or kind changed; a travel narrowed; a constant a kernel computes with changed (a
  *          scalar, sheet leaf or derived value that is not a travel bound or default; a list member
- *          changed or removed)
- *   minor  an item, field, sheet leaf or list member added (appended); a travel widened;
+ *          or set id changed or removed; a set's default added, removed)
+ *   minor  an item, field, sheet leaf, list member or set id added (appended); a travel widened;
  *          a default moved inside its travel; a step changed
  *   patch  doc and why text
  */
@@ -32,6 +32,7 @@ function travelChanges(at, a, b, say) {
   if (a.default !== b.default) say(a.default === undefined || b.default === undefined ? 'major' : 'minor', `${at}: default ${a.default} -> ${b.default}`);
   if (a.step !== b.step) say('minor', `${at}: step ${a.step} -> ${b.step}`);
   if (a.defaultFrom !== b.defaultFrom) say('minor', `${at}: defaultFrom ${a.defaultFrom} -> ${b.defaultFrom}`);
+  if (a.scale !== b.scale) say('minor', `${at}: scale ${a.scale} -> ${b.scale}`);
   const ka = a.byKind ?? {};
   const kb = b.byKind ?? {};
   for (const k of Object.keys(ka)) if (!(k in kb)) say('major', `${at}.byKind.${k} removed`);
@@ -92,6 +93,15 @@ export function classify(prev, next, { developmentPhase = DEVELOPMENT_PHASE } =
         });
         if (b.value.length > a.value.length) say('minor', `${name}: ${b.value.length - a.value.length} member(s) appended`);
         break;
+      case 'set':
+        a.value.forEach((v, i) => {
+          if (i >= b.value.length) say('major', `${name}[${i}] removed`);
+          else if (b.value[i] !== v) say('major', `${name}[${i}]: ${v} -> ${b.value[i]}`);
+        });
+        if (b.value.length > a.value.length) say('minor', `${name}: ${b.value.length - a.value.length} id(s) appended`);
+        if (a.default !== b.default) say(a.default === undefined || b.default === undefined ? 'major' : 'minor', `${name}: default ${a.default} -> ${b.default}`);
+        if (!same(a.labels, b.labels)) say('patch', `${name}: labels`);
+        break;
       default:
         break;
     }

package/lib/validate.mjs

@@ -9,6 +9,7 @@ import { readFileSync } from 'node:fs';
 import { posix } from 'node:path';
 import Ajv2020 from 'ajv/dist/2020.js';
 import { resolveData } from './data.mjs';
+import { eqDefaultBands, eqDefaultParams } from './eq-defaults.mjs';
 import { renderC } from '../render/c.mjs';
 import { renderTs } from '../render/ts.mjs';
 
@@ -22,6 +23,62 @@ export function schemaValidator() {
 
 const constCase = (s) => s.replace(/([a-z0-9])([A-Z])/g, '$1_$2').toUpperCase();
 
+/**
+ * The rules about the meaning of the numbers, not their shape (they live with the data they judge):
+ * a set's default and labels; a travel's scale is a PARAM_SCALES id; the EQ band counts and budget; the
+ * default EQ rule's inputs.
+ */
+function semanticRules(resolved, say) {
+  const val = (name) => resolved.get(name)?.value;
+  for (const r of resolved.values()) {
+    if (r.kind === 'set') {
+      if (r.default !== undefined && !r.value.includes(r.default)) say(r.rel, r.name, 'set-default', `default ${JSON.stringify(r.default)} is not one of ${JSON.stringify(r.value)}`);
+      if (r.labels !== undefined && r.labels.length !== r.value.length) say(r.rel, r.name, 'set-labels', `${r.labels.length} labels for ${r.value.length} ids`);
+    }
+    const travels = r.kind === 'travels' ? (r.shape === 'table' ? Object.entries(r.value) : [['', r.value]]) : [];
+    for (const [field, t] of travels) {
+      if (t.scale !== undefined && !(val('PARAM_SCALES') ?? []).includes(t.scale)) say(r.rel, r.name, 'scale', `${field ? `${r.name}.${field}` : r.name}: scale ${JSON.stringify(t.scale)} is not an id of PARAM_SCALES`);
+    }
+  }
+
+  // The EQ band budget (ruling 2026-10-08): what the operator keeps, what the feedback suppressor plants
+  // and what the ring correction plants all fit in the band maximum.
+  const reserve = val('OPERATOR_EQ_BANDS_RESERVE');
+  if (reserve !== undefined) {
+    const need = reserve + val('FBS_DEFAULT_MAX_AUTO_BANDS') + val('HRP_DEFAULT_MAX_AUTO_BANDS');
+    const cap = val('EQ_MAX_BANDS');
+    if (!(need <= cap)) say(resolved.get('OPERATOR_EQ_BANDS_RESERVE').rel, 'OPERATOR_EQ_BANDS_RESERVE', 'eq-band-budget',
+      `OPERATOR_EQ_BANDS_RESERVE ${reserve} + FBS_DEFAULT_MAX_AUTO_BANDS ${val('FBS_DEFAULT_MAX_AUTO_BANDS')} + HRP_DEFAULT_MAX_AUTO_BANDS ${val('HRP_DEFAULT_MAX_AUTO_BANDS')} = ${need} exceeds EQ_MAX_BANDS ${cap}`);
+  }
+  const counts = val('EQ_BAND_COUNTS');
+  if (counts) {
+    const rel = resolved.get('EQ_BAND_COUNTS').rel;
+    for (const [strip, c] of Object.entries(counts)) {
+      for (const k of ['default', 'max']) if (!Number.isInteger(c[k]) || c[k] < 1) say(rel, 'EQ_BAND_COUNTS', 'eq-band-counts', `${strip}.${k} ${c[k]} is not a positive integer`);
+      if (c.default > c.max) say(rel, 'EQ_BAND_COUNTS', 'eq-band-counts', `${strip}: default ${c.default} exceeds max ${c.max}`);
+    }
+  }
+
+  // The default EQ rule: its inputs are consistent and it answers for every declared default count.
+  if (resolved.has('EQ_DEFAULT_CENTRES_FOUR_BAND_HZ')) {
+    const rel = resolved.get('EQ_DEFAULT_CENTRES_FOUR_BAND_HZ').rel;
+    const bad = (rule, message) => say(rel, 'EQ_DEFAULT_CENTRES_FOUR_BAND_HZ', rule, message);
+    let p;
+    try { p = eqDefaultParams(resolved); } catch (e) { bad('eq-default-rule', e.message); return; }
+    const [r10, r20] = p.series;
+    if (p.four.length !== 4) bad('eq-default-rule', `the four-band set holds ${p.four.length} centres`);
+    for (const [name, list] of [['four-band set', p.four], ['R10', r10], ['R20', r20]]) {
+      if (!list.every((f, i) => f >= p.lo && f <= p.hi && (i === 0 || f > list[i - 1]))) bad('eq-default-rule', `the ${name} is not ascending inside [${p.lo}, ${p.hi}] Hz`);
+    }
+    for (const f of [...p.four, ...r10]) if (!r20.includes(f)) bad('eq-default-rule', `${f} Hz is not in the R20 series: R10 and the four-band set are preferred values of it`);
+    const types = val('EQ_BAND_TYPES') ?? [];
+    for (const id of ['bell', 'lowShelf', 'highShelf']) if (!types.includes(id)) bad('eq-default-rule', `EQ_BAND_TYPES lacks ${id}, which the default rule uses`);
+    for (const [strip, c] of Object.entries(counts ?? {})) {
+      try { eqDefaultBands(c.default, p); } catch (e) { bad('eq-default-rule', `${strip}: ${e.message}`); }
+    }
+  }
+}
+
 /** Every problem of the loaded data: `[{ file, item, rule, message }]`; empty is valid. */
 export function validateData(data) {
   const problems = [];
@@ -71,6 +128,8 @@ export function validateData(data) {
     if (typeof r.doc !== 'string' || !r.doc.trim()) say(r.rel, r.name, 'doc', 'every item carries its doc');
   }
 
+  semanticRules(resolved, say);
+
   for (const [target, files] of [['c', () => renderC(resolved)], ['ts', () => renderTs(resolved)]]) {
     let out;
     try {
@@ -82,7 +141,7 @@ export function validateData(data) {
     if (target !== 'c') continue;
     for (const f of out) {
       const seen = new Map();
-      for (const m of f.text.matchAll(/^#define (\w+)/gm)) {
+      for (const m of f.text.matchAll(/^(?:#define |  )(OMX_\w+)(?= = |\s)/gm)) {
         if (seen.has(m[1])) say('-', m[1], 'c-name-unique', `${f.path} defines ${m[1]} twice`);
         seen.set(m[1], true);
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openmixer/omx-contract",
-  "version": "1.2.1",
+  "version": "1.3.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",