curvy 1.0.7 → 1.0.9

package/dist/curve/quadratic2d.d.mts

@@ -1,7 +1,7 @@
 import { T as TwoDimensional } from '../shared/curvy.Bf5TIk31.mjs';
 import { Interval } from '../interval.mjs';
 import { Pipeable } from '../pipe.mjs';
-import { Q as QuadraticPolynomial } from '../shared/curvy.NsmY7zcr.mjs';
+import { Q as QuadraticPolynomial } from '../shared/curvy.FDaj5rlj.mjs';
 import { Vector2 } from '../vector/vector2.mjs';
 import { LinearCurve2d } from './linear2d.mjs';
 import '../vector/vector3.mjs';
@@ -10,24 +10,108 @@ import '../vector/vector4.mjs';
 declare const QuadraticCurve2dTypeId: unique symbol;
 type QuadraticCurve2dTypeId = typeof QuadraticCurve2dTypeId;
 
+/**
+ * A quadratic curve in 2D space.
+ *
+ * All fields are readonly and immutable, and all operations create new instances.
+ *
+ * @since 1.0.0
+ */
 interface QuadraticCurve2d extends Pipeable, TwoDimensional<QuadraticPolynomial> {
     readonly [QuadraticCurve2dTypeId]: QuadraticCurve2dTypeId;
 }
+/**
+ * Creates a new `QuadraticCurve2d` instance from polynomial parameters.
+ *
+ * @param c0 - The x polynomial.
+ * @param c1 - The y polynomial.
+ * @returns A new `QuadraticCurve2d` instance.
+ * @since 1.0.0
+ */
 declare const fromPolynomials: (c0: QuadraticPolynomial, c1: QuadraticPolynomial) => QuadraticCurve2d;
+/**
+ * Creates a new `QuadraticCurve2d` instance from pairs of coefficients.
+ *
+ * @param p0 - The x^0 coefficients for the x and y polynomials.
+ * @param p1 - The x^1 coefficients for the x and y polynomials.
+ * @param p2 - The x^2 coefficients for the x and y polynomials.
+ * @returns A new `QuadraticCurve2d` instance.
+ * @since 1.0.0
+ */
 declare const fromPoints: (p0: Vector2, p1: Vector2, p2: Vector2) => QuadraticCurve2d;
+/**
+ * Checks if a value is a `QuadraticCurve2d`.
+ *
+ * @param c - The value to check.
+ * @returns `true` if the value is a `QuadraticCurve2d`, `false` otherwise.
+ * @since 1.0.0
+ */
 declare const isQuadraticCurve2d: (c: unknown) => c is QuadraticCurve2d;
 declare const solve: {
+    /**
+     * Solves the quadratic curve for a given parameter t.
+     *
+     * @param t - The parameter value.
+     * @returns A function that takes a quadratic curve and returns the point on the curve at parameter t.
+     * @since 1.0.0
+     */
     (t: number): (c: QuadraticCurve2d) => Vector2;
+    /**
+     * Solves the quadratic curve for a given parameter t.
+     *
+     * @param c - The quadratic curve to solve.
+     * @param t - The parameter value.
+     * @returns The point on the curve at parameter t.
+     * @since 1.0.0
+     */
     (c: QuadraticCurve2d, t: number): Vector2;
 };
 declare const length: {
+    /**
+     * Computes the length of the quadratic curve over a given interval.
+     *
+     * @param c - The quadratic curve to compute the length of.
+     * @param i - The interval over which to compute the length.
+     * @returns The length of the quadratic curve over the interval.
+     * @since 1.0.0
+     */
     (c: QuadraticCurve2d, i: Interval): number;
+    /**
+     * Computes the length of the quadratic curve over a given interval.
+     *
+     * @param i - The interval over which to compute the length.
+     * @returns A function that takes a quadratic curve and returns the length of the curve over the interval.
+     * @since 1.0.0
+     */
     (i: Interval): (c: QuadraticCurve2d) => number;
 };
+/**
+ * Computes the derivative of a quadratic curve.
+ *
+ * @param c - The quadratic curve to compute the derivative of.
+ * @returns The derivative of the quadratic curve as a linear curve.
+ * @since 1.0.0
+ */
 declare const derivative: (c: QuadraticCurve2d) => LinearCurve2d;
 declare const curvature: {
+    /**
+     * Computes the curvature of the quadratic curve at a given parameter t.
+     *
+     * @param c - The quadratic curve to compute the curvature for.
+     * @param t - The parameter value.
+     * @returns The curvature of the quadratic curve at parameter t.
+     * @since 1.0.0
+     */
     (c: QuadraticCurve2d, t: number): number;
+    /**
+     * Computes the curvature of the quadratic curve at a given parameter t.
+     *
+     * @param t - The parameter value.
+     * @returns A function that takes a quadratic curve and returns the curvature of the curve at parameter t.
+     * @since 1.0.0
+     */
     (t: number): (c: QuadraticCurve2d) => number;
 };
 
-export { type QuadraticCurve2d, curvature, derivative, fromPoints, fromPolynomials, isQuadraticCurve2d, length, solve };
+export { curvature, derivative, fromPoints, fromPolynomials, isQuadraticCurve2d, length, solve };
+export type { QuadraticCurve2d };

