@ccpc/math 0.1.0

package/dist/curves/circle2.d.ts

@@ -0,0 +1,42 @@
+import { EN_GEO_TYPE } from '../constants/geom_type';
+import { Box2 } from '../core/box2';
+import { Mat3 } from '../core/mat3';
+import { Vec2 } from '../core/vec2';
+import type { IDBCircle2 } from '../serialize/dump_types';
+import type { IClosestPointResult } from '../types/type_define';
+import { Arc2 } from './arc2';
+import { CircleCurve2 } from './circle_curve2';
+import { Interval } from './interval';
+export declare class Circle2 extends CircleCurve2 {
+    static readonly type = EN_GEO_TYPE.Circle2;
+    /**
+     * 构造整圆。
+     * @param center 圆心。
+     * @param radius 半径。
+     */
+    constructor(center: Vec2, radius: number);
+    length(range?: Interval): number;
+    lengthAtParam(u: number): number;
+    paramAtLength(s: number, tol?: number): number;
+    split(u: number): Arc2[];
+    trim(range: Interval): Arc2[];
+    reverse(): this;
+    transform(m: Mat3): this;
+    transformed(m: Mat3): this;
+    closestPoint(p: Vec2): IClosestPointResult;
+    boundingBox(): Box2;
+    isValid(eps?: number): boolean;
+    isClosed(): boolean;
+    isCircle(): this is Circle2;
+    /**
+     * 结构等价判断（字段级）。
+     * @param other 对比圆。
+     * @param eps 数值容差。
+     * @returns 圆心和半径近似相等时返回 `true`。
+     */
+    equals(other: Circle2, eps?: number): boolean;
+    clone(): this;
+    dump(): IDBCircle2;
+    static load(data: IDBCircle2): Circle2;
+}
+//# sourceMappingURL=circle2.d.ts.map

package/dist/curves/circle2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circle2.d.ts","sourceRoot":"","sources":["../../src/curves/circle2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAEpD,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AACnC,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AACnC,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AACnC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAEzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAG/D,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAGrC,qBAKa,OAAQ,SAAQ,YAAY;IACrC,gBAAuB,IAAI,uBAAsB;IAEjD;;;;OAIG;gBACS,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM;IAKxB,MAAM,CAAC,KAAK,CAAC,EAAE,QAAQ;IAMvB,aAAa,CAAC,CAAC,EAAE,MAAM;IAMvB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,SAA6B;IASzD,KAAK,CAAC,CAAC,EAAE,MAAM;IAYf,IAAI,CAAC,KAAK,EAAE,QAAQ;IAMpB,OAAO;IAKP,SAAS,CAAC,CAAC,EAAE,IAAI;IAajB,WAAW,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI;IAI1B,YAAY,CAAC,CAAC,EAAE,IAAI,GAAG,mBAAmB;IAgB1C,WAAW;IASX,OAAO,CAAC,GAAG,SAA6B;IAIxC,QAAQ,IAAI,OAAO;IAInB,QAAQ,IAAI,IAAI,IAAI,OAAO;IAI3C;;;;;OAKG;IACI,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,SAAgB;IAIjC,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,UAAU;WAQpB,IAAI,CAAC,IAAI,EAAE,UAAU;CAGtC"}

package/dist/curves/circle2.js

