@thi.ng/dsp 4.1.4 → 4.1.5

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2021-12-13T10:26:00Z
+- **Last updated**: 2022-03-11T12:13:49Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.

package/README.md

@@ -583,4 +583,4 @@ If this project contributes to an academic publication, please cite it as:
 
 ## License
 
-© 2015 - 2021 Karsten Schmidt // Apache Software License 2.0
+© 2015 - 2022 Karsten Schmidt // Apache Software License 2.0

package/add.d.ts

@@ -6,9 +6,9 @@ import { AGen } from "./agen.js";
  * given, the resulting output will be clamped to that value (min or max depends
  * on sign of `start - clamp`).
  *
- * @param step
- * @param start
- * @param clamp
+ * @param step -
+ * @param start -
+ * @param clamp -
  */
 export declare const add: (step?: number | undefined, start?: number | undefined, clamp?: number | undefined) => Add;
 export declare class Add extends AGen<number> implements IReset {

package/add.js

@@ -5,9 +5,9 @@ import { AGen } from "./agen.js";
  * given, the resulting output will be clamped to that value (min or max depends
  * on sign of `start - clamp`).
  *
- * @param step
- * @param start
- * @param clamp
+ * @param step -
+ * @param start -
+ * @param clamp -
  */
 export const add = (step, start, clamp) => new Add(step, start, clamp);
 export class Add extends AGen {

package/addg.d.ts

@@ -14,8 +14,8 @@ import type { IGen } from "./api.js";
  * // [ 10, 11, 12, 13, 14 ]
  * ```
  *
- * @param step
- * @param start
+ * @param step -
+ * @param start -
  */
 export declare const addG: (step: IGen<number>, start?: number) => IGen<number>;
 //# sourceMappingURL=addg.d.ts.map

package/addg.js

@@ -14,7 +14,7 @@ import { MapG1 } from "./mapg.js";
  * // [ 10, 11, 12, 13, 14 ]
  * ```
  *
- * @param step
- * @param start
+ * @param step -
+ * @param start -
  */
 export const addG = (step, start = 0) => new MapG1((a, b) => a + b, step, start - step.deref());

package/const.d.ts

@@ -2,7 +2,7 @@ import { AGen } from "./agen.js";
 /**
  * Returns new gen yielding always the same given value `x`.
  *
- * @param x
+ * @param x -
  */
 export declare const constant: <T>(x: T) => Const<T>;
 export declare class Const<T> extends AGen<T> {

package/const.js

@@ -2,7 +2,7 @@ import { AGen } from "./agen.js";
 /**
  * Returns new gen yielding always the same given value `x`.
  *
- * @param x
+ * @param x -
  */
 export const constant = (x) => new Const(x);
 export class Const extends AGen {

package/convert.d.ts

@@ -3,29 +3,29 @@ import type { FnN, FnN2 } from "@thi.ng/api";
  * Returns frequency `f` normalized to sample rate `fs`:
  * `fnorm = f / fs`
  *
- * @param f
- * @param fs
+ * @param f -
+ * @param fs -
  */
 export declare const normFreq: FnN2;
 /**
  * Returns frequency `f` in radians, based on sample rate `fs`.
  * I.e. Nyquist freq = PI
  *
- * @param f
- * @param fs
+ * @param f -
+ * @param fs -
  */
 export declare const freqRad: FnN2;
 /**
  * Returns period length in milliseconds for given frequency in Hz.
  *
- * @param f
+ * @param f -
  */
 export declare const freqMs: FnN;
 /**
  * Reverse op of {@link freqRad}.
  *
- * @param rad
- * @param fs
+ * @param rad -
+ * @param fs -
  */
 export declare const radFreq: FnN2;
 /**
@@ -39,28 +39,28 @@ export declare const radFreq: FnN2;
  * // 882
  * ```
  *
- * @param t
- * @param fs
+ * @param t -
+ * @param fs -
  */
 export declare const msFrames: FnN2;
 /**
  * Reverse op of {@link msFrames}.
  *
- * @param frames
- * @param fs
+ * @param frames -
+ * @param fs -
  */
 export declare const framesMs: FnN2;
 /**
  * Converts given linear magnitude to dBFS (i.e. `20 * log10(x)`)
  *
- * @param x
+ * @param x -
  */
 export declare const magDb: FnN;
 /**
  * Converts given dBFS value to linear magnitude
  * (i.e. `pow(10, x / 20)`)
  *
- * @param x
+ * @param x -
  */
 export declare const dbMag: FnN;
 //# sourceMappingURL=convert.d.ts.map

package/convert.js

@@ -3,29 +3,29 @@ import { TAU } from "@thi.ng/math/api";
  * Returns frequency `f` normalized to sample rate `fs`:
  * `fnorm = f / fs`
  *
- * @param f
- * @param fs
+ * @param f -
+ * @param fs -
  */
 export const normFreq = (f, fs) => f / fs;
 /**
  * Returns frequency `f` in radians, based on sample rate `fs`.
  * I.e. Nyquist freq = PI
  *
- * @param f
- * @param fs
+ * @param f -
+ * @param fs -
  */
 export const freqRad = (f, fs) => (f / fs) * TAU;
 /**
  * Returns period length in milliseconds for given frequency in Hz.
  *
- * @param f
+ * @param f -
  */
 export const freqMs = (f) => 1000 / f;
 /**
  * Reverse op of {@link freqRad}.
  *
- * @param rad
- * @param fs
+ * @param rad -
+ * @param fs -
  */
 export const radFreq = (rad, fs) => (rad / TAU) * fs;
 /**
@@ -39,27 +39,27 @@ export const radFreq = (rad, fs) => (rad / TAU) * fs;
  * // 882
  * ```
  *
- * @param t
- * @param fs
+ * @param t -
+ * @param fs -
  */
 export const msFrames = (t, fs) => t * 0.001 * fs;
 /**
  * Reverse op of {@link msFrames}.
  *
- * @param frames
- * @param fs
+ * @param frames -
+ * @param fs -
  */
 export const framesMs = (frames, fs) => (frames / fs) * 1000;
 /**
  * Converts given linear magnitude to dBFS (i.e. `20 * log10(x)`)
  *
- * @param x
+ * @param x -
  */
 export const magDb = (x) => (20 * Math.log(x)) / Math.LN10;
 /**
  * Converts given dBFS value to linear magnitude
  * (i.e. `pow(10, x / 20)`)
  *
- * @param x
+ * @param x -
  */
 export const dbMag = (x) => 10 ** (x / 20);

package/dcblock.d.ts

@@ -2,7 +2,7 @@ import { OnePole } from "./onepole.js";
 /**
  * One-pole DC blocker based on {@link OnePole}.
  *
- * @param freq
+ * @param freq -
  */
 export declare const dcBlock: (freq: number) => DCBlock;
 export declare class DCBlock extends OnePole {

package/dcblock.js

@@ -2,7 +2,7 @@ import { OnePole } from "./onepole.js";
 /**
  * One-pole DC blocker based on {@link OnePole}.
  *
- * @param freq
+ * @param freq -
  */
 export const dcBlock = (freq) => new DCBlock("lp", freq);
 export class DCBlock extends OnePole {

package/delay.d.ts

@@ -3,13 +3,13 @@ import { AProc } from "./aproc.js";
 /**
  * Delay line of length `n` for numeric values.
  *
- * @param n
+ * @param n -
  */
 export declare const delay: (n: number) => Delay<number>;
 /**
  * Delay line of length `n` for arbitrary typed values.
  *
- * @param n
+ * @param n -
  */
 export declare const delayT: <T>(n: number, off: T | Fn0<T>) => Delay<T>;
 /**
@@ -27,8 +27,8 @@ export declare class Delay<T> extends AProc<T, T> implements IClear, ILength, IR
      * be initialized with the results of that function (called for each
      * element).
      *
-     * @param n
-     * @param _empty
+     * @param n -
+     * @param _empty -
      */
     constructor(n: number, _empty: T | Fn0<T>);
     get length(): number;
@@ -48,7 +48,7 @@ export declare class Delay<T> extends AProc<T, T> implements IClear, ILength, IR
      * be in `(-∞..0)` interval. E.g. `tap(-1)` returns the second
      * most recent value written.
      *
-     * @param t
+     * @param t -
      */
     tap(t: number): T;
     /**
@@ -60,7 +60,7 @@ export declare class Delay<T> extends AProc<T, T> implements IClear, ILength, IR
     /**
      * Progresses read & write pos, stores & returns new value.
      *
-     * @param x
+     * @param x -
      */
     next(x: T): T;
     /**

package/delay.js

@@ -4,13 +4,13 @@ import { AProc } from "./aproc.js";
 /**
  * Delay line of length `n` for numeric values.
  *
- * @param n
+ * @param n -
  */
 export const delay = (n) => new Delay(n, 0);
 /**
  * Delay line of length `n` for arbitrary typed values.
  *
- * @param n
+ * @param n -
  */
 export const delayT = (n, off) => new Delay(n, off);
 /**
@@ -24,8 +24,8 @@ export class Delay extends AProc {
      * be initialized with the results of that function (called for each
      * element).
      *
-     * @param n
-     * @param _empty
+     * @param n -
+     * @param _empty -
      */
     constructor(n, _empty) {
         super(isFunction(_empty) ? _empty() : _empty);
@@ -69,7 +69,7 @@ export class Delay extends AProc {
      * be in `(-∞..0)` interval. E.g. `tap(-1)` returns the second
      * most recent value written.
      *
-     * @param t
+     * @param t -
      */
     tap(t) {
         return this._buf[wrap((t | 0) + this._wpos, 0, this._buf.length - 1)];
@@ -88,7 +88,7 @@ export class Delay extends AProc {
     /**
      * Progresses read & write pos, stores & returns new value.
      *
-     * @param x
+     * @param x -
      */
     next(x) {
         this.step();

package/fft.d.ts

@@ -3,13 +3,13 @@ import type { ComplexArray } from "./api.js";
 /**
  * Returns a new tuple of real/img F64 buffers of given size.
  *
- * @param n
+ * @param n -
  */
 export declare const complexArray: (n: number) => ComplexArray;
 /**
  * Creates a deep copy of given {@link ComplexArray}.
  *
- * @param complex
+ * @param complex -
  */
 export declare const copyComplex: (complex: ComplexArray) => ComplexArray;
 /**
@@ -53,8 +53,8 @@ export declare const copyComplex: (complex: ComplexArray) => ComplexArray;
  * // ]
  * ```
  *
- * @param src
- * @param isImg
+ * @param src -
+ * @param isImg -
  */
 export declare function conjugate(src: NumericArray, isImg?: boolean): NumericArray;
 export declare function conjugate(complex: ComplexArray): ComplexArray;
@@ -74,8 +74,8 @@ export declare function conjugate(complex: ComplexArray): ComplexArray;
  * - https://betterexplained.com/articles/an-interactive-guide-to-the-fourier-transform/
  * - http://toxi.co.uk/p5/fftDebug/fft4amit.pde
  *
- * @param complex
- * @param window
+ * @param complex -
+ * @param window -
  */
 export declare const fft: (complex: NumericArray | ComplexArray, window?: NumericArray | undefined) => ComplexArray;
 /**
@@ -87,7 +87,7 @@ export declare const fft: (complex: NumericArray | ComplexArray, window?: Numeri
  *
  * - https://www.dsprelated.com/showarticle/800.php (method #3)
  *
- * @param complex
+ * @param complex -
  */
 export declare const ifft: (src: NumericArray | ComplexArray) => ComplexArray;
 export declare const scaleFFT: (complex: ComplexArray, scale: number) => ComplexArray;
@@ -103,8 +103,8 @@ export declare const scaleFFT: (complex: ComplexArray, scale: number) => Complex
  * References:
  * - https://holometer.fnal.gov/GH_FFT.pdf
  *
- * @param complex
- * @param window
+ * @param complex -
+ * @param window -
  */
 export declare const normalizeFFT: (complex: ComplexArray, window?: number | NumericArray) => ComplexArray;
 /**
@@ -119,8 +119,8 @@ export declare const normalizeFFT: (complex: ComplexArray, window?: number | Num
  * References:
  * - https://holometer.fnal.gov/GH_FFT.pdf
  *
- * @param complex
- * @param window
+ * @param complex -
+ * @param window -
  */
 export declare const denormalizeFFT: (complex: ComplexArray, window?: number | NumericArray) => ComplexArray;
 /**
@@ -135,8 +135,8 @@ export declare const denormalizeFFT: (complex: ComplexArray, window?: number | N
  * References:
  * - https://www.gaussianwaves.com/2015/11/interpreting-fft-results-obtaining-magnitude-and-phase-information/
  *
- * @param complex
- * @param eps
+ * @param complex -
+ * @param eps -
  */
 export declare const thresholdFFT: (complex: ComplexArray, eps?: number) => ComplexArray;
 /**
@@ -170,11 +170,11 @@ export declare const spectrumMag: (complex: ComplexArray, n?: number, out?: Nume
  * - https://dsp.stackexchange.com/a/14935
  * - https://www.kvraudio.com/forum/viewtopic.php?t=276092
  *
- * @param complex
- * @param db
- * @param window
- * @param n
- * @param out
+ * @param complex -
+ * @param db -
+ * @param window -
+ * @param n -
+ * @param out -
  */
 export declare const spectrumPow: (complex: ComplexArray, db?: boolean, window?: number | NumericArray, n?: number, out?: NumericArray) => NumericArray;
 /**

package/fft.js

@@ -5,7 +5,7 @@ import { applyWindow } from "./window.js";
 /**
  * Returns a new tuple of real/img F64 buffers of given size.
  *
- * @param n
+ * @param n -
  */
 export const complexArray = (n) => [
     new Float64Array(n),
@@ -14,7 +14,7 @@ export const complexArray = (n) => [
 /**
  * Creates a deep copy of given {@link ComplexArray}.
  *
- * @param complex
+ * @param complex -
  */
 export const copyComplex = (complex) => [
     complex[0].slice(),
@@ -140,8 +140,8 @@ const transform = (real, img, n) => {
  * - https://betterexplained.com/articles/an-interactive-guide-to-the-fourier-transform/
  * - http://toxi.co.uk/p5/fftDebug/fft4amit.pde
  *
- * @param complex
- * @param window
+ * @param complex -
+ * @param window -
  */
 export const fft = (complex, window) => {
     let real, img;
@@ -175,7 +175,7 @@ export const fft = (complex, window) => {
  *
  * - https://www.dsprelated.com/showarticle/800.php (method #3)
  *
- * @param complex
+ * @param complex -
  */
 export const ifft = (src) => {
     let complex = isComplex(src)
@@ -205,8 +205,8 @@ export const scaleFFT = (complex, scale) => {
  * References:
  * - https://holometer.fnal.gov/GH_FFT.pdf
  *
- * @param complex
- * @param window
+ * @param complex -
+ * @param window -
  */
 export const normalizeFFT = (complex, window = 2 / complex[0].length) => scaleFFT(complex, powerScale(window, 2));
 /**
@@ -221,8 +221,8 @@ export const normalizeFFT = (complex, window = 2 / complex[0].length) => scaleFF
  * References:
  * - https://holometer.fnal.gov/GH_FFT.pdf
  *
- * @param complex
- * @param window
+ * @param complex -
+ * @param window -
  */
 export const denormalizeFFT = (complex, window = complex[0].length / 2) => scaleFFT(complex, invPowerScale(window, 2));
 /**
@@ -237,8 +237,8 @@ export const denormalizeFFT = (complex, window = complex[0].length / 2) => scale
  * References:
  * - https://www.gaussianwaves.com/2015/11/interpreting-fft-results-obtaining-magnitude-and-phase-information/
  *
- * @param complex
- * @param eps
+ * @param complex -
+ * @param eps -
  */
 export const thresholdFFT = (complex, eps = 1e-12) => {
     const [real, img] = complex;
@@ -286,11 +286,11 @@ export const spectrumMag = (complex, n = complex[0].length / 2, out = []) => {
  * - https://dsp.stackexchange.com/a/14935
  * - https://www.kvraudio.com/forum/viewtopic.php?t=276092
  *
- * @param complex
- * @param db
- * @param window
- * @param n
- * @param out
+ * @param complex -
+ * @param db -
+ * @param window -
+ * @param n -
+ * @param out -
  */
 export const spectrumPow = (complex, db = false, window = 2 / complex[0].length, n = complex[0].length / 2, out = []) => {
     const [real, img] = complex;

package/impulse.d.ts

@@ -4,7 +4,7 @@ import { AGen } from "./agen.js";
  * Numeric version of {@link impulseT}, using given `on` (default: 1) as
  * initial value and zero for the remaining values.
  *
- * @param on
+ * @param on -
  */
 export declare const impulse: (on?: number) => Impulse<number>;
 /**
@@ -19,7 +19,7 @@ export declare const impulseT: <T>(on: T, off: T) => Impulse<T>;
  * Boolean version of {@link impulseT}, using given `start` (default:
  * true) as initial value and its inverse for the remaining values.
  *
- * @param start
+ * @param start -
  */
 export declare const impulseB: (start?: boolean) => Impulse<boolean>;
 export declare class Impulse<T> extends AGen<T> implements IReset {

package/impulse.js

@@ -3,7 +3,7 @@ import { AGen } from "./agen.js";
  * Numeric version of {@link impulseT}, using given `on` (default: 1) as
  * initial value and zero for the remaining values.
  *
- * @param on
+ * @param on -
  */
 export const impulse = (on = 1) => new Impulse(on, 0);
 /**
@@ -18,7 +18,7 @@ export const impulseT = (on, off) => new Impulse(on, off);
  * Boolean version of {@link impulseT}, using given `start` (default:
  * true) as initial value and its inverse for the remaining values.
  *
- * @param start
+ * @param start -
  */
 export const impulseB = (start = true) => new Impulse(start, !start);
 export class Impulse extends AGen {

package/iterable.d.ts

@@ -10,8 +10,8 @@ import type { IGen } from "./api.js";
  * The `initial` value is required to satisfy `.deref()` and the case where the
  * iterable doesn't provide a single value.
  *
- * @param src
- * @param initial
+ * @param src -
+ * @param initial -
  */
 export declare const iterable: <T>(src: Iterable<T>, initial: T) => $Iterable<T>;
 export declare class $Iterable<T> implements IGen<T> {

package/iterable.js

@@ -10,8 +10,8 @@ import { __take } from "./internal/take.js";
  * The `initial` value is required to satisfy `.deref()` and the case where the
  * iterable doesn't provide a single value.
  *
- * @param src
- * @param initial
+ * @param src -
+ * @param initial -
  */
 export const iterable = (src, initial) => new $Iterable(src, initial);
 export class $Iterable {

package/multiplex.d.ts

@@ -12,8 +12,8 @@ import { AProc } from "./aproc.js";
  *
  * See {@link bounce} for combining results back into a single channel output.
  *
- * @param a
- * @param b
+ * @param a -
+ * @param b -
  */
 export declare function multiplex<T, A, B>(a: IProc<T, A>, b: IProc<T, B>): Multiplex<T, [A, B]>;
 export declare function multiplex<T, A, B, C>(a: IProc<T, A>, b: IProc<T, B>, c: IProc<T, C>): Multiplex<T, [A, B, C]>;

package/osc-additive.d.ts

@@ -9,10 +9,10 @@ import type { StatelessOscillator } from "./api.js";
  * and amplitude factors for each of the `n` requested harmonics (given in [i,n]
  * range).
  *
- * @param osc
- * @param freqFn
- * @param ampFn
- * @param n
+ * @param osc -
+ * @param freqFn -
+ * @param ampFn -
+ * @param n -
  */
 export declare const additive: (osc: StatelessOscillator, freqFn: Fn<number, number>, ampFn: Fn<number, number>, n: number) => StatelessOscillator;
 /**

package/osc-additive.js

@@ -9,10 +9,10 @@ import { sin } from "./osc-sin.js";
  * and amplitude factors for each of the `n` requested harmonics (given in [i,n]
  * range).
  *
- * @param osc
- * @param freqFn
- * @param ampFn
- * @param n
+ * @param osc -
+ * @param freqFn -
+ * @param ampFn -
+ * @param n -
  */
 export const additive = (osc, freqFn, ampFn, n) => {
     const fcache = [];

package/osc-dsf.d.ts

@@ -20,20 +20,20 @@ import type { StatelessOscillator } from "./api.js";
  * - https://www.desmos.com/calculator/klvl9oszfm
  * - https://ccrma.stanford.edu/files/papers/stanm5.pdf
  *
- * @param phase
- * @param freq
- * @param amp
- * @param dc
- * @param alpha
- * @param beta
+ * @param phase -
+ * @param freq -
+ * @param amp -
+ * @param dc -
+ * @param alpha -
+ * @param beta -
  */
 export declare const dsf: StatelessOscillator;
 /**
  * Higher order version of {@link dsf} oscillator with pre-configured
  * params. Slightly faster, but not dynamically changeable waveform.
  *
- * @param alpha
- * @param beta
+ * @param alpha -
+ * @param beta -
  */
 export declare const dsfHOF: (alpha?: number, beta?: number) => StatelessOscillator;
 //# sourceMappingURL=osc-dsf.d.ts.map

package/osc-dsf.js

@@ -20,12 +20,12 @@ import { TAU } from "@thi.ng/math/api";
  * - https://www.desmos.com/calculator/klvl9oszfm
  * - https://ccrma.stanford.edu/files/papers/stanm5.pdf
  *
- * @param phase
- * @param freq
- * @param amp
- * @param dc
- * @param alpha
- * @param beta
+ * @param phase -
+ * @param freq -
+ * @param amp -
+ * @param dc -
+ * @param alpha -
+ * @param beta -
  */
 export const dsf = (phase, freq, amp = 1, dc = 0, alpha = 0.5, beta = 1) => {
     const aa = alpha * alpha;
@@ -40,8 +40,8 @@ export const dsf = (phase, freq, amp = 1, dc = 0, alpha = 0.5, beta = 1) => {
  * Higher order version of {@link dsf} oscillator with pre-configured
  * params. Slightly faster, but not dynamically changeable waveform.
  *
- * @param alpha
- * @param beta
+ * @param alpha -
+ * @param beta -
  */
 export const dsfHOF = (alpha = 0.5, beta = 1) => {
     const aa = alpha * alpha;

package/osc-mix.d.ts

@@ -6,17 +6,17 @@ import type { StatelessOscillator } from "./api.js";
  * control contributions of either oscillator (default: 0.5 aka 50/50
  * ratio).
  *
- * @param osc1
- * @param osc2
+ * @param osc1 -
+ * @param osc2 -
  */
 export declare const mixOsc: (osc1: StatelessOscillator, osc2: StatelessOscillator) => StatelessOscillator;
 /**
  * Similar to {@link mixOsc}, but with `mix` arg ([0..1] range)
  * directly given to HOF and not changeable after.
  *
- * @param osc1
- * @param osc2
- * @param mix
+ * @param osc1 -
+ * @param osc2 -
+ * @param mix -
  */
 export declare const mixOscHOF: (osc1: StatelessOscillator, osc2: StatelessOscillator, mix?: number) => StatelessOscillator;
 //# sourceMappingURL=osc-mix.d.ts.map

package/osc-mix.js

@@ -6,16 +6,16 @@ import { mix as _mix } from "@thi.ng/math/mix";
  * control contributions of either oscillator (default: 0.5 aka 50/50
  * ratio).
  *
- * @param osc1
- * @param osc2
+ * @param osc1 -
+ * @param osc2 -
  */
 export const mixOsc = (osc1, osc2) => (phase, freq, amp = 1, dc = 0, t = 0.5) => _mix(osc1(phase, freq, amp, dc), osc2(phase, freq, amp, dc), t);
 /**
  * Similar to {@link mixOsc}, but with `mix` arg ([0..1] range)
  * directly given to HOF and not changeable after.
  *
- * @param osc1
- * @param osc2
- * @param mix
+ * @param osc1 -
+ * @param osc2 -
+ * @param mix -
  */
 export const mixOscHOF = (osc1, osc2, mix = 0.5) => (phase, freq, amp = 1, dc = 0) => _mix(osc1(phase, freq, amp, dc), osc2(phase, freq, amp, dc), mix);

package/osc-rect.d.ts

@@ -4,7 +4,7 @@ export declare const rect: StatelessOscillator;
  * Higher order version of {@link rect} with pre-configured `duty` width
  * (in the (0..1) range).
  *
- * @param duty
+ * @param duty -
  */
 export declare const rectHOF: (duty?: number) => StatelessOscillator;
 //# sourceMappingURL=osc-rect.d.ts.map

package/osc-rect.js

@@ -4,6 +4,6 @@ export const rect = (phase, freq, amp = 1, dc = 0, duty = 0.5) => dc + amp * (fr
  * Higher order version of {@link rect} with pre-configured `duty` width
  * (in the (0..1) range).
  *
- * @param duty
+ * @param duty -
  */
 export const rectHOF = (duty = 0.5) => (phase, freq, amp, dc) => rect(phase, freq, amp, dc, duty);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/dsp",
-  "version": "4.1.4",
+  "version": "4.1.5",
   "description": "Composable signal generators, oscillators, filters, FFT, spectrum, windowing & related DSP utils",
   "type": "module",
   "module": "./index.js",
@@ -34,20 +34,20 @@
     "test": "testament test"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.3.3",
-    "@thi.ng/checks": "^3.1.3",
-    "@thi.ng/errors": "^2.1.3",
-    "@thi.ng/math": "^5.2.0",
-    "@thi.ng/random": "^3.2.3",
-    "@thi.ng/transducers": "^8.2.0"
+    "@thi.ng/api": "^8.3.4",
+    "@thi.ng/checks": "^3.1.4",
+    "@thi.ng/errors": "^2.1.4",
+    "@thi.ng/math": "^5.3.0",
+    "@thi.ng/random": "^3.2.4",
+    "@thi.ng/transducers": "^8.3.0"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.19.2",
-    "@thi.ng/testament": "^0.2.3",
+    "@microsoft/api-extractor": "^7.19.4",
+    "@thi.ng/testament": "^0.2.4",
     "rimraf": "^3.0.2",
     "tools": "^0.0.1",
-    "typedoc": "^0.22.10",
-    "typescript": "^4.5.3"
+    "typedoc": "^0.22.13",
+    "typescript": "^4.6.2"
   },
   "keywords": [
     "allpass",
@@ -272,5 +272,5 @@
     ],
     "year": 2015
   },
-  "gitHead": "1ba92c6b9509e74e509b4c0b875fc380a97bbbc1\n"
+  "gitHead": "0fc692a3225c068aacafdc4cb6140cf603c67ad8\n"
 }

package/pipe.d.ts

@@ -3,8 +3,8 @@ import type { IGen, IProc } from "./api.js";
  * Higher order generator. Composes a new {@link IGen} from given source gen and
  * a number of {@link IProc}s (processed in series, like using {@link serial}).
  *
- * @param src
- * @param proc
+ * @param src -
+ * @param proc -
  */
 export declare function pipe<A, B>(src: IGen<A>, proc: IProc<A, B>): IGen<B>;
 export declare function pipe<A, B, C>(src: IGen<A>, a: IProc<A, B>, b: IProc<B, C>): IGen<C>;

package/power.d.ts

@@ -3,39 +3,39 @@ import type { ComplexArray } from "./api.js";
 /**
  * Computes the sum of the given array.
  *
- * @param window
+ * @param window -
  */
 export declare const integralT: (window: NumericArray) => number;
 /**
  * Computes the squared sum of given array.
  *
- * @param window
+ * @param window -
  */
 export declare const integralTSquared: (window: NumericArray) => number;
 /**
  * Computes the `sum(|c(i)|)` for given complex array.
  *
- * @param window
+ * @param window -
  */
 export declare const integralF: ([real, img]: ComplexArray) => number;
 /**
  * Computes the `sum(|c(i)|^2)` for given complex array.
  *
- * @param window
+ * @param window -
  */
 export declare const integralFSquared: ([real, img]: ComplexArray) => number;
 /**
  * If `scale` is a number, returns it. Else returns `base / integralT(scale)`.
  *
- * @param scale
- * @param base
+ * @param scale -
+ * @param base -
  */
 export declare const powerScale: (scale: number | NumericArray, base?: number) => number;
 /**
  * If `scale` is a number, returns it. Else returns `integralT(scale) / base`.
  *
- * @param scale
- * @param base
+ * @param scale -
+ * @param base -
  */
 export declare const invPowerScale: (scale: number | NumericArray, base?: number) => number;
 /**
@@ -46,7 +46,7 @@ export declare const invPowerScale: (scale: number | NumericArray, base?: number
  * - http://www.it.uom.gr/teaching/linearalgebra/NumericalRecipiesInC/c13-4.pdf
  * - http://www.hep.ucl.ac.uk/~rjn/saltStuff/fftNormalisation.pdf
  *
- * @param window
+ * @param window -
  */
 export declare const powerSumSquared: (window: NumericArray | ComplexArray) => number;
 /**
@@ -57,7 +57,7 @@ export declare const powerSumSquared: (window: NumericArray | ComplexArray) => n
  * - http://www.it.uom.gr/teaching/linearalgebra/NumericalRecipiesInC/c13-4.pdf
  * - http://www.hep.ucl.ac.uk/~rjn/saltStuff/fftNormalisation.pdf
  *
- * @param window
+ * @param window -
  */
 export declare const powerMeanSquared: (window: NumericArray | ComplexArray) => number;
 /**
@@ -69,7 +69,7 @@ export declare const powerMeanSquared: (window: NumericArray | ComplexArray) =>
  * - http://www.it.uom.gr/teaching/linearalgebra/NumericalRecipiesInC/c13-4.pdf
  * - http://www.hep.ucl.ac.uk/~rjn/saltStuff/fftNormalisation.pdf
  *
- * @param window
+ * @param window -
  */
 export declare const powerTimeIntegral: (window: NumericArray | ComplexArray, fs: number) => number;
 //# sourceMappingURL=power.d.ts.map

package/power.js

@@ -3,7 +3,7 @@ import { isComplex } from "./complex.js";
 /**
  * Computes the sum of the given array.
  *
- * @param window
+ * @param window -
  */
 export const integralT = (window) => {
     let sum = 0;
@@ -15,7 +15,7 @@ export const integralT = (window) => {
 /**
  * Computes the squared sum of given array.
  *
- * @param window
+ * @param window -
  */
 export const integralTSquared = (window) => {
     let sum = 0;
@@ -27,7 +27,7 @@ export const integralTSquared = (window) => {
 /**
  * Computes the `sum(|c(i)|)` for given complex array.
  *
- * @param window
+ * @param window -
  */
 export const integralF = ([real, img]) => {
     let sum = 0;
@@ -39,7 +39,7 @@ export const integralF = ([real, img]) => {
 /**
  * Computes the `sum(|c(i)|^2)` for given complex array.
  *
- * @param window
+ * @param window -
  */
 export const integralFSquared = ([real, img]) => {
     let sum = 0;
@@ -51,15 +51,15 @@ export const integralFSquared = ([real, img]) => {
 /**
  * If `scale` is a number, returns it. Else returns `base / integralT(scale)`.
  *
- * @param scale
- * @param base
+ * @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
+ * @param scale -
+ * @param base -
  */
 export const invPowerScale = (scale, base = 1) => isNumber(scale) ? scale : integralT(scale) / base;
 /**
@@ -70,7 +70,7 @@ export const invPowerScale = (scale, base = 1) => isNumber(scale) ? scale : inte
  * - http://www.it.uom.gr/teaching/linearalgebra/NumericalRecipiesInC/c13-4.pdf
  * - http://www.hep.ucl.ac.uk/~rjn/saltStuff/fftNormalisation.pdf
  *
- * @param window
+ * @param window -
  */
 export const powerSumSquared = (window) => isComplex(window)
     ? integralFSquared(window) / window[0].length
@@ -83,7 +83,7 @@ export const powerSumSquared = (window) => isComplex(window)
  * - http://www.it.uom.gr/teaching/linearalgebra/NumericalRecipiesInC/c13-4.pdf
  * - http://www.hep.ucl.ac.uk/~rjn/saltStuff/fftNormalisation.pdf
  *
- * @param window
+ * @param window -
  */
 export const powerMeanSquared = (window) => powerSumSquared(window) /
     (isComplex(window) ? window[0].length : window.length);
@@ -96,7 +96,7 @@ export const powerMeanSquared = (window) => powerSumSquared(window) /
  * - http://www.it.uom.gr/teaching/linearalgebra/NumericalRecipiesInC/c13-4.pdf
  * - http://www.hep.ucl.ac.uk/~rjn/saltStuff/fftNormalisation.pdf
  *
- * @param window
+ * @param window -
  */
 export const powerTimeIntegral = (window, fs) => (isComplex(window) ? integralFSquared(window) : integralTSquared(window)) /
     fs;

package/reciprocal.d.ts

@@ -3,7 +3,7 @@ import { AGen } from "./agen.js";
 /**
  * Returns a gen which yield sequence `y(t) = 1 / (y(t - 1) + step)`.
  *
- * @param step
+ * @param step -
  */
 export declare const reciprocal: (step?: number | undefined) => Reciprocal;
 export declare class Reciprocal extends AGen<number> implements IReset {

package/reciprocal.js

@@ -2,7 +2,7 @@ import { AGen } from "./agen.js";
 /**
  * Returns a gen which yield sequence `y(t) = 1 / (y(t - 1) + step)`.
  *
- * @param step
+ * @param step -
  */
 export const reciprocal = (step) => new Reciprocal(step);
 export class Reciprocal extends AGen {

package/serial.d.ts

@@ -8,8 +8,8 @@ import { AProc } from "./aproc.js";
  * @remarks
  * Provides optimized (loop free) versions for 2-4 inputs
  *
- * @param a
- * @param b
+ * @param a -
+ * @param b -
  */
 export declare function serial<A, B, C>(a: IProc<A, B>, b: IProc<B, C>): IProc<A, C>;
 export declare function serial<A, B, C, D>(a: IProc<A, B>, b: IProc<B, C>, c: IProc<C, D>): IProc<A, D>;

package/sweep.d.ts

@@ -18,10 +18,10 @@
  * // [...]
  * ```
  *
- * @param start
- * @param end
- * @param steps
- * @param rate
+ * @param start -
+ * @param end -
+ * @param steps -
+ * @param rate -
  * @param clamp - true, if clamp at `end` value
  */
 export declare const sweep: (start: number, end: number, steps: number, rate?: number | undefined, clamp?: boolean) => import("./api.js").IGen<number>;

package/sweep.js

@@ -20,10 +20,10 @@ import { curve } from "./curve.js";
  * // [...]
  * ```
  *
- * @param start
- * @param end
- * @param steps
- * @param rate
+ * @param start -
+ * @param end -
+ * @param steps -
+ * @param rate -
  * @param clamp - true, if clamp at `end` value
  */
 export const sweep = (start, end, steps, rate, clamp = true) => addG(curve(start, end, steps, rate, false, clamp));

package/window.d.ts

@@ -5,17 +5,17 @@ import type { WindowFn } from "./api.js";
  * The buffer size MUST be the same as the signal length given to
  * {@link fft}.
  *
- * @param fn
- * @param lenOfBuf
+ * @param fn -
+ * @param lenOfBuf -
  */
 export declare const window: (fn: WindowFn, lenOfBuf: number | FloatArray) => FloatArray;
 /**
  * Takes a `signal` and `window` buffer and multiplies both elementwise. Writes
  * results into `out` (or back into `signal` by default).
  *
- * @param signal
- * @param window
- * @param out
+ * @param signal -
+ * @param window -
+ * @param out -
  */
 export declare const applyWindow: (signal: NumericArray, window: NumericArray, out?: NumericArray) => NumericArray;
 export declare const windowRect: WindowFn;

package/window.js

@@ -10,8 +10,8 @@ const cos = Math.cos;
  * The buffer size MUST be the same as the signal length given to
  * {@link fft}.
  *
- * @param fn
- * @param lenOfBuf
+ * @param fn -
+ * @param lenOfBuf -
  */
 export const window = (fn, lenOfBuf) => {
     const buf = isNumber(lenOfBuf) ? new Float64Array(lenOfBuf) : lenOfBuf;
@@ -25,9 +25,9 @@ export const window = (fn, lenOfBuf) => {
  * Takes a `signal` and `window` buffer and multiplies both elementwise. Writes
  * results into `out` (or back into `signal` by default).
  *
- * @param signal
- * @param window
- * @param out
+ * @param signal -
+ * @param window -
+ * @param out -
  */
 export const applyWindow = (signal, window, out = signal) => {
     for (let i = signal.length; i-- > 0;) {