@openmixer/omx-dsp 0.0.0-stage → 0.25.0

package/dist/definitions.d.ts

@@ -0,0 +1,4 @@
+/** The RTA's target bin resolution — generated into `omx_contract_limits.h` as `OMX_RTA_TARGET_BIN_HZ`, which `mix_dsp.h` reads; the engine's conformance test reads it back from the header. (Hz) @see data/kernels/rta.json */
+export declare const RTA_TARGET_BIN_HZ = 5.9;
+/** The largest RTA FFT the native ring holds — generated into `omx_contract_limits.h` as `OMX_RTA_FFT_SIZE_MAX`. @see data/kernels/rta.json */
+export declare const RTA_FFT_SIZE_MAX = 32768;

package/dist/definitions.js

@@ -0,0 +1,7 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+// GENERATED by ts/tools/definitions.mjs from omx-dsp data/kernels/ - do not edit.
+/** The RTA's target bin resolution — generated into `omx_contract_limits.h` as `OMX_RTA_TARGET_BIN_HZ`, which `mix_dsp.h` reads; the engine's conformance test reads it back from the header. (Hz) @see data/kernels/rta.json */
+export const RTA_TARGET_BIN_HZ = 5.9;
+/** The largest RTA FFT the native ring holds — generated into `omx_contract_limits.h` as `OMX_RTA_FFT_SIZE_MAX`. @see data/kernels/rta.json */
+export const RTA_FFT_SIZE_MAX = 32768;

package/dist/eq.d.ts

@@ -0,0 +1,3 @@
+/** The twin of omx_eq_design.h omx_eq_octaves_q, moved verbatim from the console (its catalog package). */
+/** Bandwidth in octaves → Q (the cookbook relation). */
+export declare function octavesToQ(octaves: number): number;

package/dist/eq.js

@@ -0,0 +1,9 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+/** The twin of omx_eq_design.h omx_eq_octaves_q, moved verbatim from the console (its catalog package). */
+/** Bandwidth in octaves → Q (the cookbook relation). */
+export function octavesToQ(octaves) {
+    const bw = Math.max(octaves, 0.05);
+    const t = Math.pow(2, bw);
+    return Math.sqrt(t) / (t - 1);
+}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @openmixer/omx-dsp: the TypeScript twins of omx-dsp kernels, the ones that stay in TypeScript because doing
+ * the work in C would be silly (a display, a unit conversion a browser runs). Each is pinned to its kernel by an
+ * agreement test in test/ that feeds both the same grid.
+ */
+export { ANALYSIS_FLOOR_DB, dbToLinearGain, linearGainToDb, linearToDbFloored } from './units.js';
+export { octavesToQ } from './eq.js';
+export { fftSizeForRate } from './rta.js';

package/dist/index.js

@@ -0,0 +1,10 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+/**
+ * @openmixer/omx-dsp: the TypeScript twins of omx-dsp kernels, the ones that stay in TypeScript because doing
+ * the work in C would be silly (a display, a unit conversion a browser runs). Each is pinned to its kernel by an
+ * agreement test in test/ that feeds both the same grid.
+ */
+export { ANALYSIS_FLOOR_DB, dbToLinearGain, linearGainToDb, linearToDbFloored } from './units.js';
+export { octavesToQ } from './eq.js';
+export { fftSizeForRate } from './rta.js';

package/dist/rta.d.ts

@@ -0,0 +1,11 @@
+/** The twin of omx_rta.h omx_rta_fft_size_for, moved verbatim from the console (its spectrum bands); the two limits are omx-dsp's own (data/kernels/rta.json). */
+/**
+ * The RTA FFT length for `rate` — the TypeScript mirror of `mix_dsp.h`'s `omx_rta_fft_size_for`:
+ * the smallest power of two whose bins are at or under {@link RTA_TARGET_BIN_HZ} (44.1/48 kHz →
+ * 8192, 88.2/96 kHz → 16384, 176.4/192 kHz → 32768). Window TIME stays ~171 ms at every rate —
+ * pinning the length instead of deriving it was how moving the rig to 96 kHz silently halved the
+ * resolution (2026-09-17 declare-derive audit, F2). Every consumer of an offline/synth or a
+ * server RTA frame derives its window from the graph rate through this function rather than
+ * declaring one of its own.
+ */
+export declare function fftSizeForRate(rate: number): number;

