Feat: PolyBLEP oscillator (#13)

README.md

@@ -7,17 +7,18 @@ Collection of synth modules implemented as AudioWorklets.
 ```ts
 import {
   registerSynthletOnce,
-  createAdsr,
-  createWavetableOscillator,
+  createVca,
+  createStateVariableFilter
+  createPolyblepOscillator,
 } from "synthlet";
 
 const audioContext = new AudioContext();
 await registerSynthletOnce(audioContext);
 
 // Simplest synth: Oscillator -> Filter -> Amplifier
-const osc = createWavetableOscillator(audioContext);
-const filter = createStateVariableFilter(audioContext);
-const vca = createVca(audioContext);
+const osc = createPolyblepOscillator(audioContext, { type: "saw", frequency: 440 });
+const filter = createStateVariableFilter(audioContext, { type: "lowpass", frequency: 4000 });
+const vca = createVca(audioContext, { attack: 0.1, release: 0.5 });
 
 osc.connect(filter).connect(vca).connect(audioContext.destination);
 
@@ -44,7 +45,21 @@ npm i @synthlet/adsr
 
 ## Documentation
 
-- [ADSR](/packages/adsr)
+#### Oscillators
+
+- [PolyblepOscillator](/packages/polyblep-oscilllator)
+- [WavetableOscillator](/packages/wavetable-oscilllator)
 - [Noise](/packages/noise)
+
+#### Envelopes
+
+- [ADSR](/packages/adsr)
+
+#### Modulators
+
 - [StateVariableFilter](/packages/state-variable-filter)
-- [WavetableOscillator](/packages/wavetable-oscilllator)
+
+## References
+
+- https://github.com/BillyDM/awesome-audio-dsp
+- https://paulbatchelor.github.io/sndkit/algos/

packages/adsr/src/index.ts

@@ -111,7 +111,7 @@ export function createAdsr(
   audioContext: AudioContext,
   params?: Partial<AdsrParams>
 ): AudioWorkletNode {
-  return createWorkletNode(audioContext, { mode: "generator" });
+  return createWorkletNode(audioContext, { mode: "generator" }, params);
 }
 
 function createWorkletNode(

packages/noise/README.md

@@ -3,15 +3,13 @@
 > Noise generator module for [synthlet](https://github.com/danigb/synthlet)
 
 ```ts
-import { registerNoiseWorkletOnce, createWhiteNoise } from "@synthlet/adsr";
+import { registerNoiseWorkletOnce, createWhiteNoise } from "@synthlet/noise";
 
 const audioContext = new AudioContext();
 
 await registerNoiseWorkletOnce(audioContext);
 
-// Create a VCA (Voltage Controlled Amplifier)
 const noise = createWhiteNoise();
-// Connect the noise to the output
 noise.connect(audioContext.destination);
 ```
 

packages/polyblep-oscillator/README.md

@@ -0,0 +1,22 @@
+# @synthlet/polyblep-oscillator
+
+> An Oscillator module implemented with PolyBLEP algorithm for [synthlet](https://github.com/danigb/synthlet)
+
+An oscillator implemented using the PolyBLEP (Polynomial Band-limited Step Functions -Valimaki et. al 2010) algorithm.
+
+```js
+import {} from "@synthlet/polyblep-oscillator";
+```
+
+## Install
+
+```bash
+npm i @synthlet/polyblep-oscillator
+```
+
+## References
+
+- https://paulbatchelor.github.io/sndkit/blep/
+- https://www.martin-finke.de/articles/audio-plugins-018-polyblep-oscillator/
+- https://www.metafunction.co.uk/post/all-about-digital-oscillators-part-2-blits-bleps
+- https://github.com/cmajor-lang/cmajor/blob/main/standard_library/std_library_oscillators.cmajor

packages/polyblep-oscillator/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@synthlet/polyblep-oscillator",
+  "version": "0.1.0",
+  "description": "PolyBLEP Oscillator module for synthlet",
+  "keywords": [
+    "modular",
+    "synthesizer",
+    "poly-blep",
+    "oscillator",
+    "synthlet"
+  ],
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "author": "[email protected]",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.11",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.1"
+  },
+  "jest": {
+    "preset": "ts-jest"
+  },
+  "scripts": {
+    "worklet": "esbuild src/worklet.ts --bundle --minify | sed -e 's/^/export const PROCESSOR = \\`/' -e 's/$/\\`;/'  > src/processor.ts",
+    "lib": "tsup src/index.ts --sourcemap --dts --format esm,cjs",
+    "build": "npm run worklet && npm run lib"
+  }
+}