@faicad/faijs 0.18.3 → 0.22.2

package/dist/geometry2d/bridge/plane.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plane.js","sourceRoot":"","sources":["../../../src/geometry2d/bridge/plane.ts"],"names":[],"mappings":"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CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;IAC9D,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;IAC/D,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;IAC9D,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;IACjE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE;IAClE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;IACjE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;IAClE,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;IAC/D,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;CACpE,CAAA;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,SAAoB,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;IAC/E,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;IAC9B,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,8DAA8D,CAAC,CAAA;IAC/G,OAAO,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAA;AACtD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAY,EAAE,CAAS,EAAE,CAAS;IACjE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,KAAK,CAAA;IAC7C,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;AAC/F,CAAC","sourcesContent":["/**\n * Plane frame helpers for 2D→3D placement (pure TS, no kernel, no `api/` import).\n *\n * A {@link Plane} carries an origin plus a right-handed, orthonormal frame\n * `xDir / yDir / zDir` where `zDir` is the plane normal — the same semantic as\n * the kernel `gp_Ax3` frame and the `createPlane` helper in `api/brepjs-compat`.\n * The bridge may **not** import `api/` (plan rule against a cycle), so this\n * module re-derives the framing math self-containedly. Points use the\n * `{ x, y, z }` shape compatible with the BREP engine's neutral `BrepVec3`.\n * @module\n */\n\n/** A 3D point / vector (neutral {x,y,z} shape, kernel-compatible). */\nexport interface Vec3 {\n  x: number\n  y: number\n  z: number\n}\n\n/** User-facing 3D input: `{x,y,z}` object or `[x,y,z]` array (the script form). */\nexport type Vec3Input = Vec3 | readonly [number, number, number]\n\n/**\n * Normalize a raw script- or API-facing 3D input to the canonical `{x,y,z}`.\n * Accepts both the array form (`[1,0,0]`, as produced by `.fai.js` literals)\n * and the object form (`{x,y,z}`, used by the bridge internals).\n * @param v - the input 3D value.\n * @returns the canonical vector.\n */\nexport function toVec3(v: Vec3Input): Vec3 {\n  if (Array.isArray(v)) return { x: v[0]!, y: v[1]!, z: v[2]! }\n  const o = v as Vec3\n  return { x: o.x, y: o.y, z: o.z }\n}\n\n/**\n * A right-handed, orthonormal plane frame: an origin plus `xDir`/`yDir` (in-plane\n * axes) and `zDir` (the normal). 2D `(x, y)` maps to `origin + x*xDir + y*yDir`.\n */\nexport interface Plane {\n  /** The plane's anchor point (the 2D origin maps here). */\n  readonly origin: Vec3\n  /** The in-plane X axis (maps the 2D +X). */\n  readonly xDir: Vec3\n  /** The in-plane Y axis (maps the 2D +Y). */\n  readonly yDir: Vec3\n  /** The plane normal (2D +Z after placement). */\n  readonly zDir: Vec3\n}\n\nfunction cross(a: Vec3, b: Vec3): Vec3 {\n  return { x: a.y * b.z - a.z * b.y, y: a.z * b.x - a.x * b.z, z: a.x * b.y - a.y * b.x }\n}\n\nfunction norm(v: Vec3): number {\n  return Math.sqrt(v.x * v.x + v.y * v.y + v.z * v.z)\n}\n\nfunction normalize(v: Vec3): Vec3 {\n  const len = norm(v)\n  return len > 1e-14 ? { x: v.x / len, y: v.y / len, z: v.z / len } : { x: 1, y: 0, z: 0 }\n}\n\n/**\n * Build a right-handed plane frame from an origin, a normal, and an optional\n * in-plane X direction. The X direction is auto-derived (least-aligned-axis\n * cross product) when omitted, mirroring the kernel `gp_Ax3` convention.\n * @param origin - the plane origin (2D origin maps here).\n * @param normal - the plane normal (becomes the zDir); must be non-zero.\n * @param xDir - optional explicit in-plane X; auto-derived when omitted.\n * @returns the orthonormal plane frame.\n */\nexport function makePlane(origin: Vec3Input, normal: Vec3Input, xDir?: Vec3Input): Plane {\n  const o = toVec3(origin)\n  const z = normalize(toVec3(normal))\n  let x: Vec3\n  if (xDir) {\n    x = normalize(toVec3(xDir))\n  } else {\n    const ax = Math.abs(z.x), ay = Math.abs(z.y), az = Math.abs(z.z)\n    const cand: Vec3 =\n      ax <= ay && ax <= az ? { x: 1, y: 0, z: 0 } : ay <= az ? { x: 0, y: 1, z: 0 } : { x: 0, y: 0, z: 1 }\n    x = normalize(cross(cand, z))\n  }\n  const y = normalize(cross(z, x))\n  return { origin: o, xDir: x, yDir: y, zDir: z }\n}\n\n/** Named CAD planes with their canonical frames (origin defaults to [0,0,0]). */\nconst NAMED_PLANES: Record<string, { xDir: Vec3; zDir: Vec3 }> = {\n  XY: { xDir: { x: 1, y: 0, z: 0 }, zDir: { x: 0, y: 0, z: 1 } },\n  XZ: { xDir: { x: 1, y: 0, z: 0 }, zDir: { x: 0, y: -1, z: 0 } },\n  YZ: { xDir: { x: 0, y: 1, z: 0 }, zDir: { x: 1, y: 0, z: 0 } },\n  front: { xDir: { x: 1, y: 0, z: 0 }, zDir: { x: 0, y: 0, z: 1 } },\n  back: { xDir: { x: -1, y: 0, z: 0 }, zDir: { x: 0, y: 0, z: -1 } },\n  left: { xDir: { x: 0, y: 0, z: 1 }, zDir: { x: -1, y: 0, z: 0 } },\n  right: { xDir: { x: 0, y: 0, z: -1 }, zDir: { x: 1, y: 0, z: 0 } },\n  top: { xDir: { x: 1, y: 0, z: 0 }, zDir: { x: 0, y: 1, z: 0 } },\n  bottom: { xDir: { x: 1, y: 0, z: 0 }, zDir: { x: 0, y: -1, z: 0 } },\n}\n\n/**\n * Resolve a named plane (e.g. `'XY'` / `'XZ'` / `'top'`) to a frame at a given\n * origin. Unknown names throw.\n * @param name - the canonical plane name.\n * @param origin - the plane origin (default [0,0,0]).\n * @returns the plane frame.\n */\nexport function namedPlane(name: string, origin: Vec3Input = { x: 0, y: 0, z: 0 }): Plane {\n  const cfg = NAMED_PLANES[name]\n  if (!cfg) throw new Error(`unknown plane '${name}' (expected XY | XZ | YZ | front/back/left/right/top/bottom)`)\n  return makePlane(toVec3(origin), cfg.zDir, cfg.xDir)\n}\n\n/**\n * Map a 2D point `(x, y)` into 3D on a plane frame:\n * `origin + x*xDir + y*yDir`. This is the per-point lift used by curve lifting.\n * @param plane - the target plane.\n * @param x - the 2D `x` coordinate.\n * @param y - the 2D `y` coordinate.\n * @returns the 3D point on the plane.\n */\nexport function liftPointToPlane(plane: Plane, x: number, y: number): Vec3 {\n  const { origin: o, xDir: u, yDir: v } = plane\n  return { x: o.x + x * u.x + y * v.x, y: o.y + x * u.y + y * v.y, z: o.z + x * u.z + y * v.z }\n}"]}

