@nuxt/docs-nightly 4.2.0-29336619.cf102e88 → 4.2.0-29344147.7bcc4ca3

package/2.guide/3.going-further/7.layers.md

@@ -234,22 +234,30 @@ export default defineNuxtConfig({
 
 ## Multi-Layer Support for Nuxt Modules
 
-You can use the internal array `nuxt.options._layers` to support custom multi-layer handling for your modules.
+You can use the [`getLayerDirectories`](/docs/api/kit/layers#getlayerdirectories) utility from Nuxt Kit to support custom multi-layer handling for your modules.
 
 ```ts [modules/my-module.ts]
+import { defineNuxtModule, getLayerDirectories } from 'nuxt/kit'
+
 export default defineNuxtModule({
   setup (_options, nuxt) {
-    for (const layer of nuxt.options._layers) {
-      // You can check for a custom directory existence to extend for each layer
-      console.log('Custom extension for', layer.cwd, layer.config)
+    const layerDirs = getLayerDirectories()
+
+    for (const [index, layer] of layerDirs.entries()) {
+      console.log(`Layer ${index}:`)
+      console.log(`  Root: ${layer.root}`)
+      console.log(`  App: ${layer.app}`)
+      console.log(`  Server: ${layer.server}`)
+      console.log(`  Pages: ${layer.appPages}`)
+      // ... other directories
     }
   },
 })
 ```
 
 **Notes:**
-- Earlier items in the `_layers` array have higher priority and override later ones
-- The user's project is the first item in the `_layers` array
+- Earlier items in the array have higher priority and override later ones
+- The user's project is the first item in the array
 
 ## Going Deeper
 

package/3.api/6.nuxt-config.md

@@ -424,9 +424,60 @@ A unique identifier matching the build. This may contain the hash of the current
 
 The builder to use for bundling the Vue part of your application.
 
-- **Type**: `string`
+Nuxt supports multiple builders for the client-side application. By default, Vite is used, but you can switch to webpack, Rspack, or even provide a custom builder implementation.
+
+- **Type**: `'vite' | 'webpack' | 'rspack' | string | { bundle: (nuxt: Nuxt) => Promise<void> }`
 - **Default:** `"@nuxt/vite-builder"`
 
+**Using supported builders:**
+
+```ts
+export default defineNuxtConfig({
+  // default - uses @nuxt/vite-builder
+  // builder: 'vite',
+
+  // uses @nuxt/webpack-builder
+  // builder: 'webpack',
+
+  // uses @nuxt/rspack-builder
+  builder: 'rspack',
+})
+```
+
+If you are using `webpack` or `rspack` you will need to make sure `@nuxt/webpack-builder` or `@nuxt/rspack-builder` is explicitly installed in your project.
+
+**Using a custom builder object:**
+
+You can provide a custom builder by passing an object with a `bundle` function:
+
+```ts
+export default defineNuxtConfig({
+  builder: {
+    async bundle (nuxt) {
+      const entry = await resolvePath(resolve(nuxt.options.appDir, 'entry'))
+
+      // Build client and server bundles
+      await buildClient(nuxt, entry)
+      if (nuxt.options.ssr) {
+        await buildServer(nuxt, entry)
+      }
+
+      // ... it's a bit more complicated than that, of course!
+    },
+  },
+})
+```
+
+**Creating a custom builder package:**
+
+To create a custom builder as a separate package, it should export a `bundle` function. You can then specify the package name in your `nuxt.config.ts`:
+
+```ts
+export default defineNuxtConfig({
+  builder: 'my-custom-builder',
+})
+```
+
 ## compatibilityDate
 
 Specify a compatibility date for your app.
@@ -1218,6 +1269,23 @@ export default defineNuxtConfig({
 })
 ```
 
+## server
+
+Configuration for Nuxt's server builder.
+
+### `builder`
+
+Specify the server builder to use for bundling the server part of your application.
+
+By default, Nuxt uses `@nuxt/nitro-server`, which provides standalone Nitro integration. This architecture allows for different Nitro integration patterns, such as using Nitro as a Vite plugin (with the Vite Environment API).
+
+- **Type**: `string | { bundle: (nuxt: Nuxt) => Promise<void> }`
+- **Default:** `"@nuxt/nitro-server"`
+
+::callout{type="warning"}
+This option is intended for internal use and the API is not finalized. Please open an issue before relying on the current implementation.
+::
+
 ## serverDir
 
 Define the server directory of your Nuxt application, where Nitro routes, middleware and plugins are kept.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuxt/docs-nightly",
-  "version": "4.2.0-29336619.cf102e88",
+  "version": "4.2.0-29344147.7bcc4ca3",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/nuxt/nuxt.git",