@faicad/faijs 0.13.0

package/dist/vendored/brepjs/core/planeOps.js

@@ -0,0 +1,148 @@
+/**
+ * Pure plane operations — replaces the old Plane class methods.
+ * All functions return new immutable Plane objects.
+ */
+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.js';
+import { validationError } from './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).
+ * @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}.
+ *
+ * @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. */
+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.
+ */
+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. */
+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.
+ */
+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/vendored/brepjs/core/planeOps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planeOps.js","sourceRoot":"","sources":["../../../../src/vendored/brepjs/core/planeOps.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Pure plane operations — replaces the old Plane class methods.\n * All functions return new immutable Plane objects.\n */\n\nimport type { Vec3, Vec2, PointInput } from './types.js';\nimport { toVec3 } from './types.js';\nimport type { Plane, PlaneName, PlaneInput } from './planeTypes.js';\nimport {\n  vecAdd,\n  vecSub,\n  vecScale,\n  vecDot,\n  vecCross,\n  vecNormalize,\n  vecIsZero,\n  vecRotate,\n} from './vecOps.js';\nimport { DEG2RAD } from './constants.js';\nimport { type Result, ok, err, unwrap } from './result.js';\nimport { validationError } from './errors.js';\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 * @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 * @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 * @default plane `'XY'`\n */\nfunction makePlane(plane: Plane): Plane;\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. */\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 */\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. */\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 */\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/vendored/brepjs/core/planeTypes.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Plane type definitions — immutable plain objects.
+ * Replaces the old Plane class.
+ */
+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/vendored/brepjs/core/planeTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planeTypes.d.ts","sourceRoot":"","sources":["../../../../src/vendored/brepjs/core/planeTypes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,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/vendored/brepjs/core/planeTypes.js

@@ -0,0 +1,6 @@
+/**
+ * Plane type definitions — immutable plain objects.
+ * Replaces the old Plane class.
+ */
+export {};
+//# sourceMappingURL=planeTypes.js.map

