@faicad/faijs 0.13.0

package/dist/brep/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * BREP 操作统一导出
+ *
+ * 目录结构：
+ * - brep-ops.ts: 核心 BREP 操作（变换、布尔、钻孔、分割、拉伸）
+ * - brep-chain.ts: BREP 链状态管理
+ * - brep-utils.ts: 通用工具
+ * - brepjs-mirror/: 从 brepjs 参考的操作实现（镜像 brepjs src/operations/，勿手改核心算法）
+ * - text/: 文字 BREP 实现（镜像 brepjs src/text/）
+ * - ops/: 每个操作的 BREP + Mesh 分派器（src/ops/）
+ */
+export { solidToShape, translateBrep, rotateBrep, scaleBrep, fuseBrep, cutBrep, commonBrep, drillBrep, splitBrep, extrudeBrep, loadBrep, matrixToArray, type DrillBrepParams, type SplitBrepParams, type SplitBrepResult, type ExtrudeBrepParams, } from './brep-ops.js';
+export { type BrepChainState, createBrepChainState, initBrepChainState, releaseBrepChainState, isCadFormat, } from './brep-chain.js';
+export { getSolidBoundingBox } from './brep-utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/brep/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/brep/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EACL,YAAY,EACZ,aAAa,EAAE,UAAU,EAAE,SAAS,EACpC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAC7B,SAAS,EAAE,SAAS,EAAE,WAAW,EACjC,QAAQ,EAAE,aAAa,EACvB,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,KAAK,iBAAiB,GACzF,MAAM,YAAY,CAAA;AAGnB,OAAO,EACL,KAAK,cAAc,EACnB,oBAAoB,EAAE,kBAAkB,EACxC,qBAAqB,EACrB,WAAW,GACZ,MAAM,cAAc,CAAA;AAGrB,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA"}

package/dist/brep/index.js

@@ -0,0 +1,20 @@
+/**
+ * BREP 操作统一导出
+ *
+ * 目录结构：
+ * - brep-ops.ts: 核心 BREP 操作（变换、布尔、钻孔、分割、拉伸）
+ * - brep-chain.ts: BREP 链状态管理
+ * - brep-utils.ts: 通用工具
+ * - brepjs-mirror/: 从 brepjs 参考的操作实现（镜像 brepjs src/operations/，勿手改核心算法）
+ * - text/: 文字 BREP 实现（镜像 brepjs src/text/）
+ * - ops/: 每个操作的 BREP + Mesh 分派器（src/ops/）
+ */
+// 核心 BREP 操作
+export { solidToShape, translateBrep, rotateBrep, scaleBrep, fuseBrep, cutBrep, commonBrep, drillBrep, splitBrep, extrudeBrep, loadBrep, matrixToArray, } from './brep-ops.js';
+// BREP 链状态管理
+export { createBrepChainState, initBrepChainState, releaseBrepChainState, isCadFormat, } from './brep-chain.js';
+// 通用工具
+export { getSolidBoundingBox } from './brep-utils.js';
+// F4 修复：不再反向 re-export executeStatement（ops/dispatcher）。
+// brep/ 不应 re-export ops/ 的符号。宿主从 @faicad/faijs/browser 直接 import executeStatement。
+//# sourceMappingURL=index.js.map

