@faicad/faijs 0.13.0

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

@@ -0,0 +1,271 @@
+/**
+ * Evolution-tracking variants of boolean and modifier operations.
+ *
+ * These functions mirror the standard fuse/cut/intersect/fillet/chamfer/shell
+ * operations but additionally return the ShapeEvolution data, enabling
+ * persistent face selections, constraint tracking, and custom face-level logic.
+ */
+import { getKernel } from '../kernel/index.js';
+import { castShape, castResultShape, disposeDowncastSource, disposeResultShape, getShapeKind, isShape3D, } from '../core/shapeTypes.js';
+import { HASH_CODE_MAX } from '../core/constants.js';
+import { ok, err, isErr } from '../core/result.js';
+import { validationError, typeCastError, kernelError, BrepErrorCode } from '../core/errors.js';
+import { getEdges } from './shapeFns.js';
+import { collectInputFaceHashes, propagateAllMetadata } from './metadata/metadataPropagation.js';
+// ---------------------------------------------------------------------------
+// Pre-validation (inlined from booleanFns.ts to keep change self-contained)
+// ---------------------------------------------------------------------------
+function validateShape3D(shape, label) {
+    if (getKernel().isNull(shape.wrapped)) {
+        return err(validationError(BrepErrorCode.NULL_SHAPE_INPUT, `${label} is a null shape`));
+    }
+    return ok(undefined);
+}
+function validateNotNull(shape, label) {
+    if (getKernel().isNull(shape.wrapped)) {
+        return err(validationError(BrepErrorCode.NULL_SHAPE_INPUT, `${label} is a null shape`));
+    }
+    return ok(undefined);
+}
+function castToShape3D(shape, errorCode, errorMsg, suggestion) {
+    const wrapped = castShape(shape);
+    if (!isShape3D(wrapped)) {
+        const typeName = getShapeKind(wrapped).toUpperCase();
+        disposeDowncastSource(shape, wrapped);
+        disposeResultShape(wrapped);
+        return err(typeCastError(errorCode, `${errorMsg}. Got ${typeName} instead.`, undefined, undefined, suggestion));
+    }
+    disposeDowncastSource(shape, wrapped);
+    return ok(wrapped);
+}
+function resolveEdgeCallback(selectedEdges, callbackFn) {
+    const filteredEdges = [];
+    const hashToValue = new Map();
+    for (const edge of selectedEdges) {
+        const val = callbackFn(edge) ?? 0;
+        if (typeof val === 'number' && val <= 0)
+            continue;
+        if (Array.isArray(val) && (val[0] <= 0 || val[1] <= 0))
+            continue;
+        filteredEdges.push(edge);
+        hashToValue.set(getKernel().hashCode(edge.wrapped, HASH_CODE_MAX), val);
+    }
+    if (filteredEdges.length === 0)
+        return null;
+    const kernelParam = (ocEdge) => {
+        const v = hashToValue.get(getKernel().hashCode(ocEdge, HASH_CODE_MAX));
+        return v ?? 1;
+    };
+    return { edges: filteredEdges, kernelParam };
+}
+export function fuseWithEvolution(a, b, { optimisation = 'none', simplify = false, signal, fuzzyValue } = {}) {
+    if (signal?.aborted)
+        throw signal.reason;
+    const checkA = validateShape3D(a, 'fuseWithEvolution: first operand');
+    if (isErr(checkA))
+        return checkA;
+    const checkB = validateShape3D(b, 'fuseWithEvolution: second operand');
+    if (isErr(checkB))
+        return checkB;
+    const inputFaceHashes = collectInputFaceHashes([a, b]);
+    const { shape: resultShape, evolution } = getKernel().fuseWithHistory(a.wrapped, b.wrapped, inputFaceHashes, HASH_CODE_MAX, { optimisation, simplify, fuzzyValue });
+    const fuseResult = castToShape3D(resultShape, 'FUSE_NOT_3D', 'Fuse did not produce a 3D shape', 'Common causes: overlapping coplanar faces, zero-thickness geometry, or non-manifold input. Try autoHeal() on inputs first.');
+    if (fuseResult.ok) {
+        propagateAllMetadata(evolution, [a, b], fuseResult.value);
+        return ok({ shape: fuseResult.value, evolution });
+    }
+    return fuseResult;
+}
+export function cutWithEvolution(base, tool, { optimisation = 'none', simplify = false, signal, fuzzyValue } = {}) {
+    if (signal?.aborted)
+        throw signal.reason;
+    const checkBase = validateShape3D(base, 'cutWithEvolution: base');
+    if (isErr(checkBase))
+        return checkBase;
+    const checkTool = validateShape3D(tool, 'cutWithEvolution: tool');
+    if (isErr(checkTool))
+        return checkTool;
+    const inputFaceHashes = collectInputFaceHashes([base, tool]);
+    const { shape: resultShape, evolution } = getKernel().cutWithHistory(base.wrapped, tool.wrapped, inputFaceHashes, HASH_CODE_MAX, { optimisation, simplify, fuzzyValue });
+    const cutResult = castToShape3D(resultShape, 'CUT_NOT_3D', 'Cut did not produce a 3D shape', 'Common causes: tool does not fully intersect the base, or produces a zero-thickness sliver. Ensure the tool extends through the shape.');
+    if (cutResult.ok) {
+        propagateAllMetadata(evolution, [base, tool], cutResult.value);
+        return ok({ shape: cutResult.value, evolution });
+    }
+    return cutResult;
+}
+export function intersectWithEvolution(a, b, { simplify = false, signal, fuzzyValue } = {}) {
+    if (signal?.aborted)
+        throw signal.reason;
+    const checkA = validateShape3D(a, 'intersectWithEvolution: first operand');
+    if (isErr(checkA))
+        return checkA;
+    const checkB = validateShape3D(b, 'intersectWithEvolution: second operand');
+    if (isErr(checkB))
+        return checkB;
+    const inputFaceHashes = collectInputFaceHashes([a, b]);
+    const { shape: resultShape, evolution } = getKernel().intersectWithHistory(a.wrapped, b.wrapped, inputFaceHashes, HASH_CODE_MAX, { simplify, fuzzyValue });
+    const intResult = castToShape3D(resultShape, 'INTERSECT_NOT_3D', 'Intersect did not produce a 3D shape', 'Shapes may not overlap. Verify they share a common volume before intersecting.');
+    if (intResult.ok) {
+        propagateAllMetadata(evolution, [a, b], intResult.value);
+        return ok({ shape: intResult.value, evolution });
+    }
+    return intResult;
+}
+// ---------------------------------------------------------------------------
+// Modifier evolution variants
+// ---------------------------------------------------------------------------
+/**
+ * Apply a fillet (rounded edge) to selected edges, returning both
+ * the result shape and the face evolution data.
+ *
+ * @param shape - The shape to modify.
+ * @param edges - Edges to fillet. Pass `undefined` to fillet all edges.
+ * @param radius - Constant radius, variable radius `[r1, r2]`, or per-edge callback.
+ */
+// brepjs-patterns-disable: max-function-lines
+export function filletWithEvolution(shape, edges, radius) {
+    const check = validateNotNull(shape, 'filletWithEvolution: shape');
+    if (isErr(check))
+        return check;
+    if (typeof radius === 'number' && radius <= 0) {
+        return err(validationError('INVALID_FILLET_RADIUS', 'Fillet radius must be positive', undefined, undefined, 'Provide a positive radius value greater than 0'));
+    }
+    if (Array.isArray(radius) && (radius[0] <= 0 || radius[1] <= 0)) {
+        return err(validationError('INVALID_FILLET_RADIUS', 'Fillet radii must both be positive', undefined, undefined, 'Both radius values must be greater than 0'));
+    }
+    const selectedEdges = edges ?? getEdges(shape);
+    if (selectedEdges.length === 0) {
+        return err(validationError(BrepErrorCode.FILLET_NO_EDGES, 'No edges found for fillet', undefined, undefined, 'Check that the shape has edges, or adjust your edge finder criteria'));
+    }
+    try {
+        let filteredEdges;
+        let kernelRadius;
+        if (typeof radius === 'function') {
+            const resolved = resolveEdgeCallback(selectedEdges, radius);
+            if (!resolved) {
+                return err(validationError(BrepErrorCode.FILLET_NO_EDGES, 'No edges with positive radius for fillet', undefined, undefined, 'Check that the radius callback returns positive values'));
+            }
+            filteredEdges = resolved.edges;
+            kernelRadius = resolved.kernelParam;
+        }
+        else {
+            filteredEdges = [...selectedEdges];
+            kernelRadius = radius;
+        }
+        const inputFaceHashes = collectInputFaceHashes([shape]);
+        const { shape: resultShape, evolution } = getKernel().filletWithHistory(shape.wrapped, filteredEdges.map((e) => e.wrapped), kernelRadius, inputFaceHashes, HASH_CODE_MAX);
+        const cast = castResultShape(resultShape);
+        if (!isShape3D(cast)) {
+            disposeResultShape(cast);
+            return err(kernelError(BrepErrorCode.FILLET_NOT_3D, 'Fillet result is not a 3D shape'));
+        }
+        propagateAllMetadata(evolution, [shape], cast);
+        return ok({ shape: cast, evolution });
+    }
+    catch (e) {
+        const raw = e instanceof Error ? e.message : String(e);
+        return err(kernelError('FILLET_FAILED', `Fillet operation failed: ${raw}`, e, {
+            operation: 'fillet',
+            edgeCount: selectedEdges.length,
+            radius,
+        }));
+    }
+}
+/**
+ * Apply a chamfer (beveled edge) to selected edges, returning both
+ * the result shape and the face evolution data.
+ *
+ * @param shape - The shape to modify.
+ * @param edges - Edges to chamfer. Pass `undefined` to chamfer all edges.
+ * @param distance - Symmetric distance, asymmetric `[d1, d2]`, or per-edge callback.
+ */
+// brepjs-patterns-disable: max-function-lines
+export function chamferWithEvolution(shape, edges, distance) {
+    const check = validateNotNull(shape, 'chamferWithEvolution: shape');
+    if (isErr(check))
+        return check;
+    if (typeof distance === 'number' && distance <= 0) {
+        return err(validationError('INVALID_CHAMFER_DISTANCE', 'Chamfer distance must be positive', undefined, undefined, 'Provide a positive distance value greater than 0'));
+    }
+    if (Array.isArray(distance) && (distance[0] <= 0 || distance[1] <= 0)) {
+        return err(validationError('INVALID_CHAMFER_DISTANCE', 'Chamfer distances must both be positive', undefined, undefined, 'Both distance values must be greater than 0'));
+    }
+    const selectedEdges = edges ?? getEdges(shape);
+    if (selectedEdges.length === 0) {
+        return err(validationError(BrepErrorCode.CHAMFER_NO_EDGES, 'No edges found for chamfer'));
+    }
+    try {
+        let filteredEdges;
+        let kernelDistance;
+        if (typeof distance === 'function') {
+            const resolved = resolveEdgeCallback(selectedEdges, distance);
+            if (!resolved) {
+                return err(validationError(BrepErrorCode.CHAMFER_NO_EDGES, 'No edges with positive distance for chamfer'));
+            }
+            filteredEdges = resolved.edges;
+            kernelDistance = resolved.kernelParam;
+        }
+        else {
+            filteredEdges = [...selectedEdges];
+            kernelDistance = distance;
+        }
+        const inputFaceHashes = collectInputFaceHashes([shape]);
+        const { shape: resultShape, evolution } = getKernel().chamferWithHistory(shape.wrapped, filteredEdges.map((e) => e.wrapped), kernelDistance, inputFaceHashes, HASH_CODE_MAX);
+        const cast = castResultShape(resultShape);
+        if (!isShape3D(cast)) {
+            disposeResultShape(cast);
+            return err(kernelError(BrepErrorCode.CHAMFER_NOT_3D, 'Chamfer result is not a 3D shape'));
+        }
+        propagateAllMetadata(evolution, [shape], cast);
+        return ok({ shape: cast, evolution });
+    }
+    catch (e) {
+        const raw = e instanceof Error ? e.message : String(e);
+        return err(kernelError('CHAMFER_FAILED', `Chamfer operation failed: ${raw}`, e, {
+            operation: 'chamfer',
+            edgeCount: selectedEdges.length,
+            distance,
+        }));
+    }
+}
+/**
+ * Create a hollow shell by removing faces and offsetting remaining walls,
+ * returning both the result shape and the face evolution data.
+ *
+ * @param shape - The solid to hollow out.
+ * @param faces - Faces to remove.
+ * @param thickness - Wall thickness.
+ * @param tolerance - Shell operation tolerance (default 1e-3).
+ */
+export function shellWithEvolution(shape, faces, thickness, tolerance = 1e-3) {
+    const check = validateNotNull(shape, 'shellWithEvolution: shape');
+    if (isErr(check))
+        return check;
+    if (thickness <= 0) {
+        return err(validationError('INVALID_THICKNESS', 'Shell thickness must be positive'));
+    }
+    if (faces.length === 0) {
+        return err(validationError('NO_FACES', 'At least one face must be specified for shell'));
+    }
+    try {
+        const inputFaceHashes = collectInputFaceHashes([shape]);
+        const { shape: resultShape, evolution } = getKernel().shellWithHistory(shape.wrapped, faces.map((f) => f.wrapped), thickness, inputFaceHashes, HASH_CODE_MAX, tolerance);
+        const cast = castResultShape(resultShape);
+        if (!isShape3D(cast)) {
+            disposeResultShape(cast);
+            return err(kernelError('SHELL_RESULT_NOT_3D', 'Shell result is not a 3D shape'));
+        }
+        propagateAllMetadata(evolution, [shape], cast);
+        return ok({ shape: cast, evolution });
+    }
+    catch (e) {
+        const raw = e instanceof Error ? e.message : String(e);
+        return err(kernelError('SHELL_FAILED', `Shell operation failed: ${raw}`, e, {
+            operation: 'shell',
+            faceCount: faces.length,
+            thickness,
+        }));
+    }
+}
+//# sourceMappingURL=evolutionFns.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evolutionFns.js","sourceRoot":"","sources":["../../../../src/vendored/brepjs/topology/evolutionFns.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Evolution-tracking variants of boolean and modifier operations.\n *\n * These functions mirror the standard fuse/cut/intersect/fillet/chamfer/shell\n * operations but additionally return the ShapeEvolution data, enabling\n * persistent face selections, constraint tracking, and custom face-level logic.\n */\n\nimport { getKernel } from '../kernel/index.js';\nimport type { Edge, Face, Shape3D } from '../core/shapeTypes.js';\nimport type { ValidSolid } from '../core/validityTypes.js';\nimport {\n  castShape,\n  castResultShape,\n  disposeDowncastSource,\n  disposeResultShape,\n  getShapeKind,\n  isShape3D,\n} from '../core/shapeTypes.js';\nimport { HASH_CODE_MAX } from '../core/constants.js';\nimport { type Result, ok, err, isErr } from '../core/result.js';\nimport { validationError, typeCastError, kernelError, BrepErrorCode } from '../core/errors.js';\nimport type { BooleanOptions, KernelShape, ShapeEvolution, KernelType } from '../kernel/types.js';\nimport { getEdges } from './shapeFns.js';\nimport { collectInputFaceHashes, propagateAllMetadata } from './metadata/metadataPropagation.js';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/** Result of an operation with face evolution tracking. */\nexport interface EvolutionResult<T> {\n  readonly shape: T;\n  readonly evolution: ShapeEvolution;\n}\n\n// ---------------------------------------------------------------------------\n// Pre-validation (inlined from booleanFns.ts to keep change self-contained)\n// ---------------------------------------------------------------------------\n\nfunction validateShape3D(shape: Shape3D, label: string): Result<undefined> {\n  if (getKernel().isNull(shape.wrapped)) {\n    return err(validationError(BrepErrorCode.NULL_SHAPE_INPUT, `${label} is a null shape`));\n  }\n  return ok(undefined);\n}\n\nfunction validateNotNull(\n  shape: { wrapped: { IsNull(): boolean } },\n  label: string\n): Result<undefined> {\n  if (getKernel().isNull(shape.wrapped)) {\n    return err(validationError(BrepErrorCode.NULL_SHAPE_INPUT, `${label} is a null shape`));\n  }\n  return ok(undefined);\n}\n\nfunction castToShape3D(\n  shape: KernelType,\n  errorCode: string,\n  errorMsg: string,\n  suggestion?: string\n): Result<Shape3D> {\n  const wrapped = castShape(shape);\n  if (!isShape3D(wrapped)) {\n    const typeName = getShapeKind(wrapped).toUpperCase();\n    disposeDowncastSource(shape, wrapped);\n    disposeResultShape(wrapped);\n    return err(\n      typeCastError(\n        errorCode,\n        `${errorMsg}. Got ${typeName} instead.`,\n        undefined,\n        undefined,\n        suggestion\n      )\n    );\n  }\n  disposeDowncastSource(shape, wrapped);\n  return ok(wrapped);\n}\n\n// ---------------------------------------------------------------------------\n// Edge callback resolution (inlined from modifierFns.ts)\n// ---------------------------------------------------------------------------\n\n/** Kernel-compatible callback type: looks up value by raw kernel shape hash. */\ntype KernelHashCallback<V> = (ocShape: KernelShape) => V;\n\nfunction resolveEdgeCallback(\n  selectedEdges: ReadonlyArray<Edge>,\n  callbackFn: (edge: Edge) => number | [number, number] | null\n): { edges: Edge[]; kernelParam: KernelHashCallback<number | [number, number]> } | null {\n  const filteredEdges: Edge[] = [];\n  const hashToValue = new Map<number, number | [number, number]>();\n\n  for (const edge of selectedEdges) {\n    const val = callbackFn(edge) ?? 0;\n    if (typeof val === 'number' && val <= 0) continue;\n    if (Array.isArray(val) && (val[0] <= 0 || val[1] <= 0)) continue;\n    filteredEdges.push(edge);\n    hashToValue.set(getKernel().hashCode(edge.wrapped, HASH_CODE_MAX), val);\n  }\n  if (filteredEdges.length === 0) return null;\n\n  const kernelParam: KernelHashCallback<number | [number, number]> = (ocEdge) => {\n    const v = hashToValue.get(getKernel().hashCode(ocEdge, HASH_CODE_MAX));\n    return v ?? 1;\n  };\n  return { edges: filteredEdges, kernelParam };\n}\n\n// ---------------------------------------------------------------------------\n// Boolean evolution variants\n// ---------------------------------------------------------------------------\n\n/**\n * Fuse two 3D shapes together (boolean union), returning both the result\n * shape and the face evolution data.\n *\n * @param a - The first operand.\n * @param b - The second operand.\n * @param options - Boolean operation options.\n * @returns Ok with the fused shape and evolution, or Err on failure.\n */\nexport function fuseWithEvolution(\n  a: ValidSolid,\n  b: ValidSolid,\n  options?: BooleanOptions\n): Result<EvolutionResult<ValidSolid>>;\nexport function fuseWithEvolution(\n  a: Shape3D,\n  b: Shape3D,\n  options?: BooleanOptions\n): Result<EvolutionResult<Shape3D>>;\nexport function fuseWithEvolution(\n  a: Shape3D,\n  b: Shape3D,\n  { optimisation = 'none', simplify = false, signal, fuzzyValue }: BooleanOptions = {}\n): Result<EvolutionResult<Shape3D>> {\n  if (signal?.aborted) throw signal.reason;\n  const checkA = validateShape3D(a, 'fuseWithEvolution: first operand');\n  if (isErr(checkA)) return checkA;\n  const checkB = validateShape3D(b, 'fuseWithEvolution: second operand');\n  if (isErr(checkB)) return checkB;\n  const inputFaceHashes = collectInputFaceHashes([a, b]);\n  const { shape: resultShape, evolution } = getKernel().fuseWithHistory(\n    a.wrapped,\n    b.wrapped,\n    inputFaceHashes,\n    HASH_CODE_MAX,\n    { optimisation, simplify, fuzzyValue }\n  );\n  const fuseResult = castToShape3D(\n    resultShape,\n    'FUSE_NOT_3D',\n    'Fuse did not produce a 3D shape',\n    'Common causes: overlapping coplanar faces, zero-thickness geometry, or non-manifold input. Try autoHeal() on inputs first.'\n  );\n  if (fuseResult.ok) {\n    propagateAllMetadata(evolution, [a, b], fuseResult.value);\n    return ok({ shape: fuseResult.value, evolution });\n  }\n  return fuseResult;\n}\n\n/**\n * Cut a tool shape from a base shape (boolean subtraction), returning both\n * the result shape and the face evolution data.\n *\n * @param base - The shape to cut from.\n * @param tool - The shape to subtract.\n * @param options - Boolean operation options.\n * @returns Ok with the cut shape and evolution, or Err on failure.\n */\nexport function cutWithEvolution(\n  base: ValidSolid,\n  tool: ValidSolid,\n  options?: BooleanOptions\n): Result<EvolutionResult<ValidSolid>>;\nexport function cutWithEvolution(\n  base: Shape3D,\n  tool: Shape3D,\n  options?: BooleanOptions\n): Result<EvolutionResult<Shape3D>>;\nexport function cutWithEvolution(\n  base: Shape3D,\n  tool: Shape3D,\n  { optimisation = 'none', simplify = false, signal, fuzzyValue }: BooleanOptions = {}\n): Result<EvolutionResult<Shape3D>> {\n  if (signal?.aborted) throw signal.reason;\n  const checkBase = validateShape3D(base, 'cutWithEvolution: base');\n  if (isErr(checkBase)) return checkBase;\n  const checkTool = validateShape3D(tool, 'cutWithEvolution: tool');\n  if (isErr(checkTool)) return checkTool;\n  const inputFaceHashes = collectInputFaceHashes([base, tool]);\n  const { shape: resultShape, evolution } = getKernel().cutWithHistory(\n    base.wrapped,\n    tool.wrapped,\n    inputFaceHashes,\n    HASH_CODE_MAX,\n    { optimisation, simplify, fuzzyValue }\n  );\n  const cutResult = castToShape3D(\n    resultShape,\n    'CUT_NOT_3D',\n    'Cut did not produce a 3D shape',\n    'Common causes: tool does not fully intersect the base, or produces a zero-thickness sliver. Ensure the tool extends through the shape.'\n  );\n  if (cutResult.ok) {\n    propagateAllMetadata(evolution, [base, tool], cutResult.value);\n    return ok({ shape: cutResult.value, evolution });\n  }\n  return cutResult;\n}\n\n/**\n * Compute the intersection of two shapes (boolean common), returning both\n * the result shape and the face evolution data.\n *\n * @param a - The first operand.\n * @param b - The second operand.\n * @param options - Boolean operation options.\n * @returns Ok with the intersection and evolution, or Err on failure.\n */\nexport function intersectWithEvolution(\n  a: ValidSolid,\n  b: ValidSolid,\n  options?: BooleanOptions\n): Result<EvolutionResult<ValidSolid>>;\nexport function intersectWithEvolution(\n  a: Shape3D,\n  b: Shape3D,\n  options?: BooleanOptions\n): Result<EvolutionResult<Shape3D>>;\nexport function intersectWithEvolution(\n  a: Shape3D,\n  b: Shape3D,\n  { simplify = false, signal, fuzzyValue }: BooleanOptions = {}\n): Result<EvolutionResult<Shape3D>> {\n  if (signal?.aborted) throw signal.reason;\n  const checkA = validateShape3D(a, 'intersectWithEvolution: first operand');\n  if (isErr(checkA)) return checkA;\n  const checkB = validateShape3D(b, 'intersectWithEvolution: second operand');\n  if (isErr(checkB)) return checkB;\n  const inputFaceHashes = collectInputFaceHashes([a, b]);\n  const { shape: resultShape, evolution } = getKernel().intersectWithHistory(\n    a.wrapped,\n    b.wrapped,\n    inputFaceHashes,\n    HASH_CODE_MAX,\n    { simplify, fuzzyValue }\n  );\n  const intResult = castToShape3D(\n    resultShape,\n    'INTERSECT_NOT_3D',\n    'Intersect did not produce a 3D shape',\n    'Shapes may not overlap. Verify they share a common volume before intersecting.'\n  );\n  if (intResult.ok) {\n    propagateAllMetadata(evolution, [a, b], intResult.value);\n    return ok({ shape: intResult.value, evolution });\n  }\n  return intResult;\n}\n\n// ---------------------------------------------------------------------------\n// Modifier evolution variants\n// ---------------------------------------------------------------------------\n\n/**\n * Apply a fillet (rounded edge) to selected edges, returning both\n * the result shape and the face evolution data.\n *\n * @param shape - The shape to modify.\n * @param edges - Edges to fillet. Pass `undefined` to fillet all edges.\n * @param radius - Constant radius, variable radius `[r1, r2]`, or per-edge callback.\n */\n// brepjs-patterns-disable: max-function-lines\nexport function filletWithEvolution(\n  shape: ValidSolid,\n  edges: ReadonlyArray<Edge> | undefined,\n  radius: number | [number, number] | ((edge: Edge) => number | [number, number] | null)\n): Result<EvolutionResult<ValidSolid>> {\n  const check = validateNotNull(shape, 'filletWithEvolution: shape');\n  if (isErr(check)) return check;\n  if (typeof radius === 'number' && radius <= 0) {\n    return err(\n      validationError(\n        'INVALID_FILLET_RADIUS',\n        'Fillet radius must be positive',\n        undefined,\n        undefined,\n        'Provide a positive radius value greater than 0'\n      )\n    );\n  }\n  if (Array.isArray(radius) && (radius[0] <= 0 || radius[1] <= 0)) {\n    return err(\n      validationError(\n        'INVALID_FILLET_RADIUS',\n        'Fillet radii must both be positive',\n        undefined,\n        undefined,\n        'Both radius values must be greater than 0'\n      )\n    );\n  }\n\n  const selectedEdges = edges ?? getEdges(shape);\n  if (selectedEdges.length === 0) {\n    return err(\n      validationError(\n        BrepErrorCode.FILLET_NO_EDGES,\n        'No edges found for fillet',\n        undefined,\n        undefined,\n        'Check that the shape has edges, or adjust your edge finder criteria'\n      )\n    );\n  }\n\n  try {\n    let filteredEdges: Edge[];\n    let kernelRadius: number | [number, number] | KernelHashCallback<number | [number, number]>;\n\n    if (typeof radius === 'function') {\n      const resolved = resolveEdgeCallback(selectedEdges, radius);\n      if (!resolved) {\n        return err(\n          validationError(\n            BrepErrorCode.FILLET_NO_EDGES,\n            'No edges with positive radius for fillet',\n            undefined,\n            undefined,\n            'Check that the radius callback returns positive values'\n          )\n        );\n      }\n      filteredEdges = resolved.edges;\n      kernelRadius = resolved.kernelParam;\n    } else {\n      filteredEdges = [...selectedEdges];\n      kernelRadius = radius;\n    }\n\n    const inputFaceHashes = collectInputFaceHashes([shape]);\n    const { shape: resultShape, evolution } = getKernel().filletWithHistory(\n      shape.wrapped,\n      filteredEdges.map((e) => e.wrapped),\n      kernelRadius,\n      inputFaceHashes,\n      HASH_CODE_MAX\n    );\n    const cast = castResultShape(resultShape);\n    if (!isShape3D(cast)) {\n      disposeResultShape(cast);\n      return err(kernelError(BrepErrorCode.FILLET_NOT_3D, 'Fillet result is not a 3D shape'));\n    }\n    propagateAllMetadata(evolution, [shape], cast);\n    return ok({ shape: cast as ValidSolid, evolution });\n  } catch (e) {\n    const raw = e instanceof Error ? e.message : String(e);\n    return err(\n      kernelError('FILLET_FAILED', `Fillet operation failed: ${raw}`, e, {\n        operation: 'fillet',\n        edgeCount: selectedEdges.length,\n        radius,\n      })\n    );\n  }\n}\n\n/**\n * Apply a chamfer (beveled edge) to selected edges, returning both\n * the result shape and the face evolution data.\n *\n * @param shape - The shape to modify.\n * @param edges - Edges to chamfer. Pass `undefined` to chamfer all edges.\n * @param distance - Symmetric distance, asymmetric `[d1, d2]`, or per-edge callback.\n */\n// brepjs-patterns-disable: max-function-lines\nexport function chamferWithEvolution(\n  shape: ValidSolid,\n  edges: ReadonlyArray<Edge> | undefined,\n  distance: number | [number, number] | ((edge: Edge) => number | [number, number] | null)\n): Result<EvolutionResult<ValidSolid>> {\n  const check = validateNotNull(shape, 'chamferWithEvolution: shape');\n  if (isErr(check)) return check;\n  if (typeof distance === 'number' && distance <= 0) {\n    return err(\n      validationError(\n        'INVALID_CHAMFER_DISTANCE',\n        'Chamfer distance must be positive',\n        undefined,\n        undefined,\n        'Provide a positive distance value greater than 0'\n      )\n    );\n  }\n  if (Array.isArray(distance) && (distance[0] <= 0 || distance[1] <= 0)) {\n    return err(\n      validationError(\n        'INVALID_CHAMFER_DISTANCE',\n        'Chamfer distances must both be positive',\n        undefined,\n        undefined,\n        'Both distance values must be greater than 0'\n      )\n    );\n  }\n\n  const selectedEdges = edges ?? getEdges(shape);\n  if (selectedEdges.length === 0) {\n    return err(validationError(BrepErrorCode.CHAMFER_NO_EDGES, 'No edges found for chamfer'));\n  }\n\n  try {\n    let filteredEdges: Edge[];\n    let kernelDistance: number | [number, number] | KernelHashCallback<number | [number, number]>;\n\n    if (typeof distance === 'function') {\n      const resolved = resolveEdgeCallback(selectedEdges, distance);\n      if (!resolved) {\n        return err(\n          validationError(\n            BrepErrorCode.CHAMFER_NO_EDGES,\n            'No edges with positive distance for chamfer'\n          )\n        );\n      }\n      filteredEdges = resolved.edges;\n      kernelDistance = resolved.kernelParam;\n    } else {\n      filteredEdges = [...selectedEdges];\n      kernelDistance = distance;\n    }\n\n    const inputFaceHashes = collectInputFaceHashes([shape]);\n    const { shape: resultShape, evolution } = getKernel().chamferWithHistory(\n      shape.wrapped,\n      filteredEdges.map((e) => e.wrapped),\n      kernelDistance,\n      inputFaceHashes,\n      HASH_CODE_MAX\n    );\n    const cast = castResultShape(resultShape);\n    if (!isShape3D(cast)) {\n      disposeResultShape(cast);\n      return err(kernelError(BrepErrorCode.CHAMFER_NOT_3D, 'Chamfer result is not a 3D shape'));\n    }\n    propagateAllMetadata(evolution, [shape], cast);\n    return ok({ shape: cast as ValidSolid, evolution });\n  } catch (e) {\n    const raw = e instanceof Error ? e.message : String(e);\n    return err(\n      kernelError('CHAMFER_FAILED', `Chamfer operation failed: ${raw}`, e, {\n        operation: 'chamfer',\n        edgeCount: selectedEdges.length,\n        distance,\n      })\n    );\n  }\n}\n\n/**\n * Create a hollow shell by removing faces and offsetting remaining walls,\n * returning both the result shape and the face evolution data.\n *\n * @param shape - The solid to hollow out.\n * @param faces - Faces to remove.\n * @param thickness - Wall thickness.\n * @param tolerance - Shell operation tolerance (default 1e-3).\n */\nexport function shellWithEvolution(\n  shape: ValidSolid,\n  faces: ReadonlyArray<Face>,\n  thickness: number,\n  tolerance = 1e-3\n): Result<EvolutionResult<Shape3D>> {\n  const check = validateNotNull(shape, 'shellWithEvolution: shape');\n  if (isErr(check)) return check;\n  if (thickness <= 0) {\n    return err(validationError('INVALID_THICKNESS', 'Shell thickness must be positive'));\n  }\n  if (faces.length === 0) {\n    return err(validationError('NO_FACES', 'At least one face must be specified for shell'));\n  }\n\n  try {\n    const inputFaceHashes = collectInputFaceHashes([shape]);\n    const { shape: resultShape, evolution } = getKernel().shellWithHistory(\n      shape.wrapped,\n      faces.map((f) => f.wrapped),\n      thickness,\n      inputFaceHashes,\n      HASH_CODE_MAX,\n      tolerance\n    );\n    const cast = castResultShape(resultShape);\n    if (!isShape3D(cast)) {\n      disposeResultShape(cast);\n      return err(kernelError('SHELL_RESULT_NOT_3D', 'Shell result is not a 3D shape'));\n    }\n    propagateAllMetadata(evolution, [shape], cast);\n    return ok({ shape: cast, evolution });\n  } catch (e) {\n    const raw = e instanceof Error ? e.message : String(e);\n    return err(\n      kernelError('SHELL_FAILED', `Shell operation failed: ${raw}`, e, {\n        operation: 'shell',\n        faceCount: faces.length,\n        thickness,\n      })\n    );\n  }\n}\n"]}

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

