@faicad/faijs 0.16.1 → 0.18.0

package/dist/api/view/projectionPlanes.js

@@ -0,0 +1,30 @@
+/**
+ * Shared projection plane definitions used by cameraFns（faijs 视图投影，路径 A）。
+ *
+ * 第一方模块（2026-09-25 core-decouple Phase 1）：复制自 brepjs
+ * `src/projection/projectionPlanes.ts`（同源复制，签名不变）。
+ */
+/** Lookup table mapping each {@link ProjectionPlane} to its camera configuration. */
+export const PROJECTION_PLANES = {
+    XY: { dir: [0, 0, 1], xAxis: [1, 0, 0] },
+    XZ: { dir: [0, -1, 0], xAxis: [1, 0, 0] },
+    YZ: { dir: [1, 0, 0], xAxis: [0, 1, 0] },
+    YX: { dir: [0, 0, -1], xAxis: [0, 1, 0] },
+    ZX: { dir: [0, 1, 0], xAxis: [0, 0, 1] },
+    ZY: { dir: [-1, 0, 0], xAxis: [0, 0, 1] },
+    front: { dir: [0, -1, 0], xAxis: [1, 0, 0] },
+    back: { dir: [0, 1, 0], xAxis: [-1, 0, 0] },
+    right: { dir: [-1, 0, 0], xAxis: [0, -1, 0] },
+    left: { dir: [1, 0, 0], xAxis: [0, 1, 0] },
+    bottom: { dir: [0, 0, 1], xAxis: [1, 0, 0] },
+    top: { dir: [0, 0, -1], xAxis: [1, 0, 0] },
+};
+/** Type guard — check if a value is a valid {@link ProjectionPlane} name.
+ *
+ * @param plane - Value to test.
+ * @returns True if `plane` is a valid projection plane name.
+ */
+export function isProjectionPlane(plane) {
+    return typeof plane === 'string' && plane in PROJECTION_PLANES;
+}
+//# sourceMappingURL=projectionPlanes.js.map

package/dist/api/view/projectionPlanes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectionPlanes.js","sourceRoot":"","sources":["../../../src/api/view/projectionPlanes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH,qFAAqF;AACrF,MAAM,CAAC,MAAM,iBAAiB,GAAyC;IACrE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;IACxC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;IACzC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;IACxC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;IACzC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;IACxC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;IAEzC,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;IAC5C,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;IAC3C,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;IAC7C,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;IAC1C,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;IAC5C,GAAG,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;CAC3C,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,IAAI,iBAAiB,CAAC;AACjE,CAAC","sourcesContent":["/**\n * Shared projection plane definitions used by cameraFns（faijs 视图投影，路径 A）。\n *\n * 第一方模块（2026-09-25 core-decouple Phase 1）：复制自 brepjs\n * `src/projection/projectionPlanes.ts`（同源复制，签名不变）。\n */\n\nimport type { Vec3 } from '../brepjs-compat/types';\n\n/** Named face of an axis-aligned bounding cube. */\nexport type CubeFace = 'front' | 'back' | 'top' | 'bottom' | 'left' | 'right';\n\n/** Named projection plane — axis pairs or cube face names. */\nexport type ProjectionPlane =\n  'XY' | 'XZ' | 'YZ' | 'YX' | 'ZX' | 'ZY' | 'front' | 'back' | 'top' | 'bottom' | 'left' | 'right';\n\n/** Camera direction and X axis for a projection plane. */\nexport interface PlaneConfig {\n  readonly dir: Vec3;\n  readonly xAxis: Vec3;\n}\n\n/** Lookup table mapping each {@link ProjectionPlane} to its camera configuration. */\nexport const PROJECTION_PLANES: Record<ProjectionPlane, PlaneConfig> = {\n  XY: { dir: [0, 0, 1], xAxis: [1, 0, 0] },\n  XZ: { dir: [0, -1, 0], xAxis: [1, 0, 0] },\n  YZ: { dir: [1, 0, 0], xAxis: [0, 1, 0] },\n  YX: { dir: [0, 0, -1], xAxis: [0, 1, 0] },\n  ZX: { dir: [0, 1, 0], xAxis: [0, 0, 1] },\n  ZY: { dir: [-1, 0, 0], xAxis: [0, 0, 1] },\n\n  front: { dir: [0, -1, 0], xAxis: [1, 0, 0] },\n  back: { dir: [0, 1, 0], xAxis: [-1, 0, 0] },\n  right: { dir: [-1, 0, 0], xAxis: [0, -1, 0] },\n  left: { dir: [1, 0, 0], xAxis: [0, 1, 0] },\n  bottom: { dir: [0, 0, 1], xAxis: [1, 0, 0] },\n  top: { dir: [0, 0, -1], xAxis: [1, 0, 0] },\n};\n\n/** Type guard — check if a value is a valid {@link ProjectionPlane} name.\n *\n * @param plane - Value to test.\n * @returns True if `plane` is a valid projection plane name.\n */\nexport function isProjectionPlane(plane: unknown): plane is ProjectionPlane {\n  return typeof plane === 'string' && plane in PROJECTION_PLANES;\n}\n"]}

package/dist/api/view/view-camera.d.ts

@@ -15,8 +15,8 @@
  * vendored brepjs 的 Camera 纯数据对象，供 projectView/projectSheet 与宿主复用。
  * 返回类型 re-export 自 vendored（api/generated/projection.ts 已登记 Camera type）。
  */
-import { type Camera } from '../../vendored/brepjs/projection/cameraFns.js';
-import type { Vec3 } from '../../vendored/brepjs/core/types.js';
+import { type Camera } from './cameraFns.js';
+import type { Vec3 } from '../brepjs-compat/types.js';
 /** 六个标准正交视图名（vendored CubeFace 同集）。 */
 export type StandardView = 'front' | 'back' | 'top' | 'bottom' | 'left' | 'right';
 /** 等轴测视图名（faijs 新增别名；方向 (1,-1,1)）。 */

