@nuxt/docs-nightly 4.1.3-29313386.edc02e27 → 4.1.3-29316215.910d159d

package/2.guide/3.going-further/1.features.md

@@ -7,29 +7,51 @@ Some features of Nuxt are available on an opt-in basis, or can be disabled based
 
 ## `features`
 
+### devLogs
+
+Stream server logs to the client as you are developing. These logs can be handled in the `dev:ssr-logs` hook.
+
+By default, this is enabled in development (when test mode is not active).
+
+If set to `silent`, the logs will not be printed to the browser console.
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+  features: {
+    devLogs: true,
+  },
+})
+```
+
 ### inlineStyles
 
 Inlines styles when rendering HTML. This is currently available only when using Vite.
 
 You can also pass a function that receives the path of a Vue component and returns a boolean indicating whether to inline the styles for that component.
 
+It defaults to `(id) => id.includes('.vue')`.
+
 ```ts [nuxt.config.ts]
 export default defineNuxtConfig({
   features: {
-    inlineStyles: false // or a function to determine inlining
-  }
+    inlineStyles: false, // or a function to determine inlining
+  },
 })
 ```
 
 ### noScripts
 
-Disables rendering of Nuxt scripts and JS resource hints. Can also be configured granularly within `routeRules`.
+Turn off rendering of Nuxt scripts and JavaScript resource hints. Can also be configured granularly within `routeRules`.
+
+You can also disable scripts more granularly within `routeRules`.
+
+If set to 'production' or `true`, JavaScript will be disabled in production mode only. If set to 'all', JavaScript will be disabled in both development and production modes.
 
 ```ts [nuxt.config.ts]
 export default defineNuxtConfig({
   features: {
-    noScripts: true
-  }
+    noScripts: true, // or 'production' | 'all' | false
+  },
 })
 ```
 
@@ -43,19 +65,32 @@ This is used for enabling early access to Nuxt features or flags.
 
 It is not configurable yet in Nuxt 4, but once we begin merging breaking changes for v5, it will be possible to enable it.
 
+### multiApp
+
+This enables early access to the experimental multi-app support. You can follow the [tracker issue #21635](https://github.com/nuxt/nuxt/issues/21635) to see the progress of multi-app support in Nuxt.
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+  future: {
+    multiApp: true,
+  },
+})
+```
+
 ### typescriptBundlerResolution
 
-This enables 'Bundler' module resolution mode for TypeScript, which is the recommended setting
-for frameworks like Nuxt and [Vite](https://vite.dev/guide/performance.html#reduce-resolve-operations).
+This enables 'Bundler' module resolution mode for TypeScript, which is the recommended setting for frameworks like Nuxt and [Vite](https://vite.dev/guide/performance.html#reduce-resolve-operations).
 
 It improves type support when using modern libraries with `exports`.
 
 See [the original TypeScript pull request](https://github.com/microsoft/TypeScript/pull/51669).
 
+You can set it to false to use the legacy 'Node' mode, which is the default for TypeScript.
+
 ```ts [nuxt.config.ts]
 export default defineNuxtConfig({
   future: {
-    typescriptBundlerResolution: true
-  }
+    typescriptBundlerResolution: false,
+  },
 })
 ```

package/2.guide/3.going-further/1.internals.md

@@ -36,31 +36,31 @@ Check [Nuxt App](/docs/4.x/api/composables/use-nuxt-app) for more information ab
 
 `nuxtApp` has the following properties:
 
-```js
-const nuxtApp = {
-  vueApp, // the global Vue application: https://vuejs.org/api/application.html#application-api
+```ts
+interface NuxtApp {
+  vueApp // the global Vue application: https://vuejs.org/api/application.html#application-api
 
-  versions, // an object containing Nuxt and Vue versions
+  versions // an object containing Nuxt and Vue versions
 
   // These let you call and add runtime NuxtApp hooks
   // https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/nuxt.ts#L18
-  hooks,
-  hook,
-  callHook,
+  hooks
+  hook
+  callHook
 
   // Only accessible on server-side
   ssrContext: {
-    url,
-    req,
-    res,
-    runtimeConfig,
-    noSSR,
-  },
+    url
+    req
+    res
+    runtimeConfig
+    noSSR
+  }
 
   // This will be stringified and passed from server to client
   payload: {
-    serverRendered: true,
-    data: {},
+    serverRendered: true
+    data: {}
     state: {}
   }
 

package/2.guide/3.going-further/10.runtime-config.md

@@ -14,9 +14,9 @@ export default defineNuxtConfig({
     apiSecret: '123',
     // Keys within public, will be also exposed to the client-side
     public: {
-      apiBase: '/api'
-    }
-  }
+      apiBase: '/api',
+    },
+  },
 })
 ```
 
@@ -45,7 +45,7 @@ The most common way to provide configuration is by using [Environment Variables]
 
 ::note
 The Nuxt CLI has built-in support for reading your `.env` file in development, build and generate. But when you run your built server, **your `.env` file will not be read**.
-:read-more{to="/docs/guide/directory-structure/env"}
+:read-more{to="/docs/4.x/guide/directory-structure/env"}
 ::
 
 Runtime config values are **automatically replaced by matching environment variables at runtime**.
@@ -78,7 +78,7 @@ export default defineNuxtConfig({
     apiSecret: '', // can be overridden by NUXT_API_SECRET environment variable
     public: {
       apiBase: '', // can be overridden by NUXT_PUBLIC_API_BASE environment variable
-    }
+    },
   },
 })
 ```