@@ -0,0 +1,86 @@
+/**
+ * Face-specific functions — functional replacements for Face class methods.
+ * All functions accept branded Face handles and return plain values or branded shapes.
+ */
+import type { Vec3, PointInput } from '../core/types.js';
+import type { ClosedWire, Dimension, Face } from '../core/shapeTypes.js';
+import { type Result } from '../core/result.js';
+/** String literal identifying the geometric type of a face's underlying surface. */
+export type SurfaceType = 'PLANE' | 'CYLINDRE' | 'CONE' | 'SPHERE' | 'TORUS' | 'BEZIER_SURFACE' | 'BSPLINE_SURFACE' | 'REVOLUTION_SURFACE' | 'EXTRUSION_SURFACE' | 'OFFSET_SURFACE' | 'OTHER_SURFACE';
+/**
+ * Get the geometric surface type of a face.
+ *
+ * @returns Ok with the surface type, or Err for unrecognized kernel surface types.
+ */
+export declare function getSurfaceType(face: Face): Result<SurfaceType>;
+/** Get the surface type of a face (unwrapped convenience). */
+export declare function faceGeomType(face: Face): SurfaceType;
+/** Get the topological orientation of a face. */
+export declare function faceOrientation(face: Face): 'forward' | 'backward';
+/** Flip the orientation of a face. Returns a new face. */
+export declare function flipFaceOrientation(face: Face): Face;
+/** UV parameter bounds of a face. */
+export interface UVBounds {
+    readonly uMin: number;
+    readonly uMax: number;
+    readonly vMin: number;
+    readonly vMax: number;
+}
+/** Get the UV parameter bounds of a face. */
+export declare function uvBounds(face: Face): UVBounds;
+/**
+ * Get a point on a face surface at normalized UV coordinates (0-1 range).
+ *
+ * @param face - The face to evaluate.
+ * @param u - Normalized U parameter (0-1).
+ * @param v - Normalized V parameter (0-1).
+ */
+export declare function pointOnSurface(face: Face, u: number, v: number): Vec3;
+/** Get the UV coordinates on a face for a given 3D point. */
+export declare function uvCoordinates(face: Face, point: PointInput): [number, number];
+/** Result of projecting a point onto a face surface. */
+export interface PointProjectionResult {
+    /** UV coordinates on the surface. */
+    readonly uv: [number, number];
+    /** The closest 3D point on the surface. */
+    readonly point: Vec3;
+    /** Distance from the input point to the projected point. */
+    readonly distance: number;
+}
+/**
+ * Project a 3D point onto a face surface.
+ *
+ * Returns the projected point, its UV coordinates, and the distance
+ * from the original point to the surface.
+ */
+export declare function projectPointOnFace(face: Face, point: PointInput): Result<PointProjectionResult>;
+/** Get the surface normal at a point (or at the center if no point given). */
+export declare function normalAt(face: Face, locationPoint?: PointInput): Vec3;
+/** Get the center of mass of a face. */
+export declare function faceCenter(face: Face): Vec3;
+/**
+ * Get a face's axis of symmetry — a point on the axis plus a unit direction —
+ * for analytic faces that have one (e.g. a cylinder's axis). Returns null when
+ * the face has no well-defined axis or the active kernel can't determine it.
+ */
+export declare function faceAxis(face: Face): {
+    origin: Vec3;
+    direction: Vec3;
+} | null;
+/**
+ * Classify a 3D point's position relative to a face boundary.
+ * Projects the point onto the face's surface and classifies the UV result.
+ *
+ * @returns 'in' if inside, 'on' if on the boundary, 'out' if outside
+ */
+export declare function classifyPointOnFace(face: Face, point: PointInput, tolerance?: number): 'in' | 'on' | 'out';
+/** Get the outer wire of a face. The outer boundary of a face is always closed. */
+export declare function outerWire<D extends Dimension = '3D'>(face: Face<D>): ClosedWire<D>;
+/**
+ * Remove all holes (inner wires) from a face, returning a new face with only the outer boundary.
+ * Useful for defeaturing workflows where holes need to be temporarily or permanently filled.
+ */
+export declare function removeHolesFromFace<D extends Dimension = '3D'>(face: Face<D>): Face<D>;
+/** Get the inner wires (holes) of a face. Hole boundaries are always closed. */
+export declare function innerWires<D extends Dimension = '3D'>(face: Face<D>): ClosedWire<D>[];
+//# sourceMappingURL=faceFns.d.ts.map

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

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

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

