npm - @faicad/faijs - Versions diffs - 0.31.1 → 0.32.2 - Mend

@faicad/faijs 0.31.1 → 0.32.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1538) hide show

package/dist/api/generated/topology.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"topology.js","sourceRoot":"","sources":["../../../src/api/generated/topology.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n generated/topology.ts — 生成文件，勿手改。\n * 由 packages/core/scripts/gen-l3-surface.ts 依据 api/surface/arg-spec.ts 生成（E5/P14 分片）。\n * topology 模块：21 个投影符号；另有 281 个 skip 登记。\n * A6（2026-10-06）口径指认：本文件是 brepjs 投影面的增量清单；脚本面全集的\n * 权威来源是 generated/script-face.ts + gen-symbol-table 产物\n * lang/symbol-table.generated.ts（cad 脚本面 95 op）。两个清单回答不同问题，\n * 互不为超集——禁止用本文件的名字反推脚本面能力。\n /\nimport { defineOp } from '../../define-op'\nimport { brepOf } from '../../shape'\nimport { getBrepApi } from '../../brep/handle-bridge'\nimport type { BrepHandle } from '../../brep/engine/types'\nimport type { Shape } from '../../mesh/types'\nimport { torusBrep as __own_torusBrep } from '../brep-operations/primitiveFns'\nimport { fuseBrep as __own_fuseBrep } from '../brep-operations/booleanFns'\nimport { ellipsoidBrep as __own_ellipsoidBrep } from '../brep-operations/primitiveFns'\nimport { rotateBrep as __own_rotateBrep } from '../brep-operations/topologyFns'\nimport { mirrorBrep as __own_mirrorBrep } from '../brep-operations/topologyFns'\nimport { cloneBrep as __own_cloneBrep } from '../brep-operations/topologyFns'\nimport { applyMatrixBrep as __own_applyMatrixBrep } from '../brep-operations/topologyFns'\nimport { locateBrep as __own_locateBrep } from '../brep-operations/topologyFns'\nimport { sectionBrep as __own_sectionBrep } from '../brep-operations/booleanFns'\nimport { splitBrep as __own_splitBrep } from '../brep-operations/booleanFns'\nimport { shellBrep as __own_shellBrep } from '../brep-operations/topologyFns'\nimport { offsetBrep as __own_offsetBrep } from '../brep-operations/topologyFns'\nimport { healBrep as __own_healBrep } from '../brep-operations/healingFns'\nimport { simplifyBrep as __own_simplifyBrep } from '../brep-operations/healingFns'\nimport { autoHealBrep as __own_autoHealBrep } from '../brep-operations/healingFns'\nimport { fixShapeBrep as __own_fixShapeBrep } from '../brep-operations/healingFns'\nimport { healSolidBrep as __own_healSolidBrep } from '../brep-operations/healingFns'\nimport { fixSelfIntersectionBrep as __own_fixSelfIntersectionBrep } from '../brep-operations/healingFns'\n\n/\n torus — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * (majorRadius: number, minorRadius: number, options?: TorusOptions)\n * 桥接：defineOp({ brep: __own_torusBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const torus = defineOp({\n brep: __own_torusBrep,\n name: 'torus', naming: {\"kind\":\"unmodeled\",\"reason\":\"construct vocabulary pending Phase 3\"},\n})\n\n/\n fuse — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * (a: Shape3D, b: Shape3D, options?: BooleanOptions) -> Result<Shape3D>\n * 桥接：defineOp({ brep: __own_fuseBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const fuse = defineOp({\n brep: __own_fuseBrep,\n name: 'fuse', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, engines: [\"occt\"],\n})\n\n/\n getBounds — 查询（core，生成文件，勿手改；来源 api/surface/arg-spec.ts）。\n * (shape: Shape) -> BrepBoundingBox（core）\n * 桥接：getBrepApi().* 直连 occt 引擎（§5.5 第 2 条）——无来源实现中转。\n \n @param shape - 可形状参数（原样透传）\n * @returns { xmin: number; ymin: number; zmin: number; xmax: number; ymax: number; zmax: number } — 纯数据结果（非 Shape）。\n /\nexport function getBounds(shape: Shape): { xmin: number; ymin: number; zmin: number; xmax: number; ymax: number; zmax: number } {\n const h0 = brepOf(shape as Shape) as BrepHandle\n return getBrepApi().getBoundingBox(h0)\n}\n\n/\n ellipsoid — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * ellipsoid(rx: number, ry: number, rz: number, options?: EllipsoidOptions): Shape\n * 桥接：defineOp({ brep: __own_ellipsoidBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const ellipsoid = defineOp({\n brep: __own_ellipsoidBrep,\n name: 'ellipsoid', naming: {\"kind\":\"unmodeled\",\"reason\":\"construct vocabulary pending Phase 3\"},\n})\n\n/\n rotate — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * rotate(shape: Shape, angle: number, options?: { at?, axis? }): Shape\n * 桥接：defineOp({ brep: __own_rotateBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const rotate = defineOp({\n brep: __own_rotateBrep,\n name: 'rotate', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}},\n})\n\n/\n mirror — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * mirror(shape: Shape, options?: MirrorOptions): Shape\n * 桥接：defineOp({ brep: __own_mirrorBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const mirror = defineOp({\n brep: __own_mirrorBrep,\n name: 'mirror', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}},\n})\n\n/\n clone — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * clone(shape: Shape): Shape\n * 桥接：defineOp({ brep: __own_cloneBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const clone = defineOp({\n brep: __own_cloneBrep,\n name: 'clone', naming: {\"kind\":\"identity\"},\n})\n\n/\n applyMatrix — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * applyMatrix(shape: Shape, matrix: unknown): Shape\n * 桥接：defineOp({ brep: __own_applyMatrixBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const applyMatrix = defineOp({\n brep: __own_applyMatrixBrep,\n name: 'applyMatrix', naming: {\"kind\":\"identity\"},\n})\n\n/\n locate — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * locate(shape: Shape, placement: unknown): Shape\n * 桥接：defineOp({ brep: __own_locateBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const locate = defineOp({\n brep: __own_locateBrep,\n name: 'locate', naming: {\"kind\":\"identity\"}, engines: [\"occt\"],\n})\n\n/\n section — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * section(shape: Shape, plane: PlaneInput): Shape\n * 桥接：defineOp({ brep: __own_sectionBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const section = defineOp({\n brep: __own_sectionBrep,\n name: 'section', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}},\n})\n\n/\n split — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * split(shape: Shape, tools: Shape[]): Shape\n * 桥接：defineOp({ brep: __own_splitBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const split = defineOp({\n brep: __own_splitBrep,\n name: 'split', naming: {\"kind\":\"subdivide\"}, engines: [\"occt\"],\n})\n\n/\n shell — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * shell(shape: Shape, faces?: Shape[], thickness: number): Shape\n * 桥接：defineOp({ brep: __own_shellBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const shell = defineOp({\n brep: __own_shellBrep,\n name: 'shell', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, engines: [\"occt\"],\n})\n\n/\n offset — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * offset(shape: Shape, distance: number): Shape\n * 桥接：defineOp({ brep: __own_offsetBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const offset = defineOp({\n brep: __own_offsetBrep,\n name: 'offset', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, engines: [\"occt\"],\n})\n\n/\n heal — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * heal(shape: Shape): Shape\n * 桥接：defineOp({ brep: __own_healBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const heal = defineOp({\n brep: __own_healBrep,\n name: 'heal', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, engines: [\"occt\"],\n})\n\n/\n simplify — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * simplify(shape: Shape): Shape\n * 桥接：defineOp({ brep: __own_simplifyBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const simplify = defineOp({\n brep: __own_simplifyBrep,\n name: 'simplify', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, engines: [\"occt\"],\n})\n\n/\n isValid — 查询（core，生成文件，勿手改；来源 api/surface/arg-spec.ts）。\n * isValid(shape: Shape): boolean（core）\n * 桥接：getBrepApi().* 直连 occt 引擎（§5.5 第 2 条）——无来源实现中转。\n \n @param shape - 可形状参数（原样透传）\n * @returns boolean — 纯数据结果（非 Shape）。\n /\nexport function isValid(shape: Shape): boolean {\n const h0 = brepOf(shape as Shape) as BrepHandle\n return getBrepApi().isValid(h0)\n}\n\n/\n isSameShape — 查询（core，生成文件，勿手改；来源 api/surface/arg-spec.ts）。\n * isSameShape(a: Shape, b: Shape): boolean（core）\n * 桥接：getBrepApi().* 直连 occt 引擎（§5.5 第 2 条）——无来源实现中转。\n \n @param a - 可形状参数（第一个被比较形状）\n * @param b - 可形状参数（第二个被比较形状）\n * @returns boolean — 纯数据结果（非 Shape）。\n /\nexport function isSameShape(a: Shape, b: Shape): boolean {\n const h0 = brepOf(a as Shape) as BrepHandle\n const h1 = brepOf(b as Shape) as BrepHandle\n return getBrepApi().isSame(h0, h1)\n}\n\n/\n autoHeal — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * autoHeal(shape: Shape, options?: AutoHealOptions): { shape: Shape, report }\n * 桥接：defineOp({ brep: __own_autoHealBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const autoHeal = defineOp({\n brep: __own_autoHealBrep,\n name: 'autoHeal', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, engines: [\"occt\"], outputs: [\"shape\"],\n})\n\n/\n fixShape — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * fixShape(shape: Shape): Shape\n * 桥接：defineOp({ brep: __own_fixShapeBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const fixShape = defineOp({\n brep: __own_fixShapeBrep,\n name: 'fixShape', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}},\n})\n\n/\n healSolid — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * healSolid(solid: Shape): Shape\n * 桥接：defineOp({ brep: __own_healSolidBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const healSolid = defineOp({\n brep: __own_healSolidBrep,\n name: 'healSolid', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}},\n})\n\n/\n fixSelfIntersection — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * fixSelfIntersection(shape: Shape): Shape\n * 桥接：defineOp({ brep: __own_fixSelfIntersectionBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const fixSelfIntersection = defineOp({\n brep: __own_fixSelfIntersectionBrep,\n name: 'fixSelfIntersection', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, engines: [\"occt\"],\n})\n"]}
1	+ {"version":3,"file":"topology.js","sourceRoot":"","sources":["../../../src/api/generated/topology.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n generated/topology.ts — 生成文件，勿手改。\n * 由 packages/core/scripts/gen-l3-surface.ts 依据 api/surface/arg-spec.ts 生成（E5/P14 分片）。\n * topology 模块：21 个投影符号；另有 281 个 skip 登记。\n * A6（2026-10-06）口径指认：本文件是 brepjs 投影面的增量清单；脚本面全集的\n * 权威来源是 generated/script-face.ts + gen-symbol-table 产物\n * lang/symbol-table.generated.ts（cad 脚本面 95 op）。两个清单回答不同问题，\n * 互不为超集——禁止用本文件的名字反推脚本面能力。\n /\nimport { defineOp } from '../../define-op'\nimport { brepOf } from '../../shape'\nimport { getBrepApi } from '../../brep/handle-bridge'\nimport type { BrepHandle } from '../../brep/engine/types'\nimport type { Shape } from '../../mesh/types'\nimport { torusBrep as __own_torusBrep } from '../brep-operations/primitiveFns'\nimport { fuseBrep as __own_fuseBrep } from '../brep-operations/booleanFns'\nimport { ellipsoidBrep as __own_ellipsoidBrep } from '../brep-operations/primitiveFns'\nimport { rotateBrep as __own_rotateBrep } from '../brep-operations/topologyFns'\nimport { mirrorBrep as __own_mirrorBrep } from '../brep-operations/topologyFns'\nimport { cloneBrep as __own_cloneBrep } from '../brep-operations/topologyFns'\nimport { applyMatrixBrep as __own_applyMatrixBrep } from '../brep-operations/topologyFns'\nimport { locateBrep as __own_locateBrep } from '../brep-operations/topologyFns'\nimport { sectionBrep as __own_sectionBrep } from '../brep-operations/booleanFns'\nimport { splitBrep as __own_splitBrep } from '../brep-operations/booleanFns'\nimport { shellBrep as __own_shellBrep } from '../brep-operations/topologyFns'\nimport { offsetBrep as __own_offsetBrep } from '../brep-operations/topologyFns'\nimport { healBrep as __own_healBrep } from '../brep-operations/healingFns'\nimport { simplifyBrep as __own_simplifyBrep } from '../brep-operations/healingFns'\nimport { autoHealBrep as __own_autoHealBrep } from '../brep-operations/healingFns'\nimport { fixShapeBrep as __own_fixShapeBrep } from '../brep-operations/healingFns'\nimport { healSolidBrep as __own_healSolidBrep } from '../brep-operations/healingFns'\nimport { fixSelfIntersectionBrep as __own_fixSelfIntersectionBrep } from '../brep-operations/healingFns'\n\n/\n torus — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * (majorRadius: number, minorRadius: number, options?: TorusOptions)\n * 桥接：defineOp({ brep: __own_torusBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const torus = defineOp({\n brep: __own_torusBrep,\n name: 'torus', naming: {\"kind\":\"unmodeled\",\"reason\":\"construct vocabulary pending Phase 3\"}, paramDims: {},\n})\n\n/\n fuse — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * (a: Shape3D, b: Shape3D, options?: BooleanOptions) -> Result<Shape3D>\n * 桥接：defineOp({ brep: __own_fuseBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const fuse = defineOp({\n brep: __own_fuseBrep,\n name: 'fuse', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, engines: [\"occt\"], paramDims: {},\n})\n\n/\n getBounds — 查询（core，生成文件，勿手改；来源 api/surface/arg-spec.ts）。\n * (shape: Shape) -> BrepBoundingBox（core）\n * 桥接：getBrepApi().* 直连 occt 引擎（§5.5 第 2 条）——无来源实现中转。\n \n @param shape - 可形状参数（原样透传）\n * @returns { xmin: number; ymin: number; zmin: number; xmax: number; ymax: number; zmax: number } — 纯数据结果（非 Shape）。\n /\nexport function getBounds(shape: Shape): { xmin: number; ymin: number; zmin: number; xmax: number; ymax: number; zmax: number } {\n const h0 = brepOf(shape as Shape) as BrepHandle\n return getBrepApi().getBoundingBox(h0)\n}\n\n/\n ellipsoid — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * ellipsoid(rx: number, ry: number, rz: number, options?: EllipsoidOptions): Shape\n * 桥接：defineOp({ brep: __own_ellipsoidBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const ellipsoid = defineOp({\n brep: __own_ellipsoidBrep,\n name: 'ellipsoid', naming: {\"kind\":\"unmodeled\",\"reason\":\"construct vocabulary pending Phase 3\"}, paramDims: {},\n})\n\n/\n rotate — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * rotate(shape: Shape, angle: number, options?: { at?, axis? }): Shape\n * 桥接：defineOp({ brep: __own_rotateBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const rotate = defineOp({\n brep: __own_rotateBrep,\n name: 'rotate', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, paramDims: {},\n})\n\n/\n mirror — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * mirror(shape: Shape, options?: MirrorOptions): Shape\n * 桥接：defineOp({ brep: __own_mirrorBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const mirror = defineOp({\n brep: __own_mirrorBrep,\n name: 'mirror', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, paramDims: {},\n})\n\n/\n clone — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * clone(shape: Shape): Shape\n * 桥接：defineOp({ brep: __own_cloneBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const clone = defineOp({\n brep: __own_cloneBrep,\n name: 'clone', naming: {\"kind\":\"identity\"}, paramDims: {},\n})\n\n/\n applyMatrix — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * applyMatrix(shape: Shape, matrix: unknown): Shape\n * 桥接：defineOp({ brep: __own_applyMatrixBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const applyMatrix = defineOp({\n brep: __own_applyMatrixBrep,\n name: 'applyMatrix', naming: {\"kind\":\"identity\"}, paramDims: {},\n})\n\n/\n locate — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * locate(shape: Shape, placement: unknown): Shape\n * 桥接：defineOp({ brep: __own_locateBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const locate = defineOp({\n brep: __own_locateBrep,\n name: 'locate', naming: {\"kind\":\"identity\"}, engines: [\"occt\"], paramDims: {},\n})\n\n/\n section — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * section(shape: Shape, plane: PlaneInput): Shape\n * 桥接：defineOp({ brep: __own_sectionBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const section = defineOp({\n brep: __own_sectionBrep,\n name: 'section', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, paramDims: {},\n})\n\n/\n split — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * split(shape: Shape, tools: Shape[]): Shape\n * 桥接：defineOp({ brep: __own_splitBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const split = defineOp({\n brep: __own_splitBrep,\n name: 'split', naming: {\"kind\":\"subdivide\"}, engines: [\"occt\"], paramDims: {},\n})\n\n/\n shell — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * shell(shape: Shape, faces?: Shape[], thickness: number): Shape\n * 桥接：defineOp({ brep: __own_shellBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const shell = defineOp({\n brep: __own_shellBrep,\n name: 'shell', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, engines: [\"occt\"], paramDims: {},\n})\n\n/\n offset — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * offset(shape: Shape, distance: number): Shape\n * 桥接：defineOp({ brep: __own_offsetBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const offset = defineOp({\n brep: __own_offsetBrep,\n name: 'offset', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, engines: [\"occt\"], paramDims: {},\n})\n\n/\n heal — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * heal(shape: Shape): Shape\n * 桥接：defineOp({ brep: __own_healBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const heal = defineOp({\n brep: __own_healBrep,\n name: 'heal', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, engines: [\"occt\"], paramDims: {},\n})\n\n/\n simplify — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * simplify(shape: Shape): Shape\n * 桥接：defineOp({ brep: __own_simplifyBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const simplify = defineOp({\n brep: __own_simplifyBrep,\n name: 'simplify', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, engines: [\"occt\"], paramDims: {},\n})\n\n/\n isValid — 查询（core，生成文件，勿手改；来源 api/surface/arg-spec.ts）。\n * isValid(shape: Shape): boolean（core）\n * 桥接：getBrepApi().* 直连 occt 引擎（§5.5 第 2 条）——无来源实现中转。\n \n @param shape - 可形状参数（原样透传）\n * @returns boolean — 纯数据结果（非 Shape）。\n /\nexport function isValid(shape: Shape): boolean {\n const h0 = brepOf(shape as Shape) as BrepHandle\n return getBrepApi().isValid(h0)\n}\n\n/\n isSameShape — 查询（core，生成文件，勿手改；来源 api/surface/arg-spec.ts）。\n * isSameShape(a: Shape, b: Shape): boolean（core）\n * 桥接：getBrepApi().* 直连 occt 引擎（§5.5 第 2 条）——无来源实现中转。\n \n @param a - 可形状参数（第一个被比较形状）\n * @param b - 可形状参数（第二个被比较形状）\n * @returns boolean — 纯数据结果（非 Shape）。\n /\nexport function isSameShape(a: Shape, b: Shape): boolean {\n const h0 = brepOf(a as Shape) as BrepHandle\n const h1 = brepOf(b as Shape) as BrepHandle\n return getBrepApi().isSame(h0, h1)\n}\n\n/\n autoHeal — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * autoHeal(shape: Shape, options?: AutoHealOptions): { shape: Shape, report }\n * 桥接：defineOp({ brep: __own_autoHealBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const autoHeal = defineOp({\n brep: __own_autoHealBrep,\n name: 'autoHeal', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, engines: [\"occt\"], outputs: [\"shape\"], paramDims: {},\n})\n\n/\n fixShape — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * fixShape(shape: Shape): Shape\n * 桥接：defineOp({ brep: __own_fixShapeBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const fixShape = defineOp({\n brep: __own_fixShapeBrep,\n name: 'fixShape', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, paramDims: {},\n})\n\n/\n healSolid — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * healSolid(solid: Shape): Shape\n * 桥接：defineOp({ brep: __own_healSolidBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n /\nexport const healSolid = defineOp({\n brep: __own_healSolidBrep,\n name: 'healSolid', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, paramDims: {},\n})\n\n/\n fixSelfIntersection — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * fixSelfIntersection(shape: Shape): Shape\n * 桥接：defineOp({ brep: __own_fixSelfIntersectionBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const fixSelfIntersection = defineOp({\n brep: __own_fixSelfIntersectionBrep,\n name: 'fixSelfIntersection', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, engines: [\"occt\"], paramDims: {},\n})\n"]}

