@thi.ng/shader-ast-stdlib 0.13.16 → 0.14.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2023-05-24T14:26:03Z
+- **Last updated**: 2023-07-14T11:37:51Z
 - **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.14.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/shader-ast-stdlib@0.14.0) (2023-07-14)
+
+#### 🚀 Features
+
+- add smootherStep() ([859fa5d](https://github.com/thi-ng/umbrella/commit/859fa5d))
+
 ### [0.13.15](https://github.com/thi-ng/umbrella/tree/@thi.ng/shader-ast-stdlib@0.13.15) (2023-05-11)
 
 #### ♻️ Refactoring

package/README.md

@@ -101,7 +101,7 @@ For Node.js REPL:
 const shaderAstStdlib = await import("@thi.ng/shader-ast-stdlib");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 11.64 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 11.82 KB
 
 ## Dependencies
 
@@ -386,6 +386,8 @@ for reference.
 - `orthogonal3`
 - `polar2` / `polar3`
 - `sincos` / `cossin`
+- `smootherStep` / `smootherStep2` / `smootherStep3` / `smootherStep4`
+- `smootherStep01` / `smootherStep01_2` / `smootherStep01_3` / `smootherStep01_4`
 
 ### Oscillators
 

package/index.d.ts

@@ -26,6 +26,7 @@ export * from "./math/orthogonal.js";
 export * from "./math/osc.js";
 export * from "./math/polar.js";
 export * from "./math/sincos.js";
+export * from "./math/smoother-step.js";
 export * from "./matrix/lookat.js";
 export * from "./matrix/mvp.js";
 export * from "./matrix/normal.js";

package/index.js

@@ -26,6 +26,7 @@ export * from "./math/orthogonal.js";
 export * from "./math/osc.js";
 export * from "./math/polar.js";
 export * from "./math/sincos.js";
+export * from "./math/smoother-step.js";
 export * from "./matrix/lookat.js";
 export * from "./matrix/mvp.js";
 export * from "./matrix/normal.js";

package/math/smoother-step.d.ts

@@ -0,0 +1,23 @@
+import type { TaggedFn1 } from "@thi.ng/shader-ast";
+/**
+ * Specialized version of {@link smootherStep}, assuming edges are 0/1
+ * respectively and `x` is in [0..1]. No clamping performed.
+ *
+ * @param x
+ */
+export declare const smootherStep01: TaggedFn1<"float", "float">;
+export declare const smootherStep01_2: TaggedFn1<"vec2", "vec2">;
+export declare const smootherStep01_3: TaggedFn1<"vec3", "vec3">;
+export declare const smootherStep01_4: TaggedFn1<"vec4", "vec4">;
+/**
+ * Similar to GLSL-native `smoothstep()` but using different, higher degree
+ * polynomial.
+ *
+ * @remarks
+ * Also see {@link smootherStep01}
+ */
+export declare const smootherStep: import("@thi.ng/shader-ast").TaggedFn3<"float", "float", "float", "float">;
+export declare const smootherStep2: import("@thi.ng/shader-ast").TaggedFn3<"vec2", "vec2", "vec2", "vec2">;
+export declare const smootherStep3: import("@thi.ng/shader-ast").TaggedFn3<"vec3", "vec3", "vec3", "vec3">;
+export declare const smootherStep4: import("@thi.ng/shader-ast").TaggedFn3<"vec4", "vec4", "vec4", "vec4">;
+//# sourceMappingURL=smoother-step.d.ts.map

package/math/smoother-step.js

@@ -0,0 +1,30 @@
+import { F, V2, V3, V4 } from "@thi.ng/shader-ast/api/types";
+import { defn, ret } from "@thi.ng/shader-ast/ast/function";
+import { add, div, mul, sub } from "@thi.ng/shader-ast/ast/ops";
+import { clamp01 } from "./clamp.js";
+const $ = (n, type) => defn(type, `smootherStep01${n > 1 ? "_" + n : ""}`, [type], (x) => [
+    // @ts-ignore
+    ret(mul(x, mul(x, mul(x, add(mul(x, sub(mul(x, 6), 15)), 10))))),
+]);
+/**
+ * Specialized version of {@link smootherStep}, assuming edges are 0/1
+ * respectively and `x` is in [0..1]. No clamping performed.
+ *
+ * @param x
+ */
+export const smootherStep01 = $(1, F);
+export const smootherStep01_2 = $(2, V2);
+export const smootherStep01_3 = $(3, V3);
+export const smootherStep01_4 = $(4, V4);
+const $$ = (n, type, fn) => defn(type, `smootherStep${n > 1 ? n : ""}`, [type, type, type], (e0, e1, x) => [ret(fn(clamp01(div(sub(x, e0), sub(e1, e0)))))]);
+/**
+ * Similar to GLSL-native `smoothstep()` but using different, higher degree
+ * polynomial.
+ *
+ * @remarks
+ * Also see {@link smootherStep01}
+ */
+export const smootherStep = $$(1, F, smootherStep01);
+export const smootherStep2 = $$(2, V2, smootherStep01_2);
+export const smootherStep3 = $$(3, V3, smootherStep01_3);
+export const smootherStep4 = $$(4, V4, smootherStep01_4);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/shader-ast-stdlib",
-  "version": "0.13.16",
+  "version": "0.14.0",
   "description": "Function collection for modular GPGPU / shader programming with @thi.ng/shader-ast",
   "type": "module",
   "module": "./index.js",
@@ -34,16 +34,16 @@
     "test": "testament test"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.8.1",
-    "@thi.ng/shader-ast": "^0.12.52"
+    "@thi.ng/api": "^8.8.2",
+    "@thi.ng/shader-ast": "^0.12.54"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.34.8",
-    "@thi.ng/testament": "^0.3.16",
-    "rimraf": "^5.0.0",
+    "@microsoft/api-extractor": "^7.35.3",
+    "@thi.ng/testament": "^0.3.17",
+    "rimraf": "^5.0.1",
     "tools": "^0.0.1",
-    "typedoc": "^0.24.6",
-    "typescript": "^5.0.4"
+    "typedoc": "^0.24.8",
+    "typescript": "^5.1.3"
   },
   "keywords": [
     "ast",
@@ -179,6 +179,9 @@
     "./math/sincos": {
       "default": "./math/sincos.js"
     },
+    "./math/smoother-step": {
+      "default": "./math/smoother-step.js"
+    },
     "./matrix/convert": {
       "default": "./matrix/convert.js"
     },
@@ -330,5 +333,5 @@
     ],
     "year": 2019
   },
-  "gitHead": "26a171dff04a026e5466fc655b91c09e5279db8e\n"
+  "gitHead": "88cfe77770f3b07c788301dccefcb9547cd4aff6\n"
 }