feat(adminui): {{equip}}-aware hover + {{equip}}. leaf completion in the script editor

src/Server/ZB.MOM.WW.OtOpcUa.AdminUI/ScriptAnalysis/ScriptAnalysisService.cs

@@ -2,6 +2,7 @@ using Microsoft.CodeAnalysis;
 using Microsoft.CodeAnalysis.CSharp;
 using Microsoft.CodeAnalysis.CSharp.Syntax;
 using Microsoft.Extensions.Logging;
+using ZB.MOM.WW.OtOpcUa.Commons.Types;
 using ZB.MOM.WW.OtOpcUa.Core.Scripting;
 using ZB.MOM.WW.OtOpcUa.Core.VirtualTags;
 
@@ -161,6 +162,16 @@ public sealed class ScriptAnalysisService
 
             if (_catalog != null && TryGetTagPathLiteral(token, out var pathPrefix))
             {
+                const string equipDot = EquipmentScriptPaths.EquipToken + "."; // "{{equip}}."
+                if (pathPrefix.StartsWith(equipDot, StringComparison.Ordinal))
+                {
+                    var leaves = await _catalog.GetEquipmentRelativeLeavesAsync(
+                        pathPrefix.Substring(equipDot.Length), CancellationToken.None);
+                    return new CompletionsResponse(leaves
+                        .Select(n => new CompletionItem(equipDot + n, equipDot + n, "tag path", "Field"))
+                        .ToList());
+                }
+
                 var paths = await _catalog.GetPathsAsync(pathPrefix, CancellationToken.None);
                 return new CompletionsResponse(
                     paths.Select(p => new CompletionItem(p, p, "tag path", "Field")).ToList());
@@ -242,8 +253,18 @@ public sealed class ScriptAnalysisService
             // (or note it's not a known configured tag path) instead of the string-literal symbol.
             if (_catalog is not null && TryGetTagPathLiteral(token, out var tagPath) && !string.IsNullOrEmpty(tagPath))
             {
-                var info = await _catalog.GetTagInfoAsync(tagPath, CancellationToken.None);
                 static string Code(string s) => s.Replace("`", "\\`");
+                // Equipment-relative literal (contains the {{equip}} token): it cannot resolve to a
+                // configured path as-typed (the token is only substituted at deploy), so short-circuit
+                // before GetTagInfoAsync and explain the token instead of warning "not a known path".
+                if (tagPath.Contains(EquipmentScriptPaths.EquipToken, StringComparison.Ordinal))
+                {
+                    return new HoverResponse(
+                        $"**Equipment-relative path** `{Code(tagPath)}`\n\n" +
+                        "The {{equip}} token is replaced with the owning equipment's tag base when the VirtualTag is deployed.");
+                }
+
+                var info = await _catalog.GetTagInfoAsync(tagPath, CancellationToken.None);
                 var tagMd = info is null
                     ? $"**Tag path** `{Code(tagPath)}`\n\n⚠ Not a known configured tag path."
                     : $"**Tag path** `{Code(info.Path)}`\n\n{info.Kind} · Type **{info.DataType}**"