@weasel-js/geom 1.7.3 → 1.8.1

package/dist/nd/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The cubic control points that make a curve leave a port along its normal and
+ * arrive at the next against that port's normal — what makes a routed edge read
+ * as plugged into a box rather than aimed at it.
+ *
+ * The rule is stated once, over loose components, and published as is from
+ * `./nd`; the 2D barrel and `./3d` each wrap it in their own currency. Every
+ * operation here is closed on the plane z = 0, so a planar problem answered
+ * through the 3D wrapper returns the same numbers as through the 2D one, not an
+ * approximation of them.
+ */
+/** How far a control point reaches toward the other end, as a fraction of the
+ *  straight-line distance between the two. */
+declare const PORT_REACH = 0.4;
+/**
+ * `[c1, c2]` for the cubic from `a` to `b`.
+ *
+ * A null normal falls back to a plain lerp along the chord, which is what makes
+ * an unported waypoint curve smoothly instead of kinking. The two ends are not
+ * symmetric: `outNormal` points the way the curve departs, while `inNormal`
+ * points out of the receiving port, so `c2` is pushed *along* it to arrive
+ * against it.
+ */
+declare function portControls(a: readonly number[], b: readonly number[], outNormal: readonly number[] | null | undefined, inNormal: readonly number[] | null | undefined, reach?: number): [number[], number[]];
+/** A port curve sampled into `samples` points, excluding its start. */
+declare function portCurvePoints(a: readonly number[], b: readonly number[], outNormal: readonly number[] | null | undefined, inNormal: readonly number[] | null | undefined, samples: number, reach?: number): number[][];
+/** A cubic evaluated at `t`, component-wise, in whatever dimension it was given. */
+declare function cubicAt(p0: readonly number[], p1: readonly number[], p2: readonly number[], p3: readonly number[], t: number): number[];
+
+export { PORT_REACH, cubicAt, portControls, portCurvePoints };

package/dist/nd/index.js

@@ -0,0 +1,3 @@
+export { PORT_REACH, cubicAt, portControls, portCurvePoints } from '../chunk-YQADYJJ7.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/nd/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weasel-js/geom",
-  "version": "1.7.3",
+  "version": "1.8.1",
   "description": "Pure geometry kernel for @weasel-js/core: affine, box, curve, polyline, the Path command stream and its math, and easing curves in 2D. Dependency-free core; curve representations in ./curves, tessellation in ./tessellate (earcut), polygon booleans and path splitting in ./booleans (polygon-clipping), vectors, quaternions, 4x4 matrices and ray intersection in ./3d.",
   "license": "MIT",
   "type": "module",
@@ -21,6 +21,10 @@
       "import": "./dist/3d/index.js",
       "types": "./dist/3d/index.d.ts"
     },
