feat: support showInPalette 'without-children' value

Allow showInPalette to accept 'without-children' alongside boolean.
When set, the command appears in the palette but its children are not
flattened into top-level search results — they remain accessible only
via drill-down when the parent is selected.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: antfu

docs/kit/commands.md

@@ -69,7 +69,7 @@ const plugin: Plugin = {
 | `description` | `string` | Optional description text |
 | `icon` | `string` | Iconify icon string (e.g. `ph:trash-duotone`) |
 | `category` | `string` | Category for grouping |
-| `showInPalette` | `boolean` | Whether to show in command palette (default: `true`) |
+| `showInPalette` | `boolean \| 'without-children'` | Whether to show in command palette (default: `true`). `'without-children'` shows the command but doesn't flatten children into search — they're only accessible via drill-down. |
 | `when` | `string` | Conditional visibility expression (see [When Clauses](/kit/when-clauses)) |
 | `keybindings` | `DevToolsCommandKeybinding[]` | Default keyboard shortcuts |
 | `handler` | `Function` | Server-side handler. Optional if the command is a group for children. |

packages/core/src/client/webcomponents/components/command-palette/CommandPalette.vue

@@ -35,7 +35,7 @@ const flattenedItems = computed<FlatItem[]>(() => {
   const result: FlatItem[] = []
   for (const cmd of commandsCtx.value.paletteCommands) {
     result.push({ entry: cmd, searchTitle: cmd.title })
-    if (cmd.children) {
+    if (cmd.children && cmd.showInPalette !== 'without-children') {
       for (const child of cmd.children) {
         if (child.showInPalette === false)
           continue

packages/kit/src/types/commands.ts

@@ -33,8 +33,12 @@ export interface DevToolsCommandBase {
   category?: string
   /**
    * Whether to show in command palette. Default: true
+   *
+   * - `true` — show the command and flatten its children into search results
+   * - `false` — hide the command entirely from the palette
+   * - `'without-children'` — show the command but don't flatten children into top-level search (children are still accessible via drill-down)
    */
-  showInPalette?: boolean
+  showInPalette?: boolean | 'without-children'
   /**
    * Optional context expression for conditional visibility.
    * When set, the command is only shown in the palette and only executable