Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel
using Aetheris.Kernel.Firmament.Assembly;
namespace Aetheris.Kernel.Firmament.Tests.Assembly;
public sealed class FirmasmManifestLoaderTests
{
[Fact]
public void LoadFromFile_NativeOnlyManifest_LoadsSuccessfully()
{
var loader = new FirmasmManifestLoader();
var path = FirmamentCorpusHarness.ResolveFixtureFullPath("fixtures/Compatibility/Firmasm/LegacyAssembly/examples/native-only.firmasm");
var result = loader.LoadFromFile(path);
Assert.True(result.IsSuccess, string.Join(Environment.NewLine, result.Diagnostics.Select(d => d.Message)));
Assert.Equal("1", result.Value.Manifest.ManifestVersion);
Assert.Equal("native_demo", result.Value.Manifest.Assembly.Name);
Assert.All(result.Value.LoadedParts.Values, part => Assert.IsType<FirmasmLoadedNativeFirmamentPart>(part));
}
[Fact]
public void LoadFromFile_MixedNativeAndStep_LoadsSuccessfully()
{
var loader = new FirmasmManifestLoader();
var path = FirmamentCorpusHarness.ResolveFixtureFullPath("fixtures/Compatibility/Firmasm/LegacyAssembly/examples/mixed-native-step.firmasm");
var result = loader.LoadFromFile(path);
Assert.True(result.IsSuccess, string.Join(Environment.NewLine, result.Diagnostics.Select(d => d.Message)));
Assert.IsType<FirmasmLoadedNativeFirmamentPart>(result.Value.LoadedParts["base"]);
Assert.IsType<FirmasmLoadedOpaqueStepPart>(result.Value.LoadedParts["vendor_motor"]);
var motorInstance = Assert.Single(result.Value.Manifest.Instances, instance => instance.Id == "motor_1");
Assert.Equal(3, motorInstance.Transform.Translate.Count);
Assert.Equal(3, motorInstance.Transform.RotateDegXyz!.Count);
}
[Fact]
public void Parse_InvalidStructure_RejectsClearly()
{
var loader = new FirmasmManifestLoader();
var path = FirmamentCorpusHarness.ResolveFixtureFullPath("fixtures/Compatibility/Firmasm/LegacyAssembly/fixtures/invalid-structure.firmasm");
var result = loader.LoadFromFile(path);
Assert.False(result.IsSuccess);
var diagnostic = Assert.Single(result.Diagnostics);
Assert.Contains("Missing required section 'instances'", diagnostic.Message, StringComparison.Ordinal);
}
[Fact]
public void LoadFromFile_MissingStep_RejectsClearly()
{
var loader = new FirmasmManifestLoader();
var path = FirmamentCorpusHarness.ResolveFixtureFullPath("fixtures/Compatibility/Firmasm/LegacyAssembly/fixtures/invalid-step-missing-file.firmasm");
var result = loader.LoadFromFile(path);
Assert.False(result.IsSuccess);
var diagnostic = Assert.Single(result.Diagnostics);
Assert.Contains("was not found", diagnostic.Message, StringComparison.Ordinal);
}
[Fact]
public void Parse_RejectsUnknownPartKind()
{
var loader = new FirmasmManifestLoader();
var source = """
{
"manifest": { "version": "1" },
"assembly": { "name": "demo", "units": "mm" },
"parts": {
"base": { "kind": "mesh", "source": "./base.firmament" }
},
"instances": [
{
"id": "base_1",
"part": "base",
"transform": { "translate": [0, 0, 0] }
}
]
}
""";
var result = loader.Parse(source);
Assert.False(result.IsSuccess);
Assert.Contains("Allowed kinds: 'firmament', 'step'", Assert.Single(result.Diagnostics).Message, StringComparison.Ordinal);
}
[Fact]
public void Parse_RejectsInvalidTransformShape()
{
var loader = new FirmasmManifestLoader();
var source = """
{
"manifest": { "version": "1" },
"assembly": { "name": "demo", "units": "mm" },
"parts": {
"base": { "kind": "firmament", "source": "./base.firmament" }
},
"instances": [
{
"id": "base_1",
"part": "base",
"transform": { "translate": [0, 0] }
}
]
}
""";
var result = loader.Parse(source);
Assert.False(result.IsSuccess);
Assert.Contains("exactly 3 numeric values", Assert.Single(result.Diagnostics).Message, StringComparison.Ordinal);
}
[Fact]
public void Parse_RejectsDuplicateInstanceIds()
{
var loader = new FirmasmManifestLoader();
var source = """
{
"manifest": { "version": "1" },
"assembly": { "name": "demo", "units": "mm" },
"parts": {
"base": { "kind": "firmament", "source": "./base.firmament" }
},
"instances": [
{
"id": "base_1",
"part": "base",
"transform": { "translate": [0, 0, 0] }
},
{
"id": "base_1",
"part": "base",
"transform": { "translate": [10, 0, 0] }
}
]
}
""";
var result = loader.Parse(source);
Assert.False(result.IsSuccess);
Assert.Contains("Duplicate instance id 'base_1'", Assert.Single(result.Diagnostics).Message, StringComparison.Ordinal);
}
[Fact]
public void Parse_RejectsUnknownPartReference()
{
var loader = new FirmasmManifestLoader();
var source = """
{
"manifest": { "version": "1" },
"assembly": { "name": "demo", "units": "mm" },
"parts": {
"base": { "kind": "firmament", "source": "./base.firmament" }
},
"instances": [
{
"id": "missing_1",
"part": "missing",
"transform": { "translate": [0, 0, 0] }
}
]
}
""";
var result = loader.Parse(source);
Assert.False(result.IsSuccess);
Assert.Contains("references unknown part 'missing'", Assert.Single(result.Diagnostics).Message, StringComparison.Ordinal);
}
[Fact]
public void LoadFromFile_OcctNutBoltBoltOnly_LoadsSuccessfully()
{
var loader = new FirmasmManifestLoader();
var path = FirmamentCorpusHarness.ResolveFixtureFullPath("fixtures/Compatibility/Firmasm/LegacyAssembly/examples/occt-nut-bolt/bolt-only.firmasm");
var result = loader.LoadFromFile(path);
Assert.True(result.IsSuccess, string.Join(Environment.NewLine, result.Diagnostics.Select(d => d.Message)));
Assert.IsType<FirmasmLoadedOpaqueStepPart>(result.Value.LoadedParts["bolt"]);
}
[Fact]
public void Parse_OcctNutBoltManifest_UsesStepKindsAndRigidTransforms()
{
var loader = new FirmasmManifestLoader();
var path = FirmamentCorpusHarness.ResolveFixtureFullPath("fixtures/Compatibility/Firmasm/LegacyAssembly/examples/occt-nut-bolt/nut-bolt-assembly.firmasm");
var result = loader.Parse(File.ReadAllText(path));
Assert.True(result.IsSuccess, string.Join(Environment.NewLine, result.Diagnostics.Select(d => d.Message)));
Assert.Equal(FirmasmPartKind.Step, result.Value.Parts["bolt"].Kind);
Assert.Equal(FirmasmPartKind.Step, result.Value.Parts["nut"].Kind);
Assert.All(result.Value.Instances, instance => Assert.Equal(3, instance.Transform.Translate.Count));
Assert.All(result.Value.Instances, instance => Assert.Equal(3, instance.Transform.RotateDegXyz!.Count));
}
[Fact]
public void LoadFromFile_OcctNutBoltManifest_LoadsSuccessfully()
{
var loader = new FirmasmManifestLoader();
var path = FirmamentCorpusHarness.ResolveFixtureFullPath("fixtures/Compatibility/Firmasm/LegacyAssembly/examples/occt-nut-bolt/nut-bolt-assembly.firmasm");
var result = loader.LoadFromFile(path);
Assert.True(result.IsSuccess, string.Join(Environment.NewLine, result.Diagnostics.Select(d => d.Message)));
Assert.IsType<FirmasmLoadedOpaqueStepPart>(result.Value.LoadedParts["bolt"]);
Assert.IsType<FirmasmLoadedOpaqueStepPart>(result.Value.LoadedParts["nut"]);
}
[Fact]
public void Parse_OcctLBracketManifest_IsFlatAndDeduplicated()
{
var loader = new FirmasmManifestLoader();
var path = FirmamentCorpusHarness.ResolveFixtureFullPath("fixtures/Compatibility/Firmasm/LegacyAssembly/examples/occt-l-bracket/l-bracket-assembly.firmasm");
var result = loader.Parse(File.ReadAllText(path));
Assert.True(result.IsSuccess, string.Join(Environment.NewLine, result.Diagnostics.Select(d => d.Message)));
Assert.Equal(3, result.Value.Parts.Count);
Assert.Equal(7, result.Value.Instances.Count);
Assert.All(result.Value.Parts.Values, part => Assert.Equal(FirmasmPartKind.Step, part.Kind));
Assert.Equal(3, result.Value.Instances.Count(instance => instance.Part == "part_001_bolt"));
Assert.Equal(3, result.Value.Instances.Count(instance => instance.Part == "part_002_nut"));
Assert.Single(result.Value.Instances, instance => instance.Part == "part_003_l_bracket");
Assert.All(result.Value.Instances, instance => Assert.Equal(3, instance.Transform.Translate.Count));
Assert.All(result.Value.Instances, instance => Assert.Equal(3, instance.Transform.RotateDegXyz!.Count));
}
[Fact]
public void LoadFromFile_OcctLBracketManifest_LoadsSuccessfully()
{
var loader = new FirmasmManifestLoader();
var path = FirmamentCorpusHarness.ResolveFixtureFullPath("fixtures/Compatibility/Firmasm/LegacyAssembly/examples/occt-l-bracket/l-bracket-assembly.firmasm");
var result = loader.LoadFromFile(path);
Assert.True(result.IsSuccess, string.Join(Environment.NewLine, result.Diagnostics.Select(d => d.Message)));
Assert.Equal(3, result.Value.LoadedParts.Count);
Assert.Equal(7, result.Value.Manifest.Instances.Count);
Assert.All(result.Value.LoadedParts.Values, loadedPart => Assert.IsType<FirmasmLoadedOpaqueStepPart>(loadedPart));
}
[Fact]
public void Parse_OcctAs1Manifest_IsFlatAndDeduplicated()
{
var loader = new FirmasmManifestLoader();
var path = FirmamentCorpusHarness.ResolveFixtureFullPath("fixtures/Compatibility/Firmasm/LegacyAssembly/examples/occt-as1/as1-assembly.firmasm");
var result = loader.Parse(File.ReadAllText(path));
Assert.True(result.IsSuccess, string.Join(Environment.NewLine, result.Diagnostics.Select(d => d.Message)));
Assert.Equal(5, result.Value.Parts.Count);
Assert.Equal(18, result.Value.Instances.Count);
Assert.All(result.Value.Parts.Values, part => Assert.Equal(FirmasmPartKind.Step, part.Kind));
Assert.Equal(6, result.Value.Instances.Count(instance => instance.Part == "part_001_bolt"));
Assert.Equal(2, result.Value.Instances.Count(instance => instance.Part == "part_002_l_bracket"));
Assert.Equal(8, result.Value.Instances.Count(instance => instance.Part == "part_003_nut"));
Assert.Equal(1, result.Value.Instances.Count(instance => instance.Part == "part_004_plate"));
Assert.Equal(1, result.Value.Instances.Count(instance => instance.Part == "part_005_rod"));
Assert.All(result.Value.Instances, instance => Assert.Equal(3, instance.Transform.Translate.Count));
Assert.All(result.Value.Instances, instance => Assert.Equal(3, instance.Transform.RotateDegXyz!.Count));
}
[Fact]
public void LoadFromFile_OcctAs1Manifest_LoadsSuccessfully()
{
var loader = new FirmasmManifestLoader();
var path = FirmamentCorpusHarness.ResolveFixtureFullPath("fixtures/Compatibility/Firmasm/LegacyAssembly/examples/occt-as1/as1-assembly.firmasm");
var result = loader.LoadFromFile(path);
Assert.True(result.IsSuccess, string.Join(Environment.NewLine, result.Diagnostics.Select(d => d.Message)));
Assert.Equal(5, result.Value.LoadedParts.Count);
Assert.Equal(18, result.Value.Manifest.Instances.Count);
Assert.All(result.Value.LoadedParts.Values, loadedPart => Assert.IsType<FirmasmLoadedOpaqueStepPart>(loadedPart));
}
}