package/dist/rta.js

@@ -0,0 +1,19 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+/** The twin of omx_rta.h omx_rta_fft_size_for, moved verbatim from the console (its spectrum bands); the two limits are omx-dsp's own (data/kernels/rta.json). */
+import { RTA_TARGET_BIN_HZ, RTA_FFT_SIZE_MAX } from './definitions.js';
+/**
+ * The RTA FFT length for `rate` — the TypeScript mirror of `mix_dsp.h`'s `omx_rta_fft_size_for`:
+ * the smallest power of two whose bins are at or under {@link RTA_TARGET_BIN_HZ} (44.1/48 kHz →
+ * 8192, 88.2/96 kHz → 16384, 176.4/192 kHz → 32768). Window TIME stays ~171 ms at every rate —
+ * pinning the length instead of deriving it was how moving the rig to 96 kHz silently halved the
+ * resolution (2026-09-17 declare-derive audit, F2). Every consumer of an offline/synth or a
+ * server RTA frame derives its window from the graph rate through this function rather than
+ * declaring one of its own.
+ */
+export function fftSizeForRate(rate) {
+    let n = 2048;
+    while (n < RTA_FFT_SIZE_MAX && rate / n > RTA_TARGET_BIN_HZ)
+        n *= 2;
+    return n;
+}

package/dist/units.d.ts

@@ -0,0 +1,33 @@
+/** The dB and linear-amplitude twins of omx_units.h (omx_db_to_lin, omx_lin_to_db, omx_lin_to_db_d), moved verbatim from the console (its output routes). */
+/**
+ * dB → linear amplitude (0 dB → 1, −6 dB → ~0.501). The trim/fold gain the engine applies.
+ *
+ * `-Infinity` dB → 0 falls out of the exponential itself (`10 ** -Infinity === 0`), so
+ * callers need no silence guard of their own.
+ */
+export declare function dbToLinearGain(db: number): number;
+/**
+ * Linear amplitude → dB — the exact inverse of {@link dbToLinearGain}, and the reason this
+ * one exists: without it the inverse direction was hand-rolled at every call site, which is
+ * how three different silence conventions (`1e-12`, `1e-7`, `-60`) grew up elsewhere in the
+ * tree for what is nominally the same conversion.
+ *
+ * Silence and any non-positive amplitude read `-Infinity`, not NaN: `Math.log10` of a
+ * negative is NaN, and an amplitude below zero is a phase-inverted sample's magnitude
+ * mistake, not a level. Note this is the LEVEL conversion — an analyser floors its own
+ * spectrum at a chosen epsilon instead, deliberately, and should keep doing so.
+ */
+export declare function linearGainToDb(linear: number): number;
+/**
+ * The analysers' magnitude floor: an FFT bin or an envelope at exact zero reads −240 dB, below
+ * any real signal and finite for the growth and ratio arithmetic built on it (was the epsilon
+ * `1e-12` inside three analysers' logarithms).
+ */
+export declare const ANALYSIS_FLOOR_DB = -240;
+/**
+ * Linear amplitude → dB, never below `floorDb` — the conversion for a site whose floor is
+ * deliberate (an analyser's magnitude, a plot's axis, a meter that must stay finite). The floor
+ * is a named dB value, never an epsilon hidden inside the logarithm (`Math.max(x, 1e-12)` is
+ * `linearToDbFloored(x, -240)`); silence reads `floorDb`, not `-Infinity`.
+ */
+export declare function linearToDbFloored(linear: number, floorDb: number): number;

package/dist/units.js