package/dist/geometry2d/canned-blueprints.d.ts

@@ -0,0 +1,44 @@
+/**
+ * geometry2d — canned 2D shape factories that return `Blueprint`s (C2).
+ *
+ * Ported from brepjs `2d/blueprints/cannedBlueprints.ts` (Apache-2.0). Built on
+ * `BlueprintSketcher`; each result is a closed contour ready for placement.
+ *
+ * @module
+ */
+import { Blueprint } from './blueprint.js';
+/**
+ * Create a regular polygon Blueprint inscribed in a circle of the given radius.
+ * @param radius - circumscribed circle radius.
+ * @param sidesCount - number of sides (3 = triangle, 6 = hexagon).
+ * @param sagitta - when non-zero, sides become sagitta arcs (bulge height).
+ * @returns a closed `Blueprint` representing the polygon.
+ *
+ * @example
+ * ```ts
+ * const hexagon = polysidesBlueprint(10, 6)
+ * const roundedTriangle = polysidesBlueprint(10, 3, 2)
+ * ```
+ */
+export declare function polysidesBlueprint(radius: number, sidesCount: number, sagitta?: number): Blueprint;
+/**
+ * Create an axis-aligned rectangle Blueprint (centered at the origin) with
+ * optional rounded corners.
+ * @param width - total width.
+ * @param height - total height.
+ * @param r - corner radius: a number for uniform rounding, or `{ rx, ry }`
+ *   for elliptical corners. Clamped to half the respective dimension.
+ * @returns the closed Blueprint representing the rounded rectangle.
+ *
+ * @example
+ * ```ts
+ * const sharp = roundedRectangleBlueprint(20, 10)
+ * const rounded = roundedRectangleBlueprint(20, 10, 3)
+ * const elliptical = roundedRectangleBlueprint(20, 10, { rx: 4, ry: 2 })
+ * ```
+ */
+export declare function roundedRectangleBlueprint(width: number, height: number, r?: number | {
+    rx?: number;
+    ry?: number;
+}): Blueprint;
+//# sourceMappingURL=canned-blueprints.d.ts.map

package/dist/geometry2d/canned-blueprints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canned-blueprints.d.ts","sourceRoot":"","sources":["../../src/geometry2d/canned-blueprints.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAWvC;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,SAAI,GAAG,SAAS,CAa7F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,CAAC,GAAE,MAAM,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAM,GAC3C,SAAS,CAyBX"}

package/dist/geometry2d/canned-blueprints.js

