@faicad/faijs 0.13.0

package/dist/vendored/brepjs/2d/blueprints/ellipseUtils.d.ts

@@ -0,0 +1,48 @@
+import { type Point2D } from '../../2d/lib/index.js';
+import type { Curve2D } from '../../2d/lib/index.js';
+/**
+ * Normalized ellipse parameters after swapping axes when horizontalRadius < verticalRadius.
+ */
+export interface NormalizedEllipseParams {
+    readonly majorRadius: number;
+    readonly minorRadius: number;
+    readonly rotationAngle: number;
+}
+/**
+ * Normalize ellipse radii so that major >= minor, adjusting the rotation
+ * angle by 90 degrees when the radii need to be swapped.
+ */
+export declare function normalizeEllipseRadii(horizontalRadius: number, verticalRadius: number, rotation: number): NormalizedEllipseParams;
+/**
+ * Build a 2D elliptical arc curve from SVG-style endpoint parameters,
+ * applying the UV coordinate conversions used by {@link BaseSketcher2d}.
+ *
+ * @param startUV - Start point in UV space.
+ * @param endUV - End point in UV space.
+ * @param majorRadius - Major radius (already normalized so major >= minor).
+ * @param minorRadius - Minor radius.
+ * @param rotationAngleDeg - Rotation of the ellipse in degrees.
+ * @param longAxis - SVG large-arc flag.
+ * @param sweep - SVG sweep flag.
+ * @param convertToUV - Coordinate conversion function from user space to UV space.
+ */
+export declare function makeEllipseArcFromSvgParams(startUV: Point2D, endUV: Point2D, majorRadius: number, minorRadius: number, rotationAngleDeg: number, longAxis: boolean, sweep: boolean, convertToUV: (p: Point2D) => Point2D): Curve2D;
+/**
+ * Convert SVG-style elliptical arc endpoint parameters to center-parametrization.
+ *
+ * Implements the SVG spec F.6.5 / F.6.6 algorithm for converting (x1,y1)-(x2,y2)
+ * arc notation into center, radii, and angle ranges.
+ *
+ * @returns Center coordinates, corrected radii, start/end/delta angles, and winding direction.
+ */
+export declare function convertSvgEllipseParams([x1, y1]: [number, number], [x2, y2]: [number, number], rx: number, ry: number, phi: number, fA: boolean, fS: boolean): {
+    cx: number;
+    cy: number;
+    rx: number;
+    ry: number;
+    startAngle: number;
+    deltaAngle: number;
+    endAngle: number;
+    clockwise: boolean;
+};
+//# sourceMappingURL=ellipseUtils.d.ts.map

package/dist/vendored/brepjs/2d/blueprints/ellipseUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ellipseUtils.d.ts","sourceRoot":"","sources":["../../../../../src/vendored/brepjs/2d/blueprints/ellipseUtils.ts"],"names":[],"mappings":"AACA,OAAO,EAOL,KAAK,OAAO,EACb,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGrD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,gBAAgB,EAAE,MAAM,EACxB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,GACf,uBAAuB,CAazB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,GACnC,OAAO,CAkCT;AAoDD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1B,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1B,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,OAAO,EACX,EAAE,EAAE,OAAO,GACV;IACD,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACpB,CAkEA"}

package/dist/vendored/brepjs/2d/blueprints/ellipseUtils.js

