Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel
Firmament Example Pack
This directory contains small canonical Firmament examples for the current v1 surface.
Placement examples use canonical place.on_face for semantic anchors; place.centered_on remains accepted as a compatibility alias but is normalized by formatter output.
These examples represent the currently supported boolean subset. Other combinations may fail and are intentionally not supported yet.
box_basic.firmament— minimal single-box golden-path example; helper export path:testdata/step242/golden/firmament-v1/box_basic.step.cylinder_basic.firmament— minimal single-cylinder export example; helper export path:testdata/step242/golden/firmament-v1/cylinder_basic.step.cone_frustum_basic.firmament— minimal single frustum-cone export example using the v1coneprimitive; helper export path:testdata/step242/golden/firmament-v1/cone_frustum_basic.step.cone_pointed_top_zero.firmament— minimal single pointed-cone export example using the same v1coneprimitive withtop_radius: 0; helper export path:testdata/step242/golden/firmament-v1/cone_pointed_top_zero.step.sphere_basic.firmament— minimal single-sphere export example; helper export path:testdata/step242/golden/firmament-v1/sphere_basic.step.torus_basic.firmament— minimal single-torus export example using the canonicalmajor_radius/minor_radiussurface; helper export paths:testdata/step242/golden/firmament-v1/torus_basic.stepand the milestone proof artifacttestdata/step242/golden/firmament-v1/m10g2-torus.step.straight_slot_basic.firmament— minimal single straight-slot export example; helper export path:testdata/step242/golden/firmament-v1/straight_slot_basic.step.rounded_corner_box_basic.firmament— minimal single rounded-corner-box export example using Forge-backed rounded-rectangle atomics under StandardLibrary; helper export path:testdata/step242/golden/firmament-v1/rounded_corner_box_basic.step.slot_cut_basic.firmament— minimal single slot-cut export example using the same Forge rounded-rectangle atomic seam under StandardLibrary; helper export path:testdata/step242/golden/firmament-v1/slot_cut_basic.step.library_part_cube_with_hole_basic.firmament— connector-routed standard library reusable part example forstandard_library/cube_with_cylindrical_hole; helper export path:testdata/step242/golden/firmament-v1/library_part_cube_with_hole_basic.step.mcmaster_91180a151_threadless_hex_bolt.firmament— canonical V2Record/Static/Templateinstance routed through the genericStandardPartrecord toStandardLibrary.HexBolt, with an exact conical head treatment, hyperbolic cone/hex trims, semantic thread region, and no modeled threads or markings.composed_part_with_slot.firmament— bounded composability probe combining connector part import (standard_library/cube_with_cylindrical_hole) and lane-routedslot_cutsubtract in one model; currently documents a real bounded-safe-composition blocker rather than a successful export.box_add_basic.firmament— minimal supported box-plus-box boolean add example; helper export path:testdata/step242/golden/firmament-v1/box_add_basic.step.boolean_add_basic.firmament— canonical proven boolean add example for the current box/box single-box subset; helper export path:testdata/step242/golden/firmament-v1/boolean_add_basic.step.ribbed_support_f1.firmament— bounded F1 connected orthogonal add family example for rib/wall-like parts; helper export path:testdata/step242/golden/firmament-v1/ribbed_support_f1.step.boolean_subtract_basic.firmament— canonical proven boolean subtract example for the current box/box single-box subset; helper export path:testdata/step242/golden/firmament-v1/boolean_subtract_basic.step.boolean_intersect_basic.firmament— canonical proven boolean intersect example for the current box/box single-box subset; helper export path:testdata/step242/golden/firmament-v1/boolean_intersect_basic.step.boolean_box_cylinder_hole.firmament— the only supported box+cylinder boolean case: subtracting a Z-aligned cylinder that cleanly spans the full box height to form a single box-with-through-hole solid; helper export path:testdata/step242/golden/firmament-v1/boolean_box_cylinder_hole.step.boolean_box_cone_throughhole_basic.firmament— the narrow supported box+cone boolean case: subtracting a Z-aligned cone that cleanly spans the full box height, keeps both boundary circles strictly inside the box footprint, and reconstructs as one box-with-conical-through-hole solid; helper export path:testdata/step242/golden/firmament-v1/boolean_box_cone_throughhole_basic.step.boolean_two_cylinder_holes_basic.firmament— canonical sequential safe composition case forbox → subtract cylinder → subtract cylinder; helper export path:testdata/step242/golden/firmament-v1/boolean_two_cylinder_holes_basic.step.boolean_cylinder_cone_holes_basic.firmament— canonical sequential safe composition case forbox → subtract cylinder → subtract cone; helper export path:testdata/step242/golden/firmament-v1/boolean_cylinder_cone_holes_basic.step.boolean_box_sphere_cavity_basic.firmament— narrow supportedsubtract(box, sphere)cavity case only: the sphere must remain strictly contained and non-tangent so the result can be reconstructed as one outer shell plus one inner spherical shell; helper export path:testdata/step242/golden/firmament-v1/boolean_box_sphere_cavity_basic.step.placed_primitive.firmament— selector-based placement usingplace.onandoffset[3]; helper export path:testdata/step242/golden/firmament-v1/placed_primitive.step.p1_blind_hole_on_face_semantic.firmament— minimal semantic placement subset example usingplace.on_facefor a blind-hole tool placement.p1_flange_radial_hole_semantic.firmament— minimal semantic placement subset example usingplace.around_axis+place.radial_offsetfor flange radial hole placement.p1_bracket_rib_on_face_semantic.firmament— minimal semantic placement subset example usingplace.on_facefor bracket rib authoring ergonomics.w2_cylinder_root_blind_bore_semantic.firmament— Wave 2.1 canonical cylinder-root blind-bore example (subtract(cylinder_root, cylinder)with top-entry coaxial blind bore) authored with semanticplace.on_face; helper export path:testdata/step242/golden/firmament-v1/w2_cylinder_root_blind_bore_semantic.step.w2_box_sphere_exterior_opening_pocket_semantic.firmament— Wave 2.1 canonical exterior-opening spherical pocket example (subtract(box, sphere)with one-sided opening attop_face) authored with semanticplace.on_face; helper export path:testdata/step242/golden/firmament-v1/w2_box_sphere_exterior_opening_pocket_semantic.step.p2_linear_hole_row.firmament— minimal built-inpattern_linearexample for repeated hole rows.p2_flange_bolt_circle_pattern.firmament— minimal built-inpattern_circularbolt-circle example for flange holes.p2_mirror_hole_pair.firmament— boundedpattern_mirrorexample for principal-plane mirrored hole placement.schema_box_basic.firmament— minimal schema-present export example showing schema presence without changing export body semantics; helper export path:testdata/step242/golden/firmament-v1/schema_box_basic.step.
Unsupported boolean requests are tracked as fixtures/tests, not presented in this working example pack. The supported safe subtract family remains narrow and explicit: subtract(box, cylinder) and subtract(box, cone) still require a Z-aligned tool, full span through the current box shell, non-degenerate boundary circles for cones, and strict in-bounds clearance with no tangent/grazing contact. Forge-style polygonal extrusions (for example rounded-corner boxes / slot-cut solids) now also have a bounded safe-root path for prismatic through-cut subtract continuation, so these roots are no longer immediate left-operand dead ends; containment for that family uses the true polygon footprint, not only the root AABB. Sequential composition is still bounded: analytic follow-on subtracts are pre-validated as safe-hole composition, while non-analytic follow-on tools are now passed through to kernel bounded-family routing for final admissibility/reconstruction diagnostics rather than being rejected by an upstream tool-kind gate. This is not general multi-feature boolean support. The composability probe composed_part_with_slot.firmament is now a successful routed case (subtract(library_part, slot_cut)) and remains useful as a regression check that follow-on prismatic routing reaches kernel execution. Box+cylinder add, box+cylinder intersect, rotated cylinders, partial-depth cuts, tangent/grazing cases, outside-footprint cuts, interfering multi-hole layouts, and unsupported subtract orderings remain unsupported. Box+cone add, box+cone intersect, tilted cones, partial-depth cone cuts, tangent/grazing cone cuts, apex-inside cases, outside-footprint cone cuts, and unsupported mixed-ordering requests remain unsupported. Box+sphere support is still narrow and truth-first: only subtract(box, sphere) with a strictly contained, non-tangent, fully enclosed cavity is supported, reconstructed via one outer shell plus one inner spherical shell. add(box, sphere), intersect(box, sphere), tangent cavity requests, and partially outside sphere requests remain unsupported. Box+torus booleans are currently unsupported in every audited form: subtract(box, torus), add(box, torus), and intersect(box, torus) all fail the real kernel boundary for centered, offset, fully contained, face-intersecting, and outside-footprint torus placements, so no box+torus example is included here. These files are intended to stay minimal, readable, and aligned with the implemented language surface. Export artifacts are kept separately under testdata/step242/golden/firmament-v1/ so examples remain source-only and demo outputs stay easy to find.