@faicad/faijs 0.18.3 → 0.22.2

package/dist/geometry2d/pen-sketcher.js

@@ -0,0 +1,520 @@
+/**
+ * geometry2d — 2D `BaseSketcher2d` pen (C1), adapted for the pure-object base.
+ *
+ * Ported from brepjs `2d/blueprints/baseSketcher2d.ts` (Apache-2.0).
+ *
+ * The brepjs original accumulates kernel-backed `Curve2D` handles (mutable:
+ * `delete`/`reverse`/`tangentAt`). Here those are replaced by the pure
+ * `Curve2dObj` base of `geometry2d/curve2d` — each pen method emits a plain
+ * object, the pointer advances by plain arithmetic, and end-tangent lookup maps
+ * to `tangentCurve2d`. `curves()`/`close()` return the ordered `Curve2dObj[]`,
+ * which feeds `Blueprint` and the 2D→3D placement pipeline.
+ *
+ * Not-yet-ported (honest `throw`s, per the D-group/port plan):
+ *   · `ellipse*`     — needs the SVG ellipse→arc helper;
+ *   · `smoothSplit*` — needs the spline control helper;
+ *   · `customCorner`/`closeWithMirror` — needs 2D corner/mirror ops (D-group).
+ *
+ * @module
+ */
+import { makeLine2d, makeArc2dThreePoints, makeArc2dTangent, makeBezier2d, tangentCurve2d, } from './curve2d.js';
+import { makeEllipseArcFromSvgParams, normalizeEllipseRadii } from './svg-ellipse.js';
+import { distance2d, normalize2d, polarAngle2d, polarToCartesian, samePoint } from './point.js';
+const DEG2RAD = Math.PI / 180;
+const RAD2DEG = 180 / Math.PI;
+/** Guard-style error: throw so callers immediately see pen misuse. */
+function bug(caller, message) {
+    throw new Error(`[geometry2d/pen] ${caller}: ${message}`);
+}
+/** Non-normalized tangent at the end of a curve (t=1 within its direct parameter space). */
+function endTangent(c) {
+    return tangentCurve2d(c, 1);
+}
+/**
+ * Base class for 2D flood-pen sketchers that accumulate `Curve2dObj` segments.
+ *
+ * Provides the shared pen-drawing API (lines, arcs, beziers) used by the
+ * drawing DSL. Subclasses implement `close()` to package the accumulated curves
+ * as a `Blueprint` or plain curve list.
+ */
+export class BaseSketcher2d {
+    /** Current pen position `[x, y]`. */
+    pointer;
+    /** The starting point of the pen run. */
+    firstPoint;
+    /** Accumulated segments, in draw order. */
+    pendingCurves;
+    /** A queued one-shot corner transform (D-group; unused until ported). */
+    _nextCorner;
+    constructor(origin = [0, 0]) {
+        this.pointer = origin;
+        this.firstPoint = origin;
+        this.pendingCurves = [];
+        this._nextCorner = null;
+    }
+    /**
+     * The most recently drawn curve, or `null`.
+     * @returns the last drawn curve, or `null` when nothing has been drawn.
+     */
+    _lastCurve() {
+        return this.pendingCurves.length ? this.pendingCurves[this.pendingCurves.length - 1] : null;
+    }
+    /**
+     * Fetch the last drawn curve, or throw a misuse error.
+     * @param caller - the calling method name (for the error message).
+     * @returns the last curve.
+     */
+    _requireLastCurve(caller) {
+        const c = this._lastCurve();
+        if (!c)
+            bug(caller, 'You need a previous curve to continue');
+        return c;
+    }
+    /**
+     * Add a relative offset to the current pointer.
+     * @param xDist - relative x distance.
+     * @param yDist - relative y distance.
+     * @returns the resulting absolute point.
+     */
+    _resolveRelative(xDist, yDist) {
+        return [this.pointer[0] + xDist, this.pointer[1] + yDist];
+    }
+    /**
+     * Save a curve and advance the pen to `end`.
+     * @param curve - the curve to record.
+     * @param end - the new pen position.
+     * @returns this pen, for chaining.
+     */
+    _saveCurveAndAdvance(curve, end) {
+        this.saveCurve(curve);
+        this.pointer = end;
+        return this;
+    }
+    /** The current pen position `[x, y]`. */
+    get penPosition() {
+        return this.pointer;
+    }
+    /** The current pen angle in degrees (direction of the last segment's end tangent). */
+    get penAngle() {
+        const last = this._lastCurve();
+        if (!last)
+            return 0;
+        const [dx, dy] = endTangent(last);
+        return Math.atan2(dy, dx) * RAD2DEG;
+    }
+    /**
+     * Move the pen to an absolute position before any segment is drawn.
+     * @param point - the absolute start position.
+     * @returns this pen, for chaining.
+     */
+    movePointerTo(point) {
+        if (this.pendingCurves.length)
+            bug('movePointerTo', 'You can only move the pointer if there is no curve defined');
+        this.pointer = point;
+        this.firstPoint = point;
+        return this;
+    }
+    /**
+     * Record a segment, applying a queued corner transform if present.
+     * @param curve - the curve to record.
+     */
+    saveCurve(curve) {
+        if (!this._nextCorner) {
+            this.pendingCurves.push(curve);
+            return;
+        }
+        const previous = this.pendingCurves.pop();
+        if (!previous)
+            bug('saveCurve', 'No previous curve available for custom corner');
+        const cornered = this._nextCorner(previous, curve);
+        this.pendingCurves.push(...cornered);
+        this._nextCorner = null;
+    }
+    /**
+     * Draw a straight line to an absolute point.
+     * @param point - the absolute end point.
+     * @returns this pen, for chaining.
+     */
+    lineTo(point) {
+        return this._saveCurveAndAdvance(makeLine2d(this.pointer[0], this.pointer[1], point[0], point[1]), point);
+    }
+    /**
+     * Draw a straight line by relative horizontal and vertical distances.
+     * @param x - relative x distance.
+     * @param y - relative y distance.
+     * @returns this pen, for chaining.
+     */
+    line(x, y) {
+        return this.lineTo(this._resolveRelative(x, y));
+    }
+    /**
+     * Draw a vertical line of the given signed distance.
+     * @param distance - signed vertical distance.
+     * @returns this pen, for chaining.
+     */
+    vLine(distance) {
+        return this.line(0, distance);
+    }
+    /**
+     * Draw a horizontal line of the given signed distance.
+     * @param distance - signed horizontal distance.
+     * @returns this pen, for chaining.
+     */
+    hLine(distance) {
+        return this.line(distance, 0);
+    }
+    /**
+     * Draw a vertical line to an absolute Y coordinate.
+     * @param yPos - the absolute y.
+     * @returns this pen, for chaining.
+     */
+    vLineTo(yPos) {
+        return this.lineTo([this.pointer[0], yPos]);
+    }
+    /**
+     * Draw a horizontal line to an absolute X coordinate.
+     * @param xPos - the absolute x.
+     * @returns this pen, for chaining.
+     */
+    hLineTo(xPos) {
+        return this.lineTo([xPos, this.pointer[1]]);
+    }
+    /**
+     * Draw a whole contour from an explicit point list, in one call.
+     *
+     * The batched counterpart of a chained `lineTo` run, and the only form that
+     * survives the `.fai.js` dialect: the parser caps AST nesting at 100
+     * (`SEC_LIMIT`), and a chained call builds a nested
+     * `MemberExpression`/`CallExpression` tree whose depth equals the segment count
+     * — a contour of a few hundred tessellated points cannot be emitted as
+     * `pen.lineTo(a).lineTo(b)…` (measured: a 150-call chain already trips the
+     * limit). Handing the points over as ONE array literal keeps the emitted depth
+     * constant (array nesting = 2) at any point count.
+     *
+     * The first point also (re)seats an empty pen, so `firstPoint` keeps its
+     * meaning for {@link close} / `movePointerTo`. GOTCHA (2026-09-28):
+     * `movePointerTo` refuses to lift the pointer once a curve exists, so ONE pen
+     * carries exactly ONE contour — a shape holding many disjoint loops (a rebuilt
+     * Draft drawing was measured carrying 12 / 36 / 56 / 61 of them) needs one pen
+     * per loop, never one pen with several lifts.
+     *
+     * @param points - the contour's points in draw order (at least 2).
+     * @param close - append a final segment back to `points[0]` (skipped when the
+     *   run already ended there, mirroring {@link close}).
+     * @returns this pen, for chaining.
+     */
+    polyline(points, close = false) {
+        if (points.length < 2)
+            bug('polyline', 'a polyline needs at least two points');
+        const start = points[0];
+        if (this.pendingCurves.length === 0) {
+            this.pointer = [start[0], start[1]];
+            this.firstPoint = this.pointer;
+        }
+        else if (!samePoint(this.pointer, start)) {
+            bug('polyline', 'a run is already in flight — the pen must be sitting on the polyline start (use one pen per contour)');
+        }
+        for (let i = 1; i < points.length; i++) {
+            const p = points[i];
+            this.lineTo([p[0], p[1]]);
+        }
+        if (close && !samePoint(this.pointer, start))
+            this.lineTo([start[0], start[1]]);
+        return this;
+    }
+    /**
+     * Draw a line to an absolute point in polar form.
+     * @param polar - `[radius, angleDeg]`.
+     * @returns this pen, for chaining.
+     */
+    polarLineTo(polar) {
+        const [x, y] = polarToCartesian(polar[0], polar[1] * DEG2RAD);
+        return this.lineTo([x, y]);
+    }
+    /**
+     * Draw a line in polar relative form.
+     * @param distance - radial distance.
+     * @param angle - angle in degrees.
+     * @returns this pen, for chaining.
+     */
+    polarLine(distance, angle) {
+        const [x, y] = polarToCartesian(distance, angle * DEG2RAD);
+        return this.line(x, y);
+    }
+    /**
+     * Draw a line tangent to the previous curve.
+     * @param distance - distance along the tangent.
+     * @returns this pen, for chaining.
+     */
+    tangentLine(distance) {
+        const previous = this._requireLastCurve('tangentLine');
+        const [dx, dy] = normalize2d(endTangent(previous));
+        return this.line(dx * distance, dy * distance);
+    }
+    /**
+     * Draw a circular arc through a mid-point to an absolute end point.
+     * @param end - the absolute end point.
+     * @param midPoint - a point on the arc.
+     * @returns this pen, for chaining.
+     */
+    threePointsArcTo(end, midPoint) {
+        const curve = makeArc2dThreePoints(this.pointer[0], this.pointer[1], midPoint[0], midPoint[1], end[0], end[1]);
+        return this._saveCurveAndAdvance(curve, end);
+    }
+    /**
+     * Draw a circular arc through a via-point to an end point, both relative.
+     * @param x - relative x end distance.
+     * @param y - relative y end distance.
+     * @param viaX - relative via x distance.
+     * @param viaY - relative via y distance.
+     * @returns this pen, for chaining.
+     */
+    threePointsArc(x, y, viaX, viaY) {
+        const [ax, ay] = this.pointer;
+        return this.threePointsArcTo([ax + x, ay + y], [ax + viaX, ay + viaY]);
+    }
+    /**
+     * Draw a circular arc to an absolute end, bulging `sagitta` off the chord.
+     * @param end - the absolute end point.
+     * @param sagitta - the sagitta (signed bulge off the chord).
+     * @returns this pen, for chaining.
+     */
+    sagittaArcTo(end, sagitta) {
+        const [x0, y0] = this.pointer;
+        const [x1, y1] = end;
+        const midX = (x0 + x1) / 2;
+        const midY = (y0 + y1) / 2;
+        const sX = -(y1 - y0);
+        const sY = x1 - x0;
+        const sLen = Math.hypot(sX, sY);
+        if (sLen < 1e-12)
+            bug('sagittaArcTo', 'Start and end points cannot be identical');
+        const sag = [midX + (sX / sLen) * sagitta, midY + (sY / sLen) * sagitta];
+        return this.threePointsArcTo(end, sag);
+    }
+    /**
+     * Draw a circular arc to a relative end, bulging `sagitta`.
+     * @param x - relative x end distance.
+     * @param y - relative y end distance.
+     * @param sagitta - the sagitta.
+     * @returns this pen, for chaining.
+     */
+    sagittaArc(x, y, sagitta) {
+        return this.sagittaArcTo(this._resolveRelative(x, y), sagitta);
+    }
+    /**
+     * Draw a vertical sagitta arc of `distance` and `sagitta`.
+     * @param distance - vertical distance.
+     * @param sagitta - the sagitta.
+     * @returns this pen, for chaining.
+     */
+    vSagittaArc(distance, sagitta) {
+        return this.sagittaArc(0, distance, sagitta);
+    }
+    /**
+     * Draw a horizontal sagitta arc of `distance` and `sagitta`.
+     * @param distance - horizontal distance.
+     * @param sagitta - the sagitta.
+     * @returns this pen, for chaining.
+     */
+    hSagittaArc(distance, sagitta) {
+        return this.sagittaArc(distance, 0, sagitta);
+    }
+    /**
+     * Draw a circular arc to an absolute end via a bulge factor.
+     * @param end - the absolute end point.
+     * @param bulge - the bulge factor.
+     * @returns this pen, for chaining.
+     */
+    bulgeArcTo(end, bulge) {
+        if (!bulge)
+            return this.lineTo(end);
+        const halfChord = distance2d(this.pointer, end) / 2;
+        return this.sagittaArcTo(end, -bulge * halfChord);
+    }
+    /**
+     * Draw a circular arc to a relative end via a bulge factor.
+     * @param x - horizontal end distance.
+     * @param y - vertical end distance.
+     * @param bulge - the bulge factor.
+     * @returns this pen, for chaining.
+     */
+    bulgeArc(x, y, bulge) {
+        return this.bulgeArcTo(this._resolveRelative(x, y), bulge);
+    }
+    /**
+     * Draw a vertical bulge arc.
+     * @param distance - vertical distance.
+     * @param bulge - the bulge factor.
+     * @returns this pen, for chaining.
+     */
+    vBulgeArc(distance, bulge) {
+        return this.bulgeArc(0, distance, bulge);
+    }
+    /**
+     * Draw a horizontal bulge arc.
+     * @param distance - horizontal distance.
+     * @param bulge - the bulge factor.
+     * @returns this pen, for chaining.
+     */
+    hBulgeArc(distance, bulge) {
+        return this.bulgeArc(distance, 0, bulge);
+    }
+    /**
+     * Draw a circular arc tangent to the previous curve, ending at `end`.
+     * @param end - the absolute end point.
+     * @returns this pen, for chaining.
+     */
+    tangentArcTo(end) {
+        const previous = this._requireLastCurve('tangentArc');
+        const arc = makeArc2dTangent(this.pointer[0], this.pointer[1], ...endTangent(previous), end[0], end[1]);
+        return this._saveCurveAndAdvance(arc, end);
+    }
+    /**
+     * Draw a tangent arc to a relative offset.
+     * @param x - horizontal end distance.
+     * @param y - vertical end distance.
+     * @returns this pen, for chaining.
+     */
+    tangentArc(x, y) {
+        return this.tangentArcTo(this._resolveRelative(x, y));
+    }
+    /**
+     * Draw an elliptical arc (SVG-style endpoint parameters).
+     * @param end - the absolute end point.
+     * @param horizontalRadius - the horizontal radius.
+     * @param verticalRadius - the vertical radius.
+     * @param rotation - rotation in degrees.
+     * @param longAxis - SVG large-arc flag.
+     * @param sweep - SVG sweep flag.
+     * @returns this pen, for chaining.
+     */
+    ellipseTo(end, horizontalRadius, verticalRadius, rotation = 0, longAxis = false, sweep = false) {
+        const { majorRadius, minorRadius, rotationAngle } = normalizeEllipseRadii(horizontalRadius, verticalRadius, rotation);
+        const arc = makeEllipseArcFromSvgParams(this.pointer, end, majorRadius, minorRadius, rotationAngle, longAxis, sweep);
+        return this._saveCurveAndAdvance(arc, end);
+    }
+    /**
+     * Draw an elliptical arc to a relative end point.
+     * @param x - relative x end distance.
+     * @param y - relative y end distance.
+     * @param horizontalRadius - the horizontal radius.
+     * @param verticalRadius - the vertical radius.
+     * @param rotation - rotation in degrees.
+     * @param longAxis - SVG large-arc flag.
+     * @param sweep - SVG sweep flag.
+     * @returns this pen, for chaining.
+     */
+    ellipse(x, y, horizontalRadius, verticalRadius, rotation = 0, longAxis = false, sweep = false) {
+        return this.ellipseTo(this._resolveRelative(x, y), horizontalRadius, verticalRadius, rotation, longAxis, sweep);
+    }
+    /**
+     * Draw a half-ellipse arc to an absolute end point with a given minor radius.
+     * @param end - the absolute end point.
+     * @param minorRadius - the minor radius.
+     * @param sweep - SVG sweep flag.
+     * @returns this pen, for chaining.
+     */
+    halfEllipseTo(end, minorRadius, sweep = false) {
+        const angle = polarAngle2d(end, this.pointer);
+        const dist = distance2d(end, this.pointer);
+        return this.ellipseTo(end, dist / 2, minorRadius, angle * RAD2DEG, true, sweep);
+    }
+    /**
+     * Draw a half-ellipse arc to a relative end point with a given minor radius.
+     * @param x - relative x end distance.
+     * @param y - relative y end distance.
+     * @param minorRadius - the minor radius.
+     * @param sweep - SVG sweep flag.
+     * @returns this pen, for chaining.
+     */
+    halfEllipse(x, y, minorRadius, sweep = false) {
+        return this.halfEllipseTo(this._resolveRelative(x, y), minorRadius, sweep);
+    }
+    /**
+     * Draw a Bezier curve to an absolute end through control points.
+     * @param end - the absolute end point.
+     * @param controlPoints - one control point (quadratic) or two (cubic).
+     * @returns this pen, for chaining.
+     */
+    bezierCurveTo(end, controlPoints) {
+        const poles = [[this.pointer[0], this.pointer[1]], ...controlPoints, [end[0], end[1]]];
+        return this._saveCurveAndAdvance(makeBezier2d(poles), end);
+    }
+    /**
+     * Draw a quadratic Bezier to an absolute end point.
+     * @param end - the absolute end point.
+     * @param controlPoint - the single control point.
+     * @returns this pen, for chaining.
+     */
+    quadraticBezierCurveTo(end, controlPoint) {
+        return this.bezierCurveTo(end, [controlPoint]);
+    }
+    /**
+     * Draw a cubic Bezier to an absolute end point.
+     * @param end - the absolute end point.
+     * @param startControlPoint - the start control point.
+     * @param endControlPoint - the end control point.
+     * @returns this pen, for chaining.
+     */
+    cubicBezierCurveTo(end, startControlPoint, endControlPoint) {
+        return this.bezierCurveTo(end, [startControlPoint, endControlPoint]);
+    }
+    /**
+     * Draw a smooth cubic spline to an absolute end point.
+     * @param _end - the absolute end point.
+     * @param _config - spline smoothing options.
+     * @returns this pen, for chaining.
+     * @throws not yet ported (needs the spline control helper).
+     */
+    smoothSplineTo(_end, _config) {
+        throw new Error('[geometry2d/pen] smoothSplineTo is not yet ported');
+    }
+    /**
+     * Draw a smooth cubic spline to a relative end point.
+     * @param _x - relative x end distance.
+     * @param _y - relative y end distance.
+     * @param _config - spline smoothing options.
+     * @returns this pen, for chaining.
+     * @throws not yet ported (needs the spline control helper).
+     */
+    smoothSpline(_x, _y, _config) {
+        throw new Error('[geometry2d/pen] smoothSpline is not yet ported');
+    }
+    /**
+     * Change the corner between the previous and next segment.
+     * @param _radius - the corner radius.
+     * @param _mode - the corner kind.
+     * @returns this pen, for chaining.
+     * @throws D-group corner ops (fillet/chamfer/dogbone) are not yet ported.
+     */
+    customCorner(_radius, _mode = 'fillet') {
+        throw new Error('[geometry2d/pen] customCorner: D-group corner ops are not yet ported');
+    }
+    /**
+     * Close the sketch by drawing a final segment back to the start.
+     * @returns the closed, ordered curve list.
+     */
+    close() {
+        if (!samePoint(this.pointer, this.firstPoint)) {
+            this.lineTo(this.firstPoint);
+        }
+        return [...this.pendingCurves];
+    }
+    /**
+     * Close by mirroring the drawn segments across the start→current chord.
+     * @returns the closed, mirror-augmented curve list.
+     * @throws not yet ported (needs the curve-mirror transform).
+     */
+    closeWithMirror() {
+        throw new Error('[geometry2d/pen] closeWithMirror is not yet ported');
+    }
+    /**
+     * The ordered drawn curve list (no implicit close).
+     * @returns the drawn segments in draw order.
+     */
+    curves() {
+        return [...this.pendingCurves];
+    }
+}
+//# sourceMappingURL=pen-sketcher.js.map