@@ -0,0 +1,154 @@
+import { DEG2RAD } from '../../core/constants.js';
+import { normalize2d, distance2d, polarToCartesian, cartesianToPolar, rotate2d, make2dEllipseArc, } from '../../2d/lib/index.js';
+import { bug } from '../../core/errors.js';
+/**
+ * Normalize ellipse radii so that major >= minor, adjusting the rotation
+ * angle by 90 degrees when the radii need to be swapped.
+ */
+export function normalizeEllipseRadii(horizontalRadius, verticalRadius, rotation) {
+    if (horizontalRadius < verticalRadius) {
+        return {
+            majorRadius: verticalRadius,
+            minorRadius: horizontalRadius,
+            rotationAngle: rotation + 90,
+        };
+    }
+    return {
+        majorRadius: horizontalRadius,
+        minorRadius: verticalRadius,
+        rotationAngle: rotation,
+    };
+}
+/**
+ * Build a 2D elliptical arc curve from SVG-style endpoint parameters,
+ * applying the UV coordinate conversions used by {@link BaseSketcher2d}.
+ *
+ * @param startUV - Start point in UV space.
+ * @param endUV - End point in UV space.
+ * @param majorRadius - Major radius (already normalized so major >= minor).
+ * @param minorRadius - Minor radius.
+ * @param rotationAngleDeg - Rotation of the ellipse in degrees.
+ * @param longAxis - SVG large-arc flag.
+ * @param sweep - SVG sweep flag.
+ * @param convertToUV - Coordinate conversion function from user space to UV space.
+ */
+export function makeEllipseArcFromSvgParams(startUV, endUV, majorRadius, minorRadius, rotationAngleDeg, longAxis, sweep, convertToUV) {
+    const radRotationAngle = rotationAngleDeg * DEG2RAD;
+    const convertAxis = (ax) => distance2d(convertToUV(ax));
+    const r1 = convertAxis(polarToCartesian(majorRadius, radRotationAngle));
+    const r2 = convertAxis(polarToCartesian(minorRadius, radRotationAngle + Math.PI / 2));
+    const xDir = normalize2d(convertToUV(rotate2d([1, 0], radRotationAngle)));
+    const [, newRotationAngle] = cartesianToPolar(xDir);
+    const { cx, cy, startAngle, endAngle, clockwise, rx, ry } = convertSvgEllipseParams(startUV, endUV, r1, r2, newRotationAngle, longAxis, sweep);
+    const arc = make2dEllipseArc(rx, ry, clockwise ? startAngle : endAngle, clockwise ? endAngle : startAngle, [cx, cy], xDir);
+    if (!clockwise) {
+        arc.reverse();
+    }
+    return arc;
+}
+/**
+ * Compute start/delta/end angles from the unit-circle parameterization
+ * of an SVG elliptical arc (F6.5.5–F6.5.6).
+ */
+function computeArcAngles(xcr1, ycr1, xcr2, ycr2, fS) {
+    const PIx2 = Math.PI * 2.0;
+    const startAngle = radianAngle(1.0, 0.0, xcr1, ycr1);
+    let deltaAngle = radianAngle(xcr1, ycr1, -xcr2, -ycr2);
+    while (deltaAngle > PIx2) {
+        deltaAngle -= PIx2;
+    }
+    while (deltaAngle < 0.0) {
+        deltaAngle += PIx2;
+    }
+    if (!fS) {
+        deltaAngle -= PIx2;
+    }
+    let endAngle = startAngle + deltaAngle;
+    while (endAngle > PIx2) {
+        endAngle -= PIx2;
+    }
+    while (endAngle < 0.0) {
+        endAngle += PIx2;
+    }
+    return { startAngle, deltaAngle, endAngle };
+}
+// adapted from https://stackoverflow.com/a/12329083
+function radianAngle(ux, uy, vx, vy) {
+    const dot = ux * vx + uy * vy;
+    const mod = Math.sqrt((ux * ux + uy * uy) * (vx * vx + vy * vy));
+    if (mod < 1e-12) {
+        bug('radianAngle', 'Cannot compute angle between zero-length vectors');
+    }
+    let rad = Math.acos(Math.max(-1, Math.min(1, dot / mod)));
+    if (ux * vy - uy * vx < 0.0) {
+        rad = -rad;
+    }
+    return rad;
+}
+/**
+ * Convert SVG-style elliptical arc endpoint parameters to center-parametrization.
+ *
+ * Implements the SVG spec F.6.5 / F.6.6 algorithm for converting (x1,y1)-(x2,y2)
+ * arc notation into center, radii, and angle ranges.
+ *
+ * @returns Center coordinates, corrected radii, start/end/delta angles, and winding direction.
+ */
+export function convertSvgEllipseParams([x1, y1], [x2, y2], rx, ry, phi, fA, fS) {
+    if (rx < 0) {
+        rx = -rx;
+    }
+    if (ry < 0) {
+        ry = -ry;
+    }
+    if (rx < 1e-10 || ry < 1e-10) {
+        bug('convertSvgEllipseParams', 'rx and ry cannot be 0');
+    }
+    const s_phi = Math.sin(phi);
+    const c_phi = Math.cos(phi);
+    const hd_x = (x1 - x2) / 2.0;
+    const hd_y = (y1 - y2) / 2.0;
+    const hs_x = (x1 + x2) / 2.0;
+    const hs_y = (y1 + y2) / 2.0;
+    // F6.5.1
+    const x1_ = c_phi * hd_x + s_phi * hd_y;
+    const y1_ = c_phi * hd_y - s_phi * hd_x;
+    // F.6.6 Correction of out-of-range radii
+    const lambda = (x1_ * x1_) / (rx * rx) + (y1_ * y1_) / (ry * ry);
+    if (lambda > 1) {
+        rx = rx * Math.sqrt(lambda);
+        ry = ry * Math.sqrt(lambda);
+    }
+    const rxry = rx * ry;
+    const rxy1_ = rx * y1_;
+    const ryx1_ = ry * x1_;
+    const sum_of_sq = rxy1_ * rxy1_ + ryx1_ * ryx1_;
+    if (!sum_of_sq) {
+        bug('convertSvgEllipseParams', 'Start point cannot be same as end point');
+    }
+    let coe = Math.sqrt(Math.abs((rxry * rxry - sum_of_sq) / sum_of_sq));
+    if (fA === fS) {
+        coe = -coe;
+    }
+    // F6.5.2
+    const cx_ = (coe * rxy1_) / ry;
+    const cy_ = (-coe * ryx1_) / rx;
+    // F6.5.3
+    const cx = c_phi * cx_ - s_phi * cy_ + hs_x;
+    const cy = s_phi * cx_ + c_phi * cy_ + hs_y;
+    const xcr1 = (x1_ - cx_) / rx;
+    const xcr2 = (x1_ + cx_) / rx;
+    const ycr1 = (y1_ - cy_) / ry;
+    const ycr2 = (y1_ + cy_) / ry;
+    const { startAngle, deltaAngle, endAngle } = computeArcAngles(xcr1, ycr1, xcr2, ycr2, fS);
+    return {
+        cx,
+        cy,
+        startAngle,
+        deltaAngle,
+        endAngle,
+        clockwise: fS,
+        rx,
+        ry,
+    };
+}
+//# sourceMappingURL=ellipseUtils.js.map