@@ -0,0 +1,94 @@
+/**
+ * geometry2d — canned 2D shape factories that return `Blueprint`s (C2).
+ *
+ * Ported from brepjs `2d/blueprints/cannedBlueprints.ts` (Apache-2.0). Built on
+ * `BlueprintSketcher`; each result is a closed contour ready for placement.
+ *
+ * @module
+ */
+import { BlueprintSketcher } from './blueprint-sketcher.js';
+import { Blueprint } from './blueprint.js';
+function lastOrThrow(items) {
+    const last = items[items.length - 1];
+    if (last === undefined)
+        throw new Error('[canned-blueprints] empty curve list');
+    return last;
+}
+/**
+ * Create a regular polygon Blueprint inscribed in a circle of the given radius.
+ * @param radius - circumscribed circle radius.
+ * @param sidesCount - number of sides (3 = triangle, 6 = hexagon).
+ * @param sagitta - when non-zero, sides become sagitta arcs (bulge height).
+ * @returns a closed `Blueprint` representing the polygon.
+ *
+ * @example
+ * ```ts
+ * const hexagon = polysidesBlueprint(10, 6)
+ * const roundedTriangle = polysidesBlueprint(10, 3, 2)
+ * ```
+ */
+export function polysidesBlueprint(radius, sidesCount, sagitta = 0) {
+    const points = [...Array(sidesCount).keys()].map((i) => {
+        const theta = -((Math.PI * 2) / sidesCount) * i;
+        return [radius * Math.sin(theta), radius * Math.cos(theta)];
+    });
+    const lastPoint = lastOrThrow(points);
+    const blueprint = new BlueprintSketcher().movePointerTo([lastPoint[0], lastPoint[1]]);
+    if (sagitta) {
+        points.forEach(([x, y]) => blueprint.sagittaArcTo([x, y], sagitta));
+    }
+    else {
+        points.forEach(([x, y]) => blueprint.lineTo([x, y]));
+    }
+    return blueprint.done();
+}
+/**
+ * Create an axis-aligned rectangle Blueprint (centered at the origin) with
+ * optional rounded corners.
+ * @param width - total width.
+ * @param height - total height.
+ * @param r - corner radius: a number for uniform rounding, or `{ rx, ry }`
+ *   for elliptical corners. Clamped to half the respective dimension.
+ * @returns the closed Blueprint representing the rounded rectangle.
+ *
+ * @example
+ * ```ts
+ * const sharp = roundedRectangleBlueprint(20, 10)
+ * const rounded = roundedRectangleBlueprint(20, 10, 3)
+ * const elliptical = roundedRectangleBlueprint(20, 10, { rx: 4, ry: 2 })
+ * ```
+ */
+export function roundedRectangleBlueprint(width, height, r = 0) {
+    const { rx: inputRx = 0, ry: inputRy = 0 } = typeof r === 'number' ? { ry: r, rx: r } : r;
+    let rx = Math.min(inputRx, width / 2);
+    let ry = Math.min(inputRy, height / 2);
+    const withRadius = rx && ry;
+    if (!withRadius) {
+        rx = 0;
+        ry = 0;
+    }
+    const symmetricRadius = rx === ry;
+    const sk = new BlueprintSketcher([Math.min(0, -(width / 2 - rx)), -height / 2]);
+    const addFillet = (xDist, yDist) => {
+        if (!withRadius)
+            return;
+        if (symmetricRadius)
+            sk.tangentArc(xDist, yDist);
+        else
+            sk.ellipse(xDist, yDist, rx, ry, 0, false, true);
+    };
+    if (rx < width / 2)
+        sk.hLine(width - 2 * rx);
+    addFillet(rx, ry);
+    if (ry < height / 2)
+        sk.vLine(height - 2 * ry);
+    addFillet(-rx, ry);
+    if (rx < width / 2)
+        sk.hLine(-(width - 2 * rx));
+    addFillet(-rx, -ry);
+    if (ry < height / 2)
+        sk.vLine(-(height - 2 * ry));
+    addFillet(rx, -ry);
+    return new Blueprint(sk.close());
+}
+//# sourceMappingURL=canned-blueprints.js.map

package/dist/geometry2d/canned-blueprints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canned-blueprints.js","sourceRoot":"","sources":["../../src/geometry2d/canned-blueprints.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * geometry2d — canned 2D shape factories that return `Blueprint`s (C2).\n *\n * Ported from brepjs `2d/blueprints/cannedBlueprints.ts` (Apache-2.0). Built on\n * `BlueprintSketcher`; each result is a closed contour ready for placement.\n *\n * @module\n */\n\nimport { BlueprintSketcher } from './blueprint-sketcher'\nimport { Blueprint } from './blueprint'\n\n/** A point type local to this module. */\ntype Pt = readonly [number, number]\n\nfunction lastOrThrow<T>(items: readonly T[]): T {\n  const last = items[items.length - 1]\n  if (last === undefined) throw new Error('[canned-blueprints] empty curve list')\n  return last\n}\n\n/**\n * Create a regular polygon Blueprint inscribed in a circle of the given radius.\n * @param radius - circumscribed circle radius.\n * @param sidesCount - number of sides (3 = triangle, 6 = hexagon).\n * @param sagitta - when non-zero, sides become sagitta arcs (bulge height).\n * @returns a closed `Blueprint` representing the polygon.\n *\n * @example\n * ```ts\n * const hexagon = polysidesBlueprint(10, 6)\n * const roundedTriangle = polysidesBlueprint(10, 3, 2)\n * ```\n */\nexport function polysidesBlueprint(radius: number, sidesCount: number, sagitta = 0): Blueprint {\n  const points: Pt[] = [...Array(sidesCount).keys()].map((i) => {\n    const theta = -((Math.PI * 2) / sidesCount) * i\n    return [radius * Math.sin(theta), radius * Math.cos(theta)]\n  })\n  const lastPoint = lastOrThrow(points)\n  const blueprint = new BlueprintSketcher().movePointerTo([lastPoint[0], lastPoint[1]])\n  if (sagitta) {\n    points.forEach(([x, y]) => blueprint.sagittaArcTo([x, y], sagitta))\n  } else {\n    points.forEach(([x, y]) => blueprint.lineTo([x, y]))\n  }\n  return blueprint.done()\n}\n\n/**\n * Create an axis-aligned rectangle Blueprint (centered at the origin) with\n * optional rounded corners.\n * @param width - total width.\n * @param height - total height.\n * @param r - corner radius: a number for uniform rounding, or `{ rx, ry }`\n *   for elliptical corners. Clamped to half the respective dimension.\n * @returns the closed Blueprint representing the rounded rectangle.\n *\n * @example\n * ```ts\n * const sharp = roundedRectangleBlueprint(20, 10)\n * const rounded = roundedRectangleBlueprint(20, 10, 3)\n * const elliptical = roundedRectangleBlueprint(20, 10, { rx: 4, ry: 2 })\n * ```\n */\nexport function roundedRectangleBlueprint(\n  width: number,\n  height: number,\n  r: number | { rx?: number; ry?: number } = 0,\n): Blueprint {\n  const { rx: inputRx = 0, ry: inputRy = 0 } = typeof r === 'number' ? { ry: r, rx: r } : r\n  let rx = Math.min(inputRx, width / 2)\n  let ry = Math.min(inputRy, height / 2)\n  const withRadius = rx && ry\n  if (!withRadius) {\n    rx = 0\n    ry = 0\n  }\n  const symmetricRadius = rx === ry\n  const sk = new BlueprintSketcher([Math.min(0, -(width / 2 - rx)), -height / 2])\n  const addFillet = (xDist: number, yDist: number): void => {\n    if (!withRadius) return\n    if (symmetricRadius) sk.tangentArc(xDist, yDist)\n    else sk.ellipse(xDist, yDist, rx, ry, 0, false, true)\n  }\n  if (rx < width / 2) sk.hLine(width - 2 * rx)\n  addFillet(rx, ry)\n  if (ry < height / 2) sk.vLine(height - 2 * ry)\n  addFillet(-rx, ry)\n  if (rx < width / 2) sk.hLine(-(width - 2 * rx))\n  addFillet(-rx, -ry)\n  if (ry < height / 2) sk.vLine(-(height - 2 * ry))\n  addFillet(rx, -ry)\n  return new Blueprint(sk.close())\n}"]}

