Update: schema.

cmdcomp/v2/command/__init__.py

@@ -139,8 +139,9 @@ class V2SubcommandsCommand(Model):
         ),
     ]
 
-    subcommands: OrderedDict[SubcommandName, "V2Command"] = Field(
+    raw_subcommands: OrderedDict[SubcommandName, "V2Command | None"] = Field(
         title="subcommands of the command.",
+        alias="subcommands",
         default_factory=OrderedDict,
     )
 
@@ -169,6 +170,20 @@ def keyword_arguments(self) -> OrderedDict[Keyword, V2Argument]:
             ]
         )
 
+    @property
+    def subcommands(self) -> OrderedDict[SubcommandName, "V2Command"]:
+        return OrderedDict(
+            [
+                (
+                    name,
+                    V2SubcommandsCommand(alias=[], arguments=OrderedDict())
+                    if subcommand is None
+                    else subcommand,
+                )
+                for name, subcommand in self.raw_subcommands.items()
+            ]
+        )
+
     @property
     def subcommand_names_with_alias(self) -> list[SubcommandName]:
         return _subcommand_names_with_alias(self)

docs/config.schema.json

@@ -568,6 +568,9 @@
                             },
                             {
                                 "$ref": "#/$defs/V2SubcommandsCommand"
+                            },
+                            {
+                                "type": "null"
                             }
                         ]
                     },