@thi.ng/dsp 3.0.28 → 4.0.0

package/CHANGELOG.md

@@ -3,181 +3,130 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
-## [3.0.28](https://github.com/thi-ng/umbrella/compare/@thi.ng/dsp@3.0.27...@thi.ng/dsp@3.0.28) (2021-08-17)
+# [4.0.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/dsp@3.0.31...@thi.ng/dsp@4.0.0) (2021-10-12)
 
-**Note:** Version bump only for package @thi.ng/dsp
 
+### Build System
 
+* major update of ALL pkgs (export maps, ESM only) ([0d1d6ea](https://github.com/thi-ng/umbrella/commit/0d1d6ea9fab2a645d6c5f2bf2591459b939c09b6))
 
 
+### Features
 
-## [3.0.27](https://github.com/thi-ng/umbrella/compare/@thi.ng/dsp@3.0.26...@thi.ng/dsp@3.0.27) (2021-08-08)
-
-**Note:** Version bump only for package @thi.ng/dsp
-
-
-
-
-
-## [3.0.26](https://github.com/thi-ng/umbrella/compare/@thi.ng/dsp@3.0.25...@thi.ng/dsp@3.0.26) (2021-08-08)
-
-**Note:** Version bump only for package @thi.ng/dsp
-
-
-
-
-
-## [3.0.25](https://github.com/thi-ng/umbrella/compare/@thi.ng/dsp@3.0.24...@thi.ng/dsp@3.0.25) (2021-08-08)
-
-**Note:** Version bump only for package @thi.ng/dsp
-
-
-
-
-
-## [3.0.24](https://github.com/thi-ng/umbrella/compare/@thi.ng/dsp@3.0.23...@thi.ng/dsp@3.0.24) (2021-08-04)
-
-**Note:** Version bump only for package @thi.ng/dsp
-
-
-
-
-
-## [3.0.23](https://github.com/thi-ng/umbrella/compare/@thi.ng/dsp@3.0.22...@thi.ng/dsp@3.0.23) (2021-08-04)
-
-**Note:** Version bump only for package @thi.ng/dsp
-
-
-
-
-
-## [3.0.22](https://github.com/thi-ng/umbrella/compare/@thi.ng/dsp@3.0.21...@thi.ng/dsp@3.0.22) (2021-07-27)
-
-**Note:** Version bump only for package @thi.ng/dsp
-
-
-
-
-
-## [3.0.21](https://github.com/thi-ng/umbrella/compare/@thi.ng/dsp@3.0.20...@thi.ng/dsp@3.0.21) (2021-07-01)
-
-**Note:** Version bump only for package @thi.ng/dsp
-
-
-
-
-
-## [3.0.20](https://github.com/thi-ng/umbrella/compare/@thi.ng/dsp@3.0.19...@thi.ng/dsp@3.0.20) (2021-06-08)
-
-**Note:** Version bump only for package @thi.ng/dsp
-
-
-
-
+* **dsp:** restructure/flatten /src folder, add ops ([c001e6f](https://github.com/thi-ng/umbrella/commit/c001e6f86bcb132323bde974a23cf1e69421142f))
 
-# [3.0.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/dsp@2.1.5...@thi.ng/dsp@3.0.0) (2020-12-22)
 
+### BREAKING CHANGES
 
-### Code Refactoring
+* **dsp:** restructure pkg, add/rename ops
 
-* **adjacency:** fix [#256](https://github.com/thi-ng/umbrella/issues/256) replace enums w/ type aliases ([b9cfacb](https://github.com/thi-ng/umbrella/commit/b9cfacbbb67fcb89d72090bdad512edaffa1adcf))
+- dissolve all subfolders
+- add bounce()
+- rename `compP()` => `serial()`
+- add docs
+* discontinue CommonJS & UMD versions
 
+- only ESM modules will be published from now on
+- CJS obsolete due to ESM support in recent versions of node:
+  - i.e. launch NodeJS via:
+  - `node --experimental-specifier-resolution=node --experimental-repl-await`
+  - in the node REPL use `await import(...)` instead of `require()`
+- UMD obsolete due to widespread browser support for ESM
 
-### Features
+Also:
+- normalize/restructure/reorg all package.json files
+- cleanup all build scripts, remove obsolete
+- switch from mocha to @thi.ng/testament for all tests
 
-* **dsp:** add applyWindow(), windowBartlett() ([d51a17c](https://github.com/thi-ng/umbrella/commit/d51a17c10dd6cbfbb69bb1cf09f46e59d2dd8ba2))
-* **dsp:** add cos() stateless oscillator ([276c6b7](https://github.com/thi-ng/umbrella/commit/276c6b76a6b69498f3b37c94fc34c4915b95b9b6))
-* **dsp:** add power & integral fns ([88edaac](https://github.com/thi-ng/umbrella/commit/88edaac0b93fb811738cbfd06d41063d8c4b9aff))
-* **dsp:** add windowWelch(), add docs ([84cd476](https://github.com/thi-ng/umbrella/commit/84cd4763a2a897d6b15b21b680fe2c8bd15c9d4a))
-* **dsp:** add/update power & integral fns ([f455fad](https://github.com/thi-ng/umbrella/commit/f455fad649394cd386839d983d8ae25895f9f1a2))
-* **dsp:** add/update various FFT & spectrum fns (fix [#258](https://github.com/thi-ng/umbrella/issues/258)) ([e351acb](https://github.com/thi-ng/umbrella/commit/e351acb98b1c776a6c8efe9ba910c2ec3b2df831))
 
 
-### BREAKING CHANGES
 
-* **adjacency:** replace filter type enums w/ type aliases
 
-- FilterType
-- BiquadType
-- SVFType
-- OnepoleType
-* **dsp:** new args for normalizeFFT(),denormalizeFFT(), spectrumPow()
 
-- add support for windowing adjustments in above functions
-- add thresholdFFT()
-- add copyComplex()
-- update various real/complex checks using isComplex()
-- update docs, add references
+#  [3.0.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/dsp@2.1.5...@thi.ng/dsp@3.0.0) (2020-12-22) 
 
+###  Code Refactoring 
 
+- **adjacency:** fix [#256](https://github.com/thi-ng/umbrella/issues/256) replace enums w/ type aliases ([b9cfacb](https://github.com/thi-ng/umbrella/commit/b9cfacbbb67fcb89d72090bdad512edaffa1adcf)) 
 
+###  Features 
 
+- **dsp:** add applyWindow(), windowBartlett() ([d51a17c](https://github.com/thi-ng/umbrella/commit/d51a17c10dd6cbfbb69bb1cf09f46e59d2dd8ba2)) 
+- **dsp:** add cos() stateless oscillator ([276c6b7](https://github.com/thi-ng/umbrella/commit/276c6b76a6b69498f3b37c94fc34c4915b95b9b6)) 
+- **dsp:** add power & integral fns ([88edaac](https://github.com/thi-ng/umbrella/commit/88edaac0b93fb811738cbfd06d41063d8c4b9aff)) 
+- **dsp:** add windowWelch(), add docs ([84cd476](https://github.com/thi-ng/umbrella/commit/84cd4763a2a897d6b15b21b680fe2c8bd15c9d4a)) 
+- **dsp:** add/update power & integral fns ([f455fad](https://github.com/thi-ng/umbrella/commit/f455fad649394cd386839d983d8ae25895f9f1a2)) 
+- **dsp:** add/update various FFT & spectrum fns (fix [#258](https://github.com/thi-ng/umbrella/issues/258)) ([e351acb](https://github.com/thi-ng/umbrella/commit/e351acb98b1c776a6c8efe9ba910c2ec3b2df831)) 
 
-# [2.1.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/dsp@2.0.28...@thi.ng/dsp@2.1.0) (2020-08-28)
+###  BREAKING CHANGES 
 
+- **adjacency:** replace filter type enums w/ type aliases 
+    - FilterType 
+    - BiquadType 
+    - SVFType 
+    - OnepoleType 
+- **dsp:** new args for normalizeFFT(),denormalizeFFT(), spectrumPow() 
+    - add support for windowing adjustments in above functions 
+    - add thresholdFFT() 
+    - add copyComplex() 
+    - update various real/complex checks using isComplex() 
+    - update docs, add references 
 
-### Features
+#  [2.1.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/dsp@2.0.28...@thi.ng/dsp@2.1.0) (2020-08-28) 
 
-* **dsp:** add iterable() wrapper ([94fb8ed](https://github.com/thi-ng/umbrella/commit/94fb8ed3a91ea45dcb53961a3b1c4a6a96cb2fb0))
+###  Features 
 
+- **dsp:** add iterable() wrapper ([94fb8ed](https://github.com/thi-ng/umbrella/commit/94fb8ed3a91ea45dcb53961a3b1c4a6a96cb2fb0)) 
 
+#  [2.0.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/dsp@1.0.18...@thi.ng/dsp@2.0.0) (2020-01-24) 
 
+###  Code Refactoring 
 
+- **dsp:** remove obsolete classes ([aa24c1e](https://github.com/thi-ng/umbrella/commit/aa24c1e4d9272f6ed468c011c00ab7c1b3e6c4f7)) 
 
-# [2.0.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/dsp@1.0.18...@thi.ng/dsp@2.0.0) (2020-01-24)
+###  Features 
 
-### Code Refactoring
+- **dsp:** add DelayLine ([bd25cd7](https://github.com/thi-ng/umbrella/commit/bd25cd7482d40ad21b713c6c6f7086458b5adbd0)) 
+- **dsp:** add fft, spectrum and window fns, add tests ([f918af4](https://github.com/thi-ng/umbrella/commit/f918af4e4169f75a0168098083e6b7fab4eba551)) 
+- **dsp:** add filters, refactor, update pkg/docs/readme ([7758609](https://github.com/thi-ng/umbrella/commit/775860996c09ea540d397702040ab4d53a338830)) 
+- **dsp:** add gen/proc composition ops, restructure ([8be2a5f](https://github.com/thi-ng/umbrella/commit/8be2a5f9fee18e2fdf7aefb48455b38511de5569)) 
+- **dsp:** add LFO sin/cos iterator/osc, minor refactor window fns ([dc89204](https://github.com/thi-ng/umbrella/commit/dc892043bb94b759ec04547b9194d8cfdbd9aa2f)) 
+- **dsp:** add missing factory fns, update docstrings ([3ede5af](https://github.com/thi-ng/umbrella/commit/3ede5af1c85564a4aa974f3a77c18a12f3bb6073)) 
+- **dsp:** add new operators ([68a88e4](https://github.com/thi-ng/umbrella/commit/68a88e4774979ef1a81149dd233324cdbc8b3787)) 
+- **dsp:** add sweep(), move curve(), minor refactor ([0b24d80](https://github.com/thi-ng/umbrella/commit/0b24d8035d8da716f14644c76b7768ba75b84189)) 
+- **dsp:** add/rename oscillators ([8a826bf](https://github.com/thi-ng/umbrella/commit/8a826bf0f0ead26e7da52ef79c911290942c80fb)) 
+- **dsp:** add/update FFT fns, test, update docs ([1ac9508](https://github.com/thi-ng/umbrella/commit/1ac95080da1da7d07212dcc65a1d97917c644d7f)) 
+- **dsp:** add/update filters, filter resp, delay ([2854b09](https://github.com/thi-ng/umbrella/commit/2854b096fdbe05f05b542c87a80bf08bb2b14ffe)) 
+- **dsp:** import gen & proc nodes, general pkg restructure ([a85c3cf](https://github.com/thi-ng/umbrella/commit/a85c3cf3c80c3714637fc4f3410742a88356f78f)) 
+- **dsp:** update ADSR, add ADSROpts, auto-release ([16f41ec](https://github.com/thi-ng/umbrella/commit/16f41ec4a60ea80ee9e544641f034491b7814754)) 
+- **dsp:** update all gens/procs, housekeeping, docs ([e483245](https://github.com/thi-ng/umbrella/commit/e483245d48b8ae0c74d93d1f2f2270a2379c642b)) 
+- **dsp:** update DelayLine ctor, freqBin, update pkg ([228a81e](https://github.com/thi-ng/umbrella/commit/228a81e951203e4e215de825d2474ec302290727)) 
+- **dsp:** update gens to support clamping ([fe8f6f3](https://github.com/thi-ng/umbrella/commit/fe8f6f347b9a9a618cfd30b95739f9400cc197d6)) 
 
-* **dsp:** remove obsolete classes ([aa24c1e](https://github.com/thi-ng/umbrella/commit/aa24c1e4d9272f6ed468c011c00ab7c1b3e6c4f7))
+###  BREAKING CHANGES 
 
-### Features
+- **dsp:** remove obsolete Oscillator/AMFMOscillator (superceded by osc()/modOsc()) 
 
-* **dsp:** add DelayLine ([bd25cd7](https://github.com/thi-ng/umbrella/commit/bd25cd7482d40ad21b713c6c6f7086458b5adbd0))
-* **dsp:** add fft, spectrum and window fns, add tests ([f918af4](https://github.com/thi-ng/umbrella/commit/f918af4e4169f75a0168098083e6b7fab4eba551))
-* **dsp:** add filters, refactor, update pkg/docs/readme ([7758609](https://github.com/thi-ng/umbrella/commit/775860996c09ea540d397702040ab4d53a338830))
-* **dsp:** add gen/proc composition ops, restructure ([8be2a5f](https://github.com/thi-ng/umbrella/commit/8be2a5f9fee18e2fdf7aefb48455b38511de5569))
-* **dsp:** add LFO sin/cos iterator/osc, minor refactor window fns ([dc89204](https://github.com/thi-ng/umbrella/commit/dc892043bb94b759ec04547b9194d8cfdbd9aa2f))
-* **dsp:** add missing factory fns, update docstrings ([3ede5af](https://github.com/thi-ng/umbrella/commit/3ede5af1c85564a4aa974f3a77c18a12f3bb6073))
-* **dsp:** add new operators ([68a88e4](https://github.com/thi-ng/umbrella/commit/68a88e4774979ef1a81149dd233324cdbc8b3787))
-* **dsp:** add sweep(), move curve(), minor refactor ([0b24d80](https://github.com/thi-ng/umbrella/commit/0b24d8035d8da716f14644c76b7768ba75b84189))
-* **dsp:** add/rename oscillators ([8a826bf](https://github.com/thi-ng/umbrella/commit/8a826bf0f0ead26e7da52ef79c911290942c80fb))
-* **dsp:** add/update FFT fns, test, update docs ([1ac9508](https://github.com/thi-ng/umbrella/commit/1ac95080da1da7d07212dcc65a1d97917c644d7f))
-* **dsp:** add/update filters, filter resp, delay ([2854b09](https://github.com/thi-ng/umbrella/commit/2854b096fdbe05f05b542c87a80bf08bb2b14ffe))
-* **dsp:** import gen & proc nodes, general pkg restructure ([a85c3cf](https://github.com/thi-ng/umbrella/commit/a85c3cf3c80c3714637fc4f3410742a88356f78f))
-* **dsp:** update ADSR, add ADSROpts, auto-release ([16f41ec](https://github.com/thi-ng/umbrella/commit/16f41ec4a60ea80ee9e544641f034491b7814754))
-* **dsp:** update all gens/procs, housekeeping, docs ([e483245](https://github.com/thi-ng/umbrella/commit/e483245d48b8ae0c74d93d1f2f2270a2379c642b))
-* **dsp:** update DelayLine ctor, freqBin, update pkg ([228a81e](https://github.com/thi-ng/umbrella/commit/228a81e951203e4e215de825d2474ec302290727))
-* **dsp:** update gens to support clamping ([fe8f6f3](https://github.com/thi-ng/umbrella/commit/fe8f6f347b9a9a618cfd30b95739f9400cc197d6))
+##  [1.0.10](https://github.com/thi-ng/umbrella/compare/@thi.ng/dsp@1.0.9...@thi.ng/dsp@1.0.10) (2019-04-26) 
 
-### BREAKING CHANGES
+###  Bug Fixes 
 
-* **dsp:** remove obsolete Oscillator/AMFMOscillator
-(superceded by osc()/modOsc())
+- **dsp:** fix tri() oscillator for negative phases ([c67c733](https://github.com/thi-ng/umbrella/commit/c67c733)) 
 
-## [1.0.10](https://github.com/thi-ng/umbrella/compare/@thi.ng/dsp@1.0.9...@thi.ng/dsp@1.0.10) (2019-04-26)
+#  [1.0.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/dsp@0.1.3...@thi.ng/dsp@1.0.0) (2019-01-21) 
 
-### Bug Fixes
+###  Build System 
 
-* **dsp:** fix tri() oscillator for negative phases ([c67c733](https://github.com/thi-ng/umbrella/commit/c67c733))
+- update package build scripts & outputs, imports in ~50 packages ([b54b703](https://github.com/thi-ng/umbrella/commit/b54b703)) 
 
-# [1.0.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/dsp@0.1.3...@thi.ng/dsp@1.0.0) (2019-01-21)
+###  BREAKING CHANGES 
 
-### Build System
-
-* update package build scripts & outputs, imports in ~50 packages ([b54b703](https://github.com/thi-ng/umbrella/commit/b54b703))
-
-### BREAKING CHANGES
+- enabled multi-outputs (ES6 modules, CJS, UMD) 
+- build scripts now first build ES6 modules in package root, then call   `scripts/bundle-module` to build minified CJS & UMD bundles in `/lib` 
+- all imports MUST be updated to only refer to package level   (not individual files anymore). tree shaking in user land will get rid of   all unused imported symbols. 
 
-* enabled multi-outputs (ES6 modules, CJS, UMD)
+#  0.1.0 (2018-10-17) 
 
-- build scripts now first build ES6 modules in package root, then call
-  `scripts/bundle-module` to build minified CJS & UMD bundles in `/lib`
-- all imports MUST be updated to only refer to package level
-  (not individual files anymore). tree shaking in user land will get rid of
-  all unused imported symbols.
-
-# 0.1.0 (2018-10-17)
-
-### Features
+###  Features 
 
-* **dsp:** add oscillators as [@thi](https://github.com/thi).ng/dsp package (from synstack / VEX) ([889730f](https://github.com/thi-ng/umbrella/commit/889730f))
+- **dsp:** add oscillators as [@thi](https://github.com/thi).ng/dsp package (from synstack / VEX) ([889730f](https://github.com/thi-ng/umbrella/commit/889730f))

package/README.md

@@ -69,15 +69,23 @@ might be ported to WASM.
 yarn add @thi.ng/dsp
 ```
 
+ES module import:
+
 ```html
-// ES module
-<script type="module" src="https://unpkg.com/@thi.ng/dsp?module" crossorigin></script>
+<script type="module" src="https://cdn.skypack.dev/@thi.ng/dsp"></script>
+```
+
+[Skypack documentation](https://docs.skypack.dev/)
+
+For NodeJS (v14.6+):
+
+```text
+node --experimental-specifier-resolution=node --experimental-repl-await
 
-// UMD
-<script src="https://unpkg.com/@thi.ng/dsp/lib/index.umd.js" crossorigin></script>
+> const dsp = await import("@thi.ng/dsp");
 ```
 
-Package sizes (gzipped, pre-treeshake): ESM: 6.99 KB / CJS: 7.51 KB / UMD: 6.94 KB
+Package sizes (gzipped, pre-treeshake): ESM: 7.43 KB
 
 ## Dependencies
 
@@ -96,12 +104,12 @@ directory are using this package.
 
 A selection:
 
-| Screenshot                                                                                                         | Description                                       | Live demo                                         | Source                                                                         |
-| ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------- | ------------------------------------------------- | ------------------------------------------------------------------------------ |
-| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/fft-synth.png" width="240"/>   | Interactive inverse FFT toy synth                 | [Demo](https://demo.thi.ng/umbrella/fft-synth/)   | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/fft-synth)   |
-| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/poly-spline.png" width="240"/> | Polygon to cubic curve conversion & visualization | [Demo](https://demo.thi.ng/umbrella/poly-spline/) | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/poly-spline) |
-| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/text-canvas.png" width="240"/> | 3D wireframe textmode demo                        | [Demo](https://demo.thi.ng/umbrella/text-canvas/) | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/text-canvas) |
-| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/webgl-ssao.jpg" width="240"/>  | WebGL screenspace ambient occlusion               | [Demo](https://demo.thi.ng/umbrella/webgl-ssao/)  | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/webgl-ssao)  |
+| Screenshot                                                                                                           | Description                                       | Live demo                                           | Source                                                                           |
+|:---------------------------------------------------------------------------------------------------------------------|:--------------------------------------------------|:----------------------------------------------------|:---------------------------------------------------------------------------------|
+| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/fft-synth.png" width="240"/>     | Interactive inverse FFT toy synth                 | [Demo](https://demo.thi.ng/umbrella/fft-synth/)     | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/fft-synth)     |
+| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/poly-spline.png" width="240"/>   | Polygon to cubic curve conversion & visualization | [Demo](https://demo.thi.ng/umbrella/poly-spline/)   | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/poly-spline)   |
+| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/webgl-cubemap.jpg" width="240"/> | WebGL cube maps with async texture loading        | [Demo](https://demo.thi.ng/umbrella/webgl-cubemap/) | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/webgl-cubemap) |
+| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/webgl-ssao.jpg" width="240"/>    | WebGL screenspace ambient occlusion               | [Demo](https://demo.thi.ng/umbrella/webgl-ssao/)    | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/webgl-ssao)    |
 
 ## API
 
@@ -175,36 +183,36 @@ import { take } from "@thi.ng/transducers";
 // ]
 ```
 
-- [add](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/gen/add.ts) - adder
-- [adsr](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/gen/add.ts) - timebased ADSR / AD envelope generator
-- [alt](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/gen/alt.ts) - alternating values
-- [constant](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/gen/const.ts) - constant value
-- [cosine](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/gen/cosp.ts) - trig-free cosine osc
-- [curve](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/gen/curve.ts) - timebased exponential gain/decay (factory for `madd`)
-- [impulse](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/gen/impulse.ts) - impulse gen
-- [impulseTrain](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/gen/impulse-train.ts) - timebased cyclic impulse
-- [line](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/gen/line.ts) - timebased line gen (factory for `add`)
-- [madd](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/gen/madd.ts) - multiply-adder
-- [mul](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/gen/mul.ts) - multiplier (exponential gain/decay)
-- [pinkNoise](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/gen/pink-noise.ts) - configurable pink noise (1/f power spectrum)
-- [reciprocal](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/gen/reciprocal.ts) - fractional sequence (1, 1/2, 1/3, 1/4 etc.)
-- [sincos](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/gen/sincos.ts) - trig-free sin/cos LFO
-- [sweep](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/gen/sweep.ts) - freq sweep gen w/ phase accumulation for oscillators
-- [whiteNoise](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/gen/pink-noise.ts) - white noise
+- [add](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/add.ts) - adder
+- [adsr](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/add.ts) - timebased ADSR / AD envelope generator
+- [alt](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/alt.ts) - alternating values
+- [constant](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/const.ts) - constant value
+- [cosine](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/cosp.ts) - trig-free cosine osc
+- [curve](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/curve.ts) - timebased exponential gain/decay (factory for `madd`)
+- [impulse](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/impulse.ts) - impulse gen
+- [impulseTrain](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/impulse-train.ts) - timebased cyclic impulse
+- [line](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/line.ts) - timebased line gen (factory for `add`)
+- [madd](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/madd.ts) - multiply-adder
+- [mul](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/mul.ts) - multiplier (exponential gain/decay)
+- [pinkNoise](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/pink-noise.ts) - configurable pink noise (1/f power spectrum)
+- [reciprocal](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/reciprocal.ts) - fractional sequence (1, 1/2, 1/3, 1/4 etc.)
+- [sincos](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/sincos.ts) - trig-free sin/cos LFO
+- [sweep](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/sweep.ts) - freq sweep gen w/ phase accumulation for oscillators
+- [whiteNoise](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/pink-noise.ts) - white noise
 
 #### Higher order generators
 
-- [mapG](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/comp/mapg.ts) - `IGen` composition / transformation (1-4 inputs)
-- [addG](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/comp/addg.ts) - higher-order adder
-- [product](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/comp/product.ts) - product of input gens
-- [sum](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/comp/sum.ts) - sum of input gens
+- [mapG](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/mapg.ts) - `IGen` composition / transformation (1-4 inputs)
+- [addG](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/addg.ts) - higher-order adder
+- [product](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/product.ts) - product of input gens
+- [sum](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/sum.ts) - sum of input gens
 
 #### Oscillators
 
 ##### IGen wrappers
 
-- [osc](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/gen/osc.ts) - arbitrary function oscillator w/ modulation support
-- [modOsc](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/gen/osc.ts) - FM / FMAM oscillator builder
+- [osc](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/osc.ts) - arbitrary function oscillator w/ modulation support
+- [modOsc](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/osc.ts) - FM / FMAM oscillator builder
 
 ```ts
 const FS = 44100;
@@ -238,17 +246,17 @@ Diagram of the FM/AM osc with some low pass filters applied:
 
 ##### Stateless oscillator functions
 
-- [additive](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/osc/additive.ts)
-- [dsf](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/osc/dsf.ts)
-- [mix](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/osc/mix.ts)
-- [parabolic](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/osc/parabolic.ts)
-- [rect](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/osc/rect.ts)
-- [saw](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/osc/saw.ts)
-- [sawAdditive](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/osc/additive.ts)
-- [squareAdditive](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/osc/additive.ts)
-- [sin](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/osc/sin.ts)
-- [tri](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/osc/tri.ts)
-- [wavetable](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/osc/wavetable.ts)
+- [additive](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/osc-additive.ts)
+- [dsf](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/osc-dsf.ts)
+- [mix](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/osc-mix.ts)
+- [parabolic](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/osc-parabolic.ts)
+- [rect](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/osc-rect.ts)
+- [saw](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/osc-saw.ts)
+- [sawAdditive](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/osc-additive.ts)
+- [squareAdditive](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/osc-additive.ts)
+- [sin](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/osc-sin.ts)
+- [tri](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/osc-tri.ts)
+- [wavetable](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/osc-wavetable.ts)
 
 ### IProc
 
@@ -319,9 +327,9 @@ The following filter types / functions are available:
 
 ##### 1-pole
 
-- [`onepoleLP`](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/proc/onepole.ts) - low pass, 6dB/oct falloff
-- [`dcBlock`](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/proc/dcblock.ts) - high pass, 6dB/oct falloff
-- [`allpass`](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/proc/allpass.ts) - allpass (-90° phase shift @ center freq)
+- [`onepoleLP`](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/onepole.ts) - low pass, 6dB/oct falloff
+- [`dcBlock`](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/dcblock.ts) - high pass, 6dB/oct falloff
+- [`allpass`](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/allpass.ts) - allpass (-90° phase shift @ center freq)
 
 Low pass:
 
@@ -337,7 +345,7 @@ Allpass:
 
 ##### Biquad
 
-[Source](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/proc/biquad.ts)
+[Source](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/biquad.ts)
 
 - `biquadLP` - low pass, 12dB/oct falloff, resonance
 - `biquadHP` - high pass, 12dB/oct falloff, resonance
@@ -379,7 +387,7 @@ High shelf (gain = -6dB):
 
 ##### State variable filter
 
-[Source](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/proc/biquad.ts)
+[Source](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/biquad.ts)
 
 - `svfLP` - low pass, resonance
 - `svfHP` - high pass, resonance
@@ -417,7 +425,7 @@ Allpass:
 #### Filter responses
 
 Using the [Filter response
-utils](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/util/filter-response.ts),
+utils](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/filter-response.ts),
 the following filter types can be evaluated for analyzing their impact
 on specific frequencies (or frequency bands). Any type implementing
 [`IFilter`](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/api.ts#L50)
@@ -460,7 +468,7 @@ Basic filter response plot:
 
 #### Delay
 
-[Source](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/proc/delay.ts)
+[Source](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/delay.ts)
 
 Ringbuffer / delay line for arbitrary values and support for single &
 multi-taps at any relative positions. Useful fundamental building block
@@ -468,14 +476,14 @@ for various other effects, filters etc.
 
 #### Feedback delay
 
-[Source](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/proc/feedback-delay.ts)
+[Source](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/feedback-delay.ts)
 
 Variation of `delay()` which adds a portion of the delayed value to each
 new input and stores result in delay line.
 
 #### Wave shaping
 
-[Source](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/proc/waveshaper.ts)
+[Source](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/waveshaper.ts)
 
 This operator remaps inputs via a user provided function. The following shaping functions are provided:
 
@@ -500,7 +508,7 @@ Sine:
 
 #### Foldback distortion
 
-[Source](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/proc/waveshaper.ts)
+[Source](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/waveshaper.ts)
 
 Recursively folds input into `[-thresh .. +thresh]` interval and amplifies it with `amp` (default: 1/thresh).
 
@@ -511,7 +519,7 @@ Desmos](https://www.desmos.com/calculator/lkyf2ag3ta) to experiment.
 
 ### FFT
 
-[Source](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/fft/fft.ts)
+[Source](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/fft.ts)
 
 - `fft()`
 - `ifft()`
@@ -534,7 +542,7 @@ Desmos](https://www.desmos.com/calculator/lkyf2ag3ta) to experiment.
 
 #### Window functions
 
-[Source](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/fft/window.ts)
+[Source](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/window.ts)
 
 - `window()`
 - `applyWindow()`
@@ -554,8 +562,8 @@ Desmos](https://www.desmos.com/calculator/lkyf2ag3ta) to experiment.
 
 ### Utilities
 
-- [Unit conversions](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/util/convert.ts)
-- [Filter response](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/util/filter-response.ts)
+- [Unit conversions](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/convert.ts)
+- [Filter response](https://github.com/thi-ng/umbrella/blob/develop/packages/dsp/src/filter-response.ts)
 
 ## Authors
 

package/{gen/add.d.ts → add.d.ts}

@@ -1,8 +1,10 @@
 import type { IReset } from "@thi.ng/api";
 import { AGen } from "./agen";
 /**
- * Creates a new `Add` gen using given `step` (default: 1) and `start
- * (default: 0) values, producing: `y(t) = step + y(t-1)`.
+ * Creates a new `Add` gen using given `step` (default: 1.0) and `start`
+ * (default: 0.0) values, producing: `y(t) = step + y(t-1)`. If `clamp` is
+ * given, the resulting output will be clamped to that value (min or max depends
+ * on sign of `start - clamp`).
  *
  * @param step
  * @param start

package/{gen/add.js → add.js}

@@ -1,7 +1,9 @@
 import { AGen } from "./agen";
 /**
- * Creates a new `Add` gen using given `step` (default: 1) and `start
- * (default: 0) values, producing: `y(t) = step + y(t-1)`.
+ * Creates a new `Add` gen using given `step` (default: 1.0) and `start`
+ * (default: 0.0) values, producing: `y(t) = step + y(t-1)`. If `clamp` is
+ * given, the resulting output will be clamped to that value (min or max depends
+ * on sign of `start - clamp`).
  *
  * @param step
  * @param start
@@ -9,6 +11,9 @@ import { AGen } from "./agen";
  */
 export const add = (step, start, clamp) => new Add(step, start, clamp);
 export class Add extends AGen {
+    _step;
+    _start;
+    _clamp;
     constructor(_step = 1, _start = 0, _clamp) {
         super(0);
         this._step = _step;

package/{comp/addg.d.ts → addg.d.ts}

@@ -1,4 +1,4 @@
-import type { IGen } from "../api";
+import type { IGen } from "./api";
 /**
  * Creates a new {@link IGen} using given `step` gen and `start
  * (default: 0) value, producing: `y(t) = step(t) + y(t-1)`.

package/{gen/adsr.d.ts → adsr.d.ts}

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

package/{gen/adsr.js → adsr.js}

@@ -1,4 +1,4 @@
-import { clamp01 } from "@thi.ng/math";
+import { clamp01 } from "@thi.ng/math/interval";
 import { add } from "./add";
 import { AGen } from "./agen";
 import { curve } from "./curve";
@@ -36,9 +36,29 @@ var EnvPhase;
  */
 export const adsr = (opts) => new ADSR(opts);
 export class ADSR extends AGen {
+    _phase;
+    _curve;
+    _atime;
+    _dtime;
+    _rtime;
+    _acurve;
+    _dcurve;
+    _sustain;
+    _speriod;
+    _gain;
     constructor(opts) {
         super(0);
-        opts = Object.assign({ a: 0, d: 0, s: 1, r: 0, acurve: 0.1, dcurve: 0.001, slen: Infinity, gain: 1 }, opts);
+        opts = {
+            a: 0,
+            d: 0,
+            s: 1,
+            r: 0,
+            acurve: 0.1,
+            dcurve: 0.001,
+            slen: Infinity,
+            gain: 1,
+            ...opts,
+        };
         this.setAttack(opts.a);
         this.setDecay(opts.d);
         this.setRelease(opts.r);

package/{gen/agen.d.ts → agen.d.ts}

@@ -1,4 +1,4 @@
-import type { IGen } from "../api";
+import type { IGen } from "./api";
 /**
  * Abstract base class for unit gens in this package. Provides
  * {@link @thi.ng/api#IDeref} to obtain the gen's current value and

package/{gen/agen.js → agen.js}

@@ -1,9 +1,11 @@
+import { __take } from "./internal/take";
 /**
  * Abstract base class for unit gens in this package. Provides
  * {@link @thi.ng/api#IDeref} to obtain the gen's current value and
  * `Iterable` implementations to use gens as ES6 iterables.
  */
 export class AGen {
+    _val;
     constructor(_val) {
         this._val = _val;
     }
@@ -15,9 +17,6 @@ export class AGen {
             yield this.next();
     }
     take(num, out = [], idx = 0) {
-        for (; --num >= 0;) {
-            out[idx++] = this.next();
-        }
-        return out;
+        return __take(this, num, out, idx);
     }
 }