package/dist/api/helix.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"helix.d.ts","sourceRoot":"","sources":["../../src/api/helix.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAS1C,oDAAoD;AACpD,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,CAAA;AAE1C,sBAAsB;AACtB,MAAM,WAAW,YAAY;IAC3B,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,cAAc;IACd,KAAK,EAAE,MAAM,CAAA;IACb,yBAAyB;IACzB,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,gBAAgB;IAChB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AA4BD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,KAAK;;~~CAWhB~~,CAAA"}
1	+ {"version":3,"file":"helix.d.ts","sourceRoot":"","sources":["../../src/api/helix.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAS1C,oDAAoD;AACpD,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,CAAA;AAE1C,sBAAsB;AACtB,MAAM,WAAW,YAAY;IAC3B,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,cAAc;IACd,KAAK,EAAE,MAAM,CAAA;IACb,yBAAyB;IACzB,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,gBAAgB;IAChB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AA4BD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,KAAK;;CAahB,CAAA"}

package/dist/api/helix.js CHANGED Viewed

@@ -75,5 +75,6 @@ export const helix = defineOp({
     },
     engines: ['occt'],
     naming: { kind: 'unmodeled', reason: 'construct vocabulary pending Phase 3' },
+    paramDims: {},
 });
 //# sourceMappingURL=helix.js.map

