@faicad/faijs 0.16.0 → 0.17.0

package/dist/result/errors.js

@@ -0,0 +1,317 @@
+/**
+ * Domain error types and constructors（第一方模块）。
+ *
+ * 2026-09-25 core-decouple Phase 1：复制自 brepjs `src/core/errors.ts`
+ * （同源复制，签名不变）；import 来源改为 core 第一方 `result/` 内模块。
+ * Re-exports bug/BrepBugError（Layer 0）for convenience.
+ */
+import { bug, BrepBugError } from './bug.js';
+import { wasmIndex } from './vec3.js';
+export { bug, BrepBugError };
+// ---------------------------------------------------------------------------
+// Error codes — typed constants for all known error code strings
+// ---------------------------------------------------------------------------
+/**
+ * Typed string constants for all known brepjs error codes, grouped by category.
+ *
+ * Use these instead of raw strings so that typos are caught at compile time.
+ */
+export const BrepErrorCode = {
+    // kernel operation errors
+    BSPLINE_FAILED: 'BSPLINE_FAILED',
+    FACE_BUILD_FAILED: 'FACE_BUILD_FAILED',
+    WIRE_BUILD_FAILED: 'WIRE_BUILD_FAILED',
+    SWEEP_FAILED: 'SWEEP_FAILED',
+    LOFT_FAILED: 'LOFT_FAILED',
+    FUSE_FAILED: 'FUSE_FAILED',
+    CUT_FAILED: 'CUT_FAILED',
+    HEAL_NO_EFFECT: 'HEAL_NO_EFFECT',
+    BOOLEAN_HAS_ERRORS: 'BOOLEAN_HAS_ERRORS',
+    VARIABLE_FILLET_FAILED: 'VARIABLE_FILLET_FAILED',
+    POSITION_ON_CURVE_FAILED: 'POSITION_ON_CURVE_FAILED',
+    FIX_SHAPE_FAILED: 'FIX_SHAPE_FAILED',
+    SOLID_FROM_SHELL_FAILED: 'SOLID_FROM_SHELL_FAILED',
+    FIX_SELF_INTERSECTION_FAILED: 'FIX_SELF_INTERSECTION_FAILED',
+    MESH_FAILED: 'MESH_FAILED',
+    // Validation errors
+    ELLIPSE_RADII: 'ELLIPSE_RADII',
+    FUSE_ALL_EMPTY: 'FUSE_ALL_EMPTY',
+    FILLET_NO_EDGES: 'FILLET_NO_EDGES',
+    CHAMFER_NO_EDGES: 'CHAMFER_NO_EDGES',
+    CHAMFER_ANGLE_NO_EDGES: 'CHAMFER_ANGLE_NO_EDGES',
+    CHAMFER_ANGLE_BAD_DISTANCE: 'CHAMFER_ANGLE_BAD_DISTANCE',
+    CHAMFER_ANGLE_BAD_ANGLE: 'CHAMFER_ANGLE_BAD_ANGLE',
+    BEZIER_MIN_POINTS: 'BEZIER_MIN_POINTS',
+    POLYGON_MIN_POINTS: 'POLYGON_MIN_POINTS',
+    WIRE_NOT_CLOSED: 'WIRE_NOT_CLOSED',
+    FACE_NOT_PLANAR: 'FACE_NOT_PLANAR',
+    ZERO_LENGTH_EXTRUSION: 'ZERO_LENGTH_EXTRUSION',
+    ZERO_TWIST_ANGLE: 'ZERO_TWIST_ANGLE',
+    LOFT_EMPTY: 'LOFT_EMPTY',
+    UNSUPPORTED_PROFILE: 'UNSUPPORTED_PROFILE',
+    UNKNOWN_PLANE: 'UNKNOWN_PLANE',
+    NULL_SHAPE_INPUT: 'NULL_SHAPE_INPUT',
+    INVALID_FILLET_RADIUS: 'INVALID_FILLET_RADIUS',
+    INVALID_CHAMFER_DISTANCE: 'INVALID_CHAMFER_DISTANCE',
+    INVALID_THICKNESS: 'INVALID_THICKNESS',
+    ZERO_OFFSET: 'ZERO_OFFSET',
+    NO_EDGES: 'NO_EDGES',
+    NO_FACES: 'NO_FACES',
+    DRAFT_NO_FACES: 'DRAFT_NO_FACES',
+    DRAFT_INVALID_ANGLE: 'DRAFT_INVALID_ANGLE',
+    DRAFT_NOT_3D: 'DRAFT_NOT_3D',
+    DRAFT_FAILED: 'DRAFT_FAILED',
+    // Type cast errors
+    FUSE_NOT_3D: 'FUSE_NOT_3D',
+    CUT_NOT_3D: 'CUT_NOT_3D',
+    INTERSECT_NOT_3D: 'INTERSECT_NOT_3D',
+    FUSE_ALL_NOT_3D: 'FUSE_ALL_NOT_3D',
+    CUT_ALL_NOT_3D: 'CUT_ALL_NOT_3D',
+    LOFT_NOT_3D: 'LOFT_NOT_3D',
+    SWEEP_NOT_3D: 'SWEEP_NOT_3D',
+    REVOLUTION_NOT_3D: 'REVOLUTION_NOT_3D',
+    FILLET_NOT_3D: 'FILLET_NOT_3D',
+    CHAMFER_NOT_3D: 'CHAMFER_NOT_3D',
+    CHAMFER_ANGLE_NOT_3D: 'CHAMFER_ANGLE_NOT_3D',
+    CHAMFER_ANGLE_FAILED: 'CHAMFER_ANGLE_FAILED',
+    CSG_NOT_3D: 'CSG_NOT_3D',
+    SHELL_NOT_3D: 'SHELL_NOT_3D',
+    OFFSET_NOT_3D: 'OFFSET_NOT_3D',
+    NULL_SHAPE: 'NULL_SHAPE',
+    NO_WRAPPER: 'NO_WRAPPER',
+    WELD_NOT_SHELL: 'WELD_NOT_SHELL',
+    SOLID_BUILD_FAILED: 'SOLID_BUILD_FAILED',
+    OFFSET_NOT_WIRE: 'OFFSET_NOT_WIRE',
+    UNKNOWN_SURFACE_TYPE: 'UNKNOWN_SURFACE_TYPE',
+    UNKNOWN_CURVE_TYPE: 'UNKNOWN_CURVE_TYPE',
+    SWEEP_START_NOT_WIRE: 'SWEEP_START_NOT_WIRE',
+    SWEEP_END_NOT_WIRE: 'SWEEP_END_NOT_WIRE',
+    // IO errors
+    STEP_EXPORT_FAILED: 'STEP_EXPORT_FAILED',
+    STEP_EXPORT_CONFIGURED_FAILED: 'STEP_EXPORT_CONFIGURED_FAILED',
+    STEP_FILE_READ_ERROR: 'STEP_FILE_READ_ERROR',
+    STEP_EXPORT_CRASHED: 'STEP_EXPORT_CRASHED',
+    STEP_EXPORT_UNSERIALIZABLE: 'STEP_EXPORT_UNSERIALIZABLE',
+    STL_EXPORT_FAILED: 'STL_EXPORT_FAILED',
+    STL_FILE_READ_ERROR: 'STL_FILE_READ_ERROR',
+    STL_EXPORT_CRASHED: 'STL_EXPORT_CRASHED',
+    STL_EXPORT_UNSERIALIZABLE: 'STL_EXPORT_UNSERIALIZABLE',
+    STEP_IMPORT_FAILED: 'STEP_IMPORT_FAILED',
+    STL_IMPORT_FAILED: 'STL_IMPORT_FAILED',
+    IGES_EXPORT_FAILED: 'IGES_EXPORT_FAILED',
+    IGES_IMPORT_FAILED: 'IGES_IMPORT_FAILED',
+    DXF_IMPORT_FAILED: 'DXF_IMPORT_FAILED',
+    OBJ_IMPORT_FAILED: 'OBJ_IMPORT_FAILED',
+    THREEMF_IMPORT_FAILED: 'THREEMF_IMPORT_FAILED',
+    // Computation errors
+    PARAMETER_NOT_FOUND: 'PARAMETER_NOT_FOUND',
+    INTERSECTION_FAILED: 'INTERSECTION_FAILED',
+    SELF_INTERSECTION_FAILED: 'SELF_INTERSECTION_FAILED',
+    STRAIGHT_SKELETON_FAILED: 'STRAIGHT_SKELETON_FAILED',
+    CENTER_OF_MASS_FAILED: 'CENTER_OF_MASS_FAILED',
+    // Compound operation errors
+    COMPOUND_NO_FACES: 'COMPOUND_NO_FACES',
+    COMPOUND_FACE_NOT_FOUND: 'COMPOUND_FACE_NOT_FOUND',
+    // Query errors
+    FINDER_NOT_UNIQUE: 'FINDER_NOT_UNIQUE',
+    // Hull errors
+    HULL_EMPTY_INPUT: 'HULL_EMPTY_INPUT',
+    HULL_FAILED: 'HULL_FAILED',
+    HULL_DEGENERATE: 'HULL_DEGENERATE',
+    HULL_NOT_3D: 'HULL_NOT_3D',
+    // Minkowski errors
+    MINKOWSKI_FAILED: 'MINKOWSKI_FAILED',
+    MINKOWSKI_NULL_TOOL: 'MINKOWSKI_NULL_TOOL',
+    MINKOWSKI_NOT_3D: 'MINKOWSKI_NOT_3D',
+    // Polyhedron errors
+    POLYHEDRON_INSUFFICIENT_POINTS: 'POLYHEDRON_INSUFFICIENT_POINTS',
+    POLYHEDRON_INSUFFICIENT_FACES: 'POLYHEDRON_INSUFFICIENT_FACES',
+    POLYHEDRON_INVALID_INDEX: 'POLYHEDRON_INVALID_INDEX',
+    POLYHEDRON_FAILED: 'POLYHEDRON_FAILED',
+    // General validation errors
+    VALIDATION_FAILED: 'VALIDATION_FAILED',
+    // Roof errors
+    ROOF_FAILED: 'ROOF_FAILED',
+    // Multi-section sweep errors
+    MULTI_SWEEP_INSUFFICIENT_SECTIONS: 'MULTI_SWEEP_INSUFFICIENT_SECTIONS',
+    MULTI_SWEEP_FAILED: 'MULTI_SWEEP_FAILED',
+    // Guide curve sweep errors
+    GUIDED_SWEEP_FAILED: 'GUIDED_SWEEP_FAILED',
+    // Surface errors
+    SURFACE_GRID_TOO_SMALL: 'SURFACE_GRID_TOO_SMALL',
+    SURFACE_GRID_JAGGED: 'SURFACE_GRID_JAGGED',
+    SURFACE_FAILED: 'SURFACE_FAILED',
+    // Assembly mate errors
+    ASSEMBLY_MATE_INVALID: 'ASSEMBLY_MATE_INVALID',
+    ASSEMBLY_SOLVE_FAILED: 'ASSEMBLY_SOLVE_FAILED',
+    ASSEMBLY_NOT_CONVERGED: 'ASSEMBLY_NOT_CONVERGED',
+    // Blueprint / CompoundBlueprint errors
+    BLUEPRINT_EMPTY_CURVES: 'BLUEPRINT_EMPTY_CURVES',
+    COMPOUND_BLUEPRINT_EMPTY: 'COMPOUND_BLUEPRINT_EMPTY',
+    // GLB/glTF import errors
+    GLB_IMPORT_FAILED: 'GLB_IMPORT_FAILED',
+    // Font/text errors
+    FONT_FETCH_FAILED: 'FONT_FETCH_FAILED',
+    FONT_PARSE_FAILED: 'FONT_PARSE_FAILED',
+    NO_FONT_LOADED: 'NO_FONT_LOADED',
+    // 2D curve geometry errors
+    CURVE2D_CONSTRUCTION_FAILED: 'CURVE2D_CONSTRUCTION_FAILED',
+    CURVE2D_INVALID_RADIUS: 'CURVE2D_INVALID_RADIUS',
+    CURVE2D_TRANSFORM_FAILED: 'CURVE2D_TRANSFORM_FAILED',
+    CURVE2D_QUERY_FAILED: 'CURVE2D_QUERY_FAILED',
+    CURVE2D_INTERSECTION_FAILED: 'CURVE2D_INTERSECTION_FAILED',
+    CURVE2D_BRIDGE_FAILED: 'CURVE2D_BRIDGE_FAILED',
+    // Shape identity errors
+    CLONE_FAILED: 'CLONE_FAILED',
+    SIMPLIFY_FAILED: 'SIMPLIFY_FAILED',
+    TO_BREP_FAILED: 'TO_BREP_FAILED',
+    // Unsupported capability errors (ADR-0006 Phase 4)
+    UNSUPPORTED_CAPABILITY: 'UNSUPPORTED_CAPABILITY',
+};
+// ---------------------------------------------------------------------------
+// Constructors per kind
+// ---------------------------------------------------------------------------
+function makeError(kind, code, message, cause, metadata, suggestion) {
+    const base = { kind, code, message, cause };
+    if (suggestion) {
+        const withSuggestion = { ...base, suggestion };
+        if (metadata)
+            return { ...withSuggestion, metadata };
+        return withSuggestion;
+    }
+    if (metadata)
+        return { ...base, metadata };
+    return base;
+}
+/** Create an error for a failed kernel kernel operation.
+ *
+ * @param code - Error code identifying the failure.
+ * @param message - Human-readable error message.
+ * @param cause - Optional underlying cause of the error.
+ * @param metadata - Optional structured metadata attached to the error.
+ * @param suggestion - Optional actionable suggestion for resolving the error.
+ * @returns The constructed {@link BrepError}.
+ */
+export function kernelError(code, message, cause, metadata, suggestion) {
+    return makeError('KERNEL_OPERATION', code, message, cause, metadata, suggestion);
+}
+/** Create an error for invalid input parameters.
+ *
+ * @param code - Error code identifying the failure.
+ * @param message - Human-readable error message.
+ * @param cause - Optional underlying cause of the error.
+ * @param metadata - Optional structured metadata attached to the error.
+ * @param suggestion - Optional actionable suggestion for resolving the error.
+ * @returns The constructed {@link BrepError}.
+ */
+export function validationError(code, message, cause, metadata, suggestion) {
+    return makeError('VALIDATION', code, message, cause, metadata, suggestion);
+}
+/** Create an error for a failed shape type cast or conversion.
+ *
+ * @param code - Error code identifying the failure.
+ * @param message - Human-readable error message.
+ * @param cause - Optional underlying cause of the error.
+ * @param metadata - Optional structured metadata attached to the error.
+ * @param suggestion - Optional actionable suggestion for resolving the error.
+ * @returns The constructed {@link BrepError}.
+ */
+export function typeCastError(code, message, cause, metadata, suggestion) {
+    return makeError('TYPE_CAST', code, message, cause, metadata, suggestion);
+}
+/** Create an error for an invalid sketcher state transition.
+ *
+ * @param code - Error code identifying the failure.
+ * @param message - Human-readable error message.
+ * @param cause - Optional underlying cause of the error.
+ * @param metadata - Optional structured metadata attached to the error.
+ * @param suggestion - Optional actionable suggestion for resolving the error.
+ * @returns The constructed {@link BrepError}.
+ */
+export function sketcherStateError(code, message, cause, metadata, suggestion) {
+    return makeError('SKETCHER_STATE', code, message, cause, metadata, suggestion);
+}
+/** Create an error for a module initialisation failure.
+ *
+ * @param code - Error code identifying the failure.
+ * @param message - Human-readable error message.
+ * @param cause - Optional underlying cause of the error.
+ * @param metadata - Optional structured metadata attached to the error.
+ * @param suggestion - Optional actionable suggestion for resolving the error.
+ * @returns The constructed {@link BrepError}.
+ */
+export function moduleInitError(code, message, cause, metadata, suggestion) {
+    return makeError('MODULE_INIT', code, message, cause, metadata, suggestion);
+}
+/** Create an error for a failed geometric computation.
+ *
+ * @param code - Error code identifying the failure.
+ * @param message - Human-readable error message.
+ * @param cause - Optional underlying cause of the error.
+ * @param metadata - Optional structured metadata attached to the error.
+ * @param suggestion - Optional actionable suggestion for resolving the error.
+ * @returns The constructed {@link BrepError}.
+ */
+export function computationError(code, message, cause, metadata, suggestion) {
+    return makeError('COMPUTATION', code, message, cause, metadata, suggestion);
+}
+/** Create an error for a file import/export failure.
+ *
+ * @param code - Error code identifying the failure.
+ * @param message - Human-readable error message.
+ * @param cause - Optional underlying cause of the error.
+ * @param metadata - Optional structured metadata attached to the error.
+ * @param suggestion - Optional actionable suggestion for resolving the error.
+ * @returns The constructed {@link BrepError}.
+ */
+export function ioError(code, message, cause, metadata, suggestion) {
+    return makeError('IO', code, message, cause, metadata, suggestion);
+}
+/** Create an error for a shape query failure (e.g. finder not unique).
+ *
+ * @param code - Error code identifying the failure.
+ * @param message - Human-readable error message.
+ * @param cause - Optional underlying cause of the error.
+ * @param metadata - Optional structured metadata attached to the error.
+ * @param suggestion - Optional actionable suggestion for resolving the error.
+ * @returns The constructed {@link BrepError}.
+ */
+export function queryError(code, message, cause, metadata, suggestion) {
+    return makeError('QUERY', code, message, cause, metadata, suggestion);
+}
+/** Create an error for a capability not supported by the current kernel (ADR-0006 Phase 4).
+ *
+ * @param code - Error code identifying the failure.
+ * @param message - Human-readable error message.
+ * @param cause - Optional underlying cause of the error.
+ * @param metadata - Optional structured metadata attached to the error.
+ * @param suggestion - Optional actionable suggestion for resolving the error.
+ * @returns The constructed {@link BrepError}.
+ */
+export function unsupportedError(code, message, cause, metadata, suggestion) {
+    return makeError('UNSUPPORTED', code, message, cause, metadata, suggestion);
+}
+// Re-export from kernelErrorTranslation for backward compatibility
+export { translateKernelError, getSuggestionForCode } from './kernelErrorTranslation.js';
+// ---------------------------------------------------------------------------
+// Array safety helper
+// ---------------------------------------------------------------------------
+/**
+ * Safe array index access that throws a descriptive {@link BrepBugError} instead
+ * of returning `undefined` when the index is out of bounds.
+ *
+ * Use in place of `arr[i]!` when the caller can prove the index is valid by
+ * construction but TypeScript's `noUncheckedIndexedAccess` still requires a guard.
+ *
+ * @param arr - The array to index into.
+ * @param index - The index to access.
+ * @param context - Optional caller context for the error message (e.g. function name).
+ * @returns The array element at `index`.
+ */
+export function safeIndex(arr, index, context) {
+    if (index < 0 || index >= arr.length) {
+        bug(context ?? 'safeIndex', `Index ${index} is out of bounds (array length ${arr.length})`);
+    }
+    return wasmIndex(arr, index);
+}
+//# sourceMappingURL=errors.js.map

