@faicad/faijs 0.18.3 → 0.19.0

package/dist/geometry2d/blueprint.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Blueprint — ordered 2D profile of `Curve2dObj` segments (pure-data port of
+ * brepjs `Blueprint`, Apache-2.0).
+ *
+ * Key adaptation: brepjs stores kernel-backed `Curve2D` handles that must be
+ * disposed; faijs stores plain `Curve2dObj` objects (no handles, no dispose).
+ * Kernel-coupling methods (sketchOnPlane / sketchOnFace / subFace / punchHole)
+ * intentionally live in `geometry2d/bridge`, not here.
+ *
+ * @module
+ */
+import type { Curve2dObj } from './curve2d.js';
+import { type BBox2d } from './bbox2d.js';
+/** 2D point. */
+export type Point2 = [number, number];
+/**
+ * True when `(x,y)` is within `tol` of curve `c`.
+ * @param c - the curve to test against.
+ * @param pt - the 2D point to test, `[x, y]`.
+ * @param tol - the distance tolerance (default 1e-9).
+ * @returns true when the point lies within `tol` of the curve.
+ */
+export declare function isOnCurve(c: Curve2dObj, pt: readonly [number, number], tol?: number): boolean;
+/**
+ * A planar 2D profile = an ordered sequence of 2D curves.
+ * Shared base for `cad.profile`, `cad.draw` and (solved) `cad.sketch` outputs on
+ * their way to `sketchOnPlane`/`sketchOnFace`.
+ */
+export declare class Blueprint {
+    /** Ordered 2D curve segments composing this blueprint. */
+    readonly curves: Curve2dObj[];
+    private _bbox;
+    private _orientation;
+    private _guessedOrientation;
+    constructor(curves: Curve2dObj[]);
+    /**
+     * Return a shallow copy of this blueprint (new container, same curve objects).
+     * @returns a new Blueprint with the same curves.
+     */
+    clone(): Blueprint;
+    /** Bounding box (cached). */
+    get boundingBox(): BBox2d;
+    /** Winding orientation via shoelace (curve midpoints for non-lines). */
+    get orientation(): 'clockwise' | 'counterClockwise';
+    /**
+     * Scale the blueprint 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 Blueprint with every curve scaled about the center.
+     */
+    scale(factor: number, center?: Point2): Blueprint;
+    /**
+     * Translate the whole blueprint 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 Blueprint with every curve translated.
+     */
+    translate(dxOrPoint: number | Point2, dy?: number): Blueprint;
+    /**
+     * Rotate the whole blueprint 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 Blueprint with every curve rotated.
+     */
+    rotate(angleDeg: number, center?: Point2): Blueprint;
+    /**
+     * Mirror the whole blueprint.
+     * @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 Blueprint with every curve mirrored.
+     */
+    mirror(centerOrDirection: Point2, origin?: Point2, mode?: 'center' | 'plane'): Blueprint;
+    /**
+     * The starting point of the first curve.
+     * @returns the 2D point where this blueprint begins.
+     */
+    get firstPoint(): Point2;
+    /**
+     * The ending point of the last curve.
+     * @returns the 2D point where this blueprint ends.
+     */
+    get lastPoint(): Point2;
+    /**
+     * True when the profile closes back on itself.
+     * @returns true when the first and last points coincide.
+     */
+    isClosed(): boolean;
+    /**
+     * True when a point is strictly inside (ray-cast); false on the boundary.
+     * @param point - the 2D point to test, `[x, y]`.
+     * @returns true when the point is strictly inside, false on/outside the boundary.
+     */
+    isInside(point: readonly [number, number]): boolean;
+    /**
+     * True when any curve of `this` intersects any curve of `other`.
+     * @param other - the blueprint to test for intersections against.
+     * @returns true when any pair of curves intersects.
+     */
+    intersects(other: Blueprint): boolean;
+}
+//# sourceMappingURL=blueprint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blueprint.d.ts","sourceRoot":"","sources":["../../src/geometry2d/blueprint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAE3C,OAAO,EAAgE,KAAK,MAAM,EAAE,MAAM,UAAU,CAAA;AAEpG,gBAAgB;AAChB,MAAM,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAcrC;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,SAAO,GAAG,OAAO,CAa3F;AAED;;;;GAIG;AACH,qBAAa,SAAS;IACpB,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,CAAA;IAE7B,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,YAAY,CAAgD;IACpE,OAAO,CAAC,mBAAmB,CAAgD;gBAE/D,MAAM,EAAE,UAAU,EAAE;IAKhC;;;OAGG;IACH,KAAK,IAAI,SAAS;IAIlB,6BAA6B;IAC7B,IAAI,WAAW,IAAI,MAAM,CAOxB;IAED,wEAAwE;IACxE,IAAI,WAAW,IAAI,WAAW,GAAG,kBAAkB,CAiBlD;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS;IAKjD;;;;;OAKG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS;IAK7D;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS;IAMpD;;;;;;OAMG;IACH,MAAM,CAAC,iBAAiB,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,GAAE,QAAQ,GAAG,OAAkB,GAAG,SAAS;IAUlG;;;OAGG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;;OAGG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;;OAGG;IACH,QAAQ,IAAI,OAAO;IAMnB;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO;IAsBnD;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO;CAWtC"}