package/dist/vendored/brepjs/core/planeTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planeTypes.js","sourceRoot":"","sources":["../../../../src/vendored/brepjs/core/planeTypes.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * Plane type definitions — immutable plain objects.\n * Replaces the old Plane class.\n */\n\nimport type { Vec3 } from './types.js';\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/vendored/brepjs/core/result.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Rust-inspired Result<T, E> type for explicit error handling.
+ * Zero internal imports — this is a pure foundation module.
+ */
+import type { BrepError } from './errors.js';
+export interface Ok<T> {
+    readonly ok: true;
+    readonly value: T;
+}
+export interface Err<E> {
+    readonly ok: false;
+    readonly error: E;
+}
+export type Result<T, E = BrepError> = Ok<T> | Err<E>;
+export type Unit = undefined;
+export declare function ok<T>(value: T): Ok<T>;
+export declare function err<E>(error: E): Err<E>;
+export declare const OK: Ok<Unit>;
+export declare function isOk<T, E>(result: Result<T, E>): result is Ok<T>;
+export declare function isErr<T, E>(result: Result<T, E>): result is Err<E>;
+export declare function map<T, U, E>(result: Result<T, E>, fn: (value: T) => U): Result<U, E>;
+export declare function mapErr<T, E, F>(result: Result<T, E>, fn: (error: E) => F): Result<T, F>;
+export declare function andThen<T, U, E>(result: Result<T, E>, fn: (value: T) => Result<U, E>): Result<U, E>;
+/** Alias for andThen */
+export declare const flatMap: typeof andThen;
+/** Return `a` if Ok, otherwise return `b`. */
+export declare function or<T, E, F>(a: Result<T, E>, b: Result<T, F>): Result<T, F>;
+/** Return `result` if Ok, otherwise call `fn` with the error and return its result. */
+export declare function orElse<T, E, F>(result: Result<T, E>, fn: (error: E) => Result<T, F>): Result<T, F>;
+/** Combine two independent Results into a Result of a tuple. */
+export declare function zip<A, B, E>(a: Result<A, E>, b: Result<B, E>): Result<[A, B], E>;
+/** Collect an array of Results into a Result of an array. Alias for {@link collect}. */
+export declare const all: typeof collect;
+/** Run a side-effect on an Ok value without transforming the result. */
+export declare function tap<T, E>(result: Result<T, E>, fn: (value: T) => void): Result<T, E>;
+/** Run a side-effect on an Err value without transforming the result. */
+export declare function tapErr<T, E>(result: Result<T, E>, fn: (error: E) => void): Result<T, E>;
+/** Flatten a nested Result<Result<T, E>, E> into Result<T, E>. */
+export declare function flatten<T, E>(result: Result<Result<T, E>, E>): Result<T, E>;
+/** Map both Ok and Err variants in a single pass. */
+export declare function mapBoth<T, U, E, F>(result: Result<T, E>, okFn: (value: T) => U, errFn: (error: E) => F): Result<U, F>;
+/** Convert a nullable value to a Result, using `errorFn` to produce the error for null/undefined. */
+export declare function fromNullable<T, E>(value: T | null | undefined, errorFn: () => E): Result<T, E>;
+export declare function unwrap<T, E>(result: Result<T, E>): T;
+export declare function unwrapOr<T, E>(result: Result<T, E>, defaultValue: T): T;
+export declare function unwrapOrElse<T, E>(result: Result<T, E>, fn: (error: E) => T): T;
+export declare function unwrapErr<T, E>(result: Result<T, E>): E;
+export declare function match<T, E, U>(result: Result<T, E>, handlers: {
+    ok: (value: T) => U;
+    err: (error: E) => U;
+}): U;
+/**
+ * Collects an array of Results into a Result of an array.
+ * Short-circuits on the first Err.
+ */
+export declare function collect<T, E>(results: Result<T, E>[]): Result<T[], E>;
+/**
+ * Wraps a throwing function into a Result.
+ * The mapError function converts the caught exception into the error type.
+ */
+export declare function tryCatch<T, E>(fn: () => T, mapError: (error: unknown) => E): Result<T, E>;
+/**
+ * Wraps an async throwing function into a Result.
+ * The mapError function converts the caught exception into the error type.
+ */
+export declare function tryCatchAsync<T, E>(fn: () => Promise<T>, mapError: (error: unknown) => E): Promise<Result<T, E>>;
+/** A chainable pipeline that short-circuits on the first Err. */
+export interface ResultPipeline<T, E> {
+    /** Chain a Result-returning transform. Short-circuits on Err. */
+    then<U>(fn: (value: T) => Result<U, E>): ResultPipeline<U, E>;
+    /** Extract the final Result. */
+    readonly result: Result<T, E>;
+}
+/**
+ * Create a chainable pipeline from a value or Result.
+ *
+ * ```ts
+ * pipeline(shape)
+ *   .then(s => filletShape(s, edges, 2))
+ *   .then(s => shellShape(s, [topFace], 1))
+ *   .result  // → Result<Shape3D>
+ * ```
+ */
+export declare function pipeline<T, E = BrepError>(input: T | Result<T, E>): ResultPipeline<T, E>;
+//# sourceMappingURL=result.d.ts.map

package/dist/vendored/brepjs/core/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../../../src/vendored/brepjs/core/result.ts"],"names":[],"mappings":"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"}

package/dist/vendored/brepjs/core/result.js

