refactor(nuxt3): rename <NuxtChild> to <NuxtNestedPage> (#2432)

docs/content/3.docs/2.directory-structure/9.pages.md

@@ -93,7 +93,7 @@ If you want to know more about `<RouterLink>`, read the [Vue Router documentati
 
 ## Nested Routes
 
-We provide a semantic alias for `RouterView`, the `<NuxtChild>` component, for displaying the children components of a [nested route](https://next.router.vuejs.org/guide/essentials/nested-routes.html).
+We provide a semantic alias for `RouterView`, the `<NuxtNestedPage>` component, for displaying the children components of a [nested route](https://next.router.vuejs.org/guide/essentials/nested-routes.html).
 
 Example:
 
@@ -123,13 +123,13 @@ This file tree will generate these routes:
 ]
 ```
 
-To display the `child.vue` component, you have to insert the `<NuxtChild>` component inside `pages/parent.vue`:
+To display the `child.vue` component, you have to insert the `<NuxtNestedPage>` component inside `pages/parent.vue`:
 
 ```html{}[pages/parent.vue]
 <template>
   <div>
     <h1>I am the parent view</h1>
-    <NuxtChild :foobar="123" />
+    <NuxtNestedPage :foobar="123" />
   </div>
 </template>
 ```

examples/with-pages/pages/parent.vue

@@ -1,6 +1,6 @@
 <template>
   <div>
     Parent
-    <NuxtChild />
+    <NuxtNestedPage />
   </div>
 </template>

packages/nuxt3/src/pages/runtime/nested-page.vue

@@ -6,6 +6,6 @@
 
 <script>
 export default {
-  name: 'NuxtChild'
+  name: 'NuxtNestedPage'
 }
 </script>

packages/nuxt3/src/pages/runtime/router.ts

@@ -5,7 +5,7 @@ import {
   createMemoryHistory,
   RouterLink
 } from 'vue-router'
-import NuxtChild from './child.vue'
+import NuxtNestedPage from './nested-page.vue'
 import NuxtPage from './page.vue'
 import NuxtLayout from './layout'
 import { defineNuxtPlugin } from '#app'
@@ -14,7 +14,7 @@ import routes from '#build/routes'
 
 declare module 'vue' {
   export interface GlobalComponents {
-    NuxtChild: typeof NuxtChild
+    NuxtNestedPage: typeof NuxtNestedPage
     NuxtPage: typeof NuxtPage
     NuxtLayout: typeof NuxtLayout
     NuxtLink: typeof RouterLink
@@ -22,10 +22,12 @@ declare module 'vue' {
 }
 
 export default defineNuxtPlugin((nuxtApp) => {
-  nuxtApp.vueApp.component('NuxtChild', NuxtChild)
+  nuxtApp.vueApp.component('NuxtNestedPage', NuxtNestedPage)
   nuxtApp.vueApp.component('NuxtPage', NuxtPage)
   nuxtApp.vueApp.component('NuxtLayout', NuxtLayout)
   nuxtApp.vueApp.component('NuxtLink', RouterLink)
+  // TODO: remove before release - present for backwards compatibility & intentionally undocumented
+  nuxtApp.vueApp.component('NuxtChild', NuxtNestedPage)
 
   const routerHistory = process.client
     ? createWebHistory()