@@ -0,0 +1,41 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+/** The dB and linear-amplitude twins of omx_units.h (omx_db_to_lin, omx_lin_to_db, omx_lin_to_db_d), moved verbatim from the console (its output routes). */
+/**
+ * dB → linear amplitude (0 dB → 1, −6 dB → ~0.501). The trim/fold gain the engine applies.
+ *
+ * `-Infinity` dB → 0 falls out of the exponential itself (`10 ** -Infinity === 0`), so
+ * callers need no silence guard of their own.
+ */
+export function dbToLinearGain(db) {
+    return 10 ** (db / 20);
+}
+/**
+ * Linear amplitude → dB — the exact inverse of {@link dbToLinearGain}, and the reason this
+ * one exists: without it the inverse direction was hand-rolled at every call site, which is
+ * how three different silence conventions (`1e-12`, `1e-7`, `-60`) grew up elsewhere in the
+ * tree for what is nominally the same conversion.
+ *
+ * Silence and any non-positive amplitude read `-Infinity`, not NaN: `Math.log10` of a
+ * negative is NaN, and an amplitude below zero is a phase-inverted sample's magnitude
+ * mistake, not a level. Note this is the LEVEL conversion — an analyser floors its own
+ * spectrum at a chosen epsilon instead, deliberately, and should keep doing so.
+ */
+export function linearGainToDb(linear) {
+    return linear <= 0 ? -Infinity : 20 * Math.log10(linear);
+}
+/**
+ * The analysers' magnitude floor: an FFT bin or an envelope at exact zero reads −240 dB, below
+ * any real signal and finite for the growth and ratio arithmetic built on it (was the epsilon
+ * `1e-12` inside three analysers' logarithms).
+ */
+export const ANALYSIS_FLOOR_DB = -240;
+/**
+ * Linear amplitude → dB, never below `floorDb` — the conversion for a site whose floor is
+ * deliberate (an analyser's magnitude, a plot's axis, a meter that must stay finite). The floor
+ * is a named dB value, never an epsilon hidden inside the logarithm (`Math.max(x, 1e-12)` is
+ * `linearToDbFloored(x, -240)`); silence reads `floorDb`, not `-Infinity`.
+ */
+export function linearToDbFloored(linear, floorDb) {
+    return Math.max(floorDb, linearGainToDb(linear));
+}

package/package.json