@@ -0,0 +1,212 @@
+/**
+ * Rust-inspired Result<T, E> type for explicit error handling.
+ * Zero internal imports — this is a pure foundation module.
+ */
+// ---------------------------------------------------------------------------
+// Constructors
+// ---------------------------------------------------------------------------
+export function ok(value) {
+    return { ok: true, value };
+}
+export function err(error) {
+    return { ok: false, error };
+}
+export const OK = ok(undefined);
+// ---------------------------------------------------------------------------
+// Type guards
+// ---------------------------------------------------------------------------
+export function isOk(result) {
+    return result.ok;
+}
+export function isErr(result) {
+    return !result.ok;
+}
+// ---------------------------------------------------------------------------
+// Combinators
+// ---------------------------------------------------------------------------
+export function map(result, fn) {
+    if (result.ok)
+        return ok(fn(result.value));
+    return result;
+}
+export function mapErr(result, fn) {
+    if (result.ok)
+        return result;
+    return err(fn(result.error));
+}
+export function andThen(result, fn) {
+    if (result.ok)
+        return fn(result.value);
+    return result;
+}
+/** Alias for andThen */
+export const flatMap = andThen;
+/** Return `a` if Ok, otherwise return `b`. */
+export function or(a, b) {
+    if (a.ok)
+        return a;
+    return b;
+}
+/** Return `result` if Ok, otherwise call `fn` with the error and return its result. */
+export function orElse(result, fn) {
+    if (result.ok)
+        return result;
+    return fn(result.error);
+}
+/** Combine two independent Results into a Result of a tuple. */
+export function zip(a, b) {
+    if (!a.ok)
+        return a;
+    if (!b.ok)
+        return b;
+    return ok([a.value, b.value]);
+}
+/** Collect an array of Results into a Result of an array. Alias for {@link collect}. */
+export const all = collect;
+/** Run a side-effect on an Ok value without transforming the result. */
+export function tap(result, fn) {
+    if (result.ok)
+        fn(result.value);
+    return result;
+}
+/** Run a side-effect on an Err value without transforming the result. */
+export function tapErr(result, fn) {
+    if (!result.ok)
+        fn(result.error);
+    return result;
+}
+/** Flatten a nested Result<Result<T, E>, E> into Result<T, E>. */
+export function flatten(result) {
+    return result.ok ? result.value : result;
+}
+/** Map both Ok and Err variants in a single pass. */
+export function mapBoth(result, okFn, errFn) {
+    return result.ok ? ok(okFn(result.value)) : err(errFn(result.error));
+}
+/** Convert a nullable value to a Result, using `errorFn` to produce the error for null/undefined. */
+export function fromNullable(value, errorFn) {
+    if (value === null || value === undefined)
+        return err(errorFn());
+    return ok(value);
+}
+// ---------------------------------------------------------------------------
+// Extraction
+// ---------------------------------------------------------------------------
+/** Format an error for display, handling BrepError objects specially */
+function formatError(error) {
+    if (typeof error === 'object' &&
+        error !== null &&
+        'kind' in error &&
+        'code' in error &&
+        'message' in error) {
+        // BrepError-like object
+        const e = error;
+        return `[${e.kind}] ${e.code}: ${e.message}`;
+    }
+    return String(error);
+}
+export function unwrap(result) {
+    if (result.ok)
+        return result.value;
+    throw new Error(`Called unwrap() on an Err: ${formatError(result.error)}`);
+}
+export function unwrapOr(result, defaultValue) {
+    if (result.ok)
+        return result.value;
+    return defaultValue;
+}
+export function unwrapOrElse(result, fn) {
+    if (result.ok)
+        return result.value;
+    return fn(result.error);
+}
+export function unwrapErr(result) {
+    if (!result.ok)
+        return result.error;
+    throw new Error(`Called unwrapErr() on an Ok: ${String(result.value)}`);
+}
+// ---------------------------------------------------------------------------
+// Pattern matching
+// ---------------------------------------------------------------------------
+export function match(result, handlers) {
+    if (result.ok)
+        return handlers.ok(result.value);
+    return handlers.err(result.error);
+}
+// ---------------------------------------------------------------------------
+// Collection
+// ---------------------------------------------------------------------------
+/**
+ * Collects an array of Results into a Result of an array.
+ * Short-circuits on the first Err.
+ */
+export function collect(results) {
+    const values = [];
+    for (const result of results) {
+        if (!result.ok)
+            return result;
+        values.push(result.value);
+    }
+    return ok(values);
+}
+// ---------------------------------------------------------------------------
+// Try-catch boundary
+// ---------------------------------------------------------------------------
+/**
+ * Wraps a throwing function into a Result.
+ * The mapError function converts the caught exception into the error type.
+ */
+export function tryCatch(fn, mapError) {
+    try {
+        return ok(fn());
+    }
+    catch (e) {
+        return err(mapError(e));
+    }
+}
+/**
+ * Wraps an async throwing function into a Result.
+ * The mapError function converts the caught exception into the error type.
+ */
+export async function tryCatchAsync(fn, mapError) {
+    try {
+        return ok(await fn());
+    }
+    catch (e) {
+        return err(mapError(e));
+    }
+}
+/**
+ * Create a chainable pipeline from a value or Result.
+ *
+ * ```ts
+ * pipeline(shape)
+ *   .then(s => filletShape(s, edges, 2))
+ *   .then(s => shellShape(s, [topFace], 1))
+ *   .result  // → Result<Shape3D>
+ * ```
+ */
+export function pipeline(input) {
+    // Detect Result objects by checking the 'ok' discriminant is a boolean
+    function isResult(v) {
+        return (typeof v === 'object' &&
+            v !== null &&
+            'ok' in v &&
+            typeof v['ok'] === 'boolean');
+    }
+    const initial = isResult(input) ? input : ok(input);
+    function makePipeline(current) {
+        return {
+            then(fn) {
+                if (!current.ok)
+                    return makePipeline(current);
+                return makePipeline(fn(current.value));
+            },
+            get result() {
+                return current;
+            },
+        };
+    }
+    return makePipeline(initial);
+}
+//# sourceMappingURL=result.js.map

