@faicad/faijs 0.29.3 → 0.30.9

package/dist/api/generated/view.d.ts

@@ -2,6 +2,10 @@
  * generated/view.ts — 生成文件，勿手改。
  * 由 packages/core/scripts/gen-l3-surface.ts 依据 api/surface/arg-spec.ts 生成（E5/P14 分片）。
  * view 模块：3 个投影符号。
+ * A6（2026-10-06）口径指认：本文件是 brepjs 投影面的**增量**清单；脚本面全集的
+ * 权威来源是 generated/script-face.ts + gen-symbol-table 产物
+ * lang/symbol-table.generated.ts（cad 脚本面 95 op）。两个清单回答不同问题，
+ * 互不为超集——禁止用本文件的名字反推脚本面能力。
  */
 export { viewCamera } from '../view/index.js';
 export { projectView } from '../view/index.js';

package/dist/api/generated/view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../../src/api/generated/view.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../../src/api/generated/view.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/api/generated/view.js

@@ -2,6 +2,10 @@
  * generated/view.ts — 生成文件，勿手改。
  * 由 packages/core/scripts/gen-l3-surface.ts 依据 api/surface/arg-spec.ts 生成（E5/P14 分片）。
  * view 模块：3 个投影符号。
+ * A6（2026-10-06）口径指认：本文件是 brepjs 投影面的**增量**清单；脚本面全集的
+ * 权威来源是 generated/script-face.ts + gen-symbol-table 产物
+ * lang/symbol-table.generated.ts（cad 脚本面 95 op）。两个清单回答不同问题，
+ * 互不为超集——禁止用本文件的名字反推脚本面能力。
  */
 export { viewCamera } from '../view/index.js';
 export { projectView } from '../view/index.js';

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