package/dist/api/helix.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"helix.js","sourceRoot":"","sources":["../../src/api/helix.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAEjC,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAwBzD,4EAA4E;AAC5E,SAAS,SAAS,CAAC,IAAkB;IACnC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,IAAI,CAAA;IACrC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAA;IAC5E,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAA;IAChF,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAA;IACzE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAA;IACrC,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,8DAA8D,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACnG,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IACnC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IACvC,MAAM,MAAM,GAAG,KAAK,GAAG,KAAK,CAAA;IAC5B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAA;IAC3B,MAAM,IAAI,GAAG,aAAa,EAAE,CAAA;IAC5B,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAA;IACtD,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAA;IAChD,iDAAiD;IACjD,MAAM,MAAM,GAAG,CACb,MAAM,KAAK,MAAM;QACf,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC;QAC7D,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAC3B,CAAA;IAC1B,OAAO,aAAa,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;AACvE,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,QAAQ,CAAC;IAC5B,6DAA6D;IAC7D,iEAAiE;IACjE,oEAAoE;IACpE,mDAAmD;IACnD,IAAI,EAAE,OAAO;IACb,IAAI,CAAC,IAAkB;QACrB,OAAO,SAAS,CAAC,IAAI,CAAC,CAAA;IACxB,CAAC;IACD,OAAO,EAAE,CAAC,MAAM,CAAC;IACjB,MAAM,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,sCAAsC,EAAgB;~~CAC5F~~,CAAC,CAAA","sourcesContent":["/*\n api helix — 螺旋线（1D 曲线，平台 op engines:['occt']）\n \n @platform occt — 本文件 import occt-kernel：螺旋线用 `makeHelixWire` 构造\n * （occt-wasm 原生有，L1 无）。守卫 ① 要求平台 import 自证身份；调用方 op 声明\n * `engines: ['occt']` 由守卫 ② 校验。\n \n 用途：G-D 门控层的 1D 造线能力（Phase 3）。下游 sweep / loft 等可用螺旋线作 spine。\n \n 设计：\n * - 平台 op：occt 原生 makeHelixWire（occt-wasm 有，L1 无）→ 声明 engines:['occt']（D11）。\n * 实现直连平台原生方法，能力由引擎身份本身界定（无第二个声明轴）。\n * - 1D 产物：经 fromBrepCurve 登记，kind='curve'。\n * - 非 occt 引擎（brepkit）→ 执行前 BrepUnsupportedError（D11-4）；brep_mock 受 D11-3\n * 豁免不拦截（且 getOcctKernel 为全局 occt 实例，brep_mock 下仍可真实出线）。\n /\n\nimport type { Shape } from '../mesh/types'\nimport type { BrepHandle } from '../brep/engine/types'\nimport { solidToShape } from '../brep/brep-ops'\nimport { getBrepApi } from '../brep/handle-bridge'\nimport { fromBrepCurve } from '../shape'\nimport { defineOp } from '../sdk'\nimport type { Provenance } from '../topology/naming/lineage'\nimport { getOcctKernel } from '../occt-kernel/occtKernel'\n\n/* 螺旋手性：`'right'`（右手，逆时针上旋）或 `'left'`（左手，顺时针上旋）。 /\nexport type HelixHanded = 'right' \| 'left'\n\n/* `cad.helix` 参数。 /\nexport interface HelixOptions {\n /* 螺旋半径（mm，>0）。 /\n radius: number\n /* 螺距（mm，每圈沿轴的推进量，≠0）。 /\n pitch: number\n /* 圈数（>0）。 /\n turns: number\n /* 螺旋轴方向（单位向量，默认 +Z）。 /\n axis?: [number, number, number]\n /* 起点（默认原点）。 /\n origin?: [number, number, number]\n /\n 手性（默认 `'right'`）。同 pitch/height/radius 下左右旋互为镜像。\n * `'right'` 走 `makeHelixWire`，`'left'` 走 `makeHelixWireHanded(..., true)`。\n /\n handed?: HelixHanded\n}\n\n/* BREP 路径：用 occt 原生 makeHelixWire / makeHelixWireHanded 构造螺旋线，登记 1D 句柄。 /\nfunction helixBrep(opts: HelixOptions): Shape {\n const { radius, pitch, turns } = opts\n if (!(radius > 0)) throw new Error('E_HELIX_BAD_RADIUS: radius must be > 0')\n if (!(pitch !== 0)) throw new Error('E_HELIX_BAD_PITCH: pitch must be non-zero')\n if (!(turns > 0)) throw new Error('E_HELIX_BAD_TURNS: turns must be > 0')\n const handed = opts.handed ?? 'right'\n if (handed !== 'right' && handed !== 'left') {\n throw new Error(`E_HELIX_BAD_HANDED: handed must be 'right' or 'left' (got '${String(handed)}')`)\n }\n const axis = opts.axis ?? [0, 0, 1]\n const origin = opts.origin ?? [0, 0, 0]\n const height = pitch turns\n const kernel = getBrepApi()\n const occt = getOcctKernel()\n const o = { x: origin[0], y: origin[1], z: origin[2] }\n const a = { x: axis[0], y: axis[1], z: axis[2] }\n // 右手默认沿用 makeHelixWire（保持两个原生入口都可达）；左手走带手性的显式入口。\n const handle = (\n handed === 'left'\n ? occt.makeHelixWireHanded(o, a, pitch, height, radius, true)\n : occt.makeHelixWire(o, a, pitch, height, radius)\n ) as unknown as BrepHandle\n return fromBrepCurve(solidToShape(kernel, handle), { solid: handle })\n}\n\n/*\n 构造螺旋线（1D 曲线）。\n * @group 创建\n * @inputs 0\n * @async false\n * @qual ok\n * @name helix\n * @note 平台 op：仅 occt 引擎（原生 makeHelixWire / makeHelixWireHanded）。非 occt 引擎执行前报错；brep_mock 不拦截。\n * @returns Shape 1D 螺旋线（kind:'curve'）。\n * @param options.radius - 螺旋半径（mm，>0）。type:number required:true\n * @param options.pitch - 螺距（mm，≠0）。type:number required:true\n * @param options.turns - 圈数（>0）。type:number required:true\n * @param options.axis - 螺旋轴方向（默认 +Z）。type:Vec3 required:false\n * @param options.origin - 起点（默认原点）。type:Vec3 required:false\n * @param options.handed - 手性：'right'（默认）或 'left'。type:HelixHanded required:false\n * @example\n * const h = cad.helix({ radius: 5, pitch: 2, turns: 3 })\n * const lh = cad.helix({ radius: 5, pitch: 2, turns: 3, handed: 'left' })\n */\nexport const helix = defineOp({\n // name 必填：① 引擎门文案携带 op 名（`op 'helix' requires engine occt`，见\n // test/api/sweep-loft.test.ts GOTCHA-3 对该形态的要求）；② occt op 覆盖率扫描器\n // 的 op 全集只收 `export const X = defineOp({ name: '…' })`——缺 name 的 op\n // 不可见，其直调的 occt 方法（makeHelixWireHanded）会被误判为「未接入」。\n name: 'helix',\n brep(opts: HelixOptions) {\n return helixBrep(opts)\n },\n engines: ['occt'],\n naming: { kind: 'unmodeled', reason: 'construct vocabulary pending Phase 3' } as Provenance,\n})\n"]}
1	+ {"version":3,"file":"helix.js","sourceRoot":"","sources":["../../src/api/helix.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n api helix — 螺旋线（1D 曲线，平台 op engines:['occt']）\n \n @platform occt — 本文件 import occt-kernel：螺旋线用 `makeHelixWire` 构造\n * （occt-wasm 原生有，L1 无）。守卫 ① 要求平台 import 自证身份；调用方 op 声明\n * `engines: ['occt']` 由守卫 ② 校验。\n \n 用途：G-D 门控层的 1D 造线能力（Phase 3）。下游 sweep / loft 等可用螺旋线作 spine。\n \n 设计：\n * - 平台 op：occt 原生 makeHelixWire（occt-wasm 有，L1 无）→ 声明 engines:['occt']（D11）。\n * 实现直连平台原生方法，能力由引擎身份本身界定（无第二个声明轴）。\n * - 1D 产物：经 fromBrepCurve 登记，kind='curve'。\n * - 非 occt 引擎（brepkit）→ 执行前 BrepUnsupportedError（D11-4）；brep_mock 受 D11-3\n * 豁免不拦截（且 getOcctKernel 为全局 occt 实例，brep_mock 下仍可真实出线）。\n /\n\nimport type { Shape } from '../mesh/types'\nimport type { BrepHandle } from '../brep/engine/types'\nimport { solidToShape } from '../brep/brep-ops'\nimport { getBrepApi } from '../brep/handle-bridge'\nimport { fromBrepCurve } from '../shape'\nimport { defineOp } from '../sdk'\nimport type { Provenance } from '../topology/naming/lineage'\nimport { getOcctKernel } from '../occt-kernel/occtKernel'\n\n/* 螺旋手性：`'right'`（右手，逆时针上旋）或 `'left'`（左手，顺时针上旋）。 /\nexport type HelixHanded = 'right' \| 'left'\n\n/* `cad.helix` 参数。 /\nexport interface HelixOptions {\n /* 螺旋半径（mm，>0）。 /\n radius: number\n /* 螺距（mm，每圈沿轴的推进量，≠0）。 /\n pitch: number\n /* 圈数（>0）。 /\n turns: number\n /* 螺旋轴方向（单位向量，默认 +Z）。 /\n axis?: [number, number, number]\n /* 起点（默认原点）。 /\n origin?: [number, number, number]\n /\n 手性（默认 `'right'`）。同 pitch/height/radius 下左右旋互为镜像。\n * `'right'` 走 `makeHelixWire`，`'left'` 走 `makeHelixWireHanded(..., true)`。\n /\n handed?: HelixHanded\n}\n\n/* BREP 路径：用 occt 原生 makeHelixWire / makeHelixWireHanded 构造螺旋线，登记 1D 句柄。 /\nfunction helixBrep(opts: HelixOptions): Shape {\n const { radius, pitch, turns } = opts\n if (!(radius > 0)) throw new Error('E_HELIX_BAD_RADIUS: radius must be > 0')\n if (!(pitch !== 0)) throw new Error('E_HELIX_BAD_PITCH: pitch must be non-zero')\n if (!(turns > 0)) throw new Error('E_HELIX_BAD_TURNS: turns must be > 0')\n const handed = opts.handed ?? 'right'\n if (handed !== 'right' && handed !== 'left') {\n throw new Error(`E_HELIX_BAD_HANDED: handed must be 'right' or 'left' (got '${String(handed)}')`)\n }\n const axis = opts.axis ?? [0, 0, 1]\n const origin = opts.origin ?? [0, 0, 0]\n const height = pitch turns\n const kernel = getBrepApi()\n const occt = getOcctKernel()\n const o = { x: origin[0], y: origin[1], z: origin[2] }\n const a = { x: axis[0], y: axis[1], z: axis[2] }\n // 右手默认沿用 makeHelixWire（保持两个原生入口都可达）；左手走带手性的显式入口。\n const handle = (\n handed === 'left'\n ? occt.makeHelixWireHanded(o, a, pitch, height, radius, true)\n : occt.makeHelixWire(o, a, pitch, height, radius)\n ) as unknown as BrepHandle\n return fromBrepCurve(solidToShape(kernel, handle), { solid: handle })\n}\n\n/*\n 构造螺旋线（1D 曲线）。\n * @group 创建\n * @inputs 0\n * @async false\n * @qual ok\n * @name helix\n * @note 平台 op：仅 occt 引擎（原生 makeHelixWire / makeHelixWireHanded）。非 occt 引擎执行前报错；brep_mock 不拦截。\n * @returns Shape 1D 螺旋线（kind:'curve'）。\n * @param options.radius - 螺旋半径（mm，>0）。type:number required:true\n * @param options.pitch - 螺距（mm，≠0）。type:number required:true\n * @param options.turns - 圈数（>0）。type:number required:true\n * @param options.axis - 螺旋轴方向（默认 +Z）。type:Vec3 required:false\n * @param options.origin - 起点（默认原点）。type:Vec3 required:false\n * @param options.handed - 手性：'right'（默认）或 'left'。type:HelixHanded required:false\n * @example\n * const h = cad.helix({ radius: 5, pitch: 2, turns: 3 })\n * const lh = cad.helix({ radius: 5, pitch: 2, turns: 3, handed: 'left' })\n */\nexport const helix = defineOp({\n // name 必填：① 引擎门文案携带 op 名（`op 'helix' requires engine occt`，见\n // test/api/sweep-loft.test.ts GOTCHA-3 对该形态的要求）；② occt op 覆盖率扫描器\n // 的 op 全集只收 `export const X = defineOp({ name: '…' })`——缺 name 的 op\n // 不可见，其直调的 occt 方法（makeHelixWireHanded）会被误判为「未接入」。\n name: 'helix',\n brep(opts: HelixOptions) {\n return helixBrep(opts)\n },\n engines: ['occt'],\n naming: { kind: 'unmodeled', reason: 'construct vocabulary pending Phase 3' } as Provenance,\n\n paramDims: {},\n})\n"]}

