@faicad/faijs 0.13.0

package/dist/vendored/brepjs/topology/api.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Public API functions — short names for transforms, booleans, modifiers, and utilities.
+ *
+ * These functions provide the primary public API with short names, Shapeable<T> support,
+ * and options objects. They delegate to implementations in shapeFns.ts, booleanFns.ts, etc.
+ */
+import type { Vec3, MatrixInput } from '../core/types.js';
+import type { Result } from '../core/result.js';
+import type { AnyShape, Dimension, Edge, Face, Shape3D, Shell, Solid } from '../core/shapeTypes.js';
+import type { ValidSolid } from '../core/validityTypes.js';
+import type { Shapeable, FinderFn, FilletRadius, ChamferDistance, DraftOptions } from './apiTypes.js';
+import type { ShapeFinder } from '../query/finderFns.js';
+import * as transforms from './shapeFns.js';
+import * as booleans from './booleanFns.js';
+import * as meshing from './meshFns.js';
+import type { PlaneInput } from '../core/planeTypes.js';
+/** Translate a shape by a vector. Returns a new shape. */
+export declare function translate<T extends AnyShape<Dimension>>(shape: Shapeable<T>, v: Vec3): T;
+/** Options for {@link rotate}. */
+export interface RotateOptions {
+    /** Pivot point. Default: [0, 0, 0]. */
+    at?: Vec3;
+    /** Rotation axis. Default: [0, 0, 1] (Z). */
+    axis?: Vec3;
+}
+/** Rotate a shape around an axis. Angle is in degrees. Returns a new shape. */
+export declare function rotate<T extends AnyShape<Dimension>>(shape: Shapeable<T>, angle: number, options?: RotateOptions): T;
+/** Options for {@link mirror}. */
+export interface MirrorOptions {
+    /** Plane normal. Default: [1, 0, 0]. */
+    normal?: Vec3;
+    /** Plane origin. Default: [0, 0, 0]. */
+    at?: Vec3;
+}
+/** Mirror a shape through a plane. Returns a new shape. */
+export declare function mirror<T extends AnyShape<Dimension>>(shape: Shapeable<T>, options?: MirrorOptions): T;
+/** Options for {@link scale}. */
+export interface ScaleOptions {
+    /** Center of scaling. Default: [0, 0, 0]. */
+    center?: Vec3;
+}
+/** Scale a shape uniformly. Returns a new shape. */
+export declare function scale<T extends AnyShape<Dimension>>(shape: Shapeable<T>, factor: number, options?: ScaleOptions): T;
+/** Clone a shape (deep copy). */
+export declare function clone<T extends AnyShape<Dimension>>(shape: Shapeable<T>): Result<T>;
+/**
+ * Apply a 4x4 affine transformation matrix to a shape.
+ * Equivalent to OpenSCAD's `multmatrix`.
+ *
+ * Accepts either a raw `Matrix4x4` (4 rows of 4 numbers, row-major) or a structured
+ * `MatrixTransform` with explicit `linear` and `translation` fields.
+ */
+export declare function applyMatrix<T extends AnyShape<Dimension>>(shape: Shapeable<T>, matrix: MatrixInput): Result<T>;
+export type { TransformOp, ComposedTransform } from './shapeFns.js';
+export { composeTransforms } from './shapeFns.js';
+/**
+ * Clone a shape and apply a pre-composed transform in a single kernel operation.
+ * Much faster than separate clone() + translate() + rotate() calls for batch patterns.
+ */
+export declare function transformCopy<T extends AnyShape<Dimension>>(shape: Shapeable<T>, composed: transforms.ComposedTransform): T;
+/**
+ * Placement-only rigid move (translate / rotate) via the kernel's cheap location
+ * re-tag — O(1) on occt-wasm ≥3.6.0, falling back to a copy elsewhere. Same
+ * face-metadata guarantee as `translate`, at location-swap cost. Ideal for
+ * placing one cached cell at N positions without paying for N deep copies.
+ */
+export declare function locate<T extends AnyShape<Dimension>>(shape: Shapeable<T>, placement: transforms.TransformOp | readonly transforms.TransformOp[]): T;
+/** Fuse two 3D shapes (boolean union). */
+export declare function fuse<T extends Shape3D>(a: Shapeable<T>, b: Shapeable<Shape3D>, options?: booleans.BooleanOptions): Result<T>;
+/** Cut a tool from a base shape (boolean subtraction). */
+export declare function cut<T extends Shape3D>(base: Shapeable<T>, tool: Shapeable<Shape3D>, options?: booleans.BooleanOptions): Result<T>;
+/** Fuse many 3D shapes (boolean union) in a single operation. */
+export declare function fuseAll<T extends Shape3D>(shapes: Shapeable<T>[], options?: booleans.BooleanOptions): Result<T>;
+/** Cut many tool shapes from a base shape (boolean subtraction) in a single operation. */
+export declare function cutAll<T extends Shape3D>(base: Shapeable<T>, tools: Shapeable<Shape3D>[], options?: booleans.BooleanOptions): Result<T>;
+/** Compute the intersection of two shapes (boolean common). */
+export declare function intersect<T extends Shape3D>(a: Shapeable<T>, b: Shapeable<Shape3D>, options?: booleans.BooleanOptions): Result<T>;
+/** Section (cross-section) a shape with a plane. */
+export declare function section(shape: Shapeable<AnyShape<Dimension>>, plane: PlaneInput, options?: {
+    approximation?: boolean;
+    planeSize?: number;
+}): Result<AnyShape<Dimension>>;
+/** Section a shape with a plane and return a filled Face. */
+export declare function sectionToFace(shape: Shapeable<AnyShape<Dimension>>, plane: PlaneInput, options?: {
+    approximation?: boolean;
+    planeSize?: number;
+}): Result<Face>;
+/** Split a shape with tool shapes. */
+export declare function split(shape: Shapeable<AnyShape<Dimension>>, tools: AnyShape<Dimension>[]): Result<AnyShape<Dimension>>;
+/** Slice a shape with multiple planes. */
+export declare function slice(shape: Shapeable<AnyShape<Dimension>>, planes: PlaneInput[], options?: {
+    approximation?: boolean;
+    planeSize?: number;
+}): Result<AnyShape<Dimension>[]>;
+/** Apply a fillet to all edges of a valid solid. */
+export declare function fillet<T extends ValidSolid>(shape: Shapeable<T>, radius: FilletRadius): Result<T>;
+/** Apply a fillet to selected edges of a valid solid. */
+export declare function fillet<T extends ValidSolid>(shape: Shapeable<T>, edges: Edge[] | FinderFn<Edge> | ShapeFinder<Edge>, radius: FilletRadius): Result<T>;
+/** Apply a chamfer to all edges of a valid solid. */
+export declare function chamfer<T extends ValidSolid>(shape: Shapeable<T>, distance: ChamferDistance): Result<T>;
+/** Apply a chamfer to selected edges of a valid solid. */
+export declare function chamfer<T extends ValidSolid>(shape: Shapeable<T>, edges: Edge[] | FinderFn<Edge> | ShapeFinder<Edge>, distance: ChamferDistance): Result<T>;
+/** Create a hollow shell by removing faces and offsetting remaining walls. */
+export declare function shell<T extends ValidSolid>(shape: Shapeable<T>, faces: Face[] | FinderFn<Face> | ShapeFinder<Face>, thickness: number, options?: {
+    tolerance?: number;
+}): Result<T>;
+/** Offset all faces of a valid solid by a given distance. */
+export declare function offset<T extends ValidSolid>(shape: Shapeable<T>, distance: number, options?: {
+    tolerance?: number;
+}): Result<T>;
+/** Thicken a surface (face or shell) into a solid. */
+export declare function thicken(shape: Shapeable<Face<Dimension> | Shell>, thickness: number): Result<Solid>;
+/**
+ * Draft (taper) selected faces of a 3D shape.
+ *
+ * Tilts faces by a specified angle relative to a pull direction,
+ * pivoting about a neutral plane. Essential for manufacturing workflows
+ * (injection molding, casting) where parts must release from a mold.
+ */
+export declare function draft<T extends ValidSolid>(shape: Shapeable<T>, faces: Face[] | FinderFn<Face> | ShapeFinder<Face>, options: DraftOptions): Result<T>;
+/** Heal a shape using the appropriate fixer. */
+export declare function heal<T extends AnyShape<Dimension>>(shape: Shapeable<T>): Result<T>;
+/** Simplify a shape by merging same-domain faces/edges. */
+export declare function simplify<T extends AnyShape<Dimension>>(shape: Shapeable<T>): Result<T>;
+/** Mesh a shape for rendering. */
+export declare function mesh(shape: Shapeable<AnyShape<Dimension>>, options?: meshing.MeshOptions & {
+    skipNormals?: boolean;
+    includeUVs?: boolean;
+    cache?: boolean;
+}): meshing.ShapeMesh;
+/** Mesh the edges of a shape for wireframe rendering. */
+export declare function meshEdges(shape: Shapeable<AnyShape<Dimension>>, options?: meshing.MeshOptions & {
+    cache?: boolean;
+}): meshing.EdgeMesh;
+/** Get a summary description of a shape. */
+export declare function describe(shape: Shapeable<AnyShape<Dimension>>): transforms.ShapeDescription;
+/** Serialize a shape to BREP format. */
+export declare function toBREP(shape: Shapeable<AnyShape<Dimension>>): Result<string>;
+/** Deserialize a shape from BREP format. */
+export declare function fromBREP(data: string): Result<AnyShape<Dimension>>;
+/** Check if a shape is valid. */
+export declare function isValid(shape: Shapeable<AnyShape<Dimension>>): boolean;
+/** Check if a shape is empty (null). */
+export declare function isEmpty(shape: Shapeable<AnyShape<Dimension>>): boolean;
+//# sourceMappingURL=api.d.ts.map

