@faicad/faijs 0.29.5 → 0.30.9

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

@@ -1,27 +1,25 @@
 /**
  * view-camera — 视图规格 → 投影相机（faijs 视图投影能力，路径 A 纯数据面）
  *
- * 设计文档：docs/plans/2026-09-10-faijs-view-projection-and-screenshot.md §3.2
- *
  * 视图规格（ViewSpec）：
  *   - 六个标准正交视图：'front' | 'back' | 'top' | 'bottom' | 'left' | 'right'
- *     （方向沿用 vendored brepjs PROJECTION_PLANES：front=(0,-1,0)、top=(0,0,-1)…，
+ *     （方向沿用早期 brepjs PROJECTION_PLANES：front=(0,-1,0)、top=(0,0,-1)…，
  *      与 FreeCAD TechDraw 的方向向量惯例一致，见方案 §2.2）；
  *   - 等轴测：'iso' | 'isometric'（方向 (1,-1,1)，方案 §2.3 定稿）；
- *   - 轴对平面：'XY' | 'XZ' | 'YZ' | 'YX' | 'ZX' | 'ZY'（vendored 平面名）；
+ *   - 轴对平面：'XY' | 'XZ' | 'YZ' | 'YX' | 'ZX' | 'ZY'（早期平面名）；
  *   - 任意方向：{ dir: Vec3, xAxis?: Vec3 }（xAxis 缺省由方向自动推导）。
  *
  * viewCamera 是纯数据函数（无 Shape 输入，kind 'pure' 语义）：把视图规格解析成
- * vendored brepjs 的 Camera 纯数据对象，供 projectView/projectSheet 与宿主复用。
- * 返回类型 re-export 自 vendored（api/generated/projection.ts 已登记 Camera type）。
+ * Camera 纯数据对象，供 projectView/projectSheet 与宿主复用。
+ * 返回类型 re-export 自第一方投影模块（api/generated/projection.ts 已登记 Camera type）。
  */
 import { type Camera } from './cameraFns.js';
-import type { Vec3 } from '../brepjs-compat/types.js';
-/** 六个标准正交视图名（vendored CubeFace 同集）。 */
+import type { Vec3 } from '../geom-types/types.js';
+/** 六个标准正交视图名（与 CubeFace 同集）。 */
 export type StandardView = 'front' | 'back' | 'top' | 'bottom' | 'left' | 'right';
 /** 等轴测视图名（faijs 新增别名；方向 (1,-1,1)）。 */
 export type IsoView = 'iso' | 'isometric';