package/dist/result/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/result/errors.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Domain error types and constructors（第一方模块）。\n *\n * 2026-09-25 core-decouple Phase 1：复制自 brepjs `src/core/errors.ts`\n * （同源复制，签名不变）；import 来源改为 core 第一方 `result/` 内模块。\n * Re-exports bug/BrepBugError（Layer 0）for convenience.\n */\n\nimport { bug, BrepBugError } from './bug';\nimport { wasmIndex } from './vec3';\nexport { bug, BrepBugError };\n\n// ---------------------------------------------------------------------------\n// Error kinds\n// ---------------------------------------------------------------------------\n\n/** High-level category for a brepjs error. */\nexport type BrepErrorKind =\n  | 'KERNEL_OPERATION'\n  | 'VALIDATION'\n  | 'TYPE_CAST'\n  | 'SKETCHER_STATE'\n  | 'MODULE_INIT'\n  | 'COMPUTATION'\n  | 'IO'\n  | 'QUERY'\n  | 'UNSUPPORTED';\n\n// ---------------------------------------------------------------------------\n// Error codes — typed constants for all known error code strings\n// ---------------------------------------------------------------------------\n\n/**\n * Typed string constants for all known brepjs error codes, grouped by category.\n *\n * Use these instead of raw strings so that typos are caught at compile time.\n */\nexport const BrepErrorCode = {\n  // kernel operation errors\n  BSPLINE_FAILED: 'BSPLINE_FAILED',\n  FACE_BUILD_FAILED: 'FACE_BUILD_FAILED',\n  WIRE_BUILD_FAILED: 'WIRE_BUILD_FAILED',\n  SWEEP_FAILED: 'SWEEP_FAILED',\n  LOFT_FAILED: 'LOFT_FAILED',\n  FUSE_FAILED: 'FUSE_FAILED',\n  CUT_FAILED: 'CUT_FAILED',\n  HEAL_NO_EFFECT: 'HEAL_NO_EFFECT',\n  BOOLEAN_HAS_ERRORS: 'BOOLEAN_HAS_ERRORS',\n  VARIABLE_FILLET_FAILED: 'VARIABLE_FILLET_FAILED',\n  POSITION_ON_CURVE_FAILED: 'POSITION_ON_CURVE_FAILED',\n  FIX_SHAPE_FAILED: 'FIX_SHAPE_FAILED',\n  SOLID_FROM_SHELL_FAILED: 'SOLID_FROM_SHELL_FAILED',\n  FIX_SELF_INTERSECTION_FAILED: 'FIX_SELF_INTERSECTION_FAILED',\n  MESH_FAILED: 'MESH_FAILED',\n\n  // Validation errors\n  ELLIPSE_RADII: 'ELLIPSE_RADII',\n  FUSE_ALL_EMPTY: 'FUSE_ALL_EMPTY',\n  FILLET_NO_EDGES: 'FILLET_NO_EDGES',\n  CHAMFER_NO_EDGES: 'CHAMFER_NO_EDGES',\n  CHAMFER_ANGLE_NO_EDGES: 'CHAMFER_ANGLE_NO_EDGES',\n  CHAMFER_ANGLE_BAD_DISTANCE: 'CHAMFER_ANGLE_BAD_DISTANCE',\n  CHAMFER_ANGLE_BAD_ANGLE: 'CHAMFER_ANGLE_BAD_ANGLE',\n  BEZIER_MIN_POINTS: 'BEZIER_MIN_POINTS',\n  POLYGON_MIN_POINTS: 'POLYGON_MIN_POINTS',\n  WIRE_NOT_CLOSED: 'WIRE_NOT_CLOSED',\n  FACE_NOT_PLANAR: 'FACE_NOT_PLANAR',\n  ZERO_LENGTH_EXTRUSION: 'ZERO_LENGTH_EXTRUSION',\n  ZERO_TWIST_ANGLE: 'ZERO_TWIST_ANGLE',\n  LOFT_EMPTY: 'LOFT_EMPTY',\n  UNSUPPORTED_PROFILE: 'UNSUPPORTED_PROFILE',\n  UNKNOWN_PLANE: 'UNKNOWN_PLANE',\n  NULL_SHAPE_INPUT: 'NULL_SHAPE_INPUT',\n  INVALID_FILLET_RADIUS: 'INVALID_FILLET_RADIUS',\n  INVALID_CHAMFER_DISTANCE: 'INVALID_CHAMFER_DISTANCE',\n  INVALID_THICKNESS: 'INVALID_THICKNESS',\n  ZERO_OFFSET: 'ZERO_OFFSET',\n  NO_EDGES: 'NO_EDGES',\n  NO_FACES: 'NO_FACES',\n  DRAFT_NO_FACES: 'DRAFT_NO_FACES',\n  DRAFT_INVALID_ANGLE: 'DRAFT_INVALID_ANGLE',\n  DRAFT_NOT_3D: 'DRAFT_NOT_3D',\n  DRAFT_FAILED: 'DRAFT_FAILED',\n\n  // Type cast errors\n  FUSE_NOT_3D: 'FUSE_NOT_3D',\n  CUT_NOT_3D: 'CUT_NOT_3D',\n  INTERSECT_NOT_3D: 'INTERSECT_NOT_3D',\n  FUSE_ALL_NOT_3D: 'FUSE_ALL_NOT_3D',\n  CUT_ALL_NOT_3D: 'CUT_ALL_NOT_3D',\n  LOFT_NOT_3D: 'LOFT_NOT_3D',\n  SWEEP_NOT_3D: 'SWEEP_NOT_3D',\n  REVOLUTION_NOT_3D: 'REVOLUTION_NOT_3D',\n  FILLET_NOT_3D: 'FILLET_NOT_3D',\n  CHAMFER_NOT_3D: 'CHAMFER_NOT_3D',\n  CHAMFER_ANGLE_NOT_3D: 'CHAMFER_ANGLE_NOT_3D',\n  CHAMFER_ANGLE_FAILED: 'CHAMFER_ANGLE_FAILED',\n  CSG_NOT_3D: 'CSG_NOT_3D',\n  SHELL_NOT_3D: 'SHELL_NOT_3D',\n  OFFSET_NOT_3D: 'OFFSET_NOT_3D',\n  NULL_SHAPE: 'NULL_SHAPE',\n  NO_WRAPPER: 'NO_WRAPPER',\n  WELD_NOT_SHELL: 'WELD_NOT_SHELL',\n  SOLID_BUILD_FAILED: 'SOLID_BUILD_FAILED',\n  OFFSET_NOT_WIRE: 'OFFSET_NOT_WIRE',\n  UNKNOWN_SURFACE_TYPE: 'UNKNOWN_SURFACE_TYPE',\n  UNKNOWN_CURVE_TYPE: 'UNKNOWN_CURVE_TYPE',\n  SWEEP_START_NOT_WIRE: 'SWEEP_START_NOT_WIRE',\n  SWEEP_END_NOT_WIRE: 'SWEEP_END_NOT_WIRE',\n\n  // IO errors\n  STEP_EXPORT_FAILED: 'STEP_EXPORT_FAILED',\n  STEP_EXPORT_CONFIGURED_FAILED: 'STEP_EXPORT_CONFIGURED_FAILED',\n  STEP_FILE_READ_ERROR: 'STEP_FILE_READ_ERROR',\n  STEP_EXPORT_CRASHED: 'STEP_EXPORT_CRASHED',\n  STEP_EXPORT_UNSERIALIZABLE: 'STEP_EXPORT_UNSERIALIZABLE',\n  STL_EXPORT_FAILED: 'STL_EXPORT_FAILED',\n  STL_FILE_READ_ERROR: 'STL_FILE_READ_ERROR',\n  STL_EXPORT_CRASHED: 'STL_EXPORT_CRASHED',\n  STL_EXPORT_UNSERIALIZABLE: 'STL_EXPORT_UNSERIALIZABLE',\n  STEP_IMPORT_FAILED: 'STEP_IMPORT_FAILED',\n  STL_IMPORT_FAILED: 'STL_IMPORT_FAILED',\n  IGES_EXPORT_FAILED: 'IGES_EXPORT_FAILED',\n  IGES_IMPORT_FAILED: 'IGES_IMPORT_FAILED',\n  DXF_IMPORT_FAILED: 'DXF_IMPORT_FAILED',\n  OBJ_IMPORT_FAILED: 'OBJ_IMPORT_FAILED',\n  THREEMF_IMPORT_FAILED: 'THREEMF_IMPORT_FAILED',\n\n  // Computation errors\n  PARAMETER_NOT_FOUND: 'PARAMETER_NOT_FOUND',\n  INTERSECTION_FAILED: 'INTERSECTION_FAILED',\n  SELF_INTERSECTION_FAILED: 'SELF_INTERSECTION_FAILED',\n  STRAIGHT_SKELETON_FAILED: 'STRAIGHT_SKELETON_FAILED',\n  CENTER_OF_MASS_FAILED: 'CENTER_OF_MASS_FAILED',\n\n  // Compound operation errors\n  COMPOUND_NO_FACES: 'COMPOUND_NO_FACES',\n  COMPOUND_FACE_NOT_FOUND: 'COMPOUND_FACE_NOT_FOUND',\n\n  // Query errors\n  FINDER_NOT_UNIQUE: 'FINDER_NOT_UNIQUE',\n\n  // Hull errors\n  HULL_EMPTY_INPUT: 'HULL_EMPTY_INPUT',\n  HULL_FAILED: 'HULL_FAILED',\n  HULL_DEGENERATE: 'HULL_DEGENERATE',\n  HULL_NOT_3D: 'HULL_NOT_3D',\n\n  // Minkowski errors\n  MINKOWSKI_FAILED: 'MINKOWSKI_FAILED',\n  MINKOWSKI_NULL_TOOL: 'MINKOWSKI_NULL_TOOL',\n  MINKOWSKI_NOT_3D: 'MINKOWSKI_NOT_3D',\n\n  // Polyhedron errors\n  POLYHEDRON_INSUFFICIENT_POINTS: 'POLYHEDRON_INSUFFICIENT_POINTS',\n  POLYHEDRON_INSUFFICIENT_FACES: 'POLYHEDRON_INSUFFICIENT_FACES',\n  POLYHEDRON_INVALID_INDEX: 'POLYHEDRON_INVALID_INDEX',\n  POLYHEDRON_FAILED: 'POLYHEDRON_FAILED',\n\n  // General validation errors\n  VALIDATION_FAILED: 'VALIDATION_FAILED',\n\n  // Roof errors\n  ROOF_FAILED: 'ROOF_FAILED',\n\n  // Multi-section sweep errors\n  MULTI_SWEEP_INSUFFICIENT_SECTIONS: 'MULTI_SWEEP_INSUFFICIENT_SECTIONS',\n  MULTI_SWEEP_FAILED: 'MULTI_SWEEP_FAILED',\n\n  // Guide curve sweep errors\n  GUIDED_SWEEP_FAILED: 'GUIDED_SWEEP_FAILED',\n\n  // Surface errors\n  SURFACE_GRID_TOO_SMALL: 'SURFACE_GRID_TOO_SMALL',\n  SURFACE_GRID_JAGGED: 'SURFACE_GRID_JAGGED',\n  SURFACE_FAILED: 'SURFACE_FAILED',\n\n  // Assembly mate errors\n  ASSEMBLY_MATE_INVALID: 'ASSEMBLY_MATE_INVALID',\n  ASSEMBLY_SOLVE_FAILED: 'ASSEMBLY_SOLVE_FAILED',\n  ASSEMBLY_NOT_CONVERGED: 'ASSEMBLY_NOT_CONVERGED',\n\n  // Blueprint / CompoundBlueprint errors\n  BLUEPRINT_EMPTY_CURVES: 'BLUEPRINT_EMPTY_CURVES',\n  COMPOUND_BLUEPRINT_EMPTY: 'COMPOUND_BLUEPRINT_EMPTY',\n\n  // GLB/glTF import errors\n  GLB_IMPORT_FAILED: 'GLB_IMPORT_FAILED',\n\n  // Font/text errors\n  FONT_FETCH_FAILED: 'FONT_FETCH_FAILED',\n  FONT_PARSE_FAILED: 'FONT_PARSE_FAILED',\n  NO_FONT_LOADED: 'NO_FONT_LOADED',\n\n  // 2D curve geometry errors\n  CURVE2D_CONSTRUCTION_FAILED: 'CURVE2D_CONSTRUCTION_FAILED',\n  CURVE2D_INVALID_RADIUS: 'CURVE2D_INVALID_RADIUS',\n  CURVE2D_TRANSFORM_FAILED: 'CURVE2D_TRANSFORM_FAILED',\n  CURVE2D_QUERY_FAILED: 'CURVE2D_QUERY_FAILED',\n  CURVE2D_INTERSECTION_FAILED: 'CURVE2D_INTERSECTION_FAILED',\n  CURVE2D_BRIDGE_FAILED: 'CURVE2D_BRIDGE_FAILED',\n\n  // Shape identity errors\n  CLONE_FAILED: 'CLONE_FAILED',\n  SIMPLIFY_FAILED: 'SIMPLIFY_FAILED',\n  TO_BREP_FAILED: 'TO_BREP_FAILED',\n\n  // Unsupported capability errors (ADR-0006 Phase 4)\n  UNSUPPORTED_CAPABILITY: 'UNSUPPORTED_CAPABILITY',\n} as const;\n\n/** Union of all known error code string literals. */\nexport type BrepErrorCode = (typeof BrepErrorCode)[keyof typeof BrepErrorCode];\n\n// ---------------------------------------------------------------------------\n// Error interface\n// ---------------------------------------------------------------------------\n\n/**\n * Structured error returned inside `Result<T>` on failure.\n *\n * Every error carries a `kind` (category), a machine-readable `code`,\n * and a human-readable `message`. Optional `cause` preserves the\n * original exception, and `metadata` holds extra context.\n *\n * The optional `suggestion` field provides actionable recovery hints.\n */\nexport interface BrepError {\n  readonly kind: BrepErrorKind;\n  readonly code: string;\n  readonly message: string;\n  readonly suggestion?: string;\n  readonly cause?: unknown;\n  readonly metadata?: Readonly<Record<string, unknown>>;\n}\n\n// ---------------------------------------------------------------------------\n// Constructors per kind\n// ---------------------------------------------------------------------------\n\nfunction makeError(\n  kind: BrepErrorKind,\n  code: string,\n  message: string,\n  cause?: unknown,\n  metadata?: Record<string, unknown>,\n  suggestion?: string\n): BrepError {\n  const base: BrepError = { kind, code, message, cause };\n  if (suggestion) {\n    const withSuggestion = { ...base, suggestion };\n    if (metadata) return { ...withSuggestion, metadata };\n    return withSuggestion;\n  }\n  if (metadata) return { ...base, metadata };\n  return base;\n}\n\n/** Create an error for a failed kernel kernel operation.\n *\n * @param code - Error code identifying the failure.\n * @param message - Human-readable error message.\n * @param cause - Optional underlying cause of the error.\n * @param metadata - Optional structured metadata attached to the error.\n * @param suggestion - Optional actionable suggestion for resolving the error.\n * @returns The constructed {@link BrepError}.\n */\nexport function kernelError(\n  code: string,\n  message: string,\n  cause?: unknown,\n  metadata?: Record<string, unknown>,\n  suggestion?: string\n): BrepError {\n  return makeError('KERNEL_OPERATION', code, message, cause, metadata, suggestion);\n}\n\n/** Create an error for invalid input parameters.\n *\n * @param code - Error code identifying the failure.\n * @param message - Human-readable error message.\n * @param cause - Optional underlying cause of the error.\n * @param metadata - Optional structured metadata attached to the error.\n * @param suggestion - Optional actionable suggestion for resolving the error.\n * @returns The constructed {@link BrepError}.\n */\nexport function validationError(\n  code: string,\n  message: string,\n  cause?: unknown,\n  metadata?: Record<string, unknown>,\n  suggestion?: string\n): BrepError {\n  return makeError('VALIDATION', code, message, cause, metadata, suggestion);\n}\n\n/** Create an error for a failed shape type cast or conversion.\n *\n * @param code - Error code identifying the failure.\n * @param message - Human-readable error message.\n * @param cause - Optional underlying cause of the error.\n * @param metadata - Optional structured metadata attached to the error.\n * @param suggestion - Optional actionable suggestion for resolving the error.\n * @returns The constructed {@link BrepError}.\n */\nexport function typeCastError(\n  code: string,\n  message: string,\n  cause?: unknown,\n  metadata?: Record<string, unknown>,\n  suggestion?: string\n): BrepError {\n  return makeError('TYPE_CAST', code, message, cause, metadata, suggestion);\n}\n\n/** Create an error for an invalid sketcher state transition.\n *\n * @param code - Error code identifying the failure.\n * @param message - Human-readable error message.\n * @param cause - Optional underlying cause of the error.\n * @param metadata - Optional structured metadata attached to the error.\n * @param suggestion - Optional actionable suggestion for resolving the error.\n * @returns The constructed {@link BrepError}.\n */\nexport function sketcherStateError(\n  code: string,\n  message: string,\n  cause?: unknown,\n  metadata?: Record<string, unknown>,\n  suggestion?: string\n): BrepError {\n  return makeError('SKETCHER_STATE', code, message, cause, metadata, suggestion);\n}\n\n/** Create an error for a module initialisation failure.\n *\n * @param code - Error code identifying the failure.\n * @param message - Human-readable error message.\n * @param cause - Optional underlying cause of the error.\n * @param metadata - Optional structured metadata attached to the error.\n * @param suggestion - Optional actionable suggestion for resolving the error.\n * @returns The constructed {@link BrepError}.\n */\nexport function moduleInitError(\n  code: string,\n  message: string,\n  cause?: unknown,\n  metadata?: Record<string, unknown>,\n  suggestion?: string\n): BrepError {\n  return makeError('MODULE_INIT', code, message, cause, metadata, suggestion);\n}\n\n/** Create an error for a failed geometric computation.\n *\n * @param code - Error code identifying the failure.\n * @param message - Human-readable error message.\n * @param cause - Optional underlying cause of the error.\n * @param metadata - Optional structured metadata attached to the error.\n * @param suggestion - Optional actionable suggestion for resolving the error.\n * @returns The constructed {@link BrepError}.\n */\nexport function computationError(\n  code: string,\n  message: string,\n  cause?: unknown,\n  metadata?: Record<string, unknown>,\n  suggestion?: string\n): BrepError {\n  return makeError('COMPUTATION', code, message, cause, metadata, suggestion);\n}\n\n/** Create an error for a file import/export failure.\n *\n * @param code - Error code identifying the failure.\n * @param message - Human-readable error message.\n * @param cause - Optional underlying cause of the error.\n * @param metadata - Optional structured metadata attached to the error.\n * @param suggestion - Optional actionable suggestion for resolving the error.\n * @returns The constructed {@link BrepError}.\n */\nexport function ioError(\n  code: string,\n  message: string,\n  cause?: unknown,\n  metadata?: Record<string, unknown>,\n  suggestion?: string\n): BrepError {\n  return makeError('IO', code, message, cause, metadata, suggestion);\n}\n\n/** Create an error for a shape query failure (e.g. finder not unique).\n *\n * @param code - Error code identifying the failure.\n * @param message - Human-readable error message.\n * @param cause - Optional underlying cause of the error.\n * @param metadata - Optional structured metadata attached to the error.\n * @param suggestion - Optional actionable suggestion for resolving the error.\n * @returns The constructed {@link BrepError}.\n */\nexport function queryError(\n  code: string,\n  message: string,\n  cause?: unknown,\n  metadata?: Record<string, unknown>,\n  suggestion?: string\n): BrepError {\n  return makeError('QUERY', code, message, cause, metadata, suggestion);\n}\n\n/** Create an error for a capability not supported by the current kernel (ADR-0006 Phase 4).\n *\n * @param code - Error code identifying the failure.\n * @param message - Human-readable error message.\n * @param cause - Optional underlying cause of the error.\n * @param metadata - Optional structured metadata attached to the error.\n * @param suggestion - Optional actionable suggestion for resolving the error.\n * @returns The constructed {@link BrepError}.\n */\nexport function unsupportedError(\n  code: string,\n  message: string,\n  cause?: unknown,\n  metadata?: Record<string, unknown>,\n  suggestion?: string\n): BrepError {\n  return makeError('UNSUPPORTED', code, message, cause, metadata, suggestion);\n}\n\n// Re-export from kernelErrorTranslation for backward compatibility\nexport { translateKernelError, getSuggestionForCode } from './kernelErrorTranslation';\n\n// ---------------------------------------------------------------------------\n// Array safety helper\n// ---------------------------------------------------------------------------\n\n/**\n * Safe array index access that throws a descriptive {@link BrepBugError} instead\n * of returning `undefined` when the index is out of bounds.\n *\n * Use in place of `arr[i]!` when the caller can prove the index is valid by\n * construction but TypeScript's `noUncheckedIndexedAccess` still requires a guard.\n *\n * @param arr - The array to index into.\n * @param index - The index to access.\n * @param context - Optional caller context for the error message (e.g. function name).\n * @returns The array element at `index`.\n */\nexport function safeIndex<T>(arr: readonly T[], index: number, context?: string): T {\n  if (index < 0 || index >= arr.length) {\n    bug(context ?? 'safeIndex', `Index ${index} is out of bounds (array length ${arr.length})`);\n  }\n  return wasmIndex(arr, index);\n}\n"]}