package/dist/vendored/brepjs/topology/api.d.ts.map

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

package/dist/vendored/brepjs/topology/api.js

@@ -0,0 +1,282 @@
+/**
+ * Public API functions — short names for transforms, booleans, modifiers, and utilities.
+ *
+ * These functions provide the primary public API with short names, Shapeable<T> support,
+ * and options objects. They delegate to implementations in shapeFns.ts, booleanFns.ts, etc.
+ */
+import { resolve } from './apiTypes.js';
+import * as transforms from './shapeFns.js';
+import * as booleans from './booleanFns.js';
+import * as modifiers from './modifierFns.js';
+import * as angles from './chamferAngleFns.js';
+import * as healing from './healingFns.js';
+import * as meshing from './meshFns.js';
+import * as casting from './cast.js';
+import { edgeFinder, faceFinder } from '../query/finderFns.js';
+// ---------------------------------------------------------------------------
+// Transforms — accept Shapeable<T>, use options objects
+// ---------------------------------------------------------------------------
+/** Translate a shape by a vector. Returns a new shape. */
+export function translate(shape, v) {
+    return transforms.translate(resolve(shape), v);
+}
+// An array passed where an options object is expected resolves option keys to
+// `Array.prototype` methods — notably `at`, which becomes a function instead of
+// `undefined` and corrupts a plane/pivot origin into NaN, silently producing
+// degenerate geometry rather than an error. Reject it loudly. See issue #1881.
+function assertNotPositionalOptions(options, fn) {
+    if (Array.isArray(options)) {
+        throw new Error(`${fn}() expects an options object, e.g. ${fn}(shape, { ... }), not an array of coordinates.`);
+    }
+}
+/** Rotate a shape around an axis. Angle is in degrees. Returns a new shape. */
+export function rotate(shape, angle, options) {
+    assertNotPositionalOptions(options, 'rotate');
+    const pivotPoint = options?.at;
+    return transforms.rotate(resolve(shape), angle, pivotPoint, options?.axis);
+}
+/** Mirror a shape through a plane. Returns a new shape. */
+export function mirror(shape, options) {
+    assertNotPositionalOptions(options, 'mirror');
+    const planeOrigin = options?.at;
+    return transforms.mirror(resolve(shape), options?.normal ?? [1, 0, 0], planeOrigin);
+}
+/** Scale a shape uniformly. Returns a new shape. */
+export function scale(shape, factor, options) {
+    return transforms.scale(resolve(shape), factor, options?.center);
+}
+/** Clone a shape (deep copy). */
+export function clone(shape) {
+    return transforms.clone(resolve(shape));
+}
+/**
+ * Apply a 4x4 affine transformation matrix to a shape.
+ * Equivalent to OpenSCAD's `multmatrix`.
+ *
+ * Accepts either a raw `Matrix4x4` (4 rows of 4 numbers, row-major) or a structured
+ * `MatrixTransform` with explicit `linear` and `translation` fields.
+ */
+export function applyMatrix(shape, matrix) {
+    return transforms.applyMatrix(resolve(shape), matrix);
+}
+export { composeTransforms } from './shapeFns.js';
+/**
+ * Clone a shape and apply a pre-composed transform in a single kernel operation.
+ * Much faster than separate clone() + translate() + rotate() calls for batch patterns.
+ */
+export function transformCopy(shape, composed) {
+    return transforms.transformCopy(resolve(shape), composed);
+}
+/**
+ * Placement-only rigid move (translate / rotate) via the kernel's cheap location
+ * re-tag — O(1) on occt-wasm ≥3.6.0, falling back to a copy elsewhere. Same
+ * face-metadata guarantee as `translate`, at location-swap cost. Ideal for
+ * placing one cached cell at N positions without paying for N deep copies.
+ */
+export function locate(shape, placement) {
+    return transforms.locate(resolve(shape), placement);
+}
+// ---------------------------------------------------------------------------
+// Booleans — accept Shapeable, preserve first operand type T
+// ---------------------------------------------------------------------------
+/** Fuse two 3D shapes (boolean union). */
+export function fuse(a, b, options) {
+    return booleans.fuse(resolve(a), resolve(b), {
+        ...options,
+        unsafe: true,
+    });
+}
+/** Cut a tool from a base shape (boolean subtraction). */
+export function cut(base, tool, options) {
+    return booleans.cut(resolve(base), resolve(tool), {
+        ...options,
+        unsafe: true,
+    });
+}
+/** Fuse many 3D shapes (boolean union) in a single operation. */
+export function fuseAll(shapes, options) {
+    return booleans.fuseAll(shapes.map((s) => resolve(s)), { ...options, unsafe: true });
+}
+/** Cut many tool shapes from a base shape (boolean subtraction) in a single operation. */
+export function cutAll(base, tools, options) {
+    return booleans.cutAll(resolve(base), tools.map((s) => resolve(s)), { ...options, unsafe: true });
+}
+/** Compute the intersection of two shapes (boolean common). */
+export function intersect(a, b, options) {
+    return booleans.intersect(resolve(a), resolve(b), {
+        ...options,
+        unsafe: true,
+    });
+}
+/** Section (cross-section) a shape with a plane. */
+export function section(shape, plane, options) {
+    return booleans.section(resolve(shape), plane, options);
+}
+/** Section a shape with a plane and return a filled Face. */
+export function sectionToFace(shape, plane, options) {
+    return booleans.sectionToFace(resolve(shape), plane, options);
+}
+/** Split a shape with tool shapes. */
+export function split(shape, tools) {
+    return booleans.split(resolve(shape), tools);
+}
+/** Slice a shape with multiple planes. */
+export function slice(shape, planes, options) {
+    return booleans.slice(resolve(shape), planes, options);
+}
+// ---------------------------------------------------------------------------
+// Modifiers — accept Shapeable, FinderFn, new radius/distance types
+// ---------------------------------------------------------------------------
+/**
+ * Resolve a FinderFn callback or ShapeFinder into an array of elements.
+ * If the argument is already an array, return it directly.
+ */
+function resolveEdges(edgesOrFn, shape) {
+    if (edgesOrFn === undefined)
+        return undefined;
+    if (Array.isArray(edgesOrFn))
+        return edgesOrFn;
+    // If it's a ShapeFinder, use it directly
+    if (typeof edgesOrFn === 'object' && 'findAll' in edgesOrFn) {
+        return edgesOrFn.findAll(shape);
+    }
+    // It's a FinderFn — apply it to edgeFinder() and execute
+    const finder = edgesOrFn(edgeFinder());
+    return finder.findAll(shape);
+}
+function resolveFaces(facesOrFn, shape) {
+    if (Array.isArray(facesOrFn))
+        return facesOrFn;
+    // If it's a ShapeFinder, use it directly
+    if (typeof facesOrFn === 'object' && 'findAll' in facesOrFn) {
+        return facesOrFn.findAll(shape);
+    }
+    const finder = facesOrFn(faceFinder());
+    return finder.findAll(shape);
+}
+function normalizeChamferDistance(distance) {
+    if (typeof distance === 'object' && !Array.isArray(distance) && typeof distance !== 'function') {
+        // { distance, angle } mode
+        return { mode: 'distAngle', distance: distance.distance, angle: distance.angle };
+    }
+    if (typeof distance === 'function') {
+        // Per-edge callback — check if any returns { distance, angle }
+        // Wrap callback to extract standard values
+        const wrappedFn = (edge) => {
+            const val = distance(edge);
+            if (val === null)
+                return null;
+            if (typeof val === 'object' && !Array.isArray(val)) {
+                // { distance, angle } — not supported in per-edge callback for standard chamfer
+                // Fall back to distance-only
+                return val.distance;
+            }
+            return val;
+        };
+        return { mode: 'standard', distance: wrappedFn };
+    }
+    return { mode: 'standard', distance };
+}
+export function fillet(shape, edgesOrRadius, maybeRadius) {
+    const s = resolve(shape);
+    let edges;
+    let radius;
+    if (maybeRadius !== undefined) {
+        // 3-arg form: shape, edges, radius
+        edges = resolveEdges(edgesOrRadius, s);
+        radius = maybeRadius;
+    }
+    else {
+        // 2-arg form: shape, radius (fillet all edges)
+        edges = undefined;
+        radius = edgesOrRadius;
+    }
+    return modifiers.fillet(s, edges, radius);
+}
+export function chamfer(shape, edgesOrDistance, maybeDistance) {
+    const s = resolve(shape);
+    let edges;
+    let distance;
+    if (maybeDistance !== undefined) {
+        edges = resolveEdges(edgesOrDistance, s);
+        distance = maybeDistance;
+    }
+    else {
+        edges = undefined;
+        distance = edgesOrDistance;
+    }
+    const normalized = normalizeChamferDistance(distance);
+    if (normalized.mode === 'distAngle') {
+        // Use chamferDistAngle for distance-angle mode
+        const selectedEdges = edges ?? transforms.getEdges(s);
+        return angles.chamferDistAngle(s, [...selectedEdges], normalized.distance, normalized.angle);
+    }
+    return modifiers.chamfer(s, edges, normalized.distance);
+}
+/** Create a hollow shell by removing faces and offsetting remaining walls. */
+export function shell(shape, faces, thickness, options) {
+    const s = resolve(shape);
+    const resolvedFaces = resolveFaces(faces, s);
+    return modifiers.shell(s, resolvedFaces, thickness, options?.tolerance);
+}
+/** Offset all faces of a valid solid by a given distance. */
+export function offset(shape, distance, options) {
+    return modifiers.offset(resolve(shape), distance, options?.tolerance);
+}
+/** Thicken a surface (face or shell) into a solid. */
+export function thicken(shape, thickness) {
+    // Thicken is 3D-only — narrow from Face<Dimension> to Face<'3D'>
+    return modifiers.thicken(resolve(shape), thickness);
+}
+/**
+ * Draft (taper) selected faces of a 3D shape.
+ *
+ * Tilts faces by a specified angle relative to a pull direction,
+ * pivoting about a neutral plane. Essential for manufacturing workflows
+ * (injection molding, casting) where parts must release from a mold.
+ */
+export function draft(shape, faces, options) {
+    const s = resolve(shape);
+    const resolvedFaces = resolveFaces(faces, s);
+    return modifiers.draft(s, resolvedFaces, options.pullDirection, options.neutralPlane, options.angle);
+}
+// ---------------------------------------------------------------------------
+// Utilities — clean names
+// ---------------------------------------------------------------------------
+/** Heal a shape using the appropriate fixer. */
+export function heal(shape) {
+    return healing.heal(resolve(shape));
+}
+/** Simplify a shape by merging same-domain faces/edges. */
+export function simplify(shape) {
+    return transforms.simplify(resolve(shape));
+}
+/** Mesh a shape for rendering. */
+export function mesh(shape, options) {
+    return meshing.mesh(resolve(shape), options);
+}
+/** Mesh the edges of a shape for wireframe rendering. */
+export function meshEdges(shape, options) {
+    return meshing.meshEdges(resolve(shape), options);
+}
+/** Get a summary description of a shape. */
+export function describe(shape) {
+    return transforms.describe(resolve(shape));
+}
+/** Serialize a shape to BREP format. */
+export function toBREP(shape) {
+    return transforms.toBREP(resolve(shape));
+}
+/** Deserialize a shape from BREP format. */
+export function fromBREP(data) {
+    return casting.fromBREP(data);
+}
+/** Check if a shape is valid. */
+export function isValid(shape) {
+    return healing.isValid(resolve(shape));
+}
+/** Check if a shape is empty (null). */
+export function isEmpty(shape) {
+    return transforms.isEmpty(resolve(shape));
+}
+//# sourceMappingURL=api.js.map