package/dist/api/import-brep.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"import-brep.d.ts","sourceRoot":"","sources":["../../src/api/import-brep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAU1C;;;;;;;;;;;;;;;;;GAiBG;AACH;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CA2CpF;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW;;~~CAQtB~~,CAAA"}
1	+ {"version":3,"file":"import-brep.d.ts","sourceRoot":"","sources":["../../src/api/import-brep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAU1C;;;;;;;;;;;;;;;;;GAiBG;AACH;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CA2CpF;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW;;CAUtB,CAAA"}

package/dist/api/import-brep.js CHANGED Viewed

@@ -93,5 +93,6 @@ export const import_brep = defineOp({
     // 与上面 roleTable 的 `imported:${i}` 逐字对齐。不能写成 semantic 'imported'——
     // 它是结构 kind，出现在串首会被 parseRoleName 读成结构而非语义名（见 role-name.ts RESERVED_KEYWORDS）。
     naming: { kind: 'construct', newFaces: { via: 'explicit', vocab: [{ kind: 'imported', index: 0 }] } },
+    paramDims: {},
 });
 //# sourceMappingURL=import-brep.js.map

package/dist/api/import-brep.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"import-brep.js","sourceRoot":"","sources":["../../src/api/import-brep.ts"],"names":[],"mappings":"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~~CACpH~~,CAAC,CAAA","sourcesContent":["/*\n api import_brep — 平台 BREP 资产导入 op（H11 / 方案 §4.1）\n \n \n * 与编辑器 `cad.load`（`api/load.ts`）的区别见方案 §4.5：\n * - `cad.load` 是 ../3d_editor 的「文件导入 Feature」（key/path/url 三键分流、\n * 语句位置约定、partIndex 画布语义），且历史契约要求实体。\n * - `cad.import_brep` 是 faijs 平台几何 op：单一 asset 引用（容器资产名，\n * 去扩展名），语义是「把冻结的 BREP 载体装成持 OCCT 句柄的 Shape」。\n \n 非实体（wire/face/shell）一等公民（C6）：不要求实体，始终 allowNonSolid。\n * 需要实体的操作（布尔、up-to 目标面）在使用点报错（V-C8）。\n \n BREP 专属：`.brp` 无 mesh 解析器；mesh / 无内核模式抛 E_BREP_UNSUPPORTED。\n /\n\nimport type { Shape } from '../mesh/types'\nimport { getBackends, BrepUnsupportedError, getCurrentStmt } from '../runtime-state'\nimport { OpError } from './internal/result-unwrap'\nimport { loadBrep } from '../brep/brep-ops'\nimport { fromBrep } from '../shape'\nimport { defineOp } from '../sdk'\nimport type { Provenance } from '../topology/naming/lineage'\n\nimport type { BrepEngineApi } from '../brep/engine/primitives'\n\n/\n 平台 BREP 资产导入：把容器 `assets/` 里的冻结 BREP 载体装成持 OCCT 句柄的 Shape。\n \n `asset` = 资产名（去扩展名，沿用 `FsAssetResolver` 的 `key = basename(file)` 规则），\n * 由宿主资产解析器按 key 解析（与 `cad.load` 同套解析器）。\n \n @group 创建\n * @inputs 0\n * @async true\n * @qual ok\n * @name import_brep\n * @param params.asset - 容器资产名（去扩展名）。type:string required:true\n * @note 非实体一等（C6）：wire/face/shell 一律可导入，本 op 不设 `allowNonSolid` 一类开关。需要实体的 op（布尔、up-to 目标面）在使用点报错，而不是在导入点拒绝。\n * @note 这是平台资产导入 op。编辑器 `cad.load` 是 `../3d_editor` 的「文件导入 Feature」（key/path/url 三键分流 + 画布语句位置语义），平台侧不要复用它（C7）。\n * @returns Promise<Shape> 持 OCCT 句柄的几何（非实体亦可）。\n * @example\n * const a = await cad.import_brep({ asset: 'Array001.Shape' })\n /\n/\n 裸实现：契约层测试直调（不经 defineOp 的 dispatch 拦截）。\n \n @param params - op 参数对象；`asset` 为容器资产名（去扩展名）。\n * @returns 持 OCCT 句柄的几何（非实体亦可）。\n /\nexport async function importBrepImpl(params: Record<string, unknown>): Promise<Shape> {\n const assets = getBackends().assets as {\n resolveByKey?(key: string): Promise<{ bytes: ArrayBuffer }>\n } \| undefined\n if (!assets \|\| !assets.resolveByKey) {\n throw new OpError('import_brep', 'E_OP_FAILED', '[api/import_brep] assets backend is required')\n }\n\n const asset = params.asset\n if (typeof asset !== 'string' \|\| asset.length === 0) {\n throw new OpError('import_brep', 'E_ARGS', '[api/import_brep] asset name (string) is required')\n }\n\n const buffer = (await assets.resolveByKey(asset)).bytes\n\n const { kernel: kernels } = getBackends()\n const kernel = kernels.brep as BrepEngineApi \| null\n if (!kernel) {\n throw new BrepUnsupportedError(\n 'E_BREP_UNSUPPORTED: import_brep requires an OCCT kernel (.brp assets have no mesh parser)',\n )\n }\n\n // C6：非实体一等公民——始终允许导入 wire/face/shell（allowNonSolid=true）。\n const { solid: solidHandle, shape } = loadBrep(\n kernel, buffer, undefined, undefined, { allowNonSolid: true },\n )\n // E3（H12）：链根建 roleTable（与 primitives.ts 同源机制）——冻结资产是\n // 无名形状，没有这张表下游 edgeRef/faceRef 无法解析（nameless-shape 缺陷）。\n // Phase 1.6：origin 用导入语句的 StmtId——同一资产导入两次是两条语句，\n // 各自产出的面天然分属不同 origin（旧实现用资产名，两次导入撞 origin）。\n // 3.8: imported:<i> — imported faces have no semantic names (arbitrary geometry),\n // named by enumeration order in the imported file (stable across re-import of same file).\n const stmtId = String(getCurrentStmt()?.id ?? '')\n const hashes = kernel.subShapeHashes(solidHandle, 'face', 2147483647)\n const roles = new Map<string, number[]>()\n for (let i = 0; i < hashes.length; i++) {\n roles.set(`imported:${i}`, [hashes[i]!])\n }\n return fromBrep(shape, {\n solid: solidHandle,\n roleTable: new Map([[stmtId, roles]]),\n })\n}\n\n/\n GOTCHA（2026-09-30）：import_brep / import_step 必须经 defineOp 包装进入 cad\n * 命名空间，不能是裸 async 函数。part 键 roleTable（outputTablesByPart）只在\n * define-op.ts 包装层的 brep 分支登记（shape.ts attachBrep 只落语句键表，因为\n * fromBrep 时刻 shape 还没被 executor 命名）。裸函数产物没有 part 键表 → 下游\n * place 的 inputRoleTable（tableOfPart）拿到 undefined → place 产物 roleTable\n * 断流 → edgeRef 报 \"input shape has no role table (nameless shape)\"\n * （fcstd 语料 43 例，如 ISO4032_Hex_Nut_M10 的 chamfer(Pocket001__place)）。\n */\nexport const import_brep = defineOp({\n name: 'import_brep',\n brep: importBrepImpl,\n engines: ['occt'],\n // `imported:0` 是 <i> 采样值（同 extrude 的 `wall:0`）：实际产出 imported:0..n-1，\n // 与上面 roleTable 的 `imported:${i}` 逐字对齐。不能写成 semantic 'imported'——\n // 它是结构 kind，出现在串首会被 parseRoleName 读成结构而非语义名（见 role-name.ts RESERVED_KEYWORDS）。\n naming: { kind: 'construct', newFaces: { via: 'explicit', vocab: [{ kind: 'imported', index: 0 }] } } as Provenance,\n})\n"]}
1	+ {"version":3,"file":"import-brep.js","sourceRoot":"","sources":["../../src/api/import-brep.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n api import_brep — 平台 BREP 资产导入 op（H11 / 方案 §4.1）\n \n \n * 与编辑器 `cad.load`（`api/load.ts`）的区别见方案 §4.5：\n * - `cad.load` 是 ../3d_editor 的「文件导入 Feature」（key/path/url 三键分流、\n * 语句位置约定、partIndex 画布语义），且历史契约要求实体。\n * - `cad.import_brep` 是 faijs 平台几何 op：单一 asset 引用（容器资产名，\n * 去扩展名），语义是「把冻结的 BREP 载体装成持 OCCT 句柄的 Shape」。\n \n 非实体（wire/face/shell）一等公民（C6）：不要求实体，始终 allowNonSolid。\n * 需要实体的操作（布尔、up-to 目标面）在使用点报错（V-C8）。\n \n BREP 专属：`.brp` 无 mesh 解析器；mesh / 无内核模式抛 E_BREP_UNSUPPORTED。\n /\n\nimport type { Shape } from '../mesh/types'\nimport { getBackends, BrepUnsupportedError, getCurrentStmt } from '../runtime-state'\nimport { OpError } from './internal/result-unwrap'\nimport { loadBrep } from '../brep/brep-ops'\nimport { fromBrep } from '../shape'\nimport { defineOp } from '../sdk'\nimport type { Provenance } from '../topology/naming/lineage'\n\nimport type { BrepEngineApi } from '../brep/engine/primitives'\n\n/\n 平台 BREP 资产导入：把容器 `assets/` 里的冻结 BREP 载体装成持 OCCT 句柄的 Shape。\n \n `asset` = 资产名（去扩展名，沿用 `FsAssetResolver` 的 `key = basename(file)` 规则），\n * 由宿主资产解析器按 key 解析（与 `cad.load` 同套解析器）。\n \n @group 创建\n * @inputs 0\n * @async true\n * @qual ok\n * @name import_brep\n * @param params.asset - 容器资产名（去扩展名）。type:string required:true\n * @note 非实体一等（C6）：wire/face/shell 一律可导入，本 op 不设 `allowNonSolid` 一类开关。需要实体的 op（布尔、up-to 目标面）在使用点报错，而不是在导入点拒绝。\n * @note 这是平台资产导入 op。编辑器 `cad.load` 是 `../3d_editor` 的「文件导入 Feature」（key/path/url 三键分流 + 画布语句位置语义），平台侧不要复用它（C7）。\n * @returns Promise<Shape> 持 OCCT 句柄的几何（非实体亦可）。\n * @example\n * const a = await cad.import_brep({ asset: 'Array001.Shape' })\n /\n/\n 裸实现：契约层测试直调（不经 defineOp 的 dispatch 拦截）。\n \n @param params - op 参数对象；`asset` 为容器资产名（去扩展名）。\n * @returns 持 OCCT 句柄的几何（非实体亦可）。\n /\nexport async function importBrepImpl(params: Record<string, unknown>): Promise<Shape> {\n const assets = getBackends().assets as {\n resolveByKey?(key: string): Promise<{ bytes: ArrayBuffer }>\n } \| undefined\n if (!assets \|\| !assets.resolveByKey) {\n throw new OpError('import_brep', 'E_OP_FAILED', '[api/import_brep] assets backend is required')\n }\n\n const asset = params.asset\n if (typeof asset !== 'string' \|\| asset.length === 0) {\n throw new OpError('import_brep', 'E_ARGS', '[api/import_brep] asset name (string) is required')\n }\n\n const buffer = (await assets.resolveByKey(asset)).bytes\n\n const { kernel: kernels } = getBackends()\n const kernel = kernels.brep as BrepEngineApi \| null\n if (!kernel) {\n throw new BrepUnsupportedError(\n 'E_BREP_UNSUPPORTED: import_brep requires an OCCT kernel (.brp assets have no mesh parser)',\n )\n }\n\n // C6：非实体一等公民——始终允许导入 wire/face/shell（allowNonSolid=true）。\n const { solid: solidHandle, shape } = loadBrep(\n kernel, buffer, undefined, undefined, { allowNonSolid: true },\n )\n // E3（H12）：链根建 roleTable（与 primitives.ts 同源机制）——冻结资产是\n // 无名形状，没有这张表下游 edgeRef/faceRef 无法解析（nameless-shape 缺陷）。\n // Phase 1.6：origin 用导入语句的 StmtId——同一资产导入两次是两条语句，\n // 各自产出的面天然分属不同 origin（旧实现用资产名，两次导入撞 origin）。\n // 3.8: imported:<i> — imported faces have no semantic names (arbitrary geometry),\n // named by enumeration order in the imported file (stable across re-import of same file).\n const stmtId = String(getCurrentStmt()?.id ?? '')\n const hashes = kernel.subShapeHashes(solidHandle, 'face', 2147483647)\n const roles = new Map<string, number[]>()\n for (let i = 0; i < hashes.length; i++) {\n roles.set(`imported:${i}`, [hashes[i]!])\n }\n return fromBrep(shape, {\n solid: solidHandle,\n roleTable: new Map([[stmtId, roles]]),\n })\n}\n\n/\n GOTCHA（2026-09-30）：import_brep / import_step 必须经 defineOp 包装进入 cad\n * 命名空间，不能是裸 async 函数。part 键 roleTable（outputTablesByPart）只在\n * define-op.ts 包装层的 brep 分支登记（shape.ts attachBrep 只落语句键表，因为\n * fromBrep 时刻 shape 还没被 executor 命名）。裸函数产物没有 part 键表 → 下游\n * place 的 inputRoleTable（tableOfPart）拿到 undefined → place 产物 roleTable\n * 断流 → edgeRef 报 \"input shape has no role table (nameless shape)\"\n * （fcstd 语料 43 例，如 ISO4032_Hex_Nut_M10 的 chamfer(Pocket001__place)）。\n */\nexport const import_brep = defineOp({\n name: 'import_brep',\n brep: importBrepImpl,\n engines: ['occt'],\n // `imported:0` 是 <i> 采样值（同 extrude 的 `wall:0`）：实际产出 imported:0..n-1，\n // 与上面 roleTable 的 `imported:${i}` 逐字对齐。不能写成 semantic 'imported'——\n // 它是结构 kind，出现在串首会被 parseRoleName 读成结构而非语义名（见 role-name.ts RESERVED_KEYWORDS）。\n naming: { kind: 'construct', newFaces: { via: 'explicit', vocab: [{ kind: 'imported', index: 0 }] } } as Provenance,\n\n paramDims: {},\n})\n"]}

