@audio/eq 1.0.0

package/LICENSE

@@ -0,0 +1,40 @@
+Kṛṣnized
+
+This is a reminder that, in the absolute sense, all results of work belong to the Supreme.
+
+While software and intellectual property (IP) require a formal license to define authorship,
+responsibilities, or distribution limitations, these are temporary material designations.
+The origin and destination of all ideas, as well as the ultimate owner of all results,
+is the Supreme. The most meaningful action is to dedicate these results to the Supreme.
+This process is known as Karma-Yoga and is described in BG 3.9, BG 12.10 and BG 18.46.
+
+"Work done as a sacrifice for the Supreme must be performed;
+otherwise, work binds one to the material world."
+
+This license does not override or alter the terms specified by the material-level license below.
+
+ॐ
+
+---
+
+MIT License
+
+Copyright (c) Dmitry Iv
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,15 @@
+# @audio/eq
+
+> Equalization & tone shaping — shelves, parametric, graphic, baxandall, tilt, crossover.
+
+| Package | What |
+|---|---|
+| `@audio/eq-lowshelf` / `@audio/eq-highshelf` | RBJ shelving filters |
+| `@audio/eq-parametric` | multi-band parametric EQ |
+| `@audio/eq-graphic` | ISO 266 10-band graphic EQ |
+| `@audio/eq-baxandall` | Baxandall bass/treble tone control |
+| `@audio/eq-tilt` | one-knob see-saw tilt EQ |
+| `@audio/eq-crossover` | Linkwitz-Riley N-way crossover |
+| `@audio/eq-fir` (planned) | linear-phase FIR EQ from arbitrary response — firequalizer / match-EQ |
+
+Extracted from [filter](https://github.com/audiojs/filter). Headphone crossfeed moved to `@audio/spatial-crossfeed`.

package/index.d.ts

@@ -0,0 +1,66 @@
+type Buf = Float32Array | Float64Array | number[]
+interface BiquadCoef { b0: number; b1: number; b2: number; a1: number; a2: number }
+type SOS = BiquadCoef[]
+
+export interface GraphicEqParams {
+  gains?: Record<number, number>  // { 31.5: dB, 63: dB, 125: dB, 250: dB, 500: dB, 1000: dB, 2000: dB, 4000: dB, 8000: dB, 16000: dB } — ISO 266 / IEC 61260-1 1/1-octave nominal band keys only, unset keys default to 0 dB
+  fs?: number
+  [key: string]: unknown
+}
+
+/** ISO 266 octave-band graphic equalizer (10 bands: 31.5 Hz – 16 kHz), in-place, cascaded biquads */
+export function graphicEq(data: Buf, params: GraphicEqParams): Buf
+
+export interface PeqBand {
+  fc: number
+  Q?: number         // default 1 for type 'peak', 0.707 (RBJ maximally-flat) for 'lowshelf'/'highshelf'
+  gain?: number       // dB (default 0)
+  type?: 'peak' | 'lowshelf' | 'highshelf' // default 'peak'
+}
+
+export interface ParametricEqParams {
+  bands?: PeqBand[]
+  fs?: number
+  [key: string]: unknown
+}
+
+/** Multi-band parametric EQ, in-place. Filters rebuild automatically whenever any band's fc/Q/gain/type or fs changes. */
+export function parametricEq(data: Buf, params: ParametricEqParams): Buf
+
+/** Linkwitz-Riley crossover — returns one SOS array per output band. order default 4, fs default 44100. For order ≡ 2 (mod 4) (LR2, LR6, …) alternate bands are polarity-inverted internally so the returned bands sum flat by construction. */
+export function crossover(frequencies: number[], order?: number, fs?: number): SOS[]
+
+export interface ShelfParams {
+  fc?: number        // corner frequency Hz — default 200 for lowShelf, 4000 for highShelf
+  gain?: number      // dB boost/cut (default 0)
+  Q?: number         // slope control (default 0.707)
+  fs?: number        // sample rate (default 44100)
+  [key: string]: unknown
+}
+
+/** Low-shelf filter — boost or cut below corner frequency. fc default 200 Hz. */
+export function lowShelf(data: Buf, params: ShelfParams): Buf
+/** High-shelf filter — boost or cut above corner frequency. fc default 4000 Hz. */
+export function highShelf(data: Buf, params: ShelfParams): Buf
+
+export interface BaxandallParams {
+  bass?: number      // dB (default 0)
+  treble?: number    // dB (default 0)
+  fBass?: number     // bass pivot Hz (default 250)
+  fTreble?: number   // treble pivot Hz (default 4000)
+  fs?: number
+  [key: string]: unknown
+}
+
+/** Baxandall bass/treble tone control — cascaded low-shelf + high-shelf */
+export function baxandall(data: Buf, params: BaxandallParams): Buf
+
+export interface TiltParams {
+  gain?: number      // dB: positive = bass up / treble down (default 0)
+  pivot?: number     // pivot frequency Hz (default 1000)
+  fs?: number
+  [key: string]: unknown
+}
+
+/** Tilt EQ — see-saw around a pivot frequency */
+export function tilt(data: Buf, params: TiltParams): Buf

package/index.js

@@ -0,0 +1,13 @@
+// @audio/eq — equalization & tone shaping umbrella re-exporting every @audio/eq-* atom.
+// For smaller bundles, depend directly on the individual atom.
+// Headphone crossfeed lives in @audio/spatial-crossfeed.
+
+export { default as graphicEq } from '@audio/eq-graphic'
+export { default as parametricEq } from '@audio/eq-parametric'
+export { default as crossover } from '@audio/eq-crossover'
+export { default as lowShelf } from '@audio/eq-lowshelf'
+export { default as highShelf } from '@audio/eq-highshelf'
+export { default as baxandall } from '@audio/eq-baxandall'
+export { default as tilt } from '@audio/eq-tilt'
+export { default as firEq, design as firDesign } from '@audio/eq-fir'
+export { default as dynamicEq } from '@audio/eq-dynamic'

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@audio/eq",
+  "version": "1.0.0",
+  "type": "module",
+  "sideEffects": false,
+  "description": "Equalization & tone shaping — umbrella for @audio/eq-* atoms (shelves, parametric, graphic, baxandall, tilt, crossover)",
+  "main": "index.js",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "index.js",
+    "index.d.ts"
+  ],
+  "workspaces": [
+    "packages/*"
+  ],
+  "keywords": [
+    "audio",
+    "eq",
+    "equalizer",
+    "dsp",
+    "parametric",
+    "graphic"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@audio/eq-highshelf": "^1.0.0",
+    "@audio/eq-lowshelf": "^1.0.0",
+    "@audio/eq-parametric": "^1.0.0",
+    "@audio/eq-graphic": "^1.0.0",
+    "@audio/eq-baxandall": "^1.0.0",
+    "@audio/eq-tilt": "^1.0.0",
+    "@audio/eq-crossover": "^1.0.0",
+    "@audio/eq-fir": "^1.0.0",
+    "@audio/eq-dynamic": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "Dmitry Iv. <dfcreative@gmail.com>",
+  "scripts": {
+    "test": "node test.js",
+    "test:all": "npm test --workspaces --if-present && npm test",
+    "publish:all": "npm publish --workspaces && npm publish"
+  },
+  "types": "index.d.ts",
+  "devDependencies": {
+    "tst": "^9.4.0"
+  }
+}