package/dist/vendored/brepjs/topology/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../../src/vendored/brepjs/topology/api.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Public API functions — short names for transforms, booleans, modifiers, and utilities.\n *\n * These functions provide the primary public API with short names, Shapeable<T> support,\n * and options objects. They delegate to implementations in shapeFns.ts, booleanFns.ts, etc.\n */\n\nimport type { Vec3, MatrixInput } from '../core/types.js';\nimport type { Result } from '../core/result.js';\nimport type { AnyShape, Dimension, Edge, Face, Shape3D, Shell, Solid } from '../core/shapeTypes.js';\nimport type { ValidSolid } from '../core/validityTypes.js';\nimport type {\n  Shapeable,\n  FinderFn,\n  FilletRadius,\n  ChamferDistance,\n  DraftOptions,\n} from './apiTypes.js';\nimport { resolve } from './apiTypes.js';\nimport type { ShapeFinder } from '../query/finderFns.js';\nimport * as transforms from './shapeFns.js';\nimport * as booleans from './booleanFns.js';\nimport * as modifiers from './modifierFns.js';\nimport * as angles from './chamferAngleFns.js';\nimport * as healing from './healingFns.js';\nimport * as meshing from './meshFns.js';\nimport * as casting from './cast.js';\nimport { edgeFinder, faceFinder } from '../query/finderFns.js';\nimport type { PlaneInput } from '../core/planeTypes.js';\n\n// ---------------------------------------------------------------------------\n// Transforms — accept Shapeable<T>, use options objects\n// ---------------------------------------------------------------------------\n\n/** Translate a shape by a vector. Returns a new shape. */\nexport function translate<T extends AnyShape<Dimension>>(shape: Shapeable<T>, v: Vec3): T {\n  return transforms.translate(resolve(shape), v);\n}\n\n// An array passed where an options object is expected resolves option keys to\n// `Array.prototype` methods — notably `at`, which becomes a function instead of\n// `undefined` and corrupts a plane/pivot origin into NaN, silently producing\n// degenerate geometry rather than an error. Reject it loudly. See issue #1881.\nfunction assertNotPositionalOptions(options: unknown, fn: string): void {\n  if (Array.isArray(options)) {\n    throw new Error(\n      `${fn}() expects an options object, e.g. ${fn}(shape, { ... }), not an array of coordinates.`\n    );\n  }\n}\n\n/** Options for {@link rotate}. */\nexport interface RotateOptions {\n  /** Pivot point. Default: [0, 0, 0]. */\n  at?: Vec3;\n  /** Rotation axis. Default: [0, 0, 1] (Z). */\n  axis?: Vec3;\n}\n\n/** Rotate a shape around an axis. Angle is in degrees. Returns a new shape. */\nexport function rotate<T extends AnyShape<Dimension>>(\n  shape: Shapeable<T>,\n  angle: number,\n  options?: RotateOptions\n): T {\n  assertNotPositionalOptions(options, 'rotate');\n  const pivotPoint = options?.at;\n  return transforms.rotate(resolve(shape), angle, pivotPoint, options?.axis);\n}\n\n/** Options for {@link mirror}. */\nexport interface MirrorOptions {\n  /** Plane normal. Default: [1, 0, 0]. */\n  normal?: Vec3;\n  /** Plane origin. Default: [0, 0, 0]. */\n  at?: Vec3;\n}\n\n/** Mirror a shape through a plane. Returns a new shape. */\nexport function mirror<T extends AnyShape<Dimension>>(\n  shape: Shapeable<T>,\n  options?: MirrorOptions\n): T {\n  assertNotPositionalOptions(options, 'mirror');\n  const planeOrigin = options?.at;\n  return transforms.mirror(resolve(shape), options?.normal ?? [1, 0, 0], planeOrigin);\n}\n\n/** Options for {@link scale}. */\nexport interface ScaleOptions {\n  /** Center of scaling. Default: [0, 0, 0]. */\n  center?: Vec3;\n}\n\n/** Scale a shape uniformly. Returns a new shape. */\nexport function scale<T extends AnyShape<Dimension>>(\n  shape: Shapeable<T>,\n  factor: number,\n  options?: ScaleOptions\n): T {\n  return transforms.scale(resolve(shape), factor, options?.center);\n}\n\n/** Clone a shape (deep copy). */\nexport function clone<T extends AnyShape<Dimension>>(shape: Shapeable<T>): Result<T> {\n  return transforms.clone(resolve(shape));\n}\n\n/**\n * Apply a 4x4 affine transformation matrix to a shape.\n * Equivalent to OpenSCAD's `multmatrix`.\n *\n * Accepts either a raw `Matrix4x4` (4 rows of 4 numbers, row-major) or a structured\n * `MatrixTransform` with explicit `linear` and `translation` fields.\n */\nexport function applyMatrix<T extends AnyShape<Dimension>>(\n  shape: Shapeable<T>,\n  matrix: MatrixInput\n): Result<T> {\n  return transforms.applyMatrix(resolve(shape), matrix);\n}\n\nexport type { TransformOp, ComposedTransform } from './shapeFns.js';\nexport { composeTransforms } from './shapeFns.js';\n\n/**\n * Clone a shape and apply a pre-composed transform in a single kernel operation.\n * Much faster than separate clone() + translate() + rotate() calls for batch patterns.\n */\nexport function transformCopy<T extends AnyShape<Dimension>>(\n  shape: Shapeable<T>,\n  composed: transforms.ComposedTransform\n): T {\n  return transforms.transformCopy(resolve(shape), composed);\n}\n\n/**\n * Placement-only rigid move (translate / rotate) via the kernel's cheap location\n * re-tag — O(1) on occt-wasm ≥3.6.0, falling back to a copy elsewhere. Same\n * face-metadata guarantee as `translate`, at location-swap cost. Ideal for\n * placing one cached cell at N positions without paying for N deep copies.\n */\nexport function locate<T extends AnyShape<Dimension>>(\n  shape: Shapeable<T>,\n  placement: transforms.TransformOp | readonly transforms.TransformOp[]\n): T {\n  return transforms.locate(resolve(shape), placement);\n}\n\n// ---------------------------------------------------------------------------\n// Booleans — accept Shapeable, preserve first operand type T\n// ---------------------------------------------------------------------------\n\n/** Fuse two 3D shapes (boolean union). */\nexport function fuse<T extends Shape3D>(\n  a: Shapeable<T>,\n  b: Shapeable<Shape3D>,\n  options?: booleans.BooleanOptions\n): Result<T> {\n  return booleans.fuse(resolve(a), resolve(b), {\n    ...options,\n    unsafe: true,\n  }) as Result<T>;\n}\n\n/** Cut a tool from a base shape (boolean subtraction). */\nexport function cut<T extends Shape3D>(\n  base: Shapeable<T>,\n  tool: Shapeable<Shape3D>,\n  options?: booleans.BooleanOptions\n): Result<T> {\n  return booleans.cut(resolve(base), resolve(tool), {\n    ...options,\n    unsafe: true,\n  }) as Result<T>;\n}\n\n/** Fuse many 3D shapes (boolean union) in a single operation. */\nexport function fuseAll<T extends Shape3D>(\n  shapes: Shapeable<T>[],\n  options?: booleans.BooleanOptions\n): Result<T> {\n  return booleans.fuseAll(\n    shapes.map((s) => resolve(s)),\n    { ...options, unsafe: true }\n  ) as Result<T>;\n}\n\n/** Cut many tool shapes from a base shape (boolean subtraction) in a single operation. */\nexport function cutAll<T extends Shape3D>(\n  base: Shapeable<T>,\n  tools: Shapeable<Shape3D>[],\n  options?: booleans.BooleanOptions\n): Result<T> {\n  return booleans.cutAll(\n    resolve(base),\n    tools.map((s) => resolve(s)),\n    { ...options, unsafe: true }\n  ) as Result<T>;\n}\n\n/** Compute the intersection of two shapes (boolean common). */\nexport function intersect<T extends Shape3D>(\n  a: Shapeable<T>,\n  b: Shapeable<Shape3D>,\n  options?: booleans.BooleanOptions\n): Result<T> {\n  return booleans.intersect(resolve(a), resolve(b), {\n    ...options,\n    unsafe: true,\n  }) as Result<T>;\n}\n\n/** Section (cross-section) a shape with a plane. */\nexport function section(\n  shape: Shapeable<AnyShape<Dimension>>,\n  plane: PlaneInput,\n  options?: { approximation?: boolean; planeSize?: number }\n): Result<AnyShape<Dimension>> {\n  return booleans.section(resolve(shape), plane, options);\n}\n\n/** Section a shape with a plane and return a filled Face. */\nexport function sectionToFace(\n  shape: Shapeable<AnyShape<Dimension>>,\n  plane: PlaneInput,\n  options?: { approximation?: boolean; planeSize?: number }\n): Result<Face> {\n  return booleans.sectionToFace(resolve(shape), plane, options);\n}\n\n/** Split a shape with tool shapes. */\nexport function split(\n  shape: Shapeable<AnyShape<Dimension>>,\n  tools: AnyShape<Dimension>[]\n): Result<AnyShape<Dimension>> {\n  return booleans.split(resolve(shape), tools);\n}\n\n/** Slice a shape with multiple planes. */\nexport function slice(\n  shape: Shapeable<AnyShape<Dimension>>,\n  planes: PlaneInput[],\n  options?: { approximation?: boolean; planeSize?: number }\n): Result<AnyShape<Dimension>[]> {\n  return booleans.slice(resolve(shape), planes, options);\n}\n\n// ---------------------------------------------------------------------------\n// Modifiers — accept Shapeable, FinderFn, new radius/distance types\n// ---------------------------------------------------------------------------\n\n/**\n * Resolve a FinderFn callback or ShapeFinder into an array of elements.\n * If the argument is already an array, return it directly.\n */\nfunction resolveEdges(\n  edgesOrFn: Edge[] | FinderFn<Edge> | ShapeFinder<Edge> | undefined,\n  shape: Shape3D\n): ReadonlyArray<Edge> | undefined {\n  if (edgesOrFn === undefined) return undefined;\n  if (Array.isArray(edgesOrFn)) return edgesOrFn;\n\n  // If it's a ShapeFinder, use it directly\n  if (typeof edgesOrFn === 'object' && 'findAll' in edgesOrFn) {\n    return edgesOrFn.findAll(shape);\n  }\n\n  // It's a FinderFn — apply it to edgeFinder() and execute\n  const finder = edgesOrFn(edgeFinder());\n  return finder.findAll(shape);\n}\n\nfunction resolveFaces(\n  facesOrFn: Face[] | FinderFn<Face> | ShapeFinder<Face>,\n  shape: Shape3D\n): ReadonlyArray<Face> {\n  if (Array.isArray(facesOrFn)) return facesOrFn;\n\n  // If it's a ShapeFinder, use it directly\n  if (typeof facesOrFn === 'object' && 'findAll' in facesOrFn) {\n    return facesOrFn.findAll(shape);\n  }\n\n  const finder = facesOrFn(faceFinder());\n  return finder.findAll(shape);\n}\n\n/**\n * Normalize a ChamferDistance, handling the {distance, angle} case.\n * Returns either a kernel-compatible distance or signals distance-angle mode.\n */\ntype NormalizedChamfer =\n  | {\n      mode: 'standard';\n      distance: number | [number, number] | ((edge: Edge) => number | [number, number] | null);\n    }\n  | { mode: 'distAngle'; distance: number; angle: number };\n\nfunction normalizeChamferDistance(distance: ChamferDistance): NormalizedChamfer {\n  if (typeof distance === 'object' && !Array.isArray(distance) && typeof distance !== 'function') {\n    // { distance, angle } mode\n    return { mode: 'distAngle', distance: distance.distance, angle: distance.angle };\n  }\n  if (typeof distance === 'function') {\n    // Per-edge callback — check if any returns { distance, angle }\n    // Wrap callback to extract standard values\n    const wrappedFn = (edge: Edge) => {\n      const val = distance(edge);\n      if (val === null) return null;\n      if (typeof val === 'object' && !Array.isArray(val)) {\n        // { distance, angle } — not supported in per-edge callback for standard chamfer\n        // Fall back to distance-only\n        return val.distance;\n      }\n      return val;\n    };\n    return { mode: 'standard', distance: wrappedFn };\n  }\n  return { mode: 'standard', distance };\n}\n\n// Overloads: 2-arg (all edges) vs 3-arg (selected edges)\n\n/** Apply a fillet to all edges of a valid solid. */\nexport function fillet<T extends ValidSolid>(shape: Shapeable<T>, radius: FilletRadius): Result<T>;\n/** Apply a fillet to selected edges of a valid solid. */\nexport function fillet<T extends ValidSolid>(\n  shape: Shapeable<T>,\n  edges: Edge[] | FinderFn<Edge> | ShapeFinder<Edge>,\n  radius: FilletRadius\n): Result<T>;\nexport function fillet<T extends ValidSolid>(\n  shape: Shapeable<T>,\n  edgesOrRadius: Edge[] | FinderFn<Edge> | ShapeFinder<Edge> | FilletRadius,\n  maybeRadius?: FilletRadius\n): Result<T> {\n  const s = resolve(shape);\n  let edges: ReadonlyArray<Edge> | undefined;\n  let radius: FilletRadius;\n\n  if (maybeRadius !== undefined) {\n    // 3-arg form: shape, edges, radius\n    edges = resolveEdges(edgesOrRadius as Edge[] | FinderFn<Edge> | ShapeFinder<Edge>, s);\n    radius = maybeRadius;\n  } else {\n    // 2-arg form: shape, radius (fillet all edges)\n    edges = undefined;\n    radius = edgesOrRadius as FilletRadius;\n  }\n\n  return modifiers.fillet(s, edges, radius) as Result<T>;\n}\n\n/** Apply a chamfer to all edges of a valid solid. */\nexport function chamfer<T extends ValidSolid>(\n  shape: Shapeable<T>,\n  distance: ChamferDistance\n): Result<T>;\n/** Apply a chamfer to selected edges of a valid solid. */\nexport function chamfer<T extends ValidSolid>(\n  shape: Shapeable<T>,\n  edges: Edge[] | FinderFn<Edge> | ShapeFinder<Edge>,\n  distance: ChamferDistance\n): Result<T>;\nexport function chamfer<T extends ValidSolid>(\n  shape: Shapeable<T>,\n  edgesOrDistance: Edge[] | FinderFn<Edge> | ShapeFinder<Edge> | ChamferDistance,\n  maybeDistance?: ChamferDistance\n): Result<T> {\n  const s = resolve(shape);\n  let edges: ReadonlyArray<Edge> | undefined;\n  let distance: ChamferDistance;\n\n  if (maybeDistance !== undefined) {\n    edges = resolveEdges(edgesOrDistance as Edge[] | FinderFn<Edge> | ShapeFinder<Edge>, s);\n    distance = maybeDistance;\n  } else {\n    edges = undefined;\n    distance = edgesOrDistance as ChamferDistance;\n  }\n\n  const normalized = normalizeChamferDistance(distance);\n  if (normalized.mode === 'distAngle') {\n    // Use chamferDistAngle for distance-angle mode\n    const selectedEdges = edges ?? transforms.getEdges(s);\n    return angles.chamferDistAngle(\n      s,\n      [...selectedEdges],\n      normalized.distance,\n      normalized.angle\n    ) as Result<T>;\n  }\n\n  return modifiers.chamfer(s, edges, normalized.distance) as Result<T>;\n}\n\n/** Create a hollow shell by removing faces and offsetting remaining walls. */\nexport function shell<T extends ValidSolid>(\n  shape: Shapeable<T>,\n  faces: Face[] | FinderFn<Face> | ShapeFinder<Face>,\n  thickness: number,\n  options?: { tolerance?: number }\n): Result<T> {\n  const s = resolve(shape);\n  const resolvedFaces = resolveFaces(faces, s);\n  return modifiers.shell(s, resolvedFaces, thickness, options?.tolerance) as Result<T>;\n}\n\n/** Offset all faces of a valid solid by a given distance. */\nexport function offset<T extends ValidSolid>(\n  shape: Shapeable<T>,\n  distance: number,\n  options?: { tolerance?: number }\n): Result<T> {\n  return modifiers.offset(resolve(shape), distance, options?.tolerance) as Result<T>;\n}\n\n/** Thicken a surface (face or shell) into a solid. */\nexport function thicken(\n  shape: Shapeable<Face<Dimension> | Shell>,\n  thickness: number\n): Result<Solid> {\n  // Thicken is 3D-only — narrow from Face<Dimension> to Face<'3D'>\n  return modifiers.thicken(resolve(shape) as Face | Shell, thickness);\n}\n\n/**\n * Draft (taper) selected faces of a 3D shape.\n *\n * Tilts faces by a specified angle relative to a pull direction,\n * pivoting about a neutral plane. Essential for manufacturing workflows\n * (injection molding, casting) where parts must release from a mold.\n */\nexport function draft<T extends ValidSolid>(\n  shape: Shapeable<T>,\n  faces: Face[] | FinderFn<Face> | ShapeFinder<Face>,\n  options: DraftOptions\n): Result<T> {\n  const s = resolve(shape);\n  const resolvedFaces = resolveFaces(faces, s);\n  return modifiers.draft(\n    s,\n    resolvedFaces,\n    options.pullDirection,\n    options.neutralPlane,\n    options.angle\n  ) as Result<T>;\n}\n\n// ---------------------------------------------------------------------------\n// Utilities — clean names\n// ---------------------------------------------------------------------------\n\n/** Heal a shape using the appropriate fixer. */\nexport function heal<T extends AnyShape<Dimension>>(shape: Shapeable<T>): Result<T> {\n  return healing.heal(resolve(shape));\n}\n\n/** Simplify a shape by merging same-domain faces/edges. */\nexport function simplify<T extends AnyShape<Dimension>>(shape: Shapeable<T>): Result<T> {\n  return transforms.simplify(resolve(shape));\n}\n\n/** Mesh a shape for rendering. */\nexport function mesh(\n  shape: Shapeable<AnyShape<Dimension>>,\n  options?: meshing.MeshOptions & { skipNormals?: boolean; includeUVs?: boolean; cache?: boolean }\n): meshing.ShapeMesh {\n  return meshing.mesh(resolve(shape), options);\n}\n\n/** Mesh the edges of a shape for wireframe rendering. */\nexport function meshEdges(\n  shape: Shapeable<AnyShape<Dimension>>,\n  options?: meshing.MeshOptions & { cache?: boolean }\n): meshing.EdgeMesh {\n  return meshing.meshEdges(resolve(shape), options);\n}\n\n/** Get a summary description of a shape. */\nexport function describe(shape: Shapeable<AnyShape<Dimension>>): transforms.ShapeDescription {\n  return transforms.describe(resolve(shape));\n}\n\n/** Serialize a shape to BREP format. */\nexport function toBREP(shape: Shapeable<AnyShape<Dimension>>): Result<string> {\n  return transforms.toBREP(resolve(shape));\n}\n\n/** Deserialize a shape from BREP format. */\nexport function fromBREP(data: string): Result<AnyShape<Dimension>> {\n  return casting.fromBREP(data);\n}\n\n/** Check if a shape is valid. */\nexport function isValid(shape: Shapeable<AnyShape<Dimension>>): boolean {\n  return healing.isValid(resolve(shape));\n}\n\n/** Check if a shape is empty (null). */\nexport function isEmpty(shape: Shapeable<AnyShape<Dimension>>): boolean {\n  return transforms.isEmpty(resolve(shape));\n}\n"]}