@@ -0,0 +1,135 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var Circle2_1;
+import { EN_GEO_TYPE } from '../constants/geom_type';
+import { MathConst } from '../constants/math_const';
+import { Box2 } from '../core/box2';
+import { Vec2 } from '../core/vec2';
+import { RegisterGeom } from '../serialize/geom_mgr';
+import { MathError } from '../utils/math_error';
+import { Precision } from '../utils/precision';
+import { Arc2 } from './arc2';
+import { CircleCurve2 } from './circle_curve2';
+import { PeriodInterval } from './period_interval';
+let Circle2 = Circle2_1 = class Circle2 extends CircleCurve2 {
+    /**
+     * 构造整圆。
+     * @param center 圆心。
+     * @param radius 半径。
+     */
+    constructor(center, radius) {
+        super(center, radius);
+        this.setRange(new PeriodInterval(0, MathConst.PI2, MathConst.PI2));
+    }
+    length(range) {
+        if (!range)
+            return MathConst.PI2 * this._radius;
+        this._range.assertContainsRange(range, Precision.CURVE_PARAM_EPS);
+        return range.length() * this._radius;
+    }
+    lengthAtParam(u) {
+        const uu = this.normalizeParamForEval(u);
+        const start = this._range.start;
+        return (uu - start) * this._radius;
+    }
+    paramAtLength(s, tol = Precision.CURVE_LENGTH_EPS) {
+        const total = this.length();
+        MathError.assert(Number.isFinite(tol) && tol > 0, 'Circle2.paramAtLength: tol must be > 0');
+        MathError.assert(s >= -tol && s <= total + tol, `Circle2.paramAtLength: s out of range [0, ${total}]`);
+        const clamped = Math.min(total, Math.max(0, s));
+        return this._range.start + clamped / this._radius;
+    }
+    split(u) {
+        const range = this._range;
+        const uu = range.normalizeInPeriod(u, range.start);
+        if (Math.abs(uu - range.start) <= Precision.CURVE_PARAM_EPS || Math.abs(uu - range.end) <= Precision.CURVE_PARAM_EPS) {
+            return [];
+        }
+        const first = new Arc2(this._center, this._radius, range.start, uu, false);
+        const second = new Arc2(this._center, this._radius, uu, range.start + range.period, false);
+        return [first, second].filter((arc) => arc.length() > Precision.CURVE_LENGTH_EPS);
+    }
+    trim(range) {
+        this._range.assertContainsRange(range, Precision.CURVE_PARAM_EPS);
+        if (range.length() <= Precision.CURVE_PARAM_EPS)
+            return [];
+        return [new Arc2(this._center, this._radius, range.start, range.end, false)];
+    }
+    reverse() {
+        // 整圆反转后几何与参数域等价，保持不变即可。
+        return this;
+    }
+    transform(m) {
+        MathError.assert(m.isSimilarity2D(Precision.CURVE_PARAM_EPS), 'Circle2.transform: matrix must be a 2D similarity transform');
+        const nextCenter = m.transformedPoint(this._center);
+        const scale = m.getSimilarityScale2D(Precision.CURVE_PARAM_EPS);
+        const nextRadius = this._radius * scale;
+        MathError.assert(nextRadius > Precision.CURVE_LENGTH_EPS, 'Circle2.transform: degenerate radius after transform');
+        this._center = nextCenter;
+        this._radius = nextRadius;
+        return this;
+    }
+    transformed(m) {
+        return this.clone().transform(m);
+    }
+    closestPoint(p) {
+        const v = p.subtracted(this._center);
+        let u = this._range.start;
+        if (v.len() > Precision.CURVE_NEWTON_EPS) {
+            u = this._range.normalizeInPeriod(Math.atan2(v.y, v.x), this._range.start);
+        }
+        const point = this.pointAt(u);
+        return {
+            point,
+            param: u,
+            distance: point.distanceTo(p),
+        };
+    }
+    boundingBox() {
+        return new Box2(this._center.x - this._radius, this._center.y - this._radius, this._center.x + this._radius, this._center.y + this._radius);
+    }
+    isValid(eps = Precision.CURVE_LENGTH_EPS) {
+        return this.isCircleStructValid(eps);
+    }
+    isClosed() {
+        return true;
+    }
+    isCircle() {
+        return true;
+    }
+    /**
+     * 结构等价判断（字段级）。
+     * @param other 对比圆。
+     * @param eps 数值容差。
+     * @returns 圆心和半径近似相等时返回 `true`。
+     */
+    equals(other, eps = Precision.EPS) {
+        return this._center.equals(other._center, eps) && Precision.equal(this._radius, other._radius, eps);
+    }
+    clone() {
+        return new Circle2_1(this._center, this._radius);
+    }
+    dump() {
+        return {
+            type: Circle2_1.type,
+            center: { x: this._center.x, y: this._center.y },
+            radius: this._radius,
+        };
+    }
+    static load(data) {
+        return new Circle2_1(new Vec2(data.center.x, data.center.y), data.radius);
+    }
+};
+Circle2.type = EN_GEO_TYPE.Circle2;
+Circle2 = Circle2_1 = __decorate([
+    RegisterGeom
+    /**
+     * 二维整圆曲线。
+     * 参数域固定为 `PeriodInterval(0, 2π, 2π)`。
+     */
+], Circle2);
+export { Circle2 };