package/dist/api/import-step.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"import-step.d.ts","sourceRoot":"","sources":["../../src/api/import-step.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAwB1C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAkDpF;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW;;~~CAMtB~~,CAAA"}
1	+ {"version":3,"file":"import-step.d.ts","sourceRoot":"","sources":["../../src/api/import-step.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAwB1C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAkDpF;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW;;CAQtB,CAAA"}

package/dist/api/import-step.js CHANGED Viewed

@@ -105,5 +105,6 @@ export const import_step = defineOp({
     engines: ['occt'],
     // `imported:0` 是 <i> 采样值（同 extrude 的 `wall:0`），与 import-brep 同构。
     naming: { kind: 'construct', newFaces: { via: 'explicit', vocab: [{ kind: 'imported', index: 0 }] } },
+    paramDims: {},
 });
 //# sourceMappingURL=import-step.js.map

package/dist/api/import-step.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"import-step.js","sourceRoot":"","sources":["../../src/api/import-step.ts"],"names":[],"mappings":"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~~CACpH~~,CAAC,CAAA","sourcesContent":["import type { Shape } from '../mesh/types'\nimport { getBackends, BrepUnsupportedError, getCurrentStmt } from '../runtime-state'\nimport { getBrepApi } from '../brep/handle-bridge'\nimport { OpError } from './internal/result-unwrap'\nimport { loadBrep } from '../brep/brep-ops'\nimport { fromBrep } from '../shape'\nimport { defineOp } from '../sdk'\nimport type { Provenance } from '../topology/naming/lineage'\nimport type { BrepEngineApi } from '../brep/engine/primitives'\nimport { parseStepPartMeta } from '../step/stepMetaParser'\nimport type { ShapeMeta } from './meta'\n\n/** 尽力把 ArrayBuffer 当 UTF-8 文本解出；非文本（如 .brp 二进制）返回 undefined。 /\nfunction decodeStepText(buffer: ArrayBuffer): string \| undefined {\n if (!(buffer?.byteLength)) return undefined\n try {\n const s = new TextDecoder('utf-8', { fatal: false }).decode(buffer)\n // STEP 是纯文本 ISO-10303-21；首段要出现 `ISO-10303-21;` 才算。\n return s.includes('ISO-10303-21') ? s : undefined\n } catch {\n return undefined\n }\n}\n\n/\n api import_step — 任意路径 STEP 文件导入 op（方案 Phase 5 / Q2 真缺口）\n \n 与 `import_brep`（容器资产）和 `cad.load`（编辑器 FileRef）的职责切分：\n * - `cad.import_step` 是 faijs 平台几何 op：单一本地路径（宿主 `resolveFile`），\n * OCCT STEPControl_Reader 读入，返回持 OCCT 句柄 + roleTable 的 Shape。\n * - `import_brep` 读的是容器 `assets/` 里的冻结 BREP 资产（key，去扩展名）；\n * `cad.load` 是 `../3d_editor` 的「文件导入 Feature」（key/path/url 三键分流、\n * 画布语句位置语义），平台侧不要复用它（C7）。\n \n 非实体（wire/face/shell）一等公民（C6，对齐 import_brep）：始终 allowNonSolid。\n * STEP 是 BREP 专属格式：mesh / 无内核模式抛 E_BREP_UNSUPPORTED。\n \n @group 创建\n * @inputs 0\n * @async true\n * @qual ok\n * @name import_step\n * @param params.path - 本地绝对路径（宿主 resolveFile 解析）。type:string required:true\n * @note 平台 STEP 导入 op。读文件经宿主资产解析器（`assets.resolveFile`），与 `cad.load` 同一通道；语义为「任意路径 STEP → OCCT 读入的 Shape」。\n * @note 非实体一等（C6）：wire/face/shell 一律可导入。需要实体的 op（布尔、up-to 目标面）在使用点报错。\n * @returns Promise<Shape> 持 OCCT 句柄的几何（非实体亦可）。\n * @example\n * const a = await cad.import_step({ path: 'D:/models/box.step' })\n /\n\n/\n 裸实现：契约层测试直调（不经 defineOp 的 dispatch 拦截）。\n \n @param params - op 参数对象；`path` 为 STEP 文件路径。\n * @returns 持 OCCT 句柄的几何（非实体亦可）。\n /\nexport async function importStepImpl(params: Record<string, unknown>): Promise<Shape> {\n const path = params.path\n if (typeof path !== 'string' \|\| path.length === 0) {\n throw new OpError('import_step', 'E_ARGS', '[api/import_step] path (string) is required')\n }\n\n const assets = getBackends().assets as {\n resolveFile?(path: string): Promise<ArrayBuffer>\n } \| undefined\n if (!assets \|\| !assets.resolveFile) {\n throw new OpError(\n 'import_step',\n 'E_OP_FAILED',\n '[api/import_step] assets backend (resolveFile) is required',\n )\n }\n\n const buffer = await assets.resolveFile(path)\n\n let kernel: BrepEngineApi\n try { kernel = getBrepApi() } catch { throw new BrepUnsupportedError(\n 'E_BREP_UNSUPPORTED: import_step requires an OCCT kernel (STEP has no mesh parser)',\n )\n }\n\n // C6：非实体一等公民（对齐 import_brep）。loadBrep 自适应：CASCADE Topology\n // 文本走 kernel.fromBREP，其余（STEP/STP）走 kernel.importStep。\n const { solid: solidHandle, shape } = loadBrep(\n kernel, buffer, undefined, undefined, { allowNonSolid: true },\n )\n // P2（设计文档 2026-10-05-meta §5.2 读）：从 STEP (P21) 文本捞伙伴级描述/属性\n // 挂 `shape.meta`（name 已由 OCCT label 提供，description/UDA 由纯文本补充）。\n // 非文本/非 STEP 内容跳过，绝不抛。\n const stepText = decodeStepText(buffer)\n if (stepText && shape.meta == null) {\n const partMeta = parseStepPartMeta(stepText)\n const shapeMeta: ShapeMeta = { ...(shape.meta ?? {}) }\n if (partMeta.description) shapeMeta.description = partMeta.description\n if (partMeta.metadata && Object.keys(partMeta.metadata).length > 0) shapeMeta.metadata = partMeta.metadata\n if (Object.keys(shapeMeta).length > 0) shape.meta = shapeMeta\n }\n // E3（H12）：链根建 roleTable——导入文件的面没有语义名，按枚举序命名\n // imported:<i>（同一文件重复导入，枚举序稳定，role 名跨次导入保持一致）。\n const stmtId = String(getCurrentStmt()?.id ?? '')\n const hashes = kernel.subShapeHashes(solidHandle, 'face', 2147483647)\n const roles = new Map<string, number[]>()\n for (let i = 0; i < hashes.length; i++) {\n roles.set(`imported:${i}`, [hashes[i]!])\n }\n return fromBrep(shape, { solid: solidHandle, roleTable: new Map([[stmtId, roles]]) })\n}\n\n/\n GOTCHA（2026-09-30）：与 import_brep 同——必须经 defineOp 包装进入 cad 命名空间，\n * 不能是裸 async 函数。part 键 roleTable（outputTablesByPart）只在 define-op.ts\n * 包装层的 brep 分支登记；裸 async 函数产物没有 part 键表，下游 place/edgeRef\n * 报 \"input shape has no role table (nameless shape)\"。\n */\nexport const import_step = defineOp({\n name: 'import_step',\n brep: importStepImpl,\n engines: ['occt'],\n // `imported:0` 是 <i> 采样值（同 extrude 的 `wall:0`），与 import-brep 同构。\n naming: { kind: 'construct', newFaces: { via: 'explicit', vocab: [{ kind: 'imported', index: 0 }] } } as Provenance,\n})\n"]}
1	+ {"version":3,"file":"import-step.js","sourceRoot":"","sources":["../../src/api/import-step.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACpF,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAGjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAG1D,gEAAgE;AAChE,SAAS,cAAc,CAAC,MAAmB;IACzC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC;QAAE,OAAO,SAAS,CAAA;IAC3C,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QACnE,mDAAmD;QACnD,OAAO,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAA+B;IAClE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;IACxB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,OAAO,CAAC,aAAa,EAAE,QAAQ,EAAE,6CAA6C,CAAC,CAAA;IAC3F,CAAC;IAED,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC,MAEhB,CAAA;IACb,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QACnC,MAAM,IAAI,OAAO,CACf,aAAa,EACb,aAAa,EACb,4DAA4D,CAC7D,CAAA;IACH,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;IAE7C,IAAI,MAAqB,CAAA;IACzB,IAAI,CAAC;QAAC,MAAM,GAAG,UAAU,EAAE,CAAA;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,MAAM,IAAI,oBAAoB,CAChE,mFAAmF,CACpF,CAAA;IACH,CAAC;IAED,2DAA2D;IAC3D,uDAAuD;IACvD,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,QAAQ,CAC5C,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAC9D,CAAA;IACD,2DAA2D;IAC3D,gEAAgE;IAChE,uBAAuB;IACvB,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,CAAA;IACvC,IAAI,QAAQ,IAAI,KAAK,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAA;QAC5C,MAAM,SAAS,GAAc,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAA;QACtD,IAAI,QAAQ,CAAC,WAAW;YAAE,SAAS,CAAC,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAA;QACtE,IAAI,QAAQ,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAA;QAC1G,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,GAAG,SAAS,CAAA;IAC/D,CAAC;IACD,4CAA4C;IAC5C,+CAA+C;IAC/C,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;IACjD,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,CAAA;IACrE,MAAM,KAAK,GAAG,IAAI,GAAG,EAAoB,CAAA;IACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC,CAAA;IAC1C,CAAC;IACD,OAAO,QAAQ,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;AACvF,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC;IAClC,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,cAAc;IACpB,OAAO,EAAE,CAAC,MAAM,CAAC;IACjB,iEAAiE;IACjE,MAAM,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,EAAgB;IAEnH,SAAS,EAAE,EAAE;CACd,CAAC,CAAA","sourcesContent":["import type { Shape } from '../mesh/types'\nimport { getBackends, BrepUnsupportedError, getCurrentStmt } from '../runtime-state'\nimport { getBrepApi } from '../brep/handle-bridge'\nimport { OpError } from './internal/result-unwrap'\nimport { loadBrep } from '../brep/brep-ops'\nimport { fromBrep } from '../shape'\nimport { defineOp } from '../sdk'\nimport type { Provenance } from '../topology/naming/lineage'\nimport type { BrepEngineApi } from '../brep/engine/primitives'\nimport { parseStepPartMeta } from '../step/stepMetaParser'\nimport type { ShapeMeta } from './meta'\n\n/** 尽力把 ArrayBuffer 当 UTF-8 文本解出；非文本（如 .brp 二进制）返回 undefined。 /\nfunction decodeStepText(buffer: ArrayBuffer): string \| undefined {\n if (!(buffer?.byteLength)) return undefined\n try {\n const s = new TextDecoder('utf-8', { fatal: false }).decode(buffer)\n // STEP 是纯文本 ISO-10303-21；首段要出现 `ISO-10303-21;` 才算。\n return s.includes('ISO-10303-21') ? s : undefined\n } catch {\n return undefined\n }\n}\n\n/\n api import_step — 任意路径 STEP 文件导入 op（方案 Phase 5 / Q2 真缺口）\n \n 与 `import_brep`（容器资产）和 `cad.load`（编辑器 FileRef）的职责切分：\n * - `cad.import_step` 是 faijs 平台几何 op：单一本地路径（宿主 `resolveFile`），\n * OCCT STEPControl_Reader 读入，返回持 OCCT 句柄 + roleTable 的 Shape。\n * - `import_brep` 读的是容器 `assets/` 里的冻结 BREP 资产（key，去扩展名）；\n * `cad.load` 是 `../3d_editor` 的「文件导入 Feature」（key/path/url 三键分流、\n * 画布语句位置语义），平台侧不要复用它（C7）。\n \n 非实体（wire/face/shell）一等公民（C6，对齐 import_brep）：始终 allowNonSolid。\n * STEP 是 BREP 专属格式：mesh / 无内核模式抛 E_BREP_UNSUPPORTED。\n \n @group 创建\n * @inputs 0\n * @async true\n * @qual ok\n * @name import_step\n * @param params.path - 本地绝对路径（宿主 resolveFile 解析）。type:string required:true\n * @note 平台 STEP 导入 op。读文件经宿主资产解析器（`assets.resolveFile`），与 `cad.load` 同一通道；语义为「任意路径 STEP → OCCT 读入的 Shape」。\n * @note 非实体一等（C6）：wire/face/shell 一律可导入。需要实体的 op（布尔、up-to 目标面）在使用点报错。\n * @returns Promise<Shape> 持 OCCT 句柄的几何（非实体亦可）。\n * @example\n * const a = await cad.import_step({ path: 'D:/models/box.step' })\n /\n\n/\n 裸实现：契约层测试直调（不经 defineOp 的 dispatch 拦截）。\n \n @param params - op 参数对象；`path` 为 STEP 文件路径。\n * @returns 持 OCCT 句柄的几何（非实体亦可）。\n /\nexport async function importStepImpl(params: Record<string, unknown>): Promise<Shape> {\n const path = params.path\n if (typeof path !== 'string' \|\| path.length === 0) {\n throw new OpError('import_step', 'E_ARGS', '[api/import_step] path (string) is required')\n }\n\n const assets = getBackends().assets as {\n resolveFile?(path: string): Promise<ArrayBuffer>\n } \| undefined\n if (!assets \|\| !assets.resolveFile) {\n throw new OpError(\n 'import_step',\n 'E_OP_FAILED',\n '[api/import_step] assets backend (resolveFile) is required',\n )\n }\n\n const buffer = await assets.resolveFile(path)\n\n let kernel: BrepEngineApi\n try { kernel = getBrepApi() } catch { throw new BrepUnsupportedError(\n 'E_BREP_UNSUPPORTED: import_step requires an OCCT kernel (STEP has no mesh parser)',\n )\n }\n\n // C6：非实体一等公民（对齐 import_brep）。loadBrep 自适应：CASCADE Topology\n // 文本走 kernel.fromBREP，其余（STEP/STP）走 kernel.importStep。\n const { solid: solidHandle, shape } = loadBrep(\n kernel, buffer, undefined, undefined, { allowNonSolid: true },\n )\n // P2（设计文档 2026-10-05-meta §5.2 读）：从 STEP (P21) 文本捞伙伴级描述/属性\n // 挂 `shape.meta`（name 已由 OCCT label 提供，description/UDA 由纯文本补充）。\n // 非文本/非 STEP 内容跳过，绝不抛。\n const stepText = decodeStepText(buffer)\n if (stepText && shape.meta == null) {\n const partMeta = parseStepPartMeta(stepText)\n const shapeMeta: ShapeMeta = { ...(shape.meta ?? {}) }\n if (partMeta.description) shapeMeta.description = partMeta.description\n if (partMeta.metadata && Object.keys(partMeta.metadata).length > 0) shapeMeta.metadata = partMeta.metadata\n if (Object.keys(shapeMeta).length > 0) shape.meta = shapeMeta\n }\n // E3（H12）：链根建 roleTable——导入文件的面没有语义名，按枚举序命名\n // imported:<i>（同一文件重复导入，枚举序稳定，role 名跨次导入保持一致）。\n const stmtId = String(getCurrentStmt()?.id ?? '')\n const hashes = kernel.subShapeHashes(solidHandle, 'face', 2147483647)\n const roles = new Map<string, number[]>()\n for (let i = 0; i < hashes.length; i++) {\n roles.set(`imported:${i}`, [hashes[i]!])\n }\n return fromBrep(shape, { solid: solidHandle, roleTable: new Map([[stmtId, roles]]) })\n}\n\n/\n GOTCHA（2026-09-30）：与 import_brep 同——必须经 defineOp 包装进入 cad 命名空间，\n * 不能是裸 async 函数。part 键 roleTable（outputTablesByPart）只在 define-op.ts\n * 包装层的 brep 分支登记；裸 async 函数产物没有 part 键表，下游 place/edgeRef\n * 报 \"input shape has no role table (nameless shape)\"。\n */\nexport const import_step = defineOp({\n name: 'import_step',\n brep: importStepImpl,\n engines: ['occt'],\n // `imported:0` 是 <i> 采样值（同 extrude 的 `wall:0`），与 import-brep 同构。\n naming: { kind: 'construct', newFaces: { via: 'explicit', vocab: [{ kind: 'imported', index: 0 }] } } as Provenance,\n\n paramDims: {},\n})\n"]}

package/dist/api/index.d.ts CHANGED Viewed

@@ -25,13 +25,16 @@ export { profile, buildProfileShape, assertProfileParams } from './profile.js';
 export type { ProfileLineSeg, ProfileArcSeg, ProfileSeg, ProfileLoop, ProfileParams } from './profile.js';
 export { sketchOnPlane, buildSketchOnPlaneWith } from './sketch-on-plane.js';
 export { sketchOnFace, buildSketchOnFaceWith } from './sketch-on-face.js';
+export { sketchOnSurface, buildSketchOnSurfaceWith } from './sketch-on-surface.js';
 export { punchHole, buildPunchHole, punchSolidOf } from './punch-hole.js';
 export type { SketchOnPlaneParams, PlaneSpec } from './sketch-on-plane.js';
 export { wire } from './wire.js';
 export { helix } from './helix.js';
 export { split } from './split.js';
-export { sweep, type SweepOptions, type SweepOrientation, type SweepGuideContact, type SweepLawKind } from './sweep.js';
-export { loft } from './loft.js';
+export { sweep } from './sweep.js';
+export { sweepAdvanced, type SweepAdvancedOptions, type SweepOrientation, type SweepGuideContact, type SweepLawKind } from './sweep-advanced.js';
+export { loft, type LoftOptions } from './loft.js';
+export { loftAdvanced, type LoftAdvancedOptions } from './loft-advanced.js';
 export { surface, type SurfaceOptions } from './surface.js';
 export { offset2d, type Offset2DOptions, type Offset2DJoinType } from './offset2d.js';
 export { solidFromFaces, type SolidFromFacesParams } from './solid-from-faces.js';

package/dist/api/index.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AAQjE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AACrE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,KAAK,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAA;AACjD,OAAO,EAAE,KAAK,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAA;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,EAAE,mBAAmB,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACrI,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACxE,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAC9E,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAC3E,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACtG,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AACzE,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AACtE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AACtE,YAAY,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AACvE,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAC7B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAE,KAAK,EAAE,KAAK,~~YAAY~~,EAAE,KAAK,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,~~SAAS~~,CAAA;~~AACpH~~,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;~~AAE7B~~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"}
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"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"}

