@faicad/faijs 0.13.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/view/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,aAAa,EAA0F,MAAM,eAAe,CAAA;AACjJ,OAAO,EAAE,WAAW,EAAE,cAAc,EAA+C,MAAM,mBAAmB,CAAA;AAC5G,OAAO,EAAE,YAAY,EAA4C,MAAM,cAAc,CAAA","sourcesContent":["/**\n * view — faijs 视图投影能力（路径 A：工程线稿 SVG；路径 B 见 3d_editor 宿主）\n *\n * 设计文档：docs/plans/2026-09-10-faijs-view-projection-and-screenshot.md §3.2\n *\n * 三个 op 全部返回**纯数据**（字符串 / 相机对象），不产出 Shape：\n *   - viewCamera(view)  → 视图规格解析为相机纯数据；\n *   - projectView(shape, view, opts?) → 单视图投影 SVG 字符串；\n *   - projectSheet(shape, views, opts?) → 多视图（三视图 + 等轴测）组合 SVG。\n *\n * 均为只读查询：不消费、不修改 shape（配合 §3.7 规则 1：无赋值裸调用默认不消费）。\n */\n\nexport { viewCamera, resolveCamera, type ViewSpec, type StandardView, type IsoView, type AxisPlaneView, type DirectionView } from './view-camera'\nexport { projectView, projectViewSvg, type ProjectViewOptions, type ProjectionSvg } from './view-projection'\nexport { projectSheet, type SheetView, type ProjectSheetOptions } from './view-sheet'\n"]}

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

