@thi.ng/math 5.3.16 → 5.3.17

package/CHANGELOG.md

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

package/interval.d.ts

@@ -92,11 +92,11 @@ export declare const minNonZero3: FnN3;
  */
 export declare const smin: FnN3;
 /**
- * Smooth maximum. Note: Result values will be slightly larger than max
- * value near max(a,b) + eps due to exponential decay. Higher `k` values
- * reduce the error, but also reduce the smoothing. Recommended k=16.
+ * Smooth maximum. Note: Result values will be slightly larger than max value
+ * near max(a,b) + eps due to exponential decay. Higher `k` values reduce the
+ * error, but also reduce the smoothing. Recommended k=16.
  *
- * {@link https://en.wikipedia.org/wiki/Smooth_maximum}
+ * https://en.wikipedia.org/wiki/Smooth_maximum
  *
  * @param a -
  * @param b -

package/interval.js

@@ -135,11 +135,11 @@ export const minNonZero3 = (a, b, c) => minNonZero2(minNonZero2(a, b), c);
  */
 export const smin = (a, b, k) => smax(a, b, -k);
 /**
- * Smooth maximum. Note: Result values will be slightly larger than max
- * value near max(a,b) + eps due to exponential decay. Higher `k` values
- * reduce the error, but also reduce the smoothing. Recommended k=16.
+ * Smooth maximum. Note: Result values will be slightly larger than max value
+ * near max(a,b) + eps due to exponential decay. Higher `k` values reduce the
+ * error, but also reduce the smoothing. Recommended k=16.
  *
- * {@link https://en.wikipedia.org/wiki/Smooth_maximum}
+ * https://en.wikipedia.org/wiki/Smooth_maximum
  *
  * @param a -
  * @param b -

package/mix.d.ts

@@ -47,19 +47,19 @@ export declare const mixQuadratic: FnN4;
  */
 export declare const mixCubic: FnN5;
 /**
- * Returns hermite interpolation of `a, b, c, d` at normalized position
- * `t`, where `a` and `d` are used as predecessor/successor of `b` / `c`
- * and only inform the tangent of the interpolation curve. The
- * interpolated result is that of `b` and `c`.
+ * Returns hermite interpolation of `a, b, c, d` at normalized position `t`,
+ * where `a` and `d` are used as predecessor/successor of `b` / `c` and only
+ * inform the tangent of the interpolation curve. The interpolated result is
+ * that of `b` and `c`.
  *
  * Assumes all inputs are uniformly spaced. If that's not the case, use
  * {@link mixCubicHermite} with one of the tangent generators supporting
  * non-uniform spacing of points.
  *
- * See: {@link https://www.desmos.com/calculator/j4gf8g9vkr}
+ * See: https://www.desmos.com/calculator/j4gf8g9vkr
  *
  * Source:
- * {@link https://www.musicdsp.org/en/latest/Other/93-hermite-interpollation.html}
+ * https://www.musicdsp.org/en/latest/Other/93-hermite-interpollation.html
  *
  * - {@link mixCubicHermite}
  * - {@link tangentCardinal}
@@ -76,7 +76,7 @@ export declare const mixHermite: FnN5;
  * Computes cubic-hermite interpolation between `a` / `b` at normalized
  * time `t` and using respective tangents `ta` / `tb`.
  *
- * {@link https://en.wikipedia.org/wiki/Cubic_Hermite_spline}
+ * https://en.wikipedia.org/wiki/Cubic_Hermite_spline
  *
  * - {@link mixHermite}
  * - {@link tangentCardinal}
@@ -130,14 +130,14 @@ export declare const mixCubicHermiteFromPoints: FnN5;
  */
 export declare const mixBicubic: (s00: number, s01: number, s02: number, s03: number, s10: number, s11: number, s12: number, s13: number, s20: number, s21: number, s22: number, s23: number, s30: number, s31: number, s32: number, s33: number, u: number, v: number) => number;
 /**
- * Helper function for {@link mixCubicHermite}. Computes cardinal tangents
- * based on point neighbors of a point B (not given), i.e. `a`
- * (predecessor) and `c` (successor) and their times (defaults to
- * uniformly spaced). The optional `tension` parameter can be used to
- * scale the tangent where 0.0 produces a Cardinal spline tangent and
- * 1.0 a Catmull-Rom (opposite to the Wikipedia ref).
+ * Helper function for {@link mixCubicHermite}. Computes cardinal tangents based
+ * on point neighbors of a point B (not given), i.e. `a` (predecessor) and `c`
+ * (successor) and their times (defaults to uniformly spaced). The optional
+ * `tension` parameter can be used to scale the tangent where 0.0 produces a
+ * Cardinal spline tangent and 1.0 a Catmull-Rom (opposite to the Wikipedia
+ * ref).
  *
- * {@link https://en.wikipedia.org/wiki/Cubic_Hermite_spline#Cardinal_spline}
+ * https://en.wikipedia.org/wiki/Cubic_Hermite_spline#Cardinal_spline
  *
  * @param prev -
  * @param next -
@@ -148,15 +148,15 @@ export declare const mixBicubic: (s00: number, s01: number, s02: number, s03: nu
 export declare const tangentCardinal: (prev: number, next: number, scale?: number, ta?: number, tc?: number) => number;
 /**
  * Helper function for {@link mixCubicHermite}. Computes tangent for `curr`,
- * based on 3-point finite difference, where `prev` & `next` are
- * `curr`'s neighbors and the `tX` the three points' respective time
- * values. The latter are equally spaced by default (each 1.0 apart).
+ * based on 3-point finite difference, where `prev` & `next` are `curr`'s
+ * neighbors and the `tX` the three points' respective time values. The latter
+ * are equally spaced by default (each 1.0 apart).
  *
  * Using this function with equal spacing of 1.0 and together with
- * {@link mixCubicHermite} will produce same results as the somewhat
- * optimized variant {@link mixHermite}.
+ * {@link mixCubicHermite} will produce same results as the somewhat optimized
+ * variant {@link mixHermite}.
  *
- * {@link https://en.wikipedia.org/wiki/Cubic_Hermite_spline#Finite_difference}
+ * https://en.wikipedia.org/wiki/Cubic_Hermite_spline#Finite_difference
  *
  * @param prev -
  * @param curr -

package/mix.js

@@ -59,19 +59,19 @@ export const mixCubic = (a, b, c, d, t) => {
     return a * s2 * s + b * 3 * s2 * t + c * 3 * t2 * s + d * t2 * t;
 };
 /**
- * Returns hermite interpolation of `a, b, c, d` at normalized position
- * `t`, where `a` and `d` are used as predecessor/successor of `b` / `c`
- * and only inform the tangent of the interpolation curve. The
- * interpolated result is that of `b` and `c`.
+ * Returns hermite interpolation of `a, b, c, d` at normalized position `t`,
+ * where `a` and `d` are used as predecessor/successor of `b` / `c` and only
+ * inform the tangent of the interpolation curve. The interpolated result is
+ * that of `b` and `c`.
  *
  * Assumes all inputs are uniformly spaced. If that's not the case, use
  * {@link mixCubicHermite} with one of the tangent generators supporting
  * non-uniform spacing of points.
  *
- * See: {@link https://www.desmos.com/calculator/j4gf8g9vkr}
+ * See: https://www.desmos.com/calculator/j4gf8g9vkr
  *
  * Source:
- * {@link https://www.musicdsp.org/en/latest/Other/93-hermite-interpollation.html}
+ * https://www.musicdsp.org/en/latest/Other/93-hermite-interpollation.html
  *
  * - {@link mixCubicHermite}
  * - {@link tangentCardinal}
@@ -92,7 +92,7 @@ export const mixHermite = (a, b, c, d, t) => {
  * Computes cubic-hermite interpolation between `a` / `b` at normalized
  * time `t` and using respective tangents `ta` / `tb`.
  *
- * {@link https://en.wikipedia.org/wiki/Cubic_Hermite_spline}
+ * https://en.wikipedia.org/wiki/Cubic_Hermite_spline
  *
  * - {@link mixHermite}
  * - {@link tangentCardinal}
@@ -163,14 +163,14 @@ export const mixCubicHermiteFromPoints = (a, b, c, d, t) => {
  */
 export const mixBicubic = (s00, s01, s02, s03, s10, s11, s12, s13, s20, s21, s22, s23, s30, s31, s32, s33, u, v) => mixCubicHermiteFromPoints(mixCubicHermiteFromPoints(s00, s01, s02, s03, u), mixCubicHermiteFromPoints(s10, s11, s12, s13, u), mixCubicHermiteFromPoints(s20, s21, s22, s23, u), mixCubicHermiteFromPoints(s30, s31, s32, s33, u), v);
 /**
- * Helper function for {@link mixCubicHermite}. Computes cardinal tangents
- * based on point neighbors of a point B (not given), i.e. `a`
- * (predecessor) and `c` (successor) and their times (defaults to
- * uniformly spaced). The optional `tension` parameter can be used to
- * scale the tangent where 0.0 produces a Cardinal spline tangent and
- * 1.0 a Catmull-Rom (opposite to the Wikipedia ref).
+ * Helper function for {@link mixCubicHermite}. Computes cardinal tangents based
+ * on point neighbors of a point B (not given), i.e. `a` (predecessor) and `c`
+ * (successor) and their times (defaults to uniformly spaced). The optional
+ * `tension` parameter can be used to scale the tangent where 0.0 produces a
+ * Cardinal spline tangent and 1.0 a Catmull-Rom (opposite to the Wikipedia
+ * ref).
  *
- * {@link https://en.wikipedia.org/wiki/Cubic_Hermite_spline#Cardinal_spline}
+ * https://en.wikipedia.org/wiki/Cubic_Hermite_spline#Cardinal_spline
  *
  * @param prev -
  * @param next -
@@ -181,15 +181,15 @@ export const mixBicubic = (s00, s01, s02, s03, s10, s11, s12, s13, s20, s21, s22
 export const tangentCardinal = (prev, next, scale = 0.5, ta = 0, tc = 2) => scale * ((next - prev) / (tc - ta));
 /**
  * Helper function for {@link mixCubicHermite}. Computes tangent for `curr`,
- * based on 3-point finite difference, where `prev` & `next` are
- * `curr`'s neighbors and the `tX` the three points' respective time
- * values. The latter are equally spaced by default (each 1.0 apart).
+ * based on 3-point finite difference, where `prev` & `next` are `curr`'s
+ * neighbors and the `tX` the three points' respective time values. The latter
+ * are equally spaced by default (each 1.0 apart).
  *
  * Using this function with equal spacing of 1.0 and together with
- * {@link mixCubicHermite} will produce same results as the somewhat
- * optimized variant {@link mixHermite}.
+ * {@link mixCubicHermite} will produce same results as the somewhat optimized
+ * variant {@link mixHermite}.
  *
- * {@link https://en.wikipedia.org/wiki/Cubic_Hermite_spline#Finite_difference}
+ * https://en.wikipedia.org/wiki/Cubic_Hermite_spline#Finite_difference
  *
  * @param prev -
  * @param curr -

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/math",
-  "version": "5.3.16",
+  "version": "5.3.17",
   "description": "Assorted common math functions & utilities",
   "type": "module",
   "module": "./index.js",
@@ -37,7 +37,7 @@
     "test": "testament test"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.6.0"
+    "@thi.ng/api": "^8.6.1"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.33.7",
@@ -135,5 +135,5 @@
   "thi.ng": {
     "year": 2013
   },
-  "gitHead": "f445a9cc8022bcdebbf6ff91fd66ced016d72f01\n"
+  "gitHead": "7b2af448da8a63fb21704a79cc4cdf1f3d7d7a64\n"
 }

package/solve.d.ts

@@ -1,16 +1,16 @@
 import type { FnN2 } from "@thi.ng/api";
 /**
- * Produces a new function which computes derivative of the given
- * single-arg function. The extra optional arg `eps` is used to
- * define the step width for computing derived values:
+ * Produces a new function which computes derivative of the given single-arg
+ * function. The extra optional arg `eps` is used to define the step width for
+ * computing derived values:
  *
  * `f'(x) = (f(x + eps) - f(x)) / eps`
  *
- * The original function is assumed to be fully differentiable
- * in the interval the returned function is going to be used.
- * No validity checks of any form are done.
+ * The original function is assumed to be fully differentiable in the interval
+ * the returned function is going to be used. No validity checks of any form are
+ * done.
  *
- * {@link https://en.wikipedia.org/wiki/Derivative#Continuity_and_differentiability}
+ * https://en.wikipedia.org/wiki/Derivative#Continuity_and_differentiability
  *
  * @param fn -
  * @param eps -
@@ -26,13 +26,12 @@ export declare const derivative: (f: (x: number) => number, eps?: number) => (x:
  */
 export declare const solveLinear: FnN2;
 /**
- * Computes solutions for quadratic equation: `ax^2 + bx + c = 0`.
- * Returns array of real solutions.
- * Note: `a` MUST NOT be zero. If the quadratic term is missing,
- * use {@link solveLinear} instead.
+ * Computes solutions for quadratic equation: `ax^2 + bx + c = 0`. Returns array
+ * of real solutions. Note: `a` MUST NOT be zero. If the quadratic term is
+ * missing, use {@link solveLinear} instead.
  *
- * - {@link https://en.wikipedia.org/wiki/Quadratic_function}
- * - {@link https://en.wikipedia.org/wiki/Quadratic_equation}
+ * - https://en.wikipedia.org/wiki/Quadratic_function
+ * - https://en.wikipedia.org/wiki/Quadratic_equation
  *
  * @param a - quadratic coefficient
  * @param b - linear coefficient
@@ -42,11 +41,11 @@ export declare const solveLinear: FnN2;
 export declare const solveQuadratic: (a: number, b: number, c: number, eps?: number) => number[];
 /**
  * Computes solutions for quadratic equation: `ax^3 + bx^2 + c*x + d = 0`.
- * Returns array of solutions, both real & imaginary.
- * Note: `a` MUST NOT be zero. If the cubic term is missing (i.e. zero),
- * use {@link solveQuadratic} or {@link solveLinear} instead.
+ * Returns array of solutions, both real & imaginary. Note: `a` MUST NOT be
+ * zero. If the cubic term is missing (i.e. zero), use {@link solveQuadratic} or
+ * {@link solveLinear} instead.
  *
- * {@link https://en.wikipedia.org/wiki/Cubic_function}
+ * https://en.wikipedia.org/wiki/Cubic_function
  *
  * @param a - cubic coefficient
  * @param b - quadratic coefficient

package/solve.js

@@ -1,17 +1,17 @@
 import { EPS } from "./api.js";
 import { safeDiv } from "./safe-div.js";
 /**
- * Produces a new function which computes derivative of the given
- * single-arg function. The extra optional arg `eps` is used to
- * define the step width for computing derived values:
+ * Produces a new function which computes derivative of the given single-arg
+ * function. The extra optional arg `eps` is used to define the step width for
+ * computing derived values:
  *
  * `f'(x) = (f(x + eps) - f(x)) / eps`
  *
- * The original function is assumed to be fully differentiable
- * in the interval the returned function is going to be used.
- * No validity checks of any form are done.
+ * The original function is assumed to be fully differentiable in the interval
+ * the returned function is going to be used. No validity checks of any form are
+ * done.
  *
- * {@link https://en.wikipedia.org/wiki/Derivative#Continuity_and_differentiability}
+ * https://en.wikipedia.org/wiki/Derivative#Continuity_and_differentiability
  *
  * @param fn -
  * @param eps -
@@ -27,13 +27,12 @@ export const derivative = (f, eps = EPS) => (x) => (f(x + eps) - f(x)) / eps;
  */
 export const solveLinear = (a, b) => safeDiv(-b, a);
 /**
- * Computes solutions for quadratic equation: `ax^2 + bx + c = 0`.
- * Returns array of real solutions.
- * Note: `a` MUST NOT be zero. If the quadratic term is missing,
- * use {@link solveLinear} instead.
+ * Computes solutions for quadratic equation: `ax^2 + bx + c = 0`. Returns array
+ * of real solutions. Note: `a` MUST NOT be zero. If the quadratic term is
+ * missing, use {@link solveLinear} instead.
  *
- * - {@link https://en.wikipedia.org/wiki/Quadratic_function}
- * - {@link https://en.wikipedia.org/wiki/Quadratic_equation}
+ * - https://en.wikipedia.org/wiki/Quadratic_function
+ * - https://en.wikipedia.org/wiki/Quadratic_equation
  *
  * @param a - quadratic coefficient
  * @param b - linear coefficient
@@ -51,11 +50,11 @@ export const solveQuadratic = (a, b, c, eps = 1e-9) => {
 };
 /**
  * Computes solutions for quadratic equation: `ax^3 + bx^2 + c*x + d = 0`.
- * Returns array of solutions, both real & imaginary.
- * Note: `a` MUST NOT be zero. If the cubic term is missing (i.e. zero),
- * use {@link solveQuadratic} or {@link solveLinear} instead.
+ * Returns array of solutions, both real & imaginary. Note: `a` MUST NOT be
+ * zero. If the cubic term is missing (i.e. zero), use {@link solveQuadratic} or
+ * {@link solveLinear} instead.
  *
- * {@link https://en.wikipedia.org/wiki/Cubic_function}
+ * https://en.wikipedia.org/wiki/Cubic_function
  *
  * @param a - cubic coefficient
  * @param b - quadratic coefficient