package/dist/vendored/brepjs/core/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../../../src/vendored/brepjs/core/result.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Rust-inspired Result<T, E> type for explicit error handling.\n * Zero internal imports — this is a pure foundation module.\n */\n\nimport type { BrepError } from './errors.js';\n\n// ---------------------------------------------------------------------------\n// Core types\n// ---------------------------------------------------------------------------\n\nexport interface Ok<T> {\n  readonly ok: true;\n  readonly value: T;\n}\n\nexport interface Err<E> {\n  readonly ok: false;\n  readonly error: E;\n}\n\nexport type Result<T, E = BrepError> = Ok<T> | Err<E>;\n\nexport type Unit = undefined;\n\n// ---------------------------------------------------------------------------\n// Constructors\n// ---------------------------------------------------------------------------\n\nexport function ok<T>(value: T): Ok<T> {\n  return { ok: true, value };\n}\n\nexport function err<E>(error: E): Err<E> {\n  return { ok: false, error };\n}\n\nexport const OK: Ok<Unit> = ok(undefined);\n\n// ---------------------------------------------------------------------------\n// Type guards\n// ---------------------------------------------------------------------------\n\nexport function isOk<T, E>(result: Result<T, E>): result is Ok<T> {\n  return result.ok;\n}\n\nexport function isErr<T, E>(result: Result<T, E>): result is Err<E> {\n  return !result.ok;\n}\n\n// ---------------------------------------------------------------------------\n// Combinators\n// ---------------------------------------------------------------------------\n\nexport function map<T, U, E>(result: Result<T, E>, fn: (value: T) => U): Result<U, E> {\n  if (result.ok) return ok(fn(result.value));\n  return result;\n}\n\nexport function mapErr<T, E, F>(result: Result<T, E>, fn: (error: E) => F): Result<T, F> {\n  if (result.ok) return result;\n  return err(fn(result.error));\n}\n\nexport function andThen<T, U, E>(\n  result: Result<T, E>,\n  fn: (value: T) => Result<U, E>\n): Result<U, E> {\n  if (result.ok) return fn(result.value);\n  return result;\n}\n\n/** Alias for andThen */\nexport const flatMap = andThen;\n\n/** Return `a` if Ok, otherwise return `b`. */\nexport function or<T, E, F>(a: Result<T, E>, b: Result<T, F>): Result<T, F> {\n  if (a.ok) return a;\n  return b;\n}\n\n/** Return `result` if Ok, otherwise call `fn` with the error and return its result. */\nexport function orElse<T, E, F>(\n  result: Result<T, E>,\n  fn: (error: E) => Result<T, F>\n): Result<T, F> {\n  if (result.ok) return result;\n  return fn(result.error);\n}\n\n/** Combine two independent Results into a Result of a tuple. */\nexport function zip<A, B, E>(a: Result<A, E>, b: Result<B, E>): Result<[A, B], E> {\n  if (!a.ok) return a;\n  if (!b.ok) return b;\n  return ok([a.value, b.value]);\n}\n\n/** Collect an array of Results into a Result of an array. Alias for {@link collect}. */\nexport const all = collect;\n\n/** Run a side-effect on an Ok value without transforming the result. */\nexport function tap<T, E>(result: Result<T, E>, fn: (value: T) => void): Result<T, E> {\n  if (result.ok) fn(result.value);\n  return result;\n}\n\n/** Run a side-effect on an Err value without transforming the result. */\nexport function tapErr<T, E>(result: Result<T, E>, fn: (error: E) => void): Result<T, E> {\n  if (!result.ok) fn(result.error);\n  return result;\n}\n\n/** Flatten a nested Result<Result<T, E>, E> into Result<T, E>. */\nexport function flatten<T, E>(result: Result<Result<T, E>, E>): Result<T, E> {\n  return result.ok ? result.value : result;\n}\n\n/** Map both Ok and Err variants in a single pass. */\nexport function mapBoth<T, U, E, F>(\n  result: Result<T, E>,\n  okFn: (value: T) => U,\n  errFn: (error: E) => F\n): Result<U, F> {\n  return result.ok ? ok(okFn(result.value)) : err(errFn(result.error));\n}\n\n/** Convert a nullable value to a Result, using `errorFn` to produce the error for null/undefined. */\nexport function fromNullable<T, E>(value: T | null | undefined, errorFn: () => E): Result<T, E> {\n  if (value === null || value === undefined) return err(errorFn());\n  return ok(value);\n}\n\n// ---------------------------------------------------------------------------\n// Extraction\n// ---------------------------------------------------------------------------\n\n/** Format an error for display, handling BrepError objects specially */\nfunction formatError(error: unknown): string {\n  if (\n    typeof error === 'object' &&\n    error !== null &&\n    'kind' in error &&\n    'code' in error &&\n    'message' in error\n  ) {\n    // BrepError-like object\n    const e = error as { kind: string; code: string; message: string };\n    return `[${e.kind}] ${e.code}: ${e.message}`;\n  }\n  return String(error);\n}\n\nexport function unwrap<T, E>(result: Result<T, E>): T {\n  if (result.ok) return result.value;\n  throw new Error(`Called unwrap() on an Err: ${formatError(result.error)}`);\n}\n\nexport function unwrapOr<T, E>(result: Result<T, E>, defaultValue: T): T {\n  if (result.ok) return result.value;\n  return defaultValue;\n}\n\nexport function unwrapOrElse<T, E>(result: Result<T, E>, fn: (error: E) => T): T {\n  if (result.ok) return result.value;\n  return fn(result.error);\n}\n\nexport function unwrapErr<T, E>(result: Result<T, E>): E {\n  if (!result.ok) return result.error;\n  throw new Error(`Called unwrapErr() on an Ok: ${String(result.value)}`);\n}\n\n// ---------------------------------------------------------------------------\n// Pattern matching\n// ---------------------------------------------------------------------------\n\nexport function match<T, E, U>(\n  result: Result<T, E>,\n  handlers: { ok: (value: T) => U; err: (error: E) => U }\n): U {\n  if (result.ok) return handlers.ok(result.value);\n  return handlers.err(result.error);\n}\n\n// ---------------------------------------------------------------------------\n// Collection\n// ---------------------------------------------------------------------------\n\n/**\n * Collects an array of Results into a Result of an array.\n * Short-circuits on the first Err.\n */\nexport function collect<T, E>(results: Result<T, E>[]): Result<T[], E> {\n  const values: T[] = [];\n  for (const result of results) {\n    if (!result.ok) return result;\n    values.push(result.value);\n  }\n  return ok(values);\n}\n\n// ---------------------------------------------------------------------------\n// Try-catch boundary\n// ---------------------------------------------------------------------------\n\n/**\n * Wraps a throwing function into a Result.\n * The mapError function converts the caught exception into the error type.\n */\nexport function tryCatch<T, E>(fn: () => T, mapError: (error: unknown) => E): Result<T, E> {\n  try {\n    return ok(fn());\n  } catch (e: unknown) {\n    return err(mapError(e));\n  }\n}\n\n/**\n * Wraps an async throwing function into a Result.\n * The mapError function converts the caught exception into the error type.\n */\nexport async function tryCatchAsync<T, E>(\n  fn: () => Promise<T>,\n  mapError: (error: unknown) => E\n): Promise<Result<T, E>> {\n  try {\n    return ok(await fn());\n  } catch (e: unknown) {\n    return err(mapError(e));\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Pipeline combinator\n// ---------------------------------------------------------------------------\n\n/** A chainable pipeline that short-circuits on the first Err. */\nexport interface ResultPipeline<T, E> {\n  /** Chain a Result-returning transform. Short-circuits on Err. */\n  then<U>(fn: (value: T) => Result<U, E>): ResultPipeline<U, E>;\n  /** Extract the final Result. */\n  readonly result: Result<T, E>;\n}\n\n/**\n * Create a chainable pipeline from a value or Result.\n *\n * ```ts\n * pipeline(shape)\n *   .then(s => filletShape(s, edges, 2))\n *   .then(s => shellShape(s, [topFace], 1))\n *   .result  // → Result<Shape3D>\n * ```\n */\nexport function pipeline<T, E = BrepError>(input: T | Result<T, E>): ResultPipeline<T, E> {\n  // Detect Result objects by checking the 'ok' discriminant is a boolean\n  function isResult(v: unknown): v is Result<T, E> {\n    return (\n      typeof v === 'object' &&\n      v !== null &&\n      'ok' in v &&\n      typeof (v as Record<string, unknown>)['ok'] === 'boolean'\n    );\n  }\n\n  const initial: Result<T, E> = isResult(input) ? input : ok(input);\n\n  function makePipeline<U>(current: Result<U, E>): ResultPipeline<U, E> {\n    return {\n      then<V>(fn: (value: U) => Result<V, E>): ResultPipeline<V, E> {\n        if (!current.ok) return makePipeline(current as Result<V, E>);\n        return makePipeline(fn(current.value));\n      },\n      get result(): Result<U, E> {\n        return current;\n      },\n    };\n  }\n\n  return makePipeline(initial);\n}\n"]}

