@openmixer/omx-contract 2.9.0 → 2.10.1

package/README.md

@@ -49,7 +49,7 @@ pkg-config --cflags omx-contract
 ```
 
 Pin one version and build against its renders instead of keeping a copy: the installed package at exactly
-that version (`pkg-config --exact-version=2.9.0 omx-contract`), else the npm tarball, unpacked, and
+that version (`pkg-config --exact-version=2.10.1 omx-contract`), else the npm tarball, unpacked, and
 `omx-contract render --target c --out build/omx-contract/include`. A kernel's controls and readouts, in their
 order, are in `share/omx-contract/omx-contract.json`; how a declaration is written is in
 [docs/kernel-files.md](docs/kernel-files.md), and what a readout is in [docs/readouts.md](docs/readouts.md).

package/data/kernels/comp.json

@@ -110,11 +110,11 @@
       "name": "detectorOversampling",
       "kind": "choice",
       "global": "DETECTOR_OVERSAMPLINGS",
-      "doc": "The compressor's detector oversampling: `auto` runs the control path at 4x only while the attack is faster than DETECTOR_OVERSAMPLE_AUTO_MS, `off` never, `x4` always (omx-dsp's OMX_DYN_OVS_AUTO, _OFF and _X4, in that order). The console's comp row carries it as the operator's choice (`CompState.detectorOversampling`, spelled auto, off, 4x) and comes up `auto`.",
+      "doc": "The compressor's detector oversampling: `auto` runs the control path at 4x only while the attack is faster than DETECTOR_OVERSAMPLE_AUTO_MS, `off` never, `4x` always (omx-dsp's OMX_DYN_OVS_AUTO, _OFF and _X4, in that order, so the index mapping holds). The ids are the console's wire vocabulary (`CompState.detectorOversampling`, what the dynamics row's OPTIONS publishes and a session stores), so the console re-exports this set; it comes up `auto`.",
       "ids": [
         "auto",
         "off",
-        "x4"
+        "4x"
       ],
       "default": "auto",
       "labels": [

package/dist/ts/omx-contract.d.ts

@@ -249,10 +249,10 @@ export declare const COMP_LIMITS: {
 export declare const COMP_KINDS: readonly ["comp", "limiter"];
 
 /**
- * The compressor's detector oversampling: `auto` runs the control path at 4x only while the attack is faster than DETECTOR_OVERSAMPLE_AUTO_MS, `off` never, `x4` always (omx-dsp's OMX_DYN_OVS_AUTO, _OFF and _X4, in that order). The console's comp row carries it as the operator's choice (`CompState.detectorOversampling`, spelled auto, off, 4x) and comes up `auto`.
+ * The compressor's detector oversampling: `auto` runs the control path at 4x only while the attack is faster than DETECTOR_OVERSAMPLE_AUTO_MS, `off` never, `4x` always (omx-dsp's OMX_DYN_OVS_AUTO, _OFF and _X4, in that order, so the index mapping holds). The ids are the console's wire vocabulary (`CompState.detectorOversampling`, what the dynamics row's OPTIONS publishes and a session stores), so the console re-exports this set; it comes up `auto`.
  * @see data/kernels/comp.json
  */
-export declare const DETECTOR_OVERSAMPLINGS: readonly ["auto", "off", "x4"];
+export declare const DETECTOR_OVERSAMPLINGS: readonly ["auto", "off", "4x"];
 
 /**
  * Where the compressor's detector listens: `feedforward` hears the slot's input (or its key), `feedback` hears the slot's own pre-make-up output DYN_FB_LOOP_DELAY_SAMPLES late, through one envelope stage, and a keyed slot stays feed-forward (omx-dsp's OMX_DYN_TOPOLOGY_FEEDFORWARD 0 and _FEEDBACK 1, in that order; the set is named for its control, so C spells them OMX_DETECTOR_TOPOLOGY_*). The console's comp row carries it (`detectorTopology`, the SSL bus compressor design §3a) and comes up `feedforward`, so a zeroed atom is the compressor every slot runs.

package/dist/ts/omx-contract.js

@@ -255,13 +255,13 @@ export const COMP_KINDS = [
 ];
 
 /**
- * The compressor's detector oversampling: `auto` runs the control path at 4x only while the attack is faster than DETECTOR_OVERSAMPLE_AUTO_MS, `off` never, `x4` always (omx-dsp's OMX_DYN_OVS_AUTO, _OFF and _X4, in that order). The console's comp row carries it as the operator's choice (`CompState.detectorOversampling`, spelled auto, off, 4x) and comes up `auto`.
+ * The compressor's detector oversampling: `auto` runs the control path at 4x only while the attack is faster than DETECTOR_OVERSAMPLE_AUTO_MS, `off` never, `4x` always (omx-dsp's OMX_DYN_OVS_AUTO, _OFF and _X4, in that order, so the index mapping holds). The ids are the console's wire vocabulary (`CompState.detectorOversampling`, what the dynamics row's OPTIONS publishes and a session stores), so the console re-exports this set; it comes up `auto`.
  * @see data/kernels/comp.json
  */
 export const DETECTOR_OVERSAMPLINGS = [
   "auto",
   "off",
-  "x4"
+  "4x"
 ];
 
 /**

package/include/omxcontract/omx_contract_limits.h

@@ -659,7 +659,7 @@ enum omx_delay_pingpongs {
 enum omx_detector_oversamplings {
   OMX_DETECTOR_OVERSAMPLINGS_AUTO = 0,
   OMX_DETECTOR_OVERSAMPLINGS_OFF = 1,
-  OMX_DETECTOR_OVERSAMPLINGS_X4 = 2,
+  OMX_DETECTOR_OVERSAMPLINGS_4X = 2,
 };
 #define OMX_DETECTOR_OVERSAMPLINGS_COUNT 3u
 #define OMX_DETECTOR_OVERSAMPLINGS_DEFAULT OMX_DETECTOR_OVERSAMPLINGS_AUTO

package/lib/semver.mjs

@@ -23,7 +23,7 @@ const RANK = { none: 0, patch: 1, minor: 2, major: 3 };
  * The development-phase rule (omx-contract spec §3.6): while every consumer of
  * omx-contract is a FreeMixer repository named here, removing an item is MINOR. The rule ends, and
  * this becomes null so a removal is MAJOR again, in the release that names the first consumer
- * outside the list.
+ * outside the list. Until then a MAJOR class is released as a minor bump (see refusal).
  */
 export const DEVELOPMENT_PHASE = Object.freeze({ consumers: Object.freeze(['omx-dsp', 'omx-plugins', 'openmixer']) });
 const same = (a, b) => JSON.stringify(a) === JSON.stringify(b);
@@ -155,9 +155,16 @@ export function bumpOf(from, to) {
   return 'none';
 }
 
-/** null when bumping `from` -> `to` covers `level`, else the refusal. */
-export function refusal(level, from, to) {
+/**
+ * null when bumping `from` -> `to` covers `level`, else the refusal. In the development phase no
+ * release takes a major bump (operator ruling 2026-10-13: majors wait for the first public
+ * release), so a MAJOR class is covered by a minor bump; the classes are still reported as found.
+ */
+export function refusal(level, from, to, { developmentPhase = DEVELOPMENT_PHASE } = {}) {
   let bump;
   try { bump = bumpOf(from, to); } catch (e) { return e.message; }
-  return RANK[bump] >= RANK[level] ? null : `the changes since ${from} are ${level.toUpperCase()}, and ${from} -> ${to} is a ${bump} bump`;
+  const need = developmentPhase && level === 'major' ? 'minor' : level;
+  if (RANK[bump] >= RANK[need]) return null;
+  const phase = need === level ? '' : ' (at least a minor in the development phase)';
+  return `the changes since ${from} are ${level.toUpperCase()}, and ${from} -> ${to} is a ${bump} bump${phase}`;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openmixer/omx-contract",
-  "version": "2.9.0",
+  "version": "2.10.1",
   "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/schema/omx-contract.schema.json

@@ -181,7 +181,7 @@
     },
     "set": {
       "type": "object",
-      "description": "Ordered ids with an optional default and labels. The ids and their order are the contract: all strings (the id is the name, its position the value) or all non-negative integers (the id is the value). Labels are face text and optional. The default may be a reference to the scalar that states it: a boolean names the second id of a two-id switch when true, the first when false.",
+      "description": "Ordered ids with an optional default and labels. The ids and their order are the contract: all strings of letters and digits (the id is the name, its position the value; an id may start with a digit, as 4x does) or all non-negative integers (the id is the value). Labels are face text and optional. The default may be a reference to the scalar that states it: a boolean names the second id of a two-id switch when true, the first when false.",
       "properties": {
         "kind": { "const": "set" },
         "since": { "$ref": "#/$defs/since" },
@@ -189,11 +189,11 @@
         "why": { "$ref": "#/$defs/text" },
         "ids": {
           "oneOf": [
-            { "type": "array", "items": { "type": "string", "pattern": "^[A-Za-z][A-Za-z0-9]*$" }, "minItems": 1, "uniqueItems": true },
+            { "type": "array", "items": { "type": "string", "pattern": "^[A-Za-z0-9]+$" }, "minItems": 1, "uniqueItems": true },
             { "type": "array", "items": { "type": "integer", "minimum": 0 }, "minItems": 1, "uniqueItems": true }
           ]
         },
-        "default": { "oneOf": [{ "type": "string", "pattern": "^[A-Za-z][A-Za-z0-9]*$" }, { "type": "integer", "minimum": 0 }, { "$ref": "#/$defs/ref" }] },
+        "default": { "oneOf": [{ "type": "string", "pattern": "^[A-Za-z0-9]+$" }, { "type": "integer", "minimum": 0 }, { "$ref": "#/$defs/ref" }] },
         "labels": { "type": "array", "items": { "$ref": "#/$defs/text" }, "minItems": 1 }
       },
       "required": ["kind", "doc", "ids"],

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

@@ -1,6 +1,6 @@
 {
   "name": "@openmixer/omx-contract",
-  "version": "2.9.0",
+  "version": "2.10.1",
   "items": {
     "PAN_RANGE": {
       "rel": "data/kernels/balance.json",
@@ -286,7 +286,7 @@
     "DETECTOR_OVERSAMPLINGS": {
       "rel": "data/kernels/comp.json",
       "kind": "set",
-      "doc": "The compressor's detector oversampling: `auto` runs the control path at 4x only while the attack is faster than DETECTOR_OVERSAMPLE_AUTO_MS, `off` never, `x4` always (omx-dsp's OMX_DYN_OVS_AUTO, _OFF and _X4, in that order). The console's comp row carries it as the operator's choice (`CompState.detectorOversampling`, spelled auto, off, 4x) and comes up `auto`.",
+      "doc": "The compressor's detector oversampling: `auto` runs the control path at 4x only while the attack is faster than DETECTOR_OVERSAMPLE_AUTO_MS, `off` never, `4x` always (omx-dsp's OMX_DYN_OVS_AUTO, _OFF and _X4, in that order, so the index mapping holds). The ids are the console's wire vocabulary (`CompState.detectorOversampling`, what the dynamics row's OPTIONS publishes and a session stores), so the console re-exports this set; it comes up `auto`.",
       "default": "auto",
       "labels": [
         "Auto",
@@ -296,7 +296,7 @@
       "value": [
         "auto",
         "off",
-        "x4"
+        "4x"
       ]
     },
     "DETECTOR_TOPOLOGY": {