@audio/speech-formant 1.0.0

package/formant.d.ts

@@ -0,0 +1,15 @@
+type Buf = Float32Array | Float64Array | number[]
+interface BiquadCoef { b0: number; b1: number; b2: number; a1: number; a2: number }
+type SOS = BiquadCoef[]
+
+export interface Formant { fc: number; bw?: number; gain?: number } // bw default 50, gain default 1
+
+export interface FormantParams {
+  formants?: Formant[] // default 3-formant /a/ vowel bank
+  fs?: number
+  [key: string]: unknown
+}
+
+/** Parallel formant filter bank for vowel synthesis, in-place */
+declare function formant(data: Buf, params: FormantParams): Buf
+export default formant

package/formant.js

@@ -0,0 +1,41 @@
+/**
+ * Parallel formant filter bank.
+ * Used for vowel/formant synthesis.
+ *
+ * @module  audio-filter/speech/formant
+ */
+
+import resonator from '@audio/filter-resonator'
+
+/**
+ * @param {Float64Array} data - Input (modified in-place)
+ * @param {object} params - { formants: [{fc, bw, gain}], fs }
+ */
+export default function formant (data, params) {
+	let fs = params.fs || 44100
+	let formants = params.formants || [
+		{fc: 730, bw: 90, gain: 1},    // F1 (open vowel /a/)
+		{fc: 1090, bw: 110, gain: 0.5},
+		{fc: 2440, bw: 170, gain: 0.3}
+	]
+
+	// Rebuild filter bank when band content (fc/bw/gain) or fs changes — keyed by
+	// content, not object identity, since params.formants is often reused/mutated in place
+	let key = fs + '|' + formants.map(f => f.fc + ',' + (f.bw || 50) + ',' + (f.gain ?? 1)).join(';')
+	if (params._formantsKey !== key) {
+		params._states = formants.map(f => ({fc: f.fc, bw: f.bw || 50, fs, _gain: f.gain ?? 1}))
+		params._formantsKey = key
+	}
+
+	let input = Float64Array.from(data)
+	data.fill(0)
+
+	for (let i = 0; i < formants.length; i++) {
+		let band = Float64Array.from(input)
+		resonator(band, params._states[i])
+		let g = params._states[i]._gain
+		for (let j = 0; j < data.length; j++) data[j] += band[j] * g
+	}
+
+	return data
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@audio/speech-formant",
+  "version": "1.0.0",
+  "description": "Parallel formant filter bank",
+  "type": "module",
+  "sideEffects": false,
+  "main": "formant.js",
+  "exports": {
+    ".": "./formant.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "formant.js",
+    "formant.d.ts"
+  ],
+  "dependencies": {
+    "@audio/filter-resonator": "^1.0.0"
+  },
+  "keywords": [
+    "audio",
+    "dsp",
+    "speech",
+    "formant"
+  ],
+  "license": "MIT",
+  "author": "Dmitry Iv. <dfcreative@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/audiojs/filter.git",
+    "directory": "packages/speech-formant"
+  },
+  "homepage": "https://github.com/audiojs/filter/tree/main/packages/speech-formant",
+  "bugs": {
+    "url": "https://github.com/audiojs/filter/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "types": "formant.d.ts"
+}