@faicad/faijs 0.13.0

package/dist/lang/symbol-table.generated.js

@@ -0,0 +1,79 @@
+/**
+ * symbol-table 生成文件 — 禁手改。
+ * 由 scripts/gen-symbol-table.ts 从 api-namespace 的 cad 命名空间生成（键存在性）。
+ * keep-syntax P1 后符号表只承载 check() 符号检查（"函数不存在"判定）；
+ * 保留语义由 keep 声明表达，不再有 readonly 标注。
+ */
+export default {
+    "box": {},
+    "sphere": {},
+    "cylinder": {},
+    "cone": {},
+    "wedge": {},
+    "text": {},
+    "screw": {},
+    "svgExtrude": {},
+    "sketch": {},
+    "sdf": {},
+    "load": {},
+    "translate": {},
+    "rotate_euler": {},
+    "scale": {},
+    "scale3d": {},
+    "fai_drill": {},
+    "fai_extrude": {},
+    "engrave": {},
+    "chamfer": {},
+    "fillet": {},
+    "knurl": {},
+    "union": {},
+    "subtract": {},
+    "intersect": {},
+    "extrude": {},
+    "revolve": {},
+    "fai_split": {},
+    "group": {},
+    "assembly": {},
+    "copy": {},
+    "faceNormal": {},
+    "bboxCenter": {},
+    "bboxMin": {},
+    "bboxMax": {},
+    "edgeRef": {},
+    "faceRef": {},
+    "jointTrajectory": {},
+    "inverseKinematics": {},
+    "mechanismDOF": {},
+    "asset": {},
+    "torus": {},
+    "fuse": {},
+    "viewCamera": {},
+    "projectView": {},
+    "projectSheet": {},
+    "linearPattern": {},
+    "circularPattern": {},
+    "gridPattern": {},
+    "drill": {},
+    "pocket": {},
+    "boss": {},
+    "mirrorJoin": {},
+    "rectangularPattern": {},
+    "convexHull": {},
+    "makeBaseBox": {},
+    "ellipsoid": {},
+    "rotate": {},
+    "mirror": {},
+    "clone": {},
+    "applyMatrix": {},
+    "transformCopy": {},
+    "locate": {},
+    "cut": {},
+    "split": {},
+    "offset": {},
+    "heal": {},
+    "simplify": {},
+    "autoHeal": {},
+    "fixShape": {},
+    "healSolid": {}
+};
+//# sourceMappingURL=symbol-table.generated.js.map

