feat(uns): TagConfig JSON helper + editor map + TagModal dispatch scaffold (F-uns-1 T2)

2026-06-09 09:22:12 -04:00
parent d9dbd7917a
commit fd9fa75d0e
4 changed files with 223 additions and 5 deletions
@@ -0,0 +1,20 @@
+namespace ZB.MOM.WW.OtOpcUa.AdminUI.Uns.TagEditors;
+
+/// <summary>
+/// Maps a driver's <c>DriverType</c> string to its typed tag-config editor component (mirrors
+/// <c>DriverEditRouter._componentMap</c>). Drivers absent from the map fall back to the generic
+/// raw-JSON textarea in the TagModal.
+/// </summary>
+public static class TagConfigEditorMap
+{
+    private static readonly IReadOnlyDictionary<string, Type> Map =
+        new Dictionary<string, Type>(StringComparer.OrdinalIgnoreCase)
+        {
+            // Editors registered by later tasks, e.g.:
+            // ["ModbusTcp"] = typeof(Components.Shared.Uns.TagEditors.ModbusTagConfigEditor),
+        };
+
+    /// <summary>Returns the editor component type for a driver type, or null if none is registered.</summary>
+    public static Type? Resolve(string? driverType)
+        => driverType is not null && Map.TryGetValue(driverType, out var t) ? t : null;
+}
@@ -0,0 +1,39 @@
+using System.Text.Json;
+using System.Text.Json.Nodes;
+
+namespace ZB.MOM.WW.OtOpcUa.AdminUI.Uns.TagEditors;
+
+/// <summary>
+/// Helpers for per-driver tag-config editors: parse a TagConfig JSON string into a mutable
+/// <see cref="JsonObject"/> (preserving every key, so fields the editor doesn't expose survive a
+/// load→save), read typed scalars, and serialise back.
+/// </summary>
+public static class TagConfigJson
+{
+    /// <summary>Parses <paramref name="json"/> into a mutable object; returns a fresh empty object on null/blank/malformed/non-object input.</summary>
+    public static JsonObject ParseOrNew(string? json)
+    {
+        if (string.IsNullOrWhiteSpace(json)) { return new JsonObject(); }
+        try { return JsonNode.Parse(json) as JsonObject ?? new JsonObject(); }
+        catch (JsonException) { return new JsonObject(); }
+    }
+
+    /// <summary>Serialises the object to compact JSON (JsonNode.ToJsonString() defaults to non-indented).</summary>
+    public static string Serialize(JsonObject obj) => obj.ToJsonString();
+
+    /// <summary>Reads a string value, or null if absent/null/non-string.</summary>
+    public static string? GetString(JsonObject o, string name)
+        => o.TryGetPropertyValue(name, out var n) && n is JsonValue v && v.TryGetValue<string>(out var s) ? s : null;
+
+    /// <summary>Reads an int value, or <paramref name="fallback"/> if absent/null/non-numeric (incl. object/array nodes).</summary>
+    public static int GetInt(JsonObject o, string name, int fallback = 0)
+        => o.TryGetPropertyValue(name, out var n) && n is JsonValue v && v.TryGetValue<int>(out var i) ? i : fallback;
+
+    /// <summary>Reads an enum by its serialised name, or <paramref name="fallback"/> if absent/unparseable.</summary>
+    public static TEnum GetEnum<TEnum>(JsonObject o, string name, TEnum fallback) where TEnum : struct, Enum
+        => GetString(o, name) is { } s && Enum.TryParse<TEnum>(s, ignoreCase: true, out var v) ? v : fallback;
+
+    /// <summary>Sets a string/number/enum-name value (enums via ToString()). Null removes the key.</summary>
+    public static void Set(JsonObject o, string name, object? value)
+        => o[name] = value is null ? null : JsonValue.Create(value is Enum e ? e.ToString() : value);
+}