Skip to content

Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel

Document Firmament V2 source language doctrine

Yuechen Lif8acc1eb4432
diff --git a/Aetheris.CLI.Tests/FirmamentFixtureCorpusTests.cs b/Aetheris.CLI.Tests/FirmamentFixtureCorpusTests.cs
index 09a6b5d6..9b254023 100644
--- a/Aetheris.CLI.Tests/FirmamentFixtureCorpusTests.cs
+++ b/Aetheris.CLI.Tests/FirmamentFixtureCorpusTests.cs
@@ -5,6 +5,8 @@ namespace Aetheris.CLI.Tests;
public sealed class FirmamentFixtureCorpusTests
{
private static readonly string CorpusRoot = Path.GetFullPath(Path.Combine(AppContext.BaseDirectory, "../../../../fixtures/Firmament"));
+ private static readonly string V2CorpusRoot = Path.GetFullPath(Path.Combine(AppContext.BaseDirectory, "../../../../fixtures/FirmamentV2"));
+ private static readonly string V2DoctrinePath = Path.GetFullPath(Path.Combine(AppContext.BaseDirectory, "../../../../docs/air-firmament-a2-firmament-v2-source-language-design.md"));
private static readonly string[] RequiredMetadata = ["fixture-id", "case", "category", "validity", "implementation", "expected", "expected-stage"];
[Fact]
@@ -83,6 +85,64 @@ public sealed class FirmamentFixtureCorpusTests
Assert.Equal("CreateBox", root.GetProperty("featureAir").GetProperty("nodeKind").GetString());
}
+ [Fact]
+ public void FirmamentV1Fixtures_RemainValid()
+ {
+ FirmamentFixtureCorpus_Box_RemainsParserBacked();
+ FirmamentFixtureCorpus_SideHoleGoldenPath_RemainsIntegrated();
+ }
+
+ [Fact]
+ public void FirmamentV2DesignFixtures_MetadataRecognized()
+ {
+ var fixtures = DiscoverV2Fixtures();
+ Assert.Contains(fixtures, p => p.EndsWith("Primitive/valid/box-v2.valid.firmfixture", StringComparison.Ordinal));
+ Assert.Contains(fixtures, p => p.EndsWith("Region/valid/side-hole-v2.valid.firmfixture", StringComparison.Ordinal));
+ Assert.Contains(fixtures, p => p.EndsWith("Shell/future/open-top-box-shell-v2.valid.firmfixture", StringComparison.Ordinal));
+ Assert.Contains(fixtures, p => p.EndsWith("Fillet/future/single-edge-fillet-v2.valid.firmfixture", StringComparison.Ordinal));
+ Assert.Contains(fixtures, p => p.EndsWith("Invalid/invalid-missing-units-v2.invalid.firmfixture", StringComparison.Ordinal));
+
+ foreach (var path in fixtures)
+ {
+ var fixture = LoadMetadata(path);
+ foreach (var key in RequiredMetadata) Assert.True(fixture.ContainsKey(key), $"{path} missing {key}");
+ Assert.Equal("FirmamentV2", fixture["syntax-version"]);
+ Assert.Contains(fixture["validity"], new[] { "valid", "invalid" });
+ Assert.Contains(fixture["implementation"], new[] { "not-implemented", "rejected" });
+ Assert.True(fixture.ContainsKey("expected-diagnostic"), $"{path} missing expected-diagnostic");
+ }
+ }
+
+ [Fact]
+ public void FirmamentV2DesignFixtures_AreNotTreatedAsV1ParseFailures()
+ {
+ foreach (var path in DiscoverV2Fixtures())
+ {
+ using var doc = Trace(path);
+ var root = doc.RootElement;
+ var metadata = LoadMetadata(path);
+ Assert.False(root.GetProperty("fixture").GetProperty("parserBacked").GetBoolean());
+ Assert.True(root.GetProperty("fixture").GetProperty("expectationSatisfied").GetBoolean(), path);
+ Assert.Equal(metadata["expected-stage"], root.GetProperty("actualStageReached").GetString());
+ var diagnostics = root.GetProperty("diagnostics").EnumerateArray().Select(x => x.GetString()).ToArray();
+ Assert.Contains(metadata["expected-diagnostic"], diagnostics);
+ Assert.DoesNotContain("air-x11-firmament-parse-failed", diagnostics);
+ }
+ }
+
+ [Fact]
+ public void FirmamentV2Doctrine_DocsExist()
+ {
+ Assert.True(File.Exists(V2DoctrinePath), V2DoctrinePath);
+ var doc = File.ReadAllText(V2DoctrinePath);
+ Assert.Contains("mostly frozen", doc, StringComparison.OrdinalIgnoreCase);
+ Assert.Contains("canonical human-facing", doc, StringComparison.OrdinalIgnoreCase);
+ Assert.Contains("Feature AIR", doc, StringComparison.Ordinal);
+ Assert.Contains("CIR is not the topology path", doc, StringComparison.Ordinal);
+ Assert.Contains("Boolean", doc, StringComparison.Ordinal);
+ Assert.Contains("not the core language model", doc, StringComparison.OrdinalIgnoreCase);
+ }
+
[Fact]
public void FirmamentFixtureCorpus_DoesNotRequireFeatureImplementation()
{
@@ -131,6 +191,8 @@ public sealed class FirmamentFixtureCorpusTests
private static string[] DiscoverFixtures() => Directory.EnumerateFiles(CorpusRoot, "*.firmfixture", SearchOption.AllDirectories).OrderBy(p => p.Replace('\\', '/'), StringComparer.Ordinal).ToArray();
+ private static string[] DiscoverV2Fixtures() => Directory.EnumerateFiles(V2CorpusRoot, "*.firmfixture", SearchOption.AllDirectories).Select(p => p.Replace('\\', '/')).Order(StringComparer.Ordinal).ToArray();
+
private static JsonDocument Trace(string fixturePath, params string[] extraArgs)
{
var stdout = new StringWriter(); var stderr = new StringWriter();
diff --git a/docs/air-a0-aetheris-v2-compiler-ir-constitution.md b/docs/air-a0-aetheris-v2-compiler-ir-constitution.md
index 1d4d775d..df24a57f 100644
--- a/docs/air-a0-aetheris-v2-compiler-ir-constitution.md
+++ b/docs/air-a0-aetheris-v2-compiler-ir-constitution.md
@@ -53,6 +53,8 @@ Constructive AIR
This document is documentation/design only. It does not implement AIR, change production routes, change BRep topology, change STEP import/export, change Boolean behavior, change CIR evaluation/analyzers, change Firmament behavior, or alter chamfer/fillet/shell geometry.
+Firmament V2 is the canonical human-facing source-language design for this constitution. V2 source is expected to lower through source AST and semantic intent into Feature AIR, then Constructive/Compositional AIR, BRepPlan, BRep, and STEP/artifacts. AIR remains IR, BRep remains the topology/export backend, and CIR remains an optional computational implicit mirror for admitted analysis rather than topology authority. See `docs/air-firmament-a2-firmament-v2-source-language-design.md`.
+
AIR-A1 extends this constitution with **AIR Regions**: scoped construction islands inside AIR for local-frame features whose effects escape only through explicit yields and route-selected parent integration. The doctrine is that different-axis features such as side holes, side pockets, bosses, pattern elements, and future shell/local offset contexts should be represented as scoped local AIR intent first; Boolean remains only one possible admitted backend integration route, not the default representation. See `docs/air-a1-air-regions-scoped-feature-lowering-audit.md`.
## 2. Compiler analogy
diff --git a/docs/air-firmament-a1-firmament-fixture-corpus.md b/docs/air-firmament-a1-firmament-fixture-corpus.md
index 5d7e6fdf..2111cfbb 100644
--- a/docs/air-firmament-a1-firmament-fixture-corpus.md
+++ b/docs/air-firmament-a1-firmament-fixture-corpus.md
@@ -129,3 +129,27 @@ A1 adds `FirmamentFixtureCorpusTests` in `Aetheris.CLI.Tests`, covering metadata
## Next milestone recommendation
Next milestones should pick one narrow future fixture and lower it part-by-part: source parse, semantic intent, Feature AIR, Constructive/Compositional AIR, BRepPlan/BRep evidence, STEP/artifacts, and stable trace diagnostics. Do not admit broad shell, fillet, surfacing, Boolean, arbitrary side-hole, arbitrary face/axis, or CIR topology authority behavior through the corpus metadata path.
+
+## AIR-FIRMAMENT-A2 — Firmament V2 design-fixture policy
+
+Firmament V2 is the canonical future human-facing source language. Firmament V1 remains valid where already supported, but it is legacy TOON/YAML structured syntax, mostly frozen, and primarily useful for the existing corpus, interchange, and historical regression evidence.
+
+A2 introduces metadata-only V2 design fixtures under `fixtures/FirmamentV2/`. These fixtures use record/block-style construction-intent snippets and declare `syntax-version: FirmamentV2`. Until a V2 parser lands, they are deliberately classified by metadata as `not-implemented` or `rejected`; they must not be surfaced as random V1 parser failures.
+
+The intended V2 fixture tree is:
+
+```text
+fixtures/FirmamentV2/
+ Primitive/
+ Profile/
+ Prism/
+ Region/
+ Chamfer/
+ Fillet/
+ Shell/
+ Surfacing/
+ Material/
+ Invalid/
+```
+
+Future features should be written in V2 syntax first, marked not implemented/future-design, and then advanced through parser, semantic intent, Feature AIR, Constructive/Compositional AIR, BRepPlan, BRep, STEP/artifact, and trace stages in narrow milestones. Existing V1 fixtures remain valid in `fixtures/Firmament/` and do not require migration.
diff --git a/docs/air-firmament-a2-firmament-v2-source-language-design.md b/docs/air-firmament-a2-firmament-v2-source-language-design.md
new file mode 100644
index 00000000..b6e68497
--- /dev/null
+++ b/docs/air-firmament-a2-firmament-v2-source-language-design.md
@@ -0,0 +1,360 @@
+# AIR-FIRMAMENT-A2 — Firmament V2 source language design audit
+
+## Purpose
+
+Firmament V2 is the next canonical human-facing Aetheris source language. It is a source language for authoring construction intent: names, units, selections, profiles, regions, feature operations, materials, and traceable feature history. It is not a serialized IR and it is not a backend topology language.
+
+A2 is a design/audit milestone. It defines doctrine, policy, syntax shape, source constructs, lowering expectations, and fixture process. It does not implement a full V2 parser, migrate the corpus, add geometry features, replace production routes, change STEP behavior, change BRep topology behavior, or promote CIR to topology authority.
+
+## Relationship to Firmament V1
+
+```text
+Firmament V1:
+ legacy TOON/YAML structured syntax
+ valid where already supported
+ mostly frozen
+ useful for existing corpus/interchange
+
+Firmament V2:
+ canonical human-facing source language
+ record/block-style
+ construction-intent-first
+ developed through fixtures
+```
+
+Firmament V1 / legacy `.firmament` and `.firmfixture` syntax remains valid where already supported. V1 is useful as corpus, interchange, history, and structured regression evidence. V1 should be considered mostly frozen: maintain it, keep supported fixtures green, and avoid aggressive language expansion through V1 unless a narrow maintenance reason exists.
+
+V2 is not a migration-compatibility exercise. Existing V1 files are not invalidated and do not need immediate migration. Aetheris should not promise broad backward compatibility beyond existing V1 support. V2 should be designed as the natural source-language shape for the corrected Aetheris V2 compiler architecture.
+
+## Why V2 exists
+
+Aetheris originally leaned toward a CSG / 3D primitive-first model. Development corrected that assumption. The architecture is now sweep/profile/ruled/region/construction-first, with AIR generating topology intent and BRep owning explicit topology/export authority.
+
+Firmament V2 exists because the canonical human syntax should express authoring intent directly instead of inheriting a YAML/TOON interchange shape or encouraging raw Boolean trees as the primary mental model.
+
+## Corrected architecture lessons
+
+The architectural doctrine for V2 is:
+
+- AIR is the topology-generating compiler IR.
+- BRepPlan plans explicit topology emission.
+- BRep is explicit topology and STEP/export authority.
+- STEP is an emitted artifact, not construction truth.
+- CIR/FRep is a lower-level computational implicit mirror for evaluation/analysis, effectively analysis-only with respect to topology, not topology authority.
+- CIR-to-BRep as the default path is decompilation/materialization, not normal compilation.
+- Boolean is an admitted route/backend when selected, not the core language model.
+- Aetheris V2 should author sweeps, profiles, ruled transitions, regions, construction operations, and materials before raw primitive CSG expressions.
+
+## Canonical syntax principles
+
+Firmament V2 should follow these principles:
+
+- Source files are construction programs, not serialized IR.
+- Objects have names.
+- Units are explicit.
+- Features are named or traceable.
+- Selections are explicit and semantic.
+- Regions are scoped construction islands.
+- Feature operations express intent.
+- Lowering stages are explicit through trace and diagnostics.
+- Syntax should prefer clarity over token terseness.
+- V2 may use record/block-style constructors.
+- V2 should avoid raw Boolean-tree-first authoring.
+- V2 should not expose BRepPlan/BRep topology mechanics directly.
+- V2 should not expose CIR as topology authority.
+
+## Source-language model
+
+Core source constructs:
+
+- `model` — top-level construction program.
+- `units` — explicit model unit declaration.
+- `solid` — named solid-producing construction result.
+- `profile` — named 2D profile or section.
+- `material` — named material definition.
+- `feature` — traceable source feature when an operation needs an explicit feature identity.
+- `modify` — scoped modification block for an existing named solid.
+- `region` — scoped construction island on/within a selection.
+
+Initial constructors:
+
+- `box`
+- `cylinder`
+- `sphere`
+- `polygon`
+- `rectangle`
+- `extrude`
+- `ruled`
+- `shell`
+
+Initial operations:
+
+- `cut`
+- `add`
+- `chamfer`
+- `fillet`
+- `assign`
+
+Initial selectors:
+
+- `face(+X)`
+- `face(-X)`
+- `face(+Z).outerLoop`
+- `edge(...)`
+- future named selectors such as `edge topFront` or `face mountingFace` once binding rules are designed.
+
+## Proposed canonical syntax shape
+
+These examples are design examples, not parser promises unless a later milestone explicitly marks them implemented.
+
+### A. Box primitive / basic solid
+
+```firmament
+model BoxExample {
+ units mm
+
+ solid base = box {
+ size: [10, 8, 6]
+ }
+}
+```
+
+### B. Profile extrusion
+
+```firmament
+model ProfileExtrudeExample {
+ units mm
+
+ profile section = polygon {
+ points: [
+ [0, 0],
+ [10, 0],
+ [10, 6],
+ [0, 6]
+ ]
+ }
+
+ solid body = extrude section {
+ height: 4
+ direction: +Z
+ }
+}
+```
+
+### C. Ruled / section transition
+
+```firmament
+model RuledTransitionExample {
+ units mm
+
+ profile bottom = rectangle { size: [10, 8] }
+ profile top = rectangle { size: [8, 6] }
+
+ solid body = ruled {
+ from: bottom at z: 0
+ to: top at z: 4
+ }
+}
+```
+
+### D. Side-hole region golden path
+
+```firmament
+model SideHoleExample {
+ units mm
+
+ solid base = box {
+ size: [10, 8, 6]
+ }
+
+ modify base {
+ region sideHole on face(+X) {
+ cut cylinder {
+ radius: 1
+ through: face(-X)
+ }
+ }
+ }
+}
+```
+
+### E. Chamfer
+
+```firmament
+model ChamferExample {
+ units mm
+
+ solid base = box {
+ size: [10, 8, 6]
+ }
+
+ modify base {
+ chamfer face(+Z).outerLoop {
+ distance: 0.5
+ }
+ }
+}
+```
+
+### F. Fillet future design
+
+```firmament
+model FilletExample {
+ units mm
+
+ solid base = box {
+ size: [10, 8, 6]
+ }
+
+ modify base {
+ fillet edge(+X, +Z) {
+ radius: 0.5
+ }
+ }
+}
+```
+
+### G. Shell future design
+
+```firmament
+model OpenTopShellExample {
+ units mm
+
+ solid base = box {
+ size: [10, 8, 6]
+ }
+
+ solid shell = shell base {
+ thickness: 1
+ remove: face(+Z)
+ direction: inward
+ }
+}
+```
+
+### H. Material future design
+
+```firmament
+model MaterialExample {
+ units mm
+
+ solid plate = box {
+ size: [10, 8, 1]
+ }
+
+ material carbon = orthotropic {
+ e1: 120 GPa
+ e2: 8 GPa
+ direction: [1, 0, 0]
+ }
+
+ assign carbon to plate
+}
+```
+
+## Lowering model
+
+Firmament V2 source should lower as:
+
+```text
+FirmamentV2Source
+ -> FirmamentAst
+ -> semantic intent
+ -> Feature AIR
+ -> Constructive / Compositional AIR
+ -> BRepPlan
+ -> BRep
+ -> STEP/artifacts
+```
+
+Optional CIR mirrors are admitted from AIR when a mirror exists and declares its losses:
+
+```text
+Feature AIR / Constructive AIR
+ -> CIR mirror, if available
+```
+
+CIR is not the topology path. V2 source should not lower through CIR as the default route to recover BRep topology.
+
+## Fixture and corpus process
+
+V2 language design should be fixture-driven, compiler-style. Future features should be written in V2 syntax first, marked with explicit implementation state, then advanced through parse, semantic intent, Feature AIR, Constructive/Compositional AIR, BRepPlan, BRep, STEP/artifacts, and trace diagnostics in later milestones.
+
+V2 design fixtures may live under:
+
+```text
+fixtures/FirmamentV2/
+ Primitive/
+ Profile/
+ Prism/
+ Region/
+ Chamfer/
+ Fillet/
+ Shell/
+ Surfacing/
+ Material/
+ Invalid/
+```
+
+V2 fixtures may be classified as:
+
+- `implemented`
+- `not-implemented`
+- `future-design`
+- `invalid`
+
+A2 pilot fixtures are metadata/design fixtures. They must not be treated as random V1 parser failures. Until a V2 parser exists, they should classify as parser-not-ready / future-design / not-implemented / invalid by metadata contract.
+
+Existing V1 fixtures remain valid and may remain in their current locations.
+
+## Initial feature families
+
+Initial V2 design families are:
+
+- primitive/basic solids for continuity and smoke tests;
+- profile and prism constructions;
+- ruled and section-transition constructions;
+- regions for local construction islands such as controlled side holes;
+- chamfer as bounded currently explored feature intent;
+- fillet, shell, surfacing, and materials as future design intent;
+- invalid fixtures for source-contract diagnostics such as missing units.
+
+## Non-goals
+
+A2 explicitly does not introduce:
+
+- full V2 parser;
+- corpus migration;
+- broad feature implementation;
+- new BRep behavior;
+- new STEP behavior;
+- CIR topology authority;
+- Boolean-first language model;
+- production route replacement;
+- general side-hole support;
+- arbitrary face/axis support;
+- shell implementation;
+- fillet implementation;
+- surfacing implementation;
+- broad Boolean backend admission;
+- production Boolean invocation;
+- STEP exporter/importer behavior changes;
+- BRep topology behavior changes;
+- production analyzer/map behavior changes;
+- CIR evaluator/tape behavior changes;
+- route-selection/JudgmentUtility production behavior changes;
+- AirEdgeSweep behavior changes;
+- BrepBoundedChamfer/BrepBoundedFillet behavior changes;
+- triangle migration;
+- NURBS/freeform expansion.
+
+## Next milestones
+
+Recommended next milestones:
+
+1. Define a tiny V2 lexer/parser spike for model/units/basic named constructors without geometry expansion.
+2. Add source diagnostics for missing units, duplicate names, and unsupported V2 constructs.
+3. Lower one V2 parser-backed box fixture to existing Feature AIR without changing backend topology.
+4. Lower one profile extrusion fixture through Feature AIR and existing Constructive AIR/profile emission evidence.
+5. Promote side-hole V2 region syntax from design fixture to semantic intent only, then to AIR Region only, before any materialization expansion.
+6. Keep fillet, shell, surfacing, and material fixtures as future-design until their compiler stages are separately admitted.
diff --git a/docs/air-region-x13-side-hole-golden-path-artifacts.md b/docs/air-region-x13-side-hole-golden-path-artifacts.md
index 61b0e1ff..e809a558 100644
--- a/docs/air-region-x13-side-hole-golden-path-artifacts.md
+++ b/docs/air-region-x13-side-hole-golden-path-artifacts.md
@@ -82,3 +82,7 @@ AIR-REGION-X14 — Controlled side-hole parameter variation. Start with the same
## AIR-FIRMAMENT-A1 corpus status
AIR-FIRMAMENT-A1 promotes the controlled side-hole fixture into the language-level Firmament corpus taxonomy. The fixture remains at `fixtures/Firmament/Region/valid/side-hole-face-attached-region.valid.firmfixture` with explicit metadata for source validity, implementation state, expected lowering stage, integration status, shell closure, STEP smoke, and artifact evidence. This is still the same controlled golden path only: it does not admit general side-hole support, arbitrary face/axis support, production Boolean fallback, CIR topology authority, STEP exporter/importer changes, or BRep topology behavior changes.
+
+## Firmament V2 syntax note
+
+AIR-FIRMAMENT-A2 documents a V2 side-hole region syntax as design-level source shape. That snippet is not parser-backed yet and does not expand the controlled X13 golden path into general side-hole support, arbitrary face/axis support, production Boolean fallback, CIR topology authority, STEP exporter/importer behavior changes, or BRep topology behavior changes.
diff --git a/fixtures/FirmamentV2/Fillet/future/single-edge-fillet-v2.valid.firmfixture b/fixtures/FirmamentV2/Fillet/future/single-edge-fillet-v2.valid.firmfixture
new file mode 100644
index 00000000..9ae9a1dc
--- /dev/null
+++ b/fixtures/FirmamentV2/Fillet/future/single-edge-fillet-v2.valid.firmfixture
@@ -0,0 +1,24 @@
+// fixture-id: single-edge-fillet-v2
+// case: firmament-v2-single-edge-fillet-design
+// category: Fillet
+// syntax-version: FirmamentV2
+// validity: valid
+// implementation: not-implemented
+// expected: valid
+// expected-stage: not-implemented
+// expected-diagnostic: firmament-v2-parser-not-ready
+// notes: AIR-FIRMAMENT-A2 future fillet syntax design; no fillet implementation is introduced.
+
+model FilletExample {
+ units mm
+
+ solid base = box {
+ size: [10, 8, 6]
+ }
+
+ modify base {
+ fillet edge(+X, +Z) {
+ radius: 0.5
+ }
+ }
+}
diff --git a/fixtures/FirmamentV2/Invalid/invalid-missing-units-v2.invalid.firmfixture b/fixtures/FirmamentV2/Invalid/invalid-missing-units-v2.invalid.firmfixture
new file mode 100644
index 00000000..24af5c6e
--- /dev/null
+++ b/fixtures/FirmamentV2/Invalid/invalid-missing-units-v2.invalid.firmfixture
@@ -0,0 +1,16 @@
+// fixture-id: invalid-missing-units-v2
+// case: firmament-v2-invalid-missing-units-design
+// category: Invalid
+// syntax-version: FirmamentV2
+// validity: invalid
+// implementation: rejected
+// expected: invalid
+// expected-stage: rejected
+// expected-diagnostic: firmament-v2-missing-units
+// notes: AIR-FIRMAMENT-A2 invalid V2 design fixture; metadata-only until parser diagnostics land.
+
+model MissingUnitsExample {
+ solid base = box {
+ size: [10, 8, 6]
+ }
+}
diff --git a/fixtures/FirmamentV2/Primitive/valid/box-v2.valid.firmfixture b/fixtures/FirmamentV2/Primitive/valid/box-v2.valid.firmfixture
new file mode 100644
index 00000000..04d033a7
--- /dev/null
+++ b/fixtures/FirmamentV2/Primitive/valid/box-v2.valid.firmfixture
@@ -0,0 +1,18 @@
+// fixture-id: box-v2
+// case: firmament-v2-box-design
+// category: Primitive
+// syntax-version: FirmamentV2
+// validity: valid
+// implementation: not-implemented
+// expected: valid
+// expected-stage: not-implemented
+// expected-diagnostic: firmament-v2-parser-not-ready
+// notes: AIR-FIRMAMENT-A2 metadata-only V2 design fixture; source snippet is canonical-shape design, not parser-backed.
+
+model BoxExample {
+ units mm
+
+ solid base = box {
+ size: [10, 8, 6]
+ }
+}
diff --git a/fixtures/FirmamentV2/Region/valid/side-hole-v2.valid.firmfixture b/fixtures/FirmamentV2/Region/valid/side-hole-v2.valid.firmfixture
new file mode 100644
index 00000000..9118c4d9
--- /dev/null
+++ b/fixtures/FirmamentV2/Region/valid/side-hole-v2.valid.firmfixture
@@ -0,0 +1,27 @@
+// fixture-id: side-hole-v2
+// case: firmament-v2-side-hole-design
+// category: Region
+// syntax-version: FirmamentV2
+// validity: valid
+// implementation: not-implemented
+// expected: valid
+// expected-stage: not-implemented
+// expected-diagnostic: firmament-v2-parser-not-ready
+// notes: AIR-FIRMAMENT-A2 V2 side-hole golden-path syntax design; not general side-hole support and not parser-backed.
+
+model SideHoleExample {
+ units mm
+
+ solid base = box {
+ size: [10, 8, 6]
+ }
+
+ modify base {
+ region sideHole on face(+X) {
+ cut cylinder {
+ radius: 1
+ through: face(-X)
+ }
+ }
+ }
+}
diff --git a/fixtures/FirmamentV2/Shell/future/open-top-box-shell-v2.valid.firmfixture b/fixtures/FirmamentV2/Shell/future/open-top-box-shell-v2.valid.firmfixture
new file mode 100644
index 00000000..dd201e0d
--- /dev/null
+++ b/fixtures/FirmamentV2/Shell/future/open-top-box-shell-v2.valid.firmfixture
@@ -0,0 +1,24 @@
+// fixture-id: open-top-box-shell-v2
+// case: firmament-v2-open-top-shell-design
+// category: Shell
+// syntax-version: FirmamentV2
+// validity: valid
+// implementation: not-implemented
+// expected: valid
+// expected-stage: not-implemented
+// expected-diagnostic: firmament-v2-parser-not-ready
+// notes: AIR-FIRMAMENT-A2 future shell syntax design; no shell implementation is introduced.
+
+model OpenTopShellExample {
+ units mm
+
+ solid base = box {
+ size: [10, 8, 6]
+ }
+
+ solid shell = shell base {
+ thickness: 1
+ remove: face(+Z)
+ direction: inward
+ }
+}