package/dist/curves/circle_curve2.d.ts

@@ -0,0 +1,38 @@
+import { Vec2 } from '../core/vec2';
+import { Curve2 } from './curve2';
+/**
+ * 圆族曲线基类（整圆与圆弧）。
+ * 参数含义为角度参数。
+ */
+export declare abstract class CircleCurve2 extends Curve2 {
+    protected _center: Vec2;
+    protected _radius: number;
+    constructor(center: Vec2, radius: number);
+    /** 圆心（返回副本） */
+    get center(): Vec2;
+    /** 半径 */
+    get radius(): number;
+    pointAt(u: number): Vec2;
+    tangentAt(u: number): Vec2;
+    derivatives(u: number, n: number): Vec2[];
+    curvatureAt(u: number): number;
+    /** 圆族结构有效性检查 */
+    protected isCircleStructValid(eps?: number): boolean;
+    /** 由角度参数计算圆上点 */
+    protected pointAtAngle(theta: number): Vec2;
+    /**
+     * 按角参数计算导数（不含 0 阶点坐标）。
+     * @param theta 角参数。
+     * @param order 导数阶次（>=1）。
+     * @param sign d(theta)/d(u) 的符号，逆向参数化取 -1。
+     */
+    protected derivativeAtAngle(theta: number, order: number, sign: 1 | -1): Vec2;
+    /** 计算点相对圆心的极角 */
+    protected angleOfPoint(p: Vec2): number;
+    /**
+     * 参数校验并归一化，保证端点求值稳定。
+     * 对周期区间会归一化到当前区间窗口内。
+     */
+    protected normalizeParamForEval(u: number): number;
+}
+//# sourceMappingURL=circle_curve2.d.ts.map

package/dist/curves/circle_curve2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circle_curve2.d.ts","sourceRoot":"","sources":["../../src/curves/circle_curve2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAGnC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAGjC;;;GAGG;AACH,8BAAsB,YAAa,SAAQ,MAAM;IAC7C,SAAS,CAAC,OAAO,EAAE,IAAI,CAAA;IACvB,SAAS,CAAC,OAAO,EAAE,MAAM,CAAA;gBAEb,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM;IAQxC,eAAe;IACf,IAAW,MAAM,SAEhB;IAED,SAAS;IACT,IAAW,MAAM,WAEhB;IAEe,OAAO,CAAC,CAAC,EAAE,MAAM;IAKjB,SAAS,CAAC,CAAC,EAAE,MAAM;IAKnB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;IAWhC,WAAW,CAAC,CAAC,EAAE,MAAM;IAKrC,gBAAgB;IAChB,SAAS,CAAC,mBAAmB,CAAC,GAAG,SAA6B;IAO9D,iBAAiB;IACjB,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM;IAOpC;;;;;OAKG;IACH,SAAS,CAAC,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC;IA4BtE,iBAAiB;IACjB,SAAS,CAAC,YAAY,CAAC,CAAC,EAAE,IAAI;IAI9B;;;OAGG;IACH,SAAS,CAAC,qBAAqB,CAAC,CAAC,EAAE,MAAM;CAa5C"}

package/dist/curves/circle_curve2.js