@@ -0,0 +1,53 @@
+/**
+ * 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)…，
+ *      与 FreeCAD TechDraw 的方向向量惯例一致，见方案 §2.2）；
+ *   - 等轴测：'iso' | 'isometric'（方向 (1,-1,1)，方案 §2.3 定稿）；
+ *   - 轴对平面：'XY' | 'XZ' | 'YZ' | 'YX' | 'ZX' | 'ZY'（vendored 平面名）；
+ *   - 任意方向：{ dir: Vec3, xAxis?: Vec3 }（xAxis 缺省由方向自动推导）。
+ *
+ * viewCamera 是纯数据函数（无 Shape 输入，kind 'pure' 语义）：把视图规格解析成
+ * 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';
+/** 六个标准正交视图名（vendored CubeFace 同集）。 */
+export type StandardView = 'front' | 'back' | 'top' | 'bottom' | 'left' | 'right';
+/** 等轴测视图名（faijs 新增别名；方向 (1,-1,1)）。 */
+export type IsoView = 'iso' | 'isometric';
+/** 轴对平面名（vendored ProjectionPlane 的子集）。 */
+export type AxisPlaneView = 'XY' | 'XZ' | 'YZ' | 'YX' | 'ZX' | 'ZY';
+/** 任意方向视图规格。 */
+export interface DirectionView {
+    /** 视向（相机沿此方向观察；零向量报错）。 */
+    dir: Vec3;
+    /** 可选水平轴（缺省由方向自动推导）。 */
+    xAxis?: Vec3;
+}
+/**
+ * faijs 视图投影的视图规格：标准正交 / 等轴测 / 轴对平面 / 任意方向。
+ */
+export type ViewSpec = StandardView | IsoView | AxisPlaneView | DirectionView;
+/**
+ * 解析视图规格为投影相机（纯数据，无 Shape 输入；不消费任何几何）。
+ * @group 查询
+ * @inputs 0
+ * @async false
+ * @qual ok
+ * @name viewCamera
+ * @returns { direction, xAxis? } 归一化方向向量（iso = (1,-1,1)/√3，与 FreeCAD/OCCT 惯例一致）。未知视图名抛错；零方向向量抛错。用于 3d_editor 侧三轴相机渲染（mesh/SDF 形状的截图通道）。
+ * @param view - 视图规格：标准视图名（front/back/top/bottom/left/right/iso（=isometric）/XY/XZ/YZ/YX/ZX/ZY）或方向对象。type:string|{dir,xAxis?} required:true
+ * @example
+ * const cam = cad.viewCamera('iso')
+ * const cam = cad.viewCamera({ dir: [1, -1, 1] })
+  */
+export declare function viewCamera(view: ViewSpec): Camera;
+/** resolveCamera = viewCamera 别名（projectView/projectSheet 内部使用；与方案措辞一致）。 */
+export declare const resolveCamera: typeof viewCamera;
+//# sourceMappingURL=view-camera.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,51 @@
+/**
+ * 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)…，
+ *      与 FreeCAD TechDraw 的方向向量惯例一致，见方案 §2.2）；
+ *   - 等轴测：'iso' | 'isometric'（方向 (1,-1,1)，方案 §2.3 定稿）；
+ *   - 轴对平面：'XY' | 'XZ' | 'YZ' | 'YX' | 'ZX' | 'ZY'（vendored 平面名）；
+ *   - 任意方向：{ dir: Vec3, xAxis?: Vec3 }（xAxis 缺省由方向自动推导）。
+ *
+ * viewCamera 是纯数据函数（无 Shape 输入，kind 'pure' 语义）：把视图规格解析成
+ * 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';
+/** 等轴测视向（方案 §2.3：Iso=(1,-1,1)，与 FreeCAD 惯例一致）。 */
+const ISO_DIR = [1, -1, 1];
+/**
+ * 解析视图规格为投影相机（纯数据，无 Shape 输入；不消费任何几何）。
+ * @group 查询
+ * @inputs 0
+ * @async false
+ * @qual ok
+ * @name viewCamera
+ * @returns { direction, xAxis? } 归一化方向向量（iso = (1,-1,1)/√3，与 FreeCAD/OCCT 惯例一致）。未知视图名抛错；零方向向量抛错。用于 3d_editor 侧三轴相机渲染（mesh/SDF 形状的截图通道）。
+ * @param view - 视图规格：标准视图名（front/back/top/bottom/left/right/iso（=isometric）/XY/XZ/YZ/YX/ZX/ZY）或方向对象。type:string|{dir,xAxis?} required:true
+ * @example
+ * const cam = cad.viewCamera('iso')
+ * const cam = cad.viewCamera({ dir: [1, -1, 1] })
+  */
+export function viewCamera(view) {
+    if (typeof view === 'string') {
+        if (view === 'iso' || view === 'isometric') {
+            return unwrap(createCamera([0, 0, 0], ISO_DIR));
+        }
+        if (isProjectionPlane(view)) {
+            return unwrap(cameraFromPlane(view));
+        }
+        throw new Error(`[faijs/view] unknown view '${view}' (expected front/back/top/bottom/left/right/iso/isometric or an axis pair)`);
+    }
+    const { dir, xAxis } = view;
+    return unwrap(createCamera([0, 0, 0], dir, xAxis));
+}
+/** resolveCamera = viewCamera 别名（projectView/projectSheet 内部使用；与方案措辞一致）。 */
+export const resolveCamera = viewCamera;
+//# sourceMappingURL=view-camera.js.map

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,80 @@
+/**
+ * view-projection — 单视图投影 → SVG 线稿（faijs 视图投影能力，路径 A）
+ *
+ * 设计文档：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；
+ *   - 序列化为一个完整 SVG：可见轮廓实线 + 隐藏线虚线（stroke-dasharray）。
+ *
+ * 返回字符串绕开 arg-spec 对 projectEdges/makeProjectedEdges 的 skip 障碍
+ * （Edge 句柄数组 + compound 生命周期无法静态收养——本 op 只在内部消费，
+ *   产物是 2D 纯文本，无收养问题）。
+ *
+ * projectViewSvg 返回结构化数据（viewBox/paths/尺寸），供 projectSheet 网格组合。
+ */
+import type { Shape } from '../../mesh/types.js';
+import { type ViewSpec } from './view-camera.js';
+/** projectView 的序列化选项。 */
+export interface ProjectViewOptions {
+    /** viewBox 四周留白（单位 = 投影平面坐标单位；缺省 1）。 */
+    margin?: number;
+    /** 可见/隐藏线 stroke-width（像素；缺省 1）。 */
+    strokeWidth?: number;
+    /** 隐藏线虚线样式（SVG stroke-dasharray；缺省 '4,4'）。 */
+    dash?: string;
+    /** 隐藏线透明度（缺省 0.6）。 */
+    hiddenOpacity?: number;
+    /** 输出 SVG 宽度（缺省 = viewBox 宽度）。 */
+    width?: number;
+    /** 输出 SVG 高度（缺省 = viewBox 高度）。 */
+    height?: number;
+}
+/** 单视图投影的结构化结果（projectSheet 复用）。 */
+export interface ProjectionSvg {
+    /** 完整 SVG 字符串。 */
+    svg: string;
+    /** viewBox 属性值（'minX minY w h'；可见 ∪ 隐藏线并集 + margin）。 */
+    viewBox: string;
+    /** 各路径 d 串：可见实线 / 隐藏虚线。 */
+    paths: {
+        visible: string[];
+        hidden: string[];
+    };
+    /** 输出宽度/高度。 */
+    width: number;
+    height: number;
+}
+/**
+ * 单视图投影（结构化结果）。
+ *
+ * @param shape - 待投影的 faijs Shape（必须带 BREP 槽；mesh-only 输入抛 E_BREP_ONLY_INPUT）。
+ * @param view - 视图规格（标准视图 / iso / 轴对平面 / 方向对象）。
+ * @param opts - 序列化选项。
+ * @returns 结构化投影结果（svg/viewBox/paths/尺寸）。
+ */
+export declare function projectViewSvg(shape: Shape, view: ViewSpec, opts?: ProjectViewOptions): ProjectionSvg;
+/**
+ * 单视图投影 → SVG 线稿字符串（纯数据，不消费/修改 shape；规则 1 下裸调用不消费输入）。
+ * @group 查询
+ * @inputs 1
+ * @async false
+ * @qual ok
+ * @name projectView
+ * @returns SVG 字符串（<svg viewBox="…"> + 可见实线 <path> + 隐藏虚线 <path>）。裸调用 cad.projectView(part0, 'front') 不消费 part0（规则 1），part 仍留在 canvas。
+ * @param shape - 目标几何（必须有 BREP 槽；mesh-only 抛 E_BREP_ONLY_INPUT）。type:Shape required:true
+ * @param view - 视图规格（同 viewCamera：标准视图名 / iso / 轴对平面 / 方向对象）。type:string|{dir,xAxis?} required:true
+ * @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.width - 输出宽度（缺省 = viewBox 宽度）。type:number
+ * @param opts.height - 输出高度（缺省 = viewBox 高度）。type:number
+ * @example
+ * const svg = cad.projectView(part0, 'front')
+ * const svg = cad.projectView(part0, 'iso', { strokeWidth: 1, dash: '4,4', hiddenOpacity: 0.6 })
+  */
+export declare function projectView(shape: Shape, view: ViewSpec, opts?: ProjectViewOptions): string;
+//# sourceMappingURL=view-projection.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,128 @@
+/**
+ * view-projection — 单视图投影 → SVG 线稿（faijs 视图投影能力，路径 A）
+ *
+ * 设计文档：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；
+ *   - 序列化为一个完整 SVG：可见轮廓实线 + 隐藏线虚线（stroke-dasharray）。
+ *
+ * 返回字符串绕开 arg-spec 对 projectEdges/makeProjectedEdges 的 skip 障碍
+ * （Edge 句柄数组 + compound 生命周期无法静态收养——本 op 只在内部消费，
+ *   产物是 2D 纯文本，无收养问题）。
+ *
+ * projectViewSvg 返回结构化数据（viewBox/paths/尺寸），供 projectSheet 网格组合。
+ */
+import { borrowBrepjsShape } from '../internal/l3-bridge.js';
+import { drawProjection } from '../../vendored/brepjs/sketching/draw3d.js';
+import { resolveCamera } from './view-camera.js';
+/** 解析 'minX minY w h' 为数值数组。 */
+function parseViewBox(vb) {
+    const parts = vb.trim().split(/\s+/).map(Number);
+    if (parts.length !== 4 || parts.some((n) => !Number.isFinite(n)))
+        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) {
+    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);
+    }
+    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;
+}
+/**
+ * 单视图投影（结构化结果）。
+ *
+ * @param shape - 待投影的 faijs Shape（必须带 BREP 槽；mesh-only 输入抛 E_BREP_ONLY_INPUT）。
+ * @param view - 视图规格（标准视图 / iso / 轴对平面 / 方向对象）。
+ * @param opts - 序列化选项。
+ * @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]?.();
+    }
+}
+/**
+ * 单视图投影 → SVG 线稿字符串（纯数据，不消费/修改 shape；规则 1 下裸调用不消费输入）。
+ * @group 查询
+ * @inputs 1
+ * @async false
+ * @qual ok
+ * @name projectView
+ * @returns SVG 字符串（<svg viewBox="…"> + 可见实线 <path> + 隐藏虚线 <path>）。裸调用 cad.projectView(part0, 'front') 不消费 part0（规则 1），part 仍留在 canvas。
+ * @param shape - 目标几何（必须有 BREP 槽；mesh-only 抛 E_BREP_ONLY_INPUT）。type:Shape required:true
+ * @param view - 视图规格（同 viewCamera：标准视图名 / iso / 轴对平面 / 方向对象）。type:string|{dir,xAxis?} required:true
+ * @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.width - 输出宽度（缺省 = viewBox 宽度）。type:number
+ * @param opts.height - 输出高度（缺省 = viewBox 高度）。type:number
+ * @example
+ * const svg = cad.projectView(part0, 'front')
+ * const svg = cad.projectView(part0, 'iso', { strokeWidth: 1, dash: '4,4', hiddenOpacity: 0.6 })
+  */
+export function projectView(shape, view, opts) {
+    return projectViewSvg(shape, view, opts).svg;
+}
+//# sourceMappingURL=view-projection.js.map

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,56 @@
+/**
+ * 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'）；
+ *   - 布局参数（列数/间距/留白）可调，缺省按 sqrt 自动分列。
+ *
+ * 典型用法：三视图 + 等轴测工程图纸。
+ *   const sheet = projectSheet(part, ['front', 'top', 'right', 'iso'])
+ */
+import type { Shape } from '../../mesh/types.js';
+import { type ProjectViewOptions } from './view-projection.js';
+import type { ViewSpec } from './view-camera.js';
+/** 单个图纸视图：视图规格 + 可选标签。 */
+export interface SheetView {
+    view: ViewSpec;
+    /** 视图标签（缺省取视图名/方向描述）。 */
+    label?: string;
+}
+/** projectSheet 布局选项。 */
+export interface ProjectSheetOptions extends ProjectViewOptions {
+    /** 网格列数（缺省 ceil(sqrt(n))）。 */
+    cols?: number;
+    /** 相邻单元格间距（缺省 24）。 */
+    gap?: number;
+    /** 图纸外留白（缺省 24）。 */
+    padding?: number;
+    /** 是否渲染视图标签（缺省 true）。 */
+    labels?: boolean;
+    /** 标签字号（缺省 12）。 */
+    labelFontSize?: number;
+}
+/**
+ * 多视图投影图纸 → 组合 SVG 字符串（纯数据，不消费/修改 shape）。
+ * @group 查询
+ * @inputs 1
+ * @async false
+ * @qual ok
+ * @name projectSheet
+ * @returns SVG 字符串（嵌套 <svg x y width height viewBox preserveAspectRatio> + <text> 标签）。空列表返回空 SVG 不抛错。
+ * @param shape - 目标几何（必须有 BREP 槽；mesh-only 抛 E_BREP_ONLY_INPUT）。type:Shape required:true
+ * @param views - 视图列表：视图规格字符串，或 { view, label? } 对象（方向对象自动生成 x,y,z 标签）。type:(string|{view,label?})[] required:true
+ * @param opts.cols - 网格列数。type:number 默认 2
+ * @param opts.gap - 格间距（px）。type:number 默认 30
+ * @param opts.labels - 是否渲染 <text> 标签。type:boolean 默认 true
+ * @param opts.cellWidth - 每格画布宽度。type:number 默认 400
+ * @param opts.cellHeight - 每格画布高度。type:number 默认 300
+ * @example
+ * const sheet = cad.projectSheet(part0, ['front', 'top', 'right', 'iso'])
+ * const sheet = cad.projectSheet(part0, [{ view: 'front', label: '主视图' }], { cols: 2, gap: 40, labels: true })
+  */
+export declare function projectSheet(shape: Shape, views: (ViewSpec | SheetView)[], opts?: ProjectSheetOptions): string;
+//# sourceMappingURL=view-sheet.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,91 @@
+/**
+ * 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'）；
+ *   - 布局参数（列数/间距/留白）可调，缺省按 sqrt 自动分列。
+ *
+ * 典型用法：三视图 + 等轴测工程图纸。
+ *   const sheet = projectSheet(part, ['front', 'top', 'right', 'iso'])
+ */
+import { projectViewSvg } from './view-projection.js';
+function labelOf(item) {
+    if (item.label !== undefined)
+        return item.label;
+    if (typeof item.view === 'string')
+        return item.view;
+    const [x, y, z] = item.view.dir;
+    return `${x},${y},${z}`;
+}
+function escapeXml(s) {
+    return s.replace(/[<>&'"]/g, (c) => ({ '<': '&lt;', '>': '&gt;', '&': '&amp;', "'": '&apos;', '"': '&quot;' })[c]);
+}
+/**
+ * 多视图投影图纸 → 组合 SVG 字符串（纯数据，不消费/修改 shape）。
+ * @group 查询
+ * @inputs 1
+ * @async false
+ * @qual ok
+ * @name projectSheet
+ * @returns SVG 字符串（嵌套 <svg x y width height viewBox preserveAspectRatio> + <text> 标签）。空列表返回空 SVG 不抛错。
+ * @param shape - 目标几何（必须有 BREP 槽；mesh-only 抛 E_BREP_ONLY_INPUT）。type:Shape required:true
+ * @param views - 视图列表：视图规格字符串，或 { view, label? } 对象（方向对象自动生成 x,y,z 标签）。type:(string|{view,label?})[] required:true
+ * @param opts.cols - 网格列数。type:number 默认 2
+ * @param opts.gap - 格间距（px）。type:number 默认 30
+ * @param opts.labels - 是否渲染 <text> 标签。type:boolean 默认 true
+ * @param opts.cellWidth - 每格画布宽度。type:number 默认 400
+ * @param opts.cellHeight - 每格画布高度。type:number 默认 300
+ * @example
+ * const sheet = cad.projectSheet(part0, ['front', 'top', 'right', 'iso'])
+ * const sheet = cad.projectSheet(part0, [{ view: 'front', label: '主视图' }], { cols: 2, gap: 40, labels: true })
+  */
+export function projectSheet(shape, views, opts = {}) {
+    const items = views.map((v) => typeof v === 'string' ? { view: v, label: v } : 'view' in v ? v : { view: v });
+    if (items.length === 0) {
+        return '<svg version="1.1" xmlns="http://www.w3.org/2000/svg" width="0" height="0" />';
+    }
+    const n = items.length;
+    const cols = opts.cols ?? Math.ceil(Math.sqrt(n));
+    const gap = opts.gap ?? 24;
+    const padding = opts.padding ?? 24;
+    const labels = opts.labels !== false;
+    const labelFontSize = opts.labelFontSize ?? 12;
+    const projections = items.map((it) => ({ ...projectViewSvg(shape, it.view, opts), label: labelOf(it) }));
+    const labelPadY = labels ? labelFontSize + 10 : 0;
+    const cellW = Math.max(...projections.map((p) => p.width));
+    const cellH = Math.max(...projections.map((p) => p.height)) + labelPadY;
+    const rows = Math.ceil(n / cols);
+    const totalW = cols * cellW + (cols - 1) * gap + 2 * padding;
+    const totalH = rows * cellH + (rows - 1) * gap + 2 * padding;
+    const cells = [];
+    projections.forEach((p, i) => {
+        const col = i % cols;
+        const row = Math.floor(i / cols);
+        const x = padding + col * (cellW + gap);
+        const y = padding + row * (cellH + gap);
+        const inner = [
+            `<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">`,
+            `  <g stroke="#000" fill="none">`,
+        ];
+        for (const d of p.paths.visible) {
+            inner.push(`    <path d="${d}" fill="none" stroke="#000" stroke-width="${opts.strokeWidth ?? 1}" />`);
+        }
+        for (const d of p.paths.hidden) {
+            inner.push(`    <path d="${d}" fill="none" stroke="#000" stroke-width="${opts.strokeWidth ?? 1}" stroke-dasharray="${opts.dash ?? '4,4'}" opacity="${opts.hiddenOpacity ?? 0.6}" />`);
+        }
+        inner.push('  </g>', `</svg>`);
+        if (labels) {
+            inner.push(`<text x="${x + cellW / 2}" y="${y + p.height + labelFontSize}" text-anchor="middle" font-size="${labelFontSize}" fill="#000">${escapeXml(p.label)}</text>`);
+        }
+        cells.push(inner.join('\n'));
+    });
+    return [
+        `<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">`,
+        cells.map((c) => `  ${c}`).join('\n'),
+        `</svg>`,
+    ].join('\n');
+}
+//# sourceMappingURL=view-sheet.js.map

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

@@ -0,0 +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"]}

package/dist/boolean/cross-section.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 截面求解器（无 CSG / 无 Manifold.simplify）
+ *
+ * 给定源网格（THREE.BufferGeometry）和一个局部空间平面，直接求「平面与网格的
+ * 交线」，缝合成闭合环（外环 + 孔环），并三角化出截面 cap。这是「拉伸预览无
+ * split 方案」的唯一 CPU 几何成本。
+ *
+ * 为什么不用 Manifold.split：
+ *   - split 是整模型布尔运算（焊接 + 全分辨率 CSG），168 万三角面 4~8s/次；
+ *   - 本方案只做三角形–平面求交（纯算术），O(n)，且后续可叠加 BVH 降到 O(log n + k)。
+ *
+ * 设计契约（与 ExtrudeRenderer 现有代码对齐）：
+ *   - 输入平面为「局部空间」THREE.Plane（调用方负责把世界平面经 matrixWorld 逆变换得到）。
+ *   - computeSection 直接读 geometry.attributes，不拷贝整份顶点缓冲。
+ *   - 输出的 cap 顶点为局部空间，预览期经 matrixWorld 渲染到世界空间。
+ */
+import * as THREE from 'three';
+/**
+ * A single closed loop (3D, local space, lying on the section plane).
+ * `isHole=false` marks the outer boundary, `true` marks a hole.
+ */
+export interface SectionRing {
+    points: THREE.Vector3[];
+    isHole: boolean;
+}
+/**
+ * Result of computing a section: the stitched loops and diagnostic counters.
+ */
+export interface SectionResult {
+    /** All stitched loops (already classified by area into isHole). */
+    rings: SectionRing[];
+    /** 外环列表（3D 点）。 */
+    outers: THREE.Vector3[][];
+    /** 每个外环对应的孔环列表（与 outers 同序）。 */
+    holesOf: THREE.Vector3[][][];
+    /** 实际参与求交、跨越/贴合平面的三角形数（诊断用）。 */
+    hitTriangleCount: number;
+    /** 收集到的交线段数。 */
+    segmentCount: number;
+}
+/**
+ * Compute the section of a mesh cut by a plane.
+ * @param geometry Source mesh (local space), supports indexed and non-indexed.
+ * @param plane    Local-space cutting plane (THREE.Plane semantics: normal·p + constant = 0).
+ * @returns The stitched section rings, outers, holes, and diagnostic counters.
+ */
+export declare function computeSection(geometry: THREE.BufferGeometry, plane: THREE.Plane): SectionResult;
+/**
+ * Build a prism geometry by extruding the section rings along the normal for
+ * `length`, starting at `start` (in local space). The output contains the cap
+ * triangulation (top/bottom faces) plus the side walls of every boundary loop.
+ * It can be fed directly to a THREE.BufferGeometry or converted to ManifoldMeshData.
+ *
+ * @param section    computeSection result
+ * @param normal     Extrusion direction (local space, unit vector)
+ * @param length     Extrusion length
+ * @param start      Start offset along the normal (centered mode passes offsetBack so the prism spans [offsetBack, offsetFront])
+ * @returns Filled position and index buffers describing the extruded prism.
+ */
+export declare function buildExtrudedProfile(section: SectionResult, normal: THREE.Vector3, length: number, start?: number): {
+    positions: Float32Array;
+    indices: Uint32Array;
+};
+//# sourceMappingURL=cross-section.d.ts.map

package/dist/boolean/cross-section.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-section.d.ts","sourceRoot":"","sources":["../../src/boolean/cross-section.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE,CAAA;IACvB,MAAM,EAAE,OAAO,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,KAAK,EAAE,WAAW,EAAE,CAAA;IACpB,kBAAkB;IAClB,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,CAAA;IACzB,gCAAgC;IAChC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,CAAA;IAC5B,gCAAgC;IAChC,gBAAgB,EAAE,MAAM,CAAA;IACxB,gBAAgB;IAChB,YAAY,EAAE,MAAM,CAAA;CACrB;AAkCD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,cAAc,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,aAAa,CAiMhG;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,KAAK,CAAC,OAAO,EACrB,MAAM,EAAE,MAAM,EACd,KAAK,SAAI,GACR;IAAE,SAAS,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAoDnD"}