package/dist/brep/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/brep/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,aAAa;AACb,OAAO,EACL,YAAY,EACZ,aAAa,EAAE,UAAU,EAAE,SAAS,EACpC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAC7B,SAAS,EAAE,SAAS,EAAE,WAAW,EACjC,QAAQ,EAAE,aAAa,GAExB,MAAM,YAAY,CAAA;AAEnB,aAAa;AACb,OAAO,EAEL,oBAAoB,EAAE,kBAAkB,EACxC,qBAAqB,EACrB,WAAW,GACZ,MAAM,cAAc,CAAA;AAErB,OAAO;AACP,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAElD,yDAAyD;AACzD,oFAAoF","sourcesContent":["/**\n * BREP 操作统一导出\n *\n * 目录结构：\n * - brep-ops.ts: 核心 BREP 操作（变换、布尔、钻孔、分割、拉伸）\n * - brep-chain.ts: BREP 链状态管理\n * - brep-utils.ts: 通用工具\n * - brepjs-mirror/: 从 brepjs 参考的操作实现（镜像 brepjs src/operations/，勿手改核心算法）\n * - text/: 文字 BREP 实现（镜像 brepjs src/text/）\n * - ops/: 每个操作的 BREP + Mesh 分派器（src/ops/）\n */\n\n// 核心 BREP 操作\nexport {\n  solidToShape,\n  translateBrep, rotateBrep, scaleBrep,\n  fuseBrep, cutBrep, commonBrep,\n  drillBrep, splitBrep, extrudeBrep,\n  loadBrep, matrixToArray,\n  type DrillBrepParams, type SplitBrepParams, type SplitBrepResult, type ExtrudeBrepParams,\n} from './brep-ops'\n\n// BREP 链状态管理\nexport {\n  type BrepChainState,\n  createBrepChainState, initBrepChainState,\n  releaseBrepChainState,\n  isCadFormat,\n} from './brep-chain'\n\n// 通用工具\nexport { getSolidBoundingBox } from './brep-utils'\n\n// F4 修复：不再反向 re-export executeStatement（ops/dispatcher）。\n// brep/ 不应 re-export ops/ 的符号。宿主从 @faicad/faijs/browser 直接 import executeStatement。\n"]}

package/dist/brep/primitives-brep.d.ts

@@ -0,0 +1,52 @@
+/**
+ * mesh BREP 基本体 API — 使用 OCCT 精确实体构造
+ *
+ * See docs/api-contract.md §8 (dual-path geometry contract: BREP / Mesh).
+ *
+ * 与 `primitives.ts`（mesh 路径）的对照：
+ * - mesh 路径：THREE 参数几何 → geoToManifoldMesh → Shape（三角网格近似）
+ * - BREP 路径：OCCT 精确实体 → meshShape 三角化 → Shape（显示用 mesh，但底层是精确 BREP）
+ *
+ * 两条路径返回的 Shape 都是 { positions, indices }，显示管线一致。
+ * 差异仅在：BREP 路径的 Shape 由 OCCT 精确实体三角化得到，曲面精度更高；
+ * 且导出 STEP 时可短路为原生 ADVANCED_FACE（而非 faceted 重建）。
+ *
+ * segments 参数的处理：
+ * - mesh 路径：segments 直接控制 THREE 几何体的分段数
+ * - BREP 路径：segments 转换为 angularDeflection（≈2π/segments）控制 OCCT 三角化精度
+ *   BREP 实体本身是精确的，segments 只影响显示 mesh 的精度
+ *
+ * 坐标系：Z-up、毫米，与 mesh 路径一致。
+ */
+import type { Shape, BoxParams, SphereParams, CylinderParams, ConeParams, WedgeParams } from '../mesh/types.js';
+/**
+ * Create a box with an OCCT exact solid and tessellate it into a Shape.
+ * @param params - the box parameters.
+ * @returns a Promise resolving to the tessellated Shape.
+ */
+export declare function boxBrep(params: BoxParams): Promise<Shape>;
+/**
+ * Create a sphere with an OCCT exact solid and tessellate it into a Shape.
+ * @param params - the sphere parameters.
+ * @returns a Promise resolving to the tessellated Shape.
+ */
+export declare function sphereBrep(params: SphereParams): Promise<Shape>;
+/**
+ * Create a cylinder with an OCCT exact solid and tessellate it into a Shape.
+ * @param params - the cylinder parameters.
+ * @returns a Promise resolving to the tessellated Shape.
+ */
+export declare function cylinderBrep(params: CylinderParams): Promise<Shape>;
+/**
+ * Create a cone with an OCCT exact solid and tessellate it into a Shape.
+ * @param params - the cone parameters.
+ * @returns a Promise resolving to the tessellated Shape.
+ */
+export declare function coneBrep(params: ConeParams): Promise<Shape>;
+/**
+ * Create a wedge with an OCCT exact solid and tessellate it into a Shape.
+ * @param params - the wedge parameters.
+ * @returns a Promise resolving to the tessellated Shape.
+ */
+export declare function wedgeBrep(params: WedgeParams): Promise<Shape>;
+//# sourceMappingURL=primitives-brep.d.ts.map