package/dist/vendored/brepjs/2d/blueprints/ellipseUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ellipseUtils.js","sourceRoot":"","sources":["../../../../../src/vendored/brepjs/2d/blueprints/ellipseUtils.ts"],"names":[],"mappings":"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","sourcesContent":["import { DEG2RAD } from '../../core/constants.js';\nimport {\n  normalize2d,\n  distance2d,\n  polarToCartesian,\n  cartesianToPolar,\n  rotate2d,\n  make2dEllipseArc,\n  type Point2D,\n} from '../../2d/lib/index.js';\nimport type { Curve2D } from '../../2d/lib/index.js';\nimport { bug } from '../../core/errors.js';\n\n/**\n * Normalized ellipse parameters after swapping axes when horizontalRadius < verticalRadius.\n */\nexport interface NormalizedEllipseParams {\n  readonly majorRadius: number;\n  readonly minorRadius: number;\n  readonly rotationAngle: number;\n}\n\n/**\n * Normalize ellipse radii so that major >= minor, adjusting the rotation\n * angle by 90 degrees when the radii need to be swapped.\n */\nexport function normalizeEllipseRadii(\n  horizontalRadius: number,\n  verticalRadius: number,\n  rotation: number\n): NormalizedEllipseParams {\n  if (horizontalRadius < verticalRadius) {\n    return {\n      majorRadius: verticalRadius,\n      minorRadius: horizontalRadius,\n      rotationAngle: rotation + 90,\n    };\n  }\n  return {\n    majorRadius: horizontalRadius,\n    minorRadius: verticalRadius,\n    rotationAngle: rotation,\n  };\n}\n\n/**\n * Build a 2D elliptical arc curve from SVG-style endpoint parameters,\n * applying the UV coordinate conversions used by {@link BaseSketcher2d}.\n *\n * @param startUV - Start point in UV space.\n * @param endUV - End point in UV space.\n * @param majorRadius - Major radius (already normalized so major >= minor).\n * @param minorRadius - Minor radius.\n * @param rotationAngleDeg - Rotation of the ellipse in degrees.\n * @param longAxis - SVG large-arc flag.\n * @param sweep - SVG sweep flag.\n * @param convertToUV - Coordinate conversion function from user space to UV space.\n */\nexport function makeEllipseArcFromSvgParams(\n  startUV: Point2D,\n  endUV: Point2D,\n  majorRadius: number,\n  minorRadius: number,\n  rotationAngleDeg: number,\n  longAxis: boolean,\n  sweep: boolean,\n  convertToUV: (p: Point2D) => Point2D\n): Curve2D {\n  const radRotationAngle = rotationAngleDeg * DEG2RAD;\n\n  const convertAxis = (ax: Point2D): number => distance2d(convertToUV(ax));\n  const r1 = convertAxis(polarToCartesian(majorRadius, radRotationAngle));\n  const r2 = convertAxis(polarToCartesian(minorRadius, radRotationAngle + Math.PI / 2));\n\n  const xDir = normalize2d(convertToUV(rotate2d([1, 0], radRotationAngle)));\n  const [, newRotationAngle] = cartesianToPolar(xDir);\n\n  const { cx, cy, startAngle, endAngle, clockwise, rx, ry } = convertSvgEllipseParams(\n    startUV,\n    endUV,\n    r1,\n    r2,\n    newRotationAngle,\n    longAxis,\n    sweep\n  );\n\n  const arc = make2dEllipseArc(\n    rx,\n    ry,\n    clockwise ? startAngle : endAngle,\n    clockwise ? endAngle : startAngle,\n    [cx, cy],\n    xDir\n  );\n\n  if (!clockwise) {\n    arc.reverse();\n  }\n\n  return arc;\n}\n\n/**\n * Compute start/delta/end angles from the unit-circle parameterization\n * of an SVG elliptical arc (F6.5.5–F6.5.6).\n */\nfunction computeArcAngles(\n  xcr1: number,\n  ycr1: number,\n  xcr2: number,\n  ycr2: number,\n  fS: boolean\n): { startAngle: number; deltaAngle: number; endAngle: number } {\n  const PIx2 = Math.PI * 2.0;\n\n  const startAngle = radianAngle(1.0, 0.0, xcr1, ycr1);\n\n  let deltaAngle = radianAngle(xcr1, ycr1, -xcr2, -ycr2);\n  while (deltaAngle > PIx2) {\n    deltaAngle -= PIx2;\n  }\n  while (deltaAngle < 0.0) {\n    deltaAngle += PIx2;\n  }\n  if (!fS) {\n    deltaAngle -= PIx2;\n  }\n  let endAngle = startAngle + deltaAngle;\n  while (endAngle > PIx2) {\n    endAngle -= PIx2;\n  }\n  while (endAngle < 0.0) {\n    endAngle += PIx2;\n  }\n\n  return { startAngle, deltaAngle, endAngle };\n}\n\n// adapted from https://stackoverflow.com/a/12329083\nfunction radianAngle(ux: number, uy: number, vx: number, vy: number): number {\n  const dot = ux * vx + uy * vy;\n  const mod = Math.sqrt((ux * ux + uy * uy) * (vx * vx + vy * vy));\n  if (mod < 1e-12) {\n    bug('radianAngle', 'Cannot compute angle between zero-length vectors');\n  }\n  let rad = Math.acos(Math.max(-1, Math.min(1, dot / mod)));\n  if (ux * vy - uy * vx < 0.0) {\n    rad = -rad;\n  }\n  return rad;\n}\n\n/**\n * Convert SVG-style elliptical arc endpoint parameters to center-parametrization.\n *\n * Implements the SVG spec F.6.5 / F.6.6 algorithm for converting (x1,y1)-(x2,y2)\n * arc notation into center, radii, and angle ranges.\n *\n * @returns Center coordinates, corrected radii, start/end/delta angles, and winding direction.\n */\nexport function convertSvgEllipseParams(\n  [x1, y1]: [number, number],\n  [x2, y2]: [number, number],\n  rx: number,\n  ry: number,\n  phi: number,\n  fA: boolean,\n  fS: boolean\n): {\n  cx: number;\n  cy: number;\n  rx: number;\n  ry: number;\n  startAngle: number;\n  deltaAngle: number;\n  endAngle: number;\n  clockwise: boolean;\n} {\n  if (rx < 0) {\n    rx = -rx;\n  }\n  if (ry < 0) {\n    ry = -ry;\n  }\n  if (rx < 1e-10 || ry < 1e-10) {\n    bug('convertSvgEllipseParams', 'rx and ry cannot be 0');\n  }\n\n  const s_phi = Math.sin(phi);\n  const c_phi = Math.cos(phi);\n  const hd_x = (x1 - x2) / 2.0;\n  const hd_y = (y1 - y2) / 2.0;\n  const hs_x = (x1 + x2) / 2.0;\n  const hs_y = (y1 + y2) / 2.0;\n\n  // F6.5.1\n  const x1_ = c_phi * hd_x + s_phi * hd_y;\n  const y1_ = c_phi * hd_y - s_phi * hd_x;\n\n  // F.6.6 Correction of out-of-range radii\n  const lambda = (x1_ * x1_) / (rx * rx) + (y1_ * y1_) / (ry * ry);\n  if (lambda > 1) {\n    rx = rx * Math.sqrt(lambda);\n    ry = ry * Math.sqrt(lambda);\n  }\n\n  const rxry = rx * ry;\n  const rxy1_ = rx * y1_;\n  const ryx1_ = ry * x1_;\n  const sum_of_sq = rxy1_ * rxy1_ + ryx1_ * ryx1_;\n  if (!sum_of_sq) {\n    bug('convertSvgEllipseParams', 'Start point cannot be same as end point');\n  }\n  let coe = Math.sqrt(Math.abs((rxry * rxry - sum_of_sq) / sum_of_sq));\n  if (fA === fS) {\n    coe = -coe;\n  }\n\n  // F6.5.2\n  const cx_ = (coe * rxy1_) / ry;\n  const cy_ = (-coe * ryx1_) / rx;\n\n  // F6.5.3\n  const cx = c_phi * cx_ - s_phi * cy_ + hs_x;\n  const cy = s_phi * cx_ + c_phi * cy_ + hs_y;\n\n  const xcr1 = (x1_ - cx_) / rx;\n  const xcr2 = (x1_ + cx_) / rx;\n  const ycr1 = (y1_ - cy_) / ry;\n  const ycr2 = (y1_ + cy_) / ry;\n\n  const { startAngle, deltaAngle, endAngle } = computeArcAngles(xcr1, ycr1, xcr2, ycr2, fS);\n\n  return {\n    cx,\n    cy,\n    startAngle,\n    deltaAngle,\n    endAngle,\n    clockwise: fS,\n    rx,\n    ry,\n  };\n}\n"]}

