@thi.ng/dsp 4.6.16 → 4.6.18

package/osc.js

@@ -3,78 +3,44 @@ import { Add, add } from "./add.js";
 import { AGen } from "./agen.js";
 import { Const } from "./const.js";
 import { sum } from "./sum.js";
-/**
- * Higher order oscillator gen, wrapping a {@link StatelessOscillator} function
- * and supporting either constant or {@link IGen}-based frequency and amplitude,
- * thus allowing for FM/AM modulation. Furthermore, a constant `dc` offset
- * (center value) and/or start `phase` can be specified (both default to: 0).
- *
- * @remarks
- * If `freq` is a number, it must be given as normalized frequency (same for
- * `phase`). If `freq` is an `IGen`, it must be configured to produce normalized
- * frequency values (e.g. if using an `Osc` by setting its `amp` to a normalized
- * freq and its `dc` offset to `baseFreq * TAU`). Also see {@link fmodOsc} for
- * syntax sugar. The `phase` arg is only used if `freq` is NOT an `IGen`.
- *
- * The oscillator initializes to zero and its
- * [`IDeref`](https://docs.thi.ng/umbrella/api/interfaces/IDeref.html).deref}
- * value is only available / valid after the first invocation of
- * {@link IGen.next}.
- *
- * @param osc - stateless osc
- * @param freq - normalized freq
- * @param amp - amplitude
- * @param dc - DC offset / center value
- * @param phase - normalized start phase
- */
-export const osc = (osc, freq, amp, dc, phase) => new Osc(osc, freq, amp, dc, phase);
-/**
- * Syntax sugar for creating frequency modulated `Osc` gens.
- *
- * @remarks
- * The `fmod` value defines the +/- normalized frequency modulation
- * range, added to the main oscillator `freq`.
- *
- * @example
- * ```ts
- * // FM sin osc using rect osc as frequency modulator
- * modOsc(sin, 0.01, osc(rect, 0.1, 0.2))
- *
- * // AM sin osc using rect osc as amplitude modulator
- * modOsc(sin, 0.01, 0, osc(rect, 0.1, 0.2))
- *
- * // FM & AM sin osc using rect osc as fmod and saw as amod
- * modOsc(sin, 0.01, osc(rect, 0.1, 0.2), osc(saw, 0.05))
- *
- * ```
- *
- * @param osc - stateless main osc
- * @param freq - main osc freq
- * @param fmod - freq modulator
- * @param amod` - normalized freq
- * @param dc` - DC offset / center value
- * @param phase - normalized start phase
- */
-export const modOsc = (osc, freq, fmod, amod = 1, dc, phase) => new Osc(osc, sum(isNumber(fmod) ? new Const(fmod) : fmod, isNumber(freq) ? add(freq) : freq), amod, dc, phase);
-export class Osc extends AGen {
-    _osc;
-    _dc;
-    _phase;
-    _amp;
-    constructor(_osc, freq, amp = 1, _dc = 0, phase = 0) {
-        super(0);
-        this._osc = _osc;
-        this._dc = _dc;
-        isNumber(freq) ? this.setFreq(freq, phase) : this.setFreq(freq);
-        this.setAmp(amp);
-    }
-    next() {
-        return (this._val = this._osc(this._phase.next(), 1, this._amp.next(), this._dc));
-    }
-    setFreq(freq, phase) {
-        this._phase = isNumber(freq) ? new Add(freq, phase || 0) : freq;
-    }
-    setAmp(amp) {
-        this._amp = isNumber(amp) ? new Const(amp) : amp;
-    }
+const osc = (osc2, freq, amp, dc, phase) => new Osc(osc2, freq, amp, dc, phase);
+const modOsc = (osc2, freq, fmod, amod = 1, dc, phase) => new Osc(
+  osc2,
+  sum(
+    isNumber(fmod) ? new Const(fmod) : fmod,
+    isNumber(freq) ? add(freq) : freq
+  ),
+  amod,
+  dc,
+  phase
+);
+class Osc extends AGen {
+  constructor(_osc, freq, amp = 1, _dc = 0, phase = 0) {
+    super(0);
+    this._osc = _osc;
+    this._dc = _dc;
+    isNumber(freq) ? this.setFreq(freq, phase) : this.setFreq(freq);
+    this.setAmp(amp);
+  }
+  _phase;
+  _amp;
+  next() {
+    return this._val = this._osc(
+      this._phase.next(),
+      1,
+      this._amp.next(),
+      this._dc
+    );
+  }
+  setFreq(freq, phase) {
+    this._phase = isNumber(freq) ? new Add(freq, phase || 0) : freq;
+  }
+  setAmp(amp) {
+    this._amp = isNumber(amp) ? new Const(amp) : amp;
+  }
 }
+export {
+  Osc,
+  modOsc,
+  osc
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/dsp",
-  "version": "4.6.16",
+  "version": "4.6.18",
   "description": "Composable signal generators, oscillators, filters, FFT, spectrum, windowing & related DSP utils",
   "type": "module",
   "module": "./index.js",
@@ -24,7 +24,9 @@
   "author": "Karsten Schmidt (https://thi.ng)",
   "license": "Apache-2.0",
   "scripts": {
-    "build": "yarn clean && tsc --declaration",
+    "build": "yarn build:esbuild && yarn build:decl",
+    "build:decl": "tsc --declaration --emitDeclarationOnly",
+    "build:esbuild": "esbuild --format=esm --platform=neutral --target=es2022 --tsconfig=tsconfig.json --outdir=. src/**/*.ts",
     "clean": "rimraf --glob '*.js' '*.d.ts' '*.map' doc internal",
     "doc": "typedoc --excludePrivate --excludeInternal --out doc src/index.ts",
     "doc:ae": "mkdir -p .ae/doc .ae/temp && api-extractor run --local --verbose",
@@ -33,15 +35,16 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.9.11",
-    "@thi.ng/checks": "^3.4.11",
-    "@thi.ng/errors": "^2.4.5",
-    "@thi.ng/math": "^5.7.6",
-    "@thi.ng/random": "^3.6.17",
-    "@thi.ng/transducers": "^8.8.14"
+    "@thi.ng/api": "^8.9.13",
+    "@thi.ng/checks": "^3.4.13",
+    "@thi.ng/errors": "^2.4.7",
+    "@thi.ng/math": "^5.7.8",
+    "@thi.ng/random": "^3.6.19",
+    "@thi.ng/transducers": "^8.8.16"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.38.3",
+    "esbuild": "^0.19.8",
     "rimraf": "^5.0.5",
     "tools": "^0.0.1",
     "typedoc": "^0.25.4",
@@ -81,7 +84,7 @@
     "access": "public"
   },
   "engines": {
-    "node": ">=12.7"
+    "node": ">=18"
   },
   "files": [
     "./*.js",
@@ -282,5 +285,5 @@
     ],
     "year": 2015
   },
-  "gitHead": "25f2ac8ff795a432a930119661b364d4d93b59a0\n"
+  "gitHead": "25a42a81fac8603a1e440a7aa8bc343276211ff4\n"
 }

