@audio/synth-osc 1.0.0

package/audio-module.js

@@ -0,0 +1,30 @@
+// audio-module manifest — oscillator as a generator: no input bus, phase in closure.
+
+import { sine, square, sawtooth, triangle } from 'periodic-function'
+
+const WAVES = { sine, square, sawtooth, triangle }
+
+export const osc = (ctx) => {
+	let t = 0
+	return (inputs, outputs, params) => {
+		const out = outputs[0]
+		if (!out || !out.length) return
+		const f = params.freq[0] * 2 ** (params.detune[0] / 1200)
+		const dt = f / ctx.sampleRate
+		const fn = WAVES[params.type]
+		const g = params.gain[0]
+		const o0 = out[0]
+		for (let i = 0; i < o0.length; i++) {
+			o0[i] = g * fn(t % 1)
+			t += dt
+		}
+		for (let c = 1; c < out.length; c++) out[c].set(o0)
+	}
+}
+osc.channels = { inputs: [], outputs: 1 }
+osc.params = {
+	freq:   { type: 'number', min: 20, max: 20000, default: 440, curve: 'log', unit: 'Hz' },
+	detune: { type: 'number', min: -1200, max: 1200, default: 0, unit: 'cents' },
+	gain:   { type: 'number', min: 0, max: 1, default: 0.8, smoothing: 0.01 },
+	type:   { type: 'enum', values: ['sine', 'square', 'sawtooth', 'triangle'], default: 'sine' },
+}

package/osc.js

@@ -0,0 +1,26 @@
+// Oscillator — classic waveforms rendered from periodic-function (scijs), with detune.
+
+import { sine, square, sawtooth, triangle } from 'periodic-function'
+
+const WAVES = { sine, square, sawtooth, triangle }
+
+/**
+ * @param {number} freq — Hz
+ * @param {object} opts — { duration=1 (s), fs=44100, type='sine'|'square'|'sawtooth'|'triangle',
+ *   amp=0.8, detune=0 (cents), phase=0 (0..1), wave: custom t=>v }
+ * @returns {Float32Array}
+ */
+export default function osc (freq, { duration = 1, fs = 44100, type = 'sine', amp = 0.8, detune = 0, phase = 0, wave } = {}) {
+	let fn = wave || WAVES[type]
+	if (!fn) throw new RangeError(`osc: unknown type "${type}"`)
+	let f = freq * 2 ** (detune / 1200)
+	let n = Math.round(duration * fs)
+	let d = new Float32Array(n)
+	let t = phase
+	let dt = f / fs
+	for (let i = 0; i < n; i++) {
+		d[i] = amp * fn(t % 1)
+		t += dt
+	}
+	return d
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@audio/synth-osc",
+  "version": "1.0.0",
+  "description": "Oscillator \u2014 sine/square/sawtooth/triangle with detune (wraps periodic-function)",
+  "type": "module",
+  "sideEffects": false,
+  "main": "osc.js",
+  "exports": {
+    ".": "./osc.js",
+    "./package.json": "./package.json",
+    "./audio-module": "./audio-module.js"
+  },
+  "files": [
+    "osc.js",
+    "audio-module.js"
+  ],
+  "dependencies": {
+    "periodic-function": "^2.1.0"
+  },
+  "keywords": [
+    "audio",
+    "dsp",
+    "synth",
+    "oscillator"
+  ],
+  "license": "MIT",
+  "author": "Dmitry Iv. <dfcreative@gmail.com>",
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "audio-module": "./audio-module.js"
+}