package/dist/geometry2d/compound-blueprint.d.ts

@@ -0,0 +1,72 @@
+/**
+ * CompoundBlueprint — 2D profile with holes (pure-data port of brepjs, Apache-2.0).
+ * `blueprints[0]` is the outer boundary; subsequent entries are holes.
+ * @module
+ */
+import { Blueprint, type Point2 } from './blueprint.js';
+import { type BBox2d } from './bbox2d.js';
+/**
+ * CompoundBlueprint — 2D profile with holes.
+ * `blueprints[0]` is the outer boundary; subsequent entries are holes.
+ */
+export declare class CompoundBlueprint {
+    /** `blueprints[0]` = outer boundary; the rest are holes. */
+    readonly blueprints: Blueprint[];
+    private _bbox;
+    constructor(blueprints: Blueprint[]);
+    /**
+     * Return a copy of this profile.
+     * @returns a new CompoundBlueprint whose boundaries are clones of the originals.
+     */
+    clone(): CompoundBlueprint;
+    /**
+     * Bounding box (cached). The box spanning the outer boundary and all holes.
+     * @returns a BBox2d enclosing every boundary in this profile.
+     */
+    get boundingBox(): BBox2d;
+    /**
+     * Scale this profile about a center point.
+     * @param factor - the scale factor to apply.
+     * @param center - the scaling center `[x, y]` (defaults to the bounding-box center).
+     * @returns a new CompoundBlueprint with every boundary scaled.
+     */
+    scale(factor: number, center?: Point2): CompoundBlueprint;
+    /**
+     * Translate this profile by a delta.
+     * @param dxOrPoint - the x delta, or a full `[dx, dy]` offset point.
+     * @param dy - the y delta (default 0, ignored when `dxOrPoint` is a point).
+     * @returns a new CompoundBlueprint with every boundary translated.
+     */
+    translate(dxOrPoint: number | Point2, dy?: number): CompoundBlueprint;
+    /**
+     * Rotate this profile about a center point.
+     * @param angleDeg - the rotation angle in degrees.
+     * @param center - the rotation center `[x, y]` (defaults to the origin).
+     * @returns a new CompoundBlueprint with every boundary rotated.
+     */
+    rotate(angleDeg: number, center?: Point2): CompoundBlueprint;
+    /**
+     * Mirror this profile.
+     * @param centerOrDirection - the mirror center (mode `center`) or the mirror axis direction.
+     * @param origin - the axis origin `[x, y]` when mirroring across a plane (defaults to the origin).
+     * @param mode - `center` mirrors about a point; `plane` mirrors across an axis.
+     * @returns a new CompoundBlueprint with every boundary mirrored.
+     */
+    mirror(centerOrDirection: Point2, origin?: Point2, mode?: 'center' | 'plane'): CompoundBlueprint;
+    /**
+     * The starting point of the outer boundary's first curve.
+     * @returns the 2D point where this profile begins.
+     */
+    get firstPoint(): Point2;
+    /**
+     * The ending point of the outer boundary's last curve.
+     * @returns the 2D point where this profile ends.
+     */
+    get lastPoint(): Point2;
+    /**
+     * True when the outer boundary closes back on itself.
+     * @returns true when the outer boundary's first and last points coincide.
+     */
+    isClosed(): boolean;
+}
+//# sourceMappingURL=compound-blueprint.d.ts.map

package/dist/geometry2d/compound-blueprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compound-blueprint.d.ts","sourceRoot":"","sources":["../../src/geometry2d/compound-blueprint.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,SAAS,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,EAAqC,KAAK,MAAM,EAAE,MAAM,UAAU,CAAA;AAEzE;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,EAAE,SAAS,EAAE,CAAA;IAEhC,OAAO,CAAC,KAAK,CAAsB;gBAEvB,UAAU,EAAE,SAAS,EAAE;IAKnC;;;OAGG;IACH,KAAK,IAAI,iBAAiB;IAI1B;;;OAGG;IACH,IAAI,WAAW,IAAI,MAAM,CAOxB;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB;IAKzD;;;;;OAKG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,iBAAiB;IAIrE;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB;IAI5D;;;;;;OAMG;IACH,MAAM,CAAC,iBAAiB,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,GAAE,QAAQ,GAAG,OAAkB,GAAG,iBAAiB;IAI1G;;;OAGG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;;OAGG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;;OAGG;IACH,QAAQ,IAAI,OAAO;CAGpB"}

package/dist/geometry2d/compound-blueprint.js

