Skip to content

Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel

2.5 KB
Raw Blame

Aetheris Firmament for VS Code

Firmament is Aetheris's canonical, intent-oriented language for mechanical design. This Preview 3 extension recognizes .firmament files, adds TextMate syntax highlighting, comments/brackets, and a focused set of canonical snippets, and delegates validation, STEP build, Cadmata viewing, and verification to the real Aetheris CLI.

Requirements

Install the Aetheris CLI so aetheris is on PATH, or set aetheris.executablePath to the executable. The extension never implements or guesses compiler semantics.

Preview 3 builds are installed from the supplied VSIX: in VS Code run Extensions: Install from VSIX... and select aetheris-firmament-0.3.0-preview.3.vsix.

Commands

  • Aetheris: Validate Firmament runs aetheris validate <file> --json.
  • Aetheris: Build STEP runs aetheris build <file> --json and reports the artifact.
  • Aetheris: View in Cadmata runs aetheris view <file> --json; the CLI owns Cadmata discovery and launch.
  • Aetheris: Verify Model runs aetheris verify <file> --json.

Structured CLI diagnostics populate VS Code Problems. Validate and build remain distinct: unsupported materialization regimes can be build-time diagnostics even when syntax and semantics validate.

aetheris.validateOnSave defaults to true; it launches a short-lived CLI process only when a Firmament file is saved. The extension activates without starting the CLI and creates no daemon. All CLI execution is disabled in untrusted workspaces.

Snippets

Use model, template, box, cylinder, concept-path, profile-from-path, sweep-circular, table-with, profile-delta, hole-shaft, hole-counterbore, hole-countersink, slot-capsule, edgefinish-chamfer, edgefinish-fillet, require, pmi-projection, assert-volume, and inline-step. The Template snippet always emits canonical Template<...> generic syntax. profile-delta is deliberately domain-neutral; the same semantic profile programming applies to ordinary profiles and Sheet Metal owners. sweep-circular emits X0's bounded constant circular section over an existing planar Concept Path.

Preview 3 limits

Syntax highlighting is not capability proof. This extension has no LSP, completion engine, semantic tokens, formatter, hover, navigation, or embedded CAD view. Respect build diagnostics and the frozen capability matrix in the Aetheris manual.

The minimum supported VS Code version is 1.90. This baseline supports the APIs used here without requiring a current editor release.