package/dist/lang/symbol-table.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol-table.generated.js","sourceRoot":"","sources":["../../src/lang/symbol-table.generated.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAe;IACb,KAAK,EAAE,EAAE;IACT,QAAQ,EAAE,EAAE;IACZ,UAAU,EAAE,EAAE;IACd,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,EAAE;IACX,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,EAAE;IACX,YAAY,EAAE,EAAE;IAChB,QAAQ,EAAE,EAAE;IACZ,KAAK,EAAE,EAAE;IACT,MAAM,EAAE,EAAE;IACV,WAAW,EAAE,EAAE;IACf,cAAc,EAAE,EAAE;IAClB,OAAO,EAAE,EAAE;IACX,SAAS,EAAE,EAAE;IACb,WAAW,EAAE,EAAE;IACf,aAAa,EAAE,EAAE;IACjB,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,EAAE;IACb,QAAQ,EAAE,EAAE;IACZ,OAAO,EAAE,EAAE;IACX,OAAO,EAAE,EAAE;IACX,UAAU,EAAE,EAAE;IACd,WAAW,EAAE,EAAE;IACf,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,EAAE;IACb,WAAW,EAAE,EAAE;IACf,OAAO,EAAE,EAAE;IACX,UAAU,EAAE,EAAE;IACd,MAAM,EAAE,EAAE;IACV,YAAY,EAAE,EAAE;IAChB,YAAY,EAAE,EAAE;IAChB,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,EAAE;IACb,iBAAiB,EAAE,EAAE;IACrB,mBAAmB,EAAE,EAAE;IACvB,cAAc,EAAE,EAAE;IAClB,OAAO,EAAE,EAAE;IACX,OAAO,EAAE,EAAE;IACX,MAAM,EAAE,EAAE;IACV,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE,EAAE;IACjB,cAAc,EAAE,EAAE;IAClB,eAAe,EAAE,EAAE;IACnB,iBAAiB,EAAE,EAAE;IACrB,aAAa,EAAE,EAAE;IACjB,OAAO,EAAE,EAAE;IACX,QAAQ,EAAE,EAAE;IACZ,MAAM,EAAE,EAAE;IACV,YAAY,EAAE,EAAE;IAChB,oBAAoB,EAAE,EAAE;IACxB,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE,EAAE;IACjB,WAAW,EAAE,EAAE;IACf,QAAQ,EAAE,EAAE;IACZ,QAAQ,EAAE,EAAE;IACZ,OAAO,EAAE,EAAE;IACX,aAAa,EAAE,EAAE;IACjB,eAAe,EAAE,EAAE;IACnB,QAAQ,EAAE,EAAE;IACZ,KAAK,EAAE,EAAE;IACT,OAAO,EAAE,EAAE;IACX,QAAQ,EAAE,EAAE;IACZ,MAAM,EAAE,EAAE;IACV,UAAU,EAAE,EAAE;IACd,UAAU,EAAE,EAAE;IACd,UAAU,EAAE,EAAE;IACd,WAAW,EAAE,EAAE;CAChB,CAAA","sourcesContent":["/**\n * symbol-table 生成文件 — 禁手改。\n * 由 scripts/gen-symbol-table.ts 从 api-namespace 的 cad 命名空间生成（键存在性）。\n * keep-syntax P1 后符号表只承载 check() 符号检查（\"函数不存在\"判定）；\n * 保留语义由 keep 声明表达，不再有 readonly 标注。\n */\nexport default {\n  \"box\": {},\n  \"sphere\": {},\n  \"cylinder\": {},\n  \"cone\": {},\n  \"wedge\": {},\n  \"text\": {},\n  \"screw\": {},\n  \"svgExtrude\": {},\n  \"sketch\": {},\n  \"sdf\": {},\n  \"load\": {},\n  \"translate\": {},\n  \"rotate_euler\": {},\n  \"scale\": {},\n  \"scale3d\": {},\n  \"fai_drill\": {},\n  \"fai_extrude\": {},\n  \"engrave\": {},\n  \"chamfer\": {},\n  \"fillet\": {},\n  \"knurl\": {},\n  \"union\": {},\n  \"subtract\": {},\n  \"intersect\": {},\n  \"extrude\": {},\n  \"revolve\": {},\n  \"fai_split\": {},\n  \"group\": {},\n  \"assembly\": {},\n  \"copy\": {},\n  \"faceNormal\": {},\n  \"bboxCenter\": {},\n  \"bboxMin\": {},\n  \"bboxMax\": {},\n  \"edgeRef\": {},\n  \"faceRef\": {},\n  \"jointTrajectory\": {},\n  \"inverseKinematics\": {},\n  \"mechanismDOF\": {},\n  \"asset\": {},\n  \"torus\": {},\n  \"fuse\": {},\n  \"viewCamera\": {},\n  \"projectView\": {},\n  \"projectSheet\": {},\n  \"linearPattern\": {},\n  \"circularPattern\": {},\n  \"gridPattern\": {},\n  \"drill\": {},\n  \"pocket\": {},\n  \"boss\": {},\n  \"mirrorJoin\": {},\n  \"rectangularPattern\": {},\n  \"convexHull\": {},\n  \"makeBaseBox\": {},\n  \"ellipsoid\": {},\n  \"rotate\": {},\n  \"mirror\": {},\n  \"clone\": {},\n  \"applyMatrix\": {},\n  \"transformCopy\": {},\n  \"locate\": {},\n  \"cut\": {},\n  \"split\": {},\n  \"offset\": {},\n  \"heal\": {},\n  \"simplify\": {},\n  \"autoHeal\": {},\n  \"fixShape\": {},\n  \"healSolid\": {}\n}\n"]}

package/dist/lang/symbol-table.js

