curvy 1.0.9 → 2.0.0-alpha.2

package/dist/shared/characteristic-B9nCh_cx.mjs

@@ -0,0 +1,104 @@
+import { t as __exportAll } from "./chunk-25Hzd3z8.mjs";
+import { roundDown } from "../number.mjs";
+import { a as vectorProductLeft, n as make } from "./matrix4x4-Ck2WROK-.mjs";
+import { r as fromVector } from "./cubic-CpHAx8cC.mjs";
+//#region src/characteristic/characteristic.ts
+var characteristic_exports = /* @__PURE__ */ __exportAll({
+	apply: () => apply,
+	cubicBasisSpline: () => cubicBasisSpline,
+	cubicBezier: () => cubicBezier,
+	cubicCardinal: () => cubicCardinal,
+	cubicCatmullRom: () => cubicCatmullRom,
+	cubicHermite: () => cubicHermite
+});
+/**
+* The cubic Bézier characteristic matrix.
+*
+* Maps Bernstein-basis control points `(P₀, P₁, P₂, P₃)` to monomial cubic
+* coefficients `(c₀, c₁, c₂, c₃)` for `c₀ + c₁·t + c₂·t² + c₃·t³`. The matrix
+* IS the Bézier spline family — combined with control points (via {@link apply}),
+* it produces the cubic polynomial that parameterizes the curve.
+*
+* @since 2.1.0
+*/
+const cubicBezier = make(1, 0, 0, 0, -3, 3, 0, 0, 3, -6, 3, 0, -1, 3, -3, 1);
+/**
+* The cubic Hermite characteristic matrix.
+*
+* Maps Hermite control data `(P₀, V₀, P₁, V₁)` — two endpoints and two
+* tangent vectors — to monomial cubic coefficients.
+*
+* @since 2.1.0
+*/
+const cubicHermite = make(1, 0, 0, 0, 0, 1, 0, 0, -3, -2, 3, -1, 2, 1, -2, 1);
+/**
+* The uniform cubic B-spline (basis spline) characteristic matrix.
+*
+* Maps a window of four control points to the monomial cubic coefficients
+* of one segment of the corresponding uniform cubic B-spline. Stride-1
+* application produces a C² piecewise spline; the curve does not generally
+* pass through the control points.
+*
+* @since 2.1.0
+*/
+const cubicBasisSpline = make(1 / 6, 4 / 6, roundDown(1 / 6), 0, -.5, 0, .5, 0, .5, -1, .5, 0, -1 / 6, .5, -.5, 1 / 6);
+const cardinalCache = /* @__PURE__ */ new Map();
+/**
+* The cubic Cardinal spline characteristic matrix, parameterized by tension.
+*
+* Maps four control points to the monomial cubic coefficients of one
+* Cardinal segment. The tension `s` controls how tightly the curve hugs
+* the control points: `s = 0` produces straight-line segments between
+* adjacent points, `s = 0.5` is the Catmull-Rom variant (see
+* {@link cubicCatmullRom}), and higher values produce looser, more curved
+* shapes.
+*
+* Cached per tension value — repeated calls with the same tension return
+* the same matrix instance.
+*
+* @param tension - The tension parameter.
+* @returns The characteristic matrix for that tension.
+* @since 2.1.0
+*/
+const cubicCardinal = (tension) => {
+	let m = cardinalCache.get(tension);
+	if (m === void 0) {
+		m = make(0, 1, 0, 0, -tension, 0, tension, 0, 2 * tension, tension - 3, 3 - 2 * tension, -tension, -tension, 2 - tension, tension - 2, tension);
+		cardinalCache.set(tension, m);
+	}
+	return m;
+};
+/**
+* The cubic Catmull-Rom characteristic matrix — Cardinal with tension `0.5`.
+* The most common Cardinal-family variant; reused widely enough to deserve
+* a constant.
+*
+* @since 2.1.0
+*/
+const cubicCatmullRom = cubicCardinal(.5);
+/**
+* Applies a characteristic matrix to N channels of control values, producing
+* N cubic polynomials in monomial form.
+*
+* Each channel is a `Vector4` packing one axis's values across the four
+* control points: `(v₀, v₁, v₂, v₃)`. The result tuple has the same arity
+* as the input.
+*
+* The polynomial 2D spline pipeline applies this with two channels (x, y);
+* the rational 2D pipeline uses three (x, y, w) where `w` is the projective
+* denominator. Higher channel counts generalize to 3D, rational 3D, and
+* beyond — the characteristic matrix doesn't care about the geometric
+* domain, only about how to combine four samples per channel.
+*
+* @param matrix - The characteristic matrix of the spline family.
+* @param channels - One `Vector4` per output polynomial, packing the four control values for that channel.
+* @returns A tuple of cubic polynomials, one per input channel.
+* @since 2.1.0
+*/
+const apply = (matrix, ...channels) => {
+	return channels.map((c) => fromVector(vectorProductLeft(matrix, c)));
+};
+//#endregion
+export { cubicCardinal as a, cubicBezier as i, characteristic_exports as n, cubicHermite as o, cubicBasisSpline as r, apply as t };
+
+//# sourceMappingURL=characteristic-B9nCh_cx.mjs.map