package/dist/vendored/brepjs/core/shapeTypeCache.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Shape type cache — caches kernel shapeType() results on KernelShape objects.
+ *
+ * Eliminates redundant WASM boundary crossings when the same shape's type
+ * is queried multiple times (type guards, castShape, etc.).
+ *
+ * Shapes are immutable in brepjs — operations return new shapes — so
+ * cached types never go stale.
+ */
+import type { KernelShape, ShapeType } from '../kernel/types.js';
+import type { KernelAdapter } from '../kernel/interfaces/index.js';
+/**
+ * Get the cached type for a shape, or undefined if not cached.
+ */
+export declare function getCachedType(shape: KernelShape): ShapeType | undefined;
+/** Store a type for a shape. */
+export declare function setCachedType(shape: KernelShape, type: ShapeType): void;
+/**
+ * Check if a shape has a cached type.
+ */
+export declare function hasCachedType(shape: KernelShape): boolean;
+/**
+ * Get the type from cache, or query the kernel and cache the result.
+ * This is the primary hot-path function — replaces direct `kernel.shapeType()` calls.
+ */
+export declare function getOrQueryType(kernel: KernelAdapter, shape: KernelShape): ShapeType;
+//# sourceMappingURL=shapeTypeCache.d.ts.map

package/dist/vendored/brepjs/core/shapeTypeCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shapeTypeCache.d.ts","sourceRoot":"","sources":["../../../../src/vendored/brepjs/core/shapeTypeCache.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAKnE;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,CAEvE;AAED,gCAAgC;AAChC,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAEvE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAEzD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,GAAG,SAAS,CAMnF"}