@@ -0,0 +1,112 @@
+import { Vec2 } from '../core/vec2';
+import { MathError } from '../utils/math_error';
+import { Precision } from '../utils/precision';
+import { Curve2 } from './curve2';
+import { PeriodInterval } from './period_interval';
+/**
+ * 圆族曲线基类（整圆与圆弧）。
+ * 参数含义为角度参数。
+ */
+export class CircleCurve2 extends Curve2 {
+    constructor(center, radius) {
+        super();
+        MathError.assert(Number.isFinite(center.x) && Number.isFinite(center.y), 'CircleCurve2: center must be finite');
+        MathError.assert(Number.isFinite(radius) && radius > 0, 'CircleCurve2: radius must be > 0');
+        this._center = center.clone();
+        this._radius = radius;
+    }
+    /** 圆心（返回副本） */
+    get center() {
+        return this._center.clone();
+    }
+    /** 半径 */
+    get radius() {
+        return this._radius;
+    }
+    pointAt(u) {
+        const uu = this.normalizeParamForEval(u);
+        return this.pointAtAngle(uu);
+    }
+    tangentAt(u) {
+        const uu = this.normalizeParamForEval(u);
+        return this.derivativeAtAngle(uu, 1, 1);
+    }
+    derivatives(u, n) {
+        MathError.assert(Number.isInteger(n) && n >= 0, 'CircleCurve2.derivatives: n must be a non-negative integer');
+        const uu = this.normalizeParamForEval(u);
+        const ret = [this.pointAtAngle(uu)];
+        for (let i = 1; i <= n; i++) {
+            ret.push(this.derivativeAtAngle(uu, i, 1));
+        }
+        return ret;
+    }
+    curvatureAt(u) {
+        this.normalizeParamForEval(u);
+        return 1 / this._radius;
+    }
+    /** 圆族结构有效性检查 */
+    isCircleStructValid(eps = Precision.CURVE_LENGTH_EPS) {
+        return Number.isFinite(this._center.x) &&
+            Number.isFinite(this._center.y) &&
+            Number.isFinite(this._radius) &&
+            this._radius > eps;
+    }
+    /** 由角度参数计算圆上点 */
+    pointAtAngle(theta) {
+        return new Vec2(this._center.x + this._radius * Math.cos(theta), this._center.y + this._radius * Math.sin(theta));
+    }
+    /**
+     * 按角参数计算导数（不含 0 阶点坐标）。
+     * @param theta 角参数。
+     * @param order 导数阶次（>=1）。
+     * @param sign d(theta)/d(u) 的符号，逆向参数化取 -1。
+     */
+    derivativeAtAngle(theta, order, sign) {
+        const phase = order % 4;
+        let x = 0;
+        let y = 0;
+        switch (phase) {
+            case 0:
+                x = Math.cos(theta);
+                y = Math.sin(theta);
+                break;
+            case 1:
+                x = -Math.sin(theta);
+                y = Math.cos(theta);
+                break;
+            case 2:
+                x = -Math.cos(theta);
+                y = -Math.sin(theta);
+                break;
+            default:
+                x = Math.sin(theta);
+                y = -Math.cos(theta);
+                break;
+        }
+        // d^k/d u^k = d^k/d theta^k * (d theta / d u)^k
+        // 当 sign = -1 时，奇数阶导翻转符号，偶数阶不变。
+        const signPow = sign === 1 ? 1 : (order % 2 === 0 ? 1 : -1);
+        return new Vec2(x, y).scale(this._radius * signPow);
+    }
+    /** 计算点相对圆心的极角 */
+    angleOfPoint(p) {
+        return Math.atan2(p.y - this._center.y, p.x - this._center.x);
+    }
+    /**
+     * 参数校验并归一化，保证端点求值稳定。
+     * 对周期区间会归一化到当前区间窗口内。
+     */
+    normalizeParamForEval(u) {
+        this._range.assertContains(u, Precision.CURVE_PARAM_EPS);
+        const start = this._range.start;
+        const end = this._range.end;
+        if (Math.abs(u - start) <= Precision.CURVE_PARAM_EPS)
+            return start;
+        if (Math.abs(u - end) <= Precision.CURVE_PARAM_EPS)
+            return end;
+        if (this._range instanceof PeriodInterval) {
+            return this._range.normalizeInPeriod(u, start);
+        }
+        return u;
+    }
+}

package/dist/curves/curve2.d.ts

