feat(adminui): TwinCat typed driver page

Adds TwinCATDriverPage.razor (route: /clusters/{id}/drivers/new/twincat) with typed fields for timeout, UseNativeNotifications, EnableControllerBrowse, NotificationMaxDelayMs, probe sub-options (enabled/interval/timeout/admin timeout), and read-only JSON views for Devices and Tags collections. FormModel uses flat settable properties + FromOptions/ToOptions. Also adds TwinCATDriverPageFormSerializationTests (3 tests). Fixes pre-existing placeholder syntax error in AbCipDriverPage.razor (@raw_cpu_type in attribute caused RZ9986).
2026-05-28 09:54:49 -04:00
parent a243cfd126
commit dfbf6793de
3 changed files with 828 additions and 0 deletions
@@ -0,0 +1,98 @@
+using System.Text.Json;
+using System.Text.Json.Serialization;
+using Shouldly;
+using Xunit;
+using ZB.MOM.WW.OtOpcUa.Driver.TwinCAT;
+
+namespace ZB.MOM.WW.OtOpcUa.AdminUI.Tests;
+
+public sealed class TwinCATDriverPageFormSerializationTests
+{
+    private static readonly JsonSerializerOptions _opts = new()
+    {
+        PropertyNamingPolicy = JsonNamingPolicy.CamelCase,
+        WriteIndented = false,
+    };
+
+    [Fact]
+    public void RoundTrip_PreservesKnownFields()
+    {
+        var original = new TwinCATDriverOptions
+        {
+            Timeout = TimeSpan.FromSeconds(4),
+            UseNativeNotifications = false,
+            EnableControllerBrowse = true,
+            NotificationMaxDelayMs = 50,
+            Probe = new TwinCATProbeOptions
+            {
+                Enabled = false,
+                Interval = TimeSpan.FromSeconds(10),
+                Timeout = TimeSpan.FromSeconds(3),
+            },
+            ProbeTimeoutSeconds = 20,
+            Devices = [],
+            Tags = [],
+        };
+
+        var json = JsonSerializer.Serialize(original, _opts);
+        var back = JsonSerializer.Deserialize<TwinCATDriverOptions>(json, _opts);
+
+        back.ShouldNotBeNull();
+        back.Timeout.ShouldBe(TimeSpan.FromSeconds(4));
+        back.UseNativeNotifications.ShouldBeFalse();
+        back.EnableControllerBrowse.ShouldBeTrue();
+        back.NotificationMaxDelayMs.ShouldBe(50);
+        back.Probe.ShouldNotBeNull();
+        back.Probe.Enabled.ShouldBeFalse();
+        back.Probe.Interval.ShouldBe(TimeSpan.FromSeconds(10));
+        back.Probe.Timeout.ShouldBe(TimeSpan.FromSeconds(3));
+        back.ProbeTimeoutSeconds.ShouldBe(20);
+        back.Devices.ShouldBeEmpty();
+        back.Tags.ShouldBeEmpty();
+    }
+
+    [Fact]
+    public void Deserialize_DropsUnknownFields()
+    {
+        var jsonWithExtra = """{"unknownField":"old-value","probeTimeoutSeconds":25}""";
+        var optsSkip = new JsonSerializerOptions(_opts)
+        {
+            UnmappedMemberHandling = JsonUnmappedMemberHandling.Skip,
+        };
+        var back = JsonSerializer.Deserialize<TwinCATDriverOptions>(jsonWithExtra, optsSkip);
+        back.ShouldNotBeNull();
+        back.ProbeTimeoutSeconds.ShouldBe(25);
+    }
+
+    [Fact]
+    public void FormModel_RoundTrip_PreservesEditableFields()
+    {
+        var opts = new TwinCATDriverOptions
+        {
+            Timeout = TimeSpan.FromSeconds(3),
+            UseNativeNotifications = true,
+            EnableControllerBrowse = false,
+            NotificationMaxDelayMs = 100,
+            Probe = new TwinCATProbeOptions
+            {
+                Enabled = true,
+                Interval = TimeSpan.FromSeconds(6),
+                Timeout = TimeSpan.FromSeconds(2),
+            },
+            ProbeTimeoutSeconds = 15,
+        };
+
+        var form = ZB.MOM.WW.OtOpcUa.AdminUI.Components.Pages.Clusters.Drivers
+            .TwinCATDriverPage.FormModel.FromOptions(opts);
+        var roundTripped = form.ToOptions();
+
+        roundTripped.Timeout.ShouldBe(TimeSpan.FromSeconds(3));
+        roundTripped.UseNativeNotifications.ShouldBeTrue();
+        roundTripped.EnableControllerBrowse.ShouldBeFalse();
+        roundTripped.NotificationMaxDelayMs.ShouldBe(100);
+        roundTripped.Probe.Enabled.ShouldBeTrue();
+        roundTripped.Probe.Interval.ShouldBe(TimeSpan.FromSeconds(6));
+        roundTripped.Probe.Timeout.ShouldBe(TimeSpan.FromSeconds(2));
+        roundTripped.ProbeTimeoutSeconds.ShouldBe(15);
+    }
+}