package/dist/vendored/brepjs/core/shapeTypeCache.js

@@ -0,0 +1,40 @@
+/**
+ * Shape type cache — caches kernel shapeType() results on KernelShape objects.
+ *
+ * Eliminates redundant WASM boundary crossings when the same shape's type
+ * is queried multiple times (type guards, castShape, etc.).
+ *
+ * Shapes are immutable in brepjs — operations return new shapes — so
+ * cached types never go stale.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- KernelShape is typed as `any`; WeakMap requires object keys
+const cache = new WeakMap();
+/**
+ * Get the cached type for a shape, or undefined if not cached.
+ */
+export function getCachedType(shape) {
+    return cache.get(shape);
+}
+/** Store a type for a shape. */
+export function setCachedType(shape, type) {
+    cache.set(shape, type);
+}
+/**
+ * Check if a shape has a cached type.
+ */
+export function hasCachedType(shape) {
+    return cache.has(shape);
+}
+/**
+ * Get the type from cache, or query the kernel and cache the result.
+ * This is the primary hot-path function — replaces direct `kernel.shapeType()` calls.
+ */
+export function getOrQueryType(kernel, shape) {
+    const cached = cache.get(shape);
+    if (cached !== undefined)
+        return cached;
+    const type = kernel.shapeType(shape);
+    cache.set(shape, type);
+    return type;
+}
+//# sourceMappingURL=shapeTypeCache.js.map

