fix: remove name from _parent.vue files

Author: posva

packages/router/src/unplugin/codegen/generateRouteMap.spec.ts

@@ -827,6 +827,39 @@ describe('generateRouteNamedMap', () => {
     `)
   })
 
+  it('excludes _parent routes from route map after setCustomRouteBlock', () => {
+    const tree = new PrefixTree(DEFAULT_OPTIONS)
+    tree.insert('nested/_parent', 'nested/_parent.vue')
+    tree.insert('nested/index', 'nested/index.vue')
+    tree.insert('nested/other', 'nested/other.vue')
+
+    // Simulate what context.ts:writeRouteInfoToNode does
+    const nestedNode = tree.children.get('nested')!
+    nestedNode.setCustomRouteBlock('nested/_parent.vue', {})
+
+    // Should NOT contain '/nested' entry — _parent convention override persists
+    expect(
+      formatExports(generateRouteNamedMap(tree, DEFAULT_OPTIONS, new Map()))
+    ).toMatchInlineSnapshot(`
+      "export interface RouteNamedMap {
+        '/nested/': RouteRecordInfo<
+          '/nested/',
+          '/nested',
+          Record<never, never>,
+          Record<never, never>,
+          | never
+        >,
+        '/nested/other': RouteRecordInfo<
+          '/nested/other',
+          '/nested/other',
+          Record<never, never>,
+          Record<never, never>,
+          | never
+        >,
+      }"
+    `)
+  })
+
   it('excludes routes with empty names from route map', () => {
     const tree = new PrefixTree(DEFAULT_OPTIONS)
     tree.insert('parent', 'parent.vue')

packages/router/src/unplugin/core/tree.ts

@@ -1,5 +1,6 @@
 import { type ResolvedOptions } from '../options'
 import {
+  CONVENTION_OVERRIDE_NAME,
   createTreeNodeValue,
   escapeRegex,
   type TreeNodeValueOptions,
@@ -93,8 +94,9 @@ export class TreeNode {
     // _parent.vue is set on the current node to handle nesting
     // similar to nested.vue when we have a folder nested/
     if (segment === '_parent' && !tail) {
-      // a parent can't be matched
-      this.value.setOverride(filePath, { name: false })
+      // a parent can't be matched, equivalent to name: false unless
+      // overridden by the user
+      this.value.setOverride(CONVENTION_OVERRIDE_NAME, { name: false })
       this.value.components.set(viewName, filePath)
       return this
     }

packages/router/src/unplugin/core/treeNodeValue.ts

@@ -39,6 +39,8 @@ export interface RouteRecordOverrideQueryParamOptions extends CustomRouteBlockQu
 
 export type SubSegment = string | TreePathParam
 
+// internal name used for overrides set by file-based conventions (e.g. _parent)
+export const CONVENTION_OVERRIDE_NAME = '@@convention'
 // internal name used for overrides done by the user at build time
 export const EDITS_OVERRIDE_NAME = '@@edits'
 
@@ -196,9 +198,10 @@ class _TreeNodeValueBase {
       .sort(([nameA], [nameB]) =>
         nameA === nameB
           ? 0
-          : // EDITS_OVERRIDE_NAME should always be last
-            nameA !== EDITS_OVERRIDE_NAME &&
-              (nameA < nameB || nameB === EDITS_OVERRIDE_NAME)
+          : // CONVENTION_OVERRIDE_NAME should always be first, EDITS_OVERRIDE_NAME should always be last
+            nameA === CONVENTION_OVERRIDE_NAME ||
+              (nameA !== EDITS_OVERRIDE_NAME &&
+                (nameA < nameB || nameB === EDITS_OVERRIDE_NAME))
             ? -1
             : 1
       )