package/dist/result/kernelErrorTranslation.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Kernel error translation — maps cryptic kernel messages to user-friendly explanations.
+ *
+ * 第一方模块（2026-09-25 core-decouple Phase 1）：复制自 brepjs
+ * `src/core/kernelErrorTranslation.ts`（同源复制，签名不变）。
+ */
+/** Look up an actionable suggestion for a given error code.
+ *
+ * @param code - The error code to look up.
+ * @returns The suggestion for the code, or undefined if none is registered.
+ */
+export declare function getSuggestionForCode(code: string): string | undefined;
+/**
+ * Translate an kernel error message into a user-friendly explanation.
+ * If no pattern matches, returns the original message.
+ *
+ * @param kernelMessage - The raw error message from kernel
+ * @returns User-friendly error message with actionable guidance
+ */
+export declare function translateKernelError(kernelMessage: string): string;
+//# sourceMappingURL=kernelErrorTranslation.d.ts.map

package/dist/result/kernelErrorTranslation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernelErrorTranslation.d.ts","sourceRoot":"","sources":["../../src/result/kernelErrorTranslation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoGH;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAErE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAQlE"}

package/dist/result/kernelErrorTranslation.js

@@ -0,0 +1,102 @@
+/**
+ * Kernel error translation — maps cryptic kernel messages to user-friendly explanations.
+ *
+ * 第一方模块（2026-09-25 core-decouple Phase 1）：复制自 brepjs
+ * `src/core/kernelErrorTranslation.ts`（同源复制，签名不变）。
+ */
+/**
+ * Common kernel error patterns and their user-friendly translations.
+ * Used by kernelCall to provide actionable error messages.
+ */
+const kernel_ERROR_PATTERNS = [
+    {
+        pattern: /invalid edge configuration|edges?.*(not|fail|invalid)/i,
+        translation: 'The edges may not form a continuous loop. Check that edges connect end-to-end without gaps.',
+    },
+    {
+        pattern: /BRepAlgoAPI.*failed|boolean.*operation.*failed/i,
+        translation: 'Boolean operation failed. Common causes: overlapping faces, zero-thickness geometry, or degenerate shapes. Try healing input shapes first.',
+    },
+    {
+        pattern: /fillet.*radius.*too.*large|fillet.*failed/i,
+        translation: 'Fillet operation failed. The radius may be too large for the selected edges. Try reducing the radius or check that edges have enough room.',
+    },
+    {
+        pattern: /chamfer.*failed|chamfer.*distance.*too.*large/i,
+        translation: 'Chamfer operation failed. The distance may be too large for the selected edges. Try reducing the distance or check edge geometry.',
+    },
+    {
+        pattern: /shell.*failed|offset.*failed/i,
+        translation: 'Shell/offset operation failed. The thickness may be too large, or the shape may have complex geometry. Try reducing thickness.',
+    },
+    {
+        pattern: /sweep.*failed|pipe.*failed/i,
+        translation: 'Sweep operation failed. Check that the profile and spine are compatible, and that the spine has no sharp twists or self-intersections.',
+    },
+    {
+        pattern: /loft.*failed/i,
+        translation: 'Loft operation failed. Profiles may be incompatible or have different orientations. Ensure profiles are ordered consistently.',
+    },
+    {
+        pattern: /extrude.*failed|prism.*failed/i,
+        translation: 'Extrusion failed. The profile may be invalid or self-intersecting. Check that the profile forms a valid closed wire.',
+    },
+    {
+        pattern: /revolve.*failed|revolution.*failed/i,
+        translation: 'Revolution operation failed. The profile may intersect the axis of revolution, or the angle may be invalid.',
+    },
+    {
+        pattern: /self.*intersect|self-intersect/i,
+        translation: 'Shape has self-intersections. The operation resulted in overlapping geometry. Simplify the input or adjust parameters.',
+    },
+    {
+        pattern: /degener|degenerat/i,
+        translation: 'Degenerate geometry detected. The shape has edges or faces with zero length/area. Check input geometry for collapsed elements.',
+    },
+    {
+        pattern: /BRepCheck.*fail|shape.*invalid|shape.*not.*valid/i,
+        translation: 'Shape validation failed. The resulting shape has invalid topology. Try healing the shape or checking input geometry.',
+    },
+];
+// ---------------------------------------------------------------------------
+// Per-error-code suggestions — actionable hints for the `suggestion` field
+// ---------------------------------------------------------------------------
+const ERROR_CODE_SUGGESTIONS = {
+    FUSE_FAILED: 'Try autoHeal() on both operands before the boolean operation. Check for overlapping faces or zero-thickness geometry.',
+    CUT_FAILED: 'Try autoHeal() on both operands before the boolean operation. Check for overlapping faces or zero-thickness geometry.',
+    FUSE_NOT_3D: 'The boolean result was not a 3D solid. Ensure both input shapes are valid 3D solids, not shells or open surfaces.',
+    CUT_NOT_3D: 'The boolean result was not a 3D solid. Ensure both input shapes are valid 3D solids, not shells or open surfaces.',
+    INTERSECT_NOT_3D: 'The boolean result was not a 3D solid. Ensure both input shapes are valid 3D solids, not shells or open surfaces.',
+    SWEEP_FAILED: 'Ensure the spine curve has no sharp corners or self-intersections. Try simplifying the profile or using a smoother path.',
+    LOFT_FAILED: 'Check that all profiles have the same number of edges and consistent orientation. Try reordering profiles.',
+    FILLET_NOT_3D: 'The fillet radius may be too large for the selected edges. Try a smaller radius or check that adjacent faces have enough room.',
+    CHAMFER_NOT_3D: 'The chamfer distance may be too large. Try a smaller distance or check edge geometry.',
+    SHELL_NOT_3D: 'The shell thickness may be too large for the shape. Try reducing thickness or removing problematic faces.',
+    OFFSET_NOT_3D: 'The offset distance may be too large for the shape geometry. Try a smaller distance.',
+    DRAFT_FAILED: 'The draft angle may be too large or the selected faces incompatible. Try a smaller angle or different faces.',
+};
+/** Look up an actionable suggestion for a given error code.
+ *
+ * @param code - The error code to look up.
+ * @returns The suggestion for the code, or undefined if none is registered.
+ */
+export function getSuggestionForCode(code) {
+    return ERROR_CODE_SUGGESTIONS[code];
+}
+/**
+ * Translate an kernel error message into a user-friendly explanation.
+ * If no pattern matches, returns the original message.
+ *
+ * @param kernelMessage - The raw error message from kernel
+ * @returns User-friendly error message with actionable guidance
+ */
+export function translateKernelError(kernelMessage) {
+    for (const { pattern, translation } of kernel_ERROR_PATTERNS) {
+        if (pattern.test(kernelMessage)) {
+            return `${translation} (kernel: ${kernelMessage})`;
+        }
+    }
+    // No pattern matched — return original message
+    return kernelMessage;
+}
+//# sourceMappingURL=kernelErrorTranslation.js.map