package/dist/brep/primitives-brep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives-brep.d.ts","sourceRoot":"","sources":["../../src/brep/primitives-brep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,OAAO,KAAK,EACV,KAAK,EACL,SAAS,EACT,YAAY,EACZ,cAAc,EACd,UAAU,EACV,WAAW,EACZ,MAAM,eAAe,CAAA;AAyDtB;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAE/D;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,CAErE;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC,CAEzE;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,CAEjE;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CAEnE"}

package/dist/brep/primitives-brep.js

@@ -0,0 +1,108 @@
+/**
+ * mesh BREP 基本体 API — 使用 OCCT 精确实体构造
+ *
+ * See docs/api-contract.md §8 (dual-path geometry contract: BREP / Mesh).
+ *
+ * 与 `primitives.ts`（mesh 路径）的对照：
+ * - mesh 路径：THREE 参数几何 → geoToManifoldMesh → Shape（三角网格近似）
+ * - BREP 路径：OCCT 精确实体 → meshShape 三角化 → Shape（显示用 mesh，但底层是精确 BREP）
+ *
+ * 两条路径返回的 Shape 都是 { positions, indices }，显示管线一致。
+ * 差异仅在：BREP 路径的 Shape 由 OCCT 精确实体三角化得到，曲面精度更高；
+ * 且导出 STEP 时可短路为原生 ADVANCED_FACE（而非 faceted 重建）。
+ *
+ * segments 参数的处理：
+ * - mesh 路径：segments 直接控制 THREE 几何体的分段数
+ * - BREP 路径：segments 转换为 angularDeflection（≈2π/segments）控制 OCCT 三角化精度
+ *   BREP 实体本身是精确的，segments 只影响显示 mesh 的精度
+ *
+ * 坐标系：Z-up、毫米，与 mesh 路径一致。
+ */
+import { getBrepEngine } from './engine/registry.js';
+import { primitiveToBrepSolid } from '../primitives/brep-primitives.js';
+import { clampNRad } from '../mesh/types.js';
+// ─── 内部工具 ───
+/**
+ * 将 segments 数转换为 OCCT meshShape 的 angularDeflection。
+ *
+ * segments=32 → angularDeflection≈2π/32≈0.196 rad
+ * segments 越大，三角化越精细。
+ */
+function segmentsToAngularDeflection(segments) {
+    const segs = segments ?? 64; // 缺省 64（= brepjs standard 等效，§5.0/§5.1）
+    return (2 * Math.PI) / Math.max(3, segs);
+}
+/**
+ * 用 OCCT 构造 BREP 实体并三角化为 Shape。
+ *
+ * 内部流程：注册表取当前 BREP 引擎 → primitiveToBrepSolid（引擎精确构造）→ meshShape → release → Shape
+ *
+ * @param type      primitive 类型（cube/sphere/cylinder/cone/wedge）
+ * @param params    完整参数对象
+ * @param segments  可选分段数（影响三角化精度，不影响 BREP 实体精度）
+ * @returns Shape（三角化 mesh，供显示用）
+ */
+async function brepToShape(type, params, segments) {
+    const kernel = (await getBrepEngine()).primitives;
+    // 用升级后的 primitiveToBrepSolid 构造 OCCT 精确实体
+    const result = primitiveToBrepSolid(kernel, type, params);
+    const solid = result.solid;
+    try {
+        // 三角化为显示 mesh
+        const angularDeflection = segmentsToAngularDeflection(segments);
+        const mesh = kernel.meshShape(solid, {
+            linearDeflection: 0.1,
+            angularDeflection,
+        });
+        // 返回 Shape（与 mesh 路径格式一致）
+        return {
+            positions: new Float32Array(mesh.positions),
+            indices: new Uint32Array(mesh.indices),
+        };
+    }
+    finally {
+        kernel.release(solid);
+    }
+}
+// ─── BREP 创建 API ───
+/**
+ * Create a box with an OCCT exact solid and tessellate it into a Shape.
+ * @param params - the box parameters.
+ * @returns a Promise resolving to the tessellated Shape.
+ */
+export async function boxBrep(params) {
+    return brepToShape('cube', params);
+}
+/**
+ * Create a sphere with an OCCT exact solid and tessellate it into a Shape.
+ * @param params - the sphere parameters.
+ * @returns a Promise resolving to the tessellated Shape.
+ */
+export async function sphereBrep(params) {
+    return brepToShape('sphere', params, clampNRad(params.nRad ?? params.segments));
+}
+/**
+ * Create a cylinder with an OCCT exact solid and tessellate it into a Shape.
+ * @param params - the cylinder parameters.
+ * @returns a Promise resolving to the tessellated Shape.
+ */
+export async function cylinderBrep(params) {
+    return brepToShape('cylinder', params, clampNRad(params.nRad ?? params.segments));
+}
+/**
+ * Create a cone with an OCCT exact solid and tessellate it into a Shape.
+ * @param params - the cone parameters.
+ * @returns a Promise resolving to the tessellated Shape.
+ */
+export async function coneBrep(params) {
+    return brepToShape('cone', params, clampNRad(params.nRad ?? params.segments));
+}
+/**
+ * Create a wedge with an OCCT exact solid and tessellate it into a Shape.
+ * @param params - the wedge parameters.
+ * @returns a Promise resolving to the tessellated Shape.
+ */
+export async function wedgeBrep(params) {
+    return brepToShape('wedge', params);
+}
+//# sourceMappingURL=primitives-brep.js.map

