@thi.ng/dsp 4.5.0 → 4.6.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2023-09-15T12:33:37Z
+- **Last updated**: 2023-09-28T05:58:33Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,24 @@ See [Conventional Commits](https://conventionalcommits.org/) for commit guidelin
 **Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
 and/or version bumps of transitive dependencies.
 
+## [4.6.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/dsp@4.6.0) (2023-09-28)
+
+#### 🚀 Features
+
+- add IXform impl for AProc2 ([5aa6c9b](https://github.com/thi-ng/umbrella/commit/5aa6c9b))
+- add ICopy impls for various IGen's ([7894cd4](https://github.com/thi-ng/umbrella/commit/7894cd4))
+- add merge(), mix(), pan() ([314e9b2](https://github.com/thi-ng/umbrella/commit/314e9b2))
+- add refG()/refP() wrappers ([99f4535](https://github.com/thi-ng/umbrella/commit/99f4535))
+
+#### 🩹 Bug fixes
+
+- enforce integer delay time ([5c21b00](https://github.com/thi-ng/umbrella/commit/5c21b00))
+- return delayed value in Delay.next() ([f2b08db](https://github.com/thi-ng/umbrella/commit/f2b08db))
+
+#### ♻️ Refactoring
+
+- simplify pipe() to reuse serial() ([90910bc](https://github.com/thi-ng/umbrella/commit/90910bc))
+
 ## [4.5.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/dsp@4.5.0) (2023-09-15)
 
 #### 🚀 Features

package/add.d.ts

@@ -1,4 +1,4 @@
-import type { IReset } from "@thi.ng/api";
+import type { ICopy, IReset } from "@thi.ng/api";
 import { AGen } from "./agen.js";
 /**
  * Creates a new `Add` gen using given `step` (default: 1.0) and `start`
@@ -11,11 +11,12 @@ import { AGen } from "./agen.js";
  * @param clamp -
  */
 export declare const add: (step?: number, start?: number, clamp?: number) => Add;
-export declare class Add extends AGen<number> implements IReset {
+export declare class Add extends AGen<number> implements ICopy<Add>, IReset {
     protected _step: number;
     protected _start: number;
     protected _clamp?: number | undefined;
     constructor(_step?: number, _start?: number, _clamp?: number | undefined);
+    copy(): Add;
     reset(): this;
     next(): number;
 }

package/add.js

@@ -18,6 +18,9 @@ export class Add extends AGen {
         this._clamp = _clamp;
         this.reset();
     }
+    copy() {
+        return new Add(this._step, this._start, this._clamp);
+    }
     reset() {
         this._val = this._start - this._step;
         return this;

package/adsr.d.ts

@@ -1,4 +1,4 @@
-import type { IReset } from "@thi.ng/api";
+import type { ICopy, IReset } from "@thi.ng/api";
 import { AGen } from "./agen.js";
 import type { IGen } from "./api.js";
 declare const enum EnvPhase {
@@ -71,7 +71,7 @@ export interface ADSROpts {
  * @param opts -
  */
 export declare const adsr: (opts?: Partial<ADSROpts>) => ADSR;
-export declare class ADSR extends AGen<number> implements IReset {
+export declare class ADSR extends AGen<number> implements ICopy<ADSR>, IReset {
     protected _phase: EnvPhase;
     protected _curve: IGen<number>;
     protected _atime: number;
@@ -83,6 +83,7 @@ export declare class ADSR extends AGen<number> implements IReset {
     protected _speriod: number;
     protected _gain: number;
     constructor(opts?: Partial<ADSROpts>);
+    copy(): ADSR;
     reset(): this;
     release(): void;
     isSustained(): boolean;

package/adsr.js

@@ -58,6 +58,18 @@ export class ADSR extends AGen {
         this.setGain(opts.gain);
         this.reset();
     }
+    copy() {
+        return new ADSR({
+            a: this._atime,
+            d: this._dtime,
+            s: this._sustain,
+            r: this._rtime,
+            acurve: this._acurve,
+            dcurve: this._dcurve,
+            gain: this._gain,
+            slen: this._speriod,
+        });
+    }
     reset() {
         this._phase = EnvPhase.ATTACK;
         this._curve = curve(0, 1, this._atime + 1, this._acurve, true);

package/alt.d.ts

@@ -1,13 +1,14 @@
-import type { IReset } from "@thi.ng/api";
+import type { ICopy, IReset } from "@thi.ng/api";
 import { AGen } from "./agen.js";
 export declare const alt: (n?: number) => Alt<number>;
 export declare const altT: <T>(a: T, b: T) => Alt<T>;
 export declare const altB: (x?: boolean) => Alt<boolean>;
-export declare class Alt<T> extends AGen<T> implements IReset {
+export declare class Alt<T> extends AGen<T> implements ICopy<Alt<T>>, IReset {
     protected _a: T;
     protected _b: T;
     protected _flip: boolean;
     constructor(_a: T, _b: T);
+    copy(): Alt<T>;
     reset(): this;
     next(): T;
 }

package/alt.js

@@ -9,6 +9,9 @@ export class Alt extends AGen {
         this._b = _b;
         this._flip = true;
     }
+    copy() {
+        return new Alt(this._a, this._b);
+    }
     reset() {
         this._flip = true;
         return this;

package/aproc.d.ts

@@ -15,10 +15,11 @@ export declare abstract class AProc<A, B> implements IProc<A, B>, IXform<A, B> {
 /**
  * Similar to {@link AProc}, but for processors with 2 inputs.
  */
-export declare abstract class AProc2<A, B, C> implements IProc2<A, B, C> {
+export declare abstract class AProc2<A, B, C> implements IProc2<A, B, C>, IXform<[A, B], C> {
     protected _val: C;
     constructor(_val: C);
     deref(): C;
     abstract next(a: A, b: B): C;
+    xform(): import("@thi.ng/transducers").Transducer<[A, B], C>;
 }
 //# sourceMappingURL=aproc.d.ts.map

package/aproc.js

@@ -25,4 +25,7 @@ export class AProc2 {
     deref() {
         return this._val;
     }
+    xform() {
+        return map(([a, b]) => this.next(a, b));
+    }
 }

package/const.d.ts

@@ -1,3 +1,4 @@
+import type { ICopy } from "@thi.ng/api";
 import { AGen } from "./agen.js";
 /**
  * Returns new gen yielding always the same given value `x`.
@@ -5,7 +6,8 @@ import { AGen } from "./agen.js";
  * @param x -
  */
 export declare const constant: <T>(x: T) => Const<T>;
-export declare class Const<T> extends AGen<T> {
+export declare class Const<T> extends AGen<T> implements ICopy<Const<T>> {
+    copy(): Const<T>;
     next(): T;
 }
 //# sourceMappingURL=const.d.ts.map

package/const.js

@@ -6,6 +6,9 @@ import { AGen } from "./agen.js";
  */
 export const constant = (x) => new Const(x);
 export class Const extends AGen {
+    copy() {
+        return new Const(this._val);
+    }
     next() {
         return this._val;
     }

package/delay.d.ts

@@ -1,4 +1,4 @@
-import type { Fn0, IClear, ILength, IReset } from "@thi.ng/api";
+import type { Fn0, IClear, ICopy, ILength, IReset } from "@thi.ng/api";
 import { AProc } from "./aproc.js";
 /**
  * Delay line of length `n` for numeric values.
@@ -16,7 +16,7 @@ export declare const delayT: <T>(n: number, off: T | Fn0<T>) => Delay<T>;
  * Ring buffer / delay line for arbitrary values w/ support for tapping
  * at any delay time (within configured buffer size).
  */
-export declare class Delay<T> extends AProc<T, T> implements IClear, ILength, IReset {
+export declare class Delay<T> extends AProc<T, T> implements IClear, ICopy<Delay<T>>, ILength, IReset {
     protected _empty: T | Fn0<T>;
     protected _buf: T[];
     protected _rpos: number;
@@ -33,6 +33,7 @@ export declare class Delay<T> extends AProc<T, T> implements IClear, ILength, IR
     constructor(n: number, _empty: T | Fn0<T>);
     get length(): number;
     clear(): void;
+    copy(): Delay<T>;
     /**
      * Alias for {@link Delay.clear}
      */
@@ -58,7 +59,7 @@ export declare class Delay<T> extends AProc<T, T> implements IClear, ILength, IR
      */
     multiTap(t: ArrayLike<number>, out?: T[]): T[];
     /**
-     * Progresses read & write pos, stores & returns new value.
+     * Progresses read & write pos, stores new value and returns delayed value.
      *
      * @param x -
      */

package/delay.js

@@ -1,4 +1,5 @@
 import { isFunction } from "@thi.ng/checks/is-function";
+import { illegalArgs } from "@thi.ng/errors/illegal-arguments";
 import { wrap } from "@thi.ng/math/interval";
 import { AProc } from "./aproc.js";
 /**
@@ -30,6 +31,9 @@ export class Delay extends AProc {
     constructor(n, _empty) {
         super(isFunction(_empty) ? _empty() : _empty);
         this._empty = _empty;
+        if (n < 1)
+            illegalArgs("delay size must be >= 1");
+        n >>>= 0;
         this._wpos = n - 1;
         this._rpos = 0;
         this._buf = new Array(n);
@@ -49,6 +53,9 @@ export class Delay extends AProc {
             this._buf.fill(_empty);
         }
     }
+    copy() {
+        return new Delay(this._buf.length, this._empty);
+    }
     /**
      * Alias for {@link Delay.clear}
      */
@@ -86,14 +93,14 @@ export class Delay extends AProc {
         return out;
     }
     /**
-     * Progresses read & write pos, stores & returns new value.
+     * Progresses read & write pos, stores new value and returns delayed value.
      *
      * @param x -
      */
     next(x) {
         this.step();
         this._buf[this._wpos] = x;
-        return x;
+        return (this._val = this._buf[this._rpos]);
     }
     /**
      * Moves read & write cursors one step forward. Useful for skipping

package/feedback-delay.d.ts

@@ -1,4 +1,5 @@
 import { Delay } from "./delay.js";
+import type { ICopy } from "@thi.ng/api";
 /**
  * Extension of {@link Delay} which adds sum delayed value multiplied
  * with `feedback` for each new input.
@@ -10,9 +11,10 @@ import { Delay } from "./delay.js";
  * @param feedback - feedback factor (default: 0.5)
  */
 export declare const feedbackDelay: (n: number, feedback?: number) => FeedbackDelay;
-export declare class FeedbackDelay extends Delay<number> {
+export declare class FeedbackDelay extends Delay<number> implements ICopy<FeedbackDelay> {
     protected _feedback: number;
     constructor(n: number, _feedback?: number);
+    copy(): FeedbackDelay;
     next(x: number): number;
     feedback(): number;
     setFeedback(feedback: number): void;

package/feedback-delay.js

@@ -17,6 +17,9 @@ export class FeedbackDelay extends Delay {
         this._feedback = _feedback;
         this.setFeedback(_feedback);
     }
+    copy() {
+        return new FeedbackDelay(this._buf.length, this._feedback);
+    }
     next(x) {
         return super.next(x + this._buf[this._rpos] * this._feedback);
     }

package/filter-delay.d.ts

@@ -1,8 +1,8 @@
 import type { IProc } from "./api.js";
 import { Delay } from "./delay.js";
 /**
- * Extension of {@link feedbackDelay} with additional filter/proc
- * possibility for the feedback itself (e.g. a low pass filter).
+ * Extension of {@link feedbackDelay} with an additional filter/proc applied to
+ * the feedback itself (e.g. a low pass filter).
  *
  * @param n - delay length
  * @param filter - IProc applied to feedback

package/filter-delay.js

@@ -1,8 +1,8 @@
 import { clamp01 } from "@thi.ng/math/interval";
 import { Delay } from "./delay.js";
 /**
- * Extension of {@link feedbackDelay} with additional filter/proc
- * possibility for the feedback itself (e.g. a low pass filter).
+ * Extension of {@link feedbackDelay} with an additional filter/proc applied to
+ * the feedback itself (e.g. a low pass filter).
  *
  * @param n - delay length
  * @param filter - IProc applied to feedback

package/impulse-train.d.ts

@@ -1,4 +1,4 @@
-import type { IReset } from "@thi.ng/api";
+import type { ICopy, IReset } from "@thi.ng/api";
 import { AGen } from "./agen.js";
 /**
  * https://en.wikipedia.org/wiki/Dirac_comb
@@ -9,13 +9,14 @@ import { AGen } from "./agen.js";
 export declare const impulseTrain: (period: number, start?: number) => ImpulseTrain<number>;
 export declare const impulseTrainT: <T>(on: T, off: T, period: number, start?: number) => ImpulseTrain<T>;
 export declare const impulseTrainB: (period: number, start?: number) => ImpulseTrain<boolean>;
-export declare class ImpulseTrain<T> extends AGen<T> implements IReset {
+export declare class ImpulseTrain<T> extends AGen<T> implements ICopy<ImpulseTrain<T>>, IReset {
     protected _on: T;
     protected _off: T;
     protected _period: number;
     protected _pos: number;
     protected _startpos: number;
     constructor(_on: T, _off: T, _period: number, _pos?: number);
+    copy(): ImpulseTrain<T>;
     reset(): this;
     next(): T;
 }

package/impulse-train.js

@@ -17,6 +17,9 @@ export class ImpulseTrain extends AGen {
         this._pos = _pos;
         this._startpos = --this._pos;
     }
+    copy() {
+        return new ImpulseTrain(this._on, this._off, this._period, this._startpos + 1);
+    }
     reset() {
         this._val = this._off;
         this._pos = this._startpos;

package/impulse.d.ts

@@ -1,4 +1,4 @@
-import type { IReset } from "@thi.ng/api";
+import type { ICopy, IReset } from "@thi.ng/api";
 import { AGen } from "./agen.js";
 /**
  * Numeric version of {@link impulseT}, using given `on` (default: 1) as
@@ -22,10 +22,11 @@ export declare const impulseT: <T>(on: T, off: T) => Impulse<T>;
  * @param start -
  */
 export declare const impulseB: (start?: boolean) => Impulse<boolean>;
-export declare class Impulse<T> extends AGen<T> implements IReset {
+export declare class Impulse<T> extends AGen<T> implements ICopy<Impulse<T>>, IReset {
     protected _on: T;
     protected _off: T;
     constructor(_on: T, _off: T);
+    copy(): Impulse<T>;
     reset(): this;
     next(): T;
 }

package/impulse.js

@@ -27,6 +27,9 @@ export class Impulse extends AGen {
         this._on = _on;
         this._off = _off;
     }
+    copy() {
+        return new Impulse(this._on, this._off);
+    }
     reset() {
         this._val = this._on;
         return this;

package/index.d.ts

@@ -28,6 +28,7 @@ export * from "./iterable.js";
 export * from "./line.js";
 export * from "./madd.js";
 export * from "./mapg.js";
+export * from "./merge.js";
 export * from "./mix.js";
 export * from "./mul.js";
 export * from "./multiplex.js";
@@ -43,11 +44,13 @@ export * from "./osc-sin.js";
 export * from "./osc-tri.js";
 export * from "./osc-wavetable.js";
 export * from "./osc.js";
+export * from "./pan.js";
 export * from "./pink-noise.js";
 export * from "./pipe.js";
 export * from "./power.js";
 export * from "./product.js";
 export * from "./reciprocal.js";
+export * from "./ref.js";
 export * from "./serial.js";
 export * from "./sincos.js";
 export * from "./sum.js";

package/index.js

@@ -28,6 +28,7 @@ export * from "./iterable.js";
 export * from "./line.js";
 export * from "./madd.js";
 export * from "./mapg.js";
+export * from "./merge.js";
 export * from "./mix.js";
 export * from "./mul.js";
 export * from "./multiplex.js";
@@ -43,11 +44,13 @@ export * from "./osc-sin.js";
 export * from "./osc-tri.js";
 export * from "./osc-wavetable.js";
 export * from "./osc.js";
+export * from "./pan.js";
 export * from "./pink-noise.js";
 export * from "./pipe.js";
 export * from "./power.js";
 export * from "./product.js";
 export * from "./reciprocal.js";
+export * from "./ref.js";
 export * from "./serial.js";
 export * from "./sincos.js";
 export * from "./sum.js";

package/integrator.d.ts

@@ -1,4 +1,4 @@
-import type { IReset } from "@thi.ng/api";
+import type { ICopy, IReset } from "@thi.ng/api";
 import { AProc } from "./aproc.js";
 /**
  * Leaky integrator.
@@ -8,10 +8,11 @@ import { AProc } from "./aproc.js";
  * @param coeff - leak (default: 1)
  */
 export declare const integrator: (coeff?: number, start?: number) => Integrator;
-export declare class Integrator extends AProc<number, number> implements IReset {
+export declare class Integrator extends AProc<number, number> implements ICopy<Integrator>, IReset {
     protected _coeff: number;
     protected _start: number;
     constructor(_coeff?: number, _start?: number);
+    copy(): Integrator;
     reset(): this;
     next(x: number): number;
     coeff(): number;

package/integrator.js

@@ -13,6 +13,9 @@ export class Integrator extends AProc {
         this._coeff = _coeff;
         this._start = _start;
     }
+    copy() {
+        return new Integrator(this._coeff, this._start);
+    }
     reset() {
         this._val = this._start;
         return this;

package/internal/ensure.d.ts

@@ -0,0 +1,4 @@
+import type { FnN } from "@thi.ng/api";
+import type { IGen } from "../api.js";
+export declare const __ensureGenN: (x: number | IGen<number>, clamp: FnN) => IGen<number>;
+//# sourceMappingURL=ensure.d.ts.map

package/internal/ensure.js

@@ -0,0 +1,3 @@
+import { isNumber } from "@thi.ng/checks/is-number";
+import { Const } from "../const.js";
+export const __ensureGenN = (x, clamp) => isNumber(x) ? new Const(clamp(x)) : x;

package/madd.d.ts

@@ -1,4 +1,4 @@
-import type { IReset } from "@thi.ng/api";
+import type { ICopy, IReset } from "@thi.ng/api";
 import { AGen } from "./agen.js";
 /**
  * Returns new multiply-add gen producing `y(t) = factor * y(t-1) +
@@ -11,12 +11,13 @@ import { AGen } from "./agen.js";
  * @param clamp - optional final value
  */
 export declare const madd: (factor?: number, start?: number, offset?: number, clamp?: number) => MAdd;
-export declare class MAdd extends AGen<number> implements IReset {
+export declare class MAdd extends AGen<number> implements ICopy<MAdd>, IReset {
     protected _factor: number;
     protected _start: number;
     protected _offset: number;
     protected _clamp?: number | undefined;
     constructor(_factor?: number, _start?: number, _offset?: number, _clamp?: number | undefined);
+    copy(): MAdd;
     reset(): this;
     next(): number;
 }

package/madd.js

@@ -19,6 +19,9 @@ export class MAdd extends AGen {
         this._clamp = _clamp;
         this.reset();
     }
+    copy() {
+        return new MAdd(this._factor, this._start, this._offset, this._clamp);
+    }
     reset() {
         this._val = (this._start - this._offset) / this._factor;
         return this;

package/merge.d.ts

@@ -0,0 +1,11 @@
+import { AGen } from "./agen.js";
+import { type IGen } from "./api.js";
+export declare const merge: (...channels: IGen<number>[]) => Merge<number>;
+export declare const mergeT: <T>(channels: IGen<T>[], init: T) => Merge<T>;
+export declare class Merge<T> extends AGen<T[]> {
+    protected _channels: IGen<T>[];
+    constructor(_channels: IGen<T>[], init: T);
+    channel(i: number): IGen<T>;
+    next(): T[];
+}
+//# sourceMappingURL=merge.d.ts.map

package/merge.js

@@ -0,0 +1,16 @@
+import { AGen } from "./agen.js";
+import {} from "./api.js";
+export const merge = (...channels) => new Merge(channels, 0);
+export const mergeT = (channels, init) => new Merge(channels, init);
+export class Merge extends AGen {
+    constructor(_channels, init) {
+        super(new Array(_channels.length).fill(init));
+        this._channels = _channels;
+    }
+    channel(i) {
+        return this._channels[i];
+    }
+    next() {
+        return this._channels.map((x) => x.next());
+    }
+}

package/mix.d.ts

@@ -1,9 +1,20 @@
+import type { IGen } from "./api.js";
 import { AProc2 } from "./aproc.js";
+import type { NumericArray } from "@thi.ng/api";
+export declare const mix: (t?: number) => Mix;
 export declare class Mix extends AProc2<number, number, number> {
-    protected _t: number;
-    constructor(_t: number);
-    get mix(): number;
-    set mix(x: number);
+    protected _t: IGen<number>;
+    constructor(t?: number | IGen<number>);
+    get mix(): number | IGen<number>;
+    set mix(t: number | IGen<number>);
     next(a: number, b: number): number;
 }
+export declare const mix2: (t?: number) => Mix2;
+export declare class Mix2 extends AProc2<NumericArray, NumericArray, NumericArray> {
+    protected _t: IGen<number>;
+    constructor(t?: number | IGen<number>);
+    get mix(): number | IGen<number>;
+    set mix(t: number | IGen<number>);
+    next(a: NumericArray, b: NumericArray): number[];
+}
 //# sourceMappingURL=mix.d.ts.map

package/mix.js

@@ -1,17 +1,37 @@
 import { clamp01 } from "@thi.ng/math/interval";
+import { mix as $mix } from "@thi.ng/math/mix";
 import { AProc2 } from "./aproc.js";
+import { __ensureGenN } from "./internal/ensure.js";
+export const mix = (t) => new Mix(t);
 export class Mix extends AProc2 {
-    constructor(_t) {
+    constructor(t = 0.5) {
         super(0);
-        this._t = _t;
+        this.mix = t;
     }
     get mix() {
-        return this._t;
+        return this._t.deref();
     }
-    set mix(x) {
-        this._t = clamp01(x);
+    set mix(t) {
+        this._t = __ensureGenN(t, clamp01);
     }
     next(a, b) {
-        return (this._val = a + (b - a) * this._t);
+        return (this._val = a + (b - a) * this._t.next());
+    }
+}
+export const mix2 = (t) => new Mix2(t);
+export class Mix2 extends AProc2 {
+    constructor(t = 0.5) {
+        super([0, 0]);
+        this.mix = t;
+    }
+    get mix() {
+        return this._t.deref();
+    }
+    set mix(t) {
+        this._t = __ensureGenN(t, clamp01);
+    }
+    next(a, b) {
+        const t = this._t.next();
+        return (this._val = [$mix(a[0], b[0], t), $mix(a[1], b[1], t)]);
     }
 }

package/mul.d.ts

@@ -1,4 +1,4 @@
-import type { IReset } from "@thi.ng/api";
+import type { ICopy, IReset } from "@thi.ng/api";
 import { AGen } from "./agen.js";
 /**
  * Returns new multiply gen, producing `y(t) = factor * y(t-1)`, using
@@ -11,11 +11,12 @@ import { AGen } from "./agen.js";
  * @param clamp -
  */
 export declare const mul: (factor?: number, start?: number, clamp?: number) => Mul;
-export declare class Mul extends AGen<number> implements IReset {
+export declare class Mul extends AGen<number> implements ICopy<Mul>, IReset {
     protected _factor: number;
     protected _start: number;
     protected _clamp?: number | undefined;
     constructor(_factor?: number, _start?: number, _clamp?: number | undefined);
+    copy(): Mul;
     reset(): this;
     next(): number;
 }

package/mul.js

@@ -18,6 +18,9 @@ export class Mul extends AGen {
         this._clamp = _clamp;
         this.reset();
     }
+    copy() {
+        return new Mul(this._factor, this._start, this._clamp);
+    }
     reset() {
         this._val = this._start / this._factor;
         return this;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/dsp",
-  "version": "4.5.0",
+  "version": "4.6.0",
   "description": "Composable signal generators, oscillators, filters, FFT, spectrum, windowing & related DSP utils",
   "type": "module",
   "module": "./index.js",
@@ -38,8 +38,8 @@
     "@thi.ng/checks": "^3.4.5",
     "@thi.ng/errors": "^2.3.5",
     "@thi.ng/math": "^5.6.1",
-    "@thi.ng/random": "^3.6.4",
-    "@thi.ng/transducers": "^8.7.0"
+    "@thi.ng/random": "^3.6.5",
+    "@thi.ng/transducers": "^8.7.1"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.36.4",
@@ -275,5 +275,5 @@
     ],
     "year": 2015
   },
-  "gitHead": "b2ef5a1b8932d067af4ec2fc7da03d59d6868dc7\n"
+  "gitHead": "6323ad527d62cfbda1a22d921f34a9b6436ea297\n"
 }

package/pan.d.ts

@@ -0,0 +1,22 @@
+import type { IGen } from "./api.js";
+import { AProc } from "./aproc.js";
+import type { NumericArray } from "@thi.ng/api";
+/**
+ * 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 declare const pan: (pos?: number | IGen<number>) => Pan;
+export declare class Pan extends AProc<number, NumericArray> {
+    protected _pos: IGen<number>;
+    constructor(pos?: number | IGen<number>);
+    get pos(): number | IGen<number>;
+    set pos(pos: number | IGen<number>);
+    next(x: number): NumericArray;
+}
+//# sourceMappingURL=pan.d.ts.map

package/pan.js

@@ -0,0 +1,33 @@
+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 {
+    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];
+    }
+}

package/pipe.d.ts

@@ -1,7 +1,7 @@
 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}).
+ * a number of {@link IProc}s (processed in series, using {@link serial}).
  *
  * @param src -
  * @param proc -

package/pipe.js

@@ -1,22 +1,7 @@
 import { MapG1 } from "./mapg.js";
+import { serial } from "./serial.js";
 export function pipe(src, ...procs) {
-    let fn;
-    const [a, b, c, d] = procs;
-    switch (procs.length) {
-        case 1:
-            fn = (x) => a.next(x);
-            break;
-        case 2:
-            fn = (x) => b.next(a.next(x));
-            break;
-        case 3:
-            fn = (x) => c.next(b.next(a.next(x)));
-            break;
-        case 4:
-            fn = (x) => d.next(c.next(b.next(a.next(x))));
-            break;
-        default:
-            fn = (x) => procs.reduce((x, p) => p.next(x), x);
-    }
-    return new MapG1(fn, src, null);
+    // @ts-ignore
+    const proc = serial(...procs);
+    return new MapG1(proc.next.bind(proc), src, null);
 }

package/ref.d.ts

@@ -0,0 +1,16 @@
+import { AGen } from "./agen.js";
+import type { IGen, IProc } from "./api.js";
+import { AProc } from "./aproc.js";
+export declare const refG: <T>(src: IGen<T>) => RefG<T>;
+export declare class RefG<T> extends AGen<T> {
+    protected _src: IGen<T>;
+    constructor(_src: IGen<T>);
+    next(): T;
+}
+export declare const refP: <A, B>(src: IProc<A, B>) => RefP<A, B>;
+export declare class RefP<A, B> extends AProc<A, B> {
+    protected _src: IProc<A, B>;
+    constructor(_src: IProc<A, B>);
+    next(): B;
+}
+//# sourceMappingURL=ref.d.ts.map

package/ref.js

@@ -0,0 +1,22 @@
+import { AGen } from "./agen.js";
+import { AProc } from "./aproc.js";
+export const refG = (src) => new RefG(src);
+export 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 {
+    constructor(_src) {
+        super(_src.deref());
+        this._src = _src;
+    }
+    next() {
+        return this._src.deref();
+    }
+}

package/sincos.d.ts

@@ -1,4 +1,4 @@
-import type { IReset } from "@thi.ng/api";
+import type { ICopy, IReset } from "@thi.ng/api";
 import { AGen } from "./agen.js";
 /**
  * Generator of sine & cosine values of given frequency in the form of
@@ -17,13 +17,14 @@ import { AGen } from "./agen.js";
  * @param freq - normalized freq
  * @param amp - amplitude (default: 1)
  */
-export declare class SinCos extends AGen<number[]> implements IReset {
+export declare class SinCos extends AGen<number[]> implements ICopy<SinCos>, IReset {
     protected _freq: number;
     protected _amp: number;
     protected _f: number;
     protected _s: number;
     protected _c: number;
     constructor(_freq: number, _amp?: number);
+    copy(): SinCos;
     reset(): this;
     next(): number[];
     freq(): number;

package/sincos.js

@@ -24,6 +24,9 @@ export class SinCos extends AGen {
         this._amp = _amp;
         this.calcCoeffs();
     }
+    copy() {
+        return new SinCos(this._freq, this._amp);
+    }
     reset() {
         this.calcCoeffs();
         return this;