package/dist/curve/quadratic2d.d.ts

@@ -1,7 +1,7 @@
 import { T as TwoDimensional } from '../shared/curvy.Bf5TIk31.js';
 import { Interval } from '../interval.js';
 import { Pipeable } from '../pipe.js';
-import { Q as QuadraticPolynomial } from '../shared/curvy.BsHoYJNv.js';
+import { Q as QuadraticPolynomial } from '../shared/curvy.Cg8lZVUz.js';
 import { Vector2 } from '../vector/vector2.js';
 import { LinearCurve2d } from './linear2d.js';
 import '../vector/vector3.js';
@@ -10,24 +10,108 @@ import '../vector/vector4.js';
 declare const QuadraticCurve2dTypeId: unique symbol;
 type QuadraticCurve2dTypeId = typeof QuadraticCurve2dTypeId;
 
+/**
+ * A quadratic curve in 2D space.
+ *
+ * All fields are readonly and immutable, and all operations create new instances.
+ *
+ * @since 1.0.0
+ */
 interface QuadraticCurve2d extends Pipeable, TwoDimensional<QuadraticPolynomial> {
     readonly [QuadraticCurve2dTypeId]: QuadraticCurve2dTypeId;
 }
+/**
+ * Creates a new `QuadraticCurve2d` instance from polynomial parameters.
+ *
+ * @param c0 - The x polynomial.
+ * @param c1 - The y polynomial.
+ * @returns A new `QuadraticCurve2d` instance.
+ * @since 1.0.0
+ */
 declare const fromPolynomials: (c0: QuadraticPolynomial, c1: QuadraticPolynomial) => QuadraticCurve2d;
+/**
+ * Creates a new `QuadraticCurve2d` instance from pairs of coefficients.
+ *
+ * @param p0 - The x^0 coefficients for the x and y polynomials.
+ * @param p1 - The x^1 coefficients for the x and y polynomials.
+ * @param p2 - The x^2 coefficients for the x and y polynomials.
+ * @returns A new `QuadraticCurve2d` instance.
+ * @since 1.0.0
+ */
 declare const fromPoints: (p0: Vector2, p1: Vector2, p2: Vector2) => QuadraticCurve2d;
+/**
+ * Checks if a value is a `QuadraticCurve2d`.
+ *
+ * @param c - The value to check.
+ * @returns `true` if the value is a `QuadraticCurve2d`, `false` otherwise.
+ * @since 1.0.0
+ */
 declare const isQuadraticCurve2d: (c: unknown) => c is QuadraticCurve2d;
 declare const solve: {
+    /**
+     * Solves the quadratic curve for a given parameter t.
+     *
+     * @param t - The parameter value.
+     * @returns A function that takes a quadratic curve and returns the point on the curve at parameter t.
+     * @since 1.0.0
+     */
     (t: number): (c: QuadraticCurve2d) => Vector2;
+    /**
+     * Solves the quadratic curve for a given parameter t.
+     *
+     * @param c - The quadratic curve to solve.
+     * @param t - The parameter value.
+     * @returns The point on the curve at parameter t.
+     * @since 1.0.0
+     */
     (c: QuadraticCurve2d, t: number): Vector2;
 };
 declare const length: {
+    /**
+     * Computes the length of the quadratic curve over a given interval.
+     *
+     * @param c - The quadratic curve to compute the length of.
+     * @param i - The interval over which to compute the length.
+     * @returns The length of the quadratic curve over the interval.
+     * @since 1.0.0
+     */
     (c: QuadraticCurve2d, i: Interval): number;
+    /**
+     * Computes the length of the quadratic curve over a given interval.
+     *
+     * @param i - The interval over which to compute the length.
+     * @returns A function that takes a quadratic curve and returns the length of the curve over the interval.
+     * @since 1.0.0
+     */
     (i: Interval): (c: QuadraticCurve2d) => number;
 };
+/**
+ * Computes the derivative of a quadratic curve.
+ *
+ * @param c - The quadratic curve to compute the derivative of.
+ * @returns The derivative of the quadratic curve as a linear curve.
+ * @since 1.0.0
+ */
 declare const derivative: (c: QuadraticCurve2d) => LinearCurve2d;
 declare const curvature: {
+    /**
+     * Computes the curvature of the quadratic curve at a given parameter t.
+     *
+     * @param c - The quadratic curve to compute the curvature for.
+     * @param t - The parameter value.
+     * @returns The curvature of the quadratic curve at parameter t.
+     * @since 1.0.0
+     */
     (c: QuadraticCurve2d, t: number): number;
+    /**
+     * Computes the curvature of the quadratic curve at a given parameter t.
+     *
+     * @param t - The parameter value.
+     * @returns A function that takes a quadratic curve and returns the curvature of the curve at parameter t.
+     * @since 1.0.0
+     */
     (t: number): (c: QuadraticCurve2d) => number;
 };
 
-export { type QuadraticCurve2d, curvature, derivative, fromPoints, fromPolynomials, isQuadraticCurve2d, length, solve };
+export { curvature, derivative, fromPoints, fromPolynomials, isQuadraticCurve2d, length, solve };
+export type { QuadraticCurve2d };