@@ -0,0 +1,95 @@
+import { centerOf, createBBox2d, mergeBBox } from './bbox2d.js';
+/**
+ * CompoundBlueprint — 2D profile with holes.
+ * `blueprints[0]` is the outer boundary; subsequent entries are holes.
+ */
+export class CompoundBlueprint {
+    /** `blueprints[0]` = outer boundary; the rest are holes. */
+    blueprints;
+    _bbox = null;
+    constructor(blueprints) {
+        if (blueprints.length === 0)
+            throw new Error('CompoundBlueprint requires at least the outer boundary');
+        this.blueprints = blueprints;
+    }
+    /**
+     * Return a copy of this profile.
+     * @returns a new CompoundBlueprint whose boundaries are clones of the originals.
+     */
+    clone() {
+        return new CompoundBlueprint(this.blueprints.map((b) => b.clone()));
+    }
+    /**
+     * Bounding box (cached). The box spanning the outer boundary and all holes.
+     * @returns a BBox2d enclosing every boundary in this profile.
+     */
+    get boundingBox() {
+        if (!this._bbox) {
+            const bb = createBBox2d();
+            for (const b of this.blueprints)
+                mergeBBox(bb, b.boundingBox);
+            this._bbox = bb;
+        }
+        return this._bbox;
+    }
+    /**
+     * Scale this profile about a center point.
+     * @param factor - the scale factor to apply.
+     * @param center - the scaling center `[x, y]` (defaults to the bounding-box center).
+     * @returns a new CompoundBlueprint with every boundary scaled.
+     */
+    scale(factor, center) {
+        const ctr = center ?? centerOf(this.boundingBox);
+        return new CompoundBlueprint(this.blueprints.map((b) => b.scale(factor, ctr)));
+    }
+    /**
+     * Translate this profile by a delta.
+     * @param dxOrPoint - the x delta, or a full `[dx, dy]` offset point.
+     * @param dy - the y delta (default 0, ignored when `dxOrPoint` is a point).
+     * @returns a new CompoundBlueprint with every boundary translated.
+     */
+    translate(dxOrPoint, dy) {
+        return new CompoundBlueprint(this.blueprints.map((b) => b.translate(dxOrPoint, dy ?? 0)));
+    }
+    /**
+     * Rotate this profile about a center point.
+     * @param angleDeg - the rotation angle in degrees.
+     * @param center - the rotation center `[x, y]` (defaults to the origin).
+     * @returns a new CompoundBlueprint with every boundary rotated.
+     */
+    rotate(angleDeg, center) {
+        return new CompoundBlueprint(this.blueprints.map((b) => b.rotate(angleDeg, center)));
+    }
+    /**
+     * Mirror this profile.
+     * @param centerOrDirection - the mirror center (mode `center`) or the mirror axis direction.
+     * @param origin - the axis origin `[x, y]` when mirroring across a plane (defaults to the origin).
+     * @param mode - `center` mirrors about a point; `plane` mirrors across an axis.
+     * @returns a new CompoundBlueprint with every boundary mirrored.
+     */
+    mirror(centerOrDirection, origin, mode = 'center') {
+        return new CompoundBlueprint(this.blueprints.map((b) => b.mirror(centerOrDirection, origin, mode)));
+    }
+    /**
+     * The starting point of the outer boundary's first curve.
+     * @returns the 2D point where this profile begins.
+     */
+    get firstPoint() {
+        return this.blueprints[0].firstPoint;
+    }
+    /**
+     * The ending point of the outer boundary's last curve.
+     * @returns the 2D point where this profile ends.
+     */
+    get lastPoint() {
+        return this.blueprints[0].lastPoint;
+    }
+    /**
+     * True when the outer boundary closes back on itself.
+     * @returns true when the outer boundary's first and last points coincide.
+     */
+    isClosed() {
+        return this.blueprints[0].isClosed();
+    }
+}
+//# sourceMappingURL=compound-blueprint.js.map