package/dist/api/view/view-camera.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"view-camera.d.ts","sourceRoot":"","sources":["../../../src/api/view/view-camera.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAiC,KAAK,MAAM,EAAE,MAAM,+CAA+C,CAAA;AAG1G,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qCAAqC,CAAA;AAE/D,uCAAuC;AACvC,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAA;AAEjF,sCAAsC;AACtC,MAAM,MAAM,OAAO,GAAG,KAAK,GAAG,WAAW,CAAA;AAEzC,2CAA2C;AAC3C,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AAEnE,gBAAgB;AAChB,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,GAAG,EAAE,IAAI,CAAA;IACT,wBAAwB;IACxB,KAAK,CAAC,EAAE,IAAI,CAAA;CACb;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,OAAO,GAAG,aAAa,GAAG,aAAa,CAAA;AAK7E;;;;;;;;;;;;IAYI;AACJ,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAYjD;AAED,4EAA4E;AAC5E,eAAO,MAAM,aAAa,mBAAa,CAAA"}
+{"version":3,"file":"view-camera.d.ts","sourceRoot":"","sources":["../../../src/api/view/view-camera.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAiC,KAAK,MAAM,EAAE,MAAM,aAAa,CAAA;AAGxE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAA;AAElD,uCAAuC;AACvC,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAA;AAEjF,sCAAsC;AACtC,MAAM,MAAM,OAAO,GAAG,KAAK,GAAG,WAAW,CAAA;AAEzC,2CAA2C;AAC3C,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AAEnE,gBAAgB;AAChB,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,GAAG,EAAE,IAAI,CAAA;IACT,wBAAwB;IACxB,KAAK,CAAC,EAAE,IAAI,CAAA;CACb;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,OAAO,GAAG,aAAa,GAAG,aAAa,CAAA;AAK7E;;;;;;;;;;;;IAYI;AACJ,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAYjD;AAED,4EAA4E;AAC5E,eAAO,MAAM,aAAa,mBAAa,CAAA"}

package/dist/api/view/view-camera.js

@@ -15,9 +15,9 @@
  * vendored brepjs 的 Camera 纯数据对象，供 projectView/projectSheet 与宿主复用。
  * 返回类型 re-export 自 vendored（api/generated/projection.ts 已登记 Camera type）。
  */
-import { createCamera, cameraFromPlane } from '../../vendored/brepjs/projection/cameraFns.js';
-import { isProjectionPlane } from '../../vendored/brepjs/projection/projectionPlanes.js';
-import { unwrap } from '../../vendored/brepjs/core/result.js';
+import { createCamera, cameraFromPlane } from './cameraFns.js';
+import { isProjectionPlane } from './projectionPlanes.js';
+import { unwrap } from '../../result/result.js';
 /** 等轴测视向（方案 §2.3：Iso=(1,-1,1)，与 FreeCAD 惯例一致）。 */
 const ISO_DIR = [1, -1, 1];
 /**

package/dist/api/view/view-camera.js.map

@@ -1 +1 @@
-{"version":3,"file":"view-camera.js","sourceRoot":"","sources":["../../../src/api/view/view-camera.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,YAAY,EAAE,eAAe,EAAe,MAAM,+CAA+C,CAAA;AAC1G,OAAO,EAAE,iBAAiB,EAAE,MAAM,sDAAsD,CAAA;AACxF,OAAO,EAAE,MAAM,EAAE,MAAM,sCAAsC,CAAA;AAyB7D,kDAAkD;AAClD,MAAM,OAAO,GAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAEhC;;;;;;;;;;;;IAYI;AACJ,MAAM,UAAU,UAAU,CAAC,IAAc;IACvC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;YAC3C,OAAO,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAA;QACjD,CAAC;QACD,IAAI,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,OAAO,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAA;QACtC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,6EAA6E,CAAC,CAAA;IAClI,CAAC;IACD,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,IAAI,CAAA;IAC3B,OAAO,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAA;AACpD,CAAC;AAED,4EAA4E;AAC5E,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAA","sourcesContent":["/**\n * view-camera — 视图规格 → 投影相机（faijs 视图投影能力，路径 A 纯数据面）\n *\n * 设计文档：docs/plans/2026-09-10-faijs-view-projection-and-screenshot.md §3.2\n *\n * 视图规格（ViewSpec）：\n *   - 六个标准正交视图：'front' | 'back' | 'top' | 'bottom' | 'left' | 'right'\n *     （方向沿用 vendored brepjs PROJECTION_PLANES：front=(0,-1,0)、top=(0,0,-1)…，\n *      与 FreeCAD TechDraw 的方向向量惯例一致，见方案 §2.2）；\n *   - 等轴测：'iso' | 'isometric'（方向 (1,-1,1)，方案 §2.3 定稿）；\n *   - 轴对平面：'XY' | 'XZ' | 'YZ' | 'YX' | 'ZX' | 'ZY'（vendored 平面名）；\n *   - 任意方向：{ dir: Vec3, xAxis?: Vec3 }（xAxis 缺省由方向自动推导）。\n *\n * viewCamera 是纯数据函数（无 Shape 输入，kind 'pure' 语义）：把视图规格解析成\n * vendored brepjs 的 Camera 纯数据对象，供 projectView/projectSheet 与宿主复用。\n * 返回类型 re-export 自 vendored（api/generated/projection.ts 已登记 Camera type）。\n */\n\nimport { createCamera, cameraFromPlane, type Camera } from '../../vendored/brepjs/projection/cameraFns.js'\nimport { isProjectionPlane } from '../../vendored/brepjs/projection/projectionPlanes.js'\nimport { unwrap } from '../../vendored/brepjs/core/result.js'\nimport type { Vec3 } from '../../vendored/brepjs/core/types.js'\n\n/** 六个标准正交视图名（vendored CubeFace 同集）。 */\nexport type StandardView = 'front' | 'back' | 'top' | 'bottom' | 'left' | 'right'\n\n/** 等轴测视图名（faijs 新增别名；方向 (1,-1,1)）。 */\nexport type IsoView = 'iso' | 'isometric'\n\n/** 轴对平面名（vendored ProjectionPlane 的子集）。 */\nexport type AxisPlaneView = 'XY' | 'XZ' | 'YZ' | 'YX' | 'ZX' | 'ZY'\n\n/** 任意方向视图规格。 */\nexport interface DirectionView {\n  /** 视向（相机沿此方向观察；零向量报错）。 */\n  dir: Vec3\n  /** 可选水平轴（缺省由方向自动推导）。 */\n  xAxis?: Vec3\n}\n\n/**\n * faijs 视图投影的视图规格：标准正交 / 等轴测 / 轴对平面 / 任意方向。\n */\nexport type ViewSpec = StandardView | IsoView | AxisPlaneView | DirectionView\n\n/** 等轴测视向（方案 §2.3：Iso=(1,-1,1)，与 FreeCAD 惯例一致）。 */\nconst ISO_DIR: Vec3 = [1, -1, 1]\n\n/**\n * 解析视图规格为投影相机（纯数据，无 Shape 输入；不消费任何几何）。\n * @group 查询\n * @inputs 0\n * @async false\n * @qual ok\n * @name viewCamera\n * @returns { direction, xAxis? } 归一化方向向量（iso = (1,-1,1)/√3，与 FreeCAD/OCCT 惯例一致）。未知视图名抛错；零方向向量抛错。用于 3d_editor 侧三轴相机渲染（mesh/SDF 形状的截图通道）。\n * @param view - 视图规格：标准视图名（front/back/top/bottom/left/right/iso（=isometric）/XY/XZ/YZ/YX/ZX/ZY）或方向对象。type:string|{dir,xAxis?} required:true\n * @example\n * const cam = cad.viewCamera('iso')\n * const cam = cad.viewCamera({ dir: [1, -1, 1] })\n  */\nexport function viewCamera(view: ViewSpec): Camera {\n  if (typeof view === 'string') {\n    if (view === 'iso' || view === 'isometric') {\n      return unwrap(createCamera([0, 0, 0], ISO_DIR))\n    }\n    if (isProjectionPlane(view)) {\n      return unwrap(cameraFromPlane(view))\n    }\n    throw new Error(`[faijs/view] unknown view '${view}' (expected front/back/top/bottom/left/right/iso/isometric or an axis pair)`)\n  }\n  const { dir, xAxis } = view\n  return unwrap(createCamera([0, 0, 0], dir, xAxis))\n}\n\n/** resolveCamera = viewCamera 别名（projectView/projectSheet 内部使用；与方案措辞一致）。 */\nexport const resolveCamera = viewCamera\n"]}
+{"version":3,"file":"view-camera.js","sourceRoot":"","sources":["../../../src/api/view/view-camera.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,YAAY,EAAE,eAAe,EAAe,MAAM,aAAa,CAAA;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAyB5C,kDAAkD;AAClD,MAAM,OAAO,GAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAEhC;;;;;;;;;;;;IAYI;AACJ,MAAM,UAAU,UAAU,CAAC,IAAc;IACvC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;YAC3C,OAAO,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAA;QACjD,CAAC;QACD,IAAI,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,OAAO,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAA;QACtC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,6EAA6E,CAAC,CAAA;IAClI,CAAC;IACD,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,IAAI,CAAA;IAC3B,OAAO,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAA;AACpD,CAAC;AAED,4EAA4E;AAC5E,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAA","sourcesContent":["/**\n * view-camera — 视图规格 → 投影相机（faijs 视图投影能力，路径 A 纯数据面）\n *\n * 设计文档：docs/plans/2026-09-10-faijs-view-projection-and-screenshot.md §3.2\n *\n * 视图规格（ViewSpec）：\n *   - 六个标准正交视图：'front' | 'back' | 'top' | 'bottom' | 'left' | 'right'\n *     （方向沿用 vendored brepjs PROJECTION_PLANES：front=(0,-1,0)、top=(0,0,-1)…，\n *      与 FreeCAD TechDraw 的方向向量惯例一致，见方案 §2.2）；\n *   - 等轴测：'iso' | 'isometric'（方向 (1,-1,1)，方案 §2.3 定稿）；\n *   - 轴对平面：'XY' | 'XZ' | 'YZ' | 'YX' | 'ZX' | 'ZY'（vendored 平面名）；\n *   - 任意方向：{ dir: Vec3, xAxis?: Vec3 }（xAxis 缺省由方向自动推导）。\n *\n * viewCamera 是纯数据函数（无 Shape 输入，kind 'pure' 语义）：把视图规格解析成\n * vendored brepjs 的 Camera 纯数据对象，供 projectView/projectSheet 与宿主复用。\n * 返回类型 re-export 自 vendored（api/generated/projection.ts 已登记 Camera type）。\n */\n\nimport { createCamera, cameraFromPlane, type Camera } from './cameraFns'\nimport { isProjectionPlane } from './projectionPlanes'\nimport { unwrap } from '../../result/result'\nimport type { Vec3 } from '../brepjs-compat/types'\n\n/** 六个标准正交视图名（vendored CubeFace 同集）。 */\nexport type StandardView = 'front' | 'back' | 'top' | 'bottom' | 'left' | 'right'\n\n/** 等轴测视图名（faijs 新增别名；方向 (1,-1,1)）。 */\nexport type IsoView = 'iso' | 'isometric'\n\n/** 轴对平面名（vendored ProjectionPlane 的子集）。 */\nexport type AxisPlaneView = 'XY' | 'XZ' | 'YZ' | 'YX' | 'ZX' | 'ZY'\n\n/** 任意方向视图规格。 */\nexport interface DirectionView {\n  /** 视向（相机沿此方向观察；零向量报错）。 */\n  dir: Vec3\n  /** 可选水平轴（缺省由方向自动推导）。 */\n  xAxis?: Vec3\n}\n\n/**\n * faijs 视图投影的视图规格：标准正交 / 等轴测 / 轴对平面 / 任意方向。\n */\nexport type ViewSpec = StandardView | IsoView | AxisPlaneView | DirectionView\n\n/** 等轴测视向（方案 §2.3：Iso=(1,-1,1)，与 FreeCAD 惯例一致）。 */\nconst ISO_DIR: Vec3 = [1, -1, 1]\n\n/**\n * 解析视图规格为投影相机（纯数据，无 Shape 输入；不消费任何几何）。\n * @group 查询\n * @inputs 0\n * @async false\n * @qual ok\n * @name viewCamera\n * @returns { direction, xAxis? } 归一化方向向量（iso = (1,-1,1)/√3，与 FreeCAD/OCCT 惯例一致）。未知视图名抛错；零方向向量抛错。用于 3d_editor 侧三轴相机渲染（mesh/SDF 形状的截图通道）。\n * @param view - 视图规格：标准视图名（front/back/top/bottom/left/right/iso（=isometric）/XY/XZ/YZ/YX/ZX/ZY）或方向对象。type:string|{dir,xAxis?} required:true\n * @example\n * const cam = cad.viewCamera('iso')\n * const cam = cad.viewCamera({ dir: [1, -1, 1] })\n  */\nexport function viewCamera(view: ViewSpec): Camera {\n  if (typeof view === 'string') {\n    if (view === 'iso' || view === 'isometric') {\n      return unwrap(createCamera([0, 0, 0], ISO_DIR))\n    }\n    if (isProjectionPlane(view)) {\n      return unwrap(cameraFromPlane(view))\n    }\n    throw new Error(`[faijs/view] unknown view '${view}' (expected front/back/top/bottom/left/right/iso/isometric or an axis pair)`)\n  }\n  const { dir, xAxis } = view\n  return unwrap(createCamera([0, 0, 0], dir, xAxis))\n}\n\n/** resolveCamera = viewCamera 别名（projectView/projectSheet 内部使用；与方案措辞一致）。 */\nexport const resolveCamera = viewCamera\n"]}

package/dist/api/view/view-projection.d.ts

@@ -4,16 +4,19 @@
  * 设计文档：docs/plans/2026-09-10-faijs-view-projection-and-screenshot.md §3.2
  *
  * projectView(shape, view, opts?) 返回**纯数据 SVG 字符串**（非 Shape）：
- *   - 借入 faijs Shape 的 brep 句柄（borrowBrepjsShape，零拷贝，不转移所有权）；
- *   - 经 vendored brepjs drawProjection（OCCT HLR 隐线消除）得到 visible/hidden
- *     两组 2D Drawing；
+ *   - 直连 core 引擎的 HLR 投影（`BrepEngineApi.projectEdges`，OCCT
+ *     HLRBRep 隐线消除）：可见 / 隐藏两组边（sharp/smooth/outline compound）；
+ *   - 每组边 → 3D 曲线采样折线（`curveParameters` + `curvePointAtParam`）→
+ *     投影到相机平面（正交投影，坐标 = 相对 camera.origin 在 xAxis/yAxis 上的分量）；
  *   - 序列化为一个完整 SVG：可见轮廓实线 + 隐藏线虚线（stroke-dasharray）。
  *
  * 返回字符串绕开 arg-spec 对 projectEdges/makeProjectedEdges 的 skip 障碍
  * （Edge 句柄数组 + compound 生命周期无法静态收养——本 op 只在内部消费，
  *   产物是 2D 纯文本，无收养问题）。
  *
- * projectViewSvg 返回结构化数据（viewBox/paths/尺寸），供 projectSheet 网格组合。
+ * 2026-09-25 core-decouple wrapup（§3.1 A 案）：不再依赖 brepjs 的 HLR+2D
+ * drawing 链——HLR 由 core 引擎原生提供（occt-wasm projectEdges），2D SVG
+ * 序列化为本地实现（曲线边以采样折线近似）。
  */
 import type { Shape } from '../../mesh/types.js';
 import { type ViewSpec } from './view-camera.js';
@@ -38,7 +41,7 @@ export interface ProjectionSvg {
     svg: string;
     /** viewBox 属性值（'minX minY w h'；可见 ∪ 隐藏线并集 + margin）。 */
     viewBox: string;
-    /** 各路径 d 串：可见实线 / 隐藏虚线。 */
+    /** 各 path d 串：可见实线 / 隐藏虚线。 */
     paths: {
         visible: string[];
         hidden: string[];
@@ -69,7 +72,7 @@ export declare function projectViewSvg(shape: Shape, view: ViewSpec, opts?: Proj
  * @param opts.strokeWidth - 可见线宽（stroke-width）。type:number 默认 1
  * @param opts.dash - 隐藏线虚线样式（stroke-dasharray）。type:string 默认 '4,4'
  * @param opts.hiddenOpacity - 隐藏线透明度。type:number 默认 0.6
- * @param opts.margin - viewBox 外扩边距。type:number 默认 10
+ * @param opts.margin - viewBox 外扩边距。type:number 默认 1
  * @param opts.width - 输出宽度（缺省 = viewBox 宽度）。type:number
  * @param opts.height - 输出高度（缺省 = viewBox 高度）。type:number
  * @example

package/dist/api/view/view-projection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"view-projection.d.ts","sourceRoot":"","sources":["../../../src/api/view/view-projection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAK7C,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE5D,0BAA0B;AAC1B,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,sBAAsB;IACtB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,oCAAoC;AACpC,MAAM,WAAW,aAAa;IAC5B,kBAAkB;IAClB,GAAG,EAAE,MAAM,CAAA;IACX,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAA;IACf,2BAA2B;IAC3B,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;IAC9C,eAAe;IACf,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AA0CD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,GAAE,kBAAuB,GAAG,aAAa,CAqCzG;AAED;;;;;;;;;;;;;;;;;;;IAmBI;AACJ,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAE3F"}
+{"version":3,"file":"view-projection.d.ts","sourceRoot":"","sources":["../../../src/api/view/view-projection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAI7C,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAA;AAU5D,0BAA0B;AAC1B,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,sBAAsB;IACtB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,oCAAoC;AACpC,MAAM,WAAW,aAAa;IAC5B,kBAAkB;IAClB,GAAG,EAAE,MAAM,CAAA;IACX,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAA;IACf,8BAA8B;IAC9B,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;IAC9C,eAAe;IACf,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAyID;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,GAAE,kBAAuB,GAAG,aAAa,CA2BzG;AAED;;;;;;;;;;;;;;;;;;;IAmBI;AACJ,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAE3F"}

package/dist/api/view/view-projection.js

@@ -4,20 +4,108 @@
  * 设计文档：docs/plans/2026-09-10-faijs-view-projection-and-screenshot.md §3.2
  *
  * projectView(shape, view, opts?) 返回**纯数据 SVG 字符串**（非 Shape）：
- *   - 借入 faijs Shape 的 brep 句柄（borrowBrepjsShape，零拷贝，不转移所有权）；
- *   - 经 vendored brepjs drawProjection（OCCT HLR 隐线消除）得到 visible/hidden
- *     两组 2D Drawing；
+ *   - 直连 core 引擎的 HLR 投影（`BrepEngineApi.projectEdges`，OCCT
+ *     HLRBRep 隐线消除）：可见 / 隐藏两组边（sharp/smooth/outline compound）；
+ *   - 每组边 → 3D 曲线采样折线（`curveParameters` + `curvePointAtParam`）→
+ *     投影到相机平面（正交投影，坐标 = 相对 camera.origin 在 xAxis/yAxis 上的分量）；
  *   - 序列化为一个完整 SVG：可见轮廓实线 + 隐藏线虚线（stroke-dasharray）。
  *
  * 返回字符串绕开 arg-spec 对 projectEdges/makeProjectedEdges 的 skip 障碍
  * （Edge 句柄数组 + compound 生命周期无法静态收养——本 op 只在内部消费，
  *   产物是 2D 纯文本，无收养问题）。
  *
- * projectViewSvg 返回结构化数据（viewBox/paths/尺寸），供 projectSheet 网格组合。
+ * 2026-09-25 core-decouple wrapup（§3.1 A 案）：不再依赖 brepjs 的 HLR+2D
+ * drawing 链——HLR 由 core 引擎原生提供（occt-wasm projectEdges），2D SVG
+ * 序列化为本地实现（曲线边以采样折线近似）。
  */
-import { borrowBrepjsShape } from '../internal/l3-bridge.js';
-import { drawProjection } from '../../vendored/brepjs/sketching/draw3d.js';
+import { brepOf } from '../../shape.js';
+import { getBrepApi } from '../../brep/handle-bridge.js';
 import { resolveCamera } from './view-camera.js';
+/** 每条边的 3D 采样点数（直线 2 点；曲线分段近似）。 */
+const EDGE_SAMPLES = 5;
+/** 3D 点 → 相机平面 2D 坐标。
+ *
+ * GOTCHA: occt-wasm 的 HLR projectEdges 已把边投影到相机平面，输出坐标 =
+ * （沿 xAxis 的水平分量, 沿 cross(direction, xAxis) 的垂直分量, 沿 direction
+ * 的深度分量≈0）——不是世界坐标。因此 2D 坐标直接取输出的前两分量，不再做
+ * dot 二次投影（否则会把垂直信息读丢——垂直在 p.y 而非 p.z）。
+ */
+function projectTo2D(p, _cam) {
+    return [p[0], p[1]];
+}
+const COMPOUND_KEYS = [
+    ['visibleSharp', 'visible'],
+    ['visibleSmooth', 'visible'],
+    ['visibleOutline', 'visible'],
+    ['hiddenSharp', 'hidden'],
+    ['hiddenSmooth', 'hidden'],
+    ['hiddenOutline', 'hidden'],
+];
+/**
+ * HLR 投影 shape → 可见/隐藏 2D 折线（SVG d 串）。
+ * 全部句柄在本函数内释放（compound + 边；输入 shape 不消费）。
+ */
+function projectPolylines(shape, view) {
+    const solid = brepOf(shape);
+    if (solid === undefined) {
+        throw new Error('[faijs/view-projection] E_BREP_ONLY_INPUT: operation requires a BREP-backed shape ' +
+            '(mesh-only input cannot be projected)');
+    }
+    const api = getBrepApi();
+    const cam = resolveCamera(view);
+    const r = api.projectEdges(solid, { x: cam.position[0], y: cam.position[1], z: cam.position[2] }, { x: cam.direction[0], y: cam.direction[1], z: cam.direction[2] }, { x: cam.xAxis[0], y: cam.xAxis[1], z: cam.xAxis[2] }, true, 0.1);
+    const out = { visible: [], hidden: [] };
+    const toHandle = (id) => id;
+    try {
+        for (const [key, group] of COMPOUND_KEYS) {
+            const compoundId = r[key];
+            if (typeof compoundId !== 'number' || compoundId === 0)
+                continue;
+            const edges = api.getSubShapes(toHandle(compoundId), 'edge');
+            for (const edge of edges) {
+                const d = edgeToPath(api, edge, cam);
+                if (d !== null)
+                    out[group].push(d);
+            }
+            // 释放 compound slot（幂等）
+            try {
+                api.release(toHandle(compoundId));
+            }
+            catch {
+                // already released
+            }
+        }
+    }
+    finally {
+        void 0;
+    }
+    return out;
+}
+/** 单条边 → SVG path d 串（3D 曲线采样折线投影到相机平面）。 */
+function edgeToPath(api, edge, cam) {
+    let cp;
+    try {
+        cp = api.curveParameters(edge);
+    }
+    catch {
+        return null; // 退化边（如孤立顶点线）无曲线参数
+    }
+    const { first, last } = cp;
+    const span = last - first;
+    const pts = [];
+    for (let i = 0; i < EDGE_SAMPLES; i += 1) {
+        const t = first + (span * i) / (EDGE_SAMPLES - 1);
+        const p = api.curvePointAtParam(edge, t);
+        pts.push(projectTo2D([p.x, p.y, p.z], cam));
+    }
+    if (pts.length < 2)
+        return null;
+    let d = `M ${pts[0][0].toFixed(4)} ${pts[0][1].toFixed(4)}`;
+    for (let i = 1; i < pts.length; i += 1) {
+        d += ` L ${pts[i][0].toFixed(4)} ${pts[i][1].toFixed(4)}`;
+    }
+    return d;
+}
 /** 解析 'minX minY w h' 为数值数组。 */
 function parseViewBox(vb) {
     const parts = vb.trim().split(/\s+/).map(Number);
@@ -25,39 +113,29 @@ function parseViewBox(vb) {
         return undefined;
     return [parts[0], parts[1], parts[2], parts[3]];
 }
-/** 空 Drawing 的 viewBox 是空串（innerShape 为 null）；返回 false 表示无内容。 */
-function viewBoxOf(d) {
-    const vb = d.toSVGViewBox(0);
-    if (vb === '')
-        return undefined;
-    return parseViewBox(vb);
-}
-/**
- * 可见 ∪ 隐藏两组 Drawing 的并集 viewBox（统一坐标系；margin 再外扩）。
- */
-function mergedViewBox(visible, hidden, margin) {
+/** 折线点集 bbox → viewBox（统一坐标系；margin 再外扩）。 */
+function viewBoxOfPaths(paths, margin) {
     let minX = Infinity;
     let minY = Infinity;
     let maxX = -Infinity;
     let maxY = -Infinity;
-    for (const d of [visible, hidden]) {
-        const box = viewBoxOf(d);
-        if (!box)
-            continue;
-        const [x, y, w, h] = box;
-        minX = Math.min(minX, x);
-        minY = Math.min(minY, y);
-        maxX = Math.max(maxX, x + w);
-        maxY = Math.max(maxY, y + h);
+    for (const d of paths) {
+        const nums = d.match(/[-+]?\d*\.?\d+(?:[eE][-+]?\d+)?/g) ?? [];
+        for (let i = 0; i + 1 < nums.length; i += 2) {
+            const x = Number(nums[i]);
+            const y = Number(nums[i + 1]);
+            if (!Number.isFinite(x) || !Number.isFinite(y))
+                continue;
+            minX = Math.min(minX, x);
+            minY = Math.min(minY, y);
+            maxX = Math.max(maxX, x);
+            maxY = Math.max(maxY, y);
+        }
     }
     if (!Number.isFinite(minX))
         return '0 0 0 0'; // 空投影（如空 shape）
     return `${minX - margin} ${minY - margin} ${maxX - minX + 2 * margin} ${maxY - minY + 2 * margin}`;
 }
-function flattenPaths(d) {
-    const paths = d.toSVGPaths();
-    return Array.isArray(paths[0]) ? paths.flat() : paths;
-}
 /**
  * 单视图投影（结构化结果）。
  *
@@ -67,40 +145,29 @@ function flattenPaths(d) {
  * @returns 结构化投影结果（svg/viewBox/paths/尺寸）。
  */
 export function projectViewSvg(shape, view, opts = {}) {
-    const borrowed = borrowBrepjsShape(shape);
-    const camera = resolveCamera(view);
-    const { visible, hidden } = drawProjection(borrowed, camera);
-    try {
-        const visiblePaths = flattenPaths(visible);
-        const hiddenPaths = flattenPaths(hidden);
-        const margin = opts.margin ?? 1;
-        const viewBox = mergedViewBox(visible, hidden, margin);
-        const parsed = parseViewBox(viewBox) ?? [0, 0, 0, 0];
-        const width = opts.width ?? parsed[2];
-        const height = opts.height ?? parsed[3];
-        const strokeWidth = opts.strokeWidth ?? 1;
-        const dash = opts.dash ?? '4,4';
-        const hiddenOpacity = opts.hiddenOpacity ?? 0.6;
-        const visibleMarkup = visiblePaths
-            .map((d) => `<path d="${d}" fill="none" stroke="#000" stroke-width="${strokeWidth}" />`)
-            .join('\n    ');
-        const hiddenMarkup = hiddenPaths
-            .map((d) => `<path d="${d}" fill="none" stroke="#000" stroke-width="${strokeWidth}" stroke-dasharray="${dash}" opacity="${hiddenOpacity}" />`)
-            .join('\n    ');
-        const svg = [
-            `<svg version="1.1" xmlns="http://www.w3.org/2000/svg" viewBox="${viewBox}" width="${width}" height="${height}" fill="none" stroke="black" stroke-width="0.6%" vector-effect="non-scaling-stroke">`,
-            `  <g stroke="#000" fill="none">`,
-            `    ${visibleMarkup}${hiddenMarkup === '' ? '' : `\n    ${hiddenMarkup}`}`,
-            `  </g>`,
-            `</svg>`,
-        ].join('\n');
-        return { svg, viewBox, paths: { visible: visiblePaths, hidden: hiddenPaths }, width, height };
-    }
-    finally {
-        // Drawing 持有 2D kernel 句柄（Bnd_Box2d/2D 曲线），序列化后释放
-        visible[Symbol.dispose]?.();
-        hidden[Symbol.dispose]?.();
-    }
+    const { visible: visiblePaths, hidden: hiddenPaths } = projectPolylines(shape, view);
+    const margin = opts.margin ?? 1;
+    const viewBox = viewBoxOfPaths([...visiblePaths, ...hiddenPaths], margin);
+    const parsed = parseViewBox(viewBox) ?? [0, 0, 0, 0];
+    const width = opts.width ?? parsed[2];
+    const height = opts.height ?? parsed[3];
+    const strokeWidth = opts.strokeWidth ?? 1;
+    const dash = opts.dash ?? '4,4';
+    const hiddenOpacity = opts.hiddenOpacity ?? 0.6;
+    const visibleMarkup = visiblePaths
+        .map((d) => `<path d="${d}" fill="none" stroke="#000" stroke-width="${strokeWidth}" />`)
+        .join('\n    ');
+    const hiddenMarkup = hiddenPaths
+        .map((d) => `<path d="${d}" fill="none" stroke="#000" stroke-width="${strokeWidth}" stroke-dasharray="${dash}" opacity="${hiddenOpacity}" />`)
+        .join('\n    ');
+    const svg = [
+        `<svg version="1.1" xmlns="http://www.w3.org/2000/svg" viewBox="${viewBox}" width="${width}" height="${height}" fill="none" stroke="black" stroke-width="0.6%" vector-effect="non-scaling-stroke">`,
+        `  <g stroke="#000" fill="none">`,
+        `    ${visibleMarkup}${hiddenMarkup === '' ? '' : `\n    ${hiddenMarkup}`}`,
+        `  </g>`,
+        `</svg>`,
+    ].join('\n');
+    return { svg, viewBox, paths: { visible: visiblePaths, hidden: hiddenPaths }, width, height };
 }
 /**
  * 单视图投影 → SVG 线稿字符串（纯数据，不消费/修改 shape；规则 1 下裸调用不消费输入）。
@@ -115,7 +182,7 @@ export function projectViewSvg(shape, view, opts = {}) {
  * @param opts.strokeWidth - 可见线宽（stroke-width）。type:number 默认 1
  * @param opts.dash - 隐藏线虚线样式（stroke-dasharray）。type:string 默认 '4,4'
  * @param opts.hiddenOpacity - 隐藏线透明度。type:number 默认 0.6
- * @param opts.margin - viewBox 外扩边距。type:number 默认 10
+ * @param opts.margin - viewBox 外扩边距。type:number 默认 1
  * @param opts.width - 输出宽度（缺省 = viewBox 宽度）。type:number
  * @param opts.height - 输出高度（缺省 = viewBox 高度）。type:number
  * @example

package/dist/api/view/view-projection.js.map

@@ -1 +1 @@
-{"version":3,"file":"view-projection.js","sourceRoot":"","sources":["../../../src/api/view/view-projection.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * view-projection — 单视图投影 → SVG 线稿（faijs 视图投影能力，路径 A）\n *\n * 设计文档：docs/plans/2026-09-10-faijs-view-projection-and-screenshot.md §3.2\n *\n * projectView(shape, view, opts?) 返回**纯数据 SVG 字符串**（非 Shape）：\n *   - 借入 faijs Shape 的 brep 句柄（borrowBrepjsShape，零拷贝，不转移所有权）；\n *   - 经 vendored brepjs drawProjection（OCCT HLR 隐线消除）得到 visible/hidden\n *     两组 2D Drawing；\n *   - 序列化为一个完整 SVG：可见轮廓实线 + 隐藏线虚线（stroke-dasharray）。\n *\n * 返回字符串绕开 arg-spec 对 projectEdges/makeProjectedEdges 的 skip 障碍\n * （Edge 句柄数组 + compound 生命周期无法静态收养——本 op 只在内部消费，\n *   产物是 2D 纯文本，无收养问题）。\n *\n * projectViewSvg 返回结构化数据（viewBox/paths/尺寸），供 projectSheet 网格组合。\n */\n\nimport type { Shape } from '../../mesh/types'\nimport { borrowBrepjsShape } from '../internal/l3-bridge'\nimport { drawProjection } from '../../vendored/brepjs/sketching/draw3d.js'\nimport type { Drawing } from '../../vendored/brepjs/sketching/drawing.js'\nimport type { AnyShape } from '../../vendored/brepjs/core/shapeTypes.js'\nimport { resolveCamera, type ViewSpec } from './view-camera'\n\n/** projectView 的序列化选项。 */\nexport interface ProjectViewOptions {\n  /** viewBox 四周留白（单位 = 投影平面坐标单位；缺省 1）。 */\n  margin?: number\n  /** 可见/隐藏线 stroke-width（像素；缺省 1）。 */\n  strokeWidth?: number\n  /** 隐藏线虚线样式（SVG stroke-dasharray；缺省 '4,4'）。 */\n  dash?: string\n  /** 隐藏线透明度（缺省 0.6）。 */\n  hiddenOpacity?: number\n  /** 输出 SVG 宽度（缺省 = viewBox 宽度）。 */\n  width?: number\n  /** 输出 SVG 高度（缺省 = viewBox 高度）。 */\n  height?: number\n}\n\n/** 单视图投影的结构化结果（projectSheet 复用）。 */\nexport interface ProjectionSvg {\n  /** 完整 SVG 字符串。 */\n  svg: string\n  /** viewBox 属性值（'minX minY w h'；可见 ∪ 隐藏线并集 + margin）。 */\n  viewBox: string\n  /** 各路径 d 串：可见实线 / 隐藏虚线。 */\n  paths: { visible: string[]; hidden: string[] }\n  /** 输出宽度/高度。 */\n  width: number\n  height: number\n}\n\n/** 解析 'minX minY w h' 为数值数组。 */\nfunction parseViewBox(vb: string): [number, number, number, number] | undefined {\n  const parts = vb.trim().split(/\\s+/).map(Number)\n  if (parts.length !== 4 || parts.some((n) => !Number.isFinite(n))) return undefined\n  return [parts[0], parts[1], parts[2], parts[3]]\n}\n\n/** 空 Drawing 的 viewBox 是空串（innerShape 为 null）；返回 false 表示无内容。 */\nfunction viewBoxOf(d: Drawing): [number, number, number, number] | undefined {\n  const vb = d.toSVGViewBox(0)\n  if (vb === '') return undefined\n  return parseViewBox(vb)\n}\n\n/**\n * 可见 ∪ 隐藏两组 Drawing 的并集 viewBox（统一坐标系；margin 再外扩）。\n */\nfunction mergedViewBox(visible: Drawing, hidden: Drawing, margin: number): string {\n  let minX = Infinity\n  let minY = Infinity\n  let maxX = -Infinity\n  let maxY = -Infinity\n  for (const d of [visible, hidden]) {\n    const box = viewBoxOf(d)\n    if (!box) continue\n    const [x, y, w, h] = box\n    minX = Math.min(minX, x)\n    minY = Math.min(minY, y)\n    maxX = Math.max(maxX, x + w)\n    maxY = Math.max(maxY, y + h)\n  }\n  if (!Number.isFinite(minX)) return '0 0 0 0' // 空投影（如空 shape）\n  return `${minX - margin} ${minY - margin} ${maxX - minX + 2 * margin} ${maxY - minY + 2 * margin}`\n}\n\nfunction flattenPaths(d: Drawing): string[] {\n  const paths = d.toSVGPaths()\n  return Array.isArray(paths[0]) ? (paths as string[][]).flat() : (paths as string[])\n}\n\n/**\n * 单视图投影（结构化结果）。\n *\n * @param shape - 待投影的 faijs Shape（必须带 BREP 槽；mesh-only 输入抛 E_BREP_ONLY_INPUT）。\n * @param view - 视图规格（标准视图 / iso / 轴对平面 / 方向对象）。\n * @param opts - 序列化选项。\n * @returns 结构化投影结果（svg/viewBox/paths/尺寸）。\n */\nexport function projectViewSvg(shape: Shape, view: ViewSpec, opts: ProjectViewOptions = {}): ProjectionSvg {\n  const borrowed = borrowBrepjsShape(shape)\n  const camera = resolveCamera(view)\n  const { visible, hidden } = drawProjection(borrowed as unknown as AnyShape, camera)\n  try {\n    const visiblePaths = flattenPaths(visible)\n    const hiddenPaths = flattenPaths(hidden)\n    const margin = opts.margin ?? 1\n    const viewBox = mergedViewBox(visible, hidden, margin)\n    const parsed = parseViewBox(viewBox) ?? [0, 0, 0, 0]\n    const width = opts.width ?? parsed[2]\n    const height = opts.height ?? parsed[3]\n    const strokeWidth = opts.strokeWidth ?? 1\n    const dash = opts.dash ?? '4,4'\n    const hiddenOpacity = opts.hiddenOpacity ?? 0.6\n    const visibleMarkup = visiblePaths\n      .map((d) => `<path d=\"${d}\" fill=\"none\" stroke=\"#000\" stroke-width=\"${strokeWidth}\" />`)\n      .join('\\n    ')\n    const hiddenMarkup = hiddenPaths\n      .map(\n        (d) =>\n          `<path d=\"${d}\" fill=\"none\" stroke=\"#000\" stroke-width=\"${strokeWidth}\" stroke-dasharray=\"${dash}\" opacity=\"${hiddenOpacity}\" />`,\n      )\n      .join('\\n    ')\n    const svg = [\n      `<svg version=\"1.1\" xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"${viewBox}\" width=\"${width}\" height=\"${height}\" fill=\"none\" stroke=\"black\" stroke-width=\"0.6%\" vector-effect=\"non-scaling-stroke\">`,\n      `  <g stroke=\"#000\" fill=\"none\">`,\n      `    ${visibleMarkup}${hiddenMarkup === '' ? '' : `\\n    ${hiddenMarkup}`}`,\n      `  </g>`,\n      `</svg>`,\n    ].join('\\n')\n    return { svg, viewBox, paths: { visible: visiblePaths, hidden: hiddenPaths }, width, height }\n  } finally {\n    // Drawing 持有 2D kernel 句柄（Bnd_Box2d/2D 曲线），序列化后释放\n    visible[Symbol.dispose]?.()\n    hidden[Symbol.dispose]?.()\n  }\n}\n\n/**\n * 单视图投影 → SVG 线稿字符串（纯数据，不消费/修改 shape；规则 1 下裸调用不消费输入）。\n * @group 查询\n * @inputs 1\n * @async false\n * @qual ok\n * @name projectView\n * @returns SVG 字符串（<svg viewBox=\"…\"> + 可见实线 <path> + 隐藏虚线 <path>）。裸调用 cad.projectView(part0, 'front') 不消费 part0（规则 1），part 仍留在 canvas。\n * @param shape - 目标几何（必须有 BREP 槽；mesh-only 抛 E_BREP_ONLY_INPUT）。type:Shape required:true\n * @param view - 视图规格（同 viewCamera：标准视图名 / iso / 轴对平面 / 方向对象）。type:string|{dir,xAxis?} required:true\n * @param opts.strokeWidth - 可见线宽（stroke-width）。type:number 默认 1\n * @param opts.dash - 隐藏线虚线样式（stroke-dasharray）。type:string 默认 '4,4'\n * @param opts.hiddenOpacity - 隐藏线透明度。type:number 默认 0.6\n * @param opts.margin - viewBox 外扩边距。type:number 默认 10\n * @param opts.width - 输出宽度（缺省 = viewBox 宽度）。type:number\n * @param opts.height - 输出高度（缺省 = viewBox 高度）。type:number\n * @example\n * const svg = cad.projectView(part0, 'front')\n * const svg = cad.projectView(part0, 'iso', { strokeWidth: 1, dash: '4,4', hiddenOpacity: 0.6 })\n  */\nexport function projectView(shape: Shape, view: ViewSpec, opts?: ProjectViewOptions): string {\n  return projectViewSvg(shape, view, opts).svg\n}\n"]}
+{"version":3,"file":"view-projection.js","sourceRoot":"","sources":["../../../src/api/view/view-projection.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * view-projection — 单视图投影 → SVG 线稿（faijs 视图投影能力，路径 A）\n *\n * 设计文档：docs/plans/2026-09-10-faijs-view-projection-and-screenshot.md §3.2\n *\n * projectView(shape, view, opts?) 返回**纯数据 SVG 字符串**（非 Shape）：\n *   - 直连 core 引擎的 HLR 投影（`BrepEngineApi.projectEdges`，OCCT\n *     HLRBRep 隐线消除）：可见 / 隐藏两组边（sharp/smooth/outline compound）；\n *   - 每组边 → 3D 曲线采样折线（`curveParameters` + `curvePointAtParam`）→\n *     投影到相机平面（正交投影，坐标 = 相对 camera.origin 在 xAxis/yAxis 上的分量）；\n *   - 序列化为一个完整 SVG：可见轮廓实线 + 隐藏线虚线（stroke-dasharray）。\n *\n * 返回字符串绕开 arg-spec 对 projectEdges/makeProjectedEdges 的 skip 障碍\n * （Edge 句柄数组 + compound 生命周期无法静态收养——本 op 只在内部消费，\n *   产物是 2D 纯文本，无收养问题）。\n *\n * 2026-09-25 core-decouple wrapup（§3.1 A 案）：不再依赖 brepjs 的 HLR+2D\n * drawing 链——HLR 由 core 引擎原生提供（occt-wasm projectEdges），2D SVG\n * 序列化为本地实现（曲线边以采样折线近似）。\n */\n\nimport type { Shape } from '../../mesh/types'\nimport { brepOf } from '../../shape'\nimport { getBrepApi } from '../../brep/handle-bridge'\nimport type { BrepHandle } from '../../brep/engine/types'\nimport { resolveCamera, type ViewSpec } from './view-camera'\n\n/** 投影相机（与 view-camera 输出同构）。 */\ninterface Camera {\n  readonly position: [number, number, number]\n  readonly direction: [number, number, number]\n  readonly xAxis: [number, number, number]\n  readonly yAxis: [number, number, number]\n}\n\n/** projectView 的序列化选项。 */\nexport interface ProjectViewOptions {\n  /** viewBox 四周留白（单位 = 投影平面坐标单位；缺省 1）。 */\n  margin?: number\n  /** 可见/隐藏线 stroke-width（像素；缺省 1）。 */\n  strokeWidth?: number\n  /** 隐藏线虚线样式（SVG stroke-dasharray；缺省 '4,4'）。 */\n  dash?: string\n  /** 隐藏线透明度（缺省 0.6）。 */\n  hiddenOpacity?: number\n  /** 输出 SVG 宽度（缺省 = viewBox 宽度）。 */\n  width?: number\n  /** 输出 SVG 高度（缺省 = viewBox 高度）。 */\n  height?: number\n}\n\n/** 单视图投影的结构化结果（projectSheet 复用）。 */\nexport interface ProjectionSvg {\n  /** 完整 SVG 字符串。 */\n  svg: string\n  /** viewBox 属性值（'minX minY w h'；可见 ∪ 隐藏线并集 + margin）。 */\n  viewBox: string\n  /** 各 path d 串：可见实线 / 隐藏虚线。 */\n  paths: { visible: string[]; hidden: string[] }\n  /** 输出宽度/高度。 */\n  width: number\n  height: number\n}\n\n/** 每条边的 3D 采样点数（直线 2 点；曲线分段近似）。 */\nconst EDGE_SAMPLES = 5\n\ntype Vec3 = readonly [number, number, number]\n\n/** 3D 点 → 相机平面 2D 坐标。\n *\n * GOTCHA: occt-wasm 的 HLR projectEdges 已把边投影到相机平面，输出坐标 =\n * （沿 xAxis 的水平分量, 沿 cross(direction, xAxis) 的垂直分量, 沿 direction\n * 的深度分量≈0）——不是世界坐标。因此 2D 坐标直接取输出的前两分量，不再做\n * dot 二次投影（否则会把垂直信息读丢——垂直在 p.y 而非 p.z）。\n */\nfunction projectTo2D(p: Vec3, _cam: Camera): [number, number] {\n  return [p[0], p[1]]\n}\n\n/** 引擎 projectEdges 的返回结构（occt-wasm：6 组 compound 的 arena id）。 */\ninterface ProjectEdgesResult {\n  visibleSharp: number\n  visibleSmooth: number\n  visibleOutline: number\n  hiddenSharp: number\n  hiddenSmooth: number\n  hiddenOutline: number\n}\n\nconst COMPOUND_KEYS = [\n  ['visibleSharp', 'visible'],\n  ['visibleSmooth', 'visible'],\n  ['visibleOutline', 'visible'],\n  ['hiddenSharp', 'hidden'],\n  ['hiddenSmooth', 'hidden'],\n  ['hiddenOutline', 'hidden'],\n] as const\n\n/**\n * HLR 投影 shape → 可见/隐藏 2D 折线（SVG d 串）。\n * 全部句柄在本函数内释放（compound + 边；输入 shape 不消费）。\n */\nfunction projectPolylines(shape: Shape, view: ViewSpec): { visible: string[]; hidden: string[] } {\n  const solid = brepOf(shape) as BrepHandle | undefined\n  if (solid === undefined) {\n    throw new Error(\n      '[faijs/view-projection] E_BREP_ONLY_INPUT: operation requires a BREP-backed shape ' +\n        '(mesh-only input cannot be projected)',\n    )\n  }\n  const api = getBrepApi()\n  const cam = resolveCamera(view) as unknown as Camera\n  const r = api.projectEdges(\n    solid,\n    { x: cam.position[0], y: cam.position[1], z: cam.position[2] },\n    { x: cam.direction[0], y: cam.direction[1], z: cam.direction[2] },\n    { x: cam.xAxis[0], y: cam.xAxis[1], z: cam.xAxis[2] },\n    true,\n    0.1,\n  ) as ProjectEdgesResult\n\n  const out: { visible: string[]; hidden: string[] } = { visible: [], hidden: [] }\n  const toHandle = (id: number): BrepHandle => id as BrepHandle\n  try {\n    for (const [key, group] of COMPOUND_KEYS) {\n      const compoundId = r[key]\n      if (typeof compoundId !== 'number' || compoundId === 0) continue\n      const edges = api.getSubShapes(toHandle(compoundId), 'edge')\n      for (const edge of edges) {\n        const d = edgeToPath(api, edge, cam)\n        if (d !== null) out[group].push(d)\n      }\n      // 释放 compound slot（幂等）\n      try {\n        api.release(toHandle(compoundId))\n      } catch {\n        // already released\n      }\n    }\n  } finally {\n    void 0\n  }\n  return out\n}\n\n/** 单条边 → SVG path d 串（3D 曲线采样折线投影到相机平面）。 */\nfunction edgeToPath(api: ReturnType<typeof getBrepApi>, edge: BrepHandle, cam: Camera): string | null {\n  let cp\n  try {\n    cp = api.curveParameters(edge)\n  } catch {\n    return null // 退化边（如孤立顶点线）无曲线参数\n  }\n  const { first, last } = cp\n  const span = last - first\n  const pts: [number, number][] = []\n  for (let i = 0; i < EDGE_SAMPLES; i += 1) {\n    const t = first + (span * i) / (EDGE_SAMPLES - 1)\n    const p = api.curvePointAtParam(edge, t)\n    pts.push(projectTo2D([p.x, p.y, p.z], cam))\n  }\n  if (pts.length < 2) return null\n  let d = `M ${pts[0][0].toFixed(4)} ${pts[0][1].toFixed(4)}`\n  for (let i = 1; i < pts.length; i += 1) {\n    d += ` L ${pts[i][0].toFixed(4)} ${pts[i][1].toFixed(4)}`\n  }\n  return d\n}\n\n/** 解析 'minX minY w h' 为数值数组。 */\nfunction parseViewBox(vb: string): [number, number, number, number] | undefined {\n  const parts = vb.trim().split(/\\s+/).map(Number)\n  if (parts.length !== 4 || parts.some((n) => !Number.isFinite(n))) return undefined\n  return [parts[0], parts[1], parts[2], parts[3]]\n}\n\n/** 折线点集 bbox → viewBox（统一坐标系；margin 再外扩）。 */\nfunction viewBoxOfPaths(paths: string[], margin: number): string {\n  let minX = Infinity\n  let minY = Infinity\n  let maxX = -Infinity\n  let maxY = -Infinity\n  for (const d of paths) {\n    const nums = d.match(/[-+]?\\d*\\.?\\d+(?:[eE][-+]?\\d+)?/g) ?? []\n    for (let i = 0; i + 1 < nums.length; i += 2) {\n      const x = Number(nums[i])\n      const y = Number(nums[i + 1])\n      if (!Number.isFinite(x) || !Number.isFinite(y)) continue\n      minX = Math.min(minX, x)\n      minY = Math.min(minY, y)\n      maxX = Math.max(maxX, x)\n      maxY = Math.max(maxY, y)\n    }\n  }\n  if (!Number.isFinite(minX)) return '0 0 0 0' // 空投影（如空 shape）\n  return `${minX - margin} ${minY - margin} ${maxX - minX + 2 * margin} ${maxY - minY + 2 * margin}`\n}\n\n/**\n * 单视图投影（结构化结果）。\n *\n * @param shape - 待投影的 faijs Shape（必须带 BREP 槽；mesh-only 输入抛 E_BREP_ONLY_INPUT）。\n * @param view - 视图规格（标准视图 / iso / 轴对平面 / 方向对象）。\n * @param opts - 序列化选项。\n * @returns 结构化投影结果（svg/viewBox/paths/尺寸）。\n */\nexport function projectViewSvg(shape: Shape, view: ViewSpec, opts: ProjectViewOptions = {}): ProjectionSvg {\n  const { visible: visiblePaths, hidden: hiddenPaths } = projectPolylines(shape, view)\n  const margin = opts.margin ?? 1\n  const viewBox = viewBoxOfPaths([...visiblePaths, ...hiddenPaths], margin)\n  const parsed = parseViewBox(viewBox) ?? [0, 0, 0, 0]\n  const width = opts.width ?? parsed[2]\n  const height = opts.height ?? parsed[3]\n  const strokeWidth = opts.strokeWidth ?? 1\n  const dash = opts.dash ?? '4,4'\n  const hiddenOpacity = opts.hiddenOpacity ?? 0.6\n  const visibleMarkup = visiblePaths\n    .map((d) => `<path d=\"${d}\" fill=\"none\" stroke=\"#000\" stroke-width=\"${strokeWidth}\" />`)\n    .join('\\n    ')\n  const hiddenMarkup = hiddenPaths\n    .map(\n      (d) =>\n        `<path d=\"${d}\" fill=\"none\" stroke=\"#000\" stroke-width=\"${strokeWidth}\" stroke-dasharray=\"${dash}\" opacity=\"${hiddenOpacity}\" />`,\n    )\n    .join('\\n    ')\n  const svg = [\n    `<svg version=\"1.1\" xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"${viewBox}\" width=\"${width}\" height=\"${height}\" fill=\"none\" stroke=\"black\" stroke-width=\"0.6%\" vector-effect=\"non-scaling-stroke\">`,\n    `  <g stroke=\"#000\" fill=\"none\">`,\n    `    ${visibleMarkup}${hiddenMarkup === '' ? '' : `\\n    ${hiddenMarkup}`}`,\n    `  </g>`,\n    `</svg>`,\n  ].join('\\n')\n  return { svg, viewBox, paths: { visible: visiblePaths, hidden: hiddenPaths }, width, height }\n}\n\n/**\n * 单视图投影 → SVG 线稿字符串（纯数据，不消费/修改 shape；规则 1 下裸调用不消费输入）。\n * @group 查询\n * @inputs 1\n * @async false\n * @qual ok\n * @name projectView\n * @returns SVG 字符串（<svg viewBox=\"…\"> + 可见实线 <path> + 隐藏虚线 <path>）。裸调用 cad.projectView(part0, 'front') 不消费 part0（规则 1），part 仍留在 canvas。\n * @param shape - 目标几何（必须有 BREP 槽；mesh-only 抛 E_BREP_ONLY_INPUT）。type:Shape required:true\n * @param view - 视图规格（同 viewCamera：标准视图名 / iso / 轴对平面 / 方向对象）。type:string|{dir,xAxis?} required:true\n * @param opts.strokeWidth - 可见线宽（stroke-width）。type:number 默认 1\n * @param opts.dash - 隐藏线虚线样式（stroke-dasharray）。type:string 默认 '4,4'\n * @param opts.hiddenOpacity - 隐藏线透明度。type:number 默认 0.6\n * @param opts.margin - viewBox 外扩边距。type:number 默认 1\n * @param opts.width - 输出宽度（缺省 = viewBox 宽度）。type:number\n * @param opts.height - 输出高度（缺省 = viewBox 高度）。type:number\n * @example\n * const svg = cad.projectView(part0, 'front')\n * const svg = cad.projectView(part0, 'iso', { strokeWidth: 1, dash: '4,4', hiddenOpacity: 0.6 })\n  */\nexport function projectView(shape: Shape, view: ViewSpec, opts?: ProjectViewOptions): string {\n  return projectViewSvg(shape, view, opts).svg\n}\n"]}

package/dist/api/wire.d.ts

@@ -0,0 +1,45 @@
+/**
+ * stdlib wire — 从点列构造 1D 曲线（折线 / 闭合轮廓 / 平滑样条）
+ *
+ * 用途：脚本面造线能力（G-D 门控层，Phase 3）。下游 sweep / loft / twistExtrude /
+ * complexExtrude / roof 等 11 个动作都需要 wire 输入；此前脚本面造不出 wire，这些动作
+ * 即使登记也喂不进输入。
+ *
+ * 设计：
+ * - 中立 op（dual-path）：mesh 路径用折线 mesh 包成 `curve(mesh)`；brep 路径用 L1 构造
+ *   （makeLineEdge / interpolatePoints + makeWire），经 `fromBrepCurve` 登记 1D 句柄。
+ *   两种 mode 下 kind 都取 'curve'，避免随 mode 漂移（§7.1 建议 1 / 附带子项②推荐 (i)）。
+ * - 无输入（creator），故 dispatch 走 mesh（mode=mesh）或 brep（mode=brep/auto 有 brep 实现）。
+ * - 1D 产物命名取 unmodeled（无面 → 无 roleTable，先例 torus/convexHull）。
+ */
+import type { Shape } from '../mesh/types.js';
+/** 一个 3D 点（点列成员）。 */
+export type WirePoint = [number, number, number];
+/** `cad.wire` 选项：折线 / 闭合轮廓 / 平滑曲线。 */
+export interface WireOptions {
+    /** 闭合轮廓：首尾相连。 */
+    closed?: boolean;
+    /** 平滑曲线：经 interpolatePoints 走 B-样条穿过全部点（默认折线）。 */
+    smooth?: boolean;
+    /** smooth 时的样条次数（默认 3）。 */
+    degree?: number;
+}
+/**
+ * 从点列构造 1D 曲线（折线 / 闭合轮廓 / 平滑样条）。
+ * @group 创建
+ * @inputs 0
+ * @async false
+ * @qual ok
+ * @name wire
+ * @returns Shape 1D 曲线（kind:'curve'，无三角载荷；显示经 wireframe）。
+ * @param points - 有序点列 [[x,y,z], ...]，至少 2 点。type:Vec3[] required:true
+ * @param options.closed - 闭合轮廓（首尾相连）。type:boolean required:false
+ * @param options.smooth - 平滑曲线（B-样条穿过全部点，默认折线）。type:boolean required:false
+ * @param options.degree - smooth 时的样条次数（默认 3）。type:number required:false
+ * @example
+ * const w = cad.wire([[0,0,0],[10,0,0],[10,10,0]], { closed: true })
+ */
+export declare const wire: ((points: WirePoint[], opts?: WireOptions | undefined) => Promise<Shape>) & {
+    __faijs__dualOp?: import("../define-op.js").DualOpMeta;
+};
+//# sourceMappingURL=wire.d.ts.map

package/dist/api/wire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../../src/api/wire.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAS1C,qBAAqB;AACrB,MAAM,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAEhD,sCAAsC;AACtC,MAAM,WAAW,WAAW;IAC1B,iBAAiB;IACjB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,kDAAkD;IAClD,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAsDD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,IAAI;;CAQf,CAAA"}

package/dist/api/wire.js

@@ -0,0 +1,96 @@
+/**
+ * stdlib wire — 从点列构造 1D 曲线（折线 / 闭合轮廓 / 平滑样条）
+ *
+ * 用途：脚本面造线能力（G-D 门控层，Phase 3）。下游 sweep / loft / twistExtrude /
+ * complexExtrude / roof 等 11 个动作都需要 wire 输入；此前脚本面造不出 wire，这些动作
+ * 即使登记也喂不进输入。
+ *
+ * 设计：
+ * - 中立 op（dual-path）：mesh 路径用折线 mesh 包成 `curve(mesh)`；brep 路径用 L1 构造
+ *   （makeLineEdge / interpolatePoints + makeWire），经 `fromBrepCurve` 登记 1D 句柄。
+ *   两种 mode 下 kind 都取 'curve'，避免随 mode 漂移（§7.1 建议 1 / 附带子项②推荐 (i)）。
+ * - 无输入（creator），故 dispatch 走 mesh（mode=mesh）或 brep（mode=brep/auto 有 brep 实现）。
+ * - 1D 产物命名取 unmodeled（无面 → 无 roleTable，先例 torus/convexHull）。
+ */
+import { getBrepApi } from '../brep/handle-bridge.js';
+import { solidToShape } from '../brep/brep-ops.js';
+import { curve, fromBrepCurve } from '../shape.js';
+import { defineOp } from '../sdk.js';
+/** 校验并归一化点列（至少 2 点，每点 [x,y,z]）。 */
+function normalizePoints(raw) {
+    if (!Array.isArray(raw) || raw.length < 2) {
+        throw new Error('E_WIRE_TOO_FEW_POINTS: wire requires at least 2 points');
+    }
+    const pts = [];
+    for (const p of raw) {
+        if (!Array.isArray(p) || p.length < 3) {
+            throw new Error('E_WIRE_BAD_POINT: each wire point must be [x, y, z]');
+        }
+        pts.push({ x: Number(p[0]), y: Number(p[1]), z: Number(p[2]) });
+    }
+    return pts;
+}
+/** mesh 路径：折线 mesh 载荷（位置 + 线段索引），包成 curve（kind 维持 'curve'）。 */
+function wireMesh(points, opts) {
+    const pts = normalizePoints(points);
+    const closed = !!(opts && opts.closed);
+    const positions = [];
+    for (const p of pts)
+        positions.push(p.x, p.y, p.z);
+    if (closed)
+        positions.push(pts[0].x, pts[0].y, pts[0].z);
+    const n = pts.length + (closed ? 1 : 0);
+    const indices = [];
+    for (let i = 0; i < n - 1; i++)
+        indices.push(i, i + 1);
+    return curve({ positions: new Float32Array(positions), indices: new Uint32Array(indices) });
+}
+/** BREP 路径：点列 → wire（折线或平滑样条），经 fromBrepCurve 登记 1D 句柄。 */
+function wireBrep(points, opts) {
+    const pts = normalizePoints(points);
+    const closed = !!(opts && opts.closed);
+    const smooth = !!(opts && opts.smooth);
+    const kernel = getBrepApi();
+    let handle;
+    if (smooth && pts.length >= 2) {
+        // 平滑曲线：interpolatePoints 返回穿过全部点的 B-样条（曲线/线柄），直接作为 wire 载荷。
+        const degree = typeof opts?.degree === 'number' ? opts.degree : 3;
+        handle = kernel.interpolatePoints(pts, degree);
+    }
+    else {
+        const edges = [];
+        const segCount = closed ? pts.length : pts.length - 1;
+        for (let i = 0; i < segCount; i++) {
+            const a = pts[i];
+            const b = pts[(i + 1) % pts.length];
+            edges.push(kernel.makeLineEdge(a, b));
+        }
+        handle = kernel.makeWire(edges);
+    }
+    return fromBrepCurve(solidToShape(kernel, handle), { solid: handle });
+}
+/**
+ * 从点列构造 1D 曲线（折线 / 闭合轮廓 / 平滑样条）。
+ * @group 创建
+ * @inputs 0
+ * @async false
+ * @qual ok
+ * @name wire
+ * @returns Shape 1D 曲线（kind:'curve'，无三角载荷；显示经 wireframe）。
+ * @param points - 有序点列 [[x,y,z], ...]，至少 2 点。type:Vec3[] required:true
+ * @param options.closed - 闭合轮廓（首尾相连）。type:boolean required:false
+ * @param options.smooth - 平滑曲线（B-样条穿过全部点，默认折线）。type:boolean required:false
+ * @param options.degree - smooth 时的样条次数（默认 3）。type:number required:false
+ * @example
+ * const w = cad.wire([[0,0,0],[10,0,0],[10,10,0]], { closed: true })
+ */
+export const wire = defineOp({
+    mesh(points, opts) {
+        return wireMesh(points, opts);
+    },
+    brep(points, opts) {
+        return wireBrep(points, opts);
+    },
+    naming: { kind: 'unmodeled', reason: 'construct vocabulary pending Phase 3' },
+});
+//# sourceMappingURL=wire.js.map