@faicad/faijs 0.18.2 → 0.19.0

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"curve2d.d.ts","sourceRoot":"","sources":["../../src/geometry2d/curve2d.ts"],"names":[],"mappings":"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"}