@@ -0,0 +1,27 @@
+/**
+ * symbol-table — 标准库符号表类型与消费入口（L0 零依赖）
+ *
+ *
+ * 符号表是"标准库符号表"（正常语言编译器认识 prelude 的同款机制），
+ * 机器生成、均匀查询。keep-syntax P1 之后它只承载一个职责：
+ * check() 符号检查判定 callee 是否存在（"函数不存在"诊断）。
+ * 保留语义（readonlyPositions/readonlyPaths）已删除——保留由 keep 声明
+ * （调用点 keep / 函数体 exec.keep）显式表达，不再靠类型标注提取（R7）。
+ * 未知第三方函数不在表中时，check() 报"函数不存在"，其它机制不受影响。
+ *
+ * 生成文件：src/lang/symbol-table.generated.ts（由 scripts/gen-symbol-table.ts 生成，禁手改）。
+ */
+import symbolTable from './symbol-table.generated.js';
+/** 生成的符号表（禁手改，由 scripts/gen-symbol-table.ts 生成） */
+export const SYMBOL_TABLE = symbolTable;
+/**
+ * Look up a callee in the standard-library symbol table. Unknown functions
+ * (absent from the table) return undefined, which check() reports as
+ * "function does not exist".
+ * @param callee - the callee name to look up.
+ * @returns the matching symbol-table entry, or undefined when unknown.
+ */
+export function getFunctionSymbol(callee) {
+    return SYMBOL_TABLE[callee];
+}
+//# sourceMappingURL=symbol-table.js.map

package/dist/lang/symbol-table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol-table.js","sourceRoot":"","sources":["../../src/lang/symbol-table.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,WAAW,MAAM,0BAA0B,CAAA;AAQlD,mDAAmD;AACnD,MAAM,CAAC,MAAM,YAAY,GAAgB,WAA0B,CAAA;AAEnE;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,OAAO,YAAY,CAAC,MAAM,CAAC,CAAA;AAC7B,CAAC","sourcesContent":["/**\n * symbol-table — 标准库符号表类型与消费入口（L0 零依赖）\n *\n *\n * 符号表是\"标准库符号表\"（正常语言编译器认识 prelude 的同款机制），\n * 机器生成、均匀查询。keep-syntax P1 之后它只承载一个职责：\n * check() 符号检查判定 callee 是否存在（\"函数不存在\"诊断）。\n * 保留语义（readonlyPositions/readonlyPaths）已删除——保留由 keep 声明\n * （调用点 keep / 函数体 exec.keep）显式表达，不再靠类型标注提取（R7）。\n * 未知第三方函数不在表中时，check() 报\"函数不存在\"，其它机制不受影响。\n *\n * 生成文件：src/lang/symbol-table.generated.ts（由 scripts/gen-symbol-table.ts 生成，禁手改）。\n */\n\nimport symbolTable from './symbol-table.generated'\n\n/** 符号表条目（keep-syntax P1 后为空对象占位，仅承载键存在性）。 */\nexport type FunctionSymbol = Record<string, never>\n\n/** 标准库符号表：callee → 条目。均匀数据，无 per-函数代码。 */\nexport type SymbolTable = Record<string, FunctionSymbol>\n\n/** 生成的符号表（禁手改，由 scripts/gen-symbol-table.ts 生成） */\nexport const SYMBOL_TABLE: SymbolTable = symbolTable as SymbolTable\n\n/**\n * Look up a callee in the standard-library symbol table. Unknown functions\n * (absent from the table) return undefined, which check() reports as\n * \"function does not exist\".\n * @param callee - the callee name to look up.\n * @returns the matching symbol-table entry, or undefined when unknown.\n */\nexport function getFunctionSymbol(callee: string): FunctionSymbol | undefined {\n  return SYMBOL_TABLE[callee]\n}\n"]}

package/dist/lang/types.d.ts