package/dist/vendored/brepjs/2d/blueprints/genericSketcher.d.ts

@@ -0,0 +1,342 @@
+import { type Point2D, type Curve2D } from '../../2d/lib/index.js';
+type StartSplineTangent = number | Point2D;
+/** Tangent specification for smooth spline endpoints: an angle (degrees), a 2D direction, or `'symmetric'`. */
+export type SplineTangent = StartSplineTangent | 'symmetric';
+/**
+ * Configuration for {@link GenericSketcher.smoothSplineTo}.
+ *
+ * Can be a single tangent value (applied to the end), or an object with
+ * separate start/end tangents and distance factors.
+ */
+export type SplineOptions = SplineTangent | {
+    endTangent?: SplineTangent;
+    startTangent?: StartSplineTangent;
+    startFactor?: number;
+    endFactor?: number;
+};
+/** Resolve a {@link SplineOptions} into fully-expanded tangent directions and factors. */
+export declare const defaultsSplineOptions: (config?: SplineOptions) => {
+    endTangent: Point2D | "symmetric";
+    startTangent?: Point2D | undefined;
+    startFactor: number;
+    endFactor: number;
+};
+/**
+ * Sketchers allow the user to draw a two dimensional shape using segments of
+ * curve. You start by defining where your sketch will start (with the method
+ * `movePointerTo`).
+ * Each sketching method corresponds to drawing a curve of some type (line,
+ * arc, elliptic arc, bezier curve) to a new point. The next segment will start
+ * from the end point of the previous segment.
+ * Once you end your sketch you will receive a `Sketch` object that allows you
+ * to give some three dimensionality to your finished sketch.
+ *
+ * @category Sketching
+ */
+export interface GenericSketcher<ReturnType> {
+    /**
+     * Changes the point to start your drawing from
+     */
+    movePointerTo(point: Point2D): this;
+    /**
+     * Draws a line from the current point to the point given in argument
+     *
+     * @category Line Segment
+     */
+    lineTo(point: Point2D): this;
+    /**
+     * Draws a line at the horizontal distance xDist and the vertical distance
+     * yDist of the current point
+     *
+     * @category Line Segment
+     */
+    line(xDist: number, yDist: number): this;
+    /**
+     * Draws a vertical line of length distance from the current point
+     *
+     * @category Line Segment
+     */
+    vLine(distance: number): this;
+    /**
+     * Draws an horizontal line of length distance from the current point
+     *
+     * @category Line Segment
+     */
+    hLine(distance: number): this;
+    /**
+     * Draws a vertical line to the y coordinate
+     *
+     * @category Line Segment
+     */
+    vLineTo(yPos: number): this;
+    /**
+     * Draws an horizontal line to the x coordinate
+     *
+     * @category Line Segment
+     */
+    hLineTo(xPos: number): this;
+    /**
+     * Draws a line from the current point to the point defined in polar
+     * coordinates, of radius r and angle theta (in degrees) from the origin
+     *
+     * @category Line Segment
+     */
+    polarLineTo([r, theta]: [number, number]): this;
+    /**
+     * Draws a line from the current point to the point defined in polar
+     * coordinates, of radius r and angle theta (in degrees) from the current
+     * point
+     *
+     * @category Line Segment
+     */
+    polarLine(r: number, theta: number): this;
+    /**
+     * Draws a line from the current point as a tangent to the previous part of
+     * curve drawn. The distance defines how long the line will be.
+     *
+     * @category Line Segment
+     */
+    tangentLine(distance: number): this;
+    /** Draws an arc of circle by defining its end point and a third point
+     * through which the arc will pass.
+     *
+     * @category Arc Segment
+     */
+    threePointsArcTo(end: Point2D, innerPoint: Point2D): this;
+    /** Draws an arc of circle by defining its end point and a third point
+     * through which the arc will pass. Both points are defined in horizontal
+     * (x) and vertical (y) distances from the start point.
+     *
+     * @category Arc Segment
+     */
+    threePointsArc(xDist: number, yDist: number, viaXDist: number, viaYDist: number): this;
+    /** Draws an arc of circle by defining its end point and the sagitta - the
+     * maximum distance between the arc and the straight line going from start to
+     * end point.
+     *
+     * @category Arc Segment
+     */
+    sagittaArcTo(end: Point2D, sagitta: number): this;
+    /** Draws an arc of circle by defining its end point and the sagitta - the
+     * maximum distance between the arc and the straight line going from start to
+     * end point. The end point is defined by its horizontal and vertical
+     * distances from the start point.
+     *
+     * @category Arc Segment
+     */
+    sagittaArc(xDist: number, yDist: number, sagitta: number): this;
+    /** Draws a vertical arc of circle by defining its end point and the sagitta
+     * - the maximum distance between the arc and the straight line going from
+     * start to end point. The end point is defined by its vertical distance from
+     * the start point.
+     *
+     * @category Arc Segment
+     */
+    vSagittaArc(distance: number, sagitta: number): this;
+    /** Draws an horizontal arc of circle by defining its end point and the
+     * sagitta - the maximum distance between the arc and the straight line going
+     * from start to end point. The end point is defined by its horizontal
+     * distance from the start point.
+     *
+     * @category Arc Segment
+     */
+    hSagittaArc(distance: number, sagitta: number): this;
+    /** Draws an arc of circle by defining its end point and the bulge - the
+     * maximum distance between the arc and the straight line going from start to
+     * end point.
+     *
+     * @category Arc Segment
+     */
+    bulgeArcTo(end: Point2D, bulge: number): this;
+    /** Draws an arc of circle by defining its end point and the bulge - the
+     * maximum distance between the arc and the straight line going from start to
+     * end point in units of half the chord. The end point is defined by its horizontal and vertical distances
+     * from the start point.
+     *
+     * @category Arc Segment
+     */
+    bulgeArc(xDist: number, yDist: number, bulge: number): this;
+    /** Draws a vertical arc of circle by defining its end point and the bulge
+     * - the maximum distance between the arc and the straight line going from
+     * start to end point in units of half the chord. The end point is defined by its vertical distance from
+     * the start point.
+     *
+     * @category Arc Segment
+     */
+    vBulgeArc(distance: number, bulge: number): this;
+    /** Draws an horizontal arc of circle by defining its end point and the bulge
+     * - the maximum distance between the arc and the straight line going from
+     * start to end point in units of half the chord. The end point is defined by
+     * its horizontal distance from the start point.
+     *
+     * @category Arc Segment
+     */
+    hBulgeArc(distance: number, bulge: number): this;
+    /**
+     * Draws an arc of circle from the current point as a tangent to the previous
+     * part of curve drawn.
+     *
+     * @category Arc Segment
+     */
+    tangentArcTo(end: Point2D): this;
+    /**
+     * Draws an arc of circle from the current point as a tangent to the previous
+     * part of curve drawn. The end point is defined by its horizontal and vertical
+     * distances from the start point.
+     *
+     * @category Arc Segment
+     */
+    tangentArc(xDist: number, yDist: number): this;
+    /**
+     * Draws an arc of ellipse by defining its end point and an ellipse.
+     *
+     * The shape of the ellipse is defined by both its radiuses, its angle
+     * relative to the current coordinate system, as well as the long and sweep
+     * flags (as defined for SVG paths)
+     *
+     * @category Ellipse Arc Segment
+     */
+    ellipseTo(end: Point2D, horizontalRadius: number, verticalRadius: number, rotation: number, longAxis: boolean, sweep: boolean): this;
+    /**
+     * Draws an arc of ellipse by defining its end point and an ellipse. The end
+     * point is defined by distances from the start point.
+     *
+     * The shape of the ellipse is defined by both its radiuses, its angle
+     * relative to the current coordinate system, as well as the long and sweep
+     * flags (as defined for SVG paths)
+     *
+     * @category Ellipse Arc Segment
+     */
+    ellipse(xDist: number, yDist: number, horizontalRadius: number, verticalRadius: number, rotation: number, longAxis: boolean, sweep: boolean): this;
+    /**
+     * Draws an arc as half an ellipse, defined by the sagitta of the ellipse
+     * (which corresponds to the radius in the axe orthogonal to the straight
+     * line).
+     *
+     * The sweep flag is to be understood as defined for SVG paths.
+     *
+     * @category Ellipse Arc Segment
+     */
+    halfEllipseTo(end: Point2D, radius: number, sweep: boolean): this;
+    /**
+     * Draws an arc as half an ellipse, defined by the sagitta of the ellipse
+     * (which corresponds to the radius in the axe orthogonal to the straight
+     * line). The end point is defined by distances from the start point.
+     *
+     * The sweep flag is to be understood as defined for SVG paths.
+     *
+     * @category Ellipse Arc Segment
+     */
+    halfEllipse(xDist: number, yDist: number, radius: number, sweep: boolean): this;
+    /** Draws a generic bezier curve to the end point, going using a set of
+     * control points.
+     *
+     * This is the generic definition of a bezier curve, you might want to use
+     * either the quadratic or cubic (most common) version, unless you know
+     * exactly what you are aiming at.
+     *
+     * @category Bezier Curve
+     */
+    bezierCurveTo(end: Point2D, controlPoints: Point2D | Point2D[]): this;
+    /** Draws a quadratic bezier curve to the end point, using the single control
+     * point.
+     *
+     * @category Bezier Curve
+     */
+    quadraticBezierCurveTo(end: Point2D, controlPoint: Point2D): this;
+    /** Draws a cubic bezier curve to the end point, using the start and end
+     * control point to define its shape. This corresponds to the most commonly
+     * used bezier curve.
+     *
+     * If you are struggling setting your control points, the smoothSpline might
+     * be better for your needs.
+     *
+     * @category Bezier Curve
+     */
+    cubicBezierCurveTo(end: Point2D, startControlPoint: Point2D, endControlPoint: Point2D): this;
+    /** Draws a cubic bezier curve to the end point, attempting to make the line
+     * smooth with the previous segment.
+     *
+     * It will base its first control point so that its tangent is the same as
+     * the previous segment.
+     *
+     * The control point relative to the end is by default set to be in the
+     * direction of the straight line between start and end. You can specify the
+     * `endSkew` either as an angle (in degrees) to this direction, or as an
+     * absolute direction in the coordinate system (a Point).
+     *
+     * The start- and end- factors decide on how far the control point is from
+     * the start and end point. At a factor of 1, the distance corresponds to
+     * a quarter of the straight line distance.
+     *
+     * @category Bezier Curve
+     */
+    smoothSplineTo(end: Point2D, config?: SplineOptions): this;
+    /** Draws a cubic bezier curve to the end point, attempting to make the line
+     * smooth with the previous segment. The end point is defined by its distance
+     * to the first point.
+     *
+     * It will base its first control point so that its tangent is the same as
+     * the previous segment. You can force another tangent by defining
+     * `startTangent`.
+     *
+     * You can configure the tangent of the end point by configuring the
+     * `endTangent`, either as "symmetric" to reproduce the start angle, as an
+     * angle from the X axis (in the coordinate system) or a 2d direction (still
+     * in the coordinate system).
+     *
+     * The start- and end- factors decide on how far the control point is from
+     * the start and end point. At a factor of 1, the distance corresponds to
+     * a quarter of the straight line distance.
+     *
+     * @category Bezier Curve
+     */
+    smoothSpline(xDist: number, yDist: number, splineConfig: SplineOptions): this;
+    /**
+     * Changes the corner between the previous and next segments by applying
+     * a fillet, chamfer, or custom corner function.
+     *
+     * @param radius - Fillet/chamfer radius, or a custom corner function.
+     * @param mode - Corner treatment type: `'fillet'` (default) or `'chamfer'`.
+     *
+     * @category Corner Treatment
+     */
+    customCorner(radius: number | ((first: Curve2D, second: Curve2D) => Curve2D[]), mode?: 'fillet' | 'chamfer'): this;
+    /**
+     * Returns the current pen position as [x, y] coordinates.
+     *
+     * @category Drawing State
+     */
+    readonly penPosition: Point2D;
+    /**
+     * Returns the current pen angle in degrees, based on the tangent direction
+     * at the end of the last drawn segment. Returns 0 if nothing has been drawn.
+     *
+     * @category Drawing State
+     */
+    readonly penAngle: number;
+    /**
+     * Stop drawing and returns the sketch.
+     */
+    done(): ReturnType;
+    /**
+     * Stop drawing, make sure the sketch is closed (by adding a straight line to
+     * from the last point to the first) and returns the sketch.
+     */
+    close(): ReturnType;
+    /**
+     * Stop drawing, make sure the sketch is closed (by mirroring the lines
+     * between the first and last points drawn) and returns the sketch.
+     */
+    closeWithMirror(): ReturnType;
+    /**
+     * Close the path and apply a custom corner treatment (fillet, chamfer, or dogbone)
+     * between the last and first segments.
+     *
+     * @param radius - Fillet/chamfer radius, or a custom corner function.
+     * @param mode - Corner treatment type: `'fillet'` (default), `'chamfer'`, or `'dogbone'`.
+     */
+    closeWithCustomCorner(radius: number | ((f: Curve2D, s: Curve2D) => Curve2D[]), mode?: 'fillet' | 'chamfer' | 'dogbone'): ReturnType;
+}
+export {};
+//# sourceMappingURL=genericSketcher.d.ts.map

