kernelcad-features

kernelCAD — edge and face features

For a general edge-break or radius specification, use verify({ check: 'edge-radius', file, min_radius_mm?, max_radius_mm?, require_edge_break?: 'external'|'internal'|'all', edges?, faces? }). It inspects final BREP, reports per-face fillet radii and sharp edges, and treats planar chamfer strips heuristically without claiming a radius. See docs/guide/edge-radius-check.md.

Face refs through operations

Canonical face refs ({ face: 'top' }, etc.) work transparently across transforms (.translate, .rotate, .scale, .reflect, .mirror) and unambiguous booleans (.subtract, .union, .intersect). The kernel walks each face's lineage back to its originating primitive and forward through history.

Two cases produce explicit diagnostics:

• feature.face-ref.ambiguous-after-split — an upstream boolean split the named face into multiple children (e.g., a divider cut splits top into two halves). Geometry-fallback disambiguation is planned for a future release; current workaround: apply the edge/face feature before the splitting operation, or use a query-based selector.
• feature.face-ref.removed — an upstream boolean removed the named face entirely. Reference a different face that still exists in the current shape.
• feature.hole.no-target-face — the hole entry face matched, but no body sits along the bore axis to drill into. Pick an entry face on a different body, or verify the target body extends along the bore axis.
• feature.hole.cut-missing — a bore centre is off the entry face, the depth is zero, or material is still on the bore axis after the cut. The feature fails; it never ships a part with a missing hole. The message gives the face centre, the u/v axes and the u/v span. See "Hole position frame" below.
• feature.created-ref.fallback-used — warning (not error). The created-ref resolver fell back to a geometry-snapshot match after the topology lookup lost the face. The downstream feature still resolves. Lock the ref against future edits by naming the upstream feature with .name() and addressing it by <name>.<slot>.