@@ -127,7 +127,7 @@ export default defineNuxtPlugin((nuxtApp) => {
   const config = useRuntimeConfig()
 
   console.log('API base URL:', config.public.apiBase)
-});
+})
 ```
 
 ### Server Routes
@@ -139,8 +139,8 @@ export default defineEventHandler(async (event) => {
   const { apiSecret } = useRuntimeConfig(event)
   const result = await $fetch('https://my.api.com/test', {
     headers: {
-      Authorization: `Bearer ${apiSecret}`
-    }
+      Authorization: `Bearer ${apiSecret}`,
+    },
   })
   return result
 })

package/2.guide/3.going-further/11.nightly-release-channel.md

@@ -57,6 +57,6 @@ To try the latest version of [nuxt/cli](https://github.com/nuxt/cli):
 npx @nuxt/cli-nightly@latest [command]
 ```
 
-::read-more{to="/docs/api/commands"}
+::read-more{to="/docs/4.x/api/commands"}
 Read more about the available commands.
 ::

package/2.guide/3.going-further/2.hooks.md

@@ -13,11 +13,11 @@ These hooks are available for [Nuxt Modules](/docs/4.x/guide/going-further/modul
 
 ### Within `nuxt.config.ts`
 
-```js [nuxt.config.ts]
+```ts [nuxt.config.ts]
 export default defineNuxtConfig({
   hooks: {
-    close: () => { }
-  }
+    close: () => { },
+  },
 })
 ```
 
@@ -29,11 +29,11 @@ import { defineNuxtModule } from '@nuxt/kit'
 export default defineNuxtModule({
   setup (options, nuxt) {
     nuxt.hook('close', async () => { })
-  }
+  },
 })
 ```
 
-::read-more{to="/docs/api/advanced/hooks#nuxt-hooks-build-time"}
+::read-more{to="/docs/4.x/api/advanced/hooks#nuxt-hooks-build-time"}
 Explore all available Nuxt hooks.
 ::
 
@@ -41,7 +41,7 @@ Explore all available Nuxt hooks.
 
 App hooks can be mainly used by [Nuxt Plugins](/docs/4.x/guide/directory-structure/plugins) to hook into rendering lifecycle but could also be used in Vue composables.
 
-```js [app/plugins/test.ts]
+```ts [app/plugins/test.ts]
 export default defineNuxtPlugin((nuxtApp) => {
   nuxtApp.hook('page:start', () => {
     /* your code goes here */
@@ -49,7 +49,7 @@ export default defineNuxtPlugin((nuxtApp) => {
 })
 ```
 
-::read-more{to="/docs/api/advanced/hooks#app-hooks-runtime"}
+::read-more{to="/docs/4.x/api/advanced/hooks#app-hooks-runtime"}
 Explore all available App hooks.
 ::
 
@@ -57,7 +57,7 @@ Explore all available App hooks.
 
 These hooks are available for [server plugins](/docs/4.x/guide/directory-structure/server#server-plugins) to hook into Nitro's runtime behavior.
 
-```js [~/server/plugins/test.ts]
+```ts [~/server/plugins/test.ts]
 export default defineNitroPlugin((nitroApp) => {
   nitroApp.hooks.hook('render:html', (html, { event }) => {
     console.log('render:html', html)
@@ -70,7 +70,7 @@ export default defineNitroPlugin((nitroApp) => {
 })
 ```
 
-::read-more{to="/docs/api/advanced/hooks#nitro-app-hooks-runtime-server-side"}
+::read-more{to="/docs/4.x/api/advanced/hooks#nitro-app-hooks-runtime-server-side"}
 Learn more about available Nitro lifecycle hooks.
 ::
 
@@ -79,7 +79,7 @@ Learn more about available Nitro lifecycle hooks.
 You can define your own custom hooks support by extending Nuxt's hook interfaces.
 
 ```ts
-import { HookResult } from "@nuxt/schema";
+import type { HookResult } from '@nuxt/schema'
 
 declare module '#app' {
   interface RuntimeNuxtHooks {
@@ -92,7 +92,7 @@ declare module '#app' {
 
 declare module 'nitropack/types' {
   interface NitroRuntimeHooks {
-    'your-nitro-hook': () => void;
+    'your-nitro-hook': () => void
   }
 }
 ```