package/dist/geometry2d/compound-blueprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compound-blueprint.js","sourceRoot":"","sources":["../../src/geometry2d/compound-blueprint.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAe,MAAM,UAAU,CAAA;AAEzE;;;GAGG;AACH,MAAM,OAAO,iBAAiB;IAC5B,4DAA4D;IACnD,UAAU,CAAa;IAExB,KAAK,GAAkB,IAAI,CAAA;IAEnC,YAAY,UAAuB;QACjC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAA;QACtG,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;IAC9B,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,OAAO,IAAI,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;IACrE,CAAC;IAED;;;OAGG;IACH,IAAI,WAAW;QACb,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,EAAE,GAAG,YAAY,EAAE,CAAA;YACzB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,UAAU;gBAAE,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,CAAA;YAC7D,IAAI,CAAC,KAAK,GAAG,EAAE,CAAA;QACjB,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAc,EAAE,MAAe;QACnC,MAAM,GAAG,GAAG,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QAChD,OAAO,IAAI,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;IAChF,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,SAA0B,EAAE,EAAW;QAC/C,OAAO,IAAI,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;IAC3F,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,QAAgB,EAAE,MAAe;QACtC,OAAO,IAAI,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;IACtF,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,iBAAyB,EAAE,MAAe,EAAE,OAA2B,QAAQ;QACpF,OAAO,IAAI,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;IACrG,CAAC;IAED;;;OAGG;IACH,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC,UAAU,CAAA;IACvC,CAAC;IAED;;;OAGG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC,SAAS,CAAA;IACtC,CAAC;IAED;;;OAGG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC,QAAQ,EAAE,CAAA;IACvC,CAAC;CACF","sourcesContent":["/**\n * CompoundBlueprint — 2D profile with holes (pure-data port of brepjs, Apache-2.0).\n * `blueprints[0]` is the outer boundary; subsequent entries are holes.\n * @module\n */\nimport { Blueprint, type Point2 } from './blueprint'\nimport { centerOf, createBBox2d, mergeBBox, type BBox2d } from './bbox2d'\n\n/**\n * CompoundBlueprint — 2D profile with holes.\n * `blueprints[0]` is the outer boundary; subsequent entries are holes.\n */\nexport class CompoundBlueprint {\n  /** `blueprints[0]` = outer boundary; the rest are holes. */\n  readonly blueprints: Blueprint[]\n\n  private _bbox: BBox2d | null = null\n\n  constructor(blueprints: Blueprint[]) {\n    if (blueprints.length === 0) throw new Error('CompoundBlueprint requires at least the outer boundary')\n    this.blueprints = blueprints\n  }\n\n  /**\n   * Return a copy of this profile.\n   * @returns a new CompoundBlueprint whose boundaries are clones of the originals.\n   */\n  clone(): CompoundBlueprint {\n    return new CompoundBlueprint(this.blueprints.map((b) => b.clone()))\n  }\n\n  /**\n   * Bounding box (cached). The box spanning the outer boundary and all holes.\n   * @returns a BBox2d enclosing every boundary in this profile.\n   */\n  get boundingBox(): BBox2d {\n    if (!this._bbox) {\n      const bb = createBBox2d()\n      for (const b of this.blueprints) mergeBBox(bb, b.boundingBox)\n      this._bbox = bb\n    }\n    return this._bbox\n  }\n\n  /**\n   * Scale this profile about a center point.\n   * @param factor - the scale factor to apply.\n   * @param center - the scaling center `[x, y]` (defaults to the bounding-box center).\n   * @returns a new CompoundBlueprint with every boundary scaled.\n   */\n  scale(factor: number, center?: Point2): CompoundBlueprint {\n    const ctr = center ?? centerOf(this.boundingBox)\n    return new CompoundBlueprint(this.blueprints.map((b) => b.scale(factor, ctr)))\n  }\n\n  /**\n   * Translate this profile by a delta.\n   * @param dxOrPoint - the x delta, or a full `[dx, dy]` offset point.\n   * @param dy - the y delta (default 0, ignored when `dxOrPoint` is a point).\n   * @returns a new CompoundBlueprint with every boundary translated.\n   */\n  translate(dxOrPoint: number | Point2, dy?: number): CompoundBlueprint {\n    return new CompoundBlueprint(this.blueprints.map((b) => b.translate(dxOrPoint, dy ?? 0)))\n  }\n\n  /**\n   * Rotate this profile about a center point.\n   * @param angleDeg - the rotation angle in degrees.\n   * @param center - the rotation center `[x, y]` (defaults to the origin).\n   * @returns a new CompoundBlueprint with every boundary rotated.\n   */\n  rotate(angleDeg: number, center?: Point2): CompoundBlueprint {\n    return new CompoundBlueprint(this.blueprints.map((b) => b.rotate(angleDeg, center)))\n  }\n\n  /**\n   * Mirror this profile.\n   * @param centerOrDirection - the mirror center (mode `center`) or the mirror axis direction.\n   * @param origin - the axis origin `[x, y]` when mirroring across a plane (defaults to the origin).\n   * @param mode - `center` mirrors about a point; `plane` mirrors across an axis.\n   * @returns a new CompoundBlueprint with every boundary mirrored.\n   */\n  mirror(centerOrDirection: Point2, origin?: Point2, mode: 'center' | 'plane' = 'center'): CompoundBlueprint {\n    return new CompoundBlueprint(this.blueprints.map((b) => b.mirror(centerOrDirection, origin, mode)))\n  }\n\n  /**\n   * The starting point of the outer boundary's first curve.\n   * @returns the 2D point where this profile begins.\n   */\n  get firstPoint(): Point2 {\n    return this.blueprints[0]!.firstPoint\n  }\n\n  /**\n   * The ending point of the outer boundary's last curve.\n   * @returns the 2D point where this profile ends.\n   */\n  get lastPoint(): Point2 {\n    return this.blueprints[0]!.lastPoint\n  }\n\n  /**\n   * True when the outer boundary closes back on itself.\n   * @returns true when the outer boundary's first and last points coincide.\n   */\n  isClosed(): boolean {\n    return this.blueprints[0]!.isClosed()\n  }\n}"]}

package/dist/geometry2d/curve2d.d.ts