package/dist/brep/primitives-brep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives-brep.js","sourceRoot":"","sources":["../../src/brep/primitives-brep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAA;AAWpE,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAEzC,eAAe;AAEf;;;;;GAKG;AACH,SAAS,2BAA2B,CAAC,QAAiB;IACpD,MAAM,IAAI,GAAG,QAAQ,IAAI,EAAE,CAAA,CAAC,wCAAwC;IACpE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;AAC1C,CAAC;AAED;;;;;;;;;GASG;AACH,KAAK,UAAU,WAAW,CACxB,IAAuD,EACvD,MAA4E,EAC5E,QAAiB;IAEjB,MAAM,MAAM,GAAkB,CAAC,MAAM,aAAa,EAAE,CAAC,CAAC,UAAU,CAAA;IAEhE,0CAA0C;IAC1C,MAAM,MAAM,GAAG,oBAAoB,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;IACzD,MAAM,KAAK,GAAe,MAAM,CAAC,KAAK,CAAA;IAEtC,IAAI,CAAC;QACH,cAAc;QACd,MAAM,iBAAiB,GAAG,2BAA2B,CAAC,QAAQ,CAAC,CAAA;QAC/D,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE;YACnC,gBAAgB,EAAE,GAAG;YACrB,iBAAiB;SAClB,CAAC,CAAA;QAEF,0BAA0B;QAC1B,OAAO;YACL,SAAS,EAAE,IAAI,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC;YAC3C,OAAO,EAAE,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC;SACvC,CAAA;IACH,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IACvB,CAAC;AACH,CAAC;AAED,sBAAsB;AAEtB;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAiB;IAC7C,OAAO,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAoB;IACrD,OAAO,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAA;AAC/E,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAsB;IACzD,OAAO,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAA;AACjF,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,MAAkB;IACjD,OAAO,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAA;AAC7E,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAAmB;IACjD,OAAO,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;AACrC,CAAC","sourcesContent":["/**\n * mesh BREP 基本体 API — 使用 OCCT 精确实体构造\n *\n * See docs/api-contract.md §8 (dual-path geometry contract: BREP / Mesh).\n *\n * 与 `primitives.ts`（mesh 路径）的对照：\n * - mesh 路径：THREE 参数几何 → geoToManifoldMesh → Shape（三角网格近似）\n * - BREP 路径：OCCT 精确实体 → meshShape 三角化 → Shape（显示用 mesh，但底层是精确 BREP）\n *\n * 两条路径返回的 Shape 都是 { positions, indices }，显示管线一致。\n * 差异仅在：BREP 路径的 Shape 由 OCCT 精确实体三角化得到，曲面精度更高；\n * 且导出 STEP 时可短路为原生 ADVANCED_FACE（而非 faceted 重建）。\n *\n * segments 参数的处理：\n * - mesh 路径：segments 直接控制 THREE 几何体的分段数\n * - BREP 路径：segments 转换为 angularDeflection（≈2π/segments）控制 OCCT 三角化精度\n *   BREP 实体本身是精确的，segments 只影响显示 mesh 的精度\n *\n * 坐标系：Z-up、毫米，与 mesh 路径一致。\n */\n\nimport { getBrepEngine } from './engine/registry'\nimport { primitiveToBrepSolid } from '../primitives/brep-primitives'\nimport type { BrepHandle } from './engine/types'\nimport type { BrepEngineApi } from './engine/primitives'\nimport type {\n  Shape,\n  BoxParams,\n  SphereParams,\n  CylinderParams,\n  ConeParams,\n  WedgeParams,\n} from '../mesh/types'\nimport { clampNRad } from '../mesh/types'\n\n// ─── 内部工具 ───\n\n/**\n * 将 segments 数转换为 OCCT meshShape 的 angularDeflection。\n *\n * segments=32 → angularDeflection≈2π/32≈0.196 rad\n * segments 越大，三角化越精细。\n */\nfunction segmentsToAngularDeflection(segments?: number): number {\n  const segs = segments ?? 64 // 缺省 64（= brepjs standard 等效，§5.0/§5.1）\n  return (2 * Math.PI) / Math.max(3, segs)\n}\n\n/**\n * 用 OCCT 构造 BREP 实体并三角化为 Shape。\n *\n * 内部流程：注册表取当前 BREP 引擎 → primitiveToBrepSolid（引擎精确构造）→ meshShape → release → Shape\n *\n * @param type      primitive 类型（cube/sphere/cylinder/cone/wedge）\n * @param params    完整参数对象\n * @param segments  可选分段数（影响三角化精度，不影响 BREP 实体精度）\n * @returns Shape（三角化 mesh，供显示用）\n */\nasync function brepToShape(\n  type: 'cube' | 'sphere' | 'cylinder' | 'cone' | 'wedge',\n  params: BoxParams | SphereParams | CylinderParams | ConeParams | WedgeParams,\n  segments?: number,\n): Promise<Shape> {\n  const kernel: BrepEngineApi = (await getBrepEngine()).primitives\n\n  // 用升级后的 primitiveToBrepSolid 构造 OCCT 精确实体\n  const result = primitiveToBrepSolid(kernel, type, params)\n  const solid: BrepHandle = result.solid\n\n  try {\n    // 三角化为显示 mesh\n    const angularDeflection = segmentsToAngularDeflection(segments)\n    const mesh = kernel.meshShape(solid, {\n      linearDeflection: 0.1,\n      angularDeflection,\n    })\n\n    // 返回 Shape（与 mesh 路径格式一致）\n    return {\n      positions: new Float32Array(mesh.positions),\n      indices: new Uint32Array(mesh.indices),\n    }\n  } finally {\n    kernel.release(solid)\n  }\n}\n\n// ─── BREP 创建 API ───\n\n/**\n * Create a box with an OCCT exact solid and tessellate it into a Shape.\n * @param params - the box parameters.\n * @returns a Promise resolving to the tessellated Shape.\n */\nexport async function boxBrep(params: BoxParams): Promise<Shape> {\n  return brepToShape('cube', params)\n}\n\n/**\n * Create a sphere with an OCCT exact solid and tessellate it into a Shape.\n * @param params - the sphere parameters.\n * @returns a Promise resolving to the tessellated Shape.\n */\nexport async function sphereBrep(params: SphereParams): Promise<Shape> {\nreturn brepToShape('sphere', params, clampNRad(params.nRad ?? params.segments))\n}\n\n/**\n * Create a cylinder with an OCCT exact solid and tessellate it into a Shape.\n * @param params - the cylinder parameters.\n * @returns a Promise resolving to the tessellated Shape.\n */\nexport async function cylinderBrep(params: CylinderParams): Promise<Shape> {\nreturn brepToShape('cylinder', params, clampNRad(params.nRad ?? params.segments))\n}\n\n/**\n * Create a cone with an OCCT exact solid and tessellate it into a Shape.\n * @param params - the cone parameters.\n * @returns a Promise resolving to the tessellated Shape.\n */\nexport async function coneBrep(params: ConeParams): Promise<Shape> {\nreturn brepToShape('cone', params, clampNRad(params.nRad ?? params.segments))\n}\n\n/**\n * Create a wedge with an OCCT exact solid and tessellate it into a Shape.\n * @param params - the wedge parameters.\n * @returns a Promise resolving to the tessellated Shape.\n */\nexport async function wedgeBrep(params: WedgeParams): Promise<Shape> {\n  return brepToShape('wedge', params)\n}\n"]}