package/dist/vendored/brepjs/2d/blueprints/genericSketcher.d.ts.map

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

package/dist/vendored/brepjs/2d/blueprints/genericSketcher.js

@@ -0,0 +1,32 @@
+import { DEG2RAD } from '../../core/constants.js';
+import { polarToCartesian } from '../../2d/lib/index.js';
+const isTangent = (c) => c === 'symmetric' || typeof c === 'number' || (Array.isArray(c) && c.length === 2);
+/** Resolve a {@link SplineOptions} into fully-expanded tangent directions and factors. */
+export const defaultsSplineOptions = (config) => {
+    let conf;
+    if (!config)
+        conf = { endTangent: [1, 0] };
+    else if (isTangent(config)) {
+        conf = { endTangent: config };
+    }
+    else {
+        conf = { endTangent: 0, ...config };
+    }
+    const { endTangent: endTgt, startFactor = 1, endFactor = 1, startTangent: startTgt } = conf;
+    let endTangent;
+    if (typeof endTgt === 'number') {
+        endTangent = polarToCartesian(1, endTgt * DEG2RAD);
+    }
+    else {
+        endTangent = endTgt;
+    }
+    let startTangent;
+    if (typeof startTgt === 'number') {
+        startTangent = polarToCartesian(1, startTgt * DEG2RAD);
+    }
+    else {
+        startTangent = startTgt;
+    }
+    return { endTangent, startFactor, endFactor, startTangent };
+};
+//# sourceMappingURL=genericSketcher.js.map