package/dist/vendored/brepjs/core/shapeTypeCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shapeTypeCache.js","sourceRoot":"","sources":["../../../../src/vendored/brepjs/core/shapeTypeCache.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,6HAA6H;AAC7H,MAAM,KAAK,GAAG,IAAI,OAAO,EAAkB,CAAC;AAE5C;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAkB;IAC9C,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC;AAED,gCAAgC;AAChC,MAAM,UAAU,aAAa,CAAC,KAAkB,EAAE,IAAe;IAC/D,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAkB;IAC9C,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAqB,EAAE,KAAkB;IACtE,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACxC,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACrC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACvB,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["/**\n * Shape type cache — caches kernel shapeType() results on KernelShape objects.\n *\n * Eliminates redundant WASM boundary crossings when the same shape's type\n * is queried multiple times (type guards, castShape, etc.).\n *\n * Shapes are immutable in brepjs — operations return new shapes — so\n * cached types never go stale.\n */\n\nimport type { KernelShape, ShapeType } from '../kernel/types.js';\nimport type { KernelAdapter } from '../kernel/interfaces/index.js';\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any -- KernelShape is typed as `any`; WeakMap requires object keys\nconst cache = new WeakMap<any, ShapeType>();\n\n/**\n * Get the cached type for a shape, or undefined if not cached.\n */\nexport function getCachedType(shape: KernelShape): ShapeType | undefined {\n  return cache.get(shape);\n}\n\n/** Store a type for a shape. */\nexport function setCachedType(shape: KernelShape, type: ShapeType): void {\n  cache.set(shape, type);\n}\n\n/**\n * Check if a shape has a cached type.\n */\nexport function hasCachedType(shape: KernelShape): boolean {\n  return cache.has(shape);\n}\n\n/**\n * Get the type from cache, or query the kernel and cache the result.\n * This is the primary hot-path function — replaces direct `kernel.shapeType()` calls.\n */\nexport function getOrQueryType(kernel: KernelAdapter, shape: KernelShape): ShapeType {\n  const cached = cache.get(shape);\n  if (cached !== undefined) return cached;\n  const type = kernel.shapeType(shape);\n  cache.set(shape, type);\n  return type;\n}\n"]}