@@ -1 +1 @@
-{"version":3,"file":"view.js","sourceRoot":"","sources":["../../../src/api/generated/view.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA","sourcesContent":["/**\n * generated/view.ts — 生成文件，勿手改。\n * 由 packages/core/scripts/gen-l3-surface.ts 依据 api/surface/arg-spec.ts 生成（E5/P14 分片）。\n * view 模块：3 个投影符号。\n */\nexport { viewCamera } from '../view/index.js'\n\nexport { projectView } from '../view/index.js'\n\nexport { projectSheet } from '../view/index.js'\n"]}
+{"version":3,"file":"view.js","sourceRoot":"","sources":["../../../src/api/generated/view.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA","sourcesContent":["/**\n * generated/view.ts — 生成文件，勿手改。\n * 由 packages/core/scripts/gen-l3-surface.ts 依据 api/surface/arg-spec.ts 生成（E5/P14 分片）。\n * view 模块：3 个投影符号。\n * A6（2026-10-06）口径指认：本文件是 brepjs 投影面的**增量**清单；脚本面全集的\n * 权威来源是 generated/script-face.ts + gen-symbol-table 产物\n * lang/symbol-table.generated.ts（cad 脚本面 95 op）。两个清单回答不同问题，\n * 互不为超集——禁止用本文件的名字反推脚本面能力。\n */\nexport { viewCamera } from '../view/index.js'\n\nexport { projectView } from '../view/index.js'\n\nexport { projectSheet } from '../view/index.js'\n"]}

package/dist/api/geom-types/constants.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 第一方模块（2026-09-25 core-decouple Phase 1）：复制自 brepjs
+ * `src/core/constants.ts`（同源复制，签名不变）。
+ */
+/** Maximum hash code value for kernel shape hashing (2^31 - 1). */
+export declare const HASH_CODE_MAX = 2147483647;
+/** Multiply degrees by this constant to convert to radians. */
+export declare const DEG2RAD: number;
+/** Multiply radians by this constant to convert to degrees. */
+export declare const RAD2DEG: number;
+//# sourceMappingURL=constants.d.ts.map

package/dist/api/geom-types/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/api/geom-types/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mEAAmE;AACnE,eAAO,MAAM,aAAa,aAAa,CAAC;AAExC,+DAA+D;AAC/D,eAAO,MAAM,OAAO,QAAgB,CAAC;AAErC,+DAA+D;AAC/D,eAAO,MAAM,OAAO,QAAgB,CAAC"}

package/dist/api/geom-types/constants.js

@@ -0,0 +1,11 @@
+/**
+ * 第一方模块（2026-09-25 core-decouple Phase 1）：复制自 brepjs
+ * `src/core/constants.ts`（同源复制，签名不变）。
+ */
+/** Maximum hash code value for kernel shape hashing (2^31 - 1). */
+export const HASH_CODE_MAX = 2147483647;
+/** Multiply degrees by this constant to convert to radians. */
+export const DEG2RAD = Math.PI / 180;
+/** Multiply radians by this constant to convert to degrees. */
+export const RAD2DEG = 180 / Math.PI;
+//# sourceMappingURL=constants.js.map

package/dist/api/geom-types/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/api/geom-types/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mEAAmE;AACnE,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC;AAExC,+DAA+D;AAC/D,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC;AAErC,+DAA+D;AAC/D,MAAM,CAAC,MAAM,OAAO,GAAG,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC","sourcesContent":["/**\n * 第一方模块（2026-09-25 core-decouple Phase 1）：复制自 brepjs\n * `src/core/constants.ts`（同源复制，签名不变）。\n */\n\n/** Maximum hash code value for kernel shape hashing (2^31 - 1). */\nexport const HASH_CODE_MAX = 2147483647;\n\n/** Multiply degrees by this constant to convert to radians. */\nexport const DEG2RAD = Math.PI / 180;\n\n/** Multiply radians by this constant to convert to degrees. */\nexport const RAD2DEG = 180 / Math.PI;\n"]}

package/dist/api/geom-types/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * BREP-TS compatibility surface (P21) — 2026-09-25 core-decouple rewrite.
+ *
+ * The old BREP TS tree (packages/brepjs) is deleted (裁决 9). Every
+ * op projection (primitives / booleans / evolutions / topology queries /
+ * sketching DSL / raw 2D-morph ports) is gone with it — those symbols have no
+ * receiver (裁决 1). What remains in this module is the ④ group only: the pure
+ * combinators / types inlined into core (§5.2) — Result, vectors, planes,
+ * errors, constants — which stay flat-exported from the core facade for
+ * library authors (import { ok, vecAdd } from '@faicad/faijs').
+ */
+export { ok, err, isOk, isErr, unwrap, unwrapOr, map, andThen, } from '../../result/result.js';
+export type { Result, Ok, Err } from '../../result/result.js';
+export { vecAdd, vecSub, vecScale, vecDot, vecCross, vecLength, vecNormalize, } from './vecOps.js';
+export { createPlane, createNamedPlane, resolvePlane, } from './planeOps.js';
+export { kernelError, validationError } from '../../result/errors.js';
+export type { BrepError } from '../../result/errors.js';
+export { DEG2RAD, RAD2DEG } from './constants.js';
+export type { Plane, PlaneName, PlaneInput } from './planeTypes.js';
+export type { Vec3, PointInput } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/geom-types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/geom-types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,OAAO,EACL,EAAE,EACF,GAAG,EACH,IAAI,EACJ,KAAK,EACL,MAAM,EACN,QAAQ,EACR,GAAG,EACH,OAAO,GACR,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAA;AAE1D,OAAO,EACL,MAAM,EACN,MAAM,EACN,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,SAAS,EACT,YAAY,GACb,MAAM,UAAU,CAAA;AAEjB,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,YAAY,GACb,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAClE,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAEpD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAE9C,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEhE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA"}

package/dist/api/geom-types/index.js

@@ -0,0 +1,22 @@
+/**
+ * BREP-TS compatibility surface (P21) — 2026-09-25 core-decouple rewrite.
+ *
+ * The old BREP TS tree (packages/brepjs) is deleted (裁决 9). Every
+ * op projection (primitives / booleans / evolutions / topology queries /
+ * sketching DSL / raw 2D-morph ports) is gone with it — those symbols have no
+ * receiver (裁决 1). What remains in this module is the ④ group only: the pure
+ * combinators / types inlined into core (§5.2) — Result, vectors, planes,
+ * errors, constants — which stay flat-exported from the core facade for
+ * library authors (import { ok, vecAdd } from '@faicad/faijs').
+ */
+// ─────────────────────────────────────────────────────────────────────────────
+// ④ combinators / pure helpers / types（2026-09-25 core-decouple：op 投影面
+// ① ② ③ ⑤ 已随旧子包删除；④ 全部为 core 内联实现，保留为本文件的
+// 唯一内容。旧句柄类型（Vertex/Edge/…/Shape3D/ValidSolid）随裁决 9 删除）
+// ─────────────────────────────────────────────────────────────────────────────
+export { ok, err, isOk, isErr, unwrap, unwrapOr, map, andThen, } from '../../result/result.js';
+export { vecAdd, vecSub, vecScale, vecDot, vecCross, vecLength, vecNormalize, } from './vecOps.js';
+export { createPlane, createNamedPlane, resolvePlane, } from './planeOps.js';
+export { kernelError, validationError } from '../../result/errors.js';
+export { DEG2RAD, RAD2DEG } from './constants.js';
+//# sourceMappingURL=index.js.map

package/dist/api/geom-types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/geom-types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,gFAAgF;AAChF,uEAAuE;AACvE,0CAA0C;AAC1C,wDAAwD;AACxD,gFAAgF;AAEhF,OAAO,EACL,EAAE,EACF,GAAG,EACH,IAAI,EACJ,KAAK,EACL,MAAM,EACN,QAAQ,EACR,GAAG,EACH,OAAO,GACR,MAAM,qBAAqB,CAAA;AAG5B,OAAO,EACL,MAAM,EACN,MAAM,EACN,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,SAAS,EACT,YAAY,GACb,MAAM,UAAU,CAAA;AAEjB,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,YAAY,GACb,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAGlE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA","sourcesContent":["/**\n * BREP-TS compatibility surface (P21) — 2026-09-25 core-decouple rewrite.\n *\n * The old BREP TS tree (packages/brepjs) is deleted (裁决 9). Every\n * op projection (primitives / booleans / evolutions / topology queries /\n * sketching DSL / raw 2D-morph ports) is gone with it — those symbols have no\n * receiver (裁决 1). What remains in this module is the ④ group only: the pure\n * combinators / types inlined into core (§5.2) — Result, vectors, planes,\n * errors, constants — which stay flat-exported from the core facade for\n * library authors (import { ok, vecAdd } from '@faicad/faijs').\n */\n\n// ─────────────────────────────────────────────────────────────────────────────\n// ④ combinators / pure helpers / types（2026-09-25 core-decouple：op 投影面\n// ① ② ③ ⑤ 已随旧子包删除；④ 全部为 core 内联实现，保留为本文件的\n// 唯一内容。旧句柄类型（Vertex/Edge/…/Shape3D/ValidSolid）随裁决 9 删除）\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport {\n  ok,\n  err,\n  isOk,\n  isErr,\n  unwrap,\n  unwrapOr,\n  map,\n  andThen,\n} from '../../result/result'\nexport type { Result, Ok, Err } from '../../result/result'\n\nexport {\n  vecAdd,\n  vecSub,\n  vecScale,\n  vecDot,\n  vecCross,\n  vecLength,\n  vecNormalize,\n} from './vecOps'\n\nexport {\n  createPlane,\n  createNamedPlane,\n  resolvePlane,\n} from './planeOps'\n\nexport { kernelError, validationError } from '../../result/errors'\nexport type { BrepError } from '../../result/errors'\n\nexport { DEG2RAD, RAD2DEG } from './constants'\n\nexport type { Plane, PlaneName, PlaneInput } from './planeTypes'\n\nexport type { Vec3, PointInput } from './types'\n"]}

package/dist/api/geom-types/planeOps.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Pure plane operations — replaces the old Plane class methods.
+ *
+ * 第一方模块（2026-09-25 core-decouple Phase 1）：复制自 brepjs
+ * `src/core/planeOps.ts`（同源复制，签名不变）；import 来源改为 compat 面
+ * 第一方模块与 `result/` 第一方模块。
+ */
+import type { Vec3, Vec2, PointInput } from './types.js';
+import type { Plane, PlaneName, PlaneInput } from './planeTypes.js';
+import { type Result } from '../../result/result.js';
+/**
+ * Create a {@link Plane} from an origin, optional X direction, and a normal.
+ *
+ * If `xDirection` is omitted, the X axis is derived automatically via kernel `gp_Ax3`.
+ *
+ * @param origin - Origin point of the plane.
+ * @param xDirection - Explicit X axis direction, or `null` to auto-derive.
+ * @param normal - Plane normal (Z direction).
+ * @returns The created plane.
+ * @throws If the normal or derived xDir is zero-length.
+ */
+export declare function createPlane(origin: Vec3, xDirection?: Vec3 | null, normal?: Vec3): Plane;
+/**
+ * Create a standard named plane with an optional origin offset.
+ *
+ * @param name - One of the predefined {@link PlaneName} values.
+ * @param sourceOrigin - Origin point, or a scalar offset along the plane normal.
+ * @returns `Ok<Plane>` on success, or `Err` if the name is unknown.
+ */
+export declare function createNamedPlane(name: PlaneName, sourceOrigin?: PointInput | number): Result<Plane>;
+/**
+ * Resolve a {@link PlaneInput} to a concrete {@link Plane}.
+ *
+ * @param input - Plane input to resolve (a named plane or a `Plane` object).
+ * @param origin - Optional origin point or scalar offset along the plane normal.
+ * @returns `Ok<Plane>` on success, or `Err` if the named plane cannot be resolved.
+ */
+export declare function resolvePlane(input: PlaneInput, origin?: PointInput | number): Result<Plane>;
+/**
+ * Create or copy a {@link Plane}.
+ *
+ * When called with a `Plane` object, returns a shallow copy.
+ * When called with a `PlaneName` string (or no arguments), resolves the named
+ * plane with an optional origin offset.
+ *
+ * @param plane - A `Plane` object to copy, or a `PlaneName` string to resolve.
+ * @param origin - Origin point or scalar offset along the plane normal.
+ * @returns The copied or resolved plane.
+ * @default plane `'XY'`
+ */
+/**
+ * Copy a {@link Plane} object.
+ *
+ * @param plane - The `Plane` object to copy.
+ * @returns A shallow copy of the plane.
+ */
+declare function makePlane(plane: Plane): Plane;
+/**
+ * Resolve a named plane with an optional origin offset.
+ *
+ * @param plane - The {@link PlaneName} to resolve (defaults to `'XY'`).
+ * @param origin - Origin point or scalar offset along the plane normal.
+ * @returns The resolved plane.
+ */
+declare function makePlane(plane?: PlaneName, origin?: PointInput | number): Plane;
+export { makePlane };
+/** Convert 2D local coordinates to 3D world coordinates on the plane.
+ *
+ * @param plane - Plane defining the local coordinate system.
+ * @param local - 2D local coordinates.
+ * @returns The corresponding 3D world point.
+ */
+export declare function planeToWorld(plane: Plane, local: Vec2): Vec3;
+/**
+ * Convert 3D world coordinates to 2D local coordinates on the plane.
+ *
+ * @param plane - Plane defining the local coordinate system.
+ * @param world - 3D world point.
+ * @returns The corresponding 2D local coordinates.
+ */
+export declare function planeToLocal(plane: Plane, world: Vec3): Vec2;
+/** Translate a plane by a vector.
+ *
+ * @param plane - Plane to translate.
+ * @param offset - Translation vector.
+ * @returns The translated plane.
+ */
+export declare function translatePlane(plane: Plane, offset: Vec3): Plane;
+/**
+ * Pivot a plane by rotating its axes around a world-space axis.
+ *
+ * @param angleDeg - Rotation angle in **degrees**.
+ * @param axis - World-space axis to rotate around.
+ * @param plane - Plane to pivot.
+ * @returns The pivoted plane.
+ */
+export declare function pivotPlane(plane: Plane, angleDeg: number, axis?: Vec3): Plane;
+//# sourceMappingURL=planeOps.d.ts.map

package/dist/api/geom-types/planeOps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planeOps.d.ts","sourceRoot":"","sources":["../../../src/api/geom-types/planeOps.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEtD,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAYjE,OAAO,EAAE,KAAK,MAAM,EAAmB,MAAM,qBAAqB,CAAC;AAOnE;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,IAAI,EACZ,UAAU,GAAE,IAAI,GAAG,IAAW,EAC9B,MAAM,GAAE,IAAgB,GACvB,KAAK,CA+BP;AAqBD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,SAAS,EACf,YAAY,GAAE,UAAU,GAAG,MAAkB,GAC5C,MAAM,CAAC,KAAK,CAAC,CAWf;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAK3F;AAMD;;;;;;;;;;;GAWG;AACH;;;;;GAKG;AACH,iBAAS,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAAC;AACxC;;;;;;GAMG;AACH,iBAAS,SAAS,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,KAAK,CAAC;AAU3E,OAAO,EAAE,SAAS,EAAE,CAAC;AAMrB;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,GAAG,IAAI,CAG5D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,GAAG,IAAI,CAG5D;AAMD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAG,KAAK,CAEhE;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,IAAgB,GAAG,KAAK,CAMxF"}

package/dist/api/geom-types/planeOps.js

@@ -0,0 +1,170 @@
+/**
+ * Pure plane operations — replaces the old Plane class methods.
+ *
+ * 第一方模块（2026-09-25 core-decouple Phase 1）：复制自 brepjs
+ * `src/core/planeOps.ts`（同源复制，签名不变）；import 来源改为 compat 面
+ * 第一方模块与 `result/` 第一方模块。
+ */
+import { toVec3 } from './types.js';
+import { vecAdd, vecSub, vecScale, vecDot, vecCross, vecNormalize, vecIsZero, vecRotate, } from './vecOps.js';
+import { DEG2RAD } from './constants.js';
+import { ok, err, unwrap } from '../../result/result.js';
+import { validationError } from '../../result/errors.js';
+// ---------------------------------------------------------------------------
+// Plane construction
+// ---------------------------------------------------------------------------
+/**
+ * Create a {@link Plane} from an origin, optional X direction, and a normal.
+ *
+ * If `xDirection` is omitted, the X axis is derived automatically via kernel `gp_Ax3`.
+ *
+ * @param origin - Origin point of the plane.
+ * @param xDirection - Explicit X axis direction, or `null` to auto-derive.
+ * @param normal - Plane normal (Z direction).
+ * @returns The created plane.
+ * @throws If the normal or derived xDir is zero-length.
+ */
+export function createPlane(origin, xDirection = null, normal = [0, 0, 1]) {
+    const zDir = vecNormalize(normal);
+    if (vecIsZero(zDir))
+        throw new Error('Plane normal must be non-zero');
+    let xDir;
+    if (!xDirection) {
+        // Derive xDir perpendicular to zDir (same algorithm as kernel gp_Ax3)
+        const [nx, ny, nz] = zDir;
+        const absX = Math.abs(nx), absY = Math.abs(ny), absZ = Math.abs(nz);
+        // Pick the axis least aligned with zDir to cross-product with
+        let candidate;
+        if (absX <= absY && absX <= absZ)
+            candidate = [1, 0, 0];
+        else if (absY <= absZ)
+            candidate = [0, 1, 0];
+        else
+            candidate = [0, 0, 1];
+        // xDir = normalize(candidate × zDir)
+        const cx = candidate[1] * nz - candidate[2] * ny;
+        const cy = candidate[2] * nx - candidate[0] * nz;
+        const cz = candidate[0] * ny - candidate[1] * nx;
+        const len = Math.sqrt(cx * cx + cy * cy + cz * cz);
+        xDir = len > 1e-12 ? vecNormalize([cx, cy, cz]) : [1, 0, 0];
+    }
+    else {
+        xDir = vecNormalize(xDirection);
+    }
+    if (vecIsZero(xDir))
+        throw new Error('Plane xDir must be non-zero');
+    const yDir = vecNormalize(vecCross(zDir, xDir));
+    return { origin, xDir, yDir, zDir };
+}
+// ---------------------------------------------------------------------------
+// Named plane configs
+// ---------------------------------------------------------------------------
+const PLANES_CONFIG = {
+    XY: { xDir: [1, 0, 0], normal: [0, 0, 1] },
+    YZ: { xDir: [0, 1, 0], normal: [1, 0, 0] },
+    ZX: { xDir: [0, 0, 1], normal: [0, 1, 0] },
+    XZ: { xDir: [1, 0, 0], normal: [0, -1, 0] },
+    YX: { xDir: [0, 1, 0], normal: [0, 0, -1] },
+    ZY: { xDir: [0, 0, 1], normal: [-1, 0, 0] },
+    front: { xDir: [1, 0, 0], normal: [0, 0, 1] },
+    back: { xDir: [-1, 0, 0], normal: [0, 0, -1] },
+    left: { xDir: [0, 0, 1], normal: [-1, 0, 0] },
+    right: { xDir: [0, 0, -1], normal: [1, 0, 0] },
+    top: { xDir: [1, 0, 0], normal: [0, 1, 0] },
+    bottom: { xDir: [1, 0, 0], normal: [0, -1, 0] },
+};
+/**
+ * Create a standard named plane with an optional origin offset.
+ *
+ * @param name - One of the predefined {@link PlaneName} values.
+ * @param sourceOrigin - Origin point, or a scalar offset along the plane normal.
+ * @returns `Ok<Plane>` on success, or `Err` if the name is unknown.
+ */
+export function createNamedPlane(name, sourceOrigin = [0, 0, 0]) {
+    const config = PLANES_CONFIG[name];
+    if (!config)
+        return err(validationError('UNKNOWN_PLANE', `Could not find plane ${name}`));
+    let origin;
+    if (typeof sourceOrigin === 'number') {
+        origin = vecScale(config.normal, sourceOrigin);
+    }
+    else {
+        origin = toVec3(sourceOrigin);
+    }
+    return ok(createPlane(origin, config.xDir, config.normal));
+}
+/**
+ * Resolve a {@link PlaneInput} to a concrete {@link Plane}.
+ *
+ * @param input - Plane input to resolve (a named plane or a `Plane` object).
+ * @param origin - Optional origin point or scalar offset along the plane normal.
+ * @returns `Ok<Plane>` on success, or `Err` if the named plane cannot be resolved.
+ */
+export function resolvePlane(input, origin) {
+    if (typeof input === 'string') {
+        return createNamedPlane(input, origin);
+    }
+    return ok(input);
+}
+function makePlane(plane, origin) {
+    if (plane && typeof plane !== 'string') {
+        // Already a Plane object - return a copy
+        return { ...plane };
+    }
+    else {
+        return unwrap(resolvePlane(plane ?? 'XY', origin));
+    }
+}
+export { makePlane };
+// ---------------------------------------------------------------------------
+// Coordinate transforms
+// ---------------------------------------------------------------------------
+/** Convert 2D local coordinates to 3D world coordinates on the plane.
+ *
+ * @param plane - Plane defining the local coordinate system.
+ * @param local - 2D local coordinates.
+ * @returns The corresponding 3D world point.
+ */
+export function planeToWorld(plane, local) {
+    const [u, v] = local;
+    return vecAdd(vecAdd(plane.origin, vecScale(plane.xDir, u)), vecScale(plane.yDir, v));
+}
+/**
+ * Convert 3D world coordinates to 2D local coordinates on the plane.
+ *
+ * @param plane - Plane defining the local coordinate system.
+ * @param world - 3D world point.
+ * @returns The corresponding 2D local coordinates.
+ */
+export function planeToLocal(plane, world) {
+    const relative = vecSub(world, plane.origin);
+    return [vecDot(relative, plane.xDir), vecDot(relative, plane.yDir)];
+}
+// ---------------------------------------------------------------------------
+// Plane transformations (all return new Plane)
+// ---------------------------------------------------------------------------
+/** Translate a plane by a vector.
+ *
+ * @param plane - Plane to translate.
+ * @param offset - Translation vector.
+ * @returns The translated plane.
+ */
+export function translatePlane(plane, offset) {
+    return { ...plane, origin: vecAdd(plane.origin, offset) };
+}
+/**
+ * Pivot a plane by rotating its axes around a world-space axis.
+ *
+ * @param angleDeg - Rotation angle in **degrees**.
+ * @param axis - World-space axis to rotate around.
+ * @param plane - Plane to pivot.
+ * @returns The pivoted plane.
+ */
+export function pivotPlane(plane, angleDeg, axis = [1, 0, 0]) {
+    const angleRad = angleDeg * DEG2RAD;
+    const newZDir = vecRotate(plane.zDir, axis, angleRad);
+    const newXDir = vecRotate(plane.xDir, axis, angleRad);
+    const newYDir = vecNormalize(vecCross(newZDir, newXDir));
+    return { origin: plane.origin, xDir: newXDir, yDir: newYDir, zDir: newZDir };
+}
+//# sourceMappingURL=planeOps.js.map

package/dist/api/geom-types/planeOps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planeOps.js","sourceRoot":"","sources":["../../../src/api/geom-types/planeOps.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Pure plane operations — replaces the old Plane class methods.\n *\n * 第一方模块（2026-09-25 core-decouple Phase 1）：复制自 brepjs\n * `src/core/planeOps.ts`（同源复制，签名不变）；import 来源改为 compat 面\n * 第一方模块与 `result/` 第一方模块。\n */\n\nimport type { Vec3, Vec2, PointInput } from './types';\nimport { toVec3 } from './types';\nimport type { Plane, PlaneName, PlaneInput } from './planeTypes';\nimport {\n  vecAdd,\n  vecSub,\n  vecScale,\n  vecDot,\n  vecCross,\n  vecNormalize,\n  vecIsZero,\n  vecRotate,\n} from './vecOps';\nimport { DEG2RAD } from './constants';\nimport { type Result, ok, err, unwrap } from '../../result/result';\nimport { validationError } from '../../result/errors';\n\n// ---------------------------------------------------------------------------\n// Plane construction\n// ---------------------------------------------------------------------------\n\n/**\n * Create a {@link Plane} from an origin, optional X direction, and a normal.\n *\n * If `xDirection` is omitted, the X axis is derived automatically via kernel `gp_Ax3`.\n *\n * @param origin - Origin point of the plane.\n * @param xDirection - Explicit X axis direction, or `null` to auto-derive.\n * @param normal - Plane normal (Z direction).\n * @returns The created plane.\n * @throws If the normal or derived xDir is zero-length.\n */\nexport function createPlane(\n  origin: Vec3,\n  xDirection: Vec3 | null = null,\n  normal: Vec3 = [0, 0, 1]\n): Plane {\n  const zDir = vecNormalize(normal);\n  if (vecIsZero(zDir)) throw new Error('Plane normal must be non-zero');\n\n  let xDir: Vec3;\n  if (!xDirection) {\n    // Derive xDir perpendicular to zDir (same algorithm as kernel gp_Ax3)\n    const [nx, ny, nz] = zDir;\n    const absX = Math.abs(nx),\n      absY = Math.abs(ny),\n      absZ = Math.abs(nz);\n    // Pick the axis least aligned with zDir to cross-product with\n    let candidate: Vec3;\n    if (absX <= absY && absX <= absZ) candidate = [1, 0, 0];\n    else if (absY <= absZ) candidate = [0, 1, 0];\n    else candidate = [0, 0, 1];\n    // xDir = normalize(candidate × zDir)\n    const cx = candidate[1] * nz - candidate[2] * ny;\n    const cy = candidate[2] * nx - candidate[0] * nz;\n    const cz = candidate[0] * ny - candidate[1] * nx;\n    const len = Math.sqrt(cx * cx + cy * cy + cz * cz);\n    xDir = len > 1e-12 ? vecNormalize([cx, cy, cz]) : [1, 0, 0];\n  } else {\n    xDir = vecNormalize(xDirection);\n  }\n\n  if (vecIsZero(xDir)) throw new Error('Plane xDir must be non-zero');\n\n  const yDir = vecNormalize(vecCross(zDir, xDir));\n\n  return { origin, xDir, yDir, zDir };\n}\n\n// ---------------------------------------------------------------------------\n// Named plane configs\n// ---------------------------------------------------------------------------\n\nconst PLANES_CONFIG: Record<PlaneName, { xDir: Vec3; normal: Vec3 }> = {\n  XY: { xDir: [1, 0, 0], normal: [0, 0, 1] },\n  YZ: { xDir: [0, 1, 0], normal: [1, 0, 0] },\n  ZX: { xDir: [0, 0, 1], normal: [0, 1, 0] },\n  XZ: { xDir: [1, 0, 0], normal: [0, -1, 0] },\n  YX: { xDir: [0, 1, 0], normal: [0, 0, -1] },\n  ZY: { xDir: [0, 0, 1], normal: [-1, 0, 0] },\n  front: { xDir: [1, 0, 0], normal: [0, 0, 1] },\n  back: { xDir: [-1, 0, 0], normal: [0, 0, -1] },\n  left: { xDir: [0, 0, 1], normal: [-1, 0, 0] },\n  right: { xDir: [0, 0, -1], normal: [1, 0, 0] },\n  top: { xDir: [1, 0, 0], normal: [0, 1, 0] },\n  bottom: { xDir: [1, 0, 0], normal: [0, -1, 0] },\n};\n\n/**\n * Create a standard named plane with an optional origin offset.\n *\n * @param name - One of the predefined {@link PlaneName} values.\n * @param sourceOrigin - Origin point, or a scalar offset along the plane normal.\n * @returns `Ok<Plane>` on success, or `Err` if the name is unknown.\n */\nexport function createNamedPlane(\n  name: PlaneName,\n  sourceOrigin: PointInput | number = [0, 0, 0]\n): Result<Plane> {\n  const config = PLANES_CONFIG[name] as { xDir: Vec3; normal: Vec3 } | undefined;\n  if (!config) return err(validationError('UNKNOWN_PLANE', `Could not find plane ${name}`));\n\n  let origin: Vec3;\n  if (typeof sourceOrigin === 'number') {\n    origin = vecScale(config.normal, sourceOrigin);\n  } else {\n    origin = toVec3(sourceOrigin);\n  }\n  return ok(createPlane(origin, config.xDir, config.normal));\n}\n\n/**\n * Resolve a {@link PlaneInput} to a concrete {@link Plane}.\n *\n * @param input - Plane input to resolve (a named plane or a `Plane` object).\n * @param origin - Optional origin point or scalar offset along the plane normal.\n * @returns `Ok<Plane>` on success, or `Err` if the named plane cannot be resolved.\n */\nexport function resolvePlane(input: PlaneInput, origin?: PointInput | number): Result<Plane> {\n  if (typeof input === 'string') {\n    return createNamedPlane(input, origin);\n  }\n  return ok(input);\n}\n\n// ---------------------------------------------------------------------------\n// makePlane — convenience constructor (migrated from geometryHelpers.ts)\n// ---------------------------------------------------------------------------\n\n/**\n * Create or copy a {@link Plane}.\n *\n * When called with a `Plane` object, returns a shallow copy.\n * When called with a `PlaneName` string (or no arguments), resolves the named\n * plane with an optional origin offset.\n *\n * @param plane - A `Plane` object to copy, or a `PlaneName` string to resolve.\n * @param origin - Origin point or scalar offset along the plane normal.\n * @returns The copied or resolved plane.\n * @default plane `'XY'`\n */\n/**\n * Copy a {@link Plane} object.\n *\n * @param plane - The `Plane` object to copy.\n * @returns A shallow copy of the plane.\n */\nfunction makePlane(plane: Plane): Plane;\n/**\n * Resolve a named plane with an optional origin offset.\n *\n * @param plane - The {@link PlaneName} to resolve (defaults to `'XY'`).\n * @param origin - Origin point or scalar offset along the plane normal.\n * @returns The resolved plane.\n */\nfunction makePlane(plane?: PlaneName, origin?: PointInput | number): Plane;\nfunction makePlane(plane?: PlaneInput, origin?: PointInput | number): Plane {\n  if (plane && typeof plane !== 'string') {\n    // Already a Plane object - return a copy\n    return { ...plane };\n  } else {\n    return unwrap(resolvePlane(plane ?? 'XY', origin));\n  }\n}\n\nexport { makePlane };\n\n// ---------------------------------------------------------------------------\n// Coordinate transforms\n// ---------------------------------------------------------------------------\n\n/** Convert 2D local coordinates to 3D world coordinates on the plane.\n *\n * @param plane - Plane defining the local coordinate system.\n * @param local - 2D local coordinates.\n * @returns The corresponding 3D world point.\n */\nexport function planeToWorld(plane: Plane, local: Vec2): Vec3 {\n  const [u, v] = local;\n  return vecAdd(vecAdd(plane.origin, vecScale(plane.xDir, u)), vecScale(plane.yDir, v));\n}\n\n/**\n * Convert 3D world coordinates to 2D local coordinates on the plane.\n *\n * @param plane - Plane defining the local coordinate system.\n * @param world - 3D world point.\n * @returns The corresponding 2D local coordinates.\n */\nexport function planeToLocal(plane: Plane, world: Vec3): Vec2 {\n  const relative = vecSub(world, plane.origin);\n  return [vecDot(relative, plane.xDir), vecDot(relative, plane.yDir)];\n}\n\n// ---------------------------------------------------------------------------\n// Plane transformations (all return new Plane)\n// ---------------------------------------------------------------------------\n\n/** Translate a plane by a vector.\n *\n * @param plane - Plane to translate.\n * @param offset - Translation vector.\n * @returns The translated plane.\n */\nexport function translatePlane(plane: Plane, offset: Vec3): Plane {\n  return { ...plane, origin: vecAdd(plane.origin, offset) };\n}\n\n/**\n * Pivot a plane by rotating its axes around a world-space axis.\n *\n * @param angleDeg - Rotation angle in **degrees**.\n * @param axis - World-space axis to rotate around.\n * @param plane - Plane to pivot.\n * @returns The pivoted plane.\n */\nexport function pivotPlane(plane: Plane, angleDeg: number, axis: Vec3 = [1, 0, 0]): Plane {\n  const angleRad = angleDeg * DEG2RAD;\n  const newZDir = vecRotate(plane.zDir, axis, angleRad);\n  const newXDir = vecRotate(plane.xDir, axis, angleRad);\n  const newYDir = vecNormalize(vecCross(newZDir, newXDir));\n  return { origin: plane.origin, xDir: newXDir, yDir: newYDir, zDir: newZDir };\n}\n"]}

package/dist/api/geom-types/planeTypes.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Plane type definitions — immutable plain objects.
+ *
+ * 第一方模块（2026-09-25 core-decouple Phase 1）：复制自 brepjs
+ * `src/core/planeTypes.ts`（同源复制，签名不变）。
+ */
+import type { Vec3 } from './types.js';
+/** Immutable plane defined by origin and three orthogonal direction vectors. */
+export interface Plane {
+    readonly origin: Vec3;
+    readonly xDir: Vec3;
+    readonly yDir: Vec3;
+    readonly zDir: Vec3;
+}
+/**
+ * Named standard planes.
+ *
+ * Axis pairs (`'XY'`, `'YZ'`, …) and view names (`'front'`, `'top'`, …)
+ * are both supported. The axis-pair order determines the normal direction.
+ */
+export type PlaneName = 'XY' | 'YZ' | 'ZX' | 'XZ' | 'YX' | 'ZY' | 'front' | 'back' | 'left' | 'right' | 'top' | 'bottom';
+/** Accept either an explicit {@link Plane} object or a {@link PlaneName} string. */
+export type PlaneInput = Plane | PlaneName;
+//# sourceMappingURL=planeTypes.d.ts.map

package/dist/api/geom-types/planeTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planeTypes.d.ts","sourceRoot":"","sources":["../../../src/api/geom-types/planeTypes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAEpC,gFAAgF;AAChF,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GACnB,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEnG,oFAAoF;AACpF,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,SAAS,CAAC"}

package/dist/api/geom-types/planeTypes.js

@@ -0,0 +1,8 @@
+/**
+ * Plane type definitions — immutable plain objects.
+ *
+ * 第一方模块（2026-09-25 core-decouple Phase 1）：复制自 brepjs
+ * `src/core/planeTypes.ts`（同源复制，签名不变）。
+ */
+export {};
+//# sourceMappingURL=planeTypes.js.map

package/dist/api/geom-types/planeTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planeTypes.js","sourceRoot":"","sources":["../../../src/api/geom-types/planeTypes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG","sourcesContent":["/**\n * Plane type definitions — immutable plain objects.\n *\n * 第一方模块（2026-09-25 core-decouple Phase 1）：复制自 brepjs\n * `src/core/planeTypes.ts`（同源复制，签名不变）。\n */\n\nimport type { Vec3 } from './types';\n\n/** Immutable plane defined by origin and three orthogonal direction vectors. */\nexport interface Plane {\n  readonly origin: Vec3;\n  readonly xDir: Vec3;\n  readonly yDir: Vec3;\n  readonly zDir: Vec3;\n}\n\n/**\n * Named standard planes.\n *\n * Axis pairs (`'XY'`, `'YZ'`, …) and view names (`'front'`, `'top'`, …)\n * are both supported. The axis-pair order determines the normal direction.\n */\nexport type PlaneName =\n  'XY' | 'YZ' | 'ZX' | 'XZ' | 'YX' | 'ZY' | 'front' | 'back' | 'left' | 'right' | 'top' | 'bottom';\n\n/** Accept either an explicit {@link Plane} object or a {@link PlaneName} string. */\nexport type PlaneInput = Plane | PlaneName;\n"]}

package/dist/api/geom-types/types.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Core type definitions（compat 面类型底座）。
+ *
+ * 第一方模块（2026-09-25 core-decouple Phase 1）：复制自 brepjs
+ * `src/core/types.ts`（同源复制，签名不变）。
+ * Vec3 tuples replace the old Vector class.
+ * All operations on vectors are pure functions in vecOps.ts.
+ */
+/** 3D vector/point as a readonly tuple */
+export type Vec3 = readonly [number, number, number];
+/** 2D point as a readonly tuple */
+export type Vec2 = readonly [number, number];
+/**
+ * Flexible point input — accepts various formats for convenience.
+ * Use `toVec3()` to normalize to Vec3.
+ */
+export type PointInput = Vec3 | Vec2 | readonly [number, number, number] | readonly [number, number];
+/** Normalize any point input to Vec3
+ *
+ * @param p - Point input to normalize.
+ * @returns The point as a `Vec3` (missing z defaults to 0).
+ */
+export declare function toVec3(p: PointInput): Vec3;
+/** Normalize to Vec2 (drops z)
+ *
+ * @param p - Point input to normalize.
+ * @returns The point as a `Vec2` (z component dropped).
+ */
+export declare function toVec2(p: PointInput): Vec2;
+/** Direction shorthand — a named axis (`'X'`, `'Y'`, `'Z'`) or an explicit {@link Vec3}. */
+export type Direction = Vec3 | 'X' | 'Y' | 'Z';
+/**
+ * Resolve a {@link Direction} shorthand to a unit {@link Vec3}.
+ *
+ * @param d - Direction shorthand to resolve.
+ * @returns The direction as a unit `Vec3`.
+ * @throws If the string is not a recognised axis name.
+ */
+export declare function resolveDirection(d: Direction): Vec3;
+/** A row of a 4x4 matrix. */
+type Row4 = [number, number, number, number];
+/** 4x4 affine transformation matrix in row-major order. Bottom row must be [0,0,0,1]. */
+export type Matrix4x4 = [Row4, Row4, Row4, Row4];
+/** Structured matrix input: 3x3 linear part + translation vector. */
+export interface MatrixTransform {
+    /** 3x3 linear part in row-major order: [r00, r01, r02, r10, r11, r12, r20, r21, r22]. */
+    readonly linear: readonly [
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number
+    ];
+    /** Translation vector [tx, ty, tz]. */
+    readonly translation: Vec3;
+}
+/** Input accepted by `applyMatrix`: either a raw 4x4 array or a structured object. */
+export type MatrixInput = Matrix4x4 | MatrixTransform;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/api/geom-types/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/api/geom-types/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,0CAA0C;AAC1C,MAAM,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAErD,mCAAmC;AACnC,MAAM,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE7C;;;GAGG;AACH,MAAM,MAAM,UAAU,GACpB,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE9E;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,UAAU,GAAG,IAAI,CAG1C;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,UAAU,GAAG,IAAI,CAE1C;AAED,4FAA4F;AAC5F,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAQ/C;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,SAAS,GAAG,IAAI,CAOnD;AAMD,6BAA6B;AAC7B,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE7C,yFAAyF;AACzF,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAEjD,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC9B,yFAAyF;IACzF,QAAQ,CAAC,MAAM,EAAE,SAAS;QACxB,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;KACP,CAAC;IACF,uCAAuC;IACvC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;CAC5B;AAED,sFAAsF;AACtF,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,eAAe,CAAC"}

package/dist/api/geom-types/types.js

@@ -0,0 +1,48 @@
+/**
+ * Core type definitions（compat 面类型底座）。
+ *
+ * 第一方模块（2026-09-25 core-decouple Phase 1）：复制自 brepjs
+ * `src/core/types.ts`（同源复制，签名不变）。
+ * Vec3 tuples replace the old Vector class.
+ * All operations on vectors are pure functions in vecOps.ts.
+ */
+/** Normalize any point input to Vec3
+ *
+ * @param p - Point input to normalize.
+ * @returns The point as a `Vec3` (missing z defaults to 0).
+ */
+export function toVec3(p) {
+    if (p.length === 2)
+        return [p[0], p[1], 0];
+    return [p[0], p[1], p[2]];
+}
+/** Normalize to Vec2 (drops z)
+ *
+ * @param p - Point input to normalize.
+ * @returns The point as a `Vec2` (z component dropped).
+ */
+export function toVec2(p) {
+    return [p[0], p[1]];
+}
+const DIRECTIONS = {
+    X: [1, 0, 0],
+    Y: [0, 1, 0],
+    Z: [0, 0, 1],
+};
+/**
+ * Resolve a {@link Direction} shorthand to a unit {@link Vec3}.
+ *
+ * @param d - Direction shorthand to resolve.
+ * @returns The direction as a unit `Vec3`.
+ * @throws If the string is not a recognised axis name.
+ */
+export function resolveDirection(d) {
+    if (typeof d === 'string') {
+        const dir = DIRECTIONS[d];
+        if (!dir)
+            throw new Error(`Unknown direction: ${d}`);
+        return dir;
+    }
+    return d;
+}
+//# sourceMappingURL=types.js.map

package/dist/api/geom-types/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/api/geom-types/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAeH;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,CAAa;IAClC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3C,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,CAAa;IAClC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACtB,CAAC;AAKD,MAAM,UAAU,GAAyB;IACvC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACZ,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACZ,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;CACb,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,CAAY;IAC3C,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC;QACrD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC","sourcesContent":["/**\n * Core type definitions（compat 面类型底座）。\n *\n * 第一方模块（2026-09-25 core-decouple Phase 1）：复制自 brepjs\n * `src/core/types.ts`（同源复制，签名不变）。\n * Vec3 tuples replace the old Vector class.\n * All operations on vectors are pure functions in vecOps.ts.\n */\n\n/** 3D vector/point as a readonly tuple */\nexport type Vec3 = readonly [number, number, number];\n\n/** 2D point as a readonly tuple */\nexport type Vec2 = readonly [number, number];\n\n/**\n * Flexible point input — accepts various formats for convenience.\n * Use `toVec3()` to normalize to Vec3.\n */\nexport type PointInput =\n  Vec3 | Vec2 | readonly [number, number, number] | readonly [number, number];\n\n/** Normalize any point input to Vec3\n *\n * @param p - Point input to normalize.\n * @returns The point as a `Vec3` (missing z defaults to 0).\n */\nexport function toVec3(p: PointInput): Vec3 {\n  if (p.length === 2) return [p[0], p[1], 0];\n  return [p[0], p[1], p[2]];\n}\n\n/** Normalize to Vec2 (drops z)\n *\n * @param p - Point input to normalize.\n * @returns The point as a `Vec2` (z component dropped).\n */\nexport function toVec2(p: PointInput): Vec2 {\n  return [p[0], p[1]];\n}\n\n/** Direction shorthand — a named axis (`'X'`, `'Y'`, `'Z'`) or an explicit {@link Vec3}. */\nexport type Direction = Vec3 | 'X' | 'Y' | 'Z';\n\nconst DIRECTIONS: Record<string, Vec3> = {\n  X: [1, 0, 0],\n  Y: [0, 1, 0],\n  Z: [0, 0, 1],\n};\n\n/**\n * Resolve a {@link Direction} shorthand to a unit {@link Vec3}.\n *\n * @param d - Direction shorthand to resolve.\n * @returns The direction as a unit `Vec3`.\n * @throws If the string is not a recognised axis name.\n */\nexport function resolveDirection(d: Direction): Vec3 {\n  if (typeof d === 'string') {\n    const dir = DIRECTIONS[d];\n    if (!dir) throw new Error(`Unknown direction: ${d}`);\n    return dir;\n  }\n  return d;\n}\n\n// ---------------------------------------------------------------------------\n// Matrix types for applyMatrix (OpenSCAD multmatrix equivalent)\n// ---------------------------------------------------------------------------\n\n/** A row of a 4x4 matrix. */\ntype Row4 = [number, number, number, number];\n\n/** 4x4 affine transformation matrix in row-major order. Bottom row must be [0,0,0,1]. */\nexport type Matrix4x4 = [Row4, Row4, Row4, Row4];\n\n/** Structured matrix input: 3x3 linear part + translation vector. */\nexport interface MatrixTransform {\n  /** 3x3 linear part in row-major order: [r00, r01, r02, r10, r11, r12, r20, r21, r22]. */\n  readonly linear: readonly [\n    number,\n    number,\n    number,\n    number,\n    number,\n    number,\n    number,\n    number,\n    number,\n  ];\n  /** Translation vector [tx, ty, tz]. */\n  readonly translation: Vec3;\n}\n\n/** Input accepted by `applyMatrix`: either a raw 4x4 array or a structured object. */\nexport type MatrixInput = Matrix4x4 | MatrixTransform;\n"]}