package/dist/result/kernelErrorTranslation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernelErrorTranslation.js","sourceRoot":"","sources":["../../src/result/kernelErrorTranslation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,qBAAqB,GAA4D;IACrF;QACE,OAAO,EAAE,wDAAwD;QACjE,WAAW,EACT,6FAA6F;KAChG;IACD;QACE,OAAO,EAAE,iDAAiD;QAC1D,WAAW,EACT,4IAA4I;KAC/I;IACD;QACE,OAAO,EAAE,4CAA4C;QACrD,WAAW,EACT,4IAA4I;KAC/I;IACD;QACE,OAAO,EAAE,gDAAgD;QACzD,WAAW,EACT,mIAAmI;KACtI;IACD;QACE,OAAO,EAAE,+BAA+B;QACxC,WAAW,EACT,gIAAgI;KACnI;IACD;QACE,OAAO,EAAE,6BAA6B;QACtC,WAAW,EACT,wIAAwI;KAC3I;IACD;QACE,OAAO,EAAE,eAAe;QACxB,WAAW,EACT,+HAA+H;KAClI;IACD;QACE,OAAO,EAAE,gCAAgC;QACzC,WAAW,EACT,sHAAsH;KACzH;IACD;QACE,OAAO,EAAE,qCAAqC;QAC9C,WAAW,EACT,6GAA6G;KAChH;IACD;QACE,OAAO,EAAE,iCAAiC;QAC1C,WAAW,EACT,wHAAwH;KAC3H;IACD;QACE,OAAO,EAAE,oBAAoB;QAC7B,WAAW,EACT,gIAAgI;KACnI;IACD;QACE,OAAO,EAAE,mDAAmD;QAC5D,WAAW,EACT,sHAAsH;KACzH;CACF,CAAC;AAEF,8EAA8E;AAC9E,2EAA2E;AAC3E,8EAA8E;AAE9E,MAAM,sBAAsB,GAAqC;IAC/D,WAAW,EACT,uHAAuH;IACzH,UAAU,EACR,uHAAuH;IACzH,WAAW,EACT,mHAAmH;IACrH,UAAU,EACR,mHAAmH;IACrH,gBAAgB,EACd,mHAAmH;IACrH,YAAY,EACV,0HAA0H;IAC5H,WAAW,EACT,4GAA4G;IAC9G,aAAa,EACX,gIAAgI;IAClI,cAAc,EACZ,uFAAuF;IACzF,YAAY,EACV,2GAA2G;IAC7G,aAAa,EACX,sFAAsF;IACxF,YAAY,EACV,8GAA8G;CACjH,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,aAAqB;IACxD,KAAK,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,qBAAqB,EAAE,CAAC;QAC7D,IAAI,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;YAChC,OAAO,GAAG,WAAW,aAAa,aAAa,GAAG,CAAC;QACrD,CAAC;IACH,CAAC;IACD,+CAA+C;IAC/C,OAAO,aAAa,CAAC;AACvB,CAAC","sourcesContent":["/**\n * Kernel error translation — maps cryptic kernel messages to user-friendly explanations.\n *\n * 第一方模块（2026-09-25 core-decouple Phase 1）：复制自 brepjs\n * `src/core/kernelErrorTranslation.ts`（同源复制，签名不变）。\n */\n\n/**\n * Common kernel error patterns and their user-friendly translations.\n * Used by kernelCall to provide actionable error messages.\n */\nconst kernel_ERROR_PATTERNS: ReadonlyArray<{ pattern: RegExp; translation: string }> = [\n  {\n    pattern: /invalid edge configuration|edges?.*(not|fail|invalid)/i,\n    translation:\n      'The edges may not form a continuous loop. Check that edges connect end-to-end without gaps.',\n  },\n  {\n    pattern: /BRepAlgoAPI.*failed|boolean.*operation.*failed/i,\n    translation:\n      'Boolean operation failed. Common causes: overlapping faces, zero-thickness geometry, or degenerate shapes. Try healing input shapes first.',\n  },\n  {\n    pattern: /fillet.*radius.*too.*large|fillet.*failed/i,\n    translation:\n      'Fillet operation failed. The radius may be too large for the selected edges. Try reducing the radius or check that edges have enough room.',\n  },\n  {\n    pattern: /chamfer.*failed|chamfer.*distance.*too.*large/i,\n    translation:\n      'Chamfer operation failed. The distance may be too large for the selected edges. Try reducing the distance or check edge geometry.',\n  },\n  {\n    pattern: /shell.*failed|offset.*failed/i,\n    translation:\n      'Shell/offset operation failed. The thickness may be too large, or the shape may have complex geometry. Try reducing thickness.',\n  },\n  {\n    pattern: /sweep.*failed|pipe.*failed/i,\n    translation:\n      'Sweep operation failed. Check that the profile and spine are compatible, and that the spine has no sharp twists or self-intersections.',\n  },\n  {\n    pattern: /loft.*failed/i,\n    translation:\n      'Loft operation failed. Profiles may be incompatible or have different orientations. Ensure profiles are ordered consistently.',\n  },\n  {\n    pattern: /extrude.*failed|prism.*failed/i,\n    translation:\n      'Extrusion failed. The profile may be invalid or self-intersecting. Check that the profile forms a valid closed wire.',\n  },\n  {\n    pattern: /revolve.*failed|revolution.*failed/i,\n    translation:\n      'Revolution operation failed. The profile may intersect the axis of revolution, or the angle may be invalid.',\n  },\n  {\n    pattern: /self.*intersect|self-intersect/i,\n    translation:\n      'Shape has self-intersections. The operation resulted in overlapping geometry. Simplify the input or adjust parameters.',\n  },\n  {\n    pattern: /degener|degenerat/i,\n    translation:\n      'Degenerate geometry detected. The shape has edges or faces with zero length/area. Check input geometry for collapsed elements.',\n  },\n  {\n    pattern: /BRepCheck.*fail|shape.*invalid|shape.*not.*valid/i,\n    translation:\n      'Shape validation failed. The resulting shape has invalid topology. Try healing the shape or checking input geometry.',\n  },\n];\n\n// ---------------------------------------------------------------------------\n// Per-error-code suggestions — actionable hints for the `suggestion` field\n// ---------------------------------------------------------------------------\n\nconst ERROR_CODE_SUGGESTIONS: Readonly<Record<string, string>> = {\n  FUSE_FAILED:\n    'Try autoHeal() on both operands before the boolean operation. Check for overlapping faces or zero-thickness geometry.',\n  CUT_FAILED:\n    'Try autoHeal() on both operands before the boolean operation. Check for overlapping faces or zero-thickness geometry.',\n  FUSE_NOT_3D:\n    'The boolean result was not a 3D solid. Ensure both input shapes are valid 3D solids, not shells or open surfaces.',\n  CUT_NOT_3D:\n    'The boolean result was not a 3D solid. Ensure both input shapes are valid 3D solids, not shells or open surfaces.',\n  INTERSECT_NOT_3D:\n    'The boolean result was not a 3D solid. Ensure both input shapes are valid 3D solids, not shells or open surfaces.',\n  SWEEP_FAILED:\n    'Ensure the spine curve has no sharp corners or self-intersections. Try simplifying the profile or using a smoother path.',\n  LOFT_FAILED:\n    'Check that all profiles have the same number of edges and consistent orientation. Try reordering profiles.',\n  FILLET_NOT_3D:\n    'The fillet radius may be too large for the selected edges. Try a smaller radius or check that adjacent faces have enough room.',\n  CHAMFER_NOT_3D:\n    'The chamfer distance may be too large. Try a smaller distance or check edge geometry.',\n  SHELL_NOT_3D:\n    'The shell thickness may be too large for the shape. Try reducing thickness or removing problematic faces.',\n  OFFSET_NOT_3D:\n    'The offset distance may be too large for the shape geometry. Try a smaller distance.',\n  DRAFT_FAILED:\n    'The draft angle may be too large or the selected faces incompatible. Try a smaller angle or different faces.',\n};\n\n/** Look up an actionable suggestion for a given error code.\n *\n * @param code - The error code to look up.\n * @returns The suggestion for the code, or undefined if none is registered.\n */\nexport function getSuggestionForCode(code: string): string | undefined {\n  return ERROR_CODE_SUGGESTIONS[code];\n}\n\n/**\n * Translate an kernel error message into a user-friendly explanation.\n * If no pattern matches, returns the original message.\n *\n * @param kernelMessage - The raw error message from kernel\n * @returns User-friendly error message with actionable guidance\n */\nexport function translateKernelError(kernelMessage: string): string {\n  for (const { pattern, translation } of kernel_ERROR_PATTERNS) {\n    if (pattern.test(kernelMessage)) {\n      return `${translation} (kernel: ${kernelMessage})`;\n    }\n  }\n  // No pattern matched — return original message\n  return kernelMessage;\n}\n"]}