package/dist/api/index.js CHANGED Viewed

@@ -31,12 +31,15 @@ export { screw } from './screw.js';
 export { profile, buildProfileShape, assertProfileParams } from './profile.js';
 export { sketchOnPlane, buildSketchOnPlaneWith } from './sketch-on-plane.js';
 export { sketchOnFace, buildSketchOnFaceWith } from './sketch-on-face.js';
+export { sketchOnSurface, buildSketchOnSurfaceWith } from './sketch-on-surface.js';
 export { punchHole, buildPunchHole, punchSolidOf } from './punch-hole.js';
 export { wire } from './wire.js';
 export { helix } from './helix.js';
 export { split } from './split.js';
 export { sweep } from './sweep.js';
+export { sweepAdvanced } from './sweep-advanced.js';
 export { loft } from './loft.js';
+export { loftAdvanced } from './loft-advanced.js';
 // S3（occt-wasm op 接入）：控制点阵 → B 样条面（平台 op engines:['occt']）。
 export { surface } from './surface.js';
 // S3（occt-wasm op 接入）：2D 轮廓偏置 → 1D 轮廓（平台 op engines:['occt']）。

package/dist/api/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n L3 API 面（api/）— faijs 库函数命名空间\n \n 导出全部官方库函数、Shape 构造器与 schema 表。\n * 库函数签名 = .fai.js 源码里的调用形态（无隐式参数）；\n * 后端资源经 getBackends() 获取，保留声明经 keep() 表达。\n * 实现来源按 D11：mesh 侧复用 mesh/ 层，brep 侧复用既有 brep/ 层；\n * 缺失 brep 能力时经 D10 桥接调移植树 L2（见各 op 实现）。\n /\n\nexport { box, sphere, cylinder, cone, wedge } from './primitives'\n// `../3d_editor` 消费面（不是废弃项，措辞于 2026-09-22 校正）：transform 家族\n// （translate/rotate_euler/scale/scale3d）为编辑器应用提供（拖拽 / 时间线语句），\n// 不属 faijs 平台面，但服务真实负载。变更其 API 形态必须同步更新 `../3d_editor`；\n// 各 op 的 JSDoc 已带校正后的 @deprecated。\n//\n// D1（2026-09-23 扩展库拆分，选项 C）：四个 transform op 全部留 core——\n// `translate` 是通用几何变换且是小程序端唯一在用的 transform op，同族不拆散。\nexport { translate, rotate_euler, scale, scale3d } from './transform'\nexport { union, subtract, intersect, cut } from './boolean'\nexport { engrave } from './engrave'\nexport { chamfer } from './chamfer'\nexport { fillet } from './fillet'\nexport { shell, type ShellParams } from './shell'\nexport { draft, type DraftParams } from './draft'\nexport { thicken } from './thicken'\nexport { defeature, reverseShape, unifySameDomain, sew, sewAndSolidify, removeHolesFromFace, type SewParams } from './feature-repair'\nexport { filletVariable } from './fillet-variable'\nexport { splitByPlane, type SplitByPlaneParams } from './split-by-plane'\nexport { sectionByPlane, type SectionByPlaneParams } from './section-by-plane'\nexport { screw } from './screw'\nexport { profile, buildProfileShape, assertProfileParams } from './profile'\nexport type { ProfileLineSeg, ProfileArcSeg, ProfileSeg, ProfileLoop, ProfileParams } from './profile'\nexport { sketchOnPlane, buildSketchOnPlaneWith } from './sketch-on-plane'\nexport { sketchOnFace, buildSketchOnFaceWith } from './sketch-on-face'\nexport { punchHole, buildPunchHole, punchSolidOf } from './punch-hole'\nexport type { SketchOnPlaneParams, PlaneSpec } from './sketch-on-plane'\nexport { wire } from './wire'\nexport { helix } from './helix'\nexport { split } from './split'\nexport { sweep, type SweepOptions, type SweepOrientation, type SweepGuideContact, type SweepLawKind } from './sweep'\nexport { loft } from './loft'\n// S3（occt-wasm op 接入）：控制点阵 → B 样条面（平台 op engines:['occt']）。\nexport { surface, type SurfaceOptions } from './surface'\n// S3（occt-wasm op 接入）：2D 轮廓偏置 → 1D 轮廓（平台 op engines:['occt']）。\nexport { offset2d, type Offset2DOptions, type Offset2DJoinType } from './offset2d'\n// S3（occt-wasm op 接入）：面集一次成型为实体（平台 op engines:['occt']）。\nexport { solidFromFaces, type SolidFromFacesParams } from './solid-from-faces'\n// S3（occt-wasm op 接入）：无限半空间实体（平台 op engines:['occt']，作无界布尔工具）。\nexport { halfSpace, type HalfSpaceParams } from './half-space'\n// S3（occt-wasm op 接入）：导出族——STL（中立，纯数据序列化）/ BREP 文本（平台 op engines:['occt']）。\nexport { exportStl, type ExportStlOptions } from './export-stl'\nexport { exportBrep } from './export-brep'\n// S4（occt-wasm op 接入）：类型判定谓词族（平台 op engines:['occt']，布尔返回）。\n// 仅平铺不与 ../shape 既有 TS 守卫同名者；`isCompound` 与 ../shape#isCompound 同名，\n// 只在 cad 脚本面（api-namespace）暴露，避免本桶重复导出。\nexport { isEdge, isFace, isShell, isVertex, isWire, isCompSolid, isEqual } from './shape-type'\n// S4 视图与导出族（平台 op engines:['occt']，字符串/Uint8Array 返回）：平铺到 TS 桶。\nexport { toSVG, toMultiviewSVG, toPNG, toMultiviewPNG } from './view-export'\n// S4（occt-wasm op 接入）：曲线与草图构造族（平台 op engines:['occt']，方案 §3.4.1）。\nexport {\n edge, circleArc, ellipseEdge, ellipseArc, tangentArc,\n approximatePoints, interpolateWithTangents,\n curveDegreeElevate, curveKnotInsert, curveKnotRemove, curveIsPeriodic,\n} from './curve-sketch'\n// S4（occt-wasm op 接入）：曲面与面构造族（平台 op engines:['occt']，方案 §3.4.2）。\nexport { faceOnSurface, nonPlanarFace, makeSolid, reverseSurfaceU, outerWire } from './surface-face'\n// S4（occt-wasm op 接入）：实体与偏置族剩余（平台 op engines:['occt']，方案 §3.4.4）。\nexport { draftPrism, pipe } from './solid-offset'\n// S4（occt-wasm op 接入）：测量与查询族（平台 op engines:['occt']，方案 §3.4.6）。\nexport {\n containsPoint, distanceBetween, inertia, linearCenterOfMass,\n projectPointOnEdge, projectPointOnFace, classifyPointOnFace,\n uvFromPoint, vertexPosition, subShapeCount, iterShapes,\n liftCurve2d, commonCells,\n type SubShapeType,\n} from './measure-query'\n// S4（occt-wasm op 接入）：通用布尔族（方案 §3.4.5）。`boolean` 是 cad 面的名字\n// （`api-namespace.ts` 的键）；它此前在库里被整批平铺只是因为「导出面 ⊇ cad 面」\n// 门禁——该门禁已删（§2.7 / DEC-7），且库作者侧全仓无人 `import { boolean }`\n// （DEC-6），故库面只留自解释别名 `booleanOp`（指向同一 op）。\nexport {\n boolean as booleanOp,\n type BooleanKind, type BooleanOptions,\n} from './boolean-op'\n// S4（occt-wasm op 接入）：包围盒对齐族（方案 §3.4.9）。\nexport { alignTo, type AlignAxis, type AlignAnchor, type AlignOptions } from './align'\nexport { knurl } from './knurl'\nexport { sdf } from './sdf'\n// 应用变换（mesh 顶点烘焙）下沉到引擎侧 src/mesh/rigid-transform.ts（E-b：\n// 引擎不得 import api/compound；公共 API 经本 re-export 保持）。\nexport { applyTransform } from '../mesh/rigid-transform'\n// P2-f3：装配子层全量导出（solvePreview/entityFromGeometry 等经此到门面）。\n// A/B 组 op（fai_ / group / assembly / copy / load / text / svgExtrude）已迁出\n// core，见 @faicad/faijs-extra；装配求解器（solve/validate/joints/solvers）\n// 仍是平台能力，留在此处。\nexport * from './assembly'\n// ── H11：平台几何 op（方案 §4，替代 FCStd 迁移对编辑器 op 的借用）──\nexport { import_brep } from './import-brep'\nexport { import_step } from './import-step'\nexport { compound } from './compound-geom'\nexport { place } from './place'\nexport { faceNormal, bboxCenter, bboxMin, bboxMax } from './geom'\nexport { edgeRef } from './edge-ref'\nexport { faceRef } from './face-ref'\nexport { asset } from './asset'\nexport { solid, isShape, isCompound } from '../shape'\nexport { compound as structCompound } from '../shape'\nexport type { ShapeSlot, SolidShape, CompoundShape, CurveShape, StdShape, ShapeKind } from '../shape'\nexport type { Shape } from '../mesh/types'\n// PBR 外观规格（设计文档 2026-10-05 v2 §4.1）：类型供宿主/第三方消费；\n// 归一化/合并纯函数供编辑器映射（faijsAppearanceToHost）与导出复用。\nexport type { PbrAppearance, PbrColor, PbrAlphaMode, MaterialSpec, ShapeAppearanceMethods } from './appearance'\nexport { mergeAppearance, normalizeColor } from './appearance'\n// 零件/文件级说明性元数据（设计文档 2026-10-05-meta）：类型供宿主/第三方消费；\n// 合并纯函数供编辑器映射与导出复用。\nexport type { ShapeMeta, FileMeta, ShapeMetaMethods } from './meta'\nexport { mergeMeta } from './meta'\n\n// ── P23：脚本面 op 与库面导出面的边界（§2.7 / DEC-5、DEC-6、DEC-7）──\n//\n// ① 生成脚本面 op（与 api-namespace 的 cad 面同源：api/generated/script-face.ts）。\n// 这批 op 不再整批平铺进本桶：库面公开什么只看库的作者是否需要（DEC-6），\n// 脚本 op 是 `.fai.js` 的能力，库作者要的图形 / IO 函数走细粒度子路径\n// （docs/api-contract.zh.md:63、:70），「脚本面有」不构成「库面必须有」的理由。\n// 因此这里只按名保留有库作者消费者的脚本面 op（经 @faicad/faijs/api 被\n// sheetmetal 等导入者）；其余留在 `cad.` 脚本面与子路径，不经本聚合面。\nexport { fuse, isValid, rotate, applyMatrix } from './generated/script-face'\n// P25: compat extrude/revolve (brep-only, face→prism / face→lathe) share one\n// definition between the TS surface and the cad scripting surface. The fcstd\n// codegen wires Pad/Pocket/Extrusion/Revolution through these (sketch face →\n// cad.extrude / cad.revolve).\n// extrude 是平台手写 op（承载 upTo；长度形态委托生成投影）——见 api/extrude.ts；\n// revolve 仍直接取生成投影。\nexport { extrude } from './extrude'\nexport { revolve } from './generated/operations'\n//\n// ② 2026-09-25 core-decouple：brepjsCompat 命名空间与全部 op 投影随旧\n// 子包删除（§5.5 第 3 条，裁决 9）。此处只平铺无 op 语义的组合器与纯工具\n// （Result / 向量 / 平面 / 错误 / 常量），它们为 core 内联实现（§5.2），\n// 在两个面之间语义一致且无同名冲突。\nexport {\n ok, err, isOk, isErr, unwrap, unwrapOr,\n vecAdd, vecSub, vecScale, vecDot, vecCross, vecLength, vecNormalize,\n createPlane, createNamedPlane, resolvePlane,\n kernelError, validationError,\n DEG2RAD, RAD2DEG,\n} from './geom-types'\nexport type {\n Result, Ok, Err,\n BrepError,\n Plane, PlaneName, PlaneInput,\n Vec3, PointInput,\n} from './geom-types'\n// ── 2026-09-25 core-decouple：旧库建造工厂（makeExternalGear /\n// makeInternalGear / makePlanetaryGear / thread）与其句柄类型\n// （Vertex/Edge/…/Shape3D/ValidSolid/Bounds3D/Gear）随裁决 9 删除；\n// Result 组合器 map/andThen 为 core 内联（§5.2），保留平铺；\n// brepjsCompat 命名空间整体删除（§5.5 第 3 条）。\nexport { map, andThen } from './geom-types'\n// ── 2026-09-25 core-decouple wrapup §2.2：sheetmetal 拓扑查询 / 构造 / 测量\n// 出口（faijs 风格，裁决 3 补进公开导出）。isValid 不在此面——cad 脚本面\n// 已有同语义出口（见 brep-topology.ts 头部注释）。同步测量（measureVolume\n// / measureArea / measureLength）为 api/generated/measurement.ts 第一方\n// 同步版，一并平铺（cad 面的 volume/area/length 为 async 脚本面重命名）。\nexport * from './brep-topology'\n// CadQuery 拓扑选择器子系统（独立物理边界，与 topo-resolve 隔离）：\n// 等价搬运自 cq-compat，子路径直达 @faicad/faijs/api/cadquery-selectors。\nexport * from './cadquery-selectors'\nexport { measureVolume, measureArea, measureLength } from './generated/measurement'\n"]}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n L3 API 面（api/）— faijs 库函数命名空间\n \n 导出全部官方库函数、Shape 构造器与 schema 表。\n * 库函数签名 = .fai.js 源码里的调用形态（无隐式参数）；\n * 后端资源经 getBackends() 获取，保留声明经 keep() 表达。\n * 实现来源按 D11：mesh 侧复用 mesh/ 层，brep 侧复用既有 brep/ 层；\n * 缺失 brep 能力时经 D10 桥接调移植树 L2（见各 op 实现）。\n /\n\nexport { box, sphere, cylinder, cone, wedge } from './primitives'\n// `../3d_editor` 消费面（不是废弃项，措辞于 2026-09-22 校正）：transform 家族\n// （translate/rotate_euler/scale/scale3d）为编辑器应用提供（拖拽 / 时间线语句），\n// 不属 faijs 平台面，但服务真实负载。变更其 API 形态必须同步更新 `../3d_editor`；\n// 各 op 的 JSDoc 已带校正后的 @deprecated。\n//\n// D1（2026-09-23 扩展库拆分，选项 C）：四个 transform op 全部留 core——\n// `translate` 是通用几何变换且是小程序端唯一在用的 transform op，同族不拆散。\nexport { translate, rotate_euler, scale, scale3d } from './transform'\nexport { union, subtract, intersect, cut } from './boolean'\nexport { engrave } from './engrave'\nexport { chamfer } from './chamfer'\nexport { fillet } from './fillet'\nexport { shell, type ShellParams } from './shell'\nexport { draft, type DraftParams } from './draft'\nexport { thicken } from './thicken'\nexport { defeature, reverseShape, unifySameDomain, sew, sewAndSolidify, removeHolesFromFace, type SewParams } from './feature-repair'\nexport { filletVariable } from './fillet-variable'\nexport { splitByPlane, type SplitByPlaneParams } from './split-by-plane'\nexport { sectionByPlane, type SectionByPlaneParams } from './section-by-plane'\nexport { screw } from './screw'\nexport { profile, buildProfileShape, assertProfileParams } from './profile'\nexport type { ProfileLineSeg, ProfileArcSeg, ProfileSeg, ProfileLoop, ProfileParams } from './profile'\nexport { sketchOnPlane, buildSketchOnPlaneWith } from './sketch-on-plane'\nexport { sketchOnFace, buildSketchOnFaceWith } from './sketch-on-face'\nexport { sketchOnSurface, buildSketchOnSurfaceWith } from './sketch-on-surface'\nexport { punchHole, buildPunchHole, punchSolidOf } from './punch-hole'\nexport type { SketchOnPlaneParams, PlaneSpec } from './sketch-on-plane'\nexport { wire } from './wire'\nexport { helix } from './helix'\nexport { split } from './split'\nexport { sweep } from './sweep'\nexport { sweepAdvanced, type SweepAdvancedOptions, type SweepOrientation, type SweepGuideContact, type SweepLawKind } from './sweep-advanced'\nexport { loft, type LoftOptions } from './loft'\nexport { loftAdvanced, type LoftAdvancedOptions } from './loft-advanced'\n// S3（occt-wasm op 接入）：控制点阵 → B 样条面（平台 op engines:['occt']）。\nexport { surface, type SurfaceOptions } from './surface'\n// S3（occt-wasm op 接入）：2D 轮廓偏置 → 1D 轮廓（平台 op engines:['occt']）。\nexport { offset2d, type Offset2DOptions, type Offset2DJoinType } from './offset2d'\n// S3（occt-wasm op 接入）：面集一次成型为实体（平台 op engines:['occt']）。\nexport { solidFromFaces, type SolidFromFacesParams } from './solid-from-faces'\n// S3（occt-wasm op 接入）：无限半空间实体（平台 op engines:['occt']，作无界布尔工具）。\nexport { halfSpace, type HalfSpaceParams } from './half-space'\n// S3（occt-wasm op 接入）：导出族——STL（中立，纯数据序列化）/ BREP 文本（平台 op engines:['occt']）。\nexport { exportStl, type ExportStlOptions } from './export-stl'\nexport { exportBrep } from './export-brep'\n// S4（occt-wasm op 接入）：类型判定谓词族（平台 op engines:['occt']，布尔返回）。\n// 仅平铺不与 ../shape 既有 TS 守卫同名者；`isCompound` 与 ../shape#isCompound 同名，\n// 只在 cad 脚本面（api-namespace）暴露，避免本桶重复导出。\nexport { isEdge, isFace, isShell, isVertex, isWire, isCompSolid, isEqual } from './shape-type'\n// S4 视图与导出族（平台 op engines:['occt']，字符串/Uint8Array 返回）：平铺到 TS 桶。\nexport { toSVG, toMultiviewSVG, toPNG, toMultiviewPNG } from './view-export'\n// S4（occt-wasm op 接入）：曲线与草图构造族（平台 op engines:['occt']，方案 §3.4.1）。\nexport {\n edge, circleArc, ellipseEdge, ellipseArc, tangentArc,\n approximatePoints, interpolateWithTangents,\n curveDegreeElevate, curveKnotInsert, curveKnotRemove, curveIsPeriodic,\n} from './curve-sketch'\n// S4（occt-wasm op 接入）：曲面与面构造族（平台 op engines:['occt']，方案 §3.4.2）。\nexport { faceOnSurface, nonPlanarFace, makeSolid, reverseSurfaceU, outerWire } from './surface-face'\n// S4（occt-wasm op 接入）：实体与偏置族剩余（平台 op engines:['occt']，方案 §3.4.4）。\nexport { draftPrism, pipe } from './solid-offset'\n// S4（occt-wasm op 接入）：测量与查询族（平台 op engines:['occt']，方案 §3.4.6）。\nexport {\n containsPoint, distanceBetween, inertia, linearCenterOfMass,\n projectPointOnEdge, projectPointOnFace, classifyPointOnFace,\n uvFromPoint, vertexPosition, subShapeCount, iterShapes,\n liftCurve2d, commonCells,\n type SubShapeType,\n} from './measure-query'\n// S4（occt-wasm op 接入）：通用布尔族（方案 §3.4.5）。`boolean` 是 cad 面的名字\n// （`api-namespace.ts` 的键）；它此前在库里被整批平铺只是因为「导出面 ⊇ cad 面」\n// 门禁——该门禁已删（§2.7 / DEC-7），且库作者侧全仓无人 `import { boolean }`\n// （DEC-6），故库面只留自解释别名 `booleanOp`（指向同一 op）。\nexport {\n boolean as booleanOp,\n type BooleanKind, type BooleanOptions,\n} from './boolean-op'\n// S4（occt-wasm op 接入）：包围盒对齐族（方案 §3.4.9）。\nexport { alignTo, type AlignAxis, type AlignAnchor, type AlignOptions } from './align'\nexport { knurl } from './knurl'\nexport { sdf } from './sdf'\n// 应用变换（mesh 顶点烘焙）下沉到引擎侧 src/mesh/rigid-transform.ts（E-b：\n// 引擎不得 import api/compound；公共 API 经本 re-export 保持）。\nexport { applyTransform } from '../mesh/rigid-transform'\n// P2-f3：装配子层全量导出（solvePreview/entityFromGeometry 等经此到门面）。\n// A/B 组 op（fai_ / group / assembly / copy / load / text / svgExtrude）已迁出\n// core，见 @faicad/faijs-extra；装配求解器（solve/validate/joints/solvers）\n// 仍是平台能力，留在此处。\nexport * from './assembly'\n// ── H11：平台几何 op（方案 §4，替代 FCStd 迁移对编辑器 op 的借用）──\nexport { import_brep } from './import-brep'\nexport { import_step } from './import-step'\nexport { compound } from './compound-geom'\nexport { place } from './place'\nexport { faceNormal, bboxCenter, bboxMin, bboxMax } from './geom'\nexport { edgeRef } from './edge-ref'\nexport { faceRef } from './face-ref'\nexport { asset } from './asset'\nexport { solid, isShape, isCompound } from '../shape'\nexport { compound as structCompound } from '../shape'\nexport type { ShapeSlot, SolidShape, CompoundShape, CurveShape, StdShape, ShapeKind } from '../shape'\nexport type { Shape } from '../mesh/types'\n// PBR 外观规格（设计文档 2026-10-05 v2 §4.1）：类型供宿主/第三方消费；\n// 归一化/合并纯函数供编辑器映射（faijsAppearanceToHost）与导出复用。\nexport type { PbrAppearance, PbrColor, PbrAlphaMode, MaterialSpec, ShapeAppearanceMethods } from './appearance'\nexport { mergeAppearance, normalizeColor } from './appearance'\n// 零件/文件级说明性元数据（设计文档 2026-10-05-meta）：类型供宿主/第三方消费；\n// 合并纯函数供编辑器映射与导出复用。\nexport type { ShapeMeta, FileMeta, ShapeMetaMethods } from './meta'\nexport { mergeMeta } from './meta'\n\n// ── P23：脚本面 op 与库面导出面的边界（§2.7 / DEC-5、DEC-6、DEC-7）──\n//\n// ① 生成脚本面 op（与 api-namespace 的 cad 面同源：api/generated/script-face.ts）。\n// 这批 op 不再整批平铺进本桶：库面公开什么只看库的作者是否需要（DEC-6），\n// 脚本 op 是 `.fai.js` 的能力，库作者要的图形 / IO 函数走细粒度子路径\n// （docs/api-contract.zh.md:63、:70），「脚本面有」不构成「库面必须有」的理由。\n// 因此这里只按名保留有库作者消费者的脚本面 op（经 @faicad/faijs/api 被\n// sheetmetal 等导入者）；其余留在 `cad.` 脚本面与子路径，不经本聚合面。\nexport { fuse, isValid, rotate, applyMatrix } from './generated/script-face'\n// P25: compat extrude/revolve (brep-only, face→prism / face→lathe) share one\n// definition between the TS surface and the cad scripting surface. The fcstd\n// codegen wires Pad/Pocket/Extrusion/Revolution through these (sketch face →\n// cad.extrude / cad.revolve).\n// extrude 是平台手写 op（承载 upTo；长度形态委托生成投影）——见 api/extrude.ts；\n// revolve 仍直接取生成投影。\nexport { extrude } from './extrude'\nexport { revolve } from './generated/operations'\n//\n// ② 2026-09-25 core-decouple：brepjsCompat 命名空间与全部 op 投影随旧\n// 子包删除（§5.5 第 3 条，裁决 9）。此处只平铺无 op 语义的组合器与纯工具\n// （Result / 向量 / 平面 / 错误 / 常量），它们为 core 内联实现（§5.2），\n// 在两个面之间语义一致且无同名冲突。\nexport {\n ok, err, isOk, isErr, unwrap, unwrapOr,\n vecAdd, vecSub, vecScale, vecDot, vecCross, vecLength, vecNormalize,\n createPlane, createNamedPlane, resolvePlane,\n kernelError, validationError,\n DEG2RAD, RAD2DEG,\n} from './geom-types'\nexport type {\n Result, Ok, Err,\n BrepError,\n Plane, PlaneName, PlaneInput,\n Vec3, PointInput,\n} from './geom-types'\n// ── 2026-09-25 core-decouple：旧库建造工厂（makeExternalGear /\n// makeInternalGear / makePlanetaryGear / thread）与其句柄类型\n// （Vertex/Edge/…/Shape3D/ValidSolid/Bounds3D/Gear）随裁决 9 删除；\n// Result 组合器 map/andThen 为 core 内联（§5.2），保留平铺；\n// brepjsCompat 命名空间整体删除（§5.5 第 3 条）。\nexport { map, andThen } from './geom-types'\n// ── 2026-09-25 core-decouple wrapup §2.2：sheetmetal 拓扑查询 / 构造 / 测量\n// 出口（faijs 风格，裁决 3 补进公开导出）。isValid 不在此面——cad 脚本面\n// 已有同语义出口（见 brep-topology.ts 头部注释）。同步测量（measureVolume\n// / measureArea / measureLength）为 api/generated/measurement.ts 第一方\n// 同步版，一并平铺（cad 面的 volume/area/length 为 async 脚本面重命名）。\nexport * from './brep-topology'\n// CadQuery 拓扑选择器子系统（独立物理边界，与 topo-resolve 隔离）：\n// 等价搬运自 cq-compat，子路径直达 @faicad/faijs/api/cadquery-selectors。\nexport * from './cadquery-selectors'\nexport { measureVolume, measureArea, measureLength } from './generated/measurement'\n"]}

