@nuxt/docs 4.2.1 → 4.3.0

package/{3.api → 4.api}/5.kit/4.autoimports.md

@@ -58,16 +58,16 @@ function addImports (imports: Import | Import[]): void
 
 `imports`: An object or an array of objects with the following properties:
 
-| Property           | Type                         | Required | Description                                                                                                     |
-| ------------------ | ---------------------------- | -------- | --------------------------------------------------------------------------------------------------------------- |
-| `name`             | `string`                     | `true`   | Import name to be detected.                                                                                     |
-| `from`             | `string`                     | `true`   | Module specifier to import from.                                                                                |
-| `priority`         | `number`                     | `false`  | Priority of the import; if multiple imports have the same name, the one with the highest priority will be used. |
-| `disabled`         | `boolean`                    | `false`  | If this import is disabled.                                                                                     |
-| `meta`             | `Record<string, any>`        | `false`  | Metadata of the import.                                                                                         |
-| `type`             | `boolean`                    | `false`  | If this import is a pure type import.                                                                           |
-| `typeFrom`         | `string`                     | `false`  | Use this as the `from` value when generating type declarations.                                                 |
-| `as`               | `string`                     | `false`  | Import as this name.                                                                                            |
+| Property   | Type                  | Required | Description                                                                                                     |
+|------------|-----------------------|----------|-----------------------------------------------------------------------------------------------------------------|
+| `name`     | `string`              | `true`   | Import name to be detected.                                                                                     |
+| `from`     | `string`              | `true`   | Module specifier to import from.                                                                                |
+| `priority` | `number`              | `false`  | Priority of the import; if multiple imports have the same name, the one with the highest priority will be used. |
+| `disabled` | `boolean`             | `false`  | If this import is disabled.                                                                                     |
+| `meta`     | `Record<string, any>` | `false`  | Metadata of the import.                                                                                         |
+| `type`     | `boolean`             | `false`  | If this import is a pure type import.                                                                           |
+| `typeFrom` | `string`              | `false`  | Use this as the `from` value when generating type declarations.                                                 |
+| `as`       | `string`              | `false`  | Import as this name.                                                                                            |
 
 ## `addImportsDir`
 