package/dist/curve/quadratic2d.mjs

@@ -6,19 +6,16 @@ import { make, solve as solve$2, derivative as derivative$2 } from '../polynomia
 import { round } from '../utils.mjs';
 import { make as make$1, magnitude, cross } from '../vector/vector2.mjs';
 import { fromPolynomials as fromPolynomials$2, length as length$2, solve as solve$3, derivative as derivative$3 } from './linear2d.mjs';
-import '../shared/curvy.BDhiZ7He.mjs';
-import '../shared/curvy.BzVmUIKm.mjs';
-import '../shared/curvy.BZ_mTkJe.mjs';
+import '../shared/curvy.r6f1j287.mjs';
+import '../shared/curvy.BxdGW9he.mjs';
+import '../shared/curvy.DJ4xO0al.mjs';
 
-const QuadraticCurve2dTypeId = Symbol(
-  "curvy/curve/quadratic2d"
-);
-class QuadraticCurve2dImpl extends Pipeable {
-  [QuadraticCurve2dTypeId] = QuadraticCurve2dTypeId;
-  x;
-  y;
+var _a, _b;
+const QuadraticCurve2dTypeId = Symbol("curvy/curve/quadratic2d");
+class QuadraticCurve2dImpl extends (_b = Pipeable, _a = QuadraticCurve2dTypeId, _b) {
   constructor(c0, c1) {
     super();
+    this[_a] = QuadraticCurve2dTypeId;
     this.x = c0;
     this.y = c1;
   }
@@ -37,10 +34,7 @@ const fromPoints$1 = (p0, p1, p2) => new QuadraticCurve2dImpl(
 const isQuadraticCurve2d$1 = (c) => typeof c === "object" && c !== null && QuadraticCurve2dTypeId in c;
 const solve$1 = dual(
   2,
-  (c, t) => make$1(
-    solve$2(c.x, t),
-    solve$2(c.y, t)
-  )
+  (c, t) => make$1(solve$2(c.x, t), solve$2(c.y, t))
 );
 const derivative$1 = (c) => fromPolynomials$2(
   derivative$2(c.x),
@@ -62,7 +56,7 @@ const length$1 = dual(2, (c, i) => {
   const d = derivative$1(c);
   const { scale, shift } = scaleShift(biunit, i);
   return round(
-    (GL32_W0 * magnitude(solve$3(d, shift + scale * -GL32_X0)) + GL32_W0 * magnitude(solve$3(d, shift + scale * GL32_X0)) + GL32_W1 * magnitude(solve$3(d, shift + scale * -GL32_X1)) + GL32_W1 * magnitude(solve$3(d, shift + scale * GL32_X1)) + GL32_W2 * magnitude(solve$3(d, shift + scale * -GL32_X2)) + GL32_W2 * magnitude(solve$3(d, shift + scale * GL32_X2)) + GL32_W3 * magnitude(solve$3(d, shift + scale * -GL32_X3)) + GL32_W3 * magnitude(solve$3(d, shift + scale * GL32_X3)) + GL32_W4 * magnitude(solve$3(d, shift + scale * -GL32_X4)) + GL32_W4 * magnitude(solve$3(d, shift + scale * GL32_X4)) + GL32_W5 * magnitude(solve$3(d, shift + scale * -GL32_X5)) + GL32_W5 * magnitude(solve$3(d, shift + scale * GL32_X5)) + GL32_W6 * magnitude(solve$3(d, shift + scale * -GL32_X6)) + GL32_W6 * magnitude(solve$3(d, shift + scale * GL32_X6)) + GL32_W7 * magnitude(solve$3(d, shift + scale * -GL32_X7)) + GL32_W7 * magnitude(solve$3(d, shift + scale * GL32_X7)) + GL32_W8 * magnitude(solve$3(d, shift + scale * -GL32_X8)) + GL32_W8 * magnitude(solve$3(d, shift + scale * GL32_X8)) + GL32_W9 * magnitude(solve$3(d, shift + scale * -GL32_X9)) + GL32_W9 * magnitude(solve$3(d, shift + scale * GL32_X9)) + GL32_W10 * magnitude(solve$3(d, shift + scale * -GL32_X10)) + GL32_W10 * magnitude(solve$3(d, shift + scale * GL32_X10)) + GL32_W11 * magnitude(solve$3(d, shift + scale * -GL32_X11)) + GL32_W11 * magnitude(solve$3(d, shift + scale * GL32_X11)) + GL32_W12 * magnitude(solve$3(d, shift + scale * -GL32_X12)) + GL32_W12 * magnitude(solve$3(d, shift + scale * GL32_X12)) + GL32_W13 * magnitude(solve$3(d, shift + scale * -GL32_X13)) + GL32_W13 * magnitude(solve$3(d, shift + scale * GL32_X13)) + GL32_W14 * magnitude(solve$3(d, shift + scale * -GL32_X14)) + GL32_W14 * magnitude(solve$3(d, shift + scale * GL32_X14)) + GL32_W15 * magnitude(solve$3(d, shift + scale * -GL32_X15)) + GL32_W15 * magnitude(solve$3(d, shift + scale * GL32_X15))) * scale
+    (GL32_W0 * magnitude(solve$3(d, shift + scale * -0.9972638618494816)) + GL32_W0 * magnitude(solve$3(d, shift + scale * GL32_X0)) + GL32_W1 * magnitude(solve$3(d, shift + scale * -0.9856115115452684)) + GL32_W1 * magnitude(solve$3(d, shift + scale * GL32_X1)) + GL32_W2 * magnitude(solve$3(d, shift + scale * -0.9647622555875064)) + GL32_W2 * magnitude(solve$3(d, shift + scale * GL32_X2)) + GL32_W3 * magnitude(solve$3(d, shift + scale * -0.9349060759377397)) + GL32_W3 * magnitude(solve$3(d, shift + scale * GL32_X3)) + GL32_W4 * magnitude(solve$3(d, shift + scale * -0.8963211557660521)) + GL32_W4 * magnitude(solve$3(d, shift + scale * GL32_X4)) + GL32_W5 * magnitude(solve$3(d, shift + scale * -0.84936761373257)) + GL32_W5 * magnitude(solve$3(d, shift + scale * GL32_X5)) + GL32_W6 * magnitude(solve$3(d, shift + scale * -0.7944837959679424)) + GL32_W6 * magnitude(solve$3(d, shift + scale * GL32_X6)) + GL32_W7 * magnitude(solve$3(d, shift + scale * -0.7321821187402897)) + GL32_W7 * magnitude(solve$3(d, shift + scale * GL32_X7)) + GL32_W8 * magnitude(solve$3(d, shift + scale * -0.6630442669302152)) + GL32_W8 * magnitude(solve$3(d, shift + scale * GL32_X8)) + GL32_W9 * magnitude(solve$3(d, shift + scale * -0.5877157572407623)) + GL32_W9 * magnitude(solve$3(d, shift + scale * GL32_X9)) + GL32_W10 * magnitude(solve$3(d, shift + scale * -0.5068999089322294)) + GL32_W10 * magnitude(solve$3(d, shift + scale * GL32_X10)) + GL32_W11 * magnitude(solve$3(d, shift + scale * -0.42135127613063533)) + GL32_W11 * magnitude(solve$3(d, shift + scale * GL32_X11)) + GL32_W12 * magnitude(solve$3(d, shift + scale * -0.33186860228212767)) + GL32_W12 * magnitude(solve$3(d, shift + scale * GL32_X12)) + GL32_W13 * magnitude(solve$3(d, shift + scale * -0.23928736225213706)) + GL32_W13 * magnitude(solve$3(d, shift + scale * GL32_X13)) + GL32_W14 * magnitude(solve$3(d, shift + scale * -0.1444719615827965)) + GL32_W14 * magnitude(solve$3(d, shift + scale * GL32_X14)) + GL32_W15 * magnitude(solve$3(d, shift + scale * -0.04830766568773831)) + GL32_W15 * magnitude(solve$3(d, shift + scale * GL32_X15))) * scale
   );
 });
 const curvature$1 = dual(2, (c, t) => {
@@ -85,3 +79,4 @@ const derivative = derivative$1;
 const curvature = curvature$1;
 
 export { curvature, derivative, fromPoints, fromPolynomials, isQuadraticCurve2d, length, solve };
+//# sourceMappingURL=quadratic2d.mjs.map

package/dist/curve/quadratic2d.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"quadratic2d.mjs","sources":["../../src/curve/quadratic2d.internal.ts","../../src/curve/quadratic2d.ts"],"sourcesContent":["import * as Interval from '../interval'\nimport {\n  GL32_W0,\n  GL32_W1,\n  GL32_W2,\n  GL32_W3,\n  GL32_W4,\n  GL32_W5,\n  GL32_W6,\n  GL32_W7,\n  GL32_W8,\n  GL32_W9,\n  GL32_W10,\n  GL32_W11,\n  GL32_W12,\n  GL32_W13,\n  GL32_W14,\n  GL32_W15,\n  GL32_X0,\n  GL32_X1,\n  GL32_X2,\n  GL32_X3,\n  GL32_X4,\n  GL32_X5,\n  GL32_X6,\n  GL32_X7,\n  GL32_X8,\n  GL32_X9,\n  GL32_X10,\n  GL32_X11,\n  GL32_X12,\n  GL32_X13,\n  GL32_X14,\n  GL32_X15,\n} from '../length'\nimport { Pipeable } from '../pipe'\nimport { dual } from '../pipe'\nimport * as LinearPolynomial from '../polynomial/linear'\nimport * as QuadraticPolynomial from '../polynomial/quadratic'\nimport { round } from '../utils'\nimport * as Vector2 from '../vector/vector2'\nimport * as LinearCurve2d from './linear2d'\nimport type { QuadraticCurve2d } from './quadratic2d'\n\nexport const QuadraticCurve2dTypeId: unique symbol = Symbol('curvy/curve/quadratic2d')\nexport type QuadraticCurve2dTypeId = typeof QuadraticCurve2dTypeId\n\nexport class QuadraticCurve2dImpl extends Pipeable implements QuadraticCurve2d {\n  readonly [QuadraticCurve2dTypeId]: QuadraticCurve2dTypeId = QuadraticCurve2dTypeId\n\n  readonly x: QuadraticPolynomial.QuadraticPolynomial\n  readonly y: QuadraticPolynomial.QuadraticPolynomial\n\n  constructor(\n    c0: QuadraticPolynomial.QuadraticPolynomial,\n    c1: QuadraticPolynomial.QuadraticPolynomial,\n  ) {\n    super()\n    this.x = c0\n    this.y = c1\n  }\n\n  get [0]() {\n    return this.x\n  }\n\n  get [1]() {\n    return this.y\n  }\n}\n\nexport const fromPolynomials: (\n  c0: QuadraticPolynomial.QuadraticPolynomial,\n  c1: QuadraticPolynomial.QuadraticPolynomial,\n) => QuadraticCurve2d = (c0, c1) => new QuadraticCurve2dImpl(c0, c1)\n\nexport const fromPoints: (\n  p0: Vector2.Vector2,\n  p1: Vector2.Vector2,\n  p2: Vector2.Vector2,\n) => QuadraticCurve2d = (p0, p1, p2) =>\n  new QuadraticCurve2dImpl(\n    QuadraticPolynomial.make(p0.x, p1.x, p2.x),\n    QuadraticPolynomial.make(p0.y, p1.y, p2.y),\n  )\n\nexport const isQuadraticCurve2d = (c: unknown): c is QuadraticCurve2d =>\n  typeof c === 'object' && c !== null && QuadraticCurve2dTypeId in c\n\nexport const solve = dual<\n  (t: number) => (c: QuadraticCurve2d) => Vector2.Vector2,\n  (c: QuadraticCurve2d, t: number) => Vector2.Vector2\n>(2, (c: QuadraticCurve2d, t: number) =>\n  Vector2.make(QuadraticPolynomial.solve(c.x, t), QuadraticPolynomial.solve(c.y, t)),\n)\n\nexport const derivative = (c: QuadraticCurve2d) =>\n  LinearCurve2d.fromPolynomials(\n    QuadraticPolynomial.derivative(c.x),\n    QuadraticPolynomial.derivative(c.y),\n  )\n\nexport const length = dual(2, (c: QuadraticCurve2d, i: Interval.Interval) => {\n  if (Interval.size(i) === 0) {\n    return 0\n  }\n\n  if (c.x.c2 === 0 && c.y.c2 === 0) {\n    return LinearCurve2d.length(\n      LinearCurve2d.fromPolynomials(\n        LinearPolynomial.make(c.x.c0, c.x.c1),\n        LinearPolynomial.make(c.y.c0, c.y.c1),\n      ),\n      i,\n    )\n  }\n\n  const d = derivative(c)\n\n  const { scale, shift } = Interval.scaleShift(Interval.biunit, i)\n\n  return round(\n    (GL32_W0 * Vector2.magnitude(LinearCurve2d.solve(d, shift + scale * -GL32_X0)) +\n      GL32_W0 * Vector2.magnitude(LinearCurve2d.solve(d, shift + scale * GL32_X0)) +\n      GL32_W1 * Vector2.magnitude(LinearCurve2d.solve(d, shift + scale * -GL32_X1)) +\n      GL32_W1 * Vector2.magnitude(LinearCurve2d.solve(d, shift + scale * GL32_X1)) +\n      GL32_W2 * Vector2.magnitude(LinearCurve2d.solve(d, shift + scale * -GL32_X2)) +\n      GL32_W2 * Vector2.magnitude(LinearCurve2d.solve(d, shift + scale * GL32_X2)) +\n      GL32_W3 * Vector2.magnitude(LinearCurve2d.solve(d, shift + scale * -GL32_X3)) +\n      GL32_W3 * Vector2.magnitude(LinearCurve2d.solve(d, shift + scale * GL32_X3)) +\n      GL32_W4 * Vector2.magnitude(LinearCurve2d.solve(d, shift + scale * -GL32_X4)) +\n      GL32_W4 * Vector2.magnitude(LinearCurve2d.solve(d, shift + scale * GL32_X4)) +\n      GL32_W5 * Vector2.magnitude(LinearCurve2d.solve(d, shift + scale * -GL32_X5)) +\n      GL32_W5 * Vector2.magnitude(LinearCurve2d.solve(d, shift + scale * GL32_X5)) +\n      GL32_W6 * Vector2.magnitude(LinearCurve2d.solve(d, shift + scale * -GL32_X6)) +\n      GL32_W6 * Vector2.magnitude(LinearCurve2d.solve(d, shift + scale * GL32_X6)) +\n      GL32_W7 * Vector2.magnitude(LinearCurve2d.solve(d, shift + scale * -GL32_X7)) +\n      GL32_W7 * Vector2.magnitude(LinearCurve2d.solve(d, shift + scale * GL32_X7)) +\n      GL32_W8 * Vector2.magnitude(LinearCurve2d.solve(d, shift + scale * -GL32_X8)) +\n      GL32_W8 * Vector2.magnitude(LinearCurve2d.solve(d, shift + scale * GL32_X8)) +\n      GL32_W9 * Vector2.magnitude(LinearCurve2d.solve(d, shift + scale * -GL32_X9)) +\n      GL32_W9 * Vector2.magnitude(LinearCurve2d.solve(d, shift + scale * GL32_X9)) +\n      GL32_W10 * Vector2.magnitude(LinearCurve2d.solve(d, shift + scale * -GL32_X10)) +\n      GL32_W10 * Vector2.magnitude(LinearCurve2d.solve(d, shift + scale * GL32_X10)) +\n      GL32_W11 * Vector2.magnitude(LinearCurve2d.solve(d, shift + scale * -GL32_X11)) +\n      GL32_W11 * Vector2.magnitude(LinearCurve2d.solve(d, shift + scale * GL32_X11)) +\n      GL32_W12 * Vector2.magnitude(LinearCurve2d.solve(d, shift + scale * -GL32_X12)) +\n      GL32_W12 * Vector2.magnitude(LinearCurve2d.solve(d, shift + scale * GL32_X12)) +\n      GL32_W13 * Vector2.magnitude(LinearCurve2d.solve(d, shift + scale * -GL32_X13)) +\n      GL32_W13 * Vector2.magnitude(LinearCurve2d.solve(d, shift + scale * GL32_X13)) +\n      GL32_W14 * Vector2.magnitude(LinearCurve2d.solve(d, shift + scale * -GL32_X14)) +\n      GL32_W14 * Vector2.magnitude(LinearCurve2d.solve(d, shift + scale * GL32_X14)) +\n      GL32_W15 * Vector2.magnitude(LinearCurve2d.solve(d, shift + scale * -GL32_X15)) +\n      GL32_W15 * Vector2.magnitude(LinearCurve2d.solve(d, shift + scale * GL32_X15))) *\n      scale,\n  )\n})\n\nexport const curvature = dual(2, (c: QuadraticCurve2d, t: number) => {\n  const d = derivative(c)\n  const v = LinearCurve2d.solve(d, t)\n  const a = LinearCurve2d.derivative(d)\n\n  const vMag = Vector2.magnitude(v)\n\n  if (vMag === 0) {\n    return 0\n  }\n\n  return round(Math.abs(Vector2.cross(v, a)) / vMag ** 3)\n})\n","import type { TwoDimensional } from '../dimensions'\nimport type { Interval } from '../interval'\nimport type { Pipeable } from '../pipe'\nimport type { QuadraticPolynomial } from '../polynomial/quadratic'\nimport type { Vector2 } from '../vector/vector2'\nimport type { LinearCurve2d } from './linear2d'\nimport type { QuadraticCurve2dTypeId } from './quadratic2d.internal'\nimport * as internal from './quadratic2d.internal'\n\n/**\n * A quadratic curve in 2D space.\n *\n * All fields are readonly and immutable, and all operations create new instances.\n *\n * @since 1.0.0\n */\nexport interface QuadraticCurve2d extends Pipeable, TwoDimensional<QuadraticPolynomial> {\n  readonly [QuadraticCurve2dTypeId]: QuadraticCurve2dTypeId\n}\n\n/**\n * Creates a new `QuadraticCurve2d` instance from polynomial parameters.\n *\n * @param c0 - The x polynomial.\n * @param c1 - The y polynomial.\n * @returns A new `QuadraticCurve2d` instance.\n * @since 1.0.0\n */\nexport const fromPolynomials: (\n  c0: QuadraticPolynomial,\n  c1: QuadraticPolynomial,\n) => QuadraticCurve2d = internal.fromPolynomials\n\n/**\n * Creates a new `QuadraticCurve2d` instance from pairs of coefficients.\n *\n * @param p0 - The x^0 coefficients for the x and y polynomials.\n * @param p1 - The x^1 coefficients for the x and y polynomials.\n * @param p2 - The x^2 coefficients for the x and y polynomials.\n * @returns A new `QuadraticCurve2d` instance.\n * @since 1.0.0\n */\nexport const fromPoints: (p0: Vector2, p1: Vector2, p2: Vector2) => QuadraticCurve2d =\n  internal.fromPoints\n\n/**\n * Checks if a value is a `QuadraticCurve2d`.\n *\n * @param c - The value to check.\n * @returns `true` if the value is a `QuadraticCurve2d`, `false` otherwise.\n * @since 1.0.0\n */\nexport const isQuadraticCurve2d: (c: unknown) => c is QuadraticCurve2d = internal.isQuadraticCurve2d\n\nexport const solve: {\n  /**\n   * Solves the quadratic curve for a given parameter t.\n   *\n   * @param t - The parameter value.\n   * @returns A function that takes a quadratic curve and returns the point on the curve at parameter t.\n   * @since 1.0.0\n   */\n  (t: number): (c: QuadraticCurve2d) => Vector2\n  /**\n   * Solves the quadratic curve for a given parameter t.\n   *\n   * @param c - The quadratic curve to solve.\n   * @param t - The parameter value.\n   * @returns The point on the curve at parameter t.\n   * @since 1.0.0\n   */\n  (c: QuadraticCurve2d, t: number): Vector2\n} = internal.solve\n\nexport const length: {\n  /**\n   * Computes the length of the quadratic curve over a given interval.\n   *\n   * @param c - The quadratic curve to compute the length of.\n   * @param i - The interval over which to compute the length.\n   * @returns The length of the quadratic curve over the interval.\n   * @since 1.0.0\n   */\n  (c: QuadraticCurve2d, i: Interval): number\n  /**\n   * Computes the length of the quadratic curve over a given interval.\n   *\n   * @param i - The interval over which to compute the length.\n   * @returns A function that takes a quadratic curve and returns the length of the curve over the interval.\n   * @since 1.0.0\n   */\n  (i: Interval): (c: QuadraticCurve2d) => number\n} = internal.length\n\n/**\n * Computes the derivative of a quadratic curve.\n *\n * @param c - The quadratic curve to compute the derivative of.\n * @returns The derivative of the quadratic curve as a linear curve.\n * @since 1.0.0\n */\nexport const derivative: (c: QuadraticCurve2d) => LinearCurve2d = internal.derivative\n\nexport const curvature: {\n  /**\n   * Computes the curvature of the quadratic curve at a given parameter t.\n   *\n   * @param c - The quadratic curve to compute the curvature for.\n   * @param t - The parameter value.\n   * @returns The curvature of the quadratic curve at parameter t.\n   * @since 1.0.0\n   */\n  (c: QuadraticCurve2d, t: number): number\n  /**\n   * Computes the curvature of the quadratic curve at a given parameter t.\n   *\n   * @param t - The parameter value.\n   * @returns A function that takes a quadratic curve and returns the curvature of the curve at parameter t.\n   * @since 1.0.0\n   */\n  (t: number): (c: QuadraticCurve2d) => number\n} = internal.curvature\n"],"names":["fromPolynomials","fromPoints","QuadraticPolynomial.make","isQuadraticCurve2d","solve","Vector2.make","QuadraticPolynomial.solve","derivative","LinearCurve2d.fromPolynomials","QuadraticPolynomial.derivative","length","Interval.size","LinearCurve2d.length","LinearPolynomial.make","Interval.scaleShift","Interval.biunit","Vector2.magnitude","LinearCurve2d.solve","curvature","LinearCurve2d.derivative","Vector2.cross","internal.fromPolynomials","internal.fromPoints","internal.isQuadraticCurve2d","internal.solve","internal.length","internal.derivative","internal.curvature"],"mappings":"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"}

package/dist/interval.d.mts

@@ -1,58 +1,251 @@
 import { Pipeable } from './pipe.mjs';
 
+/**
+ * A mathematical interval.
+ *
+ * All fields are readonly and immutable, and all operations create new instances.
+ *
+ * @since 1.0.0
+ */
 interface Interval extends Pipeable {
     readonly start: number;
     readonly end: number;
 }
+/**
+ * Checks if a value is an `Interval`.
+ *
+ * @param v - The value to check.
+ * @returns `true` if the value is an `Interval`, `false` otherwise.
+ * @since 1.0.0
+ */
 declare const isInterval: (v: unknown) => v is Interval;
 declare const make: {
+    /**
+     * Creates a new `Interval` instance.
+     *
+     * @param point - The point of the interval.
+     * @returns A new `Interval` instance.
+     * @since 1.0.0
+     */
     (point: number): Interval;
+    /**
+     * Creates a new `Interval` instance.
+     *
+     * @param start - The start of the interval.
+     * @param end - The end of the interval.
+     * @returns A new `Interval` instance.
+     * @since 1.0.0
+     */
     (start: number, end: number): Interval;
 };
 declare const fromSize: {
+    /**
+     * Creates a new `Interval` instance from a size.
+     *
+     * @param size - The size of the interval.
+     * @returns A new `Interval` instance.
+     * @since 1.0.0
+     */
     (size: number): Interval;
+    /**
+     * Creates a new `Interval` instance from a size.
+     *
+     * @param size - The size of the interval.
+     * @param start - The start of the interval.
+     * @returns A new `Interval` instance.
+     * @since 1.0.0
+     */
     (start: number, size: number): Interval;
 };
+/**
+ * Creates a new `Interval` instance from a minimum and maximum value.
+ *
+ * @param values - The minimum and maximum values of the interval.
+ * @returns A new `Interval` instance.
+ * @since 1.0.0
+ */
 declare const fromMinMax: (...values: ReadonlyArray<number>) => Interval;
+/**
+ * Calculates the size of an interval.
+ *
+ * @param interval - The interval to calculate the size of.
+ * @returns The size of the interval.
+ * @since 1.0.0
+ */
 declare const size: (i: Interval) => number;
 declare const contains: {
+    /**
+     * Checks if a value is contained within an interval.
+     *
+     * @param interval - The interval to check.
+     * @param value - The value to check.
+     * @param options - Options for the check.
+     * @returns `true` if the value is contained within the interval, `false` otherwise.
+     * @since 1.0.0
+     */
     (interval: Interval, value: number, options?: {
         includeStart?: boolean;
         includeEnd?: boolean;
     }): boolean;
+    /**
+     * Checks if a value is contained within an interval.
+     *
+     * @param value - The value to check.
+     * @param options - Options for the check.
+     * @returns A function that takes an interval and returns `true` if the value is contained within the interval, `false` otherwise.
+     * @since 1.0.0
+     */
     (value: number, options?: {
         includeStart?: boolean;
         includeEnd?: boolean;
     }): (interval: Interval) => boolean;
 };
 declare const filter: {
+    /**
+     * Filters a value to be within an interval.
+     *
+     * @param interval - The interval to filter the value to.
+     * @param value - The value to filter.
+     * @param options - Options for the filter.
+     * @returns The filtered value.
+     * @since 1.0.0
+     */
     <V extends ReadonlyArray<number>>(interval: Interval, value: V, options?: {
         includeStart?: boolean;
         includeEnd?: boolean;
     }): V;
+    /**
+     * Filters a value to be within an interval.
+     *
+     * @param value - The value to filter.
+     * @param options - Options for the filter.
+     * @returns A function that takes an interval and returns the filtered value.
+     * @since 1.0.0
+     */
     <V extends ReadonlyArray<number>>(value: V, options?: {
         includeStart?: boolean;
         includeEnd?: boolean;
     }): (interval: Interval) => V;
 };
 declare const clamp: {
+    /**
+     * Clamps a value to be within an interval.
+     *
+     * @param interval - The interval to clamp the value to.
+     * @param value - The value to clamp.
+     * @returns The clamped value.
+     * @since 1.0.0
+     */
     (interval: Interval, value: number): number;
+    /**
+     * Clamps a value to be within an interval.
+     *
+     * @param value - The value to clamp.
+     * @returns A function that takes an interval and returns the clamped value.
+     * @since 1.0.0
+     */
     (value: number): (interval: Interval) => number;
+    /**
+     * Clamps an array of values to be within an interval.
+     *
+     * @param interval - The interval to clamp the values to.
+     * @param value - The values to clamp.
+     * @returns The clamped values.
+     * @since 1.0.0
+     */
     (interval: Interval, value: ReadonlyArray<number>): ReadonlyArray<number>;
+    /**
+     * Clamps an array of values to be within an interval.
+     *
+     * @param value - The values to clamp.
+     * @returns A function that takes an interval and returns the clamped values.
+     * @since 1.0.0
+     */
     (value: ReadonlyArray<number>): (interval: Interval) => ReadonlyArray<number>;
 };
+/**
+ * The unit interval, which is the interval [0, 1].
+ *
+ * @since 1.0.0
+ */
 declare const unit: Interval;
+/**
+ * The biunit interval, which is the interval [-1, 1].
+ *
+ * @since 1.0.0
+ */
 declare const biunit: Interval;
+/**
+ * Linearly interpolates a value within an interval.
+ *
+ * @param interval - The interval to interpolate within.
+ * @param t - The interpolation factor, typically between 0 and 1.
+ * @returns The interpolated value.
+ * @since 1.0.0
+ */
 declare const lerp: (interval: Interval, t: number) => number;
+/**
+ * Creates a linear interpolation function for an interval.
+ *
+ * @param interval - The interval to create the interpolation function for.
+ * @returns A function that takes a factor `t` and returns the interpolated value.
+ * @since 1.0.0
+ */
 declare const toLerpFn: (interval: Interval) => (t: number) => number;
+/**
+ * Normalizes a value within an interval.
+ *
+ * @param interval - The interval to normalize within.
+ * @param x - The value to normalize.
+ * @returns The normalized value.
+ * @since 1.0.0
+ */
 declare const normalize: (interval: Interval, x: number) => number;
+/**
+ * Creates a normalization function for an interval.
+ *
+ * @param interval - The interval to create the normalization function for.
+ * @returns A function that takes a value `x` and returns the normalized value.
+ * @since 1.0.0
+ */
 declare const toNormalizeFn: (interval: Interval) => (x: number) => number;
+/**
+ * Remaps a value from one interval to another.
+ *
+ * @param source - The source interval.
+ * @param target - The target interval.
+ * @param x - The value to remap.
+ * @returns The remapped value.
+ * @since 1.0.0
+ */
 declare const remap: (source: Interval, target: Interval, x: number) => number;
+/**
+ * Creates a remapping function for an interval.
+ *
+ * @param source - The source interval.
+ * @param target - The target interval.
+ * @returns A function that takes a value `x` and returns the remapped value.
+ * @since 1.0.0
+ */
 declare const toRemapFn: (source: Interval, target: Interval) => (x: number) => number;
+/**
+ * Calculates the scale and shift needed to map a source interval to a target interval.
+ *
+ * @param source - The source interval.
+ * @param target - The target interval.
+ * @returns An object containing the scale and shift values.
+ * @since 1.0.0
+ */
+declare const scaleShift: (source: Interval, target: Interval) => ScaleShift;
+/**
+ * The scale and shift needed to map a source interval to a target interval.
+ *
+ * @since 1.0.0
+ */
 interface ScaleShift {
     readonly scale: number;
     readonly shift: number;
 }
-declare const scaleShift: (source: Interval, target: Interval) => ScaleShift;
 
-export { type Interval, type ScaleShift, biunit, clamp, contains, filter, fromMinMax, fromSize, isInterval, lerp, make, normalize, remap, scaleShift, size, toLerpFn, toNormalizeFn, toRemapFn, unit };
+export { biunit, clamp, contains, filter, fromMinMax, fromSize, isInterval, lerp, make, normalize, remap, scaleShift, size, toLerpFn, toNormalizeFn, toRemapFn, unit };
+export type { Interval, ScaleShift };