package/dist/api/loft-advanced.d.ts ADDED Viewed

@@ -0,0 +1,66 @@
+/**
+ * api loft-advanced — 放样（完整语义）：occt 平台 op。
+ *
+ * 为什么与基础 `loft` 拆成两个 op（方案 2026-10-10-sweep-loft-dual-engine-plan
+ * §3 总览 / §6）：基础 `loft` 进 L1（两内核都要支持），选项集必须等于**两内核
+ * 交集**；而本 op 承载的 `startPoint`（起点退化到点的蒙皮）与 `tolerance`
+ * （ThruSections 缝合公差）在 brepkit 没有对应能力（brepkit 的 `loftWithOptions`
+ * 只有 endPoint / ruled）。留在基础 op 上会造成语义分叉 —— 故上移到本 op
+ * （与 `sketchOnFace → sketchOnSurface` 同构）。
+ *
+ * 实现走 core 直连 occt `loft` / `loftWithVertices`（`BRepOffsetAPI_ThruSections`），
+ * 产物经 `fromBrep` 收养。
+ */
+import type { Shape } from '../mesh/types.js';
+/** 放样完整配置（occt 平台 op）。 */
+export interface LoftAdvancedOptions {
+    /** 直线插值（ruled）。默认 true。 */
+    ruled?: boolean;
+    /** 起点（退化到点的蒙皮）。 */
+    startPoint?: readonly [number, number, number] | {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /** 终点（退化到点的蒙皮）。 */
+    endPoint?: readonly [number, number, number] | {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /** ThruSections 缝合公差。默认 1e-6。 */
+    tolerance?: number;
+}
+/**
+ * 放样（完整语义）：按给定顺序在截面之间蒙皮生成体。
+ * @group 特征
+ * @inputs 2
+ * @async true
+ * @qual ok
+ * @name loftAdvanced
+ * @note 平台 op：仅 occt 引擎（BRepOffsetAPI_ThruSections）。截面可为 wire 或面
+ *       （面取其外环），至少 2 个；`startPoint` / `endPoint` 可做退化到点的蒙皮；
+ *       `tolerance` 控制缝合公差。非 occt 引擎执行前报错；brep_mock 不拦截。
+ *       基础放样（两内核交集）用 `cad.loft`。不做 `loftAll`（数组产物）。
+ * @returns Shape 放样体。
+ * @param sections - 有序截面集合（wire 或面；面取其外环）。type:Shape[] required:true
+ * @param opts - 放样完整配置（ruled / startPoint / endPoint / tolerance）。type:LoftAdvancedOptions required:false
+ * @example
+ * const bottom = cad.profile({ contours: [{ segments: [
+ *   { kind: 'line', x1: -5, y1: -5, x2: 5, y2: -5 },
+ *   { kind: 'line', x1: 5, y1: -5, x2: 5, y2: 5 },
+ *   { kind: 'line', x1: 5, y1: 5, x2: -5, y2: 5 },
+ *   { kind: 'line', x1: -5, y1: 5, x2: -5, y2: -5 },
+ * ] }] })
+ * const top = cad.translate(cad.profile({ contours: [{ segments: [
+ *   { kind: 'line', x1: -3, y1: -3, x2: 3, y2: -3 },
+ *   { kind: 'line', x1: 3, y1: -3, x2: 3, y2: 3 },
+ *   { kind: 'line', x1: 3, y1: 3, x2: -3, y2: 3 },
+ *   { kind: 'line', x1: -3, y1: 3, x2: -3, y2: -3 },
+ * ] }] }), [0, 0, 20])
+ * const body = await cad.loftAdvanced([bottom, top], { endPoint: [0, 0, 30] })
+ */
+export declare const loftAdvanced: ((sections: Shape[], opts?: LoftAdvancedOptions | undefined) => Promise<Shape>) & {
+    __faijs__dualOp?: import("../define-op.js").DualOpMeta;
+};
+//# sourceMappingURL=loft-advanced.d.ts.map

package/dist/api/loft-advanced.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"loft-advanced.d.ts","sourceRoot":"","sources":["../../src/api/loft-advanced.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAU1C,0BAA0B;AAC1B,MAAM,WAAW,mBAAmB;IAClC,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,mBAAmB;IACnB,UAAU,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACpF,mBAAmB;IACnB,QAAQ,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAClF,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAiDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,YAAY;;CASvB,CAAA"}

package/dist/api/loft-advanced.js ADDED Viewed

@@ -0,0 +1,112 @@
+/**
+ * api loft-advanced — 放样（完整语义）：occt 平台 op。
+ *
+ * 为什么与基础 `loft` 拆成两个 op（方案 2026-10-10-sweep-loft-dual-engine-plan
+ * §3 总览 / §6）：基础 `loft` 进 L1（两内核都要支持），选项集必须等于**两内核
+ * 交集**；而本 op 承载的 `startPoint`（起点退化到点的蒙皮）与 `tolerance`
+ * （ThruSections 缝合公差）在 brepkit 没有对应能力（brepkit 的 `loftWithOptions`
+ * 只有 endPoint / ruled）。留在基础 op 上会造成语义分叉 —— 故上移到本 op
+ * （与 `sketchOnFace → sketchOnSurface` 同构）。
+ *
+ * 实现走 core 直连 occt `loft` / `loftWithVertices`（`BRepOffsetAPI_ThruSections`），
+ * 产物经 `fromBrep` 收养。
+ */
+import { defineOp } from '../sdk.js';
+import { getBrepApi } from '../brep/handle-bridge.js';
+import { fromBrep } from '../shape.js';
+import { solidToShape } from '../brep/brep-ops.js';
+import { getOcctKernel } from '../occt-kernel/occtKernel.js';
+import { toProfileWireView } from './internal/profile-wire.js';
+/** PointInput → [x,y,z]（旧 toVec3 同口径）。 */
+function toVec3(p) {
+    if (Array.isArray(p) && p.length >= 3)
+        return [p[0], p[1], p[2]];
+    const o = p;
+    return [o.x, o.y, o.z];
+}
+/** BREP 路径：按序蒙皮各截面（wire 视图 → occt-wasm 直连 → fromBrep 收养）。 */
+function loftAdvancedBrep(sections, opts) {
+    if (!Array.isArray(sections) || sections.length === 0) {
+        throw new Error('E_LOFT_NO_SECTIONS: loft requires a non-empty array of section shapes');
+    }
+    // 每截面：wire 直用；面取外环（孔环不参与放样）。
+    const wireViews = sections.map((s) => toProfileWireView(s));
+    const { ruled = true, startPoint, endPoint } = opts ?? {};
+    const kernel = getBrepApi();
+    const k = getOcctKernel();
+    const wireHandles = wireViews.map((w) => w.wrapped);
+    try {
+        let h;
+        if (startPoint !== undefined || endPoint !== undefined) {
+            const startVertex = startPoint !== undefined ? k.makeVertex(...toVec3(startPoint)) : undefined;
+            const endVertex = endPoint !== undefined ? k.makeVertex(...toVec3(endPoint)) : undefined;
+            try {
+                h = k.loftWithVertices(wireHandles, true, ruled, startVertex, endVertex);
+            }
+            finally {
+                if (startVertex !== undefined)
+                    k.release(startVertex);
+                if (endVertex !== undefined)
+                    k.release(endVertex);
+            }
+        }
+        else {
+            h = k.loft(wireHandles, true, ruled);
+        }
+        return fromBrep(solidToShape(kernel, h), { solid: h });
+    }
+    catch (e) {
+        const raw = e instanceof Error ? e.message : String(e);
+        throw new Error(`E_LOFT_FAILED: loft failed: ${raw}`, { cause: e });
+    }
+    finally {
+        // 面→外环产出的 wire 是 arena 新句柄（曲线借用不 release）
+        for (const w of wireViews) {
+            if (!w.borrowed) {
+                try {
+                    kernel.release(w.wrapped);
+                }
+                catch { /* 已释放 */ }
+            }
+        }
+    }
+}
+/**
+ * 放样（完整语义）：按给定顺序在截面之间蒙皮生成体。
+ * @group 特征
+ * @inputs 2
+ * @async true
+ * @qual ok
+ * @name loftAdvanced
+ * @note 平台 op：仅 occt 引擎（BRepOffsetAPI_ThruSections）。截面可为 wire 或面
+ *       （面取其外环），至少 2 个；`startPoint` / `endPoint` 可做退化到点的蒙皮；
+ *       `tolerance` 控制缝合公差。非 occt 引擎执行前报错；brep_mock 不拦截。
+ *       基础放样（两内核交集）用 `cad.loft`。不做 `loftAll`（数组产物）。
+ * @returns Shape 放样体。
+ * @param sections - 有序截面集合（wire 或面；面取其外环）。type:Shape[] required:true
+ * @param opts - 放样完整配置（ruled / startPoint / endPoint / tolerance）。type:LoftAdvancedOptions required:false
+ * @example
+ * const bottom = cad.profile({ contours: [{ segments: [
+ *   { kind: 'line', x1: -5, y1: -5, x2: 5, y2: -5 },
+ *   { kind: 'line', x1: 5, y1: -5, x2: 5, y2: 5 },
+ *   { kind: 'line', x1: 5, y1: 5, x2: -5, y2: 5 },
+ *   { kind: 'line', x1: -5, y1: 5, x2: -5, y2: -5 },
+ * ] }] })
+ * const top = cad.translate(cad.profile({ contours: [{ segments: [
+ *   { kind: 'line', x1: -3, y1: -3, x2: 3, y2: -3 },
+ *   { kind: 'line', x1: 3, y1: -3, x2: 3, y2: 3 },
+ *   { kind: 'line', x1: 3, y1: 3, x2: -3, y2: 3 },
+ *   { kind: 'line', x1: -3, y1: 3, x2: -3, y2: -3 },
+ * ] }] }), [0, 0, 20])
+ * const body = await cad.loftAdvanced([bottom, top], { endPoint: [0, 0, 30] })
+ */
+export const loftAdvanced = defineOp({
+    name: 'loftAdvanced',
+    brep(sections, opts) {
+        return loftAdvancedBrep(sections, opts);
+    },
+    engines: ['occt'],
+    naming: { kind: 'unmodeled', reason: 'lofted-body face vocabulary not defined' },
+    paramDims: {},
+});
+//# sourceMappingURL=loft-advanced.js.map