package/dist/shared/characteristic-B9nCh_cx.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"characteristic-B9nCh_cx.mjs","names":["Matrix4x4.make","CubicPolynomial.fromVector","Matrix4x4.vectorProductLeft"],"sources":["../../src/characteristic/characteristic.ts"],"sourcesContent":["import * as Matrix4x4 from '../matrix/matrix4x4'\nimport * as CubicPolynomial from '../polynomial/cubic'\nimport { roundDown } from '../number'\nimport type * as Vector4 from '../vector/vector4'\n\n/**\n * The cubic Bézier characteristic matrix.\n *\n * Maps Bernstein-basis control points `(P₀, P₁, P₂, P₃)` to monomial cubic\n * coefficients `(c₀, c₁, c₂, c₃)` for `c₀ + c₁·t + c₂·t² + c₃·t³`. The matrix\n * IS the Bézier spline family — combined with control points (via {@link apply}),\n * it produces the cubic polynomial that parameterizes the curve.\n *\n * @since 2.1.0\n */\nexport const cubicBezier: Matrix4x4.Matrix4x4 = Matrix4x4.make(\n  1,\n  0,\n  0,\n  0,\n  -3,\n  3,\n  0,\n  0,\n  3,\n  -6,\n  3,\n  0,\n  -1,\n  3,\n  -3,\n  1,\n)\n\n/**\n * The cubic Hermite characteristic matrix.\n *\n * Maps Hermite control data `(P₀, V₀, P₁, V₁)` — two endpoints and two\n * tangent vectors — to monomial cubic coefficients.\n *\n * @since 2.1.0\n */\nexport const cubicHermite: Matrix4x4.Matrix4x4 = Matrix4x4.make(\n  1,\n  0,\n  0,\n  0,\n  0,\n  1,\n  0,\n  0,\n  -3,\n  -2,\n  3,\n  -1,\n  2,\n  1,\n  -2,\n  1,\n)\n\n/**\n * The uniform cubic B-spline (basis spline) characteristic matrix.\n *\n * Maps a window of four control points to the monomial cubic coefficients\n * of one segment of the corresponding uniform cubic B-spline. Stride-1\n * application produces a C² piecewise spline; the curve does not generally\n * pass through the control points.\n *\n * @since 2.1.0\n */\nexport const cubicBasisSpline: Matrix4x4.Matrix4x4 = Matrix4x4.make(\n  1 / 6,\n  4 / 6,\n  roundDown(1 / 6),\n  0,\n  -0.5,\n  0,\n  0.5,\n  0,\n  0.5,\n  -1,\n  0.5,\n  0,\n  -1 / 6,\n  0.5,\n  -0.5,\n  1 / 6,\n)\n\nconst cardinalCache = new Map<number, Matrix4x4.Matrix4x4>()\n\n/**\n * The cubic Cardinal spline characteristic matrix, parameterized by tension.\n *\n * Maps four control points to the monomial cubic coefficients of one\n * Cardinal segment. The tension `s` controls how tightly the curve hugs\n * the control points: `s = 0` produces straight-line segments between\n * adjacent points, `s = 0.5` is the Catmull-Rom variant (see\n * {@link cubicCatmullRom}), and higher values produce looser, more curved\n * shapes.\n *\n * Cached per tension value — repeated calls with the same tension return\n * the same matrix instance.\n *\n * @param tension - The tension parameter.\n * @returns The characteristic matrix for that tension.\n * @since 2.1.0\n */\nexport const cubicCardinal = (tension: number): Matrix4x4.Matrix4x4 => {\n  let m = cardinalCache.get(tension)\n  if (m === undefined) {\n    m = Matrix4x4.make(\n      0,\n      1,\n      0,\n      0,\n      -tension,\n      0,\n      tension,\n      0,\n      2 * tension,\n      tension - 3,\n      3 - 2 * tension,\n      -tension,\n      -tension,\n      2 - tension,\n      tension - 2,\n      tension,\n    )\n    cardinalCache.set(tension, m)\n  }\n  return m\n}\n\n/**\n * The cubic Catmull-Rom characteristic matrix — Cardinal with tension `0.5`.\n * The most common Cardinal-family variant; reused widely enough to deserve\n * a constant.\n *\n * @since 2.1.0\n */\nexport const cubicCatmullRom: Matrix4x4.Matrix4x4 = cubicCardinal(0.5)\n\n/**\n * Applies a characteristic matrix to N channels of control values, producing\n * N cubic polynomials in monomial form.\n *\n * Each channel is a `Vector4` packing one axis's values across the four\n * control points: `(v₀, v₁, v₂, v₃)`. The result tuple has the same arity\n * as the input.\n *\n * The polynomial 2D spline pipeline applies this with two channels (x, y);\n * the rational 2D pipeline uses three (x, y, w) where `w` is the projective\n * denominator. Higher channel counts generalize to 3D, rational 3D, and\n * beyond — the characteristic matrix doesn't care about the geometric\n * domain, only about how to combine four samples per channel.\n *\n * @param matrix - The characteristic matrix of the spline family.\n * @param channels - One `Vector4` per output polynomial, packing the four control values for that channel.\n * @returns A tuple of cubic polynomials, one per input channel.\n * @since 2.1.0\n */\nexport const apply = <const Channels extends ReadonlyArray<Vector4.Vector4>>(\n  matrix: Matrix4x4.Matrix4x4,\n  ...channels: Channels\n): { readonly [K in keyof Channels]: CubicPolynomial.CubicPolynomial } => {\n  const result = channels.map((c) =>\n    CubicPolynomial.fromVector(Matrix4x4.vectorProductLeft(matrix, c)),\n  )\n  return result as { readonly [K in keyof Channels]: CubicPolynomial.CubicPolynomial }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAeA,MAAa,cAAmCA,KAC9C,GACA,GACA,GACA,GACA,IACA,GACA,GACA,GACA,GACA,IACA,GACA,GACA,IACA,GACA,IACA,EACD;;;;;;;;;AAUD,MAAa,eAAoCA,KAC/C,GACA,GACA,GACA,GACA,GACA,GACA,GACA,GACA,IACA,IACA,GACA,IACA,GACA,GACA,IACA,EACD;;;;;;;;;;;AAYD,MAAa,mBAAwCA,KACnD,IAAI,GACJ,IAAI,GACJ,UAAU,IAAI,EAAE,EAChB,GACA,KACA,GACA,IACA,GACA,IACA,IACA,IACA,GACA,KAAK,GACL,IACA,KACA,IAAI,EACL;AAED,MAAM,gCAAgB,IAAI,KAAkC;;;;;;;;;;;;;;;;;;AAmB5D,MAAa,iBAAiB,YAAyC;CACrE,IAAI,IAAI,cAAc,IAAI,QAAQ;CAClC,IAAI,MAAM,KAAA,GAAW;EACnB,IAAIA,KACF,GACA,GACA,GACA,GACA,CAAC,SACD,GACA,SACA,GACA,IAAI,SACJ,UAAU,GACV,IAAI,IAAI,SACR,CAAC,SACD,CAAC,SACD,IAAI,SACJ,UAAU,GACV,QACD;EACD,cAAc,IAAI,SAAS,EAAE;;CAE/B,OAAO;;;;;;;;;AAUT,MAAa,kBAAuC,cAAc,GAAI;;;;;;;;;;;;;;;;;;;;AAqBtE,MAAa,SACX,QACA,GAAG,aACqE;CAIxE,OAHe,SAAS,KAAK,MAC3BC,WAA2BC,kBAA4B,QAAQ,EAAE,CAAC,CAEvD"}

package/dist/shared/chunk-25Hzd3z8.mjs

@@ -0,0 +1,13 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+export { __exportAll as t };