@@ -0,0 +1,214 @@
+import { Box2 } from '../core/box2';
+import { GeomBase } from '../core/geom_base';
+import { Mat3 } from '../core/mat3';
+import { Vec2 } from '../core/vec2';
+import type { IClosestPointResult } from '../types/type_define';
+import { DiscretizeOptions } from '../discretize/discretize_options';
+import type { Arc2 } from './arc2';
+import type { BSpline2 } from './bspline2';
+import type { Circle2 } from './circle2';
+import type { Ellipse2 } from './ellipse2';
+import type { EllipseArc2 } from './ellipse_arc2';
+import { Interval } from './interval';
+import type { Line2 } from './line2';
+export declare abstract class Curve2 extends GeomBase {
+    /**
+     * 参数域
+     * - 默认使用无界区间，具体曲线应在子类中覆盖
+     * - 子类可直接赋值 this._range，或调用 setRange()
+     */
+    protected _range: Interval;
+    /**
+     * 获取参数域。
+     * @returns 参数域副本，调用方修改不会影响内部状态。
+     */
+    getRange(): Interval;
+    /**
+     * 判断参数是否落在当前曲线参数域内。
+     * @param u 待判断参数。
+     * @param eps 区间边界比较容差。
+     * @returns 落在参数域内返回 `true`。
+     */
+    containsParam(u: number, eps?: number): boolean;
+    /**
+     * 原生参数取点。
+     * @param u 曲线参数。
+     * @returns 参数对应的二维点。
+     */
+    abstract pointAt(u: number): Vec2;
+    /**
+     * 原生参数切向（一阶导）。
+     * @param u 曲线参数。
+     * @returns 参数处切向量。
+     */
+    abstract tangentAt(u: number): Vec2;
+    /**
+     * 计算导数序列 `[d0, d1, ...]`。
+     * @param u 曲线参数。
+     * @param n 最大导数阶数。
+     * @returns 从 0 阶到 n 阶的导数数组。
+     */
+    abstract derivatives(u: number, n: number): Vec2[];
+    /**
+     * 计算参数处曲率。
+     * @param u 曲线参数。
+     * @returns 曲率标量。
+     */
+    abstract curvatureAt(u: number): number;
+    /**
+     * 计算曲线长度。
+     * @param range 可选子参数域；不传表示整段曲线。
+     * @returns 指定参数范围内的弧长。
+     */
+    abstract length(range?: Interval): number;
+    /**
+     * 计算从参数域起点到 `u` 的弧长。
+     * @param u 目标参数。
+     * @returns 起点到 `u` 的累计弧长。
+     */
+    abstract lengthAtParam(u: number): number;
+    /**
+     * 给定弧长反求参数。
+     * @param s 目标弧长。
+     * @param tol 迭代容差（若实现采用迭代法）。
+     * @returns 对应参数值。
+     */
+    abstract paramAtLength(s: number, tol?: number): number;
+    /**
+     * 以参数切分曲线。
+     * @param u 切分参数。
+     * @returns 切分结果曲线数组。
+     */
+    abstract split(u: number): Curve2[];
+    /**
+     * 参数裁剪。
+     * @param range 目标保留参数区间。
+     * @returns 裁剪后的曲线数组。
+     */
+    abstract trim(range: Interval): Curve2[];
+    /**
+     * 反转曲线方向（就地）。
+     * @returns 当前实例。
+     */
+    abstract reverse(): this;
+    /**
+     * 应用仿射变换（就地）。
+     * @param m 3x3 变换矩阵。
+     * @returns 当前实例。
+     */
+    abstract transform(m: Mat3): this;
+    /**
+     * 应用仿射变换（返回新对象）。
+     * @param m 3x3 变换矩阵。
+     * @returns 变换后的新曲线对象。
+     */
+    abstract transformed(m: Mat3): this;
+    /**
+     * 最近点查询。
+     * @param p 查询点。
+     * @param tol 计算容差。
+     * @returns 最近点、对应参数和距离。
+     */
+    abstract closestPoint(p: Vec2, tol?: number): IClosestPointResult;
+    /**
+     * 计算包围盒。
+     * @param accurate 是否使用高精度计算。
+     * - `accurate !== true`：优先快速保守盒（用于高频场景）
+     * - `accurate === true`：尽量返回更紧的包围盒（允许更慢）
+     * @returns 曲线包围盒。
+     */
+    abstract boundingBox(accurate?: boolean): Box2;
+    /**
+     * 有效性检查。
+     * @param eps 数值判定容差。
+     * @returns 曲线定义有效返回 `true`。
+     */
+    abstract isValid(eps?: number): boolean;
+    /**
+     * 是否为退化曲线。
+     * 默认规则：参数域过小或曲线长度过小。
+     */
+    isDegenerate(): boolean;
+    /**
+     * 是否为闭合曲线。
+     * 默认返回 `false`，由闭合曲线子类覆盖。
+     */
+    isClosed(): boolean;
+    /** 是否为线段曲线。 */
+    isLine(): this is Line2;
+    /** 是否为整圆曲线。 */
+    isCircle(): this is Circle2;
+    /** 是否为圆弧曲线。 */
+    isArc(): this is Arc2;
+    /** 是否为整椭圆曲线。 */
+    isEllipse(): this is Ellipse2;
+    /** 是否为椭圆弧曲线。 */
+    isEllipseArc(): this is EllipseArc2;
+    /** 是否为 B 样条曲线。 */
+    isBSpline(): this is BSpline2;
+    /**
+     * 克隆曲线。
+     * @returns 当前曲线的深拷贝对象。
+     */
+    abstract clone(): this;
+    /**
+     * 获取第 `n` 阶导数（默认由 `derivatives` 派生）。
+     * @param u 曲线参数。
+     * @param n 导数阶数，要求为非负整数。
+     * @returns 第 `n` 阶导数向量。
+     */
+    derivativeAt(u: number, n: number): Vec2;
+    /**
+     * 最近参数（默认由 `closestPoint` 派生）。
+     * @param p 查询点。
+     * @param tol 计算容差。
+     * @returns 最近点对应参数。
+     */
+    closestParam(p: Vec2, tol?: number): number;
+    /**
+     * 点到曲线距离（默认由 `closestPoint` 派生）。
+     * @param p 查询点。
+     * @param tol 计算容差。
+     * @returns 点到曲线的最短距离。
+     */
+    distanceToPoint(p: Vec2, tol?: number): number;
+    /**
+     * 曲线离散化便捷入口（薄封装）。
+     * @param options 离散参数。
+     * @returns 折线采样结果。
+     */
+    discretize(options?: DiscretizeOptions): Vec2[];
+    /**
+     * 设置参数域（供子类构造期使用）。
+     * @param range 参数区间。
+     * @returns 当前实例。
+     */
+    protected setRange(range: Interval): this;
+    /**
+     * Newton + 二分混合求解参数（常用于弧长反参）。
+     * @param target 目标值（如目标弧长）。
+     * @param start 参数下界。
+     * @param end 参数上界。
+     * @param tol 收敛容差。
+     * @param evalValue 参数到目标量的映射函数（要求在 [start, end] 上单调）。
+     * @param evalSlope 参数处导数量（如速度），用于 Newton 步。
+     * @param failMessage 未收敛时抛错信息。
+     * @param initialGuess 可选初值；不传时取区间中点。
+     * @returns 收敛后的参数。
+     */
+    protected solveParamByHybridNewton(target: number, start: number, end: number, tol: number, evalValue: (u: number) => number, evalSlope: (u: number) => number, failMessage: string, initialGuess?: number): number;
+    /**
+     * “采样粗定位 + Newton 细化”最近点求解通用流程。
+     * @param p 查询点。
+     * @param tol 收敛容差。
+     * @param sampleCount 初始采样数（含两端点）。
+     * @param evalPoint 参数求点函数。
+     * @param evalD1 一阶导函数。
+     * @param evalD2 二阶导函数。
+     * @param failMessage 未收敛时抛错信息。
+     * @param compareParam 参数平局比较器（返回 <0 表示 a 更优）。
+     * @returns 最近点结果。
+     */
+    protected solveClosestPointBySampleNewton(p: Vec2, tol: number, sampleCount: number, evalPoint: (u: number) => Vec2, evalD1: (u: number) => Vec2, evalD2: (u: number) => Vec2, failMessage: string, compareParam?: (a: number, b: number) => number): IClosestPointResult;
+}
+//# sourceMappingURL=curve2.d.ts.map

package/dist/curves/curve2.d.ts.map

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