package/dist/geometry2d/pen-sketcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pen-sketcher.js","sourceRoot":"","sources":["../../src/geometry2d/pen-sketcher.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * geometry2d — 2D `BaseSketcher2d` pen (C1), adapted for the pure-object base.\n *\n * Ported from brepjs `2d/blueprints/baseSketcher2d.ts` (Apache-2.0).\n *\n * The brepjs original accumulates kernel-backed `Curve2D` handles (mutable:\n * `delete`/`reverse`/`tangentAt`). Here those are replaced by the pure\n * `Curve2dObj` base of `geometry2d/curve2d` — each pen method emits a plain\n * object, the pointer advances by plain arithmetic, and end-tangent lookup maps\n * to `tangentCurve2d`. `curves()`/`close()` return the ordered `Curve2dObj[]`,\n * which feeds `Blueprint` and the 2D→3D placement pipeline.\n *\n * Not-yet-ported (honest `throw`s, per the D-group/port plan):\n *   · `ellipse*`     — needs the SVG ellipse→arc helper;\n *   · `smoothSplit*` — needs the spline control helper;\n *   · `customCorner`/`closeWithMirror` — needs 2D corner/mirror ops (D-group).\n *\n * @module\n */\n\nimport {\n  makeLine2d,\n  makeArc2dThreePoints,\n  makeArc2dTangent,\n  makeBezier2d,\n  tangentCurve2d,\n  type Curve2dObj,\n} from './curve2d'\nimport { makeEllipseArcFromSvgParams, normalizeEllipseRadii } from './svg-ellipse'\nimport { distance2d, normalize2d, polarAngle2d, polarToCartesian, samePoint } from './point'\n\nconst DEG2RAD = Math.PI / 180\nconst RAD2DEG = 180 / Math.PI\n\n/** A `[x, y]` 2D point (plain tuple). */\nexport type Point2 = [number, number]\n\n/** Options accepted by the spline methods. */\nexport type SplineOptions = {\n  /** Explicit start tangent; defaults to `[1,0]` or the previous segment's end tangent. */\n  startTangent?: Point2\n  /** Explicit end tangent, or the literal `'symmetric'` (mirror of the start tangent). */\n  endTangent?: Point2 | 'symmetric'\n  /** Start control-length factor. */\n  startFactor?: number\n  /** End control-length factor. */\n  endFactor?: number\n}\n\n/** Corner modes accepted by `customCorner` (D-group, not yet ported). */\nexport type CornerMode = 'fillet' | 'chamfer' | 'dogbone'\n\n/** Guard-style error: throw so callers immediately see pen misuse. */\nfunction bug(caller: string, message: string): never {\n  throw new Error(`[geometry2d/pen] ${caller}: ${message}`)\n}\n\n/** Non-normalized tangent at the end of a curve (t=1 within its direct parameter space). */\nfunction endTangent(c: Curve2dObj): [number, number] {\n  return tangentCurve2d(c, 1)\n}\n\n/**\n * Base class for 2D flood-pen sketchers that accumulate `Curve2dObj` segments.\n *\n * Provides the shared pen-drawing API (lines, arcs, beziers) used by the\n * drawing DSL. Subclasses implement `close()` to package the accumulated curves\n * as a `Blueprint` or plain curve list.\n */\nexport class BaseSketcher2d {\n  /** Current pen position `[x, y]`. */\n  pointer: Point2\n  /** The starting point of the pen run. */\n  firstPoint: Point2\n  /** Accumulated segments, in draw order. */\n  pendingCurves: Curve2dObj[]\n  /** A queued one-shot corner transform (D-group; unused until ported). */\n  _nextCorner: ((a: Curve2dObj, b: Curve2dObj) => Curve2dObj[]) | null\n\n  constructor(origin: Point2 = [0, 0]) {\n    this.pointer = origin\n    this.firstPoint = origin\n    this.pendingCurves = []\n    this._nextCorner = null\n  }\n\n  /**\n   * The most recently drawn curve, or `null`.\n   * @returns the last drawn curve, or `null` when nothing has been drawn.\n   */\n  _lastCurve(): Curve2dObj | null {\n    return this.pendingCurves.length ? this.pendingCurves[this.pendingCurves.length - 1]! : null\n  }\n\n  /**\n   * Fetch the last drawn curve, or throw a misuse error.\n   * @param caller - the calling method name (for the error message).\n   * @returns the last curve.\n   */\n  _requireLastCurve(caller: string): Curve2dObj {\n    const c = this._lastCurve()\n    if (!c) bug(caller, 'You need a previous curve to continue')\n    return c\n  }\n\n  /**\n   * Add a relative offset to the current pointer.\n   * @param xDist - relative x distance.\n   * @param yDist - relative y distance.\n   * @returns the resulting absolute point.\n   */\n  _resolveRelative(xDist: number, yDist: number): Point2 {\n    return [this.pointer[0] + xDist, this.pointer[1] + yDist]\n  }\n\n  /**\n   * Save a curve and advance the pen to `end`.\n   * @param curve - the curve to record.\n   * @param end - the new pen position.\n   * @returns this pen, for chaining.\n   */\n  _saveCurveAndAdvance(curve: Curve2dObj, end: Point2): this {\n    this.saveCurve(curve)\n    this.pointer = end\n    return this\n  }\n\n  /** The current pen position `[x, y]`. */\n  get penPosition(): Point2 {\n    return this.pointer\n  }\n\n  /** The current pen angle in degrees (direction of the last segment's end tangent). */\n  get penAngle(): number {\n    const last = this._lastCurve()\n    if (!last) return 0\n    const [dx, dy] = endTangent(last)\n    return Math.atan2(dy, dx) * RAD2DEG\n  }\n\n  /**\n   * Move the pen to an absolute position before any segment is drawn.\n   * @param point - the absolute start position.\n   * @returns this pen, for chaining.\n   */\n  movePointerTo(point: Point2): this {\n    if (this.pendingCurves.length) bug('movePointerTo', 'You can only move the pointer if there is no curve defined')\n    this.pointer = point\n    this.firstPoint = point\n    return this\n  }\n\n  /**\n   * Record a segment, applying a queued corner transform if present.\n   * @param curve - the curve to record.\n   */\n  saveCurve(curve: Curve2dObj): void {\n    if (!this._nextCorner) {\n      this.pendingCurves.push(curve)\n      return\n    }\n    const previous = this.pendingCurves.pop()\n    if (!previous) bug('saveCurve', 'No previous curve available for custom corner')\n    const cornered = this._nextCorner!(previous, curve)\n    this.pendingCurves.push(...cornered)\n    this._nextCorner = null\n  }\n\n  /**\n   * Draw a straight line to an absolute point.\n   * @param point - the absolute end point.\n   * @returns this pen, for chaining.\n   */\n  lineTo(point: Point2): this {\n    return this._saveCurveAndAdvance(makeLine2d(this.pointer[0], this.pointer[1], point[0], point[1]), point)\n  }\n\n  /**\n   * Draw a straight line by relative horizontal and vertical distances.\n   * @param x - relative x distance.\n   * @param y - relative y distance.\n   * @returns this pen, for chaining.\n   */\n  line(x: number, y: number): this {\n    return this.lineTo(this._resolveRelative(x, y))\n  }\n\n  /**\n   * Draw a vertical line of the given signed distance.\n   * @param distance - signed vertical distance.\n   * @returns this pen, for chaining.\n   */\n  vLine(distance: number): this {\n    return this.line(0, distance)\n  }\n\n  /**\n   * Draw a horizontal line of the given signed distance.\n   * @param distance - signed horizontal distance.\n   * @returns this pen, for chaining.\n   */\n  hLine(distance: number): this {\n    return this.line(distance, 0)\n  }\n\n  /**\n   * Draw a vertical line to an absolute Y coordinate.\n   * @param yPos - the absolute y.\n   * @returns this pen, for chaining.\n   */\n  vLineTo(yPos: number): this {\n    return this.lineTo([this.pointer[0], yPos])\n  }\n\n  /**\n   * Draw a horizontal line to an absolute X coordinate.\n   * @param xPos - the absolute x.\n   * @returns this pen, for chaining.\n   */\n  hLineTo(xPos: number): this {\n    return this.lineTo([xPos, this.pointer[1]])\n  }\n\n  /**\n   * Draw a whole contour from an explicit point list, in one call.\n   *\n   * The batched counterpart of a chained `lineTo` run, and the only form that\n   * survives the `.fai.js` dialect: the parser caps AST nesting at 100\n   * (`SEC_LIMIT`), and a chained call builds a nested\n   * `MemberExpression`/`CallExpression` tree whose depth equals the segment count\n   * — a contour of a few hundred tessellated points cannot be emitted as\n   * `pen.lineTo(a).lineTo(b)…` (measured: a 150-call chain already trips the\n   * limit). Handing the points over as ONE array literal keeps the emitted depth\n   * constant (array nesting = 2) at any point count.\n   *\n   * The first point also (re)seats an empty pen, so `firstPoint` keeps its\n   * meaning for {@link close} / `movePointerTo`. GOTCHA (2026-09-28):\n   * `movePointerTo` refuses to lift the pointer once a curve exists, so ONE pen\n   * carries exactly ONE contour — a shape holding many disjoint loops (a rebuilt\n   * Draft drawing was measured carrying 12 / 36 / 56 / 61 of them) needs one pen\n   * per loop, never one pen with several lifts.\n   *\n   * @param points - the contour's points in draw order (at least 2).\n   * @param close - append a final segment back to `points[0]` (skipped when the\n   *   run already ended there, mirroring {@link close}).\n   * @returns this pen, for chaining.\n   */\n  polyline(points: Point2[], close = false): this {\n    if (points.length < 2) bug('polyline', 'a polyline needs at least two points')\n    const start = points[0]!\n    if (this.pendingCurves.length === 0) {\n      this.pointer = [start[0], start[1]]\n      this.firstPoint = this.pointer\n    } else if (!samePoint(this.pointer, start)) {\n      bug(\n        'polyline',\n        'a run is already in flight — the pen must be sitting on the polyline start (use one pen per contour)',\n      )\n    }\n    for (let i = 1; i < points.length; i++) {\n      const p = points[i]!\n      this.lineTo([p[0], p[1]])\n    }\n    if (close && !samePoint(this.pointer, start)) this.lineTo([start[0], start[1]])\n    return this\n  }\n\n  /**\n   * Draw a line to an absolute point in polar form.\n   * @param polar - `[radius, angleDeg]`.\n   * @returns this pen, for chaining.\n   */\n  polarLineTo(polar: Point2): this {\n    const [x, y] = polarToCartesian(polar[0], polar[1] * DEG2RAD)\n    return this.lineTo([x, y])\n  }\n\n  /**\n   * Draw a line in polar relative form.\n   * @param distance - radial distance.\n   * @param angle - angle in degrees.\n   * @returns this pen, for chaining.\n   */\n  polarLine(distance: number, angle: number): this {\n    const [x, y] = polarToCartesian(distance, angle * DEG2RAD)\n    return this.line(x, y)\n  }\n\n  /**\n   * Draw a line tangent to the previous curve.\n   * @param distance - distance along the tangent.\n   * @returns this pen, for chaining.\n   */\n  tangentLine(distance: number): this {\n    const previous = this._requireLastCurve('tangentLine')\n    const [dx, dy] = normalize2d(endTangent(previous))\n    return this.line(dx * distance, dy * distance)\n  }\n\n  /**\n   * Draw a circular arc through a mid-point to an absolute end point.\n   * @param end - the absolute end point.\n   * @param midPoint - a point on the arc.\n   * @returns this pen, for chaining.\n   */\n  threePointsArcTo(end: Point2, midPoint: Point2): this {\n    const curve = makeArc2dThreePoints(this.pointer[0], this.pointer[1], midPoint[0], midPoint[1], end[0], end[1])\n    return this._saveCurveAndAdvance(curve, end)\n  }\n\n  /**\n   * Draw a circular arc through a via-point to an end point, both relative.\n   * @param x - relative x end distance.\n   * @param y - relative y end distance.\n   * @param viaX - relative via x distance.\n   * @param viaY - relative via y distance.\n   * @returns this pen, for chaining.\n   */\n  threePointsArc(x: number, y: number, viaX: number, viaY: number): this {\n    const [ax, ay] = this.pointer\n    return this.threePointsArcTo([ax + x, ay + y], [ax + viaX, ay + viaY])\n  }\n\n  /**\n   * Draw a circular arc to an absolute end, bulging `sagitta` off the chord.\n   * @param end - the absolute end point.\n   * @param sagitta - the sagitta (signed bulge off the chord).\n   * @returns this pen, for chaining.\n   */\n  sagittaArcTo(end: Point2, sagitta: number): this {\n    const [x0, y0] = this.pointer\n    const [x1, y1] = end\n    const midX = (x0 + x1) / 2\n    const midY = (y0 + y1) / 2\n    const sX = -(y1 - y0)\n    const sY = x1 - x0\n    const sLen = Math.hypot(sX, sY)\n    if (sLen < 1e-12) bug('sagittaArcTo', 'Start and end points cannot be identical')\n    const sag: Point2 = [midX + (sX / sLen) * sagitta, midY + (sY / sLen) * sagitta]\n    return this.threePointsArcTo(end, sag)\n  }\n\n  /**\n   * Draw a circular arc to a relative end, bulging `sagitta`.\n   * @param x - relative x end distance.\n   * @param y - relative y end distance.\n   * @param sagitta - the sagitta.\n   * @returns this pen, for chaining.\n   */\n  sagittaArc(x: number, y: number, sagitta: number): this {\n    return this.sagittaArcTo(this._resolveRelative(x, y), sagitta)\n  }\n\n  /**\n   * Draw a vertical sagitta arc of `distance` and `sagitta`.\n   * @param distance - vertical distance.\n   * @param sagitta - the sagitta.\n   * @returns this pen, for chaining.\n   */\n  vSagittaArc(distance: number, sagitta: number): this {\n    return this.sagittaArc(0, distance, sagitta)\n  }\n\n  /**\n   * Draw a horizontal sagitta arc of `distance` and `sagitta`.\n   * @param distance - horizontal distance.\n   * @param sagitta - the sagitta.\n   * @returns this pen, for chaining.\n   */\n  hSagittaArc(distance: number, sagitta: number): this {\n    return this.sagittaArc(distance, 0, sagitta)\n  }\n\n  /**\n   * Draw a circular arc to an absolute end via a bulge factor.\n   * @param end - the absolute end point.\n   * @param bulge - the bulge factor.\n   * @returns this pen, for chaining.\n   */\n  bulgeArcTo(end: Point2, bulge: number): this {\n    if (!bulge) return this.lineTo(end)\n    const halfChord = distance2d(this.pointer, end) / 2\n    return this.sagittaArcTo(end, -bulge * halfChord)\n  }\n\n  /**\n   * Draw a circular arc to a relative end via a bulge factor.\n   * @param x - horizontal end distance.\n   * @param y - vertical end distance.\n   * @param bulge - the bulge factor.\n   * @returns this pen, for chaining.\n   */\n  bulgeArc(x: number, y: number, bulge: number): this {\n    return this.bulgeArcTo(this._resolveRelative(x, y), bulge)\n  }\n\n  /**\n   * Draw a vertical bulge arc.\n   * @param distance - vertical distance.\n   * @param bulge - the bulge factor.\n   * @returns this pen, for chaining.\n   */\n  vBulgeArc(distance: number, bulge: number): this {\n    return this.bulgeArc(0, distance, bulge)\n  }\n\n  /**\n   * Draw a horizontal bulge arc.\n   * @param distance - horizontal distance.\n   * @param bulge - the bulge factor.\n   * @returns this pen, for chaining.\n   */\n  hBulgeArc(distance: number, bulge: number): this {\n    return this.bulgeArc(distance, 0, bulge)\n  }\n\n  /**\n   * Draw a circular arc tangent to the previous curve, ending at `end`.\n   * @param end - the absolute end point.\n   * @returns this pen, for chaining.\n   */\n  tangentArcTo(end: Point2): this {\n    const previous = this._requireLastCurve('tangentArc')\n    const arc = makeArc2dTangent(this.pointer[0], this.pointer[1], ...endTangent(previous), end[0], end[1])\n    return this._saveCurveAndAdvance(arc, end)\n  }\n\n  /**\n   * Draw a tangent arc to a relative offset.\n   * @param x - horizontal end distance.\n   * @param y - vertical end distance.\n   * @returns this pen, for chaining.\n   */\n  tangentArc(x: number, y: number): this {\n    return this.tangentArcTo(this._resolveRelative(x, y))\n  }\n\n  /**\n   * Draw an elliptical arc (SVG-style endpoint parameters).\n   * @param end - the absolute end point.\n   * @param horizontalRadius - the horizontal radius.\n   * @param verticalRadius - the vertical radius.\n   * @param rotation - rotation in degrees.\n   * @param longAxis - SVG large-arc flag.\n   * @param sweep - SVG sweep flag.\n   * @returns this pen, for chaining.\n   */\n  ellipseTo(end: Point2, horizontalRadius: number, verticalRadius: number, rotation = 0, longAxis = false, sweep = false): this {\n    const { majorRadius, minorRadius, rotationAngle } = normalizeEllipseRadii(horizontalRadius, verticalRadius, rotation)\n    const arc = makeEllipseArcFromSvgParams(this.pointer, end, majorRadius, minorRadius, rotationAngle, longAxis, sweep)\n    return this._saveCurveAndAdvance(arc, end)\n  }\n\n  /**\n   * Draw an elliptical arc to a relative end point.\n   * @param x - relative x end distance.\n   * @param y - relative y end distance.\n   * @param horizontalRadius - the horizontal radius.\n   * @param verticalRadius - the vertical radius.\n   * @param rotation - rotation in degrees.\n   * @param longAxis - SVG large-arc flag.\n   * @param sweep - SVG sweep flag.\n   * @returns this pen, for chaining.\n   */\n  ellipse(x: number, y: number, horizontalRadius: number, verticalRadius: number, rotation = 0, longAxis = false, sweep = false): this {\n    return this.ellipseTo(this._resolveRelative(x, y), horizontalRadius, verticalRadius, rotation, longAxis, sweep)\n  }\n\n  /**\n   * Draw a half-ellipse arc to an absolute end point with a given minor radius.\n   * @param end - the absolute end point.\n   * @param minorRadius - the minor radius.\n   * @param sweep - SVG sweep flag.\n   * @returns this pen, for chaining.\n   */\n  halfEllipseTo(end: Point2, minorRadius: number, sweep = false): this {\n    const angle = polarAngle2d(end, this.pointer)\n    const dist = distance2d(end, this.pointer)\n    return this.ellipseTo(end, dist / 2, minorRadius, angle * RAD2DEG, true, sweep)\n  }\n\n  /**\n   * Draw a half-ellipse arc to a relative end point with a given minor radius.\n   * @param x - relative x end distance.\n   * @param y - relative y end distance.\n   * @param minorRadius - the minor radius.\n   * @param sweep - SVG sweep flag.\n   * @returns this pen, for chaining.\n   */\n  halfEllipse(x: number, y: number, minorRadius: number, sweep = false): this {\n    return this.halfEllipseTo(this._resolveRelative(x, y), minorRadius, sweep)\n  }\n\n  /**\n   * Draw a Bezier curve to an absolute end through control points.\n   * @param end - the absolute end point.\n   * @param controlPoints - one control point (quadratic) or two (cubic).\n   * @returns this pen, for chaining.\n   */\n  bezierCurveTo(end: Point2, controlPoints: Point2[]): this {\n    const poles: [number, number][] = [[this.pointer[0], this.pointer[1]], ...controlPoints, [end[0], end[1]]]\n    return this._saveCurveAndAdvance(makeBezier2d(poles), end)\n  }\n\n  /**\n   * Draw a quadratic Bezier to an absolute end point.\n   * @param end - the absolute end point.\n   * @param controlPoint - the single control point.\n   * @returns this pen, for chaining.\n   */\n  quadraticBezierCurveTo(end: Point2, controlPoint: Point2): this {\n    return this.bezierCurveTo(end, [controlPoint])\n  }\n\n  /**\n   * Draw a cubic Bezier to an absolute end point.\n   * @param end - the absolute end point.\n   * @param startControlPoint - the start control point.\n   * @param endControlPoint - the end control point.\n   * @returns this pen, for chaining.\n   */\n  cubicBezierCurveTo(end: Point2, startControlPoint: Point2, endControlPoint: Point2): this {\n    return this.bezierCurveTo(end, [startControlPoint, endControlPoint])\n  }\n\n  /**\n   * Draw a smooth cubic spline to an absolute end point.\n   * @param _end - the absolute end point.\n   * @param _config - spline smoothing options.\n   * @returns this pen, for chaining.\n   * @throws not yet ported (needs the spline control helper).\n   */\n  smoothSplineTo(_end: Point2, _config?: SplineOptions): this {\n    throw new Error('[geometry2d/pen] smoothSplineTo is not yet ported')\n  }\n\n  /**\n   * Draw a smooth cubic spline to a relative end point.\n   * @param _x - relative x end distance.\n   * @param _y - relative y end distance.\n   * @param _config - spline smoothing options.\n   * @returns this pen, for chaining.\n   * @throws not yet ported (needs the spline control helper).\n   */\n  smoothSpline(_x: number, _y: number, _config?: SplineOptions): this {\n    throw new Error('[geometry2d/pen] smoothSpline is not yet ported')\n  }\n\n  /**\n   * Change the corner between the previous and next segment.\n   * @param _radius - the corner radius.\n   * @param _mode - the corner kind.\n   * @returns this pen, for chaining.\n   * @throws D-group corner ops (fillet/chamfer/dogbone) are not yet ported.\n   */\n  customCorner(_radius: number, _mode: CornerMode = 'fillet'): this {\n    throw new Error('[geometry2d/pen] customCorner: D-group corner ops are not yet ported')\n  }\n\n  /**\n   * Close the sketch by drawing a final segment back to the start.\n   * @returns the closed, ordered curve list.\n   */\n  close(): Curve2dObj[] {\n    if (!samePoint(this.pointer, this.firstPoint)) {\n      this.lineTo(this.firstPoint)\n    }\n    return [...this.pendingCurves]\n  }\n\n  /**\n   * Close by mirroring the drawn segments across the start→current chord.\n   * @returns the closed, mirror-augmented curve list.\n   * @throws not yet ported (needs the curve-mirror transform).\n   */\n  closeWithMirror(): Curve2dObj[] {\n    throw new Error('[geometry2d/pen] closeWithMirror is not yet ported')\n  }\n\n  /**\n   * The ordered drawn curve list (no implicit close).\n   * @returns the drawn segments in draw order.\n   */\n  curves(): Curve2dObj[] {\n    return [...this.pendingCurves]\n  }\n}"]}

