@audio/synth-noise 1.0.0

package/colors.js

@@ -0,0 +1,61 @@
+// Colors of noise — seeded, deterministic generators with defined spectral slopes:
+// white 0 dB/oct · pink −3 (Kellet filter) · brown −6 (leaky integration) ·
+// blue +3 (differentiated pink) · violet +6 (differentiated white).
+
+import pinkNoise from './pink-noise.js'
+
+function lcg (seed) {
+	let s = seed >>> 0 || 1
+	return () => {
+		s = (s * 1103515245 + 12345) & 0x7fffffff
+		return s / 0x3fffffff - 1
+	}
+}
+function normalize (d, peak = 0.9) {
+	let m = 0
+	for (let i = 0; i < d.length; i++) { let a = Math.abs(d[i]); if (a > m) m = a }
+	if (m > 0) for (let i = 0; i < d.length; i++) d[i] *= peak / m
+	return d
+}
+
+export function white (n, { seed = 1 } = {}) {
+	let rand = lcg(seed)
+	let d = new Float32Array(n)
+	for (let i = 0; i < n; i++) d[i] = rand() * 0.9
+	return d
+}
+
+export function pink (n, opts = {}) {
+	let d = Float64Array.from(white(n, opts))
+	pinkNoise(d, {})
+	return normalize(Float32Array.from(d))
+}
+
+export function brown (n, { seed = 1, leak = 0.999 } = {}) {
+	let rand = lcg(seed)
+	let d = new Float32Array(n)
+	let y = 0
+	for (let i = 0; i < n; i++) d[i] = y = y * leak + rand() * 0.02
+	return normalize(d)
+}
+
+export function blue (n, opts = {}) {
+	let p = pink(n + 1, opts)
+	let d = new Float32Array(n)
+	for (let i = 0; i < n; i++) d[i] = p[i + 1] - p[i]
+	return normalize(d)
+}
+
+export function violet (n, opts = {}) {
+	let w = white(n + 1, opts)
+	let d = new Float32Array(n)
+	for (let i = 0; i < n; i++) d[i] = w[i + 1] - w[i]
+	return normalize(d)
+}
+
+/** noise(n, { color: 'white'|'pink'|'brown'|'blue'|'violet', seed }) */
+export default function noise (n, { color = 'white', ...opts } = {}) {
+	const GEN = { white, pink, brown, blue, violet }
+	if (!GEN[color]) throw new RangeError(`noise: unknown color "${color}"`)
+	return GEN[color](n, opts)
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@audio/synth-noise",
+  "version": "1.0.0",
+  "description": "Colors of noise — white, pink (Kellet), brown, blue, violet; seeded, slope-verified",
+  "type": "module",
+  "sideEffects": false,
+  "main": "pink-noise.js",
+  "exports": {
+    ".": "./pink-noise.js",
+    "./package.json": "./package.json",
+    "./colors": "./colors.js",
+    "./pink": "./pink-noise.js"
+  },
+  "files": [
+    "pink-noise.js",
+    "pink-noise.d.ts",
+    "colors.js"
+  ],
+  "keywords": [
+    "audio",
+    "dsp",
+    "synth",
+    "noise",
+    "pink-noise"
+  ],
+  "license": "MIT",
+  "author": "Dmitry Iv. <dfcreative@gmail.com>",
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "types": "pink-noise.d.ts"
+}

package/pink-noise.d.ts

@@ -0,0 +1,7 @@
+type Buf = Float32Array | Float64Array | number[]
+interface BiquadCoef { b0: number; b1: number; b2: number; a1: number; a2: number }
+type SOS = BiquadCoef[]
+
+/** Paul Kellet pink-noise filter (IIR approximation, -3dB/oct) applied to white noise input */
+declare function pinkNoise(data: Buf, params?: Record<string, unknown>): Buf
+export default pinkNoise

package/pink-noise.js

@@ -0,0 +1,34 @@
+/**
+ * Pink noise filter (1/f spectral slope, -3dB/octave).
+ * IIR approximation using Paul Kellet's refined method.
+ * Apply to white noise to produce pink noise.
+ *
+ * @param {Float64Array} data - White noise input (modified in-place)
+ * @param {object} params - {b0-b6: state variables}
+ * @returns {Float64Array} pink noise
+ */
+export default function pinkNoise (data, params) {
+	let b0 = params.b0 || 0
+	let b1 = params.b1 || 0
+	let b2 = params.b2 || 0
+	let b3 = params.b3 || 0
+	let b4 = params.b4 || 0
+	let b5 = params.b5 || 0
+	let b6 = params.b6 || 0
+
+	for (let i = 0; i < data.length; i++) {
+		let white = data[i]
+		b0 = 0.99886 * b0 + white * 0.0555179
+		b1 = 0.99332 * b1 + white * 0.0750759
+		b2 = 0.96900 * b2 + white * 0.1538520
+		b3 = 0.86650 * b3 + white * 0.3104856
+		b4 = 0.55000 * b4 + white * 0.5329522
+		b5 = -0.7616 * b5 - white * 0.0168980
+		data[i] = b0 + b1 + b2 + b3 + b4 + b5 + b6 + white * 0.5362
+		b6 = white * 0.115926
+	}
+
+	params.b0 = b0; params.b1 = b1; params.b2 = b2
+	params.b3 = b3; params.b4 = b4; params.b5 = b5; params.b6 = b6
+	return data
+}