@thi.ng/dsp 4.7.33 → 4.7.34

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-05-08T18:24:31Z
+- **Last updated**: 2024-06-21T19:34:38Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,13 @@ 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.7.34](https://github.com/thi-ng/umbrella/tree/@thi.ng/dsp@4.7.34) (2024-06-21)
+
+#### ♻️ Refactoring
+
+- rename various rest args to be more semantically meaningful ([8088a56](https://github.com/thi-ng/umbrella/commit/8088a56))
+- enforce uniform naming convention of internal functions ([56992b2](https://github.com/thi-ng/umbrella/commit/56992b2))
+
 ### [4.7.30](https://github.com/thi-ng/umbrella/tree/@thi.ng/dsp@4.7.30) (2024-04-20)
 
 #### ♻️ Refactoring

package/README.md

@@ -7,7 +7,7 @@
 [![Mastodon Follow](https://img.shields.io/mastodon/follow/109331703950160316?domain=https%3A%2F%2Fmastodon.thi.ng&style=social)](https://mastodon.thi.ng/@toxi)
 
 > [!NOTE]
-> This is one of 192 standalone projects, maintained as part
+> This is one of 193 standalone projects, maintained as part
 > of the [@thi.ng/umbrella](https://github.com/thi-ng/umbrella/) monorepo
 > and anti-framework.
 >

package/adsr.d.ts

@@ -1,6 +1,7 @@
 import type { ICopy, IReset } from "@thi.ng/api";
 import { AGen } from "./agen.js";
 import type { IGen } from "./api.js";
+/** @internal */
 declare const enum EnvPhase {
     ATTACK = 0,
     DECAY = 1,

package/fft.js

@@ -33,7 +33,7 @@ function conjugate(src, isImg = true) {
     return dest;
   }
 }
-const swapR = (real, n) => {
+const __swapR = (real, n) => {
   const n2 = n >> 1;
   let ii;
   let jj;
@@ -55,7 +55,7 @@ const swapR = (real, n) => {
     j += k;
   }
 };
-const swapRI = (real, img, n) => {
+const __swapRI = (real, img, n) => {
   const n2 = n >> 1;
   let ii;
   let jj;
@@ -80,7 +80,7 @@ const swapRI = (real, img, n) => {
     j += k;
   }
 };
-const transform = (real, img, n) => {
+const __transform = (real, img, n) => {
   let step = 1;
   let prevStep;
   let i, j, ii, ip;
@@ -126,12 +126,12 @@ const fft = (complex, window) => {
   }
   const n = real.length;
   if (img) {
-    swapRI(real, img, n);
+    __swapRI(real, img, n);
   } else {
-    swapR(real, n);
+    __swapR(real, n);
     img = new Float64Array(n);
   }
-  transform(real, img, n);
+  __transform(real, img, n);
   return [real, img];
 };
 const ifft = (src) => {

package/filter-response.js

@@ -4,15 +4,15 @@ import { magDb } from "./convert.js";
 import { line } from "./line.js";
 const filterResponseRaw = (zeroes, poles, freq, db = true) => {
   const w0 = TAU * freq;
-  const [cp, sp] = convolve(poles, w0);
-  const [cz, sz] = convolve(zeroes, w0);
+  const [cp, sp] = __convolve(poles, w0);
+  const [cz, sz] = __convolve(zeroes, w0);
   const mag = Math.sqrt((cz * cz + sz * sz) / (cp * cp + sp * sp));
   const phase = Math.atan2(sp, cp) - Math.atan2(sz, cz);
   return { freq, phase, mag: db ? magDb(mag) : mag };
 };
 const filterResponse = (coeffs, freq, db) => filterResponseRaw(coeffs.zeroes, coeffs.poles, freq, db);
 const freqRange = (fstart, fend, num) => line(fstart, fend, num - 1).take(num);
-const convolve = (coeffs, w0) => {
+const __convolve = (coeffs, w0) => {
   let c = 0;
   let s = 0;
   for (let i = coeffs.length; i-- > 0; ) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/dsp",
-  "version": "4.7.33",
+  "version": "4.7.34",
   "description": "Composable signal generators, oscillators, filters, FFT, spectrum, windowing & related DSP utils",
   "type": "module",
   "module": "./index.js",
@@ -10,7 +10,7 @@
     "type": "git",
     "url": "https://github.com/thi-ng/umbrella.git"
   },
-  "homepage": "https://github.com/thi-ng/umbrella/tree/develop/packages/dsp#readme",
+  "homepage": "https://thi.ng/dsp",
   "funding": [
     {
       "type": "github",
@@ -37,18 +37,18 @@
     "tool:tangle": "../../node_modules/.bin/tangle src/**/*.ts"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.11.2",
-    "@thi.ng/checks": "^3.6.4",
-    "@thi.ng/errors": "^2.5.7",
-    "@thi.ng/math": "^5.10.13",
-    "@thi.ng/random": "^3.8.0",
-    "@thi.ng/transducers": "^9.0.5"
+    "@thi.ng/api": "^8.11.3",
+    "@thi.ng/checks": "^3.6.5",
+    "@thi.ng/errors": "^2.5.8",
+    "@thi.ng/math": "^5.11.0",
+    "@thi.ng/random": "^3.8.1",
+    "@thi.ng/transducers": "^9.0.6"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.43.2",
-    "esbuild": "^0.21.1",
+    "@microsoft/api-extractor": "^7.47.0",
+    "esbuild": "^0.21.5",
     "typedoc": "^0.25.13",
-    "typescript": "^5.4.5"
+    "typescript": "^5.5.2"
   },
   "keywords": [
     "allpass",
@@ -288,5 +288,5 @@
     ],
     "year": 2015
   },
-  "gitHead": "df34b4a9e650cc7323575356de207d78933bdcf3\n"
+  "gitHead": "154c95cf9d6bab32174498ec3b5b5d87e42be7f9\n"
 }

package/pipe.d.ts

@@ -10,5 +10,5 @@ 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>;
 export declare function pipe<A, B, C, D>(src: IGen<A>, a: IProc<A, B>, b: IProc<B, C>, c: IProc<C, D>): IGen<D>;
 export declare function pipe<A, B, C, D, E>(src: IGen<A>, a: IProc<A, B>, b: IProc<B, C>, c: IProc<C, D>, d: IProc<D, E>): IGen<E>;
-export declare function pipe<A, B, C, D, E>(src: IGen<A>, a: IProc<A, B>, b: IProc<B, C>, c: IProc<C, D>, d: IProc<D, E>, ...xs: IProc<any, any>[]): IGen<any>;
+export declare function pipe<A, B, C, D, E>(src: IGen<A>, a: IProc<A, B>, b: IProc<B, C>, c: IProc<C, D>, d: IProc<D, E>, ...procs: IProc<any, any>[]): IGen<any>;
 //# sourceMappingURL=pipe.d.ts.map

package/serial.d.ts

@@ -14,7 +14,7 @@ import { AProc } from "./aproc.js";
 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>;
 export declare function serial<A, B, C, D, E>(a: IProc<A, B>, b: IProc<B, C>, c: IProc<C, D>, d: IProc<D, E>): IProc<A, E>;
-export declare function serial<A, B, C, D, E>(a: IProc<A, B>, b: IProc<B, C>, c: IProc<C, D>, d: IProc<D, E>, ...xs: IProc<any, any>[]): IProc<A, any>;
+export declare function serial<A, B, C, D, E>(a: IProc<A, B>, b: IProc<B, C>, c: IProc<C, D>, d: IProc<D, E>, ...procs: IProc<any, any>[]): IProc<A, any>;
 export declare class Serial2<A, B, C> extends AProc<A, C> {
     protected _a: IProc<A, B>;
     protected _b: IProc<B, C>;

package/window.js

@@ -27,34 +27,34 @@ const windowLanczos = (i, n) => {
   i = PI * (2 * i / n - 1);
   return sin(i) / i;
 };
-const windowCosSum = (k) => {
+const __windowCosSum = (k) => {
   let ik = 1 - k;
   return (i, n) => k - ik * cos(TAU * i / n);
 };
-const windowCosSum3 = (k1, k2, k3) => (i, n) => {
+const __windowCosSum3 = (k1, k2, k3) => (i, n) => {
   i /= n;
   return k1 + k2 * cos(TAU * i) + k3 * cos(PI4 * i);
 };
-const windowCosSum4 = (k1, k2, k3, k4) => (i, n) => {
+const __windowCosSum4 = (k1, k2, k3, k4) => (i, n) => {
   i /= n;
   return k1 + k2 * cos(TAU * i) + k3 * cos(PI4 * i) + k4 * cos(PI6 * i);
 };
-const windowHann = windowCosSum(0.5);
-const windowHamming = windowCosSum(0.53836);
-const windowBlackman = windowCosSum3(0.42, -0.5, 0.08);
-const windowBlackmanHarris = windowCosSum4(
+const windowHann = __windowCosSum(0.5);
+const windowHamming = __windowCosSum(0.53836);
+const windowBlackman = __windowCosSum3(0.42, -0.5, 0.08);
+const windowBlackmanHarris = __windowCosSum4(
   0.35875,
   -0.48829,
   0.14128,
   0.01168
 );
-const windowNuttall = windowCosSum4(
+const windowNuttall = __windowCosSum4(
   0.355768,
   -0.487396,
   0.144232,
   -0.012604
 );
-const windowBlackmanNuttall = windowCosSum4(
+const windowBlackmanNuttall = __windowCosSum4(
   0.3635819,
   -0.4891775,
   0.1365995,