op-mode: T7542: add support for "standalone" tag node calls

2 files changed, 48 insertions, 11 deletions

diff --git a/schema/op-mode-definition.rnc b/schema/op-mode-definition.rnc
index ad41700b9..46430daa4 100644
--- a/schema/op-mode-definition.rnc
+++ b/schema/op-mode-definition.rnc
@@ -1,6 +1,6 @@
 #    interface_definition.rnc: VyConf reference tree XML grammar
 #
-#    Copyright (C) 2014. 2017 VyOS maintainers and contributors <maintainers@vyos.net>
+#    Copyright (C) 2014-2025 VyOS maintainers and contributors <maintainers@vyos.net>
 #
 #    This library is free software; you can redistribute it and/or
 #    modify it under the terms of the GNU Lesser General Public
@@ -37,13 +37,27 @@ node = element node
 }
 
 # Tag nodes are containers for nodes without predefined names, like network interfaces
-# or user names (e.g. "interfaces ethernet eth0" or "user jrandomhacker")
-# Tag nodes may contain node and leafNode elements, and also nameConstraint tags
-# They must not contain other tag nodes
+# or user names (e.g. "show interfaces ethernet ethX").
+# Operational mode tag nodes can be parents to other tag nodes,
+# like in "ping <host> count <packets>".
+#
+# Some commands can be called either with or without arguments,
+# like "show interfaces ethernet eth0" (show info for eth0 only)
+# or "show interfaces ethernet" (show info about all ethernet interfaces).
+# That case is handled using the <standalone> element
 tagNode = element tagNode
 {
     nodeNameAttr,
-    (properties? & children? & command?)
+    (properties? & standalone? & children? & command?)
+}
+
+# The <standalone> element is only used inside tag nodes
+# to define their behavior when they are called without arguments
+# It can provide a help string and a command.
+# Everything else is handled in the <tagNode> itself.
+standalone = element standalone
+{
+    help & command
 }
 
 # Leaf nodes are terminal configuration nodes that can't have children,
diff --git a/schema/op-mode-definition.rng b/schema/op-mode-definition.rng
index a255aeb73..bfd5cb50a 100644
--- a/schema/op-mode-definition.rng
+++ b/schema/op-mode-definition.rng
@@ -3,7 +3,7 @@
   <!--
        interface_definition.rnc: VyConf reference tree XML grammar
     
-       Copyright (C) 2014. 2017 VyOS maintainers and contributors <maintainers@vyos.net>
+       Copyright (C) 2014-2025 VyOS maintainers and contributors <maintainers@vyos.net>
     
        This library is free software; you can redistribute it and/or
        modify it under the terms of the GNU Lesser General Public
@@ -59,9 +59,14 @@
   </define>
   <!--
     Tag nodes are containers for nodes without predefined names, like network interfaces
-    or user names (e.g. "interfaces ethernet eth0" or "user jrandomhacker")
-    Tag nodes may contain node and leafNode elements, and also nameConstraint tags
-    They must not contain other tag nodes
+    or user names (e.g. "show interfaces ethernet ethX").
+    Operational mode tag nodes can be parents to other tag nodes,
+    like in "ping <host> count <packets>".
+    
+    Some commands can be called either with or without arguments,
+    like "show interfaces ethernet eth0" (show info for eth0 only)
+    or "show interfaces ethernet" (show info about all ethernet interfaces).
+    That case is handled using the <standalone> element
   -->
   <define name="tagNode">
     <element name="tagNode">
@@ -71,6 +76,9 @@
           <ref name="properties"/>
         </optional>
         <optional>
+          <ref name="standalone"/>
+        </optional>
+        <optional>
           <ref name="children"/>
         </optional>
         <optional>
@@ -80,6 +88,20 @@
     </element>
   </define>
   <!--
+    The <standalone> element is only used inside tag nodes
+    to define their behavior when they are called without arguments
+    It can provide a help string and a command.
+    Everything else is handled in the <tagNode> itself.
+  -->
+  <define name="standalone">
+    <element name="standalone">
+      <interleave>
+        <ref name="help"/>
+        <ref name="command"/>
+      </interleave>
+    </element>
+  </define>
+  <!--
     Leaf nodes are terminal configuration nodes that can't have children,
     but can have values.
   -->
@@ -139,10 +161,11 @@
   <!--
     completionHelp tags contain information about allowed values of a node that is used for generating
     tab completion in the CLI frontend and drop-down lists in GUI frontends
-    It is only meaninful for leaf nodes
+    It is only meaningful for leaf nodes
     Allowed values can be given as a fixed list of values (e.g. <list>foo bar baz</list>),
     as a configuration path (e.g. <path>interfaces ethernet</path>),
-    or as a path to a script file that generates the list (e.g. <script>/usr/lib/foo/list-things</script>
+    as a path to a script file that generates the list (e.g. <script>/usr/lib/foo/list-things</script>,
+    or to enable built-in image path completion (<imagePath/>).
   -->
   <define name="completionHelp">
     <element name="completionHelp">