@thi.ng/shader-ast-stdlib 0.12.26 → 0.12.28

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2022-12-16T12:52:25Z
+- **Last updated**: 2022-12-22T21:47:07Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.

package/README.md

@@ -41,7 +41,7 @@ This project is part of the
 
 ## About
 
-Function collection for modular GPGPU / shader programming with @thi.ng/shader-ast
+Function collection for modular GPGPU / shader programming with [@thi.ng/shader-ast](https://github.com/thi-ng/umbrella/tree/develop/packages/shader-ast).
 
 A growing collection (currently ~170) of useful functions & higher order
 constructs (incl. meta programming approaches) for GPU / shader programming,

package/color/porter-duff.d.ts

@@ -2,14 +2,13 @@ import type { Fn2 } from "@thi.ng/api";
 import type { FloatTerm } from "@thi.ng/shader-ast";
 /**
  * Higher-order Porter-Duff alpha compositing operator. See
- * {@link @thi.ng/porter-duff# | @thi.ng/porter-duff} for reference. Returns an optimized AST
- * function which accepts 2 RGBA colors (vec4) and returns blended &
- * clamped result (also a vec4). All built-in PD operators are defined
- * via this HOF.
+ * [thi.ng/porter-duff](https://thi.ng/porter-duff) for reference. Returns an
+ * optimized AST function which accepts 2 RGBA colors (vec4) and returns blended
+ * & clamped result (also a vec4). All built-in PD operators are defined via
+ * this HOF.
  *
- * The two given JS functions are used to extract blending coefficients
- * for src/dest colors and are called with the alpha components of both
- * colors.
+ * The two given JS functions are used to extract blending coefficients for
+ * src/dest colors and are called with the alpha components of both colors.
  *
  * Optimization only happens for cases where either `fa` and/or `fb` are
  * {@link ZERO}.

package/color/porter-duff.js

@@ -6,14 +6,13 @@ import { clamp01 } from "../math/clamp.js";
 const coeff = (f, a, b) => (f === ZERO ? FLOAT0 : f === ONE ? a : mul(a, f($w(a), $w(b))));
 /**
  * Higher-order Porter-Duff alpha compositing operator. See
- * {@link @thi.ng/porter-duff# | @thi.ng/porter-duff} for reference. Returns an optimized AST
- * function which accepts 2 RGBA colors (vec4) and returns blended &
- * clamped result (also a vec4). All built-in PD operators are defined
- * via this HOF.
+ * [thi.ng/porter-duff](https://thi.ng/porter-duff) for reference. Returns an
+ * optimized AST function which accepts 2 RGBA colors (vec4) and returns blended
+ * & clamped result (also a vec4). All built-in PD operators are defined via
+ * this HOF.
  *
- * The two given JS functions are used to extract blending coefficients
- * for src/dest colors and are called with the alpha components of both
- * colors.
+ * The two given JS functions are used to extract blending coefficients for
+ * src/dest colors and are called with the alpha components of both colors.
  *
  * Optimization only happens for cases where either `fa` and/or `fb` are
  * {@link ZERO}.

package/fog/exp2.d.ts

@@ -1,7 +1,8 @@
 /**
- * Similar to {@link fogExp}. Computes exponential fog factor [0..1],
- * based on given fully saturated fog distance and density. Uses
- * {@link @thi.ng/shader-ast#exp2} internally.
+ * Similar to {@link fogExp}. Computes exponential fog factor [0..1], based on
+ * given fully saturated fog distance and density. Uses
+ * [`exp2()`](https://docs.thi.ng/umbrella/shader-ast/functions/exp2.html)
+ * internally.
  *
  * @param dist - float
  * @param density - float

package/fog/exp2.js

@@ -5,9 +5,10 @@ import { mul, sub } from "@thi.ng/shader-ast/ast/ops";
 import { exp2 } from "@thi.ng/shader-ast/builtin/math";
 import { clamp01 } from "../math/clamp.js";
 /**
- * Similar to {@link fogExp}. Computes exponential fog factor [0..1],
- * based on given fully saturated fog distance and density. Uses
- * {@link @thi.ng/shader-ast#exp2} internally.
+ * Similar to {@link fogExp}. Computes exponential fog factor [0..1], based on
+ * given fully saturated fog distance and density. Uses
+ * [`exp2()`](https://docs.thi.ng/umbrella/shader-ast/functions/exp2.html)
+ * internally.
  *
  * @param dist - float
  * @param density - float

package/light/lambert.d.ts

@@ -1,7 +1,7 @@
 import type { FloatTerm, Vec3Term } from "@thi.ng/shader-ast";
 /**
- * Inline function. Computes Lambert term, i.e. `max(dot(n, l), 0)`.
- * Both vectors must be pre-normalized.
+ * Inline function. Computes Lambert term, i.e. `max(dot(n, l), 0)`. Both
+ * vectors must be pre-normalized.
  *
  * @param surfNormal - vec3
  * @param lightDir - vec3
@@ -11,7 +11,7 @@ export declare const lambert: (n: Vec3Term, ldir: Vec3Term) => import("@thi.ng/s
  * Inline function. Computes Half-Lambertian term. Both vectors must be
  * pre-normalized.
  *
- * {@link https://developer.valvesoftware.com/wiki/Half_Lambert}
+ * https://developer.valvesoftware.com/wiki/Half_Lambert
  *
  * @param n -
  * @param ldir -

package/light/lambert.js

@@ -3,8 +3,8 @@ import { madd, mul } from "@thi.ng/shader-ast/ast/ops";
 import { dot, max } from "@thi.ng/shader-ast/builtin/math";
 import { fit1101 } from "../math/fit.js";
 /**
- * Inline function. Computes Lambert term, i.e. `max(dot(n, l), 0)`.
- * Both vectors must be pre-normalized.
+ * Inline function. Computes Lambert term, i.e. `max(dot(n, l), 0)`. Both
+ * vectors must be pre-normalized.
  *
  * @param surfNormal - vec3
  * @param lightDir - vec3
@@ -14,7 +14,7 @@ export const lambert = (n, ldir) => max(dot(n, ldir), FLOAT0);
  * Inline function. Computes Half-Lambertian term. Both vectors must be
  * pre-normalized.
  *
- * {@link https://developer.valvesoftware.com/wiki/Half_Lambert}
+ * https://developer.valvesoftware.com/wiki/Half_Lambert
  *
  * @param n -
  * @param ldir -

package/math/orthogonal.d.ts

@@ -1,14 +1,14 @@
 import type { Vec2Term } from "@thi.ng/shader-ast";
 /**
- * Inline function. Returns counter-clockwise perpendicular vector
- * (assuming Y-up). [-y, x]
+ * Inline function. Returns counter-clockwise perpendicular vector (assuming
+ * Y-up). [-y, x]
  *
  * @param v -
  */
 export declare const perpendicularCCW: (v: Vec2Term) => import("@thi.ng/shader-ast").Lit<"vec2">;
 /**
- * Inline function. Returns clockwise perpendicular vector (assuming
- * Y-up). [y,-x]
+ * Inline function. Returns clockwise perpendicular vector (assuming Y-up).
+ * [y,-x]
  *
  * @param v -
  */
@@ -16,7 +16,7 @@ export declare const perpendicularCW: (v: Vec2Term) => import("@thi.ng/shader-as
 /**
  * Returns an orthogonal vector to `v`.
  *
- * {@link http://lolengine.net/blog/2013/09/21/picking-orthogonal-vector-combing-coconuts}
+ * http://lolengine.net/blog/2013/09/21/picking-orthogonal-vector-combing-coconuts
  */
 export declare const orthogonal3: import("@thi.ng/shader-ast").TaggedFn1<"vec3", "vec3">;
 //# sourceMappingURL=orthogonal.d.ts.map

package/math/orthogonal.js

@@ -5,15 +5,15 @@ import { gt, neg } from "@thi.ng/shader-ast/ast/ops";
 import { $x, $y, $z } from "@thi.ng/shader-ast/ast/swizzle";
 import { abs } from "@thi.ng/shader-ast/builtin/math";
 /**
- * Inline function. Returns counter-clockwise perpendicular vector
- * (assuming Y-up). [-y, x]
+ * Inline function. Returns counter-clockwise perpendicular vector (assuming
+ * Y-up). [-y, x]
  *
  * @param v -
  */
 export const perpendicularCCW = (v) => vec2(neg($y(v)), $x(v));
 /**
- * Inline function. Returns clockwise perpendicular vector (assuming
- * Y-up). [y,-x]
+ * Inline function. Returns clockwise perpendicular vector (assuming Y-up).
+ * [y,-x]
  *
  * @param v -
  */
@@ -21,7 +21,7 @@ export const perpendicularCW = (v) => vec2($y(v), neg($x(v)));
 /**
  * Returns an orthogonal vector to `v`.
  *
- * {@link http://lolengine.net/blog/2013/09/21/picking-orthogonal-vector-combing-coconuts}
+ * http://lolengine.net/blog/2013/09/21/picking-orthogonal-vector-combing-coconuts
  */
 export const orthogonal3 = defn("vec3", "orthogonal3", ["vec3"], (v) => [
     ret(ternary(gt(abs($x(v)), abs($z(v))), vec3(neg($y(v)), $x(v), 0), vec3(0, neg($z(v)), $y(v)))),

package/noise/simplex2.d.ts

@@ -1,8 +1,8 @@
 /**
- * Array and textureless GLSL 2D simplex noise function. Ported from
- * original GLSL implementation by Ian McEwan & Ashima Arts.
+ * Array and textureless GLSL 2D simplex noise function. Ported from original
+ * GLSL implementation by Ian McEwan & Ashima Arts.
  *
- * {@link https://github.com/ashima/webgl-noise}
+ * https://github.com/ashima/webgl-noise
  */
 export declare const snoise2: import("@thi.ng/shader-ast").TaggedFn1<"vec2", "float">;
 //# sourceMappingURL=simplex2.d.ts.map

package/noise/simplex2.js

@@ -9,10 +9,10 @@ import { abs, dot, floor, fract, max, mod, } from "@thi.ng/shader-ast/builtin/ma
 import { magSq2 } from "../math/magsq.js";
 import { permute3 } from "./permute.js";
 /**
- * Array and textureless GLSL 2D simplex noise function. Ported from
- * original GLSL implementation by Ian McEwan & Ashima Arts.
+ * Array and textureless GLSL 2D simplex noise function. Ported from original
+ * GLSL implementation by Ian McEwan & Ashima Arts.
  *
- * {@link https://github.com/ashima/webgl-noise}
+ * https://github.com/ashima/webgl-noise
  */
 export const snoise2 = defn("float", "snoise2", ["vec2"], (v) => {
     let C;

package/noise/voronoi2.d.ts

@@ -7,7 +7,7 @@
  * - perlin noise (0,1)
  * - voronoise (1,1)
  *
- * {@link http://www.iquilezles.org/www/articles/voronoise/voronoise.htm}
+ * http://www.iquilezles.org/www/articles/voronoise/voronoise.htm
  *
  * Note: This implementation uses the improved {@link hash32} by Dave Hoskins
  * instead of iq's original {@link hash3}.

package/noise/voronoi2.js

@@ -16,7 +16,7 @@ import { hash32 } from "./hash.js";
  * - perlin noise (0,1)
  * - voronoise (1,1)
  *
- * {@link http://www.iquilezles.org/www/articles/voronoise/voronoise.htm}
+ * http://www.iquilezles.org/www/articles/voronoise/voronoise.htm
  *
  * Note: This implementation uses the improved {@link hash32} by Dave Hoskins
  * instead of iq's original {@link hash3}.

package/noise/worley2.d.ts

@@ -10,7 +10,7 @@ export declare const worleyDistManhattan: import("@thi.ng/shader-ast").TaggedFn2
  * can be used individually or combined (e.g. `noise.y - noise.x`)...
  *
  * Based on implementation by Stefan Gustavson:
- * {@link http://webstaff.itn.liu.se/~stegu/GLSL-cellular/GLSL-cellular-notes.pdf}
+ * http://webstaff.itn.liu.se/~stegu/GLSL-cellular/GLSL-cellular-notes.pdf
  *
  * @param distFn -
  */

package/noise/worley2.js

@@ -18,7 +18,7 @@ export const worleyDistManhattan = defn("vec3", "worleyDistManhatten", ["vec3",
  * can be used individually or combined (e.g. `noise.y - noise.x`)...
  *
  * Based on implementation by Stefan Gustavson:
- * {@link http://webstaff.itn.liu.se/~stegu/GLSL-cellular/GLSL-cellular-notes.pdf}
+ * http://webstaff.itn.liu.se/~stegu/GLSL-cellular/GLSL-cellular-notes.pdf
  *
  * @param distFn -
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/shader-ast-stdlib",
-  "version": "0.12.26",
+  "version": "0.12.28",
   "description": "Function collection for modular GPGPU / shader programming with @thi.ng/shader-ast",
   "type": "module",
   "module": "./index.js",
@@ -34,12 +34,12 @@
     "test": "testament test"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.6.0",
-    "@thi.ng/shader-ast": "^0.12.33"
+    "@thi.ng/api": "^8.6.2",
+    "@thi.ng/shader-ast": "^0.12.35"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.33.7",
-    "@thi.ng/testament": "^0.3.7",
+    "@thi.ng/testament": "^0.3.8",
     "rimraf": "^3.0.2",
     "tools": "^0.0.1",
     "typedoc": "^0.23.22",
@@ -330,5 +330,5 @@
     ],
     "year": 2019
   },
-  "gitHead": "f445a9cc8022bcdebbf6ff91fd66ced016d72f01\n"
+  "gitHead": "bc6f7f5e2765bb96fe64db804eaf4b2443b47fc6\n"
 }

package/tex/blur.d.ts

@@ -1,8 +1,8 @@
 /**
  * 5x5 gaussian blur texture lookup, optimized, but based on:
  *
- * - {@link http://rastergrid.com/blog/2010/09/efficient-gaussian-blur-with-linear-sampling/}
- * - {@link https://github.com/Jam3/glsl-fast-gaussian-blur}
+ * - http://rastergrid.com/blog/2010/09/efficient-gaussian-blur-with-linear-sampling/
+ * - https://github.com/Jam3/glsl-fast-gaussian-blur
  *
  * @param tex - sampler2D
  * @param res - resolution
@@ -13,8 +13,8 @@ export declare const blur5: import("@thi.ng/shader-ast").TaggedFn4<"sampler2D",
 /**
  * 9x9 gaussian blur texture lookup, optimized, but based on:
  *
- * - {@link http://rastergrid.com/blog/2010/09/efficient-gaussian-blur-with-linear-sampling/}
- * - {@link https://github.com/Jam3/glsl-fast-gaussian-blur}
+ * - http://rastergrid.com/blog/2010/09/efficient-gaussian-blur-with-linear-sampling/
+ * - https://github.com/Jam3/glsl-fast-gaussian-blur
  *
  * @param tex - sampler2D
  * @param res - resolution
@@ -25,8 +25,8 @@ export declare const blur9: import("@thi.ng/shader-ast").TaggedFn4<"sampler2D",
 /**
  * 13x13 gaussian blur texture lookup, optimized, but based on:
  *
- * - {@link http://rastergrid.com/blog/2010/09/efficient-gaussian-blur-with-linear-sampling/}
- * - {@link https://github.com/Jam3/glsl-fast-gaussian-blur}
+ * - http://rastergrid.com/blog/2010/09/efficient-gaussian-blur-with-linear-sampling/
+ * - https://github.com/Jam3/glsl-fast-gaussian-blur
  *
  * @param tex - sampler2D
  * @param res - resolution

package/tex/blur.js

@@ -18,8 +18,8 @@ const singlePass = (col, tex, uv, off, k) => assign(col, add(col, mul(add(textur
 /**
  * 5x5 gaussian blur texture lookup, optimized, but based on:
  *
- * - {@link http://rastergrid.com/blog/2010/09/efficient-gaussian-blur-with-linear-sampling/}
- * - {@link https://github.com/Jam3/glsl-fast-gaussian-blur}
+ * - http://rastergrid.com/blog/2010/09/efficient-gaussian-blur-with-linear-sampling/
+ * - https://github.com/Jam3/glsl-fast-gaussian-blur
  *
  * @param tex - sampler2D
  * @param res - resolution
@@ -41,8 +41,8 @@ export const blur5 = defn("vec4", "blur5", ["sampler2D", "vec2", "vec2", "vec2"]
 /**
  * 9x9 gaussian blur texture lookup, optimized, but based on:
  *
- * - {@link http://rastergrid.com/blog/2010/09/efficient-gaussian-blur-with-linear-sampling/}
- * - {@link https://github.com/Jam3/glsl-fast-gaussian-blur}
+ * - http://rastergrid.com/blog/2010/09/efficient-gaussian-blur-with-linear-sampling/
+ * - https://github.com/Jam3/glsl-fast-gaussian-blur
  *
  * @param tex - sampler2D
  * @param res - resolution
@@ -69,8 +69,8 @@ export const blur9 = defn("vec4", "blur9", ["sampler2D", "vec2", "vec2", "vec2"]
 /**
  * 13x13 gaussian blur texture lookup, optimized, but based on:
  *
- * - {@link http://rastergrid.com/blog/2010/09/efficient-gaussian-blur-with-linear-sampling/}
- * - {@link https://github.com/Jam3/glsl-fast-gaussian-blur}
+ * - http://rastergrid.com/blog/2010/09/efficient-gaussian-blur-with-linear-sampling/
+ * - https://github.com/Jam3/glsl-fast-gaussian-blur
  *
  * @param tex - sampler2D
  * @param res - resolution