@@ -0,0 +1,298 @@
+/**
+ * Pure-TypeScript 2D analytic curve model (faijs port of brepjs).
+ *
+ * Adapted from brepjs `src/kernel/geometry2d.ts` (Apache-2.0), preserving core
+ * algorithms and naming. Differences from brepjs:
+ * - discriminant field renamed `__bk2d` → `kind2d` (2026-09-27 decision),
+ *   bbox discriminant `__bk2d_bbox` → `kind2d_b`.
+ * - All curves are plain data objects (no kernel handles, no dispose), per the
+ *   faijs "2D curves are pure objects" design (docs/plans/2d-sketching: A1/B1).
+ *
+ * Pure TS, zero WASM, zero external deps. All 2D curves represented as plain
+ * objects with a `kind2d` discriminant.
+ *
+ * License: adapted from brepjs (Apache-2.0). Retained per faijs convention for
+ * brepjs-ported files (cf. svg-to-solid.ts).
+ *
+ * @module
+ */
+/** Line: origin + unit direction + length. */
+export interface Line2d {
+    readonly kind2d: 'line';
+    readonly ox: number;
+    readonly oy: number;
+    readonly dx: number;
+    readonly dy: number;
+    readonly len: number;
+}
+/** Full circle. sense=true → CCW. */
+export interface Circle2d {
+    readonly kind2d: 'circle';
+    readonly cx: number;
+    readonly cy: number;
+    readonly radius: number;
+    readonly sense: boolean;
+}
+/** Ellipse (or arc of one, via trim). */
+export interface Ellipse2d {
+    readonly kind2d: 'ellipse';
+    readonly cx: number;
+    readonly cy: number;
+    readonly majorRadius: number;
+    readonly minorRadius: number;
+    readonly xDirAngle: number;
+    readonly sense: boolean;
+}
+/** Bezier curve (De Casteljau). */
+export interface Bezier2d {
+    readonly kind2d: 'bezier';
+    readonly poles: [number, number][];
+}
+/** B-spline (De Boor). */
+export interface BSpline2d {
+    readonly kind2d: 'bspline';
+    readonly poles: [number, number][];
+    readonly knots: number[];
+    readonly multiplicities: number[];
+    readonly degree: number;
+    readonly isPeriodic: boolean;
+}
+/** Trimmed wrapper over another curve. */
+export interface TrimmedCurve2d {
+    readonly kind2d: 'trimmed';
+    readonly basis: Curve2dObj;
+    readonly tStart: number;
+    readonly tEnd: number;
+}
+/**
+ * A 2D curve expressed as one of the supported analytic or spline kinds.
+ * Discriminated by the `kind2d` field.
+ */
+export type Curve2dObj = Line2d | Circle2d | Ellipse2d | Bezier2d | BSpline2d | TrimmedCurve2d;
+/**
+ * Mutable 2D bounding box carried by the curve-specific bbox helpers.
+ * `kind2d_b` marks the discriminant used to detect this box type.
+ */
+export interface CurveBBox2d {
+    readonly kind2d_b: true;
+    xMin: number;
+    yMin: number;
+    xMax: number;
+    yMax: number;
+}
+/**
+ * Evaluate a curve at parameter t to a 2D point.
+ * @param c - the curve to evaluate.
+ * @param t - the parameter value within the curve's domain.
+ * @returns the 2D point `[x, y]` on the curve.
+ */
+export declare function evaluateCurve2d(c: Curve2dObj, t: number): [number, number];
+/**
+ * Tangent (non-normalized direction derivative) at parameter t.
+ * @param c - the curve to differentiate.
+ * @param t - the parameter value within the curve's domain.
+ * @returns the unnormalized tangent vector `[dx, dy]` at `t`.
+ */
+export declare function tangentCurve2d(c: Curve2dObj, t: number): [number, number];
+/**
+ * Parameter domain of a curve.
+ * @param c - the curve whose domain to read.
+ * @returns the inclusive `first` and `last` parameter bounds.
+ */
+export declare function curveBounds(c: Curve2dObj): {
+    first: number;
+    last: number;
+};
+/**
+ * OCCT-style type name of a curve.
+ * @param c - the curve to name.
+ * @returns the uppercase OCCT type name such as `LINE`, `CIRCLE` or `BSPLINE_CURVE`.
+ */
+export declare function curveTypeName(c: Curve2dObj): string;
+/**
+ * Line segment from (x1,y1) to (x2,y2).
+ * @param x1 - the x coordinate of the start point.
+ * @param y1 - the y coordinate of the start point.
+ * @param x2 - the x coordinate of the end point.
+ * @param y2 - the y coordinate of the end point.
+ * @returns a Line2d describing the segment.
+ */
+export declare function makeLine2d(x1: number, y1: number, x2: number, y2: number): Line2d;
+/**
+ * Full circle with the given center, radius and winding sense.
+ * @param cx - the x coordinate of the center.
+ * @param cy - the y coordinate of the center.
+ * @param radius - the circle radius.
+ * @param sense - true for counter-clockwise winding (default true).
+ * @returns a Circle2d.
+ */
+export declare function makeCircle2d(cx: number, cy: number, radius: number, sense?: boolean): Circle2d;
+/**
+ * Arc through three points; returns a trimmed circle, or a line if collinear.
+ * @param x1 - the x coordinate of the start point.
+ * @param y1 - the y coordinate of the start point.
+ * @param xm - the x coordinate of the mid point.
+ * @param ym - the y coordinate of the mid point.
+ * @param x2 - the x coordinate of the end point.
+ * @param y2 - the y coordinate of the end point.
+ * @returns a Curve2dObj: a trimmed arc circle, or a straight line when the points are collinear.
+ */
+export declare function makeArc2dThreePoints(x1: number, y1: number, xm: number, ym: number, x2: number, y2: number): Curve2dObj;
+/**
+ * Arc from a start point through a given tangent direction to an end point.
+ * @param sx - the x coordinate of the start point.
+ * @param sy - the y coordinate of the start point.
+ * @param tx - the x component of the tangent direction at the start.
+ * @param ty - the y component of the tangent direction at the start.
+ * @param ex - the x coordinate of the end point.
+ * @param ey - the y coordinate of the end point.
+ * @returns a Curve2dObj: a trimmed circle arc, or a line when degenerate.
+ */
+export declare function makeArc2dTangent(sx: number, sy: number, tx: number, ty: number, ex: number, ey: number): Curve2dObj;
+/**
+ * Ellipse with the given center, radii, major-axis direction and sense.
+ * @param cx - the x coordinate of the center.
+ * @param cy - the y coordinate of the center.
+ * @param majorRadius - the semi-major radius.
+ * @param minorRadius - the semi-minor radius.
+ * @param xDirX - the x component of the major-axis direction (default 1).
+ * @param xDirY - the y component of the major-axis direction (default 0).
+ * @param sense - true for counter-clockwise winding (default true).
+ * @returns an Ellipse2d.
+ */
+export declare function makeEllipse2d(cx: number, cy: number, majorRadius: number, minorRadius: number, xDirX?: number, xDirY?: number, sense?: boolean): Ellipse2d;
+/**
+ * Bezier curve from control poles.
+ * @param poles - the ordered control points `[x, y]` for the curve.
+ * @returns a Bezier2d holding a copy of the poles.
+ */
+export declare function makeBezier2d(poles: [number, number][]): Bezier2d;
+/**
+ * Translate a curve by an offset.
+ * @param c - the curve to translate.
+ * @param dx - the x offset.
+ * @param dy - the y offset.
+ * @returns a new Curve2dObj translated by `(dx, dy)`.
+ */
+export declare function translateCurve2d(c: Curve2dObj, dx: number, dy: number): Curve2dObj;
+/**
+ * Rotate a curve by an angle about a center point.
+ * @param c - the curve to rotate.
+ * @param angle - the rotation angle in radians.
+ * @param cx - the x coordinate of the rotation center.
+ * @param cy - the y coordinate of the rotation center.
+ * @returns a new Curve2dObj rotated by `angle` about `(cx, cy)`.
+ */
+export declare function rotateCurve2d(c: Curve2dObj, angle: number, cx: number, cy: number): Curve2dObj;
+/**
+ * Scale a curve by a factor about a center point.
+ * @param c - the curve to scale.
+ * @param factor - the scale factor (may be negative to mirror-and-scale).
+ * @param cx - the x coordinate of the scaling center.
+ * @param cy - the y coordinate of the scaling center.
+ * @returns a new Curve2dObj scaled by `factor` about `(cx, cy)`.
+ */
+export declare function scaleCurve2d(c: Curve2dObj, factor: number, cx: number, cy: number): Curve2dObj;
+/**
+ * Mirror a curve through a center point (a half-turn).
+ * @param c - the curve to mirror.
+ * @param cx - the x coordinate of the mirror center.
+ * @param cy - the y coordinate of the mirror center.
+ * @returns a new Curve2dObj rotated 180 degrees about `(cx, cy)`.
+ */
+export declare function mirrorAtPoint(c: Curve2dObj, cx: number, cy: number): Curve2dObj;
+/**
+ * Mirror a curve across an axis defined by a point and a direction vector.
+ * @param c - the curve to mirror.
+ * @param ox - the x coordinate of a point on the mirror axis.
+ * @param oy - the y coordinate of a point on the mirror axis.
+ * @param dx - the x component of the axis direction vector.
+ * @param dy - the y component of the axis direction vector.
+ * @returns a new Curve2dObj reflected across the given axis.
+ */
+export declare function mirrorAcrossAxis(c: Curve2dObj, ox: number, oy: number, dx: number, dy: number): Curve2dObj;
+/**
+ * Compute intersection points (and overlapping segments) between two 2D curves.
+ * Handles analytic cases (line-line, line-circle, circle-circle) and falls back
+ * to numerical sampling + Newton refinement for general curves.
+ * @param c1 - the first curve.
+ * @param c2 - the second curve.
+ * @param tolerance - the geometric tolerance used for candidate filtering.
+ * @returns the intersection points and any overlapping curve segments.
+ */
+export declare function intersectCurves2dFn(c1: Curve2dObj, c2: Curve2dObj, tolerance: number): {
+    points: [number, number][];
+    segments: Curve2dObj[];
+};
+/**
+ * Serialize a curve (JSON round-trip).
+ * @param c - the curve to serialize.
+ * @returns the curve as a JSON string.
+ */
+export declare function serializeCurve2d(c: Curve2dObj): string;
+/**
+ * Deserialize a curve previously produced by {@link serializeCurve2d}.
+ * @param data - the JSON string describing the curve.
+ * @returns the reconstructed Curve2dObj.
+ */
+export declare function deserializeCurve2d(data: string): Curve2dObj;
+/**
+ * Create an empty (inverted) curve bounding box.
+ * @returns a fresh CurveBBox2d whose mins are +Infinity and maxes are -Infinity.
+ */
+export declare function createCurveBBox2d(): CurveBBox2d;
+/**
+ * Expand a curve bounding box to include a curve's extent.
+ * Uses analytic extremes for lines and circles/arcs and sampling otherwise.
+ * @param bbox - the box to expand in place.
+ * @param c - the curve whose extent is incorporated.
+ * @param _tol - reserved tolerance parameter (unused).
+ */
+export declare function addCurveToBBox(bbox: CurveBBox2d, c: Curve2dObj, _tol: number): void;
+/**
+ * Parameter on a curve closest to a point.
+ *
+ * This is the general "point → parameter" primitive used by corner/offset work:
+ * it searches the curve's domain for the parameter whose evaluated point is
+ * nearest to `(px, py)` and returns it when that nearest distance is within a
+ * configurable fraction of the curve's geometric extent. Returns `null` when the
+ * point lies too far off the curve (the raw gap-vs-extent guard) so callers can
+ * distinguish "on/very near the curve" from "clearly off".
+ *
+ * @param c - the curve to search (line, arc, ellipse, bezier, bspline, trimmed).
+ * @param px - the query point x.
+ * @param py - the query point y.
+ * @param maxRatio - the maximum acceptable nearest-distance / geometric-extent
+ *   ratio (default 0.1; raise it to accept points that sit further off the curve).
+ * @returns the domain parameter `t`, or `null` when `(px, py)` is off-curve by
+ *   more than `maxRatio` of the curve's geometric extent.
+ */
+export declare function parameterOfPoint(c: Curve2dObj, px: number, py: number, maxRatio?: number): number | null;
+/**
+ * Trim a curve to a sub-parameter range given in the basis curve's native domain.
+ *
+ * The returned `trimmed` curve keeps the full basis; its `t∈[0,1]` domain maps
+ * into `[tStart, tEnd]` of the basis (so it is the inverse of `curveBounds` for
+ * trimmed curves). Parameters are in the basis's native domain (a line: distance
+ * along `[0,len]`; an arc/ellipse: angle `[.., ..]`).
+ *
+ * @param c - the curve to trim (may itself be already-trimmed; the basis is reused).
+ * @param tStart - the basis-domain parameter where the sub-curve starts.
+ * @param tEnd - the basis-domain parameter where the sub-curve ends.
+ * @returns the trimmed `Curve2dObj`.
+ */
+export declare function trimCurve(c: Curve2dObj, tStart: number, tEnd: number): Curve2dObj;
+/**
+ * Split a curve at a native-domain parameter into two trimmed sub-curves.
+ *
+ * This is the splice primitive that D1 boolean-splitting and D3 corner
+ * (fillet/chamfer) use: it cuts a single curve at an interior parameter into
+ * two `TrimmedCurve2d` sharing the same basis, covering `[first, t]` and
+ * `[t, last]`. Returns `null` when `t` is not strictly interior.
+ *
+ * @param c - the curve to split.
+ * @param t - the native-domain split parameter (strictly inside the basis domain).
+ * @returns the two sub-curves, or `null` when `t` is outside the interior.
+ */
+export declare function splitCurveAt(c: Curve2dObj, t: number): [Curve2dObj, Curve2dObj] | null;
+//# sourceMappingURL=curve2d.d.ts.map