package/dist/geometry2d/blueprint.js

@@ -0,0 +1,225 @@
+import { addCurveToBBox, evaluateCurve2d, curveBounds, intersectCurves2dFn, makeLine2d, mirrorAcrossAxis, mirrorAtPoint, rotateCurve2d, scaleCurve2d, translateCurve2d } from './curve2d.js';
+import { centerOf, createBBox2d, isBBoxOut, mergeBBox, outsidePointOf } from './bbox2d.js';
+// `addCurveToBBox` writes xMin/yMin/xMax/yMax — same fields as BBox2d, so the
+// structural subtype is satisfied by passing a plain BBox2d.
+function curveBBox(c) {
+    const bb = createBBox2d();
+    addCurveToBBox(bb, c, 1e-9);
+    return bb;
+}
+function containsBoxPoint(bb, pt) {
+    return pt[0] >= bb.xMin && pt[0] <= bb.xMax && pt[1] >= bb.yMin && pt[1] <= bb.yMax;
+}
+/**
+ * True when `(x,y)` is within `tol` of curve `c`.
+ * @param c - the curve to test against.
+ * @param pt - the 2D point to test, `[x, y]`.
+ * @param tol - the distance tolerance (default 1e-9).
+ * @returns true when the point lies within `tol` of the curve.
+ */
+export function isOnCurve(c, pt, tol = 1e-9) {
+    const bb = curveBBox(c);
+    if (!containsBoxPoint(bb, pt))
+        return false;
+    const b = curveBounds(c);
+    const N = 32;
+    let best = Infinity;
+    for (let i = 0; i <= N; i++) {
+        const t = b.first + ((b.last - b.first) * i) / N;
+        const [px, py] = evaluateCurve2d(c, t);
+        const d2 = (px - pt[0]) ** 2 + (py - pt[1]) ** 2;
+        if (d2 < best)
+            best = d2;
+    }
+    return best <= tol * tol;
+}
+/**
+ * A planar 2D profile = an ordered sequence of 2D curves.
+ * Shared base for `cad.profile`, `cad.draw` and (solved) `cad.sketch` outputs on
+ * their way to `sketchOnPlane`/`sketchOnFace`.
+ */
+export class Blueprint {
+    /** Ordered 2D curve segments composing this blueprint. */
+    curves;
+    _bbox = null;
+    _orientation = null;
+    _guessedOrientation = null;
+    constructor(curves) {
+        if (curves.length === 0)
+            throw new Error('Blueprint requires at least one curve');
+        this.curves = curves;
+    }
+    /**
+     * Return a shallow copy of this blueprint (new container, same curve objects).
+     * @returns a new Blueprint with the same curves.
+     */
+    clone() {
+        return new Blueprint([...this.curves]);
+    }
+    /** Bounding box (cached). */
+    get boundingBox() {
+        if (!this._bbox) {
+            const bb = createBBox2d();
+            for (const c of this.curves)
+                mergeBBox(bb, curveBBox(c));
+            this._bbox = bb;
+        }
+        return this._bbox;
+    }
+    /** Winding orientation via shoelace (curve midpoints for non-lines). */
+    get orientation() {
+        if (this._orientation)
+            return this._orientation;
+        if (this._guessedOrientation)
+            return this._guessedOrientation;
+        const vertices = [];
+        for (const c of this.curves) {
+            const b = curveBounds(c);
+            vertices.push(firstPointOf(c));
+            if (c.kind2d !== 'line')
+                vertices.push(evaluate(c, (b.first + b.last) / 2));
+        }
+        let area = 0;
+        for (let i = 0; i < vertices.length; i++) {
+            const v1 = vertices[i];
+            const v2 = vertices[(i + 1) % vertices.length];
+            area += (v2[0] - v1[0]) * (v2[1] + v1[1]);
+        }
+        this._guessedOrientation = area > 0 ? 'clockwise' : 'counterClockwise';
+        return this._guessedOrientation;
+    }
+    /**
+     * Scale the blueprint 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 Blueprint with every curve scaled about the center.
+     */
+    scale(factor, center) {
+        const [cx, cy] = center ?? centerOf(this.boundingBox);
+        return new Blueprint(this.curves.map((c) => scaleCurve2d(c, factor, cx, cy)));
+    }
+    /**
+     * Translate the whole blueprint 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 Blueprint with every curve translated.
+     */
+    translate(dxOrPoint, dy) {
+        const [dx, yy] = typeof dxOrPoint === 'number' ? [dxOrPoint, dy ?? 0] : [dxOrPoint[0], dxOrPoint[1]];
+        return new Blueprint(this.curves.map((c) => translateCurve2d(c, dx, yy)));
+    }
+    /**
+     * Rotate the whole blueprint 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 Blueprint with every curve rotated.
+     */
+    rotate(angleDeg, center) {
+        const a = (angleDeg * Math.PI) / 180;
+        const [cx, cy] = center ?? [0, 0];
+        return new Blueprint(this.curves.map((c) => rotateCurve2d(c, a, cx, cy)));
+    }
+    /**
+     * Mirror the whole blueprint.
+     * @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 Blueprint with every curve mirrored.
+     */
+    mirror(centerOrDirection, origin, mode = 'center') {
+        if (mode === 'plane') {
+            const [ox, oy] = origin ?? [0, 0];
+            const [dx, dy] = centerOrDirection;
+            return new Blueprint(this.curves.map((c) => mirrorAcrossAxis(c, ox, oy, dx, dy)));
+        }
+        const [cx, cy] = centerOrDirection;
+        return new Blueprint(this.curves.map((c) => mirrorAtPoint(c, cx, cy)));
+    }
+    /**
+     * The starting point of the first curve.
+     * @returns the 2D point where this blueprint begins.
+     */
+    get firstPoint() {
+        return firstPointOf(this.curves[0]);
+    }
+    /**
+     * The ending point of the last curve.
+     * @returns the 2D point where this blueprint ends.
+     */
+    get lastPoint() {
+        return lastPointOf(this.curves[this.curves.length - 1]);
+    }
+    /**
+     * True when the profile closes back on itself.
+     * @returns true when the first and last points coincide.
+     */
+    isClosed() {
+        const fp = this.firstPoint;
+        const lp = this.lastPoint;
+        return Math.abs(fp[0] - lp[0]) < 1e-9 && Math.abs(fp[1] - lp[1]) < 1e-9;
+    }
+    /**
+     * True when a point is strictly inside (ray-cast); false on the boundary.
+     * @param point - the 2D point to test, `[x, y]`.
+     * @returns true when the point is strictly inside, false on/outside the boundary.
+     */
+    isInside(point) {
+        const bbox = this.boundingBox;
+        const p = [point[0], point[1]];
+        if (!containsBoxPoint(bbox, p))
+            return false;
+        if (this.curves.some((c) => isOnCurve(c, p)))
+            return false;
+        const outside = outsidePointOf(bbox);
+        const segment = makeLine2d(p[0], p[1], outside[0], outside[1]);
+        const seen = [];
+        let crossCount = 0;
+        for (const c of this.curves) {
+            if (isBBoxOut(curveBBox(segment), curveBBox(c)))
+                continue;
+            const r = intersectCurves2dFn(segment, c, 1e-9);
+            for (const pt of r.points) {
+                if (!seen.some((s) => samePoint(s, pt))) {
+                    seen.push(pt);
+                    crossCount++;
+                }
+            }
+        }
+        return crossCount % 2 === 1;
+    }
+    /**
+     * True when any curve of `this` intersects any curve of `other`.
+     * @param other - the blueprint to test for intersections against.
+     * @returns true when any pair of curves intersects.
+     */
+    intersects(other) {
+        if (isBBoxOut(this.boundingBox, other.boundingBox))
+            return false;
+        for (const a of this.curves) {
+            for (const b of other.curves) {
+                if (isBBoxOut(curveBBox(a), curveBBox(b)))
+                    continue;
+                const r = intersectCurves2dFn(a, b, 1e-9);
+                if (r.points.length || r.segments.length)
+                    return true;
+            }
+        }
+        return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// Pure helpers
+// ---------------------------------------------------------------------------
+function evaluate(c, t) {
+    return evaluateCurve2d(c, t);
+}
+function firstPointOf(c) {
+    return evaluateCurve2d(c, curveBounds(c).first);
+}
+function lastPointOf(c) {
+    return evaluateCurve2d(c, curveBounds(c).last);
+}
+function samePoint(a, b, tol = 1e-9) {
+    return Math.abs(a[0] - b[0]) < tol && Math.abs(a[1] - b[1]) < tol;
+}
+//# sourceMappingURL=blueprint.js.map

package/dist/geometry2d/blueprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blueprint.js","sourceRoot":"","sources":["../../src/geometry2d/blueprint.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Blueprint — ordered 2D profile of `Curve2dObj` segments (pure-data port of\n * brepjs `Blueprint`, Apache-2.0).\n *\n * Key adaptation: brepjs stores kernel-backed `Curve2D` handles that must be\n * disposed; faijs stores plain `Curve2dObj` objects (no handles, no dispose).\n * Kernel-coupling methods (sketchOnPlane / sketchOnFace / subFace / punchHole)\n * intentionally live in `geometry2d/bridge`, not here.\n *\n * @module\n */\nimport type { Curve2dObj } from './curve2d'\nimport { addCurveToBBox, evaluateCurve2d, curveBounds, intersectCurves2dFn, makeLine2d, mirrorAcrossAxis, mirrorAtPoint, rotateCurve2d, scaleCurve2d, translateCurve2d } from './curve2d'\nimport { centerOf, createBBox2d, isBBoxOut, mergeBBox, outsidePointOf, type BBox2d } from './bbox2d'\n\n/** 2D point. */\nexport type Point2 = [number, number]\n\n// `addCurveToBBox` writes xMin/yMin/xMax/yMax — same fields as BBox2d, so the\n// structural subtype is satisfied by passing a plain BBox2d.\nfunction curveBBox(c: Curve2dObj): BBox2d {\n  const bb = createBBox2d()\n  addCurveToBBox(bb as never, c, 1e-9)\n  return bb\n}\n\nfunction containsBoxPoint(bb: BBox2d, pt: readonly [number, number]): boolean {\n  return pt[0] >= bb.xMin && pt[0] <= bb.xMax && pt[1] >= bb.yMin && pt[1] <= bb.yMax\n}\n\n/**\n * True when `(x,y)` is within `tol` of curve `c`.\n * @param c - the curve to test against.\n * @param pt - the 2D point to test, `[x, y]`.\n * @param tol - the distance tolerance (default 1e-9).\n * @returns true when the point lies within `tol` of the curve.\n */\nexport function isOnCurve(c: Curve2dObj, pt: readonly [number, number], tol = 1e-9): boolean {\n  const bb = curveBBox(c)\n  if (!containsBoxPoint(bb, pt)) return false\n  const b = curveBounds(c)\n  const N = 32\n  let best = Infinity\n  for (let i = 0; i <= N; i++) {\n    const t = b.first + ((b.last - b.first) * i) / N\n    const [px, py] = evaluateCurve2d(c, t)\n    const d2 = (px - pt[0]) ** 2 + (py - pt[1]) ** 2\n    if (d2 < best) best = d2\n  }\n  return best <= tol * tol\n}\n\n/**\n * A planar 2D profile = an ordered sequence of 2D curves.\n * Shared base for `cad.profile`, `cad.draw` and (solved) `cad.sketch` outputs on\n * their way to `sketchOnPlane`/`sketchOnFace`.\n */\nexport class Blueprint {\n  /** Ordered 2D curve segments composing this blueprint. */\n  readonly curves: Curve2dObj[]\n\n  private _bbox: BBox2d | null = null\n  private _orientation: 'clockwise' | 'counterClockwise' | null = null\n  private _guessedOrientation: 'clockwise' | 'counterClockwise' | null = null\n\n  constructor(curves: Curve2dObj[]) {\n    if (curves.length === 0) throw new Error('Blueprint requires at least one curve')\n    this.curves = curves\n  }\n\n  /**\n   * Return a shallow copy of this blueprint (new container, same curve objects).\n   * @returns a new Blueprint with the same curves.\n   */\n  clone(): Blueprint {\n    return new Blueprint([...this.curves])\n  }\n\n  /** Bounding box (cached). */\n  get boundingBox(): BBox2d {\n    if (!this._bbox) {\n      const bb = createBBox2d()\n      for (const c of this.curves) mergeBBox(bb, curveBBox(c))\n      this._bbox = bb\n    }\n    return this._bbox\n  }\n\n  /** Winding orientation via shoelace (curve midpoints for non-lines). */\n  get orientation(): 'clockwise' | 'counterClockwise' {\n    if (this._orientation) return this._orientation\n    if (this._guessedOrientation) return this._guessedOrientation\n    const vertices: Point2[] = []\n    for (const c of this.curves) {\n      const b = curveBounds(c)\n      vertices.push(firstPointOf(c))\n      if (c.kind2d !== 'line') vertices.push(evaluate(c, (b.first + b.last) / 2) as Point2)\n    }\n    let area = 0\n    for (let i = 0; i < vertices.length; i++) {\n      const v1 = vertices[i]!\n      const v2 = vertices[(i + 1) % vertices.length]!\n      area += (v2[0] - v1[0]) * (v2[1] + v1[1])\n    }\n    this._guessedOrientation = area > 0 ? 'clockwise' : 'counterClockwise'\n    return this._guessedOrientation\n  }\n\n  /**\n   * Scale the blueprint 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 Blueprint with every curve scaled about the center.\n   */\n  scale(factor: number, center?: Point2): Blueprint {\n    const [cx, cy] = center ?? centerOf(this.boundingBox)\n    return new Blueprint(this.curves.map((c) => scaleCurve2d(c, factor, cx, cy)))\n  }\n\n  /**\n   * Translate the whole blueprint 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 Blueprint with every curve translated.\n   */\n  translate(dxOrPoint: number | Point2, dy?: number): Blueprint {\n    const [dx, yy] = typeof dxOrPoint === 'number' ? [dxOrPoint, dy ?? 0] : [dxOrPoint[0], dxOrPoint[1]]\n    return new Blueprint(this.curves.map((c) => translateCurve2d(c, dx, yy)))\n  }\n\n  /**\n   * Rotate the whole blueprint 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 Blueprint with every curve rotated.\n   */\n  rotate(angleDeg: number, center?: Point2): Blueprint {\n    const a = (angleDeg * Math.PI) / 180\n    const [cx, cy] = center ?? [0, 0]\n    return new Blueprint(this.curves.map((c) => rotateCurve2d(c, a, cx, cy)))\n  }\n\n  /**\n   * Mirror the whole blueprint.\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 Blueprint with every curve mirrored.\n   */\n  mirror(centerOrDirection: Point2, origin?: Point2, mode: 'center' | 'plane' = 'center'): Blueprint {\n    if (mode === 'plane') {\n      const [ox, oy] = origin ?? [0, 0]\n      const [dx, dy] = centerOrDirection\n      return new Blueprint(this.curves.map((c) => mirrorAcrossAxis(c, ox, oy, dx, dy)))\n    }\n    const [cx, cy] = centerOrDirection\n    return new Blueprint(this.curves.map((c) => mirrorAtPoint(c, cx, cy)))\n  }\n\n  /**\n   * The starting point of the first curve.\n   * @returns the 2D point where this blueprint begins.\n   */\n  get firstPoint(): Point2 {\n    return firstPointOf(this.curves[0]!)\n  }\n\n  /**\n   * The ending point of the last curve.\n   * @returns the 2D point where this blueprint ends.\n   */\n  get lastPoint(): Point2 {\n    return lastPointOf(this.curves[this.curves.length - 1]!)\n  }\n\n  /**\n   * True when the profile closes back on itself.\n   * @returns true when the first and last points coincide.\n   */\n  isClosed(): boolean {\n    const fp = this.firstPoint\n    const lp = this.lastPoint\n    return Math.abs(fp[0] - lp[0]) < 1e-9 && Math.abs(fp[1] - lp[1]) < 1e-9\n  }\n\n  /**\n   * True when a point is strictly inside (ray-cast); false on the boundary.\n   * @param point - the 2D point to test, `[x, y]`.\n   * @returns true when the point is strictly inside, false on/outside the boundary.\n   */\n  isInside(point: readonly [number, number]): boolean {\n    const bbox = this.boundingBox\n    const p: Point2 = [point[0], point[1]]\n    if (!containsBoxPoint(bbox, p)) return false\n    if (this.curves.some((c) => isOnCurve(c, p))) return false\n    const outside = outsidePointOf(bbox)\n    const segment = makeLine2d(p[0], p[1], outside[0], outside[1])\n    const seen: Point2[] = []\n    let crossCount = 0\n    for (const c of this.curves) {\n      if (isBBoxOut(curveBBox(segment), curveBBox(c))) continue\n      const r = intersectCurves2dFn(segment, c, 1e-9)\n      for (const pt of r.points) {\n        if (!seen.some((s) => samePoint(s, pt))) {\n          seen.push(pt)\n          crossCount++\n        }\n      }\n    }\n    return crossCount % 2 === 1\n  }\n\n  /**\n   * True when any curve of `this` intersects any curve of `other`.\n   * @param other - the blueprint to test for intersections against.\n   * @returns true when any pair of curves intersects.\n   */\n  intersects(other: Blueprint): boolean {\n    if (isBBoxOut(this.boundingBox, other.boundingBox)) return false\n    for (const a of this.curves) {\n      for (const b of other.curves) {\n        if (isBBoxOut(curveBBox(a), curveBBox(b))) continue\n        const r = intersectCurves2dFn(a, b, 1e-9)\n        if (r.points.length || r.segments.length) return true\n      }\n    }\n    return false\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Pure helpers\n// ---------------------------------------------------------------------------\n\nfunction evaluate(c: Curve2dObj, t: number): [number, number] {\n  return evaluateCurve2d(c, t)\n}\n\nfunction firstPointOf(c: Curve2dObj): Point2 {\n  return evaluateCurve2d(c, curveBounds(c).first)\n}\n\nfunction lastPointOf(c: Curve2dObj): Point2 {\n  return evaluateCurve2d(c, curveBounds(c).last)\n}\n\nfunction samePoint(a: readonly [number, number], b: readonly [number, number], tol = 1e-9): boolean {\n  return Math.abs(a[0] - b[0]) < tol && Math.abs(a[1] - b[1]) < tol\n}"]}

package/dist/geometry2d/blueprints.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Blueprints — collection of disjoint 2D profiles (pure-data port of brepjs,
+ * Apache-2.0). Typical result of boolean operations producing multiple regions.
+ * @module
+ */
+import { Blueprint, type Point2 } from './blueprint.js';
+import { CompoundBlueprint } from './compound-blueprint.js';
+import { type BBox2d } from './bbox2d.js';
+/**
+ * Blueprints — collection of disjoint 2D profiles.
+ * Typical result of boolean operations producing multiple independent regions.
+ */
+export declare class Blueprints {
+    /** The independent profiles in this collection. */
+    readonly blueprints: Array<Blueprint | CompoundBlueprint>;
+    private _bbox;
+    constructor(blueprints: Array<Blueprint | CompoundBlueprint>);
+    /**
+     * Return a copy of this collection.
+     * @returns a new Blueprints whose profiles are clones of the originals.
+     */
+    clone(): Blueprints;
+    /**
+     * Bounding box (cached). The box spanning all contained profiles.
+     * @returns a BBox2d enclosing every profile in this collection.
+     */
+    get boundingBox(): BBox2d;
+    /**
+     * Scale every 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 Blueprints with every profile scaled.
+     */
+    scale(factor: number, center?: Point2): Blueprints;
+    /**
+     * Translate every 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 Blueprints with every profile translated.
+     */
+    translate(dxOrPoint: number | Point2, dy?: number): Blueprints;
+    /**
+     * Rotate every 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 Blueprints with every profile rotated.
+     */
+    rotate(angleDeg: number, center?: Point2): Blueprints;
+    /**
+     * Mirror every 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 Blueprints with every profile mirrored.
+     */
+    mirror(centerOrDirection: Point2, origin?: Point2, mode?: 'center' | 'plane'): Blueprints;
+}
+//# sourceMappingURL=blueprints.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blueprints.d.ts","sourceRoot":"","sources":["../../src/geometry2d/blueprints.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,SAAS,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,EAAqC,KAAK,MAAM,EAAE,MAAM,UAAU,CAAA;AAEzE;;;GAGG;AACH,qBAAa,UAAU;IACrB,mDAAmD;IACnD,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,SAAS,GAAG,iBAAiB,CAAC,CAAA;IAEzD,OAAO,CAAC,KAAK,CAAsB;gBAEvB,UAAU,EAAE,KAAK,CAAC,SAAS,GAAG,iBAAiB,CAAC;IAI5D;;;OAGG;IACH,KAAK,IAAI,UAAU;IAInB;;;OAGG;IACH,IAAI,WAAW,IAAI,MAAM,CAOxB;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU;IAKlD;;;;;OAKG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,UAAU;IAI9D;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU;IAIrD;;;;;;OAMG;IACH,MAAM,CAAC,iBAAiB,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,GAAE,QAAQ,GAAG,OAAkB,GAAG,UAAU;CAGpG"}

package/dist/geometry2d/blueprints.js

@@ -0,0 +1,72 @@
+import { centerOf, createBBox2d, mergeBBox } from './bbox2d.js';
+/**
+ * Blueprints — collection of disjoint 2D profiles.
+ * Typical result of boolean operations producing multiple independent regions.
+ */
+export class Blueprints {
+    /** The independent profiles in this collection. */
+    blueprints;
+    _bbox = null;
+    constructor(blueprints) {
+        this.blueprints = blueprints;
+    }
+    /**
+     * Return a copy of this collection.
+     * @returns a new Blueprints whose profiles are clones of the originals.
+     */
+    clone() {
+        return new Blueprints(this.blueprints.map((b) => b.clone()));
+    }
+    /**
+     * Bounding box (cached). The box spanning all contained profiles.
+     * @returns a BBox2d enclosing every profile in this collection.
+     */
+    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 every 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 Blueprints with every profile scaled.
+     */
+    scale(factor, center) {
+        const ctr = center ?? centerOf(this.boundingBox);
+        return new Blueprints(this.blueprints.map((b) => b.scale(factor, ctr)));
+    }
+    /**
+     * Translate every 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 Blueprints with every profile translated.
+     */
+    translate(dxOrPoint, dy) {
+        return new Blueprints(this.blueprints.map((b) => b.translate(dxOrPoint, dy ?? 0)));
+    }
+    /**
+     * Rotate every 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 Blueprints with every profile rotated.
+     */
+    rotate(angleDeg, center) {
+        return new Blueprints(this.blueprints.map((b) => b.rotate(angleDeg, center)));
+    }
+    /**
+     * Mirror every 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 Blueprints with every profile mirrored.
+     */
+    mirror(centerOrDirection, origin, mode = 'center') {
+        return new Blueprints(this.blueprints.map((b) => b.mirror(centerOrDirection, origin, mode)));
+    }
+}
+//# sourceMappingURL=blueprints.js.map

package/dist/geometry2d/blueprints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blueprints.js","sourceRoot":"","sources":["../../src/geometry2d/blueprints.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAe,MAAM,UAAU,CAAA;AAEzE;;;GAGG;AACH,MAAM,OAAO,UAAU;IACrB,mDAAmD;IAC1C,UAAU,CAAsC;IAEjD,KAAK,GAAkB,IAAI,CAAA;IAEnC,YAAY,UAAgD;QAC1D,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;IAC9B,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;IAC9D,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,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;IACzE,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,SAA0B,EAAE,EAAW;QAC/C,OAAO,IAAI,UAAU,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;IACpF,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,QAAgB,EAAE,MAAe;QACtC,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;IAC/E,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,iBAAyB,EAAE,MAAe,EAAE,OAA2B,QAAQ;QACpF,OAAO,IAAI,UAAU,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;IAC9F,CAAC;CACF","sourcesContent":["/**\n * Blueprints — collection of disjoint 2D profiles (pure-data port of brepjs,\n * Apache-2.0). Typical result of boolean operations producing multiple regions.\n * @module\n */\nimport { Blueprint, type Point2 } from './blueprint'\nimport { CompoundBlueprint } from './compound-blueprint'\nimport { centerOf, createBBox2d, mergeBBox, type BBox2d } from './bbox2d'\n\n/**\n * Blueprints — collection of disjoint 2D profiles.\n * Typical result of boolean operations producing multiple independent regions.\n */\nexport class Blueprints {\n  /** The independent profiles in this collection. */\n  readonly blueprints: Array<Blueprint | CompoundBlueprint>\n\n  private _bbox: BBox2d | null = null\n\n  constructor(blueprints: Array<Blueprint | CompoundBlueprint>) {\n    this.blueprints = blueprints\n  }\n\n  /**\n   * Return a copy of this collection.\n   * @returns a new Blueprints whose profiles are clones of the originals.\n   */\n  clone(): Blueprints {\n    return new Blueprints(this.blueprints.map((b) => b.clone()))\n  }\n\n  /**\n   * Bounding box (cached). The box spanning all contained profiles.\n   * @returns a BBox2d enclosing every profile in this collection.\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 every 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 Blueprints with every profile scaled.\n   */\n  scale(factor: number, center?: Point2): Blueprints {\n    const ctr = center ?? centerOf(this.boundingBox)\n    return new Blueprints(this.blueprints.map((b) => b.scale(factor, ctr)))\n  }\n\n  /**\n   * Translate every 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 Blueprints with every profile translated.\n   */\n  translate(dxOrPoint: number | Point2, dy?: number): Blueprints {\n    return new Blueprints(this.blueprints.map((b) => b.translate(dxOrPoint, dy ?? 0)))\n  }\n\n  /**\n   * Rotate every 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 Blueprints with every profile rotated.\n   */\n  rotate(angleDeg: number, center?: Point2): Blueprints {\n    return new Blueprints(this.blueprints.map((b) => b.rotate(angleDeg, center)))\n  }\n\n  /**\n   * Mirror every 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 Blueprints with every profile mirrored.\n   */\n  mirror(centerOrDirection: Point2, origin?: Point2, mode: 'center' | 'plane' = 'center'): Blueprints {\n    return new Blueprints(this.blueprints.map((b) => b.mirror(centerOrDirection, origin, mode)))\n  }\n}"]}

package/dist/geometry2d/bridge/lift-on-plane.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 2D curve → 3D plane placement primitives (E2, occt-only bridge layer).
+ *
+ * This is the "lift" half of `sketchOnPlane`: it maps a pure-2D `Curve2dObj[]`
+ * (or `Blueprint`) onto an arbitrary plane and assembles the resulting 3D edges
+ * into a wire. `curvesAsEdgesOnPlane` / `assembleWire` mirror the plan's E2 work
+ * items. The kernel edge/wire primitives are accepted as `Pick<BrepEngineApi, …>`
+ * (the bridge may import the kernel contract, only `api/` is off-limits) so
+ * callers pass `getBrepApi()` directly with no casts.
+ * @module
+ */
+import type { BrepEngineApi } from '../../brep/engine/primitives.js';
+import type { BrepHandle } from '../../brep/engine/types.js';
+import type { Curve2dObj } from '../curve2d.js';
+import type { Blueprint } from '../blueprint.js';
+import { type Plane } from './plane.js';
+/** Minimal kernel edge/wire surface needed for planar placement. */
+export type PlaneWireKernel = Pick<BrepEngineApi, 'makeLineEdge' | 'makeArcEdge' | 'makeBezierEdge' | 'makeWire'>;
+/**
+ * Build the 3D edge(s) for a single 2D curve lifted onto a plane. Line and
+ * bezier build exact analytic edges; circle / trimmed-circle build a true arc
+ * edge from three on-plane lift points (a full circle is split into two arcs to
+ * keep `makeArcEdge` well-formed); ellipse / bspline fall back to a dense
+ * sampled polyline.
+ * @param kernel - the kernel edge primitives.
+ * @param plane - the target plane frame.
+ * @param c - the ordered 2D curve to lift.
+ * @returns the lifted 3D edge handle(s), in curve order.
+ */
+export declare function liftCurve2dToPlane(kernel: PlaneWireKernel, plane: Plane, c: Curve2dObj): BrepHandle[];
+/**
+ * Lift an ordered list of 2D curves to edges on a plane frame.
+ * @param kernel - the kernel edge/wire primitives.
+ * @param plane - the target plane.
+ * @param curves - the ordered 2D curves (a closed loop stays closed).
+ * @returns the lifted 3D edge handles in the same order.
+ */
+export declare function curvesAsEdgesOnPlane(kernel: PlaneWireKernel, plane: Plane, curves: readonly Curve2dObj[]): BrepHandle[];
+/**
+ * Assemble a Blueprint's curves into a 3D wire on a plane — the shared placement
+ * step for all of the profile / draw / sketch sources.
+ * @param kernel - the curve kernel/wire primitives.
+ * @param planeOrName - a plane frame or a named plane string (`'XY'` / `'XZ'` / …).
+ * @param bp - the blueprint whose ordered curves become the wire.
+ * @returns the assembled 3D wire.
+ */
+export declare function assembleWire(kernel: PlaneWireKernel, planeOrName: Plane | string, bp: Blueprint): BrepHandle;
+export { liftPointToPlane, namedPlane, makePlane, toVec3 } from './plane.js';
+export type { Plane, Vec3, Vec3Input } from './plane.js';
+//# sourceMappingURL=lift-on-plane.d.ts.map

package/dist/geometry2d/bridge/lift-on-plane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lift-on-plane.d.ts","sourceRoot":"","sources":["../../../src/geometry2d/bridge/lift-on-plane.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAgC,KAAK,KAAK,EAAa,MAAM,SAAS,CAAA;AAE7E,oEAAoE;AACpE,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,aAAa,EAAE,cAAc,GAAG,aAAa,GAAG,gBAAgB,GAAG,UAAU,CAAC,CAAA;AAEjH;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,GAAG,UAAU,EAAE,CAuBrG;AAaD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,UAAU,EAAE,CAIvH;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,EAAE,WAAW,EAAE,KAAK,GAAG,MAAM,EAAE,EAAE,EAAE,SAAS,GAAG,UAAU,CAG5G;AAED,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AACzE,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA"}

package/dist/geometry2d/bridge/lift-on-plane.js

@@ -0,0 +1,72 @@
+import { evaluateCurve2d } from '../curve2d.js';
+import { namedPlane, liftPointToPlane } from './plane.js';
+/**
+ * Build the 3D edge(s) for a single 2D curve lifted onto a plane. Line and
+ * bezier build exact analytic edges; circle / trimmed-circle build a true arc
+ * edge from three on-plane lift points (a full circle is split into two arcs to
+ * keep `makeArcEdge` well-formed); ellipse / bspline fall back to a dense
+ * sampled polyline.
+ * @param kernel - the kernel edge primitives.
+ * @param plane - the target plane frame.
+ * @param c - the ordered 2D curve to lift.
+ * @returns the lifted 3D edge handle(s), in curve order.
+ */
+export function liftCurve2dToPlane(kernel, plane, c) {
+    const on = (c2, t) => liftPointToPlane(plane, ...evaluateCurve2d(c2, t));
+    switch (c.kind2d) {
+        case 'line':
+            return [
+                kernel.makeLineEdge(liftPointToPlane(plane, c.ox, c.oy), liftPointToPlane(plane, c.ox + c.dx * c.len, c.oy + c.dy * c.len)),
+            ];
+        case 'bezier':
+            return [kernel.makeBezierEdge(c.poles.map(([x, y]) => liftPointToPlane(plane, x, y)))];
+        case 'circle':
+            return [
+                kernel.makeArcEdge(on(c, 0), on(c, Math.PI / 2), on(c, Math.PI)),
+                kernel.makeArcEdge(on(c, Math.PI), on(c, (3 * Math.PI) / 2), on(c, 2 * Math.PI)),
+            ];
+        case 'trimmed':
+            if (c.basis.kind2d === 'circle')
+                return [kernel.makeArcEdge(on(c, 0), on(c, 0.5), on(c, 1))];
+            return sampledEdges(kernel, plane, c);
+        default:
+            return sampledEdges(kernel, plane, c);
+    }
+}
+/** Sample a non-analytic curve into a polyline of `makeLineEdge`s on the plane. */
+function sampledEdges(kernel, plane, c) {
+    const out = [];
+    for (let k = 0; k < 32; k++) {
+        const t0 = k / 32;
+        const t1 = (k + 1) / 32;
+        out.push(kernel.makeLineEdge(liftPointToPlane(plane, ...evaluateCurve2d(c, t0)), liftPointToPlane(plane, ...evaluateCurve2d(c, t1))));
+    }
+    return out;
+}
+/**
+ * Lift an ordered list of 2D curves to edges on a plane frame.
+ * @param kernel - the kernel edge/wire primitives.
+ * @param plane - the target plane.
+ * @param curves - the ordered 2D curves (a closed loop stays closed).
+ * @returns the lifted 3D edge handles in the same order.
+ */
+export function curvesAsEdgesOnPlane(kernel, plane, curves) {
+    const out = [];
+    for (const c of curves)
+        out.push(...liftCurve2dToPlane(kernel, plane, c));
+    return out;
+}
+/**
+ * Assemble a Blueprint's curves into a 3D wire on a plane — the shared placement
+ * step for all of the profile / draw / sketch sources.
+ * @param kernel - the curve kernel/wire primitives.
+ * @param planeOrName - a plane frame or a named plane string (`'XY'` / `'XZ'` / …).
+ * @param bp - the blueprint whose ordered curves become the wire.
+ * @returns the assembled 3D wire.
+ */
+export function assembleWire(kernel, planeOrName, bp) {
+    const plane = typeof planeOrName === 'string' ? namedPlane(planeOrName) : planeOrName;
+    return kernel.makeWire(curvesAsEdgesOnPlane(kernel, plane, bp.curves));
+}
+export { liftPointToPlane, namedPlane, makePlane, toVec3 } from './plane.js';
+//# sourceMappingURL=lift-on-plane.js.map