package/pan.js

@@ -2,33 +2,27 @@ import { QUARTER_PI } from "@thi.ng/math/api";
 import { clamp11 } from "@thi.ng/math/interval";
 import { AProc } from "./aproc.js";
 import { __ensureGenN } from "./internal/ensure.js";
-/**
- * Positions and converts a mono signal into a stereo signal using given `pos`
- * in the [-1..1] range to control the panning (-1 = left, +1 = right).
- *
- * @remarks
- * Reference:
- * https://www.musicdsp.org/en/latest/Effects/255-stereo-field-rotation-via-transformation-matrix.html
- *
- * @param pos
- */
-export const pan = (pos) => new Pan(pos);
-export class Pan extends AProc {
-    _pos;
-    constructor(pos = 0) {
-        super([0, 0]);
-        this.pos = pos;
-    }
-    get pos() {
-        return this._pos.deref();
-    }
-    set pos(pos) {
-        this._pos = __ensureGenN(pos, clamp11);
-    }
-    next(x) {
-        const pos = this._pos.next() * QUARTER_PI;
-        const s = x * Math.sin(pos);
-        const c = x * Math.cos(pos);
-        return [c - s, s + c];
-    }
+const pan = (pos) => new Pan(pos);
+class Pan extends AProc {
+  _pos;
+  constructor(pos = 0) {
+    super([0, 0]);
+    this.pos = pos;
+  }
+  get pos() {
+    return this._pos.deref();
+  }
+  set pos(pos) {
+    this._pos = __ensureGenN(pos, clamp11);
+  }
+  next(x) {
+    const pos = this._pos.next() * QUARTER_PI;
+    const s = x * Math.sin(pos);
+    const c = x * Math.cos(pos);
+    return [c - s, s + c];
+  }
 }
+export {
+  Pan,
+  pan
+};

package/pink-noise.js

@@ -1,62 +1,40 @@
 import { SYSTEM } from "@thi.ng/random/system";
 import { AGen } from "./agen.js";
 const AMP = [3.8024, 2.9694, 2.597, 3.087, 3.4006];
-const PROB = [0.00198, 0.0128, 0.049, 0.17, 0.682];
-/**
- * Pink noise generator with customizable frequency distribution. The
- * default config produces a power spectrum roughly following the `1/f`
- * pink characteristic.
- *
- * @remarks
- * Custom frequency/power distributions can be obtained by providing
- * `amp` and `prob`ability tuples for the 5 internal bins used to
- * compute the noise. `amp` defines per-bin power contributions, the
- * latter bin update probabilities.
- *
- * Resulting noise values are normalized to given `gain`, which itself
- * is scale relative to the sum of given `amp` values.
- *
- * References:
- * - http://web.archive.org/web/20160513114217/http://home.earthlink.net/~ltrammell/tech/newpink.htm
- * - http://web.archive.org/web/20160515145318if_/http://home.earthlink.net/~ltrammell/tech/pinkalg.htm
- * - https://www.musicdsp.org/en/latest/Synthesis/220-trammell-pink-noise-c-class.html
- *
- * @param gain -
- * @param rnd -
- * @param amp -
- * @param prob -
- */
-export const pinkNoise = (gain, rnd, amp, prob) => new PinkNoise(gain, rnd, amp, prob);
-export class PinkNoise extends AGen {
-    _gain;
-    _rnd;
-    _amp;
-    _bins;
-    _psum;
-    constructor(_gain = 1, _rnd = SYSTEM, _amp = AMP, prob = PROB) {
-        super(0);
-        this._gain = _gain;
-        this._rnd = _rnd;
-        this._amp = _amp;
-        this._gain /= _amp.reduce((acc, x) => acc + x, 0);
-        this._psum = prob.reduce((acc, x, i) => (acc.push(i > 0 ? acc[i - 1] + x : x), acc), []);
-        this._bins = [0, 0, 0, 0, 0];
-    }
-    reset() {
-        this._bins.fill(0);
-        return this;
-    }
-    next() {
-        const { _bins, _rnd, _amp, _psum } = this;
-        const bin = _rnd.float();
-        for (let i = 0; i < 5; i++) {
-            if (bin <= _psum[i]) {
-                _bins[i] = _rnd.norm(_amp[i]);
-                break;
-            }
-        }
-        return (this._val =
-            this._gain *
-                (_bins[0] + _bins[1] + _bins[2] + _bins[3] + _bins[4]));
+const PROB = [198e-5, 0.0128, 0.049, 0.17, 0.682];
+const pinkNoise = (gain, rnd, amp, prob) => new PinkNoise(gain, rnd, amp, prob);
+class PinkNoise extends AGen {
+  constructor(_gain = 1, _rnd = SYSTEM, _amp = AMP, prob = PROB) {
+    super(0);
+    this._gain = _gain;
+    this._rnd = _rnd;
+    this._amp = _amp;
+    this._gain /= _amp.reduce((acc, x) => acc + x, 0);
+    this._psum = prob.reduce(
+      (acc, x, i) => (acc.push(i > 0 ? acc[i - 1] + x : x), acc),
+      []
+    );
+    this._bins = [0, 0, 0, 0, 0];
+  }
+  _bins;
+  _psum;
+  reset() {
+    this._bins.fill(0);
+    return this;
+  }
+  next() {
+    const { _bins, _rnd, _amp, _psum } = this;
+    const bin = _rnd.float();
+    for (let i = 0; i < 5; i++) {
+      if (bin <= _psum[i]) {
+        _bins[i] = _rnd.norm(_amp[i]);
+        break;
+      }
     }
+    return this._val = this._gain * (_bins[0] + _bins[1] + _bins[2] + _bins[3] + _bins[4]);
+  }
 }
+export {
+  PinkNoise,
+  pinkNoise
+};

package/pipe.js

@@ -1,7 +1,9 @@
 import { MapG1 } from "./mapg.js";
 import { serial } from "./serial.js";
-export function pipe(src, ...procs) {
-    // @ts-ignore
-    const proc = serial(...procs);
-    return new MapG1(proc.next.bind(proc), src, null);
+function pipe(src, ...procs) {
+  const proc = serial(...procs);
+  return new MapG1(proc.next.bind(proc), src, null);
 }
+export {
+  pipe
+};

package/power.js

@@ -1,102 +1,46 @@
 import { isNumber } from "@thi.ng/checks/is-number";
 import { isComplex } from "./complex.js";
-/**
- * Computes the sum of the given array.
- *
- * @param window -
- */
-export const integralT = (window) => {
-    let sum = 0;
-    for (let i = window.length; i-- > 0;) {
-        sum += window[i];
-    }
-    return sum;
+const integralT = (window) => {
+  let sum = 0;
+  for (let i = window.length; i-- > 0; ) {
+    sum += window[i];
+  }
+  return sum;
 };
-/**
- * Computes the squared sum of given array.
- *
- * @param window -
- */
-export const integralTSquared = (window) => {
-    let sum = 0;
-    for (let i = window.length; i-- > 0;) {
-        sum += window[i] ** 2;
-    }
-    return sum;
+const integralTSquared = (window) => {
+  let sum = 0;
+  for (let i = window.length; i-- > 0; ) {
+    sum += window[i] ** 2;
+  }
+  return sum;
 };
-/**
- * Computes the `sum(|c(i)|)` for given complex array.
- *
- * @param window -
- */
-export const integralF = ([real, img]) => {
-    let sum = 0;
-    for (let i = real.length; i-- > 0;) {
-        sum += Math.hypot(real[i], img[i]);
-    }
-    return sum;
+const integralF = ([real, img]) => {
+  let sum = 0;
+  for (let i = real.length; i-- > 0; ) {
+    sum += Math.hypot(real[i], img[i]);
+  }
+  return sum;
 };
-/**
- * Computes the `sum(|c(i)|^2)` for given complex array.
- *
- * @param window -
- */
-export const integralFSquared = ([real, img]) => {
-    let sum = 0;
-    for (let i = real.length; i-- > 0;) {
-        sum += real[i] ** 2 + img[i] ** 2;
-    }
-    return sum;
+const integralFSquared = ([real, img]) => {
+  let sum = 0;
+  for (let i = real.length; i-- > 0; ) {
+    sum += real[i] ** 2 + img[i] ** 2;
+  }
+  return sum;
+};
+const powerScale = (scale, base = 1) => isNumber(scale) ? scale : base / integralT(scale);
+const invPowerScale = (scale, base = 1) => isNumber(scale) ? scale : integralT(scale) / base;
+const powerSumSquared = (window) => isComplex(window) ? integralFSquared(window) / window[0].length : integralTSquared(window);
+const powerMeanSquared = (window) => powerSumSquared(window) / (isComplex(window) ? window[0].length : window.length);
+const powerTimeIntegral = (window, fs) => (isComplex(window) ? integralFSquared(window) : integralTSquared(window)) / fs;
+export {
+  integralF,
+  integralFSquared,
+  integralT,
+  integralTSquared,
+  invPowerScale,
+  powerMeanSquared,
+  powerScale,
+  powerSumSquared,
+  powerTimeIntegral
 };
-/**
- * If `scale` is a number, returns it. Else returns `base / integralT(scale)`.
- *
- * @param scale -
- * @param base -
- */
-export const powerScale = (scale, base = 1) => isNumber(scale) ? scale : base / integralT(scale);
-/**
- * If `scale` is a number, returns it. Else returns `integralT(scale) / base`.
- *
- * @param scale -
- * @param base -
- */
-export const invPowerScale = (scale, base = 1) => isNumber(scale) ? scale : integralT(scale) / base;
-/**
- * Computes sum squared power of given time or frequency domain window.
- *
- * @remarks
- * References:
- * - http://www.it.uom.gr/teaching/linearalgebra/NumericalRecipiesInC/c13-4.pdf
- * - http://www.hep.ucl.ac.uk/~rjn/saltStuff/fftNormalisation.pdf
- *
- * @param window -
- */
-export const powerSumSquared = (window) => isComplex(window)
-    ? integralFSquared(window) / window[0].length
-    : integralTSquared(window);
-/**
- * Computes mean squared power of given time or frequency domain window.
- *
- * @remarks
- * References:
- * - http://www.it.uom.gr/teaching/linearalgebra/NumericalRecipiesInC/c13-4.pdf
- * - http://www.hep.ucl.ac.uk/~rjn/saltStuff/fftNormalisation.pdf
- *
- * @param window -
- */
-export const powerMeanSquared = (window) => powerSumSquared(window) /
-    (isComplex(window) ? window[0].length : window.length);
-/**
- * Computes time-integral squared power of given time or frequency domain
- * window.
- *
- * @remarks
- * References:
- * - http://www.it.uom.gr/teaching/linearalgebra/NumericalRecipiesInC/c13-4.pdf
- * - http://www.hep.ucl.ac.uk/~rjn/saltStuff/fftNormalisation.pdf
- *
- * @param window -
- */
-export const powerTimeIntegral = (window, fs) => (isComplex(window) ? integralFSquared(window) : integralTSquared(window)) /
-    fs;

package/product.js

@@ -1,6 +1,7 @@
 import { MapG2, MapG3 } from "./mapg.js";
-export function product(a, b, c) {
-    return c
-        ? new MapG3((a, b, c) => a * b * c, a, b, c, 0)
-        : new MapG2((a, b) => a * b, a, b, 0);
+function product(a, b, c) {
+  return c ? new MapG3((a2, b2, c2) => a2 * b2 * c2, a, b, c, 0) : new MapG2((a2, b2) => a2 * b2, a, b, 0);
 }
+export {
+  product
+};

package/reciprocal.js

@@ -1,24 +1,22 @@
 import { AGen } from "./agen.js";
-/**
- * Returns a gen which yield sequence `y(t) = 1 / (y(t - 1) + step)`.
- *
- * @param step -
- */
-export const reciprocal = (step) => new Reciprocal(step);
-export class Reciprocal extends AGen {
-    _step;
-    _n;
-    constructor(_step = 1) {
-        super(1);
-        this._step = _step;
-        this.reset();
-    }
-    reset() {
-        this._n = 1 - this._step;
-        return this;
-    }
-    next() {
-        this._n += this._step;
-        return (this._val = 1 / this._n);
-    }
+const reciprocal = (step) => new Reciprocal(step);
+class Reciprocal extends AGen {
+  constructor(_step = 1) {
+    super(1);
+    this._step = _step;
+    this.reset();
+  }
+  _n;
+  reset() {
+    this._n = 1 - this._step;
+    return this;
+  }
+  next() {
+    this._n += this._step;
+    return this._val = 1 / this._n;
+  }
 }
+export {
+  Reciprocal,
+  reciprocal
+};

package/ref.js

@@ -1,24 +1,28 @@
 import { AGen } from "./agen.js";
 import { AProc } from "./aproc.js";
-export const refG = (src) => new RefG(src);
-export class RefG extends AGen {
-    _src;
-    constructor(_src) {
-        super(_src.deref());
-        this._src = _src;
-    }
-    next() {
-        return this._src.deref();
-    }
+const refG = (src) => new RefG(src);
+class RefG extends AGen {
+  constructor(_src) {
+    super(_src.deref());
+    this._src = _src;
+  }
+  next() {
+    return this._src.deref();
+  }
 }
-export const refP = (src) => new RefP(src);
-export class RefP extends AProc {
-    _src;
-    constructor(_src) {
-        super(_src.deref());
-        this._src = _src;
-    }
-    next() {
-        return this._src.deref();
-    }
+const refP = (src) => new RefP(src);
+class RefP extends AProc {
+  constructor(_src) {
+    super(_src.deref());
+    this._src = _src;
+  }
+  next() {
+    return this._src.deref();
+  }
 }
+export {
+  RefG,
+  RefP,
+  refG,
+  refP
+};