package/dist/vendored/brepjs/2d/blueprints/genericSketcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"genericSketcher.js","sourceRoot":"","sources":["../../../../../src/vendored/brepjs/2d/blueprints/genericSketcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAA8B,MAAM,uBAAuB,CAAC;AAqBrF,MAAM,SAAS,GAAG,CAAC,CAAU,EAAsB,EAAE,CACnD,CAAC,KAAK,WAAW,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC;AAErF,0FAA0F;AAC1F,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,MAAsB,EAMtB,EAAE;IACF,IAAI,IAKH,CAAC;IACF,IAAI,CAAC,MAAM;QAAE,IAAI,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;SACtC,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,IAAI,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IAChC,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC;IACtC,CAAC;IACD,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,GAAG,CAAC,EAAE,SAAS,GAAG,CAAC,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAE5F,IAAI,UAAiC,CAAC;IACtC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,UAAU,GAAG,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;IACrD,CAAC;SAAM,CAAC;QACN,UAAU,GAAG,MAAM,CAAC;IACtB,CAAC;IAED,IAAI,YAAiC,CAAC;IACtC,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,YAAY,GAAG,gBAAgB,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC;IACzD,CAAC;SAAM,CAAC;QACN,YAAY,GAAG,QAAQ,CAAC;IAC1B,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;AAC9D,CAAC,CAAC","sourcesContent":["import { DEG2RAD } from '../../core/constants.js';\nimport { polarToCartesian, type Point2D, type Curve2D } from '../../2d/lib/index.js';\n\ntype StartSplineTangent = number | Point2D;\n/** Tangent specification for smooth spline endpoints: an angle (degrees), a 2D direction, or `'symmetric'`. */\nexport type SplineTangent = StartSplineTangent | 'symmetric';\n\n/**\n * Configuration for {@link GenericSketcher.smoothSplineTo}.\n *\n * Can be a single tangent value (applied to the end), or an object with\n * separate start/end tangents and distance factors.\n */\nexport type SplineOptions =\n  | SplineTangent\n  | {\n      endTangent?: SplineTangent;\n      startTangent?: StartSplineTangent;\n      startFactor?: number;\n      endFactor?: number;\n    };\n\nconst isTangent = (c: unknown): c is SplineTangent =>\n  c === 'symmetric' || typeof c === 'number' || (Array.isArray(c) && c.length === 2);\n\n/** Resolve a {@link SplineOptions} into fully-expanded tangent directions and factors. */\nexport const defaultsSplineOptions = (\n  config?: SplineOptions\n): {\n  endTangent: Point2D | 'symmetric';\n  startTangent?: Point2D | undefined;\n  startFactor: number;\n  endFactor: number;\n} => {\n  let conf: {\n    endTangent: SplineTangent;\n    startFactor?: number;\n    endFactor?: number;\n    startTangent?: StartSplineTangent;\n  };\n  if (!config) conf = { endTangent: [1, 0] };\n  else if (isTangent(config)) {\n    conf = { endTangent: config };\n  } else {\n    conf = { endTangent: 0, ...config };\n  }\n  const { endTangent: endTgt, startFactor = 1, endFactor = 1, startTangent: startTgt } = conf;\n\n  let endTangent: Point2D | 'symmetric';\n  if (typeof endTgt === 'number') {\n    endTangent = polarToCartesian(1, endTgt * DEG2RAD);\n  } else {\n    endTangent = endTgt;\n  }\n\n  let startTangent: Point2D | undefined;\n  if (typeof startTgt === 'number') {\n    startTangent = polarToCartesian(1, startTgt * DEG2RAD);\n  } else {\n    startTangent = startTgt;\n  }\n\n  return { endTangent, startFactor, endFactor, startTangent };\n};\n\n/**\n * Sketchers allow the user to draw a two dimensional shape using segments of\n * curve. You start by defining where your sketch will start (with the method\n * `movePointerTo`).\n * Each sketching method corresponds to drawing a curve of some type (line,\n * arc, elliptic arc, bezier curve) to a new point. The next segment will start\n * from the end point of the previous segment.\n * Once you end your sketch you will receive a `Sketch` object that allows you\n * to give some three dimensionality to your finished sketch.\n *\n * @category Sketching\n */\nexport interface GenericSketcher<ReturnType> {\n  /**\n   * Changes the point to start your drawing from\n   */\n  movePointerTo(point: Point2D): this;\n\n  /**\n   * Draws a line from the current point to the point given in argument\n   *\n   * @category Line Segment\n   */\n  lineTo(point: Point2D): this;\n  /**\n   * Draws a line at the horizontal distance xDist and the vertical distance\n   * yDist of the current point\n   *\n   * @category Line Segment\n   */\n  line(xDist: number, yDist: number): this;\n  /**\n   * Draws a vertical line of length distance from the current point\n   *\n   * @category Line Segment\n   */\n  vLine(distance: number): this;\n  /**\n   * Draws an horizontal line of length distance from the current point\n   *\n   * @category Line Segment\n   */\n  hLine(distance: number): this;\n  /**\n   * Draws a vertical line to the y coordinate\n   *\n   * @category Line Segment\n   */\n  vLineTo(yPos: number): this;\n  /**\n   * Draws an horizontal line to the x coordinate\n   *\n   * @category Line Segment\n   */\n  hLineTo(xPos: number): this;\n  /**\n   * Draws a line from the current point to the point defined in polar\n   * coordinates, of radius r and angle theta (in degrees) from the origin\n   *\n   * @category Line Segment\n   */\n  polarLineTo([r, theta]: [number, number]): this;\n  /**\n   * Draws a line from the current point to the point defined in polar\n   * coordinates, of radius r and angle theta (in degrees) from the current\n   * point\n   *\n   * @category Line Segment\n   */\n  polarLine(r: number, theta: number): this;\n  /**\n   * Draws a line from the current point as a tangent to the previous part of\n   * curve drawn. The distance defines how long the line will be.\n   *\n   * @category Line Segment\n   */\n  tangentLine(distance: number): this;\n\n  /** Draws an arc of circle by defining its end point and a third point\n   * through which the arc will pass.\n   *\n   * @category Arc Segment\n   */\n  threePointsArcTo(end: Point2D, innerPoint: Point2D): this;\n  /** Draws an arc of circle by defining its end point and a third point\n   * through which the arc will pass. Both points are defined in horizontal\n   * (x) and vertical (y) distances from the start point.\n   *\n   * @category Arc Segment\n   */\n  threePointsArc(xDist: number, yDist: number, viaXDist: number, viaYDist: number): this;\n  /** Draws an arc of circle by defining its end point and the sagitta - the\n   * maximum distance between the arc and the straight line going from start to\n   * end point.\n   *\n   * @category Arc Segment\n   */\n  sagittaArcTo(end: Point2D, sagitta: number): this;\n  /** Draws an arc of circle by defining its end point and the sagitta - the\n   * maximum distance between the arc and the straight line going from start to\n   * end point. The end point is defined by its horizontal and vertical\n   * distances from the start point.\n   *\n   * @category Arc Segment\n   */\n  sagittaArc(xDist: number, yDist: number, sagitta: number): this;\n  /** Draws a vertical arc of circle by defining its end point and the sagitta\n   * - the maximum distance between the arc and the straight line going from\n   * start to end point. The end point is defined by its vertical distance from\n   * the start point.\n   *\n   * @category Arc Segment\n   */\n  vSagittaArc(distance: number, sagitta: number): this;\n  /** Draws an horizontal arc of circle by defining its end point and the\n   * sagitta - the maximum distance between the arc and the straight line going\n   * from start to end point. The end point is defined by its horizontal\n   * distance from the start point.\n   *\n   * @category Arc Segment\n   */\n  hSagittaArc(distance: number, sagitta: number): this;\n  /** Draws an arc of circle by defining its end point and the bulge - the\n   * maximum distance between the arc and the straight line going from start to\n   * end point.\n   *\n   * @category Arc Segment\n   */\n  bulgeArcTo(end: Point2D, bulge: number): this;\n  /** Draws an arc of circle by defining its end point and the bulge - the\n   * maximum distance between the arc and the straight line going from start to\n   * end point in units of half the chord. The end point is defined by its horizontal and vertical distances\n   * from the start point.\n   *\n   * @category Arc Segment\n   */\n  bulgeArc(xDist: number, yDist: number, bulge: number): this;\n  /** Draws a vertical arc of circle by defining its end point and the bulge\n   * - the maximum distance between the arc and the straight line going from\n   * start to end point in units of half the chord. The end point is defined by its vertical distance from\n   * the start point.\n   *\n   * @category Arc Segment\n   */\n  vBulgeArc(distance: number, bulge: number): this;\n  /** Draws an horizontal arc of circle by defining its end point and the bulge\n   * - the maximum distance between the arc and the straight line going from\n   * start to end point in units of half the chord. The end point is defined by\n   * its horizontal distance from the start point.\n   *\n   * @category Arc Segment\n   */\n  hBulgeArc(distance: number, bulge: number): this;\n\n  /**\n   * Draws an arc of circle from the current point as a tangent to the previous\n   * part of curve drawn.\n   *\n   * @category Arc Segment\n   */\n  tangentArcTo(end: Point2D): this;\n  /**\n   * Draws an arc of circle from the current point as a tangent to the previous\n   * part of curve drawn. The end point is defined by its horizontal and vertical\n   * distances from the start point.\n   *\n   * @category Arc Segment\n   */\n  tangentArc(xDist: number, yDist: number): this;\n\n  /**\n   * Draws an arc of ellipse by defining its end point and an ellipse.\n   *\n   * The shape of the ellipse is defined by both its radiuses, its angle\n   * relative to the current coordinate system, as well as the long and sweep\n   * flags (as defined for SVG paths)\n   *\n   * @category Ellipse Arc Segment\n   */\n  ellipseTo(\n    end: Point2D,\n    horizontalRadius: number,\n    verticalRadius: number,\n    rotation: number,\n    longAxis: boolean,\n    sweep: boolean\n  ): this;\n  /**\n   * Draws an arc of ellipse by defining its end point and an ellipse. The end\n   * point is defined by distances from the start point.\n   *\n   * The shape of the ellipse is defined by both its radiuses, its angle\n   * relative to the current coordinate system, as well as the long and sweep\n   * flags (as defined for SVG paths)\n   *\n   * @category Ellipse Arc Segment\n   */\n  ellipse(\n    xDist: number,\n    yDist: number,\n    horizontalRadius: number,\n    verticalRadius: number,\n    rotation: number,\n    longAxis: boolean,\n    sweep: boolean\n  ): this;\n  /**\n   * Draws an arc as half an ellipse, defined by the sagitta of the ellipse\n   * (which corresponds to the radius in the axe orthogonal to the straight\n   * line).\n   *\n   * The sweep flag is to be understood as defined for SVG paths.\n   *\n   * @category Ellipse Arc Segment\n   */\n  halfEllipseTo(end: Point2D, radius: number, sweep: boolean): this;\n\n  /**\n   * Draws an arc as half an ellipse, defined by the sagitta of the ellipse\n   * (which corresponds to the radius in the axe orthogonal to the straight\n   * line). The end point is defined by distances from the start point.\n   *\n   * The sweep flag is to be understood as defined for SVG paths.\n   *\n   * @category Ellipse Arc Segment\n   */\n  halfEllipse(xDist: number, yDist: number, radius: number, sweep: boolean): this;\n\n  /** Draws a generic bezier curve to the end point, going using a set of\n   * control points.\n   *\n   * This is the generic definition of a bezier curve, you might want to use\n   * either the quadratic or cubic (most common) version, unless you know\n   * exactly what you are aiming at.\n   *\n   * @category Bezier Curve\n   */\n  bezierCurveTo(end: Point2D, controlPoints: Point2D | Point2D[]): this;\n  /** Draws a quadratic bezier curve to the end point, using the single control\n   * point.\n   *\n   * @category Bezier Curve\n   */\n  quadraticBezierCurveTo(end: Point2D, controlPoint: Point2D): this;\n  /** Draws a cubic bezier curve to the end point, using the start and end\n   * control point to define its shape. This corresponds to the most commonly\n   * used bezier curve.\n   *\n   * If you are struggling setting your control points, the smoothSpline might\n   * be better for your needs.\n   *\n   * @category Bezier Curve\n   */\n  cubicBezierCurveTo(end: Point2D, startControlPoint: Point2D, endControlPoint: Point2D): this;\n  /** Draws a cubic bezier curve to the end point, attempting to make the line\n   * smooth with the previous segment.\n   *\n   * It will base its first control point so that its tangent is the same as\n   * the previous segment.\n   *\n   * The control point relative to the end is by default set to be in the\n   * direction of the straight line between start and end. You can specify the\n   * `endSkew` either as an angle (in degrees) to this direction, or as an\n   * absolute direction in the coordinate system (a Point).\n   *\n   * The start- and end- factors decide on how far the control point is from\n   * the start and end point. At a factor of 1, the distance corresponds to\n   * a quarter of the straight line distance.\n   *\n   * @category Bezier Curve\n   */\n  smoothSplineTo(end: Point2D, config?: SplineOptions): this;\n  /** Draws a cubic bezier curve to the end point, attempting to make the line\n   * smooth with the previous segment. The end point is defined by its distance\n   * to the first point.\n   *\n   * It will base its first control point so that its tangent is the same as\n   * the previous segment. You can force another tangent by defining\n   * `startTangent`.\n   *\n   * You can configure the tangent of the end point by configuring the\n   * `endTangent`, either as \"symmetric\" to reproduce the start angle, as an\n   * angle from the X axis (in the coordinate system) or a 2d direction (still\n   * in the coordinate system).\n   *\n   * The start- and end- factors decide on how far the control point is from\n   * the start and end point. At a factor of 1, the distance corresponds to\n   * a quarter of the straight line distance.\n   *\n   * @category Bezier Curve\n   */\n  smoothSpline(xDist: number, yDist: number, splineConfig: SplineOptions): this;\n\n  /**\n   * Changes the corner between the previous and next segments by applying\n   * a fillet, chamfer, or custom corner function.\n   *\n   * @param radius - Fillet/chamfer radius, or a custom corner function.\n   * @param mode - Corner treatment type: `'fillet'` (default) or `'chamfer'`.\n   *\n   * @category Corner Treatment\n   */\n  customCorner(\n    radius: number | ((first: Curve2D, second: Curve2D) => Curve2D[]),\n    mode?: 'fillet' | 'chamfer'\n  ): this;\n\n  /**\n   * Returns the current pen position as [x, y] coordinates.\n   *\n   * @category Drawing State\n   */\n  readonly penPosition: Point2D;\n\n  /**\n   * Returns the current pen angle in degrees, based on the tangent direction\n   * at the end of the last drawn segment. Returns 0 if nothing has been drawn.\n   *\n   * @category Drawing State\n   */\n  readonly penAngle: number;\n\n  /**\n   * Stop drawing and returns the sketch.\n   */\n  done(): ReturnType;\n  /**\n   * Stop drawing, make sure the sketch is closed (by adding a straight line to\n   * from the last point to the first) and returns the sketch.\n   */\n  close(): ReturnType;\n  /**\n   * Stop drawing, make sure the sketch is closed (by mirroring the lines\n   * between the first and last points drawn) and returns the sketch.\n   */\n  closeWithMirror(): ReturnType;\n\n  /**\n   * Close the path and apply a custom corner treatment (fillet, chamfer, or dogbone)\n   * between the last and first segments.\n   *\n   * @param radius - Fillet/chamfer radius, or a custom corner function.\n   * @param mode - Corner treatment type: `'fillet'` (default), `'chamfer'`, or `'dogbone'`.\n   */\n  closeWithCustomCorner(\n    radius: number | ((f: Curve2D, s: Curve2D) => Curve2D[]),\n    mode?: 'fillet' | 'chamfer' | 'dogbone'\n  ): ReturnType;\n}\n"]}