@@ -1,6 +1,40 @@
 {
   "name": "@openmixer/omx-dsp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.25.0",
+  "description": "The TypeScript twins of omx-dsp kernels, each pinned to its C kernel by an agreement test",
+  "type": "module",
+  "license": "GPL-3.0-or-later",
+  "author": "Pau Aliagas <linuxnow@gmail.com>",
+  "homepage": "https://github.com/FreeMixer/omx-dsp",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/FreeMixer/omx-dsp.git",
+    "directory": "ts"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/",
+    "src/"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "node tools/definitions.mjs --check && tsc -p tsconfig.json && node --test test/*.test.mjs",
+    "prepack": "tsc -p tsconfig.json"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=22.18"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}

package/src/definitions.ts

@@ -0,0 +1,9 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+// GENERATED by ts/tools/definitions.mjs from omx-dsp data/kernels/ - do not edit.
+
+/** The RTA's target bin resolution — generated into `omx_contract_limits.h` as `OMX_RTA_TARGET_BIN_HZ`, which `mix_dsp.h` reads; the engine's conformance test reads it back from the header. (Hz) @see data/kernels/rta.json */
+export const RTA_TARGET_BIN_HZ = 5.9;
+
+/** The largest RTA FFT the native ring holds — generated into `omx_contract_limits.h` as `OMX_RTA_FFT_SIZE_MAX`. @see data/kernels/rta.json */
+export const RTA_FFT_SIZE_MAX = 32768;

package/src/eq.ts

@@ -0,0 +1,10 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+/** The twin of omx_eq_design.h omx_eq_octaves_q, moved verbatim from the console (its catalog package). */
+
+/** Bandwidth in octaves → Q (the cookbook relation). */
+export function octavesToQ(octaves: number): number {
+  const bw = Math.max(octaves, 0.05);
+  const t = Math.pow(2, bw);
+  return Math.sqrt(t) / (t - 1);
+}

package/src/index.ts

@@ -0,0 +1,10 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+/**
+ * @openmixer/omx-dsp: the TypeScript twins of omx-dsp kernels, the ones that stay in TypeScript because doing
+ * the work in C would be silly (a display, a unit conversion a browser runs). Each is pinned to its kernel by an
+ * agreement test in test/ that feeds both the same grid.
+ */
+export { ANALYSIS_FLOOR_DB, dbToLinearGain, linearGainToDb, linearToDbFloored } from './units.js';
+export { octavesToQ } from './eq.js';
+export { fftSizeForRate } from './rta.js';

package/src/rta.ts

@@ -0,0 +1,20 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+/** The twin of omx_rta.h omx_rta_fft_size_for, moved verbatim from the console (its spectrum bands); the two limits are omx-dsp's own (data/kernels/rta.json). */
+
+import { RTA_TARGET_BIN_HZ, RTA_FFT_SIZE_MAX } from './definitions.js';
+
+/**
+ * The RTA FFT length for `rate` — the TypeScript mirror of `mix_dsp.h`'s `omx_rta_fft_size_for`:
+ * the smallest power of two whose bins are at or under {@link RTA_TARGET_BIN_HZ} (44.1/48 kHz →
+ * 8192, 88.2/96 kHz → 16384, 176.4/192 kHz → 32768). Window TIME stays ~171 ms at every rate —
+ * pinning the length instead of deriving it was how moving the rig to 96 kHz silently halved the
+ * resolution (2026-09-17 declare-derive audit, F2). Every consumer of an offline/synth or a
+ * server RTA frame derives its window from the graph rate through this function rather than
+ * declaring one of its own.
+ */
+export function fftSizeForRate(rate: number): number {
+  let n = 2048;
+  while (n < RTA_FFT_SIZE_MAX && rate / n > RTA_TARGET_BIN_HZ) n *= 2;
+  return n;
+}

package/src/units.ts

@@ -0,0 +1,45 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+/** The dB and linear-amplitude twins of omx_units.h (omx_db_to_lin, omx_lin_to_db, omx_lin_to_db_d), moved verbatim from the console (its output routes). */
+
+/**
+ * dB → linear amplitude (0 dB → 1, −6 dB → ~0.501). The trim/fold gain the engine applies.
+ *
+ * `-Infinity` dB → 0 falls out of the exponential itself (`10 ** -Infinity === 0`), so
+ * callers need no silence guard of their own.
+ */
+export function dbToLinearGain(db: number): number {
+  return 10 ** (db / 20);
+}
+
+/**
+ * Linear amplitude → dB — the exact inverse of {@link dbToLinearGain}, and the reason this
+ * one exists: without it the inverse direction was hand-rolled at every call site, which is
+ * how three different silence conventions (`1e-12`, `1e-7`, `-60`) grew up elsewhere in the
+ * tree for what is nominally the same conversion.
+ *
+ * Silence and any non-positive amplitude read `-Infinity`, not NaN: `Math.log10` of a
+ * negative is NaN, and an amplitude below zero is a phase-inverted sample's magnitude
+ * mistake, not a level. Note this is the LEVEL conversion — an analyser floors its own
+ * spectrum at a chosen epsilon instead, deliberately, and should keep doing so.
+ */
+export function linearGainToDb(linear: number): number {
+  return linear <= 0 ? -Infinity : 20 * Math.log10(linear);
+}
+
+/**
+ * The analysers' magnitude floor: an FFT bin or an envelope at exact zero reads −240 dB, below
+ * any real signal and finite for the growth and ratio arithmetic built on it (was the epsilon
+ * `1e-12` inside three analysers' logarithms).
+ */
+export const ANALYSIS_FLOOR_DB = -240;
+
+/**
+ * Linear amplitude → dB, never below `floorDb` — the conversion for a site whose floor is
+ * deliberate (an analyser's magnitude, a plot's axis, a meter that must stay finite). The floor
+ * is a named dB value, never an epsilon hidden inside the logarithm (`Math.max(x, 1e-12)` is
+ * `linearToDbFloored(x, -240)`); silence reads `floorDb`, not `-Infinity`.
+ */
+export function linearToDbFloored(linear: number, floorDb: number): number {
+  return Math.max(floorDb, linearGainToDb(linear));
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.