@@ -98,10 +98,10 @@ function addImportsDir (dirs: string | string[], options?: { prepend?: boolean }
 
 ### Parameters
 
-| Property           | Type                         | Required | Description                                                                                                     |
-| ------------------ | ---------------------------- | -------- | --------------------------------------------------------------------------------------------------------------- |
-| `dirs`             | `string \| string[]`{lang="ts"}          | `true`   | A string or an array of strings with the path to the directory to import from.                                 |
-| `options`          | `{ prepend?: boolean }`{lang="ts"}      | `false`  | Options to pass to the import. If `prepend` is set to `true`, the imports will be prepended to the list of imports. |
+| Property  | Type                               | Required | Description                                                                                                         |
+|-----------|------------------------------------|----------|---------------------------------------------------------------------------------------------------------------------|
+| `dirs`    | `string \| string[]`{lang="ts"}    | `true`   | A string or an array of strings with the path to the directory to import from.                                      |
+| `options` | `{ prepend?: boolean }`{lang="ts"} | `false`  | Options to pass to the import. If `prepend` is set to `true`, the imports will be prepended to the list of imports. |
 
 ## `addImportsSources`
 
@@ -138,7 +138,7 @@ function addImportsSources (importSources: ImportSource | ImportSource[]): void
 
 **importSources**: An object or an array of objects with the following properties:
 
-| Property           | Type                         | Required | Description                                                                                                     |
-| ------------------ | ---------------------------- | -------- | --------------------------------------------------------------------------------------------------------------- |
-| `from`             | `string`                     | `true`   | Module specifier to import from.                                                                                |
-| `imports`          | `PresetImport \| ImportSource[]`{lang="ts"} | `true`   | An object or an array of objects, which can be import names, import objects or import sources.                  |
+| Property  | Type                                        | Required | Description                                                                                    |
+|-----------|---------------------------------------------|----------|------------------------------------------------------------------------------------------------|
+| `from`    | `string`                                    | `true`   | Module specifier to import from.                                                               |
+| `imports` | `PresetImport \| ImportSource[]`{lang="ts"} | `true`   | An object or an array of objects, which can be import names, import objects or import sources. |

package/4.api/5.kit/5.components.md

@@ -0,0 +1,146 @@
+---
+title: "Components"
+description: Nuxt Kit provides a set of utilities to help you work with components. You can register components globally or locally, and also add directories to be scanned for components.
+links:
+  - label: Source
+    icon: i-simple-icons-github
+    to: https://github.com/nuxt/nuxt/blob/main/packages/kit/src/components.ts
+    size: xs
+---
+
+Components are the building blocks of your Nuxt application. They are reusable Vue instances that can be used to create a user interface. In Nuxt, components from the components directory are automatically imported by default. However, if you need to import components from an alternative directory or wish to selectively import them as needed, `@nuxt/kit` provides the `addComponentsDir` and `addComponent` methods. These utils allow you to customize the component configuration to better suit your needs.
+
+::tip{icon="i-lucide-video" to="https://vueschool.io/lessons/injecting-components-and-component-directories?friend=nuxt" target="_blank"}
+Watch Vue School video about injecting components.
+::
+
+## `addComponentsDir`
+
+Register a directory to be scanned for components and imported only when used. Keep in mind, that this does not register components globally, until you specify `global: true` option.
+
+### Usage
+
+```ts
+export default defineNuxtModule({
+  meta: {
+    name: '@nuxt/ui',
+    configKey: 'ui',
+  },
+  setup () {
+    addComponentsDir({
+      path: resolve('./runtime/components'),
+      prefix: 'U',
+      pathPrefix: false,
+    })
+  },
+})
+```
+
+### Type
+
+```ts
+function addComponentsDir (dir: ComponentsDir, opts: { prepend?: boolean } = {}): void
+```
+
+### Parameters
+
+`dir` An object with the following properties:
+
+| Property          | Type                                                                                     | Required | Description                                                                                                                                                                                                                                             |
+|-------------------|------------------------------------------------------------------------------------------|----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `path`            | `string`                                                                                 | `true`   | Path (absolute or relative) to the directory containing your components. You can use Nuxt aliases (~ or @) to refer to directories inside project or directly use an npm package path similar to require.                                               |
+| `pattern`         | `string \| string[]`{lang="ts"}                                                          | `false`  | Accept Pattern that will be run against specified path.                                                                                                                                                                                                 |
+| `ignore`          | `string[]`                                                                               | `false`  | Ignore patterns that will be run against specified path.                                                                                                                                                                                                |
+| `prefix`          | `string`                                                                                 | `false`  | Prefix all matched components with this string.                                                                                                                                                                                                         |
+| `pathPrefix`      | `boolean`                                                                                | `false`  | Prefix component name by its path.                                                                                                                                                                                                                      |
+| `prefetch`        | `boolean`                                                                                | `false`  | These properties (prefetch/preload) are used in production to configure how components with Lazy prefix are handled by webpack via its magic comments. Learn more on [webpack documentation](https://webpack.js.org/api/module-methods/#magic-comments) |
+| `preload`         | `boolean`                                                                                | `false`  | These properties (prefetch/preload) are used in production to configure how components with Lazy prefix are handled by webpack via its magic comments. Learn more on [webpack documentation](https://webpack.js.org/api/module-methods/#magic-comments) |
+| `isAsync`         | `boolean`                                                                                | `false`  | This flag indicates, component should be loaded async (with a separate chunk) regardless of using Lazy prefix or not.                                                                                                                                   |
+| `extendComponent` | `(component: Component) => Promise<Component \| void> \| (Component \| void)`{lang="ts"} | `false`  | A function that will be called for each component found in the directory. It accepts a component object and should return a component object or a promise that resolves to a component object.                                                          |
+| `global`          | `boolean`                                                                                | `false`  | If enabled, registers components to be globally available.                                                                                                                                                                                              |
+| `island`          | `boolean`                                                                                | `false`  | If enabled, registers components as islands. You can read more about islands in [`<NuxtIsland/>`](/docs/4.x/api/components/nuxt-island) component description.                                                                                          |
+| `watch`           | `boolean`                                                                                | `false`  | Watch specified path for changes, including file additions and file deletions.                                                                                                                                                                          |
+| `extensions`      | `string[]`                                                                               | `false`  | Extensions supported by Nuxt builder.                                                                                                                                                                                                                   |
+| `transpile`       | `'auto' \| boolean`{lang="ts"}                                                           | `false`  | Transpile specified path using build.transpile. If set to `'auto'`, it will set `transpile: true` if `node_modules/` is in path.                                                                                                                        |
+
+`opts`
+
+| Property  | Type      | Required | Description                                                                                          |
+|-----------|-----------|----------|------------------------------------------------------------------------------------------------------|
+| `prepend` | `boolean` | `false`  | If set to `true`, the directory will be prepended to the array with `unshift()` instead of `push()`. |
+
+## `addComponent`
+
+Register a component to be automatically imported.
+
+### Usage
+
+```ts
+import { addComponent, createResolver, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+  meta: {
+    name: '@nuxt/image',
+    configKey: 'image',
+  },
+  setup () {
+    const resolver = createResolver(import.meta.url)
+
+    addComponent({
+      name: 'NuxtImg',
+      filePath: resolver.resolve('./runtime/components/NuxtImg.vue'),
+    })
+
+    addComponent({
+      name: 'NuxtPicture',
+      filePath: resolver.resolve('./runtime/components/NuxtPicture.vue'),
+    })
+  },
+})
+```
+
+### Type
+
+```ts
+function addComponent (options: AddComponentOptions): void
+```
+
+### Parameters
+
+`options`: An object with the following properties:
+
+| Property          | Type                                       | Required | Description                                                                                                                                                                                                                                             |
+|-------------------|--------------------------------------------|----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|  
+| `name`            | `string`                                   | `true`   | Component name.                                                                                                                                                                                                                                         |
+| `filePath`        | `string`                                   | `true`   | Path to the component.                                                                                                                                                                                                                                  |
+| `declarationPath` | `string`                                   | `false`  | Path to component's declaration file. It is used to generate components' [type templates](/docs/4.x/api/kit/templates#addtypetemplate); if not provided, `filePath` is used instead.                                                                    |
+| `pascalName`      | `string`                                   | `false`  | Pascal case component name. If not provided, it will be generated from the component name.                                                                                                                                                              |
+| `kebabName`       | `string`                                   | `false`  | Kebab case component name. If not provided, it will be generated from the component name.                                                                                                                                                               |
+| `export`          | `string`                                   | `false`  | Specify named or default export. If not provided, it will be set to `'default'`.                                                                                                                                                                        |
+| `shortPath`       | `string`                                   | `false`  | Short path to the component. If not provided, it will be generated from the component path.                                                                                                                                                             |
+| `chunkName`       | `string`                                   | `false`  | Chunk name for the component. If not provided, it will be generated from the component name.                                                                                                                                                            |
+| `prefetch`        | `boolean`                                  | `false`  | These properties (prefetch/preload) are used in production to configure how components with Lazy prefix are handled by webpack via its magic comments. Learn more on [webpack documentation](https://webpack.js.org/api/module-methods/#magic-comments) |  
+| `preload`         | `boolean`                                  | `false`  | These properties (prefetch/preload) are used in production to configure how components with Lazy prefix are handled by webpack via its magic comments. Learn more on [webpack documentation](https://webpack.js.org/api/module-methods/#magic-comments) |
+| `global`          | `boolean`                                  | `false`  | If enabled, registers component to be globally available.                                                                                                                                                                                               |
+| `island`          | `boolean`                                  | `false`  | If enabled, registers component as island. You can read more about islands in [`<NuxtIsland/>`](/docs/4.x/api/components/nuxt-island) component description.                                                                                            |
+| `mode`            | `'client' \| 'server' \| 'all'`{lang="ts"} | `false`  | This options indicates if component should render on client, server or both. By default, it will render on both client and server.                                                                                                                      |
+| `priority`        | `number`                                   | `false`  | Priority of the component, if multiple components have the same name, the one with the highest priority will be used.                                                                                                                                   |
+
+### Examples
+
+If you want to auto-import a component from an npm package, and the component is a named export (rather than the default), you can use the `export` option to specify it.
+
+```ts
+import { addComponent, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+  setup () {
+    // import { MyComponent as MyAutoImportedComponent } from 'my-npm-package'
+    addComponent({
+      name: 'MyAutoImportedComponent',
+      export: 'MyComponent',
+      filePath: 'my-npm-package',
+    })
+  },
+})
+```

package/4.api/6.advanced/1.hooks.md

@@ -0,0 +1,105 @@
+---
+title: 'Lifecycle Hooks'
+description: Nuxt provides a powerful hooking system to expand almost every aspect using hooks.
+---
+
+:read-more{to="/docs/4.x/guide/going-further/hooks"}
+
+## App Hooks (runtime)
+
+Check the [app source code](https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/nuxt.ts#L37) for all available hooks.
+
+| Hook                         | Arguments           | Environment     | Description                                                                                                                                                                           |
+|------------------------------|---------------------|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `app:created`                | `vueApp`            | Server & Client | Called when initial `vueApp` instance is created.                                                                                                                                     |
+| `app:error`                  | `err`               | Server & Client | Called when a fatal error occurs.                                                                                                                                                     |
+| `app:error:cleared`          | `{ redirect? }`     | Server & Client | Called when a fatal error occurs.                                                                                                                                                     |
+| `vue:setup`                  | -                   | Server & Client | Called when the setup of Nuxt root is initialized. This callback must be synchronous.                                                                                                 |
+| `vue:error`                  | `err, target, info` | Server & Client | Called when a vue error propagates to the root component. [Learn More](https://vuejs.org/api/composition-api-lifecycle#onerrorcaptured).                                              |
+| `app:rendered`               | `renderContext`     | Server          | Called when SSR rendering is done.                                                                                                                                                    |
+| `app:redirected`             | -                   | Server          | Called before SSR redirection.                                                                                                                                                        |
+| `app:beforeMount`            | `vueApp`            | Client          | Called before mounting the app, called only on client side.                                                                                                                           |
+| `app:mounted`                | `vueApp`            | Client          | Called when Vue app is initialized and mounted in browser.                                                                                                                            |
+| `app:suspense:resolve`       | `appComponent`      | Client          | On [Suspense](https://vuejs.org/guide/built-ins/suspense#suspense) resolved event.                                                                                                    |
+| `app:manifest:update`        | `{ id, timestamp }` | Client          | Called when there is a newer version of your app detected.                                                                                                                            |
+| `app:data:refresh`           | `keys?`             | Client          | Called when `refreshNuxtData` is called.                                                                                                                                              |
+| `link:prefetch`              | `to`                | Client          | Called when a `<NuxtLink>` is observed to be prefetched.                                                                                                                              |
+| `page:start`                 | `pageComponent?`    | Client          | Called on [Suspense](https://vuejs.org/guide/built-ins/suspense#suspense) inside of `NuxtPage` pending event.                                                                         |
+| `page:finish`                | `pageComponent?`    | Client          | Called on [Suspense](https://vuejs.org/guide/built-ins/suspense#suspense) inside of `NuxtPage` resolved event.                                                                        |
+| `page:loading:start`         | -                   | Client          | Called when the `setup()` of the new page is running.                                                                                                                                 |
+| `page:loading:end`           | -                   | Client          | Called after `page:finish`                                                                                                                                                            |
+| `page:transition:finish`     | `pageComponent?`    | Client          | After page transition [onAfterLeave](https://vuejs.org/guide/built-ins/transition#javascript-hooks) event.                                                                            |
+| `dev:ssr-logs`               | `logs`              | Client          | Called with an array of server-side logs that have been passed to the client (if `features.devLogs` is enabled).                                                                      |
+| `page:view-transition:start` | `transition`        | Client          | Called after `document.startViewTransition` is called when [experimental viewTransition support is enabled](/docs/4.x/getting-started/transitions#view-transitions-api-experimental). |
+
+## Nuxt Hooks (build time)
+
+Check the [schema source code](https://github.com/nuxt/nuxt/blob/main/packages/schema/src/types/hooks.ts#L83) for all available hooks.
+
+| Hook                        | Arguments                                                | Description                                                                                                                                                                                                                                                                                  |
+|-----------------------------|----------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `kit:compatibility`         | `compatibility, issues`                                  | Allows extending compatibility checks.                                                                                                                                                                                                                                                       |
+| `ready`                     | `nuxt`                                                   | Called after Nuxt initialization, when the Nuxt instance is ready to work.                                                                                                                                                                                                                   |
+| `close`                     | `nuxt`                                                   | Called when Nuxt instance is gracefully closing.                                                                                                                                                                                                                                             |
+| `restart`                   | `{ hard?: boolean }`                                     | To be called to restart the current Nuxt instance.                                                                                                                                                                                                                                           |
+| `modules:before`            | -                                                        | Called during Nuxt initialization, before installing user modules.                                                                                                                                                                                                                           |
+| `modules:done`              | -                                                        | Called during Nuxt initialization, after installing user modules.                                                                                                                                                                                                                            |
+| `app:resolve`               | `app`                                                    | Called after resolving the `app` instance.                                                                                                                                                                                                                                                   |
+| `app:templates`             | `app`                                                    | Called during `NuxtApp` generation, to allow customizing, modifying or adding new files to the build directory (either virtually or to written to `.nuxt`).                                                                                                                                  |
+| `app:templatesGenerated`    | `app`                                                    | Called after templates are compiled into the [virtual file system](/docs/4.x/directory-structure/nuxt) (vfs).                                                                                                                                                                                |
+| `build:before`              | -                                                        | Called before Nuxt bundle builder.                                                                                                                                                                                                                                                           |
+| `build:done`                | -                                                        | Called after Nuxt bundle builder is complete.                                                                                                                                                                                                                                                |
+| `build:manifest`            | `manifest`                                               | Called during the manifest build by Vite and webpack. This allows customizing the manifest that Nitro will use to render `<script>` and `<link>` tags in the final HTML.                                                                                                                     |
+| `builder:generateApp`       | `options`                                                | Called before generating the app.                                                                                                                                                                                                                                                            |
+| `builder:watch`             | `event, path`                                            | Called at build time in development when the watcher spots a change to a file or directory in the project.                                                                                                                                                                                   |
+| `pages:extend`              | `pages`                                                  | Called after page routes are scanned from the file system.                                                                                                                                                                                                                                   |
+| `pages:resolved`            | `pages`                                                  | Called after page routes have been augmented with scanned metadata.                                                                                                                                                                                                                          |
+| `pages:routerOptions`       | `{ files: Array<{ path: string, optional?: boolean }> }` | Called when resolving `router.options` files. Later items in the array override earlier ones.                                                                                                                                                                                                |
+| `server:devHandler`         | `handler`                                                | Called when the dev middleware is being registered on the Nitro dev server.                                                                                                                                                                                                                  |
+| `imports:sources`           | `presets`                                                | Called at setup allowing modules to extend sources.                                                                                                                                                                                                                                          |
+| `imports:extend`            | `imports`                                                | Called at setup allowing modules to extend imports.                                                                                                                                                                                                                                          |
+| `imports:context`           | `context`                                                | Called when the [unimport](https://github.com/unjs/unimport) context is created.                                                                                                                                                                                                             |
+| `imports:dirs`              | `dirs`                                                   | Allows extending import directories.                                                                                                                                                                                                                                                         |
+| `components:dirs`           | `dirs`                                                   | Called within `app:resolve` allowing to extend the directories that are scanned for auto-importable components.                                                                                                                                                                              |
+| `components:extend`         | `components`                                             | Allows extending new components.                                                                                                                                                                                                                                                             |
+| `nitro:config`              | `nitroConfig`                                            | Called before initializing Nitro, allowing customization of Nitro's configuration.                                                                                                                                                                                                           |
+| `nitro:init`                | `nitro`                                                  | Called after Nitro is initialized, which allows registering Nitro hooks and interacting directly with Nitro.                                                                                                                                                                                 |
+| `nitro:build:before`        | `nitro`                                                  | Called before building the Nitro instance.                                                                                                                                                                                                                                                   |
+| `nitro:build:public-assets` | `nitro`                                                  | Called after copying public assets. Allows modifying public assets before Nitro server is built.                                                                                                                                                                                             |
+| `prerender:routes`          | `ctx`                                                    | Allows extending the routes to be pre-rendered.                                                                                                                                                                                                                                              |
+| `build:error`               | `error`                                                  | Called when an error occurs at build time.                                                                                                                                                                                                                                                   |
+| `prepare:types`             | `options`                                                | Called before `@nuxt/cli` writes TypeScript configuration files (`.nuxt/tsconfig.app.json`, `.nuxt/tsconfig.server.json`, etc.) and `.nuxt/nuxt.d.ts`, allowing addition of custom references and declarations in `nuxt.d.ts`, or directly modifying the options in generated configurations |
+| `listen`                    | `listenerServer, listener`                               | Called when the dev server is loading.                                                                                                                                                                                                                                                       |
+| `schema:extend`             | `schemas`                                                | Allows extending default schemas.                                                                                                                                                                                                                                                            |
+| `schema:resolved`           | `schema`                                                 | Allows extending resolved schema.                                                                                                                                                                                                                                                            |
+| `schema:beforeWrite`        | `schema`                                                 | Called before writing the given schema.                                                                                                                                                                                                                                                      |
+| `schema:written`            | -                                                        | Called after the schema is written.                                                                                                                                                                                                                                                          |
+| `vite:extend`               | `viteBuildContext`                                       | Allows extending Vite default context.                                                                                                                                                                                                                                                       |
+| `vite:extendConfig`         | `viteInlineConfig, env`                                  | Allows extending Vite default config. **Deprecated in Nuxt 5+.** In Nuxt 5, this operates on a shared configuration rather than separate client/server configs.                                                                                                                              |
+| `vite:configResolved`       | `viteInlineConfig, env`                                  | Allows reading the resolved Vite config. **Deprecated in Nuxt 5+.** In Nuxt 5, this operates on a shared configuration rather than separate client/server configs.                                                                                                                           |
+| `vite:serverCreated`        | `viteServer, env`                                        | Called when the Vite server is created.                                                                                                                                                                                                                                                      |
+| `vite:compiled`             | -                                                        | Called after Vite server is compiled.                                                                                                                                                                                                                                                        |
+| `webpack:config`            | `webpackConfigs`                                         | Called before configuring the webpack compiler.                                                                                                                                                                                                                                              |
+| `webpack:configResolved`    | `webpackConfigs`                                         | Allows reading the resolved webpack config.                                                                                                                                                                                                                                                  |
+| `webpack:compile`           | `options`                                                | Called right before compilation.                                                                                                                                                                                                                                                             |
+| `webpack:compiled`          | `options`                                                | Called after resources are loaded.                                                                                                                                                                                                                                                           |
+| `webpack:change`            | `shortPath`                                              | Called on `change` on WebpackBar.                                                                                                                                                                                                                                                            |
+| `webpack:error`             | -                                                        | Called on `done` if has errors on WebpackBar.                                                                                                                                                                                                                                                |
+| `webpack:done`              | -                                                        | Called on `allDone` on WebpackBar.                                                                                                                                                                                                                                                           |
+| `webpack:progress`          | `statesArray`                                            | Called on `progress` on WebpackBar.                                                                                                                                                                                                                                                          |
+
+## Nitro App Hooks (runtime, server-side)
+
+See [Nitro](https://nitro.build/guide/plugins#available-hooks) for all available hooks.
+
+| Hook              | Arguments                                  | Description                                 | Types                                                                                                                                                                                                                                                                                                                                                                                                   |
+|-------------------|--------------------------------------------|---------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `dev:ssr-logs`    | `{ path, logs }`                           | Server                                      | Called at the end of a request cycle with an array of server-side logs.                                                                                                                                                                                                                                                                                                                                 |
+| `render:response` | `response, { event }`                      | Called before sending the response.         | [response](https://github.com/nuxt/nuxt/blob/71ef8bd3ff207fd51c2ca18d5a8c7140476780c7/packages/nuxt/src/core/runtime/nitro/renderer.ts#L24), [event](https://github.com/h3js/h3/blob/f6ceb5581043dc4d8b6eab91e9be4531e0c30f8e/src/types.ts#L38)                                                                                                                                                         |
+| `render:html`     | `html, { event }`                          | Called before constructing the HTML.        | [html](https://github.com/nuxt/nuxt/blob/71ef8bd3ff207fd51c2ca18d5a8c7140476780c7/packages/nuxt/src/core/runtime/nitro/renderer.ts#L15), [event](https://github.com/h3js/h3/blob/f6ceb5581043dc4d8b6eab91e9be4531e0c30f8e/src/types.ts#L38)                                                                                                                                                             |
+| `render:island`   | `islandResponse, { event, islandContext }` | Called before constructing the island HTML. | [islandResponse](https://github.com/nuxt/nuxt/blob/e50cabfed1984c341af0d0c056a325a8aec26980/packages/nuxt/src/core/runtime/nitro/renderer.ts#L28), [event](https://github.com/h3js/h3/blob/f6ceb5581043dc4d8b6eab91e9be4531e0c30f8e/src/types.ts#L38), [islandContext](https://github.com/nuxt/nuxt/blob/e50cabfed1984c341af0d0c056a325a8aec26980/packages/nuxt/src/core/runtime/nitro/renderer.ts#L38) |
+| `close`           | -                                          | Called when Nitro is closed.                | -                                                                                                                                                                                                                                                                                                                                                                                                       |
+| `error`           | `error, { event? }`                        | Called when an error occurs.                | [error](https://github.com/nitrojs/nitro/blob/d20ffcbd16fc4003b774445e1a01e698c2bb078a/src/types/runtime/nitro.ts#L48), [event](https://github.com/h3js/h3/blob/f6ceb5581043dc4d8b6eab91e9be4531e0c30f8e/src/types.ts#L38)                                                                                                                                                                              |
+| `request`         | `event`                                    | Called when a request is received.          | [event](https://github.com/h3js/h3/blob/f6ceb5581043dc4d8b6eab91e9be4531e0c30f8e/src/types.ts#L38)                                                                                                                                                                                                                                                                                                      |
+| `beforeResponse`  | `event, { body }`                          | Called before sending the response.         | [event](https://github.com/h3js/h3/blob/f6ceb5581043dc4d8b6eab91e9be4531e0c30f8e/src/types.ts#L38), unknown                                                                                                                                                                                                                                                                                             |
+| `afterResponse`   | `event, { body }`                          | Called after sending the response.          | [event](https://github.com/h3js/h3/blob/f6ceb5581043dc4d8b6eab91e9be4531e0c30f8e/src/types.ts#L38), unknown                                                                                                                                                                                                                                                                                             |

package/{3.api → 4.api}/6.nuxt-config.md

@@ -210,7 +210,7 @@ Default values for layout transitions.
 
 This can be overridden with `definePageMeta` on an individual page. Only JSON-serializable values are allowed.
 
-- **Type**: `boolean`
+- **Type**: `boolean | TransitionProps`
 - **Default:** `false`
 
 **See**: [Vue Transition docs](https://vuejs.org/api/built-in-components#transition)
@@ -221,7 +221,7 @@ Default values for page transitions.
 
 This can be overridden with `definePageMeta` on an individual page. Only JSON-serializable values are allowed.
 
-- **Type**: `boolean`
+- **Type**: `boolean | TransitionProps`
 - **Default:** `false`
 
 **See**: [Vue Transition docs](https://vuejs.org/api/built-in-components#transition)
@@ -505,7 +505,7 @@ Any components in the directories configured here can be used throughout your pa
 }
 ```
 
-**See**: [`app/components/` directory documentation](https://nuxt.com/docs/4.x/guide/directory-structure/app/components)
+**See**: [`app/components/` directory documentation](https://nuxt.com/docs/4.x/directory-structure/app/components)
 
 ## css
 
@@ -801,6 +801,7 @@ More customizable than `ignorePrefix`: all files matching glob patterns specifie
   "**/*.stories.{js,cts,mts,ts,jsx,tsx}",
   "**/*.{spec,test}.{js,cts,mts,ts,jsx,tsx}",
   "**/*.d.{cts,mts,ts}",
+  "**/*.d.vue.{cts,mts,ts}",
   "**/.{pnpm-store,vercel,netlify,output,git,cache,data}",
   "**/*.sock",
   ".nuxt/analyze",
@@ -835,7 +836,7 @@ Any file in `app/pages/`, `app/layouts/`, `app/middleware/`, and `public/` direc
 
 Configure how Nuxt auto-imports composables into your application.
 
-**See**: [Nuxt documentation](https://nuxt.com/docs/4.x/guide/directory-structure/app/composables)
+**See**: [Nuxt documentation](https://nuxt.com/docs/4.x/directory-structure/app/composables)
 
 ### `dirs`
 
@@ -1146,7 +1147,7 @@ and these plugins do not need to be listed in `nuxt.config` unless you
 need to customize their order. All plugins are deduplicated by their src path.
 ::
 
-**See**: [`app/plugins/` directory documentation](https://nuxt.com/docs/4.x/guide/directory-structure/app/plugins)
+**See**: [`app/plugins/` directory documentation](https://nuxt.com/docs/4.x/directory-structure/app/plugins)
 
 **Example**:
 ```ts
@@ -1307,7 +1308,7 @@ Each handler accepts the following options:
 
 - **Type**: `array`
 
-**See**: [`server/` directory documentation](https://nuxt.com/docs/4.x/guide/directory-structure/server)
+**See**: [`server/` directory documentation](https://nuxt.com/docs/4.x/directory-structure/server)
 
 ::callout
 **Note**: Files from `server/api`, `server/middleware` and `server/routes` will be automatically registered by Nuxt.

package/5.community/4.contribution.md

@@ -11,7 +11,7 @@ There is a range of different ways you might be able to contribute to the Nuxt e
 The Nuxt ecosystem includes many different projects and organizations:
 
 * [nuxt/](https://github.com/nuxt) - core repositories for the Nuxt framework itself. [**nuxt/nuxt**](https://github.com/nuxt/nuxt) contains the Nuxt framework (both versions 2 and 3).
-* [nuxt-modules/](https://github.com/nuxt-modules) - community-contributed and maintained modules and libraries. There is a [process to migrate a module](/docs/4.x/guide/going-further/modules/#joining-nuxt-modules-and-nuxtjs) to `nuxt-modules`. While these modules have individual maintainers, they are not dependent on a single person.
+* [nuxt-modules/](https://github.com/nuxt-modules) - community-contributed and maintained modules and libraries. There is a [process to migrate a module](/docs/4.x/guide/modules/ecosystem) to `nuxt-modules`. While these modules have individual maintainers, they are not dependent on a single person.
 * [unjs/](https://github.com/unjs) - many of these libraries are used throughout the Nuxt ecosystem. They are designed to be universal libraries that are framework- and environment-agnostic. We welcome contributions and usage by other frameworks and projects.
 
 ## How To Contribute
@@ -100,7 +100,7 @@ Our aim is ensuring quality and maintaining the joy of collaborating and communi
 
 ### Create a Module
 
-If you've built something with Nuxt that's cool, why not [extract it into a module](/docs/4.x/guide/going-further/modules), so it can be shared with others? We have [many excellent modules already](/modules), but there's always room for more.
+If you've built something with Nuxt that's cool, why not [extract it into a module](/docs/4.x/guide/modules), so it can be shared with others? We have [many excellent modules already](/modules), but there's always room for more.
 
 If you need help while building it, feel free to [check in with us](/docs/4.x/community/getting-help).
 
@@ -126,7 +126,7 @@ The following conventions are _required_ within the `nuxt/` organization and rec
 
 #### Module Conventions
 
-Modules should follow the [Nuxt module template](https://github.com/nuxt/starter/tree/module). See [module guide](/docs/4.x/guide/going-further/modules) for more information.
+Modules should follow the [Nuxt module template](https://github.com/nuxt/starter/tree/module). See [module guide](/docs/4.x/guide/modules) for more information.
 
 #### Use Core `unjs/` Libraries
 
@@ -134,7 +134,7 @@ We recommend the following libraries which are used throughout the ecosystem:
 
 * [pathe](https://github.com/unjs/pathe) - universal path utilities (replacement for node `path`)
 * [ufo](https://github.com/unjs/ufo) - URL parsing and joining utilities
-* [unbuild](https://github.com/unjs/unbuild) - rollup-powered build system
+* [obuild](https://github.com/unjs/obuild) - rolldown-powered build system
 * ... check out the rest of the [unjs/](https://github.com/unjs) organization for many more!
 
 #### Use ESM Syntax and Default to `type: module`
@@ -172,7 +172,7 @@ We recommend using [VS Code](https://code.visualstudio.com) along with the [ESLi
 
 #### No Prettier
 
-Since ESLint is already configured to format the code, there is no need to duplicate the functionality with Prettier. To format the code, you can run `yarn lint --fix`, `pnpm lint --fix`, or `bun run lint --fix` or referring the [ESLint section](/docs/4.x/community/contribution#use-eslint) for IDE Setup.
+Since ESLint is already configured to format the code, there is no need to duplicate the functionality with Prettier. To format the code, you can run `yarn lint --fix`, `pnpm lint --fix`, `bun run lint --fix`, or `deno run lint --fix` or referring the [ESLint section](/docs/4.x/community/contribution#use-eslint) for IDE Setup.
 
 If you have Prettier installed in your editor, we recommend you disable it when working on the project to avoid conflict.
 

package/5.community/5.framework-contribution.md

@@ -8,7 +8,7 @@ Once you've read the [general contribution guide](/docs/4.x/community/contributi
 
 ## Monorepo Guide
 
-- `packages/kit`: Toolkit for authoring Nuxt Modules, published as [`@nuxt/kit`](https://www.npmjs.com/package/@nuxt/kit).
+- `packages/kit`: Toolkit for authoring Nuxt modules, published as [`@nuxt/kit`](https://www.npmjs.com/package/@nuxt/kit).
 - `packages/nuxt`: The core of Nuxt, published as [`nuxt`](https://www.npmjs.com/package/nuxt).
 - `packages/schema`: Cross-version Nuxt typedefs and defaults, published as [`@nuxt/schema`](https://www.npmjs.com/package/@nuxt/schema).
 - `packages/rspack`: The [Rspack](https://rspack.rs) bundler for Nuxt, published as [`@nuxt/rspack-builder`](https://www.npmjs.com/package/@nuxt/rspack-builder).

package/5.community/6.roadmap.md

@@ -28,22 +28,22 @@ In roadmap below are some features we are planning or working on at the moment.
 Check [Discussions](https://github.com/nuxt/nuxt/discussions) and [RFCs](https://github.com/nuxt/nuxt/discussions/categories/rfcs) for more upcoming features and ideas.
 ::
 
-Milestone    | Expected date | Notes                                                                  | Description
--------------|---------------|------------------------------------------------------------------------|-----------------------
-SEO & PWA    | 2025          | [nuxt/nuxt#18395](https://github.com/nuxt/nuxt/discussions/18395)      | Migrating from [nuxt-community/pwa-module](https://github.com/nuxt-community/pwa-module) for built-in SEO utils and service worker support
-Assets       | 2025          | [nuxt/nuxt#22012](https://github.com/nuxt/nuxt/discussions/22012)      | Allow developers and modules to handle loading third-party assets.
-Translations | -             | [nuxt/nuxt.com#1711](https://github.com/nuxt/nuxt.com/issues/1711)     | A collaborative project for a stable translation process for Nuxt docs. Currently pending for ideas and documentation tooling support.
+| Milestone    | Expected date | Notes                                                              | Description                                                                                                                                |
+|--------------|---------------|--------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------|
+| SEO & PWA    | 2025          | [nuxt/nuxt#18395](https://github.com/nuxt/nuxt/discussions/18395)  | Migrating from [nuxt-community/pwa-module](https://github.com/nuxt-community/pwa-module) for built-in SEO utils and service worker support |
+| Assets       | 2025          | [nuxt/nuxt#22012](https://github.com/nuxt/nuxt/discussions/22012)  | Allow developers and modules to handle loading third-party assets.                                                                         |
+| Translations | -             | [nuxt/nuxt.com#1711](https://github.com/nuxt/nuxt.com/issues/1711) | A collaborative project for a stable translation process for Nuxt docs. Currently pending for ideas and documentation tooling support.     |
 
 ## Core Modules Roadmap
 
 In addition to the Nuxt framework, there are modules that are vital for the ecosystem. Their status will be updated below.
 
-Module                              | Status              | Nuxt Support | Repository | Description
-------------------------------------|---------------------|--------------|------------|-------------------
-[Scripts](https://scripts.nuxt.com) | Public Beta         | 3.x, 4.x     | [nuxt/scripts](https://github.com/nuxt/scripts) | Easy 3rd party script management.
-Auth Utils                          | Planned             | 4.x, 5.x     | `nuxt/auth-utils` to be announced | The temporary repository [atinux/nuxt-auth-utils](https://github.com/atinux/nuxt-auth-utils) is available while awaiting its official integration into Nuxt via RFC.
-A11y                                | Planned             | 4.x, 5.x     | `nuxt/a11y` to be announced | Accessibility hinting and utilities [nuxt/nuxt#23255](https://github.com/nuxt/nuxt/issues/23255)
-Hints                               | Planned             | 4.x, 5.x     | `nuxt/hints` to be announced | Guidance and suggestions for enhancing development practices.
+| Module                                 | Status       | Nuxt Support | Repository                                      | Description                                                                                                                                                          |
+|----------------------------------------|--------------|--------------|-------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| [Scripts](https://scripts.nuxt.com)    | Public Beta  | 3.x, 4.x     | [nuxt/scripts](https://github.com/nuxt/scripts) | Easy 3rd party script management.                                                                                                                                    |
+| Auth Utils                             | Planned      | 4.x, 5.x     | `nuxt/auth-utils` to be announced               | The temporary repository [atinux/nuxt-auth-utils](https://github.com/atinux/nuxt-auth-utils) is available while awaiting its official integration into Nuxt via RFC. |
+| [a11y](https://github.com/nuxt/a11y)   | Public Alpha | 3.x, 4.x     | [nuxt/a11y](https://github.com/nuxt/a11y).      | Real-time accessibility feedback and automated testing in your browser during development (see [nuxt/nuxt#23255](https://github.com/nuxt/nuxt/issues/23255)).        |
+| [Hints](https://github.com/nuxt/hints) | Public Alpha | 4.x, 5.x     | [nuxt/hints](https://github.com/nuxt/hints)     | Guidance and suggestions for enhancing development practices.                                                                                                        |
 
 ## Release Cycle
 
@@ -65,20 +65,20 @@ Nuxt 3 will continue to receive maintenance updates (both bug fixes and backport
 
 Each active version has its own nightly releases which are generated automatically. For more about enabling the Nuxt nightly release channel, see [the nightly release channel docs](/docs/4.x/guide/going-further/nightly-release-channel).
 
-Release                    |                                                                                                                                                                               | Initial release       | End Of Life                  | Docs
--------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | ---------------------------- | ---------------------------------------
-**5.x** (scheduled)        |                                                                                                                                                                               | Q4 2025 (estimated)   | TBA                          |  
-**4.x** (stable)           | <a href="https://www.npmjs.com/package/nuxt?activeTab=versions"><img alt="Nuxt latest version" src="https://flat.badgen.net/npm/v/nuxt?label=" class="not-prose"></a>         | 2025-07-16            | 6 months after 5.x release   | [nuxt.com](/docs/4.x/getting-started/introduction)
-**3.x** (maintenance)      | <a href="https://www.npmjs.com/package/nuxt?activeTab=versions"><img alt="Nuxt 3.x version" src="https://flat.badgen.net/npm/v/nuxt/3x?label=" class="not-prose"></a>         | 2022-11-16            | 2026-01-31                   | [nuxt.com](/docs/3.x/getting-started/introduction)
-**2.x** (unsupported)      | <a href="https://www.npmjs.com/package/nuxt?activeTab=versions"><img alt="Nuxt 2.x version" src="https://flat.badgen.net/npm/v/nuxt/2x?label=" class="not-prose"></a>         | 2018-09-21            | 2024-06-30                   | [v2.nuxt.com](https://v2.nuxt.com/docs/get-started/installation/)
-**1.x** (unsupported)      | <a href="https://www.npmjs.com/package/nuxt?activeTab=versions"><img alt="Nuxt 1.x version" src="https://flat.badgen.net/npm/v/nuxt/1x?label=" class="not-prose"></a>         | 2018-01-08            | 2019-09-21                   | &nbsp;
+| Release               |                                                                                                                                                                                                                                                    | Initial release     | End Of Life                | Docs                                                              |
+|-----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------|----------------------------|-------------------------------------------------------------------|
+| **5.x** (scheduled)   |                                                                                                                                                                                                                                                    | Q4 2025 (estimated) | TBA                        | &nbsp;                                                            |
+| **4.x** (stable)      | <a href="https://www.npmjs.com/package/nuxt?activeTab=versions"><img alt="Nuxt latest version" src="https://img.shields.io/npm/v/nuxt.svg?logo=nuxt&label=&style=flat&colorA=18181B&colorB=28CF8D" class="not-prose h-5 w-auto" :zoom="false"></a> | 2025-07-16          | 6 months after 5.x release | [nuxt.com](/docs/4.x/getting-started/introduction)                |
+| **3.x** (maintenance) | <a href="https://www.npmjs.com/package/nuxt?activeTab=versions"><img alt="Nuxt 3.x version" src="https://img.shields.io/npm/v/nuxt/3x.svg?logo=nuxt&label=&style=flat&colorA=18181B&colorB=28CF8D" class="not-prose h-5 w-auto" :zoom="false"></a> | 2022-11-16          | 2026-01-31                 | [nuxt.com](/docs/3.x/getting-started/introduction)                |
+| **2.x** (unsupported) | <a href="https://www.npmjs.com/package/nuxt?activeTab=versions"><img alt="Nuxt 2.x version" src="https://img.shields.io/npm/v/nuxt/2x.svg?logo=nuxt&label=&style=flat&colorA=18181B&colorB=28CF8D" class="not-prose h-5 w-auto" :zoom="false"></a> | 2018-09-21          | 2024-06-30                 | [v2.nuxt.com](https://v2.nuxt.com/docs/get-started/installation/) |
+| **1.x** (unsupported) | <a href="https://www.npmjs.com/package/nuxt?activeTab=versions"><img alt="Nuxt 1.x version" src="https://img.shields.io/npm/v/nuxt/1x.svg?logo=nuxt&label=&style=flat&colorA=18181B&colorB=28CF8D" class="not-prose h-5 w-auto" :zoom="false"></a> | 2018-01-08          | 2019-09-21                 | &nbsp;                                                            |
 
 ### Support Status
 
-Status      | Description
-------------|----------------------------------------------------------------------------------
-Unsupported | This version is not maintained any more and will not receive security patches
-Maintenance | This version will only receive security patches
-Stable      | This version is being developed for and will receive security patches
-Development | This version could be unstable
-Scheduled   | This version does not exist yet but is planned
+| Status      | Description                                                                   |
+|-------------|-------------------------------------------------------------------------------|
+| Unsupported | This version is not maintained any more and will not receive security patches |
+| Maintenance | This version will only receive security patches                               |
+| Stable      | This version is being developed for and will receive security patches         |
+| Development | This version could be unstable                                                |
+| Scheduled   | This version does not exist yet but is planned                                |

package/5.community/7.changelog.md

@@ -28,6 +28,16 @@ navigation.icon: i-lucide-bell-dot
   ::card
   ---
   icon: i-simple-icons-github
+  title: nuxt/a11y
+  to: https://github.com/nuxt/a11y/releases
+  target: _blank
+  ui.icon.base: text-black dark:text-white
+  ---
+  Nuxt A11y releases.
+  ::
+  ::card
+  ---
+  icon: i-simple-icons-github
   title: nuxt/content
   to: https://github.com/nuxt/content/releases
   target: _blank
@@ -58,6 +68,16 @@ navigation.icon: i-lucide-bell-dot
   ::card
   ---
   icon: i-simple-icons-github
+  title: nuxt/hints
+  to: https://github.com/nuxt/hints/releases
+  target: _blank
+  ui.icon.base: text-black dark:text-white
+  ---
+  Nuxt Hints releases.
+  ::
+  ::card
+  ---
+  icon: i-simple-icons-github
   title: nuxt/image
   to: https://github.com/nuxt/image/releases
   target: _blank