Skip to content

Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel

6.2 KB
Raw Blame

Aetheris Standard Library

The Standard Library is a shipped, curated catalog of typed Firmament product families. Applications discover, describe, and invoke it through Forge Protocol v1; the same invocation produces the STEP loaded by Cadmata and offered for download. Product identities and policy field names are public API and should remain stable within a release line.

Product family Public Template ID Main capabilities
Paperclip Standard.Products.Office.Paperclip WireForm Straight/Bend program, exact circular Sweep, stock/mass evidence, deterministic AP242
Mounting Plate Standard.Products.Mechanical.MountingPlate prismatic stock, four counterbores, PMI
Bearing Block Standard.Products.Mechanical.BearingBlock base, Boss, bore, mounting holes, PMI
Machined Angle Bracket Standard.Products.Mechanical.MachinedAngleBracket prismatic L profile, mounting holes
Shaft Collar Standard.Products.Mechanical.ShaftCollar circular profile, bore
Flanged Adapter Standard.Products.Mechanical.FlangedAdapter circular flange, 4/6/8-hole semantic Pattern, bore PMI
Rack Panel Standard.Products.Electronics.RackPanel planar stock, symmetric mounting holes
Standoff Standard.Products.Mechanical.Standoff circular spacer, clearance bore
Welded Workbench Standard.Structural.WeldedWorkbench structure graph, generated Member/Joint/Weld tables, AP242 assembly, Cut List JSON
Generic Pipe / Elbow90 / Tee Standard.Piping dimensional, non-standards-claim piping product policies
Pump Cooling Skid Standard.Piping.PumpSkid equipment-owned nozzle ports, scoped KeepOut exemptions, endpoint mates, deterministic accepted route, AP242 assembly
Electronics Enclosure Standard.SheetMetal.ElectronicsEnclosure Sheet Metal, DFM, formed STEP, flat STEP, SVG
Gear families compiler-owned PowerTransmission.Gears declarations Spur/internal involute, bounded straight bevel/miter, typed Interface<Gear>, deterministic AP242
Ratchet and pawl compiler-owned PowerTransmission.Ratchets declarations Asymmetric ratchet teeth, pawl/pivot geometry, one-way interface metadata

The namespace taxonomy is intentionally shallow: Standard.Products.Mechanical, .Electronics, and .Office identify ordinary products; Standard.Structural owns structure-first weldments; the existing Standard.SheetMetal namespace remains stable for manufacturing Templates.

Gear families use concise built-in typed declarations rather than Templates because the compiler must own exact tooth construction and finite radial lowering. Their discoverable metadata lives in GearFamilyCatalog; see the Gear Standard Library guide.

Invoke a family

List and describe schemas before binding values:

dotnet run --project Aetheris.Forge.Host -- list
dotnet run --project Aetheris.Forge.Host -- describe Standard.Products.Mechanical.MountingPlate
dotnet run --project Aetheris.Forge.Host -- invoke Standard.Products.Mechanical.MountingPlate --request fixtures/Canonical/Integration/standard-products/mounting-plate.forge.json --out artifacts/local/mounting-plate

The request changes policy data, not geometry logic. Lengths are metric strings such as "120 mm". Forge describe is authoritative for fields, units, constraints, and artifacts. See the Forge interop guide.

Forge resolves each Record parameter's default Static through the Firmament binder. Each described field therefore carries its canonical default, engineering type, unit, and required status when the value is statically available. Static values derived with with are reported after overrides have been applied; unresolved compile-time forms have no invented default. This applies to both Standard.Products.* and the five existing Standard.SheetMetal.* gallery families, so a generic client never needs a parallel engineering-default table.

Use a family from Firmament

Standalone source imports a bounded shipped namespace with Use and keeps family and default identities qualified:

Model MyMountingPlate {
    Units: mm
    Use Standard.Products.Mechanical

    Static MyPolicy = Standard.Products.Mechanical.StandardMountingPlate with {
        Width: 120mm
        Height: 80mm
        Material: "Standard.Materials.Aluminum.6061_T6"
    }

    Struct Plate = Standard.Products.Mechanical.MountingPlate<P: MyPolicy>
}

X1a resolves only the embedded Standard.Products.Mechanical, .Electronics, and .Office modules. Resolution selects named exports from the semantic catalog; it does not read a path or paste an arbitrary file. Fully qualified symbols avoid shadowing. A local declaration colliding with a selected internal export is rejected, as are unknown modules, declarations, or references whose module was not explicitly used. User-defined modules and dependency cycles remain outside this bounded first release.

Authoring model

The authoritative shipped module is Aetheris.Kernel.Firmament/Standard/StandardProducts.firmament. Every family follows Record → Static default → Template<Policy> → Require → semantic geometry. The same embedded source drives Firmament import, Forge discovery/defaults, tests, and Product Gallery controls.

Pattern intent remains in compiler semantic reporting through specialization: identity, source array, generator Template, specialized count, and generated-instance relationships are retained. aetheris inspect <source> --json exposes that inventory under patterns; aetheris build <source> --json includes the same semantic report beside its materialized features. The BRep plan is the deliberate boundary where finite instances become explicit topology. PMI inside one-level and nested Templates is lifted using specialization provenance, bound to the specialized semantic feature, exported to AP242, and checked by reinspection parity.

Compatibility

Template IDs and policy field identities are public API. Additive fields require defaults before they can be non-breaking; removals, renames, type changes, and semantic reinterpretations require an announced compatibility break. Geometry may be corrected without renaming a family when the policy meaning is preserved.