@thi.ng/shader-ast-js 0.7.67 → 1.0.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2023-08-12T13:14:08Z
+- **Last updated**: 2023-08-14T13:30:45Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,30 @@ 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.
 
+# [1.0.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/shader-ast-js@1.0.0) (2023-08-14)
+
+#### 🛑 Breaking changes
+
+- update renderPixels(), renderBuffer() ([5b2fe9d](https://github.com/thi-ng/umbrella/commit/5b2fe9d))
+- BREAKING CHANGES: replace render functions args with options object
+  - add RenderPixelOpts
+  - update renderPixels()/renderBuffer() to support arbitrary integer pixel formats
+  - add/expose color conversion fns:
+    - rgbaBgra8888() for 32bit targets
+    - rgbaRgb565() for 16bit targets
+
+#### 🚀 Features
+
+- add vector pools for all vector ops ([31271e7](https://github.com/thi-ng/umbrella/commit/31271e7))
+  - add Pool class and impls for [iu]vec2/3/4
+  - update all vector ops to re-use memory from pools
+  - add CompileResult interface w/ `__reset()` and `__stats()` methods
+  - update targetJS() codegens
+
+#### ♻️ Refactoring
+
+- update/extend vector pool handling ([1c22d0c](https://github.com/thi-ng/umbrella/commit/1c22d0c))
+
 ### [0.7.64](https://github.com/thi-ng/umbrella/tree/@thi.ng/shader-ast-js@0.7.64) (2023-08-04)
 
 #### ♻️ Refactoring

package/README.md

@@ -76,7 +76,7 @@ For Node.js REPL:
 const shaderAstJs = await import("@thi.ng/shader-ast-js");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 5.46 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 6.27 KB
 
 ## Dependencies
 
@@ -97,14 +97,15 @@ directory are using this package.
 
 A selection:
 
-| Screenshot                                                                                                                   | Description                                            | Live demo                                                 | Source                                                                                 |
-|:-----------------------------------------------------------------------------------------------------------------------------|:-------------------------------------------------------|:----------------------------------------------------------|:---------------------------------------------------------------------------------------|
-| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/shader-ast/shader-ast-01.jpg" width="240"/>       | 2D canvas shader emulation                             | [Demo](https://demo.thi.ng/umbrella/shader-ast-canvas2d/) | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/shader-ast-canvas2d) |
-| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/shader-ast-noise.jpg" width="240"/>      | HOF shader procedural noise function composition       | [Demo](https://demo.thi.ng/umbrella/shader-ast-noise/)    | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/shader-ast-noise)    |
-| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/shader-ast/shader-ast-raymarch.jpg" width="240"/> | WebGL & JS canvas2D raymarch shader cross-compilation  | [Demo](https://demo.thi.ng/umbrella/shader-ast-raymarch/) | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/shader-ast-raymarch) |
-| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/shader-ast-sdf2d.jpg" width="240"/>      | WebGL & JS canvas 2D SDF                               | [Demo](https://demo.thi.ng/umbrella/shader-ast-sdf2d/)    | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/shader-ast-sdf2d)    |
-| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/shader-ast-tunnel.jpg" width="240"/>     | WebGL & Canvas2D textured tunnel shader                | [Demo](https://demo.thi.ng/umbrella/shader-ast-tunnel/)   | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/shader-ast-tunnel)   |
-| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/shader-ast-workers.jpg" width="240"/>    | Fork-join worker-based raymarch renderer (JS/CPU only) | [Demo](https://demo.thi.ng/umbrella/shader-ast-workers/)  | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/shader-ast-workers)  |
+| Screenshot                                                                                                                   | Description                                                       | Live demo                                                 | Source                                                                                 |
+|:-----------------------------------------------------------------------------------------------------------------------------|:------------------------------------------------------------------|:----------------------------------------------------------|:---------------------------------------------------------------------------------------|
+| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/ascii-raymarch.jpg" width="240"/>        | ASCII art raymarching with thi.ng/shader-ast & thi.ng/text-canvas | [Demo](https://demo.thi.ng/umbrella/ascii-raymarch/)      | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/ascii-raymarch)      |
+| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/shader-ast/shader-ast-01.jpg" width="240"/>       | 2D canvas shader emulation                                        | [Demo](https://demo.thi.ng/umbrella/shader-ast-canvas2d/) | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/shader-ast-canvas2d) |
+| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/shader-ast-noise.jpg" width="240"/>      | HOF shader procedural noise function composition                  | [Demo](https://demo.thi.ng/umbrella/shader-ast-noise/)    | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/shader-ast-noise)    |
+| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/shader-ast/shader-ast-raymarch.jpg" width="240"/> | WebGL & JS canvas2D raymarch shader cross-compilation             | [Demo](https://demo.thi.ng/umbrella/shader-ast-raymarch/) | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/shader-ast-raymarch) |
+| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/shader-ast-sdf2d.jpg" width="240"/>      | WebGL & JS canvas 2D SDF                                          | [Demo](https://demo.thi.ng/umbrella/shader-ast-sdf2d/)    | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/shader-ast-sdf2d)    |
+| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/shader-ast-tunnel.jpg" width="240"/>     | WebGL & Canvas2D textured tunnel shader                           | [Demo](https://demo.thi.ng/umbrella/shader-ast-tunnel/)   | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/shader-ast-tunnel)   |
+| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/shader-ast-workers.jpg" width="240"/>    | Fork-join worker-based raymarch renderer (JS/CPU only)            | [Demo](https://demo.thi.ng/umbrella/shader-ast-workers/)  | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/shader-ast-workers)  |
 
 ## API
 

package/api.d.ts

@@ -1,7 +1,8 @@
-import type { Fn, Fn2, Fn3, Fn4, Fn5, Fn6 } from "@thi.ng/api";
+import type { Fn, Fn0, Fn2, Fn3, Fn4, Fn5, Fn6, Keys } from "@thi.ng/api";
 import type { Mat } from "@thi.ng/matrices";
 import type { Term } from "@thi.ng/shader-ast";
 import type { BVec, Vec } from "@thi.ng/vectors";
+import type { Pool } from "./pool.js";
 export interface JSTarget extends Fn<Term<any>, string> {
     /**
      * Compiles given AST to JavaScript, using optional `env` as backend for
@@ -31,7 +32,21 @@ export interface JSTarget extends Fn<Term<any>, string> {
      * @param tree -
      * @param env -
      */
-    compile(tree: Term<any>, env?: JSEnv): any;
+    compile(tree: Term<any>, env?: JSEnv): CompileResult;
+}
+export interface CompileResult {
+    /**
+     * Resets all internal vector pools. Will be called automatically if
+     * compiled tree includes a `main()` function, otherwise **MUST** be called
+     * manually each time before invoking a compiled entry point function.
+     */
+    __reset: Fn0<void>;
+    /**
+     * Returns an object summarizing the number of used objects in each vector
+     * pool.
+     */
+    __stats: Fn0<Record<Keys<JSEnv["pools"]>, number>>;
+    [id: string]: any;
 }
 export interface JSBuiltinsCommon<T> {
     abs: Fn<T, T>;
@@ -218,6 +233,17 @@ export interface JSEnv {
     samplerCube: JSBuiltinsSampler;
     sampler2DShadow: JSBuiltinsSampler;
     samplerCubeShadow: JSBuiltinsSampler;
+    pools: {
+        vec2: Pool;
+        vec3: Pool;
+        vec4: Pool;
+        ivec2: Pool;
+        ivec3: Pool;
+        ivec4: Pool;
+        uvec2: Pool;
+        uvec3: Pool;
+        uvec4: Pool;
+    };
 }
 export interface JSTargetOpts {
     /**

package/env/ivec2.js

@@ -10,28 +10,30 @@ import { lshiftI2 } from "@thi.ng/vectors/lshift";
 import { mulI2, mulNI2 } from "@thi.ng/vectors/muli";
 import { rshiftI2 } from "@thi.ng/vectors/rshift";
 import { subI2, subNI2 } from "@thi.ng/vectors/subi";
+import { POOL_IVEC2 } from "../pool.js";
 import { VEC2 } from "./vec2.js";
+const { next, uniform } = POOL_IVEC2;
 export const IVEC2 = {
-    ...VEC2,
-    add: (a, b) => addI2([], a, b),
-    addvn: (a, b) => addNI2([], a, b),
-    addnv: (a, b) => addNI2([], b, a),
-    div: (a, b) => divI2([], a, b),
-    divvn: (a, b) => divNI2([], a, b),
-    divnv: (a, b) => divI2(null, [a, a], b),
-    modi: (a, b) => fmod2([], a, b),
-    modivn: (a, b) => fmodN2([], a, b),
-    modinv: (a, b) => fmod2(null, [a, a], b),
-    mul: (a, b) => mulI2([], a, b),
-    mulvn: (a, b) => mulNI2([], a, b),
-    mulnv: (a, b) => mulNI2([], b, a),
-    sub: (a, b) => subI2([], a, b),
-    subvn: (a, b) => subNI2([], a, b),
-    subnv: (a, b) => subI2(null, [a, a], b),
-    bitand: (a, b) => bitAndI2([], a, b),
-    lshift: (a, b) => lshiftI2([], a, b),
-    bitnot1: (a) => bitNotI2([], a),
-    bitor: (a, b) => bitOrI2([], a, b),
-    rshift: (a, b) => rshiftI2([], a, b),
-    bitxor: (a, b) => bitXorI2([], a, b),
+    ...VEC2(POOL_IVEC2),
+    add: (a, b) => addI2(next(), a, b),
+    addvn: (a, b) => addNI2(next(), a, b),
+    addnv: (a, b) => addNI2(next(), b, a),
+    div: (a, b) => divI2(next(), a, b),
+    divvn: (a, b) => divNI2(next(), a, b),
+    divnv: (a, b) => divI2(null, uniform(a), b),
+    modi: (a, b) => fmod2(next(), a, b),
+    modivn: (a, b) => fmodN2(next(), a, b),
+    modinv: (a, b) => fmod2(null, uniform(a), b),
+    mul: (a, b) => mulI2(next(), a, b),
+    mulvn: (a, b) => mulNI2(next(), a, b),
+    mulnv: (a, b) => mulNI2(next(), b, a),
+    sub: (a, b) => subI2(next(), a, b),
+    subvn: (a, b) => subNI2(next(), a, b),
+    subnv: (a, b) => subI2(null, uniform(a), b),
+    bitand: (a, b) => bitAndI2(next(), a, b),
+    lshift: (a, b) => lshiftI2(next(), a, b),
+    bitnot1: (a) => bitNotI2(next(), a),
+    bitor: (a, b) => bitOrI2(next(), a, b),
+    rshift: (a, b) => rshiftI2(next(), a, b),
+    bitxor: (a, b) => bitXorI2(next(), a, b),
 };

package/env/ivec3.js

@@ -10,28 +10,30 @@ import { lshiftI3 } from "@thi.ng/vectors/lshift";
 import { mulI3, mulNI3 } from "@thi.ng/vectors/muli";
 import { rshiftI3 } from "@thi.ng/vectors/rshift";
 import { subI3, subNI3 } from "@thi.ng/vectors/subi";
+import { POOL_IVEC3 } from "../pool.js";
 import { VEC3 } from "./vec3.js";
+const { next, uniform } = POOL_IVEC3;
 export const IVEC3 = {
-    ...VEC3,
-    add: (a, b) => addI3([], a, b),
-    addvn: (a, b) => addNI3([], a, b),
-    addnv: (a, b) => addNI3([], b, a),
-    div: (a, b) => divI3([], a, b),
-    divvn: (a, b) => divNI3([], a, b),
-    divnv: (a, b) => divI3(null, [a, a, a], b),
-    modi: (a, b) => fmod3([], a, b),
-    modivn: (a, b) => fmodN3([], a, b),
-    modinv: (a, b) => fmod3(null, [a, a, a], b),
-    mul: (a, b) => mulI3([], a, b),
-    mulvn: (a, b) => mulNI3([], a, b),
-    mulnv: (a, b) => mulNI3([], b, a),
-    sub: (a, b) => subI3([], a, b),
-    subvn: (a, b) => subNI3([], a, b),
-    subnv: (a, b) => subI3(null, [a, a, a], b),
-    bitand: (a, b) => bitAndI3([], a, b),
-    lshift: (a, b) => lshiftI3([], a, b),
-    bitnot1: (a) => bitNotI3([], a),
-    bitor: (a, b) => bitOrI3([], a, b),
-    rshift: (a, b) => rshiftI3([], a, b),
-    bitxor: (a, b) => bitXorI3([], a, b),
+    ...VEC3(POOL_IVEC3),
+    add: (a, b) => addI3(next(), a, b),
+    addvn: (a, b) => addNI3(next(), a, b),
+    addnv: (a, b) => addNI3(next(), b, a),
+    div: (a, b) => divI3(next(), a, b),
+    divvn: (a, b) => divNI3(next(), a, b),
+    divnv: (a, b) => divI3(null, uniform(a), b),
+    modi: (a, b) => fmod3(next(), a, b),
+    modivn: (a, b) => fmodN3(next(), a, b),
+    modinv: (a, b) => fmod3(null, uniform(a), b),
+    mul: (a, b) => mulI3(next(), a, b),
+    mulvn: (a, b) => mulNI3(next(), a, b),
+    mulnv: (a, b) => mulNI3(next(), b, a),
+    sub: (a, b) => subI3(next(), a, b),
+    subvn: (a, b) => subNI3(next(), a, b),
+    subnv: (a, b) => subI3(null, uniform(a), b),
+    bitand: (a, b) => bitAndI3(next(), a, b),
+    lshift: (a, b) => lshiftI3(next(), a, b),
+    bitnot1: (a) => bitNotI3(next(), a),
+    bitor: (a, b) => bitOrI3(next(), a, b),
+    rshift: (a, b) => rshiftI3(next(), a, b),
+    bitxor: (a, b) => bitXorI3(next(), a, b),
 };

package/env/ivec4.js

@@ -10,28 +10,30 @@ import { lshiftI4 } from "@thi.ng/vectors/lshift";
 import { mulI4, mulNI4 } from "@thi.ng/vectors/muli";
 import { rshiftI4 } from "@thi.ng/vectors/rshift";
 import { subI4, subNI4 } from "@thi.ng/vectors/subi";
+import { POOL_IVEC4 } from "../pool.js";
 import { VEC4 } from "./vec4.js";
+const { next, uniform } = POOL_IVEC4;
 export const IVEC4 = {
-    ...VEC4,
-    add: (a, b) => addI4([], a, b),
-    addvn: (a, b) => addNI4([], a, b),
-    addnv: (a, b) => addNI4([], b, a),
-    div: (a, b) => divI4([], a, b),
-    divvn: (a, b) => divNI4([], a, b),
-    divnv: (a, b) => divI4(null, [a, a, a, a], b),
-    modi: (a, b) => fmod4([], a, b),
-    modivn: (a, b) => fmodN4([], a, b),
-    modinv: (a, b) => fmod4(null, [a, a, a, a], b),
-    mul: (a, b) => mulI4([], a, b),
-    mulvn: (a, b) => mulNI4([], a, b),
-    mulnv: (a, b) => mulNI4([], b, a),
-    sub: (a, b) => subI4([], a, b),
-    subvn: (a, b) => subNI4([], a, b),
-    subnv: (a, b) => subI4(null, [a, a, a, a], b),
-    bitand: (a, b) => bitAndI4([], a, b),
-    lshift: (a, b) => lshiftI4([], a, b),
-    bitnot1: (a) => bitNotI4([], a),
-    bitor: (a, b) => bitOrI4([], a, b),
-    rshift: (a, b) => rshiftI4([], a, b),
-    bitxor: (a, b) => bitXorI4([], a, b),
+    ...VEC4(POOL_IVEC4),
+    add: (a, b) => addI4(next(), a, b),
+    addvn: (a, b) => addNI4(next(), a, b),
+    addnv: (a, b) => addNI4(next(), b, a),
+    div: (a, b) => divI4(next(), a, b),
+    divvn: (a, b) => divNI4(next(), a, b),
+    divnv: (a, b) => divI4(null, uniform(a), b),
+    modi: (a, b) => fmod4(next(), a, b),
+    modivn: (a, b) => fmodN4(next(), a, b),
+    modinv: (a, b) => fmod4(null, uniform(a), b),
+    mul: (a, b) => mulI4(next(), a, b),
+    mulvn: (a, b) => mulNI4(next(), a, b),
+    mulnv: (a, b) => mulNI4(next(), b, a),
+    sub: (a, b) => subI4(next(), a, b),
+    subvn: (a, b) => subNI4(next(), a, b),
+    subnv: (a, b) => subI4(null, uniform(a), b),
+    bitand: (a, b) => bitAndI4(next(), a, b),
+    lshift: (a, b) => lshiftI4(next(), a, b),
+    bitnot1: (a) => bitNotI4(next(), a),
+    bitor: (a, b) => bitOrI4(next(), a, b),
+    rshift: (a, b) => rshiftI4(next(), a, b),
+    bitxor: (a, b) => bitXorI4(next(), a, b),
 };

package/env/mat2.js

@@ -10,24 +10,26 @@ import { mulVM22 } from "@thi.ng/matrices/mulvm";
 import { sub22 } from "@thi.ng/matrices/sub";
 import { subN22 } from "@thi.ng/matrices/subn";
 import { neg } from "@thi.ng/vectors/neg";
+import { POOL_VEC4 } from "../pool.js";
+const { next, uniform } = POOL_VEC4;
 export const MAT2 = {
-    add: (a, b) => add22([], a, b),
-    addnv: (a, b) => addN22([], b, a),
-    addvn: (a, b) => addN22([], a, b),
-    dec: (a) => subN22([], a, 1),
-    div: (a, b) => div22([], a, b),
-    divnv: (a, b) => div22(null, [a, a, a, a], b),
-    divvn: (a, b) => divN22([], a, b),
+    add: (a, b) => add22(next(), a, b),
+    addnv: (a, b) => addN22(next(), b, a),
+    addvn: (a, b) => addN22(next(), a, b),
+    dec: (a) => subN22(next(), a, 1),
+    div: (a, b) => div22(next(), a, b),
+    divnv: (a, b) => div22(null, uniform(a), b),
+    divvn: (a, b) => divN22(next(), a, b),
     idx: (a, b) => [a[b * 2], a[b * 2 + 1]],
-    inc: (a) => addN22([], a, 1),
-    mul: (a, b) => mul22([], a, b),
-    mulm: (a, b) => mulM22([], a, b),
-    mulmv: (a, b) => mulV22([], a, b),
-    mulnv: (a, b) => mulN22([], b, a),
-    mulvm: (a, b) => mulVM22([], a, b),
-    mulvn: (a, b) => mulN22([], a, b),
-    sub: (a, b) => sub22([], a, b),
-    sub1: (a) => neg([], a),
-    subnv: (a, b) => sub22(null, [a, a, a, a], b),
-    subvn: (a, b) => subN22([], a, b),
+    inc: (a) => addN22(next(), a, 1),
+    mul: (a, b) => mul22(next(), a, b),
+    mulm: (a, b) => mulM22(next(), a, b),
+    mulmv: (a, b) => mulV22(next(), a, b),
+    mulnv: (a, b) => mulN22(next(), b, a),
+    mulvm: (a, b) => mulVM22(next(), a, b),
+    mulvn: (a, b) => mulN22(next(), a, b),
+    sub: (a, b) => sub22(next(), a, b),
+    sub1: (a) => neg(next(), a),
+    subnv: (a, b) => sub22(null, uniform(a), b),
+    subvn: (a, b) => subN22(next(), a, b),
 };

package/env/uvec2.js

@@ -10,28 +10,30 @@ import { lshiftU2 } from "@thi.ng/vectors/lshift";
 import { mulNU2, mulU2 } from "@thi.ng/vectors/muli";
 import { rshiftU2 } from "@thi.ng/vectors/rshift";
 import { subNU2, subU2 } from "@thi.ng/vectors/subi";
+import { POOL_UVEC2 } from "../pool.js";
 import { VEC2 } from "./vec2.js";
+const { next, uniform } = POOL_UVEC2;
 export const UVEC2 = {
-    ...VEC2,
-    add: (a, b) => addU2([], a, b),
-    addvn: (a, b) => addNU2([], a, b),
-    addnv: (a, b) => addNU2([], b, a),
-    div: (a, b) => divU2([], a, b),
-    divvn: (a, b) => divNU2([], a, b),
-    divnv: (a, b) => divU2(null, [a, a], b),
-    modi: (a, b) => fmod2([], a, b),
-    modivn: (a, b) => fmodN2([], a, b),
-    modinv: (a, b) => fmod2(null, [a, a], b),
-    mul: (a, b) => mulU2([], a, b),
-    mulvn: (a, b) => mulNU2([], a, b),
-    mulnv: (a, b) => mulNU2([], b, a),
-    sub: (a, b) => subU2([], a, b),
-    subvn: (a, b) => subNU2([], a, b),
-    subnv: (a, b) => subU2(null, [a, a], b),
-    bitand: (a, b) => bitAndU2([], a, b),
-    lshift: (a, b) => lshiftU2([], a, b),
-    bitnot1: (a) => bitNotU2([], a),
-    bitor: (a, b) => bitOrU2([], a, b),
-    rshift: (a, b) => rshiftU2([], a, b),
-    bitxor: (a, b) => bitXorU2([], a, b),
+    ...VEC2(POOL_UVEC2),
+    add: (a, b) => addU2(next(), a, b),
+    addvn: (a, b) => addNU2(next(), a, b),
+    addnv: (a, b) => addNU2(next(), b, a),
+    div: (a, b) => divU2(next(), a, b),
+    divvn: (a, b) => divNU2(next(), a, b),
+    divnv: (a, b) => divU2(null, uniform(a), b),
+    modi: (a, b) => fmod2(next(), a, b),
+    modivn: (a, b) => fmodN2(next(), a, b),
+    modinv: (a, b) => fmod2(null, uniform(a), b),
+    mul: (a, b) => mulU2(next(), a, b),
+    mulvn: (a, b) => mulNU2(next(), a, b),
+    mulnv: (a, b) => mulNU2(next(), b, a),
+    sub: (a, b) => subU2(next(), a, b),
+    subvn: (a, b) => subNU2(next(), a, b),
+    subnv: (a, b) => subU2(null, uniform(a), b),
+    bitand: (a, b) => bitAndU2(next(), a, b),
+    lshift: (a, b) => lshiftU2(next(), a, b),
+    bitnot1: (a) => bitNotU2(next(), a),
+    bitor: (a, b) => bitOrU2(next(), a, b),
+    rshift: (a, b) => rshiftU2(next(), a, b),
+    bitxor: (a, b) => bitXorU2(next(), a, b),
 };

package/env/uvec3.js

@@ -10,28 +10,30 @@ import { lshiftU3 } from "@thi.ng/vectors/lshift";
 import { mulNU3, mulU3 } from "@thi.ng/vectors/muli";
 import { rshiftU3 } from "@thi.ng/vectors/rshift";
 import { subNU3, subU3 } from "@thi.ng/vectors/subi";
+import { POOL_UVEC3 } from "../pool.js";
 import { VEC3 } from "./vec3.js";
+const { next, uniform } = POOL_UVEC3;
 export const UVEC3 = {
-    ...VEC3,
-    add: (a, b) => addU3([], a, b),
-    addvn: (a, b) => addNU3([], a, b),
-    addnv: (a, b) => addNU3([], b, a),
-    div: (a, b) => divU3([], a, b),
-    divvn: (a, b) => divNU3([], a, b),
-    divnv: (a, b) => divU3(null, [a, a, a], b),
-    modi: (a, b) => fmod3([], a, b),
-    modivn: (a, b) => fmodN3([], a, b),
-    modinv: (a, b) => fmod3(null, [a, a, a], b),
-    mul: (a, b) => mulU3([], a, b),
-    mulvn: (a, b) => mulNU3([], a, b),
-    mulnv: (a, b) => mulNU3([], b, a),
-    sub: (a, b) => subU3([], a, b),
-    subvn: (a, b) => subNU3([], a, b),
-    subnv: (a, b) => subU3(null, [a, a, a], b),
-    bitand: (a, b) => bitAndU3([], a, b),
-    lshift: (a, b) => lshiftU3([], a, b),
-    bitnot1: (a) => bitNotU3([], a),
-    bitor: (a, b) => bitOrU3([], a, b),
-    rshift: (a, b) => rshiftU3([], a, b),
-    bitxor: (a, b) => bitXorU3([], a, b),
+    ...VEC3(POOL_UVEC3),
+    add: (a, b) => addU3(next(), a, b),
+    addvn: (a, b) => addNU3(next(), a, b),
+    addnv: (a, b) => addNU3(next(), b, a),
+    div: (a, b) => divU3(next(), a, b),
+    divvn: (a, b) => divNU3(next(), a, b),
+    divnv: (a, b) => divU3(null, uniform(a), b),
+    modi: (a, b) => fmod3(next(), a, b),
+    modivn: (a, b) => fmodN3(next(), a, b),
+    modinv: (a, b) => fmod3(null, uniform(a), b),
+    mul: (a, b) => mulU3(next(), a, b),
+    mulvn: (a, b) => mulNU3(next(), a, b),
+    mulnv: (a, b) => mulNU3(next(), b, a),
+    sub: (a, b) => subU3(next(), a, b),
+    subvn: (a, b) => subNU3(next(), a, b),
+    subnv: (a, b) => subU3(null, uniform(a), b),
+    bitand: (a, b) => bitAndU3(next(), a, b),
+    lshift: (a, b) => lshiftU3(next(), a, b),
+    bitnot1: (a) => bitNotU3(next(), a),
+    bitor: (a, b) => bitOrU3(next(), a, b),
+    rshift: (a, b) => rshiftU3(next(), a, b),
+    bitxor: (a, b) => bitXorU3(next(), a, b),
 };

package/env/uvec4.js

@@ -10,28 +10,30 @@ import { lshiftU4 } from "@thi.ng/vectors/lshift";
 import { mulNU4, mulU4 } from "@thi.ng/vectors/muli";
 import { rshiftU4 } from "@thi.ng/vectors/rshift";
 import { subNU4, subU4 } from "@thi.ng/vectors/subi";
+import { POOL_UVEC4 } from "../pool.js";
 import { VEC4 } from "./vec4.js";
+const { next, uniform } = POOL_UVEC4;
 export const UVEC4 = {
-    ...VEC4,
-    add: (a, b) => addU4([], a, b),
-    addvn: (a, b) => addNU4([], a, b),
-    addnv: (a, b) => addNU4([], b, a),
-    div: (a, b) => divU4([], a, b),
-    divvn: (a, b) => divNU4([], a, b),
-    divnv: (a, b) => divU4(null, [a, a, a, a], b),
-    modi: (a, b) => fmod4([], a, b),
-    modivn: (a, b) => fmodN4([], a, b),
-    modinv: (a, b) => fmod4(null, [a, a, a, a], b),
-    mul: (a, b) => mulU4([], a, b),
-    mulvn: (a, b) => mulNU4([], a, b),
-    mulnv: (a, b) => mulNU4([], b, a),
-    sub: (a, b) => subU4([], a, b),
-    subvn: (a, b) => subNU4([], a, b),
-    subnv: (a, b) => subU4(null, [a, a, a, a], b),
-    bitand: (a, b) => bitAndU4([], a, b),
-    lshift: (a, b) => lshiftU4([], a, b),
-    bitnot1: (a) => bitNotU4([], a),
-    bitor: (a, b) => bitOrU4([], a, b),
-    rshift: (a, b) => rshiftU4([], a, b),
-    bitxor: (a, b) => bitXorU4([], a, b),
+    ...VEC4(POOL_UVEC4),
+    add: (a, b) => addU4(next(), a, b),
+    addvn: (a, b) => addNU4(next(), a, b),
+    addnv: (a, b) => addNU4(next(), b, a),
+    div: (a, b) => divU4(next(), a, b),
+    divvn: (a, b) => divNU4(next(), a, b),
+    divnv: (a, b) => divU4(null, uniform(a), b),
+    modi: (a, b) => fmod4(next(), a, b),
+    modivn: (a, b) => fmodN4(next(), a, b),
+    modinv: (a, b) => fmod4(null, uniform(a), b),
+    mul: (a, b) => mulU4(next(), a, b),
+    mulvn: (a, b) => mulNU4(next(), a, b),
+    mulnv: (a, b) => mulNU4(next(), b, a),
+    sub: (a, b) => subU4(next(), a, b),
+    subvn: (a, b) => subNU4(next(), a, b),
+    subnv: (a, b) => subU4(null, uniform(a), b),
+    bitand: (a, b) => bitAndU4(next(), a, b),
+    lshift: (a, b) => lshiftU4(next(), a, b),
+    bitnot1: (a) => bitNotU4(next(), a),
+    bitor: (a, b) => bitOrU4(next(), a, b),
+    rshift: (a, b) => rshiftU4(next(), a, b),
+    bitxor: (a, b) => bitXorU4(next(), a, b),
 };

package/env/vec2.d.ts

@@ -1,3 +1,4 @@
 import type { JSBuiltinsVec } from "../api.js";
-export declare const VEC2: JSBuiltinsVec;
+import { Pool } from "../pool.js";
+export declare const VEC2: ({ next, uniform }: Pool) => JSBuiltinsVec;
 //# sourceMappingURL=vec2.d.ts.map

package/env/vec2.js

@@ -50,66 +50,67 @@ import { step2 } from "@thi.ng/vectors/step";
 import { sub2 } from "@thi.ng/vectors/sub";
 import { subN2 } from "@thi.ng/vectors/subn";
 import { tan2 } from "@thi.ng/vectors/tan";
-export const VEC2 = {
-    abs: (a) => abs2([], a),
-    acos: (a) => acos2([], a),
-    add: (a, b) => add2([], a, b),
-    addnv: (a, b) => addN2([], b, a),
-    addvn: (a, b) => addN2([], a, b),
-    asin: (a) => asin2([], a),
-    atan: (a) => atan2([], a),
-    atannn: (a, b) => atan_22([], a, b),
-    ceil: (a) => ceil2([], a),
-    clamp: (x, a, b) => clamp2([], x, a, b),
-    cos: (a) => cos2([], a),
-    dec: (a) => subN2([], a, 1),
-    degrees: (a) => degrees2([], a),
+import { Pool } from "../pool.js";
+export const VEC2 = ({ next, uniform }) => ({
+    abs: (a) => abs2(next(), a),
+    acos: (a) => acos2(next(), a),
+    add: (a, b) => add2(next(), a, b),
+    addnv: (a, b) => addN2(next(), b, a),
+    addvn: (a, b) => addN2(next(), a, b),
+    asin: (a) => asin2(next(), a),
+    atan: (a) => atan2(next(), a),
+    atannn: (a, b) => atan_22(next(), a, b),
+    ceil: (a) => ceil2(next(), a),
+    clamp: (x, a, b) => clamp2(next(), x, a, b),
+    cos: (a) => cos2(next(), a),
+    dec: (a) => subN2(next(), a, 1),
+    degrees: (a) => degrees2(next(), a),
     dFdx: () => ZERO2,
     dFdy: () => ZERO2,
     distance: dist,
-    div: (a, b) => div2([], a, b),
-    divnv: (a, b) => div2(null, [a, a], b),
-    divvn: (a, b) => divN2([], a, b),
+    div: (a, b) => div2(next(), a, b),
+    divnv: (a, b) => div2(null, uniform(a), b),
+    divvn: (a, b) => divN2(next(), a, b),
     dot: (a, b) => dot2(a, b),
-    exp: (a) => exp2([], a),
-    exp2: (a) => exp_22([], a),
-    faceForward: (a, b, c) => faceForward([], a, b, c),
-    floor: (a) => floor2([], a),
-    fract: (a) => fract2([], a),
+    exp: (a) => exp2(next(), a),
+    exp2: (a) => exp_22(next(), a),
+    faceForward: (a, b, c) => faceForward(next(), a, b, c),
+    floor: (a) => floor2(next(), a),
+    fract: (a) => fract2(next(), a),
     fwidth: () => ZERO2,
-    inc: (a) => addN2([], a, 1),
-    inversesqrt: (a) => invSqrt2([], a),
+    inc: (a) => addN2(next(), a, 1),
+    inversesqrt: (a) => invSqrt2(next(), a),
     length: mag,
-    log: (a) => log2([], a),
-    log2: (a) => log_22([], a),
-    max: (a, b) => max2([], a, b),
-    min: (a, b) => min2([], a, b),
-    mix: (a, b, t) => mix2([], a, b, t),
-    mixn: (a, b, t) => mixN2([], a, b, t),
-    mod: (a, b) => mod2([], a, b),
-    modn: (a, b) => modN2([], a, b),
-    mul: (a, b) => mul2([], a, b),
-    mulnv: (a, b) => mulN2([], b, a),
-    mulvn: (a, b) => mulN2([], a, b),
-    normalize: (a) => normalize2([], a),
-    pow: (a, b) => pow2([], a, b),
-    radians: (a) => radians2([], a),
-    reflect: (a, b) => reflect([], a, b),
-    refract: (a, b, c) => refract([], a, b, c),
-    sign: (a) => sign2([], a),
-    sin: (a) => sin2([], a),
-    smoothstep: (a, b, t) => smoothStep2([], a, b, t),
-    sqrt: (a) => sqrt2([], a),
-    step: (a, b) => step2([], a, b),
-    sub: (a, b) => sub2([], a, b),
-    sub1: (a) => neg([], a),
-    subnv: (a, b) => sub2(null, [a, a], b),
-    subvn: (a, b) => subN2([], a, b),
-    tan: (a) => tan2([], a),
+    log: (a) => log2(next(), a),
+    log2: (a) => log_22(next(), a),
+    max: (a, b) => max2(next(), a, b),
+    min: (a, b) => min2(next(), a, b),
+    mix: (a, b, t) => mix2(next(), a, b, t),
+    mixn: (a, b, t) => mixN2(next(), a, b, t),
+    mod: (a, b) => mod2(next(), a, b),
+    modn: (a, b) => modN2(next(), a, b),
+    mul: (a, b) => mul2(next(), a, b),
+    mulnv: (a, b) => mulN2(next(), b, a),
+    mulvn: (a, b) => mulN2(next(), a, b),
+    normalize: (a) => normalize2(next(), a),
+    pow: (a, b) => pow2(next(), a, b),
+    radians: (a) => radians2(next(), a),
+    reflect: (a, b) => reflect(next(), a, b),
+    refract: (a, b, c) => refract(next(), a, b, c),
+    sign: (a) => sign2(next(), a),
+    sin: (a) => sin2(next(), a),
+    smoothstep: (a, b, t) => smoothStep2(next(), a, b, t),
+    sqrt: (a) => sqrt2(next(), a),
+    step: (a, b) => step2(next(), a, b),
+    sub: (a, b) => sub2(next(), a, b),
+    sub1: (a) => neg(next(), a),
+    subnv: (a, b) => sub2(null, uniform(a), b),
+    subvn: (a, b) => subN2(next(), a, b),
+    tan: (a) => tan2(next(), a),
     equal: (a, b) => eq2([], a, b),
     notEqual: (a, b) => neq2([], a, b),
     greaterThan: (a, b) => gt2([], a, b),
     lessThan: (a, b) => lt2([], a, b),
     greaterThanEqual: (a, b) => gte2([], a, b),
     lessThanEqual: (a, b) => lte2([], a, b),
-};
+});