Task #144 — Modbus family-native parser branch (DL205 / MELSEC)

Promotes DirectLogicAddress + MelsecAddress from "utility helpers an engineer
calls manually" to "first-class branch of ModbusAddressParser." Users can now
paste DL205-native (V2000, Y0, C100, X17, SP10) and MELSEC-native (D100, M50,
X20 hex/octal, Y0) addresses directly into TagConfig and the parser handles
the PLC-native → Modbus PDU translation.

Changes:

- Both helper files moved into the shared Driver.Modbus.Addressing assembly
  (same namespace, zero-churn for callers). Required because the parser
  needs to call them and the dependency direction is parser→helpers, not
  the other way.
- New ModbusFamily enum (Generic / DL205 / MELSEC) on
  ModbusDriverOptions.Family. Generic preserves pre-#144 behaviour exactly.
- ModbusDriverOptions.MelsecSubFamily picks the X/Y notation (Q_L_iQR hex
  vs F_iQF octal). Default Q_L_iQR.
- ModbusAddressParser.Parse now takes optional family + sub-family hints.
  When non-Generic, family-native parsing runs FIRST; on miss falls back to
  Modicon / mnemonic. Cross-family ambiguity (C100 = Modicon coil under
  Generic, DL205 control relay under DL205) is unambiguous within one
  driver instance.
- Suffix grammar composes with native addresses: V2000:F:CDAB:5 parses
  end-to-end as DL205 V-memory at PDU 1024 + Float32 + word-swap + array of 5.
- Bit suffix composes too: V2000.7 parses as bit 7 of HR[1024].
- Factory DTO fields Family / MelsecSubFamily flow through to BuildTag so
  the JSON binding can drive everything per-driver.

Tests: 16 new ModbusFamilyParserTests covering DL205 V/Y/C/X/SP, MELSEC
D/M/X/Y, sub-family hex-vs-octal disambiguation, cross-family C100 ambiguity,
fallback to Modicon when native misses, and grammar composition with bit/
byte-order/array modifiers. Existing 91 parser tests still green; 220 driver
tests still green.

Caveat: bank-base offsets for MELSEC X/Y/M default to 0 in the grammar
string. Sites with non-zero "Modbus Device Assignment Parameter" bases must
use the structured tag form to override — addressed in the docs refresh
(#138).

src/ZB.MOM.WW.OtOpcUa.Driver.Modbus/ModbusDriverFactoryExtensions.cs

@@ -46,9 +46,18 @@ public static class ModbusDriverFactoryExtensions
             UseFC16ForSingleRegisterWrites = dto.UseFC16ForSingleRegisterWrites ?? false,
             DisableFC23 = dto.DisableFC23 ?? false,
             WriteOnChangeOnly = dto.WriteOnChangeOnly ?? false,
+            Family = dto.Family is null ? ModbusFamily.Generic
+                : ParseEnum<ModbusFamily>(dto.Family, "<driver-level>", driverInstanceId, "Family"),
+            MelsecSubFamily = dto.MelsecSubFamily is null ? MelsecFamily.Q_L_iQR
+                : ParseEnum<MelsecFamily>(dto.MelsecSubFamily, "<driver-level>", driverInstanceId, "MelsecSubFamily"),
             AutoReconnect = dto.AutoReconnect ?? true,
             Tags = dto.Tags is { Count: > 0 }
-                ? [.. dto.Tags.Select(t => BuildTag(t, driverInstanceId))]
+                ? [.. dto.Tags.Select(t => BuildTag(
+                    t, driverInstanceId,
+                    dto.Family is null ? ModbusFamily.Generic
+                        : ParseEnum<ModbusFamily>(dto.Family, "<driver-level>", driverInstanceId, "Family"),
+                    dto.MelsecSubFamily is null ? MelsecFamily.Q_L_iQR
+                        : ParseEnum<MelsecFamily>(dto.MelsecSubFamily, "<driver-level>", driverInstanceId, "MelsecSubFamily")))]
                 : [],
             Probe = new ModbusProbeOptions
             {
@@ -77,6 +86,9 @@ public static class ModbusDriverFactoryExtensions
     }
 
     private static ModbusTagDefinition BuildTag(ModbusTagDto t, string driverInstanceId)
+        => BuildTag(t, driverInstanceId, ModbusFamily.Generic, MelsecFamily.Q_L_iQR);
+
+    private static ModbusTagDefinition BuildTag(ModbusTagDto t, string driverInstanceId, ModbusFamily family, MelsecFamily melsecSubFamily)
     {
         var name = t.Name ?? throw new InvalidOperationException(
             $"Modbus config for '{driverInstanceId}' has a tag missing Name");
@@ -87,7 +99,7 @@ public static class ModbusDriverFactoryExtensions
         // from the grammar (Writable, WriteIdempotent, StringByteOrder) always come from the DTO.
         if (!string.IsNullOrWhiteSpace(t.AddressString))
         {
-            if (!ModbusAddressParser.TryParse(t.AddressString, out var parsed, out var parseError))
+            if (!ModbusAddressParser.TryParse(t.AddressString, family, melsecSubFamily, out var parsed, out var parseError))
                 throw new InvalidOperationException(
                     $"Modbus tag '{name}' in '{driverInstanceId}' has invalid AddressString '{t.AddressString}': {parseError}");
             return new ModbusTagDefinition(
@@ -159,6 +171,8 @@ public static class ModbusDriverFactoryExtensions
         public bool? UseFC16ForSingleRegisterWrites { get; init; }
         public bool? DisableFC23 { get; init; }
         public bool? WriteOnChangeOnly { get; init; }
+        public string? Family { get; init; }
+        public string? MelsecSubFamily { get; init; }
         public bool? AutoReconnect { get; init; }
         public List<ModbusTagDto>? Tags { get; init; }
         public ModbusProbeDto? Probe { get; init; }