@@ -0,0 +1,57 @@
+/**
+ * faijs 文本层类型定义 — 保留类型（L0 零依赖）
+ *
+ * 设计文档：docs/syntax-design.md §3.1
+ *
+ * 代码文本是唯一事实源。IR 已删除（T5），本文件只保留宿主消费的
+ * 保留类型（ParamDef / TerminalShape / ScriptMetaIR / VarKind）和
+ * 基础值类型（Vec3 / JsonValue）。
+ *
+ * L0 边界：此文件仅依赖 TypeScript 内置类型 + identity（零依赖品牌模块）。
+ */
+import { type PartName } from '../identity.js';
+/** A 3-component vector. */
+export type Vec3 = [number, number, number];
+/** A JSON-serializable value, used for parameter literals and wire-shaped args. */
+export type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [k: string]: JsonValue;
+};
+/**
+ * A parameter declaration (`const name = <literal>`), with its value and
+ * optional schema metadata.
+ */
+export interface ParamDef {
+    name: string;
+    type: 'number' | 'vec3' | 'bool' | 'enum';
+    value: JsonValue;
+    default: JsonValue;
+    min?: number;
+    max?: number;
+    options?: string[];
+    label?: string;
+}
+/**
+ * Scene-level model metadata (name and appearance) carried by a script.
+ */
+export interface ScriptMetaIR {
+    name?: string;
+    appearance?: {
+        color?: string;
+        metalness?: number;
+        roughness?: number;
+    };
+}
+/** 终端变量类型（keep-syntax 设计 §6：运行时登记，缺省 'shape'）。 */
+export type VarKind = 'shape' | 'compound' | 'value';
+/** 终端 shape：return 数组/DAG 叶子判定列出的最终输出（设计文档 §2.2 / §4.1） */
+export interface TerminalShape {
+    /** 终端左值变量名（PartName，如 'part0'）——终端按变量名（outputs）标识，非语句 id */
+    id: PartName;
+    /** 该终端 mesh 的独立 meta（name/appearance） */
+    meta?: ScriptMetaIR;
+    /** 变量类型（'shape' | 'compound' | 'value'），运行时登记，缺省 'shape' */
+    kind?: VarKind;
+    /** 保留但 canvas 不渲染（keep-syntax 设计 §6），缺省 undefined → 可见 */
+    hidden?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lang/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lang/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAA;AAI3C,4BAA4B;AAC5B,MAAM,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAE3C,mFAAmF;AACnF,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,EAAE,GACX;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAA;AAI9B;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;IACzC,KAAK,EAAE,SAAS,CAAA;IAChB,OAAO,EAAE,SAAS,CAAA;IAClB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAID;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACxE;AAED,kDAAkD;AAClD,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAA;AAEpD,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,EAAE,EAAE,QAAQ,CAAA;IACZ,yCAAyC;IACzC,IAAI,CAAC,EAAE,YAAY,CAAA;IACnB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,0DAA0D;IAC1D,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB"}

package/dist/lang/types.js

@@ -0,0 +1,13 @@
+/**
+ * faijs 文本层类型定义 — 保留类型（L0 零依赖）
+ *
+ * 设计文档：docs/syntax-design.md §3.1
+ *
+ * 代码文本是唯一事实源。IR 已删除（T5），本文件只保留宿主消费的
+ * 保留类型（ParamDef / TerminalShape / ScriptMetaIR / VarKind）和
+ * 基础值类型（Vec3 / JsonValue）。
+ *
+ * L0 边界：此文件仅依赖 TypeScript 内置类型 + identity（零依赖品牌模块）。
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/lang/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/lang/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG","sourcesContent":["/**\n * faijs 文本层类型定义 — 保留类型（L0 零依赖）\n *\n * 设计文档：docs/syntax-design.md §3.1\n *\n * 代码文本是唯一事实源。IR 已删除（T5），本文件只保留宿主消费的\n * 保留类型（ParamDef / TerminalShape / ScriptMetaIR / VarKind）和\n * 基础值类型（Vec3 / JsonValue）。\n *\n * L0 边界：此文件仅依赖 TypeScript 内置类型 + identity（零依赖品牌模块）。\n */\n\nimport { type PartName } from '../identity'\n\n// ── 值与引用 ──\n\n/** A 3-component vector. */\nexport type Vec3 = [number, number, number]\n\n/** A JSON-serializable value, used for parameter literals and wire-shaped args. */\nexport type JsonValue =\n  | string\n  | number\n  | boolean\n  | null\n  | JsonValue[]\n  | { [k: string]: JsonValue }\n\n// ── 参数表 ──\n\n/**\n * A parameter declaration (`const name = <literal>`), with its value and\n * optional schema metadata.\n */\nexport interface ParamDef {\n  name: string\n  type: 'number' | 'vec3' | 'bool' | 'enum'\n  value: JsonValue\n  default: JsonValue\n  min?: number\n  max?: number\n  options?: string[]\n  label?: string\n}\n\n// ── Part 脚本 ──\n\n/**\n * Scene-level model metadata (name and appearance) carried by a script.\n */\nexport interface ScriptMetaIR {\n  name?: string\n  appearance?: { color?: string; metalness?: number; roughness?: number }\n}\n\n/** 终端变量类型（keep-syntax 设计 §6：运行时登记，缺省 'shape'）。 */\nexport type VarKind = 'shape' | 'compound' | 'value'\n\n/** 终端 shape：return 数组/DAG 叶子判定列出的最终输出（设计文档 §2.2 / §4.1） */\nexport interface TerminalShape {\n  /** 终端左值变量名（PartName，如 'part0'）——终端按变量名（outputs）标识，非语句 id */\n  id: PartName\n  /** 该终端 mesh 的独立 meta（name/appearance） */\n  meta?: ScriptMetaIR\n  /** 变量类型（'shape' | 'compound' | 'value'），运行时登记，缺省 'shape' */\n  kind?: VarKind\n  /** 保留但 canvas 不渲染（keep-syntax 设计 §6），缺省 undefined → 可见 */\n  hidden?: boolean\n}\n"]}

package/dist/mesh/boolean.d.ts

@@ -0,0 +1,34 @@
+/**
+ * mesh 布尔运算 API
+ *
+ * 提取来源：engine/boolean/csg.ts (computeBoolean)
+ * 已是纯数据函数，直接包装。
+ */
+import type { Shape } from './types.js';
+/**
+ * Boolean union of two or more shapes: the combined volume of every operand,
+ * keeping only the outer surface.
+ *
+ * @param a - the first input shape.
+ * @param b - the second input shape.
+ * @param rest - additional shapes to include in the union.
+ * @returns the merged solid shape.
+ */
+export declare function union(a: Shape, b: Shape, ...rest: Shape[]): Promise<Shape>;
+/**
+ * Boolean subtraction: cut shape `b` out of shape `a`.
+ *
+ * @param a - the base shape to cut from.
+ * @param b - the shape to remove.
+ * @returns the result of `a` minus `b`.
+ */
+export declare function subtract(a: Shape, b: Shape): Promise<Shape>;
+/**
+ * Boolean intersection: the volume common to both shapes.
+ *
+ * @param a - the first input shape.
+ * @param b - the second input shape.
+ * @returns the region shared by `a` and `b`.
+ */
+export declare function intersect(a: Shape, b: Shape): Promise<Shape>;
+//# sourceMappingURL=boolean.d.ts.map

package/dist/mesh/boolean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boolean.d.ts","sourceRoot":"","sources":["../../src/mesh/boolean.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAEpC;;;;;;;;GAQG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAGhF;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAEjE;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAElE"}

package/dist/mesh/boolean.js

@@ -0,0 +1,41 @@
+/**
+ * mesh 布尔运算 API
+ *
+ * 提取来源：engine/boolean/csg.ts (computeBoolean)
+ * 已是纯数据函数，直接包装。
+ */
+import { computeBoolean } from '../boolean/csg-backend.js';
+/**
+ * Boolean union of two or more shapes: the combined volume of every operand,
+ * keeping only the outer surface.
+ *
+ * @param a - the first input shape.
+ * @param b - the second input shape.
+ * @param rest - additional shapes to include in the union.
+ * @returns the merged solid shape.
+ */
+export async function union(a, b, ...rest) {
+    const meshes = [a, b, ...rest];
+    return computeBoolean(meshes, 'union');
+}
+/**
+ * Boolean subtraction: cut shape `b` out of shape `a`.
+ *
+ * @param a - the base shape to cut from.
+ * @param b - the shape to remove.
+ * @returns the result of `a` minus `b`.
+ */
+export async function subtract(a, b) {
+    return computeBoolean([a, b], 'subtract');
+}
+/**
+ * Boolean intersection: the volume common to both shapes.
+ *
+ * @param a - the first input shape.
+ * @param b - the second input shape.
+ * @returns the region shared by `a` and `b`.
+ */
+export async function intersect(a, b) {
+    return computeBoolean([a, b], 'intersect');
+}
+//# sourceMappingURL=boolean.js.map

package/dist/mesh/boolean.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boolean.js","sourceRoot":"","sources":["../../src/mesh/boolean.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAGvD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,CAAQ,EAAE,CAAQ,EAAE,GAAG,IAAa;IAC9D,MAAM,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAA;IAC9B,OAAO,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AACxC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,CAAQ,EAAE,CAAQ;IAC/C,OAAO,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,CAAA;AAC3C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,CAAQ,EAAE,CAAQ;IAChD,OAAO,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,WAAW,CAAC,CAAA;AAC5C,CAAC","sourcesContent":["/**\n * mesh 布尔运算 API\n *\n * 提取来源：engine/boolean/csg.ts (computeBoolean)\n * 已是纯数据函数，直接包装。\n */\n\nimport { computeBoolean } from '../boolean/csg-backend'\nimport type { Shape } from './types'\n\n/**\n * Boolean union of two or more shapes: the combined volume of every operand,\n * keeping only the outer surface.\n *\n * @param a - the first input shape.\n * @param b - the second input shape.\n * @param rest - additional shapes to include in the union.\n * @returns the merged solid shape.\n */\nexport async function union(a: Shape, b: Shape, ...rest: Shape[]): Promise<Shape> {\n  const meshes = [a, b, ...rest]\n  return computeBoolean(meshes, 'union')\n}\n\n/**\n * Boolean subtraction: cut shape `b` out of shape `a`.\n *\n * @param a - the base shape to cut from.\n * @param b - the shape to remove.\n * @returns the result of `a` minus `b`.\n */\nexport async function subtract(a: Shape, b: Shape): Promise<Shape> {\n  return computeBoolean([a, b], 'subtract')\n}\n\n/**\n * Boolean intersection: the volume common to both shapes.\n *\n * @param a - the first input shape.\n * @param b - the second input shape.\n * @returns the region shared by `a` and `b`.\n */\nexport async function intersect(a: Shape, b: Shape): Promise<Shape> {\n  return computeBoolean([a, b], 'intersect')\n}\n"]}

package/dist/mesh/drill-hole/DrillHoleCore.d.ts

@@ -0,0 +1,90 @@
+import * as THREE from 'three';
+import type { DrillDirection, DrillHoleParams } from './drill-types.js';
+/**
+ * Build a Z-up hole geometry centered on the origin, with the axial direction
+ * along Z.
+ *
+ * - simple: CylinderGeometry rotated to Z-up
+ * - screw: makeScrew() already returns Z-up
+ *
+ * Tolerance is applied as a radial expansion (tolerance/2 on radius).
+ *
+ * @param params - drill-hole parameters (type, diameter, screw details, tolerance).
+ * @param height - axial length of the hole in millimeters.
+ * @returns the hole geometry as a Z-up BufferGeometry.
+ */
+export declare function buildHoleGeometry(params: DrillHoleParams, height: number): THREE.BufferGeometry;
+/**
+ * Compute the through-hole height by raycasting against the target mesh's
+ * bounding box. Returns { height, center } so the cylinder exactly spans the
+ * model thickness along the drill direction, without extending outside.
+ *
+ * @param position - world-space position of the hole entry point.
+ * @param direction - the drill direction (normalized internally).
+ * @param bbox - world-space bounding box of the target mesh.
+ * @returns the height and world-space center of the through hole.
+ */
+export declare function computeThroughHoleDimensions(position: THREE.Vector3, direction: THREE.Vector3, bbox: THREE.Box3): {
+    height: number;
+    center: THREE.Vector3;
+};
+/**
+ * Compute the blind-hole center: the hole entry is at the click point,
+ * the hole extends inward by `depth`. The cylinder center is at
+ * position + direction * (depth / 2).
+ *
+ * @param position - world-space hole entry point.
+ * @param direction - the drill direction (normalized internally).
+ * @param depth - blind-hole depth in millimeters.
+ * @returns the world-space cylinder center.
+ */
+export declare function computeBlindHoleCenter(position: THREE.Vector3, direction: THREE.Vector3, depth: number): THREE.Vector3;
+/**
+ * Orient and position a Z-up hole geometry (axial along Z) to world space.
+ * Returns a new geometry with the transform baked in.
+ *
+ * @param geo - Z-up hole geometry centered on the origin.
+ * @param direction - world-space axis the hole should point along.
+ * @param center - world-space position of the hole center.
+ * @returns a transformed clone of the input geometry.
+ */
+export declare function positionHoleGeometry(geo: THREE.BufferGeometry, direction: THREE.Vector3, center: THREE.Vector3): THREE.BufferGeometry;
+/**
+ * Resolve the drill direction based on params.direction and the face normal.
+ *
+ * - 'normal': inward direction = negated face normal
+ * - 'x'/'y'/'z': axis-aligned, flipped to point INTO the material
+ *   (i.e. opposite to the face normal)
+ *
+ * @param direction - requested drill-direction reference.
+ * @param faceNormal - face normal at the drill position.
+ * @returns the resolved unit drill direction.
+ */
+export declare function resolveDrillDirection(direction: DrillDirection, faceNormal: THREE.Vector3): THREE.Vector3;
+/**
+ * Drill a hole into a THREE.Mesh in world space, returning the resulting
+ * geometry in the mesh's local space.
+ *
+ * @param targetMesh - the mesh to drill into.
+ * @param params - drill-hole parameters.
+ * @param position - world-space hole entry point.
+ * @param faceNormal - world-space normal of the face at the entry point.
+ * @returns the drilled geometry in mesh-local space.
+ */
+export declare function executeDrillHole(targetMesh: THREE.Mesh, params: DrillHoleParams, position: THREE.Vector3, faceNormal: THREE.Vector3): Promise<THREE.BufferGeometry>;
+/**
+ * Core drill computation that accepts geometry + world matrix directly.
+ *
+ * This avoids the need to temporarily swap mesh.geometry when the mesh
+ * currently has a preview geometry on it. Callers that have the G0 geometry
+ * in a separate BufferGeometry can use this directly.
+ *
+ * @param sourceGeometry - the base geometry to drill (mesh-local space).
+ * @param worldMatrix - world transform of the source geometry.
+ * @param params - drill-hole parameters.
+ * @param position - world-space hole entry point.
+ * @param faceNormal - world-space face normal at the entry point.
+ * @returns the drilled geometry, transformed back into mesh-local space.
+ */
+export declare function executeDrillHoleOnGeometry(sourceGeometry: THREE.BufferGeometry, worldMatrix: THREE.Matrix4, params: DrillHoleParams, position: THREE.Vector3, faceNormal: THREE.Vector3): Promise<THREE.BufferGeometry>;
+//# sourceMappingURL=DrillHoleCore.d.ts.map

package/dist/mesh/drill-hole/DrillHoleCore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DrillHoleCore.d.ts","sourceRoot":"","sources":["../../../src/mesh/drill-hole/DrillHoleCore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAU9B,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAKpE;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,MAAM,GACb,KAAK,CAAC,cAAc,CAkEtB;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,KAAK,CAAC,OAAO,EACvB,SAAS,EAAE,KAAK,CAAC,OAAO,EACxB,IAAI,EAAE,KAAK,CAAC,IAAI,GACf;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAA;CAAE,CAqD3C;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,KAAK,CAAC,OAAO,EACvB,SAAS,EAAE,KAAK,CAAC,OAAO,EACxB,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC,OAAO,CAEf;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,KAAK,CAAC,cAAc,EACzB,SAAS,EAAE,KAAK,CAAC,OAAO,EACxB,MAAM,EAAE,KAAK,CAAC,OAAO,GACpB,KAAK,CAAC,cAAc,CAWtB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,cAAc,EACzB,UAAU,EAAE,KAAK,CAAC,OAAO,GACxB,KAAK,CAAC,OAAO,CAiBf;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,KAAK,CAAC,IAAI,EACtB,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,KAAK,CAAC,OAAO,EACvB,UAAU,EAAE,KAAK,CAAC,OAAO,GACxB,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAS/B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,0BAA0B,CAC9C,cAAc,EAAE,KAAK,CAAC,cAAc,EACpC,WAAW,EAAE,KAAK,CAAC,OAAO,EAC1B,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,KAAK,CAAC,OAAO,EACvB,UAAU,EAAE,KAAK,CAAC,OAAO,GACxB,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CA6E/B"}