@faicad/faijs 0.29.3 → 0.30.9

package/dist/api/cadquery-selectors/borrow-bridge.js

@@ -6,12 +6,11 @@
  */
 import { fromHandle } from '../../sdk.js';
 import { isShape } from '../../shape.js';
-// ── compatOp 提升边界归一（GOTCHA：borrowDeep 把实参 Shape 换成借用视图）──
+// ── compatOp 提升边界归一（GOTCHA：compatOp 提升后实参形态可能变化）──
 //
 // 当 cq-compat 命名空间被 registerLib 提升（无 dual-op → autoLift=true）时，
-// 每个裸导出函数的实参先经 borrowDeep：faijs Shape → 借用 brepjs 视图
-// `{ wrapped, disposed, delete, onDispose }`（`isShape=false`、`brepOf=undefined`）。
-// 直接调用（测试进程内）拿到的则是真实 Shape。两个形态都必须能消费：
+// 每个裸导出函数的实参经 compatOp 适配器传入。直接调用（测试进程内）拿到的
+// 则是真实 Shape。两个形态都必须能消费：
 //
 //   asBrepShape(v) —
 //   - 真实 Shape → 原样返回；

package/dist/api/cadquery-selectors/borrow-bridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"borrow-bridge.js","sourceRoot":"","sources":["../../../src/api/cadquery-selectors/borrow-bridge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAGrC,2DAA2D;AAC3D,EAAE;AACF,gEAAgE;AAChE,qDAAqD;AACrD,kFAAkF;AAClF,uCAAuC;AACvC,EAAE;AACF,qBAAqB;AACrB,uBAAuB;AACvB,wDAAwD;AACxD,sDAAsD;AACtD,uBAAuB;AACvB,6BAA6B;AAC7B,EAAE;AACF,2DAA2D;AAC3D,uDAAuD;AACvD,oCAAoC;AACpC,mEAAmE;AACnE,oCAAoC;AACpC,MAAM,kBAAkB,GAAG,IAAI,OAAO,EAAiB,CAAA;AAEvD;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,CAAU;IACpC,IAAI,OAAO,CAAC,CAAC,CAAC;QAAE,OAAO,CAAU,CAAA;IACjC,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,GAAG,CAAyB,CAAA;QACtC,MAAM,GAAG,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACxC,IAAI,GAAG;YAAE,OAAO,GAAG,CAAA;QACnB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAA;QAC/B,MAAM,MAAM,GACV,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,IAAI,IAAI,IAAI,IAAI,UAAU;YACzE,CAAC,CAAE,UAA6B,CAAC,EAAE;YACnC,CAAC,CAAC,UAAU,CAAA;QAChB,MAAM,CAAC,GAAG,UAAU,CAAC,MAAM,CAAU,CAAA;QACrC,kBAAkB,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QAC/B,OAAO,CAAC,CAAA;IACV,CAAC;IACD,OAAO,CAAU,CAAA;AACnB,CAAC","sourcesContent":["/**\n * cadquery-selectors/borrow-bridge — compatOp 提升边界归一（等价搬运自 cq-compat）\n *\n * 原实现位于 `packages/faijs-cadquery/src/workplane.ts` 的 `asBrepShape`，本文件为\n * 原样搬运（仅 import 路径改为 core 内部相对路径），零逻辑改动。\n */\n\nimport { fromHandle } from '../../sdk'\nimport { isShape } from '../../shape'\nimport type { Shape } from '../../mesh/types'\n\n// ── compatOp 提升边界归一（GOTCHA：borrowDeep 把实参 Shape 换成借用视图）──\n//\n// 当 cq-compat 命名空间被 registerLib 提升（无 dual-op → autoLift=true）时，\n// 每个裸导出函数的实参先经 borrowDeep：faijs Shape → 借用 brepjs 视图\n// `{ wrapped, disposed, delete, onDispose }`（`isShape=false`、`brepOf=undefined`）。\n// 直接调用（测试进程内）拿到的则是真实 Shape。两个形态都必须能消费：\n//\n//   asBrepShape(v) —\n//   - 真实 Shape → 原样返回；\n//   - 借用视图（有 `.wrapped`）→ 提取原始 OCCT 句柄，fromHandle 还原为真实\n//     Shape（mesh 三角化 + BREP 身份槽登记，brepOf 可恢复），按视图对象缓存\n//     （同句柄多次调用不重复三角化）；\n//   - 其余 → 原样返回（调用方自行判空/报错）。\n//\n// 所有权：归一出的新 Shape 与原 part Shape 的 slot 指向同一 OCCT 句柄，但 slot\n// 按 Shape 对象各自持有（fromBrep 写的是新 Shape 的 slot），无共享释放路径——\n// 与 core fromHandle 收编模式同构，不引入双重释放。\n// 视图 `.wrapped` 是 OcctWasmHandle 对象（{ id, type, __occtWasm }），内核只收\n// 数字 id → 解包方式与 core fromHandle 一致。\nconst borrowedShapeCache = new WeakMap<object, Shape>()\n\n/**\n * 把可能是借用视图的几何输入归一为真实 faijs Shape（见上方注释）。\n * @param v 真实 Shape、借用视图（`{ wrapped }`）或其他原样透传的输入。\n * @returns 真实 faijs `Shape`（借用视图经 `fromHandle` 还原并缓存）。\n */\nexport function asBrepShape(v: unknown): Shape {\n  if (isShape(v)) return v as Shape\n  if (v !== null && typeof v === 'object' && 'wrapped' in v) {\n    const view = v as { wrapped: unknown }\n    const hit = borrowedShapeCache.get(view)\n    if (hit) return hit\n    const wrappedAny = view.wrapped\n    const handle =\n      typeof wrappedAny === 'object' && wrappedAny !== null && 'id' in wrappedAny\n        ? (wrappedAny as { id: number }).id\n        : wrappedAny\n    const s = fromHandle(handle) as Shape\n    borrowedShapeCache.set(view, s)\n    return s\n  }\n  return v as Shape\n}"]}
+{"version":3,"file":"borrow-bridge.js","sourceRoot":"","sources":["../../../src/api/cadquery-selectors/borrow-bridge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAGrC,oDAAoD;AACpD,EAAE;AACF,gEAAgE;AAChE,4CAA4C;AAC5C,yBAAyB;AACzB,EAAE;AACF,qBAAqB;AACrB,uBAAuB;AACvB,wDAAwD;AACxD,sDAAsD;AACtD,uBAAuB;AACvB,6BAA6B;AAC7B,EAAE;AACF,2DAA2D;AAC3D,uDAAuD;AACvD,oCAAoC;AACpC,mEAAmE;AACnE,oCAAoC;AACpC,MAAM,kBAAkB,GAAG,IAAI,OAAO,EAAiB,CAAA;AAEvD;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,CAAU;IACpC,IAAI,OAAO,CAAC,CAAC,CAAC;QAAE,OAAO,CAAU,CAAA;IACjC,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,GAAG,CAAyB,CAAA;QACtC,MAAM,GAAG,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACxC,IAAI,GAAG;YAAE,OAAO,GAAG,CAAA;QACnB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAA;QAC/B,MAAM,MAAM,GACV,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,IAAI,IAAI,IAAI,IAAI,UAAU;YACzE,CAAC,CAAE,UAA6B,CAAC,EAAE;YACnC,CAAC,CAAC,UAAU,CAAA;QAChB,MAAM,CAAC,GAAG,UAAU,CAAC,MAAM,CAAU,CAAA;QACrC,kBAAkB,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QAC/B,OAAO,CAAC,CAAA;IACV,CAAC;IACD,OAAO,CAAU,CAAA;AACnB,CAAC","sourcesContent":["/**\n * cadquery-selectors/borrow-bridge — compatOp 提升边界归一（等价搬运自 cq-compat）\n *\n * 原实现位于 `packages/faijs-cadquery/src/workplane.ts` 的 `asBrepShape`，本文件为\n * 原样搬运（仅 import 路径改为 core 内部相对路径），零逻辑改动。\n */\n\nimport { fromHandle } from '../../sdk'\nimport { isShape } from '../../shape'\nimport type { Shape } from '../../mesh/types'\n\n// ── compatOp 提升边界归一（GOTCHA：compatOp 提升后实参形态可能变化）──\n//\n// 当 cq-compat 命名空间被 registerLib 提升（无 dual-op → autoLift=true）时，\n// 每个裸导出函数的实参经 compatOp 适配器传入。直接调用（测试进程内）拿到的\n// 则是真实 Shape。两个形态都必须能消费：\n//\n//   asBrepShape(v) —\n//   - 真实 Shape → 原样返回；\n//   - 借用视图（有 `.wrapped`）→ 提取原始 OCCT 句柄，fromHandle 还原为真实\n//     Shape（mesh 三角化 + BREP 身份槽登记，brepOf 可恢复），按视图对象缓存\n//     （同句柄多次调用不重复三角化）；\n//   - 其余 → 原样返回（调用方自行判空/报错）。\n//\n// 所有权：归一出的新 Shape 与原 part Shape 的 slot 指向同一 OCCT 句柄，但 slot\n// 按 Shape 对象各自持有（fromBrep 写的是新 Shape 的 slot），无共享释放路径——\n// 与 core fromHandle 收编模式同构，不引入双重释放。\n// 视图 `.wrapped` 是 OcctWasmHandle 对象（{ id, type, __occtWasm }），内核只收\n// 数字 id → 解包方式与 core fromHandle 一致。\nconst borrowedShapeCache = new WeakMap<object, Shape>()\n\n/**\n * 把可能是借用视图的几何输入归一为真实 faijs Shape（见上方注释）。\n * @param v 真实 Shape、借用视图（`{ wrapped }`）或其他原样透传的输入。\n * @returns 真实 faijs `Shape`（借用视图经 `fromHandle` 还原并缓存）。\n */\nexport function asBrepShape(v: unknown): Shape {\n  if (isShape(v)) return v as Shape\n  if (v !== null && typeof v === 'object' && 'wrapped' in v) {\n    const view = v as { wrapped: unknown }\n    const hit = borrowedShapeCache.get(view)\n    if (hit) return hit\n    const wrappedAny = view.wrapped\n    const handle =\n      typeof wrappedAny === 'object' && wrappedAny !== null && 'id' in wrappedAny\n        ? (wrappedAny as { id: number }).id\n        : wrappedAny\n    const s = fromHandle(handle) as Shape\n    borrowedShapeCache.set(view, s)\n    return s\n  }\n  return v as Shape\n}"]}

package/dist/api/curve-sketch/index.d.ts

@@ -0,0 +1,235 @@
+/**
+ * api curve-sketch — 曲线与草图构造族（S4，平台 op engines:['occt']）
+ *
+ * @platform occt — 本目录 import occt-kernel：各 op 直调 occt 原生曲线构造/精修方法
+ * （`makeEdge` / `makeCircleArc` / `makeEllipseEdge` / `makeEllipseArc` /
+ * `makeTangentArc` / `approximatePoints` / `interpolatePointsWithTangents` /
+ * `curveDegreeElevate` / `curveKnotInsert` / `curveKnotRemove` / `curveIsPeriodic`，
+ * occt-wasm 原生有）。这些原生方法**不在** L1 契约 `BrepEngineApi` 里（L1 只有
+ * `makeLineEdge` / `makeArcEdge` / `interpolatePoints` 等按几何构造的子集，见
+ * brep/engine/primitives.ts）⇒ 全族平台 op：defineOp 声明 `engines: ['occt']`（D11）。
+ *
+ * 方案落点：docs/plans/2026-10-07-occt-wasm-op-enablement-plan.md §3.4.1。
+ * 与既有 op 的边界（§4.5 去重表）：`edge`（顶点对构造）≠ `makeLineEdge`（L1 点对构造，
+ * 无脚本符号）≠ `wire`（多边组装）；`approximatePoints`（逼近）与 L1 `interpolatePoints`
+ * （插值）是数学对偶的两条路径；`interpolateWithTangents` 是带端点切向的插值。
+ *
+ * 角度约定（实测钉住，见 test/api/occt-s4-curve-sketch.test.ts）：occt 原生
+ * `makeCircleArc` / `makeEllipseArc` 的起止角走 `Geom_TrimmedCurve`（**弧度**，
+ * 见 occt-wasm facade `Geom_TrimmedCurve(new Geom_Circle(circle), startAngle, endAngle)`）；
+ * 本仓契约「角度用度」（docs/api-contract.md）⇒ 脚本面收**度**、内部换算弧度。
+ *
+ * 产物形态（同 offset2d / helix）：1D 曲线经 `fromBrepCurve` 登记为 `kind:'curve'`
+ * （wire/edge 三角载荷为空，显示走 L1 `wireframe`）。
+ *
+ * `curveIsPeriodic` 返回布尔（非 Shape）⇒ 与 shape-type 族同口径：普通函数 +
+ * `assertEngineFor('curveIsPeriodic', ['occt'])`（见 api/shape-type/index.ts 头注），
+ * 覆盖率扫描器经 PLAN_C2_EXTRA 计入。
+ */
+import type { Shape } from '../../mesh/types.js';
+type Vec3 = [number, number, number];
+/**
+ * 两顶点构造边。顶点入参可以是 vertex Shape，也可以是 `[x,y,z]` 点
+ * （点经 L1 契约 `makeVertex` 物化成顶点再配边）。
+ * @group 创建
+ * @inputs 2
+ * @async false
+ * @qual ok
+ * @name edge
+ * @note 平台 op：仅 occt 引擎（原生 makeEdge，L1 契约只有 makeLineEdge 等按几何构造）。
+ *       非 occt 引擎执行前报错；brep_mock 不拦截。
+ * @returns Shape 1D 直线边（kind:'curve'）。
+ * @param v1 - 第一个顶点（vertex Shape 或 [x,y,z]）。type:Shape|Vec3 required:true
+ * @param v2 - 第二个顶点（vertex Shape 或 [x,y,z]）。type:Shape|Vec3 required:true
+ * @example
+ * const e = cad.edge([0,0,0], [10,0,0])
+ */
+export declare const edge: ((v1: Shape | Vec3, v2: Shape | Vec3) => Promise<Shape>) & {
+    __faijs__dualOp?: import("../../define-op.js").DualOpMeta;
+};
+/**
+ * 构造圆弧：圆心 + 法向 + 半径 + 起止角（度，绕法向右手逆时针）。
+ * @group 创建
+ * @inputs 0
+ * @async false
+ * @qual ok
+ * @name circleArc
+ * @note 平台 op：仅 occt 引擎（原生 makeCircleArc）。角度单位是**度**（内部换算弧度
+ *       传给 occt 的 Geom_TrimmedCurve）。
+ * @returns Shape 1D 圆弧（kind:'curve'）。
+ * @param center - 圆心 [x,y,z]。type:Vec3 required:true
+ * @param normal - 圆面法向 [x,y,z]（非零）。type:Vec3 required:true
+ * @param radius - 半径（mm，>0）。type:number required:true
+ * @param startAngle - 起始角（度，自法向基准 X 方向起量）。type:number required:true
+ * @param endAngle - 终止角（度）。type:number required:true
+ * @example
+ * const a = cad.circleArc([0,0,0], [0,0,1], 5, 0, 90)
+ */
+export declare const circleArc: ((center: Vec3, normal: Vec3, radius: number, startAngleDeg: number, endAngleDeg: number) => Promise<Shape>) & {
+    __faijs__dualOp?: import("../../define-op.js").DualOpMeta;
+};
+/**
+ * 构造整椭圆边：中心 + 法向 + 长半轴 + 短半轴。
+ * @group 创建
+ * @inputs 0
+ * @async false
+ * @qual ok
+ * @name ellipseEdge
+ * @note 平台 op：仅 occt 引擎（原生 makeEllipseEdge）。要求 majorRadius >= minorRadius。
+ * @returns Shape 1D 椭圆边（kind:'curve'）。
+ * @param center - 椭圆中心 [x,y,z]。type:Vec3 required:true
+ * @param normal - 椭圆面法向 [x,y,z]（非零）。type:Vec3 required:true
+ * @param majorRadius - 长半轴（mm，>0）。type:number required:true
+ * @param minorRadius - 短半轴（mm，>0 且 <= 长半轴）。type:number required:true
+ * @example
+ * const e = cad.ellipseEdge([0,0,0], [0,0,1], 10, 5)
+ */
+export declare const ellipseEdge: ((center: Vec3, normal: Vec3, majorRadius: number, minorRadius: number) => Promise<Shape>) & {
+    __faijs__dualOp?: import("../../define-op.js").DualOpMeta;
+};
+/**
+ * 构造椭圆弧：中心 + 法向 + 长短半轴 + 起止角（度）。
+ * @group 创建
+ * @inputs 0
+ * @async false
+ * @qual ok
+ * @name ellipseArc
+ * @note 平台 op：仅 occt 引擎（原生 makeEllipseArc）。角度单位是**度**（内部换算弧度）。
+ * @returns Shape 1D 椭圆弧（kind:'curve'）。
+ * @param center - 椭圆中心 [x,y,z]。type:Vec3 required:true
+ * @param normal - 椭圆面法向 [x,y,z]（非零）。type:Vec3 required:true
+ * @param majorRadius - 长半轴（mm，>0）。type:number required:true
+ * @param minorRadius - 短半轴（mm，>0 且 <= 长半轴）。type:number required:true
+ * @param startAngle - 起始角（度）。type:number required:true
+ * @param endAngle - 终止角（度）。type:number required:true
+ * @example
+ * const a = cad.ellipseArc([0,0,0], [0,0,1], 10, 5, 0, 90)
+ */
+export declare const ellipseArc: ((center: Vec3, normal: Vec3, majorRadius: number, minorRadius: number, startAngleDeg: number, endAngleDeg: number) => Promise<Shape>) & {
+    __faijs__dualOp?: import("../../define-op.js").DualOpMeta;
+};
+/**
+ * 构造圆弧：过起点、以给定切向出发、终于终点（GC_MakeArcOfCircle 语义）。
+ * @group 创建
+ * @inputs 0
+ * @async false
+ * @qual ok
+ * @name tangentArc
+ * @note 平台 op：仅 occt 引擎（原生 makeTangentArc）。切向为零向量非法。
+ * @returns Shape 1D 圆弧（kind:'curve'）。
+ * @param start - 起点 [x,y,z]。type:Vec3 required:true
+ * @param tangent - 起点切向 [x,y,z]（非零，不必单位化）。type:Vec3 required:true
+ * @param end - 终点 [x,y,z]。type:Vec3 required:true
+ * @example
+ * const a = cad.tangentArc([0,0,0], [1,0,0], [5,5,0])
+ */
+export declare const tangentArc: ((start: Vec3, tangent: Vec3, end: Vec3) => Promise<Shape>) & {
+    __faijs__dualOp?: import("../../define-op.js").DualOpMeta;
+};
+/**
+ * 点集**逼近**曲线：过点但不严格插值（逼近容差内贴合，产平滑 B 样条）。
+ * 与 L1 `interpolatePoints`（严格插值）成对的数学对偶路径。
+ * @group 创建
+ * @inputs 0
+ * @async false
+ * @qual ok
+ * @name approximatePoints
+ * @note 平台 op：仅 occt 引擎（原生 approximatePoints，tolerance 缺省 1e-3）。
+ * @returns Shape 1D 逼近曲线（kind:'curve'）。
+ * @param points - 点集 [x,y,z][]（≥2 点）。type:Vec3[] required:true
+ * @param tolerance - 逼近容差（mm，默认 1e-3）。type:number required:false
+ * @example
+ * const c = cad.approximatePoints([[0,0,0],[5,3,0],[10,0,0]])
+ */
+export declare const approximatePoints: ((points: Vec3[], tolerance?: number | undefined) => Promise<Shape>) & {
+    __faijs__dualOp?: import("../../define-op.js").DualOpMeta;
+};
+/**
+ * 点集**插值**曲线，带端点切向约束（三次 B 样条，过全部点且端点切向指定）。
+ * @group 创建
+ * @inputs 0
+ * @async false
+ * @qual ok
+ * @name interpolateWithTangents
+ * @note 平台 op：仅 occt 引擎（原生 interpolatePointsWithTangents）。两端切向非零。
+ * @returns Shape 1D 插值曲线（kind:'curve'）。
+ * @param points - 点集 [x,y,z][]（≥2 点）。type:Vec3[] required:true
+ * @param startTangent - 起点切向 [x,y,z]（非零）。type:Vec3 required:true
+ * @param endTangent - 终点切向 [x,y,z]（非零）。type:Vec3 required:true
+ * @example
+ * const c = cad.interpolateWithTangents([[0,0,0],[5,3,0],[10,0,0]], [1,0,0], [1,0,0])
+ */
+export declare const interpolateWithTangents: ((points: Vec3[], startTangent: Vec3, endTangent: Vec3) => Promise<Shape>) & {
+    __faijs__dualOp?: import("../../define-op.js").DualOpMeta;
+};
+/**
+ * NURBS 曲线升阶：把边/曲线的阶数提升 `elevateBy`（几何不变，表示空间变大）。
+ * @group 查询
+ * @inputs 1
+ * @async false
+ * @qual ok
+ * @name curveDegreeElevate
+ * @note 平台 op：仅 occt 引擎（原生 curveDegreeElevate）。输入边/曲线。
+ * @returns Shape 升阶后的 1D 曲线（kind:'curve'）。
+ * @param curve - 输入边/曲线。type:Shape required:true
+ * @param elevateBy - 升阶量（正整数）。type:number required:true
+ * @example
+ * const up = cad.curveDegreeElevate(e, 2)
+ */
+export declare const curveDegreeElevate: ((curve: Shape, elevateBy: number) => Promise<Shape>) & {
+    __faijs__dualOp?: import("../../define-op.js").DualOpMeta;
+};
+/**
+ * NURBS 曲线插节点：在曲线参数 `knot` 处插入节点 `times` 次（几何不变）。
+ * @group 查询
+ * @inputs 1
+ * @async false
+ * @qual ok
+ * @name curveKnotInsert
+ * @note 平台 op：仅 occt 引擎（原生 curveKnotInsert）。knot 是曲线参数（不是长度）。
+ * @returns Shape 插节点后的 1D 曲线（kind:'curve'）。
+ * @param curve - 输入边/曲线。type:Shape required:true
+ * @param knot - 目标节点参数。type:number required:true
+ * @param times - 重复次数（正整数）。type:number required:true
+ * @example
+ * const refined = cad.curveKnotInsert(e, 0.5, 1)
+ */
+export declare const curveKnotInsert: ((curve: Shape, knot: number, times: number) => Promise<Shape>) & {
+    __faijs__dualOp?: import("../../define-op.js").DualOpMeta;
+};
+/**
+ * NURBS 曲线去节点：在容差内移除参数 `knot` 处的节点（几何漂移不超过 tolerance）。
+ * @group 查询
+ * @inputs 1
+ * @async false
+ * @qual ok
+ * @name curveKnotRemove
+ * @note 平台 op：仅 occt 引擎（原生 curveKnotRemove）。knot 是曲线参数（不是长度）。
+ * @returns Shape 去节点后的 1D 曲线（kind:'curve'）。
+ * @param curve - 输入边/曲线。type:Shape required:true
+ * @param knot - 目标节点参数。type:number required:true
+ * @param tolerance - 允许的几何漂移（mm，>0）。type:number required:true
+ * @example
+ * const lean = cad.curveKnotRemove(e, 0.5, 1e-4)
+ */
+export declare const curveKnotRemove: ((curve: Shape, knot: number, tolerance: number) => Promise<Shape>) & {
+    __faijs__dualOp?: import("../../define-op.js").DualOpMeta;
+};
+/**
+ * 曲线是否周期（L1 契约只有 `curveIsClosed`，周期性是 occt 原生独有查询）。
+ * @group 查询
+ * @inputs 1
+ * @async false
+ * @qual ok
+ * @name curveIsPeriodic
+ * @note 平台 op：仅 occt 引擎（原生 curveIsPeriodic，L1 无对应成员）。非 occt 引擎
+ *       执行前报 E_BREP_UNSUPPORTED。
+ * @returns boolean 是否为周期曲线。
+ * @param curve - 被查询的边/曲线。type:Shape required:true
+ * @example
+ * const c = cad.circleArc([0,0,0], [0,0,1], 5, 0, 360)
+ * const periodic = cad.curveIsPeriodic(c)
+ */
+export declare function curveIsPeriodic(curve: Shape): boolean;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/api/curve-sketch/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/curve-sketch/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAU7C,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAgEpC;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,IAAI;;CAOf,CAAA;AA+BF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,SAAS;;CAQpB,CAAA;AA4BF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,WAAW;;CAQtB,CAAA;AA0BF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,UAAU;;CAQrB,CAAA;AAeF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,UAAU;;CAQrB,CAAA;AA4BF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,iBAAiB;;CAQ5B,CAAA;AAiBF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,uBAAuB;;CAQlC,CAAA;AAgBF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kBAAkB;;CAO7B,CAAA;AAeF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,eAAe;;CAO1B,CAAA;AAeF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,eAAe;;CAQ1B,CAAA;AAMF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAKrD"}