@audio/dynamics-core 0.1.0

package/biquad.js

@@ -0,0 +1,24 @@
+// RBJ audio EQ cookbook biquads — only what dynamics-processor needs for
+// sidechain filtering (deesser). For a full filter library see audio-filter.
+
+const PI2 = 2 * Math.PI
+
+export function bandpass(sr, freq, q) {
+  let w0 = PI2 * freq / sr
+  let cw = Math.cos(w0)
+  let a = Math.sin(w0) / (2 * q)
+  let a0 = 1 + a
+  return {
+    b0: a / a0, b1: 0, b2: -a / a0,
+    a1: -2 * cw / a0, a2: (1 - a) / a0,
+  }
+}
+
+export function biquad(c, s, x) {
+  let y = c.b0 * x + c.b1 * s.x1 + c.b2 * s.x2 - c.a1 * s.y1 - c.a2 * s.y2
+  s.x2 = s.x1; s.x1 = x
+  s.y2 = s.y1; s.y1 = y
+  return y
+}
+
+export const biquadState = () => ({ x1: 0, x2: 0, y1: 0, y2: 0 })

package/index.js

@@ -0,0 +1,2 @@
+export * from './util.js'
+export * from './biquad.js'

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@audio/dynamics-core",
+  "version": "0.1.0",
+  "description": "Shared dynamics primitives — dB/linear conversion, time-constant coefficients, stream writers, biquad sidechain filters",
+  "type": "module",
+  "sideEffects": false,
+  "main": "index.js",
+  "exports": {
+    ".": "./index.js",
+    "./package.json": "./package.json",
+    "./util": "./util.js",
+    "./biquad": "./biquad.js"
+  },
+  "files": [
+    "index.js",
+    "util.js",
+    "biquad.js"
+  ],
+  "keywords": [
+    "audio",
+    "dsp",
+    "dynamics"
+  ],
+  "license": "MIT",
+  "author": "Dmitry Iv. <dfcreative@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/audiojs/dynamics.git",
+    "directory": "packages/dynamics-core"
+  },
+  "homepage": "https://github.com/audiojs/dynamics/tree/main/packages/dynamics-core",
+  "bugs": {
+    "url": "https://github.com/audiojs/dynamics/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/util.js

@@ -0,0 +1,30 @@
+export const clamp = (v, lo, hi) => v < lo ? lo : v > hi ? hi : v
+
+export const db2lin = (db) => Math.pow(10, db / 20)
+export const lin2db = (lin) => 20 * Math.log10(Math.max(Math.abs(lin), 1e-10))
+
+// One-pole smoothing coefficient: y[n] = c·y[n-1] + (1-c)·x[n].
+// ms → coefficient. c close to 1 = slow, close to 0 = fast.
+export function timeCoef(ms, sampleRate) {
+  if (ms <= 0) return 0
+  return Math.exp(-1 / (ms * 0.001 * sampleRate))
+}
+
+// Wrap { write, flush } into a single callable: write(chunk) → process, write() → flush.
+export function writer(s) {
+  return (chunk) => chunk ? s.write(chunk) : s.flush()
+}
+
+// Two-input variant for ducker/sidechain.
+export function writer2(s) {
+  return (main, side) => main ? s.write(main, side || main) : s.flush()
+}
+
+export function concat(a, b) {
+  if (!b || !b.length) return a
+  if (!a.length) return b
+  let out = new Float32Array(a.length + b.length)
+  out.set(a)
+  out.set(b, a.length)
+  return out
+}