-/** 轴对平面名（vendored ProjectionPlane 的子集）。 */
+/** 轴对平面名（ProjectionPlane 的子集）。 */
 export type AxisPlaneView = 'XY' | 'XZ' | 'YZ' | 'YX' | 'ZX' | 'ZY';
 /** 任意方向视图规格。 */
 export interface DirectionView {

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,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"}
+{"version":3,"file":"view-camera.d.ts","sourceRoot":"","sources":["../../../src/api/view/view-camera.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAiC,KAAK,MAAM,EAAE,MAAM,aAAa,CAAA;AAGxE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAE/C,gCAAgC;AAChC,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,kCAAkC;AAClC,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

@@ -1,19 +1,17 @@
 /**
  * view-camera — 视图规格 → 投影相机（faijs 视图投影能力，路径 A 纯数据面）
  *
- * 设计文档：docs/plans/2026-09-10-faijs-view-projection-and-screenshot.md §3.2
- *
  * 视图规格（ViewSpec）：
  *   - 六个标准正交视图：'front' | 'back' | 'top' | 'bottom' | 'left' | 'right'
- *     （方向沿用 vendored brepjs PROJECTION_PLANES：front=(0,-1,0)、top=(0,0,-1)…，
+ *     （方向沿用早期 brepjs PROJECTION_PLANES：front=(0,-1,0)、top=(0,0,-1)…，
  *      与 FreeCAD TechDraw 的方向向量惯例一致，见方案 §2.2）；
  *   - 等轴测：'iso' | 'isometric'（方向 (1,-1,1)，方案 §2.3 定稿）；
- *   - 轴对平面：'XY' | 'XZ' | 'YZ' | 'YX' | 'ZX' | 'ZY'（vendored 平面名）；
+ *   - 轴对平面：'XY' | 'XZ' | 'YZ' | 'YX' | 'ZX' | 'ZY'（早期平面名）；
  *   - 任意方向：{ dir: Vec3, xAxis?: Vec3 }（xAxis 缺省由方向自动推导）。
  *
  * viewCamera 是纯数据函数（无 Shape 输入，kind 'pure' 语义）：把视图规格解析成
- * vendored brepjs 的 Camera 纯数据对象，供 projectView/projectSheet 与宿主复用。
- * 返回类型 re-export 自 vendored（api/generated/projection.ts 已登记 Camera type）。
+ * Camera 纯数据对象，供 projectView/projectSheet 与宿主复用。
+ * 返回类型 re-export 自第一方投影模块（api/generated/projection.ts 已登记 Camera type）。
  */
 import { createCamera, cameraFromPlane } from './cameraFns.js';
 import { isProjectionPlane } from './projectionPlanes.js';

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,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"]}
+{"version":3,"file":"view-camera.js","sourceRoot":"","sources":["../../../src/api/view/view-camera.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;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 * 视图规格（ViewSpec）：\n *   - 六个标准正交视图：'front' | 'back' | 'top' | 'bottom' | 'left' | 'right'\n *     （方向沿用早期 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'（早期平面名）；\n *   - 任意方向：{ dir: Vec3, xAxis?: Vec3 }（xAxis 缺省由方向自动推导）。\n *\n * viewCamera 是纯数据函数（无 Shape 输入，kind 'pure' 语义）：把视图规格解析成\n * Camera 纯数据对象，供 projectView/projectSheet 与宿主复用。\n * 返回类型 re-export 自第一方投影模块（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 '../geom-types/types'\n\n/** 六个标准正交视图名（与 CubeFace 同集）。 */\nexport type StandardView = 'front' | 'back' | 'top' | 'bottom' | 'left' | 'right'\n\n/** 等轴测视图名（faijs 新增别名；方向 (1,-1,1)）。 */\nexport type IsoView = 'iso' | 'isometric'\n\n/** 轴对平面名（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

@@ -1,8 +1,6 @@
 /**
  * view-projection — 单视图投影 → SVG 线稿（faijs 视图投影能力，路径 A）
  *
- * 设计文档：docs/plans/2026-09-10-faijs-view-projection-and-screenshot.md §3.2
- *
  * projectView(shape, view, opts?) 返回**纯数据 SVG 字符串**（非 Shape）：
  *   - 直连 core 引擎的 HLR 投影（`BrepEngineApi.projectEdges`，OCCT
  *     HLRBRep 隐线消除）：可见 / 隐藏两组边（sharp/smooth/outline compound）；

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;;;;;;;;;;;;;;;;;;;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"}
+{"version":3,"file":"view-projection.d.ts","sourceRoot":"","sources":["../../../src/api/view/view-projection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;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

@@ -1,8 +1,6 @@
 /**
  * view-projection — 单视图投影 → SVG 线稿（faijs 视图投影能力，路径 A）
  *
- * 设计文档：docs/plans/2026-09-10-faijs-view-projection-and-screenshot.md §3.2
- *
  * projectView(shape, view, opts?) 返回**纯数据 SVG 字符串**（非 Shape）：
  *   - 直连 core 引擎的 HLR 投影（`BrepEngineApi.projectEdges`，OCCT
  *     HLRBRep 隐线消除）：可见 / 隐藏两组边（sharp/smooth/outline compound）；

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 *   - 直连 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"]}
+{"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 * 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/view/view-sheet.d.ts

@@ -1,8 +1,6 @@
 /**
  * view-sheet — 多视图投影图纸（三视图 + 等轴测组合 SVG，faijs 路径 A）
  *
- * 设计文档：docs/plans/2026-09-10-faijs-view-projection-and-screenshot.md §3.2
- *
  * projectSheet(shape, views, opts?) 把多个单视图投影按网格排布为一个 SVG：
  *   - 每个视图用嵌套 `<svg>`（绝对定位 + 各自 viewBox，preserveAspectRatio 保比例）；
  *   - 每个视图可带标签（默认用视图名，如 'front' / 'iso'）；

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

@@ -1 +1 @@
-{"version":3,"file":"view-sheet.d.ts","sourceRoot":"","sources":["../../../src/api/view/view-sheet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAC3E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE7C,0BAA0B;AAC1B,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,QAAQ,CAAA;IACd,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,yBAAyB;AACzB,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC7D,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,sBAAsB;IACtB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,yBAAyB;IACzB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,mBAAmB;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAaD;;;;;;;;;;;;;;;;;;IAkBI;AACJ,wBAAgB,YAAY,CAC1B,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,CAAC,QAAQ,GAAG,SAAS,CAAC,EAAE,EAC/B,IAAI,GAAE,mBAAwB,GAC7B,MAAM,CAsDR"}
+{"version":3,"file":"view-sheet.d.ts","sourceRoot":"","sources":["../../../src/api/view/view-sheet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAC3E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE7C,0BAA0B;AAC1B,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,QAAQ,CAAA;IACd,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,yBAAyB;AACzB,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC7D,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,sBAAsB;IACtB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,yBAAyB;IACzB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,mBAAmB;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAaD;;;;;;;;;;;;;;;;;;IAkBI;AACJ,wBAAgB,YAAY,CAC1B,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,CAAC,QAAQ,GAAG,SAAS,CAAC,EAAE,EAC/B,IAAI,GAAE,mBAAwB,GAC7B,MAAM,CAsDR"}

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

@@ -1,8 +1,6 @@
 /**
  * view-sheet — 多视图投影图纸（三视图 + 等轴测组合 SVG，faijs 路径 A）
  *
- * 设计文档：docs/plans/2026-09-10-faijs-view-projection-and-screenshot.md §3.2
- *
  * projectSheet(shape, views, opts?) 把多个单视图投影按网格排布为一个 SVG：
  *   - 每个视图用嵌套 `<svg>`（绝对定位 + 各自 viewBox，preserveAspectRatio 保比例）；
  *   - 每个视图可带标签（默认用视图名，如 'front' / 'iso'）；

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

@@ -1 +1 @@
-{"version":3,"file":"view-sheet.js","sourceRoot":"","sources":["../../../src/api/view/view-sheet.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * view-sheet — 多视图投影图纸（三视图 + 等轴测组合 SVG，faijs 路径 A）\n *\n * 设计文档：docs/plans/2026-09-10-faijs-view-projection-and-screenshot.md §3.2\n *\n * projectSheet(shape, views, opts?) 把多个单视图投影按网格排布为一个 SVG：\n *   - 每个视图用嵌套 `<svg>`（绝对定位 + 各自 viewBox，preserveAspectRatio 保比例）；\n *   - 每个视图可带标签（默认用视图名，如 'front' / 'iso'）；\n *   - 布局参数（列数/间距/留白）可调，缺省按 sqrt 自动分列。\n *\n * 典型用法：三视图 + 等轴测工程图纸。\n *   const sheet = projectSheet(part, ['front', 'top', 'right', 'iso'])\n */\n\nimport type { Shape } from '../../mesh/types'\nimport { projectViewSvg, type ProjectViewOptions } from './view-projection'\nimport type { ViewSpec } from './view-camera'\n\n/** 单个图纸视图：视图规格 + 可选标签。 */\nexport interface SheetView {\n  view: ViewSpec\n  /** 视图标签（缺省取视图名/方向描述）。 */\n  label?: string\n}\n\n/** projectSheet 布局选项。 */\nexport interface ProjectSheetOptions extends ProjectViewOptions {\n  /** 网格列数（缺省 ceil(sqrt(n))）。 */\n  cols?: number\n  /** 相邻单元格间距（缺省 24）。 */\n  gap?: number\n  /** 图纸外留白（缺省 24）。 */\n  padding?: number\n  /** 是否渲染视图标签（缺省 true）。 */\n  labels?: boolean\n  /** 标签字号（缺省 12）。 */\n  labelFontSize?: number\n}\n\nfunction labelOf(item: SheetView): string {\n  if (item.label !== undefined) return item.label\n  if (typeof item.view === 'string') return item.view\n  const [x, y, z] = item.view.dir\n  return `${x},${y},${z}`\n}\n\nfunction escapeXml(s: string): string {\n  return s.replace(/[<>&'\"]/g, (c) => ({ '<': '&lt;', '>': '&gt;', '&': '&amp;', \"'\": '&apos;', '\"': '&quot;' })[c] as string)\n}\n\n/**\n * 多视图投影图纸 → 组合 SVG 字符串（纯数据，不消费/修改 shape）。\n * @group 查询\n * @inputs 1\n * @async false\n * @qual ok\n * @name projectSheet\n * @returns SVG 字符串（嵌套 <svg x y width height viewBox preserveAspectRatio> + <text> 标签）。空列表返回空 SVG 不抛错。\n * @param shape - 目标几何（必须有 BREP 槽；mesh-only 抛 E_BREP_ONLY_INPUT）。type:Shape required:true\n * @param views - 视图列表：视图规格字符串，或 { view, label? } 对象（方向对象自动生成 x,y,z 标签）。type:(string|{view,label?})[] required:true\n * @param opts.cols - 网格列数。type:number 默认 2\n * @param opts.gap - 格间距（px）。type:number 默认 30\n * @param opts.labels - 是否渲染 <text> 标签。type:boolean 默认 true\n * @param opts.cellWidth - 每格画布宽度。type:number 默认 400\n * @param opts.cellHeight - 每格画布高度。type:number 默认 300\n * @example\n * const sheet = cad.projectSheet(part0, ['front', 'top', 'right', 'iso'])\n * const sheet = cad.projectSheet(part0, [{ view: 'front', label: '主视图' }], { cols: 2, gap: 40, labels: true })\n  */\nexport function projectSheet(\n  shape: Shape,\n  views: (ViewSpec | SheetView)[],\n  opts: ProjectSheetOptions = {},\n): string {\n  const items: SheetView[] = views.map((v) =>\n    typeof v === 'string' ? { view: v, label: v } : 'view' in v ? v : { view: v },\n  )\n  if (items.length === 0) {\n    return '<svg version=\"1.1\" xmlns=\"http://www.w3.org/2000/svg\" width=\"0\" height=\"0\" />'\n  }\n  const n = items.length\n  const cols = opts.cols ?? Math.ceil(Math.sqrt(n))\n  const gap = opts.gap ?? 24\n  const padding = opts.padding ?? 24\n  const labels = opts.labels !== false\n  const labelFontSize = opts.labelFontSize ?? 12\n\n  const projections = items.map((it) => ({ ...projectViewSvg(shape, it.view, opts), label: labelOf(it) }))\n  const labelPadY = labels ? labelFontSize + 10 : 0\n  const cellW = Math.max(...projections.map((p) => p.width))\n  const cellH = Math.max(...projections.map((p) => p.height)) + labelPadY\n  const rows = Math.ceil(n / cols)\n  const totalW = cols * cellW + (cols - 1) * gap + 2 * padding\n  const totalH = rows * cellH + (rows - 1) * gap + 2 * padding\n\n  const cells: string[] = []\n  projections.forEach((p, i) => {\n    const col = i % cols\n    const row = Math.floor(i / cols)\n    const x = padding + col * (cellW + gap)\n    const y = padding + row * (cellH + gap)\n    const inner = [\n      `<svg x=\"${x}\" y=\"${y}\" width=\"${cellW}\" height=\"${p.height}\" viewBox=\"${p.viewBox}\" preserveAspectRatio=\"xMidYMid meet\" fill=\"none\" stroke=\"black\" stroke-width=\"0.6%\" vector-effect=\"non-scaling-stroke\">`,\n      `  <g stroke=\"#000\" fill=\"none\">`,\n    ]\n    for (const d of p.paths.visible) {\n      inner.push(`    <path d=\"${d}\" fill=\"none\" stroke=\"#000\" stroke-width=\"${opts.strokeWidth ?? 1}\" />`)\n    }\n    for (const d of p.paths.hidden) {\n      inner.push(\n        `    <path d=\"${d}\" fill=\"none\" stroke=\"#000\" stroke-width=\"${opts.strokeWidth ?? 1}\" stroke-dasharray=\"${opts.dash ?? '4,4'}\" opacity=\"${opts.hiddenOpacity ?? 0.6}\" />`,\n      )\n    }\n    inner.push('  </g>', `</svg>`)\n    if (labels) {\n      inner.push(\n        `<text x=\"${x + cellW / 2}\" y=\"${y + p.height + labelFontSize}\" text-anchor=\"middle\" font-size=\"${labelFontSize}\" fill=\"#000\">${escapeXml(p.label)}</text>`,\n      )\n    }\n    cells.push(inner.join('\\n'))\n  })\n\n  return [\n    `<svg version=\"1.1\" xmlns=\"http://www.w3.org/2000/svg\" width=\"${totalW}\" height=\"${totalH}\" fill=\"none\" stroke=\"black\" stroke-width=\"0.6%\" vector-effect=\"non-scaling-stroke\">`,\n    cells.map((c) => `  ${c}`).join('\\n'),\n    `</svg>`,\n  ].join('\\n')\n}\n"]}
+{"version":3,"file":"view-sheet.js","sourceRoot":"","sources":["../../../src/api/view/view-sheet.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * view-sheet — 多视图投影图纸（三视图 + 等轴测组合 SVG，faijs 路径 A）\n *\n * projectSheet(shape, views, opts?) 把多个单视图投影按网格排布为一个 SVG：\n *   - 每个视图用嵌套 `<svg>`（绝对定位 + 各自 viewBox，preserveAspectRatio 保比例）；\n *   - 每个视图可带标签（默认用视图名，如 'front' / 'iso'）；\n *   - 布局参数（列数/间距/留白）可调，缺省按 sqrt 自动分列。\n *\n * 典型用法：三视图 + 等轴测工程图纸。\n *   const sheet = projectSheet(part, ['front', 'top', 'right', 'iso'])\n */\n\nimport type { Shape } from '../../mesh/types'\nimport { projectViewSvg, type ProjectViewOptions } from './view-projection'\nimport type { ViewSpec } from './view-camera'\n\n/** 单个图纸视图：视图规格 + 可选标签。 */\nexport interface SheetView {\n  view: ViewSpec\n  /** 视图标签（缺省取视图名/方向描述）。 */\n  label?: string\n}\n\n/** projectSheet 布局选项。 */\nexport interface ProjectSheetOptions extends ProjectViewOptions {\n  /** 网格列数（缺省 ceil(sqrt(n))）。 */\n  cols?: number\n  /** 相邻单元格间距（缺省 24）。 */\n  gap?: number\n  /** 图纸外留白（缺省 24）。 */\n  padding?: number\n  /** 是否渲染视图标签（缺省 true）。 */\n  labels?: boolean\n  /** 标签字号（缺省 12）。 */\n  labelFontSize?: number\n}\n\nfunction labelOf(item: SheetView): string {\n  if (item.label !== undefined) return item.label\n  if (typeof item.view === 'string') return item.view\n  const [x, y, z] = item.view.dir\n  return `${x},${y},${z}`\n}\n\nfunction escapeXml(s: string): string {\n  return s.replace(/[<>&'\"]/g, (c) => ({ '<': '&lt;', '>': '&gt;', '&': '&amp;', \"'\": '&apos;', '\"': '&quot;' })[c] as string)\n}\n\n/**\n * 多视图投影图纸 → 组合 SVG 字符串（纯数据，不消费/修改 shape）。\n * @group 查询\n * @inputs 1\n * @async false\n * @qual ok\n * @name projectSheet\n * @returns SVG 字符串（嵌套 <svg x y width height viewBox preserveAspectRatio> + <text> 标签）。空列表返回空 SVG 不抛错。\n * @param shape - 目标几何（必须有 BREP 槽；mesh-only 抛 E_BREP_ONLY_INPUT）。type:Shape required:true\n * @param views - 视图列表：视图规格字符串，或 { view, label? } 对象（方向对象自动生成 x,y,z 标签）。type:(string|{view,label?})[] required:true\n * @param opts.cols - 网格列数。type:number 默认 2\n * @param opts.gap - 格间距（px）。type:number 默认 30\n * @param opts.labels - 是否渲染 <text> 标签。type:boolean 默认 true\n * @param opts.cellWidth - 每格画布宽度。type:number 默认 400\n * @param opts.cellHeight - 每格画布高度。type:number 默认 300\n * @example\n * const sheet = cad.projectSheet(part0, ['front', 'top', 'right', 'iso'])\n * const sheet = cad.projectSheet(part0, [{ view: 'front', label: '主视图' }], { cols: 2, gap: 40, labels: true })\n  */\nexport function projectSheet(\n  shape: Shape,\n  views: (ViewSpec | SheetView)[],\n  opts: ProjectSheetOptions = {},\n): string {\n  const items: SheetView[] = views.map((v) =>\n    typeof v === 'string' ? { view: v, label: v } : 'view' in v ? v : { view: v },\n  )\n  if (items.length === 0) {\n    return '<svg version=\"1.1\" xmlns=\"http://www.w3.org/2000/svg\" width=\"0\" height=\"0\" />'\n  }\n  const n = items.length\n  const cols = opts.cols ?? Math.ceil(Math.sqrt(n))\n  const gap = opts.gap ?? 24\n  const padding = opts.padding ?? 24\n  const labels = opts.labels !== false\n  const labelFontSize = opts.labelFontSize ?? 12\n\n  const projections = items.map((it) => ({ ...projectViewSvg(shape, it.view, opts), label: labelOf(it) }))\n  const labelPadY = labels ? labelFontSize + 10 : 0\n  const cellW = Math.max(...projections.map((p) => p.width))\n  const cellH = Math.max(...projections.map((p) => p.height)) + labelPadY\n  const rows = Math.ceil(n / cols)\n  const totalW = cols * cellW + (cols - 1) * gap + 2 * padding\n  const totalH = rows * cellH + (rows - 1) * gap + 2 * padding\n\n  const cells: string[] = []\n  projections.forEach((p, i) => {\n    const col = i % cols\n    const row = Math.floor(i / cols)\n    const x = padding + col * (cellW + gap)\n    const y = padding + row * (cellH + gap)\n    const inner = [\n      `<svg x=\"${x}\" y=\"${y}\" width=\"${cellW}\" height=\"${p.height}\" viewBox=\"${p.viewBox}\" preserveAspectRatio=\"xMidYMid meet\" fill=\"none\" stroke=\"black\" stroke-width=\"0.6%\" vector-effect=\"non-scaling-stroke\">`,\n      `  <g stroke=\"#000\" fill=\"none\">`,\n    ]\n    for (const d of p.paths.visible) {\n      inner.push(`    <path d=\"${d}\" fill=\"none\" stroke=\"#000\" stroke-width=\"${opts.strokeWidth ?? 1}\" />`)\n    }\n    for (const d of p.paths.hidden) {\n      inner.push(\n        `    <path d=\"${d}\" fill=\"none\" stroke=\"#000\" stroke-width=\"${opts.strokeWidth ?? 1}\" stroke-dasharray=\"${opts.dash ?? '4,4'}\" opacity=\"${opts.hiddenOpacity ?? 0.6}\" />`,\n      )\n    }\n    inner.push('  </g>', `</svg>`)\n    if (labels) {\n      inner.push(\n        `<text x=\"${x + cellW / 2}\" y=\"${y + p.height + labelFontSize}\" text-anchor=\"middle\" font-size=\"${labelFontSize}\" fill=\"#000\">${escapeXml(p.label)}</text>`,\n      )\n    }\n    cells.push(inner.join('\\n'))\n  })\n\n  return [\n    `<svg version=\"1.1\" xmlns=\"http://www.w3.org/2000/svg\" width=\"${totalW}\" height=\"${totalH}\" fill=\"none\" stroke=\"black\" stroke-width=\"0.6%\" vector-effect=\"non-scaling-stroke\">`,\n    cells.map((c) => `  ${c}`).join('\\n'),\n    `</svg>`,\n  ].join('\\n')\n}\n"]}

package/dist/api/view-export/index.d.ts

@@ -0,0 +1,97 @@
+/**
+ * api view-export — 视图与导出族（平台 op engines:['occt']，普通函数形态）
+ *
+ * @platform occt — 4 个光栅/矢量导出（`toSVG` / `toMultiviewSVG` / `toPNG` /
+ * `toMultiviewPNG`）直调 occt-wasm 原生同名方法（occt-wasm 5.6.0 有，见
+ * `dist/index.d.ts` 的 `OcctKernel`）。这些原生方法**不在** L1 契约
+ * `BrepEngineApi` 里（L1 只有导入/导出 STEP/STL，无 HLR→SVG / 光栅输出），因此它们
+ * 不能走中立路径，必须声明 `engines: ['occt']` 直调 occt（方案 §3.4.7 校正注——
+ * 原 S3 初稿把 toSVG/toMultiviewSVG 标为「中立（扩 projectView/projectSheet）」，
+ * 实测 L1 无对应成员，更正为 occt 平台 op）。
+ *
+ * 为什么不是 `defineOp`：本族返回**字符串 / Uint8Array**（非 Shape）。`defineOp` 的
+ * brep 包装（`define-op.ts#wrapBrepOne`）把返回值一律收养为 Shape，装不下文本/字节。
+ * 数据型平台 op 走普通函数，是 `api/export-brep.ts` 与 `api/shape-type` 的既定口径。
+ *
+ * 引擎身份**不能**靠 dispatchPath 门控（普通函数不走那条路）⇒ 按
+ * `api/internal/l3-bridge.ts#assertEngineFor` 的既定做法：函数体第一行断言当前引擎，
+ * 触碰内核之前报出与 D11-4 同构的 `E_BREP_UNSUPPORTED`，不补桩、不回退。
+ * （与 dispatchPath 的差异：`assertEngineFor` **不含** D11-3 的 `brep_mock` 豁免——
+ *  mock 句柄不是 occt 句柄，放行只会拿到错形状，故这里如实拦截。）
+ *
+ * 注册：api/api-namespace.ts 手动 import + 进 createApiNamespace 对象；覆盖率扫描器
+ * scan-occt-op-coverage.ts 的 PLAN_C2_EXTRA 补 4 个方法名（普通函数不在 defineOp
+ * 全集口径内，collectOps 看不见）。
+ *
+ * §9.5 降级路径（记录在案）：一旦 brepkit 的 wasm 面把 HLR/光栅渲染接进 L1 契约且两侧
+ * 适配器同时落地，这些函数删掉 assertEngineFor 并改走 `getBrepApi()`，对应方法即从 C2
+ * 转入 C1。
+ */
+import type { Shape } from '../../mesh/types.js';
+import type { ViewName, SvgViewOptions, PngViewOptions, MultiviewSvgOptions, MultiviewPngOptions } from 'occt-wasm';
+/**
+ * 将形状渲染为 SVG 字符串（HLR 隐藏线消除，单命名视图）。
+ * @group 视图
+ * @inputs 1
+ * @async false
+ * @qual ok
+ * @name toSVG
+ * @note 平台 op：仅 occt 引擎（原生 toSVG）。非 occt 引擎执行前报 E_BREP_UNSUPPORTED。
+ * @returns string SVG 文本（含命名视图与隐藏边虚线样式）。
+ * @param shape - 被渲染的形状。type:Shape required:true
+ * @param view - 命名视图（front/top/right/iso 等）。type:string required:false
+ * @param options - SVG 渲染选项。type:object required:false
+ * @example
+ * const svg = cad.toSVG(box, 'iso')
+ */
+export declare function toSVG(shape: Shape, view?: ViewName, options?: SvgViewOptions): string;
+/**
+ * 将形状渲染为多视图 SVG 图纸（Front/Top/Right/Iso 默认排布，含 gnomons 与尺寸标注）。
+ * @group 视图
+ * @inputs 1
+ * @async false
+ * @qual ok
+ * @name toMultiviewSVG
+ * @note 平台 op：仅 occt 引擎（原生 toMultiviewSVG）。非 occt 引擎执行前报
+ *       E_BREP_UNSUPPORTED。
+ * @returns string 多视图 SVG 文本。
+ * @param shape - 被渲染的形状。type:Shape required:true
+ * @param options - 多视图渲染选项。type:object required:false
+ * @example
+ * const sheet = cad.toMultiviewSVG(box)
+ */
+export declare function toMultiviewSVG(shape: Shape, options?: MultiviewSvgOptions): string;
+/**
+ * 将形状栅格化为 PNG 字节（与 toSVG 同绘制，经 CompressionStream 压缩）。
+ * @group 视图
+ * @inputs 1
+ * @async true
+ * @qual ok
+ * @name toPNG
+ * @note 平台 op：仅 occt 引擎（原生 toPNG，返回 Promise<Uint8Array>）。非 occt 引擎
+ *       执行前报 E_BREP_UNSUPPORTED。
+ * @returns Promise<Uint8Array> PNG 字节流。
+ * @param shape - 被渲染的形状。type:Shape required:true
+ * @param view - 命名视图（front/top/right/iso 等）。type:string required:false
+ * @param options - PNG 渲染选项。type:object required:false
+ * @example
+ * const png = await cad.toPNG(box, 'iso')
+ */
+export declare function toPNG(shape: Shape, view?: ViewName, options?: PngViewOptions): Promise<Uint8Array>;
+/**
+ * 将形状栅格化为多视图 PNG 字节（与 toMultiviewSVG 同绘制）。
+ * @group 视图
+ * @inputs 1
+ * @async true
+ * @qual ok
+ * @name toMultiviewPNG
+ * @note 平台 op：仅 occt 引擎（原生 toMultiviewPNG，返回 Promise<Uint8Array>）。非
+ *       occt 引擎执行前报 E_BREP_UNSUPPORTED。
+ * @returns Promise<Uint8Array> 多视图 PNG 字节流。
+ * @param shape - 被渲染的形状。type:Shape required:true
+ * @param options - 多视图渲染选项。type:object required:false
+ * @example
+ * const sheet = await cad.toMultiviewPNG(box)
+ */
+export declare function toMultiviewPNG(shape: Shape, options?: MultiviewPngOptions): Promise<Uint8Array>;
+//# sourceMappingURL=index.d.ts.map

package/dist/api/view-export/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/view-export/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,KAAK,EAAe,QAAQ,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAchI;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM,CAGrF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAGlF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAGxG;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAGrG"}

package/dist/api/view-export/index.js

@@ -0,0 +1,118 @@
+/**
+ * api view-export — 视图与导出族（平台 op engines:['occt']，普通函数形态）
+ *
+ * @platform occt — 4 个光栅/矢量导出（`toSVG` / `toMultiviewSVG` / `toPNG` /
+ * `toMultiviewPNG`）直调 occt-wasm 原生同名方法（occt-wasm 5.6.0 有，见
+ * `dist/index.d.ts` 的 `OcctKernel`）。这些原生方法**不在** L1 契约
+ * `BrepEngineApi` 里（L1 只有导入/导出 STEP/STL，无 HLR→SVG / 光栅输出），因此它们
+ * 不能走中立路径，必须声明 `engines: ['occt']` 直调 occt（方案 §3.4.7 校正注——
+ * 原 S3 初稿把 toSVG/toMultiviewSVG 标为「中立（扩 projectView/projectSheet）」，
+ * 实测 L1 无对应成员，更正为 occt 平台 op）。
+ *
+ * 为什么不是 `defineOp`：本族返回**字符串 / Uint8Array**（非 Shape）。`defineOp` 的
+ * brep 包装（`define-op.ts#wrapBrepOne`）把返回值一律收养为 Shape，装不下文本/字节。
+ * 数据型平台 op 走普通函数，是 `api/export-brep.ts` 与 `api/shape-type` 的既定口径。
+ *
+ * 引擎身份**不能**靠 dispatchPath 门控（普通函数不走那条路）⇒ 按
+ * `api/internal/l3-bridge.ts#assertEngineFor` 的既定做法：函数体第一行断言当前引擎，
+ * 触碰内核之前报出与 D11-4 同构的 `E_BREP_UNSUPPORTED`，不补桩、不回退。
+ * （与 dispatchPath 的差异：`assertEngineFor` **不含** D11-3 的 `brep_mock` 豁免——
+ *  mock 句柄不是 occt 句柄，放行只会拿到错形状，故这里如实拦截。）
+ *
+ * 注册：api/api-namespace.ts 手动 import + 进 createApiNamespace 对象；覆盖率扫描器
+ * scan-occt-op-coverage.ts 的 PLAN_C2_EXTRA 补 4 个方法名（普通函数不在 defineOp
+ * 全集口径内，collectOps 看不见）。
+ *
+ * §9.5 降级路径（记录在案）：一旦 brepkit 的 wasm 面把 HLR/光栅渲染接进 L1 契约且两侧
+ * 适配器同时落地，这些函数删掉 assertEngineFor 并改走 `getBrepApi()`，对应方法即从 C2
+ * 转入 C1。
+ */
+import { brepOf } from '../../shape.js';
+import { getOcctKernel } from '../../occt-kernel/occtKernel.js';
+import { assertEngineFor } from '../internal/l3-bridge.js';
+/** 借出形状的内核句柄；无 BREP 槽（mesh-only）报错。 */
+function occtHandleOf(shape, op) {
+    const h = brepOf(shape);
+    if (!h) {
+        throw new Error(`E_SHAPE_TYPE_NO_BREP: ${op} requires a BREP handle (mesh-only shape has none)`);
+    }
+    return h;
+}
+/**
+ * 将形状渲染为 SVG 字符串（HLR 隐藏线消除，单命名视图）。
+ * @group 视图
+ * @inputs 1
+ * @async false
+ * @qual ok
+ * @name toSVG
+ * @note 平台 op：仅 occt 引擎（原生 toSVG）。非 occt 引擎执行前报 E_BREP_UNSUPPORTED。
+ * @returns string SVG 文本（含命名视图与隐藏边虚线样式）。
+ * @param shape - 被渲染的形状。type:Shape required:true
+ * @param view - 命名视图（front/top/right/iso 等）。type:string required:false
+ * @param options - SVG 渲染选项。type:object required:false
+ * @example
+ * const svg = cad.toSVG(box, 'iso')
+ */
+export function toSVG(shape, view, options) {
+    assertEngineFor('toSVG', ['occt']);
+    return getOcctKernel().toSVG(occtHandleOf(shape, 'toSVG'), view, options);
+}
+/**
+ * 将形状渲染为多视图 SVG 图纸（Front/Top/Right/Iso 默认排布，含 gnomons 与尺寸标注）。
+ * @group 视图
+ * @inputs 1
+ * @async false
+ * @qual ok
+ * @name toMultiviewSVG
+ * @note 平台 op：仅 occt 引擎（原生 toMultiviewSVG）。非 occt 引擎执行前报
+ *       E_BREP_UNSUPPORTED。
+ * @returns string 多视图 SVG 文本。
+ * @param shape - 被渲染的形状。type:Shape required:true
+ * @param options - 多视图渲染选项。type:object required:false
+ * @example
+ * const sheet = cad.toMultiviewSVG(box)
+ */
+export function toMultiviewSVG(shape, options) {
+    assertEngineFor('toMultiviewSVG', ['occt']);
+    return getOcctKernel().toMultiviewSVG(occtHandleOf(shape, 'toMultiviewSVG'), options);
+}
+/**
+ * 将形状栅格化为 PNG 字节（与 toSVG 同绘制，经 CompressionStream 压缩）。
+ * @group 视图
+ * @inputs 1
+ * @async true
+ * @qual ok
+ * @name toPNG
+ * @note 平台 op：仅 occt 引擎（原生 toPNG，返回 Promise<Uint8Array>）。非 occt 引擎
+ *       执行前报 E_BREP_UNSUPPORTED。
+ * @returns Promise<Uint8Array> PNG 字节流。
+ * @param shape - 被渲染的形状。type:Shape required:true
+ * @param view - 命名视图（front/top/right/iso 等）。type:string required:false
+ * @param options - PNG 渲染选项。type:object required:false
+ * @example
+ * const png = await cad.toPNG(box, 'iso')
+ */
+export async function toPNG(shape, view, options) {
+    assertEngineFor('toPNG', ['occt']);
+    return getOcctKernel().toPNG(occtHandleOf(shape, 'toPNG'), view, options);
+}
+/**
+ * 将形状栅格化为多视图 PNG 字节（与 toMultiviewSVG 同绘制）。
+ * @group 视图
+ * @inputs 1
+ * @async true
+ * @qual ok
+ * @name toMultiviewPNG
+ * @note 平台 op：仅 occt 引擎（原生 toMultiviewPNG，返回 Promise<Uint8Array>）。非
+ *       occt 引擎执行前报 E_BREP_UNSUPPORTED。
+ * @returns Promise<Uint8Array> 多视图 PNG 字节流。
+ * @param shape - 被渲染的形状。type:Shape required:true
+ * @param options - 多视图渲染选项。type:object required:false
+ * @example
+ * const sheet = await cad.toMultiviewPNG(box)
+ */
+export async function toMultiviewPNG(shape, options) {
+    assertEngineFor('toMultiviewPNG', ['occt']);
+    return getOcctKernel().toMultiviewPNG(occtHandleOf(shape, 'toMultiviewPNG'), options);
+}
+//# sourceMappingURL=index.js.map

package/dist/api/view-export/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/view-export/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAIH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD,uCAAuC;AACvC,SAAS,YAAY,CAAC,KAAY,EAAE,EAAU;IAC5C,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAuC,CAAA;IAC7D,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,yBAAyB,EAAE,oDAAoD,CAAC,CAAA;IAClG,CAAC;IACD,OAAO,CAAC,CAAA;AACV,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,KAAK,CAAC,KAAY,EAAE,IAAe,EAAE,OAAwB;IAC3E,eAAe,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IAClC,OAAO,aAAa,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;AAC3E,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,cAAc,CAAC,KAAY,EAAE,OAA6B;IACxE,eAAe,CAAC,gBAAgB,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IAC3C,OAAO,aAAa,EAAE,CAAC,cAAc,CAAC,YAAY,CAAC,KAAK,EAAE,gBAAgB,CAAC,EAAE,OAAO,CAAC,CAAA;AACvF,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,KAAY,EAAE,IAAe,EAAE,OAAwB;IACjF,eAAe,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IAClC,OAAO,aAAa,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;AAC3E,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAY,EAAE,OAA6B;IAC9E,eAAe,CAAC,gBAAgB,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IAC3C,OAAO,aAAa,EAAE,CAAC,cAAc,CAAC,YAAY,CAAC,KAAK,EAAE,gBAAgB,CAAC,EAAE,OAAO,CAAC,CAAA;AACvF,CAAC","sourcesContent":["/**\n * api view-export — 视图与导出族（平台 op engines:['occt']，普通函数形态）\n *\n * @platform occt — 4 个光栅/矢量导出（`toSVG` / `toMultiviewSVG` / `toPNG` /\n * `toMultiviewPNG`）直调 occt-wasm 原生同名方法（occt-wasm 5.6.0 有，见\n * `dist/index.d.ts` 的 `OcctKernel`）。这些原生方法**不在** L1 契约\n * `BrepEngineApi` 里（L1 只有导入/导出 STEP/STL，无 HLR→SVG / 光栅输出），因此它们\n * 不能走中立路径，必须声明 `engines: ['occt']` 直调 occt（方案 §3.4.7 校正注——\n * 原 S3 初稿把 toSVG/toMultiviewSVG 标为「中立（扩 projectView/projectSheet）」，\n * 实测 L1 无对应成员，更正为 occt 平台 op）。\n *\n * 为什么不是 `defineOp`：本族返回**字符串 / Uint8Array**（非 Shape）。`defineOp` 的\n * brep 包装（`define-op.ts#wrapBrepOne`）把返回值一律收养为 Shape，装不下文本/字节。\n * 数据型平台 op 走普通函数，是 `api/export-brep.ts` 与 `api/shape-type` 的既定口径。\n *\n * 引擎身份**不能**靠 dispatchPath 门控（普通函数不走那条路）⇒ 按\n * `api/internal/l3-bridge.ts#assertEngineFor` 的既定做法：函数体第一行断言当前引擎，\n * 触碰内核之前报出与 D11-4 同构的 `E_BREP_UNSUPPORTED`，不补桩、不回退。\n * （与 dispatchPath 的差异：`assertEngineFor` **不含** D11-3 的 `brep_mock` 豁免——\n *  mock 句柄不是 occt 句柄，放行只会拿到错形状，故这里如实拦截。）\n *\n * 注册：api/api-namespace.ts 手动 import + 进 createApiNamespace 对象；覆盖率扫描器\n * scan-occt-op-coverage.ts 的 PLAN_C2_EXTRA 补 4 个方法名（普通函数不在 defineOp\n * 全集口径内，collectOps 看不见）。\n *\n * §9.5 降级路径（记录在案）：一旦 brepkit 的 wasm 面把 HLR/光栅渲染接进 L1 契约且两侧\n * 适配器同时落地，这些函数删掉 assertEngineFor 并改走 `getBrepApi()`，对应方法即从 C2\n * 转入 C1。\n */\n\nimport type { Shape } from '../../mesh/types'\nimport type { ShapeHandle, ViewName, SvgViewOptions, PngViewOptions, MultiviewSvgOptions, MultiviewPngOptions } from 'occt-wasm'\nimport { brepOf } from '../../shape'\nimport { getOcctKernel } from '../../occt-kernel/occtKernel'\nimport { assertEngineFor } from '../internal/l3-bridge'\n\n/** 借出形状的内核句柄；无 BREP 槽（mesh-only）报错。 */\nfunction occtHandleOf(shape: Shape, op: string): ShapeHandle {\n  const h = brepOf(shape) as unknown as ShapeHandle | undefined\n  if (!h) {\n    throw new Error(`E_SHAPE_TYPE_NO_BREP: ${op} requires a BREP handle (mesh-only shape has none)`)\n  }\n  return h\n}\n\n/**\n * 将形状渲染为 SVG 字符串（HLR 隐藏线消除，单命名视图）。\n * @group 视图\n * @inputs 1\n * @async false\n * @qual ok\n * @name toSVG\n * @note 平台 op：仅 occt 引擎（原生 toSVG）。非 occt 引擎执行前报 E_BREP_UNSUPPORTED。\n * @returns string SVG 文本（含命名视图与隐藏边虚线样式）。\n * @param shape - 被渲染的形状。type:Shape required:true\n * @param view - 命名视图（front/top/right/iso 等）。type:string required:false\n * @param options - SVG 渲染选项。type:object required:false\n * @example\n * const svg = cad.toSVG(box, 'iso')\n */\nexport function toSVG(shape: Shape, view?: ViewName, options?: SvgViewOptions): string {\n  assertEngineFor('toSVG', ['occt'])\n  return getOcctKernel().toSVG(occtHandleOf(shape, 'toSVG'), view, options)\n}\n\n/**\n * 将形状渲染为多视图 SVG 图纸（Front/Top/Right/Iso 默认排布，含 gnomons 与尺寸标注）。\n * @group 视图\n * @inputs 1\n * @async false\n * @qual ok\n * @name toMultiviewSVG\n * @note 平台 op：仅 occt 引擎（原生 toMultiviewSVG）。非 occt 引擎执行前报\n *       E_BREP_UNSUPPORTED。\n * @returns string 多视图 SVG 文本。\n * @param shape - 被渲染的形状。type:Shape required:true\n * @param options - 多视图渲染选项。type:object required:false\n * @example\n * const sheet = cad.toMultiviewSVG(box)\n */\nexport function toMultiviewSVG(shape: Shape, options?: MultiviewSvgOptions): string {\n  assertEngineFor('toMultiviewSVG', ['occt'])\n  return getOcctKernel().toMultiviewSVG(occtHandleOf(shape, 'toMultiviewSVG'), options)\n}\n\n/**\n * 将形状栅格化为 PNG 字节（与 toSVG 同绘制，经 CompressionStream 压缩）。\n * @group 视图\n * @inputs 1\n * @async true\n * @qual ok\n * @name toPNG\n * @note 平台 op：仅 occt 引擎（原生 toPNG，返回 Promise<Uint8Array>）。非 occt 引擎\n *       执行前报 E_BREP_UNSUPPORTED。\n * @returns Promise<Uint8Array> PNG 字节流。\n * @param shape - 被渲染的形状。type:Shape required:true\n * @param view - 命名视图（front/top/right/iso 等）。type:string required:false\n * @param options - PNG 渲染选项。type:object required:false\n * @example\n * const png = await cad.toPNG(box, 'iso')\n */\nexport async function toPNG(shape: Shape, view?: ViewName, options?: PngViewOptions): Promise<Uint8Array> {\n  assertEngineFor('toPNG', ['occt'])\n  return getOcctKernel().toPNG(occtHandleOf(shape, 'toPNG'), view, options)\n}\n\n/**\n * 将形状栅格化为多视图 PNG 字节（与 toMultiviewSVG 同绘制）。\n * @group 视图\n * @inputs 1\n * @async true\n * @qual ok\n * @name toMultiviewPNG\n * @note 平台 op：仅 occt 引擎（原生 toMultiviewPNG，返回 Promise<Uint8Array>）。非\n *       occt 引擎执行前报 E_BREP_UNSUPPORTED。\n * @returns Promise<Uint8Array> 多视图 PNG 字节流。\n * @param shape - 被渲染的形状。type:Shape required:true\n * @param options - 多视图渲染选项。type:object required:false\n * @example\n * const sheet = await cad.toMultiviewPNG(box)\n */\nexport async function toMultiviewPNG(shape: Shape, options?: MultiviewPngOptions): Promise<Uint8Array> {\n  assertEngineFor('toMultiviewPNG', ['occt'])\n  return getOcctKernel().toMultiviewPNG(occtHandleOf(shape, 'toMultiviewPNG'), options)\n}\n"]}