package/dist/geometry2d/point.d.ts

@@ -0,0 +1,44 @@
+/**
+ * geometry2d — small 2D point / vector helpers shared by the sketcher pens and
+ * the draw package. Pure TS, zero dependency.
+ *
+ * Ported from brepjs `2d/lib`-style utilities (Apache-2.0).
+ *
+ * @module
+ */
+/**
+ * Euclidean distance between two 2D points.
+ * @param a - first point.
+ * @param b - second point.
+ * @returns the distance.
+ */
+export declare function distance2d(a: readonly [number, number], b: readonly [number, number]): number;
+/**
+ * True when two 2D points coincide within `eps`.
+ * @param a - first point.
+ * @param b - second point.
+ * @param eps - coincidence tolerance (default 1e-9).
+ * @returns whether `a` and `b` are the same point.
+ */
+export declare function samePoint(a: readonly [number, number], b: readonly [number, number], eps?: number): boolean;
+/**
+ * Convert polar `[r, theta]` (radians) to Cartesian `[x, y]`.
+ * @param r - radial distance.
+ * @param theta - angle in radians.
+ * @returns the Cartesian point.
+ */
+export declare function polarToCartesian(r: number, theta: number): [number, number];
+/**
+ * Normalize a 2D vector to unit length.
+ * @param v - the input vector.
+ * @returns the unit vector (the zero vector normalizes to `[1,0]`).
+ */
+export declare function normalize2d(v: readonly [number, number]): [number, number];
+/**
+ * Absolute polar angle of `b` relative to `a`.
+ * @param a - the reference point.
+ * @param b - the target point.
+ * @returns the angle in radians, in `[0, 2π)`.
+ */
+export declare function polarAngle2d(a: readonly [number, number], b: readonly [number, number]): number;
+//# sourceMappingURL=point.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"point.d.ts","sourceRoot":"","sources":["../../src/geometry2d/point.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAE7F;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,SAAO,GAAG,OAAO,CAEzG;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAE3E;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAI1E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAE/F"}