package/dist/vendored/brepjs/topology/apiTypes.d.ts

@@ -0,0 +1,135 @@
+/**
+ * API types for the public API.
+ *
+ * Defines `Shapeable`, `Wrapped`, `FinderFn`, and modifier parameter types
+ * that are shared across functional functions and the shape() wrapper.
+ */
+import type { Vec2, Vec3 } from '../core/types.js';
+import type { AnyShape, Dimension, Edge, Face, Wire, Shape3D } from '../core/shapeTypes.js';
+import type { ShapeFinder } from '../query/finderFns.js';
+/**
+ * Structural type matching a Drawing's wire-producing interface.
+ * Used in place of importing the actual Drawing class to avoid
+ * Layer 2 → Layer 3 boundary violations.
+ */
+export interface DrawingLike {
+    sketchOnPlane(plane: string): {
+        wire: Wire;
+    };
+}
+/** Callback that configures a shape finder for inline use in modifiers. */
+export type FinderFn<T extends AnyShape<Dimension>> = (finder: ShapeFinder<T>) => ShapeFinder<T>;
+/**
+ * Fillet radius specification.
+ *
+ * - `number` — constant radius on all selected edges
+ * - `[number, number]` — variable radius (start, end)
+ * - callback — per-edge radius; return `null` to skip an edge
+ */
+export type FilletRadius = number | [number, number] | ((edge: Edge<Dimension>) => number | [number, number] | null);
+/**
+ * Chamfer distance specification.
+ *
+ * - `number` — equal distance
+ * - `[number, number]` — asymmetric distances (dist1, dist2)
+ * - `{ distance, angle }` — distance-angle mode (replaces chamferDistAngleShape)
+ * - callback — per-edge distance; return `null` to skip an edge
+ */
+export type ChamferDistance = number | [number, number] | {
+    distance: number;
+    angle: number;
+} | ((edge: Edge<Dimension>) => number | [number, number] | {
+    distance: number;
+    angle: number;
+} | null);
+/**
+ * Draft angle specification.
+ *
+ * - `number` — constant angle in degrees for all selected faces
+ * - callback — per-face angle; return `null` to skip a face
+ */
+export type DraftAngle = number | ((face: Face<Dimension>) => number | null);
+/** Options for the draft() modifier. */
+export interface DraftOptions {
+    /** Pull direction (mold opening direction). */
+    pullDirection: Vec3;
+    /** A point on the neutral plane (where no material is added or removed). */
+    neutralPlane: Vec3;
+    /** Draft angle in degrees. Constant or per-face callback. */
+    angle: DraftAngle;
+}
+/** Options for the drill() compound operation. */
+export interface DrillOptions {
+    /** Position of the hole (Vec2 projects along axis). */
+    at: Vec2 | Vec3;
+    /** Hole radius. */
+    radius: number;
+    /** Hole depth. Omit for through-all (computed from bounds). */
+    depth?: number;
+    /** Drill axis direction. Default: [0, 0, 1] (Z). */
+    axis?: Vec3;
+}
+/** Options for the pocket() compound operation. */
+export interface PocketOptions {
+    /** 2D profile shape to cut into the face. */
+    profile: DrawingLike | Wire;
+    /** Which face to pocket. Default: top face. */
+    face?: Face | FinderFn<Face>;
+    /** Depth of the pocket cut. */
+    depth: number;
+}
+/** Options for the boss() compound operation. */
+export interface BossOptions {
+    /** 2D profile shape to extrude onto the face. */
+    profile: DrawingLike | Wire;
+    /** Which face to add onto. Default: top face. */
+    face?: Face | FinderFn<Face>;
+    /** Height of the boss extrusion. */
+    height: number;
+}
+/** Options for the mirrorJoin() compound operation. */
+export interface MirrorJoinOptions {
+    /** Mirror plane normal. Default: [1, 0, 0] (mirror across YZ plane). */
+    normal?: Vec3;
+    /** Mirror plane origin. Default: [0, 0, 0]. */
+    at?: Vec3;
+}
+/** Options for the rectangularPattern() compound operation. */
+export interface RectangularPatternOptions {
+    /** Direction for X repetition. */
+    xDir: Vec3;
+    /** Number of copies in X direction. */
+    xCount: number;
+    /** Spacing between copies in X direction. */
+    xSpacing: number;
+    /** Direction for Y repetition. */
+    yDir: Vec3;
+    /** Number of copies in Y direction. */
+    yCount: number;
+    /** Spacing between copies in Y direction. */
+    ySpacing: number;
+}
+/**
+ * Marker interface for the shape() wrapper.
+ *
+ * Full definition lives in wrapperFns.ts — this minimal interface is enough
+ * for the `resolve()` utility and `Shapeable<T>` type to work without
+ * creating circular imports.
+ */
+export interface WrappedMarker<T extends AnyShape<Dimension>> {
+    readonly val: T;
+    /** Brand property to distinguish wrappers from branded shape handles. */
+    readonly __wrapped: true;
+}
+/**
+ * Accept either a raw branded shape or a shape() wrapper.
+ *
+ * All functional API functions use this as their shape parameter type,
+ * enabling seamless interop between styles.
+ */
+export type Shapeable<T extends AnyShape<Dimension>> = T | WrappedMarker<T>;
+/** Extract the raw branded shape from a Shapeable value. */
+export declare function resolve<T extends AnyShape<Dimension>>(s: Shapeable<T>): T;
+/** Extract the raw branded 3D shape from a Shapeable<Shape3D>. */
+export declare function resolve3D(s: Shapeable<Shape3D>): Shape3D;
+//# sourceMappingURL=apiTypes.d.ts.map

package/dist/vendored/brepjs/topology/apiTypes.d.ts.map

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