@thi.ng/shader-ast-stdlib 0.15.0 → 0.16.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2023-10-25T12:40:55Z
+- **Last updated**: 2023-10-27T16:56:24Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,12 @@ 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.
 
+## [0.16.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/shader-ast-stdlib@0.16.0) (2023-10-27)
+
+#### 🚀 Features
+
+- add trunc(), modulo(), foldback01() ([d3ab3e6](https://github.com/thi-ng/umbrella/commit/d3ab3e6))
+
 ## [0.15.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/shader-ast-stdlib@0.15.0) (2023-10-25)
 
 #### 🚀 Features

package/README.md

@@ -105,7 +105,7 @@ For Node.js REPL:
 const shaderAstStdlib = await import("@thi.ng/shader-ast-stdlib");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 13.20 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 13.42 KB
 
 ## Dependencies
 

package/index.d.ts

@@ -18,6 +18,7 @@ export * from "./math/cross2.js";
 export * from "./math/dist-chebyshev.js";
 export * from "./math/dist-manhattan.js";
 export * from "./math/fit.js";
+export * from "./math/interval.js";
 export * from "./math/magsq.js";
 export * from "./math/maxcomp.js";
 export * from "./math/mincomp.js";

package/index.js

@@ -18,6 +18,7 @@ export * from "./math/cross2.js";
 export * from "./math/dist-chebyshev.js";
 export * from "./math/dist-manhattan.js";
 export * from "./math/fit.js";
+export * from "./math/interval.js";
 export * from "./math/magsq.js";
 export * from "./math/maxcomp.js";
 export * from "./math/mincomp.js";

package/math/fit.d.ts

@@ -8,6 +8,17 @@ import type { PrimTerm, Term, TermType } from "@thi.ng/shader-ast";
  * @param b -
  */
 export declare const fitNorm1: import("@thi.ng/shader-ast").TaggedFn3<"float", "float", "float", "float">;
+/**
+ * Similar to {@link fitNorm1} but also for vector types and without checking if
+ * `a == b`. Scales value `x` from closed interval [a,b] to closed [0,1]
+ * interval. No clamping performed.
+ *
+ * @param x
+ * @param a
+ * @param b
+ * @returns
+ */
+export declare const fitNorm: <T extends PrimTerm>(x: T, a: T, b: T) => Term<TermType<T>>;
 /**
  * Fits value `x` from closed interval [a,b] to closed interval [c,d]. No
  * clamping performed.
@@ -19,16 +30,6 @@ export declare const fitNorm1: import("@thi.ng/shader-ast").TaggedFn3<"float", "
  * @param d -
  */
 export declare const fit: <T extends PrimTerm>(x: T, a: T, b: T, c: T, d: T) => Term<TermType<T>>;
-/**
- * Scales value `x` from closed interval [a,b] to closed [0,1] interval. No
- * clamping performed.
- *
- * @param x
- * @param a
- * @param b
- * @returns
- */
-export declare const fitNorm: <T extends PrimTerm>(x: T, a: T, b: T) => Term<TermType<T>>;
 /**
  * Same as {@link fit}, but first clamps `x` to closed [a,b] interval.
  *

package/math/fit.js

@@ -16,6 +16,17 @@ import { clamp01 } from "./clamp.js";
 export const fitNorm1 = defn(F, "fitNorm1", [F, F, F], (x, a, b) => [
     ret(ternary(neq(a, b), div(sub(x, a), sub(b, a)), FLOAT0)),
 ]);
+/**
+ * Similar to {@link fitNorm1} but also for vector types and without checking if
+ * `a == b`. Scales value `x` from closed interval [a,b] to closed [0,1]
+ * interval. No clamping performed.
+ *
+ * @param x
+ * @param a
+ * @param b
+ * @returns
+ */
+export const fitNorm = (x, a, b) => div(sub(x, a), sub(b, a));
 /**
  * Fits value `x` from closed interval [a,b] to closed interval [c,d]. No
  * clamping performed.
@@ -27,16 +38,6 @@ export const fitNorm1 = defn(F, "fitNorm1", [F, F, F], (x, a, b) => [
  * @param d -
  */
 export const fit = (x, a, b, c, d) => mix(c, d, fitNorm(x, a, b));
-/**
- * Scales value `x` from closed interval [a,b] to closed [0,1] interval. No
- * clamping performed.
- *
- * @param x
- * @param a
- * @param b
- * @returns
- */
-export const fitNorm = (x, a, b) => div(sub(x, a), sub(b, a));
 /**
  * Same as {@link fit}, but first clamps `x` to closed [a,b] interval.
  *

package/math/interval.d.ts

@@ -0,0 +1,17 @@
+/**
+ * GLSL 100 trunc() polyfill.
+ */
+export declare const trunc: import("@thi.ng/shader-ast").TaggedFn1<"float", "float">;
+/**
+ * Returns `x - y * trunc(x / y)`, i.e. essentially the same as JS `%` operator.
+ * Result will always have the sign of `x`.
+ */
+export declare const modulo: import("@thi.ng/shader-ast").TaggedFn2<"float", "float", "float">;
+/**
+ * Same as thi.ng/math foldback01(). Folds `x` into the closed [0..1] interval,
+ * using infinite internal reflection on either side of the interval.
+ *
+ * @param x
+ */
+export declare const foldback01: import("@thi.ng/shader-ast").TaggedFn1<"float", "float">;
+//# sourceMappingURL=interval.d.ts.map

package/math/interval.js

@@ -0,0 +1,33 @@
+import { F } from "@thi.ng/shader-ast/api/types";
+import { ternary } from "@thi.ng/shader-ast/ast/controlflow";
+import { defn, ret } from "@thi.ng/shader-ast/ast/function";
+import { FLOAT0, FLOAT1, FLOAT2 } from "@thi.ng/shader-ast/ast/lit";
+import { div, lt, mul, sub } from "@thi.ng/shader-ast/ast/ops";
+import { sym } from "@thi.ng/shader-ast/ast/sym";
+import { abs, ceil, floor, mix, mod, step, } from "@thi.ng/shader-ast/builtin/math";
+/**
+ * GLSL 100 trunc() polyfill.
+ */
+export const trunc = defn(F, null, [F], (x) => [
+    ret(ternary(lt(x, FLOAT0), ceil(x), floor(x))),
+]);
+/**
+ * Returns `x - y * trunc(x / y)`, i.e. essentially the same as JS `%` operator.
+ * Result will always have the sign of `x`.
+ */
+export const modulo = defn(F, null, [F, F], (x, y) => [
+    ret(sub(x, mul(y, trunc(div(x, y))))),
+]);
+/**
+ * Same as thi.ng/math foldback01(). Folds `x` into the closed [0..1] interval,
+ * using infinite internal reflection on either side of the interval.
+ *
+ * @param x
+ */
+export const foldback01 = defn(F, null, [F], (x) => {
+    let y;
+    return [
+        (y = sym(mod(abs(x), FLOAT2))),
+        ret(mix(y, sub(FLOAT2, y), step(FLOAT1, y))),
+    ];
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/shader-ast-stdlib",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "Function collection for modular GPGPU / shader programming with @thi.ng/shader-ast",
   "type": "module",
   "module": "./index.js",
@@ -38,7 +38,7 @@
   },
   "dependencies": {
     "@thi.ng/api": "^8.9.6",
-    "@thi.ng/shader-ast": "^0.12.75"
+    "@thi.ng/shader-ast": "^0.12.76"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.38.0",
@@ -162,6 +162,9 @@
     "./math/fit": {
       "default": "./math/fit.js"
     },
+    "./math/interval": {
+      "default": "./math/interval.js"
+    },
     "./math/magsq": {
       "default": "./math/magsq.js"
     },
@@ -349,5 +352,5 @@
     ],
     "year": 2019
   },
-  "gitHead": "fc6e14052ed24bf9196896980ceb9f398b6ea6c1\n"
+  "gitHead": "502e8fa937677ff7bc4fbd0906d8c8b4b0b471e5\n"
 }