@@ -0,0 +1,169 @@
+/**
+ * Face-specific functions — functional replacements for Face class methods.
+ * All functions accept branded Face handles and return plain values or branded shapes.
+ */
+import { getKernel } from '../kernel/index.js';
+import { toVec3 } from '../core/types.js';
+import { castShape } from '../core/shapeTypes.js';
+import { ok, err, unwrap } from '../core/result.js';
+import { typeCastError } from '../core/errors.js';
+import { iterTopo, downcast } from './cast.js';
+import { getCachedSurfaceType } from './topologyQueryFns.js';
+/** Map kernel surface type strings to the public API surface type constants. */
+const KERNEL_TO_PUBLIC_SURFACE_TYPE = {
+    plane: 'PLANE',
+    cylinder: 'CYLINDRE',
+    cone: 'CONE',
+    sphere: 'SPHERE',
+    torus: 'TORUS',
+    bezier: 'BEZIER_SURFACE',
+    bspline: 'BSPLINE_SURFACE',
+    revolution: 'REVOLUTION_SURFACE',
+    extrusion: 'EXTRUSION_SURFACE',
+    offset: 'OFFSET_SURFACE',
+    other: 'OTHER_SURFACE',
+};
+/**
+ * Get the geometric surface type of a face.
+ *
+ * @returns Ok with the surface type, or Err for unrecognized kernel surface types.
+ */
+export function getSurfaceType(face) {
+    const kernelType = getCachedSurfaceType(face);
+    return ok(KERNEL_TO_PUBLIC_SURFACE_TYPE[kernelType]);
+}
+/** Get the surface type of a face (unwrapped convenience). */
+export function faceGeomType(face) {
+    return unwrap(getSurfaceType(face));
+}
+// ---------------------------------------------------------------------------
+// Face orientation
+// ---------------------------------------------------------------------------
+/** Get the topological orientation of a face. */
+export function faceOrientation(face) {
+    const orient = getKernel().shapeOrientation(face.wrapped);
+    return orient === 'forward' ? 'forward' : 'backward';
+}
+/** Flip the orientation of a face. Returns a new face. */
+export function flipFaceOrientation(face) {
+    return castShape(getKernel().reverseShape(face.wrapped));
+}
+/** Get the UV parameter bounds of a face. */
+export function uvBounds(face) {
+    return getKernel().uvBounds(face.wrapped);
+}
+/**
+ * Get a point on a face surface at normalized UV coordinates (0-1 range).
+ *
+ * @param face - The face to evaluate.
+ * @param u - Normalized U parameter (0-1).
+ * @param v - Normalized V parameter (0-1).
+ */
+export function pointOnSurface(face, u, v) {
+    const bounds = uvBounds(face);
+    const absU = u * (bounds.uMax - bounds.uMin) + bounds.uMin;
+    const absV = v * (bounds.vMax - bounds.vMin) + bounds.vMin;
+    return getKernel().pointOnSurface(face.wrapped, absU, absV);
+}
+/** Get the UV coordinates on a face for a given 3D point. */
+export function uvCoordinates(face, point) {
+    const v = toVec3(point);
+    const result = getKernel().uvFromPoint(face.wrapped, v);
+    if (!result) {
+        // Fallback: return [0, 0] if projection fails (matches previous behavior where
+        // LowerDistanceParameters would return default values)
+        return [0, 0];
+    }
+    return result;
+}
+/**
+ * Project a 3D point onto a face surface.
+ *
+ * Returns the projected point, its UV coordinates, and the distance
+ * from the original point to the surface.
+ */
+export function projectPointOnFace(face, point) {
+    const v = toVec3(point);
+    try {
+        const vMut = v;
+        const uvResult = getKernel().uvFromPoint(face.wrapped, vMut);
+        if (!uvResult) {
+            return err(typeCastError('PROJECTION_FAILED', 'No projection found on the face'));
+        }
+        const projectedPoint = getKernel().projectPointOnFace(face.wrapped, vMut);
+        // Compute distance between input point and projected point
+        const dx = v[0] - projectedPoint[0];
+        const dy = v[1] - projectedPoint[1];
+        const dz = v[2] - projectedPoint[2];
+        const distance = Math.sqrt(dx * dx + dy * dy + dz * dz);
+        return ok({
+            uv: uvResult,
+            point: projectedPoint,
+            distance,
+        });
+    }
+    catch (e) {
+        return err(typeCastError('PROJECTION_FAILED', `Point projection failed: ${e instanceof Error ? e.message : String(e)}`));
+    }
+}
+/** Get the surface normal at a point (or at the center if no point given). */
+export function normalAt(face, locationPoint) {
+    let u;
+    let v;
+    if (!locationPoint) {
+        const bounds = uvBounds(face);
+        u = 0.5 * (bounds.uMin + bounds.uMax);
+        v = 0.5 * (bounds.vMin + bounds.vMax);
+    }
+    else {
+        [u, v] = uvCoordinates(face, locationPoint);
+    }
+    return getKernel().surfaceNormal(face.wrapped, u, v);
+}
+/** Get the center of mass of a face. */
+export function faceCenter(face) {
+    return getKernel().surfaceCenterOfMass(face.wrapped);
+}
+/**
+ * Get a face's axis of symmetry — a point on the axis plus a unit direction —
+ * for analytic faces that have one (e.g. a cylinder's axis). Returns null when
+ * the face has no well-defined axis or the active kernel can't determine it.
+ */
+export function faceAxis(face) {
+    return getKernel().getSurfaceAxis(face.wrapped);
+}
+// ---------------------------------------------------------------------------
+// Point classification
+// ---------------------------------------------------------------------------
+/**
+ * Classify a 3D point's position relative to a face boundary.
+ * Projects the point onto the face's surface and classifies the UV result.
+ *
+ * @returns 'in' if inside, 'on' if on the boundary, 'out' if outside
+ */
+export function classifyPointOnFace(face, point, tolerance = 1e-6) {
+    const [u, v] = uvCoordinates(face, point);
+    return getKernel().classifyPointOnFace(face.wrapped, u, v, tolerance);
+}
+// ---------------------------------------------------------------------------
+// Wire extraction from faces
+// ---------------------------------------------------------------------------
+/** Get the outer wire of a face. The outer boundary of a face is always closed. */
+export function outerWire(face) {
+    return castShape(getKernel().outerWire(face.wrapped));
+}
+/**
+ * Remove all holes (inner wires) from a face, returning a new face with only the outer boundary.
+ * Useful for defeaturing workflows where holes need to be temporarily or permanently filled.
+ */
+export function removeHolesFromFace(face) {
+    return castShape(getKernel().removeHolesFromFace(face.wrapped));
+}
+/** Get the inner wires (holes) of a face. Hole boundaries are always closed. */
+export function innerWires(face) {
+    const outer = outerWire(face);
+    const allWires = Array.from(iterTopo(face.wrapped, 'wire')).map((w) => castShape(unwrap(downcast(w))));
+    const result = allWires.filter((w) => !getKernel().isSame(w.wrapped, outer.wrapped));
+    return result;
+}
+//# sourceMappingURL=faceFns.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"faceFns.js","sourceRoot":"","sources":["../../../../src/vendored/brepjs/topology/faceFns.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Face-specific functions — functional replacements for Face class methods.\n * All functions accept branded Face handles and return plain values or branded shapes.\n */\n\nimport { getKernel } from '../kernel/index.js';\nimport type { SurfaceType as KernelSurfaceType } from '../kernel/index.js';\nimport type { Vec3, PointInput } from '../core/types.js';\nimport { toVec3 } from '../core/types.js';\nimport type { ClosedWire, Dimension, Face } from '../core/shapeTypes.js';\nimport { castShape } from '../core/shapeTypes.js';\nimport { type Result, ok, err, unwrap } from '../core/result.js';\nimport { typeCastError } from '../core/errors.js';\nimport { iterTopo, downcast } from './cast.js';\nimport { getCachedSurfaceType } from './topologyQueryFns.js';\n\n// ---------------------------------------------------------------------------\n// Surface type detection\n// ---------------------------------------------------------------------------\n\n/** String literal identifying the geometric type of a face's underlying surface. */\nexport type SurfaceType =\n  | 'PLANE'\n  | 'CYLINDRE'\n  | 'CONE'\n  | 'SPHERE'\n  | 'TORUS'\n  | 'BEZIER_SURFACE'\n  | 'BSPLINE_SURFACE'\n  | 'REVOLUTION_SURFACE'\n  | 'EXTRUSION_SURFACE'\n  | 'OFFSET_SURFACE'\n  | 'OTHER_SURFACE';\n\n/** Map kernel surface type strings to the public API surface type constants. */\nconst KERNEL_TO_PUBLIC_SURFACE_TYPE: Record<KernelSurfaceType, SurfaceType> = {\n  plane: 'PLANE',\n  cylinder: 'CYLINDRE',\n  cone: 'CONE',\n  sphere: 'SPHERE',\n  torus: 'TORUS',\n  bezier: 'BEZIER_SURFACE',\n  bspline: 'BSPLINE_SURFACE',\n  revolution: 'REVOLUTION_SURFACE',\n  extrusion: 'EXTRUSION_SURFACE',\n  offset: 'OFFSET_SURFACE',\n  other: 'OTHER_SURFACE',\n};\n\n/**\n * Get the geometric surface type of a face.\n *\n * @returns Ok with the surface type, or Err for unrecognized kernel surface types.\n */\nexport function getSurfaceType(face: Face): Result<SurfaceType> {\n  const kernelType = getCachedSurfaceType(face);\n  return ok(KERNEL_TO_PUBLIC_SURFACE_TYPE[kernelType]);\n}\n\n/** Get the surface type of a face (unwrapped convenience). */\nexport function faceGeomType(face: Face): SurfaceType {\n  return unwrap(getSurfaceType(face));\n}\n\n// ---------------------------------------------------------------------------\n// Face orientation\n// ---------------------------------------------------------------------------\n\n/** Get the topological orientation of a face. */\nexport function faceOrientation(face: Face): 'forward' | 'backward' {\n  const orient = getKernel().shapeOrientation(face.wrapped);\n  return orient === 'forward' ? 'forward' : 'backward';\n}\n\n/** Flip the orientation of a face. Returns a new face. */\nexport function flipFaceOrientation(face: Face): Face {\n  return castShape(getKernel().reverseShape(face.wrapped)) as Face;\n}\n\n// ---------------------------------------------------------------------------\n// UV and surface queries\n// ---------------------------------------------------------------------------\n\n/** UV parameter bounds of a face. */\nexport interface UVBounds {\n  readonly uMin: number;\n  readonly uMax: number;\n  readonly vMin: number;\n  readonly vMax: number;\n}\n\n/** Get the UV parameter bounds of a face. */\nexport function uvBounds(face: Face): UVBounds {\n  return getKernel().uvBounds(face.wrapped);\n}\n\n/**\n * Get a point on a face surface at normalized UV coordinates (0-1 range).\n *\n * @param face - The face to evaluate.\n * @param u - Normalized U parameter (0-1).\n * @param v - Normalized V parameter (0-1).\n */\nexport function pointOnSurface(face: Face, u: number, v: number): Vec3 {\n  const bounds = uvBounds(face);\n  const absU = u * (bounds.uMax - bounds.uMin) + bounds.uMin;\n  const absV = v * (bounds.vMax - bounds.vMin) + bounds.vMin;\n  return getKernel().pointOnSurface(face.wrapped, absU, absV);\n}\n\n/** Get the UV coordinates on a face for a given 3D point. */\nexport function uvCoordinates(face: Face, point: PointInput): [number, number] {\n  const v = toVec3(point);\n  const result = getKernel().uvFromPoint(face.wrapped, v as [number, number, number]);\n  if (!result) {\n    // Fallback: return [0, 0] if projection fails (matches previous behavior where\n    // LowerDistanceParameters would return default values)\n    return [0, 0];\n  }\n  return result;\n}\n\n/** Result of projecting a point onto a face surface. */\nexport interface PointProjectionResult {\n  /** UV coordinates on the surface. */\n  readonly uv: [number, number];\n  /** The closest 3D point on the surface. */\n  readonly point: Vec3;\n  /** Distance from the input point to the projected point. */\n  readonly distance: number;\n}\n\n/**\n * Project a 3D point onto a face surface.\n *\n * Returns the projected point, its UV coordinates, and the distance\n * from the original point to the surface.\n */\nexport function projectPointOnFace(face: Face, point: PointInput): Result<PointProjectionResult> {\n  const v = toVec3(point);\n\n  try {\n    const vMut = v as [number, number, number];\n    const uvResult = getKernel().uvFromPoint(face.wrapped, vMut);\n    if (!uvResult) {\n      return err(typeCastError('PROJECTION_FAILED', 'No projection found on the face'));\n    }\n\n    const projectedPoint = getKernel().projectPointOnFace(face.wrapped, vMut);\n\n    // Compute distance between input point and projected point\n    const dx = v[0] - projectedPoint[0];\n    const dy = v[1] - projectedPoint[1];\n    const dz = v[2] - projectedPoint[2];\n    const distance = Math.sqrt(dx * dx + dy * dy + dz * dz);\n\n    return ok({\n      uv: uvResult,\n      point: projectedPoint,\n      distance,\n    });\n  } catch (e) {\n    return err(\n      typeCastError(\n        'PROJECTION_FAILED',\n        `Point projection failed: ${e instanceof Error ? e.message : String(e)}`\n      )\n    );\n  }\n}\n\n/** Get the surface normal at a point (or at the center if no point given). */\nexport function normalAt(face: Face, locationPoint?: PointInput): Vec3 {\n  let u: number;\n  let v: number;\n\n  if (!locationPoint) {\n    const bounds = uvBounds(face);\n    u = 0.5 * (bounds.uMin + bounds.uMax);\n    v = 0.5 * (bounds.vMin + bounds.vMax);\n  } else {\n    [u, v] = uvCoordinates(face, locationPoint);\n  }\n\n  return getKernel().surfaceNormal(face.wrapped, u, v);\n}\n\n/** Get the center of mass of a face. */\nexport function faceCenter(face: Face): Vec3 {\n  return getKernel().surfaceCenterOfMass(face.wrapped);\n}\n\n/**\n * Get a face's axis of symmetry — a point on the axis plus a unit direction —\n * for analytic faces that have one (e.g. a cylinder's axis). Returns null when\n * the face has no well-defined axis or the active kernel can't determine it.\n */\nexport function faceAxis(face: Face): { origin: Vec3; direction: Vec3 } | null {\n  return getKernel().getSurfaceAxis(face.wrapped);\n}\n\n// ---------------------------------------------------------------------------\n// Point classification\n// ---------------------------------------------------------------------------\n\n/**\n * Classify a 3D point's position relative to a face boundary.\n * Projects the point onto the face's surface and classifies the UV result.\n *\n * @returns 'in' if inside, 'on' if on the boundary, 'out' if outside\n */\nexport function classifyPointOnFace(\n  face: Face,\n  point: PointInput,\n  tolerance = 1e-6\n): 'in' | 'on' | 'out' {\n  const [u, v] = uvCoordinates(face, point);\n  return getKernel().classifyPointOnFace(face.wrapped, u, v, tolerance);\n}\n\n// ---------------------------------------------------------------------------\n// Wire extraction from faces\n// ---------------------------------------------------------------------------\n\n/** Get the outer wire of a face. The outer boundary of a face is always closed. */\nexport function outerWire<D extends Dimension = '3D'>(face: Face<D>): ClosedWire<D> {\n  return castShape(getKernel().outerWire(face.wrapped)) as ClosedWire<D>;\n}\n\n/**\n * Remove all holes (inner wires) from a face, returning a new face with only the outer boundary.\n * Useful for defeaturing workflows where holes need to be temporarily or permanently filled.\n */\nexport function removeHolesFromFace<D extends Dimension = '3D'>(face: Face<D>): Face<D> {\n  return castShape(getKernel().removeHolesFromFace(face.wrapped)) as Face<D>;\n}\n\n/** Get the inner wires (holes) of a face. Hole boundaries are always closed. */\nexport function innerWires<D extends Dimension = '3D'>(face: Face<D>): ClosedWire<D>[] {\n  const outer = outerWire(face);\n  const allWires = Array.from(iterTopo(face.wrapped, 'wire')).map(\n    (w) => castShape(unwrap(downcast(w))) as ClosedWire<D>\n  );\n  const result = allWires.filter((w) => !getKernel().isSame(w.wrapped, outer.wrapped));\n  return result;\n}\n"]}