package/dist/brep/svg/svg-to-solid.d.ts

@@ -0,0 +1,111 @@
+/**
+ * SVG → OCCT wire/face/solid 转换
+ *
+ * 适配自 brepjs `src/io/svgImportFns.ts`，保留核心算法和命名。
+ * 与 brepjs 的差异：
+ * - brepjs 用 Curve2D / Blueprint / sketchOnPlane → 本项目直接用 3D edge / makeWire / makeFace
+ * - brepjs 不处理孔洞 → 本项目用 kernel.addHolesInFace 处理外轮廓+内孔
+ * - brepjs 仅解析 <path> → 本项目额外转换 <rect>/<circle>/<ellipse>/<line>/<polyline>/<polygon>
+ *
+ * 与 text-to-solid.ts 的差异：
+ * - text 的 glyph 互不嵌套，各自 makeFace→extrude→fuse
+ * - SVG 路径常有外轮廓+内孔，需 addHolesInFace 挖孔后再 extrude
+ *
+ * SVG path 命令 → OCCT edge 映射：
+ * - M (moveTo) → 开始新子路径
+ * - L (lineTo) → kernel.makeLineEdge
+ * - H/V → 转 makeLineEdge
+ * - C (cubicBezier) → kernel.makeBezierEdge
+ * - S (smoothCubicBezier) → 反射控制点 → makeBezierEdge
+ * - Q (quadraticBezier) → 转三次贝塞尔 → makeBezierEdge
+ * - T (smoothQuadraticBezier) → 反射控制点 → 转三次 → makeBezierEdge
+ * - A (arc) → 计算 sagitta 中点 → kernel.makeArcEdge(start, mid, end)
+ * - Z (closePath) → 闭合 wire
+ */
+import type { BrepHandle } from '../engine/types.js';
+import type { BrepEngineApi } from '../engine/primitives.js';
+import { parseSvgNaturalSize } from '../../primitives/parse-svg-size.js';
+export { parseSvgNaturalSize };
+/** 3D 点（OCCT Vec3 格式） */
+interface Pt {
+    x: number;
+    y: number;
+    z: number;
+}
+/** 闭合子路径信息（用于孔洞检测） */
+interface ClosedSubpath {
+    /** 顶点列表（XY 平面，Z=0） */
+    points: Pt[];
+    /** 包围盒 */
+    bbox: {
+        minX: number;
+        minY: number;
+        maxX: number;
+        maxY: number;
+    };
+    /** 有符号面积（Shoelace，正=CCW，负=CW） */
+    signedArea: number;
+    /** 对应的 OCCT wire */
+    wire: BrepHandle;
+}
+/**
+ * 从 SVG 字符串中提取所有图形元素的 path `d` 属性。
+ *
+ * 支持：<path>, <rect>, <circle>, <ellipse>, <line>, <polyline>, <polygon>。
+ * 使用正则提取，无 DOMParser 依赖（可在 Web Worker / Node 中运行）。
+ *
+ * @param svgString - the raw SVG markup to extract paths from.
+ * @returns an array of path `d` strings.
+ */
+export declare function extractSvgPaths(svgString: string): string[];
+/**
+ * 解析 SVG path `d` 字符串，构建 OCCT wire 列表。
+ *
+ * 每个 M...Z 闭合段（或 M...M 隐式闭合段）对应一个 wire。
+ * 未闭合的段（无 Z，后接 M 或结束）也会生成 wire（但标记为未闭合）。
+ *
+ * @param kernel OCCT 内核
+ * @param pathD SVG path `d` 属性字符串
+ * @returns 闭合子路径列表（含 wire + 几何信息）
+ */
+export declare function parseSVGPathToWires(kernel: BrepEngineApi, pathD: string): ClosedSubpath[];
+interface ContourGroup {
+    /** 外轮廓 wire */
+    outer: BrepHandle;
+    /** 孔洞 wire 列表 */
+    holes: BrepHandle[];
+}
+/**
+ * 将闭合子路径分类为外轮廓 + 孔洞的分组。
+ *
+ * 算法：
+ * 1. 按有符号面积绝对值降序排（大轮廓优先）
+ * 2. 对每条子路径 A，找到直接包含它的最小外轮廓 B
+ * 3. A 是 B 的孔洞
+ * 4. 没有外轮廓的子路径是独立外轮廓
+ *
+ * @param subpaths - the closed subpaths to classify.
+ * @returns the contour groups of outer wires and their hole wires.
+ */
+export declare function classifyHoles(subpaths: ClosedSubpath[]): ContourGroup[];
+/**
+ * 将 SVG 字符串转换为 OCCT 3D solid（face → extrude → fuse）。
+ *
+ * 流程：
+ * 1. 提取所有 SVG 元素的 path `d`
+ * 2. 解析每条 path → wires
+ * 3. 分类外轮廓/孔洞
+ * 4. makeFace(outer) → addHolesInFace(holes) → extrude
+ * 5. fuse 所有 solid
+ * 6. 缩放 + 居中
+ *
+ * @param kernel OCCT 内核
+ * @param svgString SVG 字符串
+ * @param options 配置选项
+ * @returns BrepHandle（合并后的 solid）
+ */
+export declare function svgToSolid(kernel: BrepEngineApi, svgString: string, options: {
+    depth: number;
+    targetLongSide?: number;
+}): BrepHandle;
+//# sourceMappingURL=svg-to-solid.d.ts.map

package/dist/brep/svg/svg-to-solid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg-to-solid.d.ts","sourceRoot":"","sources":["../../../src/brep/svg/svg-to-solid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAA;AAErE,OAAO,EAAE,mBAAmB,EAAE,CAAA;AAI9B,yBAAyB;AACzB,UAAU,EAAE;IAAG,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE;AAQhD,sBAAsB;AACtB,UAAU,aAAa;IACrB,sBAAsB;IACtB,MAAM,EAAE,EAAE,EAAE,CAAA;IACZ,UAAU;IACV,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IAChE,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,oBAAoB;IACpB,IAAI,EAAE,UAAU,CAAA;CACjB;AAID;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAyB3D;AA6PD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,GACZ,aAAa,EAAE,CA+TjB;AA6DD,UAAU,YAAY;IACpB,eAAe;IACf,KAAK,EAAE,UAAU,CAAA;IACjB,iBAAiB;IACjB,KAAK,EAAE,UAAU,EAAE,CAAA;CACpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,YAAY,EAAE,CA6DvE;AAID;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;IACP,KAAK,EAAE,MAAM,CAAA;IACb,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,GACA,UAAU,CAqGZ"}