+    "./nd": {
+      "import": "./dist/nd/index.js",
+      "types": "./dist/nd/index.d.ts"
+    },
     "./curves": {
       "import": "./dist/curves/index.js",
       "types": "./dist/curves/index.d.ts"

package/dist/chunk-TXEGHCJ4.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/portCurve.ts"],"names":[],"mappings":";AAaO,IAAM,UAAA,GAAa;AAWnB,SAAS,aACd,CAAA,EACA,CAAA,EACA,SAAA,EACA,QAAA,EACA,QAAgB,UAAA,EACM;AACtB,EAAA,IAAI,GAAA,GAAM,CAAA;AACV,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,CAAA,CAAE,QAAQ,CAAA,EAAA,EAAK;AACjC,IAAA,MAAM,CAAA,GAAI,CAAA,CAAE,CAAC,CAAA,GAAK,EAAE,CAAC,CAAA;AACrB,IAAA,GAAA,IAAO,CAAA,GAAI,CAAA;AAAA,EACb;AACA,EAAA,MAAM,IAAA,GAAO,IAAA,CAAK,IAAA,CAAK,GAAG,CAAA,GAAI,KAAA;AAE9B,EAAA,MAAM,KAAe,EAAC;AACtB,EAAA,MAAM,KAAe,EAAC;AACtB,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,CAAA,CAAE,QAAQ,CAAA,EAAA,EAAK;AACjC,IAAA,MAAM,EAAA,GAAK,EAAE,CAAC,CAAA;AACd,IAAA,MAAM,EAAA,GAAK,EAAE,CAAC,CAAA;AACd,IAAA,EAAA,CAAG,IAAA,CAAK,SAAA,IAAa,IAAA,GAAO,EAAA,GAAA,CAAM,EAAA,GAAK,EAAA,IAAM,KAAA,GAAQ,EAAA,GAAK,SAAA,CAAU,CAAC,CAAA,GAAK,IAAI,CAAA;AAC9E,IAAA,EAAA,CAAG,IAAA,CAAK,QAAA,IAAY,IAAA,GAAO,EAAA,GAAA,CAAM,EAAA,GAAK,EAAA,IAAM,KAAA,GAAQ,EAAA,GAAK,QAAA,CAAS,CAAC,CAAA,GAAK,IAAI,CAAA;AAAA,EAC9E;AACA,EAAA,OAAO,CAAC,IAAI,EAAE,CAAA;AAChB;AAGO,SAAS,OAAA,CACd,EAAA,EACA,EAAA,EACA,EAAA,EACA,IACA,CAAA,EACU;AACV,EAAA,MAAM,IAAI,CAAA,GAAI,CAAA;AACd,EAAA,MAAM,CAAA,GAAI,IAAI,CAAA,GAAI,CAAA;AAClB,EAAA,MAAM,CAAA,GAAI,CAAA,GAAI,CAAA,GAAI,CAAA,GAAI,CAAA;AACtB,EAAA,MAAM,CAAA,GAAI,CAAA,GAAI,CAAA,GAAI,CAAA,GAAI,CAAA;AACtB,EAAA,MAAM,CAAA,GAAI,IAAI,CAAA,GAAI,CAAA;AAClB,EAAA,MAAM,MAAgB,EAAC;AACvB,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,EAAA,CAAG,QAAQ,CAAA,EAAA,EAAK;AAClC,IAAA,GAAA,CAAI,KAAK,CAAA,GAAI,EAAA,CAAG,CAAC,CAAA,GAAK,IAAI,EAAA,CAAG,CAAC,CAAA,GAAK,CAAA,GAAI,GAAG,CAAC,CAAA,GAAK,CAAA,GAAI,EAAA,CAAG,CAAC,CAAE,CAAA;AAAA,EAC5D;AACA,EAAA,OAAO,GAAA;AACT","file":"chunk-TXEGHCJ4.js","sourcesContent":["/**\n * The cubic control points that make a curve leave a port along its normal and\n * arrive at the next against that port's normal — what makes a routed edge read\n * as plugged into a box rather than aimed at it.\n *\n * The rule is stated once, over loose components, and the 2D barrel and `./3d`\n * each wrap it in their own currency. Every operation here is closed on the\n * plane z = 0, so a planar problem answered through the 3D wrapper returns the\n * same numbers as through the 2D one, not an approximation of them.\n */\n\n/** How far a control point reaches toward the other end, as a fraction of the\n *  straight-line distance between the two. */\nexport const PORT_REACH = 0.4;\n\n/**\n * `[c1, c2]` for the cubic from `a` to `b`.\n *\n * A null normal falls back to a plain lerp along the chord, which is what makes\n * an unported waypoint curve smoothly instead of kinking. The two ends are not\n * symmetric: `outNormal` points the way the curve departs, while `inNormal`\n * points out of the receiving port, so `c2` is pushed *along* it to arrive\n * against it.\n */\nexport function portControls(\n  a: readonly number[],\n  b: readonly number[],\n  outNormal: readonly number[] | null | undefined,\n  inNormal: readonly number[] | null | undefined,\n  reach: number = PORT_REACH,\n): [number[], number[]] {\n  let sum = 0;\n  for (let i = 0; i < a.length; i++) {\n    const d = b[i]! - a[i]!;\n    sum += d * d;\n  }\n  const span = Math.sqrt(sum) * reach;\n\n  const c1: number[] = [];\n  const c2: number[] = [];\n  for (let i = 0; i < a.length; i++) {\n    const ai = a[i]!;\n    const bi = b[i]!;\n    c1.push(outNormal == null ? ai + (bi - ai) * reach : ai + outNormal[i]! * span);\n    c2.push(inNormal == null ? bi - (bi - ai) * reach : bi + inNormal[i]! * span);\n  }\n  return [c1, c2];\n}\n\n/** A cubic evaluated at `t`, component-wise, in whatever dimension it was given. */\nexport function cubicAt(\n  p0: readonly number[],\n  p1: readonly number[],\n  p2: readonly number[],\n  p3: readonly number[],\n  t: number,\n): number[] {\n  const u = 1 - t;\n  const a = u * u * u;\n  const b = 3 * u * u * t;\n  const c = 3 * u * t * t;\n  const d = t * t * t;\n  const out: number[] = [];\n  for (let i = 0; i < p0.length; i++) {\n    out.push(a * p0[i]! + b * p1[i]! + c * p2[i]! + d * p3[i]!);\n  }\n  return out;\n}\n"]}

package/dist/portCurve-BBr7eHAL.d.ts

@@ -1,15 +0,0 @@
-/**
- * The cubic control points that make a curve leave a port along its normal and
- * arrive at the next against that port's normal — what makes a routed edge read
- * as plugged into a box rather than aimed at it.
- *
- * The rule is stated once, over loose components, and the 2D barrel and `./3d`
- * each wrap it in their own currency. Every operation here is closed on the
- * plane z = 0, so a planar problem answered through the 3D wrapper returns the
- * same numbers as through the 2D one, not an approximation of them.
- */
-/** How far a control point reaches toward the other end, as a fraction of the
- *  straight-line distance between the two. */
-declare const PORT_REACH = 0.4;
-
-export { PORT_REACH as P };