docs: complete XML doc coverage (returns, summaries, inheritdoc)

Resolve all 622 issues flagged by the enhanced CommentChecker: add missing
<returns> tags (incl. the standard phrasing on non-generic Task methods),
add missing <summary> tags, and replace misused/redundant <inheritdoc/> on
members that override or implement nothing with real documentation.
Documentation-only — no behavior change; solution builds clean.

src/ZB.MOM.WW.ScadaBridge.CentralUI/Components/Shared/DurationInput.cs

@@ -18,6 +18,7 @@ internal static class DurationInput
     /// <c>sec</c> unit.
     /// </summary>
     /// <param name="duration">The duration to split, or null for unset.</param>
+    /// <returns>A tuple of the numeric string and unit token (ms/sec/min), or <c>(null, "sec")</c> for null or non-positive input.</returns>
     internal static (string? Value, string Unit) Split(TimeSpan? duration)
     {
         if (duration is not { } d || d <= TimeSpan.Zero) return (null, "sec");
@@ -34,6 +35,7 @@ internal static class DurationInput
     /// </summary>
     /// <param name="value">The numeric string entered by the user.</param>
     /// <param name="unit">The selected unit token (ms, sec, or min).</param>
+    /// <returns>The composed <see cref="TimeSpan"/>, or <c>null</c> for blank, unparseable, or non-positive input.</returns>
     internal static TimeSpan? Compose(string? value, string unit)
     {
         if (!long.TryParse(value, NumberStyles.Integer, CultureInfo.InvariantCulture, out var n)

src/ZB.MOM.WW.ScadaBridge.CentralUI/Components/Shared/IDialogService.cs

@@ -18,6 +18,7 @@ public interface IDialogService
     /// <param name="danger">When <c>true</c>, the confirm button renders in
     /// <c>btn-danger</c> styling with the label "Delete"; otherwise a primary
     /// "Confirm" button is shown.</param>
+    /// <returns>A task that resolves to <c>true</c> when the user confirms, or <c>false</c> when cancelled.</returns>
     Task<bool> ConfirmAsync(string title, string message, bool danger = false);
 
     /// <summary>
@@ -28,5 +29,6 @@ public interface IDialogService
     /// <param name="label">Label rendered above the input field.</param>
     /// <param name="initialValue">Pre-populated value for the input field.</param>
     /// <param name="placeholder">Optional placeholder shown when the input is empty.</param>
+    /// <returns>A task that resolves to the entered string, or <c>null</c> if the user cancels.</returns>
     Task<string?> PromptAsync(string title, string label, string initialValue = "", string? placeholder = null);
 }

src/ZB.MOM.WW.ScadaBridge.CentralUI/Components/Shared/SchemaBuilderModel.cs

@@ -46,6 +46,7 @@ internal static class SchemaBuilderModel
     /// </summary>
     /// <param name="json">JSON Schema string to parse, or null/empty to return the fallback.</param>
     /// <param name="fallback">The <see cref="SchemaNode"/> to return when the input cannot be parsed.</param>
+    /// <returns>The parsed <see cref="SchemaNode"/> tree, or <paramref name="fallback"/> if the input is empty or malformed.</returns>
     public static SchemaNode Parse(string? json, SchemaNode fallback)
     {
         if (string.IsNullOrWhiteSpace(json)) return fallback;
@@ -66,15 +67,18 @@ internal static class SchemaBuilderModel
     }
 
     /// <summary>Default empty object schema (parameters mode default).</summary>
+    /// <returns>A new <see cref="SchemaNode"/> with type <c>object</c>.</returns>
     public static SchemaNode NewObject() => new() { Type = "object" };
 
     /// <summary>Default scalar schema (return mode default).</summary>
+    /// <returns>A new <see cref="SchemaNode"/> with type <c>string</c>.</returns>
     public static SchemaNode NewValue() => new() { Type = "string" };
 
     /// <summary>
     /// Serializes a <see cref="SchemaNode"/> tree to its canonical JSON Schema string.
     /// </summary>
     /// <param name="node">The schema node to serialize.</param>
+    /// <returns>The canonical JSON Schema string representing the node tree.</returns>
     public static string Serialize(SchemaNode node)
     {
         using var stream = new System.IO.MemoryStream();

src/ZB.MOM.WW.ScadaBridge.CentralUI/Components/Shared/ScriptParameterNames.cs

@@ -13,6 +13,7 @@ public static class ScriptParameterNames
     /// Parses a parameter definitions JSON Schema and returns the declared parameter names.
     /// </summary>
     /// <param name="json">JSON Schema or legacy flat-array string; null/empty returns an empty list.</param>
+    /// <returns>A read-only list of declared parameter names.</returns>
     public static IReadOnlyList<string> Parse(string? json) =>
         JsonSchemaShapeParser.ParseParameters(json)
             .Select(p => p.Name)
@@ -23,6 +24,7 @@ public static class ScriptParameterNames
     /// Parses a parameter definitions JSON Schema and returns the full parameter shape objects.
     /// </summary>
     /// <param name="json">JSON Schema or legacy flat-array string; null/empty returns an empty list.</param>
+    /// <returns>A read-only list of parameter shape objects with name and type information.</returns>
     public static IReadOnlyList<ParameterShape> ParseShapes(string? json) =>
         JsonSchemaShapeParser.ParseParameters(json);
 }

src/ZB.MOM.WW.ScadaBridge.CentralUI/Components/Shared/ScriptTriggerConfigCodec.cs

@@ -68,6 +68,7 @@ internal static class ScriptTriggerConfigCodec
 
     /// <summary>Classifies a raw <c>TriggerType</c> string (case-insensitive).</summary>
     /// <param name="triggerType">The raw trigger type string from the template script entity.</param>
+    /// <returns>The matching <see cref="ScriptTriggerKind"/>, or <see cref="ScriptTriggerKind.None"/> for null/empty.</returns>
     internal static ScriptTriggerKind ParseKind(string? triggerType)
     {
         if (string.IsNullOrWhiteSpace(triggerType)) return ScriptTriggerKind.None;
@@ -89,6 +90,7 @@ internal static class ScriptTriggerConfigCodec
     /// (invoked explicitly, never throttled), and None/Unknown.
     /// </summary>
     /// <param name="triggerType">The raw trigger type string to classify.</param>
+    /// <returns><see langword="true"/> if the trigger honours <c>MinTimeBetweenRuns</c>; otherwise <see langword="false"/>.</returns>
     internal static bool SupportsMinTimeBetweenRuns(string? triggerType) =>
         ParseKind(triggerType) is ScriptTriggerKind.ValueChange
             or ScriptTriggerKind.Conditional
@@ -96,6 +98,7 @@ internal static class ScriptTriggerConfigCodec
 
     /// <summary>Canonical <c>TriggerType</c> string for a kind; null for None/Unknown.</summary>
     /// <param name="kind">The trigger kind to convert.</param>
+    /// <returns>The canonical trigger-type string, or null for <see cref="ScriptTriggerKind.None"/>/<see cref="ScriptTriggerKind.Unknown"/>.</returns>
     internal static string? KindToString(ScriptTriggerKind kind) => kind switch
     {
         ScriptTriggerKind.Interval => "Interval",
@@ -113,6 +116,7 @@ internal static class ScriptTriggerConfigCodec
     /// </summary>
     /// <param name="json">The raw JSON trigger configuration string.</param>
     /// <param name="kind">The trigger kind, used to determine which fields to parse.</param>
+    /// <returns>A <see cref="ScriptTriggerModel"/> populated from the JSON; defaults are used for absent or malformed fields.</returns>
     internal static ScriptTriggerModel Parse(string? json, ScriptTriggerKind kind)
     {
         var model = new ScriptTriggerModel();
@@ -161,6 +165,7 @@ internal static class ScriptTriggerConfigCodec
     /// </summary>
     /// <param name="model">The trigger model to serialize.</param>
     /// <param name="kind">The trigger kind, used to determine which fields to emit.</param>
+    /// <returns>The JSON configuration string, or null for <see cref="ScriptTriggerKind.None"/>/<see cref="ScriptTriggerKind.Unknown"/>.</returns>
     internal static string? Serialize(ScriptTriggerModel model, ScriptTriggerKind kind)
     {
         if (kind is ScriptTriggerKind.None or ScriptTriggerKind.Unknown) return null;
@@ -214,6 +219,7 @@ internal static class ScriptTriggerConfigCodec
 
     /// <summary>Returns <paramref name="raw"/> if it is a recognized operator, else "&gt;".</summary>
     /// <param name="raw">The raw operator string to normalize.</param>
+    /// <returns>A valid operator string from <see cref="Operators"/>; defaults to "&gt;" for unrecognized input.</returns>
     internal static string NormalizeOperator(string? raw)
     {
         var op = raw?.Trim();

src/ZB.MOM.WW.ScadaBridge.CentralUI/Components/Shared/TriggerAttributeMapper.cs

@@ -19,6 +19,7 @@ public static class TriggerAttributeMapper
 {
     /// <summary>Direct and inherited attributes, exposed as <c>Attributes["..."]</c>.</summary>
     /// <param name="choices">The full flattened attribute choice list from the trigger editor.</param>
+    /// <returns>The list of <see cref="AttributeShape"/>s for Direct and Inherited attributes.</returns>
     public static IReadOnlyList<AttributeShape> SelfAttributes(
         IReadOnlyList<AlarmAttributeChoice> choices) =>
         choices
@@ -32,6 +33,7 @@ public static class TriggerAttributeMapper
     /// are skipped (no child scope to attach them to).
     /// </summary>
     /// <param name="choices">The full flattened attribute choice list from the trigger editor.</param>
+    /// <returns>The list of <see cref="CompositionContext"/>s, one per distinct composition-instance name.</returns>
     public static IReadOnlyList<CompositionContext> Children(
         IReadOnlyList<AlarmAttributeChoice> choices) =>
         choices