'
+```
+::
+
+::note
+Giving the `event` as argument to `useRuntimeConfig` is optional, but it is recommended to pass it to get the runtime config overwritten by [environment variables](/docs/4.x/guide/going-further/runtime-config#environment-variables) at runtime for server routes.
+::
+
+### Request Cookies
+
+```ts [server/api/cookies.ts]
+export default defineEventHandler((event) => {
+ const cookies = parseCookies(event)
+
+ return { cookies }
+})
+```
+
+### Forwarding Context & Headers
+
+By default, neither the headers from the incoming request nor the request context are forwarded when
+making fetch requests in server routes. You can use `event.$fetch` to forward the request context and headers when making fetch requests in server routes.
+
+```ts [server/api/forward.ts]
+export default defineEventHandler((event) => {
+ return event.$fetch('/api/forwarded')
+})
+```
+
+::note
+Headers that are **not meant to be forwarded** will **not be included** in the request. These headers include, for example:
+`transfer-encoding`, `connection`, `keep-alive`, `upgrade`, `expect`, `host`, `accept`
+::
+
+### Awaiting Promises After Response
+
+When handling server requests, you might need to perform asynchronous tasks that shouldn't block the response to the client (for example, caching and logging). You can use `event.waitUntil` to await a promise in the background without delaying the response.
+
+The `event.waitUntil` method accepts a promise that will be awaited before the handler terminates, ensuring the task is completed even if the server would otherwise terminate the handler right after the response is sent. This integrates with runtime providers to leverage their native capabilities for handling asynchronous operations after the response is sent.
+
+```ts [server/api/background-task.ts]
+const timeConsumingBackgroundTask = async () => {
+ await new Promise(resolve => setTimeout(resolve, 1000))
+}
+
+export default eventHandler((event) => {
+ // schedule a background task without blocking the response
+ event.waitUntil(timeConsumingBackgroundTask())
+
+ // immediately send the response to the client
+ return 'done'
+})
+```
+
+## Advanced Usage
+
+### Nitro Config
+
+You can use `nitro` key in `nuxt.config` to directly set [Nitro configuration](https://nitro.build/config).
+
+::warning
+This is an advanced option. Custom config can affect production deployments, as the configuration interface might change over time when Nitro is upgraded in semver-minor versions of Nuxt.
+::
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+ // https://nitro.build/config
+ nitro: {},
+})
+```
+
+:read-more{to="/docs/4.x/guide/concepts/server-engine"}
+
+### Nested Router
+
+```ts [server/api/hello/[...slug\\].ts]
+import { createRouter, defineEventHandler, useBase } from 'h3'
+
+const router = createRouter()
+
+router.get('/test', defineEventHandler(() => 'Hello World'))
+
+export default useBase('/api/hello', router.handler)
+```
+
+### Sending Streams
+
+::tip
+This is an experimental feature and is available in all environments.
+::
+
+```ts [server/api/foo.get.ts]
+import fs from 'node:fs'
+import { sendStream } from 'h3'
+
+export default defineEventHandler((event) => {
+ return sendStream(event, fs.createReadStream('/path/to/file'))
+})
+```
+
+### Sending Redirect
+
+```ts [server/api/foo.get.ts]
+export default defineEventHandler(async (event) => {
+ await sendRedirect(event, '/path/redirect/to', 302)
+})
+```
+
+### Legacy Handler or Middleware
+
+```ts [server/api/legacy.ts]
+export default fromNodeMiddleware((req, res) => {
+ res.end('Legacy handler')
+})
+```
+
+::important
+Legacy support is possible using [h3js/h3](https://github.com/h3js/h3), but it is advised to avoid legacy handlers as much as you can.
+::
+
+```ts [server/middleware/legacy.ts]
+export default fromNodeMiddleware((req, res, next) => {
+ console.log('Legacy middleware')
+ next()
+})
+```
+
+::warning
+Never combine `next()` callback with a legacy middleware that is `async` or returns a `Promise`.
+::
+
+### Server Storage
+
+Nitro provides a cross-platform [storage layer](https://nitro.build/guide/storage). In order to configure additional storage mount points, you can use `nitro.storage`, or [server plugins](/docs/4.x/directory-structure/server#server-plugins).
+
+**Example of adding a Redis storage:**
+
+Using `nitro.storage`:
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+ nitro: {
+ storage: {
+ redis: {
+ driver: 'redis',
+ /* redis connector options */
+ port: 6379, // Redis port
+ host: '127.0.0.1', // Redis host
+ username: '', // needs Redis >= 6
+ password: '',
+ db: 0, // Defaults to 0
+ tls: {}, // tls/ssl
+ },
+ },
+ },
+})
+```
+
+Then in your API handler:
+
+```ts [server/api/storage/test.ts]
+export default defineEventHandler(async (event) => {
+ // List all keys with
+ const keys = await useStorage('redis').getKeys()
+
+ // Set a key with
+ await useStorage('redis').setItem('foo', 'bar')
+
+ // Remove a key with
+ await useStorage('redis').removeItem('foo')
+
+ return {}
+})
+```
+
+::read-more{to="https://nitro.build/guide/storage" target="_blank"}
+Read more about Nitro Storage Layer.
+::
+
+Alternatively, you can create a storage mount point using a server plugin and runtime config:
+
+::code-group
+```ts [server/plugins/storage.ts]
+import { definePlugin } from 'nitro'
+import redisDriver from 'unstorage/drivers/redis'
+
+export default definePlugin(() => {
+ const storage = useStorage()
+
+ // Dynamically pass in credentials from runtime configuration, or other sources
+ const driver = redisDriver({
+ base: 'redis',
+ host: useRuntimeConfig().redis.host,
+ port: useRuntimeConfig().redis.port,
+ /* other redis connector options */
+ })
+
+ // Mount driver
+ storage.mount('redis', driver)
+})
+```
+
+``` ts [nuxt.config.ts]
+export default defineNuxtConfig({
+ runtimeConfig: {
+ redis: { // Default values
+ host: '',
+ port: 0,
+ /* other redis connector options */
+ },
+ },
+})
+```
+::
diff --git a/docs/2.directory-structure/1.shared.md b/docs/2.directory-structure/1.shared.md
new file mode 100644
index 000000000000..b5dff469c6f7
--- /dev/null
+++ b/docs/2.directory-structure/1.shared.md
@@ -0,0 +1,98 @@
+---
+title: 'shared'
+head.title: 'shared/'
+description: 'Use the shared/ directory to share functionality between the Vue app and the Nitro server.'
+navigation.icon: i-vscode-icons-folder-type-shared
+---
+
+The `shared/` directory allows you to share code that can be used in both the Vue app and the Nitro server.
+
+::note
+The `shared/` directory is available in Nuxt v3.14+.
+::
+
+::important
+Code in the `shared/` directory cannot import any Vue or Nitro code.
+::
+
+:video-accordion{title="Watch a video from Vue School on sharing utils and types between app and server" videoId="nnAR-MO3q5M"}
+
+## Usage
+
+**Method 1:** Named export
+
+```ts twoslash [shared/utils/capitalize.ts]
+export const capitalize = (input: string) => {
+ return input[0] ? input[0].toUpperCase() + input.slice(1) : ''
+}
+```
+
+**Method 2:** Default export
+
+```ts twoslash [shared/utils/capitalize.ts]
+export default function (input: string) {
+ return input[0] ? input[0].toUpperCase() + input.slice(1) : ''
+}
+```
+
+You can now use [auto-imported](/docs/4.x/directory-structure/shared) utilities in your Nuxt app and `server/` directory.
+
+```vue [app/app.vue]
+
+
+
+
+ {{ hello }}
+
+
+```
+
+```ts [server/api/hello.get.ts]
+export default defineEventHandler((event) => {
+ return {
+ hello: capitalize('hello'),
+ }
+})
+```
+
+## How Files Are Scanned
+
+Only files in the `shared/utils/` and `shared/types/` directories will be auto-imported. Files nested within subdirectories of these directories will not be auto-imported unless you add these directories to `imports.dirs` and `nitro.imports.dirs`.
+
+::tip
+The way `shared/utils` and `shared/types` auto-imports work and are scanned is identical to the [`app/composables/`](/docs/4.x/directory-structure/app/composables) and [`app/utils/`](/docs/4.x/directory-structure/app/utils) directories.
+::
+
+:read-more{to="/docs/4.x/directory-structure/app/composables#how-files-are-scanned"}
+
+```bash [Directory Structure]
+-| shared/
+---| capitalize.ts # Not auto-imported
+---| formatters
+-----| lower.ts # Not auto-imported
+---| utils/
+-----| lower.ts # Auto-imported
+-----| formatters
+-------| upper.ts # Not auto-imported
+---| types/
+-----| bar.ts # Auto-imported
+```
+
+Any other files you create in the `shared/` folder must be manually imported using the `#shared` alias (automatically configured by Nuxt):
+
+```ts
+// For files directly in the shared directory
+import capitalize from '#shared/capitalize'
+
+// For files in nested directories
+import lower from '#shared/formatters/lower'
+
+// For files nested in a folder within utils
+import upper from '#shared/utils/formatters/upper'
+```
+
+This alias ensures consistent imports across your application, regardless of the importing file's location.
+
+:read-more{to="/docs/4.x/guide/concepts/auto-imports"}
diff --git a/docs/2.directory-structure/2.env.md b/docs/2.directory-structure/2.env.md
new file mode 100644
index 000000000000..f6c9048de405
--- /dev/null
+++ b/docs/2.directory-structure/2.env.md
@@ -0,0 +1,79 @@
+---
+title: ".env"
+description: "A .env file specifies your build/dev-time environment variables."
+head.title: ".env"
+navigation.icon: i-vscode-icons-file-type-dotenv
+---
+
+::important
+This file should be added to your [`.gitignore`](/docs/4.x/directory-structure/gitignore) file to avoid pushing secrets to your repository.
+::
+
+## Dev, Build and Generate Time
+
+Nuxt CLI has built-in [dotenv](https://github.com/motdotla/dotenv) support in development mode and when running [`nuxt build`](/docs/4.x/api/commands/build) and [`nuxt generate`](/docs/4.x/api/commands/generate).
+
+In addition to any process environment variables, if you have a `.env` file in your project root directory, it will be automatically loaded **at dev, build and generate time**. Any environment variables set there will be accessible within your `nuxt.config` file and modules.
+
+```ini [.env]
+MY_ENV_VARIABLE=hello
+```
+
+::note
+Note that removing a variable from `.env` or removing the `.env` file entirely will not unset values that have already been set.
+::
+
+## Custom File
+
+If you want to use a different file - for example, to use `.env.local` or `.env.production` - you can do so by passing the `--dotenv` flag when using the Nuxt CLI.
+
+```bash [Terminal]
+npx nuxt dev --dotenv .env.local
+```
+
+When updating `.env` in development mode, the Nuxt instance is automatically restarted to apply new values to the `process.env`.
+
+::important
+In your application code, you should use [Runtime Config](/docs/4.x/guide/going-further/runtime-config) instead of plain env variables.
+::
+
+## Production
+
+**After your server is built**, you are responsible for setting environment variables when you run the server.
+
+Your `.env` files will not be read at this point. How you do this is different for every environment.
+
+This design decision was made to ensure compatibility across various deployment environments, some of which may not have a traditional file system available, such as serverless platforms or edge networks like Cloudflare Workers.
+
+Since `.env` files are not used in production, you must explicitly set environment variables using the tools and methods provided by your hosting environment. Here are some common approaches:
+
+* You can pass the environment variables as arguments using the terminal:
+
+ `$ NODE_ENV=production DATABASE_HOST=mydatabaseconnectionstring node .output/server/index.mjs`
+
+* You can set environment variables in shell configuration files like `.bashrc` or `.profile`.
+
+* Many cloud service providers, such as Vercel, Netlify, and AWS, provide interfaces for setting environment variables via their dashboards, CLI tools or configuration files.
+
+::important
+`runtimeConfig` [won't pick up environment variables that don't start with `NUXT_` in production] (https://nuxt.com/docs/4.x/guide/going-further/runtime-config#environment-variables).
+::
+
+## Production Preview
+
+For local production preview purpose, we recommend using [`nuxt preview`](/docs/4.x/api/commands/preview) since using this command, the `.env` file will be loaded into `process.env` for convenience. Note that this command requires dependencies to be installed in the package directory.
+
+Or you could pass the environment variables as arguments using the terminal. For example, on Linux or macOS:
+
+```bash [Terminal]
+NODE_ENV=production DATABASE_HOST=mydatabaseconnectionstring node .output/server/index.mjs
+```
+
+Note that for a purely static site, it is not possible to set runtime configuration config after your project is prerendered.
+
+:read-more{to="/docs/4.x/guide/going-further/runtime-config"}
+
+::note
+If you want to use environment variables set at build time but do not care about updating these down the line (or only need to update them reactively _within_ your app) then `appConfig` may be a better choice. You can define `appConfig` both within your `nuxt.config` (using environment variables) and also within an `~/app.config.ts` file in your project.
+:read-more{to="/docs/4.x/directory-structure/app/app-config"}
+::
diff --git a/docs/2.directory-structure/2.gitignore.md b/docs/2.directory-structure/2.gitignore.md
new file mode 100644
index 000000000000..3f4108ffb89a
--- /dev/null
+++ b/docs/2.directory-structure/2.gitignore.md
@@ -0,0 +1,37 @@
+---
+title: ".gitignore"
+description: "A .gitignore file specifies intentionally untracked files that git should ignore."
+head.title: ".gitignore"
+navigation.icon: i-vscode-icons-file-type-git
+---
+
+A `.gitignore` file specifies intentionally untracked files that git should ignore.
+
+:read-more{icon="i-simple-icons-git" title="the git documentation" to="https://git-scm.com/docs/gitignore" target="_blank"}
+
+We recommend having a `.gitignore` file that has **at least** the following entries present:
+
+```bash [.gitignore]
+# Nuxt dev/build outputs
+.output
+.data
+.nuxt
+.nitro
+.cache
+dist
+
+# Node dependencies
+node_modules
+
+# Logs
+logs
+*.log
+
+# Misc
+.DS_Store
+
+# Local env files
+.env
+.env.*
+!.env.example
+```
diff --git a/docs/2.directory-structure/2.nuxtignore.md b/docs/2.directory-structure/2.nuxtignore.md
new file mode 100644
index 000000000000..68200c256a8e
--- /dev/null
+++ b/docs/2.directory-structure/2.nuxtignore.md
@@ -0,0 +1,37 @@
+---
+title: .nuxtignore
+head.title: '.nuxtignore'
+description: The .nuxtignore file lets Nuxt ignore files in your project’s root directory during the build phase.
+navigation.icon: i-vscode-icons-file-type-nuxt
+
+---
+
+The `.nuxtignore` file tells Nuxt to ignore files in your project’s root directory ([`rootDir`](/docs/4.x/api/nuxt-config#rootdir)) during the build phase.
+
+It is subject to the same specification as [`.gitignore`](/docs/4.x/directory-structure/gitignore) and `.eslintignore` files, in which each line is a glob pattern indicating which files should be ignored.
+
+::tip
+You can also configure [`ignoreOptions`](/docs/4.x/api/nuxt-config#ignoreoptions), [`ignorePrefix`](/docs/4.x/api/nuxt-config#ignoreprefix) and [`ignore`](/docs/4.x/api/nuxt-config#ignore) in your `nuxt.config` file.
+::
+
+## Usage
+
+```bash [.nuxtignore]
+# ignore layout foo.vue
+app/layouts/foo.vue
+# ignore layout files whose name ends with -ignore.vue
+app/layouts/*-ignore.vue
+
+# ignore page bar.vue
+app/pages/bar.vue
+# ignore page inside ignore folder
+app/pages/ignore/*.vue
+
+# ignore route middleware files under foo folder except foo/bar.js
+app/middleware/foo/*.js
+!app/middleware/foo/bar.js
+```
+
+::read-more{icon="i-simple-icons-git" title="the git documentation" to="https://git-scm.com/docs/gitignore" target="_blank"}
+More details about the spec are in the **gitignore documentation**.
+::
diff --git a/docs/2.directory-structure/2.nuxtrc.md b/docs/2.directory-structure/2.nuxtrc.md
new file mode 100644
index 000000000000..2b80b39c3a56
--- /dev/null
+++ b/docs/2.directory-structure/2.nuxtrc.md
@@ -0,0 +1,57 @@
+---
+title: ".nuxtrc"
+description: "The .nuxtrc file allows you to define nuxt configurations in a flat syntax."
+head.title: ".nuxtrc"
+navigation.icon: i-vscode-icons-file-type-nuxt
+---
+
+The `.nuxtrc` file can be used to configure Nuxt with a flat syntax. It is based on [`unjs/rc9`](https://github.com/unjs/rc9).
+
+::tip
+For more advanced configurations, use [`nuxt.config`](/docs/4.x/directory-structure/nuxt-config).
+::
+
+## Usage
+
+```bash [.nuxtrc]
+# Disable SSR
+ssr=false
+
+# Configuration for `@nuxt/devtools`
+devtools.enabled=true
+
+# Add Nuxt modules
+modules[]=@nuxt/image
+modules[]=nuxt-security
+
+# Module setups (automatically added by Nuxt)
+setups.@nuxt/test-utils="3.23.0"
+```
+
+If present, the properties in the `nuxt.config` file will overwrite the properties in `.nuxtrc` file.
+
+::note
+Nuxt automatically adds a `setups` section to track module installation and upgrade state. This is used internally for [module lifecycle hooks](/docs/4.x/api/kit/modules#using-lifecycle-hooks-for-module-installation-and-upgrade) and should not be modified manually.
+::
+
+::read-more{to="/docs/4.x/api/configuration/nuxt-config"}
+Discover all the available options in the **Nuxt configuration** documentation.
+::
+
+## Global `.nuxtrc` File
+
+You can also create a global `.nuxtrc` file in your home directory to apply configurations globally.
+
+- On macOS/Linux, this file is located at:
+
+ ```md
+ ~/.nuxtrc
+ ```
+
+- On Windows, it is located at:
+
+ ```md
+ C:\Users\{username}\.nuxtrc
+ ```
+
+This global `.nuxtrc` file allows you to define default settings that apply to all Nuxt projects on your system. However, project-level `.nuxtrc` files will override these global settings, and `nuxt.config` will take precedence over both.
diff --git a/docs/2.directory-structure/3.nuxt-config.md b/docs/2.directory-structure/3.nuxt-config.md
new file mode 100644
index 000000000000..ade41e260488
--- /dev/null
+++ b/docs/2.directory-structure/3.nuxt-config.md
@@ -0,0 +1,34 @@
+---
+title: "nuxt.config.ts"
+description: "Nuxt can be easily configured with a single nuxt.config file."
+head.title: "nuxt.config.ts"
+navigation.icon: i-vscode-icons-file-type-nuxt
+---
+
+The `nuxt.config` file extension can either be `.js`, `.ts` or `.mjs`.
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ // My Nuxt config
+})
+```
+
+::tip
+`defineNuxtConfig` helper is globally available without import.
+::
+
+You can explicitly import `defineNuxtConfig` from `nuxt/config` if you prefer:
+
+```ts twoslash [nuxt.config.ts]
+import { defineNuxtConfig } from 'nuxt/config'
+
+export default defineNuxtConfig({
+ // My Nuxt config
+})
+```
+
+::read-more{to="/docs/4.x/api/configuration/nuxt-config"}
+Discover all the available options in the **Nuxt configuration** documentation.
+::
+
+To ensure your configuration is up to date, Nuxt will make a full restart when detecting changes in the main configuration file, the [`.env`](/docs/4.x/directory-structure/env), [`.nuxtignore`](/docs/4.x/directory-structure/nuxtignore) and [`.nuxtrc`](/docs/4.x/directory-structure/nuxtrc) dotfiles.
diff --git a/docs/2.directory-structure/3.package.md b/docs/2.directory-structure/3.package.md
new file mode 100644
index 000000000000..ccfacd8fe7d0
--- /dev/null
+++ b/docs/2.directory-structure/3.package.md
@@ -0,0 +1,32 @@
+---
+title: package.json
+head.title: package.json
+description: The package.json file contains all the dependencies and scripts for your application.
+navigation.icon: i-vscode-icons-file-type-npm
+---
+
+The minimal `package.json` of your Nuxt application should looks like:
+
+```json [package.json]
+{
+ "name": "nuxt-app",
+ "private": true,
+ "type": "module",
+ "scripts": {
+ "build": "nuxt build",
+ "dev": "nuxt dev",
+ "generate": "nuxt generate",
+ "preview": "nuxt preview",
+ "postinstall": "nuxt prepare"
+ },
+ "dependencies": {
+ "nuxt": "latest",
+ "vue": "latest",
+ "vue-router": "latest"
+ }
+}
+```
+
+::read-more{icon="i-simple-icons-npm" to="https://docs.npmjs.com/cli/configuring-npm/package-json/" target="_blank"}
+Read more about the `package.json` file.
+::
diff --git a/docs/2.directory-structure/3.tsconfig.md b/docs/2.directory-structure/3.tsconfig.md
new file mode 100644
index 000000000000..05f0a505c616
--- /dev/null
+++ b/docs/2.directory-structure/3.tsconfig.md
@@ -0,0 +1,70 @@
+---
+title: "tsconfig.json"
+description: "Learn how Nuxt manages TypeScript configuration across different parts of your project."
+head.title: "tsconfig.json"
+navigation.icon: i-vscode-icons-file-type-tsconfig
+---
+
+Nuxt [automatically generates](/docs/4.x/guide/concepts/typescript#auto-generated-types) multiple TypeScript configuration files (`.nuxt/tsconfig.app.json`, `.nuxt/tsconfig.server.json`, `.nuxt/tsconfig.node.json` and `.nuxt/tsconfig.shared.json`) that include recommended basic TypeScript configuration for your project, references to [auto-imports](/docs/4.x/guide/concepts/auto-imports), [API route types](/docs/4.x/guide/concepts/server-engine#typed-api-routes), path aliases, and more.
+
+Your Nuxt project should include the following `tsconfig.json` file at the root of the project:
+
+```json [tsconfig.json]
+{
+ "files": [],
+ "references": [
+ {
+ "path": "./.nuxt/tsconfig.app.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.server.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.shared.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.node.json"
+ }
+ ]
+}
+```
+
+::warning
+We do not recommend modifying the contents of this file directly, as doing so could overwrite important settings that Nuxt or other modules rely on. Instead, extend it via `nuxt.config.ts`.
+::
+
+::read-more{to="/docs/4.x/guide/concepts/typescript#project-references"}
+Read more about the different type contexts of a Nuxt project here.
+::
+
+## Extending TypeScript Configuration
+
+You can customize the TypeScript configuration of your Nuxt project for each context (`app`, `shared`, `node`, and `server`) in the `nuxt.config.ts` file.
+
+```ts twoslash [nuxt.config.ts]
+// @errors: 2353
+export default defineNuxtConfig({
+ typescript: {
+ // customize tsconfig.app.json
+ tsConfig: {
+ // ...
+ },
+ // customize tsconfig.shared.json
+ sharedTsConfig: {
+ // ...
+ },
+ // customize tsconfig.node.json
+ nodeTsConfig: {
+ // ...
+ },
+ },
+ nitro: {
+ typescript: {
+ // customize tsconfig.server.json
+ tsConfig: {
+ // ...
+ },
+ },
+ },
+})
+```
diff --git a/docs/2.directory-structure/index.md b/docs/2.directory-structure/index.md
new file mode 100644
index 000000000000..f90034c8cc00
--- /dev/null
+++ b/docs/2.directory-structure/index.md
@@ -0,0 +1,65 @@
+---
+title: 'Nuxt Directory Structure'
+description: 'Learn about the directory structure of a Nuxt application and how to use it.'
+navigation: false
+---
+
+Nuxt applications have a specific directory structure that is used to organize the code. This structure is designed to be easy to understand and to be used in a consistent way.
+
+## Root Directory
+
+The root directory of a Nuxt application is the directory that contains the `nuxt.config.ts` file. This file is used to configure the Nuxt application.
+
+## App Directory
+
+The `app/` directory is the main directory of the Nuxt application. It contains the following subdirectories:
+- [`assets/`](/docs/4.x/directory-structure/app/assets): website's assets that the build tool (Vite or webpack) will process
+- [`components/`](/docs/4.x/directory-structure/app/components): Vue components of the application
+- [`composables/`](/docs/4.x/directory-structure/app/composables): add your Vue composables
+- [`layouts/`](/docs/4.x/directory-structure/app/layouts): Vue components that wrap around your pages and avoid re-rendering between pages
+- [`middleware/`](/docs/4.x/directory-structure/app/middleware): run code before navigating to a particular route
+- [`pages/`](/docs/4.x/directory-structure/app/pages): file-based routing to create routes within your web application
+- [`plugins/`](/docs/4.x/directory-structure/app/plugins): use Vue plugins and more at the creation of your Nuxt application
+- [`utils/`](/docs/4.x/directory-structure/app/utils): add functions throughout your application that can be used in your components, composables, and pages.
+
+This directory also includes specific files:
+- [`app.config.ts`](/docs/4.x/directory-structure/app/app-config): a reactive configuration within your application
+- [`app.vue`](/docs/4.x/directory-structure/app/app): the root component of your Nuxt application
+- [`error.vue`](/docs/4.x/directory-structure/app/error): the error page of your Nuxt application
+
+## Public Directory
+
+The [`public/`](/docs/4.x/directory-structure/public) directory is the directory that contains the public files of the Nuxt application. Files contained within this directory are served at the root and are not modified by the build process.
+
+This is suitable for files that have to keep their names (e.g. `robots.txt`) _or_ likely won't change (e.g. `favicon.ico`).
+
+## Server Directory
+
+The [`server/`](/docs/4.x/directory-structure/server) directory is the directory that contains the server-side code of the Nuxt application. It contains the following subdirectories:
+- [`api/`](/docs/4.x/directory-structure/server#server-routes): contains the API routes of the application.
+- [`routes/`](/docs/4.x/directory-structure/server#server-routes): contains the server routes of the application (e.g. dynamic `/sitemap.xml`).
+- [`middleware/`](/docs/4.x/directory-structure/server#server-middleware): run code before a server route is processed
+- [`plugins/`](/docs/4.x/directory-structure/server#server-plugins): use plugins and more at the creation of the Nuxt server
+- [`utils/`](/docs/4.x/directory-structure/server#server-utilities): add functions throughout your application that can be used in your server code.
+
+## Shared Directory
+
+The [`shared/`](/docs/4.x/directory-structure/shared) directory is the directory that contains the shared code of the Nuxt application and Nuxt server. This code can be used in both the Vue app and the Nitro server.
+
+## Content Directory
+
+The [`content/`](/docs/4.x/directory-structure/content) directory is enabled by the [Nuxt Content](https://content.nuxt.com) module. It is used to create a file-based CMS for your application using Markdown files.
+
+## Modules Directory
+
+The [`modules/`](/docs/4.x/directory-structure/modules) directory is the directory that contains the local modules of the Nuxt application. Modules are used to extend the functionality of the Nuxt application.
+
+## Layers Directory
+
+The [`layers/`](/docs/4.x/directory-structure/layers) directory allows you to organize and share reusable code, components, composables, and configurations. Layers within this directory are automatically registered in your project.
+
+## Nuxt Files
+
+- [`nuxt.config.ts`](/docs/4.x/directory-structure/nuxt-config) file is the main configuration file for the Nuxt application.
+- [`.nuxtrc`](/docs/4.x/directory-structure/nuxtrc) file is another syntax for configuring the Nuxt application (useful for global configurations).
+- [`.nuxtignore`](/docs/4.x/directory-structure/nuxtignore) file is used to ignore files in the root directory during the build phase.
diff --git a/docs/3.guide/.navigation.yml b/docs/3.guide/.navigation.yml
new file mode 100644
index 000000000000..35722a61316f
--- /dev/null
+++ b/docs/3.guide/.navigation.yml
@@ -0,0 +1,2 @@
+title: 'Guide'
+icon: i-lucide-book-open
diff --git a/docs/3.guide/0.index.md b/docs/3.guide/0.index.md
new file mode 100644
index 000000000000..1e7827a8c57b
--- /dev/null
+++ b/docs/3.guide/0.index.md
@@ -0,0 +1,28 @@
+---
+title: 'Nuxt Guide'
+titleTemplate: '%s'
+description: 'Learn how Nuxt works with in-depth guides.'
+navigation: false
+surround: false
+---
+
+::card-group{class="sm:grid-cols-1"}
+ ::card{icon="i-lucide-medal" title="Key Concepts" to="/docs/4.x/guide/concepts"}
+ Discover the main concepts behind Nuxt, from auto-import, hybrid rendering to its TypeScript support.
+ ::
+ ::card{icon="i-lucide-square-check" title="Best Practices" to="/docs/4.x/guide/best-practices"}
+ Learn about best practices when developing with Nuxt.
+ ::
+ ::card{icon="i-lucide-bot" title="Working with AI" to="/docs/4.x/guide/ai"}
+ Integrate AI tools into your Nuxt workflow with MCP Server and LLMs.txt.
+ ::
+ ::card{icon="i-lucide-box" title="Module Author Guide" to="/docs/4.x/guide/modules"}
+ Learn how to create Nuxt modules to integrate, enhance or extend any Nuxt application.
+ ::
+ ::card{icon="i-lucide-book-open" title="Recipes" to="/docs/4.x/guide/recipes"}
+ Find solutions to common problems and learn how to implement them in your Nuxt project.
+ ::
+ ::card{icon="i-lucide-star" title="Going Further" to="/docs/4.x/guide/going-further"}
+ Master Nuxt with advanced concepts like experimental features, hooks, and more.
+ ::
+::
diff --git a/docs/3.guide/1.concepts/.navigation.yml b/docs/3.guide/1.concepts/.navigation.yml
new file mode 100644
index 000000000000..67648bb6dc63
--- /dev/null
+++ b/docs/3.guide/1.concepts/.navigation.yml
@@ -0,0 +1,3 @@
+title: Key Concepts
+titleTemplate: '%s · Nuxt Concepts'
+icon: i-lucide-medal
diff --git a/docs/3.guide/1.concepts/1.rendering.md b/docs/3.guide/1.concepts/1.rendering.md
new file mode 100644
index 000000000000..babb01b8278c
--- /dev/null
+++ b/docs/3.guide/1.concepts/1.rendering.md
@@ -0,0 +1,236 @@
+---
+title: 'Rendering Modes'
+description: 'Learn about the different rendering modes available in Nuxt.'
+---
+
+Nuxt supports different rendering modes, [universal rendering](/docs/4.x/guide/concepts/rendering#universal-rendering), [client-side rendering](/docs/4.x/guide/concepts/rendering#client-side-rendering) but also offers [hybrid-rendering](/docs/4.x/guide/concepts/rendering#hybrid-rendering) and the possibility to render your application on [CDN Edge Servers](/docs/4.x/guide/concepts/rendering#edge-side-rendering).
+
+Both the browser and server can interpret JavaScript code to turn Vue.js components into HTML elements. This step is called **rendering**. Nuxt supports both **universal** and **client-side** rendering. The two approaches have benefits and downsides that we will cover.
+
+By default, Nuxt uses **universal rendering** to provide better user experience, performance and to optimize search engine indexing, but you can switch rendering modes in [one line of configuration](/docs/4.x/api/nuxt-config#ssr).
+
+## Universal Rendering
+
+This step is similar to traditional **server-side rendering** performed by PHP or Ruby applications. When the browser requests a URL with universal rendering enabled, Nuxt runs the JavaScript (Vue.js) code in a server environment and returns a fully rendered HTML page to the browser. Nuxt may also return a fully rendered HTML page from a cache if the page was generated in advance. Users immediately get the entirety of the initial content of the application, contrary to client-side rendering.
+
+Once the HTML document has been downloaded, the browser interprets this and Vue.js takes control of the document. The same JavaScript code that once ran on the server runs on the client (browser) **again** in the background now enabling interactivity (hence **Universal rendering**) by binding its listeners to the HTML. This is called **Hydration**. When hydration is complete, the page can enjoy benefits such as dynamic interfaces and page transitions.
+
+Universal rendering allows a Nuxt application to provide quick page load times while preserving the benefits of client-side rendering. Furthermore, as the content is already present in the HTML document, crawlers can index it without overhead.
+
+
+
+**What's server-rendered and what's client-rendered?**
+
+It is normal to ask which parts of a Vue file runs on the server and/or the client in universal rendering mode.
+
+```vue [app/app.vue]
+
+
+
+
+
Count: {{ counter }}
+
+ Increment
+
+
+```
+
+On the initial request, the `counter` ref is initialized in the server since it is rendered inside the `` tag. The contents of `handleClick` is never executed here. During hydration in the browser, the `counter` ref is re-initialized. The `handleClick` finally binds itself to the button; Therefore it is reasonable to deduce that the body of `handleClick` will always run in a browser environment.
+
+[Middlewares](/docs/4.x/directory-structure/app/middleware) and [pages](/docs/4.x/directory-structure/app/pages) run in the server and on the client during hydration. [Plugins](/docs/4.x/directory-structure/app/plugins) can be rendered on the server or client or both. [Components](/docs/4.x/directory-structure/app/components) can be forced to run on the client only as well. [Composables](/docs/4.x/directory-structure/app/composables) and [utilities](/docs/4.x/directory-structure/app/utils) are rendered based on the context of their usage.
+
+**Benefits of server-side rendering:**
+- **Performance**: Users can get immediate access to the page's content because browsers can display static content much faster than JavaScript-generated content. At the same time, Nuxt preserves the interactivity of a web application during the hydration process.
+- **Search Engine Optimization**: Universal rendering delivers the entire HTML content of the page to the browser as a classic server application. Web crawlers can directly index the page's content, which makes Universal rendering a great choice for any content that you want to index quickly.
+
+**Downsides of server-side rendering:**
+- **Development constraints:** Server and browser environments don't provide the same APIs, and it can be tricky to write code that can run on both sides seamlessly. Fortunately, Nuxt provides guidelines and specific variables to help you determine where a piece of code is executed.
+- **Cost:** A server needs to be running in order to render pages on the fly. This adds a monthly cost like any traditional server. However, the server calls are highly reduced thanks to universal rendering with the browser taking over on client-side navigation. A cost reduction is possible by leveraging [edge-side-rendering](/docs/4.x/guide/concepts/rendering#edge-side-rendering).
+
+Universal rendering is very versatile and can fit almost any use case, and is especially appropriate for any content-oriented websites: **blogs, marketing websites, portfolios, e-commerce sites, and marketplaces.**
+
+::tip
+For more examples about writing Vue code without hydration mismatch, see [the Vue docs](https://vuejs.org/guide/scaling-up/ssr#hydration-mismatch).
+::
+
+::important
+When importing a library that relies on browser APIs and has side effects, make sure the component importing it is only called client-side. Bundlers do not treeshake imports of modules containing side effects.
+::
+
+## Client-Side Rendering
+
+Out of the box, a traditional Vue.js application is rendered in the browser (or **client**). Then, Vue.js generates HTML elements after the browser downloads and parses all the JavaScript code containing the instructions to create the current interface.
+
+
+
+**Benefits of client-side rendering:**
+- **Development speed**: When working entirely on the client-side, we don't have to worry about the server compatibility of the code, for example, by using browser-only APIs like the `window` object.
+- **Cheaper:** Running a server adds a cost of infrastructure as you would need to run on a platform that supports JavaScript. We can host client-only applications on any static server with HTML, CSS, and JavaScript files.
+- **Offline:** Because code entirely runs in the browser, it can nicely keep working while the internet is unavailable.
+
+**Downsides of client-side rendering:**
+- **Performance**: The user has to wait for the browser to download, parse and run JavaScript files. Depending on the network for the download part and the user's device for the parsing and execution, this can take some time and impact the user's experience.
+- **Search Engine Optimization**: Indexing and updating the content delivered via client-side rendering takes more time than with a server-rendered HTML document. This is related to the performance drawback we discussed, as search engine crawlers won't wait for the interface to be fully rendered on their first try to index the page. Your content will take more time to show and update in search results pages with pure client-side rendering.
+
+Client-side rendering is a good choice for heavily interactive **web applications** that don't need indexing or whose users visit frequently. It can leverage browser caching to skip the download phase on subsequent visits, such as **SaaS, back-office applications, or online games**.
+
+You can enable client-side only rendering with Nuxt in your `nuxt.config.ts`:
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+ ssr: false,
+})
+```
+
+::note
+If you do use `ssr: false`, you should also place an HTML file in `~/spa-loading-template.html` with some HTML you would like to use to render a loading screen that will be rendered until your app is hydrated.
+:read-more{title="SPA Loading Template" to="/docs/4.x/api/configuration/nuxt-config#spaloadingtemplate"}
+::
+
+:video-accordion{title="Watch a video from Alexander Lichter about Building a plain SPA with Nuxt" videoId="7Lr0QTP1Ro8"}
+
+### Deploying a Static Client-Rendered App
+
+If you deploy your app to [static hosting](/docs/4.x/getting-started/deployment#static-hosting) with the `nuxt generate` or `nuxt build --prerender` commands, then by default, Nuxt will render every page as a separate static HTML file.
+
+::warning
+If you prerender your app with the `nuxt generate` or `nuxt build --prerender` commands, then you will not be able to use any server endpoints as no server will be included in your output folder. If you need server functionality, use `nuxt build` instead.
+::
+
+If you are using purely client-side rendering, then this might be unnecessary. You might only need a single `index.html` file, plus `200.html` and `404.html` fallbacks, which you can tell your static web host to serve up for all requests.
+
+In order to achieve this we can change how the routes are prerendered. Just add this to [your hooks](/docs/4.x/api/advanced/hooks#nuxt-hooks-build-time) in your `nuxt.config.ts`:
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ hooks: {
+ 'prerender:routes' ({ routes }) {
+ routes.clear() // Do not generate any routes (except the defaults)
+ },
+ },
+})
+```
+
+This will produce three files:
+
+- `index.html`
+- `200.html`
+- `404.html`
+
+The `200.html` and `404.html` might be useful for the hosting provider you are using.
+
+#### Skipping Client Fallback Generation
+
+When prerendering a client-rendered app, Nuxt will generate `index.html`, `200.html` and `404.html` files by default. However, if you need to prevent any (or all) of these files from being generated in your build, you can use the `'prerender:generate'` hook from [Nitro](/docs/4.x/getting-started/prerendering#prerendergenerate-nitro-hook).
+
+```ts twoslash [nuxt.config.ts]
+// @errors: 2353 7006
+export default defineNuxtConfig({
+ ssr: false,
+ nitro: {
+ hooks: {
+ 'prerender:generate' (route) {
+ const routesToSkip = ['/index.html', '/200.html', '/404.html']
+ if (routesToSkip.includes(route.route)) {
+ route.skip = true
+ }
+ },
+ },
+ },
+})
+```
+
+## Hybrid Rendering
+
+Hybrid rendering allows different caching rules per route using **Route Rules** and decides how the server should respond to a new request on a given URL.
+
+Previously every route/page of a Nuxt application and server must use the same rendering mode, universal or client-side. In various cases, some pages could be generated at build time, while others should be client-side rendered. For example, think of a content website with an admin section. Every content page should be primarily static and generated once, but the admin section requires registration and behaves more like a dynamic application.
+
+Nuxt includes route rules and hybrid rendering support. Using route rules you can define rules for a group of nuxt routes, change rendering mode or assign a cache strategy based on route!
+
+Nuxt server will automatically register corresponding middleware and wrap routes with cache handlers using [Nitro caching layer](https://nitro.build/guide/cache).
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ routeRules: {
+ // Homepage pre-rendered at build time
+ '/': { prerender: true },
+ // Products page generated on demand, revalidates in background, cached until API response changes
+ '/products': { swr: true },
+ // Product pages generated on demand, revalidates in background, cached for 1 hour (3600 seconds)
+ '/products/**': { swr: 3600 },
+ // Blog posts page generated on demand, revalidates in background, cached on CDN for 1 hour (3600 seconds)
+ '/blog': { isr: 3600 },
+ // Blog post page generated on demand once until next deployment, cached on CDN
+ '/blog/**': { isr: true },
+ // Admin dashboard renders only on client-side
+ '/admin/**': { ssr: false },
+ // Add cors headers on API routes
+ '/api/**': { cors: true },
+ // Redirects legacy urls
+ '/old-page': { redirect: '/new-page' },
+ },
+})
+```
+
+### Route Rules
+
+The different properties you can use are the following:
+- `redirect: string`{lang=ts} - Define server-side redirects.
+- `ssr: boolean`{lang=ts} - Disables server-side rendering of the HTML for sections of your app and make them render only in the browser with `ssr: false`
+- `cors: boolean`{lang=ts} - Automatically adds cors headers with `cors: true` - you can customize the output by overriding with `headers`
+- `headers: object`{lang=ts} - Add specific headers to sections of your site - for example, your assets
+- `swr: number | boolean`{lang=ts} - Add cache headers to the server response and cache it on the server or reverse proxy for a configurable TTL (time to live). The `node-server` preset of Nitro is able to cache the full response. When the TTL expired, the cached response will be sent while the page will be regenerated in the background. If true is used, a `stale-while-revalidate` header is added without a MaxAge.
+- `isr: number | boolean`{lang=ts} - The behavior is the same as `swr` except that we are able to add the response to the CDN cache on platforms that support this (currently Netlify or Vercel). If `true` is used, the content persists until the next deploy inside the CDN.
+- `prerender: boolean`{lang=ts} - Prerenders routes at build time and includes them in your build as static assets
+- `noScripts: boolean`{lang=ts} - Disables rendering of Nuxt scripts and JS resource hints for sections of your site.
+- `appMiddleware: string | string[] | Record`{lang=ts} - Allows you to define middleware that should or should not run for page paths within the Vue app part of your application (that is, not your Nitro routes)
+
+::note
+Routes using `isr` or `swr` also generate `_payload.json` files alongside HTML. Client-side navigation loads these cached payloads instead of re-fetching data. Configure dynamic routes like `pages/[...slug].vue` with glob patterns: `'/**': { isr: true }`.
+::
+
+Whenever possible, route rules will be automatically applied to the deployment platform's native rules for optimal performances (Netlify and Vercel are currently supported).
+
+::important
+Note that Hybrid Rendering is not available when using [`nuxt generate`](/docs/4.x/api/commands/generate).
+::
+
+**Examples:**
+
+::card-group
+ ::card
+ ---
+ icon: i-simple-icons-github
+ title: Nuxt Vercel ISR
+ to: https://github.com/danielroe/nuxt-vercel-isr
+ target: _blank
+ ui.icon.base: text-black dark:text-white
+ ---
+ Example of a Nuxt application with hybrid rendering deployed on Vercel.
+ ::
+::
+
+## Edge-Side Rendering
+
+Edge-Side Rendering (ESR) is a powerful feature introduced in Nuxt that allows the rendering of your Nuxt application closer to your users via edge servers of a Content Delivery Network (CDN). By leveraging ESR, you can ensure improved performance and reduced latency, thereby providing an enhanced user experience.
+
+With ESR, the rendering process is pushed to the 'edge' of the network - the CDN's edge servers. Note that ESR is more a deployment target than an actual rendering mode.
+
+When a request for a page is made, instead of going all the way to the original server, it's intercepted by the nearest edge server. This server generates the HTML for the page and sends it back to the user. This process minimizes the physical distance the data has to travel, **reducing latency and loading the page faster**.
+
+Edge-side rendering is possible thanks to [Nitro](https://nitro.build/), the [server engine](/docs/4.x/guide/concepts/server-engine) that powers Nuxt. It offers cross-platform support for Node.js, Deno, Cloudflare Workers, and more.
+
+The current platforms where you can leverage ESR are:
+- [Cloudflare Pages](https://pages.cloudflare.com) with zero configuration using the git integration and the `nuxt build` command
+- [Vercel Cloud](https://vercel.com/home) using the `nuxt build` command and `NITRO_PRESET=vercel-edge` environment variable
+- [Netlify Edge Functions](https://www.netlify.com/platform/#netlify-edge-functions) using the `nuxt build` command and `NITRO_PRESET=netlify-edge` environment variable
+
+Note that **Hybrid Rendering** can be used when using Edge-Side Rendering with route rules.
diff --git a/docs/3.guide/1.concepts/10.vuejs-development.md b/docs/3.guide/1.concepts/10.vuejs-development.md
new file mode 100644
index 000000000000..db41cc8afac2
--- /dev/null
+++ b/docs/3.guide/1.concepts/10.vuejs-development.md
@@ -0,0 +1,104 @@
+---
+title: 'Vue.js Development'
+description: "Nuxt uses Vue.js and adds features such as component auto-imports, file-based routing and composables for an SSR-friendly usage."
+navigation: false
+---
+
+Nuxt integrates Vue 3, the new major release of Vue that enables new patterns for Nuxt users.
+
+::note
+While an in-depth knowledge of Vue is not required to use Nuxt, we recommend that you read the documentation and go through some of the examples on [vuejs.org](https://vuejs.org).
+::
+
+Nuxt has always used Vue as a frontend framework.
+
+We chose to build Nuxt on top of Vue for these reasons:
+
+- The reactivity model of Vue, where a change in data automatically triggers a change in the interface.
+- The component-based templating, while keeping HTML as the common language of the web, enables intuitive patterns to keep your interface consistent, yet powerful.
+- From small projects to large web applications, Vue keeps performing well at scale to ensure that your application keeps delivering value to your users.
+
+## Vue with Nuxt
+
+### Single File Components
+
+[Vue’s single-file components](https://vuejs.org/guide/scaling-up/sfc) (SFC or `*.vue` files) encapsulate the markup (``), logic (`
+```
+
+The [Composition API](https://vuejs.org/guide/extras/composition-api-faq) introduced in Vue 3 is not a replacement of the Options API, but it enables better logic reuse throughout an application, and is a more natural way to group code by concern in complex components.
+
+Used with the `setup` keyword in the `
+```
+
+The goal of Nuxt is to provide a great developer experience around the Composition API.
+
+- Use auto-imported [Reactivity functions](https://vuejs.org/api/reactivity-core) from Vue and Nuxt [built-in composables](/docs/4.x/api/composables/use-async-data).
+- Write your own auto-imported reusable functions in the [`app/composables/` directory](/docs/4.x/directory-structure/app/composables).
+
+### TypeScript Support
+
+Both Vue 3 and Nuxt 3+ are written in TypeScript. A fully typed codebase prevents mistakes and documents APIs usage. This doesn’t mean that you have to write your application in TypeScript to take advantage of it. With Nuxt 3, you can opt-in by renaming your file from `.js` to `.ts` , or add `
+```
+
+Thanks to its opinionated directory structure, Nuxt can auto-import your [`app/components/`](/docs/4.x/directory-structure/app/components), [`app/composables/`](/docs/4.x/directory-structure/app/composables) and [`app/utils/`](/docs/4.x/directory-structure/app/utils).
+
+Contrary to a classic global declaration, Nuxt preserves typings, IDEs completions and hints, and **only includes what is used in your production code**.
+
+::note
+In the docs, every function that is not explicitly imported is auto-imported by Nuxt and can be used as-is in your code. You can find a reference for auto-imported components, composables and utilities in the [API section](/docs/4.x/api).
+::
+
+::note
+In the [`server`](/docs/4.x/directory-structure/server) directory, Nuxt auto-imports exported functions and variables from `server/utils/`.
+::
+
+::note
+You can also auto-import functions exported from custom folders or third-party packages by configuring the [`imports`](/docs/4.x/api/nuxt-config#imports) section of your `nuxt.config` file.
+::
+
+## Built-in Auto-imports
+
+Nuxt auto-imports functions and composables to perform [data fetching](/docs/4.x/getting-started/data-fetching), get access to the [app context](/docs/4.x/api/composables/use-nuxt-app) and [runtime config](/docs/4.x/guide/going-further/runtime-config), manage [state](/docs/4.x/getting-started/state-management) or define components and plugins.
+
+```vue twoslash
+
+```
+
+Vue exposes Reactivity APIs like `ref` or `computed`, as well as lifecycle hooks and helpers that are auto-imported by Nuxt.
+
+```vue twoslash
+
+```
+
+### Vue and Nuxt Composables
+
+
+
+When you are using the built-in Composition API composables provided by Vue and Nuxt, be aware that many of them rely on being called in the right _context_.
+
+During a component lifecycle, Vue tracks the temporary instance of the current component (and similarly, Nuxt tracks a temporary instance of `nuxtApp`) via a global variable, and then unsets it in the same tick. This is essential when server rendering, both to avoid cross-request state pollution (leaking a shared reference between two users) and to avoid leakage between different components.
+
+That means that (with very few exceptions) you cannot use them outside a Nuxt plugin, Nuxt route middleware or Vue setup function. On top of that, you must use them synchronously - that is, you cannot use `await` before calling a composable, except within `
+```
+
+### Disabling Auto-imports
+
+If you want to disable auto-importing composables and utilities, you can set `imports.autoImport` to `false` in the `nuxt.config` file.
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ imports: {
+ autoImport: false,
+ },
+})
+```
+
+This will disable auto-imports completely but it's still possible to use [explicit imports](/docs/4.x/guide/concepts/auto-imports#explicit-imports) from `#imports`.
+
+### Partially Disabling Auto-imports
+
+If you want framework-specific functions like `ref` to remain auto-imported but wish to disable auto-imports for your own code (e.g., custom composables), you can set the `imports.scan` option to `false` in your `nuxt.config.ts` file:
+
+```ts
+export default defineNuxtConfig({
+ imports: {
+ scan: false,
+ },
+})
+```
+
+With this configuration:
+- Framework functions like `ref`, `computed`, or `watch` will still work without needing manual imports.
+- Custom code, such as composables, will need to be manually imported in your files.
+
+::warning
+**Caution:** This setup has certain limitations:
+- If you structure your project with layers, you will need to explicitly import the composables from each layer, rather than relying on auto-imports.
+- This breaks the layer system’s override feature. If you use `imports.scan: false`, ensure you understand this side-effect and adjust your architecture accordingly.
+::
+
+## Auto-imported Components
+
+Nuxt also automatically imports components from your `~/components` directory, although this is configured separately from auto-importing composables and utility functions.
+
+:read-more{to="/docs/4.x/directory-structure/app/components"}
+
+To disable auto-importing components from your own `~/components` directory, you can set `components.dirs` to an empty array (though note that this will not affect components added by modules).
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ components: {
+ dirs: [],
+ },
+})
+```
+
+## Auto-import from Third-Party Packages
+
+Nuxt also allows auto-importing from third-party packages.
+
+::tip
+If you are using the Nuxt module for that package, it is likely that the module has already configured auto-imports for that package.
+::
+
+For example, you could enable the auto-import of the `useI18n` composable from the `vue-i18n` package like this:
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ imports: {
+ presets: [
+ {
+ from: 'vue-i18n',
+ imports: ['useI18n'],
+ },
+ ],
+ },
+})
+```
+
+:video-accordion{title="Watch a video from Alexander Lichter on how to easily set up custom auto imports" videoId="FT2LQJ2NvVI"}
diff --git a/docs/3.guide/1.concepts/4.server-engine.md b/docs/3.guide/1.concepts/4.server-engine.md
new file mode 100644
index 000000000000..e98cd17ec99f
--- /dev/null
+++ b/docs/3.guide/1.concepts/4.server-engine.md
@@ -0,0 +1,62 @@
+---
+title: Server Engine
+description: 'Nuxt is powered by a new server engine: Nitro.'
+---
+
+While building Nuxt, we created a new server engine: [Nitro](https://nitro.build/).
+
+It is shipped with many features:
+
+- Cross-platform support for Node.js, browsers, service workers and more.
+- Serverless support out-of-the-box.
+- API routes support.
+- Automatic code-splitting and async-loaded chunks.
+- Hybrid mode for static + serverless sites.
+- Development server with hot module reloading.
+
+## API Layer
+
+Server [API endpoints](/docs/4.x/directory-structure/server#server-routes) and [Middleware](/docs/4.x/directory-structure/server#server-middleware) are added by Nitro that internally uses [h3](https://github.com/h3js/h3).
+
+Key features include:
+
+- Handlers can directly return objects/arrays for an automatically-handled JSON response
+- Handlers can return promises, which will be awaited (`res.end()` and `next()` are also supported)
+- Helper functions for body parsing, cookie handling, redirects, headers and more
+
+Check out [the h3 docs](https://github.com/h3js/h3) for more information.
+
+::read-more{to="/docs/4.x/directory-structure/server#server-routes"}
+Learn more about the API layer in the `server/` directory.
+::
+
+## Direct API Calls
+
+Nitro allows 'direct' calling of routes via the globally-available [`$fetch`](/docs/4.x/api/utils/dollarfetch) helper. This will make an API call to the server if run on the browser, but will directly call the relevant function if run on the server, **saving an additional API call**.
+
+[`$fetch`](/docs/4.x/api/utils/dollarfetch) API is using [ofetch](https://github.com/unjs/ofetch), with key features including:
+
+- Automatic parsing of JSON responses (with access to raw response if needed)
+- Request body and params are automatically handled, with correct `Content-Type` headers
+
+For more information on `$fetch` features, check out [ofetch](https://github.com/unjs/ofetch).
+
+## Typed API Routes
+
+When using API routes (or middleware), Nitro will generate typings for these routes as long as you are returning a value instead of using `res.end()` to send a response.
+
+You can access these types when using [`$fetch()`](/docs/4.x/api/utils/dollarfetch) or [`useFetch()`](/docs/4.x/api/composables/use-fetch).
+
+## Standalone Server
+
+Nitro produces a standalone server dist that is independent of `node_modules`.
+
+The server in Nuxt 2 is not standalone and requires part of Nuxt core to be involved by running `nuxt start` (with the [`nuxt-start`](https://www.npmjs.com/package/nuxt-start) or [`nuxt`](https://www.npmjs.com/package/nuxt) distributions) or custom programmatic usage, which is fragile and prone to breakage and not suitable for serverless and service worker environments.
+
+Nuxt generates this dist when running `nuxt build` into a [`.output`](/docs/4.x/directory-structure/output) directory.
+
+The output contains runtime code to run your Nuxt server in any environment (including experimental browser service workers!) and serve your static files, making it a true hybrid framework for the JAMstack. In addition, Nuxt implements a native storage layer, supporting multi-source drivers and local assets.
+
+::read-more{icon="i-simple-icons-github" to="https://github.com/nitrojs/nitro" target="_blank"}
+Read more about Nitro engine on GitHub.
+::
diff --git a/docs/3.guide/1.concepts/5.modules.md b/docs/3.guide/1.concepts/5.modules.md
new file mode 100644
index 000000000000..4e2b4f90e612
--- /dev/null
+++ b/docs/3.guide/1.concepts/5.modules.md
@@ -0,0 +1,61 @@
+---
+title: 'Modules'
+description: "Nuxt provides a module system to extend the framework core and simplify integrations."
+---
+
+## Exploring Nuxt Modules
+
+When developing production-grade applications with Nuxt you might find that the framework's core functionality is not enough. Nuxt can be extended with configuration options and plugins, but maintaining these customizations across multiple projects can be tedious, repetitive and time-consuming. On the other hand, supporting every project's needs out of the box would make Nuxt very complex and hard to use.
+
+This is one of the reasons why Nuxt provides a module system that makes it possible to extend the core. Nuxt modules are async functions that sequentially run when starting Nuxt in development mode using [`nuxt dev`](/docs/4.x/api/commands/dev) or building a project for production with [`nuxt build`](/docs/4.x/api/commands/build). They can override templates, configure webpack loaders, add CSS libraries, and perform many other useful tasks.
+
+Best of all, Nuxt modules can be distributed in npm packages. This makes it possible for them to be reused across projects and shared with the community, helping create an ecosystem of high-quality add-ons.
+
+::read-more{to="/modules"}
+Explore Nuxt Modules
+::
+
+## Add Nuxt Modules
+
+Once you have installed the modules you can add them to your [`nuxt.config.ts`](/docs/4.x/directory-structure/nuxt-config) file under the `modules` property. Module developers usually provide additional steps and details for usage.
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ modules: [
+ // Using package name (recommended usage)
+ '@nuxtjs/example',
+
+ // Load a local module
+ './modules/example',
+
+ // Add module with inline-options
+ ['./modules/example', { token: '123' }],
+
+ // Inline module definition
+ async (inlineOptions, nuxt) => { },
+ ],
+})
+```
+
+::warning
+Nuxt modules are now build-time-only, and the `buildModules` property used in Nuxt 2 is deprecated in favor of `modules`.
+::
+
+## Disabling Modules
+
+You can disable a module by setting its config key to `false` in your Nuxt config. This is particularly useful when you want to disable modules inherited from layers.
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+ // Disable `@nuxt/image` module
+ image: false,
+})
+```
+
+:read-more{to="/docs/4.x/guide/going-further/layers#disabling-modules-from-layers"}
+
+## Create a Nuxt Module
+
+Everyone has the opportunity to develop modules and we cannot wait to see what you will build.
+
+:read-more{to="/docs/4.x/guide/modules" title="Module Author Guide"}
diff --git a/docs/3.guide/1.concepts/7.esm.md b/docs/3.guide/1.concepts/7.esm.md
new file mode 100644
index 000000000000..25b0eaed8f68
--- /dev/null
+++ b/docs/3.guide/1.concepts/7.esm.md
@@ -0,0 +1,306 @@
+---
+title: 'ES Modules'
+description: "Nuxt uses native ES modules."
+navigation: false
+---
+
+This guide helps explain what ES Modules are and how to make a Nuxt app (or upstream library) compatible with ESM.
+
+## Background
+
+### CommonJS Modules
+
+CommonJS (CJS) is a format introduced by Node.js that allows sharing functionality between isolated JavaScript modules ([read more](https://nodejs.org/api/modules.html)).
+You might be already familiar with this syntax:
+
+```js
+const a = require('./a')
+
+module.exports.a = a
+```
+
+Bundlers like webpack and Rollup support this syntax and allow you to use modules written in CommonJS in the browser.
+
+### ESM Syntax
+
+Most of the time, when people talk about ESM vs. CJS, they are talking about a different syntax for writing [modules](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules).
+
+```js
+import a from './a'
+
+export { a }
+```
+
+Before ECMAScript Modules (ESM) became a standard (it took more than 10 years!), tooling like
+[webpack](https://webpack.js.org/guides/ecma-script-modules/) and even languages like TypeScript started supporting so-called **ESM syntax**.
+However, there are some key differences with actual spec; here's [a helpful explainer](https://hacks.mozilla.org/2018/03/es-modules-a-cartoon-deep-dive/).
+
+### What is 'Native' ESM?
+
+You may have been writing your app using ESM syntax for a long time. After all, it's natively supported by the browser, and in Nuxt 2 we compiled all the code you wrote to the appropriate format (CJS for server, ESM for browser).
+
+When adding modules to your package, things were a little different. A sample library might expose both CJS and ESM versions, and let us pick which one we wanted:
+
+```json
+{
+ "name": "sample-library",
+ "main": "dist/sample-library.cjs.js",
+ "module": "dist/sample-library.esm.js"
+}
+```
+
+So in Nuxt 2, the bundler (webpack) would pull in the CJS file ('main') for the server build and use the ESM file ('module') for the client build.
+
+::note
+The `module` field is a convention used by bundlers like webpack and Rollup, but is not recognized by Node.js itself. Node.js only uses the [`exports`](https://nodejs.org/api/packages.html#exports) and [`main`](https://nodejs.org/api/packages.html#main) fields for module resolution.
+::
+
+However, in recent Node.js LTS releases, it is now possible to [use native ESM module](https://nodejs.org/api/esm.html) within Node.js. That means that Node.js itself can process JavaScript using ESM syntax, although it doesn't do it by default. The two most common ways to enable ESM syntax are:
+
+- set `"type": "module"` within your `package.json` and keep using `.js` extension
+- use the `.mjs` file extensions (recommended)
+
+This is what we do for Nuxt Nitro; we output a `.output/server/index.mjs` file. That tells Node.js to treat this file as a native ES module.
+
+### What Are Valid Imports in a Node.js Context?
+
+When you `import` a module rather than `require` it, Node.js resolves it differently. For example, when you import `sample-library`, Node.js will look for the `exports` entry in that library's `package.json`, or fall back to the `main` entry if `exports` is not defined.
+
+This is also true of dynamic imports, like `const b = await import('sample-library')`.
+
+Node supports the following kinds of imports (see [docs](https://nodejs.org/api/packages.html#determining-module-system)):
+
+1. files ending in `.mjs` - these are expected to use ESM syntax
+1. files ending in `.cjs` - these are expected to use CJS syntax
+1. files ending in `.js` - these are expected to use CJS syntax unless their `package.json` has `"type": "module"`
+
+### What Kinds of Problems Can There Be?
+
+For a long time module authors have been producing ESM-syntax builds but using conventions like `.esm.js` or `.es.js`, which they have added to the `module` field in their `package.json`. This hasn't been a problem until now because they have only been used by bundlers like webpack, which don't especially care about the file extension.
+
+However, if you try to import a package with an `.esm.js` file in a Node.js ESM context, it won't work, and you'll get an error like:
+
+```bash [Terminal]
+(node:22145) Warning: To load an ES module, set "type": "module" in the package.json or use the .mjs extension.
+/path/to/index.js:1
+
+export default {}
+^^^^^^
+
+SyntaxError: Unexpected token 'export'
+ at wrapSafe (internal/modules/cjs/loader.js:1001:16)
+ at Module._compile (internal/modules/cjs/loader.js:1049:27)
+ at Object.Module._extensions..js (internal/modules/cjs/loader.js:1114:10)
+ ....
+ at async Object.loadESM (internal/process/esm_loader.js:68:5)
+```
+
+You might also get this error if you have a named import from an ESM-syntax build that Node.js thinks is CJS:
+
+```bash [Terminal]
+file:///path/to/index.mjs:5
+import { named } from 'sample-library'
+ ^^^^^
+SyntaxError: Named export 'named' not found. The requested module 'sample-library' is a CommonJS module, which may not support all module.exports as named exports.
+
+CommonJS modules can always be imported via the default export, for example using:
+
+import pkg from 'sample-library';
+const { named } = pkg;
+
+ at ModuleJob._instantiate (internal/modules/esm/module_job.js:120:21)
+ at async ModuleJob.run (internal/modules/esm/module_job.js:165:5)
+ at async Loader.import (internal/modules/esm/loader.js:177:24)
+ at async Object.loadESM (internal/process/esm_loader.js:68:5)
+```
+
+## Troubleshooting ESM Issues
+
+If you encounter these errors, the issue is almost certainly with the upstream library. They need to [fix their library](/docs/4.x/guide/concepts/esm#library-author-guide) to support being imported by Node.
+
+### Transpiling Libraries
+
+In the meantime, you can tell Nuxt not to try to import these libraries by adding them to `build.transpile`:
+
+```ts twoslash
+export default defineNuxtConfig({
+ build: {
+ transpile: ['sample-library'],
+ },
+})
+```
+
+You may find that you _also_ need to add other packages that are being imported by these libraries.
+
+### Aliasing Libraries
+
+In some cases, you may also need to manually alias the library to the CJS version, for example:
+
+```ts twoslash
+export default defineNuxtConfig({
+ alias: {
+ 'sample-library': 'sample-library/dist/sample-library.cjs.js',
+ },
+})
+```
+
+### Default Exports
+
+A dependency with CommonJS format, can use `module.exports` or `exports` to provide a default export:
+
+```js [node_modules/cjs-pkg/index.js]
+module.exports = { test: 123 }
+// or
+exports.test = 123
+```
+
+This normally works well if we `require` such dependency:
+
+```js [test.cjs]
+const pkg = require('cjs-pkg')
+
+console.log(pkg) // { test: 123 }
+```
+
+[Node.js in native ESM mode](https://nodejs.org/api/esm.html#interoperability-with-commonjs), [typescript with `esModuleInterop` enabled](https://www.typescriptlang.org/tsconfig/#esModuleInterop) and bundlers such as webpack, provide a compatibility mechanism so that we can default import such library.
+This mechanism is often referred to as "interop require default":
+
+```js
+import pkg from 'cjs-pkg'
+
+console.log(pkg) // { test: 123 }
+```
+
+However, because of the complexities of syntax detection and different bundle formats, there is always a chance that the interop default fails and we end up with something like this:
+
+```js
+import pkg from 'cjs-pkg'
+
+console.log(pkg) // { default: { test: 123 } }
+```
+
+Also when using dynamic import syntax (in both CJS and ESM files), we always have this situation:
+
+```js
+import('cjs-pkg').then(console.log) // [Module: null prototype] { default: { test: '123' } }
+```
+
+In this case, we need to manually interop the default export:
+
+
+
+```js
+// Static import
+import { default as pkg } from 'cjs-pkg'
+
+// Dynamic import
+import('cjs-pkg').then(m => m.default || m).then(console.log)
+```
+
+For handling more complex situations and more safety, we recommend and internally use [mlly](https://github.com/unjs/mlly) in Nuxt that can preserve named exports.
+
+```js
+import { interopDefault } from 'mlly'
+
+// Assuming the shape is { default: { foo: 'bar' }, baz: 'qux' }
+import myModule from 'my-module'
+
+console.log(interopDefault(myModule)) // { foo: 'bar', baz: 'qux' }
+```
+
+## Library Author Guide
+
+The good news is that it's relatively simple to fix issues of ESM compatibility. There are two main options:
+
+1. **You can rename your ESM files to end with `.mjs`.**
+
+ _This is the recommended and simplest approach._ You may have to sort out issues with your library's dependencies and possibly with your build system, but in most cases, this should fix the problem for you. It's also recommended to rename your CJS files to end with `.cjs`, for the greatest explicitness.
+
+1. **You can opt to make your entire library ESM-only**.
+
+ This would mean setting `"type": "module"` in your `package.json` and ensuring that your built library uses ESM syntax. However, you may face issues with your dependencies - and this approach means your library can _only_ be consumed in an ESM context.
+
+### Migration
+
+The initial step from CJS to ESM is updating any usage of `require` to use `import` instead:
+
+::code-group
+
+```ts [Before]
+module.exports = function () { /* ... */ }
+
+exports.hello = 'world'
+```
+
+```ts [After]
+export default function () { /* ... */ }
+
+export const hello = 'world'
+```
+
+::
+
+::code-group
+
+```js [Before]
+const myLib = require('my-lib')
+```
+
+```js [After]
+import myLib from 'my-lib'
+// or
+const dynamicMyLib = await import('my-lib').then(lib => lib.default || lib)
+```
+
+::
+
+In ESM Modules, unlike CJS, `require`, `require.resolve`, `__filename` and `__dirname` globals are not available
+and should be replaced with `import()` and `import.meta.filename`.
+
+::code-group
+
+```js [Before]
+const { join } = require('node:path')
+
+const newDir = join(__dirname, 'new-dir')
+```
+
+```js [After]
+import { fileURLToPath } from 'node:url'
+
+const newDir = fileURLToPath(new URL('./new-dir', import.meta.url))
+```
+
+::
+
+::code-group
+
+```js [Before]
+const someFile = require.resolve('./lib/foo.js')
+```
+
+```js [After]
+import { resolvePath } from 'mlly'
+
+const someFile = await resolvePath('my-lib', { url: import.meta.url })
+```
+
+::
+
+### Best Practices
+
+- Prefer named exports rather than default export. This helps reduce CJS conflicts. (see [Default exports](/docs/4.x/guide/concepts/esm#default-exports) section)
+
+- Avoid depending on Node.js built-ins and CommonJS or Node.js-only dependencies as much as possible to make your library usable in Browsers and Edge Workers without needing Nitro polyfills.
+
+- Use new `exports` field with conditional exports. ([read more](https://nodejs.org/api/packages.html#conditional-exports)).
+
+```json
+{
+ "exports": {
+ ".": {
+ "import": "./dist/mymodule.mjs"
+ }
+ }
+}
+```
diff --git a/docs/3.guide/1.concepts/8.typescript.md b/docs/3.guide/1.concepts/8.typescript.md
new file mode 100644
index 000000000000..2c73c700859f
--- /dev/null
+++ b/docs/3.guide/1.concepts/8.typescript.md
@@ -0,0 +1,120 @@
+---
+title: 'TypeScript'
+description: "Nuxt is fully typed and provides helpful shortcuts to ensure you have access to accurate type information when you are coding."
+---
+
+## Type-checking
+
+By default, Nuxt doesn't check types when you run [`nuxt dev`](/docs/4.x/api/commands/dev) or [`nuxt build`](/docs/4.x/api/commands/build), for performance reasons.
+
+To enable type-checking at build or development time, install `vue-tsc` and `typescript` as development dependency:
+
+::code-group{sync="pm"}
+
+ ```bash [npm]
+ npm install --save-dev vue-tsc typescript
+ ```
+
+ ```bash [yarn]
+ yarn add --dev vue-tsc typescript
+ ```
+
+ ```bash [pnpm]
+ pnpm add -D vue-tsc typescript
+ ```
+
+ ```bash [bun]
+ bun add -D vue-tsc typescript
+ ```
+
+ ```bash [deno]
+ deno add -D npm:vue-tsc npm:typescript
+ ```
+
+::
+
+Then, run [`nuxt typecheck`](/docs/4.x/api/commands/typecheck) command to check your types:
+
+```bash [Terminal]
+npx nuxt typecheck
+```
+
+To enable type-checking at build or development time, you can also use the [`typescript.typeCheck`](/docs/4.x/api/nuxt-config#typecheck) option in your `nuxt.config` file:
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ typescript: {
+ typeCheck: true,
+ },
+})
+```
+
+## Auto-generated Types
+
+Nuxt projects rely on auto-generated types to work properly. These types are stored in the [`.nuxt`](/docs/4.x/directory-structure/nuxt) directory and are generated when you run the dev server or build your application. You can also generate these files manually by running `nuxt prepare`.
+
+The generated `tsconfig.json` files inside the [`.nuxt`](/docs/4.x/directory-structure/nuxt) directory include **recommended basic TypeScript configuration** for your project, references to [auto-imports](/docs/4.x/guide/concepts/auto-imports), [API route types](/docs/4.x/guide/concepts/server-engine#typed-api-routes), path aliases like `#imports`, `~/file`, or `#build/file`, and more.
+
+::warning
+Nuxt relies on this configuration, and [Nuxt modules](/docs/4.x/guide/modules) can extend it as well. For this reason, it is not recommended to modify your `tsconfig.json` file directly, as doing so could overwrite important settings. Instead, extend it via `nuxt.config.ts`. [Learn more about extending the configuration here](/docs/4.x/directory-structure/tsconfig).
+::
+
+::tip{icon="i-lucide-video" to="https://youtu.be/umLI7SlPygY" target="_blank"}
+Watch a video from Daniel Roe explaining built-in Nuxt aliases.
+::
+
+## Project References
+
+Nuxt uses [TypeScript project references](https://www.typescriptlang.org/docs/handbook/project-references.html) to improve type-checking performance and provide better IDE support. This feature allows TypeScript to break up your codebase into smaller, more manageable pieces.
+
+### How Nuxt Uses Project References
+
+When you run `nuxt dev`, `nuxt build` or `nuxt prepare`, Nuxt will generate multiple `tsconfig.json` files for different parts of your application.
+
+- **`.nuxt/tsconfig.app.json`** - Configuration for your application code within the `app/` directory
+- **`.nuxt/tsconfig.node.json`** - Configuration for your `nuxt.config.ts` and files outside the other contexts
+- **`.nuxt/tsconfig.server.json`** - Configuration for server-side code (when applicable)
+- **`.nuxt/tsconfig.shared.json`** - For code shared between app and server contexts (like types and non-environment specific utilities)
+
+Each of these files is configured to reference the appropriate dependencies and provide optimal type-checking for their specific context.
+
+::note
+For backward compatibility, Nuxt still generates `.nuxt/tsconfig.json`. However, we recommend using [TypeScript project references](/docs/4.x/directory-structure/tsconfig) with the new configuration files (`.nuxt/tsconfig.app.json`, `.nuxt/tsconfig.server.json`, etc.) for better type safety and performance. This legacy file will be removed in a future version of Nuxt.
+::
+
+### Benefits of Project References
+
+- **Faster builds**: TypeScript can skip rebuilding unchanged projects
+- **Better IDE performance**: Your IDE can provide faster IntelliSense and error checking
+- **Isolated compilation**: Errors in one part of your application don't prevent compilation of other parts
+- **Clearer dependency management**: Each project explicitly declares its dependencies
+
+### Augmenting Types with Project References
+
+Since the project is divided into **multiple type contexts**, it's important to **augment types within the correct context** to ensure they're properly recognized. TypeScript will not recognize augmentations placed outside these directories unless they are explicitly included in the appropriate context.
+
+For example, if you want to augment types for the `app` context, the augmentation file should be placed in the `app/` directory.
+
+Similarly:
+- For the `server` context, place the augmentation file in the `server/` directory.
+- For types that are **shared between the app and server**, place the file in the `shared/` directory.
+
+::read-more{to="/docs/4.x/guide/modules/recipes-advanced#extend-typescript-config"}
+Read more about augmenting specific type contexts from **files outside those contexts** in the Module Author Guide.
+::
+
+## Strict Checks
+
+TypeScript comes with certain checks to give you more safety and analysis of your program.
+
+[Strict checks](https://www.typescriptlang.org/docs/handbook/migrating-from-javascript.html#getting-stricter-checks) are enabled by default in Nuxt when the [`typescript.typeCheck`](/docs/4.x/guide/concepts/typescript#type-checking) option is enabled to give you greater type safety.
+
+If you are currently converting your codebase to TypeScript, you may want to temporarily disable strict checks by setting `strict` to `false` in your `nuxt.config`:
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ typescript: {
+ strict: false,
+ },
+})
+```
diff --git a/docs/3.guide/1.concepts/9.code-style.md b/docs/3.guide/1.concepts/9.code-style.md
new file mode 100644
index 000000000000..a7d3ce3b400c
--- /dev/null
+++ b/docs/3.guide/1.concepts/9.code-style.md
@@ -0,0 +1,22 @@
+---
+title: 'Code Style'
+description: "Nuxt supports ESLint out of the box"
+---
+
+## ESLint
+
+The recommended approach for Nuxt is to enable ESLint support using the [`@nuxt/eslint`](https://eslint.nuxt.com/packages/module) module, that will setup project-aware ESLint configuration for you.
+
+:::callout{icon="i-lucide-lightbulb"}
+The module is designed for the [new ESLint flat config format](https://eslint.org/docs/latest/use/configure/configuration-files) which is the [default format since ESLint v9](https://eslint.org/blog/2024/04/eslint-v9.0.0-released/). If you are using the legacy `.eslintrc` config, you will need to [configure manually with `@nuxt/eslint-config`](https://eslint.nuxt.com/packages/config#customizing-the-config). We highly recommend you to migrate over the flat config to be future-proof.
+:::
+
+## Quick Setup
+
+```bash
+npx nuxt module add eslint
+```
+
+Start your Nuxt app, a `eslint.config.mjs` file will be generated under your project root. You can customize it as needed.
+
+You can learn more about the module and customizations in [Nuxt ESLint's documentation](https://eslint.nuxt.com/packages/module).
diff --git a/docs/3.guide/2.best-practices/.navigation.yml b/docs/3.guide/2.best-practices/.navigation.yml
new file mode 100644
index 000000000000..4976f81a0dd5
--- /dev/null
+++ b/docs/3.guide/2.best-practices/.navigation.yml
@@ -0,0 +1,3 @@
+title: Best Practices
+titleTemplate: '%s · Best Practices'
+icon: i-lucide-square-check
diff --git a/docs/3.guide/2.best-practices/hydration.md b/docs/3.guide/2.best-practices/hydration.md
new file mode 100644
index 000000000000..b1aa410f34b1
--- /dev/null
+++ b/docs/3.guide/2.best-practices/hydration.md
@@ -0,0 +1,188 @@
+---
+navigation.title: 'Nuxt and Hydration'
+title: Nuxt and Hydration
+description: Why fixing hydration issues is important
+---
+
+When developing, you may face hydration issues. Don't ignore those warnings.
+
+## Why is it important to fix them?
+
+Hydration mismatches are not just warnings - they are indicators of serious problems that can break your application:
+
+### Performance Impact
+
+- **Increased time to interactive**: Hydration errors force Vue to re-render the entire component tree, which will increase the time for your Nuxt app to become interactive
+- **Poor user experience**: Users may see content flashing or unexpected layout shifts
+
+### Functionality Issues
+
+- **Broken interactivity**: Event listeners may not attach properly, leaving buttons and forms non-functional
+- **State inconsistencies**: Application state can become out of sync between what the user sees and what the application thinks is rendered
+- **SEO problems**: Search engines may index different content than what users actually see
+
+## How to detect them
+
+### Development Console Warnings
+
+Vue will log hydration mismatch warnings in the browser console during development:
+
+
+
+## Common reasons
+
+### Browser-only APIs in Server Context
+
+**Problem**: Using browser-specific APIs during server-side rendering.
+
+```html
+
+ User preference: {{ userTheme }}
+
+
+
+```
+
+**Solution**: You can use [`useCookie`](/docs/4.x/api/composables/use-cookie):
+
+```html
+
+ User preference: {{ userTheme }}
+
+
+
+```
+
+### Inconsistent Data
+
+**Problem**: Different data between server and client.
+
+```html
+
+ {{ Math.random() }}
+
+```
+
+**Solution**: Use SSR-friendly state:
+
+```html
+
+ {{ state }}
+
+
+
+```
+
+### Conditional Rendering Based on Client State
+
+**Problem**: Using client-only conditions during SSR.
+
+```html
+
+
+ Desktop content
+
+
+```
+
+**Solution**: Use media queries or handle it client-side:
+
+```html
+
+
+
Desktop content
+
Mobile content
+
+```
+
+### Third-party Libraries with Side Effects
+
+**Problem**: Libraries that modify the DOM or have browser dependencies (this happens a LOT with tag managers).
+
+```html
+
+```
+
+**Solution**: Initialise libraries after hydration has completed:
+
+```html
+
+```
+
+### Dynamic Content Based on Time
+
+**Problem**: Content that changes based on current time.
+
+```html
+
+ {{ greeting }}
+
+
+
+```
+
+**Solution**: Use [`NuxtTime`](/docs/4.x/api/components/nuxt-time) component or handle it client-side:
+
+```html
+
+
+
+
+```
+
+```html
+
+
+
+ {{ greeting }}
+
+ Hello!
+
+
+
+
+
+
+```
+
+## In summary
+
+1. **Use SSR-friendly composables**: [`useFetch`](/docs/4.x/api/composables/use-fetch), [`useAsyncData`](/docs/4.x/api/composables/use-async-data), [`useState`](/docs/4.x/api/composables/use-state)
+2. **Wrap client-only code**: Use [`ClientOnly`](/docs/4.x/api/components/client-only) component for browser-specific content
+3. **Consistent data sources**: Ensure server and client uses the same data
+4. **Avoid side effects in setup**: Move browser-dependent code to `onMounted`
+
+::tip
+You can read the [Vue documentation on SSR hydration mismatch](https://vuejs.org/guide/scaling-up/ssr#hydration-mismatch) for a better understanding of hydration.
+::
diff --git a/docs/3.guide/2.best-practices/performance.md b/docs/3.guide/2.best-practices/performance.md
new file mode 100644
index 000000000000..addf8968d05c
--- /dev/null
+++ b/docs/3.guide/2.best-practices/performance.md
@@ -0,0 +1,307 @@
+---
+navigation.title: 'Nuxt Performance'
+title: Nuxt performance
+description: Best practices for improving performance of Nuxt apps.
+---
+
+Nuxt comes with built-in features designed to improve your application's performance and contribute to better [Core Web Vitals](https://web.dev/articles/vitals). There are also multiple Nuxt core modules that assist in improving performance in specific areas. This guide outlines best practices to optimize performance of your Nuxt application.
+
+## Built-in Features
+
+Nuxt offers several built-in features that help you optimize performance of your website. Understanding how these features work is crucial for achieving blazingly-fast performance.
+
+### Links
+
+[``](/docs/4.x/api/components/nuxt-link) is a drop-in replacement for both Vue Router's `` component and HTML's `` tag. It intelligently determines whether the link is internal or external and renders it accordingly with available optimizations (prefetching, default attributes, etc.)
+
+```html
+
+ About page
+
+
+
+ About page
+```
+
+Nuxt automatically includes smart prefetching. That means it detects when a link is visible (by default), either in the viewport or when scrolling and prefetches the JavaScript for those pages so that they are ready when the user clicks the link.
+
+You can also opt for prefetching on interaction instead:
+
+```ts
+export default defineNuxtConfig({
+ experimental: {
+ defaults: {
+ nuxtLink: {
+ prefetchOn: {
+ interaction: true,
+ visibility: false,
+ },
+ },
+ },
+ },
+})
+```
+
+:read-more{title="NuxtLink" to="/docs/4.x/api/components/nuxt-link"}
+
+### Hybrid Rendering
+
+In more complex applications, we may need a full control over how our application is rendered to support cases where some pages could be generated at build time, while others should be client-side rendered
+
+Hybrid rendering allows different caching rules per route using Route Rules and decides how the server should respond to a new request on a given URL:
+
+```ts
+export default defineNuxtConfig({
+ routeRules: {
+ '/': {
+ prerender: true,
+ },
+ '/products/**': {
+ swr: 3600,
+ },
+ '/blog': {
+ isr: 3600,
+ },
+ '/admin/**': {
+ ssr: false,
+ },
+ },
+})
+```
+
+Nuxt server will automatically register corresponding middleware and wrap routes with cache handlers using Nitro caching layer.
+
+:read-more{title="Hybrid rendering" to="/docs/4.x/guide/concepts/rendering#hybrid-rendering"}
+
+### Lazy Loading Components
+
+To dynamically import a component (also known as lazy-loading a component) all you need to do is add the Lazy prefix to the component's name. This is useful if the component is not always needed.
+
+```html
+
+
+
+
+
Mountains
+ Show List
+
+
+```
+
+By using the Lazy prefix you can delay loading the component code until the right moment, which can be helpful for optimizing your JavaScript bundle size.
+
+:read-more{title="Lazy loading components" to="/docs/4.x/directory-structure/app/components#dynamic-imports"}
+
+### Lazy Hydration
+
+It is not always necessary to hydrate (or make interactive) all the components of your site on the initial load. Using lazy hydration, you can control when components can have their code loaded, which can improve the time-to-interactive metric for your app. Nuxt allows you to control when components become interactive with lazy hydration (added in Nuxt v3.16).
+
+```html
+
+
+
+
+```
+
+To optimize your app, you may want to delay the hydration of some components until they're visible, or until the browser is done with more important tasks.
+
+:read-more{title="Lazy hydration" to="/docs/4.x/directory-structure/app/components#delayed-or-lazy-hydration"}
+
+### Fetching data
+
+To avoid fetching same data twice (once on the server and once on client) Nuxt provides [`useFetch`](/docs/4.x/api/composables/use-fetch) and [`useAsyncData`](/docs/4.x/api/composables/use-async-data). They ensure that if an API call is made on the server, the data is forwarded to the client in the payload instead of being fetched again.
+
+:read-more{title="Data fetching" to="/docs/4.x/getting-started/data-fetching"}
+
+## Core Nuxt Modules
+
+Apart from Nuxt's built-in features, there are also core modules maintained by the Nuxt team which help improve performance even further. These modules help handle assets such as images, custom fonts, or third party scripts.
+
+### Images
+
+Unoptimized images can have a significant negative impact on your website performance, specifically the [Largest Contentful Paint (LCP)](https://web.dev/articles/lcp) score.
+
+In Nuxt we can use [Nuxt Image](https://image.nuxt.com/) module that is a plug-and-play image optimization for Nuxt apps. It allows resizing and transforming your images using built-in optimizer or your favorite images CDN.
+
+:video-accordion{title="Watch the video by LearnVue about Nuxt Image" videoId="_UBff2eqGY0"}
+
+[``](/docs/4.x/api/components/nuxt-img) is a drop-in replacement for the native `
+
+
+```
+
+:read-more{title="Nuxt Image" to="https://image.nuxt.com/usage/nuxt-img"}
+
+### Fonts
+
+[Nuxt Fonts](https://fonts.nuxt.com/) will automatically optimize your fonts (including custom fonts) and remove external network requests for improved privacy and performance.
+
+It includes built-in automatic self-hosting for any font file which means you can optimally load web fonts with reduced layout shift, thanks to the underlying package [fontaine](https://github.com/unjs/fontaine).
+
+:video-accordion{title="Watch the talk by Daniel Roe about the idea behind Nuxt Fonts" videoId="D3F683UViBY"}
+
+Nuxt Fonts processes all your CSS and does the following things automatically when it encounters a font-family declaration.
+
+1. **Resolves fonts** – Looks for font files in public/, then checks web providers like Google, Bunny, and Fontshare.
+2. **Generates @font-face rules** – Injects CSS rules to load fonts from the correct sources.
+3. **Proxies & caches fonts** – Rewrites URLs to `/_fonts`, downloads and caches fonts locally.
+4. **Creates fallback metrics** – Adjusts local system fonts to match web fonts, reducing layout shift ([CLS](https://web.dev/articles/cls)).
+5. **Includes fonts in build** – Bundles fonts with your project, hashing file names and setting long-lived cache headers.
+
+It supports multiple providers that are designed to be pluggable and extensible, so no matter your setup you should be able to use an existing provider or write your own.
+
+### Scripts
+
+Third-party resources like analytics tools, video embeds, maps, and social media integrations enhance website functionality but can significantly degrade user experience and negatively impact [Interaction to Next Paint (INP)](https://web.dev/articles/inp) and Largest Contentful Paint (LCP) scores.
+
+[Nuxt Scripts](https://scripts.nuxt.com/) lets you load third-party scripts with better performance, privacy, security and DX.
+
+:video-accordion{title="Watch the video by Alex Lichter about Nuxt Scripts" videoId="sjMqUUvH9AE"}
+
+Nuxt Scripts provides an abstraction layer on top of third-party scripts, providing SSR support and type-safety and while still giving you full low-level control over how a script is loaded.
+
+```ts
+const { onLoaded, proxy } = useScriptGoogleAnalytics(
+ {
+ id: 'G-1234567',
+ scriptOptions: {
+ trigger: 'manual',
+ },
+ },
+)
+// queue events to be sent when ga loads
+proxy.gtag('config', 'UA-123456789-1')
+// or wait until ga is loaded
+onLoaded((gtag) => {
+ // script loaded
+})
+```
+
+:read-more{title="Nuxt Scripts" to="https://scripts.nuxt.com/scripts"}
+
+## Profiling Tools
+
+To improve performance, we need to first know how to measure it, starting with measuring performance during development - on local environment, and then moving to auditing application that are deployed on production.
+
+### Nuxi Analyze
+
+[This](/docs/4.x/api/commands/analyze) command of `nuxi` allows to analyze the production bundle or your Nuxt application. It leverages `vite-bundle-visualizer` (similar to `webpack-bundle-analyzer`) to generate a visual representation of your application's bundle, making it easier to identify which components take up the most space.
+
+When you see a large block in the visualization, it often signals an opportunity for optimization—whether by splitting it into smaller parts, implementing lazy loading, or replacing it with a more efficient alternative, especially for third-party libraries.
+
+Large blocks containing multiple elements can often be reduced by importing only the necessary components rather than entire modules while large standalone blocks may be better suited for lazy loading rather than being included in the main bundle.
+
+### Nuxt DevTools
+
+The [Nuxt DevTools](https://devtools.nuxt.com/) gives you insights and transparency about your Nuxt App to identify performance gaps and seamlessly manage your app configurations.
+
+
+
+It comes with several features we can use to measure performance of Nuxt apps:
+1. **Timeline** – Tracks time spent on rendering, updating, and initializing components to identify performance bottlenecks.
+2. **Assets** – Displays file sizes (e.g., images) without transformations.
+3. **Render Tree** – Shows connections between Vue components, scripts, and styles to optimize dynamic loading.
+4. **Inspect** – Lists all files used in the Vue app with their size and evaluation time.
+
+### Chrome DevTools
+
+Chrome DevTools come with two useful tabs for measuring performance; `Performance` and `Lighthouse`.
+
+When you open the [Performance](https://developer.chrome.com/docs/devtools/performance/overview) panel, it instantly shows your local **Largest Contentful Paint (LCP)** and **Cumulative Layout Shift (CLS)** scores (good, needs improvement, or bad).
+
+If you interact with the page, it also captures **Interaction to Next Paint (INP)**, giving you a full view of your Core Web Vitals based on your device and network.
+
+
+
+[Lighthouse](https://developer.chrome.com/docs/devtools/lighthouse) audits performance, accessibility, SEO, progressive web apps, and best practices. It runs tests on your page and generates a report. Use failing audits as a guide to improve your site.
+
+
+
+Each audit has a reference document explaining why the audit is important, as well as how to fix it.
+
+### PageSpeed Insights
+
+[PageSpeed Insights (PSI)](https://developers.google.com/speed/docs/insights/v5/about) reports on the user experience of a page on both mobile and desktop devices, and provides suggestions on how that page may be improved.
+
+It provides both lab and field data about a page. Lab data is useful for debugging issues, as it is collected in a controlled environment while field data is useful for capturing true, real-world user experience.
+
+### Web Page Test
+
+[WebPageTest](https://www.webpagetest.org/) is a web performance tool providing deep diagnostic information about how a page performs under a variety of conditions.
+
+Each test can be run from different locations around the world, on real browsers, over any number of customizable network conditions.
+
+## Common problems
+
+When building more complex Nuxt applications, you will probably encounter some of the problems listed below. Understanding these problems and fixing them will help you improve performance of your website.
+
+### Overusing plugins
+
+**Problem**: A large number of plugins can cause performance issues, especially if they require expensive computations or take too long to initialize. Since plugins run during the hydration phase, inefficient setups can block rendering and degrade the user experience.
+
+**Solution**: Inspect your plugins and see if some of them could be implemented rather as a composable or utility function instead.
+
+### Unused code / dependencies
+
+**Problem**: With the development of the project, there can be a case where there will be some unused code or a dependency. This additional functionality may not be used or needed while it will be increase the bundle size of our project.
+
+**Solution**: Inspect your `package.json` for unused dependencies and analyze your code for unused utils/composables/functions.
+
+### Not using Vue Performance tips
+
+**Problem**: [Vue documentation](https://vuejs.org/guide/best-practices/performance) lists several Performance improvements we can use in our Nuxt projects as well but as they are part of Vue documentation, developers tend to forget about it and focus on Nuxt specific improvements only - while Nuxt application is still a Vue project.
+
+**Solution**: Use concepts such as `shallowRef`, `v-memo`, `v-once`, etc to improve performance.
+
+### Not following patterns
+
+**Problem**: The more people are currently working on the project, the more difficult it will be to maintain the stable codebase. Developers have a tendency to introduce new concepts they've seen in another project which can cause conflicts and problems with performance.
+
+**Solution**: Establish rules and patterns in the project such as [Good practices and Design Patterns for Vue Composables](https://dev.to/jacobandrewsky/good-practices-and-design-patterns-for-vue-composables-24lk)
+
+### Trying to load everything at the same time
+
+**Problem**: When a page is loaded and it is not correctly instructed about the order of loading elements it will result in fetching everything at the same time - which can be slow and result in bad User Experience.
+
+**Solution**: Use concepts such as Progressive Enhancement where core webpage content is set first, then more nuanced and technically rigorous layers of presentation and features are added on top as the browser/internet connection allow.
+
+## Useful Resources
+
+To learn more about various techniques for improving performance, take a look at the following resources:
+
+1. [Apply instant loading with the PRPL pattern](https://web.dev/articles/apply-instant-loading-with-prpl)
+2. [Perceived performance](https://developer.mozilla.org/en-US/docs/Learn_web_development/Extensions/Performance/Perceived_performance)
+3. [Understanding Critical Rendering Path](https://developer.mozilla.org/en-US/docs/Web/Performance/Guides/Critical_rendering_path)
diff --git a/docs/3.guide/2.best-practices/plugins.md b/docs/3.guide/2.best-practices/plugins.md
new file mode 100644
index 000000000000..93a78f0563b9
--- /dev/null
+++ b/docs/3.guide/2.best-practices/plugins.md
@@ -0,0 +1,20 @@
+---
+navigation.title: 'Nuxt Plugins'
+title: Nuxt Plugins
+description: Best practices when using Nuxt plugins.
+---
+
+Plugins in Nuxt allow you to extend your application with additional functionality. However, improper use can lead to performance bottlenecks. This guide outlines best practices to optimize your Nuxt plugins.
+
+## Avoid costly plugin setup
+
+A large number of plugins can cause performance issues, especially if they require expensive computations or take too long to initialize. Since plugins run during the hydration phase, inefficient setups can block rendering and degrade the user experience.
+
+## Use Composition whenever possible
+
+Whenever possible, favor composition over plugins. Just like in Vue, many utilities and composables can be used directly without the need for a plugin. This keeps your project lightweight and improves maintainability.
+
+## If `async`, enable `parallel`
+
+By default, all plugins loads synchronously.
+When defining asynchronous plugins, setting `parallel: true` allows multiple plugins to load concurrently, improving performance by preventing blocking operations.
diff --git a/docs/3.guide/3.ai/.navigation.yml b/docs/3.guide/3.ai/.navigation.yml
new file mode 100644
index 000000000000..8b00460c1050
--- /dev/null
+++ b/docs/3.guide/3.ai/.navigation.yml
@@ -0,0 +1,3 @@
+title: 'Working with AI'
+titleTemplate: 'Working with AI: %s'
+icon: i-lucide-bot
diff --git a/docs/3.guide/3.ai/1.mcp.md b/docs/3.guide/3.ai/1.mcp.md
new file mode 100644
index 000000000000..0f098a1854d6
--- /dev/null
+++ b/docs/3.guide/3.ai/1.mcp.md
@@ -0,0 +1,277 @@
+---
+title: Nuxt MCP Server
+description: Use Nuxt documentation in your AI assistants with Model Context Protocol support.
+navigation.title: MCP Server
+---
+
+## What is MCP?
+
+MCP (Model Context Protocol) is a standardized protocol that enables AI assistants to access external data sources and tools. Nuxt provides an MCP server that allows AI assistants like Claude Code, Cursor, and Windsurf to access documentation, blog posts, and deployment guides directly.
+
+The MCP server provides structured access to the Nuxt documentation, making it easy for AI tools to understand and assist with Nuxt development.
+
+## Resources
+
+The Nuxt MCP server provides the following resources for discovery:
+
+- **`resource://nuxt-com/documentation-pages`**: Browse all available documentation pages (defaults to v4.x)
+- **`resource://nuxt-com/blog-posts`**: Browse all Nuxt blog posts including releases and tutorials
+- **`resource://nuxt-com/deploy-providers`**: Browse all deployment providers and hosting platforms
+
+You're able to access these resources with tools like Claude Code by using `@`.
+
+## Tools
+
+The Nuxt MCP server provides the following tools organized by category:
+
+### Documentation
+
+- **`list_documentation_pages`**: Lists all available Nuxt documentation pages with their categories and basic information. Supports version filtering (3.x, 4.x, or all)
+- **`get_documentation_page`**: Retrieves documentation page content and details by path
+- **`get_getting_started_guide`**: Gets the getting started guide for a specific Nuxt version
+
+### Blog
+
+- **`list_blog_posts`**: Lists all Nuxt blog posts with metadata including dates, categories, and tags
+- **`get_blog_post`**: Retrieves blog post content and details by path
+
+### Deployment
+
+- **`list_deploy_providers`**: Lists all deployment providers and hosting platforms for Nuxt applications
+- **`get_deploy_provider`**: Retrieves deployment provider details and instructions by path
+
+## Prompts
+
+The Nuxt MCP server provides guided prompts for common workflows:
+
+- **`find_documentation_for_topic`**: Find the best Nuxt documentation for a specific topic or feature
+- **`deployment_guide`**: Get deployment instructions for a specific hosting provider
+- **`migration_help`**: Get help with migrating between Nuxt versions
+
+You're able to access these resources with tools like Claude Code by using `/`.
+
+## Setup
+
+The Nuxt MCP server uses HTTP transport and can be installed in different AI assistants.
+
+### ChatGPT
+
+::note{icon="i-lucide-info"}
+**Custom connectors using MCP are available on ChatGPT for Pro and Plus accounts** on the web.
+::
+
+Follow these steps to set up Nuxt as a connector within ChatGPT:
+
+1. **Enable Developer mode:**
+ - Go to Settings → Connectors → Advanced settings → Developer mode
+
+2. **Open ChatGPT settings**
+
+3. **In the Connectors tab, Create a new connector:**
+ - Give it a name: `Nuxt`
+ - MCP server URL: `https://nuxt.com/mcp`
+ - Authentication: `None`
+
+4. **Click Create**
+
+The Nuxt connector will appear in the composer's "Developer mode" tool later during conversations.
+
+### Claude Code
+
+::note{icon="i-lucide-info"}
+**Ensure Claude Code is installed** - Visit [Anthropic's documentation](https://code.claude.com/docs/en/quickstart) for installation instructions.
+::
+
+Add the server using the CLI command:
+
+```bash
+claude mcp add --transport http nuxt-remote https://nuxt.com/mcp
+```
+
+### Claude Desktop
+
+#### Setup Instructions
+
+1. Open Claude Desktop and navigate to "Settings" > "Developer".
+2. Click on "Edit Config". This will open the local Claude directory.
+3. Modify the `claude_desktop_config.json` file with your custom MCP server configuration.
+ ```json [claude_desktop_config.json]
+ {
+ "mcpServers": {
+ "nuxt": {
+ "command": "npx",
+ "args": [
+ "mcp-remote",
+ "https://nuxt.com/mcp"
+ ]
+ }
+ }
+ }
+ ```
+4. Restart Claude Desktop app. The Nuxt MCP server should now be registered.
+
+### Cursor
+
+Click the button below to install the Nuxt MCP server directly in Cursor:
+
+::u-button
+---
+to: "cursor://anysphere.cursor-deeplink/mcp/install?name=nuxt&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbnV4dC5jb20vbWNwIn0%3D"
+label: Install MCP Server
+color: neutral
+icon: i-custom-cursor
+---
+::
+
+For manual setup, follow these steps:
+
+1. Open Cursor and go to "Settings" > "Tools & MCP"
+2. Add the Nuxt MCP server configuration
+
+Or manually create/update `.cursor/mcp.json` in your project root:
+
+```json [.cursor/mcp.json]
+{
+ "mcpServers": {
+ "nuxt": {
+ "type": "http",
+ "url": "https://nuxt.com/mcp"
+ }
+ }
+}
+```
+
+### Le Chat Mistral
+
+1. Navigate to "Intelligence" > "Connectors"
+2. Click on "Add Connector" button, then select "Custom MCP Connector"
+3. Create your Custom MCP Connector:
+ - Connector Name : `Nuxt`
+ - Connector Server : `https://nuxt.com/mcp`
+
+### Visual Studio Code
+
+::note{icon="i-lucide-info"}
+**Install required extensions** - Ensure you have [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) and [GitHub Copilot Chat](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat) extensions installed.
+::
+
+1. Open VS Code and access the Command Palette (Ctrl/Cmd + Shift + P)
+2. Type "Preferences: Open Workspace Settings (JSON)" and select it
+3. Navigate to your project's `.vscode` folder or create one if it doesn't exist
+4. Create or edit the `mcp.json` file with the following configuration:
+
+```json [.vscode/mcp.json]
+{
+ "servers": {
+ "nuxt": {
+ "type": "http",
+ "url": "https://nuxt.com/mcp"
+ }
+ }
+}
+```
+
+### GitHub Copilot Agent
+
+::note{icon="i-lucide-info"}
+**Repository administrator access required** to configure MCP servers for GitHub Copilot coding agent.
+::
+
+If you have already configured MCP servers in VS Code (replace the `servers` key with `mcpServers` for GitHub Copilot Agent), you can leverage a similar configuration for GitHub Copilot coding agent. You will need to add a `tools` key specifying which tools are available to Copilot.
+
+1. Navigate to your GitHub repository
+2. Go to **Settings** > **Code & automation** > **Copilot** > **Coding agent**
+3. In the **MCP configuration** section, add the following configuration:
+ ```json
+ {
+ "mcpServers": {
+ "nuxt": {
+ "type": "http",
+ "url": "https://nuxt.com/mcp",
+ "tools": ["*"]
+ }
+ }
+ }
+ ```
+4. Click **Save**
+
+#### Validating the Configuration
+
+To verify the MCP server is configured correctly:
+
+1. Create an issue in your repository and assign it to Copilot
+2. Wait for Copilot to create a pull request
+3. In the pull request, click **View session** in the "Copilot started work" timeline event
+4. Click the ellipsis button (**...**) at the top right, then click **Copilot** in the sidebar
+5. Expand the **Start MCP Servers** step to see the configured Nuxt tools
+
+For more information on using MCP with GitHub Copilot coding agent, see [Extend coding agent with MCP](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/coding-agent/extend-coding-agent-with-mcp).
+
+### Windsurf
+
+1. Open Windsurf and navigate to "Settings" > "Windsurf Settings" > "Cascade"
+2. Click the "Manage MCPs" button, then select the "View raw config" option
+3. Add the following configuration to your MCP settings:
+
+```json [.codeium/windsurf/mcp_config.json]
+{
+ "mcpServers": {
+ "nuxt": {
+ "type": "http",
+ "url": "https://nuxt.com/mcp"
+ }
+ }
+}
+```
+
+### Zed
+
+1. Open Zed and go to "Settings" > "Open Settings"
+2. Navigate to the JSON settings file
+3. Add the following context server configuration to your settings:
+
+```json [.config/zed/settings.json]
+{
+ "context_servers": {
+ "nuxt": {
+ "source": "custom",
+ "command": "npx",
+ "args": ["mcp-remote", "https://nuxt.com/mcp"],
+ "env": {}
+ }
+ }
+}
+```
+
+### Opencode
+
+1. In your project root, create `opencode.json`
+2. Add the following configuration:
+
+```json
+{
+ "$schema": "https://opencode.ai/config.json",
+ "mcp": {
+ "nuxt": {
+ "type": "remote",
+ "url": "https://nuxt.com/mcp",
+ "enabled": true
+ }
+ }
+}
+```
+
+## Prompts Examples
+
+Once configured, you can ask your AI assistant questions like:
+
+- "List all available Nuxt documentation pages"
+- "Get the introduction documentation"
+- "What's the difference between v3 and v4?"
+- "How do I deploy to Vercel?"
+- "Show me the latest blog posts"
+- "Help me migrate from Nuxt 3 to Nuxt 4"
+- "Search documentation about composables"
+- "Find deployment guides for Cloudflare"
+
+The AI assistant will use the MCP server to fetch structured JSON data and provide guided assistance for Nuxt development.
diff --git a/docs/3.guide/3.ai/2.llms-txt.md b/docs/3.guide/3.ai/2.llms-txt.md
new file mode 100644
index 000000000000..5d25857e6dde
--- /dev/null
+++ b/docs/3.guide/3.ai/2.llms-txt.md
@@ -0,0 +1,65 @@
+---
+title: Nuxt LLMs.txt
+description: How to get AI tools like Cursor, Windsurf, GitHub Copilot, ChatGPT, and Claude to understand Nuxt concepts, APIs, and best practices.
+navigation.title: LLMs.txt
+---
+
+## What is LLMs.txt?
+
+LLMs.txt is a structured documentation format specifically designed for large language models (LLMs). Nuxt provides LLMs.txt files that contain comprehensive information about the framework, making it easy for AI tools to understand and assist with Nuxt development.
+
+These files are optimized for AI consumption and contain structured information about concepts, APIs, usage patterns, and best practices.
+
+## Available routes
+
+We provide LLMs.txt routes to help AI tools access our documentation:
+
+- **`/llms.txt`** - Contains a structured overview of all documentation pages and their links (~5K tokens)
+- **`/llms-full.txt`** - Provides comprehensive documentation including getting started guides, API references, blog posts, and deployment guides (~1M+ tokens)
+
+## Choosing the Right File
+
+::note{icon="i-lucide-info"}
+**Most users should start with `/llms.txt`** - it contains all essential information and works with standard LLM context windows.
+
+Use `/llms-full.txt` only if you need comprehensive implementation details and your AI tool supports large contexts (200K+ tokens).
+::
+
+## Important usage notes
+
+::warning{icon="i-lucide-alert-triangle"}
+**@-symbol must be typed manually** - When using tools like Cursor or Windsurf, the `@` symbol must be typed by hand in the chat interface. Copy-pasting breaks the tool's ability to recognize it as a context reference.
+::
+
+## Usage with AI Tools
+
+### Cursor
+
+Nuxt provides specialized LLMs.txt files that you can reference in Cursor for better AI assistance with Nuxt development.
+
+#### How to use
+
+1. **Direct reference**: Mention the LLMs.txt URLs when asking questions
+2. Add these specific URLs to your project context using `@docs`
+
+[Read more about Cursor Web and Docs Search](https://cursor.com/docs/context/mentions)
+
+### Windsurf
+
+Windsurf can directly access the Nuxt LLMs.txt files to understand framework usage and best practices.
+
+#### Using LLMs.txt with Windsurf
+
+- Use `@docs` to reference specific LLMs.txt URLs
+- Create persistent rules referencing these URLs in your workspace
+
+[Read more about Windsurf Web and Docs Search](https://docs.windsurf.com/windsurf/cascade/web-search)
+
+### Other AI Tools
+
+Any AI tool that supports LLMs.txt can use these routes to better understand Nuxt.
+
+#### Examples for ChatGPT, Claude, or other LLMs
+
+- "Using Nuxt documentation from https://nuxt.com/llms.txt"
+- "Follow complete Nuxt guidelines from https://nuxt.com/llms-full.txt"
diff --git a/docs/3.guide/4.modules/.navigation.yml b/docs/3.guide/4.modules/.navigation.yml
new file mode 100644
index 000000000000..cbc9618d0e45
--- /dev/null
+++ b/docs/3.guide/4.modules/.navigation.yml
@@ -0,0 +1,3 @@
+title: Module Author Guide
+titleTemplate: '%s · Nuxt Modules Author Guide'
+icon: i-lucide-box
diff --git a/docs/3.guide/4.modules/1.getting-started.md b/docs/3.guide/4.modules/1.getting-started.md
new file mode 100644
index 000000000000..4db8e4ff9b63
--- /dev/null
+++ b/docs/3.guide/4.modules/1.getting-started.md
@@ -0,0 +1,103 @@
+---
+title: "Create Your First Module"
+description: "Learn how to create your first Nuxt module using the official starter template."
+---
+
+## Create a Module
+
+We recommend you get started with Nuxt modules using our [starter template](https://github.com/nuxt/starter/tree/module):
+
+::code-group{sync="pm"}
+
+```bash [npm]
+npm create nuxt -- -t module my-module
+```
+
+```bash [yarn]
+yarn create nuxt -t module my-module
+```
+
+```bash [pnpm]
+pnpm create nuxt -t module my-module
+```
+
+```bash [bun]
+bun create nuxt --template=module my-module
+```
+::
+
+This will create a `my-module` project with all the boilerplate necessary to develop and publish your module.
+
+**Next steps:**
+
+1. Open `my-module` in your IDE of choice
+2. Install dependencies using your favorite package manager
+3. Prepare local files for development using `npm run dev:prepare`
+4. Follow this document to learn more about Nuxt modules
+
+## Use the Starter Template
+
+Learn how to perform basic tasks with the module starter.
+
+::tip{icon="i-lucide-video" to="https://vueschool.io/lessons/navigating-the-official-starter-template?friend=nuxt" target="_blank"}
+Watch Vue School video about Nuxt module starter template.
+::
+
+### Develop Your Module
+
+While your module source code lives inside the `src` directory, to develop a module you often need a Nuxt application to test it against. That's what the `playground` directory is for. It's a Nuxt application you can tinker with that is already configured to run with your module.
+
+You can interact with the playground like with any Nuxt application.
+
+- Launch its development server with `npm run dev`, it should reload itself as you make changes to your module in the `src` directory
+- Build it with `npm run dev:build`
+
+::note
+All other `nuxt` commands can be used against the `playground` directory (e.g. `nuxt playground`). Feel free to declare additional `dev:*` scripts within your `package.json` referencing them for convenience.
+::
+
+### Run Tests
+
+The module starter comes with a basic test suite:
+
+- A linter powered by [ESLint](https://eslint.org), run it with `npm run lint`
+- A test runner powered by [Vitest](https://vitest.dev), run it with `npm run test` or `npm run test:watch`
+
+::tip
+Feel free to augment this default test strategy to better suit your needs.
+::
+
+### Build Your Module
+
+Nuxt modules come with their own builder provided by [`@nuxt/module-builder`](https://github.com/nuxt/module-builder#readme). This builder doesn't require any configuration on your end, supports TypeScript, and makes sure your assets are properly bundled to be distributed to other Nuxt applications.
+
+You can build your module by running `npm run prepack`.
+
+::tip
+While building your module can be useful in some cases, most of the time you won't need to build it on your own: the `playground` takes care of it while developing, and the release script also has you covered when publishing.
+::
+
+### Publish to npm
+
+::important
+Before publishing your module to npm, makes sure you have an [npmjs.com](https://www.npmjs.com) account and that you're authenticated to it locally with `npm login`.
+::
+
+While you can publish your module by bumping its version and using the `npm publish` command, the module starter comes with a release script that helps you make sure you publish a working version of your module to npm and more.
+
+To use the release script, first, commit all your changes (we recommend you follow [Conventional Commits](https://www.conventionalcommits.org) to also take advantage of automatic version bump and changelog update), then run the release script with `npm run release`.
+
+When running the release script, the following will happen:
+
+- First, it will run your test suite by:
+ - Running the linter (`npm run lint`)
+ - Running unit, integration, and e2e tests (`npm run test`)
+ - Building the module (`npm run prepack`)
+- Then, if your test suite went well, it will proceed to publish your module by:
+ - Bumping your module version and generating a changelog according to your Conventional Commits
+ - Publishing the module to npm (for that purpose, the module will be built again to ensure its updated version number is taken into account in the published artifact)
+ - Pushing a git tag representing the newly published version to your git remote origin
+
+::tip
+As with other scripts, feel free to fine-tune the default `release` script in your `package.json` to better suit your needs.
+::
diff --git a/docs/3.guide/4.modules/2.module-anatomy.md b/docs/3.guide/4.modules/2.module-anatomy.md
new file mode 100644
index 000000000000..b64ecac0ca2d
--- /dev/null
+++ b/docs/3.guide/4.modules/2.module-anatomy.md
@@ -0,0 +1,138 @@
+---
+title: "Understand Module Structure"
+description: "Learn how Nuxt modules are structured and how to define them."
+---
+
+There are two types of Nuxt modules:
+
+- published modules are distributed on npm - you can see a list of some community modules on [the Nuxt website](/modules).
+- "local" modules exist within a Nuxt project, either [inlined in Nuxt config](/docs/4.x/api/nuxt-config#modules) or within [the `modules` directory](/docs/4.x/directory-structure/modules).
+
+In either case, they work in the same way.
+
+## Define Your Module
+
+::note
+When using the starter, your module definition is available at `src/module.ts`.
+::
+
+The module definition is the entry point of your module. It's what gets loaded by Nuxt when your module is referenced within a Nuxt configuration.
+
+At a low level, a Nuxt module definition is a simple, potentially asynchronous, function accepting inline user options and a `nuxt` object to interact with Nuxt.
+
+```ts
+export default function (inlineOptions, nuxt) {
+ // You can do whatever you like here..
+ console.log(inlineOptions.token) // `123`
+ console.log(nuxt.options.dev) // `true` or `false`
+ nuxt.hook('ready', (nuxt) => {
+ console.log('Nuxt is ready')
+ })
+}
+```
+
+You can get type hinting for this function using the higher-level `defineNuxtModule` helper provided by [Nuxt Kit](/docs/4.x/guide/going-further/kit).
+
+```ts
+import { defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule((options, nuxt) => {
+ nuxt.hook('pages:extend', (pages) => {
+ console.log(`Discovered ${pages.length} pages`)
+ })
+})
+```
+
+However, **we do not recommend** using this low-level function definition. Instead, to define a module, **we recommend** using the object-syntax with `meta` property to identify your module, especially when publishing to npm.
+
+This helper makes writing Nuxt modules more straightforward by implementing many common patterns needed by modules, guaranteeing future compatibility and improving the experience for both module authors and users.
+
+```ts
+import { defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ meta: {
+ // Usually the npm package name of your module
+ name: '@nuxtjs/example',
+ // The key in `nuxt.config` that holds your module options
+ configKey: 'sample',
+ // Compatibility constraints
+ compatibility: {
+ // Semver version of supported nuxt versions
+ nuxt: '>=3.0.0',
+ },
+ },
+ // Default configuration options for your module, can also be a function returning those
+ defaults: {},
+ // Shorthand sugar to register Nuxt hooks
+ hooks: {},
+ // Configuration for other modules - this does not ensure the module runs before
+ // your module, but it allows you to change the other module's configuration before it runs
+ moduleDependencies: {
+ 'some-module': {
+ // You can specify a version constraint for the module. If the user has a different
+ // version installed, Nuxt will throw an error on startup.
+ version: '>=2',
+ // By default moduleDependencies will be added to the list of modules to be installed
+ // by Nuxt unless `optional` is set.
+ optional: true,
+ // Any configuration that should override `nuxt.options`.
+ overrides: {},
+ // Any configuration that should be set. It will override module defaults but
+ // will not override any configuration set in `nuxt.options`.
+ defaults: {},
+ },
+ },
+ // The function holding your module logic, it can be asynchronous
+ setup (moduleOptions, nuxt) {
+ // ...
+ },
+})
+```
+
+`defineNuxtModule` returns a wrapper function with the lower level `(inlineOptions, nuxt)` module signature. This wrapper function applies defaults and other necessary steps before calling your `setup` function:
+
+- Support `defaults` and `meta.configKey` for automatically merging module options
+- Type hints and automated type inference
+- Ensure module gets installed only once using a unique key computed from `meta.name` or `meta.configKey`
+- Automatically register Nuxt hooks
+- Automatically check for compatibility issues based on module meta
+- Expose `getOptions` and `getMeta` for internal usage of Nuxt
+- Ensuring backward and upward compatibility as long as the module is using `defineNuxtModule` from the latest version of `@nuxt/kit`
+- Integration with module builder tooling
+
+## Add Runtime Code
+
+::note
+When using the starter, the runtime directory is `src/runtime/`.
+::
+
+Modules, like everything in a Nuxt configuration, aren't included in your application runtime. However, you might want your module to provide, or inject runtime code to the application it's installed on. That's what the runtime directory enables you to do.
+
+Inside the runtime directory, you can provide any kind of assets related to the Nuxt app:
+- Vue components
+- Composables
+- [Nuxt plugins](/docs/4.x/directory-structure/app/plugins)
+
+To the [server engine](/docs/4.x/guide/concepts/server-engine), Nitro:
+- API routes
+- Middlewares
+- Nitro plugins
+
+Or any other kind of asset you want to inject in users' Nuxt applications:
+- Stylesheets
+- 3D models
+- Images
+- etc.
+
+You'll then be able to inject all those assets inside the application from your [module definition](#define-your-module).
+
+::tip
+Learn more about asset injection in [the recipes section](/docs/4.x/guide/modules/recipes-basics).
+::
+
+::warning
+Published modules cannot leverage auto-imports for assets within their runtime directory. Instead, they have to import them explicitly from `#imports` or alike.
+:br :br
+Auto-imports are not enabled for files within `node_modules` (the location where a published module will eventually live) for performance reasons.
+::
diff --git a/docs/3.guide/4.modules/3.recipes-basics.md b/docs/3.guide/4.modules/3.recipes-basics.md
new file mode 100644
index 000000000000..4281b98f6c28
--- /dev/null
+++ b/docs/3.guide/4.modules/3.recipes-basics.md
@@ -0,0 +1,439 @@
+---
+title: "Add Plugins, Components & More"
+description: "Learn how to inject plugins, components, composables and server routes from your module."
+---
+
+Here are some common patterns used by module authors.
+
+## Modify Nuxt Configuration
+
+Nuxt configuration can be read and altered by modules. Here's an example of a module enabling an experimental feature.
+
+```js
+import { defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup (options, nuxt) {
+ // We create the `experimental` object if it doesn't exist yet
+ nuxt.options.experimental ||= {}
+ nuxt.options.experimental.componentIslands = true
+ },
+})
+```
+
+When you need to handle more complex configuration alterations, you should consider using [defu](https://github.com/unjs/defu).
+
+::tip{icon="i-lucide-video" to="https://vueschool.io/lessons/extending-and-altering-nuxt-configuration-and-options?friend=nuxt" target="_blank"}
+Watch Vue School video about altering Nuxt configuration.
+::
+
+## Expose Options to Runtime
+
+Because modules aren't part of the application runtime, their options aren't either. However, in many cases, you might need access to some of these module options within your runtime code. We recommend exposing the needed config using Nuxt's [`runtimeConfig`](/docs/4.x/api/nuxt-config#runtimeconfig).
+
+
+
+```js
+import { defineNuxtModule } from '@nuxt/kit'
+import { defu } from 'defu'
+
+export default defineNuxtModule({
+ setup (options, nuxt) {
+ nuxt.options.runtimeConfig.public.myModule = defu(nuxt.options.runtimeConfig.public.myModule, {
+ foo: options.foo,
+ })
+ },
+})
+```
+
+Note that we use [`defu`](https://github.com/unjs/defu) to extend the public runtime configuration the user provides instead of overwriting it.
+
+You can then access your module options in a plugin, component, the application like any other runtime configuration:
+
+```js
+import { useRuntimeConfig } from '@nuxt/kit'
+
+const options = useRuntimeConfig().public.myModule
+```
+
+::warning
+Be careful not to expose any sensitive module configuration on the public runtime config, such as private API keys, as they will end up in the public bundle.
+::
+
+:read-more{to="/docs/4.x/guide/going-further/runtime-config"}
+
+::tip{icon="i-lucide-video" to="https://vueschool.io/lessons/passing-and-exposing-module-options?friend=nuxt" target="_blank"}
+Watch Vue School video about passing and exposing Nuxt module options.
+::
+
+## Add Plugins
+
+Plugins are a common way for a module to add runtime logic. You can use the `addPlugin` utility to register them from your module.
+
+```js
+import { addPlugin, createResolver, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup (options, nuxt) {
+ // Create resolver to resolve relative paths
+ const resolver = createResolver(import.meta.url)
+
+ addPlugin(resolver.resolve('./runtime/plugin'))
+ },
+})
+```
+
+:read-more{to="/docs/4.x/guide/going-further/kit"}
+
+## Add Components
+
+If your module should provide Vue components, you can use the `addComponent` utility to add them as auto-imports for Nuxt to resolve.
+
+```ts twoslash
+import { addComponent, createResolver, defineNuxtModule, useRuntimeConfig } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup (options, nuxt) {
+ const resolver = createResolver(import.meta.url)
+
+ // From the runtime directory
+ addComponent({
+ name: 'MySuperComponent', // name of the component to be used in vue templates
+ export: 'MySuperComponent', // (optional) if the component is a named (rather than default) export
+ filePath: resolver.resolve('runtime/app/components/MySuperComponent.vue'),
+ })
+
+ // From a library
+ addComponent({
+ name: 'MyAwesomeComponent', // name of the component to be used in vue templates
+ export: 'MyAwesomeComponent', // (optional) if the component is a named (rather than default) export
+ filePath: '@vue/awesome-components',
+ })
+ },
+})
+```
+
+Alternatively, you can add an entire directory by using `addComponentsDir`.
+
+```ts
+import { addComponentsDir, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup (options, nuxt) {
+ const resolver = createResolver(import.meta.url)
+
+ addComponentsDir({
+ path: resolver.resolve('runtime/app/components'),
+ })
+ },
+})
+```
+
+::tip{icon="i-lucide-lightbulb"}
+It is highly recommended to prefix your exports to avoid conflicts with user code or other modules.
+
+:read-more{to="/docs/4.x/guide/modules/best-practices#prefix-your-exports"}
+::
+
+::note
+Note that all components, pages, composables and other files that would be normally placed in your `app/` folder need to be in `runtime/app/`. This will mean they can be type checked properly.
+::
+
+## Add Composables
+
+If your module should provide composables, you can use the `addImports` utility to add them as auto-imports for Nuxt to resolve.
+
+```ts
+import { addImports, createResolver, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup (options, nuxt) {
+ const resolver = createResolver(import.meta.url)
+
+ addImports({
+ name: 'useComposable', // name of the composable to be used
+ as: 'useMyComposable', // optional alias that will be available for the consuming apps
+ from: resolver.resolve('runtime/app/composables/useComposable'), // path of composable
+ })
+ },
+})
+```
+
+Multiple entries can be passed as an array:
+
+```ts
+import { addImports, createResolver, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup (options, nuxt) {
+ const resolver = createResolver(import.meta.url)
+
+ addImports([
+ { name: 'useFirstComposable', from: resolver.resolve('runtime/composables/useFirstComposable') },
+ { name: 'useSecondComposable', from: resolver.resolve('runtime/composables/useSecondComposable') },
+ ])
+ },
+})
+```
+
+Alternatively, you can add an entire directory by using `addImportsDir`.
+
+```ts
+import { addImportsDir, createResolver, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup (options, nuxt) {
+ const resolver = createResolver(import.meta.url)
+
+ addImportsDir(resolver.resolve('runtime/composables'))
+ },
+})
+```
+
+::tip{icon="i-lucide-lightbulb"}
+It is highly recommended to prefix your exports to avoid conflicts with user code or other modules.
+
+:read-more{to="/docs/4.x/guide/modules/best-practices#prefix-your-exports"}
+::
+
+::note
+Note that all components, pages, composables and other files that would be normally placed in your `app/` folder need to be in `runtime/app/`. This will mean they can be type checked properly.
+::
+
+### Add Keyed Functions
+
+Sometimes, you may need to maintain state consistency between the server and the client. Examples include Nuxt's built-in `useState` or `useAsyncData` composables. Nuxt provides a way to register such functions for automatic key injection.
+
+When a function is registered, Nuxt’s compiler automatically injects a unique key as an additional argument if the function is called with fewer than the specified number of arguments. This key remains stable between server-side rendering and client hydration.
+
+::tip
+The injected key is a hash derived from the file path and call location.
+::
+
+Use the `keyedComposables` option to register your function:
+
+```ts
+import { createResolver, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup (options, nuxt) {
+ const resolver = createResolver(import.meta.url)
+
+ nuxt.options.optimization.keyedComposables.push({
+ name: 'useMyState',
+ source: resolver.resolve('./runtime/composables/state'),
+ argumentLength: 2,
+ })
+ },
+})
+```
+
+The `keyedComposables` configuration accepts an array of objects with the following properties:
+
+| Property | Type | Description |
+|------------------|----------|----------------------------------------------------------------------------------------------------------------------------|
+| `name` | `string` | The function name. Use `'default'` for default exports (the callable name will be derived from the filename in camelCase). |
+| `source` | `string` | Resolved path to the file where the function is defined. Supports Nuxt aliases (`~`, `@`, etc.) |
+| `argumentLength` | `number` | Maximum number of arguments the function accepts. When called with fewer arguments, a unique key is injected. |
+
+For example, with `argumentLength: 2`:
+
+```ts
+useMyState() // useMyState('$HJiaryoL2y')
+useMyState('myKey') // useMyState('myKey', '$HJiaryoL2y')
+useMyState('a', 'b') // not transformed (already has 2 arguments)
+```
+
+::warning
+The key injection plugin verifies the exact resolved import source of each function call. It does not follow barrel exports. The function must be exported from the exact source file specified in the `source` property.
+
+```ts
+// ✅ Works - direct import matches the configured source
+import { useMyState } from 'my-module/runtime/composables/state'
+
+// ❌ Won't work - re-exported through a barrel file
+import { useMyState } from 'my-module/runtime/composables' // index.ts barrel
+```
+::
+
+::warning
+The function call must be statically analyzable. The compiler cannot inject keys for dynamic or indirect function calls.
+
+```ts
+import { useMyState } from 'my-module/runtime/composables/state'
+import * as composables from 'my-module/runtime/composables/state'
+
+// ✅ Works - direct function call
+useMyState()
+
+// ✅ Works - called on namespace import
+composables.useMyState()
+
+// ❌ Won't work - dynamic property access
+const name = 'useMyState'
+composables[name]()
+
+// ❌ Won't work - reassigned to a variable
+const myFn = useMyState
+myFn()
+
+// ❌ Won't work - passed as a callback
+someFunction(useMyState)
+
+// ❌ Won't work - destructured with renaming in a nested scope
+function setup () {
+ const { useMyState: localState } = composables
+ localState() // not transformed
+}
+
+// ...
+```
+::
+
+## Add Route Middleware
+
+```ts
+import { addRouteMiddleware, createResolver, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup (options, nuxt) {
+ const resolver = createResolver(import.meta.url)
+
+ // example to add a global route middleware
+ addRouteMiddleware({
+ global: true,
+ name: 'name-of-your-middleware',
+ path: resolver.resolve('./runtime/middleware/name-of-your-middleware'),
+ })
+ },
+})
+```
+
+## Add Server Routes
+
+```ts
+import { addServerHandler, createResolver, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup (options, nuxt) {
+ const resolver = createResolver(import.meta.url)
+
+ addServerHandler({
+ route: '/api/_my-module/hello',
+ handler: resolver.resolve('./runtime/server/api/hello/index.get'),
+ })
+ },
+})
+```
+
+You can also add a dynamic server route:
+
+```ts
+import { addServerHandler, createResolver, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup (options, nuxt) {
+ const resolver = createResolver(import.meta.url)
+
+ addServerHandler({
+ route: '/api/_my-module/hello/:name',
+ handler: resolver.resolve('./runtime/server/api/hello/[name].get'),
+ })
+
+ // Or using a catch all route
+ addServerHandler({
+ route: '/api/_my-module/files/**:path',
+ handler: resolver.resolve('./runtime/server/api/files/[...path].get'),
+ })
+ },
+})
+```
+
+::tip{icon="i-lucide-lightbulb"}
+It is highly recommended to prefix your server routes to avoid conflicts with user-defined routes. Common paths like `/api/auth`, `/api/login`, or `/api/user` may already be used by the application.
+
+:read-more{to="/docs/4.x/guide/modules/best-practices#prefix-your-exports"}
+::
+
+## Add Other Assets
+
+If your module should provide other kinds of assets, they can also be injected. Here's a simple example module injecting a stylesheet through Nuxt's `css` array.
+
+```js
+import { addPlugin, createResolver, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup (options, nuxt) {
+ const resolver = createResolver(import.meta.url)
+
+ nuxt.options.css.push(resolver.resolve('./runtime/style.css'))
+ },
+})
+```
+
+And a more advanced one, exposing a folder of assets through [Nitro](/docs/4.x/guide/concepts/server-engine)'s `publicAssets` option:
+
+```js
+import { createResolver, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup (options, nuxt) {
+ const resolver = createResolver(import.meta.url)
+
+ nuxt.hook('nitro:config', (nitroConfig) => {
+ nitroConfig.publicAssets ||= []
+ nitroConfig.publicAssets.push({
+ dir: resolver.resolve('./runtime/public'),
+ maxAge: 60 * 60 * 24 * 365, // 1 year
+ })
+ })
+ },
+})
+```
+
+## Use Other Modules
+
+If your module depends on other modules, you can specify them using the `moduleDependencies` option. This provides a more robust way to handle module dependencies with version constraints and configuration merging:
+
+```ts
+import { createResolver, defineNuxtModule } from '@nuxt/kit'
+
+const resolver = createResolver(import.meta.url)
+
+export default defineNuxtModule({
+ meta: {
+ name: 'my-module',
+ },
+ moduleDependencies: {
+ '@nuxtjs/tailwindcss': {
+ // You can specify a version constraint for the module
+ version: '>=6',
+ // Any configuration that should override `nuxt.options`
+ overrides: {
+ exposeConfig: true,
+ },
+ // Any configuration that should be set. It will override module defaults but
+ // will not override any configuration set in `nuxt.options`
+ defaults: {
+ config: {
+ darkMode: 'class',
+ content: {
+ files: [
+ resolver.resolve('./runtime/components/**/*.{vue,mjs,ts}'),
+ resolver.resolve('./runtime/*.{mjs,js,ts}'),
+ ],
+ },
+ },
+ },
+ },
+ },
+ setup (options, nuxt) {
+ // We can inject our CSS file which includes Tailwind's directives
+ nuxt.options.css.push(resolver.resolve('./runtime/assets/styles.css'))
+ },
+})
+```
+
+::callout{type="info"}
+The `moduleDependencies` option replaces the deprecated `installModule` function and ensures proper setup order and configuration merging.
+::
diff --git a/docs/3.guide/4.modules/4.recipes-advanced.md b/docs/3.guide/4.modules/4.recipes-advanced.md
new file mode 100644
index 000000000000..e57585d4dc1d
--- /dev/null
+++ b/docs/3.guide/4.modules/4.recipes-advanced.md
@@ -0,0 +1,243 @@
+---
+title: "Use Hooks & Extend Types"
+description: "Master lifecycle hooks, virtual files and TypeScript declarations in your modules."
+---
+
+Here are some advanced patterns for authoring modules, including hooks, templates, and type augmentation.
+
+## Use Lifecycle Hooks
+
+[Lifecycle hooks](/docs/4.x/guide/going-further/hooks) allow you to expand almost every aspect of Nuxt. Modules can hook to them programmatically or through the `hooks` map in their definition.
+
+```js
+import { addPlugin, createResolver, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ // Hook to the `app:error` hook through the `hooks` map
+ hooks: {
+ 'app:error': (err) => {
+ console.info(`This error happened: ${err}`)
+ },
+ },
+ setup (options, nuxt) {
+ // Programmatically hook to the `pages:extend` hook
+ nuxt.hook('pages:extend', (pages) => {
+ console.info(`Discovered ${pages.length} pages`)
+ })
+ },
+})
+```
+
+:read-more{to="/docs/4.x/api/advanced/hooks"}
+
+::tip{icon="i-lucide-video" to="https://vueschool.io/lessons/nuxt-lifecycle-hooks?friend=nuxt" target="_blank"}
+Watch Vue School video about using Nuxt lifecycle hooks in modules.
+::
+
+::note
+**Module cleanup**
+:br
+:br
+If your module opens, handles, or starts a watcher, you should close it when the Nuxt lifecycle is done. The `close` hook is available for this.
+
+```ts
+import { defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup (options, nuxt) {
+ nuxt.hook('close', async (nuxt) => {
+ // Your custom code here
+ })
+ },
+})
+```
+::
+
+### Create Custom Hooks
+
+Modules can also define and call their own hooks, which is a powerful pattern for making your module extensible.
+
+If you expect other modules to be able to subscribe to your module's hooks, you should call them in the `modules:done` hook. This ensures that all other modules have had a chance to be set up and register their listeners to your hook during their own `setup` function.
+
+```ts
+// my-module/module.ts
+import { defineNuxtModule } from '@nuxt/kit'
+
+export interface ModuleHooks {
+ 'my-module:custom-hook': (payload: { foo: string }) => void
+}
+
+export default defineNuxtModule({
+ setup (options, nuxt) {
+ // Call your hook in `modules:done`
+ nuxt.hook('modules:done', async () => {
+ const payload = { foo: 'bar' }
+ await nuxt.callHook('my-module:custom-hook', payload)
+ })
+ },
+})
+```
+
+## Add Virtual Files
+
+If you need to add a virtual file that can be imported into the user's app, you can use the `addTemplate` utility.
+
+```ts
+import { addTemplate, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup (options, nuxt) {
+ // The file is added to Nuxt's internal virtual file system and can be imported from '#build/my-module-feature.mjs'
+ addTemplate({
+ filename: 'my-module-feature.mjs',
+ getContents: () => 'export const myModuleFeature = () => "hello world !"',
+ })
+ },
+})
+```
+
+For the server, you should use the `addServerTemplate` utility instead.
+
+```ts
+import { addServerTemplate, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup (options, nuxt) {
+ // The file is added to Nitro's virtual file system and can be imported in the server code from 'my-server-module.mjs'
+ addServerTemplate({
+ filename: 'my-server-module.mjs',
+ getContents: () => 'export const myServerModule = () => "hello world !"',
+ })
+ },
+})
+```
+
+## Update Virtual Files
+
+If you need to update your templates/virtual files, you can leverage the `updateTemplates` utility like this:
+
+```ts
+nuxt.hook('builder:watch', (event, path) => {
+ if (path.includes('my-module-feature.config')) {
+ // This will reload the template that you registered
+ updateTemplates({ filter: t => t.filename === 'my-module-feature.mjs' })
+ }
+})
+```
+
+## Add Type Declarations
+
+You might also want to add a type declaration to the user's project (for example, to augment a Nuxt interface
+or provide a global type of your own). For this, Nuxt provides the `addTypeTemplate` utility that both
+writes a template to the disk and adds a reference to it in the generated `nuxt.d.ts` file.
+
+If your module should augment types handled by Nuxt, you can use `addTypeTemplate` to perform this operation:
+
+```js
+import { addTemplate, addTypeTemplate, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup (options, nuxt) {
+ addTypeTemplate({
+ filename: 'types/my-module.d.ts',
+ getContents: () => `// Generated by my-module
+ interface MyModuleNitroRules {
+ myModule?: { foo: 'bar' }
+ }
+ declare module 'nitro/types' {
+ interface NitroRouteRules extends MyModuleNitroRules {}
+ interface NitroRouteConfig extends MyModuleNitroRules {}
+ }
+ export {}`,
+ })
+ },
+})
+```
+
+If you need more granular control, you can use the `prepare:types` hook to register a callback that will inject your types.
+
+```ts
+const template = addTemplate({ /* template options */ })
+nuxt.hook('prepare:types', ({ references }) => {
+ references.push({ path: template.dst })
+})
+```
+
+## Extend TypeScript Config
+
+There are multiple ways to extend the TypeScript configuration of the user's project from your module.
+
+The simplest way is to modify the Nuxt configuration directly like this:
+
+
+```ts
+// extend tsconfig.app.json
+nuxt.options.typescript.tsConfig.include ??= []
+nuxt.options.typescript.tsConfig.include.push(resolve('./augments.d.ts'))
+
+// extend tsconfig.shared.json
+nuxt.options.typescript.sharedTsConfig.include ??= []
+nuxt.options.typescript.sharedTsConfig.include.push(resolve('./augments.d.ts'))
+
+// extend tsconfig.node.json
+nuxt.options.typescript.nodeTsConfig.include ??= []
+nuxt.options.typescript.nodeTsConfig.include.push(resolve('./augments.d.ts'))
+
+// extend tsconfig.server.json
+nuxt.options.nitro.typescript ??= {}
+nuxt.options.nitro.typescript.tsConfig ??= {}
+nuxt.options.nitro.typescript.tsConfig.include ??= []
+nuxt.options.nitro.typescript.tsConfig.include.push(resolve('./augments.d.ts'))
+```
+
+Alternatively, you can use the `prepare:types` and `nitro:prepare:types` hooks to extend the TypeScript references for specific type contexts, or modify the TypeScript configuration similar to the example above.
+
+```ts
+nuxt.hook('prepare:types', ({ references, sharedReferences, nodeReferences }) => {
+ // extend app context
+ references.push({ path: resolve('./augments.d.ts') })
+ // extend shared context
+ sharedReferences.push({ path: resolve('./augments.d.ts') })
+ // extend node context
+ nodeReferences.push({ path: resolve('./augments.d.ts') })
+})
+
+nuxt.hook('nitro:prepare:types', ({ references }) => {
+ // extend server context
+ references.push({ path: resolve('./augments.d.ts') })
+})
+```
+
+::note
+TypeScript references add files to the type context [without being affected by the `exclude` option in `tsconfig.json`](https://www.typescriptlang.org/tsconfig/#exclude).
+::
+
+## Augment Types
+
+Nuxt automatically includes your module's directories in the appropriate type contexts. To augment types from your module, all you need to do is place the type declaration file in the appropriate directory based on the augmented type context. Alternatively, you can [extend the TypeScript configuration](#extend-typescript-config) to augment from an arbitrary location.
+
+- `my-module/runtime/` - app type context (except for the `runtime/server` directory)
+- `my-module/runtime/server/` - server type context
+- `my-module/` - node type context (except for the `runtime/` and `runtime/server` directories)
+
+```bash [Directory Structure]
+-| my-module/ # node type context
+---| runtime/ # app type context
+------| augments.app.d.ts
+------| server/ # server type context
+---------| augments.server.d.ts
+---| module.ts
+---| augments.node.d.ts
+```
+
+### Known Limitations
+
+#### Type-Checking Server Routes in App Context
+
+Server routes are also type-checked using `tsconfig.app.json` in addition to `tsconfig.server.json`.
+
+This is required because Nuxt infers the return types of your server endpoints to provide response types in [`$fetch`](/docs/4.x/api/utils/dollarfetch) and [`useFetch`](/docs/4.x/api/composables/use-fetch).
+
+::warning
+This can cause issues when using **server-only types** in your route files. For example, if a module creates a server-only virtual file using [`addServerTemplate`](/docs/api/kit/templates#addservertemplate) and you declare types for it in `tsconfig.server.json`, those type declarations will only be available in the server context. When the app context type-checks your server routes, it won't recognize these server-only types and will report errors. To resolve this, you unfortunately need to declare such types in the app context as well.
+::
diff --git a/docs/3.guide/4.modules/5.testing.md b/docs/3.guide/4.modules/5.testing.md
new file mode 100644
index 000000000000..1bf9e5055ad2
--- /dev/null
+++ b/docs/3.guide/4.modules/5.testing.md
@@ -0,0 +1,76 @@
+---
+title: "Test Your Module"
+description: "Learn how to test your Nuxt module with unit, integration and E2E tests."
+---
+
+Testing helps ensure your module works as expected given various setups. Find in this section how to perform various kinds of tests against your module.
+
+## Write Unit Tests
+
+::tip
+We're still discussing and exploring how to ease unit and integration testing on Nuxt modules.
+:br :br
+[Check out this RFC to join the conversation](https://github.com/nuxt/nuxt/discussions/18399).
+::
+
+## Write E2E Tests
+
+[Nuxt Test Utils](/docs/4.x/getting-started/testing) is the go-to library to help you test your module in an end-to-end way. Here's the workflow to adopt with it:
+
+1. Create a Nuxt application to be used as a "fixture" inside `test/fixtures/*`
+2. Setup Nuxt with this fixture inside your test file
+3. Interact with the fixture using utilities from `@nuxt/test-utils` (e.g. fetching a page)
+4. Perform checks related to this fixture (e.g. "HTML contains ...")
+5. Repeat
+
+In practice, the fixture:
+
+```ts [test/fixtures/ssr/nuxt.config.ts]
+// 1. Create a Nuxt application to be used as a "fixture"
+import MyModule from '../../../src/module'
+
+export default defineNuxtConfig({
+ ssr: true,
+ modules: [
+ MyModule,
+ ],
+})
+```
+
+And its test:
+
+```ts [test/rendering.ts]
+import { describe, expect, it } from 'vitest'
+import { fileURLToPath } from 'node:url'
+import { $fetch, setup } from '@nuxt/test-utils/e2e'
+
+describe('ssr', async () => {
+ // 2. Setup Nuxt with this fixture inside your test file
+ await setup({
+ rootDir: fileURLToPath(new URL('./fixtures/ssr', import.meta.url)),
+ })
+
+ it('renders the index page', async () => {
+ // 3. Interact with the fixture using utilities from `@nuxt/test-utils`
+ const html = await $fetch('/')
+
+ // 4. Perform checks related to this fixture
+ expect(html).toContain('ssr
')
+ })
+})
+
+// 5. Repeat
+describe('csr', async () => { /* ... */ })
+```
+
+::tip
+An example of such a workflow is available on [the module starter](https://github.com/nuxt/starter/blob/module/test/basic.test.ts).
+::
+
+## Test Manually
+
+Having a playground Nuxt application to test your module when developing it is really useful. [The module starter integrates one for that purpose](/docs/4.x/guide/modules/getting-started#develop-your-module).
+
+You can test your module with other Nuxt applications (applications that are not part of your module repository) locally. To do so, you can use [`npm pack`](https://docs.npmjs.com/cli/commands/npm-pack/) command, or your package manager equivalent, to create a tarball from your module. Then in your test project, you can add your module to `package.json` packages as: `"my-module": "file:/path/to/tarball.tgz"`.
+
+After that, you should be able to reference `my-module` like in any regular project.
diff --git a/docs/3.guide/4.modules/6.best-practices.md b/docs/3.guide/4.modules/6.best-practices.md
new file mode 100644
index 000000000000..0cc743d5232b
--- /dev/null
+++ b/docs/3.guide/4.modules/6.best-practices.md
@@ -0,0 +1,104 @@
+---
+title: "Follow Best Practices"
+description: "Build performant and maintainable Nuxt modules with these guidelines."
+---
+
+With great power comes great responsibility. While modules are powerful, here are some best practices to keep in mind while authoring modules to keep applications performant and developer experience great.
+
+## Handle Async Setup
+
+As we've seen, Nuxt modules can be asynchronous. For example, you may want to develop a module that needs fetching some API or calling an async function.
+
+However, be careful with asynchronous behaviors as Nuxt will wait for your module to setup before going to the next module and starting the development server, build process, etc. Prefer deferring time-consuming logic to Nuxt hooks.
+
+::warning
+If your module takes more than **1 second** to setup, Nuxt will emit a warning about it.
+::
+
+## Prefix Your Exports
+
+Nuxt modules should provide an explicit prefix for any exposed configuration, plugin, API, composable, component, or server route to avoid conflicts with other modules, Nuxt internals, or user-defined code.
+
+Ideally, prefix them with your module's name. For example, if your module is called `nuxt-foo`:
+
+| Type | ❌ Avoid | ✅ Prefer |
+| --- | --- | --- |
+| Components | ``, `` | ``, `` |
+| Composables | `useData()`, `useModal()` | `useFooData()`, `useFooModal()` |
+| Server routes | `/api/track`, `/api/data` | `/api/_foo/track`, `/api/_foo/data` |
+
+### Server Routes
+
+This is particularly important for server routes, where common paths like `/api/auth`, `/api/login`, or `/api/user` are very likely already used by the application.
+
+Use a unique prefix based on your module name:
+- `/api/_foo/...` (using underscore prefix)
+- `/_foo/...` (for non-API routes)
+
+## Use Lifecycle Hooks
+
+When your module needs to perform one-time setup tasks (like generating configuration files, setting up databases, or installing dependencies), use lifecycle hooks instead of running the logic in your main `setup` function.
+
+```ts
+import { addServerHandler, defineNuxtModule } from 'nuxt/kit'
+import semver from 'semver'
+
+export default defineNuxtModule({
+ meta: {
+ name: 'my-database-module',
+ version: '1.0.0',
+ },
+ async onInstall (nuxt) {
+ // One-time setup: create database schema, generate config files, etc.
+ await generateDatabaseConfig(nuxt.options.rootDir)
+ },
+ async onUpgrade (nuxt, options, previousVersion) {
+ // Handle version-specific migrations
+ if (semver.lt(previousVersion, '1.0.0')) {
+ await migrateLegacyData()
+ }
+ },
+ setup (options, nuxt) {
+ // Regular setup logic that runs on every build
+ addServerHandler({ /* ... */ })
+ },
+})
+```
+
+This pattern prevents unnecessary work on every build and provides a better developer experience. See the [lifecycle hooks documentation](/docs/4.x/api/kit/modules#using-lifecycle-hooks-for-module-installation-and-upgrade) for more details.
+
+## Be TypeScript Friendly
+
+Nuxt has first-class TypeScript integration for the best developer experience.
+
+Exposing types and using TypeScript to develop modules benefits users even when not using TypeScript directly.
+
+## Use ESM Syntax
+
+Nuxt relies on native ESM. Please read [Native ES Modules](/docs/4.x/guide/concepts/esm) for more information.
+
+## Document Your Module
+
+Consider documenting module usage in the readme file:
+
+- Why use this module?
+- How to use this module?
+- What does this module do?
+
+Linking to the integration website and documentation is always a good idea.
+
+## Provide a Demo
+
+It's a good practice to make a minimal reproduction with your module and [StackBlitz](https://nuxt.new/s/v4) that you add to your module readme.
+
+This not only provides potential users of your module a quick and easy way to experiment with the module but also an easy way for them to build minimal reproductions they can send you when they encounter issues.
+
+## Stay Version Agnostic
+
+Nuxt, Nuxt Kit, and other new toolings are made to have both forward and backward compatibility in mind.
+
+Please use "X for Nuxt" instead of "X for Nuxt 3" to avoid fragmentation in the ecosystem and prefer using `meta.compatibility` to set Nuxt version constraints.
+
+## Follow Starter Conventions
+
+The module starter comes with a default set of tools and configurations (e.g. ESLint configuration). If you plan on open-sourcing your module, sticking with those defaults ensures your module shares a consistent coding style with other [community modules](/modules) out there, making it easier for others to contribute.
diff --git a/docs/3.guide/4.modules/7.ecosystem.md b/docs/3.guide/4.modules/7.ecosystem.md
new file mode 100644
index 000000000000..23d3d698a169
--- /dev/null
+++ b/docs/3.guide/4.modules/7.ecosystem.md
@@ -0,0 +1,32 @@
+---
+title: "Publish & Share Your Module"
+description: "Join the Nuxt module ecosystem and publish your module to npm."
+---
+
+The [Nuxt module ecosystem](/modules) represents more than 35 million monthly NPM downloads and provides extended functionalities and integrations with all sort of tools. You can be part of this ecosystem!
+
+::tip{icon="i-lucide-video" to="https://vueschool.io/lessons/exploring-nuxt-modules-ecosystem-and-module-types?friend=nuxt" target="_blank"}
+Watch Vue School video about Nuxt module types.
+::
+
+## Understand Module Types
+
+**Official modules** are modules prefixed (scoped) with `@nuxt/` (e.g. [`@nuxt/content`](https://content.nuxt.com)). They are made and maintained actively by the Nuxt team. Like with the framework, contributions from the community are more than welcome to help make them better!
+
+**Community modules** are modules prefixed (scoped) with `@nuxtjs/` (e.g. [`@nuxtjs/tailwindcss`](https://tailwindcss.nuxtjs.org)). They are proven modules made and maintained by community members. Again, contributions are welcome from anyone.
+
+**Third-party and other community modules** are modules (often) prefixed with `nuxt-`. Anyone can make them, using this prefix allows these modules to be discoverable on npm. This is the best starting point to draft and try an idea!
+
+**Private or personal modules** are modules made for your own use case or company. They don't need to follow any naming rules to work with Nuxt and are often seen scoped under an npm organization (e.g. `@my-company/nuxt-auth`)
+
+## List Your Module
+
+Any community modules are welcome to be listed on [the module list](/modules). To be listed, [open an issue in the nuxt/modules](https://github.com/nuxt/modules/issues/new?template=module_request.yml) repository. The Nuxt team can help you to apply best practices before listing.
+
+## Join nuxt-modules
+
+By moving your modules to [nuxt-modules](https://github.com/nuxt-modules), there is always someone else to help, and this way, we can join forces to make one perfect solution.
+
+If you have an already published and working module, and want to transfer it to `nuxt-modules`, [open an issue in nuxt/modules](https://github.com/nuxt/modules/issues/new).
+
+By joining `nuxt-modules` we can rename your community module under the `@nuxtjs/` scope and provide a subdomain (e.g. `my-module.nuxtjs.org`) for its documentation.
diff --git a/docs/3.guide/4.modules/index.md b/docs/3.guide/4.modules/index.md
new file mode 100644
index 000000000000..e7dac2c279d3
--- /dev/null
+++ b/docs/3.guide/4.modules/index.md
@@ -0,0 +1,36 @@
+---
+title: 'Module Author Guide'
+titleTemplate: '%s'
+description: 'Learn how to create a Nuxt module to integrate, enhance or extend any Nuxt applications.'
+navigation: false
+surround: false
+---
+
+Nuxt's [configuration](/docs/4.x/api/nuxt-config) and [hooks](/docs/4.x/guide/going-further/hooks) systems make it possible to customize every aspect of Nuxt and add any integration you might need (Vue plugins, CMS, server routes, components, logging, etc.).
+
+**Nuxt modules** are functions that sequentially run when starting Nuxt in development mode using `nuxt dev` or building a project for production with `nuxt build`.
+With modules, you can encapsulate, properly test, and share custom solutions as npm packages without adding unnecessary boilerplate to your project, or requiring changes to Nuxt itself.
+
+::card-group{class="sm:grid-cols-1"}
+ ::card{icon="i-lucide-rocket" title="Create Your First Module" to="/docs/4.x/guide/modules/getting-started"}
+ Learn how to create your first Nuxt module using the official starter template.
+ ::
+ ::card{icon="i-lucide-box" title="Understand Module Structure" to="/docs/4.x/guide/modules/module-anatomy"}
+ Learn how Nuxt modules are structured and how to define them.
+ ::
+ ::card{icon="i-lucide-code" title="Add Plugins, Components & More" to="/docs/4.x/guide/modules/recipes-basics"}
+ Learn how to inject plugins, components, composables and server routes from your module.
+ ::
+ ::card{icon="i-lucide-layers" title="Use Hooks & Extend Types" to="/docs/4.x/guide/modules/recipes-advanced"}
+ Master lifecycle hooks, virtual files and TypeScript declarations in your modules.
+ ::
+ ::card{icon="i-lucide-test-tube" title="Test Your Module" to="/docs/4.x/guide/modules/testing"}
+ Learn how to test your Nuxt module with unit, integration and E2E tests.
+ ::
+ ::card{icon="i-lucide-medal" title="Follow Best Practices" to="/docs/4.x/guide/modules/best-practices"}
+ Build performant and maintainable Nuxt modules with these guidelines.
+ ::
+ ::card{icon="i-lucide-globe" title="Publish & Share Your Module" to="/docs/4.x/guide/modules/ecosystem"}
+ Join the Nuxt module ecosystem and publish your module to npm.
+ ::
+::
diff --git a/docs/3.guide/5.recipes/.navigation.yml b/docs/3.guide/5.recipes/.navigation.yml
new file mode 100644
index 000000000000..6b48759515d8
--- /dev/null
+++ b/docs/3.guide/5.recipes/.navigation.yml
@@ -0,0 +1,3 @@
+title: Recipes
+titleTemplate: '%s · Recipes'
+icon: i-lucide-cooking-pot
diff --git a/docs/3.guide/5.recipes/1.custom-routing.md b/docs/3.guide/5.recipes/1.custom-routing.md
new file mode 100644
index 000000000000..839d23c5c7ac
--- /dev/null
+++ b/docs/3.guide/5.recipes/1.custom-routing.md
@@ -0,0 +1,181 @@
+---
+title: "Custom Routing"
+description: "In Nuxt, your routing is defined by the structure of your files inside the pages directory. However, since it uses vue-router under the hood, Nuxt offers you several ways to add custom routes in your project."
+---
+
+## Adding custom routes
+
+In Nuxt, your routing is defined by the structure of your files inside the [app/pages directory](/docs/4.x/directory-structure/app/pages). However, since it uses [vue-router](https://router.vuejs.org) under the hood, Nuxt offers you several ways to add custom routes in your project.
+
+### Router Config
+
+Using [router options](/docs/4.x/guide/recipes/custom-routing#router-options), you can optionally override or extend your routes using a function that accepts the scanned routes and returns customized routes.
+
+If it returns `null` or `undefined`, Nuxt will fall back to the default routes (useful to modify input array).
+
+```ts [router.options.ts]
+import type { RouterConfig } from '@nuxt/schema'
+
+export default {
+ // https://router.vuejs.org/api/interfaces/routeroptions#routes
+ routes: _routes => [
+ {
+ name: 'home',
+ path: '/',
+ component: () => import('~/pages/home.vue'),
+ },
+ ],
+} satisfies RouterConfig
+```
+
+::note
+Nuxt will not augment any new routes you return from the `routes` function with metadata defined in `definePageMeta` of the component you provide. If you want that to happen, you should use the `pages:extend` hook which is [called at build-time](/docs/4.x/api/advanced/hooks#nuxt-hooks-build-time).
+::
+
+### Pages Hook
+
+You can add, change or remove pages from the scanned routes with the `pages:extend` nuxt hook.
+
+For example, to prevent creating routes for any `.ts` files:
+
+```ts [nuxt.config.ts]
+import type { NuxtPage } from '@nuxt/schema'
+
+export default defineNuxtConfig({
+ hooks: {
+ 'pages:extend' (pages) {
+ // add a route
+ pages.push({
+ name: 'profile',
+ path: '/profile',
+ file: '~/extra-pages/profile.vue',
+ })
+
+ // remove routes
+ function removePagesMatching (pattern: RegExp, pages: NuxtPage[] = []) {
+ const pagesToRemove: NuxtPage[] = []
+ for (const page of pages) {
+ if (page.file && pattern.test(page.file)) {
+ pagesToRemove.push(page)
+ } else {
+ removePagesMatching(pattern, page.children)
+ }
+ }
+ for (const page of pagesToRemove) {
+ pages.splice(pages.indexOf(page), 1)
+ }
+ }
+ removePagesMatching(/\.ts$/, pages)
+ },
+ },
+})
+```
+
+### Nuxt Module
+
+If you plan to add a whole set of pages related with a specific functionality, you might want to use a [Nuxt module](/modules).
+
+The [Nuxt kit](/docs/4.x/guide/going-further/kit) provides a few ways [to add routes](/docs/4.x/api/kit/pages):
+- [`extendPages`](/docs/4.x/api/kit/pages#extendpages) (callback: pages => void)
+- [`extendRouteRules`](/docs/4.x/api/kit/pages#extendrouterules) (route: string, rule: NitroRouteConfig, options: ExtendRouteRulesOptions)
+
+## Router Options
+
+On top of customizing options for [`vue-router`](https://router.vuejs.org/api/interfaces/routeroptions), Nuxt offers [additional options](/docs/4.x/api/nuxt-config#router) to customize the router.
+
+### Using `router.options`
+
+This is the recommended way to specify [router options](/docs/4.x/api/nuxt-config#router).
+
+```ts [app/router.options.ts]
+import type { RouterConfig } from '@nuxt/schema'
+
+export default {
+} satisfies RouterConfig
+```
+
+It is possible to add more router options files by adding files within the `pages:routerOptions` hook. Later items in the array override earlier ones.
+
+::callout
+Adding a router options file in this hook will switch on page-based routing, unless `optional` is set, in which case it will only apply when page-based routing is already enabled.
+::
+
+```ts [nuxt.config.ts]
+import { createResolver } from '@nuxt/kit'
+
+export default defineNuxtConfig({
+ hooks: {
+ 'pages:routerOptions' ({ files }) {
+ const resolver = createResolver(import.meta.url)
+ // add a route
+ files.push({
+ path: resolver.resolve('./runtime/router-options'),
+ optional: true,
+ })
+ },
+ },
+})
+```
+
+### Using `nuxt.config`
+
+**Note:** Only JSON serializable [options](/docs/4.x/api/nuxt-config#router) are configurable:
+
+- `linkActiveClass`
+- `linkExactActiveClass`
+- `end`
+- `sensitive`
+- `strict`
+- `hashMode`
+- `scrollBehaviorType`
+
+```ts [nuxt.config]
+export default defineNuxtConfig({
+ router: {
+ options: {},
+ },
+})
+```
+
+### Hash Mode (SPA)
+
+You can enable hash history in SPA mode using the `hashMode` [config](/docs/4.x/api/nuxt-config#router). In this mode, router uses a hash character (#) before the actual URL that is internally passed. When enabled, the **URL is never sent to the server** and **SSR is not supported**.
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+ ssr: false,
+ router: {
+ options: {
+ hashMode: true,
+ },
+ },
+})
+```
+
+### Scroll Behavior for hash links
+
+You can optionally customize the scroll behavior for hash links. When you set the [config](/docs/4.x/api/nuxt-config#router) to be `smooth` and you load a page with a hash link (e.g. `https://example.com/blog/my-article#comments`), you will see that the browser smoothly scrolls to this anchor.
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+ router: {
+ options: {
+ scrollBehaviorType: 'smooth',
+ },
+ },
+})
+```
+
+#### Custom History (advanced)
+
+You can optionally override history mode using a function that accepts the base URL and returns the history mode. If it returns `null` or `undefined`, Nuxt will fallback to the default history.
+
+```ts [router.options.ts]
+import type { RouterConfig } from '@nuxt/schema'
+import { createMemoryHistory } from 'vue-router'
+
+export default {
+ // https://router.vuejs.org/api/interfaces/routeroptions
+ history: base => import.meta.client ? createMemoryHistory(base) : null, /* default */
+} satisfies RouterConfig
+```
diff --git a/docs/3.guide/5.recipes/2.vite-plugin.md b/docs/3.guide/5.recipes/2.vite-plugin.md
new file mode 100644
index 000000000000..33d5bbea5171
--- /dev/null
+++ b/docs/3.guide/5.recipes/2.vite-plugin.md
@@ -0,0 +1,110 @@
+---
+navigation.title: 'Vite Plugins'
+title: Using Vite Plugins in Nuxt
+description: Learn how to integrate Vite plugins into your Nuxt project.
+---
+
+While Nuxt modules offer extensive functionality, sometimes a specific Vite plugin might meet your needs more directly.
+
+First, we need to install the Vite plugin, for our example, we'll use `@rollup/plugin-yaml`:
+
+::code-group{sync="pm"}
+
+ ```bash [npm]
+ npm install @rollup/plugin-yaml
+ ```
+
+ ```bash [yarn]
+ yarn add @rollup/plugin-yaml
+ ```
+
+ ```bash [pnpm]
+ pnpm add @rollup/plugin-yaml
+ ```
+
+ ```bash [bun]
+ bun add @rollup/plugin-yaml
+ ```
+
+ ```bash [deno]
+ deno add npm:@rollup/plugin-yaml
+ ```
+
+::
+
+Next, we need to import and add it to our [`nuxt.config.ts`](/docs/4.x/directory-structure/nuxt-config) file:
+
+```ts [nuxt.config.ts]
+import yaml from '@rollup/plugin-yaml'
+
+export default defineNuxtConfig({
+ vite: {
+ plugins: [
+ yaml(),
+ ],
+ },
+})
+```
+
+Now we installed and configured our Vite plugin, we can start using YAML files directly in our project.
+
+For example, we can have a `config.yaml` that stores configuration data and import this data in our Nuxt components:
+
+::code-group
+
+```yaml [data/hello.yaml]
+greeting: "Hello, Nuxt with Vite!"
+```
+
+```vue [app/components/Hello.vue]
+
+
+
+ {{ config.greeting }}
+
+```
+
+::
+
+## Using Vite Plugins in Nuxt Modules
+
+If you're developing a Nuxt module and need to add Vite plugins, you should use the [`addVitePlugin`](/docs/4.x/api/kit/builder#addviteplugin) utility:
+
+```ts [modules/my-module.ts]
+import { addVitePlugin, defineNuxtModule } from '@nuxt/kit'
+import yaml from '@rollup/plugin-yaml'
+
+export default defineNuxtModule({
+ setup () {
+ addVitePlugin(yaml())
+ },
+})
+```
+
+For environment-specific plugins in Nuxt 5+, use the `applyToEnvironment()` method:
+
+```ts [modules/my-module.ts]
+import { addVitePlugin, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup () {
+ addVitePlugin(() => ({
+ name: 'my-client-plugin',
+ applyToEnvironment (environment) {
+ return environment.name === 'client'
+ },
+ // Plugin configuration
+ }))
+ },
+})
+```
+
+::important
+If you're writing code that needs to access resolved Vite configuration, you should use the `config` and `configResolved` hooks _within_ your Vite plugin, rather than using Nuxt's `vite:extend`, `vite:extendConfig` and `vite:configResolved`.
+::
+
+::read-more{to="/docs/4.x/api/kit/builder#addviteplugin"}
+Read more about `addVitePlugin` in the Nuxt Kit documentation.
+::
diff --git a/docs/3.guide/5.recipes/3.custom-usefetch.md b/docs/3.guide/5.recipes/3.custom-usefetch.md
new file mode 100644
index 000000000000..b5a2863a2ad6
--- /dev/null
+++ b/docs/3.guide/5.recipes/3.custom-usefetch.md
@@ -0,0 +1,94 @@
+---
+navigation.title: 'Custom useFetch'
+title: Custom useFetch in Nuxt
+description: How to create a custom fetcher for calling your external API in Nuxt.
+---
+
+When working with Nuxt, you might be making the frontend and fetching an external API, and you might want to set some default options for fetching from your API.
+
+The [`$fetch`](/docs/4.x/api/utils/dollarfetch) utility function (used by the [`useFetch`](/docs/4.x/api/composables/use-fetch) composable) is intentionally not globally configurable. This is important so that fetching behavior throughout your application remains consistent, and other integrations (like modules) can rely on the behavior of core utilities like `$fetch`.
+
+However, Nuxt provides a way to create a custom fetcher for your API (or multiple fetchers if you have multiple APIs to call).
+
+## Recipe: API Client with Auth
+
+Let's say you have an external API at `https://api.nuxt.com` that requires JWT authentication via [nuxt-auth-utils](https://github.com/atinux/nuxt-auth-utils), and you want to redirect to `/login` on `401` responses.
+
+```ts [app/composables/useAPI.ts]
+export const useAPI = createUseFetch({
+ baseURL: 'https://api.nuxt.com',
+ onRequest ({ options }) {
+ const { session } = useUserSession()
+ if (session.value?.token) {
+ options.headers.set('Authorization', `Bearer ${session.value.token}`)
+ }
+ },
+ async onResponseError ({ response }) {
+ if (response.status === 401) {
+ await navigateTo('/login')
+ }
+ },
+})
+```
+
+Now every call to `useAPI` automatically includes the auth header and handles 401 redirects:
+
+```vue [app/pages/dashboard.vue]
+
+```
+
+:read-more{to="/docs/4.x/api/composables/create-use-fetch"}
+
+## Recipe: Custom `$fetch` Instance
+
+If you need lower-level control, you can create a custom `$fetch` instance with a [Nuxt plugin](/docs/4.x/directory-structure/app/plugins) and either use it with `useAsyncData` directly or pass it to `createUseFetch`.
+
+::note
+`$fetch` is a configured instance of [ofetch](https://github.com/unjs/ofetch) which supports adding the base URL of your Nuxt server as well as direct function calls during SSR (avoiding HTTP roundtrips).
+::
+
+```ts [app/plugins/api.ts]
+export default defineNuxtPlugin((nuxtApp) => {
+ const { session } = useUserSession()
+
+ const api = $fetch.create({
+ baseURL: 'https://api.nuxt.com',
+ onRequest ({ request, options, error }) {
+ if (session.value?.token) {
+ options.headers.set('Authorization', `Bearer ${session.value?.token}`)
+ }
+ },
+ async onResponseError ({ response }) {
+ if (response.status === 401) {
+ await nuxtApp.runWithContext(() => navigateTo('/login'))
+ }
+ },
+ })
+
+ return {
+ provide: {
+ api,
+ },
+ }
+})
+```
+
+You can then use the custom `$fetch` instance directly:
+
+```vue [app/app.vue]
+
+```
+
+::callout
+Wrapping with [`useAsyncData`](/docs/4.x/api/composables/use-async-data) **avoids double data fetching when doing server-side rendering** (server & client on hydration).
+::
+
+:link-example{to="/docs/4.x/examples/advanced/use-custom-fetch-composable"}
+
+:video-accordion{title="Watch a video about custom $fetch and Repository Pattern in Nuxt" videoId="jXH8Tr-exhI"}
diff --git a/docs/3.guide/5.recipes/4.sessions-and-authentication.md b/docs/3.guide/5.recipes/4.sessions-and-authentication.md
new file mode 100644
index 000000000000..559fdf413fc3
--- /dev/null
+++ b/docs/3.guide/5.recipes/4.sessions-and-authentication.md
@@ -0,0 +1,217 @@
+---
+title: 'Sessions and Authentication'
+description: "Authentication is an extremely common requirement in web apps. This recipe will show you how to implement basic user registration and authentication in your Nuxt app."
+---
+
+## Introduction
+
+In this recipe we'll be setting up authentication in a full-stack Nuxt app using [Nuxt Auth Utils](https://github.com/Atinux/nuxt-auth-utils) which provides convenient utilities for managing client-side and server-side session data.
+
+The module uses secured & sealed cookies to store session data, so you don't need to setup a database to store session data.
+
+## Install nuxt-auth-utils
+
+Install the `nuxt-auth-utils` module using the `nuxt` CLI.
+
+```bash [Terminal]
+npx nuxt module add auth-utils
+```
+
+::callout
+This command will install `nuxt-auth-utils` as dependency and push it in the `modules` section of our `nuxt.config.ts`
+::
+
+## Cookie Encryption Key
+
+As `nuxt-auth-utils` uses sealed cookies to store session data, session cookies are encrypted using a secret key from the `NUXT_SESSION_PASSWORD` environment variable.
+
+::note
+If not set, this environment variable will be added to your `.env` automatically when running in development mode.
+::
+
+```ini [.env]
+NUXT_SESSION_PASSWORD=a-random-password-with-at-least-32-characters
+```
+
+::important
+You'll need to add this environment variable to your production environment before deploying.
+::
+
+## Login API Route
+
+For this recipe, we'll create a simple API route to sign-in a user based on static data.
+
+Let's create a `/api/login` API route that will accept a POST request with the email and password in the request body.
+
+```ts [server/api/login.post.ts]
+import { z } from 'zod'
+
+const bodySchema = z.object({
+ email: z.email(),
+ password: z.string().min(8),
+})
+
+export default defineEventHandler(async (event) => {
+ const { email, password } = await readValidatedBody(event, bodySchema.parse)
+
+ if (email === 'admin@admin.com' && password === 'iamtheadmin') {
+ // set the user session in the cookie
+ // this server util is auto-imported by the auth-utils module
+ await setUserSession(event, {
+ user: {
+ name: 'John Doe',
+ },
+ })
+ return {}
+ }
+ throw createError({
+ status: 401,
+ message: 'Bad credentials',
+ })
+})
+```
+
+::callout
+Make sure to install the `zod` dependency in your project (`npm i zod`).
+::
+
+::tip{to="https://github.com/atinux/nuxt-auth-utils#server-utils"}
+Read more about the `setUserSession` server helper exposed by `nuxt-auth-utils`.
+::
+
+## Login Page
+
+The module exposes a Vue composable to know if a user is authenticated in our application:
+
+```vue
+
+```
+
+Let's create a login page with a form to submit the login data to our `/api/login` route.
+
+```vue [app/pages/login.vue]
+
+
+
+
+
+```
+
+## Protect API Routes
+
+Protecting server routes is key to making sure your data is safe. Client-side middleware is helpful for the user, but without server-side protection your data can still be accessed. It is critical to protect any routes with sensitive data, we should return a 401 error if the user is not logged in on those.
+
+The `auth-utils` module provides the `requireUserSession` utility function to help make sure that users are logged in and have an active session.
+
+Let's create an example of a `/api/user/stats` route that only authenticated users can access.
+
+```ts [server/api/user/stats.get.ts]
+export default defineEventHandler(async (event) => {
+ // make sure the user is logged in
+ // This will throw a 401 error if the request doesn't come from a valid user session
+ const { user } = await requireUserSession(event)
+
+ // TODO: Fetch some stats based on the user
+
+ return {}
+})
+```
+
+## Protect App Routes
+
+Our data is safe with the server-side route in place, but without doing anything else, unauthenticated users would probably get some odd data when trying to access the `/users` page. We should create a [client-side middleware](https://nuxt.com/docs/4.x/directory-structure/app/middleware) to protect the route on the client side and redirect users to the login page.
+
+`nuxt-auth-utils` provides a convenient `useUserSession` composable which we'll use to check if the user is logged in, and redirect them if they are not.
+
+We'll create a middleware in the `/middleware` directory. Unlike on the server, client-side middleware is not automatically applied to all endpoints, and we'll need to specify where we want it applied.
+
+```typescript [app/middleware/authenticated.ts]
+export default defineNuxtRouteMiddleware(() => {
+ const { loggedIn } = useUserSession()
+
+ // redirect the user to the login screen if they're not authenticated
+ if (!loggedIn.value) {
+ return navigateTo('/login')
+ }
+})
+```
+
+## Home Page
+
+Now that we have our app middleware to protect our routes, we can use it on our home page that display our authenticated user information. If the user is not authenticated, they will be redirected to the login page.
+
+We'll use [`definePageMeta`](/docs/4.x/api/utils/define-page-meta) to apply the middleware to the route that we want to protect.
+
+```vue [app/pages/index.vue]
+
+
+
+
+
Welcome {{ user.name }}
+
+ Logout
+
+
+
+```
+
+We also added a logout button to clear the session and redirect the user to the login page.
+
+## Conclusion
+
+We've successfully set up a very basic user authentication and session management in our Nuxt app. We've also protected sensitive routes on the server and client side to ensure that only authenticated users can access them.
+
+As next steps, you can:
+- Add authentication using the [20+ supported OAuth providers](https://github.com/atinux/nuxt-auth-utils?tab=readme-ov-file#supported-oauth-providers)
+- Add a database to store users, see [Nitro SQL Database](https://nitro.build/guide/database) or [NuxtHub SQL Database](https://hub.nuxt.com/docs/database)
+- Let user signup with email & password using [password hashing](https://github.com/atinux/nuxt-auth-utils?tab=readme-ov-file#password-hashing)
+- Add support for [WebAuthn / Passkeys](https://github.com/atinux/nuxt-auth-utils?tab=readme-ov-file#webauthn-passkey)
+
+Checkout the open source [atidone repository](https://github.com/atinux/atidone) for a full example of a Nuxt app with OAuth authentication, database and CRUD operations.
diff --git a/docs/3.guide/6.going-further/.navigation.yml b/docs/3.guide/6.going-further/.navigation.yml
new file mode 100644
index 000000000000..ff10e39c55d4
--- /dev/null
+++ b/docs/3.guide/6.going-further/.navigation.yml
@@ -0,0 +1,3 @@
+title: Going Further
+titleTemplate: '%s · Nuxt Advanced'
+icon: i-lucide-star
diff --git a/docs/3.guide/6.going-further/1.events.md b/docs/3.guide/6.going-further/1.events.md
new file mode 100644
index 000000000000..b76564b034eb
--- /dev/null
+++ b/docs/3.guide/6.going-further/1.events.md
@@ -0,0 +1,62 @@
+---
+title: "Creating Custom Events"
+description: "Nuxt provides a powerful event system powered by hookable."
+navigation.title: "Custom Events"
+---
+
+Using events is a great way to decouple your application and allow for more flexible and modular communication between different parts of your code. Events can have multiple listeners that do not depend on each other. For example, you may wish to send an email to your user each time an order has shipped. Instead of coupling your order processing code to your email code, you can emit an event which a listener can receive and use to dispatch an email.
+
+The Nuxt event system is powered by [unjs/hookable](https://github.com/unjs/hookable), which is the same library that powers the Nuxt hooks system.
+
+## Creating Events and Listeners
+
+You can create your own custom events using the `hook` method:
+
+```ts
+const nuxtApp = useNuxtApp()
+
+nuxtApp.hook('app:user:registered', (payload) => {
+ console.log('A new user has registered!', payload)
+})
+```
+
+To emit an event and notify any listeners, use `callHook`:
+
+```ts
+const nuxtApp = useNuxtApp()
+
+await nuxtApp.callHook('app:user:registered', {
+ id: 1,
+ name: 'John Doe',
+})
+```
+
+You can also use the payload object to enable two-way communication between the emitter and listeners. Since the payload is passed by reference, a listener can modify it to send data back to the emitter.
+
+```ts
+const nuxtApp = useNuxtApp()
+
+nuxtApp.hook('app:user:registered', (payload) => {
+ payload.message = 'Welcome to our app!'
+})
+
+const payload = {
+ id: 1,
+ name: 'John Doe',
+}
+
+await nuxtApp.callHook('app:user:registered', {
+ id: 1,
+ name: 'John Doe',
+})
+
+// payload.message will be 'Welcome to our app!'
+```
+
+::tip
+You can inspect all events using the **Nuxt DevTools** Hooks panel.
+::
+
+::read-more{to="/docs/4.x/guide/going-further/hooks"}
+Learn more about Nuxt's built-in hooks and how to extend them
+::
diff --git a/docs/3.guide/6.going-further/1.experimental-features.md b/docs/3.guide/6.going-further/1.experimental-features.md
new file mode 100644
index 000000000000..c52fa8ec9389
--- /dev/null
+++ b/docs/3.guide/6.going-further/1.experimental-features.md
@@ -0,0 +1,995 @@
+---
+title: "Experimental Features"
+description: "Enable Nuxt experimental features to unlock new possibilities."
+---
+
+Nuxt includes experimental features that you can enable in your configuration file.
+
+Internally, Nuxt uses `@nuxt/schema` to define these experimental features. You can refer to the [API documentation](/docs/4.x/guide/going-further/experimental-features) or the [source code](https://github.com/nuxt/nuxt/blob/main/packages/schema/src/config/experimental.ts) for more information.
+
+::note
+Note that these features are experimental and could be removed or modified in the future.
+::
+
+## alwaysRunFetchOnKeyChange
+
+Whether to run `useFetch` when the key changes, even if it is set to `immediate: false` and it has not been triggered yet.
+
+`useFetch` and `useAsyncData` will always run when the key changes if `immediate: true` or if it has been already triggered.
+
+This flag is disabled by default, but you can enable this feature:
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ alwaysRunFetchOnKeyChange: true,
+ },
+})
+```
+
+## appManifest
+
+Use app manifests to respect route rules on client-side.
+
+This flag is enabled by default, but you can disable this feature:
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ appManifest: false,
+ },
+})
+```
+
+## asyncContext
+
+Enable native async context to be accessible for nested composables in Nuxt and in Nitro. This opens the possibility to use composables inside async composables and reduce the chance to get the `Nuxt instance is unavailable` error.
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ asyncContext: true,
+ },
+})
+```
+
+::read-more{icon="i-simple-icons-github" to="https://github.com/nuxt/nuxt/pull/20918" target="_blank"}
+See full explanation on the GitHub pull-request.
+::
+
+## asyncEntry
+
+Enables generation of an async entry point for the Vue bundle, aiding module federation support.
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ asyncEntry: true,
+ },
+})
+```
+
+## extractAsyncDataHandlers
+
+Extracts handler functions from `useAsyncData` and `useLazyAsyncData` calls into separate chunks for improved code splitting and caching efficiency.
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ extractAsyncDataHandlers: true,
+ },
+})
+```
+
+This feature transforms inline handler functions into dynamically imported chunks:
+
+```vue
+
+
+```
+
+```vue
+
+
+```
+
+The benefit of this transformation is that we can split out data fetching logic — while still allowing the code to be loaded if required.
+
+::important
+This feature is only recommended for **static builds** with payload extraction, and where data does not need to be re-fetched at runtime.
+::
+
+## emitRouteChunkError
+
+Emits `app:chunkError` hook when there is an error loading vite/webpack chunks. Default behavior is to perform a reload of the new route on navigation to a new route when a chunk fails to load.
+
+By default, Nuxt will also perform a reload of the new route when a chunk fails to load when navigating to a new route (`automatic`).
+
+Setting `automatic-immediate` will lead Nuxt to perform a reload of the current route right when a chunk fails to load (instead of waiting for navigation). This is useful for chunk errors that are not triggered by navigation, e.g., when your Nuxt app fails to load a [lazy component](/docs/4.x/directory-structure/app/components#dynamic-imports). A potential downside of this behavior is undesired reloads, e.g., when your app does not need the chunk that caused the error.
+
+You can disable automatic handling by setting this to `false`, or handle chunk errors manually by setting it to `manual`.
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ emitRouteChunkError: 'automatic', // or 'automatic-immediate', 'manual' or false
+ },
+})
+```
+
+## enforceModuleCompatibility
+
+Whether Nuxt should throw an error (and fail to load) if a Nuxt module is incompatible.
+
+This feature is disabled by default.
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ enforceModuleCompatibility: true,
+ },
+})
+```
+
+## restoreState
+
+Allows Nuxt app state to be restored from `sessionStorage` when reloading the page after a chunk error or manual [`reloadNuxtApp()`](/docs/4.x/api/utils/reload-nuxt-app) call.
+
+To avoid hydration errors, it will be applied only after the Vue app has been mounted, meaning there may be a flicker on initial load.
+
+::important
+Consider carefully before enabling this as it can cause unexpected behavior,
+and consider providing explicit keys to [`useState`](/docs/4.x/api/composables/use-state) as auto-generated keys may not match across builds.
+::
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ restoreState: true,
+ },
+})
+```
+
+## inlineRouteRules
+
+Define route rules at the page level using [`defineRouteRules`](/docs/4.x/api/utils/define-route-rules).
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ inlineRouteRules: true,
+ },
+})
+```
+
+Matching route rules will be created, based on the page's `path`.
+
+::read-more{to="/docs/4.x/api/utils/define-route-rules" icon="i-lucide-square-function"}
+Read more in `defineRouteRules` utility.
+::
+
+:read-more{to="/docs/4.x/guide/concepts/rendering#hybrid-rendering" icon="i-lucide-medal"}
+
+## noVueServer
+
+Disables Vue server renderer endpoint within Nitro.
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ noVueServer: true,
+ },
+})
+```
+
+## parseErrorData
+
+Whether to parse `error.data` when rendering a server error page.
+
+This flag is enabled by default, but you can disable this feature:
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ parseErrorData: false,
+ },
+})
+```
+
+## payloadExtraction
+
+Controls how payload data is delivered for prerendered and cached (ISR/SWR) pages.
+
+- `'client'` - Payload is inlined in HTML for the initial server render, and extracted to `_payload.json` files for client-side navigation. This avoids a separate network request on initial load while still enabling efficient client-side navigation.
+- `true` - Payload is extracted to a separate `_payload.json` file for both the initial server render and client-side navigation.
+- `false` - Payload extraction is disabled entirely. Payload is always inlined in HTML and no `_payload.json` files are generated.
+
+The default is `true`, or `'client'` when `compatibilityVersion: 5` is set.
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ // Inline payload in HTML, extract for client-side navigation only
+ payloadExtraction: 'client',
+ },
+})
+```
+
+Payload extraction also works for routes using ISR (Incremental Static Regeneration) or SWR (Stale-While-Revalidate) caching strategies. This allows CDNs to cache payload files alongside HTML, improving client-side navigation performance for cached routes.
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ payloadExtraction: 'client',
+ },
+ routeRules: {
+ // Payload files will be generated for these cached routes
+ '/products/**': { isr: 3600 },
+ '/blog/**': { swr: true },
+ },
+})
+```
+
+## clientNodePlaceholder
+
+Uses comment nodes (``) instead of `` elements as placeholders for client-only components during server-side rendering.
+
+When enabled, `.client.vue` components and `createClientOnly()` wrappers render an HTML comment on the server instead of an empty `
`. This fixes a Vue hydration issue where scoped styles may not be applied when the placeholder `
` and the actual component root share the same tag name.
+
+::warning
+Enabling this means attributes (`class`, `style`, etc.) passed to `.client.vue` components will not appear in the SSR HTML. If you need styled placeholders to prevent layout shift, use `
` with a `#fallback` slot instead.
+::
+
+This flag is enabled when `future.compatibilityVersion` is set to `5` or higher, but you can also enable it explicitly:
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ clientNodePlaceholder: true,
+ },
+})
+```
+
+## clientFallback
+
+Enables the experimental [``](/docs/4.x/api/components/nuxt-client-fallback) component for rendering content on the client if there's an error in SSR.
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ clientFallback: true,
+ },
+})
+```
+
+## crossOriginPrefetch
+
+Enables cross-origin prefetch using the Speculation Rules API.
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ crossOriginPrefetch: true,
+ },
+})
+```
+
+::read-more{icon="i-simple-icons-w3c" to="https://wicg.github.io/nav-speculation/prefetch.html" target="_blank"}
+Read more about the **Speculation Rules API**.
+::
+
+## viewTransition
+
+Enables View Transition API integration with client-side router.
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ viewTransition: true,
+ },
+})
+```
+
+You can also pass an object to configure [view transition types](/docs/4.x/getting-started/transitions#view-transition-types), which allow different CSS animations based on the type of navigation:
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ viewTransition: {
+ enabled: true,
+ types: ['slide'],
+ },
+ },
+})
+```
+
+:link-example{to="https://stackblitz.com/edit/nuxt-view-transitions?file=app.vue" target="_blank"}
+
+::read-more{icon="i-simple-icons-mdnwebdocs" to="https://developer.mozilla.org/en-US/docs/Web/API/View_Transition_API" target="_blank"}
+Read more about the **View Transition API**.
+::
+::read-more{icon="i-simple-icons-google" to="https://developer.chrome.com/blog/view-transitions-update-io24" target="_blank"}
+Read more about the **View Transition API**.
+::
+
+## writeEarlyHints
+
+Enables writing of early hints when using node server.
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ writeEarlyHints: true,
+ },
+})
+```
+
+## componentIslands
+
+Enables experimental component islands support with [``](/docs/4.x/api/components/nuxt-island) and `.island.vue` files.
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ componentIslands: true, // false or 'local+remote'
+ },
+})
+```
+
+:read-more{to="/docs/4.x/directory-structure/app/components#server-components"}
+
+::read-more{icon="i-simple-icons-github" to="https://github.com/nuxt/nuxt/issues/19772" target="_blank"}
+You can follow the server components roadmap on GitHub.
+::
+
+## localLayerAliases
+
+Resolve `~`, `~~`, `@` and `@@` aliases located within layers with respect to their layer source and root directories.
+
+This flag is enabled by default, but you can disable this feature:
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ localLayerAliases: false,
+ },
+})
+```
+
+## typedPages
+
+Enable the new experimental typed router.
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ typedPages: true,
+ },
+})
+```
+
+Out of the box, this will enable typed usage of [`navigateTo`](/docs/4.x/api/utils/navigate-to), [``](/docs/4.x/api/components/nuxt-link), [`router.push()`](/docs/4.x/api/composables/use-router) and more.
+
+You can even get typed params within a page by using `const route = useRoute('route-name')`.
+
+:video-accordion{title="Watch a video from Daniel Roe explaining type-safe routing in Nuxt" videoId="SXk-L19gTZk"}
+
+## watcher
+
+Set an alternative watcher that will be used as the watching service for Nuxt.
+
+Nuxt uses `chokidar-granular` by default, which will ignore top-level directories
+(like `node_modules` and `.git`) that are excluded from watching.
+
+You can set this instead to `parcel` to use `@parcel/watcher`, which may improve
+performance in large projects or on Windows platforms.
+
+You can also set this to `chokidar` to watch all files in your source directory.
+
+Set to `'builder'` to reuse the active builder's own file watcher (for example,
+Vite's `server.watcher`) instead of starting a second one. This reduces the
+number of file watchers active in dev mode and becomes the default when
+`future.compatibilityVersion` is `5`. If the active builder does not implement
+its own watcher (currently webpack and rspack), Nuxt logs a warning and falls
+back to its default selection.
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ watcher: 'chokidar-granular', // 'chokidar', 'parcel' or 'builder' are also options
+ },
+})
+```
+
+## sharedPrerenderData
+
+Nuxt automatically shares payload *data* between pages that are prerendered. This can result in a significant performance improvement when prerendering sites that use `useAsyncData` or `useFetch` and fetch the same data in different pages.
+
+You can disable this feature if needed.
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ sharedPrerenderData: false,
+ },
+})
+```
+
+:video-accordion{title="Watch a video from Alexander Lichter about the experimental sharedPrerenderData" videoId="1jUupYHVvrU"}
+
+It is particularly important when enabling this feature to make sure that any unique key of your data
+is always resolvable to the same data. For example, if you are using `useAsyncData` to fetch
+data related to a particular page, you should provide a key that uniquely matches that data. (`useFetch`
+should do this automatically for you.)
+
+```ts
+// This would be unsafe in a dynamic page (e.g. `[slug].vue`) because the route slug makes a difference
+// to the data fetched, but Nuxt can't know that because it's not reflected in the key.
+const route = useRoute()
+const { data } = await useAsyncData(async (_nuxtApp, { signal }) => {
+ return await $fetch(`/api/my-page/${route.params.slug}`, { signal })
+})
+// Instead, you should use a key that uniquely identifies the data fetched.
+const { data } = await useAsyncData(route.params.slug, async (_nuxtApp, { signal }) => {
+ return await $fetch(`/api/my-page/${route.params.slug}`, { signal })
+})
+```
+
+## clientNodeCompat
+
+With this feature, Nuxt will automatically polyfill Node.js imports in the client build using [`unenv`](https://github.com/unjs/unenv).
+
+::note
+To make globals like `Buffer` work in the browser, you need to manually inject them.
+
+```ts
+import { Buffer } from 'node:buffer'
+
+globalThis.Buffer ||= Buffer
+```
+::
+
+## scanPageMeta
+
+Nuxt exposing some route metadata defined in `definePageMeta` at build-time to modules (specifically `alias`, `name`, `path`, `redirect`, `props` and `middleware`).
+
+This only works with static or strings/arrays rather than variables or conditional assignment. See [original issue](https://github.com/nuxt/nuxt/issues/24770) for more information and context.
+
+By default page metadata is only scanned after all routes have been registered in `pages:extend`. Then another hook, `pages:resolved` will be called.
+
+You can disable this feature if it causes issues in your project.
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ scanPageMeta: false,
+ },
+})
+```
+
+## cookieStore
+
+Enables CookieStore support to listen for cookie updates (if supported by the browser) and refresh `useCookie` ref values.
+
+This flag is enabled by default, but you can disable this feature:
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ cookieStore: false,
+ },
+})
+```
+
+::read-more{icon="i-simple-icons-mdnwebdocs" to="https://developer.mozilla.org/en-US/docs/Web/API/CookieStore" target="_blank"}
+Read more about the **CookieStore**.
+::
+
+## buildCache
+
+Caches Nuxt build artifacts based on a hash of the configuration and source files.
+
+This only works for source files within `srcDir` and `serverDir` for the Vue/Nitro parts of your app.
+
+This flag is disabled by default, but you can enable it:
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ buildCache: true,
+ },
+})
+```
+
+When enabled, changes to the following files will trigger a full rebuild:
+
+```bash [Directory structure]
+.nuxtrc
+.npmrc
+package.json
+package-lock.json
+yarn.lock
+pnpm-lock.yaml
+tsconfig.json
+bun.lock
+bun.lockb
+```
+
+In addition, any changes to files within `srcDir` will trigger a rebuild of the Vue client/server bundle. Nitro will always be rebuilt (though work is in progress to allow Nitro to announce its cacheable artifacts and their hashes).
+
+::note
+A maximum of 10 cache tarballs are kept.
+::
+
+## checkOutdatedBuildInterval
+
+Set the time interval (in ms) to check for new builds. Disabled when `experimental.appManifest` is `false`.
+
+Set to `false` to disable.
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ checkOutdatedBuildInterval: 3600000, // 1 hour, or false to disable
+ },
+})
+```
+
+## extraPageMetaExtractionKeys
+
+The `definePageMeta()` macro is a useful way to collect build-time meta about pages. Nuxt itself provides a set list of supported keys which is used to power some of the internal features such as redirects, page aliases and custom paths.
+
+This option allows passing additional keys to extract from the page metadata when using `scanPageMeta`.
+
+```vue
+
+```
+
+```ts
+export default defineNuxtConfig({
+ experimental: {
+ extraPageMetaExtractionKeys: ['foo'],
+ },
+ hooks: {
+ 'pages:resolved' (ctx) {
+ // ✅ foo is available
+ },
+ },
+})
+```
+
+This allows modules to access additional metadata from the page metadata in the build context. If you are using this within a module, it's recommended also to [augment the `NuxtPage` types with your keys](/docs/4.x/directory-structure/app/pages#typing-custom-metadata).
+
+## navigationRepaint
+
+Wait for a single animation frame before navigation, which gives an opportunity for the browser to repaint, acknowledging user interaction.
+
+It can reduce INP when navigating on prerendered routes.
+
+This flag is enabled by default, but you can disable this feature:
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ navigationRepaint: false,
+ },
+})
+```
+
+## normalizeComponentNames
+
+Nuxt updates auto-generated Vue component names to match the full component name you would use to auto-import the component.
+
+If you encounter issues, you can disable this feature.
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ normalizeComponentNames: false,
+ },
+})
+```
+
+By default, if you haven't set it manually, Vue will assign a component name that matches
+the filename of the component.
+
+```bash [Directory structure]
+├─ components/
+├─── SomeFolder/
+├───── MyComponent.vue
+```
+
+In this case, the component name would be `MyComponent`, as far as Vue is concerned. If you wanted to use `` with it, or identify it in the Vue DevTools, you would need to use this component.
+
+But in order to auto-import it, you would need to use `SomeFolderMyComponent`.
+
+By setting `experimental.normalizeComponentNames`, these two values match, and Vue will generate a component name that matches the Nuxt pattern for component naming.
+
+## normalizePageNames
+
+Ensure that page component names match their route names. This sets the `__name` property on page components so that Vue's `` can correctly identify them by name.
+
+By default, Vue assigns component names based on the filename. For example, `pages/foo/index.vue` and `pages/bar/index.vue` would both have the component name `index`. This makes name-based `` filtering unreliable because multiple pages share the same name.
+
+With `normalizePageNames` enabled, page components are named after their route (e.g. `foo` and `bar`), so you can use `` with `include`/`exclude` without manually adding `defineOptions({ name: '...' })` to each page.
+
+This flag is enabled when `future.compatibilityVersion` is set to `5` or higher, but you can disable this feature:
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ normalizePageNames: false,
+ },
+})
+```
+
+```vue [app.vue]
+
+
+```
+
+## spaLoadingTemplateLocation
+
+When rendering a client-only page (with `ssr: false`), we optionally render a loading screen (from `~/spa-loading-template.html`).
+
+It can be set to `within`, which will render it like this:
+
+```html
+
+
+
+```
+
+Alternatively, you can render the template alongside the Nuxt app root by setting it to `body`:
+
+```html
+
+
+```
+
+This avoids a white flash when hydrating a client-only page.
+
+## browserDevtoolsTiming
+
+Enables performance markers for Nuxt hooks in browser devtools. This adds performance markers that you can track in the Performance tab of Chromium-based browsers, which is useful for debugging and optimizing performance.
+
+This is enabled by default in development mode. If you need to disable this feature, it is possible to do so:
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ browserDevtoolsTiming: false,
+ },
+})
+```
+
+::read-more{icon="i-simple-icons-github" color="gray" to="https://github.com/nuxt/nuxt/pull/29922" target="_blank"}
+See PR #29922 for implementation details.
+::
+
+::read-more{icon="i-simple-icons-googlechrome" color="gray" to="https://developer.chrome.com/docs/devtools/performance/extension#tracks" target="_blank"}
+Learn more about Chrome DevTools Performance API.
+::
+
+## debugModuleMutation
+
+Records mutations to `nuxt.options` in module context, helping to debug configuration changes made by modules during the Nuxt initialization phase.
+
+This is enabled by default when `debug` mode is enabled. If you need to disable this feature, it is possible to do so:
+
+To enable it explicitly:
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ debugModuleMutation: true,
+ },
+})
+```
+
+::read-more{icon="i-simple-icons-github" color="gray" to="https://github.com/nuxt/nuxt/pull/30555" target="_blank"}
+See PR #30555 for implementation details.
+::
+
+## lazyHydration
+
+This enables hydration strategies for `` components, which improves performance by deferring hydration of components until they're needed.
+
+Lazy hydration is enabled by default, but you can disable this feature:
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ lazyHydration: false,
+ },
+})
+```
+
+::read-more{icon="i-simple-icons-github" color="gray" to="/docs/4.x/directory-structure/app/components#delayed-or-lazy-hydration"}
+Read more about lazy hydration.
+::
+
+## templateImportResolution
+
+Disable resolving imports into Nuxt templates from the path of the module that added the template.
+
+By default, Nuxt attempts to resolve imports in templates relative to the module that added them. Setting this to `false` disables this behavior, which may be useful if you're experiencing resolution conflicts in certain environments.
+
+This flag is enabled by default, but you can disable this feature:
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ templateImportResolution: false,
+ },
+})
+```
+
+::read-more{icon="i-simple-icons-github" color="gray" to="https://github.com/nuxt/nuxt/pull/31175" target="_blank"}
+See PR #31175 for implementation details.
+::
+
+## templateRouteInjection
+
+By default the route object returned by the auto-imported `useRoute()` composable is kept in sync with the current page in view in ``. This is not true for `vue-router`'s exported `useRoute` or for the default `$route` object available in your Vue templates.
+
+By enabling this option a mixin will be injected to keep the `$route` template object in sync with Nuxt's managed `useRoute()`.
+
+This flag is enabled by default, but you can disable this feature:
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ templateRouteInjection: false,
+ },
+})
+```
+
+## decorators
+
+This option enables decorator syntax across your entire Nuxt/Nitro app.
+
+When using the Vite builder (default), decorators are lowered via [Babel](https://babeljs.io/) using [`@babel/plugin-proposal-decorators`](https://babeljs.io/docs/babel-plugin-proposal-decorators). When using the webpack or rspack builders, decorators are lowered via [esbuild](https://github.com/evanw/esbuild/releases/tag/v0.21.3).
+
+For a long time, TypeScript has had support for decorators via `compilerOptions.experimentalDecorators`. This implementation predated the TC39 standardization process. Now, decorators are a [Stage 3 Proposal](https://github.com/tc39/proposal-decorators), and supported without special configuration in TS 5.0+ (see https://github.com/microsoft/TypeScript/pull/52582 and https://devblogs.microsoft.com/typescript/announcing-typescript-5-0-beta/#decorators).
+
+Enabling `experimental.decorators` enables support for the TC39 proposal, **NOT** for TypeScript's previous `compilerOptions.experimentalDecorators` implementation.
+
+::warning
+Note that there may be changes before this finally lands in the JS standard.
+::
+
+### Usage
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ decorators: true,
+ },
+})
+```
+
+When using the Vite builder or the Nitro server build, you will need to install additional Babel packages as dev dependencies:
+
+::code-group
+```bash [npm]
+npm install -D @babel/plugin-proposal-decorators @babel/plugin-syntax-jsx
+```
+```bash [pnpm]
+pnpm add -D @babel/plugin-proposal-decorators @babel/plugin-syntax-jsx
+```
+```bash [yarn]
+yarn add -D @babel/plugin-proposal-decorators @babel/plugin-syntax-jsx
+```
+::
+
+::tip
+Nuxt will prompt you to install these automatically if they are not already present.
+::
+
+```ts [app/app.vue]
+function something (_method: () => unknown) {
+ return () => 'decorated'
+}
+
+class SomeClass {
+ @something
+ public someMethod () {
+ return 'initial'
+ }
+}
+
+const value = new SomeClass().someMethod()
+// this will return 'decorated'
+```
+
+## defaults
+
+This allows specifying the default options for core Nuxt components and composables.
+
+These options will likely be moved elsewhere in the future, such as into `app.config` or into the `app/` directory.
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ defaults: {
+ nuxtLink: {
+ componentName: 'NuxtLink',
+ prefetch: true,
+ prefetchOn: {
+ visibility: true,
+ },
+ },
+ useAsyncData: {
+ deep: true,
+ },
+ useState: {
+ resetOnClear: true,
+ },
+ },
+ },
+})
+```
+
+The `useState.resetOnClear` option controls whether [`clearNuxtState`](/docs/4.x/api/utils/clear-nuxt-state) resets state to its initial value (provided by the `init` function of [`useState`](/docs/4.x/api/composables/use-state)) instead of setting it to `undefined`. This defaults to `true` with `compatibilityVersion: 5`.
+
+## purgeCachedData
+
+Whether to clean up Nuxt static and asyncData caches on route navigation.
+
+Nuxt will automatically purge cached data from `useAsyncData` and `nuxtApp.static.data`. This helps prevent memory leaks and ensures fresh data is loaded when needed, but it is possible to disable it.
+
+This flag is enabled by default, but you can disable this feature:
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ purgeCachedData: false,
+ },
+})
+```
+
+::read-more{icon="i-simple-icons-github" color="gray" to="https://github.com/nuxt/nuxt/pull/31379" target="_blank"}
+See PR #31379 for implementation details.
+::
+
+## prefetchPreloadTags
+
+When a `` is prefetched and the destination route has [payload extraction](#payloadextraction) enabled (the default for prerendered and cached routes), forward any ``) into the current document.
+
+The forwarded links are downgraded from `rel="preload"` to `rel="prefetch"` so they don't compete with the current page's critical resources. Only user-defined head tags are forwarded; build-time JS/CSS chunk preloads are already handled separately by the prefetch pipeline.
+
+This flag is off by default because, combined with `prefetchOn: 'visibility'` (the `` default), it could trigger a lot of cross-route prefetches at once. Enable it once you are confident the destination preloads are worth forwarding for the links your users typically encounter.
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ prefetchPreloadTags: true,
+ },
+})
+```
+
+::read-more{icon="i-simple-icons-github" color="gray" to="https://github.com/nuxt/nuxt/issues/34953" target="_blank"}
+See issue #34953 for motivation.
+::
+
+## granularCachedData
+
+Whether to call and use the result from `getCachedData` when refreshing data for `useAsyncData` and `useFetch` (whether by `watch`, `refreshNuxtData()`, or a manual `refresh()` call.
+
+This flag is enabled by default, but you can disable this feature:
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ granularCachedData: false,
+ },
+})
+```
+
+::read-more{icon="i-simple-icons-github" color="gray" to="https://github.com/nuxt/nuxt/pull/31373" target="_blank"}
+See PR #31373 for implementation details.
+::
+
+## headNext
+
+Use head optimisations:
+
+- Add the capo.js head plugin in order to render tags in of the head in a more performant way.
+- Uses the hash hydration plugin to reduce initial hydration
+
+This flag is enabled by default, but you can disable this feature:
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ headNext: false,
+ },
+})
+```
+
+## pendingWhenIdle
+
+For `useAsyncData` and `useFetch`, whether `pending` should be `true` when data has not yet started to be fetched.
+
+This flag is disabled by default, but you can enable this feature:
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ pendingWhenIdle: true,
+ },
+})
+```
+
+## entryImportMap
+
+By default, Nuxt improves chunk stability by using an import map to resolve the entry chunk of the bundle.
+
+This injects an import map at the top of your `` tag:
+
+```html
+
+```
+
+Within the script chunks emitted by Vite, imports will be from `#entry`. This means that changes to the entry will not invalidate chunks which are otherwise unchanged.
+
+::note
+Nuxt smartly disables this feature if you have configured `vite.build.target` to include a browser that doesn't support import maps, or if you have configured `vite.build.rolldownOptions.output.entryFileNames` to a value that does not include `[hash]`.
+::
+
+If you need to disable this feature you can do so:
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ entryImportMap: false,
+ },
+ // or, better, simply tell vite your desired target
+ // which nuxt will respect
+ vite: {
+ build: {
+ target: 'safari13',
+ },
+ },
+})
+```
+
+## typescriptPlugin
+
+Enable enhanced TypeScript developer experience with the `@dxup/nuxt` module.
+
+This experimental plugin provides improved TypeScript integration and development tooling for better DX when working with TypeScript in Nuxt applications.
+
+This flag is disabled by default, but you can enable this feature:
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ typescriptPlugin: true,
+ },
+})
+```
+
+::important
+To use this feature, you need to:
+- Have `typescript` installed as a dependency
+- Configure VS Code to use your workspace TypeScript version (see [VS Code documentation](https://code.visualstudio.com/docs/typescript/typescript-compiling#_using-the-workspace-version-of-typescript))
+::
+
+::read-more{icon="i-simple-icons-github" to="https://github.com/KazariEX/dxup" target="_blank"}
+Learn more about **@dxup/nuxt**.
+::
diff --git a/docs/3.guide/6.going-further/1.features.md b/docs/3.guide/6.going-further/1.features.md
new file mode 100644
index 000000000000..9c6a7f3a03f2
--- /dev/null
+++ b/docs/3.guide/6.going-further/1.features.md
@@ -0,0 +1,108 @@
+---
+title: "Features"
+description: "Enable or disable optional Nuxt features to unlock new possibilities."
+---
+
+Some features of Nuxt are available on an opt-in basis, or can be disabled based on your needs.
+
+## `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
+ },
+})
+```
+
+### noScripts
+
+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, // or 'production' | 'all' | false
+ },
+})
+```
+
+## `future`
+
+There is also a `future` namespace for early opting-in to new features that will become default in a future (possibly major) version of the framework.
+
+### compatibilityVersion
+
+This enables early access to Nuxt features or flags.
+
+Setting `compatibilityVersion` to `5` changes defaults throughout your Nuxt configuration to opt in to Nuxt v5 behaviour, including enabling the [Vite Environment API](/docs/4.x/guide/going-further/experimental-features#viteenvironmentapi).
+
+```ts
+export default defineNuxtConfig({
+ future: {
+ compatibilityVersion: 5,
+ },
+})
+```
+
+::read-more{to="/docs/4.x/getting-started/upgrade#testing-nuxt-5"}
+Learn more about testing Nuxt 5.
+::
+
+### 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#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: false,
+ },
+})
+```
diff --git a/docs/3.guide/6.going-further/1.internals.md b/docs/3.guide/6.going-further/1.internals.md
new file mode 100644
index 000000000000..27b3ba4d8c71
--- /dev/null
+++ b/docs/3.guide/6.going-further/1.internals.md
@@ -0,0 +1,82 @@
+---
+title: "How Nuxt Works?"
+description: "Nuxt is a minimal but highly customizable framework to build web applications."
+navigation: false
+---
+
+This guide helps you better understand Nuxt internals to develop new solutions and module integrations on top of Nuxt.
+
+## The Nuxt Interface
+
+When you start Nuxt in development mode with [`nuxt dev`](/docs/4.x/api/commands/dev) or building a production application with [`nuxt build`](/docs/4.x/api/commands/build),
+a common context will be created, referred to as `nuxt` internally. It holds normalized options merged with `nuxt.config` file,
+some internal state, and a powerful [hooking system](/docs/4.x/api/advanced/hooks) powered by [unjs/hookable](https://github.com/unjs/hookable)
+allowing different components to communicate with each other. You can think of it as **Builder Core**.
+
+This context is globally available to be used with [Nuxt Kit](/docs/4.x/guide/going-further/kit) composables.
+Therefore only one instance of Nuxt is allowed to run per process.
+
+To extend the Nuxt interface and hook into different stages of the build process, we can use [Nuxt modules](/docs/4.x/guide/modules).
+
+For more details, check out [the source code](https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/core/nuxt.ts).
+
+## The NuxtApp Interface
+
+When rendering a page in the browser or on the server, a shared context will be created, referred to as `nuxtApp`.
+This context keeps vue instance, runtime hooks, and internal states like ssrContext and payload for hydration.
+You can think of it as **Runtime Core**.
+
+This context can be accessed using [`useNuxtApp()`](/docs/4.x/api/composables/use-nuxt-app) composable within Nuxt plugins and `
+
+
+
+
Check developer console!
+
+```
+
+::caution
+**Security note:** Be careful not to expose runtime config keys to the client-side by either rendering them or passing them to `useState`.
+::
+
+### Plugins
+
+If you want to use the runtime config within any (custom) plugin, you can use [`useRuntimeConfig()`](/docs/4.x/api/composables/use-runtime-config) inside of your `defineNuxtPlugin` function.
+
+```ts [app/plugins/config.ts]
+export default defineNuxtPlugin((nuxtApp) => {
+ const config = useRuntimeConfig()
+
+ console.log('API base URL:', config.public.apiBase)
+})
+```
+
+### Server Routes
+
+You can access runtime config within the server routes as well using `useRuntimeConfig`.
+
+```ts [server/api/test.ts]
+export default defineEventHandler(async (event) => {
+ const { apiSecret } = useRuntimeConfig()
+ const result = await $fetch('https://my.api.com/test', {
+ headers: {
+ Authorization: `Bearer ${apiSecret}`,
+ },
+ })
+ return result
+})
+```
+
+::note
+Giving the `event` as argument to `useRuntimeConfig` is optional, but it is recommended to pass it to get the runtime config overwritten by [environment variables](/docs/4.x/guide/going-further/runtime-config#environment-variables) at runtime for server routes.
+::
+
+## Typing Runtime Config
+
+Nuxt tries to automatically generate a typescript interface from provided runtime config using [unjs/untyped](https://github.com/unjs/untyped).
+
+But it is also possible to type your runtime config manually:
+
+```ts [index.d.ts]
+declare module 'nuxt/schema' {
+ interface RuntimeConfig {
+ apiSecret: string
+ }
+ interface PublicRuntimeConfig {
+ apiBase: string
+ }
+}
+// It is always important to ensure you import/export something when augmenting a type
+export {}
+```
+
+::note
+`nuxt/schema` is provided as a convenience for end-users to access the version of the schema used by Nuxt in their project. Module authors should instead augment `@nuxt/schema`.
+::
diff --git a/docs/3.guide/6.going-further/11.nightly-release-channel.md b/docs/3.guide/6.going-further/11.nightly-release-channel.md
new file mode 100644
index 000000000000..d9ccc494ca82
--- /dev/null
+++ b/docs/3.guide/6.going-further/11.nightly-release-channel.md
@@ -0,0 +1,62 @@
+---
+title: "Nightly Release Channel"
+description: "The nightly release channel allows using Nuxt built directly from the latest commits to the repository."
+---
+
+Nuxt lands commits, improvements, and bug fixes every day. You can opt in to test them earlier before the next release.
+
+After a commit is merged into the `main` branch of [nuxt/nuxt](https://github.com/nuxt/nuxt) and **passes all tests**, we trigger an automated npm release, using GitHub Actions.
+
+You can use these 'nightly' releases to beta test new features and changes.
+
+The build and publishing method and quality of these 'nightly' releases are the same as stable ones. The only difference is that you should often check the GitHub repository for updates. There is a slight chance of regressions not being caught during the review process and by the automated tests. Therefore, we internally use this channel to double-check everything before each release.
+
+::note
+Features that are only available on the nightly release channel are marked with an alert in the documentation.
+::
+
+::warning
+The `latest` nightly release channel is currently tracking the Nuxt v4 branch, meaning that it is particularly likely to have breaking changes right now — be careful! You can opt in to the 3.x branch nightly releases with `"nuxt": "npm:nuxt-nightly@3x"`.
+::
+
+## Opting In
+
+Update `nuxt` dependency inside `package.json`:
+
+```diff [package.json]
+{
+ "devDependencies": {
+-- "nuxt": "^4.0.0"
+++ "nuxt": "npm:nuxt-nightly@latest"
+ }
+}
+```
+
+Remove lockfile (`package-lock.json`, `yarn.lock`, `pnpm-lock.yaml`, `bun.lock` or `bun.lockb`) and reinstall dependencies.
+
+## Opting Out
+
+Update `nuxt` dependency inside `package.json`:
+
+```diff [package.json]
+{
+ "devDependencies": {
+-- "nuxt": "npm:nuxt-nightly@latest"
+++ "nuxt": "^4.0.0"
+ }
+}
+```
+
+Remove lockfile (`package-lock.json`, `yarn.lock`, `pnpm-lock.yaml`, `bun.lock` or `bun.lockb`) and reinstall dependencies.
+
+## Using Nightly `@nuxt/cli`
+
+To try the latest version of [nuxt/cli](https://github.com/nuxt/cli):
+
+```bash [Terminal]
+npx @nuxt/cli-nightly@latest [command]
+```
+
+::read-more{to="/docs/4.x/api/commands"}
+Read more about the available commands.
+::
diff --git a/docs/3.guide/6.going-further/2.hooks.md b/docs/3.guide/6.going-further/2.hooks.md
new file mode 100644
index 000000000000..86518b970dd3
--- /dev/null
+++ b/docs/3.guide/6.going-further/2.hooks.md
@@ -0,0 +1,100 @@
+---
+title: "Lifecycle Hooks"
+description: "Nuxt provides a powerful hooking system to expand almost every aspect using hooks."
+---
+
+::tip
+The hooking system is powered by [unjs/hookable](https://github.com/unjs/hookable).
+::
+
+## Nuxt Hooks (Build Time)
+
+These hooks are available for [Nuxt modules](/docs/4.x/guide/modules) and build context.
+
+### Within `nuxt.config.ts`
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+ hooks: {
+ close: () => { },
+ },
+})
+```
+
+### Within Nuxt Modules
+
+```js
+import { defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup (options, nuxt) {
+ nuxt.hook('close', async () => { })
+ },
+})
+```
+
+::read-more{to="/docs/4.x/api/advanced/hooks#nuxt-hooks-build-time"}
+Explore all available Nuxt hooks.
+::
+
+## App Hooks (Runtime)
+
+App hooks can be mainly used by [Nuxt Plugins](/docs/4.x/directory-structure/app/plugins) to hook into rendering lifecycle but could also be used in Vue composables.
+
+```ts [app/plugins/test.ts]
+export default defineNuxtPlugin((nuxtApp) => {
+ nuxtApp.hook('page:start', () => {
+ /* your code goes here */
+ })
+})
+```
+
+::read-more{to="/docs/4.x/api/advanced/hooks#app-hooks-runtime"}
+Explore all available App hooks.
+::
+
+## Server Hooks (Runtime)
+
+These hooks are available for [server plugins](/docs/4.x/directory-structure/server#server-plugins) to hook into Nitro's runtime behavior.
+
+```ts [~~/server/plugins/test.ts]
+import { definePlugin } from 'nitro'
+
+export default definePlugin((nitroApp) => {
+ nitroApp.hooks.hook('render:html', (html, { event }) => {
+ console.log('render:html', html)
+ html.bodyAppend.push('
+
+ ```
+
+ ```ts [base/nuxt.config.ts]
+ export default defineNuxtConfig({
+ // Extending from base nuxt.config.ts!
+ app: {
+ head: {
+ title: 'Extending Configs is Fun!',
+ meta: [
+ { name: 'description', content: 'I am using the extends feature in Nuxt!' },
+ ],
+ },
+ },
+ })
+ ```
+
+ ```vue [base/app/components/BaseComponent.vue]
+
+ Extending Components is Fun!
+
+ ```
+
+::
+
+## Layer Priority
+
+When extending from multiple layers, it's important to understand the override order. Layers with **higher priority** override layers with lower priority when they define the same files or components.
+
+The priority order from highest to lowest is:
+
+1. **Your project files** - always have the highest priority
+2. **Auto-scanned layers** from `~~/layers` directory - sorted alphabetically (Z has higher priority than A)
+3. **Layers in `extends`** config - first entry has higher priority than second
+
+### When to Use Each
+
+- **`extends`** - Use for external dependencies (npm packages, remote repositories) or layers outside your project directory
+- **`~~/layers` directory** - Use for local layers that are part of your project
+
+::tip
+If you need to control the order of auto-scanned layers, you can prefix them with numbers: `~/layers/1.z-layer`, `~/layers/2.a-layer`. This way `2.a-layer` will have higher priority than `1.z-layer`.
+::
+
+### Example
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+ extends: [
+ // Local layer outside the project
+ '../base',
+ // NPM package
+ '@my-themes/awesome',
+ // Remote repository
+ 'github:my-themes/awesome#v1',
+ ],
+})
+```
+
+If you also have `~~/layers/custom`, the priority order is:
+- Your project files (highest)
+- `~~/layers/custom`
+- `../base`
+- `@my-themes/awesome`
+- `github:my-themes/awesome#v1` (lowest)
+
+This means your project files will override any layer, and `~~/layers/custom` will override anything in `extends`.
+
+## Starter Template
+
+To get started you can initialize a layer with the [nuxt/starter/layer template](https://github.com/nuxt/starter/tree/layer). This will create a basic structure you can build upon. Execute this command within the terminal to get started:
+
+```bash [Terminal]
+npm create nuxt -- --template layer nuxt-layer
+```
+
+Follow up on the README instructions for the next steps.
+
+## Publishing Layers
+
+You can publish and share layers by either using a remote source or an npm package.
+
+### Git Repository
+
+You can use a git repository to share your Nuxt layer. Some examples:
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+ extends: [
+ // GitHub Remote Source
+ 'github:username/repoName',
+ // GitHub Remote Source within /base directory
+ 'github:username/repoName/base',
+ // GitHub Remote Source from dev branch
+ 'github:username/repoName#dev',
+ // GitHub Remote Source from v1.0.0 tag
+ 'github:username/repoName#v1.0.0',
+ // GitLab Remote Source example
+ 'gitlab:username/repoName',
+ // Bitbucket Remote Source example
+ 'bitbucket:username/repoName',
+ ],
+})
+```
+
+::tip
+If you want to extend a private remote source, you need to add the environment variable `GIGET_AUTH=` to provide a token.
+::
+
+::tip
+If you want to extend a remote source from a self-hosted GitHub or GitLab instance, you need to supply its URL with the `GIGET_GITHUB_URL=` or `GIGET_GITLAB_URL=` environment variable - or directly configure it with [the `auth` option](https://github.com/unjs/c12#extending-config-layer-from-remote-sources) in your `nuxt.config`.
+::
+
+::warning
+Bear in mind that if you are extending a remote source as a layer, you will not be able to access its dependencies outside of Nuxt. For example, if the remote layer depends on an eslint plugin, this will not be usable in your eslint config. That is because these dependencies will be located in a special location (`node_modules/.c12/layer_name/node_modules/`) that is not accessible to your package manager.
+::
+
+::note
+When using git remote sources, if a layer has npm dependencies and you wish to install them, you can do so by specifying `install: true` in your layer options.
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+ extends: [
+ ['github:username/repoName', { install: true }],
+ ],
+})
+```
+::
+
+### npm Package
+
+You can publish Nuxt layers as an npm package that contains the files and dependencies you want to extend. This allows you to share your config with others, use it in multiple projects or use it privately.
+
+To extend from an npm package, you need to make sure that the module is published to npm and installed in the user's project as a devDependency. Then you can use the module name to extend the current nuxt config:
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+ extends: [
+ // Node Module with scope
+ '@scope/moduleName',
+ // or just the module name
+ 'moduleName',
+ ],
+})
+```
+
+To publish a layer directory as an npm package, you want to make sure that the `package.json` has the correct properties filled out. This will make sure that the files are included when the package is published.
+
+```json [package.json]
+{
+ "name": "my-theme",
+ "version": "1.0.0",
+ "type": "module",
+ "main": "./nuxt.config.ts",
+ "dependencies": {},
+ "devDependencies": {
+ "nuxt": "^3.0.0"
+ }
+}
+```
+
+::important
+Make sure any dependency imported in the layer is **explicitly added** to the `dependencies`. The `nuxt` dependency, and anything only used for testing the layer before publishing, should remain in the `devDependencies` field.
+::
+
+Now you can proceed to publish the module to npm, either publicly or privately.
+
+::important
+When publishing the layer as a private npm package, you need to make sure you log in, to authenticate with npm to download the node module.
+::
+
+## Tips
+
+### Named Layer Aliases
+
+Auto-scanned layers (from your `~~/layers` directory) automatically create aliases. For example, you can access your `~~/layers/test` layer via `#layers/test`.
+
+If you want to create named layer aliases for other layers, you can specify a name in the configuration of the layer.
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+ $meta: {
+ name: 'example',
+ },
+})
+```
+
+This will produce an alias of `#layers/example` which points to your layer.
+
+### Relative Paths and Aliases
+
+When importing using global aliases (such as `~/` and `@/`) in a layer components and composables, note that these aliases are resolved relative to the user's project paths. As a workaround, you can **use relative paths** to import them, or use named layer aliases.
+
+Also when using relative paths in `nuxt.config` file of a layer, (with exception of nested `extends`) they are resolved relative to user's project instead of the layer. As a workaround, use full resolved paths in `nuxt.config`:
+
+```ts [nuxt.config.ts]
+import { fileURLToPath } from 'node:url'
+import { dirname, join } from 'node:path'
+
+const currentDir = dirname(fileURLToPath(import.meta.url))
+
+export default defineNuxtConfig({
+ css: [
+ join(currentDir, './app/assets/main.css'),
+ ],
+})
+```
+
+## Disabling Modules from Layers
+
+When extending a layer, you might want to disable certain modules that it includes. You can do this by setting the module's config key to `false` in your Nuxt config.
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+ extends: ['./base-layer'],
+ // Disable modules from the layer by setting their config key to false
+ image: false, // Disables @nuxt/image
+ pinia: false, // Disables @pinia/nuxt
+})
+```
+
+::note
+The config key is defined by each module. Common examples include `image` for `@nuxt/image`, `pinia` for `@pinia/nuxt`, and `content` for `@nuxt/content`. Check the module's documentation for its specific config key.
+::
+
+This is useful when:
+- A layer includes modules you don't need in your project
+- You want to use a different implementation than what the layer provides
+- You need to disable analytics or other modules in specific environments
+
+::tip
+You can also use this approach to disable modules in your own project - not just those from layers. Setting a module's config key to `false` will prevent its setup function from running while still generating types for the module.
+::
+
+## Multi-Layer Support for Nuxt Modules
+
+You can use the [`getLayerDirectories`](/docs/4.x/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) {
+ 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 array have higher priority and override later ones
+- The user's project is the first item in the array
+
+## Going Deeper
+
+Configuration loading and extends support is handled by [unjs/c12](https://github.com/unjs/c12), merged using [unjs/defu](https://github.com/unjs/defu) and remote git sources are supported using [unjs/giget](https://github.com/unjs/giget). Check the docs and source code to learn more.
+
+::read-more{icon="i-simple-icons-github" to="https://github.com/nuxt/nuxt/issues/13367" target="_blank"}
+Checkout our ongoing development to bring more improvements for layers support on GitHub.
+::
diff --git a/docs/3.guide/6.going-further/9.debugging.md b/docs/3.guide/6.going-further/9.debugging.md
new file mode 100644
index 000000000000..f1f10b5c1540
--- /dev/null
+++ b/docs/3.guide/6.going-further/9.debugging.md
@@ -0,0 +1,112 @@
+---
+title: "Debugging"
+description: "In Nuxt, you can get started with debugging your application directly in the browser as well as in your IDE."
+---
+
+## Sourcemaps
+
+Sourcemaps are enabled for your server build by default, and for the client build in dev mode, but you can enable them more specifically in your configuration.
+
+```ts
+export default defineNuxtConfig({
+ // or sourcemap: true
+ sourcemap: {
+ server: true,
+ client: true,
+ },
+})
+```
+
+## Debugging with Node Inspector
+
+You can use [Node inspector](https://nodejs.org/en/learn/getting-started/debugging) to debug Nuxt server-side.
+
+```bash
+nuxt dev --inspect
+```
+This will start Nuxt in `dev` mode with debugger active. If everything is working correctly a Node.js icon will appear on your Chrome DevTools and you can attach to the debugger.
+
+::important
+Note that the Node.js and Chrome processes need to be run on the same platform. This doesn't work inside of Docker.
+::
+
+## Debugging in Your IDE
+
+It is possible to debug your Nuxt app in your IDE while you are developing it.
+
+### Example VS Code Debug Configuration
+
+You may need to update the config below with a path to your web browser. For more information, visit the [VS Code documentation about debug configuration](https://code.visualstudio.com/docs/debugtest/debugging#_launch-configurations).
+
+```json5
+{
+ // Use IntelliSense to learn about possible attributes.
+ // Hover to view descriptions of existing attributes.
+ "version": "0.2.0",
+ "configurations": [
+ {
+ "type": "chrome",
+ "request": "launch",
+ "name": "client: chrome",
+ "url": "http://localhost:3000",
+ // this should point to your Nuxt `srcDir`, which is `app` by default
+ "webRoot": "${workspaceFolder}/app"
+ },
+ {
+ "type": "node",
+ "request": "launch",
+ "name": "server: nuxt",
+ "outputCapture": "std",
+ "program": "${workspaceFolder}/node_modules/nuxt/bin/nuxt.mjs",
+ "args": [
+ "dev"
+ ],
+ }
+ ],
+ "compounds": [
+ {
+ "name": "fullstack: nuxt",
+ "configurations": [
+ "server: nuxt",
+ "client: chrome"
+ ]
+ }
+ ]
+}
+```
+
+If you prefer your usual browser extensions, add this to the _chrome_ configuration above:
+
+```json5
+"userDataDir": false,
+```
+
+### Example JetBrains IDEs Debug Configuration
+
+You can also debug your Nuxt app in JetBrains IDEs such as IntelliJ IDEA, WebStorm, or PhpStorm.
+
+1. Create a new file in your project root directory and name it `nuxt.run.xml`.
+
+2. Open the `nuxt.run.xml` file and paste the following debug configuration:
+
+```html
+
+
+
+
+
+
+
+
+
+
+```
+
+### Other IDEs
+
+If you have another IDE and would like to contribute sample configuration, feel free to [open a PR](https://github.com/nuxt/nuxt/edit/main/docs/2.guide/3.going-further/9.debugging.md)!
diff --git a/docs/3.guide/6.going-further/index.md b/docs/3.guide/6.going-further/index.md
new file mode 100644
index 000000000000..568dff82b917
--- /dev/null
+++ b/docs/3.guide/6.going-further/index.md
@@ -0,0 +1,4 @@
+---
+navigation: false
+redirect: /guide/going-further/tooling
+---
diff --git a/docs/4.api/.navigation.yml b/docs/4.api/.navigation.yml
new file mode 100644
index 000000000000..4631715cd849
--- /dev/null
+++ b/docs/4.api/.navigation.yml
@@ -0,0 +1,3 @@
+title: API
+titleTemplate: '%s · Nuxt API'
+icon: i-lucide-code-xml
diff --git a/docs/4.api/1.components/.navigation.yml b/docs/4.api/1.components/.navigation.yml
new file mode 100644
index 000000000000..1ad3f65b8e19
--- /dev/null
+++ b/docs/4.api/1.components/.navigation.yml
@@ -0,0 +1,3 @@
+title: 'Components'
+titleTemplate: '%s · Nuxt Components'
+icon: i-lucide-box
diff --git a/docs/4.api/1.components/1.client-only.md b/docs/4.api/1.components/1.client-only.md
new file mode 100644
index 000000000000..ce880b4be4f0
--- /dev/null
+++ b/docs/4.api/1.components/1.client-only.md
@@ -0,0 +1,79 @@
+---
+title: ''
+description: Render components only in client-side with the component.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/components/client-only.ts
+ size: xs
+---
+
+The `` component is used for purposely rendering a component only on client side.
+
+::note
+The content of the default slot will be tree-shaken out of the server build. (This does mean that any CSS used by components within it may not be inlined when rendering the initial HTML.)
+::
+
+## Props
+
+- `placeholderTag` | `fallbackTag`: specify a tag to be rendered server-side.
+- `placeholder` | `fallback`: specify a content to be rendered server-side.
+
+```vue
+
+
+
+
+
+
+```
+
+## Slots
+
+- `#fallback`: specify a content to be rendered on the server and displayed until `` is mounted in the browser.
+
+```vue [app/pages/example.vue]
+
+
+
+
+
+
+
+
+ Loading comments...
+
+
+
+```
+
+## Examples
+
+### Accessing HTML Elements
+
+Components inside `` are rendered only after being mounted. To access the rendered elements in the DOM, you can watch a template ref:
+
+```vue [app/pages/example.vue]
+
+
+
+
+
+
+```
diff --git a/docs/4.api/1.components/1.dev-only.md b/docs/4.api/1.components/1.dev-only.md
new file mode 100644
index 000000000000..0b85d681b6a3
--- /dev/null
+++ b/docs/4.api/1.components/1.dev-only.md
@@ -0,0 +1,51 @@
+---
+title: ''
+description: Render components only during development with the component.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/components/dev-only.ts
+ size: xs
+---
+
+Nuxt provides the `` component to render a component only during development.
+
+The content will not be included in production builds.
+
+```vue [app/pages/example.vue]
+
+
+
+```
+
+## Slots
+
+- `#fallback`: if you ever require to have a replacement during production.
+
+```vue
+
+
+
+```
diff --git a/docs/4.api/1.components/1.nuxt-client-fallback.md b/docs/4.api/1.components/1.nuxt-client-fallback.md
new file mode 100644
index 000000000000..bc1308fa49a0
--- /dev/null
+++ b/docs/4.api/1.components/1.nuxt-client-fallback.md
@@ -0,0 +1,87 @@
+---
+title: ""
+description: "Nuxt provides the component to render its content on the client if any of its children trigger an error in SSR"
+links:
+ - label: Source (client)
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/components/client-fallback.client.ts
+ size: xs
+ - label: Source (server)
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/components/client-fallback.server.ts
+ size: xs
+---
+
+Nuxt provides the `` component to render its content on the client if any of its children trigger an error in SSR.
+
+::note{to="/docs/4.x/guide/going-further/experimental-features#clientfallback"}
+This component is experimental and in order to use it you must enable the `experimental.clientFallback` option in your `nuxt.config`.
+::
+
+```vue [app/pages/example.vue]
+
+
+
+
+
+
+```
+
+## Events
+
+- `@ssr-error`: Event emitted when a child triggers an error in SSR. Note that this will only be triggered on the server.
+
+ ```vue
+
+
+
+
+
+ ```
+
+## Props
+
+- `placeholderTag` | `fallbackTag`: Specify a fallback tag to be rendered if the slot fails to render on the server.
+ - **type**: `string`
+ - **default**: `div`
+- `placeholder` | `fallback`: Specify fallback content to be rendered if the slot fails to render.
+ - **type**: `string`
+- `keepFallback`: Keep the fallback content if it failed to render server-side.
+ - **type**: `boolean`
+ - **default**: `false`
+
+::warning{icon="i-ph-warning-duotone"}
+The `placeholder` and `fallback` props render content as raw HTML. Do not pass untrusted user input to these props as it may lead to XSS vulnerabilities. Use the `#fallback` or `#placeholder` slots instead for dynamic content that needs proper escaping.
+::
+
+```vue
+
+
+
+
+
+```
+
+## Slots
+
+- `#fallback`: specify content to be displayed server-side if the slot fails to render.
+
+```vue
+
+
+
+
+
+ Hello world
+
+
+
+```
diff --git a/docs/4.api/1.components/10.nuxt-picture.md b/docs/4.api/1.components/10.nuxt-picture.md
new file mode 100644
index 000000000000..94ec014f7eb4
--- /dev/null
+++ b/docs/4.api/1.components/10.nuxt-picture.md
@@ -0,0 +1,27 @@
+---
+title: ""
+description: "Nuxt provides a component to handle automatic image optimization."
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/image/blob/main/src/runtime/components/NuxtPicture.vue
+ size: xs
+---
+
+`` is a drop-in replacement for the native `` tag.
+
+Usage of `` is almost identical to [``](/docs/4.x/api/components/nuxt-img) but it also allows serving modern formats like `webp` when possible.
+
+Learn more about the [`` tag on MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/picture).
+
+## Setup
+
+In order to use `` you should install and enable the Nuxt Image module:
+
+```bash [Terminal]
+npx nuxt module add image
+```
+
+::read-more{to="https://image.nuxt.com/usage/nuxt-picture" target="_blank"}
+Read more about the `` component.
+::
diff --git a/docs/4.api/1.components/11.teleports.md b/docs/4.api/1.components/11.teleports.md
new file mode 100644
index 000000000000..91eaaee2cf87
--- /dev/null
+++ b/docs/4.api/1.components/11.teleports.md
@@ -0,0 +1,43 @@
+---
+title: ''
+description: The component teleports a component to a different location in the DOM.
+---
+
+::warning
+The `to` target of [``](https://vuejs.org/guide/built-ins/teleport) expects a CSS selector string or an actual DOM node. Nuxt currently has SSR support for teleports to `#teleports` only, with client-side support for other targets using a `` wrapper.
+::
+
+## Body Teleport
+
+```vue
+
+
+ Open Modal
+
+
+
+
Hello from the modal!
+
+ Close
+
+
+
+```
+
+## Client-side Teleport
+
+```vue
+
+
+
+
+
+
+
+```
+
+:link-example{to="/docs/4.x/examples/advanced/teleport"}
diff --git a/docs/4.api/1.components/12.nuxt-route-announcer.md b/docs/4.api/1.components/12.nuxt-route-announcer.md
new file mode 100644
index 000000000000..4aedcb3c14df
--- /dev/null
+++ b/docs/4.api/1.components/12.nuxt-route-announcer.md
@@ -0,0 +1,58 @@
+---
+title: ''
+description: 'The component adds a hidden element with the page title to announce route changes to assistive technologies.'
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/components/nuxt-route-announcer.ts
+ size: xs
+---
+
+::important
+This component is available in Nuxt v3.12+.
+::
+
+## Usage
+
+Add `
+
+
+
+```
+
+## Slots
+
+You can pass custom HTML or components through the route announcer's default slot.
+
+```vue
+
+
+
+ {{ message }} was loaded.
+
+
+
+```
+
+## Props
+
+- `atomic`: Controls if screen readers only announce changes or the entire content. Set to true for full content readouts on updates, false for changes only. (default `false`)
+- `politeness`: Sets the urgency for screen reader announcements: `off` (disable the announcement), `polite` (waits for silence), or `assertive` (interrupts immediately). (default `polite`)
+
+::callout
+This component is optional. :br
+To achieve full customization, you can implement your own one based on [its source code](https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/components/nuxt-route-announcer.ts).
+::
+
+::callout
+You can hook into the underlying announcer instance using [the `useRouteAnnouncer` composable](/docs/4.x/api/composables/use-route-announcer), which allows you to set a custom announcement message.
+::
+
+::callout
+For announcing in-page content changes (form validation, toast notifications, loading states, etc.), use the [``](/docs/4.x/api/components/nuxt-announcer) component with the [`useAnnouncer`](/docs/4.x/api/composables/use-announcer) composable instead.
+::
diff --git a/docs/4.api/1.components/13.nuxt-time.md b/docs/4.api/1.components/13.nuxt-time.md
new file mode 100644
index 000000000000..323ad6a89a51
--- /dev/null
+++ b/docs/4.api/1.components/13.nuxt-time.md
@@ -0,0 +1,202 @@
+---
+title: ''
+description: 'The component displays time in a locale-friendly format with server-client consistency.'
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/components/nuxt-time.vue
+ size: xs
+---
+
+::important
+This component is available in Nuxt v3.17+.
+::
+
+The `` component lets you display dates and times in a locale-friendly format with proper `` HTML semantics. It ensures consistent rendering between server and client without hydration mismatches.
+
+## Usage
+
+You can use the `` component anywhere in your app:
+
+```vue
+
+
+```
+
+## Props
+
+### `datetime`
+
+- Type: `Date | number | string`
+- Required: `true`
+
+The date and time value to display. You can provide:
+- A `Date` object
+- A timestamp (number)
+- An ISO-formatted date string
+
+```vue
+
+
+```
+
+### `locale`
+
+- Type: `string`
+- Required: `false`
+- Default: Uses the browser or server's default locale
+
+The [BCP 47 language tag](https://datatracker.ietf.org/doc/html/rfc5646) for formatting (e.g., 'en-US', 'fr-FR', 'ja-JP'):
+
+```vue
+
+
+```
+
+### Formatting Props
+
+The component accepts any property from the [Intl.DateTimeFormat](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/DateTimeFormat) options:
+
+```vue
+
+
+```
+
+This would output something like: "April 22, 2025, 08:30 AM"
+
+### `relative`
+
+- Type: `boolean`
+- Required: `false`
+- Default: `false`
+
+Enables relative time formatting using the Intl.RelativeTimeFormat API:
+
+```vue
+
+
+
+```
+
+### Relative Time Formatting Props
+
+When `relative` is set to `true`, the component also accepts properties from [Intl.RelativeTimeFormat](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/RelativeTimeFormat/RelativeTimeFormat):
+
+::warning
+Due to `style` being a reserved prop, `relativeStyle` prop is used instead.
+::
+
+```vue
+
+
+```
+
+This would output something like: "3 days ago" or "last Friday" depending on the `numeric` setting.
+
+## Examples
+
+### Basic Usage
+
+```vue
+
+
+```
+
+### Custom Formatting
+
+```vue
+
+
+```
+
+### Relative Time
+
+```vue
+
+
+
+
+
+
+
+
+
+```
+
+### With Custom Locale
+
+```vue
+
+
+
+
+```
diff --git a/docs/4.api/1.components/14.nuxt-announcer.md b/docs/4.api/1.components/14.nuxt-announcer.md
new file mode 100644
index 000000000000..18674324aadb
--- /dev/null
+++ b/docs/4.api/1.components/14.nuxt-announcer.md
@@ -0,0 +1,81 @@
+---
+title: ''
+description: 'The component adds a hidden element to announce dynamic content changes to assistive technologies.'
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/components/nuxt-announcer.ts
+ size: xs
+---
+
+::important
+This component is available in Nuxt v4.4.2+.
+::
+
+## Usage
+
+Add `
+
+
+
+```
+
+Then use the [`useAnnouncer`](/docs/4.x/api/composables/use-announcer) composable anywhere in your app to announce messages:
+
+```vue [app/pages/contact.vue]
+
+```
+
+## Slots
+
+You can pass custom HTML or components through the announcer's default slot.
+
+```vue
+
+
+
+ {{ message }}
+
+
+
+```
+
+## Props
+
+- `atomic`: Controls if screen readers announce only changes or the entire content. Set to true for full content readouts on updates, false for changes only. (default `true`)
+- `politeness`: Sets the default urgency for screen reader announcements: `off` (disable the announcement), `polite` (waits for silence), or `assertive` (interrupts immediately). (default `polite`)
+
+## Differences from ``
+
+| Aspect | `` | `` |
+|--------|------------------------|-------------------|
+| **Purpose** | Announces route/page changes | Announces any dynamic content |
+| **Trigger** | Automatic on navigation | Manual via `polite()`/`assertive()` |
+| **Message source** | Page `` | Developer-provided |
+| **atomic default** | `false` | `true` |
+
+::callout
+This component is optional. :br
+To achieve full customization, you can implement your own one based on [its source code](https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/components/nuxt-announcer.ts).
+::
+
+::callout
+You can hook into the underlying announcer instance using [the `useAnnouncer` composable](/docs/4.x/api/composables/use-announcer), which allows you to set custom announcement messages.
+::
diff --git a/docs/4.api/1.components/2.nuxt-page.md b/docs/4.api/1.components/2.nuxt-page.md
new file mode 100644
index 000000000000..0298dcdb5c67
--- /dev/null
+++ b/docs/4.api/1.components/2.nuxt-page.md
@@ -0,0 +1,154 @@
+---
+title: "<NuxtPage>"
+description: The <NuxtPage> component is required to display pages located in the pages/ directory.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/pages/runtime/page.ts
+ size: xs
+---
+
+`<NuxtPage>` is a built-in component that comes with Nuxt. It lets you display top-level or nested pages located in the [`app/pages/`](/docs/4.x/directory-structure/app/pages) directory.
+
+::note
+`<NuxtPage>` is a wrapper around [`<RouterView>`](https://router.vuejs.org/api/interfaces/routerviewprops) from Vue Router. It should be used instead of `<RouterView>` because the former takes additional care of internal states. Otherwise, `useRoute()` may return incorrect paths.
+::
+
+`<NuxtPage>` includes the following components:
+
+```vue
+<template>
+ <RouterView v-slot="{ Component }">
+ <!-- Optional, when using transitions -->
+ <Transition>
+ <!-- Optional, when using keep-alive -->
+ <KeepAlive>
+ <Suspense>
+ <component :is="Component" />
+ </Suspense>
+ </KeepAlive>
+ </Transition>
+ </RouterView>
+</template>
+```
+
+By default, Nuxt does not enable `<Transition>` and `<KeepAlive>`. You can enable them in the nuxt.config file or by setting the `transition` and `keepalive` properties on `<NuxtPage>`. If you want to define a specific page, you can set it in `definePageMeta` in the page component.
+
+::warning
+If you enable `<Transition>` in your page component, ensure that the page has a single root element.
+::
+
+Since `<NuxtPage>` uses `<Suspense>` under the hood, the component lifecycle behavior during page changes differs from that of a typical Vue application.
+
+In a typical Vue application, a new page component is mounted **only after** the previous one has been fully unmounted. However, in Nuxt, due to how Vue `<Suspense>` is implemented, the new page component is mounted **before** the previous one is unmounted.
+
+## Props
+
+- `name`: tells `<RouterView>` to render the component with the corresponding name in the matched route record's components option. See [Named Views](/docs/4.x/directory-structure/app/pages#named-views) for the `name@view.vue` filename convention.
+ - type: `string`
+- `route`: route location that has all of its components resolved.
+ - type: `RouteLocationNormalized`
+- `pageKey`: control when the `NuxtPage` component is re-rendered.
+ - type: `string` or `function`
+- `transition`: define global transitions for all pages rendered with the `NuxtPage` component.
+ - type: `boolean` or [`TransitionProps`](https://vuejs.org/api/built-in-components#transition)
+- `keepalive`: control state preservation of pages rendered with the `NuxtPage` component.
+ - type: `boolean` or [`KeepAliveProps`](https://vuejs.org/api/built-in-components#keepalive)
+
+::tip
+Nuxt automatically resolves the `name` and `route` by scanning and rendering all Vue component files found in the `/pages` directory.
+::
+
+## Example
+
+For example, if you pass a key that never changes, the `<NuxtPage>` component will be rendered only once - when it is first mounted.
+
+```vue [app/app.vue]
+<template>
+ <NuxtPage page-key="static" />
+</template>
+```
+
+You can also use a dynamic key based on the current route:
+
+```html
+<NuxtPage :page-key="route => route.fullPath" />
+```
+
+::warning
+Don't use `$route` object here as it can cause problems with how `<NuxtPage>` renders pages with `<Suspense>`.
+::
+
+Alternatively, `pageKey` can be passed as a `key` value via [`definePageMeta`](/docs/4.x/api/utils/define-page-meta) from the `<script>` section of your Vue component in the `/pages` directory.
+
+```vue [app/pages/my-page.vue]
+<script setup lang="ts">
+definePageMeta({
+ key: route => route.fullPath,
+})
+</script>
+```
+
+:link-example{to="/docs/4.x/examples/routing/pages"}
+
+## Page's Ref
+
+To get the `ref` of a page component, access it through `ref.value.pageRef`
+
+````vue [app/app.vue]
+<script setup lang="ts">
+const page = ref()
+
+function logFoo () {
+ page.value.pageRef.foo()
+}
+</script>
+
+<template>
+ <NuxtPage ref="page" />
+</template>
+````
+
+````vue [my-page.vue]
+<script setup lang="ts">
+const foo = () => {
+ console.log('foo method called')
+}
+
+defineExpose({
+ foo,
+})
+</script>
+````
+
+## Custom Props
+
+`<NuxtPage>` also accepts custom props that you may need to pass further down the hierarchy.
+
+For example, in the below example, the value of `foobar` will be passed to the `NuxtPage` component and then to the page components.
+
+```vue [app/app.vue]
+<template>
+ <NuxtPage :foobar="123" />
+</template>
+```
+
+We can access the `foobar` prop in the page component:
+
+```vue [app/pages/page.vue]
+<script setup lang="ts">
+const props = defineProps<{ foobar: number }>()
+
+console.log(props.foobar) // Outputs: 123
+```
+
+If you have not defined the prop with `defineProps`, any props passed down to `NuxtPage` can still be accessed directly from the page `attrs`:
+
+```vue [app/pages/page.vue]
+<script setup lang="ts">
+const attrs = useAttrs()
+console.log(attrs.foobar) // Outputs: 123
+</script>
+```
+
+:read-more{to="/docs/4.x/directory-structure/app/pages"}
diff --git a/docs/4.api/1.components/3.nuxt-layout.md b/docs/4.api/1.components/3.nuxt-layout.md
new file mode 100644
index 000000000000..041af45520c1
--- /dev/null
+++ b/docs/4.api/1.components/3.nuxt-layout.md
@@ -0,0 +1,190 @@
+---
+title: "<NuxtLayout>"
+description: "Nuxt provides the <NuxtLayout> component to show layouts on pages and error pages."
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/components/nuxt-layout.ts
+ size: xs
+---
+
+You can use `<NuxtLayout />` component to activate the `default` layout on `app.vue` or `error.vue`.
+
+```vue [app/app.vue]
+<template>
+ <NuxtLayout>
+ some page content
+ </NuxtLayout>
+</template>
+```
+
+:read-more{to="/docs/4.x/directory-structure/app/layouts"}
+
+## Props
+
+- `name`: Specify a layout name to be rendered, can be a string, reactive reference or a computed property. It **must** match the name of the corresponding layout file in the [`app/layouts/`](/docs/4.x/directory-structure/app/layouts) directory, or `false` to disable the layout.
+ - **type**: `string | false`
+ - **default**: `default`
+
+```vue [app/pages/index.vue]
+<script setup lang="ts">
+// layouts/custom.vue
+const layout = 'custom'
+</script>
+
+<template>
+ <NuxtLayout :name="layout">
+ <NuxtPage />
+ </NuxtLayout>
+</template>
+```
+
+::note
+Please note the layout name is normalized to kebab-case, so if your layout file is named `errorLayout.vue`, it will become `error-layout` when passed as a `name` property to `<NuxtLayout />`.
+::
+
+```vue [error.vue]
+<template>
+ <NuxtLayout name="error-layout">
+ <NuxtPage />
+ </NuxtLayout>
+</template>
+```
+
+::read-more{to="/docs/4.x/directory-structure/app/layouts"}
+Read more about dynamic layouts.
+::
+
+- `fallback`: If an invalid layout is passed to the `name` prop, no layout will be rendered. Specify a `fallback` layout to be rendered in this scenario. It **must** match the name of the corresponding layout file in the [`app/layouts/`](/docs/4.x/directory-structure/app/layouts) directory.
+ - **type**: `string`
+ - **default**: `null`
+
+## Additional Props
+
+`NuxtLayout` also accepts any additional props that you may need to pass to the layout. These custom props are then made accessible as attributes.
+
+```vue [app/pages/some-page.vue]
+<template>
+ <div>
+ <NuxtLayout
+ name="custom"
+ title="I am a custom layout"
+ >
+ <!-- ... -->
+ </NuxtLayout>
+ </div>
+</template>
+```
+
+In the above example, the value of `title` will be available using `$attrs.title` in the template or `useAttrs().title` in `<script setup>` at custom.vue.
+
+```vue [app/layouts/custom.vue]
+<script setup lang="ts">
+const layoutCustomProps = useAttrs()
+
+console.log(layoutCustomProps.title) // I am a custom layout
+</script>
+```
+
+## Layout Props from Page Meta
+
+When using [`definePageMeta`](/docs/4.x/api/utils/define-page-meta) with the object syntax for `layout`, props are automatically passed to the layout component. The layout can receive them with `defineProps`:
+
+```vue [app/pages/dashboard.vue]
+<script setup lang="ts">
+definePageMeta({
+ layout: {
+ name: 'admin',
+ props: {
+ sidebar: true,
+ },
+ },
+})
+</script>
+```
+
+```vue [app/layouts/admin.vue]
+<script setup lang="ts">
+const props = defineProps<{
+ sidebar?: boolean
+}>()
+</script>
+```
+
+::read-more{to="/docs/4.x/directory-structure/app/layouts#passing-props-to-layouts"}
+Read more about passing props to layouts.
+::
+
+## Transitions
+
+`<NuxtLayout />` renders incoming content via `<slot />`, which is then wrapped around Vue’s `<Transition />` component to activate layout transition. For this to work as expected, it is recommended that `<NuxtLayout />` is **not** the root element of the page component.
+
+::code-group
+
+```vue [app/pages/index.vue]
+<template>
+ <div>
+ <NuxtLayout name="custom">
+ <template #header>
+ Some header template content.
+ </template>
+ </NuxtLayout>
+ </div>
+</template>
+```
+
+```vue [app/layouts/custom.vue]
+<template>
+ <div>
+ <!-- named slot -->
+ <slot name="header" />
+ <slot />
+ </div>
+</template>
+```
+
+::
+
+:read-more{to="/docs/4.x/getting-started/transitions"}
+
+## Layout's Ref
+
+To get the ref of a layout component, access it through `ref.value.layoutRef`.
+
+::code-group
+
+```vue [app/app.vue]
+<script setup lang="ts">
+const layout = ref()
+
+function logFoo () {
+ layout.value.layoutRef.foo()
+}
+</script>
+
+<template>
+ <NuxtLayout ref="layout">
+ default layout
+ </NuxtLayout>
+</template>
+```
+
+```vue [app/layouts/default.vue]
+<script setup lang="ts">
+const foo = () => console.log('foo')
+defineExpose({
+ foo,
+})
+</script>
+
+<template>
+ <div>
+ default layout
+ <slot />
+ </div>
+</template>
+```
+
+::
+
+:read-more{to="/docs/4.x/directory-structure/app/layouts"}
diff --git a/docs/4.api/1.components/4.nuxt-link.md b/docs/4.api/1.components/4.nuxt-link.md
new file mode 100644
index 000000000000..e2489119d758
--- /dev/null
+++ b/docs/4.api/1.components/4.nuxt-link.md
@@ -0,0 +1,346 @@
+---
+title: "<NuxtLink>"
+description: "Nuxt provides <NuxtLink> component to handle any kind of links within your application."
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/components/nuxt-link.ts
+ size: xs
+---
+
+::note
+`<NuxtLink>` is a drop-in replacement for both Vue Router's `<RouterLink>` component and HTML's `<a>` tag. It intelligently determines whether the link is _internal_ or _external_ and renders it accordingly with available optimizations (prefetching, default attributes, etc.)
+::
+
+## Internal Routing
+
+In this example, we use `<NuxtLink>` component to link to another page of the application.
+
+::code-group
+```vue [app/pages/index.vue]
+<template>
+ <NuxtLink to="/about">About page</NuxtLink>
+</template>
+```
+
+```html [(Renders as) index.html]
+<!-- (Vue Router & Smart Prefetching) -->
+<a href="/about">About page</a>
+```
+::
+
+### Passing Params to Dynamic Routes
+
+In this example, we pass the `id` param to link to the route `~/pages/posts/[id].vue`.
+
+::code-group
+```vue [app/pages/index.vue]
+<template>
+ <NuxtLink :to="{ name: 'posts-id', params: { id: 123 } }">
+ Post 123
+ </NuxtLink>
+</template>
+```
+
+```html [(Renders as) index.html]
+<a href="/posts/123">Post 123</a>
+```
+::
+
+::tip
+Check out the Pages panel in Nuxt DevTools to see the route name and the params it might take.
+::
+
+::tip
+When you pass an object into the `to` prop, `<NuxtLink>` will inherit Vue Router’s handling of query parameters. Keys and values will be automatically encoded, so you don’t need to call `encodeURI` or `encodeURIComponent` manually.
+::
+
+### Handling Static File and Cross-App Links
+
+By default, `<NuxtLink>` uses Vue Router's client side navigation for relative route. When linking to static files in the `/public` directory or to another application hosted on the same domain, it might result in unexpected 404 errors because they are not part of the client routes. In such cases, you can use the `external` prop with `<NuxtLink>` to bypass Vue Router's internal routing mechanism.
+
+The `external` prop explicitly indicates that the link is external. `<NuxtLink>` will render the link as a standard HTML `<a>` tag. This ensures the link behaves correctly, bypassing Vue Router’s logic and directly pointing to the resource.
+
+#### Linking to Static Files
+
+For static files in the `/public` directory, such as PDFs or images, use the `external` prop to ensure the link resolves correctly.
+
+```vue [app/pages/index.vue]
+<template>
+ <NuxtLink
+ to="/example-report.pdf"
+ external
+ >
+ Download Report
+ </NuxtLink>
+</template>
+```
+
+#### Linking to a Cross-App URL
+
+When pointing to a different application on the same domain, using the `external` prop ensures the correct behavior.
+
+```vue [app/pages/index.vue]
+<template>
+ <NuxtLink
+ to="/another-app"
+ external
+ >
+ Go to Another App
+ </NuxtLink>
+</template>
+```
+
+Using the `external` prop or relying on automatic handling ensures proper navigation, avoids unexpected routing issues, and improves compatibility with static resources or cross-application scenarios.
+
+## External Routing
+
+In this example, we use `<NuxtLink>` component to link to a website.
+
+```vue [app/app.vue]
+<template>
+ <NuxtLink to="https://nuxtjs.org">
+ Nuxt website
+ </NuxtLink>
+ <!-- <a href="https://nuxtjs.org" rel="noopener noreferrer">...</a> -->
+</template>
+```
+
+## `rel` and `noRel` Attributes
+
+A `rel` attribute of `noopener noreferrer` is applied by default to links with a `target` attribute or to absolute links (e.g., links starting with `http://`, `https://`, or `//`).
+- `noopener` solves a [security bug](https://mathiasbynens.github.io/rel-noopener/) in older browsers.
+- `noreferrer` improves privacy for your users by not sending the `Referer` header to the linked site.
+
+These defaults have no negative impact on SEO and are considered [best practice](https://developer.chrome.com/docs/lighthouse/best-practices/external-anchors-use-rel-noopener).
+
+When you need to overwrite this behavior you can use the `rel` or `noRel` props.
+
+```vue [app/app.vue]
+<template>
+ <NuxtLink to="https://twitter.com/nuxt_js">
+ Nuxt Twitter
+ </NuxtLink>
+ <!-- <a href="https://twitter.com/nuxt_js" rel="noopener noreferrer">...</a> -->
+
+ <NuxtLink
+ to="https://discord.nuxtjs.org"
+ rel="noopener"
+ >
+ Nuxt Discord
+ </NuxtLink>
+ <!-- <a href="https://discord.nuxtjs.org" rel="noopener">...</a> -->
+
+ <NuxtLink
+ to="/about"
+ target="_blank"
+ >About page</NuxtLink>
+ <!-- <a href="/about" target="_blank" rel="noopener noreferrer">...</a> -->
+</template>
+```
+
+A `noRel` prop can be used to prevent the default `rel` attribute from being added to the absolute links.
+
+```vue [app/app.vue]
+<template>
+ <NuxtLink
+ to="https://github.com/nuxt"
+ no-rel
+ >
+ Nuxt GitHub
+ </NuxtLink>
+ <!-- <a href="https://github.com/nuxt">...</a> -->
+</template>
+```
+
+::note
+`noRel` and `rel` cannot be used together. `rel` will be ignored.
+::
+
+## Prefetch Links
+
+Nuxt automatically includes smart prefetching. That means it detects when a link is visible (by default), either in the viewport or when scrolling and prefetches the JavaScript for those pages so that they are ready when the user clicks the link. Nuxt only loads the resources when the browser isn't busy and skips prefetching if your connection is offline or if you only have 2g connection.
+
+```vue [app/pages/index.vue]
+<NuxtLink to="/about" no-prefetch>
+About page not pre-fetched
+</NuxtLink>
+
+<NuxtLink to="/about" :prefetch="false">
+About page not pre-fetched
+</NuxtLink>
+```
+
+### Custom Prefetch Triggers
+
+We now support custom prefetch triggers for `<NuxtLink>` after `v3.13.0`. You can use the `prefetchOn` prop to control when to prefetch links.
+
+```vue
+<template>
+ <NuxtLink prefetch-on="visibility">
+ This will prefetch when it becomes visible (default)
+ </NuxtLink>
+
+ <NuxtLink prefetch-on="interaction">
+ This will prefetch when hovered or when it gains focus
+ </NuxtLink>
+</template>
+```
+
+- `visibility`: Prefetches when the link becomes visible in the viewport. Monitors the element's intersection with the viewport using the [Intersection Observer API](https://developer.mozilla.org/en-US/docs/Web/API/Intersection_Observer_API). Prefetching is triggered when the element is scrolled into view.
+- `interaction`: Prefetches when the link is hovered or focused. This approach listens for `pointerenter` and `focus` events, proactively prefetching resources when the user indicates intent to interact.
+
+You can also use an object to configure `prefetchOn`:
+
+```vue
+<template>
+ <NuxtLink :prefetch-on="{ interaction: true }">
+ This will prefetch when hovered or when it gains focus
+ </NuxtLink>
+</template>
+```
+
+That you probably don't want both enabled!
+
+```vue
+<template>
+ <NuxtLink :prefetch-on="{ visibility: true, interaction: true }">
+ This will prefetch when hovered/focus - or when it becomes visible
+ </NuxtLink>
+</template>
+```
+
+This configuration will observe when the element enters the viewport and also listen for `pointerenter` and `focus` events. This may result in unnecessary resource usage or redundant prefetching, as both triggers can prefetch the same resource under different conditions.
+
+### Enable Cross-origin Prefetch
+
+To enable cross-origin prefetching, you can set the `crossOriginPrefetch` option in your `nuxt.config`. This will enable cross-origin prefetching using the [Speculation Rules API](https://developer.mozilla.org/en-US/docs/Web/API/Speculation_Rules_API).
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ crossOriginPrefetch: true,
+ },
+})
+```
+
+### Disable prefetch globally
+
+It's also possible to enable/disable prefetching all links globally for your app.
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ defaults: {
+ nuxtLink: {
+ prefetch: false,
+ },
+ },
+ },
+})
+```
+
+## Props
+
+### RouterLink
+
+When not using `external`, `<NuxtLink>` supports all Vue Router's [`RouterLink` props](https://router.vuejs.org/api/interfaces/routerlinkprops)
+
+- `to`: Any URL or a [route location object](https://router.vuejs.org/api/type-aliases/routelocation) from Vue Router
+- `custom`: Whether `<NuxtLink>` should wrap its content in an `<a>` element. It allows taking full control of how a link is rendered and how navigation works when it is clicked. Works the same as [Vue Router's `custom` prop](https://router.vuejs.org/api/interfaces/routerlinkprops#custom-)
+- `exactActiveClass`: A class to apply on exact active links. Works the same as [Vue Router's `exactActiveClass` prop](https://router.vuejs.org/api/interfaces/routerlinkprops#exactActiveClass-) on internal links. Defaults to Vue Router's default (`"router-link-exact-active"`)
+- `activeClass`: A class to apply on active links. Works the same as [Vue Router's `activeClass` prop](https://router.vuejs.org/api/interfaces/routerlinkprops#activeClass-) on internal links. Defaults to Vue Router's default (`"router-link-active"`)
+- `replace`: Works the same as [Vue Router's `replace` prop](https://router.vuejs.org/api/interfaces/routelocationoptions#replace-) on internal links
+- `ariaCurrentValue`: An `aria-current` attribute value to apply on exact active links. Works the same as [Vue Router's `ariaCurrentValue` prop](https://router.vuejs.org/api/interfaces/routerlinkprops#ariaCurrentValue-) on internal links
+
+### NuxtLink
+
+- `href`: An alias for `to`. If used with `to`, `href` will be ignored
+- `noRel`: If set to `true`, no `rel` attribute will be added to the external link
+- `external`: Forces the link to be rendered as an `<a>` tag instead of a Vue Router `RouterLink`.
+- `prefetch`: When enabled will prefetch middleware, layouts and payloads (when using [payloadExtraction](/docs/4.x/guide/going-further/experimental-features#payloadextraction)) of links in the viewport. Used by the experimental [crossOriginPrefetch](/docs/4.x/guide/going-further/experimental-features#crossoriginprefetch) config.
+- `prefetchOn`: Allows custom control of when to prefetch links. Possible options are `interaction` and `visibility` (default). You can also pass an object for full control, for example: `{ interaction: true, visibility: true }`. This prop is only used when `prefetch` is enabled (default) and `noPrefetch` is not set.
+- `noPrefetch`: Disables prefetching.
+- `prefetchedClass`: A class to apply to links that have been prefetched.
+
+### Anchor
+
+- `target`: A `target` attribute value to apply on the link
+- `rel`: A `rel` attribute value to apply on the link. Defaults to `"noopener noreferrer"` for external links.
+
+::tip
+Defaults can be overwritten, see [overwriting defaults](/docs/4.x/api/components/nuxt-link#overwriting-defaults) if you want to change them.
+::
+
+## Overwriting Defaults
+
+### In Nuxt Config
+
+You can overwrite some `<NuxtLink>` defaults in your [`nuxt.config`](/docs/4.x/guide/going-further/experimental-features#defaults)
+
+::important
+These options will likely be moved elsewhere in the future, such as into `app.config` or into the `app/` directory.
+::
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+ experimental: {
+ defaults: {
+ nuxtLink: {
+ // default values
+ componentName: 'NuxtLink',
+ externalRelAttribute: 'noopener noreferrer',
+ activeClass: 'router-link-active',
+ exactActiveClass: 'router-link-exact-active',
+ prefetchedClass: undefined, // can be any valid string class name
+ trailingSlash: undefined, // can be 'append' or 'remove'
+ prefetch: true,
+ prefetchOn: { visibility: true },
+ },
+ },
+ },
+})
+```
+
+### Custom Link Component
+
+You can overwrite `<NuxtLink>` defaults by creating your own link component using `defineNuxtLink`.
+
+```ts [app/components/MyNuxtLink.ts]
+export default defineNuxtLink({
+ componentName: 'MyNuxtLink',
+ /* see signature below for more */
+})
+```
+
+You can then use `<MyNuxtLink />` component as usual with your new defaults.
+
+### `defineNuxtLink` Signature
+
+```ts
+interface NuxtLinkOptions {
+ componentName?: string
+ externalRelAttribute?: string
+ activeClass?: string
+ exactActiveClass?: string
+ trailingSlash?: 'append' | 'remove'
+ prefetch?: boolean
+ prefetchedClass?: string
+ prefetchOn?: Partial<{
+ visibility: boolean
+ interaction: boolean
+ }>
+}
+function defineNuxtLink (options: NuxtLinkOptions): Component {}
+```
+
+- `componentName`: A name for the component. Default is `NuxtLink`.
+- `externalRelAttribute`: A default `rel` attribute value applied on external links. Defaults to `"noopener noreferrer"`. Set it to `""` to disable
+- `activeClass`: A default class to apply on active links. Works the same as [Vue Router's `linkActiveClass` option](https://router.vuejs.org/api/interfaces/routeroptions#linkActiveClass-). Defaults to Vue Router's default (`"router-link-active"`)
+- `exactActiveClass`: A default class to apply on exact active links. Works the same as [Vue Router's `linkExactActiveClass` option](https://router.vuejs.org/api/interfaces/routeroptions#linkExactActiveClass-). Defaults to Vue Router's default (`"router-link-exact-active"`)
+- `trailingSlash`: An option to either add or remove trailing slashes in the `href`. If unset or not matching the valid values `append` or `remove`, it will be ignored.
+- `prefetch`: Whether or not to prefetch links by default.
+- `prefetchOn`: Granular control of which prefetch strategies to apply by default.
+- `prefetchedClass`: A default class to apply to links that have been prefetched.
+
+:link-example{to="/docs/4.x/examples/routing/pages"}
diff --git a/docs/4.api/1.components/5.nuxt-loading-indicator.md b/docs/4.api/1.components/5.nuxt-loading-indicator.md
new file mode 100644
index 000000000000..27074c3e5303
--- /dev/null
+++ b/docs/4.api/1.components/5.nuxt-loading-indicator.md
@@ -0,0 +1,50 @@
+---
+title: '<NuxtLoadingIndicator>'
+description: 'Display a progress bar between page navigations.'
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/components/nuxt-loading-indicator.ts
+ size: xs
+---
+
+## Usage
+
+Add `<NuxtLoadingIndicator/>` in your [`app.vue`](/docs/4.x/directory-structure/app/app) or [`app/layouts/`](/docs/4.x/directory-structure/app/layouts).
+
+```vue [app/app.vue]
+<template>
+ <NuxtLoadingIndicator />
+ <NuxtLayout>
+ <NuxtPage />
+ </NuxtLayout>
+</template>
+```
+
+:link-example{to="/docs/4.x/examples/routing/pages"}
+
+## Slots
+
+You can pass custom HTML or components through the loading indicator's default slot.
+
+## Props
+
+- `color`: The color of the loading bar. It can be set to `false` to turn off explicit color styling.
+- `errorColor`: The color of the loading bar when `error` is set to `true`.
+- `height`: Height of the loading bar, in pixels (default `3`).
+- `duration`: Duration of the loading bar, in milliseconds (default `2000`).
+- `throttle`: Throttle the appearing and hiding, in milliseconds (default `200`).
+- `estimatedProgress`: By default Nuxt will back off as it approaches 100%. You can provide a custom function to customize the progress estimation, which is a function that receives the duration of the loading bar (above) and the elapsed time. It should return a value between 0 and 100.
+
+::note
+This component is optional. :br
+To achieve full customization, you can implement your own one based on [its source code](https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/components/nuxt-loading-indicator.ts).
+::
+
+::note
+You can hook into the underlying indicator instance using [the `useLoadingIndicator` composable](/docs/4.x/api/composables/use-loading-indicator), which will allow you to trigger start/finish events yourself.
+::
+
+::tip
+The loading indicator's speed gradually decreases after reaching a specific point controlled by `estimatedProgress`. This adjustment provides a more accurate reflection of longer page loading times and prevents the indicator from prematurely showing 100% completion.
+::
diff --git a/docs/4.api/1.components/6.nuxt-error-boundary.md b/docs/4.api/1.components/6.nuxt-error-boundary.md
new file mode 100644
index 000000000000..ac55feb9b2f4
--- /dev/null
+++ b/docs/4.api/1.components/6.nuxt-error-boundary.md
@@ -0,0 +1,67 @@
+---
+title: "<NuxtErrorBoundary>"
+description: The <NuxtErrorBoundary> component handles client-side errors happening in its default slot.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/components/nuxt-error-boundary.vue
+ size: xs
+---
+
+::tip
+The `<NuxtErrorBoundary>` uses Vue's [`onErrorCaptured`](https://vuejs.org/api/composition-api-lifecycle#onerrorcaptured) hook under the hood.
+::
+
+## Events
+
+- `@error`: Event emitted when the default slot of the component throws an error.
+
+ ```vue
+ <template>
+ <NuxtErrorBoundary @error="logSomeError">
+ <!-- ... -->
+ </NuxtErrorBoundary>
+ </template>
+ ```
+
+## Slots
+
+- `#error`: Specify a fallback content to display in case of error.
+
+ ```vue
+ <template>
+ <NuxtErrorBoundary>
+ <!-- ... -->
+ <template #error="{ error, clearError }">
+ <p>An error occurred: {{ error }}</p>
+
+ <button @click="clearError">
+ Clear error
+ </button>
+ </template>
+ </NuxtErrorBoundary>
+ </template>
+ ```
+
+:read-more{to="/docs/4.x/getting-started/error-handling"}
+
+## Examples
+
+### Accessing `error` and `clearError` in script
+
+You can access `error` and `clearError` properties within the component's script as below:
+
+```vue
+<template>
+ <NuxtErrorBoundary ref="errorBoundary">
+ <!-- ... -->
+ </NuxtErrorBoundary>
+</template>
+
+<script setup lang="ts">
+const errorBoundary = useTemplateRef('errorBoundary')
+
+// errorBoundary.value?.error
+// errorBoundary.value?.clearError()
+</script>
+```
diff --git a/docs/4.api/1.components/7.nuxt-welcome.md b/docs/4.api/1.components/7.nuxt-welcome.md
new file mode 100644
index 000000000000..63cbc43be7df
--- /dev/null
+++ b/docs/4.api/1.components/7.nuxt-welcome.md
@@ -0,0 +1,25 @@
+---
+title: '<NuxtWelcome>'
+description: The <NuxtWelcome> component greets users in new projects made from the starter template.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/ui-templates/templates/welcome/index.html
+ size: xs
+---
+
+It includes links to the Nuxt documentation, source code, and social media accounts.
+
+```vue [app/app.vue]
+<template>
+ <NuxtWelcome />
+</template>
+```
+
+::read-more{to="https://templates.ui.nuxtjs.org/templates/welcome" target="_blank"}
+Preview the `<NuxtWelcome />` component.
+::
+
+::tip
+This component is part of [`@nuxt/ui-templates`](https://github.com/nuxt/nuxt/tree/main/packages/ui-templates) package.
+::
diff --git a/docs/4.api/1.components/8.nuxt-island.md b/docs/4.api/1.components/8.nuxt-island.md
new file mode 100644
index 000000000000..5e5c6faca812
--- /dev/null
+++ b/docs/4.api/1.components/8.nuxt-island.md
@@ -0,0 +1,81 @@
+---
+title: "<NuxtIsland>"
+description: "Nuxt provides the <NuxtIsland> component to render a non-interactive component without any client JS."
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/components/nuxt-island.ts
+ size: xs
+---
+
+When rendering an island component, the content of the island component is static, thus no JS is downloaded client-side.
+
+Changing the island component props triggers a refetch of the island component to re-render it again.
+
+::note
+Global styles of your application are sent with the response.
+::
+
+::tip
+Server only components use `<NuxtIsland>` under the hood
+::
+
+## Props
+
+- `name` : Name of the component to render.
+ - **type**: `string`
+ - **required**
+- `lazy`: Make the component non-blocking.
+ - **type**: `boolean`
+ - **default**: `false`
+- `props`: Props to send to the component to render.
+ - **type**: `Record<string, any>`
+- `source`: Remote source to call the island to render.
+ - **type**: `string`
+- **dangerouslyLoadClientComponents**: Required to load client components from a remote source.
+ - **type**: `boolean`
+ - **default**: `false`
+
+::note
+Remote islands need `experimental.componentIslands` to be `'local+remote'` in your `nuxt.config`.
+::
+
+::warning{icon="i-ph-warning-duotone"}
+Using the `source` prop to render content from a remote server is inherently dangerous. When you specify a remote `source`, you are fully trusting that server to provide safe HTML content that will be rendered directly in your application.
+
+This is similar to using `v-html` with external content - the remote server can inject any HTML, including potentially malicious content. **Only use `source` with servers you fully trust and control.**
+
+The `dangerouslyLoadClientComponents` prop controls an additional layer of risk: whether to also download and execute client components from the remote source. Even with `dangerouslyLoadClientComponents` disabled (the default), you are still trusting the remote server's HTML output.
+::
+
+::note
+Component props and context are sent as GET query parameters to enable caching. Query parameters may be visible in server access logs, CDN caches, and HTTP `Referer` headers.
+::
+
+::note
+By default, component islands are scanned from the `~/components/islands/` directory. So the `~/components/islands/MyIsland.vue` component could be rendered with `<NuxtIsland name="MyIsland" />`.
+::
+
+## Slots
+
+Slots can be passed to an island component if declared.
+
+Every slot is interactive since the parent component is the one providing it.
+
+Some slots are reserved to `NuxtIsland` for special cases.
+
+- `#fallback`: Specify the content to be rendered before the island loads (if the component is lazy) or if `NuxtIsland` fails to fetch the component.
+
+## Ref
+
+- `refresh()`
+ - **type**: `() => Promise<void>`
+ - **description**: force refetch the server component by refetching it.
+
+## Events
+
+- `error`
+ - **parameters**:
+ - **error**:
+ - **type**: `unknown`
+ - **description**: emitted when `NuxtIsland` fails to fetch the new island.
diff --git a/docs/4.api/1.components/9.nuxt-img.md b/docs/4.api/1.components/9.nuxt-img.md
new file mode 100644
index 000000000000..5b4a0759f578
--- /dev/null
+++ b/docs/4.api/1.components/9.nuxt-img.md
@@ -0,0 +1,43 @@
+---
+title: "<NuxtImg>"
+description: "Nuxt provides a <NuxtImg> component to handle automatic image optimization."
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/image/blob/main/src/runtime/components/NuxtImg.vue
+ size: xs
+---
+
+`<NuxtImg>` is a drop-in replacement for the native `<img>` tag.
+
+- Uses built-in provider to optimize local and remote images
+- Converts `src` to provider-optimized URLs
+- Automatically resizes images based on `width` and `height`
+- Generates responsive sizes when providing `sizes` option
+- Supports native lazy loading as well as other `<img>` attributes
+
+## Setup
+
+In order to use `<NuxtImg>` you should install and enable the Nuxt Image module:
+
+```bash [Terminal]
+npx nuxt module add image
+```
+
+## Usage
+
+`<NuxtImg>` outputs a native `img` tag directly (without any wrapper around it). Use it like you would use the `<img>` tag:
+
+```html
+<NuxtImg src="/nuxt-icon.png" />
+```
+
+Will result in:
+
+```html
+<img src="/nuxt-icon.png" />
+```
+
+::read-more{to="https://image.nuxt.com/usage/nuxt-img" target="_blank"}
+Read more about the `<NuxtImg>` component.
+::
diff --git a/docs/4.api/2.composables/.navigation.yml b/docs/4.api/2.composables/.navigation.yml
new file mode 100644
index 000000000000..853ab6a3c1b8
--- /dev/null
+++ b/docs/4.api/2.composables/.navigation.yml
@@ -0,0 +1,3 @@
+title: 'Composables'
+titleTemplate: '%s · Nuxt Composables'
+icon: i-lucide-arrow-left-right
diff --git a/docs/4.api/2.composables/create-use-async-data.md b/docs/4.api/2.composables/create-use-async-data.md
new file mode 100644
index 000000000000..d3394c41fd00
--- /dev/null
+++ b/docs/4.api/2.composables/create-use-async-data.md
@@ -0,0 +1,90 @@
+---
+title: 'createUseAsyncData'
+description: A factory function to create a custom useAsyncData composable with pre-defined default options.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/asyncData.ts
+ size: xs
+---
+
+`createUseAsyncData` creates a custom [`useAsyncData`](/docs/4.x/api/composables/use-async-data) composable with pre-defined options. The resulting composable is fully typed and works exactly like `useAsyncData`, but with your defaults baked in.
+
+::note
+`createUseAsyncData` is a compiler macro. It must be used as an **exported** declaration in the `composables/` directory (or any directory scanned by the Nuxt compiler). Nuxt automatically injects de-duplication keys at build time.
+::
+
+## Usage
+
+```ts [app/composables/useCachedData.ts]
+export const useCachedData = createUseAsyncData({
+ getCachedData (key, nuxtApp) {
+ return nuxtApp.payload.data[key] ?? nuxtApp.static.data[key]
+ },
+})
+```
+
+```vue [app/pages/index.vue]
+<script setup lang="ts">
+const { data: mountains } = await useCachedData(
+ 'mountains',
+ () => $fetch('https://api.nuxtjs.dev/mountains'),
+)
+</script>
+```
+
+The resulting composable has the same signature and return type as [`useAsyncData`](/docs/4.x/api/composables/use-async-data), with all options available for the caller to use or override.
+
+## Type
+
+```ts [Signature]
+function createUseAsyncData (
+ options?: Partial<AsyncDataOptions>,
+): typeof useAsyncData
+
+function createUseAsyncData (
+ options: (callerOptions: AsyncDataOptions) => Partial<AsyncDataOptions>,
+): typeof useAsyncData
+```
+
+## Options
+
+`createUseAsyncData` accepts all the same options as [`useAsyncData`](/docs/4.x/api/composables/use-async-data#params), including `server`, `lazy`, `immediate`, `default`, `transform`, `pick`, `getCachedData`, `deep`, `dedupe`, `timeout`, and `watch`.
+
+See the full list of options in the [`useAsyncData` documentation](/docs/4.x/api/composables/use-async-data#params).
+
+## Default vs Override Mode
+
+### Default Mode (plain object)
+
+When you pass a plain object, the factory options act as **defaults**. Callers can override any option:
+
+```ts [app/composables/useLazyData.ts]
+export const useLazyData = createUseAsyncData({
+ lazy: true,
+ server: false,
+})
+```
+
+```ts
+// Uses the defaults (lazy: true, server: false)
+const { data } = await useLazyData('key', () => fetchSomeData())
+
+// Caller overrides server to true
+const { data } = await useLazyData('key', () => fetchSomeData(), { server: true })
+```
+
+### Override Mode (function)
+
+When you pass a function, the factory options **override** the caller's options. The function receives the caller's options as its argument:
+
+```ts [app/composables/useStrictData.ts]
+// deep is always enforced as false
+export const useStrictData = createUseAsyncData(callerOptions => ({
+ deep: false,
+}))
+```
+
+:read-more{to="/docs/4.x/guide/recipes/custom-usefetch"}
+
+:read-more{to="/docs/4.x/api/composables/use-async-data"}
diff --git a/docs/4.api/2.composables/create-use-fetch.md b/docs/4.api/2.composables/create-use-fetch.md
new file mode 100644
index 000000000000..c9ba202f840c
--- /dev/null
+++ b/docs/4.api/2.composables/create-use-fetch.md
@@ -0,0 +1,102 @@
+---
+title: 'createUseFetch'
+description: A factory function to create a custom useFetch composable with pre-defined default options.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/fetch.ts
+ size: xs
+---
+
+`createUseFetch` creates a custom [`useFetch`](/docs/4.x/api/composables/use-fetch) composable with pre-defined options. The resulting composable is fully typed and works exactly like `useFetch`, but with your defaults baked in.
+
+::note
+`createUseFetch` is a compiler macro. It must be used as an **exported** declaration in the `composables/` directory (or any directory scanned by the Nuxt compiler). Nuxt automatically injects de-duplication keys at build time.
+::
+
+## Usage
+
+```ts [app/composables/useAPI.ts]
+export const useAPI = createUseFetch({
+ baseURL: 'https://api.nuxt.com',
+})
+```
+
+```vue [app/pages/modules.vue]
+<script setup lang="ts">
+const { data: modules } = await useAPI('/modules')
+</script>
+```
+
+The resulting `useAPI` composable has the same signature and return type as [`useFetch`](/docs/4.x/api/composables/use-fetch), with all options available for the caller to use or override.
+
+## Type
+
+```ts [Signature]
+function createUseFetch (
+ options?: Partial<UseFetchOptions>,
+): typeof useFetch
+
+function createUseFetch (
+ options: (callerOptions: UseFetchOptions) => Partial<UseFetchOptions>,
+): typeof useFetch
+```
+
+## Options
+
+`createUseFetch` accepts all the same options as [`useFetch`](/docs/4.x/api/composables/use-fetch#parameters), including `baseURL`, `headers`, `query`, `onRequest`, `onResponse`, `server`, `lazy`, `transform`, `getCachedData`, and more.
+
+See the full list of options in the [`useFetch` documentation](/docs/4.x/api/composables/use-fetch#parameters).
+
+## Default vs Override Mode
+
+### Default Mode (plain object)
+
+When you pass a plain object, the factory options act as **defaults**. Callers can override any option:
+
+```ts [app/composables/useAPI.ts]
+export const useAPI = createUseFetch({
+ baseURL: 'https://api.nuxt.com',
+ lazy: true,
+})
+```
+
+```ts
+// Uses the default baseURL
+const { data } = await useAPI('/modules')
+
+// Caller overrides the baseURL
+const { data } = await useAPI('/modules', { baseURL: 'https://other-api.com' })
+```
+
+### Override Mode (function)
+
+When you pass a function, the factory options **override** the caller's options. The function receives the caller's options as its argument, so you can read them to compute your overrides:
+
+```ts [app/composables/useAPI.ts]
+// baseURL is always enforced, regardless of what the caller passes
+export const useAPI = createUseFetch(callerOptions => ({
+ baseURL: 'https://api.nuxt.com',
+}))
+```
+
+This is useful for enforcing settings like authentication headers or a specific base URL that should not be changed by the caller.
+
+## Combining with a Custom `$fetch`
+
+You can pass a custom `$fetch` instance to `createUseFetch`:
+
+```ts [app/composables/useAPI.ts]
+export const useAPI = createUseFetch(callerOptions => ({
+ $fetch: useNuxtApp().$api as typeof $fetch,
+ ...callerOptions,
+}))
+```
+
+::important
+The **function signature** (override mode) is required here so that [`useNuxtApp()`](/docs/4.x/api/composables/use-nuxt-app) is called in the setup context (at the composable call site) rather than in the module scope, where no Nuxt instance is available.
+::
+
+:read-more{to="/docs/4.x/guide/recipes/custom-usefetch"}
+
+:read-more{to="/docs/4.x/api/composables/use-fetch"}
diff --git a/docs/4.api/2.composables/on-prehydrate.md b/docs/4.api/2.composables/on-prehydrate.md
new file mode 100644
index 000000000000..17de452e983b
--- /dev/null
+++ b/docs/4.api/2.composables/on-prehydrate.md
@@ -0,0 +1,69 @@
+---
+title: "onPrehydrate"
+description: "Use onPrehydrate to run a callback on the client immediately before Nuxt hydrates the page."
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/ssr.ts
+ size: xs
+---
+
+::important
+This composable is available in Nuxt v3.12+.
+::
+
+`onPrehydrate` is a composable lifecycle hook that allows you to run a callback on the client immediately before Nuxt hydrates the page.
+::note
+This is an advanced utility and should be used with care. For example, [`nuxt-time`](https://github.com/danielroe/nuxt-time/pull/251) and [`@nuxtjs/color-mode`](https://github.com/nuxt-modules/color-mode/blob/main/src/script.js) manipulate the DOM to avoid hydration mismatches.
+::
+
+## Usage
+
+Call `onPrehydrate` in the setup function of a Vue component (e.g., in `<script setup>`) or in a plugin. It only has an effect when called on the server and will not be included in your client build.
+
+## Type
+
+```ts [Signature]
+export function onPrehydrate (callback: (el: HTMLElement) => void): void
+export function onPrehydrate (callback: string | ((el: HTMLElement) => void), key?: string): undefined | string
+```
+
+## Parameters
+
+| Parameter | Type | Required | Description |
+| ---- | --- | --- | --- |
+| `callback` | `((el: HTMLElement) => void) \| string` | Yes | A function (or stringified function) to run before Nuxt hydrates. It will be stringified and inlined in the HTML. Should not have external dependencies or reference variables outside the callback. Runs before Nuxt runtime initializes, so it should not rely on Nuxt or Vue context. |
+| `key` | `string` | No | (Advanced) A unique key to identify the prehydrate script, useful for advanced scenarios like multiple root nodes. |
+
+## Return Values
+
+- Returns `undefined` when called with only a callback function.
+- Returns a string (the prehydrate id) when called with a callback and a key, which can be used to set or access the `data-prehydrate-id` attribute for advanced use cases.
+
+## Example
+
+```vue twoslash [app/app.vue]
+<script setup lang="ts">
+declare const window: Window
+// ---cut---
+// Run code before Nuxt hydrates
+onPrehydrate(() => {
+ console.log(window)
+})
+
+// Access the root element
+onPrehydrate((el) => {
+ console.log(el.outerHTML)
+ // <div data-v-inspector="app.vue:15:3" data-prehydrate-id=":b3qlvSiBeH:"> Hi there </div>
+})
+
+// Advanced: access/set `data-prehydrate-id` yourself
+const prehydrateId = onPrehydrate((el) => {})
+</script>
+
+<template>
+ <div>
+ Hi there
+ </div>
+</template>
+```
diff --git a/docs/4.api/2.composables/use-announcer.md b/docs/4.api/2.composables/use-announcer.md
new file mode 100644
index 000000000000..906e540caa1e
--- /dev/null
+++ b/docs/4.api/2.composables/use-announcer.md
@@ -0,0 +1,128 @@
+---
+title: 'useAnnouncer'
+description: A composable for announcing messages to screen readers.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/announcer.ts
+ size: xs
+---
+
+::important
+This composable is available in Nuxt v4.4.2+.
+::
+
+## Description
+
+A composable for announcing dynamic content changes to screen readers. Unlike [`useRouteAnnouncer`](/docs/api/composables/use-route-announcer) which automatically announces route changes, `useAnnouncer` gives you manual control over what and when to announce.
+
+Use this for in-page updates like form validation, async operations, toast notifications, and live content changes.
+
+## Parameters
+
+- `politeness`: Sets the default urgency for screen reader announcements: `off` (disable the announcement), `polite` (waits for silence), or `assertive` (interrupts immediately). (default `polite`)
+
+## Properties
+
+### `message`
+
+- **type**: `Ref<string>`
+- **description**: The current message to announce
+
+### `politeness`
+
+- **type**: `Ref<'polite' | 'assertive' | 'off'>`
+- **description**: Screen reader announcement urgency level
+
+## Methods
+
+### `set(message, politeness = "polite")`
+
+Sets the message to announce with its urgency level.
+
+### `polite(message)`
+
+Sets the message with `politeness = "polite"`. Use for non-urgent updates that can wait for the screen reader to finish its current task.
+
+### `assertive(message)`
+
+Sets the message with `politeness = "assertive"`. Use for urgent updates that should interrupt the screen reader immediately.
+
+## Example
+
+```vue [app/pages/contact.vue]
+<script setup lang="ts">
+const { polite, assertive } = useAnnouncer()
+
+async function submitForm () {
+ try {
+ await $fetch('/api/contact', { method: 'POST', body: formData })
+ polite('Message sent successfully')
+ } catch (error) {
+ assertive('Error: Failed to send message')
+ }
+}
+</script>
+```
+
+## Use Cases
+
+### Form Validation
+
+```vue [app/components/LoginForm.vue]
+<script setup lang="ts">
+const { assertive } = useAnnouncer()
+
+function validateForm () {
+ const errors = []
+ if (!email.value) { errors.push('Email is required') }
+ if (!password.value) { errors.push('Password is required') }
+
+ if (errors.length) {
+ assertive(`Form has ${errors.length} errors: ${errors.join(', ')}`)
+ return false
+ }
+ return true
+}
+</script>
+```
+
+### Loading States
+
+```vue [app/pages/dashboard.vue]
+<script setup lang="ts">
+const { polite } = useAnnouncer()
+
+const { data, status } = await useFetch('/api/data')
+
+watch(status, (newStatus) => {
+ if (newStatus === 'pending') {
+ polite('Loading data...')
+ } else if (newStatus === 'success') {
+ polite('Data loaded successfully')
+ }
+})
+</script>
+```
+
+### Search Results
+
+```vue [app/components/Search.vue]
+<script setup lang="ts">
+const { polite } = useAnnouncer()
+
+const results = ref([])
+
+watch(results, (newResults) => {
+ polite(`Found ${newResults.length} results`)
+})
+</script>
+```
+
+::callout
+You need to add the [`<NuxtAnnouncer>`](/docs/4.x/api/components/nuxt-announcer) component to your app for the announcements to be rendered in the DOM.
+::
+
+::callout
+For automatic announcements of route/page changes, use [`useRouteAnnouncer`](/docs/4.x/api/composables/use-route-announcer) with the [`<NuxtRouteAnnouncer>`](/docs/4.x/api/components/nuxt-route-announcer) component instead.
+::
diff --git a/docs/4.api/2.composables/use-app-config.md b/docs/4.api/2.composables/use-app-config.md
new file mode 100644
index 000000000000..32d46506f2d3
--- /dev/null
+++ b/docs/4.api/2.composables/use-app-config.md
@@ -0,0 +1,19 @@
+---
+title: 'useAppConfig'
+description: 'Access the reactive app config defined in the project.'
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/config.ts
+ size: xs
+---
+
+## Usage
+
+```ts
+const appConfig = useAppConfig()
+
+console.log(appConfig)
+```
+
+:read-more{to="/docs/4.x/directory-structure/app/app-config"}
diff --git a/docs/4.api/2.composables/use-async-data.md b/docs/4.api/2.composables/use-async-data.md
new file mode 100644
index 000000000000..b55ddc98a102
--- /dev/null
+++ b/docs/4.api/2.composables/use-async-data.md
@@ -0,0 +1,283 @@
+---
+title: 'useAsyncData'
+description: useAsyncData provides access to data that resolves asynchronously in an SSR-friendly composable.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/asyncData.ts
+ size: xs
+---
+
+Within your pages, components, and plugins you can use useAsyncData to get access to data that resolves asynchronously.
+
+::note
+[`useAsyncData`](/docs/4.x/api/composables/use-async-data) is a composable meant to be called directly in the [Nuxt context](/docs/4.x/guide/going-further/nuxt-app#the-nuxt-context). It returns reactive composables and handles adding responses to the Nuxt payload so they can be passed from server to client **without re-fetching the data on client side** when the page hydrates.
+::
+
+## Usage
+
+```vue [app/pages/index.vue]
+<script setup lang="ts">
+const { data, status, pending, error, refresh, clear } = await useAsyncData(
+ 'mountains',
+ (_nuxtApp, { signal }) => $fetch('https://api.nuxtjs.dev/mountains', { signal }),
+)
+</script>
+```
+
+::tip{to="/docs/4.x/guide/recipes/custom-usefetch#custom-usefetch-with-createusefetch"}
+Need a custom `useAsyncData` with pre-defined defaults? Use `createUseAsyncData` to create a fully typed custom composable. See the [custom useFetch recipe](/docs/4.x/guide/recipes/custom-usefetch) for details.
+::
+
+::note
+`data`, `status`, `pending` and `error` are Vue refs and they should be accessed with `.value` when used within the `<script setup>`, while `refresh`/`execute` and `clear` are plain functions.
+::
+
+### Watch Params
+
+The built-in `watch` option allows automatically rerunning the fetcher function when any changes are detected.
+
+```vue [app/pages/index.vue]
+<script setup lang="ts">
+const page = ref(1)
+const { data: posts } = await useAsyncData(
+ 'posts',
+ (_nuxtApp, { signal }) => $fetch('https://fakeApi.com/posts', {
+ params: {
+ page: page.value,
+ },
+ signal,
+ }), {
+ watch: [page],
+ },
+)
+</script>
+```
+
+### Reactive Keys
+
+You can use a computed ref, plain ref or a getter function as the key, allowing for dynamic data fetching that automatically updates when the key changes:
+
+```vue [app/pages/[id\\].vue]
+<script setup lang="ts">
+const route = useRoute()
+const userId = computed(() => `user-${route.params.id}`)
+
+// When the route changes and userId updates, the data will be automatically refetched
+const { data: user } = useAsyncData(
+ userId,
+ () => fetchUserById(route.params.id),
+)
+</script>
+```
+
+### Make your `handler` abortable
+
+You can make your `handler` function abortable by using the `signal` provided in the second argument. This is useful for cancelling requests when they are no longer needed, such as when a user navigates away from a page. `$fetch` natively supports abort signals.
+
+```ts
+const { data, error } = await useAsyncData(
+ 'users',
+ (_nuxtApp, { signal }) => $fetch('/api/users', { signal }),
+)
+
+refresh() // will actually cancel the $fetch request (if dedupe: cancel)
+refresh() // will actually cancel the $fetch request (if dedupe: cancel)
+refresh()
+
+clear() // will cancel the latest pending handler
+```
+
+You can also pass an `AbortSignal` to the `refresh`/`execute` function to cancel individual requests manually.
+
+```ts
+const { refresh } = await useAsyncData(
+ 'users',
+ (_nuxtApp, { signal }) => $fetch('/api/users', { signal }),
+)
+let abortController: AbortController | undefined
+
+function handleUserAction () {
+ abortController = new AbortController()
+ refresh({ signal: abortController.signal })
+}
+
+function handleCancel () {
+ abortController?.abort() // aborts the ongoing refresh request
+}
+```
+
+If your `handler` function does not support abort signals, you can implement your own abort logic using the `signal` provided.
+
+```ts
+const { data, error } = await useAsyncData(
+ 'users',
+ (_nuxtApp, { signal }) => {
+ return new Promise((resolve, reject) => {
+ signal?.addEventListener('abort', () => {
+ reject(new Error('Request aborted'))
+ })
+ return Promise.resolve(callback.call(this, yourHandler)).then(resolve, reject)
+ })
+ },
+)
+```
+
+The handler signal will be aborted when:
+
+- A new request is made with `dedupe: 'cancel'`
+- The `clear` function is called
+- The `options.timeout` duration is exceeded
+
+::warning
+[`useAsyncData`](/docs/4.x/api/composables/use-async-data) is a reserved function name transformed by the compiler, so you should not name your own function [`useAsyncData`](/docs/4.x/api/composables/use-async-data).
+::
+
+:read-more{to="/docs/4.x/getting-started/data-fetching#useasyncdata"}
+
+## Params
+
+- `key`: a unique key to ensure that data fetching can be properly de-duplicated across requests. If you do not provide a key, then a key that is unique to the file name and line number of the instance of `useAsyncData` will be generated for you.
+- `handler`: an asynchronous function that must return a truthy value (for example, it should not be `undefined` or `null`) or the request may be duplicated on the client side.
+::warning
+The `handler` function should be **side-effect free** to ensure predictable behavior during SSR and CSR hydration. If you need to trigger side effects, use the [`callOnce`](/docs/4.x/api/utils/call-once) utility to do so.
+::
+- `options`:
+ - `server`: whether to fetch the data on the server (defaults to `true`)
+ - `lazy`: whether to resolve the async function after loading the route, instead of blocking client-side navigation (defaults to `false`)
+ - `immediate`: when set to `false`, will prevent the request from firing immediately. (defaults to `true`)
+ - `default`: a factory function to set the default value of the `data`, before the async function resolves - useful with the `lazy: true` or `immediate: false` option
+ - `transform`: a function that can be used to alter `handler` function result after resolving
+ - `getCachedData`: Provide a function which returns cached data. An `undefined` return value will trigger a fetch. By default, this is:
+ ```ts
+ const getDefaultCachedData = (key, nuxtApp, ctx) => nuxtApp.isHydrating
+ ? nuxtApp.payload.data[key]
+ : nuxtApp.static.data[key]
+ ```
+ Which only caches data when `experimental.payloadExtraction` of `nuxt.config` is enabled.
+ - `pick`: only pick specified keys in this array from the `handler` function result
+ - `watch`: watch reactive sources to auto-refresh
+ - `deep`: return data in a deep ref object. It is `false` by default to return data in a shallow ref object, which can improve performance if your data does not need to be deeply reactive.
+ - `dedupe`: avoid fetching same key more than once at a time (defaults to `cancel`). Possible options:
+ - `cancel` - cancels existing requests when a new one is made
+ - `defer` - does not make new requests at all if there is a pending request
+ - `timeout` - a number in milliseconds to wait before timing out the request (defaults to `undefined`, which means no timeout)
+
+::note
+Under the hood, `lazy: false` uses `<Suspense>` to block the loading of the route before the data has been fetched. Consider using `lazy: true` and implementing a loading state instead for a snappier user experience.
+::
+
+::read-more{to="/docs/4.x/api/composables/use-lazy-async-data"}
+You can use `useLazyAsyncData` to have the same behavior as `lazy: true` with `useAsyncData`.
+::
+
+:video-accordion{title="Watch a video from Alexander Lichter about client-side caching with getCachedData" videoId="aQPR0xn-MMk"}
+
+### Shared State and Option Consistency
+
+When using the same key for multiple `useAsyncData` calls, they will share the same `data`, `error`, `status` and `pending` refs. This ensures consistency across components but requires option consistency.
+
+The following options **must be consistent** across all calls with the same key:
+- `handler` function
+- `deep` option
+- `transform` function
+- `pick` array
+- `getCachedData` function
+- `default` value
+
+The following options **can differ** without triggering warnings:
+- `server`
+- `lazy`
+- `immediate`
+- `dedupe`
+- `watch`
+
+```ts
+// ❌ This will trigger a development warning
+const { data: users1 } = useAsyncData('users', (_nuxtApp, { signal }) => $fetch('/api/users', { signal }), { deep: false })
+const { data: users2 } = useAsyncData('users', (_nuxtApp, { signal }) => $fetch('/api/users', { signal }), { deep: true })
+
+// ✅ This is allowed
+const { data: users1 } = useAsyncData('users', (_nuxtApp, { signal }) => $fetch('/api/users', { signal }), { immediate: true })
+const { data: users2 } = useAsyncData('users', (_nuxtApp, { signal }) => $fetch('/api/users', { signal }), { immediate: false })
+```
+
+::tip
+Keyed state created using `useAsyncData` can be retrieved across your Nuxt application using [`useNuxtData`](/docs/4.x/api/composables/use-nuxt-data).
+::
+
+## Return Values
+
+- `data`: the result of the asynchronous function that is passed in.
+- `refresh`/`execute`: a function that can be used to refresh the data returned by the `handler` function.
+- `error`: an error object if the data fetching failed.
+- `status`: a string indicating the status of the data request:
+ - `idle`: when the request has not started, such as:
+ - when `execute` has not yet been called and `{ immediate: false }` is set
+ - when rendering HTML on the server and `{ server: false }` is set
+ - `pending`: the request is in progress
+ - `success`: the request has completed successfully
+ - `error`: the request has failed
+- `pending`: a `Ref<boolean>` that is `true` while the request is in progress (that is, while `status.value === 'pending'`).
+- `clear`: a function that can be used to set `data` to `undefined` (or the value of `options.default()` if provided), set `error` to `undefined`, set `status` to `idle`, and mark any currently pending requests as cancelled.
+
+By default, Nuxt waits until a `refresh` is finished before it can be executed again.
+
+::note
+If you have not fetched data on the server (for example, with `server: false`), then the data _will not_ be fetched until hydration completes. This means even if you await [`useAsyncData`](/docs/4.x/api/composables/use-async-data) on the client side, `data` will remain `undefined` within `<script setup>`.
+::
+
+## Type
+
+```ts [Signature]
+export type AsyncDataHandler<ResT> = (nuxtApp: NuxtApp, options: { signal: AbortSignal }) => Promise<ResT>
+
+export function useAsyncData<DataT, DataE> (
+ handler: AsyncDataHandler<DataT>,
+ options?: AsyncDataOptions<DataT>,
+): AsyncData<DataT, DataE>
+export function useAsyncData<DataT, DataE> (
+ key: MaybeRefOrGetter<string>,
+ handler: AsyncDataHandler<DataT>,
+ options?: AsyncDataOptions<DataT>,
+): Promise<AsyncData<DataT, DataE>>
+
+type AsyncDataOptions<DataT> = {
+ server?: boolean
+ lazy?: boolean
+ immediate?: boolean
+ deep?: boolean
+ dedupe?: 'cancel' | 'defer'
+ default?: () => DataT | Ref<DataT> | null
+ transform?: (input: DataT) => DataT | Promise<DataT>
+ pick?: string[]
+ watch?: MultiWatchSources | false
+ getCachedData?: (key: string, nuxtApp: NuxtApp, ctx: AsyncDataRequestContext) => DataT | undefined
+ timeout?: number
+}
+
+type AsyncDataRequestContext = {
+ /** The reason for this data request */
+ cause: 'initial' | 'refresh:manual' | 'refresh:hook' | 'watch'
+}
+
+type AsyncData<DataT, ErrorT> = {
+ data: Ref<DataT | undefined>
+ refresh: (opts?: AsyncDataExecuteOptions) => Promise<void>
+ execute: (opts?: AsyncDataExecuteOptions) => Promise<void>
+ clear: () => void
+ error: Ref<ErrorT | undefined>
+ status: Ref<AsyncDataRequestStatus>
+ pending: Ref<boolean>
+}
+
+interface AsyncDataExecuteOptions {
+ dedupe?: 'cancel' | 'defer'
+ timeout?: number
+ signal?: AbortSignal
+}
+
+type AsyncDataRequestStatus = 'idle' | 'pending' | 'success' | 'error'
+```
+
+:read-more{to="/docs/4.x/getting-started/data-fetching"}
diff --git a/docs/4.api/2.composables/use-cookie.md b/docs/4.api/2.composables/use-cookie.md
new file mode 100644
index 000000000000..188cffc30b1f
--- /dev/null
+++ b/docs/4.api/2.composables/use-cookie.md
@@ -0,0 +1,207 @@
+---
+title: 'useCookie'
+description: useCookie is an SSR-friendly composable to read and write cookies.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/cookie.ts
+ size: xs
+---
+
+## Usage
+
+Within your pages, components, and plugins, you can use `useCookie` to read and write cookies in an SSR-friendly way.
+
+```ts
+const cookie = useCookie(name, options)
+```
+
+::note
+`useCookie` only works in the [Nuxt context](/docs/4.x/guide/going-further/nuxt-app#the-nuxt-context).
+::
+
+::tip
+The returned ref will automatically serialize and deserialize cookie values to JSON.
+::
+
+## Type
+
+```ts [Signature]
+import type { Ref } from 'vue'
+import type { CookieParseOptions, CookieSerializeOptions } from 'cookie-es'
+
+export interface CookieOptions<T = any> extends Omit<CookieSerializeOptions & CookieParseOptions, 'decode' | 'encode'> {
+ decode?(value: string): T
+ encode?(value: T): string
+ default?: () => T | Ref<T>
+ watch?: boolean | 'shallow'
+ readonly?: boolean
+ refresh?: boolean
+}
+
+export interface CookieRef<T> extends Ref<T> {}
+
+export function useCookie<T = string | null | undefined> (
+ name: string,
+ options?: CookieOptions<T>,
+): CookieRef<T>
+```
+
+## Parameters
+
+`name`: The name of the cookie.
+
+`options`: Options to control cookie behavior. The object can have the following properties:
+
+Most of the options will be directly passed to the [cookie](https://github.com/jshttp/cookie) package.
+
+| Property | Type | Default | Description |
+|---------------|------------------------|----------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `decode` | `(value: string) => T` | `decodeURIComponent` + [destr](https://github.com/unjs/destr). | Custom function to decode the cookie value. Since the value of a cookie has a limited character set (and must be a simple string), this function can be used to decode a previously encoded cookie value into a JavaScript string or other object. <br/> **Note:** If an error is thrown from this function, the original, non-decoded cookie value will be returned as the cookie's value. |
+| `encode` | `(value: T) => string` | `JSON.stringify` + `encodeURIComponent` | Custom function to encode the cookie value. Since the value of a cookie has a limited character set (and must be a simple string), this function can be used to encode a value into a string suited for a cookie's value. |
+| `default` | `() => T \| Ref<T>` | `undefined` | Function returning the default value if the cookie does not exist. The function can also return a `Ref`. |
+| `watch` | `boolean \| 'shallow'` | `true` | Whether to watch for changes and update the cookie. `true` for deep watch, `'shallow'` for shallow watch, i.e. data changes for only top level properties, `false` to disable. <br/> **Note:** Refresh `useCookie` values manually when a cookie has changed with [`refreshCookie`](/docs/4.x/api/utils/refresh-cookie). |
+| `refresh` | `boolean` | `false` | If `true`, the cookie expiration will be refreshed on every explicit write (e.g. `cookie.value = cookie.value`), even if the value itself hasn’t changed. Note: the expiration is not refreshed automatically — you must assign to `.value` to trigger it. |
+| `readonly` | `boolean` | `false` | If `true`, disables writing to the cookie. |
+| `maxAge` | `number` | `undefined` | Max age in seconds for the cookie, i.e. the value for the [`Max-Age` `Set-Cookie` attribute](https://datatracker.ietf.org/doc/html/rfc6265#section-5.2.2). The given number will be converted to an integer by rounding down. By default, no maximum age is set. |
+| `expires` | `Date` | `undefined` | Expiration date for the cookie. By default, no expiration is set. Most clients will consider this a "non-persistent cookie" and will delete it on a condition like exiting a web browser application. <br/> **Note:** The [cookie storage model specification](https://datatracker.ietf.org/doc/html/rfc6265#section-5.3) states that if both `expires` and `maxAge` is set, then `maxAge` takes precedence, but not all clients may obey this, so if both are set, they should point to the same date and time! <br/>If neither of `expires` and `maxAge` is set, the cookie will be session-only and removed when the user closes their browser. |
+| `httpOnly` | `boolean` | `false` | Sets the HttpOnly attribute. <br/> **Note:** Be careful when setting this to `true`, as compliant clients will not allow client-side JavaScript to see the cookie in `document.cookie`. |
+| `secure` | `boolean` | `false` | Sets the [`Secure` `Set-Cookie` attribute](https://datatracker.ietf.org/doc/html/rfc6265#section-5.2.5). <br/>**Note:** Be careful when setting this to `true`, as compliant clients will not send the cookie back to the server in the future if the browser does not have an HTTPS connection. This can lead to hydration errors. |
+| `partitioned` | `boolean` | `false` | Sets the [`Partitioned` `Set-Cookie` attribute](https://datatracker.ietf.org/doc/html/draft-cutler-httpbis-partitioned-cookies#section-2.1). <br/>**Note:** This is an attribute that has not yet been fully standardized, and may change in the future. <br/>This also means many clients may ignore this attribute until they understand it.<br/>More information can be found in the [proposal](https://github.com/privacycg/CHIPS). |
+| `domain` | `string` | `undefined` | Sets the [`Domain` `Set-Cookie` attribute](https://datatracker.ietf.org/doc/html/rfc6265#section-5.2.3). By default, no domain is set, and most clients will consider applying the cookie only to the current domain. |
+| `path` | `string` | `'/'` | Sets the [`Path` `Set-Cookie` attribute](https://datatracker.ietf.org/doc/html/rfc6265#section-5.2.4). By default, the path is considered the ["default path"](https://datatracker.ietf.org/doc/html/rfc6265#section-5.1.4). |
+| `sameSite` | `boolean \| string` | `undefined` | Sets the [`SameSite` `Set-Cookie` attribute](https://datatracker.ietf.org/doc/html/draft-ietf-httpbis-rfc6265bis-03#section-4.1.2.7). <br/>- `true` will set the `SameSite` attribute to `Strict` for strict same-site enforcement.<br/>- `false` will not set the `SameSite` attribute.<br/>- `'lax'` will set the `SameSite` attribute to `Lax` for lax same-site enforcement.<br/>- `'none'` will set the `SameSite` attribute to `None` for an explicit cross-site cookie.<br/>- `'strict'` will set the `SameSite` attribute to `Strict` for strict same-site enforcement. |
+
+## Return Values
+
+Returns a Vue `Ref<T>` representing the cookie value. Updating the ref will update the cookie (unless `readonly` is set). The ref is SSR-friendly and will work on both client and server.
+
+## Examples
+
+### Basic Usage
+
+The example below creates a cookie called `counter`. If the cookie doesn't exist, it is initially set to a random value. Whenever we update the `counter` variable, the cookie will be updated accordingly.
+
+```vue [app/app.vue]
+<script setup lang="ts">
+const counter = useCookie('counter')
+
+counter.value ||= Math.round(Math.random() * 1000)
+</script>
+
+<template>
+ <div>
+ <h1>Counter: {{ counter || '-' }}</h1>
+ <button @click="counter = null">
+ reset
+ </button>
+ <button @click="counter--">
+ -
+ </button>
+ <button @click="counter++">
+ +
+ </button>
+ </div>
+</template>
+```
+
+### Readonly Cookies
+
+```vue
+<script setup lang="ts">
+const user = useCookie(
+ 'userInfo',
+ {
+ default: () => ({ score: -1 }),
+ watch: false,
+ },
+)
+
+if (user.value) {
+ // the actual `userInfo` cookie will not be updated
+ user.value.score++
+}
+</script>
+
+<template>
+ <div>User score: {{ user?.score }}</div>
+</template>
+```
+
+### Writable Cookies
+
+```vue
+<script setup lang="ts">
+const list = useCookie(
+ 'list',
+ {
+ default: () => [],
+ watch: 'shallow',
+ },
+)
+
+function add () {
+ list.value?.push(Math.round(Math.random() * 1000))
+ // list cookie won't be updated with this change
+}
+
+function save () {
+ // the actual `list` cookie will be updated
+ list.value &&= [...list.value]
+}
+</script>
+
+<template>
+ <div>
+ <h1>List</h1>
+ <pre>{{ list }}</pre>
+ <button @click="add">
+ Add
+ </button>
+ <button @click="save">
+ Save
+ </button>
+ </div>
+</template>
+```
+
+### Refreshing Cookies
+
+```vue
+<script setup lang="ts">
+const session = useCookie(
+ 'session', {
+ maxAge: 60 * 60, // 1 hour
+ refresh: true,
+ default: () => 'active',
+ })
+
+// Even if the value does not change,
+// the cookie expiration will be refreshed
+// every time the setter is called
+session.value = 'active'
+</script>
+
+<template>
+ <div>Session: {{ session }}</div>
+</template>
+```
+
+### Cookies in API Routes
+
+You can use `getCookie` and `setCookie` from [`h3`](https://github.com/h3js/h3) package to set cookies in server API routes.
+
+```ts [server/api/counter.ts]
+export default defineEventHandler((event) => {
+ // Read counter cookie
+ let counter = getCookie(event, 'counter') || 0
+
+ // Increase counter cookie by 1
+ setCookie(event, 'counter', ++counter)
+
+ // Send JSON response
+ return { counter }
+})
+```
+
+:link-example{to="/docs/4.x/examples/advanced/use-cookie"}
diff --git a/docs/4.api/2.composables/use-error.md b/docs/4.api/2.composables/use-error.md
new file mode 100644
index 000000000000..3b7a2760a6b8
--- /dev/null
+++ b/docs/4.api/2.composables/use-error.md
@@ -0,0 +1,55 @@
+---
+title: "useError"
+description: useError composable returns the global Nuxt error that is being handled.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/error.ts
+ size: xs
+---
+
+## Usage
+
+The `useError` composable returns the global Nuxt error that is being handled and is available on both client and server. It provides a reactive, SSR-friendly error state across your app.
+
+```ts
+const error = useError()
+```
+
+You can use this composable in your components, pages, or plugins to access or react to the current Nuxt error.
+
+## Type
+
+```ts
+interface NuxtError<DataT = unknown> {
+ status: number
+ statusText: string
+ message: string
+ data?: DataT
+ error?: true
+}
+
+export const useError: () => Ref<NuxtError | undefined>
+```
+
+## Parameters
+
+This composable does not take any parameters.
+
+## Return Values
+
+Returns a `Ref` containing the current Nuxt error (or `undefined` if there is no error). The error object is reactive and will update automatically when the error state changes.
+
+## Example
+
+```vue
+<script setup lang="ts">
+const error = useError()
+
+if (error.value) {
+ console.error('Nuxt error:', error.value)
+}
+</script>
+```
+
+:read-more{to="/docs/4.x/getting-started/error-handling"}
diff --git a/docs/4.api/2.composables/use-fetch.md b/docs/4.api/2.composables/use-fetch.md
new file mode 100644
index 000000000000..0ae9a3193cde
--- /dev/null
+++ b/docs/4.api/2.composables/use-fetch.md
@@ -0,0 +1,250 @@
+---
+title: 'useFetch'
+description: 'Fetch data from an API endpoint with an SSR-friendly composable.'
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/fetch.ts
+ size: xs
+---
+
+This composable provides a convenient wrapper around [`useAsyncData`](/docs/4.x/api/composables/use-async-data) and [`$fetch`](/docs/4.x/api/utils/dollarfetch).
+It automatically generates a key based on URL and fetch options, provides type hints for request url based on server routes, and infers API response type.
+
+::note
+`useFetch` is a composable meant to be called directly in a setup function, plugin, or route middleware. It returns reactive composables and handles adding responses to the Nuxt payload so they can be passed from server to client without re-fetching the data on client side when the page hydrates.
+::
+
+## Usage
+
+```vue [app/pages/modules.vue]
+<script setup lang="ts">
+const { data, status, error, refresh, clear } = await useFetch('/api/modules', {
+ pick: ['title'],
+})
+</script>
+```
+
+::tip{to="/docs/4.x/guide/recipes/custom-usefetch#custom-usefetch-with-createusefetch"}
+Need a custom `useFetch` with pre-defined defaults (like `baseURL` or auth headers)? Use `createUseFetch` to create a fully typed custom composable.
+::
+
+::note
+`data`, `status`, and `error` are Vue refs, and they should be accessed with `.value` when used within the `<script setup>`, while `refresh`/`execute` and `clear` are plain functions.
+::
+
+Using the `query` option, you can add search parameters to your query. This option is extended from [unjs/ofetch](https://github.com/unjs/ofetch) and is using [unjs/ufo](https://github.com/unjs/ufo) to create the URL. Objects are automatically stringified.
+
+```ts
+const param1 = ref('value1')
+const { data, status, error, refresh } = await useFetch('/api/modules', {
+ query: { param1, param2: 'value2' },
+})
+```
+
+The above example results in `https://api.nuxt.com/modules?param1=value1¶m2=value2`.
+
+You can also use [interceptors](https://github.com/unjs/ofetch#%EF%B8%8F-interceptors):
+
+```ts
+const { data, status, error, refresh, clear } = await useFetch('/api/auth/login', {
+ onRequest ({ request, options }) {
+ // Set the request headers
+ // note that this relies on ofetch >= 1.4.0 - you may need to refresh your lockfile
+ options.headers.set('Authorization', '...')
+ },
+ onRequestError ({ request, options, error }) {
+ // Handle the request errors
+ },
+ onResponse ({ request, response, options }) {
+ // Process the response data
+ localStorage.setItem('token', response._data.token)
+ },
+ onResponseError ({ request, response, options }) {
+ // Handle the response errors
+ },
+})
+```
+
+### Reactive Keys and Shared State
+
+You can use a computed ref or a plain ref as the URL, allowing for dynamic data fetching that automatically updates when the URL changes:
+
+```vue [app/pages/[id\\].vue]
+<script setup lang="ts">
+const route = useRoute()
+const id = computed(() => route.params.id)
+
+// When the route changes and id updates, the data will be automatically refetched
+const { data: post } = await useFetch(() => `/api/posts/${id.value}`)
+</script>
+```
+
+When using `useFetch` with the same URL and options in multiple components, they will share the same `data`, `error` and `status` refs. This ensures consistency across components.
+
+::tip
+Keyed state created using `useFetch` can be retrieved across your Nuxt application using [`useNuxtData`](/docs/4.x/api/composables/use-nuxt-data).
+::
+
+::warning
+`useFetch` is a reserved function name transformed by the compiler, so you should not name your own function `useFetch`. To create a custom variant with pre-defined options, use [`createUseFetch`](/docs/4.x/guide/recipes/custom-usefetch#custom-usefetch-with-createusefetch) instead.
+::
+
+::warning
+If you encounter the `data` variable destructured from a `useFetch` returns a string and not a JSON parsed object then make sure your component doesn't include an import statement like `import { useFetch } from '@vueuse/core`.
+::
+
+:video-accordion{title="Watch the video from Alexander Lichter to avoid using useFetch the wrong way" videoId="njsGVmcWviY"}
+
+:read-more{to="/docs/4.x/getting-started/data-fetching"}
+
+### Reactive Fetch Options
+
+Fetch options can be provided as reactive, supporting `computed`, `ref` and [computed getters](https://vuejs.org/guide/essentials/computed). When a reactive fetch option is updated it will trigger a refetch using the updated resolved reactive value.
+
+```ts
+const searchQuery = ref('initial')
+const { data } = await useFetch('/api/search', {
+ query: { q: searchQuery },
+})
+// triggers a refetch: /api/search?q=new%20search
+searchQuery.value = 'new search'
+```
+
+If needed, you can opt out of this behavior using `watch: false`:
+
+```ts
+const searchQuery = ref('initial')
+const { data } = await useFetch('/api/search', {
+ query: { q: searchQuery },
+ watch: false,
+})
+// does not trigger a refetch
+searchQuery.value = 'new search'
+```
+
+## Type
+
+```ts [Signature]
+export function useFetch<DataT, ErrorT> (
+ url: string | Request | Ref<string | Request> | (() => string | Request),
+ options?: UseFetchOptions<DataT>,
+): Promise<AsyncData<DataT, ErrorT>>
+
+type UseFetchOptions<DataT> = {
+ key?: MaybeRefOrGetter<string>
+ method?: MaybeRefOrGetter<string>
+ query?: MaybeRefOrGetter<SearchParams>
+ params?: MaybeRefOrGetter<SearchParams>
+ body?: MaybeRefOrGetter<RequestInit['body'] | Record<string, any>>
+ headers?: MaybeRefOrGetter<Record<string, string> | [key: string, value: string][] | Headers>
+ baseURL?: MaybeRefOrGetter<string>
+ cache?: false | 'default' | 'force-cache' | 'no-cache' | 'no-store' | 'only-if-cached' | 'reload'
+ server?: boolean
+ lazy?: boolean
+ immediate?: boolean
+ getCachedData?: (key: string, nuxtApp: NuxtApp, ctx: AsyncDataRequestContext) => DataT | undefined
+ deep?: boolean
+ dedupe?: 'cancel' | 'defer'
+ timeout?: number
+ default?: () => DataT
+ transform?: (input: DataT) => DataT | Promise<DataT>
+ pick?: string[]
+ $fetch?: typeof globalThis.$fetch
+ watch?: MultiWatchSources | false
+}
+
+type AsyncDataRequestContext = {
+ /** The reason for this data request */
+ cause: 'initial' | 'refresh:manual' | 'refresh:hook' | 'watch'
+}
+
+type AsyncData<DataT, ErrorT> = {
+ data: Ref<DataT | undefined>
+ pending: Ref<boolean>
+ refresh: (opts?: AsyncDataExecuteOptions) => Promise<void>
+ execute: (opts?: AsyncDataExecuteOptions) => Promise<void>
+ clear: () => void
+ error: Ref<ErrorT | undefined>
+ status: Ref<AsyncDataRequestStatus>
+}
+
+interface AsyncDataExecuteOptions {
+ dedupe?: 'cancel' | 'defer'
+ timeout?: number
+ signal?: AbortSignal
+}
+
+type AsyncDataRequestStatus = 'idle' | 'pending' | 'success' | 'error'
+```
+
+## Parameters
+
+- `URL` (`string | Request | Ref<string | Request> | () => string | Request`): The URL or request to fetch. Can be a string, a Request object, a Vue ref, or a function returning a string/Request. Supports reactivity for dynamic endpoints.
+
+- `options` (object): Configuration for the fetch request. Extends [unjs/ofetch](https://github.com/unjs/ofetch) options and [`AsyncDataOptions`](/docs/4.x/api/composables/use-async-data#params). All options can be a static value, a `ref`, or a computed value.
+
+| Option | Type | Default | Description |
+|-----------------|-------------------------------------------------------------------------|------------|------------------------------------------------------------------------------------------------------------------|
+| `key` | `MaybeRefOrGetter<string>` | auto-gen | Unique key for de-duplication. If not provided, generated from URL and options. |
+| `method` | `MaybeRefOrGetter<string>` | `'GET'` | HTTP request method. |
+| `query` | `MaybeRefOrGetter<SearchParams>` | - | Query/search params to append to the URL. Alias: `params`. |
+| `params` | `MaybeRefOrGetter<SearchParams>` | - | Alias for `query`. |
+| `body` | `MaybeRefOrGetter<RequestInit['body'] \| Record<string, any>>` | - | Request body. Objects are automatically stringified. |
+| `headers` | `MaybeRefOrGetter<Record<string, string> \| [key, value][] \| Headers>` | - | Request headers. |
+| `baseURL` | `MaybeRefOrGetter<string>` | - | Base URL for the request. |
+| `cache` | `false \| string` | - | Cache control. Boolean disables cache, or use Fetch API values: `default`, `no-store`, etc. |
+| `server` | `boolean` | `true` | Whether to fetch on the server. |
+| `lazy` | `boolean` | `false` | If true, resolves after route loads (does not block navigation). |
+| `immediate` | `boolean` | `true` | If false, prevents request from firing immediately. |
+| `default` | `() => DataT` | - | Factory for default value of `data` before async resolves. |
+| `timeout` | `number` | - | A number in milliseconds to wait before timing out the request (defaults to `undefined`, which means no timeout) |
+| `transform` | `(input: DataT) => DataT \| Promise<DataT>` | - | Function to transform the result after resolving. |
+| `getCachedData` | `(key, nuxtApp, ctx) => DataT \| undefined` | - | Function to return cached data. See below for default. |
+| `pick` | `string[]` | - | Only pick specified keys from the result. |
+| `watch` | `MultiWatchSources \| false` | - | Array of reactive sources to watch and auto-refresh. `false` disables watching. |
+| `deep` | `boolean` | `false` | Return data in a deep ref object. |
+| `dedupe` | `'cancel' \| 'defer'` | `'cancel'` | Avoid fetching same key more than once at a time. |
+| `$fetch` | `typeof globalThis.$fetch` | - | Custom $fetch implementation. See [Custom useFetch in Nuxt](/docs/4.x/guide/recipes/custom-usefetch) |
+
+::note
+All fetch options can be given a `computed` or `ref` value. These will be watched and new requests made automatically with any new values if they are updated.
+::
+
+**getCachedData default:**
+
+```ts
+const getDefaultCachedData = (key, nuxtApp, ctx) => nuxtApp.isHydrating
+ ? nuxtApp.payload.data[key]
+ : nuxtApp.static.data[key]
+```
+This only caches data when `experimental.payloadExtraction` in `nuxt.config` is enabled.
+
+## Return Values
+
+| Name | Type | Description |
+|-----------|-----------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `data` | `Ref<DataT \| undefined>` | The result of the asynchronous fetch. |
+| `refresh` | `(opts?: AsyncDataExecuteOptions) => Promise<void>` | Function to manually refresh the data. By default, Nuxt waits until a `refresh` is finished before it can be executed again. |
+| `execute` | `(opts?: AsyncDataExecuteOptions) => Promise<void>` | Alias for `refresh`. |
+| `error` | `Ref<ErrorT \| undefined>` | Error object if the data fetching failed. |
+| `status` | `Ref<'idle' \| 'pending' \| 'success' \| 'error'>` | Status of the data request. See below for possible values. |
+| `pending` | `Ref<boolean>` | Boolean flag indicating whether the current request is in progress. |
+| `clear` | `() => void` | Resets `data` to `undefined` (or the value of `options.default()` if provided), `error` to `undefined`, set `status` to `idle`, and cancels any pending requests. |
+
+### Status values
+
+- `idle`: Request has not started (e.g. `{ immediate: false }` or `{ server: false }` on server render)
+- `pending`: Request is in progress
+- `success`: Request completed successfully
+- `error`: Request failed
+
+::note
+If you have not fetched data on the server (for example, with `server: false`), then the data _will not_ be fetched until hydration completes. This means even if you await `useFetch` on client-side, `data` will remain null within `<script setup>`.
+::
+
+### Examples
+
+:link-example{to="/docs/4.x/examples/advanced/use-custom-fetch-composable"}
+
+:link-example{to="/docs/4.x/examples/features/data-fetching"}
diff --git a/docs/4.api/2.composables/use-head-safe.md b/docs/4.api/2.composables/use-head-safe.md
new file mode 100644
index 000000000000..6a20770aede8
--- /dev/null
+++ b/docs/4.api/2.composables/use-head-safe.md
@@ -0,0 +1,72 @@
+---
+title: useHeadSafe
+description: The recommended way to provide head data with user input.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/unjs/unhead/blob/main/packages/vue/src/composables.ts
+ size: xs
+---
+
+## Usage
+
+The `useHeadSafe` composable is a wrapper around the [`useHead`](/docs/4.x/api/composables/use-head) composable that restricts the input to only allow safe values. This is the recommended way to manage head data when working with user input, as it prevents XSS attacks by sanitizing potentially dangerous attributes.
+
+::warning
+When using `useHeadSafe`, potentially dangerous attributes like `innerHTML` in scripts or `http-equiv` in meta tags are automatically stripped out to prevent XSS attacks. Use this composable whenever you're working with user-generated content.
+::
+
+## Type
+
+```ts [Signature]
+export function useHeadSafe (input: MaybeComputedRef<HeadSafe>): void
+```
+
+### Allowed Attributes
+
+The following attributes are whitelisted for each head element type:
+
+```ts
+const WhitelistAttributes = {
+ htmlAttrs: ['class', 'style', 'lang', 'dir'],
+ bodyAttrs: ['class', 'style'],
+ meta: ['name', 'property', 'charset', 'content', 'media'],
+ noscript: ['textContent'],
+ style: ['media', 'textContent', 'nonce', 'title', 'blocking'],
+ script: ['type', 'textContent', 'nonce', 'blocking'],
+ link: ['color', 'crossorigin', 'fetchpriority', 'href', 'hreflang', 'imagesrcset', 'imagesizes', 'integrity', 'media', 'referrerpolicy', 'rel', 'sizes', 'type'],
+}
+```
+
+See [@unhead/vue](https://github.com/unjs/unhead/blob/main/packages/vue/src/types/safeSchema.ts) for more detailed types.
+
+## Parameters
+
+`input`: A `MaybeComputedRef<HeadSafe>` object containing head data. You can pass all the same values as [`useHead`](/docs/4.x/api/composables/use-head), but only safe attributes will be rendered.
+
+## Return Values
+
+This composable does not return any value.
+
+## Example
+
+```vue [app/pages/user-profile.vue]
+<script setup lang="ts">
+// User-generated content that might contain malicious code
+const userBio = ref('<script>alert("xss")<' + '/script>')
+
+useHeadSafe({
+ title: `User Profile`,
+ meta: [
+ {
+ name: 'description',
+ content: userBio.value, // Safely sanitized
+ },
+ ],
+})
+</script>
+```
+
+::read-more{to="https://unhead.unjs.io/docs/typescript/head/api/composables/use-head-safe" target="_blank"}
+Read more on the `Unhead` documentation.
+::
diff --git a/docs/4.api/2.composables/use-head.md b/docs/4.api/2.composables/use-head.md
new file mode 100644
index 000000000000..f0b277b21f78
--- /dev/null
+++ b/docs/4.api/2.composables/use-head.md
@@ -0,0 +1,184 @@
+---
+title: useHead
+description: useHead customizes the head properties of individual pages of your Nuxt app.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/unjs/unhead/blob/main/packages/vue/src/composables.ts
+ size: xs
+---
+
+## Usage
+
+The `useHead` composable allows you to manage your head tags in a programmatic and reactive way, powered by [Unhead](https://unhead.unjs.io). It lets you customize the meta tags, links, scripts, and other elements in the `<head>` section of your HTML document.
+
+```vue [app/app.vue]
+<script setup lang="ts">
+useHead({
+ title: 'My App',
+ meta: [
+ { name: 'description', content: 'My amazing site.' },
+ ],
+ bodyAttrs: {
+ class: 'test',
+ },
+ script: [{ innerHTML: 'console.log(\'Hello world\')' }],
+})
+</script>
+```
+
+::warning
+If the data comes from a user or other untrusted source, we recommend you check out [`useHeadSafe`](/docs/4.x/api/composables/use-head-safe).
+::
+
+::note
+The properties of `useHead` can be dynamic, accepting `ref`, `computed` and `reactive` properties. The `meta` parameter can also accept a function returning an object to make the entire object reactive.
+::
+
+## Type
+
+```ts [Signature]
+export function useHead (meta: MaybeComputedRef<MetaObject>): ActiveHeadEntry<UseHeadInput>
+
+interface MetaObject {
+ title?: string
+ titleTemplate?: string | ((title?: string) => string)
+ base?: Base
+ link?: Link[]
+ meta?: Meta[]
+ style?: Style[]
+ script?: Script[]
+ noscript?: Noscript[]
+ htmlAttrs?: HtmlAttributes
+ bodyAttrs?: BodyAttributes
+}
+
+interface ActiveHeadEntry<Input> {
+ /**
+ * Updates the entry with new input.
+ *
+ * Will first clear any side effects for previous input.
+ */
+ patch: (input: Input) => void
+ /**
+ * Dispose the entry, removing it from the active head.
+ *
+ * Will queue side effects for removal.
+ */
+ dispose: () => void
+}
+```
+
+See [@unhead/schema](https://github.com/unjs/unhead/blob/main/packages/vue/src/types/schema.ts) for more detailed types.
+
+## Parameters
+
+`meta`: An object accepting head metadata properties to customize the page's `<head>` section. All properties support reactive values (`ref`, `computed`, `reactive`) or can be a function returning the metadata object.
+
+| Property | Type | Description |
+| --- | --- | --- |
+| `title` | `string` | Sets the page title. |
+| `titleTemplate` | `string \| ((title?: string) => string)` | Configures a dynamic template to customize the page title. Can be a string with `%s` placeholder or a function. |
+| `base` | `Base` | Sets the `<base>` tag for the document. |
+| `link` | `Link[]` | Array of link objects. Each element is mapped to a `<link>` tag, where object properties correspond to HTML attributes. |
+| `meta` | `Meta[]` | Array of meta objects. Each element is mapped to a `<meta>` tag, where object properties correspond to HTML attributes. |
+| `style` | `Style[]` | Array of style objects. Each element is mapped to a `<style>` tag, where object properties correspond to HTML attributes. |
+| `script` | `Script[]` | Array of script objects. Each element is mapped to a `<script>` tag, where object properties correspond to HTML attributes. |
+| `noscript` | `Noscript[]` | Array of noscript objects. Each element is mapped to a `<noscript>` tag, where object properties correspond to HTML attributes. |
+| `htmlAttrs` | `HtmlAttributes` | Sets attributes of the `<html>` tag. Each object property is mapped to the corresponding attribute. |
+| `bodyAttrs` | `BodyAttributes` | Sets attributes of the `<body>` tag. Each object property is mapped to the corresponding attribute. |
+
+## Return Values
+
+This composable does not return any value. It registers the head metadata with Unhead, which manages the actual DOM updates.
+
+## Examples
+
+### Basic Meta Tags
+
+```vue [app/pages/about.vue]
+<script setup lang="ts">
+useHead({
+ title: 'About Us',
+ meta: [
+ { name: 'description', content: 'Learn more about our company' },
+ { property: 'og:title', content: 'About Us' },
+ { property: 'og:description', content: 'Learn more about our company' },
+ ],
+})
+</script>
+```
+
+### Reactive Meta Tags
+
+```vue [app/pages/profile.vue]
+<script setup lang="ts">
+const profile = ref({ name: 'John Doe' })
+
+useHead({
+ title: computed(() => profile.value.name),
+ meta: [
+ {
+ name: 'description',
+ content: computed(() => `Profile page for ${profile.value.name}`),
+ },
+ ],
+})
+</script>
+```
+
+### Using a Function for Full Reactivity
+
+```vue [app/pages/dynamic.vue]
+<script setup lang="ts">
+const count = ref(0)
+
+useHead(() => ({
+ title: `Count: ${count.value}`,
+ meta: [
+ { name: 'description', content: `Current count is ${count.value}` },
+ ],
+}))
+</script>
+```
+
+### Adding External Scripts and Styles
+
+```vue [app/pages/external.vue]
+<script setup lang="ts">
+useHead({
+ link: [
+ {
+ rel: 'stylesheet',
+ href: 'https://cdn.example.com/styles.css',
+ },
+ ],
+ script: [
+ {
+ src: 'https://cdn.example.com/script.js',
+ async: true,
+ },
+ ],
+})
+</script>
+```
+
+### Body and HTML Attributes
+
+```vue [app/pages/themed.vue]
+<script setup lang="ts">
+const isDark = ref(true)
+
+useHead({
+ htmlAttrs: {
+ lang: 'en',
+ class: computed(() => isDark.value ? 'dark' : 'light'),
+ },
+ bodyAttrs: {
+ class: 'themed-page',
+ },
+})
+</script>
+```
+
+:read-more{to="/docs/4.x/getting-started/seo-meta"}
diff --git a/docs/4.api/2.composables/use-hydration.md b/docs/4.api/2.composables/use-hydration.md
new file mode 100644
index 000000000000..c5cd9d38a190
--- /dev/null
+++ b/docs/4.api/2.composables/use-hydration.md
@@ -0,0 +1,74 @@
+---
+title: 'useHydration'
+description: 'Allows full control of the hydration cycle to set and receive data from the server.'
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/hydrate.ts
+ size: xs
+---
+
+`useHydration` is a built-in composable that provides a way to set data on the server side every time a new HTTP request is made and receive that data on the client side. This way `useHydration` allows you to take full control of the hydration cycle.
+
+::note
+This is an advanced composable, primarily designed for use within plugins, mostly used by Nuxt modules.
+::
+
+::note
+`useHydration` is designed to **ensure state synchronization and restoration during SSR**. If you need to create a globally reactive state that is SSR-friendly in Nuxt, [`useState`](/docs/4.x/api/composables/use-state) is the recommended choice.
+::
+
+## Usage
+
+The data returned from the `get` function on the server is stored in `nuxtApp.payload` under the unique key provided as the first parameter to `useHydration`. During hydration, this data is then retrieved on the client, preventing redundant computations or API calls.
+
+::code-group
+
+```ts [With useHydration]
+export default defineNuxtPlugin((nuxtApp) => {
+ const myStore = new MyStore()
+
+ useHydration(
+ 'myStoreState',
+ () => myStore.getState(),
+ data => myStore.setState(data),
+ )
+})
+```
+
+```ts [Without useHydration]
+export default defineNuxtPlugin((nuxtApp) => {
+ const myStore = new MyStore()
+
+ if (import.meta.server) {
+ nuxt.hooks.hook('app:rendered', () => {
+ nuxtApp.payload.myStoreState = myStore.getState()
+ })
+ }
+
+ if (import.meta.client) {
+ nuxt.hooks.hook('app:created', () => {
+ myStore.setState(nuxtApp.payload.myStoreState)
+ })
+ }
+})
+```
+::
+
+## Type
+
+```ts [Signature]
+export function useHydration<T> (key: string, get: () => T, set: (value: T) => void): void
+```
+
+## Parameters
+
+| Parameter | Type | Description |
+| --- | --- | --- |
+| `key` | `string` | A unique key that identifies the data in your Nuxt application. |
+| `get` | `() => T` | A function executed **only on the server** (called when SSR rendering is done) to set the initial value. |
+| `set` | `(value: T) => void` | A function executed **only on the client** (called when initial Vue instance is created) to receive the data. |
+
+## Return Values
+
+This composable does not return any value.
diff --git a/docs/4.api/2.composables/use-lazy-async-data.md b/docs/4.api/2.composables/use-lazy-async-data.md
new file mode 100644
index 000000000000..400b27f1143c
--- /dev/null
+++ b/docs/4.api/2.composables/use-lazy-async-data.md
@@ -0,0 +1,96 @@
+---
+title: useLazyAsyncData
+description: This wrapper around useAsyncData triggers navigation immediately.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/asyncData.ts
+ size: xs
+---
+
+`useLazyAsyncData` provides a wrapper around [`useAsyncData`](/docs/4.x/api/composables/use-async-data) that triggers navigation before the handler is resolved by setting the `lazy` option to `true`.
+
+::note
+By default, [`useAsyncData`](/docs/4.x/api/composables/use-async-data) blocks navigation until its async handler is resolved. `useLazyAsyncData` allows navigation to occur immediately while data fetching continues in the background.
+::
+
+## Usage
+
+```vue [app/pages/index.vue]
+<script setup lang="ts">
+const { status, data: posts } = await useLazyAsyncData('posts', () => $fetch('/api/posts'))
+</script>
+
+<template>
+ <div>
+ <div v-if="status === 'pending'">
+ Loading...
+ </div>
+ <div v-else-if="status === 'error'">
+ Error loading posts
+ </div>
+ <div v-else>
+ {{ posts }}
+ </div>
+ </div>
+</template>
+```
+
+When using `useLazyAsyncData`, navigation will occur before fetching is complete. This means you must handle `pending` and `error` states directly within your component's template.
+
+::warning
+`useLazyAsyncData` is a reserved function name transformed by the compiler, so you should not name your own function `useLazyAsyncData`.
+::
+
+## Type
+
+```ts [Signature]
+export function useLazyAsyncData<DataT, ErrorT> (
+ handler: (ctx?: NuxtApp) => Promise<DataT>,
+ options?: AsyncDataOptions<DataT>,
+): AsyncData<DataT, ErrorT>
+
+export function useLazyAsyncData<DataT, ErrorT> (
+ key: string,
+ handler: (ctx?: NuxtApp) => Promise<DataT>,
+ options?: AsyncDataOptions<DataT>,
+): AsyncData<DataT, ErrorT>
+```
+
+`useLazyAsyncData` has the same signature as [`useAsyncData`](/docs/4.x/api/composables/use-async-data).
+
+## Parameters
+
+`useLazyAsyncData` accepts the same parameters as [`useAsyncData`](/docs/4.x/api/composables/use-async-data), with the `lazy` option automatically set to `true`.
+
+:read-more{to="/docs/4.x/api/composables/use-async-data#parameters"}
+
+## Return Values
+
+`useLazyAsyncData` returns the same values as [`useAsyncData`](/docs/4.x/api/composables/use-async-data).
+
+:read-more{to="/docs/4.x/api/composables/use-async-data#return-values"}
+
+## Example
+
+```vue [app/pages/index.vue]
+<script setup lang="ts">
+/* Navigation will occur before fetching is complete.
+ Handle 'pending' and 'error' states directly within your component's template
+*/
+const { status, data: count } = await useLazyAsyncData('count', () => $fetch('/api/count'))
+
+watch(count, (newCount) => {
+ // Because count might start out null, you won't have access
+ // to its contents immediately, but you can watch it.
+})
+</script>
+
+<template>
+ <div>
+ {{ status === 'pending' ? 'Loading' : count }}
+ </div>
+</template>
+```
+
+:read-more{to="/docs/4.x/getting-started/data-fetching"}
diff --git a/docs/4.api/2.composables/use-lazy-fetch.md b/docs/4.api/2.composables/use-lazy-fetch.md
new file mode 100644
index 000000000000..4d95fc09e7c7
--- /dev/null
+++ b/docs/4.api/2.composables/use-lazy-fetch.md
@@ -0,0 +1,112 @@
+---
+title: 'useLazyFetch'
+description: This wrapper around useFetch triggers navigation immediately.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/fetch.ts
+ size: xs
+---
+
+`useLazyFetch` provides a wrapper around [`useFetch`](/docs/4.x/api/composables/use-fetch) that triggers navigation before the handler is resolved by setting the `lazy` option to `true`.
+
+## Usage
+
+By default, [`useFetch`](/docs/4.x/api/composables/use-fetch) blocks navigation until its async handler is resolved. `useLazyFetch` allows navigation to proceed immediately, with data being fetched in the background.
+
+```vue [app/pages/index.vue]
+<script setup lang="ts">
+const { status, data: posts } = await useLazyFetch('/api/posts')
+</script>
+
+<template>
+ <div v-if="status === 'pending'">
+ Loading ...
+ </div>
+ <div v-else>
+ <div v-for="post in posts">
+ <!-- do something -->
+ </div>
+ </div>
+</template>
+```
+
+::note
+`useLazyFetch` has the same signature as [`useFetch`](/docs/4.x/api/composables/use-fetch).
+::
+
+::warning
+Awaiting `useLazyFetch` only ensures the call is initialized. On client-side navigation, data may not be immediately available, and you must handle the `pending` state in your component's template.
+::
+
+::warning
+`useLazyFetch` is a reserved function name transformed by the compiler, so you should not name your own function `useLazyFetch`.
+::
+
+## Type
+
+```ts [Signature]
+export function useLazyFetch<DataT, ErrorT> (
+ url: string | Request | Ref<string | Request> | (() => string | Request),
+ options?: UseFetchOptions<DataT>,
+): Promise<AsyncData<DataT, ErrorT>>
+```
+
+::note
+`useLazyFetch` is equivalent to `useFetch` with `lazy: true` option set. See [`useFetch`](/docs/4.x/api/composables/use-fetch) for full type definitions.
+::
+
+## Parameters
+
+`useLazyFetch` accepts the same parameters as [`useFetch`](/docs/4.x/api/composables/use-fetch):
+
+- `URL` (`string | Request | Ref<string | Request> | () => string | Request`): The URL or request to fetch.
+- `options` (object): Same as [`useFetch` options](/docs/4.x/api/composables/use-fetch#parameters), with `lazy` automatically set to `true`.
+
+:read-more{to="/docs/4.x/api/composables/use-fetch#parameters"}
+
+## Return Values
+
+Returns the same `AsyncData` object as [`useFetch`](/docs/4.x/api/composables/use-fetch):
+
+| Name | Type | Description |
+|-----------|-----------------------------------------------------|------------------------------------------------------------------------------------------------------------------|
+| `data` | `Ref<DataT \| undefined>` | The result of the asynchronous fetch. |
+| `refresh` | `(opts?: AsyncDataExecuteOptions) => Promise<void>` | Function to manually refresh the data. |
+| `execute` | `(opts?: AsyncDataExecuteOptions) => Promise<void>` | Alias for `refresh`. |
+| `error` | `Ref<ErrorT \| undefined>` | Error object if the data fetching failed. |
+| `status` | `Ref<'idle' \| 'pending' \| 'success' \| 'error'>` | Status of the data request. |
+| `pending` | `Ref<boolean>` | Boolean flag indicating whether the current request is in progress. |
+| `clear` | `() => void` | Resets `data` to `undefined`, `error` to `undefined`, sets `status` to `idle`, and cancels any pending requests. |
+
+:read-more{to="/docs/4.x/api/composables/use-fetch#return-values"}
+
+## Examples
+
+### Handling Pending State
+
+```vue [app/pages/index.vue]
+<script setup lang="ts">
+/* Navigation will occur before fetching is complete.
+ * Handle 'pending' and 'error' states directly within your component's template
+ */
+const { status, data: posts } = await useLazyFetch('/api/posts')
+watch(posts, (newPosts) => {
+ // Because posts might start out null, you won't have access
+ // to its contents immediately, but you can watch it.
+})
+</script>
+
+<template>
+ <div v-if="status === 'pending'">
+ Loading ...
+ </div>
+ <div v-else>
+ <div v-for="post in posts">
+ <!-- do something -->
+ </div>
+ </div>
+</template>
+```
+
+:read-more{to="/docs/4.x/getting-started/data-fetching"}
diff --git a/docs/4.api/2.composables/use-loading-indicator.md b/docs/4.api/2.composables/use-loading-indicator.md
new file mode 100644
index 000000000000..fc47959e0847
--- /dev/null
+++ b/docs/4.api/2.composables/use-loading-indicator.md
@@ -0,0 +1,77 @@
+---
+title: 'useLoadingIndicator'
+description: This composable gives you access to the loading state of the app page.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/loading-indicator.ts
+ size: xs
+---
+
+## Description
+
+A composable which returns the loading state of the page. Used by [`<NuxtLoadingIndicator>`](/docs/4.x/api/components/nuxt-loading-indicator) and controllable.
+It hooks into [`page:loading:start`](/docs/4.x/api/advanced/hooks#app-hooks-runtime) and [`page:loading:end`](/docs/4.x/api/advanced/hooks#app-hooks-runtime) to change its state.
+
+## Parameters
+
+- `duration`: Duration of the loading bar, in milliseconds (default `2000`).
+- `throttle`: Throttle the appearing and hiding, in milliseconds (default `200`).
+- `estimatedProgress`: By default Nuxt will back off as it approaches 100%. You can provide a custom function to customize the progress estimation, which is a function that receives the duration of the loading bar (above) and the elapsed time. It should return a value between 0 and 100.
+
+## Properties
+
+### `isLoading`
+
+- **type**: `Readonly<ShallowRef<boolean>>`
+- **description**: The loading state
+
+### `error`
+
+- **type**: `Readonly<ShallowRef<boolean>>`
+- **description**: The error state
+
+### `progress`
+
+- **type**: `Readonly<ShallowRef<number>>`
+- **description**: The progress state. From `0` to `100`.
+
+## Methods
+
+### `start()`
+
+Set `isLoading` to true and start to increase the `progress` value. `start` accepts a `{ force: true }` option to skip the interval and show the loading state immediately.
+
+### `set()`
+
+Set the `progress` value to a specific value. `set` accepts a `{ force: true }` option to skip the interval and show the loading state immediately.
+
+### `finish()`
+
+Set the `progress` value to `100`, stop all timers and intervals then reset the loading state `500` ms later. `finish` accepts a `{ force: true }` option to skip the interval before the state is reset, and `{ error: true }` to change the loading bar color and set the error property to true.
+
+### `clear()`
+
+Used by `finish()`. Clear all timers and intervals used by the composable.
+
+## Example
+
+```vue
+<script setup lang="ts">
+const { progress, isLoading, start, finish, clear } = useLoadingIndicator({
+ duration: 2000,
+ throttle: 200,
+ // This is how progress is calculated by default
+ estimatedProgress: (duration, elapsed) => (2 / Math.PI * 100) * Math.atan(elapsed / duration * 100 / 50),
+})
+</script>
+```
+
+```vue
+<script setup lang="ts">
+const { start, set } = useLoadingIndicator()
+// same as set(0, { force: true })
+// set the progress to 0, and show loading immediately
+start({ force: true })
+</script>
+```
diff --git a/docs/4.api/2.composables/use-nuxt-app.md b/docs/4.api/2.composables/use-nuxt-app.md
new file mode 100644
index 000000000000..de74aa0d7a76
--- /dev/null
+++ b/docs/4.api/2.composables/use-nuxt-app.md
@@ -0,0 +1,296 @@
+---
+title: 'useNuxtApp'
+description: 'Access the shared runtime context of the Nuxt Application.'
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/nuxt.ts
+ size: xs
+---
+
+`useNuxtApp` is a built-in composable that provides a way to access shared runtime context of Nuxt, also known as the [Nuxt context](/docs/4.x/guide/going-further/nuxt-app#the-nuxt-context), which is available on both client and server side (but not within Nitro routes). It helps you access the Vue app instance, runtime hooks, runtime config variables and internal states, such as `ssrContext` and `payload`.
+
+```vue [app/app.vue]
+<script setup lang="ts">
+const nuxtApp = useNuxtApp()
+</script>
+```
+
+If runtime context is unavailable in your scope, `useNuxtApp` will throw an exception when called. You can use [`tryUseNuxtApp`](/docs/4.x/api/composables/use-nuxt-app#tryusenuxtapp) instead for composables that do not require `nuxtApp`, or to simply check if context is available or not without an exception.
+
+<!--
+note
+By default, the shared runtime context of Nuxt is namespaced under the [`buildId`](/docs/4.x/api/nuxt-config#buildid) option. It allows the support of multiple runtime contexts.
+
+## Params
+
+- `appName`: an optional application name. If you do not provide it, the Nuxt `buildId` option is used. Otherwise, it must match with an existing `buildId`. -->
+
+## Methods
+
+### `provide (name, value)`
+
+`nuxtApp` is a runtime context that you can extend using [Nuxt plugins](/docs/4.x/directory-structure/app/plugins). Use the `provide` function to create Nuxt plugins to make values and helper methods available in your Nuxt application across all composables and components.
+
+`provide` function accepts `name` and `value` parameters.
+
+```ts
+const nuxtApp = useNuxtApp()
+nuxtApp.provide('hello', name => `Hello ${name}!`)
+
+// Prints "Hello name!"
+console.log(nuxtApp.$hello('name'))
+```
+
+As you can see in the example above, `$hello` has become the new and custom part of `nuxtApp` context and it is available in all places where `nuxtApp` is accessible.
+
+### `hook(name, cb)`
+
+Hooks available in `nuxtApp` allows you to customize the runtime aspects of your Nuxt application. You can use runtime hooks in Vue.js composables and [Nuxt plugins](/docs/4.x/directory-structure/app/plugins) to hook into the rendering lifecycle.
+
+`hook` function is useful for adding custom logic by hooking into the rendering lifecycle at a specific point. `hook` function is mostly used when creating Nuxt plugins.
+
+See [Runtime Hooks](/docs/4.x/api/advanced/hooks#app-hooks-runtime) for available runtime hooks called by Nuxt.
+
+```ts [app/plugins/test.ts]
+export default defineNuxtPlugin((nuxtApp) => {
+ nuxtApp.hook('page:start', () => {
+ /* your code goes here */
+ })
+ nuxtApp.hook('vue:error', (..._args) => {
+ console.log('vue:error')
+ // if (import.meta.client) {
+ // console.log(..._args)
+ // }
+ })
+})
+```
+
+### `callHook(name, ...args)`
+
+`callHook` returns a promise when called with any of the existing hooks.
+
+```ts
+await nuxtApp.callHook('my-plugin:init')
+```
+
+## Properties
+
+`useNuxtApp()` exposes the following properties that you can use to extend and customize your app and share state, data and variables.
+
+### `vueApp`
+
+`vueApp` is the global Vue.js [application instance](https://vuejs.org/api/application#application-api) that you can access through `nuxtApp`.
+
+Some useful methods:
+- [`component()`](https://vuejs.org/api/application#app-component) - Registers a global component if passing both a name string and a component definition, or retrieves an already registered one if only the name is passed.
+- [`directive()`](https://vuejs.org/api/application#app-directive) - Registers a global custom directive if passing both a name string and a directive definition, or retrieves an already registered one if only the name is passed[(example)](/docs/4.x/directory-structure/app/plugins#vue-directives).
+- [`use()`](https://vuejs.org/api/application#app-use) - Installs a **[Vue.js Plugin](https://vuejs.org/guide/reusability/plugins)** [(example)](/docs/4.x/directory-structure/app/plugins#vue-plugins).
+
+:read-more{icon="i-simple-icons-vuedotjs" to="https://vuejs.org/api/application.html#application-api"}
+
+### `ssrContext`
+
+`ssrContext` is generated during server-side rendering and it is only available on the server side.
+
+Nuxt exposes the following properties through `ssrContext`:
+- `url` (string) - Current request url.
+- `event` ([h3js/h3](https://github.com/h3js/h3) request event) - Access the request & response of the current route.
+- `payload` (object) - NuxtApp payload object.
+
+### `payload`
+
+`payload` exposes data and state variables from server side to client side. The following keys will be available on the client after they have been passed from the server side:
+
+- `serverRendered` (boolean) - Indicates if response is server-side-rendered.
+- `data` (object) - When you fetch the data from an API endpoint using either [`useFetch`](/docs/4.x/api/composables/use-fetch) or [`useAsyncData`](/docs/4.x/api/composables/use-async-data) , resulting payload can be accessed from the `payload.data`. This data is cached and helps you prevent fetching the same data in case an identical request is made more than once.
+
+ ::code-group
+ ```vue [app/app.vue]
+ <script setup lang="ts">
+ const { data } = await useAsyncData('count', (_nuxtApp, { signal }) => $fetch('/api/count', { signal }))
+ </script>
+ ```
+ ```ts [server/api/count.ts]
+ export default defineEventHandler((event) => {
+ return { count: 1 }
+ })
+ ```
+ ::
+
+ After fetching the value of `count` using [`useAsyncData`](/docs/4.x/api/composables/use-async-data) in the example above, if you access `payload.data`, you will see `{ count: 1 }` recorded there.
+
+ When accessing the same `payload.data` from [`ssrcontext`](/docs/4.x/api/composables/use-nuxt-app#ssrcontext), you can access the same value on the server side as well.
+
+- `state` (object) - When you use [`useState`](/docs/4.x/api/composables/use-state) composable in Nuxt to set shared state, this state data is accessed through `payload.state.[name-of-your-state]`.
+
+ ```ts [app/plugins/my-plugin.ts]
+ export const useColor = () => useState<string>('color', () => 'pink')
+
+ export default defineNuxtPlugin((nuxtApp) => {
+ if (import.meta.server) {
+ const color = useColor()
+ }
+ })
+ ```
+
+ It is also possible to use more advanced types, such as `ref`, `reactive`, `shallowRef`, `shallowReactive` and `NuxtError`.
+
+#### Custom Reducer/Reviver
+
+ Since [Nuxt v3.4](https://nuxt.com/blog/v3-4#payload-enhancements), it is possible to define your own reducer/reviver for types that are not supported by Nuxt.
+
+ :video-accordion{title="Watch a video from Alexander Lichter about serializing payloads, especially with regards to classes" videoId="8w6ffRBs8a4"}
+
+ In the example below, we define a reducer (or a serializer) and a reviver (or deserializer) for the [Luxon](https://moment.github.io/luxon/#/) DateTime class, using a payload plugin.
+
+ ```ts [app/plugins/date-time-payload.ts]
+ /**
+ * This kind of plugin runs very early in the Nuxt lifecycle, before we revive the payload.
+ * You will not have access to the router or other Nuxt-injected properties.
+ *
+ * Note that the "DateTime" string is the type identifier and must
+ * be the same on both the reducer and the reviver.
+ */
+ export default definePayloadPlugin((nuxtApp) => {
+ definePayloadReducer('DateTime', (value) => {
+ return value instanceof DateTime && value.toJSON()
+ })
+ definePayloadReviver('DateTime', (value) => {
+ return DateTime.fromISO(value)
+ })
+ })
+ ```
+
+### `isHydrating`
+
+Use `nuxtApp.isHydrating` (boolean) to check if the Nuxt app is hydrating on the client side.
+
+```ts [app/components/nuxt-error-boundary.ts]
+export default defineComponent({
+ setup (_props, { slots, emit }) {
+ const nuxtApp = useNuxtApp()
+ onErrorCaptured((err) => {
+ if (import.meta.client && !nuxtApp.isHydrating) {
+ // ...
+ }
+ })
+ },
+})
+```
+
+### `runWithContext`
+
+::note
+You are likely here because you got a "Nuxt instance unavailable" message. Please use this method sparingly, and report examples that are causing issues, so that it can ultimately be solved at the framework level.
+::
+
+The `runWithContext` method is meant to be used to call a function and give it an explicit Nuxt context. Typically, the Nuxt context is passed around implicitly and you do not need to worry about this. However, when working with complex `async`/`await` scenarios in middleware/plugins, you can run into instances where the current instance has been unset after an async call.
+
+```ts [app/middleware/auth.ts]
+export default defineNuxtRouteMiddleware(async (to, from) => {
+ const nuxtApp = useNuxtApp()
+ let user
+ try {
+ user = await fetchUser()
+ // the Vue/Nuxt compiler loses context here because of the try/catch block.
+ } catch (e) {
+ user = null
+ }
+ if (!user) {
+ // apply the correct Nuxt context to our `navigateTo` call.
+ return nuxtApp.runWithContext(() => navigateTo('/auth'))
+ }
+})
+```
+
+#### Usage
+
+```ts
+const result = nuxtApp.runWithContext(() => functionWithContext())
+```
+
+- `functionWithContext`: Any function that requires the context of the current Nuxt application. This context will be correctly applied automatically.
+
+`runWithContext` will return whatever is returned by `functionWithContext`.
+
+#### A Deeper Explanation of Context
+
+Vue.js Composition API (and Nuxt composables similarly) work by depending on an implicit context. During the lifecycle, Vue sets the temporary instance of the current component (and Nuxt temporary instance of nuxtApp) to a global variable and unsets it in same tick. When rendering on the server side, there are multiple requests from different users and nuxtApp running in a same global context. Because of this, Nuxt and Vue immediately unset this global instance to avoid leaking a shared reference between two users or components.
+
+What it does mean? The Composition API and Nuxt Composables are only available during lifecycle and in same tick before any async operation:
+
+```ts
+// --- Vue internal ---
+const _vueInstance = null
+const getCurrentInstance = () => _vueInstance
+// ---
+
+// Vue / Nuxt sets a global variable referencing to current component in _vueInstance when calling setup()
+async function setup () {
+ getCurrentInstance() // Works
+ await someAsyncOperation() // Vue unsets the context in same tick before async operation!
+ getCurrentInstance() // null
+}
+```
+
+The classic solution to this, is caching the current instance on first call to a local variable like `const instance = getCurrentInstance()` and use it in the next composable call but the issue is that any nested composable calls now needs to explicitly accept the instance as an argument and not depend on the implicit context of composition-api. This is design limitation with composables and not an issue per-se.
+
+To overcome this limitation, Vue does some behind the scenes work when compiling our application code and restores context after each call for `<script setup>`:
+
+```ts
+const __instance = getCurrentInstance() // Generated by Vue compiler
+getCurrentInstance() // Works!
+await someAsyncOperation() // Vue unsets the context
+__restoreInstance(__instance) // Generated by Vue compiler
+getCurrentInstance() // Still works!
+```
+
+For a better description of what Vue actually does, see [unjs/unctx#2 (comment)](https://github.com/unjs/unctx/issues/2#issuecomment-942193723).
+
+#### Solution
+
+This is where `runWithContext` can be used to restore context, similarly to how `<script setup>` works.
+
+Nuxt internally uses [unjs/unctx](https://github.com/unjs/unctx) to support composables similar to Vue for plugins and middleware. This enables composables like `navigateTo()` to work without directly passing `nuxtApp` to them - bringing the DX and performance benefits of Composition API to the whole Nuxt framework.
+
+Nuxt composables have the same design as the Vue Composition API and therefore need a similar solution to magically do this transform. Check out [unjs/unctx#2](https://github.com/unjs/unctx/issues/2) (proposal), [unjs/unctx#4](https://github.com/unjs/unctx/pull/4) (transform implementation), and [nuxt/framework#3884](https://github.com/nuxt/framework/pull/3884) (Integration to Nuxt).
+
+Vue currently only supports async context restoration for `<script setup>` for async/await usage. In Nuxt, the transform support for `defineNuxtPlugin()` and `defineNuxtRouteMiddleware()` was added, which means when you use them Nuxt automatically transforms them with context restoration.
+
+#### Remaining Issues
+
+The `unjs/unctx` transformation to automatically restore context seems buggy with `try/catch` statements containing `await` which ultimately needs to be solved in order to remove the requirement of the workaround suggested above.
+
+#### Native Async Context
+
+Using a new experimental feature, it is possible to enable native async context support using [Node.js `AsyncLocalStorage`](https://nodejs.org/api/async_context.html#class-asynclocalstorage) and new unctx support to make async context available **natively** to **any nested async composable** without needing a transform or manual passing/calling with context.
+
+::tip
+Native async context support works currently in Bun and Node.
+::
+
+:read-more{to="/docs/4.x/guide/going-further/experimental-features#asynccontext"}
+
+## tryUseNuxtApp
+
+This function works exactly the same as `useNuxtApp`, but returns `null` if context is unavailable instead of throwing an exception.
+
+You can use it for composables that do not require `nuxtApp`, or to simply check if context is available or not without an exception.
+
+Example usage:
+
+```ts [composable.ts]
+export function useStandType () {
+ // Always works on the client
+ if (tryUseNuxtApp()) {
+ return useRuntimeConfig().public.STAND_TYPE
+ } else {
+ return process.env.STAND_TYPE
+ }
+}
+```
+
+<!-- ### Params
+
+- `appName`: an optional application name. If you do not provide it, the Nuxt `buildId` option is used. Otherwise, it must match with an existing `buildId`. -->
diff --git a/docs/4.api/2.composables/use-nuxt-data.md b/docs/4.api/2.composables/use-nuxt-data.md
new file mode 100644
index 000000000000..f0502f22135f
--- /dev/null
+++ b/docs/4.api/2.composables/use-nuxt-data.md
@@ -0,0 +1,112 @@
+---
+title: 'useNuxtData'
+description: 'Access the current cached value of data fetching composables.'
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/asyncData.ts
+ size: xs
+---
+
+::note
+`useNuxtData` gives you access to the current cached value of [`useAsyncData`](/docs/4.x/api/composables/use-async-data) , [`useLazyAsyncData`](/docs/4.x/api/composables/use-lazy-async-data), [`useFetch`](/docs/4.x/api/composables/use-fetch) and [`useLazyFetch`](/docs/4.x/api/composables/use-lazy-fetch) with explicitly provided key.
+::
+
+## Usage
+
+The `useNuxtData` composable is used to access the current cached value of data-fetching composables such as `useAsyncData`, `useLazyAsyncData`, `useFetch`, and `useLazyFetch`. By providing the key used during the data fetch, you can retrieve the cached data and use it as needed.
+
+This is particularly useful for optimizing performance by reusing already-fetched data or implementing features like Optimistic Updates or cascading data updates.
+
+To use `useNuxtData`, ensure that the data-fetching composable (`useFetch`, `useAsyncData`, etc.) has been called with an explicitly provided key.
+
+:video-accordion{title="Watch a video from LearnVue about useNuxtData" videoId="e-_u6swXRWk"}
+
+## Params
+
+- `key`: The unique key that identifies the cached data. This key should match the one used during the original data fetch.
+
+## Return Values
+
+- `data`: A reactive reference to the cached data associated with the provided key. If no cached data exists, the value will be `null`. This `Ref` automatically updates if the cached data changes, allowing seamless reactivity in your components.
+
+## Example
+
+The example below shows how you can use cached data as a placeholder while the most recent data is being fetched from the server.
+
+```vue [app/pages/posts.vue]
+<script setup lang="ts">
+// We can access same data later using 'posts' key
+const { data } = await useFetch('/api/posts', { key: 'posts' })
+</script>
+```
+
+```vue [app/pages/posts/[id\\].vue]
+<script setup lang="ts">
+// Access to the cached value of useFetch in posts.vue (parent route)
+const { data: posts } = useNuxtData('posts')
+
+const route = useRoute()
+
+const { data } = useLazyFetch(`/api/posts/${route.params.id}`, {
+ key: `post-${route.params.id}`,
+ default () {
+ // Find the individual post from the cache and set it as the default value.
+ return posts.value.find(post => post.id === route.params.id)
+ },
+})
+</script>
+```
+
+## Optimistic Updates
+
+The example below shows how implementing Optimistic Updates can be achieved using useNuxtData.
+
+Optimistic Updates is a technique where the user interface is updated immediately, assuming a server operation will succeed. If the operation eventually fails, the UI is rolled back to its previous state.
+
+```vue [app/pages/todos.vue]
+<script setup lang="ts">
+// We can access same data later using 'todos' key
+const { data } = await useAsyncData('todos', (_nuxtApp, { signal }) => $fetch('/api/todos', { signal }))
+</script>
+```
+
+```vue [app/components/NewTodo.vue]
+<script setup lang="ts">
+const newTodo = ref('')
+let previousTodos = []
+
+// Access to the cached value of useAsyncData in todos.vue
+const { data: todos } = useNuxtData('todos')
+
+async function addTodo () {
+ await $fetch('/api/addTodo', {
+ method: 'post',
+ body: {
+ todo: newTodo.value,
+ },
+ onRequest () {
+ // Store the previously cached value to restore if fetch fails.
+ previousTodos = todos.value
+
+ // Optimistically update the todos.
+ todos.value = [...todos.value, newTodo.value]
+ },
+ onResponseError () {
+ // Rollback the data if the request failed.
+ todos.value = previousTodos
+ },
+ async onResponse () {
+ // Invalidate todos in the background if the request succeeded.
+ await refreshNuxtData('todos')
+ },
+ })
+}
+</script>
+```
+
+## Type
+
+```ts [Signature]
+export function useNuxtData<DataT = any> (key: string): { data: Ref<DataT | undefined> }
+```
diff --git a/docs/4.api/2.composables/use-preview-mode.md b/docs/4.api/2.composables/use-preview-mode.md
new file mode 100644
index 000000000000..aa8401db909e
--- /dev/null
+++ b/docs/4.api/2.composables/use-preview-mode.md
@@ -0,0 +1,115 @@
+---
+title: "usePreviewMode"
+description: "Use usePreviewMode to check and control preview mode in Nuxt"
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/preview.ts
+ size: xs
+---
+
+# `usePreviewMode`
+
+Preview mode allows you to see how your changes would be displayed on a live site without revealing them to users.
+
+You can use the built-in `usePreviewMode` composable to access and control preview state in Nuxt. If the composable detects preview mode it will automatically force any updates necessary for [`useAsyncData`](/docs/4.x/api/composables/use-async-data) and [`useFetch`](/docs/4.x/api/composables/use-fetch) to rerender preview content.
+
+```ts
+const { enabled, state } = usePreviewMode()
+```
+
+## Options
+
+### Custom `enable` check
+
+You can specify a custom way to enable preview mode. By default the `usePreviewMode` composable will enable preview mode if there is a `preview` param in url that is equal to `true` (for example, `http://localhost:3000?preview=true`). You can wrap the `usePreviewMode` into custom composable, to keep options consistent across usages and prevent any errors.
+
+```ts
+export function useMyPreviewMode () {
+ const route = useRoute()
+ return usePreviewMode({
+ shouldEnable: () => {
+ return !!route.query.customPreview
+ },
+ })
+}
+```
+
+### Modify default state
+
+`usePreviewMode` will try to store the value of a `token` param from url in state. You can modify this state and it will be available for all [`usePreviewMode`](/docs/4.x/api/composables/use-preview-mode) calls.
+
+```ts
+const data1 = ref('data1')
+
+const { enabled, state } = usePreviewMode({
+ getState: (currentState) => {
+ return { data1, data2: 'data2' }
+ },
+})
+```
+
+::note
+The `getState` function will append returned values to current state, so be careful not to accidentally overwrite important state.
+::
+
+### Customize the `onEnable` and `onDisable` callbacks
+
+By default, when `usePreviewMode` is enabled, it will call `refreshNuxtData()` to re-fetch all data from the server.
+
+When preview mode is disabled, the composable will attach a callback to call `refreshNuxtData()` to run after a subsequent router navigation.
+
+You can specify custom callbacks to be triggered by providing your own functions for the `onEnable` and `onDisable` options.
+
+```ts
+const { enabled, state } = usePreviewMode({
+ onEnable: () => {
+ console.log('preview mode has been enabled')
+ },
+ onDisable: () => {
+ console.log('preview mode has been disabled')
+ },
+})
+```
+
+## Example
+
+The example below creates a page where part of a content is rendered only in preview mode.
+
+```vue [app/pages/some-page.vue]
+<script setup>
+const { enabled, state } = usePreviewMode()
+
+const { data } = await useFetch('/api/preview', {
+ query: {
+ apiKey: state.token,
+ },
+})
+</script>
+
+<template>
+ <div>
+ Some base content
+ <p v-if="enabled">
+ Only preview content: {{ state.token }}
+ <br>
+ <button @click="enabled = false">
+ disable preview mode
+ </button>
+ </p>
+ </div>
+</template>
+```
+
+Now you can generate your site and serve it:
+
+```bash [Terminal]
+npx nuxt generate
+npx nuxt preview
+```
+
+Then you can see your preview page by adding the query param `preview` to the end of the page you want to see once, for example `http://localhost:3000/?preview=true`.
+
+::note
+`usePreviewMode` should be tested locally with `nuxt generate` and then `nuxt preview` rather than `nuxt dev`. (The [preview command](/docs/4.x/api/commands/preview) is not related to preview mode.)
+::
diff --git a/docs/4.api/2.composables/use-request-event.md b/docs/4.api/2.composables/use-request-event.md
new file mode 100644
index 000000000000..c3f2639b5e58
--- /dev/null
+++ b/docs/4.api/2.composables/use-request-event.md
@@ -0,0 +1,23 @@
+---
+title: 'useRequestEvent'
+description: 'Access the incoming request event with the useRequestEvent composable.'
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/ssr.ts
+ size: xs
+---
+
+Within the [Nuxt context](/docs/4.x/guide/going-further/nuxt-app#the-nuxt-context) you can use `useRequestEvent` to access the incoming request.
+
+```ts
+// Get underlying request event
+const event = useRequestEvent()
+
+// Get the URL
+const url = event?.path
+```
+
+::tip
+In the browser, `useRequestEvent` will return `undefined`.
+::
diff --git a/docs/4.api/2.composables/use-request-fetch.md b/docs/4.api/2.composables/use-request-fetch.md
new file mode 100644
index 000000000000..ae342f52d0e9
--- /dev/null
+++ b/docs/4.api/2.composables/use-request-fetch.md
@@ -0,0 +1,52 @@
+---
+title: 'useRequestFetch'
+description: 'Forward the request context and headers for server-side fetch requests with the useRequestFetch composable.'
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/ssr.ts
+ size: xs
+---
+
+You can use `useRequestFetch` to forward the request context and headers when making server-side fetch requests.
+
+When making a client-side fetch request, the browser automatically sends the necessary headers.
+However, when making a request during server-side rendering, due to security considerations, we need to forward the headers manually.
+
+::note
+Headers that are **not meant to be forwarded** will **not be included** in the request. These headers include, for example:
+`transfer-encoding`, `connection`, `keep-alive`, `upgrade`, `expect`, `host`, `accept`
+::
+
+::tip
+The [`useFetch`](/docs/4.x/api/composables/use-fetch) composable uses `useRequestFetch` under the hood to automatically forward the request context and headers.
+::
+
+::code-group
+
+```vue [app/pages/index.vue]
+<script setup lang="ts">
+// This will forward the user's headers to the `/api/cookies` event handler
+// Result: { cookies: { foo: 'bar' } }
+const requestFetch = useRequestFetch()
+const { data: forwarded } = await useAsyncData(() => requestFetch('/api/cookies'))
+
+// This will NOT forward anything
+// Result: { cookies: {} }
+const { data: notForwarded } = await useAsyncData((_nuxtApp, { signal }) => $fetch('/api/cookies', { signal }))
+</script>
+```
+
+```ts [server/api/cookies.ts]
+export default defineEventHandler((event) => {
+ const cookies = parseCookies(event)
+
+ return { cookies }
+})
+```
+
+::
+
+::tip
+In the browser during client-side navigation, `useRequestFetch` will behave just like regular [`$fetch`](/docs/4.x/api/utils/dollarfetch).
+::
diff --git a/docs/4.api/2.composables/use-request-header.md b/docs/4.api/2.composables/use-request-header.md
new file mode 100644
index 000000000000..7bd4012bd2ca
--- /dev/null
+++ b/docs/4.api/2.composables/use-request-header.md
@@ -0,0 +1,34 @@
+---
+title: "useRequestHeader"
+description: "Use useRequestHeader to access a certain incoming request header."
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/ssr.ts
+ size: xs
+---
+
+You can use the built-in [`useRequestHeader`](/docs/4.x/api/composables/use-request-header) composable to access any incoming request header within your pages, components, and plugins.
+
+```ts
+// Get the authorization request header
+const authorization = useRequestHeader('authorization')
+```
+
+::tip
+In the browser, `useRequestHeader` will return `undefined`.
+::
+
+## Example
+
+We can use `useRequestHeader` to easily figure out if a user is authorized or not.
+
+The example below reads the `authorization` request header to find out if a person can access a restricted resource.
+
+```ts [app/middleware/authorized-only.ts]
+export default defineNuxtRouteMiddleware((to, from) => {
+ if (!useRequestHeader('authorization')) {
+ return navigateTo('/not-authorized')
+ }
+})
+```
diff --git a/docs/4.api/2.composables/use-request-headers.md b/docs/4.api/2.composables/use-request-headers.md
new file mode 100644
index 000000000000..b35d868852d1
--- /dev/null
+++ b/docs/4.api/2.composables/use-request-headers.md
@@ -0,0 +1,37 @@
+---
+title: "useRequestHeaders"
+description: "Use useRequestHeaders to access the incoming request headers."
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/ssr.ts
+ size: xs
+---
+
+You can use built-in [`useRequestHeaders`](/docs/4.x/api/composables/use-request-headers) composable to access the incoming request headers within your pages, components, and plugins.
+
+```ts
+// Get all request headers
+const headers = useRequestHeaders()
+
+// Get only cookie request header
+const { cookie } = useRequestHeaders(['cookie'])
+```
+
+::tip
+In the browser, `useRequestHeaders` will return an empty object.
+::
+
+## Example
+
+We can use `useRequestHeaders` to access and proxy the initial request's `authorization` header to any future internal requests during SSR.
+
+The example below adds the `authorization` request header to an isomorphic `$fetch` call.
+
+```vue [app/pages/some-page.vue]
+<script setup lang="ts">
+const { data } = await useFetch('/api/confidential', {
+ headers: useRequestHeaders(['authorization']),
+})
+</script>
+```
diff --git a/docs/4.api/2.composables/use-request-url.md b/docs/4.api/2.composables/use-request-url.md
new file mode 100644
index 000000000000..1294c13f5bce
--- /dev/null
+++ b/docs/4.api/2.composables/use-request-url.md
@@ -0,0 +1,41 @@
+---
+title: 'useRequestURL'
+description: 'Access the incoming request URL with the useRequestURL composable.'
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/url.ts
+ size: xs
+---
+
+`useRequestURL` is a helper function that returns an [URL object](https://developer.mozilla.org/en-US/docs/Web/API/URL/URL) working on both server-side and client-side.
+
+::important
+When utilizing [Hybrid Rendering](/docs/4.x/guide/concepts/rendering#hybrid-rendering) with cache strategies, all incoming request headers are dropped when handling the cached responses via the [Nitro caching layer](https://nitro.build/guide/cache) (meaning `useRequestURL` will return `localhost` for the `host`).
+
+You can define the [`cache.varies` option](https://nitro.build/guide/cache#options) to specify headers that will be considered when caching and serving the responses, such as `host` and `x-forwarded-host` for multi-tenant environments.
+::
+
+::code-group
+
+```vue [app/pages/about.vue]
+<script setup lang="ts">
+const url = useRequestURL()
+</script>
+
+<template>
+ <p>URL is: {{ url }}</p>
+ <p>Path is: {{ url.pathname }}</p>
+</template>
+```
+
+```html [Result in development]
+<p>URL is: http://localhost:3000/about</p>
+<p>Path is: /about</p>
+```
+
+::
+
+::tip{icon="i-simple-icons-mdnwebdocs" to="https://developer.mozilla.org/en-US/docs/Web/API/URL#instance_properties" target="_blank"}
+Read about the URL instance properties on the MDN documentation.
+::
diff --git a/docs/4.api/2.composables/use-response-header.md b/docs/4.api/2.composables/use-response-header.md
new file mode 100644
index 000000000000..4257dfcbb5e8
--- /dev/null
+++ b/docs/4.api/2.composables/use-response-header.md
@@ -0,0 +1,47 @@
+---
+title: "useResponseHeader"
+description: "Use useResponseHeader to set a server response header."
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/ssr.ts
+ size: xs
+---
+
+::important
+This composable is available in Nuxt v3.14+.
+::
+
+You can use the built-in [`useResponseHeader`](/docs/4.x/api/composables/use-response-header) composable to set any server response header within your pages, components, and plugins.
+
+```ts
+// Set a custom response header
+const header = useResponseHeader('X-My-Header')
+header.value = 'my-value'
+```
+
+## Example
+
+We can use `useResponseHeader` to easily set a response header on a per-page basis.
+
+```vue [app/pages/test.vue]
+<script setup>
+// pages/test.vue
+const header = useResponseHeader('X-My-Header')
+header.value = 'my-value'
+</script>
+
+<template>
+ <h1>Test page with custom header</h1>
+ <p>The response from the server for this "/test" page will have a custom "X-My-Header" header.</p>
+</template>
+```
+
+We can use `useResponseHeader` for example in Nuxt [middleware](/docs/4.x/directory-structure/app/middleware) to set a response header for all pages.
+
+```ts [app/middleware/my-header-middleware.ts]
+export default defineNuxtRouteMiddleware((to, from) => {
+ const header = useResponseHeader('X-My-Always-Header')
+ header.value = `I'm Always here!`
+})
+```
diff --git a/docs/4.api/2.composables/use-route-announcer.md b/docs/4.api/2.composables/use-route-announcer.md
new file mode 100644
index 000000000000..cbbf49cc4d3a
--- /dev/null
+++ b/docs/4.api/2.composables/use-route-announcer.md
@@ -0,0 +1,62 @@
+---
+title: 'useRouteAnnouncer'
+description: This composable observes the page title changes and updates the announcer message accordingly.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/route-announcer.ts
+ size: xs
+---
+
+::important
+This composable is available in Nuxt v3.12+.
+::
+
+## Description
+
+A composable which observes the page title changes and updates the announcer message accordingly. Used by [`<NuxtRouteAnnouncer>`](/docs/4.x/api/components/nuxt-route-announcer) and controllable.
+It hooks into Unhead's `dom:rendered` hook to read the page's title and set it as the announcer message.
+
+## Parameters
+
+- `politeness`: Sets the urgency for screen reader announcements: `off` (disable the announcement), `polite` (waits for silence), or `assertive` (interrupts immediately). (default `polite`).
+
+## Properties
+
+### `message`
+
+- **type**: `Ref<string>`
+- **description**: The message to announce
+
+### `politeness`
+
+- **type**: `Ref<string>`
+- **description**: Screen reader announcement urgency level `off`, `polite`, or `assertive`
+
+## Methods
+
+### `set(message, politeness = "polite")`
+
+Sets the message to announce with its urgency level.
+
+### `polite(message)`
+
+Sets the message with `politeness = "polite"`
+
+### `assertive(message)`
+
+Sets the message with `politeness = "assertive"`
+
+## Example
+
+```vue [app/pages/index.vue]
+<script setup lang="ts">
+const { message, politeness, set, polite, assertive } = useRouteAnnouncer({
+ politeness: 'assertive',
+})
+</script>
+```
+
+::callout
+For announcing dynamic in-page content changes (form validation, toasts, loading states), use [`useAnnouncer`](/docs/4.x/api/composables/use-announcer) instead.
+::
diff --git a/docs/4.api/2.composables/use-route.md b/docs/4.api/2.composables/use-route.md
new file mode 100644
index 000000000000..21faa85dfce1
--- /dev/null
+++ b/docs/4.api/2.composables/use-route.md
@@ -0,0 +1,87 @@
+---
+title: "useRoute"
+description: The useRoute composable returns the current route.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/router.ts
+ size: xs
+---
+
+::note
+Within the template of a Vue component, you can access the route using `$route`.
+::
+
+The `useRoute` composable is a wrapper around the identically named composable from `vue-router`, providing access to the current route in a Nuxt application.
+
+The key difference is that in Nuxt, the composable ensures that the route is updated **only after** the page content has changed after navigation.
+In contrast, the `vue-router` version updates the route **immediately**, which can lead to synchronization issues between different parts of the template
+that rely on the route metadata, for example.
+
+## Example
+
+In the following example, we call an API via [`useFetch`](/docs/4.x/api/composables/use-fetch) using a dynamic page parameter - `slug` - as part of the URL.
+
+```html [~/pages/[slug\\].vue]
+<script setup lang="ts">
+const route = useRoute()
+const { data: mountain } = await useFetch(`/api/mountains/${route.params.slug}`)
+</script>
+
+<template>
+ <div>
+ <h1>{{ mountain.title }}</h1>
+ <p>{{ mountain.description }}</p>
+ </div>
+</template>
+```
+
+If you need to access the route query parameters (for example `example` in the path `/test?example=true`), then you can use `useRoute().query` instead of `useRoute().params`.
+
+## API
+
+Apart from dynamic parameters and query parameters, `useRoute()` also provides the following computed references related to the current route:
+
+- `fullPath`: encoded URL associated with the current route that contains path, query and hash
+- `hash`: decoded hash section of the URL that starts with a #
+- `query`: access route query parameters
+- `matched`: array of normalized matched routes with current route location
+- `meta`: custom data attached to the record
+- `name`: unique name for the route record
+- `path`: encoded pathname section of the URL
+- `redirectedFrom`: route location that was attempted to access before ending up on the current route location
+
+## Common Pitfalls
+
+### Route Synchronization Issues
+
+It’s important to use the `useRoute()` composable from Nuxt rather than the one from `vue-router` to avoid synchronization issues during page navigation.
+Importing `useRoute` directly from `vue-router` bypasses Nuxt's implementation.
+
+```ts twoslash
+// ❌ do not use `useRoute` from `vue-router`
+// @errors: 2300
+import { useRoute } from 'vue-router'
+// ✅ use Nuxt's `useRoute` composable
+import { useRoute } from '#app'
+```
+
+### Calling `useRoute` in Middleware
+
+Using `useRoute` in middleware is not recommended because it can lead to unexpected behavior.
+There is no concept of a "current route" in middleware.
+The `useRoute()` composable should only be used in the setup function of a Vue component or in a Nuxt plugin.
+
+::warning
+This applies to any composable that uses `useRoute()` internally too.
+::
+
+::read-more{to="/docs/4.x/directory-structure/app/middleware"}
+Read more about accessing the route in the middleware section.
+::
+
+### Hydration Issues with `route.fullPath`
+
+Browsers don't send [URL fragments](https://url.spec.whatwg.org/#concept-url-fragment) (for example `#foo`) when making requests. So using `route.fullPath` to affect the template can trigger hydration issues because this will include the fragment on client but not the server.
+
+:read-more{icon="i-simple-icons-vuedotjs" to="https://router.vuejs.org/api/type-aliases/RouteLocationNormalizedLoaded.html"}
diff --git a/docs/4.api/2.composables/use-router.md b/docs/4.api/2.composables/use-router.md
new file mode 100644
index 000000000000..2fc5a4763720
--- /dev/null
+++ b/docs/4.api/2.composables/use-router.md
@@ -0,0 +1,94 @@
+---
+title: "useRouter"
+description: "The useRouter composable returns the router instance."
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/router.ts
+ size: xs
+---
+
+```vue [app/pages/index.vue]
+<script setup lang="ts">
+const router = useRouter()
+</script>
+```
+
+If you only need the router instance within your template, use `$router`:
+
+```vue [app/pages/index.vue]
+<template>
+ <button @click="$router.back()">
+ Back
+ </button>
+</template>
+```
+
+If you have a `app/pages/` directory, `useRouter` is identical in behavior to the one provided by `vue-router`.
+
+::read-more{icon="i-simple-icons-vuedotjs" to="https://router.vuejs.org/api/interfaces/router#Properties-currentRoute-" target="_blank"}
+Read `vue-router` documentation about the `Router` interface.
+::
+
+## Basic Manipulation
+
+- [`addRoute()`](https://router.vuejs.org/api/interfaces/router#addRoute-): Add a new route to the router instance. `parentName` can be provided to add new route as the child of an existing route.
+- [`removeRoute()`](https://router.vuejs.org/api/interfaces/router#removeRoute-): Remove an existing route by its name.
+- [`getRoutes()`](https://router.vuejs.org/api/interfaces/router#getRoutes-): Get a full list of all the route records.
+- [`hasRoute()`](https://router.vuejs.org/api/interfaces/router#hasRoute-): Checks if a route with a given name exists.
+- [`resolve()`](https://router.vuejs.org/api/interfaces/router#resolve-): Returns the normalized version of a route location. Also includes an `href` property that includes any existing base.
+
+```ts [Example]
+const router = useRouter()
+
+router.addRoute({ name: 'home', path: '/home', component: Home })
+router.removeRoute('home')
+router.getRoutes()
+router.hasRoute('home')
+router.resolve({ name: 'home' })
+```
+
+::note
+`router.addRoute()` adds route details into an array of routes and it is useful while building [Nuxt plugins](/docs/4.x/directory-structure/app/plugins) while `router.push()` on the other hand, triggers a new navigation immediately and it is useful in pages, Vue components and composable.
+::
+
+## Based on History API
+
+- [`back()`](https://router.vuejs.org/api/interfaces/router#back-): Go back in history if possible, same as `router.go(-1)`.
+- [`forward()`](https://router.vuejs.org/api/interfaces/router#forward-): Go forward in history if possible, same as `router.go(1)`.
+- [`go()`](https://router.vuejs.org/api/interfaces/router#go-): Move forward or backward through the history without the hierarchical restrictions enforced in `router.back()` and `router.forward()`.
+- [`push()`](https://router.vuejs.org/api/interfaces/router#push-): Programmatically navigate to a new URL by pushing an entry in the history stack. **It is recommended to use [`navigateTo`](/docs/4.x/api/utils/navigate-to) instead.**
+- [`replace()`](https://router.vuejs.org/api/interfaces/router#replace-): Programmatically navigate to a new URL by replacing the current entry in the routes history stack. **It is recommended to use [`navigateTo`](/docs/4.x/api/utils/navigate-to) instead.**
+
+```ts [Example]
+const router = useRouter()
+
+router.back()
+router.forward()
+router.go(3)
+router.push({ path: '/home' })
+router.replace({ hash: '#bio' })
+```
+
+::read-more{icon="i-simple-icons-mdnwebdocs" to="https://developer.mozilla.org/en-US/docs/Web/API/History" target="_blank"}
+Read more about the browser's History API.
+::
+
+## Navigation Guards
+
+`useRouter` composable provides `afterEach`, `beforeEach` and `beforeResolve` helper methods that acts as navigation guards.
+
+However, Nuxt has a concept of **route middleware** that simplifies the implementation of navigation guards and provides a better developer experience.
+
+:read-more{to="/docs/4.x/directory-structure/app/middleware"}
+
+## Promise and Error Handling
+
+- [`isReady()`](https://router.vuejs.org/api/interfaces/router#isReady-): Returns a Promise that resolves when the router has completed the initial navigation.
+- [`onError`](https://router.vuejs.org/api/interfaces/router#onError-): Adds an error handler that is called every time a non caught error happens during navigation.
+
+:read-more{icon="i-simple-icons-vuedotjs" to="https://router.vuejs.org/api/interfaces/router#Methods-" title="Vue Router Docs" target="_blank"}
+
+## Universal Router Instance
+
+If you do not have a `app/pages/` folder, then [`useRouter`](/docs/4.x/api/composables/use-router) will return a universal router instance with similar helper methods, but be aware that not all features may be supported or behave in exactly the same way as with `vue-router`.
diff --git a/docs/4.api/2.composables/use-runtime-config.md b/docs/4.api/2.composables/use-runtime-config.md
new file mode 100644
index 000000000000..83df48f8fd70
--- /dev/null
+++ b/docs/4.api/2.composables/use-runtime-config.md
@@ -0,0 +1,142 @@
+---
+title: 'useRuntimeConfig'
+description: 'Access runtime config variables with the useRuntimeConfig composable.'
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/nuxt.ts
+ size: xs
+---
+
+## Usage
+
+```vue [app/app.vue]
+<script setup lang="ts">
+const config = useRuntimeConfig()
+</script>
+```
+
+```ts [server/api/foo.ts]
+export default defineEventHandler((event) => {
+ const config = useRuntimeConfig()
+})
+```
+
+:read-more{to="/docs/4.x/guide/going-further/runtime-config"}
+
+## Define Runtime Config
+
+The example below shows how to set a public API base URL and a secret API token that is only accessible on the server.
+
+We should always define `runtimeConfig` variables inside `nuxt.config`.
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+ runtimeConfig: {
+ // Private keys are only available on the server
+ apiSecret: '123',
+
+ // Public keys that are exposed to the client
+ public: {
+ apiBase: process.env.NUXT_PUBLIC_API_BASE || '/api',
+ },
+ },
+})
+```
+
+::note
+Variables that need to be accessible on the server are added directly inside `runtimeConfig`. Variables that need to be accessible on both the client and the server are defined in `runtimeConfig.public`.
+::
+
+:read-more{to="/docs/4.x/guide/going-further/runtime-config"}
+
+## Access Runtime Config
+
+To access runtime config, we can use `useRuntimeConfig()` composable:
+
+```ts [server/api/test.ts]
+export default defineEventHandler(async (event) => {
+ const config = useRuntimeConfig()
+
+ // Access public variables
+ const result = await $fetch(`/test`, {
+ baseURL: config.public.apiBase,
+ headers: {
+ // Access a private variable (only available on the server)
+ Authorization: `Bearer ${config.apiSecret}`,
+ },
+ })
+ return result
+})
+```
+
+In this example, since `apiBase` is defined within the `public` namespace, it is universally accessible on both server and client-side, while `apiSecret` **is only accessible on the server-side**.
+
+## Environment Variables
+
+It is possible to update runtime config values using a matching environment variable name prefixed with `NUXT_`.
+
+:read-more{to="/docs/4.x/guide/going-further/runtime-config"}
+
+### Using the `.env` File
+
+We can set the environment variables inside the `.env` file to make them accessible during **development** and **build/generate**.
+
+```ini [.env]
+NUXT_PUBLIC_API_BASE = "https://api.localhost:5555"
+NUXT_API_SECRET = "123"
+```
+
+::note
+Any environment variables set within `.env` file are accessed using `process.env` in the Nuxt app during **development** and **build/generate**.
+::
+
+::warning
+In **production runtime**, you should use platform environment variables and `.env` is not used.
+::
+
+:read-more{to="/docs/4.x/directory-structure/env"}
+
+## `app` namespace
+
+Nuxt uses `app` namespace in runtime-config with keys including `baseURL` and `cdnURL`. You can customize their values at runtime by setting environment variables.
+
+::note
+This is a reserved namespace. You should not introduce additional keys inside `app`.
+::
+
+### `app.baseURL`
+
+By default, the `baseURL` is set to `'/'`.
+
+However, the `baseURL` can be updated at runtime by setting the `NUXT_APP_BASE_URL` as an environment variable.
+
+Then, you can access this new base URL using `config.app.baseURL`:
+
+```ts [/plugins/my-plugin.ts]
+export default defineNuxtPlugin((NuxtApp) => {
+ const config = useRuntimeConfig()
+
+ // Access baseURL universally
+ const baseURL = config.app.baseURL
+})
+```
+
+### `app.cdnURL`
+
+This example shows how to set a custom CDN url and access them using `useRuntimeConfig()`.
+
+You can use a custom CDN for serving static assets inside `.output/public` using the `NUXT_APP_CDN_URL` environment variable.
+
+And then access the new CDN url using `config.app.cdnURL`.
+
+```ts [server/api/foo.ts]
+export default defineEventHandler((event) => {
+ const config = useRuntimeConfig()
+
+ // Access cdnURL universally
+ const cdnURL = config.app.cdnURL
+})
+```
+
+:read-more{to="/docs/4.x/guide/going-further/runtime-config"}
diff --git a/docs/4.api/2.composables/use-runtime-hook.md b/docs/4.api/2.composables/use-runtime-hook.md
new file mode 100644
index 000000000000..2662eb77cede
--- /dev/null
+++ b/docs/4.api/2.composables/use-runtime-hook.md
@@ -0,0 +1,43 @@
+---
+title: useRuntimeHook
+description: Registers a runtime hook in a Nuxt application and ensures it is properly disposed of when the scope is destroyed.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/runtime-hook.ts
+ size: xs
+---
+
+::important
+This composable is available in Nuxt v3.14+.
+::
+
+```ts [signature]
+function useRuntimeHook<THookName extends keyof RuntimeNuxtHooks> (
+ name: THookName,
+ fn: RuntimeNuxtHooks[THookName] extends HookCallback ? RuntimeNuxtHooks[THookName] : never,
+): void
+```
+
+## Usage
+
+### Parameters
+
+- `name`: The name of the runtime hook to register. You can see the full list of [runtime Nuxt hooks here](/docs/4.x/api/advanced/hooks#app-hooks-runtime).
+- `fn`: The callback function to execute when the hook is triggered. The function signature varies based on the hook name.
+
+### Returns
+
+The composable doesn't return a value, but it automatically unregisters the hook when the component's scope is destroyed.
+
+## Example
+
+```vue twoslash [pages/index.vue]
+<script setup lang="ts">
+// Register a hook that runs every time a link is prefetched, but which will be
+// automatically cleaned up (and not called again) when the component is unmounted
+useRuntimeHook('link:prefetch', (link) => {
+ console.log('Prefetching', link)
+})
+</script>
+```
diff --git a/docs/4.api/2.composables/use-seo-meta.md b/docs/4.api/2.composables/use-seo-meta.md
new file mode 100644
index 000000000000..9f81d4ff0ef0
--- /dev/null
+++ b/docs/4.api/2.composables/use-seo-meta.md
@@ -0,0 +1,80 @@
+---
+title: 'useSeoMeta'
+description: The useSeoMeta composable lets you define your site's SEO meta tags as a flat object with full TypeScript support.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/unjs/unhead/blob/main/packages/vue/src/composables.ts
+ size: xs
+---
+
+This helps you avoid common mistakes, such as using `name` instead of `property`, as well as typos - with over 100+ meta tags fully typed.
+
+::important
+This is the recommended way to add meta tags to your site as it is XSS safe and has full TypeScript support.
+::
+
+:read-more{to="/docs/4.x/getting-started/seo-meta"}
+
+## Usage
+
+```vue [app/app.vue]
+<script setup lang="ts">
+useSeoMeta({
+ title: 'My Amazing Site',
+ ogTitle: 'My Amazing Site',
+ description: 'This is my amazing site, let me tell you all about it.',
+ ogDescription: 'This is my amazing site, let me tell you all about it.',
+ ogImage: 'https://example.com/image.png',
+ twitterCard: 'summary_large_image',
+})
+</script>
+```
+
+When inserting tags that are reactive, you should use the computed getter syntax (`() => value`):
+
+```vue [app/app.vue]
+<script setup lang="ts">
+const title = ref('My title')
+
+useSeoMeta({
+ title,
+ description: () => `This is a description for the ${title.value} page`,
+})
+</script>
+```
+
+## Parameters
+
+There are over 100 parameters. See the [full list of parameters in the source code](https://github.com/harlan-zw/zhead/blob/main/packages/zhead/src/metaFlat.ts#L1035).
+
+:read-more{to="/docs/4.x/getting-started/seo-meta"}
+
+## Performance
+
+In most instances, SEO meta tags don't need to be reactive as search engine robots primarily scan the initial page load.
+
+For better performance, you can wrap your `useSeoMeta` calls in a server-only condition when the meta tags don't need to be reactive:
+
+```vue [app/app.vue]
+<script setup lang="ts">
+if (import.meta.server) {
+ // These meta tags will only be added during server-side rendering
+ useSeoMeta({
+ robots: 'index, follow',
+ description: 'Static description that does not need reactivity',
+ ogImage: 'https://example.com/image.png',
+ // other static meta tags...
+ })
+}
+
+const dynamicTitle = ref('My title')
+// Only use reactive meta tags outside the condition when necessary
+useSeoMeta({
+ title: () => dynamicTitle.value,
+ ogTitle: () => dynamicTitle.value,
+})
+</script>
+```
+
+This previously used the [`useServerSeoMeta`](/docs/4.x/api/composables/use-server-seo-meta) composable, but it has been deprecated in favor of this approach.
diff --git a/docs/4.api/2.composables/use-server-seo-meta.md b/docs/4.api/2.composables/use-server-seo-meta.md
new file mode 100644
index 000000000000..3a516a4f3695
--- /dev/null
+++ b/docs/4.api/2.composables/use-server-seo-meta.md
@@ -0,0 +1,33 @@
+---
+title: 'useServerSeoMeta'
+description: The useServerSeoMeta composable lets you define your site's SEO meta tags as a flat object with full TypeScript support.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/unjs/unhead/blob/main/packages/vue/src/composables.ts
+ size: xs
+---
+
+::warning
+`useServerSeoMeta` is deprecated. Wrap [`useSeoMeta`](/docs/4.x/api/composables/use-seo-meta) in an `if (import.meta.server)` block instead. The auto-import is removed under `future.compatibilityVersion: 5`.
+::
+
+`useServerSeoMeta` lets you define your site's SEO meta tags as a flat object with full TypeScript support, exactly like [`useSeoMeta`](/docs/4.x/api/composables/use-seo-meta), but it only runs server-side and is tree-shaken from the client bundle.
+
+:read-more{to="/docs/4.x/api/composables/use-seo-meta"}
+
+For new code, use the server-only pattern directly:
+
+```vue [app/app.vue]
+<script setup lang="ts">
+if (import.meta.server) {
+ useSeoMeta({
+ robots: 'index, follow',
+ })
+}
+</script>
+```
+
+Parameters are exactly the same as with [`useSeoMeta`](/docs/4.x/api/composables/use-seo-meta).
+
+:read-more{to="/docs/4.x/getting-started/seo-meta"}
diff --git a/docs/4.api/2.composables/use-state.md b/docs/4.api/2.composables/use-state.md
new file mode 100644
index 000000000000..f34d61288252
--- /dev/null
+++ b/docs/4.api/2.composables/use-state.md
@@ -0,0 +1,58 @@
+---
+title: "useState"
+description: The useState composable creates a reactive and SSR-friendly shared state.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/state.ts
+ size: xs
+---
+
+## Usage
+
+```ts
+// Create a reactive state and set default value
+const count = useState('counter', () => Math.round(Math.random() * 100))
+```
+
+:read-more{to="/docs/4.x/getting-started/state-management"}
+
+::important
+Because the data inside `useState` will be serialized to JSON, it is important that it does not contain anything that cannot be serialized, such as classes, functions or symbols.
+::
+
+::warning
+`useState` is a reserved function name transformed by the compiler, so you should not name your own function `useState`.
+::
+
+:video-accordion{title="Watch a video from Alexander Lichter about why and when to use useState" videoId="mv0WcBABcIk"}
+
+## Using `shallowRef`
+
+If you don't need your state to be deeply reactive, you can combine `useState` with [`shallowRef`](https://vuejs.org/api/reactivity-advanced#shallowref). This can improve performance when your state contains large objects and arrays.
+
+```ts
+const state = useState('my-shallow-state', () => shallowRef({ deep: 'not reactive' }))
+// isShallow(state) === true
+```
+
+## Type
+
+```ts [Signature]
+export function useState<T> (init?: () => T | Ref<T>): Ref<T>
+export function useState<T> (key: string, init?: () => T | Ref<T>): Ref<T>
+```
+
+- `key`: A unique key ensuring that data fetching is properly de-duplicated across requests. If you do not provide a key, then a key that is unique to the file and line number of the instance of [`useState`](/docs/4.x/api/composables/use-state) will be generated for you.
+- `init`: A function that provides initial value for the state when not initiated. This function can also return a `Ref`.
+- `T`: (typescript only) Specify the type of state
+
+## Troubleshooting
+
+### `Cannot stringify arbitrary non-POJOs`
+
+This error occurs when you try to store a non-serializable payload with `useState`, such as class instances.
+
+If you want to store class instances with `useState` that are not supported by Nuxt, you can use [`definePayloadPlugin`](/docs/4.x/api/composables/use-nuxt-app#custom-reducerreviver) to add a custom serializer and deserializer for your classes.
+
+:read-more{to="/docs/4.x/api/composables/use-nuxt-app#payload"}
diff --git a/docs/4.api/3.utils/$fetch.md b/docs/4.api/3.utils/$fetch.md
new file mode 100644
index 000000000000..f42dedd95cdf
--- /dev/null
+++ b/docs/4.api/3.utils/$fetch.md
@@ -0,0 +1,100 @@
+---
+title: "$fetch"
+description: Nuxt uses ofetch to expose globally the $fetch helper for making HTTP requests.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/entry.ts
+ size: xs
+---
+
+Nuxt uses [ofetch](https://github.com/unjs/ofetch) to expose globally the `$fetch` helper for making HTTP requests within your Vue app or API routes.
+
+::tip{icon="i-lucide-rocket"}
+During server-side rendering, calling `$fetch` to fetch your internal [API routes](/docs/4.x/directory-structure/server) will directly call the relevant function (emulating the request), **saving an additional API call**.
+::
+
+::note{color="blue" icon="i-lucide-info"}
+Using `$fetch` in components without wrapping it with [`useAsyncData`](/docs/4.x/api/composables/use-async-data) causes fetching the data twice: initially on the server, then again on the client-side during hydration, because `$fetch` does not transfer state from the server to the client. Thus, the fetch will be executed on both sides because the client has to get the data again.
+::
+
+## Usage
+
+We recommend using [`useFetch`](/docs/4.x/api/composables/use-fetch) or [`useAsyncData`](/docs/4.x/api/composables/use-async-data) + `$fetch` to prevent double data fetching when fetching the component data.
+
+```vue [app/app.vue]
+<script setup lang="ts">
+// During SSR data is fetched twice, once on the server and once on the client.
+const dataTwice = await $fetch('/api/item')
+
+// During SSR data is fetched only on the server side and transferred to the client.
+const { data } = await useAsyncData('item', () => $fetch('/api/item'))
+
+// You can also useFetch as shortcut of useAsyncData + $fetch
+const { data } = await useFetch('/api/item')
+</script>
+```
+
+:read-more{to="/docs/4.x/getting-started/data-fetching"}
+
+You can use `$fetch` in any methods that are executed only on client-side.
+
+```vue [app/pages/contact.vue]
+<script setup lang="ts">
+async function contactForm () {
+ await $fetch('/api/contact', {
+ method: 'POST',
+ body: { hello: 'world' },
+ })
+}
+</script>
+
+<template>
+ <button @click="contactForm">
+ Contact
+ </button>
+</template>
+```
+
+::tip
+`$fetch` is the preferred way to make HTTP calls in Nuxt instead of [@nuxt/http](https://github.com/nuxt/http) and [@nuxtjs/axios](https://github.com/nuxt-community/axios-module) that are made for Nuxt 2.
+::
+
+::note
+If you use `$fetch` to call an (external) HTTPS URL with a self-signed certificate in development, you will need to set `NODE_TLS_REJECT_UNAUTHORIZED=0` in your environment.
+::
+
+### Passing Headers and Cookies
+
+When we call `$fetch` in the browser, user headers like `cookie` will be directly sent to the API.
+
+However, during Server-Side Rendering, due to security risks such as **Server-Side Request Forgery (SSRF)** or **Authentication Misuse**, the `$fetch` wouldn't include the user's browser cookies, nor pass on cookies from the fetch response.
+
+::code-group
+
+```vue [app/pages/index.vue]
+<script setup lang="ts">
+// This will NOT forward headers or cookies during SSR
+const { data } = await useAsyncData(() => $fetch('/api/cookies'))
+</script>
+```
+
+```ts [server/api/cookies.ts]
+export default defineEventHandler((event) => {
+ const foo = getCookie(event, 'foo')
+ // ... Do something with the cookie
+})
+```
+::
+
+If you need to forward headers and cookies on the server, you must manually pass them:
+
+```vue [app/pages/index.vue]
+<script setup lang="ts">
+// This will forward the user's headers and cookies to `/api/cookies`
+const requestFetch = useRequestFetch()
+const { data } = await useAsyncData(() => requestFetch('/api/cookies'))
+</script>
+```
+
+However, when calling `useFetch` with a relative URL on the server, Nuxt will use [`useRequestFetch`](/docs/4.x/api/composables/use-request-fetch) to proxy headers and cookies (with the exception of headers not meant to be forwarded, like `host`).
diff --git a/docs/4.api/3.utils/.navigation.yml b/docs/4.api/3.utils/.navigation.yml
new file mode 100644
index 000000000000..c128cf751444
--- /dev/null
+++ b/docs/4.api/3.utils/.navigation.yml
@@ -0,0 +1,3 @@
+title: 'Utils'
+titleTemplate: '%s · Nuxt Utils'
+navigation.icon: i-lucide-square-function
diff --git a/docs/4.api/3.utils/abort-navigation.md b/docs/4.api/3.utils/abort-navigation.md
new file mode 100644
index 000000000000..641549ea8346
--- /dev/null
+++ b/docs/4.api/3.utils/abort-navigation.md
@@ -0,0 +1,73 @@
+---
+title: 'abortNavigation'
+description: 'abortNavigation is a helper function that prevents navigation from taking place and throws an error if one is set as a parameter.'
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/router.ts
+ size: xs
+---
+
+::warning
+`abortNavigation` is only usable inside a [route middleware handler](/docs/4.x/directory-structure/app/middleware).
+::
+
+## Type
+
+```ts [Signature]
+export function abortNavigation (err?: Error | string): false
+```
+
+## Parameters
+
+### `err`
+
+- **Type**: [`Error`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error) | `string`
+
+ Optional error to be thrown by `abortNavigation`.
+
+## Examples
+
+The example below shows how you can use `abortNavigation` in a route middleware to prevent unauthorized route access:
+
+```ts [app/middleware/auth.ts]
+export default defineNuxtRouteMiddleware((to, from) => {
+ const user = useState('user')
+
+ if (!user.value.isAuthorized) {
+ return abortNavigation()
+ }
+
+ if (to.path !== '/edit-post') {
+ return navigateTo('/edit-post')
+ }
+})
+```
+
+### `err` as a String
+
+You can pass the error as a string:
+
+```ts [app/middleware/auth.ts]
+export default defineNuxtRouteMiddleware((to, from) => {
+ const user = useState('user')
+
+ if (!user.value.isAuthorized) {
+ return abortNavigation('Insufficient permissions.')
+ }
+})
+```
+
+### `err` as an Error Object
+
+You can pass the error as an [`Error`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error) object, e.g. caught by the `catch`-block:
+
+```ts [app/middleware/auth.ts]
+export default defineNuxtRouteMiddleware((to, from) => {
+ try {
+ /* code that might throw an error */
+ } catch (err) {
+ return abortNavigation(err)
+ }
+})
+```
diff --git a/docs/4.api/3.utils/add-route-middleware.md b/docs/4.api/3.utils/add-route-middleware.md
new file mode 100644
index 000000000000..00497a88c185
--- /dev/null
+++ b/docs/4.api/3.utils/add-route-middleware.md
@@ -0,0 +1,88 @@
+---
+title: 'addRouteMiddleware'
+description: 'addRouteMiddleware() is a helper function to dynamically add middleware in your application.'
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/router.ts
+ size: xs
+---
+
+::note
+Route middleware are navigation guards stored in the [`app/middleware/`](/docs/4.x/directory-structure/app/middleware) directory of your Nuxt application (unless [set otherwise](/docs/4.x/api/nuxt-config#middleware)).
+::
+
+## Type
+
+```ts
+function addRouteMiddleware (name: string, middleware: RouteMiddleware, options?: AddRouteMiddlewareOptions): void
+function addRouteMiddleware (middleware: RouteMiddleware): void
+
+interface AddRouteMiddlewareOptions {
+ global?: boolean
+}
+```
+
+## Parameters
+
+### `name`
+
+- **Type:** `string` | `RouteMiddleware`
+
+Can be either a string or a function of type `RouteMiddleware`. Function takes the next route `to` as the first argument and the current route `from` as the second argument, both of which are Vue route objects.
+
+Learn more about available properties of [route objects](/docs/4.x/api/composables/use-route).
+
+### `middleware`
+
+- **Type:** `RouteMiddleware`
+
+The second argument is a function of type `RouteMiddleware`. Same as above, it provides `to` and `from` route objects. It becomes optional if the first argument in `addRouteMiddleware()` is already passed as a function.
+
+### `options`
+
+- **Type:** `AddRouteMiddlewareOptions`
+
+An optional `options` argument lets you set the value of `global` to `true` to indicate whether the router middleware is global or not (set to `false` by default).
+
+## Examples
+
+### Named Route Middleware
+
+Named route middleware is defined by providing a string as the first argument and a function as the second:
+
+```ts [app/plugins/my-plugin.ts]
+export default defineNuxtPlugin(() => {
+ addRouteMiddleware('named-middleware', () => {
+ console.log('named middleware added in Nuxt plugin')
+ })
+})
+```
+
+When defined in a plugin, it overrides any existing middleware of the same name located in the `app/middleware/` directory.
+
+### Global Route Middleware
+
+Global route middleware can be defined in two ways:
+
+- Pass a function directly as the first argument without a name. It will automatically be treated as global middleware and applied on every route change.
+
+ ```ts [app/plugins/my-plugin.ts]
+ export default defineNuxtPlugin(() => {
+ addRouteMiddleware((to, from) => {
+ console.log('anonymous global middleware that runs on every route change')
+ })
+ })
+ ```
+
+- Set an optional, third argument `{ global: true }` to indicate whether the route middleware is global.
+
+ ```ts [app/plugins/my-plugin.ts]
+ export default defineNuxtPlugin(() => {
+ addRouteMiddleware('global-middleware', (to, from) => {
+ console.log('global middleware that runs on every route change')
+ },
+ { global: true },
+ )
+ })
+ ```
diff --git a/docs/4.api/3.utils/call-once.md b/docs/4.api/3.utils/call-once.md
new file mode 100644
index 000000000000..87e4777f786b
--- /dev/null
+++ b/docs/4.api/3.utils/call-once.md
@@ -0,0 +1,90 @@
+---
+title: "callOnce"
+description: "Run a given function or block of code once during SSR or CSR."
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/once.ts
+ size: xs
+---
+
+::important
+This utility is available since [Nuxt v3.9](/blog/v3-9).
+::
+
+## Purpose
+
+The `callOnce` function is designed to execute a given function or block of code only once during:
+- server-side rendering but not hydration
+- client-side navigation
+
+This is useful for code that should be executed only once, such as logging an event or setting up a global state.
+
+## Usage
+
+The default mode of `callOnce` is to run code only once. For example, if the code runs on the server it won't run again on the client. It also won't run again if you `callOnce` more than once on the client, for example by navigating back to this page.
+
+```vue [app/app.vue]
+<script setup lang="ts">
+const websiteConfig = useState('config')
+
+await callOnce(async () => {
+ console.log('This will only be logged once')
+ websiteConfig.value = await $fetch('https://my-cms.com/api/website-config')
+})
+</script>
+```
+
+It is also possible to run on every navigation while still avoiding the initial server/client double load. For this, it is possible to use the `navigation` mode:
+
+```vue [app/app.vue]
+<script setup lang="ts">
+const websiteConfig = useState('config')
+
+await callOnce(async () => {
+ console.log('This will only be logged once and then on every client side navigation')
+ websiteConfig.value = await $fetch('https://my-cms.com/api/website-config')
+}, { mode: 'navigation' })
+</script>
+```
+
+::important
+`navigation` mode is available since [Nuxt v3.15](/blog/v3-15).
+::
+
+::tip{to="/docs/4.x/getting-started/state-management#usage-with-pinia"}
+`callOnce` is useful in combination with the [Pinia module](/modules/pinia) to call store actions.
+::
+
+:read-more{to="/docs/4.x/getting-started/state-management"}
+
+::warning
+Note that `callOnce` doesn't return anything. You should use [`useAsyncData`](/docs/4.x/api/composables/use-async-data) or [`useFetch`](/docs/4.x/api/composables/use-fetch) if you want to do data fetching during SSR.
+::
+
+::note
+`callOnce` is a composable meant to be called directly in a setup function, plugin, or route middleware, because it needs to add data to the Nuxt payload to avoid re-calling the function on the client when the page hydrates.
+::
+
+## Type
+
+```ts [Signature]
+export function callOnce (key?: string, fn?: (() => any | Promise<any>), options?: CallOnceOptions): Promise<void>
+export function callOnce (fn?: (() => any | Promise<any>), options?: CallOnceOptions): Promise<void>
+
+type CallOnceOptions = {
+ /**
+ * Execution mode for the callOnce function
+ * @default 'render'
+ */
+ mode?: 'navigation' | 'render'
+}
+```
+
+## Parameters
+
+- `key`: A unique key ensuring that the code is run once. If you do not provide a key, then a key that is unique to the file and line number of the instance of `callOnce` will be generated for you.
+- `fn`: The function to run once. It can be asynchronous.
+- `options`: Setup the mode, either to re-execute on navigation (`navigation`) or just once for the lifetime of the app (`render`). Defaults to `render`.
+ - `render`: Executes once during initial render (either SSR or CSR) - Default mode
+ - `navigation`: Executes once during initial render and once per subsequent client-side navigation
diff --git a/docs/4.api/3.utils/clear-error.md b/docs/4.api/3.utils/clear-error.md
new file mode 100644
index 000000000000..3563c4f3a63b
--- /dev/null
+++ b/docs/4.api/3.utils/clear-error.md
@@ -0,0 +1,29 @@
+---
+title: "clearError"
+description: "The clearError composable clears all handled errors."
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/error.ts
+ size: xs
+---
+
+Within your pages, components, and plugins, you can use `clearError` to clear all errors and redirect the user.
+
+**Parameters:**
+
+- `options?: { redirect?: string }`
+
+You can provide an optional path to redirect to (for example, if you want to navigate to a 'safe' page).
+
+```ts
+// Without redirect
+clearError()
+
+// With redirect
+clearError({ redirect: '/homepage' })
+```
+
+Errors are set in state using [`useError()`](/docs/4.x/api/composables/use-error). The `clearError` composable will reset this state and calls the `app:error:cleared` hook with the provided options.
+
+:read-more{to="/docs/4.x/getting-started/error-handling"}
diff --git a/docs/4.api/3.utils/clear-nuxt-data.md b/docs/4.api/3.utils/clear-nuxt-data.md
new file mode 100644
index 000000000000..a36a3eb587be
--- /dev/null
+++ b/docs/4.api/3.utils/clear-nuxt-data.md
@@ -0,0 +1,23 @@
+---
+title: 'clearNuxtData'
+description: Delete cached data, error status and pending promises of useAsyncData and useFetch.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/asyncData.ts
+ size: xs
+---
+
+::note
+This method is useful if you want to invalidate the data fetching for another page.
+::
+
+## Type
+
+```ts [Signature]
+export function clearNuxtData (keys?: string | string[] | ((key: string) => boolean)): void
+```
+
+## Parameters
+
+* `keys`: One or an array of keys that are used in [`useAsyncData`](/docs/4.x/api/composables/use-async-data) to delete their cached data. If no keys are provided, **all data** will be invalidated.
diff --git a/docs/4.api/3.utils/clear-nuxt-state.md b/docs/4.api/3.utils/clear-nuxt-state.md
new file mode 100644
index 000000000000..20345af1a339
--- /dev/null
+++ b/docs/4.api/3.utils/clear-nuxt-state.md
@@ -0,0 +1,25 @@
+---
+title: 'clearNuxtState'
+description: Delete the cached state of useState.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/state.ts
+ size: xs
+---
+
+::note
+This method is useful if you want to invalidate the state of `useState`. You can also reset the state to its initial value by passing `{ reset: true }` as the second parameter.
+::
+
+## Type
+
+```ts [Signature]
+export function clearNuxtState (keys?: string | string[] | ((key: string) => boolean), opts?: ClearNuxtStateOptions): void
+```
+
+## Parameters
+
+- `keys`: One or an array of keys that are used in [`useState`](/docs/4.x/api/composables/use-state) to delete their cached state. If no keys are provided, **all state** will be invalidated.
+- `opts`: An options object to configure the clear behavior.
+ - `reset`: When set to `true`, resets the state to the initial value provided by the `init` function of [`useState`](/docs/4.x/api/composables/use-state) instead of setting it to `undefined`. When not specified, defaults to the value of `experimental.defaults.useState.resetOnClear` in your Nuxt config (which is `true` with `compatibilityVersion: 5`).
diff --git a/docs/4.api/3.utils/create-error.md b/docs/4.api/3.utils/create-error.md
new file mode 100644
index 000000000000..17054dac0e5c
--- /dev/null
+++ b/docs/4.api/3.utils/create-error.md
@@ -0,0 +1,55 @@
+---
+title: 'createError'
+description: Create an error object with additional metadata.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/error.ts
+ size: xs
+---
+
+You can use this function to create an error object with additional metadata. It is usable in both the Vue and Nitro portions of your app, and is meant to be thrown.
+
+## Parameters
+
+- `err`: `string | { cause, data, message, name, stack, status, statusText, fatal }`
+
+You can pass either a string or an object to the `createError` function. If you pass a string, it will be used as the error `message`, and the `status` will default to `500`. If you pass an object, you can set multiple properties of the error, such as `status`, `message`, and other error properties.
+
+## In Vue App
+
+If you throw an error created with `createError`:
+
+- on server-side, it will trigger a full-screen error page which you can clear with `clearError`.
+- on client-side, it will throw a non-fatal error for you to handle. If you need to trigger a full-screen error page, then you can do this by setting `fatal: true`.
+
+### Example
+
+```vue [app/pages/movies/[slug\\].vue]
+<script setup lang="ts">
+const route = useRoute()
+const { data } = await useFetch(`/api/movies/${route.params.slug}`)
+if (!data.value) {
+ throw createError({ status: 404, statusText: 'Page Not Found' })
+}
+</script>
+```
+
+## In API Routes
+
+Use `createError` to trigger error handling in server API routes.
+
+### Example
+
+```ts [server/api/error.ts]
+export default eventHandler(() => {
+ throw createError({
+ status: 404,
+ statusText: 'Page Not Found',
+ })
+})
+```
+
+In API routes, using `createError` by passing an object with a short `statusText` is recommended because it can be accessed on the client side. Otherwise, a `message` passed to `createError` on an API route will not propagate to the client. Alternatively, you can use the `data` property to pass data back to the client. In any case, always consider avoiding to put dynamic user input to the message to avoid potential security issues.
+
+:read-more{to="/docs/4.x/getting-started/error-handling"}
diff --git a/docs/4.api/3.utils/define-lazy-hydration-component.md b/docs/4.api/3.utils/define-lazy-hydration-component.md
new file mode 100644
index 000000000000..f5295b4a49a0
--- /dev/null
+++ b/docs/4.api/3.utils/define-lazy-hydration-component.md
@@ -0,0 +1,261 @@
+---
+title: 'defineLazyHydrationComponent'
+description: 'Define a lazy hydration component with a specific strategy.'
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/components/plugins/lazy-hydration-macro-transform.ts
+ size: xs
+---
+
+`defineLazyHydrationComponent` is a compiler macro that helps you create a component with a specific lazy hydration strategy. Lazy hydration defers hydration until components become visible or until the browser has completed more critical tasks. This can significantly reduce the initial performance cost, especially for non-essential components.
+
+## Usage
+
+### Visibility Strategy
+
+Hydrates the component when it becomes visible in the viewport.
+
+```vue
+<script setup lang="ts">
+const LazyHydrationMyComponent = defineLazyHydrationComponent(
+ 'visible',
+ () => import('./components/MyComponent.vue'),
+)
+</script>
+
+<template>
+ <div>
+ <!--
+ Hydration will be triggered when
+ the element(s) is 100px away from entering the viewport.
+ -->
+ <LazyHydrationMyComponent :hydrate-on-visible="{ rootMargin: '100px' }" />
+ </div>
+</template>
+```
+
+The `hydrateOnVisible` prop is optional. You can pass an object to customize the behavior of the `IntersectionObserver` under the hood.
+
+::read-more{to="https://developer.mozilla.org/en-US/docs/Web/API/IntersectionObserver/IntersectionObserver" title="IntersectionObserver options"}
+Read more about the options for `hydrate-on-visible`.
+::
+
+::note
+Under the hood, this uses Vue's built-in [`hydrateOnVisible` strategy](https://vuejs.org/guide/components/async#hydrate-on-visible).
+::
+
+### Idle Strategy
+
+Hydrates the component when the browser is idle. This is suitable if you need the component to load as soon as possible, but not block the critical rendering path.
+
+```vue
+<script setup lang="ts">
+const LazyHydrationMyComponent = defineLazyHydrationComponent(
+ 'idle',
+ () => import('./components/MyComponent.vue'),
+)
+</script>
+
+<template>
+ <div>
+ <!-- Hydration will be triggered when the browser is idle or after 2000ms. -->
+ <LazyHydrationMyComponent :hydrate-on-idle="2000" />
+ </div>
+</template>
+```
+
+The `hydrateOnIdle` prop is optional. You can pass a positive number to specify the maximum timeout.
+
+Idle strategy is for components that can be hydrated when the browser is idle.
+
+::note
+Under the hood, this uses Vue's built-in [`hydrateOnIdle` strategy](https://vuejs.org/guide/components/async#hydrate-on-idle).
+::
+
+### Interaction Strategy
+
+Hydrates the component after a specified interaction (e.g., click, mouseover).
+
+```vue
+<script setup lang="ts">
+const LazyHydrationMyComponent = defineLazyHydrationComponent(
+ 'interaction',
+ () => import('./components/MyComponent.vue'),
+)
+</script>
+
+<template>
+ <div>
+ <!--
+ Hydration will be triggered when
+ the element(s) is hovered over by the pointer.
+ -->
+ <LazyHydrationMyComponent hydrate-on-interaction="mouseover" />
+ </div>
+</template>
+```
+
+The `hydrateOnInteraction` prop is optional. If you do not pass an event or a list of events, it defaults to hydrating on `pointerenter`, `click`, and `focus`.
+
+::note
+Under the hood, this uses Vue's built-in [`hydrateOnInteraction` strategy](https://vuejs.org/guide/components/async#hydrate-on-interaction).
+::
+
+### Media Query Strategy
+
+Hydrates the component when the window matches a media query.
+
+```vue
+<script setup lang="ts">
+const LazyHydrationMyComponent = defineLazyHydrationComponent(
+ 'mediaQuery',
+ () => import('./components/MyComponent.vue'),
+)
+</script>
+
+<template>
+ <div>
+ <!--
+ Hydration will be triggered when
+ the window width is greater than or equal to 768px.
+ -->
+ <LazyHydrationMyComponent hydrate-on-media-query="(min-width: 768px)" />
+ </div>
+</template>
+```
+
+::note
+Under the hood, this uses Vue's built-in [`hydrateOnMediaQuery` strategy](https://vuejs.org/guide/components/async#hydrate-on-media-query).
+::
+
+### Time Strategy
+
+Hydrates the component after a specified delay (in milliseconds).
+
+```vue
+<script setup lang="ts">
+const LazyHydrationMyComponent = defineLazyHydrationComponent(
+ 'time',
+ () => import('./components/MyComponent.vue'),
+)
+</script>
+
+<template>
+ <div>
+ <!-- Hydration is triggered after 1000ms. -->
+ <LazyHydrationMyComponent :hydrate-after="1000" />
+ </div>
+</template>
+```
+
+Time strategy is for components that can wait a specific amount of time.
+
+### If Strategy
+
+Hydrates the component based on a boolean condition.
+
+```vue
+<script setup lang="ts">
+const LazyHydrationMyComponent = defineLazyHydrationComponent(
+ 'if',
+ () => import('./components/MyComponent.vue'),
+)
+
+const isReady = ref(false)
+
+function myFunction () {
+ // Trigger custom hydration strategy...
+ isReady.value = true
+}
+</script>
+
+<template>
+ <div>
+ <!-- Hydration is triggered when isReady becomes true. -->
+ <LazyHydrationMyComponent :hydrate-when="isReady" />
+ </div>
+</template>
+```
+
+If strategy is best for components that might not always need to be hydrated.
+
+### Never Hydrate
+
+Never hydrates the component.
+
+```vue
+<script setup lang="ts">
+const LazyHydrationMyComponent = defineLazyHydrationComponent(
+ 'never',
+ () => import('./components/MyComponent.vue'),
+)
+</script>
+
+<template>
+ <div>
+ <!-- This component will never be hydrated by Vue. -->
+ <LazyHydrationMyComponent />
+ </div>
+</template>
+```
+
+### Listening to Hydration Events
+
+All delayed hydration components emit a `@hydrated` event when they are hydrated.
+
+```vue
+<script setup lang="ts">
+const LazyHydrationMyComponent = defineLazyHydrationComponent(
+ 'visible',
+ () => import('./components/MyComponent.vue'),
+)
+
+function onHydrate () {
+ console.log('Component has been hydrated!')
+}
+</script>
+
+<template>
+ <div>
+ <LazyHydrationMyComponent
+ :hydrate-on-visible="{ rootMargin: '100px' }"
+ @hydrated="onHydrated"
+ />
+ </div>
+</template>
+```
+
+## Parameters
+
+::warning
+To ensure that the compiler correctly recognizes this macro, avoid using external variables. The following approach will prevent the macro from being properly recognized:
+
+```vue
+<script setup lang="ts">
+const strategy = 'visible'
+const source = () => import('./components/MyComponent.vue')
+const LazyHydrationMyComponent = defineLazyHydrationComponent(strategy, source)
+</script>
+```
+::
+
+### `strategy`
+
+- **Type**: `'visible' | 'idle' | 'interaction' | 'mediaQuery' | 'if' | 'time' | 'never'`
+- **Required**: `true`
+
+| Strategy | Description |
+|---------------|----------------------------------------------------------------|
+| `visible` | Hydrates when the component becomes visible in the viewport. |
+| `idle` | Hydrates when the browser is idle or after a delay. |
+| `interaction` | Hydrates upon user interaction (e.g., click, hover). |
+| `mediaQuery` | Hydrates when the specified media query condition is met. |
+| `if` | Hydrates when a specified boolean condition is met. |
+| `time` | Hydrates after a specified time delay. |
+| `never` | Prevents Vue from hydrating the component. |
+
+### `source`
+
+- **Type**: `() => Promise<Component>`
+- **Required**: `true`
diff --git a/docs/4.api/3.utils/define-nuxt-component.md b/docs/4.api/3.utils/define-nuxt-component.md
new file mode 100644
index 000000000000..97b934430952
--- /dev/null
+++ b/docs/4.api/3.utils/define-nuxt-component.md
@@ -0,0 +1,53 @@
+---
+title: "defineNuxtComponent"
+description: defineNuxtComponent() is a helper function for defining type safe components with Options API.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/component.ts
+ size: xs
+---
+
+::note
+`defineNuxtComponent()` is a helper function for defining type safe Vue components using options API similar to [`defineComponent()`](https://vuejs.org/api/general#definecomponent). `defineNuxtComponent()` wrapper also adds support for `asyncData` and `head` component options.
+::
+
+::note
+Using `<script setup lang="ts">` is the recommended way of declaring Vue components in Nuxt.
+::
+
+:read-more{to=/docs/getting-started/data-fetching}
+
+## `asyncData()`
+
+If you choose not to use `setup()` in your app, you can use the `asyncData()` method within your component definition:
+
+```vue [app/pages/index.vue]
+<script lang="ts">
+export default defineNuxtComponent({
+ asyncData () {
+ return {
+ data: {
+ greetings: 'hello world!',
+ },
+ }
+ },
+})
+</script>
+```
+
+## `head()`
+
+If you choose not to use `setup()` in your app, you can use the `head()` method within your component definition:
+
+```vue [app/pages/index.vue]
+<script lang="ts">
+export default defineNuxtComponent({
+ head (nuxtApp) {
+ return {
+ title: 'My site',
+ }
+ },
+})
+</script>
+```
diff --git a/docs/4.api/3.utils/define-nuxt-plugin.md b/docs/4.api/3.utils/define-nuxt-plugin.md
new file mode 100644
index 000000000000..a8f2b5c90c80
--- /dev/null
+++ b/docs/4.api/3.utils/define-nuxt-plugin.md
@@ -0,0 +1,102 @@
+---
+title: "defineNuxtPlugin"
+description: defineNuxtPlugin() is a helper function for creating Nuxt plugins.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/nuxt.ts
+ size: xs
+---
+
+`defineNuxtPlugin` is a helper function for creating Nuxt plugins with enhanced functionality and type safety. This utility normalizes different plugin formats into a consistent structure that works seamlessly within Nuxt's plugin system.
+
+```ts twoslash [plugins/hello.ts]
+export default defineNuxtPlugin((nuxtApp) => {
+ // Doing something with nuxtApp
+})
+```
+
+:read-more{to="/docs/4.x/directory-structure/app/plugins#creating-plugins"}
+
+## Type
+
+```ts [Signature]
+export function defineNuxtPlugin<T extends Record<string, unknown>> (plugin: Plugin<T> | ObjectPlugin<T>): Plugin<T> & ObjectPlugin<T>
+
+type Plugin<T> = (nuxt: NuxtApp) => Promise<void> | Promise<{ provide?: T }> | void | { provide?: T }
+
+interface ObjectPlugin<T> {
+ name?: string
+ enforce?: 'pre' | 'default' | 'post'
+ dependsOn?: string[]
+ order?: number
+ parallel?: boolean
+ setup?: Plugin<T>
+ hooks?: Partial<RuntimeNuxtHooks>
+ env?: {
+ islands?: boolean
+ }
+}
+```
+
+## Parameters
+
+**plugin**: A plugin can be defined in two ways:
+1. **Function Plugin**: A function that receives the [`NuxtApp`](/docs/4.x/guide/going-further/internals#the-nuxtapp-interface) instance and can return a promise with a potential object with a [`provide`](/docs/4.x/directory-structure/app/plugins#providing-helpers) property if you want to provide a helper on [`NuxtApp`](/docs/4.x/guide/going-further/internals#the-nuxtapp-interface) instance.
+2. **Object Plugin**: An object that can include various properties to configure the plugin's behavior, such as `name`, `enforce`, `dependsOn`, `order`, `parallel`, `setup`, `hooks`, and `env`.
+
+| Property | Type | Required | Description |
+|-------------|----------------------------------------|----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `name` | `string` | `false` | Optional name for the plugin, useful for debugging and dependency management. |
+| `enforce` | `'pre'` \| `'default'` \| `'post'` | `false` | Controls when the plugin runs relative to other plugins. |
+| `dependsOn` | `string[]` | `false` | Array of plugin names this plugin depends on. Ensures proper execution order. |
+| `order` | `number` | `false` | This allows more granular control over plugin order and should only be used by advanced users. **It overrides the value of `enforce` and is used to sort plugins.** |
+| `parallel` | `boolean` | `false` | Whether to execute the plugin in parallel with other parallel plugins. |
+| `setup` | `Plugin<T>`{lang="ts"} | `false` | The main plugin function, equivalent to a function plugin. |
+| `hooks` | `Partial<RuntimeNuxtHooks>`{lang="ts"} | `false` | Nuxt app runtime hooks to register directly. |
+| `env` | `{ islands?: boolean }`{lang="ts"} | `false` | Set this value to `false` if you don't want the plugin to run when rendering server-only or island components. |
+
+:video-accordion{title="Watch a video from Alexander Lichter about the Object Syntax for Nuxt plugins" videoId="2aXZyXB1QGQ"}
+
+## Examples
+
+### Basic Usage
+
+The example below demonstrates a simple plugin that adds global functionality:
+
+```ts twoslash [plugins/hello.ts]
+export default defineNuxtPlugin((nuxtApp) => {
+ // Add a global method
+ return {
+ provide: {
+ hello: (name: string) => `Hello ${name}!`,
+ },
+ }
+})
+```
+
+### Object Syntax Plugin
+
+The example below shows the object syntax with advanced configuration:
+
+```ts twoslash [plugins/advanced.ts]
+export default defineNuxtPlugin({
+ name: 'my-plugin',
+ enforce: 'pre',
+ async setup (nuxtApp) {
+ // Plugin setup logic
+ const data = await $fetch('/api/config')
+
+ return {
+ provide: {
+ config: data,
+ },
+ }
+ },
+ hooks: {
+ 'app:created' () {
+ console.log('App created!')
+ },
+ },
+})
+```
diff --git a/docs/4.api/3.utils/define-nuxt-route-middleware.md b/docs/4.api/3.utils/define-nuxt-route-middleware.md
new file mode 100644
index 000000000000..d13862854917
--- /dev/null
+++ b/docs/4.api/3.utils/define-nuxt-route-middleware.md
@@ -0,0 +1,67 @@
+---
+title: "defineNuxtRouteMiddleware"
+description: "Create named route middleware using defineNuxtRouteMiddleware helper function."
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/router.ts
+ size: xs
+---
+
+Route middleware are stored in the [`app/middleware/`](/docs/4.x/directory-structure/app/middleware) of your Nuxt application (unless [set otherwise](/docs/4.x/api/nuxt-config#middleware)).
+
+## Type
+
+```ts [Signature]
+export function defineNuxtRouteMiddleware (middleware: RouteMiddleware): RouteMiddleware
+
+interface RouteMiddleware {
+ (to: RouteLocationNormalized, from: RouteLocationNormalized): ReturnType<NavigationGuard>
+}
+```
+
+## Parameters
+
+### `middleware`
+
+- **Type**: `RouteMiddleware`
+
+A function that takes two Vue Router's route location objects as parameters: the next route `to` as the first, and the current route `from` as the second.
+
+Learn more about available properties of `RouteLocationNormalized` in the **[Vue Router docs](https://router.vuejs.org/api/type-aliases/routelocationnormalized)**.
+
+## Examples
+
+### Showing Error Page
+
+You can use route middleware to throw errors and show helpful error messages:
+
+```ts [app/middleware/error.ts]
+export default defineNuxtRouteMiddleware((to) => {
+ if (to.params.id === '1') {
+ throw createError({ status: 404, statusText: 'Page Not Found' })
+ }
+})
+```
+
+The above route middleware will redirect a user to the custom error page defined in the `~/error.vue` file, and expose the error message and code passed from the middleware.
+
+### Redirection
+
+Use [`useState`](/docs/4.x/api/composables/use-state) in combination with `navigateTo` helper function inside the route middleware to redirect users to different routes based on their authentication status:
+
+```ts [app/middleware/auth.ts]
+export default defineNuxtRouteMiddleware((to, from) => {
+ const auth = useState('auth')
+
+ if (!auth.value.isAuthenticated) {
+ return navigateTo('/login')
+ }
+
+ if (to.path !== '/dashboard') {
+ return navigateTo('/dashboard')
+ }
+})
+```
+
+Both [navigateTo](/docs/4.x/api/utils/navigate-to) and [abortNavigation](/docs/4.x/api/utils/abort-navigation) are globally available helper functions that you can use inside `defineNuxtRouteMiddleware`.
diff --git a/docs/4.api/3.utils/define-page-meta.md b/docs/4.api/3.utils/define-page-meta.md
new file mode 100644
index 000000000000..c93f8455b575
--- /dev/null
+++ b/docs/4.api/3.utils/define-page-meta.md
@@ -0,0 +1,298 @@
+---
+title: 'definePageMeta'
+description: 'Define metadata for your page components.'
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/pages/runtime/composables.ts
+ size: xs
+---
+
+`definePageMeta` is a compiler macro that you can use to set metadata for your **page** components located in the [`app/pages/`](/docs/4.x/directory-structure/app/pages) directory (unless [set otherwise](/docs/4.x/api/nuxt-config#pages)). This way you can set custom metadata for each static or dynamic route of your Nuxt application.
+
+```vue [app/pages/some-page.vue]
+<script setup lang="ts">
+definePageMeta({
+ layout: 'default',
+})
+</script>
+```
+
+:read-more{to="/docs/4.x/directory-structure/app/pages#page-metadata"}
+
+## Type
+
+```ts [Signature]
+export function definePageMeta (meta: PageMeta): void
+
+interface PageMeta {
+ validate?: ((route: RouteLocationNormalized) => boolean | Promise<boolean> | Partial<NuxtError> | Promise<Partial<NuxtError>>)
+ redirect?: RouteRecordRedirectOption
+ name?: string
+ path?: string
+ props?: RouteRecordRaw['props']
+ alias?: string | string[]
+ groups?: string[]
+ pageTransition?: boolean | TransitionProps
+ layoutTransition?: boolean | TransitionProps
+ viewTransition?: ViewTransitionPageOptions['enabled'] | ViewTransitionPageOptions
+ key?: false | string | ((route: RouteLocationNormalizedLoaded) => string)
+ keepalive?: boolean | KeepAliveProps
+ layout?: false | LayoutKey | Ref<LayoutKey> | ComputedRef<LayoutKey> | { name?: LayoutKey | false, props?: Record<string, unknown> /* or the selected layout's props */ }
+ middleware?: MiddlewareKey | NavigationGuard | Array<MiddlewareKey | NavigationGuard>
+ scrollToTop?: boolean | ((to: RouteLocationNormalizedLoaded, from: RouteLocationNormalizedLoaded) => boolean)
+ [key: string]: unknown
+}
+```
+
+## Parameters
+
+### `meta`
+
+- **Type**: `PageMeta`
+
+ An object accepting the following page metadata:
+
+ **`name`**
+
+ - **Type**: `string`
+
+ You may define a name for this page's route. By default, name is generated based on path inside the [`app/pages/` directory](/docs/4.x/directory-structure/app/pages).
+
+ **`path`**
+
+ - **Type**: `string`
+
+ You may define a [custom regular expression](/docs/4.x/api/utils/define-page-meta#using-a-custom-regular-expression) if you have a more complex pattern than can be expressed with the file name.
+
+ **`props`**
+
+ - **Type**: [`RouteRecordRaw['props']`](https://router.vuejs.org/guide/essentials/passing-props)
+
+ Allows accessing the route `params` as props passed to the page component.
+
+ **`alias`**
+
+ - **Type**: `string | string[]`
+
+ Aliases for the record. Allows defining extra paths that will behave like a copy of the record. Allows having paths shorthands like `/users/:id` and `/u/:id`. All `alias` and `path` values must share the same params.
+
+ **`groups`**
+
+ - **Type**: `string[]`
+
+ Route groups the page belongs to, based on the folder structure. Automatically populated for pages within [route groups](/docs/4.x/guide/directory-structure/app/pages#route-groups).
+
+ **`keepalive`**
+
+ - **Type**: `boolean` | [`KeepAliveProps`](https://vuejs.org/api/built-in-components#keepalive)
+
+ Set to `true` when you want to preserve page state across route changes or use the [`KeepAliveProps`](https://vuejs.org/api/built-in-components#keepalive) for a fine-grained control.
+
+ **`key`**
+
+ - **Type**: `false` | `string` | `((route: RouteLocationNormalizedLoaded) => string)`
+
+ Set `key` value when you need more control over when the `<NuxtPage>` component is re-rendered.
+
+ **`layout`**
+
+ - **Type**: `false` | `LayoutKey` | `Ref<LayoutKey>` | `ComputedRef<LayoutKey>` | `{ name?: LayoutKey | false; props?: Record<string, unknown> /* or the selected layout's props */ }`
+
+ Set a static or dynamic name of the layout for each route. This can be set to `false` in case the default layout needs to be disabled.
+
+ You can also pass an object with `name` and `props` to pass typed props to your layout component. When your layout defines props with `defineProps`, they will be fully typed in `definePageMeta`.
+
+ **`layoutTransition`**
+
+ - **Type**: `boolean` | [`TransitionProps`](https://vuejs.org/api/built-in-components#transition)
+
+ Set name of the transition to apply for current layout. You can also set this value to `false` to disable the layout transition.
+
+ **`middleware`**
+
+ - **Type**: `MiddlewareKey` | [`NavigationGuard`](https://router.vuejs.org/api/interfaces/navigationguard) | `Array<MiddlewareKey | NavigationGuard>`
+
+ Define anonymous or named middleware directly within `definePageMeta`. Learn more about [route middleware](/docs/4.x/directory-structure/app/middleware).
+
+ **`pageTransition`**
+
+ - **Type**: `boolean` | [`TransitionProps`](https://vuejs.org/api/built-in-components#transition)
+
+ Set name of the transition to apply for current page. You can also set this value to `false` to disable the page transition.
+
+ **`viewTransition`**
+
+ - **Type**: `boolean | 'always' | ViewTransitionPageOptions`
+
+ **Experimental feature, only available when [enabled in your nuxt.config file](/docs/4.x/getting-started/transitions#view-transitions-api-experimental)**</br>
+ Enable/disable View Transitions for the current page.
+ If set to true, Nuxt will not apply the transition if the users browser matches `prefers-reduced-motion: reduce` (recommended). If set to `always`, Nuxt will always apply the transition.
+
+ You can also pass a `ViewTransitionPageOptions` object to configure [view transition types](/docs/4.x/getting-started/transitions#view-transition-types):
+ - `enabled`: `boolean | 'always'` - enable/disable the transition
+ - `types`: `string[] | (to, from) => string[]` - types applied to any transition involving this page
+ - `toTypes`: `string[] | (to, from) => string[]` - types applied only when navigating **to** this page
+ - `fromTypes`: `string[] | (to, from) => string[]` - types applied only when navigating **from** this page
+
+ **`redirect`**
+
+ - **Type**: [`RouteRecordRedirectOption`](https://router.vuejs.org/guide/essentials/redirect-and-alias)
+
+ Where to redirect if the route is directly matched. The redirection happens before any navigation guard and triggers a new navigation with the new target location.
+
+ **`validate`**
+
+ - **Type**: `(route: RouteLocationNormalized) => boolean | Promise<boolean> | Partial<NuxtError> | Promise<Partial<NuxtError>>`
+
+ Validate whether a given route can validly be rendered with this page. Return true if it is valid, or false if not. If another match can't be found, this will mean a 404. You can also directly return an object with `status`/`statusText` to respond immediately with an error (other matches will not be checked).
+
+ **`scrollToTop`**
+
+ - **Type**: `boolean | (to: RouteLocationNormalized, from: RouteLocationNormalized) => boolean`
+
+ Tell Nuxt to scroll to the top before rendering the page or not. Navigation is independent from rendering, so scroll behavior is always triggered even when the page doesn't re-render (e.g. when using a fixed [`key`](/docs/4.x/api/utils/define-page-meta#key)). Set `scrollToTop: false` to disable scrolling in such cases. If you want to overwrite the default scroll behavior of Nuxt, you can do so in `~/router.options.ts` (see [custom routing](/docs/4.x/guide/recipes/custom-routing#using-routeroptions)) for more info.
+
+ **`[key: string]`**
+
+ - **Type**: `any`
+
+ Apart from the above properties, you can also set **custom** metadata. You may wish to do so in a type-safe way by [augmenting the type of the `meta` object](/docs/4.x/directory-structure/app/pages/#typing-custom-metadata).
+
+## Examples
+
+### Basic Usage
+
+The example below demonstrates:
+
+- how `key` can be a function that returns a value;
+- how `keepalive` property makes sure that the `<modal>` component is not cached when switching between multiple components;
+- adding `pageType` as a custom property:
+
+```vue [app/pages/some-page.vue]
+<script setup lang="ts">
+definePageMeta({
+ key: route => route.fullPath,
+
+ keepalive: {
+ exclude: ['modal'],
+ },
+
+ pageType: 'Checkout',
+})
+</script>
+```
+
+### Defining Middleware
+
+The example below shows how the middleware can be defined using a `function` directly within the `definePageMeta` or set as a `string` that matches the middleware file name located in the `app/middleware/` directory:
+
+```vue [app/pages/some-page.vue]
+<script setup lang="ts">
+definePageMeta({
+ // define middleware as a function
+ middleware: [
+ function (to, from) {
+ const auth = useState('auth')
+
+ if (!auth.value.authenticated) {
+ return navigateTo('/login')
+ }
+
+ if (to.path !== '/checkout') {
+ return navigateTo('/checkout')
+ }
+ },
+ ],
+
+ // ... or a string
+ middleware: 'auth',
+
+ // ... or multiple strings
+ middleware: ['auth', 'another-named-middleware'],
+})
+</script>
+```
+
+### Using a Custom Regular Expression
+
+A custom regular expression is a good way to resolve conflicts between overlapping routes, for instance:
+
+The two routes "/test-category" and "/1234-post" match both `[postId]-[postSlug].vue` and `[categorySlug].vue` page routes.
+
+To make sure that we are only matching digits (`\d+`) for `postId` in the `[postId]-[postSlug]` route, we can add the following to the `[postId]-[postSlug].vue` page template:
+
+```vue [app/pages/[postId\\]-[postSlug\\].vue]
+<script setup lang="ts">
+definePageMeta({
+ path: '/:postId(\\d+)-:postSlug',
+})
+</script>
+```
+
+For more examples see [Vue Router's Matching Syntax](https://router.vuejs.org/guide/essentials/route-matching-syntax).
+
+### Defining Layout
+
+You can define the layout that matches the layout's file name located (by default) in the [`app/layouts/` directory](/docs/4.x/directory-structure/app/layouts). You can also disable the layout by setting the `layout` to `false`:
+
+```vue [app/pages/some-page.vue]
+<script setup lang="ts">
+definePageMeta({
+ // set custom layout
+ layout: 'admin',
+
+ // ... or disable a default layout
+ layout: false,
+})
+</script>
+```
+
+### Passing Props to a Layout
+
+You can pass props to a layout by using the object syntax for `layout`. If your layout defines props with `defineProps`, the props will be fully typed.
+
+::code-group
+
+```vue [app/pages/dashboard.vue]
+<script setup lang="ts">
+definePageMeta({
+ layout: {
+ name: 'panel',
+ props: {
+ sidebar: true,
+ title: 'Dashboard',
+ },
+ },
+})
+</script>
+```
+
+```vue [app/layouts/panel.vue]
+<script setup lang="ts">
+const props = defineProps<{
+ sidebar?: boolean
+ title?: string
+}>()
+</script>
+
+<template>
+ <div>
+ <aside v-if="sidebar">
+ Sidebar
+ </aside>
+ <main>
+ <h1>{{ title }}</h1>
+ <slot />
+ </main>
+ </div>
+</template>
+```
+
+::
+
+::tip
+Layout props set via `definePageMeta` are fully typed based on the layout's `defineProps`. You'll get autocomplete and type-checking in your editor.
+::
+
+:read-more{to="/docs/4.x/directory-structure/app/layouts#passing-props-to-layouts"}
diff --git a/docs/4.api/3.utils/define-route-rules.md b/docs/4.api/3.utils/define-route-rules.md
new file mode 100644
index 000000000000..02d6bb62fa2d
--- /dev/null
+++ b/docs/4.api/3.utils/define-route-rules.md
@@ -0,0 +1,52 @@
+---
+title: 'defineRouteRules'
+description: 'Define route rules for hybrid rendering at the page level.'
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/pages/runtime/composables.ts
+ size: xs
+---
+
+::read-more{to="/docs/4.x/guide/going-further/experimental-features#inlinerouterules" icon="i-lucide-star"}
+This feature is experimental and in order to use it you must enable the `experimental.inlineRouteRules` option in your `nuxt.config`.
+::
+
+## Usage
+
+```vue [app/pages/index.vue]
+<script setup lang="ts">
+defineRouteRules({
+ prerender: true,
+})
+</script>
+
+<template>
+ <h1>Hello world!</h1>
+</template>
+```
+
+Will be translated to:
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+ routeRules: {
+ '/': { prerender: true },
+ },
+})
+```
+
+::note
+When running [`nuxt build`](/docs/4.x/api/commands/build), the home page will be pre-rendered in `.output/public/index.html` and statically served.
+::
+
+## Notes
+
+- A rule defined in `~/pages/foo/bar.vue` will be applied to `/foo/bar` requests.
+- A rule in `~/pages/foo/[id].vue` will be applied to `/foo/**` requests.
+
+For more control, such as if you are using a custom `path` or `alias` set in the page's [`definePageMeta`](/docs/4.x/api/utils/define-page-meta), you should set `routeRules` directly within your `nuxt.config`.
+
+::read-more{to="/docs/4.x/guide/concepts/rendering#hybrid-rendering" icon="i-lucide-medal"}
+Read more about the `routeRules`.
+::
diff --git a/docs/4.api/3.utils/navigate-to.md b/docs/4.api/3.utils/navigate-to.md
new file mode 100644
index 000000000000..531fd562fe90
--- /dev/null
+++ b/docs/4.api/3.utils/navigate-to.md
@@ -0,0 +1,230 @@
+---
+title: "navigateTo"
+description: navigateTo is a helper function that programmatically navigates users.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/router.ts
+ size: xs
+---
+
+## Usage
+
+`navigateTo` is available on both server side and client side. It can be used within the [Nuxt context](/docs/4.x/guide/going-further/nuxt-app#the-nuxt-context), or directly, to perform page navigation.
+
+::warning
+Make sure to always use `await` or `return` on result of `navigateTo` when calling it.
+::
+
+::note
+`navigateTo` cannot be used within Nitro routes. To perform a server-side redirect in Nitro routes, use [`sendRedirect`](https://h3.dev/utils/response#redirectlocation-status-statustext) instead.
+::
+
+### Within a Vue Component
+
+```vue
+<script setup lang="ts">
+// passing 'to' as a string
+await navigateTo('/search')
+
+// ... or as a route object
+await navigateTo({ path: '/search' })
+
+// ... or as a route object with query parameters
+await navigateTo({
+ path: '/search',
+ query: {
+ page: 1,
+ sort: 'asc',
+ },
+})
+</script>
+```
+
+### Within Route Middleware
+
+```ts
+export default defineNuxtRouteMiddleware((to, from) => {
+ if (to.path !== '/search') {
+ // setting the redirect code to '301 Moved Permanently'
+ return navigateTo('/search', { redirectCode: 301 })
+ }
+})
+```
+
+When using `navigateTo` within route middleware, you must **return its result** to ensure the middleware execution flow works correctly.
+
+For example, the following implementation **will not work as expected**:
+
+```ts
+export default defineNuxtRouteMiddleware((to, from) => {
+ if (to.path !== '/search') {
+ // ❌ This will not work as expected
+ navigateTo('/search', { redirectCode: 301 })
+ return
+ }
+})
+```
+
+In this case, `navigateTo` will be executed but not returned, which may lead to unexpected behavior.
+
+:read-more{to="/docs/4.x/directory-structure/app/middleware"}
+
+### Navigating to an External URL
+
+The `external` parameter in `navigateTo` influences how navigating to URLs is handled:
+
+- **Without `external: true`**:
+ - Internal URLs navigate as expected.
+ - External URLs throw an error.
+
+- **With `external: true`**:
+ - Internal URLs navigate with a full-page reload.
+ - External URLs navigate as expected.
+
+#### Example
+
+```vue
+<script setup lang="ts">
+// will throw an error;
+// navigating to an external URL is not allowed by default
+await navigateTo('https://nuxt.com')
+
+// will redirect successfully with the 'external' parameter set to 'true'
+await navigateTo('https://nuxt.com', {
+ external: true,
+})
+</script>
+```
+
+### Opening a Page in a New Tab
+
+```vue
+<script setup lang="ts">
+// will open 'https://nuxt.com' in a new tab
+await navigateTo('https://nuxt.com', {
+ open: {
+ target: '_blank',
+ windowFeatures: {
+ width: 500,
+ height: 500,
+ },
+ },
+})
+</script>
+```
+
+## Type
+
+```ts [Signature]
+export function navigateTo (
+ to: RouteLocationRaw | undefined | null,
+ options?: NavigateToOptions,
+): Promise<void | NavigationFailure | false> | false | void | RouteLocationRaw
+
+interface NavigateToOptions {
+ replace?: boolean
+ redirectCode?: number
+ external?: boolean
+ open?: OpenOptions
+}
+
+type OpenOptions = {
+ target: string
+ windowFeatures?: OpenWindowFeatures
+}
+
+type OpenWindowFeatures = {
+ popup?: boolean
+ noopener?: boolean
+ noreferrer?: boolean
+} & XOR<{ width?: number }, { innerWidth?: number }>
+ & XOR<{ height?: number }, { innerHeight?: number }>
+ & XOR<{ left?: number }, { screenX?: number }>
+ & XOR<{ top?: number }, { screenY?: number }>
+```
+
+## Parameters
+
+### `to`
+
+**Type**: [`RouteLocationRaw`](https://router.vuejs.org/api/interfaces/routelocationoptions) | `undefined` | `null`
+
+**Default**: `'/'`
+
+`to` can be a plain string or a route object to redirect to. When passed as `undefined` or `null`, it will default to `'/'`.
+
+#### Example
+
+```ts
+// Passing the URL directly will redirect to the '/blog' page
+await navigateTo('/blog')
+
+// Using the route object, will redirect to the route with the name 'blog'
+await navigateTo({ name: 'blog' })
+
+// Redirects to the 'product' route while passing a parameter (id = 1) using the route object.
+await navigateTo({ name: 'product', params: { id: 1 } })
+```
+
+### `options` (optional)
+
+**Type**: `NavigateToOptions`
+
+An object accepting the following properties:
+
+- `replace`
+
+ - **Type**: `boolean`
+ - **Default**: `false`
+ - By default, `navigateTo` pushes the given route into the Vue Router's instance on the client side.
+
+ This behavior can be changed by setting `replace` to `true`, to indicate that given route should be replaced.
+
+- `redirectCode`
+
+ - **Type**: `number`
+ - **Default**: `302`
+
+ - `navigateTo` redirects to the given path and sets the redirect code to [`302 Found`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/302) by default when the redirection takes place on the server side.
+
+ This default behavior can be modified by providing different `redirectCode`. Commonly, [`301 Moved Permanently`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/301) can be used for permanent redirections.
+
+- `external`
+
+ - **Type**: `boolean`
+ - **Default**: `false`
+
+ - Allows navigating to an external URL when set to `true`. Otherwise, `navigateTo` will throw an error, as external navigation is not allowed by default.
+
+- `open`
+
+ - **Type**: `OpenOptions`
+ - Allows navigating to the URL using the [open()](https://developer.mozilla.org/en-US/docs/Web/API/Window/open) method of the window. This option is only applicable on the client side and will be ignored on the server side.
+
+ An object accepting the following properties:
+
+ - `target`
+
+ - **Type**: `string`
+ - **Default**: `'_blank'`
+
+ - A string, without whitespace, specifying the name of the browsing context the resource is being loaded into.
+
+ - `windowFeatures`
+
+ - **Type**: `OpenWindowFeatures`
+
+ - An object accepting the following properties:
+
+ | Property | Type | Description |
+ |---------------------------|-----------|------------------------------------------------------------------------------------------------|
+ | `popup` | `boolean` | Requests a minimal popup window instead of a new tab, with UI features decided by the browser. |
+ | `width` or `innerWidth` | `number` | Specifies the content area's width (minimum 100 pixels), including scrollbars. |
+ | `height` or `innerHeight` | `number` | Specifies the content area's height (minimum 100 pixels), including scrollbars. |
+ | `left` or `screenX` | `number` | Sets the horizontal position of the new window relative to the left edge of the screen. |
+ | `top` or `screenY` | `number` | Sets the vertical position of the new window relative to the top edge of the screen. |
+ | `noopener` | `boolean` | Prevents the new window from accessing the originating window via `window.opener`. |
+ | `noreferrer` | `boolean` | Prevents the Referer header from being sent and implicitly enables `noopener`. |
+
+ Refer to the [documentation](https://developer.mozilla.org/en-US/docs/Web/API/Window/open#windowfeatures) for more detailed information on the **windowFeatures** properties.
diff --git a/docs/4.api/3.utils/on-before-route-leave.md b/docs/4.api/3.utils/on-before-route-leave.md
new file mode 100644
index 000000000000..7cfe14cc9d6e
--- /dev/null
+++ b/docs/4.api/3.utils/on-before-route-leave.md
@@ -0,0 +1,11 @@
+---
+title: "onBeforeRouteLeave"
+description: The onBeforeRouteLeave composable allows registering a route guard within a component.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/router.ts
+ size: xs
+---
+
+:read-more{icon="i-simple-icons-vuedotjs" to="https://router.vuejs.org/api/functions/onbeforerouteleave" title="Vue Router Docs" target="_blank"}
diff --git a/docs/4.api/3.utils/on-before-route-update.md b/docs/4.api/3.utils/on-before-route-update.md
new file mode 100644
index 000000000000..636c63642912
--- /dev/null
+++ b/docs/4.api/3.utils/on-before-route-update.md
@@ -0,0 +1,11 @@
+---
+title: "onBeforeRouteUpdate"
+description: The onBeforeRouteUpdate composable allows registering a route guard within a component.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/router.ts
+ size: xs
+---
+
+:read-more{icon="i-simple-icons-vuedotjs" to="https://router.vuejs.org/api/functions/onbeforerouteupdate" title="Vue Router Docs" target="_blank"}
diff --git a/docs/4.api/3.utils/on-nuxt-ready.md b/docs/4.api/3.utils/on-nuxt-ready.md
new file mode 100644
index 000000000000..42c4dcd27708
--- /dev/null
+++ b/docs/4.api/3.utils/on-nuxt-ready.md
@@ -0,0 +1,25 @@
+---
+title: "onNuxtReady"
+description: The onNuxtReady composable allows running a callback after your app has finished initializing.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/ready.ts
+ size: xs
+---
+
+::important
+`onNuxtReady` only runs on the client-side. :br
+It is ideal for running code that should not block the initial rendering of your app.
+::
+
+```ts [app/plugins/ready.client.ts]
+export default defineNuxtPlugin(() => {
+ onNuxtReady(async () => {
+ const myAnalyticsLibrary = await import('my-big-analytics-library')
+ // do something with myAnalyticsLibrary
+ })
+})
+```
+
+It is 'safe' to run even after your app has initialized. In this case, then the code will be registered to run in the next idle callback.
diff --git a/docs/4.api/3.utils/prefetch-components.md b/docs/4.api/3.utils/prefetch-components.md
new file mode 100644
index 000000000000..4e27f84d6fb0
--- /dev/null
+++ b/docs/4.api/3.utils/prefetch-components.md
@@ -0,0 +1,28 @@
+---
+title: 'prefetchComponents'
+description: Nuxt provides utilities to give you control over prefetching components.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/preload.ts
+ size: xs
+---
+
+
+Prefetching component downloads the code in the background, this is based on the assumption that the component will likely be used for rendering, enabling the component to load instantly if and when the user requests it. The component is downloaded and cached for anticipated future use without the user making an explicit request for it.
+
+Use `prefetchComponents` to manually prefetch individual components that have been registered globally in your Nuxt app. By default Nuxt registers these as async components. You must use the Pascal-cased version of the component name.
+
+```ts
+await prefetchComponents('MyGlobalComponent')
+
+await prefetchComponents(['MyGlobalComponent1', 'MyGlobalComponent2'])
+```
+
+::note
+Current implementation behaves exactly the same as [`preloadComponents`](/docs/4.x/api/utils/preload-components) by preloading components instead of just prefetching we are working to improve this behavior.
+::
+
+::note
+On server, `prefetchComponents` will have no effect.
+::
diff --git a/docs/4.api/3.utils/preload-components.md b/docs/4.api/3.utils/preload-components.md
new file mode 100644
index 000000000000..33c262f76437
--- /dev/null
+++ b/docs/4.api/3.utils/preload-components.md
@@ -0,0 +1,23 @@
+---
+title: 'preloadComponents'
+description: Nuxt provides utilities to give you control over preloading components.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/preload.ts
+ size: xs
+---
+
+Preloading components loads components that your page will need very soon, which you want to start loading early in rendering lifecycle. This ensures they are available earlier and are less likely to block the page's render, improving performance.
+
+Use `preloadComponents` to manually preload individual components that have been registered globally in your Nuxt app. By default Nuxt registers these as async components. You must use the Pascal-cased version of the component name.
+
+```ts
+await preloadComponents('MyGlobalComponent')
+
+await preloadComponents(['MyGlobalComponent1', 'MyGlobalComponent2'])
+```
+
+::note
+On server, `preloadComponents` will have no effect.
+::
diff --git a/docs/4.api/3.utils/preload-route-components.md b/docs/4.api/3.utils/preload-route-components.md
new file mode 100644
index 000000000000..838b93e5a69b
--- /dev/null
+++ b/docs/4.api/3.utils/preload-route-components.md
@@ -0,0 +1,41 @@
+---
+title: 'preloadRouteComponents'
+description: preloadRouteComponents allows you to manually preload individual pages in your Nuxt app.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/preload.ts
+ size: xs
+---
+
+Preloading routes loads the components of a given route that the user might navigate to in future. This ensures that the components are available earlier and less likely to block the navigation, improving performance.
+
+::tip{icon="i-lucide-rocket"}
+Nuxt already automatically preloads the necessary routes if you're using the `NuxtLink` component.
+::
+
+:read-more{to="/docs/4.x/api/components/nuxt-link"}
+
+## Example
+
+Preload a route when using `navigateTo`.
+
+```ts
+// we don't await this async function, to avoid blocking rendering
+// this component's setup function
+preloadRouteComponents('/dashboard')
+
+const submit = async () => {
+ const results = await $fetch('/api/authentication')
+
+ if (results.token) {
+ await navigateTo('/dashboard')
+ }
+}
+```
+
+:read-more{to="/docs/4.x/api/utils/navigate-to"}
+
+::note
+On server, `preloadRouteComponents` will have no effect.
+::
diff --git a/docs/4.api/3.utils/prerender-routes.md b/docs/4.api/3.utils/prerender-routes.md
new file mode 100644
index 000000000000..f53ab26d710a
--- /dev/null
+++ b/docs/4.api/3.utils/prerender-routes.md
@@ -0,0 +1,46 @@
+---
+title: 'prerenderRoutes'
+description: prerenderRoutes hints to Nitro to prerender an additional route.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/ssr.ts
+ size: xs
+---
+
+When prerendering, you can hint to Nitro to prerender additional paths, even if their URLs do not show up in the HTML of the generated page.
+
+::important
+`prerenderRoutes` can only be called within the [Nuxt context](/docs/4.x/guide/going-further/nuxt-app#the-nuxt-context).
+::
+
+::note
+`prerenderRoutes` has to be executed during prerendering. If the `prerenderRoutes` is used in dynamic pages/routes which are not prerendered, then it will not be executed.
+::
+
+```ts
+const route = useRoute()
+
+prerenderRoutes('/')
+prerenderRoutes(['/', '/about'])
+```
+
+::note
+In the browser, or if called outside prerendering, `prerenderRoutes` will have no effect.
+::
+
+You can even prerender API routes which is particularly useful for full statically generated sites (SSG) because you can then `$fetch` data as if you have an available server!
+
+```ts
+prerenderRoutes('/api/content/article/name-of-article')
+
+// Somewhere later in App
+const articleContent = await $fetch('/api/content/article/name-of-article', {
+ responseType: 'json',
+})
+```
+
+::warning
+Prerendered API routes in production may not return the expected response headers, depending on the provider you deploy to. For example, a JSON response might be served with an `application/octet-stream` content type.
+Always manually set `responseType` when fetching prerendered API routes.
+::
diff --git a/docs/4.api/3.utils/refresh-cookie.md b/docs/4.api/3.utils/refresh-cookie.md
new file mode 100644
index 000000000000..962784ac4496
--- /dev/null
+++ b/docs/4.api/3.utils/refresh-cookie.md
@@ -0,0 +1,44 @@
+---
+title: "refreshCookie"
+description: "Refresh useCookie values manually when a cookie has changed"
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/cookie.ts
+ size: xs
+---
+
+::important
+This utility is available since [Nuxt v3.10](/blog/v3-10).
+::
+
+## Purpose
+
+The `refreshCookie` function is designed to refresh cookie value returned by `useCookie`.
+
+This is useful for updating the `useCookie` ref when we know the new cookie value has been set in the browser.
+
+## Usage
+
+```vue [app/app.vue]
+<script setup lang="ts">
+const tokenCookie = useCookie('token')
+
+const login = async (username, password) => {
+ const token = await $fetch('/api/token', { /** ... */ }) // Sets `token` cookie on response
+ refreshCookie('token')
+}
+
+const loggedIn = computed(() => !!tokenCookie.value)
+</script>
+```
+
+::note{to="/docs/4.x/guide/going-further/experimental-features#cookiestore"}
+Since [Nuxt v3.12.0](https://github.com/nuxt/nuxt/releases/tag/v3.12.0), the experimental `cookieStore` option is enabled by default. It automatically refreshes the `useCookie` value when cookies change in the browser.
+::
+
+## Type
+
+```ts [Signature]
+export function refreshCookie (name: string): void
+```
diff --git a/docs/4.api/3.utils/refresh-nuxt-data.md b/docs/4.api/3.utils/refresh-nuxt-data.md
new file mode 100644
index 000000000000..b32356df810f
--- /dev/null
+++ b/docs/4.api/3.utils/refresh-nuxt-data.md
@@ -0,0 +1,96 @@
+---
+title: 'refreshNuxtData'
+description: Refresh all or specific asyncData instances in Nuxt
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/asyncData.ts
+ size: xs
+---
+
+`refreshNuxtData` is used to refetch all or specific `asyncData` instances, including those from [`useAsyncData`](/docs/4.x/api/composables/use-async-data), [`useLazyAsyncData`](/docs/4.x/api/composables/use-lazy-async-data), [`useFetch`](/docs/4.x/api/composables/use-fetch), and [`useLazyFetch`](/docs/4.x/api/composables/use-lazy-fetch).
+
+::note
+If your component is cached by `<KeepAlive>` and enters a deactivated state, the `asyncData` inside the component will still be refetched until the component is unmounted.
+::
+
+## Type
+
+```ts [Signature]
+export function refreshNuxtData (keys?: string | string[])
+```
+
+## Parameters
+
+* `keys`: A single string or an array of strings as `keys` that are used to fetch the data. This parameter is **optional**. All [`useAsyncData`](/docs/4.x/api/composables/use-async-data) and [`useFetch`](/docs/4.x/api/composables/use-fetch) keys are re-fetched when no `keys` are explicitly specified.
+
+## Return Values
+
+`refreshNuxtData` returns a promise, resolving when all or specific `asyncData` instances have been refreshed.
+
+## Examples
+
+### Refresh All Data
+
+This example below refreshes all data being fetched using `useAsyncData` and `useFetch` in Nuxt application.
+
+```vue [app/pages/some-page.vue]
+<script setup lang="ts">
+const refreshing = ref(false)
+
+async function refreshAll () {
+ refreshing.value = true
+ try {
+ await refreshNuxtData()
+ } finally {
+ refreshing.value = false
+ }
+}
+</script>
+
+<template>
+ <div>
+ <button
+ :disabled="refreshing"
+ @click="refreshAll"
+ >
+ Refetch All Data
+ </button>
+ </div>
+</template>
+```
+
+### Refresh Specific Data
+
+This example below refreshes only data where the key matches to `count` and `user`.
+
+```vue [app/pages/some-page.vue]
+<script setup lang="ts">
+const refreshing = ref(false)
+
+async function refresh () {
+ refreshing.value = true
+ try {
+ // you could also pass an array of keys to refresh multiple data
+ await refreshNuxtData(['count', 'user'])
+ } finally {
+ refreshing.value = false
+ }
+}
+</script>
+
+<template>
+ <div v-if="refreshing">
+ Loading
+ </div>
+ <button @click="refresh">
+ Refresh
+ </button>
+</template>
+```
+
+::note
+If you have access to the `asyncData` instance, it is recommended to use its `refresh` or `execute` method as the preferred way to refetch the data.
+::
+
+:read-more{to="/docs/4.x/getting-started/data-fetching"}
diff --git a/docs/4.api/3.utils/reload-nuxt-app.md b/docs/4.api/3.utils/reload-nuxt-app.md
new file mode 100644
index 000000000000..850e01d3a43b
--- /dev/null
+++ b/docs/4.api/3.utils/reload-nuxt-app.md
@@ -0,0 +1,74 @@
+---
+title: 'reloadNuxtApp'
+description: reloadNuxtApp will perform a hard reload of the page.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/chunk.ts
+ size: xs
+---
+
+::note
+`reloadNuxtApp` will perform a hard reload of your app, re-requesting a page and its dependencies from the server.
+::
+
+By default, it will also save the current `state` of your app (that is, any state you could access with `useState`).
+
+::read-more{to="/docs/4.x/guide/going-further/experimental-features#restorestate" icon="i-lucide-star"}
+You can enable experimental restoration of this state by enabling the `experimental.restoreState` option in your `nuxt.config` file.
+::
+
+## Type
+
+```ts [Signature]
+export function reloadNuxtApp (options?: ReloadNuxtAppOptions)
+
+interface ReloadNuxtAppOptions {
+ ttl?: number
+ force?: boolean
+ path?: string
+ persistState?: boolean
+}
+```
+
+### `options` (optional)
+
+**Type**: `ReloadNuxtAppOptions`
+
+An object accepting the following properties:
+
+- `path` (optional)
+
+ **Type**: `string`
+
+ **Default**: `window.location.pathname`
+
+ The path to reload (defaulting to the current path). If this is different from the current window location it
+ will trigger a navigation and add an entry in the browser history.
+
+- `ttl` (optional)
+
+ **Type**: `number`
+
+ **Default**: `10000`
+
+ The number of milliseconds in which to ignore future reload requests. If called again within this time period,
+ `reloadNuxtApp` will not reload your app to avoid reload loops.
+
+- `force` (optional)
+
+ **Type**: `boolean`
+
+ **Default**: `false`
+
+ This option allows bypassing reload loop protection entirely, forcing a reload even if one has occurred within
+ the previously specified TTL.
+
+- `persistState` (optional)
+
+ **Type**: `boolean`
+
+ **Default**: `false`
+
+ Whether to dump the current Nuxt state to sessionStorage (as `nuxt:reload:state`). By default this will have no
+ effect on reload unless `experimental.restoreState` is also set, or unless you handle restoring the state yourself.
diff --git a/docs/4.api/3.utils/set-page-layout.md b/docs/4.api/3.utils/set-page-layout.md
new file mode 100644
index 000000000000..9609c5064aec
--- /dev/null
+++ b/docs/4.api/3.utils/set-page-layout.md
@@ -0,0 +1,60 @@
+---
+title: 'setPageLayout'
+description: setPageLayout allows you to dynamically change the layout of a page.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/router.ts
+ size: xs
+---
+
+::important
+`setPageLayout` allows you to dynamically change the layout of a page. It relies on access to the Nuxt context and therefore can only be called within the [Nuxt context](/docs/4.x/guide/going-further/nuxt-app#the-nuxt-context).
+::
+
+```ts [app/middleware/custom-layout.ts]
+export default defineNuxtRouteMiddleware((to) => {
+ // Set the layout on the route you are navigating _to_
+ setPageLayout('other')
+})
+```
+
+## Passing Props to Layouts
+
+You can pass props to the layout by providing an object as the second argument:
+
+```ts [app/middleware/admin-layout.ts]
+export default defineNuxtRouteMiddleware((to) => {
+ setPageLayout('admin', {
+ sidebar: true,
+ title: 'Dashboard',
+ })
+})
+```
+
+The layout can then receive these props:
+
+```vue [app/layouts/admin.vue]
+<script setup lang="ts">
+const props = defineProps<{
+ sidebar?: boolean
+ title?: string
+}>()
+</script>
+
+<template>
+ <div>
+ <aside v-if="sidebar">
+ Sidebar
+ </aside>
+ <main>
+ <h1>{{ title }}</h1>
+ <slot />
+ </main>
+ </div>
+</template>
+```
+
+::note
+If you choose to set the layout dynamically on the server side, you _must_ do so before the layout is rendered by Vue (that is, within a plugin or route middleware) to avoid a hydration mismatch.
+::
diff --git a/docs/4.api/3.utils/set-response-status.md b/docs/4.api/3.utils/set-response-status.md
new file mode 100644
index 000000000000..e996e196d386
--- /dev/null
+++ b/docs/4.api/3.utils/set-response-status.md
@@ -0,0 +1,36 @@
+---
+title: 'setResponseStatus'
+description: setResponseStatus sets the status (and optionally the statusText) of the response.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/ssr.ts
+ size: xs
+---
+
+Nuxt provides composables and utilities for first-class server-side-rendering support.
+
+`setResponseStatus` sets the status (and optionally the statusText) of the response.
+
+::important
+`setResponseStatus` can only be called in the [Nuxt context](/docs/4.x/guide/going-further/nuxt-app#the-nuxt-context).
+::
+
+```ts
+const event = useRequestEvent()
+
+// event will be undefined in the browser
+if (event) {
+ // Set the status code to 404 for a custom 404 page
+ setResponseStatus(event, 404)
+
+ // Set the status message as well
+ setResponseStatus(event, 404, 'Page Not Found')
+}
+```
+
+::note
+In the browser, `setResponseStatus` will have no effect.
+::
+
+:read-more{to="/docs/4.x/getting-started/error-handling"}
diff --git a/docs/4.api/3.utils/show-error.md b/docs/4.api/3.utils/show-error.md
new file mode 100644
index 000000000000..70f2d6f111dd
--- /dev/null
+++ b/docs/4.api/3.utils/show-error.md
@@ -0,0 +1,31 @@
+---
+title: 'showError'
+description: Nuxt provides a quick and simple way to show a full screen error page if needed.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/error.ts
+ size: xs
+---
+
+Within the [Nuxt context](/docs/4.x/guide/going-further/nuxt-app#the-nuxt-context) you can use `showError` to show an error.
+
+**Parameters:**
+
+- `error`: `string | Error | Partial<{ cause, data, message, name, stack, status, statusText }>`
+
+```ts
+showError('😱 Oh no, an error has been thrown.')
+showError({
+ status: 404,
+ statusText: 'Page Not Found',
+})
+```
+
+The error is set in the state using [`useError()`](/docs/4.x/api/composables/use-error) to create a reactive and SSR-friendly shared error state across components.
+
+::tip
+`showError` calls the `app:error` hook.
+::
+
+:read-more{to="/docs/4.x/getting-started/error-handling"}
diff --git a/docs/4.api/3.utils/update-app-config.md b/docs/4.api/3.utils/update-app-config.md
new file mode 100644
index 000000000000..ea015bda5686
--- /dev/null
+++ b/docs/4.api/3.utils/update-app-config.md
@@ -0,0 +1,28 @@
+---
+title: 'updateAppConfig'
+description: 'Update the App Config at runtime.'
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/config.ts
+ size: xs
+---
+
+::note
+Updates the [`app.config`](/docs/4.x/directory-structure/app/app-config) using deep assignment. Existing (nested) properties will be preserved.
+::
+
+## Usage
+
+```js
+import { updateAppConfig, useAppConfig } from '#imports'
+
+const appConfig = useAppConfig() // { foo: 'bar' }
+
+const newAppConfig = { foo: 'baz' }
+updateAppConfig(newAppConfig)
+
+console.log(appConfig) // { foo: 'baz' }
+```
+
+:read-more{to="/docs/4.x/directory-structure/app/app-config"}
diff --git a/docs/4.api/4.commands/.navigation.yml b/docs/4.api/4.commands/.navigation.yml
new file mode 100644
index 000000000000..664fa8a91889
--- /dev/null
+++ b/docs/4.api/4.commands/.navigation.yml
@@ -0,0 +1,3 @@
+title: 'Commands'
+titleTemplate: '%s · Nuxt Commands'
+icon: i-lucide-square-terminal
diff --git a/docs/4.api/4.commands/add.md b/docs/4.api/4.commands/add.md
new file mode 100644
index 000000000000..1293f915d9c9
--- /dev/null
+++ b/docs/4.api/4.commands/add.md
@@ -0,0 +1,112 @@
+---
+title: "nuxt add"
+description: "Scaffold an entity into your Nuxt application."
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/cli/blob/main/packages/nuxi/src/commands/add-template.ts
+ size: xs
+---
+
+<!--add-cmd-->
+```bash [Terminal]
+npx nuxt add <TEMPLATE> <NAME> [--cwd=<directory>] [--logLevel=<silent|info|verbose>] [--force]
+```
+<!--/add-cmd-->
+
+## Arguments
+
+<!--add-args-->
+| Argument | Description |
+|------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `TEMPLATE` | Specify which template to generate (options: <api\|app\|app-config\|component\|composable\|error\|layer\|layout\|middleware\|module\|page\|plugin\|server-middleware\|server-plugin\|server-route\|server-util>) |
+| `NAME` | Specify name of the generated file |
+<!--/add-args-->
+
+## Options
+
+<!--add-opts-->
+| Option | Default | Description |
+|--------------------------------------|---------|------------------------------------------|
+| `--cwd=<directory>` | `.` | Specify the working directory |
+| `--logLevel=<silent\|info\|verbose>` | | Specify build-time log level |
+| `--force` | `false` | Force override file if it already exists |
+<!--/add-opts-->
+
+**Modifiers:**
+
+Some templates support additional modifier flags to add a suffix (like `.client` or `.get`) to their name.
+
+```bash [Terminal]
+# Generates `/plugins/sockets.client.ts`
+npx nuxt add plugin sockets --client
+```
+
+## `nuxt add component`
+
+* Modifier flags: `--mode client|server` or `--client` or `--server`
+
+```bash [Terminal]
+# Generates `app/components/TheHeader.vue`
+npx nuxt add component TheHeader
+```
+
+## `nuxt add composable`
+
+```bash [Terminal]
+# Generates `app/composables/foo.ts`
+npx nuxt add composable foo
+```
+
+## `nuxt add layout`
+
+```bash [Terminal]
+# Generates `app/layouts/custom.vue`
+npx nuxt add layout custom
+```
+
+## `nuxt add plugin`
+
+* Modifier flags: `--mode client|server` or `--client`or `--server`
+
+```bash [Terminal]
+# Generates `app/plugins/analytics.ts`
+npx nuxt add plugin analytics
+```
+
+## `nuxt add page`
+
+```bash [Terminal]
+# Generates `app/pages/about.vue`
+npx nuxt add page about
+```
+
+```bash [Terminal]
+# Generates `app/pages/category/[id].vue`
+npx nuxt add page "category/[id]"
+```
+
+## `nuxt add middleware`
+
+* Modifier flags: `--global`
+
+```bash [Terminal]
+# Generates `app/middleware/auth.ts`
+npx nuxt add middleware auth
+```
+
+## `nuxt add api`
+
+* Modifier flags: `--method` (can accept `connect`, `delete`, `get`, `head`, `options`, `patch`, `post`, `put` or `trace`) or alternatively you can directly use `--get`, `--post`, etc.
+
+```bash [Terminal]
+# Generates `server/api/hello.ts`
+npx nuxt add api hello
+```
+
+## `nuxt add layer`
+
+```bash [Terminal]
+# Generates `layers/subscribe/nuxt.config.ts`
+npx nuxt add layer subscribe
+```
diff --git a/docs/4.api/4.commands/analyze.md b/docs/4.api/4.commands/analyze.md
new file mode 100644
index 000000000000..39110f6807b6
--- /dev/null
+++ b/docs/4.api/4.commands/analyze.md
@@ -0,0 +1,42 @@
+---
+title: "nuxt analyze"
+description: "Analyze the production bundle or your Nuxt application."
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/cli/blob/main/packages/nuxi/src/commands/analyze.ts
+ size: xs
+---
+
+<!--analyze-cmd-->
+```bash [Terminal]
+npx nuxt analyze [ROOTDIR] [--cwd=<directory>] [--logLevel=<silent|info|verbose>] [--dotenv] [-e, --extends=<layer-name>] [--name=<name>] [--no-serve]
+```
+<!--/analyze-cmd-->
+
+The `analyze` command builds Nuxt and analyzes the production bundle (experimental).
+
+## Arguments
+
+<!--analyze-args-->
+| Argument | Description |
+|---------------|------------------------------------------------|
+| `ROOTDIR="."` | Specifies the working directory (default: `.`) |
+<!--/analyze-args-->
+
+## Options
+
+<!--analyze-opts-->
+| Option | Default | Description |
+|--------------------------------------|-----------|----------------------------------------------------------------------------------|
+| `--cwd=<directory>` | | Specify the working directory, this takes precedence over ROOTDIR (default: `.`) |
+| `--logLevel=<silent\|info\|verbose>` | | Specify build-time log level |
+| `--dotenv` | | Path to `.env` file to load, relative to the root directory |
+| `-e, --extends=<layer-name>` | | Extend from a Nuxt layer |
+| `--name=<name>` | `default` | Name of the analysis |
+| `--no-serve` | | Skip serving the analysis results |
+<!--/analyze-opts-->
+
+::note
+This command sets `process.env.NODE_ENV` to `production`.
+::
diff --git a/docs/4.api/4.commands/build-module.md b/docs/4.api/4.commands/build-module.md
new file mode 100644
index 000000000000..23e394810daf
--- /dev/null
+++ b/docs/4.api/4.commands/build-module.md
@@ -0,0 +1,42 @@
+---
+title: 'nuxt build-module'
+description: 'Nuxt command to build your Nuxt module before publishing.'
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/module-builder/blob/main/src/cli.ts
+ size: xs
+---
+
+<!--build-module-cmd-->
+```bash [Terminal]
+npx nuxt build-module [ROOTDIR] [--cwd=<directory>] [--logLevel=<silent|info|verbose>] [--build] [--stub] [--sourcemap] [--prepare]
+```
+<!--/build-module-cmd-->
+
+The `build-module` command runs `@nuxt/module-builder` to generate `dist` directory within your `rootDir` that contains the full build for your **nuxt-module**.
+
+## Arguments
+
+<!--build-module-args-->
+| Argument | Description |
+|---------------|------------------------------------------------|
+| `ROOTDIR="."` | Specifies the working directory (default: `.`) |
+<!--/build-module-args-->
+
+## Options
+
+<!--build-module-opts-->
+| Option | Default | Description |
+|--------------------------------------|---------|----------------------------------------------------------------------------------|
+| `--cwd=<directory>` | | Specify the working directory, this takes precedence over ROOTDIR (default: `.`) |
+| `--logLevel=<silent\|info\|verbose>` | | Specify build-time log level |
+| `--build` | `false` | Build module for distribution |
+| `--stub` | `false` | Stub dist instead of actually building it for development |
+| `--sourcemap` | `false` | Generate sourcemaps |
+| `--prepare` | `false` | Prepare module for local development |
+<!--/build-module-opts-->
+
+::read-more{to="https://github.com/nuxt/module-builder" icon="i-simple-icons-github" target="\_blank"}
+Read more about `@nuxt/module-builder`.
+::
diff --git a/docs/4.api/4.commands/build.md b/docs/4.api/4.commands/build.md
new file mode 100644
index 000000000000..b1afdae0aab4
--- /dev/null
+++ b/docs/4.api/4.commands/build.md
@@ -0,0 +1,48 @@
+---
+title: "nuxt build"
+description: "Build your Nuxt application."
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/cli/blob/main/packages/nuxi/src/commands/build.ts
+ size: xs
+---
+
+<!--build-cmd-->
+```bash [Terminal]
+npx nuxt build [ROOTDIR] [--cwd=<directory>] [--logLevel=<silent|info|verbose>] [--prerender] [--preset] [--dotenv] [--envName] [-e, --extends=<layer-name>] [--profile[=verbose]]
+```
+<!--/build-cmd-->
+
+The `build` command creates a `.output` directory with all your application, server and dependencies ready for production.
+
+## Arguments
+
+<!--build-args-->
+| Argument | Description |
+|---------------|------------------------------------------------|
+| `ROOTDIR="."` | Specifies the working directory (default: `.`) |
+<!--/build-args-->
+
+## Options
+
+<!--build-opts-->
+| Option | Default | Description |
+|--------------------------------------|---------|------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `--cwd=<directory>` | | Specify the working directory, this takes precedence over ROOTDIR (default: `.`) |
+| `--logLevel=<silent\|info\|verbose>` | | Specify build-time log level |
+| `--prerender` | | Build Nuxt and prerender static routes |
+| `--preset=<preset>` | | Specify Nitro server preset. Available presets depend on Nitro (e.g. `node-server`, `vercel`, `netlify`, `static`) |
+| `--dotenv` | | Path to `.env` file to load, relative to the root directory |
+| `--envName` | | The environment to use when resolving configuration overrides (default is `production` when building, and `development` when running the dev server) |
+| `-e, --extends=<layer-name>` | | Extend from a Nuxt layer |
+| `--profile` | | Profile performance (v4.4+). Writes a V8 CPU profile and JSON report on exit. Use `--profile=verbose` for a full console report. |
+<!--/build-opts-->
+
+::note
+This command sets `process.env.NODE_ENV` to `production`.
+::
+
+::note
+`--prerender` will always set the `preset` to `static`
+::
diff --git a/docs/4.api/4.commands/cleanup.md b/docs/4.api/4.commands/cleanup.md
new file mode 100644
index 000000000000..1bbeb9745162
--- /dev/null
+++ b/docs/4.api/4.commands/cleanup.md
@@ -0,0 +1,38 @@
+---
+title: 'nuxt cleanup'
+description: 'Remove common generated Nuxt files and caches.'
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/cli/blob/main/packages/nuxi/src/commands/cleanup.ts
+ size: xs
+---
+
+<!--cleanup-cmd-->
+```bash [Terminal]
+npx nuxt cleanup [ROOTDIR] [--cwd=<directory>]
+```
+<!--/cleanup-cmd-->
+
+The `cleanup` command removes common generated Nuxt files and caches, including:
+
+- `.nuxt`
+- `.output`
+- `node_modules/.vite`
+- `node_modules/.cache`
+
+## Arguments
+
+<!--cleanup-args-->
+| Argument | Description |
+|---------------|------------------------------------------------|
+| `ROOTDIR="."` | Specifies the working directory (default: `.`) |
+<!--/cleanup-args-->
+
+## Options
+
+<!--cleanup-opts-->
+| Option | Default | Description |
+|---------------------|---------|----------------------------------------------------------------------------------|
+| `--cwd=<directory>` | | Specify the working directory, this takes precedence over ROOTDIR (default: `.`) |
+<!--/cleanup-opts-->
diff --git a/docs/4.api/4.commands/dev.md b/docs/4.api/4.commands/dev.md
new file mode 100644
index 000000000000..c83fd6ab0cd9
--- /dev/null
+++ b/docs/4.api/4.commands/dev.md
@@ -0,0 +1,61 @@
+---
+title: 'nuxt dev'
+description: The dev command starts a development server with hot module replacement at http://localhost:3000
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/cli/blob/main/packages/nuxi/src/commands/dev.ts
+ size: xs
+---
+
+<!--dev-cmd-->
+```bash [Terminal]
+npx nuxt dev [ROOTDIR] [--cwd=<directory>] [--logLevel=<silent|info|verbose>] [--dotenv] [--envName] [-e, --extends=<layer-name>] [--clear] [--no-f, --no-fork] [-p, --port] [-h, --host] [--clipboard] [-o, --open] [--https] [--publicURL] [--qr] [--public] [--tunnel] [--profile[=verbose]] [--sslCert] [--sslKey]
+```
+<!--/dev-cmd-->
+
+The `dev` command starts a development server with hot module replacement at [http://localhost:3000](https://localhost:3000)
+
+## Arguments
+
+<!--dev-args-->
+| Argument | Description |
+|---------------|------------------------------------------------|
+| `ROOTDIR="."` | Specifies the working directory (default: `.`) |
+<!--/dev-args-->
+
+## Options
+
+<!--dev-opts-->
+| Option | Default | Description |
+|--------------------------------------|---------|------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `--cwd=<directory>` | | Specify the working directory, this takes precedence over ROOTDIR (default: `.`) |
+| `--logLevel=<silent\|info\|verbose>` | | Specify build-time log level |
+| `--dotenv` | | Path to `.env` file to load, relative to the root directory |
+| `--envName` | | The environment to use when resolving configuration overrides (default is `production` when building, and `development` when running the dev server) |
+| `-e, --extends=<layer-name>` | | Extend from a Nuxt layer |
+| `--clear` | `false` | Clear console on restart |
+| `--no-f, --no-fork` | | Disable forked mode |
+| `-p, --port` | | Port to listen on (default: `NUXT_PORT \|\| NITRO_PORT \|\| PORT \|\| nuxtOptions.devServer.port`) |
+| `-h, --host` | | Host to listen on (default: `NUXT_HOST \|\| NITRO_HOST \|\| HOST \|\| nuxtOptions.devServer?.host`) |
+| `--clipboard` | `false` | Copy the URL to the clipboard |
+| `-o, --open` | `false` | Open the URL in the browser |
+| `--https` | | Enable HTTPS |
+| `--publicURL` | | Displayed public URL (used for QR code) |
+| `--qr` | | Display The QR code of public URL when available |
+| `--public` | | Listen to all network interfaces |
+| `--tunnel` | | Open a tunnel using https://github.com/unjs/untun |
+| `--profile` | | Profile performance (v4.4+). Writes a V8 CPU profile and JSON report on exit. Use `--profile=verbose` for a full console report. |
+| `--sslCert` | | (DEPRECATED) Use `--https.cert` instead. |
+| `--sslKey` | | (DEPRECATED) Use `--https.key` instead. |
+<!--/dev-opts-->
+
+The port and host can also be set via NUXT_PORT, PORT, NUXT_HOST or HOST environment variables.
+
+Additionally to the above options, `@nuxt/cli` can pass options through to `listhen`, e.g. `--no-qr` to turn off the dev server QR code. You can find the list of `listhen` options in the [unjs/listhen](https://github.com/unjs/listhen) docs.
+
+This command sets `process.env.NODE_ENV` to `development`.
+
+::note
+If you are using a self-signed certificate in development, you will need to set `NODE_TLS_REJECT_UNAUTHORIZED=0` in your environment.
+::
diff --git a/docs/4.api/4.commands/devtools.md b/docs/4.api/4.commands/devtools.md
new file mode 100644
index 000000000000..caac28f2a74f
--- /dev/null
+++ b/docs/4.api/4.commands/devtools.md
@@ -0,0 +1,38 @@
+---
+title: "nuxt devtools"
+description: The devtools command allows you to enable or disable Nuxt DevTools on a per-project basis.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/cli/blob/main/packages/nuxi/src/commands/devtools.ts
+ size: xs
+---
+
+<!--devtools-cmd-->
+```bash [Terminal]
+npx nuxt devtools <COMMAND> [ROOTDIR] [--cwd=<directory>]
+```
+<!--/devtools-cmd-->
+
+Running `nuxt devtools enable` will install the Nuxt DevTools globally, and also enable it within the particular project you are using. It is saved as a preference in your user-level `.nuxtrc`. If you want to remove devtools support for a particular project, you can run `nuxt devtools disable`.
+
+## Arguments
+
+<!--devtools-args-->
+| Argument | Description |
+|---------------|------------------------------------------------|
+| `COMMAND` | Command to run (options: <enable\|disable>) |
+| `ROOTDIR="."` | Specifies the working directory (default: `.`) |
+<!--/devtools-args-->
+
+## Options
+
+<!--devtools-opts-->
+| Option | Default | Description |
+|---------------------|---------|----------------------------------------------------------------------------------|
+| `--cwd=<directory>` | | Specify the working directory, this takes precedence over ROOTDIR (default: `.`) |
+<!--/devtools-opts-->
+
+::read-more{icon="i-simple-icons-nuxtdotjs" to="https://devtools.nuxt.com" target="\_blank"}
+Read more about the **Nuxt DevTools**.
+::
diff --git a/docs/4.api/4.commands/generate.md b/docs/4.api/4.commands/generate.md
new file mode 100644
index 000000000000..ec1a01a85d28
--- /dev/null
+++ b/docs/4.api/4.commands/generate.md
@@ -0,0 +1,43 @@
+---
+title: "nuxt generate"
+description: Pre-renders every route of the application and stores the result in plain HTML files.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/cli/blob/main/packages/nuxi/src/commands/generate.ts
+ size: xs
+---
+
+<!--generate-cmd-->
+```bash [Terminal]
+npx nuxt generate [ROOTDIR] [--cwd=<directory>] [--logLevel=<silent|info|verbose>] [--preset] [--dotenv] [--envName] [-e, --extends=<layer-name>] [--profile[=verbose]]
+```
+<!--/generate-cmd-->
+
+The `generate` command pre-renders every route of your application and stores the result in plain HTML files that you can deploy on any static hosting services. The command triggers the `nuxt build` command with the `prerender` argument set to `true`
+
+## Arguments
+
+<!--generate-args-->
+| Argument | Description |
+|---------------|------------------------------------------------|
+| `ROOTDIR="."` | Specifies the working directory (default: `.`) |
+<!--/generate-args-->
+
+## Options
+
+<!--generate-opts-->
+| Option | Default | Description |
+|--------------------------------------|---------|------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `--cwd=<directory>` | | Specify the working directory, this takes precedence over ROOTDIR (default: `.`) |
+| `--logLevel=<silent\|info\|verbose>` | | Specify build-time log level |
+| `--preset` | | Nitro server preset |
+| `--dotenv` | | Path to `.env` file to load, relative to the root directory |
+| `--envName` | | The environment to use when resolving configuration overrides (default is `production` when building, and `development` when running the dev server) |
+| `-e, --extends=<layer-name>` | | Extend from a Nuxt layer |
+| `--profile` | | Profile performance (v4.4+). Writes a V8 CPU profile and JSON report on exit. Use `--profile=verbose` for a full console report. |
+<!--/generate-opts-->
+
+::read-more{to="/docs/4.x/getting-started/deployment#static-hosting"}
+Read more about pre-rendering and static hosting.
+::
diff --git a/docs/4.api/4.commands/info.md b/docs/4.api/4.commands/info.md
new file mode 100644
index 000000000000..d175b6e88276
--- /dev/null
+++ b/docs/4.api/4.commands/info.md
@@ -0,0 +1,33 @@
+---
+title: "nuxt info"
+description: The info command logs information about the current or specified Nuxt project.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/cli/blob/main/packages/nuxi/src/commands/info.ts
+ size: xs
+---
+
+<!--info-cmd-->
+```bash [Terminal]
+npx nuxt info [ROOTDIR] [--cwd=<directory>]
+```
+<!--/info-cmd-->
+
+The `info` command logs information about the current or specified Nuxt project.
+
+## Arguments
+
+<!--info-args-->
+| Argument | Description |
+|---------------|------------------------------------------------|
+| `ROOTDIR="."` | Specifies the working directory (default: `.`) |
+<!--/info-args-->
+
+## Options
+
+<!--info-opts-->
+| Option | Default | Description |
+|---------------------|---------|----------------------------------------------------------------------------------|
+| `--cwd=<directory>` | | Specify the working directory, this takes precedence over ROOTDIR (default: `.`) |
+<!--/info-opts-->
diff --git a/docs/4.api/4.commands/init.md b/docs/4.api/4.commands/init.md
new file mode 100644
index 000000000000..44654536e2ad
--- /dev/null
+++ b/docs/4.api/4.commands/init.md
@@ -0,0 +1,50 @@
+---
+title: "create nuxt"
+description: The init command initializes a fresh Nuxt project.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/cli/blob/main/packages/nuxi/src/commands/init.ts
+ size: xs
+---
+
+<!--init-cmd-->
+```bash [Terminal]
+npm create nuxt@latest [DIR] [--cwd=<directory>] [--logLevel=<silent|info|verbose>] [-t, --template] [-f, --force] [--offline] [--preferOffline] [--no-install] [--gitInit] [--shell] [--packageManager] [-M, --modules] [--no-modules] [--nightly]
+```
+<!--/init-cmd-->
+
+The `create-nuxt` command initializes a fresh Nuxt project using [unjs/giget](https://github.com/unjs/giget).
+
+## Arguments
+
+<!--init-args-->
+| Argument | Description |
+|----------|-------------------|
+| `DIR=""` | Project directory |
+<!--/init-args-->
+
+## Options
+
+<!--init-opts-->
+| Option | Default | Description |
+|--------------------------------------|---------|----------------------------------------------------------|
+| `--cwd=<directory>` | `.` | Specify the working directory |
+| `--logLevel=<silent\|info\|verbose>` | | Specify build-time log level |
+| `-t, --template` | | Template name |
+| `-f, --force` | | Override existing directory |
+| `--offline` | | Force offline mode |
+| `--preferOffline` | | Prefer offline mode |
+| `--no-install` | | Skip installing dependencies |
+| `--gitInit` | | Initialize git repository |
+| `--shell` | | Start shell after installation in project directory |
+| `--packageManager` | | Package manager choice (npm, pnpm, yarn, bun) |
+| `-M, --modules` | | Nuxt modules to install (comma separated without spaces) |
+| `--no-modules` | | Skip module installation prompt |
+| `--nightly` | | Use Nuxt nightly release channel (3x or latest) |
+<!--/init-opts-->
+
+## Environment variables
+
+- `NUXI_INIT_REGISTRY`: Set to a custom template registry. ([learn more](https://github.com/unjs/giget#custom-registry)).
+ - Default registry is loaded from [nuxt/starter/templates](https://github.com/nuxt/starter/tree/templates/templates)
diff --git a/docs/4.api/4.commands/module.md b/docs/4.api/4.commands/module.md
new file mode 100644
index 000000000000..64b578a75caa
--- /dev/null
+++ b/docs/4.api/4.commands/module.md
@@ -0,0 +1,84 @@
+---
+title: "nuxt module"
+description: "Search and add modules to your Nuxt application with the command line."
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/cli/tree/main/packages/nuxi/src/commands/module
+ size: xs
+---
+
+Nuxt provides a few utilities to work with [Nuxt modules](/modules) seamlessly.
+
+## nuxt module add
+
+<!--module-add-cmd-->
+```bash [Terminal]
+npx nuxt module add <MODULENAME> [--cwd=<directory>] [--logLevel=<silent|info|verbose>] [--skipInstall] [--skipConfig] [--dev]
+```
+<!--/module-add-cmd-->
+
+<!--module-add-args-->
+| Argument | Description |
+|--------------|---------------------------------------------------------------------|
+| `MODULENAME` | Specify one or more modules to install by name, separated by spaces |
+<!--/module-add-args-->
+
+<!--module-add-opts-->
+| Option | Default | Description |
+|--------------------------------------|---------|-------------------------------------|
+| `--cwd=<directory>` | `.` | Specify the working directory |
+| `--logLevel=<silent\|info\|verbose>` | | Specify build-time log level |
+| `--skipInstall` | | Skip npm install |
+| `--skipConfig` | | Skip nuxt.config.ts update |
+| `--dev` | | Install modules as dev dependencies |
+<!--/module-add-opts-->
+
+The command lets you install [Nuxt modules](/modules) in your application with no manual work.
+
+When running the command, it will:
+
+- install the module as a dependency using your package manager
+- add it to your [package.json](/docs/4.x/directory-structure/package) file
+- update your [`nuxt.config`](/docs/4.x/directory-structure/nuxt-config) file
+
+**Example:**
+
+Installing the [`Pinia`](/modules/pinia) module
+
+```bash [Terminal]
+npx nuxt module add pinia
+```
+
+## nuxt module search
+
+<!--module-search-cmd-->
+```bash [Terminal]
+npx nuxt module search <QUERY> [--cwd=<directory>] [--nuxtVersion=<2|3>]
+```
+<!--/module-search-cmd-->
+
+### Arguments
+
+<!--module-search-args-->
+| Argument | Description |
+|----------|------------------------|
+| `QUERY` | keywords to search for |
+<!--/module-search-args-->
+
+### Options
+
+<!--module-search-opts-->
+| Option | Default | Description |
+|------------------------|---------|------------------------------------------------------------------------------------|
+| `--cwd=<directory>` | `.` | Specify the working directory |
+| `--nuxtVersion=<2\|3>` | | Filter by Nuxt version and list compatible modules only (auto detected by default) |
+<!--/module-search-opts-->
+
+The command searches for Nuxt modules matching your query that are compatible with your Nuxt version.
+
+**Example:**
+
+```bash [Terminal]
+npx nuxt module search pinia
+```
diff --git a/docs/4.api/4.commands/prepare.md b/docs/4.api/4.commands/prepare.md
new file mode 100644
index 000000000000..5ccf9603b4b7
--- /dev/null
+++ b/docs/4.api/4.commands/prepare.md
@@ -0,0 +1,41 @@
+---
+title: 'nuxt prepare'
+description: The prepare command creates a .nuxt directory in your application and generates types.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/cli/blob/main/packages/nuxi/src/commands/prepare.ts
+ size: xs
+---
+
+<!--prepare-cmd-->
+```bash [Terminal]
+npx nuxt prepare [ROOTDIR] [--dotenv] [--cwd=<directory>] [--logLevel=<silent|info|verbose>] [--envName] [-e, --extends=<layer-name>]
+```
+<!--/prepare-cmd-->
+
+The `prepare` command creates a [`.nuxt`](/docs/4.x/directory-structure/nuxt) directory in your application and generates types. This can be useful in a CI environment or as a `postinstall` command in your [`package.json`](/docs/4.x/directory-structure/package).
+
+## Arguments
+
+<!--prepare-args-->
+| Argument | Description |
+|---------------|------------------------------------------------|
+| `ROOTDIR="."` | Specifies the working directory (default: `.`) |
+<!--/prepare-args-->
+
+## Options
+
+<!--prepare-opts-->
+| Option | Default | Description |
+|--------------------------------------|---------|------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `--dotenv` | | Path to `.env` file to load, relative to the root directory |
+| `--cwd=<directory>` | | Specify the working directory, this takes precedence over ROOTDIR (default: `.`) |
+| `--logLevel=<silent\|info\|verbose>` | | Specify build-time log level |
+| `--envName` | | The environment to use when resolving configuration overrides (default is `production` when building, and `development` when running the dev server) |
+| `-e, --extends=<layer-name>` | | Extend from a Nuxt layer |
+<!--/prepare-opts-->
+
+::note
+This command sets `process.env.NODE_ENV` to `production`.
+::
diff --git a/docs/4.api/4.commands/preview.md b/docs/4.api/4.commands/preview.md
new file mode 100644
index 000000000000..6dcde40c004c
--- /dev/null
+++ b/docs/4.api/4.commands/preview.md
@@ -0,0 +1,44 @@
+---
+title: "nuxt preview"
+description: The preview command starts a server to preview your application after the build command.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/cli/blob/main/packages/nuxi/src/commands/preview.ts
+ size: xs
+---
+
+<!--preview-cmd-->
+```bash [Terminal]
+npx nuxt preview [ROOTDIR] [--cwd=<directory>] [--logLevel=<silent|info|verbose>] [--envName] [-e, --extends=<layer-name>] [-p, --port] [--dotenv]
+```
+<!--/preview-cmd-->
+
+The `preview` command starts a server to preview your Nuxt application after running the `build` command. The `start` command is an alias for `preview`. When running your application in production refer to the [Deployment section](/docs/4.x/getting-started/deployment).
+
+## Arguments
+
+<!--preview-args-->
+| Argument | Description |
+|---------------|------------------------------------------------|
+| `ROOTDIR="."` | Specifies the working directory (default: `.`) |
+<!--/preview-args-->
+
+## Options
+
+<!--preview-opts-->
+| Option | Default | Description |
+|--------------------------------------|---------|------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `--cwd=<directory>` | | Specify the working directory, this takes precedence over ROOTDIR (default: `.`) |
+| `--logLevel=<silent\|info\|verbose>` | | Specify build-time log level |
+| `--envName` | | The environment to use when resolving configuration overrides (default is `production` when building, and `development` when running the dev server) |
+| `-e, --extends=<layer-name>` | | Extend from a Nuxt layer |
+| `-p, --port` | | Port to listen on (use `PORT` environment variable to override) |
+| `--dotenv` | | Path to `.env` file to load, relative to the root directory |
+<!--/preview-opts-->
+
+This command sets `process.env.NODE_ENV` to `production`. To override, define `NODE_ENV` in a `.env` file or as command-line argument.
+
+::note
+For convenience, in preview mode, your [`.env`](/docs/4.x/directory-structure/env) file will be loaded into `process.env`. (However, in production you will need to ensure your environment variables are set yourself. For example, with Node.js 20+ you could do this by running `NODE_ENV=production node --env-file .env .output/server/index.mjs` to start your server.)
+::
diff --git a/docs/4.api/4.commands/test.md b/docs/4.api/4.commands/test.md
new file mode 100644
index 000000000000..975d7da857bc
--- /dev/null
+++ b/docs/4.api/4.commands/test.md
@@ -0,0 +1,40 @@
+---
+title: "nuxt test"
+description: The test command runs tests using @nuxt/test-utils.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/cli/blob/main/packages/nuxi/src/commands/test.ts
+ size: xs
+---
+
+<!--test-cmd-->
+```bash [Terminal]
+npx nuxt test [ROOTDIR] [--cwd=<directory>] [--logLevel=<silent|info|verbose>] [--dev] [--watch]
+```
+<!--/test-cmd-->
+
+The `test` command runs tests using [`@nuxt/test-utils`](/docs/getting-started/testing). This command sets `process.env.NODE_ENV` to `test` if not already set.
+
+## Arguments
+
+<!--test-args-->
+| Argument | Description |
+|---------------|------------------------------------------------|
+| `ROOTDIR="."` | Specifies the working directory (default: `.`) |
+<!--/test-args-->
+
+## Options
+
+<!--test-opts-->
+| Option | Default | Description |
+|--------------------------------------|---------|----------------------------------------------------------------------------------|
+| `--cwd=<directory>` | | Specify the working directory, this takes precedence over ROOTDIR (default: `.`) |
+| `--logLevel=<silent\|info\|verbose>` | | Specify build-time log level |
+| `--dev` | | Run in dev mode |
+| `--watch` | | Watch mode |
+<!--/test-opts-->
+
+::note
+This command sets `process.env.NODE_ENV` to `test`.
+::
diff --git a/docs/4.api/4.commands/typecheck.md b/docs/4.api/4.commands/typecheck.md
new file mode 100644
index 000000000000..e12319e81b78
--- /dev/null
+++ b/docs/4.api/4.commands/typecheck.md
@@ -0,0 +1,44 @@
+---
+title: "nuxt typecheck"
+description: The typecheck command runs vue-tsc to check types throughout your app.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/cli/blob/main/packages/nuxi/src/commands/typecheck.ts
+ size: xs
+---
+
+<!--typecheck-cmd-->
+```bash [Terminal]
+npx nuxt typecheck [ROOTDIR] [--cwd=<directory>] [--logLevel=<silent|info|verbose>] [--dotenv] [-e, --extends=<layer-name>]
+```
+<!--/typecheck-cmd-->
+
+The `typecheck` command runs [`vue-tsc`](https://github.com/vuejs/language-tools/tree/master/packages/tsc) to check types throughout your app.
+
+## Arguments
+
+<!--typecheck-args-->
+| Argument | Description |
+|---------------|------------------------------------------------|
+| `ROOTDIR="."` | Specifies the working directory (default: `.`) |
+<!--/typecheck-args-->
+
+## Options
+
+<!--typecheck-opts-->
+| Option | Default | Description |
+|--------------------------------------|---------|----------------------------------------------------------------------------------|
+| `--cwd=<directory>` | | Specify the working directory, this takes precedence over ROOTDIR (default: `.`) |
+| `--logLevel=<silent\|info\|verbose>` | | Specify build-time log level |
+| `--dotenv` | | Path to `.env` file to load, relative to the root directory |
+| `-e, --extends=<layer-name>` | | Extend from a Nuxt layer |
+<!--/typecheck-opts-->
+
+::note
+This command sets `process.env.NODE_ENV` to `production`. To override, define `NODE_ENV` in a [`.env`](/docs/4.x/directory-structure/env) file or as a command-line argument.
+::
+
+::read-more{to="/docs/4.x/guide/concepts/typescript#type-checking"}
+Read more on how to enable type-checking at build or development time.
+::
diff --git a/docs/4.api/4.commands/upgrade.md b/docs/4.api/4.commands/upgrade.md
new file mode 100644
index 000000000000..46fc85c84160
--- /dev/null
+++ b/docs/4.api/4.commands/upgrade.md
@@ -0,0 +1,37 @@
+---
+title: "nuxt upgrade"
+description: The upgrade command upgrades Nuxt to the latest version.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/cli/blob/main/packages/nuxi/src/commands/upgrade.ts
+ size: xs
+---
+
+<!--upgrade-cmd-->
+```bash [Terminal]
+npx nuxt upgrade [ROOTDIR] [--cwd=<directory>] [--logLevel=<silent|info|verbose>] [--dedupe] [-f, --force] [-ch, --channel=<stable|nightly|v3|v4|v4-nightly|v3-nightly>]
+```
+<!--/upgrade-cmd-->
+
+The `upgrade` command upgrades Nuxt to the latest version.
+
+## Arguments
+
+<!--upgrade-args-->
+| Argument | Description |
+|---------------|------------------------------------------------|
+| `ROOTDIR="."` | Specifies the working directory (default: `.`) |
+<!--/upgrade-args-->
+
+## Options
+
+<!--upgrade-opts-->
+| Option | Default | Description |
+|--------------------------------------------------------------------|----------|----------------------------------------------------------------------------------|
+| `--cwd=<directory>` | | Specify the working directory, this takes precedence over ROOTDIR (default: `.`) |
+| `--logLevel=<silent\|info\|verbose>` | | Specify build-time log level |
+| `--dedupe` | | Dedupe dependencies after upgrading |
+| `-f, --force` | | Force upgrade to recreate lockfile and node_modules |
+| `-ch, --channel=<stable\|nightly\|v3\|v4\|v4-nightly\|v3-nightly>` | `stable` | Specify a channel to install from (default: stable) |
+<!--/upgrade-opts-->
diff --git a/docs/4.api/5.kit/.navigation.yml b/docs/4.api/5.kit/.navigation.yml
new file mode 100644
index 000000000000..0ad5ba29e990
--- /dev/null
+++ b/docs/4.api/5.kit/.navigation.yml
@@ -0,0 +1,3 @@
+title: Nuxt Kit
+titleTemplate: '%s · Nuxt Kit'
+navigation.icon: i-lucide-package
diff --git a/docs/4.api/5.kit/1.modules.md b/docs/4.api/5.kit/1.modules.md
new file mode 100644
index 000000000000..01d6d35f1919
--- /dev/null
+++ b/docs/4.api/5.kit/1.modules.md
@@ -0,0 +1,401 @@
+---
+title: "Modules"
+description: Nuxt Kit provides a set of utilities to help you create and use modules. You can use these utilities to create your own modules or to reuse existing modules.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/tree/main/packages/kit/src/module
+ size: xs
+---
+
+Modules are the building blocks of Nuxt. Kit provides a set of utilities to help you create and use modules. You can use these utilities to create your own modules or to reuse existing modules. For example, you can use the `defineNuxtModule` function to define a module and specify dependencies using the `moduleDependencies` option.
+
+## `defineNuxtModule`
+
+Define a Nuxt module, automatically merging defaults with user provided options, installing any hooks that are provided, and calling an optional setup function for full control.
+
+### Usage
+
+```ts twoslash
+import { defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ meta: {
+ name: 'my-module',
+ configKey: 'myModule',
+ },
+ defaults: {
+ enabled: true,
+ },
+ setup (options) {
+ if (options.enabled) {
+ console.log('My Nuxt module is enabled!')
+ }
+ },
+})
+```
+
+### Type
+
+```ts twoslash
+// @errors: 2391
+import type { ModuleDefinition, ModuleOptions, NuxtModule } from '@nuxt/schema'
+// ---cut---
+export function defineNuxtModule<TOptions extends ModuleOptions> (
+ definition?: ModuleDefinition<TOptions, Partial<TOptions>, false> | NuxtModule<TOptions, Partial<TOptions>, false>,
+): NuxtModule<TOptions, TOptions, false>
+
+export function defineNuxtModule<TOptions extends ModuleOptions> (): {
+ with: <TOptionsDefaults extends Partial<TOptions>> (
+ definition: ModuleDefinition<TOptions, TOptionsDefaults, true> | NuxtModule<TOptions, TOptionsDefaults, true>,
+ ) => NuxtModule<TOptions, TOptionsDefaults, true>
+}
+```
+
+### Parameters
+
+**definition**: A module definition object or a module function. The module definition object should contain the following properties:
+
+| Property | Type | Required | Description |
+|----------------------|-------------------------------------------------------------------------------------------------------------------|----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `meta` | `ModuleMeta` | `false` | Metadata of the module. It defines the module name, version, config key and compatibility. |
+| `defaults` | `T \| ((nuxt: Nuxt) => T)`{lang="ts"} | `false` | Default options for the module. If a function is provided, it will be called with the Nuxt instance as the first argument. |
+| `schema` | `T` | `false` | Schema for the module options. If provided, options will be applied to the schema. |
+| `hooks` | `Partial<NuxtHooks>`{lang="ts"} | `false` | Hooks to be installed for the module. If provided, the module will install the hooks. |
+| `moduleDependencies` | `Record<string, ModuleDependency> \| ((nuxt: Nuxt) => Record<string, ModuleDependency>)`{lang="ts"} | `false` | Dependencies on other modules with version constraints and configuration. Can be an object or a function that receives the Nuxt instance. See [example](/docs/4.x/api/kit/modules#specifying-module-dependencies). |
+| `onInstall` | `(nuxt: Nuxt) => Awaitable<void>`{lang="ts"} | `false` | Lifecycle hook called when the module is first installed. Requires `meta.name` and `meta.version` to be defined. |
+| `onUpgrade` | `(nuxt: Nuxt, options: T, previousVersion: string) => Awaitable<void>`{lang="ts"} | `false` | Lifecycle hook called when the module is upgraded to a newer version. Requires `meta.name` and `meta.version` to be defined. |
+| `setup` | `(this: void, resolvedOptions: T, nuxt: Nuxt) => Awaitable<void \| false \| ModuleSetupInstallResult>`{lang="ts"} | `false` | Setup function for the module. If provided, the module will call the setup function. |
+
+### Examples
+
+#### Using `configKey` to Make Your Module Configurable
+
+When defining a Nuxt module, you can set a `configKey` to specify how users should configure the module in their `nuxt.config`.
+
+```ts
+import { defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ meta: {
+ name: 'my-module',
+ configKey: 'myModule',
+ },
+ defaults: {
+ // Module options
+ enabled: true,
+ },
+ setup (options) {
+ if (options.enabled) {
+ console.log('My Nuxt module is enabled!')
+ }
+ },
+})
+```
+
+Users can provide options for this module under the corresponding key in `nuxt.config`.
+
+```ts
+export default defineNuxtConfig({
+ myModule: {
+ enabled: false,
+ },
+})
+```
+
+Users can also completely disable a module by setting the config key to `false`. This prevents the module's setup function from running while still generating types for module options.
+
+```ts
+export default defineNuxtConfig({
+ // Disable the module entirely
+ myModule: false,
+})
+```
+
+::tip
+This is particularly useful when you want to disable modules inherited from [Nuxt layers](/docs/4.x/guide/going-further/layers#disabling-modules-from-layers).
+::
+
+#### Defining Module Compatibility Requirements
+
+If you're developing a Nuxt module and using APIs that are only supported in specific Nuxt versions, it's highly recommended to include `compatibility.nuxt`.
+
+```ts
+export default defineNuxtModule({
+ meta: {
+ name: '@nuxt/icon',
+ configKey: 'icon',
+ compatibility: {
+ // Required nuxt version in semver format.
+ nuxt: '>=3.0.0', // or use '^3.0.0'
+ },
+ },
+ setup () {
+ const resolver = createResolver(import.meta.url)
+ // Implement
+ },
+})
+```
+
+If the user tries to use your module with an incompatible Nuxt version, they will receive a warning in the console.
+
+```terminal
+ WARN Module @nuxt/icon is disabled due to incompatibility issues:
+ - [nuxt] Nuxt version ^3.1.0 is required but currently using 3.0.0
+```
+
+#### Type Safety for Resolved Options with `.with()`
+
+When you need type safety for your resolved/merged module options, you can use the `.with()` method. This enables TypeScript to properly infer the relationship between your module's defaults and the final resolved options that your setup function receives.
+
+```ts
+import { defineNuxtModule } from '@nuxt/kit'
+
+// Define your module options interface
+interface ModuleOptions {
+ apiKey: string
+ baseURL: string
+ timeout?: number
+ retries?: number
+}
+
+export default defineNuxtModule<ModuleOptions>().with({
+ meta: {
+ name: '@nuxtjs/my-api',
+ configKey: 'myApi',
+ },
+ defaults: {
+ baseURL: 'https://api.example.com',
+ timeout: 5000,
+ retries: 3,
+ },
+ setup (resolvedOptions, nuxt) {
+ // resolvedOptions is properly typed as:
+ // {
+ // apiKey: string // Required, no default provided
+ // baseURL: string // Required, has default value
+ // timeout: number // Optional, has default value
+ // retries: number // Optional, has default value
+ // }
+
+ console.log(resolvedOptions.baseURL) // ✅ TypeScript knows this is always defined
+ console.log(resolvedOptions.timeout) // ✅ TypeScript knows this is always defined
+ console.log(resolvedOptions.retries) // ✅ TypeScript knows this is always defined
+ },
+})
+```
+
+Without using `.with()`, the `resolvedOptions` parameter would be typed as the raw `ModuleOptions` interface, where `timeout` and `retries` could be `undefined` even when defaults are provided. The `.with()` method enables TypeScript to understand that default values make those properties non-optional in the resolved options.
+
+#### Using Lifecycle Hooks for Module Installation and Upgrade
+
+You can define lifecycle hooks that run when your module is first installed or upgraded to a new version. These hooks are useful for performing one-time setup tasks, database migrations, or cleanup operations.
+
+::important
+For lifecycle hooks to work, you **must** provide both `meta.name` and `meta.version` in your module definition. The hooks use these values to track the module's installation state in the project's `.nuxtrc` file.
+::
+
+Lifecycle hooks run before the main `setup` function, and if a hook throws an error, it's logged but doesn't stop the build process.
+
+**`onInstall`** runs only once when the module is first added to a project.
+
+**`onUpgrade`** runs each time the module version increases (using semver comparison) — but only once for each version bump.
+
+##### Example
+
+```ts
+import { defineNuxtModule } from '@nuxt/kit'
+import semver from 'semver'
+
+export default defineNuxtModule({
+ meta: {
+ name: 'my-awesome-module',
+ version: '1.2.0', // Required for lifecycle hooks
+ configKey: 'myAwesomeModule',
+ },
+ defaults: {
+ apiKey: '',
+ enabled: true,
+ },
+
+ onInstall (nuxt) {
+ // This runs only when the module is first installed
+ console.log('Setting up my-awesome-module for the first time!')
+
+ // You might want to:
+ // - Create initial configuration files
+ // - Set up database schemas
+ // - Display welcome messages
+ // - Perform initial data migration
+ },
+
+ onUpgrade (nuxt, options, previousVersion) {
+ // This runs when the module is upgraded to a newer version
+ console.log(`Upgrading my-awesome-module from ${previousVersion} to 1.2.0`)
+
+ // You might want to:
+ // - Migrate configuration files
+ // - Update database schemas
+ // - Clean up deprecated files
+ // - Display upgrade notes
+
+ if (semver.lt(previousVersion, '1.1.0')) {
+ console.log('⚠️ Breaking changes in 1.1.0 - please check the migration guide')
+ }
+ },
+
+ setup (options, nuxt) {
+ // Regular setup logic runs on every build
+ if (options.enabled) {
+ // Configure the module
+ }
+ },
+})
+```
+
+#### Specifying Module Dependencies
+
+You can use the `moduleDependencies` option to declare dependencies on other modules. This provides a robust way to ensure proper setup order, version compatibility, and configuration management.
+
+The `moduleDependencies` option can be either an object or a function that receives the Nuxt instance:
+
+##### Example
+
+```ts
+import { defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ meta: {
+ name: 'my-module',
+ },
+ moduleDependencies: {
+ '@nuxtjs/tailwindcss': {
+ // Specify a version constraint (semver format)
+ version: '>=6.0.0',
+ // Configuration that overrides user settings
+ overrides: {
+ exposeConfig: true,
+ },
+ // Configuration that sets defaults but respects user settings
+ defaults: {
+ config: {
+ darkMode: 'class',
+ },
+ },
+ },
+ '@nuxtjs/fontaine': {
+ // Optional dependencies won't be installed but ensure that options
+ // can be set if they _are_ installed
+ optional: true,
+ defaults: {
+ fonts: [
+ {
+ family: 'Roboto',
+ fallbacks: ['Impact'],
+ },
+ ],
+ },
+ },
+ },
+ setup (options, nuxt) {
+
+ },
+})
+```
+
+You can also use a function to dynamically determine dependencies based on the Nuxt configuration:
+
+```ts
+import { defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ meta: {
+ name: 'my-module',
+ },
+ moduleDependencies (nuxt) {
+ const dependencies: Record<string, any> = {
+ '@nuxtjs/tailwindcss': {
+ version: '>=6.0.0',
+ },
+ }
+
+ // Conditionally add dependencies based on Nuxt config
+ if (nuxt.options.experimental?.someFeature) {
+ dependencies['@nuxtjs/fontaine'] = {
+ optional: true,
+ }
+ }
+
+ return dependencies
+ },
+ setup (options, nuxt) {
+ // Your setup logic runs after all dependencies are initialized
+ },
+})
+```
+
+## `installModule`
+
+::callout{type="warning"}
+**Deprecated:** Use the [`moduleDependencies`](/docs/4.x/api/kit/modules#specifying-module-dependencies) option in `defineNuxtModule` instead. The `installModule` function will be removed (or may become non-blocking) in a future version.
+::
+
+Install specified Nuxt module programmatically. This is helpful when your module depends on other modules. You can pass the module options as an object to `inlineOptions` and they will be passed to the module's `setup` function.
+
+### Usage
+
+```ts twoslash
+import { defineNuxtModule, installModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ async setup () {
+ // will install @nuxtjs/fontaine with Roboto font and Impact fallback
+ await installModule('@nuxtjs/fontaine', {
+ // module configuration
+ fonts: [
+ {
+ family: 'Roboto',
+ fallbacks: ['Impact'],
+ fallbackName: 'fallback-a',
+ },
+ ],
+ })
+ },
+})
+```
+
+### Type
+
+```ts
+async function installModule (moduleToInstall: string | NuxtModule, inlineOptions?: any, nuxt?: Nuxt)
+```
+
+### Parameters
+
+| Property | Type | Required | Description |
+|-------------------|-----------------------------------|----------|-----------------------------------------------------------------------------------------------|
+| `moduleToInstall` | `string \| NuxtModule`{lang="ts"} | `true` | The module to install. Can be either a string with the module name or a module object itself. |
+| `inlineOptions` | `any` | `false` | An object with the module options to be passed to the module's `setup` function. |
+| `nuxt` | `Nuxt` | `false` | Nuxt instance. If not provided, it will be retrieved from the context via `useNuxt()` call. |
+
+### Examples
+
+```ts
+import { defineNuxtModule, installModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ async setup (options, nuxt) {
+ // will install @nuxtjs/fontaine with Roboto font and Impact fallback
+ await installModule('@nuxtjs/fontaine', {
+ // module configuration
+ fonts: [
+ {
+ family: 'Roboto',
+ fallbacks: ['Impact'],
+ fallbackName: 'fallback-a',
+ },
+ ],
+ })
+ },
+})
+```
diff --git a/docs/4.api/5.kit/10.runtime-config.md b/docs/4.api/5.kit/10.runtime-config.md
new file mode 100644
index 000000000000..5f458a6e298d
--- /dev/null
+++ b/docs/4.api/5.kit/10.runtime-config.md
@@ -0,0 +1,29 @@
+---
+title: Runtime Config
+description: Nuxt Kit provides a set of utilities to help you access and modify Nuxt runtime configuration.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/kit/src/runtime-config.ts
+ size: xs
+---
+
+## `useRuntimeConfig`
+
+At build-time, it is possible to access the resolved Nuxt [runtime config](/docs/4.x/guide/going-further/runtime-config).
+
+### Type
+
+```ts
+function useRuntimeConfig (): Record<string, unknown>
+```
+
+## `updateRuntimeConfig`
+
+It is also possible to update runtime configuration. This will be merged with the existing runtime configuration, and if Nitro has already been initialized it will trigger an HMR event to reload the Nitro runtime config.
+
+### Type
+
+```ts
+function updateRuntimeConfig (config: Record<string, unknown>): void | Promise<void>
+```
diff --git a/docs/4.api/5.kit/10.templates.md b/docs/4.api/5.kit/10.templates.md
new file mode 100644
index 000000000000..4e195c84040e
--- /dev/null
+++ b/docs/4.api/5.kit/10.templates.md
@@ -0,0 +1,309 @@
+---
+title: "Templates"
+description: Nuxt Kit provides a set of utilities to help you work with templates. These functions allow you to generate extra files during development and build time.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/kit/src/template.ts
+ size: xs
+---
+
+Templates allow you to generate extra files during development and build time. These files will be available in virtual filesystem and can be used in plugins, layouts, components, etc. `addTemplate` and `addTypeTemplate` allow you to add templates to the Nuxt application. `updateTemplates` allows you to regenerate templates that match the filter.
+
+## `addTemplate`
+
+Renders given template during build into the virtual file system, and optionally to disk in the project `buildDir`
+
+### Usage
+
+```ts twoslash
+import { addTemplate, defineNuxtModule } from '@nuxt/kit'
+import { defu } from 'defu'
+
+export default defineNuxtModule({
+ setup (options, nuxt) {
+ const globalMeta = defu(nuxt.options.app.head, {
+ charset: options.charset,
+ viewport: options.viewport,
+ })
+
+ addTemplate({
+ filename: 'meta.config.mjs',
+ getContents: () => 'export default ' + JSON.stringify({ globalMeta, mixinKey: 'setup' }),
+ })
+ },
+})
+```
+
+### Type
+
+```ts twoslash
+// @errors: 2391
+import type { NuxtTemplate, ResolvedNuxtTemplate } from '@nuxt/schema'
+// ---cut---
+function addTemplate (template: NuxtTemplate | string): ResolvedNuxtTemplate
+```
+
+### Parameters
+
+**template**: A template object or a string with the path to the template. If a string is provided, it will be converted to a template object with `src` set to the string value. If a template object is provided, it must have the following properties:
+
+| Property | Type | Required | Description |
+|---------------|-----------------------------------------------------------|----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `src` | `string` | `false` | Path to the template. If `src` is not provided, `getContents` must be provided instead. |
+| `filename` | `string` | `false` | Filename of the template. If `filename` is not provided, it will be generated from the `src` path. In this case, the `src` option is required. |
+| `dst` | `string` | `false` | Path to the destination file. If `dst` is not provided, it will be generated from the `filename` path and nuxt `buildDir` option. |
+| `options` | `Options` | `false` | Options to pass to the template. |
+| `getContents` | `(data: Options) => string \| Promise<string>`{lang="ts"} | `false` | A function that will be called with the `options` object. It should return a string or a promise that resolves to a string. If `src` is provided, this function will be ignored. |
+| `write` | `boolean` | `false` | If set to `true`, the template will be written to the destination file. Otherwise, the template will be used only in virtual filesystem. |
+
+### Examples
+
+#### Creating a Virtual File for Runtime Plugin
+
+In this example, we merge an object inside a module and consume the result in a runtime plugin.
+
+```ts twoslash [module.ts]
+import { addTemplate, defineNuxtModule } from '@nuxt/kit'
+import { defu } from 'defu'
+
+export default defineNuxtModule({
+ setup (options, nuxt) {
+ const globalMeta = defu(nuxt.options.app.head, {
+ charset: options.charset,
+ viewport: options.viewport,
+ })
+
+ addTemplate({
+ filename: 'meta.config.mjs',
+ getContents: () => 'export default ' + JSON.stringify({ globalMeta, mixinKey: 'setup' }),
+ })
+ },
+})
+```
+
+In the module above, we generate a virtual file named `meta.config.mjs`. In the runtime plugin, we can import it using the `#build` alias:
+
+```ts [runtime/plugin.ts]
+import { createHead as createServerHead } from '@unhead/vue/server'
+import { createHead as createClientHead } from '@unhead/vue/client'
+import { defineNuxtPlugin } from '#imports'
+// @ts-expect-error - virtual file
+import metaConfig from '#build/meta.config.mjs'
+
+export default defineNuxtPlugin((nuxtApp) => {
+ const createHead = import.meta.server ? createServerHead : createClientHead
+ const head = createHead()
+ head.push(metaConfig.globalMeta)
+
+ nuxtApp.vueApp.use(head)
+})
+```
+
+## `addTypeTemplate`
+
+Renders given template during build into the project buildDir, then registers it as types.
+
+### Usage
+
+```ts twoslash
+import { addTypeTemplate, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup () {
+ addTypeTemplate({
+ filename: 'types/markdown.d.ts',
+ getContents: () => `declare module '*.md' {
+ import type { ComponentOptions } from 'vue'
+ const Component: ComponentOptions
+ export default Component
+}`,
+ })
+ },
+})
+```
+
+### Type
+
+```ts
+function addTypeTemplate (template: NuxtTypeTemplate | string, context?: { nitro?: boolean, nuxt?: boolean }): ResolvedNuxtTemplate
+```
+
+### Parameters
+
+**template**: A template object or a string with the path to the template. If a string is provided, it will be converted to a template object with `src` set to the string value. If a template object is provided, it must have the following properties:
+
+| Property | Type | Required | Description |
+|---------------|-----------------------------------------------------------|----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `src` | `string` | `false` | Path to the template. If `src` is not provided, `getContents` must be provided instead. |
+| `filename` | `string` | `false` | Filename of the template. If `filename` is not provided, it will be generated from the `src` path. In this case, the `src` option is required. |
+| `dst` | `string` | `false` | Path to the destination file. If `dst` is not provided, it will be generated from the `filename` path and nuxt `buildDir` option. |
+| `options` | `Options` | `false` | Options to pass to the template. |
+| `getContents` | `(data: Options) => string \| Promise<string>`{lang="ts"} | `false` | A function that will be called with the `options` object. It should return a string or a promise that resolves to a string. If `src` is provided, this function will be ignored. |
+
+**context**: An optional context object can be passed to control where the type is added. If omitted, the type will only be added to the Nuxt context. This object supports the following properties:
+
+| Property | Type | Required | Description |
+|----------|-----------|----------|----------------------------------------------------------------|
+| `nuxt` | `boolean` | `false` | If set to `true`, the type will be added to the Nuxt context. |
+| `nitro` | `boolean` | `false` | If set to `true`, the type will be added to the Nitro context. |
+
+### Examples
+
+#### Adding Type Templates to the Nitro Context
+
+By default, －－ only adds the type declarations to the Nuxt context. To also add them to the Nitro context, set nitro to true.
+
+```ts twoslash
+import { addTypeTemplate, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup () {
+ addTypeTemplate({
+ filename: 'types/auth.d.ts',
+ getContents: () => `declare module '#auth-utils' {
+ interface User {
+ id: string;
+ name: string;
+ }
+
+}`,
+ }, {
+ nitro: true,
+ })
+ },
+})
+```
+
+This allows the `#auth-utils` module to be used within the Nitro context.
+
+```ts [server/api/auth.ts]
+import type { User } from '#auth-utils'
+
+export default eventHandler(() => {
+ const user: User = {
+ id: '123',
+ name: 'John Doe',
+ }
+
+ // do something with the user
+
+ return user
+})
+```
+
+## `addServerTemplate`
+
+Adds a virtual file that can be used within the Nuxt Nitro server build.
+
+### Usage
+
+```ts twoslash
+import { addServerTemplate, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup () {
+ addServerTemplate({
+ filename: '#my-module/test.mjs',
+ getContents () {
+ return 'export const test = 123'
+ },
+ })
+ },
+})
+```
+
+### Type
+
+```ts twoslash
+// @errors: 2391
+import type { NuxtServerTemplate } from '@nuxt/schema'
+// ---cut---
+function addServerTemplate (template: NuxtServerTemplate): NuxtServerTemplate
+```
+
+### Parameters
+
+**template**: A template object. It must have the following properties:
+
+| Property | Type | Required | Description |
+|---------------|----------------------------------------------|----------|-----------------------------------------------------------------------------------------------------------------------------|
+| `filename` | `string` | `true` | Filename of the template. |
+| `getContents` | `() => string \| Promise<string>`{lang="ts"} | `true` | A function that will be called with the `options` object. It should return a string or a promise that resolves to a string. |
+
+### Examples
+
+### Creating a Virtual File for Nitro
+
+In this example, we create a virtual file that can be used within the Nuxt Nitro server build.
+
+```ts twoslash
+import { addServerTemplate, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup () {
+ addServerTemplate({
+ filename: '#my-module/test.mjs',
+ getContents () {
+ return 'export const test = 123'
+ },
+ })
+ },
+})
+```
+
+And then in a runtime file
+
+```ts [server/api/test.ts]
+import { test } from '#my-module/test.js'
+
+export default eventHandler(() => {
+ return test
+})
+```
+
+## `updateTemplates`
+
+Regenerate templates that match the filter. If no filter is provided, all templates will be regenerated.
+
+### Usage
+
+```ts
+import { defineNuxtModule, updateTemplates } from '@nuxt/kit'
+import { resolve } from 'pathe'
+
+export default defineNuxtModule({
+ setup (options, nuxt) {
+ const updateTemplatePaths = [
+ resolve(nuxt.options.srcDir, 'pages'),
+ ]
+ // watch and rebuild routes template list when one of the pages changes
+ nuxt.hook('builder:watch', async (event, relativePath) => {
+ if (event === 'change') {
+ return
+ }
+
+ const path = resolve(nuxt.options.srcDir, relativePath)
+ if (updateTemplatePaths.some(dir => path.startsWith(dir))) {
+ await updateTemplates({
+ filter: template => template.filename === 'routes.mjs',
+ })
+ }
+ })
+ },
+})
+```
+
+### Type
+
+```ts
+async function updateTemplates (options: UpdateTemplatesOptions): void
+```
+
+### Parameters
+
+**options**: Options to pass to the template. This object can have the following property:
+
+| Property | Type | Required | Description |
+|----------|----------------------------------------------------------|----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `filter` | `(template: ResolvedNuxtTemplate) => boolean`{lang="ts"} | `false` | A function that will be called with the `template` object. It should return a boolean indicating whether the template should be regenerated. If `filter` is not provided, all templates will be regenerated. |
diff --git a/docs/4.api/5.kit/11.nitro.md b/docs/4.api/5.kit/11.nitro.md
new file mode 100644
index 000000000000..d92655e16b85
--- /dev/null
+++ b/docs/4.api/5.kit/11.nitro.md
@@ -0,0 +1,507 @@
+---
+title: "Nitro"
+description: Nuxt Kit provides a set of utilities to help you work with Nitro. These functions allow you to add server handlers, plugins, and prerender routes.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/kit/src/nitro.ts
+ size: xs
+---
+
+Nitro is an open source TypeScript framework to build ultra-fast web servers. Nuxt uses Nitro as its server engine. You can use `useNitro` to access the Nitro instance, `addServerHandler` to add a server handler, `addDevServerHandler` to add a server handler to be used only in development mode, `addServerPlugin` to add a plugin to extend Nitro's runtime behavior, and `addPrerenderRoutes` to add routes to be prerendered by Nitro.
+
+## `addServerHandler`
+
+Adds a Nitro server handler. Use this if you want to create server middleware or a custom route.
+
+### Usage
+
+```ts twoslash
+import { addServerHandler, createResolver, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup (options) {
+ const { resolve } = createResolver(import.meta.url)
+
+ addServerHandler({
+ route: '/robots.txt',
+ handler: resolve('./runtime/robots.get'),
+ })
+ },
+})
+```
+
+### Type
+
+```ts
+function addServerHandler (handler: NitroEventHandler): void
+```
+
+### Parameters
+
+**handler**: A handler object with the following properties:
+
+| Property | Type | Required | Description |
+|--------------|-----------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------|
+| `handler` | `string` | `true` | Path to event handler. |
+| `route` | `string` | `false` | Path prefix or route. If an empty string used, will be used as a middleware. |
+| `middleware` | `boolean` | `false` | Specifies this is a middleware handler. Middleware are called on every route and should normally return nothing to pass to the next handlers. |
+| `lazy` | `boolean` | `false` | Use lazy loading to import the handler. This is useful when you only want to load the handler on demand. |
+| `method` | `string` | `false` | Router method matcher. If handler name contains method name, it will be used as a default value. |
+
+### Examples
+
+#### Basic Usage
+
+You can use `addServerHandler` to add a server handler from your module.
+
+::code-group
+
+```ts twoslash [module.ts]
+import { addServerHandler, createResolver, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup (options) {
+ const { resolve } = createResolver(import.meta.url)
+
+ addServerHandler({
+ route: '/robots.txt',
+ handler: resolve('./runtime/robots.get'),
+ })
+ },
+})
+```
+
+```ts twoslash [runtime/robots.get.ts]
+import { defineEventHandler } from 'nitro/h3'
+
+export default defineEventHandler(() => {
+ return {
+ body: `User-agent: *\nDisallow: /`,
+ }
+})
+```
+
+::
+
+When you access `/robots.txt`, it will return the following response:
+
+```txt
+User-agent: *
+Disallow: /
+```
+
+## `addDevServerHandler`
+
+Adds a Nitro server handler to be used only in development mode. This handler will be excluded from production build.
+
+### Usage
+
+```ts twoslash
+import { defineEventHandler } from 'nitro/h3'
+import { addDevServerHandler, createResolver, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup () {
+ addDevServerHandler({
+ handler: defineEventHandler(() => {
+ return {
+ body: `Response generated at ${new Date().toISOString()}`,
+ }
+ }),
+ route: '/_handler',
+ })
+ },
+})
+```
+
+### Type
+
+```ts twoslash
+// @errors: 2391
+import type { NitroDevEventHandler } from 'nitro/types'
+// ---cut---
+function addDevServerHandler (handler: NitroDevEventHandler): void
+```
+
+### Parameters
+
+**handler**: A handler object with the following properties:
+
+| Property | Type | Required | Description |
+|-----------|----------------|----------|------------------------------------------------------------------------------|
+| `handler` | `EventHandler` | `true` | Event handler. |
+| `route` | `string` | `false` | Path prefix or route. If an empty string used, will be used as a middleware. |
+
+### Examples
+
+#### Basic Usage
+
+In some cases, you may want to create a server handler specifically for development purposes, such as a Tailwind config viewer.
+
+```ts
+import { joinURL } from 'ufo'
+import { addDevServerHandler, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ async setup (options, nuxt) {
+ const route = joinURL(nuxt.options.app?.baseURL, '/_tailwind')
+
+ // @ts-expect-error - tailwind-config-viewer does not have correct types
+ const createServer = await import('tailwind-config-viewer/server/index.js').then(r => r.default || r) as any
+ const viewerDevMiddleware = createServer({ tailwindConfigProvider: () => options, routerPrefix: route }).asMiddleware()
+
+ addDevServerHandler({ route, handler: viewerDevMiddleware })
+ },
+})
+```
+
+## `useNitro`
+
+Returns the Nitro instance.
+
+::warning
+You can call `useNitro()` only after `ready` hook.
+::
+
+::note
+Changes to the Nitro instance configuration are not applied.
+::
+
+### Usage
+
+```ts
+import { defineNuxtModule, useNitro } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup (options, nuxt) {
+ const resolver = createResolver(import.meta.url)
+
+ nuxt.hook('ready', () => {
+ const nitro = useNitro()
+ // Do something with Nitro instance
+ })
+ },
+})
+```
+
+### Type
+
+```ts
+function useNitro (): Nitro
+```
+
+## `addServerPlugin`
+
+Add plugin to extend Nitro's runtime behavior.
+
+::tip
+You can read more about Nitro plugins in the [Nitro documentation](https://nitro.build/guide/plugins).
+::
+
+::warning
+It is necessary to explicitly import `definePlugin` from `` within your plugin file. The same requirement applies to utilities such as `useRuntimeConfig`.
+::
+
+### Usage
+
+```ts twoslash
+import { addServerPlugin, createResolver, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup () {
+ const { resolve } = createResolver(import.meta.url)
+ addServerPlugin(resolve('./runtime/plugin.ts'))
+ },
+})
+```
+
+### Type
+
+```ts
+function addServerPlugin (plugin: string): void
+```
+
+### Parameters
+
+| Property | Type | Required | Description |
+|----------|----------|----------|---------------------------------------------------------------------------------------------------------------|
+| `plugin` | `string` | `true` | Path to the plugin. The plugin must export a default function that accepts the Nitro instance as an argument. |
+
+### Examples
+
+::code-group
+
+```ts [module.ts]
+import { addServerPlugin, createResolver, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup () {
+ const { resolve } = createResolver(import.meta.url)
+ addServerPlugin(resolve('./runtime/plugin.ts'))
+ },
+})
+```
+
+```ts [runtime/plugin.ts]
+import { definePlugin } from 'nitro'
+
+export default definePlugin((nitroApp) => {
+ nitroApp.hooks.hook('request', (event) => {
+ console.log('on request', event.req.url)
+ })
+
+ nitroApp.hooks.hook('response', async (res) => {
+ console.log('on response', await res.text())
+ })
+})
+```
+
+::
+
+## `addPrerenderRoutes`
+
+Add routes to be prerendered to Nitro.
+
+### Usage
+
+```ts
+import { addPrerenderRoutes, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ meta: {
+ name: 'nuxt-sitemap',
+ configKey: 'sitemap',
+ },
+ defaults: {
+ sitemapUrl: '/sitemap.xml',
+ prerender: true,
+ },
+ setup (options) {
+ if (options.prerender) {
+ addPrerenderRoutes(options.sitemapUrl)
+ }
+ },
+})
+```
+
+### Type
+
+```ts
+function addPrerenderRoutes (routes: string | string[]): void
+```
+
+### Parameters
+
+| Property | Type | Required | Description |
+|----------|---------------------------------|----------|---------------------------------------------|
+| `routes` | `string \| string[]`{lang="ts"} | `true` | A route or an array of routes to prerender. |
+
+## `addServerImports`
+
+Add imports to the server. It makes your imports available in Nitro without the need to import them manually.
+
+::warning
+If you want to provide a utility that works in both server and client contexts and is usable in the [`shared/`](/docs/4.x/directory-structure/shared) directory, the function must be imported from the same source file for both [`addImports`](/docs/4.x/api/kit/autoimports#addimports) and `addServerImports` and should have identical signature. That source file should not import anything context-specific (i.e., Nitro context, Nuxt app context) or else it might cause errors during type-checking.
+::
+
+### Usage
+
+```ts twoslash
+import { addServerImports, createResolver, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup (options) {
+ const names = [
+ 'useStoryblok',
+ 'useStoryblokApi',
+ 'useStoryblokBridge',
+ 'renderRichText',
+ 'RichTextSchema',
+ ]
+
+ names.forEach(name =>
+ addServerImports({ name, as: name, from: '@storyblok/vue' }),
+ )
+ },
+})
+```
+
+### Type
+
+```ts
+function addServerImports (dirs: Import | Import[]): void
+```
+
+### Parameters
+
+`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. |
+
+## `addServerImportsDir`
+
+Add a directory to be scanned for auto-imports by Nitro.
+
+### Usage
+
+```ts twoslash
+import { addServerImportsDir, createResolver, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ meta: {
+ name: 'my-module',
+ configKey: 'myModule',
+ },
+ setup (options) {
+ const { resolve } = createResolver(import.meta.url)
+ addServerImportsDir(resolve('./runtime/server/composables'))
+ },
+})
+```
+
+### Type
+
+```ts
+function addServerImportsDir (dirs: string | string[], opts: { prepend?: boolean }): void
+```
+
+### Parameters
+
+| Property | Type | Required | Description |
+|----------|---------------------------------|----------|---------------------------------------------------------------------------------------------------------------------|
+| `dirs` | `string \| string[]`{lang="ts"} | `true` | A directory or an array of directories to register to be scanned by Nitro. |
+| `opts` | `{ prepend?: boolean }` | `false` | Options for the import directory. If `prepend` is `true`, the directory is added to the beginning of the scan list. |
+
+### Examples
+
+You can use `addServerImportsDir` to add a directory to be scanned by Nitro. This is useful when you want Nitro to auto-import functions from a custom server directory.
+
+::code-group
+
+```ts twoslash [module.ts]
+import { addServerImportsDir, createResolver, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ meta: {
+ name: 'my-module',
+ configKey: 'myModule',
+ },
+ setup (options) {
+ const { resolve } = createResolver(import.meta.url)
+ addServerImportsDir(resolve('./runtime/server/composables'))
+ },
+})
+```
+
+```ts twoslash [runtime/server/composables/index.ts]
+export function useApiSecret () {
+ const { apiSecret } = useRuntimeConfig()
+ return apiSecret
+}
+```
+
+::
+
+You can then use the `useApiSecret` function in your server code:
+
+```ts twoslash [runtime/server/api/hello.ts]
+import { defineEventHandler } from 'nitro/h3'
+
+const useApiSecret = (): string => ''
+// ---cut---
+export default defineEventHandler(() => {
+ const apiSecret = useApiSecret()
+ // Do something with the apiSecret
+})
+```
+
+## `addServerScanDir`
+
+Add directories to be scanned by Nitro. It will check for subdirectories, which will be registered
+just like the `~~/server` folder is.
+
+::note
+Only `~~/server/api`, `~~/server/routes`, `~~/server/middleware`, and `~~/server/utils` are scanned.
+::
+
+### Usage
+
+```ts twoslash
+import { addServerScanDir, createResolver, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ meta: {
+ name: 'my-module',
+ configKey: 'myModule',
+ },
+ setup (options) {
+ const { resolve } = createResolver(import.meta.url)
+ addServerScanDir(resolve('./runtime/server'))
+ },
+})
+```
+
+### Type
+
+```ts
+function addServerScanDir (dirs: string | string[], opts: { prepend?: boolean }): void
+```
+
+### Parameters
+
+| Property | Type | Required | Description |
+|----------|---------------------------------|----------|---------------------------------------------------------------------------------------------------------------------|
+| `dirs` | `string \| string[]`{lang="ts"} | `true` | A directory or an array of directories to register to be scanned for by Nitro as server dirs. |
+| `opts` | `{ prepend?: boolean }` | `false` | Options for the import directory. If `prepend` is `true`, the directory is added to the beginning of the scan list. |
+
+### Examples
+
+You can use `addServerScanDir` to add a directory to be scanned by Nitro. This is useful when you want to add a custom server directory.
+
+::code-group
+
+```ts twoslash [module.ts]
+import { addServerScanDir, createResolver, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ meta: {
+ name: 'my-module',
+ configKey: 'myModule',
+ },
+ setup (options) {
+ const { resolve } = createResolver(import.meta.url)
+ addServerScanDir(resolve('./runtime/server'))
+ },
+})
+```
+
+```ts twoslash [runtime/server/utils/index.ts]
+export function hello () {
+ return 'Hello from server utils!'
+}
+```
+::
+
+You can then use the `hello` function in your server code.
+
+```ts twoslash [runtime/server/api/hello.ts]
+import { defineEventHandler } from 'nitro/h3'
+
+function hello () {
+ return 'Hello from server utils!'
+}
+// ---cut---
+export default defineEventHandler(() => {
+ return hello() // Hello from server utils!
+})
+```
diff --git a/docs/4.api/5.kit/12.resolving.md b/docs/4.api/5.kit/12.resolving.md
new file mode 100644
index 000000000000..fafe005f972d
--- /dev/null
+++ b/docs/4.api/5.kit/12.resolving.md
@@ -0,0 +1,214 @@
+---
+title: Resolving
+description: Nuxt Kit provides a set of utilities to help you resolve paths. These functions allow you to resolve paths relative to the current module, with unknown name or extension.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/kit/src/resolve.ts
+ size: xs
+---
+
+Sometimes you need to resolve a paths: relative to the current module, with unknown name or extension. For example, you may want to add a plugin that is located in the same directory as the module. To handle this cases, nuxt provides a set of utilities to resolve paths. `resolvePath` and `resolveAlias` are used to resolve paths relative to the current module. `findPath` is used to find first existing file in given paths. `createResolver` is used to create resolver relative to base path.
+
+## `resolvePath`
+
+Resolves full path to a file or directory respecting Nuxt alias and extensions options. If path could not be resolved, normalized input path will be returned.
+
+### Usage
+
+```ts
+import { defineNuxtModule, resolvePath } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ async setup () {
+ const entrypoint = await resolvePath('@unhead/vue')
+ console.log(`Unhead entrypoint is ${entrypoint}`)
+ },
+})
+```
+
+### Type
+
+```ts
+function resolvePath (path: string, options?: ResolvePathOptions): Promise<string>
+```
+
+### Parameters
+
+**`path`**: A path to resolve.
+
+**`options`**: Options to pass to the resolver. This object can have the following properties:
+
+| Property | Type | Required | Description |
+| -------------------- | ----------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------- |
+| `cwd` | `string` | `false` | Base for resolving paths from. Default is Nuxt rootDir. |
+| `alias` | `Record<string, string>`{lang="ts"} | `false` | An object of aliases. Default is Nuxt configured aliases. |
+| `extensions` | `string[]` | `false` | The file extensions to try. Default is Nuxt configured extensions. |
+| `virtual` | `boolean` | `false` | Whether to resolve files that exist in the Nuxt VFS (for example, as a Nuxt template). |
+| `fallbackToOriginal` | `boolean` | `false` | Whether to fallback to the original path if the resolved path does not exist instead of returning the normalized input path. |
+
+### Examples
+
+```ts
+import { defineNuxtModule, resolvePath } from '@nuxt/kit'
+import { join } from 'pathe'
+
+const headlessComponents: ComponentGroup[] = [
+ {
+ relativePath: 'combobox/combobox.js',
+ chunkName: 'headlessui/combobox',
+ exports: [
+ 'Combobox',
+ 'ComboboxLabel',
+ 'ComboboxButton',
+ 'ComboboxInput',
+ 'ComboboxOptions',
+ 'ComboboxOption',
+ ],
+ },
+]
+
+export default defineNuxtModule({
+ meta: {
+ name: 'nuxt-headlessui',
+ configKey: 'headlessui',
+ },
+ defaults: {
+ prefix: 'Headless',
+ },
+ async setup (options) {
+ const entrypoint = await resolvePath('@headlessui/vue')
+ const root = join(entrypoint, '../components')
+
+ for (const group of headlessComponents) {
+ for (const e of group.exports) {
+ addComponent(
+ {
+ name: e,
+ export: e,
+ filePath: join(root, group.relativePath),
+ chunkName: group.chunkName,
+ mode: 'all',
+ },
+ )
+ }
+ }
+ },
+})
+```
+
+## `resolveAlias`
+
+Resolves path aliases respecting Nuxt alias options.
+
+### Type
+
+```ts
+function resolveAlias (path: string, alias?: Record<string, string>): string
+```
+
+### Parameters
+
+**`path`**: A path to resolve.
+
+**`alias`**: An object of aliases. If not provided, it will be read from `nuxt.options.alias`.
+
+## `findPath`
+
+Try to resolve first existing file in given paths.
+
+### Usage
+
+```ts
+import { defineNuxtModule, findPath } from '@nuxt/kit'
+import { join } from 'pathe'
+
+export default defineNuxtModule({
+ async setup (_, nuxt) {
+ // Resolve main (app.vue)
+ const mainComponent = await findPath([
+ join(nuxt.options.srcDir, 'App'),
+ join(nuxt.options.srcDir, 'app'),
+ ])
+ },
+})
+```
+
+### Type
+
+```ts
+function findPath (paths: string | string[], options?: ResolvePathOptions, pathType: 'file' | 'dir'): Promise<string | null>
+```
+
+### Parameters
+
+**`paths`**: A path or an array of paths to resolve.
+
+**`options`**: Options to pass to the resolver. This object can have the following properties:
+
+| Property | Type | Required | Description |
+| -------------------- | ----------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------- |
+| `cwd` | `string` | `false` | Base for resolving paths from. Default is Nuxt rootDir. |
+| `alias` | `Record<string, string>`{lang="ts"} | `false` | An object of aliases. Default is Nuxt configured aliases. |
+| `extensions` | `string[]` | `false` | The file extensions to try. Default is Nuxt configured extensions. |
+| `virtual` | `boolean` | `false` | Whether to resolve files that exist in the Nuxt VFS (for example, as a Nuxt template). |
+| `fallbackToOriginal` | `boolean` | `false` | Whether to fallback to the original path if the resolved path does not exist instead of returning the normalized input path. |
+
+## `createResolver`
+
+Creates resolver relative to base path.
+
+::tip{icon="i-lucide-video" to="https://vueschool.io/lessons/resolving-paths-and-injecting-assets-to-the-app?friend=nuxt" target="_blank"}
+Watch Vue School video about createResolver.
+::
+
+### Usage
+
+```ts
+import { createResolver, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup (_, nuxt) {
+ const { resolve, resolvePath } = createResolver(import.meta.url)
+ },
+})
+```
+
+### Type
+
+```ts
+function createResolver (basePath: string | URL): Resolver
+```
+
+### Parameters
+
+**`basePath`**: A base path to resolve from. It can be a string or a URL.
+
+### Return Value
+
+The `createResolver` function returns an object with the following properties:
+
+| Property | Type | Description |
+| ------------- | ---------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
+| `resolve` | `(path: string) => string`{lang="ts"} | A function that resolves a path relative to the base path. |
+| `resolvePath` | `(path: string, options?: ResolvePathOptions) => Promise<string>`{lang="ts"} | A function that resolves a path relative to the base path and respects Nuxt alias and extensions options. |
+
+### Examples
+
+```ts
+import { createResolver, defineNuxtModule, isNuxt2 } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup (options, nuxt) {
+ const resolver = createResolver(import.meta.url)
+
+ nuxt.hook('modules:done', () => {
+ if (isNuxt2()) {
+ addPlugin(resolver.resolve('./runtime/plugin.vue2'))
+ } else {
+ addPlugin(resolver.resolve('./runtime/plugin.vue3'))
+ }
+ })
+ },
+})
+```
diff --git a/docs/4.api/5.kit/13.logging.md b/docs/4.api/5.kit/13.logging.md
new file mode 100644
index 000000000000..8882040567b7
--- /dev/null
+++ b/docs/4.api/5.kit/13.logging.md
@@ -0,0 +1,55 @@
+---
+title: "Logging"
+description: Nuxt Kit provides a set of utilities to help you work with logging. These functions allow you to log messages with extra features.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/kit/src/logger.ts
+ size: xs
+---
+
+Nuxt provides a logger instance that you can use to log messages with extra features. `useLogger` allows you to get a logger instance.
+
+## `useLogger`
+
+Returns a logger instance. It uses [consola](https://github.com/unjs/consola) under the hood.
+
+### Usage
+
+```ts twoslash
+import { defineNuxtModule, useLogger } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup (options, nuxt) {
+ const logger = useLogger('my-module')
+
+ logger.info('Hello from my module!')
+ },
+})
+```
+
+### Type
+
+```ts
+function useLogger (tag?: string, options?: Partial<ConsolaOptions>): ConsolaInstance
+```
+
+### Parameters
+
+**`tag`**: A tag to suffix all log messages with, displayed on the right near the timestamp.
+
+**`options`**: Consola configuration options.
+
+### Examples
+
+```ts twoslash
+import { defineNuxtModule, useLogger } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup (options, nuxt) {
+ const logger = useLogger('my-module', { level: options.quiet ? 0 : 3 })
+
+ logger.info('Hello from my module!')
+ },
+})
+```
diff --git a/docs/4.api/5.kit/14.builder.md b/docs/4.api/5.kit/14.builder.md
new file mode 100644
index 000000000000..c18a2a66b2be
--- /dev/null
+++ b/docs/4.api/5.kit/14.builder.md
@@ -0,0 +1,327 @@
+---
+title: Builder
+description: Nuxt Kit provides a set of utilities to help you work with the builder. These functions allow you to extend the Vite and webpack configurations.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/kit/src/build.ts
+ size: xs
+---
+
+Nuxt have builders based on [Vite](https://github.com/nuxt/nuxt/tree/main/packages/vite) and [webpack](https://github.com/nuxt/nuxt/tree/main/packages/webpack). You can extend the config passed to each one using `extendViteConfig` and `extendWebpackConfig` functions. You can also add additional plugins via `addVitePlugin`, `addWebpackPlugin` and `addBuildPlugin`.
+
+## `extendViteConfig`
+
+Extends the Vite configuration. Callback function can be called multiple times, when applying to both client and server builds.
+
+::warning
+This hook is now deprecated, and we recommend using a Vite plugin instead with a `config` hook, or — for environment-specific configuration — the `applyToEnvironment` hook.
+::
+
+### Usage
+
+```ts twoslash
+import { defineNuxtModule, extendViteConfig } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup () {
+ extendViteConfig((config) => {
+ config.optimizeDeps ||= {}
+ config.optimizeDeps.include ||= []
+ config.optimizeDeps.include.push('cross-fetch')
+ })
+ },
+})
+```
+
+For environment-specific configuration in Nuxt 5+, use `addVitePlugin()` instead:
+
+```ts twoslash
+import { addVitePlugin, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup () {
+ // For global configuration (affects all environments)
+ addVitePlugin(() => ({
+ name: 'my-global-plugin',
+ config (config) {
+ // This runs before environment setup
+ config.optimizeDeps ||= {}
+ config.optimizeDeps.include ||= []
+ config.optimizeDeps.include.push('cross-fetch')
+ },
+ }))
+
+ // For environment-specific configuration
+ addVitePlugin(() => ({
+ name: 'my-client-plugin',
+ applyToEnvironment (environment) {
+ return environment.name === 'client'
+ },
+ configEnvironment (name, config) {
+ // This only affects the client environment
+ config.optimizeDeps ||= {}
+ config.optimizeDeps.include ||= []
+ config.optimizeDeps.include.push('client-only-package')
+ },
+ }))
+ },
+})
+```
+
+::warning
+**Important:** The `config` hook runs before `applyToEnvironment` and modifies the global configuration. Use `configEnvironment` for environment-specific configuration changes.
+::
+
+### Type
+
+```ts twoslash
+// @errors: 2391
+import type { UserConfig as ViteConfig } from 'vite'
+import type { ExtendViteConfigOptions } from '@nuxt/kit'
+// ---cut---
+function extendViteConfig (callback: ((config: ViteConfig) => void), options?: ExtendViteConfigOptions): void
+```
+
+::read-more{to="https://vite.dev/config/" target="_blank" icon="i-simple-icons-vite"}
+Check out the Vite website for more information about its configuration.
+::
+
+### Parameters
+
+**`callback`**: A callback function that will be called with the Vite configuration object.
+
+**`options`**: Options to pass to the callback function. This object can have the following properties:
+
+| Property | Type | Required | Description |
+|-----------|-----------|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `dev` | `boolean` | `false` | If set to `true`, the callback function will be called when building in development mode. |
+| `build` | `boolean` | `false` | If set to `true`, the callback function will be called when building in production mode. |
+| `server` | `boolean` | `false` | If set to `true`, the callback function will be called when building the server bundle. **Deprecated in Nuxt 5+.** Use `addVitePlugin()` with `applyToEnvironment()` instead. |
+| `client` | `boolean` | `false` | If set to `true`, the callback function will be called when building the client bundle. **Deprecated in Nuxt 5+.** Use `addVitePlugin()` with `applyToEnvironment()` instead. |
+| `prepend` | `boolean` | `false` | If set to `true`, the callback function will be prepended to the array with `unshift()` instead of `push()`. |
+
+## `extendWebpackConfig`
+
+Extends the webpack configuration. Callback function can be called multiple times, when applying to both client and server builds.
+
+### Usage
+
+```ts twoslash
+import { defineNuxtModule, extendWebpackConfig } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup () {
+ extendWebpackConfig((config) => {
+ config.module!.rules!.push({
+ test: /\.txt$/,
+ use: 'raw-loader',
+ })
+ })
+ },
+})
+```
+
+### Type
+
+```ts twoslash
+// @errors: 2391
+import type { Configuration as WebpackConfig } from 'webpack'
+import type { ExtendWebpackConfigOptions } from '@nuxt/kit'
+// ---cut---
+function extendWebpackConfig (callback: ((config: WebpackConfig) => void), options?: ExtendWebpackConfigOptions): void
+```
+
+::read-more{to="https://webpack.js.org/configuration/" target="_blank" icon="i-simple-icons-webpack"}
+Check out webpack website for more information about its configuration.
+::
+
+### Parameters
+
+**`callback`**: A callback function that will be called with the webpack configuration object.
+
+**`options`**: Options to pass to the callback function. This object can have the following properties:
+
+| Property | Type | Required | Description |
+|-----------|-----------|----------|--------------------------------------------------------------------------------------------------------------|
+| `dev` | `boolean` | `false` | If set to `true`, the callback function will be called when building in development mode. |
+| `build` | `boolean` | `false` | If set to `true`, the callback function will be called when building in production mode. |
+| `server` | `boolean` | `false` | If set to `true`, the callback function will be called when building the server bundle. |
+| `client` | `boolean` | `false` | If set to `true`, the callback function will be called when building the client bundle. |
+| `prepend` | `boolean` | `false` | If set to `true`, the callback function will be prepended to the array with `unshift()` instead of `push()`. |
+
+## `addVitePlugin`
+
+Append Vite plugin to the config.
+
+::warning
+In Nuxt 5+, plugins registered with `server: false` or `client: false` options will not have their `config` or `configResolved` hooks called. Instead, use the `applyToEnvironment()` method instead for environment-specific plugins.
+::
+
+### Usage
+
+```ts twoslash
+// @errors: 2307
+// ---cut---
+import { addVitePlugin, defineNuxtModule } from '@nuxt/kit'
+import { svg4VuePlugin } from 'vite-plugin-svg4vue'
+
+export default defineNuxtModule({
+ meta: {
+ name: 'nuxt-svg-icons',
+ configKey: 'nuxtSvgIcons',
+ },
+ defaults: {
+ svg4vue: {
+ assetsDirName: 'assets/icons',
+ },
+ },
+ setup (options) {
+ addVitePlugin(svg4VuePlugin(options.svg4vue))
+
+ // or, to add a vite plugin to only one environment
+ addVitePlugin(() => ({
+ name: 'my-client-plugin',
+ applyToEnvironment (environment) {
+ return environment.name === 'client'
+ },
+ // ... rest of your client-only plugin
+ }))
+ },
+})
+```
+
+### Type
+
+```ts twoslash
+// @errors: 2391
+import type { Plugin as VitePlugin } from 'vite'
+import type { ExtendViteConfigOptions } from '@nuxt/kit'
+// ---cut---
+function addVitePlugin (pluginOrGetter: VitePlugin | VitePlugin[] | (() => VitePlugin | VitePlugin[]), options?: ExtendViteConfigOptions): void
+```
+
+::tip
+See [Vite website](https://vite.dev/guide/api-plugin) for more information about Vite plugins. You can also use [this repository](https://github.com/vitejs/awesome-vite#plugins) to find a plugin that suits your needs.
+::
+
+### Parameters
+
+**`pluginOrGetter`**: A Vite plugin instance or an array of Vite plugin instances. If a function is provided, it must return a Vite plugin instance or an array of Vite plugin instances. The function can also be async or return a Promise, which is useful for lazy-loading plugins:
+
+```ts twoslash
+// @errors: 2307
+import { addVitePlugin, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup () {
+ // Lazy load the plugin - only imported when the build actually runs
+ addVitePlugin(() => import('my-vite-plugin').then(r => r.default()))
+ },
+})
+```
+
+**`options`**: Options to pass to the callback function. This object can have the following properties:
+
+| Property | Type | Required | Description |
+|-----------|-----------|----------|--------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `dev` | `boolean` | `false` | If set to `true`, the callback function will be called when building in development mode. |
+| `build` | `boolean` | `false` | If set to `true`, the callback function will be called when building in production mode. |
+| `server` | `boolean` | `false` | If set to `true`, the callback function will be called when building the server bundle. **Deprecated in Nuxt 5+.** Use `applyToEnvironment()` instead. |
+| `client` | `boolean` | `false` | If set to `true`, the callback function will be called when building the client bundle. **Deprecated in Nuxt 5+.** Use `applyToEnvironment()` instead. |
+| `prepend` | `boolean` | `false` | If set to `true`, the callback function will be prepended to the array with `unshift()` instead of `push()`. |
+
+## `addWebpackPlugin`
+
+Append webpack plugin to the config.
+
+### Usage
+
+```ts
+import EslintWebpackPlugin from 'eslint-webpack-plugin'
+import { addWebpackPlugin, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ meta: {
+ name: 'nuxt-eslint',
+ configKey: 'eslint',
+ },
+ defaults: nuxt => ({
+ include: [`${nuxt.options.srcDir}/**/*.{js,jsx,ts,tsx,vue}`],
+ lintOnStart: true,
+ }),
+ setup (options, nuxt) {
+ const webpackOptions = {
+ ...options,
+ context: nuxt.options.srcDir,
+ files: options.include,
+ lintDirtyModulesOnly: !options.lintOnStart,
+ }
+ addWebpackPlugin(new EslintWebpackPlugin(webpackOptions), { server: false })
+ },
+})
+```
+
+### Type
+
+```ts twoslash
+// @errors: 2391
+import type { WebpackPluginInstance } from 'webpack'
+import type { ExtendWebpackConfigOptions } from '@nuxt/kit'
+// ---cut---
+function addWebpackPlugin (pluginOrGetter: WebpackPluginInstance | WebpackPluginInstance[] | (() => WebpackPluginInstance | WebpackPluginInstance[]), options?: ExtendWebpackConfigOptions): void
+```
+
+::tip
+See [webpack website](https://webpack.js.org/concepts/plugins/) for more information about webpack plugins. You can also use [this collection](https://webpack.js.org/awesome-webpack/#webpack-plugins) to find a plugin that suits your needs.
+::
+
+### Parameters
+
+**`pluginOrGetter`**: A webpack plugin instance or an array of webpack plugin instances. If a function is provided, it must return a webpack plugin instance or an array of webpack plugin instances. The function can also be async or return a Promise, enabling lazy-loading of plugins.
+
+**`options`**: Options to pass to the callback function. This object can have the following properties:
+
+| Property | Type | Required | Description |
+|-----------|-----------|----------|--------------------------------------------------------------------------------------------------------------|
+| `dev` | `boolean` | `false` | If set to `true`, the callback function will be called when building in development mode. |
+| `build` | `boolean` | `false` | If set to `true`, the callback function will be called when building in production mode. |
+| `server` | `boolean` | `false` | If set to `true`, the callback function will be called when building the server bundle. |
+| `client` | `boolean` | `false` | If set to `true`, the callback function will be called when building the client bundle. |
+| `prepend` | `boolean` | `false` | If set to `true`, the callback function will be prepended to the array with `unshift()` instead of `push()`. |
+
+## `addBuildPlugin`
+
+Builder-agnostic version of `addVitePlugin` and `addWebpackPlugin`. It will add the plugin to both Vite and webpack configurations if they are present.
+
+### Type
+
+```ts twoslash
+// @errors: 2391
+import type { ExtendConfigOptions } from '@nuxt/kit'
+import type { Plugin as VitePlugin } from 'vite'
+import type { WebpackPluginInstance } from 'webpack'
+import type { RspackPluginInstance } from '@rspack/core'
+
+interface AddBuildPluginFactory {
+ vite?: () => VitePlugin | VitePlugin[]
+ webpack?: () => WebpackPluginInstance | WebpackPluginInstance[]
+ rspack?: () => RspackPluginInstance | RspackPluginInstance[]
+}
+// ---cut---
+function addBuildPlugin (pluginFactory: AddBuildPluginFactory, options?: ExtendConfigOptions): void
+```
+
+### Parameters
+
+**`pluginFactory`**: A factory function that returns an object with `vite` and/or `webpack` properties. These properties must be functions that return a Vite plugin instance or an array of Vite plugin instances and/or a webpack plugin instance or an array of webpack plugin instances.
+
+**`options`**: Options to pass to the callback function. This object can have the following properties:
+
+| Property | Type | Required | Description |
+|-----------|-----------|----------|--------------------------------------------------------------------------------------------------------------|
+| `dev` | `boolean` | `false` | If set to `true`, the callback function will be called when building in development mode. |
+| `build` | `boolean` | `false` | If set to `true`, the callback function will be called when building in production mode. |
+| `server` | `boolean` | `false` | If set to `true`, the callback function will be called when building the server bundle. |
+| `client` | `boolean` | `false` | If set to `true`, the callback function will be called when building the client bundle. |
+| `prepend` | `boolean` | `false` | If set to `true`, the callback function will be prepended to the array with `unshift()` instead of `push()`. |
diff --git a/docs/4.api/5.kit/15.examples.md b/docs/4.api/5.kit/15.examples.md
new file mode 100644
index 000000000000..c8de488a85a8
--- /dev/null
+++ b/docs/4.api/5.kit/15.examples.md
@@ -0,0 +1,39 @@
+---
+title: "Examples"
+description: Examples of Nuxt Kit utilities in use.
+---
+
+## Accessing Nuxt Vite Config
+
+If you are building an integration that needs access to the runtime Vite or webpack config that Nuxt uses, it is possible to extract this using Kit utilities.
+
+Some examples of projects doing this already:
+
+- [histoire](https://github.com/histoire-dev/histoire/blob/main/packages/histoire-plugin-nuxt/src/index.ts)
+- [nuxt-vitest](https://github.com/danielroe/nuxt-vitest/blob/main/packages/nuxt-vitest/src/config.ts)
+- [@storybook-vue/nuxt](https://github.com/storybook-vue/storybook-nuxt/blob/main/packages/storybook-nuxt/src/preset.ts)
+
+Here is a brief example of how you might access the Vite config from a project; you could implement a similar approach to get the webpack configuration.
+
+```js
+import { buildNuxt, loadNuxt } from '@nuxt/kit'
+
+// https://github.com/nuxt/nuxt/issues/14534
+async function getViteConfig () {
+ const nuxt = await loadNuxt({ cwd: process.cwd(), dev: false, overrides: { ssr: false } })
+ return new Promise((resolve, reject) => {
+ nuxt.hook('vite:extend', (config) => {
+ resolve(config)
+ throw new Error('_stop_')
+ })
+ buildNuxt(nuxt).catch((err) => {
+ if (!err.toString().includes('_stop_')) {
+ reject(err)
+ }
+ })
+ }).finally(() => nuxt.close())
+}
+
+const viteConfig = await getViteConfig()
+console.log(viteConfig)
+```
diff --git a/docs/4.api/5.kit/16.layers.md b/docs/4.api/5.kit/16.layers.md
new file mode 100644
index 000000000000..a1e03cb0e3d5
--- /dev/null
+++ b/docs/4.api/5.kit/16.layers.md
@@ -0,0 +1,220 @@
+---
+title: "Layers"
+description: Nuxt Kit provides utilities to help you work with layers and their directory structures.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/kit/src/layers.ts
+ size: xs
+---
+
+Nuxt layers provide a powerful way to share and extend functionality across projects. When working with layers in modules, you often need to access directory paths from each layer. Nuxt Kit provides the `getLayerDirectories` utility to access resolved directory paths for all layers in your Nuxt application.
+
+## `getLayerDirectories`
+
+Get the resolved directory paths for all layers in a Nuxt application. This function provides a structured way to access layer directories without directly accessing the private `nuxt.options._layers` property.
+
+### Usage
+
+```ts twoslash
+import { defineNuxtModule, getLayerDirectories } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup () {
+ const layerDirs = getLayerDirectories()
+
+ // Access directories from all layers
+ 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
+ }
+ },
+})
+```
+
+### Type
+
+```ts twoslash
+// @errors: 2391
+import type { Nuxt } from '@nuxt/schema'
+// ---cut---
+function getLayerDirectories (nuxt?: Nuxt): LayerDirectories[]
+
+interface LayerDirectories {
+ /** Nuxt rootDir (`/` by default) */
+ readonly root: string
+ /** Nitro source directory (`/server` by default) */
+ readonly server: string
+ /** Local modules directory (`/modules` by default) */
+ readonly modules: string
+ /** Shared directory (`/shared` by default) */
+ readonly shared: string
+ /** Public directory (`/public` by default) */
+ readonly public: string
+ /** Nuxt srcDir (`/app/` by default) */
+ readonly app: string
+ /** Layouts directory (`/app/layouts` by default) */
+ readonly appLayouts: string
+ /** Middleware directory (`/app/middleware` by default) */
+ readonly appMiddleware: string
+ /** Pages directory (`/app/pages` by default) */
+ readonly appPages: string
+ /** Plugins directory (`/app/plugins` by default) */
+ readonly appPlugins: string
+}
+```
+
+### Parameters
+
+**`nuxt`** (optional): The Nuxt instance to get layers from. If not provided, the function will use the current Nuxt context.
+
+### Return Value
+
+The `getLayerDirectories` function returns an array of `LayerDirectories` objects, one for each layer in the application.
+
+**Layer Priority Ordering**: The layers are ordered by priority, where:
+- The **first layer** is the user/project layer (highest priority)
+- **Earlier layers override later layers** in the array
+- **Base layers appear last** in the array (lowest priority)
+
+This ordering matches Nuxt's layer resolution system, where user-defined configurations and files take precedence over those from base layers.
+
+**`LayerDirectories`**: An object containing the resolved directory paths for a layer.
+
+| Property | Type | Description |
+|-----------------|----------|--------------------------------------------------------------|
+| `root` | `string` | The root directory of the layer (equivalent to `rootDir`) |
+| `server` | `string` | The server directory for Nitro server-side code |
+| `modules` | `string` | The local modules directory |
+| `shared` | `string` | The shared directory for code used by both client and server |
+| `app` | `string` | The source directory of the layer (equivalent to `srcDir`) |
+| `public` | `string` | The public directory for static assets |
+| `appLayouts` | `string` | The layouts directory for Vue layout components |
+| `appMiddleware` | `string` | The middleware directory for route middleware |
+| `appPages` | `string` | The pages directory for file-based routing |
+| `appPlugins` | `string` | The plugins directory for Nuxt plugins |
+
+### Examples
+
+**Processing files from all layers:**
+
+```ts twoslash
+// @errors: 2307
+// ---cut---
+import { defineNuxtModule, getLayerDirectories } from '@nuxt/kit'
+import { resolve } from 'pathe'
+import { globby } from 'globby'
+
+export default defineNuxtModule({
+ async setup () {
+ const layerDirs = getLayerDirectories()
+
+ // Find all component files across layers
+ // Note: layerDirs[0] is the user layer (highest priority)
+ // Later layers in the array have lower priority
+ const componentFiles = []
+ for (const [index, layer] of layerDirs.entries()) {
+ const files = await globby('**/*.vue', {
+ cwd: resolve(layer.app, 'components'),
+ absolute: true,
+ })
+ console.log(`Layer ${index} (${index === 0 ? 'user' : 'base'}):`, files.length, 'components')
+ componentFiles.push(...files)
+ }
+ },
+})
+```
+
+**Adding templates from multiple layers:**
+
+```ts twoslash
+import { addTemplate, defineNuxtModule, getLayerDirectories } from '@nuxt/kit'
+import { basename, resolve } from 'pathe'
+import { existsSync } from 'node:fs'
+
+export default defineNuxtModule({
+ setup () {
+ const layerDirs = getLayerDirectories()
+
+ // Add a config file from each layer that has one
+ for (const dirs of layerDirs) {
+ const configPath = resolve(dirs.app, 'my-module.config.ts')
+ if (existsSync(configPath)) {
+ addTemplate({
+ filename: `my-module-${basename(dirs.root)}.config.ts`,
+ src: configPath,
+ })
+ }
+ }
+ },
+})
+```
+
+**Respecting layer priority:**
+
+```ts twoslash
+import { defineNuxtModule, getLayerDirectories } from '@nuxt/kit'
+import { resolve } from 'pathe'
+import { existsSync, readFileSync } from 'node:fs'
+
+export default defineNuxtModule({
+ setup () {
+ const layerDirs = getLayerDirectories()
+
+ // Find the first (highest priority) layer that has a specific config file
+ // This respects the layer priority system
+ let configContent = null
+ for (const dirs of layerDirs) {
+ const configPath = resolve(dirs.app, 'my-config.json')
+ if (existsSync(configPath)) {
+ configContent = readFileSync(configPath, 'utf-8')
+ console.log(`Using config from layer: ${dirs.root}`)
+ break // Use the first (highest priority) config found
+ }
+ }
+
+ // Alternative: Collect configs from all layers, with user layer taking precedence
+ const allConfigs = {}
+ for (const dirs of layerDirs.reverse()) { // Process from lowest to highest priority
+ const configPath = resolve(dirs.app, 'my-config.json')
+ if (existsSync(configPath)) {
+ const config = JSON.parse(readFileSync(configPath, 'utf-8'))
+ Object.assign(allConfigs, config) // Later assignments override earlier ones
+ }
+ }
+ },
+})
+```
+
+**Checking for layer-specific directories:**
+
+```ts twoslash
+import { defineNuxtModule, getLayerDirectories } from '@nuxt/kit'
+import { existsSync } from 'node:fs'
+import { resolve } from 'pathe'
+
+export default defineNuxtModule({
+ setup () {
+ const layerDirs = getLayerDirectories()
+
+ // Find layers that have a specific custom directory
+ const layersWithAssets = layerDirs.filter((layer) => {
+ return existsSync(resolve(layer.app, 'assets'))
+ })
+
+ console.log(`Found ${layersWithAssets.length} layers with assets directory`)
+ },
+})
+```
+
+::note
+The `getLayerDirectories` function includes caching via a WeakMap to avoid recomputing directory paths for the same layers repeatedly, improving performance when called multiple times.
+::
+
+::note
+Directory paths returned by this function always include a trailing slash for consistency.
+::
diff --git a/docs/4.api/5.kit/2.programmatic.md b/docs/4.api/5.kit/2.programmatic.md
new file mode 100644
index 000000000000..c348e5695188
--- /dev/null
+++ b/docs/4.api/5.kit/2.programmatic.md
@@ -0,0 +1,72 @@
+---
+title: "Programmatic Usage"
+description: Nuxt Kit provides a set of utilities to help you work with Nuxt programmatically. These functions allow you to load Nuxt, build Nuxt, and load Nuxt configuration.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/tree/main/packages/kit/src/loader
+ size: xs
+---
+
+Programmatic usage can be helpful when you want to use Nuxt programmatically, for example, when building a [CLI tool](https://github.com/nuxt/cli) or [test utils](https://github.com/nuxt/test-utils).
+
+## `loadNuxt`
+
+Load Nuxt programmatically. It will load the Nuxt configuration, instantiate and return the promise with Nuxt instance.
+
+### Type
+
+```ts
+function loadNuxt (loadOptions?: LoadNuxtOptions): Promise<Nuxt>
+```
+
+### Parameters
+
+**`loadOptions`**: Loading conditions for Nuxt. `loadNuxt` uses [`c12`](https://github.com/unjs/c12) under the hood, so it accepts the same options as `c12.loadConfig` with some additional options:
+
+| Property | Type | Required | Description |
+| -------- | --------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `dev` | `boolean` | `false` | If set to `true`, Nuxt will be loaded in development mode. |
+| `ready` | `boolean` | `true` | If set to `true`, Nuxt will be ready to use after the `loadNuxt` call. If set to `false`, you will need to call `nuxt.ready()` to make sure Nuxt is ready to use. |
+
+## `buildNuxt`
+
+Build Nuxt programmatically. It will invoke the builder (currently [@nuxt/vite-builder](https://github.com/nuxt/nuxt/tree/main/packages/vite) or [@nuxt/webpack-builder](https://github.com/nuxt/nuxt/tree/main/packages/webpack)) to bundle the application.
+
+### Type
+
+```ts
+function buildNuxt (nuxt: Nuxt): Promise<any>
+```
+
+### Parameters
+
+**`nuxt`**: Nuxt instance to build. It can be retrieved from the context via `useNuxt()` call.
+
+## `loadNuxtConfig`
+
+Load Nuxt configuration. It will return the promise with the configuration object.
+
+### Type
+
+```ts
+function loadNuxtConfig (options: LoadNuxtConfigOptions): Promise<NuxtOptions>
+```
+
+### Parameters
+
+**`options`**: Options to pass in [`c12`](https://github.com/unjs/c12#options) `loadConfig` call.
+
+## `writeTypes`
+
+Generates `tsconfig.json` and writes it to the project buildDir.
+
+### Type
+
+```ts
+function writeTypes (nuxt?: Nuxt): void
+```
+
+### Parameters
+
+**`nuxt`**: Nuxt instance to build. It can be retrieved from the context via `useNuxt()` call.
diff --git a/docs/4.api/5.kit/3.compatibility.md b/docs/4.api/5.kit/3.compatibility.md
new file mode 100644
index 000000000000..b77ad8f55f45
--- /dev/null
+++ b/docs/4.api/5.kit/3.compatibility.md
@@ -0,0 +1,183 @@
+---
+title: "Compatibility"
+description: Nuxt Kit provides a set of utilities to help you check the compatibility of your modules with different Nuxt versions.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/kit/src/compatibility.ts
+ size: xs
+---
+
+Nuxt Kit utilities can be used in Nuxt 3, Nuxt 2 with Bridge and even Nuxt 2 without Bridge. To make sure your module is compatible with all versions, you can use the `checkNuxtCompatibility`, `assertNuxtCompatibility` and `hasNuxtCompatibility` functions. They will check if the current Nuxt version meets the constraints you provide. Also you can use `isNuxt2`, `isNuxt3` and `getNuxtVersion` functions for more granular checks.
+
+## `checkNuxtCompatibility`
+
+Checks if constraints are met for the current Nuxt version. If not, returns an array of messages. Nuxt 2 version also checks for `bridge` support.
+
+### Usage
+
+```ts twoslash
+import { checkNuxtCompatibility, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ async setup (_options, nuxt) {
+ const issues = await checkNuxtCompatibility({ nuxt: '^2.16.0' }, nuxt)
+ if (issues.length) {
+ console.warn('Nuxt compatibility issues found:\n' + issues.toString())
+ } else {
+ // do something
+ }
+ },
+})
+```
+
+### Type
+
+```ts
+function checkNuxtCompatibility (constraints: NuxtCompatibility, nuxt?: Nuxt): Promise<NuxtCompatibilityIssues>
+```
+
+### Parameters
+
+**`constraints`**: Version and builder constraints to check against. It accepts the following properties:
+
+| Property | Type | Required | Description |
+| -------- | --------------------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `nuxt` | `string` | `false` | Nuxt version in semver format. Versions may be defined in Node.js way, for example: `>=2.15.0 <3.0.0`. |
+| `bridge` | `Record<string, string \| false>`{lang="ts"} | `false` | Specifies version constraints or disables compatibility for specific Nuxt builders like `vite`, `webpack`, or `rspack`. Use `false` to disable. |
+
+**`nuxt`**: Nuxt instance. If not provided, it will be retrieved from the context via `useNuxt()` call.
+
+## `assertNuxtCompatibility`
+
+Asserts that constraints are met for the current Nuxt version. If not, throws an error with the list of issues as string.
+
+### Type
+
+```ts twoslash
+// @errors: 2391
+import type { Nuxt, NuxtCompatibility } from '@nuxt/schema'
+// ---cut---
+function assertNuxtCompatibility (constraints: NuxtCompatibility, nuxt?: Nuxt): Promise<true>
+```
+
+### Parameters
+
+**`constraints`**: Version and builder constraints to check against. Refer to the [constraints table in `checkNuxtCompatibility`](/docs/4.x/api/kit/compatibility#parameters) for details.
+
+**`nuxt`**: Nuxt instance. If not provided, it will be retrieved from the context via `useNuxt()` call.
+
+## `hasNuxtCompatibility`
+
+Checks if constraints are met for the current Nuxt version. Return `true` if all constraints are met, otherwise returns `false`. Nuxt 2 version also checks for `bridge` support.
+
+### Usage
+
+```ts twoslash
+import { defineNuxtModule, hasNuxtCompatibility } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ async setup (_options, nuxt) {
+ const usingNewPostcss = await hasNuxtCompatibility({ nuxt: '^2.16.0' }, nuxt)
+ if (usingNewPostcss) {
+ // do something
+ } else {
+ // do something else
+ }
+ },
+})
+```
+
+### Type
+
+```ts
+function hasNuxtCompatibility (constraints: NuxtCompatibility, nuxt?: Nuxt): Promise<boolean>
+```
+
+### Parameters
+
+**`constraints`**: Version and builder constraints to check against. Refer to the [constraints table in `checkNuxtCompatibility`](/docs/4.x/api/kit/compatibility#parameters) for details.
+
+**`nuxt`**: Nuxt instance. If not provided, it will be retrieved from the context via `useNuxt()` call.
+
+## `isNuxtMajorVersion`
+
+Check if current Nuxt instance is of specified major version
+
+### Usage
+
+```ts twoslash
+import { defineNuxtModule, isNuxtMajorVersion } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup () {
+ if (isNuxtMajorVersion(3)) {
+ // do something for Nuxt 3
+ } else {
+ // do something else for other versions
+ }
+ },
+})
+```
+
+### Type
+
+```ts
+function isNuxtMajorVersion (major: number, nuxt?: Nuxt): boolean
+```
+
+### Parameters
+
+**`major`**: Major version to check against.
+
+**`nuxt`**: Nuxt instance. If not provided, it will be retrieved from the context via `useNuxt()` call.
+
+## `isNuxt3`
+
+Checks if the current Nuxt version is 3.x.
+
+::note
+Use `isNuxtMajorVersion(2, nuxt)` instead. This may be removed in \@nuxt/kit v5 or a future major version.
+::
+
+### Type
+
+```ts
+function isNuxt3 (nuxt?: Nuxt): boolean
+```
+
+### Parameters
+
+**`nuxt`**: Nuxt instance. If not provided, it will be retrieved from the context via `useNuxt()` call.
+
+## `isNuxt2`
+
+Checks if the current Nuxt version is 2.x.
+
+::note
+Use `isNuxtMajorVersion(2, nuxt)` instead. This may be removed in \@nuxt/kit v5 or a future major version.
+::
+
+### Type
+
+```ts
+function isNuxt2 (nuxt?: Nuxt): boolean
+```
+
+### Parameters
+
+**`nuxt`**: Nuxt instance. If not provided, it will be retrieved from the context via `useNuxt()` call.
+
+## `getNuxtVersion`
+
+Returns the current Nuxt version.
+
+### Type
+
+```ts
+function getNuxtVersion (nuxt?: Nuxt): string
+```
+
+### Parameters
+
+**`nuxt`**: Nuxt instance. If not provided, it will be retrieved from the context via `useNuxt()` call.
diff --git a/docs/4.api/5.kit/4.autoimports.md b/docs/4.api/5.kit/4.autoimports.md
new file mode 100644
index 000000000000..d4871f593a5e
--- /dev/null
+++ b/docs/4.api/5.kit/4.autoimports.md
@@ -0,0 +1,159 @@
+---
+title: "Auto-imports"
+description: Nuxt Kit provides a set of utilities to help you work with auto-imports. These functions allow you to register your own utils, composables and Vue APIs.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/kit/src/imports.ts
+ size: xs
+---
+
+Nuxt auto-imports helper functions, composables and Vue APIs to use across your application without explicitly importing them. Based on the directory structure, every Nuxt application can also use auto-imports for its own composables and plugins.
+
+With Nuxt Kit you can also add your own auto-imports. `addImports` and `addImportsDir` allow you to add imports to the Nuxt application. `addImportsSources` allows you to add listed imports from 3rd party packages to the Nuxt application.
+
+These utilities are powered by [`unimport`](https://github.com/unjs/unimport), which provides the underlying auto-import mechanism used in Nuxt.
+
+::note
+These functions are designed for registering your own utils, composables and Vue APIs. For pages, components and plugins, please refer to the specific sections: [Pages](/docs/4.x/api/kit/pages), [Components](/docs/4.x/api/kit/components), [Plugins](/docs/4.x/api/kit/plugins).
+::
+
+::tip{icon="i-lucide-video" to="https://vueschool.io/lessons/expanding-nuxt-s-auto-imports?friend=nuxt" target="_blank"}
+Watch Vue School video about Auto-imports Nuxt Kit utilities.
+::
+
+## `addImports`
+
+Add imports to the Nuxt application. It makes your imports available in the Nuxt app context without the need to import them manually.
+
+::tip
+To add imports for the Nitro server context, refer to the [`addServerImports`](/docs/4.x/api/kit/nitro#addserverimports) function.
+::
+
+### Usage
+
+```ts twoslash
+import { addImports, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup (options, nuxt) {
+ const names = [
+ 'useStoryblok',
+ 'useStoryblokApi',
+ 'useStoryblokBridge',
+ 'renderRichText',
+ 'RichTextSchema',
+ ]
+
+ names.forEach(name =>
+ addImports({ name, as: name, from: '@storyblok/vue' }),
+ )
+ },
+})
+```
+
+### Type
+
+```ts
+function addImports (imports: Import | Import[]): void
+```
+
+### Parameters
+
+`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. |
+
+## `addImportsDir`
+
+Add imports from a directory to the Nuxt application. It will automatically import all files from the directory and make them available in the Nuxt application without the need to import them manually.
+
+### Usage
+
+```ts twoslash
+import { addImportsDir, createResolver, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ meta: {
+ name: '@vueuse/motion',
+ configKey: 'motion',
+ },
+ setup (options, nuxt) {
+ const resolver = createResolver(import.meta.url)
+ addImportsDir(resolver.resolve('./runtime/composables'))
+ },
+})
+```
+
+### Type
+
+```ts
+function addImportsDir (dirs: string | string[], options?: { prepend?: boolean }): void
+```
+
+### 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. |
+
+## `addImportsSources`
+
+Add listed imports to the Nuxt application.
+
+### Usage
+
+```ts twoslash
+import { addImportsSources, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup () {
+ addImportsSources([
+ { package: '@vueuse/core' },
+ {
+ from: 'h3',
+ imports: [
+ 'defineEventHandler',
+ 'getQuery',
+ 'getRouterParams',
+ 'readBody',
+ 'sendRedirect',
+ ],
+ },
+ ])
+ },
+})
+```
+
+### Type
+
+```ts
+function addImportsSources (importSources: Preset | Preset[]): void
+```
+
+### Parameters
+
+**importSources**: An object or an array of objects with the following properties:
+
+- InlinePreset
+
+| 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. |
+
+- PackagePreset
+
+| Property | Type | Required | Description |
+|-----------|---------------------------------------------|----------|------------------------------------------------------------------------------------------------|
+| `package` | `string` | `true` | Name of the package. |
diff --git a/docs/4.api/5.kit/5.components.md b/docs/4.api/5.kit/5.components.md
new file mode 100644
index 000000000000..e82b58b81a82
--- /dev/null
+++ b/docs/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',
+ })
+ },
+})
+```
diff --git a/docs/4.api/5.kit/6.context.md b/docs/4.api/5.kit/6.context.md
new file mode 100644
index 000000000000..98b386e30e29
--- /dev/null
+++ b/docs/4.api/5.kit/6.context.md
@@ -0,0 +1,174 @@
+---
+title: "Context"
+description: Nuxt Kit provides a set of utilities to help you work with context.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/kit/src/context.ts
+ size: xs
+---
+
+Nuxt modules allow you to enhance Nuxt's capabilities. They offer a structured way to keep your code organized and modular. If you're looking to break down your module into smaller components, Nuxt offers the `useNuxt` and `tryUseNuxt` functions. These functions enable you to conveniently access the Nuxt instance from the context without having to pass it as an argument.
+
+::note
+When you're working with the `setup` function in Nuxt modules, Nuxt is already provided as the second argument. This means you can access it directly without needing to call `useNuxt()`.
+::
+
+## `useNuxt`
+
+Get the Nuxt instance from the context. It will throw an error if Nuxt is not available.
+
+### Usage
+
+```ts
+import { useNuxt } from '@nuxt/kit'
+
+const setupSomeFeature = () => {
+ const nuxt = useNuxt()
+
+ // You can now use the nuxt instance
+ console.log(nuxt.options)
+}
+```
+
+### Type
+
+```ts twoslash
+// @errors: 2391
+import type { Nuxt } from '@nuxt/schema'
+// ---cut---
+function useNuxt (): Nuxt
+```
+
+### Return Value
+
+The `useNuxt` function returns the Nuxt instance, which contains all the options and methods available in Nuxt.
+
+| Property | Type | Description |
+| ---------- | ------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
+| `options` | `NuxtOptions` | The resolved Nuxt configuration. |
+| `hooks` | `Hookable<NuxtHooks>` | The Nuxt hook system. Allows registering and listening to lifecycle events. |
+| `hook` | `(name: string, (...args: any[]) => Promise<void> \| void) => () => void` | Shortcut for `nuxt.hooks.hook`. Registers a single callback for a specific lifecycle hook. |
+| `callHook` | `(name: string, ...args: any[]) => Promise<any>` | Shortcut for `nuxt.hooks.callHook`. Triggers a lifecycle hook manually and runs all registered callbacks. |
+| `addHooks` | `(configHooks: NestedHooks) => () => void` | Shortcut for `nuxt.hooks.addHooks`. Registers multiple hooks at once. |
+
+### Examples
+
+::code-group
+
+```ts twoslash [setupTranspilation.ts]
+import { useNuxt } from '@nuxt/kit'
+
+export const setupTranspilation = () => {
+ const nuxt = useNuxt()
+
+ if (nuxt.options.builder === '@nuxt/webpack-builder') {
+ nuxt.options.build.transpile ||= []
+ nuxt.options.build.transpile.push('xstate')
+ }
+}
+```
+
+```ts twoslash [module.ts]
+// @module: esnext
+// @filename: setupTranspilation.ts
+export const setupTranspilation = () => {}
+// @filename: module.ts
+import { defineNuxtModule } from '@nuxt/kit'
+// ---cut---
+import { setupTranspilation } from './setupTranspilation'
+
+export default defineNuxtModule({
+ setup () {
+ setupTranspilation()
+ },
+})
+```
+
+::
+
+## `tryUseNuxt`
+
+Get the Nuxt instance from the context. It will return `null` if Nuxt is not available.
+
+### Usage
+
+```ts twoslash
+import { tryUseNuxt } from '@nuxt/kit'
+
+function setupSomething () {
+ const nuxt = tryUseNuxt()
+
+ if (nuxt) {
+ // You can now use the nuxt instance
+ console.log(nuxt.options)
+ } else {
+ console.log('Nuxt is not available')
+ }
+}
+```
+
+### Type
+
+```ts twoslash
+// @errors: 2391
+import type { Nuxt } from '@nuxt/schema'
+// ---cut---
+function tryUseNuxt (): Nuxt | null
+```
+
+### Return Value
+
+The `tryUseNuxt` function returns the Nuxt instance if available, or `null` if Nuxt is not available.
+
+The Nuxt instance as described in the `useNuxt` section.
+
+### Examples
+
+::code-group
+
+```ts twoslash [requireSiteConfig.ts]
+declare module '@nuxt/schema' {
+ interface NuxtOptions {
+ siteConfig: SiteConfig
+ }
+}
+// ---cut---
+import { tryUseNuxt } from '@nuxt/kit'
+
+interface SiteConfig {
+ title?: string
+}
+
+export const requireSiteConfig = (): SiteConfig => {
+ const nuxt = tryUseNuxt()
+ if (!nuxt) {
+ return {}
+ }
+ return nuxt.options.siteConfig
+}
+```
+
+```ts twoslash [module.ts]
+// @module: esnext
+// @filename: requireSiteConfig.ts
+interface SiteConfig {
+ title?: string
+}
+export const requireSiteConfig = (): SiteConfig => {
+ return {}
+}
+// @filename: module.ts
+// ---cut---
+import { defineNuxtModule, useNuxt } from '@nuxt/kit'
+import { requireSiteConfig } from './requireSiteConfig'
+
+export default defineNuxtModule({
+ setup (_, nuxt) {
+ const config = requireSiteConfig()
+ nuxt.options.app.head.title = config.title
+ },
+})
+```
+
+::
diff --git a/docs/4.api/5.kit/7.pages.md b/docs/4.api/5.kit/7.pages.md
new file mode 100644
index 000000000000..2fa0269fda19
--- /dev/null
+++ b/docs/4.api/5.kit/7.pages.md
@@ -0,0 +1,193 @@
+---
+title: Pages
+description: Nuxt Kit provides a set of utilities to help you create and use pages. You can use these utilities to manipulate the pages configuration or to define route rules.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/kit/src/pages.ts
+ size: xs
+---
+
+## `extendPages`
+
+In Nuxt, routes are automatically generated based on the structure of the files in the `app/pages` directory. However, there may be scenarios where you'd want to customize these routes. For instance, you might need to add a route for a dynamic page not generated by Nuxt, remove an existing route, or modify the configuration of a route. For such customizations, Nuxt offers the `extendPages` feature, which allows you to extend and alter the pages configuration.
+
+::tip{icon="i-lucide-video" to="https://vueschool.io/lessons/extend-and-alter-nuxt-pages?friend=nuxt" target="_blank"}
+Watch Vue School video about extendPages.
+::
+
+### Usage
+
+```ts twoslash
+import { createResolver, defineNuxtModule, extendPages } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup (options) {
+ const { resolve } = createResolver(import.meta.url)
+
+ extendPages((pages) => {
+ pages.unshift({
+ name: 'prismic-preview',
+ path: '/preview',
+ file: resolve('runtime/preview.vue'),
+ })
+ })
+ },
+})
+```
+
+### Type
+
+```ts
+function extendPages (callback: (pages: NuxtPage[]) => void): void
+```
+
+### Parameters
+
+**callback**: A function that will be called with the pages configuration. You can alter this array by adding, deleting, or modifying its elements. Note: You should modify the provided pages array directly, as changes made to a copied array will not be reflected in the configuration.
+
+| Property | Type | Required | Description |
+| ---------- | ---------------------------------- | -------- | -------------------------------------------------------------------------------------------- |
+| `name` | `string` | `false` | The name of the route. Useful for programmatic navigation and identifying routes. |
+| `path` | `string` | `false` | The route URL path. If not set, Nuxt will infer it from the file location. |
+| `file` | `string` | `false` | Path to the Vue file that should be used as the component for the route. |
+| `meta` | `Record<string, any>`{lang="ts"} | `false` | Custom metadata for the route. Can be used in layouts, middlewares, or navigation guards. |
+| `alias` | `string[] \| string`{lang="ts"} | `false` | One or more alias paths for the route. Useful for supporting multiple URLs. |
+| `redirect` | `RouteLocationRaw`{lang="ts"} | `false` | Redirect rule for the route. Supports named routes, objects, or string paths. |
+| `children` | `NuxtPage[]`{lang="ts"} | `false` | Nested child routes under this route for layout or view nesting. |
+
+## `extendRouteRules`
+
+Nuxt is powered by the [Nitro](https://nitro.build/) server engine. With Nitro, you can incorporate high-level logic directly into your configuration, which is useful for actions like redirects, proxying, caching, and appending headers to routes. This configuration works by associating route patterns with specific route settings.
+
+::tip
+You can read more about Nitro route rules in the [Nitro documentation](https://nitro.build/guide/routing#route-rules).
+::
+
+::tip{icon="i-lucide-video" to="https://vueschool.io/lessons/adding-route-rules-and-route-middlewares?friend=nuxt" target="_blank"}
+Watch Vue School video about adding route rules and route middelwares.
+::
+
+### Usage
+
+```ts twoslash
+import { createResolver, defineNuxtModule, extendPages, extendRouteRules } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup (options) {
+ const { resolve } = createResolver(import.meta.url)
+
+ extendPages((pages) => {
+ pages.unshift({
+ name: 'preview-new',
+ path: '/preview-new',
+ file: resolve('runtime/preview.vue'),
+ })
+ })
+
+ extendRouteRules('/preview', {
+ redirect: {
+ to: '/preview-new',
+ status: 302,
+ },
+ })
+
+ extendRouteRules('/preview-new', {
+ cache: {
+ maxAge: 60 * 60 * 24 * 7,
+ },
+ })
+ },
+})
+```
+
+### Type
+
+```ts
+function extendRouteRules (route: string, rule: NitroRouteConfig, options?: ExtendRouteRulesOptions): void
+```
+
+### Parameters
+
+**route**: A route pattern to match against.\
+**rule**: A route rule configuration to apply to the matched route.
+
+::tip
+About route rules configurations, you can get more detail in [Hybrid Rendering > Route Rules](/docs/4.x/guide/concepts/rendering#route-rules).
+::
+
+**options**: A object to pass to the route configuration. If `override` is set to `true`, it will override the existing route configuration.
+
+| Name | Type | Default | Description |
+| ---------- | --------- | ------- | -------------------------------------------- |
+| `override` | `boolean` | `false` | Override route rule config, default is false |
+
+## `addRouteMiddleware`
+
+Registers route middlewares to be available for all routes or for specific routes.
+
+Route middlewares can be also defined in plugins via [`addRouteMiddleware`](/docs/4.x/api/utils/add-route-middleware) composable.
+
+::tip
+Read more about route middlewares in the [Route middleware documentation](/docs/4.x/getting-started/routing#route-middleware).
+::
+
+::tip{icon="i-lucide-video" to="https://vueschool.io/lessons/adding-route-rules-and-route-middlewares?friend=nuxt" target="_blank"}
+Watch Vue School video about adding route rules and route middelwares.
+::
+
+### Usage
+
+::code-group
+
+```ts twoslash [module.ts]
+import { addRouteMiddleware, createResolver, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup () {
+ const { resolve } = createResolver(import.meta.url)
+
+ addRouteMiddleware({
+ name: 'auth',
+ path: resolve('runtime/auth'),
+ global: true,
+ }, { prepend: true })
+ },
+})
+```
+
+```ts twoslash [runtime/auth.ts]
+function isAuthenticated (): boolean { return false }
+// ---cut---
+export default defineNuxtRouteMiddleware((to, from) => {
+ // isAuthenticated() is an example method verifying if a user is authenticated
+ if (to.path !== '/login' && isAuthenticated() === false) {
+ return navigateTo('/login')
+ }
+})
+```
+
+::
+
+### Type
+
+```ts
+function addRouteMiddleware (input: NuxtMiddleware | NuxtMiddleware[], options?: AddRouteMiddlewareOptions): void
+```
+
+### Parameters
+
+**input**: A middleware object or an array of middleware objects with the following properties:
+
+| Property | Type | Required | Description |
+| -------- | --------- | -------- | --------------------------------------------------- |
+| `name` | `string` | `true` | The name of the middleware. |
+| `path` | `string` | `true` | The file path to the middleware. |
+| `global` | `boolean` | `false` | If set to `true`, applies middleware to all routes. |
+
+**options**: An object with the following properties:
+
+| Property | Type | Default | Description |
+| ---------- | --------- | ------- | ----------------------------------------------------------- |
+| `override` | `boolean` | `false` | If `true`, replaces middleware with the same name. |
+| `prepend` | `boolean` | `false` | If `true`, prepends middleware before existing middlewares. |
diff --git a/docs/4.api/5.kit/8.layout.md b/docs/4.api/5.kit/8.layout.md
new file mode 100644
index 000000000000..7259c37d91b9
--- /dev/null
+++ b/docs/4.api/5.kit/8.layout.md
@@ -0,0 +1,99 @@
+---
+title: "Layout"
+description: "Nuxt Kit provides a set of utilities to help you work with layouts."
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/kit/src/layout.ts
+ size: xs
+---
+
+Layouts is used to be a wrapper around your pages. It can be used to wrap your pages with common components, for example, a header and a footer. Layouts can be registered using `addLayout` utility.
+
+## `addLayout`
+
+Register template as layout and add it to the layouts.
+
+::note
+In Nuxt 2 `error` layout can also be registered using this utility. In Nuxt 3+ `error` layout [replaced](/docs/4.x/getting-started/error-handling#error-page) with `error.vue` page in project root.
+::
+
+### Usage
+
+```ts twoslash
+import { addLayout, createResolver, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup () {
+ const { resolve } = createResolver(import.meta.url)
+
+ addLayout({
+ src: resolve('templates/custom-layout.ts'),
+ filename: 'custom-layout.ts',
+ }, 'custom')
+ },
+})
+```
+
+### Type
+
+```ts
+function addLayout (layout: NuxtTemplate | string, name: string): void
+```
+
+### Parameters
+
+**`layout`**: A template object or a string with the path to the template. If a string is provided, it will be converted to a template object with `src` set to the string value. If a template object is provided, it must have the following properties:
+
+| Property | Type | Required | Description |
+| ------------- | ------------------------------------------------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `src` | `string` | `false` | Path to the template. If `src` is not provided, `getContents` must be provided instead. |
+| `filename` | `string` | `false` | Filename of the template. If `filename` is not provided, it will be generated from the `src` path. In this case, the `src` option is required. |
+| `dst` | `string` | `false` | Path to the destination file. If `dst` is not provided, it will be generated from the `filename` path and nuxt `buildDir` option. |
+| `options` | `Record<string, any>`{lang="ts"} | `false` | Options to pass to the template. |
+| `getContents` | `(data) => string \| Promise<string>`{lang="ts"} | `false` | A function that will be called with the `options` object. It should return a string or a promise that resolves to a string. If `src` is provided, this function will be ignored. |
+| `write` | `boolean` | `false` | If set to `true`, the template will be written to the destination file. Otherwise, the template will be used only in virtual filesystem. |
+
+**`name`**: The name to register the layout under (e.g., `default`, `custom`, etc.).
+
+### Example
+
+This will register a layout named `custom` that wraps pages with a header and footer.
+
+```ts twoslash
+import { addLayout, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup () {
+ addLayout({
+ write: true,
+ filename: 'my-layout.vue',
+ getContents: () => `<template>
+ <div>
+ <header>My Header</header>
+ <slot />
+ <footer>My Footer</footer>
+ </div>
+</template>`,
+ }, 'custom')
+ },
+})
+```
+
+You can then use this layout in your pages:
+
+```vue [app/pages/about.vue]
+<script setup lang="ts">
+definePageMeta({
+ layout: 'custom',
+})
+</script>
+
+<template>
+ <div>About Page</div>
+</template>
+```
+
+::warning
+Due to the lack of support for virtual `.vue` files by `@vitejs/plugin-vue`, you can work around this limitation by passing `write: true` to the first argument of `addLayout`.
+::
diff --git a/docs/4.api/5.kit/9.head.md b/docs/4.api/5.kit/9.head.md
new file mode 100644
index 000000000000..746a53d8c4e2
--- /dev/null
+++ b/docs/4.api/5.kit/9.head.md
@@ -0,0 +1,132 @@
+---
+title: Head
+description: Nuxt Kit provides utilities to help you manage head configuration in modules.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/kit/src/head.ts
+ size: xs
+---
+
+## `setGlobalHead`
+
+Sets global head configuration for your Nuxt application. This utility allows modules to programmatically configure meta tags, links, scripts, and other head elements that will be applied across all pages.
+
+The provided head configuration will be merged with any existing head configuration using deep merging, with your provided values taking precedence.
+
+::tip
+This is particularly useful for modules that need to inject global meta tags, stylesheets, or scripts into the application head.
+::
+
+### Type
+
+```ts twoslash
+// @errors: 2391
+// ---cut---
+import type { SerializableHead } from '@unhead/vue/types'
+
+interface AppHeadMetaObject extends SerializableHead {
+ charset?: string
+ viewport?: string
+}
+
+function setGlobalHead (head: AppHeadMetaObject): void
+```
+
+### Parameters
+
+#### `head`
+
+**Type**: `AppHeadMetaObject`
+
+An object containing head configuration. All properties are optional and will be merged with existing configuration:
+
+- `charset`: Character encoding for the document
+- `viewport`: Viewport meta tag configuration
+- `meta`: Array of meta tag objects
+- `link`: Array of link tag objects (stylesheets, icons, etc.)
+- `style`: Array of inline style tag objects
+- `script`: Array of script tag objects
+- `noscript`: Array of noscript tag objects
+- `title`: Default page title
+- `titleTemplate`: Template for formatting page titles
+- `bodyAttrs`: Attributes to add to the `<body>` tag
+- `htmlAttrs`: Attributes to add to the `<html>` tag
+
+### Examples
+
+#### Adding Global Meta Tags
+
+```ts
+import { defineNuxtModule, setGlobalHead } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup () {
+ setGlobalHead({
+ meta: [
+ { name: 'theme-color', content: '#ffffff' },
+ { name: 'author', content: 'Your Name' },
+ ],
+ })
+ },
+})
+```
+
+#### Injecting Global Stylesheets
+
+```ts
+import { defineNuxtModule, setGlobalHead } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup () {
+ setGlobalHead({
+ link: [
+ {
+ rel: 'stylesheet',
+ href: 'https://fonts.googleapis.com/css2?family=Inter:wght@400;700&display=swap',
+ },
+ ],
+ })
+ },
+})
+```
+
+#### Adding Global Scripts
+
+```ts
+import { defineNuxtModule, setGlobalHead } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup () {
+ setGlobalHead({
+ script: [
+ {
+ src: 'https://cdn.example.com/analytics.js',
+ async: true,
+ defer: true,
+ },
+ ],
+ })
+ },
+})
+```
+
+#### Setting HTML Attributes
+
+```ts
+import { defineNuxtModule, setGlobalHead } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup () {
+ setGlobalHead({
+ htmlAttrs: {
+ lang: 'en',
+ dir: 'ltr',
+ },
+ bodyAttrs: {
+ class: 'custom-body-class',
+ },
+ })
+ },
+})
+```
diff --git a/docs/4.api/5.kit/9.plugins.md b/docs/4.api/5.kit/9.plugins.md
new file mode 100644
index 000000000000..b0b51fcae3b3
--- /dev/null
+++ b/docs/4.api/5.kit/9.plugins.md
@@ -0,0 +1,217 @@
+---
+title: Plugins
+description: Nuxt Kit provides a set of utilities to help you create and use plugins. You can add plugins or plugin templates to your module using these functions.
+links:
+ - label: Source
+ icon: i-simple-icons-github
+ to: https://github.com/nuxt/nuxt/blob/main/packages/kit/src/plugin.ts
+ size: xs
+---
+
+Plugins are self-contained code that usually add app-level functionality to Vue. In Nuxt, plugins are automatically imported from the `app/plugins/` directory. However, if you need to ship a plugin with your module, Nuxt Kit provides the `addPlugin` and `addPluginTemplate` methods. These utils allow you to customize the plugin configuration to better suit your needs.
+
+## `addPlugin`
+
+Registers a Nuxt plugin and adds it to the plugins array.
+
+::tip{icon="i-lucide-video" to="https://vueschool.io/lessons/injecting-plugins?friend=nuxt" target="_blank"}
+Watch Vue School video about `addPlugin`.
+::
+
+### Usage
+
+```ts twoslash
+import { addPlugin, createResolver, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup () {
+ const { resolve } = createResolver(import.meta.url)
+
+ addPlugin({
+ src: resolve('runtime/plugin.js'),
+ mode: 'client',
+ })
+ },
+})
+```
+
+### Type
+
+```ts
+function addPlugin (plugin: NuxtPlugin | string, options?: AddPluginOptions): NuxtPlugin
+```
+
+### Parameters
+
+**`plugin`**: A plugin object or a string with the path to the plugin. If a string is provided, it will be converted to a plugin object with `src` set to the string value.
+
+If a plugin object is provided, it must have the following properties:
+
+| Property | Type | Required | Description |
+| -------- | ------------------------------------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `src` | `string` | `true` | Path to the plugin file. |
+| `mode` | `'all' \| 'server' \| 'client'`{lang="ts"} | `false` | If set to `'all'`, the plugin will be included in both client and server bundles. If set to `'server'`, the plugin will only be included in the server bundle. If set to `'client'`, the plugin will only be included in the client bundle. You can also use `.client` and `.server` modifiers when specifying `src` option to use plugin only in client or server side. |
+| `order` | `number` | `false` | Order of the plugin. This allows more granular control over plugin order and should only be used by advanced users. Lower numbers run first, and user plugins default to `0`. It's recommended to set `order` to a number between `-20` for `pre`-plugins (plugins that run before Nuxt plugins) and `20` for `post`-plugins (plugins that run after Nuxt plugins). |
+
+::warning
+Avoid using `order` unless necessary. Use `append` if you simply need to register plugins after Nuxt defaults.
+::
+
+**`options`**: Optional object with the following properties:
+
+| Property | Type | Required | Description |
+| -------- | --------- | -------- | ------------------------------------------------------------------------------------------------------------------- |
+| `append` | `boolean` | `false` | If `true`, the plugin will be appended to the plugins array. If `false`, it will be prepended. Defaults to `false`. |
+
+### Examples
+
+::code-group
+
+```ts [module.ts]
+import { addPlugin, createResolver, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup () {
+ const { resolve } = createResolver(import.meta.url)
+
+ addPlugin({
+ src: resolve('runtime/plugin.js'),
+ mode: 'client',
+ })
+ },
+})
+```
+
+```ts [runtime/plugin.ts]
+export default defineNuxtPlugin((nuxtApp) => {
+ const colorMode = useColorMode()
+
+ nuxtApp.hook('app:mounted', () => {
+ if (colorMode.preference !== 'dark') {
+ colorMode.preference = 'dark'
+ }
+ })
+})
+```
+
+::
+
+## `addPluginTemplate`
+
+Adds a template and registers as a nuxt plugin. This is useful for plugins that need to generate code at build time.
+
+::tip{icon="i-lucide-video" to="https://vueschool.io/lessons/injecting-plugin-templates?friend=nuxt" target="_blank"}
+Watch Vue School video about `addPluginTemplate`.
+::
+
+### Usage
+
+```ts twoslash
+import { addPluginTemplate, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup (options) {
+ addPluginTemplate({
+ filename: 'module-plugin.mjs',
+ getContents: () => `import { defineNuxtPlugin } from '#app/nuxt'
+export default defineNuxtPlugin({
+ name: 'module-plugin',
+ setup (nuxtApp) {
+ ${options.log ? 'console.log("Plugin install")' : ''}
+ }
+})`,
+ })
+ },
+})
+```
+
+### Type
+
+```ts
+function addPluginTemplate (pluginOptions: NuxtPluginTemplate, options?: AddPluginOptions): NuxtPlugin
+```
+
+### Parameters
+
+**`pluginOptions`**: A plugin template object with the following properties:
+
+| Property | Type | Required | Description |
+| ------------- | --------------------------------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `src` | `string` | `false` | Path to the template. If `src` is not provided, `getContents` must be provided instead. |
+| `filename` | `string` | `false` | Filename of the template. If `filename` is not provided, it will be generated from the `src` path. In this case, the `src` option is required. |
+| `dst` | `string` | `false` | Path to the destination file. If `dst` is not provided, it will be generated from the `filename` path and nuxt `buildDir` option. |
+| `mode` | `'all' \| 'server' \| 'client'`{lang="ts"} | `false` | If set to `'all'`, the plugin will be included in both client and server bundles. If set to `'server'`, the plugin will only be included in the server bundle. If set to `'client'`, the plugin will only be included in the client bundle. You can also use `.client` and `.server` modifiers when specifying `src` option to use plugin only in client or server side. |
+| `options` | `Record<string, any>`{lang="ts"} | `false` | Options to pass to the template. |
+| `getContents` | `(data: Record<string, any>) => string \| Promise<string>`{lang="ts"} | `false` | A function that will be called with the `options` object. It should return a string or a promise that resolves to a string. If `src` is provided, this function will be ignored. |
+| `write` | `boolean` | `false` | If set to `true`, the template will be written to the destination file. Otherwise, the template will be used only in virtual filesystem. |
+| `order` | `number` | `false` | Order of the plugin. This allows more granular control over plugin order and should only be used by advanced users. Lower numbers run first, and user plugins default to `0`. It's recommended to set `order` to a number between `-20` for `pre`-plugins (plugins that run before Nuxt plugins) and `20` for `post`-plugins (plugins that run after Nuxt plugins). |
+
+::warning
+Prefer using `getContents` for dynamic plugin generation. Avoid setting `order` unless necessary.
+::
+
+**`options`**: Optional object with the following properties:
+
+| Property | Type | Required | Description |
+| -------- | --------- | -------- | ------------------------------------------------------------------------------------------------------------------- |
+| `append` | `boolean` | `false` | If `true`, the plugin will be appended to the plugins array. If `false`, it will be prepended. Defaults to `false`. |
+
+### Examples
+
+#### Generate a plugin template with different options
+
+Use `addPluginTemplate` when you need to generate plugin code dynamically at build time. This allows you to generate different plugin contents based on the options passed to it. For example, Nuxt internally uses this function to generate Vue app configurations.
+
+```ts twoslash [module.ts]
+import { addPluginTemplate, defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ setup (_, nuxt) {
+ if (nuxt.options.vue.config && Object.values(nuxt.options.vue.config).some(v => v !== null && v !== undefined)) {
+ addPluginTemplate({
+ filename: 'vue-app-config.mjs',
+ write: true,
+ getContents: () => `import { defineNuxtPlugin } from '#app/nuxt'
+export default defineNuxtPlugin({
+ name: 'nuxt:vue-app-config',
+ enforce: 'pre',
+ setup (nuxtApp) {
+ ${Object.keys(nuxt.options.vue.config!)
+ .map(k => `nuxtApp.vueApp.config[${JSON.stringify(k)}] = ${JSON.stringify(nuxt.options.vue.config![k as 'idPrefix'])}`)
+ .join('\n')
+ }
+ }
+})`,
+ })
+ }
+ },
+})
+```
+
+This generates different plugin code depending on the provided configuration.
+
+::code-group
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+ vue: {
+ config: {
+ idPrefix: 'nuxt',
+ },
+ },
+})
+```
+
+```ts [#build/vue-app-config.mjs]
+import { defineNuxtPlugin } from '#app/nuxt'
+
+export default defineNuxtPlugin({
+ name: 'nuxt:vue-app-config',
+ enforce: 'pre',
+ setup (nuxtApp) {
+ nuxtApp.vueApp.config.idPrefix = 'nuxt'
+ },
+})
+```
+
+::
diff --git a/docs/4.api/6.advanced/.navigation.yml b/docs/4.api/6.advanced/.navigation.yml
new file mode 100644
index 000000000000..2426d6f7db21
--- /dev/null
+++ b/docs/4.api/6.advanced/.navigation.yml
@@ -0,0 +1 @@
+icon: i-lucide-brain
diff --git a/docs/4.api/6.advanced/1.hooks.md b/docs/4.api/6.advanced/1.hooks.md
new file mode 100644
index 000000000000..df870ee6ce8d
--- /dev/null
+++ b/docs/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 a route navigation begins (before resolution) or when the page key changes. May fire without the page component's `setup()` re-running if the page is reused (e.g. with a static `key` in `definePageMeta`). |
+| `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). The `transition` argument is a [`ViewTransition`](https://developer.mozilla.org/en-US/docs/Web/API/ViewTransition) object with a `types` property ([`ViewTransitionTypeSet`](https://developer.mozilla.org/en-US/docs/Web/API/ViewTransitionTypeSet)) that can be read or modified. |
+
+## 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 |
diff --git a/docs/4.api/6.advanced/2.import-meta.md b/docs/4.api/6.advanced/2.import-meta.md
new file mode 100644
index 000000000000..b63e8eb5a838
--- /dev/null
+++ b/docs/4.api/6.advanced/2.import-meta.md
@@ -0,0 +1,61 @@
+---
+title: 'Import meta'
+description: Understand where your code is running using `import.meta`.
+---
+
+## The `import.meta` object
+
+With ES modules you can obtain some metadata from the code that imports or compiles your ES-module.
+This is done through `import.meta`, which is an object that provides your code with this information.
+Throughout the Nuxt documentation you may see snippets that use this already to figure out whether the
+code is currently running on the client or server side.
+
+::read-more{to="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/import.meta"}
+Read more about `import.meta`.
+::
+
+## Runtime (App) Properties
+
+These values are statically injected and can be used for tree-shaking your runtime code.
+
+Property | Type | Description
+--- | --- | ---
+`import.meta.client` | boolean | True when evaluated on the client side.
+`import.meta.browser` | boolean | True when evaluated on the client side.
+`import.meta.server` | boolean | True when evaluated on the server side.
+`import.meta.nitro` | boolean | True when evaluated on the server side.
+`import.meta.dev` | boolean | True when running the Nuxt dev server.
+`import.meta.envName` | string | The current Nuxt environment name, including custom values passed via `--envName`.
+`import.meta.test` | boolean | True when running in a test context.
+`import.meta.prerender` | boolean | True when rendering HTML on the server in the prerender stage of your build.
+
+## Builder Properties
+
+These values are available both in modules and in your `nuxt.config`.
+
+Property | Type | Description
+--- | --- | ---
+`import.meta.env` | object | Equals `process.env`
+`import.meta.url` | string | Resolvable path for the current file.
+
+## Examples
+
+### Using `import.meta.url` to resolve files within modules
+
+```ts [modules/my-module/index.ts]
+import { createResolver } from 'nuxt/kit'
+
+// Resolve relative from the current file
+const resolver = createResolver(import.meta.url)
+
+export default defineNuxtModule({
+ meta: { name: 'myModule' },
+ setup () {
+ addComponent({
+ name: 'MyModuleComponent',
+ // Resolves to '/modules/my-module/components/MyModuleComponent.vue'
+ filePath: resolver.resolve('./components/MyModuleComponent.vue'),
+ })
+ },
+})
+```
diff --git a/docs/4.api/6.nuxt-config.md b/docs/4.api/6.nuxt-config.md
new file mode 100644
index 000000000000..be69773ee93e
--- /dev/null
+++ b/docs/4.api/6.nuxt-config.md
@@ -0,0 +1,2476 @@
+---
+title: Nuxt Configuration
+titleTemplate: '%s'
+description: Discover all the options you can use in your nuxt.config.ts file.
+navigation.icon: i-lucide-cog
+---
+
+## alias
+
+You can improve your DX by defining additional aliases to access custom directories within your JavaScript and CSS.
+
+- **Type**: `object`
+- **Default**
+```json
+{
+ "~": "/<rootDir>/app",
+ "@": "/<rootDir>/app",
+ "~~": "/<rootDir>",
+ "@@": "/<rootDir>",
+ "#shared": "/<rootDir>/shared",
+ "#server": "/<rootDir>/server",
+ "assets": "/<rootDir>/app/assets",
+ "public": "/<rootDir>/public",
+ "#build": "/<rootDir>/.nuxt",
+ "#internal/nuxt/paths": "/<rootDir>/.nuxt/paths.mjs"
+}
+```
+
+::callout
+**Note**: Within a webpack context (image sources, CSS - but not JavaScript) you _must_ access
+your alias by prefixing it with `~`.
+::
+
+::callout
+<!-- @case-police-ignore tsConfig -->
+**Note**: These aliases will be automatically added to the generated TypeScript configurations (`.nuxt/tsconfig.app.json`, `.nuxt/tsconfig.server.json`, etc.) so you can get full type support and path auto-complete. In case you need to extend options provided by the generated configurations further, make sure to add them here or within the `typescript.tsConfig` property in `nuxt.config`.
+::
+
+**Example**:
+```ts
+import { fileURLToPath } from 'node:url'
+
+export default defineNuxtConfig({
+ alias: {
+ 'images': fileURLToPath(new URL('./assets/images', import.meta.url)),
+ 'style': fileURLToPath(new URL('./assets/style', import.meta.url)),
+ 'data': fileURLToPath(new URL('./assets/other/data', import.meta.url)),
+ },
+})
+```
+
+```html
+<template>
+ <img src="~images/main-bg.jpg">
+</template>
+
+<script>
+import data from 'data/test.json'
+</script>
+
+<style>
+// Uncomment the below
+//@import '~style/variables.scss';
+//@import '~style/utils.scss';
+//@import '~style/base.scss';
+body {
+ background-image: url('~images/main-bg.jpg');
+}
+</style>
+```
+
+## analyzeDir
+
+The directory where Nuxt will store the generated files when running `nuxt analyze`.
+
+If a relative path is specified, it will be relative to your `rootDir`.
+
+- **Type**: `string`
+- **Default:** `"/<rootDir>/.nuxt/analyze"`
+
+## app
+
+Nuxt App configuration.
+
+### `baseURL`
+
+The base path of your Nuxt application.
+
+For example:
+
+- **Type**: `string`
+- **Default:** `"/"`
+
+**Example**:
+```ts
+export default defineNuxtConfig({
+ app: {
+ baseURL: '/prefix/',
+ },
+})
+```
+
+This can also be set at runtime by setting the NUXT_APP_BASE_URL environment variable.
+
+**Example**:
+```bash
+NUXT_APP_BASE_URL=/prefix/ node .output/server/index.mjs
+```
+
+### `buildAssetsDir`
+
+The folder name for the built site assets, relative to `baseURL` (or `cdnURL` if set). This is set at build time and should not be customized at runtime.
+
+- **Type**: `string`
+- **Default:** `"/_nuxt/"`
+
+### `cdnURL`
+
+An absolute URL to serve the public folder from (production-only).
+
+For example:
+
+- **Type**: `string`
+- **Default:** `""`
+
+**Example**:
+```ts
+export default defineNuxtConfig({
+ app: {
+ cdnURL: 'https://mycdn.org/',
+ },
+})
+```
+
+This can be set to a different value at runtime by setting the `NUXT_APP_CDN_URL` environment variable.
+
+**Example**:
+```bash
+NUXT_APP_CDN_URL=https://mycdn.org/ node .output/server/index.mjs
+```
+
+### `head`
+
+Set default configuration for `<head>` on every page.
+
+- **Type**: `object`
+- **Default**
+```json
+{
+ "meta": [
+ {
+ "name": "viewport",
+ "content": "width=device-width, initial-scale=1"
+ },
+ {
+ "charset": "utf-8"
+ }
+ ],
+ "link": [],
+ "style": [],
+ "script": [],
+ "noscript": []
+}
+```
+
+**Example**:
+```ts
+export default defineNuxtConfig({
+ app: {
+ head: {
+ meta: [
+ // <meta name="viewport" content="width=device-width, initial-scale=1">
+ { name: 'viewport', content: 'width=device-width, initial-scale=1' },
+ ],
+ script: [
+ // <script src="https://myawesome-lib.js"></script>
+ { src: 'https://awesome-lib.js' },
+ ],
+ link: [
+ // <link rel="stylesheet" href="https://myawesome-lib.css">
+ { rel: 'stylesheet', href: 'https://awesome-lib.css' },
+ ],
+ // please note that this is an area that is likely to change
+ style: [
+ // <style>:root { color: red }</style>
+ { textContent: ':root { color: red }' },
+ ],
+ noscript: [
+ // <noscript>JavaScript is required</noscript>
+ { textContent: 'JavaScript is required' },
+ ],
+ },
+ },
+})
+```
+
+### `keepalive`
+
+Default values for KeepAlive configuration between pages.
+
+This can be overridden with `definePageMeta` on an individual page. Only JSON-serializable values are allowed.
+
+- **Type**: `boolean`
+- **Default:** `false`
+
+**See**: [Vue KeepAlive](https://vuejs.org/api/built-in-components#keepalive)
+
+### `layoutTransition`
+
+Default values for layout transitions.
+
+This can be overridden with `definePageMeta` on an individual page. Only JSON-serializable values are allowed.
+
+- **Type**: `boolean | TransitionProps`
+- **Default:** `false`
+
+**See**: [Vue Transition docs](https://vuejs.org/api/built-in-components#transition)
+
+### `pageTransition`
+
+Default values for page transitions.
+
+This can be overridden with `definePageMeta` on an individual page. Only JSON-serializable values are allowed.
+
+- **Type**: `boolean | TransitionProps`
+- **Default:** `false`
+
+**See**: [Vue Transition docs](https://vuejs.org/api/built-in-components#transition)
+
+### `rootAttrs`
+
+Customize Nuxt root element id.
+
+- **Type**: `object`
+- **Default**
+```json
+{
+ "id": "__nuxt"
+}
+```
+
+### `rootId`
+
+Customize Nuxt root element id.
+
+- **Type**: `string`
+- **Default:** `"__nuxt"`
+
+### `rootTag`
+
+Customize Nuxt root element tag.
+
+- **Type**: `string`
+- **Default:** `"div"`
+
+### `spaLoaderAttrs`
+
+Customize Nuxt SPA loading template element attributes.
+
+- **Type**: `object`
+- **Default:**
+```json
+{
+"id": "__nuxt-loader"
+}
+```
+
+#### `id`
+
+- **Type**: `string`
+- **Default:** `"__nuxt-loader"`
+
+### `spaLoaderTag`
+
+Customize Nuxt SpaLoader element tag.
+
+- **Type**: `string`
+- **Default:** `"div"`
+
+### `teleportAttrs`
+
+Customize Nuxt Teleport element attributes.
+
+- **Type**: `object`
+- **Default**
+```json
+{
+ "id": "teleports"
+}
+```
+
+### `teleportId`
+
+Customize Nuxt Teleport element id.
+
+- **Type**: `string`
+- **Default:** `"teleports"`
+
+### `teleportTag`
+
+Customize Nuxt Teleport element tag.
+
+- **Type**: `string`
+- **Default:** `"div"`
+
+### `viewTransition`
+
+Default values for view transitions.
+
+This only has an effect when **experimental** support for View Transitions is [enabled in your nuxt.config file](/docs/4.x/getting-started/transitions#view-transitions-api-experimental).
+This can be overridden with `definePageMeta` on an individual page.
+
+- **Type**: `boolean`
+- **Default:** `false`
+
+**See**: [Nuxt View Transition API docs](https://nuxt.com/docs/4.x/getting-started/transitions#view-transitions-api-experimental)
+
+## appConfig
+
+Additional app configuration
+
+For programmatic usage and type support, you can directly provide app config with this option. It will be merged with `app.config` file as default value.
+
+### `nuxt`
+
+## appId
+
+For multi-app projects, the unique id of the Nuxt application.
+
+Defaults to `nuxt-app`.
+
+- **Type**: `string`
+- **Default:** `"nuxt-app"`
+
+## build
+
+Shared build configuration.
+
+### `analyze`
+
+Nuxt allows visualizing your bundles and how to optimize them.
+
+Set to `true` to enable bundle analysis, or pass an object with options: [for webpack](https://github.com/webpack/webpack-bundle-analyzer#options-for-plugin) or [for vite](https://github.com/btd/rollup-plugin-visualizer#options).
+
+- **Type**: `object`
+- **Default**
+```json
+{
+ "template": "treemap",
+ "projectRoot": "/<rootDir>",
+ "filename": "/<rootDir>/.nuxt/analyze/{name}.html"
+}
+```
+
+**Example**:
+```ts
+export default defineNuxtConfig({
+ analyze: {
+ analyzerMode: 'static',
+ },
+})
+```
+
+### `templates`
+
+It is recommended to use `addTemplate` from `@nuxt/kit` instead of this option.
+
+- **Type**: `array`
+
+**Example**:
+```ts
+export default defineNuxtConfig({
+ build: {
+ templates: [
+ {
+ src: '~~/modules/support/plugin.js', // `src` can be absolute or relative
+ dst: 'support.js', // `dst` is relative to project `.nuxt` dir
+ },
+ ],
+ },
+})
+```
+
+### `transpile`
+
+If you want to transpile specific dependencies with Babel, you can add them here. Each item in transpile can be a package name, a function, a string or regex object matching the dependency's file name.
+
+You can also use a function to conditionally transpile. The function will receive an object ({ isDev, isServer, isClient, isModern, isLegacy }).
+
+- **Type**: `array`
+
+**Example**:
+```ts
+export default defineNuxtConfig({
+ build: {
+ transpile: [({ isLegacy }) => isLegacy && 'ky'],
+ },
+})
+```
+
+## buildDir
+
+Define the directory where your built Nuxt files will be placed.
+
+Many tools assume that `.nuxt` is a hidden directory (because it starts with a `.`). If that is a problem, you can use this option to prevent that.
+
+- **Type**: `string`
+- **Default:** `"/<rootDir>/.nuxt"`
+
+**Example**:
+```ts
+export default defineNuxtConfig({
+ buildDir: 'nuxt-build',
+})
+```
+
+## buildId
+
+A unique identifier matching the build. This may contain the hash of the current state of the project.
+
+- **Type**: `string`
+- **Default:** `"4a2e2d30-418f-41df-8e58-ed5df06de7fd"`
+
+## builder
+
+The builder to use for bundling the Vue part of your application.
+
+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.
+
+This is used to control the behavior of presets in Nitro, Nuxt Image and other modules that may change behavior without a major version bump.
+We plan to improve the tooling around this feature in the future.
+
+## components
+
+Configure Nuxt component auto-registration.
+
+Any components in the directories configured here can be used throughout your pages, layouts (and other components) without needing to explicitly import them.
+
+- **Type**: `object`
+- **Default**
+```json
+{
+ "dirs": [
+ {
+ "path": "~/components/global",
+ "global": true
+ },
+ "~/components"
+ ]
+}
+```
+
+**See**: [`app/components/` directory documentation](https://nuxt.com/docs/4.x/directory-structure/app/components)
+
+## css
+
+You can define the CSS files/modules/libraries you want to set globally (included in every page).
+
+Nuxt will automatically guess the file type by its extension and use the appropriate pre-processor. You will still need to install the required loader if you need to use them.
+
+- **Type**: `array`
+
+**Example**:
+```ts
+export default defineNuxtConfig({
+ css: [
+ // Load a Node.js module directly (here it's a Sass file).
+ 'bulma',
+ // CSS file in the project
+ '~/assets/css/main.css',
+ // SCSS file in the project
+ '~/assets/css/main.scss',
+ ],
+})
+```
+
+## debug
+
+Set to `true` to enable debug mode.
+
+At the moment, it prints out hook names and timings on the server, and logs hook arguments as well in the browser.
+You can also set this to an object to enable specific debug options.
+
+- **Type**: `boolean`
+- **Default:** `false`
+
+## dev
+
+Whether Nuxt is running in development mode.
+
+Normally, you should not need to set this.
+
+- **Type**: `boolean`
+- **Default:** `false`
+
+## devServer
+
+### `cors`
+
+Set CORS options for the dev server
+
+#### `origin`
+
+- **Type**: `array`
+- **Default**
+```json
+[
+ {}
+]
+```
+
+### `host`
+
+Dev server listening host
+
+### `https`
+
+Whether to enable HTTPS.
+
+- **Type**: `boolean`
+- **Default:** `false`
+
+**Example**:
+```ts
+export default defineNuxtConfig({
+ devServer: {
+ https: {
+ key: './server.key',
+ cert: './server.crt',
+ },
+ },
+})
+```
+
+### `loadingTemplate`
+
+Template to show a loading screen
+
+- **Type**: `function`
+
+### `port`
+
+Dev server listening port
+
+- **Type**: `number`
+- **Default:** `3000`
+
+### `url`
+
+Listening dev server URL.
+
+This should not be set directly as it will always be overridden by the dev server with the full URL (for module and internal use).
+
+- **Type**: `string`
+- **Default:** `"http://localhost:3000"`
+
+## devServerHandlers
+
+Nitro development-only server handlers.
+
+- **Type**: `array`
+
+**See**: [Nitro server routes documentation](https://nitro.build/guide/routing)
+
+## devtools
+
+Enable Nuxt DevTools for development.
+
+Breaking changes for devtools might not reflect on the version of Nuxt.
+
+**See**: [Nuxt DevTools](https://devtools.nuxt.com/) for more information.
+
+## dir
+
+Customize default directory structure used by Nuxt.
+
+It is better to stick with defaults unless needed.
+
+### `app`
+
+- **Type**: `string`
+- **Default:** `"app"`
+
+### `assets`
+
+The assets directory (aliased as `~assets` in your build).
+
+- **Type**: `string`
+- **Default:** `"app/assets"`
+
+### `layouts`
+
+The layouts directory, each file of which will be auto-registered as a Nuxt layout.
+
+- **Type**: `string`
+- **Default:** `"app/layouts"`
+
+### `middleware`
+
+The middleware directory, each file of which will be auto-registered as a Nuxt middleware.
+
+- **Type**: `string`
+- **Default:** `"app/middleware"`
+
+### `modules`
+
+The modules directory, each file in which will be auto-registered as a Nuxt module.
+
+- **Type**: `string`
+- **Default:** `"modules"`
+
+### `pages`
+
+The directory which will be processed to auto-generate your application page routes.
+
+- **Type**: `string`
+- **Default:** `"app/pages"`
+
+### `plugins`
+
+The plugins directory, each file of which will be auto-registered as a Nuxt plugin.
+
+- **Type**: `string`
+- **Default:** `"app/plugins"`
+
+### `public`
+
+The directory containing your static files, which will be directly accessible via the Nuxt server and copied across into your `dist` folder when your app is generated.
+
+- **Type**: `string`
+- **Default:** `"public"`
+
+### `shared`
+
+The shared directory. This directory is shared between the app and the server.
+
+- **Type**: `string`
+- **Default:** `"shared"`
+
+## esbuild
+
+### `options`
+
+Configure shared esbuild options used within Nuxt and passed to other builders, such as Vite or webpack.
+
+#### `jsxFactory`
+
+- **Type**: `string`
+- **Default:** `"h"`
+
+#### `jsxFragment`
+
+- **Type**: `string`
+- **Default:** `"Fragment"`
+
+#### `target`
+
+- **Type**: `string`
+- **Default:** `"esnext"`
+
+#### `tsconfigRaw`
+
+- **Type**: `object`
+
+## experimental
+
+::read-more{to="/docs/4.x/guide/going-further/experimental-features"}
+Learn more about Nuxt's experimental features.
+::
+
+## extends
+
+Extend project from multiple local or remote sources.
+
+Value should be either a string or array of strings pointing to source directories or config path relative to current config.
+You can use `github:`, `gh:` `gitlab:` or `bitbucket:`
+
+**See**: [`c12` docs on extending config layers](https://github.com/unjs/c12#extending-config-layer-from-remote-sources)
+
+**See**: [`giget` documentation](https://github.com/unjs/giget)
+
+## extensions
+
+The extensions that should be resolved by the Nuxt resolver.
+
+- **Type**: `array`
+- **Default**
+```json
+[
+ ".js",
+ ".jsx",
+ ".mjs",
+ ".ts",
+ ".tsx",
+ ".vue"
+]
+```
+
+## features
+
+::read-more{to="/docs/4.x/guide/going-further/features#features"}
+Learn more about Nuxt's opt-in features.
+::
+
+## future
+
+::read-more{to="/docs/4.x/guide/going-further/features#features"}
+Learn more about opting-in to new features that will become default in a future (possibly major) version of the framework.
+::
+
+## hooks
+
+Hooks are listeners to Nuxt events that are typically used in modules, but are also available in `nuxt.config`.
+
+Internally, hooks follow a naming pattern using colons (e.g., build:done).
+For ease of configuration, you can also structure them as an hierarchical object in `nuxt.config` (as below).
+
+**Example**:
+```ts
+import fs from 'node:fs'
+import path from 'node:path'
+
+export default defineNuxtConfig({
+ hooks: {
+ build: {
+ done (builder) {
+ const extraFilePath = path.join(
+ builder.nuxt.options.buildDir,
+ 'extra-file',
+ )
+ fs.writeFileSync(extraFilePath, 'Something extra')
+ },
+ },
+ },
+})
+```
+
+## ignore
+
+More customizable than `ignorePrefix`: all files matching glob patterns specified inside the `ignore` array will be ignored in building.
+
+- **Type**: `array`
+- **Default**
+```json
+[
+ "**/*.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",
+ ".nuxt",
+ "**/-*.*"
+]
+```
+
+## ignoreOptions
+
+Pass options directly to `node-ignore` (which is used by Nuxt to ignore files).
+
+**See**: [node-ignore](https://github.com/kaelzhang/node-ignore)
+
+**Example**:
+```ts
+export default defineNuxtConfig({
+ ignoreOptions: {
+ ignorecase: false,
+ },
+})
+```
+
+## ignorePrefix
+
+Any file in `app/pages/`, `app/layouts/`, `app/middleware/`, and `public/` directories will be ignored during the build process if its filename starts with the prefix specified by `ignorePrefix`. This is intended to prevent certain files from being processed or served in the built application. By default, the `ignorePrefix` is set to '-', ignoring any files starting with '-'.
+
+- **Type**: `string`
+- **Default:** `"-"`
+
+## imports
+
+Configure how Nuxt auto-imports composables into your application.
+
+**See**: [Nuxt documentation](https://nuxt.com/docs/4.x/directory-structure/app/composables)
+
+### `dirs`
+
+An array of custom directories that will be auto-imported. Note that this option will not override the default directories (~/composables, ~/utils).
+
+- **Type**: `array`
+
+**Example**:
+```ts
+export default defineNuxtConfig({
+ imports: {
+ // Auto-import pinia stores defined in `~/stores`
+ dirs: ['stores'],
+ },
+})
+```
+
+### `global`
+
+- **Type**: `boolean`
+- **Default:** `false`
+
+### `scan`
+
+Whether to scan your `app/composables/` and `app/utils/` directories for composables to auto-import. Auto-imports registered by Nuxt or other modules, such as imports from `vue` or `nuxt`, will still be enabled.
+
+- **Type**: `boolean`
+- **Default:** `true`
+
+## logLevel
+
+Log level when building logs.
+
+Defaults to 'silent' when running in CI or when a TTY is not available. This option is then used as 'silent' in Vite and 'none' in webpack
+
+- **Type**: `string`
+- **Default:** `"info"`
+
+## modules
+
+Modules are Nuxt extensions which can extend its core functionality and add endless integrations.
+
+Each module is either a string (which can refer to a package, or be a path to a file), a tuple with the module as first string and the options as a second object, or an inline module function.
+Nuxt tries to resolve each item in the modules array using node require path (in `node_modules`) and then will be resolved from project `rootDir` if `~~` alias is used.
+
+- **Type**: `array`
+
+::callout
+**Note**: Modules are executed sequentially so the order is important. First, the modules defined in `nuxt.config.ts` are loaded. Then, modules found in the `modules/`
+directory are executed, and they load in alphabetical order.
+::
+
+**Example**:
+```ts
+export default defineNuxtConfig({
+ modules: [
+ // Using package name
+ '@nuxt/scripts',
+ // Relative to your project rootDir
+ '~~/custom-modules/awesome.js',
+ // Providing options
+ ['@nuxtjs/google-analytics', { ua: 'X1234567' }],
+ // Inline definition
+ function () {},
+ ],
+})
+```
+
+## modulesDir
+
+Used to set the modules directories for path resolving (for example, webpack's `resolveLoading`, `nodeExternals` and `postcss`).
+
+The configuration path is relative to `options.rootDir` (default is current working directory).
+Setting this field may be necessary if your project is organized as a yarn workspace-styled mono-repository.
+
+- **Type**: `array`
+- **Default**
+```json
+[
+ "/<rootDir>/node_modules"
+]
+```
+
+**Example**:
+```ts
+export default defineNuxtConfig({
+ modulesDir: ['../../node_modules'],
+})
+```
+
+## nitro
+
+Configuration for Nitro.
+
+**See**: [Nitro configuration docs](https://nitro.build/config)
+
+### `routeRules`
+
+- **Type**: `object`
+
+### `runtimeConfig`
+
+- **Type**: `object`
+- **Default**
+```json
+{
+ "public": {},
+ "app": {
+ "buildId": "4a2e2d30-418f-41df-8e58-ed5df06de7fd",
+ "baseURL": "/",
+ "buildAssetsDir": "/_nuxt/",
+ "cdnURL": ""
+ },
+ "nitro": {
+ "envPrefix": "NUXT_"
+ }
+}
+```
+
+## optimization
+
+Build time optimization configuration.
+
+### `asyncTransforms`
+
+Options passed directly to the transformer from `unctx` that preserves async context after `await`.
+
+#### `asyncFunctions`
+
+- **Type**: `array`
+- **Default**
+```json
+[
+ "defineNuxtPlugin",
+ "defineNuxtRouteMiddleware"
+]
+```
+
+#### `objectDefinitions`
+
+##### `defineNuxtComponent`
+
+- **Type**: `array`
+- **Default**
+```json
+[
+ "asyncData",
+ "setup"
+]
+```
+
+##### `defineNuxtPlugin`
+
+- **Type**: `array`
+- **Default**
+```json
+[
+ "setup"
+]
+```
+
+##### `definePageMeta`
+
+- **Type**: `array`
+- **Default**
+```json
+[
+ "middleware",
+ "validate"
+]
+```
+
+### `keyedComposables`
+
+Functions to inject a key for.
+
+As long as the number of arguments passed to the function is less than `argumentLength`, an additional magic string will be injected as the last argument. This key is stable between SSR and client-side hydration. You will need to take steps to handle this additional key.
+The key is unique based on the location of the function being invoked within the file.
+
+::read-more{to="/docs/4.x/guide/modules/recipes-basics#add-keyed-functions"}
+Learn more about keyed functions.
+::
+
+- **Type**: `array`
+- **Default**
+```json
+[
+ {
+ "name": "callOnce",
+ "argumentLength": 3,
+ "source": "#app/composables/once"
+ },
+ {
+ "name": "defineNuxtComponent",
+ "argumentLength": 2,
+ "source": "#app/composables/component"
+ },
+ {
+ "name": "useState",
+ "argumentLength": 2,
+ "source": "#app/composables/state"
+ },
+ {
+ "name": "useFetch",
+ "argumentLength": 3,
+ "source": "#app/composables/fetch"
+ },
+ {
+ "name": "useAsyncData",
+ "argumentLength": 3,
+ "source": "#app/composables/asyncData"
+ },
+ {
+ "name": "useLazyAsyncData",
+ "argumentLength": 3,
+ "source": "#app/composables/asyncData"
+ },
+ {
+ "name": "useLazyFetch",
+ "argumentLength": 3,
+ "source": "#app/composables/fetch"
+ }
+]
+```
+
+### `treeShake`
+
+Tree shake code from specific builds.
+
+#### `composables`
+
+Tree shake composables from the server or client builds.
+
+**Example**:
+```ts
+export default defineNuxtConfig({
+ optimization: {
+ treeShake: {
+ composables: {
+ client: { vue: ['onMounted'] },
+ server: { vue: ['onServerPrefetch'] },
+ },
+ },
+ },
+})
+```
+
+##### `client`
+
+- **Type**: `object`
+- **Default**
+```json
+{
+ "vue": [
+ "onRenderTracked",
+ "onRenderTriggered",
+ "onServerPrefetch"
+ ],
+ "#app": [
+ "definePayloadReducer",
+ "definePageMeta",
+ "onPrehydrate"
+ ]
+}
+```
+
+##### `server`
+
+- **Type**: `object`
+- **Default**
+```json
+{
+ "vue": [
+ "onMounted",
+ "onUpdated",
+ "onUnmounted",
+ "onBeforeMount",
+ "onBeforeUpdate",
+ "onBeforeUnmount",
+ "onRenderTracked",
+ "onRenderTriggered",
+ "onActivated",
+ "onDeactivated"
+ ],
+ "#app": [
+ "definePayloadReviver",
+ "definePageMeta"
+ ]
+}
+```
+
+## pages
+
+Whether to use the vue-router integration in Nuxt 3. If you do not provide a value it will be enabled if you have a `app/pages/` directory in your source folder.
+
+Additionally, you can provide a glob pattern or an array of patterns to scan only certain files for pages.
+
+**Example**:
+```ts
+export default defineNuxtConfig({
+ pages: {
+ pattern: ['**/*/*.vue', '!**/*.spec.*'],
+ },
+})
+```
+
+## plugins
+
+An array of nuxt app plugins.
+
+Each plugin can be a string (which can be an absolute or relative path to a file). If it ends with `.client` or `.server` then it will be automatically loaded only in the appropriate context.
+It can also be an object with `src` and `mode` keys.
+
+- **Type**: `array`
+
+::callout
+**Note**: Plugins are also auto-registered from the `~/plugins` directory
+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/directory-structure/app/plugins)
+
+**Example**:
+```ts
+export default defineNuxtConfig({
+ plugins: [
+ '~/custom-plugins/foo.client.js', // only in client side
+ '~/custom-plugins/bar.server.js', // only in server side
+ '~/custom-plugins/baz.js', // both client & server
+ { src: '~/custom-plugins/both-sides.js' },
+ { src: '~/custom-plugins/client-only.js', mode: 'client' }, // only on client side
+ { src: '~/custom-plugins/server-only.js', mode: 'server' }, // only on server side
+ ],
+})
+```
+
+## postcss
+
+### `order`
+
+A strategy for ordering PostCSS plugins.
+
+- **Type**: `function`
+
+### `plugins`
+
+Options for configuring PostCSS plugins.
+
+**See**: [PostCSS docs](https://postcss.org/)
+
+#### `autoprefixer`
+
+Plugin to parse CSS and add vendor prefixes to CSS rules.
+
+**See**: [`autoprefixer`](https://github.com/postcss/autoprefixer)
+
+#### `cssnano`
+
+- **Type**: `object`
+
+**See**: [`cssnano` configuration options](https://cssnano.github.io/cssnano/docs/config-file/#configuration-options)
+
+## rootDir
+
+Define the root directory of your application.
+
+This property can be overwritten (for example, running `nuxt ./my-app/` will set the `rootDir` to the absolute path of `./my-app/` from the current/working directory.
+It is normally not needed to configure this option.
+
+- **Type**: `string`
+- **Default:** `"/<rootDir>"`
+
+## routeRules
+
+Global route options applied to matching server routes.
+
+**Experimental**: This is an experimental feature and API may change in the future.
+
+**See**: [Nitro route rules documentation](https://nitro.build/config#routerules)
+
+## router
+
+### `options`
+
+Additional router options passed to `vue-router`. On top of the options for `vue-router`, Nuxt offers additional options to customize the router (see below).
+
+::callout
+**Note**: Only JSON serializable options should be passed by Nuxt config.
+For more control, you can use an `router.options.ts` file.
+::
+
+**See**: [Vue Router documentation](https://router.vuejs.org/api/interfaces/routeroptions)
+
+#### `hashMode`
+
+You can enable hash history in SPA mode. In this mode, router uses a hash character (#) before the actual URL that is internally passed. When enabled, the **URL is never sent to the server** and **SSR is not supported**.
+
+- **Type**: `boolean`
+- **Default:** `false`
+
+**Default**: false
+
+#### `scrollBehaviorType`
+
+Customize the scroll behavior for hash links.
+
+- **Type**: `string`
+- **Default:** `"auto"`
+
+**Default**: 'auto'
+
+## runtimeConfig
+
+Runtime config allows passing dynamic config and environment variables to the Nuxt app context.
+
+The value of this object is accessible from server only using `useRuntimeConfig`.
+It mainly should hold _private_ configuration which is not exposed on the frontend. This could include a reference to your API secret tokens.
+Anything under `public` and `app` will be exposed to the frontend as well.
+Values are automatically replaced by matching env variables at runtime, e.g. setting an environment variable `NUXT_API_KEY=my-api-key NUXT_PUBLIC_BASE_URL=/foo/` would overwrite the two values in the example below.
+
+- **Type**: `object`
+- **Default**
+```json
+{
+ "public": {},
+ "app": {
+ "buildId": "4a2e2d30-418f-41df-8e58-ed5df06de7fd",
+ "baseURL": "/",
+ "buildAssetsDir": "/_nuxt/",
+ "cdnURL": ""
+ }
+}
+```
+
+**Example**:
+```ts
+export default defineNuxtConfig({
+ runtimeConfig: {
+ apiKey: '', // Default to an empty string, automatically set at runtime using process.env.NUXT_API_KEY
+ public: {
+ baseURL: '', // Exposed to the frontend as well.
+ },
+ },
+})
+```
+
+## 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.
+
+If a relative path is specified, it will be relative to your `rootDir`.
+
+- **Type**: `string`
+- **Default:** `"/<rootDir>/server"`
+
+## serverHandlers
+
+Nitro server handlers.
+
+Each handler accepts the following options:
+- handler: The path to the file defining the handler. - route: The route under which the handler is available. This follows the conventions of [rou3](https://github.com/h3js/rou3). - method: The HTTP method of requests that should be handled. - middleware: Specifies whether it is a middleware handler. - lazy: Specifies whether to use lazy loading to import the handler.
+
+- **Type**: `array`
+
+**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.
+::
+
+**Example**:
+```ts
+export default defineNuxtConfig({
+ serverHandlers: [
+ { route: '/path/foo/**:name', handler: '#server/foohandler.ts' },
+ ],
+})
+```
+
+## sourcemap
+
+Configures whether and how sourcemaps are generated for server and/or client bundles.
+
+If set to a single boolean, that value applies to both server and client. Additionally, the `'hidden'` option is also available for both server and client.
+Available options for both client and server: - `true`: Generates sourcemaps and includes source references in the final bundle. - `false`: Does not generate any sourcemaps. - `'hidden'`: Generates sourcemaps but does not include references in the final bundle.
+
+- **Type**: `object`
+- **Default**
+```json
+{
+ "server": true,
+ "client": false
+}
+```
+
+## spaLoadingTemplate
+
+Boolean or a path to an HTML file with the contents of which will be inserted into any HTML page rendered with `ssr: false`.
+
+- If it is unset, it will use `~/spa-loading-template.html` file in one of your layers, if it exists. - If it is false, no SPA loading indicator will be loaded. - If true, Nuxt will look for `~/spa-loading-template.html` file in one of your layers, or a
+ default Nuxt image will be used.
+Some good sources for spinners are [SpinKit](https://github.com/tobiasahlin/SpinKit) or [SVG Spinners](https://icones.js.org/collection/svg-spinners).
+
+- **Default:** `null`
+
+**Example**: ~/spa-loading-template.html
+```html
+<!-- https://github.com/barelyhuman/snips/blob/dev/pages/css-loader.md -->
+<div class="loader"></div>
+<style>
+.loader {
+ display: block;
+ position: fixed;
+ z-index: 1031;
+ top: 50%;
+ left: 50%;
+ transform: translate(-50%, -50%);
+ width: 18px;
+ height: 18px;
+ box-sizing: border-box;
+ border: solid 2px transparent;
+ border-top-color: #000;
+ border-left-color: #000;
+ border-bottom-color: #efefef;
+ border-right-color: #efefef;
+ border-radius: 50%;
+ -webkit-animation: loader 400ms linear infinite;
+ animation: loader 400ms linear infinite;
+}
+
+@-webkit-keyframes loader {
+ 0% {
+ -webkit-transform: translate(-50%, -50%) rotate(0deg);
+ }
+ 100% {
+ -webkit-transform: translate(-50%, -50%) rotate(360deg);
+ }
+}
+@keyframes loader {
+ 0% {
+ transform: translate(-50%, -50%) rotate(0deg);
+ }
+ 100% {
+ transform: translate(-50%, -50%) rotate(360deg);
+ }
+}
+</style>
+```
+
+## srcDir
+
+Define the source directory of your Nuxt application.
+
+If a relative path is specified, it will be relative to the `rootDir`.
+
+- **Type**: `string`
+- **Default:** `"app"` (Nuxt 4), `"."` (Nuxt 3 with `compatibilityMode: 3`)
+
+**Example**:
+```ts
+export default defineNuxtConfig({
+ srcDir: 'app/',
+})
+```
+
+This expects the following folder structure:
+```bash
+-| app/
+---| assets/
+---| components/
+---| composables/
+---| layouts/
+---| middleware/
+---| pages/
+---| plugins/
+---| utils/
+---| app.config.ts
+---| app.vue
+---| error.vue
+-| server/
+-| shared/
+-| public/
+-| modules/
+-| layers/
+-| nuxt.config.ts
+-| package.json
+```
+
+## ssr
+
+Whether to enable rendering of HTML - either dynamically (in server mode) or at generate time. If set to `false` generated pages will have no content.
+
+- **Type**: `boolean`
+- **Default:** `true`
+
+## telemetry
+
+Manually disable nuxt telemetry.
+
+**See**: [Nuxt Telemetry](https://github.com/nuxt/telemetry) for more information.
+
+## test
+
+Whether your app is being unit tested.
+
+- **Type**: `boolean`
+- **Default:** `false`
+
+## theme
+
+Extend project from a local or remote source.
+
+Value should be a string pointing to source directory or config path relative to current config.
+You can use `github:`, `gitlab:`, `bitbucket:` or `https://` to extend from a remote git repository.
+
+- **Type**: `string`
+
+## typescript
+
+Configuration for Nuxt's TypeScript integration.
+
+### `builder`
+
+Which builder types to include for your project.
+
+By default Nuxt infers this based on your `builder` option (defaulting to 'vite') but you can either turn off builder environment types (with `false`) to handle this fully yourself, or opt for a 'shared' option.
+The 'shared' option is advised for module authors, who will want to support multiple possible builders.
+
+- **Default:** `null`
+
+### `hoist`
+
+Modules to generate deep aliases for within `compilerOptions.paths`. This does not yet support subpaths. It may be necessary when using Nuxt within a pnpm monorepo with `shamefully-hoist=false`.
+
+- **Type**: `array`
+- **Default**
+```json
+[
+ "nitro/types",
+ "nitro/runtime-config",
+ "nitro",
+ "defu",
+ "h3",
+ "consola",
+ "ofetch",
+ "@unhead/vue",
+ "@nuxt/devtools",
+ "vue",
+ "@vue/runtime-core",
+ "@vue/compiler-sfc",
+ "vue-router",
+ "vue-router/auto-routes",
+ "unplugin-vue-router/client",
+ "@nuxt/schema",
+ "nuxt"
+]
+```
+
+### `includeWorkspace`
+
+Include parent workspace in the Nuxt project. Mostly useful for themes and module authors.
+
+- **Type**: `boolean`
+- **Default:** `false`
+
+### `shim`
+
+Generate a `*.vue` shim.
+
+We recommend instead letting the [official Vue extension](https://marketplace.visualstudio.com/items?itemName=Vue.volar) generate accurate types for your components.
+Note that you may wish to set this to `true` if you are using other libraries, such as ESLint, that are unable to understand the type of `.vue` files.
+
+- **Type**: `boolean`
+- **Default:** `false`
+
+### `strict`
+
+TypeScript comes with certain checks to give you more safety and analysis of your program. Once you’ve converted your codebase to TypeScript, you can start enabling these checks for greater safety. [Read More](https://www.typescriptlang.org/docs/handbook/migrating-from-javascript.html#getting-stricter-checks)
+
+- **Type**: `boolean`
+- **Default:** `true`
+
+<!-- @case-police-ignore tsConfig -->
+
+### `tsConfig`
+
+You can extend the generated TypeScript configurations (`.nuxt/tsconfig.app.json`, `.nuxt/tsconfig.server.json`, etc.) using this option.
+
+### `typeCheck`
+
+Enable build-time type checking.
+
+If set to true, this will type check in development. You can restrict this to build-time type checking by setting it to `build`. Requires to install `typescript` and `vue-tsc` as dev dependencies.
+
+- **Type**: `boolean`
+- **Default:** `false`
+
+**See**: [Nuxt TypeScript docs](https://nuxt.com/docs/4.x/guide/concepts/typescript)
+
+## unhead
+
+An object that allows us to configure the `unhead` nuxt module.
+
+### `legacy`
+
+Enable the legacy compatibility mode for `unhead` module. This applies the following changes: - Disables Capo.js sorting - Adds the `DeprecationsPlugin`: supports `hid`, `vmid`, `children`, `body` - Adds the `PromisesPlugin`: supports promises as input
+
+- **Type**: `boolean`
+- **Default:** `false`
+
+**See**: [`unhead` migration documentation](https://unhead.unjs.io/docs/typescript/head/guides/get-started/migration)
+
+**Example**:
+```ts
+export default defineNuxtConfig({
+ unhead: {
+ legacy: true,
+ },
+})
+```
+
+### `renderSSRHeadOptions`
+
+An object that will be passed to `renderSSRHead` to customize the output.
+
+- **Type**: `object`
+- **Default**
+```json
+{
+ "omitLineBreaks": false
+}
+```
+
+**Example**:
+```ts
+export default defineNuxtConfig({
+ unhead: {
+ renderSSRHeadOptions: {
+ omitLineBreaks: true,
+ },
+ },
+})
+```
+
+## vite
+
+Configuration that will be passed directly to Vite.
+
+Top-level `vite` options are shared across both client and server environments. Use `$client` and `$server` to provide environment-specific configuration that will be merged into their respective builds.
+
+**Example**:
+```ts
+export default defineNuxtConfig({
+ vite: {
+ $client: {
+ build: {
+ rollupOptions: {
+ output: {
+ manualChunks: {
+ analytics: ['analytics-package'],
+ },
+ },
+ },
+ },
+ },
+ $server: {
+ build: {
+ sourcemap: 'inline',
+ },
+ },
+ },
+})
+```
+
+**See**: [Vite configuration docs](https://vite.dev/config/) for more information.
+Please note that not all vite options are supported in Nuxt.
+
+### `$client`
+
+Configuration that will be merged into Vite's configuration for the client (browser) build.
+
+- **Type**: `object`
+
+### `$server`
+
+Configuration that will be merged into Vite's configuration for the server build.
+
+- **Type**: `object`
+
+### `build`
+
+#### `assetsDir`
+
+- **Type**: `string`
+- **Default:** `"_nuxt/"`
+
+#### `emptyOutDir`
+
+- **Type**: `boolean`
+- **Default:** `false`
+
+### `cacheDir`
+
+- **Type**: `string`
+- **Default:** `"/<rootDir>/node_modules/.cache/vite"`
+
+### `clearScreen`
+
+- **Type**: `boolean`
+- **Default:** `true`
+
+### `define`
+
+- **Type**: `object`
+- **Default**
+```json
+{
+ "__VUE_PROD_HYDRATION_MISMATCH_DETAILS__": false,
+ "process.dev": false,
+ "import.meta.dev": false,
+ "process.test": false,
+ "import.meta.test": false
+}
+```
+
+### `esbuild`
+
+- **Type**: `object`
+- **Default**
+```json
+{
+ "target": "esnext",
+ "jsxFactory": "h",
+ "jsxFragment": "Fragment",
+ "tsconfigRaw": {}
+}
+```
+
+### `mode`
+
+- **Type**: `string`
+- **Default:** `"production"`
+
+### `optimizeDeps`
+
+#### `esbuildOptions`
+
+- **Type**: `object`
+- **Default**
+```json
+{
+ "target": "esnext",
+ "jsxFactory": "h",
+ "jsxFragment": "Fragment",
+ "tsconfigRaw": {}
+}
+```
+
+#### `exclude`
+
+- **Type**: `array`
+- **Default**
+```json
+[
+ "vue-demi"
+]
+```
+
+### `publicDir`
+
+### `resolve`
+
+#### `extensions`
+
+- **Type**: `array`
+- **Default**
+```json
+[
+ ".mjs",
+ ".js",
+ ".ts",
+ ".jsx",
+ ".tsx",
+ ".json",
+ ".vue"
+]
+```
+
+### `root`
+
+- **Type**: `string`
+- **Default:** `"/<rootDir>"`
+
+### `server`
+
+#### `fs`
+
+##### `allow`
+
+- **Type**: `array`
+- **Default**
+```json
+[
+ "/<rootDir>/.nuxt",
+ "/<rootDir>/app",
+ "/<rootDir>",
+ "/<workspaceDir>"
+]
+```
+
+### `vue`
+
+#### `features`
+
+##### `propsDestructure`
+
+- **Type**: `boolean`
+- **Default:** `true`
+
+#### `isProduction`
+
+- **Type**: `boolean`
+- **Default:** `true`
+
+#### `script`
+
+##### `hoistStatic`
+
+#### `template`
+
+##### `compilerOptions`
+
+- **Type**: `object`
+
+##### `transformAssetUrls`
+
+- **Type**: `object`
+- **Default**
+```json
+{
+ "video": [
+ "src",
+ "poster"
+ ],
+ "source": [
+ "src"
+ ],
+ "img": [
+ "src"
+ ],
+ "image": [
+ "xlink:href",
+ "href"
+ ],
+ "use": [
+ "xlink:href",
+ "href"
+ ]
+}
+```
+
+### `vueJsx`
+
+- **Type**: `object`
+- **Default**
+```json
+{
+ "isCustomElement": {
+ "$schema": {
+ "title": "",
+ "description": "",
+ "tags": []
+ }
+ }
+}
+```
+
+## vue
+
+Vue.js config
+
+### `compilerOptions`
+
+Options for the Vue compiler that will be passed at build time.
+
+**See**: [Vue documentation](https://vuejs.org/api/application#app-config-compileroptions)
+
+### `config`
+
+It is possible to pass configure the Vue app globally. Only serializable options may be set in your `nuxt.config`. All other options should be set at runtime in a Nuxt plugin.
+
+**See**: [Vue app config documentation](https://vuejs.org/api/application#app-config)
+
+### `propsDestructure`
+
+Enable reactive destructure for `defineProps`
+
+- **Type**: `boolean`
+- **Default:** `true`
+
+### `runtimeCompiler`
+
+Include Vue compiler in runtime bundle.
+
+- **Type**: `boolean`
+- **Default:** `false`
+
+### `transformAssetUrls`
+
+#### `image`
+
+- **Type**: `array`
+- **Default**
+```json
+[
+ "xlink:href",
+ "href"
+]
+```
+
+#### `img`
+
+- **Type**: `array`
+- **Default**
+```json
+[
+ "src"
+]
+```
+
+#### `source`
+
+- **Type**: `array`
+- **Default**
+```json
+[
+ "src"
+]
+```
+
+#### `use`
+
+- **Type**: `array`
+- **Default**
+```json
+[
+ "xlink:href",
+ "href"
+]
+```
+
+#### `video`
+
+- **Type**: `array`
+- **Default**
+```json
+[
+ "src",
+ "poster"
+]
+```
+
+## watch
+
+The watch property lets you define patterns that will restart the Nuxt dev server when changed.
+
+It is an array of strings or regular expressions. Strings should be either absolute paths or relative to the `srcDir` (and the `srcDir` of any layers). Regular expressions will be matched against the path relative to the project `srcDir` (and the `srcDir` of any layers).
+
+- **Type**: `array`
+
+## watchers
+
+The watchers property lets you overwrite watchers configuration in your `nuxt.config`.
+
+### `chokidar`
+
+Options to pass directly to `chokidar`.
+
+**See**: [chokidar](https://github.com/paulmillr/chokidar#api)
+
+#### `ignoreInitial`
+
+- **Type**: `boolean`
+- **Default:** `true`
+
+#### `ignorePermissionErrors`
+
+- **Type**: `boolean`
+- **Default:** `true`
+
+### `rewatchOnRawEvents`
+
+An array of event types, which, when received, will cause the watcher to restart.
+
+### `webpack`
+
+`watchOptions` to pass directly to webpack.
+
+**See**: [webpack@4 watch options](https://v4.webpack.js.org/configuration/watch/#watchoptions).
+
+#### `aggregateTimeout`
+
+- **Type**: `number`
+- **Default:** `1000`
+
+## webpack
+
+### `aggressiveCodeRemoval`
+
+Hard-replaces `typeof process`, `typeof window` and `typeof document` to tree-shake bundle.
+
+- **Type**: `boolean`
+- **Default:** `false`
+
+### `analyze`
+
+If you are using webpack, Nuxt uses `webpack-bundle-analyzer` to visualize your bundles and how to optimize them.
+
+Set to `true` to enable bundle analysis, or pass an object with options: [for webpack](https://github.com/webpack/webpack-bundle-analyzer#options-for-plugin) or [for vite](https://github.com/btd/rollup-plugin-visualizer#options).
+
+- **Type**: `object`
+- **Default**
+```json
+{
+ "template": "treemap",
+ "projectRoot": "/<rootDir>",
+ "filename": "/<rootDir>/.nuxt/analyze/{name}.html"
+}
+```
+
+**Example**:
+```ts
+export default defineNuxtConfig({
+ webpack: {
+ analyze: {
+ analyzerMode: 'static',
+ },
+ },
+})
+```
+
+### `cssSourceMap`
+
+Enables CSS source map support (defaults to `true` in development).
+
+- **Type**: `boolean`
+- **Default:** `false`
+
+### `devMiddleware`
+
+See [webpack-dev-middleware](https://github.com/webpack/webpack-dev-middleware) for available options.
+
+#### `stats`
+
+- **Type**: `string`
+- **Default:** `"none"`
+
+### `experiments`
+
+Configure [webpack experiments](https://webpack.js.org/configuration/experiments/)
+
+### `extractCSS`
+
+Enables Common CSS Extraction.
+
+Using [mini-css-extract-plugin](https://github.com/webpack/mini-css-extract-plugin) under the hood, your CSS will be extracted into separate files, usually one per component. This allows caching your CSS and JavaScript separately.
+
+- **Type**: `boolean`
+- **Default:** `true`
+
+**Example**:
+```ts
+export default defineNuxtConfig({
+ webpack: {
+ extractCSS: true,
+ // or
+ extractCSS: {
+ ignoreOrder: true,
+ },
+ },
+})
+```
+
+If you want to extract all your CSS to a single file, there is a workaround for this.
+However, note that it is not recommended to extract everything into a single file.
+Extracting into multiple CSS files is better for caching and preload isolation. It
+can also improve page performance by downloading and resolving only those resources
+that are needed.
+
+**Example**:
+```ts
+export default defineNuxtConfig({
+ webpack: {
+ extractCSS: true,
+ optimization: {
+ splitChunks: {
+ cacheGroups: {
+ styles: {
+ name: 'styles',
+ test: /\.(css|vue)$/,
+ chunks: 'all',
+ enforce: true,
+ },
+ },
+ },
+ },
+ },
+})
+```
+
+### `filenames`
+
+Customize bundle filenames.
+
+To understand a bit more about the use of manifests, take a look at [webpack documentation](https://webpack.js.org/guides/code-splitting/).
+
+::callout
+**Note**: Be careful when using non-hashed based filenames in production
+as most browsers will cache the asset and not detect the changes on first load.
+::
+
+This example changes fancy chunk names to numerical ids:
+
+**Example**:
+```ts
+export default defineNuxtConfig({
+ webpack: {
+ filenames: {
+ chunk: ({ isDev }) => (isDev ? '[name].js' : '[id].[contenthash].js'),
+ },
+ },
+})
+```
+
+#### `app`
+
+- **Type**: `function`
+
+#### `chunk`
+
+- **Type**: `function`
+
+#### `css`
+
+- **Type**: `function`
+
+#### `font`
+
+- **Type**: `function`
+
+#### `img`
+
+- **Type**: `function`
+
+#### `video`
+
+- **Type**: `function`
+
+### `friendlyErrors`
+
+Set to `false` to disable the overlay provided by [FriendlyErrorsWebpackPlugin](https://github.com/nuxt/friendly-errors-webpack-plugin).
+
+- **Type**: `boolean`
+- **Default:** `true`
+
+### `hotMiddleware`
+
+See [webpack-hot-middleware](https://github.com/webpack/webpack-hot-middleware) for available options.
+
+### `loaders`
+
+Customize the options of Nuxt's integrated webpack loaders.
+
+#### `css`
+
+See [css-loader](https://github.com/webpack/css-loader) for available options.
+
+##### `esModule`
+
+- **Type**: `boolean`
+- **Default:** `false`
+
+##### `importLoaders`
+
+- **Type**: `number`
+- **Default:** `0`
+
+##### `url`
+
+###### `filter`
+
+- **Type**: `function`
+
+#### `cssModules`
+
+See [css-loader](https://github.com/webpack/css-loader) for available options.
+
+##### `esModule`
+
+- **Type**: `boolean`
+- **Default:** `false`
+
+##### `importLoaders`
+
+- **Type**: `number`
+- **Default:** `0`
+
+##### `modules`
+
+###### `localIdentName`
+
+- **Type**: `string`
+- **Default:** `"[local]_[hash:base64:5]"`
+
+##### `url`
+
+###### `filter`
+
+- **Type**: `function`
+
+#### `esbuild`
+
+- **Type**: `object`
+- **Default**
+```json
+{
+ "target": "esnext",
+ "jsxFactory": "h",
+ "jsxFragment": "Fragment",
+ "tsconfigRaw": {}
+}
+```
+
+**See**: [esbuild loader](https://github.com/privatenumber/esbuild-loader)
+
+#### `file`
+
+**See**: [`file-loader` Options](https://github.com/webpack/file-loader#options)
+
+**Default**:
+```json
+{ "esModule": false }
+```
+
+##### `esModule`
+
+- **Type**: `boolean`
+- **Default:** `false`
+
+##### `limit`
+
+- **Type**: `number`
+- **Default:** `1000`
+
+#### `fontUrl`
+
+**See**: [`file-loader` Options](https://github.com/webpack/file-loader#options)
+
+**Default**:
+```json
+{ "esModule": false }
+```
+
+##### `esModule`
+
+- **Type**: `boolean`
+- **Default:** `false`
+
+##### `limit`
+
+- **Type**: `number`
+- **Default:** `1000`
+
+#### `imgUrl`
+
+**See**: [`file-loader` Options](https://github.com/webpack/file-loader#options)
+
+**Default**:
+```json
+{ "esModule": false }
+```
+
+##### `esModule`
+
+- **Type**: `boolean`
+- **Default:** `false`
+
+##### `limit`
+
+- **Type**: `number`
+- **Default:** `1000`
+
+#### `less`
+
+- **Default**
+```json
+{
+ "sourceMap": false
+}
+```
+
+**See**: [`less-loader` Options](https://github.com/webpack/less-loader#options)
+
+#### `pugPlain`
+
+**See**: [`pug` options](https://pugjs.org/api/reference.html#options)
+
+#### `sass`
+
+**See**: [`sass-loader` Options](https://github.com/webpack/sass-loader#options)
+
+**Default**:
+```json
+{
+ "sassOptions": {
+ "indentedSyntax": true
+ }
+}
+```
+
+##### `sassOptions`
+
+###### `indentedSyntax`
+
+- **Type**: `boolean`
+- **Default:** `true`
+
+#### `scss`
+
+- **Default**
+```json
+{
+ "sourceMap": false
+}
+```
+
+**See**: [`sass-loader` Options](https://github.com/webpack/sass-loader#options)
+
+#### `stylus`
+
+- **Default**
+```json
+{
+ "sourceMap": false
+}
+```
+
+**See**: [`stylus-loader` Options](https://github.com/webpack/stylus-loader#options)
+
+#### `vue`
+
+See [vue-loader](https://github.com/vuejs/vue-loader) for available options.
+
+##### `compilerOptions`
+
+- **Type**: `object`
+
+##### `propsDestructure`
+
+- **Type**: `boolean`
+- **Default:** `true`
+
+##### `transformAssetUrls`
+
+- **Type**: `object`
+- **Default**
+```json
+{
+ "video": [
+ "src",
+ "poster"
+ ],
+ "source": [
+ "src"
+ ],
+ "img": [
+ "src"
+ ],
+ "image": [
+ "xlink:href",
+ "href"
+ ],
+ "use": [
+ "xlink:href",
+ "href"
+ ]
+}
+```
+
+#### `vueStyle`
+
+- **Default**
+```json
+{
+ "sourceMap": false
+}
+```
+
+### `optimization`
+
+Configure [webpack optimization](https://webpack.js.org/configuration/optimization/).
+
+#### `minimize`
+
+Set minimize to `false` to disable all minimizers. (It is disabled in development by default).
+
+- **Type**: `boolean`
+- **Default:** `true`
+
+#### `minimizer`
+
+You can set minimizer to a customized array of plugins.
+
+#### `runtimeChunk`
+
+- **Type**: `string`
+- **Default:** `"single"`
+
+#### `splitChunks`
+
+##### `automaticNameDelimiter`
+
+- **Type**: `string`
+- **Default:** `"/"`
+
+##### `cacheGroups`
+
+##### `chunks`
+
+- **Type**: `string`
+- **Default:** `"all"`
+
+### `optimizeCSS`
+
+OptimizeCSSAssets plugin options.
+
+Defaults to true when `extractCSS` is enabled.
+
+- **Type**: `boolean`
+- **Default:** `false`
+
+**See**: [css-minimizer-webpack-plugin documentation](https://github.com/webpack/css-minimizer-webpack-plugin).
+
+### `plugins`
+
+Add webpack plugins.
+
+- **Type**: `array`
+
+**Example**:
+```ts
+import webpack from 'webpack'
+import { version } from './package.json'
+
+export default defineNuxtConfig({
+ webpack: {
+ plugins: [
+ // ...
+ new webpack.DefinePlugin({
+ 'process.VERSION': version,
+ }),
+ ],
+ },
+})
+```
+
+### `postcss`
+
+Customize PostCSS Loader. same options as [`postcss-loader` options](https://github.com/webpack/postcss-loader#options)
+
+#### `postcssOptions`
+
+##### `plugins`
+
+- **Type**: `object`
+- **Default**
+```json
+{
+ "autoprefixer": {},
+ "cssnano": {}
+}
+```
+
+### `profile`
+
+Enable the profiler in webpackbar.
+
+It is normally enabled by CLI argument `--profile`.
+
+- **Type**: `boolean`
+- **Default:** `false`
+
+**See**: [webpackbar](https://github.com/unjs/webpackbar#profile).
+
+### `serverURLPolyfill`
+
+The polyfill library to load to provide URL and URLSearchParams.
+
+Defaults to `'url'` ([see package](https://www.npmjs.com/package/url)).
+
+- **Type**: `string`
+- **Default:** `"url"`
+
+### `warningIgnoreFilters`
+
+Filters to hide build warnings.
+
+- **Type**: `array`
+
+## workspaceDir
+
+Define the workspace directory of your application.
+
+Often this is used when in a monorepo setup. Nuxt will attempt to detect your workspace directory automatically, but you can override it here.
+It is normally not needed to configure this option.
+
+- **Type**: `string`
+- **Default:** `"/<workspaceDir>"`
diff --git a/docs/4.api/index.md b/docs/4.api/index.md
new file mode 100644
index 000000000000..4146f81f21c5
--- /dev/null
+++ b/docs/4.api/index.md
@@ -0,0 +1,31 @@
+---
+title: 'Nuxt API Reference'
+titleTemplate: '%s'
+description: 'Explore all Nuxt Internals: Components, Composables, Utils, Commands and more.'
+navigation: false
+surround: false
+---
+
+::card-group
+ ::card{icon="i-lucide-box" title="Components" to="/docs/4.x/api/components/client-only"}
+ Explore Nuxt built-in components for pages, layouts, head, and more.
+ ::
+ ::card{icon="i-lucide-arrow-left-right" title="Composables" to="/docs/4.x/api/composables/use-app-config"}
+ Discover Nuxt composable functions for data-fetching, head management and more.
+ ::
+ ::card{icon="i-lucide-square-function" title="Utils" to="/docs/4.x/api/utils/dollarfetch"}
+ Learn about Nuxt utility functions for navigation, error handling and more.
+ ::
+ ::card{icon="i-lucide-square-terminal" title="Commands" to="/docs/4.x/api/commands/add"}
+ List of Nuxt CLI commands to init, analyze, build, and preview your application.
+ ::
+ ::card{icon="i-lucide-package" title="Nuxt Kit" to="/docs/4.x/api/kit/modules"}
+ Understand Nuxt Kit utilities to create modules and control Nuxt.
+ ::
+ ::card{icon="i-lucide-brain" title="Advanced" to="/docs/4.x/api/advanced/hooks"}
+ Go deep in Nuxt internals with Nuxt lifecycle hooks.
+ ::
+ ::card{icon="i-lucide-cog" title="Nuxt Configuration" to="/docs/4.x/api/nuxt-config"}
+ Explore all Nuxt configuration options to customize your application.
+ ::
+::
diff --git a/docs/5.community/.navigation.yml b/docs/5.community/.navigation.yml
new file mode 100644
index 000000000000..715f79a3bf83
--- /dev/null
+++ b/docs/5.community/.navigation.yml
@@ -0,0 +1,3 @@
+title: 'Community'
+titleTemplate: '%s · Nuxt Community'
+icon: i-lucide-messages-square
diff --git a/docs/5.community/2.getting-help.md b/docs/5.community/2.getting-help.md
new file mode 100644
index 000000000000..14d377370525
--- /dev/null
+++ b/docs/5.community/2.getting-help.md
@@ -0,0 +1,48 @@
+---
+title: Getting Help
+description: We're a friendly community of developers and we'd love to help.
+navigation:
+ icon: i-lucide-life-buoy
+---
+
+At some point, you may find that there's an issue you need some help with.
+
+But don't worry! We're a friendly community of developers and we'd love to help.
+
+::card-group
+ ::card{icon="i-simple-icons-discord" title="Discord" to="https://go.nuxt.com/discord" target="_blank"}
+ Get real-time help, exchange with the core team and the community, and stay updated on the latest Nuxt news.
+ ::
+ ::card{icon="i-simple-icons-nuxt" title="Nuxters" to="https://nuxters.nuxt.com" target="_blank"}
+ Connect with other Nuxt enthusiasts.
+ ::
+::
+
+## "I can't figure out how to (...)."
+
+You've read through these docs and you think it should be possible, but it's not clear how. The best thing is to [open a GitHub Discussion](https://github.com/nuxt/nuxt/discussions).
+
+Please don't feel embarrassed about asking a question that you think is easy - we've all been there! ❤️
+
+Everyone you'll encounter is helping out because they care, not because they are paid to do so. The kindest thing to do is make it easy for them to help you. Here are some ideas:
+
+- _Explain what your objective is, not just the problem you're facing._ "I need to ensure my form inputs are accessible, so I'm trying to get the ids to match between server and client."
+- _Make sure you've first read the docs and used your favorite search engine_. Let people know by saying something like "I've Googled for 'nuxt script setup' but I couldn't find code examples anywhere."
+- _Explain what you've tried._ Tell people the kind of solutions you've experimented with, and why. Often this can make people's advice more relevant to your situation.
+- _Share your code._ People probably won't be able to help if they just see an error message or a screenshot - but that all changes if you share your code in a copy/pasteable format - preferably in the form of a minimal reproduction like a CodeSandbox.
+
+And finally, just ask the question! There's no need to [ask permission to ask a question](https://dontasktoask.com) or [wait for someone to reply to your 'hello'](https://www.nohello.com). If you do, you might not get a response because people are waiting for the whole question before engaging.
+
+## "Could there be a bug?"
+
+Something isn't working the way that the docs say that it should. You're not sure if it's a bug. You've searched through the [open issues](https://github.com/nuxt/nuxt/issues) and [discussions](https://github.com/nuxt/nuxt/discussions) but you can't find anything. (if there is a closed issue, please create a new one)
+
+We recommend taking a look at [how to report bugs](/docs/4.x/community/reporting-bugs). Nuxt is still in active development, and every issue helps make it better.
+
+## "I need professional help"
+
+If the community couldn't provide the help you need in the time-frame you have, NuxtLabs offers professional support with the [Nuxt Experts](https://nuxt.com/enterprise/agencies).
+
+The objective of the Nuxt Expert is to provide support to the Vue ecosystem, while also creating freelance opportunities for those contributing to open-source solutions, thus helping to maintain the sustainability of the ecosystem.
+
+The Nuxt experts are Vue, Nuxt and Vite chosen contributors providing professional support and consulting services.
diff --git a/docs/5.community/3.reporting-bugs.md b/docs/5.community/3.reporting-bugs.md
new file mode 100644
index 000000000000..25d0325fbd8d
--- /dev/null
+++ b/docs/5.community/3.reporting-bugs.md
@@ -0,0 +1,50 @@
+---
+title: 'Reporting Bugs'
+description: 'One of the most valuable roles in open source is taking the time to report bugs helpfully.'
+navigation.icon: i-lucide-bug
+---
+
+Try as we might, we will never completely eliminate bugs.
+
+Even if you can't fix the underlying code, reporting a bug well can enable someone else with a bit more familiarity with the codebase to spot a pattern or make a quick fix.
+
+Here are a few key steps.
+
+## Is It Really a Bug?
+
+Consider if you're looking to get help with something, or whether you think there's a bug with Nuxt itself. If it's the former, we'd love to help you - but the best way to do that is through [asking for help](/docs/4.x/community/getting-help) rather than reporting a bug.
+
+## Search the Issues
+
+Search through the [open issues](https://github.com/nuxt/nuxt/issues) and [discussions](https://github.com/nuxt/nuxt/discussions) first. If you find anything that seems like the same bug, it's much better to comment on an existing thread than create a duplicate.
+
+## Create a Minimal Reproduction
+
+It's important to be able to reproduce the bug reliably - in a minimal way and apart from the rest of your project. This narrows down what could be causing the issue and makes it possible for someone not only to find the cause, but also to test a potential solution.
+
+Start with the Nuxt sandbox and add the **minimum** amount of code necessary to reproduce the bug you're experiencing.
+
+::note
+If your issue concerns Vue or Vite, please try to reproduce it first with the Vue SSR starter.
+::
+
+**Nuxt**:
+
+::card-group
+ :card{title="Nuxt on StackBlitz" icon="i-simple-icons-stackblitz" to="https://nuxt.new/s/v4" target="_blank"}
+ :card{title="Nuxt on CodeSandbox" icon="i-simple-icons-codesandbox" to="https://nuxt.new/c/v4" target="_blank"}
+::
+
+**Vue**:
+
+::card-group
+ :card{title="Vue SSR on StackBlitz" icon="i-simple-icons-stackblitz" to="https://stackblitz.com/github/nuxt-contrib/vue3-ssr-starter/tree/main?terminal=dev" target="_blank"}
+ :card{title="Vue SSR on CodeSandbox" icon="i-simple-icons-codesandbox" to="https://codesandbox.io/p/sandbox/github/nuxt-contrib/vue3-ssr-starter/main" target="_blank"}
+ :card{title="Vue SSR Template on GitHub" icon="i-simple-icons-github" to="https://github.com/nuxt-contrib/vue3-ssr-starter/generate" target="_blank"}
+::
+
+Once you've reproduced the issue, remove as much code from your reproduction as you can (while still recreating the bug). The time spent making the reproduction as minimal as possible will make a huge difference to whoever sets out to fix the issue.
+
+## Figure Out What the Cause Might Be
+
+With a Nuxt project, there are lots of moving pieces - from [Nuxt modules](/modules) to [other JavaScript libraries](https://www.npmjs.com). Try to report the bug at the most relevant and specific place. That will likely be the Nuxt module causing an issue, or the upstream library that Nuxt is depending on.
diff --git a/docs/5.community/4.contribution.md b/docs/5.community/4.contribution.md
new file mode 100644
index 000000000000..14a34212cdcf
--- /dev/null
+++ b/docs/5.community/4.contribution.md
@@ -0,0 +1,223 @@
+---
+title: 'Contribution'
+description: 'Nuxt is a community project - and so we love contributions of all kinds! ❤️'
+navigation.icon: i-lucide-git-pull-request
+---
+
+There is a range of different ways you might be able to contribute to the Nuxt ecosystem.
+
+## Ecosystem
+
+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/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
+
+### Triage Issues and Help Out in Discussions
+
+Check out the issues and discussions for the project you want to help. For example, here are [the issues board](https://github.com/nuxt/nuxt/issues) and [discussions](https://github.com/nuxt/nuxt/discussions) for Nuxt. Helping other users, sharing workarounds, creating reproductions, or even poking into a bug a little bit and sharing your findings makes a huge difference.
+
+### Creating an Issue
+
+Thank you for taking the time to create an issue! ❤️
+
+* **Reporting bugs**: Check out [our guide](/docs/4.x/community/reporting-bugs) for some things to do before opening an issue.
+
+* **Feature requests**: Check that there is not an existing issue or discussion covering the scope of the feature you have in mind. If the feature is to another part of the Nuxt ecosystem (such as a module), please consider raising a feature request there first. If the feature you have in mind is general or the API is not entirely clear, consider opening a discussion in the **Ideas** section to discuss with the community first.
+
+We'll do our best to follow our [internal issue decision making flowchart](https://mermaid.live/view#pako:eNqFlE1v2zAMhv8K4UuToslhx2Bo0TZt12Edhm7YMCAXWqJtorLk6qOpkfS_j7KdfpyWQ-BQr8mHL6nsCuU0FauiMm6rGvQRfq03FuRzvvvTYIQHthpcBT_ugQNwPHuZjheLxf4i1VDx8x4udrf5EBCOQvSsYg4ffS79KS9pmX9QALTgyid2KYB7Ih-4bmKWbDk2YB0E1gRUVaRi-FDmmjAmT3u4nB3DmoNKIUA1BsGSohA49jnVMQhHbDh_EZQUImyxh-gAtfaiG-KWSJ-N8nt6YtpCdgEeE5rXPOdav5YwWJIJU7zrvNADV9C7JBIyIC07Wxupkx3LFQ5vCkguRno5f9fP2qnUko0Y2dk9rGdvHAa9IIhVGlCp5FFNPN-ce4DKeXBd53xMliOLp9IZtyORQVsnrGm-WJzejtUu5fFqdr5FGQ3bLslYvGthjZbJTLpReZG5_lLYw7XQ_CbPVT92ws9gnEJj-v84dk-PiaXnmF1XGAaPsOsMKywNvYmG80ZohV8k4wDR9_N3KN_dHm5mh1lnkM5FsYzRfNiTvJoT5gnQsl6uxjqXLhkNQ9syHJ0UZZ8ERUIlNShr6N8gZDEliR-ow7QZa0fhY4LoHLRo-8N7ZxPwjRj5ZZYXpvOSNs9v3Jjs8NXB4ets92xan3zydXZHvj64lKMayh4-gZC1bjASW2ipLeWuzIuToiXfImu5rbucclMIc0ubYiWPGv3DptjYF9Fhiu5nb1Wxij7RSZE6jZHWjLXHtlhVaIJESXN0_m68_sO_wMs_oO9gyg) when responding to issues.
+
+### Send a Pull Request
+
+We always welcome pull requests! ❤️
+
+#### Before You Start
+
+Before you fix a bug, we recommend that you check whether **there's an issue that describes it**, as it's possible it's a documentation issue or that there is some context that would be helpful to know.
+
+If you're working on a feature, then we ask that you **open a feature request issue first** to discuss with the maintainers whether the feature is desired - and the design of those features. This helps save time for both the maintainers and the contributors and means that features can be shipped faster. The issue **should be confirmed** by a framework team member before building out a feature in a pull request.
+
+For typo fixes, it's recommended to batch multiple typo fixes into one pull request to maintain a cleaner commit history.
+
+For bigger changes to Nuxt itself, we recommend that you first [create a Nuxt module](/docs/4.x/community/contribution#create-a-module) and implement the feature there. This allows for quick proof-of-concept. You can then [create an RFC](/docs/4.x/community/contribution#make-an-rfc) in the form of a discussion. As users adopt it and you gather feedback, it can then be refined and either added to Nuxt core or continue as a standalone module.
+
+#### Commit Conventions
+
+We use [Conventional Commits](https://www.conventionalcommits.org) for commit messages, which [allows a changelog to be auto-generated](https://github.com/unjs/changelogen) based on the commits. Please read the guide through if you aren't familiar with it already.
+
+Note that `fix:` and `feat:` are for **actual code changes** (that might affect logic). For typo or document changes, use `docs:` or `chore:` instead:
+
+* ~~`fix: typo`~~ -> `docs: fix typo`
+
+If you are working in a project with a monorepo, like `nuxt/nuxt`, ensure that you specify the main scope of your commit in brackets. For example: `feat(kit): add 'addMagicStuff' utility`.
+
+#### Making the Pull Request
+
+If you don't know how to send a pull request, we recommend reading [the guide](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request).
+
+When sending a pull request, make sure your PR's title also follows the [Commit Convention](/docs/4.x/community/contribution#commit-conventions).
+
+If your PR fixes or resolves existing issues, please make sure you mention them in the PR description.
+
+It's ok to have multiple commits in a single PR; you don't need to rebase or force push for your changes as we will use `Squash and Merge` to squash the commits into one commit when merging.
+
+We do not add any commit hooks to allow for quick commits. But before you make a pull request, you should ensure that any lint/test scripts are passing.
+
+In general, please also make sure that there are no _unrelated_ changes in a PR. For example, if your editor has made any changes to whitespace or formatting elsewhere in a file that you edited, please revert these so it is more obvious what your PR changes. And please avoid including multiple unrelated features or fixes in a single PR. If it is possible to separate them, it is better to have multiple PRs to review and merge separately. In general, a PR should do _one thing only_.
+
+#### Once You've Made a Pull Request
+
+Once you've made a pull request, we'll do our best to review it promptly.
+
+If we assign it to a maintainer, then that means that person will take special care to review it and implement any changes that may be required.
+
+If we request changes on a PR, please ignore the red text! It doesn't mean we think it's a bad PR - it's just a way of easily telling the status of a list of pull requests at a glance.
+
+If we mark a PR as 'pending', that means we likely have another task to do in reviewing the PR - it's an internal note-to-self, and not necessarily a reflection on whether the PR is a good idea or not. We will do our best to explain via a comment the reason for the pending status.
+
+We'll do our best to follow [our PR decision making flowchart](https://mermaid.live/view#pako:eNp9VE1v2kAQ_SsjXzBSEqlALlaUisSh0ACK2l4qcVm8Y9hi7672Iwly-O-ZtYPt5FAOCHbee_PmzdpVlCmOURLlhXrJ9sw4-JNuJNBnWs1UQafIQVjrERyWumAOv58-AJeXt29_0b7BXbWwwL0uRPa1vlZvcB_fF8oiMMmB2QM4BXkt3UoON7Lh3LWaDz2SVkK6QGt7DHvw0CKt5sxCKaQoWQEGtVHcZ04oGdw04LTVngW_LHOeFcURGGz97mw6PSv-iJdsi0UCA4nI7SfNwc3W3JZit3eQ1SZFDlKB15yswQ2MgbOjbYeatY3n8bcr-IWlekYYaJRcyB04I9gOB1CEfkF5dAVTzmFAtnqn4-bUYAiMMmHZgWhNPRhgus5mW2BATxq0NkIZ4Y4NbNjzE2ZchBzcHmGLe_ZMSKCcyRXyLrVFa_5n_PBK2xKy3kk9eOjULUdltk6C8kI-7NFDr8f4EVGDoqlp-wa4sJm3ltIMIuZ_mTQXJyTSkQZtunPqsKxShV9GKdkBYe1fHXjpbcjlvONlO9Kqx_M7YHmOmav_luxfE5zKwVs09hM5DLSupgYDlr5flDkwo7ykixKG-xDsUly1LZ-uY32dgDc7lG7YqwbNp0msJwmIUivjWFtfd-xRrEcJ7Omydz37qFplHOtxEp4GskI2qB5dRCWakglOz3oV8JuITJa4iRL6yZk5bKKNPBGOead-H2UWJc54vIiaW53SPgwrz4fIhVNm1bw76lfI6R2_MW21) when responding and reviewing to pull requests.
+
+### AI-Assisted Contributions
+
+We welcome the thoughtful use of AI tools when contributing to Nuxt, yet ask all contributors to follow [two core principles](https://roe.dev/blog/using-ai-in-open-source).
+
+#### Never let an LLM speak for you
+
+* All comments, issues, and pull request descriptions should be written in your own voice
+* We value clear, human communication over perfect grammar or spelling
+* Avoid copy-pasting AI-generated summaries that don't reflect your own understanding
+
+#### Never let an LLM think for you
+
+* Feel free to use AI tools to generate code or explore ideas
+* Only submit contributions you fully understand and can explain
+* Contributions should reflect your own reasoning and problem-solving
+
+Our aim is ensuring quality and maintaining the joy of collaborating and communicating with real people. If you have ideas for improving our policy on AI in the Nuxt community, we'd love to hear them! ❤️
+
+### Create a Module
+
+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).
+
+### Make an RFC
+
+We highly recommend [creating a module](/docs/4.x/community/contribution#create-a-module) first to test out big new features and gain community adoption.
+
+If you have done this already, or it's not appropriate to create a new module, then please start by creating a new discussion. Make sure it explains your thinking as clearly as possible. Include code examples or function signatures for new APIs. Reference existing issues or pain points with examples.
+
+If we think this should be an RFC, we'll change the category to RFC and broadcast it more widely for feedback.
+
+An RFC will then move through the following stages:
+
+* `rfc: active` - currently open for comment
+* `rfc: approved` - approved by the Nuxt team
+* `rfc: ready to implement` - an issue has been created and assigned to implement
+* `rfc: shipped` - implemented
+* `rfc: archived` - not approved, but archived for future reference
+
+### Conventions Across Ecosystem
+
+The following conventions are _required_ within the `nuxt/` organization and recommended for other maintainers in the ecosystem.
+
+#### Module Conventions
+
+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
+
+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
+* [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`
+
+Most of the Nuxt ecosystem can consume ESM directly. In general we advocate that you avoid using CJS-specific code, such as `__dirname` and `require` statements. You can [read more about ESM](/docs/4.x/guide/concepts/esm).
+
+#### What's Corepack
+
+[Corepack](https://github.com/nodejs/corepack) makes sure you are using the correct version for package manager when you run corresponding commands. Projects might have `packageManager` field in their `package.json`.
+
+Under projects with configuration as shown below, Corepack will install `v7.5.0` of `pnpm` (if you don't have it already) and use it to run your commands.
+
+```jsonc [package.json]
+{
+ "packageManager": "pnpm@7.5.0"
+}
+```
+
+#### Use ESLint
+
+We use [ESLint](https://eslint.org) for both linting and formatting with [`@nuxt/eslint`](https://github.com/nuxt/eslint).
+
+##### IDE Setup
+
+We recommend using [VS Code](https://code.visualstudio.com) along with the [ESLint extension](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint). If you would like, you can enable auto-fix and formatting when you save the code you are editing:
+
+```json [settings.json]
+{
+ "editor.codeActionsOnSave": {
+ "source.fixAll": "never",
+ "source.fixAll.eslint": "explicit"
+ }
+}
+```
+
+#### 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`, `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 Manager
+
+We recommend `pnpm` as a package manager for modules, libraries and apps.
+
+It is important to enable Corepack to ensure you are on the same version of the package manager as the project. Corepack is built-in to new node versions for seamless package manager integration.
+
+To enable it, run
+
+```bash [Terminal]
+corepack enable
+```
+
+You only need to do this one time, after Node.js is installed on your computer.
+
+## Documentation Style Guide
+
+Documentation is an essential part of Nuxt. We aim to be an intuitive framework - and a big part of that is making sure that both the developer experience and the docs are perfect across the ecosystem. 👌
+
+Here are some tips that may help improve your documentation:
+
+* Avoid subjective words like _simply_, _just_, _obviously..._ when possible.
+
+ Keep in mind your readers can have different backgrounds and experiences. Therefore, these words don't convey meaning and can be harmful.
+
+ ::caution{ icon="i-lucide-circle-x"}
+ Simply make sure the function returns a promise.
+ ::
+
+ ::tip{icon="i-lucide-circle-check"}
+ Make sure the function returns a [promise](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise).
+ ::
+
+* Prefer [active voice](https://developers.google.com/tech-writing/one/active-voice).
+
+ ::caution{icon="i-lucide-circle-x"}
+ An error will be thrown by Nuxt.
+ ::
+
+ ::tip{icon="i-lucide-circle-check"}
+ Nuxt will throw an error.
+ ::
+
+::read-more{to="/docs/4.x/community/framework-contribution#documentation-guide"}
+Learn how to contribute to the documentation.
+::
diff --git a/docs/5.community/5.framework-contribution.md b/docs/5.community/5.framework-contribution.md
new file mode 100644
index 000000000000..ce1dfe9c7103
--- /dev/null
+++ b/docs/5.community/5.framework-contribution.md
@@ -0,0 +1,142 @@
+---
+title: 'Framework'
+navigation.icon: i-lucide-github
+description: Some specific points about contributions to the framework repository.
+---
+
+Once you've read the [general contribution guide](/docs/4.x/community/contribution), here are some specific points to make about contributions to the [`nuxt/nuxt`](https://github.com/nuxt/nuxt) repository.
+
+## Monorepo Guide
+
+- `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).
+- `packages/vite`: The [Vite](https://vite.dev) bundler for Nuxt, published as [`@nuxt/vite-builder`](https://www.npmjs.com/package/@nuxt/vite-builder).
+- `packages/webpack`: The [webpack](https://webpack.js.org) bundler for Nuxt, published as [`@nuxt/webpack-builder`](https://www.npmjs.com/package/@nuxt/webpack-builder).
+
+## Setup
+
+To contribute to Nuxt, you need to set up a local environment.
+
+1. [Fork](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo) the [`nuxt/nuxt`](https://github.com/nuxt/nuxt) repository to your own GitHub account and then [clone](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository) it to your local device.
+2. Ensure using the latest [Node.js](https://nodejs.org/en)
+3. Enable [Corepack](https://github.com/nodejs/corepack) to have `pnpm` and `yarn`
+ ```bash [Terminal]
+ corepack enable
+ ```
+4. Run `pnpm install --frozen-lockfile` to Install the dependencies with pnpm:
+ ```bash [Terminal]
+ pnpm install --frozen-lockfile
+ ```
+ ::note
+ If you are adding a dependency, please use `pnpm add`. :br
+ The `pnpm-lock.yaml` file is the source of truth for all Nuxt dependencies.
+ ::
+5. Activate the passive development system
+ ```bash [Terminal]
+ pnpm dev:prepare
+ ```
+6. Check out a branch where you can work and commit your changes:
+ ```bash [Terminal]
+ git checkout -b my-new-branch
+ ```
+
+Then, test your changes against the [playground](/docs/4.x/community/framework-contribution#playground) and [test](/docs/4.x/community/framework-contribution#testing) your changes before submitting a pull request.
+
+### Playground
+
+While working on a pull request, you will likely want to check if your changes are working correctly.
+
+You can modify the example app in `playground/`, and run:
+
+```bash [Terminal]
+pnpm dev
+```
+
+::important
+Please make sure not to commit it to your branch, but it could be helpful to add some example code to your PR description. This can help reviewers and other Nuxt users understand the feature you've built in-depth.
+::
+
+### Testing
+
+Every new feature should have a corresponding unit test (if possible). The `test/` directory in this repository is currently a work in progress, but do your best to create a new test following the example of what's already there.
+
+Before creating a PR or marking it as ready-to-review, ensure that all tests pass by running:
+
+```bash [Terminal]
+pnpm test
+```
+
+### Linting
+
+You might have noticed already that we use ESLint to enforce a coding standard.
+
+Before committing your changes, to verify that the code style is correct, run:
+
+```bash [Terminal]
+pnpm lint
+```
+
+::note
+You can use `pnpm lint --fix` to fix most of the style changes. :br
+If there are still errors left, you must correct them manually.
+::
+
+### Documentation
+
+If you are adding a new feature or refactoring or changing the behavior of Nuxt in any other manner, you'll likely want to document the changes. Please include any changes to the docs in the same PR. You don't have to write documentation up on the first commit (but please do so as soon as your pull request is mature enough).
+
+::important
+Make sure to make changes according to the [Documentation Style Guide](/docs/4.x/community/contribution#documentation-style-guide).
+::
+
+### Final Checklist
+
+When submitting your PR, there is a simple template that you have to fill out. Please tick all appropriate "answers" in the checklists.
+
+## Documentation Guide
+
+If you spot an area where we can improve documentation or error messages, please do open a PR - even if it's just to fix a typo!
+
+::important
+Make sure to make changes according to the [Documentation Style Guide](/docs/4.x/community/contribution#documentation-style-guide).
+::
+
+### Quick Edits
+
+If you spot a typo or want to rephrase a sentence, you can click on the **Edit this page** link located on the right aside in the **Community** section.
+
+Make the change directly in the GitHub interface and open a Pull Request.
+
+### Longer Edits
+
+The documentation content is inside the `docs/` directory of the [nuxt/nuxt](https://github.com/nuxt/nuxt) repository and written in markdown.
+
+::note
+To preview the docs locally, follow the steps on [nuxt/nuxt.com](https://github.com/nuxt/nuxt.com) repository.
+::
+
+::note
+We recommend that you install the [MDC extension](https://marketplace.visualstudio.com/items?itemName=Nuxt.mdc) for VS Code.
+::
+
+### Linting Docs
+
+Documentation is linted using [MarkdownLint](https://github.com/DavidAnson/markdownlint) and [case police](https://github.com/antfu/case-police) to keep the documentation cohesive.
+
+```bash [Terminal]
+pnpm lint:docs
+```
+
+::note
+You can also run `pnpm lint:docs:fix` to highlight and resolve any lint issues.
+::
+
+### Open a PR
+
+Please make sure your PR title adheres to the [conventional commits](https://www.conventionalcommits.org) guidelines.
+
+```bash [Example of PR title]
+docs: update the section about the nuxt.config.ts file
+```
diff --git a/docs/5.community/6.roadmap.md b/docs/5.community/6.roadmap.md
new file mode 100644
index 000000000000..0a206f52ceb0
--- /dev/null
+++ b/docs/5.community/6.roadmap.md
@@ -0,0 +1,82 @@
+---
+title: 'Roadmap'
+description: 'Nuxt is constantly evolving, with new features and modules being added all the time.'
+navigation.icon: i-lucide-map
+---
+
+::read-more{to="/blog"}
+See our blog for the latest framework and ecosystem announcements.
+::
+
+## Status Reports
+
+::read-more{icon="i-simple-icons-github" to="https://github.com/nuxt/nuxt/issues/13653" target="_blank"}
+Documentation Progress
+::
+::read-more{icon="i-simple-icons-github" to="https://github.com/nuxt/nuxt/discussions/16119" target="_blank"}
+Rendering Optimizations: Today and Tomorrow
+::
+::read-more{icon="i-simple-icons-github" to="https://github.com/nuxt/image/discussions/563" target="_blank"}
+Nuxt Image: Performance and Status
+::
+
+## Roadmap
+
+In roadmap below are some features we are planning or working on at the moment.
+
+::tip
+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. |
+
+## 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 |
+|----------------------------------------|--------------|--------------|-------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| 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)). |
+
+## Release Cycle
+
+Since January 2023, we've adopted a consistent release cycle for Nuxt, following [semver](https://semver.org). We aim for major framework releases every year, with an expectation of patch releases every week or so and minor releases every month or so. They should never contain breaking changes except within options clearly marked as `experimental`.
+
+We are planning a slight variation from this plan for Nuxt 4 and Nuxt 5. Nuxt 4 will be a stability-focused release containing all `compatibilityVersion: 4` features, and will be followed shortly by Nuxt 5 which will include an upgrade to Nitro v3 and additional changes.
+
+This approach separates breaking changes into manageable phases, allowing for better ecosystem testing and smoother migrations.
+
+### Ongoing Support for Nuxt
+
+We commit to support each major version of Nuxt for a minimum of six months after the release of the next major version, and to providing an upgrade path for current users at that point.
+
+### Current Packages
+
+The current active version of [Nuxt](https://nuxt.com) is **v4** which is available as `nuxt` on npm with the `latest` tag.
+
+Nuxt 3 will continue to receive maintenance updates (bug fixes and security patches) until the end of July 2026.
+
+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) | | Q1 2026 (estimated) | TBA | |
+| **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-07-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 | |
+
+### 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 |
diff --git a/docs/5.community/7.changelog.md b/docs/5.community/7.changelog.md
new file mode 100644
index 000000000000..859c38e80636
--- /dev/null
+++ b/docs/5.community/7.changelog.md
@@ -0,0 +1,112 @@
+---
+title: 'Releases'
+description: Discover the latest releases of Nuxt & Nuxt official modules.
+navigation.icon: i-lucide-bell-dot
+---
+
+::card-group
+ ::card
+ ---
+ icon: i-simple-icons-github
+ title: nuxt/nuxt
+ to: https://github.com/nuxt/nuxt/releases
+ target: _blank
+ ui.icon.base: text-black dark:text-white
+ ---
+ Nuxt framework releases.
+ ::
+ ::card
+ ---
+ icon: i-simple-icons-github
+ title: nuxt/cli
+ to: https://github.com/nuxt/cli/releases
+ target: _blank
+ ui.icon.base: text-black dark:text-white
+ ---
+ Nuxt CLI (`@nuxt/cli`) releases.
+ ::
+ ::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
+ ui.icon.base: text-black dark:text-white
+ ---
+ Nuxt Content releases.
+ ::
+ ::card
+ ---
+ icon: i-simple-icons-github
+ title: nuxt/devtools
+ to: https://github.com/nuxt/devtools/releases
+ target: _blank
+ ui.icon.base: text-black dark:text-white
+ ---
+ Nuxt DevTools releases.
+ ::
+ ::card
+ ---
+ icon: i-simple-icons-github
+ title: nuxt/fonts
+ to: https://github.com/nuxt/fonts/releases
+ target: _blank
+ ui.icon.base: text-black dark:text-white
+ ---
+ Nuxt Fonts releases.
+ ::
+ ::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
+ ui.icon.base: text-black dark:text-white
+ ---
+ Nuxt Image releases.
+ ::
+ ::card
+ ---
+ icon: i-simple-icons-github
+ title: nuxt/scripts
+ to: https://github.com/nuxt/scripts/releases
+ target: _blank
+ ui.icon.base: text-black dark:text-white
+ ---
+ Nuxt Scripts releases.
+ ::
+ ::card
+ ---
+ icon: i-simple-icons-github
+ title: nuxt/ui
+ to: https://github.com/nuxt/ui/releases
+ target: _blank
+ ui.icon.base: text-black dark:text-white
+ ---
+ Nuxt UI releases.
+ ::
+::
+
+::read-more{icon="i-simple-icons-github" to="https://github.com/nuxt" target="_blank"}
+Discover the `nuxt` organization on GitHub
+::
diff --git a/docs/6.bridge/.navigation.yml b/docs/6.bridge/.navigation.yml
new file mode 100644
index 000000000000..cf5e862143e0
--- /dev/null
+++ b/docs/6.bridge/.navigation.yml
@@ -0,0 +1,3 @@
+titleTemplate: 'Migrate to Nuxt Bridge: %s'
+title: 'Migrate to Nuxt Bridge'
+icon: i-lucide-ship
diff --git a/docs/6.bridge/1.overview.md b/docs/6.bridge/1.overview.md
new file mode 100644
index 000000000000..34f699ee9a2b
--- /dev/null
+++ b/docs/6.bridge/1.overview.md
@@ -0,0 +1,145 @@
+---
+title: Overview
+description: Reduce the differences with Nuxt 3 and reduce the burden of migration to Nuxt 3.
+---
+
+::note
+If you're starting a fresh Nuxt 3 project, please skip this section and go to [Nuxt 3 Installation](/docs/4.x/getting-started/introduction).
+::
+
+::warning
+Nuxt Bridge provides identical features to Nuxt 3 ([docs](/docs/4.x/guide/concepts/auto-imports)) but there are some limitations, notably that [`useAsyncData`](/docs/4.x/api/composables/use-async-data) and [`useFetch`](/docs/4.x/api/composables/use-fetch) composables are not available. Please read the rest of this page for details.
+::
+
+Bridge is a forward-compatibility layer that allows you to experience many of the new Nuxt 3 features by simply installing and enabling a Nuxt module.
+
+Using Nuxt Bridge, you can make sure your project is (almost) ready for Nuxt 3 and you can gradually proceed with the transition to Nuxt 3.
+
+## First Step
+
+### Upgrade Nuxt 2
+
+Make sure your dev server (`nuxt dev`) isn't running, remove any package lock files (`package-lock.json` and `yarn.lock`), and install the latest Nuxt 2 version:
+
+```diff [package.json]
+- "nuxt": "^2.16.3"
++ "nuxt": "^2.17.3"
+```
+
+Then, reinstall your dependencies:
+
+::code-group{sync="pm"}
+
+```bash [npm]
+npm install
+```
+
+```bash [yarn]
+yarn install
+```
+
+```bash [pnpm]
+pnpm install
+```
+
+```bash [bun]
+bun install
+```
+
+```bash [deno]
+deno install
+```
+
+::
+
+::note
+Once the installation is complete, make sure both development and production builds are working as expected before proceeding.
+::
+
+### Install Nuxt Bridge
+
+Install `@nuxt/bridge` and `nuxi` as development dependencies:
+
+::code-group{sync="pm"}
+
+```bash [npm]
+npm install -D @nuxt/bridge nuxi
+```
+
+```bash [yarn]
+yarn add --dev @nuxt/bridge nuxi
+```
+
+```bash [pnpm]
+pnpm add -D @nuxt/bridge nuxi
+```
+
+```bash [bun]
+bun add -D @nuxt/bridge nuxi
+```
+
+```bash [deno]
+deno add -D npm:@nuxt/bridge npm:nuxi
+```
+
+::
+
+### Update `nuxt.config`
+
+Please make sure to avoid any CommonJS syntax such as `module.exports`, `require` or `require.resolve` in your config file. It will soon be deprecated and unsupported.
+
+You can use static `import`, dynamic `import()` and `export default` instead. Using TypeScript by renaming to [`nuxt.config.ts`](/docs/4.x/directory-structure/nuxt-config) is also possible and recommended.
+
+```ts [nuxt.config.ts]
+import { defineNuxtConfig } from '@nuxt/bridge'
+
+export default defineNuxtConfig({
+ bridge: false,
+})
+```
+
+### Update Commands
+
+The `nuxt` command should now be changed to the `nuxt2` command.
+
+```diff
+{
+ "scripts": {
+- "dev": "nuxt",
++ "dev": "nuxt2",
+- "build": "nuxt build",
++ "build": "nuxt2 build",
+- "start": "nuxt start",
++ "start": "nuxt2 start"
+ }
+}
+```
+
+Try running `nuxt2` once here. You will see that the application works as before.
+
+(If 'bridge' is set to false, your application will operate without any changes as before.)
+
+## Upgrade Steps
+
+With Nuxt Bridge, the migration to Nuxt 3 can proceed in steps.
+The below `Upgrade Steps` does not need to be done all at once.
+
+- [TypeScript](/docs/4.x/bridge/typescript)
+
+- [Migrate Legacy Composition API](/docs/4.x/bridge/bridge-composition-api)
+
+- [Plugins and Middleware](/docs/4.x/bridge/plugins-and-middleware)
+
+- [Migrate New Composition API](/docs/4.x/bridge/nuxt3-compatible-api)
+
+- [Meta Tags](/docs/4.x/bridge/meta)
+
+- [Runtime Config](/docs/4.x/bridge/runtime-config)
+
+- [Nitro](/docs/4.x/bridge/nitro)
+
+- [Vite](/docs/4.x/bridge/vite)
+
+## Migrate from CommonJS to ESM
+
+Nuxt 3 natively supports TypeScript and ECMAScript Modules. Please check [Native ES Modules](/docs/4.x/guide/concepts/esm) for more info and upgrading.
diff --git a/docs/6.bridge/10.configuration.md b/docs/6.bridge/10.configuration.md
new file mode 100644
index 000000000000..c8ada66f96c3
--- /dev/null
+++ b/docs/6.bridge/10.configuration.md
@@ -0,0 +1,97 @@
+---
+title: Configuration
+description: 'Learn how to configure Nuxt Bridge to your own needs.'
+---
+
+## Feature Flags
+
+You can optionally disable some features from bridge or opt-in to less stable ones. In normal circumstances, it is always best to stick with defaults!
+
+You can check [bridge/src/module.ts](https://github.com/nuxt/bridge/blob/main/packages/bridge/src/module.ts) for latest defaults.
+
+```ts [nuxt.config.ts]
+import { defineNuxtConfig } from '@nuxt/bridge'
+
+export default defineNuxtConfig({
+ bridge: {
+
+ // -- Opt-in features --
+
+ // Use Vite as the bundler instead of webpack 4
+ // vite: true,
+
+ // Enable Nuxt 3 compatible useHead
+ // meta: true,
+
+ // Enable definePageMeta macro
+ // macros: {
+ // pageMeta: true
+ // },
+
+ // Enable transpiling TypeScript with esbuild
+ // typescript: {
+ // esbuild: true
+ // },
+
+ // -- Default features --
+
+ // Use legacy server instead of Nitro
+ // nitro: false,
+
+ // Disable Nuxt 3 compatible `nuxtApp` interface
+ // app: false,
+
+ // Disable Composition API support
+ // capi: false,
+
+ // ... or just disable legacy Composition API support
+ // capi: {
+ // legacy: false
+ // },
+
+ // Do not transpile modules
+ // transpile: false,
+
+ // Disable <script setup> support
+ // scriptSetup: false,
+
+ // Disable composables auto importing
+ // imports: false,
+
+ // Do not warn about module incompatibilities
+ // constraints: false
+ },
+
+ vite: {
+ // Config for Vite
+ },
+})
+```
+
+## Migration of each option
+
+### router.base
+
+```diff
+export default defineNuxtConfig({
+- router: {
+- base: '/my-app/'
+- }
++ app: {
++ baseURL: '/my-app/'
++ }
+})
+```
+
+### build.publicPath
+
+```diff
+export default defineNuxtConfig({
+- build: {
+- publicPath: 'https://my-cdn.net'
+- }
++ app: {
++ cdnURL: 'https://my-cdn.net'
++ }
+})
+```
diff --git a/docs/6.bridge/2.typescript.md b/docs/6.bridge/2.typescript.md
new file mode 100644
index 000000000000..b5ef8c8a4b47
--- /dev/null
+++ b/docs/6.bridge/2.typescript.md
@@ -0,0 +1,48 @@
+---
+title: TypeScript
+description: 'Learn how to use TypeScript with Nuxt Bridge.'
+---
+
+## Remove Modules
+
+- Remove `@nuxt/typescript-build`: Bridge enables same functionality
+- Remove `@nuxt/typescript-runtime` and `nuxt-ts`: Nuxt 2 has built-in runtime support
+
+### Set `bridge.typescript`
+
+```ts
+import { defineNuxtConfig } from '@nuxt/bridge'
+
+export default defineNuxtConfig({
+ bridge: {
+ typescript: true,
+ nitro: false, // If migration to Nitro is complete, set to true
+ },
+})
+```
+
+## Update `tsconfig.json`
+
+If you are using TypeScript, you can edit your `tsconfig.json` to benefit from auto-generated Nuxt types:
+
+```diff [tsconfig.json]
+{
++ "extends": "./.nuxt/tsconfig.json",
+ "compilerOptions": {
+ ...
+ }
+}
+```
+
+::note
+As `.nuxt/tsconfig.json` is generated and not checked into version control, you'll need to generate that file before running your tests. Add `nuxi prepare` as a step before your tests, otherwise you'll see `TS5083: Cannot read file '~/.nuxt/tsconfig.json'`
+
+For modern Nuxt projects, we recommend using [TypeScript project references](/docs/4.x/directory-structure/tsconfig) instead of directly extending `.nuxt/tsconfig.json`.
+::
+
+::note
+Keep in mind that all options extended from `./.nuxt/tsconfig.json` will be overwritten by the options defined in your `tsconfig.json`.
+Overwriting options such as `"compilerOptions.paths"` with your own configuration will lead TypeScript to not factor in the module resolutions from `./.nuxt/tsconfig.json`. This can lead to module resolutions such as `#imports` not being recognized.
+
+In case you need to extend options provided by `./.nuxt/tsconfig.json` further, you can use the `alias` property within your `nuxt.config`. `nuxi` will pick them up and extend `./.nuxt/tsconfig.json` accordingly.
+::
diff --git a/docs/6.bridge/3.bridge-composition-api.md b/docs/6.bridge/3.bridge-composition-api.md
new file mode 100644
index 000000000000..662f156aff69
--- /dev/null
+++ b/docs/6.bridge/3.bridge-composition-api.md
@@ -0,0 +1,132 @@
+---
+title: Legacy Composition API
+description: 'Learn how to migrate to Composition API with Nuxt Bridge.'
+---
+
+Nuxt Bridge provides access to Composition API syntax. It is specifically designed to be aligned with Nuxt 3. Because of this, there are a few extra steps to take when enabling Nuxt Bridge, if you have been using the Composition API previously.
+
+## Remove Modules
+
+- Remove `@vue/composition-api` from your dependencies.
+- Remove `@nuxtjs/composition-api` from your dependencies (and from your modules in `nuxt.config`).
+
+## Using `@vue/composition-api`
+
+If you have been using just `@vue/composition-api` and not `@nuxtjs/composition-api`, then things are very straightforward.
+
+1. First, remove the plugin where you are manually registering the Composition API. Nuxt Bridge will handle this for you.
+
+ ```diff
+ - import Vue from 'vue'
+ - import VueCompositionApi from '@vue/composition-api'
+ -
+ - Vue.use(VueCompositionApi)
+ ```
+
+2. Otherwise, there is nothing you need to do. However, if you want, you can remove your explicit imports from `@vue/composition-api` and rely on Nuxt Bridge auto-importing them for you.
+
+## Migrating from `@nuxtjs/composition-api`
+
+Nuxt Bridge implements the Composition API slightly differently from `@nuxtjs/composition-api` and provides different composables (designed to be aligned with the composables that Nuxt 3 provides).
+
+Because some composables have been removed and don't yet have a replacement, this will be a slightly more complicated process.
+
+### Remove `@nuxtjs/composition-api/module` from your buildModules
+
+You don't have to immediately update your imports yet - Nuxt Bridge will automatically provide a 'shim' for most imports you currently have, to give you time to migrate to the new, Nuxt 3-compatible composables, with the following exceptions:
+
+- `withContext` has been removed. See [below](/docs/4.x/bridge/nuxt3-compatible-api#usecontext-and-withcontext).
+- `useStatic` has been removed. There is no current replacement. Feel free to raise a discussion if you have a use case for this.
+- `reqRef` and `reqSsrRef`, which were deprecated, have now been removed entirely. Follow the instructions below regarding [ssrRef](/docs/4.x/bridge/nuxt3-compatible-api#ssrref-and-shallowssrref) to replace this.
+
+### Set `bridge.capi`
+
+```ts
+import { defineNuxtConfig } from '@nuxt/bridge'
+
+export default defineNuxtConfig({
+ bridge: {
+ capi: true,
+ nitro: false, // If migration to Nitro is complete, set to true
+ },
+})
+```
+
+For each other composable you are using from `@nuxtjs/composition-api`, follow the steps below.
+
+### useFetch
+
+`$fetchState` and `$fetch` have been removed.
+
+```diff
+const {
+- $fetch,
+- $fetchState,
++ fetch,
++ fetchState,
+} = useFetch(() => { posts.value = await $fetch('/api/posts') })
+```
+
+### `defineNuxtMiddleware`
+
+This was a type-helper stub function that is now removed.
+
+Remove the `defineNuxtMiddleware` wrapper:
+
+```diff
+- import { defineNuxtMiddleware } from '@nuxtjs/composition-api`
+- export default defineNuxtMiddleware((ctx) => {})
++ export default (ctx) => {}
+```
+
+For typescript support, you can use `@nuxt/types`:
+
+```ts
+import type { Middleware } from '@nuxt/types'
+
+export default <Middleware> function (ctx) { }
+```
+
+### `defineNuxtPlugin`
+
+This was a type-helper stub function that is now removed.
+
+You may also keep using Nuxt 2-style plugins, by removing the function (as with [defineNuxtMiddleware](/docs/4.x/bridge/bridge-composition-api#definenuxtmiddleware)).
+
+Remove the `defineNuxtPlugin` wrapper:
+
+```diff
+- import { defineNuxtPlugin } from '@nuxtjs/composition-api'
+- export default defineNuxtPlugin((ctx, inject) => {})
++ export default (ctx, inject) => {}
+```
+
+For typescript support, you can use `@nuxt/types`:
+
+```ts
+import type { Plugin } from '@nuxt/types'
+
+export default <Plugin> function (ctx, inject) {}
+```
+
+::warning
+While this example is valid, Nuxt 3 introduces a new defineNuxtPlugin function that has a slightly different signature.
+::
+
+:ReadMore{link="/docs/4.x/directory-structure/app/plugins#creating-plugins"}
+
+### `useRouter` and `useRoute`
+
+Nuxt Bridge provides direct replacements for these composables via [`useRouter`](/docs/4.x/api/composables/use-router) and `useRoute`.
+
+The only key difference is that [`useRoute`](/docs/4.x/api/composables/use-route) no longer returns a computed property.
+
+```diff
+- import { useRouter, useRoute } from '@nuxtjs/composition-api'
+
+ const router = useRouter()
+ const route = useRoute()
+
+- console.log(route.value.path)
++ console.log(route.path)
+```
diff --git a/docs/6.bridge/4.plugins-and-middleware.md b/docs/6.bridge/4.plugins-and-middleware.md
new file mode 100644
index 000000000000..fdfd58f56a9a
--- /dev/null
+++ b/docs/6.bridge/4.plugins-and-middleware.md
@@ -0,0 +1,65 @@
+---
+title: Plugins and Middleware
+description: 'Learn how to migrate from Nuxt 2 to Nuxt Bridge new plugins and middleware.'
+---
+
+## New Plugins Format
+
+You can now migrate to the Nuxt 3 plugins API, which is slightly different in format from Nuxt 2.
+
+Plugins now take only one argument (`nuxtApp`). You can find out more in [the docs](/docs/4.x/directory-structure/app/plugins).
+
+```ts [app/plugins/hello.ts]
+export default defineNuxtPlugin((nuxtApp) => {
+ nuxtApp.provide('injected', () => 'my injected function')
+ // now available on `nuxtApp.$injected`
+})
+```
+
+::note
+If you want to use the new Nuxt composables (such as [`useNuxtApp`](/docs/4.x/api/composables/use-nuxt-app) or `useRuntimeConfig`) within your plugins, you will need to use the `defineNuxtPlugin` helper for those plugins.
+::
+
+::warning
+Although a compatibility interface is provided via `nuxtApp.vueApp` you should avoid registering plugins, directives, mixins or components this way without adding your own logic to ensure they are not installed more than once, or this may cause a memory leak.
+::
+
+## New Middleware Format
+
+You can now migrate to the Nuxt 3 middleware API, which is slightly different in format from Nuxt 2.
+
+Middleware now take only two argument (`to`, `from`). You can find out more in [the docs](/docs/4.x/directory-structure/app/middleware).
+
+```ts twoslash
+export default defineNuxtRouteMiddleware((to) => {
+ if (to.path !== '/') {
+ return navigateTo('/')
+ }
+})
+```
+
+::important
+Use of `defineNuxtRouteMiddleware` is not supported outside of the `app/middleware` directory.
+::
+
+## definePageMeta
+
+You can also use [`definePageMeta`](/docs/4.x/api/utils/define-page-meta) in Nuxt Bridge.
+
+It can be enabled with the `macros.pageMeta` option in your configuration file
+
+```ts [nuxt.config.ts]
+import { defineNuxtConfig } from '@nuxt/bridge'
+
+export default defineNuxtConfig({
+ bridge: {
+ macros: {
+ pageMeta: true,
+ },
+ },
+})
+```
+
+::note
+But only for `middleware` and `layout`.
+::
diff --git a/docs/6.bridge/5.nuxt3-compatible-api.md b/docs/6.bridge/5.nuxt3-compatible-api.md
new file mode 100644
index 000000000000..77b0c86c2817
--- /dev/null
+++ b/docs/6.bridge/5.nuxt3-compatible-api.md
@@ -0,0 +1,207 @@
+---
+title: New Composition API
+description: Nuxt Bridge implements composables compatible with Nuxt 3.
+---
+
+By migrating from `@nuxtjs/composition-api` to the Nuxt 3 compatible API, there will be less rewriting when migrating to Nuxt 3.
+
+## `ssrRef` and `shallowSsrRef`
+
+These two functions have been replaced with a new composable that works very similarly under the hood: `useState`.
+
+The key differences are that you must provide a _key_ for this state (which Nuxt generated automatically for `ssrRef` and `shallowSsrRef`), and that it can only be called within a Nuxt 3 plugin (which is defined by `defineNuxtPlugin`) or a component instance. (In other words, you cannot use [`useState`](/docs/4.x/api/composables/use-state) with a global/ambient context, because of the danger of shared state across requests.)
+
+```diff
+- import { ssrRef } from '@nuxtjs/composition-api'
+
+- const ref1 = ssrRef('initialData')
+- const ref2 = ssrRef(() => 'factory function')
++ const ref1 = useState('ref1-key', () => 'initialData')
++ const ref2 = useState('ref2-key', () => 'factory function')
+ // accessing the state
+ console.log(ref1.value)
+```
+
+Because the state is keyed, you can access the same state from multiple locations, as long as you are using the same key.
+
+You can read more about how to use this composable in [the Nuxt 3 docs](/docs/4.x/api/composables/use-state).
+
+## `ssrPromise`
+
+This function has been removed, and you will need to find an alternative implementation if you were using it. If you have a use case for `ssrPromise`, please let us know via a discussion.
+
+## `onGlobalSetup`
+
+This function has been removed, but its use cases can be met by using [`useNuxtApp`](/docs/4.x/api/composables/use-nuxt-app) or [`useState`](/docs/4.x/api/composables/use-state) within `defineNuxtPlugin`. You can also run any custom code within the `setup()` function of a layout.
+
+```diff
+- import { onGlobalSetup } from '@nuxtjs/composition-api'
+
+- export default () => {
+- onGlobalSetup(() => {
++ export default defineNuxtPlugin((nuxtApp) => {
++ nuxtApp.hook('vue:setup', () => {
+ // ...
+ })
+- }
++ })
+```
+
+## `useStore`
+
+In order to access Vuex store instance, you can use `useNuxtApp().$store`.
+
+```diff
+- import { useStore } from '@nuxtjs/composition-api`
++ const { $store } = useNuxtApp()
+```
+
+## `useContext` and `withContext`
+
+You can access injected helpers using `useNuxtApp`.
+
+```diff
+- import { useContext } from '@nuxtjs/composition-api`
++ const { $axios } = useNuxtApp()
+```
+
+::note
+`useNuxtApp()` also provides a key called `nuxt2Context` which contains all the same properties you would normally access from Nuxt 2 context, but it's advised _not_ to use this directly, as it won't exist in Nuxt 3. Instead, see if there is another way to access what you need. (If not, please raise a feature request or discussion.)
+::
+
+## `wrapProperty`
+
+This helper function is not provided any more but you can replace it with the following code:
+
+```ts
+import { computed, getCurrentInstance } from 'vue'
+
+const wrapProperty = (property: string, makeComputed = true) => () => {
+ const vm = getCurrentInstance().proxy
+ return makeComputed ? computed(() => vm[property]) : vm[property]
+}
+```
+
+## `useAsync` and `useFetch`
+
+These two composables can be replaced with `useLazyAsyncData` and `useLazyFetch`, which are documented [in the Nuxt 3 docs](/docs/4.x/getting-started/data-fetching). Just like the previous `@nuxtjs/composition-api` composables, these composables do not block route navigation on the client-side (hence the 'lazy' part of the name).
+
+::important
+Note that the API is entirely different, despite similar sounding names. Importantly, you should not attempt to change the value of other variables outside the composable (as you may have been doing with the previous `useFetch`).
+::
+
+::warning
+The `useLazyFetch` must have been configured for [Nitro](/docs/4.x/bridge/nitro).
+::
+
+Migrating to the new composables from `useAsync`:
+
+```diff
+<script setup>
+- import { useAsync } from '@nuxtjs/composition-api'
+- const posts = useAsync(() => $fetch('/api/posts'))
++ const { data: posts } = useLazyAsyncData('posts', () => $fetch('/api/posts'))
++ // or, more simply!
++ const { data: posts } = useLazyFetch('/api/posts')
+</script>
+```
+
+Migrating to the new composables from `useFetch`:
+
+```diff
+<script setup>
+- import { useFetch } from '@nuxtjs/composition-api'
+- const posts = ref([])
+- const { fetch } = useFetch(() => { posts.value = await $fetch('/api/posts') })
++ const { data: posts, refresh } = useLazyAsyncData('posts', () => $fetch('/api/posts'))
++ // or, more simply!
++ const { data: posts, refresh } = useLazyFetch('/api/posts')
+ function updatePosts() {
+- return fetch()
++ return refresh()
+ }
+</script>
+```
+
+### `useMeta`
+
+In order to interact with `vue-meta`, you may use `useNuxt2Meta`, which will work in Nuxt Bridge (but not Nuxt 3) and will allow you to manipulate your meta tags in a `vue-meta`-compatible way.
+
+```diff
+<script setup>
+- import { useMeta } from '@nuxtjs/composition-api'
+ useNuxt2Meta({
+ title: 'My Nuxt App',
+ })
+</script>
+```
+
+You can also pass in computed values or refs, and the meta values will be updated reactively:
+
+```vue
+<script setup>
+const title = ref('my title')
+useNuxt2Meta({
+ title,
+})
+title.value = 'new title'
+</script>
+```
+
+::note
+Be careful not to use both `useNuxt2Meta()` and the Options API `head()` within the same component, as behavior may be unpredictable.
+::
+
+Nuxt Bridge also provides a Nuxt 3-compatible meta implementation that can be accessed with the [`useHead`](/docs/4.x/api/composables/use-head) composable.
+
+```diff
+<script setup>
+- import { useMeta } from '@nuxtjs/composition-api'
+ useHead({
+ title: 'My Nuxt App',
+ })
+</script>
+```
+
+You will also need to enable it explicitly in your `nuxt.config`:
+
+```js
+import { defineNuxtConfig } from '@nuxt/bridge'
+
+export default defineNuxtConfig({
+ bridge: {
+ meta: true,
+ },
+})
+```
+
+This [`useHead`](/docs/4.x/api/composables/use-head) composable uses `@unhead/vue` under the hood (rather than `vue-meta`) to manipulate your `<head>`. Accordingly, it is recommended not to use both the native Nuxt 2 `head()` properties as well as [`useHead`](/docs/4.x/api/composables/use-head) , as they may conflict.
+
+For more information on how to use this composable, see [the Nuxt 3 docs](/docs/4.x/getting-started/seo-meta).
+
+### Explicit Imports
+
+Nuxt exposes every auto-import with the `#imports` alias that can be used to make the import explicit if needed:
+
+```vue
+<script setup lang="ts">
+import { computed, ref } from '#imports'
+
+const count = ref(1)
+const double = computed(() => count.value * 2)
+</script>
+```
+
+### Disabling Auto-imports
+
+If you want to disable auto-importing composables and utilities, you can set `imports.autoImport` to `false` in the `nuxt.config` file.
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+ imports: {
+ autoImport: false,
+ },
+})
+```
+
+This will disable auto-imports completely but it's still possible to use [explicit imports](/docs/4.x/bridge/nuxt3-compatible-api#explicit-imports) from `#imports`.
diff --git a/docs/6.bridge/6.meta.md b/docs/6.bridge/6.meta.md
new file mode 100644
index 000000000000..a678d06ebc9d
--- /dev/null
+++ b/docs/6.bridge/6.meta.md
@@ -0,0 +1,118 @@
+---
+title: Meta Tags
+description: 'Learn how to migrate from Nuxt 2 to Nuxt Bridge new meta tags.'
+---
+
+If you need to access the component state with `head`, you should migrate to using [`useHead`](/docs/4.x/api/composables/use-head) .
+
+If you need to use the Options API, there is a `head()` method you can use when you use `defineNuxtComponent`.
+
+## Migration
+
+### Set `bridge.meta`
+
+```js
+import { defineNuxtConfig } from '@nuxt/bridge'
+
+export default defineNuxtConfig({
+ bridge: {
+ meta: true,
+ nitro: false, // If migration to Nitro is complete, set to true
+ },
+})
+```
+
+### Update head properties
+
+In your `nuxt.config`, rename `head` to `app.head`. (Note that objects no longer have a `hid` key for deduplication.)
+
+::code-group
+
+```ts [Nuxt 2]
+export default {
+ head: {
+ titleTemplate: '%s - Nuxt',
+ meta: [
+ { charset: 'utf-8' },
+ { name: 'viewport', content: 'width=device-width, initial-scale=1' },
+ { hid: 'description', name: 'description', content: 'Meta description' },
+ ],
+ },
+}
+```
+
+```ts [Nuxt 3]
+export default defineNuxtConfig({
+ app: {
+ head: {
+ titleTemplate: '%s - Nuxt',
+ meta: [
+ { charset: 'utf-8' },
+ { name: 'viewport', content: 'width=device-width, initial-scale=1' },
+ { name: 'description', content: 'Meta description' },
+ ],
+ },
+ },
+})
+```
+
+::
+
+## `useHead` Composables
+
+Nuxt Bridge provides a new Nuxt 3 meta API that can be accessed with a new [`useHead`](/docs/4.x/api/composables/use-head) composable.
+
+```vue
+<script setup lang="ts">
+useHead({
+ title: 'My Nuxt App',
+})
+</script>
+```
+
+::tip
+This [`useHead`](/docs/4.x/api/composables/use-head) composable uses `@unhead/vue` under the hood (rather than `vue-meta`) to manipulate your `<head>`.
+::
+
+::warning
+We recommend not using the native Nuxt 2 `head()` properties in addition to [`useHead`](/docs/4.x/api/composables/use-head) , as they may conflict.
+::
+
+For more information on how to use this composable, see [the docs](/docs/4.x/getting-started/seo-meta).
+
+## Options API
+
+```vue
+<script>
+// if using options API `head` method you must use `defineNuxtComponent`
+export default defineNuxtComponent({
+ head (nuxtApp) {
+ // `head` receives the nuxt app but cannot access the component instance
+ return {
+ meta: [{
+ name: 'description',
+ content: 'This is my page description.',
+ }],
+ }
+ },
+})
+</script>
+```
+
+::warning
+Possible breaking change: `head` receives the nuxt app but cannot access the component instance. If the code in your `head` tries to access the data object through `this` or `this.$data`, you will need to migrate to the `useHead` composable.
+::
+
+## Title Template
+
+If you want to use a function (for full control), then this cannot be set in your nuxt.config, and it is recommended instead to set it within your `/layouts` directory.
+
+```vue [app/layouts/default.vue]
+<script setup lang="ts">
+useHead({
+ titleTemplate: (titleChunk) => {
+ return titleChunk ? `${titleChunk} - Site Title` : 'Site Title'
+ },
+})
+</script>
+```
diff --git a/docs/6.bridge/7.runtime-config.md b/docs/6.bridge/7.runtime-config.md
new file mode 100644
index 000000000000..27fa94d5cae4
--- /dev/null
+++ b/docs/6.bridge/7.runtime-config.md
@@ -0,0 +1,38 @@
+---
+title: Runtime Config
+description: 'Nuxt provides a runtime config API to expose configuration and secrets within your application.'
+---
+
+::warning
+When using `runtimeConfig` option, [nitro](/docs/4.x/bridge/nitro) must have been configured.
+::
+
+## Update Runtime Config
+
+Nuxt 3 approaches runtime config differently than Nuxt 2, using a new combined `runtimeConfig` option.
+
+First, you'll need to combine your `publicRuntimeConfig` and `privateRuntimeConfig` properties into a new one called `runtimeConfig`, with the public config within a key called `public`.
+
+```diff
+// nuxt.config.js
+- privateRuntimeConfig: {
+- apiKey: process.env.NUXT_API_KEY || 'super-secret-key'
+- },
+- publicRuntimeConfig: {
+- websiteURL: 'https://public-data.com'
+- }
++ runtimeConfig: {
++ apiKey: process.env.NUXT_API_KEY || 'super-secret-key',
++ public: {
++ websiteURL: 'https://public-data.com'
++ }
++ }
+```
+
+This also means that when you need to access public runtime config, it's behind a property called `public`. If you use public runtime config, you'll need to update your code.
+
+```diff
+// MyWidget.vue
+- <div>Website: {{ $config.websiteURL }}</div>
++ <div>Website: {{ $config.public.websiteURL }}</div>
+```
diff --git a/docs/6.bridge/8.nitro.md b/docs/6.bridge/8.nitro.md
new file mode 100644
index 000000000000..5c82e4ce6ff5
--- /dev/null
+++ b/docs/6.bridge/8.nitro.md
@@ -0,0 +1,106 @@
+---
+title: Nitro
+description: 'Activate Nitro to your Nuxt 2 application with Nuxt Bridge.'
+---
+
+## Remove Modules
+
+- Remove `@nuxt/nitro`: Bridge injects same functionality
+
+## Update Config
+
+```ts [nuxt.config.ts]
+import { defineNuxtConfig } from '@nuxt/bridge'
+
+export default defineNuxtConfig({
+ bridge: {
+ nitro: true,
+ },
+})
+```
+
+## Update Your Scripts
+
+You will also need to update your scripts within your `package.json` to reflect the fact that Nuxt will now produce a Nitro server as build output.
+
+### Install Nuxi
+
+Install `nuxi` as a development dependency:
+
+::code-group{sync="pm"}
+
+```bash [npm]
+npm install -D nuxi
+```
+
+```bash [yarn]
+yarn add --dev nuxi
+```
+
+```bash [pnpm]
+pnpm add -D nuxi
+```
+
+```bash [bun]
+bun add -D nuxi
+```
+
+```bash [deno]
+deno add -D npm:nuxi
+```
+
+::
+
+### Nuxi
+
+Nuxt 3 introduced the new Nuxt CLI command [`nuxi`](/docs/4.x/api/commands/add). Update your scripts as follows to leverage the better support from Nuxt Bridge:
+
+```diff
+{
+ "scripts": {
+- "dev": "nuxt",
++ "dev": "nuxi dev",
+- "build": "nuxt build",
++ "build": "nuxi build",
+- "start": "nuxt start",
++ "start": "nuxi preview"
+ }
+}
+```
+
+::tip
+If `nitro: false`, use the `nuxt2` command.
+::
+
+### Static Target
+
+If you have set `target: 'static'` in your `nuxt.config` then you need to ensure that you update your build script to be `nuxi generate`.
+
+```json [package.json]
+{
+ "scripts": {
+ "build": "nuxi generate"
+ }
+}
+```
+
+### Server Target
+
+For all other situations, you can use the `nuxi build` command.
+
+```json [package.json]
+{
+ "scripts": {
+ "build": "nuxi build",
+ "start": "nuxi preview"
+ }
+}
+```
+
+## Exclude Built Nitro Folder From Git
+
+Add the folder `.output` to the `.gitignore` file.
+
+## Ensure Everything Goes Well
+
+✔️ Try with `nuxi dev` and `nuxi build` (or `nuxi generate`) to see if everything goes well.
diff --git a/docs/6.bridge/9.vite.md b/docs/6.bridge/9.vite.md
new file mode 100644
index 000000000000..950de0eda0cc
--- /dev/null
+++ b/docs/6.bridge/9.vite.md
@@ -0,0 +1,37 @@
+---
+title: Vite
+description: 'Activate Vite to your Nuxt 2 application with Nuxt Bridge.'
+---
+
+::warning
+When using `vite`, [nitro](/docs/4.x/bridge/nitro) must have been configured.
+::
+
+## Remove Modules
+
+- Remove `nuxt-vite`: Bridge enables same functionality
+
+## Update Config
+
+```ts [nuxt.config.ts]
+import { defineNuxtConfig } from '@nuxt/bridge'
+
+export default defineNuxtConfig({
+ bridge: {
+ vite: true,
+ nitro: true,
+ },
+})
+```
+
+## Configuration
+
+```ts [nuxt.config.ts]
+import { defineNuxtConfig } from '@nuxt/bridge'
+
+export default defineNuxtConfig({
+ vite: {
+ // Config for Vite
+ },
+})
+```
diff --git a/docs/7.migration/.navigation.yml b/docs/7.migration/.navigation.yml
new file mode 100644
index 000000000000..be7c848b0d4d
--- /dev/null
+++ b/docs/7.migration/.navigation.yml
@@ -0,0 +1,3 @@
+title: 'Migrate to Nuxt 3'
+titleTemplate: 'Migrate to Nuxt 3: %s'
+icon: i-lucide-circle-arrow-up
diff --git a/docs/7.migration/1.overview.md b/docs/7.migration/1.overview.md
new file mode 100644
index 000000000000..05f4d17ce78a
--- /dev/null
+++ b/docs/7.migration/1.overview.md
@@ -0,0 +1,24 @@
+---
+title: Overview
+description: Nuxt 3 is a complete rewrite of Nuxt 2, and also based on a new set of underlying technologies.
+---
+
+There are significant changes when migrating a Nuxt 2 app to Nuxt 3, although you can expect migration to become more straightforward as we move toward a stable release.
+
+::note
+This migration guide is under progress to align with the development of Nuxt 3.
+::
+
+Some of these significant changes include:
+
+1. Moving from Vue 2 to Vue 3, including defaulting to the Composition API and script setup.
+1. Moving from webpack 4 and Babel to Vite or webpack 5 and esbuild.
+1. Moving from a runtime Nuxt dependency to a minimal, standalone server compiled with nitropack.
+
+::tip
+If you need to remain on Nuxt 2, but want to benefit from Nuxt 3 features in Nuxt 2, you can alternatively check out [how to get started with Bridge](/docs/4.x/bridge/overview).
+::
+
+## Next Steps
+
+- Learn about differences in [configuration](/docs/4.x/migration/configuration)
diff --git a/docs/7.migration/10.bundling.md b/docs/7.migration/10.bundling.md
new file mode 100644
index 000000000000..e817f71b776f
--- /dev/null
+++ b/docs/7.migration/10.bundling.md
@@ -0,0 +1,28 @@
+---
+title: Build Tooling
+description: 'Learn how to migrate from Nuxt 2 to Nuxt 3 build tooling.'
+---
+
+We use the following build tools by default:
+
+- [Vite](https://vite.dev) or [webpack](https://webpack.js.org)
+- [Rollup](https://rollupjs.org)
+- [PostCSS](https://postcss.org)
+- [esbuild](https://esbuild.github.io)
+
+For this reason, most of your previous `build` configuration in `nuxt.config` will now be ignored, including any custom babel configuration.
+
+If you need to configure any of Nuxt's build tools, you can do so in your `nuxt.config`, using the new top-level `vite`, `webpack` and `postcss` keys.
+
+In addition, Nuxt ships with TypeScript support.
+
+:read-more{to="/docs/4.x/guide/concepts/typescript"}
+
+## Steps
+
+1. Remove `@nuxt/typescript-build` and `@nuxt/typescript-runtime` from your dependencies and modules.
+2. Remove any unused babel dependencies from your project.
+3. Remove any explicit core-js dependencies.
+4. Migrate `require` to `import`.
+
+<!-- TODO: Enabling webpack builder -->
diff --git a/docs/7.migration/11.server.md b/docs/7.migration/11.server.md
new file mode 100644
index 000000000000..1b0bb4bbba51
--- /dev/null
+++ b/docs/7.migration/11.server.md
@@ -0,0 +1,17 @@
+---
+title: Server
+description: 'Learn how to migrate from Nuxt 2 to Nuxt 3 server.'
+---
+
+In a built Nuxt 3 application, there is no runtime Nuxt dependency. That means your site will be highly performant, and ultra-slim. But it also means you can no longer hook into runtime Nuxt server hooks.
+
+:read-more{to="/docs/4.x/guide/concepts/server-engine"}
+
+## Steps
+
+1. Remove the `render` key in your `nuxt.config`.
+2. Any files in `~~/server/api` and `~~/server/middleware` will be automatically registered; you can remove them from your `serverMiddleware` array.
+3. Update any other items in your `serverMiddleware` array to point to files or npm packages directly, rather than using inline functions.
+
+:read-more{to="/docs/4.x/directory-structure/server"}
+:read-more{to="/docs/4.x/guide/going-further/hooks#server-hooks-runtime"}
diff --git a/docs/7.migration/2.configuration.md b/docs/7.migration/2.configuration.md
new file mode 100644
index 000000000000..83b7e130442d
--- /dev/null
+++ b/docs/7.migration/2.configuration.md
@@ -0,0 +1,256 @@
+---
+title: Configuration
+description: 'Learn how to migrate from Nuxt 2 to Nuxt 3 new configuration.'
+---
+
+## `nuxt.config`
+
+The starting point for your Nuxt app remains your `nuxt.config` file.
+
+::note
+Nuxt configuration will be loaded using [`unjs/jiti`](https://github.com/unjs/jiti) and [`unjs/c12`](https://github.com/unjs/c12).
+::
+
+### Migration
+
+1. You should migrate to the new `defineNuxtConfig` function that provides a typed configuration schema.
+
+ ::code-group
+
+ ```ts [Nuxt 2]
+ export default {
+ // ...
+ }
+ ```
+
+ ```ts [Nuxt 3]
+ export default defineNuxtConfig({
+ // ...
+ })
+ ```
+
+ ::
+
+1. If you were using `router.extendRoutes` you can migrate to the new `pages:extend` hook:
+
+ ::code-group
+
+ ```ts [Nuxt 2]
+ export default {
+ router: {
+ extendRoutes (routes) {
+ //
+ },
+ },
+ }
+ ```
+
+ ```ts [Nuxt 3]
+ export default defineNuxtConfig({
+ hooks: {
+ 'pages:extend' (routes) {
+ //
+ },
+ },
+ })
+ ```
+
+ ::
+
+1. If you were using `router.routeNameSplitter` you can achieve same result by updating route name generation logic in the new `pages:extend` hook:
+
+ ::code-group
+
+ ```ts [Nuxt 2]
+ export default {
+ router: {
+ routeNameSplitter: '/',
+ },
+ }
+ ```
+
+ ```ts [Nuxt 3]
+ import { createResolver } from '@nuxt/kit'
+
+ export default defineNuxtConfig({
+ hooks: {
+ 'pages:extend' (routes) {
+ const routeNameSplitter = '/'
+ const root = createResolver(import.meta.url).resolve('./pages')
+
+ function updateName (routes) {
+ if (!routes) {
+ return
+ }
+
+ for (const route of routes) {
+ const relativePath = route.file.substring(root.length + 1)
+ route.name = relativePath.slice(0, -4).replace(/\/index$/, '').replace(/\//g, routeNameSplitter)
+
+ updateName(route.children)
+ }
+ }
+ updateName(routes)
+ },
+ },
+ })
+ ```
+
+ ::
+
+#### ESM Syntax
+
+Nuxt 3 is an [ESM native framework](/docs/4.x/guide/concepts/esm). Although [`unjs/jiti`](https://github.com/unjs/jiti) provides semi compatibility when loading `nuxt.config` file, avoid any usage of `require` and `module.exports` in this file.
+
+1. Change `module.exports` to `export default`
+1. Change `const lib = require('lib')` to `import lib from 'lib'`
+
+#### Async Configuration
+
+In order to make Nuxt loading behavior more predictable, async config syntax is deprecated. Consider using Nuxt hooks for async operations.
+
+#### Dotenv
+
+Nuxt has built-in support for loading `.env` files. Avoid directly importing it from `nuxt.config`.
+
+## Modules
+
+Nuxt and Nuxt modules are now build-time-only.
+
+### Migration
+
+1. Move all your `buildModules` into `modules`.
+2. Check for Nuxt 3 compatibility of modules.
+3. If you have any local modules pointing to a directory you should update this to point to the entry file:
+
+```diff
+ export default defineNuxtConfig({
+ modules: [
+- '~/modules/my-module'
++ '~/modules/my-module/index'
+ ]
+ })
+```
+
+::tip
+If you are a module author, you can check out [more information about module compatibility](/docs/4.x/migration/module-authors) and [our module author guide](/docs/4.x/guide/modules).
+::
+
+## Directory Changes
+
+The `static/` (for storing static assets) has been renamed to `public/`. You can either rename your `static` directory to `public`, or keep the name by setting `dir.public` in your `nuxt.config`.
+
+:read-more{to="/docs/4.x/directory-structure/public"}
+
+## TypeScript
+
+It will be much easier to migrate your application if you use Nuxt's TypeScript integration. This does not mean you need to write your application in TypeScript, just that Nuxt will provide automatic type hints for your editor.
+
+You can read more about Nuxt's TypeScript support [in the docs](/docs/4.x/guide/concepts/typescript).
+
+::note
+Nuxt can type-check your app using [`vue-tsc`](https://github.com/vuejs/language-tools/tree/master/packages/tsc) with `nuxt typecheck` command.
+::
+
+### Migration
+
+1. Create a `tsconfig.json` with the following content:
+
+ ```json
+ {
+ "files": [],
+ "references": [
+ {
+ "path": "./.nuxt/tsconfig.app.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.server.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.shared.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.node.json"
+ }
+ ]
+ }
+ ```
+
+1. Run `npx nuxt prepare` to generate the tsconfig files.
+1. Install Volar following the instructions in the [docs](/docs/4.x/getting-started/installation#prerequisites).
+
+## Vue Changes
+
+There are a number of changes to what is recommended Vue best practice, as well as a number of breaking changes between Vue 2 and 3.
+
+It is recommended to read the [Vue 3 migration guide](https://v3-migration.vuejs.org) and in particular the [breaking changes list](https://v3-migration.vuejs.org/breaking-changes/).
+
+It is not currently possible to use the [Vue 3 migration build](https://v3-migration.vuejs.org/migration-build.html) with Nuxt 3.
+
+## Vuex
+
+Nuxt no longer provides a Vuex integration. Instead, the official Vue recommendation is to use `pinia`, which has built-in Nuxt support via a [Nuxt module](https://pinia.vuejs.org/ssr/nuxt.html). [Find out more about pinia here](https://pinia.vuejs.org).
+
+A simple way to provide global state management with pinia would be:
+
+Install the [`@pinia/nuxt`](/modules/pinia) module:
+
+```bash [Terminal]
+yarn add pinia @pinia/nuxt
+```
+
+Enable the module in your nuxt configuration:
+
+```ts [nuxt.config.ts]
+import { defineNuxtConfig } from 'nuxt/config'
+
+export default defineNuxtConfig({
+ modules: ['@pinia/nuxt'],
+})
+```
+
+Create a `store` folder at the root of your application:
+
+```ts [store/index.ts]
+import { defineStore } from 'pinia'
+
+export const useMainStore = defineStore('main', {
+ state: () => ({
+ counter: 0,
+ }),
+ actions: {
+ increment () {
+ // `this` is the store instance
+ this.counter++
+ },
+ },
+})
+```
+
+Create a [plugin](/docs/4.x/directory-structure/app/plugins) file to globalize your store:
+
+```ts [app/plugins/pinia.ts]
+import { useMainStore } from '~/store'
+
+export default defineNuxtPlugin(({ $pinia }) => {
+ return {
+ provide: {
+ store: useMainStore($pinia),
+ },
+ }
+})
+```
+
+If you want to keep using Vuex, you can manually migrate to Vuex 4 following [these steps](https://vuex.vuejs.org/guide/migrating-to-4-0-from-3-x.html).
+
+Once it's done you will need to add the following plugin to your Nuxt app:
+
+```ts [app/plugins/vuex.ts]
+import store from '~/store'
+
+export default defineNuxtPlugin((nuxtApp) => {
+ nuxtApp.vueApp.use(store)
+})
+```
+
+For larger apps, this migration can entail a lot of work. If updating Vuex still creates roadblocks, you may want to use the community module: [nuxt3-vuex-module](https://github.com/vedmant/nuxt3-vuex#nuxt3-vuex-module), which should work out of the box.
diff --git a/docs/7.migration/20.module-authors.md b/docs/7.migration/20.module-authors.md
new file mode 100644
index 000000000000..1a3b47d45e03
--- /dev/null
+++ b/docs/7.migration/20.module-authors.md
@@ -0,0 +1,94 @@
+---
+title: Modules
+description: 'Learn how to migrate from Nuxt 2 to Nuxt 3 modules.'
+---
+
+## Module Compatibility
+
+Nuxt 3 has a basic backward compatibility layer for Nuxt 2 modules using `@nuxt/kit` auto wrappers. But there are usually steps to follow to make modules compatible with Nuxt 3 and sometimes, using Nuxt Bridge is required for cross-version compatibility.
+
+We have prepared a [Dedicated Guide](/docs/4.x/guide/modules) for authoring Nuxt 3 ready modules using `@nuxt/kit`. Currently best migration path is to follow it and rewrite your modules. Rest of this guide includes preparation steps if you prefer to avoid a full rewrite yet making modules compatible with Nuxt 3.
+
+::tip{icon="i-lucide-puzzle" to="/modules"}
+Explore Nuxt 3 compatible modules.
+::
+
+### Plugin Compatibility
+
+Nuxt 3 plugins are **not** fully backward compatible with Nuxt 2.
+
+:read-more{to="/docs/4.x/directory-structure/app/plugins"}
+
+### Vue Compatibility
+
+Plugins or components using the Composition API need exclusive Vue 2 or Vue 3 support.
+
+By using [vue-demi](https://github.com/vueuse/vue-demi) they should be compatible with both Nuxt 2 and 3.
+
+## Module Migration
+
+When Nuxt 3 users add your module, you will not have access to the module container (`this.*`) so you will need to use utilities from `@nuxt/kit` to access the container functionality.
+
+### Test with `@nuxt/bridge`
+
+Migrating to `@nuxt/bridge` is the first and most important step for supporting Nuxt 3.
+
+If you have a fixture or example in your module, add `@nuxt/bridge` package to its config (see [example](/docs/4.x/bridge/overview#update-nuxtconfig))
+
+### Migrate from CommonJS to ESM
+
+Nuxt 3 natively supports TypeScript and ECMAScript Modules. Please check [Native ES Modules](/docs/4.x/guide/concepts/esm) for more info and upgrading.
+
+### Ensure Plugins Default Export
+
+If you inject a Nuxt plugin that does not have `export default` (such as global Vue plugins), ensure you add `export default () => { }` to the end of it.
+
+::code-group
+
+```js [Before]
+// ~/plugins/vuelidate.js
+import Vue from 'vue'
+import Vuelidate from 'vuelidate'
+
+Vue.use(Vuelidate)
+```
+
+```js [After]
+// ~/plugins/vuelidate.js
+import Vue from 'vue'
+import Vuelidate from 'vuelidate'
+
+Vue.use(Vuelidate)
+
+export default () => { }
+```
+
+::
+
+### Avoid Runtime Modules
+
+With Nuxt 3, Nuxt is now a build-time-only dependency, which means that modules shouldn't attempt to hook into the Nuxt runtime.
+
+Your module should work even if it's only added to [`buildModules`](/docs/4.x/api/nuxt-config#runtimeconfig) (instead of `modules`). For example:
+
+- Avoid updating `process.env` within a Nuxt module and reading by a Nuxt plugin; use [`runtimeConfig`](/docs/4.x/api/nuxt-config#runtimeconfig) instead.
+- (*) Avoid depending on runtime hooks like `vue-renderer:*` for production
+- (*) Avoid adding `serverMiddleware` by importing them inside the module. Instead, add them by referencing a file path so that they are independent of the module's context
+
+(*) Unless it is for `nuxt dev` purpose only and guarded with `if (nuxt.options.dev) { }`.
+
+::tip
+Continue reading about Nuxt 3 modules in the [Modules Author Guide](/docs/4.x/guide/modules).
+::
+
+### Use TypeScript (Optional)
+
+While it is not essential, most of the Nuxt ecosystem is shifting to use TypeScript, so it is highly recommended to consider migration.
+
+::tip
+You can start migration by renaming `.js` files, to `.ts`. TypeScript is designed to be progressive!
+::
+
+::tip
+You can use TypeScript syntax for Nuxt 2 and 3 modules and plugins without any extra dependencies.
+::
diff --git a/docs/7.migration/3.auto-imports.md b/docs/7.migration/3.auto-imports.md
new file mode 100644
index 000000000000..d4611ed91bb0
--- /dev/null
+++ b/docs/7.migration/3.auto-imports.md
@@ -0,0 +1,18 @@
+---
+title: Auto Imports
+description: Nuxt 3 adopts a minimal friction approach, meaning wherever possible components and composables are auto-imported.
+---
+
+::note
+In the rest of the migration documentation, you will notice that key Nuxt and Vue utilities do not have explicit imports. This is not a typo; Nuxt will automatically import them for you, and you should get full type hinting if you have followed [the instructions](/docs/4.x/migration/configuration#typescript) to use Nuxt's TypeScript support.
+::
+
+[Read more about auto imports](/docs/4.x/guide/concepts/auto-imports)
+
+## Migration
+
+1. If you have been using `@nuxt/components` in Nuxt 2, you can remove `components: true` in your `nuxt.config`. If you had a more complex setup, then note that the component options have changed somewhat. See the [components documentation](/docs/4.x/directory-structure/app/components) for more information.
+
+::tip
+You can look at `.nuxt/types/components.d.ts` and `.nuxt/types/imports.d.ts` to see how Nuxt has resolved your components and composable auto-imports.
+::
diff --git a/docs/7.migration/4.meta.md b/docs/7.migration/4.meta.md
new file mode 100644
index 000000000000..02408379d80b
--- /dev/null
+++ b/docs/7.migration/4.meta.md
@@ -0,0 +1,130 @@
+---
+title: Meta Tags
+description: Manage your meta tags, from Nuxt 2 to Nuxt 3.
+---
+
+Nuxt 3 provides several different ways to manage your meta tags:
+1. Through your `nuxt.config`.
+2. Through the [`useHead`](/docs/4.x/api/composables/use-head) [composable](/docs/4.x/getting-started/seo-meta)
+3. Through [global meta components](/docs/4.x/getting-started/seo-meta)
+
+You can customize `title`, `titleTemplate`, `base`, `script`, `noscript`, `style`, `meta`, `link`, `htmlAttrs` and `bodyAttrs`.
+
+::tip
+Nuxt currently uses [`Unhead`](https://github.com/unjs/unhead) to manage your meta tags, but implementation details may change.
+::
+
+:read-more{to="/docs/4.x/getting-started/seo-meta"}
+
+## Migration
+
+1. In your `nuxt.config`, rename `head` to `meta`. Consider moving this shared meta configuration into your `app.vue` instead. (Note that objects no longer have a `hid` key for deduplication.)
+2. If you need to access the component state with `head`, you should migrate to using [`useHead`](/docs/4.x/api/composables/use-head) . You might also consider using the built-in meta-components.
+3. If you need to use the Options API, there is a `head()` method you can use when you use `defineNuxtComponent`.
+
+### useHead
+
+::code-group
+
+```vue [Nuxt 2]
+<script>
+export default {
+ data: () => ({
+ title: 'My App',
+ description: 'My App Description',
+ }),
+ head () {
+ return {
+ title: this.title,
+ meta: [{
+ hid: 'description',
+ name: 'description',
+ content: this.description,
+ }],
+ }
+ },
+}
+</script>
+```
+
+```vue [Nuxt 3]
+<script setup lang="ts">
+const title = ref('My App')
+const description = ref('My App Description')
+
+// This will be reactive when you change title/description above
+useHead({
+ title,
+ meta: [{
+ name: 'description',
+ content: description,
+ }],
+})
+</script>
+```
+
+::
+
+### Meta-components
+
+Nuxt 3 also provides meta components that you can use to accomplish the same task. While these components look similar to HTML tags, they are provided by Nuxt and have similar functionality.
+
+::code-group
+
+```vue [Nuxt 2]
+<script>
+export default {
+ head () {
+ return {
+ title: 'My App',
+ meta: [{
+ hid: 'description',
+ name: 'description',
+ content: 'My App Description',
+ }],
+ }
+ },
+}
+</script>
+```
+
+```vue [Nuxt 3]
+<template>
+ <div>
+ <Head>
+ <Title>My App
+
+
+```
+
+::
+
+::important
+1. Make sure you use capital letters for these component names to distinguish them from native HTML elements (`
` rather than `<title>`).
+2. You can place these components anywhere in your template for your page.
+::
+
+### Options API
+
+```vue [Nuxt 3 (Options API)]
+<script>
+// if using options API `head` method you must use `defineNuxtComponent`
+export default defineNuxtComponent({
+ head (nuxtApp) {
+ // `head` receives the nuxt app but cannot access the component instance
+ return {
+ meta: [{
+ name: 'description',
+ content: 'This is my page description.',
+ }],
+ }
+ },
+})
+</script>
+```
diff --git a/docs/7.migration/5.plugins-and-middleware.md b/docs/7.migration/5.plugins-and-middleware.md
new file mode 100644
index 000000000000..d39473bdde9f
--- /dev/null
+++ b/docs/7.migration/5.plugins-and-middleware.md
@@ -0,0 +1,80 @@
+---
+title: Plugins and Middleware
+description: 'Learn how to migrate from Nuxt 2 to Nuxt 3 plugins and middleware.'
+---
+
+## Plugins
+
+Plugins now have a different format, and take only one argument (`nuxtApp`).
+
+::code-group
+
+```ts [Nuxt 2]
+export default (ctx, inject) => {
+ inject('injected', () => 'my injected function')
+}
+```
+
+```ts [Nuxt 3]
+export default defineNuxtPlugin((nuxtApp) => {
+ // now available on `nuxtApp.$injected`
+ nuxtApp.provide('injected', () => 'my injected function')
+
+ // You can alternatively use this format, which comes with automatic type support
+ return {
+ provide: {
+ injected: () => 'my injected function',
+ },
+ }
+})
+```
+
+::
+
+:read-more{to="/docs/4.x/directory-structure/app/plugins"}
+
+::read-more{to="/docs/4.x/api/composables/use-nuxt-app"}
+Read more about the format of `nuxtApp`.
+::
+
+### Migration
+
+1. Migrate your plugins to use the `defineNuxtPlugin` helper function.
+2. Remove any entries in your `nuxt.config` plugins array that are located in your `app/plugins/` folder. All files in this directory at the top level (and any index files in any subdirectories) will be automatically registered. Instead of setting `mode` to `client` or `server`, you can indicate this in the file name. For example, `~/plugins/my-plugin.client.ts` will only be loaded on client-side.
+
+## Route Middleware
+
+Route middleware has a different format.
+
+::code-group
+
+```js [Nuxt 2]
+export default function ({ store, redirect }) {
+ // If the user is not authenticated
+ if (!store.state.authenticated) {
+ return redirect('/login')
+ }
+}
+```
+
+```ts [Nuxt 3]
+export default defineNuxtRouteMiddleware((to, from) => {
+ const auth = useState('auth')
+ if (!auth.value.authenticated) {
+ return navigateTo('/login')
+ }
+})
+```
+
+::
+
+Much like Nuxt 2, route middleware placed in your `~/middleware` folder is automatically registered. You can then specify it by name in a component. However, this is done with `definePageMeta` rather than as a component option.
+
+`navigateTo` is one of a number of route helper functions.
+
+:read-more{to="/docs/4.x/directory-structure/app/middleware"}
+
+### Migration
+
+1. Migrate your route middleware to use the `defineNuxtRouteMiddleware` helper function.
+1. Any global middleware (such as in your `nuxt.config`) can be placed in your `~/middleware` folder with a `.global` extension, for example `~/middleware/auth.global.ts`.
diff --git a/docs/7.migration/6.pages-and-layouts.md b/docs/7.migration/6.pages-and-layouts.md
new file mode 100644
index 000000000000..4ff8bd1fbb0d
--- /dev/null
+++ b/docs/7.migration/6.pages-and-layouts.md
@@ -0,0 +1,237 @@
+---
+title: Pages and Layouts
+description: Learn how to migrate from Nuxt 2 to Nuxt 3 pages and layouts.
+---
+
+## `app.vue`
+
+Nuxt 3 provides a central entry point to your app via `~/app.vue`.
+
+::note
+If you don't have an `app.vue` file in your source directory, Nuxt will use its own default version.
+::
+
+This file is a great place to put any custom code that needs to be run once when your app starts up, as well as any components that are present on every page of your app. For example, if you only have one layout, you can move this to `app.vue` instead.
+
+:read-more{to="/docs/4.x/directory-structure/app/app"}
+
+:link-example{to="/docs/4.x/examples/hello-world"}
+
+### Migration
+
+Consider creating an `app.vue` file and including any logic that needs to run once at the top-level of your app. You can check out [an example here](/docs/4.x/directory-structure/app/app).
+
+## Layouts
+
+If you are using layouts in your app for multiple pages, there is only a slight change required.
+
+In Nuxt 2, the `<Nuxt>` component is used within a layout to render the current page. In Nuxt 3, layouts use slots instead, so you will have to replace that component with a `<slot />`. This also allows advanced use cases with named and scoped slots. [Read more about layouts](/docs/4.x/directory-structure/app/layouts).
+
+You will also need to change how you define the layout used by a page using the `definePageMeta` compiler macro. Layouts will be kebab-cased. So `app/layouts/customLayout.vue` becomes `custom-layout` when referenced in your page.
+
+### Migration
+
+1. Replace `<Nuxt />` with `<slot />`
+ ```diff [app/layouts/custom.vue]
+ <template>
+ <div id="app-layout">
+ <main>
+ - <Nuxt />
+ + <slot />
+ </main>
+ </div>
+ </template>
+ ```
+2. Use [`definePageMeta`](/docs/4.x/api/utils/define-page-meta) to select the layout used by your page.
+ ```diff [app/pages/index.vue]
+ + <script setup>
+ + definePageMeta({
+ + layout: 'custom'
+ + })
+ - <script>
+ - export default {
+ - layout: 'custom'
+ - }
+ </script>
+ ```
+3. Move `~/layouts/_error.vue` to `~/error.vue`. See [the error handling docs](/docs/4.x/getting-started/error-handling). If you want to ensure that this page uses a layout, you can use [`<NuxtLayout>`](/docs/4.x/directory-structure/app/layouts) directly within `error.vue`:
+ ```vue [error.vue]
+ <template>
+ <div>
+ <NuxtLayout name="default">
+ <!-- -->
+ </NuxtLayout>
+ </div>
+ </template>
+ ```
+
+## Pages
+
+Nuxt 3 ships with an optional `vue-router` integration triggered by the existence of a [`app/pages/`](/docs/4.x/directory-structure/app/pages) directory in your source directory. If you only have a single page, you may consider instead moving it to `app.vue` for a lighter build.
+
+### Dynamic Routes
+
+The format for defining dynamic routes in Nuxt 3 is slightly different from Nuxt 2, so you may need to rename some of the files within `app/pages/`.
+
+1. Where you previously used `_id` to define a dynamic route parameter you now use `[id]`.
+2. Where you previously used `_.vue` to define a catch-all route, you now use `[...slug].vue`.
+
+### Nested Routes
+
+In Nuxt 2, you will have defined any nested routes (with parent and child components) using `<Nuxt>` and `<NuxtChild>`. In Nuxt 3, these have been replaced with a single `<NuxtPage>` component.
+
+### Page Keys and Keep-alive Props
+
+If you were passing a custom page key or keep-alive props to `<Nuxt>`, you will now use `definePageMeta` to set these options.
+
+:read-more{to="/docs/4.x/directory-structure/app/pages#special-metadata"}
+
+### Page and Layout Transitions
+
+If you have been defining transitions for your page or layout directly in your component options, you will now need to use `definePageMeta` to set the transition. Since Vue 3, [-enter and -leave CSS classes have been renamed](https://v3-migration.vuejs.org/breaking-changes/transition.html). The `style` prop from `<Nuxt>` no longer applies to transition when used on `<slot>`, so move the styles to your `-active` class.
+
+:read-more{to="/docs/4.x/getting-started/transitions"}
+
+### Migration
+
+1. Rename any pages with dynamic parameters to match the new format.
+2. Update `<Nuxt>` and `<NuxtChild>` to be `<NuxtPage>`.
+3. If you're using the Composition API, you can also migrate `this.$route` and `this.$router` to use [`useRoute`](/docs/4.x/api/composables/use-route) and [`useRouter`](/docs/4.x/api/composables/use-router) composables.
+
+#### Example: Dynamic Routes
+
+::code-group
+
+``` [Nuxt 2]
+- URL: /users
+- Page: /pages/users/index.vue
+
+- URL: /users/some-user-name
+- Page: /pages/users/_user.vue
+- Usage: params.user
+
+- URL: /users/some-user-name/edit
+- Page: /pages/users/_user/edit.vue
+- Usage: params.user
+
+- URL: /users/anything-else
+- Page: /pages/users/_.vue
+- Usage: params.pathMatch
+```
+
+``` [Nuxt 3]
+- URL: /users
+- Page: /pages/users/index.vue
+
+- URL: /users/some-user-name
+- Page: /pages/users/[user].vue
+- Usage: params.user
+
+- URL: /users/some-user-name/edit
+- Page: /pages/users/[user]/edit.vue
+- Usage: params.user
+
+- URL: /users/anything-else
+- Page: /pages/users/[...slug].vue
+- Usage: params.slug
+```
+
+::
+
+#### Example: Nested Routes and `definePageMeta`
+
+::code-group
+
+```vue [Nuxt 2]
+<template>
+ <div>
+ <NuxtChild
+ keep-alive
+ :keep-alive-props="{ exclude: ['modal'] }"
+ :nuxt-child-key="$route.slug"
+ />
+ </div>
+</template>
+
+<script>
+export default {
+ transition: 'page', // or { name: 'page' }
+}
+</script>
+```
+
+```vue [Nuxt 3]
+<template>
+ <div>
+ <NuxtPage />
+ </div>
+</template>
+
+<script setup lang="ts">
+// This compiler macro works in both <script> and <script setup>
+definePageMeta({
+ // you can also pass a string or a computed property
+ key: route => route.slug,
+ transition: {
+ name: 'page',
+ },
+ keepalive: {
+ exclude: ['modal'],
+ },
+})
+</script>
+```
+
+::
+
+## `<NuxtLink>` Component
+
+Most of the syntax and functionality are the same for the global [NuxtLink](/docs/4.x/api/components/nuxt-link) component. If you have been using the shortcut `<NLink>` format, you should update this to use `<NuxtLink>`.
+
+`<NuxtLink>` is now a drop-in replacement for _all_ links, even external ones. You can read more about it, and how to extend it to provide your own link component.
+
+:read-more{to="/docs/4.x/api/components/nuxt-link"}
+
+## Programmatic Navigation
+
+When migrating from Nuxt 2 to Nuxt 3, you will have to update how you programmatically navigate your users. In Nuxt 2, you had access to the underlying Vue Router with `this.$router`. In Nuxt 3, you can use the `navigateTo()` utility method which allows you to pass a route and parameters to Vue Router.
+
+::warning
+Make sure to always `await` on [`navigateTo`](/docs/4.x/api/utils/navigate-to) or chain its result by returning from functions.
+::
+
+::code-group
+
+```vue [Nuxt 2]
+<script>
+export default {
+ methods: {
+ navigate () {
+ this.$router.push({
+ path: '/search',
+ query: {
+ name: 'first name',
+ type: '1',
+ },
+ })
+ },
+ },
+}
+</script>
+```
+
+```vue [Nuxt 3]
+<script setup lang="ts">
+function navigate () {
+ return navigateTo({
+ path: '/search',
+ query: {
+ name: 'first name',
+ type: '1',
+ },
+ })
+}
+</script>
+```
+
+::
diff --git a/docs/7.migration/7.component-options.md b/docs/7.migration/7.component-options.md
new file mode 100644
index 000000000000..cbe22fb8e286
--- /dev/null
+++ b/docs/7.migration/7.component-options.md
@@ -0,0 +1,156 @@
+---
+title: Component Options
+description: 'Learn how to migrate from Nuxt 2 components options to Nuxt 3 composables.'
+---
+
+## `asyncData` and `fetch`
+
+Nuxt 3 provides new options for [fetching data from an API](/docs/4.x/getting-started/data-fetching).
+
+<!-- TODO: Intro to <script setup> -->
+<!-- TODO: Mention about options compatibility with asyncData -->
+
+### Isomorphic Fetch
+
+In Nuxt 2 you might use `@nuxtjs/axios` or `@nuxt/http` to fetch your data - or just the polyfilled global `fetch`.
+
+In Nuxt 3 you can use a globally available `fetch` method that has the same API as [the Fetch API](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API/Using_Fetch) or [`$fetch`](/docs/4.x/api/utils/dollarfetch) method which is using [unjs/ofetch](https://github.com/unjs/ofetch). It has a number of benefits, including:
+
+1. It will handle 'smartly' making [direct API calls](/docs/4.x/guide/concepts/server-engine#direct-api-calls) if it's running on the server, or making a client-side call to your API if it's running on the client. (It can also handle calling third-party APIs.)
+
+2. Plus, it comes with convenience features including automatically parsing responses and stringifying data.
+
+You can read more [about direct API calls](/docs/4.x/guide/concepts/server-engine#direct-api-calls) or [fetching data](/docs/4.x/getting-started/data-fetching).
+
+### Composables
+
+Nuxt 3 provides new composables for fetching data: [`useAsyncData`](/docs/4.x/api/composables/use-async-data) and `useFetch`. They each have 'lazy' variants (`useLazyAsyncData` and `useLazyFetch`), which do not block client-side navigation.
+
+In Nuxt 2, you'd fetch your data in your component using a syntax similar to:
+
+```ts
+export default {
+ async asyncData ({ params, $http }) {
+ const post = await $http.$get(`https://api.nuxtjs.dev/posts/${params.id}`)
+ return { post }
+ },
+ // or alternatively
+ fetch () {
+ this.post = await $http.$get(`https://api.nuxtjs.dev/posts/${params.id}`)
+ },
+}
+```
+
+Within your methods and templates, you could use the `post` variable similar how you'd use any other piece of data provided by your component.
+
+With Nuxt 3, you can perform this data fetching using composables in your `setup()` method or `<script setup>` tag:
+
+```vue
+<script setup lang="ts">
+// Define params wherever, through `defineProps()`, `useRoute()`, etc.
+const { data: post, refresh } = await useAsyncData('post', () => $fetch(`https://api.nuxtjs.dev/posts/${params.id}`))
+// Or instead - useFetch is a convenience wrapper around useAsyncData when you're just performing a simple fetch
+const { data: post, refresh } = await useFetch(`https://api.nuxtjs.dev/posts/${params.id}`)
+</script>
+```
+
+You can now use `post` inside of your Nuxt 3 template, or call `refresh` to update the data.
+
+::note
+Despite the names, [`useFetch`](/docs/4.x/api/composables/use-fetch) is not a direct replacement of the `fetch()` hook. Rather, [`useAsyncData`](/docs/4.x/api/composables/use-async-data) replaces both hooks and is more customizable; it can do more than simply fetching data from an endpoint. [`useFetch`](/docs/4.x/api/composables/use-fetch) is a convenience wrapper around [`useAsyncData`](/docs/4.x/api/composables/use-async-data) for simply fetching data from an endpoint.
+::
+
+### Migration
+
+1. Replace the `asyncData` hook with [`useAsyncData`](/docs/4.x/api/composables/use-async-data) or [`useFetch`](/docs/4.x/api/composables/use-fetch) in your page/component.
+2. Replace the `fetch` hook with [`useAsyncData`](/docs/4.x/api/composables/use-async-data) or [`useFetch`](/docs/4.x/api/composables/use-fetch) in your component.
+
+## `head`
+
+:read-more{to="/docs/4.x/migration/meta"}
+
+## `key`
+
+You can now define a key within the [`definePageMeta`](/docs/4.x/api/utils/define-page-meta) compiler macro.
+
+```diff [app/pages/index.vue]
+- <script>
+- export default {
+- key: 'index'
+- // or a method
+- // key: route => route.fullPath
+- }
++ <script setup>
++ definePageMeta({
++ key: 'index'
++ // or a method
++ // key: route => route.fullPath
++ })
+</script>
+```
+
+## `layout`
+
+:read-more{to="/docs/4.x/migration/pages-and-layouts"}
+
+## `loading`
+
+This feature is not yet supported in Nuxt 3.
+
+## `middleware`
+
+:read-more{to="/docs/4.x/migration/plugins-and-middleware"}
+
+## `scrollToTop`
+
+This feature is not yet supported in Nuxt 3. If you want to overwrite the default scroll behavior of `vue-router`, you can do so in an `~/router.options.ts` (see [docs](/docs/4.x/guide/recipes/custom-routing#router-options)) for more info.
+Similar to `key`, specify it within the [`definePageMeta`](/docs/4.x/api/utils/define-page-meta) compiler macro.
+
+```diff [app/pages/index.vue]
+- <script>
+- export default {
+- scrollToTop: false
+- }
++ <script setup>
++ definePageMeta({
++ scrollToTop: false
++ })
+</script>
+```
+
+## `transition`
+
+:read-more{to="/docs/4.x/getting-started/transitions"}
+
+## `validate`
+
+The validate hook in Nuxt 3 only accepts a single argument, the `route`. Just as in Nuxt 2, you can return a boolean value. If you return false and another match can't be found, this will mean a 404. You can also directly return an object with `status`/`statusText` to respond immediately with an error (other matches will not be checked).
+
+```diff [app/pages/users/[id\\].vue]
+- <script>
+- export default {
+- async validate({ params }) {
+- return /^\d+$/.test(params.id)
+- }
+- }
++ <script setup>
++ definePageMeta({
++ validate: async (route) => {
++ const nuxtApp = useNuxtApp()
++ return /^\d+$/.test(route.params.id)
++ }
++ })
+ </script>
+```
+
+## `watchQuery`
+
+This is not supported in Nuxt 3. Instead, you can directly use a watcher to trigger refetching data.
+
+```vue [app/pages/users/[id\\].vue]
+<script setup lang="ts">
+const route = useRoute()
+const { data, refresh } = await useFetch('/api/user')
+watch(() => route.query, () => refresh())
+</script>
+```
diff --git a/docs/7.migration/8.runtime-config.md b/docs/7.migration/8.runtime-config.md
new file mode 100644
index 000000000000..ee1d023ed11f
--- /dev/null
+++ b/docs/7.migration/8.runtime-config.md
@@ -0,0 +1,58 @@
+---
+title: Runtime Config
+description: 'Learn how to migrate from Nuxt 2 to Nuxt 3 runtime config.'
+---
+
+If you wish to reference environment variables within your Nuxt 3 app, you will need to use runtime config.
+
+When referencing these variables within your components, you will have to use the [`useRuntimeConfig`](/docs/4.x/api/composables/use-runtime-config) composable in your setup method (or Nuxt plugin).
+
+In the `server/` portion of your app, you can use [`useRuntimeConfig`](/docs/4.x/api/composables/use-runtime-config) without any import.
+
+:read-more{to="/docs/4.x/guide/going-further/runtime-config"}
+
+## Migration
+
+1. Add any environment variables that you use in your app to the `runtimeConfig` property of the `nuxt.config` file.
+2. Migrate `process.env` to [`useRuntimeConfig`](/docs/4.x/api/composables/use-runtime-config) throughout the Vue part of your app.
+
+::code-group
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+ runtimeConfig: {
+ // Private config that is only available on the server
+ apiSecret: '123',
+ // Config within public will be also exposed to the client
+ public: {
+ apiBase: '/api',
+ },
+ },
+})
+```
+
+```vue [app/pages/index.vue]
+<script setup lang="ts">
+const config = useRuntimeConfig()
+
+// instead of process.env you will now access config.public.apiBase
+console.log(config.public.apiBase)
+</script>
+```
+
+```ts [server/api/hello.ts]
+export default defineEventhandler((event) => {
+ const config = useRuntimeConfig()
+ // In server, you can now access config.apiSecret, in addition to config.public
+ console.log(config.apiSecret)
+ console.log(config.public.apiBase)
+})
+```
+
+```ini [.env]
+# Runtime config values are automatically replaced by matching environment variables at runtime
+NUXT_API_SECRET=api_secret_token
+NUXT_PUBLIC_API_BASE=https://nuxtjs.org
+```
+
+::
diff --git a/docs/README.md b/docs/README.md
new file mode 100644
index 000000000000..6f7943cf7c2b
--- /dev/null
+++ b/docs/README.md
@@ -0,0 +1,11 @@
+---
+navigation: false
+---
+
+# Nuxt Docs
+
+This repository contains the documentation of Nuxt, hosted on <https://nuxt.com/docs/4.x/getting-started/introduction>
+
+## Contributing
+
+Have a look at <https://github.com/nuxt/nuxt.com> to run the website locally.
diff --git a/docs/package.json b/docs/package.json
new file mode 100644
index 000000000000..c11a4924e04d
--- /dev/null
+++ b/docs/package.json
@@ -0,0 +1,20 @@
+{
+ "name": "@nuxt/docs",
+ "version": "4.3.1",
+ "repository": {
+ "type": "git",
+ "url": "git+https://github.com/nuxt/nuxt.git",
+ "directory": "docs"
+ },
+ "homepage": "https://nuxt.com",
+ "description": "Documentation for Nuxt in raw markdown",
+ "license": "MIT",
+ "type": "module",
+ "exports": {
+ "./*": "./*"
+ },
+ "files": [
+ "**/*.md",
+ "**/*.yml"
+ ]
+}
diff --git a/eslint.config.mjs b/eslint.config.mjs
new file mode 100644
index 000000000000..e7f5d059d8cb
--- /dev/null
+++ b/eslint.config.mjs
@@ -0,0 +1,341 @@
+// @ts-check
+import { createConfigForNuxt } from '@nuxt/eslint-config/flat'
+// @ts-expect-error missing types
+import noOnlyTests from 'eslint-plugin-no-only-tests'
+import typegen from 'eslint-typegen'
+import perfectionist from 'eslint-plugin-perfectionist'
+import { importX } from 'eslint-plugin-import-x'
+import parser from '@typescript-eslint/parser'
+import markdown from '@eslint/markdown'
+import { runtimeDependencies } from 'nuxt/meta'
+
+export default createConfigForNuxt({
+ features: {
+ stylistic: {
+ commaDangle: 'always-multiline',
+ },
+ tooling: true,
+ typescript: true,
+ },
+})
+ .prepend(
+ {
+ // Ignores have to be a separate object to be treated as global ignores
+ // Don't add other attributes to this object
+ ignores: [
+ '.goff/**',
+ 'packages/schema/schema/**',
+ 'packages/nuxt/stubs/**',
+ 'packages/nuxt/src/app/components/welcome.vue',
+ 'packages/nuxt/src/app/components/error-*.vue',
+ 'packages/nuxt/src/core/runtime/nitro/templates/error-*',
+ 'packages/nitro-server/src/runtime/templates/error-*',
+ ],
+ },
+ {
+ languageOptions: {
+ globals: {
+ $fetch: 'readonly',
+ NodeJS: 'readonly',
+ },
+ },
+ name: 'local/settings',
+ settings: {
+ jsdoc: {
+ ignoreInternal: true,
+ tagNamePreference: {
+ note: 'note',
+ warning: 'warning',
+ },
+ },
+ },
+ },
+ )
+
+ .override('nuxt/javascript', {
+ rules: {
+ 'curly': ['error', 'all'], // Including if blocks with a single statement
+ 'dot-notation': 'error',
+ 'logical-assignment-operators': ['error', 'always', { enforceForIfStatements: true }],
+ 'no-console': ['warn', { allow: ['warn', 'error', 'debug'] }],
+ 'no-lonely-if': 'error', // No single if in an "else" block
+ 'no-useless-rename': 'error',
+ 'object-shorthand': 'error',
+ 'prefer-const': ['error', { destructuring: 'any', ignoreReadBeforeAssign: false }],
+ 'require-await': 'error',
+ 'sort-imports': ['error', { ignoreDeclarationSort: true }],
+ },
+ })
+
+ .override('nuxt/typescript/rules', {
+ rules: {
+ '@typescript-eslint/ban-ts-comment': [
+ 'error',
+ {
+ 'ts-expect-error': 'allow-with-description',
+ 'ts-ignore': true,
+ },
+ ],
+ '@typescript-eslint/no-dynamic-delete': 'off',
+ '@typescript-eslint/no-unused-vars': [
+ 'error',
+ {
+ argsIgnorePattern: '^_',
+ destructuredArrayIgnorePattern: '^_',
+ ignoreRestSiblings: true,
+ varsIgnorePattern: '',
+ },
+ ],
+ '@typescript-eslint/triple-slash-reference': 'off',
+ '@typescript-eslint/unified-signatures': 'off',
+ ...{
+ // TODO: Discuss if we want to enable this
+ '@typescript-eslint/ban-types': 'off',
+ // TODO: Discuss if we want to enable this
+ '@typescript-eslint/no-explicit-any': 'off',
+ // TODO: Discuss if we want to enable this
+ '@typescript-eslint/no-invalid-void-type': 'off',
+ },
+ },
+ })
+
+ .append({
+ files: ['packages/**/*.{mjs,js,ts}', '**/*.{spec,test}.{mjs,js,ts}'],
+ ignores: [
+ 'packages/nuxt/src/app/types/augments.ts',
+ 'test/fixtures/basic/app/plugins/this-should-not-load.spec.js',
+ ],
+ languageOptions: {
+ parser,
+ parserOptions: {
+ projectService: true,
+ tsconfigRootDir: import.meta.dirname,
+ },
+ },
+ rules: {
+ '@typescript-eslint/no-deprecated': 'error',
+ '@typescript-eslint/return-await': ['error', 'in-try-catch'],
+ 'no-return-await': 'off',
+ },
+ })
+
+ .override('nuxt/tooling/unicorn', {
+ rules: {
+ 'unicorn/no-new-array': 'off',
+ 'unicorn/prefer-dom-node-text-content': 'off',
+ },
+ })
+
+ .override('nuxt/vue/rules', {
+ rules: {
+
+ },
+ })
+
+ // Stylistic rules
+ .override('nuxt/stylistic', {
+ rules: {
+ '@stylistic/brace-style': ['error', '1tbs', { allowSingleLine: true }],
+ '@stylistic/indent-binary-ops': 'off',
+ '@stylistic/max-statements-per-line': 'off',
+ '@stylistic/operator-linebreak': 'off',
+ '@stylistic/quote-props': ['error', 'consistent'],
+ '@stylistic/space-before-function-paren': ['error', 'always'],
+ },
+ })
+
+ // Append local rules
+ .append(
+ {
+ files: ['*.{js,ts}', 'scripts/**/*.{js,ts}', 'packages/**/*.{mts,ts,mjs,js}'],
+ ignores: ['packages/**/*.client.ts', 'packages/**/*.client.mts', 'packages/**/*.client.js', 'packages/**/*.client.mjs'],
+ name: 'local/requires/explicit-node-imports',
+ rules: {
+ // Ban direct use of restricted global identifiers
+ 'no-restricted-globals': [
+ 'error',
+ {
+ message: 'Use explicit import: import process from "node:process" (or a scoped alias). Implicit globals are banned for clarity and tree-shakability.',
+ name: 'process',
+ },
+ {
+ message: 'Use explicit import: import { performance } from "node:perf_hooks". Implicit global performance is banned in server contexts to ensure Node.js-specific usage.',
+ name: 'performance',
+ },
+ ],
+ },
+ },
+ {
+ files: ['**/*.vue', '**/*.ts', '**/*.mts', '**/*.js', '**/*.cjs', '**/*.mjs'],
+ name: 'local/rules',
+ plugins: {
+ 'import-x': importX,
+ },
+ rules: {
+ 'import-x/no-restricted-paths': [
+ 'error',
+ {
+ zones: [
+ {
+ from: 'packages/nuxt/src/!(core)/runtime/*',
+ message: 'core should not directly import from modules.',
+ target: 'packages/nuxt/src/core',
+ },
+ {
+ from: 'packages/nuxt/src/!(app)/**/*',
+ message: 'app should not directly import from modules.',
+ target: 'packages/nuxt/src/app',
+ },
+ {
+ from: 'packages/nuxt/src/app/**/index.ts',
+ message: 'should not import from barrel/index files',
+ target: 'packages/nuxt/src',
+ },
+ {
+ from: 'packages/nitro',
+ message: 'nitro should not directly import other packages.',
+ target: 'packages/!(nitro)/**/*',
+ },
+ ],
+ },
+ ],
+ 'jsdoc/check-tag-names': [
+ 'error',
+ {
+ definedTags: [
+ 'experimental',
+ '__NO_SIDE_EFFECTS__',
+ ],
+ },
+ ],
+ },
+ },
+ {
+ files: ['packages/*/src/**'],
+ ignores: ['packages/nuxt/src/app/**', '**/runtime/**/*'],
+ name: 'local/import-extensions',
+ plugins: {
+ 'import-x': importX,
+ },
+ rules: {
+ 'import/extensions': ['error', 'always', {
+ ignorePackages: true,
+ js: 'always',
+ ts: 'always',
+ vue: 'always',
+ }],
+ },
+ },
+ {
+ files: ['packages/nuxt/src/app/**', 'test/**', '**/runtime/**', '**/*.test.ts'],
+ name: 'local/disables/client-console',
+ rules: {
+ 'no-console': 'off',
+ },
+ },
+ {
+ // `DefineSetupFnComponent<Props, Emits, Slots>` uses
+ // `{}` as the default for `Emits`/`Slots` so we suppress
+ // the warning in our runtime/ dirs.
+ files: ['packages/nuxt/src/app/**', 'packages/nuxt/src/{components,head,imports,pages}/runtime/**'],
+ name: 'local/disables/empty-object-type',
+ rules: {
+ '@typescript-eslint/no-empty-object-type': ['error', { allowObjectTypes: 'always' }],
+ },
+ },
+ // manually specify dependencies for nuxt browser app
+ {
+ files: ['packages/nuxt/src/app/**', 'packages/nuxt/src/(components,head,imports,pages)/runtime/**'],
+ name: 'local/client-packages',
+ rules: {
+ '@typescript-eslint/no-restricted-imports': ['error', {
+ 'patterns': [
+ {
+ allowTypeImports: true,
+ regex: `^(?!(${
+ [
+ // vue ecosystem
+ '@unhead',
+ '@vue/shared',
+ 'ofetch',
+ 'vue/server-renderer',
+ 'vue',
+ 'vue-router',
+ ...runtimeDependencies,
+ 'errx', /* only used in dev */
+ // internal deps
+ 'nuxt/app',
+ ].map(r => r.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')).join('|')
+ })($|/))(?!#)(?!\\.)[a-zA-Z@]`,
+ },
+ ],
+ }],
+ },
+ },
+ {
+ files: ['**/fixtures/**', '**/fixture/**', '**/*-fixture/**'],
+ name: 'local/disables/fixtures',
+ rules: {
+ '@typescript-eslint/no-unused-vars': 'off',
+ '@typescript-eslint/triple-slash-reference': 'off',
+ 'vue/multi-word-component-names': 'off',
+ 'vue/valid-v-for': 'off',
+ },
+ },
+ {
+ files: ['test/**', '**/*.test.ts'],
+ name: 'local/disables/tests',
+ plugins: {
+ 'no-only-tests': noOnlyTests,
+ },
+ rules: {
+ '@typescript-eslint/no-explicit-any': 'off',
+ 'no-console': 'off',
+ 'no-only-tests/no-only-tests': 'error',
+ },
+ },
+ // Sort rule keys in eslint config
+ {
+ files: ['**/eslint.config.mjs'],
+ name: 'local/sort-eslint-config',
+ plugins: {
+ perfectionist,
+ },
+ rules: {
+ 'perfectionist/sort-objects': 'error',
+ },
+ },
+ {
+ files: ['packages/nuxt/src/app/components/welcome.vue'],
+ rules: {
+ 'vue/multi-word-component-names': 'off',
+ },
+ },
+ // @ts-expect-error type issues between @types/eslint and @eslint/core
+ {
+ files: ['**/*.md'],
+ language: 'markdown/commonmark',
+ name: 'local/docs-markdown',
+ plugins: {
+ markdown,
+ },
+ processor: 'markdown/markdown',
+ },
+ {
+ // targets code-blocks in markdown files
+ files: ['**/*.md/**/*'],
+ rules: {
+ '@stylistic/keyword-spacing': 'off',
+ '@typescript-eslint/no-empty-object-type': 'off',
+ '@typescript-eslint/no-unused-vars': 'off',
+ 'import/first': 'off',
+ 'no-console': 'off',
+ 'no-unused-vars': 'off',
+ 'vue/no-unused-vars': 'off',
+ 'vue/require-v-for-key': 'off',
+ },
+ },
+ )
+
+ // Generate type definitions for the eslint config
+ .onResolved(configs => typegen(configs))
diff --git a/examples/README.md b/examples/README.md
new file mode 100644
index 000000000000..98a9e9ba060e
--- /dev/null
+++ b/examples/README.md
@@ -0,0 +1,4 @@
+# Nuxt Examples
+
+- 👉 See examples in your browser at https://nuxt.com/docs/4.x/examples
+- 👉 View on GitHub at https://github.com/nuxt/examples
diff --git a/examples/async-component-injection/README.md b/examples/async-component-injection/README.md
deleted file mode 100644
index d3eb261942c7..000000000000
--- a/examples/async-component-injection/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Nuxt with advanced async components
-
-See [here](https://vuejs.org/v2/guide/components.html#Advanced-Async-Components) for more details
diff --git a/examples/async-component-injection/assets/css/common.css b/examples/async-component-injection/assets/css/common.css
deleted file mode 100644
index b4f5ee78bfd8..000000000000
--- a/examples/async-component-injection/assets/css/common.css
+++ /dev/null
@@ -1,69 +0,0 @@
-body {
- font-family: "Roboto", "Helvetica Neue", "Hiragino Sans GB", "LiHei Pro", Arial, serif;
- text-rendering: optimizelegibility;
- -webkit-font-smoothing: antialiased;
- -moz-osx-font-smoothing: grayscale;
- font-weight: 400;
- font-size: 16px;
- word-spacing: 1px;
- color: #666;
- margin: 0;
-}
-img {
- border: none;
-}
-a {
- color: #666;
- text-decoration: none;
- transition: color 0.2s ease, border-color 0.2s ease;
-}
-.header {
- letter-spacing: 5px;
- margin: 50px auto 15px;
- text-align: center;
-}
-.header a {
- font-size: 15px;
- color: #444;
-}
-.links {
- text-align: center;
- font-family: "Roboto", "Helvetica Neue", "Hiragino Sans GB", "LiHei Pro", Arial, serif;
- color: #999;
- font-size: 24px;
- margin: 0;
-}
-.links a {
- cursor: pointer;
- padding: 2px;
- margin: 0 3px;
-}
-.links img {
- width: 15px;
- height: 15px;
-}
-.header,
-h1,
-h2,
-h3,
-h4,
-h5,
-h6 {
- font-family: "Montserrat", "Helvetica Neue", "Hiragino Sans GB", "LiHei Pro", Arial, sans-serif;
- font-weight: 400;
- color: #444;
-}
-.main {
- max-width: 600px;
- margin: 50px auto;
- padding: 0 30px 50px;
- position: relative;
-}
-@media screen and (max-width: 420px) {
- .header {
- margin: 40px auto 10px;
- }
- .header a {
- font-size: 14px;
- }
-}
diff --git a/examples/async-component-injection/assets/css/index.css b/examples/async-component-injection/assets/css/index.css
deleted file mode 100644
index 25870b834deb..000000000000
--- a/examples/async-component-injection/assets/css/index.css
+++ /dev/null
@@ -1,57 +0,0 @@
-.main > ul {
- list-style-type: none;
- padding: 0;
- padding-top: 4px;
-}
-.main > ul > li {
- position: relative;
- padding: 30px 0 30px;
- border-bottom: 1px solid #e6e6e6;
-}
-.main > ul > li:first-child {
- margin-top: -30px;
-}
-.main h2,
-.main h3 {
- letter-spacing: 1px;
- margin: 0;
- text-transform: uppercase;
-}
-.main h2 {
- font-size: 20px;
- letter-spacing: 1px;
- margin-left: 120px;
-}
-.main h2 a {
- color: #444;
-}
-.main h2 a:hover {
- color: #f33;
-}
-.main h3 {
- font-size: 13px;
- color: #999;
- position: absolute;
- left: 0;
- top: 33px;
-}
-@media screen and (max-width: 420px) {
- .main h2 {
- font-size: 16px;
- margin-left: 0;
- }
- .main h2 a:hover {
- color: #f66;
- }
- .main h3 {
- font-size: 11px;
- position: static;
- margin-bottom: 10px;
- }
- .main ul li {
- padding: 18px 0 20px;
- }
- .main ul li:first-child {
- margin-top: -35px;
- }
-}
diff --git a/examples/async-component-injection/assets/css/post.css b/examples/async-component-injection/assets/css/post.css
deleted file mode 100644
index 128b175f7093..000000000000
--- a/examples/async-component-injection/assets/css/post.css
+++ /dev/null
@@ -1,307 +0,0 @@
-.gutter pre {
- color: #999;
-}
-pre {
- color: #525252;
-}
-pre .function .keyword,
-pre .constant {
- color: #0092db;
-}
-pre .keyword,
-pre .attribute {
- color: #e96900;
-}
-pre .number,
-pre .literal {
- color: #ae81ff;
-}
-pre .tag,
-pre .tag .title,
-pre .change,
-pre .winutils,
-pre .flow,
-pre .lisp .title,
-pre .clojure .built_in,
-pre .nginx .title,
-pre .tex .special {
- color: #2973b7;
-}
-pre .class .title {
- color: #fff;
-}
-pre .symbol,
-pre .symbol .string,
-pre .value,
-pre .regexp {
- color: #42b983;
-}
-pre .title {
- color: #a6e22e;
-}
-pre .tag .value,
-pre .string,
-pre .subst,
-pre .haskell .type,
-pre .preprocessor,
-pre .ruby .class .parent,
-pre .built_in,
-pre .sql .aggregate,
-pre .django .template_tag,
-pre .django .variable,
-pre .smalltalk .class,
-pre .javadoc,
-pre .django .filter .argument,
-pre .smalltalk .localvars,
-pre .smalltalk .array,
-pre .attr_selector,
-pre .pseudo,
-pre .addition,
-pre .stream,
-pre .envvar,
-pre .apache .tag,
-pre .apache .cbracket,
-pre .tex .command,
-pre .prompt {
- color: #42b983;
-}
-pre .comment,
-pre .java .annotation,
-pre .python .decorator,
-pre .template_comment,
-pre .pi,
-pre .doctype,
-pre .deletion,
-pre .shebang,
-pre .apache .sqbracket,
-pre .tex .formula {
- color: #b3b3b3;
-}
-pre .coffeescript .javascript,
-pre .javascript .xml,
-pre .tex .formula,
-pre .xml .javascript,
-pre .xml .vbscript,
-pre .xml .css,
-pre .xml .cdata {
- opacity: 0.5;
-}
-.main .post {
- position: relative;
- padding-bottom: 30px;
- margin-bottom: 30px;
- border-bottom: 1px solid #e6e6e6;
-}
-.main .post h1,
-.main .post h2 {
- text-transform: uppercase;
- letter-spacing: 0px;
-}
-.main .post h1 a:hover,
-.main .post h2 a:hover {
- border-bottom: 3px solid #666;
-}
-.main .post h1 {
- font-size: 32px;
- margin: 0 0 45px;
- letter-spacing: 1px;
-}
-.main .post h2 {
- font-size: 24px;
- margin: 60px 0 30px;
- position: relative;
-}
-.main .post h2:before {
- content: '';
- border-left: 5px solid #41b883;
- position: absolute;
- left: -15px;
- height: 75%;
- top: 12%;
-}
-.main .post h3 {
- margin: 30px 0 15px;
-}
-.main .post .date {
- font-family: "Montserrat", "Helvetica Neue", "Hiragino Sans GB", "LiHei Pro", Arial, sans-serif;
- font-size: 13px;
- color: #999;
- margin: 0 0 30px;
- letter-spacing: 1px;
- position: initial;
- text-transform: none;
-}
-.main .post .content {
- text-align: left;
- line-height: 1.8em;
-}
-.main .post .content p,
-.main .post .content ul,
-.main .post .content ol {
- margin: 1em 0 1.5em;
-}
-.main .post .content strong {
- font-weight: 600;
- color: #444;
-}
-.main .post .content ol {
- padding-left: 1.6em;
-}
-.main .post .content ul {
- padding-left: 15px;
- list-style-type: none;
-}
-.main .post .content ul li:before {
- position: absolute;
- font-weight: 600;
- content: " · ";
- margin: 0;
- left: 0;
-}
-.main .post .content a {
- color: #41b883;
- border-bottom: 2px solid transparent;
-}
-.main .post .content a:hover {
- color: #41b883;
- border-bottom-color: #41b883;
-}
-.main .post .content .highlight,
-.main .post .content .highlight table {
- margin: 0;
- width: 100%;
-}
-.main .post .content .highlight {
- overflow-x: auto;
-}
-.main .post .content .highlight table,
-.main .post .content .highlight tr,
-.main .post .content .highlight td {
- padding: 0;
- border-collapse: collapse;
-}
-.main .post .content code {
- font-family: "Roboto Mono", "Menlo", "Consolas", monospace;
- font-size: 13px;
- background-color: #f6f6f6;
- padding: 3px 10px;
- margin: 0 5px;
- border-radius: 2px;
-}
-.main .post .content pre {
- font-family: "Roboto Mono", "Menlo", "Consolas", monospace;
- font-size: 13px;
- overflow-x: auto;
- text-align: left;
- padding: 15px 25px;
- background-color: #f6f6f6;
- line-height: 1.5em;
-}
-.main .post .content .code pre {
- border-top-right-radius: 2px;
- border-bottom-right-radius: 2px;
-}
-.main .post .content .gutter pre {
- padding: 15px 0 15px 15px;
- color: #75715e;
- border-top-left-radius: 2px;
- border-bottom-left-radius: 2px;
-}
-.main .post .content blockquote {
- margin: 2em 0;
- padding-left: 30px;
- border-left: 5px solid #e6e6e6;
-}
-.main .post .content blockquote p {
- font-size: 17px;
- font-style: italic;
- line-height: 1.8em;
- color: #999;
-}
-.main .post img {
- display: block;
- max-width: 100%;
-}
-.blog-nav {
- position: fixed;
- bottom: 20px;
- height: 20px;
- line-height: 20px;
- font-family: "Montserrat", "Helvetica Neue", "Hiragino Sans GB", "LiHei Pro", Arial, sans-serif;
- font-size: 15px;
- color: #999;
- text-decoration: none;
- cursor: pointer;
- letter-spacing: 1px;
- border-bottom: 3px solid transparent;
-}
-.blog-nav:hover {
- color: #333;
- border-bottom-color: #333;
-}
-#newer {
- left: 40px;
-}
-#older {
- right: 40px;
-}
-.show-comments {
- font-family: "Montserrat", "Helvetica Neue", "Hiragino Sans GB", "LiHei Pro", Arial, sans-serif;
- text-align: center;
-}
-.show-comments a {
- color: #999;
- cursor: pointer;
-}
-.show-comments a:hover {
- color: #666;
-}
-@media screen and (max-width: 900px) {
- .main .post {
- padding-bottom: 80px;
- }
- .blog-nav {
- position: absolute;
- bottom: 30px;
- }
- #newer {
- left: 0;
- }
- #older {
- right: 0;
- }
-}
-@media screen and (max-width: 420px) {
- .main {
- margin-top: 32px;
- }
- .main .post h1 {
- font-size: 24px;
- margin: 0 0 30px;
- }
- .main .post h2 {
- font-size: 20px;
- margin: 30px 0 15px;
- }
- .main .post h3 {
- font-size: 16px;
- line-height: 1.3em;
- }
- .main .post .date {
- font-size: 12px;
- margin: 0 0 20px;
- }
- .main .post .content {
- font-size: 15px;
- }
- .main .post .content pre {
- font-size: 12px;
- }
- .main .post .content blockquote p {
- font-size: 16px;
- }
- .blog-nav {
- font-size: 14px;
- color: #444;
- }
-}
diff --git a/examples/async-component-injection/assets/img/github.png b/examples/async-component-injection/assets/img/github.png
deleted file mode 100644
index 3844ec302dc2..000000000000
Binary files a/examples/async-component-injection/assets/img/github.png and /dev/null differ
diff --git a/examples/async-component-injection/assets/img/swimmer.jpg b/examples/async-component-injection/assets/img/swimmer.jpg
deleted file mode 100644
index e22693d4e693..000000000000
Binary files a/examples/async-component-injection/assets/img/swimmer.jpg and /dev/null differ
diff --git a/examples/async-component-injection/assets/img/twitter.png b/examples/async-component-injection/assets/img/twitter.png
deleted file mode 100644
index e84e1b8a2849..000000000000
Binary files a/examples/async-component-injection/assets/img/twitter.png and /dev/null differ
diff --git a/examples/async-component-injection/layouts/default.vue b/examples/async-component-injection/layouts/default.vue
deleted file mode 100644
index ceba7c02fe90..000000000000
--- a/examples/async-component-injection/layouts/default.vue
+++ /dev/null
@@ -1,20 +0,0 @@
-<template>
- <div class="wrapper">
- <div class="header">
- <NuxtLink to="/">
- NUXT BLOG
- </NuxtLink>
- </div>
- <p class="links">
- <a href="https://twitter.com/nuxt_js" target="_blank">
- <img src="~/assets/img/twitter.png">
- </a>
- <a href="https://github.com/nuxt/nuxt.js/tree/dev/examples/async-component-injection" target="_blank">
- <img src="~/assets/img/github.png">
- </a>
- </p>
- <div class="main">
- <Nuxt />
- </div>
- </div>
-</template>
diff --git a/examples/async-component-injection/nuxt.config.js b/examples/async-component-injection/nuxt.config.js
deleted file mode 100644
index 94c5adc9982c..000000000000
--- a/examples/async-component-injection/nuxt.config.js
+++ /dev/null
@@ -1,22 +0,0 @@
-export default {
- head: {
- title: 'Nuxt Blog',
- meta: [
- { charset: 'utf-8' },
- { name: 'viewport', content: 'width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no' }
- ],
- link: [
- { rel: 'icon', href: '/favicon.ico', type: 'image/x-icon' },
- { rel: 'stylesheet', href: 'http://fonts.googleapis.com/css?family=Montserrat|Roboto:400,400italic,600|Roboto+Mono', type: 'text/css' }
- ]
- },
- css: [
- '@/assets/css/common.css'
- ],
- generate: {
- routes: [
- '/deep-dive-into-ocean',
- '/welcome-to-my-blog'
- ]
- }
-}
diff --git a/examples/async-component-injection/package.json b/examples/async-component-injection/package.json
deleted file mode 100644
index a9e00066e21a..000000000000
--- a/examples/async-component-injection/package.json
+++ /dev/null
@@ -1,12 +0,0 @@
-{
- "name": "example-async-components-injection",
- "dependencies": {
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/async-component-injection/pages/_slug.vue b/examples/async-component-injection/pages/_slug.vue
deleted file mode 100644
index 120d8f32ce41..000000000000
--- a/examples/async-component-injection/pages/_slug.vue
+++ /dev/null
@@ -1,21 +0,0 @@
-<template>
- <div class="post">
- <Component :is="component" />
- </div>
-</template>
-
-<script>
-// See https://vuejs.org/v2/guide/components.html#Advanced-Async-Components
-const getPost = slug => ({
- component: import(`@/posts/${slug}`),
- error: require('@/posts/404')
-})
-
-export default {
- beforeCreate () {
- this.component = () => getPost(this.$route.params.slug)
- }
-}
-</script>
-
-<style src="@/assets/css/post.css"/>
diff --git a/examples/async-component-injection/pages/index.vue b/examples/async-component-injection/pages/index.vue
deleted file mode 100644
index 24525fd6e588..000000000000
--- a/examples/async-component-injection/pages/index.vue
+++ /dev/null
@@ -1,30 +0,0 @@
-<template>
- <ul>
- <li v-for="(post, index) in posts" :key="index">
- <h3>{{ post.date }}</h3>
- <h2>
- <NuxtLink :to="post.link">
- {{ post.title }}
- </NuxtLink>
- </h2>
- </li>
- <li style="border:none;text-align: center;font-size: 14px;">
- Design from <a href="http://blog.evanyou.me" target="_blank">
- EvanYou.me
- </a>
- </li>
- </ul>
-</template>
-
-<script>
-export default {
- data: () => ({
- posts: [
- { date: 'Jul 10, 2017', title: 'Deep dive into the Ocean', link: '/deep-dive-into-ocean' },
- { date: 'Jul 08, 2017', title: 'Welcome to my blog', link: '/welcome-to-my-blog' }
- ]
- })
-}
-</script>
-
-<style src="@/assets/css/index.css"/>
diff --git a/examples/async-component-injection/posts/404.vue b/examples/async-component-injection/posts/404.vue
deleted file mode 100644
index 4965d77953f7..000000000000
--- a/examples/async-component-injection/posts/404.vue
+++ /dev/null
@@ -1,5 +0,0 @@
-<template>
- <h1 style="text-align: center;">
- Article not found
- </h1>
-</template>
diff --git a/examples/async-component-injection/posts/deep-dive-into-ocean.vue b/examples/async-component-injection/posts/deep-dive-into-ocean.vue
deleted file mode 100644
index 3cc9c61b9078..000000000000
--- a/examples/async-component-injection/posts/deep-dive-into-ocean.vue
+++ /dev/null
@@ -1,19 +0,0 @@
-<template>
- <div>
- <h3 class="date">
- Jul 10, 2017
- </h3>
- <h1>Deep dive into the Ocean</h1>
- <div class="content">
- <img src="~/assets/img/swimmer.jpg">
- <h2>Subtitle #1</h2>
- <p>Far far away, behind the word mountains, far from the countries Vokalia and Consonantia, there live the blind texts. Separated they live in Bookmarksgrove right at the coast of the Semantics, a large language ocean. A small river named Duden flows by their place and supplies it with the necessary regelialia. It is a paradisematic country, in which roasted parts of sentences fly into your mouth. Even the all-powerful Pointing has no control about the blind texts it is an almost unorthographic life One day however a small line of blind text by the name of Lorem Ipsum decided to leave for the far World of Grammar.</p>
- <h2>Another subtitle</h2>
- <ul>
- <li>Vue.js</li>
- <li>Nuxt.js</li>
- <li>= <3</li>
- </ul>
- </div>
- </div>
-</template>
diff --git a/examples/async-component-injection/posts/welcome-to-my-blog.vue b/examples/async-component-injection/posts/welcome-to-my-blog.vue
deleted file mode 100644
index cf22f0db1f30..000000000000
--- a/examples/async-component-injection/posts/welcome-to-my-blog.vue
+++ /dev/null
@@ -1,12 +0,0 @@
-<template>
- <div>
- <h3 class="date">
- Jul 08, 2017
- </h3>
- <h1>Welcome to my blog</h1>
- <div class="content">
- <h2>What is Lorem Ipsum?</h2>
- <p><b>Lorem Ipsum</b> is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book. It has survived not only five centuries, but also the leap into electronic typesetting, remaining essentially unchanged. It was popularised in the 1960s with the release of Letraset sheets containing Lorem Ipsum passages, and more recently with desktop publishing software like Aldus PageMaker including versions of Lorem Ipsum.</p>
- </div>
- </div>
-</template>
diff --git a/examples/async-component-injection/static/favicon.ico b/examples/async-component-injection/static/favicon.ico
deleted file mode 100644
index 382fecbbf96d..000000000000
Binary files a/examples/async-component-injection/static/favicon.ico and /dev/null differ
diff --git a/examples/async-data/README.md b/examples/async-data/README.md
deleted file mode 100644
index b84dedfb015b..000000000000
--- a/examples/async-data/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Async data with Nuxt.js
-
-https://nuxtjs.org/examples/async-data
diff --git a/examples/async-data/nuxt.config.js b/examples/async-data/nuxt.config.js
deleted file mode 100644
index 883ef1b53d4f..000000000000
--- a/examples/async-data/nuxt.config.js
+++ /dev/null
@@ -1,15 +0,0 @@
-export default {
- loading: {
- color: '#4FC08D',
- failedColor: '#bf5050',
- duration: 1500
- },
- head: {
- title: 'Default title'
- },
- generate: {
- routes: [
- '/posts/1'
- ]
- }
-}
diff --git a/examples/async-data/package.json b/examples/async-data/package.json
deleted file mode 100644
index fd97dab8184d..000000000000
--- a/examples/async-data/package.json
+++ /dev/null
@@ -1,13 +0,0 @@
-{
- "name": "example-async-data",
- "dependencies": {
- "axios": "^0.19.0",
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/async-data/pages/index.vue b/examples/async-data/pages/index.vue
deleted file mode 100644
index 3fcf2a8b0e84..000000000000
--- a/examples/async-data/pages/index.vue
+++ /dev/null
@@ -1,35 +0,0 @@
-
-<template>
- <div class="container">
- <h1>User Agent</h1>
- <p>{{ userAgent }}</p>
- <p>
- <NuxtLink to="/posts">
- Blog
- </NuxtLink>
- </p>
- </div>
-</template>
-
-<script>
-export default {
- asyncData: ({ req }) => ({
- userAgent: (req ? req.headers['user-agent'] : (typeof navigator !== 'undefined' ? navigator.userAgent : 'No user agent (generated)'))
- })
-}
-</script>
-
-<style scoped>
-.container {
- width: 70%;
- margin: auto;
- text-align: center;
- padding-top: 100px;
-}
-p {
- font-size: 20px;
-}
-a {
- color: #41B883;
-}
-</style>
diff --git a/examples/async-data/pages/posts/_id.vue b/examples/async-data/pages/posts/_id.vue
deleted file mode 100644
index c391a073a95c..000000000000
--- a/examples/async-data/pages/posts/_id.vue
+++ /dev/null
@@ -1,56 +0,0 @@
-
-<template>
- <div class="container">
- <h1>{{ post.title }}</h1>
- <pre>{{ post.body }}</pre>
- <p>
- <NuxtLink to="/posts">
- Back to the list
- </NuxtLink>
- </p>
- </div>
-</template>
-
-<script>
-import axios from 'axios'
-
-export default {
- async asyncData ({ params }) {
- // We can use async/await ES6 feature
- const { data } = await axios.get(`https://jsonplaceholder.typicode.com/posts/${params.id}`)
- return { post: data }
- },
- head () {
- return {
- title: this.post.title
- }
- }
-}
-</script>
-
-<style scoped>
-.container {
- width: 70%;
- margin: auto;
- text-align: center;
- padding-top: 100px;
-}
-ul {
- list-style-type: none;
- padding: 0;
-}
-ul li {
- border: 1px #ddd solid;
- padding: 20px;
- text-align: left;
-}
-ul li a {
- color: gray;
-}
-p {
- font-size: 20px;
-}
-a {
- color: #41B883;
-}
-</style>
diff --git a/examples/async-data/pages/posts/index.vue b/examples/async-data/pages/posts/index.vue
deleted file mode 100644
index b026891f03f3..000000000000
--- a/examples/async-data/pages/posts/index.vue
+++ /dev/null
@@ -1,62 +0,0 @@
-
-<template>
- <div class="container">
- <h1>Blog</h1>
- <ul>
- <li v-for="(post, index) in posts" :key="index">
- <NuxtLink :to="{ name: 'posts-id', params: { id: post.id } }">
- {{ post.title }}
- </NuxtLink>
- </li>
- </ul>
- <p>
- <NuxtLink to="/">
- Back to home page
- </NuxtLink>
- </p>
- </div>
-</template>
-
-<script>
-import axios from 'axios'
-
-export default {
- asyncData ({ req, params }) {
- // We can return a Promise instead of calling the callback
- return axios.get('https://jsonplaceholder.typicode.com/posts')
- .then((res) => {
- return { posts: res.data.slice(0, 5) }
- })
- },
- head: {
- title: 'List of posts'
- }
-}
-</script>
-
-<style scoped>
-.container {
- width: 70%;
- margin: auto;
- text-align: center;
- padding-top: 100px;
-}
-ul {
- list-style-type: none;
- padding: 0;
-}
-ul li {
- border: 1px #ddd solid;
- padding: 20px;
- text-align: left;
-}
-ul li a {
- color: gray;
-}
-p {
- font-size: 20px;
-}
-a {
- color: #41B883;
-}
-</style>
diff --git a/examples/auth-jwt/README.md b/examples/auth-jwt/README.md
deleted file mode 100644
index 5780625bd03a..000000000000
--- a/examples/auth-jwt/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Auth External API (JWT) with Nuxt.js
-
-https://nuxtjs.org/examples/auth-external-jwt
diff --git a/examples/auth-jwt/middleware/authenticated.js b/examples/auth-jwt/middleware/authenticated.js
deleted file mode 100644
index 2368cd8c0cd9..000000000000
--- a/examples/auth-jwt/middleware/authenticated.js
+++ /dev/null
@@ -1,6 +0,0 @@
-export default function ({ store, redirect }) {
- // If the user is not authenticated
- if (!store.state.auth) {
- return redirect('/login')
- }
-}
diff --git a/examples/auth-jwt/middleware/notAuthenticated.js b/examples/auth-jwt/middleware/notAuthenticated.js
deleted file mode 100644
index 1379dfe28cb6..000000000000
--- a/examples/auth-jwt/middleware/notAuthenticated.js
+++ /dev/null
@@ -1,6 +0,0 @@
-export default function ({ store, redirect }) {
- // If the user is authenticated redirect to home page
- if (store.state.auth) {
- return redirect('/')
- }
-}
diff --git a/examples/auth-jwt/package.json b/examples/auth-jwt/package.json
deleted file mode 100644
index 246a6e2dfd16..000000000000
--- a/examples/auth-jwt/package.json
+++ /dev/null
@@ -1,14 +0,0 @@
-{
- "name": "example-auth-jwt",
- "dependencies": {
- "cookieparser": "^0.1.0",
- "js-cookie": "^2.2.0",
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/auth-jwt/pages/index.vue b/examples/auth-jwt/pages/index.vue
deleted file mode 100644
index d75075dc9039..000000000000
--- a/examples/auth-jwt/pages/index.vue
+++ /dev/null
@@ -1,34 +0,0 @@
-<template>
- <div>
- <div v-if="$store.state.auth">
- <p>
- You are authenticated. You can see the
- <NuxtLink to="/secret">
- secret page
- </NuxtLink>!
- </p>
- <button @click="logout">
- Logout
- </button>
- </div>
- <p v-else>
- Please
- <NuxtLink to="/login">
- login
- </NuxtLink>.
- </p>
- </div>
-</template>
-
-<script>
-const Cookie = process.client ? require('js-cookie') : undefined
-
-export default {
- methods: {
- logout () {
- Cookie.remove('auth')
- this.$store.commit('setAuth', null)
- }
- }
-}
-</script>
diff --git a/examples/auth-jwt/pages/login.vue b/examples/auth-jwt/pages/login.vue
deleted file mode 100644
index be11d62eb50d..000000000000
--- a/examples/auth-jwt/pages/login.vue
+++ /dev/null
@@ -1,37 +0,0 @@
-<template>
- <div class="container">
- <h1>Sign in to access the secret page</h1>
- <div>
- <label for="email">
- <input id="email" type="email" value="test">
- </label>
- <label for="password">
- <input id="password" type="password" value="test">
- </label>
- <button @click="postLogin">
- login
- </button>
- <p>The credentials are not verified for the example purpose.</p>
- </div>
- </div>
-</template>
-
-<script>
-const Cookie = process.client ? require('js-cookie') : undefined
-
-export default {
- middleware: 'notAuthenticated',
- methods: {
- postLogin () {
- setTimeout(() => { // we simulate the async request with timeout.
- const auth = {
- accessToken: 'someStringGotFromApiServiceWithAjax'
- }
- this.$store.commit('setAuth', auth) // mutating to store for client rendering
- Cookie.set('auth', auth) // saving token in cookie for server rendering
- this.$router.push('/')
- }, 1000)
- }
- }
-}
-</script>
diff --git a/examples/auth-jwt/pages/secret.vue b/examples/auth-jwt/pages/secret.vue
deleted file mode 100644
index 26cfe810195f..000000000000
--- a/examples/auth-jwt/pages/secret.vue
+++ /dev/null
@@ -1,14 +0,0 @@
-<template>
- <div>
- <h1>This is secret page.</h1>
- <NuxtLink to="/">
- Back home
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- middleware: 'authenticated'
-}
-</script>
diff --git a/examples/auth-jwt/store/index.js b/examples/auth-jwt/store/index.js
deleted file mode 100644
index 16a41ee1b296..000000000000
--- a/examples/auth-jwt/store/index.js
+++ /dev/null
@@ -1,26 +0,0 @@
-const cookieparser = process.server ? require('cookieparser') : undefined
-
-export const state = () => {
- return {
- auth: null
- }
-}
-export const mutations = {
- setAuth (state, auth) {
- state.auth = auth
- }
-}
-export const actions = {
- nuxtServerInit ({ commit }, { req }) {
- let auth = null
- if (req.headers.cookie) {
- const parsed = cookieparser.parse(req.headers.cookie)
- try {
- auth = JSON.parse(parsed.auth)
- } catch (err) {
- // No valid cookie found
- }
- }
- commit('setAuth', auth)
- }
-}
diff --git a/examples/auth-routes/README.md b/examples/auth-routes/README.md
deleted file mode 100644
index 51ba41fb9b3f..000000000000
--- a/examples/auth-routes/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Authenticated Routes with Nuxt and Express sessions
-
-https://nuxtjs.org/examples/auth-routes
diff --git a/examples/auth-routes/api/index.js b/examples/auth-routes/api/index.js
deleted file mode 100644
index bc5383c3aa8e..000000000000
--- a/examples/auth-routes/api/index.js
+++ /dev/null
@@ -1,36 +0,0 @@
-import express from 'express'
-
-// Create express router
-const router = express.Router()
-
-// Transform req & res to have the same API as express
-// So we can use res.status() & res.json()
-const app = express()
-router.use((req, res, next) => {
- Object.setPrototypeOf(req, app.request)
- Object.setPrototypeOf(res, app.response)
- req.res = res
- res.req = req
- next()
-})
-
-// Add POST - /api/login
-router.post('/login', (req, res) => {
- if (req.body.username === 'demo' && req.body.password === 'demo') {
- req.session.authUser = { username: 'demo' }
- return res.json({ username: 'demo' })
- }
- res.status(401).json({ message: 'Bad credentials' })
-})
-
-// Add POST - /api/logout
-router.post('/logout', (req, res) => {
- delete req.session.authUser
- res.json({ ok: true })
-})
-
-// Export the server middleware
-export default {
- path: '/api',
- handler: router
-}
diff --git a/examples/auth-routes/middleware/auth.js b/examples/auth-routes/middleware/auth.js
deleted file mode 100644
index fa4b73b642e6..000000000000
--- a/examples/auth-routes/middleware/auth.js
+++ /dev/null
@@ -1,8 +0,0 @@
-export default function ({ store, error }) {
- if (!store.state.authUser) {
- error({
- message: 'You are not connected',
- statusCode: 403
- })
- }
-}
diff --git a/examples/auth-routes/nuxt.config.js b/examples/auth-routes/nuxt.config.js
deleted file mode 100644
index e0efd9aebf11..000000000000
--- a/examples/auth-routes/nuxt.config.js
+++ /dev/null
@@ -1,32 +0,0 @@
-import bodyParser from 'body-parser'
-import session from 'express-session'
-
-export default {
- head: {
- title: 'Auth Routes',
- meta: [
- { charset: 'utf-8' },
- { name: 'viewport', content: 'width=device-width, initial-scale=1' },
- { hid: 'description', content: 'Auth Routes example' }
- ]
- },
- /*
- ** Add server middleware
- ** Nuxt.js uses `connect` module as server
- ** So most of express middleware works with nuxt.js server middleware
- */
- serverMiddleware: [
- // body-parser middleware
- bodyParser.json(),
- // session middleware
- session({
- secret: 'super-secret-key',
- resave: false,
- saveUninitialized: false,
- cookie: { maxAge: 60000 }
- }),
- // Api middleware
- // We add /api/login & /api/logout routes
- '~/api'
- ]
-}
diff --git a/examples/auth-routes/package.json b/examples/auth-routes/package.json
deleted file mode 100644
index f708bd4e39d3..000000000000
--- a/examples/auth-routes/package.json
+++ /dev/null
@@ -1,16 +0,0 @@
-{
- "name": "example-auth-routes",
- "dependencies": {
- "axios": "^0.19.0",
- "body-parser": "^1.17.2",
- "express": "^4.15.3",
- "express-session": "^1.15.3",
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/auth-routes/pages/index.vue b/examples/auth-routes/pages/index.vue
deleted file mode 100644
index 99e0405d9021..000000000000
--- a/examples/auth-routes/pages/index.vue
+++ /dev/null
@@ -1,72 +0,0 @@
-<template>
- <div class="container">
- <h1>Please login to see the secret content</h1>
- <form v-if="!$store.state.authUser" @submit.prevent="login">
- <p v-if="formError" class="error">
- {{ formError }}
- </p>
- <p><i>To login, use <b>demo</b> as username and <b>demo</b> as password.</i></p>
- <p>Username: <input v-model="formUsername" type="text" name="username"></p>
- <p>Password: <input v-model="formPassword" type="password" name="password"></p>
- <button type="submit">
- Login
- </button>
- </form>
- <div v-else>
- Hello {{ $store.state.authUser.username }}!
- <pre>I am the secret content, I am shown only when the user is connected.</pre>
- <p><i>You can also refresh this page, you'll still be connected!</i></p>
- <button @click="logout">
- Logout
- </button>
- </div>
- <p>
- <NuxtLink to="/secret">
- Super secret page
- </NuxtLink>
- </p>
- </div>
-</template>
-
-<script>
-export default {
- data () {
- return {
- formError: null,
- formUsername: '',
- formPassword: ''
- }
- },
- methods: {
- async login () {
- try {
- await this.$store.dispatch('login', {
- username: this.formUsername,
- password: this.formPassword
- })
- this.formUsername = ''
- this.formPassword = ''
- this.formError = null
- } catch (e) {
- this.formError = e.message
- }
- },
- async logout () {
- try {
- await this.$store.dispatch('logout')
- } catch (e) {
- this.formError = e.message
- }
- }
- }
-}
-</script>
-
-<style>
-.container {
- padding: 100px;
-}
-.error {
- color: red;
-}
-</style>
diff --git a/examples/auth-routes/pages/secret.vue b/examples/auth-routes/pages/secret.vue
deleted file mode 100644
index a004006193df..000000000000
--- a/examples/auth-routes/pages/secret.vue
+++ /dev/null
@@ -1,15 +0,0 @@
-<template>
- <div>
- <h1>Super secret page</h1>
- <p>If you try to access this URL not connected, you will see the error page telling your that you are not connected.</p>
- <NuxtLink to="/">
- Back to the home page
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- middleware: 'auth'
-}
-</script>
diff --git a/examples/auth-routes/store/index.js b/examples/auth-routes/store/index.js
deleted file mode 100644
index d50612e52c81..000000000000
--- a/examples/auth-routes/store/index.js
+++ /dev/null
@@ -1,37 +0,0 @@
-import axios from 'axios'
-
-export const state = () => ({
- authUser: null
-})
-
-export const mutations = {
- SET_USER (state, user) {
- state.authUser = user
- }
-}
-
-export const actions = {
- // nuxtServerInit is called by Nuxt.js before server-rendering every page
- nuxtServerInit ({ commit }, { req }) {
- if (req.session && req.session.authUser) {
- commit('SET_USER', req.session.authUser)
- }
- },
- async login ({ commit }, { username, password }) {
- try {
- const { data } = await axios.post('/api/login', { username, password })
- commit('SET_USER', data)
- } catch (error) {
- if (error.response && error.response.status === 401) {
- throw new Error('Bad credentials')
- }
- throw error
- }
- },
-
- async logout ({ commit }) {
- await axios.post('/api/logout')
- commit('SET_USER', null)
- }
-
-}
diff --git a/examples/axios/README.md b/examples/axios/README.md
deleted file mode 100644
index 0916b6287309..000000000000
--- a/examples/axios/README.md
+++ /dev/null
@@ -1,38 +0,0 @@
-# Nuxt with Axios Proxy Example
-
-Using [proxy-module](https://github.com/nuxt-community/proxy-module) and [Axios module](https://axios.nuxtjs.org/)
-
-> proxy-module is the one-liner node.js http-proxy middleware solution for Nuxt.js using [http-proxy-middleware](https://github.com/chimurai/http-proxy-middleware)
-
-> Axios-module is a secure and easy [Axios](https://github.com/mzabriskie/axios) integration with Nuxt.js.
-
-## Install
-
-```bash
-$ yarn add @nuxtjs/axios @nuxtjs/proxy
-```
-
-## Nuxt.config.js
-
-```json
-{
- modules: [
- '@nuxtjs/axios',
- '@nuxtjs/proxy'
- ],
- proxy: [
- ['/api/dog', { target: 'https://dog.ceo/', pathRewrite: { '^/api/dog': '/api/breeds/image/random' } }]
- ]
-}
-```
-
-### Use Axios
-
-```js
-async asyncData({ app }) {
- const ip = await app.$axios.$get('http://icanhazip.com')
- return { ip }
-}
-```
-
-More detail, please refer [axios-module](https://github.com/nuxt-community/axios-module).
diff --git a/examples/axios/nuxt.config.js b/examples/axios/nuxt.config.js
deleted file mode 100644
index 35675b08091b..000000000000
--- a/examples/axios/nuxt.config.js
+++ /dev/null
@@ -1,9 +0,0 @@
-export default {
- modules: [
- '@nuxtjs/axios',
- '@nuxtjs/proxy'
- ],
- proxy: [
- ['/dog', { target: 'https://dog.ceo/', pathRewrite: { '^/dog': '/api/breeds/image/random' } }]
- ]
-}
diff --git a/examples/axios/package.json b/examples/axios/package.json
deleted file mode 100644
index 195df2c1b261..000000000000
--- a/examples/axios/package.json
+++ /dev/null
@@ -1,15 +0,0 @@
-{
- "name": "example-axios",
- "version": "1.0.0",
- "dependencies": {
- "@nuxtjs/axios": "^5.0.0",
- "@nuxtjs/proxy": "^1.1.2",
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/axios/pages/index.vue b/examples/axios/pages/index.vue
deleted file mode 100644
index 7388c37ee837..000000000000
--- a/examples/axios/pages/index.vue
+++ /dev/null
@@ -1,17 +0,0 @@
-<template>
- <div>
- <h1>Dog</h1>
- <img :src="dog">
- </div>
-</template>
-
-<script>
-
-export default {
-
- async asyncData ({ app }) {
- const { data: { message: dog } } = await app.$axios.get('/dog')
- return { dog }
- }
-}
-</script>
diff --git a/examples/cached-components/README.md b/examples/cached-components/README.md
deleted file mode 100644
index 0f1764e92c0e..000000000000
--- a/examples/cached-components/README.md
+++ /dev/null
@@ -1 +0,0 @@
-# Nuxt with Cached Components using lru-cache
diff --git a/examples/cached-components/nuxt.config.js b/examples/cached-components/nuxt.config.js
deleted file mode 100644
index 485ee61e0cf9..000000000000
--- a/examples/cached-components/nuxt.config.js
+++ /dev/null
@@ -1,10 +0,0 @@
-export default {
- render: {
- bundleRenderer: {
- cache: require('lru-cache')({
- max: 1000,
- maxAge: 1000 * 60 * 15
- })
- }
- }
-}
diff --git a/examples/cached-components/package.json b/examples/cached-components/package.json
deleted file mode 100644
index 88467bb0c4ad..000000000000
--- a/examples/cached-components/package.json
+++ /dev/null
@@ -1,13 +0,0 @@
-{
- "name": "example-cached-components",
- "dependencies": {
- "lru-cache": "^4.0.2",
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/cached-components/pages/index.vue b/examples/cached-components/pages/index.vue
deleted file mode 100644
index 1786eabc9895..000000000000
--- a/examples/cached-components/pages/index.vue
+++ /dev/null
@@ -1,20 +0,0 @@
-<template>
- <div>
- <h1>Cached components</h1>
- <p>Look at the source code and see how the timestamp is not reloaded before 10s after refreshing the page.</p>
- <p>Timestamp: {{ date }}</p>
- </div>
-</template>
-
-<script>
-export default {
- name: 'Date',
- serverCacheKey () {
- // Will change every 10 secondes
- return Math.floor(Date.now() / 10000)
- },
- data () {
- return { date: Date.now() }
- }
-}
-</script>
diff --git a/examples/coffeescript/README.md b/examples/coffeescript/README.md
deleted file mode 100644
index f8a4a5f1d687..000000000000
--- a/examples/coffeescript/README.md
+++ /dev/null
@@ -1,22 +0,0 @@
-# Nuxt with CoffeeScript
-
-> Nuxt.js project with CoffeeScript
-
-## Build Setup
-
-``` bash
-# install dependencies
-$ npm install # Or yarn install
-
-# serve with hot reload at localhost:3000
-$ npm run dev
-
-# build for production and launch server
-$ npm run build
-$ npm start
-
-# generate static project
-$ npm run generate
-```
-
-For detailed explanation on how things work, checkout the [Nuxt.js docs](https://github.com/nuxt/nuxt.js).
diff --git a/examples/coffeescript/components/Logo.vue b/examples/coffeescript/components/Logo.vue
deleted file mode 100644
index a4f590a68862..000000000000
--- a/examples/coffeescript/components/Logo.vue
+++ /dev/null
@@ -1,79 +0,0 @@
-<template>
- <div class="VueToNuxtLogo">
- <div class="Triangle Triangle--two" />
- <div class="Triangle Triangle--one" />
- <div class="Triangle Triangle--three" />
- <div class="Triangle Triangle--four" />
- </div>
-</template>
-
-<style>
-.VueToNuxtLogo {
- display: inline-block;
- animation: turn 2s linear forwards 1s;
- transform: rotateX(180deg);
- position: relative;
- overflow: hidden;
- height: 180px;
- width: 245px;
-}
-
-.Triangle {
- position: absolute;
- top: 0;
- left: 0;
- width: 0;
- height: 0;
-}
-
-.Triangle--one {
- border-left: 105px solid transparent;
- border-right: 105px solid transparent;
- border-bottom: 180px solid #41B883;
-}
-
-.Triangle--two {
- top: 30px;
- left: 35px;
- animation: goright 0.5s linear forwards 3.5s;
- border-left: 87.5px solid transparent;
- border-right: 87.5px solid transparent;
- border-bottom: 150px solid #3B8070;
-}
-
-.Triangle--three {
- top: 60px;
- left: 35px;
- animation: goright 0.5s linear forwards 3.5s;
- border-left: 70px solid transparent;
- border-right: 70px solid transparent;
- border-bottom: 120px solid #35495E;
-}
-
-.Triangle--four {
- top: 120px;
- left: 70px;
- animation: godown 0.5s linear forwards 3s;
- border-left: 35px solid transparent;
- border-right: 35px solid transparent;
- border-bottom: 60px solid #fff;
-}
-
-@keyframes turn {
- 100% {
- transform: rotateX(0deg);
- }
-}
-
-@keyframes godown {
- 100% {
- top: 180px;
- }
-}
-
-@keyframes goright {
- 100% {
- left: 70px;
- }
-}
-</style>
diff --git a/examples/coffeescript/layouts/default.vue b/examples/coffeescript/layouts/default.vue
deleted file mode 100644
index e94a75802585..000000000000
--- a/examples/coffeescript/layouts/default.vue
+++ /dev/null
@@ -1,52 +0,0 @@
-<template>
- <div>
- <Nuxt />
- </div>
-</template>
-
-<style>
-html {
- font-family: "Source Sans Pro", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
- font-size: 16px;
- word-spacing: 1px;
- -ms-text-size-adjust: 100%;
- -webkit-text-size-adjust: 100%;
- -moz-osx-font-smoothing: grayscale;
- -webkit-font-smoothing: antialiased;
- box-sizing: border-box;
-}
-
-*, *:before, *:after {
- box-sizing: border-box;
- margin: 0;
-}
-
-.button--green {
- display: inline-block;
- border-radius: 4px;
- border: 1px solid #3b8070;
- color: #3b8070;
- text-decoration: none;
- padding: 10px 30px;
-}
-
-.button--green:hover {
- color: #fff;
- background-color: #3b8070;
-}
-
-.button--grey {
- display: inline-block;
- border-radius: 4px;
- border: 1px solid #35495e;
- color: #35495e;
- text-decoration: none;
- padding: 10px 30px;
- margin-left: 15px;
-}
-
-.button--grey:hover {
- color: #fff;
- background-color: #35495e;
-}
-</style>
diff --git a/examples/coffeescript/modules/coffeescript.js b/examples/coffeescript/modules/coffeescript.js
deleted file mode 100644
index 3dcc8dc83c10..000000000000
--- a/examples/coffeescript/modules/coffeescript.js
+++ /dev/null
@@ -1,17 +0,0 @@
-export default function () {
- // Add .coffee extension for store, middleware and more
- this.nuxt.options.build.additionalExtensions.push('coffee')
- // Extend build
- const coffeeLoader = {
- test: /\.coffee$/,
- loader: 'coffee-loader'
- }
- this.extendBuild((config) => {
- // Add CoffeeScruot loader
- config.module.rules.push(coffeeLoader)
- // Add .coffee extension in webpack resolve
- if (!config.resolve.extensions.includes('.coffee')) {
- config.resolve.extensions.push('.coffee')
- }
- })
-}
diff --git a/examples/coffeescript/nuxt.config.js b/examples/coffeescript/nuxt.config.js
deleted file mode 100644
index 3d8378c38124..000000000000
--- a/examples/coffeescript/nuxt.config.js
+++ /dev/null
@@ -1,24 +0,0 @@
-export default {
- /*
- ** Headers of the page
- */
- head: {
- title: 'Nuxt with CoffeeScript',
- meta: [
- { charset: 'utf-8' },
- { name: 'viewport', content: 'width=device-width, initial-scale=1' },
- { hid: 'description', name: 'description', content: 'Nuxt.js project' }
- ],
- link: [
- { rel: 'icon', type: 'image/x-icon', href: '/favicon.ico' }
- ]
- },
- /*
- ** Customize the progress bar color
- */
- loading: { color: '#3B8070' },
- /*
- ** Modules
- */
- modules: ['~/modules/coffeescript']
-}
diff --git a/examples/coffeescript/package.json b/examples/coffeescript/package.json
deleted file mode 100644
index df5a495709d7..000000000000
--- a/examples/coffeescript/package.json
+++ /dev/null
@@ -1,20 +0,0 @@
-{
- "name": "example-coffeescript",
- "version": "1.0.0",
- "description": "Nuxt.js with CoffeeScript",
- "author": "Alex Ananiev <alex.ananiev.r@gmail.com>",
- "private": true,
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- },
- "dependencies": {
- "nuxt": "latest"
- },
- "devDependencies": {
- "coffee-loader": "^0.8.0",
- "coffeescript": "^2.0.1"
- }
-}
diff --git a/examples/coffeescript/pages/README.md b/examples/coffeescript/pages/README.md
deleted file mode 100644
index 3c7faf56e7cf..000000000000
--- a/examples/coffeescript/pages/README.md
+++ /dev/null
@@ -1,7 +0,0 @@
-# PAGES
-
-This directory contains your Application Views and Routes.
-The framework reads all the .vue files inside this directory and create the router of your application.
-
-More information about the usage of this directory in the documentation:
-https://nuxtjs.org/guide/routing
diff --git a/examples/coffeescript/pages/index.vue b/examples/coffeescript/pages/index.vue
deleted file mode 100644
index 62f9e08b7ee0..000000000000
--- a/examples/coffeescript/pages/index.vue
+++ /dev/null
@@ -1,58 +0,0 @@
-<template>
- <section class="container">
- <div>
- <logo/>
- <h1 class="title">
- Nuxt.js with Coffee!
- </h1>
- <h2 class="subtitle">
- {{message}}
- </h2>
- <div class="links">
- <a href="https://nuxtjs.org/" target="_blank" class="button--green">Documentation</a>
- <a href="https://github.com/nuxt/nuxt.js" target="_blank" class="button--grey">GitHub</a>
- </div>
- </div>
- </section>
-</template>
-
-<script lang="coffee">
-import Logo from '~/components/Logo.vue'
-
-export default {
- components: { Logo }
- computed:
- message: -> @$store.state.message
-}
-</script>
-
-<style>
-.container {
- min-height: 100vh;
- display: flex;
- justify-content: center;
- align-items: center;
- text-align: center;
-}
-
-.title {
- font-family: "Quicksand", "Source Sans Pro", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif; /* 1 */
- display: block;
- font-weight: 300;
- font-size: 100px;
- color: #35495e;
- letter-spacing: 1px;
-}
-
-.subtitle {
- font-weight: 300;
- font-size: 42px;
- color: #526488;
- word-spacing: 5px;
- padding-bottom: 15px;
-}
-
-.links {
- padding-top: 15px;
-}
-</style>
diff --git a/examples/coffeescript/static/favicon.ico b/examples/coffeescript/static/favicon.ico
deleted file mode 100644
index 382fecbbf96d..000000000000
Binary files a/examples/coffeescript/static/favicon.ico and /dev/null differ
diff --git a/examples/coffeescript/store/index.coffee b/examples/coffeescript/store/index.coffee
deleted file mode 100644
index 6f3287b80650..000000000000
--- a/examples/coffeescript/store/index.coffee
+++ /dev/null
@@ -1,2 +0,0 @@
-export state = ->
- message: 'Hello CoffeeScript!'
diff --git a/examples/custom-build/README.md b/examples/custom-build/README.md
deleted file mode 100644
index b72faaed0a5b..000000000000
--- a/examples/custom-build/README.md
+++ /dev/null
@@ -1 +0,0 @@
-# Nuxt with customised build step
diff --git a/examples/custom-build/assets/nuxt.png b/examples/custom-build/assets/nuxt.png
deleted file mode 100644
index a48bda6be88f..000000000000
Binary files a/examples/custom-build/assets/nuxt.png and /dev/null differ
diff --git a/examples/custom-build/nuxt.config.js b/examples/custom-build/nuxt.config.js
deleted file mode 100644
index b2f4edb1864e..000000000000
--- a/examples/custom-build/nuxt.config.js
+++ /dev/null
@@ -1,25 +0,0 @@
-export default {
- build: {
- filenames: {
- css: 'styles.[contenthash].css', // default: common.[contenthash].css
- manifest: 'manifest.[contenthash].js', // default: manifest.[contenthash].js
- app: 'app.[contenthash].js' // default: nuxt.bundle.[contenthash].js
- },
- extend (config, { isDev }) {
- if (isDev) {
- config.devtool = 'eval-source-map'
- }
-
- config.module.rules.some((loader) => {
- if (loader.use) {
- const urlLoader = loader.use.find(use => use.loader === 'url-loader')
- if (urlLoader) {
- // Increase limit to 100KO
- urlLoader.options.limit = 100000
- return true
- }
- }
- })
- }
- }
-}
diff --git a/examples/custom-build/package.json b/examples/custom-build/package.json
deleted file mode 100644
index 07ce2d2076f8..000000000000
--- a/examples/custom-build/package.json
+++ /dev/null
@@ -1,13 +0,0 @@
-{
- "name": "example-custom-build",
- "description": "",
- "dependencies": {
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/custom-build/pages/index.vue b/examples/custom-build/pages/index.vue
deleted file mode 100644
index b1f35869f299..000000000000
--- a/examples/custom-build/pages/index.vue
+++ /dev/null
@@ -1,15 +0,0 @@
-<template>
- <div class="container">
- <p><img src="~/assets/nuxt.png"></p>
- <p>This image is included as data:image/png;base64...</p>
- <p>In the source code, the files generated are based on the build.filenames data.</p>
- </div>
-</template>
-
-<style>
-.container {
- font-size: 20px;
- text-align: center;
- padding: 100px;
-}
-</style>
diff --git a/examples/custom-layouts/README.md b/examples/custom-layouts/README.md
deleted file mode 100644
index 096465680446..000000000000
--- a/examples/custom-layouts/README.md
+++ /dev/null
@@ -1,5 +0,0 @@
-# Nuxt layouts
-
-https://nuxtjs.org/examples/layouts
-
-Read more on Nuxt layouts [here](https://nuxtjs.org/guide/views#layouts)
diff --git a/examples/custom-layouts/layouts/dark.vue b/examples/custom-layouts/layouts/dark.vue
deleted file mode 100644
index 5c414543b71f..000000000000
--- a/examples/custom-layouts/layouts/dark.vue
+++ /dev/null
@@ -1,24 +0,0 @@
-<template>
- <div class="dark">
- <Nuxt />
- </div>
-</template>
-
-<style>
-body {
- overflow: hidden;
-}
-.dark {
- position: absolute;
- top: 0;
- left: 0;
- width: 100%;
- min-height: 100%;
- background: black;
- color: white;
- padding: 10px;
-}
-.dark a {
- color: white;
-}
-</style>
diff --git a/examples/custom-layouts/layouts/default.vue b/examples/custom-layouts/layouts/default.vue
deleted file mode 100644
index 1aea542319f2..000000000000
--- a/examples/custom-layouts/layouts/default.vue
+++ /dev/null
@@ -1,15 +0,0 @@
-<template>
- <div>
- <img src="logo.png">
- <Nuxt />
- </div>
-</template>
-
-<style scoped>
-img {
- position: fixed;
- top: 20px;
- right: 20px;
- z-index: 1000;
-}
-</style>
diff --git a/examples/custom-layouts/layouts/error.vue b/examples/custom-layouts/layouts/error.vue
deleted file mode 100644
index b30b3c7912f3..000000000000
--- a/examples/custom-layouts/layouts/error.vue
+++ /dev/null
@@ -1,35 +0,0 @@
-<template>
- <div class="container">
- <h1 v-if="error.statusCode === 404">
- Page not found
- </h1>
- <h1 v-else>
- An error occurred
- </h1>
- <NuxtLink to="/">
- Home page
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- props: {
- error: {
- type: Object,
- default: null
- }
- }
-}
-</script>
-
-<style scoped>
-.container {
- font-family: sans-serif;
- padding-top: 10%;
- text-align: center;
-}
-h1 {
- font-size: 20px;
-}
-</style>
diff --git a/examples/custom-layouts/package.json b/examples/custom-layouts/package.json
deleted file mode 100644
index 847a5dc02938..000000000000
--- a/examples/custom-layouts/package.json
+++ /dev/null
@@ -1,12 +0,0 @@
-{
- "name": "example-custom-layouts",
- "dependencies": {
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/custom-layouts/pages/about.vue b/examples/custom-layouts/pages/about.vue
deleted file mode 100644
index 5b47e7c6efcf..000000000000
--- a/examples/custom-layouts/pages/about.vue
+++ /dev/null
@@ -1,19 +0,0 @@
-<template>
- <div>
- <p>Hi from {{ name }}</p>
- <NuxtLink to="/">
- Home page
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- layout: 'dark',
- asyncData ({ req }) {
- return {
- name: req ? 'server' : 'client'
- }
- }
-}
-</script>
diff --git a/examples/custom-layouts/pages/index.vue b/examples/custom-layouts/pages/index.vue
deleted file mode 100644
index 658ac5ac1def..000000000000
--- a/examples/custom-layouts/pages/index.vue
+++ /dev/null
@@ -1,8 +0,0 @@
-<template>
- <div class="container">
- <h1>Welcome!</h1>
- <NuxtLink to="/about">
- About page
- </NuxtLink>
- </div>
-</template>
diff --git a/examples/custom-layouts/static/logo.png b/examples/custom-layouts/static/logo.png
deleted file mode 100644
index 7f238b598c85..000000000000
Binary files a/examples/custom-layouts/static/logo.png and /dev/null differ
diff --git a/examples/custom-loading/README.md b/examples/custom-loading/README.md
deleted file mode 100644
index f69dd97ea5a6..000000000000
--- a/examples/custom-loading/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Custom loading with Nuxt.js
-
-https://nuxtjs.org/examples/custom-loading
diff --git a/examples/custom-loading/components/loading.vue b/examples/custom-loading/components/loading.vue
deleted file mode 100644
index 2cbaa5b346a5..000000000000
--- a/examples/custom-loading/components/loading.vue
+++ /dev/null
@@ -1,36 +0,0 @@
-<template>
- <div v-if="loading" class="loading-page">
- <p>Loading...</p>
- </div>
-</template>
-
-<script>
-export default {
- data: () => ({
- loading: false
- }),
- methods: {
- start () {
- this.loading = true
- },
- finish () {
- this.loading = false
- }
- }
-}
-</script>
-
-<style scoped>
-.loading-page {
- position: fixed;
- top: 0;
- left: 0;
- width: 100%;
- height: 100%;
- background: rgba(255, 255, 255, 0.8);
- text-align: center;
- padding-top: 200px;
- font-size: 30px;
- font-family: sans-serif;
-}
-</style>
diff --git a/examples/custom-loading/nuxt.config.js b/examples/custom-loading/nuxt.config.js
deleted file mode 100644
index f39ade9d8008..000000000000
--- a/examples/custom-loading/nuxt.config.js
+++ /dev/null
@@ -1,3 +0,0 @@
-export default {
- loading: '~/components/loading.vue'
-}
diff --git a/examples/custom-loading/package.json b/examples/custom-loading/package.json
deleted file mode 100644
index e717c873baa0..000000000000
--- a/examples/custom-loading/package.json
+++ /dev/null
@@ -1,12 +0,0 @@
-{
- "name": "example-custom-loading",
- "dependencies": {
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/custom-loading/pages/about.vue b/examples/custom-loading/pages/about.vue
deleted file mode 100644
index 54b8039f030e..000000000000
--- a/examples/custom-loading/pages/about.vue
+++ /dev/null
@@ -1,28 +0,0 @@
-<template>
- <div class="container">
- <p>About Page</p>
- <NuxtLink to="/">
- Go to /
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- asyncData () {
- return new Promise((resolve) => {
- setTimeout(function () {
- resolve({})
- }, 1000)
- })
- }
-}
-</script>
-
-<style scoped>
-.container {
- font-size: 20px;
- text-align: center;
- padding-top: 100px;
-}
-</style>
diff --git a/examples/custom-loading/pages/index.vue b/examples/custom-loading/pages/index.vue
deleted file mode 100644
index 6dcfa37a3204..000000000000
--- a/examples/custom-loading/pages/index.vue
+++ /dev/null
@@ -1,28 +0,0 @@
-<template>
- <div class="container">
- <p>Hello {{ name }}!</p>
- <NuxtLink to="/about">
- Go to /about
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- asyncData () {
- return new Promise((resolve) => {
- setTimeout(function () {
- resolve({ name: 'world' })
- }, 1000)
- })
- }
-}
-</script>
-
-<style scoped>
-.container {
- font-size: 20px;
- text-align: center;
- padding-top: 100px;
-}
-</style>
diff --git a/examples/custom-page-loading/README.md b/examples/custom-page-loading/README.md
deleted file mode 100644
index 9ed60e75ca66..000000000000
--- a/examples/custom-page-loading/README.md
+++ /dev/null
@@ -1,5 +0,0 @@
-# Custom page loading with Nuxt.js
-
-https://nuxtjs.org/examples/custom-page-loading
-
-Use `loading: false` in page to manually call $loading.finish() and $loading.start() methods.
diff --git a/examples/custom-page-loading/package.json b/examples/custom-page-loading/package.json
deleted file mode 100644
index 202221c4614c..000000000000
--- a/examples/custom-page-loading/package.json
+++ /dev/null
@@ -1,12 +0,0 @@
-{
- "name": "example-custom-page-loading",
- "dependencies": {
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/custom-page-loading/pages/about.vue b/examples/custom-page-loading/pages/about.vue
deleted file mode 100644
index f6a157d25d80..000000000000
--- a/examples/custom-page-loading/pages/about.vue
+++ /dev/null
@@ -1,53 +0,0 @@
-<template>
- <div class="container">
- <p>About Page</p>
- <p>It should take 5 seconds for the loader to disappear</p>
- <p>
- It should take 5 seconds for the route to change after you
- <span class="link" @click="goToFinal">
- click here
- </span>
- </p>
- </div>
-</template>
-
-<script>
-export default {
- loading: false,
- asyncData () {
- return new Promise((resolve) => {
- setTimeout(function () {
- resolve({})
- }, 1000)
- })
- },
- mounted () {
- setTimeout(() => {
- // Extend loader for an additional 5s
- this.$nuxt.$loading.finish()
- }, 5000)
- },
- methods: {
- goToFinal () {
- // Start loader immediately
- this.$nuxt.$loading.start()
- // Actually change route 5s later
- setTimeout(() => {
- this.$router.push('/final')
- }, 5000)
- }
- }
-}
-</script>
-
-<style scoped>
-.link {
- cursor: pointer;
- text-decoration: underline;
-}
-.container {
- font-size: 20px;
- text-align: center;
- padding-top: 100px;
-}
-</style>
diff --git a/examples/custom-page-loading/pages/final.vue b/examples/custom-page-loading/pages/final.vue
deleted file mode 100644
index fca5638c2891..000000000000
--- a/examples/custom-page-loading/pages/final.vue
+++ /dev/null
@@ -1,21 +0,0 @@
-<template>
- <div class="container">
- <p>Final Page</p>
- <NuxtLink to="/">
- Go to /
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
-}
-</script>
-
-<style scoped>
-.container {
- font-size: 20px;
- text-align: center;
- padding-top: 100px;
-}
-</style>
diff --git a/examples/custom-page-loading/pages/index.vue b/examples/custom-page-loading/pages/index.vue
deleted file mode 100644
index 6dcfa37a3204..000000000000
--- a/examples/custom-page-loading/pages/index.vue
+++ /dev/null
@@ -1,28 +0,0 @@
-<template>
- <div class="container">
- <p>Hello {{ name }}!</p>
- <NuxtLink to="/about">
- Go to /about
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- asyncData () {
- return new Promise((resolve) => {
- setTimeout(function () {
- resolve({ name: 'world' })
- }, 1000)
- })
- }
-}
-</script>
-
-<style scoped>
-.container {
- font-size: 20px;
- text-align: center;
- padding-top: 100px;
-}
-</style>
diff --git a/examples/custom-port-host/README.md b/examples/custom-port-host/README.md
deleted file mode 100644
index 886caac31910..000000000000
--- a/examples/custom-port-host/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Custom PORT and HOST in `nuxt.config.js` with Nuxt.js
-
-https://nuxtjs.org/examples/custom-port-host
diff --git a/examples/custom-port-host/nuxt.config.js b/examples/custom-port-host/nuxt.config.js
deleted file mode 100644
index 14bac0434e3f..000000000000
--- a/examples/custom-port-host/nuxt.config.js
+++ /dev/null
@@ -1,6 +0,0 @@
-export default {
- server: {
- port: 8000,
- host: '0.0.0.0'
- }
-}
diff --git a/examples/custom-port-host/package.json b/examples/custom-port-host/package.json
deleted file mode 100644
index 151d727e878a..000000000000
--- a/examples/custom-port-host/package.json
+++ /dev/null
@@ -1,12 +0,0 @@
-{
- "name": "example-custom-port-host",
- "dependencies": {
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/custom-port-host/pages/index.vue b/examples/custom-port-host/pages/index.vue
deleted file mode 100644
index fb48acc3961f..000000000000
--- a/examples/custom-port-host/pages/index.vue
+++ /dev/null
@@ -1,3 +0,0 @@
-<template>
- <p>Set port and host in <code>nuxt.config.js</code>.</p>
-</template>
diff --git a/examples/custom-routes/README.md b/examples/custom-routes/README.md
deleted file mode 100644
index 3a95b0d8bf40..000000000000
--- a/examples/custom-routes/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Custom Routes with Nuxt.js
-
-https://nuxtjs.org/examples/custom-routes
diff --git a/examples/custom-routes/nuxt.config.js b/examples/custom-routes/nuxt.config.js
deleted file mode 100644
index efba7fa6977a..000000000000
--- a/examples/custom-routes/nuxt.config.js
+++ /dev/null
@@ -1,2 +0,0 @@
-export default {
-}
diff --git a/examples/custom-routes/package.json b/examples/custom-routes/package.json
deleted file mode 100644
index 6c18c3607a70..000000000000
--- a/examples/custom-routes/package.json
+++ /dev/null
@@ -1,13 +0,0 @@
-{
- "name": "example-custom-routes",
- "dependencies": {
- "axios": "^0.19.0",
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/custom-routes/pages/index.vue b/examples/custom-routes/pages/index.vue
deleted file mode 100644
index 52c3ddbff0a4..000000000000
--- a/examples/custom-routes/pages/index.vue
+++ /dev/null
@@ -1,46 +0,0 @@
-<template>
- <div class="container">
- <h2>Users</h2>
- <ul class="users">
- <li v-for="user in users" :key="user.id">
- <NuxtLink :to="'/users/'+user.id">
- {{ user.name }}
- </NuxtLink>
- </li>
- </ul>
- </div>
-</template>
-
-<script>
-import axios from 'axios'
-
-export default {
- async asyncData () {
- const { data } = await axios.get('https://jsonplaceholder.typicode.com/users')
- return { users: data }
- }
-}
-</script>
-
-<style scoped>
-.container {
- text-align: center;
- margin-top: 100px;
- font-family: sans-serif;
-}
-.users {
- list-style-type: none;
-}
-.users li a {
- display: inline-block;
- width: 200px;
- border: 1px #ddd solid;
- padding: 10px;
- text-align: left;
- color: #222;
- text-decoration: none;
-}
-.users li a:hover {
- color: orange;
-}
-</style>
diff --git a/examples/custom-routes/pages/users/_id.vue b/examples/custom-routes/pages/users/_id.vue
deleted file mode 100644
index 2c18f811f6fb..000000000000
--- a/examples/custom-routes/pages/users/_id.vue
+++ /dev/null
@@ -1,38 +0,0 @@
-<template>
- <div class="user">
- <h3>{{ name }}</h3>
- <h4>@{{ username }}</h4>
- <p>Email : {{ email }}</p>
- <p>
- <NuxtLink to="/">
- List of users
- </NuxtLink>
- </p>
- </div>
-</template>
-
-<script>
-import axios from 'axios'
-
-export default {
- validate ({ params }) {
- return !isNaN(+params.id)
- },
- async asyncData ({ params, error }) {
- try {
- const { data } = await axios.get(`https://jsonplaceholder.typicode.com/users/${+params.id}`)
- return data
- } catch (e) {
- error({ message: 'User not found', statusCode: 404 })
- }
- }
-}
-</script>
-
-<style scoped>
-.user {
- text-align: center;
- margin-top: 100px;
- font-family: sans-serif;
-}
-</style>
diff --git a/examples/custom-server/README.md b/examples/custom-server/README.md
deleted file mode 100644
index 9235bee4da5f..000000000000
--- a/examples/custom-server/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Nuxt with custom [Express](https://expressjs.com/) Server
-
-> Express ia a fast, unopinionated, minimalist web framework for Node.js
diff --git a/examples/custom-server/package.json b/examples/custom-server/package.json
deleted file mode 100644
index a608690fcb05..000000000000
--- a/examples/custom-server/package.json
+++ /dev/null
@@ -1,13 +0,0 @@
-{
- "name": "example-custom-server",
- "dependencies": {
- "express": "^4.15.3",
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "node server.js",
- "build": "nuxt build",
- "start": "NODE_ENV=production node server.js",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/custom-server/pages/index.vue b/examples/custom-server/pages/index.vue
deleted file mode 100644
index b8f045cab60b..000000000000
--- a/examples/custom-server/pages/index.vue
+++ /dev/null
@@ -1,7 +0,0 @@
-<template>
- <p>
- Please look at <code>server.js</code> to see how to use <a href="https://nuxtjs.org">
- Nuxt.js
- </a> programmatically.
- </p>
-</template>
diff --git a/examples/custom-server/server.js b/examples/custom-server/server.js
deleted file mode 100644
index ab0c16eae1d6..000000000000
--- a/examples/custom-server/server.js
+++ /dev/null
@@ -1,25 +0,0 @@
-import express from 'express'
-import { Nuxt, Builder } from 'nuxt'
-
-const app = express()
-
-const host = process.env.HOST || '127.0.0.1'
-const port = process.env.PORT || 3000
-
-// Import and set Nuxt.js options
-const config = require('./nuxt.config.js')
-config.dev = process.env.NODE_ENV !== 'production'
-
-const nuxt = new Nuxt(config)
-
-// Start build process in dev mode
-if (config.dev) {
- const builder = new Builder(nuxt)
- builder.build()
-}
-
-// Give nuxt middleware to express
-app.use(nuxt.render)
-
-// Start express server
-app.listen(port, host)
diff --git a/examples/custom-template/app.html b/examples/custom-template/app.html
deleted file mode 100644
index 7ca7bf601fd6..000000000000
--- a/examples/custom-template/app.html
+++ /dev/null
@@ -1,13 +0,0 @@
-<html>
- <head>
- {{ HEAD }}
- {% if (ENV.NODE_ENV === 'dev') { %}
- <!-- debug scripts -->
- {% } else if (ENV.NODE_ENV === 'production') { %}
- <!-- production scripts -->
- {% } %}
- </head>
- <body>
- {{ APP }}
- </body>
-</html>
\ No newline at end of file
diff --git a/examples/custom-template/nuxt.config.js b/examples/custom-template/nuxt.config.js
deleted file mode 100644
index dcb73ae94449..000000000000
--- a/examples/custom-template/nuxt.config.js
+++ /dev/null
@@ -1,5 +0,0 @@
-module.exports = {
- env: {
- NODE_ENV: process.env.NODE_ENV
- }
-}
diff --git a/examples/custom-template/package.json b/examples/custom-template/package.json
deleted file mode 100644
index 947bf1ab1181..000000000000
--- a/examples/custom-template/package.json
+++ /dev/null
@@ -1,12 +0,0 @@
-{
- "name": "example-custom-template",
- "dependencies": {
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/custom-template/pages/index.vue b/examples/custom-template/pages/index.vue
deleted file mode 100644
index bd5ee17b4b45..000000000000
--- a/examples/custom-template/pages/index.vue
+++ /dev/null
@@ -1,5 +0,0 @@
-<template>
- <div class="container">
- <h1>Welcome!</h1>
- </div>
-</template>
diff --git a/examples/docker-build/.dockerignore b/examples/docker-build/.dockerignore
deleted file mode 100644
index f935a370cd45..000000000000
--- a/examples/docker-build/.dockerignore
+++ /dev/null
@@ -1,84 +0,0 @@
-# Created by .ignore support plugin (hsz.mobi)
-### Node template
-# Logs
-logs
-*.log
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-
-# Runtime data
-pids
-*.pid
-*.seed
-*.pid.lock
-
-# Directory for instrumented libs generated by jscoverage/JSCover
-lib-cov
-
-# Coverage directory used by tools like istanbul
-coverage
-
-# nyc test coverage
-.nyc_output
-
-# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
-.grunt
-
-# Bower dependency directory (https://bower.io/)
-bower_components
-
-# node-waf configuration
-.lock-wscript
-
-# Compiled binary addons (https://nodejs.org/api/addons.html)
-build/Release
-
-# Dependency directories
-node_modules/
-jspm_packages/
-
-# TypeScript v1 declaration files
-typings/
-
-# Optional npm cache directory
-.npm
-
-# Optional eslint cache
-.eslintcache
-
-# Optional REPL history
-.node_repl_history
-
-# Output of 'npm pack'
-*.tgz
-
-# Yarn Integrity file
-.yarn-integrity
-
-# dotenv environment variables file
-.env
-
-# parcel-bundler cache (https://parceljs.org/)
-.cache
-
-# next.js build output
-.next
-
-# nuxt.js build output
-.nuxt
-
-# Nuxt generate
-dist
-
-# vuepress build output
-.vuepress/dist
-
-# Serverless directories
-.serverless
-
-# IDE
-.idea
-
-# Service worker
-sw.*
diff --git a/examples/docker-build/.yarnclean b/examples/docker-build/.yarnclean
deleted file mode 100644
index 846be8d4e397..000000000000
--- a/examples/docker-build/.yarnclean
+++ /dev/null
@@ -1,5 +0,0 @@
-*.yaml
-*.md
-*.lock
-LICENSE
-CHANGELOG
diff --git a/examples/docker-build/Dockerfile b/examples/docker-build/Dockerfile
deleted file mode 100644
index 205325fba8b0..000000000000
--- a/examples/docker-build/Dockerfile
+++ /dev/null
@@ -1,31 +0,0 @@
-FROM node:latest as builder
-
-WORKDIR /src
-
-COPY . .
-
-RUN yarn install \
- --prefer-offline \
- --frozen-lockfile \
- --non-interactive \
- --production=false
-
-RUN yarn build
-
-RUN rm -rf node_modules && \
- NODE_ENV=production yarn install \
- --prefer-offline \
- --pure-lockfile \
- --non-interactive \
- --production=true
-
-FROM node:alpine
-
-WORKDIR /src
-
-COPY --from=builder /src .
-
-ENV HOST 0.0.0.0
-EXPOSE 3000
-
-CMD [ "yarn", "start" ]
diff --git a/examples/docker-build/README.md b/examples/docker-build/README.md
deleted file mode 100644
index a30871800605..000000000000
--- a/examples/docker-build/README.md
+++ /dev/null
@@ -1,12 +0,0 @@
-# docker-build
-
-## Build Setup
-
-```bash
-# Build a nuxt-docker image
-$ docker build -t nuxt-docker .
-
-# Run the container for the nuxt-docker image with a exposed port 3000
-$ docker run --rm -it -p 3000:3000 nuxt-docker
-
-```
diff --git a/examples/docker-build/assets/README.md b/examples/docker-build/assets/README.md
deleted file mode 100644
index 56f854589847..000000000000
--- a/examples/docker-build/assets/README.md
+++ /dev/null
@@ -1 +0,0 @@
-# ASSETS
diff --git a/examples/docker-build/components/README.md b/examples/docker-build/components/README.md
deleted file mode 100644
index 6bd97512d80d..000000000000
--- a/examples/docker-build/components/README.md
+++ /dev/null
@@ -1 +0,0 @@
-# COMPONENTS
diff --git a/examples/docker-build/layouts/README.md b/examples/docker-build/layouts/README.md
deleted file mode 100644
index dc04186c20b3..000000000000
--- a/examples/docker-build/layouts/README.md
+++ /dev/null
@@ -1 +0,0 @@
-# LAYOUTS
diff --git a/examples/docker-build/layouts/default.vue b/examples/docker-build/layouts/default.vue
deleted file mode 100644
index ed5693313912..000000000000
--- a/examples/docker-build/layouts/default.vue
+++ /dev/null
@@ -1,8 +0,0 @@
-<template>
- <div>
- <nuxt />
- </div>
-</template>
-
-<style>
-</style>
diff --git a/examples/docker-build/middleware/README.md b/examples/docker-build/middleware/README.md
deleted file mode 100644
index a98e70894901..000000000000
--- a/examples/docker-build/middleware/README.md
+++ /dev/null
@@ -1 +0,0 @@
-# MIDDLEWARE
diff --git a/examples/docker-build/nuxt.config.js b/examples/docker-build/nuxt.config.js
deleted file mode 100644
index 2f5df58a7e6b..000000000000
--- a/examples/docker-build/nuxt.config.js
+++ /dev/null
@@ -1,54 +0,0 @@
-import pkg from './package'
-
-export default {
- mode: 'universal',
-
- /*
- ** Headers of the page
- */
- head: {
- title: pkg.name,
- meta: [
- { charset: 'utf-8' },
- { name: 'viewport', content: 'width=device-width, initial-scale=1' },
- { hid: 'description', name: 'description', content: pkg.description }
- ],
- link: [
- { rel: 'icon', type: 'image/x-icon', href: '/favicon.ico' }
- ]
- },
-
- /*
- ** Customize the progress-bar color
- */
- loading: { color: '#fff' },
-
- /*
- ** Global CSS
- */
- css: [
- ],
-
- /*
- ** Plugins to load before mounting the App
- */
- plugins: [
- ],
-
- /*
- ** Nuxt.js modules
- */
- modules: [
- ],
-
- /*
- ** Build configuration
- */
- build: {
- /*
- ** You can extend webpack config here
- */
- extend (config, ctx) {
- }
- }
-}
diff --git a/examples/docker-build/package.json b/examples/docker-build/package.json
deleted file mode 100644
index 36d835a783a5..000000000000
--- a/examples/docker-build/package.json
+++ /dev/null
@@ -1,15 +0,0 @@
-{
- "name": "docker-build",
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt-start",
- "generate": "nuxt generate"
- },
- "dependencies": {
- "nuxt-start": "latest"
- },
- "devDependencies": {
- "nuxt": "latest"
- }
-}
diff --git a/examples/docker-build/pages/README.md b/examples/docker-build/pages/README.md
deleted file mode 100644
index 2a7198f3d0ea..000000000000
--- a/examples/docker-build/pages/README.md
+++ /dev/null
@@ -1 +0,0 @@
-# PAGES
diff --git a/examples/docker-build/pages/index.vue b/examples/docker-build/pages/index.vue
deleted file mode 100644
index 050f57356947..000000000000
--- a/examples/docker-build/pages/index.vue
+++ /dev/null
@@ -1,12 +0,0 @@
-<template>
- <div>
- <h1>It works!</h1>
- </div>
-</template>
-
-<script>
-export default {}
-</script>
-
-<style>
-</style>
diff --git a/examples/docker-build/plugins/README.md b/examples/docker-build/plugins/README.md
deleted file mode 100644
index 49df5d2ddbbb..000000000000
--- a/examples/docker-build/plugins/README.md
+++ /dev/null
@@ -1 +0,0 @@
-# PLUGINS
diff --git a/examples/docker-build/static/README.md b/examples/docker-build/static/README.md
deleted file mode 100644
index 8fce9105971d..000000000000
--- a/examples/docker-build/static/README.md
+++ /dev/null
@@ -1 +0,0 @@
-# STATIC
diff --git a/examples/docker-build/static/favicon.ico b/examples/docker-build/static/favicon.ico
deleted file mode 100644
index 382fecbbf96d..000000000000
Binary files a/examples/docker-build/static/favicon.ico and /dev/null differ
diff --git a/examples/docker-build/store/README.md b/examples/docker-build/store/README.md
deleted file mode 100644
index 0987715ce34d..000000000000
--- a/examples/docker-build/store/README.md
+++ /dev/null
@@ -1 +0,0 @@
-# STORE
diff --git a/examples/dynamic-components/README.md b/examples/dynamic-components/README.md
deleted file mode 100644
index 8b7290300fe7..000000000000
--- a/examples/dynamic-components/README.md
+++ /dev/null
@@ -1,5 +0,0 @@
-# Dynamic Components with Nuxt.js
-
-Demo: https://dynamic-components.nuxtjs.org/
-
-Video: https://www.youtube.com/watch?v=HzDea5-PFaw
diff --git a/examples/dynamic-components/components/chart.js b/examples/dynamic-components/components/chart.js
deleted file mode 100644
index e86302e462b1..000000000000
--- a/examples/dynamic-components/components/chart.js
+++ /dev/null
@@ -1,9 +0,0 @@
-import { Bar } from 'vue-chartjs'
-
-export default {
- extends: Bar,
- props: ['data'],
- mounted () {
- this.renderChart(this.data)
- }
-}
diff --git a/examples/dynamic-components/components/code.vue b/examples/dynamic-components/components/code.vue
deleted file mode 100644
index 6758c983315c..000000000000
--- a/examples/dynamic-components/components/code.vue
+++ /dev/null
@@ -1,23 +0,0 @@
-<template>
- <pre>{{ data }}</pre>
-</template>
-
-<script>
-export default {
- props: {
- data: {
- type: String,
- default: ''
- }
- }
-}
-</script>
-
-<style scoped>
-pre {
- background: #222;
- color: #eee;
- margin: 0;
- padding: 20px;
-}
-</style>
diff --git a/examples/dynamic-components/components/image.vue b/examples/dynamic-components/components/image.vue
deleted file mode 100644
index 2e3e5057012d..000000000000
--- a/examples/dynamic-components/components/image.vue
+++ /dev/null
@@ -1,71 +0,0 @@
-<template>
- <div>
- <img v-if="loaded" :src="data" alt="image">
- <svg
- v-else
- width="60px"
- height="60px"
- xmlns="http://www.w3.org/2000/svg"
- viewBox="0 0 100 100"
- preserveAspectRatio="xMidYMid"
- class="uil-ring"
- >
- <rect
- x="0"
- y="0"
- width="100"
- height="100"
- fill="none"
- class="bk"
- /><defs>
- <filter id="uil-ring-shadow" x="-100%" y="-100%" width="300%" height="300%">
- <feOffset result="offOut" in="SourceGraphic" dx="0" dy="0" /><feGaussianBlur result="blurOut" in="offOut" stdDeviation="0" /><feBlend in="SourceGraphic" in2="blurOut" mode="normal" />
- </filter>
- </defs><path d="M10,50c0,0,0,0.5,0.1,1.4c0,0.5,0.1,1,0.2,1.7c0,0.3,0.1,0.7,0.1,1.1c0.1,0.4,0.1,0.8,0.2,1.2c0.2,0.8,0.3,1.8,0.5,2.8 c0.3,1,0.6,2.1,0.9,3.2c0.3,1.1,0.9,2.3,1.4,3.5c0.5,1.2,1.2,2.4,1.8,3.7c0.3,0.6,0.8,1.2,1.2,1.9c0.4,0.6,0.8,1.3,1.3,1.9 c1,1.2,1.9,2.6,3.1,3.7c2.2,2.5,5,4.7,7.9,6.7c3,2,6.5,3.4,10.1,4.6c3.6,1.1,7.5,1.5,11.2,1.6c4-0.1,7.7-0.6,11.3-1.6 c3.6-1.2,7-2.6,10-4.6c3-2,5.8-4.2,7.9-6.7c1.2-1.2,2.1-2.5,3.1-3.7c0.5-0.6,0.9-1.3,1.3-1.9c0.4-0.6,0.8-1.3,1.2-1.9 c0.6-1.3,1.3-2.5,1.8-3.7c0.5-1.2,1-2.4,1.4-3.5c0.3-1.1,0.6-2.2,0.9-3.2c0.2-1,0.4-1.9,0.5-2.8c0.1-0.4,0.1-0.8,0.2-1.2 c0-0.4,0.1-0.7,0.1-1.1c0.1-0.7,0.1-1.2,0.2-1.7C90,50.5,90,50,90,50s0,0.5,0,1.4c0,0.5,0,1,0,1.7c0,0.3,0,0.7,0,1.1 c0,0.4-0.1,0.8-0.1,1.2c-0.1,0.9-0.2,1.8-0.4,2.8c-0.2,1-0.5,2.1-0.7,3.3c-0.3,1.2-0.8,2.4-1.2,3.7c-0.2,0.7-0.5,1.3-0.8,1.9 c-0.3,0.7-0.6,1.3-0.9,2c-0.3,0.7-0.7,1.3-1.1,2c-0.4,0.7-0.7,1.4-1.2,2c-1,1.3-1.9,2.7-3.1,4c-2.2,2.7-5,5-8.1,7.1 c-0.8,0.5-1.6,1-2.4,1.5c-0.8,0.5-1.7,0.9-2.6,1.3L66,87.7l-1.4,0.5c-0.9,0.3-1.8,0.7-2.8,1c-3.8,1.1-7.9,1.7-11.8,1.8L47,90.8 c-1,0-2-0.2-3-0.3l-1.5-0.2l-0.7-0.1L41.1,90c-1-0.3-1.9-0.5-2.9-0.7c-0.9-0.3-1.9-0.7-2.8-1L34,87.7l-1.3-0.6 c-0.9-0.4-1.8-0.8-2.6-1.3c-0.8-0.5-1.6-1-2.4-1.5c-3.1-2.1-5.9-4.5-8.1-7.1c-1.2-1.2-2.1-2.7-3.1-4c-0.5-0.6-0.8-1.4-1.2-2 c-0.4-0.7-0.8-1.3-1.1-2c-0.3-0.7-0.6-1.3-0.9-2c-0.3-0.7-0.6-1.3-0.8-1.9c-0.4-1.3-0.9-2.5-1.2-3.7c-0.3-1.2-0.5-2.3-0.7-3.3 c-0.2-1-0.3-2-0.4-2.8c-0.1-0.4-0.1-0.8-0.1-1.2c0-0.4,0-0.7,0-1.1c0-0.7,0-1.2,0-1.7C10,50.5,10,50,10,50z" fill="#59ebff" filter="url(#uil-ring-shadow)">
- <animateTransform
- attributeName="transform"
- type="rotate"
- from="0 50 50"
- to="360 50 50"
- repeatCount="indefinite"
- dur="1s"
- />
- </path>
- </svg>
- </div>
-</template>
-
-<script>
-export default {
- props: {
- data: {
- type: String,
- default: ''
- }
- },
- data: () => ({
- loaded: false
- }),
- beforeMount () {
- // Preload image
- const img = new Image()
- img.onload = () => {
- this.loaded = true
- }
- img.src = this.data
- }
-}
-</script>
-
-<style scoped>
-img {
- width: 100%;
- vertical-align: middle;
-}
-svg {
- margin: 20px;
- margin-left: 50%;
- position: relative;
- left: -30px;
-}
-</style>
diff --git a/examples/dynamic-components/components/text.vue b/examples/dynamic-components/components/text.vue
deleted file mode 100644
index 47d2e9c7fd11..000000000000
--- a/examples/dynamic-components/components/text.vue
+++ /dev/null
@@ -1,22 +0,0 @@
-<template>
- <p>
- {{ data }}
- </p>
-</template>
-
-<script>
-export default {
- props: {
- data: {
- type: String,
- default: ''
- }
- }
-}
-</script>
-
-<style scoped>
-p {
- padding: 5px 20px;
-}
-</style>
diff --git a/examples/dynamic-components/js/messages.js b/examples/dynamic-components/js/messages.js
deleted file mode 100644
index de96d0211c65..000000000000
--- a/examples/dynamic-components/js/messages.js
+++ /dev/null
@@ -1,27 +0,0 @@
-export const messages = [
- { component: 'vText', data: 'Welcome to the <b>Dynamic Component</b> demo!' },
- { component: 'vImage', data: 'https://placeimg.com/350/200/animals' },
- { component: 'vCode', data: 'var a = 1;\nvar b = 2;\nb = a;' },
- {
- component: 'vChart',
- data: {
- labels: ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'],
- datasets: [
- {
- label: 'Activity',
- backgroundColor: '#41b883',
- data: [40, 20, 12, 39, 10, 40, 39, 50, 40, 20, 12, 11]
- }
- ]
- }
- },
- { component: 'vText', data: 'End of demo 🎉' }
-]
-
-async function streamMessages (fn, i = 0) {
- if (i >= messages.length) { return }
- await fn(messages[i])
- setTimeout(() => streamMessages(fn, i + 1), 1500)
-}
-
-export default streamMessages
diff --git a/examples/dynamic-components/nuxt.config.js b/examples/dynamic-components/nuxt.config.js
deleted file mode 100644
index cc195cee5ead..000000000000
--- a/examples/dynamic-components/nuxt.config.js
+++ /dev/null
@@ -1,9 +0,0 @@
-export default {
- head: {
- titleTemplate: 'Nuxt.js - Dynamic Components',
- meta: [
- { charset: 'utf-8' },
- { name: 'viewport', content: 'width=device-width, initial-scale=1' }
- ]
- }
-}
diff --git a/examples/dynamic-components/package.json b/examples/dynamic-components/package.json
deleted file mode 100644
index 0fb7f11c8f4d..000000000000
--- a/examples/dynamic-components/package.json
+++ /dev/null
@@ -1,15 +0,0 @@
-{
- "name": "example-dynamic-components",
- "dependencies": {
- "chart.js": "^2.7.3",
- "nuxt": "latest",
- "vue-chartjs": "^3.4.2"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "generate": "nuxt generate",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/dynamic-components/pages/index.vue b/examples/dynamic-components/pages/index.vue
deleted file mode 100755
index e175a881f503..000000000000
--- a/examples/dynamic-components/pages/index.vue
+++ /dev/null
@@ -1,71 +0,0 @@
-<template>
- <div>
- <h1>Nuxt Chat</h1>
- <TransitionGroup name="list" tag="ul">
- <li v-for="(message, index) in messages" :key="index">
- <Component :is="message.component" :data="message.data" />
- </li>
- </TransitionGroup>
- </div>
-</template>
-
-<script>
-import streamMessages from '@/js/messages.js'
-// Dynamic components
-const components = {
- vText: () => import('@/components/text.vue' /* webpackChunkName: "components/text" */),
- vImage: () => import('@/components/image.vue' /* webpackChunkName: "components/image" */),
- vCode: () => import('@/components/code.vue' /* webpackChunkName: "components/code" */),
- vChart: () => import('@/components/chart.js' /* webpackChunkName: "components/chart" */)
-}
-
-export default {
- components,
- data: () => ({
- messages: []
- }),
- mounted () {
- // Listen for incoming messages
- streamMessages(async (message) => {
- // Wait for the component to load before displaying it
- await components[message.component]()
- // Add the message to the list
- this.messages.push(message)
- })
- }
-}
-</script>
-
-<style scoped>
-h1 {
- text-align: center;
- font-family: Helvetica, Arial, sans-serif;
-}
-ul {
- list-style: none;
- margin: 0;
- padding: 0;
- width: 100%;
- max-width: 300px;
- margin: auto;
-}
-
-ul li {
- display: block;
- width: 100%;
- border-radius: 20px;
- margin-bottom: 5px;
- font-family: Helvetica, Arial, sans-serif;
- background: white;
- border: 1px #ddd solid;
- overflow: hidden;
- opacity: 1;
-}
-.list-enter-active, .list-leave-active {
- transition: all 0.4s;
-}
-.list-enter, .list-leave-to {
- opacity: 0;
- transform: translateY(20px);
-}
-</style>
diff --git a/examples/dynamic-components/pages/ssr.vue b/examples/dynamic-components/pages/ssr.vue
deleted file mode 100644
index 2f72661b5d08..000000000000
--- a/examples/dynamic-components/pages/ssr.vue
+++ /dev/null
@@ -1,63 +0,0 @@
-<template>
- <div>
- <h1>Nuxt Chat</h1>
- <TransitionGroup name="list" tag="ul">
- <li v-for="(message, index) in messages" :key="index">
- <Component :is="message.component" :data="message.data" />
- </li>
- </TransitionGroup>
- </div>
-</template>
-
-<script>
-import { messages } from '@/js/messages.js'
-
-// Dynamic components
-const components = {
- vText: () => import('@/components/text.vue' /* webpackChunkName: "components/text" */),
- vImage: () => import('@/components/image.vue' /* webpackChunkName: "components/image" */),
- vCode: () => import('@/components/code.vue' /* webpackChunkName: "components/code" */),
- vChart: () => import('@/components/chart.js' /* webpackChunkName: "components/chart" */)
-}
-
-export default {
- components,
- data: () => ({
- messages
- })
-}
-</script>
-
-<style scoped>
-h1 {
- text-align: center;
- font-family: Helvetica, Arial, sans-serif;
-}
-ul {
- list-style: none;
- margin: 0;
- padding: 0;
- with: 100%;
- max-width: 300px;
- margin: auto;
-}
-
-ul li {
- display: block;
- width: 100%;
- border-radius: 20px;
- margin-bottom: 5px;
- font-family: Helvetica, Arial, sans-serif;
- background: white;
- border: 1px #ddd solid;
- overflow: hidden;
- opacity: 1;
-}
-.list-enter-active, .list-leave-active {
- transition: all 0.4s;
-}
-.list-enter, .list-leave-to {
- opacity: 0;
- transform: translateY(20px);
-}
-</style>
diff --git a/examples/dynamic-layouts/README.md b/examples/dynamic-layouts/README.md
deleted file mode 100644
index baba1117a57c..000000000000
--- a/examples/dynamic-layouts/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Dynamic Layouts
-
-https://nuxtjs.org/examples/layouts
diff --git a/examples/dynamic-layouts/layouts/error.vue b/examples/dynamic-layouts/layouts/error.vue
deleted file mode 100644
index d18a9a7db3b4..000000000000
--- a/examples/dynamic-layouts/layouts/error.vue
+++ /dev/null
@@ -1,36 +0,0 @@
-<template>
- <div class="container">
- <h1 v-if="error.statusCode === 404">
- Page not found
- </h1>
- <h1 v-else>
- An error occurred
- </h1>
- <NuxtLink to="/">
- Home page
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- layout: ({ isMobile }) => isMobile ? 'mobile' : 'default',
- props: {
- error: {
- type: Object,
- default: null
- }
- }
-}
-</script>
-
-<style scoped>
-.container {
- font-family: sans-serif;
- padding-top: 10%;
- text-align: center;
-}
-h1 {
- font-size: 20px;
-}
-</style>
diff --git a/examples/dynamic-layouts/layouts/mobile.vue b/examples/dynamic-layouts/layouts/mobile.vue
deleted file mode 100644
index 2acd7ccee33b..000000000000
--- a/examples/dynamic-layouts/layouts/mobile.vue
+++ /dev/null
@@ -1,39 +0,0 @@
-<template>
- <div class="dark">
- <div class="mobile-banner">
- Mobile website
- </div>
- <Nuxt />
- </div>
-</template>
-
-<style>
-* {
- box-sizing: border-box;
-}
-.dark {
- position: absolute;
- top: 0;
- left: 0;
- width: 100%;
- min-height: 100%;
- background: black;
- color: white;
- padding: 10px;
- padding-top: 40px;
-}
-.dark a {
- color: white;
-}
-.mobile-banner {
- position: absolute;
- top: 0;
- left: 0;
- width: 100%;
- text-align: center;
- padding: 10px;
- background: #333;
- font-family: sans-serif;
- font-size: 13px;
-}
-</style>
diff --git a/examples/dynamic-layouts/middleware/mobile.js b/examples/dynamic-layouts/middleware/mobile.js
deleted file mode 100644
index 179645220bd7..000000000000
--- a/examples/dynamic-layouts/middleware/mobile.js
+++ /dev/null
@@ -1,4 +0,0 @@
-export default function (ctx) {
- const userAgent = ctx.req ? ctx.req.headers['user-agent'] : navigator.userAgent
- ctx.isMobile = /mobile/i.test(userAgent)
-}
diff --git a/examples/dynamic-layouts/nuxt.config.js b/examples/dynamic-layouts/nuxt.config.js
deleted file mode 100644
index 7a6bb49c01f9..000000000000
--- a/examples/dynamic-layouts/nuxt.config.js
+++ /dev/null
@@ -1,10 +0,0 @@
-export default {
- head: {
- meta: [
- { content: 'width=device-width,initial-scale=1', name: 'viewport' }
- ]
- },
- router: {
- middleware: ['mobile']
- }
-}
diff --git a/examples/dynamic-layouts/package.json b/examples/dynamic-layouts/package.json
deleted file mode 100644
index bc28c9614926..000000000000
--- a/examples/dynamic-layouts/package.json
+++ /dev/null
@@ -1,12 +0,0 @@
-{
- "name": "example-dynamic-layouts",
- "dependencies": {
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/dynamic-layouts/pages/about.vue b/examples/dynamic-layouts/pages/about.vue
deleted file mode 100644
index 6703cf58ee6a..000000000000
--- a/examples/dynamic-layouts/pages/about.vue
+++ /dev/null
@@ -1,19 +0,0 @@
-<template>
- <div>
- <p>Hi from {{ name }}</p>
- <NuxtLink to="/">
- Home page
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- layout: ({ isMobile }) => isMobile ? 'mobile' : 'default',
- asyncData ({ req }) {
- return {
- name: req ? 'server' : 'client'
- }
- }
-}
-</script>
diff --git a/examples/dynamic-layouts/pages/index.vue b/examples/dynamic-layouts/pages/index.vue
deleted file mode 100644
index fe2bc2d65945..000000000000
--- a/examples/dynamic-layouts/pages/index.vue
+++ /dev/null
@@ -1,14 +0,0 @@
-<template>
- <div class="container">
- <h1>Welcome!</h1>
- <NuxtLink to="/about">
- About page
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- layout: ({ isMobile }) => isMobile ? 'mobile' : 'default'
-}
-</script>
diff --git a/examples/dynamic-layouts/static/logo.png b/examples/dynamic-layouts/static/logo.png
deleted file mode 100644
index 7f238b598c85..000000000000
Binary files a/examples/dynamic-layouts/static/logo.png and /dev/null differ
diff --git a/examples/global-css/README.md b/examples/global-css/README.md
deleted file mode 100644
index 94f73bf46f00..000000000000
--- a/examples/global-css/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Global CSS with Nuxt.js
-
-https://nuxtjs.org/examples/global-css
diff --git a/examples/global-css/assets/roboto.woff2 b/examples/global-css/assets/roboto.woff2
deleted file mode 100644
index 555f98b12050..000000000000
Binary files a/examples/global-css/assets/roboto.woff2 and /dev/null differ
diff --git a/examples/global-css/css/main.css b/examples/global-css/css/main.css
deleted file mode 100644
index debffff97e01..000000000000
--- a/examples/global-css/css/main.css
+++ /dev/null
@@ -1,22 +0,0 @@
-@font-face {
- font-family: 'Roboto';
- font-style: normal;
- font-weight: 400;
- src: local('Roboto'), local('Roboto-Regular'), url(../assets/roboto.woff2) format('woff2');
- unicode-range: U+0460-052F, U+20B4, U+2DE0-2DFF, U+A640-A69F;
-}
-
-body {
- background: #eee;
- text-align: center;
- padding-top: 30px;
- height: 100%;
- width: 100%;
- position: absolute;
- top: 0;
- left: 0;
- font-family: 'Roboto';
-}
-.content {
- margin-top: 100px;
-}
diff --git a/examples/global-css/nuxt.config.js b/examples/global-css/nuxt.config.js
deleted file mode 100644
index 1846b62750ae..000000000000
--- a/examples/global-css/nuxt.config.js
+++ /dev/null
@@ -1,20 +0,0 @@
-export default {
- head: {
- meta: [
- { charset: 'utf-8' },
- { name: 'viewport', content: 'width=device-width, initial-scale=1' },
- { hid: 'description', name: 'description', content: 'Meta description' }
- ]
- },
- css: [
- 'bulma/css/bulma.css',
- '~/css/main.css'
- ],
- render: {
- bundleRenderer: {
- shouldPreload: (file, type) => {
- return ['script', 'style', 'font'].includes(type)
- }
- }
- }
-}
diff --git a/examples/global-css/package.json b/examples/global-css/package.json
deleted file mode 100644
index d25e597e1479..000000000000
--- a/examples/global-css/package.json
+++ /dev/null
@@ -1,13 +0,0 @@
-{
- "name": "example-global-css",
- "dependencies": {
- "bulma": "^0.5.1",
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/global-css/pages/about.vue b/examples/global-css/pages/about.vue
deleted file mode 100644
index ea7a8d6d7fcb..000000000000
--- a/examples/global-css/pages/about.vue
+++ /dev/null
@@ -1,17 +0,0 @@
-<template>
- <div class="content">
- <h1 class="title">
- Another Page
- </h1>
- <p>
- <NuxtLink to="/" class="button is-medium is-info hvr-wobble-vertical">
- Another button
- </NuxtLink>
- </p>
- <p>
- <NuxtLink to="/">
- Back home
- </NuxtLink>
- </p>
- </div>
-</template>
diff --git a/examples/global-css/pages/index.vue b/examples/global-css/pages/index.vue
deleted file mode 100644
index 4ee0a090b80f..000000000000
--- a/examples/global-css/pages/index.vue
+++ /dev/null
@@ -1,17 +0,0 @@
-<template>
- <div class="content">
- <h1 class="title">
- Custom CSS!
- </h1>
- <p>
- <NuxtLink to="/about" class="button is-medium is-primary hvr-float-shadow">
- I am a button
- </NuxtLink>
- </p>
- <p>
- <NuxtLink to="/about">
- About page
- </NuxtLink>
- </p>
- </div>
-</template>
diff --git a/examples/hello-world/README.md b/examples/hello-world/README.md
deleted file mode 100644
index d64ba5270afd..000000000000
--- a/examples/hello-world/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Hello World with Nuxt.js
-
-https://nuxtjs.org/examples
diff --git a/examples/hello-world/package.json b/examples/hello-world/package.json
deleted file mode 100644
index c1521ad7bf73..000000000000
--- a/examples/hello-world/package.json
+++ /dev/null
@@ -1,12 +0,0 @@
-{
- "name": "example-hello-world",
- "dependencies": {
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/hello-world/pages/about.vue b/examples/hello-world/pages/about.vue
deleted file mode 100755
index 86261e23a86e..000000000000
--- a/examples/hello-world/pages/about.vue
+++ /dev/null
@@ -1,21 +0,0 @@
-<template>
- <div>
- <p>Hi from {{ name }}</p>
- <NLink to="/">
- Home page
- </NLink>
- </div>
-</template>
-
-<script>
-export default {
- asyncData () {
- return {
- name: process.static ? 'static' : (process.server ? 'server' : 'client')
- }
- },
- head: {
- title: 'About page'
- }
-}
-</script>
diff --git a/examples/hello-world/pages/index.vue b/examples/hello-world/pages/index.vue
deleted file mode 100755
index 5b3e5ae01075..000000000000
--- a/examples/hello-world/pages/index.vue
+++ /dev/null
@@ -1,16 +0,0 @@
-<template>
- <div>
- <h1>Welcome!</h1>
- <NLink to="/about">
- About Page
- </NLink>
- </div>
-</template>
-
-<script>
-export default {
- head: {
- title: 'Home page'
- }
-}
-</script>
diff --git a/examples/i18n/README.md b/examples/i18n/README.md
deleted file mode 100644
index 7c41613d0a68..000000000000
--- a/examples/i18n/README.md
+++ /dev/null
@@ -1,5 +0,0 @@
-# Nuxt with i18n
-
-https://nuxtjs.org/examples/i18n
-
-https://github.com/kazupon/vue-i18n
diff --git a/examples/i18n/layouts/default.vue b/examples/i18n/layouts/default.vue
deleted file mode 100644
index 7d970a4dd9d6..000000000000
--- a/examples/i18n/layouts/default.vue
+++ /dev/null
@@ -1,95 +0,0 @@
-<template>
- <div>
- <header class="Header">
- <div class="container">
- <h1 class="Header__Title">
- Nuxt i18n
- </h1>
- <nav class="Header__Menu">
- <NuxtLink :to="$i18n.path('')" class="Header__Link" exact>
- {{ $t('links.home') }}
- </NuxtLink>
- <NuxtLink :to="$i18n.path('about')" class="Header__Link" exact>
- {{ $t('links.about') }}
- </NuxtLink>
- <NuxtLink v-if="$i18n.locale === 'en'" :to="`/fr` + $route.fullPath" class="Header__Link" active-class="none" exact>
- {{ $t('links.french') }}
- </NuxtLink>
- <NuxtLink v-else :to="$route.fullPath.replace(/^\/[^\/]+/, '')" class="Header__Link" active-class="none" exact>
- {{ $t('links.english') }}
- </NuxtLink>
- </nav>
- </div>
- </header>
- <Nuxt />
- </div>
-</template>
-
-<script>
-export default {}
-</script>
-
-<style>
-*, *:before, *:after {
- padding: 0;
- margin: 0;
- box-sizing: border-box;
-}
-html, body {
- background-color: #fff;
- color: #2e2f30;
- letter-spacing: 0.5px;
- font-size: 18px;
- font-family: "Source Sans Pro", Arial, sans-serif;
- height: 100vh;
- margin: 0;
-}
-.container {
- width: 75%;
- margin: 0 auto;
-}
-.container:after {
- content: "";
- display: table;
- clear: both;
-}
-.Header {
- color: #fff;
- height: 80px;
- line-height: 80px;
- background-color: #2e2f30;
-}
-.Header__Title {
- float: left;
- font-weight: 300;
- font-size: 30px;
-}
-.Header__Menu {
- float: right;
-}
-.Header__Link {
- font-size: 16px;
- color: #fff;
- border: 1px solid #fff;
- padding: 7px 12px;
- text-transform: uppercase;
- text-decoration: none;
- border-radius: 5px;
- margin-left: 10px;
-}
-.Header__Link:hover {
- color: #2e2f30;
- background-color: #fff;
-}
-.nuxt-link-active {
- color: cyan;
-}
-.Content {
- padding: 50px 0;
- text-align: center;
-}
-.Content__Title {
- font-weight: 300;
- padding-bottom: 30px;
-}
-</style>
diff --git a/examples/i18n/locales/en.json b/examples/i18n/locales/en.json
deleted file mode 100644
index 898218c0a0ce..000000000000
--- a/examples/i18n/locales/en.json
+++ /dev/null
@@ -1,16 +0,0 @@
-{
- "links": {
- "home": "Home",
- "about": "About",
- "english": "English version",
- "french": "French version"
- },
- "home": {
- "title": "Welcome",
- "introduction": "This is an introduction in English."
- },
- "about": {
- "title": "About",
- "introduction": "This page is made to give you more informations."
- }
-}
diff --git a/examples/i18n/locales/fr.json b/examples/i18n/locales/fr.json
deleted file mode 100644
index b4e96aeb96ee..000000000000
--- a/examples/i18n/locales/fr.json
+++ /dev/null
@@ -1,16 +0,0 @@
-{
- "links": {
- "home": "Accueil",
- "about": "À propos",
- "english": "Version Anglaise",
- "french": "Version Française"
- },
- "home": {
- "title": "Bienvenue",
- "introduction": "Ceci est un texte d'introduction en Français."
- },
- "about": {
- "title": "À propos",
- "introduction": "Cette page est faite pour vous donner plus d'informations."
- }
-}
diff --git a/examples/i18n/middleware/i18n.js b/examples/i18n/middleware/i18n.js
deleted file mode 100644
index 25924c1ab80b..000000000000
--- a/examples/i18n/middleware/i18n.js
+++ /dev/null
@@ -1,21 +0,0 @@
-export default function ({ isHMR, app, store, route, params, error, redirect }) {
- const defaultLocale = app.i18n.fallbackLocale
- // If middleware is called from hot module replacement, ignore it
- if (isHMR) { return }
- // Get locale from params
- const locale = params.lang || defaultLocale
- if (!store.state.locales.includes(locale)) {
- return error({ message: 'This page could not be found.', statusCode: 404 })
- }
- // Set locale
- store.commit('SET_LANG', locale)
- app.i18n.locale = store.state.locale
- // If route is /<defaultLocale>/... -> redirect to /...
- if (locale === defaultLocale && route.fullPath.indexOf('/' + defaultLocale) === 0) {
- const toReplace = '^/' + defaultLocale + (route.fullPath.indexOf('/' + defaultLocale + '/') === 0 ? '/' : '')
- const re = new RegExp(toReplace)
- return redirect(
- route.fullPath.replace(re, '/')
- )
- }
-}
diff --git a/examples/i18n/nuxt.config.js b/examples/i18n/nuxt.config.js
deleted file mode 100644
index 45979caaf293..000000000000
--- a/examples/i18n/nuxt.config.js
+++ /dev/null
@@ -1,10 +0,0 @@
-export default {
- loading: { color: 'cyan' },
- router: {
- middleware: 'i18n'
- },
- plugins: ['~/plugins/i18n.js'],
- generate: {
- routes: ['/', '/about', '/fr', '/fr/about']
- }
-}
diff --git a/examples/i18n/package.json b/examples/i18n/package.json
deleted file mode 100644
index 84105bae7550..000000000000
--- a/examples/i18n/package.json
+++ /dev/null
@@ -1,14 +0,0 @@
-{
- "name": "example-i18n",
- "dependencies": {
- "nuxt": "latest",
- "vue-i18n": "^7.3.2"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "generate": "nuxt generate",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/i18n/pages/_lang/about.vue b/examples/i18n/pages/_lang/about.vue
deleted file mode 100644
index 82aa83fb196d..000000000000
--- a/examples/i18n/pages/_lang/about.vue
+++ /dev/null
@@ -1,18 +0,0 @@
-<template>
- <div class="Content">
- <div class="container">
- <h1 class="Content__Title">
- {{ $t('about.title') }}
- </h1>
- <p>{{ $t('about.introduction') }}</p>
- </div>
- </div>
-</template>
-
-<script>
-export default {
- head () {
- return { title: this.$t('about.title') }
- }
-}
-</script>
diff --git a/examples/i18n/pages/_lang/index.vue b/examples/i18n/pages/_lang/index.vue
deleted file mode 100644
index fc4f7e0795c8..000000000000
--- a/examples/i18n/pages/_lang/index.vue
+++ /dev/null
@@ -1,18 +0,0 @@
-<template>
- <div class="Content">
- <div class="container">
- <h1 class="Content__Title">
- {{ $t('home.title') }}
- </h1>
- <p>{{ $t('home.introduction') }}</p>
- </div>
- </div>
-</template>
-
-<script>
-export default {
- head () {
- return { title: this.$t('home.title') }
- }
-}
-</script>
diff --git a/examples/i18n/pages/about.vue b/examples/i18n/pages/about.vue
deleted file mode 100644
index b080865661ce..000000000000
--- a/examples/i18n/pages/about.vue
+++ /dev/null
@@ -1,4 +0,0 @@
-<script>
-import About from '~/pages/_lang/about'
-export default About
-</script>
diff --git a/examples/i18n/pages/index.vue b/examples/i18n/pages/index.vue
deleted file mode 100644
index f0ca25b6f817..000000000000
--- a/examples/i18n/pages/index.vue
+++ /dev/null
@@ -1,4 +0,0 @@
-<script>
-import Index from '~/pages/_lang/index'
-export default Index
-</script>
diff --git a/examples/i18n/plugins/i18n.js b/examples/i18n/plugins/i18n.js
deleted file mode 100644
index c4ab93796fcd..000000000000
--- a/examples/i18n/plugins/i18n.js
+++ /dev/null
@@ -1,25 +0,0 @@
-import Vue from 'vue'
-import VueI18n from 'vue-i18n'
-
-Vue.use(VueI18n)
-
-export default ({ app, store }) => {
- // Set i18n instance on app
- // This way we can use it in middleware and pages asyncData/fetch
- app.i18n = new VueI18n({
- locale: store.state.locale,
- fallbackLocale: 'en',
- messages: {
- en: require('~/locales/en.json'),
- fr: require('~/locales/fr.json')
- }
- })
-
- app.i18n.path = (link) => {
- if (app.i18n.locale === app.i18n.fallbackLocale) {
- return `/${link}`
- }
-
- return `/${app.i18n.locale}/${link}`
- }
-}
diff --git a/examples/i18n/store/index.js b/examples/i18n/store/index.js
deleted file mode 100644
index 0d7271ea2760..000000000000
--- a/examples/i18n/store/index.js
+++ /dev/null
@@ -1,12 +0,0 @@
-export const state = () => ({
- locales: ['en', 'fr'],
- locale: 'en'
-})
-
-export const mutations = {
- SET_LANG (state, locale) {
- if (state.locales.includes(locale)) {
- state.locale = locale
- }
- }
-}
diff --git a/examples/jest-puppeteer/README.md b/examples/jest-puppeteer/README.md
deleted file mode 100755
index f6e389efe8bb..000000000000
--- a/examples/jest-puppeteer/README.md
+++ /dev/null
@@ -1,43 +0,0 @@
-# Nuxt with [Jest](https://jestjs.io/) and [Puppeteer](https://developers.google.com/web/tools/puppeteer/)
-
-> Jest is a delightful JavaScript Testing Framework with a focus on simplicity.
-
-> Puppeteer is a Node library which provides a high-level API to control headless Chrome or Chromium over the DevTools Protocol.
-
-# Install deps
-```
-npm install
-```
-
-# Run tests
-```
-npm run test
-```
-
-## It will
-- Build app
-- Run server
-- Run tests
-
-### Output
-```
- PASS test/index.spec.js
- Index page
- √ test index title (53ms)
- √ test navigate to about page (2ms)
-
-Test Suites: 1 passed, 1 total
-Tests: 2 passed, 2 total
-Snapshots: 2 passed, 2 total
-Time: 0.992s, estimated 1s
-Ran all test suites.
-```
-
-## Check configuration files:
-- `jest.config.js`
-- `jest-puppeteer.config.js`
-
-## Documentation
-- [jest-puppeteer](https://github.com/smooth-code/jest-puppeteer)
-- [jest](https://jestjs.io/)
-- [puppeteer](https://pptr.dev/)
diff --git a/examples/jest-puppeteer/jest-puppeteer.config.js b/examples/jest-puppeteer/jest-puppeteer.config.js
deleted file mode 100755
index 70c11b412f70..000000000000
--- a/examples/jest-puppeteer/jest-puppeteer.config.js
+++ /dev/null
@@ -1,10 +0,0 @@
-module.exports = {
- launch: {
- headless: process.env.HEADLESS !== 'false'
- },
- server: {
- command: 'npm run testServer',
- port: 3000,
- launchTimeout: 50000
- }
-}
diff --git a/examples/jest-puppeteer/jest.config.js b/examples/jest-puppeteer/jest.config.js
deleted file mode 100755
index 77b369b61dc0..000000000000
--- a/examples/jest-puppeteer/jest.config.js
+++ /dev/null
@@ -1,4 +0,0 @@
-module.exports = {
- verbose: true,
- preset: 'jest-puppeteer'
-}
diff --git a/examples/jest-puppeteer/package.json b/examples/jest-puppeteer/package.json
deleted file mode 100755
index 4c8e2ea28927..000000000000
--- a/examples/jest-puppeteer/package.json
+++ /dev/null
@@ -1,19 +0,0 @@
-{
- "name": "example-jest-puppeteer",
- "dependencies": {
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "test": "jest -w=4",
- "testServer": "nuxt build && nuxt start"
- },
- "devDependencies": {
- "jest": "latest",
- "jest-puppeteer": "latest",
- "puppeteer": "latest",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/jest-puppeteer/pages/about.vue b/examples/jest-puppeteer/pages/about.vue
deleted file mode 100755
index 7730d625bf21..000000000000
--- a/examples/jest-puppeteer/pages/about.vue
+++ /dev/null
@@ -1,23 +0,0 @@
-<template>
- <div>
- <p id="hello-msg">
- Hi from {{ name }}
- </p>
- <NuxtLink to="/">
- Home page
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- asyncData () {
- return {
- name: process.static ? 'static' : (process.server ? 'server' : 'client')
- }
- },
- head: {
- title: 'About page'
- }
-}
-</script>
diff --git a/examples/jest-puppeteer/pages/index.vue b/examples/jest-puppeteer/pages/index.vue
deleted file mode 100755
index 48b6b78c9e98..000000000000
--- a/examples/jest-puppeteer/pages/index.vue
+++ /dev/null
@@ -1,16 +0,0 @@
-<template>
- <div>
- <h1>Welcome!</h1>
- <NuxtLink id="about-link" to="/about">
- About page
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- head: {
- title: 'Home page'
- }
-}
-</script>
diff --git a/examples/jest-puppeteer/test/__snapshots__/index.spec.js.snap b/examples/jest-puppeteer/test/__snapshots__/index.spec.js.snap
deleted file mode 100755
index 7ad881e3b11b..000000000000
--- a/examples/jest-puppeteer/test/__snapshots__/index.spec.js.snap
+++ /dev/null
@@ -1,5 +0,0 @@
-// Jest Snapshot v1, https://goo.gl/fbAQLP
-
-exports[`Index page test index title: index.title 1`] = `"Home page"`;
-
-exports[`Index page test navigation to about page: about.msg 1`] = `"Hi from client"`;
diff --git a/examples/jest-puppeteer/test/index.spec.js b/examples/jest-puppeteer/test/index.spec.js
deleted file mode 100755
index 00aa5f16ff52..000000000000
--- a/examples/jest-puppeteer/test/index.spec.js
+++ /dev/null
@@ -1,32 +0,0 @@
-const devices = require('puppeteer/DeviceDescriptors')
-const iPhone = devices['iPhone 6']
-
-const BASE_URL = 'http://127.0.0.1:3000'
-
-describe('Index page', () => {
- let page
- beforeAll(async () => {
- // eslint-disable-next-line no-undef
- page = await browser.newPage()
- await page.emulate(iPhone)
- await page.goto(BASE_URL)
- })
-
- afterAll(async () => {
- await page.close()
- })
-
- it('test index title', async () => {
- expect.assertions(1)
- const title = await page.evaluate(() => document.title)
- expect(title).toMatchSnapshot('index.title')
- })
-
- it('test navigation to about page', async () => {
- expect.assertions(1)
- await page.click('a#about-link')
- await page.waitForSelector('p#hello-msg')
- const msg = await page.$eval('p#hello-msg', e => e.textContent)
- expect(msg).toMatchSnapshot('about.msg')
- })
-})
diff --git a/examples/jest-vtu-example/.eslintignore b/examples/jest-vtu-example/.eslintignore
deleted file mode 100644
index d6083f1e1a0f..000000000000
--- a/examples/jest-vtu-example/.eslintignore
+++ /dev/null
@@ -1 +0,0 @@
-*.spec.js.snap
diff --git a/examples/jest-vtu-example/.gitignore b/examples/jest-vtu-example/.gitignore
deleted file mode 100644
index 4da44f57b7bf..000000000000
--- a/examples/jest-vtu-example/.gitignore
+++ /dev/null
@@ -1,14 +0,0 @@
-# dependencies
-node_modules
-
-# logs
-npm-debug.log
-
-# Nuxt build
-.nuxt
-
-# Nuxt generate
-dist
-
-# coverage report
-coverage/
diff --git a/examples/jest-vtu-example/README.md b/examples/jest-vtu-example/README.md
deleted file mode 100644
index f1d5b0246058..000000000000
--- a/examples/jest-vtu-example/README.md
+++ /dev/null
@@ -1,13 +0,0 @@
-# Nuxt with [Jest](https://jestjs.io/) and [Vue Test Utils](https://vue-test-utils.vuejs.org/)
-
-> Vue Test Utils is the official unit testing utility library for Vue.js.
-
-> Jest is a delightful JavaScript Testing Framework with a focus on simplicity.
-
-```sh
-# Install dependencies
-npm i # or yarn
-
-# Run tests
-npm test
-```
diff --git a/examples/jest-vtu-example/babel.config.js b/examples/jest-vtu-example/babel.config.js
deleted file mode 100644
index 5b9bf010f83e..000000000000
--- a/examples/jest-vtu-example/babel.config.js
+++ /dev/null
@@ -1,7 +0,0 @@
-module.exports = {
- env: {
- test: {
- presets: ['@babel/preset-env']
- }
- }
-}
diff --git a/examples/jest-vtu-example/components/Btn/Btn.spec.js b/examples/jest-vtu-example/components/Btn/Btn.spec.js
deleted file mode 100644
index 5ead735618c4..000000000000
--- a/examples/jest-vtu-example/components/Btn/Btn.spec.js
+++ /dev/null
@@ -1,36 +0,0 @@
-import { shallowMount } from '@vue/test-utils'
-import Btn from './Btn'
-
-const factory = () => shallowMount(Btn, {
- propsData: {
- label: 'click me!'
- }
-})
-
-describe('Btn', () => {
- test('mounts properly', () => {
- const wrapper = factory()
- expect(wrapper.isVueInstance()).toBeTruthy()
- })
-
- test('renders properly', () => {
- const wrapper = factory()
- expect(wrapper.html()).toMatchSnapshot()
- })
-
- test('calls handleClick on click', () => {
- const wrapper = factory()
- const handleClickMock = jest.fn()
- wrapper.setMethods({
- handleClick: handleClickMock
- })
- wrapper.find('button').trigger('click')
- expect(handleClickMock).toHaveBeenCalled()
- })
-
- test('clicked is true after click', () => {
- const wrapper = factory()
- wrapper.find('button').trigger('click')
- expect(wrapper.vm.clicked).toBe(true)
- })
-})
diff --git a/examples/jest-vtu-example/components/Btn/Btn.vue b/examples/jest-vtu-example/components/Btn/Btn.vue
deleted file mode 100644
index 9f299df35e32..000000000000
--- a/examples/jest-vtu-example/components/Btn/Btn.vue
+++ /dev/null
@@ -1,25 +0,0 @@
-<template>
- <button @click="handleClick">
- {{ label }}
- </button>
-</template>
-
-<script>
-export default {
- name: 'Button',
- props: {
- label: {
- type: String,
- required: true
- }
- },
- data: () => ({
- clicked: false
- }),
- methods: {
- handleClick () {
- this.clicked = true
- }
- }
-}
-</script>
diff --git a/examples/jest-vtu-example/components/Btn/__snapshots__/Btn.spec.js.snap b/examples/jest-vtu-example/components/Btn/__snapshots__/Btn.spec.js.snap
deleted file mode 100644
index 93754d828029..000000000000
--- a/examples/jest-vtu-example/components/Btn/__snapshots__/Btn.spec.js.snap
+++ /dev/null
@@ -1,7 +0,0 @@
-// Jest Snapshot v1, https://goo.gl/fbAQLP
-
-exports[`Btn renders properly 1`] = `
-<button>
- click me!
-</button>
-`;
diff --git a/examples/jest-vtu-example/layouts/default.vue b/examples/jest-vtu-example/layouts/default.vue
deleted file mode 100644
index 0acb4c79974f..000000000000
--- a/examples/jest-vtu-example/layouts/default.vue
+++ /dev/null
@@ -1,5 +0,0 @@
-<template>
- <div>
- <Nuxt />
- </div>
-</template>
diff --git a/examples/jest-vtu-example/nuxt.config.js b/examples/jest-vtu-example/nuxt.config.js
deleted file mode 100644
index f4e276c34194..000000000000
--- a/examples/jest-vtu-example/nuxt.config.js
+++ /dev/null
@@ -1,3 +0,0 @@
-export default {
- mode: 'universal'
-}
diff --git a/examples/jest-vtu-example/package.json b/examples/jest-vtu-example/package.json
deleted file mode 100644
index 3d6edb297735..000000000000
--- a/examples/jest-vtu-example/package.json
+++ /dev/null
@@ -1,47 +0,0 @@
-{
- "name": "example-jest-vtu",
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "generate": "nuxt generate",
- "test": "jest",
- "post-update": "yarn upgrade --latest"
- },
- "dependencies": {
- "nuxt": "latest"
- },
- "devDependencies": {
- "@babel/core": "^7.3.4",
- "@vue/test-utils": "^1.0.0-beta.29",
- "babel-jest": "^24.1.0",
- "jest": "^24.1.0",
- "jest-serializer-vue": "^2.0.2",
- "vue-jest": "^4.0.0-beta.2"
- },
- "jest": {
- "moduleFileExtensions": [
- "js",
- "json",
- "vue"
- ],
- "watchman": false,
- "moduleNameMapper": {
- "^~/(.*)$": "<rootDir>/$1",
- "^~~/(.*)$": "<rootDir>/$1"
- },
- "transform": {
- "^.+\\.js$": "babel-jest",
- ".*\\.(vue)$": "vue-jest"
- },
- "snapshotSerializers": [
- "jest-serializer-vue"
- ],
- "collectCoverage": true,
- "collectCoverageFrom": [
- "<rootDir>/components/**/*.vue",
- "<rootDir>/pages/*.vue"
- ],
- "testURL": "http://localhost/"
- }
-}
diff --git a/examples/jest-vtu-example/pages/__snapshots__/index.spec.js.snap b/examples/jest-vtu-example/pages/__snapshots__/index.spec.js.snap
deleted file mode 100644
index c4bca24d2675..000000000000
--- a/examples/jest-vtu-example/pages/__snapshots__/index.spec.js.snap
+++ /dev/null
@@ -1,12 +0,0 @@
-// Jest Snapshot v1, https://goo.gl/fbAQLP
-
-exports[`index renders properly 1`] = `
-<section class="container">
- <div>
- <h1 class="title">
- jest-vtu-example
- </h1>
- <btn-stub label="click me!"></btn-stub>
- </div>
-</section>
-`;
diff --git a/examples/jest-vtu-example/pages/index.spec.js b/examples/jest-vtu-example/pages/index.spec.js
deleted file mode 100644
index 9b1209abd521..000000000000
--- a/examples/jest-vtu-example/pages/index.spec.js
+++ /dev/null
@@ -1,14 +0,0 @@
-import { shallowMount } from '@vue/test-utils'
-import index from './index'
-
-describe('index', () => {
- test('mounts properly', () => {
- const wrapper = shallowMount(index)
- expect(wrapper.isVueInstance()).toBeTruthy()
- })
-
- test('renders properly', () => {
- const wrapper = shallowMount(index)
- expect(wrapper.html()).toMatchSnapshot()
- })
-})
diff --git a/examples/jest-vtu-example/pages/index.vue b/examples/jest-vtu-example/pages/index.vue
deleted file mode 100644
index 5a30dbb68583..000000000000
--- a/examples/jest-vtu-example/pages/index.vue
+++ /dev/null
@@ -1,20 +0,0 @@
-<template>
- <section class="container">
- <div>
- <h1 class="title">
- jest-vtu-example
- </h1>
- <Btn label="click me!" />
- </div>
- </section>
-</template>
-
-<script>
-import Btn from '~/components/Btn/Btn.vue'
-
-export default {
- components: {
- Btn
- }
-}
-</script>
diff --git a/examples/jsx/README.md b/examples/jsx/README.md
deleted file mode 100644
index 5bcdfae9c373..000000000000
--- a/examples/jsx/README.md
+++ /dev/null
@@ -1,7 +0,0 @@
-# Nuxt with render Functions & JSX Example
-
-## Documentation
-
-Vue: https://vuejs.org/v2/guide/render-function.html
-
-Also see [TSX example](https://github.com/nuxt/typescript/examples/tsx)
diff --git a/examples/jsx/components/test.vue b/examples/jsx/components/test.vue
deleted file mode 100644
index 47d2e9c7fd11..000000000000
--- a/examples/jsx/components/test.vue
+++ /dev/null
@@ -1,22 +0,0 @@
-<template>
- <p>
- {{ data }}
- </p>
-</template>
-
-<script>
-export default {
- props: {
- data: {
- type: String,
- default: ''
- }
- }
-}
-</script>
-
-<style scoped>
-p {
- padding: 5px 20px;
-}
-</style>
diff --git a/examples/jsx/package.json b/examples/jsx/package.json
deleted file mode 100644
index 17a52325ecaf..000000000000
--- a/examples/jsx/package.json
+++ /dev/null
@@ -1,12 +0,0 @@
-{
- "name": "example-jsx",
- "dependencies": {
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/jsx/pages/about.js b/examples/jsx/pages/about.js
deleted file mode 100644
index 0ddc056398b7..000000000000
--- a/examples/jsx/pages/about.js
+++ /dev/null
@@ -1,21 +0,0 @@
-
-import Test from '~/components/test.vue'
-
-export default {
- head: {
- title: 'About Page',
- meta: [
- { hid: 'description', name: 'description', content: 'About page description' }
- ]
- },
- components: {
- Test
- },
- render () {
- return <div class='container'>
- <h1>About page</h1>
- <test data='I am test component' />
- <p><NuxtLink to='/'>Home page</NuxtLink></p>
- </div>
- }
-}
diff --git a/examples/jsx/pages/index.js b/examples/jsx/pages/index.js
deleted file mode 100755
index e1730f93b626..000000000000
--- a/examples/jsx/pages/index.js
+++ /dev/null
@@ -1,20 +0,0 @@
-export default {
- head: {
- title: 'Home page 🚀',
- meta: [
- { hid: 'description', name: 'description', content: 'Home page description' }
- ],
- script: [
- { src: '/head.js' },
- // Supported since 1.0
- { src: '/body.js', body: true },
- { src: '/defer.js', defer: '' }
- ]
- },
- render () {
- return <div class='container'>
- <h1>Home page 🚀</h1>
- <NuxtLink to='/about'>About page</NuxtLink>
- </div>
- }
-}
diff --git a/examples/layout-transitions/README.md b/examples/layout-transitions/README.md
deleted file mode 100644
index 3bdd2a909252..000000000000
--- a/examples/layout-transitions/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Layout transitions with Nuxt.js
-
-https://nuxtjs.org/examples/layout-transitions
diff --git a/examples/layout-transitions/assets/main.css b/examples/layout-transitions/assets/main.css
deleted file mode 100644
index 63b42c3f6f66..000000000000
--- a/examples/layout-transitions/assets/main.css
+++ /dev/null
@@ -1,52 +0,0 @@
-body {
- font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, 'Fira Sans', 'Droid Sans', 'Helvetica Neue', sans-serif;
-}
-
-.container {
- text-align: center;
- padding-top: 200px;
- font-size: 20px;
- transition: all .5s cubic-bezier(.55,0,.1,1);
-}
-
-.page-enter-active, .page-leave-active {
- transition: opacity .5s
-}
-.page-enter, .page-leave-active {
- opacity: 0
-}
-
-.layout-enter-active, .layout-leave-active {
- transition: opacity 0.5s
-}
-.layout-enter, .layout-leave-active {
- opacity: 0
-}
-
-.bounce-enter-active {
- animation: bounce-in .5s;
-}
-.bounce-leave-active {
- animation: bounce-out .5s;
-}
-@keyframes bounce-in {
- 0% { transform: scale(0) }
- 50% { transform: scale(1.5) }
- 100% { transform: scale(1) }
-}
-@keyframes bounce-out {
- 0% { transform: scale(1) }
- 50% { transform: scale(1.5) }
- 100% { transform: scale(0) }
-}
-
-.slide-left-enter,
-.slide-right-leave-active {
- opacity: 0;
- transform: translate(30px, 0);
-}
-.slide-left-leave-active,
-.slide-right-enter {
- opacity: 0;
- transform: translate(-30px, 0);
-}
diff --git a/examples/layout-transitions/layouts/secondary.vue b/examples/layout-transitions/layouts/secondary.vue
deleted file mode 100644
index d1d4d2018b8f..000000000000
--- a/examples/layout-transitions/layouts/secondary.vue
+++ /dev/null
@@ -1,6 +0,0 @@
-<template>
- <div>
- <h1>Secondary Layout</h1>
- <Nuxt />
- </div>
-</template>
diff --git a/examples/layout-transitions/nuxt.config.js b/examples/layout-transitions/nuxt.config.js
deleted file mode 100644
index a8ac6ebd10a7..000000000000
--- a/examples/layout-transitions/nuxt.config.js
+++ /dev/null
@@ -1,7 +0,0 @@
-export default {
- css: ['~/assets/main.css'],
- layoutTransition: {
- name: 'layout',
- mode: 'out-in'
- }
-}
diff --git a/examples/layout-transitions/package.json b/examples/layout-transitions/package.json
deleted file mode 100644
index 480616cf22f5..000000000000
--- a/examples/layout-transitions/package.json
+++ /dev/null
@@ -1,13 +0,0 @@
-{
- "name": "example-layout-transitions",
- "dependencies": {
- "axios": "^0.19.0",
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/layout-transitions/pages/about.vue b/examples/layout-transitions/pages/about.vue
deleted file mode 100644
index 335a493304b2..000000000000
--- a/examples/layout-transitions/pages/about.vue
+++ /dev/null
@@ -1,18 +0,0 @@
-<template>
- <div class="container">
- <h1>About page</h1>
- <NuxtLink to="/">
- Home page
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- layout: 'secondary',
- transition: 'bounce',
- head: {
- title: 'About'
- }
-}
-</script>
diff --git a/examples/layout-transitions/pages/index.vue b/examples/layout-transitions/pages/index.vue
deleted file mode 100644
index a47b1bbf92a7..000000000000
--- a/examples/layout-transitions/pages/index.vue
+++ /dev/null
@@ -1,28 +0,0 @@
-<template>
- <div class="container">
- <h1>Home page</h1>
- <p>
- <NuxtLink to="/about">
- About page
- </NuxtLink>
- </p>
- <p>
- <NuxtLink to="/users">
- Lists of users
- </NuxtLink>
- </p>
- <p>
- <NuxtLink to="/users-2">
- Lists of users #2 (with `watch`)
- </NuxtLink>
- </p>
- </div>
-</template>
-
-<script>
-export default {
- head: {
- title: 'Home'
- }
-}
-</script>
diff --git a/examples/layout-transitions/pages/users-2.vue b/examples/layout-transitions/pages/users-2.vue
deleted file mode 100644
index e8380afdb3a4..000000000000
--- a/examples/layout-transitions/pages/users-2.vue
+++ /dev/null
@@ -1,106 +0,0 @@
-<template>
- <div class="container">
- <NuxtLink v-if="page > 1" :to="'?page=' + (page - 1)">
- < Prev
- </NuxtLink>
- <a v-else class="disabled">
- < Prev
- </a>
- <span>{{ page }}/{{ totalPages }}</span>
- <NuxtLink v-if="page < totalPages" :to="'?page=' + (page + 1)">
- Next >
- </NuxtLink>
- <a v-else class="disabled">
- Next >
- </a>
- <Transition :name="transitionName" mode="out-in">
- <ul :key="page">
- <li v-for="user in users" :key="user.id">
- <img :src="user.avatar" class="avatar">
- <span>{{ user.first_name }} {{ user.last_name }}</span>
- </li>
- </ul>
- </Transition>
- <p>
- <NuxtLink to="/">
- Back home
- </NuxtLink>
- </p>
- </div>
-</template>
-
-<script>
-import axios from 'axios'
-
-export default {
- async asyncData ({ query }) {
- const page = +(query.page || 1)
- const { data } = await axios.get(`https://reqres.in/api/users?page=${page}`)
- return {
- page,
- totalPages: data.total_pages,
- users: data.data
- }
- },
- data () {
- return {
- transitionName: this.getTransitionName(this.page)
- }
- },
- watch: {
- async '$route.query.page' (page) {
- this.$nuxt.$loading.start()
- const { data } = await axios.get(`https://reqres.in/api/users?page=${page}`)
- this.users = data.data
- this.transitionName = this.getTransitionName(page)
- this.page = +(page || 1)
- this.totalPages = data.total_pages
- this.$nuxt.$loading.finish()
- }
- },
- methods: {
- getTransitionName (newPage) {
- return newPage < this.page ? 'slide-right' : 'slide-left'
- }
- },
- head: {
- title: 'Users #2'
- }
-}
-</script>
-
-<style scoped>
-a {
- display: inline-block;
- margin: 0 1em;
- color: #34495e;
- text-decoration: none;
-}
-a.disabled {
- color: #ccc;
-}
-ul {
- margin: auto;
- padding: 0;
- width: 100%;
- max-width: 400px;
- padding-top: 40px;
- transition: all .5s cubic-bezier(.55,0,.1,1);
-}
-li {
- list-style-type: none;
- width: 400px;
- border: 1px #ddd solid;
- overflow: hidden;
-}
-li img {
- float: left;
- width: 100px;
- height: 100px;
-}
-li span {
- display: inline-block;
- padding-top: 40px;
- text-transform: uppercase;
-}
-</style>
diff --git a/examples/layout-transitions/pages/users.vue b/examples/layout-transitions/pages/users.vue
deleted file mode 100644
index 7cccaca33cb8..000000000000
--- a/examples/layout-transitions/pages/users.vue
+++ /dev/null
@@ -1,91 +0,0 @@
-<template>
- <div class="container">
- <NuxtLink v-if="page > 1" :to="'?page=' + (page - 1)">
- < Prev
- </NuxtLink>
- <a v-else class="disabled">
- < Prev
- </a>
- <span>{{ page }}/{{ totalPages }}</span>
- <NuxtLink v-if="page < totalPages" :to="'?page=' + (page + 1)">
- Next >
- </NuxtLink>
- <a v-else class="disabled">
- Next >
- </a>
- <ul>
- <li v-for="user in users" :key="user.id">
- <img :src="user.avatar" class="avatar">
- <span>{{ user.first_name }} {{ user.last_name }}</span>
- </li>
- </ul>
- <p>
- <NuxtLink to="/">
- Back home
- </NuxtLink>
- </p>
- </div>
-</template>
-
-<script>
-import axios from 'axios'
-
-export default {
- // Watch for $route.query.page to call Component methods (asyncData, fetch, validate, layout, etc.)
- watchQuery: ['page'],
- // Key for <NuxtChild> (transitions)
- key: to => to.fullPath,
- // Called to know which transition to apply
- transition (to, from) {
- if (!from) { return 'slide-left' }
- return +to.query.page < +from.query.page ? 'slide-right' : 'slide-left'
- },
- async asyncData ({ query }) {
- const page = +(query.page || 1)
- const { data } = await axios.get(`https://reqres.in/api/users?page=${page}`)
- return {
- page,
- totalPages: data.total_pages,
- users: data.data
- }
- },
- head: {
- title: 'Users'
- }
-}
-</script>
-
-<style scoped>
-a {
- display: inline-block;
- margin: 0 1em;
- color: #34495e;
- text-decoration: none;
-}
-a.disabled {
- color: #ccc;
-}
-ul {
- margin: auto;
- padding: 0;
- width: 100%;
- max-width: 400px;
- padding-top: 40px;
-}
-li {
- list-style-type: none;
- width: 400px;
- border: 1px #ddd solid;
- overflow: hidden;
-}
-li img {
- float: left;
- width: 100px;
- height: 100px;
-}
-li span {
- display: inline-block;
- padding-top: 40px;
- text-transform: uppercase;
-}
-</style>
diff --git a/examples/markdownit/README.md b/examples/markdownit/README.md
deleted file mode 100644
index a19b10344024..000000000000
--- a/examples/markdownit/README.md
+++ /dev/null
@@ -1,5 +0,0 @@
-# Nuxt with Markdown
-
-> Convert Markdown file to HTML using markdown-it.
-
-**See [Markdownit Module](https://github.com/nuxt-community/modules/tree/master/packages/markdownit) for easy integration with [Nuxt.js](https://nuxtjs.org).**
diff --git a/examples/markdownit/nuxt.config.js b/examples/markdownit/nuxt.config.js
deleted file mode 100644
index d0d4440accff..000000000000
--- a/examples/markdownit/nuxt.config.js
+++ /dev/null
@@ -1,8 +0,0 @@
-export default {
- modules: [
- '@nuxtjs/markdownit'
- ],
- plugins: [
- '~/plugins/md-it'
- ]
-}
diff --git a/examples/markdownit/package.json b/examples/markdownit/package.json
deleted file mode 100644
index 1a613b9bd5e2..000000000000
--- a/examples/markdownit/package.json
+++ /dev/null
@@ -1,18 +0,0 @@
-{
- "name": "example-markdownit",
- "version": "1.0.0",
- "dependencies": {
- "@nuxtjs/markdownit": "^1.1.2",
- "nuxt": "latest",
- "pug": "^2.0.0-rc.4"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- },
- "devDependencies": {
- "jstransformer-markdown-it": "^2.0.0"
- }
-}
diff --git a/examples/markdownit/pages/about.vue b/examples/markdownit/pages/about.vue
deleted file mode 100644
index e3139412bf91..000000000000
--- a/examples/markdownit/pages/about.vue
+++ /dev/null
@@ -1,6 +0,0 @@
-<template lang="md">
- # About Page!
- Current route is: {{ $route.name }}
-
- <NuxtLink to="/">Back home</NuxtLink>
-</template>
diff --git a/examples/markdownit/pages/index.vue b/examples/markdownit/pages/index.vue
deleted file mode 100644
index bcf035a10e39..000000000000
--- a/examples/markdownit/pages/index.vue
+++ /dev/null
@@ -1,19 +0,0 @@
-<template lang="md">
- # Hello World!
-
- Current route is: {{ $route.path }}
-
- Data model is: {{ model }}
-
- <NuxtLink to="/about">Goto About</NuxtLink>
-</template>
-
-<script>
-export default {
- data () {
- return {
- model: 'I am index'
- }
- }
-}
-</script>
diff --git a/examples/markdownit/pages/pug.vue b/examples/markdownit/pages/pug.vue
deleted file mode 100644
index 4193053bebff..000000000000
--- a/examples/markdownit/pages/pug.vue
+++ /dev/null
@@ -1,20 +0,0 @@
-<template lang="pug">
- div
- h1 Pug Page
- :markdown-it()
- ## Current route is: {{ $route.name }}
- div(v-html="$md.render(model)")
-
- br
- nuxt-link(to='/') Back Home
-</template>
-
-<script>
-export default {
- data () {
- return {
- model: '## Title h2\n### title h3\n\nLong text Long text Long text Long text Long text Long text Long text Long text Long text \n\n* gimme a list item\n* and one more yeehaw'
- }
- }
-}
-</script>
diff --git a/examples/markdownit/plugins/md-it.js b/examples/markdownit/plugins/md-it.js
deleted file mode 100644
index 3080f2004659..000000000000
--- a/examples/markdownit/plugins/md-it.js
+++ /dev/null
@@ -1,5 +0,0 @@
-import MarkdownIt from 'markdown-it'
-
-export default ({ app }, inject) => {
- inject('md', new MarkdownIt())
-}
diff --git a/examples/meta-info/README.md b/examples/meta-info/README.md
deleted file mode 100644
index 2d2ddaa6a514..000000000000
--- a/examples/meta-info/README.md
+++ /dev/null
@@ -1,13 +0,0 @@
-# Manage your app's meta information
-
-Nuxt.js uses [vue-meta](https://github.com/nuxt/vue-meta) to manage page meta info (such as: meta, title, link, style, script) of your application.
-
-## Example
-
-SEO: https://nuxtjs.org/examples/seo-html-head
-
-## Documentation
-
-Nuxt.js: https://nuxtjs.org/guide/views#html-head
-
-vue-meta: https://github.com/nuxt/vue-meta#table-of-contents
diff --git a/examples/meta-info/components/twitter-head-card.vue b/examples/meta-info/components/twitter-head-card.vue
deleted file mode 100644
index 9506baf3ec52..000000000000
--- a/examples/meta-info/components/twitter-head-card.vue
+++ /dev/null
@@ -1,22 +0,0 @@
-<template>
- <span v-if="false" />
-</template>
-
-<script>
-// Test on: https://cards-dev.twitter.com/validator
-export default {
- data: () => ({
- href: 'https://twitter.com/intent/tweet?url=' + encodeURIComponent('https://head-elements.now.sh/about')
- }),
- head: {
- meta: [
- { name: 'twitter:card', content: 'summary' },
- { name: 'twitter:site', content: '@nuxt_js' },
- { name: 'twitter:title', content: 'Nuxt.js Twitter Card' },
- { name: 'twitter:description', content: 'Nuxt.js lets you handle custom headers for your app with vue-meta' },
- { name: 'twitter:image', content: 'https://avatars0.githubusercontent.com/u/23360933?v=3' },
- { name: 'twitter:image:alt', content: 'Nuxt.js logo' }
- ]
- }
-}
-</script>
diff --git a/examples/meta-info/nuxt.config.js b/examples/meta-info/nuxt.config.js
deleted file mode 100644
index 941b70d4c610..000000000000
--- a/examples/meta-info/nuxt.config.js
+++ /dev/null
@@ -1,13 +0,0 @@
-export default {
- head: {
- titleTemplate: '%s - Nuxt.js',
- meta: [
- { charset: 'utf-8' },
- { name: 'viewport', content: 'width=device-width, initial-scale=1' },
- { hid: 'description', name: 'description', content: 'Meta description' }
- ]
- },
- render: {
- ssrLog: 'collapsed'
- }
-}
diff --git a/examples/meta-info/package.json b/examples/meta-info/package.json
deleted file mode 100644
index 2c046bb6179a..000000000000
--- a/examples/meta-info/package.json
+++ /dev/null
@@ -1,12 +0,0 @@
-{
- "name": "example-meta-info",
- "dependencies": {
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/meta-info/pages/about.vue b/examples/meta-info/pages/about.vue
deleted file mode 100644
index ce5cbb268e60..000000000000
--- a/examples/meta-info/pages/about.vue
+++ /dev/null
@@ -1,36 +0,0 @@
-<template>
- <div class="container">
- <h1>About page</h1>
- <p>Check the source code to see the custom meta tags added with our custom component <code>twitter-head-card</code></p>
- <TwitterHeadCard />
- <p>
- <NuxtLink to="/">
- Home page
- </NuxtLink>
- </p>
- </div>
-</template>
-
-<script>
-import TwitterHeadCard from '~/components/twitter-head-card.vue'
-
-export default {
- components: {
- TwitterHeadCard
- },
- head: {
- title: 'About Page',
- meta: [
- { hid: 'description', name: 'description', content: 'About page description' }
- ]
- }
-}
-</script>
-
-<style>
-.container {
- text-align: center;
- margin-top: 150px;
- font-size: 20px;
-}
-</style>
diff --git a/examples/meta-info/pages/index.vue b/examples/meta-info/pages/index.vue
deleted file mode 100755
index f4232a719150..000000000000
--- a/examples/meta-info/pages/index.vue
+++ /dev/null
@@ -1,36 +0,0 @@
-<template>
- <div class="container">
- <h1>Home page 🚀</h1>
- <NuxtLink to="/about">
- About page
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- head: {
- title: 'Home page 🚀',
- meta: [
- { hid: 'description', name: 'description', content: 'Home page description' }
- ],
- noscript: [
- { innerHTML: 'Body No Scripts', body: true }
- ],
- script: [
- { src: '/head.js' },
- // Supported since 1.0
- { src: '/body.js', body: true },
- { src: '/defer.js', defer: '' }
- ]
- }
-}
-</script>
-
-<style>
-.container {
- text-align: center;
- margin-top: 150px;
- font-size: 20px;
-}
-</style>
diff --git a/examples/meta-info/static/about.js b/examples/meta-info/static/about.js
deleted file mode 100644
index 464cf1245026..000000000000
--- a/examples/meta-info/static/about.js
+++ /dev/null
@@ -1 +0,0 @@
-console.log('about.js loaded!') // eslint-disable-line no-console
diff --git a/examples/meta-info/static/body.js b/examples/meta-info/static/body.js
deleted file mode 100644
index 7469d61dc563..000000000000
--- a/examples/meta-info/static/body.js
+++ /dev/null
@@ -1 +0,0 @@
-console.log('body.js loaded!') // eslint-disable-line no-console
diff --git a/examples/meta-info/static/defer.js b/examples/meta-info/static/defer.js
deleted file mode 100644
index 9437a02b3548..000000000000
--- a/examples/meta-info/static/defer.js
+++ /dev/null
@@ -1 +0,0 @@
-console.log('defer.js loaded!') // eslint-disable-line no-console
diff --git a/examples/meta-info/static/head.js b/examples/meta-info/static/head.js
deleted file mode 100644
index 6869a2c47a0e..000000000000
--- a/examples/meta-info/static/head.js
+++ /dev/null
@@ -1 +0,0 @@
-console.log('head.js loaded!') // eslint-disable-line no-console
diff --git a/examples/middleware/README.md b/examples/middleware/README.md
deleted file mode 100644
index 127bdfad32f8..000000000000
--- a/examples/middleware/README.md
+++ /dev/null
@@ -1,6 +0,0 @@
-# Middleware with Nuxt
-
-## Demo
-https://nuxtjs.org/examples/middleware
-
-Read more Nuxt on middleware [here](https://nuxtjs.org/guide/routing#middleware)
diff --git a/examples/middleware/components/Visits.vue b/examples/middleware/components/Visits.vue
deleted file mode 100644
index 461ef9067ed0..000000000000
--- a/examples/middleware/components/Visits.vue
+++ /dev/null
@@ -1,42 +0,0 @@
-<template>
- <ul>
- <li v-for="(visit, index) in visits" :key="index">
- <i>{{ visit.date | hours }}</i> - {{ visit.path }}
- </li>
- </ul>
-</template>
-
-<script>
-export default {
- filters: {
- hours (date) {
- return date.split('T')[1].split('.')[0]
- }
- },
- computed: {
- visits () {
- return this.$store.state.visits.slice().reverse()
- }
- }
-}
-</script>
-
-<style scoped>
-ul {
- position: fixed;
- top: 20px;
- right: 20px;
- margin: 0;
- padding: 0;
- height: 100%;
- overflow: auto;
- list-style-type: none;
-}
-ul li {
- padding: 2px 0;
-}
-ul li i {
- color: gray;
- font-style: normal;
-}
-</style>
diff --git a/examples/middleware/layouts/default.vue b/examples/middleware/layouts/default.vue
deleted file mode 100644
index 27001bd8e8fe..000000000000
--- a/examples/middleware/layouts/default.vue
+++ /dev/null
@@ -1,14 +0,0 @@
-<template>
- <div>
- <Nuxt />
- <Visits />
- </div>
-</template>
-
-<script>
-import Visits from '~/components/Visits'
-
-export default {
- components: { Visits }
-}
-</script>
diff --git a/examples/middleware/middleware/user-agent.js b/examples/middleware/middleware/user-agent.js
deleted file mode 100644
index 662a76ef028b..000000000000
--- a/examples/middleware/middleware/user-agent.js
+++ /dev/null
@@ -1,3 +0,0 @@
-export default function (context) {
- context.userAgent = process.server ? context.req.headers['user-agent'] : navigator.userAgent
-}
diff --git a/examples/middleware/middleware/visits.js b/examples/middleware/middleware/visits.js
deleted file mode 100644
index 7804fad335e5..000000000000
--- a/examples/middleware/middleware/visits.js
+++ /dev/null
@@ -1,3 +0,0 @@
-export default function ({ store, route, redirect }) {
- store.commit('ADD_VISIT', route.path)
-}
diff --git a/examples/middleware/nuxt.config.js b/examples/middleware/nuxt.config.js
deleted file mode 100644
index ce672e35abc0..000000000000
--- a/examples/middleware/nuxt.config.js
+++ /dev/null
@@ -1,5 +0,0 @@
-export default {
- router: {
- middleware: ['visits', 'user-agent']
- }
-}
diff --git a/examples/middleware/package.json b/examples/middleware/package.json
deleted file mode 100644
index b2b3d4411453..000000000000
--- a/examples/middleware/package.json
+++ /dev/null
@@ -1,12 +0,0 @@
-{
- "name": "example-middleware",
- "dependencies": {
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/middleware/pages/_slug.vue b/examples/middleware/pages/_slug.vue
deleted file mode 100644
index 22897da72eb6..000000000000
--- a/examples/middleware/pages/_slug.vue
+++ /dev/null
@@ -1,33 +0,0 @@
-<template>
- <div>
- <h1>{{ $route.params.slug || 'Home' }}</h1>
- <pre>{{ userAgent }}</pre>
- <ul>
- <li>
- <NuxtLink to="/">
- Home
- </NuxtLink>
- </li>
- <li v-for="(slug, index) in slugs" :key="index">
- <NuxtLink :to="{ name: 'slug', params: { slug } }">
- {{ slug }}
- </NuxtLink>
- </li>
- </ul>
- </div>
-</template>
-
-<script>
-export default {
- asyncData ({ store, route, userAgent }) {
- return {
- userAgent,
- slugs: [
- 'foo',
- 'bar',
- 'baz'
- ]
- }
- }
-}
-</script>
diff --git a/examples/middleware/store/index.js b/examples/middleware/store/index.js
deleted file mode 100644
index d143305b3c56..000000000000
--- a/examples/middleware/store/index.js
+++ /dev/null
@@ -1,12 +0,0 @@
-export const state = () => ({
- visits: []
-})
-
-export const mutations = {
- ADD_VISIT (state, path) {
- state.visits.push({
- path,
- date: new Date().toJSON()
- })
- }
-}
diff --git a/examples/minimal-features/README.md b/examples/minimal-features/README.md
deleted file mode 100644
index 30b16a2c3b80..000000000000
--- a/examples/minimal-features/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# A minimal Hello World Nuxt.js app
-
-https://nuxtjs.org/examples
diff --git a/examples/minimal-features/nuxt.config.js b/examples/minimal-features/nuxt.config.js
deleted file mode 100644
index 24b288822953..000000000000
--- a/examples/minimal-features/nuxt.config.js
+++ /dev/null
@@ -1,28 +0,0 @@
-export default {
- loading: false,
- loadingIndicator: false,
- fetch: {
- client: false,
- server: false
- },
- features: {
- store: false,
- layouts: false,
- meta: false,
- middleware: false,
- transitions: false,
- deprecations: false,
- validate: false,
- asyncData: false,
- fetch: false,
- clientOnline: false,
- clientPrefetch: false,
- clientUseUrl: true,
- componentAliases: false,
- componentClientOnly: false
- },
- build: {
- indicator: false,
- terser: true
- }
-}
diff --git a/examples/minimal-features/package.json b/examples/minimal-features/package.json
deleted file mode 100644
index b8661b729532..000000000000
--- a/examples/minimal-features/package.json
+++ /dev/null
@@ -1,12 +0,0 @@
-{
- "name": "example-minimal-features",
- "dependencies": {
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/minimal-features/pages/about.vue b/examples/minimal-features/pages/about.vue
deleted file mode 100755
index 0a6e9a060e5d..000000000000
--- a/examples/minimal-features/pages/about.vue
+++ /dev/null
@@ -1,21 +0,0 @@
-<template>
- <div>
- <p>Hi from {{ name }}</p>
- <nuxt-link to="/">
- Home page
- </nuxt-link>
- </div>
-</template>
-
-<script>
-export default {
- data () {
- return {
- name: process.static ? 'static' : (process.server ? 'server' : 'client')
- }
- },
- head: {
- title: 'About page'
- }
-}
-</script>
diff --git a/examples/minimal-features/pages/index.vue b/examples/minimal-features/pages/index.vue
deleted file mode 100755
index 79027bff4013..000000000000
--- a/examples/minimal-features/pages/index.vue
+++ /dev/null
@@ -1,16 +0,0 @@
-<template>
- <div>
- <h1>Welcome!</h1>
- <nuxt-link to="/about">
- About Page
- </nuxt-link>
- </div>
-</template>
-
-<script>
-export default {
- head: {
- title: 'Home page'
- }
-}
-</script>
diff --git a/examples/named-views/README.md b/examples/named-views/README.md
deleted file mode 100644
index 0f1abed03206..000000000000
--- a/examples/named-views/README.md
+++ /dev/null
@@ -1 +0,0 @@
-# Nuxt with named views
diff --git a/examples/named-views/components/childLeft.vue b/examples/named-views/components/childLeft.vue
deleted file mode 100644
index cf1a6a2d498f..000000000000
--- a/examples/named-views/components/childLeft.vue
+++ /dev/null
@@ -1,15 +0,0 @@
-<template>
- <div>
- Child Left content!
- </div>
-</template>
-
-<script>
-export default {
- name: 'ChildLeft'
-}
-</script>
-
-<style scoped>
-
-</style>
diff --git a/examples/named-views/components/mainTop.vue b/examples/named-views/components/mainTop.vue
deleted file mode 100644
index 44b442afb01f..000000000000
--- a/examples/named-views/components/mainTop.vue
+++ /dev/null
@@ -1,19 +0,0 @@
-<template>
- <div class="top">
- Main Top content!
- </div>
-</template>
-
-<script>
-export default {
- name: 'MainTop'
-}
-</script>
-
-<style scoped>
- .top {
- margin: auto;
- max-width: 420px;
- padding: 10px;
- }
-</style>
diff --git a/examples/named-views/layouts/default.vue b/examples/named-views/layouts/default.vue
deleted file mode 100644
index 20818174fc4f..000000000000
--- a/examples/named-views/layouts/default.vue
+++ /dev/null
@@ -1,6 +0,0 @@
-<template>
- <div>
- <Nuxt name="top" />
- <Nuxt />
- </div>
-</template>
diff --git a/examples/named-views/nuxt.config.js b/examples/named-views/nuxt.config.js
deleted file mode 100644
index 72c752ac0b24..000000000000
--- a/examples/named-views/nuxt.config.js
+++ /dev/null
@@ -1,30 +0,0 @@
-export default {
- router: {
- extendRoutes (routes, resolve) {
- const indexIndex = routes.findIndex(route => route.name === 'index')
- let index = routes[indexIndex].children.findIndex(route => route.name === 'index-child-id')
- routes[indexIndex].children[index] = {
- ...routes[indexIndex].children[index],
- components: {
- default: routes[indexIndex].children[index].component,
- left: resolve(__dirname, 'components/childLeft.vue')
- },
- chunkNames: {
- left: 'components/childLeft'
- }
- }
-
- index = routes.findIndex(route => route.name === 'main')
- routes[index] = {
- ...routes[index],
- components: {
- default: routes[index].component,
- top: resolve(__dirname, 'components/mainTop.vue')
- },
- chunkNames: {
- top: 'components/mainTop'
- }
- }
- }
- }
-}
diff --git a/examples/named-views/package.json b/examples/named-views/package.json
deleted file mode 100644
index fb8189c9081b..000000000000
--- a/examples/named-views/package.json
+++ /dev/null
@@ -1,12 +0,0 @@
-{
- "name": "my-app",
- "dependencies": {
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/named-views/pages/index.vue b/examples/named-views/pages/index.vue
deleted file mode 100755
index 37f9753ee809..000000000000
--- a/examples/named-views/pages/index.vue
+++ /dev/null
@@ -1,73 +0,0 @@
-<template lang="html">
- <div class="main">
- <h1>Hello there</h1>
- <p>This is an example of a named views</p>
- <ul>
- <li>
- <NuxtLink to="/">
- Root
- </NuxtLink>
- </li>
- <li>
- <NuxtLink to="/section">
- Section
- </NuxtLink>
- </li>
- <li>
- <NuxtLink to="/child/123">
- Child 123
- </NuxtLink>
- </li>
- <li>
- <NuxtLink to="/child/234">
- Child 234
- </NuxtLink>
- </li>
- <li>
- <NuxtLink to="/main">
- Main page with named view in layout
- </NuxtLink>
- </li>
- </ul>
-
- <hr>
- <div>
- <div class="left">
- <NuxtChild name="left" />
- </div>
- <div class="content">
- <NuxtChild />
- </div>
- </div>
- </div>
-</template>
-
-<script>
-export default {
- name: 'Stage'
-}
-</script>
-
-<style scoped>
- .main {
- margin: auto;
- max-width: 420px;
- padding: 10px;
- }
-
- .left {
- max-width: 150px;
- display: inline-block;
- vertical-align: top;
- border: 1px;
- }
-
- .left:empty {
- display: none;
- }
-
- .content {
- display: inline-block;
- }
-
-</style>
diff --git a/examples/named-views/pages/index/child/_id/index.vue b/examples/named-views/pages/index/child/_id/index.vue
deleted file mode 100644
index 75ed8e18136a..000000000000
--- a/examples/named-views/pages/index/child/_id/index.vue
+++ /dev/null
@@ -1,24 +0,0 @@
-<template>
- <div>
- <h2>Child content</h2>
- ID:{{ id }}
- </div>
-</template>
-
-<script>
-export default {
- name: 'Child',
- validate ({ params }) {
- return !isNaN(+params.id)
- },
- computed: {
- id () {
- return this.$route.params.id
- }
- }
-}
-</script>
-
-<style scoped>
-
-</style>
diff --git a/examples/named-views/pages/index/section.vue b/examples/named-views/pages/index/section.vue
deleted file mode 100644
index 48834ac56152..000000000000
--- a/examples/named-views/pages/index/section.vue
+++ /dev/null
@@ -1,16 +0,0 @@
-<template>
- <div>
- <h2>Section content</h2>
- <p>This page does not have left panel.</p>
- </div>
-</template>
-
-<script>
-export default {
- name: 'Section'
-}
-</script>
-
-<style scoped>
-
-</style>
diff --git a/examples/named-views/pages/main.vue b/examples/named-views/pages/main.vue
deleted file mode 100755
index 14ca7e86937f..000000000000
--- a/examples/named-views/pages/main.vue
+++ /dev/null
@@ -1,50 +0,0 @@
-<template lang="html">
- <div class="main">
- <h1>Main page</h1>
- <p>This is an example of a named views</p>
- <ul>
- <li>
- <NuxtLink to="/">
- Root
- </NuxtLink>
- </li>
- <li>
- <NuxtLink to="/section">
- Section
- </NuxtLink>
- </li>
- <li>
- <NuxtLink to="/child/123">
- Child 123
- </NuxtLink>
- </li>
- <li>
- <NuxtLink to="/child/234">
- Child 234
- </NuxtLink>
- </li>
- <li>
- <NuxtLink to="/main">
- Main page with named view in layout
- </NuxtLink>
- </li>
- </ul>
-
- <hr>
- <p>At top of this page there is named view from layout!</p>
- </div>
-</template>
-
-<script>
-export default {
- name: 'Main'
-}
-</script>
-
-<style scoped>
- .main {
- margin: auto;
- max-width: 420px;
- padding: 10px;
- }
-</style>
diff --git a/examples/nested-components/README.md b/examples/nested-components/README.md
deleted file mode 100644
index ed2a70463a7f..000000000000
--- a/examples/nested-components/README.md
+++ /dev/null
@@ -1 +0,0 @@
-# Nuxt with nested components example
diff --git a/examples/nested-components/components/paragraph.vue b/examples/nested-components/components/paragraph.vue
deleted file mode 100755
index 8895cddd927a..000000000000
--- a/examples/nested-components/components/paragraph.vue
+++ /dev/null
@@ -1,12 +0,0 @@
-<template>
- <p class="p">
- <slot />
- </p>
-</template>
-
-<style scoped>
-.p {
- font: 13px Helvetica, Arial;
- margin: 10px 0;
-}
-</style>
diff --git a/examples/nested-components/components/post.vue b/examples/nested-components/components/post.vue
deleted file mode 100755
index ef9cd8be117a..000000000000
--- a/examples/nested-components/components/post.vue
+++ /dev/null
@@ -1,32 +0,0 @@
-<template>
- <div class="main">
- <h1 class="title">
- {{ title }}
- </h1>
- <slot />
- </div>
-</template>
-
-<script>
-export default {
- props: {
- title: {
- type: String,
- default: ''
- }
- }
-}
-</script>
-
-<style scoped>
-.main {
- font: 15px Helvetica, Arial;
- border: 1px solid #eee;
- padding: 0 10px;
-}
-.title {
- font-size: 16px;
- font-weight: bold;
- margin: 10px 0
-}
-</style>
diff --git a/examples/nested-components/package.json b/examples/nested-components/package.json
deleted file mode 100644
index b60fda7c1f65..000000000000
--- a/examples/nested-components/package.json
+++ /dev/null
@@ -1,12 +0,0 @@
-{
- "name": "example-nested-components",
- "dependencies": {
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/nested-components/pages/index.vue b/examples/nested-components/pages/index.vue
deleted file mode 100755
index f53870294ebc..000000000000
--- a/examples/nested-components/pages/index.vue
+++ /dev/null
@@ -1,54 +0,0 @@
-<template lang="html">
- <div class="main">
- <Post title="My first blog post">
- <VP>Hello there</VP>
- <VP>This is an example of a componentized blog post</VP>
- </Post>
-
- <VHr />
-
- <Post title="My second blog post">
- <VP>Hello there</VP>
- <VP>This is another example.</VP>
- <VP>Wa-hoo!</VP>
- </Post>
-
- <VHr />
-
- <Post title="The final blog post">
- <VP>C'est la fin !</VP>
- </Post>
- </div>
-</template>
-
-<script>
-import Post from '~/components/post'
-import VP from '~/components/paragraph'
-const VHr = { render: h => h('hr', { class: 'hr' }) }
-
-export default {
- components: {
- Post,
- VP,
- VHr
- }
-}
-</script>
-
-<style scoped>
-.main {
- margin: auto;
- max-width: 420px;
- padding: 10px;
-}
-.hr {
- width: 100px;
- border-width: 0;
- margin: 20px auto;
- text-align: center;
-}
-hr::before {
- content: '***';
- color: #ccc;
-}
-</style>
diff --git a/examples/nested-routes/README.md b/examples/nested-routes/README.md
deleted file mode 100644
index 1c9f2bf47dcb..000000000000
--- a/examples/nested-routes/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Nested Routes with Nuxt.js
-
-[https://nuxtjs.org/examples/nested-routes](https://nuxtjs.org/examples/nested-routes)
diff --git a/examples/nested-routes/nuxt.config.js b/examples/nested-routes/nuxt.config.js
deleted file mode 100644
index b72f941c44d6..000000000000
--- a/examples/nested-routes/nuxt.config.js
+++ /dev/null
@@ -1,29 +0,0 @@
-export default {
- loading: false,
- head: {
- meta: [
- { charset: 'utf-8' },
- { name: 'viewport', content: 'width=device-width, initial-scale=1' }
- ]
- },
- env: {
- users: [
- { id: 1, name: 'Kobe Bryant', number: 24 },
- { id: 2, name: 'Michael Jordan', number: 23 },
- { id: 3, name: 'Stephen Curry', number: 30 },
- { id: 4, name: 'Lebron James', number: 23 },
- { id: 5, name: 'Kevin Durant', number: 35 },
- { id: 6, name: 'Kyrie Irving', number: 2 }
- ]
- },
- generate: {
- routes: [
- '/1',
- '/2',
- '/3',
- '/4',
- '/5',
- '/6'
- ]
- }
-}
diff --git a/examples/nested-routes/package.json b/examples/nested-routes/package.json
deleted file mode 100644
index 00c2f3d48cee..000000000000
--- a/examples/nested-routes/package.json
+++ /dev/null
@@ -1,13 +0,0 @@
-{
- "name": "example-nested-routes",
- "dependencies": {
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "generate": "nuxt generate",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/nested-routes/pages/index.vue b/examples/nested-routes/pages/index.vue
deleted file mode 100644
index c55b4a1339a1..000000000000
--- a/examples/nested-routes/pages/index.vue
+++ /dev/null
@@ -1,77 +0,0 @@
-<template>
- <div class="container">
- <div class="left">
- <h2>
- <NuxtLink to="/">
- Players
- </NuxtLink>
- </h2>
- <ul class="players">
- <li v-for="user in users" :key="user.id">
- <NuxtLink :to="'/'+user.id">
- {{ user.name }}
- </NuxtLink>
- </li>
- </ul>
- </div>
- <div class="right">
- <NuxtChild :key="$route.params.id" />
- </div>
- </div>
-</template>
-
-<script>
-export default {
- asyncData ({ env }) {
- return { users: env.users }
- }
-}
-</script>
-
-<style scoped>
-.page-enter-active, .page-leave-active {
- transition: opacity .4s, transform .4s;
- transform-style: preserve-3d;
- backface-visibility: hidden;
- opacity: 1;
-}
-.page-enter, .page-leave-active {
- opacity: 0.5;
- transform: rotateY(100deg);
-}
-.container {
- width: 100%;
- margin: 0;
- padding: 0;
- font-family: sans-serif;
- box-sizing: border-box;
-}
-.left {
- width: 50%;
- position: absolute;
- top: 0;
- left: 0;
-}
-.right {
- width: 50%;
- position: absolute;
- top: 0;
- right: 0;
-}
-.players {
- list-style-type: none;
- margin: 0;
- padding: 0;
-}
-.players li a {
- display: block;
- border: 1px #ddd solid;
- padding: 10px;
- text-align: left;
- color: #222;
- text-decoration: none;
-}
-.players li a:hover {
- color: orange;
-}
-</style>
diff --git a/examples/nested-routes/pages/index/_id.vue b/examples/nested-routes/pages/index/_id.vue
deleted file mode 100644
index 9cb2eb90a7a0..000000000000
--- a/examples/nested-routes/pages/index/_id.vue
+++ /dev/null
@@ -1,34 +0,0 @@
-<template>
- <div class="player">
- <h1>#{{ number }}</h1>
- <h2>{{ name }}</h2>
- </div>
-</template>
-
-<script>
-export default {
- validate ({ params }) {
- return !isNaN(+params.id)
- },
- asyncData ({ params, env, error }) {
- const user = env.users.find(user => String(user.id) === params.id)
- if (!user) {
- return error({ message: 'User not found', statusCode: 404 })
- }
- return user
- },
- head () {
- return {
- title: this.name
- }
- }
-}
-</script>
-
-<style scoped>
-.player {
- text-align: center;
- margin-top: 100px;
- font-family: sans-serif;
-}
-</style>
diff --git a/examples/nested-routes/pages/index/index.vue b/examples/nested-routes/pages/index/index.vue
deleted file mode 100644
index 6e6bda89fd05..000000000000
--- a/examples/nested-routes/pages/index/index.vue
+++ /dev/null
@@ -1,19 +0,0 @@
-<template>
- <h2>Please select an user.</h2>
-</template>
-
-<script>
-export default {
- head: {
- title: 'Please select an user'
- }
-}
-</script>
-
-<style scoped>
-h2 {
- text-align: center;
- margin-top: 100px;
- font-family: sans-serif;
-}
-</style>
diff --git a/examples/new-fetch/README.md b/examples/new-fetch/README.md
deleted file mode 100644
index 3b31939e1a31..000000000000
--- a/examples/new-fetch/README.md
+++ /dev/null
@@ -1,5 +0,0 @@
-# New fetch() with Nuxt.js
-
-Nuxt.js `v2.12` introduces a new hook called `fetch` in any of your Vue components.
-
-See [live demo](https://nuxt-new-fetch.surge.sh) and [documentation](https://nuxtjs.org/api/pages-fetch).
diff --git a/examples/new-fetch/components/Author.vue b/examples/new-fetch/components/Author.vue
deleted file mode 100644
index 05e6cda27979..000000000000
--- a/examples/new-fetch/components/Author.vue
+++ /dev/null
@@ -1,30 +0,0 @@
-<template>
- <p v-if="$fetchState.error">
- Could not fetch Author
- </p>
- <p v-else>
- Written by {{ $fetchState.pending ? '...' : user.name }} <button @click="$fetch">
- Refresh
- </button>
- </p>
-</template>
-
-<script>
-export default {
- props: {
- userId: {
- type: Number,
- required: true
- }
- },
- async fetch () {
- this.user = await this.$http.$get(`https://jsonplaceholder.typicode.com/users/${this.userId}`)
- },
- data () {
- return {
- user: {}
- }
- },
- fetchOnServer: false
-}
-</script>
diff --git a/examples/new-fetch/layouts/default.vue b/examples/new-fetch/layouts/default.vue
deleted file mode 100644
index 07cb60a9a115..000000000000
--- a/examples/new-fetch/layouts/default.vue
+++ /dev/null
@@ -1,28 +0,0 @@
-<template>
- <div>
- <!-- <p>Fetching: {{ $nuxt.isFetching }} ({{ $nuxt.nbFetching }})</p> -->
- <nuxt />
- </div>
-</template>
-
-<script>
-export default {
- head: {
- link: [
- { rel: 'stylesheet', href: 'https://cdn.jsdelivr.net/gh/kognise/water.css@1.4.0/dist/light.min.css' }
- ]
- }
-}
-</script>
-
-<style>
-body {
- padding: 20px 30px;
-}
-.page-enter-active, .page-leave-active {
- transition: opacity .3s;
-}
-.page-enter, .page-leave-to {
- opacity: 0;
-}
-</style>
diff --git a/examples/new-fetch/nuxt.config.js b/examples/new-fetch/nuxt.config.js
deleted file mode 100644
index 7e25ad865f5c..000000000000
--- a/examples/new-fetch/nuxt.config.js
+++ /dev/null
@@ -1,18 +0,0 @@
-const fetch = require('node-fetch')
-
-export default {
- plugins: [
- '@/plugins/vue-placeholders.js'
- ],
- modules: [
- '@nuxt/http'
- ],
- generate: {
- async routes () {
- const posts = await fetch('https://jsonplaceholder.typicode.com/posts').then(res => res.json()).then(d => d.slice(0, 20))
- const routes = posts.map(post => `/posts/${post.id}`)
-
- return ['/'].concat(routes)
- }
- }
-}
diff --git a/examples/new-fetch/package.json b/examples/new-fetch/package.json
deleted file mode 100644
index 1c893ab9a69b..000000000000
--- a/examples/new-fetch/package.json
+++ /dev/null
@@ -1,18 +0,0 @@
-{
- "name": "example-hello-world",
- "dependencies": {
- "@nuxt/http": "^0.3.8",
- "nuxt-start": "latest",
- "vue-content-placeholders": "^0.2.1"
- },
- "devDependencies": {
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "generate": "nuxt generate",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/new-fetch/pages/index.vue b/examples/new-fetch/pages/index.vue
deleted file mode 100644
index f3a5d75aa50b..000000000000
--- a/examples/new-fetch/pages/index.vue
+++ /dev/null
@@ -1,43 +0,0 @@
-<template>
- <div>
- <h1>Blog posts</h1>
- <template v-if="$fetchState.pending">
- <content-placeholders>
- <content-placeholders-text :lines="20" />
- </content-placeholders>
- </template>
- <template v-else-if="$fetchState.error">
- <p>
- Error while fetching posts: {{ error }}
- </p>
- </template>
- <template v-else>
- <ul>
- <li v-for="post of posts" :key="post.id">
- <n-link :to="`/posts/${post.id}`">
- {{ post.title }}
- </n-link>
- </li>
- <li>
- <n-link to="/posts/404">
- 404 post
- </n-link>
- </li>
- </ul>
- </template>
- </div>
-</template>
-
-<script>
-export default {
- async fetch () {
- this.posts = await this.$http.$get('https://jsonplaceholder.typicode.com/posts')
- .then(posts => posts.slice(0, 20))
- },
- data () {
- return {
- posts: null
- }
- }
-}
-</script>
diff --git a/examples/new-fetch/pages/posts/_id.vue b/examples/new-fetch/pages/posts/_id.vue
deleted file mode 100644
index ab58607eb76a..000000000000
--- a/examples/new-fetch/pages/posts/_id.vue
+++ /dev/null
@@ -1,54 +0,0 @@
-<template>
- <div>
- <button @click="$fetch">
- Refresh
- </button>
- <template v-if="$fetchState.pending">
- <content-placeholders>
- <content-placeholders-heading />
- <content-placeholders-text :lines="10" />
- </content-placeholders>
- </template>
- <template v-else-if="$fetchState.error">
- <h1>
- Post #{{ $route.params.id }} not found
- </h1>
- </template>
- <template v-else>
- <h1>{{ post.title }}</h1>
- <author :user-id="post.userId" />
- <pre>{{ post.body }}</pre>
- <p>
- <n-link :to="{ name: 'posts-id', params: { id: (post.id + 1) } }">
- Next article
- </n-link>
- </p>
- </template>
- <p>
- <n-link to="/">
- Home
- </n-link>
- </p>
- </div>
-</template>
-
-<script>
-import Author from '~/components/Author.vue'
-
-export default {
- components: {
- Author
- },
- async fetch () {
- this.post = await this.$http.$get(`https://jsonplaceholder.typicode.com/posts/${this.$route.params.id}`)
- },
- data () {
- return {
- post: {}
- }
- },
- head () {
- return { title: this.post.title }
- }
-}
-</script>
diff --git a/examples/new-fetch/plugins/vue-placeholders.js b/examples/new-fetch/plugins/vue-placeholders.js
deleted file mode 100644
index 40bfc7e19ae2..000000000000
--- a/examples/new-fetch/plugins/vue-placeholders.js
+++ /dev/null
@@ -1,4 +0,0 @@
-import Vue from 'vue'
-import VueContentPlaceholders from 'vue-content-placeholders'
-
-Vue.use(VueContentPlaceholders)
diff --git a/examples/no-ssr/README.md b/examples/no-ssr/README.md
deleted file mode 100644
index 9d5678cabc38..000000000000
--- a/examples/no-ssr/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# `<no-ssr>` with Nuxt.js
-
-https://nuxtjs.org/examples
diff --git a/examples/no-ssr/package.json b/examples/no-ssr/package.json
deleted file mode 100644
index de8ab5cb71ac..000000000000
--- a/examples/no-ssr/package.json
+++ /dev/null
@@ -1,12 +0,0 @@
-{
- "name": "example-no-ssr",
- "dependencies": {
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/no-ssr/pages/index.vue b/examples/no-ssr/pages/index.vue
deleted file mode 100755
index a6942c6d24b5..000000000000
--- a/examples/no-ssr/pages/index.vue
+++ /dev/null
@@ -1,17 +0,0 @@
-<template>
- <div class="page">
- <h1>Home</h1>
- <NoSsr placeholder="Loading...">
- <h2>This part is rendered on the client-side only</h2>
- </NoSsr>
- <NoSsr>
- <p><code>placeholder</code> prop is optional</p>
- </NoSsr>
- </div>
-</template>
-
-<style scoped>
-.no-ssr-placeholder {
- color: #41b883;
-}
-</style>
diff --git a/examples/nuxt-prefetch/README.md b/examples/nuxt-prefetch/README.md
deleted file mode 100644
index 9907d2f5455c..000000000000
--- a/examples/nuxt-prefetch/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Example of Nuxt.js prefetching
-
-Learn more at https://github.com/nuxt/nuxt.js/pull/4574
diff --git a/examples/nuxt-prefetch/assets/check.svg b/examples/nuxt-prefetch/assets/check.svg
deleted file mode 100644
index bb093ca332d8..000000000000
--- a/examples/nuxt-prefetch/assets/check.svg
+++ /dev/null
@@ -1 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="#41b883" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-check"><polyline points="20 6 9 17 4 12"></polyline></svg>
diff --git a/examples/nuxt-prefetch/layouts/default.vue b/examples/nuxt-prefetch/layouts/default.vue
deleted file mode 100644
index a8c577b30c89..000000000000
--- a/examples/nuxt-prefetch/layouts/default.vue
+++ /dev/null
@@ -1,57 +0,0 @@
-<template>
- <div>
- <div v-if="$nuxt.isOffline" class="offline">
- You are offline
- </div>
- <div class="container">
- <h1>{{ $route.name }}</h1>
- <Nuxt />
- </div>
- </div>
-</template>
-
-<style>
-body {
- padding: 0;
- margin: 0;
- font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, 'Open Sans', 'Helvetica Neue', sans-serif;
-}
-.container {
- padding: 10px 20px;
- padding-bottom: 40px;
-}
-.offline {
- background: #3B8070;
- color: white;
- position: fixed;
- bottom: 0;
- left: 0;
- right: 0;
- padding: 10px;
-}
-a {
- display: block;
- padding: 10px 10px 10px 0px;
- margin: 20px 0;
- font-size: 20px;
- border-bottom: 2px #ddd solid;
- color: #3B8070;
- text-decoration: none;
- transition: border-bottom-color 0.3s linear;
-}
-a:hover,
-a.nuxt-link-exact-active {
- background-color: rgb(245, 245, 245);
-}
-a.nuxt-link-prefetched:after {
- content: '';
- display: inline-block;
- background: url('../assets/check.svg') no-repeat;
- background-size: 14px;
- width: 14px;
- height: 14px;
- position: relative;
- right: -3px;
- top: 1px;
-}
-</style>
diff --git a/examples/nuxt-prefetch/nuxt.config.js b/examples/nuxt-prefetch/nuxt.config.js
deleted file mode 100644
index dc2118bd9cf9..000000000000
--- a/examples/nuxt-prefetch/nuxt.config.js
+++ /dev/null
@@ -1,22 +0,0 @@
-export default {
- head: {
- titleTemplate: '%s - NuxtJS Prefetching',
- htmlAttrs: { lang: 'en' },
- meta: [
- { charset: 'utf-8' },
- { name: 'viewport', content: 'width=device-width, initial-scale=1' }
- ],
- // Support polyfill for browsers that don't support it (Safari Mobile for example)
- script: [
- { src: 'https://polyfill.io/v2/polyfill.min.js?features=IntersectionObserver', body: true }
- ]
- },
- router: {
- // To disable prefetching, uncomment the line
- // prefetchLinks: false
-
- // Activate prefetched class (default: false)
- // Used to display the check mark next to the prefetched link
- linkPrefetchedClass: 'nuxt-link-prefetched'
- }
-}
diff --git a/examples/nuxt-prefetch/package.json b/examples/nuxt-prefetch/package.json
deleted file mode 100644
index f17816254813..000000000000
--- a/examples/nuxt-prefetch/package.json
+++ /dev/null
@@ -1,12 +0,0 @@
-{
- "name": "example-nuxt-prefetch",
- "dependencies": {
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/nuxt-prefetch/pages/accelerated.vue b/examples/nuxt-prefetch/pages/accelerated.vue
deleted file mode 100755
index b68ac7494b2c..000000000000
--- a/examples/nuxt-prefetch/pages/accelerated.vue
+++ /dev/null
@@ -1,17 +0,0 @@
-<template>
- <div>
- <NuxtLink v-for="link of $store.state.links" :key="link" :to="{ name: link }">
- /{{ link }}
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- head () {
- return {
- title: this.$route.name
- }
- }
-}
-</script>
diff --git a/examples/nuxt-prefetch/pages/active.vue b/examples/nuxt-prefetch/pages/active.vue
deleted file mode 100755
index b68ac7494b2c..000000000000
--- a/examples/nuxt-prefetch/pages/active.vue
+++ /dev/null
@@ -1,17 +0,0 @@
-<template>
- <div>
- <NuxtLink v-for="link of $store.state.links" :key="link" :to="{ name: link }">
- /{{ link }}
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- head () {
- return {
- title: this.$route.name
- }
- }
-}
-</script>
diff --git a/examples/nuxt-prefetch/pages/agile.vue b/examples/nuxt-prefetch/pages/agile.vue
deleted file mode 100755
index b68ac7494b2c..000000000000
--- a/examples/nuxt-prefetch/pages/agile.vue
+++ /dev/null
@@ -1,17 +0,0 @@
-<template>
- <div>
- <NuxtLink v-for="link of $store.state.links" :key="link" :to="{ name: link }">
- /{{ link }}
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- head () {
- return {
- title: this.$route.name
- }
- }
-}
-</script>
diff --git a/examples/nuxt-prefetch/pages/brisk.vue b/examples/nuxt-prefetch/pages/brisk.vue
deleted file mode 100755
index b68ac7494b2c..000000000000
--- a/examples/nuxt-prefetch/pages/brisk.vue
+++ /dev/null
@@ -1,17 +0,0 @@
-<template>
- <div>
- <NuxtLink v-for="link of $store.state.links" :key="link" :to="{ name: link }">
- /{{ link }}
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- head () {
- return {
- title: this.$route.name
- }
- }
-}
-</script>
diff --git a/examples/nuxt-prefetch/pages/dashing.vue b/examples/nuxt-prefetch/pages/dashing.vue
deleted file mode 100755
index b68ac7494b2c..000000000000
--- a/examples/nuxt-prefetch/pages/dashing.vue
+++ /dev/null
@@ -1,17 +0,0 @@
-<template>
- <div>
- <NuxtLink v-for="link of $store.state.links" :key="link" :to="{ name: link }">
- /{{ link }}
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- head () {
- return {
- title: this.$route.name
- }
- }
-}
-</script>
diff --git a/examples/nuxt-prefetch/pages/electric.vue b/examples/nuxt-prefetch/pages/electric.vue
deleted file mode 100755
index b68ac7494b2c..000000000000
--- a/examples/nuxt-prefetch/pages/electric.vue
+++ /dev/null
@@ -1,17 +0,0 @@
-<template>
- <div>
- <NuxtLink v-for="link of $store.state.links" :key="link" :to="{ name: link }">
- /{{ link }}
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- head () {
- return {
- title: this.$route.name
- }
- }
-}
-</script>
diff --git a/examples/nuxt-prefetch/pages/flashing.vue b/examples/nuxt-prefetch/pages/flashing.vue
deleted file mode 100755
index b68ac7494b2c..000000000000
--- a/examples/nuxt-prefetch/pages/flashing.vue
+++ /dev/null
@@ -1,17 +0,0 @@
-<template>
- <div>
- <NuxtLink v-for="link of $store.state.links" :key="link" :to="{ name: link }">
- /{{ link }}
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- head () {
- return {
- title: this.$route.name
- }
- }
-}
-</script>
diff --git a/examples/nuxt-prefetch/pages/fleet.vue b/examples/nuxt-prefetch/pages/fleet.vue
deleted file mode 100755
index b68ac7494b2c..000000000000
--- a/examples/nuxt-prefetch/pages/fleet.vue
+++ /dev/null
@@ -1,17 +0,0 @@
-<template>
- <div>
- <NuxtLink v-for="link of $store.state.links" :key="link" :to="{ name: link }">
- /{{ link }}
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- head () {
- return {
- title: this.$route.name
- }
- }
-}
-</script>
diff --git a/examples/nuxt-prefetch/pages/fleeting.vue b/examples/nuxt-prefetch/pages/fleeting.vue
deleted file mode 100755
index b68ac7494b2c..000000000000
--- a/examples/nuxt-prefetch/pages/fleeting.vue
+++ /dev/null
@@ -1,17 +0,0 @@
-<template>
- <div>
- <NuxtLink v-for="link of $store.state.links" :key="link" :to="{ name: link }">
- /{{ link }}
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- head () {
- return {
- title: this.$route.name
- }
- }
-}
-</script>
diff --git a/examples/nuxt-prefetch/pages/flying.vue b/examples/nuxt-prefetch/pages/flying.vue
deleted file mode 100755
index b68ac7494b2c..000000000000
--- a/examples/nuxt-prefetch/pages/flying.vue
+++ /dev/null
@@ -1,17 +0,0 @@
-<template>
- <div>
- <NuxtLink v-for="link of $store.state.links" :key="link" :to="{ name: link }">
- /{{ link }}
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- head () {
- return {
- title: this.$route.name
- }
- }
-}
-</script>
diff --git a/examples/nuxt-prefetch/pages/hot.vue b/examples/nuxt-prefetch/pages/hot.vue
deleted file mode 100755
index b68ac7494b2c..000000000000
--- a/examples/nuxt-prefetch/pages/hot.vue
+++ /dev/null
@@ -1,17 +0,0 @@
-<template>
- <div>
- <NuxtLink v-for="link of $store.state.links" :key="link" :to="{ name: link }">
- /{{ link }}
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- head () {
- return {
- title: this.$route.name
- }
- }
-}
-</script>
diff --git a/examples/nuxt-prefetch/pages/hurried.vue b/examples/nuxt-prefetch/pages/hurried.vue
deleted file mode 100755
index b68ac7494b2c..000000000000
--- a/examples/nuxt-prefetch/pages/hurried.vue
+++ /dev/null
@@ -1,17 +0,0 @@
-<template>
- <div>
- <NuxtLink v-for="link of $store.state.links" :key="link" :to="{ name: link }">
- /{{ link }}
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- head () {
- return {
- title: this.$route.name
- }
- }
-}
-</script>
diff --git a/examples/nuxt-prefetch/pages/index.vue b/examples/nuxt-prefetch/pages/index.vue
deleted file mode 100755
index b68ac7494b2c..000000000000
--- a/examples/nuxt-prefetch/pages/index.vue
+++ /dev/null
@@ -1,17 +0,0 @@
-<template>
- <div>
- <NuxtLink v-for="link of $store.state.links" :key="link" :to="{ name: link }">
- /{{ link }}
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- head () {
- return {
- title: this.$route.name
- }
- }
-}
-</script>
diff --git a/examples/nuxt-prefetch/pages/nimble.vue b/examples/nuxt-prefetch/pages/nimble.vue
deleted file mode 100755
index b68ac7494b2c..000000000000
--- a/examples/nuxt-prefetch/pages/nimble.vue
+++ /dev/null
@@ -1,17 +0,0 @@
-<template>
- <div>
- <NuxtLink v-for="link of $store.state.links" :key="link" :to="{ name: link }">
- /{{ link }}
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- head () {
- return {
- title: this.$route.name
- }
- }
-}
-</script>
diff --git a/examples/nuxt-prefetch/pages/quick.vue b/examples/nuxt-prefetch/pages/quick.vue
deleted file mode 100755
index b68ac7494b2c..000000000000
--- a/examples/nuxt-prefetch/pages/quick.vue
+++ /dev/null
@@ -1,17 +0,0 @@
-<template>
- <div>
- <NuxtLink v-for="link of $store.state.links" :key="link" :to="{ name: link }">
- /{{ link }}
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- head () {
- return {
- title: this.$route.name
- }
- }
-}
-</script>
diff --git a/examples/nuxt-prefetch/pages/racing.vue b/examples/nuxt-prefetch/pages/racing.vue
deleted file mode 100755
index b68ac7494b2c..000000000000
--- a/examples/nuxt-prefetch/pages/racing.vue
+++ /dev/null
@@ -1,17 +0,0 @@
-<template>
- <div>
- <NuxtLink v-for="link of $store.state.links" :key="link" :to="{ name: link }">
- /{{ link }}
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- head () {
- return {
- title: this.$route.name
- }
- }
-}
-</script>
diff --git a/examples/nuxt-prefetch/pages/rapid.vue b/examples/nuxt-prefetch/pages/rapid.vue
deleted file mode 100755
index b68ac7494b2c..000000000000
--- a/examples/nuxt-prefetch/pages/rapid.vue
+++ /dev/null
@@ -1,17 +0,0 @@
-<template>
- <div>
- <NuxtLink v-for="link of $store.state.links" :key="link" :to="{ name: link }">
- /{{ link }}
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- head () {
- return {
- title: this.$route.name
- }
- }
-}
-</script>
diff --git a/examples/nuxt-prefetch/pages/ready.vue b/examples/nuxt-prefetch/pages/ready.vue
deleted file mode 100755
index b68ac7494b2c..000000000000
--- a/examples/nuxt-prefetch/pages/ready.vue
+++ /dev/null
@@ -1,17 +0,0 @@
-<template>
- <div>
- <NuxtLink v-for="link of $store.state.links" :key="link" :to="{ name: link }">
- /{{ link }}
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- head () {
- return {
- title: this.$route.name
- }
- }
-}
-</script>
diff --git a/examples/nuxt-prefetch/pages/snap.vue b/examples/nuxt-prefetch/pages/snap.vue
deleted file mode 100755
index b68ac7494b2c..000000000000
--- a/examples/nuxt-prefetch/pages/snap.vue
+++ /dev/null
@@ -1,17 +0,0 @@
-<template>
- <div>
- <NuxtLink v-for="link of $store.state.links" :key="link" :to="{ name: link }">
- /{{ link }}
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- head () {
- return {
- title: this.$route.name
- }
- }
-}
-</script>
diff --git a/examples/nuxt-prefetch/pages/swift.vue b/examples/nuxt-prefetch/pages/swift.vue
deleted file mode 100755
index b68ac7494b2c..000000000000
--- a/examples/nuxt-prefetch/pages/swift.vue
+++ /dev/null
@@ -1,17 +0,0 @@
-<template>
- <div>
- <NuxtLink v-for="link of $store.state.links" :key="link" :to="{ name: link }">
- /{{ link }}
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- head () {
- return {
- title: this.$route.name
- }
- }
-}
-</script>
diff --git a/examples/nuxt-prefetch/pages/winged.vue b/examples/nuxt-prefetch/pages/winged.vue
deleted file mode 100755
index b68ac7494b2c..000000000000
--- a/examples/nuxt-prefetch/pages/winged.vue
+++ /dev/null
@@ -1,17 +0,0 @@
-<template>
- <div>
- <NuxtLink v-for="link of $store.state.links" :key="link" :to="{ name: link }">
- /{{ link }}
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- head () {
- return {
- title: this.$route.name
- }
- }
-}
-</script>
diff --git a/examples/nuxt-prefetch/store/index.js b/examples/nuxt-prefetch/store/index.js
deleted file mode 100644
index 0295063e7e7c..000000000000
--- a/examples/nuxt-prefetch/store/index.js
+++ /dev/null
@@ -1,25 +0,0 @@
-export const state = () => ({
- links: [
- 'index',
- 'agile',
- 'brisk',
- 'hot',
- 'nimble',
- 'quick',
- 'rapid',
- 'swift',
- 'accelerated',
- 'active',
- 'dashing',
- 'electric',
- 'flashing',
- 'fleet',
- 'fleeting',
- 'flying',
- 'hurried',
- 'racing',
- 'ready',
- 'snap',
- 'winged'
- ]
-})
diff --git a/examples/plugins-vendor/README.md b/examples/plugins-vendor/README.md
deleted file mode 100644
index d86e3dcc5a0b..000000000000
--- a/examples/plugins-vendor/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Using external modules and plugins with Nuxt.js
-
-https://nuxtjs.org/examples/plugins
diff --git a/examples/plugins-vendor/nuxt.config.js b/examples/plugins-vendor/nuxt.config.js
deleted file mode 100644
index 182eba49229b..000000000000
--- a/examples/plugins-vendor/nuxt.config.js
+++ /dev/null
@@ -1,6 +0,0 @@
-export default {
- plugins: [
- // ssr: false to only include it on client-side
- { src: '~/plugins/vue-notifications.js', ssr: false }
- ]
-}
diff --git a/examples/plugins-vendor/package.json b/examples/plugins-vendor/package.json
deleted file mode 100644
index d233640c30e4..000000000000
--- a/examples/plugins-vendor/package.json
+++ /dev/null
@@ -1,15 +0,0 @@
-{
- "name": "example-plugins-vendor",
- "dependencies": {
- "axios": "^0.19.0",
- "mini-toastr": "^0.6.5",
- "nuxt": "latest",
- "vue-notifications": "^0.8.0"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/plugins-vendor/pages/about.vue b/examples/plugins-vendor/pages/about.vue
deleted file mode 100644
index 75c3202b0d5c..000000000000
--- a/examples/plugins-vendor/pages/about.vue
+++ /dev/null
@@ -1,29 +0,0 @@
-<template>
- <div class="container">
- <img :src="thumbnailUrl">
- <p>
- <NuxtLink to="/">
- Home
- </NuxtLink> - About
- </p>
- </div>
-</template>
-
-<script>
-import axios from 'axios'
-
-export default {
- asyncData () {
- const nb = Math.max(1, Math.round(Math.random() * 10))
- return axios.get(`https://jsonplaceholder.typicode.com/photos/${nb}`).then(res => res.data)
- }
-}
-</script>
-
-<style>
-.container {
- text-align: center;
- padding-top: 100px;
- font-family: sans-serif;
-}
-</style>
diff --git a/examples/plugins-vendor/pages/index.vue b/examples/plugins-vendor/pages/index.vue
deleted file mode 100644
index f99a6baff2a7..000000000000
--- a/examples/plugins-vendor/pages/index.vue
+++ /dev/null
@@ -1,42 +0,0 @@
-<template>
- <div class="container">
- <p>
- <button @click="showLoginError">
- Notif me!
- </button>
- </p>
- <p>
- Home - <NuxtLink to="/about">
- About
- </NuxtLink>
- </p>
- </div>
-</template>
-
-<script>
-let miniToastr
-if (process.client) {
- miniToastr = require('mini-toastr').default
-}
-
-export default {
- mounted () {
- miniToastr.init()
- },
- notifications: {
- showLoginError: {
- title: 'Welcome!',
- message: 'Hello from nuxt.js',
- type: 'info'
- }
- }
-}
-</script>
-
-<style>
-.container {
- text-align: center;
- padding-top: 100px;
- font-family: sans-serif;
-}
-</style>
diff --git a/examples/plugins-vendor/plugins/vue-notifications.js b/examples/plugins-vendor/plugins/vue-notifications.js
deleted file mode 100644
index 3eca0a3f8951..000000000000
--- a/examples/plugins-vendor/plugins/vue-notifications.js
+++ /dev/null
@@ -1,23 +0,0 @@
-// This code will be injected before initializing the root App
-import Vue from 'vue'
-import VueNotifications from 'vue-notifications'
-// Include mini-toaster (or any other UI-notification library
-import miniToastr from 'mini-toastr'
-
-// Here we setup messages output to `mini-toastr`
-const toast = function ({ title, message, type, timeout, cb }) {
- return miniToastr[type](message, title, timeout, cb)
-}
-
-// Binding for methods .success(), .error() and etc. You can specify and map your own methods here.
-// Required to pipe our outout to UI library (mini-toastr in example here)
-// All not-specified events (types) would be piped to output in console.
-const options = {
- success: toast,
- error: toast,
- info: toast,
- warn: toast
-}
-
-// Activate plugin
-Vue.use(VueNotifications, options)
diff --git a/examples/programmatic/nuxt.config.js b/examples/programmatic/nuxt.config.js
deleted file mode 100644
index 743331b4226f..000000000000
--- a/examples/programmatic/nuxt.config.js
+++ /dev/null
@@ -1,5 +0,0 @@
-export default {
- head: {
- title: 'Programmatic Works'
- }
-}
diff --git a/examples/programmatic/package.json b/examples/programmatic/package.json
deleted file mode 100644
index bd2b095de900..000000000000
--- a/examples/programmatic/package.json
+++ /dev/null
@@ -1,12 +0,0 @@
-{
- "name": "example-programmatic",
- "dependencies": {
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "node scripts/dev",
- "build": "node scripts/build",
- "start": "node scripts/start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/programmatic/pages/index.vue b/examples/programmatic/pages/index.vue
deleted file mode 100644
index e676eb3feb94..000000000000
--- a/examples/programmatic/pages/index.vue
+++ /dev/null
@@ -1,5 +0,0 @@
-<template>
- <div>
- Works
- </div>
-</template>
diff --git a/examples/programmatic/scripts/build.js b/examples/programmatic/scripts/build.js
deleted file mode 100644
index 2d30708bc26b..000000000000
--- a/examples/programmatic/scripts/build.js
+++ /dev/null
@@ -1,8 +0,0 @@
-const { loadNuxt, build } = require('nuxt')
-
-const main = async () => {
- const nuxt = await loadNuxt({ for: 'build' })
- await build(nuxt)
-}
-
-main()
diff --git a/examples/programmatic/scripts/dev.js b/examples/programmatic/scripts/dev.js
deleted file mode 100644
index 2b6f1d5a290e..000000000000
--- a/examples/programmatic/scripts/dev.js
+++ /dev/null
@@ -1,9 +0,0 @@
-const { loadNuxt, build } = require('nuxt')
-
-const main = async () => {
- const nuxt = await loadNuxt({ for: 'dev' })
- build(nuxt)
- await nuxt.listen(3000)
-}
-
-main()
diff --git a/examples/programmatic/scripts/start.js b/examples/programmatic/scripts/start.js
deleted file mode 100644
index 8564596ffd10..000000000000
--- a/examples/programmatic/scripts/start.js
+++ /dev/null
@@ -1,8 +0,0 @@
-const { loadNuxt } = require('nuxt-start')
-
-const main = async () => {
- const nuxt = await loadNuxt({ for: 'start' })
- await nuxt.listen(3000)
-}
-
-main()
diff --git a/examples/pug-stylus-coffee/README.md b/examples/pug-stylus-coffee/README.md
deleted file mode 100644
index 930f5e4d87a0..000000000000
--- a/examples/pug-stylus-coffee/README.md
+++ /dev/null
@@ -1,20 +0,0 @@
-# Pug + Stylus + Coffee template for Nuxt.js
-
-> Ultimative complete pack for coding with pleasure and Nuxt.js
-
-## Build Setup
-
-``` bash
-# install dependencies
-$ npm install
-
-# serve with hot reload at localhost:3000
-$ npm run dev
-
-# build for production and launch server
-$ npm run build
-$ npm start
-
-# generate static project
-$ npm run generate
-```
diff --git a/examples/pug-stylus-coffee/components/Logo.vue b/examples/pug-stylus-coffee/components/Logo.vue
deleted file mode 100644
index 14799f76d354..000000000000
--- a/examples/pug-stylus-coffee/components/Logo.vue
+++ /dev/null
@@ -1,66 +0,0 @@
-<template lang="pug">
- .VueToNuxtLogo
- .Triangle.Triangle--two
- .Triangle.Triangle--one
- .Triangle.Triangle--three
- .Triangle.Triangle--four
-</template>
-
-<style lang="stylus">
-.VueToNuxtLogo
- display: inline-block
- animation: turn 2s linear forwards 1s
- transform: rotateX(180deg)
- position: relative
- overflow: hidden
- height: 180px
- width: 245px
-
-.Triangle
- position: absolute
- top: 0
- left: 0
- width: 0
- height: 0
-
-.Triangle--one
- border-left: 105px solid transparent
- border-right: 105px solid transparent
- border-bottom: 180px solid #41b883
-
-.Triangle--two
- top: 30px
- left: 35px
- animation: goright 0.5s linear forwards 3.5s
- border-left: 87.5px solid transparent
- border-right: 87.5px solid transparent
- border-bottom: 150px solid #3b8070
-
-.Triangle--three
- top: 60px
- left: 35px
- animation: goright 0.5s linear forwards 3.5s
- border-left: 70px solid transparent
- border-right: 70px solid transparent
- border-bottom: 120px solid #35495e
-
-.Triangle--four
- top: 120px
- left: 70px
- animation: godown 0.5s linear forwards 3s
- border-left: 35px solid transparent
- border-right: 35px solid transparent
- border-bottom: 60px solid #fff
-
-@keyframes turn
- 100%
- transform: rotateX(0deg)
-
-@keyframes godown
- 100%
- top: 180px
-
-@keyframes goright
- 100%
- left: 70px
-</style>
diff --git a/examples/pug-stylus-coffee/components/README.md b/examples/pug-stylus-coffee/components/README.md
deleted file mode 100644
index a079f1060e7a..000000000000
--- a/examples/pug-stylus-coffee/components/README.md
+++ /dev/null
@@ -1,7 +0,0 @@
-# COMPONENTS
-
-**This directory is not required, you can delete it if you don't want to use it.**
-
-The components directory contains your Vue.js Components.
-
-_Nuxt.js doesn't supercharge these components._
diff --git a/examples/pug-stylus-coffee/layouts/README.md b/examples/pug-stylus-coffee/layouts/README.md
deleted file mode 100644
index cad1ad57385f..000000000000
--- a/examples/pug-stylus-coffee/layouts/README.md
+++ /dev/null
@@ -1,7 +0,0 @@
-# LAYOUTS
-
-**This directory is not required, you can delete it if you don't want to use it.**
-
-This directory contains your Application Layouts.
-
-More information about the usage of this directory in [the documentation](https://nuxtjs.org/guide/views#layouts).
diff --git a/examples/pug-stylus-coffee/layouts/default.vue b/examples/pug-stylus-coffee/layouts/default.vue
deleted file mode 100644
index 540fff86dae7..000000000000
--- a/examples/pug-stylus-coffee/layouts/default.vue
+++ /dev/null
@@ -1,46 +0,0 @@
-<template lang="pug">
- .div
- nuxt
-</template>
-
-<style lang="stylus">
-html
- font-family: 'Source Sans Pro', -apple-system, BlinkMacSystemFont, 'Segoe UI',
- Roboto, 'Helvetica Neue', Arial, sans-serif
- font-size: 16px
- word-spacing: 1px
- -ms-text-size-adjust: 100%
- -webkit-text-size-adjust: 100%
- -moz-osx-font-smoothing: grayscale
- -webkit-font-smoothing: antialiased
- box-sizing: border-box
-
-*
-&:before
-&:after
- box-sizing: border-box
- margin: 0
-
-.button--green
- display: inline-block
- border-radius: 4px
- border: 1px solid #3b8070
- color: #3b8070
- text-decoration: none
- padding: 10px 30px
- &:hover
- color: #fff
- background-color: #3b8070
-
-.button--grey
- display: inline-block
- border-radius: 4px
- border: 1px solid #35495e
- color: #35495e
- text-decoration: none
- padding: 10px 30px
- margin-left: 15px
- &:hover
- color: #fff
- background-color: #35495e
-</style>
diff --git a/examples/pug-stylus-coffee/middleware/README.md b/examples/pug-stylus-coffee/middleware/README.md
deleted file mode 100644
index 51861b278c15..000000000000
--- a/examples/pug-stylus-coffee/middleware/README.md
+++ /dev/null
@@ -1,8 +0,0 @@
-# MIDDLEWARE
-
-**This directory is not required, you can delete it if you don't want to use it.**
-
-This directory contains your application middleware.
-Middleware lets you define custom functions that can be run before rendering either a page or a group of pages.
-
-More information about the usage of this directory in [the documentation](https://nuxtjs.org/guide/routing#middleware).
diff --git a/examples/pug-stylus-coffee/modules/coffeescript.js b/examples/pug-stylus-coffee/modules/coffeescript.js
deleted file mode 100644
index 3dcc8dc83c10..000000000000
--- a/examples/pug-stylus-coffee/modules/coffeescript.js
+++ /dev/null
@@ -1,17 +0,0 @@
-export default function () {
- // Add .coffee extension for store, middleware and more
- this.nuxt.options.build.additionalExtensions.push('coffee')
- // Extend build
- const coffeeLoader = {
- test: /\.coffee$/,
- loader: 'coffee-loader'
- }
- this.extendBuild((config) => {
- // Add CoffeeScruot loader
- config.module.rules.push(coffeeLoader)
- // Add .coffee extension in webpack resolve
- if (!config.resolve.extensions.includes('.coffee')) {
- config.resolve.extensions.push('.coffee')
- }
- })
-}
diff --git a/examples/pug-stylus-coffee/nuxt.config.coffee b/examples/pug-stylus-coffee/nuxt.config.coffee
deleted file mode 100644
index 039a2022ba42..000000000000
--- a/examples/pug-stylus-coffee/nuxt.config.coffee
+++ /dev/null
@@ -1,48 +0,0 @@
-pkg = require('./package')
-module.exports =
- mode: 'universal'
- #
- # Headers of the page
- #
- head:
- title: pkg.name
- meta:
- [
- {
- charset: 'utf-8'
- }
- {
- name: 'viewport'
- content: 'width=device-width, initial-scale=1'
- }
- {
- hid: 'description'
- name: 'description'
- content: pkg.description
- }
- ]
- link:
- [
- rel: 'icon'
- type: 'image/x-icon'
- href: '/favicon.ico'
- ]
- # Customize the progress-bar color
- loading:
- {
- color: '#3B8070'
- }
- # Global CSS
- css: []
- # Plugins to load before mounting the App
- plugins: []
- # Nuxt.js modules
- modules:
- [
- '~/modules/coffeescript'
- ]
- # Build configuration
- build:
- # You can extend webpack config here
- extend = (config, ctx) ->
- pass
diff --git a/examples/pug-stylus-coffee/nuxt.config.js b/examples/pug-stylus-coffee/nuxt.config.js
deleted file mode 100644
index 3d783db4d2d1..000000000000
--- a/examples/pug-stylus-coffee/nuxt.config.js
+++ /dev/null
@@ -1,2 +0,0 @@
-require('coffeescript/register')
-module.exports = require('./nuxt.config.coffee')
diff --git a/examples/pug-stylus-coffee/package.json b/examples/pug-stylus-coffee/package.json
deleted file mode 100644
index c63df436f854..000000000000
--- a/examples/pug-stylus-coffee/package.json
+++ /dev/null
@@ -1,25 +0,0 @@
-{
- "name": "example-pug-stylus-coffee",
- "version": "1.0.0",
- "description": "Nuxt.js with Pug Stylus and CoffeeScript",
- "author": "Alex Ananiev <alex.ananiev.r@gmail.com>, Kron Austrum <huyach@protonmail.ch>",
- "private": true,
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "generate": "nuxt generate",
- "post-update": "yarn upgrade --latest"
- },
- "dependencies": {
- "nuxt": "latest"
- },
- "devDependencies": {
- "coffee-loader": "^0.8.0",
- "coffeescript": "^2.0.1",
- "pug": "^2.0.3",
- "pug-plain-loader": "^1.0.0",
- "stylus": "^0.54.5",
- "stylus-loader": "^3.0.2"
- }
-}
diff --git a/examples/pug-stylus-coffee/pages/README.md b/examples/pug-stylus-coffee/pages/README.md
deleted file mode 100644
index 3c7faf56e7cf..000000000000
--- a/examples/pug-stylus-coffee/pages/README.md
+++ /dev/null
@@ -1,7 +0,0 @@
-# PAGES
-
-This directory contains your Application Views and Routes.
-The framework reads all the .vue files inside this directory and create the router of your application.
-
-More information about the usage of this directory in the documentation:
-https://nuxtjs.org/guide/routing
diff --git a/examples/pug-stylus-coffee/pages/index.vue b/examples/pug-stylus-coffee/pages/index.vue
deleted file mode 100644
index ee0df7e4eff1..000000000000
--- a/examples/pug-stylus-coffee/pages/index.vue
+++ /dev/null
@@ -1,55 +0,0 @@
-<template lang="pug">
- section.container
- div
- logo
- h1.title Nuxt.js with Pug Stylus and Coffee!
- h2.subtitle {{ $store.state.msg }}
- //- h2.subtitle {{message}}
- .links
- a.button--green(
- href='https://nuxtjs.org/'
- arget='_blank') Documentation
- a.button--grey(
- href='https://github.com/nuxt/nuxt.js'
- target='_blank') GitHub
-</template>
-
-
-<script lang="coffee">
-import Logo from '~/components/Logo.vue'
-
-export default
- components: { Logo }
- computed:
- message: -> @$store.state.msgComputed
-</script>
-
-<style lang="stylus">
-.container
- margin: 0 auto
- min-height: 100vh
- display: flex
- justify-content: center
- align-items: center
- text-align: center
-
-.title
- font-family: 'Quicksand', 'Source Sans Pro', -apple-system, BlinkMacSystemFont,
- 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif
- display: block
- font-weight: 300
- font-size: 60px
- color: #35495e
- letter-spacing: 1px
- padding 5%
-
-.subtitle
- font-weight: 300
- font-size: 42px
- color: #526488
- word-spacing: 5px
- padding-bottom: 15px
-
-.links
- padding-top: 15px
-</style>
diff --git a/examples/pug-stylus-coffee/plugins/README.md b/examples/pug-stylus-coffee/plugins/README.md
deleted file mode 100644
index ca1f9d8a452e..000000000000
--- a/examples/pug-stylus-coffee/plugins/README.md
+++ /dev/null
@@ -1,7 +0,0 @@
-# PLUGINS
-
-**This directory is not required, you can delete it if you don't want to use it.**
-
-This directory contains Javascript plugins that you want to run before mounting the root Vue.js application.
-
-More information about the usage of this directory in [the documentation](https://nuxtjs.org/guide/plugins).
diff --git a/examples/pug-stylus-coffee/static/README.md b/examples/pug-stylus-coffee/static/README.md
deleted file mode 100644
index 3fc500234819..000000000000
--- a/examples/pug-stylus-coffee/static/README.md
+++ /dev/null
@@ -1,10 +0,0 @@
-# STATIC
-
-**This directory is not required, you can delete it if you don't want to use it.**
-
-This directory contains your static files.
-Each file inside this directory is mapped to `/`.
-
-Example: `/static/robots.txt` is mapped as `/robots.txt`.
-
-More information about the usage of this directory in [the documentation](https://nuxtjs.org/guide/assets#static).
diff --git a/examples/pug-stylus-coffee/static/favicon.ico b/examples/pug-stylus-coffee/static/favicon.ico
deleted file mode 100644
index c785410aa253..000000000000
Binary files a/examples/pug-stylus-coffee/static/favicon.ico and /dev/null differ
diff --git a/examples/pug-stylus-coffee/store/README.md b/examples/pug-stylus-coffee/store/README.md
deleted file mode 100644
index 1972d277a298..000000000000
--- a/examples/pug-stylus-coffee/store/README.md
+++ /dev/null
@@ -1,10 +0,0 @@
-# STORE
-
-**This directory is not required, you can delete it if you don't want to use it.**
-
-This directory contains your Vuex Store files.
-Vuex Store option is implemented in the Nuxt.js framework.
-
-Creating a file in this directory automatically activates the option in the framework.
-
-More information about the usage of this directory in [the documentation](https://nuxtjs.org/guide/vuex-store).
diff --git a/examples/pug-stylus-coffee/store/index.coffee b/examples/pug-stylus-coffee/store/index.coffee
deleted file mode 100644
index 5b8fb88be64f..000000000000
--- a/examples/pug-stylus-coffee/store/index.coffee
+++ /dev/null
@@ -1,3 +0,0 @@
-export state = ->
- msg: 'Hello from /store/index.coffee!'
- msgComputed: 'Hello from /store/index.coffee computed!'
diff --git a/examples/pug/README.md b/examples/pug/README.md
deleted file mode 100644
index 8fc6026c9736..000000000000
--- a/examples/pug/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Nuxt.js with Pug
-
-No further packages needed. It works out of the box.
diff --git a/examples/pug/package.json b/examples/pug/package.json
deleted file mode 100644
index c434da1ea305..000000000000
--- a/examples/pug/package.json
+++ /dev/null
@@ -1,14 +0,0 @@
-{
- "name": "example-pug",
- "dependencies": {
- "nuxt": "latest",
- "pug": "^2.0.3",
- "pug-plain-loader": "^1.0.0"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/pug/pages/about.vue b/examples/pug/pages/about.vue
deleted file mode 100755
index 7461ff054648..000000000000
--- a/examples/pug/pages/about.vue
+++ /dev/null
@@ -1,18 +0,0 @@
-<template lang="pug">
- div
- p Hi from {{ name }}
- NuxtLink(to="/") Home Page
-</template>
-
-<script>
-export default {
- asyncData () {
- return {
- name: process.static ? 'static' : (process.server ? 'server' : 'client')
- }
- },
- head: {
- title: 'About page'
- }
-}
-</script>
diff --git a/examples/pug/pages/index.vue b/examples/pug/pages/index.vue
deleted file mode 100755
index 702997299149..000000000000
--- a/examples/pug/pages/index.vue
+++ /dev/null
@@ -1,13 +0,0 @@
-<template lang="pug">
- div
- h1 Welcome
- NuxtLink(to="/about") About Page
-</template>
-
-<script>
-export default {
- head: {
- title: 'Home page'
- }
-}
-</script>
diff --git a/examples/routes-meta/README.md b/examples/routes-meta/README.md
deleted file mode 100644
index 318c8209bb71..000000000000
--- a/examples/routes-meta/README.md
+++ /dev/null
@@ -1,5 +0,0 @@
-# Routes meta with Nuxt.js
-
-Demo: https://nuxt-routes-meta.glitch.me
-
-Live edit: https://glitch.com/edit/#!/nuxt-routes-meta
diff --git a/examples/routes-meta/layouts/default.vue b/examples/routes-meta/layouts/default.vue
deleted file mode 100644
index a07cf4394135..000000000000
--- a/examples/routes-meta/layouts/default.vue
+++ /dev/null
@@ -1,73 +0,0 @@
-<template>
- <div :class="$store.state.theme" class="theme">
- <div class="nav horizontal-align">
- <NuxtLink class="nav-item" to="/">
- Home
- </NuxtLink>
- <NuxtLink class="nav-item" to="/about">
- About
- </NuxtLink>
- <NuxtLink class="nav-item" to="/parent">
- Parent page
- </NuxtLink>
- </div>
- <Nuxt class="container" />
- </div>
-</template>
-
-<style>
-body,
-html {
- padding: 0;
- margin: 0;
- min-height: 100vh;
-}
-.nav-item {
- text-decoration: none;
- font-size: 1.2em;
-}
-.theme {
- min-height: 100vh;
- padding-top: 2rem;
-}
-/*
-** Light theme
-*/
-.theme.light {
- background: #f5f5f5;
- color: #202020;
-}
-.theme.light a {
- color: #555;
-}
-/*
-** Dark theme
-*/
-.theme.dark {
- background: #202020;
- color: #f5f5f5;
-}
-.theme.dark a {
- color: #eee;
-}
-/*
-** Orange theme
-*/
-.theme.orange {
- background: #ffc107;
- color: #795548;
-}
-.theme.orange a {
- color: #202020;
-}
-/*
-** Blue theme
-*/
-.theme.blue {
- background: #3f51b5;
- color: #f5f5f5;
-}
-.theme.blue a {
- color: #eee;
-}
-</style>
diff --git a/examples/routes-meta/middleware/theme.js b/examples/routes-meta/middleware/theme.js
deleted file mode 100644
index 91cb0e85e0a4..000000000000
--- a/examples/routes-meta/middleware/theme.js
+++ /dev/null
@@ -1,5 +0,0 @@
-export default ({ route, store }) => {
- // Take the last value (latest route child)
- const theme = route.meta.reduce((theme, meta) => meta.theme || theme, 'light')
- store.commit('SET_THEME', theme)
-}
diff --git a/examples/routes-meta/nuxt.config.js b/examples/routes-meta/nuxt.config.js
deleted file mode 100644
index e97a8c3a3bf6..000000000000
--- a/examples/routes-meta/nuxt.config.js
+++ /dev/null
@@ -1,6 +0,0 @@
-export default {
- router: {
- middleware: ['theme']
- },
- css: ['wingcss']
-}
diff --git a/examples/routes-meta/package.json b/examples/routes-meta/package.json
deleted file mode 100644
index 2eae745848d8..000000000000
--- a/examples/routes-meta/package.json
+++ /dev/null
@@ -1,13 +0,0 @@
-{
- "name": "examples-routes-meta",
- "dependencies": {
- "nuxt": "latest",
- "wingcss": "^1.0.0-beta"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/routes-meta/pages/about.vue b/examples/routes-meta/pages/about.vue
deleted file mode 100644
index 89b92384f8dd..000000000000
--- a/examples/routes-meta/pages/about.vue
+++ /dev/null
@@ -1,32 +0,0 @@
-<template>
- <div>
- <h1>About</h1>
- <p> I am the about page and have set in my component:</p>
- <pre>export default {
- meta: {
- theme: 'dark'
- }
-}</pre>
- </div>
-</template>
-
-<script>
-export default {
- meta: {
- theme: 'dark'
- }
-}
-</script>
-
-<style scoped>
-pre {
- padding: 0.2rem 0.5rem;
- margin: 0 0.2rem;
- font-size: 90%;
- background: #f1f1f1;
- color: #202020;
- border: 1px solid #e1e1e1;
- border-radius: 4px;
- font-family: Consolas, Monaco, Menlo, monospace;
-}
-</style>
diff --git a/examples/routes-meta/pages/index.vue b/examples/routes-meta/pages/index.vue
deleted file mode 100644
index 0eeec0bb91df..000000000000
--- a/examples/routes-meta/pages/index.vue
+++ /dev/null
@@ -1,22 +0,0 @@
-<template>
- <div>
- <h1>Page with meta</h1>
- <p>
- This example is made to illustrate the usafe of
- <code>meta</code> inside the page components.
- </p>
- <p>
- We have a middleware setup in
- <code>~/middleware/theme.js</code> used to get which theme has to be applied and commit it to the store.
- </p>
- <p>
- Then, in our layout, we simply use
- <code>$store.state.theme</code> as a class to change our CSS dynamically.
- </p>
- </div>
-</template>
-
-<script>
-export default {
-}
-</script>
diff --git a/examples/routes-meta/pages/parent.vue b/examples/routes-meta/pages/parent.vue
deleted file mode 100644
index f679baafac3e..000000000000
--- a/examples/routes-meta/pages/parent.vue
+++ /dev/null
@@ -1,18 +0,0 @@
-<template>
- <div>
- <h1>Parent</h1>
- Checkout
- <NuxtLink to="/parent/blue">
- Blue page
- </NuxtLink>
- <NuxtChild />
- </div>
-</template>
-
-<script>
-export default {
- meta: {
- theme: 'orange'
- }
-}
-</script>
diff --git a/examples/routes-meta/pages/parent/blue.vue b/examples/routes-meta/pages/parent/blue.vue
deleted file mode 100644
index ec654910a4b8..000000000000
--- a/examples/routes-meta/pages/parent/blue.vue
+++ /dev/null
@@ -1,20 +0,0 @@
-<template>
- <div>
- <h3>I am the blue page</h3>
- <p>I am a child of /parent, and the theme is overwritten by myself!</p>
- <p>
- Go back to
- <NuxtLink to="/parent">
- Parent
- </NuxtLink>
- </p>
- </div>
-</template>
-
-<script>
-export default {
- meta: {
- theme: 'blue'
- }
-}
-</script>
diff --git a/examples/routes-meta/store/index.js b/examples/routes-meta/store/index.js
deleted file mode 100644
index 23f500d4ea4c..000000000000
--- a/examples/routes-meta/store/index.js
+++ /dev/null
@@ -1,9 +0,0 @@
-export const state = () => ({
- theme: 'light'
-})
-
-export const mutations = {
- SET_THEME (state, theme) {
- state.theme = theme
- }
-}
diff --git a/examples/routes-transitions/README.md b/examples/routes-transitions/README.md
deleted file mode 100644
index fe38a76062dc..000000000000
--- a/examples/routes-transitions/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Routes transitions with Nuxt.js
-
-https://nuxtjs.org/examples/routes-transitions
diff --git a/examples/routes-transitions/assets/main.css b/examples/routes-transitions/assets/main.css
deleted file mode 100644
index b70172dea406..000000000000
--- a/examples/routes-transitions/assets/main.css
+++ /dev/null
@@ -1,45 +0,0 @@
-body {
- font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, 'Fira Sans', 'Droid Sans', 'Helvetica Neue', sans-serif;
-}
-
-.container {
- text-align: center;
- padding-top: 200px;
- font-size: 20px;
- transition: all .5s cubic-bezier(.55,0,.1,1);
-}
-
-.page-enter-active, .page-leave-active {
- transition: opacity .5s
-}
-.page-enter, .page-leave-active {
- opacity: 0
-}
-
-.bounce-enter-active {
- animation: bounce-in .8s;
-}
-.bounce-leave-active {
- animation: bounce-out .5s;
-}
-@keyframes bounce-in {
- 0% { transform: scale(0) }
- 50% { transform: scale(1.5) }
- 100% { transform: scale(1) }
-}
-@keyframes bounce-out {
- 0% { transform: scale(1) }
- 50% { transform: scale(1.5) }
- 100% { transform: scale(0) }
-}
-
-.slide-left-enter,
-.slide-right-leave-active {
- opacity: 0;
- transform: translate(30px, 0);
-}
-.slide-left-leave-active,
-.slide-right-enter {
- opacity: 0;
- transform: translate(-30px, 0);
-}
diff --git a/examples/routes-transitions/nuxt.config.js b/examples/routes-transitions/nuxt.config.js
deleted file mode 100644
index 737f5169915b..000000000000
--- a/examples/routes-transitions/nuxt.config.js
+++ /dev/null
@@ -1,3 +0,0 @@
-export default {
- css: ['~/assets/main.css']
-}
diff --git a/examples/routes-transitions/package.json b/examples/routes-transitions/package.json
deleted file mode 100644
index 365851f27989..000000000000
--- a/examples/routes-transitions/package.json
+++ /dev/null
@@ -1,12 +0,0 @@
-{
- "name": "example-routes-transitions",
- "dependencies": {
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/routes-transitions/pages/about.vue b/examples/routes-transitions/pages/about.vue
deleted file mode 100644
index 33199b54d3af..000000000000
--- a/examples/routes-transitions/pages/about.vue
+++ /dev/null
@@ -1,14 +0,0 @@
-<template>
- <div class="container">
- <h1>About page</h1>
- <NuxtLink to="/">
- Home page
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- transition: 'bounce'
-}
-</script>
diff --git a/examples/routes-transitions/pages/index.vue b/examples/routes-transitions/pages/index.vue
deleted file mode 100644
index 9e6c927d20f7..000000000000
--- a/examples/routes-transitions/pages/index.vue
+++ /dev/null
@@ -1,15 +0,0 @@
-<template>
- <div class="container">
- <h1>Home page</h1>
- <p>
- <NuxtLink to="/about">
- About page
- </NuxtLink>
- </p>
- <p>
- <NuxtLink to="/users">
- Lists of users
- </NuxtLink>
- </p>
- </div>
-</template>
diff --git a/examples/routes-transitions/pages/users.vue b/examples/routes-transitions/pages/users.vue
deleted file mode 100644
index 064e2a54e575..000000000000
--- a/examples/routes-transitions/pages/users.vue
+++ /dev/null
@@ -1,87 +0,0 @@
-<template>
- <div class="container">
- <NuxtLink v-if="page > 1" :to="'?page=' + (page - 1)">
- < Prev
- </NuxtLink>
- <a v-else class="disabled">
- < Prev
- </a>
- <span>{{ page }}/{{ totalPages }}</span>
- <NuxtLink v-if="page < totalPages" :to="'?page=' + (page + 1)">
- Next >
- </NuxtLink>
- <a v-else class="disabled">
- Next >
- </a>
- <ul>
- <li v-for="user in users" :key="user.id">
- <img :src="user.avatar" class="avatar">
- <span>{{ user.first_name }} {{ user.last_name }}</span>
- </li>
- </ul>
- <p>
- <NuxtLink to="/">
- Back home
- </NuxtLink>
- </p>
- </div>
-</template>
-
-<script>
-export default {
- // Watch for $route.query.page to call Component methods (asyncData, fetch, validate, layout, etc.)
- watchQuery: ['page'],
- // Key for <NuxtChild> (transitions)
- key: to => to.fullPath,
- // Called to know which transition to apply
- transition (to, from) {
- if (!from) { return 'slide-left' }
- return +to.query.page < +from.query.page ? 'slide-right' : 'slide-left'
- },
- async asyncData ({ query }) {
- const page = +query.page || 1
- const data = await fetch(`https://reqres.in/api/users?page=${page}`).then(res => res.json())
-
- return {
- page: +data.page,
- totalPages: data.total_pages,
- users: data.data
- }
- }
-}
-</script>
-
-<style scoped>
-a {
- display: inline-block;
- margin: 0 1em;
- color: #34495e;
- text-decoration: none;
-}
-a.disabled {
- color: #ccc;
-}
-ul {
- margin: auto;
- padding: 0;
- width: 100%;
- max-width: 400px;
- padding-top: 40px;
-}
-li {
- list-style-type: none;
- width: 400px;
- border: 1px #ddd solid;
- overflow: hidden;
-}
-li img {
- float: left;
- width: 100px;
- height: 100px;
-}
-li span {
- display: inline-block;
- padding-top: 40px;
- text-transform: uppercase;
-}
-</style>
diff --git a/examples/scroll-behavior/README.md b/examples/scroll-behavior/README.md
deleted file mode 100644
index a4cb7c288475..000000000000
--- a/examples/scroll-behavior/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Custom scroll behavior with Nuxt.js
-
-https://nuxtjs.org/examples/custom-scroll-behavior
diff --git a/examples/scroll-behavior/assets/main.css b/examples/scroll-behavior/assets/main.css
deleted file mode 100644
index 3cbe3caad2e0..000000000000
--- a/examples/scroll-behavior/assets/main.css
+++ /dev/null
@@ -1,69 +0,0 @@
-body {
- font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, 'Fira Sans', 'Droid Sans', 'Helvetica Neue', sans-serif;
-}
-
-.container {
- padding: 20px;
- text-align: center;
- font-size: 20px;
- transition: all .5s cubic-bezier(.55,0,.1,1);
-}
-
-.child {
- position: absolute;
- top: 200px;
- left: 0;
- width: 100%;
- text-align: center;
- font-size: 16px;
- transition: all .5s cubic-bezier(.55,0,.1,1);
-}
-
-ul {
- list-style: none;
- padding: 0;
-}
-
-.page-enter-active, .page-leave-active {
- transition: opacity .5s
-}
-.page-enter, .page-leave-active {
- opacity: 0
-}
-
-.bounce-enter-active {
- animation: bounce-in .8s;
-}
-.bounce-leave-active {
- animation: bounce-out .5s;
-}
-@keyframes bounce-in {
- 0% { transform: scale(0) }
- 50% { transform: scale(1.5) }
- 100% { transform: scale(1) }
-}
-@keyframes bounce-out {
- 0% { transform: scale(1) }
- 50% { transform: scale(1.5) }
- 100% { transform: scale(0) }
-}
-
-.slide-left-enter,
-.slide-right-leave-active {
- opacity: 0;
- transform: translate(30px, 0);
-}
-.slide-left-leave-active,
-.slide-right-enter {
- opacity: 0;
- transform: translate(-30px, 0);
-}
-
-.fade-enter,
-.fade-leave-active {
- opacity: 0;
-}
-.fade-leave-active,
-.fade-enter {
- opacity: 0;
-}
diff --git a/examples/scroll-behavior/layouts/default2.vue b/examples/scroll-behavior/layouts/default2.vue
deleted file mode 100644
index 5d3ae9c407bd..000000000000
--- a/examples/scroll-behavior/layouts/default2.vue
+++ /dev/null
@@ -1,3 +0,0 @@
-<template>
- <Nuxt />
-</template>
diff --git a/examples/scroll-behavior/nuxt.config.js b/examples/scroll-behavior/nuxt.config.js
deleted file mode 100644
index c236197313e2..000000000000
--- a/examples/scroll-behavior/nuxt.config.js
+++ /dev/null
@@ -1,4 +0,0 @@
-export default {
- css: ['~/assets/main.css'],
- modules: ['@nuxtjs/axios']
-}
diff --git a/examples/scroll-behavior/package.json b/examples/scroll-behavior/package.json
deleted file mode 100644
index 7db9bc42611a..000000000000
--- a/examples/scroll-behavior/package.json
+++ /dev/null
@@ -1,14 +0,0 @@
-{
- "name": "example-scroll-behavior",
- "dependencies": {
- "@nuxtjs/axios": "^5.3.6",
- "nuxt": "latest",
- "vue-router": "https://github.com/homerjam/vue-router#dist"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/scroll-behavior/pages/about.vue b/examples/scroll-behavior/pages/about.vue
deleted file mode 100644
index 837e71361db7..000000000000
--- a/examples/scroll-behavior/pages/about.vue
+++ /dev/null
@@ -1,27 +0,0 @@
-<template>
- <div class="container">
- <h1>About page</h1>
- <ul>
- <li>
- <NuxtLink to="/about/profile">
- Profile
- </NuxtLink>
- </li>
- <li>
- <NuxtLink to="/about/contact">
- Contact
- </NuxtLink>
- </li>
- </ul>
- <NuxtChild />
- <NuxtLink to="/">
- Home page
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- transition: 'fade'
-}
-</script>
diff --git a/examples/scroll-behavior/pages/about/contact.vue b/examples/scroll-behavior/pages/about/contact.vue
deleted file mode 100644
index 8c3f36f4d9db..000000000000
--- a/examples/scroll-behavior/pages/about/contact.vue
+++ /dev/null
@@ -1,13 +0,0 @@
-<template>
- <div class="child">
- <h1>Contact</h1>
- <div class="spacer" style="width: 100%; height: 3000px; background: grey" />
- </div>
-</template>
-
-<script>
-export default {
- transition: 'fade',
- scrollToTop: true
-}
-</script>
diff --git a/examples/scroll-behavior/pages/about/profile.vue b/examples/scroll-behavior/pages/about/profile.vue
deleted file mode 100644
index 28c0b38e500b..000000000000
--- a/examples/scroll-behavior/pages/about/profile.vue
+++ /dev/null
@@ -1,12 +0,0 @@
-<template>
- <div class="child">
- <h1>Profile</h1>
- <div class="spacer" style="width: 100%; height: 3000px; background: grey" />
- </div>
-</template>
-
-<script>
-export default {
- transition: 'fade'
-}
-</script>
diff --git a/examples/scroll-behavior/pages/another-long.vue b/examples/scroll-behavior/pages/another-long.vue
deleted file mode 100644
index 365451a6e7de..000000000000
--- a/examples/scroll-behavior/pages/another-long.vue
+++ /dev/null
@@ -1,16 +0,0 @@
-<template>
- <div class="container">
- <h1>Another long page</h1>
- <div class="spacer" style="width: 100%; height: 3000px; background: darkgreen" />
- <NuxtLink to="/">
- Home page
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- layout: 'default2',
- scrollToTop: true
-}
-</script>
diff --git a/examples/scroll-behavior/pages/index.vue b/examples/scroll-behavior/pages/index.vue
deleted file mode 100644
index 2c108144bc25..000000000000
--- a/examples/scroll-behavior/pages/index.vue
+++ /dev/null
@@ -1,31 +0,0 @@
-<template>
- <div class="container">
- <h1>Home page</h1>
- <p>
- <NuxtLink to="/about">
- About page
- </NuxtLink>
- </p>
- <p>
- <NuxtLink to="/users">
- Lists of users
- </NuxtLink>
- </p>
- <p>
- <NuxtLink to="/long">
- Long page
- </NuxtLink>
- </p>
- <p>
- <NuxtLink to="/long#anchor">
- Long page #anchor
- </NuxtLink>
- </p>
- <div class="spacer" style="width: 100%; height: 3000px; background: grey" />
- <p>
- <NuxtLink to="/another-long">
- Another long page
- </NuxtLink>
- </p>
- </div>
-</template>
diff --git a/examples/scroll-behavior/pages/long.vue b/examples/scroll-behavior/pages/long.vue
deleted file mode 100644
index 244914778972..000000000000
--- a/examples/scroll-behavior/pages/long.vue
+++ /dev/null
@@ -1,42 +0,0 @@
-<template>
- <div class="container">
- <h1>Long page</h1>
- <p>
- <a href="#anchor">
- Go to anchor
- </a>
- </p>
- <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam neque turpis, tempor vitae accumsan eget, bibendum eget dui. Vestibulum fringilla mi ac nunc malesuada accumsan. Proin mattis, ex vitae rhoncus dapibus, tellus tortor tincidunt metus, sed scelerisque dolor nunc rhoncus enim. Pellentesque semper interdum quam in placerat. Sed ut finibus mi. Aliquam placerat tellus ac tincidunt sodales. Quisque pharetra neque a risus placerat, sed suscipit felis mattis. Maecenas pretium efficitur fringilla. Sed commodo leo congue velit pretium, in consequat ex egestas. Pellentesque gravida vitae elit varius condimentum. Fusce in magna tellus. Proin in odio ac est elementum pharetra.</p>
- <p>Vivamus dapibus libero sem, eu sagittis lorem hendrerit id. Suspendisse faucibus sapien quis cursus lobortis. Phasellus blandit tellus at arcu ornare fermentum. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Morbi ac massa sollicitudin, lacinia lacus porta, cursus mi. Interdum et malesuada fames ac ante ipsum primis in faucibus. Nunc aliquam quis elit ut maximus. Integer blandit ipsum sed elit laoreet consequat. Pellentesque quis volutpat tellus, vitae finibus nulla. Etiam a porta orci. Morbi at libero sit amet tortor eleifend congue. Integer egestas fermentum lacinia. Curabitur dignissim, enim eget consectetur tempor, lacus felis auctor ante, in egestas arcu turpis ut tellus. Phasellus mattis dictum leo, a gravida purus tristique sed. Pellentesque sollicitudin arcu eu augue vehicula, molestie hendrerit sapien mollis.</p>
- <p>Nunc ullamcorper magna nunc, vitae vestibulum est laoreet vel. Aliquam erat volutpat. Duis vehicula ligula at justo egestas posuere. Mauris pharetra nulla ac pretium eleifend. Mauris purus eros, venenatis sollicitudin ornare id, mattis in lorem. Curabitur tortor magna, viverra eget lorem ultricies, aliquam aliquam libero. Maecenas vestibulum id libero sed fermentum. Praesent consequat dui sed pellentesque commodo. Curabitur finibus purus vel purus mattis luctus. Nullam maximus dapibus orci, ac mattis diam egestas vel. Praesent lorem dolor, congue quis gravida commodo, rhoncus nec justo. In et elementum augue. Donec fringilla imperdiet magna, quis luctus leo placerat sed. Morbi scelerisque in sem eu dapibus. Sed interdum, felis luctus semper viverra, ex lorem posuere velit, in bibendum nunc dolor et diam.</p>
- <p>Duis pulvinar lorem vel tempus pellentesque. Vivamus imperdiet imperdiet augue, ac rhoncus velit vulputate eu. Sed sed nulla risus. Curabitur ut velit consectetur, semper velit quis, elementum tellus. Ut eget ligula eget leo porta vestibulum. Curabitur ligula magna, rutrum ut enim vitae, gravida sollicitudin augue. Aliquam auctor gravida mauris, nec feugiat ipsum mollis vel. Vivamus nec aliquet ipsum, id scelerisque nibh. Vestibulum iaculis eleifend nunc, vitae efficitur massa egestas et. Ut pulvinar, purus eget viverra sodales, est mauris luctus metus, non luctus tellus diam in elit.</p>
- <p>Quisque sollicitudin non urna non consectetur. Cras quis dapibus nisi. Maecenas maximus rhoncus neque, a lacinia urna egestas nec. Morbi molestie odio sit amet tempus cursus. Vivamus lorem nunc, malesuada et maximus id, imperdiet eget felis. Ut elementum fringilla velit in mattis. Morbi ut laoreet mi. Aliquam et odio dignissim, fermentum purus sit amet, facilisis lorem. Donec semper mi ut semper tristique. Sed in dolor placerat, porta elit in, tempor felis. Integer metus erat, tristique efficitur quam quis, finibus blandit magna. Nunc sit amet lorem dui. Suspendisse ut vulputate nisi. Integer sit amet sollicitudin libero.</p>
- <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam neque turpis, tempor vitae accumsan eget, bibendum eget dui. Vestibulum fringilla mi ac nunc malesuada accumsan. Proin mattis, ex vitae rhoncus dapibus, tellus tortor tincidunt metus, sed scelerisque dolor nunc rhoncus enim. Pellentesque semper interdum quam in placerat. Sed ut finibus mi. Aliquam placerat tellus ac tincidunt sodales. Quisque pharetra neque a risus placerat, sed suscipit felis mattis. Maecenas pretium efficitur fringilla. Sed commodo leo congue velit pretium, in consequat ex egestas. Pellentesque gravida vitae elit varius condimentum. Fusce in magna tellus. Proin in odio ac est elementum pharetra.</p>
- <p>Vivamus dapibus libero sem, eu sagittis lorem hendrerit id. Suspendisse faucibus sapien quis cursus lobortis. Phasellus blandit tellus at arcu ornare fermentum. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Morbi ac massa sollicitudin, lacinia lacus porta, cursus mi. Interdum et malesuada fames ac ante ipsum primis in faucibus. Nunc aliquam quis elit ut maximus. Integer blandit ipsum sed elit laoreet consequat. Pellentesque quis volutpat tellus, vitae finibus nulla. Etiam a porta orci. Morbi at libero sit amet tortor eleifend congue. Integer egestas fermentum lacinia. Curabitur dignissim, enim eget consectetur tempor, lacus felis auctor ante, in egestas arcu turpis ut tellus. Phasellus mattis dictum leo, a gravida purus tristique sed. Pellentesque sollicitudin arcu eu augue vehicula, molestie hendrerit sapien mollis.</p>
- <p>Nunc ullamcorper magna nunc, vitae vestibulum est laoreet vel. Aliquam erat volutpat. Duis vehicula ligula at justo egestas posuere. Mauris pharetra nulla ac pretium eleifend. Mauris purus eros, venenatis sollicitudin ornare id, mattis in lorem. Curabitur tortor magna, viverra eget lorem ultricies, aliquam aliquam libero. Maecenas vestibulum id libero sed fermentum. Praesent consequat dui sed pellentesque commodo. Curabitur finibus purus vel purus mattis luctus. Nullam maximus dapibus orci, ac mattis diam egestas vel. Praesent lorem dolor, congue quis gravida commodo, rhoncus nec justo. In et elementum augue. Donec fringilla imperdiet magna, quis luctus leo placerat sed. Morbi scelerisque in sem eu dapibus. Sed interdum, felis luctus semper viverra, ex lorem posuere velit, in bibendum nunc dolor et diam.</p>
- <p>Duis pulvinar lorem vel tempus pellentesque. Vivamus imperdiet imperdiet augue, ac rhoncus velit vulputate eu. Sed sed nulla risus. Curabitur ut velit consectetur, semper velit quis, elementum tellus. Ut eget ligula eget leo porta vestibulum. Curabitur ligula magna, rutrum ut enim vitae, gravida sollicitudin augue. Aliquam auctor gravida mauris, nec feugiat ipsum mollis vel. Vivamus nec aliquet ipsum, id scelerisque nibh. Vestibulum iaculis eleifend nunc, vitae efficitur massa egestas et. Ut pulvinar, purus eget viverra sodales, est mauris luctus metus, non luctus tellus diam in elit.</p>
- <p>Quisque sollicitudin non urna non consectetur. Cras quis dapibus nisi. Maecenas maximus rhoncus neque, a lacinia urna egestas nec. Morbi molestie odio sit amet tempus cursus. Vivamus lorem nunc, malesuada et maximus id, imperdiet eget felis. Ut elementum fringilla velit in mattis. Morbi ut laoreet mi. Aliquam et odio dignissim, fermentum purus sit amet, facilisis lorem. Donec semper mi ut semper tristique. Sed in dolor placerat, porta elit in, tempor felis. Integer metus erat, tristique efficitur quam quis, finibus blandit magna. Nunc sit amet lorem dui. Suspendisse ut vulputate nisi. Integer sit amet sollicitudin libero.</p>
- <h2 id="anchor">
- Anchor
- </h2>
- <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam neque turpis, tempor vitae accumsan eget, bibendum eget dui. Vestibulum fringilla mi ac nunc malesuada accumsan. Proin mattis, ex vitae rhoncus dapibus, tellus tortor tincidunt metus, sed scelerisque dolor nunc rhoncus enim. Pellentesque semper interdum quam in placerat. Sed ut finibus mi. Aliquam placerat tellus ac tincidunt sodales. Quisque pharetra neque a risus placerat, sed suscipit felis mattis. Maecenas pretium efficitur fringilla. Sed commodo leo congue velit pretium, in consequat ex egestas. Pellentesque gravida vitae elit varius condimentum. Fusce in magna tellus. Proin in odio ac est elementum pharetra.</p>
- <p>Vivamus dapibus libero sem, eu sagittis lorem hendrerit id. Suspendisse faucibus sapien quis cursus lobortis. Phasellus blandit tellus at arcu ornare fermentum. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Morbi ac massa sollicitudin, lacinia lacus porta, cursus mi. Interdum et malesuada fames ac ante ipsum primis in faucibus. Nunc aliquam quis elit ut maximus. Integer blandit ipsum sed elit laoreet consequat. Pellentesque quis volutpat tellus, vitae finibus nulla. Etiam a porta orci. Morbi at libero sit amet tortor eleifend congue. Integer egestas fermentum lacinia. Curabitur dignissim, enim eget consectetur tempor, lacus felis auctor ante, in egestas arcu turpis ut tellus. Phasellus mattis dictum leo, a gravida purus tristique sed. Pellentesque sollicitudin arcu eu augue vehicula, molestie hendrerit sapien mollis.</p>
- <p>Nunc ullamcorper magna nunc, vitae vestibulum est laoreet vel. Aliquam erat volutpat. Duis vehicula ligula at justo egestas posuere. Mauris pharetra nulla ac pretium eleifend. Mauris purus eros, venenatis sollicitudin ornare id, mattis in lorem. Curabitur tortor magna, viverra eget lorem ultricies, aliquam aliquam libero. Maecenas vestibulum id libero sed fermentum. Praesent consequat dui sed pellentesque commodo. Curabitur finibus purus vel purus mattis luctus. Nullam maximus dapibus orci, ac mattis diam egestas vel. Praesent lorem dolor, congue quis gravida commodo, rhoncus nec justo. In et elementum augue. Donec fringilla imperdiet magna, quis luctus leo placerat sed. Morbi scelerisque in sem eu dapibus. Sed interdum, felis luctus semper viverra, ex lorem posuere velit, in bibendum nunc dolor et diam.</p>
- <p>Duis pulvinar lorem vel tempus pellentesque. Vivamus imperdiet imperdiet augue, ac rhoncus velit vulputate eu. Sed sed nulla risus. Curabitur ut velit consectetur, semper velit quis, elementum tellus. Ut eget ligula eget leo porta vestibulum. Curabitur ligula magna, rutrum ut enim vitae, gravida sollicitudin augue. Aliquam auctor gravida mauris, nec feugiat ipsum mollis vel. Vivamus nec aliquet ipsum, id scelerisque nibh. Vestibulum iaculis eleifend nunc, vitae efficitur massa egestas et. Ut pulvinar, purus eget viverra sodales, est mauris luctus metus, non luctus tellus diam in elit.</p>
- <p>Quisque sollicitudin non urna non consectetur. Cras quis dapibus nisi. Maecenas maximus rhoncus neque, a lacinia urna egestas nec. Morbi molestie odio sit amet tempus cursus. Vivamus lorem nunc, malesuada et maximus id, imperdiet eget felis. Ut elementum fringilla velit in mattis. Morbi ut laoreet mi. Aliquam et odio dignissim, fermentum purus sit amet, facilisis lorem. Donec semper mi ut semper tristique. Sed in dolor placerat, porta elit in, tempor felis. Integer metus erat, tristique efficitur quam quis, finibus blandit magna. Nunc sit amet lorem dui. Suspendisse ut vulputate nisi. Integer sit amet sollicitudin libero.</p>
- <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam neque turpis, tempor vitae accumsan eget, bibendum eget dui. Vestibulum fringilla mi ac nunc malesuada accumsan. Proin mattis, ex vitae rhoncus dapibus, tellus tortor tincidunt metus, sed scelerisque dolor nunc rhoncus enim. Pellentesque semper interdum quam in placerat. Sed ut finibus mi. Aliquam placerat tellus ac tincidunt sodales. Quisque pharetra neque a risus placerat, sed suscipit felis mattis. Maecenas pretium efficitur fringilla. Sed commodo leo congue velit pretium, in consequat ex egestas. Pellentesque gravida vitae elit varius condimentum. Fusce in magna tellus. Proin in odio ac est elementum pharetra.</p>
- <p>Vivamus dapibus libero sem, eu sagittis lorem hendrerit id. Suspendisse faucibus sapien quis cursus lobortis. Phasellus blandit tellus at arcu ornare fermentum. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Morbi ac massa sollicitudin, lacinia lacus porta, cursus mi. Interdum et malesuada fames ac ante ipsum primis in faucibus. Nunc aliquam quis elit ut maximus. Integer blandit ipsum sed elit laoreet consequat. Pellentesque quis volutpat tellus, vitae finibus nulla. Etiam a porta orci. Morbi at libero sit amet tortor eleifend congue. Integer egestas fermentum lacinia. Curabitur dignissim, enim eget consectetur tempor, lacus felis auctor ante, in egestas arcu turpis ut tellus. Phasellus mattis dictum leo, a gravida purus tristique sed. Pellentesque sollicitudin arcu eu augue vehicula, molestie hendrerit sapien mollis.</p>
- <p>Nunc ullamcorper magna nunc, vitae vestibulum est laoreet vel. Aliquam erat volutpat. Duis vehicula ligula at justo egestas posuere. Mauris pharetra nulla ac pretium eleifend. Mauris purus eros, venenatis sollicitudin ornare id, mattis in lorem. Curabitur tortor magna, viverra eget lorem ultricies, aliquam aliquam libero. Maecenas vestibulum id libero sed fermentum. Praesent consequat dui sed pellentesque commodo. Curabitur finibus purus vel purus mattis luctus. Nullam maximus dapibus orci, ac mattis diam egestas vel. Praesent lorem dolor, congue quis gravida commodo, rhoncus nec justo. In et elementum augue. Donec fringilla imperdiet magna, quis luctus leo placerat sed. Morbi scelerisque in sem eu dapibus. Sed interdum, felis luctus semper viverra, ex lorem posuere velit, in bibendum nunc dolor et diam.</p>
- <p>Duis pulvinar lorem vel tempus pellentesque. Vivamus imperdiet imperdiet augue, ac rhoncus velit vulputate eu. Sed sed nulla risus. Curabitur ut velit consectetur, semper velit quis, elementum tellus. Ut eget ligula eget leo porta vestibulum. Curabitur ligula magna, rutrum ut enim vitae, gravida sollicitudin augue. Aliquam auctor gravida mauris, nec feugiat ipsum mollis vel. Vivamus nec aliquet ipsum, id scelerisque nibh. Vestibulum iaculis eleifend nunc, vitae efficitur massa egestas et. Ut pulvinar, purus eget viverra sodales, est mauris luctus metus, non luctus tellus diam in elit.</p>
- <p>Quisque sollicitudin non urna non consectetur. Cras quis dapibus nisi. Maecenas maximus rhoncus neque, a lacinia urna egestas nec. Morbi molestie odio sit amet tempus cursus. Vivamus lorem nunc, malesuada et maximus id, imperdiet eget felis. Ut elementum fringilla velit in mattis. Morbi ut laoreet mi. Aliquam et odio dignissim, fermentum purus sit amet, facilisis lorem. Donec semper mi ut semper tristique. Sed in dolor placerat, porta elit in, tempor felis. Integer metus erat, tristique efficitur quam quis, finibus blandit magna. Nunc sit amet lorem dui. Suspendisse ut vulputate nisi. Integer sit amet sollicitudin libero.</p>
- <NuxtLink to="/">
- Home page
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- transition: 'fade'
-}
-</script>
diff --git a/examples/scroll-behavior/pages/users.vue b/examples/scroll-behavior/pages/users.vue
deleted file mode 100644
index 4fb60006991a..000000000000
--- a/examples/scroll-behavior/pages/users.vue
+++ /dev/null
@@ -1,87 +0,0 @@
-<template>
- <div class="container">
- <NuxtLink v-if="page > 1" :to="'?page=' + (page - 1)">
- < Prev
- </NuxtLink>
- <a v-else class="disabled">
- < Prev
- </a>
- <span>{{ page }}/{{ totalPages }}</span>
- <NuxtLink v-if="page < totalPages" :to="'?page=' + (page + 1)">
- Next >
- </NuxtLink>
- <a v-else class="disabled">
- Next >
- </a>
- <ul>
- <li v-for="user in users" :key="user.id">
- <img :src="user.avatar" class="avatar">
- <span>{{ user.first_name }} {{ user.last_name }}</span>
- </li>
- </ul>
- <p>
- <NuxtLink to="/">
- Back home
- </NuxtLink>
- </p>
- </div>
-</template>
-
-<script>
-
-export default {
- // Watch for $route.query.page to call Component methods (asyncData, fetch, validate, layout, etc.)
- watchQuery: ['page'],
- // Key for <NuxtChild> (transitions)
- key: to => to.fullPath,
- // Called to know which transition to apply
- transition (to, from) {
- if (!from) { return 'slide-left' }
- return +to.query.page < +from.query.page ? 'slide-right' : 'slide-left'
- },
- async asyncData ({ query, $axios }) {
- const page = +query.page || 1
- const data = await $axios.$get(`https://reqres.in/api/users?page=${page}`)
- return {
- page: +data.page,
- totalPages: data.total_pages,
- users: data.data
- }
- }
-}
-</script>
-
-<style scoped>
-a {
- display: inline-block;
- margin: 0 1em;
- color: #34495e;
- text-decoration: none;
-}
-a.disabled {
- color: #ccc;
-}
-ul {
- margin: auto;
- padding: 0;
- width: 100%;
- max-width: 400px;
- padding-top: 40px;
-}
-li {
- list-style-type: none;
- width: 400px;
- border: 1px #ddd solid;
- overflow: hidden;
-}
-li img {
- float: left;
- width: 100px;
- height: 100px;
-}
-li span {
- display: inline-block;
- padding-top: 40px;
- text-transform: uppercase;
-}
-</style>
diff --git a/examples/spa/README.md b/examples/spa/README.md
deleted file mode 100644
index b919cf3f9ad4..000000000000
--- a/examples/spa/README.md
+++ /dev/null
@@ -1,2 +0,0 @@
-# Nuxt in SPA mode
-
diff --git a/examples/spa/assets/main.css b/examples/spa/assets/main.css
deleted file mode 100644
index 1baea580c6c9..000000000000
--- a/examples/spa/assets/main.css
+++ /dev/null
@@ -1,6 +0,0 @@
-.appear-active {
- transition: opacity .5s
-}
-.appear {
- opacity: 0
-}
diff --git a/examples/spa/nuxt.config.js b/examples/spa/nuxt.config.js
deleted file mode 100644
index 84d3d9b1b8df..000000000000
--- a/examples/spa/nuxt.config.js
+++ /dev/null
@@ -1,41 +0,0 @@
-export default {
- /*
- ** Single Page Application mode
- ** Means no SSR
- */
- mode: 'spa',
- /*
- ** Headers of the page (works with SPA!)
- */
- head: {
- title: 'SPA mode with Nuxt.js',
- meta: [
- { charset: 'utf-8' },
- { name: 'viewport', content: 'width=device-width, initial-scale=1' },
- { hid: 'description', name: 'description', content: 'Single Page Application made with Nuxt.js' }
- ],
- link: [
- { rel: 'icon', type: 'image/x-icon', href: '/favicon.ico' }
- ]
- },
- /*
- ** Add css for appear transition
- */
- css: ['~/assets/main.css'],
- /*
- ** Customize loading indicator
- */
- loadingIndicator: {
- /*
- ** See https://nuxtjs.org/api/configuration-loading-indicator for available loading indicators
- ** You can add a custom indicator by giving a path
- */
- // name: 'folding-cube',
- /*
- ** You can give custom options given to the template
- ** See https://github.com/nuxt/nuxt.js/blob/dev/lib/app/views/loading/folding-cube.html
- */
- // color: '#DBE1EC'
- // background: 'white'
- }
-}
diff --git a/examples/spa/package.json b/examples/spa/package.json
deleted file mode 100644
index 6517c98127e0..000000000000
--- a/examples/spa/package.json
+++ /dev/null
@@ -1,12 +0,0 @@
-{
- "name": "example-spa",
- "dependencies": {
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/spa/pages/about.vue b/examples/spa/pages/about.vue
deleted file mode 100644
index 416642a9af83..000000000000
--- a/examples/spa/pages/about.vue
+++ /dev/null
@@ -1,18 +0,0 @@
-<template>
- <div>
- <p>Hi from {{ name }}</p>
- <NuxtLink to="/">
- Home page
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- asyncData () {
- return {
- name: (process.server ? 'server' : 'client')
- }
- }
-}
-</script>
diff --git a/examples/spa/pages/index.vue b/examples/spa/pages/index.vue
deleted file mode 100644
index 74922a35273a..000000000000
--- a/examples/spa/pages/index.vue
+++ /dev/null
@@ -1,8 +0,0 @@
-<template>
- <div>
- <h1>Welcome!</h1>
- <NuxtLink to="/about">
- About page
- </NuxtLink>
- </div>
-</template>
diff --git a/examples/spa/static/favicon.ico b/examples/spa/static/favicon.ico
deleted file mode 100644
index 382fecbbf96d..000000000000
Binary files a/examples/spa/static/favicon.ico and /dev/null differ
diff --git a/examples/static-images/README.md b/examples/static-images/README.md
deleted file mode 100644
index 058b3f3535e5..000000000000
--- a/examples/static-images/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Nuxt with static images
-
-How to use static images with nuxt
diff --git a/examples/static-images/package.json b/examples/static-images/package.json
deleted file mode 100644
index fa90475587ca..000000000000
--- a/examples/static-images/package.json
+++ /dev/null
@@ -1,12 +0,0 @@
-{
- "name": "example-static-images",
- "dependencies": {
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/static-images/pages/about.vue b/examples/static-images/pages/about.vue
deleted file mode 100644
index d7aaac8ff7e3..000000000000
--- a/examples/static-images/pages/about.vue
+++ /dev/null
@@ -1,40 +0,0 @@
-<template>
- <div class="container">
- <img src="~static/nuxt-black.png">
- <h2>Thank you for testing nuxt.js</h2>
- <p>Loaded from the {{ name }}</p>
- <p>
- <NuxtLink to="/">
- Back home
- </NuxtLink>
- </p>
- </div>
-</template>
-
-<script>
-export default {
- asyncData ({ req }) {
- return {
- name: req ? 'server' : 'client'
- }
- }
-}
-</script>
-
-<style scoped>
-.container {
- position: absolute;
- top: 0;
- left: 0;
- height: 100%;
- width: 100%;
- background: black;
- color: white;
- font-family: "Lucida Console", Monaco, monospace;
- padding-top: 130px;
- text-align: center;
-}
-a {
- color: silver;
-}
-</style>
diff --git a/examples/static-images/pages/index.vue b/examples/static-images/pages/index.vue
deleted file mode 100644
index 92d956cf6885..000000000000
--- a/examples/static-images/pages/index.vue
+++ /dev/null
@@ -1,19 +0,0 @@
-<template>
- <div class="container">
- <img src="nuxt.png">
- <h2>Hello World.</h2>
- <p>
- <NuxtLink to="/about">
- About
- </NuxtLink>
- </p>
- </div>
-</template>
-
-<style scoped>
-.container {
- font-family: sans-serif;
- margin-top: 200px;
- text-align: center;
-}
-</style>
diff --git a/examples/static-images/static/nuxt-black.png b/examples/static-images/static/nuxt-black.png
deleted file mode 100644
index fd58ee4497ab..000000000000
Binary files a/examples/static-images/static/nuxt-black.png and /dev/null differ
diff --git a/examples/static-images/static/nuxt.png b/examples/static-images/static/nuxt.png
deleted file mode 100644
index bba7a9a99be9..000000000000
Binary files a/examples/static-images/static/nuxt.png and /dev/null differ
diff --git a/examples/storybook/.storybook/addons.js b/examples/storybook/.storybook/addons.js
deleted file mode 100644
index b4ae4fc5363e..000000000000
--- a/examples/storybook/.storybook/addons.js
+++ /dev/null
@@ -1,5 +0,0 @@
-import '@storybook/addon-knobs/register'
-import '@storybook/addon-actions/register'
-import '@storybook/addon-links/register'
-import '@storybook/addon-notes/register'
-import '@storybook/addon-viewport/register'
diff --git a/examples/storybook/.storybook/config.js b/examples/storybook/.storybook/config.js
deleted file mode 100644
index 6b006914ff86..000000000000
--- a/examples/storybook/.storybook/config.js
+++ /dev/null
@@ -1,21 +0,0 @@
-import 'vuetify/dist/vuetify.css'
-
-import { configure } from '@storybook/vue'
-import Vue from 'vue'
-import Vuex from 'vuex'
-import Vuetify from 'vuetify'
-import MyButton from '../components/Button.vue'
-
-Vue.use(Vuex)
-Vue.use(Vuetify)
-
-Vue.component('my-button', MyButton)
-
-// Automatically import all files ending in *.stories.js
-const req = require.context('../stories', true, /.story.js$/)
-
-function loadStories() {
- req.keys().forEach(req)
-}
-
-configure(loadStories, module)
diff --git a/examples/storybook/.storybook/webpack.config.js b/examples/storybook/.storybook/webpack.config.js
deleted file mode 100644
index c1fcd43e3926..000000000000
--- a/examples/storybook/.storybook/webpack.config.js
+++ /dev/null
@@ -1,14 +0,0 @@
-const path = require('path')
-const nuxtConf = require('../nuxt.config')
-
-module.exports = (sBaseConfig, configType, defaultConfig) => {
- const srcDir = `../${nuxtConf.srcDir || ''}`
- const rootDir = `../${nuxtConf.rootDir || ''}`
-
- Object.assign(defaultConfig.resolve.alias, {
- '~~': path.resolve(__dirname, rootDir),
- '~': path.resolve(__dirname, srcDir)
- })
-
- return defaultConfig
-}
diff --git a/examples/storybook/README.md b/examples/storybook/README.md
deleted file mode 100644
index 0d85f97591d1..000000000000
--- a/examples/storybook/README.md
+++ /dev/null
@@ -1,44 +0,0 @@
-# Storybook demo for Nuxt
-
-Demo showcasing [Storybook](https://storybook.js.org/) usage with Nuxt.js, [Vuetify](https://vuetifyjs.com) and [Vue-Charts](http://vue-chartjs.org/)
-
-## Features
-
-* Supports `~` and `~~` Nuxt.js aliases
-* Contains `storybase.js` with helper classes
-* Integrates most of addons
-* Real life examples with Vuetify and Vue-Charts
-
-## Description
-
-This demo aims to integrate all the above mentioned technologies with best practices in mind.
-
-Points of interest
-
-* `.storybook` folder contains storybook configuration
-* `stories` folder has number of stories corresponding to `components`
-* Note, Storybook is configured to understand Nuxt aliases `~` and `~~`
-* Number of helpers in `storybase.js` to simplify storybook usahe
-
-## Usage
-
-To run locally in dev mode
-
-```
-npm run storybook
-```
-
-and then access the storybook from [localhost:9001](http://localhost:9001)
-
-To build static storybook to `.out` folder
-
-```
-npm run storybookoutput
-```
-
-## More reading
-
-* [Using Storybook with Nuxt](https://davidwalsh.name/storybook-nuxt) by David Walsh
-* [StoryBook for Vue](https://github.com/storybooks/storybook/tree/master/app/vue)
-* [Vue Kitchen sink Storybook demo](https://github.com/storybooks/storybook/tree/master/examples/vue-kitchen-sink)
-* [Vuetify Storybook boilerplate](https://github.com/white-rabbit-japan/vuetify-storyboard-boilerplate)
diff --git a/examples/storybook/components/Button.vue b/examples/storybook/components/Button.vue
deleted file mode 100644
index 2bcefd833581..000000000000
--- a/examples/storybook/components/Button.vue
+++ /dev/null
@@ -1,36 +0,0 @@
-<template>
- <button :style="{color: color, borderColor: color}" :class="{rounded: rounded}" class="wr-button" @click="handleClick">
- <slot />!
- </button>
-</template>
-
-<script>
-export default {
- props: {
- rounded: {
- type: Boolean,
- default: false
- },
- handleClick: {
- type: Function,
- default: () => () => null
- },
- color: {
- type: String,
- default: '#42b983'
- }
- }
-}
-</script>
-
-<style>
-.rounded {
- border-radius: 10px;
-}
-.wr-button {
- border: 3px solid;
- padding: 10px 20px;
- background-color: white;
- outline: none;
-}
-</style>
diff --git a/examples/storybook/components/Layout.vue b/examples/storybook/components/Layout.vue
deleted file mode 100644
index 70ad04e57912..000000000000
--- a/examples/storybook/components/Layout.vue
+++ /dev/null
@@ -1,92 +0,0 @@
-<template>
- <v-app id="inspire" dark>
- <v-navigation-drawer
- v-model="drawer"
- clipped
- fixed
- app
- >
- <v-list dense>
- <v-list-group v-for="item in items" :key="item.title" :value="item.active">
- <v-list-tile slot="item">
- <v-list-tile-action>
- <v-icon>{{ item.action }}</v-icon>
- </v-list-tile-action>
- <v-list-tile-content>
- <v-list-tile-title>{{ item.title }}</v-list-tile-title>
- </v-list-tile-content>
- <v-list-tile-action>
- <v-icon v-if="item.items">
- keyboard_arrow_down
- </v-icon>
- </v-list-tile-action>
- </v-list-tile>
- <v-list-tile v-for="subItem in item.items" :key="subItem.title">
- <v-list-tile-content>
- <v-list-tile-title>{{ subItem.title }}</v-list-tile-title>
- </v-list-tile-content>
- <v-list-tile-action>
- <v-icon>{{ subItem.action }}</v-icon>
- </v-list-tile-action>
- </v-list-tile>
- </v-list-group>
- </v-list>
- </v-navigation-drawer>
- <v-toolbar app fixed clipped-left>
- <v-toolbar-side-icon @click.stop="drawer = !drawer" />
- <v-toolbar-title>Application</v-toolbar-title>
- </v-toolbar>
- <v-content>
- <v-container grid-list-md text-xs-center>
- <v-layout row wrap>
- <v-flex xs12>
- <v-card dark color="primary">
- <v-card-text class="px-0">
- <slot />
- </v-card-text>
- </v-card>
- </v-flex>
- </v-layout>
- </v-container>
-
- <v-container fluid fill-height>
- <v-layout justify-center align-center>
- <v-tooltip right>
- <v-btn slot="activator" :href="source" icon large target="_blank">
- <v-icon large>
- code
- </v-icon>
- </v-btn>
- <span>Source</span>
- </v-tooltip>
- </v-layout>
- </v-container>
- </v-content>
- <v-footer app fixed>
- <span>© 2017</span>
- </v-footer>
- </v-app>
-</template>
-
-<script>
-export default {
- name: 'Layout',
- props: {
- items: {
- type: Array,
- default: () => []
- },
- source: {
- type: String,
- default: ''
- }
- },
- data: () => ({
- drawer: null
- })
-}
-</script>
-
-<style type="text/css">
-@import url("https://fonts.googleapis.com/css?family=Roboto:300,400,500,700|Material+Icons");
-</style>
diff --git a/examples/storybook/components/LineChart.js b/examples/storybook/components/LineChart.js
deleted file mode 100644
index 85b9c0b349fd..000000000000
--- a/examples/storybook/components/LineChart.js
+++ /dev/null
@@ -1,9 +0,0 @@
-import { Line } from 'vue-chartjs'
-
-export default {
- extends: Line,
- props: ['data', 'options'],
- mounted () {
- this.renderChart(this.data, this.options)
- }
-}
diff --git a/examples/storybook/components/Logo.vue b/examples/storybook/components/Logo.vue
deleted file mode 100644
index a4f590a68862..000000000000
--- a/examples/storybook/components/Logo.vue
+++ /dev/null
@@ -1,79 +0,0 @@
-<template>
- <div class="VueToNuxtLogo">
- <div class="Triangle Triangle--two" />
- <div class="Triangle Triangle--one" />
- <div class="Triangle Triangle--three" />
- <div class="Triangle Triangle--four" />
- </div>
-</template>
-
-<style>
-.VueToNuxtLogo {
- display: inline-block;
- animation: turn 2s linear forwards 1s;
- transform: rotateX(180deg);
- position: relative;
- overflow: hidden;
- height: 180px;
- width: 245px;
-}
-
-.Triangle {
- position: absolute;
- top: 0;
- left: 0;
- width: 0;
- height: 0;
-}
-
-.Triangle--one {
- border-left: 105px solid transparent;
- border-right: 105px solid transparent;
- border-bottom: 180px solid #41B883;
-}
-
-.Triangle--two {
- top: 30px;
- left: 35px;
- animation: goright 0.5s linear forwards 3.5s;
- border-left: 87.5px solid transparent;
- border-right: 87.5px solid transparent;
- border-bottom: 150px solid #3B8070;
-}
-
-.Triangle--three {
- top: 60px;
- left: 35px;
- animation: goright 0.5s linear forwards 3.5s;
- border-left: 70px solid transparent;
- border-right: 70px solid transparent;
- border-bottom: 120px solid #35495E;
-}
-
-.Triangle--four {
- top: 120px;
- left: 70px;
- animation: godown 0.5s linear forwards 3s;
- border-left: 35px solid transparent;
- border-right: 35px solid transparent;
- border-bottom: 60px solid #fff;
-}
-
-@keyframes turn {
- 100% {
- transform: rotateX(0deg);
- }
-}
-
-@keyframes godown {
- 100% {
- top: 180px;
- }
-}
-
-@keyframes goright {
- 100% {
- left: 70px;
- }
-}
-</style>
diff --git a/examples/storybook/components/VuetifyLogo.vue b/examples/storybook/components/VuetifyLogo.vue
deleted file mode 100644
index 93c3d38f9882..000000000000
--- a/examples/storybook/components/VuetifyLogo.vue
+++ /dev/null
@@ -1,16 +0,0 @@
-<template>
- <img class="VuetifyLogo" alt="Vuetify Logo" src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAGQAAABkCAYAAABw4pVUAAANs0lEQVR4nO2deTxV6R/H77n75dpluRdXCyVKKEvLkFC2SDQkIoWaUCoqTPWrmVY7De0yNRVhmsyYGG00MxXR1CjVvCb9puE3o0VNiyy/81xzzFTCvfc597H0eb3OX67zfZ7v28fzfc75nnMpFCmJyTfi89dVnON/XFEG/VhXUabpfaBc0zuLrKOMKTAcJq1cSUcYRuGvrzqju/NJOxmHdnBJu3bId6QcmnOzL1CoNNQZhC856xDP/giEO2aWJ+rckSKqjCJLZ8e9u/0JCD/wy1sYg81AnTvSpOKTHNOfgChYLopAnTNSRdcYqaa78+kLqEDSm/DkwQeiFXyqkSanoYA6Z6RLPfyr7P4ARNk+dgvqXElFnLHOlngi2/o0kNDSZsYQPS3UuZKOMCrG//jy9/CAPIbuDjWP1GzUaZKqFKZH+kMDkgYdSCtn+BQz1DmSqvASmKOTWF/fF4FofLivBN8IYqhzJHWpeKdv6otAZA1dnVHnBomYAlMBXgI3Sw7kETQYvMD86xhTpu9dJxll7W4y1tHPgYxDWVtPlYijEVmUKzGQVHhA5C0CFxFjM/lghonNLD8H2Ie1u68tlUYX7V/iZP+YwLjy9nYyjpmx+3cQcWRM3GwkLoEhAeEHnaynchRkwLg4XAXOsRvNf+bfaW+HfcRllWSJ7BCOvDIz8mRDLRlA1px+/qe8mpY8iIMxOTTtzber+wIQJZuV64n5f7hs40dkwDh+q/XFUGOrESIDAZrkvzaALJdYL9wQQsRRdFoTKhmQh5IDCS5+Slfja4DxsGW4jL0/NtwgA0hURkGGWDCAGGxZetS3D0lxyfITv1VjVBoVxKFx1bmClMYHKIGoTN+wi5i3rddCNzJg5N1pf84bYagtNhCgKQFr/clyiaGdty0RRzVgT4LYQFIkBtLK1BwzGowDw6hYyqmac2QACY/PTpIIBhCTw8XXkvqfyQASkFGWR8RhDbcaiSf3lXhAHkgERN1rVyExDtOpLpZ48tpgwzh242WT9khjnsRAgCzmRPiR5JJmzZGmgo4oGIW3+nwhCiCyo52mEXON2//tETLcsXjzXnhXjhlsGTrukhoyoLh/fHArEYdr4e0obSC8+ccrKH+vZdr6Y4bm3W5rhg0j50bzQyV1vgo0IEDmXmG+ZACJLm5qkFVS44IY+B6Arr297qbIQJLFByJn6utHzHHptgMJZLgjYF36OqgwgIBLIgruXScDypSAmAVEHKVZm5aLDqRRLBhaC7++R5VVZoO4KjxdpSPXnz2EDePwT0//UFLjK0IHAmQ+J3wuGUAiCxsqQXUDYtAUNJUEO588kQYQRduVUcTcfCI/WUmGO/xWx0e9O6MSCq+4GMsK7l0jA4qBjcdkIo7a0oJM0oEsPtNEk1NTAvEYTDYju+rZXdgwPq9uui+vrCZHGhAgS58VPmQA8U87fZSIwTGYZownurXXQJJEB6JiF5tMxHMJjZlLhjvmRPwnnFQYQFQanYpXXPDXkrK2F5qjxnfsYvF/X7yY70t7D+RPEYGUNLO0zfRAKDqTRU0tqb0I3R1Xn9SxZBVYpAMBmuAV/iEZLpkZs28jEUNuauhssoCoeaTnEnEsXXyt80nYCHosiQ2WCgwgUHGF5dyphg0kuqTpPpuryAEx8BKYqZNY37suR9GAtLF1zK2EE8Ewyqc5F07AhrH3x/qbbBmudNxBaLxnxBwyXGIxJ2IeEUPZa+ta2EA0ArIuUFgdFd1Is8mj8+60v4INxDVolb9UYQCBK8ERBXXQXRKed/ci+MsFoqsO1RCkPnjWI5DEP3oNhGs4s7NxekVabgZsGJnn666xOLJoeoHxisuTDJeMtvWyJGJoLP+m5y7HXgLhBxbcwugsYbJUeTpD8m63/QUbyAy/MC8kMICodAaouK7CBuKbWtLZpMYZ42ih29Mt3l4CUTBf0Nk4HRiXHAcbxu4f6q/Q8JygofG3zNxDPWADiT3f8kxV16DjUjWVjvHjLnXf5Zj4v54vkyz6tpHGVRM2TsspqcpmX3l0HzKQNmuPYFekMIDoLA49LPeXSthQnKMyOy/IKThGd9/lmNAzEOVpazqvKrsELg+C7Y6U4tpy5O4gZDYLvktWFT24x5ZXYoLz4yUwS5DS2CA2kNDSlwyVYcLGaSqVRs288PtPsN1h5TLXHi2Ffwnfl1Aj8uugu8TKN8qbiKHinbBRXCBD3JM616QpHiFOsN2RUHj1NO6OvtV6au4VNgs2kCVf3CgnGsqYOuMEummPun7Qp3sgreyhE4WN0/i5KNtOVBbDdoels/cHaLPfhcA1roiCexWQobSNsHLs7ELXXHGq6y7H+IZ3bwR9skoof1/aH201zQRPYCtMIFvyLn6NYX1j6XhL+FriBtslcxOL9hPnlxk3s+sux26AyIx2diJ+P2ZfURZkd7SMnexgjibbvRCdyaZ9dLT2EkwgMWebnypr66uD82N0JlVr47W3uxzfAYQXkHcdY3Do4HeHGk3QPn6r9TlMIBuOlOf1WXcQMnMLcYXtEvuw+LXE+RVdYkLeBCKIr+8SiLzlws7G6cVb92+B7Q6DCdZj0GRZBIFFOKKg7jJMIKtL/6qjsbnCv3SavDpXkPaosScgWouK6qlsBeGVYzkVdW7OzVcPYAKJO3j6MNpMiyAzd/gumTgvuvOioOr8XYmvuWTH20AUrSPXE5/3WfFpOEwYebfbX44YZzUKSXLFEai48N37DzCBLDpQeQajdlRL7BGT9HX/1eUoeBNIcPFTxpARHY3TsnLM/Zf+uAUTSHTGl/vQZlgMmbgGOUN2SeuwCXbjhCfHF1Le2vLCf4D8/hoQVcdNnY3Tdt7Bs+G6o+2Ftr5Z/3szENi9L825DdUlvkmndhPn51r4OHUNpLSFxTM2BJ8BjkotqS2HCSQiJScNXVYllLFzoBNMIGtOP29S1TUQPg4HHvTRSbhfKwSy/R8g6p4ZnY3T4+3cJuZDvF+eW9vylK9n1H9fJgAqLtwl38OEYrt48wri/IpuG5a9CURm1Aw74ufrsopzYLojLD47AU0mIcrYaf4MPJFtsIBEnXr0C1NWTlgC01UEyoKUxseC7fc7NoL+ORUUrKNxWjDKfHj+nTZo98uP1rx4pKY9TB1tNiEI3FXEd+/lMF0y3uMjN+L8asGHMgggcibenY3T4Tuyk2C6I+STPZvQZJAEGTsHzIAJJGjPxVPEudn61mNxIK38oMI6KqejhWiIjp7K0Zrmx7Bg5NS2PlDhCZTRZRCycJdgS4/dgumSFu2xk4w6Tk7DNJeVlCpaL48m4s2LTYuG6Y7A2KRYZMkjS+NcAh1gusRrc95O4tyy42ZZ02RVhS3/TBkF5ufVTXWwYBz66VmDwhDewHuJGdgTLD788zlYQNaefflYkTdU6c04bsGr/WC6w3vl1hVdzWdAyMjexw5mxTU1eONr70NksNjUjPN1lbBgHKx8+F/FITwuqnyRLtCVEfr5tbOwgER+VX8T9BkT57d08p6WD3EjiLtjKcp8SUXg2XSYa4mx43zhHUEMwyhb8n4shOeOB7+yZOSYqPMlFS35ogaaS4KzrhTi6xPFYIK1EZ7IFlhAZi5ctaDnmQwQ4WuJLcS15NXQ8Xajoj7L3w0Lxq7y32rYXEXpPk6AUqDiCs6qKoXlkvnJRYfwREK7X+68INIXdY6kLoOps6fCcsnWS/DK3Mzzd6+yZLj0nmcwwAR27yHZV7+DAWQbRCBTPRfMQp0bZDK097aG4RJYQNJLb1+iMZh9vK+HROGlKrbkcI3ELoEEpG2K2zynnkc9wGVgM/sDPKmtkgDZfllyIPEnq85RabTB6w5CoGt80YGKYsRA2ia6+tr2PNpBolE2HpMlWUskBRJfeLUEw/rW0wTIFXKw+pS4QHZIBqTV1G72RNTz73OSxCWSANmSf/kk5b073hZ4PRO+ey+SMpAWw0nTTVHPvc9Kf7LrRHEqrngxgWw4dCYXG4hfhwdLwoprX8U3IgOpEM8d+iZWhqjn3OelN9HZUtS1JEEMIDEHSgbXN+iIL4yycO8lkVwiKpDjtS0v9U0njUQ9034jvUkulqKsJaICid5TtLvnUbxXp8D9kqC9F0/2FkiiCEDAc4Za+mMFqOfY76Q/ydW8ty4RBUhE4uFU1HPrtwrIKDvRKyCVvYNxrObFEw1dIzjvXx+MwteSXrkkqZdAwuIPbUM9p36vwMzyHl3SGyC4Ox6qC/TUUM+n32u4hcN4POktkgIJjE1aj3ouA0LgTQkBGeUF3QFJ7gEI7o5GBdVB8K3P0tIwcweT7taS5CvdA/GL3r4a9RwGnAIzyvPfBSSlGyDgVX4KKuryqMc/4IS7xPRda0l3QHxXbY1EPfYBK//0M7miAMHdUcdVVOGgHveA1XCL6eO6csm7gHhGbApFPeaBLQwDFddbLkmtehvGwSuP7zA5soPjcQKUGmZub/ymS7oC4hwYNR/1WAeHcJcE7b34mkvS3gCy58L9nzlyiu/dIS3hFRdwyat3AbH3CZ2DeoyDSuCJqYCMsmNdAfns7G9VTBbnfeeCtKVrajOGWEvSq15zhzvqsQ1a+aWWHvk3kPTTv/5Apb5vmEYmvOIyAmtJerUQSJuls/901GMa9MLXki92VgsfJzhDo9PfuwO1dM1sDXEgzeYOffD964NS+L7EJy5zUc8f7B/6P+/deFKc6+9QAAAAAElFTkSuQmCC">
-</template>
-
-<style>
-.VuetifyLogo {
- width: 180px;
- transform: rotateY(560deg);
- animation: turn 3.5s ease-out forwards 1s;
-}
-@keyframes turn {
- 100% {
- transform: rotateY(0deg);
- }
-}
-</style>
diff --git a/examples/storybook/components/Welcome.vue b/examples/storybook/components/Welcome.vue
deleted file mode 100644
index 1d4d67fcc9d2..000000000000
--- a/examples/storybook/components/Welcome.vue
+++ /dev/null
@@ -1,124 +0,0 @@
-<template>
- <v-app>
- <v-container fluid>
- <div class="main">
- <h1>Welcome to STORYBOOK</h1>
- <p>
- This is a UI component dev environment for your app.
- </p>
-
- <p>
- The repo for this project exists here
- <a
- class="link"
- href="https://github.com/white-rabbit-japan/vuetify-storyboard-boilerplate"
- target="_blank"
- rel="noopener noreferrer"
- >
- vuetify-storyboard-boilerplate
- </a>
- </p>
-
- <p>
- We've added some basic stories inside the
-
- <code class="code">
- src/stories
- </code>
- directory.
- A story is a single state of one or more UI components. You can have as many stories as you want.
- (Basically a story is like a visual test case.)
- </p>
- <p>
- See these sample
-
- <a class="link" role="button" tabIndex="0" @click.prevent="showApp">
- stories
- </a>
- for a component called
-
- <code class="code">
- Button
- </code> .
- </p>
- <p>
- Just like that, you can add your own components as stories.
- You can also edit those components and see changes right away.
- (Try editing the
- <code class="code">
- Button
- </code> component located at
- <code class="code">
- src/stories/Button.js
- </code>.)
- </p>
- <p>
- This is just one thing you can do with Storybook.
- Have a look at the
-
- <a class="link" href="https://github.com/storybooks/storybook" target="_blank" rel="noopener noreferrer">
- Storybook
- </a>
- repo for more information.
- </p>
- <p class="note">
- <b>NOTE:</b>
- Have a look at the
-
- <code class="code">
- .storybook/webpack.config.js
- </code>
- to add webpack loaders and plugins you are using in this project.
- </p>
- </div>
- </v-container>
- </v-app>
-</template>
-
-<script>
-export default {
- name: 'Welcome',
-
- props: {
- showApp: {
- type: Function,
- default: () => console.log('Welcome to storybook!') // eslint-disable-line
- }
- }
-}
-</script>
-
-<style>
-.main {
- margin: 15px;
- max-width: 600px;
- line-height: 1.4;
- font-family: "Helvetica Neue", Helvetica, "Segoe UI", Arial, freesans,
- sans-serif;
-}
-
-.logo {
- width: 200px;
-}
-
-.link {
- color: #1474f3;
- text-decoration: none;
- border-bottom: 1px solid #1474f3;
- padding-bottom: 2px;
-}
-
-.code {
- font-size: 15px;
- font-weight: 600;
- padding: 2px 5px;
- border: 1px solid #eae9e9;
- border-radius: 4px;
- background-color: #f3f2f2;
- color: #3a3a3a;
-}
-
-.note {
- opacity: 0.5;
-}
-</style>
diff --git a/examples/storybook/layouts/default.vue b/examples/storybook/layouts/default.vue
deleted file mode 100644
index e5d476fe9cf1..000000000000
--- a/examples/storybook/layouts/default.vue
+++ /dev/null
@@ -1,102 +0,0 @@
-<template>
- <v-app dark>
- <v-navigation-drawer
- v-model="drawer"
- :mini-variant="miniVariant"
- :clipped="clipped"
- fixed
- app
- >
- <v-list>
- <v-list-tile
- v-for="(item, i) in items"
- :key="i"
- :to="item.to"
- router
- exact
- >
- <v-list-tile-action>
- <v-icon>{{ item.icon }}</v-icon>
- </v-list-tile-action>
- <v-list-tile-content>
- <v-list-tile-title v-text="item.title" />
- </v-list-tile-content>
- </v-list-tile>
- </v-list>
- </v-navigation-drawer>
- <v-toolbar :clipped-left="clipped" fixed app>
- <v-toolbar-side-icon @click="drawer = !drawer" />
- <v-btn
- icon
- @click.stop="miniVariant = !miniVariant"
- >
- <v-icon>{{ miniVariant ? 'chevron_right' : 'chevron_left' }}</v-icon>
- </v-btn>
- <v-btn
- icon
- @click.stop="clipped = !clipped"
- >
- <v-icon>web</v-icon>
- </v-btn>
- <v-btn
- icon
- @click.stop="fixed = !fixed"
- >
- <v-icon>remove</v-icon>
- </v-btn>
- <v-toolbar-title v-text="title" />
- <v-spacer />
- <v-btn
- icon
- @click.stop="rightDrawer = !rightDrawer"
- >
- <v-icon>menu</v-icon>
- </v-btn>
- </v-toolbar>
- <v-content>
- <v-container>
- <nuxt />
- </v-container>
- </v-content>
- <v-navigation-drawer
- v-model="rightDrawer"
- :right="right"
- temporary
- fixed
- >
- <v-list>
- <v-list-tile @click.native="right = !right">
- <v-list-tile-action>
- <v-icon light>
- compare_arrows
- </v-icon>
- </v-list-tile-action>
- <v-list-tile-title>Switch drawer (click me)</v-list-tile-title>
- </v-list-tile>
- </v-list>
- </v-navigation-drawer>
- <v-footer :fixed="fixed" app>
- <span>© 2017</span>
- </v-footer>
- </v-app>
-</template>
-
-<script>
-export default {
- data () {
- return {
- clipped: false,
- drawer: true,
- fixed: false,
- items: [
- { icon: 'apps', title: 'Welcome', to: '/' },
- { icon: 'bubble_chart', title: 'Inspire', to: '/inspire' }
- ],
- miniVariant: false,
- right: true,
- rightDrawer: false,
- title: 'Vuetify.js'
- }
- }
-}
-</script>
diff --git a/examples/storybook/nuxt.config.js b/examples/storybook/nuxt.config.js
deleted file mode 100644
index 24a6bfbb0303..000000000000
--- a/examples/storybook/nuxt.config.js
+++ /dev/null
@@ -1,40 +0,0 @@
-const pkg = require('./package')
-
-module.exports = {
- mode: 'universal',
-
- /*
- ** Headers of the page
- */
- head: {
- title: pkg.name,
- meta: [
- { charset: 'utf-8' },
- { name: 'viewport', content: 'width=device-width, initial-scale=1' },
- { hid: 'description', name: 'description', content: pkg.description }
- ],
- link: [
- { rel: 'icon', type: 'image/x-icon', href: '/favicon.ico' },
- { rel: 'stylesheet', href: 'https://fonts.googleapis.com/css?family=Roboto:300,400,500,700|Material+Icons' }
- ]
- },
-
- /*
- ** Customize the progress-bar color
- */
- loading: { color: '#3B8070' },
-
- /*
- ** Global CSS
- */
- css: [
- 'vuetify/src/stylus/main.styl'
- ],
-
- /*
- ** Plugins to load before mounting the App
- */
- plugins: [
- '@/plugins/vuetify'
- ]
-}
diff --git a/examples/storybook/package.json b/examples/storybook/package.json
deleted file mode 100644
index a4823c239d18..000000000000
--- a/examples/storybook/package.json
+++ /dev/null
@@ -1,35 +0,0 @@
-{
- "name": "example-storybook",
- "version": "1.0.0",
- "description": "sample storybook setup for nuxt",
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "generate": "nuxt generate",
- "precommit": "yarn run lint",
- "storybook": "start-storybook -p 9001 -c .storybook",
- "storybookoutput": "build-storybook -c .storybook -o .out",
- "post-update": "yarn upgrade --latest"
- },
- "dependencies": {
- "chart.js": "^2.7.1",
- "nuxt": "latest",
- "vue-chartjs": "^3.1.1",
- "vuetify": "1.2.6"
- },
- "devDependencies": {
- "@storybook/addon-actions": "^4.0.0-alpha.24",
- "@storybook/addon-centered": "^4.0.0-alpha.24",
- "@storybook/addon-knobs": "^4.0.0-alpha.24",
- "@storybook/addon-links": "^4.0.0-alpha.24",
- "@storybook/addon-notes": "^4.0.0-alpha.24",
- "@storybook/addon-storyshots": "^4.0.0-alpha.24",
- "@storybook/addon-viewport": "^4.0.0-alpha.24",
- "@storybook/addons": "^4.0.0-alpha.24",
- "@storybook/vue": "^4.0.0-alpha.24",
- "babel-preset-vue": "^2.0.2",
- "stylus": "^0.54.5",
- "stylus-loader": "^3.0.1"
- }
-}
diff --git a/examples/storybook/pages/index.vue b/examples/storybook/pages/index.vue
deleted file mode 100644
index 6ab62e09aa6d..000000000000
--- a/examples/storybook/pages/index.vue
+++ /dev/null
@@ -1,63 +0,0 @@
-<template>
- <v-layout column justify-center align-center>
- <v-flex xs12 sm8 md6>
- <div class="text-xs-center">
- <logo />
- <vuetify-logo />
- </div>
- <v-card>
- <v-card-title class="headline">
- Welcome to the Vuetify + Nuxt.js template
- </v-card-title>
- <v-card-text>
- <p>Vuetify is a progressive Material Design component framework for Vue.js. It was designed to empower developers to create amazing applications.</p>
- <p>
- For more information on Vuetify, check out the <a href="https://vuetifyjs.com" target="_blank">
- documentation
- </a>.
- </p>
- <p>
- If you have questions, please join the official <a href="https://chat.vuetifyjs.com/" target="_blank" title="chat">
- discord
- </a>.
- </p>
- <p>
- Find a bug? Report it on the github <a href="https://github.com/vuetifyjs/vuetify/issues" target="_blank" title="contribute">
- issue board
- </a>.
- </p>
- <p>Thank you for developing with Vuetify and I look forward to bringing more exciting features in the future.</p>
- <div class="text-xs-right">
- <em><small>— John Leider</small></em>
- </div>
- <hr class="my-3">
- <a href="https://nuxtjs.org/" target="_blank">
- Nuxt Documentation
- </a>
- <br>
- <a href="https://github.com/nuxt/nuxt.js" target="_blank">
- Nuxt GitHub
- </a>
- </v-card-text>
- <v-card-actions>
- <v-spacer />
- <v-btn color="primary" flat nuxt to="/inspire">
- Continue
- </v-btn>
- </v-card-actions>
- </v-card>
- </v-flex>
- </v-layout>
-</template>
-
-<script>
-import Logo from '~/components/Logo.vue'
-import VuetifyLogo from '~/components/VuetifyLogo.vue'
-
-export default {
- components: {
- Logo,
- VuetifyLogo
- }
-}
-</script>
diff --git a/examples/storybook/pages/inspire.vue b/examples/storybook/pages/inspire.vue
deleted file mode 100644
index fd6b51676c85..000000000000
--- a/examples/storybook/pages/inspire.vue
+++ /dev/null
@@ -1,15 +0,0 @@
-<template>
- <v-layout>
- <v-flex text-xs-center>
- <img src="/v.png" alt="Vuetify.js" class="mb-5">
- <blockquote class="blockquote">
- “First, solve the problem. Then, write the code.”
- <footer>
- <small>
- <em>—John Johnson</em>
- </small>
- </footer>
- </blockquote>
- </v-flex>
- </v-layout>
-</template>
diff --git a/examples/storybook/plugins/vuetify.js b/examples/storybook/plugins/vuetify.js
deleted file mode 100644
index b2a8935e8c92..000000000000
--- a/examples/storybook/plugins/vuetify.js
+++ /dev/null
@@ -1,15 +0,0 @@
-import Vue from 'vue'
-import Vuetify from 'vuetify'
-import colors from 'vuetify/es5/util/colors'
-
-Vue.use(Vuetify, {
- theme: {
- primary: '#121212', // a color that is not in the material colors palette
- accent: colors.grey.darken3,
- secondary: colors.amber.darken3,
- info: colors.teal.lighten1,
- warning: colors.amber.base,
- error: colors.deepOrange.accent4,
- success: colors.green.accent3
- }
-})
diff --git a/examples/storybook/static/favicon.ico b/examples/storybook/static/favicon.ico
deleted file mode 100644
index 382fecbbf96d..000000000000
Binary files a/examples/storybook/static/favicon.ico and /dev/null differ
diff --git a/examples/storybook/static/v.png b/examples/storybook/static/v.png
deleted file mode 100644
index a2ce2353f273..000000000000
Binary files a/examples/storybook/static/v.png and /dev/null differ
diff --git a/examples/storybook/store/README.md b/examples/storybook/store/README.md
deleted file mode 100644
index 111fea1b3348..000000000000
--- a/examples/storybook/store/README.md
+++ /dev/null
@@ -1,10 +0,0 @@
-# STORE
-
-**This directory is not required, you can delete it if you don't want to use it.**
-
-This directory contains your Vuex Store files.
-Vuex Store option is implemented in the Nuxt.js framework.
-
-Creating a file in this directory activate the option in the framework automatically.
-
-More information about the usage of this directory in [the documentation](https://nuxtjs.org/guide/vuex-store).
diff --git a/examples/storybook/stories/LineChart.story.js b/examples/storybook/stories/LineChart.story.js
deleted file mode 100644
index b8cc3413439c..000000000000
--- a/examples/storybook/stories/LineChart.story.js
+++ /dev/null
@@ -1,92 +0,0 @@
-import {
- nStoriesOfWithDefault,
- action,
- boolean,
- text,
- color,
- array
-} from './storybase.js'
-
-import LineChart from '~/components/LineChart'
-
-nStoriesOfWithDefault({ LineChart })
- .add('with some data', () => ({
- components: { LineChart },
- template: `
-<div>
- <line-chart :data="{
- labels: [1,2,3],
- datasets: [
- {
- label: 'Sample',
- backgroundColor: 'green',
- data: ['1','2','3']
- }
- ]
- }" :options="{ maintainAspectRatio: false, responsive:true}"/>
-</div>`
- }))
- .add('with knobs demo', () => {
- const maintainAspectRatio = boolean('Aspect Ratio', false)
- const responsive = boolean('Responsive', true)
- const title = text('Title', 'Sample chart')
- const myColor = color('Background Color', 'darkred')
-
- const defaultValue = array('Values', [1, 2, 3, 6, 3, 8])
- const defaultLabel = array('Labels', [
- "'a'",
- "'b'",
- "'c'",
- "'d'",
- "'e'",
- "'f'"
- ])
-
- return {
- components: { LineChart },
- methods: { onResize: action('resized') },
- template: `
- <div style="position: relative; height:40vh; width:80vw">
- <line-chart :data="{
- labels: [${defaultLabel}],
- datasets: [
- {
- label: '${title}',
- backgroundColor: '${myColor}',
- data: [${defaultValue}]
- }
- ]
- }" :options="{ maintainAspectRatio: ${maintainAspectRatio}, responsive:${responsive}, onResize }"/>
- </div>
- `
- }
- })
- .addVT('with Vuetify', () => {
- const data = { "'a'": 1, "'b'": 2, "'c'": 3 }
- return `
- <line-chart :data="{
- labels: [${Object.keys(data)}],
- datasets: [
- {
- label: 'list 1',
- backgroundColor: '#41b883',
- data: [${Object.values(data)}]
- }
- ]
- }" :options="{ maintainAspectRatio: false, responsive:true}"/>
- `
- })
- .addVT(
- 'with Vuetify2',
- `<line-chart :data="{
- labels: [1,2,3],
- datasets: [
- {
- label: 'list 2',
- backgroundColor: '#41b883',
- data: ['1','2','3']
- }
- ]
- }" :options="{ maintainAspectRatio: false, responsive:true}"/>
- `
- )
diff --git a/examples/storybook/stories/Logo.story.js b/examples/storybook/stories/Logo.story.js
deleted file mode 100644
index 60d0212fb7d1..000000000000
--- a/examples/storybook/stories/Logo.story.js
+++ /dev/null
@@ -1,45 +0,0 @@
-import {
- nStoriesOf,
- // action,
- // boolean,
- // text,
- // color,
- // array,
- object
-} from './storybase.js'
-
-import Logo from '~/components/Logo.vue'
-
-// nStoriesOf({ Logo }, "Logo 1")
-// .addDecorator(story => (
-// <div style={{textAlign: 'center'}}>
-// {story()}
-// </div>
-// ))
-// .add("with some data", () => ({
-// components: { Logo },
-// template: `
-// <logo :data="{ } "/>`
-// }))
-
-nStoriesOf({ Logo }, 'Logo ')
- .add('with some data', () => ({
- components: { Logo },
- template: `
- <v-app dark style="min-width:400px">
- <v-container fill-height>
- <v-flex xs12>
- <logo :data="{ } "/>
- </v-flex>
- </v-container></v-app>`
- }))
- .addVT('with App layout', '<logo :data="{ } "/>')
- .addVT('with a knob', () => {
- const data = JSON.stringify(
- object('Data', {
- name: 'Apple',
- count: 132
- })
- )
- return `<logo :data='${data}' />`
- })
diff --git a/examples/storybook/stories/MyButton.story.js b/examples/storybook/stories/MyButton.story.js
deleted file mode 100644
index 70c8a892a57e..000000000000
--- a/examples/storybook/stories/MyButton.story.js
+++ /dev/null
@@ -1,14 +0,0 @@
-
-import { storiesOf } from '@storybook/vue'
-import Centered from '@storybook/addon-centered'
-import MyButton from '~/components/Button.vue'
-
-storiesOf('Button', module)
- .addDecorator(Centered)
- .add('rounded button', () => ({
- template: '<my-button :rounded="true"> 👍 A Button with rounded edges</my-button>'
- }))
- .add('normal button', () => ({
- components: { MyButton },
- template: '<my-button :rounded="false">A Button with square edges</my-button>'
- }))
diff --git a/examples/storybook/stories/Welcome.story.js b/examples/storybook/stories/Welcome.story.js
deleted file mode 100644
index abc02b7142d5..000000000000
--- a/examples/storybook/stories/Welcome.story.js
+++ /dev/null
@@ -1,14 +0,0 @@
-
-import { storiesOf } from '@storybook/vue'
-import { linkTo } from '@storybook/addon-links'
-
-import Welcome from '~/components/Welcome.vue'
-
-storiesOf('Welcome', module).add('to Storybook', () => ({
- render: h => h(Welcome)
-}))
- .add('with Link To Button', () => ({
- components: { Welcome },
- template: '<div align=center><welcome :showApp="action" /></div>',
- methods: { action: linkTo('Button') }
- }))
diff --git a/examples/storybook/stories/collection.story.js b/examples/storybook/stories/collection.story.js
deleted file mode 100644
index bccd39c30c56..000000000000
--- a/examples/storybook/stories/collection.story.js
+++ /dev/null
@@ -1,227 +0,0 @@
-import Vuex from 'vuex'
-import { storiesOf } from '@storybook/vue'
-import { action } from '@storybook/addon-actions'
-import { linkTo } from '@storybook/addon-links'
-import { withNotes } from '@storybook/addon-notes'
-import {
- withKnobs,
- text,
- number,
- boolean,
- array,
- select,
- color,
- date,
- button
-} from '@storybook/addon-knobs/vue'
-import MyButton from '~/components/Button.vue'
-
-storiesOf('Features/Method for rendering Vue', module)
- .add('render', () => ({
- render: h => h('div', ['renders a div with some text in it..'])
- }))
- .add('render + component', () => ({
- render (h) {
- return h(MyButton, { props: { color: 'pink' } }, ['renders component: MyButton'])
- }
- }))
- .add('template', () => ({
- template: `
- <div>
- <h1>A template</h1>
- <p>rendered in vue in storybook</p>
- </div>`
- }))
- .add('template + component', () => ({
- components: { MyButton },
- template: '<my-button>MyButton rendered in a template</my-button>'
- }))
- .add('template + methods', () => ({
- components: { MyButton },
- template: `
- <p>
- <em>Clicking the button will navigate to another story using the 'addon-links'</em><br/>
- <my-button :rounded="true" :handle-click="action">MyButton rendered in a template + props & methods</my-button>
- </p>`,
- methods: {
- action: linkTo('Button')
- }
- }))
- .add('JSX', () => ({
- components: { MyButton },
- render () {
- return <my-button>MyButton rendered with JSX</my-button>
- }
- }))
- .add('vuex + actions', () => ({
- components: { MyButton },
- template: '<my-button :handle-click="log">with vuex: {{ $store.state.count }}</my-button>',
- store: new Vuex.Store({
- state: { count: 0 },
- mutations: {
- increment (state) {
- state.count += 1; // eslint-disable-line
- action('vuex state')(state)
- }
- }
- }),
- methods: {
- log () {
- this.$store.commit('increment')
- }
- }
- }))
- .add('whatever you want', () => ({
- components: { MyButton },
- template:
- '<my-button :handle-click="log">with awesomeness: {{ $store.state.count }}</my-button>',
- store: new Vuex.Store({
- state: { count: 0 },
- mutations: {
- increment (state) {
- state.count += 1; // eslint-disable-line
- action('vuex state')(state)
- }
- }
- }),
- methods: {
- log () {
- this.$store.commit('increment')
- }
- }
- }))
- .add('pre-registered component', () => ({
- /* By pre-registering component in config.js,
- * the need to register all components with each story is removed.
- * You'll only need the template */
- template: `
- <p>
- <em>This component was pre-registered in .storybook/config.js</em><br/>
- <my-button>MyButton rendered in a template</my-button>
- </p>`
- }))
-
-storiesOf('Features/Decorator for Vue', module)
- .addDecorator((story) => {
- // Decorated with story function
- const WrapButton = story()
- return {
- components: { WrapButton },
- template: '<div :style="{ border: borderStyle }"><wrap-button/></div>',
- data () {
- return { borderStyle: 'medium solid red' }
- }
- }
- })
- .addDecorator(() => ({
- // Decorated with `story` component
- template: '<div :style="{ border: borderStyle }"><story/></div>',
- data () {
- return {
- borderStyle: 'medium solid blue'
- }
- }
- }))
- .add('template', () => ({
- template: '<my-button>MyButton with template</my-button>'
- }))
- .add('render', () => ({
- render (h) {
- return h(MyButton, { props: { color: 'pink' } }, ['renders component: MyButton'])
- }
- }))
-
-storiesOf('Features/Addon Actions', module)
- .add('Action only', () => ({
- template: '<my-button :handle-click="log">Click me to log the action</my-button>',
- methods: {
- log: action('log1')
- }
- }))
- .add('Action and method', () => ({
- template: '<my-button :handle-click="log">Click me to log the action</my-button>',
- methods: {
- log: (e) => {
- e.preventDefault()
- action('log2')(e.target)
- }
- }
- }))
-
-storiesOf('Features/Addon Notes', module)
- .add(
- 'Simple note',
- withNotes({ text: 'My notes on some bold text' })(() => ({
- template:
- '<p><strong>Etiam vulputate elit eu venenatis eleifend. Duis nec lectus augue. Morbi egestas diam sed vulputate mollis. Fusce egestas pretium vehicula. Integer sed neque diam. Donec consectetur velit vitae enim varius, ut placerat arcu imperdiet. Praesent sed faucibus arcu. Nullam sit amet nibh a enim eleifend rhoncus. Donec pretium elementum leo at fermentum. Nulla sollicitudin, mauris quis semper tempus, sem metus tristique diam, efficitur pulvinar mi urna id urna.</strong></p>'
- }))
- )
- .add(
- 'Note with HTML',
- withNotes({
- text: `
- <h2>My notes on emojies</h2>
-
- <em>It's not all that important to be honest, but..</em>
-
- Emojis are great, I love emojis, in fact I like using them in my Component notes too! 😇
- `
- })(() => ({
- template: '<p>🤔😳😯😮<br/>😄😩😓😱<br/>🤓😑😶😊</p>'
- }))
- )
-
-storiesOf('Features/ Addon Knobs', module)
- .addDecorator(withKnobs)
- .add('Simple', () => {
- const name = text('Name', 'John Doe')
- const age = number('Age', 44)
- const content = `I am ${name} and I'm ${age} years old.`
-
- return {
- template: `<div>${content}</div>`
- }
- })
- .add('All knobs', () => {
- const name = text('Name', 'Jane')
- const stock = number('Stock', 20, {
- range: true,
- min: 0,
- max: 30,
- step: 5
- })
- const fruits = {
- apples: 'Apple',
- bananas: 'Banana',
- cherries: 'Cherry'
- }
- const fruit = select('Fruit', fruits, 'apple')
- const price = number('Price', 2.25)
-
- const colour = color('Border', 'deeppink')
- const today = date('Today', new Date('Jan 20 2017'))
- const items = array('Items', ['Laptop', 'Book', 'Whiskey'])
- const nice = boolean('Nice', true)
-
- const stockMessage = stock
- ? `I have a stock of ${stock} ${fruit}, costing $${price} each.`
- : `I'm out of ${fruit}${nice ? ', Sorry!' : '.'}`
- const salutation = nice ? 'Nice to meet you!' : 'Leave me alone!'
-
- button('Arbitrary action', action('You clicked it!'))
-
- return {
- template: `
- <div style="border:2px dotted ${colour}; padding: 8px 22px; border-radius: 8px">
- <h1>My name is ${name},</h1>
- <h3>today is ${new Date(today).toLocaleDateString()}</h3>
- <p>${stockMessage}</p>
- <p>Also, I have:</p>
- <ul>
- ${items.map(item => `<li key=${item}>${item}</li>`).join('')}
- </ul>
- <p>${salutation}</p>
- </div>
- `
- }
- })
diff --git a/examples/storybook/stories/storybase.js b/examples/storybook/stories/storybase.js
deleted file mode 100644
index ba2b93a3f268..000000000000
--- a/examples/storybook/stories/storybase.js
+++ /dev/null
@@ -1,82 +0,0 @@
-import { storiesOf } from '@storybook/vue'
-import { action } from '@storybook/addon-actions'
-import {
- withKnobs,
- text,
- number,
- boolean,
- array,
- select,
- color,
- date,
- object,
- button
-} from '@storybook/addon-knobs/vue'
-import centered from '@storybook/addon-centered'
-import { linkTo } from '@storybook/addon-links'
-
-/**
- * Template function for Vuetify
- * @param {*} cmp component inside object {cmp}
- * @param {*} cmpStr template string or function returning on
- */
-const vtmp = (cmp, cmpStr) => ({
- components: cmp,
- template: `
- <v-app style="min-width:400px">
- <v-container fluid fill-height>
- <v-flex xs12>${cmpStr instanceof Function ? cmpStr() : cmpStr}</v-flex>
- </v-container>
- </v-app>
- `
-})
-/**
- * Richer aLternative to storiesOf
- * @param {*} cmp
- * @param {*} name
- * @param {*} params
- */
-const nStoriesOf = (cmp, name = Object.keys(cmp)[0], params = {}) => {
- const x = storiesOf(name, module)
- .addDecorator(centered)
- .addDecorator(withKnobs)
-
- if (params.withDefault) {
- x.add('Default', () => ({
- render: h => h(Object.values(cmp)[0])
- }))
- }
-
- x.addVT = (title, cmpStr) => {
- x.add(title, () => vtmp(cmp, cmpStr))
- return x
- }
-
- return x
-}
-
-/**
- * Stories of which just works
- * @param {*} cmp
- * @param {*} name
- */
-const nStoriesOfWithDefault = (cmp, name = Object.keys(cmp)[0]) =>
- nStoriesOf(cmp, name, { withDefault: 'withDefault' })
-
-export {
- nStoriesOf,
- nStoriesOfWithDefault,
- action,
- linkTo,
- withKnobs,
- text,
- number,
- object,
- boolean,
- array,
- select,
- color,
- date,
- button,
- vtmp
-}
diff --git a/examples/storybook/stories/vuetify.story.js b/examples/storybook/stories/vuetify.story.js
deleted file mode 100644
index 1e8ab1b8c68a..000000000000
--- a/examples/storybook/stories/vuetify.story.js
+++ /dev/null
@@ -1,110 +0,0 @@
-import { storiesOf } from '@storybook/vue'
-
-import Centered from '@storybook/addon-centered'
-import VuetifyLogo from '~/components/VuetifyLogo.vue'
-
-storiesOf('Vuetify/Logo', module)
- .addDecorator(Centered)
- .add('Logo', () => ({
- render: h => h(VuetifyLogo)
- }))
-
-const menuItems = [
- {
- action: 'local_activity',
- title: 'Attractions',
- items: [{ title: 'List Item' }]
- },
- {
- action: 'restaurant',
- title: 'Dining',
- active: true,
- items: [
- { title: 'Breakfast & brunch' },
- { title: 'New American' },
- { title: 'Sushi' }
- ]
- },
- {
- action: 'school',
- title: 'Education',
- items: [{ title: 'List Item' }]
- },
- {
- action: 'directions_run',
- title: 'Family',
- items: [{ title: 'List Item' }]
- },
- {
- action: 'healing',
- title: 'Health',
- items: [{ title: 'List Item' }]
- },
- {
- action: 'content_cut',
- title: 'Office',
- items: [{ title: 'List Item' }]
- },
- {
- action: 'local_offer',
- title: 'Promotions',
- items: [{ title: 'List Item' }]
- }
-]
-
-const menuItemsAlt = [
- {
- action: 'inbox',
- title: 'Mailbox'
- },
- {
- action: 'note',
- title: 'My Address'
- },
- {
- action: 'assignment',
- title: 'In Progress',
- active: true,
- items: [
- { title: 'Consolidation' },
- { title: 'Repacking' },
- { title: 'Shipping' }
- ]
- },
- {
- action: 'playlist_add_check',
- title: 'Registration'
- },
- {
- action: 'account_circle',
- title: 'Account'
- },
- {
- action: 'view_headline',
- title: 'Shipped'
- }
-]
-
-storiesOf('Vuetify/V-Btn', module)
- .add('Square Button', () => ({
- components: {},
- data () {
- return {
- items: menuItems
- }
- },
- template:
- '<v-btn color="success">Success</v-btn>'
- }))
- .add('with rounded button', () => ({
- components: {},
- data () {
- return {
- items: menuItemsAlt
- }
- },
- template:
- `<v-btn color="warning" large round dark>
-Rounded button
- </v-btn>`
- }))
diff --git a/examples/style-resources/README.md b/examples/style-resources/README.md
deleted file mode 100644
index eef7d89305de..000000000000
--- a/examples/style-resources/README.md
+++ /dev/null
@@ -1,56 +0,0 @@
-# Using build.styleResources with Nuxt.js
-
-This is useful when you need to inject some variables and mixins in your pages without having to import them every time.
-
-Nuxt.js uses https://github.com/yenshih/style-resources-loader to achieve this behaviour.
-
-You need to specify the patterns/path you want to include for the given pre-processors: `css`, `less`, `sass`, `scss` or `stylus`
-
-:warning: You cannot use path aliases here (`~` and `@`), you need to use relative or absolute paths.
-
-`nuxt.config.js`:
-
-```js
-{
- build: {
- styleResources: {
- scss: './assets/variables.scss',
- less: './assets/*.less',
- // sass: ...,
- // scss: ...
- options: {
- // See https://github.com/yenshih/style-resources-loader#options
- // Except `patterns` property
- }
- }
- }
-}
-```
-
-:warning: If you want to use `@import` in these `styleResources` files, you should use path alias (`~@`) like this
-
-```scss
-@import '~@/assets/other.scss';
-```
-
-Then in your pages, you can use directly:
-
-`pages/index.vue`
-
-```vue
-<template>
- <div class="main">
- <p>Page with SCSS</p>
- <p><NuxtLink to="/less">LESS</NuxtLink></p>
- </div>
-</template>
-
-<style lang="scss">
-/* ~/assets/variables.scss is injected automatically here */
-.main {
- background: $main;
-}
-</style>
-```
-
-Thanks to [0pt1m1z3r](https://github.com/0pt1m1z3r) for adding this feature and example.
diff --git a/examples/style-resources/assets/resources.less b/examples/style-resources/assets/resources.less
deleted file mode 100644
index d032b2fc9ad1..000000000000
--- a/examples/style-resources/assets/resources.less
+++ /dev/null
@@ -1 +0,0 @@
-@main: orange;
diff --git a/examples/style-resources/assets/variables.scss b/examples/style-resources/assets/variables.scss
deleted file mode 100644
index 81a376da5c44..000000000000
--- a/examples/style-resources/assets/variables.scss
+++ /dev/null
@@ -1 +0,0 @@
-$main: #ccc;
diff --git a/examples/style-resources/nuxt.config.js b/examples/style-resources/nuxt.config.js
deleted file mode 100644
index c3eb94b56905..000000000000
--- a/examples/style-resources/nuxt.config.js
+++ /dev/null
@@ -1,9 +0,0 @@
-export default {
- build: {
- // You cannot use ~/ or @/ here since it's a Webpack plugin
- styleResources: {
- scss: './assets/variables.scss',
- less: './assets/*.less'
- }
- }
-}
diff --git a/examples/style-resources/package.json b/examples/style-resources/package.json
deleted file mode 100644
index d33729f74861..000000000000
--- a/examples/style-resources/package.json
+++ /dev/null
@@ -1,18 +0,0 @@
-{
- "name": "example-style-resources",
- "dependencies": {
- "less": "^2.7.3",
- "less-loader": "^4.0.5",
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- },
- "devDependencies": {
- "node-sass": "^4.7.2",
- "sass-loader": "^6.0.6"
- }
-}
diff --git a/examples/style-resources/pages/index.vue b/examples/style-resources/pages/index.vue
deleted file mode 100755
index f0b7b46d8ecd..000000000000
--- a/examples/style-resources/pages/index.vue
+++ /dev/null
@@ -1,18 +0,0 @@
-<template>
- <div class="main">
- <p>Page with SCSS</p>
- <p>
- <NuxtLink to="/less">
- LESS
- </NuxtLink>
- </p>
- </div>
-</template>
-
-<style lang="scss" scoped>
-/* ~/assets/variables.scss is injected automatically here */
-.main {
- background: $main;
- padding: 10px;
-}
-</style>
diff --git a/examples/style-resources/pages/less.vue b/examples/style-resources/pages/less.vue
deleted file mode 100644
index 0be9c148dc7b..000000000000
--- a/examples/style-resources/pages/less.vue
+++ /dev/null
@@ -1,21 +0,0 @@
-<template>
- <div class="main">
- <p>Page with LESS</p>
- <p>
- <NuxtLink to="/">
- SCSS
- </NuxtLink>
- </p>
- </div>
-</template>
-
-<style lang="less" scoped>
-/* ~/assets/*.less are injected automatically here */
-.main {
- background: @main;
- padding: 10px;
-}
-a {
- color: white;
-}
-</style>
diff --git a/examples/styled-vue/README.md b/examples/styled-vue/README.md
deleted file mode 100644
index ccf5af99d184..000000000000
--- a/examples/styled-vue/README.md
+++ /dev/null
@@ -1,5 +0,0 @@
-# Nuxt with [styled-vue](https://github.com/egoist/styled-vue)
-
-> *styled-vue* allows to use dynamic styles in Vue single-file components.
-
-See https://github.com/egoist/styled-vue
diff --git a/examples/styled-vue/nuxt.config.js b/examples/styled-vue/nuxt.config.js
deleted file mode 100644
index 9c00c590494a..000000000000
--- a/examples/styled-vue/nuxt.config.js
+++ /dev/null
@@ -1,5 +0,0 @@
-module.exports = {
- modules: [
- 'styled-vue/nuxt'
- ]
-}
diff --git a/examples/styled-vue/package.json b/examples/styled-vue/package.json
deleted file mode 100644
index 927759939900..000000000000
--- a/examples/styled-vue/package.json
+++ /dev/null
@@ -1,16 +0,0 @@
-{
- "name": "example-styled-vue",
- "version": "1.0.0",
- "dependencies": {
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- },
- "devDependencies": {
- "styled-vue": "^0.1.3"
- }
-}
diff --git a/examples/styled-vue/pages/index.vue b/examples/styled-vue/pages/index.vue
deleted file mode 100644
index 167e61d473e1..000000000000
--- a/examples/styled-vue/pages/index.vue
+++ /dev/null
@@ -1,35 +0,0 @@
-<template>
- <div>
- <h1>styled-vue</h1>
- <a href="https://github.com/egoist/styled-vue" class="github">
- Check it out on GitHub.
- </a>
- </div>
-</template>
-
-<script>
-import { css } from 'styled-vue'
-
-export default {
- style: css`
- h1 {
- color: red;
- font-size: ${vm => vm.fontSize}px;
- }
- .github {
- color: blue;
- animation: blink 1s linear infinite;
- }
- @keyframes blink {
- 50% {
- opacity: 0;
- }
- }
- `,
- data () {
- return {
- fontSize: 60
- }
- }
-}
-</script>
diff --git a/examples/tailwindcss-purgecss/.github/demo.png b/examples/tailwindcss-purgecss/.github/demo.png
deleted file mode 100644
index afe67d82b67e..000000000000
Binary files a/examples/tailwindcss-purgecss/.github/demo.png and /dev/null differ
diff --git a/examples/tailwindcss-purgecss/.github/pagespeed-desktop.png b/examples/tailwindcss-purgecss/.github/pagespeed-desktop.png
deleted file mode 100644
index d47820174bbb..000000000000
Binary files a/examples/tailwindcss-purgecss/.github/pagespeed-desktop.png and /dev/null differ
diff --git a/examples/tailwindcss-purgecss/.github/pagespeed-mobile.png b/examples/tailwindcss-purgecss/.github/pagespeed-mobile.png
deleted file mode 100644
index a2ae489e148c..000000000000
Binary files a/examples/tailwindcss-purgecss/.github/pagespeed-mobile.png and /dev/null differ
diff --git a/examples/tailwindcss-purgecss/.github/tailwind-default.png b/examples/tailwindcss-purgecss/.github/tailwind-default.png
deleted file mode 100644
index 4312e1824b19..000000000000
Binary files a/examples/tailwindcss-purgecss/.github/tailwind-default.png and /dev/null differ
diff --git a/examples/tailwindcss-purgecss/.github/tailwind-purgecss.png b/examples/tailwindcss-purgecss/.github/tailwind-purgecss.png
deleted file mode 100644
index 1d7a6d7db048..000000000000
Binary files a/examples/tailwindcss-purgecss/.github/tailwind-purgecss.png and /dev/null differ
diff --git a/examples/tailwindcss-purgecss/.gitignore b/examples/tailwindcss-purgecss/.gitignore
deleted file mode 100644
index a81eaca249e0..000000000000
--- a/examples/tailwindcss-purgecss/.gitignore
+++ /dev/null
@@ -1,5 +0,0 @@
-node_modules
-.nuxt
-dist
-*.log
-.DS_Store
\ No newline at end of file
diff --git a/examples/tailwindcss-purgecss/README.md b/examples/tailwindcss-purgecss/README.md
deleted file mode 100644
index 068dd85ce905..000000000000
--- a/examples/tailwindcss-purgecss/README.md
+++ /dev/null
@@ -1,27 +0,0 @@
-# Nuxt Tailwind CSS + Purgecss
-
-> Demo of using Nuxt with Tailwind CSS and Purgecss to drastically reduce CSS size.
-
-## Demo
-
-[https://nuxt-tailwindcss-purgecss.surge.sh/](https://nuxt-tailwindcss-purgecss.surge.sh/)
-
-
-
-### Before and after stats
-
-The before CSS bundle came out to `299kb`, where as after running it through Purgecss, it dropped to `3kb` (granted I'm only using around a dozen classes).
-
-
-
-
-### Performance
-
-And since the CSS remains inline (due to using Purgecss as a postcss plugin) it scores perfect on Google Page Speed Insights! (This is after running `nuxt generate` and deploying the `dist` folder)
-
-
-
-
-### Other
-
-See also this [demo](https://github.com/nuxt/nuxt.js/tree/dev/examples/with-purgecss)
diff --git a/examples/tailwindcss-purgecss/assets/css/tailwind.css b/examples/tailwindcss-purgecss/assets/css/tailwind.css
deleted file mode 100644
index 69d4ab0237e5..000000000000
--- a/examples/tailwindcss-purgecss/assets/css/tailwind.css
+++ /dev/null
@@ -1,63 +0,0 @@
-/**
- * This injects Tailwind's base styles, which is a combination of
- * Normalize.css and some additional base styles.
- *
- * You can see the styles here:
- * https://github.com/tailwindcss/tailwindcss/blob/master/css/preflight.css
- *
- * If using `postcss-import`, use this import instead:
- *
- * @import "tailwindcss/preflight";
- */
- @tailwind preflight;
-
- /**
- * This injects any component classes registered by plugins.
- *
- * If using `postcss-import`, use this import instead:
- *
- * @import "tailwindcss/components";
- */
- @tailwind components;
-
- /**
- * Here you would add any of your custom component classes; stuff that you'd
- * want loaded *before* the utilities so that the utilities could still
- * override them.
- *
- * Example:
- *
- * .btn { ... }
- * .form-input { ... }
- *
- * Or if using a preprocessor or `postcss-import`:
- *
- * @import "components/buttons";
- * @import "components/forms";
- */
-
- /**
- * This injects all of Tailwind's utility classes, generated based on your
- * config file.
- *
- * If using `postcss-import`, use this import instead:
- *
- * @import "tailwindcss/utilities";
- */
- @tailwind utilities;
-
- /**
- * Here you would add any custom utilities you need that don't come out of the
- * box with Tailwind.
- *
- * Example :
- *
- * .bg-pattern-graph-paper { ... }
- * .skew-45 { ... }
- *
- * Or if using a preprocessor or `postcss-import`:
- *
- * @import "utilities/background-patterns";
- * @import "utilities/skew-transforms";
- */
-
\ No newline at end of file
diff --git a/examples/tailwindcss-purgecss/components/MyComponent.vue b/examples/tailwindcss-purgecss/components/MyComponent.vue
deleted file mode 100644
index bdf92cf1e130..000000000000
--- a/examples/tailwindcss-purgecss/components/MyComponent.vue
+++ /dev/null
@@ -1,7 +0,0 @@
-<template>
- <div>
- <button class="bg-blue hover:bg-blue-dark text-white font-bold py-2 px-4 rounded">
- My Component Button
- </button>
- </div>
-</template>
diff --git a/examples/tailwindcss-purgecss/layouts/default.vue b/examples/tailwindcss-purgecss/layouts/default.vue
deleted file mode 100644
index 1910dc63f324..000000000000
--- a/examples/tailwindcss-purgecss/layouts/default.vue
+++ /dev/null
@@ -1,8 +0,0 @@
-<template>
- <div class="p-10">
- <h1 class="mb-6">
- Nuxt Tailwind CSS + Purgecss
- </h1>
- <Nuxt />
- </div>
-</template>
diff --git a/examples/tailwindcss-purgecss/nuxt.config.js b/examples/tailwindcss-purgecss/nuxt.config.js
deleted file mode 100644
index c6d101a106e0..000000000000
--- a/examples/tailwindcss-purgecss/nuxt.config.js
+++ /dev/null
@@ -1,36 +0,0 @@
-const path = require('path')
-
-export default {
- head: {
- title: 'Nuxt Tailwind CSS + Purgecss',
- meta: [
- { charset: 'utf-8' },
- { name: 'viewport', content: 'width=device-width, initial-scale=1' },
- {
- hid: 'description',
- name: 'description',
- content: 'A static site powered by Nuxt.js'
- }
- ]
- },
-
- css: ['~/assets/css/tailwind.css'],
-
- build: {
- postcss: {
- plugins: {
- tailwindcss: path.join(__dirname, 'tailwind.js'),
- autoprefixer: {},
- '@fullhuman/postcss-purgecss': {
- content: [
- path.join(__dirname, './pages/**/*.vue'),
- path.join(__dirname, './layouts/**/*.vue'),
- path.join(__dirname, './components/**/*.vue')
- ],
- defaultExtractor: content => content.match(/[\w-/:]+(?<!:)/g) || [],
- whitelist: ['html', 'body', 'nuxt-progress']
- }
- }
- }
- }
-}
diff --git a/examples/tailwindcss-purgecss/package.json b/examples/tailwindcss-purgecss/package.json
deleted file mode 100644
index 5b8c4b9e1b27..000000000000
--- a/examples/tailwindcss-purgecss/package.json
+++ /dev/null
@@ -1,27 +0,0 @@
-{
- "name": "tailwindcss-purgecss",
- "version": "1.0.0",
- "main": "index.js",
- "license": "MIT",
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "generate": "nuxt generate",
- "deploy": "surge -p dist/ -d https://nuxt-tailwindcss-purgecss.surge.sh",
- "post-update": "yarn upgrade --latest"
- },
- "dependencies": {
- "nuxt": "^2.2.0"
- },
- "devDependencies": {
- "@fullhuman/postcss-purgecss": "^1.1.0",
- "autoprefixer": "^9.3.1",
- "tailwindcss": "^0.6.6"
- },
- "prettier": {
- "semi": false,
- "singleQuote": true,
- "trailingComma": "none"
- }
-}
diff --git a/examples/tailwindcss-purgecss/pages/index.vue b/examples/tailwindcss-purgecss/pages/index.vue
deleted file mode 100644
index 65bcffecd04c..000000000000
--- a/examples/tailwindcss-purgecss/pages/index.vue
+++ /dev/null
@@ -1,21 +0,0 @@
-<template>
- <div>
- <h2 class="mb-4 text-blue">
- Homepage
- </h2>
- <p class="mb-4 bg-grey-light p-4 text-sm rounded leading-normal">
- Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed ut dolor placerat enim suscipit porttitor et sodales orci. In eget lorem a odio rhoncus finibus vel quis ex. Donec varius nisl ligula, vel finibus velit dignissim in.
- </p>
- <MyComponent />
- </div>
-</template>
-
-<script>
-import MyComponent from '~/components/MyComponent'
-
-export default {
- components: {
- MyComponent
- }
-}
-</script>
diff --git a/examples/tailwindcss-purgecss/tailwind.js b/examples/tailwindcss-purgecss/tailwind.js
deleted file mode 100644
index 0af356481ddc..000000000000
--- a/examples/tailwindcss-purgecss/tailwind.js
+++ /dev/null
@@ -1,921 +0,0 @@
-/*
-
-Tailwind - The Utility-First CSS Framework
-
-A project by Adam Wathan (@adamwathan), Jonathan Reinink (@reinink),
-David Hemphill (@davidhemphill) and Steve Schoger (@steveschoger).
-
-Welcome to the Tailwind config file. This is where you can customize
-Tailwind specifically for your project. Don't be intimidated by the
-length of this file. It's really just a big JavaScript object and
-we've done our very best to explain each section.
-
-View the full documentation at https://tailwindcss.com.
-
-|-------------------------------------------------------------------------------
-| The default config
-|-------------------------------------------------------------------------------
-|
-| This variable contains the default Tailwind config. You don't have
-| to use it, but it can sometimes be helpful to have available. For
-| example, you may choose to merge your custom configuration
-| values with some of the Tailwind defaults.
-|
-*/
-
-// let defaultConfig = require('tailwindcss/defaultConfig')()
-
-/*
-|-------------------------------------------------------------------------------
-| Colors https://tailwindcss.com/docs/colors
-|-------------------------------------------------------------------------------
-|
-| Here you can specify the colors used in your project. To get you started,
-| we've provided a generous palette of great looking colors that are perfect
-| for prototyping, but don't hesitate to change them for your project. You
-| own these colors, nothing will break if you change everything about them.
-|
-| We've used literal color names ("red", "blue", etc.) for the default
-| palette, but if you'd rather use functional names like "primary" and
-| "secondary", or even a numeric scale like "100" and "200", go for it.
-|
-*/
-
-const colors = {
- transparent: 'transparent',
-
- black: '#22292f',
- 'grey-darkest': '#3d4852',
- 'grey-darker': '#606f7b',
- 'grey-dark': '#8795a1',
- grey: '#b8c2cc',
- 'grey-light': '#dae1e7',
- 'grey-lighter': '#f1f5f8',
- 'grey-lightest': '#f8fafc',
- white: '#ffffff',
-
- 'red-darkest': '#3b0d0c',
- 'red-darker': '#621b18',
- 'red-dark': '#cc1f1a',
- red: '#e3342f',
- 'red-light': '#ef5753',
- 'red-lighter': '#f9acaa',
- 'red-lightest': '#fcebea',
-
- 'orange-darkest': '#462a16',
- 'orange-darker': '#613b1f',
- 'orange-dark': '#de751f',
- orange: '#f6993f',
- 'orange-light': '#faad63',
- 'orange-lighter': '#fcd9b6',
- 'orange-lightest': '#fff5eb',
-
- 'yellow-darkest': '#453411',
- 'yellow-darker': '#684f1d',
- 'yellow-dark': '#f2d024',
- yellow: '#ffed4a',
- 'yellow-light': '#fff382',
- 'yellow-lighter': '#fff9c2',
- 'yellow-lightest': '#fcfbeb',
-
- 'green-darkest': '#0f2f21',
- 'green-darker': '#1a4731',
- 'green-dark': '#1f9d55',
- green: '#38c172',
- 'green-light': '#51d88a',
- 'green-lighter': '#a2f5bf',
- 'green-lightest': '#e3fcec',
-
- 'teal-darkest': '#0d3331',
- 'teal-darker': '#20504f',
- 'teal-dark': '#38a89d',
- teal: '#4dc0b5',
- 'teal-light': '#64d5ca',
- 'teal-lighter': '#a0f0ed',
- 'teal-lightest': '#e8fffe',
-
- 'blue-darkest': '#12283a',
- 'blue-darker': '#1c3d5a',
- 'blue-dark': '#2779bd',
- blue: '#3490dc',
- 'blue-light': '#6cb2eb',
- 'blue-lighter': '#bcdefa',
- 'blue-lightest': '#eff8ff',
-
- 'indigo-darkest': '#191e38',
- 'indigo-darker': '#2f365f',
- 'indigo-dark': '#5661b3',
- indigo: '#6574cd',
- 'indigo-light': '#7886d7',
- 'indigo-lighter': '#b2b7ff',
- 'indigo-lightest': '#e6e8ff',
-
- 'purple-darkest': '#21183c',
- 'purple-darker': '#382b5f',
- 'purple-dark': '#794acf',
- purple: '#9561e2',
- 'purple-light': '#a779e9',
- 'purple-lighter': '#d6bbfc',
- 'purple-lightest': '#f3ebff',
-
- 'pink-darkest': '#451225',
- 'pink-darker': '#6f213f',
- 'pink-dark': '#eb5286',
- pink: '#f66d9b',
- 'pink-light': '#fa7ea8',
- 'pink-lighter': '#ffbbca',
- 'pink-lightest': '#ffebef'
-}
-
-module.exports = {
-
- /*
- |-----------------------------------------------------------------------------
- | Colors https://tailwindcss.com/docs/colors
- |-----------------------------------------------------------------------------
- |
- | The color palette defined above is also assigned to the "colors" key of
- | your Tailwind config. This makes it easy to access them in your CSS
- | using Tailwind's config helper. For example:
- |
- | .error { color: config('colors.red') }
- |
- */
-
- colors,
-
- /*
- |-----------------------------------------------------------------------------
- | Screens https://tailwindcss.com/docs/responsive-design
- |-----------------------------------------------------------------------------
- |
- | Screens in Tailwind are translated to CSS media queries. They define the
- | responsive breakpoints for your project. By default Tailwind takes a
- | "mobile first" approach, where each screen size represents a minimum
- | viewport width. Feel free to have as few or as many screens as you
- | want, naming them in whatever way you'd prefer for your project.
- |
- | Tailwind also allows for more complex screen definitions, which can be
- | useful in certain situations. Be sure to see the full responsive
- | documentation for a complete list of options.
- |
- | Class name: .{screen}:{utility}
- |
- */
-
- screens: {
- sm: '576px',
- md: '768px',
- lg: '992px',
- xl: '1200px'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Fonts https://tailwindcss.com/docs/fonts
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your project's font stack, or font families.
- | Keep in mind that Tailwind doesn't actually load any fonts for you.
- | If you're using custom fonts you'll need to import them prior to
- | defining them here.
- |
- | By default we provide a native font stack that works remarkably well on
- | any device or OS you're using, since it just uses the default fonts
- | provided by the platform.
- |
- | Class name: .font-{name}
- |
- */
-
- fonts: {
- sans: [
- 'system-ui',
- 'BlinkMacSystemFont',
- '-apple-system',
- 'Segoe UI',
- 'Roboto',
- 'Oxygen',
- 'Ubuntu',
- 'Cantarell',
- 'Fira Sans',
- 'Droid Sans',
- 'Helvetica Neue',
- 'sans-serif'
- ],
- serif: [
- 'Constantia',
- 'Lucida Bright',
- 'Lucidabright',
- 'Lucida Serif',
- 'Lucida',
- 'DejaVu Serif',
- 'Bitstream Vera Serif',
- 'Liberation Serif',
- 'Georgia',
- 'serif'
- ],
- mono: [
- 'Menlo',
- 'Monaco',
- 'Consolas',
- 'Liberation Mono',
- 'Courier New',
- 'monospace'
- ]
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Text sizes https://tailwindcss.com/docs/text-sizing
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your text sizes. Name these in whatever way
- | makes the most sense to you. We use size names by default, but
- | you're welcome to use a numeric scale or even something else
- | entirely.
- |
- | By default Tailwind uses the "rem" unit type for most measurements.
- | This allows you to set a root font size which all other sizes are
- | then based on. That said, you are free to use whatever units you
- | prefer, be it rems, ems, pixels or other.
- |
- | Class name: .text-{size}
- |
- */
-
- textSizes: {
- xs: '.75rem', // 12px
- sm: '.875rem', // 14px
- base: '1rem', // 16px
- lg: '1.125rem', // 18px
- xl: '1.25rem', // 20px
- '2xl': '1.5rem', // 24px
- '3xl': '1.875rem', // 30px
- '4xl': '2.25rem', // 36px
- '5xl': '3rem' // 48px
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Font weights https://tailwindcss.com/docs/font-weight
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your font weights. We've provided a list of
- | common font weight names with their respective numeric scale values
- | to get you started. It's unlikely that your project will require
- | all of these, so we recommend removing those you don't need.
- |
- | Class name: .font-{weight}
- |
- */
-
- fontWeights: {
- hairline: 100,
- thin: 200,
- light: 300,
- normal: 400,
- medium: 500,
- semibold: 600,
- bold: 700,
- extrabold: 800,
- black: 900
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Leading (line height) https://tailwindcss.com/docs/line-height
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your line height values, or as we call
- | them in Tailwind, leadings.
- |
- | Class name: .leading-{size}
- |
- */
-
- leading: {
- none: 1,
- tight: 1.25,
- normal: 1.5,
- loose: 2
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Tracking (letter spacing) https://tailwindcss.com/docs/letter-spacing
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your letter spacing values, or as we call
- | them in Tailwind, tracking.
- |
- | Class name: .tracking-{size}
- |
- */
-
- tracking: {
- tight: '-0.05em',
- normal: '0',
- wide: '0.05em'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Text colors https://tailwindcss.com/docs/text-color
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your text colors. By default these use the
- | color palette we defined above, however you're welcome to set these
- | independently if that makes sense for your project.
- |
- | Class name: .text-{color}
- |
- */
-
- textColors: colors,
-
- /*
- |-----------------------------------------------------------------------------
- | Background colors https://tailwindcss.com/docs/background-color
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your background colors. By default these use
- | the color palette we defined above, however you're welcome to set
- | these independently if that makes sense for your project.
- |
- | Class name: .bg-{color}
- |
- */
-
- backgroundColors: colors,
-
- /*
- |-----------------------------------------------------------------------------
- | Background sizes https://tailwindcss.com/docs/background-size
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your background sizes. We provide some common
- | values that are useful in most projects, but feel free to add other sizes
- | that are specific to your project here as well.
- |
- | Class name: .bg-{size}
- |
- */
-
- backgroundSize: {
- auto: 'auto',
- cover: 'cover',
- contain: 'contain'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Border widths https://tailwindcss.com/docs/border-width
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your border widths. Take note that border
- | widths require a special "default" value set as well. This is the
- | width that will be used when you do not specify a border width.
- |
- | Class name: .border{-side?}{-width?}
- |
- */
-
- borderWidths: {
- default: '1px',
- 0: '0',
- 2: '2px',
- 4: '4px',
- 8: '8px'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Border colors https://tailwindcss.com/docs/border-color
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your border colors. By default these use the
- | color palette we defined above, however you're welcome to set these
- | independently if that makes sense for your project.
- |
- | Take note that border colors require a special "default" value set
- | as well. This is the color that will be used when you do not
- | specify a border color.
- |
- | Class name: .border-{color}
- |
- */
-
- borderColors: global.Object.assign({ default: colors['grey-light'] }, colors),
-
- /*
- |-----------------------------------------------------------------------------
- | Border radius https://tailwindcss.com/docs/border-radius
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your border radius values. If a `default` radius
- | is provided, it will be made available as the non-suffixed `.rounded`
- | utility.
- |
- | If your scale includes a `0` value to reset already rounded corners, it's
- | a good idea to put it first so other values are able to override it.
- |
- | Class name: .rounded{-side?}{-size?}
- |
- */
-
- borderRadius: {
- none: '0',
- sm: '.125rem',
- default: '.25rem',
- lg: '.5rem',
- full: '9999px'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Width https://tailwindcss.com/docs/width
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your width utility sizes. These can be
- | percentage based, pixels, rems, or any other units. By default
- | we provide a sensible rem based numeric scale, a percentage
- | based fraction scale, plus some other common use-cases. You
- | can, of course, modify these values as needed.
- |
- |
- | It's also worth mentioning that Tailwind automatically escapes
- | invalid CSS class name characters, which allows you to have
- | awesome classes like .w-2/3.
- |
- | Class name: .w-{size}
- |
- */
-
- width: {
- auto: 'auto',
- px: '1px',
- 1: '0.25rem',
- 2: '0.5rem',
- 3: '0.75rem',
- 4: '1rem',
- 5: '1.25rem',
- 6: '1.5rem',
- 8: '2rem',
- 10: '2.5rem',
- 12: '3rem',
- 16: '4rem',
- 24: '6rem',
- 32: '8rem',
- 48: '12rem',
- 64: '16rem',
- '1/2': '50%',
- '1/3': '33.33333%',
- '2/3': '66.66667%',
- '1/4': '25%',
- '3/4': '75%',
- '1/5': '20%',
- '2/5': '40%',
- '3/5': '60%',
- '4/5': '80%',
- '1/6': '16.66667%',
- '5/6': '83.33333%',
- full: '100%',
- screen: '100vw'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Height https://tailwindcss.com/docs/height
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your height utility sizes. These can be
- | percentage based, pixels, rems, or any other units. By default
- | we provide a sensible rem based numeric scale plus some other
- | common use-cases. You can, of course, modify these values as
- | needed.
- |
- | Class name: .h-{size}
- |
- */
-
- height: {
- auto: 'auto',
- px: '1px',
- 1: '0.25rem',
- 2: '0.5rem',
- 3: '0.75rem',
- 4: '1rem',
- 5: '1.25rem',
- 6: '1.5rem',
- 8: '2rem',
- 10: '2.5rem',
- 12: '3rem',
- 16: '4rem',
- 24: '6rem',
- 32: '8rem',
- 48: '12rem',
- 64: '16rem',
- full: '100%',
- screen: '100vh'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Minimum width https://tailwindcss.com/docs/min-width
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your minimum width utility sizes. These can
- | be percentage based, pixels, rems, or any other units. We provide a
- | couple common use-cases by default. You can, of course, modify
- | these values as needed.
- |
- | Class name: .min-w-{size}
- |
- */
-
- minWidth: {
- 0: '0',
- full: '100%'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Minimum height https://tailwindcss.com/docs/min-height
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your minimum height utility sizes. These can
- | be percentage based, pixels, rems, or any other units. We provide a
- | few common use-cases by default. You can, of course, modify these
- | values as needed.
- |
- | Class name: .min-h-{size}
- |
- */
-
- minHeight: {
- 0: '0',
- full: '100%',
- screen: '100vh'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Maximum width https://tailwindcss.com/docs/max-width
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your maximum width utility sizes. These can
- | be percentage based, pixels, rems, or any other units. By default
- | we provide a sensible rem based scale and a "full width" size,
- | which is basically a reset utility. You can, of course,
- | modify these values as needed.
- |
- | Class name: .max-w-{size}
- |
- */
-
- maxWidth: {
- xs: '20rem',
- sm: '30rem',
- md: '40rem',
- lg: '50rem',
- xl: '60rem',
- '2xl': '70rem',
- '3xl': '80rem',
- '4xl': '90rem',
- '5xl': '100rem',
- full: '100%'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Maximum height https://tailwindcss.com/docs/max-height
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your maximum height utility sizes. These can
- | be percentage based, pixels, rems, or any other units. We provide a
- | couple common use-cases by default. You can, of course, modify
- | these values as needed.
- |
- | Class name: .max-h-{size}
- |
- */
-
- maxHeight: {
- full: '100%',
- screen: '100vh'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Padding https://tailwindcss.com/docs/padding
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your padding utility sizes. These can be
- | percentage based, pixels, rems, or any other units. By default we
- | provide a sensible rem based numeric scale plus a couple other
- | common use-cases like "1px". You can, of course, modify these
- | values as needed.
- |
- | Class name: .p{side?}-{size}
- |
- */
-
- padding: {
- px: '1px',
- 0: '0',
- 1: '0.25rem',
- 2: '0.5rem',
- 3: '0.75rem',
- 4: '1rem',
- 5: '1.25rem',
- 6: '1.5rem',
- 8: '2rem',
- 10: '2.5rem',
- 12: '3rem',
- 16: '4rem',
- 20: '5rem',
- 24: '6rem',
- 32: '8rem'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Margin https://tailwindcss.com/docs/margin
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your margin utility sizes. These can be
- | percentage based, pixels, rems, or any other units. By default we
- | provide a sensible rem based numeric scale plus a couple other
- | common use-cases like "1px". You can, of course, modify these
- | values as needed.
- |
- | Class name: .m{side?}-{size}
- |
- */
-
- margin: {
- auto: 'auto',
- px: '1px',
- 0: '0',
- 1: '0.25rem',
- 2: '0.5rem',
- 3: '0.75rem',
- 4: '1rem',
- 5: '1.25rem',
- 6: '1.5rem',
- 8: '2rem',
- 10: '2.5rem',
- 12: '3rem',
- 16: '4rem',
- 20: '5rem',
- 24: '6rem',
- 32: '8rem'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Negative margin https://tailwindcss.com/docs/negative-margin
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your negative margin utility sizes. These can
- | be percentage based, pixels, rems, or any other units. By default we
- | provide matching values to the padding scale since these utilities
- | generally get used together. You can, of course, modify these
- | values as needed.
- |
- | Class name: .-m{side?}-{size}
- |
- */
-
- negativeMargin: {
- px: '1px',
- 0: '0',
- 1: '0.25rem',
- 2: '0.5rem',
- 3: '0.75rem',
- 4: '1rem',
- 5: '1.25rem',
- 6: '1.5rem',
- 8: '2rem',
- 10: '2.5rem',
- 12: '3rem',
- 16: '4rem',
- 20: '5rem',
- 24: '6rem',
- 32: '8rem'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Shadows https://tailwindcss.com/docs/shadows
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your shadow utilities. As you can see from
- | the defaults we provide, it's possible to apply multiple shadows
- | per utility using comma separation.
- |
- | If a `default` shadow is provided, it will be made available as the non-
- | suffixed `.shadow` utility.
- |
- | Class name: .shadow-{size?}
- |
- */
-
- shadows: {
- default: '0 2px 4px 0 rgba(0,0,0,0.10)',
- md: '0 4px 8px 0 rgba(0,0,0,0.12), 0 2px 4px 0 rgba(0,0,0,0.08)',
- lg: '0 15px 30px 0 rgba(0,0,0,0.11), 0 5px 15px 0 rgba(0,0,0,0.08)',
- inner: 'inset 0 2px 4px 0 rgba(0,0,0,0.06)',
- outline: '0 0 0 3px rgba(52,144,220,0.5)',
- none: 'none'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Z-index https://tailwindcss.com/docs/z-index
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your z-index utility values. By default we
- | provide a sensible numeric scale. You can, of course, modify these
- | values as needed.
- |
- | Class name: .z-{index}
- |
- */
-
- zIndex: {
- auto: 'auto',
- 0: 0,
- 10: 10,
- 20: 20,
- 30: 30,
- 40: 40,
- 50: 50
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Opacity https://tailwindcss.com/docs/opacity
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your opacity utility values. By default we
- | provide a sensible numeric scale. You can, of course, modify these
- | values as needed.
- |
- | Class name: .opacity-{name}
- |
- */
-
- opacity: {
- 0: '0',
- 25: '.25',
- 50: '.5',
- 75: '.75',
- 100: '1'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | SVG fill https://tailwindcss.com/docs/svg
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your SVG fill colors. By default we just provide
- | `fill-current` which sets the fill to the current text color. This lets you
- | specify a fill color using existing text color utilities and helps keep the
- | generated CSS file size down.
- |
- | Class name: .fill-{name}
- |
- */
-
- svgFill: {
- current: 'currentColor'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | SVG stroke https://tailwindcss.com/docs/svg
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your SVG stroke colors. By default we just provide
- | `stroke-current` which sets the stroke to the current text color. This lets
- | you specify a stroke color using existing text color utilities and helps
- | keep the generated CSS file size down.
- |
- | Class name: .stroke-{name}
- |
- */
-
- svgStroke: {
- current: 'currentColor'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Modules https://tailwindcss.com/docs/configuration#modules
- |-----------------------------------------------------------------------------
- |
- | Here is where you control which modules are generated and what variants are
- | generated for each of those modules.
- |
- | Currently supported variants:
- | - responsive
- | - hover
- | - focus
- | - active
- | - group-hover
- |
- | To disable a module completely, use `false` instead of an array.
- |
- */
-
- modules: {
- appearance: ['responsive'],
- backgroundAttachment: ['responsive'],
- backgroundColors: ['responsive', 'hover', 'focus'],
- backgroundPosition: ['responsive'],
- backgroundRepeat: ['responsive'],
- backgroundSize: ['responsive'],
- borderCollapse: [],
- borderColors: ['responsive', 'hover', 'focus'],
- borderRadius: ['responsive'],
- borderStyle: ['responsive'],
- borderWidths: ['responsive'],
- cursor: ['responsive'],
- display: ['responsive'],
- flexbox: ['responsive'],
- float: ['responsive'],
- fonts: ['responsive'],
- fontWeights: ['responsive', 'hover', 'focus'],
- height: ['responsive'],
- leading: ['responsive'],
- lists: ['responsive'],
- margin: ['responsive'],
- maxHeight: ['responsive'],
- maxWidth: ['responsive'],
- minHeight: ['responsive'],
- minWidth: ['responsive'],
- negativeMargin: ['responsive'],
- opacity: ['responsive'],
- outline: ['focus'],
- overflow: ['responsive'],
- padding: ['responsive'],
- pointerEvents: ['responsive'],
- position: ['responsive'],
- resize: ['responsive'],
- shadows: ['responsive', 'hover', 'focus'],
- svgFill: [],
- svgStroke: [],
- tableLayout: ['responsive'],
- textAlign: ['responsive'],
- textColors: ['responsive', 'hover', 'focus'],
- textSizes: ['responsive'],
- textStyle: ['responsive', 'hover', 'focus'],
- tracking: ['responsive'],
- userSelect: ['responsive'],
- verticalAlign: ['responsive'],
- visibility: ['responsive'],
- whitespace: ['responsive'],
- width: ['responsive'],
- zIndex: ['responsive']
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Plugins https://tailwindcss.com/docs/plugins
- |-----------------------------------------------------------------------------
- |
- | Here is where you can register any plugins you'd like to use in your
- | project. Tailwind's built-in `container` plugin is enabled by default to
- | give you a Bootstrap-style responsive container component out of the box.
- |
- | Be sure to view the complete plugin documentation to learn more about how
- | the plugin system works.
- |
- */
-
- plugins: [
- require('tailwindcss/plugins/container')({
- // center: true,
- // padding: '1rem',
- })
- ],
-
- /*
- |-----------------------------------------------------------------------------
- | Advanced Options https://tailwindcss.com/docs/configuration#options
- |-----------------------------------------------------------------------------
- |
- | Here is where you can tweak advanced configuration options. We recommend
- | leaving these options alone unless you absolutely need to change them.
- |
- */
-
- options: {
- prefix: '',
- important: false,
- separator: ':'
- }
-
-}
diff --git a/examples/tailwindcss/README.md b/examples/tailwindcss/README.md
deleted file mode 100644
index ed20a3dab755..000000000000
--- a/examples/tailwindcss/README.md
+++ /dev/null
@@ -1,5 +0,0 @@
-# Nuxt.js with Tailwind CSS
-
-See https://tailwindcss.com/docs/what-is-tailwind/
-
-Demo: https://tailwindcss.nuxtjs.org
diff --git a/examples/tailwindcss/assets/css/tailwind.css b/examples/tailwindcss/assets/css/tailwind.css
deleted file mode 100644
index d44c6d8c2c4a..000000000000
--- a/examples/tailwindcss/assets/css/tailwind.css
+++ /dev/null
@@ -1,57 +0,0 @@
-/**
- * This injects Tailwind's base styles, which is a combination of
- * Normalize.css and some additional base styles.
- *
- * You can see the styles here:
- * https://github.com/tailwindcss/tailwindcss/blob/master/css/preflight.css
- *
- * If using `postcss-import`, you should import this line from it's own file:
- *
- * @import "./tailwind-preflight.css";
- *
- * See: https://github.com/tailwindcss/tailwindcss/issues/53#issuecomment-341413622
- */
- @tailwind preflight;
-
- /**
- * Here you would add any of your custom component classes; stuff that you'd
- * want loaded *before* the utilities so that the utilities could still
- * override them.
- *
- * Example:
- *
- * .btn { ... }
- * .form-input { ... }
- *
- * Or if using a preprocessor or `postcss-import`:
- *
- * @import "components/buttons";
- * @import "components/forms";
- */
-
- /**
- * This injects all of Tailwind's utility classes, generated based on your
- * config file.
- *
- * If using `postcss-import`, you should import this line from it's own file:
- *
- * @import "./tailwind-utilities.css";
- *
- * See: https://github.com/tailwindcss/tailwindcss/issues/53#issuecomment-341413622
- */
- @tailwind utilities;
-
- /**
- * Here you would add any custom utilities you need that don't come out of the
- * box with Tailwind.
- *
- * Example :
- *
- * .bg-pattern-graph-paper { ... }
- * .skew-45 { ... }
- *
- * Or if using a preprocessor or `postcss-import`:
- *
- * @import "utilities/background-patterns";
- * @import "utilities/skew-transforms";
- */
\ No newline at end of file
diff --git a/examples/tailwindcss/layouts/default.vue b/examples/tailwindcss/layouts/default.vue
deleted file mode 100644
index 21ab7eb46485..000000000000
--- a/examples/tailwindcss/layouts/default.vue
+++ /dev/null
@@ -1,14 +0,0 @@
-<template>
- <!-- See https://tailwindcss.com/docs/container -->
- <div class="container mx-auto">
- <Nuxt />
- <a href="https://github.com/nuxt/nuxt.js/tree/dev/examples/tailwindcss" class="inline-flex items-center no-underline mt-4 rounded-full border border-grey-light bg-grey-lightest text-xs text-grey-darkest font-semibold p-2">
- <span class="inline-flex rounded-full mr-1">
- <svg class="h-4 w-4" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
- <path d="M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.73.084-.73 1.205.085 1.838 1.237 1.838 1.237 1.07 1.835 2.81 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.136-.303-.54-1.523.104-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.4 3-.405 1.02.005 2.04.137 3 .404 2.28-1.552 3.285-1.23 3.285-1.23.644 1.653.24 2.873.12 3.176.764.84 1.23 1.91 1.23 3.22 0 4.61-2.806 5.625-5.476 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.824.57 4.8-1.574 8.236-6.074 8.236-11.37 0-6.626-5.373-12-12-12" />
- </svg>
- </span>
- <span>Source code</span>
- </a>
- </div>
-</template>
diff --git a/examples/tailwindcss/nuxt.config.js b/examples/tailwindcss/nuxt.config.js
deleted file mode 100644
index 69cf86bd223a..000000000000
--- a/examples/tailwindcss/nuxt.config.js
+++ /dev/null
@@ -1,3 +0,0 @@
-export default {
- css: ['~/assets/css/tailwind.css']
-}
diff --git a/examples/tailwindcss/package.json b/examples/tailwindcss/package.json
deleted file mode 100644
index d2238ed65906..000000000000
--- a/examples/tailwindcss/package.json
+++ /dev/null
@@ -1,17 +0,0 @@
-{
- "name": "example-tailwindcss",
- "description": "Nuxt.js with Tailwind CSS",
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- },
- "dependencies": {
- "nuxt": "latest"
- },
- "devDependencies": {
- "autoprefixer": "^7.1.6",
- "tailwindcss": "^0.1.3"
- }
-}
diff --git a/examples/tailwindcss/pages/about.vue b/examples/tailwindcss/pages/about.vue
deleted file mode 100644
index 7c69c23f4f8e..000000000000
--- a/examples/tailwindcss/pages/about.vue
+++ /dev/null
@@ -1,21 +0,0 @@
-<template>
- <div>
- <div class="mt-4 bg-orange-lightest border-l-4 border-orange text-orange-dark p-4">
- <p class="font-bold">
- Be Warned!
- </p>
- <p>This page has been {{ mode }}-side rendered!</p>
- </div>
- <button class="mt-4 bg-blue hover:bg-blue-light text-white font-bold py-2 px-4 border-b-4 border-blue-dark hover:border-blue rounded" @click="$router.push('/')">
- Back to home
- </button>
- </div>
-</template>
-
-<script>
-export default {
- asyncData: () => ({
- mode: (process.server ? 'server' : 'client')
- })
-}
-</script>
diff --git a/examples/tailwindcss/pages/index.vue b/examples/tailwindcss/pages/index.vue
deleted file mode 100644
index 5c633c2b9f41..000000000000
--- a/examples/tailwindcss/pages/index.vue
+++ /dev/null
@@ -1,29 +0,0 @@
-<template>
- <div>
- <div class="max-w-sm mt-4 rounded overflow-hidden shadow-lg">
- <img class="w-full" src="https://tailwindcss.com/img/card-top.jpg">
- <div class="px-6 py-4">
- <div class="font-bold text-xl mb-2">
- The Coldest Sunset
- </div>
- <p class="text-slate text-base">
- Lorem ipsum dolor sit amet, consectetur adipisicing elit. Voluptatibus quia, nulla! Maiores et perferendis eaque, exercitationem praesentium nihil.
- </p>
- </div>
- <div class="px-6 py-4">
- <span class="inline-block bg-grey-lighter rounded-full px-3 py-1 text-sm font-semibold text-slate mr-2">
- #photography
- </span>
- <span class="inline-block bg-grey-lighter rounded-full px-3 py-1 text-sm font-semibold text-slate mr-2">
- #travel
- </span>
- <span class="inline-block bg-grey-lighter rounded-full px-3 py-1 text-sm font-semibold text-slate">
- #winter
- </span>
- </div>
- </div>
- <button class="bg-blue mt-4 hover:bg-blue-dark text-white font-bold py-2 px-4 rounded" @click="$router.push('/about')">
- About
- </button>
- </div>
-</template>
diff --git a/examples/tailwindcss/postcss.config.js b/examples/tailwindcss/postcss.config.js
deleted file mode 100644
index 6b4212984e72..000000000000
--- a/examples/tailwindcss/postcss.config.js
+++ /dev/null
@@ -1,6 +0,0 @@
-module.exports = {
- plugins: [
- require('tailwindcss')('./tailwind.js'),
- require('autoprefixer')
- ]
-}
diff --git a/examples/tailwindcss/tailwind.js b/examples/tailwindcss/tailwind.js
deleted file mode 100644
index ad8978a24c4e..000000000000
--- a/examples/tailwindcss/tailwind.js
+++ /dev/null
@@ -1,744 +0,0 @@
-/*
-
-Tailwind - The Utility-First CSS Framework
-
-A project by Adam Wathan (@adamwathan), Jonathan Reinink (@reinink),
-David Hemphill (@davidhemphill) and Steve Schoger (@steveschoger).
-
-Welcome to the Tailwind config file. This is where you can customize
-Tailwind specifically for your project. Don't be intimidated by the
-length of this file. It's really just a big JavaScript object and
-we've done our very best to explain each section.
-
-View the full documentation at https://tailwindcss.com.
-
-|-------------------------------------------------------------------------------
-| The default config
-|-------------------------------------------------------------------------------
-|
-| This variable contains the default Tailwind config. You don't have
-| to use it, but it can sometimes be helpful to have available. For
-| example, you may choose to merge your custom configuration
-| values with some of the Tailwind defaults.
-|
-*/
-
-// var defaultConfig = require('tailwindcss').defaultConfig()
-
-/*
-|-------------------------------------------------------------------------------
-| Colors https://tailwindcss.com/docs/colors
-|-------------------------------------------------------------------------------
-|
-| Here you can specify the colors used in your project. To get you started,
-| we've provided a generous palette of great looking colors that are perfect
-| for prototyping, but don't hesitate to change them for your project. You
-| own these colors, nothing will break if you change everything about them.
-|
-| We've used literal color names ("red", "blue", etc.) for the default
-| palette, but if you'd rather use functional names like "primary" and
-| "secondary", or even a numeric scale like "100" and "200", go for it.
-|
-*/
-
-const colors = {
- transparent: 'transparent',
-
- black: '#222b2f',
- 'grey-darkest': '#364349',
- 'grey-darker': '#596a73',
- 'grey-dark': '#70818a',
- grey: '#9babb4',
- 'grey-light': '#dae4e9',
- 'grey-lighter': '#f3f7f9',
- 'grey-lightest': '#fafcfc',
- white: '#ffffff',
-
- 'red-darkest': '#420806',
- 'red-darker': '#6a1b19',
- 'red-dark': '#cc1f1a',
- red: '#e3342f',
- 'red-light': '#ef5753',
- 'red-lighter': '#f9acaa',
- 'red-lightest': '#fcebea',
-
- 'orange-darkest': '#542605',
- 'orange-darker': '#7f4012',
- 'orange-dark': '#de751f',
- orange: '#f6993f',
- 'orange-light': '#faad63',
- 'orange-lighter': '#fcd9b6',
- 'orange-lightest': '#fff5eb',
-
- 'yellow-darkest': '#453411',
- 'yellow-darker': '#684f1d',
- 'yellow-dark': '#f2d024',
- yellow: '#ffed4a',
- 'yellow-light': '#fff382',
- 'yellow-lighter': '#fff9c2',
- 'yellow-lightest': '#fcfbeb',
-
- 'green-darkest': '#032d19',
- 'green-darker': '#0b4228',
- 'green-dark': '#1f9d55',
- green: '#38c172',
- 'green-light': '#51d88a',
- 'green-lighter': '#a2f5bf',
- 'green-lightest': '#e3fcec',
-
- 'teal-darkest': '#0d3331',
- 'teal-darker': '#174e4b',
- 'teal-dark': '#38a89d',
- teal: '#4dc0b5',
- 'teal-light': '#64d5ca',
- 'teal-lighter': '#a0f0ed',
- 'teal-lightest': '#e8fffe',
-
- 'blue-darkest': '#05233b',
- 'blue-darker': '#103d60',
- 'blue-dark': '#2779bd',
- blue: '#3490dc',
- 'blue-light': '#6cb2eb',
- 'blue-lighter': '#bcdefa',
- 'blue-lightest': '#eff8ff',
-
- 'indigo-darkest': '#191e38',
- 'indigo-darker': '#2f365f',
- 'indigo-dark': '#5661b3',
- indigo: '#6574cd',
- 'indigo-light': '#7886d7',
- 'indigo-lighter': '#b2b7ff',
- 'indigo-lightest': '#e6e8ff',
-
- 'purple-darkest': '#1f133f',
- 'purple-darker': '#352465',
- 'purple-dark': '#794acf',
- purple: '#9561e2',
- 'purple-light': '#a779e9',
- 'purple-lighter': '#d6bbfc',
- 'purple-lightest': '#f3ebff',
-
- 'pink-darkest': '#45051e',
- 'pink-darker': '#72173a',
- 'pink-dark': '#eb5286',
- pink: '#f66d9b',
- 'pink-light': '#fa7ea8',
- 'pink-lighter': '#ffbbca',
- 'pink-lightest': '#ffebef'
-}
-
-export default {
-
- /*
- |-----------------------------------------------------------------------------
- | Colors https://tailwindcss.com/docs/colors
- |-----------------------------------------------------------------------------
- |
- | The color palette defined above is also assigned to the "colors" key of
- | your Tailwind config. This makes it easy to access them in your CSS
- | using Tailwind's config helper. For example:
- |
- | .error { color: config('colors.red') }
- |
- */
-
- colors,
-
- /*
- |-----------------------------------------------------------------------------
- | Screens https://tailwindcss.com/docs/responsive-design
- |-----------------------------------------------------------------------------
- |
- | Screens in Tailwind are translated to CSS media queries. They define the
- | responsive breakpoints for your project. By default Tailwind takes a
- | "mobile first" approach, where each screen size represents a minimum
- | viewport width. Feel free to have as few or as many screens as you
- | want, naming them in whatever way you'd prefer for your project.
- |
- | Tailwind also allows for more complex screen definitions, which can be
- | useful in certain situations. Be sure to see the full responsive
- | documentation for a complete list of options.
- |
- | Class name: .{screen}:{utility}
- |
- */
-
- screens: {
- sm: '576px',
- md: '768px',
- lg: '992px',
- xl: '1200px'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Fonts https://tailwindcss.com/docs/fonts
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your project's font stack, or font families.
- | Keep in mind that Tailwind doesn't actually load any fonts for you.
- | If you're using custom fonts you'll need to import them prior to
- | defining them here.
- |
- | By default we provide a native font stack that works remarkably well on
- | any device or OS you're using, since it just uses the default fonts
- | provided by the platform.
- |
- | Class name: .font-{name}
- |
- */
-
- fonts: {
- sans: [
- '-apple-system',
- 'BlinkMacSystemFont',
- 'Segoe UI',
- 'Roboto',
- 'Oxygen',
- 'Ubuntu',
- 'Cantarell',
- 'Fira Sans',
- 'Droid Sans',
- 'Helvetica Neue'
- ],
- serif: [
- 'Constantia',
- 'Lucida Bright',
- 'Lucidabright',
- 'Lucida Serif',
- 'Lucida',
- 'DejaVu Serif',
- 'Bitstream Vera Serif',
- 'Liberation Serif',
- 'Georgia',
- 'serif'
- ],
- mono: [
- 'Menlo',
- 'Monaco',
- 'Consolas',
- 'Liberation Mono',
- 'Courier New',
- 'monospace'
- ]
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Text sizes https://tailwindcss.com/docs/text-sizing
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your text sizes. Name these in whatever way
- | makes the most sense to you. We use size names by default, but
- | you're welcome to use a numeric scale or even something else
- | entirely.
- |
- | By default Tailwind uses the "rem" unit type for most measurements.
- | This allows you to set a root font size which all other sizes are
- | then based on. That said, you are free to use whatever units you
- | prefer, be it rems, ems, pixels or other.
- |
- | Class name: .text-{size}
- |
- */
-
- textSizes: {
- xs: '.75rem', // 12px
- sm: '.875rem', // 14px
- base: '1rem', // 16px
- lg: '1.125rem', // 18px
- xl: '1.25rem', // 20px
- '2xl': '1.5rem', // 24px
- '3xl': '1.875rem', // 30px
- '4xl': '2.25rem', // 36px
- '5xl': '3rem' // 48px
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Font weights https://tailwindcss.com/docs/font-weight
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your font weights. We've provided a list of
- | common font weight names with their respective numeric scale values
- | to get you started. It's unlikely that your project will require
- | all of these, so we recommend removing those you don't need.
- |
- | Class name: .font-{weight}
- |
- */
-
- fontWeights: {
- hairline: 100,
- thin: 200,
- light: 300,
- normal: 400,
- medium: 500,
- semibold: 600,
- bold: 700,
- extrabold: 800,
- black: 900
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Leading (line height) https://tailwindcss.com/docs/line-height
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your line height values, or as we call
- | them in Tailwind, leadings.
- |
- | Class name: .leading-{size}
- |
- */
-
- leading: {
- none: 1,
- tight: 1.25,
- normal: 1.5,
- loose: 2
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Tracking (letter spacing) https://tailwindcss.com/docs/letter-spacing
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your letter spacing values, or as we call
- | them in Tailwind, tracking.
- |
- | Class name: .tracking-{size}
- |
- */
-
- tracking: {
- tight: '-0.05em',
- normal: '0',
- wide: '0.05em'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Text colors https://tailwindcss.com/docs/text-color
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your text colors. By default these use the
- | color palette we defined above, however you're welcome to set these
- | independently if that makes sense for your project.
- |
- | Class name: .text-{color}
- |
- */
-
- textColors: colors,
-
- /*
- |-----------------------------------------------------------------------------
- | Background colors https://tailwindcss.com/docs/background-color
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your background colors. By default these use
- | the color palette we defined above, however you're welcome to set
- | these independently if that makes sense for your project.
- |
- | Class name: .bg-{color}
- |
- */
-
- backgroundColors: colors,
-
- /*
- |-----------------------------------------------------------------------------
- | Border widths https://tailwindcss.com/docs/border-width
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your border widths. Take note that border
- | widths require a special "default" value set as well. This is the
- | width that will be used when you do not specify a border width.
- |
- | Class name: .border{-side?}{-width?}
- |
- */
-
- borderWidths: {
- default: '1px',
- 0: '0',
- 2: '2px',
- 4: '4px',
- 8: '8px'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Border colors https://tailwindcss.com/docs/border-color
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your border colors. By default these use the
- | color palette we defined above, however you're welcome to set these
- | independently if that makes sense for your project.
- |
- | Take note that border colors require a special "default" value set
- | as well. This is the color that will be used when you do not
- | specify a border color.
- |
- | Class name: .border-{color}
- |
- */
-
- borderColors: Object.assign({ default: colors['grey-light'] }, colors),
-
- /*
- |-----------------------------------------------------------------------------
- | Border radius https://tailwindcss.com/docs/border-radius
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your border radius values. If a `default` radius
- | is provided, it will be made available as the non-suffixed `.rounded`
- | utility.
- |
- | Class name: .rounded{-radius?}
- |
- */
-
- borderRadius: {
- default: '.25rem',
- sm: '.125rem',
- lg: '.5rem',
- full: '9999px',
- none: '0'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Width https://tailwindcss.com/docs/width
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your width utility sizes. These can be
- | percentage based, pixels, rems, or any other units. By default
- | we provide a sensible rem based numeric scale, a percentage
- | based fraction scale, plus some other common use-cases. You
- | can, of course, modify these values as needed.
- |
- |
- | It's also worth mentioning that Tailwind automatically escapes
- | invalid CSS class name characters, which allows you to have
- | awesome classes like .w-2/3.
- |
- | Class name: .w-{size}
- |
- */
-
- width: {
- auto: 'auto',
- px: '1px',
- 1: '0.25rem',
- 2: '0.5rem',
- 3: '0.75rem',
- 4: '1rem',
- 6: '1.5rem',
- 8: '2rem',
- 10: '2.5rem',
- 12: '3rem',
- 16: '4rem',
- 24: '6rem',
- 32: '8rem',
- 48: '12rem',
- 64: '16rem',
- '1/2': '50%',
- '1/3': '33.33333%',
- '2/3': '66.66667%',
- '1/4': '25%',
- '3/4': '75%',
- '1/5': '20%',
- '2/5': '40%',
- '3/5': '60%',
- '4/5': '80%',
- '1/6': '16.66667%',
- '5/6': '83.33333%',
- full: '100%',
- screen: '100vw'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Height https://tailwindcss.com/docs/height
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your height utility sizes. These can be
- | percentage based, pixels, rems, or any other units. By default
- | we provide a sensible rem based numeric scale plus some other
- | common use-cases. You can, of course, modify these values as
- | needed.
- |
- | Class name: .h-{size}
- |
- */
-
- height: {
- auto: 'auto',
- px: '1px',
- 1: '0.25rem',
- 2: '0.5rem',
- 3: '0.75rem',
- 4: '1rem',
- 6: '1.5rem',
- 8: '2rem',
- 10: '2.5rem',
- 12: '3rem',
- 16: '4rem',
- 24: '6rem',
- 32: '8rem',
- 48: '12rem',
- 64: '16rem',
- full: '100%',
- screen: '100vh'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Minimum width https://tailwindcss.com/docs/min-width
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your minimum width utility sizes. These can
- | be percentage based, pixels, rems, or any other units. We provide a
- | couple common use-cases by default. You can, of course, modify
- | these values as needed.
- |
- | Class name: .min-w-{size}
- |
- */
-
- minWidth: {
- 0: '0',
- full: '100%'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Minimum height https://tailwindcss.com/docs/min-height
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your minimum height utility sizes. These can
- | be percentage based, pixels, rems, or any other units. We provide a
- | few common use-cases by default. You can, of course, modify these
- | values as needed.
- |
- | Class name: .min-h-{size}
- |
- */
-
- minHeight: {
- 0: '0',
- full: '100%',
- screen: '100vh'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Maximum width https://tailwindcss.com/docs/max-width
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your maximum width utility sizes. These can
- | be percentage based, pixels, rems, or any other units. By default
- | we provide a sensible rem based scale and a "full width" size,
- | which is basically a reset utility. You can, of course,
- | modify these values as needed.
- |
- | Class name: .max-w-{size}
- |
- */
-
- maxWidth: {
- xs: '20rem',
- sm: '30rem',
- md: '40rem',
- lg: '50rem',
- xl: '60rem',
- '2xl': '70rem',
- '3xl': '80rem',
- '4xl': '90rem',
- '5xl': '100rem',
- full: '100%'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Maximum height https://tailwindcss.com/docs/max-height
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your maximum height utility sizes. These can
- | be percentage based, pixels, rems, or any other units. We provide a
- | couple common use-cases by default. You can, of course, modify
- | these values as needed.
- |
- | Class name: .max-h-{size}
- |
- */
-
- maxHeight: {
- full: '100%',
- screen: '100vh'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Padding https://tailwindcss.com/docs/padding
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your padding utility sizes. These can be
- | percentage based, pixels, rems, or any other units. By default we
- | provide a sensible rem based numeric scale plus a couple other
- | common use-cases like "1px". You can, of course, modify these
- | values as needed.
- |
- | Class name: .p{side?}-{size}
- |
- */
-
- padding: {
- px: '1px',
- 0: '0',
- 1: '0.25rem',
- 2: '0.5rem',
- 3: '0.75rem',
- 4: '1rem',
- 6: '1.5rem',
- 8: '2rem'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Margin https://tailwindcss.com/docs/margin
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your margin utility sizes. These can be
- | percentage based, pixels, rems, or any other units. By default we
- | provide a sensible rem based numeric scale plus a couple other
- | common use-cases like "1px". You can, of course, modify these
- | values as needed.
- |
- | Class name: .m{side?}-{size}
- |
- */
-
- margin: {
- px: '1px',
- 0: '0',
- 1: '0.25rem',
- 2: '0.5rem',
- 3: '0.75rem',
- 4: '1rem',
- 6: '1.5rem',
- 8: '2rem'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Negative margin https://tailwindcss.com/docs/negative-margin
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your negative margin utility sizes. These can
- | be percentage based, pixels, rems, or any other units. By default we
- | provide matching values to the padding scale since these utilities
- | generally get used together. You can, of course, modify these
- | values as needed.
- |
- | Class name: .-m{side?}-{size}
- |
- */
-
- negativeMargin: {
- px: '1px',
- 0: '0',
- 1: '0.25rem',
- 2: '0.5rem',
- 3: '0.75rem',
- 4: '1rem',
- 6: '1.5rem',
- 8: '2rem'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Shadows https://tailwindcss.com/docs/shadows
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your shadow utilities. As you can see from
- | the defaults we provide, it's possible to apply multiple shadows
- | per utility using comma separation.
- |
- | If a `default` shadow is provided, it will be made available as the non-
- | suffixed `.shadow` utility.
- |
- | Class name: .shadow-{size?}
- |
- */
-
- shadows: {
- default: '0 2px 4px 0 rgba(0,0,0,0.10)',
- md: '0 4px 8px 0 rgba(0,0,0,0.12), 0 2px 4px 0 rgba(0,0,0,0.08)',
- lg: '0 15px 30px 0 rgba(0,0,0,0.11), 0 5px 15px 0 rgba(0,0,0,0.08)',
- inner: 'inset 0 2px 4px 0 rgba(0,0,0,0.06)',
- none: 'none'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Z-index https://tailwindcss.com/docs/z-index
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your z-index utility values. By default we
- | provide a sensible numeric scale. You can, of course, modify these
- | values as needed.
- |
- | Class name: .z-{index}
- |
- */
-
- zIndex: {
- 0: 0,
- 10: 10,
- 20: 20,
- 30: 30,
- 40: 40,
- 50: 50,
- auto: 'auto'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Opacity https://tailwindcss.com/docs/opacity
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your opacity utility values. By default we
- | provide a sensible numeric scale. You can, of course, modify these
- | values as needed.
- |
- | Class name: .opacity-{name}
- |
- */
-
- opacity: {
- 0: '0',
- 25: '.25',
- 50: '.5',
- 75: '.75',
- 100: '1'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Packages
- |-----------------------------------------------------------------------------
- |
- | Here is where you can define the configuration for any Tailwind packages
- | you're using. These can be utility packs, component bundles, or even
- | complete themes. You'll want to reference each package's
- | documentation for a list of settings available for it.
- |
- */
-
- packages: {
- }
-
-}
diff --git a/examples/uikit/README.md b/examples/uikit/README.md
deleted file mode 100644
index d2a1e2953e42..000000000000
--- a/examples/uikit/README.md
+++ /dev/null
@@ -1,7 +0,0 @@
-# Nuxt with [UIKit](https://github.com/uikit/uikit)
-
-> [UIkit](https://github.com/uikit/uikit) is a lightweight and modular front-end framework for developing fast and powerful web interfaces
-
-Live demo: https://uikit.nuxtjs.org
-
-Live edit: https://glitch.com/edit/#!/nuxt-uitkit
diff --git a/examples/uikit/layouts/default.vue b/examples/uikit/layouts/default.vue
deleted file mode 100644
index 636babbeeae5..000000000000
--- a/examples/uikit/layouts/default.vue
+++ /dev/null
@@ -1,5 +0,0 @@
-<template>
- <div class="uk-container">
- <Nuxt />
- </div>
-</template>
diff --git a/examples/uikit/nuxt.config.js b/examples/uikit/nuxt.config.js
deleted file mode 100644
index 33ff283accf7..000000000000
--- a/examples/uikit/nuxt.config.js
+++ /dev/null
@@ -1,6 +0,0 @@
-export default {
- css: ['uikit/dist/css/uikit.css'],
- plugins: [
- { src: '~/plugins/uikit.js', ssr: false }
- ]
-}
diff --git a/examples/uikit/package.json b/examples/uikit/package.json
deleted file mode 100644
index 6340233176a7..000000000000
--- a/examples/uikit/package.json
+++ /dev/null
@@ -1,14 +0,0 @@
-{
- "name": "example-uikit",
- "dependencies": {
- "nuxt": "latest",
- "uikit": "^3.0.0-beta.30",
- "jquery": "^3.2.1"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/uikit/pages/about.vue b/examples/uikit/pages/about.vue
deleted file mode 100644
index faccc5408703..000000000000
--- a/examples/uikit/pages/about.vue
+++ /dev/null
@@ -1,21 +0,0 @@
-<template>
- <div class="uk-card uk-card-body">
- <p>Hi from {{ name }}</p>
- <span class="uk-margin-small-right" uk-icon="icon: check" />
- <a href="#" uk-icon="icon: heart" />
- <hr class="uk-divider-icon">
- <NuxtLink to="/">
- Home page
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- asyncData ({ req }) {
- return {
- name: req ? 'server' : 'client'
- }
- }
-}
-</script>
diff --git a/examples/uikit/pages/index.vue b/examples/uikit/pages/index.vue
deleted file mode 100644
index ae84cbb077d3..000000000000
--- a/examples/uikit/pages/index.vue
+++ /dev/null
@@ -1,22 +0,0 @@
-<template>
- <div class="uk-card uk-card-body uk-card-primary">
- <h3 class="uk-card-title">
- Nuxt.js + UIKIT
- </h3>
- <button class="uk-button uk-button-default" title="Hello World" uk-tooltip>
- Hover
- </button>
- <div class="uk-inline">
- <button class="uk-button uk-button-default" type="button">
- Click
- </button>
- <div uk-dropdown="mode: click" class="uk-dropdown">
- Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt.
- </div>
- </div>
- <hr class="uk-divider-icon">
- <NuxtLink to="/about">
- About page
- </NuxtLink>
- </div>
-</template>
diff --git a/examples/uikit/plugins/uikit.js b/examples/uikit/plugins/uikit.js
deleted file mode 100644
index 81a92335a154..000000000000
--- a/examples/uikit/plugins/uikit.js
+++ /dev/null
@@ -1,5 +0,0 @@
-import UIkit from 'uikit'
-import Icons from 'uikit/dist/js/uikit-icons'
-
-// loads the Icon plugin
-UIkit.use(Icons)
diff --git a/examples/vue-apollo/README.md b/examples/vue-apollo/README.md
deleted file mode 100644
index befcbe177160..000000000000
--- a/examples/vue-apollo/README.md
+++ /dev/null
@@ -1,9 +0,0 @@
-# Nuxt with [Vue-Apollo](https://vue-apollo.netlify.com/)
-
-> *Vue-Apollo* is a Apollo/GraphQL integration for VueJS
-
-Demo: https://nuxt-vue-apollo.now.sh/
-
-https://github.com/nuxt-community/apollo-module
-
-https://github.com/Akryum/vue-apollo
diff --git a/examples/vue-apollo/apollo/queries/allCars.gql b/examples/vue-apollo/apollo/queries/allCars.gql
deleted file mode 100644
index 81c1448c14a1..000000000000
--- a/examples/vue-apollo/apollo/queries/allCars.gql
+++ /dev/null
@@ -1,8 +0,0 @@
-{
- allCars {
- id
- make
- model
- year
- }
-}
diff --git a/examples/vue-apollo/apollo/queries/car.gql b/examples/vue-apollo/apollo/queries/car.gql
deleted file mode 100644
index c380d258843d..000000000000
--- a/examples/vue-apollo/apollo/queries/car.gql
+++ /dev/null
@@ -1,8 +0,0 @@
-query Car($id: ID!) {
- Car(id: $id) {
- make
- model
- photoURL
- price
- }
-}
diff --git a/examples/vue-apollo/nuxt.config.js b/examples/vue-apollo/nuxt.config.js
deleted file mode 100644
index ed54e7faedb5..000000000000
--- a/examples/vue-apollo/nuxt.config.js
+++ /dev/null
@@ -1,10 +0,0 @@
-export default {
- modules: ['@nuxtjs/apollo'],
- apollo: {
- clientConfigs: {
- default: {
- httpEndpoint: 'https://api.graph.cool/simple/v1/cj1dqiyvqqnmj0113yuqamkuu'
- }
- }
- }
-}
diff --git a/examples/vue-apollo/package.json b/examples/vue-apollo/package.json
deleted file mode 100644
index fe23a6fba7e5..000000000000
--- a/examples/vue-apollo/package.json
+++ /dev/null
@@ -1,16 +0,0 @@
-{
- "name": "example-vue-apollo",
- "dependencies": {
- "@nuxtjs/apollo": "^4.0.0-rc.4",
- "core-js": "^2.6.5",
- "node-fetch": "^2.3.0",
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "generate": "nuxt generate",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/vue-apollo/pages/car/_id.vue b/examples/vue-apollo/pages/car/_id.vue
deleted file mode 100644
index d5debe41365e..000000000000
--- a/examples/vue-apollo/pages/car/_id.vue
+++ /dev/null
@@ -1,49 +0,0 @@
-<template>
- <div v-if="Car">
- <h3>{{ Car.make }} {{ Car.model }}</h3>
- <p>{{ formatCurrency(Car.price) }}</p>
- <img :src="Car.photoURL" :alt="`${Car.model} photo`">
- <p>
- <NuxtLink to="/">
- Home page
- </NuxtLink>
- </p>
- </div>
-</template>
-
-<script>
-import car from '~/apollo/queries/car'
-
-export default {
- apollo: {
- Car: {
- query: car,
- prefetch: ({ route }) => ({ id: route.params.id }),
- variables () {
- return { id: this.$route.params.id }
- }
- }
- },
- methods: {
- formatCurrency (num) {
- const formatter = new Intl.NumberFormat('en-US', {
- style: 'currency',
- currency: 'USD',
- minimumFractionDigits: 2
- })
- return formatter.format(num)
- }
- },
- head () {
- return {
- title: (this.Car ? `${this.Car.make} ${this.Car.model}` : 'Loading')
- }
- }
-}
-</script>
-
-<style>
-img {
- max-width: 600px;
-}
-</style>
diff --git a/examples/vue-apollo/pages/index.vue b/examples/vue-apollo/pages/index.vue
deleted file mode 100644
index 33d8f6d996bd..000000000000
--- a/examples/vue-apollo/pages/index.vue
+++ /dev/null
@@ -1,44 +0,0 @@
-<template>
- <div>
- <h3>Cars</h3>
- <ul>
- <li v-for="car in allCars" :key="car.id">
- <NuxtLink :to="`car/${car.id}`">
- {{ car.year }} {{ car.make }} {{ car.model }}
- </NuxtLink>
- </li>
- </ul>
- </div>
-</template>
-
-<script>
-import allCars from '~/apollo/queries/allCars'
-
-export default {
- apollo: {
- allCars: {
- prefetch: true,
- query: allCars
- }
- },
- head: {
- title: 'Cars with Apollo'
- }
-}
-</script>
-
-<style>
-ul {
- list-style-type: none;
- margin: 0;
- padding: 0;
- line-height: 1.6;
-}
-a {
- text-decoration: none;
- color: #3498DB;
-}
-a:hover {
- border-bottom: 1px solid;
-}
-</style>
diff --git a/examples/vue-chartjs/README.md b/examples/vue-chartjs/README.md
deleted file mode 100644
index a8eea1680eb7..000000000000
--- a/examples/vue-chartjs/README.md
+++ /dev/null
@@ -1,7 +0,0 @@
-# Nuxt with [Vue-ChartJS](https://vue-chartjs.org/)
-
-> *Vue-chartjs* is a wrapper for [Chart.js](https://github.com/chartjs/Chart.js) in vue. You can easily create reuseable chart components.
-
-Live demo: http://nuxt-vue-chartjs.surge.sh
-
-[](https://codesandbox.io/s/github/nuxt/nuxt.js/tree/dev/examples/vue-chartjs?fontsize=14&hidenavigation=1&theme=dark)
diff --git a/examples/vue-chartjs/components/bar-chart.js b/examples/vue-chartjs/components/bar-chart.js
deleted file mode 100644
index f8ae8c43182e..000000000000
--- a/examples/vue-chartjs/components/bar-chart.js
+++ /dev/null
@@ -1,9 +0,0 @@
-import { Bar } from 'vue-chartjs'
-
-export default {
- extends: Bar,
- props: ['data', 'options'],
- mounted () {
- this.renderChart(this.data, this.options)
- }
-}
diff --git a/examples/vue-chartjs/components/doughnut-chart.js b/examples/vue-chartjs/components/doughnut-chart.js
deleted file mode 100644
index 63e71a817951..000000000000
--- a/examples/vue-chartjs/components/doughnut-chart.js
+++ /dev/null
@@ -1,9 +0,0 @@
-import { Doughnut } from 'vue-chartjs'
-
-export default {
- extends: Doughnut,
- props: ['data', 'options'],
- mounted () {
- this.renderChart(this.data, this.options)
- }
-}
diff --git a/examples/vue-chartjs/layouts/default.vue b/examples/vue-chartjs/layouts/default.vue
deleted file mode 100644
index f9705198d0c7..000000000000
--- a/examples/vue-chartjs/layouts/default.vue
+++ /dev/null
@@ -1,62 +0,0 @@
-<template>
- <div class="container">
- <ul>
- <li>
- <NuxtLink to="/">
- Activity
- </NuxtLink>
- </li>
- <li>
- <NuxtLink to="/contributors">
- Contributors
- </NuxtLink>
- </li>
- </ul>
- <Nuxt />
- </div>
-</template>
-
-<style scoped>
-* {
- box-sizing: border-box;
-}
-.container {
- text-align: center;
- padding-top: 20px;
- font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, 'Open Sans', 'Helvetica Neue', sans-serif;
-}
-ul {
- margin: 0;
- padding: 0;
- list-style-type: none;
-}
-li {
- display: inline-block;
-}
-a {
- display: inline-block;
- font-weight: 500;
- padding-top: .75rem;
- padding-bottom: .75rem;
- padding-left: 1.5rem;
- padding-right: 1.5rem;
- text-transform: uppercase;
- text-decoration: none;
- box-shadow: 0 1px 3px 0 rgba(0,0,0,.1), 0 1px 2px 0 rgba(0,0,0,.06);
- border-radius: .25rem;
- border: none;
- background-color: #edf2f7;
- color: #2f495e;
- margin-right: 1rem;
-}
-a:hover {
- background-color: #e2e8f0;
-}
-.nuxt-link-exact-active {
- background-color: #00c58e;
- color: #fff;
-}
-.nuxt-link-exact-active:hover {
- background-color: #00e0a1;
-}
-</style>
diff --git a/examples/vue-chartjs/nuxt.config.js b/examples/vue-chartjs/nuxt.config.js
deleted file mode 100644
index 7ca1fc8d5187..000000000000
--- a/examples/vue-chartjs/nuxt.config.js
+++ /dev/null
@@ -1,16 +0,0 @@
-export default {
- head: {
- title: 'Nuxt.js + Vue-ChartJS',
- meta: [
- { charset: 'utf-8' },
- { name: 'viewport', content: 'width=device-width, initial-scale=1' }
- ]
- },
- modules: [
- // https://http.nuxtjs.org
- '@nuxt/http'
- ],
- env: {
- githubToken: '42cdf9fd55abf41d24f34c0f8a4d9ada5f9e9b93'
- }
-}
diff --git a/examples/vue-chartjs/package.json b/examples/vue-chartjs/package.json
deleted file mode 100644
index 84931417f795..000000000000
--- a/examples/vue-chartjs/package.json
+++ /dev/null
@@ -1,16 +0,0 @@
-{
- "name": "example-vue-chartjs",
- "dependencies": {
- "@nuxt/http": "^0.4.0",
- "chart.js": "^2.9.3",
- "moment": "^2.24.0",
- "nuxt": "latest",
- "vue-chartjs": "^3.5.0"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/vue-chartjs/pages/contributors.vue b/examples/vue-chartjs/pages/contributors.vue
deleted file mode 100644
index daf9dd33a2fe..000000000000
--- a/examples/vue-chartjs/pages/contributors.vue
+++ /dev/null
@@ -1,57 +0,0 @@
-<template>
- <div class="doughnut-chart">
- <DoughnutChart :data="doughnutChartData" :options="{ legend: { display: false }, maintainAspectRatio: false }" />
- </div>
-</template>
-
-<script>
-import DoughnutChart from '~/components/doughnut-chart'
-
-function isBot (username) {
- return username.includes('[bot]') || username.includes('-bot')
-}
-
-function getRandomColor () {
- const letters = '0123456789ABCDEF'
- let color = '#'
- for (let i = 0; i < 6; i++) {
- color += letters[Math.floor(Math.random() * 16)]
- }
- return color
-}
-
-export default {
- components: {
- DoughnutChart
- },
- async asyncData ({ $http, env }) {
- let contributors = await $http.$get('https://api.github.com/repos/nuxt/nuxt.js/contributors', {
- headers: {
- Authorization: `token ${env.githubToken}`
- }
- })
- contributors = contributors.filter(c => c.contributions >= 10 && !isBot(c.login))
- return {
- doughnutChartData: {
- labels: contributors.map(c => c.login),
- datasets: [
- {
- label: 'Nuxt.js Contributors',
- backgroundColor: contributors.map(getRandomColor),
- data: contributors.map(c => c.contributions)
- }
- ]
- }
- }
- }
-}
-</script>
-
-<style scoped>
-.doughnut-chart {
- width: 80%;
- height: 80%;
- margin: auto;
- margin-top: 30px;
-}
-</style>
diff --git a/examples/vue-chartjs/pages/index.vue b/examples/vue-chartjs/pages/index.vue
deleted file mode 100755
index c00f4f74d60d..000000000000
--- a/examples/vue-chartjs/pages/index.vue
+++ /dev/null
@@ -1,44 +0,0 @@
-<template>
- <div class="bar-chart">
- <BarChart :data="barChartData" :options="{ maintainAspectRatio: false }" />
- </div>
-</template>
-
-<script>
-import moment from 'moment'
-import BarChart from '~/components/bar-chart'
-
-export default {
- components: {
- BarChart
- },
- async asyncData ({ env, $http, $dayjs }) {
- const stats = await $http.$get('https://api.github.com/repos/nuxt/nuxt.js/stats/commit_activity', {
- headers: {
- Authorization: `token ${env.githubToken}`
- }
- })
- return {
- barChartData: {
- labels: stats.map(stat => moment(stat.week * 1000).format('GGGG[-W]WW')),
- datasets: [
- {
- label: 'Nuxt.js Commit Activity',
- backgroundColor: '#41B38A',
- data: stats.map(stat => stat.total)
- }
- ]
- }
- }
- }
-}
-</script>
-
-<style scoped>
-.bar-chart {
- width: 80%;
- height: 80%;
- margin: auto;
- margin-top: 30px;
-}
-</style>
diff --git a/examples/vue-class-component/README.md b/examples/vue-class-component/README.md
deleted file mode 100644
index 5bfd6e0b46df..000000000000
--- a/examples/vue-class-component/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Nuxt with [Vue-class-component](https://github.com/vuejs/vue-class-component) library
-
-> *vue-class-component* is an ECMAScript / TypeScript decorator for class-style Vue components.
diff --git a/examples/vue-class-component/components/Base.vue b/examples/vue-class-component/components/Base.vue
deleted file mode 100644
index 529a12ce282c..000000000000
--- a/examples/vue-class-component/components/Base.vue
+++ /dev/null
@@ -1,47 +0,0 @@
-<template>
- <div>
- <input v-model="msg">
- <p>msg: {{ msg }}</p>
- <p>env: {{ env }}</p>
- <p>computed msg: {{ computedMsg }}</p>
- <button @click="greet">
- Greet
- </button>
- <p>
- <NuxtLink to="/about">
- About page
- </NuxtLink>
- </p>
- </div>
-</template>
-
-<script>
-import Vue from 'vue'
-import Component from 'nuxt-class-component'
-
-export default
-@Component({
- props: {
- env: String
- }
-})
-class Base extends Vue {
- // initial data
- msg = 123
-
- // lifecycle hook
- mounted () {
- this.greet()
- }
-
- // computed
- get computedMsg () {
- return 'computed ' + this.msg
- }
-
- // method
- greet () {
- console.log('base greeting: ' + this.msg) // eslint-disable-line no-console
- }
-}
-</script>
diff --git a/examples/vue-class-component/components/Child.vue b/examples/vue-class-component/components/Child.vue
deleted file mode 100644
index 8a92b77f6890..000000000000
--- a/examples/vue-class-component/components/Child.vue
+++ /dev/null
@@ -1,30 +0,0 @@
-<template>
- <div>
- <input v-model="msg">
- <p>msg: {{ msg }}</p>
- <p>env: {{ env }}</p>
- <p>computed msg: {{ computedMsg }}</p>
- <button @click="greet">
- Greet
- </button>
- <p>
- <NuxtLink to="/about">
- About page
- </NuxtLink>
- </p>
- </div>
-</template>
-
-<script>
-import Component from 'nuxt-class-component'
-import Base from '@/components/Base'
-
-export default
-@Component
-class Child extends Base {
- // override parent method
- greet () {
- console.log('child greeting: ' + this.msg) // eslint-disable-line no-console
- }
-}
-</script>
diff --git a/examples/vue-class-component/package.json b/examples/vue-class-component/package.json
deleted file mode 100644
index 6cb041f7f2f7..000000000000
--- a/examples/vue-class-component/package.json
+++ /dev/null
@@ -1,13 +0,0 @@
-{
- "name": "example-vue-class-component",
- "dependencies": {
- "nuxt": "latest",
- "nuxt-class-component": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/vue-class-component/pages/about.vue b/examples/vue-class-component/pages/about.vue
deleted file mode 100644
index 57a01449ef35..000000000000
--- a/examples/vue-class-component/pages/about.vue
+++ /dev/null
@@ -1,10 +0,0 @@
-<template>
- <div>
- <h1>About</h1>
- <p>
- <NuxtLink to="/">
- Home page
- </NuxtLink>
- </p>
- </div>
-</template>
diff --git a/examples/vue-class-component/pages/index.vue b/examples/vue-class-component/pages/index.vue
deleted file mode 100644
index 7a71074af1e4..000000000000
--- a/examples/vue-class-component/pages/index.vue
+++ /dev/null
@@ -1,19 +0,0 @@
-<template>
- <Child :env="env" />
-</template>
-
-<script>
-import Vue from 'vue'
-import Component from 'nuxt-class-component'
-import Child from '@/components/Child'
-
-export default
-@Component({
- components: { Child }
-})
-class App extends Vue {
- asyncData ({ req }) {
- return { env: req ? 'server' : 'client' }
- }
-}
-</script>
diff --git a/examples/vuex-persistedstate/README.md b/examples/vuex-persistedstate/README.md
deleted file mode 100644
index 4af48686c656..000000000000
--- a/examples/vuex-persistedstate/README.md
+++ /dev/null
@@ -1,4 +0,0 @@
-# Nuxt with [Vuex](https://vuex.vuejs.org/) persisted state (localStorage)
-
-
-Demo is using [vuex-persistedstate](https://github.com/robinvdvleuten/vuex-persistedstate) library
diff --git a/examples/vuex-persistedstate/nuxt.config.js b/examples/vuex-persistedstate/nuxt.config.js
deleted file mode 100644
index e5e23be598f5..000000000000
--- a/examples/vuex-persistedstate/nuxt.config.js
+++ /dev/null
@@ -1,6 +0,0 @@
-export default {
- /*
- ** We set `spa` mode to have only client-side rendering
- */
- mode: 'spa'
-}
diff --git a/examples/vuex-persistedstate/package.json b/examples/vuex-persistedstate/package.json
deleted file mode 100644
index 679bd58b8a36..000000000000
--- a/examples/vuex-persistedstate/package.json
+++ /dev/null
@@ -1,13 +0,0 @@
-{
- "name": "example-persisted-state",
- "dependencies": {
- "nuxt": "latest",
- "vuex-persistedstate": "^2.0.0"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/vuex-persistedstate/pages/index.vue b/examples/vuex-persistedstate/pages/index.vue
deleted file mode 100644
index 8734ceb2fb9a..000000000000
--- a/examples/vuex-persistedstate/pages/index.vue
+++ /dev/null
@@ -1,26 +0,0 @@
-<template>
- <div>
- <p>{{ counter }}</p>
- <p>
- <button @click="increment">
- +
- </button>
- <button @click="decrement">
- -
- </button>
- </p>
- </div>
-</template>
-
-<script>
-import { mapState, mapMutations } from 'vuex'
-
-export default {
- computed: {
- ...mapState(['counter'])
- },
- methods: {
- ...mapMutations(['increment', 'decrement'])
- }
-}
-</script>
diff --git a/examples/vuex-persistedstate/store/index.js b/examples/vuex-persistedstate/store/index.js
deleted file mode 100644
index 0470583e3a18..000000000000
--- a/examples/vuex-persistedstate/store/index.js
+++ /dev/null
@@ -1,14 +0,0 @@
-import createPersistedState from 'vuex-persistedstate'
-
-export const state = () => ({
- counter: 0
-})
-
-export const mutations = {
- increment: state => state.counter++,
- decrement: state => state.counter--
-}
-
-export const plugins = [
- createPersistedState()
-]
diff --git a/examples/vuex-store/README.md b/examples/vuex-store/README.md
deleted file mode 100644
index dc0a710fb0a7..000000000000
--- a/examples/vuex-store/README.md
+++ /dev/null
@@ -1,7 +0,0 @@
-# Nuxt with [Vuex](https://vuex.vuejs.org/) and store modules
-
-> Vuex is a state management pattern + library for Vue.js applications.
-
-Read on Vuex modules [here](https://vuex.vuejs.org/guide/modules.html)
-
-https://nuxtjs.org/guide/vuex-store#modules-files
diff --git a/examples/vuex-store/package.json b/examples/vuex-store/package.json
deleted file mode 100644
index f36e0c3ca58d..000000000000
--- a/examples/vuex-store/package.json
+++ /dev/null
@@ -1,12 +0,0 @@
-{
- "name": "example-vuex-store",
- "dependencies": {
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/vuex-store/pages/about.vue b/examples/vuex-store/pages/about.vue
deleted file mode 100644
index 45fa28a1735a..000000000000
--- a/examples/vuex-store/pages/about.vue
+++ /dev/null
@@ -1,12 +0,0 @@
-<template>
- <div>
- <p>
- <button @click="$store.commit('increment')">
- {{ $store.state.counter }}
- </button><br>
- <NuxtLink to="/">
- Home
- </NuxtLink>
- </p>
- </div>
-</template>
diff --git a/examples/vuex-store/pages/index.vue b/examples/vuex-store/pages/index.vue
deleted file mode 100644
index a05711e9e8a6..000000000000
--- a/examples/vuex-store/pages/index.vue
+++ /dev/null
@@ -1,44 +0,0 @@
-<template>
- <div>
- <h3>Index Module</h3>
- <button @click="increment">
- {{ counter }}
- </button>
- <br>
- <NuxtLink to="/about">
- About
- </NuxtLink>
- <br>
- <br>
- <h3>Todo Module</h3>
- <NuxtLink to="/todos">
- Todos
- </NuxtLink>
- <br>
- <br>
- <h3>Nested Modules</h3>
- <NuxtLink to="/website">
- Website
- </NuxtLink>
- </div>
-</template>
-
-<script>
-import { mapState } from 'vuex'
-
-export default {
- // fetch(context) is called by the server-side
- // and before instantiating the component
- fetch ({ store }) {
- store.commit('increment')
- },
- computed: mapState([
- 'counter'
- ]),
- methods: {
- increment () {
- this.$store.commit('increment')
- }
- }
-}
-</script>
diff --git a/examples/vuex-store/pages/todos.vue b/examples/vuex-store/pages/todos.vue
deleted file mode 100644
index 00f0d3cb76ea..000000000000
--- a/examples/vuex-store/pages/todos.vue
+++ /dev/null
@@ -1,45 +0,0 @@
-<template>
- <div>
- <h2>Todos</h2>
- <ul>
- <li v-for="(todo, index) in todos" :key="index">
- <input :checked="todo.done" type="checkbox" @change="toggle(todo)">
- <span :class="{ done: todo.done }">
- {{ todo.text }}
- </span>
- </li>
- <li><input placeholder="What needs to be done?" @keyup.enter="addTodo"></li>
- </ul>
- <NuxtLink to="/">
- Home
- </NuxtLink>
- </div>
-</template>
-
-<script>
-import { mapMutations, mapGetters } from 'vuex'
-
-export default {
- computed: mapGetters({
- todos: 'todos/todos'
- }),
- methods: {
- addTodo (e) {
- const text = e.target.value
- if (text.trim()) {
- this.$store.commit('todos/add', { text })
- }
- e.target.value = ''
- },
- ...mapMutations({
- toggle: 'todos/toggle'
- })
- }
-}
-</script>
-
-<style>
-.done {
- text-decoration: line-through;
-}
-</style>
diff --git a/examples/vuex-store/pages/website.vue b/examples/vuex-store/pages/website.vue
deleted file mode 100644
index 0d33e8425a5b..000000000000
--- a/examples/vuex-store/pages/website.vue
+++ /dev/null
@@ -1,35 +0,0 @@
-<template>
- <div>
- <h2>Articles</h2>
- <ul>
- <li v-for="(article, index) in articles" :key="index">
- <span>{{ article }}</span>
- </li>
- </ul>
- <h2>Comments <small>(nested under articles)</small></h2>
- <ul>
- <li v-for="(comment, index) in comments" :key="index">
- <span>{{ comment }}</span>
- </li>
- </ul>
- <NuxtLink to="/">
- Home
- </NuxtLink>
- </div>
-</template>
-
-<script>
-import { mapGetters } from 'vuex'
-
-export default {
- computed: mapGetters({
- articles: 'articles/get',
- comments: 'articles/comments/get'
- }),
- methods: {
- }
-}
-</script>
-
-<style>
-</style>
diff --git a/examples/vuex-store/store/articles.js b/examples/vuex-store/store/articles.js
deleted file mode 100644
index e2fb76f674bf..000000000000
--- a/examples/vuex-store/store/articles.js
+++ /dev/null
@@ -1,19 +0,0 @@
-export const state = () => ({
- list: [
- 'Lorem ipsum',
- 'dolor sit amet',
- 'consetetur sadipscing elitr'
- ]
-})
-
-export const mutations = {
- add (state, title) {
- state.list.push(title)
- }
-}
-
-export const getters = {
- get (state) {
- return state.list
- }
-}
diff --git a/examples/vuex-store/store/articles/comments.js b/examples/vuex-store/store/articles/comments.js
deleted file mode 100644
index cf6588f3a31e..000000000000
--- a/examples/vuex-store/store/articles/comments.js
+++ /dev/null
@@ -1,13 +0,0 @@
-export const state = () => ({
- list: [
- 'Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.',
- 'Lorem ipsum dolor sit amet, consetetur sadipscing elit.',
- 'Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.'
- ]
-})
-
-export const getters = {
- get (state) {
- return state.list
- }
-}
diff --git a/examples/vuex-store/store/articles/comments/mutations.js b/examples/vuex-store/store/articles/comments/mutations.js
deleted file mode 100644
index 273b155b47e4..000000000000
--- a/examples/vuex-store/store/articles/comments/mutations.js
+++ /dev/null
@@ -1,5 +0,0 @@
-export default {
- add (state, title) {
- state.list.push(title)
- }
-}
diff --git a/examples/vuex-store/store/index.js b/examples/vuex-store/store/index.js
deleted file mode 100644
index 63f1975bf25c..000000000000
--- a/examples/vuex-store/store/index.js
+++ /dev/null
@@ -1,9 +0,0 @@
-export const state = () => ({
- counter: 0
-})
-
-export const mutations = {
- increment (state) {
- state.counter++
- }
-}
diff --git a/examples/vuex-store/store/todos/getters.js b/examples/vuex-store/store/todos/getters.js
deleted file mode 100644
index 5abcb21a63d5..000000000000
--- a/examples/vuex-store/store/todos/getters.js
+++ /dev/null
@@ -1,5 +0,0 @@
-export default {
- todos (state) {
- return state.list
- }
-}
diff --git a/examples/vuex-store/store/todos/mutations.js b/examples/vuex-store/store/todos/mutations.js
deleted file mode 100644
index 89496999cc72..000000000000
--- a/examples/vuex-store/store/todos/mutations.js
+++ /dev/null
@@ -1,12 +0,0 @@
-export default {
- add (state, { text }) {
- state.list.push({
- text,
- done: false
- })
- },
-
- toggle (state, todo) {
- todo.done = !todo.done
- }
-}
diff --git a/examples/vuex-store/store/todos/state.js b/examples/vuex-store/store/todos/state.js
deleted file mode 100644
index 0d94e8f20c51..000000000000
--- a/examples/vuex-store/store/todos/state.js
+++ /dev/null
@@ -1,3 +0,0 @@
-export default () => ({
- list: []
-})
diff --git a/examples/web-worker/.eslintrc.js b/examples/web-worker/.eslintrc.js
deleted file mode 100644
index ee82d758451e..000000000000
--- a/examples/web-worker/.eslintrc.js
+++ /dev/null
@@ -1,19 +0,0 @@
-module.exports = {
- root: true,
- env: {
- browser: true,
- node: true
- },
- parserOptions: {
- parser: 'babel-eslint'
- },
- extends: [
- 'plugin:vue/recommended'
- ],
- // required to lint *.vue files
- plugins: [
- 'vue'
- ],
- // add your custom rules here
- rules: {}
-}
diff --git a/examples/web-worker/.gitignore b/examples/web-worker/.gitignore
deleted file mode 100644
index 7ee611505397..000000000000
--- a/examples/web-worker/.gitignore
+++ /dev/null
@@ -1,11 +0,0 @@
-# dependencies
-node_modules
-
-# logs
-npm-debug.log
-
-# Nuxt build
-.nuxt
-
-# Nuxt generate
-dist
diff --git a/examples/web-worker/README.md b/examples/web-worker/README.md
deleted file mode 100644
index 6d3d6fac5834..000000000000
--- a/examples/web-worker/README.md
+++ /dev/null
@@ -1,26 +0,0 @@
-# Nuxt with web-workers using [Worker-loader](https://github.com/webpack-contrib/worker-loader)
-
-> Nuxt.js project
-
-In nuxt 1.4 and below you have to create a production build to use web workers.
-
-## Build Setup
-
-``` bash
-# install dependencies
-$ npm install # Or yarn install
-
-# serve with hot reload at localhost:3000
-# nuxt 1.4 and below does not support web workers in dev mode
-$ npm run dev
-
-# build for production and launch server
-# in nuxt 1.4 and below you have to create a production build to use web workers
-$ npm run build
-$ npm start
-
-# generate static project
-$ npm run generate
-```
-
-For detailed explanation on how things work, checkout the [Nuxt.js docs](https://github.com/nuxt/nuxt.js).
diff --git a/examples/web-worker/assets/README.md b/examples/web-worker/assets/README.md
deleted file mode 100644
index c67cf2e260e5..000000000000
--- a/examples/web-worker/assets/README.md
+++ /dev/null
@@ -1,8 +0,0 @@
-# ASSETS
-
-This directory contains your un-compiled assets such as LESS, SASS, or JavaScript.
-
-More information about the usage of this directory in the documentation:
-https://nuxtjs.org/guide/assets#webpacked
-
-**This directory is not required, you can delete it if you don't want to use it.**
diff --git a/examples/web-worker/assets/js/Example.worker.js b/examples/web-worker/assets/js/Example.worker.js
deleted file mode 100644
index f5767ffa4f0e..000000000000
--- a/examples/web-worker/assets/js/Example.worker.js
+++ /dev/null
@@ -1,19 +0,0 @@
-// block for `time` ms, then return the number of loops we could run in that time:
-function expensive(time) {
- let start = Date.now(),
- count = 0
- while (Date.now() - start < time) count++
- return count
-}
-
-// Respond to message from parent thread
-self.addEventListener('message', (event) => {
- console.log('worker', event.data)
-
- if (event.data.action === 'expensive' && event.data.time) {
- // Post data to parent thread
- self.postMessage(expensive(Number(event.data.time)))
- } else {
- self.postMessage({ hello: 'from worker' })
- }
-})
diff --git a/examples/web-worker/components/AppLogo.vue b/examples/web-worker/components/AppLogo.vue
deleted file mode 100644
index a4f590a68862..000000000000
--- a/examples/web-worker/components/AppLogo.vue
+++ /dev/null
@@ -1,79 +0,0 @@
-<template>
- <div class="VueToNuxtLogo">
- <div class="Triangle Triangle--two" />
- <div class="Triangle Triangle--one" />
- <div class="Triangle Triangle--three" />
- <div class="Triangle Triangle--four" />
- </div>
-</template>
-
-<style>
-.VueToNuxtLogo {
- display: inline-block;
- animation: turn 2s linear forwards 1s;
- transform: rotateX(180deg);
- position: relative;
- overflow: hidden;
- height: 180px;
- width: 245px;
-}
-
-.Triangle {
- position: absolute;
- top: 0;
- left: 0;
- width: 0;
- height: 0;
-}
-
-.Triangle--one {
- border-left: 105px solid transparent;
- border-right: 105px solid transparent;
- border-bottom: 180px solid #41B883;
-}
-
-.Triangle--two {
- top: 30px;
- left: 35px;
- animation: goright 0.5s linear forwards 3.5s;
- border-left: 87.5px solid transparent;
- border-right: 87.5px solid transparent;
- border-bottom: 150px solid #3B8070;
-}
-
-.Triangle--three {
- top: 60px;
- left: 35px;
- animation: goright 0.5s linear forwards 3.5s;
- border-left: 70px solid transparent;
- border-right: 70px solid transparent;
- border-bottom: 120px solid #35495E;
-}
-
-.Triangle--four {
- top: 120px;
- left: 70px;
- animation: godown 0.5s linear forwards 3s;
- border-left: 35px solid transparent;
- border-right: 35px solid transparent;
- border-bottom: 60px solid #fff;
-}
-
-@keyframes turn {
- 100% {
- transform: rotateX(0deg);
- }
-}
-
-@keyframes godown {
- 100% {
- top: 180px;
- }
-}
-
-@keyframes goright {
- 100% {
- left: 70px;
- }
-}
-</style>
diff --git a/examples/web-worker/components/README.md b/examples/web-worker/components/README.md
deleted file mode 100644
index d7768ddb5fd5..000000000000
--- a/examples/web-worker/components/README.md
+++ /dev/null
@@ -1,6 +0,0 @@
-# COMPONENTS
-
-The components directory contains your Vue.js Components.
-Nuxt.js doesn't supercharge these components.
-
-**This directory is not required, you can delete it if you don't want to use it.**
diff --git a/examples/web-worker/layouts/README.md b/examples/web-worker/layouts/README.md
deleted file mode 100644
index 83d09caee84b..000000000000
--- a/examples/web-worker/layouts/README.md
+++ /dev/null
@@ -1,8 +0,0 @@
-# LAYOUTS
-
-This directory contains your Application Layouts.
-
-More information about the usage of this directory in the documentation:
-https://nuxtjs.org/guide/views#layouts
-
-**This directory is not required, you can delete it if you don't want to use it.**
diff --git a/examples/web-worker/layouts/default.vue b/examples/web-worker/layouts/default.vue
deleted file mode 100644
index 3fec18260fdc..000000000000
--- a/examples/web-worker/layouts/default.vue
+++ /dev/null
@@ -1,58 +0,0 @@
-<template>
- <div>
- <Nuxt />
- </div>
-</template>
-
-<style>
-html {
- font-family: "Source Sans Pro", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
- font-size: 16px;
- word-spacing: 1px;
- -ms-text-size-adjust: 100%;
- -webkit-text-size-adjust: 100%;
- -moz-osx-font-smoothing: grayscale;
- -webkit-font-smoothing: antialiased;
- box-sizing: border-box;
-}
-
-*, *:before, *:after {
- box-sizing: border-box;
- margin: 0;
-}
-
-.button {
- margin-left: 15px;
-
- cursor: pointer;
- user-select: none;
-}
-
-.button--green {
- display: inline-block;
- border-radius: 4px;
- border: 1px solid #3b8070;
- color: #3b8070;
- text-decoration: none;
- padding: 10px 30px;
-}
-
-.button--green:hover {
- color: #fff;
- background-color: #3b8070;
-}
-
-.button--grey {
- display: inline-block;
- border-radius: 4px;
- border: 1px solid #35495e;
- color: #35495e;
- text-decoration: none;
- padding: 10px 30px;
-}
-
-.button--grey:hover {
- color: #fff;
- background-color: #35495e;
-}
-</style>
diff --git a/examples/web-worker/nuxt.config.js b/examples/web-worker/nuxt.config.js
deleted file mode 100644
index 0326a79cf138..000000000000
--- a/examples/web-worker/nuxt.config.js
+++ /dev/null
@@ -1,52 +0,0 @@
-module.exports = {
- /*
- ** Headers of the page
- */
- head: {
- title: 'web-worker',
- meta: [
- { charset: 'utf-8' },
- { name: 'viewport', content: 'width=device-width, initial-scale=1' },
- { hid: 'description', name: 'description', content: 'Nuxt.js project' }
- ],
- link: [
- { rel: 'icon', type: 'image/x-icon', href: '/favicon.ico' }
- ]
- },
- /*
- ** Customize the progress bar color
- */
- loading: { color: '#3B8070' },
- plugins: [
- { src: '~/plugins/inject-ww', ssr: false } // web workers are only available client-side, hence ssr: false
- ],
- /*
- ** Build configuration
- */
- build: {
- /*
- ** Run ESLint on save
- */
- extend (config, { isDev, isClient }) {
- if (isDev && isClient) {
- config.module.rules.push({
- enforce: 'pre',
- test: /\.(js|vue)$/,
- loader: 'eslint-loader',
- exclude: /(node_modules)/
- })
- }
-
- // @see https://github.com/nuxt/nuxt.js/pull/3480#issuecomment-404150387
- config.output.globalObject = "this"
-
- if (isClient) { // web workers are only available client-side
- config.module.rules.push({
- test: /\.worker\.js$/, // this will pick up all .js files that ends with ".worker.js"
- loader: 'worker-loader',
- exclude: /(node_modules)/
- })
- }
- }
- }
-}
diff --git a/examples/web-worker/package.json b/examples/web-worker/package.json
deleted file mode 100644
index c417b3bf6ec0..000000000000
--- a/examples/web-worker/package.json
+++ /dev/null
@@ -1,24 +0,0 @@
-{
- "name": "web-worker",
- "description": "Demo web workers in nuxt.js",
- "private": true,
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "generate": "nuxt generate",
- "lint": "eslint --ext .js,.vue --ignore-path .gitignore .",
- "precommit": "npm run lint",
- "post-update": "yarn upgrade --latest"
- },
- "dependencies": {
- "nuxt": "latest"
- },
- "devDependencies": {
- "babel-eslint": "^8.2.6",
- "eslint": "^5.1.0",
- "eslint-loader": "^2.0.0",
- "eslint-plugin-vue": "^4.5.0",
- "worker-loader": "^1.1.1"
- }
-}
diff --git a/examples/web-worker/pages/README.md b/examples/web-worker/pages/README.md
deleted file mode 100644
index b0070716393e..000000000000
--- a/examples/web-worker/pages/README.md
+++ /dev/null
@@ -1,7 +0,0 @@
-# PAGES
-
-This directory contains your Application Views and Routes.
-The framework reads all the .vue files inside this directory and creates the router of your application.
-
-More information about the usage of this directory in the documentation:
-https://nuxtjs.org/guide/routing
diff --git a/examples/web-worker/pages/index.vue b/examples/web-worker/pages/index.vue
deleted file mode 100644
index 88352404955a..000000000000
--- a/examples/web-worker/pages/index.vue
+++ /dev/null
@@ -1,185 +0,0 @@
-<template>
- <section class="container">
- <div>
- <AppLogo />
- <h1 class="title">
- web-worker
- </h1>
- <h2 class="subtitle">
- Nuxt.js project
- </h2>
- <p>{{ notification }}</p>
- <ul class="list">
- <li>Number of Web Workers: {{ workers.length }}</li>
- <li>Number of long Running Workers: {{ longRunningWorkers.length }}</li>
- <li>Number of unused Workers: {{ workers.filter(w => !w.inUse).length }}</li>
- </ul>
- <div class="links">
- <a
- :class="needWorkerSetup ? 'hidden' : 'visible'"
- class="button button--green"
- @click="test"
- >
- Test Worker
- </a>
- <a
- :class="needWorkerSetup ? 'hidden' : 'visible'"
- class="button button--green"
- @click="long(4000)"
- >
- Execute long running Worker
- </a>
- <a
- :class="needWorkerSetup || !longRunningWorkers.length ? 'hidden' : 'visible'"
- class="button button--green"
- @click="freeWorker"
- >
- Free long running Worker
- </a>
- <a
- class="button button--grey"
- @click="removeWorker"
- >
- Remove Web Worker
- </a>
- <a
- class="button button--grey"
- @click="createWorkers"
- >
- Create more Workers
- </a>
- </div>
- </div>
- </section>
-</template>
-
-<script>
-import AppLogo from '~/components/AppLogo.vue'
-
-export default {
- components: {
- AppLogo
- },
- data () {
- return {
- notification: '',
- workers: [],
- workerIndex: 0,
- longRunningWorkers: [],
- longIndex: 0
- }
- },
- computed: {
- needWorkerSetup () {
- return this.workers.length === 0 && this.longRunningWorkers.length === 0
- }
- },
- watch: {
- workers (workers) {
- if (workers.length === 0) this.notification = 'Zero free Web Workers - click "Create more Workers"'
- }
- },
- methods: {
- test () {
- const worker = this.workers[this.workerIndex++ % this.workers.length]
-
- if (worker) {
- worker.onmessage = (event) => {
- this.notification = event.data.hello
- }
- }
-
- if (worker) worker.postMessage({ hello: 'world' })
- else this.notification = 'No more test workers available'
- },
- long (milliseconds) {
- let worker = this.workers.shift()
-
- if (worker) {
- worker.onmessage = (event) => {
- this.notification = `expensive made ${event.data} loops`
- worker.onmessage = null
- this.workers.push(...this.longRunningWorkers.splice(this.longRunningWorkers.indexOf(worker), 1))
- }
- this.longRunningWorkers.push(worker)
- } else {
- worker = this.longRunningWorkers[ this.longIndex++ % this.longRunningWorkers.length]
- }
-
- worker.postMessage({ action: 'expensive', time: milliseconds })
- },
- freeWorker () {
- // we can't really free a worker, we can only terminate it and create a new
- const worker = this.longRunningWorkers.pop()
- worker.onmessage = null
- worker.terminate()
- this.workers.push(this.$worker.createWorker())
- this.notification = 'Worker freed'
- },
- removeWorker () {
- const worker = this.workers.pop() || this.longRunningWorkers.pop()
-
- if (!worker) return
-
- if (this.longRunningWorkers.indexOf(worker) > -1) this.longRunningWorkers.splice(this.longRunningWorkers.indexOf(worker), 1)
-
- worker.onmessage = null
- worker.terminate()
- },
- createWorkers () {
- if (process.client) {
- for(let i = 0, len = navigator.hardwareConcurrency || 1; i < len; i++) {
- this.workers.push(this.$worker.createWorker())
- }
-
- this.notification = 'Go nuts!'
- }
- }
- }
-}
-</script>
-
-<style>
-.hidden {
- visibility: hidden;
-}
-
-.visible {
- visibility: visible;
-}
-
-.container {
- min-height: 100vh;
- display: flex;
- justify-content: center;
- align-items: center;
- text-align: center;
-}
-
-.title {
- font-family: "Quicksand", "Source Sans Pro", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif; /* 1 */
- display: block;
- font-weight: 300;
- font-size: 100px;
- color: #35495e;
- letter-spacing: 1px;
-}
-
-.subtitle {
- font-weight: 300;
- font-size: 42px;
- color: #526488;
- word-spacing: 5px;
- padding-bottom: 15px;
-}
-
-.links {
- padding-top: 15px;
-}
-
-.list {
- text-align: left;
- color: #526488;
- list-style: none;
-}
-</style>
diff --git a/examples/web-worker/plugins/README.md b/examples/web-worker/plugins/README.md
deleted file mode 100644
index ec39a25e3fc1..000000000000
--- a/examples/web-worker/plugins/README.md
+++ /dev/null
@@ -1,8 +0,0 @@
-# PLUGINS
-
-This directory contains your Javascript plugins that you want to run before instantiating the root vue.js application.
-
-More information about the usage of this directory in the documentation:
-https://nuxtjs.org/guide/plugins
-
-**This directory is not required, you can delete it if you don't want to use it.**
diff --git a/examples/web-worker/plugins/inject-ww.js b/examples/web-worker/plugins/inject-ww.js
deleted file mode 100644
index f1935cdf5ded..000000000000
--- a/examples/web-worker/plugins/inject-ww.js
+++ /dev/null
@@ -1,9 +0,0 @@
-import ExampleWorker from '~/assets/js/Example.worker.js' // worker files has to end in ".worker.js" - see nuxt.config.js
-
-export default (context, inject) => {
- inject('worker', {
- createWorker () {
- return new ExampleWorker()
- }
- })
-}
diff --git a/examples/web-worker/static/README.md b/examples/web-worker/static/README.md
deleted file mode 100644
index 66fe23aac171..000000000000
--- a/examples/web-worker/static/README.md
+++ /dev/null
@@ -1,11 +0,0 @@
-# STATIC
-
-This directory contains your static files.
-Each file inside this directory is mapped to /.
-
-Example: /static/robots.txt is mapped as /robots.txt.
-
-More information about the usage of this directory in the documentation:
-https://nuxtjs.org/guide/assets#static
-
-**This directory is not required, you can delete it if you don't want to use it.**
diff --git a/examples/web-worker/static/favicon.ico b/examples/web-worker/static/favicon.ico
deleted file mode 100644
index 382fecbbf96d..000000000000
Binary files a/examples/web-worker/static/favicon.ico and /dev/null differ
diff --git a/examples/with-amp/README.md b/examples/with-amp/README.md
deleted file mode 100644
index c5f79736c3bd..000000000000
--- a/examples/with-amp/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Nuxt with [AMP](https://www.ampproject.org/)
-
->AMP is an open-source library that provides a straightforward way to create web pages that are compelling, smooth, and load near instantaneously for users. AMP pages are just web pages that you can link to and are controlled by you.
diff --git a/examples/with-amp/app.html b/examples/with-amp/app.html
deleted file mode 100644
index 4b77b8ada141..000000000000
--- a/examples/with-amp/app.html
+++ /dev/null
@@ -1,11 +0,0 @@
-<!doctype html>
-<html ⚡ {{ HTML_ATTRS }}>
- <head>
- {{ HEAD }}
- <style amp-boilerplate>body{-webkit-animation:-amp-start 8s steps(1,end) 0s 1 normal both;-moz-animation:-amp-start 8s steps(1,end) 0s 1 normal both;-ms-animation:-amp-start 8s steps(1,end) 0s 1 normal both;animation:-amp-start 8s steps(1,end) 0s 1 normal both}@-webkit-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@-moz-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@-ms-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@-o-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}</style>
- <noscript><style amp-boilerplate>body{-webkit-animation:none;-moz-animation:none;-ms-animation:none;animation:none}</style></noscript>
- </head>
- <body {{ BODY_ATTRS }}>
- {{ APP }}
- </body>
-</html>
diff --git a/examples/with-amp/assets/main.css b/examples/with-amp/assets/main.css
deleted file mode 100644
index 6d33a3cafe81..000000000000
--- a/examples/with-amp/assets/main.css
+++ /dev/null
@@ -1,23 +0,0 @@
-body {
- font-family: Roboto, sans-serif;
- padding: 30px;
- color: #444;
-}
-h1 {
- margin-bottom: 5px;
-}
-.caption {
- color: #ccc;
- margin-top: 0;
- font-size: 14px;
- text-align: center;
-}
-.byline {
- color: #aaa;
- margin-bottom: 25px;
-}
-p {
- font-size: 18px;
- line-height: 30px;
- margin-top: 30px;
-}
diff --git a/examples/with-amp/components/Byline.vue b/examples/with-amp/components/Byline.vue
deleted file mode 100644
index a03a54f72cfd..000000000000
--- a/examples/with-amp/components/Byline.vue
+++ /dev/null
@@ -1,16 +0,0 @@
-<template>
- <div class="byline">
- By {{ author }}
- </div>
-</template>
-
-<script>
-export default {
- props: {
- author: {
- type: String,
- default: ''
- }
- }
-}
-</script>
diff --git a/examples/with-amp/nuxt.config.js b/examples/with-amp/nuxt.config.js
deleted file mode 100644
index da1d946516be..000000000000
--- a/examples/with-amp/nuxt.config.js
+++ /dev/null
@@ -1,39 +0,0 @@
-const modifyHtml = (html) => {
- // Add amp-custom tag to added CSS
- html = html.replace(/<style data-vue-ssr/g, '<style amp-custom data-vue-ssr')
- // Remove every script tag from generated HTML
- html = html.replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, '')
- // Add AMP script before </head>
- const ampScript = '<script async src="https://cdn.ampproject.org/v0.js"></script>'
- html = html.replace('</head>', ampScript + '</head>')
- return html
-}
-
-export default {
- head: {
- meta: [
- { charset: 'utf-8' },
- { name: 'viewport', content: 'width=device-width,minimum-scale=1' }
- ],
- link: [
- { rel: 'canonical', href: '/' },
- { rel: 'stylesheet', href: 'https://fonts.googleapis.com/css?family=Roboto' }
- ]
- },
- css: ['~/assets/main.css'],
- loading: false, // Disable loading bar since AMP will not generate a dynamic page
- render: {
- // Disable resourceHints since we don't load any scripts for AMP
- resourceHints: false
- },
- hooks: {
- // This hook is called before generatic static html files for SPA mode
- 'generate:page': (page) => {
- page.html = modifyHtml(page.html)
- },
- // This hook is called before rendering the html to the browser
- 'render:route': (url, page, { req, res }) => {
- page.html = modifyHtml(page.html)
- }
- }
-}
diff --git a/examples/with-amp/package.json b/examples/with-amp/package.json
deleted file mode 100644
index 999d240f52c9..000000000000
--- a/examples/with-amp/package.json
+++ /dev/null
@@ -1,14 +0,0 @@
-{
- "name": "example-with-amp",
- "version": "1.0.0",
- "dependencies": {
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "generate": "nuxt generate",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/with-amp/pages/dog.vue b/examples/with-amp/pages/dog.vue
deleted file mode 100644
index 1ab9bea4d5b6..000000000000
--- a/examples/with-amp/pages/dog.vue
+++ /dev/null
@@ -1,36 +0,0 @@
-<template>
- <div>
- <h1>The Dog</h1>
- <Byline author="Meow Meow Fuzzyface" />
- <!-- eslint-disable-next-line vue/component-name-in-template-casing -->
- <amp-img src="/dog.jpg" width="470" height="350" layout="responsive" alt="Woof" />
- <p class="caption">
- Woooooooooooof
- </p>
- <p>
- Go to <a href="/">
- the cat
- </a>.
- </p>
- <p>Wafer donut candy soufflé lemon drops icing. Marzipan gummi bears pie danish lollipop pudding powder gummi bears sweet. Pie sweet roll sweet roll topping chocolate bar dragée pudding chocolate cake. Croissant sweet chocolate bar cheesecake candy canes. Tootsie roll icing macaroon bonbon cupcake apple pie candy canes biscuit candy canes. Jujubes jelly liquorice toffee gingerbread. Candy tootsie roll macaroon chocolate bar icing sugar plum pie. Icing gummies chocolate bar chocolate marzipan bonbon cookie chocolate tart. Caramels danish halvah croissant. Cheesecake cookie tootsie roll ice cream. Powder dessert carrot cake muffin tiramisu lemon drops liquorice topping brownie. Soufflé chocolate cake croissant cupcake jelly.</p>
- <p>Muffin gummies dessert cheesecake candy canes. Candy canes danish cotton candy tart dessert powder bear claw marshmallow. Muffin chocolate marshmallow danish. Chocolate bar biscuit cake tiramisu. Topping sweet brownie jujubes powder marzipan. Croissant wafer bonbon chupa chups cake cake marzipan caramels jujubes. Cupcake cheesecake sweet roll marshmallow lollipop danish jujubes jelly icing. Apple pie chupa chups lollipop jelly-o cheesecake jelly beans cake dessert. Tootsie roll tootsie roll bonbon pastry croissant gummi bears cake cake. Fruitcake sugar plum halvah gingerbread cookie pastry chupa chups wafer lemon drops. Marshmallow liquorice oat cake lollipop. Lemon drops oat cake halvah liquorice danish powder cupcake soufflé. Cake tart topping jelly-o tart sugar plum. Chocolate bar cookie wafer tootsie roll candy cotton candy toffee pie donut.</p>
- <p>Ice cream lollipop marshmallow tiramisu jujubes croissant. Bear claw lemon drops marzipan candy bonbon cupcake powder. Candy canes cheesecake bear claw pastry cake donut jujubes. Icing tart jelly-o soufflé bonbon apple pie. Cheesecake pie chupa chups toffee powder. Bonbon lemon drops carrot cake pudding candy halvah cheesecake lollipop cupcake. Pudding marshmallow fruitcake. Gummi bears bonbon chupa chups lemon drops. Wafer dessert gummies gummi bears biscuit donut tiramisu gummi bears brownie. Tootsie roll liquorice bonbon cookie. Sesame snaps chocolate bar cake croissant chupa chups cheesecake gingerbread tiramisu jelly. Cheesecake ice cream muffin lollipop gummies. Sesame snaps jelly beans sweet bear claw tart.</p>
- <p>Sweet topping chupa chups chocolate cake jelly-o liquorice danish. Pastry jelly beans apple pie dessert pastry lemon drops marzipan gummies. Jelly beans macaroon bear claw cotton candy. Toffee sweet lollipop toffee oat cake. Jelly-o oat cake fruitcake chocolate bar sweet. Lemon drops gummies chocolate cake lollipop bear claw croissant danish icing. Chocolate bar donut brownie chocolate cake lemon drops chocolate bar. Cake fruitcake pudding chocolate apple pie. Brownie tiramisu chocolate macaroon lemon drops wafer soufflé jujubes icing. Cheesecake tiramisu cake macaroon tart lollipop donut. Gummi bears dragée pudding bear claw. Muffin cake cupcake candy canes. Soufflé candy canes biscuit. Macaroon gummies danish.</p>
- <p>Cupcake cupcake tart. Cotton candy danish candy canes oat cake ice cream candy canes powder wafer. Chocolate sesame snaps oat cake dragée cheesecake. Sesame snaps marshmallow topping liquorice cookie marshmallow. Liquorice pudding chocolate bar. Cake powder brownie fruitcake. Carrot cake dessert marzipan sugar plum cupcake cheesecake pastry. Apple pie macaroon ice cream fruitcake apple pie cookie. Tootsie roll ice cream oat cake cheesecake donut cheesecake bear claw. Sesame snaps marzipan jelly beans chocolate tootsie roll. Chocolate bar donut dragée ice cream biscuit. Pie candy canes muffin candy canes ice cream tiramisu.</p>
- </div>
-</template>
-
-<script>
-import Byline from '../components/Byline'
-
-export default {
- components: {
- Byline
- },
- head: {
- title: 'The Dog'
- }
-}
-</script>
-
-<!-- You should not write any CSS here, but use ~/assets/main.css instead -->
diff --git a/examples/with-amp/pages/index.vue b/examples/with-amp/pages/index.vue
deleted file mode 100644
index f043ab584ece..000000000000
--- a/examples/with-amp/pages/index.vue
+++ /dev/null
@@ -1,36 +0,0 @@
-<template>
- <div>
- <h1>The Cat</h1>
- <Byline author="Dan Zajdband" />
- <!-- eslint-disable-next-line vue/component-name-in-template-casing -->
- <amp-img src="/cat.jpg" width="470" height="350" layout="responsive" alt="Meow" />
- <p class="caption">
- Meowwwwwwww
- </p>
- <p>
- Go to <a href="/dog">
- the dog
- </a>.
- </p>
- <p>Cat ipsum dolor sit amet, eat grass, throw it back up but refuse to leave cardboard box or groom yourself 4 hours - checked, have your beauty sleep 18 hours - checked, be fabulous for the rest of the day - checked!. Hide from vacuum cleaner. Chirp at birds chew foot chase the pig around the house and meoooow!. Chase ball of string climb a tree, wait for a fireman jump to fireman then scratch his face claw drapes, for meow to be let in yet attack dog, run away and pretend to be victim meow loudly just to annoy owners. Touch water with paw then recoil in horror hide when guests come over, and tuxedo cats always looking dapper so has closed eyes but still sees you or a nice warm laptop for me to sit on pee in human's bed until he cleans the litter box. Steal the warm chair right after you get up cat not kitten around yet claws in your leg eat all the power cords. Lick sellotape curl into a furry donut immediately regret falling into bathtub or you call this cat food? and fall asleep on the washing machine. Purr for no reason hack up furballs and pelt around the house and up and down stairs chasing phantoms. If it smells like fish eat as much as you wish. Unwrap toilet paper chew iPad power cord white cat sleeps on a black shirt lick the other cats. Lounge in doorway mew. Has closed eyes but still sees you sleep on keyboard, so hunt anything that moves lick sellotape but slap owner's face at 5am until human fills food dish if it smells like fish eat as much as you wish. Meow to be let in find empty spot in cupboard and sleep all day and thug cat sit by the fire burrow under covers always hungry. Swat at dog hide when guests come over purrrrrr chew on cable so mark territory, yet howl on top of tall thing or find something else more interesting. Chase mice kitten is playing with dead mouse. Sit and stare if it fits, i sits. Mark territory damn that dog , but step on your keyboard while you're gaming and then turn in a circle put butt in owner's face human give me attention meow or eat and than sleep on your face. Friends are not food jump around on couch, meow constantly until given food, or walk on car leaving trail of paw prints on hood and windshield, and spread kitty litter all over house, going to catch the red dot today going to catch the red dot today. Jump off balcony, onto stranger's head.</p>
- <p>Meow to be let out damn that dog howl uncontrollably for no reason caticus cuteicus for play riveting piece on synthesizer keyboard. Meow loudly just to annoy owners the dog smells bad for eat the fat cats food, yet ignore the squirrels, you'll never catch them anyway cat snacks spread kitty litter all over house or hopped up on catnip. Spit up on light gray carpet instead of adjacent linoleum throwup on your pillow, so cat is love, cat is life yet human is washing you why halp oh the horror flee scratch hiss bite. Chase mice. Swat turds around the house hide at bottom of staircase to trip human. Meowing non stop for food howl on top of tall thing. Shake treat bag pee in human's bed until he cleans the litter box missing until dinner time. Have secret plans climb a tree, wait for a fireman jump to fireman then scratch his face bleghbleghvomit my furball really tie the room together. Chase dog then run away purr shake treat bag spit up on light gray carpet instead of adjacent linoleum but dream about hunting birds. Hiss at vacuum cleaner milk the cow lay on arms while you're using the keyboard sleep in the bathroom sink. Stare at ceiling touch water with paw then recoil in horror or refuse to leave cardboard box. Paw at your fat belly plan steps for world domination for going to catch the red dot today going to catch the red dot today slap owner's face at 5am until human fills food dish scratch at the door then walk away for intrigued by the shower, but steal the warm chair right after you get up. Fall asleep on the washing machine destroy couch as revenge scream at teh bath so love to play with owner's hair tie. Howl uncontrollably for no reason rub whiskers on bare skin act innocent. Cats making all the muffins lick butt and make a weird face meow all night having their mate disturbing sleeping humans human give me attention meow intently stare at the same spot. Sleep on dog bed, force dog to sleep on floor spot something, big eyes, big eyes, crouch, shake butt, prepare to pounce for wake up human for food at 4am or pooping rainbow while flying in a toasted bread costume in space sleep on keyboard put toy mouse in food bowl run out of litter box at full speed . Jump off balcony, onto stranger's head lick butt and make a weird face but go into a room to decide you didn't want to be in there anyway so then cats take over the world, pee in human's bed until he cleans the litter box and if it fits, i sits caticus cuteicus. Eats owners hair then claws head lounge in doorway, and hide when guests come over chase ball of string eat owner's food play riveting piece on synthesizer keyboard. Purrr purr littel cat, little cat purr purr spit up on light gray carpet instead of adjacent linoleum kitty loves pigs yet damn that dog meow or walk on car leaving trail of paw prints on hood and windshield. Roll on the floor purring your whiskers off meow all night having their mate disturbing sleeping humans need to chase tail meow hide when guests come over. Soft kitty warm kitty little ball of furr destroy the blinds meow leave hair everywhere attack dog, run away and pretend to be victim. Going to catch the red dot today going to catch the red dot today instantly break out into full speed gallop across the house for no reason meow so hide when guests come over, yet hide at bottom of staircase to trip human toy mouse squeak roll over claws in your leg. Cat slap dog in face lick plastic bags why must they do that.</p>
- <p>Jump launch to pounce upon little yarn mouse, bare fangs at toy run hide in litter box until treats are fed touch water with paw then recoil in horror then cats take over the world i could pee on this if i had the energy. Lie on your belly and purr when you are asleep toy mouse squeak roll over so stick butt in face you call this cat food? and behind the couch curl up and sleep on the freshly laundered towels yet love to play with owner's hair tie. Knock dish off table head butt cant eat out of my own dish walk on car leaving trail of paw prints on hood and windshield find something else more interesting cats go for world domination, spit up on light gray carpet instead of adjacent linoleum sit in box. Missing until dinner time put toy mouse in food bowl run out of litter box at full speed but poop in the plant pot and nap all day caticus cuteicus. Leave hair everywhere attack feet mrow bleghbleghvomit my furball really tie the room together meowwww eat grass, throw it back up. Hate dog meowzer! find something else more interesting, yet cat snacks, so scratch at the door then walk away chase mice. Chase laser scratch the box plan steps for world domination massacre a bird in the living room and then look like the cutest and most innocent animal on the planet for stare at ceiling light and who's the baby. Stare at ceiling Gate keepers of hell, for licks paws intently sniff hand. Pooping rainbow while flying in a toasted bread costume in space. Gnaw the corn cob. Lick yarn hanging out of own butt stare at ceiling lick butt and make a weird face eat and than sleep on your face. Meow all night having their mate disturbing sleeping humans attack feet, so poop on grasses stare at wall turn and meow stare at wall some more meow again continue staring yet purr. Have my breakfast spaghetti yarn. Cats secretly make all the worlds muffins throwup on your pillow plays league of legends. Lick the plastic bag scratch at the door then walk away. Unwrap toilet paper meow to be let in walk on car leaving trail of paw prints on hood and windshield yet hide from vacuum cleaner or massacre a bird in the living room and then look like the cutest and most innocent animal on the planet. Purr lick the curtain just to be annoying go into a room to decide you didn't want to be in there anyway attack feet, and spit up on light gray carpet instead of adjacent linoleum yet lick plastic bags. Spit up on light gray carpet instead of adjacent linoleum touch water with paw then recoil in horror so cat snacks. Purr. Lick sellotape please stop looking at your phone and pet me yet stick butt in face meow. Groom yourself 4 hours - checked, have your beauty sleep 18 hours - checked, be fabulous for the rest of the day - checked! tuxedo cats always looking dapper but purrrrrr. Claws in your leg i could pee on this if i had the energy. Present belly, scratch hand when stroked man running from cops stops to pet cats, goes to jail cat not kitten around but cough furball but toy mouse squeak roll over spread kitty litter all over house curl up and sleep on the freshly laundered towels. Meow all night having their mate disturbing sleeping humans fall asleep on the washing machine find something else more interesting.</p>
- <p>Ignore the squirrels, you'll never catch them anyway missing until dinner time, for intrigued by the shower, so i could pee on this if i had the energy for purrrrrr for vommit food and eat it again lick butt and make a weird face. Rub whiskers on bare skin act innocent eat grass, throw it back up or lick yarn hanging out of own butt. I am the best cat is love, cat is life, or sleep nap, mew but meoooow!. Meowzer!. Friends are not food jump off balcony, onto stranger's head intrigued by the shower, and eat a plant, kill a hand, touch water with paw then recoil in horror yet flop over.</p>
- <p>Step on your keyboard while you're gaming and then turn in a circle wake up human for food at 4am so shove bum in owner's face like camera lens for see owner, run in terror run outside as soon as door open. Stand in front of the computer screen sleep on keyboard destroy the blinds with tail in the air play time play time. Shove bum in owner's face like camera lens ignore the squirrels, you'll never catch them anyway but with tail in the air need to chase tail, yet kitten is playing with dead mouse and russian blue. Hopped up on catnip refuse to leave cardboard box you call this cat food? walk on car leaving trail of paw prints on hood and windshield. Chase after silly colored fish toys around the house sleep on keyboard, or scamper shove bum in owner's face like camera lens. Groom yourself 4 hours - checked, have your beauty sleep 18 hours - checked, be fabulous for the rest of the day - checked! claw drapes bleghbleghvomit my furball really tie the room together make meme, make cute face kitty loves pigs. Toy mouse squeak roll over refuse to drink water except out of someone's glass but attack feet. Sleep on keyboard. Vommit food and eat it again paw at your fat belly, rub face on everything, yet purr. Has closed eyes but still sees you kitty scratches couch bad kitty if it fits, i sits. Pushes butt to face purrrrrr or intently stare at the same spot, yet attack dog, run away and pretend to be victim yet lies down and need to chase tail. Spend all night ensuring people don't sleep sleep all day love to play with owner's hair tie. I could pee on this if i had the energy lick butt stare out the window. Make meme, make cute face. Chase after silly colored fish toys around the house. Leave fur on owners clothes poop in the plant pot. Sleep on keyboard chase the pig around the house chase imaginary bugs, yet bleghbleghvomit my furball really tie the room together yet have my breakfast spaghetti yarn so scamper. Need to chase tail meow for food, then when human fills food dish, take a few bites of food and continue meowing for pee in the shoe thinking longingly about tuna brine yet purrr purr littel cat, little cat purr purr lie on your belly and purr when you are asleep. Lounge in doorway poop on grasses for lounge in doorway for chew iPad power cord.</p>
- </div>
-</template>
-
-<script>
-import Byline from '~/components/Byline'
-
-export default {
- components: {
- Byline
- },
- head: {
- title: 'The Cat'
- }
-}
-</script>
-
-<!-- You should not write any CSS here, but use ~/assets/main.css instead -->
diff --git a/examples/with-amp/static/cat.jpg b/examples/with-amp/static/cat.jpg
deleted file mode 100644
index bfa51377a3bd..000000000000
Binary files a/examples/with-amp/static/cat.jpg and /dev/null differ
diff --git a/examples/with-amp/static/dog.jpg b/examples/with-amp/static/dog.jpg
deleted file mode 100644
index 3af7918cb578..000000000000
Binary files a/examples/with-amp/static/dog.jpg and /dev/null differ
diff --git a/examples/with-ava/Readme.md b/examples/with-ava/Readme.md
deleted file mode 100755
index 8771714dd668..000000000000
--- a/examples/with-ava/Readme.md
+++ /dev/null
@@ -1,7 +0,0 @@
-# Nuxt with [Ava](https://github.com/avajs/ava)
-
-> AVA is a test runner for Node.js with a concise API, detailed error output, embrace of new language features and process isolation that let you write tests more effectively. So you can ship more awesome code. rocket
-
-## Testing your Nuxt.js Application
-
-https://nuxtjs.org/examples/testing
diff --git a/examples/with-ava/package.json b/examples/with-ava/package.json
deleted file mode 100755
index e5f008dea5fd..000000000000
--- a/examples/with-ava/package.json
+++ /dev/null
@@ -1,17 +0,0 @@
-{
- "name": "example-with-ava",
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "test": "ava --serial --verbose",
- "post-update": "yarn upgrade --latest"
- },
- "devDependencies": {
- "ava": "^0.19.1",
- "jsdom": "^11.0.0"
- },
- "dependencies": {
- "nuxt": "latest"
- }
-}
diff --git a/examples/with-ava/pages/index.vue b/examples/with-ava/pages/index.vue
deleted file mode 100755
index aae596dfe82e..000000000000
--- a/examples/with-ava/pages/index.vue
+++ /dev/null
@@ -1,19 +0,0 @@
-<template>
- <h1 class="red">
- Hello {{ name }}!
- </h1>
-</template>
-
-<script>
-export default {
- data () {
- return { name: 'world' }
- }
-}
-</script>
-
-<style>
-.red {
- color: red;
-}
-</style>
diff --git a/examples/with-ava/test/index.test.js b/examples/with-ava/test/index.test.js
deleted file mode 100755
index fb25e5ec5fd4..000000000000
--- a/examples/with-ava/test/index.test.js
+++ /dev/null
@@ -1,43 +0,0 @@
-import { resolve } from 'path'
-import { Nuxt, Builder } from 'nuxt'
-import { JSDOM } from 'jsdom'
-import test from 'ava'
-
-// We keep the nuxt and server instance
-// So we can close them at the end of the test
-let nuxt = null
-
-// Init Nuxt.js and create a server listening on localhost:4000
-test.before(async () => {
- const config = {
- dev: false,
- rootDir: resolve(__dirname, '..')
- }
- nuxt = new Nuxt(config)
- await new Builder(nuxt).build()
- await nuxt.server.listen(4000, 'localhost')
-}, 30000)
-
-// Example of testing only generated html
-test('Route / exits and render HTML', async (t) => {
- const context = {}
- const { html } = await nuxt.server.renderRoute('/', context)
- t.true(html.includes('<h1 class="red">Hello world!</h1>'))
-})
-
-// Example of testing via dom checking
-test('Route / exits and render HTML with CSS applied', async (t) => {
- const context = {}
- const { html } = await nuxt.server.renderRoute('/', context)
- const { window } = new JSDOM(html).window
- const element = window.document.querySelector('.red')
- t.not(element, null)
- t.is(element.textContent, 'Hello world!')
- t.is(element.className, 'red')
- t.is(window.getComputedStyle(element).color, 'red')
-})
-
-// Close server and ask nuxt to stop listening to file changes
-test.after('Closing server and nuxt.js', (t) => {
- nuxt.close()
-})
diff --git a/examples/with-buefy/README.md b/examples/with-buefy/README.md
deleted file mode 100644
index 160e688e60e4..000000000000
--- a/examples/with-buefy/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Nuxt with [Buefy](https://buefy.github.io/)
-
-> Buefy are lightweight UI components for Vue.js based on Bulma
diff --git a/examples/with-buefy/components/card.vue b/examples/with-buefy/components/card.vue
deleted file mode 100644
index 9c379b1191c0..000000000000
--- a/examples/with-buefy/components/card.vue
+++ /dev/null
@@ -1,42 +0,0 @@
-<template>
- <div class="column">
- <div class="card">
- <header class="card-header">
- <p class="card-header-title has-text-grey">
- {{ title }}
- </p>
- </header>
- <div class="card-content">
- <div class="content has-text-centered">
- <b-icon
- :icon="icon"
- size="is-large"
- type="is-primary"
- />
- </div>
- </div>
- <footer class="card-footer">
- <div class="card-footer-item">
- <span>
- <slot />
- </span>
- </div>
- </footer>
- </div>
- </div>
-</template>
-
-<script>
-export default {
- props: {
- title: {
- type: String,
- required: true
- },
- icon: {
- type: String,
- required: true
- }
- }
-}
-</script>
diff --git a/examples/with-buefy/nuxt.config.js b/examples/with-buefy/nuxt.config.js
deleted file mode 100644
index 663560b91fd1..000000000000
--- a/examples/with-buefy/nuxt.config.js
+++ /dev/null
@@ -1,12 +0,0 @@
-export default {
- /*
- ** Customize the progress bar color
- */
- loading: { color: '#3B8070' },
- modules: [
- 'nuxt-buefy'
- ],
- router: {
- linkActiveClass: 'is-active'
- }
-}
diff --git a/examples/with-buefy/package.json b/examples/with-buefy/package.json
deleted file mode 100644
index 6e5c6241e88e..000000000000
--- a/examples/with-buefy/package.json
+++ /dev/null
@@ -1,16 +0,0 @@
-{
- "name": "example-with-buefy",
- "version": "1.0.0",
- "main": "index.js",
- "license": "MIT",
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- },
- "dependencies": {
- "nuxt": "latest",
- "nuxt-buefy": "latest"
- }
-}
diff --git a/examples/with-buefy/pages/index.vue b/examples/with-buefy/pages/index.vue
deleted file mode 100644
index 9ef1901afb76..000000000000
--- a/examples/with-buefy/pages/index.vue
+++ /dev/null
@@ -1,43 +0,0 @@
-<template>
- <section class="section">
- <div class="columns is-mobile">
- <card
- title="Free"
- icon="github-circle"
- >
- Open source on <a href="https://github.com/buefy/buefy"> GitHub</a>
- </card>
-
- <card
- title="Responsive"
- icon="cellphone-link"
- >
- <b class="has-text-grey">Every</b> component is responsive
- </card>
-
- <card
- title="Modern"
- icon="alert-decagram"
- >
- Built with <a href="https://vuejs.org/">Vue.js</a> and <a href="http://bulma.io/">Bulma</a>
- </card>
-
- <card
- title="Lightweight"
- icon="arrange-bring-to-front"
- >
- No other internal dependency
- </card>
- </div>
- </section>
-</template>
-
-<script>
-import Card from '~/components/Card'
-export default {
- name: 'HomePage',
- components: {
- Card
- }
-}
-</script>
diff --git a/examples/with-cookies/README.md b/examples/with-cookies/README.md
deleted file mode 100644
index 2ca49d4bd16c..000000000000
--- a/examples/with-cookies/README.md
+++ /dev/null
@@ -1,5 +0,0 @@
-# Nuxt with cookies
-
-This demo showcases reading/updating cookies with Nuxt.js
-
-https://nuxtjs.org/examples
diff --git a/examples/with-cookies/nuxt.config.js b/examples/with-cookies/nuxt.config.js
deleted file mode 100644
index 339699b0aabb..000000000000
--- a/examples/with-cookies/nuxt.config.js
+++ /dev/null
@@ -1,9 +0,0 @@
-export default {
- head: {
- title: 'Nuxt-Cookies',
- meta: [
- { content: 'width=device-width,initial-scale=1', name: 'viewport' }
- ]
- },
- plugins: ['~/plugins/cookies']
-}
diff --git a/examples/with-cookies/package.json b/examples/with-cookies/package.json
deleted file mode 100644
index c7b01c606f5b..000000000000
--- a/examples/with-cookies/package.json
+++ /dev/null
@@ -1,14 +0,0 @@
-{
- "name": "example-with-cookies",
- "dependencies": {
- "cookie": "^0.3.1",
- "js-cookie": "^2.1.4",
- "nuxt": "latest",
- "post-update": "yarn upgrade --latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start"
- }
-}
diff --git a/examples/with-cookies/pages/index.vue b/examples/with-cookies/pages/index.vue
deleted file mode 100755
index e69d6cfe71ee..000000000000
--- a/examples/with-cookies/pages/index.vue
+++ /dev/null
@@ -1,85 +0,0 @@
-<template>
- <div>
- <h1>Cookies</h1>
- <table>
- <thead>
- <tr>
- <th>Key</th><th>Value</th><th />
- </tr>
- </thead>
- <tbody>
- <tr v-for="(value, key) in cookies" :key="key">
- <td>{{ key }}</td>
- <td>{{ value }}</td>
- <td>
- <button @click="removeCookie(key)">
- Remove
- </button>
- </td>
- </tr>
- </tbody>
- </table>
- <h2>Add a new cookie</h2>
- <form @submit.prevent="addCookie">
- <input v-model="newCookie.key" type="text" placeholder="Key" class="key">:
- <input v-model="newCookie.value" type="text" placeholder="Value" class="value">
- <button type="submit">
- Add
- </button>
- </form>
- </div>
-</template>
-
-<script>
-export default {
- data: () => ({
- newCookie: {
- key: '',
- value: ''
- }
- }),
- computed: {
- cookies () {
- return this.$cookies.cookies
- }
- },
- methods: {
- addCookie () {
- // Make sure the cookie is not empty
- if (!this.newCookie.key || !this.newCookie.value) { return }
- // Sanitize the key to avoid spaces
- const cookieKey = this.newCookie.key.replace(/\s/g, '-')
- // Add the cookie
- this.$cookies.set(cookieKey, this.newCookie.value)
- // Reset newCookie data
- this.newCookie.key = this.newCookie.value = ''
- },
- removeCookie (key) {
- this.$cookies.remove(key)
- }
- }
-}
-</script>
-
-<style scoped>
-table {
- text-align: left;
-}
-th, td {
- padding-right: 10px;
-}
-input.key {
- width: 50px;
-}
-input.value {
- width: 100px;
-}
-input, button {
- border: 1px #ddd solid;
- background: white;
- padding: 5px;
-}
-button[type="submit"] {
- margin-left: 5px;
-}
-</style>
diff --git a/examples/with-cookies/plugins/cookies.js b/examples/with-cookies/plugins/cookies.js
deleted file mode 100644
index d2925a416528..000000000000
--- a/examples/with-cookies/plugins/cookies.js
+++ /dev/null
@@ -1,34 +0,0 @@
-import Vue from 'vue'
-import Cookie from 'cookie'
-import JSCookie from 'js-cookie'
-
-// Called only on client-side
-export const getCookies = (str) => {
- return Cookie.parse(str || '')
-}
-
-/*
-** Executed by ~/.nuxt/index.js with context given
-** This method can be asynchronous
-*/
-export default ({ req }, inject) => {
- // Inject `cookies` key
- // -> app.$cookies
- // -> this.$cookies in vue components
- // -> this.$cookies in store actions/mutations
- inject('cookies', new Vue({
- data: () => ({
- cookies: getCookies(process.server ? req.headers.cookie : document.cookie)
- }),
- methods: {
- set (...args) {
- JSCookie.set(...args)
- this.cookies = getCookies(document.cookie)
- },
- remove (...args) {
- JSCookie.remove(...args)
- this.cookies = getCookies(document.cookie)
- }
- }
- }))
-}
diff --git a/examples/with-element-ui/README.md b/examples/with-element-ui/README.md
deleted file mode 100644
index 576520270cf4..000000000000
--- a/examples/with-element-ui/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Nuxt with [Element UI](https://element.eleme.io/#/en-US)
-
->Element, a Vue 2.0 based component library for developers, designers and product managers
diff --git a/examples/with-element-ui/layouts/default.vue b/examples/with-element-ui/layouts/default.vue
deleted file mode 100644
index c54893120c49..000000000000
--- a/examples/with-element-ui/layouts/default.vue
+++ /dev/null
@@ -1,10 +0,0 @@
-<template>
- <el-card class="box-card">
- <div slot="header" class="clearfix">
- <span>Element Example</span>
- </div>
- <div>
- <nuxt />
- </div>
- </el-card>
-</template>
diff --git a/examples/with-element-ui/nuxt.config.js b/examples/with-element-ui/nuxt.config.js
deleted file mode 100644
index 29fd3a0b7e29..000000000000
--- a/examples/with-element-ui/nuxt.config.js
+++ /dev/null
@@ -1,15 +0,0 @@
-export default {
- /*
- ** Global CSS
- */
- css: [
- 'element-ui/lib/theme-chalk/index.css'
- ],
-
- /*
- ** Add element-ui in our app, see plugins/element-ui.js file
- */
- plugins: [
- '@/plugins/element-ui'
- ]
-}
diff --git a/examples/with-element-ui/package.json b/examples/with-element-ui/package.json
deleted file mode 100644
index 6dd5c6c8cce5..000000000000
--- a/examples/with-element-ui/package.json
+++ /dev/null
@@ -1,19 +0,0 @@
-{
- "name": "example-with-element-ui",
- "version": "1.0.0",
- "license": "MIT",
- "dependencies": {
- "element-ui": "^2.6.3",
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- },
- "devDependencies": {
- "node-sass": "^4.6.0",
- "sass-loader": "^6.0.6"
- }
-}
diff --git a/examples/with-element-ui/pages/index.vue b/examples/with-element-ui/pages/index.vue
deleted file mode 100644
index f17c376765a1..000000000000
--- a/examples/with-element-ui/pages/index.vue
+++ /dev/null
@@ -1,108 +0,0 @@
-<template>
- <div class="elm-demo">
- <el-form ref="elm-demo" :model="account" :rules="formRules" label-width="100px">
- <el-row type="flex" justify="flex-start">
- <el-col :xs="24" :sm="10">
- <el-form-item label="Account Name" prop="name" required>
- <el-input v-model="account.name" />
- </el-form-item>
- </el-col>
- </el-row>
- <el-row type="flex" justify="flex-start">
- <el-col :xs="24" :sm="10">
- <el-form-item label="Date" prop="date" required>
- <el-date-picker v-model="account.date" style="width: 100%;" />
- </el-form-item>
- </el-col>
- <el-col :xs="24" :sm="{span: 3, offset: 2}">
- <el-form-item label="Subscribe" prop="subscribe">
- <el-switch v-model="account.subscribe" on-text="" off-text="" />
- </el-form-item>
- </el-col>
- </el-row>
- <el-row type="flex" justify="flex-start">
- <el-col :xs="24" :sm="10">
- <el-form-item label="Rate" prop="rate">
- <el-rate v-model="account.rate" :colors="['#99A9BF', '#F7BA2A', '#FF9900']" />
- </el-form-item>
- </el-col>
- <el-col :xs="24" :sm="{span: 10, offset: 2}">
- <el-form-item label="Priority" prop="priority">
- <el-radio-group v-model="account.priority">
- <el-radio label="m">
- Medium
- </el-radio>
- <el-radio label="h">
- High
- </el-radio>
- </el-radio-group>
- </el-form-item>
- </el-col>
- </el-row>
- <el-row type="flex" justify="center">
- <el-button type="primary" @click="submit('elm-demo')">
- Create
- </el-button>
- <el-button @click="reset('elm-demo')">
- Reset
- </el-button>
- </el-row>
- </el-form>
- </div>
-</template>
-
-<script>
-export default {
- data () {
- return {
- account: {
- name: '',
- date: '',
- subscribe: false,
- priority: 'm',
- rate: 5
- },
- formRules: {
- name: [
- { required: true, message: 'Account is required', trigger: 'blur' },
- { min: 6, message: 'Account\'s length is at least 6', trigger: 'blur' }
- ]
- }
- }
- },
- methods: {
- submit (formName) {
- this.$refs[formName].validate((valid) => {
- if (valid) {
- this.$message.success('Create successfully !')
- if (formName === 'popForm') {
- this.popVisible = false
- }
- return false
- } else {
- this.$message.warning('Create failed')
- return false
- }
- })
- },
- reset (formName) {
- this.$refs[formName].resetFields()
- }
- }
-}
-</script>
-
-<style lang="scss" scoped>
-.el-select {
- display: block
-}
-@media (max-width: 768px) {
- .el-row {
- flex-direction:column;
- .el-button+.el-button {
- margin-left: 0px;
- margin-top: 15px;
- }
- }
-}
-</style>
diff --git a/examples/with-element-ui/plugins/element-ui.js b/examples/with-element-ui/plugins/element-ui.js
deleted file mode 100644
index 346f98d67b7a..000000000000
--- a/examples/with-element-ui/plugins/element-ui.js
+++ /dev/null
@@ -1,7 +0,0 @@
-import Vue from 'vue'
-import Element from 'element-ui'
-import locale from 'element-ui/lib/locale/lang/en'
-
-export default () => {
- Vue.use(Element, { locale })
-}
diff --git a/examples/with-feathers/.editorconfig b/examples/with-feathers/.editorconfig
deleted file mode 100644
index e717f5eb6387..000000000000
--- a/examples/with-feathers/.editorconfig
+++ /dev/null
@@ -1,13 +0,0 @@
-# http://editorconfig.org
-root = true
-
-[*]
-indent_style = space
-indent_size = 2
-end_of_line = lf
-charset = utf-8
-trim_trailing_whitespace = true
-insert_final_newline = true
-
-[*.md]
-trim_trailing_whitespace = false
diff --git a/examples/with-feathers/.eslintrc.js b/examples/with-feathers/.eslintrc.js
deleted file mode 100644
index 22c6e9f90888..000000000000
--- a/examples/with-feathers/.eslintrc.js
+++ /dev/null
@@ -1,42 +0,0 @@
-module.exports = {
- root: true,
- parserOptions: {
- parser: 'babel-eslint',
- sourceType: 'module'
- },
- env: {
- browser: true,
- node: true,
- mocha: true
- },
- extends: [
- 'standard',
- 'plugin:vue/recommended'
- ],
- // required to lint *.vue files
- plugins: [
- 'vue'
- ],
- // add your custom rules here
- rules: {
- // allow paren-less arrow functions
- 'arrow-parens': 0,
- // allow async-await
- 'generator-star-spacing': 0,
- // allow debugger during development
- 'no-debugger': process.env.NODE_ENV === 'production' ? 2 : 0,
- // do not allow console.logs etc...
- 'no-console': 2,
- 'space-before-function-paren': [2, {
- anonymous: 'always',
- named: 'never'
- }],
- 'vue/no-parsing-error': [2, {
- 'x-invalid-end-tag': false
- }],
- "vue/max-attributes-per-line": [2, {
- "singleline": 5,
- }]
- },
- globals: {}
-}
diff --git a/examples/with-feathers/.gitignore b/examples/with-feathers/.gitignore
deleted file mode 100644
index 815b7b2a2709..000000000000
--- a/examples/with-feathers/.gitignore
+++ /dev/null
@@ -1,35 +0,0 @@
-# Logs
-logs
-*.log
-
-# Runtime data
-pids
-*.pid
-*.seed
-
-# Directory for instrumented libs generated by jscoverage/JSCover
-lib-cov
-
-# Coverage directory used by tools like istanbul
-coverage
-
-# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
-.grunt
-
-# Compiled binary addons (http://nodejs.org/api/addons.html)
-build/Release
-
-# Dependency directory
-# Commenting this out is preferred by some people, see
-# https://www.npmjs.org/doc/misc/npm-faq.html#should-i-check-my-node_modules-folder-into-git-
-node_modules
-
-# Users Environment Variables
-.lock-wscript
-
-lib/
-data/
-
-# Nuxt
-.nuxt/
-dist/
diff --git a/examples/with-feathers/.jshintrc b/examples/with-feathers/.jshintrc
deleted file mode 100644
index 1c271e2c7faa..000000000000
--- a/examples/with-feathers/.jshintrc
+++ /dev/null
@@ -1,29 +0,0 @@
-{
- "node": true,
- "esnext": true,
- "bitwise": true,
- "camelcase": true,
- "curly": true,
- "eqeqeq": true,
- "immed": true,
- "indent": 2,
- "latedef": "nofunc",
- "newcap": false,
- "noarg": true,
- "quotmark": "single",
- "regexp": true,
- "undef": true,
- "unused": false,
- "strict": false,
- "trailing": true,
- "smarttabs": true,
- "white": false,
- "globals": {
- "it": true,
- "describe": true,
- "before": true,
- "beforeEach": true,
- "after": true,
- "afterEach": true
- }
-}
diff --git a/examples/with-feathers/.npmignore b/examples/with-feathers/.npmignore
deleted file mode 100644
index 40e14ef09172..000000000000
--- a/examples/with-feathers/.npmignore
+++ /dev/null
@@ -1,30 +0,0 @@
-# Logs
-logs
-*.log
-
-# Runtime data
-pids
-*.pid
-*.seed
-
-# Directory for instrumented libs generated by jscoverage/JSCover
-lib-cov
-
-# Coverage directory used by tools like istanbul
-coverage
-
-# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
-.grunt
-
-# Compiled binary addons (http://nodejs.org/api/addons.html)
-build/Release
-
-# Dependency directory
-# Commenting this out is preferred by some people, see
-# https://www.npmjs.org/doc/misc/npm-faq.html#should-i-check-my-node_modules-folder-into-git-
-node_modules
-
-# Users Environment Variables
-.lock-wscript
-
-data/
diff --git a/examples/with-feathers/LICENSE b/examples/with-feathers/LICENSE
deleted file mode 100644
index 40b7881afaca..000000000000
--- a/examples/with-feathers/LICENSE
+++ /dev/null
@@ -1,22 +0,0 @@
-The MIT License (MIT)
-
-Copyright (c) 2015 Feathers
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-
diff --git a/examples/with-feathers/README.md b/examples/with-feathers/README.md
deleted file mode 100644
index 3d4015c48faf..000000000000
--- a/examples/with-feathers/README.md
+++ /dev/null
@@ -1,50 +0,0 @@
-# Nuxt with [Feathers](http://feathersjs.com)
-
-## About
-
-This project uses [Feathers](http://feathersjs.com). An open source web framework for building modern real-time applications.
-
-## Getting Started
-
-Getting up and running is as easy as 1, 2, 3.
-
-1. Make sure you have [NodeJS](https://nodejs.org/) and [npm](https://www.npmjs.com/) installed.
-2. Install your dependencies
-
- ```bash
- npm install
- ```
-
-3. Start your app
-
- ```bash
- npm run dev
- ```
-
-## Production
-
-```bash
-npm run build
-npm start
-```
-
-## Testing
-
-Simply run `npm test` and all your tests in the `test/` directory will be run.
-
-## Scaffolding
-
-Feathers has a powerful command line interface. Here are a few things it can do:
-
-```bash
-$ npm install -g feathers-cli # Install Feathers CLI
-
-$ feathers generate service # Generate a new Service
-$ feathers generate hook # Generate a new Hook
-$ feathers generate model # Generate a new Model
-$ feathers help # Show all commands
-```
-
-## Help
-
-For more information on all the things you can do with Feathers visit [docs.feathersjs.com](http://docs.feathersjs.com).
diff --git a/examples/with-feathers/config/default.json b/examples/with-feathers/config/default.json
deleted file mode 100644
index bb12579e236b..000000000000
--- a/examples/with-feathers/config/default.json
+++ /dev/null
@@ -1,11 +0,0 @@
-{
- "host": "localhost",
- "port": 3000,
- "nedb": "../data/",
- "auth": {
- "token": {
- "secret": "B/UmaCQUlnIn8lNq7h7KjkM5aqlRz+RkiZ/v3cPL72LYavj6d68HtxXfnrb5T70mdZxHjPNsNfBR7YE1sE6Hdg=="
- },
- "local": {}
- }
-}
diff --git a/examples/with-feathers/config/production.json b/examples/with-feathers/config/production.json
deleted file mode 100644
index 6690c58474b7..000000000000
--- a/examples/with-feathers/config/production.json
+++ /dev/null
@@ -1,11 +0,0 @@
-{
- "host": "with-featherjs-app.feathersjs.com",
- "port": 80,
- "nedb": "NEDB_BASE_PATH",
- "auth": {
- "token": {
- "secret": "FEATHERS_AUTH_SECRET"
- },
- "local": {}
- }
-}
diff --git a/examples/with-feathers/nuxt.config.js b/examples/with-feathers/nuxt.config.js
deleted file mode 100644
index 5fadcc875cc8..000000000000
--- a/examples/with-feathers/nuxt.config.js
+++ /dev/null
@@ -1,5 +0,0 @@
-export default {
- loading: {
- color: 'purple'
- }
-}
diff --git a/examples/with-feathers/package.json b/examples/with-feathers/package.json
deleted file mode 100644
index f742b4cd5fbe..000000000000
--- a/examples/with-feathers/package.json
+++ /dev/null
@@ -1,47 +0,0 @@
-{
- "name": "example-with-feathers",
- "description": "Nuxt.js with FeathersJS",
- "version": "1.0.0",
- "main": "src/",
- "keywords": [
- "feathers"
- ],
- "license": "MIT",
- "repository": {},
- "author": {},
- "contributors": [],
- "bugs": {},
- "scripts": {
- "test": "npm run jshint && npm run mocha",
- "jshint": "jshint src/. test/. --config",
- "dev": "DEBUG=nuxt:* nodemon --watch src/ --watch config/ src/index.js",
- "build": "nuxt build",
- "start": "NODE_ENV=production node src/",
- "mocha": "mocha test/ --recursive --timeout=30000",
- "post-update": "yarn upgrade --latest"
- },
- "dependencies": {
- "body-parser": "^1.15.2",
- "compression": "^1.6.2",
- "cors": "^2.8.1",
- "feathers": "^2.0.3",
- "feathers-authentication": "^0.7.12",
- "feathers-configuration": "^0.3.3",
- "feathers-errors": "^2.5.0",
- "feathers-hooks": "^1.7.1",
- "feathers-nedb": "^2.6.0",
- "feathers-rest": "^1.6.0",
- "feathers-socketio": "^1.4.2",
- "nedb": "^1.8.0",
- "nuxt": "latest",
- "passport": "^0.3.2",
- "winston": "^2.3.0"
- },
- "devDependencies": {
- "eslint-plugin-mocha": "^4.11.0",
- "jshint": "^2.9.4",
- "mocha": "^3.2.0",
- "nodemon": "^1.11.0",
- "request": "^2.79.0"
- }
-}
diff --git a/examples/with-feathers/pages/about.vue b/examples/with-feathers/pages/about.vue
deleted file mode 100644
index 3cb15affecc0..000000000000
--- a/examples/with-feathers/pages/about.vue
+++ /dev/null
@@ -1,18 +0,0 @@
-<template>
- <div>
- <p>Hi from {{ name }}</p>
- <NuxtLink to="/">
- Home page
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- asyncData() {
- return {
- name: process.server ? 'server' : 'client'
- }
- }
-}
-</script>
diff --git a/examples/with-feathers/pages/index.vue b/examples/with-feathers/pages/index.vue
deleted file mode 100644
index 74922a35273a..000000000000
--- a/examples/with-feathers/pages/index.vue
+++ /dev/null
@@ -1,8 +0,0 @@
-<template>
- <div>
- <h1>Welcome!</h1>
- <NuxtLink to="/about">
- About page
- </NuxtLink>
- </div>
-</template>
diff --git a/examples/with-feathers/src/app.js b/examples/with-feathers/src/app.js
deleted file mode 100644
index c8d255a22044..000000000000
--- a/examples/with-feathers/src/app.js
+++ /dev/null
@@ -1,28 +0,0 @@
-import path from 'path'
-import compress from 'compression'
-import cors from 'cors'
-import feathers from 'feathers'
-import configuration from 'feathers-configuration'
-import hooks from 'feathers-hooks'
-import rest from 'feathers-rest'
-import bodyParser from 'body-parser'
-import socketio from 'feathers-socketio'
-import middleware from './middleware'
-import services from './services'
-
-const app = feathers()
-
-app.configure(configuration(path.join(__dirname, '..')))
-
-app.use(compress())
- .options('*', cors())
- .use(cors())
- .use(bodyParser.json())
- .use(bodyParser.urlencoded({ extended: true }))
- .configure(hooks())
- .configure(rest())
- .configure(socketio())
- .configure(services)
- .configure(middleware)
-
-export default app
diff --git a/examples/with-feathers/src/hooks/index.js b/examples/with-feathers/src/hooks/index.js
deleted file mode 100644
index 9f64020c757b..000000000000
--- a/examples/with-feathers/src/hooks/index.js
+++ /dev/null
@@ -1,11 +0,0 @@
-// Add any common hooks you want to share across services in here.
-//
-// Below is an example of how a hook is written and exported. Please
-// see http://docs.feathersjs.com/hooks/readme.html for more details
-// on hooks.
-
-export function myHook(options) {
- return function (hook) {
- console.log('My custom global hook ran. Feathers is awesome!') // eslint-disable-line no-console
- }
-}
diff --git a/examples/with-feathers/src/index.js b/examples/with-feathers/src/index.js
deleted file mode 100644
index 07d0202e1b1a..000000000000
--- a/examples/with-feathers/src/index.js
+++ /dev/null
@@ -1,14 +0,0 @@
-import app from './app'
-
-const port = app.get('port')
-
-process.on('nuxt:build:done', (err) => {
- if (err) {
- console.error(err) // eslint-disable-line no-console
- process.exit(1)
- }
- const server = app.listen(port)
- server.on('listening', () =>
- console.log(`Feathers application started on ${app.get('host')}:${port}`) // eslint-disable-line no-console
- )
-})
diff --git a/examples/with-feathers/src/middleware/index.js b/examples/with-feathers/src/middleware/index.js
deleted file mode 100644
index 64a383c6e182..000000000000
--- a/examples/with-feathers/src/middleware/index.js
+++ /dev/null
@@ -1,10 +0,0 @@
-import nuxt from './nuxt'
-
-export default function () {
- // Add your custom middleware here. Remember, that
- // just like Express the order matters, so error
- // handling middleware should go last.
- const app = this
-
- app.use(nuxt)
-}
diff --git a/examples/with-feathers/src/middleware/nuxt.js b/examples/with-feathers/src/middleware/nuxt.js
deleted file mode 100644
index 91f809aa6e6f..000000000000
--- a/examples/with-feathers/src/middleware/nuxt.js
+++ /dev/null
@@ -1,23 +0,0 @@
-import { resolve } from 'path'
-import { Nuxt, Builder } from 'nuxt'
-
-// Setup nuxt.js
-let config = {}
-try {
- config = require('../../nuxt.config.js')
-} catch (e) {}
-config.rootDir = resolve(__dirname, '..', '..')
-config.dev = process.env.NODE_ENV !== 'production'
-
-const nuxt = new Nuxt(config)
-if (config.dev) {
- const builder = new Builder(nuxt)
- builder.build().then(() => process.emit('nuxt:build:done'))
-} else {
- process.nextTick(() => process.emit('nuxt:build:done'))
-}
-
-// Add nuxt.js middleware
-export default function (req, res) {
- nuxt.render(req, res)
-}
diff --git a/examples/with-feathers/src/services/authentication/index.js b/examples/with-feathers/src/services/authentication/index.js
deleted file mode 100644
index bba5d4f8594a..000000000000
--- a/examples/with-feathers/src/services/authentication/index.js
+++ /dev/null
@@ -1,9 +0,0 @@
-import authentication from 'feathers-authentication'
-
-export default function () {
- const app = this
-
- const config = app.get('auth')
-
- app.configure(authentication(config))
-}
diff --git a/examples/with-feathers/src/services/index.js b/examples/with-feathers/src/services/index.js
deleted file mode 100644
index a09ac9b3742f..000000000000
--- a/examples/with-feathers/src/services/index.js
+++ /dev/null
@@ -1,9 +0,0 @@
-import authentication from './authentication'
-import user from './user'
-
-export default function () {
- const app = this
-
- app.configure(authentication)
- app.configure(user)
-}
diff --git a/examples/with-feathers/src/services/user/hooks/index.js b/examples/with-feathers/src/services/user/hooks/index.js
deleted file mode 100644
index 3ecc6e074d4b..000000000000
--- a/examples/with-feathers/src/services/user/hooks/index.js
+++ /dev/null
@@ -1,50 +0,0 @@
-import hooks from 'feathers-hooks'
-import { hooks as auth } from 'feathers-authentication'
-
-require('../../../hooks')
-
-exports.before = {
- all: [],
- find: [
- auth.verifyToken(),
- auth.populateUser(),
- auth.restrictToAuthenticated()
- ],
- get: [
- auth.verifyToken(),
- auth.populateUser(),
- auth.restrictToAuthenticated(),
- auth.restrictToOwner({ ownerField: '_id' })
- ],
- create: [
- auth.hashPassword()
- ],
- update: [
- auth.verifyToken(),
- auth.populateUser(),
- auth.restrictToAuthenticated(),
- auth.restrictToOwner({ ownerField: '_id' })
- ],
- patch: [
- auth.verifyToken(),
- auth.populateUser(),
- auth.restrictToAuthenticated(),
- auth.restrictToOwner({ ownerField: '_id' })
- ],
- remove: [
- auth.verifyToken(),
- auth.populateUser(),
- auth.restrictToAuthenticated(),
- auth.restrictToOwner({ ownerField: '_id' })
- ]
-}
-
-exports.after = {
- all: [hooks.remove('password')],
- find: [],
- get: [],
- create: [],
- update: [],
- patch: [],
- remove: []
-}
diff --git a/examples/with-feathers/src/services/user/index.js b/examples/with-feathers/src/services/user/index.js
deleted file mode 100644
index 1367c59a34d4..000000000000
--- a/examples/with-feathers/src/services/user/index.js
+++ /dev/null
@@ -1,33 +0,0 @@
-import path from 'path'
-import NeDB from 'nedb'
-import service from 'feathers-nedb'
-import hooks from './hooks'
-
-export default function () {
- const app = this
-
- const db = new NeDB({
- filename: path.join(app.get('nedb'), 'users.db'),
- autoload: true
- })
-
- const options = {
- Model: db,
- paginate: {
- default: 5,
- max: 25
- }
- }
-
- // Initialize our service with any options it requires
- app.use('/users', service(options))
-
- // Get our initialize service to that we can bind hooks
- const userService = app.service('/users')
-
- // Set up our before hooks
- userService.before(hooks.before)
-
- // Set up our after hooks
- userService.after(hooks.after)
-}
diff --git a/examples/with-feathers/static/favicon.ico b/examples/with-feathers/static/favicon.ico
deleted file mode 100644
index 7ed25a60b049..000000000000
Binary files a/examples/with-feathers/static/favicon.ico and /dev/null differ
diff --git a/examples/with-feathers/test/app.test.js b/examples/with-feathers/test/app.test.js
deleted file mode 100644
index 56bbcdfbbf0c..000000000000
--- a/examples/with-feathers/test/app.test.js
+++ /dev/null
@@ -1,36 +0,0 @@
-import assert from 'assert'
-import request from 'request'
-import app from '../src/app'
-
-describe('Feathers application tests', function () {
- before(function (done) {
- this.server = app.listen(3030)
- this.server.once('listening', done)
- })
-
- after(function (done) {
- this.server.close(done)
- })
-
- it('starts and shows the index page', function (done) {
- request('http://localhost:3030', function (err, res, body) {
- assert.ok(body.indexOf('<h1>Welcome!</h1>') !== -1)
- done(err)
- })
- })
-
- describe('404', function () {
- it('shows a 404 HTML page', function (done) {
- request({
- url: 'http://localhost:3030/path/to/nowhere',
- headers: {
- Accept: 'text/html'
- }
- }, function (err, res, body) {
- assert.strictEqual(res.statusCode, 404)
- assert.ok(body.indexOf('This page could not be found.') !== -1)
- done(err)
- })
- })
- })
-})
diff --git a/examples/with-feathers/test/services/user/index.test.js b/examples/with-feathers/test/services/user/index.test.js
deleted file mode 100644
index d6b4df626480..000000000000
--- a/examples/with-feathers/test/services/user/index.test.js
+++ /dev/null
@@ -1,8 +0,0 @@
-import assert from 'assert'
-import app from '../../../src/app'
-
-describe('user service', function () {
- it('registered the users service', () => {
- assert.ok(app.service('users'))
- })
-})
diff --git a/examples/with-firebase/.gitignore b/examples/with-firebase/.gitignore
deleted file mode 100644
index a77c238f1c12..000000000000
--- a/examples/with-firebase/.gitignore
+++ /dev/null
@@ -1,2 +0,0 @@
-node_modules
-.nuxt
diff --git a/examples/with-firebase/README.md b/examples/with-firebase/README.md
deleted file mode 100644
index 74b2528687b2..000000000000
--- a/examples/with-firebase/README.md
+++ /dev/null
@@ -1,29 +0,0 @@
-# Nuxt with [Firebase](https://firebase.google.com/) (REST API)
-
-[DEMO](https://nuxt-firebase.now.sh/)
-
-## About
-
-This project uses [Firebase](https://firebase.google.com/). The tools and infrastructure you need to build better apps and grow successful businesses.
-
-You can view the Firebase data at [https://nuxt-firebase.firebaseio.com/.json](https://nuxt-firebase.firebaseio.com/.json). This is what the App will consume.
-
-## Getting Started
-
-Download this example [or clone the repo](https://github.com/nuxt/nuxt.js):
-
-```bash
-curl https://codeload.github.com/nuxt/nuxt.js/tar.gz/master | tar -xz --strip=2 nuxt.js-master/examples/with-firebase
-cd with-firebase
-```
-
-Install and run:
-
-```bash
-npm install
-npm run dev
-
-# or with Yarn
-yarn
-yarn dev
-```
diff --git a/examples/with-firebase/layouts/default.vue b/examples/with-firebase/layouts/default.vue
deleted file mode 100644
index e282e55be6b4..000000000000
--- a/examples/with-firebase/layouts/default.vue
+++ /dev/null
@@ -1,29 +0,0 @@
-<template>
- <div class="container">
- <div class="header">
- <nav>
- <h1 @click="$router.push('/')">
- Nuxt.js + Firebase
- </h1>
- </nav>
- </div>
- <Nuxt />
- </div>
-</template>
-
-<style>
-
-body {
- padding-top: 1.5rem;
-}
-
-nav {
- padding: 1.5rem 0;
-}
-
-h1 {
- cursor: pointer;
- display: inline-block;
-}
-
-</style>
diff --git a/examples/with-firebase/nuxt.config.js b/examples/with-firebase/nuxt.config.js
deleted file mode 100644
index ddb39cc36026..000000000000
--- a/examples/with-firebase/nuxt.config.js
+++ /dev/null
@@ -1,11 +0,0 @@
-export default {
- head: {
- meta: [
- { charset: 'utf-8' },
- { name: 'viewport', content: 'width=device-width, initial-scale=1' }
- ],
- link: [
- { rel: 'stylesheet', href: 'https://maxcdn.bootstrapcdn.com/bootstrap/4.0.0-alpha.6/css/bootstrap.min.css' }
- ]
- }
-}
diff --git a/examples/with-firebase/package.json b/examples/with-firebase/package.json
deleted file mode 100644
index efd7ba441a99..000000000000
--- a/examples/with-firebase/package.json
+++ /dev/null
@@ -1,21 +0,0 @@
-{
- "name": "example-with-firebase",
- "version": "1.0.0",
- "description": "Nuxt.js with Firebase",
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- },
- "keywords": [
- "nuxt",
- "firebase"
- ],
- "author": "Charlie Hield",
- "license": "MIT",
- "dependencies": {
- "axios": "^0.19.0",
- "nuxt": "latest"
- }
-}
diff --git a/examples/with-firebase/pages/index.vue b/examples/with-firebase/pages/index.vue
deleted file mode 100644
index 65e12e88050c..000000000000
--- a/examples/with-firebase/pages/index.vue
+++ /dev/null
@@ -1,41 +0,0 @@
-<template>
- <div>
- <table class="table table-bordered">
- <thead>
- <tr>
- <th>Avatar</th>
- <th>Name</th>
- <th>Title</th>
- <th>Profile</th>
- </tr>
- </thead>
- <tbody>
- <tr v-for="(user, key) in users" :key="key">
- <td>
- <NuxtLink :to="{ path: `/users/${key}`}">
- <img :src="user.avatar" class="rounded" alt="avatar">
- </NuxtLink>
- </td>
- <td>{{ user.name }}</td>
- <td>{{ user.title }}</td>
- <td>
- <NuxtLink :to="{ path: `/users/${key}`}">
- View profile →
- </NuxtLink>
- </td>
- </tr>
- </tbody>
- </table>
- </div>
-</template>
-
-<script>
-import axios from '~/plugins/axios'
-
-export default {
- async asyncData () {
- const { data: users } = await axios.get('users.json')
- return { users }
- }
-}
-</script>
diff --git a/examples/with-firebase/pages/users/_key.vue b/examples/with-firebase/pages/users/_key.vue
deleted file mode 100644
index 0e3ffb24a289..000000000000
--- a/examples/with-firebase/pages/users/_key.vue
+++ /dev/null
@@ -1,31 +0,0 @@
-<template>
- <div class="card" style="width: 20rem;">
- <div class="card-block">
- <img :src="user.avatar" class="rounded" alt="avatar"> <br><br>
- <h4 class="card-title">
- {{ user.name }}
- </h4>
- <h6 class="card-subtitle mb-2 text-muted">
- {{ user.title }}
- </h6>
- <p class="card-text">
- {{ user.description }}
- </p>
- <a href="#" class="btn btn-primary">
- Hire {{ user.name.split(' ')[0] }}
- </a>
- </div>
- </div>
-</template>
-
-<script>
-import axios from '~/plugins/axios'
-
-export default {
- async asyncData ({ route }) {
- const { key } = route.params
- const { data: user } = await axios.get(`users/${key}.json`)
- return { user }
- }
-}
-</script>
diff --git a/examples/with-firebase/plugins/axios.js b/examples/with-firebase/plugins/axios.js
deleted file mode 100644
index 9e99293f7199..000000000000
--- a/examples/with-firebase/plugins/axios.js
+++ /dev/null
@@ -1,5 +0,0 @@
-import axios from 'axios'
-
-export default axios.create({
- baseURL: 'https://nuxt-firebase.firebaseio.com'
-})
diff --git a/examples/with-keep-alive/README.md b/examples/with-keep-alive/README.md
deleted file mode 100644
index 46d80338464b..000000000000
--- a/examples/with-keep-alive/README.md
+++ /dev/null
@@ -1,15 +0,0 @@
-# `<keep-alive>` with Nuxt.js
-
-Introduced in v1.2.0, you can add the `keep-alive` prop to `<Nuxt/>` or `<NuxtChild/>` to "keep alive" the pages.
-
-`layouts/default.vue`:
-
-```vue
-<template>
- <Nuxt keep-alive/>
-</template>
-```
-
-Screenshot:
-
-
diff --git a/examples/with-keep-alive/layouts/default.vue b/examples/with-keep-alive/layouts/default.vue
deleted file mode 100644
index fb1a815fa157..000000000000
--- a/examples/with-keep-alive/layouts/default.vue
+++ /dev/null
@@ -1,3 +0,0 @@
-<template>
- <Nuxt keep-alive />
-</template>
diff --git a/examples/with-keep-alive/package.json b/examples/with-keep-alive/package.json
deleted file mode 100644
index 9aa427ac1ec5..000000000000
--- a/examples/with-keep-alive/package.json
+++ /dev/null
@@ -1,12 +0,0 @@
-{
- "name": "example-with-keep-alive",
- "dependencies": {
- "nuxt": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/with-keep-alive/pages/about.vue b/examples/with-keep-alive/pages/about.vue
deleted file mode 100755
index 2830db4f5202..000000000000
--- a/examples/with-keep-alive/pages/about.vue
+++ /dev/null
@@ -1,21 +0,0 @@
-<template>
- <div>
- <p>Hi from {{ name }}</p>
- <NuxtLink to="/">
- Home page
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- asyncData () {
- return {
- name: process.static ? 'static' : (process.server ? 'server' : 'client')
- }
- },
- head: {
- title: 'About page'
- }
-}
-</script>
diff --git a/examples/with-keep-alive/pages/index.vue b/examples/with-keep-alive/pages/index.vue
deleted file mode 100755
index dbb2b0586886..000000000000
--- a/examples/with-keep-alive/pages/index.vue
+++ /dev/null
@@ -1,16 +0,0 @@
-<template>
- <div>
- <h1>Welcome!</h1>
- <NuxtLink to="/about">
- About page
- </NuxtLink>
- </div>
-</template>
-
-<script>
-export default {
- head: {
- title: 'Home page'
- }
-}
-</script>
diff --git a/examples/with-museui/README.md b/examples/with-museui/README.md
deleted file mode 100644
index 35d99400ad19..000000000000
--- a/examples/with-museui/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Nuxt with [Muse-UI](https://muse-ui.org/#/en-US/)
-
-> Muse-UI is an elegant Material Design UI component library based on the Vue 2.0
diff --git a/examples/with-museui/nuxt.config.js b/examples/with-museui/nuxt.config.js
deleted file mode 100644
index 1c13f5c91b8f..000000000000
--- a/examples/with-museui/nuxt.config.js
+++ /dev/null
@@ -1,26 +0,0 @@
-export default {
- head: {
- meta: [
- {
- name: 'viewport',
- content: 'width=device-width, initial-scale=1'
- }
- ],
- link: [
- {
- rel: 'stylesheet',
- href:
- 'https://fonts.googleapis.com/css?family=Roboto:300,400,500,700,400italic'
- },
- {
- rel: 'stylesheet',
- href: 'https://fonts.googleapis.com/icon?family=Material+Icons'
- },
- {
- rel: 'stylesheet',
- href: 'https://unpkg.com/muse-ui@2.1.0/dist/muse-ui.css'
- }
- ]
- },
- plugins: ['~/plugins/museui']
-}
diff --git a/examples/with-museui/package.json b/examples/with-museui/package.json
deleted file mode 100644
index fb60a2449d06..000000000000
--- a/examples/with-museui/package.json
+++ /dev/null
@@ -1,13 +0,0 @@
-{
- "name": "example-with-museui",
- "dependencies": {
- "nuxt": "latest",
- "muse-ui": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/with-museui/pages/index.vue b/examples/with-museui/pages/index.vue
deleted file mode 100644
index e790fb569424..000000000000
--- a/examples/with-museui/pages/index.vue
+++ /dev/null
@@ -1,43 +0,0 @@
-<template>
- <div>
- <mu-appbar title="Nuxt.js">
- <mu-icon-button slot="left" icon="menu" @click="toggle()" />
- <mu-icon-menu slot="right" icon="expand_more">
- <mu-menu-item value="1" title="One" />
- <mu-menu-item value="2" title="Two" />
- <mu-menu-item value="3" title="Three" />
- </mu-icon-menu>
- </mu-appbar>
- <mu-drawer :open="open" :docked="false" @close="toggle()">
- <mu-list>
- <mu-list-item title="Menu Item 1" />
- <mu-list-item title="Menu Item 2" />
- <mu-list-item title="Menu Item 3" />
- </mu-list>
- </mu-drawer>
- <div class="content">
- <mu-raised-button label="Primary" class="demo-raised-button" primary />
- </div>
- </div>
-</template>
-
-<script>
-export default {
- data () {
- return {
- open: false
- }
- },
- methods: {
- toggle (flag) {
- this.open = !this.open
- }
- }
-}
-</script>
-
-<style>
-.content {
- margin: 10px
-}
-</style>
diff --git a/examples/with-museui/plugins/museui.js b/examples/with-museui/plugins/museui.js
deleted file mode 100644
index 623286c123ec..000000000000
--- a/examples/with-museui/plugins/museui.js
+++ /dev/null
@@ -1,4 +0,0 @@
-import Vue from 'vue'
-import MuseUI from 'muse-ui'
-
-Vue.use(MuseUI)
diff --git a/examples/with-purgecss/README.md b/examples/with-purgecss/README.md
deleted file mode 100644
index 7991de5b5d4a..000000000000
--- a/examples/with-purgecss/README.md
+++ /dev/null
@@ -1,6 +0,0 @@
-# Nuxt.js with [Purgecss](https://www.purgecss.com/) (and [Tailwind CSS](https://tailwindcss.com))
-
-> *Tailwind CSS* is a utility-first CSS framework for rapidly building custom user interfaces.
-
-
-> *Purgecss* is a tool to remove unused CSS. It can be used as part of your development workflow. Purgecss comes with a JavaScript API, a CLI, and plugins for popular build tools.
diff --git a/examples/with-purgecss/assets/css/tailwind.css b/examples/with-purgecss/assets/css/tailwind.css
deleted file mode 100644
index d44c6d8c2c4a..000000000000
--- a/examples/with-purgecss/assets/css/tailwind.css
+++ /dev/null
@@ -1,57 +0,0 @@
-/**
- * This injects Tailwind's base styles, which is a combination of
- * Normalize.css and some additional base styles.
- *
- * You can see the styles here:
- * https://github.com/tailwindcss/tailwindcss/blob/master/css/preflight.css
- *
- * If using `postcss-import`, you should import this line from it's own file:
- *
- * @import "./tailwind-preflight.css";
- *
- * See: https://github.com/tailwindcss/tailwindcss/issues/53#issuecomment-341413622
- */
- @tailwind preflight;
-
- /**
- * Here you would add any of your custom component classes; stuff that you'd
- * want loaded *before* the utilities so that the utilities could still
- * override them.
- *
- * Example:
- *
- * .btn { ... }
- * .form-input { ... }
- *
- * Or if using a preprocessor or `postcss-import`:
- *
- * @import "components/buttons";
- * @import "components/forms";
- */
-
- /**
- * This injects all of Tailwind's utility classes, generated based on your
- * config file.
- *
- * If using `postcss-import`, you should import this line from it's own file:
- *
- * @import "./tailwind-utilities.css";
- *
- * See: https://github.com/tailwindcss/tailwindcss/issues/53#issuecomment-341413622
- */
- @tailwind utilities;
-
- /**
- * Here you would add any custom utilities you need that don't come out of the
- * box with Tailwind.
- *
- * Example :
- *
- * .bg-pattern-graph-paper { ... }
- * .skew-45 { ... }
- *
- * Or if using a preprocessor or `postcss-import`:
- *
- * @import "utilities/background-patterns";
- * @import "utilities/skew-transforms";
- */
\ No newline at end of file
diff --git a/examples/with-purgecss/layouts/default.vue b/examples/with-purgecss/layouts/default.vue
deleted file mode 100644
index 750ea7d80b44..000000000000
--- a/examples/with-purgecss/layouts/default.vue
+++ /dev/null
@@ -1,14 +0,0 @@
-<template>
- <!-- See https://tailwindcss.com/docs/container -->
- <div class="container mx-auto">
- <Nuxt />
- <a href="https://github.com/nuxt/nuxt.js/tree/dev/examples/with-purgecss" class="inline-flex items-center no-underline mt-4 rounded-full border border-grey-light bg-grey-lightest text-xs text-grey-darkest font-semibold p-2">
- <span class="inline-flex rounded-full mr-1">
- <svg class="h-4 w-4" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
- <path d="M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.73.084-.73 1.205.085 1.838 1.237 1.838 1.237 1.07 1.835 2.81 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.136-.303-.54-1.523.104-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.4 3-.405 1.02.005 2.04.137 3 .404 2.28-1.552 3.285-1.23 3.285-1.23.644 1.653.24 2.873.12 3.176.764.84 1.23 1.91 1.23 3.22 0 4.61-2.806 5.625-5.476 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.824.57 4.8-1.574 8.236-6.074 8.236-11.37 0-6.626-5.373-12-12-12" />
- </svg>
- </span>
- <span>Source code</span>
- </a>
- </div>
-</template>
diff --git a/examples/with-purgecss/nuxt.config.js b/examples/with-purgecss/nuxt.config.js
deleted file mode 100644
index 0ca2b9d09379..000000000000
--- a/examples/with-purgecss/nuxt.config.js
+++ /dev/null
@@ -1,44 +0,0 @@
-import path from 'path'
-import PurgecssPlugin from 'purgecss-webpack-plugin'
-import glob from 'glob-all'
-
-class TailwindExtractor {
- static extract (content) {
- return content.match(/[A-Za-z0-9-:/]+/g) || []
- }
-}
-
-export default {
- build: {
- extractCSS: true,
- postcss: {
- plugins: {
- tailwindcss: path.resolve('./tailwind.js')
- },
- preset: { autoprefixer: { grid: true } }
- },
- extend (config, { isDev }) {
- if (!isDev) {
- config.plugins.push(
- new PurgecssPlugin({
- // purgecss configuration
- // https://github.com/FullHuman/purgecss
- paths: glob.sync([
- path.join(__dirname, './pages/**/*.vue'),
- path.join(__dirname, './layouts/**/*.vue'),
- path.join(__dirname, './components/**/*.vue')
- ]),
- extractors: [
- {
- extractor: TailwindExtractor,
- extensions: ['vue']
- }
- ],
- whitelist: ['html', 'body', 'nuxt-progress']
- })
- )
- }
- }
- },
- css: ['~/assets/css/tailwind.css']
-}
diff --git a/examples/with-purgecss/package.json b/examples/with-purgecss/package.json
deleted file mode 100644
index 4807507df879..000000000000
--- a/examples/with-purgecss/package.json
+++ /dev/null
@@ -1,18 +0,0 @@
-{
- "name": "example-with-purgecss",
- "description": "Nuxt.js with Tailwind CSS",
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- },
- "dependencies": {
- "nuxt": "latest"
- },
- "devDependencies": {
- "glob-all": "^3.1.0",
- "purgecss-webpack-plugin": "^0.20.1",
- "tailwindcss": "^0.1.3"
- }
-}
diff --git a/examples/with-purgecss/pages/about.vue b/examples/with-purgecss/pages/about.vue
deleted file mode 100644
index 7c69c23f4f8e..000000000000
--- a/examples/with-purgecss/pages/about.vue
+++ /dev/null
@@ -1,21 +0,0 @@
-<template>
- <div>
- <div class="mt-4 bg-orange-lightest border-l-4 border-orange text-orange-dark p-4">
- <p class="font-bold">
- Be Warned!
- </p>
- <p>This page has been {{ mode }}-side rendered!</p>
- </div>
- <button class="mt-4 bg-blue hover:bg-blue-light text-white font-bold py-2 px-4 border-b-4 border-blue-dark hover:border-blue rounded" @click="$router.push('/')">
- Back to home
- </button>
- </div>
-</template>
-
-<script>
-export default {
- asyncData: () => ({
- mode: (process.server ? 'server' : 'client')
- })
-}
-</script>
diff --git a/examples/with-purgecss/pages/index.vue b/examples/with-purgecss/pages/index.vue
deleted file mode 100644
index 5c633c2b9f41..000000000000
--- a/examples/with-purgecss/pages/index.vue
+++ /dev/null
@@ -1,29 +0,0 @@
-<template>
- <div>
- <div class="max-w-sm mt-4 rounded overflow-hidden shadow-lg">
- <img class="w-full" src="https://tailwindcss.com/img/card-top.jpg">
- <div class="px-6 py-4">
- <div class="font-bold text-xl mb-2">
- The Coldest Sunset
- </div>
- <p class="text-slate text-base">
- Lorem ipsum dolor sit amet, consectetur adipisicing elit. Voluptatibus quia, nulla! Maiores et perferendis eaque, exercitationem praesentium nihil.
- </p>
- </div>
- <div class="px-6 py-4">
- <span class="inline-block bg-grey-lighter rounded-full px-3 py-1 text-sm font-semibold text-slate mr-2">
- #photography
- </span>
- <span class="inline-block bg-grey-lighter rounded-full px-3 py-1 text-sm font-semibold text-slate mr-2">
- #travel
- </span>
- <span class="inline-block bg-grey-lighter rounded-full px-3 py-1 text-sm font-semibold text-slate">
- #winter
- </span>
- </div>
- </div>
- <button class="bg-blue mt-4 hover:bg-blue-dark text-white font-bold py-2 px-4 rounded" @click="$router.push('/about')">
- About
- </button>
- </div>
-</template>
diff --git a/examples/with-purgecss/tailwind.js b/examples/with-purgecss/tailwind.js
deleted file mode 100644
index ad8978a24c4e..000000000000
--- a/examples/with-purgecss/tailwind.js
+++ /dev/null
@@ -1,744 +0,0 @@
-/*
-
-Tailwind - The Utility-First CSS Framework
-
-A project by Adam Wathan (@adamwathan), Jonathan Reinink (@reinink),
-David Hemphill (@davidhemphill) and Steve Schoger (@steveschoger).
-
-Welcome to the Tailwind config file. This is where you can customize
-Tailwind specifically for your project. Don't be intimidated by the
-length of this file. It's really just a big JavaScript object and
-we've done our very best to explain each section.
-
-View the full documentation at https://tailwindcss.com.
-
-|-------------------------------------------------------------------------------
-| The default config
-|-------------------------------------------------------------------------------
-|
-| This variable contains the default Tailwind config. You don't have
-| to use it, but it can sometimes be helpful to have available. For
-| example, you may choose to merge your custom configuration
-| values with some of the Tailwind defaults.
-|
-*/
-
-// var defaultConfig = require('tailwindcss').defaultConfig()
-
-/*
-|-------------------------------------------------------------------------------
-| Colors https://tailwindcss.com/docs/colors
-|-------------------------------------------------------------------------------
-|
-| Here you can specify the colors used in your project. To get you started,
-| we've provided a generous palette of great looking colors that are perfect
-| for prototyping, but don't hesitate to change them for your project. You
-| own these colors, nothing will break if you change everything about them.
-|
-| We've used literal color names ("red", "blue", etc.) for the default
-| palette, but if you'd rather use functional names like "primary" and
-| "secondary", or even a numeric scale like "100" and "200", go for it.
-|
-*/
-
-const colors = {
- transparent: 'transparent',
-
- black: '#222b2f',
- 'grey-darkest': '#364349',
- 'grey-darker': '#596a73',
- 'grey-dark': '#70818a',
- grey: '#9babb4',
- 'grey-light': '#dae4e9',
- 'grey-lighter': '#f3f7f9',
- 'grey-lightest': '#fafcfc',
- white: '#ffffff',
-
- 'red-darkest': '#420806',
- 'red-darker': '#6a1b19',
- 'red-dark': '#cc1f1a',
- red: '#e3342f',
- 'red-light': '#ef5753',
- 'red-lighter': '#f9acaa',
- 'red-lightest': '#fcebea',
-
- 'orange-darkest': '#542605',
- 'orange-darker': '#7f4012',
- 'orange-dark': '#de751f',
- orange: '#f6993f',
- 'orange-light': '#faad63',
- 'orange-lighter': '#fcd9b6',
- 'orange-lightest': '#fff5eb',
-
- 'yellow-darkest': '#453411',
- 'yellow-darker': '#684f1d',
- 'yellow-dark': '#f2d024',
- yellow: '#ffed4a',
- 'yellow-light': '#fff382',
- 'yellow-lighter': '#fff9c2',
- 'yellow-lightest': '#fcfbeb',
-
- 'green-darkest': '#032d19',
- 'green-darker': '#0b4228',
- 'green-dark': '#1f9d55',
- green: '#38c172',
- 'green-light': '#51d88a',
- 'green-lighter': '#a2f5bf',
- 'green-lightest': '#e3fcec',
-
- 'teal-darkest': '#0d3331',
- 'teal-darker': '#174e4b',
- 'teal-dark': '#38a89d',
- teal: '#4dc0b5',
- 'teal-light': '#64d5ca',
- 'teal-lighter': '#a0f0ed',
- 'teal-lightest': '#e8fffe',
-
- 'blue-darkest': '#05233b',
- 'blue-darker': '#103d60',
- 'blue-dark': '#2779bd',
- blue: '#3490dc',
- 'blue-light': '#6cb2eb',
- 'blue-lighter': '#bcdefa',
- 'blue-lightest': '#eff8ff',
-
- 'indigo-darkest': '#191e38',
- 'indigo-darker': '#2f365f',
- 'indigo-dark': '#5661b3',
- indigo: '#6574cd',
- 'indigo-light': '#7886d7',
- 'indigo-lighter': '#b2b7ff',
- 'indigo-lightest': '#e6e8ff',
-
- 'purple-darkest': '#1f133f',
- 'purple-darker': '#352465',
- 'purple-dark': '#794acf',
- purple: '#9561e2',
- 'purple-light': '#a779e9',
- 'purple-lighter': '#d6bbfc',
- 'purple-lightest': '#f3ebff',
-
- 'pink-darkest': '#45051e',
- 'pink-darker': '#72173a',
- 'pink-dark': '#eb5286',
- pink: '#f66d9b',
- 'pink-light': '#fa7ea8',
- 'pink-lighter': '#ffbbca',
- 'pink-lightest': '#ffebef'
-}
-
-export default {
-
- /*
- |-----------------------------------------------------------------------------
- | Colors https://tailwindcss.com/docs/colors
- |-----------------------------------------------------------------------------
- |
- | The color palette defined above is also assigned to the "colors" key of
- | your Tailwind config. This makes it easy to access them in your CSS
- | using Tailwind's config helper. For example:
- |
- | .error { color: config('colors.red') }
- |
- */
-
- colors,
-
- /*
- |-----------------------------------------------------------------------------
- | Screens https://tailwindcss.com/docs/responsive-design
- |-----------------------------------------------------------------------------
- |
- | Screens in Tailwind are translated to CSS media queries. They define the
- | responsive breakpoints for your project. By default Tailwind takes a
- | "mobile first" approach, where each screen size represents a minimum
- | viewport width. Feel free to have as few or as many screens as you
- | want, naming them in whatever way you'd prefer for your project.
- |
- | Tailwind also allows for more complex screen definitions, which can be
- | useful in certain situations. Be sure to see the full responsive
- | documentation for a complete list of options.
- |
- | Class name: .{screen}:{utility}
- |
- */
-
- screens: {
- sm: '576px',
- md: '768px',
- lg: '992px',
- xl: '1200px'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Fonts https://tailwindcss.com/docs/fonts
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your project's font stack, or font families.
- | Keep in mind that Tailwind doesn't actually load any fonts for you.
- | If you're using custom fonts you'll need to import them prior to
- | defining them here.
- |
- | By default we provide a native font stack that works remarkably well on
- | any device or OS you're using, since it just uses the default fonts
- | provided by the platform.
- |
- | Class name: .font-{name}
- |
- */
-
- fonts: {
- sans: [
- '-apple-system',
- 'BlinkMacSystemFont',
- 'Segoe UI',
- 'Roboto',
- 'Oxygen',
- 'Ubuntu',
- 'Cantarell',
- 'Fira Sans',
- 'Droid Sans',
- 'Helvetica Neue'
- ],
- serif: [
- 'Constantia',
- 'Lucida Bright',
- 'Lucidabright',
- 'Lucida Serif',
- 'Lucida',
- 'DejaVu Serif',
- 'Bitstream Vera Serif',
- 'Liberation Serif',
- 'Georgia',
- 'serif'
- ],
- mono: [
- 'Menlo',
- 'Monaco',
- 'Consolas',
- 'Liberation Mono',
- 'Courier New',
- 'monospace'
- ]
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Text sizes https://tailwindcss.com/docs/text-sizing
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your text sizes. Name these in whatever way
- | makes the most sense to you. We use size names by default, but
- | you're welcome to use a numeric scale or even something else
- | entirely.
- |
- | By default Tailwind uses the "rem" unit type for most measurements.
- | This allows you to set a root font size which all other sizes are
- | then based on. That said, you are free to use whatever units you
- | prefer, be it rems, ems, pixels or other.
- |
- | Class name: .text-{size}
- |
- */
-
- textSizes: {
- xs: '.75rem', // 12px
- sm: '.875rem', // 14px
- base: '1rem', // 16px
- lg: '1.125rem', // 18px
- xl: '1.25rem', // 20px
- '2xl': '1.5rem', // 24px
- '3xl': '1.875rem', // 30px
- '4xl': '2.25rem', // 36px
- '5xl': '3rem' // 48px
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Font weights https://tailwindcss.com/docs/font-weight
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your font weights. We've provided a list of
- | common font weight names with their respective numeric scale values
- | to get you started. It's unlikely that your project will require
- | all of these, so we recommend removing those you don't need.
- |
- | Class name: .font-{weight}
- |
- */
-
- fontWeights: {
- hairline: 100,
- thin: 200,
- light: 300,
- normal: 400,
- medium: 500,
- semibold: 600,
- bold: 700,
- extrabold: 800,
- black: 900
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Leading (line height) https://tailwindcss.com/docs/line-height
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your line height values, or as we call
- | them in Tailwind, leadings.
- |
- | Class name: .leading-{size}
- |
- */
-
- leading: {
- none: 1,
- tight: 1.25,
- normal: 1.5,
- loose: 2
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Tracking (letter spacing) https://tailwindcss.com/docs/letter-spacing
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your letter spacing values, or as we call
- | them in Tailwind, tracking.
- |
- | Class name: .tracking-{size}
- |
- */
-
- tracking: {
- tight: '-0.05em',
- normal: '0',
- wide: '0.05em'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Text colors https://tailwindcss.com/docs/text-color
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your text colors. By default these use the
- | color palette we defined above, however you're welcome to set these
- | independently if that makes sense for your project.
- |
- | Class name: .text-{color}
- |
- */
-
- textColors: colors,
-
- /*
- |-----------------------------------------------------------------------------
- | Background colors https://tailwindcss.com/docs/background-color
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your background colors. By default these use
- | the color palette we defined above, however you're welcome to set
- | these independently if that makes sense for your project.
- |
- | Class name: .bg-{color}
- |
- */
-
- backgroundColors: colors,
-
- /*
- |-----------------------------------------------------------------------------
- | Border widths https://tailwindcss.com/docs/border-width
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your border widths. Take note that border
- | widths require a special "default" value set as well. This is the
- | width that will be used when you do not specify a border width.
- |
- | Class name: .border{-side?}{-width?}
- |
- */
-
- borderWidths: {
- default: '1px',
- 0: '0',
- 2: '2px',
- 4: '4px',
- 8: '8px'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Border colors https://tailwindcss.com/docs/border-color
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your border colors. By default these use the
- | color palette we defined above, however you're welcome to set these
- | independently if that makes sense for your project.
- |
- | Take note that border colors require a special "default" value set
- | as well. This is the color that will be used when you do not
- | specify a border color.
- |
- | Class name: .border-{color}
- |
- */
-
- borderColors: Object.assign({ default: colors['grey-light'] }, colors),
-
- /*
- |-----------------------------------------------------------------------------
- | Border radius https://tailwindcss.com/docs/border-radius
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your border radius values. If a `default` radius
- | is provided, it will be made available as the non-suffixed `.rounded`
- | utility.
- |
- | Class name: .rounded{-radius?}
- |
- */
-
- borderRadius: {
- default: '.25rem',
- sm: '.125rem',
- lg: '.5rem',
- full: '9999px',
- none: '0'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Width https://tailwindcss.com/docs/width
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your width utility sizes. These can be
- | percentage based, pixels, rems, or any other units. By default
- | we provide a sensible rem based numeric scale, a percentage
- | based fraction scale, plus some other common use-cases. You
- | can, of course, modify these values as needed.
- |
- |
- | It's also worth mentioning that Tailwind automatically escapes
- | invalid CSS class name characters, which allows you to have
- | awesome classes like .w-2/3.
- |
- | Class name: .w-{size}
- |
- */
-
- width: {
- auto: 'auto',
- px: '1px',
- 1: '0.25rem',
- 2: '0.5rem',
- 3: '0.75rem',
- 4: '1rem',
- 6: '1.5rem',
- 8: '2rem',
- 10: '2.5rem',
- 12: '3rem',
- 16: '4rem',
- 24: '6rem',
- 32: '8rem',
- 48: '12rem',
- 64: '16rem',
- '1/2': '50%',
- '1/3': '33.33333%',
- '2/3': '66.66667%',
- '1/4': '25%',
- '3/4': '75%',
- '1/5': '20%',
- '2/5': '40%',
- '3/5': '60%',
- '4/5': '80%',
- '1/6': '16.66667%',
- '5/6': '83.33333%',
- full: '100%',
- screen: '100vw'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Height https://tailwindcss.com/docs/height
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your height utility sizes. These can be
- | percentage based, pixels, rems, or any other units. By default
- | we provide a sensible rem based numeric scale plus some other
- | common use-cases. You can, of course, modify these values as
- | needed.
- |
- | Class name: .h-{size}
- |
- */
-
- height: {
- auto: 'auto',
- px: '1px',
- 1: '0.25rem',
- 2: '0.5rem',
- 3: '0.75rem',
- 4: '1rem',
- 6: '1.5rem',
- 8: '2rem',
- 10: '2.5rem',
- 12: '3rem',
- 16: '4rem',
- 24: '6rem',
- 32: '8rem',
- 48: '12rem',
- 64: '16rem',
- full: '100%',
- screen: '100vh'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Minimum width https://tailwindcss.com/docs/min-width
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your minimum width utility sizes. These can
- | be percentage based, pixels, rems, or any other units. We provide a
- | couple common use-cases by default. You can, of course, modify
- | these values as needed.
- |
- | Class name: .min-w-{size}
- |
- */
-
- minWidth: {
- 0: '0',
- full: '100%'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Minimum height https://tailwindcss.com/docs/min-height
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your minimum height utility sizes. These can
- | be percentage based, pixels, rems, or any other units. We provide a
- | few common use-cases by default. You can, of course, modify these
- | values as needed.
- |
- | Class name: .min-h-{size}
- |
- */
-
- minHeight: {
- 0: '0',
- full: '100%',
- screen: '100vh'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Maximum width https://tailwindcss.com/docs/max-width
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your maximum width utility sizes. These can
- | be percentage based, pixels, rems, or any other units. By default
- | we provide a sensible rem based scale and a "full width" size,
- | which is basically a reset utility. You can, of course,
- | modify these values as needed.
- |
- | Class name: .max-w-{size}
- |
- */
-
- maxWidth: {
- xs: '20rem',
- sm: '30rem',
- md: '40rem',
- lg: '50rem',
- xl: '60rem',
- '2xl': '70rem',
- '3xl': '80rem',
- '4xl': '90rem',
- '5xl': '100rem',
- full: '100%'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Maximum height https://tailwindcss.com/docs/max-height
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your maximum height utility sizes. These can
- | be percentage based, pixels, rems, or any other units. We provide a
- | couple common use-cases by default. You can, of course, modify
- | these values as needed.
- |
- | Class name: .max-h-{size}
- |
- */
-
- maxHeight: {
- full: '100%',
- screen: '100vh'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Padding https://tailwindcss.com/docs/padding
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your padding utility sizes. These can be
- | percentage based, pixels, rems, or any other units. By default we
- | provide a sensible rem based numeric scale plus a couple other
- | common use-cases like "1px". You can, of course, modify these
- | values as needed.
- |
- | Class name: .p{side?}-{size}
- |
- */
-
- padding: {
- px: '1px',
- 0: '0',
- 1: '0.25rem',
- 2: '0.5rem',
- 3: '0.75rem',
- 4: '1rem',
- 6: '1.5rem',
- 8: '2rem'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Margin https://tailwindcss.com/docs/margin
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your margin utility sizes. These can be
- | percentage based, pixels, rems, or any other units. By default we
- | provide a sensible rem based numeric scale plus a couple other
- | common use-cases like "1px". You can, of course, modify these
- | values as needed.
- |
- | Class name: .m{side?}-{size}
- |
- */
-
- margin: {
- px: '1px',
- 0: '0',
- 1: '0.25rem',
- 2: '0.5rem',
- 3: '0.75rem',
- 4: '1rem',
- 6: '1.5rem',
- 8: '2rem'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Negative margin https://tailwindcss.com/docs/negative-margin
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your negative margin utility sizes. These can
- | be percentage based, pixels, rems, or any other units. By default we
- | provide matching values to the padding scale since these utilities
- | generally get used together. You can, of course, modify these
- | values as needed.
- |
- | Class name: .-m{side?}-{size}
- |
- */
-
- negativeMargin: {
- px: '1px',
- 0: '0',
- 1: '0.25rem',
- 2: '0.5rem',
- 3: '0.75rem',
- 4: '1rem',
- 6: '1.5rem',
- 8: '2rem'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Shadows https://tailwindcss.com/docs/shadows
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your shadow utilities. As you can see from
- | the defaults we provide, it's possible to apply multiple shadows
- | per utility using comma separation.
- |
- | If a `default` shadow is provided, it will be made available as the non-
- | suffixed `.shadow` utility.
- |
- | Class name: .shadow-{size?}
- |
- */
-
- shadows: {
- default: '0 2px 4px 0 rgba(0,0,0,0.10)',
- md: '0 4px 8px 0 rgba(0,0,0,0.12), 0 2px 4px 0 rgba(0,0,0,0.08)',
- lg: '0 15px 30px 0 rgba(0,0,0,0.11), 0 5px 15px 0 rgba(0,0,0,0.08)',
- inner: 'inset 0 2px 4px 0 rgba(0,0,0,0.06)',
- none: 'none'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Z-index https://tailwindcss.com/docs/z-index
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your z-index utility values. By default we
- | provide a sensible numeric scale. You can, of course, modify these
- | values as needed.
- |
- | Class name: .z-{index}
- |
- */
-
- zIndex: {
- 0: 0,
- 10: 10,
- 20: 20,
- 30: 30,
- 40: 40,
- 50: 50,
- auto: 'auto'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Opacity https://tailwindcss.com/docs/opacity
- |-----------------------------------------------------------------------------
- |
- | Here is where you define your opacity utility values. By default we
- | provide a sensible numeric scale. You can, of course, modify these
- | values as needed.
- |
- | Class name: .opacity-{name}
- |
- */
-
- opacity: {
- 0: '0',
- 25: '.25',
- 50: '.5',
- 75: '.75',
- 100: '1'
- },
-
- /*
- |-----------------------------------------------------------------------------
- | Packages
- |-----------------------------------------------------------------------------
- |
- | Here is where you can define the configuration for any Tailwind packages
- | you're using. These can be utility packs, component bundles, or even
- | complete themes. You'll want to reference each package's
- | documentation for a list of settings available for it.
- |
- */
-
- packages: {
- }
-
-}
diff --git a/examples/with-sockets/README.md b/examples/with-sockets/README.md
deleted file mode 100644
index 3ddd4ba9577e..000000000000
--- a/examples/with-sockets/README.md
+++ /dev/null
@@ -1,12 +0,0 @@
-# Nuxt with [Socket.io](https://socket.io/)
-
-An example for Nuxt.js with WebSockets over Socket.io.
-
-> Socket.IO enables real-time, bidirectional and event-based communication.
-> It works on every platform, browser or device, focusing equally on reliability and speed.
-
-* Do you use Nuxt programmatically (eg. with Express or Koa)? Take a look into [`server.js`](./server.js) for setting up WS with your implementation
-
-* In case you use Nuxt standalone, check out [`nuxt.config.js`](./nuxt.config.js) and the [io-module](./io/index.js)
-
-* In both situations you should look into the [`index.vue`](./pages/index.vue) where sending and receiving messages is done
diff --git a/examples/with-sockets/io/index.js b/examples/with-sockets/io/index.js
deleted file mode 100644
index ffbda8dd218a..000000000000
--- a/examples/with-sockets/io/index.js
+++ /dev/null
@@ -1,26 +0,0 @@
-import http from 'http'
-import socketIO from 'socket.io'
-
-export default function () {
- this.nuxt.hook('render:before', (renderer) => {
- const server = http.createServer(this.nuxt.renderer.app)
- const io = socketIO(server)
-
- // overwrite nuxt.server.listen()
- this.nuxt.server.listen = (port, host) => new Promise(resolve => server.listen(port || 3000, host || 'localhost', resolve))
- // close this server on 'close' event
- this.nuxt.hook('close', () => new Promise(server.close))
-
- // Add socket.io events
- const messages = []
- io.on('connection', (socket) => {
- socket.on('last-messages', function (fn) {
- fn(messages.slice(-50))
- })
- socket.on('send-message', function (message) {
- messages.push(message)
- socket.broadcast.emit('new-message', message)
- })
- })
- })
-}
diff --git a/examples/with-sockets/nuxt.config.js b/examples/with-sockets/nuxt.config.js
deleted file mode 100644
index 538c237f8f27..000000000000
--- a/examples/with-sockets/nuxt.config.js
+++ /dev/null
@@ -1,12 +0,0 @@
-export default {
- head: {
- meta: [
- { charset: 'utf-8' },
- { name: 'viewport', content: 'width=device-width, initial-scale=1' }
- ]
- },
- modules: ['~/io'],
- env: {
- WS_URL: process.env.WS_URL || 'http://localhost:3000'
- }
-}
diff --git a/examples/with-sockets/package.json b/examples/with-sockets/package.json
deleted file mode 100644
index cb26d4247209..000000000000
--- a/examples/with-sockets/package.json
+++ /dev/null
@@ -1,18 +0,0 @@
-{
- "name": "example-with-sockets",
- "scripts": {
- "dev": "nodemon -w server.js -w nuxt.config.js server.js",
- "build": "nuxt build",
- "start": "NODE_ENV=production node server.js",
- "post-update": "yarn upgrade --latest"
- },
- "dependencies": {
- "express": "^4.14.0",
- "nuxt": "latest",
- "socket.io": "^1.7.2",
- "socket.io-client": "^1.7.2"
- },
- "devDependencies": {
- "nodemon": "^1.11.0"
- }
-}
diff --git a/examples/with-sockets/pages/index.vue b/examples/with-sockets/pages/index.vue
deleted file mode 100644
index fe944f6c0dd6..000000000000
--- a/examples/with-sockets/pages/index.vue
+++ /dev/null
@@ -1,157 +0,0 @@
-<template>
- <div>
- <ul class="pages">
- <li class="chat page">
- <div class="chatArea">
- <ul ref="messages" class="messages">
- <li v-for="(message, index) in messages" :key="index" class="message">
- <i :title="message.date">
- {{ message.date.split('T')[1].slice(0, -2) }}
- </i>: {{ message.text }}
- </li>
- </ul>
- </div>
- <input v-model="message" class="inputMessage" type="text" placeholder="Type here..." @keyup.enter="sendMessage">
- </li>
- </ul>
- </div>
-</template>
-
-<script>
-import socket from '~/plugins/socket.io.js'
-
-export default {
- asyncData (context, callback) {
- socket.emit('last-messages', function (messages) {
- callback(null, {
- messages,
- message: ''
- })
- })
- },
- watch: {
- messages: 'scrollToBottom'
- },
- beforeMount () {
- socket.on('new-message', (message) => {
- this.messages.push(message)
- })
- },
- mounted () {
- this.scrollToBottom()
- },
- methods: {
- sendMessage () {
- if (!this.message.trim()) { return }
- const message = {
- date: new Date().toJSON(),
- text: this.message.trim()
- }
- this.messages.push(message)
- this.message = ''
- socket.emit('send-message', message)
- },
- scrollToBottom () {
- this.$nextTick(() => {
- this.$refs.messages.scrollTop = this.$refs.messages.scrollHeight
- })
- }
- },
- head: {
- title: 'Nuxt.js with Socket.io'
- }
-}
-</script>
-
-<style>
-* {
- box-sizing: border-box;
-}
-
-html {
- font-weight: 300;
- -webkit-font-smoothing: antialiased;
-}
-
-html, input {
- font-family:
- "HelveticaNeue-Light",
- "Helvetica Neue Light",
- "Helvetica Neue",
- Helvetica,
- Arial,
- "Lucida Grande",
- sans-serif;
-}
-
-html, body {
- height: 100%;
- margin: 0;
- padding: 0;
-}
-
-ul {
- list-style: none;
- word-wrap: break-word;
-}
-
-/* Pages */
-
-.pages {
- height: 100%;
- margin: 0;
- padding: 0;
- width: 100%;
-}
-
-.page {
- height: 100%;
- position: absolute;
- width: 100%;
-}
-
-/* Font */
-
-.messages {
- font-size: 150%;
-}
-
-.inputMessage {
- font-size: 100%;
-}
-
-.log {
- color: gray;
- font-size: 70%;
- margin: 5px;
- text-align: center;
-}
-
-/* Messages */
-
-.chatArea {
- height: 100%;
- padding-bottom: 60px;
-}
-
-.messages {
- height: 100%;
- margin: 0;
- overflow-y: scroll;
- padding: 10px 20px 10px 20px;
-}
-
-/* Input */
-
-.inputMessage {
- border: 10px solid #3B8070;
- bottom: 0;
- height: 60px;
- left: 0;
- outline: none;
- padding-left: 10px;
- position: absolute;
- right: 0;
- width: 100%;
-}
-</style>
diff --git a/examples/with-sockets/plugins/socket.io.js b/examples/with-sockets/plugins/socket.io.js
deleted file mode 100644
index a404aaec1972..000000000000
--- a/examples/with-sockets/plugins/socket.io.js
+++ /dev/null
@@ -1,4 +0,0 @@
-import io from 'socket.io-client'
-const socket = io(process.env.WS_URL)
-
-export default socket
diff --git a/examples/with-sockets/server.js b/examples/with-sockets/server.js
deleted file mode 100644
index 648f7427e048..000000000000
--- a/examples/with-sockets/server.js
+++ /dev/null
@@ -1,40 +0,0 @@
-import http from 'http'
-
-import { Nuxt, Builder } from 'nuxt'
-import express from 'express'
-import SocketIO from 'socket.io'
-
-const port = process.env.PORT || 3000
-const isProd = process.env.NODE_ENV === 'production'
-
-const app = express()
-const server = http.createServer(app)
-const io = SocketIO(server)
-
-// We instantiate Nuxt.js with the options
-const config = require('./nuxt.config.js')
-config.dev = !isProd
-
-const nuxt = new Nuxt(config)
-// Start build process in dev mode
-if (config.dev) {
- const builder = new Builder(nuxt)
- builder.build()
-}
-app.use(nuxt.render)
-
-// Listen the server
-server.listen(port, '0.0.0.0')
-console.log('Server listening on localhost:' + port) // eslint-disable-line no-console
-
-// Socket.io
-const messages = []
-io.on('connection', (socket) => {
- socket.on('last-messages', function (fn) {
- fn(messages.slice(-50))
- })
- socket.on('send-message', function (message) {
- messages.push(message)
- socket.broadcast.emit('new-message', message)
- })
-})
diff --git a/examples/with-tape/README.md b/examples/with-tape/README.md
deleted file mode 100644
index 0eaad767e777..000000000000
--- a/examples/with-tape/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Nuxt with [Tape](https://github.com/substack/tape)
-
-> Tape is a tap-producing test harness for node and browsers
diff --git a/examples/with-tape/package.json b/examples/with-tape/package.json
deleted file mode 100755
index 73d07461a05c..000000000000
--- a/examples/with-tape/package.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
- "name": "example-with-tape",
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "test": "tape ./test/**/*.js -r ./test/setup.js | tap-spec",
- "post-update": "yarn upgrade --latest"
- },
- "devDependencies": {
- "browser-env": "^3.2.1",
- "require-extension-hooks": "^0.3.2",
- "require-extension-hooks-babel": "^0.1.1",
- "require-extension-hooks-vue": "^0.4.1",
- "tap-spec": "^4.1.1",
- "tape": "^4.8.0",
- "vue-test-utils": "^1.0.0-beta.2"
- },
- "dependencies": {
- "nuxt": "latest"
- }
-}
diff --git a/examples/with-tape/pages/index.vue b/examples/with-tape/pages/index.vue
deleted file mode 100755
index c83119df1d89..000000000000
--- a/examples/with-tape/pages/index.vue
+++ /dev/null
@@ -1,35 +0,0 @@
-<template>
- <div>
- <h1 :class="className">
- Hello {{ name }}!
- </h1>
- <button @click="changeColor()">
- Change h1 Color
- </button>
- </div>
-</template>
-
-<script>
-export default {
- data () {
- return { name: 'world', className: 'red' }
- },
- methods: {
- changeColor () {
- this.className = this.className === 'red' ? 'blue' : 'green'
- }
- }
-}
-</script>
-
-<style>
-.red {
- color: red;
-}
-.blue {
- color: blue;
-}
-.green {
- color: green;
-}
-</style>
diff --git a/examples/with-tape/test/index.test.js b/examples/with-tape/test/index.test.js
deleted file mode 100755
index e408493ab6c0..000000000000
--- a/examples/with-tape/test/index.test.js
+++ /dev/null
@@ -1,43 +0,0 @@
-import test from 'tape'
-import { shallow } from 'vue-test-utils'
-import Index from '../pages/index.vue'
-
-test('renders Index.vue correctly', (t) => {
- t.plan(4)
-
- const wrapper = shallow(Index, {
- data: {
- name: 'nuxt'
- }
- })
-
- const button = wrapper.find('button')
-
- t.equal(
- wrapper.find('h1').text(),
- 'Hello nuxt!',
- 'renders "Hello nuxt!" text'
- )
-
- t.equal(
- wrapper.find('h1').hasClass('red'),
- true,
- 'h1 has a red class [default]'
- )
-
- button.trigger('click')
-
- t.equal(
- wrapper.find('h1').hasClass('blue'),
- true,
- 'h1 class changes to blue [after 1st click]'
- )
-
- button.trigger('click')
-
- t.equal(
- wrapper.find('h1').hasClass('green'),
- true,
- 'h1 class changes to green [after 2nd click]'
- )
-})
diff --git a/examples/with-tape/test/setup.js b/examples/with-tape/test/setup.js
deleted file mode 100644
index c193cfd102cc..000000000000
--- a/examples/with-tape/test/setup.js
+++ /dev/null
@@ -1,14 +0,0 @@
-import hooks from 'require-extension-hooks'
-
-// Setup browser environment
-require('browser-env')()
-
-// Setup vue files to be processed by `require-extension-hooks-vue`
-hooks('vue')
- .plugin('vue')
- .push()
-
-// Setup vue and js files to be processed by `require-extension-hooks-babel`
-hooks(['vue', 'js'])
- .plugin('babel')
- .push()
diff --git a/examples/with-vue-material/README.md b/examples/with-vue-material/README.md
deleted file mode 100644
index 7f7cbc0b3e68..000000000000
--- a/examples/with-vue-material/README.md
+++ /dev/null
@@ -1,9 +0,0 @@
-# Nuxt.js With [Vue-Material](https://vuematerial.io/)
-
-> Vue Material is a Vue.js bassed Material Design component library
-
-## Compatibility
-
-Vue-Material >= 1.0.0beta
-
-[View Demo](https://nuxt-vue-material.now.sh)
diff --git a/examples/with-vue-material/nuxt.config.js b/examples/with-vue-material/nuxt.config.js
deleted file mode 100644
index c62c272b75c1..000000000000
--- a/examples/with-vue-material/nuxt.config.js
+++ /dev/null
@@ -1,25 +0,0 @@
-export default {
- head: {
- meta: [
- {
- name: 'viewport',
- content: 'width=device-width, initial-scale=1, minimal-ui'
- }
- ],
- link: [
- {
- rel: 'stylesheet',
- href: 'https://fonts.googleapis.com/css?family=Roboto:300,400,500,700,400italic|Material+Icons'
- },
- {
- rel: 'stylesheet',
- href: 'https://unpkg.com/vue-material@beta/dist/vue-material.min.css'
- },
- {
- rel: 'stylesheet',
- href: 'https://unpkg.com/vue-material@beta/dist/theme/default.css'
- }
- ]
- },
- plugins: ['~/plugins/vue-material']
-}
diff --git a/examples/with-vue-material/package.json b/examples/with-vue-material/package.json
deleted file mode 100644
index 41527211f3cc..000000000000
--- a/examples/with-vue-material/package.json
+++ /dev/null
@@ -1,15 +0,0 @@
-{
- "name": "example-with-vue-material",
- "version": "1.0.0",
- "dependencies": {
- "nuxt": "latest",
- "vue": "~2.4.4",
- "vue-material": "beta"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/with-vue-material/pages/index.vue b/examples/with-vue-material/pages/index.vue
deleted file mode 100644
index 8773eca347fa..000000000000
--- a/examples/with-vue-material/pages/index.vue
+++ /dev/null
@@ -1,132 +0,0 @@
-<template>
- <div class="page-container md-layout-column">
- <md-toolbar class="md-primary">
- <md-button class="md-icon-button" @click="showNavigation = true">
- <md-icon>menu</md-icon>
- </md-button>
- <span class="md-title">
- Nuxt + Vue Material
- </span>
-
- <div class="md-toolbar-section-end">
- <md-button @click="showSidepanel = true">
- Favorites
- </md-button>
- </div>
- </md-toolbar>
-
- <md-drawer :md-active.sync="showNavigation">
- <md-toolbar class="md-transparent" md-elevation="0">
- <span class="md-title">
- My App name
- </span>
- </md-toolbar>
-
- <md-list>
- <md-list-item>
- <md-icon>move_to_inbox</md-icon>
- <span class="md-list-item-text">
- Inbox
- </span>
- </md-list-item>
-
- <md-list-item>
- <md-icon>send</md-icon>
- <span class="md-list-item-text">
- Sent Mail
- </span>
- </md-list-item>
-
- <md-list-item>
- <md-icon>delete</md-icon>
- <span class="md-list-item-text">
- Trash
- </span>
- </md-list-item>
-
- <md-list-item>
- <md-icon>error</md-icon>
- <span class="md-list-item-text">
- Spam
- </span>
- </md-list-item>
- </md-list>
- </md-drawer>
-
- <md-drawer :md-active.sync="showSidepanel" class="md-right">
- <md-toolbar class="md-transparent" md-elevation="0">
- <span class="md-title">
- Favorites
- </span>
- </md-toolbar>
-
- <md-list>
- <md-list-item>
- <span class="md-list-item-text">
- Abbey Christansen
- </span>
-
- <md-button class="md-icon-button md-list-action">
- <md-icon class="md-primary">
- chat_bubble
- </md-icon>
- </md-button>
- </md-list-item>
-
- <md-list-item>
- <span class="md-list-item-text">
- Alex Nelson
- </span>
-
- <md-button class="md-icon-button md-list-action">
- <md-icon class="md-primary">
- chat_bubble
- </md-icon>
- </md-button>
- </md-list-item>
-
- <md-list-item>
- <span class="md-list-item-text">
- Mary Johnson
- </span>
-
- <md-button class="md-icon-button md-list-action">
- <md-icon>chat_bubble</md-icon>
- </md-button>
- </md-list-item>
- </md-list>
- </md-drawer>
-
- <md-content>
- Lorem ipsum dolor sit amet, consectetur adipisicing elit. Error quibusdam, non molestias et! Earum magnam, similique, quo recusandae placeat dicta asperiores modi sint ea repudiandae maxime? Quae non explicabo, neque.
- </md-content>
- </div>
-</template>
-
-<script>
-export default {
- name: 'Sidenav',
- data: () => ({
- showNavigation: false,
- showSidepanel: false
- })
-}
-</script>
-
-<style scoped>
- .page-container {
- min-height: 100vh;
- overflow: hidden;
- position: relative;
- border: 1px solid rgba(#000, 0.12);
- }
-
- .md-drawer {
- width: 230px;
- max-width: calc(100vw - 125px);
- }
-
- .md-content {
- padding: 16px;
- }
-</style>
diff --git a/examples/with-vue-material/plugins/vue-material.js b/examples/with-vue-material/plugins/vue-material.js
deleted file mode 100644
index 3f64c62cc102..000000000000
--- a/examples/with-vue-material/plugins/vue-material.js
+++ /dev/null
@@ -1,4 +0,0 @@
-import Vue from 'vue'
-import VueMaterial from 'vue-material'
-
-Vue.use(VueMaterial)
diff --git a/examples/with-vuetify/README.md b/examples/with-vuetify/README.md
deleted file mode 100644
index 0532d1203610..000000000000
--- a/examples/with-vuetify/README.md
+++ /dev/null
@@ -1,10 +0,0 @@
-# Using [Vuetify.js](https://vuetifyjs.com/en/) with Nuxt.js
-
-> Vuetify is a Vue based Material Design Component Framework
-
-## Demo
-https://nuxt-with-vuetify-example.surge.sh
-
-## Resources
-https://nuxtjs.org/examples/with-vuetify<br>
-https://vuetifyjs.com/
diff --git a/examples/with-vuetify/assets/app.styl b/examples/with-vuetify/assets/app.styl
deleted file mode 100644
index 784fd9c8980f..000000000000
--- a/examples/with-vuetify/assets/app.styl
+++ /dev/null
@@ -1,27 +0,0 @@
-// Specify overrides (theme and/or base variables etc.)
-// See https://vuetifyjs.com/quick-start
-// And for themes customizing: https://vuetifyjs.com/style/theme
-
-// Color Palette: https://vuetifyjs.com/style/colors
-
-// Although, since version https://github.com/vuetifyjs/vuetify/releases/tag/v0.17.0, colors are no
-// longer defined **explicitly** in the stylus files.
-// you can use `import colors from 'vuetify/es5/util/colors'` in the vuetify instance, under `plugins`
-// if you only want to define your color palette.
-
-// you have to define the same palette colors just if you want to use them inside your own stylus files.
-
-@require '~vuetify/src/stylus/settings/_colors'
-
-$theme := {
- primary: $red.darken-2
- accent: $red.accent-2
- secondary: $grey.lighten-1
- info: $blue.lighten-1
- warning: $amber.darken-2
- error: $red.accent-4
- success: $green.lighten-2
-}
-
-// Import Vuetify styling
-@require '~vuetify/src/stylus/main'
diff --git a/examples/with-vuetify/layouts/default.vue b/examples/with-vuetify/layouts/default.vue
deleted file mode 100644
index ffe7193b418a..000000000000
--- a/examples/with-vuetify/layouts/default.vue
+++ /dev/null
@@ -1,41 +0,0 @@
-<template>
- <v-app>
- <v-toolbar color="primary" dark>
- <v-toolbar-side-icon @click.native.stop="drawer = !drawer" />
- <v-toolbar-title>Toolbar</v-toolbar-title>
- </v-toolbar>
- <v-navigation-drawer v-model="drawer" left fixed app>
- <v-list>
- <v-list-tile router nuxt href="/">
- <v-list-tile-title>Home</v-list-tile-title>
- </v-list-tile>
- <v-list-tile router nuxt href="/about">
- <v-list-tile-title>About</v-list-tile-title>
- </v-list-tile>
- </v-list>
- </v-navigation-drawer>
- <main>
- <v-content>
- <v-container fluid>
- <nuxt />
- </v-container>
- </v-content>
- </main>
- </v-app>
-</template>
-
-<script>
-export default {
- data () {
- return {
- drawer: false
- }
- }
-}
-</script>
-
-<style scoped>
- .title {
- padding-left: 20px;
- }
-</style>
diff --git a/examples/with-vuetify/nuxt.config.js b/examples/with-vuetify/nuxt.config.js
deleted file mode 100644
index f13447cd02ff..000000000000
--- a/examples/with-vuetify/nuxt.config.js
+++ /dev/null
@@ -1,31 +0,0 @@
-import VuetifyLoaderPlugin from 'vuetify-loader/lib/plugin'
-
-export default {
- /*
- ** Head elements
- ** Add Roboto font and Material Icons
- */
- head: {
- link: [
- {
- rel: 'stylesheet',
- type: 'text/css',
- href: 'https://fonts.googleapis.com/css?family=Roboto:300,400,500,700|Material+Icons'
- }
- ]
- },
-
- build: {
- plugins: [new VuetifyLoaderPlugin()],
- extractCSS: true,
- transpile: ['vuetify/lib']
- },
- /*
- ** Load Vuetify into the app
- */
- plugins: ['~/plugins/vuetify'],
- /*
- ** Load Vuetify CSS globally
- */
- css: ['~/assets/app.styl']
-}
diff --git a/examples/with-vuetify/package.json b/examples/with-vuetify/package.json
deleted file mode 100644
index 3e6d3b281a43..000000000000
--- a/examples/with-vuetify/package.json
+++ /dev/null
@@ -1,19 +0,0 @@
-{
- "name": "example-with-vuetify",
- "dependencies": {
- "nuxt": "latest",
- "vuetify": "latest",
- "vuetify-loader": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "generate": "nuxt generate",
- "post-update": "yarn upgrade --latest"
- },
- "devDependencies": {
- "stylus": "^0.54.5",
- "stylus-loader": "^3.0.1"
- }
-}
diff --git a/examples/with-vuetify/pages/about.vue b/examples/with-vuetify/pages/about.vue
deleted file mode 100644
index 215fcd8ea6a1..000000000000
--- a/examples/with-vuetify/pages/about.vue
+++ /dev/null
@@ -1,18 +0,0 @@
-<template>
- <v-carousel>
- <v-carousel-item v-for="(src, i) in images" :key="i" :src="src" />
- </v-carousel>
-</template>
-
-<script>
-export default {
- data: () => ({
- images: [
- 'https://cdn.vuetifyjs.com/images/carousel/squirrel.jpg',
- 'https://cdn.vuetifyjs.com/images/carousel/sky.jpg',
- 'https://cdn.vuetifyjs.com/images/carousel/bird.jpg',
- 'https://cdn.vuetifyjs.com/images/carousel/planet.jpg'
- ]
- })
-}
-</script>
diff --git a/examples/with-vuetify/pages/index.vue b/examples/with-vuetify/pages/index.vue
deleted file mode 100644
index 3e2d64d81c90..000000000000
--- a/examples/with-vuetify/pages/index.vue
+++ /dev/null
@@ -1,14 +0,0 @@
-<template>
- <div class="title">
- <h2>Main content</h2>
- <v-btn color="primary">
- Primary button
- </v-btn>
- <v-btn color="secondary">
- Secondary button
- </v-btn>
- <v-btn color="success">
- Success button
- </v-btn>
- </div>
-</template>
diff --git a/examples/with-vuetify/plugins/vuetify.js b/examples/with-vuetify/plugins/vuetify.js
deleted file mode 100644
index 12bb590ca4e0..000000000000
--- a/examples/with-vuetify/plugins/vuetify.js
+++ /dev/null
@@ -1,19 +0,0 @@
-import Vue from 'vue'
-import Vuetify from 'vuetify/lib'
-import colors from 'vuetify/es5/util/colors'
-
-// You can also specify those components you are going to use for "a la carte" build:
-// https://github.com/vuetifyjs/nuxt/blob/master/template/plugins/vuetify.js
-// https://github.com/vuetifyjs/a-la-carte/blob/master/template/src/main.js
-
-Vue.use(Vuetify, {
- theme: {
- primary: '#9c27b0', // a color that is not in the material colors palette
- accent: colors.grey.darken3,
- secondary: colors.amber.darken3,
- info: colors.teal.lighten1,
- warning: colors.amber.darken2,
- error: colors.deepOrange.accent4,
- success: colors.green.accent3
- }
-})
diff --git a/examples/with-vuikit/README.md b/examples/with-vuikit/README.md
deleted file mode 100644
index 18af9216aea7..000000000000
--- a/examples/with-vuikit/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Nuxt with [Vuikit](https://vuikit.js.org)
-
-> Vuikit is a consistent and responsive Vue UI library, based on the front-end framework UIkit.
diff --git a/examples/with-vuikit/layouts/default.vue b/examples/with-vuikit/layouts/default.vue
deleted file mode 100644
index 04f11e32389f..000000000000
--- a/examples/with-vuikit/layouts/default.vue
+++ /dev/null
@@ -1,5 +0,0 @@
-<template>
- <div class="uk-container">
- <nuxt />
- </div>
-</template>
diff --git a/examples/with-vuikit/nuxt.config.js b/examples/with-vuikit/nuxt.config.js
deleted file mode 100644
index 2d9f22cd1af3..000000000000
--- a/examples/with-vuikit/nuxt.config.js
+++ /dev/null
@@ -1,6 +0,0 @@
-export default {
- css: ['@vuikit/theme'],
- plugins: [
- '~/plugins/vuikit.js'
- ]
-}
diff --git a/examples/with-vuikit/package.json b/examples/with-vuikit/package.json
deleted file mode 100644
index 991b564ae55b..000000000000
--- a/examples/with-vuikit/package.json
+++ /dev/null
@@ -1,15 +0,0 @@
-{
- "name": "nuxt-with-vuikit",
- "dependencies": {
- "@vuikit/icons": "latest",
- "@vuikit/theme": "latest",
- "nuxt": "latest",
- "vuikit": "latest"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- }
-}
diff --git a/examples/with-vuikit/pages/index.vue b/examples/with-vuikit/pages/index.vue
deleted file mode 100644
index d435b0b12406..000000000000
--- a/examples/with-vuikit/pages/index.vue
+++ /dev/null
@@ -1,19 +0,0 @@
-<template>
- <vk-card type="primary">
- <vk-card-title>Nuxt + Vuikit</vk-card-title>
- <div class="uk-inline">
- <vk-button>Hover</vk-button>
- <vk-dropdown>
- Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt.
- </vk-dropdown>
- </div>
- <div class="uk-inline">
- <vk-button>Click</vk-button>
- <vk-dropdown mode="click">
- Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt.
- </vk-dropdown>
- </div>
- <hr class="uk-divider-icon">
- <vk-icon icon="heart" />
- </vk-card>
-</template>
diff --git a/examples/with-vuikit/plugins/vuikit.js b/examples/with-vuikit/plugins/vuikit.js
deleted file mode 100644
index 1b09e549102d..000000000000
--- a/examples/with-vuikit/plugins/vuikit.js
+++ /dev/null
@@ -1,6 +0,0 @@
-import Vue from 'vue'
-import Vuikit from 'vuikit'
-import VuikitIcons from '@vuikit/icons'
-
-Vue.use(Vuikit)
-Vue.use(VuikitIcons)
diff --git a/examples/with-vux/README.md b/examples/with-vux/README.md
deleted file mode 100644
index 84e3a5f943b0..000000000000
--- a/examples/with-vux/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Showcase of Nuxt.js and [VUX](https://github.com/airyland/vux)
-
-> VUX is a Mobile UI Components based on Vue & WeUI.
diff --git a/examples/with-vux/layouts/default.vue b/examples/with-vux/layouts/default.vue
deleted file mode 100644
index bb788e5fa375..000000000000
--- a/examples/with-vux/layouts/default.vue
+++ /dev/null
@@ -1,9 +0,0 @@
-<template>
- <nuxt />
-</template>
-
-<style>
-body {
- background-color: #fbf9fe;
-}
-</style>
diff --git a/examples/with-vux/nuxt.config.js b/examples/with-vux/nuxt.config.js
deleted file mode 100644
index ccf223ae5392..000000000000
--- a/examples/with-vux/nuxt.config.js
+++ /dev/null
@@ -1,40 +0,0 @@
-import path from 'path'
-
-import vuxLoader from 'vux-loader'
-
-export default {
- head: {
- meta: [
- { charset: 'utf-8' },
- { name: 'viewport', content: 'width=device-width, initial-scale=1, user-scalable=0' }
- ]
- },
- css: [
- 'vux/src/styles/reset.less',
- 'vux/src/styles/1px.less'
- ],
- plugins: [
- {
- src: '~/plugins/vux-plugins',
- ssr: false
- },
- {
- src: '~/plugins/vux-components',
- ssr: true
- }
- ],
- build: {
- extend (config, { isDev, isClient }) {
- const configs = vuxLoader.merge(config, {
- options: {
- ssr: true
- },
- plugins: ['vux-ui', {
- name: 'less-theme',
- path: path.join(__dirname, './styles/theme.less')
- }]
- })
- return configs
- }
- }
-}
diff --git a/examples/with-vux/package.json b/examples/with-vux/package.json
deleted file mode 100644
index d2662ff5520d..000000000000
--- a/examples/with-vux/package.json
+++ /dev/null
@@ -1,20 +0,0 @@
-{
- "name": "example-with-vux",
- "version": "1.0.0",
- "license": "MIT",
- "dependencies": {
- "nuxt": "latest",
- "vux": "^2.8.0"
- },
- "scripts": {
- "dev": "nuxt",
- "build": "nuxt build",
- "start": "nuxt start",
- "post-update": "yarn upgrade --latest"
- },
- "devDependencies": {
- "less": "^2.7.3",
- "less-loader": "^4.0.6",
- "vux-loader": "^1.2.1"
- }
-}
diff --git a/examples/with-vux/pages/index.vue b/examples/with-vux/pages/index.vue
deleted file mode 100644
index c2013bf0092f..000000000000
--- a/examples/with-vux/pages/index.vue
+++ /dev/null
@@ -1,22 +0,0 @@
-<template>
- <div>
- <group title="vux demo">
- <cell title="cell" value="click me" is-link @click.native="alert" />
- </group>
- </div>
-</template>
-
-<script>
-export default {
- methods: {
- alert () {
- this.$vux.alert.show('This is a Alert example.')
- }
- },
- head () {
- return {
- title: 'vux demo'
- }
- }
-}
-</script>
diff --git a/examples/with-vux/plugins/vux-components.js b/examples/with-vux/plugins/vux-components.js
deleted file mode 100644
index b6a978aa8e9f..000000000000
--- a/examples/with-vux/plugins/vux-components.js
+++ /dev/null
@@ -1,5 +0,0 @@
-import Vue from 'vue'
-import { Group, Cell } from 'vux'
-
-Vue.component('group', Group)
-Vue.component('cell', Cell)
diff --git a/examples/with-vux/plugins/vux-plugins.js b/examples/with-vux/plugins/vux-plugins.js
deleted file mode 100644
index ff22a2598e6e..000000000000
--- a/examples/with-vux/plugins/vux-plugins.js
+++ /dev/null
@@ -1,12 +0,0 @@
-import Vue from 'vue'
-import { BusPlugin, TransferDom, WechatPlugin, DatetimePlugin, LoadingPlugin, ToastPlugin, AlertPlugin, ConfirmPlugin } from 'vux'
-
-Vue.use(DatetimePlugin)
-Vue.use(LoadingPlugin)
-Vue.use(ToastPlugin)
-Vue.use(AlertPlugin)
-Vue.use(ConfirmPlugin)
-Vue.use(WechatPlugin)
-Vue.use(BusPlugin)
-
-Vue.directive('transfer-dom', TransferDom)
diff --git a/examples/with-vux/styles/theme.less b/examples/with-vux/styles/theme.less
deleted file mode 100644
index 88c363007e63..000000000000
--- a/examples/with-vux/styles/theme.less
+++ /dev/null
@@ -1 +0,0 @@
-@dialog-button-text-primary-color: #FF9900;
\ No newline at end of file
diff --git a/jest.config.js b/jest.config.js
deleted file mode 100644
index 68e437d910df..000000000000
--- a/jest.config.js
+++ /dev/null
@@ -1,59 +0,0 @@
-const fs = require('fs')
-const path = require('path')
-
-const corePackages = fs.readdirSync(path.resolve(__dirname, 'packages'))
-
-module.exports = {
- testEnvironment: 'node',
-
- expand: true,
-
- forceExit: true,
-
- roots: [
- '<rootDir>/packages',
- '<rootDir>/test'
- ],
-
- // https://github.com/facebook/jest/pull/6747 fix warning here
- // But its performance overhead is pretty bad (30+%).
- // detectOpenHandles: true
-
- setupFilesAfterEnv: ['./test/utils/setup'],
-
- coverageDirectory: './coverage',
-
- collectCoverageFrom: [
- '**/packages/*/src/**/*.js'
- ],
-
- coveragePathIgnorePatterns: [
- 'node_modules/(?!(@nuxt|nuxt))',
- 'packages/webpack/src/config/plugins/vue',
- 'packages/server/src/jsdom'
- ],
-
- testPathIgnorePatterns: [
- 'node_modules/(?!(@nuxt|nuxt))',
- 'test/fixtures/.*/.*?/',
- 'examples/.*'
- ],
-
- transformIgnorePatterns: [
- 'node_modules/(?!(@nuxt|nuxt))'
- ],
-
- transform: {
- '^.+\\.js$': 'babel-jest',
- '^.+\\.vue$': 'vue-jest'
- },
-
- moduleFileExtensions: [
- 'js',
- 'json'
- ],
-
- moduleNameMapper: {
- [`@nuxt/(${corePackages.join('|')})(/?.*)$`]: '<rootDir>/packages/$1/src/$2'
- }
-}
diff --git a/knip.json b/knip.json
new file mode 100644
index 000000000000..5bb583173932
--- /dev/null
+++ b/knip.json
@@ -0,0 +1,60 @@
+{
+ "$schema": "https://unpkg.com/knip@5/schema.json",
+ "ignoreBinaries": [
+ "prepack"
+ ],
+ "ignoreWorkspaces": ["test/fixtures/basic"],
+ "ignoreDependencies": [
+ "bing",
+ "uno.css"
+ ],
+ "workspaces": {
+ ".": {
+ "entry": [
+ "scripts/*"
+ ]
+ },
+ "test/fixtures/*": {
+ "entry": [
+ "nuxt.config.{js,ts}",
+ "modules/*.ts",
+ "types.ts"
+ ]
+ },
+ "packages/*": {
+ "entry": [
+ "src/index.ts",
+ "src/runtime/**/*.{js,ts,mjs}"
+ ]
+ },
+ "packages/nuxt": {
+ "entry": [
+ "src/app/**/*.ts",
+ "src/app/*.ts",
+ "src/*/runtime/**/*.{ts,js}",
+ "src/core/templates.ts",
+ "src/index.ts"
+ ]
+ },
+ "packages/rspack": {
+ "entry": [
+ "../webpack/src/index.ts",
+ "../webpack/src/runtime/**/*.{js,ts,mjs}",
+ "builder.mjs"
+ ]
+ },
+ "packages/ui-templates": {
+ "entry": [
+ "lib/*.ts",
+ "styles.ts"
+ ]
+ },
+ "packages/webpack": {
+ "entry": [
+ "src/index.ts",
+ "src/runtime/**/*.{js,ts,mjs}",
+ "builder.mjs"
+ ]
+ }
+ }
+}
diff --git a/lerna.json b/lerna.json
deleted file mode 100644
index b3c25579d0bc..000000000000
--- a/lerna.json
+++ /dev/null
@@ -1,28 +0,0 @@
-{
- "version": "2.12.1",
- "npmClient": "yarn",
- "useWorkspaces": true,
- "conventionalCommits": true,
- "exact": true,
- "packages": [
- "packages/*",
- "distributions/*"
- ],
- "command": {
- "publish": {
- "npmClient": "npm"
- },
- "init": {
- "exact": true
- }
- },
- "changelog": {
- "labels": {
- "feat": "New Feature",
- "fix": "Bug Fix",
- "docs": "Documentation",
- "perf": "Performance",
- "refactor": "Code Refactoring"
- }
- }
-}
diff --git a/lychee.toml b/lychee.toml
new file mode 100644
index 000000000000..efd7f7263419
--- /dev/null
+++ b/lychee.toml
@@ -0,0 +1,71 @@
+# Cache the results of Lychee if ran locally in order to minimise the chance of rate limiting
+cache = true
+
+# Discard all cached requests older than this duration.
+max_cache_age = "1d"
+# Ignore all private link (such as localhost) to avoid errors
+exclude_all_private = true
+# HTTP status code: 429 (Too Many Requests) will also be treated as a valid link if Lychee gets rate limited
+accept = [200, 201, 204, 206, 300, 301, 302, 303, 304, 307, 308, 999]
+
+# Base URL or website root directory to check relative URLs.
+base_url = "https://nuxt.com/"
+
+no_progress = true
+
+# Enable checking of fragments/anchors in links (e.g., #section-name)
+# include_fragments = true
+
+# Follow redirects
+max_redirects = 3
+
+# Set user agent to avoid bot blocking
+user_agent = "Mozilla/5.0 (compatible; lychee link checker)"
+
+# Set reasonable timeout and retry values
+timeout = 20
+retry_wait_time = 2
+max_retries = 6
+# Throttle per host to reduce rate limits / connection failures from external docs in CI
+host_request_interval = "50ms"
+host_concurrency = 5
+
+# Explicitly exclude some URLs
+exclude = [
+ "https://twitter.nuxt.dev/",
+ "https://www.webpagetest.org/",
+ "https://stackoverflow.com/help/minimal-reproducible-example",
+ "https://gsap.com/",
+ # external docs sites that block or rate-limit CI bots
+ 'https://router.vuejs.org/(.*)',
+ 'https://vitest.dev/(.*)',
+ 'https://vite.dev/(.*)',
+ # dummy example URLs
+ "https://myawesome-lib.js/",
+ "https://awesome-lib.js/",
+ "https://myawesome-lib.css/",
+ "https://awesome-lib.css/",
+ "https://mycdn.org/",
+ "https://nuxt.new/c/v4",
+ "https://nuxt.new/s/v4",
+ "https://www.npmjs.com/",
+ 'https://nuxt\.com/docs/4\.x/api/composables/\$%7BkebabCase\(factory\.name\)%7D.*',
+ # TODO: fix upstream API issues
+ "https://nuxt.com/modules",
+ # single-quotes are required for regexp
+ 'https://res.cloudinary.com/nuxt/video/upload/(.*)',
+ 'https://www.npmjs.com/package/(.*)',
+ '(https?:\/\/github\.com\/)(.*\/)(generate)',
+ "https://github.com/nuxt-contrib/vue3-ssr-starter/generate",
+ # GitHub URLs that redirect to login in unauthenticated CI
+ 'https://github.com/(.*)/issues/new(.*)',
+ 'https://github.com/(.*)/edit/(.*)',
+ # Discord invite redirects
+ 'https://go.nuxt.com/discord',
+ # excluded URLs from test suite
+ "http://auth.com",
+ "http://example1.com/",
+ "http://example2.com/",
+ "http://example3.com/",
+ "~images/main-bg.jpg",
+]
diff --git a/nuxt.config.ts b/nuxt.config.ts
new file mode 100644
index 000000000000..6386a29db04b
--- /dev/null
+++ b/nuxt.config.ts
@@ -0,0 +1,58 @@
+// For pnpm typecheck:docs to generate correct types
+
+import process from 'node:process'
+import { fileURLToPath } from 'node:url'
+import { addPluginTemplate, addRouteMiddleware, addVitePlugin } from 'nuxt/kit'
+
+export default defineNuxtConfig({
+ modules: [
+ function () {
+ if (!process.env.DOCS_TYPECHECK) { return }
+ addPluginTemplate({
+ filename: 'plugins/my-plugin.mjs',
+ getContents: () => 'export default defineNuxtPlugin({ name: \'my-plugin\' })',
+ })
+ addRouteMiddleware({
+ name: 'auth',
+ path: '#build/auth.js',
+ })
+ },
+ function (_options, nuxt) {
+ // this preserves onPrehydrate so we can make assertions on the client
+ nuxt.options.optimization.treeShake.composables.client ||= {}
+ nuxt.options.optimization.treeShake.composables.client['#app'] = nuxt.options.optimization.treeShake.composables.client['#app']?.filter(c => c !== 'onPrehydrate') || []
+
+ addVitePlugin(() => ({
+ name: 'preserve-ssr-composables',
+ enforce: 'pre',
+ transform (code, id) {
+ let replaced = false
+ if (code.includes('export function onPrehydrate')) {
+ replaced = true
+ code = code.replaceAll('if (import.meta.client) { return }', '')
+ }
+ if (id.includes('nuxt-time.vue')) {
+ replaced = true
+ code = code.replace('if (import.meta.server) {', 'if (useAttrs().ssr) {')
+ }
+ if (replaced) {
+ return code
+ }
+ },
+ }))
+ },
+ ],
+ pages: process.env.DOCS_TYPECHECK === 'true',
+ dir: {
+ app: fileURLToPath(new URL('./test/runtime/app', import.meta.url)),
+ },
+ vite: {
+ define: {
+ 'import.meta.dev': 'globalThis.__TEST_DEV__',
+ },
+ },
+ typescript: {
+ shim: process.env.DOCS_TYPECHECK === 'true',
+ hoist: ['@vitejs/plugin-vue', 'vue-router'],
+ },
+})
diff --git a/package.json b/package.json
index c20d48657ea5..4855f8141a65 100644
--- a/package.json
+++ b/package.json
@@ -1,82 +1,118 @@
{
- "name": "nuxt.js",
+ "name": "nuxt-framework",
"private": true,
"repository": {
"type": "git",
- "url": "git+https://github.com/nuxt/nuxt.js.git"
+ "url": "git+https://github.com/nuxt/nuxt.git"
},
- "workspaces": [
- "packages/*",
- "distributions/*"
- ],
+ "license": "MIT",
+ "type": "module",
"scripts": {
- "build": "yarn clean && yarn pkg",
- "changelog": "node -r esm scripts/changelog.js",
- "clean": "yarn clean:build && yarn clean:examples && yarn clean:test",
- "clean:build": "rimraf distributions/*/dist packages/*/dist",
- "clean:examples": "rimraf examples/*/dist examples/*/.nuxt",
- "clean:test": "rimraf test/fixtures/*/dist test/fixtures/*/.nuxt*/",
- "dev": "node -r esm ./scripts/dev.js",
- "postinstall": "lerna link && yarn dev",
- "ls-lint": "npx @ls-lint/ls-lint",
- "lint": "eslint --ext .js,.mjs,.vue .",
- "lint:app": "eslint-multiplexer eslint --ignore-path packages/vue-app/template/.eslintignore 'test/fixtures/!(missing-plugin)/.nuxt!(-dev)/**' | eslint-multiplexer -b",
- "nuxt": "node -r esm ./packages/cli/bin/nuxt-cli.js",
- "pkg": "node -r esm ./scripts/package",
- "test": "yarn test:fixtures && yarn test:dev && yarn test:unit",
- "test:dev": "jest test/dev --forceExit",
- "test:e2e": "jest -i test/e2e --forceExit",
- "test:fixtures": "jest test/fixtures --forceExit",
- "test:lint": "yarn lint && yarn ls-lint",
- "test:unit": "jest packages --forceExit",
- "audit": "improved-yarn-audit --ignore-dev-deps --min-severity moderate -e 1488"
+ "build": "pnpm --filter './packages/**' prepack",
+ "build:stub": "pnpm dev:prepare",
+ "dev": "pnpm play",
+ "dev:prepare": "pnpm --filter './packages/**' build:stub && nuxt prepare",
+ "debug:dev": "rm -rf **/node_modules/.cache/jiti && pnpm nuxt dev",
+ "lint": "eslint . --cache",
+ "lint:fix": "eslint . --cache --fix",
+ "lint:docs": "markdownlint --ignore-path=.gitignore ./docs && case-police 'docs/**/*.md' *.md && eslint docs --cache",
+ "lint:docs:fix": "markdownlint --ignore-path=.gitignore ./docs --fix && case-police 'docs/**/*.md' *.md --fix && eslint docs --cache --fix",
+ "lint:knip": "knip",
+ "play": "nuxt dev playground",
+ "play:build": "nuxt build playground",
+ "play:generate": "nuxt generate playground",
+ "play:preview": "nuxt preview playground",
+ "test": "pnpm test:prepare && vitest run && pnpm test:types && pnpm typecheck",
+ "test:prepare": "node ./test/prepare.ts",
+ "test:fixtures": "pnpm test:prepare && vitest run --project 'fixtures:*'",
+ "test:fixtures:dev": "vitest run --project 'fixtures:vite-dev-*'",
+ "test:fixtures:webpack": "vitest run --project 'fixtures:webpack-*'",
+ "test:runtime": "vitest run --project nuxt --project nuxt-universal --project nuxt-legacy",
+ "test:types": "pnpm --filter './test/fixtures/**' test:types",
+ "test:bundle": "pnpm build && vitest run bundle",
+ "test:unit": "vitest run --project unit",
+ "test:attw": "pnpm --filter './packages/**' test:attw",
+ "test:e2e": "playwright test",
+ "test:e2e:debug": "playwright test --debug",
+ "test:e2e:ui": "playwright test --ui",
+ "test:e2e:dev": "playwright test --project 'e2e-vite-dev'",
+ "test:e2e:webpack": "playwright test --project 'e2e-webpack-built'",
+ "test:engines": "installed-check --no-include-workspace-root --ignore-dev --workspace-ignore='test/**,playground' --workspace-ignore='packages/schema' -i rollup-plugin-visualizer",
+ "test:engines:fix": "installed-check --no-include-workspace-root --ignore-dev --workspace-ignore='test/**,playground' --workspace-ignore='packages/schema' -i rollup-plugin-visualizer --fix",
+ "typecheck": "vue-tsc --noEmit",
+ "typecheck:docs": "DOCS_TYPECHECK=true pnpm nuxt prepare && nuxt-content-twoslash verify --content-dir docs --languages html"
},
"devDependencies": {
- "@ls-lint/ls-lint": "^1.8.1",
- "@babel/core": "^7.9.0",
- "@babel/preset-env": "^7.9.5",
- "@nuxtjs/eslint-config": "^2.0.2",
- "@rollup/plugin-alias": "^3.1.0",
- "@rollup/plugin-commonjs": "^11.0.2",
- "@rollup/plugin-json": "^4.0.3",
- "@rollup/plugin-node-resolve": "7.0.0",
- "@rollup/plugin-replace": "^2.3.2",
- "@vue/server-test-utils": "^1.0.0-beta.33",
- "@vue/test-utils": "^1.0.0-beta.33",
- "babel-eslint": "^10.1.0",
- "babel-jest": "^25.4.0",
- "consola": "^2.11.3",
- "cross-spawn": "^7.0.2",
- "eslint": "6.8.0",
- "eslint-multiplexer": "^2.0.0",
- "esm": "^3.2.25",
- "execa": "^3.4.0",
- "express": "^4.17.1",
- "finalhandler": "^1.1.2",
- "fs-extra": "^8.1.0",
- "get-port": "^5.1.1",
- "glob": "^7.1.6",
- "got": "^11.0.2",
- "improved-yarn-audit": "^2.0.0",
- "is-wsl": "^2.1.1",
- "jest": "^25.4.0",
- "jsdom": "^16.2.2",
- "klaw-sync": "^6.0.0",
- "lerna": "^3.20.2",
- "lodash": "^4.17.15",
- "node-fetch": "^2.6.0",
- "node-sass": "^4.14.0",
- "puppeteer-core": "^3.0.1",
- "request": "^2.88.2",
- "rimraf": "^3.0.2",
- "rollup": "^2.7.2",
- "rollup-plugin-license": "^2.0.0",
- "sass-loader": "^8.0.2",
- "sort-package-json": "^1.42.1",
- "vue-jest": "^4.0.0-beta.2"
+ "@arethetypeswrong/cli": "0.18.2",
+ "@babel/core": "7.29.0",
+ "@babel/helper-plugin-utils": "7.28.6",
+ "@codspeed/core": "5.4.0",
+ "@codspeed/vitest-plugin": "5.4.0",
+ "@eslint/markdown": "8.0.1",
+ "@nuxt/cli": "3.35.2",
+ "@nuxt/eslint-config": "1.15.2",
+ "@nuxt/kit": "workspace:*",
+ "@nuxt/rspack-builder": "workspace:*",
+ "@nuxt/test-utils": "4.0.3",
+ "@nuxt/webpack-builder": "workspace:*",
+ "@playwright/test": "1.60.0",
+ "@rspack/core": "2.0.3",
+ "@testing-library/vue": "8.1.0",
+ "@types/babel__core": "7.20.5",
+ "@types/babel__helper-plugin-utils": "7.10.3",
+ "@types/node": "24.12.4",
+ "@types/semver": "7.7.1",
+ "@typescript-eslint/parser": "8.59.3",
+ "@unhead/vue": "3.1.0",
+ "@vitest/coverage-v8": "4.1.7",
+ "@vue/test-utils": "2.4.10",
+ "acorn": "8.16.0",
+ "case-police": "2.2.1",
+ "changelogen": "0.6.2",
+ "consola": "3.4.2",
+ "defu": "6.1.7",
+ "destr": "2.0.5",
+ "devalue": "5.8.1",
+ "eslint": "9.39.4",
+ "eslint-plugin-import-x": "4.16.2",
+ "eslint-plugin-no-only-tests": "3.4.0",
+ "eslint-plugin-perfectionist": "5.9.0",
+ "eslint-typegen": "2.3.1",
+ "estree-walker": "3.0.3",
+ "get-port-please": "3.2.0",
+ "h3": "2.0.1-rc.22",
+ "happy-dom": "20.9.0",
+ "installed-check": "10.0.1",
+ "knip": "6.14.1",
+ "magic-regexp": "0.11.0",
+ "magic-string": "0.30.21",
+ "markdownlint-cli": "0.48.0",
+ "memfs": "4.57.2",
+ "nitro": "3.0.260311-beta",
+ "nuxt": "workspace:*",
+ "nuxt-content-twoslash": "0.4.0",
+ "ofetch": "2.0.0-alpha.3",
+ "pathe": "2.0.3",
+ "pkg-pr-new": "0.0.74",
+ "playwright-core": "1.60.0",
+ "rolldown-string": "0.3.0",
+ "rollup": "4.60.4",
+ "semver": "7.8.0",
+ "sherif": "1.11.1",
+ "srvx": "0.11.15",
+ "std-env": "4.1.0",
+ "tinyexec": "1.1.2",
+ "tinyglobby": "0.2.16",
+ "ts-blank-space": "0.9.0",
+ "typescript": "6.0.3",
+ "ufo": "1.6.4",
+ "vite": "8.0.12",
+ "vitest": "4.1.7",
+ "vitest-environment-nuxt": "2.0.0",
+ "vue": "3.5.34",
+ "vue-tsc": "3.2.9",
+ "webpack": "5.106.2"
},
- "resolutions": {
- "babel-eslint/@babel/parser": "7.7.5",
- "@rollup/plugin-commonjs": "11.0.2"
- }
+ "packageManager": "pnpm@11.1.2",
+ "version": ""
}
diff --git a/packages/babel-preset-app/README.md b/packages/babel-preset-app/README.md
deleted file mode 100644
index 260f6dcd5961..000000000000
--- a/packages/babel-preset-app/README.md
+++ /dev/null
@@ -1,120 +0,0 @@
-# `@nuxt/babel-preset-app`
-
-> Default babel preset for nuxt
-
-## Usage
-
-This is the default preset used by Nuxt, which is mainly a wrapper around the `@babel/preset-env` preset. It also optionally uses the `@vue/babel-preset-jsx` preset as well as `@babel/plugin-proposal-decorators`, `@babel/plugin-proposal-class-properties`, `@babel/plugin-transform-runtime`. Furthermore the preset is adding polyfills.
-
-**Note**: Since `core-js@2` and `core-js@3` are both supported from Babel 7.4.0, we recommend directly adding `core-js` and setting the version via the [`corejs`](#corejs) option.
-
-```sh
-yarn add --dev core-js@3 @babel/runtime-corejs3
-
-# or
-
-yarn add --dev core-js@2 @babel/runtime-corejs2
-
-```
-
-Usually, no additional configuration is required. If needed though, there is an option to fine-tune the preset's behavior. Just add the following to `nuxt.config.js`:
-
-```js
-babel: {
- presets(env, [ preset, options ]) {
- return [
- [ "@nuxt/babel-preset-app", options ]
- ]
- }
-}
-```
-
-`env` is an object which contains `envName` (`server`, `client`, `modern`) and all `nuxtEnv` properties (`isDev`, `isServer`, `isClient`, `isModern`, `isLegacy`)
-
-`preset` is the preset package name `@nuxt/babel-preset-app`
-
-`options` is an object with parameters, for example:
-
-```js
-const options = {
- useBuiltIns: "entry"
-}
-```
-
-Below is a list of all available `options` parameters:
-
-### Options
-
-* **bugfixes** - [`@babel/preset-env`](https://babeljs.io/docs/en/babel-preset-env#bugfixes)
-* **configPath** - [`@babel/preset-env` parameter](https://babeljs.io/docs/en/babel-preset-env#configpath)
-* **forceAllTransforms** - '[@babel/preset-env](https://babeljs.io/docs/en/babel-preset-env#forcealltransforms)' parameter
-* **debug**, default `false` - '[@babel/preset-env](https://babeljs.io/docs/en/babel-preset-env#debug)' parameter
-* **decoratorsBeforeExport**
-* **decoratorsLegacy**, default true
-* **exclude** - '[@babel/preset-env](https://babeljs.io/docs/en/babel-preset-env#exclude)' parameter
-* **ignoreBrowserslistConfig**, defaults to value of `modern` - '[@babel/preset-env](https://babeljs.io/docs/en/babel-preset-env#ignorebrowserslistconfig)' parameter
-* **include** - '[@babel/preset-env](https://babeljs.io/docs/en/babel-preset-env#include)' parameter
-* **jsx**, default true, can be a an object passed as params to [@vue/babel-preset-jsx`](https://www.npmjs.com/package/@vue/babel-preset-jsx)
-* **loose**, default `false` - '[@babel/preset-env](https://babeljs.io/docs/en/babel-preset-env#loose)' parameter and also sets `loose=true` for `@babel/plugin-proposal-class-properties`
-* **modules**, default `false` - '[@babel/preset-env](https://babeljs.io/docs/en/babel-preset-env#modules)' parameter
-* **polyfills**, default `core-js@2: ['es6.array.iterator','es6.promise','es6.object.assign','es7.promise.finally']`, `core-js@3: ['es.array.iterator','es.promise','es.object.assign','es.promise.finally']`, more [in the corresponding repository](https://github.com/zloirock/core-js)
-* **shippedProposals** - '[@babel/preset-env](https://babeljs.io/docs/en/babel-preset-env#shippedproposals)' parameter
-* **spec** - '[@babel/preset-env](https://babeljs.io/docs/en/babel-preset-env#spec)' parameter
-* **targets** - '[@babel/preset-env](https://babeljs.io/docs/en/babel-preset-env#targets)' parameter
-* **useBuiltIns**, default `"usage"` - '[@babel/preset-env](https://babeljs.io/docs/en/babel-preset-env#usebuiltins)' parameter
-* **corejs**, default `{ version: 2 }` - '[@babel/preset-env](https://babeljs.io/docs/en/babel-preset-env#corejs)' parameter
-
-There are [detailed docs](https://babeljs.io/docs/en/babel-preset-env#options) for the parameters of '@babel/preset-env'.
-
-### Example 1. Change targets for server and client respectively
-
-```js
-export default {
- build: {
- babel: {
- presets({ envName }) {
- const envTargets = {
- client: { browsers: ["last 2 versions"], ie: 11 },
- server: { node: "current" },
- }
- return [
- [
- "@nuxt/babel-preset-app",
- {
- targets: envTargets[envName]
- }
- ]
- ]
- }
- }
- }
-}
-```
-
-### Example 2. Use core-js@3
-
-**NOTE**: Make sure that all dependencies have been upgraded to use core-js@3. If core-js@2 and core-js@3 are both dependent, babel may resolve incorrect core-js package which is hoisted by yarn/npm.
-
-```sh
-yarn add --dev core-js@3 @babel/runtime-corejs3
-```
-
-```js
-export default {
- build: {
- babel: {
- // envName: server, client, modern
- presets({ envName }) {
- return [
- [
- '@nuxt/babel-preset-app',
- {
- corejs: { version: 3 }
- }
- ]
- ]
- }
- }
- }
-}
-```
diff --git a/packages/babel-preset-app/package.json b/packages/babel-preset-app/package.json
deleted file mode 100644
index c5aec38a4a2f..000000000000
--- a/packages/babel-preset-app/package.json
+++ /dev/null
@@ -1,26 +0,0 @@
-{
- "name": "@nuxt/babel-preset-app",
- "version": "2.12.1",
- "description": "babel-preset-app for nuxt.js",
- "repository": "nuxt/nuxt.js",
- "license": "MIT",
- "author": "Evan You",
- "contributors": [
- "Clark Du"
- ],
- "main": "src/index.js",
- "dependencies": {
- "@babel/core": "^7.9.0",
- "@babel/helper-compilation-targets": "^7.8.7",
- "@babel/plugin-proposal-class-properties": "^7.8.3",
- "@babel/plugin-proposal-decorators": "^7.8.3",
- "@babel/plugin-transform-runtime": "^7.9.0",
- "@babel/preset-env": "^7.9.5",
- "@babel/runtime": "^7.9.2",
- "@vue/babel-preset-jsx": "^1.1.2",
- "core-js": "^2.6.5"
- },
- "publishConfig": {
- "access": "public"
- }
-}
diff --git a/packages/babel-preset-app/src/index.js b/packages/babel-preset-app/src/index.js
deleted file mode 100644
index 5d6da53e26b3..000000000000
--- a/packages/babel-preset-app/src/index.js
+++ /dev/null
@@ -1,159 +0,0 @@
-const coreJsMeta = {
- 2: {
- prefixes: {
- es6: 'es6',
- es7: 'es7'
- },
- builtIns: '@babel/compat-data/corejs2-built-ins'
- },
- 3: {
- prefixes: {
- es6: 'es',
- es7: 'es'
- },
- builtIns: 'core-js-compat/data'
- }
-}
-
-function getDefaultPolyfills (corejs) {
- const { prefixes: { es6, es7 } } = coreJsMeta[corejs.version]
- return [
- // Promise polyfill alone doesn't work in IE,
- // Needs this as well. see: #1642
- `${es6}.array.iterator`,
- // This is required for webpack code splitting, vuex etc.
- `${es6}.promise`,
- // this is needed for object rest spread support in templates
- // as vue-template-es2015-compiler 1.8+ compiles it to Object.assign() calls.
- `${es6}.object.assign`,
- // #2012 es7.promise replaces native Promise in FF and causes missing finally
- `${es7}.promise.finally`
- ]
-}
-
-function getPolyfills (targets, includes, { ignoreBrowserslistConfig, configPath, corejs }) {
- const { default: getTargets, isRequired } = require('@babel/helper-compilation-targets')
- const builtInsList = require(coreJsMeta[corejs.version].builtIns)
- const builtInTargets = getTargets(targets, {
- ignoreBrowserslistConfig,
- configPath
- })
-
- return includes.filter(item => isRequired(
- 'nuxt-polyfills',
- builtInTargets,
- {
- compatData: { 'nuxt-polyfills': builtInsList[item] }
- }
- ))
-}
-
-module.exports = (api, options = {}) => {
- const presets = []
- const plugins = []
-
- const envName = api.env()
-
- const {
- bugfixes,
- polyfills: userPolyfills,
- loose = false,
- debug = false,
- useBuiltIns = 'usage',
- modules = false,
- spec,
- ignoreBrowserslistConfig = envName === 'modern',
- configPath,
- include,
- exclude,
- shippedProposals,
- forceAllTransforms,
- decoratorsBeforeExport,
- decoratorsLegacy,
- absoluteRuntime
- } = options
-
- let { corejs = { version: 2 } } = options
-
- if (typeof corejs !== 'object') {
- corejs = { version: Number(corejs) }
- }
-
- const defaultTargets = {
- server: { node: 'current' },
- client: { ie: 9 },
- modern: { esmodules: true }
- }
-
- let { targets = defaultTargets[envName] } = options
-
- // modern mode can only be { esmodules: true }
- if (envName === 'modern') {
- targets = defaultTargets.modern
- }
-
- const polyfills = []
-
- if (envName === 'client' && useBuiltIns === 'usage') {
- polyfills.push(
- ...getPolyfills(
- targets,
- userPolyfills || getDefaultPolyfills(corejs),
- {
- ignoreBrowserslistConfig,
- configPath,
- corejs
- }
- )
- )
- plugins.push([require('./polyfills-plugin'), { polyfills }])
- }
-
- // Pass options along to babel-preset-env
- presets.push([
- require('@babel/preset-env'), {
- bugfixes,
- spec,
- loose,
- debug,
- modules,
- targets,
- useBuiltIns,
- corejs,
- ignoreBrowserslistConfig,
- configPath,
- include,
- exclude: polyfills.concat(exclude || []),
- shippedProposals,
- forceAllTransforms
- }
- ])
-
- // JSX
- if (options.jsx !== false) {
- presets.push([require('@vue/babel-preset-jsx'), Object.assign({}, options.jsx)])
- }
-
- plugins.push(
- [require('@babel/plugin-proposal-decorators'), {
- decoratorsBeforeExport,
- legacy: decoratorsLegacy !== false
- }],
- [require('@babel/plugin-proposal-class-properties'), { loose: true }]
- )
-
- // Transform runtime, but only for helpers
- plugins.push([require('@babel/plugin-transform-runtime'), {
- regenerator: useBuiltIns !== 'usage',
- corejs: false,
- helpers: useBuiltIns === 'usage',
- useESModules: envName !== 'server',
- absoluteRuntime
- }])
-
- return {
- sourceType: 'unambiguous',
- presets,
- plugins
- }
-}
diff --git a/packages/babel-preset-app/src/polyfills-plugin.js b/packages/babel-preset-app/src/polyfills-plugin.js
deleted file mode 100644
index 2d0b32b476d9..000000000000
--- a/packages/babel-preset-app/src/polyfills-plugin.js
+++ /dev/null
@@ -1,24 +0,0 @@
-// Add polyfill imports to the first file encountered.
-module.exports = ({ types }) => {
- let entryFile
- return {
- name: 'inject-polyfills',
- visitor: {
- Program (path, state) {
- if (!entryFile) {
- entryFile = state.filename
- } else if (state.filename !== entryFile) {
- return
- }
-
- const { polyfills } = state.opts
- const { createImport } = require('@babel/preset-env/lib/utils')
-
- // Imports are injected in reverse order
- polyfills.slice().reverse().forEach((p) => {
- createImport(path, p)
- })
- }
- }
- }
-}
diff --git a/packages/builder/package.js b/packages/builder/package.js
deleted file mode 100644
index 19d0ef6e2d14..000000000000
--- a/packages/builder/package.js
+++ /dev/null
@@ -1,3 +0,0 @@
-export default {
- build: true
-}
diff --git a/packages/builder/package.json b/packages/builder/package.json
deleted file mode 100644
index 7c9a17b2b424..000000000000
--- a/packages/builder/package.json
+++ /dev/null
@@ -1,31 +0,0 @@
-{
- "name": "@nuxt/builder",
- "version": "2.12.1",
- "repository": "nuxt/nuxt.js",
- "license": "MIT",
- "main": "dist/builder.js",
- "files": [
- "dist"
- ],
- "dependencies": {
- "@nuxt/devalue": "^1.2.4",
- "@nuxt/utils": "2.12.1",
- "@nuxt/vue-app": "2.12.1",
- "@nuxt/webpack": "2.12.1",
- "chalk": "^3.0.0",
- "chokidar": "^3.3.1",
- "consola": "^2.11.3",
- "fs-extra": "^8.1.0",
- "glob": "^7.1.6",
- "hash-sum": "^2.0.0",
- "ignore": "^5.1.4",
- "lodash": "^4.17.15",
- "pify": "^4.0.1",
- "semver": "^7.3.2",
- "serialize-javascript": "^3.0.0",
- "upath": "^1.2.0"
- },
- "publishConfig": {
- "access": "public"
- }
-}
diff --git a/packages/builder/src/builder.js b/packages/builder/src/builder.js
deleted file mode 100644
index b40b6f93f9aa..000000000000
--- a/packages/builder/src/builder.js
+++ /dev/null
@@ -1,812 +0,0 @@
-import path from 'path'
-import chokidar from 'chokidar'
-import consola from 'consola'
-import fsExtra from 'fs-extra'
-import Glob from 'glob'
-import hash from 'hash-sum'
-import pify from 'pify'
-import upath from 'upath'
-import semver from 'semver'
-import chalk from 'chalk'
-
-import debounce from 'lodash/debounce'
-import omit from 'lodash/omit'
-import template from 'lodash/template'
-import uniq from 'lodash/uniq'
-import uniqBy from 'lodash/uniqBy'
-
-import {
- r,
- createRoutes,
- relativeTo,
- waitFor,
- determineGlobals,
- stripWhitespace,
- isIndexFileAndFolder,
- scanRequireTree
-} from '@nuxt/utils'
-
-import Ignore from './ignore'
-import BuildContext from './context/build'
-import TemplateContext from './context/template'
-
-const glob = pify(Glob)
-export default class Builder {
- constructor (nuxt, bundleBuilder) {
- this.nuxt = nuxt
- this.plugins = []
- this.options = nuxt.options
- this.globals = determineGlobals(nuxt.options.globalName, nuxt.options.globals)
- this.watchers = {
- files: null,
- custom: null,
- restart: null
- }
-
- this.supportedExtensions = ['vue', 'js', ...(this.options.build.additionalExtensions || [])]
-
- // Helper to resolve build paths
- this.relativeToBuild = (...args) => relativeTo(this.options.buildDir, ...args)
-
- this._buildStatus = STATUS.INITIAL
-
- // Hooks for watch lifecycle
- if (this.options.dev) {
- // Start watching after initial render
- this.nuxt.hook('build:done', () => {
- consola.info('Waiting for file changes')
- this.watchClient()
- this.watchRestart()
- })
-
- // Enable HMR for serverMiddleware
- this.serverMiddlewareHMR()
-
- // Close hook
- this.nuxt.hook('close', () => this.close())
- }
-
- if (this.options.build.analyze) {
- this.nuxt.hook('build:done', () => {
- consola.warn('Notice: Please do not deploy bundles built with "analyze" mode, they\'re for analysis purposes only.')
- })
- }
-
- // Resolve template
- this.template = this.options.build.template || '@nuxt/vue-app'
- if (typeof this.template === 'string') {
- this.template = this.nuxt.resolver.requireModule(this.template).template
- }
-
- // Create a new bundle builder
- this.bundleBuilder = this.getBundleBuilder(bundleBuilder)
-
- this.ignore = new Ignore({
- rootDir: this.options.srcDir,
- ignoreArray: this.options.ignore
- })
- }
-
- getBundleBuilder (BundleBuilder) {
- if (typeof BundleBuilder === 'object') {
- return BundleBuilder
- }
-
- const context = new BuildContext(this)
-
- if (typeof BundleBuilder !== 'function') {
- ({ BundleBuilder } = require('@nuxt/webpack'))
- }
-
- return new BundleBuilder(context)
- }
-
- forGenerate () {
- this.bundleBuilder.forGenerate()
- }
-
- async build () {
- // Avoid calling build() method multiple times when dev:true
- if (this._buildStatus === STATUS.BUILD_DONE && this.options.dev) {
- return this
- }
- // If building
- if (this._buildStatus === STATUS.BUILDING) {
- await waitFor(1000)
- return this.build()
- }
- this._buildStatus = STATUS.BUILDING
-
- if (this.options.dev) {
- consola.info('Preparing project for development')
- consola.info('Initial build may take a while')
- } else {
- consola.info('Production build')
- }
-
- // Wait for nuxt ready
- await this.nuxt.ready()
-
- // Call before hook
- await this.nuxt.callHook('build:before', this, this.options.build)
-
- await this.validatePages()
-
- // Validate template
- try {
- this.validateTemplate()
- } catch (err) {
- consola.fatal(err)
- }
-
- consola.success('Builder initialized')
-
- consola.debug(`App root: ${this.options.srcDir}`)
-
- // Create .nuxt/, .nuxt/components and .nuxt/dist folders
- await fsExtra.remove(r(this.options.buildDir))
- const buildDirs = [r(this.options.buildDir, 'components')]
- if (!this.options.dev) {
- buildDirs.push(
- r(this.options.buildDir, 'dist', 'client'),
- r(this.options.buildDir, 'dist', 'server')
- )
- }
- await Promise.all(buildDirs.map(dir => fsExtra.mkdirp(dir)))
-
- // Call ready hook
- await this.nuxt.callHook('builder:prepared', this, this.options.build)
-
- // Generate routes and interpret the template files
- await this.generateRoutesAndFiles()
-
- // Add vue-app template dir to watchers
- this.options.build.watch.push(this.globPathWithExtensions(this.template.dir))
-
- await this.resolvePlugins()
-
- // Start bundle build: webpack, rollup, parcel...
- await this.bundleBuilder.build()
-
- // Flag to set that building is done
- this._buildStatus = STATUS.BUILD_DONE
-
- // Call done hook
- await this.nuxt.callHook('build:done', this)
-
- return this
- }
-
- // Check if pages dir exists and warn if not
- async validatePages () {
- this._nuxtPages = typeof this.options.build.createRoutes !== 'function'
-
- if (
- !this._nuxtPages ||
- await fsExtra.exists(path.join(this.options.srcDir, this.options.dir.pages))
- ) {
- return
- }
-
- const dir = this.options.srcDir
- if (await fsExtra.exists(path.join(this.options.srcDir, '..', this.options.dir.pages))) {
- throw new Error(
- `No \`${this.options.dir.pages}\` directory found in ${dir}. Did you mean to run \`nuxt\` in the parent (\`../\`) directory?`
- )
- }
-
- this._defaultPage = true
- consola.warn(`No \`${this.options.dir.pages}\` directory found in ${dir}. Using the default built-in page.`)
- }
-
- validateTemplate () {
- // Validate template dependencies
- const templateDependencies = this.template.dependencies
- for (const depName in templateDependencies) {
- const depVersion = templateDependencies[depName]
-
- // Load installed version
- const pkg = this.nuxt.resolver.requireModule(path.join(depName, 'package.json'))
- if (pkg) {
- const validVersion = semver.satisfies(pkg.version, depVersion)
- if (!validVersion) {
- consola.warn(`${depName}@${depVersion} is recommended but ${depName}@${pkg.version} is installed!`)
- }
- } else {
- consola.warn(`${depName}@${depVersion} is required but not installed!`)
- }
- }
- }
-
- globPathWithExtensions (path) {
- return `${path}/**/*.{${this.supportedExtensions.join(',')}}`
- }
-
- createTemplateContext () {
- return new TemplateContext(this, this.options)
- }
-
- async generateRoutesAndFiles () {
- consola.debug('Generating nuxt files')
-
- this.plugins = Array.from(await this.normalizePlugins())
-
- const templateContext = this.createTemplateContext()
-
- await Promise.all([
- this.resolveLayouts(templateContext),
- this.resolveRoutes(templateContext),
- this.resolveStore(templateContext),
- this.resolveMiddleware(templateContext)
- ])
-
- this.addOptionalTemplates(templateContext)
-
- await this.resolveCustomTemplates(templateContext)
-
- await this.resolveLoadingIndicator(templateContext)
-
- await this.compileTemplates(templateContext)
-
- consola.success('Nuxt files generated')
- }
-
- async normalizePlugins () {
- // options.extendPlugins allows for returning a new plugins array
- if (typeof this.options.extendPlugins === 'function') {
- const extendedPlugins = this.options.extendPlugins(this.options.plugins)
-
- if (Array.isArray(extendedPlugins)) {
- this.options.plugins = extendedPlugins
- }
- }
-
- // extendPlugins hook only supports in-place modifying
- await this.nuxt.callHook('builder:extendPlugins', this.options.plugins)
-
- const modes = ['client', 'server']
- const modePattern = new RegExp(`\\.(${modes.join('|')})(\\.\\w+)*$`)
- return uniqBy(
- this.options.plugins.map((p) => {
- if (typeof p === 'string') {
- p = { src: p }
- }
- const pluginBaseName = path.basename(p.src, path.extname(p.src)).replace(
- /[^a-zA-Z?\d\s:]/g,
- ''
- )
-
- if (p.ssr === false) {
- p.mode = 'client'
- } else if (p.mode === undefined) {
- p.mode = 'all'
- p.src.replace(modePattern, (_, mode) => {
- if (modes.includes(mode)) {
- p.mode = mode
- }
- })
- } else if (!['client', 'server', 'all'].includes(p.mode)) {
- consola.warn(`Invalid plugin mode (server/client/all): '${p.mode}'. Falling back to 'all'`)
- p.mode = 'all'
- }
-
- return {
- src: this.nuxt.resolver.resolveAlias(p.src),
- mode: p.mode,
- name: 'nuxt_plugin_' + pluginBaseName + '_' + hash(p.src)
- }
- }),
- p => p.name
- )
- }
-
- addOptionalTemplates (templateContext) {
- if (this.options.build.indicator) {
- templateContext.templateFiles.push('components/nuxt-build-indicator.vue')
- }
-
- if (this.options.loading !== false) {
- templateContext.templateFiles.push('components/nuxt-loading.vue')
- }
- }
-
- async resolveFiles (dir, cwd = this.options.srcDir) {
- return this.ignore.filter(await glob(this.globPathWithExtensions(dir), {
- cwd,
- follow: this.options.build.followSymlinks
- }))
- }
-
- async resolveRelative (dir) {
- const dirPrefix = new RegExp(`^${dir}/`)
- return (await this.resolveFiles(dir)).map(file => ({ src: file.replace(dirPrefix, '') }))
- }
-
- async resolveLayouts ({ templateVars, templateFiles }) {
- if (!this.options.features.layouts) {
- return
- }
-
- if (await fsExtra.exists(path.resolve(this.options.srcDir, this.options.dir.layouts))) {
- for (const file of await this.resolveFiles(this.options.dir.layouts)) {
- const name = file
- .replace(new RegExp(`^${this.options.dir.layouts}/`), '')
- .replace(new RegExp(`\\.(${this.supportedExtensions.join('|')})$`), '')
-
- // Layout Priority: module.addLayout > .vue file > other extensions
- if (name === 'error') {
- if (!templateVars.components.ErrorPage) {
- templateVars.components.ErrorPage = this.relativeToBuild(
- this.options.srcDir,
- file
- )
- }
- } else if (this.options.layouts[name]) {
- consola.warn(`Duplicate layout registration, "${name}" has been registered as "${this.options.layouts[name]}"`)
- } else if (!templateVars.layouts[name] || /\.vue$/.test(file)) {
- templateVars.layouts[name] = this.relativeToBuild(
- this.options.srcDir,
- file
- )
- }
- }
- }
-
- // If no default layout, create its folder and add the default folder
- if (!templateVars.layouts.default) {
- await fsExtra.mkdirp(r(this.options.buildDir, 'layouts'))
- templateFiles.push('layouts/default.vue')
- templateVars.layouts.default = './layouts/default.vue'
- }
- }
-
- async resolveRoutes ({ templateVars }) {
- consola.debug('Generating routes...')
- const { routeNameSplitter, trailingSlash } = this.options.router
-
- if (this._defaultPage) {
- templateVars.router.routes = createRoutes({
- files: ['index.vue'],
- srcDir: this.template.dir + '/pages',
- routeNameSplitter,
- trailingSlash
- })
- } else if (this._nuxtPages) {
- // Use nuxt.js createRoutes bases on pages/
- const files = {}
- const ext = new RegExp(`\\.(${this.supportedExtensions.join('|')})$`)
- for (const page of await this.resolveFiles(this.options.dir.pages)) {
- const key = page.replace(ext, '')
- // .vue file takes precedence over other extensions
- if (/\.vue$/.test(page) || !files[key]) {
- files[key] = page.replace(/(['"])/g, '\\$1')
- }
- }
- templateVars.router.routes = createRoutes({
- files: Object.values(files),
- srcDir: this.options.srcDir,
- pagesDir: this.options.dir.pages,
- routeNameSplitter,
- supportedExtensions: this.supportedExtensions,
- trailingSlash
- })
- } else { // If user defined a custom method to create routes
- templateVars.router.routes = await this.options.build.createRoutes(
- this.options.srcDir
- )
- }
-
- await this.nuxt.callHook(
- 'build:extendRoutes',
- templateVars.router.routes,
- r
- )
- // router.extendRoutes method
- if (typeof this.options.router.extendRoutes === 'function') {
- // let the user extend the routes
- const extendedRoutes = this.options.router.extendRoutes(
- templateVars.router.routes,
- r
- )
- // Only overwrite routes when something is returned for backwards compatibility
- if (extendedRoutes !== undefined) {
- templateVars.router.routes = extendedRoutes
- }
- }
-
- // Make routes accessible for other modules and webpack configs
- this.routes = templateVars.router.routes
- }
-
- async resolveStore ({ templateVars, templateFiles }) {
- // Add store if needed
- if (!this.options.features.store || !this.options.store) {
- return
- }
-
- templateVars.storeModules = (await this.resolveRelative(this.options.dir.store))
- .sort(({ src: p1 }, { src: p2 }) => {
- // modules are sorted from low to high priority (for overwriting properties)
- let res = p1.split('/').length - p2.split('/').length
- if (res === 0 && p1.includes('/index.')) {
- res = -1
- } else if (res === 0 && p2.includes('/index.')) {
- res = 1
- }
- return res
- })
-
- templateFiles.push('store.js')
- }
-
- async resolveMiddleware ({ templateVars, templateFiles }) {
- if (!this.options.features.middleware) {
- return
- }
-
- const middleware = await this.resolveRelative(this.options.dir.middleware)
- const extRE = new RegExp(`\\.(${this.supportedExtensions.join('|')})$`)
- templateVars.middleware = middleware.map(({ src }) => {
- const name = src.replace(extRE, '')
- const dst = this.relativeToBuild(this.options.srcDir, this.options.dir.middleware, src)
- return { name, src, dst }
- })
-
- templateFiles.push('middleware.js')
- }
-
- async resolveCustomTemplates (templateContext) {
- // Sanitize custom template files
- this.options.build.templates = this.options.build.templates.map((t) => {
- const src = t.src || t
- return {
- src: r(this.options.srcDir, src),
- dst: t.dst || path.basename(src),
- custom: true,
- ...(typeof t === 'object' ? t : undefined)
- }
- })
-
- const customTemplateFiles = this.options.build.templates.map(t => t.dst || path.basename(t.src || t))
-
- const templatePaths = uniq([
- // Modules & user provided templates
- // first custom to keep their index
- ...customTemplateFiles,
- // @nuxt/vue-app templates
- ...templateContext.templateFiles
- ])
-
- const appDir = path.resolve(this.options.srcDir, this.options.dir.app)
-
- templateContext.templateFiles = await Promise.all(templatePaths.map(async (file) => {
- // Use custom file if provided in build.templates[]
- const customTemplateIndex = customTemplateFiles.indexOf(file)
- const customTemplate = customTemplateIndex !== -1 ? this.options.build.templates[customTemplateIndex] : null
- let src = customTemplate ? (customTemplate.src || customTemplate) : r(this.template.dir, file)
-
- // Allow override templates using a file with same name in ${srcDir}/app
- const customAppFile = path.resolve(this.options.srcDir, this.options.dir.app, file)
- const customAppFileExists = customAppFile.startsWith(appDir) && await fsExtra.exists(customAppFile)
- if (customAppFileExists) {
- src = customAppFile
- }
-
- return {
- src,
- dst: file,
- custom: Boolean(customAppFileExists || customTemplate),
- options: (customTemplate && customTemplate.options) || {}
- }
- }))
- }
-
- async resolveLoadingIndicator ({ templateFiles }) {
- if (!this.options.loadingIndicator.name) {
- return
- }
- let indicatorPath = path.resolve(
- this.template.dir,
- 'views/loading',
- this.options.loadingIndicator.name + '.html'
- )
-
- let customIndicator = false
- if (!await fsExtra.exists(indicatorPath)) {
- indicatorPath = this.nuxt.resolver.resolveAlias(
- this.options.loadingIndicator.name
- )
-
- if (await fsExtra.exists(indicatorPath)) {
- customIndicator = true
- } else {
- indicatorPath = null
- }
- }
-
- if (!indicatorPath) {
- consola.error(
- `Could not fetch loading indicator: ${
- this.options.loadingIndicator.name
- }`
- )
- return
- }
-
- templateFiles.push({
- src: indicatorPath,
- dst: 'loading.html',
- custom: customIndicator,
- options: this.options.loadingIndicator
- })
- }
-
- async compileTemplates (templateContext) {
- // Prepare template options
- const { templateVars, templateFiles, templateOptions } = templateContext
-
- await this.nuxt.callHook('build:templates', {
- templateVars,
- templatesFiles: templateFiles,
- resolve: r
- })
-
- templateOptions.imports = {
- ...templateOptions.imports,
- resolvePath: this.nuxt.resolver.resolvePath,
- resolveAlias: this.nuxt.resolver.resolveAlias,
- relativeToBuild: this.relativeToBuild
- }
-
- // Interpret and move template files to .nuxt/
- await Promise.all(
- templateFiles.map(async (templateFile) => {
- const { src, dst, custom } = templateFile
-
- // Add custom templates to watcher
- if (custom) {
- this.options.build.watch.push(src)
- }
-
- // Render template to dst
- const fileContent = await fsExtra.readFile(src, 'utf8')
-
- let content
- try {
- const templateFunction = template(fileContent, templateOptions)
- content = stripWhitespace(
- templateFunction({
- ...templateVars,
- ...templateFile
- })
- )
- } catch (err) {
- throw new Error(`Could not compile template ${src}: ${err.message}`)
- }
-
- // Ensure parent dir exits and write file
- const relativePath = r(this.options.buildDir, dst)
- await fsExtra.outputFile(relativePath, content, 'utf8')
- })
- )
- }
-
- resolvePlugins () {
- // Check plugins exist then set alias to their real path
- return Promise.all(this.plugins.map(async (p) => {
- const ext = '{?(.+([^.])),/index.+([^.])}'
- const pluginFiles = await glob(`${p.src}${ext}`)
-
- if (!pluginFiles || pluginFiles.length === 0) {
- throw new Error(`Plugin not found: ${p.src}`)
- }
-
- if (pluginFiles.length > 1 && !isIndexFileAndFolder(pluginFiles)) {
- consola.warn({
- message: `Found ${pluginFiles.length} plugins that match the configuration, suggest to specify extension:`,
- additional: '\n' + pluginFiles.map(x => `- ${x}`).join('\n')
- })
- }
-
- p.src = this.relativeToBuild(p.src)
- }))
- }
-
- // TODO: Uncomment when generateConfig enabled again
- // async generateConfig() {
- // const config = path.resolve(this.options.buildDir, 'build.config.js')
- // const options = omit(this.options, Options.unsafeKeys)
- // await fsExtra.writeFile(
- // config,
- // `export default ${JSON.stringify(options, null, ' ')}`,
- // 'utf8'
- // )
- // }
-
- createFileWatcher (patterns, events, listener, watcherCreatedCallback) {
- const options = this.options.watchers.chokidar
- const watcher = chokidar.watch(patterns, options)
-
- for (const event of events) {
- watcher.on(event, listener)
- }
-
- // TODO: due to fixes in chokidar this isnt used anymore and could be removed in Nuxt v3
- const { rewatchOnRawEvents } = this.options.watchers
- if (rewatchOnRawEvents && Array.isArray(rewatchOnRawEvents)) {
- watcher.on('raw', (_event) => {
- if (rewatchOnRawEvents.includes(_event)) {
- watcher.close()
-
- listener()
- this.createFileWatcher(patterns, events, listener, watcherCreatedCallback)
- }
- })
- }
-
- if (typeof watcherCreatedCallback === 'function') {
- watcherCreatedCallback(watcher)
- }
- }
-
- assignWatcher (key) {
- return (watcher) => {
- if (this.watchers[key]) {
- this.watchers[key].close()
- }
- this.watchers[key] = watcher
- }
- }
-
- watchClient () {
- let patterns = [
- r(this.options.srcDir, this.options.dir.layouts),
- r(this.options.srcDir, this.options.dir.middleware)
- ]
-
- if (this.options.store) {
- patterns.push(r(this.options.srcDir, this.options.dir.store))
- }
-
- if (this._nuxtPages && !this._defaultPage) {
- patterns.push(r(this.options.srcDir, this.options.dir.pages))
- }
-
- patterns = patterns.map((path, ...args) => upath.normalizeSafe(this.globPathWithExtensions(path), ...args))
-
- const refreshFiles = debounce(() => this.generateRoutesAndFiles(), 200)
-
- // Watch for src Files
- this.createFileWatcher(patterns, ['add', 'unlink'], refreshFiles, this.assignWatcher('files'))
-
- // Watch for custom provided files
- const customPatterns = uniq([
- ...this.options.build.watch,
- ...Object.values(omit(this.options.build.styleResources, ['options']))
- ]).map(upath.normalizeSafe)
-
- if (customPatterns.length === 0) {
- return
- }
-
- this.createFileWatcher(customPatterns, ['change'], refreshFiles, this.assignWatcher('custom'))
-
- // Watch for app/ files
- this.createFileWatcher([r(this.options.srcDir, this.options.dir.app)], ['add', 'change', 'unlink'], refreshFiles, this.assignWatcher('app'))
- }
-
- serverMiddlewareHMR () {
- // Check nuxt.server dependency
- if (!this.nuxt.server) {
- return
- }
-
- // Get registered server middleware with path
- const entries = this.nuxt.server.serverMiddlewarePaths()
-
- // Resolve dependency tree
- const deps = new Set()
- const dep2Entry = {}
-
- for (const entry of entries) {
- for (const dep of scanRequireTree(entry)) {
- deps.add(dep)
- if (!dep2Entry[dep]) {
- dep2Entry[dep] = new Set()
- }
- dep2Entry[dep].add(entry)
- }
- }
-
- // Create watcher
- this.createFileWatcher(
- Array.from(deps),
- ['all'],
- debounce((event, fileName) => {
- if (!dep2Entry[fileName]) {
- return // #7097
- }
- for (const entry of dep2Entry[fileName]) {
- // Reload entry
- let newItem
- try {
- newItem = this.nuxt.server.replaceMiddleware(entry, entry)
- } catch (error) {
- consola.error(error)
- consola.error(`[HMR Error]: ${error}`)
- }
-
- if (!newItem) {
- // Full reload if HMR failed
- return this.nuxt.callHook('watch:restart', { event, path: fileName })
- }
-
- // Log
- consola.info(`[HMR] ${chalk.cyan(newItem.route || '/')} (${chalk.grey(fileName)})`)
- }
- // Tree may be changed so recreate watcher
- this.serverMiddlewareHMR()
- }, 200),
- this.assignWatcher('serverMiddleware')
- )
- }
-
- watchRestart () {
- const nuxtRestartWatch = [
- // Custom watchers
- ...this.options.watch
- ].map(this.nuxt.resolver.resolveAlias)
-
- if (this.ignore.ignoreFile) {
- nuxtRestartWatch.push(this.ignore.ignoreFile)
- }
- // If default page displayed, watch for first page creation
- if (this._nuxtPages && this._defaultPage) {
- nuxtRestartWatch.push(path.join(this.options.srcDir, this.options.dir.pages))
- }
- // If store not activated, watch for a file in the directory
- if (!this.options.store) {
- nuxtRestartWatch.push(path.join(this.options.srcDir, this.options.dir.store))
- }
-
- this.createFileWatcher(
- nuxtRestartWatch,
- ['all'],
- async (event, fileName) => {
- if (['add', 'change', 'unlink'].includes(event) === false) {
- return
- }
- await this.nuxt.callHook('watch:fileChanged', this, fileName) // Legacy
- await this.nuxt.callHook('watch:restart', { event, path: fileName })
- },
- this.assignWatcher('restart')
- )
- }
-
- unwatch () {
- for (const watcher in this.watchers) {
- this.watchers[watcher].close()
- }
- }
-
- async close () {
- if (this.__closed) {
- return
- }
- this.__closed = true
-
- // Unwatch
- this.unwatch()
-
- // Close bundleBuilder
- if (typeof this.bundleBuilder.close === 'function') {
- await this.bundleBuilder.close()
- }
- }
-}
-
-const STATUS = {
- INITIAL: 1,
- BUILD_DONE: 2,
- BUILDING: 3
-}
diff --git a/packages/builder/src/context/build.js b/packages/builder/src/context/build.js
deleted file mode 100644
index d02bea82fc89..000000000000
--- a/packages/builder/src/context/build.js
+++ /dev/null
@@ -1,16 +0,0 @@
-export default class BuildContext {
- constructor (builder) {
- this._builder = builder
- this.nuxt = builder.nuxt
- this.options = builder.nuxt.options
- this.isStatic = false
- }
-
- get buildOptions () {
- return this.options.build
- }
-
- get plugins () {
- return this._builder.plugins
- }
-}
diff --git a/packages/builder/src/context/template.js b/packages/builder/src/context/template.js
deleted file mode 100644
index fe5f04e93888..000000000000
--- a/packages/builder/src/context/template.js
+++ /dev/null
@@ -1,81 +0,0 @@
-import hash from 'hash-sum'
-import consola from 'consola'
-import uniqBy from 'lodash/uniqBy'
-import serialize from 'serialize-javascript'
-
-import devalue from '@nuxt/devalue'
-import { r, wp, wChunk, serializeFunction } from '@nuxt/utils'
-
-export default class TemplateContext {
- constructor (builder, options) {
- this.templateFiles = Array.from(builder.template.files)
- this.templateVars = {
- nuxtOptions: options,
- features: options.features,
- extensions: options.extensions
- .map(ext => ext.replace(/^\./, ''))
- .join('|'),
- messages: options.messages,
- splitChunks: options.build.splitChunks,
- uniqBy,
- isDev: options.dev,
- isTest: options.test,
- debug: options.debug,
- buildIndicator: options.dev && options.build.indicator,
- vue: { config: options.vue.config },
- fetch: options.fetch,
- mode: options.mode,
- router: options.router,
- env: options.env,
- head: options.head,
- store: options.features.store ? options.store : false,
- globalName: options.globalName,
- globals: builder.globals,
- css: options.css,
- plugins: builder.plugins,
- appPath: './App.js',
- layouts: Object.assign({}, options.layouts),
- loading:
- typeof options.loading === 'string'
- ? builder.relativeToBuild(options.srcDir, options.loading)
- : options.loading,
- pageTransition: options.pageTransition,
- layoutTransition: options.layoutTransition,
- rootDir: options.rootDir,
- srcDir: options.srcDir,
- dir: options.dir,
- components: {
- ErrorPage: options.ErrorPage
- ? builder.relativeToBuild(options.ErrorPage)
- : null
- }
- }
- }
-
- get templateOptions () {
- let lodash = null
-
- return {
- imports: {
- serialize,
- serializeFunction,
- devalue,
- hash,
- r,
- wp,
- wChunk,
- // Legacy support: https://github.com/nuxt/nuxt.js/issues/4350
- _: new Proxy({}, {
- get (target, prop) {
- if (!lodash) {
- consola.warn('Avoid using _ inside templates')
- lodash = require('lodash')
- }
- return lodash[prop]
- }
- })
- },
- interpolate: /<%=([\s\S]+?)%>/g
- }
- }
-}
diff --git a/packages/builder/src/ignore.js b/packages/builder/src/ignore.js
deleted file mode 100644
index d92936896017..000000000000
--- a/packages/builder/src/ignore.js
+++ /dev/null
@@ -1,59 +0,0 @@
-import path from 'path'
-import fs from 'fs-extra'
-import ignore from 'ignore'
-
-export default class Ignore {
- constructor (options) {
- this.rootDir = options.rootDir
- this.ignoreOptions = options.ignoreOptions
- this.ignoreArray = options.ignoreArray
- this.addIgnoresRules()
- }
-
- static get IGNORE_FILENAME () {
- return '.nuxtignore'
- }
-
- findIgnoreFile () {
- if (!this.ignoreFile) {
- const ignoreFile = path.resolve(this.rootDir, Ignore.IGNORE_FILENAME)
- if (fs.existsSync(ignoreFile) && fs.statSync(ignoreFile).isFile()) {
- this.ignoreFile = ignoreFile
- this.ignore = ignore(this.ignoreOptions)
- }
- }
- return this.ignoreFile
- }
-
- readIgnoreFile () {
- if (this.findIgnoreFile()) {
- return fs.readFileSync(this.ignoreFile, 'utf8')
- }
- }
-
- addIgnoresRules () {
- const content = this.readIgnoreFile()
- if (content) {
- this.ignore.add(content)
- }
- if (this.ignoreArray && this.ignoreArray.length > 0) {
- if (!this.ignore) {
- this.ignore = ignore(this.ignoreOptions)
- }
- this.ignore.add(this.ignoreArray)
- }
- }
-
- filter (paths) {
- if (this.ignore) {
- return this.ignore.filter([].concat(paths || []))
- }
- return paths
- }
-
- reload () {
- delete this.ignore
- delete this.ignoreFile
- this.addIgnoresRules()
- }
-}
diff --git a/packages/builder/src/index.js b/packages/builder/src/index.js
deleted file mode 100644
index e00c399decdc..000000000000
--- a/packages/builder/src/index.js
+++ /dev/null
@@ -1,10 +0,0 @@
-import Builder from './builder'
-export { default as Builder } from './builder'
-
-export function getBuilder (nuxt) {
- return new Builder(nuxt)
-}
-
-export function build (nuxt) {
- return getBuilder(nuxt).build()
-}
diff --git a/packages/builder/test/__utils__/index.js b/packages/builder/test/__utils__/index.js
deleted file mode 100644
index e703b3ff7ca7..000000000000
--- a/packages/builder/test/__utils__/index.js
+++ /dev/null
@@ -1,21 +0,0 @@
-export const createNuxt = () => ({
- options: {
- globalName: 'global_name',
- globals: [],
- build: {
- watch: []
- },
- router: {},
- dir: {
- app: 'app'
- }
- },
- ready: jest.fn(),
- hook: jest.fn(),
- callHook: jest.fn(),
- resolver: {
- requireModule: jest.fn(() => ({ template: 'builder-template' })),
- resolveAlias: jest.fn(src => `resolveAlias(${src})`),
- resolvePath: jest.fn(src => `resolvePath(${src})`)
- }
-})
diff --git a/packages/builder/test/builder.build.test.js b/packages/builder/test/builder.build.test.js
deleted file mode 100644
index b5caf80ba442..000000000000
--- a/packages/builder/test/builder.build.test.js
+++ /dev/null
@@ -1,282 +0,0 @@
-import path from 'path'
-import consola from 'consola'
-import fsExtra from 'fs-extra'
-import semver from 'semver'
-import { r, waitFor } from '@nuxt/utils'
-import { BundleBuilder } from '@nuxt/webpack'
-
-import Builder from '../src/builder'
-import { createNuxt } from './__utils__'
-
-jest.mock('fs-extra')
-jest.mock('semver/functions/satisfies')
-jest.mock('hash-sum', () => src => `hash(${src})`)
-jest.mock('@nuxt/utils')
-jest.mock('../src/ignore')
-jest.mock('@nuxt/webpack')
-
-describe('builder: builder build', () => {
- beforeAll(() => {
- jest.spyOn(path, 'join').mockImplementation((...args) => `join(${args.join(', ')})`)
- })
-
- afterAll(() => {
- path.join.mockRestore()
- })
-
- beforeEach(() => {
- jest.clearAllMocks()
- })
-
- test('should build all resources', async () => {
- const nuxt = createNuxt()
- nuxt.options.srcDir = '/var/nuxt/src'
- nuxt.options.buildDir = '/var/nuxt/build'
- nuxt.options.dir = { pages: '/var/nuxt/src/pages' }
- nuxt.options.build.template = { dir: '/var/nuxt/src/template' }
- nuxt.options.build.createRoutes = jest.fn()
-
- const bundleBuilder = { build: jest.fn() }
- const builder = new Builder(nuxt, bundleBuilder)
- builder.validatePages = jest.fn()
- builder.validateTemplate = jest.fn()
- builder.generateRoutesAndFiles = jest.fn()
- builder.resolvePlugins = jest.fn()
-
- r.mockImplementation((dir, src) => `r(${dir})`)
-
- const buildReturn = await builder.build()
-
- expect(consola.info).toBeCalledTimes(1)
- expect(consola.info).toBeCalledWith('Production build')
- expect(nuxt.ready).toBeCalledTimes(1)
- expect(nuxt.callHook).toBeCalledTimes(3)
- expect(nuxt.callHook).nthCalledWith(1, 'build:before', builder, nuxt.options.build)
- expect(nuxt.callHook).nthCalledWith(2, 'builder:prepared', builder, nuxt.options.build)
- expect(builder.validatePages).toBeCalledTimes(1)
- expect(builder.validateTemplate).toBeCalledTimes(1)
- expect(consola.success).toBeCalledTimes(1)
- expect(consola.success).toBeCalledWith('Builder initialized')
- expect(consola.debug).toBeCalledTimes(1)
- expect(consola.debug).toBeCalledWith('App root: /var/nuxt/src')
- expect(fsExtra.remove).toBeCalledTimes(1)
- expect(fsExtra.remove).toBeCalledWith('r(/var/nuxt/build)')
- expect(fsExtra.mkdirp).toBeCalledTimes(3)
- expect(fsExtra.mkdirp).nthCalledWith(1, 'r(/var/nuxt/build)')
- expect(fsExtra.mkdirp).nthCalledWith(2, 'r(/var/nuxt/build)')
- expect(fsExtra.mkdirp).nthCalledWith(3, 'r(/var/nuxt/build)')
- expect(r).toBeCalledTimes(4)
- expect(r).nthCalledWith(1, '/var/nuxt/build')
- expect(r).nthCalledWith(2, '/var/nuxt/build', 'components')
- expect(r).nthCalledWith(3, '/var/nuxt/build', 'dist', 'client')
- expect(r).nthCalledWith(4, '/var/nuxt/build', 'dist', 'server')
- expect(builder.generateRoutesAndFiles).toBeCalledTimes(1)
- expect(nuxt.options.build.watch).toEqual(['/var/nuxt/src/template/**/*.{vue,js}'])
- expect(builder.resolvePlugins).toBeCalledTimes(1)
- expect(bundleBuilder.build).toBeCalledTimes(1)
- expect(builder._buildStatus).toEqual(2)
- expect(nuxt.callHook).nthCalledWith(3, 'build:done', builder)
- expect(buildReturn).toBe(builder)
- })
-
- test('should prevent duplicate build in dev mode', async () => {
- const nuxt = createNuxt()
- nuxt.options.dev = true
- const builder = new Builder(nuxt, BundleBuilder)
- builder._buildStatus = 3
-
- waitFor.mockImplementationOnce(() => {
- builder.build = jest.fn(() => 'calling build')
- })
-
- const buildReturn = await builder.build()
-
- expect(nuxt.ready).not.toBeCalled()
- expect(waitFor).toBeCalledTimes(1)
- expect(waitFor).toBeCalledWith(1000)
- expect(builder.build).toBeCalledTimes(1)
- expect(buildReturn).toBe('calling build')
- })
-
- test('should wait 1000ms and retry if building is in progress', async () => {
- const nuxt = createNuxt()
- nuxt.options.dev = true
- const builder = new Builder(nuxt, BundleBuilder)
- builder._buildStatus = 2
-
- const buildReturn = await builder.build()
-
- expect(nuxt.ready).not.toBeCalled()
- expect(buildReturn).toBe(builder)
- })
-
- test('should build in dev mode and print dev mode building messages', async () => {
- const nuxt = createNuxt()
- nuxt.options.dev = true
- nuxt.options.srcDir = '/var/nuxt/src'
- nuxt.options.buildDir = '/var/nuxt/build'
- nuxt.options.dir = { pages: '/var/nuxt/src/pages' }
- nuxt.options.build.createRoutes = jest.fn()
-
- const bundleBuilder = { build: jest.fn() }
- const builder = new Builder(nuxt, bundleBuilder)
- builder.validatePages = jest.fn()
- builder.validateTemplate = jest.fn()
- builder.generateRoutesAndFiles = jest.fn()
- builder.resolvePlugins = jest.fn()
-
- await builder.build()
-
- expect(consola.info).toBeCalledTimes(2)
- expect(consola.info).nthCalledWith(1, 'Preparing project for development')
- expect(consola.info).nthCalledWith(2, 'Initial build may take a while')
- expect(fsExtra.mkdirp).toBeCalledTimes(1)
- expect(fsExtra.mkdirp).toBeCalledWith('r(/var/nuxt/build)')
- expect(r).toBeCalledTimes(2)
- expect(r).nthCalledWith(1, '/var/nuxt/build')
- expect(r).nthCalledWith(2, '/var/nuxt/build', 'components')
- })
-
- test('should throw error when validateTemplate failed', async () => {
- const nuxt = createNuxt()
- const builder = new Builder(nuxt, BundleBuilder)
- builder.validatePages = jest.fn()
- builder.validateTemplate = jest.fn(() => {
- throw new Error('validate failed')
- })
- consola.success.mockImplementationOnce(() => {
- throw new Error('exit')
- })
-
- await expect(builder.build()).rejects.toThrow('exit')
-
- expect(builder._buildStatus).toEqual(3)
- expect(consola.fatal).toBeCalledTimes(1)
- expect(consola.fatal).toBeCalledWith(new Error('validate failed'))
- })
-
- test('should warn built-in page will be used if no pages dir found', async () => {
- const nuxt = createNuxt()
- nuxt.options.srcDir = '/var/nuxt/src'
- nuxt.options.dir = { pages: '/var/nuxt/src/pages' }
- const builder = new Builder(nuxt, BundleBuilder)
- fsExtra.exists.mockReturnValue(false)
-
- await builder.validatePages()
-
- expect(builder._nuxtPages).toEqual(true)
- expect(path.join).toBeCalledTimes(2)
- expect(path.join).nthCalledWith(1, '/var/nuxt/src', '/var/nuxt/src/pages')
- expect(path.join).nthCalledWith(2, '/var/nuxt/src', '..', '/var/nuxt/src/pages')
- expect(fsExtra.exists).toBeCalledTimes(2)
- expect(fsExtra.exists).nthCalledWith(1, 'join(/var/nuxt/src, /var/nuxt/src/pages)')
- expect(fsExtra.exists).nthCalledWith(2, 'join(/var/nuxt/src, .., /var/nuxt/src/pages)')
- expect(builder._defaultPage).toEqual(true)
- expect(consola.warn).toBeCalledTimes(1)
- expect(consola.warn).toBeCalledWith('No `/var/nuxt/src/pages` directory found in /var/nuxt/src. Using the default built-in page.')
- })
-
- test('should throw error if pages is found in parent dir', async () => {
- const nuxt = createNuxt()
- nuxt.options.srcDir = '/var/nuxt/src'
- nuxt.options.dir = { pages: '/var/nuxt/src/pages' }
- const builder = new Builder(nuxt, BundleBuilder)
- fsExtra.exists
- .mockReturnValueOnce(false)
- .mockReturnValueOnce(true)
-
- await expect(builder.validatePages()).rejects.toThrow(
- 'No `/var/nuxt/src/pages` directory found in /var/nuxt/src. Did you mean to run `nuxt` in the parent (`../`) directory?'
- )
-
- expect(builder._nuxtPages).toEqual(true)
- expect(path.join).toBeCalledTimes(2)
- expect(path.join).nthCalledWith(1, '/var/nuxt/src', '/var/nuxt/src/pages')
- expect(path.join).nthCalledWith(2, '/var/nuxt/src', '..', '/var/nuxt/src/pages')
- expect(fsExtra.exists).toBeCalledTimes(2)
- expect(fsExtra.exists).nthCalledWith(1, 'join(/var/nuxt/src, /var/nuxt/src/pages)')
- expect(fsExtra.exists).nthCalledWith(2, 'join(/var/nuxt/src, .., /var/nuxt/src/pages)')
- expect(builder._defaultPage).toBeUndefined()
- })
-
- test('should pass validation if createRoutes is function', async () => {
- const nuxt = createNuxt()
- nuxt.options.build.createRoutes = jest.fn()
- const builder = new Builder(nuxt, BundleBuilder)
-
- await builder.validatePages()
-
- expect(builder._nuxtPages).toEqual(false)
- expect(fsExtra.exists).not.toBeCalled()
- })
-
- test('should pass validation if pages exists', async () => {
- const nuxt = createNuxt()
- nuxt.options.srcDir = '/var/nuxt/src'
- nuxt.options.dir = { pages: '/var/nuxt/src/pages' }
- const builder = new Builder(nuxt, BundleBuilder)
- fsExtra.exists.mockReturnValueOnce(true)
-
- await builder.validatePages()
-
- expect(builder._nuxtPages).toEqual(true)
- expect(path.join).toBeCalledTimes(1)
- expect(path.join).toBeCalledWith('/var/nuxt/src', '/var/nuxt/src/pages')
- expect(fsExtra.exists).toBeCalledTimes(1)
- expect(fsExtra.exists).toBeCalledWith('join(/var/nuxt/src, /var/nuxt/src/pages)')
- expect(builder._defaultPage).toBeUndefined()
- })
-
- test('should validate dependencies in template', () => {
- const nuxt = createNuxt()
- nuxt.options.build.template = {
- dependencies: {
- vue: 'latest',
- nuxt: 'edge'
- }
- }
- const builder = new Builder(nuxt, BundleBuilder)
- semver.satisfies
- .mockReturnValueOnce(true)
- .mockReturnValueOnce(true)
- nuxt.resolver.requireModule
- .mockReturnValueOnce({ version: 'alpha' })
- .mockReturnValueOnce({ version: 'beta' })
-
- builder.validateTemplate()
-
- expect(nuxt.resolver.requireModule).toBeCalledTimes(2)
- expect(nuxt.resolver.requireModule).nthCalledWith(1, 'join(vue, package.json)')
- expect(nuxt.resolver.requireModule).nthCalledWith(2, 'join(nuxt, package.json)')
- expect(semver.satisfies).toBeCalledTimes(2)
- expect(semver.satisfies).nthCalledWith(1, 'alpha', 'latest')
- expect(semver.satisfies).nthCalledWith(2, 'beta', 'edge')
- })
-
- test('should warn and throw error if dependencies is not installed', () => {
- const nuxt = createNuxt()
- nuxt.options.build.template = {
- dependencies: {
- vue: 'latest',
- nuxt: 'edge'
- }
- }
- const builder = new Builder(nuxt, BundleBuilder)
- semver.satisfies
- .mockReturnValueOnce(false)
- nuxt.resolver.requireModule
- .mockReturnValueOnce({ version: 'alpha' })
- .mockReturnValueOnce(undefined)
-
- builder.validateTemplate()
-
- expect(nuxt.resolver.requireModule).toBeCalledTimes(2)
- expect(nuxt.resolver.requireModule).nthCalledWith(1, 'join(vue, package.json)')
- expect(nuxt.resolver.requireModule).nthCalledWith(2, 'join(nuxt, package.json)')
- expect(consola.warn).toBeCalledTimes(2)
- expect(consola.warn).nthCalledWith(1, 'vue@latest is recommended but vue@alpha is installed!')
- expect(consola.warn).nthCalledWith(2, 'nuxt@edge is required but not installed!')
- expect(semver.satisfies).toBeCalledTimes(1)
- expect(semver.satisfies).nthCalledWith(1, 'alpha', 'latest')
- })
-})
diff --git a/packages/builder/test/builder.common.test.js b/packages/builder/test/builder.common.test.js
deleted file mode 100644
index 2f582890835a..000000000000
--- a/packages/builder/test/builder.common.test.js
+++ /dev/null
@@ -1,59 +0,0 @@
-import { BundleBuilder } from '@nuxt/webpack'
-
-import Builder from '../src/builder'
-import BuildContext from '../src/context/build'
-import { createNuxt } from './__utils__'
-
-jest.mock('@nuxt/webpack', () => ({
- BundleBuilder: jest.fn(function () {
- this.name = 'webpack_builder'
- })
-}))
-jest.mock('../src/context/build', () => jest.fn(function () {
- this.name = 'build_context'
-}))
-jest.mock('../src/ignore')
-
-describe('builder: builder common', () => {
- beforeEach(() => {
- jest.clearAllMocks()
- })
-
- test('should get webpack builder by default', () => {
- const builder = new Builder(createNuxt(), {})
-
- const bundleBuilder = builder.getBundleBuilder()
-
- expect(BuildContext).toBeCalledTimes(1)
- expect(BuildContext).toBeCalledWith(builder)
- expect(BundleBuilder).toBeCalledTimes(1)
- expect(BundleBuilder).toBeCalledWith({ name: 'build_context' })
- expect(bundleBuilder).toEqual({ name: 'webpack_builder' })
- })
-
- test('should get custom builder from given constructor', () => {
- const builder = new Builder(createNuxt(), {})
-
- const CustomBundleBuilder = jest.fn(function () {
- this.name = 'custom_builder'
- })
- const bundleBuilder = builder.getBundleBuilder(CustomBundleBuilder)
-
- expect(BuildContext).toBeCalledTimes(1)
- expect(BuildContext).toBeCalledWith(builder)
- expect(CustomBundleBuilder).toBeCalledTimes(1)
- expect(CustomBundleBuilder).toBeCalledWith({ name: 'build_context' })
- expect(bundleBuilder).toEqual({ name: 'custom_builder' })
- })
-
- test('should call bundleBuilder forGenerate', () => {
- const bundleBuilder = {
- forGenerate: jest.fn()
- }
- const builder = new Builder(createNuxt(), bundleBuilder)
-
- builder.forGenerate()
-
- expect(bundleBuilder.forGenerate).toBeCalledTimes(1)
- })
-})
diff --git a/packages/builder/test/builder.ctor.test.js b/packages/builder/test/builder.ctor.test.js
deleted file mode 100644
index 8980d0e255a0..000000000000
--- a/packages/builder/test/builder.ctor.test.js
+++ /dev/null
@@ -1,117 +0,0 @@
-import consola from 'consola'
-import { relativeTo, determineGlobals } from '@nuxt/utils'
-
-import Builder from '../src/builder'
-import { createNuxt } from './__utils__'
-
-jest.mock('@nuxt/utils')
-jest.mock('../src/ignore')
-
-describe('builder: builder constructor', () => {
- beforeEach(() => {
- jest.clearAllMocks()
- })
-
- test('should construct builder', () => {
- const nuxt = createNuxt()
-
- const bundleBuilder = {}
- determineGlobals.mockReturnValueOnce('__global')
-
- const builder = new Builder(nuxt, bundleBuilder)
-
- expect(builder.nuxt).toEqual(nuxt)
- expect(builder.plugins).toEqual([])
- expect(builder.options).toEqual(nuxt.options)
-
- expect(determineGlobals).toBeCalledTimes(1)
- expect(determineGlobals).toBeCalledWith(nuxt.options.globalName, nuxt.options.globals)
-
- expect(builder.watchers).toEqual({
- files: null,
- custom: null,
- restart: null
- })
- expect(builder.supportedExtensions).toEqual(['vue', 'js'])
- expect(builder.relativeToBuild).toBeInstanceOf(Function)
-
- expect(builder._buildStatus).toEqual(1)
-
- expect(nuxt.resolver.requireModule).toBeCalledTimes(1)
- expect(nuxt.resolver.requireModule).toBeCalledWith('@nuxt/vue-app')
- expect(builder.template).toEqual('builder-template')
-
- expect(builder.bundleBuilder).toBe(bundleBuilder)
- })
-
- test('should call relativeTo in relativeToBuild', () => {
- const nuxt = createNuxt()
- nuxt.options.buildDir = '/var/nuxt/build'
- const bundleBuilder = {}
- const builder = new Builder(nuxt, bundleBuilder)
-
- const args = [{}, {}]
- builder.relativeToBuild(...args)
-
- expect(relativeTo).toBeCalledTimes(1)
- expect(relativeTo).toBeCalledWith('/var/nuxt/build', ...args)
- })
-
- test('should add hooks in dev mode', () => {
- const nuxt = createNuxt()
- nuxt.options.dev = true
-
- const bundleBuilder = {}
- determineGlobals.mockReturnValueOnce('__global')
-
- const builder = new Builder(nuxt, bundleBuilder)
-
- expect(builder.options.dev).toEqual(true)
-
- expect(nuxt.hook).toBeCalledTimes(2)
- expect(nuxt.hook).toBeCalledWith('build:done', expect.any(Function))
- expect(nuxt.hook).toBeCalledWith('close', expect.any(Function))
-
- const doneHook = nuxt.hook.mock.calls[0][1]
- builder.watchClient = jest.fn()
- builder.watchRestart = jest.fn()
- doneHook()
- expect(consola.info).toBeCalledTimes(1)
- expect(consola.info).toBeCalledWith('Waiting for file changes')
- expect(builder.watchClient).toBeCalledTimes(1)
- expect(builder.watchRestart).toBeCalledTimes(1)
-
- const closeHook = nuxt.hook.mock.calls[1][1]
- builder.close = jest.fn()
- closeHook()
- expect(builder.close).toBeCalledTimes(1)
- })
-
- test('should add hooks in analyze mode', () => {
- const nuxt = createNuxt()
- nuxt.options.build.analyze = true
-
- const bundleBuilder = {}
- const builder = new Builder(nuxt, bundleBuilder)
-
- expect(builder.options.build.analyze).toEqual(true)
-
- expect(nuxt.hook).toBeCalledTimes(1)
- expect(nuxt.hook).toBeCalledWith('build:done', expect.any(Function))
-
- const doneHook = nuxt.hook.mock.calls[0][1]
- doneHook()
- expect(consola.warn).toBeCalledTimes(1)
- expect(consola.warn).toBeCalledWith('Notice: Please do not deploy bundles built with "analyze" mode, they\'re for analysis purposes only.')
- })
-
- test('should support function template', () => {
- const nuxt = createNuxt()
- nuxt.options.build.template = jest.fn()
- const bundleBuilder = {}
- const builder = new Builder(nuxt, bundleBuilder)
-
- expect(builder.template).toBe(nuxt.options.build.template)
- expect(nuxt.resolver.requireModule).not.toBeCalled()
- })
-})
diff --git a/packages/builder/test/builder.generate.test.js b/packages/builder/test/builder.generate.test.js
deleted file mode 100644
index 88c42342c44f..000000000000
--- a/packages/builder/test/builder.generate.test.js
+++ /dev/null
@@ -1,707 +0,0 @@
-import path from 'path'
-import Glob from 'glob'
-import fs from 'fs-extra'
-import consola from 'consola'
-import template from 'lodash/template'
-import { r, createRoutes, stripWhitespace } from '@nuxt/utils'
-import { BundleBuilder } from '@nuxt/webpack'
-import Builder from '../src/builder'
-import TemplateContext from '../src/context/template'
-import { createNuxt } from './__utils__'
-
-jest.mock('glob')
-jest.mock('pify', () => fn => fn)
-jest.mock('fs-extra')
-jest.mock('lodash/template')
-jest.mock('@nuxt/utils')
-jest.mock('../src/context/template', () => jest.fn())
-jest.mock('../src/ignore', () => function () {
- this.filter = jest.fn(files => files)
-})
-jest.mock('@nuxt/webpack')
-
-describe('builder: builder generate', () => {
- beforeAll(() => {
- r.mockImplementation((...args) => `r(${args.join(', ')})`)
- fs.readFile.mockImplementation((...args) => `readFile(${args.join(', ')})`)
- fs.outputFile.mockImplementation((...args) => `outputFile(${args.join(', ')})`)
- const { join, resolve } = path.posix
- jest.spyOn(path, 'join').mockImplementation((...args) => join(...args))
- jest.spyOn(path, 'resolve').mockImplementation((...args) => resolve(...args))
- })
-
- afterAll(() => {
- path.join.mockRestore()
- path.resolve.mockRestore()
- })
-
- beforeEach(() => {
- jest.clearAllMocks()
- })
-
- test('should generate routes and files', async () => {
- const nuxt = createNuxt()
- nuxt.options.build = {
- template: {
- dir: '/var/nuxt/src/template',
- files: ['App.js', 'index.js']
- },
- watch: []
- }
-
- const builder = new Builder(nuxt, BundleBuilder)
- builder.normalizePlugins = jest.fn(() => [{ name: 'test_plugin', src: '/var/somesrc' }])
- builder.resolveLayouts = jest.fn(() => 'resolveLayouts')
- builder.resolveRoutes = jest.fn(() => 'resolveRoutes')
- builder.resolveStore = jest.fn(() => 'resolveStore')
- builder.resolveMiddleware = jest.fn(() => 'resolveMiddleware')
- builder.addOptionalTemplates = jest.fn()
- builder.resolveCustomTemplates = jest.fn()
- builder.resolveLoadingIndicator = jest.fn()
- builder.compileTemplates = jest.fn()
- jest.spyOn(Promise, 'all').mockImplementation(() => {})
-
- await builder.generateRoutesAndFiles()
-
- expect(consola.debug).toBeCalledTimes(1)
- expect(consola.debug).toBeCalledWith('Generating nuxt files')
- expect(TemplateContext).toBeCalledTimes(1)
- expect(TemplateContext).toBeCalledWith(builder, builder.options)
- expect(builder.normalizePlugins).toBeCalledTimes(1)
- expect(builder.resolveLayouts).toBeCalledTimes(1)
- expect(builder.resolveRoutes).toBeCalledTimes(1)
- expect(builder.resolveStore).toBeCalledTimes(1)
- expect(builder.resolveMiddleware).toBeCalledTimes(1)
- expect(Promise.all).toBeCalledTimes(1)
- expect(Promise.all).toBeCalledWith([
- 'resolveLayouts',
- 'resolveRoutes',
- 'resolveStore',
- 'resolveMiddleware'
- ])
- expect(builder.addOptionalTemplates).toBeCalledTimes(1)
- expect(builder.resolveCustomTemplates).toBeCalledTimes(1)
- expect(builder.resolveLoadingIndicator).toBeCalledTimes(1)
- expect(builder.options.build.watch).toEqual([])
- expect(builder.compileTemplates).toBeCalledTimes(1)
- expect(consola.success).toBeCalledTimes(1)
- expect(consola.success).toBeCalledWith('Nuxt files generated')
-
- Promise.all.mockRestore()
- })
-
- test('should resolve files', async () => {
- const nuxt = createNuxt()
- nuxt.options.srcDir = '/var/nuxt/src'
- nuxt.options.ignore = '/var/nuxt/ignore'
- const builder = new Builder(nuxt, BundleBuilder)
- Glob.mockReturnValue('matched files')
-
- const files = await builder.resolveFiles('/var/nuxt/dir')
-
- expect(Glob).toBeCalledTimes(1)
- expect(Glob).toBeCalledWith(
- '/var/nuxt/dir/**/*.{vue,js}',
- { cwd: '/var/nuxt/src' }
- )
- expect(builder.ignore.filter).toBeCalledTimes(1)
- expect(builder.ignore.filter).toBeCalledWith('matched files')
- expect(files).toEqual('matched files')
- })
-
- test('should resolve relative files', async () => {
- const nuxt = createNuxt()
- const builder = new Builder(nuxt, BundleBuilder)
- builder.resolveFiles = jest.fn(dir => [`${dir}/foo.vue`, `${dir}/bar.vue`, `${dir}/baz.vue`])
-
- const files = await builder.resolveRelative('/var/nuxt/dir')
-
- expect(builder.resolveFiles).toBeCalledTimes(1)
- expect(builder.resolveFiles).toBeCalledWith('/var/nuxt/dir')
- expect(files).toEqual([
- { src: 'foo.vue' },
- { src: 'bar.vue' },
- { src: 'baz.vue' }
- ])
- })
-
- test('should resolve store modules', async () => {
- const nuxt = createNuxt()
- nuxt.options.features = { store: true }
- nuxt.options.store = true
- nuxt.options.dir = {
- store: '/var/nuxt/src/store'
- }
- const builder = new Builder(nuxt, BundleBuilder)
- builder.resolveRelative = jest.fn(dir => [
- { src: `${dir}/index.js` },
- { src: `${dir}/bar.js` },
- { src: `${dir}/baz.js` },
- { src: `${dir}/foo/bar.js` },
- { src: `${dir}/foo/baz.js` },
- { src: `${dir}/foo/index.js` }
- ])
-
- const templateVars = {}
- const templateFiles = []
- await builder.resolveStore({ templateVars, templateFiles })
-
- expect(templateVars.storeModules).toEqual([
- { src: '/var/nuxt/src/store/index.js' },
- { src: '/var/nuxt/src/store/bar.js' },
- { src: '/var/nuxt/src/store/baz.js' },
- { src: '/var/nuxt/src/store/foo/index.js' },
- { src: '/var/nuxt/src/store/foo/bar.js' },
- { src: '/var/nuxt/src/store/foo/baz.js' }]
- )
- expect(templateFiles).toEqual(['store.js'])
- })
-
- test('should disable store resolving when not set', async () => {
- const nuxt = createNuxt()
- nuxt.options.features = { store: false }
- nuxt.options.dir = {
- store: '/var/nuxt/src/store'
- }
- const builder = new Builder(nuxt, BundleBuilder)
-
- const templateVars = {}
- const templateFiles = []
- await builder.resolveStore({ templateVars, templateFiles })
-
- expect(templateVars.storeModules).toBeUndefined()
- expect(templateFiles).toEqual([])
- })
-
- test('should disable store resolving when feature disabled', async () => {
- const nuxt = createNuxt()
- nuxt.options.features = { store: false }
- nuxt.options.store = true
- nuxt.options.dir = {
- store: '/var/nuxt/src/store'
- }
- const builder = new Builder(nuxt, BundleBuilder)
-
- const templateVars = {}
- const templateFiles = []
- await builder.resolveStore({ templateVars, templateFiles })
-
- expect(templateVars.storeModules).toBeUndefined()
- expect(templateFiles).toEqual([])
- })
-
- test('should resolve middleware', async () => {
- const nuxt = createNuxt()
- nuxt.options.features = { middleware: true }
- nuxt.options.store = false
- nuxt.options.srcDir = '/var/nuxt/src'
- nuxt.options.dir = {
- middleware: 'middleware'
- }
- const middlewarePath = 'subfolder/midd.js'
- const builder = new Builder(nuxt, BundleBuilder)
- builder.resolveRelative = jest.fn(dir => [
- { src: middlewarePath }
- ])
- builder.relativeToBuild = jest.fn().mockReturnValue(middlewarePath)
-
- const templateVars = {}
- const templateFiles = []
- await builder.resolveMiddleware({ templateVars, templateFiles })
-
- expect(templateVars.middleware).toEqual([
- {
- name: 'subfolder/midd',
- src: 'subfolder/midd.js',
- dst: 'subfolder/midd.js'
- }
- ])
- expect(templateFiles).toEqual(['middleware.js'])
- })
-
- test('should disable middleware when feature disabled', async () => {
- const nuxt = createNuxt()
- nuxt.options.features = { middleware: false }
- nuxt.options.store = false
- nuxt.options.dir = {
- middleware: '/var/nuxt/src/middleware'
- }
- const builder = new Builder(nuxt, BundleBuilder)
- const templateVars = {}
- const templateFiles = []
- await builder.resolveMiddleware({ templateVars, templateFiles })
- expect(templateFiles).toEqual([])
- })
-
- test('should custom templates', async () => {
- const nuxt = createNuxt()
- nuxt.options.srcDir = '/var/nuxt/src'
- nuxt.options.build = {
- watch: [],
- template: { dir: '/var/nuxt/templates' },
- templates: [
- '/var/nuxt/templates/foo.js',
- { src: '/var/nuxt/templates/bar.js' },
- { src: '/var/nuxt/templates/baz.js', dst: 'baz.js' }
- ]
- }
- const builder = new Builder(nuxt, BundleBuilder)
- fs.exists.mockReturnValueOnce(true)
-
- const templateContext = {
- templateFiles: [
- 'foo.js',
- 'bar.js',
- 'baz.js',
- 'router.js',
- 'store.js',
- 'middleware.js'
- ]
- }
- await builder.resolveCustomTemplates(templateContext)
-
- expect(templateContext.templateFiles).toEqual([
- { custom: true, dst: 'foo.js', src: '/var/nuxt/src/app/foo.js', options: {} },
- { custom: true, dst: 'bar.js', src: '/var/nuxt/templates/bar.js', options: {} },
- { custom: true, dst: 'baz.js', src: '/var/nuxt/templates/baz.js', options: {} },
- { custom: false, dst: 'router.js', src: 'r(/var/nuxt/templates, router.js)', options: {} },
- { custom: false, dst: 'store.js', src: 'r(/var/nuxt/templates, store.js)', options: {} },
- { custom: false, dst: 'middleware.js', src: 'r(/var/nuxt/templates, middleware.js)', options: {} }
- ])
- })
-
- test('should resolve loading indicator', async () => {
- const nuxt = createNuxt()
- nuxt.options.loadingIndicator = {
- name: 'test_loading_indicator'
- }
- nuxt.options.build = {
- watch: [],
- template: { dir: '/var/nuxt/templates' }
- }
- const builder = new Builder(nuxt, BundleBuilder)
- fs.exists.mockReturnValueOnce(true)
-
- const templateFiles = []
- await builder.resolveLoadingIndicator({ templateFiles })
-
- expect(path.resolve).toBeCalledTimes(1)
- expect(path.resolve).toBeCalledWith('/var/nuxt/templates', 'views/loading', 'test_loading_indicator.html')
- expect(fs.exists).toBeCalledTimes(1)
- expect(fs.exists).toBeCalledWith('/var/nuxt/templates/views/loading/test_loading_indicator.html')
- expect(templateFiles).toEqual([{
- custom: false,
- dst: 'loading.html',
- options: { name: 'test_loading_indicator' },
- src: '/var/nuxt/templates/views/loading/test_loading_indicator.html'
- }])
- })
-
- test('should resolve alias loading indicator', async () => {
- const nuxt = createNuxt()
- nuxt.options.loadingIndicator = {
- name: '@/app/template.vue'
- }
- nuxt.options.build = {
- watch: [],
- template: { dir: '/var/nuxt/templates' }
- }
- const builder = new Builder(nuxt, BundleBuilder)
- fs.exists
- .mockReturnValueOnce(false)
- .mockReturnValueOnce(true)
-
- const templateFiles = []
- await builder.resolveLoadingIndicator({ templateFiles })
-
- expect(path.resolve).toBeCalledTimes(1)
- expect(path.resolve).toBeCalledWith('/var/nuxt/templates', 'views/loading', '@/app/template.vue.html')
- expect(fs.exists).toBeCalledTimes(2)
- expect(fs.exists).nthCalledWith(1, '/var/nuxt/templates/views/loading/@/app/template.vue.html')
- expect(fs.exists).nthCalledWith(2, 'resolveAlias(@/app/template.vue)')
- expect(templateFiles).toEqual([{
- custom: true,
- dst: 'loading.html',
- options: { name: '@/app/template.vue' },
- src: 'resolveAlias(@/app/template.vue)'
- }])
- })
-
- test('should display error if three is not loading indicator', async () => {
- const nuxt = createNuxt()
- nuxt.options.loadingIndicator = {
- name: '@/app/empty.vue'
- }
- nuxt.options.build = {
- watch: [],
- template: { dir: '/var/nuxt/templates' }
- }
- const builder = new Builder(nuxt, BundleBuilder)
- fs.exists
- .mockReturnValueOnce(false)
- .mockReturnValueOnce(false)
-
- const templateFiles = []
- await builder.resolveLoadingIndicator({ templateFiles })
-
- expect(path.resolve).toBeCalledTimes(1)
- expect(path.resolve).toBeCalledWith('/var/nuxt/templates', 'views/loading', '@/app/empty.vue.html')
- expect(fs.exists).toBeCalledTimes(2)
- expect(fs.exists).nthCalledWith(1, '/var/nuxt/templates/views/loading/@/app/empty.vue.html')
- expect(fs.exists).nthCalledWith(2, 'resolveAlias(@/app/empty.vue)')
- expect(consola.error).toBeCalledTimes(1)
- expect(consola.error).toBeCalledWith('Could not fetch loading indicator: @/app/empty.vue')
- expect(templateFiles).toEqual([])
- })
-
- test('should disable loading indicator', async () => {
- const nuxt = createNuxt()
- nuxt.options.loadingIndicator = {
- name: false
- }
- const builder = new Builder(nuxt, BundleBuilder)
-
- await builder.resolveLoadingIndicator({ templateFiles: [] })
-
- expect(path.resolve).not.toBeCalled()
- })
-
- test('should compile templates', async () => {
- const nuxt = createNuxt()
- nuxt.options.build.watch = []
- nuxt.options.buildDir = '/var/nuxt/build'
- const builder = new Builder(nuxt, BundleBuilder)
- builder.relativeToBuild = jest.fn()
- const templateFn = jest.fn(() => 'compiled content')
- template.mockImplementation(() => templateFn)
- stripWhitespace.mockImplementation(content => `trim(${content})`)
-
- const templateContext = {
- templateVars: { test: 'template_vars' },
- templateFiles: [
- { src: '/var/nuxt/src/foo.js', dst: 'foo.js', options: { foo: true } },
- { src: '/var/nuxt/src/bar.js', dst: 'bar.js', options: { bar: true } },
- { src: '/var/nuxt/src/baz.js', dst: 'baz.js', custom: true }
- ],
- templateOptions: {}
- }
- await builder.compileTemplates(templateContext)
-
- expect(nuxt.callHook).toBeCalledTimes(1)
- expect(nuxt.callHook).toBeCalledWith('build:templates', {
- templateVars: templateContext.templateVars,
- templatesFiles: templateContext.templateFiles,
- resolve: r
- })
- expect(templateContext.templateOptions.imports).toEqual({
- resolvePath: nuxt.resolver.resolvePath,
- resolveAlias: nuxt.resolver.resolveAlias,
- relativeToBuild: builder.relativeToBuild
- })
- expect(nuxt.options.build.watch).toEqual(['/var/nuxt/src/baz.js'])
- expect(fs.readFile).toBeCalledTimes(3)
- expect(fs.readFile).nthCalledWith(1, '/var/nuxt/src/foo.js', 'utf8')
- expect(fs.readFile).nthCalledWith(2, '/var/nuxt/src/bar.js', 'utf8')
- expect(fs.readFile).nthCalledWith(3, '/var/nuxt/src/baz.js', 'utf8')
- expect(template).toBeCalledTimes(3)
- expect(template).nthCalledWith(1, 'readFile(/var/nuxt/src/foo.js, utf8)', templateContext.templateOptions)
- expect(template).nthCalledWith(2, 'readFile(/var/nuxt/src/bar.js, utf8)', templateContext.templateOptions)
- expect(template).nthCalledWith(3, 'readFile(/var/nuxt/src/baz.js, utf8)', templateContext.templateOptions)
- expect(templateFn).toBeCalledTimes(3)
- expect(templateFn).nthCalledWith(1, {
- ...templateContext.templateVars,
- custom: undefined,
- dst: 'foo.js',
- src: '/var/nuxt/src/foo.js',
- options: { foo: true }
- })
- expect(templateFn).nthCalledWith(2, {
- ...templateContext.templateVars,
- custom: undefined,
- dst: 'bar.js',
- src: '/var/nuxt/src/bar.js',
- options: { bar: true }
- })
- expect(templateFn).nthCalledWith(3, {
- ...templateContext.templateVars,
- custom: true,
- dst: 'baz.js',
- src: '/var/nuxt/src/baz.js'
- })
- expect(stripWhitespace).toBeCalledTimes(3)
- expect(stripWhitespace).nthCalledWith(1, 'compiled content')
- expect(stripWhitespace).nthCalledWith(2, 'compiled content')
- expect(stripWhitespace).nthCalledWith(3, 'compiled content')
- expect(fs.outputFile).toBeCalledTimes(3)
- expect(fs.outputFile).nthCalledWith(1, 'r(/var/nuxt/build, foo.js)', 'trim(compiled content)', 'utf8')
- expect(fs.outputFile).nthCalledWith(2, 'r(/var/nuxt/build, bar.js)', 'trim(compiled content)', 'utf8')
- expect(fs.outputFile).nthCalledWith(3, 'r(/var/nuxt/build, baz.js)', 'trim(compiled content)', 'utf8')
- })
-
- test('should throw error if compile failed', async () => {
- const nuxt = createNuxt()
- const builder = new Builder(nuxt, BundleBuilder)
- builder.relativeToBuild = jest.fn()
- template.mockImplementation(() => {
- throw new Error('compile failed')
- })
-
- const templateContext = {
- templateVars: { test: 'template_vars' },
- templateFiles: [{ src: '/var/nuxt/src/foo.js' }],
- templateOptions: {}
- }
- await expect(builder.compileTemplates(templateContext)).rejects.toThrow(
- 'Could not compile template /var/nuxt/src/foo.js: compile failed'
- )
- })
-
- describe('builder: builder resolveLayouts', () => {
- test('should resolve layouts', async () => {
- const nuxt = createNuxt()
- nuxt.options.features = { layouts: true }
- nuxt.options.srcDir = '/var/nuxt/src'
- nuxt.options.buildDir = '/var/nuxt/build'
- nuxt.options.dir = {
- layouts: '/var/nuxt/src/layouts'
- }
- nuxt.options.layouts = {
- foo: '/var/nuxt/layouts/foo/index.vue'
- }
- const builder = new Builder(nuxt, BundleBuilder)
- builder.resolveFiles = jest.fn(layouts => [
- `${layouts}/foo.vue`,
- `${layouts}/bar.js`,
- `${layouts}/baz.vue`,
- `${layouts}/error.vue`
- ])
- builder.relativeToBuild = jest.fn((...args) => `relativeBuild(${args.join(', ')})`)
- fs.exists.mockReturnValueOnce(true)
-
- const templateVars = {
- components: {},
- layouts: {
- bar: '/var/nuxt/layouts/bar/index.vue'
- }
- }
- const templateFiles = []
- await builder.resolveLayouts({ templateVars, templateFiles })
-
- expect(path.resolve).toBeCalledTimes(1)
- expect(path.resolve).toBeCalledWith('/var/nuxt/src', '/var/nuxt/src/layouts')
- expect(fs.exists).toBeCalledTimes(1)
- expect(fs.exists).toBeCalledWith('/var/nuxt/src/layouts')
- expect(builder.resolveFiles).toBeCalledTimes(1)
- expect(builder.resolveFiles).toBeCalledWith('/var/nuxt/src/layouts')
- expect(builder.relativeToBuild).toBeCalledTimes(2)
- expect(builder.relativeToBuild).nthCalledWith(1, '/var/nuxt/src', '/var/nuxt/src/layouts/baz.vue')
- expect(builder.relativeToBuild).nthCalledWith(2, '/var/nuxt/src', '/var/nuxt/src/layouts/error.vue')
- expect(templateVars.components.ErrorPage).toEqual('relativeBuild(/var/nuxt/src, /var/nuxt/src/layouts/error.vue)')
- expect(consola.warn).toBeCalledTimes(1)
- expect(consola.warn).toBeCalledWith('Duplicate layout registration, "foo" has been registered as "/var/nuxt/layouts/foo/index.vue"')
- expect(templateVars.layouts).toEqual({
- bar: '/var/nuxt/layouts/bar/index.vue',
- baz: 'relativeBuild(/var/nuxt/src, /var/nuxt/src/layouts/baz.vue)',
- default: './layouts/default.vue'
- })
- expect(fs.mkdirp).toBeCalledTimes(1)
- expect(fs.mkdirp).toBeCalledWith('r(/var/nuxt/build, layouts)')
- expect(templateFiles).toEqual(['layouts/default.vue'])
- expect(templateVars.layouts.default).toEqual('./layouts/default.vue')
- })
-
- test('should resolve error layouts', async () => {
- const nuxt = createNuxt()
- nuxt.options.features = { layouts: true }
- nuxt.options.srcDir = '/var/nuxt/src'
- nuxt.options.dir = {
- layouts: '/var/nuxt/src/layouts'
- }
- const builder = new Builder(nuxt, BundleBuilder)
- builder.resolveFiles = jest.fn(layouts => [
- `${layouts}/error.vue`
- ])
- builder.relativeToBuild = jest.fn((...args) => `relativeBuild(${args.join(', ')})`)
- fs.exists.mockReturnValueOnce(true)
-
- const templateVars = {
- components: {
- ErrorPage: '/var/nuxt/components/error.vue'
- },
- layouts: {
- default: '/var/nuxt/layouts/default.vue'
- }
- }
- await builder.resolveLayouts({ templateVars })
-
- expect(builder.relativeToBuild).not.toBeCalled()
- expect(templateVars.components.ErrorPage).toEqual('/var/nuxt/components/error.vue')
- })
-
- test('should not resolve layouts if layouts dir does not exist', async () => {
- const nuxt = createNuxt()
- nuxt.options.features = { layouts: true }
- nuxt.options.srcDir = '/var/nuxt/src'
- nuxt.options.dir = {
- layouts: '/var/nuxt/src/layouts'
- }
- const builder = new Builder(nuxt, BundleBuilder)
- builder.resolveFiles = jest.fn()
- fs.exists.mockReturnValueOnce(false)
-
- const templateVars = {
- layouts: {
- default: '/var/nuxt/layouts/default.vue'
- }
- }
- await builder.resolveLayouts({ templateVars })
-
- expect(path.resolve).toBeCalledTimes(1)
- expect(path.resolve).toBeCalledWith('/var/nuxt/src', '/var/nuxt/src/layouts')
- expect(fs.exists).toBeCalledTimes(1)
- expect(fs.exists).toBeCalledWith('/var/nuxt/src/layouts')
- expect(builder.resolveFiles).not.toBeCalled()
- expect(fs.mkdirp).not.toBeCalled()
- })
- })
-
- describe('builder: builder resolveRoutes', () => {
- test('should resolve routes via build.createRoutes', async () => {
- const nuxt = createNuxt()
- nuxt.options.srcDir = '/var/nuxt/src'
- nuxt.options.build.createRoutes = jest.fn(() => [{ name: 'default_route' }])
- nuxt.options.router.extendRoutes = jest.fn(routes => [...routes, { name: 'extend_route' }])
- const builder = new Builder(nuxt, BundleBuilder)
-
- const templateVars = {
- router: {
- routes: []
- }
- }
- await builder.resolveRoutes({ templateVars })
-
- expect(consola.debug).toBeCalledTimes(1)
- expect(consola.debug).toBeCalledWith('Generating routes...')
- expect(nuxt.options.build.createRoutes).toBeCalledTimes(1)
- expect(nuxt.options.build.createRoutes).toBeCalledWith('/var/nuxt/src')
- expect(nuxt.callHook).toBeCalledTimes(1)
- expect(nuxt.callHook).toBeCalledWith(
- 'build:extendRoutes',
- [{ name: 'default_route' }],
- r
- )
- expect(nuxt.options.router.extendRoutes).toBeCalledTimes(1)
- expect(nuxt.options.router.extendRoutes).toBeCalledWith([{ name: 'default_route' }], r)
- expect(templateVars.router.routes).toEqual([
- { name: 'default_route' },
- { name: 'extend_route' }
- ])
- expect(builder.routes).toEqual(templateVars.router.routes)
- })
-
- test('should resolve routes from default pages dir', async () => {
- const nuxt = createNuxt()
- nuxt.options.srcDir = '/var/nuxt/src'
- nuxt.options.build = {
- watch: [],
- createRoutes: jest.fn(),
- template: { dir: '/var/nuxt/templates' }
- }
- nuxt.options.router.routeNameSplitter = '[splitter]'
- createRoutes.mockReturnValueOnce([{ name: 'default_route' }])
- const builder = new Builder(nuxt, BundleBuilder)
- builder._defaultPage = true
-
- const templateVars = {
- router: {
- routes: []
- }
- }
- await builder.resolveRoutes({ templateVars })
-
- expect(consola.debug).toBeCalledTimes(1)
- expect(consola.debug).toBeCalledWith('Generating routes...')
- expect(nuxt.options.build.createRoutes).not.toBeCalled()
- expect(createRoutes).toBeCalledTimes(1)
- expect(createRoutes).toBeCalledWith({
- files: ['index.vue'],
- srcDir: '/var/nuxt/templates/pages',
- routeNameSplitter: '[splitter]'
- })
- expect(nuxt.callHook).toBeCalledTimes(1)
- expect(nuxt.callHook).toBeCalledWith(
- 'build:extendRoutes',
- [{ name: 'default_route' }],
- r
- )
- expect(templateVars.router.routes).toEqual([
- { name: 'default_route' }
- ])
- expect(builder.routes).toEqual(templateVars.router.routes)
- })
-
- test('should resolve routes from dir.pages', async () => {
- const nuxt = createNuxt()
- nuxt.options.srcDir = '/var/nuxt/src'
- nuxt.options.dir = {
- pages: '/var/nuxt/pages'
- }
- nuxt.options.build = {
- watch: [],
- createRoutes: jest.fn()
- }
- nuxt.options.router = {
- routeNameSplitter: '[splitter]',
- extendRoutes: jest.fn()
- }
- createRoutes.mockImplementationOnce(({ files }) => files.map(file => ({ path: file })))
- const builder = new Builder(nuxt, BundleBuilder)
- builder._nuxtPages = true
- builder.resolveFiles = jest.fn(dir => [
- `${dir}/foo.js`,
- `${dir}/bar.vue`,
- `${dir}/baz.vue`,
- `${dir}/foo.vue`,
- `${dir}/bar.js`
- ])
-
- const templateVars = {
- router: {
- routes: []
- }
- }
- await builder.resolveRoutes({ templateVars })
-
- expect(consola.debug).toBeCalledTimes(1)
- expect(consola.debug).toBeCalledWith('Generating routes...')
- expect(nuxt.options.build.createRoutes).not.toBeCalled()
- expect(builder.resolveFiles).toBeCalledTimes(1)
- expect(builder.resolveFiles).toBeCalledWith('/var/nuxt/pages')
-
- expect(createRoutes).toBeCalledTimes(1)
- expect(createRoutes).toBeCalledWith({
- files: ['/var/nuxt/pages/foo.vue', '/var/nuxt/pages/bar.vue', '/var/nuxt/pages/baz.vue'],
- srcDir: '/var/nuxt/src',
- pagesDir: '/var/nuxt/pages',
- routeNameSplitter: '[splitter]',
- supportedExtensions: ['vue', 'js']
- })
- expect(nuxt.callHook).toBeCalledTimes(1)
- expect(nuxt.callHook).toBeCalledWith(
- 'build:extendRoutes',
- [
- { path: '/var/nuxt/pages/foo.vue' },
- { path: '/var/nuxt/pages/bar.vue' },
- { path: '/var/nuxt/pages/baz.vue' }
- ],
- r
- )
- expect(templateVars.router.routes).toEqual([
- { path: '/var/nuxt/pages/foo.vue' },
- { path: '/var/nuxt/pages/bar.vue' },
- { path: '/var/nuxt/pages/baz.vue' }
- ])
- expect(builder.routes).toEqual(templateVars.router.routes)
- })
- })
-})
diff --git a/packages/builder/test/builder.plugin.test.js b/packages/builder/test/builder.plugin.test.js
deleted file mode 100644
index 24234f6c72fa..000000000000
--- a/packages/builder/test/builder.plugin.test.js
+++ /dev/null
@@ -1,189 +0,0 @@
-import Glob from 'glob'
-import consola from 'consola'
-import { isIndexFileAndFolder } from '@nuxt/utils'
-import { BundleBuilder } from '@nuxt/webpack'
-
-import Builder from '../src/builder'
-import { createNuxt } from './__utils__'
-
-jest.mock('glob')
-jest.mock('pify', () => fn => fn)
-jest.mock('hash-sum', () => src => `hash(${src})`)
-jest.mock('@nuxt/utils')
-jest.mock('../src/ignore')
-jest.mock('@nuxt/webpack')
-
-describe('builder: builder plugins', () => {
- beforeEach(() => {
- jest.clearAllMocks()
- })
-
- test('should normalize plugins', async () => {
- const nuxt = createNuxt()
- nuxt.options.plugins = [
- '/var/nuxt/plugins/test.js',
- '/var/nuxt/.nuxt/foo-bar.plugin.client.530b6c6a.js',
- { src: '/var/nuxt/plugins/test.server', mode: 'server' },
- { src: '/var/nuxt/plugins/test.client', ssr: false }
- ]
-
- const builder = new Builder(nuxt, BundleBuilder)
- const plugins = await builder.normalizePlugins()
-
- expect(nuxt.callHook).toBeCalledTimes(1)
- expect(nuxt.callHook).toBeCalledWith('builder:extendPlugins', nuxt.options.plugins)
-
- expect(plugins).toEqual([
- {
- mode: 'all',
- name: 'nuxt_plugin_test_hash(/var/nuxt/plugins/test.js)',
- src: 'resolveAlias(/var/nuxt/plugins/test.js)'
- },
- {
- mode: 'client',
- name: 'nuxt_plugin_foobarpluginclient530b6c6a_hash(/var/nuxt/.nuxt/foo-bar.plugin.client.530b6c6a.js)',
- src: 'resolveAlias(/var/nuxt/.nuxt/foo-bar.plugin.client.530b6c6a.js)'
- },
- {
- mode: 'server',
- name: 'nuxt_plugin_test_hash(/var/nuxt/plugins/test.server)',
- src: 'resolveAlias(/var/nuxt/plugins/test.server)'
- },
- {
- mode: 'client',
- name: 'nuxt_plugin_test_hash(/var/nuxt/plugins/test.client)',
- src: 'resolveAlias(/var/nuxt/plugins/test.client)'
- }
- ])
- })
-
- test('should overwrite plugins from options', async () => {
- const nuxt = createNuxt()
-
- nuxt.options.plugins = ['/var/nuxt/plugins/foo-bar.js']
- nuxt.options.extendPlugins = jest.fn().mockReturnValue([
- '/var/nuxt/plugins/fizz-fuzz.js'
- ])
-
- const builder = new Builder(nuxt, BundleBuilder)
- const plugins = await builder.normalizePlugins()
-
- expect(nuxt.options.extendPlugins).toHaveBeenCalledTimes(1)
- expect(nuxt.options.extendPlugins).toHaveBeenCalledWith([
- '/var/nuxt/plugins/foo-bar.js'
- ])
-
- expect(plugins).toEqual([
- {
- mode: 'all',
- name: 'nuxt_plugin_fizzfuzz_hash(/var/nuxt/plugins/fizz-fuzz.js)',
- src: 'resolveAlias(/var/nuxt/plugins/fizz-fuzz.js)'
- }
- ])
- })
-
- test('should warning and fallback invalid mode when normalize plugins', async () => {
- const nuxt = createNuxt()
- nuxt.options.plugins = [
- { src: '/var/nuxt/plugins/test', mode: 'abc' }
- ]
- const builder = new Builder(nuxt, BundleBuilder)
-
- const plugins = await builder.normalizePlugins()
-
- expect(plugins).toEqual([
- {
- mode: 'all',
- name: 'nuxt_plugin_test_hash(/var/nuxt/plugins/test)',
- src: 'resolveAlias(/var/nuxt/plugins/test)'
- }
- ])
- expect(consola.warn).toBeCalledTimes(1)
- expect(consola.warn).toBeCalledWith('Invalid plugin mode (server/client/all): \'abc\'. Falling back to \'all\'')
- })
-
- test('should resolve plugins', async () => {
- const nuxt = createNuxt()
- const builder = new Builder(nuxt, BundleBuilder)
- builder.plugins = [
- { src: '/var/nuxt/plugins/test.js', mode: 'all' },
- { src: '/var/nuxt/plugins/test.client', mode: 'client' },
- { src: '/var/nuxt/plugins/test.server', mode: 'server' }
- ]
- builder.relativeToBuild = jest.fn(src => `relative(${src})`)
- for (let step = 0; step < builder.plugins.length; step++) {
- Glob.mockImplementationOnce(src => [`${src.replace(/\{.*\}/, '')}.js`])
- }
-
- await builder.resolvePlugins()
-
- expect(Glob).toBeCalledTimes(3)
- expect(Glob).nthCalledWith(1, '/var/nuxt/plugins/test.js{?(.+([^.])),/index.+([^.])}')
- expect(Glob).nthCalledWith(2, '/var/nuxt/plugins/test.client{?(.+([^.])),/index.+([^.])}')
- expect(Glob).nthCalledWith(3, '/var/nuxt/plugins/test.server{?(.+([^.])),/index.+([^.])}')
- expect(builder.plugins).toEqual([
- { mode: 'all', src: 'relative(/var/nuxt/plugins/test.js)' },
- { mode: 'client', src: 'relative(/var/nuxt/plugins/test.client)' },
- { mode: 'server', src: 'relative(/var/nuxt/plugins/test.server)' }
- ])
- })
-
- test('should throw error if plugin no existed', async () => {
- const nuxt = createNuxt()
- const builder = new Builder(nuxt, BundleBuilder)
- builder.plugins = [
- { src: '/var/nuxt/plugins/test.js', mode: 'all' }
- ]
- Glob.mockImplementationOnce(() => [])
-
- await expect(builder.resolvePlugins()).rejects.toThrow('Plugin not found: /var/nuxt/plugins/test.js')
- })
-
- test('should warn if there are multiple files and not index', async () => {
- const nuxt = createNuxt()
- const builder = new Builder(nuxt, BundleBuilder)
- builder.plugins = [
- { src: '/var/nuxt/plugins/test', mode: 'all' }
- ]
- builder.relativeToBuild = jest.fn(src => `relative(${src})`)
-
- Glob.mockImplementationOnce(src => [`${src}.js`])
- isIndexFileAndFolder.mockReturnValueOnce(false)
-
- await builder.resolvePlugins()
-
- expect(builder.plugins).toEqual([
- { mode: 'all', src: 'relative(/var/nuxt/plugins/test)' }
- ])
- })
-
- test('should detect plugin mode for client/server plugins', async () => {
- const nuxt = createNuxt()
- const builder = new Builder(nuxt, BundleBuilder)
- builder.options.plugins = [
- { src: '/var/nuxt/plugins/test.js', mode: 'all' },
- { src: '/var/nuxt/plugins/test.client' },
- { src: '/var/nuxt/plugins/test.server' }
- ]
-
- const plugins = await builder.normalizePlugins()
-
- expect(plugins).toEqual([
- {
- mode: 'all',
- src: 'resolveAlias(/var/nuxt/plugins/test.js)',
- name: 'nuxt_plugin_test_hash(/var/nuxt/plugins/test.js)'
- },
- {
- mode: 'client',
- src: 'resolveAlias(/var/nuxt/plugins/test.client)',
- name: 'nuxt_plugin_test_hash(/var/nuxt/plugins/test.client)'
- },
- {
- mode: 'server',
- src: 'resolveAlias(/var/nuxt/plugins/test.server)',
- name: 'nuxt_plugin_test_hash(/var/nuxt/plugins/test.server)'
- }
- ])
- })
-})
diff --git a/packages/builder/test/builder.watch.test.js b/packages/builder/test/builder.watch.test.js
deleted file mode 100644
index 46d0245a4cc7..000000000000
--- a/packages/builder/test/builder.watch.test.js
+++ /dev/null
@@ -1,434 +0,0 @@
-import path from 'path'
-import chokidar from 'chokidar'
-import upath from 'upath'
-import debounce from 'lodash/debounce'
-import { r, isString, isPureObject } from '@nuxt/utils'
-
-import { BundleBuilder } from '@nuxt/webpack'
-import Builder from '../src/builder'
-import { createNuxt } from './__utils__'
-jest.mock('@nuxt/webpack')
-
-jest.mock('chokidar', () => ({
- watch: jest.fn().mockReturnThis(),
- on: jest.fn().mockReturnThis(),
- close: jest.fn().mockReturnThis()
-}))
-jest.mock('upath', () => ({ normalizeSafe: jest.fn(src => src) }))
-jest.mock('lodash/debounce', () => jest.fn(fn => fn))
-jest.mock('@nuxt/utils')
-jest.mock('../src/ignore')
-jest.mock('@nuxt/webpack')
-
-describe('builder: builder watch', () => {
- beforeEach(() => {
- jest.clearAllMocks()
- })
-
- test('should watch client files', () => {
- const nuxt = createNuxt()
- nuxt.options.srcDir = '/var/nuxt/src'
- nuxt.options.dir = {
- layouts: '/var/nuxt/src/layouts',
- pages: '/var/nuxt/src/pages',
- store: '/var/nuxt/src/store',
- middleware: '/var/nuxt/src/middleware'
- }
- nuxt.options.build.watch = []
-
- const builder = new Builder(nuxt, BundleBuilder)
- builder.createFileWatcher = jest.fn()
- builder.assignWatcher = jest.fn(() => () => {})
- r.mockImplementation((dir, src) => src)
-
- builder.watchClient()
-
- const patterns = [
- '/var/nuxt/src/layouts',
- '/var/nuxt/src/middleware'
- ]
-
- const globbedPatterns = [
- '/var/nuxt/src/layouts/**/*.{vue,js}',
- '/var/nuxt/src/middleware/**/*.{vue,js}'
- ]
-
- expect(r).toBeCalledTimes(2)
- expect(r).nthCalledWith(1, '/var/nuxt/src', patterns[0])
- expect(r).nthCalledWith(2, '/var/nuxt/src', patterns[1])
-
- expect(upath.normalizeSafe).toBeCalledTimes(2)
- expect(upath.normalizeSafe).nthCalledWith(1, globbedPatterns[0], 0, patterns)
- expect(upath.normalizeSafe).nthCalledWith(2, globbedPatterns[1], 1, patterns)
-
- expect(builder.createFileWatcher).toBeCalledTimes(1)
- expect(builder.createFileWatcher).toBeCalledWith(globbedPatterns, ['add', 'unlink'], expect.any(Function), expect.any(Function))
- expect(builder.assignWatcher).toBeCalledTimes(1)
- })
-
- test('should watch store files', () => {
- const nuxt = createNuxt()
- nuxt.options.store = true
- nuxt.options.srcDir = '/var/nuxt/src'
- nuxt.options.dir = {
- layouts: '/var/nuxt/src/layouts',
- pages: '/var/nuxt/src/pages',
- store: '/var/nuxt/src/store',
- middleware: '/var/nuxt/src/middleware'
- }
- nuxt.options.build.watch = []
-
- const builder = new Builder(nuxt, BundleBuilder)
- builder.createFileWatcher = jest.fn()
- builder.assignWatcher = jest.fn(() => () => {})
- r.mockImplementation((dir, src) => src)
-
- builder.watchClient()
-
- expect(r).toBeCalledTimes(3)
- expect(r).nthCalledWith(3, '/var/nuxt/src', '/var/nuxt/src/store')
- })
-
- test('should NOT watch pages files on client if _defaultPage=true', () => {
- const nuxt = createNuxt()
- nuxt.options.srcDir = '/var/nuxt/src'
- nuxt.options.dir = {
- layouts: '/var/nuxt/src/layouts',
- pages: '/var/nuxt/src/pages',
- store: '/var/nuxt/src/store',
- middleware: '/var/nuxt/src/middleware'
- }
- nuxt.options.build.watch = []
- nuxt.options.watchers = {
- chokidar: { test: true }
- }
-
- const builder = new Builder(nuxt, BundleBuilder)
- builder._nuxtPages = true
- builder._defaultPage = true
- r.mockImplementation((dir, src) => src)
-
- builder.watchClient()
-
- expect(r).toBeCalledTimes(2)
- })
- test('should watch pages files', () => {
- const nuxt = createNuxt()
- nuxt.options.srcDir = '/var/nuxt/src'
- nuxt.options.dir = {
- layouts: '/var/nuxt/src/layouts',
- pages: '/var/nuxt/src/pages',
- store: '/var/nuxt/src/store',
- middleware: '/var/nuxt/src/middleware'
- }
- nuxt.options.build.watch = []
- nuxt.options.watchers = {
- chokidar: { test: true }
- }
-
- const builder = new Builder(nuxt, BundleBuilder)
- builder._nuxtPages = true
- r.mockImplementation((dir, src) => src)
-
- builder.watchClient()
-
- expect(r).toBeCalledTimes(3)
- expect(r).nthCalledWith(3, '/var/nuxt/src', '/var/nuxt/src/pages')
-
- expect(upath.normalizeSafe).toBeCalledTimes(3)
- expect(upath.normalizeSafe).nthCalledWith(3, '/var/nuxt/src/pages/**/*.{vue,js}', 2, expect.any(Array))
- })
-
- test('should invoke generateRoutesAndFiles on file refresh', () => {
- const nuxt = createNuxt()
- nuxt.options.srcDir = '/var/nuxt/src'
- nuxt.options.dir = {
- layouts: '/var/nuxt/src/layouts',
- pages: '/var/nuxt/src/pages',
- store: '/var/nuxt/src/store',
- middleware: '/var/nuxt/src/middleware'
- }
- nuxt.options.build.watch = []
- nuxt.options.watchers = {
- chokidar: { test: true }
- }
- const builder = new Builder(nuxt, BundleBuilder)
- builder.watchCustom = jest.fn()
- r.mockImplementation((dir, src) => src)
-
- builder.watchClient()
-
- expect(debounce).toBeCalledTimes(1)
- expect(debounce).toBeCalledWith(expect.any(Function), 200)
-
- const refreshFiles = chokidar.on.mock.calls[0][1]
- builder.generateRoutesAndFiles = jest.fn()
- refreshFiles()
- expect(builder.generateRoutesAndFiles).toBeCalled()
- })
-
- test('should watch custom patterns', () => {
- const nuxt = createNuxt()
- nuxt.options.srcDir = '/var/nuxt/src'
- nuxt.options.dir = {
- layouts: '/var/nuxt/src/layouts',
- pages: '/var/nuxt/src/pages',
- store: '/var/nuxt/src/store',
- middleware: '/var/nuxt/src/middleware'
- }
- nuxt.options.build.watch = [
- '/var/nuxt/src/custom'
- ]
- nuxt.options.build.styleResources = [
- '/var/nuxt/src/style'
- ]
- const builder = new Builder(nuxt, BundleBuilder)
- builder.createFileWatcher = jest.fn()
- builder.assignWatcher = jest.fn(() => () => {})
- builder.watchClient()
-
- const patterns = [
- '/var/nuxt/src/custom',
- '/var/nuxt/src/style'
- ]
-
- expect(builder.createFileWatcher).toBeCalledTimes(3)
- expect(builder.createFileWatcher).toBeCalledWith(patterns, ['change'], expect.any(Function), expect.any(Function))
- expect(builder.assignWatcher).toBeCalledTimes(3)
- })
-
- test('should invoke chokidar to create watcher', () => {
- const nuxt = createNuxt()
- nuxt.options.srcDir = '/var/nuxt/src'
- nuxt.options.dir = {
- layouts: '/var/nuxt/src/layouts',
- pages: '/var/nuxt/src/pages',
- store: '/var/nuxt/src/store',
- middleware: '/var/nuxt/src/middleware'
- }
- nuxt.options.watchers = {
- chokidar: { test: true }
- }
-
- const patterns = ['/patterns']
- const events = ['event', 'another event']
- const listener = jest.fn()
- const watcherCreatedCallback = jest.fn()
-
- const builder = new Builder(nuxt, BundleBuilder)
- builder.createFileWatcher(patterns, events, listener, watcherCreatedCallback)
-
- expect(chokidar.watch).toBeCalledTimes(1)
- expect(chokidar.watch).toBeCalledWith(patterns, { test: true })
- expect(chokidar.on).toBeCalledTimes(2)
- expect(chokidar.on).nthCalledWith(1, 'event', listener)
- expect(chokidar.on).nthCalledWith(2, 'another event', listener)
- expect(watcherCreatedCallback).toBeCalledTimes(1)
- })
-
- test('should restart watcher when event is included in rewatchOnRawEvents', () => {
- const nuxt = createNuxt()
- nuxt.options.srcDir = '/var/nuxt/src'
- nuxt.options.dir = {
- layouts: '/var/nuxt/src/layouts',
- pages: '/var/nuxt/src/pages',
- store: '/var/nuxt/src/store',
- middleware: '/var/nuxt/src/middleware'
- }
- nuxt.options.watchers = {
- chokidar: { test: true },
- rewatchOnRawEvents: ['rename']
- }
-
- const patterns = ['/pattern']
- const events = ['event']
- const listener = jest.fn()
- const watcherCreatedCallback = jest.fn()
-
- const builder = new Builder(nuxt, BundleBuilder)
- builder.createFileWatcher(patterns, events, listener, watcherCreatedCallback)
-
- expect(chokidar.on).toBeCalledTimes(2)
- expect(chokidar.on).nthCalledWith(2, 'raw', expect.any(Function))
-
- const rewatchHandler = chokidar.on.mock.calls[1][1]
- rewatchHandler('rename')
- rewatchHandler('change')
-
- expect(chokidar.close).toBeCalledTimes(1)
- expect(builder.watchers.custom).toBeNull()
- expect(watcherCreatedCallback).toBeCalledTimes(2)
- })
-
- test('should watch files for restarting server', () => {
- const nuxt = createNuxt()
- nuxt.options.srcDir = '/var/nuxt/src'
- nuxt.options.dir = {
- layouts: '/var/nuxt/src/layouts',
- pages: '/var/nuxt/src/pages',
- store: '/var/nuxt/src/store',
- middleware: '/var/nuxt/src/middleware'
- }
- nuxt.options.watchers = {
- chokidar: { test: true }
- }
- nuxt.options.watch = [
- '/var/nuxt/src/watch/test'
- ]
- nuxt.options.serverMiddleware = [
- '/var/nuxt/src/serverMiddleware/test',
- { path: '/test', handler: '/var/nuxt/src/serverMiddleware/test-handler' },
- { obj: 'test' }
- ]
- const builder = new Builder(nuxt, BundleBuilder)
- builder.ignore.ignoreFile = '/var/nuxt/src/.nuxtignore'
- isString.mockImplementation(src => typeof src === 'string')
- isPureObject.mockImplementation(obj => typeof obj === 'object')
-
- builder.watchRestart()
-
- expect(chokidar.watch).toBeCalledTimes(1)
- expect(chokidar.watch).toBeCalledWith(
- [
- 'resolveAlias(/var/nuxt/src/watch/test)',
- '/var/nuxt/src/.nuxtignore',
- path.join('/var/nuxt/src/var/nuxt/src/store') // because store == false + using path.join()
- ],
- { test: true }
- )
- expect(chokidar.on).toBeCalledTimes(1)
- expect(chokidar.on).toBeCalledWith('all', expect.any(Function))
- })
-
- test('should trigger restarting when files changed', async () => {
- const nuxt = createNuxt()
- nuxt.options.srcDir = '/var/nuxt/src'
- nuxt.options.dir = {
- layouts: '/var/nuxt/src/layouts',
- pages: '/var/nuxt/src/pages',
- store: '/var/nuxt/src/store',
- middleware: '/var/nuxt/src/middleware'
- }
- nuxt.options.watchers = {
- chokidar: { test: true }
- }
- nuxt.options.watch = [
- '/var/nuxt/src/watch/test'
- ]
- nuxt.options.serverMiddleware = []
- const builder = new Builder(nuxt, BundleBuilder)
-
- builder.watchRestart()
-
- const restartHandler = chokidar.on.mock.calls[0][1]
- const watchingFile = '/var/nuxt/src/watch/test/index.js'
- await restartHandler('add', watchingFile)
- await restartHandler('change', watchingFile)
- await restartHandler('unlink', watchingFile)
-
- expect(nuxt.callHook).toBeCalledTimes(6)
- expect(nuxt.callHook).nthCalledWith(1, 'watch:fileChanged', builder, watchingFile)
- expect(nuxt.callHook).nthCalledWith(2, 'watch:restart', { event: 'add', path: watchingFile })
- expect(nuxt.callHook).nthCalledWith(3, 'watch:fileChanged', builder, watchingFile)
- expect(nuxt.callHook).nthCalledWith(4, 'watch:restart', { event: 'change', path: watchingFile })
- expect(nuxt.callHook).nthCalledWith(5, 'watch:fileChanged', builder, watchingFile)
- expect(nuxt.callHook).nthCalledWith(6, 'watch:restart', { event: 'unlink', path: watchingFile })
- })
-
- test('should ignore other events in watchRestart', () => {
- const nuxt = createNuxt()
- nuxt.options.srcDir = '/var/nuxt/src'
- nuxt.options.dir = {
- layouts: '/var/nuxt/src/layouts',
- pages: '/var/nuxt/src/pages',
- store: '/var/nuxt/src/store',
- middleware: '/var/nuxt/src/middleware'
- }
- nuxt.options.watchers = {
- chokidar: { test: true }
- }
- nuxt.options.watch = [
- '/var/nuxt/src/watch/test'
- ]
- nuxt.options.serverMiddleware = []
- const builder = new Builder(nuxt, BundleBuilder)
-
- builder.watchRestart()
-
- const restartHandler = chokidar.on.mock.calls[0][1]
- const watchingFile = '/var/nuxt/src/watch/test/index.js'
- restartHandler('rename', watchingFile)
-
- expect(nuxt.callHook).not.toBeCalled()
- })
-
- test('should unwatch every watcher', () => {
- const nuxt = createNuxt()
- const builder = new Builder(nuxt, BundleBuilder)
- builder.watchers = {
- files: { close: jest.fn() },
- custom: { close: jest.fn() },
- restart: { close: jest.fn() }
- }
-
- builder.unwatch()
-
- expect(builder.watchers.files.close).toBeCalledTimes(1)
- expect(builder.watchers.custom.close).toBeCalledTimes(1)
- expect(builder.watchers.restart.close).toBeCalledTimes(1)
- })
-
- test('should close watch and bundle builder', async () => {
- const nuxt = createNuxt()
- const builder = new Builder(nuxt, BundleBuilder)
- builder.unwatch = jest.fn()
-
- expect(builder.__closed).toBeUndefined()
-
- await builder.close()
-
- expect(builder.__closed).toEqual(true)
- expect(builder.unwatch).toBeCalledTimes(1)
- expect(builder.bundleBuilder.close).toBeCalledTimes(1)
- })
-
- test('should close bundleBuilder only if close api exists', async () => {
- const nuxt = createNuxt()
- const builder = new Builder(nuxt, { })
- builder.unwatch = jest.fn()
-
- expect(builder.__closed).toBeUndefined()
-
- await builder.close()
-
- expect(builder.__closed).toEqual(true)
- expect(builder.unwatch).toBeCalledTimes(1)
- })
-
- test('should prevent duplicate close', async () => {
- const nuxt = createNuxt()
- const bundleBuilderClose = jest.fn()
- const builder = new Builder(nuxt, { close: bundleBuilderClose })
- builder.unwatch = jest.fn()
- builder.__closed = true
-
- await builder.close()
-
- expect(builder.unwatch).not.toBeCalled()
- expect(bundleBuilderClose).not.toBeCalled()
- })
-
- test('should assign watcher with key', () => {
- const nuxt = createNuxt()
- const builder = new Builder(nuxt, BundleBuilder)
-
- const key = 'key'
- const watcher = 'watcher'
-
- const fn = builder.assignWatcher(key)
- fn(watcher)
-
- expect(Boolean(builder.watchers[key])).toBe(true)
- expect(builder.watchers[key]).toBe(watcher)
- })
-})
diff --git a/packages/builder/test/context/__snapshots__/template.test.js.snap b/packages/builder/test/context/__snapshots__/template.test.js.snap
deleted file mode 100644
index 873cea085399..000000000000
--- a/packages/builder/test/context/__snapshots__/template.test.js.snap
+++ /dev/null
@@ -1,116 +0,0 @@
-// Jest Snapshot v1, https://goo.gl/fbAQLP
-
-exports[`builder: buildContext should construct context 1`] = `
-TemplateContext {
- "templateFiles": Array [
- "template.js",
- ],
- "templateVars": Object {
- "appPath": "./App.js",
- "buildIndicator": undefined,
- "components": Object {
- "ErrorPage": "relativeBuild(test_error_page)",
- },
- "css": Array [
- "test.css",
- ],
- "debug": "test_debug",
- "dir": Array [
- "test_dir",
- ],
- "env": "test_env",
- "extensions": "test|ext",
- "features": Object {
- "store": true,
- },
- "fetch": undefined,
- "globalName": "test_global",
- "globals": Array [
- "globals",
- ],
- "head": "test_head",
- "isDev": "test_dev",
- "isTest": "test_test",
- "layoutTransition": Object {
- "name": "test_layout_trans",
- },
- "layouts": Object {
- "test-layout": "test.template",
- },
- "loading": "relativeBuild(test_src_dir, test-loading)",
- "messages": Object {
- "test": "test message",
- },
- "mode": "test mode",
- "nuxtOptions": Object {
- "ErrorPage": "test_error_page",
- "build": Object {
- "splitChunks": Object {
- "testSC": true,
- },
- },
- "css": Array [
- "test.css",
- ],
- "debug": "test_debug",
- "dev": "test_dev",
- "dir": Array [
- "test_dir",
- ],
- "env": "test_env",
- "extensions": Array [
- "test",
- "ext",
- ],
- "features": Object {
- "store": true,
- },
- "globalName": "test_global",
- "head": "test_head",
- "layoutTransition": Object {
- "name": "test_layout_trans",
- },
- "layouts": Object {
- "test-layout": "test.template",
- },
- "loading": "test-loading",
- "messages": Object {
- "test": "test message",
- },
- "mode": "test mode",
- "pageTransition": Object {
- "name": "test_trans",
- },
- "rootDir": "test_root_dir",
- "router": Object {
- "route": "test",
- },
- "srcDir": "test_src_dir",
- "store": "test_store",
- "test": "test_test",
- "vue": Object {
- "config": "test_config",
- },
- },
- "pageTransition": Object {
- "name": "test_trans",
- },
- "plugins": Array [
- "plugins",
- ],
- "rootDir": "test_root_dir",
- "router": Object {
- "route": "test",
- },
- "splitChunks": Object {
- "testSC": true,
- },
- "srcDir": "test_src_dir",
- "store": "test_store",
- "uniqBy": [Function],
- "vue": Object {
- "config": "test_config",
- },
- },
-}
-`;
diff --git a/packages/builder/test/context/build.test.js b/packages/builder/test/context/build.test.js
deleted file mode 100644
index a067add15628..000000000000
--- a/packages/builder/test/context/build.test.js
+++ /dev/null
@@ -1,33 +0,0 @@
-import BuildContext from '../../src/context/build'
-
-describe('builder: buildContext', () => {
- test('should construct context', () => {
- const builder = {
- nuxt: { options: {} }
- }
- const context = new BuildContext(builder)
- expect(context._builder).toEqual(builder)
- expect(context.nuxt).toEqual(builder.nuxt)
- expect(context.options).toEqual(builder.nuxt.options)
- expect(context.isStatic).toEqual(false)
- })
-
- test('should return builder plugins context', () => {
- const builder = {
- plugins: [],
- nuxt: { options: {} }
- }
- const context = new BuildContext(builder)
- expect(context.plugins).toEqual(builder.plugins)
- })
-
- test('should return builder build options', () => {
- const buildOptions = { id: 'test-build-options' }
- const builder = {
- plugins: [],
- nuxt: { options: { build: buildOptions } }
- }
- const context = new BuildContext(builder)
- expect(context.buildOptions).toEqual(buildOptions)
- })
-})
diff --git a/packages/builder/test/context/template.test.js b/packages/builder/test/context/template.test.js
deleted file mode 100644
index 53eb27704fe9..000000000000
--- a/packages/builder/test/context/template.test.js
+++ /dev/null
@@ -1,83 +0,0 @@
-import hash from 'hash-sum'
-import consola from 'consola'
-import serialize from 'serialize-javascript'
-
-import devalue from '@nuxt/devalue'
-import { r, wp, wChunk, serializeFunction } from '@nuxt/utils'
-import TemplateContext from '../../src/context/template'
-
-jest.mock('lodash', () => ({ test: 'test lodash', warn: 'only once' }))
-
-describe('builder: buildContext', () => {
- const builder = {
- template: { files: ['template.js'] },
- globals: ['globals'],
- plugins: ['plugins'],
- relativeToBuild: jest.fn((...args) => `relativeBuild(${args.join(', ')})`)
- }
- const options = {
- features: { store: true },
- extensions: ['test', 'ext'],
- messages: { test: 'test message' },
- build: {
- splitChunks: { testSC: true }
- },
- dev: 'test_dev',
- test: 'test_test',
- debug: 'test_debug',
- vue: { config: 'test_config' },
- mode: 'test mode',
- router: { route: 'test' },
- env: 'test_env',
- head: 'test_head',
- store: 'test_store',
- globalName: 'test_global',
- css: ['test.css'],
- layouts: {
- 'test-layout': 'test.template'
- },
- srcDir: 'test_src_dir',
- rootDir: 'test_root_dir',
- loading: 'test-loading',
- pageTransition: { name: 'test_trans' },
- layoutTransition: { name: 'test_layout_trans' },
- dir: ['test_dir'],
- ErrorPage: 'test_error_page'
- }
-
- test('should construct context', () => {
- const context = new TemplateContext(builder, options)
- expect(context).toMatchSnapshot()
- })
-
- test('should return object loading template options', () => {
- const context = new TemplateContext(builder, {
- ...options,
- loading: { name: 'test_loading' }
- })
-
- expect(context.templateVars.loading).toEqual({ name: 'test_loading' })
- })
-
- test('should return object loading template options', () => {
- const context = new TemplateContext(builder, options)
- const templateOptions = context.templateOptions
- expect(templateOptions).toEqual({
- imports: {
- serialize,
- serializeFunction,
- devalue,
- hash,
- r,
- wp,
- wChunk,
- _: {}
- },
- interpolate: /<%=([\s\S]+?)%>/g
- })
- expect(templateOptions.imports._.test).toEqual('test lodash')
- expect(templateOptions.imports._.warn).toEqual('only once')
- expect(consola.warn).toBeCalledTimes(1)
- expect(consola.warn).toBeCalledWith('Avoid using _ inside templates')
- })
-})
diff --git a/packages/builder/test/ignore.test.js b/packages/builder/test/ignore.test.js
deleted file mode 100644
index 76f732fa29e6..000000000000
--- a/packages/builder/test/ignore.test.js
+++ /dev/null
@@ -1,147 +0,0 @@
-import path from 'path'
-import fs from 'fs-extra'
-
-import Ignore from '../src/ignore'
-
-jest.mock('path')
-jest.mock('fs-extra')
-jest.mock('ignore', () => () => ({
- add: jest.fn(),
- filter: jest.fn(paths => paths)
-}))
-
-describe('builder: Ignore', () => {
- beforeAll(() => {
- path.resolve.mockImplementation((...args) => `resolve(${args.join(', ')})`)
- })
-
- beforeEach(() => {
- jest.clearAllMocks()
- })
-
- test('should construct Ignore', () => {
- jest.spyOn(Ignore.prototype, 'addIgnoresRules').mockImplementation(() => {})
-
- const ignore = new Ignore({
- rootDir: '/var/nuxt'
- })
-
- expect(Ignore.IGNORE_FILENAME).toEqual('.nuxtignore')
- expect(ignore.rootDir).toEqual('/var/nuxt')
- expect(ignore.addIgnoresRules).toBeCalledTimes(1)
-
- Ignore.prototype.addIgnoresRules.mockRestore()
- })
-
- test('should add ignore file', () => {
- jest.spyOn(Ignore.prototype, 'addIgnoresRules')
- jest.spyOn(Ignore.prototype, 'readIgnoreFile').mockReturnValue('')
-
- const ignore = new Ignore({
- rootDir: '/var/nuxt'
- })
-
- expect(Ignore.IGNORE_FILENAME).toEqual('.nuxtignore')
- expect(ignore.rootDir).toEqual('/var/nuxt')
- expect(ignore.addIgnoresRules).toBeCalledTimes(1)
- expect(ignore.readIgnoreFile).toBeCalledTimes(1)
-
- Ignore.prototype.addIgnoresRules.mockRestore()
- Ignore.prototype.readIgnoreFile.mockRestore()
- })
-
- test('should find ignore file', () => {
- fs.existsSync.mockReturnValueOnce(true)
- fs.statSync.mockReturnValueOnce({ isFile: () => true })
- fs.readFileSync.mockReturnValueOnce('pages/ignore.vue')
-
- const ignore = new Ignore({
- rootDir: '/var/nuxt'
- })
-
- expect(path.resolve).toBeCalledTimes(1)
- expect(path.resolve).toBeCalledWith('/var/nuxt', '.nuxtignore')
- expect(fs.existsSync).toBeCalledTimes(1)
- expect(fs.existsSync).toBeCalledWith('resolve(/var/nuxt, .nuxtignore)')
- expect(fs.statSync).toBeCalledTimes(1)
- expect(fs.statSync).toBeCalledWith('resolve(/var/nuxt, .nuxtignore)')
- expect(ignore.ignoreFile).toEqual('resolve(/var/nuxt, .nuxtignore)')
- expect(fs.readFileSync).toBeCalledTimes(1)
- expect(fs.readFileSync).toBeCalledWith('resolve(/var/nuxt, .nuxtignore)', 'utf8')
- expect(ignore.ignore.add).toBeCalledTimes(1)
- expect(ignore.ignore.add).toBeCalledWith('pages/ignore.vue')
-
- fs.existsSync.mockClear()
- ignore.findIgnoreFile()
- expect(fs.existsSync).not.toBeCalled()
- })
-
- test('should only find existed ignore file', () => {
- fs.existsSync.mockReturnValueOnce(false)
-
- const ignore = new Ignore({
- rootDir: '/var/nuxt'
- })
-
- expect(path.resolve).toBeCalledTimes(1)
- expect(path.resolve).toBeCalledWith('/var/nuxt', '.nuxtignore')
- expect(fs.existsSync).toBeCalledTimes(1)
- expect(fs.existsSync).toBeCalledWith('resolve(/var/nuxt, .nuxtignore)')
- expect(fs.statSync).not.toBeCalled()
- expect(ignore.ignoreFile).toBeUndefined()
- expect(ignore.ignore).toBeUndefined()
- })
-
- test('should filter ignore files', () => {
- fs.existsSync.mockReturnValueOnce(true)
- fs.statSync.mockReturnValueOnce({ isFile: () => true })
- fs.readFileSync.mockReturnValueOnce('pages/ignore.vue')
-
- const ignore = new Ignore({
- rootDir: '/var/nuxt'
- })
-
- ignore.filter()
- ignore.filter('pages/ignore.vue')
- const paths = ignore.filter(['pages/ignore.vue', 'layouts/ignore.vue'])
-
- expect(ignore.ignore.filter).toBeCalledTimes(3)
- expect(ignore.ignore.filter).nthCalledWith(1, [])
- expect(ignore.ignore.filter).nthCalledWith(2, ['pages/ignore.vue'])
- expect(ignore.ignore.filter).nthCalledWith(3, ['pages/ignore.vue', 'layouts/ignore.vue'])
- expect(paths).toEqual(['pages/ignore.vue', 'layouts/ignore.vue'])
- })
-
- test('should return origin paths if there is no ignorefile', () => {
- fs.existsSync.mockReturnValueOnce(false)
-
- const ignore = new Ignore({
- rootDir: '/var/nuxt'
- })
-
- const paths = ignore.filter(['pages/ignore.vue', 'layouts/ignore.vue'])
-
- expect(paths).toEqual(['pages/ignore.vue', 'layouts/ignore.vue'])
- })
-
- test('should reload ignore', () => {
- fs.existsSync.mockReturnValueOnce(true)
- fs.statSync.mockReturnValueOnce({ isFile: () => true })
- fs.readFileSync.mockReturnValueOnce('pages/ignore.vue')
-
- const ignore = new Ignore({
- rootDir: '/var/nuxt'
- })
-
- expect(ignore.ignore).toBeDefined()
- expect(ignore.ignoreFile).toEqual('resolve(/var/nuxt, .nuxtignore)')
-
- ignore.addIgnoresRules = jest.fn()
-
- ignore.reload()
-
- expect(ignore.ignore).toBeUndefined()
- expect(ignore.ignoreFile).toBeUndefined()
- expect(ignore.addIgnoresRules).toBeCalledTimes(1)
- })
-})
diff --git a/packages/builder/test/index.test.js b/packages/builder/test/index.test.js
deleted file mode 100644
index a8ada36f52ca..000000000000
--- a/packages/builder/test/index.test.js
+++ /dev/null
@@ -1,9 +0,0 @@
-import { Builder } from '../src'
-
-jest.mock('../src/builder', () => jest.fn(() => 'nuxt builder'))
-
-describe('builder: entry', () => {
- test('should export Builder', () => {
- expect(Builder()).toEqual('nuxt builder')
- })
-})
diff --git a/packages/cli/bin/nuxt-cli.js b/packages/cli/bin/nuxt-cli.js
deleted file mode 100755
index cc6f24825f23..000000000000
--- a/packages/cli/bin/nuxt-cli.js
+++ /dev/null
@@ -1,7 +0,0 @@
-#!/usr/bin/env node
-
-require('../dist/cli.js').run()
- .catch((error) => {
- require('consola').fatal(error)
- require('exit')(2)
- })
diff --git a/packages/cli/package.js b/packages/cli/package.js
deleted file mode 100644
index 19d0ef6e2d14..000000000000
--- a/packages/cli/package.js
+++ /dev/null
@@ -1,3 +0,0 @@
-export default {
- build: true
-}
diff --git a/packages/cli/package.json b/packages/cli/package.json
deleted file mode 100644
index 768a93237eca..000000000000
--- a/packages/cli/package.json
+++ /dev/null
@@ -1,34 +0,0 @@
-{
- "name": "@nuxt/cli",
- "version": "2.12.1",
- "repository": "nuxt/nuxt.js",
- "license": "MIT",
- "main": "dist/cli.js",
- "bin": {
- "nuxt-cli": "bin/nuxt-cli.js"
- },
- "files": [
- "bin",
- "dist"
- ],
- "dependencies": {
- "@nuxt/config": "2.12.1",
- "@nuxt/utils": "2.12.1",
- "boxen": "^4.2.0",
- "chalk": "^3.0.0",
- "consola": "^2.11.3",
- "esm": "^3.2.25",
- "execa": "^3.4.0",
- "exit": "^0.1.2",
- "fs-extra": "^8.1.0",
- "hable": "^3.0.0",
- "minimist": "^1.2.5",
- "opener": "1.5.1",
- "pretty-bytes": "^5.3.0",
- "std-env": "^2.2.1",
- "wrap-ansi": "^6.2.0"
- },
- "publishConfig": {
- "access": "public"
- }
-}
diff --git a/packages/cli/src/command.js b/packages/cli/src/command.js
deleted file mode 100644
index 0e4103d71d03..000000000000
--- a/packages/cli/src/command.js
+++ /dev/null
@@ -1,239 +0,0 @@
-
-import path from 'path'
-import consola from 'consola'
-import minimist from 'minimist'
-import Hookable from 'hable'
-import { name, version } from '../package.json'
-import { forceExit } from './utils'
-import { loadNuxtConfig } from './utils/config'
-import { indent, foldLines, colorize } from './utils/formatting'
-import { startSpaces, optionSpaces, forceExitTimeout } from './utils/constants'
-import * as imports from './imports'
-
-export default class NuxtCommand extends Hookable {
- constructor (cmd = { name: '', usage: '', description: '' }, argv = process.argv.slice(2), hooks = {}) {
- super(consola)
- this.addHooks(hooks)
-
- if (!cmd.options) {
- cmd.options = {}
- }
- this.cmd = cmd
-
- this._argv = Array.from(argv)
- this._parsedArgv = null // Lazy evaluate
- }
-
- static run (cmd, argv, hooks) {
- return NuxtCommand.from(cmd, argv, hooks).run()
- }
-
- static from (cmd, argv, hooks) {
- if (cmd instanceof NuxtCommand) {
- return cmd
- }
- return new NuxtCommand(cmd, argv, hooks)
- }
-
- async run () {
- await this.callHook('run:before', {
- argv: this._argv,
- cmd: this.cmd,
- rootDir: path.resolve(this.argv._[0] || '.')
- })
-
- if (this.argv.help) {
- this.showHelp()
- return
- }
-
- if (this.argv.version) {
- this.showVersion()
- return
- }
-
- if (typeof this.cmd.run !== 'function') {
- throw new TypeError('Invalid command! Commands should at least implement run() function.')
- }
-
- let cmdError
-
- try {
- await this.cmd.run(this)
- } catch (e) {
- cmdError = e
- }
-
- if (this.argv.lock) {
- await this.releaseLock()
- }
-
- if (this.argv['force-exit']) {
- const forceExitByUser = this.isUserSuppliedArg('force-exit')
- if (cmdError) {
- consola.fatal(cmdError)
- }
- forceExit(this.cmd.name, forceExitByUser ? false : forceExitTimeout)
- if (forceExitByUser) {
- return
- }
- }
-
- if (cmdError) {
- throw cmdError
- }
- }
-
- showVersion () {
- process.stdout.write(`${name} v${version}\n`)
- }
-
- showHelp () {
- process.stdout.write(this._getHelp())
- }
-
- get argv () {
- if (!this._parsedArgv) {
- const minimistOptions = this._getMinimistOptions()
- this._parsedArgv = minimist(this._argv, minimistOptions)
- }
- return this._parsedArgv
- }
-
- async getNuxtConfig (extraOptions = {}) {
- // Flag to indicate nuxt is running with CLI (not programmatic)
- extraOptions._cli = true
-
- const context = {
- command: this.cmd.name,
- dev: !!extraOptions.dev
- }
-
- const config = await loadNuxtConfig(this.argv, context)
- const options = Object.assign(config, extraOptions)
-
- for (const name of Object.keys(this.cmd.options)) {
- this.cmd.options[name].prepare && this.cmd.options[name].prepare(this, options, this.argv)
- }
-
- await this.callHook('config', options)
-
- return options
- }
-
- async getNuxt (options) {
- const { Nuxt } = await imports.core()
-
- const nuxt = new Nuxt(options)
- await nuxt.ready()
-
- return nuxt
- }
-
- async getBuilder (nuxt) {
- const { Builder } = await imports.builder()
- const { BundleBuilder } = await imports.webpack()
- return new Builder(nuxt, BundleBuilder)
- }
-
- async getGenerator (nuxt) {
- const { Generator } = await imports.generator()
- const builder = await this.getBuilder(nuxt)
- return new Generator(nuxt, builder)
- }
-
- async setLock (lockRelease) {
- if (lockRelease) {
- if (this._lockRelease) {
- consola.warn(`A previous unreleased lock was found, this shouldn't happen and is probably an error in 'nuxt ${this.cmd.name}' command. The lock will be removed but be aware of potential strange results`)
-
- await this.releaseLock()
- this._lockRelease = lockRelease
- } else {
- this._lockRelease = lockRelease
- }
- }
- }
-
- async releaseLock () {
- if (this._lockRelease) {
- await this._lockRelease()
- this._lockRelease = undefined
- }
- }
-
- isUserSuppliedArg (option) {
- return this._argv.includes(`--${option}`) || this._argv.includes(`--no-${option}`)
- }
-
- _getDefaultOptionValue (option) {
- return typeof option.default === 'function' ? option.default(this.cmd) : option.default
- }
-
- _getMinimistOptions () {
- const minimistOptions = {
- alias: {},
- boolean: [],
- string: [],
- default: {}
- }
-
- for (const name of Object.keys(this.cmd.options)) {
- const option = this.cmd.options[name]
-
- if (option.alias) {
- minimistOptions.alias[option.alias] = name
- }
- if (option.type) {
- minimistOptions[option.type].push(option.alias || name)
- }
- if (option.default) {
- minimistOptions.default[option.alias || name] = this._getDefaultOptionValue(option)
- }
- }
-
- return minimistOptions
- }
-
- _getHelp () {
- const options = []
- let maxOptionLength = 0
-
- for (const name in this.cmd.options) {
- const option = this.cmd.options[name]
-
- let optionHelp = '--'
- optionHelp += option.type === 'boolean' && this._getDefaultOptionValue(option) ? 'no-' : ''
- optionHelp += name
- if (option.alias) {
- optionHelp += `, -${option.alias}`
- }
-
- maxOptionLength = Math.max(maxOptionLength, optionHelp.length)
- options.push([optionHelp, option.description])
- }
-
- const _opts = options.map(([option, description]) => {
- const i = indent(maxOptionLength + optionSpaces - option.length)
- return foldLines(
- option + i + description,
- startSpaces + maxOptionLength + optionSpaces * 2,
- startSpaces + optionSpaces
- )
- }).join('\n')
-
- const usage = foldLines(`Usage: nuxt ${this.cmd.usage} [options]`, startSpaces)
- const description = foldLines(this.cmd.description, startSpaces)
- const opts = foldLines('Options:', startSpaces) + '\n\n' + _opts
-
- let helpText = colorize(`${usage}\n\n`)
- if (this.cmd.description) {
- helpText += colorize(`${description}\n\n`)
- }
- if (options.length) {
- helpText += colorize(`${opts}\n\n`)
- }
-
- return helpText
- }
-}
diff --git a/packages/cli/src/commands/build.js b/packages/cli/src/commands/build.js
deleted file mode 100644
index c0ecf210fef5..000000000000
--- a/packages/cli/src/commands/build.js
+++ /dev/null
@@ -1,86 +0,0 @@
-import { common, locking } from '../options'
-import { createLock } from '../utils'
-
-export default {
- name: 'build',
- description: 'Compiles the application for production deployment',
- usage: 'build <dir>',
- options: {
- ...common,
- ...locking,
- analyze: {
- alias: 'a',
- type: 'boolean',
- description: 'Launch webpack-bundle-analyzer to optimize your bundles',
- prepare (cmd, options, argv) {
- // Analyze option
- options.build = options.build || {}
- if (argv.analyze && typeof options.build.analyze !== 'object') {
- options.build.analyze = true
- }
- }
- },
- devtools: {
- type: 'boolean',
- default: false,
- description: 'Enable Vue devtools',
- prepare (cmd, options, argv) {
- options.vue = options.vue || {}
- options.vue.config = options.vue.config || {}
- if (argv.devtools) {
- options.vue.config.devtools = true
- }
- }
- },
- generate: {
- type: 'boolean',
- default: true,
- description: 'Don\'t generate static version for SPA mode (useful for nuxt start)'
- },
- quiet: {
- alias: 'q',
- type: 'boolean',
- description: 'Disable output except for errors',
- prepare (cmd, options, argv) {
- // Silence output when using --quiet
- options.build = options.build || {}
- if (argv.quiet) {
- options.build.quiet = Boolean(argv.quiet)
- }
- }
- },
- standalone: {
- type: 'boolean',
- default: false,
- description: 'Bundle all server dependencies (useful for nuxt-start)',
- prepare (cmd, options, argv) {
- if (argv.standalone) {
- options.build.standalone = true
- }
- }
- }
- },
- async run (cmd) {
- const config = await cmd.getNuxtConfig({ dev: false, server: false, _build: true })
- config.server = config.mode === 'spa' && cmd.argv.generate !== false
- const nuxt = await cmd.getNuxt(config)
-
- if (cmd.argv.lock) {
- await cmd.setLock(await createLock({
- id: 'build',
- dir: nuxt.options.buildDir,
- root: config.rootDir
- }))
- }
-
- if (nuxt.options.mode === 'spa' && cmd.argv.generate !== false) {
- // Build + Generate for static deployment
- const generator = await cmd.getGenerator(nuxt)
- await generator.generate({ build: true })
- } else {
- // Build only
- const builder = await cmd.getBuilder(nuxt)
- await builder.build()
- }
- }
-}
diff --git a/packages/cli/src/commands/dev.js b/packages/cli/src/commands/dev.js
deleted file mode 100644
index 9674bca05210..000000000000
--- a/packages/cli/src/commands/dev.js
+++ /dev/null
@@ -1,116 +0,0 @@
-import consola from 'consola'
-import chalk from 'chalk'
-import opener from 'opener'
-import { common, server } from '../options'
-import { eventsMapping, formatPath } from '../utils'
-import { showBanner } from '../utils/banner'
-import { showMemoryUsage } from '../utils/memory'
-
-export default {
- name: 'dev',
- description: 'Start the application in development mode (e.g. hot-code reloading, error reporting)',
- usage: 'dev <dir>',
- options: {
- ...common,
- ...server,
- open: {
- alias: 'o',
- type: 'boolean',
- description: 'Opens the server listeners url in the default browser'
- }
- },
-
- async run (cmd) {
- const { argv } = cmd
-
- await this.startDev(cmd, argv, argv.open)
- },
-
- async startDev (cmd, argv) {
- let nuxt
- try {
- nuxt = await this._listenDev(cmd, argv)
- } catch (error) {
- consola.fatal(error)
- return
- }
-
- try {
- await this._buildDev(cmd, argv, nuxt)
- } catch (error) {
- await nuxt.callHook('cli:buildError', error)
- consola.error(error)
- }
-
- return nuxt
- },
-
- async _listenDev (cmd, argv) {
- const config = await cmd.getNuxtConfig({ dev: true, _build: true })
- const nuxt = await cmd.getNuxt(config)
-
- // Setup hooks
- nuxt.hook('watch:restart', payload => this.onWatchRestart(payload, { nuxt, cmd, argv }))
- nuxt.hook('bundler:change', changedFileName => this.onBundlerChange(changedFileName))
-
- // Wait for nuxt to be ready
- await nuxt.ready()
-
- // Start listening
- await nuxt.server.listen()
-
- // Show banner when listening
- showBanner(nuxt, false)
-
- // Opens the server listeners url in the default browser (only once)
- if (argv.open) {
- argv.open = false
- const openerPromises = nuxt.server.listeners.map(listener => opener(listener.url))
- await Promise.all(openerPromises)
- }
-
- // Return instance
- return nuxt
- },
-
- async _buildDev (cmd, argv, nuxt) {
- // Create builder instance
- const builder = await cmd.getBuilder(nuxt)
-
- // Start Build
- await builder.build()
-
- // Print memory usage
- showMemoryUsage()
-
- // Display server urls after the build
- for (const listener of nuxt.server.listeners) {
- consola.info(chalk.bold('Listening on: ') + listener.url)
- }
-
- // Return instance
- return nuxt
- },
-
- logChanged ({ event, path }) {
- const { icon, color, action } = eventsMapping[event] || eventsMapping.change
-
- consola.log({
- type: event,
- icon: chalk[color].bold(icon),
- message: `${action} ${chalk.cyan(formatPath(path))}`
- })
- },
-
- async onWatchRestart ({ event, path }, { nuxt, cmd, argv }) {
- this.logChanged({ event, path })
-
- await nuxt.close()
-
- await this.startDev(cmd, argv)
- },
-
- onBundlerChange (path) {
- this.logChanged({ event: 'change', path })
- }
-}
diff --git a/packages/cli/src/commands/generate.js b/packages/cli/src/commands/generate.js
deleted file mode 100644
index e32be8f9f358..000000000000
--- a/packages/cli/src/commands/generate.js
+++ /dev/null
@@ -1,95 +0,0 @@
-import { common, locking } from '../options'
-import { normalizeArg, createLock } from '../utils'
-
-export default {
- name: 'generate',
- description: 'Generate a static web application (server-rendered)',
- usage: 'generate <dir>',
- options: {
- ...common,
- ...locking,
- build: {
- type: 'boolean',
- default: true,
- description: 'Only generate pages for dynamic routes. Nuxt has to be built once before using this option'
- },
- devtools: {
- type: 'boolean',
- default: false,
- description: 'Enable Vue devtools',
- prepare (cmd, options, argv) {
- options.vue = options.vue || {}
- options.vue.config = options.vue.config || {}
- if (argv.devtools) {
- options.vue.config.devtools = true
- }
- }
- },
- quiet: {
- alias: 'q',
- type: 'boolean',
- description: 'Disable output except for errors',
- prepare (cmd, options, argv) {
- // Silence output when using --quiet
- options.build = options.build || {}
- if (argv.quiet) {
- options.build.quiet = true
- }
- }
- },
- modern: {
- ...common.modern,
- description: 'Generate app in modern build (modern mode can be only client)',
- prepare (cmd, options, argv) {
- if (normalizeArg(argv.modern)) {
- options.modern = 'client'
- }
- }
- },
- 'fail-on-error': {
- type: 'boolean',
- default: false,
- description: 'Exit with non-zero status code if there are errors when generating pages'
- }
- },
- async run (cmd) {
- const config = await cmd.getNuxtConfig({ dev: false, _generate: true, _build: cmd.argv.build })
-
- // Disable analyze if set by the nuxt config
- if (!config.build) {
- config.build = {}
- }
- config.build.analyze = false
-
- const nuxt = await cmd.getNuxt(config)
-
- if (cmd.argv.lock) {
- await cmd.setLock(await createLock({
- id: 'build',
- dir: nuxt.options.buildDir,
- root: config.rootDir
- }))
-
- nuxt.hook('build:done', async () => {
- await cmd.releaseLock()
-
- await cmd.setLock(await createLock({
- id: 'generate',
- dir: nuxt.options.generate.dir,
- root: config.rootDir
- }))
- })
- }
-
- const generator = await cmd.getGenerator(nuxt)
-
- const { errors } = await generator.generate({
- init: true,
- build: cmd.argv.build
- })
-
- if (cmd.argv['fail-on-error'] && errors.length > 0) {
- throw new Error('Error generating pages, exiting with non-zero code')
- }
- }
-}
diff --git a/packages/cli/src/commands/help.js b/packages/cli/src/commands/help.js
deleted file mode 100644
index e26adf9629e3..000000000000
--- a/packages/cli/src/commands/help.js
+++ /dev/null
@@ -1,29 +0,0 @@
-import consola from 'consola'
-import getCommand from '../commands'
-import listCommands from '../list'
-import { common } from '../options'
-import NuxtCommand from '../command'
-
-export default {
- name: 'help',
- description: 'Shows help for <command>',
- usage: 'help <command>',
- options: {
- help: common.help,
- version: common.version
- },
- async run (cmd) {
- const [name] = cmd._argv
- if (!name) {
- return listCommands()
- }
- const command = await getCommand(name)
-
- if (!command) {
- consola.info(`Unknown command: ${name}`)
- return
- }
-
- NuxtCommand.from(command).showHelp()
- }
-}
diff --git a/packages/cli/src/commands/index.js b/packages/cli/src/commands/index.js
deleted file mode 100644
index defb960b05da..000000000000
--- a/packages/cli/src/commands/index.js
+++ /dev/null
@@ -1,15 +0,0 @@
-const commands = {
- start: () => import('./start'),
- dev: () => import('./dev'),
- build: () => import('./build'),
- generate: () => import('./generate'),
- webpack: () => import('./webpack'),
- help: () => import('./help')
-}
-
-export default function getCommand (name) {
- if (!commands[name]) {
- return Promise.resolve(null)
- }
- return commands[name]().then(m => m.default)
-}
diff --git a/packages/cli/src/commands/start.js b/packages/cli/src/commands/start.js
deleted file mode 100644
index 89987e5c2df1..000000000000
--- a/packages/cli/src/commands/start.js
+++ /dev/null
@@ -1,20 +0,0 @@
-import { common, server } from '../options'
-import { showBanner } from '../utils/banner'
-
-export default {
- name: 'start',
- description: 'Start the application in production mode (the application should be compiled with `nuxt build` first)',
- usage: 'start <dir>',
- options: {
- ...common,
- ...server
- },
- async run (cmd) {
- const config = await cmd.getNuxtConfig({ dev: false, _start: true })
- const nuxt = await cmd.getNuxt(config)
-
- // Listen and show ready banner
- await nuxt.server.listen()
- showBanner(nuxt)
- }
-}
diff --git a/packages/cli/src/commands/webpack.js b/packages/cli/src/commands/webpack.js
deleted file mode 100644
index 5d453f330881..000000000000
--- a/packages/cli/src/commands/webpack.js
+++ /dev/null
@@ -1,114 +0,0 @@
-import util from 'util'
-import consola from 'consola'
-import get from 'lodash/get'
-import { common } from '../options'
-
-export default {
- name: 'webpack',
- description: 'Inspect Nuxt webpack config',
- usage: 'webpack [query...]',
- options: {
- ...common,
- name: {
- alias: 'n',
- type: 'string',
- default: 'client',
- description: 'Webpack bundle name: server, client, modern'
- },
- depth: {
- alias: 'd',
- type: 'string',
- default: 2,
- description: 'Inspection depth'
- },
- colors: {
- type: 'boolean',
- default: process.stdout.isTTY,
- description: 'Output with ANSI colors'
- },
- dev: {
- type: 'boolean',
- default: false,
- description: 'Inspect development mode webpack config'
- }
- },
- async run (cmd) {
- const { name } = cmd.argv
- const queries = [...cmd.argv._]
-
- const config = await cmd.getNuxtConfig({ dev: cmd.argv.dev, server: false })
- const nuxt = await cmd.getNuxt(config)
- const builder = await cmd.getBuilder(nuxt)
- const { bundleBuilder } = builder
- const webpackConfig = bundleBuilder.getWebpackConfig(name)
-
- let queryError
- const match = queries.reduce((result, query) => {
- const m = advancedGet(result, query)
- if (m === undefined) {
- queryError = query
- return result
- }
- return m
- }, webpackConfig)
-
- const serialized = formatObj(match, {
- depth: parseInt(cmd.argv.depth),
- colors: cmd.argv.colors
- })
-
- consola.log(serialized + '\n')
-
- if (serialized.includes('[Object]' || serialized.includes('[Array'))) {
- consola.info('You can use `--depth` or add more queries to inspect `[Object]` and `[Array]` fields.')
- }
-
- if (queryError) {
- consola.warn(`No match in webpack config for \`${queryError}\``)
- }
- }
-}
-
-function advancedGet (obj = {}, query = '') {
- let result = obj
-
- if (!query || !result) {
- return result
- }
-
- const [l, r] = query.split('=')
-
- if (!Array.isArray(result)) {
- return typeof result === 'object' ? get(result, l) : result
- }
-
- result = result.filter((i) => {
- const v = get(i, l)
-
- if (!v) {
- return
- }
-
- if (
- (v === r) ||
- (typeof v.test === 'function' && v.test(r)) ||
- (typeof v.match === 'function' && v.match(r)) ||
- (r && r.match(v))
- ) {
- return true
- }
- })
-
- if (result.length === 1) {
- return result[0]
- }
-
- return result.length ? result : undefined
-}
-
-function formatObj (obj, formatOptions) {
- if (!util.formatWithOptions) {
- return util.format(obj)
- }
- return util.formatWithOptions(formatOptions, obj)
-}
diff --git a/packages/cli/src/imports.js b/packages/cli/src/imports.js
deleted file mode 100644
index 50e283fc4543..000000000000
--- a/packages/cli/src/imports.js
+++ /dev/null
@@ -1,30 +0,0 @@
-import path from 'path'
-
-const localNodeModules = path.resolve(process.cwd(), 'node_modules')
-
-// Prefer importing modules from local node_modules (for NPX and global bin)
-async function _import (modulePath) {
- for (const mp of [
- path.resolve(localNodeModules, modulePath),
- modulePath
- ]) {
- try {
- return await import(mp)
- } catch (e) {
- if (e.code !== 'MODULE_NOT_FOUND') {
- throw e
- }
- }
- }
-
- const error = new Error(`Cannot import module '${modulePath}'`)
- error.code = 'MODULE_NOT_FOUND'
- throw error
-}
-
-export const builder = () => _import('@nuxt/builder')
-export const webpack = () => _import('@nuxt/webpack')
-export const generator = () => _import('@nuxt/generator')
-export const core = () => _import('@nuxt/core')
-
-export const importModule = _import
diff --git a/packages/cli/src/index.js b/packages/cli/src/index.js
deleted file mode 100644
index fd633598a330..000000000000
--- a/packages/cli/src/index.js
+++ /dev/null
@@ -1,15 +0,0 @@
-import * as commands from './commands'
-import * as imports from './imports'
-import * as options from './options'
-
-export {
- commands,
- imports,
- options
-}
-
-export { default as NuxtCommand } from './command'
-export { default as setup } from './setup'
-export { default as run } from './run'
-export { loadNuxtConfig } from './utils/config'
-export { getWebpackConfig } from './utils/webpack'
diff --git a/packages/cli/src/list.js b/packages/cli/src/list.js
deleted file mode 100644
index 13d21d997a97..000000000000
--- a/packages/cli/src/list.js
+++ /dev/null
@@ -1,35 +0,0 @@
-import chalk from 'chalk'
-import { indent, foldLines, colorize } from './utils/formatting'
-import { startSpaces, optionSpaces } from './utils/constants'
-import getCommand from './commands'
-
-export default async function listCommands () {
- const commandsOrder = ['dev', 'build', 'generate', 'start', 'help']
-
- // Load all commands
- const _commands = await Promise.all(
- commandsOrder.map(cmd => getCommand(cmd))
- )
-
- let maxLength = 0
- const commandsHelp = []
-
- for (const command of _commands) {
- commandsHelp.push([command.usage, command.description])
- maxLength = Math.max(maxLength, command.usage.length)
- }
-
- const _cmds = commandsHelp.map(([cmd, description]) => {
- const i = indent(maxLength + optionSpaces - cmd.length)
- return foldLines(
- chalk.green(cmd) + i + description,
- startSpaces + maxLength + optionSpaces * 2,
- startSpaces + optionSpaces
- )
- }).join('\n')
-
- const usage = foldLines('Usage: nuxt <command> [--help|-h]', startSpaces)
- const cmds = foldLines('Commands:', startSpaces) + '\n\n' + _cmds
-
- process.stderr.write(colorize(`${usage}\n\n${cmds}\n\n`))
-}
diff --git a/packages/cli/src/options/common.js b/packages/cli/src/options/common.js
deleted file mode 100644
index 948c7dd8921f..000000000000
--- a/packages/cli/src/options/common.js
+++ /dev/null
@@ -1,48 +0,0 @@
-import { defaultNuxtConfigFile } from '@nuxt/config'
-import { normalizeArg } from '../utils'
-
-export default {
- spa: {
- alias: 's',
- type: 'boolean',
- description: 'Launch in SPA mode'
- },
- universal: {
- alias: 'u',
- type: 'boolean',
- description: 'Launch in Universal mode (default)'
- },
- 'config-file': {
- alias: 'c',
- type: 'string',
- default: defaultNuxtConfigFile,
- description: `Path to Nuxt.js config file (default: \`${defaultNuxtConfigFile}\`)`
- },
- modern: {
- alias: 'm',
- type: 'string',
- description: 'Build/Start app for modern browsers, e.g. server, client and false',
- prepare (cmd, options, argv) {
- if (argv.modern !== undefined) {
- options.modern = normalizeArg(argv.modern)
- }
- }
- },
- 'force-exit': {
- type: 'boolean',
- default (cmd) {
- return ['build', 'generate'].includes(cmd.name)
- },
- description: 'Whether Nuxt.js should force exit after the command has finished'
- },
- version: {
- alias: 'v',
- type: 'boolean',
- description: 'Display the Nuxt version'
- },
- help: {
- alias: 'h',
- type: 'boolean',
- description: 'Display this message'
- }
-}
diff --git a/packages/cli/src/options/index.js b/packages/cli/src/options/index.js
deleted file mode 100644
index 1d2420967e57..000000000000
--- a/packages/cli/src/options/index.js
+++ /dev/null
@@ -1,9 +0,0 @@
-import common from './common'
-import server from './server'
-import locking from './locking'
-
-export {
- common,
- server,
- locking
-}
diff --git a/packages/cli/src/options/locking.js b/packages/cli/src/options/locking.js
deleted file mode 100644
index 28035510aec5..000000000000
--- a/packages/cli/src/options/locking.js
+++ /dev/null
@@ -1,7 +0,0 @@
-export default {
- lock: {
- type: 'boolean',
- default: true,
- description: 'Do not set a lock on the project when building'
- }
-}
diff --git a/packages/cli/src/options/server.js b/packages/cli/src/options/server.js
deleted file mode 100644
index 36316b23e6a5..000000000000
--- a/packages/cli/src/options/server.js
+++ /dev/null
@@ -1,29 +0,0 @@
-import consola from 'consola'
-
-export default {
- port: {
- alias: 'p',
- type: 'string',
- description: 'Port number on which to start the application',
- prepare (cmd, options, argv) {
- if (argv.port) {
- options.server.port = +argv.port
- }
- }
- },
- hostname: {
- alias: 'H',
- type: 'string',
- description: 'Hostname on which to start the application',
- prepare (cmd, options, argv) {
- if (argv.hostname === '') {
- consola.fatal('Provided hostname argument has no value')
- }
- }
- },
- 'unix-socket': {
- alias: 'n',
- type: 'string',
- description: 'Path to a UNIX socket'
- }
-}
diff --git a/packages/cli/src/run.js b/packages/cli/src/run.js
deleted file mode 100644
index e6847c57329e..000000000000
--- a/packages/cli/src/run.js
+++ /dev/null
@@ -1,60 +0,0 @@
-import fs from 'fs'
-import execa from 'execa'
-import { name as pkgName } from '../package.json'
-import NuxtCommand from './command'
-import setup from './setup'
-import getCommand from './commands'
-
-function packageExists (name) {
- try {
- require.resolve(name)
- return true
- } catch (e) {
- return false
- }
-}
-
-export default async function run (_argv, hooks = {}) {
- // Check for not installing both nuxt and nuxt-edge
- const dupPkg = '@nuxt/' + (pkgName === '@nuxt/cli-edge' ? 'cli' : 'cli-edge')
- if (packageExists(dupPkg)) {
- throw new Error('Both `nuxt` and `nuxt-edge` dependencies are installed! This is unsupported, please choose one and remove the other one from dependencies.')
- }
-
- // Read from process.argv
- const argv = _argv ? Array.from(_argv) : process.argv.slice(2)
-
- // Check for internal command
- let cmd = await getCommand(argv[0])
-
- // Matching `nuxt` or `nuxt [dir]` or `nuxt -*` for `nuxt dev` shortcut
- if (!cmd && (!argv[0] || argv[0][0] === '-' || fs.existsSync(argv[0]))) {
- argv.unshift('dev')
- cmd = await getCommand('dev')
- }
-
- // Check for dev
- const dev = argv[0] === 'dev'
-
- // Setup env
- setup({ dev })
-
- // Try internal command
- if (cmd) {
- return NuxtCommand.run(cmd, argv.slice(1), hooks)
- }
-
- // Try external command
- try {
- await execa(`nuxt-${argv[0]}`, argv.slice(1), {
- stdout: process.stdout,
- stderr: process.stderr,
- stdin: process.stdin
- })
- } catch (error) {
- if (error.exitCode === 2) {
- throw String(`Command not found: nuxt-${argv[0]}`)
- }
- throw String(`Failed to run command \`nuxt-${argv[0]}\`:\n${error}`)
- }
-}
diff --git a/packages/cli/src/setup.js b/packages/cli/src/setup.js
deleted file mode 100644
index 1fba67e2ca9b..000000000000
--- a/packages/cli/src/setup.js
+++ /dev/null
@@ -1,38 +0,0 @@
-import consola from 'consola'
-import exit from 'exit'
-import { fatalBox } from './utils/formatting'
-
-let _setup = false
-
-export default function setup ({ dev }) {
- // Apply default NODE_ENV if not provided
- if (!process.env.NODE_ENV) {
- process.env.NODE_ENV = dev ? 'development' : 'production'
- }
-
- if (_setup) {
- return
- }
- _setup = true
-
- // Global error handler
- /* istanbul ignore next */
- process.on('unhandledRejection', (err) => {
- consola.error(err)
- })
-
- // Exit process on fatal errors
- /* istanbul ignore next */
- consola.addReporter({
- log (logObj) {
- if (logObj.type === 'fatal') {
- const errorMessage = String(logObj.args[0])
- process.stderr.write(fatalBox(errorMessage))
- exit(1)
- }
- }
- })
-
- // Wrap all console logs with consola for better DX
- consola.wrapConsole()
-}
diff --git a/packages/cli/src/utils/banner.js b/packages/cli/src/utils/banner.js
deleted file mode 100644
index a9e5237fa2b3..000000000000
--- a/packages/cli/src/utils/banner.js
+++ /dev/null
@@ -1,44 +0,0 @@
-import consola from 'consola'
-import env from 'std-env'
-import chalk from 'chalk'
-import { successBox } from './formatting'
-import { getFormattedMemoryUsage } from './memory'
-
-export function showBanner (nuxt, showMemoryUsage = true) {
- if (env.test) {
- return
- }
-
- if (env.minimalCLI) {
- for (const listener of nuxt.server.listeners) {
- consola.info('Listening on: ' + listener.url)
- }
- return
- }
-
- const titleLines = []
- const messageLines = []
-
- // Name and version
- const { bannerColor } = nuxt.options.cli
- titleLines.push(`${chalk[bannerColor].bold('Nuxt.js')} ${nuxt.constructor.version}`)
-
- // Running mode
- titleLines.push(`Running in ${nuxt.options.dev ? chalk.bold.blue('development') : chalk.bold.green('production')} mode (${chalk.bold(nuxt.options.mode)})`)
-
- if (showMemoryUsage) {
- titleLines.push(getFormattedMemoryUsage())
- }
-
- // Listeners
- for (const listener of nuxt.server.listeners) {
- messageLines.push(chalk.bold('Listening on: ') + chalk.underline.blue(listener.url))
- }
-
- // Add custom badge messages
- if (nuxt.options.cli.badgeMessages.length) {
- messageLines.push('', ...nuxt.options.cli.badgeMessages)
- }
-
- process.stdout.write(successBox(messageLines.join('\n'), titleLines.join('\n')))
-}
diff --git a/packages/cli/src/utils/config.js b/packages/cli/src/utils/config.js
deleted file mode 100644
index 44ea8a5e7a1e..000000000000
--- a/packages/cli/src/utils/config.js
+++ /dev/null
@@ -1,27 +0,0 @@
-import path from 'path'
-import defaultsDeep from 'lodash/defaultsDeep'
-import { loadNuxtConfig as _loadNuxtConfig, getDefaultNuxtConfig } from '@nuxt/config'
-
-export async function loadNuxtConfig (argv, configContext) {
- const rootDir = path.resolve(argv._[0] || '.')
- const configFile = argv['config-file']
-
- // Load config
- const options = await _loadNuxtConfig({
- rootDir,
- configFile,
- configContext
- })
-
- // Nuxt Mode
- options.mode = (argv.spa && 'spa') || (argv.universal && 'universal') || options.mode
-
- // Server options
- options.server = defaultsDeep({
- port: argv.port || undefined,
- host: argv.hostname || undefined,
- socket: argv['unix-socket'] || undefined
- }, options.server || {}, getDefaultNuxtConfig().server)
-
- return options
-}
diff --git a/packages/cli/src/utils/constants.js b/packages/cli/src/utils/constants.js
deleted file mode 100644
index 4bd9089e8ce5..000000000000
--- a/packages/cli/src/utils/constants.js
+++ /dev/null
@@ -1,8 +0,0 @@
-export const forceExitTimeout = 5
-
-export const startSpaces = 2
-export const optionSpaces = 2
-
-// 80% of terminal column width
-// this is a fn because console width can have changed since startup
-export const maxCharsPerLine = () => (process.stdout.columns || 100) * 80 / 100
diff --git a/packages/cli/src/utils/formatting.js b/packages/cli/src/utils/formatting.js
deleted file mode 100644
index c085eab83c37..000000000000
--- a/packages/cli/src/utils/formatting.js
+++ /dev/null
@@ -1,69 +0,0 @@
-import wrapAnsi from 'wrap-ansi'
-import chalk from 'chalk'
-import boxen from 'boxen'
-import { maxCharsPerLine } from './constants'
-
-export function indent (count, chr = ' ') {
- return chr.repeat(count)
-}
-
-export function indentLines (string, spaces, firstLineSpaces) {
- const lines = Array.isArray(string) ? string : string.split('\n')
- let s = ''
- if (lines.length) {
- const i0 = indent(firstLineSpaces === undefined ? spaces : firstLineSpaces)
- s = i0 + lines.shift()
- }
- if (lines.length) {
- const i = indent(spaces)
- s += '\n' + lines.map(l => i + l).join('\n')
- }
- return s
-}
-
-export function foldLines (string, spaces, firstLineSpaces, charsPerLine = maxCharsPerLine()) {
- return indentLines(wrapAnsi(string, charsPerLine), spaces, firstLineSpaces)
-}
-
-export function colorize (text) {
- return text
- .replace(/\[[^ ]+]/g, m => chalk.grey(m))
- .replace(/<[^ ]+>/g, m => chalk.green(m))
- .replace(/ (-[-\w,]+)/g, m => chalk.bold(m))
- .replace(/`([^`]+)`/g, (_, m) => chalk.bold.cyan(m))
-}
-
-export function box (message, title, options) {
- return boxen([
- title || chalk.white('Nuxt Message'),
- '',
- chalk.white(foldLines(message, 0, 0, maxCharsPerLine()))
- ].join('\n'), Object.assign({
- borderColor: 'white',
- borderStyle: 'round',
- padding: 1,
- margin: 1
- }, options)) + '\n'
-}
-
-export function successBox (message, title) {
- return box(message, title || chalk.green('✔ Nuxt Success'), {
- borderColor: 'green'
- })
-}
-
-export function warningBox (message, title) {
- return box(message, title || chalk.yellow('⚠ Nuxt Warning'), {
- borderColor: 'yellow'
- })
-}
-
-export function errorBox (message, title) {
- return box(message, title || chalk.red('✖ Nuxt Error'), {
- borderColor: 'red'
- })
-}
-
-export function fatalBox (message, title) {
- return errorBox(message, title || chalk.red('✖ Nuxt Fatal Error'))
-}
diff --git a/packages/cli/src/utils/index.js b/packages/cli/src/utils/index.js
deleted file mode 100644
index 44ff0a0f552f..000000000000
--- a/packages/cli/src/utils/index.js
+++ /dev/null
@@ -1,64 +0,0 @@
-import path from 'path'
-import exit from 'exit'
-
-import { lock } from '@nuxt/utils'
-import chalk from 'chalk'
-import env from 'std-env'
-import { warningBox } from './formatting'
-
-export const eventsMapping = {
- add: { icon: '+', color: 'green', action: 'Created' },
- change: { icon: env.windows ? '»' : '↻', color: 'blue', action: 'Updated' },
- unlink: { icon: '-', color: 'red', action: 'Removed' }
-}
-
-export function formatPath (filePath) {
- if (!filePath) {
- return
- }
- return filePath.replace(process.cwd() + path.sep, '')
-}
-
-/**
- * Normalize string argument in command
- *
- * @export
- * @param {String} argument
- * @param {*} defaultValue
- * @returns formatted argument
- */
-export function normalizeArg (arg, defaultValue) {
- switch (arg) {
- case 'true': arg = true; break
- case '': arg = true; break
- case 'false': arg = false; break
- case undefined: arg = defaultValue; break
- }
- return arg
-}
-
-export function forceExit (cmdName, timeout) {
- if (timeout !== false) {
- const exitTimeout = setTimeout(() => {
- const msg = `The command 'nuxt ${cmdName}' finished but did not exit after ${timeout}s
-This is most likely not caused by a bug in Nuxt.js
-Make sure to cleanup all timers and listeners you or your plugins/modules start.
-Nuxt.js will now force exit
-
-${chalk.bold('DeprecationWarning: Starting with Nuxt version 3 this will be a fatal error')}`
-
- // TODO: Change this to a fatal error in v3
- process.stderr.write(warningBox(msg))
- exit(0)
- }, timeout * 1000)
- exitTimeout.unref()
- } else {
- exit(0)
- }
-}
-
-// An immediate export throws an error when mocking with jest
-// TypeError: Cannot set property createLock of #<Object> which has only a getter
-export function createLock (...args) {
- return lock(...args)
-}
diff --git a/packages/cli/src/utils/memory.js b/packages/cli/src/utils/memory.js
deleted file mode 100644
index 3071e59f7a9c..000000000000
--- a/packages/cli/src/utils/memory.js
+++ /dev/null
@@ -1,18 +0,0 @@
-import chalk from 'chalk'
-import consola from 'consola'
-import prettyBytes from 'pretty-bytes'
-
-export function getMemoryUsage () {
- // https://nodejs.org/api/process.html#process_process_memoryusage
- const { heapUsed, rss } = process.memoryUsage()
- return { heap: heapUsed, rss }
-}
-
-export function getFormattedMemoryUsage () {
- const { heap, rss } = getMemoryUsage()
- return `Memory usage: ${chalk.bold(prettyBytes(heap))} (RSS: ${prettyBytes(rss)})`
-}
-
-export function showMemoryUsage () {
- consola.info(getFormattedMemoryUsage())
-}
diff --git a/packages/cli/src/utils/webpack.js b/packages/cli/src/utils/webpack.js
deleted file mode 100644
index 432172efb4e5..000000000000
--- a/packages/cli/src/utils/webpack.js
+++ /dev/null
@@ -1,11 +0,0 @@
-import { core as importCore, builder as importBuilder } from '../imports'
-
-export async function getWebpackConfig (name = 'client', loadOptions = {}) {
- const { loadNuxt } = await importCore()
- const { getBuilder } = await importBuilder()
-
- const nuxt = await loadNuxt(loadOptions)
- const builder = await getBuilder(nuxt)
- const { bundleBuilder } = builder
- return bundleBuilder.getWebpackConfig(name)
-}
diff --git a/packages/cli/test/fixtures/nuxt.async-config.js b/packages/cli/test/fixtures/nuxt.async-config.js
deleted file mode 100644
index 4fa271b3808e..000000000000
--- a/packages/cli/test/fixtures/nuxt.async-config.js
+++ /dev/null
@@ -1,9 +0,0 @@
-import { resolve } from 'path'
-
-export default () => {
- // delete cache is needed because otherwise Jest will return the same
- // object reference as the previous test and then mode will not be
- // set correctly. jest.resetModules doesnt work for some reason
- delete require.cache[resolve(__dirname, 'nuxt.config.js')]
- return import('./nuxt.config.js')
-}
diff --git a/packages/cli/test/fixtures/nuxt.async-error.js b/packages/cli/test/fixtures/nuxt.async-error.js
deleted file mode 100644
index fb5f8ca71181..000000000000
--- a/packages/cli/test/fixtures/nuxt.async-error.js
+++ /dev/null
@@ -1 +0,0 @@
-export default () => Promise.reject(new Error('Async Config Error'))
diff --git a/packages/cli/test/fixtures/nuxt.config.js b/packages/cli/test/fixtures/nuxt.config.js
deleted file mode 100644
index 7594287a998a..000000000000
--- a/packages/cli/test/fixtures/nuxt.config.js
+++ /dev/null
@@ -1,10 +0,0 @@
-export default {
- testOption: true,
- rootDir: '/some/path',
- mode: 'supercharged',
- server: {
- host: 'nuxt-host',
- port: 3001,
- socket: '/var/run/nuxt.sock'
- }
-}
diff --git a/packages/cli/test/fixtures/nuxt.fn-config.js b/packages/cli/test/fixtures/nuxt.fn-config.js
deleted file mode 100644
index 3f8e9810deb9..000000000000
--- a/packages/cli/test/fixtures/nuxt.fn-config.js
+++ /dev/null
@@ -1,3 +0,0 @@
-export default (context) => {
- return { context }
-}
diff --git a/packages/cli/test/unit/__snapshots__/command.test.js.snap b/packages/cli/test/unit/__snapshots__/command.test.js.snap
deleted file mode 100644
index 7e94e0af4a61..000000000000
--- a/packages/cli/test/unit/__snapshots__/command.test.js.snap
+++ /dev/null
@@ -1,37 +0,0 @@
-// Jest Snapshot v1, https://goo.gl/fbAQLP
-
-exports[`cli/command builds help text 1`] = `
-" Usage: nuxt this is how you do it
- [options]
-
- a very long description that should wrap
- to the next line because is not longer
- than the terminal width
-
- Options:
-
- --spa, -s Launch in SPA mode
- --universal, -u Launch in Universal
- mode (default)
- --config-file, -c Path to Nuxt.js
- config file (default: nuxt.config)
- --modern, -m Build/Start app for
- modern browsers, e.g. server, client and
- false
- --force-exit Whether Nuxt.js
- should force exit after the command has
- finished
- --version, -v Display the Nuxt
- version
- --help, -h Display this message
- --port, -p Port number on which
- to start the application
- --hostname, -H Hostname on which to
- start the application
- --unix-socket, -n Path to a UNIX socket
- --foo very long option that
- is longer than the terminal width and
- should wrap to the next line
-
-"
-`;
diff --git a/packages/cli/test/unit/__snapshots__/webpack.test.js.snap b/packages/cli/test/unit/__snapshots__/webpack.test.js.snap
deleted file mode 100644
index b5000549cdf2..000000000000
--- a/packages/cli/test/unit/__snapshots__/webpack.test.js.snap
+++ /dev/null
@@ -1,685 +0,0 @@
-// Jest Snapshot v1, https://goo.gl/fbAQLP
-
-exports[`webpack getWebpackConfig() 1`] = `
-"Object {
- \\"loader\\": \\"vue-loader\\",
- \\"options\\": Object {
- \\"productionMode\\": true,
- \\"transformAssetUrls\\": Object {
- \\"embed\\": \\"src\\",
- \\"object\\": \\"src\\",
- \\"source\\": \\"src\\",
- \\"video\\": \\"src\\",
- },
- },
- \\"test\\": /\\\\.vue$/i,
-}"
-`;
-
-exports[`webpack nuxt webpack devtool 1`] = `
-"false
-"
-`;
-
-exports[`webpack nuxt webpack module.rules 1`] = `
-"Array [
- Object {
- \\"loader\\": \\"vue-loader\\",
- \\"options\\": Object {
- \\"productionMode\\": true,
- \\"transformAssetUrls\\": Object {
- \\"embed\\": \\"src\\",
- \\"object\\": \\"src\\",
- \\"source\\": \\"src\\",
- \\"video\\": \\"src\\",
- },
- },
- \\"test\\": /\\\\.vue$/i,
- },
- Object {
- \\"oneOf\\": Array [
- Object {
- \\"resourceQuery\\": /^\\\\?vue/i,
- \\"use\\": Array [
- Object {
- \\"loader\\": \\"pug-plain-loader\\",
- \\"options\\": Object {},
- },
- ],
- },
- Object {
- \\"use\\": Array [
- \\"raw-loader\\",
- Object {
- \\"loader\\": \\"pug-plain-loader\\",
- \\"options\\": Object {},
- },
- ],
- },
- ],
- \\"test\\": /\\\\.pug$/i,
- },
- Object {
- \\"exclude\\": [Function exclude],
- \\"test\\": /\\\\.m?jsx?$/i,
- \\"use\\": Array [
- Object {
- \\"loader\\": \\"<nuxtDir>/node_modules/babel-loader/lib/index.js\\",
- \\"options\\": Object {
- \\"babelrc\\": false,
- \\"cacheDirectory\\": false,
- \\"configFile\\": false,
- \\"envName\\": \\"client\\",
- \\"presets\\": Array [
- Array [
- \\"<nuxtDir>/packages/babel-preset-app/src/index.js\\",
- Object {},
- ],
- ],
- },
- },
- ],
- },
- Object {
- \\"oneOf\\": Array [
- Object {
- \\"resourceQuery\\": /module/,
- \\"use\\": Array [
- Object {
- \\"loader\\": \\"vue-style-loader\\",
- \\"options\\": Object {
- \\"sourceMap\\": false,
- },
- },
- Object {
- \\"loader\\": \\"css-loader\\",
- \\"options\\": Object {
- \\"importLoaders\\": 2,
- \\"modules\\": Object {
- \\"localIdentName\\": \\"[local]_[hash:base64:5]\\",
- },
- \\"onlyLocals\\": false,
- \\"sourceMap\\": false,
- },
- },
- Object {
- \\"loader\\": \\"postcss-loader\\",
- \\"options\\": Object {
- \\"order\\": \\"presetEnvAndCssnanoLast\\",
- \\"plugins\\": Array [
- [Function anonymous],
- [Function anonymous],
- [Function anonymous],
- [Function anonymous],
- ],
- \\"sourceMap\\": false,
- },
- },
- ],
- },
- Object {
- \\"use\\": Array [
- Object {
- \\"loader\\": \\"vue-style-loader\\",
- \\"options\\": Object {
- \\"sourceMap\\": false,
- },
- },
- Object {
- \\"loader\\": \\"css-loader\\",
- \\"options\\": Object {
- \\"importLoaders\\": 2,
- \\"onlyLocals\\": false,
- \\"sourceMap\\": false,
- },
- },
- Object {
- \\"loader\\": \\"postcss-loader\\",
- \\"options\\": Object {
- \\"order\\": \\"presetEnvAndCssnanoLast\\",
- \\"plugins\\": Array [
- [Function anonymous],
- [Function anonymous],
- [Function anonymous],
- [Function anonymous],
- ],
- \\"sourceMap\\": false,
- },
- },
- ],
- },
- ],
- \\"test\\": /\\\\.css$/i,
- },
- Object {
- \\"oneOf\\": Array [
- Object {
- \\"resourceQuery\\": /module/,
- \\"use\\": Array [
- Object {
- \\"loader\\": \\"vue-style-loader\\",
- \\"options\\": Object {
- \\"sourceMap\\": false,
- },
- },
- Object {
- \\"loader\\": \\"css-loader\\",
- \\"options\\": Object {
- \\"importLoaders\\": 2,
- \\"modules\\": Object {
- \\"localIdentName\\": \\"[local]_[hash:base64:5]\\",
- },
- \\"onlyLocals\\": false,
- \\"sourceMap\\": false,
- },
- },
- Object {
- \\"loader\\": \\"postcss-loader\\",
- \\"options\\": Object {
- \\"order\\": \\"presetEnvAndCssnanoLast\\",
- \\"plugins\\": Array [
- [Function anonymous],
- [Function anonymous],
- [Function anonymous],
- [Function anonymous],
- ],
- \\"sourceMap\\": false,
- },
- },
- ],
- },
- Object {
- \\"use\\": Array [
- Object {
- \\"loader\\": \\"vue-style-loader\\",
- \\"options\\": Object {
- \\"sourceMap\\": false,
- },
- },
- Object {
- \\"loader\\": \\"css-loader\\",
- \\"options\\": Object {
- \\"importLoaders\\": 2,
- \\"onlyLocals\\": false,
- \\"sourceMap\\": false,
- },
- },
- Object {
- \\"loader\\": \\"postcss-loader\\",
- \\"options\\": Object {
- \\"order\\": \\"presetEnvAndCssnanoLast\\",
- \\"plugins\\": Array [
- [Function anonymous],
- [Function anonymous],
- [Function anonymous],
- [Function anonymous],
- ],
- \\"sourceMap\\": false,
- },
- },
- ],
- },
- ],
- \\"test\\": /\\\\.p(ost)?css$/i,
- },
- Object {
- \\"oneOf\\": Array [
- Object {
- \\"resourceQuery\\": /module/,
- \\"use\\": Array [
- Object {
- \\"loader\\": \\"vue-style-loader\\",
- \\"options\\": Object {
- \\"sourceMap\\": false,
- },
- },
- Object {
- \\"loader\\": \\"css-loader\\",
- \\"options\\": Object {
- \\"importLoaders\\": 2,
- \\"modules\\": Object {
- \\"localIdentName\\": \\"[local]_[hash:base64:5]\\",
- },
- \\"onlyLocals\\": false,
- \\"sourceMap\\": false,
- },
- },
- Object {
- \\"loader\\": \\"postcss-loader\\",
- \\"options\\": Object {
- \\"order\\": \\"presetEnvAndCssnanoLast\\",
- \\"plugins\\": Array [
- [Function anonymous],
- [Function anonymous],
- [Function anonymous],
- [Function anonymous],
- ],
- \\"sourceMap\\": false,
- },
- },
- Object {
- \\"loader\\": \\"less-loader\\",
- \\"options\\": Object {
- \\"sourceMap\\": false,
- },
- },
- ],
- },
- Object {
- \\"use\\": Array [
- Object {
- \\"loader\\": \\"vue-style-loader\\",
- \\"options\\": Object {
- \\"sourceMap\\": false,
- },
- },
- Object {
- \\"loader\\": \\"css-loader\\",
- \\"options\\": Object {
- \\"importLoaders\\": 2,
- \\"onlyLocals\\": false,
- \\"sourceMap\\": false,
- },
- },
- Object {
- \\"loader\\": \\"postcss-loader\\",
- \\"options\\": Object {
- \\"order\\": \\"presetEnvAndCssnanoLast\\",
- \\"plugins\\": Array [
- [Function anonymous],
- [Function anonymous],
- [Function anonymous],
- [Function anonymous],
- ],
- \\"sourceMap\\": false,
- },
- },
- Object {
- \\"loader\\": \\"less-loader\\",
- \\"options\\": Object {
- \\"sourceMap\\": false,
- },
- },
- ],
- },
- ],
- \\"test\\": /\\\\.less$/i,
- },
- Object {
- \\"oneOf\\": Array [
- Object {
- \\"resourceQuery\\": /module/,
- \\"use\\": Array [
- Object {
- \\"loader\\": \\"vue-style-loader\\",
- \\"options\\": Object {
- \\"sourceMap\\": false,
- },
- },
- Object {
- \\"loader\\": \\"css-loader\\",
- \\"options\\": Object {
- \\"importLoaders\\": 2,
- \\"modules\\": Object {
- \\"localIdentName\\": \\"[local]_[hash:base64:5]\\",
- },
- \\"onlyLocals\\": false,
- \\"sourceMap\\": false,
- },
- },
- Object {
- \\"loader\\": \\"postcss-loader\\",
- \\"options\\": Object {
- \\"order\\": \\"presetEnvAndCssnanoLast\\",
- \\"plugins\\": Array [
- [Function anonymous],
- [Function anonymous],
- [Function anonymous],
- [Function anonymous],
- ],
- \\"sourceMap\\": false,
- },
- },
- Object {
- \\"loader\\": \\"sass-loader\\",
- \\"options\\": Object {
- \\"sassOptions\\": Object {
- \\"indentedSyntax\\": true,
- },
- \\"sourceMap\\": false,
- },
- },
- ],
- },
- Object {
- \\"use\\": Array [
- Object {
- \\"loader\\": \\"vue-style-loader\\",
- \\"options\\": Object {
- \\"sourceMap\\": false,
- },
- },
- Object {
- \\"loader\\": \\"css-loader\\",
- \\"options\\": Object {
- \\"importLoaders\\": 2,
- \\"onlyLocals\\": false,
- \\"sourceMap\\": false,
- },
- },
- Object {
- \\"loader\\": \\"postcss-loader\\",
- \\"options\\": Object {
- \\"order\\": \\"presetEnvAndCssnanoLast\\",
- \\"plugins\\": Array [
- [Function anonymous],
- [Function anonymous],
- [Function anonymous],
- [Function anonymous],
- ],
- \\"sourceMap\\": false,
- },
- },
- Object {
- \\"loader\\": \\"sass-loader\\",
- \\"options\\": Object {
- \\"sassOptions\\": Object {
- \\"indentedSyntax\\": true,
- },
- \\"sourceMap\\": false,
- },
- },
- ],
- },
- ],
- \\"test\\": /\\\\.sass$/i,
- },
- Object {
- \\"oneOf\\": Array [
- Object {
- \\"resourceQuery\\": /module/,
- \\"use\\": Array [
- Object {
- \\"loader\\": \\"vue-style-loader\\",
- \\"options\\": Object {
- \\"sourceMap\\": false,
- },
- },
- Object {
- \\"loader\\": \\"css-loader\\",
- \\"options\\": Object {
- \\"importLoaders\\": 2,
- \\"modules\\": Object {
- \\"localIdentName\\": \\"[local]_[hash:base64:5]\\",
- },
- \\"onlyLocals\\": false,
- \\"sourceMap\\": false,
- },
- },
- Object {
- \\"loader\\": \\"postcss-loader\\",
- \\"options\\": Object {
- \\"order\\": \\"presetEnvAndCssnanoLast\\",
- \\"plugins\\": Array [
- [Function anonymous],
- [Function anonymous],
- [Function anonymous],
- [Function anonymous],
- ],
- \\"sourceMap\\": false,
- },
- },
- Object {
- \\"loader\\": \\"sass-loader\\",
- \\"options\\": Object {
- \\"sourceMap\\": false,
- },
- },
- ],
- },
- Object {
- \\"use\\": Array [
- Object {
- \\"loader\\": \\"vue-style-loader\\",
- \\"options\\": Object {
- \\"sourceMap\\": false,
- },
- },
- Object {
- \\"loader\\": \\"css-loader\\",
- \\"options\\": Object {
- \\"importLoaders\\": 2,
- \\"onlyLocals\\": false,
- \\"sourceMap\\": false,
- },
- },
- Object {
- \\"loader\\": \\"postcss-loader\\",
- \\"options\\": Object {
- \\"order\\": \\"presetEnvAndCssnanoLast\\",
- \\"plugins\\": Array [
- [Function anonymous],
- [Function anonymous],
- [Function anonymous],
- [Function anonymous],
- ],
- \\"sourceMap\\": false,
- },
- },
- Object {
- \\"loader\\": \\"sass-loader\\",
- \\"options\\": Object {
- \\"sourceMap\\": false,
- },
- },
- ],
- },
- ],
- \\"test\\": /\\\\.scss$/i,
- },
- Object {
- \\"oneOf\\": Array [
- Object {
- \\"resourceQuery\\": /module/,
- \\"use\\": Array [
- Object {
- \\"loader\\": \\"vue-style-loader\\",
- \\"options\\": Object {
- \\"sourceMap\\": false,
- },
- },
- Object {
- \\"loader\\": \\"css-loader\\",
- \\"options\\": Object {
- \\"importLoaders\\": 2,
- \\"modules\\": Object {
- \\"localIdentName\\": \\"[local]_[hash:base64:5]\\",
- },
- \\"onlyLocals\\": false,
- \\"sourceMap\\": false,
- },
- },
- Object {
- \\"loader\\": \\"postcss-loader\\",
- \\"options\\": Object {
- \\"order\\": \\"presetEnvAndCssnanoLast\\",
- \\"plugins\\": Array [
- [Function anonymous],
- [Function anonymous],
- [Function anonymous],
- [Function anonymous],
- ],
- \\"sourceMap\\": false,
- },
- },
- Object {
- \\"loader\\": \\"stylus-loader\\",
- \\"options\\": Object {
- \\"sourceMap\\": false,
- },
- },
- ],
- },
- Object {
- \\"use\\": Array [
- Object {
- \\"loader\\": \\"vue-style-loader\\",
- \\"options\\": Object {
- \\"sourceMap\\": false,
- },
- },
- Object {
- \\"loader\\": \\"css-loader\\",
- \\"options\\": Object {
- \\"importLoaders\\": 2,
- \\"onlyLocals\\": false,
- \\"sourceMap\\": false,
- },
- },
- Object {
- \\"loader\\": \\"postcss-loader\\",
- \\"options\\": Object {
- \\"order\\": \\"presetEnvAndCssnanoLast\\",
- \\"plugins\\": Array [
- [Function anonymous],
- [Function anonymous],
- [Function anonymous],
- [Function anonymous],
- ],
- \\"sourceMap\\": false,
- },
- },
- Object {
- \\"loader\\": \\"stylus-loader\\",
- \\"options\\": Object {
- \\"sourceMap\\": false,
- },
- },
- ],
- },
- ],
- \\"test\\": /\\\\.styl(us)?$/i,
- },
- Object {
- \\"test\\": /\\\\.(png|jpe?g|gif|svg|webp)$/i,
- \\"use\\": Array [
- Object {
- \\"loader\\": \\"url-loader\\",
- \\"options\\": Object {
- \\"limit\\": 1000,
- \\"name\\": \\"img/[contenthash:7].[ext]\\",
- },
- },
- ],
- },
- Object {
- \\"test\\": /\\\\.(woff2?|eot|ttf|otf)(\\\\?.*)?$/i,
- \\"use\\": Array [
- Object {
- \\"loader\\": \\"url-loader\\",
- \\"options\\": Object {
- \\"limit\\": 1000,
- \\"name\\": \\"fonts/[contenthash:7].[ext]\\",
- },
- },
- ],
- },
- Object {
- \\"test\\": /\\\\.(webm|mp4|ogv)$/i,
- \\"use\\": Array [
- Object {
- \\"loader\\": \\"file-loader\\",
- \\"options\\": Object {
- \\"name\\": \\"videos/[contenthash:7].[ext]\\",
- },
- },
- ],
- },
-]
-"
-`;
-
-exports[`webpack nuxt webpack module.rules loader=.*-loader 1`] = `
-"Object {
- \\"loader\\": \\"vue-loader\\",
- \\"options\\": Object {
- \\"productionMode\\": true,
- \\"transformAssetUrls\\": Object {
- \\"embed\\": \\"src\\",
- \\"object\\": \\"src\\",
- \\"source\\": \\"src\\",
- \\"video\\": \\"src\\",
- },
- },
- \\"test\\": /\\\\.vue$/i,
-}
-"
-`;
-
-exports[`webpack nuxt webpack module.rules loader=vue- 1`] = `
-"Object {
- \\"loader\\": \\"vue-loader\\",
- \\"options\\": Object {
- \\"productionMode\\": true,
- \\"transformAssetUrls\\": Object {
- \\"embed\\": \\"src\\",
- \\"object\\": \\"src\\",
- \\"source\\": \\"src\\",
- \\"video\\": \\"src\\",
- },
- },
- \\"test\\": /\\\\.vue$/i,
-}
-"
-`;
-
-exports[`webpack nuxt webpack module.rules test=.jsx 1`] = `
-"Object {
- \\"exclude\\": [Function exclude],
- \\"test\\": /\\\\.m?jsx?$/i,
- \\"use\\": Array [
- Object {
- \\"loader\\": \\"<nuxtDir>/node_modules/babel-loader/lib/index.js\\",
- \\"options\\": Object {
- \\"babelrc\\": false,
- \\"cacheDirectory\\": false,
- \\"configFile\\": false,
- \\"envName\\": \\"client\\",
- \\"presets\\": Array [
- Array [
- \\"<nuxtDir>/packages/babel-preset-app/src/index.js\\",
- Object {},
- ],
- ],
- },
- },
- ],
-}
-"
-`;
-
-exports[`webpack nuxt webpack nuxt webpack module rules test=.pug oneOf use.0=raw 1`] = `
-"Object {
- \\"use\\": Array [
- \\"raw-loader\\",
- Object {
- \\"loader\\": \\"pug-plain-loader\\",
- \\"options\\": Object {},
- },
- ],
-}
-"
-`;
-
-exports[`webpack nuxt webpack resolve alias 1`] = `
-"Object {
- \\"@\\": \\"<nuxtDir>/resolve\\",
- \\"@@\\": \\"<nuxtDir>/resolve\\",
- \\"assets\\": \\"<nuxtDir>/resolve/assets\\",
- \\"static\\": \\"<nuxtDir>/resolve/static\\",
- \\"vue-meta\\": \\"<nuxtDir>/node_modules/vue-meta/dist/vue-meta.esm.browser.js\\",
- \\"~\\": \\"<nuxtDir>/resolve\\",
- \\"~~\\": \\"<nuxtDir>/resolve\\",
-}
-"
-`;
diff --git a/packages/cli/test/unit/build.test.js b/packages/cli/test/unit/build.test.js
deleted file mode 100644
index 69164cb2bee7..000000000000
--- a/packages/cli/test/unit/build.test.js
+++ /dev/null
@@ -1,146 +0,0 @@
-import * as utils from '../../src/utils'
-import { mockGetNuxt, mockGetBuilder, mockGetGenerator, NuxtCommand } from '../utils'
-
-describe('build', () => {
- let build
-
- beforeAll(async () => {
- build = await import('../../src/commands/build').then(m => m.default)
- jest.spyOn(process, 'exit').mockImplementation(code => code)
- jest.spyOn(utils, 'forceExit').mockImplementation(() => {})
- jest.spyOn(utils, 'createLock').mockImplementation(() => () => {})
- })
-
- afterAll(() => {
- process.exit.mockRestore()
- })
-
- afterEach(() => jest.resetAllMocks())
-
- test('has run function', () => {
- expect(typeof build.run).toBe('function')
- })
-
- test('builds on universal mode', async () => {
- mockGetNuxt({
- mode: 'universal',
- build: {
- analyze: true
- }
- })
- const builder = mockGetBuilder(Promise.resolve())
-
- await NuxtCommand.from(build).run()
-
- expect(builder).toHaveBeenCalled()
- })
-
- test('generates on spa mode', async () => {
- mockGetNuxt({
- mode: 'spa',
- build: {
- analyze: false
- }
- })
- const generate = mockGetGenerator()
-
- await NuxtCommand.from(build).run()
-
- expect(generate).toHaveBeenCalled()
- })
-
- test('build with devtools', async () => {
- mockGetNuxt({
- mode: 'universal'
- })
- const builder = mockGetBuilder(Promise.resolve())
-
- const cmd = NuxtCommand.from(build, ['build', '.', '--devtools'])
-
- const options = await cmd.getNuxtConfig(cmd.argv)
-
- await cmd.run()
-
- expect(options.vue.config.devtools).toBe(true)
- expect(builder).toHaveBeenCalled()
- })
-
- test('build with modern mode', async () => {
- mockGetNuxt({
- mode: 'universal'
- })
- mockGetBuilder(Promise.resolve())
-
- const cmd = NuxtCommand.from(build, ['build', '.', '--m'])
-
- const options = await cmd.getNuxtConfig()
-
- await cmd.run()
-
- expect(options.modern).toBe(true)
- })
-
- test('build force-exits by default', async () => {
- mockGetNuxt()
- mockGetBuilder(Promise.resolve())
-
- const cmd = NuxtCommand.from(build, ['build', '.'])
- await cmd.run()
-
- expect(utils.forceExit).toHaveBeenCalledTimes(1)
- expect(utils.forceExit).toHaveBeenCalledWith('build', 5)
- })
-
- test('build can set force exit explicitly', async () => {
- mockGetNuxt()
- mockGetBuilder(Promise.resolve())
-
- const cmd = NuxtCommand.from(build, ['build', '.', '--force-exit'])
- await cmd.run()
-
- expect(utils.forceExit).toHaveBeenCalledTimes(1)
- expect(utils.forceExit).toHaveBeenCalledWith('build', false)
- })
-
- test('build can disable force exit explicitly', async () => {
- mockGetNuxt()
- mockGetBuilder(Promise.resolve())
-
- const cmd = NuxtCommand.from(build, ['build', '.', '--no-force-exit'])
- await cmd.run()
-
- expect(utils.forceExit).not.toHaveBeenCalled()
- })
-
- test('build locks project by default', async () => {
- mockGetNuxt({
- mode: 'universal'
- })
- mockGetBuilder(Promise.resolve())
-
- const releaseLock = jest.fn(() => Promise.resolve())
- const createLock = jest.fn(() => releaseLock)
- jest.spyOn(utils, 'createLock').mockImplementation(createLock)
-
- const cmd = NuxtCommand.from(build, ['build', '.'])
- await cmd.run()
-
- expect(createLock).toHaveBeenCalledTimes(1)
- expect(releaseLock).toHaveBeenCalledTimes(1)
- })
-
- test('build can disable locking', async () => {
- mockGetNuxt({
- mode: 'universal'
- })
- mockGetBuilder(Promise.resolve())
-
- const createLock = jest.fn(() => Promise.resolve())
- jest.spyOn(utils, 'createLock').mockImplementationOnce(() => createLock)
-
- const cmd = NuxtCommand.from(build, ['build', '.', '--no-lock'])
- await cmd.run()
-
- expect(createLock).not.toHaveBeenCalled()
- })
-})
diff --git a/packages/cli/test/unit/cli.test.js b/packages/cli/test/unit/cli.test.js
deleted file mode 100644
index 010a475b979d..000000000000
--- a/packages/cli/test/unit/cli.test.js
+++ /dev/null
@@ -1,47 +0,0 @@
-import { run } from '../../src'
-import getCommand from '../../src/commands'
-import * as utils from '../../src/utils/'
-
-jest.mock('../../src/commands')
-
-describe('cli', () => {
- beforeAll(() => {
- jest.spyOn(utils, 'forceExit').mockImplementation(() => {})
- })
-
- afterEach(() => jest.resetAllMocks())
-
- test('calls expected method', async () => {
- const mockedCommand = {
- run: jest.fn(() => Promise.resolve({}))
- }
- getCommand.mockImplementationOnce(() => Promise.resolve(mockedCommand))
-
- await run()
- expect(mockedCommand.run).toHaveBeenCalled()
- expect(utils.forceExit).not.toHaveBeenCalled()
- })
-
- test('sets NODE_ENV=development for dev', async () => {
- const nodeEnv = process.env.NODE_ENV
- process.env.NODE_ENV = ''
-
- getCommand.mockImplementationOnce(() => Promise.resolve({ run () { } }))
-
- await run(['dev'])
- expect(process.env.NODE_ENV).toBe('development')
- process.env.NODE_ENV = nodeEnv
- })
-
- test('sets NODE_ENV=production for build', async () => {
- const nodeEnv = process.env.NODE_ENV
- process.env.NODE_ENV = ''
-
- getCommand.mockImplementationOnce(() => Promise.resolve({ run () { } }))
-
- await run(['', '', 'build'])
- expect(process.env.NODE_ENV).toBe('production')
-
- process.env.NODE_ENV = nodeEnv
- })
-})
diff --git a/packages/cli/test/unit/command.test.js b/packages/cli/test/unit/command.test.js
deleted file mode 100644
index fc6051f1f1d3..000000000000
--- a/packages/cli/test/unit/command.test.js
+++ /dev/null
@@ -1,163 +0,0 @@
-import Command from '../../src/command'
-import { common, server } from '../../src/options'
-import * as utils from '../../src/utils/'
-import * as config from '../../src/utils/config'
-import * as constants from '../../src/utils/constants'
-import { consola } from '../utils'
-
-jest.mock('@nuxt/core')
-jest.mock('@nuxt/builder')
-jest.mock('@nuxt/generator')
-
-const allOptions = {
- ...common,
- ...server
-}
-
-describe('cli/command', () => {
- beforeEach(() => jest.restoreAllMocks())
-
- test('builds minimist options', () => {
- const cmd = new Command({ options: allOptions })
- const minimistOptions = cmd._getMinimistOptions()
-
- expect(minimistOptions.string.length).toBe(5)
- expect(minimistOptions.boolean.length).toBe(5)
- expect(minimistOptions.alias.c).toBe('config-file')
- expect(minimistOptions.default.c).toBe(common['config-file'].default)
- })
-
- test('parses args', () => {
- const argv = ['-c', 'test-file', '-s', '-p', '3001']
- const cmd = new Command({ options: { ...common, ...server } }, argv)
-
- expect(cmd.argv['config-file']).toBe(argv[1])
- expect(cmd.argv.spa).toBe(true)
- expect(cmd.argv.universal).toBe(false)
- expect(cmd.argv.port).toBe('3001')
-
- const cmd2 = new Command({ options: { ...common, ...server } }, ['--no-build'])
- expect(cmd2.argv.build).toBe(false)
- })
-
- test('prints version automatically', async () => {
- jest.spyOn(utils, 'forceExit').mockImplementation(() => {})
-
- const cmd = new Command({}, ['--version'])
- cmd.showVersion = jest.fn()
- await cmd.run()
-
- expect(cmd.showVersion).toHaveBeenCalledTimes(1)
- })
-
- test('prints help automatically', async () => {
- jest.spyOn(utils, 'forceExit').mockImplementation(() => {})
-
- const cmd = new Command({ options: allOptions }, ['-h'])
- cmd.showHelp = jest.fn()
- await cmd.run()
-
- expect(cmd.showHelp).toHaveBeenCalledTimes(1)
- })
-
- test('returns nuxt config', async () => {
- const loadConfigSpy = jest.spyOn(config, 'loadNuxtConfig')
-
- const cmd = new Command({ name: 'test', options: allOptions }, ['-c', 'test-file', '-a', '-p', '3001', '-q', '-H'])
-
- const options = await cmd.getNuxtConfig({ testOption: true })
-
- expect(options.testOption).toBe(true)
- expect(options.server.port).toBe(3001)
- expect(consola.fatal).toHaveBeenCalledWith('Provided hostname argument has no value') // hostname check
- expect(loadConfigSpy).toHaveBeenCalledTimes(1)
- expect(loadConfigSpy).toHaveBeenCalledWith(expect.any(Object), { command: 'test', dev: false })
-
- loadConfigSpy.mockRestore()
- })
-
- test('returns Nuxt instance', async () => {
- const cmd = new Command()
- const nuxt = await cmd.getNuxt()
-
- expect(nuxt.constructor.name).toBe('Nuxt')
- expect(typeof nuxt.ready).toBe('function')
- })
-
- test('returns Builder instance', async () => {
- const cmd = new Command()
- const builder = await cmd.getBuilder()
-
- expect(builder.constructor.name).toBe('Builder')
- expect(typeof builder.build).toBe('function')
- })
-
- test('returns Generator instance', async () => {
- const cmd = new Command()
- const generator = await cmd.getGenerator()
-
- expect(generator.constructor.name).toBe('Generator')
- expect(typeof generator.generate).toBe('function')
- })
-
- test('builds help text', () => {
- jest.spyOn(constants, 'maxCharsPerLine').mockReturnValue(40)
-
- const cmd = new Command({
- description: 'a very long description that should wrap to the next line because is not longer ' +
- 'than the terminal width',
- usage: 'this is how you do it',
- options: {
- ...allOptions,
- foo: {
- type: 'boolean',
- description: 'very long option that is longer than the terminal width and ' +
- 'should wrap to the next line'
- }
- }
- })
-
- expect(cmd._getHelp()).toMatchSnapshot()
- })
-
- test('show version prints to stdout and exits', () => {
- jest.spyOn(process.stdout, 'write').mockImplementation(() => {})
- const cmd = new Command()
- cmd.showVersion()
- expect(process.stdout.write).toHaveBeenCalled()
- process.stdout.write.mockRestore()
- })
-
- test('show help prints to stdout and exits', () => {
- jest.spyOn(process.stdout, 'write').mockImplementation(() => {})
- const cmd = new Command()
- cmd.showHelp()
- expect(process.stdout.write).toHaveBeenCalled()
- process.stdout.write.mockRestore()
- })
-
- test('can set and release lock', () => {
- const release = jest.fn(() => Promise.resolve())
- const cmd = new Command()
-
- cmd.setLock(release)
- cmd.releaseLock()
-
- expect(release).toHaveBeenCalledTimes(1)
- })
-
- test('logs warning when lock already exists and removes old lock', () => {
- const release = jest.fn(() => Promise.resolve())
- const cmd = new Command()
-
- cmd.setLock(release)
- cmd.setLock(release)
-
- expect(consola.warn).toHaveBeenCalledTimes(1)
- expect(consola.warn).toHaveBeenCalledWith(expect.stringMatching('A previous unreleased lock was found'))
- expect(release).toHaveBeenCalledTimes(1)
-
- cmd.releaseLock()
- expect(release).toHaveBeenCalledTimes(2)
- })
-})
diff --git a/packages/cli/test/unit/dev.test.js b/packages/cli/test/unit/dev.test.js
deleted file mode 100644
index 2654b4ea0322..000000000000
--- a/packages/cli/test/unit/dev.test.js
+++ /dev/null
@@ -1,141 +0,0 @@
-import * as utils from '../../src/utils/'
-import { consola, mockNuxt, mockBuilder, mockGetNuxtConfig, NuxtCommand } from '../utils'
-
-describe('dev', () => {
- let dev
-
- beforeAll(async () => {
- dev = await import('../../src/commands/dev').then(m => m.default)
- jest.spyOn(utils, 'forceExit').mockImplementation(() => {})
- })
-
- afterEach(() => jest.clearAllMocks())
-
- test('has run function', () => {
- expect(typeof dev.run).toBe('function')
- })
-
- test('reloads on fileRestartHook', async () => {
- const Nuxt = mockNuxt()
- const Builder = mockBuilder()
-
- await NuxtCommand.from(dev).run()
-
- expect(consola.error).not.toHaveBeenCalled()
-
- expect(Builder.prototype.build).toHaveBeenCalled()
- expect(Nuxt.prototype.server.listen).toHaveBeenCalled()
- // expect(Builder.prototype.watchRestart).toHaveBeenCalled()
-
- jest.clearAllMocks()
-
- const builder = new Builder()
- builder.nuxt = new Nuxt()
- await Nuxt.fileRestartHook(builder)
- expect(consola.log).toHaveBeenCalled()
-
- expect(Builder.prototype.build).toHaveBeenCalled()
- expect(Nuxt.prototype.close).toHaveBeenCalled()
- expect(Nuxt.prototype.server.listen).toHaveBeenCalled()
-
- expect(consola.error).not.toHaveBeenCalled()
- })
-
- test('catches build error and calls hook', async () => {
- const Nuxt = mockNuxt()
- const Builder = mockBuilder()
-
- await NuxtCommand.from(dev).run()
- jest.clearAllMocks()
-
- // Test error on second build so we cover oldInstance stuff
- const builder = new Builder()
- builder.nuxt = new Nuxt()
- Builder.prototype.build = () => { throw new Error('Build Error') }
- await Nuxt.fileRestartHook(builder)
-
- expect(Nuxt.prototype.close).toHaveBeenCalled()
- expect(Nuxt.prototype.callHook).toHaveBeenCalledWith('cli:buildError', expect.any(Error))
- expect(consola.error).toHaveBeenCalledWith(new Error('Build Error'))
- })
-
- test.skip('catches watchRestart error', async () => {
- const Nuxt = mockNuxt()
- const Builder = mockBuilder()
-
- await NuxtCommand.from(dev).run()
- jest.clearAllMocks()
-
- const builder = new Builder()
- builder.nuxt = new Nuxt()
- Builder.prototype.watchRestart = jest.fn().mockImplementationOnce(() => Promise.reject(new Error('watchRestart Error')))
- await Nuxt.fileRestartHook(builder)
-
- expect(consola.error).toHaveBeenCalledWith(new Error('watchRestart Error'))
- expect(Builder.prototype.watchRestart).toHaveBeenCalledTimes(2)
- })
-
- test('catches error on hook error', async () => {
- const Nuxt = mockNuxt()
- const Builder = mockBuilder()
-
- await NuxtCommand.from(dev).run()
- jest.clearAllMocks()
-
- mockGetNuxtConfig().mockImplementationOnce(() => {
- throw new Error('Config Error')
- })
- const builder = new Builder()
- builder.nuxt = new Nuxt()
- await Nuxt.fileRestartHook(builder)
-
- expect(consola.fatal).toHaveBeenCalledWith(new Error('Config Error'))
- // expect(Builder.prototype.watchRestart).toHaveBeenCalledTimes(1)
- })
-
- test('catches error on startDev', async () => {
- mockNuxt({
- server: {
- listen: jest.fn().mockImplementation(() => {
- throw new Error('Listen Error')
- })
- }
- })
- mockBuilder()
-
- await NuxtCommand.from(dev).run()
-
- expect(consola.fatal).toHaveBeenCalledWith(new Error('Listen Error'))
- })
-
- test('dev doesnt force-exit by default', async () => {
- mockNuxt()
- mockBuilder()
-
- const cmd = NuxtCommand.from(dev, ['dev', '.'])
- await cmd.run()
-
- expect(utils.forceExit).not.toHaveBeenCalled()
- })
-
- test('dev can set force exit explicitly', async () => {
- mockNuxt()
- mockBuilder()
-
- const cmd = NuxtCommand.from(dev, ['dev', '.', '--force-exit'])
- await cmd.run()
-
- expect(utils.forceExit).toHaveBeenCalledTimes(1)
- expect(utils.forceExit).toHaveBeenCalledWith('dev', false)
- })
-
- test('dev can disable force exit explicitly', async () => {
- mockNuxt()
- mockBuilder()
-
- const cmd = NuxtCommand.from(dev, ['dev', '.', '--no-force-exit'])
- await cmd.run()
-
- expect(utils.forceExit).not.toHaveBeenCalled()
- })
-})
diff --git a/packages/cli/test/unit/generate.test.js b/packages/cli/test/unit/generate.test.js
deleted file mode 100644
index 44b54cc9f498..000000000000
--- a/packages/cli/test/unit/generate.test.js
+++ /dev/null
@@ -1,162 +0,0 @@
-import * as utils from '../../src/utils'
-import { mockGetNuxt, mockGetGenerator, NuxtCommand } from '../utils'
-
-describe('generate', () => {
- let generate
-
- beforeAll(async () => {
- generate = await import('../../src/commands/generate').then(m => m.default)
- jest.spyOn(process, 'exit').mockImplementation(code => code)
- jest.spyOn(utils, 'forceExit').mockImplementation(() => {})
- jest.spyOn(utils, 'createLock').mockImplementation(() => () => {})
- })
-
- afterAll(() => {
- process.exit.mockRestore()
- })
-
- afterEach(() => jest.resetAllMocks())
-
- test('has run function', () => {
- expect(typeof generate.run).toBe('function')
- })
-
- test('builds by default', async () => {
- mockGetNuxt()
- const generator = mockGetGenerator()
-
- await NuxtCommand.from(generate).run()
-
- expect(generator).toHaveBeenCalled()
- expect(generator.mock.calls[0][0].build).toBe(true)
- })
-
- test('doesnt build with no-build', async () => {
- mockGetNuxt()
- const generator = mockGetGenerator()
-
- await NuxtCommand.run(generate, ['generate', '.', '--no-build'])
-
- expect(generator).toHaveBeenCalled()
- expect(generator.mock.calls[0][0].build).toBe(false)
- })
-
- test('build with devtools', async () => {
- mockGetNuxt()
- const generator = mockGetGenerator()
-
- const cmd = NuxtCommand.from(generate, ['generate', '.', '--devtools'])
-
- const options = await cmd.getNuxtConfig()
-
- await cmd.run()
-
- expect(options.vue.config.devtools).toBe(true)
- expect(generator).toHaveBeenCalled()
- expect(generator.mock.calls[0][0].build).toBe(true)
- })
-
- test('generate with modern mode', async () => {
- mockGetNuxt()
- mockGetGenerator()
-
- const cmd = NuxtCommand.from(generate, ['generate', '.', '--m'])
-
- const options = await cmd.getNuxtConfig()
-
- await cmd.run()
-
- expect(options.modern).toBe('client')
- })
-
- test('generate force-exits by default', async () => {
- mockGetNuxt()
- mockGetGenerator()
-
- const cmd = NuxtCommand.from(generate, ['generate', '.'])
- await cmd.run()
-
- expect(utils.forceExit).toHaveBeenCalledTimes(1)
- expect(utils.forceExit).toHaveBeenCalledWith('generate', 5)
- })
-
- test('generate can set force exit explicitly', async () => {
- mockGetNuxt()
- mockGetGenerator()
-
- const cmd = NuxtCommand.from(generate, ['generate', '.', '--force-exit'])
- await cmd.run()
-
- expect(utils.forceExit).toHaveBeenCalledTimes(1)
- expect(utils.forceExit).toHaveBeenCalledWith('generate', false)
- })
-
- test('generate can disable force exit explicitly', async () => {
- mockGetNuxt()
- mockGetGenerator()
-
- const cmd = NuxtCommand.from(generate, ['generate', '.', '--no-force-exit'])
- await cmd.run()
-
- expect(utils.forceExit).not.toHaveBeenCalled()
- })
-
- test('generate locks project by default twice', async () => {
- const releaseLock = jest.fn(() => Promise.resolve())
- const createLock = jest.fn(() => releaseLock)
- jest.spyOn(utils, 'createLock').mockImplementation(createLock)
-
- let buildDone
- mockGetNuxt({ generate: {} }, {
- hook: (hookName, fn) => (buildDone = fn)
- })
-
- mockGetGenerator(async () => {
- await buildDone()
- return { errors: [] }
- })
-
- const cmd = NuxtCommand.from(generate, ['generate', '.'])
- await cmd.run()
-
- expect(createLock).toHaveBeenCalledTimes(2)
- expect(releaseLock).toHaveBeenCalledTimes(2)
- })
-
- test('generate can disable locking', async () => {
- mockGetNuxt()
- mockGetGenerator()
-
- const createLock = jest.fn(() => Promise.resolve())
- jest.spyOn(utils, 'createLock').mockImplementationOnce(() => createLock)
-
- const cmd = NuxtCommand.from(generate, ['generate', '.', '--no-lock'])
- await cmd.run()
-
- expect(createLock).not.toHaveBeenCalled()
- })
-
- test('throw an error when fail-on-error enabled and page errors', async () => {
- mockGetNuxt()
- mockGetGenerator(() => ({ errors: [{ type: 'dummy' }] }))
-
- const cmd = NuxtCommand.from(generate, ['generate', '.', '--fail-on-error'])
- await expect(cmd.run()).rejects.toThrow('Error generating pages, exiting with non-zero code')
- })
-
- test('do not throw an error when fail-on-error disabled and page errors', async () => {
- mockGetNuxt()
- mockGetGenerator(() => ({ errors: [{ type: 'dummy' }] }))
-
- const cmd = NuxtCommand.from(generate, ['generate', '.'])
- await cmd.run()
- })
-
- test('do not throw an error when fail-on-error enabled and no page errors', async () => {
- mockGetNuxt()
- mockGetGenerator()
-
- const cmd = NuxtCommand.from(generate, ['generate', '.', '--fail-on-error'])
- await cmd.run()
- })
-})
diff --git a/packages/cli/test/unit/hooks.test.js b/packages/cli/test/unit/hooks.test.js
deleted file mode 100644
index 6820139efc4d..000000000000
--- a/packages/cli/test/unit/hooks.test.js
+++ /dev/null
@@ -1,52 +0,0 @@
-import path from 'path'
-import { NuxtCommand } from '../utils'
-
-describe('dev', () => {
- let dev
-
- beforeAll(async () => {
- dev = await import('../../src/commands/dev').then(m => m.default)
- })
-
- afterEach(() => jest.clearAllMocks())
-
- test('run:before hook', async () => {
- const hooks = {
- 'run:before': jest.fn()
- }
-
- await NuxtCommand.run(dev, [], hooks)
-
- expect(hooks['run:before']).toHaveBeenCalledWith({
- argv: [],
- cmd: dev,
- rootDir: path.resolve('.')
- })
- })
-
- test('run:before hook (custom CLI options & rootDir)', async () => {
- const hooks = {
- 'run:before': jest.fn()
- }
-
- await NuxtCommand.run(dev, ['-p', '3001', 'path/to/project'], hooks)
-
- expect(hooks['run:before']).toHaveBeenCalledWith({
- argv: ['-p', '3001', 'path/to/project'],
- cmd: dev,
- rootDir: path.resolve('path/to/project')
- })
- })
-
- test('config hook', async () => {
- const hooks = {
- config: jest.fn()
- }
-
- await NuxtCommand.run(dev, [], hooks)
-
- expect(hooks.config).toHaveBeenCalledWith(expect.objectContaining({
- _cli: true
- }))
- })
-})
diff --git a/packages/cli/test/unit/imports.test.js b/packages/cli/test/unit/imports.test.js
deleted file mode 100644
index c8ead193a045..000000000000
--- a/packages/cli/test/unit/imports.test.js
+++ /dev/null
@@ -1,19 +0,0 @@
-import { importModule } from '../../src/imports'
-
-describe('imports', () => {
- test('should import relative module', async () => {
- await expect(importModule('jest')).resolves.toBeDefined()
- })
- test('should import core module', async () => {
- await expect(importModule('path')).resolves.toBeDefined()
- })
- test('should throw error with proper code when module not found', async () => {
- await expect(importModule('not-found-module')).rejects.toMatchObject({
- message: 'Cannot import module \'not-found-module\'',
- code: 'MODULE_NOT_FOUND'
- })
- })
- test('should throw error when error is not module not found', async () => {
- await expect(importModule('jest/README.md')).rejects.toThrow()
- })
-})
diff --git a/packages/cli/test/unit/list.test.js b/packages/cli/test/unit/list.test.js
deleted file mode 100644
index 64f862324447..000000000000
--- a/packages/cli/test/unit/list.test.js
+++ /dev/null
@@ -1,57 +0,0 @@
-
-import chalk from 'chalk'
-
-import listCommands from '../../src/list'
-import getCommand from '../../src/commands'
-import { indent, foldLines, colorize } from '../../src/utils/formatting'
-
-jest.mock('chalk', () => ({ green: jest.fn(text => text) }))
-jest.mock('../../src/commands')
-jest.mock('../../src/utils/formatting')
-
-describe('list', () => {
- beforeAll(() => {
- const commands = {
- dev: { usage: 'dev', description: 'dev desc' },
- build: { usage: 'build', description: 'build desc' },
- generate: { usage: 'generate', description: 'generate desc' },
- start: { usage: 'start', description: 'start desc' },
- help: { usage: 'help', description: 'help desc' }
- }
- indent.mockReturnValue(' ')
- colorize.mockImplementation(text => text)
- getCommand.mockImplementation(cmd => commands[cmd])
- process.stderr.write = jest.fn()
- })
-
- test('should list all commands', async () => {
- await listCommands()
-
- expect(indent).toBeCalledTimes(5)
- expect(indent).nthCalledWith(1, 7)
- expect(indent).nthCalledWith(2, 5)
- expect(indent).nthCalledWith(3, 2)
- expect(indent).nthCalledWith(4, 5)
- expect(indent).nthCalledWith(5, 6)
-
- expect(chalk.green).toBeCalledTimes(5)
- expect(chalk.green).nthCalledWith(1, 'dev')
- expect(chalk.green).nthCalledWith(2, 'build')
- expect(chalk.green).nthCalledWith(3, 'generate')
- expect(chalk.green).nthCalledWith(4, 'start')
- expect(chalk.green).nthCalledWith(5, 'help')
-
- const spaces = [14, 4]
- expect(foldLines).toBeCalledTimes(7)
- expect(foldLines).nthCalledWith(1, 'dev dev desc', ...spaces)
- expect(foldLines).nthCalledWith(2, 'build build desc', ...spaces)
- expect(foldLines).nthCalledWith(3, 'generate generate desc', ...spaces)
- expect(foldLines).nthCalledWith(4, 'start start desc', ...spaces)
- expect(foldLines).nthCalledWith(5, 'help help desc', ...spaces)
- expect(foldLines).nthCalledWith(6, 'Usage: nuxt <command> [--help|-h]', 2)
- expect(foldLines).nthCalledWith(7, 'Commands:', 2)
-
- expect(colorize).toBeCalledTimes(1)
- expect(process.stderr.write).toBeCalledTimes(1)
- })
-})
diff --git a/packages/cli/test/unit/run-edge.test.js b/packages/cli/test/unit/run-edge.test.js
deleted file mode 100644
index 366f91c746b4..000000000000
--- a/packages/cli/test/unit/run-edge.test.js
+++ /dev/null
@@ -1,12 +0,0 @@
-import run from '../../src/run'
-
-jest.mock('../../package.json', () => ({
- name: '@nuxt/cli-edge'
-}))
-
-describe('run in edge', () => {
- test('throws error if nuxt and nuxt-edge are installed', async () => {
- await expect(run())
- .rejects.toThrow('Both `nuxt` and `nuxt-edge` dependencies are installed! This is unsupported, please choose one and remove the other one from dependencies.')
- })
-})
diff --git a/packages/cli/test/unit/run.test.js b/packages/cli/test/unit/run.test.js
deleted file mode 100644
index 6134085795f8..000000000000
--- a/packages/cli/test/unit/run.test.js
+++ /dev/null
@@ -1,73 +0,0 @@
-import execa from 'execa'
-import run from '../../src/run'
-import getCommand from '../../src/commands'
-import NuxtCommand from '../../src/command'
-
-jest.mock('execa')
-jest.mock('../../src/commands')
-jest.mock('../../src/command')
-
-describe('run', () => {
- beforeEach(() => {
- jest.resetAllMocks()
- getCommand.mockImplementation(cmd => cmd === 'dev' ? ({ name: 'dev', run: jest.fn() }) : undefined)
- })
-
- afterAll(() => {
- jest.clearAllMocks()
- })
-
- test('nuxt aliases to nuxt dev', async () => {
- await run([])
- expect(getCommand).toHaveBeenCalledWith('dev')
- expect(NuxtCommand.run).toHaveBeenCalledWith(expect.anything(), [], {})
- })
-
- test('nuxt --foo aliases to nuxt dev --foo', async () => {
- await run(['--foo'])
- expect(getCommand).toHaveBeenCalledWith('dev')
- expect(NuxtCommand.run).toHaveBeenCalledWith(expect.anything(), ['--foo'], {})
- })
-
- test('all hooks passed to NuxtCommand', async () => {
- const hooks = { foo: jest.fn() }
- await run([], hooks)
-
- expect(NuxtCommand.run).toHaveBeenCalledWith(expect.anything(), [], hooks)
- })
-
- test('nuxt <dir> aliases to nuxt dev <dir>', async () => {
- await run([__dirname])
- expect(getCommand).toHaveBeenCalledWith('dev')
- expect(NuxtCommand.run).toHaveBeenCalledWith(expect.anything(), [__dirname], {})
- })
-
- test('external commands', async () => {
- await run(['custom', 'command', '--args'])
-
- expect(execa).toHaveBeenCalledWith('nuxt-custom', ['command', '--args'], {
- stdout: process.stdout,
- stderr: process.stderr,
- stdin: process.stdin
- })
- })
-
- test('throws error if external command not found', async () => {
- execa.mockImplementationOnce(() => {
- const e = new Error()
- e.exitCode = 2
- e.exitName = 'ENOENT'
- throw e
- })
-
- await expect(run(['custom', 'command', '--args']))
- .rejects.toBe('Command not found: nuxt-custom')
- })
-
- test('throws error if external command failed', async () => {
- execa.mockImplementationOnce(() => { throw new Error('boo') })
-
- await expect(run(['custom', 'command', '--args']))
- .rejects.toBe('Failed to run command `nuxt-custom`:\nError: boo')
- })
-})
diff --git a/packages/cli/test/unit/start.test.js b/packages/cli/test/unit/start.test.js
deleted file mode 100644
index 3a30702f7dc6..000000000000
--- a/packages/cli/test/unit/start.test.js
+++ /dev/null
@@ -1,65 +0,0 @@
-import fs from 'fs-extra'
-import * as utils from '../../src/utils/'
-import { consola, mockGetNuxtStart, mockGetNuxtConfig, NuxtCommand } from '../utils'
-
-describe('start', () => {
- let start
-
- beforeAll(async () => {
- start = await import('../../src/commands/start').then(m => m.default)
- jest.spyOn(utils, 'forceExit').mockImplementation(() => {})
- })
-
- afterEach(() => {
- if (fs.existsSync.mockRestore) {
- fs.existsSync.mockRestore()
- }
- jest.resetAllMocks()
- })
-
- test('has run function', () => {
- expect(typeof start.run).toBe('function')
- })
-
- test('no error if dist dir exists', async () => {
- mockGetNuxtStart()
- mockGetNuxtConfig()
- await NuxtCommand.from(start).run()
- expect(consola.fatal).not.toHaveBeenCalled()
- })
-
- test('no error on ssr and server bundle exists', async () => {
- mockGetNuxtStart(true)
- mockGetNuxtConfig()
- await NuxtCommand.from(start).run()
- expect(consola.fatal).not.toHaveBeenCalled()
- })
-
- test('start doesnt force-exit by default', async () => {
- mockGetNuxtStart()
-
- const cmd = NuxtCommand.from(start, ['start', '.'])
- await cmd.run()
-
- expect(utils.forceExit).not.toHaveBeenCalled()
- })
-
- test('start can set force exit explicitly', async () => {
- mockGetNuxtStart()
-
- const cmd = NuxtCommand.from(start, ['start', '.', '--force-exit'])
- await cmd.run()
-
- expect(utils.forceExit).toHaveBeenCalledTimes(1)
- expect(utils.forceExit).toHaveBeenCalledWith('start', false)
- })
-
- test('start can disable force exit explicitly', async () => {
- mockGetNuxtStart()
-
- const cmd = NuxtCommand.from(start, ['start', '.', '--no-force-exit'])
- await cmd.run()
-
- expect(utils.forceExit).not.toHaveBeenCalled()
- })
-})
diff --git a/packages/cli/test/unit/utils-minimalcli.test.js b/packages/cli/test/unit/utils-minimalcli.test.js
deleted file mode 100644
index 42427da11ea4..000000000000
--- a/packages/cli/test/unit/utils-minimalcli.test.js
+++ /dev/null
@@ -1,33 +0,0 @@
-import { consola } from '../utils'
-import { showBanner } from '../../src/utils/banner'
-
-jest.mock('std-env', () => ({
- test: false,
- minimalCLI: true
-}))
-
-describe('cli/utils', () => {
- afterEach(() => jest.resetAllMocks())
-
- test('showBanner prints only listeners', () => {
- const listeners = [
- { url: 'first' },
- { url: 'second' }
- ]
-
- showBanner({
- options: {
- cli: {
- bannerColor: 'green'
- }
- },
- server: {
- listeners
- }
- })
-
- expect(consola.info).toHaveBeenCalledTimes(2)
- expect(consola.info).toHaveBeenCalledWith(`Listening on: ${listeners[0].url}`)
- expect(consola.info).toHaveBeenCalledWith(`Listening on: ${listeners[1].url}`)
- })
-})
diff --git a/packages/cli/test/unit/utils.test.js b/packages/cli/test/unit/utils.test.js
deleted file mode 100644
index aedb99dd0857..000000000000
--- a/packages/cli/test/unit/utils.test.js
+++ /dev/null
@@ -1,233 +0,0 @@
-import { getDefaultNuxtConfig } from '@nuxt/config'
-import { consola } from '../utils'
-import { loadNuxtConfig } from '../../src/utils/config'
-import * as utils from '../../src/utils'
-import { showBanner } from '../../src/utils/banner'
-import { showMemoryUsage } from '../../src/utils/memory'
-import * as fmt from '../../src/utils/formatting'
-
-jest.mock('std-env', () => ({
- test: false,
- minimalCLI: false
-}))
-jest.mock('boxen', () => text => `[boxen] ${text}`)
-
-describe('cli/utils', () => {
- afterEach(() => jest.resetAllMocks())
-
- test('loadNuxtConfig: defaults', async () => {
- const argv = {
- _: ['.'],
- 'config-file': 'nuxt.config.js',
- universal: true
- }
-
- const options = await loadNuxtConfig(argv)
- expect(options.rootDir).toBe(process.cwd())
- expect(options.mode).toBe('universal')
- expect(options.server.host).toBe('localhost')
- expect(options.server.port).toBe(3000)
- expect(options.server.socket).not.toBeDefined()
- })
-
- test('loadNuxtConfig: config-file', async () => {
- const argv = {
- _: [__dirname],
- 'config-file': '../fixtures/nuxt.config.js',
- spa: true
- }
-
- const options = await loadNuxtConfig(argv)
- expect(options.testOption).toBe(true)
- expect(options.rootDir).toBe('/some/path')
- expect(options.mode).toBe('spa')
- expect(options.server.host).toBe('nuxt-host')
- expect(options.server.port).toBe(3001)
- expect(options.server.socket).toBe('/var/run/nuxt.sock')
- })
-
- test('loadNuxtConfig: not-existing config-file', async () => {
- const argv = {
- _: [__dirname],
- 'config-file': '../fixtures/nuxt.doesnt-exist.js'
- }
-
- const options = await loadNuxtConfig(argv)
- expect(options.testOption).not.toBeDefined()
-
- expect(consola.fatal).toHaveBeenCalledTimes(1)
- expect(consola.fatal).toHaveBeenCalledWith(expect.stringMatching(/Config file not found/))
- })
-
- test('loadNuxtConfig: async config-file', async () => {
- const argv = {
- _: [__dirname],
- 'config-file': '../fixtures/nuxt.async-config.js',
- hostname: 'async-host',
- port: 3002,
- 'unix-socket': '/var/run/async.sock'
- }
-
- const options = await loadNuxtConfig(argv)
- expect(options.testOption).toBe(true)
- expect(options.mode).toBe('supercharged')
- expect(options.server.host).toBe('async-host')
- expect(options.server.port).toBe(3002)
- expect(options.server.socket).toBe('/var/run/async.sock')
- })
-
- test('loadNuxtConfig: passes context to config fn', async () => {
- const argv = {
- _: [__dirname],
- 'config-file': '../fixtures/nuxt.fn-config.js'
- }
-
- const context = { command: 'test', dev: true }
- const options = await loadNuxtConfig(argv, context)
- expect(options.context.command).toBe('test')
- expect(options.context.dev).toBe(true)
- })
-
- test('loadNuxtConfig: async config-file with error', async () => {
- const argv = {
- _: [__dirname],
- 'config-file': '../fixtures/nuxt.async-error.js'
- }
-
- const options = await loadNuxtConfig(argv)
- expect(options.testOption).not.toBeDefined()
-
- expect(consola.error).toHaveBeenCalledTimes(1)
- expect(consola.error).toHaveBeenCalledWith(new Error('Async Config Error'))
- expect(consola.fatal).toHaveBeenCalledWith('Error while fetching async configuration')
- })
-
- test('normalizeArg: normalize string argument in command', () => {
- expect(utils.normalizeArg('true')).toBe(true)
- expect(utils.normalizeArg('false')).toBe(false)
- expect(utils.normalizeArg(true)).toBe(true)
- expect(utils.normalizeArg(false)).toBe(false)
- expect(utils.normalizeArg('')).toBe(true)
- expect(utils.normalizeArg(undefined, 'default')).toBe('default')
- expect(utils.normalizeArg('text')).toBe('text')
- })
-
- test('nuxtServerConfig: server env', () => {
- const options = getDefaultNuxtConfig({
- env: {
- ...process.env,
- HOST: 'env-host',
- PORT: 3003,
- UNIX_SOCKET: '/var/run/env.sock'
- }
- })
-
- expect(options.server.host).toBe('env-host')
- expect(options.server.port).toBe(3003)
- expect(options.server.socket).toBe('/var/run/env.sock')
- })
-
- test('indent', () => {
- expect(fmt.indent(4)).toBe(' ')
- })
-
- test('indent custom char', () => {
- expect(fmt.indent(4, '-')).toBe('----')
- })
-
- test('showBanner prints full-info box with memory usage', () => {
- const stdout = jest.spyOn(process.stdout, 'write').mockImplementation(() => {})
- const successBox = jest.fn().mockImplementation((m, t) => t + m)
- jest.spyOn(fmt, 'successBox').mockImplementation(successBox)
-
- const badgeMessages = ['badgeMessage']
- const bannerColor = 'green'
- const listeners = [
- { url: 'first' },
- { url: 'second' }
- ]
-
- showBanner({
- options: {
- cli: {
- badgeMessages,
- bannerColor
- }
- },
- server: {
- listeners
- }
- })
-
- expect(successBox).toHaveBeenCalledTimes(1)
- expect(stdout).toHaveBeenCalledTimes(1)
- expect(stdout).toHaveBeenCalledWith(expect.stringMatching('Nuxt.js'))
- expect(stdout).toHaveBeenCalledWith(expect.stringMatching(`Listening on: ${listeners[0].url}`))
- expect(stdout).toHaveBeenCalledWith(expect.stringMatching(`Listening on: ${listeners[1].url}`))
- expect(stdout).toHaveBeenCalledWith(expect.stringMatching('Memory usage'))
- expect(stdout).toHaveBeenCalledWith(expect.stringMatching('badgeMessage'))
- stdout.mockRestore()
- })
-
- test('showBanner doesnt print memory usage', () => {
- const stdout = jest.spyOn(process.stdout, 'write').mockImplementation(() => {})
- const successBox = jest.fn().mockImplementation((m, t) => t + m)
- jest.spyOn(fmt, 'successBox').mockImplementation(successBox)
-
- showBanner({
- options: {
- cli: {
- badgeMessages: [],
- bannerColor: 'green'
- }
- },
- server: {
- listeners: []
- }
- }, false)
-
- expect(successBox).toHaveBeenCalledTimes(1)
- expect(stdout).toHaveBeenCalledTimes(1)
- expect(stdout).toHaveBeenCalledWith(expect.stringMatching('Nuxt.js'))
- expect(stdout).not.toHaveBeenCalledWith(expect.stringMatching('Memory usage'))
- stdout.mockRestore()
- })
-
- test('showMemoryUsage prints memory usage', () => {
- showMemoryUsage()
-
- expect(consola.info).toHaveBeenCalledTimes(1)
- expect(consola.info).toHaveBeenCalledWith(expect.stringMatching('Memory usage'))
- })
-
- test('forceExit exits after timeout', () => {
- jest.useFakeTimers()
- const exit = jest.spyOn(process, 'exit').mockImplementation(() => {})
- const stderr = jest.spyOn(process.stderr, 'write').mockImplementation(() => {})
-
- utils.forceExit('test', 1)
- expect(exit).not.toHaveBeenCalled()
- jest.runAllTimers()
-
- expect(stderr).toHaveBeenCalledWith(expect.stringMatching('Nuxt.js will now force exit'))
- expect(exit).toHaveBeenCalledTimes(1)
-
- stderr.mockRestore()
- exit.mockRestore()
- jest.useRealTimers()
- })
-
- test('forceExit exits immediately without timeout', () => {
- jest.useFakeTimers()
- const exit = jest.spyOn(process, 'exit').mockImplementation(() => {})
- const stderr = jest.spyOn(process.stderr, 'write').mockImplementation(() => {})
-
- utils.forceExit('test', false)
- expect(stderr).not.toHaveBeenCalledWith()
- expect(exit).toHaveBeenCalledTimes(1)
-
- stderr.mockRestore()
- exit.mockRestore()
- jest.useRealTimers()
- })
-})
diff --git a/packages/cli/test/unit/webpack.test.js b/packages/cli/test/unit/webpack.test.js
deleted file mode 100644
index daf43dd5135f..000000000000
--- a/packages/cli/test/unit/webpack.test.js
+++ /dev/null
@@ -1,50 +0,0 @@
-import path from 'path'
-import util from 'util'
-import consola from 'consola'
-import prettyFormat from 'pretty-format'
-import { NuxtCommand, getWebpackConfig } from '../..'
-import webpackCommand from '../../src/commands/webpack'
-
-const replaceAll = (str, a, b) => str.split(a).join(b)
-const nuxtDir = path.join(__dirname, '../../../..')
-const maskDir = str => replaceAll(str, nuxtDir, '<nuxtDir>')
-
-const tests = [
- 'devtool',
- 'resolve alias',
- 'module.rules',
- 'module.rules test=.jsx',
- 'module.rules loader=vue-',
- 'module.rules loader=.*-loader',
- 'nuxt webpack module rules test=.pug oneOf use.0=raw'
-]
-
-describe('webpack', () => {
- beforeAll(() => {
- process.stdout.isTTY = false
- util.formatWithOptions = (opts, obj) => prettyFormat(obj)
- })
-
- afterEach(() => {
- jest.resetAllMocks()
- })
-
- test.posix('getWebpackConfig()', async () => {
- const webpackConfig = await getWebpackConfig('Client')
- expect(maskDir(prettyFormat(webpackConfig.module.rules[0]))).toMatchSnapshot()
- })
-
- test.posix('nuxt webpack no match', async () => {
- const cmd = NuxtCommand.from(webpackCommand, ['module.rules', 'loader=foobar'])
- await cmd.run()
- expect(maskDir(consola.warn.mock.calls[0][0])).toBe('No match in webpack config for `loader=foobar`')
- })
-
- for (const testCase of tests) {
- test.posix('nuxt webpack ' + testCase, async () => {
- const cmd = NuxtCommand.from(webpackCommand, testCase.split(' '))
- await cmd.run()
- expect(maskDir(consola.log.mock.calls[0][0])).toMatchSnapshot()
- })
- }
-})
diff --git a/packages/cli/test/utils/index.js b/packages/cli/test/utils/index.js
deleted file mode 100644
index f0ebe40a9b81..000000000000
--- a/packages/cli/test/utils/index.js
+++ /dev/null
@@ -1,9 +0,0 @@
-import consola from 'consola'
-export * from './mocking'
-export { NuxtCommand } from '../../src'
-
-consola.mockTypes(() => jest.fn())
-
-export {
- consola
-}
diff --git a/packages/cli/test/utils/mocking.js b/packages/cli/test/utils/mocking.js
deleted file mode 100644
index 045a4e6e654d..000000000000
--- a/packages/cli/test/utils/mocking.js
+++ /dev/null
@@ -1,113 +0,0 @@
-import * as imports from '../../src/imports'
-import Command from '../../src/command'
-
-jest.mock('../../src/imports', () => {
- return {
- core: jest.fn().mockImplementation(() => ({
- Nuxt () {}
- })),
- builder: jest.fn().mockImplementation(() => ({
- Builder () {}
- })),
- generator: jest.fn().mockImplementation(() => ({
- Generator () {}
- })),
- webpack: jest.fn().mockImplementation(() => ({
- BundleBuilder () {}
- }))
- }
-})
-
-export const mockGetNuxt = (options = {}, implementation) => {
- Command.prototype.getNuxt = jest.fn().mockImplementationOnce(() => {
- return Object.assign({
- hook: jest.fn(),
- options
- }, implementation)
- })
-}
-
-export const mockGetBuilder = (ret) => {
- const build = jest.fn().mockImplementationOnce(() => ret)
-
- Command.prototype.getBuilder = jest.fn().mockImplementationOnce(() => ({ build }))
-
- return build
-}
-
-export const mockGetGenerator = (ret) => {
- const generate = jest.fn()
- if (ret) {
- generate.mockImplementationOnce(ret)
- } else {
- generate.mockImplementationOnce(() => ({ errors: [] }))
- }
-
- Command.prototype.getGenerator = jest.fn().mockImplementationOnce(() => ({ generate }))
-
- return generate
-}
-
-export const mockGetNuxtStart = (ssr) => {
- const listen = jest.fn().mockImplementationOnce(() => {
- return Promise.resolve()
- })
-
- mockGetNuxt({
- rootDir: '.',
- render: {
- ssr
- }
- }, {
- server: {
- listen,
- listeners: []
- }
- })
-
- return { listen }
-}
-
-export const mockGetNuxtConfig = () => {
- const spy = jest.fn()
- Command.prototype.getNuxtConfig = spy
- return spy
-}
-
-export const mockNuxt = (implementation) => {
- const Nuxt = function () {}
- Object.assign(Nuxt.prototype, {
- hook (type, fn) {
- if (type === 'watch:restart') {
- Nuxt.fileRestartHook = fn
- }
- },
- options: {},
- callHook: jest.fn(),
- clearHook: jest.fn(),
- clearHooks: jest.fn(),
- close: jest.fn(),
- ready: jest.fn(),
- server: {
- listeners: [],
- listen: jest.fn().mockImplementationOnce(() => Promise.resolve())
- }
- }, implementation || {})
-
- imports.core.mockImplementation(() => ({ Nuxt }))
-
- return Nuxt
-}
-
-export const mockBuilder = (implementation) => {
- const Builder = function () {}
- Object.assign(Builder.prototype, {
- build: jest.fn().mockImplementationOnce(() => Promise.resolve()),
- unwatch: jest.fn().mockImplementationOnce(() => Promise.resolve()),
- watchRestart: jest.fn().mockImplementationOnce(() => Promise.resolve())
- }, implementation || {})
-
- imports.builder.mockImplementation(() => ({ Builder }))
-
- return Builder
-}
diff --git a/packages/config/index.d.ts b/packages/config/index.d.ts
deleted file mode 100644
index c8a4f6a3cbd8..000000000000
--- a/packages/config/index.d.ts
+++ /dev/null
@@ -1,3 +0,0 @@
-// Dummy type definition file to provide backward compatibility
-// around Nuxt modules extending `@nuxt/config` for Nuxt < 2.9
-declare module "@nuxt/config"
diff --git a/packages/config/package.js b/packages/config/package.js
deleted file mode 100644
index 19d0ef6e2d14..000000000000
--- a/packages/config/package.js
+++ /dev/null
@@ -1,3 +0,0 @@
-export default {
- build: true
-}
diff --git a/packages/config/package.json b/packages/config/package.json
deleted file mode 100644
index bc7b691f6920..000000000000
--- a/packages/config/package.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
- "name": "@nuxt/config",
- "version": "2.12.1",
- "repository": "nuxt/nuxt.js",
- "license": "MIT",
- "main": "dist/config.js",
- "typings": "index.d.ts",
- "files": [
- "dist",
- "index.d.ts"
- ],
- "dependencies": {
- "@nuxt/utils": "2.12.1",
- "consola": "^2.11.3",
- "defu": "^2.0.2",
- "esm": "^3.2.25",
- "std-env": "^2.2.1"
- },
- "publishConfig": {
- "access": "public"
- }
-}
diff --git a/packages/config/src/config/_app.js b/packages/config/src/config/_app.js
deleted file mode 100644
index 8db8e1f9aded..000000000000
--- a/packages/config/src/config/_app.js
+++ /dev/null
@@ -1,79 +0,0 @@
-export default () => ({
- vue: {
- config: {
- silent: undefined, // = !dev
- performance: undefined // = dev
- }
- },
-
- vueMeta: null,
-
- head: {
- meta: [],
- link: [],
- style: [],
- script: []
- },
-
- fetch: {
- server: true,
- client: true
- },
-
- plugins: [],
-
- extendPlugins: null,
-
- css: [],
-
- modules: [],
- buildModules: [],
-
- layouts: {},
-
- ErrorPage: null,
-
- loading: {
- color: 'black',
- failedColor: 'red',
- height: '2px',
- throttle: 200,
- duration: 5000,
- continuous: false,
- rtl: false,
- css: true
- },
-
- loadingIndicator: 'default',
-
- pageTransition: {
- name: 'page',
- mode: 'out-in',
- appear: false,
- appearClass: 'appear',
- appearActiveClass: 'appear-active',
- appearToClass: 'appear-to'
- },
-
- layoutTransition: {
- name: 'layout',
- mode: 'out-in'
- },
-
- features: {
- store: true,
- layouts: true,
- meta: true,
- middleware: true,
- transitions: true,
- deprecations: true,
- validate: true,
- asyncData: true,
- fetch: true,
- clientOnline: true,
- clientPrefetch: true,
- clientUseUrl: false,
- componentAliases: true,
- componentClientOnly: true
- }
-})
diff --git a/packages/config/src/config/_common.js b/packages/config/src/config/_common.js
deleted file mode 100644
index a724bbe86778..000000000000
--- a/packages/config/src/config/_common.js
+++ /dev/null
@@ -1,84 +0,0 @@
-import capitalize from 'lodash/capitalize'
-import env from 'std-env'
-
-export default () => ({
- // Env
- dev: Boolean(env.dev),
- test: Boolean(env.test),
- debug: undefined, // = dev
- env: {},
-
- // Mode
- mode: 'universal',
- modern: undefined,
-
- globalName: undefined,
- globals: {
- id: globalName => `__${globalName}`,
- nuxt: globalName => `$${globalName}`,
- context: globalName => `__${globalName.toUpperCase()}__`,
- pluginPrefix: globalName => globalName,
- readyCallback: globalName => `on${capitalize(globalName)}Ready`,
- loadedCallback: globalName => `_on${capitalize(globalName)}Loaded`
- },
-
- // Server
- serverMiddleware: [],
-
- // Dirs and extensions
- _nuxtConfigFile: undefined,
- srcDir: undefined,
- buildDir: '.nuxt',
- modulesDir: [
- 'node_modules'
- ],
- dir: {
- assets: 'assets',
- app: 'app',
- layouts: 'layouts',
- middleware: 'middleware',
- pages: 'pages',
- static: 'static',
- store: 'store'
- },
- extensions: [],
- styleExtensions: ['css', 'pcss', 'postcss', 'styl', 'stylus', 'scss', 'sass', 'less'],
- alias: {},
-
- // Ignores
- ignoreOptions: undefined,
- ignorePrefix: '-',
- ignore: [
- '**/*.test.*',
- '**/*.spec.*'
- ],
-
- // Generate
- generate: {
- dir: 'dist',
- routes: [],
- exclude: [],
- concurrency: 500,
- interval: 0,
- subFolders: true,
- fallback: '200.html'
- },
-
- // Watch
- watch: [],
- watchers: {
- rewatchOnRawEvents: undefined,
- webpack: {
- aggregateTimeout: 1000
- },
- chokidar: {
- ignoreInitial: true
- }
- },
-
- // Editor
- editor: undefined,
-
- // Hooks
- hooks: null
-})
diff --git a/packages/config/src/config/build.js b/packages/config/src/config/build.js
deleted file mode 100644
index ae72a82e8a9a..000000000000
--- a/packages/config/src/config/build.js
+++ /dev/null
@@ -1,127 +0,0 @@
-import env from 'std-env'
-
-export default () => ({
- quiet: Boolean(env.ci || env.test),
- analyze: false,
- profile: process.argv.includes('--profile'),
- extractCSS: false,
- cssSourceMap: undefined,
- ssr: undefined,
- parallel: false,
- cache: false,
- standalone: false,
- publicPath: '/_nuxt/',
- serverURLPolyfill: 'url',
- filenames: {
- // { isDev, isClient, isServer }
- app: ({ isDev, isModern }) => isDev ? `${isModern ? 'modern-' : ''}[name].js` : '[contenthash].js',
- chunk: ({ isDev, isModern }) => isDev ? `${isModern ? 'modern-' : ''}[name].js` : '[contenthash].js',
- css: ({ isDev }) => isDev ? '[name].css' : '[contenthash].css',
- img: ({ isDev }) => isDev ? '[path][name].[ext]' : 'img/[contenthash:7].[ext]',
- font: ({ isDev }) => isDev ? '[path][name].[ext]' : 'fonts/[contenthash:7].[ext]',
- video: ({ isDev }) => isDev ? '[path][name].[ext]' : 'videos/[contenthash:7].[ext]'
- },
- loaders: {
- file: {},
- fontUrl: { limit: 1000 },
- imgUrl: { limit: 1000 },
- pugPlain: {},
- vue: {
- transformAssetUrls: {
- video: 'src',
- source: 'src',
- object: 'src',
- embed: 'src'
- }
- },
- css: {},
- cssModules: {
- modules: {
- localIdentName: '[local]_[hash:base64:5]'
- }
- },
- less: {},
- sass: {
- sassOptions: {
- indentedSyntax: true
- }
- },
- scss: {},
- stylus: {},
- vueStyle: {}
- },
- styleResources: {},
- plugins: [],
- terser: {},
- hardSource: false,
- aggressiveCodeRemoval: false,
- optimizeCSS: undefined,
- optimization: {
- runtimeChunk: 'single',
- minimize: undefined,
- minimizer: undefined,
- splitChunks: {
- chunks: 'all',
- automaticNameDelimiter: '.',
- name: undefined,
- cacheGroups: {}
- }
- },
- splitChunks: {
- layouts: false,
- pages: true,
- commons: true
- },
- babel: {
- configFile: false,
- babelrc: false,
- cacheDirectory: undefined
- },
- transpile: [], // Name of NPM packages to be transpiled
- postcss: {
- preset: {
- // https://cssdb.org/#staging-process
- stage: 2
- }
- },
- html: {
- minify: {
- collapseBooleanAttributes: true,
- decodeEntities: true,
- minifyCSS: true,
- minifyJS: true,
- processConditionalComments: true,
- removeEmptyAttributes: true,
- removeRedundantAttributes: true,
- trimCustomFragments: true,
- useShortDoctype: true
- }
- },
-
- template: undefined,
- templates: [],
-
- watch: [],
- devMiddleware: {},
- hotMiddleware: {},
-
- stats: {
- excludeAssets: [
- /.map$/,
- /index\..+\.html$/,
- /vue-ssr-(client|modern)-manifest.json/
- ]
- },
- friendlyErrors: true,
- additionalExtensions: [],
- warningIgnoreFilters: [],
-
- followSymlinks: false,
-
- loadingScreen: {},
- indicator: {
- position: 'bottom-right',
- backgroundColor: '#2E495E',
- color: '#00C48D'
- }
-})
diff --git a/packages/config/src/config/cli.js b/packages/config/src/config/cli.js
deleted file mode 100644
index 88f6404b2490..000000000000
--- a/packages/config/src/config/cli.js
+++ /dev/null
@@ -1,4 +0,0 @@
-export default () => ({
- badgeMessages: [],
- bannerColor: 'green'
-})
diff --git a/packages/config/src/config/index.js b/packages/config/src/config/index.js
deleted file mode 100644
index fe94688b65a8..000000000000
--- a/packages/config/src/config/index.js
+++ /dev/null
@@ -1,31 +0,0 @@
-
-import _app from './_app'
-import _common from './_common'
-
-import build from './build'
-import messages from './messages'
-import modes from './modes'
-import render from './render'
-import router from './router'
-import server from './server'
-import cli from './cli'
-
-export const defaultNuxtConfigFile = 'nuxt.config'
-
-export function getDefaultNuxtConfig (options = {}) {
- if (!options.env) {
- options.env = process.env
- }
-
- return {
- ..._app(),
- ..._common(),
- build: build(),
- messages: messages(),
- modes: modes(),
- render: render(),
- router: router(),
- server: server(options),
- cli: cli()
- }
-}
diff --git a/packages/config/src/config/messages.js b/packages/config/src/config/messages.js
deleted file mode 100644
index 0c3694c2b580..000000000000
--- a/packages/config/src/config/messages.js
+++ /dev/null
@@ -1,12 +0,0 @@
-export default () => ({
- loading: 'Loading...',
- error_404: 'This page could not be found',
- server_error: 'Server error',
- nuxtjs: 'Nuxt.js',
- back_to_home: 'Back to the home page',
- server_error_details:
- 'An error occurred in the application and your page could not be served. If you are the application owner, check your logs for details.',
- client_error: 'Error',
- client_error_details:
- 'An error occurred while rendering the page. Check developer tools console for details.'
-})
diff --git a/packages/config/src/config/modes.js b/packages/config/src/config/modes.js
deleted file mode 100644
index b73a08fa626e..000000000000
--- a/packages/config/src/config/modes.js
+++ /dev/null
@@ -1,18 +0,0 @@
-export default () => ({
- universal: {
- build: {
- ssr: true
- },
- render: {
- ssr: true
- }
- },
- spa: {
- build: {
- ssr: false
- },
- render: {
- ssr: false
- }
- }
-})
diff --git a/packages/config/src/config/render.js b/packages/config/src/config/render.js
deleted file mode 100644
index f478922cbf8e..000000000000
--- a/packages/config/src/config/render.js
+++ /dev/null
@@ -1,45 +0,0 @@
-// TODO: Refactor @nuxt/server related options into `server.js`
-
-export default () => ({
- bundleRenderer: {
- shouldPrefetch: () => false,
- shouldPreload: (fileWithoutQuery, asType) => ['script', 'style'].includes(asType),
- runInNewContext: undefined
- },
- crossorigin: undefined,
- resourceHints: true,
- ssr: undefined,
- ssrLog: undefined,
- http2: {
- push: false,
- shouldPush: null,
- pushAssets: null
- },
- static: {
- prefix: true
- },
- compressor: {
- threshold: 0
- },
- etag: {
- weak: false
- },
- csp: false,
- dist: {
- // Don't serve index.html template
- index: false,
- // 1 year in production
- maxAge: '1y'
- },
- // https://github.com/nuxt/serve-placeholder
- fallback: {
- dist: {},
- static: {
- skipUnknown: true,
- handlers: {
- '.htm': false,
- '.html': false
- }
- }
- }
-})
diff --git a/packages/config/src/config/router.js b/packages/config/src/config/router.js
deleted file mode 100644
index 878920675563..000000000000
--- a/packages/config/src/config/router.js
+++ /dev/null
@@ -1,17 +0,0 @@
-export default () => ({
- mode: 'history',
- base: '/',
- routes: [],
- routeNameSplitter: '-',
- middleware: [],
- linkActiveClass: 'nuxt-link-active',
- linkExactActiveClass: 'nuxt-link-exact-active',
- linkPrefetchedClass: false,
- extendRoutes: null,
- scrollBehavior: null,
- parseQuery: false,
- stringifyQuery: false,
- fallback: false,
- prefetchLinks: true,
- trailingSlash: undefined
-})
diff --git a/packages/config/src/config/server.js b/packages/config/src/config/server.js
deleted file mode 100644
index 8d45fee77f26..000000000000
--- a/packages/config/src/config/server.js
+++ /dev/null
@@ -1,14 +0,0 @@
-export default ({ env = {} } = {}) => ({
- https: false,
- port: env.NUXT_PORT ||
- env.PORT ||
- env.npm_package_config_nuxt_port ||
- 3000,
- host: env.NUXT_HOST ||
- env.HOST ||
- env.npm_package_config_nuxt_host ||
- 'localhost',
- socket: env.UNIX_SOCKET ||
- env.npm_package_config_unix_socket,
- timing: false
-})
diff --git a/packages/config/src/index.js b/packages/config/src/index.js
deleted file mode 100644
index ecb6359c3eb5..000000000000
--- a/packages/config/src/index.js
+++ /dev/null
@@ -1,3 +0,0 @@
-export { defaultNuxtConfigFile, getDefaultNuxtConfig } from './config'
-export { getNuxtConfig } from './options'
-export { loadNuxtConfig } from './load'
diff --git a/packages/config/src/load.js b/packages/config/src/load.js
deleted file mode 100644
index 6d013c3a917e..000000000000
--- a/packages/config/src/load.js
+++ /dev/null
@@ -1,70 +0,0 @@
-import path from 'path'
-import defu from 'defu'
-import consola from 'consola'
-import { clearRequireCache, scanRequireTree } from '@nuxt/utils'
-import esm from 'esm'
-import { defaultNuxtConfigFile } from './config'
-
-export async function loadNuxtConfig ({
- rootDir = '.',
- configFile = defaultNuxtConfigFile,
- configContext = {},
- configOverrides = {}
-} = {}) {
- rootDir = path.resolve(rootDir)
-
- let options = {}
-
- try {
- configFile = require.resolve(path.resolve(rootDir, configFile))
- } catch (e) {
- if (e.code !== 'MODULE_NOT_FOUND') {
- throw (e)
- } else if (configFile !== defaultNuxtConfigFile) {
- consola.fatal('Config file not found: ' + configFile)
- }
- // Skip configFile if cannot resolve
- configFile = undefined
- }
-
- if (configFile) {
- // Clear cache
- clearRequireCache(configFile)
-
- options = esm(module)(configFile) || {}
-
- if (options.default) {
- options = options.default
- }
-
- if (typeof options === 'function') {
- try {
- options = await options(configContext)
- if (options.default) {
- options = options.default
- }
- } catch (error) {
- consola.error(error)
- consola.fatal('Error while fetching async configuration')
- }
- }
-
- // Don't mutate options export
- options = defu(configOverrides, options)
-
- // Keep _nuxtConfigFile for watching
- options._nuxtConfigFile = configFile
-
- // Keep all related files for watching
- options._nuxtConfigFiles = Array.from(scanRequireTree(configFile))
- if (!options._nuxtConfigFiles.includes(configFile)) {
- options._nuxtConfigFiles.unshift(configFile)
- }
- }
-
- if (typeof options.rootDir !== 'string') {
- options.rootDir = rootDir
- }
-
- return options
-}
diff --git a/packages/config/src/options.js b/packages/config/src/options.js
deleted file mode 100644
index b21b0d8070ff..000000000000
--- a/packages/config/src/options.js
+++ /dev/null
@@ -1,440 +0,0 @@
-import path from 'path'
-import fs from 'fs'
-import defaultsDeep from 'lodash/defaultsDeep'
-import defu from 'defu'
-import pick from 'lodash/pick'
-import uniq from 'lodash/uniq'
-import consola from 'consola'
-import { guardDir, isNonEmptyString, isPureObject, isUrl, getMainModule } from '@nuxt/utils'
-import { defaultNuxtConfigFile, getDefaultNuxtConfig } from './config'
-
-export function getNuxtConfig (_options) {
- // Prevent duplicate calls
- if (_options.__normalized__) {
- return _options
- }
-
- // Clone options to prevent unwanted side-effects
- const options = Object.assign({}, _options)
- options.__normalized__ = true
-
- // Normalize options
- if (options.loading === true) {
- delete options.loading
- }
-
- if (
- options.router &&
- options.router.middleware &&
- !Array.isArray(options.router.middleware)
- ) {
- options.router.middleware = [options.router.middleware]
- }
-
- if (options.router && typeof options.router.base === 'string') {
- options._routerBaseSpecified = true
- }
-
- // TODO: Remove for Nuxt 3
- // router.scrollBehavior -> app/router.scrollBehavior.js
- if (options.router && typeof options.router.scrollBehavior !== 'undefined') {
- consola.warn('`router.scrollBehavior` property is deprecated in favor of using `~/app/router.scrollBehavior.js` file, learn more: https://nuxtjs.org/api/configuration-router#scrollbehavior')
- }
-
- // TODO: Remove for Nuxt 3
- // transition -> pageTransition
- if (typeof options.transition !== 'undefined') {
- consola.warn('`transition` property is deprecated in favor of `pageTransition` and will be removed in Nuxt 3')
- options.pageTransition = options.transition
- delete options.transition
- }
-
- if (typeof options.pageTransition === 'string') {
- options.pageTransition = { name: options.pageTransition }
- }
-
- if (typeof options.layoutTransition === 'string') {
- options.layoutTransition = { name: options.layoutTransition }
- }
-
- if (typeof options.extensions === 'string') {
- options.extensions = [options.extensions]
- }
-
- options.globalName = (isNonEmptyString(options.globalName) && /^[a-zA-Z]+$/.test(options.globalName))
- ? options.globalName.toLowerCase()
- // use `` for preventing replacing to nuxt-edge
- : `nuxt`
-
- // Resolve rootDir
- options.rootDir = isNonEmptyString(options.rootDir) ? path.resolve(options.rootDir) : process.cwd()
-
- // Apply defaults by ${buildDir}/dist/build.config.js
- // TODO: Unsafe operation.
- // const buildDir = options.buildDir || defaults.buildDir
- // const buildConfig = resolve(options.rootDir, buildDir, 'build.config.js')
- // if (existsSync(buildConfig)) {
- // defaultsDeep(options, require(buildConfig))
- // }
-
- // Apply defaults
- const nuxtConfig = getDefaultNuxtConfig()
-
- nuxtConfig.build._publicPath = nuxtConfig.build.publicPath
-
- // Fall back to default if publicPath is falsy
- if (options.build && !options.build.publicPath) {
- options.build.publicPath = undefined
- }
-
- defaultsDeep(options, nuxtConfig)
-
- // Sanitize router.base
- if (!/\/$/.test(options.router.base)) {
- options.router.base += '/'
- }
-
- // Check srcDir and generate.dir existence
- const hasSrcDir = isNonEmptyString(options.srcDir)
- const hasGenerateDir = isNonEmptyString(options.generate.dir)
-
- // Resolve srcDir
- options.srcDir = hasSrcDir
- ? path.resolve(options.rootDir, options.srcDir)
- : options.rootDir
-
- // Resolve buildDir
- options.buildDir = path.resolve(options.rootDir, options.buildDir)
-
- // Aliases
- const { rootDir, srcDir, dir: { assets: assetsDir, static: staticDir } } = options
- options.alias = {
- '~~': rootDir,
- '@@': rootDir,
- '~': srcDir,
- '@': srcDir,
- [assetsDir]: path.join(srcDir, assetsDir),
- [staticDir]: path.join(srcDir, staticDir),
- ...options.alias
- }
-
- // Default value for _nuxtConfigFile
- if (!options._nuxtConfigFile) {
- options._nuxtConfigFile = path.resolve(options.rootDir, `${defaultNuxtConfigFile}.js`)
- }
-
- if (!options._nuxtConfigFiles) {
- options._nuxtConfigFiles = [
- options._nuxtConfigFile
- ]
- }
-
- // Watch for config file changes
- options.watch.push(...options._nuxtConfigFiles)
-
- // Protect rootDir against buildDir
- guardDir(options, 'rootDir', 'buildDir')
-
- if (hasGenerateDir) {
- // Resolve generate.dir
- options.generate.dir = path.resolve(options.rootDir, options.generate.dir)
-
- // Protect rootDir against buildDir
- guardDir(options, 'rootDir', 'generate.dir')
- }
-
- if (hasSrcDir) {
- // Protect srcDir against buildDir
- guardDir(options, 'srcDir', 'buildDir')
-
- if (hasGenerateDir) {
- // Protect srcDir against generate.dir
- guardDir(options, 'srcDir', 'generate.dir')
- }
- }
-
- // Populate modulesDir
- options.modulesDir = uniq(
- getMainModule().paths.concat(
- [].concat(options.modulesDir).map(dir => path.resolve(options.rootDir, dir))
- )
- )
-
- const mandatoryExtensions = ['js', 'mjs']
-
- options.extensions = mandatoryExtensions
- .filter(ext => !options.extensions.includes(ext))
- .concat(options.extensions)
-
- // If app.html is defined, set the template path to the user template
- if (options.appTemplatePath === undefined) {
- options.appTemplatePath = path.resolve(options.buildDir, 'views/app.template.html')
- if (fs.existsSync(path.join(options.srcDir, 'app.html'))) {
- options.appTemplatePath = path.join(options.srcDir, 'app.html')
- }
- } else {
- options.appTemplatePath = path.resolve(options.srcDir, options.appTemplatePath)
- }
-
- options.build.publicPath = options.build.publicPath.replace(/([^/])$/, '$1/')
- options.build._publicPath = options.build._publicPath.replace(/([^/])$/, '$1/')
-
- // Ignore publicPath on dev
- if (options.dev && isUrl(options.build.publicPath)) {
- options.build.publicPath = options.build._publicPath
- }
-
- // If store defined, update store options to true unless explicitly disabled
- if (
- options.store !== false &&
- fs.existsSync(path.join(options.srcDir, options.dir.store)) &&
- fs.readdirSync(path.join(options.srcDir, options.dir.store))
- .find(filename => filename !== 'README.md' && filename[0] !== '.')
- ) {
- options.store = true
- }
-
- // SPA loadingIndicator
- if (options.loadingIndicator) {
- // Normalize loadingIndicator
- if (!isPureObject(options.loadingIndicator)) {
- options.loadingIndicator = { name: options.loadingIndicator }
- }
-
- // Apply defaults
- options.loadingIndicator = Object.assign(
- {
- name: 'default',
- color: (options.loading && options.loading.color) || '#D3D3D3',
- color2: '#F5F5F5',
- background: (options.manifest && options.manifest.theme_color) || 'white',
- dev: options.dev,
- loading: options.messages.loading
- },
- options.loadingIndicator
- )
- }
-
- // Debug errors
- if (options.debug === undefined) {
- options.debug = options.dev
- }
-
- // Validate that etag.hash is a function, if not unset it
- if (options.render.etag) {
- const { hash } = options.render.etag
- if (hash) {
- const isFn = typeof hash === 'function'
- if (!isFn) {
- options.render.etag.hash = undefined
-
- if (options.dev) {
- consola.warn(`render.etag.hash should be a function, received ${typeof hash} instead`)
- }
- }
- }
- }
-
- // Apply default hash to CSP option
- if (options.render.csp) {
- options.render.csp = defu(options.render.csp, {
- hashAlgorithm: 'sha256',
- allowedSources: undefined,
- policies: undefined,
- addMeta: Boolean(options._generate),
- unsafeInlineCompatibility: false,
- reportOnly: options.debug
- })
-
- // TODO: Remove this if statement in Nuxt 3, we will stop supporting this typo (more on: https://github.com/nuxt/nuxt.js/pull/6583)
- if (options.render.csp.unsafeInlineCompatiblity) {
- consola.warn('Using `unsafeInlineCompatiblity` is deprecated and will be removed in Nuxt 3. Use `unsafeInlineCompatibility` instead.')
- options.render.csp.unsafeInlineCompatibility = options.render.csp.unsafeInlineCompatiblity
- delete options.render.csp.unsafeInlineCompatiblity
- }
- }
-
- // cssSourceMap
- if (options.build.cssSourceMap === undefined) {
- options.build.cssSourceMap = options.dev
- }
-
- const babelConfig = options.build.babel
- // babel cacheDirectory
- if (babelConfig.cacheDirectory === undefined) {
- babelConfig.cacheDirectory = options.dev
- }
-
- // TODO: remove this warn in Nuxt 3
- if (Array.isArray(babelConfig.presets)) {
- const warnPreset = (presetName) => {
- const oldPreset = '@nuxtjs/babel-preset-app'
- const newPreset = '@nuxt/babel-preset-app'
- if (presetName.includes(oldPreset)) {
- presetName = presetName.replace(oldPreset, newPreset)
- consola.warn('@nuxtjs/babel-preset-app has been deprecated, please use @nuxt/babel-preset-app.')
- }
- return presetName
- }
- babelConfig.presets = babelConfig.presets.map((preset) => {
- const hasOptions = Array.isArray(preset)
- if (hasOptions) {
- preset[0] = warnPreset(preset[0])
- } else if (typeof preset === 'string') {
- preset = warnPreset(preset)
- }
- return preset
- })
- }
-
- // Vue config
- const vueConfig = options.vue.config
-
- if (vueConfig.silent === undefined) {
- vueConfig.silent = !options.dev
- }
- if (vueConfig.performance === undefined) {
- vueConfig.performance = options.dev
- }
-
- // merge custom env with variables
- const eligibleEnvVariables = pick(process.env, Object.keys(process.env).filter(k => k.startsWith('NUXT_ENV_')))
- Object.assign(options.env, eligibleEnvVariables)
-
- // Normalize ignore
- options.ignore = options.ignore ? [].concat(options.ignore) : []
-
- // Append ignorePrefix glob to ignore
- if (typeof options.ignorePrefix === 'string') {
- options.ignore.push(`**/${options.ignorePrefix}*.*`)
- }
-
- // Compression middleware legacy
- if (options.render.gzip) {
- consola.warn('render.gzip is deprecated and will be removed in a future version! Please switch to render.compressor')
- options.render.compressor = options.render.gzip
- delete options.render.gzip
- }
-
- // Apply mode preset
- const modePreset = options.modes[options.mode || 'universal']
-
- if (!modePreset) {
- consola.warn(`Unknown mode: ${options.mode}. Falling back to universal`)
- }
- defaultsDeep(options, modePreset || options.modes.universal)
-
- // If no server-side rendering, add appear true transition
- if (options.render.ssr === false && options.pageTransition) {
- options.pageTransition.appear = true
- }
-
- options.render.ssrLog = options.dev
- ? options.render.ssrLog === undefined || options.render.ssrLog
- : false
-
- // We assume the SPA fallback path is 404.html (for GitHub Pages, Surge, etc.)
- if (options.generate.fallback === true) {
- options.generate.fallback = '404.html'
- }
-
- if (options.build.stats === 'none' || options.build.quiet === true) {
- options.build.stats = false
- }
-
- // Vendor backward compatibility with nuxt 1.x
- if (typeof options.build.vendor !== 'undefined') {
- delete options.build.vendor
- consola.warn('vendor has been deprecated due to webpack4 optimization')
- }
-
- // Disable CSS extraction due to incompatibility with thread-loader
- if (options.build.extractCSS && options.build.parallel) {
- options.build.parallel = false
- consola.warn('extractCSS cannot work with parallel build due to limited work pool in thread-loader')
- }
-
- // build.extractCSS.allChunks has no effect
- if (typeof options.build.extractCSS.allChunks !== 'undefined') {
- consola.warn('build.extractCSS.allChunks has no effect from v2.0.0. Please use build.optimization.splitChunks settings instead.')
- }
-
- // devModules has been renamed to buildModules
- if (typeof options.devModules !== 'undefined') {
- consola.warn('`devModules` has been renamed to `buildModules` and will be removed in Nuxt 3.')
- options.buildModules.push(...options.devModules)
- delete options.devModules
- }
-
- // Enable minimize for production builds
- if (options.build.optimization.minimize === undefined) {
- options.build.optimization.minimize = !options.dev
- }
-
- // Enable optimizeCSS only when extractCSS is enabled
- if (options.build.optimizeCSS === undefined) {
- options.build.optimizeCSS = options.build.extractCSS ? {} : false
- }
-
- const { loaders } = options.build
- const vueLoader = loaders.vue
- if (vueLoader.productionMode === undefined) {
- vueLoader.productionMode = !options.dev
- }
- const styleLoaders = [
- 'css', 'cssModules', 'less',
- 'sass', 'scss', 'stylus', 'vueStyle'
- ]
- for (const name of styleLoaders) {
- const loader = loaders[name]
- if (loader && loader.sourceMap === undefined) {
- loader.sourceMap = Boolean(options.build.cssSourceMap)
- }
- }
-
- options.build.transpile = [].concat(options.build.transpile || [])
-
- if (options.build.quiet === true) {
- consola.level = 0
- }
-
- // Use runInNewContext for dev mode by default
- const { bundleRenderer } = options.render
- if (typeof bundleRenderer.runInNewContext === 'undefined') {
- bundleRenderer.runInNewContext = options.dev
- }
-
- // Loading screen
- // disable for production and programmatic users
- if (!options.dev || !options._cli) {
- options.build.loadingScreen = false
- }
- // Add loading-screen module
- if (options.build.loadingScreen) {
- options.buildModules.push(['@nuxt/loading-screen', options.build.loadingScreen])
- }
-
- // When loadingScreen is disabled we should also disable build indicator
- if (!options.build.loadingScreen) {
- options.build.indicator = false
- }
-
- // TODO: Remove this if statement in Nuxt 3
- if (options.build.crossorigin) {
- consola.warn('Using `build.crossorigin` is deprecated and will be removed in Nuxt 3. Please use `render.crossorigin` instead.')
- options.render.crossorigin = options.build.crossorigin
- delete options.build.crossorigin
- }
-
- const { timing } = options.server
- if (timing) {
- options.server.timing = { total: true, ...timing }
- }
-
- if (isPureObject(options.serverMiddleware)) {
- options.serverMiddleware = Object.entries(options.serverMiddleware)
- .map(([path, handler]) => ({ path, handler }))
- }
-
- return options
-}
diff --git a/packages/config/test/__snapshots__/options.test.js.snap b/packages/config/test/__snapshots__/options.test.js.snap
deleted file mode 100644
index f33b8354384f..000000000000
--- a/packages/config/test/__snapshots__/options.test.js.snap
+++ /dev/null
@@ -1,388 +0,0 @@
-// Jest Snapshot v1, https://goo.gl/fbAQLP
-
-exports[`config: options should return default nuxt config 1`] = `
-Object {
- "ErrorPage": null,
- "__normalized__": true,
- "_nuxtConfigFile": "/var/nuxt/test/nuxt.config.js",
- "_nuxtConfigFiles": Array [
- "/var/nuxt/test/nuxt.config.js",
- ],
- "alias": Object {
- "@": "/var/nuxt/test",
- "@@": "/var/nuxt/test",
- "assets": "/var/nuxt/test/assets",
- "static": "/var/nuxt/test/static",
- "~": "/var/nuxt/test",
- "~~": "/var/nuxt/test",
- },
- "appTemplatePath": "/var/nuxt/test/.nuxt/views/app.template.html",
- "build": Object {
- "_publicPath": "/_nuxt/",
- "additionalExtensions": Array [],
- "aggressiveCodeRemoval": false,
- "analyze": false,
- "babel": Object {
- "babelrc": false,
- "cacheDirectory": false,
- "configFile": false,
- },
- "cache": false,
- "cssSourceMap": false,
- "devMiddleware": Object {},
- "extractCSS": false,
- "filenames": Object {
- "app": [Function],
- "chunk": [Function],
- "css": [Function],
- "font": [Function],
- "img": [Function],
- "video": [Function],
- },
- "followSymlinks": false,
- "friendlyErrors": true,
- "hardSource": false,
- "hotMiddleware": Object {},
- "html": Object {
- "minify": Object {
- "collapseBooleanAttributes": true,
- "decodeEntities": true,
- "minifyCSS": true,
- "minifyJS": true,
- "processConditionalComments": true,
- "removeEmptyAttributes": true,
- "removeRedundantAttributes": true,
- "trimCustomFragments": true,
- "useShortDoctype": true,
- },
- },
- "indicator": false,
- "loaders": Object {
- "css": Object {
- "sourceMap": false,
- },
- "cssModules": Object {
- "modules": Object {
- "localIdentName": "[local]_[hash:base64:5]",
- },
- "sourceMap": false,
- },
- "file": Object {},
- "fontUrl": Object {
- "limit": 1000,
- },
- "imgUrl": Object {
- "limit": 1000,
- },
- "less": Object {
- "sourceMap": false,
- },
- "pugPlain": Object {},
- "sass": Object {
- "sassOptions": Object {
- "indentedSyntax": true,
- },
- "sourceMap": false,
- },
- "scss": Object {
- "sourceMap": false,
- },
- "stylus": Object {
- "sourceMap": false,
- },
- "vue": Object {
- "productionMode": true,
- "transformAssetUrls": Object {
- "embed": "src",
- "object": "src",
- "source": "src",
- "video": "src",
- },
- },
- "vueStyle": Object {
- "sourceMap": false,
- },
- },
- "loadingScreen": false,
- "optimization": Object {
- "minimize": true,
- "minimizer": undefined,
- "runtimeChunk": "single",
- "splitChunks": Object {
- "automaticNameDelimiter": ".",
- "cacheGroups": Object {},
- "chunks": "all",
- "name": undefined,
- },
- },
- "optimizeCSS": false,
- "parallel": false,
- "plugins": Array [],
- "postcss": Object {
- "preset": Object {
- "stage": 2,
- },
- },
- "profile": false,
- "publicPath": "/_nuxt/",
- "quiet": true,
- "serverURLPolyfill": "url",
- "splitChunks": Object {
- "commons": true,
- "layouts": false,
- "pages": true,
- },
- "ssr": true,
- "standalone": false,
- "stats": false,
- "styleResources": Object {},
- "template": undefined,
- "templates": Array [],
- "terser": Object {},
- "transpile": Array [],
- "warningIgnoreFilters": Array [],
- "watch": Array [],
- },
- "buildDir": "/var/nuxt/test/.nuxt",
- "buildModules": Array [],
- "cli": Object {
- "badgeMessages": Array [],
- "bannerColor": "green",
- },
- "css": Array [],
- "debug": false,
- "dev": false,
- "dir": Object {
- "app": "app",
- "assets": "assets",
- "layouts": "layouts",
- "middleware": "middleware",
- "pages": "pages",
- "static": "static",
- "store": "store",
- },
- "editor": undefined,
- "env": Object {},
- "extendPlugins": null,
- "extensions": Array [
- "js",
- "mjs",
- ],
- "features": Object {
- "asyncData": true,
- "clientOnline": true,
- "clientPrefetch": true,
- "clientUseUrl": false,
- "componentAliases": true,
- "componentClientOnly": true,
- "deprecations": true,
- "fetch": true,
- "layouts": true,
- "meta": true,
- "middleware": true,
- "store": true,
- "transitions": true,
- "validate": true,
- },
- "fetch": Object {
- "client": true,
- "server": true,
- },
- "generate": Object {
- "concurrency": 500,
- "dir": "/var/nuxt/test/dist",
- "exclude": Array [],
- "fallback": "200.html",
- "interval": 0,
- "routes": Array [],
- "subFolders": true,
- },
- "globalName": "nuxt",
- "globals": Object {
- "context": [Function],
- "id": [Function],
- "loadedCallback": [Function],
- "nuxt": [Function],
- "pluginPrefix": [Function],
- "readyCallback": [Function],
- },
- "head": Object {
- "link": Array [],
- "meta": Array [],
- "script": Array [],
- "style": Array [],
- },
- "hooks": null,
- "ignore": Array [
- "**/*.test.*",
- "**/*.spec.*",
- "**/-*.*",
- ],
- "ignoreOptions": undefined,
- "ignorePrefix": "-",
- "layoutTransition": Object {
- "mode": "out-in",
- "name": "layout",
- },
- "layouts": Object {},
- "loading": Object {
- "color": "black",
- "continuous": false,
- "css": true,
- "duration": 5000,
- "failedColor": "red",
- "height": "2px",
- "rtl": false,
- "throttle": 200,
- },
- "loadingIndicator": Object {
- "background": "white",
- "color": "black",
- "color2": "#F5F5F5",
- "dev": false,
- "loading": "Loading...",
- "name": "default",
- },
- "messages": Object {
- "back_to_home": "Back to the home page",
- "client_error": "Error",
- "client_error_details": "An error occurred while rendering the page. Check developer tools console for details.",
- "error_404": "This page could not be found",
- "loading": "Loading...",
- "nuxtjs": "Nuxt.js",
- "server_error": "Server error",
- "server_error_details": "An error occurred in the application and your page could not be served. If you are the application owner, check your logs for details.",
- },
- "mode": "universal",
- "modern": undefined,
- "modes": Object {
- "spa": Object {
- "build": Object {
- "ssr": false,
- },
- "render": Object {
- "ssr": false,
- },
- },
- "universal": Object {
- "build": Object {
- "ssr": true,
- },
- "render": Object {
- "ssr": true,
- },
- },
- },
- "modules": Array [],
- "modulesDir": Array [
- "/var/nuxt/node_modules",
- "/var/nuxt/test/node_modules",
- ],
- "pageTransition": Object {
- "appear": false,
- "appearActiveClass": "appear-active",
- "appearClass": "appear",
- "appearToClass": "appear-to",
- "mode": "out-in",
- "name": "page",
- },
- "plugins": Array [],
- "render": Object {
- "bundleRenderer": Object {
- "runInNewContext": false,
- "shouldPrefetch": [Function],
- "shouldPreload": [Function],
- },
- "compressor": Object {
- "threshold": 0,
- },
- "crossorigin": undefined,
- "csp": false,
- "dist": Object {
- "index": false,
- "maxAge": "1y",
- },
- "etag": Object {
- "weak": false,
- },
- "fallback": Object {
- "dist": Object {},
- "static": Object {
- "handlers": Object {
- ".htm": false,
- ".html": false,
- },
- "skipUnknown": true,
- },
- },
- "http2": Object {
- "push": false,
- "pushAssets": null,
- "shouldPush": null,
- },
- "resourceHints": true,
- "ssr": true,
- "ssrLog": false,
- "static": Object {
- "prefix": true,
- },
- },
- "rootDir": "/var/nuxt/test",
- "router": Object {
- "base": "/",
- "extendRoutes": null,
- "fallback": false,
- "linkActiveClass": "nuxt-link-active",
- "linkExactActiveClass": "nuxt-link-exact-active",
- "linkPrefetchedClass": false,
- "middleware": Array [],
- "mode": "history",
- "parseQuery": false,
- "prefetchLinks": true,
- "routeNameSplitter": "-",
- "routes": Array [],
- "scrollBehavior": null,
- "stringifyQuery": false,
- "trailingSlash": undefined,
- },
- "server": Object {
- "host": "localhost",
- "https": false,
- "port": 3000,
- "socket": undefined,
- "timing": false,
- },
- "serverMiddleware": Array [],
- "srcDir": "/var/nuxt/test",
- "styleExtensions": Array [
- "css",
- "pcss",
- "postcss",
- "styl",
- "stylus",
- "scss",
- "sass",
- "less",
- ],
- "test": true,
- "vue": Object {
- "config": Object {
- "performance": false,
- "silent": true,
- },
- },
- "vueMeta": null,
- "watch": Array [
- "/var/nuxt/test/nuxt.config.js",
- ],
- "watchers": Object {
- "chokidar": Object {
- "ignoreInitial": true,
- },
- "rewatchOnRawEvents": undefined,
- "webpack": Object {
- "aggregateTimeout": 1000,
- },
- },
-}
-`;
diff --git a/packages/config/test/config/__snapshots__/index.test.js.snap b/packages/config/test/config/__snapshots__/index.test.js.snap
deleted file mode 100644
index 98be64b3b17a..000000000000
--- a/packages/config/test/config/__snapshots__/index.test.js.snap
+++ /dev/null
@@ -1,713 +0,0 @@
-// Jest Snapshot v1, https://goo.gl/fbAQLP
-
-exports[`config should return default nuxt configurations 1`] = `
-Object {
- "ErrorPage": null,
- "_nuxtConfigFile": undefined,
- "alias": Object {},
- "build": Object {
- "additionalExtensions": Array [],
- "aggressiveCodeRemoval": false,
- "analyze": false,
- "babel": Object {
- "babelrc": false,
- "cacheDirectory": undefined,
- "configFile": false,
- },
- "cache": false,
- "cssSourceMap": undefined,
- "devMiddleware": Object {},
- "extractCSS": false,
- "filenames": Object {
- "app": [Function],
- "chunk": [Function],
- "css": [Function],
- "font": [Function],
- "img": [Function],
- "video": [Function],
- },
- "followSymlinks": false,
- "friendlyErrors": true,
- "hardSource": false,
- "hotMiddleware": Object {},
- "html": Object {
- "minify": Object {
- "collapseBooleanAttributes": true,
- "decodeEntities": true,
- "minifyCSS": true,
- "minifyJS": true,
- "processConditionalComments": true,
- "removeEmptyAttributes": true,
- "removeRedundantAttributes": true,
- "trimCustomFragments": true,
- "useShortDoctype": true,
- },
- },
- "indicator": Object {
- "backgroundColor": "#2E495E",
- "color": "#00C48D",
- "position": "bottom-right",
- },
- "loaders": Object {
- "css": Object {},
- "cssModules": Object {
- "modules": Object {
- "localIdentName": "[local]_[hash:base64:5]",
- },
- },
- "file": Object {},
- "fontUrl": Object {
- "limit": 1000,
- },
- "imgUrl": Object {
- "limit": 1000,
- },
- "less": Object {},
- "pugPlain": Object {},
- "sass": Object {
- "sassOptions": Object {
- "indentedSyntax": true,
- },
- },
- "scss": Object {},
- "stylus": Object {},
- "vue": Object {
- "transformAssetUrls": Object {
- "embed": "src",
- "object": "src",
- "source": "src",
- "video": "src",
- },
- },
- "vueStyle": Object {},
- },
- "loadingScreen": Object {},
- "optimization": Object {
- "minimize": undefined,
- "minimizer": undefined,
- "runtimeChunk": "single",
- "splitChunks": Object {
- "automaticNameDelimiter": ".",
- "cacheGroups": Object {},
- "chunks": "all",
- "name": undefined,
- },
- },
- "optimizeCSS": undefined,
- "parallel": false,
- "plugins": Array [],
- "postcss": Object {
- "preset": Object {
- "stage": 2,
- },
- },
- "profile": false,
- "publicPath": "/_nuxt/",
- "quiet": true,
- "serverURLPolyfill": "url",
- "splitChunks": Object {
- "commons": true,
- "layouts": false,
- "pages": true,
- },
- "ssr": undefined,
- "standalone": false,
- "stats": Object {
- "excludeAssets": Array [
- /\\.map\\$/,
- /index\\\\\\.\\.\\+\\\\\\.html\\$/,
- /vue-ssr-\\(client\\|modern\\)-manifest\\.json/,
- ],
- },
- "styleResources": Object {},
- "template": undefined,
- "templates": Array [],
- "terser": Object {},
- "transpile": Array [],
- "warningIgnoreFilters": Array [],
- "watch": Array [],
- },
- "buildDir": ".nuxt",
- "buildModules": Array [],
- "cli": Object {
- "badgeMessages": Array [],
- "bannerColor": "green",
- },
- "css": Array [],
- "debug": undefined,
- "dev": false,
- "dir": Object {
- "app": "app",
- "assets": "assets",
- "layouts": "layouts",
- "middleware": "middleware",
- "pages": "pages",
- "static": "static",
- "store": "store",
- },
- "editor": undefined,
- "env": Object {},
- "extendPlugins": null,
- "extensions": Array [],
- "features": Object {
- "asyncData": true,
- "clientOnline": true,
- "clientPrefetch": true,
- "clientUseUrl": false,
- "componentAliases": true,
- "componentClientOnly": true,
- "deprecations": true,
- "fetch": true,
- "layouts": true,
- "meta": true,
- "middleware": true,
- "store": true,
- "transitions": true,
- "validate": true,
- },
- "fetch": Object {
- "client": true,
- "server": true,
- },
- "generate": Object {
- "concurrency": 500,
- "dir": "dist",
- "exclude": Array [],
- "fallback": "200.html",
- "interval": 0,
- "routes": Array [],
- "subFolders": true,
- },
- "globalName": undefined,
- "globals": Object {
- "context": [Function],
- "id": [Function],
- "loadedCallback": [Function],
- "nuxt": [Function],
- "pluginPrefix": [Function],
- "readyCallback": [Function],
- },
- "head": Object {
- "link": Array [],
- "meta": Array [],
- "script": Array [],
- "style": Array [],
- },
- "hooks": null,
- "ignore": Array [
- "**/*.test.*",
- "**/*.spec.*",
- ],
- "ignoreOptions": undefined,
- "ignorePrefix": "-",
- "layoutTransition": Object {
- "mode": "out-in",
- "name": "layout",
- },
- "layouts": Object {},
- "loading": Object {
- "color": "black",
- "continuous": false,
- "css": true,
- "duration": 5000,
- "failedColor": "red",
- "height": "2px",
- "rtl": false,
- "throttle": 200,
- },
- "loadingIndicator": "default",
- "messages": Object {
- "back_to_home": "Back to the home page",
- "client_error": "Error",
- "client_error_details": "An error occurred while rendering the page. Check developer tools console for details.",
- "error_404": "This page could not be found",
- "loading": "Loading...",
- "nuxtjs": "Nuxt.js",
- "server_error": "Server error",
- "server_error_details": "An error occurred in the application and your page could not be served. If you are the application owner, check your logs for details.",
- },
- "mode": "universal",
- "modern": undefined,
- "modes": Object {
- "spa": Object {
- "build": Object {
- "ssr": false,
- },
- "render": Object {
- "ssr": false,
- },
- },
- "universal": Object {
- "build": Object {
- "ssr": true,
- },
- "render": Object {
- "ssr": true,
- },
- },
- },
- "modules": Array [],
- "modulesDir": Array [
- "node_modules",
- ],
- "pageTransition": Object {
- "appear": false,
- "appearActiveClass": "appear-active",
- "appearClass": "appear",
- "appearToClass": "appear-to",
- "mode": "out-in",
- "name": "page",
- },
- "plugins": Array [],
- "render": Object {
- "bundleRenderer": Object {
- "runInNewContext": undefined,
- "shouldPrefetch": [Function],
- "shouldPreload": [Function],
- },
- "compressor": Object {
- "threshold": 0,
- },
- "crossorigin": undefined,
- "csp": false,
- "dist": Object {
- "index": false,
- "maxAge": "1y",
- },
- "etag": Object {
- "weak": false,
- },
- "fallback": Object {
- "dist": Object {},
- "static": Object {
- "handlers": Object {
- ".htm": false,
- ".html": false,
- },
- "skipUnknown": true,
- },
- },
- "http2": Object {
- "push": false,
- "pushAssets": null,
- "shouldPush": null,
- },
- "resourceHints": true,
- "ssr": undefined,
- "ssrLog": undefined,
- "static": Object {
- "prefix": true,
- },
- },
- "router": Object {
- "base": "/",
- "extendRoutes": null,
- "fallback": false,
- "linkActiveClass": "nuxt-link-active",
- "linkExactActiveClass": "nuxt-link-exact-active",
- "linkPrefetchedClass": false,
- "middleware": Array [],
- "mode": "history",
- "parseQuery": false,
- "prefetchLinks": true,
- "routeNameSplitter": "-",
- "routes": Array [],
- "scrollBehavior": null,
- "stringifyQuery": false,
- "trailingSlash": undefined,
- },
- "server": Object {
- "host": "localhost",
- "https": false,
- "port": 3000,
- "socket": undefined,
- "timing": false,
- },
- "serverMiddleware": Array [],
- "srcDir": undefined,
- "styleExtensions": Array [
- "css",
- "pcss",
- "postcss",
- "styl",
- "stylus",
- "scss",
- "sass",
- "less",
- ],
- "test": true,
- "vue": Object {
- "config": Object {
- "performance": undefined,
- "silent": undefined,
- },
- },
- "vueMeta": null,
- "watch": Array [],
- "watchers": Object {
- "chokidar": Object {
- "ignoreInitial": true,
- },
- "rewatchOnRawEvents": undefined,
- "webpack": Object {
- "aggregateTimeout": 1000,
- },
- },
-}
-`;
-
-exports[`config should return nuxt configurations with custom env 1`] = `
-Object {
- "ErrorPage": null,
- "_nuxtConfigFile": undefined,
- "alias": Object {},
- "build": Object {
- "additionalExtensions": Array [],
- "aggressiveCodeRemoval": false,
- "analyze": false,
- "babel": Object {
- "babelrc": false,
- "cacheDirectory": undefined,
- "configFile": false,
- },
- "cache": false,
- "cssSourceMap": undefined,
- "devMiddleware": Object {},
- "extractCSS": false,
- "filenames": Object {
- "app": [Function],
- "chunk": [Function],
- "css": [Function],
- "font": [Function],
- "img": [Function],
- "video": [Function],
- },
- "followSymlinks": false,
- "friendlyErrors": true,
- "hardSource": false,
- "hotMiddleware": Object {},
- "html": Object {
- "minify": Object {
- "collapseBooleanAttributes": true,
- "decodeEntities": true,
- "minifyCSS": true,
- "minifyJS": true,
- "processConditionalComments": true,
- "removeEmptyAttributes": true,
- "removeRedundantAttributes": true,
- "trimCustomFragments": true,
- "useShortDoctype": true,
- },
- },
- "indicator": Object {
- "backgroundColor": "#2E495E",
- "color": "#00C48D",
- "position": "bottom-right",
- },
- "loaders": Object {
- "css": Object {},
- "cssModules": Object {
- "modules": Object {
- "localIdentName": "[local]_[hash:base64:5]",
- },
- },
- "file": Object {},
- "fontUrl": Object {
- "limit": 1000,
- },
- "imgUrl": Object {
- "limit": 1000,
- },
- "less": Object {},
- "pugPlain": Object {},
- "sass": Object {
- "sassOptions": Object {
- "indentedSyntax": true,
- },
- },
- "scss": Object {},
- "stylus": Object {},
- "vue": Object {
- "transformAssetUrls": Object {
- "embed": "src",
- "object": "src",
- "source": "src",
- "video": "src",
- },
- },
- "vueStyle": Object {},
- },
- "loadingScreen": Object {},
- "optimization": Object {
- "minimize": undefined,
- "minimizer": undefined,
- "runtimeChunk": "single",
- "splitChunks": Object {
- "automaticNameDelimiter": ".",
- "cacheGroups": Object {},
- "chunks": "all",
- "name": undefined,
- },
- },
- "optimizeCSS": undefined,
- "parallel": false,
- "plugins": Array [],
- "postcss": Object {
- "preset": Object {
- "stage": 2,
- },
- },
- "profile": false,
- "publicPath": "/_nuxt/",
- "quiet": true,
- "serverURLPolyfill": "url",
- "splitChunks": Object {
- "commons": true,
- "layouts": false,
- "pages": true,
- },
- "ssr": undefined,
- "standalone": false,
- "stats": Object {
- "excludeAssets": Array [
- /\\.map\\$/,
- /index\\\\\\.\\.\\+\\\\\\.html\\$/,
- /vue-ssr-\\(client\\|modern\\)-manifest\\.json/,
- ],
- },
- "styleResources": Object {},
- "template": undefined,
- "templates": Array [],
- "terser": Object {},
- "transpile": Array [],
- "warningIgnoreFilters": Array [],
- "watch": Array [],
- },
- "buildDir": ".nuxt",
- "buildModules": Array [],
- "cli": Object {
- "badgeMessages": Array [],
- "bannerColor": "green",
- },
- "css": Array [],
- "debug": undefined,
- "dev": false,
- "dir": Object {
- "app": "app",
- "assets": "assets",
- "layouts": "layouts",
- "middleware": "middleware",
- "pages": "pages",
- "static": "static",
- "store": "store",
- },
- "editor": undefined,
- "env": Object {},
- "extendPlugins": null,
- "extensions": Array [],
- "features": Object {
- "asyncData": true,
- "clientOnline": true,
- "clientPrefetch": true,
- "clientUseUrl": false,
- "componentAliases": true,
- "componentClientOnly": true,
- "deprecations": true,
- "fetch": true,
- "layouts": true,
- "meta": true,
- "middleware": true,
- "store": true,
- "transitions": true,
- "validate": true,
- },
- "fetch": Object {
- "client": true,
- "server": true,
- },
- "generate": Object {
- "concurrency": 500,
- "dir": "dist",
- "exclude": Array [],
- "fallback": "200.html",
- "interval": 0,
- "routes": Array [],
- "subFolders": true,
- },
- "globalName": undefined,
- "globals": Object {
- "context": [Function],
- "id": [Function],
- "loadedCallback": [Function],
- "nuxt": [Function],
- "pluginPrefix": [Function],
- "readyCallback": [Function],
- },
- "head": Object {
- "link": Array [],
- "meta": Array [],
- "script": Array [],
- "style": Array [],
- },
- "hooks": null,
- "ignore": Array [
- "**/*.test.*",
- "**/*.spec.*",
- ],
- "ignoreOptions": undefined,
- "ignorePrefix": "-",
- "layoutTransition": Object {
- "mode": "out-in",
- "name": "layout",
- },
- "layouts": Object {},
- "loading": Object {
- "color": "black",
- "continuous": false,
- "css": true,
- "duration": 5000,
- "failedColor": "red",
- "height": "2px",
- "rtl": false,
- "throttle": 200,
- },
- "loadingIndicator": "default",
- "messages": Object {
- "back_to_home": "Back to the home page",
- "client_error": "Error",
- "client_error_details": "An error occurred while rendering the page. Check developer tools console for details.",
- "error_404": "This page could not be found",
- "loading": "Loading...",
- "nuxtjs": "Nuxt.js",
- "server_error": "Server error",
- "server_error_details": "An error occurred in the application and your page could not be served. If you are the application owner, check your logs for details.",
- },
- "mode": "universal",
- "modern": undefined,
- "modes": Object {
- "spa": Object {
- "build": Object {
- "ssr": false,
- },
- "render": Object {
- "ssr": false,
- },
- },
- "universal": Object {
- "build": Object {
- "ssr": true,
- },
- "render": Object {
- "ssr": true,
- },
- },
- },
- "modules": Array [],
- "modulesDir": Array [
- "node_modules",
- ],
- "pageTransition": Object {
- "appear": false,
- "appearActiveClass": "appear-active",
- "appearClass": "appear",
- "appearToClass": "appear-to",
- "mode": "out-in",
- "name": "page",
- },
- "plugins": Array [],
- "render": Object {
- "bundleRenderer": Object {
- "runInNewContext": undefined,
- "shouldPrefetch": [Function],
- "shouldPreload": [Function],
- },
- "compressor": Object {
- "threshold": 0,
- },
- "crossorigin": undefined,
- "csp": false,
- "dist": Object {
- "index": false,
- "maxAge": "1y",
- },
- "etag": Object {
- "weak": false,
- },
- "fallback": Object {
- "dist": Object {},
- "static": Object {
- "handlers": Object {
- ".htm": false,
- ".html": false,
- },
- "skipUnknown": true,
- },
- },
- "http2": Object {
- "push": false,
- "pushAssets": null,
- "shouldPush": null,
- },
- "resourceHints": true,
- "ssr": undefined,
- "ssrLog": undefined,
- "static": Object {
- "prefix": true,
- },
- },
- "router": Object {
- "base": "/",
- "extendRoutes": null,
- "fallback": false,
- "linkActiveClass": "nuxt-link-active",
- "linkExactActiveClass": "nuxt-link-exact-active",
- "linkPrefetchedClass": false,
- "middleware": Array [],
- "mode": "history",
- "parseQuery": false,
- "prefetchLinks": true,
- "routeNameSplitter": "-",
- "routes": Array [],
- "scrollBehavior": null,
- "stringifyQuery": false,
- "trailingSlash": undefined,
- },
- "server": Object {
- "host": "localhost",
- "https": false,
- "port": "3001",
- "socket": "/var/run/nuxt.sock",
- "timing": false,
- },
- "serverMiddleware": Array [],
- "srcDir": undefined,
- "styleExtensions": Array [
- "css",
- "pcss",
- "postcss",
- "styl",
- "stylus",
- "scss",
- "sass",
- "less",
- ],
- "test": true,
- "vue": Object {
- "config": Object {
- "performance": undefined,
- "silent": undefined,
- },
- },
- "vueMeta": null,
- "watch": Array [],
- "watchers": Object {
- "chokidar": Object {
- "ignoreInitial": true,
- },
- "rewatchOnRawEvents": undefined,
- "webpack": Object {
- "aggregateTimeout": 1000,
- },
- },
-}
-`;
diff --git a/packages/config/test/config/_common.test.js b/packages/config/test/config/_common.test.js
deleted file mode 100644
index 704d1755da92..000000000000
--- a/packages/config/test/config/_common.test.js
+++ /dev/null
@@ -1,14 +0,0 @@
-import commonConfig from '../../src/config/_common'
-
-describe('config: common', () => {
- test('should return globals with given globalName', () => {
- const globalName = 'nuxt_global'
- const { globals } = commonConfig()
- expect(globals.id(globalName)).toEqual('__nuxt_global')
- expect(globals.nuxt(globalName)).toEqual('$nuxt_global')
- expect(globals.context(globalName)).toEqual('__NUXT_GLOBAL__')
- expect(globals.pluginPrefix(globalName)).toEqual('nuxt_global')
- expect(globals.readyCallback(globalName)).toEqual('onNuxt_globalReady')
- expect(globals.loadedCallback(globalName)).toEqual('_onNuxt_globalLoaded')
- })
-})
diff --git a/packages/config/test/config/build.test.js b/packages/config/test/config/build.test.js
deleted file mode 100644
index f55f79e6e085..000000000000
--- a/packages/config/test/config/build.test.js
+++ /dev/null
@@ -1,32 +0,0 @@
-import buildConfig from '../../src/config/build'
-
-describe('config: build', () => {
- test('should return dev filenames', () => {
- const { filenames } = buildConfig()
- const env = { isDev: true }
- expect(filenames.app(env)).toEqual('[name].js')
- expect(filenames.chunk(env)).toEqual('[name].js')
- expect(filenames.css(env)).toEqual('[name].css')
- expect(filenames.img(env)).toEqual('[path][name].[ext]')
- expect(filenames.font(env)).toEqual('[path][name].[ext]')
- expect(filenames.video(env)).toEqual('[path][name].[ext]')
- })
-
- test('should return prod filenames', () => {
- const { filenames } = buildConfig()
- const env = { isDev: false }
- expect(filenames.app(env)).toEqual('[contenthash].js')
- expect(filenames.chunk(env)).toEqual('[contenthash].js')
- expect(filenames.css(env)).toEqual('[contenthash].css')
- expect(filenames.img(env)).toEqual('img/[contenthash:7].[ext]')
- expect(filenames.font(env)).toEqual('fonts/[contenthash:7].[ext]')
- expect(filenames.video(env)).toEqual('videos/[contenthash:7].[ext]')
- })
-
- test('should return modern filenames', () => {
- const { filenames } = buildConfig()
- const env = { isDev: true, isModern: true }
- expect(filenames.app(env)).toEqual('modern-[name].js')
- expect(filenames.chunk(env)).toEqual('modern-[name].js')
- })
-})
diff --git a/packages/config/test/config/index.test.js b/packages/config/test/config/index.test.js
deleted file mode 100644
index d32c809aa4fe..000000000000
--- a/packages/config/test/config/index.test.js
+++ /dev/null
@@ -1,28 +0,0 @@
-import { getDefaultNuxtConfig } from '../../src/config'
-
-jest.mock('std-env', () => ({
- browser: false,
- test: 'test',
- dev: false,
- production: true,
- debug: false,
- ci: true,
- windows: false,
- darwin: false,
- linux: true
-}))
-
-describe('config', () => {
- test('should return default nuxt configurations', () => {
- expect(getDefaultNuxtConfig()).toMatchSnapshot()
- })
-
- test('should return nuxt configurations with custom env', () => {
- const env = {
- NUXT_PORT: '3001',
- NUXT_HOST: 'localhost',
- UNIX_SOCKET: '/var/run/nuxt.sock'
- }
- expect(getDefaultNuxtConfig({ env })).toMatchSnapshot()
- })
-})
diff --git a/packages/config/test/config/render.test.js b/packages/config/test/config/render.test.js
deleted file mode 100644
index 0223125d8a65..000000000000
--- a/packages/config/test/config/render.test.js
+++ /dev/null
@@ -1,19 +0,0 @@
-import renderConfig from '../../src/config/render'
-
-describe('config: render', () => {
- test('should return false in default shouldPrefetch', () => {
- const { bundleRenderer: { shouldPrefetch } } = renderConfig()
- expect(shouldPrefetch()).toEqual(false)
- })
-
- test('should return true in script/style shouldPreload', () => {
- const { bundleRenderer: { shouldPreload } } = renderConfig()
- expect(shouldPreload(undefined, 'script')).toEqual(true)
- expect(shouldPreload(undefined, 'style')).toEqual(true)
- })
-
- test('should return false in other shouldPreload', () => {
- const { bundleRenderer: { shouldPreload } } = renderConfig()
- expect(shouldPreload(undefined, 'font')).toEqual(false)
- })
-})
diff --git a/packages/config/test/config/server.test.js b/packages/config/test/config/server.test.js
deleted file mode 100644
index ee59034a820c..000000000000
--- a/packages/config/test/config/server.test.js
+++ /dev/null
@@ -1,45 +0,0 @@
-import serverConfig from '../../src/config/server'
-
-const serverDefaults = serverConfig()
-
-describe('config: server', () => {
- test('should return server configurations with NUXT_* env', () => {
- const env = {
- NUXT_PORT: 3001,
- NUXT_HOST: '127.0.0.1'
- }
- expect(serverConfig({ env })).toEqual({
- ...serverDefaults,
- port: env.NUXT_PORT,
- host: env.NUXT_HOST
- })
- })
-
- test('should return server configurations with env', () => {
- const env = {
- PORT: 3002,
- HOST: 'local.env',
- UNIX_SOCKET: '/var/run/env.sock'
- }
- expect(serverConfig({ env })).toEqual({
- ...serverDefaults,
- port: env.PORT,
- host: env.HOST,
- socket: env.UNIX_SOCKET
- })
- })
-
- test('should return server configurations with npm_* env', () => {
- const env = {
- npm_package_config_nuxt_port: 3003,
- npm_package_config_nuxt_host: 'local.npm',
- npm_package_config_unix_socket: '/var/run/env.npm.sock'
- }
- expect(serverConfig({ env })).toEqual({
- ...serverDefaults,
- port: env.npm_package_config_nuxt_port,
- host: env.npm_package_config_nuxt_host,
- socket: env.npm_package_config_unix_socket
- })
- })
-})
diff --git a/packages/config/test/index.test.js b/packages/config/test/index.test.js
deleted file mode 100644
index 7779b5c0b7e0..000000000000
--- a/packages/config/test/index.test.js
+++ /dev/null
@@ -1,16 +0,0 @@
-import { getDefaultNuxtConfig, getNuxtConfig } from '../src'
-
-jest.mock('../src/options', () => ({
- getNuxtConfig: jest.fn(() => 'nuxt config')
-}))
-
-jest.mock('../src/config', () => ({
- getDefaultNuxtConfig: jest.fn(() => 'default nuxt config')
-}))
-
-describe('config: entry', () => {
- test('should export getDefaultNuxtConfig and getNuxtConfig', () => {
- expect(getNuxtConfig()).toEqual('nuxt config')
- expect(getDefaultNuxtConfig()).toEqual('default nuxt config')
- })
-})
diff --git a/packages/config/test/options.test.js b/packages/config/test/options.test.js
deleted file mode 100644
index 7cd3d64f67e0..000000000000
--- a/packages/config/test/options.test.js
+++ /dev/null
@@ -1,305 +0,0 @@
-import path from 'path'
-import consola from 'consola'
-import { getNuxtConfig } from '../src/options'
-
-jest.mock('std-env', () => ({
- browser: false,
- test: 'test',
- dev: false,
- production: true,
- debug: false,
- ci: true,
- windows: false,
- darwin: false,
- linux: true
-}))
-
-jest.mock('@nuxt/utils', () => ({
- ...jest.requireActual('@nuxt/utils'),
- getMainModule: () => ({ paths: ['/var/nuxt/node_modules'] })
-}))
-
-describe('config: options', () => {
- test('should return default nuxt config', () => {
- jest.spyOn(process, 'cwd').mockReturnValue('/var/nuxt/test')
- jest.spyOn(path, 'resolve').mockImplementation((...args) => args.join('/').replace(/\\+/, '/'))
- jest.spyOn(path, 'join').mockImplementation((...args) => args.join('/').replace(/\\+/, '/'))
-
- expect(getNuxtConfig({})).toMatchSnapshot()
-
- process.cwd.mockRestore()
- path.resolve.mockRestore()
- path.join.mockRestore()
- })
-
- test('should prevent duplicate calls with same options', () => {
- const options = {}
- const firstConfig = getNuxtConfig(options)
- const secondConfig = getNuxtConfig(firstConfig)
-
- expect(firstConfig).toBe(secondConfig)
- expect(firstConfig.__normalized__).toBe(true)
- })
-
- test('should return default loading when loading is true', () => {
- const { loading } = getNuxtConfig({ loading: true })
- expect(loading).toEqual({
- color: 'black',
- failedColor: 'red',
- height: '2px',
- throttle: 200,
- duration: 5000,
- continuous: false,
- rtl: false,
- css: true
- })
- })
-
- test('[Compatibility] should transform transition to pageTransition', () => {
- const { pageTransition, transition } = getNuxtConfig({
- transition: 'test-tran'
- })
- expect(pageTransition).toMatchObject({ name: 'test-tran' })
- expect(transition).toBeUndefined()
- })
-
- test('should transform pageTransition/layoutTransition to name', () => {
- const { pageTransition, layoutTransition } = getNuxtConfig({
- pageTransition: 'test-tran',
- layoutTransition: 'test-layout-tran'
- })
- expect(pageTransition).toMatchObject({ name: 'test-tran' })
- expect(layoutTransition).toMatchObject({ name: 'test-layout-tran' })
- })
-
- test('should transform extensions to array', () => {
- const { extensions } = getNuxtConfig({ extensions: 'ext' })
- expect(extensions).toEqual(['js', 'mjs', 'ext'])
- })
-
- test('should support custom global name', () => {
- const { globalName } = getNuxtConfig({ globalName: 'globalNuxt' })
- expect(globalName).toEqual('globalnuxt')
- })
-
- test('should detect store dir', () => {
- const { store } = getNuxtConfig({ rootDir: path.resolve(__dirname, 'fixtures') })
- expect(store).toEqual(true)
- })
-
- test('should unset and warn when etag.hash not a function', () => {
- const { render: { etag } } = getNuxtConfig({ render: { etag: { hash: true } } })
- expect(etag).toMatchObject({ hash: undefined })
- expect(consola.warn).not.toHaveBeenCalledWith('render.etag.hash should be a function, received boolean instead')
-
- const { render: { etag: etagDev } } = getNuxtConfig({ dev: true, render: { etag: { hash: true } } })
- expect(etagDev).toMatchObject({ hash: undefined })
- expect(consola.warn).toHaveBeenCalledWith('render.etag.hash should be a function, received boolean instead')
- })
-
- test('should enable csp', () => {
- const { render: { csp } } = getNuxtConfig({ render: { csp: { allowedSources: ['/nuxt/*'], test: true } } })
- expect(csp).toEqual({
- hashAlgorithm: 'sha256',
- addMeta: false,
- unsafeInlineCompatibility: false,
- allowedSources: ['/nuxt/*'],
- policies: undefined,
- reportOnly: false,
- test: true
- })
- })
-
- // TODO: Remove this test in Nuxt 3, we will stop supporting this typo (more on: https://github.com/nuxt/nuxt.js/pull/6583)
- test('should enable csp with old typo property name, avoiding breaking changes', () => {
- const { render: { csp } } = getNuxtConfig({ render: { csp: { allowedSources: ['/nuxt/*'], test: true, unsafeInlineCompatiblity: true } } })
- expect(csp).toEqual({
- hashAlgorithm: 'sha256',
- addMeta: false,
- unsafeInlineCompatibility: true,
- allowedSources: ['/nuxt/*'],
- policies: undefined,
- reportOnly: false,
- test: true
- })
- })
-
- test('should check unknown mode', () => {
- const { build, render } = getNuxtConfig({ mode: 'test' })
- expect(consola.warn).toHaveBeenCalledWith('Unknown mode: test. Falling back to universal')
- expect(build.ssr).toEqual(true)
- expect(render.ssr).toEqual(true)
- })
-
- test('should add appear true in pageTransition when no ssr', () => {
- const { pageTransition } = getNuxtConfig({ render: { ssr: false } })
- expect(pageTransition.appear).toEqual(true)
- })
-
- test('should return 200.html as default generate.fallback', () => {
- const { generate: { fallback } } = getNuxtConfig({})
- expect(fallback).toEqual('200.html')
- })
-
- test('should return 404.html when generate.fallback is true', () => {
- const { generate: { fallback } } = getNuxtConfig({ generate: { fallback: true } })
- expect(fallback).toEqual('404.html')
- })
-
- test('should return fallback html when generate.fallback is string', () => {
- const { generate: { fallback } } = getNuxtConfig({ generate: { fallback: 'fallback.html' } })
- expect(fallback).toEqual('fallback.html')
- })
-
- test('should disable parallel if extractCSS is enabled', () => {
- const { build: { parallel } } = getNuxtConfig({ build: { extractCSS: true, parallel: true } })
- expect(parallel).toEqual(false)
- expect(consola.warn).toHaveBeenCalledWith('extractCSS cannot work with parallel build due to limited work pool in thread-loader')
- })
-
- describe('config: router dir', () => {
- test('should transform middleware to array', () => {
- const { router: { middleware } } = getNuxtConfig({ router: { middleware: 'midd' } })
- expect(middleware).toEqual(['midd'])
- })
-
- test('should set _routerBaseSpecified when base is specified', () => {
- const { _routerBaseSpecified } = getNuxtConfig({ router: { base: '/test' } })
- expect(_routerBaseSpecified).toEqual(true)
- })
- })
-
- describe('config: options dir', () => {
- test('should support custom root dir', () => {
- const { rootDir } = getNuxtConfig({
- rootDir: 'root'
- })
- expect(rootDir).toEqual(path.resolve('root'))
- })
-
- test('should support custom src dir', () => {
- const { srcDir } = getNuxtConfig({
- rootDir: 'root',
- srcDir: 'src'
- })
- expect(srcDir).toEqual(path.resolve('root', 'src'))
- })
-
- test('should support custom generate dir', () => {
- const { generate: { dir } } = getNuxtConfig({
- rootDir: 'root',
- generate: { dir: 'generate' }
- })
- expect(dir).toEqual(path.resolve('root', 'generate'))
- })
- })
-
- describe('config: options template', () => {
- test('should use default appTemplatePath', () => {
- const { appTemplatePath } = getNuxtConfig({})
- expect(appTemplatePath).toEqual(path.resolve('.nuxt', 'views', 'app.template.html'))
- })
-
- test('should use custom appTemplatePath', () => {
- const { appTemplatePath } = getNuxtConfig({ appTemplatePath: 'templates' })
- expect(appTemplatePath).toEqual(path.resolve('templates'))
- })
-
- test('should use custom app.html', () => {
- const { appTemplatePath } = getNuxtConfig({ rootDir: path.resolve(__dirname, 'fixtures') })
- expect(appTemplatePath).toEqual(path.resolve(__dirname, 'fixtures', 'app.html'))
- })
- })
-
- describe('config: options publicPath', () => {
- test('should fallback to default when publicPath is falsy', () => {
- const { build: { publicPath } } = getNuxtConfig({ build: { publicPath: false } })
- expect(publicPath).toEqual('/_nuxt/')
- })
-
- test('should append slash in publicPath', () => {
- const { build: { publicPath } } = getNuxtConfig({ build: { publicPath: '/nuxt_public' } })
- expect(publicPath).toEqual('/nuxt_public/')
- })
-
- test('should ignore url publicPath in dev', () => {
- const { build: { publicPath } } = getNuxtConfig({ dev: true, build: { publicPath: 'http://nuxt_public' } })
- expect(publicPath).toEqual('/_nuxt/')
- })
- })
-
- describe('config: options babel', () => {
- test('should replace and deprecate @nuxtjs/babel-preset-app', () => {
- const { build: { babel } } = getNuxtConfig({
- build: { babel: { presets: ['@nuxtjs/babel-preset-app'] } }
- })
- expect(consola.warn).toHaveBeenCalledWith('@nuxtjs/babel-preset-app has been deprecated, please use @nuxt/babel-preset-app.')
- expect(babel).toEqual({
- configFile: false,
- babelrc: false,
- cacheDirectory: false,
- presets: ['@nuxt/babel-preset-app']
- })
- })
-
- test('should support options in babel presets', () => {
- const { build: { babel } } = getNuxtConfig({
- build: { babel: { presets: [['@nuxt/babel-preset-app', { test: true }]] } }
- })
- expect(babel).toEqual({
- configFile: false,
- babelrc: false,
- cacheDirectory: false,
- presets: [['@nuxt/babel-preset-app', { test: true }]]
- })
- })
- })
-
- describe('config: options deprecated', () => {
- test('should deprecate render.gzip', () => {
- getNuxtConfig({ render: { gzip: true } })
- expect(consola.warn).toHaveBeenCalledWith('render.gzip is deprecated and will be removed in a future version! Please switch to render.compressor')
- })
-
- test('should deprecate build.vendor', () => {
- getNuxtConfig({ build: { vendor: ['lodash'] } })
- expect(consola.warn).toHaveBeenCalledWith('vendor has been deprecated due to webpack4 optimization')
- })
-
- test('should deprecate devModules', () => {
- const config = getNuxtConfig({ devModules: ['foo'], buildModules: ['bar'] })
- expect(consola.warn).toHaveBeenCalledWith('`devModules` has been renamed to `buildModules` and will be removed in Nuxt 3.')
- expect(config.devModules).toBe(undefined)
- expect(config.buildModules).toEqual(['bar', 'foo'])
- })
-
- test('should deprecate build.extractCSS.allChunks', () => {
- getNuxtConfig({ build: { extractCSS: { allChunks: true } } })
- expect(consola.warn).toHaveBeenCalledWith('build.extractCSS.allChunks has no effect from v2.0.0. Please use build.optimization.splitChunks settings instead.')
- })
-
- test('should deprecate build.crossorigin', () => {
- getNuxtConfig({ build: { crossorigin: 'use-credentials' } })
- expect(consola.warn).toHaveBeenCalledWith('Using `build.crossorigin` is deprecated and will be removed in Nuxt 3. Please use `render.crossorigin` instead.')
- })
- })
-})
-
-describe('config: serverMiddleware', () => {
- test('should transform serverMiddleware hash', () => {
- const serverMiddleware = {
- '/resource': (req, res, next) => {
- }
- }
- const config = getNuxtConfig({ serverMiddleware })
- expect(config.serverMiddleware[0].path).toBe('/resource')
- expect(config.serverMiddleware[0].handler).toBe(serverMiddleware['/resource'])
- })
-})
-
-describe('config: router', () => {
- test('should sanitize router.base', () => {
- const config = getNuxtConfig({ router: { base: '/foo' } })
- expect(config.router.base).toBe('/foo/')
- })
-})
diff --git a/packages/core/package.js b/packages/core/package.js
deleted file mode 100644
index 19d0ef6e2d14..000000000000
--- a/packages/core/package.js
+++ /dev/null
@@ -1,3 +0,0 @@
-export default {
- build: true
-}
diff --git a/packages/core/package.json b/packages/core/package.json
deleted file mode 100644
index 3279fa0031cf..000000000000
--- a/packages/core/package.json
+++ /dev/null
@@ -1,27 +0,0 @@
-{
- "name": "@nuxt/core",
- "version": "2.12.1",
- "repository": "nuxt/nuxt.js",
- "license": "MIT",
- "main": "dist/core.js",
- "files": [
- "dist"
- ],
- "dependencies": {
- "@nuxt/config": "2.12.1",
- "@nuxt/devalue": "^1.2.4",
- "@nuxt/server": "2.12.1",
- "@nuxt/utils": "2.12.1",
- "@nuxt/vue-renderer": "2.12.1",
- "consola": "^2.11.3",
- "debug": "^4.1.1",
- "esm": "^3.2.25",
- "fs-extra": "^8.1.0",
- "hable": "^3.0.0",
- "hash-sum": "^2.0.0",
- "std-env": "^2.2.1"
- },
- "publishConfig": {
- "access": "public"
- }
-}
diff --git a/packages/core/src/index.js b/packages/core/src/index.js
deleted file mode 100644
index f885225c9061..000000000000
--- a/packages/core/src/index.js
+++ /dev/null
@@ -1,5 +0,0 @@
-export { default as Module } from './module'
-export { default as Nuxt } from './nuxt'
-export { default as Resolver } from './resolver'
-export { loadNuxtConfig } from '@nuxt/config'
-export { loadNuxt } from './load'
diff --git a/packages/core/src/load.js b/packages/core/src/load.js
deleted file mode 100644
index 6ed0073c3e2e..000000000000
--- a/packages/core/src/load.js
+++ /dev/null
@@ -1,40 +0,0 @@
-import { loadNuxtConfig } from '@nuxt/config'
-import Nuxt from './nuxt'
-
-const OVERRIDES = {
- dry: { dev: false, server: false },
- dev: { dev: true, _build: true },
- build: { dev: false, server: false, _build: true },
- start: { dev: false, _start: true }
-}
-
-export async function loadNuxt (loadOptions) {
- // Normalize loadOptions
- if (typeof loadOptions === 'string') {
- loadOptions = { for: loadOptions }
- }
- const { ready = true } = loadOptions
- const _for = loadOptions.for || 'dry'
-
- // Get overrides
- const override = OVERRIDES[_for]
-
- // Unsupported purpose
- if (!override) {
- throw new Error('Unsupported for: ' + _for)
- }
-
- // Load Config
- const config = await loadNuxtConfig(loadOptions)
-
- // Apply config overrides
- Object.assign(config, override)
-
- // Initiate Nuxt
- const nuxt = new Nuxt(config)
- if (ready) {
- await nuxt.ready()
- }
-
- return nuxt
-}
diff --git a/packages/core/src/module.js b/packages/core/src/module.js
deleted file mode 100644
index 91ecfbc1c3f9..000000000000
--- a/packages/core/src/module.js
+++ /dev/null
@@ -1,200 +0,0 @@
-import path from 'path'
-import fs from 'fs'
-import hash from 'hash-sum'
-import consola from 'consola'
-
-import { chainFn, sequence } from '@nuxt/utils'
-
-export default class ModuleContainer {
- constructor (nuxt) {
- this.nuxt = nuxt
- this.options = nuxt.options
- this.requiredModules = {}
- }
-
- async ready () {
- // Call before hook
- await this.nuxt.callHook('modules:before', this, this.options.modules)
-
- if (this.options.buildModules && !this.options._start) {
- // Load every devModule in sequence
- await sequence(this.options.buildModules, this.addModule.bind(this))
- }
-
- // Load every module in sequence
- await sequence(this.options.modules, this.addModule.bind(this))
-
- // Call done hook
- await this.nuxt.callHook('modules:done', this)
- }
-
- addVendor () {
- consola.warn('addVendor has been deprecated due to webpack4 optimization')
- }
-
- addTemplate (template) {
- if (!template) {
- throw new Error('Invalid template: ' + JSON.stringify(template))
- }
-
- // Validate & parse source
- const src = template.src || template
- const srcPath = path.parse(src)
-
- if (typeof src !== 'string' || !fs.existsSync(src)) {
- throw new Error('Template src not found: ' + src)
- }
-
- // Generate unique and human readable dst filename
- const dst =
- template.fileName ||
- path.basename(srcPath.dir) + `.${srcPath.name}.${hash(src)}` + srcPath.ext
-
- // Add to templates list
- const templateObj = {
- src,
- dst,
- options: template.options
- }
-
- this.options.build.templates.push(templateObj)
- return templateObj
- }
-
- addPlugin (template) {
- const { dst } = this.addTemplate(template)
-
- // Add to nuxt plugins
- this.options.plugins.unshift({
- src: path.join(this.options.buildDir, dst),
- // TODO: remove deprecated option in Nuxt 3
- ssr: template.ssr,
- mode: template.mode
- })
- }
-
- addLayout (template, name) {
- const { dst, src } = this.addTemplate(template)
- const layoutName = name || path.parse(src).name
- const layout = this.options.layouts[layoutName]
-
- if (layout) {
- consola.warn(`Duplicate layout registration, "${layoutName}" has been registered as "${layout}"`)
- }
-
- // Add to nuxt layouts
- this.options.layouts[layoutName] = `./${dst}`
-
- // If error layout, set ErrorPage
- if (name === 'error') {
- this.addErrorLayout(dst)
- }
- }
-
- addErrorLayout (dst) {
- const relativeBuildDir = path.relative(this.options.rootDir, this.options.buildDir)
- this.options.ErrorPage = `~/${relativeBuildDir}/${dst}`
- }
-
- addServerMiddleware (middleware) {
- this.options.serverMiddleware.push(middleware)
- }
-
- extendBuild (fn) {
- this.options.build.extend = chainFn(this.options.build.extend, fn)
- }
-
- extendRoutes (fn) {
- this.options.router.extendRoutes = chainFn(
- this.options.router.extendRoutes,
- fn
- )
- }
-
- requireModule (moduleOpts) {
- return this.addModule(moduleOpts, true /* require once */)
- }
-
- async addModule (moduleOpts, requireOnce) {
- let src
- let options
- let handler
-
- // Type 1: String or Function
- if (typeof moduleOpts === 'string' || typeof moduleOpts === 'function') {
- src = moduleOpts
- } else if (Array.isArray(moduleOpts)) {
- // Type 2: Babel style array
- [src, options] = moduleOpts
- } else if (typeof moduleOpts === 'object') {
- // Type 3: Pure object
- ({ src, options, handler } = moduleOpts)
- }
-
- // Define handler if src is a function
- if (typeof src === 'function') {
- handler = src
- }
-
- // Prevent adding buildModules-listed entries in production
- if (this.options.buildModules.includes(handler) && this.options._start) {
- return
- }
-
- // Resolve handler
- if (!handler) {
- try {
- handler = this.nuxt.resolver.requireModule(src, { useESM: true })
- } catch (error) {
- if (error.code !== 'MODULE_NOT_FOUND') {
- throw error
- }
-
- let message = 'Module `{name}` not found.'
-
- if (this.options.buildModules.includes(src)) {
- message += ' Please ensure `{name}` is in `devDependencies` and installed. HINT: During build step, for npm/yarn, `NODE_ENV=production` or `--production` should NOT be used.'.replace('{name}', src)
- } else if (this.options.modules.includes(src)) {
- message += ' Please ensure `{name}` is in `dependencies` and installed.'
- }
-
- message = message.replace(/{name}/g, src)
-
- if (this.options._cli) {
- throw new Error(message)
- } else {
- // TODO: Remove in next major version
- message += ' Silently ignoring module as programmatic usage detected.'
- consola.warn(message)
- return
- }
- }
- }
-
- // Validate handler
- if (typeof handler !== 'function') {
- throw new TypeError('Module should export a function: ' + src)
- }
-
- // Resolve module meta
- let key = (handler.meta && handler.meta.name) || handler.name
- if (!key || key === 'default') {
- key = src
- }
-
- // Update requiredModules
- if (typeof key === 'string') {
- if (requireOnce && this.requiredModules[key]) {
- return
- }
- this.requiredModules[key] = { src, options, handler }
- }
-
- // Default module options to empty object
- if (options === undefined) {
- options = {}
- }
- const result = await handler.call(this, options)
- return result
- }
-}
diff --git a/packages/core/src/nuxt.js b/packages/core/src/nuxt.js
deleted file mode 100644
index ac8201c2bdf6..000000000000
--- a/packages/core/src/nuxt.js
+++ /dev/null
@@ -1,115 +0,0 @@
-
-import isPlainObject from 'lodash/isPlainObject'
-import consola from 'consola'
-import Hookable from 'hable'
-
-import { defineAlias } from '@nuxt/utils'
-import { getNuxtConfig } from '@nuxt/config'
-import { Server } from '@nuxt/server'
-
-import { version } from '../package.json'
-
-import ModuleContainer from './module'
-import Resolver from './resolver'
-
-export default class Nuxt extends Hookable {
- constructor (options = {}) {
- super(consola)
-
- // Assign options and apply defaults
- this.options = getNuxtConfig(options)
-
- // Create instance of core components
- this.resolver = new Resolver(this)
- this.moduleContainer = new ModuleContainer(this)
-
- // Deprecated hooks
- this.deprecateHooks({
- // #3294 - 7514db73b25c23b8c14ebdafbb4e129ac282aabd
- 'render:context': {
- to: '_render:context',
- message: '`render:context(nuxt)` is deprecated, Please use `vue-renderer:ssr:context(context)`'
- },
- // #3773
- 'render:routeContext': {
- to: '_render:context',
- message: '`render:routeContext(nuxt)` is deprecated, Please use `vue-renderer:ssr:context(context)`'
- },
- showReady: 'webpack:done'
- })
-
- // Add Legacy aliases
- defineAlias(this, this.resolver, ['resolveAlias', 'resolvePath'])
- this.showReady = () => { this.callHook('webpack:done') }
-
- // Init server
- if (this.options.server !== false) {
- this._initServer()
- }
-
- // Call ready
- if (this.options._ready !== false) {
- this.ready().catch((err) => {
- consola.fatal(err)
- })
- }
- }
-
- static get version () {
- return (global.__NUXT && global.__NUXT.version) || `v${version}`
- }
-
- ready () {
- if (!this._ready) {
- this._ready = this._init()
- }
- return this._ready
- }
-
- async _init () {
- if (this._initCalled) {
- return this
- }
- this._initCalled = true
-
- // Add hooks
- if (isPlainObject(this.options.hooks)) {
- this.addHooks(this.options.hooks)
- } else if (typeof this.options.hooks === 'function') {
- this.options.hooks(this.hook)
- }
-
- // Await for modules
- await this.moduleContainer.ready()
-
- // Await for server to be ready
- if (this.server) {
- await this.server.ready()
- }
-
- // Call ready hook
- await this.callHook('ready', this)
-
- return this
- }
-
- _initServer () {
- if (this.server) {
- return
- }
- this.server = new Server(this)
- this.renderer = this.server
- this.render = this.server.app
- defineAlias(this, this.server, ['renderRoute', 'renderAndGetWindow', 'listen'])
- }
-
- async close (callback) {
- await this.callHook('close', this)
-
- if (typeof callback === 'function') {
- await callback()
- }
-
- this.clearHooks()
- }
-}
diff --git a/packages/core/src/resolver.js b/packages/core/src/resolver.js
deleted file mode 100644
index 087dacaeebca..000000000000
--- a/packages/core/src/resolver.js
+++ /dev/null
@@ -1,183 +0,0 @@
-import { resolve, join } from 'path'
-import fs from 'fs-extra'
-import consola from 'consola'
-import esm from 'esm'
-
-import {
- startsWithRootAlias,
- startsWithSrcAlias,
- isExternalDependency,
- clearRequireCache
-} from '@nuxt/utils'
-
-export default class Resolver {
- constructor (nuxt) {
- this.nuxt = nuxt
- this.options = this.nuxt.options
-
- // Binds
- this.resolvePath = this.resolvePath.bind(this)
- this.resolveAlias = this.resolveAlias.bind(this)
- this.resolveModule = this.resolveModule.bind(this)
- this.requireModule = this.requireModule.bind(this)
-
- // ESM Loader
- this.esm = esm(module)
-
- this._resolve = require.resolve
- }
-
- resolveModule (path) {
- try {
- return this._resolve(path, {
- paths: this.options.modulesDir
- })
- } catch (error) {
- if (error.code !== 'MODULE_NOT_FOUND') {
- // TODO: remove after https://github.com/facebook/jest/pull/8487 released
- if (process.env.NODE_ENV === 'test' && error.message.startsWith('Cannot resolve module')) {
- return
- }
- throw error
- }
- }
- }
-
- resolveAlias (path) {
- if (startsWithRootAlias(path)) {
- return join(this.options.rootDir, path.substr(2))
- }
-
- if (startsWithSrcAlias(path)) {
- return join(this.options.srcDir, path.substr(1))
- }
-
- return resolve(this.options.srcDir, path)
- }
-
- resolvePath (path, { alias, isAlias = alias, module, isModule = module, isStyle } = {}) {
- // TODO: Remove in Nuxt 3
- if (alias) {
- consola.warn('Using alias is deprecated and will be removed in Nuxt 3. Use `isAlias` instead.')
- }
- if (module) {
- consola.warn('Using module is deprecated and will be removed in Nuxt 3. Use `isModule` instead.')
- }
-
- // Fast return in case of path exists
- if (fs.existsSync(path)) {
- return path
- }
-
- let resolvedPath
-
- // Try to resolve it as a regular module
- if (isModule !== false) {
- resolvedPath = this.resolveModule(path)
- }
-
- // Try to resolve alias
- if (!resolvedPath && isAlias !== false) {
- resolvedPath = this.resolveAlias(path)
- }
-
- // Use path for resolvedPath
- if (!resolvedPath) {
- resolvedPath = path
- }
-
- let isDirectory
-
- // Check if resolvedPath exits and is not a directory
- if (fs.existsSync(resolvedPath)) {
- isDirectory = fs.lstatSync(resolvedPath).isDirectory()
-
- if (!isDirectory) {
- return resolvedPath
- }
- }
-
- const extensions = isStyle ? this.options.styleExtensions : this.options.extensions
-
- // Check if any resolvedPath.[ext] or resolvedPath/index.[ext] exists
- for (const ext of extensions) {
- if (!isDirectory && fs.existsSync(resolvedPath + '.' + ext)) {
- return resolvedPath + '.' + ext
- }
-
- const resolvedPathwithIndex = join(resolvedPath, 'index.' + ext)
- if (isDirectory && fs.existsSync(resolvedPathwithIndex)) {
- return resolvedPathwithIndex
- }
- }
-
- // If there's no index.[ext] we just return the directory path
- if (isDirectory) {
- return resolvedPath
- }
-
- // Give up
- throw new Error(`Cannot resolve "${path}" from "${resolvedPath}"`)
- }
-
- requireModule (path, { esm, useESM = esm, alias, isAlias = alias, intropDefault, interopDefault = intropDefault } = {}) {
- let resolvedPath = path
- let requiredModule
-
- // TODO: Remove in Nuxt 3
- if (intropDefault) {
- consola.warn('Using intropDefault is deprecated and will be removed in Nuxt 3. Use `interopDefault` instead.')
- }
- if (alias) {
- consola.warn('Using alias is deprecated and will be removed in Nuxt 3. Use `isAlias` instead.')
- }
- if (esm) {
- consola.warn('Using esm is deprecated and will be removed in Nuxt 3. Use `useESM` instead.')
- }
-
- let lastError
-
- // Try to resolve path
- try {
- resolvedPath = this.resolvePath(path, { isAlias })
- } catch (e) {
- lastError = e
- }
-
- const isExternal = isExternalDependency(resolvedPath)
-
- // in dev mode make sure to clear the require cache so after
- // a dev server restart any changed file is reloaded
- if (this.options.dev && !isExternal) {
- clearRequireCache(resolvedPath)
- }
-
- // By default use esm only for js,mjs files outside of node_modules
- if (useESM === undefined) {
- useESM = !isExternal && /.(js|mjs)$/.test(resolvedPath)
- }
-
- // Try to require
- try {
- if (useESM) {
- requiredModule = this.esm(resolvedPath)
- } else {
- requiredModule = require(resolvedPath)
- }
- } catch (e) {
- lastError = e
- }
-
- // Interop default
- if (interopDefault !== false && requiredModule && requiredModule.default) {
- requiredModule = requiredModule.default
- }
-
- // Throw error if failed to require
- if (requiredModule === undefined && lastError) {
- throw lastError
- }
-
- return requiredModule
- }
-}
diff --git a/packages/core/test/index.test.js b/packages/core/test/index.test.js
deleted file mode 100644
index c5e31a016f82..000000000000
--- a/packages/core/test/index.test.js
+++ /dev/null
@@ -1,17 +0,0 @@
-import { Module, Nuxt, Resolver } from '../src'
-
-jest.mock('../src/module', () => ({
- module: true
-})).mock('../src/nuxt', () => ({
- nuxt: true
-})).mock('../src/resolver', () => ({
- resolver: true
-}))
-
-describe('core: entry', () => {
- test('should export Module, Nuxt and Resolver', () => {
- expect(Module.module).toEqual(true)
- expect(Nuxt.nuxt).toEqual(true)
- expect(Resolver.resolver).toEqual(true)
- })
-})
diff --git a/packages/core/test/module.test.js b/packages/core/test/module.test.js
deleted file mode 100644
index 766d648fe6ed..000000000000
--- a/packages/core/test/module.test.js
+++ /dev/null
@@ -1,478 +0,0 @@
-import fs from 'fs'
-import path from 'path'
-import consola from 'consola'
-import { chainFn } from '@nuxt/utils'
-import ModuleContainer from '../src/module'
-
-jest.mock('fs', () => ({
- existsSync: Boolean,
- closeSync: Boolean,
- realpath: jest.fn()
-}))
-
-jest.mock('hash-sum', () => src => `hash(${src})`)
-
-jest.mock('@nuxt/utils', () => ({
- ...jest.requireActual('@nuxt/utils'),
- chainFn: jest.fn(() => 'chainedFn')
-}))
-
-const defaultOptions = {
- modules: [],
- buildModules: []
-}
-
-describe('core: module', () => {
- const requireModule = jest.fn(src => options => Promise.resolve({ src, options }))
-
- beforeEach(() => {
- consola.debug.mockClear()
- consola.log.mockClear()
- consola.warn.mockClear()
- consola.error.mockClear()
- consola.fatal.mockClear()
- chainFn.mockClear()
- requireModule.mockClear()
- })
-
- test('should construct module container', () => {
- const nuxt = jest.fn()
- nuxt.options = jest.fn()
- const module = new ModuleContainer(nuxt)
-
- expect(module.nuxt).toBe(nuxt)
- expect(module.options).toBe(nuxt.options)
- expect(module.requiredModules).toEqual({})
- })
-
- test('should call hooks and addModule when ready', async () => {
- const nuxt = {
- options: {
- ...defaultOptions,
- modules: [jest.fn(), jest.fn()]
- },
- callHook: jest.fn()
- }
- const module = new ModuleContainer(nuxt)
- module.addModule = jest.fn()
-
- await module.ready()
-
- expect(nuxt.callHook).toBeCalledTimes(2)
- expect(nuxt.callHook).nthCalledWith(1, 'modules:before', module, module.options.modules)
- expect(nuxt.callHook).nthCalledWith(2, 'modules:done', module)
-
- expect(module.addModule).toBeCalledTimes(2)
- expect(module.addModule).nthCalledWith(1, module.options.modules[0])
- expect(module.addModule).nthCalledWith(2, module.options.modules[1])
- })
-
- test('should display deprecated message for addVendor', () => {
- new ModuleContainer({
- ...defaultOptions
- }).addVendor()
-
- expect(consola.warn).toBeCalledTimes(1)
- expect(consola.warn).toBeCalledWith('addVendor has been deprecated due to webpack4 optimization')
- })
-
- test('should add string template', () => {
- const module = new ModuleContainer({
- options: {
- ...defaultOptions,
- build: {
- templates: []
- }
- }
- })
-
- const template = module.addTemplate('/var/nuxt/test')
- const expected = {
- dst: 'nuxt.test.hash(/var/nuxt/test)',
- options: undefined,
- src: '/var/nuxt/test'
- }
- expect(template).toEqual(expected)
- expect(module.options.build.templates).toEqual([expected])
- })
-
- test('should add object template', () => {
- const module = new ModuleContainer({
- options: {
- ...defaultOptions,
- build: {
- templates: []
- }
- }
- })
-
- const template = module.addTemplate({
- src: '/var/nuxt/test',
- options: { test: true }
- })
- const expected = {
- dst: 'nuxt.test.hash(/var/nuxt/test)',
- options: { test: true },
- src: '/var/nuxt/test'
- }
- expect(template).toEqual(expected)
- expect(module.options.build.templates).toEqual([expected])
- })
-
- test('should use filename in preference to calculation', () => {
- const module = new ModuleContainer({
- ...defaultOptions,
- options: {
- build: {
- templates: []
- }
- }
- })
-
- const template = module.addTemplate({
- src: '/var/nuxt/test',
- fileName: '/var/nuxt/dist/test'
- })
- const expected = {
- dst: '/var/nuxt/dist/test',
- options: undefined,
- src: '/var/nuxt/test'
- }
- expect(template).toEqual(expected)
- expect(module.options.build.templates).toEqual([expected])
- })
-
- test('should throw error when template invalid', () => {
- const module = new ModuleContainer({
- options: {
- ...defaultOptions
- }
- })
-
- expect(() => module.addTemplate()).toThrow('Invalid template: undefined')
- })
-
- test('should throw error when template not found', () => {
- const module = new ModuleContainer({
- options: {
- ...defaultOptions
- }
- })
- fs.existsSync = jest.fn(() => false)
-
- expect(() => module.addTemplate('/var/nuxt/test')).toThrow('Template src not found: /var/nuxt/test')
-
- fs.existsSync = jest.fn(Boolean)
- })
-
- test('should add plugin into module', () => {
- const module = new ModuleContainer({
- options: {
- ...defaultOptions,
- buildDir: '/var/nuxt/build',
- plugins: []
- }
- })
- module.addTemplate = jest.fn(() => ({ dst: 'nuxt.test.template' }))
-
- module.addPlugin({ ssr: false, mode: 'client' })
-
- expect(module.options.plugins).toEqual([{
- src: path.join('/var/nuxt/build', 'nuxt.test.template'),
- ssr: false,
- mode: 'client'
- }])
- })
-
- test('should add layout into module', () => {
- const module = new ModuleContainer({
- options: {
- ...defaultOptions,
- layouts: {}
- }
- })
- module.addTemplate = jest.fn(() => ({
- dst: 'nuxt.test.template',
- src: '/var/nuxt/src'
- }))
-
- module.addLayout({}, 'test-layout')
-
- expect(module.options.layouts).toEqual({ 'test-layout': './nuxt.test.template' })
- })
-
- test('should display deprecated message when registration is duplicate', () => {
- const module = new ModuleContainer({
- options: {
- ...defaultOptions,
- layouts: {
- 'test-layout': 'test.template'
- }
- }
- })
- module.addTemplate = jest.fn(() => ({
- dst: 'nuxt.test.template',
- src: '/var/nuxt/src'
- }))
-
- module.addLayout({}, 'test-layout')
-
- expect(consola.warn).toBeCalledTimes(1)
- expect(consola.warn).toBeCalledWith('Duplicate layout registration, "test-layout" has been registered as "test.template"')
- })
-
- test('should register error layout at same time', () => {
- const module = new ModuleContainer({
- options: {
- ...defaultOptions,
- layouts: {}
- }
- })
- module.addErrorLayout = jest.fn()
- module.addTemplate = jest.fn(() => ({
- dst: 'nuxt.test.template',
- src: '/var/nuxt/src'
- }))
-
- module.addLayout({}, 'error')
-
- expect(module.options.layouts).toEqual({ error: './nuxt.test.template' })
- expect(module.addErrorLayout).toBeCalledTimes(1)
- expect(module.addErrorLayout).toBeCalledWith('nuxt.test.template')
- })
-
- test('should add error layout', () => {
- const module = new ModuleContainer({
- options: {
- ...defaultOptions,
- rootDir: '/var/nuxt',
- buildDir: '/var/nuxt/build',
- layouts: {}
- }
- })
-
- module.addErrorLayout('error.template')
-
- expect(module.options.ErrorPage).toEqual('~/build/error.template')
- })
-
- test('should add server middleware', () => {
- const module = new ModuleContainer({
- options: {
- ...defaultOptions,
- serverMiddleware: []
- }
- })
-
- module.addServerMiddleware(() => {})
- module.addServerMiddleware(() => {})
-
- expect(module.options.serverMiddleware).toHaveLength(2)
- expect(module.options.serverMiddleware).toEqual([expect.any(Function), expect.any(Function)])
- })
-
- test('should chain build.extend', () => {
- const extend = () => {}
- const module = new ModuleContainer({
- options: {
- ...defaultOptions,
- build: { extend }
- }
- })
-
- const newExtend = () => {}
- module.extendBuild(newExtend)
-
- expect(chainFn).toBeCalledTimes(1)
- expect(chainFn).toBeCalledWith(extend, newExtend)
- expect(module.options.build.extend).toEqual('chainedFn')
- })
-
- test('should chain router.extendRoutes', () => {
- const extendRoutes = () => {}
- const module = new ModuleContainer({
- options: {
- ...defaultOptions,
- router: { extendRoutes }
- }
- })
-
- const newExtendRoutes = () => {}
- module.extendRoutes(newExtendRoutes)
-
- expect(chainFn).toBeCalledTimes(1)
- expect(chainFn).toBeCalledWith(extendRoutes, newExtendRoutes)
- expect(module.options.router.extendRoutes).toEqual('chainedFn')
- })
-
- test('should call addModule when require module', () => {
- const module = new ModuleContainer({
- options: {
- ...defaultOptions
- }
- })
- module.addModule = jest.fn()
-
- const moduleOpts = {}
- module.requireModule(moduleOpts)
-
- expect(module.addModule).toBeCalledTimes(1)
- expect(module.addModule).toBeCalledWith(moduleOpts, true)
- })
-
- test('should add string module', async () => {
- const module = new ModuleContainer({
- resolver: { requireModule },
- options: {
- ...defaultOptions
- }
- })
-
- const result = await module.addModule('moduleTest')
-
- expect(requireModule).toBeCalledTimes(1)
- expect(requireModule).toBeCalledWith('moduleTest', { useESM: true })
- expect(module.requiredModules).toEqual({
- moduleTest: {
- handler: expect.any(Function),
- options: undefined,
- src: 'moduleTest'
- }
- })
- expect(result).toEqual({ src: 'moduleTest', options: {} })
- })
-
- test('should add function module', async () => {
- const module = new ModuleContainer({
- resolver: { requireModule },
- options: {
- ...defaultOptions
- }
- })
-
- const functionModule = function (options) {
- return Promise.resolve(options)
- }
-
- functionModule.meta = { name: 'moduleTest' }
-
- const result = await module.addModule(functionModule)
-
- expect(requireModule).not.toBeCalled()
- expect(module.requiredModules).toEqual({
- moduleTest: {
- handler: expect.any(Function),
- options: undefined,
- src: functionModule
- }
- })
- expect(result).toEqual({ })
- })
-
- test('should add array module', async () => {
- const module = new ModuleContainer({
- resolver: { requireModule },
- options: {
- ...defaultOptions
- }
- })
-
- const result = await module.addModule(['moduleTest', { test: true }])
-
- expect(requireModule).toBeCalledTimes(1)
- expect(requireModule).toBeCalledWith('moduleTest', { useESM: true })
- expect(module.requiredModules).toEqual({
- moduleTest: {
- handler: expect.any(Function),
- options: {
- test: true
- },
- src: 'moduleTest'
- }
- })
- expect(result).toEqual({ src: 'moduleTest', options: { test: true } })
- })
-
- test('should add object module', async () => {
- const module = new ModuleContainer({
- resolver: { requireModule },
- options: {
- ...defaultOptions
- }
- })
-
- const result = await module.addModule({
- src: 'moduleTest',
- options: { test: true },
- handler: function objectModule (options) {
- return Promise.resolve(options)
- }
- })
-
- expect(requireModule).not.toBeCalled()
- expect(module.requiredModules).toEqual({
- objectModule: {
- handler: expect.any(Function),
- options: {
- test: true
- },
- src: 'moduleTest'
- }
- })
- expect(result).toEqual({ test: true })
- })
-
- test('should throw error when handler is not function', async () => {
- const module = new ModuleContainer({
- resolver: { requireModule: () => false },
- options: {
- ...defaultOptions
- }
- })
-
- await expect(module.addModule('moduleTest')).rejects.toThrow('Module should export a function: moduleTest')
- })
-
- test('should prevent multiple adding when requireOnce is enabled', async () => {
- const module = new ModuleContainer({
- resolver: { requireModule },
- options: {
- ...defaultOptions
- }
- })
-
- const handler = jest.fn(() => true)
- handler.meta = {
- name: 'moduleTest'
- }
-
- const first = await module.addModule({ handler }, true)
- const second = await module.addModule({ handler }, true)
-
- expect(first).toEqual(true)
- expect(second).toBeUndefined()
- expect(handler).toBeCalledTimes(1)
- expect(module.requiredModules.moduleTest).toBeDefined()
- })
-
- test('should prevent adding not installed buildModules', async () => {
- const module = new ModuleContainer({
- resolver: { requireModule },
- options: {
- ...defaultOptions,
- buildModules: ['test-build-module']
- }
- })
-
- requireModule.mockImplementationOnce(() => {
- const moduleNotFound = new Error()
- moduleNotFound.code = 'MODULE_NOT_FOUND'
- throw moduleNotFound
- })
-
- const result = await module.addModule('test-build-module', true)
-
- expect(result).toBeUndefined()
- expect(consola.warn).toBeCalledWith('Module `test-build-module` not found. Please ensure `test-build-module` is in `devDependencies` and installed. HINT: During build step, for npm/yarn, `NODE_ENV=production` or `--production` should NOT be used. Silently ignoring module as programmatic usage detected.')
- })
-})
diff --git a/packages/core/test/nuxt.test.js b/packages/core/test/nuxt.test.js
deleted file mode 100644
index 5d458d12d8ad..000000000000
--- a/packages/core/test/nuxt.test.js
+++ /dev/null
@@ -1,189 +0,0 @@
-import { defineAlias } from '@nuxt/utils'
-import { getNuxtConfig } from '@nuxt/config'
-import { Server } from '@nuxt/server'
-import Hookable from 'hable'
-
-import Nuxt from '../src/nuxt'
-import ModuleContainer from '../src/module'
-import Resolver from '../src/resolver'
-import { version } from '../package.json'
-
-jest.mock('@nuxt/utils')
-
-jest.mock('@nuxt/server')
-
-jest.mock('@nuxt/config', () => ({
- getNuxtConfig: jest.fn(() => ({
- _ready: false
- }))
-}))
-
-describe('core: nuxt', () => {
- beforeEach(() => {
- jest.clearAllMocks()
- })
-
- test('should construct nuxt with options', async () => {
- const options = {}
- const nuxt = new Nuxt(options)
- await nuxt.ready()
-
- expect(nuxt).toBeInstanceOf(Hookable)
- expect(getNuxtConfig).toBeCalledTimes(1)
- expect(getNuxtConfig).toBeCalledWith(options)
-
- expect(nuxt.resolver).toBeInstanceOf(Resolver)
- expect(nuxt.moduleContainer).toBeInstanceOf(ModuleContainer)
- expect(nuxt.server).toBeInstanceOf(Server)
-
- expect(defineAlias).toBeCalledTimes(2)
- expect(defineAlias).nthCalledWith(1, nuxt, nuxt.resolver, ['resolveAlias', 'resolvePath'])
- expect(defineAlias).nthCalledWith(2, nuxt, nuxt.server, ['renderRoute', 'renderAndGetWindow', 'listen'])
-
- expect(nuxt.renderer).toBe(nuxt.server)
- expect(nuxt.render).toBe(nuxt.server.app)
- expect(nuxt.showReady).toBeInstanceOf(Function)
-
- expect(nuxt._ready).toBeInstanceOf(Promise)
- })
-
- // TODO: Remove in next major release
- test('should call hook webpack:done in showReady', () => {
- const nuxt = new Nuxt()
- nuxt.callHook = jest.fn()
-
- nuxt.showReady()
-
- expect(nuxt.callHook).toBeCalledTimes(1)
- expect(nuxt.callHook).toBeCalledWith('webpack:done')
- })
-
- for (const name of ['render:context', 'render:routeContext']) {
- test('should deprecate ' + name, async () => {
- const nuxt = new Nuxt()
- const fn = jest.fn()
- nuxt.hook(name, fn)
- await nuxt.callHook('_render:context')
- expect(fn).toBeCalledTimes(1)
- expect(fn).toBeCalledWith()
- })
- }
-
- test('should display fatal message if ready failed', async () => {
- const err = new Error('nuxt ready failed')
- const nuxt = new Nuxt()
- nuxt._init = () => Promise.reject(err)
- await expect(nuxt.ready()).rejects.toThrow(err)
- })
-
- test('should return nuxt version from package.json', () => {
- expect(Nuxt.version).toEqual(`v${version}`)
- })
-
- test('should return nuxt version from global.__NUXT', () => {
- global.__NUXT = {
- version: 'latest'
- }
-
- expect(Nuxt.version).toEqual('latest')
-
- delete global.__NUXT
- })
-
- test('should call module/server ready in nuxt.ready', async () => {
- const nuxt = new Nuxt()
-
- nuxt.callHook = jest.fn()
- nuxt.server = { ready: jest.fn() }
- nuxt.moduleContainer = { ready: jest.fn() }
-
- const result = await nuxt.ready()
-
- expect(result).toBe(nuxt)
- expect(nuxt.moduleContainer.ready).toBeCalledTimes(1)
- expect(nuxt.server.ready).toBeCalledTimes(1)
- expect(nuxt._initCalled).toEqual(true)
- expect(nuxt.callHook).toBeCalledTimes(1)
- expect(nuxt.callHook).toBeCalledWith('ready', nuxt)
- })
-
- test('should ignore ready when _ready exists', async () => {
- const nuxt = new Nuxt()
- const _ready = nuxt._ready = jest.fn()
- const result = await nuxt.ready()
- expect(result).toBe(_ready)
- })
-
- test('should add object hooks', async () => {
- const hooks = {}
- getNuxtConfig.mockReturnValueOnce({ hooks, _ready: false })
- const nuxt = new Nuxt()
-
- nuxt.addHooks = jest.fn()
- nuxt.server = { ready: jest.fn() }
- nuxt.moduleContainer = { ready: jest.fn() }
-
- await nuxt.ready()
-
- expect(nuxt.addHooks).toBeCalledTimes(1)
- expect(nuxt.addHooks).toBeCalledWith(hooks)
- })
-
- test('should add function hooks', async () => {
- const hooks = jest.fn()
- getNuxtConfig.mockReturnValueOnce({ hooks })
- const nuxt = new Nuxt()
-
- nuxt.addHooks = jest.fn()
- nuxt.server = { ready: jest.fn() }
- nuxt.moduleContainer = { ready: jest.fn() }
-
- await nuxt.ready()
-
- expect(nuxt.addHooks).not.toBeCalled()
- expect(hooks).toBeCalledTimes(1)
- })
-
- test('should close nuxt with hook triggered', async () => {
- const nuxt = new Nuxt()
- nuxt.callHook = jest.fn()
- nuxt.clearHooks = jest.fn()
-
- const cb = jest.fn()
- await nuxt.close(cb)
-
- expect(cb).toBeCalledTimes(1)
- expect(nuxt.callHook).toBeCalledTimes(1)
- expect(nuxt.callHook).toBeCalledWith('close', nuxt)
- expect(nuxt.clearHooks).toBeCalledTimes(1)
- })
-
- test('should ignore non-function callback in close', async () => {
- const nuxt = new Nuxt()
-
- nuxt.callHook = jest.fn()
- nuxt.server = { ready: jest.fn() }
- nuxt.moduleContainer = { ready: jest.fn() }
-
- const result = await nuxt.ready()
-
- expect(result).toBe(nuxt)
- expect(nuxt.moduleContainer.ready).toBeCalledTimes(1)
- expect(nuxt.server.ready).toBeCalledTimes(1)
- expect(nuxt._initCalled).toEqual(true)
- expect(nuxt.callHook).toBeCalledTimes(1)
- expect(nuxt.callHook).toBeCalledWith('ready', nuxt)
- })
-
- test('should ignore non-function callback in close', async () => {
- const nuxt = new Nuxt()
- nuxt.callHook = jest.fn()
- nuxt.clearHooks = jest.fn()
-
- const cb = {}
- await nuxt.close(cb)
-
- expect(nuxt.callHook).toBeCalledTimes(1)
- expect(nuxt.clearHooks).toBeCalledTimes(1)
- })
-})
diff --git a/packages/core/test/resolver.test.js b/packages/core/test/resolver.test.js
deleted file mode 100644
index bf89d201a17f..000000000000
--- a/packages/core/test/resolver.test.js
+++ /dev/null
@@ -1,456 +0,0 @@
-import path from 'path'
-import esm from 'esm'
-import fs from 'fs-extra'
-import consola from 'consola'
-import { startsWithRootAlias, startsWithSrcAlias } from '@nuxt/utils'
-
-import Resolver from '../src/resolver'
-
-jest.mock('esm', () => jest.fn(() => jest.fn()))
-jest.mock('fs-extra')
-jest.mock('@nuxt/utils')
-
-jest.spyOn(path, 'join')
-jest.spyOn(path, 'resolve')
-
-describe.posix('core: resolver', () => {
- beforeEach(() => {
- jest.clearAllMocks()
- })
-
- test('should construct resolver', () => {
- const nuxt = jest.fn()
- nuxt.options = jest.fn()
- const resolver = new Resolver(nuxt)
-
- expect(resolver.nuxt).toBe(nuxt)
- expect(resolver.options).toBe(nuxt.options)
- expect(resolver.resolvePath).toBeInstanceOf(Function)
- expect(resolver.resolveAlias).toBeInstanceOf(Function)
- expect(resolver.resolveModule).toBeInstanceOf(Function)
- expect(resolver.requireModule).toBeInstanceOf(Function)
- expect(resolver.esm).toEqual(expect.any(Function))
- expect(esm).toBeCalledTimes(1)
- })
-
- test('should call require.resolve in resolveModule', () => {
- const resolver = new Resolver({
- options: { modulesDir: '/var/nuxt/node_modules' }
- })
- const resolve = resolver._resolve = jest.fn(() => '/var/nuxt/resolver/module')
-
- const modulePath = resolver.resolveModule('/var/nuxt/resolver')
-
- expect(modulePath).toEqual('/var/nuxt/resolver/module')
- expect(resolve).toBeCalledTimes(1)
- expect(resolve).toBeCalledWith('/var/nuxt/resolver', { paths: '/var/nuxt/node_modules' })
- })
-
- test('should return undefined when module is not found', () => {
- const resolver = new Resolver({
- options: { modulesDir: '/var/nuxt/node_modules' }
- })
- const resolve = resolver._resolve = jest.fn(() => {
- const err = new Error()
- err.code = 'MODULE_NOT_FOUND'
- throw err
- })
-
- const modulePath = resolver.resolveModule('/var/nuxt/resolver')
-
- expect(modulePath).toBeUndefined()
- expect(resolve).toBeCalledTimes(1)
- })
-
- test('should throw error when require.resolve failed', () => {
- const resolver = new Resolver({
- options: { modulesDir: '/var/nuxt/node_modules' }
- })
- resolver._resolve = jest.fn(() => { throw new Error('resolve failed') })
-
- expect(() => resolver.resolveModule('/var/nuxt/resolver')).toThrow('resolve failed')
- })
-
- test('should resolve root alias', () => {
- const resolver = new Resolver({
- options: { rootDir: '/var/nuxt' }
- })
- startsWithRootAlias.mockReturnValue(true)
-
- const aliasPath = { substr: jest.fn(p => String(p)) }
- resolver.resolveAlias(aliasPath)
-
- expect(path.join).toBeCalledTimes(1)
- expect(path.join).toBeCalledWith('/var/nuxt', '2')
- expect(aliasPath.substr).toBeCalledTimes(1)
- expect(aliasPath.substr).toBeCalledWith(2)
- })
-
- test('should resolve src alias', () => {
- const resolver = new Resolver({
- options: { srcDir: '/var/nuxt/src' }
- })
- startsWithRootAlias.mockReturnValue(false)
- startsWithSrcAlias.mockReturnValue(true)
-
- const aliasPath = { substr: jest.fn(p => String(p)) }
- resolver.resolveAlias(aliasPath)
-
- expect(path.join).toBeCalledTimes(1)
- expect(path.join).toBeCalledWith('/var/nuxt/src', '1')
- expect(aliasPath.substr).toBeCalledTimes(1)
- expect(aliasPath.substr).toBeCalledWith(1)
- })
-
- test('should resolve other alias', () => {
- const resolver = new Resolver({
- options: { srcDir: '/var/nuxt/src' }
- })
- startsWithRootAlias.mockReturnValue(false)
- startsWithSrcAlias.mockReturnValue(false)
-
- const aliasPath = 'x'
- resolver.resolveAlias(aliasPath)
-
- expect(path.resolve).toBeCalledTimes(1)
- expect(path.resolve).toBeCalledWith('/var/nuxt/src', aliasPath)
- })
-
- describe('core: resolver resolvePath', () => {
- test('should resolve existed path', () => {
- const resolver = new Resolver({
- options: {}
- })
- fs.existsSync = jest.fn(() => true)
-
- const resolvedPath = resolver.resolvePath('/var/nuxt/resolver/file')
-
- expect(fs.existsSync).toBeCalledTimes(1)
- expect(fs.existsSync).toBeCalledWith('/var/nuxt/resolver/file')
- expect(resolvedPath).toEqual('/var/nuxt/resolver/file')
- })
-
- test('should resolve a module path', () => {
- const resolver = new Resolver({
- options: {}
- })
- fs.existsSync = jest.fn(path => path === '/var/nuxt/resolver/module')
- fs.lstatSync = jest.fn(() => ({ isDirectory: () => false }))
- resolver.resolveModule = jest.fn(() => '/var/nuxt/resolver/module')
-
- const resolvedPath = resolver.resolvePath('/var/nuxt/resolver')
-
- expect(fs.existsSync).toBeCalledTimes(2)
- expect(fs.existsSync).nthCalledWith(1, '/var/nuxt/resolver')
- expect(fs.existsSync).nthCalledWith(2, '/var/nuxt/resolver/module')
- expect(fs.lstatSync).toBeCalledTimes(1)
- expect(fs.lstatSync).nthCalledWith(1, '/var/nuxt/resolver/module')
- expect(resolvedPath).toEqual('/var/nuxt/resolver/module')
- })
-
- test('should resolve a alias path', () => {
- const resolver = new Resolver({
- options: {}
- })
- fs.existsSync = jest.fn(path => path === '/var/nuxt/resolver/alias')
- fs.lstatSync = jest.fn(() => ({
- isDirectory: () => false
- }))
- resolver.resolveModule = jest.fn(() => false)
- resolver.resolveAlias = jest.fn(() => '/var/nuxt/resolver/alias')
-
- const resolvedPath = resolver.resolvePath('/var/nuxt/resolver')
-
- expect(fs.existsSync).toBeCalledTimes(2)
- expect(fs.existsSync).nthCalledWith(1, '/var/nuxt/resolver')
- expect(fs.existsSync).nthCalledWith(2, '/var/nuxt/resolver/alias')
- expect(fs.lstatSync).toBeCalledTimes(1)
- expect(fs.lstatSync).nthCalledWith(1, '/var/nuxt/resolver/alias')
- expect(resolvedPath).toEqual('/var/nuxt/resolver/alias')
- })
-
- test('should resolve path with extension', () => {
- const resolver = new Resolver({
- options: {
- extensions: ['js']
- }
- })
- fs.existsSync = jest.fn(path => path === '/var/nuxt/resolver/file.js')
- resolver.resolveModule = jest.fn(() => false)
- resolver.resolveAlias = jest.fn(() => false)
-
- const resolvedPath = resolver.resolvePath('/var/nuxt/resolver/file')
-
- expect(fs.existsSync).toBeCalledTimes(3)
- expect(fs.existsSync).nthCalledWith(1, '/var/nuxt/resolver/file')
- expect(fs.existsSync).nthCalledWith(2, '/var/nuxt/resolver/file')
- expect(fs.existsSync).nthCalledWith(3, '/var/nuxt/resolver/file.js')
- expect(resolvedPath).toEqual('/var/nuxt/resolver/file.js')
- })
-
- test('should resolve module path with extension', () => {
- const resolver = new Resolver({
- options: {
- extensions: ['js']
- }
- })
- fs.existsSync = jest.fn(path => path === '/var/nuxt/resolver/module.js')
- resolver.resolveModule = jest.fn(() => '/var/nuxt/resolver/module')
-
- const resolvedPath = resolver.resolvePath('/var/nuxt/resolver/file')
-
- expect(fs.existsSync).toBeCalledTimes(3)
- expect(fs.existsSync).nthCalledWith(1, '/var/nuxt/resolver/file')
- expect(fs.existsSync).nthCalledWith(2, '/var/nuxt/resolver/module')
- expect(fs.existsSync).nthCalledWith(3, '/var/nuxt/resolver/module.js')
- expect(resolvedPath).toEqual('/var/nuxt/resolver/module.js')
- })
-
- test('should resolve alias path with extension', () => {
- const resolver = new Resolver({
- options: {
- extensions: ['js']
- }
- })
- fs.existsSync = jest.fn(path => path === '/var/nuxt/resolver/alias.js')
- resolver.resolveModule = jest.fn(() => false)
- resolver.resolveAlias = jest.fn(() => '/var/nuxt/resolver/alias')
-
- const resolvedPath = resolver.resolvePath('/var/nuxt/resolver/file')
-
- expect(fs.existsSync).toBeCalledTimes(3)
- expect(fs.existsSync).nthCalledWith(1, '/var/nuxt/resolver/file')
- expect(fs.existsSync).nthCalledWith(2, '/var/nuxt/resolver/alias')
- expect(fs.existsSync).nthCalledWith(3, '/var/nuxt/resolver/alias.js')
- expect(resolvedPath).toEqual('/var/nuxt/resolver/alias.js')
- })
-
- test('should resolve index.[ext] when path is directory', () => {
- const resolver = new Resolver({
- options: {
- extensions: ['js']
- }
- })
- fs.existsSync = jest.fn(path => ['/var/nuxt/resolver/alias', '/var/nuxt/resolver/alias/index.js'].includes(path))
- fs.lstatSync = jest.fn(() => ({ isDirectory: () => true }))
- resolver.resolveModule = jest.fn(() => false)
- resolver.resolveAlias = jest.fn(() => '/var/nuxt/resolver/alias')
-
- const resolvedPath = resolver.resolvePath('/var/nuxt/resolver')
-
- expect(fs.existsSync).toBeCalledTimes(3)
- expect(fs.existsSync).nthCalledWith(1, '/var/nuxt/resolver')
- expect(fs.existsSync).nthCalledWith(2, '/var/nuxt/resolver/alias')
- expect(fs.existsSync).nthCalledWith(3, '/var/nuxt/resolver/alias/index.js')
- expect(resolvedPath).toEqual('/var/nuxt/resolver/alias/index.js')
- })
-
- test('should resolve style path', () => {
- const resolver = new Resolver({
- options: {
- extensions: ['js'],
- styleExtensions: ['css', 'scss']
- }
- })
- fs.existsSync = jest.fn(path => ['/var/nuxt/resolver/alias', '/var/nuxt/resolver/alias/index.scss'].includes(path))
- fs.lstatSync = jest.fn(path => ({ isDirectory: () => path === '/var/nuxt/resolver/alias' }))
- resolver.resolveModule = jest.fn(() => false)
- resolver.resolveAlias = jest.fn(() => '/var/nuxt/resolver/alias')
-
- const resolvedPath = resolver.resolvePath('/var/nuxt/resolver', { isStyle: true })
-
- expect(fs.existsSync).toBeCalledTimes(4)
- expect(fs.existsSync).nthCalledWith(1, '/var/nuxt/resolver')
- expect(fs.existsSync).nthCalledWith(2, '/var/nuxt/resolver/alias')
- expect(fs.existsSync).nthCalledWith(3, '/var/nuxt/resolver/alias/index.css')
- expect(fs.existsSync).nthCalledWith(4, '/var/nuxt/resolver/alias/index.scss')
- expect(resolvedPath).toEqual('/var/nuxt/resolver/alias/index.scss')
- })
-
- test('should resolve the directory path if no file', () => {
- const resolver = new Resolver({
- options: {
- extensions: ['js', 'vue']
- }
- })
- fs.existsSync = jest.fn(path => path === '/var/nuxt/resolver/alias')
- fs.lstatSync = jest.fn(() => ({ isDirectory: () => true }))
- resolver.resolveModule = jest.fn(() => false)
- resolver.resolveAlias = jest.fn(() => '/var/nuxt/resolver/alias')
-
- const resolvedPath = resolver.resolvePath('/var/nuxt/resolver')
-
- expect(fs.existsSync).toBeCalledTimes(4)
- expect(fs.existsSync).nthCalledWith(1, '/var/nuxt/resolver')
- expect(fs.existsSync).nthCalledWith(2, '/var/nuxt/resolver/alias')
- expect(fs.existsSync).nthCalledWith(3, '/var/nuxt/resolver/alias/index.js')
- expect(fs.existsSync).nthCalledWith(4, '/var/nuxt/resolver/alias/index.vue')
- expect(resolvedPath).toEqual('/var/nuxt/resolver/alias')
- })
-
- test('should throw error if no dir and file', () => {
- const resolver = new Resolver({
- options: {
- extensions: ['js', 'vue']
- }
- })
- fs.existsSync = jest.fn(() => false)
- fs.lstatSync = jest.fn(() => ({ isDirectory: () => false }))
- resolver.resolveModule = jest.fn(() => false)
- resolver.resolveAlias = jest.fn(() => '/var/nuxt/resolver/alias')
-
- const errMsg = 'Cannot resolve "/var/nuxt/resolver/file" from "/var/nuxt/resolver/alias"'
- expect(() => resolver.resolvePath('/var/nuxt/resolver/file')).toThrow(errMsg)
- })
-
- test('should ignore module resolve if isModule is false', () => {
- const resolver = new Resolver({
- options: {}
- })
- fs.existsSync = jest.fn(path => path === '/var/nuxt/resolver/alias')
- resolver.resolveModule = jest.fn(() => '/var/nuxt/resolver/module')
- resolver.resolveAlias = jest.fn(() => '/var/nuxt/resolver/alias')
-
- const resolvedPath = resolver.resolvePath('/var/nuxt/resolver/file', { isModule: false })
-
- expect(fs.existsSync).toBeCalledTimes(2)
- expect(fs.existsSync).nthCalledWith(1, '/var/nuxt/resolver/file')
- expect(fs.existsSync).nthCalledWith(2, '/var/nuxt/resolver/alias')
- expect(resolver.resolveModule).not.toBeCalled()
- expect(resolvedPath).toEqual('/var/nuxt/resolver/alias')
- })
-
- test('should display deprecated alias options', () => {
- const resolver = new Resolver({
- options: {}
- })
- fs.existsSync = jest.fn(() => true)
-
- resolver.resolvePath('/var/nuxt/resolver/file', { alias: true })
- const warnMsg = 'Using alias is deprecated and will be removed in Nuxt 3. Use `isAlias` instead.'
- expect(consola.warn).toBeCalledTimes(1)
- expect(consola.warn).toBeCalledWith(warnMsg)
- })
-
- test('should display deprecated module options', () => {
- const resolver = new Resolver({
- options: {}
- })
- fs.existsSync = jest.fn(() => true)
-
- resolver.resolvePath('/var/nuxt/resolver/file.js', { module: true })
- const warnMsg = 'Using module is deprecated and will be removed in Nuxt 3. Use `isModule` instead.'
- expect(consola.warn).toBeCalledTimes(1)
- expect(consola.warn).toBeCalledWith(warnMsg)
- })
- })
-
- describe('core: resolver resolveModule', () => {
- test('should require es modules with default export', () => {
- const resolver = new Resolver({
- options: {}
- })
- resolver.resolvePath = x => x
- resolver.esm = jest.fn(() => ({ default: 'resolved module' }))
-
- const resolvedModule = resolver.requireModule('/var/nuxt/resolver/module.js')
-
- expect(resolvedModule).toEqual('resolved module')
- })
-
- test('should require es modules without default export', () => {
- const resolver = new Resolver({
- options: {}
- })
- resolver.resolvePath = x => x
- resolver.esm = jest.fn(() => 'resolved module')
-
- const resolvedModule = resolver.requireModule('/var/nuxt/resolver/module.js')
-
- expect(resolvedModule).toEqual('resolved module')
- })
-
- test('should require es modules without default export when interopDefault is disabled', () => {
- const resolver = new Resolver({
- options: {}
- })
- resolver.resolvePath = x => x
- resolver.esm = jest.fn(() => ({ default: 'resolved module' }))
-
- const resolvedModule = resolver.requireModule('/var/nuxt/resolver/module.js', { interopDefault: false })
-
- expect(resolvedModule).toEqual({ default: 'resolved module' })
- })
-
- test('should require common module', () => {
- const resolver = new Resolver({
- options: {}
- })
- resolver.resolvePath = jest.fn(() => 'path')
- resolver.esm = jest.fn(() => ({ default: 'resolved module' }))
-
- const resolvedModule = resolver.requireModule('path', { useESM: false })
-
- expect(resolvedModule).toBe(path)
- })
-
- test('should throw error if resolvePath failed', () => {
- const resolver = new Resolver({
- options: {}
- })
- resolver.resolvePath = jest.fn(() => { throw new Error('resolve failed') })
- resolver.esm = jest.fn(() => undefined)
-
- expect(() => resolver.requireModule('/var/nuxt/resolver/module.js')).toThrow('resolve failed')
- })
-
- test('should throw last error', () => {
- const resolver = new Resolver({
- options: {}
- })
- resolver.resolvePath = jest.fn(() => { throw new Error('resolve failed') })
- resolver.esm = jest.fn(() => { throw new Error('resolve esm failed') })
-
- expect(() => resolver.requireModule('/var/nuxt/resolver/module.js')).toThrow('resolve esm failed')
- })
-
- test('should display deprecated intropDefault options', () => {
- const resolver = new Resolver({
- options: {}
- })
- resolver.resolvePath = x => x
- resolver.esm = jest.fn()
-
- resolver.requireModule('/var/nuxt/resolver/file.js', { intropDefault: true })
- const warnMsg = 'Using intropDefault is deprecated and will be removed in Nuxt 3. Use `interopDefault` instead.'
- expect(consola.warn).toBeCalledTimes(1)
- expect(consola.warn).toBeCalledWith(warnMsg)
- })
-
- test('should display deprecated alias options', () => {
- const resolver = new Resolver({
- options: {}
- })
- resolver.resolvePath = x => x
- resolver.esm = jest.fn()
-
- resolver.requireModule('/var/nuxt/resolver/file.js', { alias: true })
- const warnMsg = 'Using alias is deprecated and will be removed in Nuxt 3. Use `isAlias` instead.'
- expect(consola.warn).toBeCalledTimes(1)
- expect(consola.warn).toBeCalledWith(warnMsg)
- })
-
- test('should display deprecated esm options', () => {
- const resolver = new Resolver({
- options: {}
- })
- resolver.resolvePath = jest.fn().mockReturnValue('/var/nuxt/resolver/file.js')
- resolver.esm = jest.fn()
-
- resolver.requireModule('/var/nuxt/resolver/file.js', { esm: true })
- const warnMsg = 'Using esm is deprecated and will be removed in Nuxt 3. Use `useESM` instead.'
- expect(consola.warn).toBeCalledTimes(1)
- expect(consola.warn).toBeCalledWith(warnMsg)
- })
- })
-})
diff --git a/packages/generator/package.js b/packages/generator/package.js
deleted file mode 100644
index 19d0ef6e2d14..000000000000
--- a/packages/generator/package.js
+++ /dev/null
@@ -1,3 +0,0 @@
-export default {
- build: true
-}
diff --git a/packages/generator/package.json b/packages/generator/package.json
deleted file mode 100644
index ba1e2707bd8a..000000000000
--- a/packages/generator/package.json
+++ /dev/null
@@ -1,20 +0,0 @@
-{
- "name": "@nuxt/generator",
- "version": "2.12.1",
- "repository": "nuxt/nuxt.js",
- "license": "MIT",
- "main": "dist/generator.js",
- "files": [
- "dist"
- ],
- "dependencies": {
- "@nuxt/utils": "2.12.1",
- "chalk": "^3.0.0",
- "consola": "^2.11.3",
- "fs-extra": "^8.1.0",
- "html-minifier": "^4.0.0"
- },
- "publishConfig": {
- "access": "public"
- }
-}
diff --git a/packages/generator/src/generator.js b/packages/generator/src/generator.js
deleted file mode 100644
index c13addf27b17..000000000000
--- a/packages/generator/src/generator.js
+++ /dev/null
@@ -1,293 +0,0 @@
-import path from 'path'
-import Chalk from 'chalk'
-import consola from 'consola'
-import fsExtra from 'fs-extra'
-import htmlMinifier from 'html-minifier'
-
-import { flatRoutes, isString, isUrl, promisifyRoute, waitFor } from '@nuxt/utils'
-
-export default class Generator {
- constructor (nuxt, builder) {
- this.nuxt = nuxt
- this.options = nuxt.options
- this.builder = builder
-
- // Set variables
- this.staticRoutes = path.resolve(this.options.srcDir, this.options.dir.static)
- this.srcBuiltPath = path.resolve(this.options.buildDir, 'dist', 'client')
- this.distPath = this.options.generate.dir
- this.distNuxtPath = path.join(
- this.distPath,
- isUrl(this.options.build.publicPath) ? '' : this.options.build.publicPath
- )
- }
-
- async generate ({ build = true, init = true } = {}) {
- consola.debug('Initializing generator...')
-
- await this.initiate({ build, init })
-
- consola.debug('Preparing routes for generate...')
-
- const routes = await this.initRoutes()
-
- consola.info('Generating pages')
-
- const errors = await this.generateRoutes(routes)
-
- await this.afterGenerate()
-
- // Done hook
- await this.nuxt.callHook('generate:done', this, errors)
-
- return { errors }
- }
-
- async initiate ({ build = true, init = true } = {}) {
- // Wait for nuxt be ready
- await this.nuxt.ready()
-
- // Call before hook
- await this.nuxt.callHook('generate:before', this, this.options.generate)
-
- if (build) {
- // Add flag to set process.static
- this.builder.forGenerate()
-
- // Start build process
- await this.builder.build()
- }
-
- // Initialize dist directory
- if (init) {
- await this.initDist()
- }
- }
-
- async initRoutes (...args) {
- // Resolve config.generate.routes promises before generating the routes
- let generateRoutes = []
- if (this.options.router.mode !== 'hash') {
- try {
- generateRoutes = await promisifyRoute(
- this.options.generate.routes || [],
- ...args
- )
- } catch (e) {
- consola.error('Could not resolve routes')
- throw e // eslint-disable-line no-unreachable
- }
- }
- // Generate only index.html for router.mode = 'hash'
- let routes =
- this.options.router.mode === 'hash'
- ? ['/']
- : flatRoutes(this.options.router.routes)
-
- routes = routes.filter(route => this.options.generate.exclude.every(regex => !regex.test(route)))
-
- routes = this.decorateWithPayloads(routes, generateRoutes)
-
- // extendRoutes hook
- await this.nuxt.callHook('generate:extendRoutes', routes)
-
- return routes
- }
-
- async generateRoutes (routes) {
- const errors = []
-
- // Start generate process
- while (routes.length) {
- let n = 0
- await Promise.all(
- routes
- .splice(0, this.options.generate.concurrency)
- .map(async ({ route, payload }) => {
- await waitFor(n++ * this.options.generate.interval)
- await this.generateRoute({ route, payload, errors })
- })
- )
- }
-
- // Improve string representation for errors
- // TODO: Use consola for more consistency
- errors.toString = () => this._formatErrors(errors)
-
- return errors
- }
-
- _formatErrors (errors) {
- return errors
- .map(({ type, route, error }) => {
- const isHandled = type === 'handled'
- const color = isHandled ? 'yellow' : 'red'
-
- let line = Chalk[color](` ${route}\n\n`)
-
- if (isHandled) {
- line += Chalk.grey(JSON.stringify(error, undefined, 2) + '\n')
- } else {
- line += Chalk.grey(error.stack || error.message || `${error}`)
- }
-
- return line
- })
- .join('\n')
- }
-
- async afterGenerate () {
- const { fallback } = this.options.generate
-
- // Disable SPA fallback if value isn't a non-empty string
- if (typeof fallback !== 'string' || !fallback) {
- return
- }
-
- const fallbackPath = path.join(this.distPath, fallback)
-
- // Prevent conflicts
- if (await fsExtra.exists(fallbackPath)) {
- consola.warn(`SPA fallback was configured, but the configured path (${fallbackPath}) already exists.`)
- return
- }
-
- // Render and write the SPA template to the fallback path
- let { html } = await this.nuxt.server.renderRoute('/', { spa: true })
-
- try {
- html = this.minifyHtml(html)
- } catch (error) {
- consola.warn('HTML minification failed for SPA fallback')
- }
-
- await fsExtra.writeFile(fallbackPath, html, 'utf8')
- }
-
- async initDist () {
- // Clean destination folder
- await fsExtra.remove(this.distPath)
-
- await this.nuxt.callHook('generate:distRemoved', this)
-
- // Copy static and built files
- if (await fsExtra.exists(this.staticRoutes)) {
- await fsExtra.copy(this.staticRoutes, this.distPath)
- }
- await fsExtra.copy(this.srcBuiltPath, this.distNuxtPath)
-
- // Add .nojekyll file to let GitHub Pages add the _nuxt/ folder
- // https://help.github.com/articles/files-that-start-with-an-underscore-are-missing/
- const nojekyllPath = path.resolve(this.distPath, '.nojekyll')
- fsExtra.writeFile(nojekyllPath, '')
-
- await this.nuxt.callHook('generate:distCopied', this)
- }
-
- decorateWithPayloads (routes, generateRoutes) {
- const routeMap = {}
- // Fill routeMap for known routes
- routes.forEach((route) => {
- routeMap[route] = { route, payload: null }
- })
- // Fill routeMap with given generate.routes
- generateRoutes.forEach((route) => {
- // route is either a string or like { route : '/my_route/1', payload: {} }
- const path = isString(route) ? route : route.route
- routeMap[path] = {
- route: path,
- payload: route.payload || null
- }
- })
- return Object.values(routeMap)
- }
-
- async generateRoute ({ route, payload = {}, errors = [] }) {
- let html
- const pageErrors = []
-
- try {
- const res = await this.nuxt.server.renderRoute(route, {
- _generate: true,
- payload
- })
- ;({ html } = res)
- if (res.error) {
- pageErrors.push({ type: 'handled', route, error: res.error })
- }
- } catch (err) {
- pageErrors.push({ type: 'unhandled', route, error: err })
- errors.push(...pageErrors)
-
- await this.nuxt.callHook('generate:routeFailed', {
- route,
- errors: pageErrors
- })
- consola.error(this._formatErrors(pageErrors))
-
- return false
- }
-
- try {
- html = this.minifyHtml(html)
- } catch (err) {
- const minifyErr = new Error(
- `HTML minification failed. Make sure the route generates valid HTML. Failed HTML:\n ${html}`
- )
- pageErrors.push({ type: 'unhandled', route, error: minifyErr })
- }
-
- let fileName
-
- if (this.options.generate.subFolders) {
- fileName = path.join(route, path.sep, 'index.html') // /about -> /about/index.html
- fileName = fileName === '/404/index.html' ? '/404.html' : fileName // /404 -> /404.html
- } else {
- const normalizedRoute = route.replace(/\/$/, '')
- fileName = route.length > 1 ? path.join(path.sep, normalizedRoute + '.html') : path.join(path.sep, 'index.html')
- }
-
- // Call hook to let user update the path & html
- const page = { route, path: fileName, html }
- await this.nuxt.callHook('generate:page', page)
-
- page.path = path.join(this.distPath, page.path)
-
- // Make sure the sub folders are created
- await fsExtra.mkdirp(path.dirname(page.path))
- await fsExtra.writeFile(page.path, page.html, 'utf8')
-
- await this.nuxt.callHook('generate:routeCreated', {
- route,
- path: page.path,
- errors: pageErrors
- })
-
- if (pageErrors.length) {
- consola.error('Error generating ' + route)
- errors.push(...pageErrors)
- } else {
- consola.success('Generated ' + route)
- }
-
- return true
- }
-
- minifyHtml (html) {
- let minificationOptions = this.options.build.html.minify
-
- // Legacy: Override minification options with generate.minify if present
- // TODO: Remove in Nuxt version 3
- if (typeof this.options.generate.minify !== 'undefined') {
- minificationOptions = this.options.generate.minify
- consola.warn('generate.minify has been deprecated and will be removed in the next major version.' +
- ' Use build.html.minify instead!')
- }
-
- if (!minificationOptions) {
- return html
- }
-
- return htmlMinifier.minify(html, minificationOptions)
- }
-}
diff --git a/packages/generator/src/index.js b/packages/generator/src/index.js
deleted file mode 100644
index 6e420c7e35e8..000000000000
--- a/packages/generator/src/index.js
+++ /dev/null
@@ -1,6 +0,0 @@
-import Generator from './generator'
-export { default as Generator } from './generator'
-
-export function getGenerator (nuxt) {
- return new Generator(nuxt)
-}
diff --git a/packages/generator/test/__utils__/index.js b/packages/generator/test/__utils__/index.js
deleted file mode 100644
index a83a706acf69..000000000000
--- a/packages/generator/test/__utils__/index.js
+++ /dev/null
@@ -1,14 +0,0 @@
-export const createNuxt = () => ({
- ready: jest.fn(),
- callHook: jest.fn(),
- server: {
- renderRoute: jest.fn(() => ({ html: 'rendered html' }))
- },
- options: {
- srcDir: '/var/nuxt/src',
- buildDir: '/var/nuxt/build',
- generate: { dir: '/var/nuxt/generate' },
- build: { publicPath: '__public' },
- dir: { static: '/var/nuxt/static' }
- }
-})
diff --git a/packages/generator/test/generator.gen.test.js b/packages/generator/test/generator.gen.test.js
deleted file mode 100644
index fb2752515c6e..000000000000
--- a/packages/generator/test/generator.gen.test.js
+++ /dev/null
@@ -1,220 +0,0 @@
-import path from 'path'
-import chalk from 'chalk'
-import consola from 'consola'
-import fsExtra from 'fs-extra'
-import { waitFor } from '@nuxt/utils'
-
-import Generator from '../src/generator'
-import { createNuxt } from './__utils__'
-
-jest.mock('path')
-jest.mock('chalk', () => ({
- red: jest.fn(str => `red:${str}`),
- yellow: jest.fn(str => `yellow:${str}`),
- grey: jest.fn(str => `grey:${str}`)
-}))
-jest.mock('fs-extra')
-jest.mock('@nuxt/utils')
-
-describe('generator: generate routes', () => {
- const sep = path.sep
-
- beforeAll(() => {
- path.sep = '[sep]'
- path.join.mockImplementation((...args) => `join(${args.join(', ')})`)
- })
-
- afterAll(() => {
- path.sep = sep
- })
-
- beforeEach(() => {
- jest.clearAllMocks()
- })
-
- test('should generate with build and init by default', async () => {
- const nuxt = createNuxt()
- const builder = jest.fn()
- const generator = new Generator(nuxt, builder)
-
- const routes = ['routes']
- const errors = ['errors']
- generator.initiate = jest.fn()
- generator.initRoutes = jest.fn(() => routes)
- generator.generateRoutes = jest.fn(() => errors)
- generator.afterGenerate = jest.fn()
-
- await generator.generate()
-
- expect(consola.debug).toBeCalledTimes(2)
- expect(consola.debug).nthCalledWith(1, 'Initializing generator...')
- expect(consola.debug).nthCalledWith(2, 'Preparing routes for generate...')
- expect(generator.initiate).toBeCalledTimes(1)
- expect(generator.initiate).toBeCalledWith({ build: true, init: true })
- expect(generator.initRoutes).toBeCalledTimes(1)
- expect(consola.info).toBeCalledTimes(1)
- expect(consola.info).toBeCalledWith('Generating pages')
- expect(generator.generateRoutes).toBeCalledTimes(1)
- expect(generator.generateRoutes).toBeCalledWith(routes)
- expect(generator.afterGenerate).toBeCalledTimes(1)
- expect(nuxt.callHook).toBeCalledTimes(1)
- expect(nuxt.callHook).toBeCalledWith('generate:done', generator, errors)
- })
-
- test('should generate without build and init when disabled', async () => {
- const nuxt = createNuxt()
- const builder = jest.fn()
- const generator = new Generator(nuxt, builder)
-
- const routes = ['routes']
- const errors = ['errors']
- generator.initiate = jest.fn()
- generator.initRoutes = jest.fn(() => routes)
- generator.generateRoutes = jest.fn(() => errors)
- generator.afterGenerate = jest.fn()
-
- await generator.generate({ build: false, init: false })
-
- expect(generator.initiate).toBeCalledTimes(1)
- expect(generator.initiate).toBeCalledWith({ build: false, init: false })
- })
-
- test('should generate routes', async () => {
- const nuxt = createNuxt()
- nuxt.options.generate = {
- ...nuxt.options.generate,
- concurrency: 2,
- interval: 100
- }
- const routes = [
- { route: '/index', payload: { param: 'test-index' } },
- { route: '/about', payload: { param: 'test-about' } },
- { route: '/foo', payload: { param: 'test-foo' } },
- { route: '/bar', payload: { param: 'test-bar' } },
- { route: '/baz', payload: { param: 'test-baz' } }
- ]
- const generator = new Generator(nuxt)
-
- generator.generateRoute = jest.fn()
- jest.spyOn(routes, 'splice')
-
- const errors = await generator.generateRoutes(routes)
-
- expect(routes.splice).toBeCalledTimes(3)
- expect(routes.splice).toBeCalledWith(0, 2)
- expect(waitFor).toBeCalledTimes(5)
- expect(waitFor).nthCalledWith(1, 0)
- expect(waitFor).nthCalledWith(2, 100)
- expect(waitFor).nthCalledWith(3, 0)
- expect(waitFor).nthCalledWith(4, 100)
- expect(waitFor).nthCalledWith(5, 0)
- expect(generator.generateRoute).toBeCalledTimes(5)
- expect(generator.generateRoute).nthCalledWith(1, { route: '/index', payload: { param: 'test-index' }, errors })
- expect(generator.generateRoute).nthCalledWith(2, { route: '/about', payload: { param: 'test-about' }, errors })
- expect(generator.generateRoute).nthCalledWith(3, { route: '/foo', payload: { param: 'test-foo' }, errors })
- expect(generator.generateRoute).nthCalledWith(4, { route: '/bar', payload: { param: 'test-bar' }, errors })
- expect(generator.generateRoute).nthCalledWith(5, { route: '/baz', payload: { param: 'test-baz' }, errors })
-
- generator._formatErrors = jest.fn()
- errors.toString()
-
- expect(generator._formatErrors).toBeCalledTimes(1)
- expect(generator._formatErrors).toBeCalledWith(errors)
-
- routes.splice.mockRestore()
- })
-
- test('should format errors', () => {
- const nuxt = createNuxt()
- const generator = new Generator(nuxt)
-
- const errors = generator._formatErrors([
- { type: 'handled', route: '/foo', error: 'foo failed' },
- { type: 'unhandled', route: '/bar', error: { stack: 'bar failed' } }
- ])
-
- expect(chalk.yellow).toBeCalledTimes(1)
- expect(chalk.yellow).toBeCalledWith(' /foo\n\n')
- expect(chalk.red).toBeCalledTimes(1)
- expect(chalk.red).toBeCalledWith(' /bar\n\n')
- expect(chalk.grey).toBeCalledTimes(2)
- expect(chalk.grey).nthCalledWith(1, '"foo failed"\n')
- expect(chalk.grey).nthCalledWith(2, 'bar failed')
- expect(errors).toEqual(`yellow: /foo
-
-grey:"foo failed"
-
-red: /bar
-
-grey:bar failed`)
- })
-
- test('should write fallback html after generate', async () => {
- const nuxt = createNuxt()
- nuxt.options.generate.fallback = 'fallback.html'
- const generator = new Generator(nuxt)
- path.join.mockClear()
- fsExtra.exists.mockReturnValueOnce(false)
-
- await generator.afterGenerate()
-
- expect(path.join).toBeCalledTimes(1)
- expect(path.join).toBeCalledWith(generator.distPath, 'fallback.html')
- expect(fsExtra.exists).toBeCalledTimes(1)
- expect(fsExtra.exists).toBeCalledWith(`join(${generator.distPath}, fallback.html)`)
- expect(nuxt.server.renderRoute).toBeCalledTimes(1)
- expect(nuxt.server.renderRoute).toBeCalledWith('/', { spa: true })
- expect(fsExtra.writeFile).toBeCalledTimes(1)
- expect(fsExtra.writeFile).toBeCalledWith(`join(${generator.distPath}, fallback.html)`, 'rendered html', 'utf8')
- })
-
- test('should disable writing fallback if fallback is empty or not string', async () => {
- const nuxt = createNuxt()
- const generator = new Generator(nuxt)
- path.join.mockClear()
-
- nuxt.options.generate.fallback = ''
- await generator.afterGenerate()
-
- nuxt.options.generate.fallback = jest.fn()
- await generator.afterGenerate()
-
- expect(path.join).not.toBeCalled()
- expect(fsExtra.exists).not.toBeCalled()
- expect(nuxt.server.renderRoute).not.toBeCalled()
- expect(fsExtra.writeFile).not.toBeCalled()
- })
-
- test('should disable writing fallback if fallback path is not existed', async () => {
- const nuxt = createNuxt()
- nuxt.options.generate.fallback = 'fallback.html'
- const generator = new Generator(nuxt)
- path.join.mockClear()
- fsExtra.exists.mockReturnValueOnce(true)
-
- await generator.afterGenerate()
-
- expect(path.join).toBeCalledTimes(1)
- expect(path.join).toBeCalledWith(generator.distPath, 'fallback.html')
- expect(fsExtra.exists).toBeCalledTimes(1)
- expect(fsExtra.exists).toBeCalledWith(`join(${generator.distPath}, fallback.html)`)
- expect(nuxt.server.renderRoute).not.toBeCalled()
- expect(fsExtra.writeFile).not.toBeCalled()
- })
-
- test('should disable writing fallback if fallback is empty or not string', async () => {
- const nuxt = createNuxt()
- const generator = new Generator(nuxt)
- path.join.mockClear()
-
- nuxt.options.generate.fallback = ''
- await generator.afterGenerate()
-
- nuxt.options.generate.fallback = jest.fn()
- await generator.afterGenerate()
-
- expect(path.join).not.toBeCalled()
- expect(fsExtra.exists).not.toBeCalled()
- expect(fsExtra.writeFile).not.toBeCalled()
- })
-})
diff --git a/packages/generator/test/generator.init.test.js b/packages/generator/test/generator.init.test.js
deleted file mode 100644
index 23e6cba71cd1..000000000000
--- a/packages/generator/test/generator.init.test.js
+++ /dev/null
@@ -1,228 +0,0 @@
-import path from 'path'
-import consola from 'consola'
-import fsExtra from 'fs-extra'
-import { flatRoutes, isString, isUrl, promisifyRoute } from '@nuxt/utils'
-
-import Generator from '../src/generator'
-import { createNuxt } from './__utils__'
-
-jest.mock('path')
-jest.mock('fs-extra')
-jest.mock('@nuxt/utils')
-
-describe('generator: initialize', () => {
- beforeAll(() => {
- isString.mockImplementation(str => typeof str === 'string')
- path.join.mockImplementation((...args) => `join(${args.join(', ')})`)
- path.resolve.mockImplementation((...args) => `resolve(${args.join(', ')})`)
- })
-
- beforeEach(() => {
- jest.clearAllMocks()
- })
-
- test('should construct Generator', () => {
- isUrl.mockReturnValueOnce(true)
- const nuxt = createNuxt()
- nuxt.options = {
- ...nuxt.options,
- build: { publicPath: 'http://localhost:3000' }
- }
- const builder = jest.fn()
- const generator = new Generator(nuxt, builder)
-
- expect(generator.nuxt).toBe(nuxt)
- expect(generator.options).toBe(nuxt.options)
- expect(generator.builder).toBe(builder)
- expect(generator.staticRoutes).toEqual('resolve(/var/nuxt/src, /var/nuxt/static)')
- expect(generator.srcBuiltPath).toBe('resolve(/var/nuxt/build, dist, client)')
- expect(generator.distPath).toBe('/var/nuxt/generate')
- expect(generator.distNuxtPath).toBe('join(/var/nuxt/generate, )')
- })
-
- test('should append publicPath to distPath if publicPath is not url', () => {
- isUrl.mockReturnValueOnce(false)
- const nuxt = createNuxt()
- nuxt.options = {
- ...nuxt.options,
- build: { publicPath: '__public' }
- }
- const builder = jest.fn()
- const generator = new Generator(nuxt, builder)
-
- expect(generator.distNuxtPath).toBe('join(/var/nuxt/generate, __public)')
- })
-
- test('should initiate with build and init by default', async () => {
- const nuxt = createNuxt()
- const builder = { forGenerate: jest.fn(), build: jest.fn() }
- const generator = new Generator(nuxt, builder)
-
- generator.initDist = jest.fn()
-
- await generator.initiate()
-
- expect(nuxt.ready).toBeCalledTimes(1)
- expect(nuxt.callHook).toBeCalledTimes(1)
- expect(nuxt.callHook).toBeCalledWith('generate:before', generator, { dir: generator.distPath })
- expect(builder.forGenerate).toBeCalledTimes(1)
- expect(builder.build).toBeCalledTimes(1)
- expect(generator.initDist).toBeCalledTimes(1)
- })
-
- test('should initiate without build and init if disabled', async () => {
- const nuxt = createNuxt()
- const builder = { forGenerate: jest.fn(), build: jest.fn() }
- const generator = new Generator(nuxt, builder)
-
- generator.initDist = jest.fn()
-
- await generator.initiate({ build: false, init: false })
-
- expect(nuxt.ready).toBeCalledTimes(1)
- expect(nuxt.callHook).toBeCalledTimes(1)
- expect(nuxt.callHook).toBeCalledWith('generate:before', generator, { dir: generator.distPath })
- expect(builder.forGenerate).not.toBeCalled()
- expect(builder.build).not.toBeCalled()
- expect(generator.initDist).not.toBeCalled()
- })
-
- test('should init routes with generate.routes and router.routes', async () => {
- const nuxt = createNuxt()
- nuxt.options = {
- ...nuxt.options,
- generate: {
- ...nuxt.options.generate,
- exclude: [/test/],
- routes: ['/foo', '/foo/bar']
- },
- router: {
- mode: 'history',
- routes: ['/index', '/about', '/test']
- }
- }
- const generator = new Generator(nuxt)
-
- flatRoutes.mockImplementationOnce(routes => routes)
- promisifyRoute.mockImplementationOnce(routes => routes)
- generator.decorateWithPayloads = jest.fn(() => 'decoratedRoutes')
-
- const routes = await generator.initRoutes()
-
- expect(promisifyRoute).toBeCalledTimes(1)
- expect(promisifyRoute).toBeCalledWith(['/foo', '/foo/bar'])
- expect(flatRoutes).toBeCalledTimes(1)
- expect(flatRoutes).toBeCalledWith(['/index', '/about', '/test'])
- expect(generator.decorateWithPayloads).toBeCalledTimes(1)
- expect(generator.decorateWithPayloads).toBeCalledWith(['/index', '/about'], ['/foo', '/foo/bar'])
- expect(nuxt.callHook).toBeCalledTimes(1)
- expect(nuxt.callHook).toBeCalledWith('generate:extendRoutes', 'decoratedRoutes')
- expect(routes).toEqual('decoratedRoutes')
- })
-
- test('should init routes with hash mode', async () => {
- const nuxt = createNuxt()
- nuxt.options = {
- ...nuxt.options,
- generate: {
- ...nuxt.options.generate,
- exclude: [/test/],
- routes: ['/foo', '/foo/bar']
- },
- router: {
- mode: 'hash',
- routes: ['/index', '/about', '/test']
- }
- }
- const generator = new Generator(nuxt)
-
- flatRoutes.mockImplementationOnce(routes => routes)
- promisifyRoute.mockImplementationOnce(routes => routes)
- generator.decorateWithPayloads = jest.fn(() => 'decoratedRoutes')
-
- const routes = await generator.initRoutes()
-
- expect(promisifyRoute).not.toBeCalled()
- expect(flatRoutes).not.toBeCalled()
- expect(generator.decorateWithPayloads).toBeCalledTimes(1)
- expect(generator.decorateWithPayloads).toBeCalledWith(['/'], [])
- expect(nuxt.callHook).toBeCalledTimes(1)
- expect(nuxt.callHook).toBeCalledWith('generate:extendRoutes', 'decoratedRoutes')
- expect(routes).toEqual('decoratedRoutes')
-
- promisifyRoute.mockReset()
- flatRoutes.mockReset()
- })
-
- test('should throw error when route can not be resolved', async () => {
- const nuxt = createNuxt()
- nuxt.options.router = { mode: 'history' }
- const generator = new Generator(nuxt)
-
- promisifyRoute.mockImplementationOnce(() => {
- throw new Error('promisifyRoute failed')
- })
-
- await expect(generator.initRoutes()).rejects.toThrow('promisifyRoute failed')
-
- expect(promisifyRoute).toBeCalledTimes(1)
- expect(promisifyRoute).toBeCalledWith([])
- expect(consola.error).toBeCalledTimes(1)
- expect(consola.error).toBeCalledWith('Could not resolve routes')
- })
-
- test('should initialize destination folder', async () => {
- const nuxt = createNuxt()
- nuxt.options.generate.fallback = 'fallback.html'
- const generator = new Generator(nuxt)
- path.join.mockClear()
- path.resolve.mockClear()
- fsExtra.exists.mockReturnValueOnce(false)
-
- await generator.initDist()
-
- expect(fsExtra.remove).toBeCalledTimes(1)
- expect(fsExtra.remove).toBeCalledWith(generator.distPath)
- expect(nuxt.callHook).toBeCalledTimes(2)
- expect(nuxt.callHook).nthCalledWith(1, 'generate:distRemoved', generator)
- expect(fsExtra.exists).toBeCalledTimes(1)
- expect(fsExtra.exists).toBeCalledWith(generator.staticRoutes)
- expect(fsExtra.copy).toBeCalledTimes(1)
- expect(fsExtra.copy).toBeCalledWith(generator.srcBuiltPath, generator.distNuxtPath)
- expect(path.resolve).toBeCalledTimes(1)
- expect(path.resolve).toBeCalledWith(generator.distPath, '.nojekyll')
- expect(fsExtra.writeFile).toBeCalledTimes(1)
- expect(fsExtra.writeFile).toBeCalledWith(`resolve(${generator.distPath}, .nojekyll)`, '')
- expect(nuxt.callHook).nthCalledWith(2, 'generate:distCopied', generator)
- })
-
- test('should copy static routes if path exists', async () => {
- const nuxt = createNuxt()
- nuxt.options.generate.fallback = 'fallback.html'
- const generator = new Generator(nuxt)
- fsExtra.exists.mockReturnValueOnce(true)
-
- await generator.initDist()
-
- expect(fsExtra.copy).toBeCalledTimes(2)
- expect(fsExtra.copy).nthCalledWith(1, generator.staticRoutes, generator.distPath)
- expect(fsExtra.copy).nthCalledWith(2, generator.srcBuiltPath, generator.distNuxtPath)
- })
-
- test('should decorate routes with payloads', () => {
- const nuxt = createNuxt()
- const generator = new Generator(nuxt)
-
- const routes = ['/index', '/about', '/test']
- const generateRoutes = ['/foo', { route: '/foo/bar', payload: { param: 'foo bar' } }]
- const routeMap = generator.decorateWithPayloads(routes, generateRoutes)
-
- expect(routeMap).toEqual([
- { payload: null, route: '/index' },
- { payload: null, route: '/about' },
- { payload: null, route: '/test' },
- { payload: null, route: '/foo' },
- { payload: { param: 'foo bar' }, route: '/foo/bar' }
- ])
- })
-})
diff --git a/packages/generator/test/generator.route.test.js b/packages/generator/test/generator.route.test.js
deleted file mode 100644
index 7fe50091a80e..000000000000
--- a/packages/generator/test/generator.route.test.js
+++ /dev/null
@@ -1,244 +0,0 @@
-import path from 'path'
-import consola from 'consola'
-import fsExtra from 'fs-extra'
-import htmlMinifier from 'html-minifier'
-
-import Generator from '../src/generator'
-import { createNuxt } from './__utils__'
-
-jest.mock('path')
-jest.mock('fs-extra')
-jest.mock('html-minifier')
-jest.mock('@nuxt/utils')
-
-describe('generator: generate route', () => {
- const sep = path.sep
-
- beforeAll(() => {
- path.sep = '[sep]'
- path.join.mockImplementation((...args) => `join(${args.join(', ')})`)
- path.dirname.mockImplementation((...args) => `dirname(${args.join(', ')})`)
- })
-
- afterAll(() => {
- path.sep = sep
- })
-
- beforeEach(() => {
- jest.clearAllMocks()
- })
-
- test('should generate route', async () => {
- const nuxt = createNuxt()
- nuxt.options.build.html = { minify: false }
- nuxt.options.generate.minify = undefined
- nuxt.options.generate.subFolders = false
- const generator = new Generator(nuxt)
- path.join.mockClear()
-
- const route = '/foo/'
- const payload = {}
- const errors = []
-
- const returned = await generator.generateRoute({ route, payload, errors })
-
- expect(nuxt.server.renderRoute).toBeCalledTimes(1)
- expect(nuxt.server.renderRoute).toBeCalledWith('/foo/', { _generate: true, payload })
- expect(path.join).toBeCalledTimes(2)
- expect(path.join).nthCalledWith(1, '[sep]', '/foo.html')
- expect(path.join).nthCalledWith(2, generator.distPath, 'join([sep], /foo.html)')
- expect(nuxt.callHook).toBeCalledTimes(2)
- expect(nuxt.callHook).nthCalledWith(1, 'generate:page', {
- route,
- html: 'rendered html',
- path: `join(${generator.distPath}, join([sep], /foo.html))`
- })
- expect(nuxt.callHook).nthCalledWith(2, 'generate:routeCreated', {
- route,
- errors: [],
- path: `join(${generator.distPath}, join([sep], /foo.html))`
- })
- expect(fsExtra.mkdirp).toBeCalledTimes(1)
- expect(fsExtra.mkdirp).toBeCalledWith(`dirname(join(${generator.distPath}, join([sep], /foo.html)))`)
- expect(fsExtra.writeFile).toBeCalledTimes(1)
- expect(fsExtra.writeFile).toBeCalledWith(`join(${generator.distPath}, join([sep], /foo.html))`, 'rendered html', 'utf8')
- expect(returned).toEqual(true)
- })
-
- test('should create unhandled error if render route has any exception', async () => {
- const nuxt = createNuxt()
- const error = new Error('render route failed')
- nuxt.server.renderRoute.mockImplementationOnce(() => {
- throw error
- })
- const generator = new Generator(nuxt)
- generator._formatErrors = jest.fn(() => 'formatted errors')
-
- const route = '/foo'
- const payload = {}
- const errors = []
-
- const returned = await generator.generateRoute({ route, payload, errors })
-
- expect(nuxt.server.renderRoute).toBeCalledTimes(1)
- expect(nuxt.server.renderRoute).toBeCalledWith('/foo', { _generate: true, payload })
- expect(nuxt.callHook).toBeCalledTimes(1)
- expect(nuxt.callHook).toBeCalledWith('generate:routeFailed', {
- route,
- errors: [{ type: 'unhandled', route, error }]
- })
- expect(generator._formatErrors).toBeCalledTimes(1)
- expect(generator._formatErrors).toBeCalledWith([{ type: 'unhandled', route, error }])
- expect(consola.error).toBeCalledTimes(1)
- expect(consola.error).toBeCalledWith('formatted errors')
- expect(errors).toEqual([{
- error,
- route,
- type: 'unhandled'
- }])
- expect(returned).toEqual(false)
- })
-
- test('should create handled error if render route failed', async () => {
- const nuxt = createNuxt()
- nuxt.options.build.html = { minify: false }
- nuxt.options.generate.minify = undefined
- const error = new Error('render route failed')
- nuxt.server.renderRoute.mockReturnValueOnce({
- html: 'renderer html',
- error
- })
- const generator = new Generator(nuxt)
-
- const route = '/foo'
- const payload = {}
- const errors = []
-
- const returned = await generator.generateRoute({ route, payload, errors })
-
- expect(consola.error).toBeCalledTimes(1)
- expect(consola.error).toBeCalledWith('Error generating /foo')
- expect(errors).toEqual([{
- error,
- route,
- type: 'handled'
- }])
- expect(returned).toEqual(true)
- })
-
- test('should warn generate.minify deprecation message', async () => {
- const nuxt = createNuxt()
- nuxt.options.build.html = { minify: false }
- nuxt.options.generate.minify = false
- const generator = new Generator(nuxt)
-
- const route = '/foo'
-
- const returned = await generator.generateRoute({ route })
-
- expect(consola.warn).toBeCalledTimes(1)
- expect(consola.warn).toBeCalledWith(
- 'generate.minify has been deprecated and will be removed in the next major version. Use build.html.minify instead!'
- )
- expect(returned).toEqual(true)
- })
-
- test('should minify generated html', async () => {
- const nuxt = createNuxt()
- nuxt.options.build.html = { minify: { value: 'test-minify' } }
- nuxt.options.generate.minify = undefined
- const generator = new Generator(nuxt)
- htmlMinifier.minify.mockReturnValueOnce('minified rendered html')
-
- const route = '/foo'
-
- const returned = await generator.generateRoute({ route })
-
- expect(htmlMinifier.minify).toBeCalledTimes(1)
- expect(htmlMinifier.minify).toBeCalledWith('rendered html', { value: 'test-minify' })
- expect(fsExtra.writeFile).toBeCalledTimes(1)
- expect(fsExtra.writeFile).toBeCalledWith(`join(${generator.distPath}, join([sep], /foo.html))`, 'minified rendered html', 'utf8')
- expect(returned).toEqual(true)
- })
-
- test('should create unhandled error if minify failed', async () => {
- const nuxt = createNuxt()
- nuxt.options.build.html = { minify: { value: 'test-minify' } }
- nuxt.options.generate.minify = undefined
- const generator = new Generator(nuxt)
- htmlMinifier.minify.mockImplementationOnce(() => {
- throw new Error('minify html failed')
- })
-
- const route = '/foo'
- const errors = []
-
- const returned = await generator.generateRoute({ route, errors })
-
- expect(htmlMinifier.minify).toBeCalledTimes(1)
- expect(htmlMinifier.minify).toBeCalledWith('rendered html', { value: 'test-minify' })
- expect(errors).toEqual([{
- route,
- type: 'unhandled',
- error: new Error('HTML minification failed. Make sure the route generates valid HTML. Failed HTML:\n rendered html')
- }])
- expect(returned).toEqual(true)
- })
-
- test('should generate file in sub folder', async () => {
- const nuxt = createNuxt()
- nuxt.options.build.html = { minify: false }
- nuxt.options.generate.subFolders = true
- const generator = new Generator(nuxt)
- path.join.mockClear()
-
- const route = '/foo'
-
- const returned = await generator.generateRoute({ route })
-
- expect(path.join).toBeCalledTimes(2)
- expect(path.join).nthCalledWith(1, route, '[sep]', 'index.html')
- expect(path.join).nthCalledWith(2, generator.distPath, 'join(/foo, [sep], index.html)')
- expect(fsExtra.writeFile).toBeCalledTimes(1)
- expect(fsExtra.writeFile).toBeCalledWith(`join(${generator.distPath}, join(/foo, [sep], index.html))`, 'rendered html', 'utf8')
- expect(returned).toEqual(true)
- })
-
- test('should generate 404 file in flat folder', async () => {
- const nuxt = createNuxt()
- nuxt.options.build.html = { minify: false }
- nuxt.options.generate.subFolders = true
- const generator = new Generator(nuxt)
- path.join.mockClear()
- path.join.mockReturnValueOnce('/404/index.html')
-
- const route = '/404'
-
- const returned = await generator.generateRoute({ route })
-
- expect(path.join).toBeCalledTimes(2)
- expect(path.join).nthCalledWith(1, route, '[sep]', 'index.html')
- expect(path.join).nthCalledWith(2, generator.distPath, '/404.html')
- expect(fsExtra.writeFile).toBeCalledTimes(1)
- expect(fsExtra.writeFile).toBeCalledWith(`join(${generator.distPath}, /404.html)`, 'rendered html', 'utf8')
- expect(returned).toEqual(true)
- })
-
- test('should generate file in flat folder if route is empty', async () => {
- const nuxt = createNuxt()
- nuxt.options.build.html = { minify: false }
- const generator = new Generator(nuxt)
- path.join.mockClear()
-
- const route = ''
-
- const returned = await generator.generateRoute({ route })
-
- expect(path.join).toBeCalledTimes(2)
- expect(path.join).nthCalledWith(1, '[sep]', 'index.html')
- expect(path.join).nthCalledWith(2, generator.distPath, 'join([sep], index.html)')
- expect(fsExtra.writeFile).toBeCalledTimes(1)
- expect(fsExtra.writeFile).toBeCalledWith(`join(${generator.distPath}, join([sep], index.html))`, 'rendered html', 'utf8')
- expect(returned).toEqual(true)
- })
-})
diff --git a/packages/generator/test/index.test.js b/packages/generator/test/index.test.js
deleted file mode 100644
index 4c5a70b22d93..000000000000
--- a/packages/generator/test/index.test.js
+++ /dev/null
@@ -1,11 +0,0 @@
-import { Generator } from '../src'
-
-jest.mock('../src/generator', () => ({
- generator: true
-}))
-
-describe('generator: entry', () => {
- test('should export Generator', () => {
- expect(Generator.generator).toEqual(true)
- })
-})
diff --git a/packages/kit/.attw.json b/packages/kit/.attw.json
new file mode 100644
index 000000000000..ac2579855eb0
--- /dev/null
+++ b/packages/kit/.attw.json
@@ -0,0 +1,3 @@
+{
+ "ignoreRules": ["cjs-resolves-to-esm"]
+}
diff --git a/packages/kit/.gitignore b/packages/kit/.gitignore
new file mode 100644
index 000000000000..c4d83b97fd45
--- /dev/null
+++ b/packages/kit/.gitignore
@@ -0,0 +1 @@
+/schema
diff --git a/packages/kit/build.config.ts b/packages/kit/build.config.ts
new file mode 100644
index 000000000000..16fb8725d584
--- /dev/null
+++ b/packages/kit/build.config.ts
@@ -0,0 +1,25 @@
+import { defineBuildConfig } from 'obuild/config'
+
+export default defineBuildConfig({
+ entries: [
+ {
+ type: 'bundle',
+ input: 'src/index',
+ dts: { oxc: true },
+ rolldown: {
+ external: [
+ '@rspack/core',
+ '@nuxt/schema',
+ 'nitro/types',
+ 'nitropack/types',
+ 'webpack',
+ 'vite',
+ 'unimport',
+ /^nuxt(\/|$)/,
+ /^#build\//,
+ /^#internal\//,
+ ],
+ },
+ },
+ ],
+})
diff --git a/packages/kit/package.json b/packages/kit/package.json
new file mode 100644
index 000000000000..df23772881c3
--- /dev/null
+++ b/packages/kit/package.json
@@ -0,0 +1,65 @@
+{
+ "name": "@nuxt/kit",
+ "version": "4.3.1",
+ "repository": {
+ "type": "git",
+ "url": "git+https://github.com/nuxt/nuxt.git",
+ "directory": "packages/kit"
+ },
+ "homepage": "https://nuxt.com/docs/4.x/api/kit",
+ "description": "Toolkit for authoring modules and interacting with Nuxt",
+ "license": "MIT",
+ "type": "module",
+ "types": "./dist/index.d.mts",
+ "exports": {
+ ".": "./dist/index.mjs",
+ "./package.json": "./package.json"
+ },
+ "files": [
+ "dist"
+ ],
+ "scripts": {
+ "prepack": "obuild",
+ "build:stub": "obuild --stub",
+ "test:attw": "attw --pack"
+ },
+ "dependencies": {
+ "c12": "^3.3.4",
+ "consola": "^3.4.2",
+ "defu": "^6.1.7",
+ "destr": "^2.0.5",
+ "errx": "^0.1.0",
+ "exsolve": "^1.0.8",
+ "ignore": "^7.0.5",
+ "jiti": "^2.7.0",
+ "klona": "^2.0.6",
+ "mlly": "^1.8.2",
+ "nypm": "^0.6.6",
+ "ohash": "^2.0.11",
+ "pathe": "^2.0.3",
+ "pkg-types": "^2.3.1",
+ "rc9": "^3.0.1",
+ "scule": "^1.3.0",
+ "semver": "^7.8.0",
+ "tinyglobby": "^0.2.16",
+ "ufo": "^1.6.4",
+ "unctx": "^2.5.0",
+ "untyped": "^2.0.0"
+ },
+ "devDependencies": {
+ "@nuxt/schema": "workspace:*",
+ "@rspack/core": "2.0.3",
+ "@types/semver": "7.7.1",
+ "hookable": "6.1.1",
+ "nitro": "3.0.260311-beta",
+ "nitropack": "2.13.4",
+ "obuild": "0.4.36",
+ "unimport": "6.3.0",
+ "vite": "8.0.12",
+ "vitest": "4.1.7",
+ "webpack": "5.106.2"
+ },
+ "engines": {
+ "node": ">=18.12.0"
+ }
+}
diff --git a/packages/kit/src/build.ts b/packages/kit/src/build.ts
new file mode 100644
index 000000000000..163d8453dca9
--- /dev/null
+++ b/packages/kit/src/build.ts
@@ -0,0 +1,229 @@
+import type { Configuration as WebpackConfig, WebpackPluginInstance } from 'webpack'
+import type { RspackPluginInstance } from '@rspack/core'
+import type { UserConfig as ViteConfig, Plugin as VitePlugin } from 'vite'
+import { useNuxt } from './context.ts'
+import { toArray } from './utils.ts'
+import { resolveAlias } from './resolve.ts'
+import { getUserCaller, warn } from './internal/trace.ts'
+
+type Arrayable<T> = T | T[]
+type Thenable<T> = T | Promise<T>
+
+export interface ExtendConfigOptions {
+ /**
+ * Install plugin on dev
+ * @default true
+ */
+ dev?: boolean
+ /**
+ * Install plugin on build
+ * @default true
+ */
+ build?: boolean
+ /**
+ * Install plugin on server side
+ * @default true
+ */
+ server?: boolean
+ /**
+ * Install plugin on client side
+ * @default true
+ */
+ client?: boolean
+ /**
+ * Prepends the plugin to the array with `unshift()` instead of `push()`.
+ */
+ prepend?: boolean
+}
+
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type
+export interface ExtendWebpackConfigOptions extends ExtendConfigOptions {}
+
+export interface ExtendViteConfigOptions extends Omit<ExtendConfigOptions, 'server' | 'client'> {
+ /**
+ * Extend server Vite configuration
+ * @default true
+ * @deprecated calling \`extendViteConfig\` with only server/client environment is deprecated.
+ * Nuxt 5+ uses the Vite Environment API which shares a configuration between environments.
+ * You can likely use a Vite plugin to achieve the same result.
+ */
+ server?: boolean
+ /**
+ * Extend client Vite configuration
+ * @default true
+ * @deprecated calling \`extendViteConfig\` with only server/client environment is deprecated.
+ * Nuxt 5+ uses the Vite Environment API which shares a configuration between environments.
+ * You can likely use a Vite plugin to achieve the same result.
+ */
+ client?: boolean
+}
+
+const extendWebpackCompatibleConfig = (builder: 'rspack' | 'webpack') => (fn: ((config: WebpackConfig) => Thenable<void>), options: ExtendWebpackConfigOptions = {}) => {
+ const nuxt = useNuxt()
+
+ if (options.dev === false && nuxt.options.dev) {
+ return
+ }
+ if (options.build === false && nuxt.options.build) {
+ return
+ }
+
+ nuxt.hook(`${builder}:config`, async (configs) => {
+ if (options.server !== false) {
+ const config = configs.find(i => i.name === 'server')
+ if (config) {
+ await fn(config)
+ }
+ }
+ if (options.client !== false) {
+ const config = configs.find(i => i.name === 'client')
+ if (config) {
+ await fn(config)
+ }
+ }
+ })
+}
+
+type ExtendWebpacklikeConfig = (fn: (config: WebpackConfig) => void, options?: ExtendWebpackConfigOptions) => void
+
+/**
+ * Extend webpack config
+ *
+ * The fallback function might be called multiple times
+ * when applying to both client and server builds.
+ */
+export const extendWebpackConfig: ExtendWebpacklikeConfig = extendWebpackCompatibleConfig('webpack')
+/**
+ * Extend rspack config
+ *
+ * The fallback function might be called multiple times
+ * when applying to both client and server builds.
+ */
+export const extendRspackConfig: ExtendWebpacklikeConfig = extendWebpackCompatibleConfig('rspack')
+
+/**
+ * Extend Vite config
+ */
+export function extendViteConfig (fn: ((config: ViteConfig) => Thenable<void>), options: ExtendViteConfigOptions = {}): (() => void) | undefined {
+ const nuxt = useNuxt()
+
+ if (options.dev === false && nuxt.options.dev) {
+ return
+ }
+ if (options.build === false && nuxt.options.build) {
+ return
+ }
+
+ // eslint-disable-next-line @typescript-eslint/no-deprecated
+ if (options.server === false || options.client === false) {
+ const caller = getUserCaller()
+ const explanation = caller ? ` (used at \`${resolveAlias(caller.source)}:${caller.line}:${caller.column}\`)` : ''
+ const warning = `[@nuxt/kit] calling \`extendViteConfig\` with only server/client environment is deprecated${explanation}. Nuxt 5+ will use the Vite Environment API which shares a configuration between environments. You can likely use a Vite plugin to achieve the same result.`
+ warn(warning)
+ }
+
+ // Call fn() only once
+ return nuxt.hook('vite:extend', ({ config }) => fn(config))
+}
+
+/**
+ * Append webpack plugin to the config.
+ */
+export function addWebpackPlugin (pluginOrGetter: Arrayable<WebpackPluginInstance> | (() => Thenable<Arrayable<WebpackPluginInstance>>), options?: ExtendWebpackConfigOptions): void {
+ extendWebpackConfig(async (config) => {
+ const method: 'push' | 'unshift' = options?.prepend ? 'unshift' : 'push'
+ const plugin = typeof pluginOrGetter === 'function' ? await pluginOrGetter() : pluginOrGetter
+
+ config.plugins ||= []
+ config.plugins[method](...toArray(plugin))
+ }, options)
+}
+/**
+ * Append rspack plugin to the config.
+ */
+export function addRspackPlugin (pluginOrGetter: Arrayable<RspackPluginInstance> | (() => Thenable<Arrayable<RspackPluginInstance>>), options?: ExtendWebpackConfigOptions): void {
+ extendRspackConfig(async (config) => {
+ const method: 'push' | 'unshift' = options?.prepend ? 'unshift' : 'push'
+ const plugin = typeof pluginOrGetter === 'function' ? await pluginOrGetter() : pluginOrGetter
+
+ config.plugins ||= []
+ config.plugins[method](...toArray(plugin))
+ }, options)
+}
+
+/**
+ * Append Vite plugin to the config.
+ */
+export function addVitePlugin (pluginOrGetter: Arrayable<VitePlugin> | (() => Thenable<Arrayable<VitePlugin>>), options: ExtendConfigOptions = {}): void {
+ const nuxt = useNuxt()
+
+ if (options.dev === false && nuxt.options.dev) {
+ return
+ }
+ if (options.build === false && nuxt.options.build) {
+ return
+ }
+
+ let needsEnvInjection = false
+ nuxt.hook('vite:extend', async ({ config }) => {
+ config.plugins ||= []
+
+ const plugin = toArray(typeof pluginOrGetter === 'function' ? await pluginOrGetter() : pluginOrGetter)
+ if (options.server !== false && options.client !== false) {
+ const method: 'push' | 'unshift' = options?.prepend ? 'unshift' : 'push'
+ config.plugins[method](...plugin)
+ return
+ }
+
+ if (!config.environments?.ssr || !config.environments.client) {
+ needsEnvInjection = true
+ return
+ }
+
+ const environmentName = options.server === false ? 'client' : 'ssr'
+ const pluginName = plugin.map(p => p.name).join('|')
+ config.plugins.push({
+ name: `${pluginName}:wrapper`,
+ enforce: options?.prepend ? 'pre' : 'post',
+ applyToEnvironment (environment) {
+ if (environment.name === environmentName) {
+ return plugin
+ }
+ },
+ })
+ })
+
+ nuxt.hook('vite:extendConfig', async (config, env) => {
+ if (!needsEnvInjection) {
+ return
+ }
+ const plugin = toArray(typeof pluginOrGetter === 'function' ? await pluginOrGetter() : pluginOrGetter)
+ const method: 'push' | 'unshift' = options?.prepend ? 'unshift' : 'push'
+ if (env.isClient && options.server === false) {
+ config.plugins
+ }
+ if (env.isServer && options.client === false) {
+ config.plugins
+ }
+ })
+}
+
+interface AddBuildPluginFactory {
+ vite?: () => Thenable<Arrayable<VitePlugin>>
+ webpack?: () => Thenable<Arrayable<WebpackPluginInstance>>
+ rspack?: () => Thenable<Arrayable<RspackPluginInstance>>
+}
+
+export function addBuildPlugin (pluginFactory: AddBuildPluginFactory, options?: ExtendConfigOptions): void {
+ if (pluginFactory.vite) {
+ addVitePlugin(pluginFactory.vite, options)
+ }
+
+ if (pluginFactory.webpack) {
+ addWebpackPlugin(pluginFactory.webpack, options)
+ }
+
+ if (pluginFactory.rspack) {
+ addRspackPlugin(pluginFactory.rspack, options)
+ }
+}
diff --git a/packages/kit/src/compatibility.ts b/packages/kit/src/compatibility.ts
new file mode 100644
index 000000000000..ae9a1b8f7a12
--- /dev/null
+++ b/packages/kit/src/compatibility.ts
@@ -0,0 +1,130 @@
+import satisfies from 'semver/functions/satisfies.js' // npm/node-semver#381
+import { readPackageJSON } from 'pkg-types'
+import type { Nuxt, NuxtCompatibility, NuxtCompatibilityIssues } from '@nuxt/schema'
+import { useNuxt } from './context.ts'
+
+const SEMANTIC_VERSION_RE = /-\d+\.[0-9a-f]+/
+export function normalizeSemanticVersion (version: string): string {
+ return version.replace(SEMANTIC_VERSION_RE, '') // Remove edge prefix
+}
+
+const builderMap = {
+ '@nuxt/rspack-builder': 'rspack',
+ '@nuxt/vite-builder': 'vite',
+ '@nuxt/webpack-builder': 'webpack',
+}
+
+export function checkNuxtVersion (version: string, nuxt: Nuxt = useNuxt()): boolean {
+ const nuxtVersion = getNuxtVersion(nuxt)
+ return satisfies(normalizeSemanticVersion(nuxtVersion), version, { includePrerelease: true })
+}
+
+/**
+ * Check version constraints and return incompatibility issues as an array
+ */
+export async function checkNuxtCompatibility (constraints: NuxtCompatibility, nuxt: Nuxt = useNuxt()): Promise<NuxtCompatibilityIssues> {
+ const issues: NuxtCompatibilityIssues = []
+
+ // Nuxt version check
+ if (constraints.nuxt) {
+ const nuxtVersion = getNuxtVersion(nuxt)
+ if (!checkNuxtVersion(constraints.nuxt, nuxt)) {
+ issues.push({
+ name: 'nuxt',
+ message: `Nuxt version \`${constraints.nuxt}\` is required but currently using \`${nuxtVersion}\``,
+ })
+ }
+ }
+
+ // Builder compatibility check
+ if (constraints.builder && typeof nuxt.options.builder === 'string') {
+ const currentBuilder = builderMap[nuxt.options.builder] || nuxt.options.builder
+ if (currentBuilder in constraints.builder) {
+ const constraint = constraints.builder[currentBuilder]!
+ if (constraint === false) {
+ issues.push({
+ name: 'builder',
+ message: `Not compatible with \`${nuxt.options.builder}\`.`,
+ })
+ } else {
+ for (const parent of [nuxt.options.rootDir, nuxt.options.workspaceDir, import.meta.url]) {
+ const builderVersion = await readPackageJSON(nuxt.options.builder, { parent }).then(r => r.version).catch(() => undefined)
+ if (builderVersion) {
+ if (!satisfies(normalizeSemanticVersion(builderVersion), constraint, { includePrerelease: true })) {
+ issues.push({
+ name: 'builder',
+ message: `Not compatible with \`${builderVersion}\` of \`${currentBuilder}\`. This module requires \`${constraint}\`.`,
+ })
+ }
+ break
+ }
+ }
+ }
+ }
+ }
+
+ // Allow extending compatibility checks
+ await nuxt.callHook('kit:compatibility', constraints, issues)
+
+ // Issues formatter
+ issues.toString = () =>
+ issues.map(issue => ` - [${issue.name}] ${issue.message}`).join('\n')
+
+ return issues
+}
+
+/**
+ * Check version constraints and throw a detailed error if has any, otherwise returns true
+ */
+export async function assertNuxtCompatibility (constraints: NuxtCompatibility, nuxt: Nuxt = useNuxt()): Promise<true> {
+ const issues = await checkNuxtCompatibility(constraints, nuxt)
+ if (issues.length) {
+ throw new Error('Nuxt compatibility issues found:\n' + issues.toString())
+ }
+ return true
+}
+
+/**
+ * Check version constraints and return true if passed, otherwise returns false
+ */
+export async function hasNuxtCompatibility (constraints: NuxtCompatibility, nuxt: Nuxt = useNuxt()): Promise<boolean> {
+ const issues = await checkNuxtCompatibility(constraints, nuxt)
+ return !issues.length
+}
+
+export type NuxtMajorVersion = 2 | 3 | 4
+
+/**
+ * Check if current Nuxt instance is of specified major version
+ */
+export function isNuxtMajorVersion (majorVersion: NuxtMajorVersion, nuxt: Nuxt = useNuxt()): boolean {
+ const version = getNuxtVersion(nuxt)
+
+ return version[0] === majorVersion.toString() && version[1] === '.'
+}
+
+/**
+ * @deprecated Use `isNuxtMajorVersion(2, nuxt)` instead. This may be removed in \@nuxt/kit v5 or a future major version.
+ */
+export function isNuxt2 (nuxt: Nuxt = useNuxt()): boolean {
+ return isNuxtMajorVersion(2, nuxt)
+}
+
+/**
+ * @deprecated Use `isNuxtMajorVersion(3, nuxt)` instead. This may be removed in \@nuxt/kit v5 or a future major version.
+ */
+export function isNuxt3 (nuxt: Nuxt = useNuxt()): boolean {
+ return isNuxtMajorVersion(3, nuxt)
+}
+
+const NUXT_VERSION_RE = /^v/g
+/**
+ * Get nuxt version
+ */
+export function getNuxtVersion (nuxt: Nuxt | any = useNuxt() /* TODO: LegacyNuxt */): string {
+ const rawVersion = nuxt?._version || nuxt?.version || nuxt?.constructor?.version
+ if (typeof rawVersion !== 'string') {
+ throw new TypeError('Cannot determine nuxt version! Is current instance passed?')
+ }
+ return rawVersion.replace(NUXT_VERSION_RE, '')
+}
diff --git a/packages/kit/src/components.ts b/packages/kit/src/components.ts
new file mode 100644
index 000000000000..8631a223eb1f
--- /dev/null
+++ b/packages/kit/src/components.ts
@@ -0,0 +1,101 @@
+import { kebabCase, pascalCase } from 'scule'
+import type { Component, ComponentsDir } from '@nuxt/schema'
+import { resolveModuleExportNames } from 'mlly'
+
+import { useNuxt } from './context.ts'
+import { logger } from './logger.ts'
+import { resolvePath } from './resolve.ts'
+import { MODE_RE } from './utils.ts'
+
+/**
+ * Register a directory to be scanned for components and imported only when used.
+ */
+export function addComponentsDir (dir: ComponentsDir, opts: { prepend?: boolean } = {}): void {
+ const nuxt = useNuxt()
+ nuxt.options.components ||= []
+ dir.priority ||= 0
+ nuxt.hook('components:dirs', (dirs) => { dirs[opts.prepend ? 'unshift' : 'push'](dir) })
+}
+
+export type AddComponentOptions = { name: string, filePath: string } & Partial<Exclude<Component,
+'shortPath' | 'async' | 'level' | 'import' | 'asyncImport'
+>>
+
+/**
+ * This utility takes a file path or npm package that is scanned for named exports, which are get added automatically
+ */
+export function addComponentExports (opts: Omit<AddComponentOptions, 'name'> & { prefix?: string }): void {
+ const nuxt = useNuxt()
+ const components: Component[] = []
+ nuxt.hook('components:dirs', async () => {
+ const filePath = await resolvePath(opts.filePath)
+
+ const names = await resolveModuleExportNames(filePath, { extensions: nuxt.options.extensions })
+ components.length = 0
+ for (const name of names) {
+ components.push(normalizeComponent({ name: pascalCase([opts.prefix || '', name === 'default' ? '' : name]), export: name, ...opts }))
+ }
+ })
+ addComponents(components)
+}
+
+/**
+ * Register a component by its name and filePath.
+ */
+export function addComponent (opts: AddComponentOptions): void {
+ const component = normalizeComponent(opts)
+ addComponents([component])
+}
+
+function addComponents (addedComponents: Component[]) {
+ const nuxt = useNuxt()
+ nuxt.options.components ||= []
+
+ nuxt.hook('components:extend', (components: Component[]) => {
+ for (const component of addedComponents) {
+ const existingComponentIndex = components.findIndex(c => (c.pascalName === component.pascalName || c.kebabName === component.kebabName) && c.mode === component.mode)
+ if (existingComponentIndex !== -1) {
+ const existingComponent = components[existingComponentIndex]!
+ const existingPriority = existingComponent.priority ?? 0
+ const newPriority = component.priority ?? 0
+
+ if (newPriority < existingPriority) { continue }
+
+ // We override where new component priority is equal or higher
+ // but we warn if they are equal.
+ if (newPriority === existingPriority) {
+ const name = existingComponent.pascalName || existingComponent.kebabName
+ logger.warn(`Overriding ${name} component. You can specify a \`priority\` option when calling \`addComponent\` to avoid this warning.`)
+ }
+ components.splice(existingComponentIndex, 1, component)
+ } else {
+ components.push(component)
+ }
+ }
+ })
+}
+
+function normalizeComponent (opts: AddComponentOptions) {
+ if (!opts.mode) {
+ const [, mode = 'all'] = opts.filePath.match(MODE_RE) || []
+ opts.mode = mode as 'all' | 'client' | 'server'
+ }
+
+ // Apply defaults
+ const component: Component = {
+ export: opts.export || 'default',
+ chunkName: 'components/' + kebabCase(opts.name),
+ global: opts.global ?? false,
+ kebabName: kebabCase(opts.name || ''),
+ pascalName: pascalCase(opts.name || ''),
+ prefetch: false,
+ preload: false,
+ mode: 'all',
+ shortPath: opts.filePath,
+ priority: 0,
+ meta: {},
+ ...opts,
+ }
+
+ return component
+}
diff --git a/packages/kit/src/context.ts b/packages/kit/src/context.ts
new file mode 100644
index 000000000000..a0f39c91f471
--- /dev/null
+++ b/packages/kit/src/context.ts
@@ -0,0 +1,58 @@
+import { AsyncLocalStorage } from 'node:async_hooks'
+import { getContext } from 'unctx'
+import type { UseContext } from 'unctx'
+import type { Nuxt } from '@nuxt/schema'
+
+/**
+ * Direct access to the Nuxt global context - see https://github.com/unjs/unctx.
+ * @deprecated Use `getNuxtCtx` instead
+ */
+export const nuxtCtx: UseContext<Nuxt> = getContext<Nuxt>('nuxt')
+
+/** async local storage for the name of the current nuxt instance */
+const asyncNuxtStorage = getContext<Nuxt>('asyncNuxtStorage', {
+ asyncContext: true,
+ AsyncLocalStorage,
+})
+
+/** Direct access to the Nuxt context with asyncLocalStorage - see https://github.com/unjs/unctx. */
+export const getNuxtCtx = (): Nuxt | null => asyncNuxtStorage.tryUse()
+
+/**
+ * Get access to Nuxt instance.
+ *
+ * Throws an error if Nuxt instance is unavailable.
+ * @example
+ * ```js
+ * const nuxt = useNuxt()
+ * ```
+ */
+export function useNuxt (): Nuxt {
+ // eslint-disable-next-line @typescript-eslint/no-deprecated
+ const instance = asyncNuxtStorage.tryUse() || nuxtCtx.tryUse()
+ if (!instance) {
+ throw new Error('Nuxt instance is unavailable!')
+ }
+ return instance
+}
+
+/**
+ * Get access to Nuxt instance.
+ *
+ * Returns null if Nuxt instance is unavailable.
+ * @example
+ * ```js
+ * const nuxt = tryUseNuxt()
+ * if (nuxt) {
+ * // Do something
+ * }
+ * ```
+ */
+export function tryUseNuxt (): Nuxt | null {
+ // eslint-disable-next-line @typescript-eslint/no-deprecated
+ return asyncNuxtStorage.tryUse() || nuxtCtx.tryUse()
+}
+
+export function runWithNuxtContext<T extends (...args: any[]) => any> (nuxt: Nuxt, fn: T) {
+ return asyncNuxtStorage.call(nuxt, fn) as ReturnType<T>
+}
diff --git a/packages/kit/src/dependency.ts b/packages/kit/src/dependency.ts
new file mode 100644
index 000000000000..acc18a286ba8
--- /dev/null
+++ b/packages/kit/src/dependency.ts
@@ -0,0 +1,111 @@
+import process from 'node:process'
+import { addDependency } from 'nypm'
+import { resolveModulePath } from 'exsolve'
+import { hasTTY, isCI, provider } from 'std-env'
+import { logger } from './logger.ts'
+import { tryUseNuxt } from './context.ts'
+
+const isStackblitz = provider === 'stackblitz'
+
+export interface EnsureDependencyInstalledOptions {
+ rootDir?: string
+ searchPaths?: string[]
+ /**
+ * Additional URL or path to resolve packages from (e.g. `import.meta.url`).
+ * Useful when the calling package ships optional deps as peer dependencies.
+ */
+ from?: string
+ /**
+ * Whether to prompt the user to install the dependency.
+ *
+ * - `true`: always prompt
+ * - `false`: never prompt (install automatically on StackBlitz)
+ * - `undefined`: prompt unless on StackBlitz
+ */
+ prompt?: boolean
+}
+
+/**
+ * Ensure one or more dependencies are installed, prompting the user to install any that are missing.
+ *
+ * When called with a single package name (string), returns `true` if available, `false` if not.
+ *
+ * When called with an array, returns `true` if all are available, or an array of
+ * package names that are still missing (user declined, install failed, or CI).
+ *
+ * @param names - One or more package names to check and potentially install
+ * @param options - Configuration options
+ */
+export async function ensureDependencyInstalled (names: string, options?: EnsureDependencyInstalledOptions): Promise<boolean>
+export async function ensureDependencyInstalled (names: string[], options?: EnsureDependencyInstalledOptions): Promise<true | string[]>
+export async function ensureDependencyInstalled (names: string | string[], options: EnsureDependencyInstalledOptions = {}): Promise<boolean | string[]> {
+ const packages = Array.isArray(names) ? names : [names]
+ const nuxt = tryUseNuxt()
+ const rootDir = options.rootDir || nuxt?.options.rootDir || process.cwd()
+ const searchPaths = options.searchPaths || nuxt?.options.modulesDir || []
+
+ const missing = findMissing(packages, [rootDir, ...options.from ? [options.from] : [], ...searchPaths])
+
+ if (missing.length === 0) {
+ return true
+ }
+
+ const formattedNames = missing.map(n => `\`${n}\``).join(', ')
+ logger.info(`Missing ${missing.length === 1 ? 'package' : 'packages'}: ${formattedNames}`)
+
+ if (isCI) {
+ return Array.isArray(names) ? missing : false
+ }
+
+ if (options.prompt === true || (options.prompt !== false && !isStackblitz)) {
+ if (!hasTTY) {
+ return Array.isArray(names) ? missing : false
+ }
+
+ const shouldInstall = await logger.prompt(`Do you want to install ${formattedNames}?`, {
+ type: 'confirm',
+ initial: true,
+ })
+
+ if (shouldInstall !== true) {
+ return Array.isArray(names) ? missing : false
+ }
+ } else if (!isStackblitz) {
+ // prompt: false should only auto-install on StackBlitz
+ return Array.isArray(names) ? missing : false
+ }
+
+ logger.start(`Installing ${formattedNames}...`)
+ try {
+ await addDependency(missing, {
+ dev: true,
+ cwd: rootDir,
+ silent: true,
+ })
+ logger.success(`Installed ${formattedNames}`)
+ return true
+ } catch (err) {
+ logger.error(err)
+ return Array.isArray(names) ? missing : false
+ }
+}
+
+function findMissing (packages: string[], searchPaths: string[]): string[] {
+ const missing: string[] = []
+ for (const name of packages) {
+ if (isResolvable(name, searchPaths)) {
+ continue
+ }
+ missing.push(name)
+ }
+ return missing
+}
+
+function isResolvable (name: string, searchPaths: string[]): boolean {
+ for (const from of searchPaths) {
+ if (resolveModulePath(name, { from, try: true })) {
+ return true
+ }
+ }
+ return false
+}
diff --git a/packages/kit/src/head.ts b/packages/kit/src/head.ts
new file mode 100644
index 000000000000..0b106816ccf0
--- /dev/null
+++ b/packages/kit/src/head.ts
@@ -0,0 +1,8 @@
+import type { NuxtAppConfig } from '@nuxt/schema'
+import { useNuxt } from './context.ts'
+import { defu } from 'defu'
+
+export function setGlobalHead (head: NuxtAppConfig['head']): void {
+ const nuxt = useNuxt()
+ nuxt.options.app.head = defu(head, nuxt.options.app.head)
+}
diff --git a/packages/kit/src/ignore.test.ts b/packages/kit/src/ignore.test.ts
new file mode 100644
index 000000000000..5137fe4e6176
--- /dev/null
+++ b/packages/kit/src/ignore.test.ts
@@ -0,0 +1,38 @@
+import { describe, expect, it, vi } from 'vitest'
+import type { Nuxt, NuxtConfig } from '@nuxt/schema'
+import { isIgnored, resolveGroupSyntax, resolveIgnorePatterns } from './ignore.ts'
+import * as context from './context.ts'
+
+describe('isIgnored', () => {
+ it('should populate _ignore', () => {
+ const mockNuxt = { options: { ignore: ['my-dir'], _layers: [] } as NuxtConfig } as unknown as Nuxt
+ vi.spyOn(context, 'tryUseNuxt').mockReturnValue(mockNuxt)
+
+ expect(isIgnored('my-dir/my-file.ts')).toBe(true)
+ expect(resolveIgnorePatterns()?.includes('my-dir')).toBe(true)
+ })
+})
+
+describe('resolveGroupSyntax', () => {
+ it('should resolve single group syntax', () => {
+ expect(resolveGroupSyntax('**/*.{spec}.{js,ts}')).toStrictEqual([
+ '**/*.spec.js',
+ '**/*.spec.ts',
+ ])
+ })
+
+ it('should resolve multi-group syntax', () => {
+ expect(resolveGroupSyntax('**/*.{spec,test}.{js,ts}')).toStrictEqual([
+ '**/*.spec.js',
+ '**/*.spec.ts',
+ '**/*.test.js',
+ '**/*.test.ts',
+ ])
+ })
+
+ it('should do nothing with normal globs', () => {
+ expect(resolveGroupSyntax('**/*.spec.js')).toStrictEqual([
+ '**/*.spec.js',
+ ])
+ })
+})
diff --git a/packages/kit/src/ignore.ts b/packages/kit/src/ignore.ts
new file mode 100644
index 000000000000..262f5e7a6cec
--- /dev/null
+++ b/packages/kit/src/ignore.ts
@@ -0,0 +1,105 @@
+import { existsSync, readFileSync } from 'node:fs'
+import ignore from 'ignore'
+import { join, relative, resolve } from 'pathe'
+import { tryUseNuxt } from './context.ts'
+import { getLayerDirectories } from './layers.ts'
+import type { Nuxt } from '@nuxt/schema'
+
+export function createIsIgnored (nuxt: Nuxt | null | undefined = tryUseNuxt()): (pathname: string, stats?: unknown) => boolean {
+ return (pathname, stats) => isIgnored(pathname, stats, nuxt)
+}
+
+// cache of layer root paths sorted by descending length per Nuxt instance.
+const layerRootsCache = new WeakMap<Nuxt, string[]>()
+
+/**
+ * Return a filter function to filter an array of paths
+ */
+export function isIgnored (pathname: string, _stats?: unknown, nuxt: Nuxt | null | undefined = tryUseNuxt()): boolean {
+ // Happens with CLI reloads
+ if (!nuxt) {
+ return false
+ }
+
+ if (!nuxt._ignore) {
+ nuxt._ignore = ignore(nuxt.options.ignoreOptions)
+ nuxt._ignore.add(resolveIgnorePatterns())
+ }
+
+ let cwds = layerRootsCache.get(nuxt)
+ if (!cwds) {
+ cwds = getLayerDirectories(nuxt)
+ .map(dirs => dirs.root)
+ .sort((a, b) => b.length - a.length)
+ layerRootsCache.set(nuxt, cwds)
+ }
+ // layer roots are stored with a trailing slash, so when `pathname`
+ // is below a layer root the relative path is exactly the suffix after
+ // that prefix
+ for (const cwd of cwds) {
+ if (pathname.startsWith(cwd)) {
+ const relativePath = pathname.slice(cwd.length)
+ return !!(relativePath && nuxt._ignore.ignores(relativePath))
+ }
+ }
+ const relativePath = relative(nuxt.options.rootDir, pathname)
+ if (relativePath[0] === '.' && relativePath[1] === '.') {
+ return false
+ }
+ return !!(relativePath && nuxt._ignore.ignores(relativePath))
+}
+
+const NEGATION_RE = /^(!?)(.*)$/
+
+export function resolveIgnorePatterns (relativePath?: string): string[] {
+ const nuxt = tryUseNuxt()
+
+ // Happens with CLI reloads
+ if (!nuxt) {
+ return []
+ }
+
+ const ignorePatterns = nuxt.options.ignore.flatMap(s => resolveGroupSyntax(s))
+
+ const nuxtignoreFile = join(nuxt.options.rootDir, '.nuxtignore')
+ if (existsSync(nuxtignoreFile)) {
+ const contents = readFileSync(nuxtignoreFile, 'utf-8')
+ ignorePatterns.push(...contents.trim().split(/\r?\n/))
+ }
+
+ if (relativePath) {
+ // Map ignore patterns based on if they start with * or !*
+ return ignorePatterns.map((p) => {
+ const [_, negation = '', pattern] = p.match(NEGATION_RE) || []
+ if (pattern && pattern[0] === '*') {
+ return p
+ }
+ return negation + relative(relativePath, resolve(nuxt.options.rootDir, pattern || p))
+ })
+ }
+
+ return ignorePatterns
+}
+
+/**
+ * This function turns string containing groups '**\/*.{spec,test}.{js,ts}' into an array of strings.
+ * For example will '**\/*.{spec,test}.{js,ts}' be resolved to:
+ * ['**\/*.spec.js', '**\/*.spec.ts', '**\/*.test.js', '**\/*.test.ts']
+ * @param group string containing the group syntax
+ * @returns {string[]} array of strings without the group syntax
+ */
+export function resolveGroupSyntax (group: string): string[] {
+ let groups = [group]
+ while (groups.some(group => group.includes('{'))) {
+ groups = groups.flatMap((group) => {
+ const [head, ...tail] = group.split('{')
+ if (tail.length) {
+ const [body = '', ...rest] = tail.join('{').split('}')
+ return body.split(',').map(part => `${head}${part}${rest.join('')}`)
+ }
+
+ return group
+ })
+ }
+ return groups
+}
diff --git a/packages/kit/src/imports.ts b/packages/kit/src/imports.ts
new file mode 100644
index 000000000000..dc23f7aa1a54
--- /dev/null
+++ b/packages/kit/src/imports.ts
@@ -0,0 +1,24 @@
+import type { Import, Preset } from 'unimport'
+import { useNuxt } from './context.ts'
+import { toArray } from './utils.ts'
+
+export function addImports (imports: Import | Import[]): void {
+ useNuxt().hook('imports:extend', (_imports) => {
+ _imports.push(...toArray(imports))
+ })
+}
+
+export function addImportsDir (dirs: string | string[], opts: { prepend?: boolean } = {}): void {
+ useNuxt().hook('imports:dirs', (_dirs: string[]) => {
+ for (const dir of toArray(dirs)) {
+ _dirs[opts.prepend ? 'unshift' : 'push'](dir)
+ }
+ })
+}
+export function addImportsSources (presets: Preset | Preset[]): void {
+ useNuxt().hook('imports:sources', (_presets: Preset[]) => {
+ for (const preset of toArray(presets)) {
+ _presets.push(preset)
+ }
+ })
+}
diff --git a/packages/kit/src/index.ts b/packages/kit/src/index.ts
new file mode 100644
index 000000000000..1142a1ed3ee2
--- /dev/null
+++ b/packages/kit/src/index.ts
@@ -0,0 +1,50 @@
+// Module
+export { defineNuxtModule } from './module/define.ts'
+// eslint-disable-next-line @typescript-eslint/no-deprecated
+export { getDirectory, installModule, installModules, loadNuxtModuleInstance, normalizeModuleTranspilePath, resolveModuleWithOptions } from './module/install.ts'
+export { getNuxtModuleVersion, hasNuxtModule, hasNuxtModuleCompatibility } from './module/compatibility.ts'
+
+// Loader
+export { loadNuxtConfig } from './loader/config.ts'
+export type { LoadNuxtConfigOptions } from './loader/config.ts'
+export { extendNuxtSchema } from './loader/schema.ts'
+export { buildNuxt, loadNuxt } from './loader/nuxt.ts'
+export type { LoadNuxtOptions } from './loader/nuxt.ts'
+
+// Layers
+export { getLayerDirectories } from './layers.ts'
+export type { LayerDirectories } from './layers.ts'
+
+// Utils
+export { setGlobalHead } from './head.ts'
+export { addImports, addImportsDir, addImportsSources } from './imports.ts'
+export { updateRuntimeConfig, useRuntimeConfig } from './runtime-config.ts'
+export { addBuildPlugin, addVitePlugin, addRspackPlugin, addWebpackPlugin, extendViteConfig, extendRspackConfig, extendWebpackConfig } from './build.ts'
+export type { ExtendConfigOptions, ExtendViteConfigOptions, ExtendWebpackConfigOptions } from './build.ts'
+// eslint-disable-next-line @typescript-eslint/no-deprecated
+export { assertNuxtCompatibility, checkNuxtCompatibility, getNuxtVersion, hasNuxtCompatibility, isNuxtMajorVersion, normalizeSemanticVersion, isNuxt2, isNuxt3 } from './compatibility.ts'
+export type { NuxtMajorVersion } from './compatibility.ts'
+export { addComponent, addComponentExports, addComponentsDir } from './components.ts'
+export type { AddComponentOptions } from './components.ts'
+// eslint-disable-next-line @typescript-eslint/no-deprecated
+export { getNuxtCtx, runWithNuxtContext, tryUseNuxt, useNuxt, nuxtCtx } from './context.ts'
+export { createIsIgnored, isIgnored, resolveIgnorePatterns } from './ignore.ts'
+export { addLayout } from './layout.ts'
+export { addRouteMiddleware, extendPages, extendRouteRules } from './pages.ts'
+export type { AddRouteMiddlewareOptions, ExtendRouteRulesOptions } from './pages.ts'
+export { addPlugin, addPluginTemplate, normalizePlugin } from './plugin.ts'
+export type { AddPluginOptions } from './plugin.ts'
+export { createResolver, findPath, resolveAlias, resolveFiles, resolveNuxtModule, resolvePath } from './resolve.ts'
+export type { ResolvePathOptions, Resolver } from './resolve.ts'
+export { addServerHandler, addDevServerHandler, addServerPlugin, addPrerenderRoutes, useNitro, addServerImports, addServerImportsDir, addServerScanDir } from './nitro.ts'
+export { addTemplate, addServerTemplate, addTypeTemplate, normalizeTemplate, updateTemplates, writeTypes } from './template.ts'
+export { logger, useLogger } from './logger.ts'
+
+// Dependencies
+export { ensureDependencyInstalled } from './dependency.ts'
+export type { EnsureDependencyInstalledOptions } from './dependency.ts'
+
+// Internal Utils
+// eslint-disable-next-line @typescript-eslint/no-deprecated
+export { directoryToURL, resolveModule, tryResolveModule, importModule, tryImportModule, requireModule, tryRequireModule } from './internal/esm.ts'
+export type { ImportModuleOptions, ResolveModuleOptions } from './internal/esm.ts'
diff --git a/packages/kit/src/internal/esm.ts b/packages/kit/src/internal/esm.ts
new file mode 100644
index 000000000000..084ba3bc419f
--- /dev/null
+++ b/packages/kit/src/internal/esm.ts
@@ -0,0 +1,89 @@
+import { pathToFileURL } from 'node:url'
+import { interopDefault } from 'mlly'
+import { resolveModulePath } from 'exsolve'
+import { createJiti } from 'jiti'
+import { getUserCaller, warn } from './trace.ts'
+import { resolveAlias } from '../resolve.ts'
+
+export interface ResolveModuleOptions {
+ /** @deprecated use `url` with URLs pointing at a file - never a directory */
+ paths?: string | string[]
+ url?: URL | URL[]
+ /** @default ['.js', '.mjs', '.cjs', '.ts', '.mts', '.cts'] */
+ extensions?: string[]
+}
+
+export function directoryToURL (dir: string): URL {
+ return pathToFileURL(dir + '/')
+}
+
+/**
+ * Resolve a module from a given root path using an algorithm patterned on
+ * the upcoming `import.meta.resolve`. It returns a file URL
+ *
+ * @internal
+ */
+export async function tryResolveModule (id: string, url: URL | URL[]): Promise<string | undefined>
+/** @deprecated pass URLs pointing at files */
+export function tryResolveModule (id: string, url: string | string[]): Promise<string | undefined>
+export function tryResolveModule (id: string, url: string | string[] | URL | URL[] = import.meta.url) {
+ return Promise.resolve(resolveModulePath(id, {
+ from: url,
+ suffixes: ['', 'index'],
+ try: true,
+ }))
+}
+
+export function resolveModule (id: string, options?: ResolveModuleOptions): string {
+ return resolveModulePath(id, {
+ // eslint-disable-next-line @typescript-eslint/no-deprecated
+ from: options?.url ?? options?.paths ?? [import.meta.url],
+ extensions: options?.extensions ?? ['.js', '.mjs', '.cjs', '.ts', '.mts', '.cts'],
+ })
+}
+
+export interface ImportModuleOptions extends ResolveModuleOptions {
+ /** Automatically de-default the result of requiring the module. */
+ interopDefault?: boolean
+}
+
+export async function importModule<T = unknown> (id: string, opts?: ImportModuleOptions): Promise<T> {
+ const resolvedPath = resolveModule(id, opts)
+ return await import(pathToFileURL(resolvedPath).href).then(r => opts?.interopDefault !== false ? interopDefault(r) : r) as Promise<T>
+}
+
+export function tryImportModule<T = unknown> (id: string, opts?: ImportModuleOptions): Promise<T | undefined> | undefined {
+ try {
+ return importModule<T>(id, opts).catch(() => undefined)
+ } catch {
+ // intentionally empty as this is a `try-` function
+ }
+}
+
+/**
+ * @deprecated Please use `importModule` instead.
+ */
+export function requireModule<T = unknown> (id: string, opts?: ImportModuleOptions) {
+ const caller = getUserCaller()
+ const explanation = caller ? ` (used at \`${resolveAlias(caller.source)}:${caller.line}:${caller.column}\`)` : ''
+ const warning = `[@nuxt/kit] \`requireModule\` is deprecated${explanation}. Please use \`importModule\` instead.`
+ warn(warning)
+ const resolvedPath = resolveModule(id, opts)
+ const jiti = createJiti(import.meta.url, {
+ interopDefault: opts?.interopDefault !== false,
+ })
+ // eslint-disable-next-line @typescript-eslint/no-deprecated
+ return jiti(pathToFileURL(resolvedPath).href) as T
+}
+
+/**
+ * @deprecated Please use `tryImportModule` instead.
+ */
+export function tryRequireModule<T = unknown> (id: string, opts?: ImportModuleOptions): T | undefined {
+ try {
+ // eslint-disable-next-line @typescript-eslint/no-deprecated
+ return requireModule<T>(id, opts)
+ } catch {
+ // intentionally empty as this is a `try-` function
+ }
+}
diff --git a/packages/kit/src/internal/trace.ts b/packages/kit/src/internal/trace.ts
new file mode 100644
index 000000000000..7e53cf89683b
--- /dev/null
+++ b/packages/kit/src/internal/trace.ts
@@ -0,0 +1,30 @@
+import { captureStackTrace } from 'errx'
+
+const distURL = import.meta.url.replace(/\/dist\/.*$/, '/')
+
+export function getUserCaller () {
+ if (!import.meta.dev) {
+ return null
+ }
+
+ const { source, line, column } = captureStackTrace().find(entry => !entry.source.startsWith(distURL)) ?? {}
+
+ if (!source) {
+ return null
+ }
+
+ return {
+ source: source.replace(/^file:\/\//, ''),
+ line,
+ column,
+ }
+}
+
+const warnings = new Set<string>()
+
+export function warn (warning: string) {
+ if (!warnings.has(warning)) {
+ console.warn(warning)
+ warnings.add(warning)
+ }
+}
diff --git a/packages/kit/src/layers.ts b/packages/kit/src/layers.ts
new file mode 100644
index 000000000000..6b4d886af684
--- /dev/null
+++ b/packages/kit/src/layers.ts
@@ -0,0 +1,77 @@
+import type { Nuxt, NuxtConfigLayer, NuxtOptions } from '@nuxt/schema'
+import { resolve } from 'pathe'
+
+import { useNuxt } from './context.ts'
+import { resolveAlias } from './resolve.ts'
+
+export interface LayerDirectories {
+ /** Nuxt rootDir (`/` by default) */
+ readonly root: string
+ /** Nitro source directory (`/server` by default) */
+ readonly server: string
+ /** Local modules directory (`/modules` by default) */
+ readonly modules: string
+ /** Shared directory (`/shared` by default) */
+ readonly shared: string
+ /** Public directory (`/public` by default) */
+ readonly public: string
+ /** Nuxt srcDir (`/app/` by default) */
+ readonly app: string
+ /** Layouts directory (`/app/layouts` by default) */
+ readonly appLayouts: string
+ /** Middleware directory (`/app/middleware` by default) */
+ readonly appMiddleware: string
+ /** Pages directory (`/app/pages` by default) */
+ readonly appPages: string
+ /** Plugins directory (`/app/plugins` by default) */
+ readonly appPlugins: string
+}
+
+const layerMap = new WeakMap<NuxtConfigLayer, LayerDirectories>()
+
+/**
+ * Get the resolved directory paths for all layers in a Nuxt application.
+ *
+ * Returns an array of LayerDirectories objects, ordered by layer priority:
+ * - The first layer is the user/project layer (highest priority)
+ * - Earlier layers override later layers in the array
+ * - Base layers appear last in the array (lowest priority)
+ *
+ * @param nuxt - The Nuxt instance to get layers from. Defaults to the current Nuxt context.
+ * @returns Array of LayerDirectories objects, ordered by priority (user layer first)
+ */
+export function getLayerDirectories (nuxt: Nuxt = useNuxt()): LayerDirectories[] {
+ return nuxt.options._layers.map((layer) => {
+ if (layerMap.has(layer)) {
+ return layerMap.get(layer)!
+ }
+
+ const isRoot = withTrailingSlash(layer.config.rootDir) === withTrailingSlash(nuxt.options.rootDir)
+ const config = isRoot ? nuxt.options : (layer.config as Omit<NuxtOptions, '_layers'>)
+
+ const src = withTrailingSlash(config.srcDir || layer.cwd)
+ const root = withTrailingSlash(config.rootDir || layer.cwd)
+
+ const directories = {
+ root,
+ shared: withTrailingSlash(resolve(root, resolveAlias(config.dir?.shared || 'shared', nuxt.options.alias))),
+ // these are resolved relative to root in `@nuxt/schema` for v4+
+ // so resolving relative to `src` covers backward compatibility for v3
+ server: withTrailingSlash(resolve(src, resolveAlias(config.serverDir || 'server', nuxt.options.alias))),
+ modules: withTrailingSlash(resolve(src, resolveAlias(config.dir?.modules || 'modules', nuxt.options.alias))),
+ public: withTrailingSlash(resolve(src, resolveAlias(config.dir?.public || 'public', nuxt.options.alias))),
+ // nuxt app
+ app: src,
+ appLayouts: withTrailingSlash(resolve(src, resolveAlias(config.dir?.layouts || 'layouts', nuxt.options.alias))),
+ appMiddleware: withTrailingSlash(resolve(src, resolveAlias(config.dir?.middleware || 'middleware', nuxt.options.alias))),
+ appPages: withTrailingSlash(resolve(src, resolveAlias(config.dir?.pages || 'pages', nuxt.options.alias))),
+ appPlugins: withTrailingSlash(resolve(src, resolveAlias(config.dir?.plugins || 'plugins', nuxt.options.alias))),
+ }
+ layerMap.set(layer, directories)
+ return directories
+ })
+}
+
+function withTrailingSlash (dir: string) {
+ return dir.replace(/[^/]$/, '$&/')
+}
diff --git a/packages/kit/src/layout.ts b/packages/kit/src/layout.ts
new file mode 100644
index 000000000000..234f80df4f56
--- /dev/null
+++ b/packages/kit/src/layout.ts
@@ -0,0 +1,33 @@
+import type { NuxtTemplate } from '@nuxt/schema'
+import { join, parse } from 'pathe'
+import { kebabCase } from 'scule'
+import { useNuxt } from './context.ts'
+import { logger } from './logger.ts'
+import { addTemplate } from './template.ts'
+import { reverseResolveAlias } from 'pathe/utils'
+
+const LAYOUT_RE = /["']/g
+export function addLayout (template: NuxtTemplate | string, name?: string): void {
+ const nuxt = useNuxt()
+ const { filename, src } = addTemplate(template)
+ const layoutName = kebabCase(name || parse(filename).name).replace(LAYOUT_RE, '')
+
+ // Nuxt 3 adds layouts on app
+ nuxt.hook('app:templates', (app) => {
+ if (layoutName in app.layouts) {
+ const relativePath = reverseResolveAlias(app.layouts[layoutName]!.file, { ...nuxt?.options.alias || {}, ...strippedAtAliases }).pop() || app.layouts[layoutName]!.file
+ return logger.warn(
+ `Not overriding \`${layoutName}\` (provided by \`${relativePath}\`) with \`${src || filename}\`.`,
+ )
+ }
+ app.layouts[layoutName] = {
+ file: join('#build', filename),
+ name: layoutName,
+ }
+ })
+}
+
+const strippedAtAliases = {
+ '@': '',
+ '@@': '',
+}
diff --git a/packages/kit/src/loader/config.ts b/packages/kit/src/loader/config.ts
new file mode 100644
index 000000000000..fe402d28a8a2
--- /dev/null
+++ b/packages/kit/src/loader/config.ts
@@ -0,0 +1,174 @@
+import { existsSync } from 'node:fs'
+import process from 'node:process'
+import type { JSValue } from 'untyped'
+import { applyDefaults } from 'untyped'
+import type { ConfigLayer, ConfigLayerMeta, LoadConfigOptions } from 'c12'
+import { loadConfig, setupDotenv } from 'c12'
+import type { NuxtConfig, NuxtOptions } from '@nuxt/schema'
+import { glob } from 'tinyglobby'
+import { createDefu, defu } from 'defu'
+import { basename, join, relative } from 'pathe'
+import { resolveModuleURL } from 'exsolve'
+import { withTrailingSlash, withoutTrailingSlash } from 'ufo'
+
+import { directoryToURL } from '../internal/esm.ts'
+
+export interface LoadNuxtConfigOptions extends Omit<LoadConfigOptions<NuxtConfig>, 'overrides'> {
+ // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+ overrides?: Exclude<LoadConfigOptions<NuxtConfig>['overrides'], Promise<any> | Function>
+}
+
+const merger = createDefu((obj, key, value) => {
+ if (Array.isArray(obj[key]) && Array.isArray(value)) {
+ obj[key] = obj[key].concat(value)
+ return true
+ }
+})
+
+export async function loadNuxtConfig (opts: LoadNuxtConfigOptions): Promise<NuxtOptions> {
+ // Automatically detect and import layers from `~~/layers/` directory
+ const localLayers = (await glob('layers/*', {
+ onlyDirectories: true, cwd: opts.cwd || process.cwd(),
+ }))
+ .map((d: string) => withTrailingSlash(d))
+ .sort((a, b) => b.localeCompare(a))
+ opts.overrides = defu(opts.overrides, { _extends: localLayers })
+
+ // populate process.env before the schema imports its env-based defaults
+ if (opts.dotenv !== false) {
+ await setupDotenv({
+ cwd: opts.cwd || process.cwd(),
+ ...(typeof opts.dotenv === 'object' ? opts.dotenv : {}),
+ })
+ }
+
+ const schemaPromise = loadNuxtSchema(opts.cwd || process.cwd())
+
+ const { configFile, layers = [], cwd, config: nuxtConfig, meta } = await withDefineNuxtConfig(
+ () => loadConfig<NuxtConfig>({
+ name: 'nuxt',
+ configFile: 'nuxt.config',
+ rcFile: '.nuxtrc',
+ extend: { extendKey: ['theme', '_extends', 'extends'] },
+ globalRc: true,
+ // @ts-expect-error TODO: fix type in c12, it should accept createDefu directly
+ merger,
+ ...opts,
+ dotenv: false, // already loaded above
+ }),
+ )
+
+ // Fill config
+ nuxtConfig.rootDir ||= cwd
+ nuxtConfig._nuxtConfigFile = configFile
+ nuxtConfig._nuxtConfigFiles = [configFile]
+ nuxtConfig._loadOptions = opts
+ // explicit `envName` (e.g. from `nuxt --envName`) takes precedence over `nuxt.config`,
+ // matching how `c12` selects `$env.*` overrides
+ if (typeof opts.envName === 'string') {
+ nuxtConfig.envName = opts.envName
+ }
+ nuxtConfig.alias ||= {}
+
+ if (meta?.name) {
+ const alias = `#layers/${meta.name}`
+ nuxtConfig.alias[alias] ||= withTrailingSlash(nuxtConfig.rootDir)
+ }
+
+ const defaultBuildDir = join(nuxtConfig.rootDir!, '.nuxt')
+ if (!opts.overrides?._prepare && !nuxtConfig.dev && !nuxtConfig.buildDir && existsSync(defaultBuildDir)) {
+ nuxtConfig.buildDir = join(nuxtConfig.rootDir!, 'node_modules/.cache/nuxt/.nuxt')
+ }
+
+ const NuxtConfigSchema = await schemaPromise
+
+ const layerSchemaKeys = ['future', 'srcDir', 'rootDir', 'serverDir', 'dir']
+ const layerSchema = Object.create(null)
+ for (const key of layerSchemaKeys) {
+ if (key in NuxtConfigSchema) {
+ layerSchema[key] = NuxtConfigSchema[key]
+ }
+ }
+
+ const _layers: ConfigLayer<NuxtConfig, ConfigLayerMeta>[] = []
+ const processedLayers = new Set<string>()
+ const localRelativePaths = new Set(localLayers.map(layer => withoutTrailingSlash(layer)))
+ for (const layer of layers) {
+ // Resolve `rootDir` & `srcDir` of layers
+ // Create a shallow copy to avoid mutating the cached ESM config object
+ const resolvedRootDir = layer.config?.rootDir ?? layer.cwd!
+ layer.config = {
+ ...(layer.config || {}),
+ rootDir: resolvedRootDir,
+ }
+
+ // Only process/resolve layers once
+ if (processedLayers.has(resolvedRootDir)) { continue }
+ processedLayers.add(resolvedRootDir)
+
+ // Normalise layer directories
+ layer.config = await applyDefaults(layerSchema, layer.config as NuxtConfig & Record<string, JSValue>) as unknown as NuxtConfig
+
+ // Filter layers
+ if (!layer.configFile || layer.configFile.endsWith('.nuxtrc')) { continue }
+
+ // Add layer name for local layers
+ if (layer.cwd && cwd && localRelativePaths.has(relative(cwd, layer.cwd))) {
+ layer.meta ||= {}
+ layer.meta.name ||= basename(layer.cwd)
+ }
+
+ // Add layer alias
+ if (layer.meta?.name) {
+ const alias = `#layers/${layer.meta.name}`
+ nuxtConfig.alias[alias] ||= withTrailingSlash(layer.config.rootDir || layer.cwd)
+ }
+ _layers.push(layer)
+ }
+
+ ;(nuxtConfig as any)._layers = _layers
+
+ // Ensure at least one layer remains (without nuxt.config)
+ if (!_layers.length) {
+ _layers.push({
+ cwd,
+ config: {
+ rootDir: cwd,
+ srcDir: cwd,
+ },
+ })
+ }
+
+ // Resolve and apply defaults
+ return await applyDefaults(NuxtConfigSchema, nuxtConfig as NuxtConfig & Record<string, JSValue>) as unknown as NuxtOptions
+}
+
+function loadNuxtSchema (cwd: string) {
+ const url = directoryToURL(cwd)
+ const urls: Array<URL | string> = [url]
+ const nuxtPath = resolveModuleURL('nuxt', { try: true, from: url }) ?? resolveModuleURL('nuxt-nightly', { try: true, from: url })
+ if (nuxtPath) {
+ urls.unshift(nuxtPath)
+ }
+ const schemaPath = resolveModuleURL('@nuxt/schema', { try: true, from: urls }) ?? '@nuxt/schema'
+ return import(schemaPath).then(r => r.NuxtConfigSchema)
+}
+
+async function withDefineNuxtConfig<T> (fn: () => Promise<T>) {
+ const key = 'defineNuxtConfig'
+ const globalSelf = globalThis as any
+
+ if (!globalSelf[key]) {
+ globalSelf[key] = (c: any) => c
+ globalSelf[key].count = 0
+ }
+ globalSelf[key].count++
+ try {
+ return await fn()
+ } finally {
+ globalSelf[key].count--
+ if (!globalSelf[key].count) {
+ delete globalSelf[key]
+ }
+ }
+}
diff --git a/packages/kit/src/loader/nuxt.ts b/packages/kit/src/loader/nuxt.ts
new file mode 100644
index 000000000000..633dbd203286
--- /dev/null
+++ b/packages/kit/src/loader/nuxt.ts
@@ -0,0 +1,44 @@
+import { pathToFileURL } from 'node:url'
+import type { Nuxt, NuxtConfig } from '@nuxt/schema'
+import { resolve } from 'pathe'
+import { resolveModulePath } from 'exsolve'
+import { interopDefault } from 'mlly'
+import { directoryToURL, importModule, tryImportModule } from '../internal/esm.ts'
+import { runWithNuxtContext } from '../context.ts'
+import type { LoadNuxtConfigOptions } from './config.ts'
+
+export interface LoadNuxtOptions extends LoadNuxtConfigOptions {
+ /** Load nuxt with development mode */
+ dev?: boolean
+
+ /** Use lazy initialization of nuxt if set to false */
+ ready?: boolean
+}
+
+export async function loadNuxt (opts: LoadNuxtOptions): Promise<Nuxt> {
+ // Backward compatibility
+ opts.cwd = resolve(opts.cwd || (opts as any).rootDir /* backwards compat */ || '.')
+ opts.overrides ||= (opts as any).config as NuxtConfig /* backwards compat */ || {}
+
+ // Apply dev as config override
+ opts.overrides.dev = !!opts.dev
+
+ const resolvedPath = ['nuxt-nightly', 'nuxt'].reduce((resolvedPath, pkg) => {
+ const path = resolveModulePath(pkg, { try: true, from: [directoryToURL(opts.cwd!)] })
+ return path && path.length > resolvedPath.length ? path : resolvedPath
+ }, '')
+
+ if (!resolvedPath) {
+ throw new Error(`Cannot find any nuxt version from ${opts.cwd}`)
+ }
+ const { loadNuxt } = await import(pathToFileURL(resolvedPath).href).then(r => interopDefault(r)) as typeof import('nuxt')
+ const nuxt = await loadNuxt(opts)
+ return nuxt
+}
+
+export async function buildNuxt (nuxt: Nuxt): Promise<any> {
+ const rootURL = directoryToURL(nuxt.options.rootDir)
+
+ const { build } = await tryImportModule<typeof import('nuxt')>('nuxt-nightly', { url: rootURL }) || await importModule<typeof import('nuxt')>('nuxt', { url: rootURL })
+ return runWithNuxtContext(nuxt, () => build(nuxt))
+}
diff --git a/packages/kit/src/loader/schema.ts b/packages/kit/src/loader/schema.ts
new file mode 100644
index 000000000000..43440459fbe8
--- /dev/null
+++ b/packages/kit/src/loader/schema.ts
@@ -0,0 +1,9 @@
+import type { SchemaDefinition } from '@nuxt/schema'
+import { useNuxt } from '../context.ts'
+
+export function extendNuxtSchema (def: SchemaDefinition | (() => SchemaDefinition)): void {
+ const nuxt = useNuxt()
+ nuxt.hook('schema:extend', (schemas) => {
+ schemas.push(typeof def === 'function' ? def() : def)
+ })
+}
diff --git a/packages/kit/src/logger.test.ts b/packages/kit/src/logger.test.ts
new file mode 100644
index 000000000000..0056a407a47d
--- /dev/null
+++ b/packages/kit/src/logger.test.ts
@@ -0,0 +1,43 @@
+import { describe, expect, it, vi } from 'vitest'
+
+import { logger, useLogger } from './logger.ts'
+
+describe('logger', () => {
+ it('should expose consola', () => {
+ expect(logger).toBeDefined()
+ expect(logger.create).toBeDefined()
+ expect(logger.withTag).toBeDefined()
+ })
+})
+
+describe('useLogger', () => {
+ it('should expose logger when not passing a tag', () => {
+ expect(useLogger()).toBe(logger)
+ })
+
+ it('should create a new instance when passing a tag', () => {
+ const mockWithTag = vi.fn().mockReturnValue({})
+ const mockInstance = { withTag: mockWithTag }
+ const createSpy = vi.spyOn(logger, 'create').mockReturnValue(mockInstance as any)
+
+ useLogger('tag')
+
+ expect(createSpy).toHaveBeenCalledWith({})
+ expect(mockWithTag).toHaveBeenCalledWith('tag')
+
+ createSpy.mockRestore()
+ })
+
+ it('should create a new instance when passing a tag and options', () => {
+ const mockWithTag = vi.fn().mockReturnValue({})
+ const mockInstance = { withTag: mockWithTag }
+ const createSpy = vi.spyOn(logger, 'create').mockReturnValue(mockInstance as any)
+
+ useLogger('tag', { level: 0 })
+
+ expect(createSpy).toHaveBeenCalledWith({ level: 0 })
+ expect(mockWithTag).toHaveBeenCalledWith('tag')
+
+ createSpy.mockRestore()
+ })
+})
diff --git a/packages/kit/src/logger.ts b/packages/kit/src/logger.ts
new file mode 100644
index 000000000000..3b8b0f92b2d7
--- /dev/null
+++ b/packages/kit/src/logger.ts
@@ -0,0 +1,8 @@
+import { consola } from 'consola'
+import type { ConsolaInstance, ConsolaOptions } from 'consola'
+
+export const logger: ConsolaInstance = consola
+
+export function useLogger (tag?: string, options: Partial<ConsolaOptions> = {}): ConsolaInstance {
+ return tag ? logger.create(options).withTag(tag) : logger
+}
diff --git a/packages/kit/src/module/compatibility.test.ts b/packages/kit/src/module/compatibility.test.ts
new file mode 100644
index 000000000000..8adac78b6e81
--- /dev/null
+++ b/packages/kit/src/module/compatibility.test.ts
@@ -0,0 +1,56 @@
+import { describe, expect, it } from 'vitest'
+import { loadNuxt } from '../loader/nuxt.ts'
+import { getNuxtModuleVersion, hasNuxtModule, hasNuxtModuleCompatibility } from './compatibility.ts'
+import { defineNuxtModule } from './define.ts'
+
+describe('nuxt module compatibility', () => {
+ it('check module installed', async () => {
+ const nuxt = await loadNuxt({
+ overrides: {
+ modules: [
+ defineNuxtModule({
+ meta: {
+ name: 'nuxt-module-foo',
+ },
+ }),
+ [
+ defineNuxtModule({
+ meta: {
+ name: 'module-instance-with-options',
+ },
+ }),
+ {
+ foo: 'bar',
+ },
+ ],
+ ],
+ },
+ })
+ expect(hasNuxtModule('nuxt-module-foo', nuxt)).toStrictEqual(true)
+ expect(hasNuxtModule('module-instance-with-options', nuxt)).toStrictEqual(true)
+ await nuxt.close()
+ })
+ it('can retrieve module version from module instance', async () => {
+ const nuxt = await loadNuxt({})
+ const module = defineNuxtModule({
+ meta: {
+ name: 'nuxt-module-foo',
+ version: '1.0.0',
+ },
+ })
+ expect(await getNuxtModuleVersion(module, nuxt)).toEqual('1.0.0')
+ await nuxt.close()
+ })
+ it('check module instance version compatibility', async () => {
+ const nuxt = await loadNuxt({})
+ const module = defineNuxtModule({
+ meta: {
+ name: 'nuxt-module-foo',
+ version: '1.0.0',
+ },
+ })
+ expect(await hasNuxtModuleCompatibility(module, '^1.0.0', nuxt)).toStrictEqual(true)
+ expect(await hasNuxtModuleCompatibility(module, '^2.0.0', nuxt)).toStrictEqual(false)
+ await nuxt.close()
+ })
+})
diff --git a/packages/kit/src/module/compatibility.ts b/packages/kit/src/module/compatibility.ts
new file mode 100644
index 000000000000..5bdbbafa86e4
--- /dev/null
+++ b/packages/kit/src/module/compatibility.ts
@@ -0,0 +1,65 @@
+import satisfies from 'semver/functions/satisfies.js' // npm/node-semver#381
+import type { Nuxt, NuxtModule, NuxtOptions } from '@nuxt/schema'
+import { useNuxt } from '../context.ts'
+import { normalizeSemanticVersion } from '../compatibility.ts'
+import { loadNuxtModuleInstance } from './install.ts'
+
+function resolveNuxtModuleEntryName (m: NuxtOptions['modules'][number]): string | false {
+ if (typeof m === 'object' && !Array.isArray(m)) {
+ return (m as any as NuxtModule).name
+ }
+ if (Array.isArray(m)) {
+ return resolveNuxtModuleEntryName(m[0])
+ }
+ return m as string || false
+}
+
+/**
+ * Check if a Nuxt module is installed by name.
+ *
+ * This will check both the installed modules and the modules to be installed. Note
+ * that it cannot detect if a module is _going to be_ installed programmatically by another module.
+ */
+export function hasNuxtModule (moduleName: string, nuxt: Nuxt = useNuxt()): boolean {
+ // check installed modules
+ return nuxt.options._installedModules.some(({ meta }) => meta.name === moduleName) ||
+ // check modules to be installed
+ nuxt.options.modules.some(m => moduleName === resolveNuxtModuleEntryName(m))
+}
+
+/**
+ * Checks if a Nuxt module is compatible with a given semver version.
+ */
+export async function hasNuxtModuleCompatibility (module: string | NuxtModule, semverVersion: string, nuxt: Nuxt = useNuxt()): Promise<boolean> {
+ const version = await getNuxtModuleVersion(module, nuxt)
+ if (!version) {
+ return false
+ }
+ return satisfies(normalizeSemanticVersion(version), semverVersion, {
+ includePrerelease: true,
+ })
+}
+
+/**
+ * Get the version of a Nuxt module.
+ *
+ * Scans installed modules for the version, if it's not found it will attempt to load the module instance and get the version from there.
+ */
+export async function getNuxtModuleVersion (module: string | NuxtModule, nuxt: Nuxt | any = useNuxt()): Promise<string | false> {
+ const moduleMeta = (typeof module === 'string' ? { name: module } : await module.getMeta?.()) || {}
+ if (moduleMeta.version) { return moduleMeta.version }
+ // need a name from here
+ if (!moduleMeta.name) { return false }
+ // maybe the version got attached within the installed module instance?
+ for (const m of nuxt.options._installedModules) {
+ if (m.meta.name === moduleMeta.name && m.meta.version) {
+ return m.meta.version
+ }
+ }
+ // it's possible that the module will be installed, it just hasn't been done yet, preemptively load the instance
+ if (hasNuxtModule(moduleMeta.name)) {
+ const { nuxtModule, buildTimeModuleMeta } = await loadNuxtModuleInstance(moduleMeta.name, nuxt)
+ return buildTimeModuleMeta.version || await nuxtModule.getMeta?.().then(r => r.version) || false
+ }
+ return false
+}
diff --git a/packages/kit/src/module/define.ts b/packages/kit/src/module/define.ts
new file mode 100644
index 000000000000..da51ab644f2b
--- /dev/null
+++ b/packages/kit/src/module/define.ts
@@ -0,0 +1,164 @@
+import { performance } from 'node:perf_hooks'
+import { defu } from 'defu'
+import { applyDefaults } from 'untyped'
+import type { ModuleDefinition, ModuleOptions, ModuleSetupInstallResult, ModuleSetupReturn, Nuxt, NuxtModule, NuxtOptions, ResolvedModuleOptions } from '@nuxt/schema'
+import { logger } from '../logger.ts'
+import { tryUseNuxt, useNuxt } from '../context.ts'
+import { checkNuxtCompatibility } from '../compatibility.ts'
+
+/**
+ * Define a Nuxt module, automatically merging defaults with user provided options, installing
+ * any hooks that are provided, and calling an optional setup function for full control.
+ */
+export function defineNuxtModule<TOptions extends ModuleOptions> (
+ definition: ModuleDefinition<TOptions, Partial<TOptions>, false> | NuxtModule<TOptions, Partial<TOptions>, false>,
+): NuxtModule<TOptions, TOptions, false>
+
+export function defineNuxtModule<TOptions extends ModuleOptions> (): {
+ with: <TOptionsDefaults extends Partial<TOptions>> (
+ definition: ModuleDefinition<TOptions, TOptionsDefaults, true> | NuxtModule<TOptions, TOptionsDefaults, true>,
+ ) => NuxtModule<TOptions, TOptionsDefaults, true>
+}
+
+export function defineNuxtModule<TOptions extends ModuleOptions> (
+ definition?: ModuleDefinition<TOptions, Partial<TOptions>, false> | NuxtModule<TOptions, Partial<TOptions>, false>,
+) {
+ if (definition) {
+ return _defineNuxtModule(definition)
+ }
+
+ return {
+ with: <TOptionsDefaults extends Partial<TOptions>>(
+ definition: ModuleDefinition<TOptions, TOptionsDefaults, true> | NuxtModule<TOptions, TOptionsDefaults, true>,
+ ) => _defineNuxtModule(definition),
+ }
+}
+
+function _defineNuxtModule<
+ TOptions extends ModuleOptions,
+ TOptionsDefaults extends Partial<TOptions>,
+ TWith extends boolean,
+> (
+ definition: ModuleDefinition<TOptions, TOptionsDefaults, TWith> | NuxtModule<TOptions, TOptionsDefaults, TWith>,
+): NuxtModule<TOptions, TOptionsDefaults, TWith> {
+ if (typeof definition === 'function') {
+ return _defineNuxtModule<TOptions, TOptionsDefaults, TWith>({ setup: definition })
+ }
+
+ // Normalize definition and meta
+ const module: ModuleDefinition<TOptions, TOptionsDefaults, TWith> & Required<Pick<ModuleDefinition<TOptions, TOptionsDefaults, TWith>, 'meta'>> = defu(definition, { meta: {} })
+
+ module.meta.configKey ||= module.meta.name
+
+ // Resolves module options from inline options, [configKey] in nuxt.config, defaults and schema
+ async function getOptions (inlineOptions?: Partial<TOptions>, nuxt: Nuxt = useNuxt()): Promise<
+ TWith extends true
+ ? ResolvedModuleOptions<TOptions, TOptionsDefaults>
+ : TOptions
+ > {
+ const nuxtConfigOptionsKey = module.meta.configKey || module.meta.name
+
+ const nuxtConfigOptions: Partial<TOptions> = nuxtConfigOptionsKey && nuxtConfigOptionsKey in nuxt.options ? nuxt.options[nuxtConfigOptionsKey as keyof NuxtOptions] as Partial<TOptions> : {}
+
+ const optionsDefaults: TOptionsDefaults =
+ module.defaults instanceof Function
+ ? await module.defaults(nuxt)
+ : module.defaults ?? {} as TOptionsDefaults
+
+ let options = defu(inlineOptions, nuxtConfigOptions, optionsDefaults)
+
+ if (module.schema) {
+ options = await applyDefaults(module.schema, options) as any
+ }
+
+ // @ts-expect-error ignore type mismatch when calling `defineNuxtModule` without `.with()`
+ return Promise.resolve(options)
+ }
+
+ function getModuleDependencies (nuxt: Nuxt = useNuxt()) {
+ if (typeof module.moduleDependencies === 'function') {
+ return module.moduleDependencies(nuxt)
+ }
+ return module.moduleDependencies
+ }
+
+ // Module format is always a simple function
+ async function normalizedModule (inlineOptions: Partial<TOptions>, nuxt = tryUseNuxt()!): Promise<ModuleSetupReturn> {
+ if (!nuxt) {
+ throw new TypeError(`Cannot use ${module.meta.name || 'module'} outside of Nuxt context`)
+ }
+
+ // Avoid duplicate installs
+ const uniqueKey = module.meta.name || module.meta.configKey
+ if (uniqueKey) {
+ nuxt.options._requiredModules ||= {}
+ if (nuxt.options._requiredModules[uniqueKey]) {
+ return false
+ }
+ nuxt.options._requiredModules[uniqueKey] = true
+ }
+
+ // Check compatibility constraints
+ if (module.meta.compatibility) {
+ const issues = await checkNuxtCompatibility(module.meta.compatibility, nuxt)
+ if (issues.length) {
+ const errorMessage = `Module \`${module.meta.name}\` is disabled due to incompatibility issues:\n${issues.toString()}`
+ if (nuxt.options.experimental.enforceModuleCompatibility) {
+ const error = new Error(errorMessage)
+ error.name = 'ModuleCompatibilityError'
+ throw error
+ }
+ logger.warn(errorMessage)
+ return
+ }
+ }
+
+ // Resolve module and options
+ const _options = await getOptions(inlineOptions, nuxt)
+
+ // Register hooks
+ if (module.hooks) {
+ nuxt.hooks.addHooks(module.hooks)
+ }
+
+ // Call setup
+ const moduleName = uniqueKey || module.meta.name || '<no name>'
+ nuxt._perf?.startPhase(`module:${moduleName}`)
+ const start = performance.now()
+ let res = {} as ModuleSetupReturn
+ try {
+ res = await module.setup?.call(null as any, _options, nuxt) ?? {}
+ } finally {
+ nuxt._perf?.endPhase(`module:${moduleName}`)
+ }
+ const perf = performance.now() - start
+ const setupTime = Math.round((perf * 100)) / 100
+
+ // Measure setup time
+ if (setupTime > 5000 && uniqueKey !== '@nuxt/telemetry') {
+ logger.warn(`Slow module \`${moduleName}\` took \`${setupTime}ms\` to setup.`)
+ } else if (nuxt.options.debug && nuxt.options.debug.modules) {
+ logger.info(`Module \`${moduleName}\` took \`${setupTime}ms\` to setup.`)
+ }
+
+ // Check if module is ignored
+ if (res === false) { return false }
+
+ // Return module install result
+ return defu(res, {
+ timings: {
+ setup: setupTime,
+ },
+ } as ModuleSetupInstallResult)
+ }
+
+ // Define getters for options and meta
+ normalizedModule.getMeta = () => Promise.resolve(module.meta)
+ normalizedModule.getOptions = getOptions
+ normalizedModule.getModuleDependencies = getModuleDependencies
+
+ normalizedModule.onInstall = module.onInstall
+ normalizedModule.onUpgrade = module.onUpgrade
+
+ return normalizedModule as NuxtModule<TOptions, TOptionsDefaults, TWith>
+}
diff --git a/packages/kit/src/module/install.test.ts b/packages/kit/src/module/install.test.ts
new file mode 100644
index 000000000000..465bb3972eb9
--- /dev/null
+++ b/packages/kit/src/module/install.test.ts
@@ -0,0 +1,81 @@
+import { mkdir, rm, writeFile } from 'node:fs/promises'
+import { afterAll, beforeAll, describe, expect, it } from 'vitest'
+import { join } from 'pathe'
+import { findWorkspaceDir } from 'pkg-types'
+import { loadNuxt } from '../loader/nuxt.ts'
+import { defineNuxtModule } from './define.ts'
+
+const repoRoot = await findWorkspaceDir()
+
+describe('nuxt module install', () => {
+ const tempDir = join(repoRoot, 'node_modules/.temp/module-prerelease-test')
+
+ beforeAll(async () => {
+ const prereleaseModule = join(tempDir, 'node_modules/prerelease-module')
+ await mkdir(prereleaseModule, { recursive: true })
+ await writeFile(join(prereleaseModule, 'package.json'), JSON.stringify({
+ name: 'prerelease-module',
+ version: '2.0.0-beta.1',
+ type: 'module',
+ exports: './index.js',
+ }))
+ await writeFile(join(prereleaseModule, 'index.js'), `
+export default Object.assign(() => {}, {
+ getMeta: () => ({
+ name: 'prerelease-module',
+ configKey: 'prereleaseModule'
+ })
+})
+ `)
+ })
+
+ afterAll(async () => {
+ await rm(tempDir, { recursive: true, force: true })
+ })
+
+ it('accounts for prerelease versions in module dependencies', async () => {
+ const nuxt = await loadNuxt({
+ cwd: tempDir,
+ overrides: {
+ modules: [
+ defineNuxtModule({
+ meta: {
+ name: 'parent-module',
+ version: '1.0.0',
+ },
+ moduleDependencies: {
+ 'prerelease-module': {
+ version: '>=1',
+ },
+ },
+ setup () {},
+ }),
+ ],
+ },
+ })
+
+ await nuxt.close()
+ })
+
+ it('rejects incompatible prerelease versions in module dependencies', async () => {
+ await expect(loadNuxt({
+ cwd: tempDir,
+ overrides: {
+ modules: [
+ defineNuxtModule({
+ meta: {
+ name: 'parent-module',
+ version: '1.0.0',
+ },
+ moduleDependencies: {
+ 'prerelease-module': {
+ version: '>=3',
+ },
+ },
+ setup () {},
+ }),
+ ],
+ },
+ })).rejects.toThrow(/Module `prerelease-module` version \(`2\.0\.0-beta\.1`\) does not satisfy `>=3`/)
+ })
+})
diff --git a/packages/kit/src/module/install.ts b/packages/kit/src/module/install.ts
new file mode 100644
index 000000000000..ed5b13d3f153
--- /dev/null
+++ b/packages/kit/src/module/install.ts
@@ -0,0 +1,460 @@
+import { existsSync, promises as fsp, lstatSync } from 'node:fs'
+import { fileURLToPath } from 'node:url'
+import type { ModuleMeta, ModuleOptions, Nuxt, NuxtConfig, NuxtModule, NuxtOptions } from '@nuxt/schema'
+import { dirname, isAbsolute, join, resolve } from 'pathe'
+import { defu } from 'defu'
+import { createJiti } from 'jiti'
+import { lookupNodeModuleSubpath, parseNodeModulePath } from 'mlly'
+import { resolveModulePath, resolveModuleURL } from 'exsolve'
+import { isRelative } from 'ufo'
+import { readPackageJSON, resolvePackageJSON } from 'pkg-types'
+import { read as readRc, update as updateRc } from 'rc9'
+import semver from 'semver'
+import { directoryToURL } from '../internal/esm.ts'
+import { useNuxt } from '../context.ts'
+import { resolveAlias } from '../resolve.ts'
+import { logger } from '../logger.ts'
+import { getLayerDirectories } from '../layers.ts'
+
+const NODE_MODULES_RE = /[/\\]node_modules[/\\]/
+
+type ModuleToInstall = string | NuxtModule<ModuleOptions, Partial<ModuleOptions>, false>
+interface ResolvedModule {
+ moduleToInstall: ModuleToInstall
+ nuxtModule: NuxtModule<ModuleOptions, Partial<ModuleOptions>, false>
+ buildTimeModuleMeta: ModuleMeta
+ resolvedModulePath: string | undefined
+ inlineOptions: Record<string, any>
+ meta: ModuleMeta | undefined
+}
+
+// config keys that accept `false` as a valid config value or are known to handle disabling internally
+const ignoredConfigKeys = new Set(['components', 'imports', 'pages', 'devtools', 'telemetry'])
+
+/**
+ * Installs a set of modules on a Nuxt instance.
+ * @internal
+ */
+export async function installModules (modulesToInstall: Map<ModuleToInstall, Record<string, any>>, resolvedModulePaths: Set<string>, nuxt: Nuxt = useNuxt()): Promise<void> {
+ const localLayerModuleDirs: string[] = []
+ for (const l of nuxt.options._layers) {
+ const srcDir = l.config.srcDir || l.cwd
+ if (!NODE_MODULES_RE.test(srcDir)) {
+ localLayerModuleDirs.push(resolve(srcDir, l.config?.dir?.modules || 'modules').replace(/\/?$/, '/'))
+ }
+ }
+
+ nuxt._moduleOptionsFunctions ||= new Map<ModuleToInstall, Array<() => { defaults?: Record<string, unknown>, overrides?: Record<string, unknown> }>>()
+ const resolvedModules: Array<ResolvedModule> = []
+ // allow moduleDependencies to reference modules by their meta.name
+ const modulesByMetaName = new Map<string, ModuleToInstall>()
+
+ // preload known modules in parallel
+ const moduleLoadCache = new Map<ModuleToInstall, Promise<{ nuxtModule: NuxtModule<any>, buildTimeModuleMeta: ModuleMeta, resolvedModulePath?: string }>>()
+ for (const [key] of modulesToInstall) {
+ moduleLoadCache.set(key, loadNuxtModuleInstance(key, nuxt))
+ }
+
+ const inlineConfigKeys = new Set(
+ await Promise.all([...modulesToInstall].map(async ([mod]) => {
+ if (typeof mod === 'string') { return }
+ const meta = await Promise.resolve(mod.getMeta?.())
+ if (meta?.name) {
+ modulesByMetaName.set(meta.name, mod)
+ }
+ if (meta?.configKey) {
+ if (meta.configKey !== meta.name) {
+ modulesByMetaName.set(meta.configKey, mod)
+ }
+ return meta.configKey
+ }
+ })),
+ )
+ let error: Error | undefined
+ const dependencyMap = new Map<ModuleToInstall, string>()
+ for (const [key, options] of modulesToInstall) {
+ const loadPromise = moduleLoadCache.get(key) || loadNuxtModuleInstance(key, nuxt)
+ const res = await loadPromise.catch((err) => {
+ if (dependencyMap.has(key) && typeof key === 'string') {
+ (err as Error).cause = `Could not resolve \`${key}\` (specified as a dependency of ${dependencyMap.get(key)!}).`
+ }
+ throw err
+ })
+
+ const dependencyMeta = await res.nuxtModule.getModuleDependencies?.(nuxt) || {}
+ for (const [name, value] of Object.entries(dependencyMeta)) {
+ if (!value.overrides && !value.defaults && !value.version && value.optional) {
+ continue
+ }
+
+ // Try to resolve by path/package name first.
+ // If the name matches a meta.name/configKey of an already-loaded module,
+ // resolve using the original module key instead (supports local modules and
+ // modules where meta.name differs from the npm package name).
+ const resolvedModule = modulesByMetaName.has(name)
+ ? resolveModuleWithOptions(modulesByMetaName.get(name)!, nuxt)
+ : resolveModuleWithOptions(name, nuxt)
+ const moduleToAttribute = typeof key === 'string' ? `\`${key}\`` : 'a module in `nuxt.options`'
+
+ if (!resolvedModule?.module) {
+ const message = `Could not resolve \`${name}\` (specified as a dependency of ${moduleToAttribute}).`
+ error = new TypeError(message)
+ continue
+ }
+
+ if (value.version) {
+ const resolvePaths = [res.resolvedModulePath!, ...nuxt.options.modulesDir].filter(Boolean)
+ const pkg = await readPackageJSON(name, { from: resolvePaths }).catch(() => null)
+ if (pkg?.version && !semver.satisfies(pkg.version, value.version, { includePrerelease: true })) {
+ const message = `Module \`${name}\` version (\`${pkg.version}\`) does not satisfy \`${value.version}\` (requested by ${moduleToAttribute}).`
+ error = new TypeError(message)
+ }
+ }
+
+ if (value.overrides || value.defaults) {
+ const currentFns = nuxt._moduleOptionsFunctions.get(resolvedModule.module) || []
+ nuxt._moduleOptionsFunctions.set(resolvedModule.module, [
+ ...currentFns,
+ () => ({ defaults: value.defaults, overrides: value.overrides }),
+ ])
+ }
+
+ if (value.optional === true) {
+ continue
+ }
+
+ // ensure types are recognised for modules that are dependencies of other modules
+ nuxt.options.typescript.hoist.push(name)
+
+ if (resolvedModule && !modulesToInstall.has(resolvedModule.module) && (!resolvedModule.resolvedPath || !resolvedModulePaths.has(resolvedModule.resolvedPath))) {
+ // check for config key already registered
+ if (typeof resolvedModule.module === 'string' && inlineConfigKeys.has(resolvedModule.module)) {
+ continue
+ }
+ modulesToInstall.set(resolvedModule.module, resolvedModule.options)
+ dependencyMap.set(resolvedModule.module, moduleToAttribute)
+ const path = resolvedModule.resolvedPath || resolvedModule.module
+ if (typeof path === 'string') {
+ resolvedModulePaths.add(path)
+ }
+ }
+ }
+
+ resolvedModules.push({
+ moduleToInstall: key,
+ meta: await res.nuxtModule.getMeta?.(),
+ nuxtModule: res.nuxtModule,
+ buildTimeModuleMeta: res.buildTimeModuleMeta,
+ resolvedModulePath: res.resolvedModulePath,
+ inlineOptions: options,
+ })
+ }
+
+ if (error) {
+ throw error
+ }
+
+ for (const { nuxtModule, meta = {}, moduleToInstall, buildTimeModuleMeta, resolvedModulePath, inlineOptions } of resolvedModules) {
+ const configKey = meta.configKey as keyof NuxtOptions | undefined
+
+ // Merge options
+ const optionsFns = new Set([
+ ...nuxt._moduleOptionsFunctions.get(moduleToInstall) || [],
+ ...meta?.name ? nuxt._moduleOptionsFunctions.get(meta.name) || [] : [],
+ // TODO: consider dropping options functions keyed by config key
+ ...configKey ? nuxt._moduleOptionsFunctions.get(configKey) || [] : [],
+ ])
+ if (optionsFns.size > 0) {
+ const overrides = [] as unknown as [Record<string, unknown> | undefined, ...Array<Record<string, unknown> | undefined>]
+ const defaults: Array<Record<string, unknown> | undefined> = []
+ for (const fn of optionsFns) {
+ const options = fn()
+ overrides.push(options.overrides)
+ defaults.push(options.defaults)
+ }
+ if (configKey) {
+ ;(nuxt.options[configKey] as any) = defu(...overrides, nuxt.options[configKey], ...defaults)
+ }
+ }
+
+ // Check if module should be disabled
+ const isDisabled = configKey && !ignoredConfigKeys.has(configKey) && nuxt.options[configKey] === false
+ if (!isDisabled) {
+ await callLifecycleHooks(nuxtModule, meta, inlineOptions, nuxt)
+ }
+ const path = typeof moduleToInstall === 'string' ? moduleToInstall : undefined
+ await callModule(nuxt, nuxtModule, inlineOptions, {
+ meta: defu({ disabled: isDisabled }, meta, buildTimeModuleMeta),
+ nameOrPath: path,
+ modulePath: resolvedModulePath || path,
+ localLayerModuleDirs,
+ })
+ }
+
+ // clean up merging options
+ delete nuxt._moduleOptionsFunctions
+}
+
+/**
+ * Installs a module on a Nuxt instance.
+ * @deprecated Use module dependencies.
+ */
+export async function installModule<
+ T extends string | NuxtModule,
+ Config extends Extract<NonNullable<NuxtConfig['modules']>[number], [T, any]>,
+> (moduleToInstall: T, inlineOptions?: [Config] extends [never] ? any : Config[1], nuxt: Nuxt = useNuxt()): Promise<void> {
+ const { nuxtModule, buildTimeModuleMeta, resolvedModulePath } = await loadNuxtModuleInstance(moduleToInstall, nuxt)
+
+ const localLayerModuleDirs: string[] = []
+ for (const dirs of getLayerDirectories(nuxt)) {
+ if (!NODE_MODULES_RE.test(dirs.app)) {
+ localLayerModuleDirs.push(dirs.modules)
+ }
+ }
+
+ // module lifecycle hooks
+ const meta = await nuxtModule.getMeta?.()
+
+ // Apply options from moduleDependencies if available
+ let mergedOptions = inlineOptions
+ const configKey = meta?.configKey as keyof NuxtOptions | undefined
+ if (configKey && nuxt._moduleOptionsFunctions) {
+ const optionsFns = [
+ ...nuxt._moduleOptionsFunctions.get(moduleToInstall) || [],
+ ...nuxt._moduleOptionsFunctions.get(configKey) || [],
+ ]
+ if (optionsFns.length > 0) {
+ const overrides = [] as unknown as [Record<string, unknown> | undefined, ...Array<Record<string, unknown> | undefined>]
+ const defaults: Array<Record<string, unknown> | undefined> = []
+ for (const fn of optionsFns) {
+ const options = fn()
+ overrides.push(options.overrides)
+ defaults.push(options.defaults)
+ }
+ mergedOptions = defu(inlineOptions, ...overrides, nuxt.options[configKey], ...defaults) as any
+ ;(nuxt.options[configKey] as any) = mergedOptions
+ }
+ }
+
+ // Check if module should be disabled
+ const isDisabled = configKey && !ignoredConfigKeys.has(configKey) && nuxt.options[configKey] === false
+
+ if (!isDisabled) {
+ await callLifecycleHooks(nuxtModule, meta, mergedOptions, nuxt)
+ }
+ const path = typeof moduleToInstall === 'string' ? moduleToInstall : undefined
+ await callModule(nuxt, nuxtModule, mergedOptions, {
+ meta: defu({ disabled: isDisabled }, meta, buildTimeModuleMeta),
+ nameOrPath: path,
+ modulePath: resolvedModulePath || path,
+ localLayerModuleDirs,
+ })
+}
+
+export function resolveModuleWithOptions (
+ definition: NuxtModule<any> | string | false | undefined | null | [(NuxtModule | string)?, Record<string, any>?],
+ nuxt: Nuxt,
+): { resolvedPath?: string, module: string | NuxtModule<any>, options: Record<string, any> } | undefined {
+ const [module, options = {}] = Array.isArray(definition) ? definition : [definition, {}]
+
+ if (!module) {
+ return
+ }
+
+ if (typeof module !== 'string') {
+ return {
+ module,
+ options,
+ }
+ }
+
+ const modAlias = resolveAlias(module, nuxt.options.alias)
+ const modPath = resolveModulePath(modAlias, {
+ try: true,
+ from: nuxt.options.modulesDir.map(m => directoryToURL(m.replace(/\/node_modules\/?$/, '/'))),
+ suffixes: ['nuxt', 'nuxt/index', 'module', 'module/index', '', 'index'],
+ extensions: ['.js', '.mjs', '.cjs', '.ts', '.mts', '.cts'],
+ })
+
+ return {
+ module,
+ resolvedPath: modPath || modAlias,
+ options,
+ }
+}
+
+let _jitiCache: WeakMap<Nuxt, ReturnType<typeof createJiti>> | undefined
+
+function getSharedJiti (nuxt: Nuxt): ReturnType<typeof createJiti> {
+ _jitiCache ||= new WeakMap()
+ let jiti = _jitiCache.get(nuxt)
+ if (!jiti) {
+ jiti = createJiti(nuxt.options.rootDir, { alias: nuxt.options.alias })
+ _jitiCache.set(nuxt, jiti)
+ }
+ return jiti
+}
+
+export async function loadNuxtModuleInstance (nuxtModule: string | NuxtModule, nuxt: Nuxt = useNuxt()): Promise<{ nuxtModule: NuxtModule<any>, buildTimeModuleMeta: ModuleMeta, resolvedModulePath?: string }> {
+ let buildTimeModuleMeta: ModuleMeta = {}
+
+ if (typeof nuxtModule === 'function') {
+ return {
+ nuxtModule,
+ buildTimeModuleMeta,
+ }
+ }
+
+ if (typeof nuxtModule !== 'string') {
+ throw new TypeError(`Nuxt module should be a function or a string to import. Received: ${nuxtModule}.`)
+ }
+
+ const jiti = getSharedJiti(nuxt)
+
+ // Import if input is string
+ nuxtModule = resolveAlias(nuxtModule, nuxt.options.alias)
+
+ if (isRelative(nuxtModule)) {
+ nuxtModule = resolve(nuxt.options.rootDir, nuxtModule)
+ }
+
+ try {
+ const src = resolveModuleURL(nuxtModule, {
+ from: nuxt.options.modulesDir.map(m => directoryToURL(m.replace(/\/node_modules\/?$/, '/'))),
+ suffixes: ['nuxt', 'nuxt/index', 'module', 'module/index', '', 'index'],
+ extensions: ['.js', '.mjs', '.cjs', '.ts', '.mts', '.cts'],
+ })
+ const resolvedModulePath = fileURLToPath(src)
+ const resolvedNuxtModule = await jiti.import<NuxtModule<any>>(src, { default: true })
+
+ if (typeof resolvedNuxtModule !== 'function') {
+ throw new TypeError(`Nuxt module should be a function: ${nuxtModule}.`)
+ }
+
+ // nuxt-module-builder generates a module.json with metadata including the version
+ const moduleMetadataPath = new URL('module.json', src)
+ if (existsSync(moduleMetadataPath)) {
+ buildTimeModuleMeta = JSON.parse(await fsp.readFile(moduleMetadataPath, 'utf-8'))
+ }
+
+ return { nuxtModule: resolvedNuxtModule, buildTimeModuleMeta, resolvedModulePath }
+ } catch (error: unknown) {
+ const code = (error as Error & { code?: string }).code
+ if (code === 'ERR_PACKAGE_PATH_NOT_EXPORTED' || code === 'ERR_UNSUPPORTED_DIR_IMPORT' || code === 'ENOTDIR') {
+ throw new TypeError(`Could not load \`${nuxtModule}\`. Is it installed?`)
+ }
+ if (code === 'MODULE_NOT_FOUND' || code === 'ERR_MODULE_NOT_FOUND') {
+ const module = MissingModuleMatcher.exec((error as Error).message)?.[1]
+ // verify that it's missing the nuxt module otherwise it may be a sub dependency of the module itself
+ // i.e. module is importing a module that is missing
+ if (module && !module.includes(nuxtModule as string)) {
+ throw new TypeError(`Error while importing module \`${nuxtModule}\`: ${error}`)
+ }
+ }
+ }
+
+ throw new TypeError(`Could not load \`${nuxtModule}\`. Is it installed?`)
+}
+
+// --- Internal ---
+
+export function getDirectory (p: string): string {
+ try {
+ // we need to target directories instead of module file paths themselves
+ // /home/user/project/node_modules/module/index.js -> /home/user/project/node_modules/module
+ return isAbsolute(p) && lstatSync(p).isFile() ? dirname(p) : p
+ } catch {
+ // maybe the path is absolute but does not exist, allow this to bubble up
+ }
+ return p
+}
+
+export const normalizeModuleTranspilePath = (p: string) => {
+ return getDirectory(p).split('node_modules/').pop() as string
+}
+
+const MissingModuleMatcher = /Cannot find module\s+['"]?([^'")\s]+)['"]?/i
+
+async function callLifecycleHooks (nuxtModule: NuxtModule<any, Partial<any>, false>, meta: ModuleMeta = {}, inlineOptions?: Record<string, unknown>, nuxt = useNuxt()) {
+ if (!meta.name || !meta.version) {
+ return
+ }
+ if (!nuxtModule.onInstall && !nuxtModule.onUpgrade) {
+ return
+ }
+
+ const rc = readRc({ dir: nuxt.options.rootDir, name: '.nuxtrc' })
+ const previousVersion = rc?.setups?.[meta.name]
+
+ try {
+ if (!previousVersion) {
+ await nuxtModule.onInstall?.(nuxt)
+ } else if (semver.gt(meta.version, previousVersion)) {
+ await nuxtModule.onUpgrade?.(nuxt, inlineOptions, previousVersion)
+ }
+ if (previousVersion !== meta.version) {
+ updateRc(
+ { setups: { [meta.name]: meta?.version } },
+ { dir: nuxt.options.rootDir, name: '.nuxtrc' },
+ )
+ }
+ } catch (e) {
+ logger.error(
+ `Error while executing ${!previousVersion ? 'install' : 'upgrade'} hook for module \`${meta.name}\`: ${e}`,
+ )
+ }
+}
+
+interface CallModuleOptions {
+ meta: ModuleMeta
+ modulePath?: string
+ nameOrPath?: string
+ localLayerModuleDirs: string[]
+}
+
+async function callModule (nuxt: Nuxt, nuxtModule: NuxtModule<any, Partial<any>, false>, moduleOptions: Record<string, unknown> = {}, options: CallModuleOptions) {
+ const modulePath = options.modulePath
+ const nameOrPath = options.nameOrPath
+ const localLayerModuleDirs = options.localLayerModuleDirs
+
+ const fn = () => nuxt.options.experimental?.debugModuleMutation && nuxt._asyncLocalStorageModule
+ ? nuxt._asyncLocalStorageModule.run(nuxtModule, () => nuxtModule(moduleOptions, nuxt))
+ : nuxtModule(moduleOptions, nuxt)
+
+ const res = options.meta.disabled ? false : await fn()
+
+ let entryPath: string | undefined
+ if (typeof modulePath === 'string') {
+ const parsed = parseNodeModulePath(modulePath)
+ if (parsed.name) {
+ const subpath = await lookupNodeModuleSubpath(modulePath) || '.'
+ entryPath = join(parsed.name, subpath === './' ? '.' : subpath)
+ }
+ if (res !== false) {
+ const moduleRoot = parsed.dir
+ ? parsed.dir + parsed.name
+ : await resolvePackageJSON(modulePath, { try: true }).then(r => r ? dirname(r) : modulePath)
+ nuxt.options.build.transpile.push(normalizeModuleTranspilePath(moduleRoot))
+ const directory = moduleRoot.replace(/\/?$/, '/')
+ if (moduleRoot !== nameOrPath && !localLayerModuleDirs.some(dir => directory.startsWith(dir))) {
+ nuxt.options.modulesDir.push(join(moduleRoot, 'node_modules'))
+ }
+ }
+ }
+
+ if (nameOrPath) {
+ entryPath ||= resolveAlias(nameOrPath, nuxt.options.alias)
+
+ if (entryPath !== nameOrPath) {
+ options.meta.rawPath = nameOrPath
+ }
+ }
+
+ nuxt.options._installedModules ||= []
+ nuxt.options._installedModules.push({
+ meta: options.meta,
+ module: nuxtModule,
+ timings: (res || {} as Record<string, undefined>).timings,
+ entryPath,
+ })
+}
diff --git a/packages/kit/src/nitro-types.ts b/packages/kit/src/nitro-types.ts
new file mode 100644
index 000000000000..9a7c65b905e7
--- /dev/null
+++ b/packages/kit/src/nitro-types.ts
@@ -0,0 +1,20 @@
+import type * as NitroV2 from 'nitropack/types'
+import type * as NitroV3 from 'nitro/types'
+
+type isNitroV2 = 'options' extends keyof NitroV2.Nitro
+ ? '___INVALID' extends keyof NitroV2.Nitro
+ ? false
+ : true
+ : false
+
+type isNitroV3 = 'options' extends keyof NitroV3.Nitro
+ ? '___INVALID' extends keyof NitroV3.Nitro
+ ? false
+ : true
+ : false
+
+export type Nitro = isNitroV2 extends true ? isNitroV3 extends true ? NitroV2.Nitro | NitroV3.Nitro : NitroV2.Nitro : NitroV3.Nitro
+export type NitroDevEventHandler = isNitroV2 extends true ? isNitroV3 extends true ? NitroV2.NitroDevEventHandler | NitroV3.NitroDevEventHandler : NitroV2.NitroDevEventHandler : NitroV3.NitroDevEventHandler
+export type NitroEventHandler = isNitroV2 extends true ? isNitroV3 extends true ? NitroV2.NitroEventHandler | NitroV3.NitroEventHandler : NitroV2.NitroEventHandler : NitroV3.NitroEventHandler
+export type NitroRouteConfig = isNitroV2 extends true ? isNitroV3 extends true ? NitroV2.NitroRouteConfig | NitroV3.NitroRouteConfig : NitroV2.NitroRouteConfig : NitroV3.NitroRouteConfig
+export type NitroRuntimeConfig = isNitroV2 extends true ? isNitroV3 extends true ? NitroV2.NitroRuntimeConfig | NitroV3.NitroRuntimeConfig : NitroV2.NitroRuntimeConfig : NitroV3.NitroRuntimeConfig
diff --git a/packages/kit/src/nitro.ts b/packages/kit/src/nitro.ts
new file mode 100644
index 000000000000..a61f2f51305c
--- /dev/null
+++ b/packages/kit/src/nitro.ts
@@ -0,0 +1,127 @@
+import type { Import } from 'unimport'
+import { normalize } from 'pathe'
+
+import { useNuxt } from './context.ts'
+import type { Nitro, NitroDevEventHandler, NitroEventHandler } from './nitro-types.ts'
+import { toArray } from './utils.ts'
+
+const HANDLER_METHOD_RE = /\.(get|head|patch|post|put|delete|connect|options|trace)(\.\w+)*$/
+type HANDLER_METHOD_RE = 'get' | 'head' | 'patch' | 'post' | 'put' | 'delete' | 'connect' | 'options' | 'trace'
+/**
+ * normalize handler object
+ *
+ */
+function normalizeHandlerMethod (handler: NitroEventHandler) {
+ // retrieve method from handler file name
+ const [, method = undefined] = handler.handler.match(HANDLER_METHOD_RE) || []
+ return {
+ method: method?.toUpperCase() as Uppercase<HANDLER_METHOD_RE> | undefined,
+ ...handler,
+ handler: normalize(handler.handler),
+ }
+}
+
+/**
+ * Adds a nitro server handler
+ *
+ */
+export function addServerHandler (handler: NitroEventHandler): void {
+ useNuxt().options.serverHandlers.push(normalizeHandlerMethod(handler) as any)
+}
+
+/**
+ * Adds a nitro server handler for development-only
+ *
+ */
+export function addDevServerHandler (handler: NitroDevEventHandler): void {
+ useNuxt().options.devServerHandlers.push(handler as any)
+}
+
+/**
+ * Adds a Nitro plugin
+ */
+export function addServerPlugin (plugin: string): void {
+ const nuxt = useNuxt()
+ nuxt.options.nitro.plugins ||= []
+ nuxt.options.nitro.plugins.push(normalize(plugin))
+}
+
+/**
+ * Adds routes to be prerendered
+ */
+export function addPrerenderRoutes (routes: string | string[]): void {
+ const nuxt = useNuxt()
+
+ routes = toArray(routes).filter(Boolean)
+ if (!routes.length) {
+ return
+ }
+ nuxt.hook('prerender:routes', (ctx) => {
+ for (const route of routes) {
+ ctx.routes.add(route)
+ }
+ })
+}
+
+/**
+ * Access to the Nitro instance
+ *
+ * **Note:** You can call `useNitro()` only after `ready` hook.
+ *
+ * **Note:** Changes to the Nitro instance configuration are not applied.
+ * @example
+ *
+ * ```ts
+ * nuxt.hook('ready', () => {
+ * console.log(useNitro())
+ * })
+ * ```
+ */
+export function useNitro (): Nitro {
+ const nuxt = useNuxt()
+ if (!(nuxt as any)._nitro) {
+ throw new Error('Nitro is not initialized yet. You can call `useNitro()` only after `ready` hook.')
+ }
+ return (nuxt as any)._nitro
+}
+
+/**
+ * Add server imports to be auto-imported by Nitro
+ */
+export function addServerImports (imports: Import | Import[]): void {
+ const nuxt = useNuxt()
+ const _imports = toArray(imports)
+ nuxt.hook('nitro:config', (config) => {
+ config.imports ||= {}
+ config.imports.imports ||= []
+ config.imports.imports.push(..._imports)
+ })
+}
+
+/**
+ * Add directories to be scanned for auto-imports by Nitro
+ */
+export function addServerImportsDir (dirs: string | string[], opts: { prepend?: boolean } = {}): void {
+ const nuxt = useNuxt()
+ const _dirs = toArray(dirs)
+ nuxt.hook('nitro:config', (config) => {
+ config.imports ||= {}
+ config.imports.dirs ||= []
+ config.imports.dirs[opts.prepend ? 'unshift' : 'push'](..._dirs)
+ })
+}
+
+/**
+ * Add directories to be scanned by Nitro. It will check for subdirectories,
+ * which will be registered just like the `~~/server` folder is.
+ */
+export function addServerScanDir (dirs: string | string[], opts: { prepend?: boolean } = {}): void {
+ const nuxt = useNuxt()
+ nuxt.hook('nitro:config', (config) => {
+ config.scanDirs ||= []
+
+ for (const dir of toArray(dirs)) {
+ config.scanDirs[opts.prepend ? 'unshift' : 'push'](dir)
+ }
+ })
+}
diff --git a/packages/kit/src/pages.ts b/packages/kit/src/pages.ts
new file mode 100644
index 000000000000..05ee6c035b78
--- /dev/null
+++ b/packages/kit/src/pages.ts
@@ -0,0 +1,65 @@
+import type { NuxtHooks, NuxtMiddleware } from '@nuxt/schema'
+import { defu } from 'defu'
+
+import { useNuxt } from './context.ts'
+import { logger } from './logger.ts'
+import type { NitroRouteConfig } from './nitro-types.ts'
+import { toArray } from './utils.ts'
+
+export function extendPages (cb: NuxtHooks['pages:extend']): void {
+ useNuxt().hook('pages:extend', cb)
+}
+
+export interface ExtendRouteRulesOptions {
+ /**
+ * Override route rule config
+ * @default false
+ */
+ override?: boolean
+}
+
+export function extendRouteRules (route: string, rule: NitroRouteConfig, options: ExtendRouteRulesOptions = {}): void {
+ const nuxt = useNuxt()
+ for (const opts of [nuxt.options, nuxt.options.nitro]) {
+ opts.routeRules ||= {}
+ opts.routeRules[route] = options.override
+ ? defu(rule, opts.routeRules[route] as any)
+ : defu(opts.routeRules[route] as any, rule)
+ }
+}
+
+export interface AddRouteMiddlewareOptions {
+ /**
+ * Override existing middleware with the same name, if it exists
+ * @default false
+ */
+ override?: boolean
+ /**
+ * Prepend middleware to the list
+ * @default false
+ */
+ prepend?: boolean
+}
+
+export function addRouteMiddleware (input: NuxtMiddleware | NuxtMiddleware[], options: AddRouteMiddlewareOptions = {}): void {
+ const nuxt = useNuxt()
+ const middlewares = toArray(input)
+ nuxt.hook('app:resolve', (app) => {
+ for (const middleware of middlewares) {
+ const find = app.middleware.findIndex(item => item.name === middleware.name)
+ if (find >= 0) {
+ const foundPath = app.middleware[find]!.path
+ if (foundPath === middleware.path) { continue }
+ if (options.override === true) {
+ app.middleware[find] = { ...middleware }
+ } else {
+ logger.warn(`'${middleware.name}' middleware already exists at '${foundPath}'. You can set \`override: true\` to replace it.`)
+ }
+ } else if (options.prepend === true) {
+ app.middleware.unshift({ ...middleware })
+ } else {
+ app.middleware.push({ ...middleware })
+ }
+ }
+ })
+}
diff --git a/packages/kit/src/plugin.ts b/packages/kit/src/plugin.ts
new file mode 100644
index 000000000000..b6906219eda2
--- /dev/null
+++ b/packages/kit/src/plugin.ts
@@ -0,0 +1,104 @@
+import { existsSync } from 'node:fs'
+import { isAbsolute } from 'node:path'
+import { normalize } from 'pathe'
+import type { NuxtPlugin, NuxtPluginTemplate } from '@nuxt/schema'
+import { resolveModulePath } from 'exsolve'
+import { MODE_RE, filterInPlace } from './utils.ts'
+import { tryUseNuxt, useNuxt } from './context.ts'
+import { addTemplate } from './template.ts'
+import { resolveAlias } from './resolve.ts'
+
+/**
+ * Normalize a nuxt plugin object
+ */
+const pluginSymbol = Symbol.for('nuxt plugin')
+export function normalizePlugin (plugin: NuxtPlugin | string): NuxtPlugin {
+ // Normalize src
+ if (typeof plugin === 'string') {
+ plugin = { src: plugin }
+ } else {
+ plugin = { ...plugin }
+ }
+
+ if (pluginSymbol in plugin) {
+ return plugin
+ }
+
+ if (!plugin.src) {
+ throw new Error('Invalid plugin. src option is required: ' + JSON.stringify(plugin))
+ }
+
+ // Normalize full path to plugin
+ plugin.src = normalize(resolveAlias(plugin.src))
+
+ if (!existsSync(plugin.src) && isAbsolute(plugin.src)) {
+ try {
+ plugin.src = resolveModulePath(plugin.src, {
+ extensions: tryUseNuxt()?.options.extensions ?? ['.js', '.mjs', '.cjs', '.ts', '.tsx', '.mts', '.cts'],
+ })
+ } catch {
+ // ignore errors as the file may be in the nuxt vfs
+ }
+ }
+
+ // Normalize mode
+ // eslint-disable-next-line @typescript-eslint/no-deprecated
+ if (plugin.ssr) {
+ plugin.mode = 'server'
+ }
+ if (!plugin.mode) {
+ const [, mode = 'all'] = plugin.src.match(MODE_RE) || []
+ plugin.mode = mode as 'all' | 'client' | 'server'
+ }
+
+ // @ts-expect-error not adding symbol to types to avoid conflicts
+ plugin[pluginSymbol] = true
+
+ return plugin
+}
+
+/**
+ * Registers a nuxt plugin and to the plugins array.
+ *
+ * Note: You can use mode or .client and .server modifiers with fileName option
+ * to use plugin only in client or server side.
+ *
+ * Note: By default plugin is prepended to the plugins array. You can use second argument to append (push) instead.
+ * @example
+ * ```js
+ * import { createResolver } from '@nuxt/kit'
+ * const resolver = createResolver(import.meta.url)
+ *
+ * addPlugin({
+ * src: resolver.resolve('templates/foo.js'),
+ * filename: 'foo.server.js' // [optional] only include in server bundle
+ * })
+ * ```
+ */
+export interface AddPluginOptions { append?: boolean }
+export function addPlugin (_plugin: NuxtPlugin | string, opts: AddPluginOptions = {}): NuxtPlugin {
+ const nuxt = useNuxt()
+
+ // Normalize plugin
+ const plugin = normalizePlugin(_plugin)
+
+ // Remove any existing plugin with the same src
+ filterInPlace(nuxt.options.plugins, p => normalizePlugin(p).src !== plugin.src)
+
+ // Prepend to array by default to be before user provided plugins since is usually used by modules
+ nuxt.options.plugins[opts.append ? 'push' : 'unshift'](plugin)
+
+ return plugin
+}
+
+/**
+ * Adds a template and registers as a nuxt plugin.
+ */
+export function addPluginTemplate (plugin: NuxtPluginTemplate | string, opts: AddPluginOptions = {}): NuxtPlugin {
+ const normalizedPlugin: NuxtPlugin = typeof plugin === 'string'
+ ? { src: plugin }
+ // Update plugin src to template destination
+ : { ...plugin, src: addTemplate(plugin).dst! }
+
+ return addPlugin(normalizedPlugin, opts)
+}
diff --git a/packages/kit/src/resolve.test.ts b/packages/kit/src/resolve.test.ts
new file mode 100644
index 000000000000..bd4e2525cbe8
--- /dev/null
+++ b/packages/kit/src/resolve.test.ts
@@ -0,0 +1,56 @@
+import { stat } from 'node:fs/promises'
+import { describe, expect, it } from 'vitest'
+import { resolve } from 'pathe'
+import { withTrailingSlash } from 'ufo'
+import { loadNuxt } from './loader/nuxt.ts'
+import { findPath, resolveNuxtModule, resolvePath } from './resolve.ts'
+import { defineNuxtModule } from './module/define.ts'
+import { addTemplate } from './template.ts'
+
+const nuxt = await loadNuxt({
+ overrides: {
+ modules: [
+ defineNuxtModule(() => {
+ addTemplate({
+ filename: 'my-template.mjs',
+ getContents: () => 'export const myUtil = () => \'hello\'',
+ })
+ }),
+ ],
+ },
+})
+
+describe('resolvePath', () => {
+ it('should resolve paths correctly', async () => {
+ expect(await resolvePath('.nuxt/app.config')).toBe(resolve('.nuxt/app.config.mjs'))
+ })
+})
+
+describe('resolveNuxtModule', () => {
+ it('should resolve Nuxt module paths correctly', async () => {
+ const installedModulePaths = nuxt.options._installedModules.map(m => m.meta?.rawPath || m.entryPath!).filter(Boolean)
+ expect(installedModulePaths).toMatchInlineSnapshot(`
+ [
+ "@nuxt/devtools",
+ "@nuxt/telemetry",
+ ]
+ `)
+
+ const resolved = await resolveNuxtModule(withTrailingSlash(nuxt.options.rootDir), [
+ ...installedModulePaths,
+ '@nuxt/test-utils/module',
+ ])
+
+ expect(resolved.length).toBe(3)
+
+ for (const path of resolved) {
+ expect(await stat(path).then(r => r.isDirectory() && path.endsWith('node_modules/')).catch(() => false)).toBe(true)
+ }
+ })
+})
+
+describe('findPath', () => {
+ it('should find paths correctly', async () => {
+ expect(await findPath(resolve(nuxt.options.buildDir, 'my-template'), { virtual: true })).toBe(resolve(nuxt.options.buildDir, 'my-template.mjs'))
+ })
+})
diff --git a/packages/kit/src/resolve.ts b/packages/kit/src/resolve.ts
new file mode 100644
index 000000000000..a5b48b35b435
--- /dev/null
+++ b/packages/kit/src/resolve.ts
@@ -0,0 +1,289 @@
+import { promises as fsp } from 'node:fs'
+import { fileURLToPath } from 'node:url'
+import process from 'node:process'
+import { basename, dirname, isAbsolute, join, normalize, resolve } from 'pathe'
+import { type GlobOptions, glob } from 'tinyglobby'
+import { resolveModulePath } from 'exsolve'
+import { resolveAlias as _resolveAlias } from 'pathe/utils'
+import { parseNodeModulePath } from 'mlly'
+import { directoryToURL } from './internal/esm.ts'
+import { tryUseNuxt } from './context.ts'
+import { isIgnored } from './ignore.ts'
+import { type RequirePicked, toArray } from './utils.ts'
+
+export interface ResolvePathOptions {
+ /** Base for resolving paths from. Default is Nuxt rootDir. */
+ cwd?: string
+
+ /** An object of aliases. Default is Nuxt configured aliases. */
+ alias?: Record<string, string>
+
+ /**
+ * The file extensions to try.
+ * Default is Nuxt configured extensions.
+ *
+ * Isn't considered when `type` is set to `'dir'`.
+ */
+ extensions?: string[]
+
+ /**
+ * Whether to resolve files that exist in the Nuxt VFS (for example, as a Nuxt template).
+ * @default false
+ */
+ virtual?: boolean
+
+ /**
+ * Whether to fallback to the original path if the resolved path does not exist instead of returning the normalized input path.
+ * @default false
+ */
+ fallbackToOriginal?: boolean
+ /**
+ * The type of the path to be resolved.
+ * @default 'file'
+ */
+ type?: PathType
+}
+
+/**
+ * Resolve the full path to a file or a directory (based on the provided type), respecting Nuxt alias and extensions options.
+ *
+ * If a path cannot be resolved, normalized input will be returned unless the `fallbackToOriginal` option is set to `true`,
+ * in which case the original input path will be returned.
+ */
+export async function resolvePath (path: string, opts: ResolvePathOptions = {}): Promise<string> {
+ const { type = 'file' } = opts
+
+ const res = await _resolvePathGranularly(path, { ...opts, type })
+
+ if (res.type === type) {
+ return res.path
+ }
+
+ // Return normalized input
+ return opts.fallbackToOriginal ? path : res.path
+}
+
+/**
+ * Try to resolve first existing file in paths
+ */
+export async function findPath (paths: string | string[], opts?: ResolvePathOptions, pathType: PathType = 'file'): Promise<string | null> {
+ for (const path of toArray(paths)) {
+ const res = await _resolvePathGranularly(path, {
+ ...opts,
+ // TODO: this is for backwards compatibility, remove the `pathType` argument in Nuxt 5
+ type: opts?.type || pathType,
+ })
+
+ if (!res.type || (pathType && res.type !== pathType)) {
+ continue
+ }
+
+ // Check file system
+ if (res.virtual || await existsSensitive(res.path)) {
+ return res.path
+ }
+ }
+ return null
+}
+
+/**
+ * Resolve path aliases respecting Nuxt alias options
+ */
+export function resolveAlias (path: string, alias?: Record<string, string>): string {
+ alias ||= tryUseNuxt()?.options.alias || {}
+ return _resolveAlias(path, alias)
+}
+
+export interface Resolver {
+ resolve (...path: string[]): string
+ resolvePath (path: string, opts?: ResolvePathOptions): Promise<string>
+}
+
+/**
+ * Create a relative resolver
+ */
+export function createResolver (base: string | URL): Resolver {
+ if (!base) {
+ throw new Error('`base` argument is missing for createResolver(base)!')
+ }
+
+ base = base.toString()
+ if (base.startsWith('file://')) {
+ base = dirname(fileURLToPath(base))
+ }
+
+ return {
+ resolve: (...path) => resolve(base as string, ...path),
+ resolvePath: (path, opts) => resolvePath(path, { cwd: base as string, ...opts }),
+ }
+}
+
+export async function resolveNuxtModule (base: string, paths: string[]): Promise<string[]> {
+ const resolved: string[] = []
+ const resolver = createResolver(base)
+
+ for (const path of paths) {
+ if (path.startsWith(base)) {
+ resolved.push(path.split('/index.ts')[0]!)
+ continue
+ }
+ const resolvedPath = await resolver.resolvePath(path)
+ const dir = parseNodeModulePath(resolvedPath).dir
+ if (dir) {
+ resolved.push(dir)
+ continue
+ }
+ const index = resolvedPath.lastIndexOf(path)
+ resolved.push(index === -1 ? dirname(resolvedPath) : resolvedPath.slice(0, index + path.length))
+ }
+
+ return resolved
+}
+
+// --- Internal ---
+
+type PathType = 'file' | 'dir'
+
+interface PathResolution {
+ path: string
+ type?: PathType
+ virtual?: boolean
+}
+
+async function _resolvePathType (path: string, opts: ResolvePathOptions = {}, skipFs = false): Promise<PathResolution | undefined> {
+ if (opts?.virtual && existsInVFS(path)) {
+ return {
+ path,
+ type: 'file',
+ virtual: true,
+ }
+ }
+
+ if (skipFs) {
+ return
+ }
+
+ const fd = await fsp.open(path, 'r').catch(() => null)
+ try {
+ const stats = await fd?.stat()
+ if (stats) {
+ return {
+ path,
+ type: stats.isFile() ? 'file' : 'dir',
+ virtual: false,
+ }
+ }
+ } finally {
+ fd?.close()
+ }
+}
+
+function normalizeExtension (ext: string) {
+ return ext.startsWith('.') ? ext : `.${ext}`
+}
+
+async function _resolvePathGranularly (path: string, opts: RequirePicked<ResolvePathOptions, 'type'> = { type: 'file' }): Promise<PathResolution> {
+ // Always normalize input
+ const _path = path
+ path = normalize(path)
+
+ // Fast return if the path exists
+ if (isAbsolute(path)) {
+ const res = await _resolvePathType(path, opts)
+ if (res && res.type === opts.type) {
+ return res
+ }
+ }
+
+ // Use current nuxt options
+ const nuxt = tryUseNuxt()
+ const cwd = opts.cwd || (nuxt ? nuxt.options.rootDir : process.cwd())
+ const extensions = opts.extensions || (nuxt ? nuxt.options.extensions : ['.ts', '.mjs', '.cjs', '.json'])
+ const modulesDir = nuxt ? nuxt.options.modulesDir : []
+
+ // Resolve aliases
+ path = _resolveAlias(path, opts.alias ?? nuxt?.options.alias ?? {})
+
+ // Resolve relative to cwd
+ if (!isAbsolute(path)) {
+ path = resolve(cwd, path)
+ }
+
+ const res = await _resolvePathType(path, opts)
+ if (res && res.type === opts.type) {
+ return res
+ }
+
+ // Check possible extensions
+ if (opts.type === 'file') {
+ for (const ext of extensions) {
+ const normalizedExt = normalizeExtension(ext)
+
+ // path.[ext]
+ const extPath = await _resolvePathType(path + normalizedExt, opts)
+ if (extPath && extPath.type === 'file') {
+ return extPath
+ }
+
+ // path/index.[ext]
+ const indexPath = await _resolvePathType(join(path, 'index' + normalizedExt), opts, res?.type !== 'dir' /* skip checking if parent is not a directory */)
+ if (indexPath && indexPath.type === 'file') {
+ return indexPath
+ }
+ }
+
+ // Try to resolve as module id
+ const resolvedModulePath = resolveModulePath(_path, {
+ try: true,
+ suffixes: ['', 'index'],
+ from: [cwd, ...modulesDir].map(d => directoryToURL(d)),
+ })
+ if (resolvedModulePath) {
+ return {
+ path: resolvedModulePath,
+ type: 'file',
+ virtual: false,
+ }
+ }
+ }
+
+ // Return normalized input
+ return {
+ path,
+ }
+}
+
+async function existsSensitive (path: string) {
+ const dirFiles = new Set(await fsp.readdir(dirname(path)).catch(() => []))
+ return dirFiles.has(basename(path))
+}
+
+function existsInVFS (path: string, nuxt = tryUseNuxt()) {
+ if (!nuxt) { return false }
+
+ if (path in nuxt.vfs) {
+ return true
+ }
+
+ const templates = nuxt.apps.default?.templates ?? nuxt.options.build.templates
+ return templates.some(template => template.dst === path)
+}
+
+/**
+ * Resolve absolute file paths in the provided directory with respect to `.nuxtignore` and return them sorted.
+ * @param path path to the directory to resolve files in
+ * @param pattern glob pattern or an array of glob patterns to match files
+ * @param opts options for globbing
+ * @param opts.followSymbolicLinks whether to follow symbolic links, default is `true`
+ * @param opts.ignore additional glob patterns to ignore
+ * @returns sorted array of absolute file paths
+ */
+export async function resolveFiles (path: string, pattern: string | string[], opts: { followSymbolicLinks?: boolean, ignore?: GlobOptions['ignore'] } = {}): Promise<string[]> {
+ const files: string[] = []
+ for (const p of await glob(pattern, { cwd: path, followSymbolicLinks: opts.followSymbolicLinks ?? true, absolute: true, ignore: opts.ignore })) {
+ if (!isIgnored(p)) {
+ files.push(p)
+ }
+ }
+ return files.sort()
+}
diff --git a/packages/kit/src/runtime-config.test.ts b/packages/kit/src/runtime-config.test.ts
new file mode 100644
index 000000000000..6f3bcad0b33b
--- /dev/null
+++ b/packages/kit/src/runtime-config.test.ts
@@ -0,0 +1,80 @@
+import { afterEach, describe, expect, it, vi } from 'vitest'
+import * as context from './context.ts'
+import { useRuntimeConfig } from './runtime-config.ts'
+
+const { mockKlona } = vi.hoisted(() => ({
+ mockKlona: vi.fn(),
+}))
+vi.mock('klona', () => ({
+ klona: mockKlona,
+}))
+
+const testCases = [
+ {
+ description:
+ 'should return runtime config with environment variables applied',
+ runtimeConfig: {
+ apiUrl: 'http://localhost',
+ authUrl: 'http://auth.com',
+ },
+ envExpansion: true,
+ env: {
+ NITRO_API_URL: 'http://example.com',
+ },
+ expected: {
+ apiUrl: 'http://example.com',
+ authUrl: 'http://auth.com',
+ },
+ },
+ {
+ description: 'should expand environment variables in strings',
+ runtimeConfig: {
+ apiUrl: '{{BASE_URL}}/api',
+ mail: '{{MAIL_SCHEME}}://{{MAIL_HOST}}:{{MAIL_PORT}}',
+ },
+ envExpansion: true,
+ env: {
+ BASE_URL: 'http://example.com',
+ MAIL_SCHEME: 'http',
+ MAIL_HOST: 'localhost',
+ MAIL_PORT: '3366',
+ },
+ expected: {
+ apiUrl: 'http://example.com/api',
+ mail: 'http://localhost:3366',
+ },
+ },
+ {
+ description:
+ 'should not expand environment variables if envExpansion is false',
+ runtimeConfig: {
+ apiUrl: '{{BASE_URL}}/api',
+ someUrl: '',
+ },
+ envExpansion: false,
+ env: {
+ BASE_URL: 'http://example1.com',
+ NITRO_NOT_API_URL: 'http://example2.com',
+ NUXT_SOME_URL: 'http://example3.com',
+ },
+ expected: {
+ apiUrl: '{{BASE_URL}}/api',
+ someUrl: 'http://example3.com',
+ },
+ },
+]
+
+describe('useRuntimeConfig', () => {
+ afterEach(() => {
+ vi.unstubAllEnvs()
+ vi.restoreAllMocks()
+ })
+
+ it.each(testCases)('$description', ({ runtimeConfig, envExpansion, env, expected }) => {
+ vi.spyOn(context, 'useNuxt').mockReturnValue({ options: { nitro: { runtimeConfig, experimental: { envExpansion } } } } as any)
+ mockKlona.mockReturnValue(runtimeConfig)
+ Object.entries(env).forEach(([key, value]) => vi.stubEnv(key, value))
+
+ expect(useRuntimeConfig()).toEqual(expected)
+ })
+})
diff --git a/packages/kit/src/runtime-config.ts b/packages/kit/src/runtime-config.ts
new file mode 100644
index 000000000000..ddaea935716f
--- /dev/null
+++ b/packages/kit/src/runtime-config.ts
@@ -0,0 +1,103 @@
+import process from 'node:process'
+import destr from 'destr'
+import { snakeCase } from 'scule'
+import { klona } from 'klona'
+
+import { defu } from 'defu'
+import { useNuxt } from './context.ts'
+import { useNitro } from './nitro.ts'
+
+/**
+ * Access 'resolved' Nuxt runtime configuration, with values updated from environment.
+ *
+ * This mirrors the runtime behavior of Nitro.
+ */
+export function useRuntimeConfig (): Record<string, any> {
+ const nuxt = useNuxt()
+ return applyEnv(klona(nuxt.options.nitro.runtimeConfig!), {
+ prefix: 'NITRO_',
+ altPrefix: 'NUXT_',
+ envExpansion: nuxt.options.nitro.experimental?.envExpansion ?? !!process.env.NITRO_ENV_EXPANSION,
+ })
+}
+
+/**
+ * Update Nuxt runtime configuration.
+ */
+export function updateRuntimeConfig (runtimeConfig: Record<string, unknown>): void | Promise<void> {
+ const nuxt = useNuxt()
+ Object.assign(nuxt.options.nitro.runtimeConfig as Record<string, unknown>, defu(runtimeConfig, nuxt.options.nitro.runtimeConfig))
+
+ try {
+ return useNitro().updateConfig({ runtimeConfig: runtimeConfig as any })
+ } catch {
+ // Nitro is not yet initialised - we can safely ignore this error
+ }
+}
+
+/**
+ * https://github.com/nitrojs/nitro/blob/v2/src/runtime/internal/utils.env.ts.
+*
+ * These utils will be replaced by util exposed from nitropack. See https://github.com/nitrojs/nitro/pull/2404
+ * for more context and future plans.)
+ *
+ * @internal
+ */
+
+type EnvOptions = {
+ prefix?: string
+ altPrefix?: string
+ envExpansion?: boolean
+}
+
+function getEnv (key: string, opts: EnvOptions, env = process.env) {
+ const envKey = snakeCase(key).toUpperCase()
+ return destr(
+ env[opts.prefix + envKey] ?? env[opts.altPrefix + envKey],
+ )
+}
+
+function _isObject (input: unknown) {
+ return typeof input === 'object' && !Array.isArray(input)
+}
+
+function applyEnv (
+ obj: Record<string, any>,
+ opts: EnvOptions,
+ parentKey = '',
+) {
+ for (const key in obj) {
+ const subKey = parentKey ? `${parentKey}_${key}` : key
+ const envValue = getEnv(subKey, opts)
+ if (_isObject(obj[key])) {
+ // Same as before
+ if (_isObject(envValue)) {
+ obj[key] = { ...(obj[key] as any), ...(envValue as any) }
+ applyEnv(obj[key], opts, subKey)
+ } else if (envValue === undefined) {
+ // If envValue is undefined
+ // Then proceed to nested properties
+ applyEnv(obj[key], opts, subKey)
+ } else {
+ // If envValue is a primitive other than undefined
+ // Then set objValue and ignore the nested properties
+ obj[key] = envValue ?? obj[key]
+ }
+ } else {
+ obj[key] = envValue ?? obj[key]
+ }
+ // Experimental env expansion
+ if (opts.envExpansion && typeof obj[key] === 'string') {
+ obj[key] = _expandFromEnv(obj[key])
+ }
+ }
+ return obj
+}
+
+const envExpandRx = /\{\{([^{}]*)\}\}/g
+
+function _expandFromEnv (value: string, env: Record<string, any> = process.env) {
+ return value.replace(envExpandRx, (match, key) => {
+ return env[key] || match
+ })
+}
diff --git a/packages/kit/src/template.ts b/packages/kit/src/template.ts
new file mode 100644
index 000000000000..7f22d826179a
--- /dev/null
+++ b/packages/kit/src/template.ts
@@ -0,0 +1,682 @@
+import { existsSync, promises as fsp } from 'node:fs'
+import { fileURLToPath } from 'node:url'
+import { basename, isAbsolute, join, normalize, parse, relative, resolve } from 'pathe'
+import { hash } from 'ohash'
+import type { Nuxt, NuxtServerTemplate, NuxtTemplate, NuxtTypeTemplate, ResolvedNuxtTemplate, TSReference } from '@nuxt/schema'
+import { defu } from 'defu'
+import type { TSConfig } from 'pkg-types'
+import { gte } from 'semver'
+import { readPackageJSON } from 'pkg-types'
+import { resolveModulePath } from 'exsolve'
+import { captureStackTrace } from 'errx'
+
+import { distDirURL, filterInPlace } from './utils.ts'
+import { directoryToURL } from './internal/esm.ts'
+import { getDirectory } from './module/install.ts'
+import { tryUseNuxt, useNuxt } from './context.ts'
+import { resolveNuxtModule } from './resolve.ts'
+import { getLayerDirectories } from './layers.ts'
+import type { LayerDirectories } from './layers.ts'
+
+/**
+ * Renders given template during build into the virtual file system (and optionally to disk in the project `buildDir`)
+ */
+export function addTemplate<T> (_template: NuxtTemplate<T> | string): ResolvedNuxtTemplate<T> {
+ const nuxt = useNuxt()
+
+ // Normalize template
+ const template = normalizeTemplate(_template)
+
+ // Remove any existing template with the same destination path
+ filterInPlace(nuxt.options.build.templates, p => (p.dst || normalizeTemplate(p).dst) !== template.dst)
+
+ try {
+ const distDir = distDirURL.toString()
+ const { source } = captureStackTrace().find(e => e.source && !e.source.startsWith(distDir)) ?? {}
+ if (source) {
+ const path = normalize(fileURLToPath(source))
+ if (existsSync(path)) {
+ template._path = path
+ }
+ }
+ } catch {
+ // ignore errors as this is an additive feature
+ }
+
+ // Add to templates array
+ nuxt.options.build.templates.push(template)
+
+ return template
+}
+
+/**
+ * Adds a virtual file that can be used within the Nuxt Nitro server build.
+ */
+export function addServerTemplate (template: NuxtServerTemplate): NuxtServerTemplate {
+ const nuxt = useNuxt()
+
+ nuxt.options.nitro.virtual ||= {}
+ nuxt.options.nitro.virtual[template.filename] = template.getContents
+
+ return template
+}
+
+/**
+ * Renders given types during build to disk in the project `buildDir`
+ * and register them as types.
+ *
+ * You can pass a second context object to specify in which context the type should be added.
+ *
+ * If no context object is passed, then it will only be added to the nuxt context.
+ */
+export function addTypeTemplate<T> (_template: NuxtTypeTemplate<T>, context?: { nitro?: boolean, nuxt?: boolean, node?: boolean, shared?: boolean }): ResolvedNuxtTemplate<T> {
+ const nuxt = useNuxt()
+
+ const template = addTemplate(_template)
+
+ if (!template.filename.endsWith('.d.ts')) {
+ throw new Error(`Invalid type template. Filename must end with .d.ts : "${template.filename}"`)
+ }
+
+ // Add template to types reference
+ if (!context || context.nuxt) {
+ nuxt.hook('prepare:types', (payload) => {
+ payload.references ||= []
+ payload.references.push({ path: template.dst })
+ })
+ }
+ if (context?.node) {
+ nuxt.hook('prepare:types', (payload) => {
+ payload.nodeReferences ||= []
+ payload.nodeReferences.push({ path: template.dst })
+ })
+ }
+ if (context?.shared) {
+ nuxt.hook('prepare:types', (payload) => {
+ payload.sharedReferences ||= []
+ payload.sharedReferences.push({ path: template.dst })
+ })
+ }
+
+ if (!context || context.nuxt || context.shared) {
+ // expose global types to vue compiler
+ nuxt.options.vite.vue = defu(nuxt.options.vite.vue, {
+ script: {
+ globalTypeFiles: [template.dst],
+ },
+ })
+ }
+
+ if (context?.nitro) {
+ nuxt.hook('nitro:prepare:types', (payload) => {
+ payload.references ||= []
+ payload.references.push({ path: template.dst })
+ })
+ }
+
+ return template
+}
+
+/**
+ * Normalize a nuxt template object
+ */
+export function normalizeTemplate<T> (template: NuxtTemplate<T> | string, buildDir?: string): ResolvedNuxtTemplate<T> {
+ if (!template) {
+ throw new Error('Invalid template: ' + JSON.stringify(template))
+ }
+
+ // Normalize
+ if (typeof template === 'string') {
+ template = { src: template }
+ } else {
+ template = { ...template }
+ }
+
+ // Use src if provided
+ if (template.src) {
+ if (!existsSync(template.src)) {
+ throw new Error('Template not found: ' + template.src)
+ }
+ if (!template.filename) {
+ const srcPath = parse(template.src)
+ template.filename = (template as any).fileName || `${basename(srcPath.dir)}.${srcPath.name}.${hash(template.src).replace(/-/g, '_')}${srcPath.ext}`
+ }
+ }
+
+ if (!template.src && !template.getContents) {
+ throw new Error('Invalid template. Either `getContents` or `src` should be provided: ' + JSON.stringify(template))
+ }
+
+ if (!template.filename) {
+ throw new Error('Invalid template. `filename` must be provided: ' + JSON.stringify(template))
+ }
+
+ // Always write declaration files
+ if (template.filename.endsWith('.d.ts')) {
+ template.write = true
+ }
+
+ // Resolve dst
+ template.dst ||= resolve(buildDir ?? useNuxt().options.buildDir, template.filename)
+
+ return template as ResolvedNuxtTemplate<T>
+}
+
+/**
+ * Trigger rebuilding Nuxt templates
+ *
+ * You can pass a filter within the options to selectively regenerate a subset of templates.
+ */
+export async function updateTemplates (options?: { filter?: (template: ResolvedNuxtTemplate<any>) => boolean }): Promise<void> {
+ await tryUseNuxt()?.hooks.callHook('builder:generateApp', options)
+}
+
+interface LayerPaths {
+ nuxt: string[]
+ nitro: string[]
+ node: string[]
+ shared: string[]
+ sharedDeclarations: string[]
+ globalDeclarations: string[]
+}
+
+export function resolveLayerPaths (dirs: LayerDirectories, projectBuildDir: string): LayerPaths {
+ const relativeRootDir = relativeWithDot(projectBuildDir, dirs.root)
+ const relativeSrcDir = relativeWithDot(projectBuildDir, dirs.app)
+ const relativeModulesDir = relativeWithDot(projectBuildDir, dirs.modules)
+ const relativeSharedDir = relativeWithDot(projectBuildDir, dirs.shared)
+ return {
+ nuxt: [
+ join(relativeSrcDir, '**/*'),
+ join(relativeModulesDir, `*/runtime/**/*`),
+ join(relativeRootDir, `test/nuxt/**/*`),
+ join(relativeRootDir, `tests/nuxt/**/*`),
+ join(relativeRootDir, `layers/*/app/**/*`),
+ join(relativeRootDir, `layers/*/modules/*/runtime/**/*`),
+ ],
+ nitro: [
+ join(relativeModulesDir, `*/runtime/server/**/*`),
+ join(relativeRootDir, `layers/*/server/**/*`),
+ join(relativeRootDir, `layers/*/modules/*/runtime/server/**/*`),
+ ],
+ node: [
+ join(relativeModulesDir, `*.*`),
+ join(relativeRootDir, `nuxt.config.*`),
+ join(relativeRootDir, `.config/nuxt.*`),
+ join(relativeRootDir, `layers/*/nuxt.config.*`),
+ join(relativeRootDir, `layers/*/.config/nuxt.*`),
+ join(relativeRootDir, `layers/*/modules/**/*`),
+ ],
+ shared: [
+ join(relativeSharedDir, `**/*`),
+ join(relativeModulesDir, `*/shared/**/*`),
+ join(relativeRootDir, `layers/*/shared/**/*`),
+ ],
+ sharedDeclarations: [
+ join(relativeSharedDir, `**/*.d.ts`),
+ join(relativeModulesDir, `*/shared/**/*.d.ts`),
+ join(relativeRootDir, `layers/*/shared/**/*.d.ts`),
+ ],
+ globalDeclarations: [
+ join(relativeRootDir, `*.d.ts`),
+ join(relativeRootDir, `layers/*/*.d.ts`),
+ ],
+ }
+}
+
+const EXTENSION_RE = /\b(?:\.d\.[cm]?ts|\.\w+)$/g
+// Exclude bridge alias types to support Volar
+const excludedAlias = [/^@vue\/.*$/, /^#internal\/nuxt/]
+
+interface GenerateTypesReturn {
+ declaration: string
+ sharedTsConfig: TSConfig
+ sharedDeclaration: string
+ nodeTsConfig: TSConfig
+ nodeDeclaration: string
+ tsConfig: TSConfig
+ legacyTsConfig: TSConfig
+}
+export async function _generateTypes (nuxt: Nuxt): Promise<GenerateTypesReturn> {
+ const include = new Set<string>(['./nuxt.d.ts'])
+ const nodeInclude = new Set<string>(['./nuxt.node.d.ts'])
+ const sharedInclude = new Set<string>(['./nuxt.shared.d.ts'])
+ const legacyInclude = new Set<string>([...include, ...nodeInclude])
+
+ const exclude = new Set<string>()
+ const nodeExclude = new Set<string>()
+ const sharedExclude = new Set<string>()
+ const legacyExclude = new Set<string>()
+
+ if (nuxt.options.typescript.includeWorkspace && nuxt.options.workspaceDir !== nuxt.options.srcDir) {
+ include.add(join(relative(nuxt.options.buildDir, nuxt.options.workspaceDir), '**/*'))
+ legacyInclude.add(join(relative(nuxt.options.buildDir, nuxt.options.workspaceDir), '**/*'))
+ }
+
+ const layerDirs = getLayerDirectories(nuxt)
+
+ const sourceDirs = layerDirs.map(layer => layer.app)
+
+ // node_modules folders
+ for (const dir of nuxt.options.modulesDir) {
+ // we only need to exclude node_modules directories if they are
+ // being included automatically by being inside the source directory
+ if (!sourceDirs.some(srcDir => dir.startsWith(srcDir))) {
+ exclude.add(relativeWithDot(nuxt.options.buildDir, dir))
+ }
+ nodeExclude.add(relativeWithDot(nuxt.options.buildDir, dir))
+ legacyExclude.add(relativeWithDot(nuxt.options.buildDir, dir))
+ }
+
+ // nitro generate output: https://github.com/nuxt/nuxt/blob/main/packages/nitro-server/src/index.ts
+ // + nitro generate .data in development when kv storage is used
+ for (const dir of ['dist', '.data']) {
+ exclude.add(relativeWithDot(nuxt.options.buildDir, resolve(nuxt.options.rootDir, dir)))
+ nodeExclude.add(relativeWithDot(nuxt.options.buildDir, resolve(nuxt.options.rootDir, dir)))
+ legacyExclude.add(relativeWithDot(nuxt.options.buildDir, resolve(nuxt.options.rootDir, dir)))
+ }
+
+ const rootDirWithSlash = withTrailingSlash(nuxt.options.rootDir)
+ for (const dirs of layerDirs) {
+ if (!dirs.app.startsWith(rootDirWithSlash) || dirs.root === rootDirWithSlash || dirs.app.includes('node_modules')) {
+ const rootGlob = join(relativeWithDot(nuxt.options.buildDir, dirs.root), '**/*')
+ const paths = resolveLayerPaths(dirs, nuxt.options.buildDir)
+ for (const path of paths.nuxt) {
+ include.add(path)
+ legacyInclude.add(path)
+ if (path !== rootGlob) {
+ nodeExclude.add(path)
+ }
+ }
+ for (const path of paths.nitro) {
+ exclude.add(path)
+ nodeExclude.add(path)
+ legacyExclude.add(path)
+ }
+ for (const path of paths.node) {
+ nodeInclude.add(path)
+ legacyInclude.add(path)
+ exclude.add(path)
+ }
+ for (const path of paths.shared) {
+ legacyInclude.add(path)
+ sharedInclude.add(path)
+ }
+ for (const path of paths.sharedDeclarations) {
+ include.add(path)
+ }
+ for (const path of paths.globalDeclarations) {
+ include.add(path)
+ legacyInclude.add(path)
+ sharedInclude.add(path)
+ }
+ }
+ }
+
+ const moduleEntryPaths: string[] = []
+ for (const m of nuxt.options._installedModules) {
+ const path = m.meta?.rawPath || m.entryPath
+ if (path) {
+ moduleEntryPaths.push(getDirectory(path))
+ }
+ }
+
+ const modulePaths = await resolveNuxtModule(rootDirWithSlash, moduleEntryPaths)
+
+ for (const path of modulePaths) {
+ const relative = relativeWithDot(nuxt.options.buildDir, path)
+ if (!path.includes('node_modules') && path.startsWith(rootDirWithSlash)) {
+ include.add(join(relative, 'runtime'))
+ include.add(join(relative, 'dist/runtime'))
+ nodeInclude.add(join(relative, '*.*'))
+ }
+
+ legacyInclude.add(join(relative, 'runtime'))
+ legacyInclude.add(join(relative, 'dist/runtime'))
+
+ nodeExclude.add(join(relative, 'runtime'))
+ nodeExclude.add(join(relative, 'dist/runtime'))
+
+ exclude.add(join(relative, 'runtime/server'))
+ exclude.add(join(relative, 'dist/runtime/server'))
+ exclude.add(join(relative, '*.*'))
+ exclude.add(join(relative, 'dist/*.*'))
+ legacyExclude.add(join(relative, 'runtime/server'))
+ legacyExclude.add(join(relative, 'dist/runtime/server'))
+ }
+
+ const nestedModulesDirs: string[] = []
+ for (const dir of nuxt.options.modulesDir.toSorted()) {
+ const withSlash = withTrailingSlash(dir)
+ if (nestedModulesDirs.every(d => !d.startsWith(withSlash))) {
+ nestedModulesDirs.push(withSlash)
+ }
+ }
+
+ let hasTypescriptVersionWithModulePreserve
+ for (const parent of nestedModulesDirs) {
+ hasTypescriptVersionWithModulePreserve ??= await readPackageJSON('typescript', { parent })
+ .then(r => r?.version && gte(r.version, '5.4.0'))
+ .catch(() => undefined)
+ }
+ hasTypescriptVersionWithModulePreserve ??= true
+
+ const useDecorators = Boolean(nuxt.options.experimental?.decorators)
+
+ const userExclude = nuxt.options.typescript?.tsConfig?.exclude ?? []
+
+ // https://www.totaltypescript.com/tsconfig-cheat-sheet
+ const tsConfig: TSConfig = defu(nuxt.options.typescript?.tsConfig, {
+ compilerOptions: {
+ /* Base options: */
+ esModuleInterop: true,
+ skipLibCheck: true,
+ target: 'ESNext',
+ allowJs: true,
+ allowImportingTsExtensions: true,
+ resolveJsonModule: true,
+ moduleDetection: 'force',
+ isolatedModules: true,
+ verbatimModuleSyntax: true,
+ allowArbitraryExtensions: true,
+ /* Strictness */
+ strict: nuxt.options.typescript?.strict ?? true,
+ noUncheckedIndexedAccess: true,
+ forceConsistentCasingInFileNames: true,
+ noImplicitOverride: true,
+ /* Decorator support */
+ ...useDecorators
+ ? {
+ experimentalDecorators: false,
+ }
+ : {},
+ /* If NOT transpiling with TypeScript: */
+ module: hasTypescriptVersionWithModulePreserve ? 'preserve' : 'ESNext',
+ noEmit: true,
+ /* If your code runs in the DOM: */
+ lib: [
+ 'ESNext',
+ ...useDecorators ? ['esnext.decorators'] : [],
+ 'dom',
+ 'dom.iterable',
+ 'webworker',
+ ],
+ /* JSX support for Vue */
+ jsx: 'preserve',
+ jsxImportSource: 'vue',
+ /* remove auto-scanning for types */
+ types: [],
+ /* add paths object for filling-in later */
+ paths: {},
+ /* Possibly consider removing the following in future */
+ moduleResolution: nuxt.options.future?.typescriptBundlerResolution || (nuxt.options.experimental as any)?.typescriptBundlerResolution ? 'Bundler' : 'Node', /* implied by module: preserve */
+ useDefineForClassFields: true, /* implied by target: es2022+ */
+ noImplicitThis: true, /* enabled with `strict` */
+ allowSyntheticDefaultImports: true,
+ },
+ include: [...include],
+ exclude: [...exclude],
+ } satisfies TSConfig)
+
+ // This describes the environment where we load `nuxt.config.ts` (and modules)
+ const nodeTsConfig: TSConfig = defu(nuxt.options.typescript?.nodeTsConfig, {
+ compilerOptions: {
+ /* Base options: */
+ esModuleInterop: tsConfig.compilerOptions?.esModuleInterop,
+ skipLibCheck: tsConfig.compilerOptions?.skipLibCheck,
+ target: tsConfig.compilerOptions?.target,
+ allowJs: tsConfig.compilerOptions?.allowJs,
+ allowImportingTsExtensions: tsConfig.compilerOptions?.allowImportingTsExtensions,
+ resolveJsonModule: tsConfig.compilerOptions?.resolveJsonModule,
+ moduleDetection: tsConfig.compilerOptions?.moduleDetection,
+ isolatedModules: tsConfig.compilerOptions?.isolatedModules,
+ verbatimModuleSyntax: tsConfig.compilerOptions?.verbatimModuleSyntax,
+ allowArbitraryExtensions: tsConfig.compilerOptions?.allowArbitraryExtensions,
+ /* Strictness */
+ strict: tsConfig.compilerOptions?.strict,
+ noUncheckedIndexedAccess: tsConfig.compilerOptions?.noUncheckedIndexedAccess,
+ forceConsistentCasingInFileNames: tsConfig.compilerOptions?.forceConsistentCasingInFileNames,
+ noImplicitOverride: tsConfig.compilerOptions?.noImplicitOverride,
+ /* If NOT transpiling with TypeScript: */
+ module: tsConfig.compilerOptions?.module,
+ noEmit: true,
+ /* remove auto-scanning for types */
+ types: [],
+ /* add paths object for filling-in later */
+ paths: {},
+ /* Possibly consider removing the following in future */
+ moduleResolution: tsConfig.compilerOptions?.moduleResolution,
+ useDefineForClassFields: tsConfig.compilerOptions?.useDefineForClassFields,
+ noImplicitThis: tsConfig.compilerOptions?.noImplicitThis,
+ allowSyntheticDefaultImports: tsConfig.compilerOptions?.allowSyntheticDefaultImports,
+ },
+ include: [...nodeInclude],
+ exclude: [...nodeExclude],
+ } satisfies TSConfig)
+
+ // This describes the environment where we load `nuxt.config.ts` (and modules)
+ const sharedTsConfig: TSConfig = defu(nuxt.options.typescript?.sharedTsConfig, {
+ compilerOptions: {
+ /* Base options: */
+ esModuleInterop: tsConfig.compilerOptions?.esModuleInterop,
+ skipLibCheck: tsConfig.compilerOptions?.skipLibCheck,
+ target: tsConfig.compilerOptions?.target,
+ allowJs: tsConfig.compilerOptions?.allowJs,
+ allowImportingTsExtensions: tsConfig.compilerOptions?.allowImportingTsExtensions,
+ resolveJsonModule: tsConfig.compilerOptions?.resolveJsonModule,
+ moduleDetection: tsConfig.compilerOptions?.moduleDetection,
+ isolatedModules: tsConfig.compilerOptions?.isolatedModules,
+ verbatimModuleSyntax: tsConfig.compilerOptions?.verbatimModuleSyntax,
+ allowArbitraryExtensions: tsConfig.compilerOptions?.allowArbitraryExtensions,
+ /* Strictness */
+ strict: tsConfig.compilerOptions?.strict,
+ noUncheckedIndexedAccess: tsConfig.compilerOptions?.noUncheckedIndexedAccess,
+ forceConsistentCasingInFileNames: tsConfig.compilerOptions?.forceConsistentCasingInFileNames,
+ noImplicitOverride: tsConfig.compilerOptions?.noImplicitOverride,
+ /* If NOT transpiling with TypeScript: */
+ module: tsConfig.compilerOptions?.module,
+ noEmit: true,
+ /* remove auto-scanning for types */
+ types: [],
+ /* add paths object for filling-in later */
+ paths: {},
+ /* Possibly consider removing the following in future */
+ moduleResolution: tsConfig.compilerOptions?.moduleResolution,
+ useDefineForClassFields: tsConfig.compilerOptions?.useDefineForClassFields,
+ noImplicitThis: tsConfig.compilerOptions?.noImplicitThis,
+ allowSyntheticDefaultImports: tsConfig.compilerOptions?.allowSyntheticDefaultImports,
+ },
+ include: [...sharedInclude],
+ exclude: [...sharedExclude],
+ } satisfies TSConfig)
+
+ const aliases: Record<string, string> = nuxt.options.alias
+
+ // TODO: remove support for baseUrl in nuxt v5
+ // eslint-disable-next-line @typescript-eslint/no-deprecated
+ const basePath = tsConfig.compilerOptions!.baseUrl
+ // TODO: remove support for baseUrl in nuxt v5
+ // eslint-disable-next-line @typescript-eslint/no-deprecated
+ ? resolve(nuxt.options.buildDir, tsConfig.compilerOptions!.baseUrl)
+ : nuxt.options.buildDir
+
+ tsConfig.compilerOptions ||= {}
+ tsConfig.compilerOptions.paths ||= {}
+ tsConfig.include ||= []
+ tsConfig.exclude ||= []
+
+ const importPaths = nuxt.options.modulesDir.map(d => directoryToURL(d))
+
+ for (const alias in aliases) {
+ if (excludedAlias.some(re => re.test(alias))) {
+ continue
+ }
+ let absolutePath = resolve(basePath, aliases[alias]!)
+ let stats = await fsp.stat(absolutePath).catch(() => null /* file does not exist */)
+ if (!stats) {
+ const resolvedModule = resolveModulePath(aliases[alias]!, {
+ try: true,
+ from: importPaths,
+ extensions: [...nuxt.options.extensions, '.d.ts', '.d.mts', '.d.cts'],
+ })
+ if (resolvedModule) {
+ absolutePath = resolvedModule
+ stats = await fsp.stat(resolvedModule).catch(() => null)
+ }
+ }
+
+ const relativePath = relativeWithDot(nuxt.options.buildDir, absolutePath)
+ if (stats?.isDirectory() || aliases[alias]!.endsWith('/')) {
+ tsConfig.compilerOptions.paths[alias] = [relativePath]
+ tsConfig.compilerOptions.paths[`${alias}/*`] = [`${relativePath}/*`]
+ } else {
+ const path = stats?.isFile()
+ // remove extension
+ ? relativePath.replace(EXTENSION_RE, '')
+ // non-existent file probably shouldn't be resolved
+ : aliases[alias]!
+
+ tsConfig.compilerOptions.paths[alias] = [path]
+ }
+ }
+
+ const references: TSReference[] = []
+ const nodeReferences: TSReference[] = []
+ const sharedReferences: TSReference[] = []
+
+ // This adds types of all modules
+ await Promise.all([...nuxt.options.modules, ...nuxt.options._modules].map(async (id) => {
+ if (typeof id !== 'string') { return }
+
+ for (const parent of nestedModulesDirs) {
+ const pkg = await readPackageJSON(id, { parent }).catch(() => null)
+ if (pkg) {
+ nodeReferences.push(({ types: pkg.name ?? id }))
+ references.push(({ types: pkg.name ?? id }))
+ return
+ }
+ }
+
+ nodeReferences.push(({ types: id }))
+ references.push(({ types: id }))
+ }))
+
+ const declarations: string[] = []
+
+ await nuxt.callHook('prepare:types', { references, declarations, tsConfig, nodeTsConfig, nodeReferences, sharedTsConfig, sharedReferences })
+
+ // Legacy tsConfig for backward compatibility
+ const legacyTsConfig: TSConfig = defu({}, {
+ ...tsConfig,
+ include: [...tsConfig.include, ...legacyInclude],
+ exclude: [...userExclude, ...legacyExclude],
+ })
+
+ async function resolveConfig (tsConfig: TSConfig) {
+ for (const alias in tsConfig.compilerOptions!.paths) {
+ const paths = tsConfig.compilerOptions!.paths[alias]
+ tsConfig.compilerOptions!.paths[alias] = [...new Set(await Promise.all(paths.map(async (path: string) => {
+ if (!isAbsolute(path)) { return path }
+ const stats = await fsp.stat(path).catch(() => null /* file does not exist */)
+ return relativeWithDot(nuxt.options.buildDir, stats?.isFile() ? path.replace(EXTENSION_RE, '') /* remove extension */ : path)
+ })))]
+ }
+
+ // Ensure `#build` is placed at the end of the paths object.
+ // https://github.com/nuxt/nuxt/issues/30325
+ sortTsPaths(tsConfig.compilerOptions!.paths)
+
+ tsConfig.include = [...new Set(tsConfig.include!.map(p => isAbsolute(p) ? relativeWithDot(nuxt.options.buildDir, p) : p))]
+ tsConfig.exclude = [...new Set(tsConfig.exclude!.map(p => isAbsolute(p) ? relativeWithDot(nuxt.options.buildDir, p) : p))]
+ }
+
+ await Promise.all([
+ resolveConfig(tsConfig),
+ resolveConfig(nodeTsConfig),
+ resolveConfig(sharedTsConfig),
+ resolveConfig(legacyTsConfig),
+ ])
+
+ const declaration = [
+ ...references.map(ref => renderReference(ref, nuxt.options.buildDir)),
+ ...declarations,
+ '',
+ 'export {}',
+ '',
+ ].join('\n')
+
+ const nodeDeclaration = [
+ ...nodeReferences.map(ref => renderReference(ref, nuxt.options.buildDir)),
+ '',
+ 'export {}',
+ '',
+ ].join('\n')
+
+ const sharedDeclaration = [
+ ...sharedReferences.map(ref => renderReference(ref, nuxt.options.buildDir)),
+ '',
+ 'export {}',
+ '',
+ ].join('\n')
+
+ return {
+ declaration,
+ sharedTsConfig,
+ sharedDeclaration,
+ nodeTsConfig,
+ nodeDeclaration,
+ tsConfig,
+ legacyTsConfig,
+ }
+}
+
+export async function writeTypes (nuxt: Nuxt): Promise<void> {
+ const { tsConfig, nodeTsConfig, nodeDeclaration, declaration, legacyTsConfig, sharedDeclaration, sharedTsConfig } = await _generateTypes(nuxt)
+
+ const appTsConfigPath = resolve(nuxt.options.buildDir, 'tsconfig.app.json')
+ const legacyTsConfigPath = resolve(nuxt.options.buildDir, 'tsconfig.json')
+ const nodeTsConfigPath = resolve(nuxt.options.buildDir, 'tsconfig.node.json')
+ const sharedTsConfigPath = resolve(nuxt.options.buildDir, 'tsconfig.shared.json')
+
+ const declarationPath = resolve(nuxt.options.buildDir, 'nuxt.d.ts')
+ const nodeDeclarationPath = resolve(nuxt.options.buildDir, 'nuxt.node.d.ts')
+ const sharedDeclarationPath = resolve(nuxt.options.buildDir, 'nuxt.shared.d.ts')
+
+ await fsp.mkdir(nuxt.options.buildDir, { recursive: true })
+ await Promise.all([
+ fsp.writeFile(appTsConfigPath, JSON.stringify(tsConfig, null, 2)),
+ fsp.writeFile(legacyTsConfigPath, JSON.stringify(legacyTsConfig, null, 2)),
+ fsp.writeFile(nodeTsConfigPath, JSON.stringify(nodeTsConfig, null, 2)),
+ fsp.writeFile(sharedTsConfigPath, JSON.stringify(sharedTsConfig, null, 2)),
+ fsp.writeFile(declarationPath, declaration),
+ fsp.writeFile(nodeDeclarationPath, nodeDeclaration),
+ fsp.writeFile(sharedDeclarationPath, sharedDeclaration),
+ ])
+}
+
+function sortTsPaths (paths: Record<string, string[]>) {
+ for (const pathKey in paths) {
+ if (pathKey.startsWith('#build')) {
+ const pathValue = paths[pathKey]!
+ // Delete & Reassign to ensure key is inserted at the end of object.
+ delete paths[pathKey]
+ paths[pathKey] = pathValue
+ }
+ }
+}
+
+function renderReference (ref: TSReference, baseDir: string) {
+ const stuff = 'path' in ref
+ ? `path="${isAbsolute(ref.path) ? relative(baseDir, ref.path) : ref.path}"`
+ : `types="${ref.types}"`
+ return `/// <reference ${stuff} />`
+}
+
+const RELATIVE_WITH_DOT_RE = /^([^.])/
+function relativeWithDot (from: string, to: string) {
+ return relative(from, to).replace(RELATIVE_WITH_DOT_RE, './$1') || '.'
+}
+
+function withTrailingSlash (dir: string) {
+ return dir.replace(/[^/]$/, '$&/')
+}
diff --git a/packages/kit/src/utils.ts b/packages/kit/src/utils.ts
new file mode 100644
index 000000000000..160f9cf57634
--- /dev/null
+++ b/packages/kit/src/utils.ts
@@ -0,0 +1,25 @@
+/** @since 3.9.0 */
+export function toArray<T> (value: T | T[]): T[] {
+ return Array.isArray(value) ? value : [value]
+}
+
+/**
+ * Filter out items from an array in place. This function mutates the array.
+ * `predicate` get through the array from the end to the start for performance.
+ *
+ * This function should be faster than `Array.prototype.filter` on large arrays.
+ */
+export function filterInPlace<T> (array: T[], predicate: (item: T, index: number, arr: T[]) => unknown) {
+ for (let i = array.length; i--; i >= 0) {
+ if (!predicate(array[i]!, i, array)) {
+ array.splice(i, 1)
+ }
+ }
+ return array
+}
+
+export const MODE_RE = /\.(server|client)(\.\w+)*$/
+
+export const distDirURL = new URL('.', import.meta.url)
+
+export type RequirePicked<T extends Record<string, any>, K extends keyof T> = Omit<T, K> & Required<Pick<T, K>>
diff --git a/packages/kit/test/async-nuxt-storage.spec.ts b/packages/kit/test/async-nuxt-storage.spec.ts
new file mode 100644
index 000000000000..66164ace7264
--- /dev/null
+++ b/packages/kit/test/async-nuxt-storage.spec.ts
@@ -0,0 +1,152 @@
+import { describe, expect, it, vi } from 'vitest'
+
+import type { Nuxt } from '@nuxt/schema'
+import { runWithNuxtContext, tryUseNuxt } from '@nuxt/kit'
+
+describe('asyncNuxtStorage', () => {
+ it('should return nuxt instance', () => {
+ const nuxt = { __name: '1' } as Nuxt
+ expect(tryUseNuxt()?.__name).toBeUndefined()
+ expect(runWithNuxtContext(nuxt, () => tryUseNuxt()?.__name)).toBe('1')
+ })
+
+ it('should isolate async ctx', async () => {
+ const nuxt1 = { __name: '1' } as Nuxt
+ const nuxt2 = { __name: '2' } as Nuxt
+ const nuxt3 = { __name: '3' } as Nuxt
+
+ let resolve!: () => void
+ const promise = new Promise<void>(resolve_ => resolve = resolve_)
+
+ expect(tryUseNuxt()?.__name).toBeUndefined()
+
+ await expect(Promise.all([
+ runWithNuxtContext(nuxt1, async () => {
+ await promise
+ return tryUseNuxt()?.__name
+ }),
+ runWithNuxtContext(nuxt2, async () => {
+ await new Promise(resolve => setTimeout(resolve, 1))
+ resolve()
+ return tryUseNuxt()?.__name
+ }),
+ runWithNuxtContext(nuxt3, async () => {
+ await promise
+ return tryUseNuxt()?.__name
+ }),
+ ])).resolves.toEqual(['1', '2', '3'])
+
+ expect(tryUseNuxt()?.__name).toBeUndefined()
+ })
+
+ it('should share ctx with same kit', async () => {
+ const sameKit = await import('@nuxt/kit')
+
+ expect(sameKit.tryUseNuxt).toBe(tryUseNuxt)
+
+ const nuxt = { __name: '1' } as Nuxt
+
+ expect(tryUseNuxt()?.__name).toBeUndefined()
+ expect(sameKit.tryUseNuxt()?.__name).toBeUndefined()
+
+ expect(runWithNuxtContext(nuxt, () => tryUseNuxt()?.__name)).toBe('1')
+ expect(runWithNuxtContext(nuxt, () => sameKit.tryUseNuxt()?.__name)).toBe('1')
+
+ expect(tryUseNuxt()?.__name).toBeUndefined()
+ expect(sameKit.tryUseNuxt()?.__name).toBeUndefined()
+ })
+
+ it('should share ctx with another kit', async () => {
+ vi.resetModules()
+ const anotherKit = await import('@nuxt/kit')
+
+ expect(anotherKit.tryUseNuxt).not.toBe(tryUseNuxt)
+
+ const nuxt = { __name: '1' } as Nuxt
+
+ expect(tryUseNuxt()?.__name).toBeUndefined()
+ expect(anotherKit.tryUseNuxt()?.__name).toBeUndefined()
+
+ expect(runWithNuxtContext(nuxt, () => tryUseNuxt()?.__name)).toBe('1')
+ expect(runWithNuxtContext(nuxt, () => anotherKit.tryUseNuxt()?.__name)).toBe('1')
+
+ expect(tryUseNuxt()?.__name).toBeUndefined()
+ expect(anotherKit.tryUseNuxt()?.__name).toBeUndefined()
+ })
+
+ it('should isolate ctx with another kit', async () => {
+ vi.resetModules()
+ const anotherKit = await import('@nuxt/kit')
+
+ expect(anotherKit.tryUseNuxt).not.toBe(tryUseNuxt)
+
+ const nuxt1 = { __name: '1' } as Nuxt
+ const nuxt2 = { __name: '2' } as Nuxt
+
+ expect(anotherKit.tryUseNuxt()?.__name).toBeUndefined()
+
+ expect(runWithNuxtContext(nuxt1, () => anotherKit.tryUseNuxt()?.__name)).toBe('1')
+ expect(runWithNuxtContext(nuxt2, () => anotherKit.tryUseNuxt()?.__name)).toBe('2')
+
+ expect(anotherKit.tryUseNuxt()?.__name).toBeUndefined()
+ })
+
+ it('should isolate async ctx with another kit', async () => {
+ vi.resetModules()
+ const anotherKit = await import('@nuxt/kit')
+
+ expect(anotherKit.tryUseNuxt).not.toBe(tryUseNuxt)
+
+ const nuxt1 = { __name: '1' } as Nuxt
+ const nuxt2 = { __name: '2' } as Nuxt
+ const nuxt3 = { __name: '3' } as Nuxt
+
+ let resolve!: () => void
+ const promise = new Promise<void>(resolve_ => resolve = resolve_)
+
+ expect(tryUseNuxt()?.__name).toBeUndefined()
+ expect(anotherKit.tryUseNuxt()?.__name).toBeUndefined()
+
+ await expect(Promise.all([
+ runWithNuxtContext(nuxt1, async () => {
+ await promise
+ return anotherKit.tryUseNuxt()?.__name
+ }),
+ runWithNuxtContext(nuxt2, async () => {
+ await new Promise(resolve => setTimeout(resolve, 1))
+ resolve()
+ return anotherKit.tryUseNuxt()?.__name
+ }),
+ anotherKit.runWithNuxtContext(nuxt3, async () => {
+ await promise
+ return tryUseNuxt()?.__name
+ }),
+ ])).resolves.toEqual(['1', '2', '3'])
+
+ expect(tryUseNuxt()?.__name).toBeUndefined()
+ expect(anotherKit.tryUseNuxt()?.__name).toBeUndefined()
+ })
+
+ it('should conflict error nested ctx with same kit', () => {
+ const nuxt1 = { __name: '1' } as Nuxt
+ const nuxt2 = { __name: '2' } as Nuxt
+
+ expect(() => runWithNuxtContext(nuxt1, () =>
+ runWithNuxtContext(nuxt2, () => tryUseNuxt()?.__name),
+ )).toThrow(/conflict/)
+ })
+
+ it('should conflict error nested ctx with another kit', async () => {
+ vi.resetModules()
+ const anotherKit = await import('@nuxt/kit')
+
+ expect(anotherKit.tryUseNuxt).not.toBe(tryUseNuxt)
+
+ const nuxt1 = { __name: '1' } as Nuxt
+ const nuxt2 = { __name: '2' } as Nuxt
+
+ expect(() => runWithNuxtContext(nuxt1, () =>
+ anotherKit.runWithNuxtContext(nuxt2, () => tryUseNuxt()?.__name),
+ )).toThrow(/conflict/)
+ })
+})
diff --git a/packages/kit/test/components-fixture/Named.ts b/packages/kit/test/components-fixture/Named.ts
new file mode 100644
index 000000000000..baeed7a7d512
--- /dev/null
+++ b/packages/kit/test/components-fixture/Named.ts
@@ -0,0 +1,13 @@
+import { defineComponent } from 'vue'
+
+export const NamedExport = defineComponent({
+ setup () {
+ return () => 'hello'
+ },
+})
+
+export default defineComponent({
+ setup () {
+ return () => 'default'
+ },
+})
diff --git a/packages/kit/test/components.spec.ts b/packages/kit/test/components.spec.ts
new file mode 100644
index 000000000000..ae44c4f81a63
--- /dev/null
+++ b/packages/kit/test/components.spec.ts
@@ -0,0 +1,122 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
+import { createHooks } from 'hookable'
+import type { Component } from '@nuxt/schema'
+import { relative } from 'pathe'
+
+import { addComponent, addComponentExports } from '../src/components.ts'
+import { createResolver } from '../src/resolve.ts'
+import * as context from '../src/context.ts'
+
+const mockNuxt = {
+ options: {
+ components: [],
+ modulesDir: [],
+ extensions: ['.vue', '.js', '.ts'],
+ },
+ hook: undefined as unknown,
+}
+
+describe('addComponentExports', () => {
+ let mockHooks: ReturnType<typeof createHooks>
+
+ beforeEach(() => {
+ mockHooks = createHooks()
+ mockNuxt.hook = mockHooks.hook.bind(mockHooks)
+ vi.spyOn(context, 'tryUseNuxt').mockReturnValue(mockNuxt as any)
+ vi.spyOn(context, 'useNuxt').mockReturnValue(mockNuxt as any)
+ })
+
+ afterEach(() => {
+ vi.restoreAllMocks()
+ })
+
+ it('should add components exports', async () => {
+ const resolver = createResolver(import.meta.url)
+ addComponentExports({
+ filePath: resolver.resolve('./components-fixture/Named'),
+ prefix: 'test',
+ })
+ await mockHooks.callHook('components:dirs', [])
+ const components: Component[] = []
+ await mockHooks.callHook('components:extend', components)
+ for (const c of components) {
+ c.filePath = relative(resolver.resolve('./components-fixture'), c.filePath)
+ c.shortPath = relative(resolver.resolve('./components-fixture'), c.shortPath)
+ }
+ expect(components).toMatchInlineSnapshot(`
+ [
+ {
+ "chunkName": "components/test-named-export",
+ "export": "NamedExport",
+ "filePath": "Named",
+ "global": false,
+ "kebabName": "test-named-export",
+ "meta": {},
+ "mode": "all",
+ "name": "TestNamedExport",
+ "pascalName": "TestNamedExport",
+ "prefetch": false,
+ "prefix": "test",
+ "preload": false,
+ "priority": 0,
+ "shortPath": "Named",
+ },
+ {
+ "chunkName": "components/test",
+ "export": "default",
+ "filePath": "Named",
+ "global": false,
+ "kebabName": "test",
+ "meta": {},
+ "mode": "all",
+ "name": "Test",
+ "pascalName": "Test",
+ "prefetch": false,
+ "prefix": "test",
+ "preload": false,
+ "priority": 0,
+ "shortPath": "Named",
+ },
+ ]
+ `)
+ })
+ it('should add components other than an existing component', async () => {
+ const resolver = createResolver(import.meta.url)
+ addComponent({
+ filePath: resolver.resolve('./components-fixture/Named'),
+ name: 'TestNamedExport',
+ export: 'NamedExport',
+ priority: 1,
+ })
+ addComponentExports({
+ filePath: resolver.resolve('./components-fixture/Named'),
+ prefix: 'test',
+ })
+ await mockHooks.callHook('components:dirs', [])
+ const components: Component[] = []
+ await mockHooks.callHook('components:extend', components)
+ for (const c of components) {
+ c.filePath = relative(resolver.resolve('./components-fixture'), c.filePath)
+ c.shortPath = relative(resolver.resolve('./components-fixture'), c.shortPath)
+ }
+ expect(components.length).eq(2)
+ expect(components[1]).toMatchInlineSnapshot(`
+ {
+ "chunkName": "components/test",
+ "export": "default",
+ "filePath": "Named",
+ "global": false,
+ "kebabName": "test",
+ "meta": {},
+ "mode": "all",
+ "name": "Test",
+ "pascalName": "Test",
+ "prefetch": false,
+ "prefix": "test",
+ "preload": false,
+ "priority": 0,
+ "shortPath": "Named",
+ }
+ `)
+ })
+})
diff --git a/packages/kit/test/generate-types.spec.ts b/packages/kit/test/generate-types.spec.ts
new file mode 100644
index 000000000000..5a9421bf6d2d
--- /dev/null
+++ b/packages/kit/test/generate-types.spec.ts
@@ -0,0 +1,186 @@
+import { describe, expect, it } from 'vitest'
+import type { Nuxt, NuxtConfig } from '@nuxt/schema'
+import { defu } from 'defu'
+import { findWorkspaceDir } from 'pkg-types'
+
+import { loadNuxtConfig } from '../src/loader/config.ts'
+import { _generateTypes, resolveLayerPaths } from '../src/template.ts'
+import { getLayerDirectories } from 'nuxt/kit'
+
+type DeepPartial<T> = {
+ [P in keyof T]?: T[P] extends Record<string, any> ? DeepPartial<T[P]> : T[P]
+}
+
+const mockNuxt = {
+ options: {
+ rootDir: '/my-app',
+ srcDir: '/my-app',
+ alias: {
+ '~': '/my-app',
+ 'some-custom-alias': '/my-app/some-alias',
+ },
+ typescript: { includeWorkspace: false },
+ buildDir: '/my-app/.nuxt',
+ modulesDir: ['/my-app/node_modules', '/node_modules'],
+ modules: [],
+ extensions: ['.ts', '.mjs', '.js'],
+ _layers: [{ config: { rootDir: '/my-app', srcDir: '/my-app' } }],
+ _installedModules: [],
+ _modules: [],
+ },
+ callHook: () => {},
+} satisfies DeepPartial<Nuxt> as unknown as Nuxt
+
+const mockNuxtWithOptions = (options: NuxtConfig) => defu({ options }, mockNuxt) as Nuxt
+
+describe('tsConfig generation', () => {
+ it('should add correct relative paths for aliases', async () => {
+ const { tsConfig } = await _generateTypes(mockNuxt)
+ expect(tsConfig.compilerOptions?.paths).toMatchInlineSnapshot(`
+ {
+ "some-custom-alias": [
+ "../some-alias",
+ ],
+ "~": [
+ "..",
+ ],
+ }
+ `)
+ })
+
+ it('should add exclude for module paths', async () => {
+ const { tsConfig } = await _generateTypes(mockNuxtWithOptions({
+ modulesDir: ['/my-app/modules/test/node_modules', '/my-app/modules/node_modules', '/my-app/node_modules/@some/module/node_modules'],
+ }))
+ expect(tsConfig.exclude).toMatchInlineSnapshot(`
+ [
+ "../../node_modules",
+ "../dist",
+ "../.data",
+ "../modules/*/runtime/server/**/*",
+ "../layers/*/server/**/*",
+ "../layers/*/modules/*/runtime/server/**/*",
+ "../modules/*.*",
+ "../nuxt.config.*",
+ "../.config/nuxt.*",
+ "../layers/*/nuxt.config.*",
+ "../layers/*/.config/nuxt.*",
+ "../layers/*/modules/**/*",
+ ]
+ `)
+ })
+
+ it('should not exclude node-context paths from legacy tsconfig', async () => {
+ const { legacyTsConfig } = await _generateTypes(mockNuxt)
+ // nuxt.config.* and .config/nuxt.* are intentionally in legacyInclude (node context)
+ // and must NOT be excluded by the legacy tsconfig
+ expect(legacyTsConfig.include).toEqual(expect.arrayContaining(['../nuxt.config.*', '../.config/nuxt.*']))
+ expect(legacyTsConfig.exclude).not.toEqual(expect.arrayContaining(['../nuxt.config.*', '../.config/nuxt.*']))
+ })
+
+ it('should propagate user-defined excludes to legacy tsconfig', async () => {
+ const { legacyTsConfig } = await _generateTypes(mockNuxtWithOptions({
+ typescript: { tsConfig: { exclude: ['my-custom-exclude'] } },
+ }))
+ expect(legacyTsConfig.exclude).toContain('my-custom-exclude')
+ // but computed app-only paths must still be absent
+ expect(legacyTsConfig.exclude).not.toContain('../nuxt.config.*')
+ })
+
+ it('should add #build after #components to paths', async () => {
+ const { tsConfig } = await _generateTypes(mockNuxtWithOptions({
+ alias: {
+ '~': '/my-app',
+ '@': '/my-app',
+ 'some-custom-alias': '/my-app/some-alias',
+ '#build': './build-dir',
+ '#build/*': './build-dir/*',
+ '#imports': './imports',
+ '#components': './components',
+ },
+ }))
+
+ expect(tsConfig.compilerOptions?.paths).toMatchObject({
+ '~': [
+ '..',
+ ],
+ 'some-custom-alias': [
+ '../some-alias',
+ ],
+ '@': [
+ '..',
+ ],
+ '#imports': [
+ './imports',
+ ],
+ '#components': [
+ './components',
+ ],
+ '#build': [
+ './build-dir',
+ ],
+ '#build/*': [
+ './build-dir/*',
+ ],
+ })
+ })
+})
+
+describe('resolveLayerPaths', async () => {
+ const repoRoot = await findWorkspaceDir()
+
+ it('should respect custom nuxt options', async () => {
+ const nuxtOptions = await loadNuxtConfig({
+ cwd: repoRoot,
+ overrides: {
+ _prepare: true,
+ srcDir: 'app',
+ dir: {
+ modules: 'custom-modules',
+ shared: 'custom-shared',
+ },
+ },
+ })
+ const [layer] = getLayerDirectories({ options: nuxtOptions } as Nuxt)
+ const paths = resolveLayerPaths(layer!, nuxtOptions.buildDir)
+ expect(paths).toMatchInlineSnapshot(`
+ {
+ "globalDeclarations": [
+ "../*.d.ts",
+ "../layers/*/*.d.ts",
+ ],
+ "nitro": [
+ "../custom-modules/*/runtime/server/**/*",
+ "../layers/*/server/**/*",
+ "../layers/*/modules/*/runtime/server/**/*",
+ ],
+ "node": [
+ "../custom-modules/*.*",
+ "../nuxt.config.*",
+ "../.config/nuxt.*",
+ "../layers/*/nuxt.config.*",
+ "../layers/*/.config/nuxt.*",
+ "../layers/*/modules/**/*",
+ ],
+ "nuxt": [
+ "../app/**/*",
+ "../custom-modules/*/runtime/**/*",
+ "../test/nuxt/**/*",
+ "../tests/nuxt/**/*",
+ "../layers/*/app/**/*",
+ "../layers/*/modules/*/runtime/**/*",
+ ],
+ "shared": [
+ "../custom-shared/**/*",
+ "../custom-modules/*/shared/**/*",
+ "../layers/*/shared/**/*",
+ ],
+ "sharedDeclarations": [
+ "../custom-shared/**/*.d.ts",
+ "../custom-modules/*/shared/**/*.d.ts",
+ "../layers/*/shared/**/*.d.ts",
+ ],
+ }
+ `)
+ })
+})
diff --git a/examples/custom-server/nuxt.config.js b/packages/kit/test/layer-fixture/custom-layers/a/nuxt.config.ts
similarity index 100%
rename from examples/custom-server/nuxt.config.js
rename to packages/kit/test/layer-fixture/custom-layers/a/nuxt.config.ts
diff --git a/test/fixtures/fetch/nuxt.config.js b/packages/kit/test/layer-fixture/custom-layers/b/nuxt.config.ts
similarity index 100%
rename from test/fixtures/fetch/nuxt.config.js
rename to packages/kit/test/layer-fixture/custom-layers/b/nuxt.config.ts
diff --git a/packages/kit/test/layer-fixture/layers/c/assets/foo.js b/packages/kit/test/layer-fixture/layers/c/assets/foo.js
new file mode 100644
index 000000000000..21ec276fc7f8
--- /dev/null
+++ b/packages/kit/test/layer-fixture/layers/c/assets/foo.js
@@ -0,0 +1 @@
+export const foo = 'bar'
diff --git a/packages/kit/test/layer-fixture/layers/c/nuxt.config.ts b/packages/kit/test/layer-fixture/layers/c/nuxt.config.ts
new file mode 100644
index 000000000000..268da7f8c110
--- /dev/null
+++ b/packages/kit/test/layer-fixture/layers/c/nuxt.config.ts
@@ -0,0 +1 @@
+export default defineNuxtConfig({})
diff --git a/packages/kit/test/layer-fixture/layers/d/nuxt.config.ts b/packages/kit/test/layer-fixture/layers/d/nuxt.config.ts
new file mode 100644
index 000000000000..268da7f8c110
--- /dev/null
+++ b/packages/kit/test/layer-fixture/layers/d/nuxt.config.ts
@@ -0,0 +1 @@
+export default defineNuxtConfig({})
diff --git a/packages/kit/test/layer-fixture/nuxt.config.ts b/packages/kit/test/layer-fixture/nuxt.config.ts
new file mode 100644
index 000000000000..93f1ff9ac2d3
--- /dev/null
+++ b/packages/kit/test/layer-fixture/nuxt.config.ts
@@ -0,0 +1,6 @@
+export default defineNuxtConfig({
+ extends: ['./custom-layers/b', './custom-layers/a'],
+ $meta: {
+ name: 'layer-fixture',
+ },
+})
diff --git a/packages/kit/test/load-nuxt-config.bench.ts b/packages/kit/test/load-nuxt-config.bench.ts
new file mode 100644
index 000000000000..ade8e9fd79ea
--- /dev/null
+++ b/packages/kit/test/load-nuxt-config.bench.ts
@@ -0,0 +1,22 @@
+import { bench, describe } from 'vitest'
+import { join } from 'pathe'
+import { loadNuxtConfig } from '@nuxt/kit'
+import { findWorkspaceDir } from 'pkg-types'
+
+const fixtures = {
+ 'empty directory': 'node_modules/fixture',
+ 'basic test fixture': 'test/fixtures/basic',
+ 'basic test fixture (types)': 'test/fixtures/basic-types',
+ 'minimal test fixture': 'test/fixtures/minimal',
+ 'minimal test fixture (types)': 'test/fixtures/minimal-types',
+}
+
+describe('loadNuxtConfig', async () => {
+ const repoRoot = await findWorkspaceDir()
+ for (const fixture in fixtures) {
+ const path = join(repoRoot, fixtures[fixture as keyof typeof fixtures])
+ bench(`loadNuxtConfig in the ${fixture}`, async () => {
+ await loadNuxtConfig({ cwd: path })
+ })
+ }
+})
diff --git a/packages/kit/test/load-nuxt-config.spec.ts b/packages/kit/test/load-nuxt-config.spec.ts
new file mode 100644
index 000000000000..184a2c70ada5
--- /dev/null
+++ b/packages/kit/test/load-nuxt-config.spec.ts
@@ -0,0 +1,92 @@
+import process from 'node:process'
+import { mkdtemp, rm, writeFile } from 'node:fs/promises'
+import { tmpdir } from 'node:os'
+import { fileURLToPath } from 'node:url'
+import { afterAll, beforeAll, describe, expect, it, vi } from 'vitest'
+import { loadNuxtConfig } from '@nuxt/kit'
+import { basename, join } from 'pathe'
+
+describe('loadNuxtConfig', () => {
+ it('should add named aliases for local layers', async () => {
+ const cwd = fileURLToPath(new URL('./layer-fixture', import.meta.url)).replace(/\\/g, '/')
+ const config = await loadNuxtConfig({ cwd })
+ for (const alias in config.alias) {
+ config.alias[alias] = config.alias[alias]!.replace(cwd, '<rootDir>')
+ }
+ expect(config.alias).toMatchInlineSnapshot(`
+ {
+ "#build": "<rootDir>/.nuxt/",
+ "#internal/nuxt/paths": "<rootDir>/.nuxt/paths.mjs",
+ "#layers/c": "<rootDir>/layers/c/",
+ "#layers/d": "<rootDir>/layers/d/",
+ "#layers/layer-fixture": "<rootDir>/",
+ "#server": "<rootDir>/server/",
+ "#shared": "<rootDir>/shared/",
+ "@": "<rootDir>/",
+ "@@": "<rootDir>/",
+ "~": "<rootDir>/",
+ "~~": "<rootDir>/",
+ }
+ `)
+ })
+
+ it('should respect alphabetical order of local layers', async () => {
+ const cwd = fileURLToPath(new URL('./layer-fixture', import.meta.url)).replace(/\\/g, '/')
+ const config = await loadNuxtConfig({ cwd })
+ // priority list
+ // 1. layers in nuxt.config (first overrides second)
+ // 2. then local layers in alphabetical order (Z overrides A)
+ // 3. local project overrides
+ expect(config._layers.map(l => basename(l.cwd))).toMatchInlineSnapshot(`
+ [
+ "layer-fixture",
+ "d",
+ "c",
+ "b",
+ "a",
+ ]
+ `)
+ })
+
+ describe('with .env file', () => {
+ let tempDir: string
+
+ beforeAll(async () => {
+ tempDir = await mkdtemp(join(tmpdir(), 'nuxt-loadConfig-'))
+ await writeFile(join(tempDir, '.env'), 'NUXT_PORT=3005\nNUXT_HOST=0.0.0.0\n')
+ })
+
+ afterAll(async () => {
+ delete process.env.NUXT_PORT
+ delete process.env.NUXT_HOST
+ vi.restoreAllMocks()
+ await rm(tempDir, { recursive: true, force: true })
+ })
+
+ it('should apply NUXT_PORT and NUXT_HOST from .env to devServer defaults', async () => {
+ vi.resetModules()
+ // delay c12 so the schema import wins the race (#34955 repro)
+ vi.doMock('c12', async () => {
+ const actual = await vi.importActual<typeof import('c12')>('c12')
+ return {
+ ...actual,
+ loadConfig: async (opts: Parameters<typeof actual.loadConfig>[0]) => {
+ await new Promise(resolve => setTimeout(resolve, 50))
+ return actual.loadConfig(opts)
+ },
+ }
+ })
+
+ const { loadNuxtConfig } = await import('@nuxt/kit')
+ const config = await loadNuxtConfig({ cwd: tempDir })
+ expect(config.devServer.port).toBe(3005)
+ expect(config.devServer.host).toBe('0.0.0.0')
+ })
+ })
+
+ it('should preserve and resolve a custom env name', async () => {
+ const cwd = fileURLToPath(new URL('./layer-fixture', import.meta.url)).replace(/\\/g, '/')
+ const config = await loadNuxtConfig({ cwd, envName: 'staging' })
+ expect(config.envName).toBe('staging')
+ })
+})
diff --git a/packages/kit/test/load-nuxt.test.ts b/packages/kit/test/load-nuxt.test.ts
new file mode 100644
index 000000000000..c3a09d6ef831
--- /dev/null
+++ b/packages/kit/test/load-nuxt.test.ts
@@ -0,0 +1,32 @@
+import { mkdir, rm, writeFile } from 'node:fs/promises'
+import { afterAll, beforeAll, describe, expect, it } from 'vitest'
+import { join } from 'pathe'
+import { x } from 'tinyexec'
+
+import { loadNuxt } from '../src/loader/nuxt.ts'
+import { findWorkspaceDir } from 'pkg-types'
+
+const repoRoot = await findWorkspaceDir()
+
+describe('loadNuxt', () => {
+ const tempDir = join(repoRoot, 'temp')
+
+ beforeAll(async () => {
+ await mkdir(join(tempDir, 'nuxt'), { recursive: true })
+ await writeFile(join(tempDir, 'package.json'), '{"dependencies":{"nuxt":"file:./nuxt"}}')
+ await writeFile(join(tempDir, 'nuxt', 'package.json'), '{"name":"nuxt","type":"module","exports":{".":"./index.js"}}')
+ await writeFile(join(tempDir, 'nuxt', 'index.js'), 'export const loadNuxt = (opts) => ({ name: "it me" })')
+ await x('npm', ['install'], { nodeOptions: { cwd: tempDir } })
+ })
+
+ afterAll(async () => {
+ await rm(tempDir, { recursive: true, force: true })
+ })
+
+ it('respects correct directory', async () => {
+ const nuxt = await loadNuxt({ cwd: tempDir })
+ expect(nuxt).toStrictEqual({
+ name: 'it me',
+ })
+ })
+})
diff --git a/packages/kit/test/module.test.ts b/packages/kit/test/module.test.ts
new file mode 100644
index 000000000000..d8e3a3c2a7c6
--- /dev/null
+++ b/packages/kit/test/module.test.ts
@@ -0,0 +1,474 @@
+import { mkdir, readFile, rm, writeFile } from 'node:fs/promises'
+import { appendFileSync } from 'node:fs'
+
+import type { Nuxt } from 'nuxt/schema'
+
+import { afterAll, afterEach, beforeAll, beforeEach, describe, expect, it, vi } from 'vitest'
+import { join } from 'pathe'
+import { findWorkspaceDir } from 'pkg-types'
+import { read as readRc, write as writeRc } from 'rc9'
+
+import { defineNuxtModule, installModule, loadNuxt } from '../src/index.ts'
+
+const repoRoot = await findWorkspaceDir()
+
+describe('installNuxtModule', { sequential: true }, () => {
+ let nuxt: Nuxt
+
+ const tempDir = join(repoRoot, 'node_modules/.temp/module-temp-hooks')
+ const hooksLogFile = join(tempDir, 'hooks-logs')
+
+ async function getHooksLogs () {
+ const logs = await readFile(hooksLogFile, { encoding: 'utf8' }).catch(_ => '')
+ return logs.split('\n').slice(0, -1)
+ }
+
+ const testModule = defineNuxtModule({
+ meta: {
+ name: 'test-module',
+ version: '1.0.0',
+ },
+
+ onInstall () {
+ appendFileSync(hooksLogFile, 'install\n')
+ },
+
+ onUpgrade () {
+ appendFileSync(hooksLogFile, 'upgrade\n')
+ },
+ })
+
+ beforeAll(async () => {
+ await mkdir(join(tempDir, 'nuxt'), { recursive: true })
+ await rm(hooksLogFile, { force: true })
+ })
+
+ afterAll(async () => {
+ await rm(tempDir, { recursive: true, force: true })
+ })
+
+ afterEach(async () => {
+ await nuxt?.close()
+ await rm(hooksLogFile, { force: true })
+ })
+
+ it('runs onInstall hook when a module is added', async () => {
+ nuxt = await loadNuxt({ cwd: tempDir })
+ // eslint-disable-next-line @typescript-eslint/no-deprecated
+ await installModule(testModule, {}, nuxt)
+
+ expect(await getHooksLogs()).toEqual(['install'])
+ const rc = readRc({ dir: tempDir, name: '.nuxtrc' })
+ expect(rc.setups['test-module']).toBe('1.0.0')
+ })
+
+ it('runs onInstall only once', async () => {
+ writeRc(
+ { setups: { 'test-module': '1.0.0' } },
+ { dir: tempDir, name: '.nuxtrc' },
+ )
+
+ nuxt = await loadNuxt({ cwd: tempDir })
+ // eslint-disable-next-line @typescript-eslint/no-deprecated
+ await installModule(testModule, {}, nuxt)
+
+ expect(await getHooksLogs()).toEqual([])
+ })
+
+ it('runs onUpgrade hook when a module is upgraded', async () => {
+ writeRc(
+ { setups: { 'test-module': '0.1.0' } },
+ { dir: tempDir, name: '.nuxtrc' },
+ )
+
+ nuxt = await loadNuxt({ cwd: tempDir })
+ // eslint-disable-next-line @typescript-eslint/no-deprecated
+ await installModule(testModule, {}, nuxt)
+
+ expect(await getHooksLogs()).toEqual(['upgrade'])
+ const rc = readRc({ dir: tempDir, name: '.nuxtrc' })
+ expect(rc.setups['test-module']).toBe('1.0.0')
+ })
+})
+
+describe('module dependencies', { sequential: true }, () => {
+ let nuxt: Nuxt
+
+ const tempDir = join(repoRoot, 'node_modules/.temp/module-dependencies')
+
+ beforeAll(async () => {
+ const fakeModule = join(tempDir, 'node_modules/some-module')
+ await mkdir(fakeModule, { recursive: true })
+ await writeFile(join(fakeModule, 'package.json'), JSON.stringify({ name: 'some-module', version: '1.0.0', type: 'module', exports: './index.js' }))
+ await writeFile(join(fakeModule, 'index.js'), `
+export default Object.assign((options) => {
+ globalThis.someModuleLoaded ||= 0
+ globalThis.someModuleLoaded++
+ globalThis.someModuleOptions = options
+}, {
+ getMeta: () => ({
+ configKey: 'someModule'
+ })
+})
+ `)
+ })
+
+ beforeEach(() => {
+ delete globalThis.someModuleLoaded
+ delete globalThis.someModuleOptions
+ })
+
+ afterEach(async () => {
+ await nuxt?.close()
+ })
+
+ it('should install modules that are not marked as optional', async () => {
+ nuxt = await loadNuxt({
+ cwd: tempDir,
+ overrides: {
+ modules: [
+ defineNuxtModule({
+ meta: { name: 'foo' },
+ moduleDependencies: {
+ 'some-module': {},
+ 'non-existent-module': { optional: true },
+ },
+ }),
+ ],
+ },
+ })
+
+ expect(globalThis.someModuleLoaded).toBe(1)
+ })
+
+ it('should resolve moduleDependencies provided as async functions', async () => {
+ nuxt = await loadNuxt({
+ cwd: tempDir,
+ overrides: {
+ modules: [
+ defineNuxtModule({
+ meta: { name: 'foo' },
+ async moduleDependencies () {
+ await Promise.resolve()
+ return {
+ 'some-module': {},
+ }
+ },
+ }),
+ ],
+ },
+ })
+
+ expect(globalThis.someModuleLoaded).toBe(1)
+ })
+
+ it('should not install modules that are already installed by the user', async () => {
+ nuxt = await loadNuxt({
+ cwd: tempDir,
+ overrides: {
+ modules: [
+ defineNuxtModule({
+ meta: { name: 'some-module' },
+ }),
+ defineNuxtModule({
+ meta: { name: 'foo' },
+ moduleDependencies: {
+ 'some-module': {},
+ },
+ }),
+ ],
+ },
+ })
+
+ expect(globalThis.someModuleLoaded).toBeUndefined()
+ })
+
+ it('should resolve moduleDependencies by meta.name when it differs from package name', async () => {
+ const depSetupFn = vi.fn()
+
+ nuxt = await loadNuxt({
+ cwd: tempDir,
+ overrides: {
+ modules: [
+ // Module with meta.name that differs from any package path
+ defineNuxtModule({
+ meta: { name: 'my-custom-name' },
+ setup: depSetupFn,
+ }),
+ // Module that depends on the above by meta.name
+ defineNuxtModule({
+ meta: { name: 'consumer' },
+ moduleDependencies: {
+ 'my-custom-name': {},
+ },
+ }),
+ ],
+ },
+ })
+
+ // The dependency module should have been found (not re-installed) via meta.name lookup
+ expect(depSetupFn).toHaveBeenCalledTimes(1)
+ })
+
+ it('should resolve moduleDependencies by meta.name and apply overrides/defaults', async () => {
+ nuxt = await loadNuxt({
+ cwd: tempDir,
+ overrides: {
+ // @ts-expect-error untyped nuxt option
+ localMod: {
+ user: 'provided by user',
+ },
+ modules: [
+ defineNuxtModule({
+ meta: { name: 'local-module', configKey: 'localMod' },
+ defaults: {
+ value: 'default',
+ user: 'default',
+ fromDefault: 'default',
+ },
+ setup (options) {
+ expect(options).toMatchObject({
+ value: 'from override',
+ user: 'provided by user',
+ fromDefault: 'from consumer default',
+ })
+ },
+ }),
+ defineNuxtModule({
+ meta: { name: 'consumer' },
+ moduleDependencies: {
+ 'local-module': {
+ overrides: {
+ value: 'from override',
+ },
+ defaults: {
+ fromDefault: 'from consumer default',
+ user: 'from consumer default',
+ },
+ },
+ },
+ }),
+ ],
+ },
+ })
+
+ // @ts-expect-error untyped nuxt option
+ expect(nuxt.options.localMod).toMatchObject({
+ value: 'from override',
+ user: 'provided by user',
+ fromDefault: 'from consumer default',
+ })
+ })
+
+ it('should not load a module from disk if it is present inline', async () => {
+ nuxt = await loadNuxt({
+ cwd: tempDir,
+ overrides: {
+ modules: [
+ defineNuxtModule({
+ meta: { name: 'foo' },
+ moduleDependencies: {
+ 'some-module': {},
+ },
+ }),
+ 'some-module',
+ ],
+ },
+ })
+
+ expect(globalThis.someModuleLoaded).toBe(1)
+ })
+
+ it('should merge options as expected', async () => {
+ nuxt = await loadNuxt({
+ cwd: tempDir,
+ overrides: {
+ // @ts-expect-error untyped nuxt options
+ a: {
+ user: 'provided by user',
+ },
+ modules: [
+ defineNuxtModule({
+ meta: { name: 'a' },
+ defaults: {
+ value: 'provided by a',
+ user: 'provided by a',
+ default: 'provided by a',
+ },
+ setup (options) {
+ expect(options).toMatchInlineSnapshot(`
+ {
+ "default": "provided by c",
+ "user": "provided by user",
+ "value": "provided by c",
+ }
+ `)
+ },
+ }),
+ defineNuxtModule({
+ meta: { name: 'b' },
+ setup (options) {
+ expect(options).toMatchInlineSnapshot(`
+ {
+ "default": "provided by c",
+ "value": "provided by c",
+ }
+ `)
+ },
+ }),
+ defineNuxtModule({
+ meta: { name: 'c' },
+ setup (options) {
+ expect(options).toMatchInlineSnapshot(`{}`)
+ },
+ moduleDependencies: {
+ 'a': {
+ overrides: {
+ value: 'provided by c',
+ },
+ defaults: {
+ user: 'provided by c',
+ default: 'provided by c',
+ },
+ },
+ 'b': {
+ overrides: {
+ value: 'provided by c',
+ },
+ defaults: {
+ default: 'provided by c',
+ },
+ },
+ },
+ }),
+ defineNuxtModule({
+ meta: { name: 'd' },
+ setup (options) {
+ expect(options).toMatchInlineSnapshot(`{}`)
+ },
+ moduleDependencies: {
+ 'b': {
+ overrides: {
+ value: 'provided by d',
+ },
+ defaults: {
+ default: 'provided by d',
+ },
+ },
+ },
+ }),
+ ],
+ },
+ })
+
+ // @ts-expect-error untyped nuxt option
+ expect(nuxt.options.a).toMatchInlineSnapshot(`
+ {
+ "default": "provided by c",
+ "user": "provided by user",
+ "value": "provided by c",
+ }
+ `)
+ // @ts-expect-error untyped nuxt option
+ expect(nuxt.options.b).toMatchInlineSnapshot(`
+ {
+ "default": "provided by c",
+ "value": "provided by c",
+ }
+ `)
+ // @ts-expect-error untyped nuxt option
+ expect(nuxt.options.c).toMatchInlineSnapshot(`undefined`)
+ // @ts-expect-error untyped nuxt option
+ expect(nuxt.options.d).toMatchInlineSnapshot(`undefined`)
+ })
+
+ it('should warn if version constraints do not match', async () => {
+ await expect(loadNuxt({
+ cwd: tempDir,
+ overrides: {
+ modules: [
+ defineNuxtModule({
+ meta: { name: 'foo' },
+ moduleDependencies: {
+ 'some-module': {
+ version: '>=2',
+ },
+ },
+ }),
+ ],
+ },
+ })).rejects.toThrowErrorMatchingInlineSnapshot(`[TypeError: Module \`some-module\` version (\`1.0.0\`) does not satisfy \`>=2\` (requested by a module in \`nuxt.options\`).]`)
+ })
+
+ it('should apply moduleDependencies config when installModule is called explicitly', async () => {
+ const setupOrder: string[] = []
+
+ nuxt = await loadNuxt({
+ cwd: tempDir,
+ overrides: {
+ // @ts-expect-error no types for someModule
+ someModule: {
+ value: 'from user',
+ moduleOverride: 'from user',
+ userDefault: 'from user',
+ },
+ modules: [
+ // Module A defines config for module C via moduleDependencies
+ defineNuxtModule({
+ meta: { name: 'module-a' },
+ moduleDependencies: {
+ 'someModule': {
+ optional: true,
+ overrides: {
+ value: 'from module-a override',
+ moduleOverride: 'from module-a',
+ },
+ defaults: {
+ defaultValue: 'from module-a default',
+ userDefault: 'from module-a default',
+ },
+ },
+ },
+ setup () {
+ setupOrder.push('module-a')
+ },
+ }),
+ // Module B calls installModule on module C
+ defineNuxtModule({
+ meta: { name: 'module-b' },
+ async setup (_, nuxt) {
+ setupOrder.push('module-b')
+
+ // eslint-disable-next-line @typescript-eslint/no-deprecated
+ await installModule('some-module', {
+ value: 'from module-b',
+ inlineValue: 'from module-b inline',
+ }, nuxt)
+ },
+ }),
+ ],
+ },
+ })
+
+ expect(setupOrder).toEqual(['module-a', 'module-b'])
+ expect(globalThis.someModuleLoaded).toBe(1)
+
+ expect(globalThis.someModuleOptions).toMatchObject({
+ // `installModule` should always override values
+ value: 'from module-b',
+ // extra values should be passed alone
+ inlineValue: 'from module-b inline',
+ // modules should be able to set default values
+ defaultValue: 'from module-a default',
+ // modules should be able to override user configuration
+ moduleOverride: 'from module-a',
+ // user configuration should be merged in
+ userDefault: 'from user',
+ })
+ })
+})
+
+declare global {
+ var someModuleLoaded: number | undefined
+ var someModuleOptions: Record<string, any> | undefined
+}
diff --git a/packages/kit/test/templates.spec.ts b/packages/kit/test/templates.spec.ts
new file mode 100644
index 000000000000..2691dde35519
--- /dev/null
+++ b/packages/kit/test/templates.spec.ts
@@ -0,0 +1,42 @@
+import { describe, expect, it } from 'vitest'
+import { addTypeTemplate, buildNuxt, loadNuxt } from '../src/index.ts'
+import { findWorkspaceDir } from 'pkg-types'
+import { resolve } from 'node:path'
+import { randomUUID } from 'node:crypto'
+import { mkdir, writeFile } from 'node:fs/promises'
+
+describe('addTypeTemplate', () => {
+ it('should add type templates to vue global files', { timeout: 20_000 }, async () => {
+ const repoRoot = await findWorkspaceDir()
+ const rootDir = resolve(repoRoot, 'node_modules/.fixture', randomUUID())
+ await mkdir(rootDir, { recursive: true })
+ await writeFile(resolve(rootDir, 'app.vue'), `
+ <script setup lang="ts">
+ defineProps<TestComponentProps>()
+ </script>
+ <template><div /></template>
+ `)
+ const nuxt = await loadNuxt({
+ cwd: rootDir,
+ overrides: {
+ modules: [
+ function () {
+ addTypeTemplate({
+ filename: 'some-type-template.d.ts',
+ getContents: () => `
+ declare global {
+ type TestComponentProps = { foo?: string }
+ }
+ export {};
+ `,
+ })
+ },
+ ],
+ },
+ })
+
+ await expect(buildNuxt(nuxt)).resolves.not.toThrow()
+
+ await nuxt.close()
+ })
+})
diff --git a/packages/kit/test/write-types.bench.ts b/packages/kit/test/write-types.bench.ts
new file mode 100644
index 000000000000..3e8dca8ca659
--- /dev/null
+++ b/packages/kit/test/write-types.bench.ts
@@ -0,0 +1,26 @@
+import { rm } from 'node:fs/promises'
+import { afterAll, beforeAll, bench, describe } from 'vitest'
+import { join, resolve } from 'pathe'
+import type { Nuxt } from 'nuxt/schema'
+import { loadNuxt, writeTypes } from '@nuxt/kit'
+import { findWorkspaceDir } from 'pkg-types'
+
+describe('writeTypes', async () => {
+ const repoRoot = await findWorkspaceDir()
+ const path = join(repoRoot, 'test/fixtures/basic-types')
+
+ let nuxt: Nuxt
+
+ beforeAll(async () => {
+ nuxt = await loadNuxt({ cwd: path })
+ await rm(resolve(path, '.nuxt'), { recursive: true, force: true })
+ }, 20_000)
+
+ afterAll(async () => {
+ await nuxt.close()
+ }, 20_000)
+
+ bench('writeTypes in the basic-types fixture', async () => {
+ await writeTypes(nuxt)
+ })
+})
diff --git a/packages/nitro-server/.attw.json b/packages/nitro-server/.attw.json
new file mode 100644
index 000000000000..ac2579855eb0
--- /dev/null
+++ b/packages/nitro-server/.attw.json
@@ -0,0 +1,3 @@
+{
+ "ignoreRules": ["cjs-resolves-to-esm"]
+}
diff --git a/packages/nitro-server/.gitignore b/packages/nitro-server/.gitignore
new file mode 100644
index 000000000000..253f4464bd93
--- /dev/null
+++ b/packages/nitro-server/.gitignore
@@ -0,0 +1,2 @@
+src/runtime/templates/error-500.ts
+src/runtime/templates/error-dev.ts
diff --git a/packages/nitro-server/build.config.ts b/packages/nitro-server/build.config.ts
new file mode 100644
index 000000000000..88e3f2c41514
--- /dev/null
+++ b/packages/nitro-server/build.config.ts
@@ -0,0 +1,21 @@
+import { defineBuildConfig } from 'obuild/config'
+
+export default defineBuildConfig({
+ entries: [
+ {
+ type: 'bundle',
+ input: 'src/index',
+ dts: { oxc: true },
+ rolldown: {
+ external: [
+ '@nuxt/schema',
+ ],
+ },
+ },
+ {
+ type: 'transform',
+ input: 'src/runtime/',
+ outDir: 'dist/runtime',
+ },
+ ],
+})
diff --git a/packages/nitro-server/package.json b/packages/nitro-server/package.json
new file mode 100644
index 000000000000..d2897c6fced2
--- /dev/null
+++ b/packages/nitro-server/package.json
@@ -0,0 +1,91 @@
+{
+ "name": "@nuxt/nitro-server",
+ "version": "4.3.1",
+ "repository": {
+ "type": "git",
+ "url": "git+https://github.com/nuxt/nuxt.git",
+ "directory": "packages/nitro-server"
+ },
+ "description": "Nitro server integration for Nuxt",
+ "homepage": "https://nuxt.com",
+ "license": "MIT",
+ "type": "module",
+ "types": "./dist/index.d.mts",
+ "typesVersions": {
+ "*": {
+ "h3": [
+ "./dist/runtime/h3-compat.d.mts"
+ ]
+ }
+ },
+ "exports": {
+ ".": "./dist/index.mjs",
+ "./h3": "./dist/runtime/h3-compat.mjs"
+ },
+ "files": [
+ "dist"
+ ],
+ "scripts": {
+ "prepack": "obuild",
+ "build:stub": "obuild --stub",
+ "test:attw": "attw --pack"
+ },
+ "dependencies": {
+ "@nuxt/kit": "workspace:*",
+ "@unhead/vue": "^3.1.0",
+ "@vue/shared": "3.5.34",
+ "consola": "^3.4.2",
+ "defu": "^6.1.7",
+ "destr": "^2.0.5",
+ "devalue": "^5.8.1",
+ "errx": "^0.1.0",
+ "escape-string-regexp": "^5.0.0",
+ "exsolve": "^1.0.8",
+ "impound": "^1.1.5",
+ "klona": "^2.0.6",
+ "lru-cache": "^11.4.0",
+ "mlly": "^1.8.2",
+ "mocked-exports": "^0.1.1",
+ "nitro": "^3.0.260311-beta",
+ "ohash": "^2.0.11",
+ "pathe": "^2.0.3",
+ "srvx": "^0.11.15",
+ "std-env": "^4.1.0",
+ "ufo": "^1.6.4",
+ "unctx": "^2.5.0",
+ "unstorage": "^2.0.0-alpha.7",
+ "vue": "^3.5.34",
+ "vue-bundle-renderer": "^2.2.0",
+ "vue-devtools-stub": "^0.1.0"
+ },
+ "peerDependencies": {
+ "@babel/plugin-proposal-decorators": "^7.25.0",
+ "@babel/plugin-syntax-typescript": "^7.25.0",
+ "@rollup/plugin-babel": "^6.0.0 || ^7.0.0",
+ "nuxt": "workspace:^"
+ },
+ "peerDependenciesMeta": {
+ "@babel/plugin-proposal-decorators": {
+ "optional": true
+ },
+ "@babel/plugin-syntax-typescript": {
+ "optional": true
+ },
+ "@rollup/plugin-babel": {
+ "optional": true
+ }
+ },
+ "devDependencies": {
+ "@babel/plugin-proposal-decorators": "7.29.0",
+ "@babel/plugin-syntax-typescript": "7.28.6",
+ "@nuxt/schema": "workspace:*",
+ "@rollup/plugin-babel": "7.0.0",
+ "hookable": "6.1.1",
+ "nuxt": "workspace:*",
+ "obuild": "0.4.36",
+ "vitest": "4.1.7"
+ },
+ "engines": {
+ "node": "^22.12.0 || ^24.11.0 || >=26.0.0"
+ }
+}
diff --git a/packages/nitro-server/src/augments.ts b/packages/nitro-server/src/augments.ts
new file mode 100644
index 000000000000..981c260e6817
--- /dev/null
+++ b/packages/nitro-server/src/augments.ts
@@ -0,0 +1,254 @@
+import type { Nitro, NitroConfig, NitroDevEventHandler, NitroEventHandler, NitroOptions, NitroRouteConfig, NitroRuntimeConfig, NitroRuntimeConfigApp } from 'nitro/types'
+import type { EventHandler, H3Event } from 'nitro/h3'
+import type { LogObject } from 'consola'
+import type { NuxtIslandContext, NuxtIslandResponse, NuxtRenderHTMLContext } from 'nuxt/app'
+import type { HookResult, RuntimeConfig, TSReference } from 'nuxt/schema'
+
+declare module 'nitro/types' {
+ interface NitroRuntimeConfigApp {
+ baseURL: string
+ buildAssetsDir: string
+ cdnURL: string
+ }
+ interface NitroRouteRules {
+ ssr?: boolean
+ noScripts?: boolean
+ /** @deprecated Use `noScripts` instead */
+ experimentalNoScripts?: boolean
+ appMiddleware?: Record<string, boolean>
+ appLayout?: string | false
+ }
+}
+
+// Note: Keep in sync with packages/nuxt/src/core/templates.ts
+declare module 'nitro/types' {
+ // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ interface NitroRuntimeConfig extends RuntimeConfig {}
+ interface NitroRouteConfig {
+ ssr?: boolean
+ noScripts?: boolean
+ /** @deprecated Use `noScripts` instead */
+ experimentalNoScripts?: boolean
+ }
+ interface NitroRuntimeHooks {
+ 'dev:ssr-logs': (ctx: { logs: LogObject[], path: string }) => void | Promise<void>
+ 'render:html': (htmlContext: NuxtRenderHTMLContext, context: { event: H3Event }) => void | Promise<void>
+ 'render:island': (islandResponse: NuxtIslandResponse, context: { event: H3Event, islandContext: NuxtIslandContext }) => void | Promise<void>
+ }
+}
+
+declare module '@nuxt/schema' {
+ interface NuxtHooks {
+ /**
+ * Called when the dev middleware is being registered on the Nitro dev server.
+ * @param handler the Vite or Webpack event handler
+ * @returns Promise
+ */
+ 'server:devHandler': (handler: EventHandler, options: { cors: (path: string) => boolean }) => HookResult
+
+ /**
+ * Called before Nitro writes `.nuxt/tsconfig.server.json`, allowing addition of custom references and declarations.
+ * @param options Objects containing `references`, `declarations`
+ * @param options.references Array of TypeScript references to add
+ * @param options.declarations Array of declaration strings to add
+ * @returns Promise
+ */
+ 'nitro:prepare:types': (options: { references: TSReference[], declarations: string[] }) => HookResult
+ /**
+ * Called before initializing Nitro, allowing customization of Nitro's configuration.
+ * @param nitroConfig The nitro config to be extended
+ * @returns Promise
+ */
+ 'nitro:config': (nitroConfig: NitroConfig) => HookResult
+ /**
+ * Called after Nitro is initialized, which allows registering Nitro hooks and interacting directly with Nitro.
+ * @param nitro The created nitro object
+ * @returns Promise
+ */
+ 'nitro:init': (nitro: Nitro) => HookResult
+ /**
+ * Called before building the Nitro instance.
+ * @param nitro The created nitro object
+ * @returns Promise
+ */
+ 'nitro:build:before': (nitro: Nitro) => HookResult
+ /**
+ * Called after copying public assets. Allows modifying public assets before Nitro server is built.
+ * @param nitro The created nitro object
+ * @returns Promise
+ */
+ 'nitro:build:public-assets': (nitro: Nitro) => HookResult
+ }
+
+ interface ConfigSchema {
+ /**
+ * Configuration for Nitro.
+ *
+ * @see [Nitro configuration docs](https://nitro.build/config)
+ */
+ nitro: NitroConfig
+
+ /**
+ * Global route options applied to matching server routes.
+ *
+ * @experimental This is an experimental feature and API may change in the future.
+ *
+ * @see [Nitro route rules documentation](https://nitro.build/config#routerules)
+ */
+ routeRules: NitroConfig['routeRules']
+
+ /**
+ * Nitro server handlers.
+ *
+ * Each handler accepts the following options:
+ * - handler: The path to the file defining the handler. - route: The route under which the handler is available. This follows the conventions of [rou3](https://github.com/h3js/rou3). - method: The HTTP method of requests that should be handled. - middleware: Specifies whether it is a middleware handler. - lazy: Specifies whether to use lazy loading to import the handler.
+ *
+ * @see [`server/` directory documentation](https://nuxt.com/docs/4.x/directory-structure/server)
+ *
+ * @note Files from `server/api`, `server/middleware` and `server/routes` will be automatically registered by Nuxt.
+ *
+ * @example
+ * ```js
+ * serverHandlers: [
+ * { route: '/path/foo/**:name', handler: '#server/foohandler.ts' }
+ * ]
+ * ```
+ */
+ serverHandlers: NitroEventHandler[]
+
+ /**
+ * Nitro development-only server handlers.
+ *
+ * @see [Nitro server routes documentation](https://nitro.build/guide/routing)
+ */
+ devServerHandlers: NitroDevEventHandler[]
+ }
+
+ interface NuxtConfig {
+ nitro?: NitroConfig
+ }
+
+ interface RuntimeConfig {
+ app: NitroRuntimeConfigApp
+ /** Only available on the server. */
+ nitro?: NitroRuntimeConfig['nitro']
+ }
+
+ interface NuxtDebugOptions {
+ /** Debug options for Nitro */
+ nitro?: NitroOptions['debug']
+ }
+
+ interface NuxtPage {
+ rules?: NitroRouteConfig
+ }
+}
+
+declare module 'nuxt/schema' {
+ interface NuxtHooks {
+ /**
+ * Called when the dev middleware is being registered on the Nitro dev server.
+ * @param handler the Vite or Webpack event handler
+ * @returns Promise
+ */
+ 'server:devHandler': (handler: EventHandler, options: { cors: (path: string) => boolean }) => HookResult
+
+ /**
+ * Called before Nitro writes `.nuxt/tsconfig.server.json`, allowing addition of custom references and declarations.
+ * @param options Objects containing `references`, `declarations`
+ * @param options.references Array of TypeScript references to add
+ * @param options.declarations Array of declaration strings to add
+ * @returns Promise
+ */
+ 'nitro:prepare:types': (options: { references: TSReference[], declarations: string[] }) => HookResult
+ /**
+ * Called before initializing Nitro, allowing customization of Nitro's configuration.
+ * @param nitroConfig The nitro config to be extended
+ * @returns Promise
+ */
+ 'nitro:config': (nitroConfig: NitroConfig) => HookResult
+ /**
+ * Called after Nitro is initialized, which allows registering Nitro hooks and interacting directly with Nitro.
+ * @param nitro The created nitro object
+ * @returns Promise
+ */
+ 'nitro:init': (nitro: Nitro) => HookResult
+ /**
+ * Called before building the Nitro instance.
+ * @param nitro The created nitro object
+ * @returns Promise
+ */
+ 'nitro:build:before': (nitro: Nitro) => HookResult
+ /**
+ * Called after copying public assets. Allows modifying public assets before Nitro server is built.
+ * @param nitro The created nitro object
+ * @returns Promise
+ */
+ 'nitro:build:public-assets': (nitro: Nitro) => HookResult
+ }
+
+ interface ConfigSchema {
+ /**
+ * Configuration for Nitro.
+ *
+ * @see [Nitro configuration docs](https://nitro.build/config)
+ */
+ nitro: NitroConfig
+
+ /**
+ * Global route options applied to matching server routes.
+ *
+ * @experimental This is an experimental feature and API may change in the future.
+ *
+ * @see [Nitro route rules documentation](https://nitro.build/config#routerules)
+ */
+ routeRules: NitroConfig['routeRules']
+
+ /**
+ * Nitro server handlers.
+ *
+ * Each handler accepts the following options:
+ * - handler: The path to the file defining the handler. - route: The route under which the handler is available. This follows the conventions of [rou3](https://github.com/h3js/rou3). - method: The HTTP method of requests that should be handled. - middleware: Specifies whether it is a middleware handler. - lazy: Specifies whether to use lazy loading to import the handler.
+ *
+ * @see [`server/` directory documentation](https://nuxt.com/docs/4.x/directory-structure/server)
+ *
+ * @note Files from `server/api`, `server/middleware` and `server/routes` will be automatically registered by Nuxt.
+ *
+ * @example
+ * ```js
+ * serverHandlers: [
+ * { route: '/path/foo/**:name', handler: '~/server/foohandler.ts' }
+ * ]
+ * ```
+ */
+ serverHandlers: NitroEventHandler[]
+
+ /**
+ * Nitro development-only server handlers.
+ *
+ * @see [Nitro server routes documentation](https://nitro.build/guide/routing)
+ */
+ devServerHandlers: NitroDevEventHandler[]
+ }
+
+ interface NuxtConfig {
+ nitro?: NitroConfig
+ }
+
+ interface RuntimeConfig {
+ app: NitroRuntimeConfigApp
+ /** Only available on the server. */
+ nitro?: NitroRuntimeConfig['nitro']
+ }
+
+ interface NuxtDebugOptions {
+ /** Debug options for Nitro */
+ nitro?: NitroOptions['debug']
+ }
+
+ interface NuxtPage {
+ rules?: NitroRouteConfig
+ }
+}
+
+export {}
diff --git a/packages/nitro-server/src/imports.ts b/packages/nitro-server/src/imports.ts
new file mode 100644
index 000000000000..3f092fe12570
--- /dev/null
+++ b/packages/nitro-server/src/imports.ts
@@ -0,0 +1,59 @@
+import { resolveModuleExportNames } from 'mlly'
+
+// TODO: defineRenderHandler and useEvent
+export const v2ImportsPreset = [
+ {
+ from: 'nitro/app',
+ imports: ['useNitroApp', 'getRouteRules'],
+ },
+ {
+ from: 'nitro/runtime-config',
+ imports: ['useRuntimeConfig'],
+ },
+ {
+ from: 'nitro',
+ imports: [
+ 'defineRouteMeta',
+ {
+ name: 'defineErrorHandler',
+ as: 'defineNitroErrorHandler',
+ },
+ {
+ name: 'definePlugin',
+ as: 'defineNitroPlugin',
+ },
+ {
+ name: 'definePlugin',
+ as: 'nitroPlugin',
+ },
+ ],
+ },
+ {
+ from: 'nitro/cache',
+ imports: [
+ 'defineCachedFunction',
+ { name: 'defineCachedFunction', as: 'cachedFunction' },
+ 'defineCachedHandler',
+ { name: 'defineCachedHandler', as: 'defineCachedEventHandler' },
+ { name: 'defineCachedHandler', as: 'cachedEventHandler' },
+ ],
+ },
+ {
+ from: 'nitro/storage',
+ imports: ['useStorage'],
+ },
+ {
+ from: 'nitro/task',
+ imports: ['defineTask', 'runTask'],
+ },
+]
+
+export async function getH3ImportsPreset () {
+ const h3Exports = await resolveModuleExportNames('nitro/h3', {
+ url: import.meta.url,
+ })
+ return {
+ from: 'nitro/h3',
+ imports: h3Exports.filter(n => !/^[A-Z]/.test(n) && n !== 'use'),
+ }
+}
diff --git a/packages/nitro-server/src/index.ts b/packages/nitro-server/src/index.ts
new file mode 100644
index 000000000000..2ad75048e101
--- /dev/null
+++ b/packages/nitro-server/src/index.ts
@@ -0,0 +1,1068 @@
+import { performance } from 'node:perf_hooks'
+import { pathToFileURL } from 'node:url'
+import { existsSync, promises as fsp, readFileSync } from 'node:fs'
+import { cpus } from 'node:os'
+import process from 'node:process'
+import { mkdir, readFile, writeFile } from 'node:fs/promises'
+import { randomUUID } from 'node:crypto'
+import type { Nuxt, NuxtOptions } from '@nuxt/schema'
+import { join, relative, resolve } from 'pathe'
+import { joinURL, withTrailingSlash } from 'ufo'
+import nuxtPkg from 'nuxt/package.json' with { type: 'json' }
+import { build, copyPublicAssets, createDevServer, createNitro, prepare, prerender, writeTypes } from 'nitro/builder'
+import type { Nitro, NitroConfig, NitroRouteRules } from 'nitro/types'
+import { addPlugin, addTemplate, addVitePlugin, createIsIgnored, ensureDependencyInstalled, findPath, getDirectory, getLayerDirectories, logger, resolveAlias, resolveIgnorePatterns, resolveNuxtModule } from '@nuxt/kit'
+import escapeRE from 'escape-string-regexp'
+import { defu } from 'defu'
+import { defineEventHandler, dynamicEventHandler, handleCors } from 'nitro/h3'
+import { isWindows } from 'std-env'
+import { ImpoundPlugin } from 'impound'
+import { resolveModulePath } from 'exsolve'
+import { runtimeDependencies } from 'nitro/meta'
+import './augments.ts'
+
+import nitroBuilder from '../package.json' with { type: 'json' }
+import { distDir, getSsrResolveConditions, toArray } from './utils.ts'
+import { template as defaultSpaLoadingTemplate } from '../../ui-templates/dist/templates/spa-loading-icon.ts'
+// TODO: figure out a good way to share this
+import { createImportProtectionPatterns } from '../../nuxt/src/core/plugins/import-protection.ts'
+import { nitroSchemaTemplate } from './templates.ts'
+import { getH3ImportsPreset, v2ImportsPreset } from './imports.ts'
+
+const logLevelMapReverse = {
+ silent: 0,
+ info: 3,
+ verbose: 3,
+} satisfies Record<NuxtOptions['logLevel'], NitroConfig['logLevel']>
+
+const NODE_MODULES_RE = /(?<=\/)node_modules\/(.+)$/
+const PNPM_NODE_MODULES_RE = /\.pnpm\/.+\/node_modules\/(.+)$/
+export async function bundle (nuxt: Nuxt & { _nitro?: Nitro }): Promise<void> {
+ // Resolve config
+ const layerDirs = getLayerDirectories(nuxt)
+ const excludePaths: string[] = []
+ for (const dirs of layerDirs) {
+ const paths = [
+ dirs.root.match(NODE_MODULES_RE)?.[1]?.replace(/\/$/, ''),
+ dirs.root.match(PNPM_NODE_MODULES_RE)?.[1]?.replace(/\/$/, ''),
+ ]
+ for (const dir of paths) {
+ if (dir) {
+ excludePaths.push(escapeRE(dir))
+ }
+ }
+ }
+
+ const layerPublicAssetsDirs: Array<{ dir: string, maxAge: number }> = []
+ for (const dirs of layerDirs) {
+ if (existsSync(dirs.public)) {
+ layerPublicAssetsDirs.push({ dir: dirs.public, maxAge: 0 })
+ }
+ }
+
+ const excludePattern = excludePaths.length
+ ? [new RegExp(`node_modules\\/(?!${excludePaths.join('|')})`)]
+ : [/node_modules/]
+
+ const rootDirWithSlash = withTrailingSlash(nuxt.options.rootDir)
+
+ const moduleEntryPaths: string[] = []
+ for (const m of nuxt.options._installedModules) {
+ const path = m.meta?.rawPath || m.entryPath
+ if (path) {
+ moduleEntryPaths.push(getDirectory(path))
+ }
+ }
+
+ const modules = await resolveNuxtModule(rootDirWithSlash, moduleEntryPaths)
+
+ addTemplate(nitroSchemaTemplate)
+
+ const sharedDirs = new Set<string>()
+ if (nuxt.options.nitro.imports !== false && nuxt.options.imports.scan !== false) {
+ for (const layer of nuxt.options._layers) {
+ // Layer disabled scanning for itself
+ if (layer.config?.imports?.scan === false) {
+ continue
+ }
+
+ sharedDirs.add(resolve(layer.config.rootDir, layer.config.dir?.shared ?? 'shared', 'utils'))
+ sharedDirs.add(resolve(layer.config.rootDir, layer.config.dir?.shared ?? 'shared', 'types'))
+ }
+ }
+
+ // Resolve aliases in user-provided input - so `~~/server/test` will work
+ nuxt.options.nitro.plugins ||= []
+ nuxt.options.nitro.plugins = nuxt.options.nitro.plugins.map(plugin => plugin ? resolveAlias(plugin, nuxt.options.alias) : plugin)
+
+ if (nuxt.options.dev && nuxt.options.features.devLogs) {
+ addPlugin(resolve(nuxt.options.appDir, 'plugins/dev-server-logs'))
+ nuxt.options.nitro.plugins.push(resolve(distDir, 'runtime/plugins/dev-server-logs'))
+ nuxt.options.nitro.virtual = defu(nuxt.options.nitro.virtual, {
+ '#internal/dev-server-logs-options': () => `export const rootDir = ${JSON.stringify(nuxt.options.rootDir)};`,
+ })
+ }
+
+ if (nuxt.options.experimental.runtimeBaseURL) {
+ nuxt.options.serverHandlers.unshift({
+ route: '',
+ middleware: true,
+ handler: resolve(distDir, 'runtime/middleware/base-url'),
+ })
+ }
+
+ if (nuxt.options.experimental.componentIslands) {
+ const islandHandlerPath = JSON.stringify(resolve(distDir, 'runtime/handlers/island'))
+ const h3Path = JSON.stringify(resolve(distDir, 'runtime/h3-compat'))
+ const ISLAND_RENDERER_KEY = '#internal/nuxt/island-renderer.mjs'
+
+ nuxt.options.nitro.virtual ||= {}
+ nuxt.options.nitro.virtual[ISLAND_RENDERER_KEY] = () => {
+ // sync conditions with /packages/nuxt/src/core/templates.ts#L539
+ if (nuxt.options.dev || nuxt.options.experimental.componentIslands !== 'auto' || nuxt.apps.default?.pages?.some(p => p.mode === 'server') || nuxt.apps.default?.components?.some(c => c.mode === 'server' && !nuxt.apps.default?.components.some(other => other.pascalName === c.pascalName && other.mode === 'client'))) {
+ return `export { default } from ${islandHandlerPath}`
+ }
+ return `import { defineEventHandler } from ${h3Path}; export default defineEventHandler(() => {});`
+ }
+ nuxt.options.serverHandlers.push({
+ route: '/__nuxt_island/**',
+ handler: ISLAND_RENDERER_KEY,
+ })
+
+ if (!nuxt.options.ssr && nuxt.options.experimental.componentIslands !== 'auto') {
+ nuxt.options.ssr = true
+ nuxt.options.nitro.routeRules ||= {}
+ nuxt.options.nitro.routeRules['/**'] = defu(nuxt.options.nitro.routeRules['/**'], { ssr: false })
+ }
+ }
+
+ const mockProxy = resolveModulePath('mocked-exports/proxy', { from: import.meta.url })
+
+ const nitroConfig: NitroConfig = defu(nuxt.options.nitro, {
+ debug: nuxt.options.debug ? nuxt.options.debug.nitro : false,
+ rootDir: nuxt.options.rootDir,
+ workspaceDir: nuxt.options.workspaceDir,
+ serverDir: nuxt.options.serverDir,
+ dev: nuxt.options.dev,
+ buildDir: nuxt.options.buildDir,
+ experimental: {
+ asyncContext: nuxt.options.experimental.asyncContext,
+ typescriptBundlerResolution: nuxt.options.future.typescriptBundlerResolution || nuxt.options.typescript?.tsConfig?.compilerOptions?.moduleResolution?.toLowerCase() === 'bundler' || nuxt.options.nitro.typescript?.tsConfig?.compilerOptions?.moduleResolution?.toLowerCase() === 'bundler',
+ },
+ framework: {
+ name: 'nuxt',
+ version: nuxtPkg.version || nitroBuilder.version,
+ },
+ imports: nuxt.options.experimental.nitroAutoImports === false
+ ? false
+ : {
+ autoImport: nuxt.options.imports.autoImport as boolean,
+ dirs: [...sharedDirs],
+ presets: nuxt.options.experimental.nitroAutoImports
+ ? [
+ ...v2ImportsPreset,
+ await getH3ImportsPreset(),
+ ]
+ : [],
+ imports: [
+ {
+ as: '__buildAssetsURL',
+ name: 'buildAssetsURL',
+ from: resolve(distDir, 'runtime/utils/paths'),
+ },
+ {
+ as: '__publicAssetsURL',
+ name: 'publicAssetsURL',
+ from: resolve(distDir, 'runtime/utils/paths'),
+ },
+ {
+ // TODO: Remove after https://github.com/nitrojs/nitro/issues/1049
+ as: 'defineAppConfig',
+ name: 'defineAppConfig',
+ from: resolve(distDir, 'runtime/utils/config'),
+ priority: -1,
+ },
+ ],
+ exclude: [...excludePattern, /[\\/]\.git[\\/]/],
+ },
+ // TODO: support for bundle analyser: https://github.com/nitrojs/nitro/pull/3628
+ scanDirs: layerDirs.map(dirs => dirs.server),
+ renderer: {
+ handler: resolve(distDir, 'runtime/handlers/renderer'),
+ },
+ baseURL: nuxt.options.app.baseURL,
+ virtual: {
+ '#internal/nuxt.config.mjs': () => nuxt.vfs['#build/nuxt.config.mjs'] || '',
+ '#internal/nuxt/app-config': () => nuxt.vfs['#build/app.config.mjs']?.replace(/\/\*\* client \*\*\/[\s\S]*\/\*\* client-end \*\*\//, '') || '',
+ '#spa-template': async () => `export const template = ${JSON.stringify(await spaLoadingTemplate(nuxt))}`,
+ // this will be overridden in vite plugin
+ '#internal/entry-chunk.mjs': () => `export const entryFileName = undefined`,
+ '#internal/nuxt/entry-ids.mjs': () => `export default []`,
+ '#internal/nuxt/nitro-config.mjs': () => {
+ const hasCachedRoutes = nitro.routing.routeRules.routes.some(r => r.data.isr || r.data.cache)
+ return [
+ `export const NUXT_NO_SSR = ${nuxt.options.ssr === false}`,
+ `export const NUXT_EARLY_HINTS = ${nuxt.options.experimental.writeEarlyHints !== false}`,
+ `export const NUXT_NO_SCRIPTS = ${nuxt.options.features.noScripts === 'all' || (!!nuxt.options.features.noScripts && !nuxt.options.dev)}`,
+ `export const NUXT_INLINE_STYLES = ${!!nuxt.options.features.inlineStyles}`,
+ `export const PARSE_ERROR_DATA = ${!!nuxt.options.experimental.parseErrorData}`,
+ `export const NUXT_ASYNC_CONTEXT = ${!!nuxt.options.experimental.asyncContext}`,
+ `export const NUXT_SHARED_DATA = ${!!nuxt.options.experimental.sharedPrerenderData}`,
+ `export const NUXT_PAYLOAD_EXTRACTION = ${nuxt.options.experimental.payloadExtraction !== false}`,
+ `export const NUXT_PAYLOAD_INLINE = ${nuxt.options.experimental.payloadExtraction !== true}`,
+ `export const NUXT_RUNTIME_PAYLOAD_EXTRACTION = ${hasCachedRoutes}`,
+ ].join('\n')
+ },
+ },
+ routeRules: {
+ '/**': { ssr: true },
+ '/__nuxt_error': { cache: false },
+ },
+ rolldownConfig: {
+ // don't try to resolve rolldown options from the tsconfig we generate
+ tsconfig: false,
+ },
+ typescript: {
+ generateTsConfig: true,
+ tsconfigPath: join(nuxt.options.buildDir, 'tsconfig.server.json'),
+ generatedTypesDir: join(nuxt.options.buildDir, 'types/nitro'),
+ tsConfig: {
+ compilerOptions: {
+ lib: ['esnext', 'webworker', 'dom.iterable'],
+ skipLibCheck: true,
+ noEmit: true,
+ moduleResolution: 'bundler',
+ noUncheckedIndexedAccess: true,
+ allowArbitraryExtensions: true,
+ },
+ include: [
+ join(nuxt.options.buildDir, 'types/nitro-nuxt.d.ts'),
+ ...modules.flatMap((m) => {
+ const moduleDir = relativeWithDot(nuxt.options.buildDir, m)
+ return [
+ join(moduleDir, 'runtime/server'),
+ join(moduleDir, 'dist/runtime/server'),
+ ]
+ }),
+ ...layerDirs.map(dirs => relativeWithDot(nuxt.options.buildDir, join(dirs.server, '**/*'))),
+ ...layerDirs.map(dirs => relativeWithDot(nuxt.options.buildDir, join(dirs.shared, '**/*.d.ts'))),
+ ],
+ exclude: [
+ ...nuxt.options.modulesDir.map(m => relativeWithDot(nuxt.options.buildDir, m)),
+ relativeWithDot(nuxt.options.buildDir, resolve(nuxt.options.rootDir, 'dist')),
+ ],
+ },
+ },
+ publicAssets: [
+ nuxt.options.dev
+ ? {
+ dir: resolve(nuxt.options.buildDir, 'dist/client'),
+ maxAge: 0,
+ }
+ : {
+ dir: join(nuxt.options.buildDir, 'dist/client', nuxt.options.app.buildAssetsDir),
+ maxAge: 31536000 /* 1 year */,
+ baseURL: nuxt.options.app.buildAssetsDir,
+ ignore: false,
+ },
+ ...layerPublicAssetsDirs,
+ ],
+ prerender: {
+ ignoreUnprefixedPublicAssets: true,
+ failOnError: true,
+ concurrency: cpus().length * 4 || 4,
+ routes: ([] as string[])
+ // @ts-expect-error TODO: remove in nuxt v5
+ .concat(nuxt.options.generate.routes),
+ },
+ sourcemap: !!nuxt.options.sourcemap.server,
+ traceDeps: [
+ // force include files used in generated code from the runtime-compiler
+ ...(nuxt.options.vue.runtimeCompiler)
+ ? [
+ ...nuxt.options.modulesDir.reduce<string[]>((targets, path) => {
+ const serverRendererPath = resolve(path, 'vue/server-renderer/index.js')
+ if (existsSync(serverRendererPath)) { targets.push(serverRendererPath) }
+ return targets
+ }, []),
+ ]
+ : [],
+ ],
+ noExternals: [
+ ...(nuxt.options.dev
+ ? []
+ : [
+ '@nuxt/',
+ nuxt.options.buildDir,
+ ]),
+ ...nuxt.options.build.transpile.filter((i): i is string => typeof i === 'string'),
+ 'nuxt/dist',
+ 'nuxt3/dist',
+ 'nuxt-nightly/dist',
+ distDir,
+ // Ensure app config files have auto-imports injected even if they are pure .js files
+ ...layerDirs.map(dirs => join(dirs.app, 'app.config')),
+
+ ],
+ alias: {
+ // Vue 3 mocks
+ ...nuxt.options.vue.runtimeCompiler
+ ? {}
+ : {
+ 'estree-walker': mockProxy,
+ '@babel/parser': mockProxy,
+ '@vue/compiler-core': mockProxy,
+ '@vue/compiler-dom': mockProxy,
+ '@vue/compiler-ssr': mockProxy,
+ },
+ '@vue/devtools-api': 'vue-devtools-stub',
+
+ // Nuxt aliases
+ ...nuxt.options.alias,
+
+ // Paths
+ '#internal/nuxt/paths': resolve(distDir, 'runtime/utils/paths'),
+ },
+ replace: {
+ '__VUE_PROD_DEVTOOLS__': String(false),
+ },
+ rollupConfig: {
+ output: {
+ generatedCode: {
+ symbols: true, // temporary fix for https://github.com/vuejs/core/issues/8351
+ },
+ },
+ plugins: [],
+ },
+ logLevel: logLevelMapReverse[nuxt.options.logLevel],
+ } satisfies NitroConfig)
+
+ // eslint-disable-next-line @typescript-eslint/no-deprecated
+ if (nuxt.options.experimental.serverAppConfig === true && nitroConfig.imports) {
+ nitroConfig.imports.imports ||= []
+ nitroConfig.imports.imports.push({
+ name: 'useAppConfig',
+ from: resolve(distDir, 'runtime/utils/app-config'),
+ priority: -1,
+ })
+ }
+
+ // add error handler
+ if (!nitroConfig.errorHandler && (nuxt.options.dev || !nuxt.options.experimental.noVueServer)) {
+ nitroConfig.errorHandler = resolve(distDir, 'runtime/handlers/error')
+ }
+
+ // Resolve user-provided paths
+ nitroConfig.serverDir = resolve(nuxt.options.rootDir, nuxt.options.srcDir, nitroConfig.serverDir as string)
+ nitroConfig.ignore ||= []
+ nitroConfig.ignore.push(...resolveIgnorePatterns(nitroConfig.serverDir))
+
+ const validManifestKeys = ['prerender', 'redirect', 'appMiddleware', 'appLayout', 'cache', 'isr', 'swr', 'ssr']
+
+ addTemplate({
+ filename: 'route-rules.mjs',
+ getContents () {
+ if (!nuxt._nitro) {
+ return `export default () => ({})`
+ }
+ const matcher = nuxt._nitro.routing.routeRules.compileToString({
+ matchAll: true,
+ serialize (routeRules) {
+ return `{${Object.entries(routeRules)
+ .filter(([name, value]) => value !== undefined && validManifestKeys.includes(name))
+ .map(([name, value]) => {
+ if (name === 'redirect') {
+ const redirectOptions = value as NitroRouteRules['redirect']
+ value = typeof redirectOptions === 'string' ? redirectOptions : redirectOptions!.to
+ }
+ if (name === 'appMiddleware') {
+ const appMiddlewareOptions = value as NitroRouteRules['appMiddleware']
+ if (typeof appMiddlewareOptions === 'string') {
+ value = { [appMiddlewareOptions]: true }
+ } else if (Array.isArray(appMiddlewareOptions)) {
+ const normalizedRules: Record<string, boolean> = {}
+ for (const middleware of appMiddlewareOptions) {
+ normalizedRules[middleware] = true
+ }
+ value = normalizedRules
+ }
+ }
+ if (name === 'cache' || name === 'isr' || name === 'swr') {
+ name = 'payload'
+ value = Boolean(value)
+ }
+ return `${name}: ${JSON.stringify(value)}`
+ }).join(',')
+ }}`
+ },
+ })
+ return `
+ import { defu } from 'defu'
+ const matcher = ${matcher}
+ export default (path) => defu({}, ...matcher('', path).map(r => r.data).reverse())
+ `
+ },
+ })
+
+ if (nuxt.options.experimental.payloadExtraction) {
+ if (nuxt.options.dev) {
+ nuxt.hook('nitro:config', (nitroConfig) => {
+ nitroConfig.prerender ||= {}
+ nitroConfig.prerender.routes ||= []
+ nitroConfig.routeRules ||= {}
+ for (const route of nitroConfig.prerender.routes) {
+ if (!route) { continue }
+ nitroConfig.routeRules[route] = defu(nitroConfig.routeRules[route], { prerender: true })
+ }
+ })
+ }
+ nuxt.hook('nitro:init', (nitro) => {
+ nitro.hooks.hook('build:before', async (nitro) => {
+ const updatedRules: Record<string, Record<string, any>> = {}
+ for (const { route, data: value } of nitro.routing.routeRules.routes) {
+ if (!route.endsWith('*') && !route.endsWith('/_payload.json')) {
+ if (value.ssr === false) { continue }
+ if ((value.isr || value.cache) || (value.prerender && nuxt.options.dev)) {
+ const payloadKey = (route === '/' ? '' : route) + '/_payload.json'
+ const defaults = { ssr: true } as Record<string, any>
+ for (const key of ['isr', 'cache', ...nuxt.options.dev ? ['prerender'] : []]) {
+ if (key in value) {
+ defaults[key] = value[key as keyof typeof value]
+ }
+ }
+ updatedRules[payloadKey] = defu(nitro.options.routeRules[payloadKey], defaults)
+ }
+ }
+ }
+ await nitro.updateConfig({ routeRules: { ...nitro.options.routeRules, ...updatedRules } })
+ nitro.routing.sync()
+ })
+ })
+ }
+
+ // Add app manifest handler and prerender configuration
+ if (nuxt.options.experimental.appManifest) {
+ const buildId = nuxt.options.runtimeConfig.app.buildId ||= nuxt.options.buildId
+ const buildTimestamp = Date.now()
+
+ const manifestPrefix = joinURL(nuxt.options.app.buildAssetsDir, 'builds')
+ const tempDir = join(nuxt.options.buildDir, 'manifest')
+
+ nitroConfig.prerender ||= {}
+ nitroConfig.prerender.ignore ||= []
+ nitroConfig.prerender.ignore.push(joinURL(nuxt.options.app.baseURL, manifestPrefix))
+
+ nitroConfig.publicAssets!.unshift(
+ // build manifest
+ {
+ dir: join(tempDir, 'meta'),
+ maxAge: 31536000 /* 1 year */,
+ baseURL: joinURL(manifestPrefix, 'meta'),
+ },
+ // latest build
+ {
+ dir: tempDir,
+ maxAge: 1,
+ baseURL: manifestPrefix,
+ },
+ )
+
+ nuxt.options.alias['#app-manifest'] = join(tempDir, `meta/${buildId}.json`)
+
+ // write stub manifest before build so external import of #app-manifest can be resolved
+ if (!nuxt.options.dev) {
+ nuxt.hook('build:before', async () => {
+ await fsp.mkdir(join(tempDir, 'meta'), { recursive: true })
+ await fsp.writeFile(join(tempDir, `meta/${buildId}.json`), JSON.stringify({}))
+ })
+ }
+
+ nuxt.hook('nitro:config', (config) => {
+ config.alias ||= {}
+ config.alias['#app-manifest'] = join(tempDir, `meta/${buildId}.json`)
+ })
+
+ nuxt.hook('nitro:init', (nitro) => {
+ nitro.hooks.hook('rollup:before', async (nitro) => {
+ // Add pages prerendered but not covered by route rules
+ const prerenderedRoutes = new Set<string>()
+ if (nitro._prerenderedRoutes?.length) {
+ const payloadSuffix = '/_payload.json'
+ for (const route of nitro._prerenderedRoutes) {
+ if (!route.error && route.route.endsWith(payloadSuffix)) {
+ const url = route.route.slice(0, -payloadSuffix.length) || '/'
+ const rules = defu({}, ...nitro.routing.routeRules.matchAll('', url).reverse()) as Record<string, any>
+ if (!rules.prerender) {
+ prerenderedRoutes.add(url)
+ }
+ }
+ }
+ }
+
+ const manifest = {
+ id: buildId,
+ timestamp: buildTimestamp,
+ prerendered: nuxt.options.dev ? [] : [...prerenderedRoutes],
+ }
+
+ await fsp.mkdir(join(tempDir, 'meta'), { recursive: true })
+ await fsp.writeFile(join(tempDir, 'latest.json'), JSON.stringify({
+ id: buildId,
+ timestamp: buildTimestamp,
+ }))
+ await fsp.writeFile(join(tempDir, `meta/${buildId}.json`), JSON.stringify(manifest))
+ })
+ })
+ }
+
+ // add stub alias to allow vite to resolve import
+ if (!nuxt.options.experimental.appManifest) {
+ nuxt.options.alias['#app-manifest'] = mockProxy
+ }
+
+ // Add fallback server for `ssr: false`
+ const FORWARD_SLASH_RE = /\//g
+ if (!nuxt.options.ssr) {
+ nitroConfig.virtual!['#build/dist/server/server.mjs'] = 'export default () => {}'
+ // In case a non-normalized absolute path is called for on Windows
+ if (process.platform === 'win32') {
+ nitroConfig.virtual!['#build/dist/server/server.mjs'.replace(FORWARD_SLASH_RE, '\\')] = 'export default () => {}'
+ }
+ }
+
+ if (nuxt.options.dev) {
+ nitroConfig.virtual!['#build/dist/server/styles.mjs'] = 'export default {}'
+ // In case a non-normalized absolute path is called for on Windows
+ if (process.platform === 'win32') {
+ nitroConfig.virtual!['#build/dist/server/styles.mjs'.replace(FORWARD_SLASH_RE, '\\')] = 'export default {}'
+ }
+ }
+
+ // Add decorator support via Babel when experimental.decorators is enabled.
+ if (nuxt.options.experimental.decorators) {
+ const nitroDecoratorDeps = ['@rollup/plugin-babel', '@babel/plugin-proposal-decorators', '@babel/plugin-syntax-typescript']
+ const result = await ensureDependencyInstalled(nitroDecoratorDeps, {
+ rootDir: nuxt.options.rootDir,
+ searchPaths: nuxt.options.modulesDir,
+ from: import.meta.url,
+ })
+
+ if (result !== true) {
+ logger.warn(`Install ${result.map(d => `\`${d}\``).join(' and ')} to enable decorator support.`)
+ }
+
+ if (result === true) {
+ const { babel } = await import('@rollup/plugin-babel')
+ nitroConfig.rollupConfig!.plugins = toArray(await nitroConfig.rollupConfig!.plugins || [])
+ nitroConfig.rollupConfig!.plugins!.unshift(
+ babel({
+ babelHelpers: 'bundled',
+ configFile: false,
+ extensions: ['.ts', '.js', '.mjs', '.mts'],
+ plugins: [
+ // Syntax plugin allows Babel to parse TypeScript without transforming it,
+ // since the actual TS stripping is handled later by the bundler's esbuild plugin.
+ ['@babel/plugin-syntax-typescript', { isTSX: false }],
+ ['@babel/plugin-proposal-decorators', { version: '2023-11' }],
+ ],
+ }),
+ babel({
+ babelHelpers: 'bundled',
+ configFile: false,
+ extensions: ['.tsx', '.jsx'],
+ plugins: [
+ ['@babel/plugin-syntax-typescript', { isTSX: true }],
+ ['@babel/plugin-proposal-decorators', { version: '2023-11' }],
+ ],
+ }),
+ )
+ }
+ }
+
+ // Register nuxt protection patterns
+ nitroConfig.rollupConfig!.plugins = await nitroConfig.rollupConfig!.plugins || []
+ nitroConfig.rollupConfig!.plugins = toArray(nitroConfig.rollupConfig!.plugins)
+
+ const sharedDir = withTrailingSlash(resolve(nuxt.options.rootDir, nuxt.options.dir.shared))
+ const relativeSharedDir = withTrailingSlash(relative(nuxt.options.rootDir, resolve(nuxt.options.rootDir, nuxt.options.dir.shared)))
+ const sharedPatterns = [/^#shared\//, new RegExp('^' + escapeRE(sharedDir)), new RegExp('^' + escapeRE(relativeSharedDir))]
+ nitroConfig.rollupConfig!.plugins!.push(
+ ImpoundPlugin.rollup({
+ cwd: nuxt.options.rootDir,
+ trace: true,
+ include: sharedPatterns,
+ patterns: createImportProtectionPatterns(nuxt, { context: 'shared' }),
+ }),
+ ImpoundPlugin.rollup({
+ cwd: nuxt.options.rootDir,
+ trace: true,
+ patterns: createImportProtectionPatterns(nuxt, { context: 'nitro-app' }),
+ exclude: [/node_modules[\\/]nitro(?:pack)?(?:-nightly)?[\\/]|(packages|@nuxt)[\\/]nitro-server(?:-nightly)?[\\/](src|dist)[\\/]runtime[\\/]/, ...sharedPatterns],
+ }),
+ )
+
+ // Apply Nuxt's ignore configuration to the root and src unstorage mounts
+ // created by Nitro. This ensures that the unstorage watcher will use the
+ // same ignore list as Nuxt's watcher and can reduce unnecessary file handles.
+ const isIgnored = createIsIgnored(nuxt)
+ nitroConfig.devStorage ??= {}
+ nitroConfig.devStorage.root ??= {
+ driver: 'fs',
+ readOnly: true,
+ base: nitroConfig.rootDir,
+ watchOptions: {
+ ignored: [isIgnored],
+ },
+ }
+ nitroConfig.devStorage.src ??= {
+ driver: 'fs',
+ readOnly: true,
+ base: nitroConfig.serverDir,
+ watchOptions: {
+ ignored: [isIgnored],
+ },
+ }
+
+ const cacheDriverPath = join(distDir, 'runtime/utils/cache-driver.js')
+ const cacheDriverOption = isWindows ? pathToFileURL(cacheDriverPath).href : cacheDriverPath
+
+ // Use hash-based cache driver for runtime payload cache to avoid conflicts when
+ // path is both a file and a directory prefix: https://github.com/nuxt/nuxt/issues/34547
+ if (nuxt.options.dev) {
+ const payloadCacheDir = resolve(nuxt.options.buildDir, 'cache/nuxt/payload')
+ nitroConfig.devStorage['cache:nuxt:payload'] ||= {
+ driver: cacheDriverOption,
+ base: payloadCacheDir,
+ }
+ }
+
+ // Hoist types for nitro implicit dependencies
+ nuxt.options.typescript.hoist.push(
+ // Nitro auto-imported/augmented dependencies
+ 'nitro',
+ 'nitro/app',
+ 'nitro/builder',
+ 'nitro/cache',
+ 'nitro/config',
+ 'nitro/context',
+ 'nitro/database',
+ 'nitro/h3',
+ 'nitro/meta',
+ 'nitro/runtime-config',
+ 'nitro/storage',
+ 'nitro/task',
+ 'nitro/types',
+ // TODO: remove in v5
+ 'nitropack/types',
+ 'nitropack/runtime',
+ 'nitropack',
+ 'srvx',
+ 'defu',
+ 'h3',
+ 'consola',
+ 'ofetch',
+ 'crossws',
+ )
+
+ // Extend nitro config with hook
+ await nuxt.callHook('nitro:config', nitroConfig)
+
+ if (nitroConfig.static && nuxt.options.dev) {
+ nitroConfig.routeRules ||= {}
+ nitroConfig.routeRules['/**'] = defu(nitroConfig.routeRules['/**'], { prerender: true })
+ }
+
+ // TODO: extract to shared utility?
+ const excludedAlias = [/^@vue\/.*$/, 'vue', /vue-router/, 'vite/client', '#imports', 'vue-demi', /^#app/, '~', '@', '~~', '@@']
+ // TODO: remove support for baseUrl in nuxt v5
+ // eslint-disable-next-line @typescript-eslint/no-deprecated
+ const basePath = nitroConfig.typescript!.tsConfig!.compilerOptions?.baseUrl ? resolve(nuxt.options.buildDir, nitroConfig.typescript!.tsConfig!.compilerOptions?.baseUrl) : nuxt.options.buildDir
+ const aliases = nitroConfig.alias!
+ const tsConfig = nitroConfig.typescript!.tsConfig!
+ tsConfig.compilerOptions ||= {}
+ tsConfig.compilerOptions.paths ||= {}
+ for (const _alias in aliases) {
+ const alias = _alias as keyof typeof aliases
+ if (excludedAlias.some(pattern => typeof pattern === 'string' ? alias === pattern : pattern.test(alias))) {
+ continue
+ }
+ if (alias in tsConfig.compilerOptions.paths) {
+ continue
+ }
+
+ const absolutePath = resolve(basePath, aliases[alias]!)
+ const isDirectory = aliases[alias]!.endsWith('/') || await fsp.stat(absolutePath).then(r => r.isDirectory()).catch(() => null /* file does not exist */)
+ // note - nitro will check + remove the file extension as required
+ tsConfig.compilerOptions.paths[alias] = [absolutePath]
+ if (isDirectory) {
+ tsConfig.compilerOptions.paths[`${alias}/*`] = [`${absolutePath}/*`]
+ }
+ }
+
+ // Init nitro
+ nuxt._perf?.startPhase('nitro:createNitro')
+ const nitro = await createNitro(nitroConfig, {
+ compatibilityDate: nuxt.options.compatibilityDate,
+ dotenv: nuxt.options._loadOptions?.dotenv,
+ })
+ nuxt._perf?.endPhase('nitro:createNitro')
+
+ // TODO: remove when devtools gains support for nitro v3
+ // @ts-expect-error devtools calls storage.watch() and storage.getMount()
+ nitro.storage ||= { watch: () => {}, getMount: () => ({}) }
+
+ // For full-static output, ensure payload extraction is not disabled
+ if (nuxt.options.ssr && nitro.options.static && nuxt.options.experimental.payloadExtraction === false) {
+ logger.warn('Payload extraction is recommended for full-static output. You can enable it by setting `experimental.payloadExtraction` to `true` or `\'client\'`.')
+ }
+
+ // Trigger Nitro reload when SPA loading template changes
+ const spaLoadingTemplateFilePath = await spaLoadingTemplatePath(nuxt)
+ nuxt.hook('builder:watch', async (_event, relativePath) => {
+ const path = resolve(nuxt.options.srcDir, relativePath)
+ if (path === spaLoadingTemplateFilePath) {
+ await nitro.hooks.callHook('rollup:reload')
+ }
+ })
+
+ const cacheDir = resolve(nuxt.options.buildDir, 'cache/nitro/prerender')
+ await fsp.rm(cacheDir, { recursive: true, force: true }).catch(() => {})
+ nitro.options._config.storage = defu(nitro.options._config.storage, {
+ 'internal:nuxt:prerender': {
+ // TODO: resolve upstream where file URLs are not being resolved/inlined correctly
+ driver: cacheDriverOption,
+ base: cacheDir,
+ },
+ })
+
+ // Expose nitro to modules and kit
+ nuxt._nitro = nitro
+ await nuxt.callHook('nitro:init', nitro)
+
+ // Instrument Nitro rollup plugins for perf tracking
+ if (nuxt._perf) {
+ nitro.hooks.hook('rollup:before', (_nitro, rollupConfig) => {
+ const plugins = (rollupConfig.plugins || []) as Array<{ name?: string, transform?: (...a: any[]) => any, resolveId?: (...a: any[]) => any, load?: (...a: any[]) => any } | null>
+ for (const plugin of plugins) {
+ if (!plugin || !plugin.name) { continue }
+ const pluginName = `nitro:${plugin.name}`
+ for (const hookName of ['transform', 'resolveId', 'load'] as const) {
+ const original = plugin[hookName]
+ if (typeof original !== 'function') { continue }
+ plugin[hookName] = function (this: any, ...args: any[]) {
+ const start = performance.now()
+ const record = () => nuxt._perf?.recordBundlerPluginHook(pluginName, hookName, performance.now() - start, start)
+ try {
+ const result = original.apply(this, args)
+ if (result && typeof result === 'object' && 'then' in result) {
+ return (result as Promise<any>).finally(record)
+ }
+ record()
+ return result
+ } catch (err) {
+ record()
+ throw err
+ }
+ } as any
+ }
+ }
+ })
+ }
+
+ nuxt['~runtimeDependencies'] ||= []
+ nuxt['~runtimeDependencies']!.push(
+ ...runtimeDependencies,
+ 'unhead', '@unhead/vue', 'unstorage',
+ // ensure we only have one version of vue if nitro is going to inline anyway
+ ...nitro.options.inlineDynamicImports ? ['vue', '@vue/server-renderer'] : [],
+ )
+
+ addVitePlugin({
+ name: 'nuxt:nitro:ssr-conditions',
+ configEnvironment (name, config) {
+ if (name === 'ssr') {
+ config.resolve ||= {}
+ config.resolve.conditions = getSsrResolveConditions(nitro.options.exportConditions)
+ }
+ },
+ })
+
+ addVitePlugin({
+ name: 'nuxt:nitro:config',
+ configEnvironment (name) {
+ if (name === 'client') {
+ return {
+ optimizeDeps: {
+ exclude: [
+ 'nitro/h3',
+ ],
+ },
+ }
+ }
+ },
+ })
+
+ // Tree-shake Vue feature flags for non-node Nitro targets
+ addVitePlugin({
+ name: 'nuxt:nitro:vue-feature-flags',
+ applyToEnvironment: environment => environment.name === 'ssr' && environment.config.isProduction,
+ configResolved (config) {
+ for (const key in config.define) {
+ if (key.startsWith('__VUE')) {
+ nitro.options.replace[key] = config.define[key]
+ }
+ }
+ },
+ })
+
+ // Connect vfs storages
+ const nitroVfs = nitro.vfs
+ nitro.vfs = new Proxy(nitroVfs, {
+ get (target, prop: string) {
+ return Reflect.get(target, prop) || { render: () => nuxt.vfs[prop] }
+ },
+ set (target, prop: string, value) {
+ return Reflect.set(target, prop, value)
+ },
+ })
+
+ // Connect hooks
+ nuxt.hook('close', () => nitro.hooks.callHook('close'))
+ nitro.hooks.hook('prerender:routes', (routes) => {
+ return nuxt.callHook('prerender:routes', { routes })
+ })
+
+ // Enable runtime compiler client side
+ if (nuxt.options.vue.runtimeCompiler) {
+ addVitePlugin({
+ name: 'nuxt:vue:runtime-compiler',
+ applyToEnvironment: environment => environment.name === 'client',
+ enforce: 'pre',
+ resolveId (id, importer) {
+ if (id === 'vue') {
+ return this.resolve('vue/dist/vue.esm-bundler', importer, { skipSelf: true })
+ }
+ },
+ })
+ for (const hook of ['webpack:config', 'rspack:config'] as const) {
+ nuxt.hook(hook, (configuration) => {
+ const clientConfig = configuration.find(config => config.name === 'client')
+ if (!clientConfig!.resolve) { clientConfig!.resolve!.alias = {} }
+ if (Array.isArray(clientConfig!.resolve!.alias)) {
+ clientConfig!.resolve!.alias.push({
+ name: 'vue',
+ alias: 'vue/dist/vue.esm-bundler',
+ })
+ } else {
+ clientConfig!.resolve!.alias!.vue = 'vue/dist/vue.esm-bundler'
+ }
+ })
+ }
+ }
+
+ // Setup handlers
+ const devMiddlewareHandler = dynamicEventHandler()
+ nitro.options.devHandlers.unshift({ route: '', handler: devMiddlewareHandler })
+ nitro.options.devHandlers.push(...nuxt.options.devServerHandlers)
+ nitro.options.handlers.unshift({
+ route: '/__nuxt_error',
+ lazy: true,
+ handler: resolve(distDir, 'runtime/handlers/renderer'),
+ })
+
+ // TODO: refactor into a module when this is more full-featured
+ // add Chrome devtools integration
+ if (nuxt.options.experimental.chromeDevtoolsProjectSettings) {
+ const cacheDir = resolve(nuxt.options.rootDir, 'node_modules/.cache/nuxt')
+ let projectConfiguration = await readFile(join(cacheDir, 'chrome-workspace.json'), 'utf-8')
+ .then(r => JSON.parse(r))
+ .catch(() => null)
+
+ if (!projectConfiguration) {
+ projectConfiguration = { uuid: randomUUID() }
+ await mkdir(cacheDir, { recursive: true })
+ await writeFile(join(cacheDir, 'chrome-workspace.json'), JSON.stringify(projectConfiguration), 'utf-8')
+ }
+
+ nitro.options.devHandlers.push({
+ route: '/.well-known/appspecific/com.chrome.devtools.json',
+ handler: defineEventHandler(() => ({
+ workspace: {
+ ...projectConfiguration,
+ root: nuxt.options.rootDir,
+ },
+ })),
+ })
+ }
+
+ if (!nuxt.options.dev && nuxt.options.experimental.noVueServer) {
+ nitro.hooks.hook('rollup:before', (nitro) => {
+ if (nitro.options.preset === 'nitro-prerender') {
+ nitro.options.errorHandler = resolve(distDir, 'runtime/handlers/error')
+ return
+ }
+ const nuxtErrorHandler = nitro.options.handlers.findIndex(h => h.route === '/__nuxt_error')
+ if (nuxtErrorHandler >= 0) {
+ nitro.options.handlers.splice(nuxtErrorHandler, 1)
+ }
+
+ nitro.options.renderer = undefined
+ })
+ }
+
+ // ensure Nitro types only apply to server directory and not the whole root directory
+ nitro.hooks.hook('types:extend', (types) => {
+ types.tsConfig ||= {}
+ const rootDirGlob = relativeWithDot(nuxt.options.buildDir, join(nuxt.options.rootDir, '**/*'))
+ types.tsConfig.include = types.tsConfig.include?.filter(i => i !== rootDirGlob)
+ })
+
+ // Add typed route responses
+ nuxt.hook('prepare:types', async (opts) => {
+ if (!nuxt.options.dev) {
+ await writeTypes(nitro)
+ }
+ // Exclude nitro output dir from typescript
+ opts.tsConfig.exclude ||= []
+ opts.tsConfig.exclude.push(relative(nuxt.options.buildDir, resolve(nuxt.options.rootDir, nitro.options.output.dir)))
+ opts.tsConfig.exclude.push(relative(nuxt.options.buildDir, resolve(nuxt.options.rootDir, nuxt.options.serverDir)))
+ opts.references.push({ path: resolve(nuxt.options.buildDir, 'types/nitro.d.ts') })
+
+ // ensure aliases shared between nuxt + nitro are included in shared tsconfig
+ opts.sharedTsConfig.compilerOptions ||= {}
+ opts.sharedTsConfig.compilerOptions.paths ||= {}
+ for (const key in nuxt.options.alias) {
+ if (nitro.options.alias[key] && nitro.options.alias[key] === nuxt.options.alias[key]) {
+ const dirKey = join(key, '*')
+ if (opts.tsConfig.compilerOptions?.paths[key]) {
+ opts.sharedTsConfig.compilerOptions.paths[key] = opts.tsConfig.compilerOptions.paths[key]
+ }
+ if (opts.tsConfig.compilerOptions?.paths[dirKey]) {
+ opts.sharedTsConfig.compilerOptions.paths[dirKey] = opts.tsConfig.compilerOptions.paths[dirKey]
+ }
+ }
+ }
+ })
+
+ if (nitro.options.static) {
+ nitro.hooks.hook('prerender:routes', (routes) => {
+ for (const route of ['/200.html', '/404.html']) {
+ routes.add(route)
+ }
+ if (!nuxt.options.ssr) {
+ routes.add('/index.html')
+ }
+ })
+ }
+
+ // Copy public assets after prerender so app manifest can be present
+ if (!nuxt.options.dev) {
+ nitro.hooks.hook('rollup:before', async (nitro) => {
+ await copyPublicAssets(nitro)
+ await nuxt.callHook('nitro:build:public-assets', nitro)
+ })
+ }
+
+ async function symlinkDist () {
+ if (nitro.options.static) {
+ const distDir = resolve(nuxt.options.rootDir, 'dist')
+ if (!existsSync(distDir)) {
+ await fsp.symlink(nitro.options.output.publicDir, distDir, 'junction').catch(() => {})
+ }
+ }
+ }
+
+ // nuxt dev
+ let waitUntilCompile: Promise<void> | undefined
+ if (nuxt.options.dev) {
+ for (const builder of ['webpack', 'rspack'] as const) {
+ nuxt.hook(`${builder}:compile`, ({ name, compiler }) => {
+ if (name === 'server') {
+ const memfs = compiler.outputFileSystem as typeof import('node:fs')
+ nitro.options.virtual['#build/dist/server/server.mjs'] = () => memfs.readFileSync(join(nuxt.options.buildDir, 'dist/server/server.mjs'), 'utf-8')
+ }
+ })
+ nuxt.hook(`${builder}:compiled`, () => { nuxt.server.reload() })
+ }
+ nuxt.hook('vite:compiled', () => { nuxt.server.reload() })
+
+ nuxt.hook('server:devHandler', (h, options) => {
+ devMiddlewareHandler.set(defineEventHandler((event) => {
+ if (options.cors(event.url.pathname)) {
+ const isPreflight = handleCors(event, nuxt.options.devServer.cors)
+ if (isPreflight) {
+ return null
+ }
+ event.res.headers.set('Vary', 'Origin')
+ }
+ return h(event)
+ }))
+ })
+ nuxt.server = createDevServer(nitro)
+
+ waitUntilCompile = new Promise<void>(resolve => nitro.hooks.hook('compiled', () => resolve()))
+ }
+
+ // nuxt build/dev
+ nuxt.hook('build:done', async () => {
+ nuxt._perf?.startPhase('nitro:build')
+ try {
+ await nuxt.callHook('nitro:build:before', nitro)
+ await prepare(nitro)
+ if (nuxt.options.dev) {
+ await build(nitro)
+ await waitUntilCompile
+ return
+ }
+
+ await prerender(nitro)
+
+ logger.restoreAll()
+ await build(nitro)
+ logger.wrapAll()
+
+ await symlinkDist()
+ } finally {
+ nuxt._perf?.endPhase('nitro:build')
+ }
+ })
+}
+
+const RELATIVE_RE = /^([^.])/
+function relativeWithDot (from: string, to: string) {
+ return relative(from, to).replace(RELATIVE_RE, './$1') || '.'
+}
+
+async function spaLoadingTemplatePath (nuxt: Nuxt) {
+ if (typeof nuxt.options.spaLoadingTemplate === 'string') {
+ return resolve(nuxt.options.srcDir, nuxt.options.spaLoadingTemplate)
+ }
+
+ const possiblePaths = nuxt.options._layers.map(layer => resolve(layer.config.srcDir, layer.config.dir?.app || 'app', 'spa-loading-template.html'))
+
+ return await findPath(possiblePaths) ?? resolve(nuxt.options.srcDir, nuxt.options.dir?.app || 'app', 'spa-loading-template.html')
+}
+
+async function spaLoadingTemplate (nuxt: Nuxt) {
+ if (nuxt.options.spaLoadingTemplate === false) { return '' }
+
+ const spaLoadingTemplate = await spaLoadingTemplatePath(nuxt)
+
+ try {
+ if (existsSync(spaLoadingTemplate)) {
+ return readFileSync(spaLoadingTemplate, 'utf-8').trim()
+ }
+ } catch {
+ // fall through if we have issues reading the file
+ }
+
+ if (nuxt.options.spaLoadingTemplate === true) {
+ return defaultSpaLoadingTemplate()
+ }
+
+ if (nuxt.options.spaLoadingTemplate) {
+ logger.warn(`Could not load custom \`spaLoadingTemplate\` path as it does not exist: \`${nuxt.options.spaLoadingTemplate}\`.`)
+ }
+
+ return ''
+}
diff --git a/packages/nitro-server/src/runtime/h3-compat.ts b/packages/nitro-server/src/runtime/h3-compat.ts
new file mode 100644
index 000000000000..1690613d29d1
--- /dev/null
+++ b/packages/nitro-server/src/runtime/h3-compat.ts
@@ -0,0 +1,21 @@
+/**
+ * h3 compatibility layer for Nuxt runtime code.
+ */
+
+// export named re-exports to help rolldown statically link consumers
+export {
+ HTTPError,
+ // eslint-disable-next-line @typescript-eslint/no-deprecated
+ H3Error,
+ H3Event,
+ // eslint-disable-next-line @typescript-eslint/no-deprecated
+ createError,
+ deleteCookie,
+ getCookie,
+ getRequestURL,
+ sanitizeStatusCode,
+ setCookie,
+} from 'nitro/h3'
+export type { EventHandlerRequest } from 'nitro/h3'
+
+export * from 'nitro/h3'
diff --git a/packages/nitro-server/src/runtime/handlers/error.ts b/packages/nitro-server/src/runtime/handlers/error.ts
new file mode 100644
index 000000000000..c214857514d6
--- /dev/null
+++ b/packages/nitro-server/src/runtime/handlers/error.ts
@@ -0,0 +1,125 @@
+import { withQuery } from 'ufo'
+import type { NitroErrorHandler } from 'nitro/types'
+import type { NuxtPayload } from 'nuxt/app'
+import type { H3Event } from 'nitro/h3'
+import { serverFetch } from 'nitro'
+
+import { isJsonRequest } from '../utils/error'
+import { generateErrorOverlayHTML } from '../utils/dev'
+
+export default <NitroErrorHandler> async function errorhandler (error, event, { defaultHandler }) {
+ // invoke default Nitro error handler (which will log appropriately if required)
+ const defaultRes = await defaultHandler(error, event, { json: true })
+
+ // return Nitro response + our headers for redirects and JSON responses
+ const status = error.status || 500
+ const headers = new Headers(error.headers)
+ if (isJsonRequest(event) || (status === 404 && defaultRes.status === 302)) {
+ const setCookies = new Set(headers.getSetCookie())
+ const headerEntries = [
+ new Headers(defaultRes.headers),
+ ...('res' in event ? [(event.res as Response).headers.entries()] : []),
+ ]
+ for (const entries of headerEntries) {
+ mergeHeaders(headers, entries, setCookies)
+ }
+
+ return new Response(typeof defaultRes.body === 'string' ? defaultRes.body : JSON.stringify(defaultRes.body, null, 2), {
+ headers,
+ status: defaultRes.status,
+ statusText: defaultRes.statusText,
+ })
+ }
+
+ if (import.meta.dev && defaultRes.body && typeof defaultRes.body !== 'string' && Array.isArray(defaultRes.body.stack)) {
+ // normalize to string format expected by nuxt `error.vue`
+ defaultRes.body.stack = defaultRes.body.stack.join('\n')
+ }
+
+ const errorObject = (defaultRes.body || {}) as Pick<NonNullable<NuxtPayload['error']>, 'status' | 'statusText' | 'message' | 'stack'> & { url?: string, data: any }
+ // we will be rendering this error internally so we pass along the error.data safely
+ errorObject.data ??= error.data
+ errorObject.url = event.req.url
+
+ // Merge defaultRes headers, skipping content-type (would be application/json)
+ // and content-security-policy (would disable JS execution in the error page)
+ mergeHeaders(headers, new Headers(defaultRes.headers), new Set(), IGNORED_ERROR_HEADERS)
+
+ // Skip SSR error rendering if we're already inside one, to avoid recursion.
+ const isRenderingError = (event as H3Event).url?.pathname.startsWith('/__nuxt_error') || !!(event as H3Event).context.nuxt?.['~rendering-error']
+
+ if (!isRenderingError) {
+ const eventContext = (event as H3Event).context
+ eventContext.nuxt ||= {}
+ eventContext.nuxt['~rendering-error'] = true
+ }
+
+ // HTML response (via SSR)
+ const res = !isRenderingError && await serverFetch(
+ withQuery('/__nuxt_error', errorObject),
+ {
+ headers: event.req.headers,
+ redirect: 'manual',
+ },
+ {
+ nuxt: {
+ '~internal': true,
+ '~rendering-error': true,
+ },
+ },
+ ).catch(() => null)
+
+ // Fallback to static rendered error page
+ if (!res) {
+ const { template } = await import('../templates/error-500')
+ if (import.meta.dev) {
+ // TODO: Support `message` in template
+ (errorObject as any).description = errorObject.message
+ }
+ headers.set('Content-Type', 'text/html;charset=UTF-8')
+
+ return new Response(template(errorObject), {
+ headers,
+ status: defaultRes.status,
+ statusText: defaultRes.statusText,
+ })
+ }
+
+ let html = await res.text()
+
+ if (import.meta.dev && !import.meta.test && typeof html === 'string') {
+ const prettyResponse = await defaultHandler(error, event, { json: false })
+ if (typeof prettyResponse.body === 'string') {
+ html = html.replace('</body>', `${generateErrorOverlayHTML(prettyResponse.body, { startMinimized: 300 <= error.status && error.status < 500 })}</body>`)
+ }
+ }
+
+ const setCookies = new Set(headers.getSetCookie())
+ mergeHeaders(headers, res.headers, setCookies)
+ if ('res' in event) {
+ mergeHeaders(headers, (event as H3Event).res.headers, setCookies)
+ }
+
+ return new Response(html, {
+ headers,
+ status: res.status && res.status !== 200 ? res.status : defaultRes.status,
+ statusText: res.statusText || defaultRes.statusText,
+ })
+}
+// Headers that should not be forwarded from the default handler or SSR render to the error page
+const IGNORED_ERROR_HEADERS = new Set(['content-type', 'content-security-policy'])
+
+function mergeHeaders (target: Headers, overrides: Headers | [string, string][] | HeadersIterator<[string, string]>, setCookies: Set<string>, ignore?: Set<string>): Headers {
+ for (const [name, value] of overrides) {
+ if (ignore?.has(name)) { continue }
+ if (name === 'set-cookie') {
+ if (!setCookies.has(value)) {
+ setCookies.add(value)
+ target.append(name, value)
+ }
+ } else {
+ target.set(name, value)
+ }
+ }
+ return target
+}
diff --git a/packages/nitro-server/src/runtime/handlers/island.ts b/packages/nitro-server/src/runtime/handlers/island.ts
new file mode 100644
index 000000000000..59f3cdb12e12
--- /dev/null
+++ b/packages/nitro-server/src/runtime/handlers/island.ts
@@ -0,0 +1,195 @@
+import { useNitroHooks } from 'nitro/app'
+import type { RenderResponse } from 'nitro/types'
+import type { Link, SerializableHead } from '@unhead/vue/types'
+import { destr } from 'destr'
+import type { H3Event } from 'nitro/h3'
+import { HTTPError, defineEventHandler, getQuery, readBody } from 'nitro/h3'
+import { resolveUnrefHeadInput } from '@unhead/vue'
+import { getRequestDependencies } from 'vue-bundle-renderer/runtime'
+import { getQuery as getURLQuery } from 'ufo'
+import { computeIslandHash, filterIslandProps } from '#app/island-hash'
+import type { NuxtIslandContext, NuxtIslandResponse } from 'nuxt/app'
+import { islandCache, islandPropCache } from '../utils/cache'
+import { createSSRContext } from '../utils/renderer/app'
+import { getSSRRenderer } from '../utils/renderer/build-files'
+import { renderInlineStyles } from '../utils/renderer/inline-styles'
+import { getClientIslandResponse, getServerComponentHTML, getSlotIslandResponse } from '../utils/renderer/islands'
+
+const ISLAND_SUFFIX_RE = /\.json(?:\?.*)?$/
+
+const handler: ReturnType<typeof defineEventHandler> = defineEventHandler(async (event) => {
+ event.res.headers.set('content-type', 'application/json;charset=utf-8')
+ event.res.headers.set('x-powered-by', 'Nuxt')
+
+ const islandPath = event.url.pathname
+ if (import.meta.prerender && await islandCache!.hasItem(islandPath)) {
+ return islandCache!.getItem(islandPath) as Promise<Partial<RenderResponse>>
+ }
+
+ const islandContext = await getIslandContext(event)
+
+ const ssrContext = {
+ ...createSSRContext(event),
+ islandContext,
+ noSSR: false,
+ url: islandContext.url,
+ }
+
+ // Render app
+ const renderer = await getSSRRenderer()
+
+ const renderResult = await renderer.renderToString(ssrContext).catch(async (err) => {
+ if (ssrContext['~renderResponse'] && (err as Error)?.message === 'skipping render') {
+ return {} as Awaited<ReturnType<typeof renderer.renderToString>>
+ }
+ await ssrContext.nuxt?.hooks.callHook('app:error', err)
+ throw err
+ })
+
+ // Fire `app:rendered` before checking `~renderResponse` (matches `renderer.ts`), so
+ // anything hooking into it, like `useCookie`, will still work on redirect/reject.
+ await ssrContext.nuxt?.hooks.callHook('app:rendered', { ssrContext, renderResult })
+
+ if (ssrContext['~renderResponse']) {
+ const response = ssrContext['~renderResponse']
+ if (response.status && response.status >= 400) {
+ throw new HTTPError({
+ status: response.status,
+ statusText: response.statusText,
+ })
+ }
+ return returnIslandResponse(event, response)
+ }
+
+ // Handle errors
+ if (ssrContext.payload?.error) {
+ throw ssrContext.payload.error
+ }
+
+ const inlinedStyles = await renderInlineStyles(ssrContext.modules ?? [])
+
+ if (inlinedStyles.length) {
+ ssrContext.head.push({ style: inlinedStyles })
+ }
+
+ if (import.meta.dev) {
+ const { styles } = getRequestDependencies(ssrContext, renderer.rendererContext)
+
+ const link: Link[] = []
+ for (const resource of Object.values(styles)) {
+ // Do not add links to resources that are inlined (vite v5+)
+ if ('inline' in getURLQuery(resource.file)) {
+ continue
+ }
+ // Add CSS links in <head> for CSS files
+ // - in dev mode when rendering an island and the file has scoped styles and is not a page
+ if (resource.file.includes('scoped') && !resource.file.includes('pages/')) {
+ link.push({ rel: 'stylesheet', href: renderer.rendererContext.buildAssetsURL(resource.file), crossorigin: '' })
+ }
+ }
+ if (link.length) {
+ ssrContext.head.push({ link })
+ }
+ }
+
+ const islandHead: SerializableHead = {}
+ for (const entry of ssrContext.head.entries.values()) {
+ // eslint-disable-next-line @typescript-eslint/no-deprecated
+ for (const [key, value] of Object.entries(resolveUnrefHeadInput(entry.input as any) as SerializableHead)) {
+ const currentValue = islandHead[key as keyof SerializableHead]
+ if (Array.isArray(currentValue)) {
+ currentValue.push(...value)
+ } else {
+ islandHead[key as keyof SerializableHead] = value
+ }
+ }
+ }
+
+ const islandResponse: NuxtIslandResponse = {
+ id: islandContext.id,
+ head: islandHead,
+ html: getServerComponentHTML(renderResult.html),
+ components: getClientIslandResponse(ssrContext),
+ slots: getSlotIslandResponse(ssrContext),
+ }
+
+ await useNitroHooks().callHook('render:island', islandResponse, { event, islandContext })
+
+ if (import.meta.prerender) {
+ const requestUrl = islandPath + event.url.search + event.url.hash
+ await islandCache!.setItem(islandPath, islandResponse)
+ await islandPropCache!.setItem(islandPath, requestUrl)
+ }
+ return islandResponse
+})
+
+export default handler
+
+function returnIslandResponse (event: H3Event, response: Partial<RenderResponse>) {
+ for (const header in response.headers || {}) {
+ event.res.headers.set(header, response.headers![header]!)
+ }
+ if (response.status) {
+ event.res.status = response.status
+ }
+ if (response.statusText) {
+ event.res.statusText = response.statusText
+ }
+ return response.body
+}
+
+const ISLAND_PATH_PREFIX = '/__nuxt_island/'
+const VALID_COMPONENT_NAME_RE = /^[a-z][\w.-]*$/i
+
+async function getIslandContext (event: H3Event): Promise<NuxtIslandContext> {
+ let url = event.url.pathname + event.url.search + event.url.hash
+ const islandPath = event.url.pathname
+ if (import.meta.prerender && await islandPropCache!.hasItem(islandPath)) {
+ // for prerender, the original request URL (with query) is rehydrated from cache
+ // so that re-renders of the same island path use the original props
+ url = await islandPropCache!.getItem(islandPath) as string
+ }
+
+ if (!url.startsWith(ISLAND_PATH_PREFIX)) {
+ throw new HTTPError({ status: 400, statusText: 'Invalid island request path' })
+ }
+
+ const componentParts = url.substring(ISLAND_PATH_PREFIX.length).replace(ISLAND_SUFFIX_RE, '').split('_')
+ const hashId = componentParts.length > 1 ? componentParts.pop() : undefined
+ const componentName = componentParts.join('_')
+
+ if (!componentName || !VALID_COMPONENT_NAME_RE.test(componentName)) {
+ throw new HTTPError({ status: 400, statusText: 'Invalid island component name' })
+ }
+
+ const rawContext = event.req.method === 'GET' ? getQuery<NuxtIslandContext>(event) : await readBody<NuxtIslandContext>(event)
+ const rawProps = destr<Record<string, any> | null | undefined>(rawContext?.props) || {}
+ const filteredProps = filterIslandProps(rawProps)
+
+ // Reconstruct the `context` object as the client computed its hash over.
+ // `<NuxtIsland>` sends `{ ...props.context, props: JSON.stringify(props.props) }`
+ const clientContext: Record<string, any> = {}
+ if (rawContext && typeof rawContext === 'object') {
+ for (const key in rawContext) {
+ if (key !== 'props') {
+ clientContext[key] = (rawContext as Record<string, any>)[key]
+ }
+ }
+ }
+
+ // Bind the response to the URL: a request whose URL-resident `hashId` does not match
+ // the actual (name, props, context) is rejected.
+ const expectedHash = computeIslandHash(componentName, filteredProps, clientContext, undefined)
+ if (!hashId || hashId !== expectedHash) {
+ throw new HTTPError({ status: 400, statusText: 'Invalid island request hash' })
+ }
+
+ return {
+ url: typeof rawContext?.url === 'string' ? rawContext.url : '/',
+ id: hashId,
+ name: componentName,
+ props: rawProps,
+ slots: {},
+ components: {},
+ }
+}
diff --git a/packages/nitro-server/src/runtime/handlers/renderer.ts b/packages/nitro-server/src/runtime/handlers/renderer.ts
new file mode 100644
index 000000000000..1346f0f22ca8
--- /dev/null
+++ b/packages/nitro-server/src/runtime/handlers/renderer.ts
@@ -0,0 +1,389 @@
+import { AsyncLocalStorage } from 'node:async_hooks'
+import { getPrefetchLinks, getPreloadLinks, getRequestDependencies, renderResourceHeaders } from 'vue-bundle-renderer/runtime'
+import type { RenderResponse } from 'nitro/types'
+import type { H3Event } from 'nitro/h3'
+import { HTTPError, defineEventHandler, getQuery, writeEarlyHints } from 'nitro/h3'
+import { getQuery as getURLQuery, joinURL } from 'ufo'
+import { propsToString, renderSSRHead } from '@unhead/vue/server'
+import type { Link, Script } from '@unhead/vue/types'
+import destr from 'destr'
+import { getRouteRules, useNitroHooks } from 'nitro/app'
+import { relative } from 'pathe'
+
+import type { NuxtPayload, NuxtRenderHTMLContext, NuxtSSRContext } from 'nuxt/app'
+
+import { getRenderer } from '../utils/renderer/build-files'
+import { payloadCache, prerenderRenderingURLs } from '../utils/cache'
+
+import { renderPayloadJsonScript, renderPayloadResponse, splitPayload } from '../utils/renderer/payload'
+import { createSSRContext, setSSRError } from '../utils/renderer/app'
+import { renderInlineStyles } from '../utils/renderer/inline-styles'
+import { replaceIslandTeleports } from '../utils/renderer/islands'
+// @ts-expect-error virtual file
+import { renderSSRHeadOptions } from '#internal/unhead.config.mjs'
+// @ts-expect-error virtual file
+import { NUXT_ASYNC_CONTEXT, NUXT_EARLY_HINTS, NUXT_INLINE_STYLES, NUXT_NO_SCRIPTS, NUXT_PAYLOAD_EXTRACTION, NUXT_PAYLOAD_INLINE, NUXT_RUNTIME_PAYLOAD_EXTRACTION, PARSE_ERROR_DATA } from '#internal/nuxt/nitro-config.mjs'
+// @ts-expect-error virtual file
+import { appHead, appTeleportAttrs, appTeleportTag, componentIslands } from '#internal/nuxt.config.mjs'
+// @ts-expect-error virtual file
+import entryIds from '#internal/nuxt/entry-ids.mjs'
+// @ts-expect-error virtual file
+import { entryFileName } from '#internal/entry-chunk.mjs'
+import { buildAssetsURL, publicAssetsURL } from '../utils/paths'
+import type { AppConfig } from '@nuxt/schema'
+
+// @ts-expect-error private property consumed by vite-generated url helpers
+globalThis.__buildAssetsURL = buildAssetsURL
+// @ts-expect-error private property consumed by vite-generated url helpers
+globalThis.__publicAssetsURL = publicAssetsURL
+
+// Polyfill for unctx (https://github.com/unjs/unctx#native-async-context)
+if (NUXT_ASYNC_CONTEXT && !('AsyncLocalStorage' in globalThis)) {
+ (globalThis as any).AsyncLocalStorage = AsyncLocalStorage
+}
+
+const HAS_APP_TELEPORTS = !!(appTeleportTag && appTeleportAttrs.id)
+const APP_TELEPORT_OPEN_TAG = HAS_APP_TELEPORTS ? `<${appTeleportTag}${propsToString(appTeleportAttrs)}>` : ''
+const APP_TELEPORT_CLOSE_TAG = HAS_APP_TELEPORTS ? `</${appTeleportTag}>` : ''
+
+const PAYLOAD_URL_RE = /^[^?]*\/_payload.json(?:\?.*)?$/
+const PAYLOAD_FILENAME = '_payload.json'
+
+let entryPath: string
+
+const handler: ReturnType<typeof defineEventHandler> = defineEventHandler((event) => {
+ // Whether we're rendering an error page
+ const ssrError = event.url.pathname.startsWith('/__nuxt_error')
+ ? getQuery<NuxtPayload['error'] & { url: string }>(event)
+ : null
+
+ if (ssrError && !event.context.nuxt?.['~internal'] /* allow internal fetch */) {
+ throw new HTTPError({
+ status: 404,
+ statusText: 'Page Not Found: /__nuxt_error',
+ })
+ }
+
+ // During prerender, refuse to recurse into a URL that is already rendering
+ // higher in the same call chain. Without this, a `useFetch`/`$fetch` against
+ // the in-flight URL (typically from route middleware) silently deadlocks the
+ // build. See https://github.com/nuxt/nuxt/issues/33871.
+ if (import.meta.prerender && prerenderRenderingURLs) {
+ const renderingURL = event.url.pathname + event.url.search
+ const stack = prerenderRenderingURLs.getStore()
+ if (stack?.includes(renderingURL)) {
+ const chain = [...stack, renderingURL].filter(url => !url.startsWith('/__nuxt_error')).map(url => `"${url}"`).join(' -> ')
+ throw new HTTPError({
+ status: 508,
+ statusText: `Loop detected while prerendering "${renderingURL}" (${chain}). Check for \`useFetch\`/\`$fetch\` calls targeting a URL that is currently being rendered.`,
+ })
+ }
+ return prerenderRenderingURLs.run([...(stack || []), renderingURL], () => renderRoute(event, ssrError))
+ }
+
+ return renderRoute(event, ssrError)
+})
+
+async function renderRoute (event: H3Event, ssrError: (NuxtPayload['error'] & { url: string }) | null) {
+ // Initialize ssr context
+ const ssrContext: NuxtSSRContext = createSSRContext(event)
+
+ ssrContext.head.push(appHead)
+
+ if (ssrError) {
+ // @ts-expect-error TODO: investigate creating new error
+ ssrError.status &&= Number.parseInt(ssrError.status.toString())
+ if (PARSE_ERROR_DATA && typeof ssrError.data === 'string') {
+ try {
+ // @ts-expect-error TODO: investigate creating new error
+ ssrError.data = destr(ssrError.data)
+ } catch {
+ // ignore
+ }
+ }
+ setSSRError(ssrContext, ssrError)
+ }
+
+ // Get route options (for `ssr: false`, `isr`, `cache` and `noScripts`)
+ const routeOptions = getRouteRules(event.req.method, event.url.pathname).routeRules || {}
+
+ if (!routeOptions?.ssr) {
+ ssrContext.noSSR = true
+ }
+
+ // Whether we are prerendering route or using ISR/SWR caching
+ const _PAYLOAD_EXTRACTION = !ssrContext.noSSR && (
+ (import.meta.prerender && NUXT_PAYLOAD_EXTRACTION)
+ || (NUXT_RUNTIME_PAYLOAD_EXTRACTION && (routeOptions.isr || routeOptions.cache))
+ )
+
+ // When NUXT_PAYLOAD_INLINE is true (payloadExtraction: 'client'), we inline the full payload
+ const _PAYLOAD_INLINE = !_PAYLOAD_EXTRACTION || NUXT_PAYLOAD_INLINE
+
+ const isRenderingPayload = (_PAYLOAD_EXTRACTION || (import.meta.dev && routeOptions.prerender)) && PAYLOAD_URL_RE.test(ssrContext.url)
+ if (isRenderingPayload) {
+ const url = ssrContext.url.substring(0, ssrContext.url.lastIndexOf('/')) || '/'
+ ssrContext.url = url
+
+ if (import.meta.prerender && await payloadCache!.hasItem(url + '.json')) {
+ return returnResponse(event, await payloadCache!.getItem(url + '.json') as Partial<RenderResponse>)
+ }
+ }
+
+ const payloadURL = _PAYLOAD_EXTRACTION ? joinURL(ssrContext.runtimeConfig.app.cdnURL || ssrContext.runtimeConfig.app.baseURL, ssrContext.url.replace(/\?.*$/, ''), PAYLOAD_FILENAME) + '?' + ssrContext.runtimeConfig.app.buildId : undefined
+
+ // Render app
+ const renderer = await getRenderer(ssrContext)
+
+ // Render 103 Early Hints
+ if (NUXT_EARLY_HINTS && !isRenderingPayload && !import.meta.prerender) {
+ const { link } = renderResourceHeaders({}, renderer.rendererContext)
+ if (link) {
+ writeEarlyHints(event, { link })
+ }
+ }
+
+ if (NUXT_INLINE_STYLES) {
+ for (const id of entryIds) {
+ ssrContext.modules!.add(id)
+ }
+ }
+
+ const _rendered = await renderer.renderToString(ssrContext).catch(async (error) => {
+ // We use error to bypass full render if we have an early response we can make
+ if (ssrContext['~renderResponse'] && error.message === 'skipping render') { return {} as ReturnType<typeof renderer['renderToString']> }
+
+ // Use explicitly thrown error in preference to subsequent rendering errors
+ const _err = (!ssrError && ssrContext.payload?.error) || error
+ await ssrContext.nuxt?.hooks.callHook('app:error', _err)
+ throw _err
+ })
+
+ // Render inline styles
+ const inlinedStyles = NUXT_INLINE_STYLES && !ssrContext['~renderResponse'] && !isRenderingPayload
+ ? await renderInlineStyles(ssrContext.modules ?? [])
+ : []
+
+ await ssrContext.nuxt?.hooks.callHook('app:rendered', { ssrContext, renderResult: _rendered })
+
+ if (ssrContext['~renderResponse']) {
+ return returnResponse(event, ssrContext['~renderResponse'])
+ }
+
+ // Handle errors
+ if (ssrContext.payload?.error && !ssrError) {
+ throw ssrContext.payload.error
+ }
+
+ // Directly render payload routes
+ if (isRenderingPayload) {
+ const response = renderPayloadResponse(ssrContext)
+ if (import.meta.prerender) {
+ await payloadCache!.setItem(ssrContext.url + '.json', response)
+ }
+
+ return returnResponse(event, response)
+ }
+
+ if (_PAYLOAD_EXTRACTION && import.meta.prerender) {
+ // Hint nitro to prerender payload for this route
+ event.res.headers.append('x-nitro-prerender', joinURL(ssrContext.url.replace(/\?.*$/, ''), PAYLOAD_FILENAME))
+ // Use same ssr context to generate payload for this route
+ await payloadCache!.setItem((ssrContext.url === '/' ? '/' : ssrContext.url.replace(/\/$/, '')) + '.json', renderPayloadResponse(ssrContext))
+ }
+
+ const NO_SCRIPTS = NUXT_NO_SCRIPTS || !!routeOptions?.noScripts
+
+ // Setup head
+ const { styles, scripts } = getRequestDependencies(ssrContext, renderer.rendererContext)
+
+ // 0. Add import map for stable chunk hashes
+ if (entryFileName && !NO_SCRIPTS) {
+ let path = entryPath
+ if (!path) {
+ path = buildAssetsURL(entryFileName) as string
+ if (ssrContext.runtimeConfig.app.cdnURL || /^(?:\/|\.+\/)/.test(path)) {
+ // cache absolute entry path
+ entryPath = path
+ } else {
+ // TODO: provide support for relative paths in assets as well
+ // relativise path
+ path = relative(event.url.pathname.replace(/\/[^/]+$/, '/'), joinURL('/', path))
+ if (!/^(?:\/|\.+\/)/.test(path)) {
+ path = `./${path}`
+ }
+ }
+ }
+ ssrContext.head.push({
+ script: [{
+ type: 'importmap',
+ // unhead v3 JSON-stringifies object innerHTML for <script> tags
+ innerHTML: { imports: { '#entry': path } },
+ }],
+ })
+ }
+ // 1. Preload payloads and app manifest
+ // Skip preload when inlining full payload in HTML (no separate fetch needed for initial load)
+ if (_PAYLOAD_EXTRACTION && !_PAYLOAD_INLINE && !NO_SCRIPTS) {
+ ssrContext.head.push({
+ link: [
+ { rel: 'preload', as: 'fetch', crossorigin: 'anonymous', href: payloadURL },
+ ],
+ })
+ }
+
+ // 2. Styles
+ if (inlinedStyles.length) {
+ ssrContext.head.push({ style: inlinedStyles })
+ }
+
+ const link: Link[] = []
+ for (const resource of Object.values(styles)) {
+ // Do not add links to resources that are inlined (vite v5+)
+ if (import.meta.dev && 'inline' in getURLQuery(resource.file)) {
+ continue
+ }
+ // Add CSS links in <head> for CSS files
+ // - in production
+ // - in dev mode when not rendering an island
+ link.push({ rel: 'stylesheet', href: renderer.rendererContext.buildAssetsURL(resource.file), crossorigin: '' })
+ }
+
+ if (link.length) {
+ ssrContext.head.push({ link })
+ }
+
+ if (!NO_SCRIPTS) {
+ // 4. Resource Hints
+ // Remove lazy hydrated modules from ssrContext.modules so they don't get preloaded
+ // (CSS links are already added above, this only affects JS preloads)
+ if (ssrContext['~lazyHydratedModules']) {
+ for (const id of ssrContext['~lazyHydratedModules']) {
+ ssrContext.modules?.delete(id)
+ }
+ }
+ ssrContext.head.push({
+ link: getPreloadLinks(ssrContext, renderer.rendererContext) as Link[],
+ })
+ ssrContext.head.push({
+ link: getPrefetchLinks(ssrContext, renderer.rendererContext) as Link[],
+ })
+ // 5. Payloads
+ ssrContext.head.push({
+ script: _PAYLOAD_INLINE
+ // Inline full payload in HTML (payloadExtraction: 'client' | false, or non-cached route)
+ // `prefetchLinks` is only consumed when *another* page prefetches this URL via
+ // _payload.json, so we drop it from the inline payload to avoid the duplication.
+ ? renderPayloadJsonScript({ ssrContext, data: stripInlineOnlyPayloadFields(ssrContext.payload) })
+ // Split payload: inline initial data, reference external _payload.json via src (payloadExtraction: true)
+ : renderPayloadJsonScript({ ssrContext, data: splitPayload(ssrContext).initial, src: payloadURL }),
+ }, {
+ // this should come before another end of body scripts
+ tagPosition: 'bodyClose',
+ tagPriority: 'high',
+ })
+ }
+
+ // 6. Scripts
+ if (!NO_SCRIPTS) {
+ ssrContext.head.push({
+ script: Object.values(scripts).map(resource => (<Script> {
+ type: resource.module ? 'module' : null,
+ src: renderer.rendererContext.buildAssetsURL(resource.file),
+ defer: resource.module ? null : true,
+ // if we are rendering script tag payloads that import an async payload
+ // we need to ensure this resolves before executing the Nuxt entry
+ tagPosition: 'head',
+ crossorigin: '',
+ })),
+ })
+ }
+
+ // TODO: migrate to `ssrContext.head.render()` once `renderSSRHeadOptions` (e.g. `omitLineBreaks`) can be passed to `createServerHead` at construction time.
+ // eslint-disable-next-line @typescript-eslint/no-deprecated
+ const { headTags, bodyTags, bodyTagsOpen, htmlAttrs, bodyAttrs } = renderSSRHead(ssrContext.head, renderSSRHeadOptions)
+
+ // Create render context
+ const htmlContext: NuxtRenderHTMLContext = {
+ htmlAttrs: htmlAttrs ? [htmlAttrs] : [],
+ head: normalizeChunks([headTags]),
+ bodyAttrs: bodyAttrs ? [bodyAttrs] : [],
+ bodyPrepend: normalizeChunks([bodyTagsOpen, ssrContext.teleports?.body]),
+ body: [
+ componentIslands ? replaceIslandTeleports(ssrContext, _rendered.html) : _rendered.html,
+ APP_TELEPORT_OPEN_TAG + (HAS_APP_TELEPORTS ? joinTags([ssrContext.teleports?.[`#${appTeleportAttrs.id}`]]) : '') + APP_TELEPORT_CLOSE_TAG,
+ ],
+ bodyAppend: [bodyTags],
+ }
+
+ // Allow hooking into the rendered result
+ await useNitroHooks().callHook('render:html', htmlContext, { event })
+
+ event.res.headers.set('content-type', 'text/html;charset=utf-8')
+ event.res.headers.set('x-powered-by', 'Nuxt')
+
+ return renderHTMLDocument(htmlContext)
+}
+
+export default handler
+
+function normalizeChunks (chunks: (string | undefined)[]) {
+ const result: string[] = []
+ for (const _chunk of chunks) {
+ const chunk = _chunk?.trim()
+ if (chunk) {
+ result.push(chunk)
+ }
+ }
+ return result
+}
+
+function joinTags (tags: Array<string | undefined>) {
+ return tags.join('')
+}
+
+function joinAttrs (chunks: string[]) {
+ if (chunks.length === 0) { return '' }
+ return ' ' + chunks.join(' ')
+}
+
+function renderHTMLDocument (html: NuxtRenderHTMLContext) {
+ return '<!DOCTYPE html>' +
+ `<html${joinAttrs(html.htmlAttrs)}>` +
+ `<head>${joinTags(html.head)}</head>` +
+ `<body${joinAttrs(html.bodyAttrs)}>${joinTags(html.bodyPrepend)}${joinTags(html.body)}${joinTags(html.bodyAppend)}</body>` +
+ '</html>'
+}
+
+declare module 'srvx' {
+ interface ServerRequestContext {
+ nuxt?: {
+ 'appConfig'?: AppConfig
+ 'noSSR'?: boolean
+ /** @internal */
+ '~internal'?: boolean
+ /** @internal */
+ '~rendering-error'?: boolean
+ }
+ }
+}
+
+function stripInlineOnlyPayloadFields (payload: NuxtSSRContext['payload']): NuxtSSRContext['payload'] {
+ if (!payload.prefetchLinks) { return payload }
+ const { prefetchLinks: _, ...rest } = payload
+ return rest
+}
+
+function returnResponse (event: H3Event, response: Partial<RenderResponse>) {
+ for (const header in response.headers || {}) {
+ event.res.headers.set(header, response.headers![header]!)
+ }
+ if (response.status) {
+ event.res.status = response.status
+ }
+ if (response.statusText) {
+ event.res.statusText = response.statusText
+ }
+
+ return response.body
+}
diff --git a/packages/nitro-server/src/runtime/middleware/base-url.ts b/packages/nitro-server/src/runtime/middleware/base-url.ts
new file mode 100644
index 000000000000..fbdc198db1be
--- /dev/null
+++ b/packages/nitro-server/src/runtime/middleware/base-url.ts
@@ -0,0 +1,32 @@
+import { HTTPError, defineEventHandler } from 'nitro/h3'
+import { useRuntimeConfig } from 'nitro/runtime-config'
+import { serverFetch } from 'nitro'
+
+const config = useRuntimeConfig()
+const baseURL = config.app.baseURL?.replace(/\/$/, '') || '/'
+const hasBaseURL = baseURL !== '/' && !/^\.(?:$|\/)/.test(baseURL)
+
+const handler: ReturnType<typeof defineEventHandler> = defineEventHandler((event) => {
+ if (!hasBaseURL) {
+ return
+ }
+
+ // avoid processing the same request more than once (detect internal fetches)
+ if (event.context.nuxt?.['~internal']) {
+ return
+ }
+
+ if (event.url.pathname === baseURL || event.url.pathname.startsWith(baseURL + '/')) {
+ const newURL = (event.url.pathname.slice(baseURL.length) || '/') + event.url.search + event.url.hash
+
+ return serverFetch(newURL, event.req, {
+ nuxt: {
+ '~internal': true,
+ },
+ })
+ }
+
+ throw new HTTPError({ status: 404, statusText: `Page not found.` })
+})
+
+export default handler
diff --git a/packages/nitro-server/src/runtime/middleware/no-ssr.ts b/packages/nitro-server/src/runtime/middleware/no-ssr.ts
new file mode 100644
index 000000000000..07734933f571
--- /dev/null
+++ b/packages/nitro-server/src/runtime/middleware/no-ssr.ts
@@ -0,0 +1,10 @@
+import { defineEventHandler } from 'nitro/h3'
+
+const handler: ReturnType<typeof defineEventHandler> = defineEventHandler((event) => {
+ if (event.req.headers.get('x-nuxt-no-ssr')) {
+ event.context.nuxt ||= {}
+ event.context.nuxt.noSSR = true
+ }
+})
+
+export default handler
diff --git a/packages/nitro-server/src/runtime/plugins/dev-server-logs.ts b/packages/nitro-server/src/runtime/plugins/dev-server-logs.ts
new file mode 100644
index 000000000000..89411a3337a9
--- /dev/null
+++ b/packages/nitro-server/src/runtime/plugins/dev-server-logs.ts
@@ -0,0 +1,110 @@
+import { AsyncLocalStorage } from 'node:async_hooks'
+import type { LogObject } from 'consola'
+import { consola } from 'consola'
+import { stringify } from 'devalue'
+import { withTrailingSlash } from 'ufo'
+import { toRequest } from 'nitro/h3'
+import { definePlugin } from 'nitro'
+import { useNitroHooks } from 'nitro/app'
+import { getContext } from 'unctx'
+import type { ServerRequest } from 'srvx'
+import { captureRawStackTrace, parseRawStackTrace } from 'errx'
+import type { ParsedTrace } from 'errx'
+
+import { isVNode } from 'vue'
+
+// @ts-expect-error virtual file
+import { rootDir } from '#internal/dev-server-logs-options'
+// @ts-expect-error virtual file
+import { appId } from '#internal/nuxt.config.mjs'
+
+const devReducers: Record<string, (data: any) => any> = {
+ VNode: data => isVNode(data) ? { type: data.type, props: data.props } : undefined,
+ URL: data => data instanceof URL ? data.toString() : undefined,
+ Symbol: data => typeof data === 'symbol' ? data.description ?? '' : undefined,
+}
+
+interface NuxtDevAsyncContext {
+ logs: LogObject[]
+ request: ServerRequest
+}
+
+const asyncContext = getContext<NuxtDevAsyncContext>('nuxt-dev', { asyncContext: true, AsyncLocalStorage })
+
+const plugin: ReturnType<typeof definePlugin> = definePlugin((nitroApp) => {
+ // TODO: Use nitro asyncContext
+ const originalFetch = nitroApp.fetch
+ nitroApp.fetch = (input: ServerRequest | URL | string, init?: RequestInit, context?: any) => {
+ const req = toRequest(input, init)
+ req.context = { ...req.context, ...context }
+ return asyncContext.callAsync({ logs: [], request: req }, () => originalFetch(req))
+ }
+
+ onConsoleLog((_log) => {
+ const ctx = asyncContext.tryUse()
+ if (!ctx) { return }
+
+ const rawStack = captureRawStackTrace()
+ if (!rawStack || rawStack.includes('runtime/vite-node.mjs')) { return }
+
+ const trace: ParsedTrace[] = []
+ let filename = ''
+ for (const entry of parseRawStackTrace(rawStack)) {
+ if (entry.source === import.meta.url) { continue }
+ if (EXCLUDE_TRACE_RE.test(entry.source)) { continue }
+
+ filename ||= entry.source.replace(withTrailingSlash(rootDir), '')
+ trace.push({
+ ...entry,
+ source: entry.source.startsWith('file://') ? entry.source.replace('file://', '') : entry.source,
+ })
+ }
+
+ const log = {
+ ..._log,
+ // Pass along filename to allow the client to display more info about where log comes from
+ filename,
+ // Clean up file names in stack trace
+ stack: trace,
+ }
+
+ // retain log to be include in the next render
+ ctx.logs.push(log)
+ })
+
+ const nitroHooks = useNitroHooks()
+
+ nitroHooks.hook('response', () => {
+ const ctx = asyncContext.tryUse()
+ if (!ctx) { return }
+ const url = new URL(ctx.request.url)
+ const path = url.pathname + url.search + url.hash
+ return nitroHooks.callHook('dev:ssr-logs', { logs: ctx.logs, path })
+ })
+
+ // Pass any logs to the client
+ nitroHooks.hook('render:html', (htmlContext) => {
+ const ctx = asyncContext.tryUse()
+ if (!ctx) { return }
+ try {
+ const reducers = Object.assign(Object.create(null), devReducers, ctx.request.context?.['~payloadReducers'])
+ htmlContext.bodyAppend.unshift(`<script type="application/json" data-nuxt-logs="${appId}">${stringify(ctx.logs, reducers)}</script>`)
+ } catch (e) {
+ const shortError = e instanceof Error && 'toString' in e ? ` Received \`${e.toString()}\`.` : ''
+ console.warn(`[nuxt] Failed to stringify dev server logs.${shortError} You can define your own reducer/reviver for rich types following the instructions in https://nuxt.com/docs/4.x/api/composables/use-nuxt-app#payload.`)
+ }
+ })
+})
+
+export default plugin
+
+const EXCLUDE_TRACE_RE = /\/node_modules\/(?:.*\/)?(?:nuxt|nuxt-nightly|nuxt-edge|nuxt3|consola|@vue)\/|core\/runtime\/nitro/
+
+function onConsoleLog (callback: (log: LogObject) => void) {
+ consola.addReporter({
+ log (logObj) {
+ callback(logObj)
+ },
+ })
+ consola.wrapConsole()
+}
diff --git a/packages/nitro-server/src/runtime/utils/app-config.ts b/packages/nitro-server/src/runtime/utils/app-config.ts
new file mode 100644
index 000000000000..6b6042e3ff2f
--- /dev/null
+++ b/packages/nitro-server/src/runtime/utils/app-config.ts
@@ -0,0 +1,37 @@
+import type { H3Event } from 'nitro/h3'
+import { klona } from 'klona'
+import type { AppConfig } from '@nuxt/schema'
+
+// @ts-expect-error virtual file
+import _inlineAppConfig from '#internal/nuxt/app-config'
+
+// App config
+const _sharedAppConfig = _deepFreeze(klona(_inlineAppConfig)) as AppConfig
+export function useAppConfig (event?: H3Event): AppConfig {
+ // Backwards compatibility with ambient context
+ if (!event) {
+ return _sharedAppConfig
+ }
+ event.context.nuxt ||= {}
+ // Reuse cached app config from event context
+ if (event.context.nuxt.appConfig) {
+ return event.context.nuxt.appConfig
+ }
+ // Prepare app config for event context
+ const appConfig = klona(_inlineAppConfig)
+ event.context.nuxt.appConfig = appConfig
+ return appConfig
+}
+
+// --- Utils ---
+
+function _deepFreeze (object: Record<string, any>) {
+ const propNames = Object.getOwnPropertyNames(object)
+ for (const name of propNames) {
+ const value = object[name]
+ if (value && typeof value === 'object') {
+ _deepFreeze(value)
+ }
+ }
+ return Object.freeze(object)
+}
diff --git a/packages/nitro-server/src/runtime/utils/cache-driver.js b/packages/nitro-server/src/runtime/utils/cache-driver.js
new file mode 100644
index 000000000000..58b2cb5eab8f
--- /dev/null
+++ b/packages/nitro-server/src/runtime/utils/cache-driver.js
@@ -0,0 +1,38 @@
+// @ts-check
+
+import crypto from 'node:crypto'
+import fsDriver from 'unstorage/drivers/fs-lite'
+import lruCache from 'unstorage/drivers/lru-cache'
+
+/**
+ * @param {string} item
+ */
+function normalizeFsKey (item) {
+ const safe = item.replace(/[^\w.-]/g, '_')
+ const prefix = safe.slice(0, 20)
+ const hash = crypto.createHash('sha256').update(item).digest('hex')
+ return `${prefix}-${hash}`
+}
+
+/**
+ * @param {{ base?: string }} opts
+ * @returns {import('unstorage').Driver} An unstorage driver that uses both LRU cache and file system, with LRU as the primary and file system as the fallback.
+ */
+export default function cacheDriver (opts) {
+ const fs = fsDriver({ base: opts.base })
+ const lru = lruCache({ max: 1000 })
+
+ return {
+ ...fs, // fall back to file system - only the bottom three methods are used in renderer
+ async setItem (key, value, opts) {
+ await fs.setItem?.(normalizeFsKey(key), value, opts)
+ await lru.setItem?.(key, value, opts)
+ },
+ async hasItem (key, opts) {
+ return await lru.hasItem(key, opts) || await fs.hasItem(normalizeFsKey(key), opts)
+ },
+ async getItem (key, opts) {
+ return await lru.getItem(key, opts) || await fs.getItem(normalizeFsKey(key), opts)
+ },
+ }
+}
diff --git a/packages/nitro-server/src/runtime/utils/cache.ts b/packages/nitro-server/src/runtime/utils/cache.ts
new file mode 100644
index 000000000000..315d433c49c7
--- /dev/null
+++ b/packages/nitro-server/src/runtime/utils/cache.ts
@@ -0,0 +1,63 @@
+import { AsyncLocalStorage } from 'node:async_hooks'
+import type { Storage, StorageValue } from 'unstorage'
+import { useStorage } from 'nitro/storage'
+// @ts-expect-error virtual file
+import { NUXT_RUNTIME_PAYLOAD_EXTRACTION, NUXT_SHARED_DATA } from '#internal/nuxt/nitro-config.mjs'
+
+/**
+ * Stack of URLs currently rendering in the active async context (oldest first).
+ * A repeated entry signals a render cycle.
+ */
+export const prerenderRenderingURLs: AsyncLocalStorage<readonly string[]> | null = import.meta.prerender ? new AsyncLocalStorage() : null
+
+export const payloadCache: Storage | null = import.meta.prerender
+ ? useStorage<StorageValue>('internal:nuxt:prerender:payload')
+ : NUXT_RUNTIME_PAYLOAD_EXTRACTION
+ ? useStorage<StorageValue>('cache:nuxt:payload')
+ : null
+export const islandCache: Storage | null = import.meta.prerender ? useStorage<StorageValue>('internal:nuxt:prerender:island') : null
+export const islandPropCache: Storage | null = import.meta.prerender ? useStorage<StorageValue>('internal:nuxt:prerender:island-props') : null
+export const sharedPrerenderPromises: Map<string, Promise<any>> | null = import.meta.prerender && NUXT_SHARED_DATA ? new Map<string, Promise<any>>() : null
+
+const sharedPrerenderKeys = new Set<string>()
+// Render chain in flight when each pending shared promise was inserted,
+// used to detect cyclic awaits in `get()`.
+const sharedPrerenderChains: Map<string, readonly string[]> | null = import.meta.prerender && NUXT_SHARED_DATA ? new Map() : null
+
+interface SharedPrerenderCache {
+ get<T = unknown>(key: string): Promise<T> | undefined
+ set<T>(key: string, value: Promise<T>): Promise<void>
+}
+
+export const sharedPrerenderCache: SharedPrerenderCache | null = import.meta.prerender && NUXT_SHARED_DATA
+ ? {
+ get<T = unknown> (key: string): Promise<T> | undefined {
+ if (!sharedPrerenderKeys.has(key)) { return }
+
+ // Skip a pending entry whose render chain overlaps the caller's.
+ const currentChain = prerenderRenderingURLs?.getStore()
+ const setChain = sharedPrerenderChains?.get(key)
+ if (currentChain?.length && setChain?.length && setChain.some(url => currentChain.includes(url))) {
+ return
+ }
+ return sharedPrerenderPromises!.get(key) ?? useStorage('internal:nuxt:prerender:shared').getItem(key) as Promise<T>
+ },
+ async set<T> (key: string, value: Promise<T>): Promise<void> {
+ sharedPrerenderKeys.add(key)
+ sharedPrerenderPromises!.set(key, value)
+ const chain = prerenderRenderingURLs?.getStore()
+ if (chain?.length) {
+ sharedPrerenderChains!.set(key, chain)
+ }
+ try {
+ const resolved = await value
+ await useStorage('internal:nuxt:prerender:shared').setItem(key, resolved as any)
+ } catch {
+ // Rejections propagate through the original promise; only resolved values are persisted.
+ } finally {
+ sharedPrerenderPromises!.delete(key)
+ sharedPrerenderChains?.delete(key)
+ }
+ },
+ }
+ : null
diff --git a/packages/nitro-server/src/runtime/utils/config.ts b/packages/nitro-server/src/runtime/utils/config.ts
new file mode 100644
index 000000000000..e81a77a2b5e0
--- /dev/null
+++ b/packages/nitro-server/src/runtime/utils/config.ts
@@ -0,0 +1 @@
+export const defineAppConfig = (config: any): any => config
diff --git a/packages/nitro-server/src/runtime/utils/dev.ts b/packages/nitro-server/src/runtime/utils/dev.ts
new file mode 100644
index 000000000000..2098d886f297
--- /dev/null
+++ b/packages/nitro-server/src/runtime/utils/dev.ts
@@ -0,0 +1,989 @@
+const iframeStorageBridge = (nonce: string) => /* js */ `
+(function () {
+ const NONCE = ${JSON.stringify(nonce)};
+ const memoryStore = Object.create(null);
+
+ const post = (type, payload) => {
+ window.parent.postMessage({ type, nonce: NONCE, ...payload }, '*');
+ };
+
+ const isValid = (data) => data && data.nonce === NONCE;
+
+ const mockStorage = {
+ getItem(key) {
+ return Object.hasOwn(memoryStore, key)
+ ? memoryStore[key]
+ : null;
+ },
+ setItem(key, value) {
+ const v = String(value);
+ memoryStore[key] = v;
+ post('storage-set', { key, value: v });
+ },
+ removeItem(key) {
+ delete memoryStore[key];
+ post('storage-remove', { key });
+ },
+ clear() {
+ for (const key of Object.keys(memoryStore))
+ delete memoryStore[key];
+ post('storage-clear', {});
+ },
+ key(index) {
+ const keys = Object.keys(memoryStore);
+ return keys[index] ?? null;
+ },
+ get length() {
+ return Object.keys(memoryStore).length;
+ }
+ };
+
+ const defineLocalStorage = () => {
+ try {
+ Object.defineProperty(window, 'localStorage', {
+ value: mockStorage,
+ writable: false,
+ configurable: true
+ });
+ } catch {
+ window.localStorage = mockStorage;
+ }
+ };
+
+ defineLocalStorage();
+
+ window.addEventListener('message', (event) => {
+ const data = event.data;
+ if (!isValid(data) || data.type !== 'storage-sync-data') return;
+
+ const incoming = data.data || {};
+ for (const key of Object.keys(incoming))
+ memoryStore[key] = incoming[key];
+
+ if (typeof window.initTheme === 'function')
+ window.initTheme();
+ window.dispatchEvent(new Event('storage-ready'));
+ });
+
+ // Clipboard API is unavailable in data: URL iframe, so we use postMessage
+ document.addEventListener('DOMContentLoaded', function() {
+ window.copyErrorMessage = function(button) {
+ post('clipboard-copy', { text: button.dataset.errorText });
+ button.classList.add('copied');
+ setTimeout(function() { button.classList.remove('copied'); }, 2000);
+ };
+ });
+
+ post('storage-sync-request', {});
+})();
+`
+
+const parentStorageBridge = (nonce: string) => /* js */ `
+(function () {
+ const host = document.querySelector('nuxt-error-overlay');
+ if (!host) return;
+
+ const NONCE = ${JSON.stringify(nonce)};
+ const isValid = (data) => data && data.nonce === NONCE;
+
+ // Handle clipboard copy from iframe
+ window.addEventListener('message', function(e) {
+ if (isValid(e.data) && e.data.type === 'clipboard-copy') {
+ navigator.clipboard.writeText(e.data.text).catch(function() {});
+ }
+ });
+
+ const collectLocalStorage = () => {
+ const all = {};
+ for (let i = 0; i < localStorage.length; i++) {
+ const k = localStorage.key(i);
+ if (k != null) all[k] = localStorage.getItem(k);
+ }
+ return all;
+ };
+
+ const attachWhenReady = () => {
+ const root = host.shadowRoot;
+ if (!root)
+ return false;
+ const iframe = root.getElementById('frame');
+ if (!iframe || !iframe.contentWindow)
+ return false;
+
+ const handlers = {
+ 'storage-set': (d) => localStorage.setItem(d.key, d.value),
+ 'storage-remove': (d) => localStorage.removeItem(d.key),
+ 'storage-clear': () => localStorage.clear(),
+ 'storage-sync-request': () => {
+ iframe.contentWindow.postMessage({
+ type: 'storage-sync-data',
+ data: collectLocalStorage(),
+ nonce: NONCE
+ }, '*');
+ }
+ };
+
+ window.addEventListener('message', (event) => {
+ const data = event.data;
+ if (!isValid(data)) return;
+ const fn = handlers[data.type];
+ if (fn) fn(data);
+ });
+
+ return true;
+ };
+
+ if (attachWhenReady())
+ return;
+
+ const obs = new MutationObserver(() => {
+ if (attachWhenReady())
+ obs.disconnect();
+ });
+
+ obs.observe(host, { childList: true, subtree: true });
+})();
+`
+
+const errorCSS = /* css */ `
+:host {
+ --preview-width: 240px;
+ --preview-height: 180px;
+ --base-width: 1200px;
+ --base-height: 900px;
+ --z-base: 999999998;
+ --error-pip-left: auto;
+ --error-pip-top: auto;
+ --error-pip-right: 5px;
+ --error-pip-bottom: 5px;
+ --error-pip-origin: bottom right;
+ --app-preview-left: auto;
+ --app-preview-top: auto;
+ --app-preview-right: 5px;
+ --app-preview-bottom: 5px;
+ all: initial;
+ display: contents;
+}
+.sr-only {
+ position: absolute;
+ width: 1px;
+ height: 1px;
+ padding: 0;
+ margin: -1px;
+ overflow: hidden;
+ clip: rect(0, 0, 0, 0);
+ white-space: nowrap;
+ border-width: 0;
+}
+#frame {
+ position: fixed;
+ left: 0;
+ top: 0;
+ width: 100vw;
+ height: 100vh;
+ border: none;
+ z-index: var(--z-base);
+}
+#frame[inert] {
+ left: var(--error-pip-left);
+ top: var(--error-pip-top);
+ right: var(--error-pip-right);
+ bottom: var(--error-pip-bottom);
+ width: var(--base-width);
+ height: var(--base-height);
+ transform: scale(calc(240 / 1200));
+ transform-origin: var(--error-pip-origin);
+ overflow: hidden;
+ border-radius: calc(1200 * 8px / 240);
+}
+#preview {
+ position: fixed;
+ left: var(--app-preview-left);
+ top: var(--app-preview-top);
+ right: var(--app-preview-right);
+ bottom: var(--app-preview-bottom);
+ width: var(--preview-width);
+ height: var(--preview-height);
+ overflow: hidden;
+ border-radius: 6px;
+ pointer-events: none;
+ z-index: var(--z-base);
+ background: white;
+ display: none;
+}
+#preview iframe {
+ transform-origin: var(--error-pip-origin);
+}
+#frame:not([inert]) + #preview {
+ display: block;
+}
+#toggle {
+ position: fixed;
+ left: var(--app-preview-left);
+ top: var(--app-preview-top);
+ right: calc(var(--app-preview-right) - 3px);
+ bottom: calc(var(--app-preview-bottom) - 3px);
+ width: var(--preview-width);
+ height: var(--preview-height);
+ background: none;
+ border: 3px solid #00DC82;
+ border-radius: 8px;
+ cursor: pointer;
+ opacity: 0.8;
+ transition: opacity 0.2s, box-shadow 0.2s;
+ z-index: calc(var(--z-base) + 1);
+ display: flex;
+ align-items: center;
+ justify-content: center;
+}
+#toggle:hover,
+#toggle:focus {
+ opacity: 1;
+ box-shadow: 0 0 20px rgba(0, 220, 130, 0.6);
+}
+#toggle:focus-visible {
+ outline: 3px solid #00DC82;
+ outline-offset: 0;
+ box-shadow: 0 0 24px rgba(0, 220, 130, 0.8);
+}
+#frame[inert] ~ #toggle {
+ left: var(--error-pip-left);
+ top: var(--error-pip-top);
+ right: calc(var(--error-pip-right) - 3px);
+ bottom: calc(var(--error-pip-bottom) - 3px);
+ cursor: grab;
+}
+:host(.dragging) #frame[inert] ~ #toggle {
+ cursor: grabbing;
+}
+#frame:not([inert]) ~ #toggle,
+#frame:not([inert]) + #preview {
+ cursor: grab;
+}
+:host(.dragging-preview) #frame:not([inert]) ~ #toggle,
+:host(.dragging-preview) #frame:not([inert]) + #preview {
+ cursor: grabbing;
+}
+
+#pip-close {
+ position: absolute;
+ top: 6px;
+ right: 6px;
+ width: 24px;
+ height: 24px;
+ border-radius: 50%;
+ border: none;
+ background: rgba(0, 0, 0, 0.75);
+ color: #fff;
+ font-size: 16px;
+ line-height: 1;
+ display: inline-flex;
+ align-items: center;
+ justify-content: center;
+ cursor: pointer;
+ box-shadow: 0 2px 8px rgba(0, 0, 0, 0.3);
+ pointer-events: auto;
+}
+#pip-close:focus-visible {
+ outline: 2px solid #00DC82;
+ outline-offset: 2px;
+}
+
+#pip-restore {
+ position: fixed;
+ right: 16px;
+ bottom: 16px;
+ padding: 8px 14px;
+ border-radius: 999px;
+ border: 2px solid #00DC82;
+ background: #111;
+ color: #fff;
+ font-family: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', sans-serif;
+ font-size: 14px;
+ display: inline-flex;
+ align-items: center;
+ gap: 6px;
+ z-index: calc(var(--z-base) + 2);
+ cursor: grab;
+}
+#pip-restore:focus-visible {
+ outline: 2px solid #00DC82;
+ outline-offset: 2px;
+}
+:host(.dragging-restore) #pip-restore {
+ cursor: grabbing;
+}
+
+#frame[hidden],
+#toggle[hidden],
+#preview[hidden],
+#pip-restore[hidden],
+#pip-close[hidden] {
+ display: none !important;
+}
+
+@media (prefers-reduced-motion: reduce) {
+ #toggle {
+ transition: none;
+ }
+}
+`
+
+function webComponentScript (base64HTML: string, startMinimized: boolean) {
+ return /* js */ `
+(function () {
+ try {
+ // =========================
+ // Host + Shadow
+ // =========================
+ const host = document.querySelector('nuxt-error-overlay');
+ if (!host)
+ return;
+ const shadow = host.attachShadow({ mode: 'open' });
+
+ // =========================
+ // DOM helpers
+ // =========================
+ const el = (tag) => document.createElement(tag);
+ const on = (node, type, fn, opts) => node.addEventListener(type, fn, opts);
+ const hide = (node, v) => node.toggleAttribute('hidden', !!v);
+ const setVar = (name, value) => host.style.setProperty(name, value);
+ const unsetVar = (name) => host.style.removeProperty(name);
+
+ // =========================
+ // Create DOM
+ // =========================
+ const style = el('style');
+ style.textContent = ${JSON.stringify(errorCSS)};
+
+ const iframe = el('iframe');
+ iframe.id = 'frame';
+ iframe.src = 'data:text/html;base64,${base64HTML}';
+ iframe.title = 'Detailed error stack trace';
+ iframe.setAttribute('sandbox', 'allow-scripts allow-same-origin allow-top-navigation-by-user-activation');
+
+ const preview = el('div');
+ preview.id = 'preview';
+
+ const toggle = el('div');
+ toggle.id = 'toggle';
+ toggle.setAttribute('aria-expanded', 'true');
+ toggle.setAttribute('role', 'button');
+ toggle.setAttribute('tabindex', '0');
+ toggle.innerHTML = '<span class="sr-only">Toggle detailed error view</span>';
+
+ const liveRegion = el('div');
+ liveRegion.setAttribute('role', 'status');
+ liveRegion.setAttribute('aria-live', 'polite');
+ liveRegion.className = 'sr-only';
+
+ const pipCloseButton = el('button');
+ pipCloseButton.id = 'pip-close';
+ pipCloseButton.setAttribute('type', 'button');
+ pipCloseButton.setAttribute('aria-label', 'Hide error preview overlay');
+ pipCloseButton.innerHTML = '×';
+ pipCloseButton.hidden = true;
+ toggle.appendChild(pipCloseButton);
+
+ const pipRestoreButton = el('button');
+ pipRestoreButton.id = 'pip-restore';
+ pipRestoreButton.setAttribute('type', 'button');
+ pipRestoreButton.setAttribute('aria-label', 'Show error overlay');
+ pipRestoreButton.innerHTML = '<span aria-hidden="true">⟲</span><span>Show error overlay</span>';
+ pipRestoreButton.hidden = true;
+
+ // Order matters: #frame + #preview adjacency
+ shadow.appendChild(style);
+ shadow.appendChild(liveRegion);
+ shadow.appendChild(iframe);
+ shadow.appendChild(preview);
+ shadow.appendChild(toggle);
+ shadow.appendChild(pipRestoreButton);
+
+ // =========================
+ // Constants / keys
+ // =========================
+ const POS_KEYS = {
+ position: 'nuxt-error-overlay:position',
+ hiddenPretty: 'nuxt-error-overlay:error-pip:hidden',
+ hiddenPreview: 'nuxt-error-overlay:app-preview:hidden'
+ };
+
+ const CSS_VARS = {
+ pip: {
+ left: '--error-pip-left',
+ top: '--error-pip-top',
+ right: '--error-pip-right',
+ bottom: '--error-pip-bottom'
+ },
+ preview: {
+ left: '--app-preview-left',
+ top: '--app-preview-top',
+ right: '--app-preview-right',
+ bottom: '--app-preview-bottom'
+ }
+ };
+
+ const MIN_GAP = 5;
+ const DRAG_THRESHOLD = 2;
+
+ // =========================
+ // Local storage safe access + state
+ // =========================
+ let storageReady = true;
+ let isPrettyHidden = false;
+ let isPreviewHidden = false;
+
+ const safeGet = (k) => {
+ try {
+ return localStorage.getItem(k);
+ } catch {
+ return null;
+ }
+ };
+
+ const safeSet = (k, v) => {
+ if (!storageReady)
+ return;
+ try {
+ localStorage.setItem(k, v);
+ } catch {}
+ };
+
+ // =========================
+ // Sizing helpers
+ // =========================
+ const vvSize = () => {
+ const v = window.visualViewport;
+ return v ? { w: v.width, h: v.height } : { w: window.innerWidth, h: window.innerHeight };
+ };
+
+ const previewSize = () => {
+ const styles = getComputedStyle(host);
+ const w = parseFloat(styles.getPropertyValue('--preview-width')) || 240;
+ const h = parseFloat(styles.getPropertyValue('--preview-height')) || 180;
+ return { w, h };
+ };
+
+ const sizeForTarget = (target) => {
+ if (!target)
+ return previewSize();
+ const rect = target.getBoundingClientRect();
+ if (rect.width && rect.height)
+ return { w: rect.width, h: rect.height };
+ return previewSize();
+ };
+
+ // =========================
+ // Dock model + offset/alignment calculations
+ // =========================
+ const dock = { edge: null, offset: null, align: null, gap: null };
+
+ const maxOffsetFor = (edge, size) => {
+ const vv = vvSize();
+ if (edge === 'left' || edge === 'right')
+ return Math.max(MIN_GAP, vv.h - size.h - MIN_GAP);
+ return Math.max(MIN_GAP, vv.w - size.w - MIN_GAP);
+ };
+
+ const clampOffset = (edge, value, size) => {
+ const max = maxOffsetFor(edge, size);
+ return Math.min(Math.max(value, MIN_GAP), max);
+ };
+
+ const updateDockAlignment = (size) => {
+ if (!dock.edge || dock.offset == null)
+ return;
+ const max = maxOffsetFor(dock.edge, size);
+ if (dock.offset <= max / 2) {
+ dock.align = 'start';
+ dock.gap = dock.offset;
+ } else {
+ dock.align = 'end';
+ dock.gap = Math.max(0, max - dock.offset);
+ }
+ };
+
+ const appliedOffsetFor = (size) => {
+ if (!dock.edge || dock.offset == null)
+ return null;
+ const max = maxOffsetFor(dock.edge, size);
+
+ if (dock.align === 'end' && typeof dock.gap === 'number') {
+ return clampOffset(dock.edge, max - dock.gap, size);
+ }
+ if (dock.align === 'start' && typeof dock.gap === 'number') {
+ return clampOffset(dock.edge, dock.gap, size);
+ }
+ return clampOffset(dock.edge, dock.offset, size);
+ };
+
+ const nearestEdgeAt = (x, y) => {
+ const { w, h } = vvSize();
+ const d = { left: x, right: w - x, top: y, bottom: h - y };
+ return Object.keys(d).reduce((a, b) => (d[a] < d[b] ? a : b));
+ };
+
+ const cornerDefaultDock = () => {
+ const vv = vvSize();
+ const size = previewSize();
+ const offset = Math.max(MIN_GAP, vv.w - size.w - MIN_GAP);
+ return { edge: 'bottom', offset };
+ };
+
+ const currentTransformOrigin = () => {
+ if (!dock.edge) return null;
+ if (dock.edge === 'left' || dock.edge === 'top')
+ return 'top left';
+ if (dock.edge === 'right')
+ return 'top right';
+ return 'bottom left';
+ };
+
+ // =========================
+ // Persist / load dock
+ // =========================
+ const loadDock = () => {
+ const raw = safeGet(POS_KEYS.position);
+ if (!raw)
+ return;
+ try {
+ const parsed = JSON.parse(raw);
+ const { edge, offset, align, gap } = parsed || {};
+ if (!['left', 'right', 'top', 'bottom'].includes(edge))
+ return;
+ if (typeof offset !== 'number')
+ return;
+
+ dock.edge = edge;
+ dock.offset = clampOffset(edge, offset, previewSize());
+ dock.align = align === 'start' || align === 'end' ? align : null;
+ dock.gap = typeof gap === 'number' ? gap : null;
+
+ if (!dock.align || dock.gap == null)
+ updateDockAlignment(previewSize());
+ } catch {}
+ };
+
+ const persistDock = () => {
+ if (!dock.edge || dock.offset == null)
+ return;
+ safeSet(POS_KEYS.position, JSON.stringify({
+ edge: dock.edge,
+ offset: dock.offset,
+ align: dock.align,
+ gap: dock.gap
+ }));
+ };
+
+ // =========================
+ // Apply dock
+ // =========================
+ const dockToVars = (vars) => ({
+ set: (side, v) => host.style.setProperty(vars[side], v),
+ clear: (side) => host.style.removeProperty(vars[side])
+ });
+
+ const dockToEl = (node) => ({
+ set: (side, v) => { node.style[side] = v; },
+ clear: (side) => { node.style[side] = ''; }
+ });
+
+ const applyDock = (target, size, opts) => {
+ if (!dock.edge || dock.offset == null) {
+ target.clear('left');
+ target.clear('top');
+ target.clear('right');
+ target.clear('bottom');
+ return;
+ }
+
+ target.set('left', 'auto');
+ target.set('top', 'auto');
+ target.set('right', 'auto');
+ target.set('bottom', 'auto');
+
+ const applied = appliedOffsetFor(size);
+
+ if (dock.edge === 'left') {
+ target.set('left', MIN_GAP + 'px');
+ target.set('top', applied + 'px');
+ } else if (dock.edge === 'right') {
+ target.set('right', MIN_GAP + 'px');
+ target.set('top', applied + 'px');
+ } else if (dock.edge === 'top') {
+ target.set('top', MIN_GAP + 'px');
+ target.set('left', applied + 'px');
+ } else {
+ target.set('bottom', MIN_GAP + 'px');
+ target.set('left', applied + 'px');
+ }
+
+ if (!opts || opts.persist !== false)
+ persistDock();
+ };
+
+ const applyDockAll = (opts) => {
+ applyDock(dockToVars(CSS_VARS.pip), previewSize(), opts);
+ applyDock(dockToVars(CSS_VARS.preview), previewSize(), opts);
+ applyDock(dockToEl(pipRestoreButton), sizeForTarget(pipRestoreButton), opts);
+ };
+
+ const repaintToDock = () => {
+ if (!dock.edge || dock.offset == null)
+ return;
+ const origin = currentTransformOrigin();
+ if (origin)
+ setVar('--error-pip-origin', origin);
+ else
+ unsetVar('--error-pip-origin');
+ applyDockAll({ persist: false });
+ };
+
+ // =========================
+ // Hidden state + UI
+ // =========================
+ const loadHidden = () => {
+ const rawPretty = safeGet(POS_KEYS.hiddenPretty);
+ if (rawPretty != null)
+ isPrettyHidden = rawPretty === '1' || rawPretty === 'true';
+ const rawPreview = safeGet(POS_KEYS.hiddenPreview);
+ if (rawPreview != null)
+ isPreviewHidden = rawPreview === '1' || rawPreview === 'true';
+ };
+
+ const setPrettyHidden = (v) => {
+ isPrettyHidden = !!v;
+ safeSet(POS_KEYS.hiddenPretty, isPrettyHidden ? '1' : '0');
+ updateUI();
+ };
+
+ const setPreviewHidden = (v) => {
+ isPreviewHidden = !!v;
+ safeSet(POS_KEYS.hiddenPreview, isPreviewHidden ? '1' : '0');
+ updateUI();
+ };
+
+ const isMinimized = () => iframe.hasAttribute('inert');
+
+ const setMinimized = (v) => {
+ if (v) {
+ iframe.setAttribute('inert', '');
+ toggle.setAttribute('aria-expanded', 'false');
+ } else {
+ iframe.removeAttribute('inert');
+ toggle.setAttribute('aria-expanded', 'true');
+ }
+ };
+
+ const setRestoreLabel = (kind) => {
+ if (kind === 'pretty') {
+ pipRestoreButton.innerHTML = '<span aria-hidden="true">⟲</span><span>Show error overlay</span>';
+ pipRestoreButton.setAttribute('aria-label', 'Show error overlay');
+ } else {
+ pipRestoreButton.innerHTML = '<span aria-hidden="true">⟲</span><span>Show error page</span>';
+ pipRestoreButton.setAttribute('aria-label', 'Show error page');
+ }
+ };
+
+ const updateUI = () => {
+ const minimized = isMinimized();
+ const showPiP = minimized && !isPrettyHidden;
+ const showPreview = !minimized && !isPreviewHidden;
+ const pipHiddenByUser = minimized && isPrettyHidden;
+ const previewHiddenByUser = !minimized && isPreviewHidden;
+ const showToggle = minimized ? showPiP : showPreview;
+ const showRestore = pipHiddenByUser || previewHiddenByUser;
+
+ hide(iframe, pipHiddenByUser);
+ hide(preview, !showPreview);
+ hide(toggle, !showToggle);
+ hide(pipCloseButton, !showToggle);
+ hide(pipRestoreButton, !showRestore);
+
+ pipCloseButton.setAttribute('aria-label', minimized ? 'Hide error overlay' : 'Hide error page preview');
+
+ if (pipHiddenByUser)
+ setRestoreLabel('pretty');
+ else if (previewHiddenByUser)
+ setRestoreLabel('preview');
+
+ host.classList.toggle('pip-hidden', isPrettyHidden);
+ host.classList.toggle('preview-hidden', isPreviewHidden);
+ };
+
+ // =========================
+ // Preview snapshot
+ // =========================
+ const updatePreview = () => {
+ try {
+ let previewIframe = preview.querySelector('iframe');
+ if (!previewIframe) {
+ previewIframe = el('iframe');
+ previewIframe.style.cssText = 'width: 1200px; height: 900px; transform: scale(0.2); transform-origin: top left; border: none;';
+ previewIframe.setAttribute('sandbox', 'allow-scripts allow-same-origin');
+ preview.appendChild(previewIframe);
+ }
+
+ const doctype = document.doctype ? '<!DOCTYPE ' + document.doctype.name + '>' : '';
+ const cleanedHTML = document.documentElement.outerHTML
+ .replace(/<nuxt-error-overlay[^>]*>.*?<\\/nuxt-error-overlay>/gs, '')
+ .replace(/<script[^>]*>.*?<\\/script>/gs, '');
+
+ const iframeDoc = previewIframe.contentDocument || previewIframe.contentWindow.document;
+ iframeDoc.open();
+ iframeDoc.write(doctype + cleanedHTML);
+ iframeDoc.close();
+ } catch (err) {
+ console.error('Failed to update preview:', err);
+ }
+ };
+
+ // =========================
+ // View toggling
+ // =========================
+ const toggleView = () => {
+ if (isMinimized()) {
+ updatePreview();
+ setMinimized(false);
+ liveRegion.textContent = 'Showing detailed error view';
+ setTimeout(() => {
+ try {
+ iframe.contentWindow.focus();
+ } catch {}
+ }, 100);
+ } else {
+ setMinimized(true);
+ liveRegion.textContent = 'Showing error page';
+ repaintToDock();
+ void iframe.offsetWidth;
+ }
+ updateUI();
+ };
+
+ // =========================
+ // Dragging (unified, rAF throttled)
+ // =========================
+ let drag = null;
+ let rafId = null;
+ let suppressToggleClick = false;
+ let suppressRestoreClick = false;
+
+ const beginDrag = (e) => {
+ if (drag)
+ return;
+
+ if (!dock.edge || dock.offset == null) {
+ const def = cornerDefaultDock();
+ dock.edge = def.edge;
+ dock.offset = def.offset;
+ updateDockAlignment(previewSize());
+ }
+
+ const isRestoreTarget = e.currentTarget === pipRestoreButton;
+
+ drag = {
+ kind: isRestoreTarget ? 'restore' : (isMinimized() ? 'pip' : 'preview'),
+ pointerId: e.pointerId,
+ startX: e.clientX,
+ startY: e.clientY,
+ lastX: e.clientX,
+ lastY: e.clientY,
+ moved: false,
+ target: e.currentTarget
+ };
+
+ drag.target.setPointerCapture(e.pointerId);
+
+ if (drag.kind === 'restore')
+ host.classList.add('dragging-restore');
+ else
+ host.classList.add(drag.kind === 'pip' ? 'dragging' : 'dragging-preview');
+
+ e.preventDefault();
+ };
+
+ const moveDrag = (e) => {
+ if (!drag || drag.pointerId !== e.pointerId)
+ return;
+
+ drag.lastX = e.clientX;
+ drag.lastY = e.clientY;
+
+ const dx = drag.lastX - drag.startX;
+ const dy = drag.lastY - drag.startY;
+
+ if (!drag.moved && (Math.abs(dx) > DRAG_THRESHOLD || Math.abs(dy) > DRAG_THRESHOLD)) {
+ drag.moved = true;
+ }
+
+ if (!drag.moved)
+ return;
+ if (rafId)
+ return;
+
+ rafId = requestAnimationFrame(() => {
+ rafId = null;
+
+ const edge = nearestEdgeAt(drag.lastX, drag.lastY);
+ const size = sizeForTarget(drag.target);
+
+ let offset;
+ if (edge === 'left' || edge === 'right') {
+ const top = drag.lastY - (size.h / 2);
+ offset = clampOffset(edge, Math.round(top), size);
+ } else {
+ const left = drag.lastX - (size.w / 2);
+ offset = clampOffset(edge, Math.round(left), size);
+ }
+
+ dock.edge = edge;
+ dock.offset = offset;
+ updateDockAlignment(size);
+
+ const origin = currentTransformOrigin();
+ setVar('--error-pip-origin', origin || 'bottom right');
+
+ applyDockAll({ persist: false });
+ });
+ };
+
+ const endDrag = (e) => {
+ if (!drag || drag.pointerId !== e.pointerId)
+ return;
+
+ const endedKind = drag.kind;
+ drag.target.releasePointerCapture(e.pointerId);
+
+ if (endedKind === 'restore')
+ host.classList.remove('dragging-restore');
+ else
+ host.classList.remove(endedKind === 'pip' ? 'dragging' : 'dragging-preview');
+
+ const didMove = drag.moved;
+ drag = null;
+
+ if (didMove) {
+ persistDock();
+ if (endedKind === 'restore')
+ suppressRestoreClick = true;
+ else
+ suppressToggleClick = true;
+ e.preventDefault();
+ e.stopPropagation();
+ }
+ };
+
+ const bindDragTarget = (node) => {
+ on(node, 'pointerdown', beginDrag);
+ on(node, 'pointermove', moveDrag);
+ on(node, 'pointerup', endDrag);
+ on(node, 'pointercancel', endDrag);
+ };
+
+ bindDragTarget(toggle);
+ bindDragTarget(pipRestoreButton);
+
+ // =========================
+ // Events (toggle / close / restore)
+ // =========================
+ on(toggle, 'click', (e) => {
+ if (suppressToggleClick) {
+ e.preventDefault();
+ suppressToggleClick = false;
+ return;
+ }
+ toggleView();
+ });
+
+ on(toggle, 'keydown', (e) => {
+ if (e.key === 'Enter' || e.key === ' ') {
+ e.preventDefault();
+ toggleView();
+ }
+ });
+
+ on(pipCloseButton, 'click', (e) => {
+ e.preventDefault();
+ e.stopPropagation();
+ if (isMinimized())
+ setPrettyHidden(true);
+ else
+ setPreviewHidden(true);
+ });
+
+ on(pipCloseButton, 'pointerdown', (e) => {
+ e.stopPropagation();
+ });
+
+ on(pipRestoreButton, 'click', (e) => {
+ if (suppressRestoreClick) {
+ e.preventDefault();
+ suppressRestoreClick = false;
+ return;
+ }
+ e.preventDefault();
+ e.stopPropagation();
+ if (isMinimized())
+ setPrettyHidden(false);
+ else
+ setPreviewHidden(false);
+ });
+
+ // =========================
+ // Lifecycle: load / sync / repaint
+ // =========================
+ const loadState = () => {
+ loadDock();
+ loadHidden();
+
+ if (isPrettyHidden && !isMinimized())
+ setMinimized(true);
+
+ updateUI();
+ repaintToDock();
+ };
+
+ loadState();
+
+ on(window, 'storage-ready', () => {
+ storageReady = true;
+ loadState();
+ });
+
+ const onViewportChange = () => repaintToDock();
+
+ on(window, 'resize', onViewportChange);
+
+ if (window.visualViewport) {
+ on(window.visualViewport, 'resize', onViewportChange);
+ on(window.visualViewport, 'scroll', onViewportChange);
+ }
+
+ // initial preview
+ setTimeout(updatePreview, 100);
+
+ // initial minimized option
+ if (${startMinimized}) {
+ setMinimized(true);
+ repaintToDock();
+ void iframe.offsetWidth;
+ updateUI();
+ }
+ } catch (err) {
+ console.error('Failed to initialize Nuxt error overlay:', err);
+ }
+})();
+`
+}
+
+export function generateErrorOverlayHTML (html: string, options?: { startMinimized?: boolean }) {
+ const nonce = Array.from(crypto.getRandomValues(new Uint8Array(16)), b => b.toString(16).padStart(2, '0')).join('')
+ const errorPage = html.replace('<head>', `<head><script>${iframeStorageBridge(nonce)}</script>`)
+ const base64HTML = Buffer.from(errorPage, 'utf8').toString('base64')
+ return `
+ <script>${parentStorageBridge(nonce)}</script>
+ <nuxt-error-overlay></nuxt-error-overlay>
+ <script>${webComponentScript(base64HTML, options?.startMinimized ?? false)}</script>
+ `
+}
diff --git a/packages/nitro-server/src/runtime/utils/error.ts b/packages/nitro-server/src/runtime/utils/error.ts
new file mode 100644
index 000000000000..14df9fc34735
--- /dev/null
+++ b/packages/nitro-server/src/runtime/utils/error.ts
@@ -0,0 +1,29 @@
+import type { HTTPEvent } from 'nitro/h3'
+import { FastURL } from 'srvx'
+
+/**
+ * Nitro internal functions extracted from https://github.com/nitrojs/nitro/blob/v2/src/runtime/internal/utils.ts
+ */
+
+export function isJsonRequest (event: HTTPEvent): boolean {
+ // If the client specifically requests HTML, then avoid classifying as JSON.
+ if (event.req.headers.get('accept')?.includes('text/html')) {
+ return false
+ }
+ const pathname = new FastURL(event.req.url).pathname
+ return (
+ hasReqHeader(event, 'accept', 'application/json') ||
+ hasReqHeader(event, 'user-agent', 'curl/') ||
+ hasReqHeader(event, 'user-agent', 'httpie/') ||
+ hasReqHeader(event, 'sec-fetch-mode', 'cors') ||
+ pathname.startsWith('/api/') ||
+ pathname.endsWith('.json')
+ )
+}
+
+export function hasReqHeader (event: HTTPEvent, name: string, includes: string): boolean {
+ const value = event.req.headers.get(name)
+ return !!(
+ value && value.toLowerCase().includes(includes)
+ )
+}
diff --git a/packages/nitro-server/src/runtime/utils/paths.ts b/packages/nitro-server/src/runtime/utils/paths.ts
new file mode 100644
index 000000000000..7e794762f6fe
--- /dev/null
+++ b/packages/nitro-server/src/runtime/utils/paths.ts
@@ -0,0 +1,22 @@
+import { joinRelativeURL } from 'ufo'
+import { useRuntimeConfig } from 'nitro/runtime-config'
+
+const config = useRuntimeConfig()
+
+export function baseURL (): string {
+ return config.app.baseURL
+}
+
+export function buildAssetsDir (): string {
+ return config.app.buildAssetsDir as string
+}
+
+export function buildAssetsURL (...path: string[]): string {
+ return joinRelativeURL(publicAssetsURL(), buildAssetsDir(), ...path)
+}
+
+export function publicAssetsURL (...path: string[]): string {
+ const app = config.app
+ const publicBase = app.cdnURL as string || app.baseURL
+ return path.length ? joinRelativeURL(publicBase, ...path) : publicBase
+}
diff --git a/packages/nitro-server/src/runtime/utils/renderer/app.ts b/packages/nitro-server/src/runtime/utils/renderer/app.ts
new file mode 100644
index 000000000000..10543a73d4d4
--- /dev/null
+++ b/packages/nitro-server/src/runtime/utils/renderer/app.ts
@@ -0,0 +1,43 @@
+import type { H3Event } from 'nitro/h3'
+import { useRuntimeConfig } from 'nitro/runtime-config'
+import { createHead } from '@unhead/vue/server'
+import type { NuxtPayload, NuxtSSRContext } from 'nuxt/app'
+import { sharedPrerenderCache } from '../cache'
+// @ts-expect-error virtual file
+import unheadOptions from '#internal/unhead-options.mjs'
+// @ts-expect-error virtual file
+import { NUXT_NO_SSR, NUXT_SHARED_DATA } from '#internal/nuxt/nitro-config.mjs'
+
+const PRERENDER_NO_SSR_ROUTES = new Set(['/index.html', '/200.html', '/404.html'])
+
+export function createSSRContext (event: H3Event): NuxtSSRContext {
+ const url = event.url.pathname + event.url.search + event.url.hash
+ const ssrContext: NuxtSSRContext = {
+ url,
+ event,
+ runtimeConfig: useRuntimeConfig() as NuxtSSRContext['runtimeConfig'],
+ noSSR: !!(NUXT_NO_SSR) || event.context.nuxt?.noSSR || (import.meta.prerender ? PRERENDER_NO_SSR_ROUTES.has(url) : false),
+ head: createHead(unheadOptions),
+ error: false,
+ nuxt: undefined!, /* NuxtApp */
+ payload: {},
+ ['~payloadReducers']: Object.create(null),
+ modules: new Set(),
+ }
+
+ if (import.meta.prerender) {
+ if (NUXT_SHARED_DATA) {
+ ssrContext['~sharedPrerenderCache'] = sharedPrerenderCache!
+ }
+ ssrContext.payload.prerenderedAt = Date.now()
+ }
+
+ return ssrContext
+}
+
+export function setSSRError (ssrContext: NuxtSSRContext, error: NuxtPayload['error'] & { url: string }): void {
+ ssrContext.error = true
+ ssrContext.payload = { error }
+ const url = new URL(error.url)
+ ssrContext.url = url.pathname + url.search + url.hash
+}
diff --git a/packages/nitro-server/src/runtime/utils/renderer/build-files.ts b/packages/nitro-server/src/runtime/utils/renderer/build-files.ts
new file mode 100644
index 000000000000..7dbfc8935203
--- /dev/null
+++ b/packages/nitro-server/src/runtime/utils/renderer/build-files.ts
@@ -0,0 +1,138 @@
+import type { RendererContext } from 'vue-bundle-renderer/runtime'
+import { createRenderer } from 'vue-bundle-renderer/runtime'
+import type { Manifest, PrecomputedData } from 'vue-bundle-renderer'
+import { renderToString as _renderToString } from 'vue/server-renderer'
+import { propsToString } from '@unhead/vue/server'
+import { useRuntimeConfig } from 'nitro/runtime-config'
+
+import type { NuxtSSRContext } from 'nuxt/app'
+
+// @ts-expect-error virtual file
+import { NUXT_NO_SSR } from '#internal/nuxt/nitro-config.mjs'
+// @ts-expect-error virtual file
+import { appRootAttrs, appRootTag, appSpaLoaderAttrs, appSpaLoaderTag, spaLoadingTemplateOutside } from '#internal/nuxt.config.mjs'
+import { buildAssetsURL, publicAssetsURL } from '../paths'
+
+// @ts-expect-error private property consumed by vite-generated url helpers
+globalThis.__buildAssetsURL = buildAssetsURL
+// @ts-expect-error private property consumed by vite-generated url helpers
+globalThis.__publicAssetsURL = publicAssetsURL
+
+const APP_ROOT_OPEN_TAG = `<${appRootTag}${propsToString(appRootAttrs)}>`
+const APP_ROOT_CLOSE_TAG = `</${appRootTag}>`
+
+// @ts-expect-error file will be produced after app build
+const getServerEntry = () => import('#build/dist/server/server.mjs').then(r => r.default || r)
+
+// @ts-expect-error file will be produced after app build
+const getClientManifest: () => Promise<Manifest> = () => import('#build/dist/server/client.manifest.mjs')
+ .then(r => r.default || r)
+ .then(r => typeof r === 'function' ? r() : r) as Promise<Manifest>
+
+// @ts-expect-error file will be produced after app build
+const getPrecomputedDependencies: () => Promise<PrecomputedData> = () => import('#build/dist/server/client.precomputed.mjs')
+ .then(r => r.default || r)
+ .then(r => typeof r === 'function' ? r() : r) as Promise<PrecomputedData>
+
+interface Renderer {
+ rendererContext: RendererContext
+ renderToString(ssrContext: NuxtSSRContext): Promise<{
+ html: string
+ renderResourceHeaders: () => Record<string, string>
+ renderResourceHints: () => string
+ renderStyles: () => string
+ renderScripts: () => string
+ }>
+}
+
+// -- SSR Renderer --
+export const getSSRRenderer: () => Promise<Renderer> = lazyCachedFunction(async (): Promise<Renderer> => {
+ // Load server bundle
+ const createSSRApp = await getServerEntry()
+ if (!createSSRApp) { throw new Error('Server bundle is not available') }
+
+ // Load precomputed dependencies
+ const precomputed = import.meta.dev ? undefined : await getPrecomputedDependencies()
+
+ // Create renderer
+ const renderer = createRenderer(createSSRApp, {
+ precomputed,
+ manifest: import.meta.dev ? await getClientManifest() : undefined,
+ renderToString,
+ buildAssetsURL,
+ })
+
+ type RenderToStringParams = Parameters<typeof _renderToString>
+ async function renderToString (input: RenderToStringParams[0], context: RenderToStringParams[1]) {
+ const html = await _renderToString(input, context)
+ // In development with vite-node, the manifest is on-demand and will be available after rendering
+ // eslint-disable-next-line no-restricted-globals
+ if (import.meta.dev && process.env.NUXT_VITE_NODE_OPTIONS) {
+ renderer.rendererContext.updateManifest(await getClientManifest())
+ }
+ return APP_ROOT_OPEN_TAG + html + APP_ROOT_CLOSE_TAG
+ }
+
+ return renderer
+})
+
+// -- SPA Renderer --
+const getSPARenderer = lazyCachedFunction(async (): Promise<Renderer> => {
+ const precomputed = import.meta.dev ? undefined : await getPrecomputedDependencies()
+
+ // @ts-expect-error virtual file
+ const spaTemplate = await import('#spa-template').then(r => r.template).catch(() => '')
+ .then((r) => {
+ if (spaLoadingTemplateOutside) {
+ const APP_SPA_LOADER_OPEN_TAG = `<${appSpaLoaderTag}${propsToString(appSpaLoaderAttrs)}>`
+ const APP_SPA_LOADER_CLOSE_TAG = `</${appSpaLoaderTag}>`
+ const appTemplate = APP_ROOT_OPEN_TAG + APP_ROOT_CLOSE_TAG
+ const loaderTemplate = r ? APP_SPA_LOADER_OPEN_TAG + r + APP_SPA_LOADER_CLOSE_TAG : ''
+ return appTemplate + loaderTemplate
+ } else {
+ return APP_ROOT_OPEN_TAG + r + APP_ROOT_CLOSE_TAG
+ }
+ })
+
+ // Create SPA renderer and cache the result for all requests
+ const renderer = createRenderer(() => () => {}, {
+ precomputed,
+ manifest: import.meta.dev ? await getClientManifest() : undefined,
+ renderToString: () => spaTemplate,
+ buildAssetsURL,
+ })
+ const result = await renderer.renderToString({})
+
+ const renderToString = (ssrContext: NuxtSSRContext) => {
+ const config = useRuntimeConfig()
+ ssrContext.modules ||= new Set<string>()
+ ssrContext.payload.serverRendered = false
+ ssrContext.config = {
+ public: config.public,
+ app: config.app,
+ }
+ return Promise.resolve(result)
+ }
+
+ return {
+ rendererContext: renderer.rendererContext,
+ renderToString,
+ }
+})
+
+function lazyCachedFunction<T> (fn: () => Promise<T>): () => Promise<T> {
+ let res: Promise<T> | null = null
+ return () => {
+ if (res === null) {
+ res = fn().catch((err) => { res = null; throw err })
+ }
+ return res
+ }
+}
+
+export function getRenderer (ssrContext: NuxtSSRContext): Promise<Renderer> {
+ return (NUXT_NO_SSR || ssrContext.noSSR) ? getSPARenderer() : getSSRRenderer()
+}
+
+// @ts-expect-error file will be produced after app build
+export const getSSRStyles: () => Promise<Record<string, () => Promise<string[]>>> = lazyCachedFunction((): Promise<Record<string, () => Promise<string[]>>> => import('#build/dist/server/styles.mjs').then(r => r.default || r))
diff --git a/packages/nitro-server/src/runtime/utils/renderer/inline-styles.ts b/packages/nitro-server/src/runtime/utils/renderer/inline-styles.ts
new file mode 100644
index 000000000000..8ad4a656e4c2
--- /dev/null
+++ b/packages/nitro-server/src/runtime/utils/renderer/inline-styles.ts
@@ -0,0 +1,15 @@
+import type { Style } from '@unhead/vue/types'
+import { getSSRStyles } from './build-files'
+
+export async function renderInlineStyles (usedModules: Set<string> | string[]): Promise<Style[]> {
+ const styleMap = await getSSRStyles()
+ const inlinedStyles = new Set<string>()
+ for (const mod of usedModules) {
+ if (mod in styleMap && styleMap[mod]) {
+ for (const style of await styleMap[mod]()) {
+ inlinedStyles.add(style)
+ }
+ }
+ }
+ return Array.from(inlinedStyles).map(style => ({ innerHTML: style }))
+}
diff --git a/packages/nitro-server/src/runtime/utils/renderer/islands.ts b/packages/nitro-server/src/runtime/utils/renderer/islands.ts
new file mode 100644
index 000000000000..af9a87635187
--- /dev/null
+++ b/packages/nitro-server/src/runtime/utils/renderer/islands.ts
@@ -0,0 +1,86 @@
+import type { NuxtIslandResponse, NuxtSSRContext } from 'nuxt/app'
+// @ts-expect-error virtual file
+import { appRootTag } from '#internal/nuxt.config.mjs'
+
+const ROOT_NODE_REGEX = new RegExp(`^<${appRootTag}[^>]*>([\\s\\S]*)<\\/${appRootTag}>$`)
+
+/**
+ * remove the root node from the html body
+ */
+export function getServerComponentHTML (body: string): string {
+ const match = body.match(ROOT_NODE_REGEX)
+ return match?.[1] || body
+}
+
+const SSR_SLOT_TELEPORT_MARKER = /^uid=([^;]*);slot=(.*)$/
+const SSR_CLIENT_TELEPORT_MARKER = /^uid=([^;]*);client=(.*)$/
+const SSR_CLIENT_SLOT_MARKER = /^island-slot=([^;]*);(.*)$/
+
+export function getSlotIslandResponse (ssrContext: NuxtSSRContext): NuxtIslandResponse['slots'] {
+ if (!ssrContext.islandContext || !Object.keys(ssrContext.islandContext.slots).length) { return undefined }
+ const response: NuxtIslandResponse['slots'] = {}
+ for (const [name, slot] of Object.entries(ssrContext.islandContext.slots)) {
+ response[name] = {
+ ...slot,
+ fallback: ssrContext.teleports?.[`island-fallback=${name}`],
+ }
+ }
+ return response
+}
+
+export function getClientIslandResponse (ssrContext: NuxtSSRContext): NuxtIslandResponse['components'] {
+ if (!ssrContext.islandContext || !Object.keys(ssrContext.islandContext.components).length) { return undefined }
+ const response: NuxtIslandResponse['components'] = {}
+
+ for (const [clientUid, component] of Object.entries(ssrContext.islandContext.components)) {
+ // remove teleport anchor to avoid hydration issues
+ const html = ssrContext.teleports?.[clientUid]?.replaceAll('<!--teleport start anchor-->', '') || ''
+ response[clientUid] = {
+ ...component,
+ html,
+ slots: getComponentSlotTeleport(clientUid, ssrContext.teleports ?? {}),
+ }
+ }
+ return response
+}
+
+export function getComponentSlotTeleport (clientUid: string, teleports: Record<string, string>): Record<string, string> {
+ const entries = Object.entries(teleports)
+ const slots: Record<string, string> = {}
+
+ for (const [key, value] of entries) {
+ const match = key.match(SSR_CLIENT_SLOT_MARKER)
+ if (match) {
+ const [, id, slot] = match
+ if (!slot || clientUid !== id) { continue }
+ slots[slot] = value
+ }
+ }
+ return slots
+}
+
+export function replaceIslandTeleports (ssrContext: NuxtSSRContext, html: string): string {
+ const { teleports, islandContext } = ssrContext
+
+ if (islandContext || !teleports) { return html }
+ for (const key in teleports) {
+ const matchClientComp = key.match(SSR_CLIENT_TELEPORT_MARKER)
+ if (matchClientComp) {
+ const [, uid, clientId] = matchClientComp
+ if (!uid || !clientId) { continue }
+ html = html.replace(new RegExp(` data-island-uid="${uid}" data-island-component="${clientId}"[^>]*>`), (full) => {
+ return full + teleports[key]
+ })
+ continue
+ }
+ const matchSlot = key.match(SSR_SLOT_TELEPORT_MARKER)
+ if (matchSlot) {
+ const [, uid, slot] = matchSlot
+ if (!uid || !slot) { continue }
+ html = html.replace(new RegExp(` data-island-uid="${uid}" data-island-slot="${slot}"[^>]*>`), (full) => {
+ return full + teleports[key]
+ })
+ }
+ }
+ return html
+}
diff --git a/packages/nitro-server/src/runtime/utils/renderer/payload.ts b/packages/nitro-server/src/runtime/utils/renderer/payload.ts
new file mode 100644
index 000000000000..451c5a864f0c
--- /dev/null
+++ b/packages/nitro-server/src/runtime/utils/renderer/payload.ts
@@ -0,0 +1,77 @@
+import type { RenderResponse } from 'nitro/types'
+import { stringify, uneval } from 'devalue'
+import type { Script } from '@unhead/vue'
+
+import type { NuxtPayload, NuxtSSRContext } from 'nuxt/app'
+
+// @ts-expect-error virtual file
+import { appId, multiApp } from '#internal/nuxt.config.mjs'
+// @ts-expect-error virtual file
+import { NUXT_NO_SSR } from '#internal/nuxt/nitro-config.mjs'
+
+export function renderPayloadResponse (ssrContext: NuxtSSRContext): RenderResponse {
+ return {
+ body: encodeForwardSlashes(stringify(splitPayload(ssrContext).payload, ssrContext['~payloadReducers'])),
+ status: ssrContext.event.res.status || 200,
+ statusText: ssrContext.event.res.statusText || '',
+ headers: {
+ 'content-type': 'application/json;charset=utf-8',
+ 'x-powered-by': 'Nuxt',
+ },
+ }
+}
+
+export function renderPayloadJsonScript (opts: { ssrContext: NuxtSSRContext, data?: any, src?: string }): Script[] {
+ const contents = opts.data ? encodeForwardSlashes(stringify(opts.data, opts.ssrContext['~payloadReducers'])) : ''
+ const payload: Script = {
+ 'type': 'application/json',
+ 'innerHTML': contents,
+ 'data-nuxt-data': appId,
+ 'data-ssr': !(NUXT_NO_SSR || opts.ssrContext.noSSR),
+ }
+ if (!multiApp) {
+ payload.id = '__NUXT_DATA__'
+ }
+ if (opts.src) {
+ payload['data-src'] = opts.src
+ }
+ const config = uneval(opts.ssrContext.config)
+ return [
+ payload,
+ {
+ innerHTML: multiApp
+ ? `window.__NUXT__=window.__NUXT__||{};window.__NUXT__[${JSON.stringify(appId)}]={config:${config}}`
+ : `window.__NUXT__={};window.__NUXT__.config=${config}`,
+ },
+ ]
+}
+
+/**
+ * Encode forward slashes as unicode escape sequences to prevent
+ * Google from treating them as internal links and trying to crawl them.
+ * @see https://github.com/nuxt/nuxt/issues/24175
+ */
+function encodeForwardSlashes (str: string): string {
+ return str.replaceAll('/', '\\u002F')
+}
+
+interface SplitPayload {
+ initial: Omit<NuxtPayload, 'data' | 'prefetchLinks'>
+ payload: {
+ data?: NuxtPayload['data']
+ prerenderedAt?: NuxtPayload['prerenderedAt']
+ prefetchLinks?: NuxtPayload['prefetchLinks']
+ }
+}
+
+export function splitPayload (ssrContext: NuxtSSRContext): SplitPayload {
+ const { data, prerenderedAt, prefetchLinks, ...initial } = ssrContext.payload
+ const payload: SplitPayload['payload'] = { data, prerenderedAt }
+ if (prefetchLinks?.length) {
+ payload.prefetchLinks = prefetchLinks
+ }
+ return {
+ initial: { ...initial, prerenderedAt },
+ payload,
+ }
+}
diff --git a/packages/nitro-server/src/templates.ts b/packages/nitro-server/src/templates.ts
new file mode 100644
index 000000000000..17ed4b5e9b22
--- /dev/null
+++ b/packages/nitro-server/src/templates.ts
@@ -0,0 +1,61 @@
+import type { NuxtTemplate, TSReference } from 'nuxt/schema'
+import { isAbsolute, join, relative } from 'pathe'
+
+export const nitroSchemaTemplate: NuxtTemplate = {
+ filename: 'types/nitro-nuxt.d.ts',
+ async getContents ({ nuxt }) {
+ const references = [] as TSReference[]
+ const declarations = [] as string[]
+ await nuxt.callHook('nitro:prepare:types', { references, declarations })
+
+ const typesDir = join(nuxt.options.buildDir, 'types')
+ const lines = [
+ ...references.map(ref => renderReference(ref, typesDir)),
+ ...declarations,
+ ]
+
+ return /* typescript */`
+${lines.join('\n')}
+
+import type { RuntimeConfig } from 'nuxt/schema'
+import type { H3Event } from 'nitro/h3'
+import type { LogObject } from 'consola'
+import type { NuxtIslandContext, NuxtIslandResponse, NuxtRenderHTMLContext } from 'nuxt/app'
+
+declare module 'nitro/types' {
+ interface NitroRuntimeConfigApp {
+ baseURL: string
+ buildAssetsDir: string
+ cdnURL: string
+ }
+ interface NitroRuntimeConfig extends RuntimeConfig {}
+ interface NitroRouteConfig {
+ ssr?: boolean
+ noScripts?: boolean
+ /** @deprecated Use \`noScripts\` instead */
+ experimentalNoScripts?: boolean
+ }
+ interface NitroRouteRules {
+ ssr?: boolean
+ noScripts?: boolean
+ /** @deprecated Use \`noScripts\` instead */
+ experimentalNoScripts?: boolean
+ appMiddleware?: Record<string, boolean>
+ appLayout?: string | false
+ }
+ interface NitroRuntimeHooks {
+ 'dev:ssr-logs': (ctx: { logs: LogObject[], path: string }) => void | Promise<void>
+ 'render:html': (htmlContext: NuxtRenderHTMLContext, context: { event: H3Event }) => void | Promise<void>
+ 'render:island': (islandResponse: NuxtIslandResponse, context: { event: H3Event, islandContext: NuxtIslandContext }) => void | Promise<void>
+ }
+}
+`
+ },
+}
+
+function renderReference (ref: TSReference, baseDir: string) {
+ const stuff = 'path' in ref
+ ? `path="${isAbsolute(ref.path) ? relative(baseDir, ref.path) : ref.path}"`
+ : `types="${ref.types}"`
+ return `/// <reference ${stuff} />`
+}
diff --git a/packages/nitro-server/src/utils.ts b/packages/nitro-server/src/utils.ts
new file mode 100644
index 000000000000..acb2a8e24146
--- /dev/null
+++ b/packages/nitro-server/src/utils.ts
@@ -0,0 +1,26 @@
+import { fileURLToPath } from 'node:url'
+import { dirname } from 'pathe'
+
+export function toArray<T> (value: T | T[]): T[] {
+ return Array.isArray(value) ? value : [value]
+}
+
+/**
+ * Build the `resolve.conditions` array applied to the SSR vite environment.
+ *
+ * `'import'` is required so that packages whose top-level `exports` map is
+ * keyed only by `import`/`require` (notably `vue` and `vue-router`) resolve
+ * when the only available copy is nested under `nuxt`'s own `node_modules`.
+ */
+export function getSsrResolveConditions (exportConditions?: string[]): string[] {
+ const conditions = [...exportConditions || []]
+ if (!conditions.includes('import')) {
+ conditions.push('import')
+ }
+ return conditions
+}
+
+let _distDir = dirname(fileURLToPath(import.meta.url))
+if (/(?:chunks|shared)$/.test(_distDir)) { _distDir = dirname(_distDir) }
+
+export const distDir = _distDir
diff --git a/packages/nuxi/README.md b/packages/nuxi/README.md
new file mode 100644
index 000000000000..05abfb28f5ba
--- /dev/null
+++ b/packages/nuxi/README.md
@@ -0,0 +1,5 @@
+# Nuxt CLI
+
+⚡️ Next Generation CLI Experience for [Nuxt](https://nuxt.com/).
+
+- 👉 View on GitHub at https://github.com/nuxt/cli
diff --git a/packages/nuxt/.attw.json b/packages/nuxt/.attw.json
new file mode 100644
index 000000000000..aea59b2f4bd9
--- /dev/null
+++ b/packages/nuxt/.attw.json
@@ -0,0 +1,3 @@
+{
+ "ignoreRules": ["cjs-resolves-to-esm", "false-esm", "internal-resolution-error"]
+}
diff --git a/packages/nuxt/.gitignore b/packages/nuxt/.gitignore
new file mode 100644
index 000000000000..1e618527efd8
--- /dev/null
+++ b/packages/nuxt/.gitignore
@@ -0,0 +1,8 @@
+src/app/components/error-404.vue
+src/app/components/error-500.vue
+src/app/components/error-dev.vue
+src/app/components/welcome.vue
+src/core/runtime/nitro/handlers/error-500.ts
+src/core/runtime/nitro/handlers/error-dev.ts
+src/core/runtime/nitro/templates/error-500.ts
+src/core/runtime/nitro/templates/error-dev.ts
diff --git a/packages/nuxt/app.d.ts b/packages/nuxt/app.d.ts
new file mode 100644
index 000000000000..f313e6f7ec46
--- /dev/null
+++ b/packages/nuxt/app.d.ts
@@ -0,0 +1 @@
+export * from './dist/app/index.ts'
diff --git a/packages/nuxt/bin/nuxt.mjs b/packages/nuxt/bin/nuxt.mjs
new file mode 100755
index 000000000000..8c0237f4ee4b
--- /dev/null
+++ b/packages/nuxt/bin/nuxt.mjs
@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '@nuxt/cli/cli'
diff --git a/packages/nuxt/build.config.ts b/packages/nuxt/build.config.ts
new file mode 100644
index 000000000000..dcd6a87c301d
--- /dev/null
+++ b/packages/nuxt/build.config.ts
@@ -0,0 +1,38 @@
+import type { BuildEntry } from 'unbuild'
+import { defineBuildConfig } from 'unbuild'
+
+export default defineBuildConfig({
+ declaration: true,
+ entries: [
+ // Core
+ { input: 'src/index' },
+ // App
+ { input: 'src/app/', outDir: 'dist/app/', ext: 'js' },
+ // Runtime dirs
+ ...[
+ 'core',
+ 'head',
+ 'components',
+ 'pages',
+ 'compiler',
+ ].map(name => ({ input: `src/${name}/runtime/`, outDir: `dist/${name}/runtime`, format: 'esm', ext: 'js' } as BuildEntry)),
+ ],
+ hooks: {
+ 'mkdist:entry:options' (_ctx, _entry, mkdistOptions) {
+ mkdistOptions.addRelativeDeclarationExtensions = true
+ },
+ },
+ dependencies: [
+ '@nuxt/cli',
+ 'vue-router',
+ 'ofetch',
+ ],
+ externals: [
+ 'nuxt',
+ 'nuxt/schema',
+ '@vue/shared',
+ '@unhead/vue',
+ 'rolldown/experimental',
+ 'lightningcss',
+ ],
+})
diff --git a/packages/nuxt/config.cjs b/packages/nuxt/config.cjs
new file mode 100644
index 000000000000..f4540f1290a5
--- /dev/null
+++ b/packages/nuxt/config.cjs
@@ -0,0 +1,7 @@
+function defineNuxtConfig (config) {
+ return config
+}
+
+module.exports = {
+ defineNuxtConfig,
+}
diff --git a/packages/nuxt/config.d.ts b/packages/nuxt/config.d.ts
new file mode 100644
index 000000000000..528eb6eb914e
--- /dev/null
+++ b/packages/nuxt/config.d.ts
@@ -0,0 +1,8 @@
+import type { NuxtConfig, DefineNuxtConfig as _DefineNuxtConfig } from 'nuxt/schema'
+
+export { NuxtConfig } from 'nuxt/schema'
+
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type
+export interface DefineNuxtConfig extends _DefineNuxtConfig<NuxtConfig> {}
+
+export declare const defineNuxtConfig: DefineNuxtConfig
diff --git a/packages/nuxt/config.js b/packages/nuxt/config.js
new file mode 100644
index 000000000000..a063cde6ed7b
--- /dev/null
+++ b/packages/nuxt/config.js
@@ -0,0 +1,5 @@
+function defineNuxtConfig (config) {
+ return config
+}
+
+export { defineNuxtConfig }
diff --git a/packages/nuxt/index.d.ts b/packages/nuxt/index.d.ts
new file mode 100644
index 000000000000..f085bd5976eb
--- /dev/null
+++ b/packages/nuxt/index.d.ts
@@ -0,0 +1,20 @@
+declare global {
+ var __NUXT_VERSION__: string
+ var __NUXT_ASYNC_CONTEXT__: boolean
+
+ interface Navigator {
+ connection?: {
+ type: 'bluetooth' | 'cellular' | 'ethernet' | 'none' | 'wifi' | 'wimax' | 'other' | 'unknown'
+ effectiveType: 'slow-2g' | '2g' | '3g' | '4g'
+ }
+ }
+
+ interface Window {
+ cookieStore?: {
+ addEventListener: (type: 'change', listener: (event: any) => void) => void
+ removeEventListener: (type: 'change', listener: (event: any) => void) => void
+ }
+ }
+}
+
+export {}
diff --git a/packages/nuxt/kit.d.ts b/packages/nuxt/kit.d.ts
new file mode 100644
index 000000000000..4625be9a95bc
--- /dev/null
+++ b/packages/nuxt/kit.d.ts
@@ -0,0 +1 @@
+export * from '@nuxt/kit'
diff --git a/packages/nuxt/kit.js b/packages/nuxt/kit.js
new file mode 100644
index 000000000000..4625be9a95bc
--- /dev/null
+++ b/packages/nuxt/kit.js
@@ -0,0 +1 @@
+export * from '@nuxt/kit'
diff --git a/packages/nuxt/meta.d.ts b/packages/nuxt/meta.d.ts
new file mode 100644
index 000000000000..79871dad9a19
--- /dev/null
+++ b/packages/nuxt/meta.d.ts
@@ -0,0 +1 @@
+export const runtimeDependencies: string[]
diff --git a/packages/nuxt/meta.js b/packages/nuxt/meta.js
new file mode 100644
index 000000000000..4a65a050412c
--- /dev/null
+++ b/packages/nuxt/meta.js
@@ -0,0 +1,20 @@
+export const runtimeDependencies = [
+ // other deps
+ 'devalue',
+ 'klona',
+ 'unhead',
+ // deliberate exports from nitro builder
+ '@nuxt/nitro-server/h3',
+ // unjs ecosystem
+ 'defu',
+ 'ufo',
+ 'destr',
+ 'consola',
+ 'hookable',
+ 'unctx',
+ 'cookie-es',
+ 'perfect-debounce',
+ 'ohash',
+ 'pathe',
+ 'uncrypto',
+]
diff --git a/packages/nuxt/package.json b/packages/nuxt/package.json
new file mode 100644
index 000000000000..6db34ef5a6bc
--- /dev/null
+++ b/packages/nuxt/package.json
@@ -0,0 +1,141 @@
+{
+ "name": "nuxt",
+ "version": "4.3.1",
+ "repository": {
+ "type": "git",
+ "url": "git+https://github.com/nuxt/nuxt.git",
+ "directory": "packages/nuxt"
+ },
+ "homepage": "https://nuxt.com",
+ "description": "Nuxt is a free and open-source framework with an intuitive and extendable way to create type-safe, performant and production-grade full-stack web applications and websites with Vue.js.",
+ "license": "MIT",
+ "type": "module",
+ "types": "./types.d.ts",
+ "bin": {
+ "nuxi": "bin/nuxt.mjs",
+ "nuxt": "bin/nuxt.mjs"
+ },
+ "exports": {
+ ".": {
+ "types": "./types.d.mts",
+ "import": "./dist/index.mjs"
+ },
+ "./config": {
+ "types": "./config.d.ts",
+ "import": "./config.js",
+ "require": "./config.cjs"
+ },
+ "./schema": "./schema.js",
+ "./kit": "./kit.js",
+ "./meta": "./meta.js",
+ "./app": "./dist/app/index.js",
+ "./package.json": "./package.json"
+ },
+ "imports": {
+ "#app": "./dist/app/index.js",
+ "#app/nuxt": "./dist/app/nuxt.js",
+ "#unhead/composables": "./dist/head/runtime/composables.js",
+ "#pages/composables": "./dist/pages/runtime/composables.js"
+ },
+ "files": [
+ "app.d.ts",
+ "bin",
+ "types.d.ts",
+ "types.d.mts",
+ "dist",
+ "config.*",
+ "kit.*",
+ "meta.*",
+ "schema.*"
+ ],
+ "scripts": {
+ "prepack": "unbuild",
+ "build:stub": "unbuild --stub",
+ "test:attw": "attw --pack"
+ },
+ "dependencies": {
+ "@dxup/nuxt": "^0.4.1",
+ "@nuxt/cli": "^3.35.2",
+ "@nuxt/devtools": "^4.0.0-alpha.4",
+ "@nuxt/kit": "workspace:*",
+ "@nuxt/nitro-server": "workspace:*",
+ "@nuxt/schema": "workspace:*",
+ "@nuxt/telemetry": "^2.8.0",
+ "@nuxt/vite-builder": "workspace:*",
+ "@unhead/vue": "^3.1.0",
+ "@vue/shared": "^3.5.34",
+ "chokidar": "^5.0.0",
+ "compatx": "^0.2.0",
+ "consola": "^3.4.2",
+ "cookie-es": "^3.1.1",
+ "defu": "^6.1.7",
+ "devalue": "^5.8.1",
+ "errx": "^0.1.0",
+ "escape-string-regexp": "^5.0.0",
+ "exsolve": "^1.0.8",
+ "hookable": "^6.1.1",
+ "ignore": "^7.0.5",
+ "impound": "^1.1.5",
+ "jiti": "^2.7.0",
+ "klona": "^2.0.6",
+ "knitwork": "^1.3.0",
+ "magic-string": "^0.30.21",
+ "mlly": "^1.8.2",
+ "nanotar": "^0.3.0",
+ "ofetch": "^2.0.0-alpha.3",
+ "ohash": "^2.0.11",
+ "on-change": "^6.0.2",
+ "oxc-walker": "^1.0.0",
+ "pathe": "^2.0.3",
+ "perfect-debounce": "^2.1.0",
+ "picomatch": "^4.0.4",
+ "pkg-types": "^2.3.1",
+ "rolldown": "^1.0.2",
+ "rolldown-string": "^0.3.0",
+ "scule": "^1.3.0",
+ "semver": "^7.8.0",
+ "std-env": "^4.1.0",
+ "tinyglobby": "^0.2.16",
+ "ufo": "^1.6.4",
+ "ultrahtml": "^1.6.0",
+ "uncrypto": "^0.1.3",
+ "unctx": "^2.5.0",
+ "unhead": "^3.1.0",
+ "unimport": "^6.3.0",
+ "unplugin": "^3.0.0",
+ "unrouting": "^0.1.7",
+ "untyped": "^2.0.0",
+ "vue": "^3.5.34",
+ "vue-router": "^5.0.7"
+ },
+ "devDependencies": {
+ "@nuxt/scripts": "1.1.0",
+ "@oxc-project/types": "0.131.0",
+ "@parcel/watcher": "2.5.6",
+ "@types/estree": "1.0.9",
+ "@types/picomatch": "4.0.3",
+ "@vitejs/plugin-vue": "6.0.7",
+ "@vitejs/plugin-vue-jsx": "5.1.5",
+ "@vue/compiler-sfc": "3.5.34",
+ "unbuild": "3.6.1",
+ "vite": "8.0.12",
+ "vitest": "4.1.7",
+ "vue-bundle-renderer": "2.2.0",
+ "vue-sfc-transformer": "0.1.17"
+ },
+ "peerDependencies": {
+ "@parcel/watcher": "^2.1.0",
+ "@types/node": ">=18.12.0"
+ },
+ "peerDependenciesMeta": {
+ "@parcel/watcher": {
+ "optional": true
+ },
+ "@types/node": {
+ "optional": true
+ }
+ },
+ "engines": {
+ "node": "^22.12.0 || ^24.11.0 || >=26.0.0"
+ }
+}
diff --git a/packages/nuxt/schema.d.ts b/packages/nuxt/schema.d.ts
new file mode 100644
index 000000000000..a6a3e9a9d20e
--- /dev/null
+++ b/packages/nuxt/schema.d.ts
@@ -0,0 +1,36 @@
+import type {
+ AppConfig as _AppConfig,
+ ConfigSchema as _ConfigSchema,
+ CustomAppConfig as _CustomAppConfig,
+ ModuleDependencies as _ModuleDependencies,
+ NuxtConfig as _NuxtConfig,
+ NuxtDebugOptions as _NuxtDebugOptions,
+ NuxtHooks as _NuxtHooks,
+ NuxtOptions as _NuxtOptions,
+ NuxtPage as _NuxtPage,
+ ViteOptions as _ViteOptions,
+} from '@nuxt/schema'
+
+export * from '@nuxt/schema'
+
+// Bridge augmentations to `@nuxt/schema` into `nuxt/schema`'s module identity so
+// that users and modules only need to augment one of the two surfaces.
+declare module 'nuxt/schema' {
+ // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ interface NuxtHooks extends _NuxtHooks {}
+ interface NuxtConfig extends _NuxtConfig { hooks?: Partial<NuxtHooks> }
+ interface NuxtOptions extends _NuxtOptions { hooks: NuxtHooks }
+ interface ConfigSchema extends _ConfigSchema { hooks: NuxtHooks }
+ // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ interface AppConfig extends _AppConfig {}
+ // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ interface CustomAppConfig extends _CustomAppConfig {}
+ // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ interface ModuleDependencies extends _ModuleDependencies {}
+ // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ interface NuxtPage extends _NuxtPage {}
+ // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ interface NuxtDebugOptions extends _NuxtDebugOptions {}
+ // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ interface ViteOptions extends _ViteOptions {}
+}
diff --git a/packages/nuxt/schema.js b/packages/nuxt/schema.js
new file mode 100644
index 000000000000..b5c423e91606
--- /dev/null
+++ b/packages/nuxt/schema.js
@@ -0,0 +1 @@
+export * from '@nuxt/schema'
diff --git a/packages/nuxt/src/app/compat/capi.ts b/packages/nuxt/src/app/compat/capi.ts
new file mode 100644
index 000000000000..28d7e29d4834
--- /dev/null
+++ b/packages/nuxt/src/app/compat/capi.ts
@@ -0,0 +1,21 @@
+export * from 'vue'
+
+export const install = (): void => {}
+
+export function set<T> (target: any, key: string | number | symbol, val: T): T {
+ if (Array.isArray(target)) {
+ target.length = Math.max(target.length, key as number)
+ target.splice(key as number, 1, val)
+ return val
+ }
+ target[key] = val
+ return val
+}
+
+export function del (target: any, key: string | number | symbol): void {
+ if (Array.isArray(target)) {
+ target.splice(key as number, 1)
+ return
+ }
+ delete target[key]
+}
diff --git a/packages/nuxt/src/app/compat/idle-callback.ts b/packages/nuxt/src/app/compat/idle-callback.ts
new file mode 100644
index 000000000000..12e01230e737
--- /dev/null
+++ b/packages/nuxt/src/app/compat/idle-callback.ts
@@ -0,0 +1,16 @@
+// Polyfills for Safari support
+// https://caniuse.com/requestidlecallback
+export const requestIdleCallback: Window['requestIdleCallback'] = import.meta.server
+ ? (() => {}) as any
+ : (globalThis.requestIdleCallback || ((cb) => {
+ const start = Date.now()
+ const idleDeadline = {
+ didTimeout: false,
+ timeRemaining: () => Math.max(0, 50 - (Date.now() - start)),
+ }
+ return setTimeout(() => { cb(idleDeadline) }, 1)
+ }))
+
+export const cancelIdleCallback: Window['cancelIdleCallback'] = import.meta.server
+ ? (() => {}) as any
+ : (globalThis.cancelIdleCallback || ((id) => { clearTimeout(id) }))
diff --git a/packages/nuxt/src/app/compat/interval.ts b/packages/nuxt/src/app/compat/interval.ts
new file mode 100644
index 000000000000..33144e60f660
--- /dev/null
+++ b/packages/nuxt/src/app/compat/interval.ts
@@ -0,0 +1,16 @@
+import { createError } from '../composables/error'
+
+const intervalError = '[nuxt] `setInterval` should not be used on the server. Consider wrapping it with an `onNuxtReady`, `onBeforeMount` or `onMounted` lifecycle hook, or ensure you only call it in the browser by checking `import.meta.client`.'
+
+export const setInterval: typeof globalThis.setInterval = import.meta.client
+ ? globalThis.setInterval
+ : (() => {
+ if (import.meta.dev) {
+ throw createError({
+ status: 500,
+ message: intervalError,
+ })
+ }
+
+ console.error(intervalError)
+ }) as any
diff --git a/packages/nuxt/src/app/compat/vue-demi.ts b/packages/nuxt/src/app/compat/vue-demi.ts
new file mode 100644
index 000000000000..c54dba1fe5ca
--- /dev/null
+++ b/packages/nuxt/src/app/compat/vue-demi.ts
@@ -0,0 +1,5 @@
+export * from './capi'
+
+export const Vue2 = undefined
+export const isVue2 = false
+export const isVue3 = true
diff --git a/packages/nuxt/src/app/components/client-fallback.client.ts b/packages/nuxt/src/app/components/client-fallback.client.ts
new file mode 100644
index 000000000000..8a8b89150ede
--- /dev/null
+++ b/packages/nuxt/src/app/components/client-fallback.client.ts
@@ -0,0 +1,75 @@
+import { Fragment, createElementBlock, defineComponent, h, onMounted, shallowRef, useId } from 'vue'
+import type { DefineSetupFnComponent, SlotsType, VNode } from 'vue'
+import { useState } from '../composables/state'
+
+const VALID_TAG_RE = /^[a-z][a-z0-9-]*$/i
+function sanitizeTag (tag: string, fallback: string): string {
+ return VALID_TAG_RE.test(tag) ? tag : fallback
+}
+
+interface NuxtClientFallbackProps {
+ fallbackTag?: string
+ fallback?: string
+ placeholder?: string
+ placeholderTag?: string
+ keepFallback?: boolean
+}
+
+type NuxtClientFallbackEmits = {
+ 'ssr-error': (error: unknown) => void
+}
+
+type NuxtClientFallbackSlots = SlotsType<{
+ default?: () => VNode[]
+ fallback?: () => VNode[]
+ placeholder?: () => VNode[]
+}>
+
+const NuxtClientFallbackClient = defineComponent({
+ name: 'NuxtClientFallback',
+ inheritAttrs: false,
+ props: {
+ fallbackTag: {
+ type: String,
+ default: () => 'div',
+ },
+ fallback: {
+ type: String,
+ default: () => '',
+ },
+ placeholder: {
+ type: String,
+ },
+ placeholderTag: {
+ type: String,
+ },
+ keepFallback: {
+ type: Boolean,
+ default: () => false,
+ },
+ },
+ emits: ['ssr-error'],
+ setup (props, ctx) {
+ const mounted = shallowRef(false)
+ const ssrFailed = useState(useId())
+
+ if (ssrFailed.value) {
+ onMounted(() => { mounted.value = true })
+ }
+
+ return () => {
+ if (ssrFailed.value) {
+ if (!mounted.value || props.keepFallback) {
+ const slot = ctx.slots.placeholder || ctx.slots.fallback
+ if (slot) { return h(Fragment, null, slot()) }
+ const fallbackStr = props.placeholder || props.fallback
+ const fallbackTag = sanitizeTag(props.placeholderTag || props.fallbackTag, 'div')
+ return createElementBlock(fallbackTag, null, fallbackStr)
+ }
+ }
+ return h(Fragment, null, ctx.slots.default?.())
+ }
+ },
+}) as unknown as DefineSetupFnComponent<NuxtClientFallbackProps, NuxtClientFallbackEmits, NuxtClientFallbackSlots>
+
+export default NuxtClientFallbackClient
diff --git a/packages/nuxt/src/app/components/client-fallback.server.ts b/packages/nuxt/src/app/components/client-fallback.server.ts
new file mode 100644
index 000000000000..e57b3b902cc3
--- /dev/null
+++ b/packages/nuxt/src/app/components/client-fallback.server.ts
@@ -0,0 +1,114 @@
+import { defineComponent, getCurrentInstance, onErrorCaptured, shallowRef, useId } from 'vue'
+import type { DefineSetupFnComponent, SlotsType, VNode } from 'vue'
+import { ssrRenderAttrs, ssrRenderSlot, ssrRenderVNode } from 'vue/server-renderer'
+
+import { isPromise } from '@vue/shared'
+import { useState } from '../composables/state'
+import { createBuffer } from './utils'
+
+const VALID_TAG_RE = /^[a-z][a-z0-9-]*$/i
+function sanitizeTag (tag: string, fallback: string): string {
+ return VALID_TAG_RE.test(tag) ? tag : fallback
+}
+
+interface NuxtClientFallbackProps {
+ fallbackTag?: string
+ fallback?: string
+ placeholder?: string
+ placeholderTag?: string
+ keepFallback?: boolean
+}
+
+type NuxtClientFallbackEmits = {
+ 'ssr-error': (error: unknown) => void
+}
+
+type NuxtClientFallbackSlots = SlotsType<{
+ default?: () => VNode[]
+ fallback?: () => VNode[]
+ placeholder?: () => VNode[]
+}>
+
+const NuxtClientFallbackServer = defineComponent({
+ name: 'NuxtClientFallback',
+ inheritAttrs: false,
+ props: {
+ fallbackTag: {
+ type: String,
+ default: () => 'div',
+ },
+ fallback: {
+ type: String,
+ default: () => '',
+ },
+ placeholder: {
+ type: String,
+ },
+ placeholderTag: {
+ type: String,
+ },
+ keepFallback: {
+ type: Boolean,
+ default: () => false,
+ },
+ },
+ emits: {
+ 'ssr-error' (_error: unknown) {
+ return true
+ },
+ },
+ async setup (_, ctx) {
+ const vm = getCurrentInstance()
+ const ssrFailed = shallowRef(false)
+ const error = useState<boolean | undefined>(useId())
+
+ onErrorCaptured((err) => {
+ error.value = true
+ ssrFailed.value = true
+ ctx.emit('ssr-error', err)
+ return false
+ })
+
+ try {
+ const defaultSlot = ctx.slots.default?.()
+ const ssrVNodes = createBuffer()
+
+ if (defaultSlot) {
+ for (let i = 0; i < defaultSlot.length; i++) {
+ ssrRenderVNode(ssrVNodes.push, defaultSlot[i]!, vm!)
+ }
+ }
+
+ const buffer = ssrVNodes.getBuffer()
+ if (buffer.hasAsync) {
+ await Promise.all((buffer as unknown[]).flat(Infinity).filter(isPromise))
+ }
+
+ return { ssrFailed, ssrVNodes }
+ } catch (ssrError) {
+ // catch in dev
+ error.value = true
+ ctx.emit('ssr-error', ssrError)
+ return { ssrFailed: true, ssrVNodes: [] }
+ }
+ },
+ ssrRender (ctx: any, push: any, parent: any) {
+ if (ctx.ssrFailed) {
+ const { fallback, placeholder } = ctx.$slots
+ if (fallback || placeholder) {
+ ssrRenderSlot(ctx.$slots, fallback ? 'fallback' : 'placeholder', {}, null, push, parent)
+ } else {
+ const content = ctx.placeholder || ctx.fallback
+ const tag = sanitizeTag(ctx.placeholderTag || ctx.fallbackTag, 'div')
+ push(`<${tag}${ssrRenderAttrs(ctx.$attrs)}>${content}</${tag}>`)
+ }
+ } else {
+ // push Fragment markup
+ push('<!--[-->')
+ push(ctx.ssrVNodes.getBuffer())
+ push('<!--]-->')
+ }
+ },
+}) as unknown as DefineSetupFnComponent<NuxtClientFallbackProps, NuxtClientFallbackEmits, NuxtClientFallbackSlots>
+
+export default NuxtClientFallbackServer
diff --git a/packages/nuxt/src/app/components/client-only.ts b/packages/nuxt/src/app/components/client-only.ts
new file mode 100644
index 000000000000..d6de09df0b03
--- /dev/null
+++ b/packages/nuxt/src/app/components/client-only.ts
@@ -0,0 +1,185 @@
+import { cloneVNode, createCommentVNode, createElementBlock, defineComponent, getCurrentInstance, h, onMounted, provide, shallowRef } from 'vue'
+import type { Component, ComponentInternalInstance, ComponentOptions, DefineSetupFnComponent, InjectionKey, RendererNode, SlotsType, VNode } from 'vue'
+import { isPromise } from '@vue/shared'
+import { useNuxtApp } from '../nuxt'
+import ServerPlaceholder from './server-placeholder'
+import { elToStaticVNode } from './utils'
+
+// @ts-expect-error virtual file
+import { clientNodePlaceholder } from '#build/nuxt.config.mjs'
+
+export const clientOnlySymbol: InjectionKey<boolean> = Symbol.for('nuxt:client-only')
+
+const STATIC_DIV = '<div></div>'
+
+function isPlaceholderComment (el: RendererNode) {
+ return el.nodeName === '#comment' && el.nodeValue === 'placeholder'
+}
+
+function createPlaceholder (el?: RendererNode | null) {
+ if (el && !isPlaceholderComment(el)) {
+ return elToStaticVNode(el, STATIC_DIV)
+ }
+ return clientNodePlaceholder ? createCommentVNode('placeholder') : h('div')
+}
+
+interface ClientOnlyProps {
+ fallback?: string
+ placeholder?: string
+ placeholderTag?: string
+ fallbackTag?: string
+}
+
+type ClientOnlySlots = SlotsType<{
+ default?: () => VNode[]
+ /**
+ * Specify a content to be rendered on the server and displayed until `<ClientOnly>` is mounted in the browser.
+ */
+ fallback?: () => VNode[]
+ placeholder?: () => VNode[]
+}>
+
+const ClientOnly = defineComponent({
+ name: 'ClientOnly',
+ inheritAttrs: false,
+ props: ['fallback', 'placeholder', 'placeholderTag', 'fallbackTag'],
+ ...(import.meta.dev && {
+ slots: Object as ClientOnlySlots,
+ }),
+ setup (props, { slots, attrs }) {
+ const mounted = shallowRef(false)
+ onMounted(() => { mounted.value = true })
+ // Bail out of checking for pages/layouts as they might be included under `<ClientOnly>` 🤷♂️
+ if (import.meta.dev) {
+ const nuxtApp = useNuxtApp()
+ nuxtApp._isNuxtPageUsed = true
+ nuxtApp._isNuxtLayoutUsed = true
+ }
+ const vm = getCurrentInstance()
+ if (vm) {
+ vm._nuxtClientOnly = true
+ }
+ provide(clientOnlySymbol, true)
+ return () => {
+ if (mounted.value) {
+ const vnodes = slots.default?.()
+ if (vnodes && vnodes.length === 1) {
+ return [cloneVNode(vnodes[0]!, attrs)]
+ }
+ return vnodes
+ }
+ const slot = slots.fallback || slots.placeholder
+ if (slot) { return h(slot) }
+ const fallbackStr = props.fallback || props.placeholder || ''
+ const fallbackTag = props.fallbackTag || props.placeholderTag || 'span'
+ return createElementBlock(fallbackTag, attrs, fallbackStr)
+ }
+ },
+}) as unknown as DefineSetupFnComponent<ClientOnlyProps, {}, ClientOnlySlots>
+
+export default ClientOnly
+
+const cache = new WeakMap()
+
+/* @__NO_SIDE_EFFECTS__ */
+export function createClientOnly<T extends ComponentOptions> (component: T): Component {
+ if (import.meta.server) {
+ return ServerPlaceholder
+ }
+ if (cache.has(component)) {
+ return cache.get(component)
+ }
+
+ const clone = { ...component }
+
+ if (clone.render) {
+ // override the component render (non script setup component) or dev mode
+ clone.render = (ctx: any, cache: any, $props: any, $setup: any, $data: any, $options: any) => {
+ if ($setup.mounted$ ?? ctx.mounted$) {
+ const res = component.render?.bind(ctx)(ctx, cache, $props, $setup, $data, $options)
+ return (res.children === null || typeof res.children === 'string')
+ ? cloneVNode(res)
+ : h(res)
+ }
+ return createPlaceholder(ctx._.vnode.el)
+ }
+ } else {
+ // handle runtime-compiler template
+ const placeholderTemplate = clientNodePlaceholder ? '<!--placeholder-->' : '<div></div>'
+ clone.template &&= `
+ <template v-if="mounted$">${component.template}</template>
+ <template v-else>${placeholderTemplate}</template>
+ `
+ }
+
+ clone.setup = (props, ctx) => {
+ const nuxtApp = useNuxtApp()
+ const mounted$ = shallowRef(nuxtApp.isHydrating === false)
+ const instance = getCurrentInstance()!
+
+ if (nuxtApp.isHydrating) {
+ const attrs = { ...instance.attrs }
+ // remove existing directives during hydration
+ const directives = extractDirectives(instance)
+ // prevent attrs inheritance since a staticVNode is rendered before hydration
+ for (const key in attrs) {
+ delete instance.attrs[key]
+ }
+
+ onMounted(() => {
+ Object.assign(instance.attrs, attrs)
+ instance.vnode.dirs = directives
+ })
+ }
+
+ onMounted(() => {
+ mounted$.value = true
+ })
+ const setupState = component.setup?.(props, ctx) || {}
+
+ if (isPromise(setupState)) {
+ return Promise.resolve(setupState).then((setupState) => {
+ if (typeof setupState !== 'function') {
+ setupState ||= {}
+ setupState.mounted$ = mounted$
+ return setupState
+ }
+ return (...args: any[]) => {
+ if (mounted$.value || !nuxtApp.isHydrating) {
+ const res = setupState(...args)
+ return (res.children === null || typeof res.children === 'string')
+ ? cloneVNode(res)
+ : h(res)
+ }
+ return createPlaceholder(instance?.vnode.el)
+ }
+ })
+ } else {
+ if (typeof setupState === 'function') {
+ return (...args: any[]) => {
+ if (mounted$.value) {
+ const res = setupState(...args)
+ const attrs = clone.inheritAttrs !== false ? ctx.attrs : undefined
+
+ return (res.children === null || typeof res.children === 'string')
+ ? cloneVNode(res, attrs)
+ : h(res, attrs)
+ }
+ return createPlaceholder(instance?.vnode.el)
+ }
+ }
+ return Object.assign(setupState, { mounted$ })
+ }
+ }
+
+ cache.set(component, clone)
+
+ return clone
+}
+
+function extractDirectives (instance: ComponentInternalInstance | null) {
+ if (!instance || !instance.vnode.dirs) { return null }
+ const directives = instance.vnode.dirs
+ instance.vnode.dirs = null
+ return directives
+}
diff --git a/packages/nuxt/src/app/components/dev-only.ts b/packages/nuxt/src/app/components/dev-only.ts
new file mode 100644
index 000000000000..ee387e86d145
--- /dev/null
+++ b/packages/nuxt/src/app/components/dev-only.ts
@@ -0,0 +1,26 @@
+import { defineComponent } from 'vue'
+import type { DefineSetupFnComponent, SlotsType, VNode } from 'vue'
+
+type DevOnlySlots = SlotsType<{
+ default?: () => VNode[]
+ /**
+ * If you ever require to have a replacement during production.
+ */
+ fallback?: () => VNode[]
+}>
+
+const DevOnly = defineComponent({
+ name: 'DevOnly',
+ inheritAttrs: false,
+ ...(import.meta.dev && {
+ slots: Object as DevOnlySlots,
+ }),
+ setup (_, props) {
+ if (import.meta.dev) {
+ return () => props.slots.default?.()
+ }
+ return () => props.slots.fallback?.()
+ },
+}) as unknown as DefineSetupFnComponent<{}, {}, DevOnlySlots>
+
+export default DevOnly
diff --git a/packages/nuxt/src/app/components/index.ts b/packages/nuxt/src/app/components/index.ts
new file mode 100644
index 000000000000..b265fba93b02
--- /dev/null
+++ b/packages/nuxt/src/app/components/index.ts
@@ -0,0 +1,5 @@
+// defineNuxtLink
+export { defineNuxtLink } from './nuxt-link'
+export type { NuxtLinkOptions, NuxtLinkProps } from './nuxt-link'
+
+export type { NuxtTimeProps } from './nuxt-time.vue'
diff --git a/packages/nuxt/src/app/components/injections.ts b/packages/nuxt/src/app/components/injections.ts
new file mode 100644
index 000000000000..3f9660e60755
--- /dev/null
+++ b/packages/nuxt/src/app/components/injections.ts
@@ -0,0 +1,10 @@
+import type { InjectionKey } from 'vue'
+import type { RouteLocationNormalizedLoaded } from 'vue-router'
+
+export interface LayoutMeta {
+ isCurrent: (route: RouteLocationNormalizedLoaded) => boolean
+}
+
+export const LayoutMetaSymbol: InjectionKey<LayoutMeta> = Symbol('layout-meta')
+
+export const PageRouteSymbol: InjectionKey<RouteLocationNormalizedLoaded> = Symbol('route')
diff --git a/packages/nuxt/src/app/components/island-renderer.ts b/packages/nuxt/src/app/components/island-renderer.ts
new file mode 100644
index 000000000000..650c777a4011
--- /dev/null
+++ b/packages/nuxt/src/app/components/island-renderer.ts
@@ -0,0 +1,39 @@
+import type { DefineSetupFnComponent, defineAsyncComponent } from 'vue'
+import { createVNode, defineComponent, onErrorCaptured } from 'vue'
+
+import { createError } from '../composables/error'
+
+// @ts-expect-error virtual file
+import { islandComponents } from '#build/components.islands.mjs'
+
+interface IslandRendererProps {
+ context: { name: string, props?: Record<string, any> }
+}
+
+const IslandRenderer = defineComponent({
+ name: 'IslandRenderer',
+ props: {
+ context: {
+ type: Object as () => { name: string, props?: Record<string, any> },
+ required: true,
+ },
+ },
+ setup (props) {
+ const component = islandComponents[props.context.name] as ReturnType<typeof defineAsyncComponent>
+
+ if (!component) {
+ throw createError({
+ status: 404,
+ statusText: `Island component not found: ${props.context.name}`,
+ })
+ }
+
+ onErrorCaptured((e) => {
+ console.log(e)
+ })
+
+ return () => createVNode(component || 'span', { ...props.context.props, 'data-island-uid': '' })
+ },
+}) as unknown as DefineSetupFnComponent<IslandRendererProps>
+
+export default IslandRenderer
diff --git a/packages/nuxt/src/app/components/nuxt-announcer.ts b/packages/nuxt/src/app/components/nuxt-announcer.ts
new file mode 100644
index 000000000000..96d20322ba18
--- /dev/null
+++ b/packages/nuxt/src/app/components/nuxt-announcer.ts
@@ -0,0 +1,76 @@
+import { computed, defineComponent, h } from 'vue'
+import type { DefineSetupFnComponent, SlotsType, VNode } from 'vue'
+import type { AnnouncerPoliteness } from '../composables/announcer'
+import { useAnnouncer } from '../composables/announcer'
+
+interface NuxtAnnouncerProps {
+ atomic?: boolean
+ politeness?: AnnouncerPoliteness
+}
+
+type NuxtAnnouncerSlots = SlotsType<{
+ default?: (props: { message: string }) => VNode[]
+}>
+
+const NuxtAnnouncer = defineComponent({
+ name: 'NuxtAnnouncer',
+ props: {
+ atomic: {
+ type: Boolean,
+ default: true,
+ },
+ politeness: {
+ type: String as () => AnnouncerPoliteness,
+ default: 'polite',
+ },
+ },
+ setup (props, { slots, expose }) {
+ const { set, polite, assertive, message, politeness } = useAnnouncer({
+ politeness: props.politeness,
+ })
+
+ const role = computed(() => {
+ if (politeness.value === 'assertive') {
+ return 'alert'
+ }
+ if (politeness.value === 'off') {
+ return undefined
+ }
+ return 'status'
+ })
+
+ expose({
+ set,
+ polite,
+ assertive,
+ message,
+ politeness,
+ })
+
+ return () => h('span', {
+ class: 'nuxt-announcer',
+ style: {
+ position: 'absolute',
+ },
+ }, h('span', {
+ 'role': role.value,
+ 'aria-live': politeness.value,
+ 'aria-atomic': props.atomic,
+ 'style': {
+ 'border': '0',
+ 'clip': 'rect(0 0 0 0)',
+ 'clip-path': 'inset(50%)',
+ 'height': '1px',
+ 'width': '1px',
+ 'overflow': 'hidden',
+ 'position': 'absolute',
+ 'white-space': 'nowrap',
+ 'word-wrap': 'normal',
+ 'margin': '-1px',
+ 'padding': '0',
+ },
+ }, slots.default ? slots.default({ message: message.value }) : message.value))
+ },
+}) as unknown as DefineSetupFnComponent<NuxtAnnouncerProps, {}, NuxtAnnouncerSlots>
+
+export default NuxtAnnouncer
diff --git a/packages/nuxt/src/app/components/nuxt-error-boundary.vue b/packages/nuxt/src/app/components/nuxt-error-boundary.vue
new file mode 100644
index 000000000000..798883040d22
--- /dev/null
+++ b/packages/nuxt/src/app/components/nuxt-error-boundary.vue
@@ -0,0 +1,64 @@
+<template>
+ <slot
+ v-if="error"
+ v-bind="{ error, clearError }"
+ name="error"
+ />
+
+ <slot
+ v-else
+ name="default"
+ />
+</template>
+
+<script setup lang="ts">
+import { onErrorCaptured, shallowRef } from 'vue'
+import { useNuxtApp } from '../nuxt'
+import { onNuxtReady } from '../composables/ready'
+
+defineOptions({
+ name: 'NuxtErrorBoundary',
+ inheritAttrs: false,
+})
+
+const emit = defineEmits<{
+ error: [error: Error]
+}>()
+
+defineSlots<{
+ error(props: { error: Error, clearError: () => void }): any
+ default(): any
+}>()
+
+const error = shallowRef<Error | null>(null)
+
+function clearError () {
+ error.value = null
+}
+
+if (import.meta.client) {
+ const nuxtApp = useNuxtApp()
+
+ function handleError (...args: Parameters<Parameters<typeof onErrorCaptured<Error>>[0]>) {
+ const [err, instance, info] = args
+
+ emit('error', err)
+
+ nuxtApp.hooks.callHook('vue:error', err, instance, info)
+
+ error.value = err
+ }
+
+ onErrorCaptured((err, instance, info) => {
+ if (!nuxtApp.isHydrating) {
+ handleError(err, instance, info)
+ } else {
+ onNuxtReady(() => handleError(err, instance, info))
+ }
+
+ return false
+ })
+}
+
+defineExpose({ error, clearError })
+</script>
diff --git a/packages/nuxt/src/app/components/nuxt-error-page.vue b/packages/nuxt/src/app/components/nuxt-error-page.vue
new file mode 100644
index 000000000000..5bc88cd12a37
--- /dev/null
+++ b/packages/nuxt/src/app/components/nuxt-error-page.vue
@@ -0,0 +1,49 @@
+<template>
+ <ErrorTemplate v-bind="{ status, statusText, description, stack }" />
+</template>
+
+<script setup>
+import { defineAsyncComponent } from 'vue'
+// eslint-disable-next-line vue/prefer-import-from-vue
+import { escapeHtml } from '@vue/shared'
+
+const props = defineProps({
+ error: Object,
+})
+
+// Deliberately prevent reactive update when error is cleared
+const _error = props.error
+
+// TODO: extract to a separate utility
+const stacktrace = import.meta.dev && _error.stack
+ ? _error.stack
+ .split('\n')
+ .splice(1)
+ .map((line) => {
+ const text = line
+ .replace('webpack:/', '')
+ .replace('.vue', '.js') // TODO: Support sourcemap
+ .trim()
+ return {
+ text,
+ internal: (line.includes('node_modules') && !line.includes('.cache')) ||
+ line.includes('internal') ||
+ line.includes('new Promise'),
+ }
+ }).map(i => `<span class="stack${i.internal ? ' internal' : ''}">${escapeHtml(i.text)}</span>`).join('\n')
+ : ''
+
+// Error page props
+const status = Number(_error.status || 500)
+const is404 = status === 404
+
+const statusText = _error.statusText ?? (is404 ? 'Page Not Found' : 'Internal Server Error')
+const description = _error.message || _error.toString()
+const stack = import.meta.dev && !is404 ? _error.description || `<pre>${stacktrace}</pre>` : undefined
+
+// TODO: Investigate side-effect issue with imports
+const _Error404 = defineAsyncComponent(() => import('./error-404.vue'))
+const _Error = defineAsyncComponent(() => import('./error-500.vue'))
+
+const ErrorTemplate = is404 ? _Error404 : _Error
+</script>
diff --git a/packages/nuxt/src/app/components/nuxt-island.ts b/packages/nuxt/src/app/components/nuxt-island.ts
new file mode 100644
index 000000000000..1d46bae4e849
--- /dev/null
+++ b/packages/nuxt/src/app/components/nuxt-island.ts
@@ -0,0 +1,380 @@
+import type { Component, DefineSetupFnComponent, PropType, RendererNode, SlotsType, VNode } from 'vue'
+import { Fragment, Teleport, computed, createStaticVNode, createVNode, defineComponent, getCurrentInstance, h, nextTick, onBeforeUnmount, onMounted, ref, shallowRef, toRaw, watch, withMemo } from 'vue'
+import { debounce } from 'perfect-debounce'
+import type { ActiveHeadEntry, SerializableHead } from '@unhead/vue'
+import { randomUUID } from 'uncrypto'
+import { joinURL, withQuery } from 'ufo'
+
+import type { NuxtIslandResponse } from '../types'
+import { useNuxtApp, useRuntimeConfig } from '../nuxt'
+import { createError } from '../composables/error'
+import { prerenderRoutes, useRequestEvent } from '../composables/ssr'
+import { injectHead } from '../composables/head'
+import { getFragmentHTML, isEndFragment, isStartFragment } from './utils'
+import { computeIslandHash, filterIslandProps } from '../island-hash'
+
+// @ts-expect-error virtual file
+import { appBaseURL, remoteComponentIslands, selectiveClient } from '#build/nuxt.config.mjs'
+
+const pKey = '_islandPromises'
+const SSR_UID_RE = /data-island-uid="([^"]*)"/
+const DATA_ISLAND_UID_RE = /data-island-uid(="")?(?!="[^"])/g
+const SLOTNAME_RE = /data-island-slot="([^"]*)"/g
+const SLOT_FALLBACK_RE = / data-island-slot="([^"]*)"[^>]*>/g
+const ISLAND_SCOPE_ID_RE = /^<[^> ]*/
+
+let id = 1
+const getId = import.meta.client ? () => (id++).toString() : randomUUID
+
+const components = import.meta.client ? new Map<string, Component>() : undefined
+
+async function loadComponents (source = appBaseURL, paths: NuxtIslandResponse['components']) {
+ if (!paths) { return }
+
+ const promises: Array<Promise<void>> = []
+
+ for (const [component, item] of Object.entries(paths)) {
+ if (!(components!.has(component))) {
+ promises.push((async () => {
+ const chunkSource = joinURL(source, item.chunk)
+ const c = await import(/* @vite-ignore */ chunkSource).then(m => m.default || m)
+ components!.set(component, c)
+ })())
+ }
+ }
+
+ await Promise.all(promises)
+}
+
+interface NuxtIslandProps {
+ name: string
+ lazy?: boolean
+ props?: Record<string, any>
+ context?: Record<string, any>
+ scopeId?: string | undefined | null
+ source?: string
+ dangerouslyLoadClientComponents?: boolean
+}
+
+type NuxtIslandEmits = {
+ error: (error: unknown) => void
+}
+
+type NuxtIslandSlots = SlotsType<{
+ fallback?: (props: { error: unknown }) => VNode[]
+ [name: string]: ((props: any) => VNode[]) | undefined
+}>
+
+const NuxtIsland = defineComponent({
+ name: 'NuxtIsland',
+ inheritAttrs: false,
+ props: {
+ name: {
+ type: String,
+ required: true,
+ },
+ lazy: Boolean,
+ props: {
+ type: Object,
+ default: () => undefined,
+ },
+ context: {
+ type: Object,
+ default: () => ({}),
+ },
+ scopeId: {
+ type: String as PropType<string | undefined | null>,
+ default: () => undefined,
+ },
+ source: {
+ type: String,
+ default: () => undefined,
+ },
+ dangerouslyLoadClientComponents: {
+ type: Boolean,
+ default: false,
+ },
+ },
+ emits: ['error'],
+ async setup (props, { slots, expose, emit }) {
+ let canTeleport = import.meta.server
+ const teleportKey = shallowRef(0)
+ const key = shallowRef(0)
+ const canLoadClientComponent = computed(() => selectiveClient && (props.dangerouslyLoadClientComponents || !props.source))
+ const error = ref<unknown>(null)
+ const config = useRuntimeConfig()
+ const nuxtApp = useNuxtApp()
+ const filteredProps = computed(() => filterIslandProps(props.props))
+ const hashId = computed(() => computeIslandHash(props.name, filteredProps.value, props.context, props.source))
+ const instance = getCurrentInstance()!
+ const event = useRequestEvent()
+
+ let activeHead: ActiveHeadEntry<SerializableHead>
+
+ const mounted = shallowRef(false)
+ onMounted(() => { mounted.value = true; teleportKey.value++ })
+ onBeforeUnmount(() => { if (activeHead) { activeHead.dispose() } })
+ function setPayload (key: string, result: NuxtIslandResponse) {
+ const toRevive: Partial<NuxtIslandResponse> = {}
+ if (result.props) { toRevive.props = result.props }
+ if (result.slots) { toRevive.slots = result.slots }
+ if (result.components) { toRevive.components = result.components }
+ if (result.head) { toRevive.head = result.head }
+ nuxtApp.payload.data[key] = {
+ __nuxt_island: {
+ key,
+ ...(import.meta.server && import.meta.prerender)
+ ? {}
+ : { params: { ...props.context, props: props.props ? JSON.stringify(props.props) : undefined } },
+ result: toRevive,
+ },
+ ...result,
+ }
+ }
+
+ const payloads: Partial<Pick<NuxtIslandResponse, 'slots' | 'components'>> = {}
+
+ if (instance.vnode.el) {
+ const slots = toRaw(nuxtApp.payload.data[`${props.name}_${hashId.value}`])?.slots
+ if (slots) { payloads.slots = slots }
+ if (selectiveClient) {
+ const components = toRaw(nuxtApp.payload.data[`${props.name}_${hashId.value}`])?.components
+ if (components) { payloads.components = components }
+ }
+ }
+
+ const ssrHTML = ref<string>('')
+
+ if (import.meta.client && instance.vnode?.el) {
+ if (import.meta.dev) {
+ let currentEl = instance.vnode.el
+ let startEl: RendererNode | null = null
+ let isFirstElement = true
+
+ while (currentEl) {
+ if (isEndFragment(currentEl)) {
+ if (startEl !== currentEl.previousSibling) {
+ console.warn(`[\`Server components(and islands)\`] "${props.name}" must have a single root element. (HTML comments are considered elements as well.)`)
+ }
+ break
+ } else if (!isStartFragment(currentEl) && isFirstElement) {
+ // find first non-comment node
+ isFirstElement = false
+ if (currentEl.nodeType === 1) {
+ startEl = currentEl
+ }
+ }
+ currentEl = currentEl.nextSibling
+ }
+ }
+ ssrHTML.value = getFragmentHTML(instance.vnode.el, true)?.join('') || ''
+ const key = `${props.name}_${hashId.value}`
+ nuxtApp.payload.data[key] ||= {}
+ // clear all data-island-uid to avoid conflicts when saving into payloads
+ nuxtApp.payload.data[key].html = ssrHTML.value.replaceAll(new RegExp(`data-island-uid="${ssrHTML.value.match(SSR_UID_RE)?.[1] || ''}"`, 'g'), `data-island-uid=""`)
+ }
+
+ const uid = ref<string>(ssrHTML.value.match(SSR_UID_RE)?.[1] || getId())
+
+ const currentSlots = new Set(Object.keys(slots))
+ const availableSlots = computed(() => new Set([...ssrHTML.value.matchAll(SLOTNAME_RE)].map(m => m[1])))
+ const html = computed(() => {
+ let html = ssrHTML.value
+
+ if (props.scopeId) {
+ html = html.replace(ISLAND_SCOPE_ID_RE, full => full + ' ' + props.scopeId)
+ }
+
+ if (import.meta.client && !canLoadClientComponent.value) {
+ for (const [key, value] of Object.entries(payloads.components || {})) {
+ html = html.replace(new RegExp(` data-island-uid="${uid.value}" data-island-component="${key}"[^>]*>`), (full) => {
+ return full + value.html
+ })
+ }
+ }
+
+ if (payloads.slots) {
+ return html.replaceAll(SLOT_FALLBACK_RE, (full, slotName) => {
+ if (!currentSlots.has(slotName)) {
+ return full + (payloads.slots?.[slotName]?.fallback || '')
+ }
+ return full
+ })
+ }
+ return html
+ })
+
+ const head = injectHead()
+
+ async function _fetchComponent (force = false) {
+ const key = `${props.name}_${hashId.value}`
+
+ if (!force && nuxtApp.payload.data[key]?.html) { return nuxtApp.payload.data[key] }
+
+ const url = remoteComponentIslands && props.source ? joinURL(props.source, `/__nuxt_island/${key}.json`) : `/__nuxt_island/${key}.json`
+ if (import.meta.server && import.meta.prerender) {
+ // Hint to Nitro to prerender the island component
+ nuxtApp.runWithContext(() => prerenderRoutes(url))
+ }
+ // TODO: Validate response
+ const r = await fetch(withQuery(((import.meta.dev && import.meta.client) || props.source) ? url : joinURL(config.app.baseURL ?? '', url), {
+ ...props.context,
+ props: props.props ? JSON.stringify(props.props) : undefined,
+ }))
+ if (!r.ok) {
+ throw createError({ status: r.status, statusText: r.statusText })
+ }
+ try {
+ const result = await r.json()
+ // TODO: support passing on more headers
+ if (import.meta.server && import.meta.prerender) {
+ const hints = r.headers.get('x-nitro-prerender')
+ if (hints) {
+ event!.res.headers.append('x-nitro-prerender', hints)
+ }
+ }
+ setPayload(key, result)
+ return result
+ } catch (e: any) {
+ if (r.status !== 200) {
+ throw new Error(e.toString(), { cause: r })
+ }
+ throw e
+ }
+ }
+
+ async function fetchComponent (force = false) {
+ nuxtApp[pKey] ||= {}
+ nuxtApp[pKey][uid.value] ||= _fetchComponent(force).finally(() => {
+ delete nuxtApp[pKey]![uid.value]
+ })
+ try {
+ const res: NuxtIslandResponse = await nuxtApp[pKey][uid.value]
+
+ ssrHTML.value = res.html.replaceAll(DATA_ISLAND_UID_RE, `data-island-uid="${uid.value}"`)
+ key.value++
+ error.value = null
+ payloads.slots = res.slots || {}
+ payloads.components = res.components || {}
+
+ if (selectiveClient && import.meta.client) {
+ if (canLoadClientComponent.value && res.components) {
+ await loadComponents(props.source, res.components)
+ }
+ }
+
+ if (res?.head) {
+ if (activeHead) {
+ activeHead.patch(res.head)
+ } else {
+ activeHead = head.push(res.head)
+ }
+ }
+
+ if (import.meta.client) {
+ // must await next tick for Teleport to work correctly with static node re-rendering
+ nextTick(() => {
+ canTeleport = true
+ teleportKey.value++
+ })
+ }
+ } catch (e) {
+ error.value = e
+ emit('error', e)
+ }
+ }
+
+ expose({
+ refresh: () => fetchComponent(true),
+ })
+
+ if (import.meta.hot) {
+ import.meta.hot.on(`nuxt-server-component:${props.name}`, () => {
+ fetchComponent(true)
+ })
+ }
+
+ if (import.meta.client) {
+ watch(props, debounce(() => fetchComponent(), 100), { deep: true })
+ }
+
+ // Restore head entries from SSR payload during hydration
+ if (import.meta.client && instance.vnode.el) {
+ const headData = toRaw(nuxtApp.payload.data[`${props.name}_${hashId.value}`])?.head
+ if (headData) {
+ activeHead = head.push(headData)
+ }
+ }
+
+ if (import.meta.client && !instance.vnode.el && props.lazy) {
+ fetchComponent()
+ } else if (import.meta.server || !instance.vnode.el || !nuxtApp.payload.serverRendered) {
+ await fetchComponent()
+ } else if (selectiveClient && canLoadClientComponent.value) {
+ await loadComponents(props.source, payloads.components)
+ }
+
+ return (_ctx: any, _cache: any) => {
+ if (!html.value || error.value) {
+ return [slots.fallback?.({ error: error.value }) ?? createVNode('div')]
+ }
+ return [
+ withMemo([key.value], () => {
+ return createVNode(Fragment, { key: key.value }, [h(createStaticVNode(html.value || '<div></div>', 1))])
+ }, _cache, 0),
+
+ // should away be triggered ONE tick after re-rendering the static node
+ withMemo([teleportKey.value], () => {
+ const teleports: Array<VNode> = []
+ // this is used to force trigger Teleport when vue makes the diff between old and new node
+ const isKeyOdd = teleportKey.value === 0 || !!(teleportKey.value && !(teleportKey.value % 2))
+
+ if (uid.value && html.value && (import.meta.server || props.lazy ? canTeleport : (mounted.value || instance.vnode?.el))) {
+ for (const slot in slots) {
+ if (availableSlots.value.has(slot)) {
+ teleports.push(createVNode(Teleport,
+ // use different selectors for even and odd teleportKey to force trigger the teleport
+ { to: import.meta.client ? `${isKeyOdd ? 'div' : ''}[data-island-uid="${uid.value}"][data-island-slot="${slot}"]` : `uid=${uid.value};slot=${slot}` },
+ { default: () => (payloads.slots?.[slot]?.props?.length ? payloads.slots[slot].props : [{}]).map((data: any) => slots[slot]?.(data)) }),
+ )
+ }
+ }
+ if (selectiveClient) {
+ if (import.meta.server) {
+ if (payloads.components) {
+ for (const [id, info] of Object.entries(payloads.components)) {
+ const { html, slots } = info
+ let replaced = html.replaceAll('data-island-uid', `data-island-uid="${uid.value}"`)
+ for (const slot in slots) {
+ replaced = replaced.replaceAll(`data-island-slot="${slot}">`, full => full + slots[slot])
+ }
+ teleports.push(createVNode(Teleport, { to: `uid=${uid.value};client=${id}` }, {
+ default: () => [createStaticVNode(replaced, 1)],
+ }))
+ }
+ }
+ } else if (canLoadClientComponent.value && payloads.components) {
+ for (const [id, info] of Object.entries(payloads.components)) {
+ const { props, slots } = info
+ const component = components!.get(id)!
+ // use different selectors for even and odd teleportKey to force trigger the teleport
+ const vnode = createVNode(Teleport, { to: `${isKeyOdd ? 'div' : ''}[data-island-uid='${uid.value}'][data-island-component="${id}"]` }, {
+ default: () => {
+ return [h(component, props, Object.fromEntries(Object.entries(slots || {}).map(([k, v]) => ([k, () => createStaticVNode(`<div style="display: contents" data-island-uid data-island-slot="${k}">${v}</div>`, 1),
+ ]))))]
+ },
+ })
+ teleports.push(vnode)
+ }
+ }
+ }
+ }
+
+ return h(Fragment, teleports)
+ }, _cache, 1),
+ ]
+ }
+ },
+}) as unknown as DefineSetupFnComponent<NuxtIslandProps, NuxtIslandEmits, NuxtIslandSlots>
+
+export default NuxtIsland
diff --git a/packages/nuxt/src/app/components/nuxt-layout.ts b/packages/nuxt/src/app/components/nuxt-layout.ts
new file mode 100644
index 000000000000..d10e7f79ae4e
--- /dev/null
+++ b/packages/nuxt/src/app/components/nuxt-layout.ts
@@ -0,0 +1,243 @@
+import type { DefineComponent, ExtractPublicPropTypes, MaybeRef, PropType, VNode } from 'vue'
+import { Suspense, computed, defineComponent, h, inject, mergeProps, nextTick, onMounted, provide, shallowReactive, shallowRef, unref } from 'vue'
+import type { RouteLocationNormalizedLoaded } from 'vue-router'
+import type { NitroRouteRules } from 'nitro/types'
+
+import type { PageMeta } from '../../pages/runtime/composables'
+
+import { useRoute, useRouter } from '../composables/router'
+import { useNuxtApp } from '../nuxt'
+import { _mergeTransitionProps, _wrapInTransition } from './utils'
+import { LayoutMetaSymbol, PageRouteSymbol } from './injections'
+
+// @ts-expect-error virtual file
+import { useRoute as useVueRouterRoute } from '#build/pages'
+// @ts-expect-error virtual file
+import layouts from '#build/layouts'
+// @ts-expect-error virtual file
+import { appLayoutTransition as defaultLayoutTransition } from '#build/nuxt.config.mjs'
+// @ts-expect-error virtual file
+import _routeRulesMatcher from '#build/route-rules.mjs'
+
+const routeRulesMatcher = _routeRulesMatcher as (path: string) => NitroRouteRules
+
+const LayoutLoader = defineComponent({
+ name: 'LayoutLoader',
+ inheritAttrs: false,
+ props: {
+ name: String,
+ layoutProps: Object,
+ },
+ setup (props, context) {
+ // This is a deliberate hack - this component must always be called with an explicit key to ensure
+ // that setup reruns when the name changes.
+ return () => h(layouts[props.name], props.layoutProps, context.slots)
+ },
+})
+
+// props are moved outside of defineComponent to later explicitly assert the prop types
+// this avoids type loss/simplification resulting in things like MaybeRef<string | false>, keeping type hints for layout names
+const nuxtLayoutProps = {
+ name: {
+ type: [String, Boolean, Object] as PropType<unknown extends PageMeta['layout'] ? MaybeRef<string | false> : PageMeta['layout']>,
+ default: null,
+ },
+ fallback: {
+ type: [String, Object] as PropType<unknown extends PageMeta['layout'] ? MaybeRef<string> : PageMeta['layout']>,
+ default: null,
+ },
+}
+
+export default defineComponent({
+ name: 'NuxtLayout',
+ inheritAttrs: false,
+ props: nuxtLayoutProps,
+ setup (props, context) {
+ const nuxtApp = useNuxtApp()
+ // Need to ensure (if we are not a child of `<NuxtPage>`) that we use synchronous route (not deferred)
+ const injectedRoute = inject(PageRouteSymbol)
+ const shouldUseEagerRoute = !injectedRoute /* this should never be true */
+ || injectedRoute === useRoute() /* this is only true if we are not within `<NuxtPage>` */
+ const route = shouldUseEagerRoute ? useVueRouterRoute() as ReturnType<typeof useRoute> : injectedRoute
+
+ const layout = computed(() => {
+ let layout = unref(props.name) ?? route?.meta.layout as string ?? routeRulesMatcher(route?.path).appLayout ?? 'default'
+ if (layout && !(layout in layouts)) {
+ if (import.meta.dev && layout !== 'default') {
+ console.warn(`[nuxt] Invalid layout \`${layout}\` selected.`)
+ }
+ if (props.fallback) {
+ layout = unref(props.fallback)
+ }
+ }
+ return layout
+ })
+
+ const layoutRef = shallowRef()
+ context.expose({ layoutRef })
+
+ const done = nuxtApp.deferHydration()
+ if (import.meta.client && nuxtApp.isHydrating) {
+ const removeErrorHook = nuxtApp.hooks.hookOnce('app:error', done)
+ const removeGuard = useRouter().beforeEach(() => {
+ removeErrorHook()
+ removeGuard()
+ })
+ }
+
+ if (import.meta.dev) {
+ nuxtApp._isNuxtLayoutUsed = true
+ }
+
+ let lastLayout: string | boolean | undefined
+
+ return () => {
+ const hasLayout = !!layout.value && layout.value in layouts
+
+ const hasTransition = hasLayout && !!(route?.meta.layoutTransition ?? defaultLayoutTransition)
+
+ const transitionProps = hasTransition && _mergeTransitionProps([
+ route?.meta.layoutTransition,
+ defaultLayoutTransition,
+ {
+ onBeforeLeave () {
+ // Create the transition promise when the leave animation starts.
+ // This overrides any page transition promise since the layout
+ // is the outermost transition wrapper.
+ nuxtApp['~transitionPromise'] = new Promise((resolve) => {
+ nuxtApp['~transitionFinish'] = resolve
+ })
+ },
+ onAfterLeave () {
+ nuxtApp['~transitionFinish']?.()
+ delete nuxtApp['~transitionFinish']
+ delete nuxtApp['~transitionPromise']
+ },
+ },
+ ])
+
+ const previouslyRenderedLayout = lastLayout
+ lastLayout = layout.value
+
+ return _wrapInTransition(transitionProps, {
+ default: () => h(Suspense, {
+ suspensible: true,
+ onResolve: async () => {
+ await nextTick(done)
+ },
+ },
+ {
+ default: () => h(
+ LayoutProvider,
+ {
+ layoutProps: mergeProps(context.attrs, route.meta.layoutProps ?? {}, { ref: layoutRef }),
+ key: layout.value || undefined,
+ name: layout.value,
+ shouldProvide: !props.name,
+ isRenderingNewLayout: (name?: string | boolean) => {
+ return (name !== previouslyRenderedLayout && name === layout.value)
+ },
+ hasTransition,
+ }, context.slots),
+ }),
+ }).default()
+ }
+ },
+}) as DefineComponent<ExtractPublicPropTypes<typeof nuxtLayoutProps>>
+
+const LayoutProvider = defineComponent({
+ name: 'NuxtLayoutProvider',
+ inheritAttrs: false,
+ props: {
+ name: {
+ type: [String, Boolean] as unknown as () => string | false,
+ },
+ layoutProps: {
+ type: Object,
+ },
+ hasTransition: {
+ type: Boolean,
+ },
+ shouldProvide: {
+ type: Boolean,
+ },
+ isRenderingNewLayout: {
+ type: Function as unknown as () => (name?: string | boolean) => boolean,
+ required: true,
+ },
+ },
+ setup (props, context) {
+ // Prevent reactivity when the page will be rerendered in a different suspense fork
+
+ const name = props.name
+ if (props.shouldProvide) {
+ provide(LayoutMetaSymbol, {
+ // When name=false, always return true so NuxtPage doesn't skip rendering
+ isCurrent: (route: RouteLocationNormalizedLoaded) => name === false || name === (route.meta.layout ?? routeRulesMatcher(route.path).appLayout ?? 'default'),
+ })
+ }
+
+ // this route waits to update until the page has finished changing
+ const injectedRoute = inject(PageRouteSymbol)
+ const isNotWithinNuxtPage = injectedRoute && injectedRoute === useRoute()
+
+ if (isNotWithinNuxtPage) {
+ // this route updates immediately
+ const vueRouterRoute = useVueRouterRoute() as ReturnType<typeof useRoute>
+ const reactiveChildRoute = {} as RouteLocationNormalizedLoaded
+ for (const _key in vueRouterRoute) {
+ const key = _key as keyof RouteLocationNormalizedLoaded
+ Object.defineProperty(reactiveChildRoute, key, {
+ enumerable: true,
+ get: () => {
+ // we want to use the eager route if we are rendering a layout for the first time
+ // and only swap back to the lazy route if the route has already changed from the first render
+ return props.isRenderingNewLayout(props.name) ? vueRouterRoute[key] : injectedRoute[key]
+ },
+ })
+ }
+ provide(PageRouteSymbol, shallowReactive(reactiveChildRoute))
+ }
+
+ let vnode: VNode | undefined
+ if (import.meta.dev && import.meta.client) {
+ onMounted(() => {
+ nextTick(() => {
+ if (['#comment', '#text'].includes(vnode?.el?.nodeName)) {
+ if (name) {
+ console.warn(`[nuxt] \`${name}\` layout does not have a single root node and will cause errors when navigating between routes.`)
+ } else {
+ console.warn('[nuxt] `<NuxtLayout>` needs to be passed a single root node in its default slot.')
+ }
+ }
+ })
+ })
+ }
+
+ return () => {
+ if (!name || (typeof name === 'string' && !(name in layouts))) {
+ if (import.meta.dev && import.meta.client && props.hasTransition) {
+ vnode = context.slots.default?.() as VNode | undefined
+ return vnode
+ }
+ return context.slots.default?.()
+ }
+
+ if (import.meta.dev && import.meta.client && props.hasTransition) {
+ vnode = h(
+ LayoutLoader,
+ { key: name, layoutProps: props.layoutProps, name },
+ context.slots,
+ )
+
+ return vnode
+ }
+
+ return h(
+ LayoutLoader,
+ { key: name, layoutProps: props.layoutProps, name },
+ context.slots,
+ )
+ }
+ },
+})
diff --git a/packages/nuxt/src/app/components/nuxt-link.ts b/packages/nuxt/src/app/components/nuxt-link.ts
new file mode 100644
index 000000000000..0a0c362e0d66
--- /dev/null
+++ b/packages/nuxt/src/app/components/nuxt-link.ts
@@ -0,0 +1,620 @@
+import type {
+ AllowedComponentProps,
+ AnchorHTMLAttributes,
+ ComputedRef,
+ DefineSetupFnComponent,
+ InjectionKey,
+ MaybeRef,
+ PropType,
+ SlotsType,
+ UnwrapRef,
+ VNode,
+ VNodeProps,
+} from 'vue'
+import { computed, defineComponent, h, inject, onBeforeUnmount, onMounted, provide, ref, resolveComponent, shallowRef, unref } from 'vue'
+import type { RouteLocation, RouteLocationRaw, Router, RouterLink, RouterLinkProps, UseLinkReturn, useLink } from 'vue-router'
+import { hasProtocol, joinURL, parseQuery, withTrailingSlash, withoutTrailingSlash } from 'ufo'
+import { preloadRouteComponents } from '../composables/preload'
+import { onNuxtReady } from '../composables/ready'
+import { encodeRoutePath, navigateTo, resolveRouteObject, useRouter } from '../composables/router'
+import { useNuxtApp, useRuntimeConfig } from '../nuxt'
+import type { NuxtApp } from '../nuxt'
+import { cancelIdleCallback, requestIdleCallback } from '../compat/idle-callback'
+
+// @ts-expect-error virtual file
+import { nuxtLinkDefaults } from '#build/nuxt.config.mjs'
+
+import { hashMode } from '#build/router.options.mjs'
+
+const firstNonUndefined = <T> (...args: (T | undefined)[]) => args.find(arg => arg !== undefined)
+
+const NuxtLinkDevKeySymbol: InjectionKey<boolean> = Symbol('nuxt-link-dev-key')
+
+/**
+ * `<NuxtLink>` is a drop-in replacement for both Vue Router's `<RouterLink>` component and HTML's `<a>` tag.
+ * @see https://nuxt.com/docs/4.x/api/components/nuxt-link
+ */
+export interface NuxtLinkProps<CustomProp extends boolean = false> extends Omit<RouterLinkProps, 'to'> {
+ custom?: CustomProp
+ /**
+ * Route Location the link should navigate to when clicked on.
+ */
+ to?: RouteLocationRaw // need to manually type to avoid breaking typedPages
+ /**
+ * An alias for `to`. If used with `to`, `href` will be ignored
+ */
+ href?: NuxtLinkProps['to']
+ /**
+ * Forces the link to be considered as external (true) or internal (false). This is helpful to handle edge-cases
+ */
+ external?: boolean
+ /**
+ * Where to display the linked URL, as the name for a browsing context.
+ */
+ target?: '_blank' | '_parent' | '_self' | '_top' | (string & {}) | null
+ /**
+ * A rel attribute value to apply on the link. Defaults to "noopener noreferrer" for external links.
+ */
+ rel?: 'noopener' | 'noreferrer' | 'nofollow' | 'sponsored' | 'ugc' | (string & {}) | null
+ /**
+ * If set to true, no rel attribute will be added to the link
+ */
+ noRel?: boolean
+ /**
+ * A class to apply to links that have been prefetched.
+ */
+ prefetchedClass?: string
+ /**
+ * When enabled will prefetch middleware, layouts and payloads of links in the viewport.
+ */
+ prefetch?: boolean
+ /**
+ * Allows controlling when to prefetch links. By default, prefetch is triggered only on visibility.
+ */
+ prefetchOn?: 'visibility' | 'interaction' | Partial<{
+ visibility: boolean
+ interaction: boolean
+ }>
+ /**
+ * Escape hatch to disable `prefetch` attribute.
+ */
+ noPrefetch?: boolean
+ /**
+ * An option to either add or remove trailing slashes in the `href` for this specific link.
+ * Overrides the global `trailingSlash` option if provided.
+ */
+ trailingSlash?: 'append' | 'remove'
+}
+
+/**
+ * Create a NuxtLink component with given options as defaults.
+ * @see https://nuxt.com/docs/4.x/api/components/nuxt-link
+ */
+export interface NuxtLinkOptions extends
+ Partial<Pick<RouterLinkProps, 'activeClass' | 'exactActiveClass'>>,
+ Partial<Pick<NuxtLinkProps, 'prefetch' | 'prefetchedClass'>> {
+ /**
+ * The name of the component.
+ * @default "NuxtLink"
+ */
+ componentName?: string
+ /**
+ * A default `rel` attribute value applied on external links. Defaults to `"noopener noreferrer"`. Set it to `""` to disable.
+ */
+ externalRelAttribute?: string | null
+ /**
+ * An option to either add or remove trailing slashes in the `href`.
+ * If unset or not matching the valid values `append` or `remove`, it will be ignored.
+ */
+ trailingSlash?: 'append' | 'remove'
+
+ /**
+ * Allows controlling default setting for when to prefetch links. By default, prefetch is triggered only on visibility.
+ */
+ prefetchOn?: Exclude<NuxtLinkProps['prefetchOn'], string>
+}
+
+type NuxtLinkDefaultSlotProps<CustomProp extends boolean = false> = CustomProp extends true
+ ? {
+ href: string
+ navigate: (e?: MouseEvent) => Promise<void>
+ prefetch: (nuxtApp?: NuxtApp) => Promise<void>
+ route: (RouteLocation & { href: string }) | undefined
+ rel: string | null
+ target: '_blank' | '_parent' | '_self' | '_top' | (string & {}) | null
+ isExternal: boolean
+ isActive: false
+ isExactActive: false
+ }
+ : UnwrapRef<UseLinkReturn>
+
+type NuxtLinkSlots<CustomProp extends boolean = false> = {
+ default?: (props: NuxtLinkDefaultSlotProps<CustomProp>) => VNode[]
+}
+
+export type NuxtLinkComponent = new<CustomProp extends boolean = false>(
+ props: NuxtLinkProps<CustomProp> & VNodeProps & AllowedComponentProps & Omit<AnchorHTMLAttributes, keyof NuxtLinkProps<CustomProp>>,
+) => InstanceType<DefineSetupFnComponent<
+ NuxtLinkProps<CustomProp> & VNodeProps & AllowedComponentProps & Omit<AnchorHTMLAttributes, keyof NuxtLinkProps<CustomProp>>,
+ [],
+ SlotsType<NuxtLinkSlots<CustomProp>>
+>>
+
+/* @__NO_SIDE_EFFECTS__ */
+export function defineNuxtLink (options: NuxtLinkOptions): NuxtLinkComponent & Record<string, any> {
+ const componentName = options.componentName || 'NuxtLink'
+
+ function checkPropConflicts (props: NuxtLinkProps, main: keyof NuxtLinkProps, sub: keyof NuxtLinkProps): void {
+ if (import.meta.dev && props[main] !== undefined && props[sub] !== undefined) {
+ console.warn(`[${componentName}] \`${main}\` and \`${sub}\` cannot be used together. \`${sub}\` will be ignored.`)
+ }
+ }
+
+ function isHashLinkWithoutHashMode (link: unknown): boolean {
+ return !hashMode && typeof link === 'string' && link.startsWith('#')
+ }
+
+ function resolveTrailingSlashBehavior (to: string, resolve: Router['resolve'], trailingSlash?: NuxtLinkOptions['trailingSlash']): string
+ function resolveTrailingSlashBehavior (to: RouteLocationRaw, resolve: Router['resolve'], trailingSlash?: NuxtLinkOptions['trailingSlash']): Exclude<RouteLocationRaw, string>
+ function resolveTrailingSlashBehavior (to: RouteLocationRaw | undefined, resolve: Router['resolve'], trailingSlash?: NuxtLinkOptions['trailingSlash']): RouteLocationRaw | RouteLocation | undefined {
+ const effectiveTrailingSlash = trailingSlash ?? options.trailingSlash
+ if (!to || (effectiveTrailingSlash !== 'append' && effectiveTrailingSlash !== 'remove')) {
+ return to
+ }
+
+ if (typeof to === 'string') {
+ return applyTrailingSlashBehavior(to, effectiveTrailingSlash)
+ }
+
+ const path = 'path' in to && to.path !== undefined ? to.path : resolve(to).path
+
+ const resolvedPath = {
+ ...to,
+ name: undefined, // named routes would otherwise always override trailing slash behavior
+ path: applyTrailingSlashBehavior(path, effectiveTrailingSlash),
+ }
+
+ return resolvedPath
+ }
+
+ function useNuxtLink (props: { [K in keyof NuxtLinkProps]: MaybeRef<NuxtLinkProps[K]> }) {
+ const router = useRouter()
+ const config = useRuntimeConfig()
+
+ const hasTarget = computed(() => !!unref(props.target) && unref(props.target) !== '_self')
+
+ // Lazily check whether to.value has a protocol
+ const isAbsoluteUrl = computed(() => {
+ const path = unref(props.to) || unref(props.href) || ''
+ return typeof path === 'string' && hasProtocol(path, { acceptRelative: true })
+ })
+
+ const builtinRouterLink = resolveComponent('RouterLink') as string | typeof RouterLink
+ const useBuiltinLink = builtinRouterLink && typeof builtinRouterLink !== 'string' ? builtinRouterLink.useLink : undefined
+
+ // Resolving link type
+ const isExternal = computed<boolean>(() => {
+ // External prop is explicitly set
+ if (unref(props.external)) {
+ return true
+ }
+
+ const path = unref(props.to) || unref(props.href) || ''
+
+ // When `to` is a route object then it's an internal link
+ if (typeof path === 'object') {
+ return false
+ }
+
+ return path === '' || isAbsoluteUrl.value
+ })
+
+ // Resolving `to` value from `to` and `href` props
+ const to: ComputedRef<RouteLocationRaw> = computed(() => {
+ checkPropConflicts(props as NuxtLinkProps, 'to', 'href')
+ const path = unref(props.to) || unref(props.href) || '' // Defaults to empty string (won't render any `href` attribute)
+ if (isExternal.value) { return path }
+ return resolveTrailingSlashBehavior(path, router.resolve, unref(props.trailingSlash))
+ })
+
+ const link = isExternal.value ? undefined : useBuiltinLink?.({ ...props, to, viewTransition: unref(props.viewTransition) })
+
+ // Resolves `to` value if it's a route location object
+ const href = computed(() => {
+ const effectiveTrailingSlash = unref(props.trailingSlash) ?? options.trailingSlash
+ if (!to.value || isAbsoluteUrl.value || isHashLinkWithoutHashMode(to.value)) {
+ return to.value as string
+ }
+
+ if (isExternal.value) {
+ const path = typeof to.value === 'object' && 'path' in to.value ? resolveRouteObject(to.value) : to.value
+ // separately resolve route objects with a 'name' property and without 'path'
+ const href = typeof path === 'object' ? router.resolve(path).href : path
+ return applyTrailingSlashBehavior(href, effectiveTrailingSlash)
+ }
+
+ if (typeof to.value === 'object') {
+ return router.resolve(to.value)?.href ?? null
+ }
+
+ return applyTrailingSlashBehavior(joinURL(config.app.baseURL, to.value), effectiveTrailingSlash)
+ })
+
+ return {
+ to,
+ hasTarget,
+ isAbsoluteUrl,
+ isExternal,
+ //
+ href,
+ isActive: link?.isActive ?? computed(() => to.value === router.currentRoute.value.path),
+ isExactActive: link?.isExactActive ?? computed(() => to.value === router.currentRoute.value.path),
+ route: link?.route ?? computed(() => router.resolve(to.value)),
+ async navigate (_e?: MouseEvent) {
+ await navigateTo(href.value, { replace: unref(props.replace), external: isExternal.value || hasTarget.value })
+ },
+ } satisfies ReturnType<typeof useLink> & {
+ to: ComputedRef<RouteLocationRaw>
+ hasTarget: ComputedRef<boolean | null | undefined>
+ isAbsoluteUrl: ComputedRef<boolean>
+ isExternal: ComputedRef<boolean>
+ }
+ }
+
+ return defineComponent({
+ name: componentName,
+ props: {
+ // Routing
+ to: {
+ type: [String, Object] as PropType<RouteLocationRaw>,
+ default: undefined,
+ required: false,
+ },
+ href: {
+ type: [String, Object] as PropType<RouteLocationRaw>,
+ default: undefined,
+ required: false,
+ },
+
+ // Attributes
+ target: {
+ type: String as PropType<NuxtLinkProps['target']>,
+ default: undefined,
+ required: false,
+ },
+ rel: {
+ type: String as PropType<NuxtLinkProps['rel']>,
+ default: undefined,
+ required: false,
+ },
+ noRel: {
+ type: Boolean as PropType<NuxtLinkProps['noRel']>,
+ default: undefined,
+ required: false,
+ },
+
+ // Prefetching
+ prefetch: {
+ type: Boolean as PropType<NuxtLinkProps['prefetch']>,
+ default: undefined,
+ required: false,
+ },
+ prefetchOn: {
+ type: [String, Object] as PropType<NuxtLinkProps['prefetchOn']>,
+ default: undefined,
+ required: false,
+ },
+ noPrefetch: {
+ type: Boolean as PropType<NuxtLinkProps['noPrefetch']>,
+ default: undefined,
+ required: false,
+ },
+
+ // Styling
+ activeClass: {
+ type: String as PropType<NuxtLinkProps['activeClass']>,
+ default: undefined,
+ required: false,
+ },
+ exactActiveClass: {
+ type: String as PropType<NuxtLinkProps['exactActiveClass']>,
+ default: undefined,
+ required: false,
+ },
+ prefetchedClass: {
+ type: String as PropType<NuxtLinkProps['prefetchedClass']>,
+ default: undefined,
+ required: false,
+ },
+
+ // Vue Router's `<RouterLink>` additional props
+ replace: {
+ type: Boolean as PropType<NuxtLinkProps['replace']>,
+ default: undefined,
+ required: false,
+ },
+ ariaCurrentValue: {
+ type: String as PropType<NuxtLinkProps['ariaCurrentValue']>,
+ default: undefined,
+ required: false,
+ },
+
+ // Edge cases handling
+ external: {
+ type: Boolean as PropType<NuxtLinkProps['external']>,
+ default: undefined,
+ required: false,
+ },
+
+ // Slot API
+ custom: {
+ type: Boolean as PropType<NuxtLinkProps['custom']>,
+ default: undefined,
+ required: false,
+ },
+ // Behavior
+ trailingSlash: {
+ type: String as PropType<NuxtLinkProps['trailingSlash']>,
+ default: undefined,
+ required: false,
+ },
+ },
+ useLink: useNuxtLink,
+ setup (props, { slots }) {
+ const router = useRouter()
+
+ const { to, href, navigate, isExternal, hasTarget, isAbsoluteUrl } = useNuxtLink(props)
+
+ // Prefetching
+ const prefetched = shallowRef(false)
+ const el = import.meta.server ? undefined : ref<HTMLElement | null>(null)
+ const elRef = import.meta.server ? undefined : (ref: any) => { el!.value = props.custom ? ref?.$el?.nextElementSibling : ref?.$el }
+
+ function shouldPrefetch (mode: 'visibility' | 'interaction') {
+ if (import.meta.server) { return }
+ return !prefetched.value && (typeof props.prefetchOn === 'string' ? props.prefetchOn === mode : (props.prefetchOn?.[mode] ?? options.prefetchOn?.[mode])) && (props.prefetch ?? options.prefetch) !== false && props.noPrefetch !== true && props.target !== '_blank' && !isSlowConnection()
+ }
+
+ async function prefetch (nuxtApp = useNuxtApp()) {
+ if (import.meta.server) { return }
+
+ if (prefetched.value) { return }
+
+ prefetched.value = true
+
+ const path = typeof to.value === 'string'
+ ? to.value
+ : isExternal.value ? resolveRouteObject(to.value) : router.resolve(to.value).fullPath
+ const normalizedPath = isExternal.value ? new URL(path, window.location.href).href : path
+ await Promise.all([
+ nuxtApp.hooks.callHook('link:prefetch', normalizedPath)?.catch(() => {}),
+ !import.meta.dev && !isExternal.value && !hasTarget.value && preloadRouteComponents(to.value as string, router).catch(() => {}),
+ ])
+ }
+
+ if (import.meta.client) {
+ checkPropConflicts(props, 'noPrefetch', 'prefetch')
+ if (shouldPrefetch('visibility')) {
+ const nuxtApp = useNuxtApp()
+ let idleId: number
+ let unobserve: (() => void) | null = null
+ onMounted(() => {
+ const observer = useObserver()
+ onNuxtReady(() => {
+ idleId = requestIdleCallback(() => {
+ if (el?.value?.tagName) {
+ unobserve = observer!.observe(el.value as HTMLElement, async () => {
+ unobserve?.()
+ unobserve = null
+ await prefetch(nuxtApp)
+ })
+ }
+ })
+ })
+ })
+ onBeforeUnmount(() => {
+ if (idleId) { cancelIdleCallback(idleId) }
+ unobserve?.()
+ unobserve = null
+ })
+ }
+ }
+
+ if (import.meta.dev && import.meta.server && !props.custom) {
+ const isNuxtLinkChild = inject(NuxtLinkDevKeySymbol, false)
+ if (isNuxtLinkChild) {
+ console.log('[nuxt] [NuxtLink] You can\'t nest one <a> inside another <a>. This will cause a hydration error on client-side. You can pass the `custom` prop to take full control of the markup.')
+ } else {
+ provide(NuxtLinkDevKeySymbol, true)
+ }
+ }
+
+ return () => {
+ if (!isExternal.value && !hasTarget.value && !isHashLinkWithoutHashMode(to.value)) {
+ const routerLinkProps: RouterLinkProps & VNodeProps & AllowedComponentProps & AnchorHTMLAttributes = {
+ ref: elRef,
+ to: to.value,
+ activeClass: props.activeClass || options.activeClass,
+ exactActiveClass: props.exactActiveClass || options.exactActiveClass,
+ replace: props.replace,
+ ariaCurrentValue: props.ariaCurrentValue,
+ custom: props.custom,
+ }
+
+ // `custom` API cannot support fallthrough attributes as the slot
+ // may render fragment or text root nodes (#14897, #19375)
+ if (!props.custom) {
+ if (import.meta.client) {
+ if (shouldPrefetch('interaction')) {
+ routerLinkProps.onPointerenter = prefetch.bind(null, undefined)
+ routerLinkProps.onFocus = prefetch.bind(null, undefined)
+ }
+ if (prefetched.value) {
+ routerLinkProps.class = props.prefetchedClass || options.prefetchedClass
+ }
+ }
+ routerLinkProps.rel = props.rel || undefined
+ }
+
+ // Internal link
+ return h(
+ resolveComponent('RouterLink'),
+ routerLinkProps,
+ slots.default,
+ )
+ }
+
+ // Resolves `target` value
+ const target = props.target || null
+
+ // Resolves `rel`
+ checkPropConflicts(props, 'noRel', 'rel')
+ const rel = firstNonUndefined<string | null>(
+ // converts `""` to `null` to prevent the attribute from being added as empty (`rel=""`)
+ props.noRel ? '' : props.rel,
+ options.externalRelAttribute,
+ /*
+ * A fallback rel of `noopener noreferrer` is applied for external links or links that open in a new tab.
+ * This solves a reverse tabnapping security flaw in browsers pre-2021 as well as improving privacy.
+ */
+ (isAbsoluteUrl.value || hasTarget.value) ? 'noopener noreferrer' : '',
+ ) || null
+
+ // https://router.vuejs.org/api/interfaces/routerlinkprops#custom-
+ if (props.custom) {
+ if (!slots.default) {
+ return null
+ }
+
+ return slots.default({
+ href: href.value,
+ navigate,
+ prefetch,
+ get route () {
+ if (!href.value) { return undefined }
+
+ const url = new URL(href.value, import.meta.client ? window.location.href : 'http://localhost')
+ return {
+ path: url.pathname,
+ fullPath: url.pathname,
+ get query () { return parseQuery(url.search) },
+ hash: url.hash,
+ params: {},
+ name: undefined,
+ matched: [],
+ redirectedFrom: undefined,
+ meta: {},
+ href: href.value,
+ } satisfies RouteLocation & { href: string }
+ },
+ rel,
+ target,
+ isExternal: isExternal.value || hasTarget.value,
+ isActive: false,
+ isExactActive: false,
+ } satisfies NuxtLinkDefaultSlotProps<true>)
+ }
+
+ return h('a', {
+ ref: el,
+ href: href.value || null, // converts `""` to `null` to prevent the attribute from being added as empty (`href=""`)
+ rel,
+ target,
+ onClick: async (event) => {
+ if (isExternal.value || hasTarget.value) {
+ return
+ }
+
+ event.preventDefault()
+
+ try {
+ const encodedHref = encodeRoutePath(href.value)
+ return await (props.replace ? router.replace(encodedHref) : router.push(encodedHref))
+ } finally {
+ // Focus the target element for hash links to restore accessibility behavior
+ // that was prevented by event.preventDefault()
+ if (import.meta.client && isHashLinkWithoutHashMode(to.value)) {
+ const rawHash = (to.value as string).slice(1)
+ let hash = rawHash
+ try {
+ hash = decodeURIComponent(rawHash)
+ } catch {
+ // ignore errors
+ }
+ const el = document.getElementById(hash)
+ el?.focus()
+ }
+ }
+ },
+ }, slots.default?.())
+ }
+ },
+ }) as unknown as NuxtLinkComponent & Record<string, any>
+}
+
+const NuxtLink: NuxtLinkComponent & Record<string, any> = defineNuxtLink(nuxtLinkDefaults)
+export default NuxtLink
+
+// -- NuxtLink utils --
+function applyTrailingSlashBehavior (to: string, trailingSlash: NuxtLinkOptions['trailingSlash']): string {
+ const normalizeFn = trailingSlash === 'append' ? withTrailingSlash : withoutTrailingSlash
+ // Until https://github.com/unjs/ufo/issues/189 is resolved
+ const hasProtocolDifferentFromHttp = hasProtocol(to) && !to.startsWith('http')
+ if (hasProtocolDifferentFromHttp) {
+ return to
+ }
+ return normalizeFn(to, true)
+}
+
+// --- Prefetching utils ---
+type CallbackFn = () => void
+type ObserveFn = (element: Element, callback: CallbackFn) => () => void
+
+function useObserver (): { observe: ObserveFn } | undefined {
+ if (import.meta.server) { return }
+
+ const nuxtApp = useNuxtApp()
+ if (nuxtApp._observer) {
+ return nuxtApp._observer
+ }
+
+ let observer: IntersectionObserver | null = null
+
+ const callbacks = new Map<Element, CallbackFn>()
+
+ const observe: ObserveFn = (element, callback) => {
+ observer ||= new IntersectionObserver((entries) => {
+ for (const entry of entries) {
+ const callback = callbacks.get(entry.target)
+ const isVisible = entry.isIntersecting || entry.intersectionRatio > 0
+ if (isVisible && callback) { callback() }
+ }
+ })
+ callbacks.set(element, callback)
+ observer.observe(element)
+ return () => {
+ callbacks.delete(element)
+ observer?.unobserve(element)
+ if (callbacks.size === 0) {
+ observer?.disconnect()
+ observer = null
+ }
+ }
+ }
+
+ const _observer = nuxtApp._observer = {
+ observe,
+ }
+
+ return _observer
+}
+
+const IS_2G_RE = /2g/
+function isSlowConnection () {
+ if (import.meta.server) { return }
+
+ // https://developer.mozilla.org/en-US/docs/Web/API/Navigator/connection
+ const cn = (navigator as any).connection as { saveData: boolean, effectiveType: string } | null
+ if (cn && (cn.saveData || IS_2G_RE.test(cn.effectiveType))) { return true }
+ return false
+}
diff --git a/packages/nuxt/src/app/components/nuxt-loading-indicator.ts b/packages/nuxt/src/app/components/nuxt-loading-indicator.ts
new file mode 100644
index 000000000000..88f61a24a5e1
--- /dev/null
+++ b/packages/nuxt/src/app/components/nuxt-loading-indicator.ts
@@ -0,0 +1,87 @@
+import { defineComponent, h } from 'vue'
+import type { DefineSetupFnComponent } from 'vue'
+import { useLoadingIndicator } from '../composables/loading-indicator'
+
+interface NuxtLoadingIndicatorProps {
+ throttle?: number
+ duration?: number
+ hideDelay?: number
+ resetDelay?: number
+ height?: number
+ color?: string | boolean
+ errorColor?: string
+ estimatedProgress?: (duration: number, elapsed: number) => number
+}
+
+const NuxtLoadingIndicator = defineComponent({
+ name: 'NuxtLoadingIndicator',
+ props: {
+ throttle: {
+ type: Number,
+ default: 200,
+ },
+ duration: {
+ type: Number,
+ default: 2000,
+ },
+ hideDelay: {
+ type: Number,
+ default: 500,
+ },
+ resetDelay: {
+ type: Number,
+ default: 400,
+ },
+ height: {
+ type: Number,
+ default: 3,
+ },
+ color: {
+ type: [String, Boolean],
+ default: 'repeating-linear-gradient(to right,#00dc82 0%,#34cdfe 50%,#0047e1 100%)',
+ },
+ errorColor: {
+ type: String,
+ default: 'repeating-linear-gradient(to right,#f87171 0%,#ef4444 100%)',
+ },
+ estimatedProgress: {
+ type: Function as unknown as () => (duration: number, elapsed: number) => number,
+ required: false,
+ },
+ },
+ setup (props, { slots, expose }) {
+ const { progress, isLoading, error, start, finish, clear } = useLoadingIndicator({
+ duration: props.duration,
+ throttle: props.throttle,
+ hideDelay: props.hideDelay,
+ resetDelay: props.resetDelay,
+ estimatedProgress: props.estimatedProgress,
+ })
+
+ expose({
+ progress, isLoading, error, start, finish, clear,
+ })
+
+ return () => h('div', {
+ class: 'nuxt-loading-indicator',
+ style: {
+ position: 'fixed',
+ top: 0,
+ right: 0,
+ left: 0,
+ pointerEvents: 'none',
+ width: 'auto',
+ height: `${props.height}px`,
+ opacity: isLoading.value ? 1 : 0,
+ background: error.value ? props.errorColor : props.color || undefined,
+ backgroundSize: `${progress.value > 0 ? (100 / progress.value) * 100 : 0}% auto`,
+ transform: `scaleX(${progress.value}%)`,
+ transformOrigin: 'left',
+ transition: 'transform 0.1s, height 0.4s, opacity 0.4s',
+ zIndex: 999999,
+ },
+ }, slots)
+ },
+}) as unknown as DefineSetupFnComponent<NuxtLoadingIndicatorProps>
+
+export default NuxtLoadingIndicator
diff --git a/packages/nuxt/src/app/components/nuxt-root.vue b/packages/nuxt/src/app/components/nuxt-root.vue
new file mode 100644
index 000000000000..b9f9dd222b96
--- /dev/null
+++ b/packages/nuxt/src/app/components/nuxt-root.vue
@@ -0,0 +1,92 @@
+<template>
+ <Suspense @resolve="onResolve">
+ <div v-if="abortRender" />
+ <ErrorComponent
+ v-else-if="error"
+ :error="error"
+ />
+ <IslandRenderer
+ v-else-if="islandContext"
+ :context="islandContext"
+ />
+ <component
+ :is="SingleRenderer"
+ v-else-if="SingleRenderer"
+ />
+ <AppComponent v-else />
+ </Suspense>
+</template>
+
+<script setup>
+import { defineAsyncComponent, onErrorCaptured, onServerPrefetch, provide } from 'vue'
+import { useNuxtApp } from '../nuxt'
+import { isNuxtError, showError, useError } from '../composables/error'
+import { useRoute, useRouter } from '../composables/router'
+import { PageRouteSymbol } from '../components/injections'
+import AppComponent from '#build/app-component.mjs'
+import ErrorComponent from '#build/error-component.mjs'
+// @ts-expect-error virtual file
+import { componentIslands } from '#build/nuxt.config.mjs'
+
+const IslandRenderer = import.meta.server && componentIslands
+ ? defineAsyncComponent(() => import('./island-renderer').then(r => r.default || r))
+ : () => null
+
+const nuxtApp = useNuxtApp()
+const onResolve = nuxtApp.deferHydration()
+if (import.meta.client && nuxtApp.isHydrating) {
+ const removeErrorHook = nuxtApp.hooks.hookOnce('app:error', onResolve)
+ const removeGuard = useRouter().beforeEach(() => {
+ removeErrorHook()
+ removeGuard()
+ })
+}
+
+const url = import.meta.server ? nuxtApp.ssrContext.url : window.location.pathname
+const SingleRenderer = import.meta.test && import.meta.dev && import.meta.server && url.startsWith('/__nuxt_component_test__/') && defineAsyncComponent(() => import('#build/test-component-wrapper.mjs')
+ .then(r => r.default(import.meta.server ? url : window.location.href)))
+
+// Inject default route (outside of pages) as active route
+provide(PageRouteSymbol, useRoute())
+
+// vue:setup hook
+const results = nuxtApp.hooks.callHookWith(hooks => hooks.map(hook => hook()), 'vue:setup', [])
+if (import.meta.dev && results && results.some(i => i && 'then' in i)) {
+ console.error('[nuxt] Error in `vue:setup`. Callbacks must be synchronous.')
+}
+
+// error handling
+const error = useError()
+// render an empty <div> when plugins have thrown an error but we're not yet rendering the error page
+const abortRender = import.meta.server && error.value && !nuxtApp.ssrContext.error
+const BOT_RE = /bot\b|chrome-lighthouse|facebookexternalhit|google\b/i
+// returning `false` from onErrorCaptured below stops Vue from invoking
+// `app.config.errorHandler`, so call it explicitly (#22691)
+function invokeAppErrorHandler (err, target, info) {
+ const errorHandler = nuxtApp.vueApp.config.errorHandler
+ if (errorHandler && !errorHandler.__nuxt_default) {
+ try {
+ errorHandler(err, target, info)
+ } catch (handlerError) {
+ console.error('[nuxt] Error in `app.config.errorHandler`', handlerError)
+ }
+ }
+}
+onErrorCaptured((err, target, info) => {
+ nuxtApp.hooks.callHook('vue:error', err, target, info)?.catch(hookError => console.error('[nuxt] Error in `vue:error` hook', hookError))
+ if (import.meta.client && BOT_RE.test(navigator.userAgent)) {
+ nuxtApp.hooks.callHook('app:error', err)
+ console.error(`[nuxt] Not rendering error page for bot with user agent \`${navigator.userAgent}\`:`, err)
+ return false
+ }
+ if (import.meta.server || (isNuxtError(err) && (err.fatal || err.unhandled))) {
+ const p = nuxtApp.runWithContext(() => showError(err))
+ onServerPrefetch(() => p)
+ invokeAppErrorHandler(err, target, info)
+ return false // suppress error from breaking render
+ }
+})
+
+// Component islands context
+const islandContext = import.meta.server && nuxtApp.ssrContext.islandContext
+</script>
diff --git a/packages/nuxt/src/app/components/nuxt-route-announcer.ts b/packages/nuxt/src/app/components/nuxt-route-announcer.ts
new file mode 100644
index 000000000000..5b673aaac25e
--- /dev/null
+++ b/packages/nuxt/src/app/components/nuxt-route-announcer.ts
@@ -0,0 +1,70 @@
+import { computed, defineComponent, h } from 'vue'
+import type { DefineSetupFnComponent, SlotsType, VNode } from 'vue'
+import type { Politeness } from 'nuxt/app'
+import { useRouteAnnouncer } from '../composables/route-announcer'
+
+interface NuxtRouteAnnouncerProps {
+ atomic?: boolean
+ politeness?: Politeness
+}
+
+type NuxtRouteAnnouncerSlots = SlotsType<{
+ default?: (props: { message: string }) => VNode[]
+}>
+
+const NuxtRouteAnnouncer = defineComponent({
+ name: 'NuxtRouteAnnouncer',
+ props: {
+ atomic: {
+ type: Boolean,
+ default: false,
+ },
+ politeness: {
+ type: String as () => Politeness,
+ default: 'polite',
+ },
+ },
+ setup (props, { slots, expose }) {
+ const { set, polite, assertive, message, politeness } = useRouteAnnouncer({ politeness: props.politeness })
+
+ const role = computed(() => {
+ if (politeness.value === 'assertive') {
+ return 'alert'
+ }
+ if (politeness.value === 'off') {
+ return undefined
+ }
+ return 'status'
+ })
+
+ expose({
+ set, polite, assertive, message, politeness,
+ })
+
+ return () => h('span', {
+ class: 'nuxt-route-announcer',
+ style: {
+ position: 'absolute',
+ },
+ }, h('span', {
+ 'role': role.value,
+ 'aria-live': politeness.value,
+ 'aria-atomic': props.atomic,
+ 'style': {
+ 'border': '0',
+ 'clip': 'rect(0 0 0 0)',
+ 'clip-path': 'inset(50%)',
+ 'height': '1px',
+ 'width': '1px',
+ 'overflow': 'hidden',
+ 'position': 'absolute',
+ 'white-space': 'nowrap',
+ 'word-wrap': 'normal',
+ 'margin': '-1px',
+ 'padding': '0',
+ },
+ }, slots.default ? slots.default({ message: message.value }) : message.value))
+ },
+}) as unknown as DefineSetupFnComponent<NuxtRouteAnnouncerProps, {}, NuxtRouteAnnouncerSlots>
+
+export default NuxtRouteAnnouncer
diff --git a/packages/nuxt/src/app/components/nuxt-stubs.ts b/packages/nuxt/src/app/components/nuxt-stubs.ts
new file mode 100644
index 000000000000..776617847e02
--- /dev/null
+++ b/packages/nuxt/src/app/components/nuxt-stubs.ts
@@ -0,0 +1,17 @@
+import { createError } from '../composables/error'
+
+function renderStubMessage (name: string): never {
+ throw createError({
+ fatal: true,
+ status: 500,
+ statusText: `${name} is provided by @nuxt/image. Check your console to install it or run 'npx nuxt module add @nuxt/image'`,
+ })
+}
+
+export const NuxtImg: { setup: () => never } = {
+ setup: (): never => renderStubMessage('<NuxtImg>'),
+}
+
+export const NuxtPicture: { setup: () => never } = {
+ setup: (): never => renderStubMessage('<NuxtPicture>'),
+}
diff --git a/packages/nuxt/src/app/components/nuxt-teleport-island-component.ts b/packages/nuxt/src/app/components/nuxt-teleport-island-component.ts
new file mode 100644
index 000000000000..37bc4597b998
--- /dev/null
+++ b/packages/nuxt/src/app/components/nuxt-teleport-island-component.ts
@@ -0,0 +1,67 @@
+import type { Component, DefineSetupFnComponent, InjectionKey, SlotsType, VNode } from 'vue'
+import { Teleport, defineComponent, h, inject, provide, useId } from 'vue'
+import { useNuxtApp } from '../nuxt'
+// @ts-expect-error virtual file
+import paths from '#build/component-chunk'
+// @ts-expect-error virtual file
+import { buildAssetsURL } from '#internal/nuxt/paths'
+
+type ExtendedComponent = Component & {
+ __file: string
+ __name: string
+}
+
+export const NuxtTeleportIslandSymbol = Symbol('NuxtTeleportIslandComponent') as InjectionKey<false | string>
+
+/**
+ * component only used with componentsIsland
+ * this teleport the component in SSR only if it needs to be hydrated on client
+ */
+interface NuxtTeleportIslandComponentProps {
+ nuxtClient?: boolean
+}
+
+type NuxtTeleportIslandComponentSlots = SlotsType<{
+ default?: () => VNode[]
+}>
+
+/* @__PURE__ */
+const NuxtTeleportIslandComponent = defineComponent({
+ name: 'NuxtTeleportIslandComponent',
+ inheritAttrs: false,
+ props: {
+ nuxtClient: {
+ type: Boolean,
+ default: false,
+ },
+ },
+ setup (props, { slots }) {
+ const nuxtApp = useNuxtApp()
+ const to = useId()
+
+ // if there's already a teleport parent, we don't need to teleport or to render the wrapped component client side
+ if (!nuxtApp.ssrContext?.islandContext || !props.nuxtClient || inject(NuxtTeleportIslandSymbol, false)) { return () => slots.default?.() }
+
+ provide(NuxtTeleportIslandSymbol, to)
+ const islandContext = nuxtApp.ssrContext!.islandContext!
+
+ return () => {
+ const slot = slots.default!()[0]!
+ const slotType = slot.type as ExtendedComponent
+ const name = (slotType.__name || slotType.name) as string
+
+ islandContext.components[to] = {
+ chunk: import.meta.dev ? buildAssetsURL(paths[name]) : paths[name],
+ props: slot.props || {},
+ }
+
+ return [h('div', {
+ 'style': 'display: contents;',
+ 'data-island-uid': '',
+ 'data-island-component': to,
+ }, []), h(Teleport, { to }, slot)]
+ }
+ },
+}) as unknown as DefineSetupFnComponent<NuxtTeleportIslandComponentProps, {}, NuxtTeleportIslandComponentSlots>
+
+export default NuxtTeleportIslandComponent
diff --git a/packages/nuxt/src/app/components/nuxt-teleport-island-slot.ts b/packages/nuxt/src/app/components/nuxt-teleport-island-slot.ts
new file mode 100644
index 000000000000..733d7044a3e8
--- /dev/null
+++ b/packages/nuxt/src/app/components/nuxt-teleport-island-slot.ts
@@ -0,0 +1,79 @@
+import type { DefineSetupFnComponent, SlotsType, VNode } from 'vue'
+import { Teleport, createVNode, defineComponent, h, inject } from 'vue'
+import { useNuxtApp } from '../nuxt'
+import { NuxtTeleportIslandSymbol } from './nuxt-teleport-island-component'
+
+/**
+ * component only used within islands for slot teleport
+ */
+interface NuxtTeleportIslandSlotProps {
+ name: string
+ /**
+ * must be an array to handle v-for
+ */
+ props?: Array<any>
+}
+
+type NuxtTeleportIslandSlotSlots = SlotsType<{
+ default?: () => VNode[]
+ fallback?: () => VNode[]
+}>
+
+/* @__PURE__ */
+const NuxtTeleportIslandSlot = defineComponent({
+ name: 'NuxtTeleportIslandSlot',
+ inheritAttrs: false,
+ props: {
+ name: {
+ type: String,
+ required: true,
+ },
+ /**
+ * must be an array to handle v-for
+ */
+ props: {
+ type: Object as () => Array<any>,
+ },
+ },
+ setup (props, { slots }) {
+ const nuxtApp = useNuxtApp()
+ const islandContext = nuxtApp.ssrContext?.islandContext
+ if (!islandContext) {
+ return () => slots.default?.()[0]
+ }
+
+ const componentName = inject(NuxtTeleportIslandSymbol, false)
+ islandContext.slots[props.name] = {
+ props: (props.props || []) as unknown[],
+ }
+
+ return () => {
+ const vnodes: VNode[] = []
+
+ if (nuxtApp.ssrContext?.islandContext && slots.default) {
+ vnodes.push(h('div', {
+ 'style': 'display: contents;',
+ 'data-island-uid': '',
+ 'data-island-slot': props.name,
+ }, {
+ // Teleport in slot to not be hydrated client-side with the staticVNode
+ default: () => [createVNode(Teleport, { to: `island-slot=${componentName};${props.name}` }, slots.default?.())],
+ }))
+ } else {
+ vnodes.push(h('div', {
+ 'style': 'display: contents;',
+ 'data-island-uid': '',
+ 'data-island-slot': props.name,
+ }))
+ }
+
+ if (slots.fallback) {
+ vnodes.push(h(Teleport, { to: `island-fallback=${props.name}` }, slots.fallback()))
+ }
+
+ return vnodes
+ }
+ },
+}) as unknown as DefineSetupFnComponent<NuxtTeleportIslandSlotProps, {}, NuxtTeleportIslandSlotSlots>
+
+export default NuxtTeleportIslandSlot
diff --git a/packages/nuxt/src/app/components/nuxt-time.vue b/packages/nuxt/src/app/components/nuxt-time.vue
new file mode 100644
index 000000000000..5f63ef63ae26
--- /dev/null
+++ b/packages/nuxt/src/app/components/nuxt-time.vue
@@ -0,0 +1,187 @@
+<script setup lang="ts">
+import { computed, getCurrentInstance, onBeforeUnmount, ref } from 'vue'
+import { onPrehydrate } from '../composables/ssr'
+import { useNuxtApp } from '../nuxt'
+
+export interface NuxtTimeProps {
+ locale?: string
+ datetime: string | number | Date
+ localeMatcher?: 'best fit' | 'lookup'
+ weekday?: 'long' | 'short' | 'narrow'
+ era?: 'long' | 'short' | 'narrow'
+ year?: 'numeric' | '2-digit'
+ month?: 'numeric' | '2-digit' | 'long' | 'short' | 'narrow'
+ day?: 'numeric' | '2-digit'
+ hour?: 'numeric' | '2-digit'
+ minute?: 'numeric' | '2-digit'
+ second?: 'numeric' | '2-digit'
+ timeZoneName?: 'short' | 'long' | 'shortOffset' | 'longOffset' | 'shortGeneric' | 'longGeneric'
+ formatMatcher?: 'best fit' | 'basic'
+ hour12?: boolean
+ timeZone?: string
+
+ calendar?: string
+ dayPeriod?: 'narrow' | 'short' | 'long'
+ numberingSystem?: string
+
+ dateStyle?: 'full' | 'long' | 'medium' | 'short'
+ timeStyle?: 'full' | 'long' | 'medium' | 'short'
+ hourCycle?: 'h11' | 'h12' | 'h23' | 'h24'
+
+ relative?: boolean
+ numeric?: 'always' | 'auto'
+ relativeStyle?: 'long' | 'short' | 'narrow'
+
+ title?: boolean | string
+}
+
+const props = withDefaults(defineProps<NuxtTimeProps>(), {
+ hour12: undefined,
+})
+
+const el = getCurrentInstance()?.vnode.el
+const renderedDate = el?.getAttribute('datetime')
+const _locale = el?.getAttribute('data-locale')
+
+const nuxtApp = useNuxtApp()
+
+const date = computed(() => {
+ const date = props.datetime
+ if (renderedDate && nuxtApp.isHydrating) { return new Date(renderedDate) }
+ if (!props.datetime) { return new Date() }
+ return new Date(date)
+})
+
+const now = ref(import.meta.client && nuxtApp.isHydrating && window._nuxtTimeNow ? new Date(window._nuxtTimeNow) : new Date())
+if (import.meta.client && props.relative) {
+ const handler = () => {
+ now.value = new Date()
+ }
+ const interval = setInterval(handler, 1000)
+ onBeforeUnmount(() => clearInterval(interval))
+}
+
+const formatter = computed(() => {
+ const { locale: propsLocale, relative, relativeStyle, ...rest } = props
+ if (relative) {
+ return new Intl.RelativeTimeFormat(_locale ?? propsLocale, { ...rest, style: relativeStyle })
+ }
+ return new Intl.DateTimeFormat(_locale ?? propsLocale, rest)
+})
+
+const formattedDate = computed(() => {
+ if (isInvalidDate.value) {
+ return date.value.toString()
+ }
+
+ if (!props.relative) {
+ return (formatter.value as Intl.DateTimeFormat).format(date.value)
+ }
+
+ const diffInSeconds = (date.value.getTime() - now.value.getTime()) / 1000
+
+ const units: Array<{
+ unit: Intl.RelativeTimeFormatUnit
+ seconds: number
+ threshold: number
+ }> = [
+ { unit: 'second', seconds: 1, threshold: 60 }, // 60 seconds → minute
+ { unit: 'minute', seconds: 60, threshold: 60 }, // 60 minutes → hour
+ { unit: 'hour', seconds: 3600, threshold: 24 }, // 24 hours → day
+ { unit: 'day', seconds: 86400, threshold: 30 }, // ~30 days → month
+ { unit: 'month', seconds: 2592000, threshold: 12 }, // 12 months → year
+ { unit: 'year', seconds: 31536000, threshold: Infinity },
+ ]
+
+ const { unit, seconds } = units.find(({ seconds, threshold }) => Math.abs(diffInSeconds / seconds) < threshold) || units[units.length - 1]!
+
+ const value = diffInSeconds / seconds
+ return (formatter.value as Intl.RelativeTimeFormat).format(Math.round(value), unit)
+})
+
+const isInvalidDate = computed(() => Number.isNaN(date.value.getTime()))
+const isoDate = computed(() => isInvalidDate.value ? undefined : date.value.toISOString())
+const title = computed(() => props.title === true ? isoDate.value : typeof props.title === 'string' ? props.title : undefined)
+const dataset: Record<string, string | number | boolean | Date | undefined> = {}
+
+if (import.meta.server) {
+ for (const prop in props) {
+ if (prop !== 'datetime') {
+ const value = props?.[prop as keyof typeof props]
+ if (value !== undefined && value !== null) {
+ const propInKebabCase = prop.split(/(?=[A-Z])/).join('-')
+ dataset[`data-${propInKebabCase}`] = props?.[prop as keyof typeof props]
+ }
+ }
+ }
+ onPrehydrate((el) => {
+ const now = window._nuxtTimeNow ||= Date.now()
+ const toCamelCase = (name: string, index: number) => {
+ if (index > 0) {
+ return name[0]!.toUpperCase() + name.slice(1)
+ }
+ return name
+ }
+
+ const datetime = el.getAttribute('datetime')
+ if (!datetime) {
+ return
+ }
+ const date = new Date(datetime)
+ if (Number.isNaN(date.getTime())) {
+ return
+ }
+
+ const options: Intl.DateTimeFormatOptions & Intl.RelativeTimeFormatOptions & { locale?: Intl.LocalesArgument, relative?: boolean } = {}
+ for (const name of el.getAttributeNames()) {
+ if (name.startsWith('data-')) {
+ let optionName = name.slice(5).split('-').map(toCamelCase).join('') as keyof (Intl.DateTimeFormatOptions & Intl.RelativeTimeFormatOptions)
+
+ if ((optionName as string) === 'relativeStyle') {
+ optionName = 'style'
+ }
+
+ const attrValue = el.getAttribute(name)
+ options[optionName] = (attrValue === 'true' ? true : attrValue === 'false' ? false : attrValue) as any
+ }
+ }
+
+ if (options.relative) {
+ const diffInSeconds = (date.getTime() - now) / 1000
+ const units: Array<{
+ unit: Intl.RelativeTimeFormatUnit
+ seconds: number
+ threshold: number
+ }> = [
+ { unit: 'second', seconds: 1, threshold: 60 }, // 60 seconds → minute
+ { unit: 'minute', seconds: 60, threshold: 60 }, // 60 minutes → hour
+ { unit: 'hour', seconds: 3600, threshold: 24 }, // 24 hours → day
+ { unit: 'day', seconds: 86400, threshold: 30 }, // ~30 days → month
+ { unit: 'month', seconds: 2592000, threshold: 12 }, // 12 months → year
+ { unit: 'year', seconds: 31536000, threshold: Infinity },
+ ]
+ const { unit, seconds } = units.find(({ seconds, threshold }) => Math.abs(diffInSeconds / seconds) < threshold) || units[units.length - 1]!
+ const value = diffInSeconds / seconds
+ const formatter = new Intl.RelativeTimeFormat(options.locale, options)
+ el.textContent = formatter.format(Math.round(value), unit)
+ } else {
+ const formatter = new Intl.DateTimeFormat(options.locale, options)
+ el.textContent = formatter.format(date)
+ }
+ })
+}
+
+declare global {
+ interface Window {
+ _nuxtTimeNow?: number
+ }
+}
+</script>
+
+<template>
+ <time
+ v-bind="dataset"
+ :datetime="isoDate"
+ :title="title"
+ >{{ formattedDate }}</time>
+</template>
diff --git a/packages/nuxt/src/app/components/route-provider.ts b/packages/nuxt/src/app/components/route-provider.ts
new file mode 100644
index 000000000000..cc3ed0c22f24
--- /dev/null
+++ b/packages/nuxt/src/app/components/route-provider.ts
@@ -0,0 +1,70 @@
+import { defineComponent, h, nextTick, onMounted, provide, shallowReactive } from 'vue'
+import type { DefineSetupFnComponent, Ref, VNode } from 'vue'
+import type { RouteLocationNormalizedLoaded } from 'vue-router'
+import { PageRouteSymbol } from './injections'
+
+interface RouteProviderProps {
+ route: RouteLocationNormalizedLoaded
+ vnode?: VNode
+ vnodeRef?: Ref<any>
+ renderKey?: string
+ trackRootNodes?: boolean
+}
+
+export type RouteProviderComponent = DefineSetupFnComponent<RouteProviderProps>
+
+export const defineRouteProvider = (name = 'RouteProvider'): RouteProviderComponent => defineComponent({
+ name,
+ props: {
+ route: {
+ type: Object as () => RouteLocationNormalizedLoaded,
+ required: true,
+ },
+ vnode: Object as () => VNode,
+ vnodeRef: Object as () => Ref<any>,
+ renderKey: String,
+ trackRootNodes: Boolean,
+ },
+ setup (props) {
+ // Prevent reactivity when the page will be rerendered in a different suspense fork
+ const previousKey = props.renderKey
+ const previousRoute = props.route
+
+ // Provide a reactive route within the page
+ const route = {} as RouteLocationNormalizedLoaded
+ for (const key in props.route) {
+ Object.defineProperty(route, key, {
+ get: () => previousKey === props.renderKey ? props.route[key as keyof RouteLocationNormalizedLoaded] : previousRoute[key as keyof RouteLocationNormalizedLoaded],
+ enumerable: true,
+ })
+ }
+
+ provide(PageRouteSymbol, shallowReactive(route))
+
+ let vnode: VNode
+ if (import.meta.dev && import.meta.client && props.trackRootNodes) {
+ onMounted(() => {
+ nextTick(() => {
+ if (['#comment', '#text'].includes(vnode?.el?.nodeName)) {
+ const filename = (vnode?.type as any)?.__file
+ console.warn(`[nuxt] \`${filename}\` does not have a single root node and will cause errors when navigating between routes.`)
+ }
+ })
+ })
+ }
+
+ return () => {
+ if (!props.vnode) {
+ return props.vnode
+ }
+ if (import.meta.dev && import.meta.client) {
+ vnode = h(props.vnode, { ref: props.vnodeRef })
+ return vnode
+ }
+
+ return h(props.vnode, { ref: props.vnodeRef })
+ }
+ },
+}) as unknown as RouteProviderComponent
+
+export const RouteProvider: RouteProviderComponent = defineRouteProvider()
diff --git a/packages/nuxt/src/app/components/server-placeholder.ts b/packages/nuxt/src/app/components/server-placeholder.ts
new file mode 100644
index 000000000000..d859be2ba680
--- /dev/null
+++ b/packages/nuxt/src/app/components/server-placeholder.ts
@@ -0,0 +1,14 @@
+import { createCommentVNode, createElementBlock, defineComponent } from 'vue'
+import type { DefineSetupFnComponent } from 'vue'
+
+// @ts-expect-error virtual file
+import { clientNodePlaceholder } from '#build/nuxt.config.mjs'
+
+const ServerPlaceholder = defineComponent({
+ name: 'ServerPlaceholder',
+ render () {
+ return clientNodePlaceholder ? createCommentVNode('placeholder') : createElementBlock('div')
+ },
+}) as unknown as DefineSetupFnComponent<{}>
+
+export default ServerPlaceholder
diff --git a/packages/nuxt/src/app/components/test-component-wrapper.ts b/packages/nuxt/src/app/components/test-component-wrapper.ts
new file mode 100644
index 000000000000..632d8101a0e0
--- /dev/null
+++ b/packages/nuxt/src/app/components/test-component-wrapper.ts
@@ -0,0 +1,39 @@
+import { defineComponent, h } from 'vue'
+import type { DefineSetupFnComponent } from 'vue'
+import { parseQuery } from 'vue-router'
+import { isAbsolute, relative, resolve } from 'pathe'
+// @ts-expect-error virtual file
+import { devRootDir } from '#build/nuxt.config.mjs'
+
+const testComponentWrapper = (url: string): DefineSetupFnComponent<{}> => defineComponent({
+ name: 'NuxtTestComponentWrapper',
+ inheritAttrs: false,
+ async setup (props, { attrs }) {
+ const query = parseQuery(new URL(url, 'http://localhost').search)
+ let urlProps: Record<string, any> = {}
+ if (query.props) {
+ try {
+ const parsedProps = JSON.parse(query.props as string)
+ if (parsedProps && typeof parsedProps === 'object') {
+ urlProps = parsedProps
+ }
+ } catch {
+ // ignore invalid JSON props in test wrapper
+ }
+ }
+ const path = resolve(query.path as string)
+ const rel = relative(devRootDir, path)
+ if (rel.startsWith('..') || isAbsolute(rel)) {
+ throw new Error(`[nuxt] Cannot access path outside of project root directory: \`${path}\`.`)
+ }
+ const comp = await import(/* @vite-ignore */ path as string).then(r => r.default)
+ return () => [
+ h('div', 'Component Test Wrapper for ' + path),
+ h('div', { id: 'nuxt-component-root' }, [
+ h(comp, { ...attrs, ...props, ...urlProps }),
+ ]),
+ ]
+ },
+}) as unknown as DefineSetupFnComponent<{}>
+
+export default testComponentWrapper
diff --git a/packages/nuxt/src/app/components/utils.ts b/packages/nuxt/src/app/components/utils.ts
new file mode 100644
index 000000000000..81227e0a3f49
--- /dev/null
+++ b/packages/nuxt/src/app/components/utils.ts
@@ -0,0 +1,194 @@
+import { Transition, createStaticVNode, h } from 'vue'
+import type { RendererNode, TransitionProps, VNode } from 'vue'
+import { defu } from 'defu'
+// eslint-disable-next-line
+import { isString, isPromise, isArray, isObject } from '@vue/shared'
+import type { RouteLocationNormalized } from 'vue-router'
+// @ts-expect-error virtual file
+import { START_LOCATION } from '#build/pages'
+
+/**
+ * Internal utility
+ * @private
+ */
+export const _wrapInTransition = (props: any, children: any): { default: () => VNode | undefined } => {
+ return { default: () => import.meta.client && props ? h(Transition, props === true ? {} : props, children) : children.default?.() }
+}
+
+const ROUTE_KEY_PARENTHESES_RE = /(:\w+)\([^)]+\)/g
+const ROUTE_KEY_SYMBOLS_RE = /(:\w+)[?+*]/g
+const ROUTE_KEY_NORMAL_RE = /:\w+/g
+// TODO: consider refactoring into single utility
+// See https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/pages/runtime/utils.ts#L8-L19
+function generateRouteKey (route: RouteLocationNormalized) {
+ const source = route?.meta.key ?? route.path
+ .replace(ROUTE_KEY_PARENTHESES_RE, '$1')
+ .replace(ROUTE_KEY_SYMBOLS_RE, '$1')
+ .replace(ROUTE_KEY_NORMAL_RE, r => route.params[r.slice(1)]?.toString() || '')
+ return typeof source === 'function' ? source(route) : source
+}
+
+/**
+ * Utility used within router guards
+ * return true if the route has been changed with a page change during navigation
+ */
+export function isChangingPage (to: RouteLocationNormalized, from: RouteLocationNormalized): boolean {
+ if (to === from || from === START_LOCATION) { return false }
+
+ // If route keys are different then it will result in a rerender
+ if (generateRouteKey(to) !== generateRouteKey(from)) { return true }
+
+ const areComponentsSame = to.matched.every((comp, index) =>
+ comp.components && comp.components.default === from.matched[index]?.components?.default,
+ )
+ if (areComponentsSame) {
+ return false
+ }
+ return true
+}
+
+export type SSRBuffer = SSRBufferItem[] & { hasAsync?: boolean }
+export type SSRBufferItem = string | SSRBuffer | Promise<SSRBuffer>
+
+/**
+ * create buffer retrieved from @vue/server-renderer
+ * @see https://github.com/vuejs/core/blob/9617dd4b2abc07a5dc40de6e5b759e851b4d0da1/packages/server-renderer/src/render.ts#L57
+ * @private
+ */
+export function createBuffer (): { getBuffer: () => SSRBuffer, push: (item: SSRBufferItem) => void } {
+ let appendable = false
+ const buffer: SSRBuffer = []
+ return {
+ getBuffer (): SSRBuffer {
+ return buffer
+ },
+ push (item: SSRBufferItem) {
+ const isStringItem = isString(item)
+ if (appendable && isStringItem) {
+ buffer[buffer.length - 1] += item as string
+ } else {
+ buffer.push(item)
+ }
+ appendable = isStringItem
+ if (isPromise(item) || (isArray(item) && item.hasAsync)) {
+ buffer.hasAsync = true
+ }
+ },
+ }
+}
+
+/**
+ * helper for NuxtIsland to generate a correct array for scoped data
+ */
+export function vforToArray (source: any): any[] {
+ if (isArray(source)) {
+ return source
+ } else if (isString(source)) {
+ return source.split('')
+ } else if (typeof source === 'number') {
+ if (import.meta.dev && !Number.isInteger(source)) {
+ console.warn(`The v-for range expect an integer value but got ${source}.`)
+ }
+ const array: number[] = []
+ for (let i = 0; i < source; i++) {
+ array[i] = i
+ }
+ return array
+ } else if (isObject(source)) {
+ if (source[Symbol.iterator as any]) {
+ return Array.from(source as Iterable<any>, item =>
+ item,
+ )
+ } else {
+ const keys = Object.keys(source)
+ const array = new Array(keys.length)
+ for (let i = 0, l = keys.length; i < l; i++) {
+ const key = keys[i]!
+ array[i] = source[key]
+ }
+ return array
+ }
+ }
+ return []
+}
+
+/**
+ * Retrieve the HTML content from an element
+ * Handles `<!--[-->` Fragment elements
+ * @param element the element to retrieve the HTML
+ * @param withoutSlots purge all slots from the HTML string retrieved
+ * @returns {string[]|undefined} An array of string which represent the content of each element. Use `.join('')` to retrieve a component vnode.el HTML
+ */
+export function getFragmentHTML (element: RendererNode | null, withoutSlots = false): string[] | undefined {
+ if (element) {
+ if (element.nodeName === '#comment' && element.nodeValue === '[') {
+ return getFragmentChildren(element, [], withoutSlots)
+ }
+ if (withoutSlots) {
+ const clone = element.cloneNode(true)
+ clone.querySelectorAll('[data-island-slot]').forEach((n: Element) => { n.innerHTML = '' })
+ return [clone.outerHTML]
+ }
+ return [element.outerHTML]
+ }
+}
+
+function getFragmentChildren (element: RendererNode | null, blocks: string[] = [], withoutSlots = false) {
+ if (element && element.nodeName) {
+ if (isEndFragment(element)) {
+ return blocks
+ } else if (!isStartFragment(element)) {
+ const clone = element.cloneNode(true) as Element
+ if (withoutSlots) {
+ clone.querySelectorAll?.('[data-island-slot]').forEach((n) => { n.innerHTML = '' })
+ }
+ blocks.push(clone.outerHTML)
+ }
+
+ getFragmentChildren(element.nextSibling, blocks, withoutSlots)
+ }
+ return blocks
+}
+
+/**
+ * Return a static vnode from an element
+ * Default to a div if the element is not found and if a fallback is not provided
+ * @param el renderer node retrieved from the component internal instance
+ * @param staticNodeFallback fallback string to use if the element is not found. Must be a valid HTML string
+ */
+export function elToStaticVNode (el: RendererNode | null, staticNodeFallback?: string): VNode {
+ const fragment: string[] | undefined = el ? getFragmentHTML(el) : staticNodeFallback ? [staticNodeFallback] : undefined
+ if (fragment) {
+ return createStaticVNode(fragment.join(''), fragment.length)
+ }
+ return h('div')
+}
+
+export function isStartFragment (element: RendererNode): boolean {
+ return element.nodeName === '#comment' && element.nodeValue === '['
+}
+
+export function isEndFragment (element: RendererNode): boolean {
+ return element.nodeName === '#comment' && element.nodeValue === ']'
+}
+
+export function toArray<T> (value: T | T[]): T[] {
+ return Array.isArray(value) ? value : [value]
+}
+
+/**
+ * Internal utility
+ * @private
+ */
+export function _mergeTransitionProps (routeProps: TransitionProps[]): TransitionProps {
+ const _props: TransitionProps[] = []
+ for (const prop of routeProps) {
+ if (!prop) { continue }
+ _props.push({
+ ...prop,
+ onAfterLeave: prop.onAfterLeave ? toArray(prop.onAfterLeave) : undefined,
+ onBeforeLeave: prop.onBeforeLeave ? toArray(prop.onBeforeLeave) : undefined,
+ })
+ }
+ return defu(..._props as [TransitionProps, TransitionProps])
+}
diff --git a/packages/nuxt/src/app/composables/announcer.ts b/packages/nuxt/src/app/composables/announcer.ts
new file mode 100644
index 000000000000..2054b1e97430
--- /dev/null
+++ b/packages/nuxt/src/app/composables/announcer.ts
@@ -0,0 +1,85 @@
+import type { Ref } from 'vue'
+import { getCurrentScope, onScopeDispose, shallowRef } from 'vue'
+import { useNuxtApp } from '../nuxt'
+
+export type AnnouncerPoliteness = 'assertive' | 'polite' | 'off'
+
+export type NuxtAnnouncerOpts = {
+ /** @default 'polite' */
+ politeness?: AnnouncerPoliteness
+}
+
+export type NuxtAnnouncer = {
+ message: Ref<string>
+ politeness: Ref<AnnouncerPoliteness>
+ set: (message: string, politeness?: AnnouncerPoliteness) => void
+ polite: (message: string) => void
+ assertive: (message: string) => void
+ _cleanup: () => void
+}
+
+function createAnnouncer (opts: NuxtAnnouncerOpts = {}): NuxtAnnouncer {
+ const message = shallowRef('')
+ const politeness = shallowRef<AnnouncerPoliteness>(opts.politeness || 'polite')
+
+ function set (messageValue: string = '', politenessSetting: AnnouncerPoliteness = 'polite') {
+ message.value = messageValue
+ politeness.value = politenessSetting
+ }
+
+ function polite (msg: string) {
+ set(msg, 'polite')
+ }
+
+ function assertive (msg: string) {
+ set(msg, 'assertive')
+ }
+
+ function _cleanup () {
+ message.value = ''
+ politeness.value = opts.politeness || 'polite'
+ }
+
+ return {
+ message,
+ politeness,
+ set,
+ polite,
+ assertive,
+ _cleanup,
+ }
+}
+
+/**
+ * Composable for announcing messages to screen readers
+ * @since 3.17.0
+ * @example
+ * const { polite, assertive } = useAnnouncer()
+ * polite('Item saved successfully')
+ * assertive('Error: Form is invalid')
+ */
+export function useAnnouncer (opts: NuxtAnnouncerOpts = {}): Omit<NuxtAnnouncer, '_cleanup'> {
+ const nuxtApp = useNuxtApp()
+
+ // Initialise global announcer if it doesn't exist already
+ const announcer = nuxtApp._announcer ||= createAnnouncer(opts)
+
+ // Update politeness if different from current
+ if (opts.politeness && opts.politeness !== announcer.politeness.value) {
+ announcer.politeness.value = opts.politeness
+ }
+
+ if (import.meta.client && getCurrentScope()) {
+ nuxtApp._announcerDeps ||= 0
+ nuxtApp._announcerDeps++
+ onScopeDispose(() => {
+ nuxtApp._announcerDeps!--
+ if (nuxtApp._announcerDeps === 0) {
+ announcer._cleanup()
+ delete nuxtApp._announcer
+ }
+ })
+ }
+
+ return announcer
+}
diff --git a/packages/nuxt/src/app/composables/asyncContext.ts b/packages/nuxt/src/app/composables/asyncContext.ts
new file mode 100644
index 000000000000..2c11f1b43333
--- /dev/null
+++ b/packages/nuxt/src/app/composables/asyncContext.ts
@@ -0,0 +1,10 @@
+// @ts-expect-error withAsyncContext is internal API
+import { getCurrentInstance, withAsyncContext as withVueAsyncContext } from 'vue'
+
+/** @since 3.8.0 */
+export function withAsyncContext (fn: () => PromiseLike<unknown>): [unknown, () => void] {
+ return withVueAsyncContext(() => {
+ const nuxtApp = getCurrentInstance()?.appContext.app.$nuxt
+ return nuxtApp ? nuxtApp.runWithContext(fn) : fn()
+ })
+}
diff --git a/packages/nuxt/src/app/composables/asyncData.ts b/packages/nuxt/src/app/composables/asyncData.ts
new file mode 100644
index 000000000000..c063d4837acd
--- /dev/null
+++ b/packages/nuxt/src/app/composables/asyncData.ts
@@ -0,0 +1,1004 @@
+import { computed, getCurrentInstance, getCurrentScope, inject, isRef, isShallow, nextTick, onBeforeMount, onScopeDispose, onServerPrefetch, onUnmounted, queuePostFlushCb, ref, shallowRef, toRef, toValue, unref, watch } from 'vue'
+import type { ComputedRef, MaybeRefOrGetter, MultiWatchSources, Ref } from 'vue'
+import { debounce } from 'perfect-debounce'
+import { hash } from 'ohash'
+import type { NuxtApp } from '../nuxt'
+import { useNuxtApp } from '../nuxt'
+import { getUserCaller, toArray } from '../utils'
+import { clientOnlySymbol } from '../components/client-only'
+import type { NuxtError } from './error'
+import { createError } from './error'
+import { onNuxtReady } from './ready'
+import { defineKeyedFunctionFactory } from '../../compiler/runtime'
+
+// @ts-expect-error virtual file
+import { asyncDataDefaults, granularCachedData, pendingWhenIdle, purgeCachedData } from '#build/nuxt.config.mjs'
+
+export type AsyncDataRequestStatus = 'idle' | 'pending' | 'success' | 'error'
+
+export type _Transform<Input = any, Output = any> = (input: Input) => Output | Promise<Output>
+
+export type AsyncDataHandler<ResT> = (nuxtApp: NuxtApp, options: { signal: AbortSignal }) => Promise<ResT>
+
+export type PickFrom<T, K extends Array<string>> = T extends Array<any>
+ ? T
+ : T extends Record<string, any>
+ ? keyof T extends K[number]
+ ? T // Exact same keys as the target, skip Pick
+ : K[number] extends never
+ ? T
+ : Pick<T, K[number]>
+ : T
+
+export type KeysOf<T> = Array<
+ T extends T // Include all keys of union types, not just common keys
+ ? keyof T extends string
+ ? keyof T
+ : never
+ : never
+>
+
+export type KeyOfRes<Transform extends _Transform> = KeysOf<ReturnType<Transform>>
+
+export type { MultiWatchSources }
+
+export type NoInfer<T> = [T][T extends any ? 0 : never]
+
+export type AsyncDataRefreshCause = 'initial' | 'refresh:hook' | 'refresh:manual' | 'watch'
+
+interface BaseAsyncDataOptions<
+ ResT,
+ DataT = ResT,
+ PickKeys extends KeysOf<DataT> = KeysOf<DataT>,
+ DefaultT = undefined,
+> {
+ /**
+ * Whether to fetch on the server side.
+ * @default true
+ */
+ server?: boolean
+ /**
+ * Whether to resolve the async function after loading the route, instead of blocking client-side navigation
+ * @default false
+ */
+ lazy?: boolean
+ /**
+ * a factory function to set the default value of the data, before the async function resolves - useful with the `lazy: true` or `immediate: false` options
+ */
+ default?: () => DefaultT | Ref<DefaultT>
+ /**
+ * Only pick specified keys in this array from the handler function result.
+ * Do not use it along with the `transform` option.
+ */
+ pick?: PickKeys
+ /**
+ * Watch reactive sources to auto-refresh when changed
+ */
+ watch?: MultiWatchSources
+ /**
+ * When set to false, will prevent the request from firing immediately
+ * @default true
+ */
+ immediate?: boolean
+ /**
+ * Return data in a deep ref object (it is false by default). It can be set to false to return data in a shallow ref object, which can improve performance if your data does not need to be deeply reactive.
+ */
+ deep?: boolean
+ /**
+ * Avoid fetching the same key more than once at a time
+ * @default 'cancel'
+ */
+ dedupe?: 'cancel' | 'defer'
+ /**
+ * A timeout in milliseconds after which the request will be aborted if it has not resolved yet.
+ */
+ timeout?: number
+}
+
+export interface AsyncDataOptions<
+ ResT,
+ DataT = ResT,
+ PickKeys extends KeysOf<DataT> = KeysOf<DataT>,
+ DefaultT = undefined,
+> extends BaseAsyncDataOptions<ResT, DataT, PickKeys, DefaultT> {
+ /**
+ * Provide a function which returns cached data.
+ * An `undefined` return value will trigger a fetch.
+ * Default is `key => nuxt.isHydrating ? nuxt.payload.data[key] : nuxt.static.data[key]` which only caches data when payloadExtraction is enabled.
+ */
+ getCachedData?: (key: string, nuxtApp: NuxtApp, context: { cause: AsyncDataRefreshCause }) => NoInfer<DataT> | undefined
+ /**
+ * A function that can be used to alter handler function result after resolving.
+ * Do not use it along with the `pick` option.
+ */
+ transform?: _Transform<ResT, DataT>
+}
+
+export interface AsyncDataOptionsWithTransform<
+ ResT,
+ DataT = ResT,
+ PickKeys extends KeysOf<DataT> = KeysOf<DataT>,
+ DefaultT = undefined,
+> extends BaseAsyncDataOptions<ResT, DataT, PickKeys, DefaultT> {
+ /**
+ * Provide a function which returns cached data.
+ * An `undefined` return value will trigger a fetch.
+ * Default is `key => nuxt.isHydrating ? nuxt.payload.data[key] : nuxt.static.data[key]` which only caches data when payloadExtraction is enabled.
+ */
+ getCachedData?: (key: string, nuxtApp: NuxtApp, context: { cause: AsyncDataRefreshCause }) => NoInfer<DataT | undefined>
+ /**
+ * A function that can be used to alter handler function result after resolving.
+ * Do not use it along with the `pick` option.
+ */
+ transform: _Transform<ResT, DataT>
+}
+
+export interface AsyncDataExecuteOptions {
+ /**
+ * Force a refresh, even if there is already a pending request. Previous requests will
+ * not be cancelled, but their result will not affect the data/pending state - and any
+ * previously awaited promises will not resolve until this new request resolves.
+ */
+ dedupe?: 'cancel' | 'defer'
+
+ cause?: AsyncDataRefreshCause
+
+ /** @internal */
+ cachedData?: any
+
+ signal?: AbortSignal
+
+ timeout?: number
+}
+
+export interface _AsyncData<DataT, ErrorT> {
+ data: Ref<DataT>
+ pending: Ref<boolean>
+ refresh: (opts?: AsyncDataExecuteOptions) => Promise<void>
+ execute: (opts?: AsyncDataExecuteOptions) => Promise<void>
+ clear: () => void
+ error: Ref<ErrorT | undefined>
+ status: Ref<AsyncDataRequestStatus>
+}
+
+export type AsyncData<Data, Error> = _AsyncData<Data, Error> & Promise<_AsyncData<Data, Error>>
+
+// Type of the public-facing `useAsyncData` returned by the factory below.
+// Expressed as a callable interface so we can spell out all eight overloads
+// without losing them in an inline function expression: oxc's isolated
+// declarations dts pipeline can't infer them otherwise.
+type NuxtErrorFor<NuxtErrorDataT> = NuxtErrorDataT extends Error | NuxtError ? NuxtErrorDataT : NuxtError<NuxtErrorDataT>
+type FactoryDataT<FDataT, ResT> = [unknown] extends [FDataT] ? ResT : FDataT
+type FactoryDefaultT<FDefaultT, Fallback> = [undefined] extends [FDefaultT] ? Fallback : FDefaultT
+type FactoryPickKeys<FPickKeys, PickKeys, DataT> = [Array<never>] extends [FPickKeys] ? PickKeys : FPickKeys & KeysOf<DataT>
+export interface UseAsyncData<FResT = unknown, FDataT = unknown, FPickKeys extends KeysOf<FDataT> = never[], FDefaultT = undefined> {
+ // Auto-key, opts with transform, default = undefined
+ <ResT = FResT, NuxtErrorDataT = unknown, DataT = ResT, PickKeys extends KeysOf<DataT> = KeysOf<DataT>, DefaultT = FactoryDefaultT<FDefaultT, undefined>>(
+ handler: AsyncDataHandler<ResT>,
+ opts: AsyncDataOptionsWithTransform<ResT, DataT, PickKeys, DefaultT>,
+ ): AsyncData<PickFrom<DataT, PickKeys> | DefaultT, NuxtErrorFor<NuxtErrorDataT> | undefined>
+ // Auto-key, opts with transform, default = DataT
+ <ResT = FResT, NuxtErrorDataT = unknown, DataT = ResT, PickKeys extends KeysOf<DataT> = KeysOf<DataT>, DefaultT = FactoryDefaultT<FDefaultT, DataT>>(
+ handler: AsyncDataHandler<ResT>,
+ opts: AsyncDataOptionsWithTransform<ResT, DataT, PickKeys, DefaultT>,
+ ): AsyncData<PickFrom<DataT, PickKeys> | DefaultT, NuxtErrorFor<NuxtErrorDataT> | undefined>
+ // Auto-key, plain opts, default = undefined
+ <ResT = FResT, NuxtErrorDataT = unknown, DataT = FactoryDataT<FDataT, ResT>, PickKeys extends KeysOf<DataT> = KeysOf<DataT>, DefaultT = FactoryDefaultT<FDefaultT, undefined>>(
+ handler: AsyncDataHandler<ResT>,
+ opts?: AsyncDataOptions<ResT, DataT, PickKeys, DefaultT>,
+ ): AsyncData<PickFrom<DataT, FactoryPickKeys<FPickKeys, PickKeys, DataT>> | DefaultT, NuxtErrorFor<NuxtErrorDataT> | undefined>
+ // Auto-key, plain opts, default = DataT
+ <ResT = FResT, NuxtErrorDataT = unknown, DataT = FactoryDataT<FDataT, ResT>, PickKeys extends KeysOf<DataT> = KeysOf<DataT>, DefaultT = FactoryDefaultT<FDefaultT, DataT>>(
+ handler: AsyncDataHandler<ResT>,
+ opts?: AsyncDataOptions<ResT, DataT, PickKeys, DefaultT>,
+ ): AsyncData<PickFrom<DataT, FactoryPickKeys<FPickKeys, PickKeys, DataT>> | DefaultT, NuxtErrorFor<NuxtErrorDataT> | undefined>
+ // Explicit key, opts with transform, default = undefined
+ <ResT = FResT, NuxtErrorDataT = unknown, DataT = ResT, PickKeys extends KeysOf<DataT> = KeysOf<DataT>, DefaultT = FactoryDefaultT<FDefaultT, undefined>>(
+ key: MaybeRefOrGetter<string>,
+ handler: AsyncDataHandler<ResT>,
+ opts: AsyncDataOptionsWithTransform<ResT, DataT, PickKeys, DefaultT>,
+ ): AsyncData<PickFrom<DataT, PickKeys> | DefaultT, NuxtErrorFor<NuxtErrorDataT> | undefined>
+ // Explicit key, opts with transform, default = DataT
+ <ResT = FResT, NuxtErrorDataT = unknown, DataT = ResT, PickKeys extends KeysOf<DataT> = KeysOf<DataT>, DefaultT = FactoryDefaultT<FDefaultT, DataT>>(
+ key: MaybeRefOrGetter<string>,
+ handler: AsyncDataHandler<ResT>,
+ opts: AsyncDataOptionsWithTransform<ResT, DataT, PickKeys, DefaultT>,
+ ): AsyncData<PickFrom<DataT, PickKeys> | DefaultT, NuxtErrorFor<NuxtErrorDataT> | undefined>
+ // Explicit key, plain opts, default = undefined
+ <ResT = FResT, NuxtErrorDataT = unknown, DataT = FactoryDataT<FDataT, ResT>, PickKeys extends KeysOf<DataT> = KeysOf<DataT>, DefaultT = FactoryDefaultT<FDefaultT, undefined>>(
+ key: MaybeRefOrGetter<string>,
+ handler: AsyncDataHandler<ResT>,
+ opts?: AsyncDataOptions<ResT, DataT, PickKeys, DefaultT>,
+ ): AsyncData<PickFrom<DataT, FactoryPickKeys<FPickKeys, PickKeys, DataT>> | DefaultT, NuxtErrorFor<NuxtErrorDataT> | undefined>
+ // Explicit key, plain opts, default = DataT
+ <ResT = FResT, NuxtErrorDataT = unknown, DataT = FactoryDataT<FDataT, ResT>, PickKeys extends KeysOf<DataT> = KeysOf<DataT>, DefaultT = FactoryDefaultT<FDefaultT, DataT>>(
+ key: MaybeRefOrGetter<string>,
+ handler: AsyncDataHandler<ResT>,
+ opts?: AsyncDataOptions<ResT, DataT, PickKeys, DefaultT>,
+ ): AsyncData<PickFrom<DataT, FactoryPickKeys<FPickKeys, PickKeys, DataT>> | DefaultT, NuxtErrorFor<NuxtErrorDataT> | undefined>
+}
+
+export interface CreateUseAsyncData {
+ <FResT, FDataT = FResT, FPickKeys extends KeysOf<FDataT> = KeysOf<FDataT>, FDefaultT = undefined>(
+ options?:
+ | Partial<AsyncDataOptions<FResT, FDataT, FPickKeys, FDefaultT>>
+ | ((callerOptions: AsyncDataOptions<unknown>) => Partial<AsyncDataOptions<FResT, FDataT, FPickKeys, FDefaultT>>),
+ ): UseAsyncData<FResT, FDataT, FPickKeys, FDefaultT>
+}
+
+export const createUseAsyncData: CreateUseAsyncData = defineKeyedFunctionFactory<CreateUseAsyncData>({
+ name: 'createUseAsyncData',
+ factory<
+ FResT,
+ FDataT = FResT,
+ FPickKeys extends KeysOf<FDataT> = KeysOf<FDataT>,
+ FDefaultT = undefined,
+ >(options:
+ Partial<AsyncDataOptions<FResT, FDataT, FPickKeys, FDefaultT>>
+ | ((callerOptions: AsyncDataOptions<unknown>) => Partial<AsyncDataOptions<FResT, FDataT, FPickKeys, FDefaultT>>) = {},
+ ): UseAsyncData<FResT, FDataT, FPickKeys, FDefaultT> {
+ /**
+ * Provides access to data that resolves asynchronously in an SSR-friendly composable.
+ * See {@link https://nuxt.com/docs/4.x/api/composables/use-async-data}
+ * @since 3.0.0
+ * @param handler An asynchronous function that must return a truthy value (for example, it should not be `undefined` or `null`) or the request may be duplicated on the client side.
+ * @param opts customize the behavior of useAsyncData
+ */
+ function useAsyncData<
+ ResT,
+ NuxtErrorDataT = unknown,
+ DataT = ResT,
+ PickKeys extends KeysOf<DataT> = KeysOf<DataT>,
+ DefaultT = [undefined] extends [FDefaultT] ? undefined : FDefaultT,
+ > (
+ handler: AsyncDataHandler<ResT>,
+ opts: AsyncDataOptionsWithTransform<ResT, DataT, PickKeys, DefaultT>,
+ ): AsyncData<PickFrom<DataT, PickKeys> | DefaultT, (NuxtErrorDataT extends Error | NuxtError ? NuxtErrorDataT : NuxtError<NuxtErrorDataT>) | undefined>
+ function useAsyncData<
+ ResT,
+ NuxtErrorDataT = unknown,
+ DataT = ResT,
+ PickKeys extends KeysOf<DataT> = KeysOf<DataT>,
+ DefaultT = [undefined] extends [FDefaultT] ? DataT : FDefaultT,
+ > (
+ handler: AsyncDataHandler<ResT>,
+ opts: AsyncDataOptionsWithTransform<ResT, DataT, PickKeys, DefaultT>,
+ ): AsyncData<PickFrom<DataT, PickKeys> | DefaultT, (NuxtErrorDataT extends Error | NuxtError ? NuxtErrorDataT : NuxtError<NuxtErrorDataT>) | undefined>
+ function useAsyncData<
+ ResT,
+ NuxtErrorDataT = unknown,
+ DataT = [unknown] extends [FDataT] ? ResT : FDataT,
+ PickKeys extends KeysOf<DataT> = KeysOf<DataT>,
+ DefaultT = [undefined] extends [FDefaultT] ? undefined : FDefaultT,
+ > (
+ handler: AsyncDataHandler<ResT>,
+ opts?: AsyncDataOptions<ResT, DataT, PickKeys, DefaultT>,
+ ): AsyncData<PickFrom<DataT, [Array<never>] extends [FPickKeys] ? PickKeys : FPickKeys & KeysOf<DataT>> | DefaultT, (NuxtErrorDataT extends Error | NuxtError ? NuxtErrorDataT : NuxtError<NuxtErrorDataT>) | undefined>
+ function useAsyncData<
+ ResT,
+ NuxtErrorDataT = unknown,
+ DataT = [unknown] extends [FDataT] ? ResT : FDataT,
+ PickKeys extends KeysOf<DataT> = KeysOf<DataT>,
+ DefaultT = [undefined] extends [FDefaultT] ? DataT : FDefaultT,
+ > (
+ handler: AsyncDataHandler<ResT>,
+ opts?: AsyncDataOptions<ResT, DataT, PickKeys, DefaultT>,
+ ): AsyncData<PickFrom<DataT, [Array<never>] extends [FPickKeys] ? PickKeys : FPickKeys & KeysOf<DataT>> | DefaultT, (NuxtErrorDataT extends Error | NuxtError ? NuxtErrorDataT : NuxtError<NuxtErrorDataT>) | undefined>
+ /**
+ * Provides access to data that resolves asynchronously in an SSR-friendly composable.
+ * See {@link https://nuxt.com/docs/4.x/api/composables/use-async-data}
+ * @param key A unique key to ensure that data fetching can be properly de-duplicated across requests.
+ * @param handler An asynchronous function that must return a truthy value (for example, it should not be `undefined` or `null`) or the request may be duplicated on the client side.
+ * @param opts customize the behavior of useAsyncData
+ */
+ function useAsyncData<
+ ResT,
+ NuxtErrorDataT = unknown,
+ DataT = ResT,
+ PickKeys extends KeysOf<DataT> = KeysOf<DataT>,
+ DefaultT = [undefined] extends [FDefaultT] ? undefined : FDefaultT,
+ > (
+ key: MaybeRefOrGetter<string>,
+ handler: AsyncDataHandler<ResT>,
+ opts: AsyncDataOptionsWithTransform<ResT, DataT, PickKeys, DefaultT>,
+ ): AsyncData<PickFrom<DataT, PickKeys> | DefaultT, (NuxtErrorDataT extends Error | NuxtError ? NuxtErrorDataT : NuxtError<NuxtErrorDataT>) | undefined>
+ function useAsyncData<
+ ResT,
+ NuxtErrorDataT = unknown,
+ DataT = ResT,
+ PickKeys extends KeysOf<DataT> = KeysOf<DataT>,
+ DefaultT = [undefined] extends [FDefaultT] ? DataT : FDefaultT,
+ > (
+ key: MaybeRefOrGetter<string>,
+ handler: AsyncDataHandler<ResT>,
+ opts: AsyncDataOptionsWithTransform<ResT, DataT, PickKeys, DefaultT>,
+ ): AsyncData<PickFrom<DataT, PickKeys> | DefaultT, (NuxtErrorDataT extends Error | NuxtError ? NuxtErrorDataT : NuxtError<NuxtErrorDataT>) | undefined>
+ function useAsyncData<
+ ResT,
+ NuxtErrorDataT = unknown,
+ DataT = [unknown] extends [FDataT] ? ResT : FDataT,
+ PickKeys extends KeysOf<DataT> = KeysOf<DataT>,
+ DefaultT = [undefined] extends [FDefaultT] ? undefined : FDefaultT,
+ > (
+ key: MaybeRefOrGetter<string>,
+ handler: AsyncDataHandler<ResT>,
+ opts?: AsyncDataOptions<ResT, DataT, PickKeys, DefaultT>,
+ ): AsyncData<PickFrom<DataT, [Array<never>] extends [FPickKeys] ? PickKeys : FPickKeys & KeysOf<DataT>> | DefaultT, (NuxtErrorDataT extends Error | NuxtError ? NuxtErrorDataT : NuxtError<NuxtErrorDataT>) | undefined>
+ function useAsyncData<
+ ResT,
+ NuxtErrorDataT = unknown,
+ DataT = [unknown] extends [FDataT] ? ResT : FDataT,
+ PickKeys extends KeysOf<DataT> = KeysOf<DataT>,
+ DefaultT = [undefined] extends [FDefaultT] ? DataT : FDefaultT,
+ > (
+ key: MaybeRefOrGetter<string>,
+ handler: AsyncDataHandler<ResT>,
+ opts?: AsyncDataOptions<ResT, DataT, PickKeys, DefaultT>,
+ ): AsyncData<PickFrom<DataT, [Array<never>] extends [FPickKeys] ? PickKeys : FPickKeys & KeysOf<DataT>> | DefaultT, (NuxtErrorDataT extends Error | NuxtError ? NuxtErrorDataT : NuxtError<NuxtErrorDataT>) | undefined>
+ function useAsyncData<
+ ResT,
+ NuxtErrorDataT = unknown,
+ DataT = ResT,
+ PickKeys extends KeysOf<DataT> = KeysOf<DataT>,
+ DefaultT = undefined,
+ > (...args: any[]): AsyncData<PickFrom<DataT, PickKeys>, (NuxtErrorDataT extends Error | NuxtError ? NuxtErrorDataT : NuxtError<NuxtErrorDataT>) | undefined> {
+ const autoKey = typeof args[args.length - 1] === 'string' ? args.pop() : undefined
+ if (_isAutoKeyNeeded(args[0], args[1])) { args.unshift(autoKey) }
+
+ // eslint-disable-next-line prefer-const
+ let [_key, _handler, opts = {}] = args as [MaybeRefOrGetter<string>, AsyncDataHandler<ResT>, AsyncDataOptions<ResT, DataT, PickKeys, DefaultT>]
+ let keyChanging = false
+ /** True if key is a Ref or getter; false for static string. When false, key watcher is skipped. */
+ const isKeyReactive = isRef(_key) || typeof _key === 'function'
+
+ // Validate arguments
+ const key = (isKeyReactive ? computed(() => toValue(_key)!) : { value: _key as string }) as { readonly value: string }
+ if (!key.value || typeof key.value !== 'string') {
+ throw new TypeError('[nuxt] [useAsyncData] key must be a non-empty string.')
+ }
+ if (typeof _handler !== 'function') {
+ throw new TypeError('[nuxt] [useAsyncData] handler must be a function.')
+ }
+
+ const shouldFactoryOptionsOverride = typeof options === 'function'
+
+ // Setup nuxt instance payload
+ const nuxtApp = useNuxtApp()
+
+ const factoryOptions = shouldFactoryOptionsOverride ? options(opts as any) : options
+ // assign factory defaults
+ if (!shouldFactoryOptionsOverride) {
+ for (const key in factoryOptions) {
+ // factory doesn't have a value set for the key
+ if (factoryOptions[key as keyof typeof factoryOptions] === undefined) { continue }
+ // opts already has a value set for the key
+ if (opts[key as keyof typeof opts] !== undefined) { continue }
+ opts[key as keyof typeof opts] = factoryOptions[key as keyof typeof factoryOptions] as any
+ }
+ }
+
+ opts.server ??= true
+ opts.default ??= getDefault as () => DefaultT
+ opts.getCachedData ??= getDefaultCachedData
+
+ opts.lazy ??= false
+ opts.immediate ??= true
+ opts.deep ??= asyncDataDefaults.deep
+ opts.dedupe ??= 'cancel'
+
+ // assign overrides from factory
+ if (shouldFactoryOptionsOverride) {
+ for (const key in factoryOptions) {
+ if (factoryOptions[key as keyof typeof factoryOptions] === undefined) { continue }
+ opts[key as keyof typeof opts] = factoryOptions[key as keyof typeof factoryOptions] as any
+ }
+ }
+
+ // internal property (dev-only, used for warning messages)
+ const functionName = import.meta.dev
+ ? (factoryOptions as typeof factoryOptions & { _functionName?: string })._functionName || 'useAsyncData'
+ : ''
+
+ // check and warn if different defaults/fetcher are provided
+ const currentData = nuxtApp._asyncData[key.value]
+ if (import.meta.dev && currentData) {
+ const warnings: string[] = []
+ const values = createHash(_handler, opts)
+ if (values.handler !== currentData._hash?.handler) {
+ warnings.push(`different handler`)
+ }
+ for (const opt of ['transform', 'pick', 'getCachedData'] as const) {
+ if (values[opt] !== currentData._hash![opt]) {
+ warnings.push(`different \`${opt}\` option`)
+ }
+ }
+ if (currentData._default.toString() !== opts.default.toString()) {
+ warnings.push(`different \`default\` value`)
+ }
+ if (opts.deep && isShallow(currentData.data)) {
+ warnings.push(`mismatching \`deep\` option`)
+ }
+ if (warnings.length) {
+ const caller = getUserCaller()
+ const explanation = caller ? ` (used at ${caller.source}:${caller.line}:${caller.column})` : ''
+ console.warn(`[nuxt] [${functionName}] Incompatible options detected for "${key.value}"${explanation}:\n${warnings.map(w => `- ${w}`).join('\n')}\nYou can use a different key or move the call to a composable to ensure the options are shared across calls.`)
+ }
+ }
+
+ // Create or use a shared asyncData entity
+ function createInitialFetch () {
+ const initialFetchOptions: AsyncDataExecuteOptions = { cause: 'initial', dedupe: opts.dedupe }
+ const existing = nuxtApp._asyncData[key.value]
+ if (!existing?._init) {
+ initialFetchOptions.cachedData = opts.getCachedData!(key.value, nuxtApp, { cause: 'initial' })
+ nuxtApp._asyncData[key.value] = buildAsyncData(nuxtApp, key.value, _handler, opts, initialFetchOptions.cachedData)
+ nuxtApp._asyncData[key.value]!._initialCachedData = initialFetchOptions.cachedData
+ } else if (nuxtApp._asyncDataPromises[key.value]) {
+ // reuse the cache lookup performed by the first concurrent caller while their fetch is still in flight
+ initialFetchOptions.cachedData = existing._initialCachedData
+ }
+ // otherwise let execute() perform a fresh getCachedData lookup so subscribers that mount
+ // after the initial fetch has settled still go through getCachedData (#35116)
+ return () => nuxtApp._asyncData[key.value]!.execute(initialFetchOptions)
+ }
+
+ const initialFetch = createInitialFetch()
+ const asyncData = nuxtApp._asyncData[key.value]!
+
+ asyncData._deps++
+
+ const fetchOnServer = opts.server !== false && nuxtApp.payload.serverRendered
+
+ // Server side
+ if (import.meta.server && fetchOnServer && opts.immediate) {
+ const promise = initialFetch()
+ if (getCurrentInstance()) {
+ onServerPrefetch(() => promise)
+ } else {
+ nuxtApp.hook('app:created', async () => { await promise })
+ }
+ }
+
+ // Client side
+ if (import.meta.client) {
+ // Setup hook callbacks once per instance
+ const instance = getCurrentInstance()
+
+ // @ts-expect-error - instance.sp is an internal vue property
+ if (instance && fetchOnServer && opts.immediate && !instance.sp) {
+ // @ts-expect-error - internal vue property. This force vue to mark the component as async boundary client-side to avoid useId hydration issue since we treeshake onServerPrefetch
+ instance.sp = []
+ }
+ if (import.meta.dev && !nuxtApp.isHydrating && !nuxtApp._processingMiddleware /* internal flag */ && (!instance || instance?.isMounted)) {
+ console.warn(`[nuxt] [${functionName}] Component is already mounted, please use $fetch instead. See https://nuxt.com/docs/4.x/getting-started/data-fetching`)
+ }
+ if (instance && !instance._nuxtOnBeforeMountCbs) {
+ instance._nuxtOnBeforeMountCbs = []
+ const cbs = instance._nuxtOnBeforeMountCbs
+ onBeforeMount(() => {
+ cbs.forEach((cb) => { cb() })
+ cbs.splice(0, cbs.length)
+ })
+ onUnmounted(() => cbs.splice(0, cbs.length))
+ }
+
+ const isWithinClientOnly = instance && (instance._nuxtClientOnly || inject(clientOnlySymbol, false))
+
+ if (fetchOnServer && nuxtApp.isHydrating && (asyncData.error.value || asyncData.data.value !== undefined)) {
+ // 1. Hydration (server: true): no fetch
+ if (pendingWhenIdle) {
+ asyncData.pending.value = false
+ }
+ asyncData.status.value = asyncData.error.value ? 'error' : 'success'
+ } else if (instance && ((!isWithinClientOnly && nuxtApp.payload.serverRendered && nuxtApp.isHydrating) || opts.lazy) && opts.immediate) {
+ // 2. Initial load (server: false): fetch on mounted
+ // 3. Initial load or navigation (lazy: true): fetch on mounted
+ instance._nuxtOnBeforeMountCbs.push(initialFetch)
+ } else if (opts.immediate && asyncData.status.value !== 'success') {
+ // 4. Navigation (lazy: false) - or plugin usage: await fetch
+ initialFetch()
+ }
+
+ function unregister (key: string) {
+ const data = nuxtApp._asyncData[key]
+ if (data?._deps) {
+ data._deps--
+ // clean up memory when it no longer is needed
+ if (data._deps === 0) {
+ data?._off()
+ }
+ }
+ }
+
+ // setup watchers/instance
+ const hasScope = getCurrentScope()
+ const noop = () => {}
+ // Key watcher: react immediately to key changes to remount/migrate the async data container deterministically.
+ // Skip watch when key is a plain string (not reactive).
+ const unsubKeyWatcher = isKeyReactive
+ ? watch(key as ComputedRef<string>, (newKey, oldKey) => {
+ if ((newKey || oldKey) && newKey !== oldKey) {
+ keyChanging = true
+
+ const hadData = nuxtApp._asyncData[oldKey]?.data.value !== undefined
+ const wasRunning = nuxtApp._asyncDataPromises[oldKey] !== undefined
+
+ const initialFetchOptions: AsyncDataExecuteOptions = { cause: 'initial', dedupe: opts.dedupe }
+
+ // Ensure destination container exists; read/migrate value BEFORE unregistering the old key.
+ if (!nuxtApp._asyncData[newKey]?._init) {
+ let initialValue: NoInfer<DataT> | undefined
+
+ if (oldKey && hadData) {
+ initialValue = nuxtApp._asyncData[oldKey]!.data.value as NoInfer<DataT>
+ } else {
+ initialValue = opts.getCachedData!(newKey, nuxtApp, { cause: 'initial' })
+ initialFetchOptions.cachedData = initialValue
+ }
+
+ nuxtApp._asyncData[newKey] = buildAsyncData(nuxtApp, newKey, _handler, opts, initialValue)
+ }
+
+ nuxtApp._asyncData[newKey]._deps++
+
+ // Now it's safe to drop the old container.
+ if (oldKey) {
+ unregister(oldKey)
+ }
+
+ // Trigger the fetch for the new key if needed.
+ const keyTriggersExecute = (opts as typeof opts & { _keyTriggersExecute?: boolean })._keyTriggersExecute !== false
+ if (keyTriggersExecute && (opts.immediate || hadData || wasRunning)) {
+ nuxtApp._asyncData[newKey].execute(initialFetchOptions)
+ }
+
+ // Release the guard after the current flush to avoid overlapping executes.
+ queuePostFlushCb(() => {
+ keyChanging = false
+ })
+ }
+ }, { flush: 'sync' })
+ : noop
+
+ // Params/deps watcher: keep default (pre) flush to batch multiple mutations into a single execute.
+ // This preserves the "non synchronous" behavior covered by tests.
+ const unsubParamsWatcher = opts.watch
+ ? watch(opts.watch, () => {
+ if (keyChanging) { return } // avoid double execute while the key switch is being processed
+ // if the 0ms debounce is pending (same tick) force flush the debounce post watcher flush
+ if (nuxtApp._asyncData[key.value]?._execute.isPending()) {
+ queuePostFlushCb(() => {
+ nuxtApp._asyncData[key.value]?._execute.flush()
+ })
+ }
+ nuxtApp._asyncData[key.value]?._execute({ cause: 'watch', dedupe: opts.dedupe })
+ })
+ : noop
+
+ if (hasScope) {
+ onScopeDispose(() => {
+ unsubKeyWatcher()
+ unsubParamsWatcher()
+ unregister(key.value)
+ })
+ }
+ }
+
+ const asyncReturn: _AsyncData<ResT, (NuxtErrorDataT extends Error | NuxtError ? NuxtErrorDataT : NuxtError<NuxtErrorDataT>)> = {
+ data: writableComputedRef(() => nuxtApp._asyncData[key.value]?.data as Ref<ResT>),
+ pending: writableComputedRef(() => nuxtApp._asyncData[key.value]?.pending as Ref<boolean>),
+ status: writableComputedRef(() => nuxtApp._asyncData[key.value]?.status as Ref<AsyncDataRequestStatus>),
+ error: writableComputedRef(() => nuxtApp._asyncData[key.value]?.error as Ref<NuxtErrorDataT extends Error | NuxtError ? NuxtErrorDataT : NuxtError<NuxtErrorDataT>>),
+ refresh: (...args) => {
+ if (!nuxtApp._asyncData[key.value]?._init) {
+ const initialFetch = createInitialFetch()
+ return initialFetch()
+ }
+ return nuxtApp._asyncData[key.value]!.execute(...args)
+ },
+ execute: (...args) => asyncReturn.refresh(...args),
+ clear: () => {
+ const entry = nuxtApp._asyncData[key.value]
+ if (entry?._abortController) {
+ try {
+ entry._abortController.abort(new DOMException('AsyncData aborted by user.', 'AbortError'))
+ } finally {
+ entry._abortController = undefined
+ }
+ }
+ clearNuxtDataByKey(nuxtApp, key.value)
+ },
+ }
+
+ // Allow directly awaiting on asyncData
+ const asyncDataPromise = Promise.resolve(nuxtApp._asyncDataPromises[key.value]).then(() => asyncReturn) as AsyncData<ResT, (NuxtErrorDataT extends Error | NuxtError ? NuxtErrorDataT : NuxtError<NuxtErrorDataT>)>
+ Object.assign(asyncDataPromise, asyncReturn)
+ // Allow destructuring without losing promise methods
+ Object.defineProperties(asyncDataPromise, {
+ then: { enumerable: true, value: asyncDataPromise.then.bind(asyncDataPromise) },
+ catch: { enumerable: true, value: asyncDataPromise.catch.bind(asyncDataPromise) },
+ finally: { enumerable: true, value: asyncDataPromise.finally.bind(asyncDataPromise) },
+ })
+ return asyncDataPromise as AsyncData<PickFrom<DataT, PickKeys>, (NuxtErrorDataT extends Error | NuxtError ? NuxtErrorDataT : NuxtError<NuxtErrorDataT>)>
+ }
+
+ return useAsyncData as unknown as UseAsyncData<FResT, FDataT, FPickKeys, FDefaultT>
+ },
+})
+
+export const useAsyncData: UseAsyncData = (createUseAsyncData as unknown as { __nuxt_factory: typeof createUseAsyncData }).__nuxt_factory()
+
+export const useLazyAsyncData: UseAsyncData = (createUseAsyncData as unknown as { __nuxt_factory: typeof createUseAsyncData }).__nuxt_factory({
+ lazy: true,
+ // @ts-expect-error private property
+ _functionName: 'useLazyAsyncData',
+})
+
+function writableComputedRef<T> (getter: () => Ref<T>): Ref<T> {
+ return computed({
+ get () {
+ return getter()?.value as T
+ },
+ set (value: T) {
+ const ref = getter()
+ if (ref) {
+ ref.value = value
+ }
+ },
+ }) as unknown as Ref<T>
+}
+
+function _isAutoKeyNeeded (keyOrFetcher: string | MaybeRefOrGetter<string> | (() => any), fetcher: () => any): boolean {
+ // string key
+ if (typeof keyOrFetcher === 'string') {
+ return false
+ }
+ // ref or computed key
+ if (typeof keyOrFetcher === 'object' && keyOrFetcher !== null) {
+ return false
+ }
+ // getter key only if it's followed by a getter function
+ if (typeof keyOrFetcher === 'function' && typeof fetcher === 'function') {
+ return false
+ }
+ return true
+}
+
+/** @since 3.1.0 */
+export function useNuxtData<DataT = any> (key: string): { data: Ref<DataT | undefined> } {
+ const nuxtApp = useNuxtApp()
+
+ // Initialize value when key is not already set
+ if (!(key in nuxtApp.payload.data)) {
+ nuxtApp.payload.data[key] = undefined
+ }
+
+ if (nuxtApp._asyncData[key]) {
+ const data = nuxtApp._asyncData[key]
+ data._deps++
+ if (getCurrentScope()) {
+ onScopeDispose(() => {
+ data._deps--
+ // clean up memory when it no longer is needed
+ if (data._deps === 0) {
+ data?._off()
+ }
+ })
+ }
+ }
+
+ return {
+ data: computed({
+ get () {
+ return nuxtApp._asyncData[key]?.data.value ?? nuxtApp.payload.data[key]
+ },
+ set (value) {
+ if (nuxtApp._asyncData[key]) {
+ nuxtApp._asyncData[key]!.data.value = value
+ } else {
+ nuxtApp.payload.data[key] = value
+ }
+ },
+ }),
+ }
+}
+
+/** @since 3.0.0 */
+export async function refreshNuxtData (keys?: string | string[]): Promise<void> {
+ if (import.meta.server) {
+ return Promise.resolve()
+ }
+
+ await new Promise<void>(resolve => onNuxtReady(resolve))
+
+ const _keys = keys ? toArray(keys) : undefined
+ await useNuxtApp().hooks.callHookParallel('app:data:refresh', _keys)
+}
+
+/** @since 3.0.0 */
+export function clearNuxtData (keys?: string | string[] | ((key: string) => boolean)): void {
+ const nuxtApp = useNuxtApp()
+ const _allKeys = Object.keys(nuxtApp.payload.data)
+ const _keys: string[] = !keys
+ ? _allKeys
+ : typeof keys === 'function'
+ ? _allKeys.filter(keys)
+ : toArray(keys)
+
+ for (const key of _keys) {
+ clearNuxtDataByKey(nuxtApp, key)
+ }
+}
+
+function clearNuxtDataByKey (nuxtApp: NuxtApp, key: string): void {
+ delete nuxtApp.payload.data[key]
+ delete nuxtApp.payload._errors[key]
+
+ if (nuxtApp._asyncData[key]) {
+ nuxtApp._asyncData[key]!.data.value = unref(nuxtApp._asyncData[key]!._default())
+ nuxtApp._asyncData[key]!.error.value = undefined
+ if (pendingWhenIdle) {
+ nuxtApp._asyncData[key]!.pending.value = false
+ }
+ nuxtApp._asyncData[key]!.status.value = 'idle'
+ nuxtApp._asyncData[key]!._initialCachedData = undefined
+ }
+
+ delete nuxtApp._asyncDataPromises[key]
+}
+
+function pick (obj: Record<string, any>, keys: string[]) {
+ const newObj = {}
+ for (const key of keys) {
+ (newObj as any)[key] = obj[key]
+ }
+ return newObj
+}
+
+// TODO: export from `perfect-debounce`
+export type DebouncedReturn<ArgumentsT extends unknown[], ReturnT> = ((...args: ArgumentsT) => Promise<ReturnT>) & {
+ cancel: () => void
+ flush: () => Promise<ReturnT> | undefined
+ isPending: () => boolean
+}
+
+export type CreatedAsyncData<ResT, NuxtErrorDataT = unknown, DataT = ResT, DefaultT = undefined> = Omit<_AsyncData<DataT | DefaultT, (NuxtErrorDataT extends Error | NuxtError ? NuxtErrorDataT : NuxtError<NuxtErrorDataT>)>, 'clear' | 'refresh'> & { _off: () => void, _hash?: Record<string, string | undefined>, _default: () => unknown, _init: boolean, _deps: number, _execute: DebouncedReturn<[opts?: AsyncDataExecuteOptions | undefined], void>, _abortController?: AbortController }
+
+function buildAsyncData<
+ ResT,
+ NuxtErrorDataT = unknown,
+ DataT = ResT,
+ PickKeys extends KeysOf<DataT> = KeysOf<DataT>,
+ DefaultT = undefined,
+> (nuxtApp: NuxtApp, key: string, _handler: AsyncDataHandler<ResT>, options: AsyncDataOptions<ResT, DataT, PickKeys, DefaultT>, initialCachedData?: NoInfer<DataT>): CreatedAsyncData<ResT, NuxtErrorDataT, DataT, DefaultT> {
+ nuxtApp.payload._errors[key] ??= undefined
+
+ const hasCustomGetCachedData = options.getCachedData !== getDefaultCachedData
+
+ // When prerendering, share payload data automatically between requests
+ const handler: AsyncDataHandler<ResT> = import.meta.client || !import.meta.prerender || !nuxtApp.ssrContext?.['~sharedPrerenderCache']
+ ? _handler
+ : (nuxtApp, options) => {
+ const value = nuxtApp.ssrContext!['~sharedPrerenderCache']!.get(key)
+ if (value) { return value as Promise<ResT> }
+
+ const promise = Promise.resolve().then(() => nuxtApp.runWithContext(() => _handler(nuxtApp, options)))
+
+ nuxtApp.ssrContext!['~sharedPrerenderCache']!.set(key, promise)
+ return promise
+ }
+
+ const _ref = options.deep ? ref : shallowRef
+ const hasCachedData = initialCachedData !== undefined
+ const unsubRefreshAsyncData = nuxtApp.hook('app:data:refresh', async (keys) => {
+ if (!keys || keys.includes(key)) {
+ await asyncData.execute({ cause: 'refresh:hook' })
+ }
+ })
+ const asyncData: CreatedAsyncData<ResT, NuxtErrorDataT, DataT, DefaultT> = {
+ data: _ref(hasCachedData ? initialCachedData : options.default!()) as any,
+ pending: pendingWhenIdle ? shallowRef(!hasCachedData) : computed(() => asyncData.status.value === 'pending'),
+ error: toRef(nuxtApp.payload._errors, key) as any,
+ status: shallowRef('idle'),
+ execute: (...args) => {
+ const [_opts, newValue = undefined] = args
+ const opts = _opts && newValue === undefined && typeof _opts === 'object' ? _opts : {}
+ if (import.meta.dev && newValue !== undefined && (!_opts || typeof _opts !== 'object')) {
+ // @ts-expect-error private property
+ console.warn(`[nuxt] [${options._functionName}] Do not pass \`execute\` directly to \`watch\`. Instead, use an inline function, such as \`watch(q, () => execute())\`.`)
+ }
+ if (nuxtApp._asyncDataPromises[key]) {
+ if ((opts.dedupe ?? options.dedupe) === 'defer') {
+ // Avoid fetching same key more than once at a time
+ return nuxtApp._asyncDataPromises[key]!
+ }
+ }
+ // Avoid fetching same key that is already fetched
+ if (granularCachedData || opts.cause === 'initial' || nuxtApp.isHydrating) {
+ const cachedData = 'cachedData' in opts ? opts.cachedData : options.getCachedData!(key, nuxtApp, { cause: opts.cause ?? 'refresh:manual' })
+ if (cachedData !== undefined) {
+ nuxtApp.payload.data[key] = asyncData.data.value = cachedData as DataT
+ asyncData.error.value = undefined
+ asyncData.status.value = 'success'
+ return Promise.resolve(cachedData)
+ }
+ }
+ if (pendingWhenIdle) {
+ asyncData.pending.value = true
+ }
+ if (asyncData._abortController) {
+ asyncData._abortController.abort(new DOMException('AsyncData request cancelled by deduplication', 'AbortError'))
+ }
+ asyncData._abortController = new AbortController()
+ asyncData.status.value = 'pending'
+ const cleanupController = new AbortController()
+ const promise: Promise<ResT | void> = new Promise<ResT>(
+ (resolve, reject) => {
+ try {
+ const timeout = opts.timeout ?? options.timeout
+ const mergedSignal = mergeAbortSignals([asyncData._abortController?.signal, opts?.signal], cleanupController.signal, timeout)
+ if (mergedSignal.aborted) {
+ const reason = mergedSignal.reason
+ reject(reason instanceof Error ? reason : new DOMException(String(reason ?? 'Aborted'), 'AbortError'))
+ return
+ }
+ mergedSignal.addEventListener('abort', () => {
+ const reason = mergedSignal.reason
+ reject(reason instanceof Error ? reason : new DOMException(String(reason ?? 'Aborted'), 'AbortError'))
+ }, { once: true, signal: cleanupController.signal })
+
+ return Promise.resolve(handler(nuxtApp, { signal: mergedSignal })).then(resolve, reject)
+ } catch (err) {
+ reject(err)
+ }
+ })
+ .then(async (_result) => {
+ // If the promise was replaced or cleared (e.g. by clearNuxtData), skip the update
+ if (nuxtApp._asyncDataPromises[key] !== promise) {
+ return
+ }
+
+ let result = _result as unknown as DataT
+ if (options.transform) {
+ result = await options.transform(_result)
+ }
+ if (options.pick) {
+ result = pick(result as any, options.pick) as DataT
+ }
+
+ if (import.meta.dev && import.meta.server && typeof result === 'undefined') {
+ const caller = getUserCaller()
+ const explanation = caller ? ` (used at ${caller.source}:${caller.line}:${caller.column})` : ''
+ // @ts-expect-error private property
+ console.warn(`[nuxt] \`${options._functionName || 'useAsyncData'}${explanation}\` must return a value (it should not be \`undefined\`) or the request may be duplicated on the client side.`)
+ }
+
+ nuxtApp.payload.data[key] = result
+
+ asyncData.data.value = result
+ asyncData.error.value = undefined
+ asyncData.status.value = 'success'
+ })
+ .catch((error: any) => {
+ // If the promise was replaced or cleared (e.g. by clearNuxtData), do not update the asyncData
+ if (nuxtApp._asyncDataPromises[key] !== promise) {
+ return nuxtApp._asyncDataPromises[key]
+ }
+
+ // If the asyncData was explicitly aborted internally (dedupe or clear), we do not update the asyncData
+ if (asyncData._abortController?.signal.aborted) {
+ return nuxtApp._asyncDataPromises[key]
+ }
+
+ // if the asyncData was explicitly aborted by user, we set it back to idle state
+ if (typeof DOMException !== 'undefined' && error instanceof DOMException && error.name === 'AbortError') {
+ asyncData.status.value = 'idle'
+ return nuxtApp._asyncDataPromises[key]
+ }
+
+ asyncData.error.value = createError<NuxtErrorDataT>(error) as (NuxtErrorDataT extends Error | NuxtError ? NuxtErrorDataT : NuxtError<NuxtErrorDataT>)
+ asyncData.data.value = unref(options.default!())
+ asyncData.status.value = 'error'
+ })
+ .finally(() => {
+ cleanupController.abort()
+
+ // Only clean up if this promise is still the current one
+ if (nuxtApp._asyncDataPromises[key] === promise) {
+ if (pendingWhenIdle) {
+ asyncData.pending.value = false
+ }
+ delete nuxtApp._asyncDataPromises[key]
+ }
+ })
+ nuxtApp._asyncDataPromises[key] = promise
+ return nuxtApp._asyncDataPromises[key]!
+ },
+ _execute: debounce((...args) => asyncData.execute(...args), 0, { leading: true }),
+ _default: options.default!,
+ _deps: 0,
+ _init: true,
+ _hash: import.meta.dev ? createHash(_handler, options) : undefined,
+ _off: () => {
+ unsubRefreshAsyncData()
+ if (nuxtApp._asyncData[key]?._init) {
+ nuxtApp._asyncData[key]._init = false
+ }
+ // TODO: disable in v4 in favour of custom caching strategies
+ if (purgeCachedData && !hasCustomGetCachedData) {
+ nextTick(() => {
+ if (!nuxtApp._asyncData[key]?._init) {
+ clearNuxtDataByKey(nuxtApp, key)
+ asyncData.execute = () => Promise.resolve()
+ }
+ })
+ }
+ },
+ }
+
+ return asyncData
+}
+
+// Used to get default values
+const getDefault = () => undefined
+const getDefaultCachedData: AsyncDataOptions<any>['getCachedData'] = (key, nuxtApp, ctx) => {
+ if (nuxtApp.isHydrating) {
+ return nuxtApp.payload.data[key]
+ }
+
+ if (ctx.cause !== 'refresh:manual' && ctx.cause !== 'refresh:hook') {
+ return nuxtApp.static.data[key]
+ }
+}
+
+function createHash (_handler: AsyncDataHandler<unknown>, options: Partial<Record<keyof AsyncDataOptions<any>, unknown>>) {
+ return {
+ handler: hash(_handler),
+ transform: options.transform ? hash(options.transform) : undefined,
+ pick: options.pick ? hash(options.pick) : undefined,
+ getCachedData: options.getCachedData ? hash(options.getCachedData) : undefined,
+ }
+}
+function mergeAbortSignals (signals: Array<AbortSignal | null | undefined>, cleanupSignal: AbortSignal, timeout?: number): AbortSignal {
+ const list = signals.filter(s => !!s)
+ if (typeof timeout === 'number' && timeout >= 0) {
+ const timeoutSignal = AbortSignal.timeout?.(timeout)
+ if (timeoutSignal) { list.push(timeoutSignal) }
+ }
+
+ // Use native if available
+ if (AbortSignal.any) {
+ return AbortSignal.any(list)
+ }
+
+ // Polyfill
+ const controller = new AbortController()
+
+ for (const sig of list) {
+ if (sig.aborted) {
+ const reason = sig.reason ?? new DOMException('Aborted', 'AbortError')
+ try {
+ controller.abort(reason)
+ } catch {
+ controller.abort()
+ }
+ return controller.signal
+ }
+ }
+
+ const onAbort = () => {
+ const abortedSignal = list.find(s => s.aborted)
+ const reason = abortedSignal?.reason ?? new DOMException('Aborted', 'AbortError')
+ try {
+ controller.abort(reason)
+ } catch {
+ controller.abort()
+ }
+ }
+
+ for (const sig of list) {
+ sig.addEventListener?.('abort', onAbort, { once: true, signal: cleanupSignal })
+ }
+
+ return controller.signal
+}
diff --git a/packages/nuxt/src/app/composables/chunk.ts b/packages/nuxt/src/app/composables/chunk.ts
new file mode 100644
index 000000000000..db3f3bf83a07
--- /dev/null
+++ b/packages/nuxt/src/app/composables/chunk.ts
@@ -0,0 +1,69 @@
+import { isScriptProtocol } from 'ufo'
+import { useNuxtApp } from '../nuxt'
+
+export interface ReloadNuxtAppOptions {
+ /**
+ * Number of milliseconds in which to ignore future reload requests
+ * @default {10000}
+ */
+ ttl?: number
+ /**
+ * Force a reload even if one has occurred within the previously specified TTL.
+ * @default {false}
+ */
+ force?: boolean
+ /**
+ * Whether to dump the current Nuxt state to sessionStorage (as `nuxt:reload:state`).
+ * @default {false}
+ */
+ persistState?: boolean
+ /**
+ * The path to reload. If this is different from the current window location it will
+ * trigger a navigation and add an entry in the browser history.
+ *
+ * URLs with script-like protocols (e.g. `javascript:`, `data:`) are rejected.
+ * @default {window.location.pathname}
+ */
+ path?: string
+}
+
+/** @since 3.3.0 */
+export function reloadNuxtApp (options: ReloadNuxtAppOptions = {}): void {
+ if (import.meta.server) { return }
+ const path = options.path || window.location.pathname
+
+ const { protocol } = new URL(path, window.location.href)
+ if (protocol && isScriptProtocol(protocol)) {
+ throw new Error(`Cannot navigate to a URL with '${protocol}' protocol.`)
+ }
+
+ let handledPath: Record<string, any> = {}
+ try {
+ handledPath = JSON.parse(sessionStorage.getItem('nuxt:reload') || '{}')
+ } catch {
+ // fail gracefully if we can't access sessionStorage
+ }
+
+ if (options.force || handledPath?.path !== path || handledPath?.expires < Date.now()) {
+ try {
+ sessionStorage.setItem('nuxt:reload', JSON.stringify({ path, expires: Date.now() + (options.ttl ?? 10000) }))
+ } catch {
+ // fail gracefully if we can't access sessionStorage
+ }
+
+ if (options.persistState) {
+ try {
+ // TODO: handle serializing/deserializing complex states as JSON: https://github.com/nuxt/nuxt/pull/19205
+ sessionStorage.setItem('nuxt:reload:state', JSON.stringify({ state: useNuxtApp().payload.state }))
+ } catch {
+ // fail gracefully if we can't access sessionStorage
+ }
+ }
+
+ if (window.location.pathname !== path) {
+ window.location.href = path
+ } else {
+ window.location.reload()
+ }
+ }
+}
diff --git a/packages/nuxt/src/app/composables/component.ts b/packages/nuxt/src/app/composables/component.ts
new file mode 100644
index 000000000000..1911c3e6bba8
--- /dev/null
+++ b/packages/nuxt/src/app/composables/component.ts
@@ -0,0 +1,100 @@
+import { computed, getCurrentInstance } from 'vue'
+import type { DefineComponent, defineComponent } from 'vue'
+import { hash } from 'ohash'
+import type { NuxtApp } from '../nuxt'
+import { getNuxtAppCtx, useNuxtApp } from '../nuxt'
+import { useHead } from './head'
+import { useAsyncData } from './asyncData'
+import { useRoute } from './router'
+import { createError } from './error'
+
+export const NuxtComponentIndicator = '__nuxt_component'
+
+/* @__NO_SIDE_EFFECTS__ */
+function getFetchKey () {
+ const vm = getCurrentInstance()!
+ const route = useRoute()
+ const { _fetchKeyBase } = vm.proxy!.$options
+ return hash([
+ _fetchKeyBase,
+ route.path,
+ route.query,
+ route.matched.findIndex(r => Object.values(r.components || {}).includes(vm.type)),
+ ])
+}
+
+async function runLegacyAsyncData (res: Record<string, any> | Promise<Record<string, any>>, fn: (nuxtApp: NuxtApp) => Promise<Record<string, any>>) {
+ const nuxtApp = useNuxtApp()
+ const { fetchKey } = getCurrentInstance()!.proxy!.$options
+ const key = (typeof fetchKey === 'function' ? fetchKey(() => '') : fetchKey) || getFetchKey()
+ const { data, error } = await useAsyncData(`options:asyncdata:${key}`, () => import.meta.server ? nuxtApp.runWithContext(() => fn(nuxtApp)) : fn(nuxtApp))
+ if (error.value) {
+ throw createError(error.value)
+ }
+ if (data.value && typeof data.value === 'object') {
+ const _res = await res
+ for (const key in data.value) {
+ _res[key] = computed({
+ get: () => data.value?.[key],
+ set (v) {
+ data.value = data.value ? { ...data.value, [key]: v } : { [key]: v }
+ },
+ })
+ }
+ } else if (import.meta.dev) {
+ console.warn('[nuxt] asyncData should return an object', data)
+ }
+}
+
+/** @since 3.0.0 */
+/* @__NO_SIDE_EFFECTS__ */
+export const defineNuxtComponent: typeof defineComponent =
+ function defineNuxtComponent (...args: any[]): any {
+ const [options, key] = args
+ const { setup } = options as DefineComponent
+
+ // Avoid wrapping if no options api is used
+ if (!setup && !options.asyncData && !options.head) {
+ return {
+ [NuxtComponentIndicator]: true,
+ ...options,
+ }
+ }
+
+ return {
+ [NuxtComponentIndicator]: true,
+ _fetchKeyBase: key,
+ ...options,
+ setup (props, ctx) {
+ const nuxtApp = useNuxtApp()
+
+ let res = {}
+ if (setup) {
+ const fn = (): Promise<Record<string, any>> => Promise.resolve(setup(props, ctx)).then((r: any) => r || {})
+ const nuxtAppCtx = getNuxtAppCtx(nuxtApp._id)
+ if (import.meta.server) {
+ res = nuxtAppCtx.callAsync(nuxtApp, fn)
+ } else {
+ nuxtAppCtx.set(nuxtApp)
+ res = fn()
+ }
+ }
+
+ const promises: Promise<any>[] = []
+ if (options.asyncData) {
+ promises.push(runLegacyAsyncData(res, options.asyncData))
+ }
+
+ if (options.head) {
+ useHead(typeof options.head === 'function' ? () => options.head(nuxtApp) : options.head)
+ }
+
+ return Promise.resolve(res)
+ .then(() => Promise.all(promises))
+ .then(() => res)
+ .finally(() => {
+ promises.length = 0
+ })
+ },
+ } as DefineComponent
+ }
diff --git a/packages/nuxt/src/app/composables/cookie.ts b/packages/nuxt/src/app/composables/cookie.ts
new file mode 100644
index 000000000000..90227581cdde
--- /dev/null
+++ b/packages/nuxt/src/app/composables/cookie.ts
@@ -0,0 +1,367 @@
+import type { Ref } from 'vue'
+import { customRef, getCurrentScope, nextTick, onScopeDispose, ref, watch } from 'vue'
+import type { CookieParseOptions, CookieSerializeOptions } from 'cookie-es'
+import { parse, serialize } from 'cookie-es'
+import { deleteCookie, getCookie, setCookie } from '@nuxt/nitro-server/h3'
+import type { H3Event } from '@nuxt/nitro-server/h3'
+import { isEqual } from 'ohash'
+import { klona } from 'klona'
+import { useNuxtApp } from '../nuxt'
+import { useRequestEvent } from './ssr'
+
+// @ts-expect-error virtual import
+import { cookieStore } from '#build/nuxt.config.mjs'
+
+function parseCookieValue (value: string) {
+ if (value === 'undefined') { return undefined }
+ try {
+ const parsed = JSON.parse(value)
+ // avoid coercing number-like strings that lose precision or overflow (e.g. '4e71375682906041' -> Infinity)
+ if (typeof parsed === 'number' && String(parsed) !== value) { return value }
+ return parsed
+ } catch { return value }
+}
+
+type _CookieOptions = Omit<CookieSerializeOptions & CookieParseOptions, 'decode' | 'encode'>
+
+export interface CookieOptions<T = any> extends _CookieOptions {
+ decode?(value: string | null | undefined): T
+ encode?(value: T): string
+ default?: () => T | Ref<T>
+ watch?: boolean | 'shallow'
+ readonly?: boolean
+
+ /**
+ * Refresh cookie expiration even when the value remains unchanged.
+ *
+ * By default, a cookie is only rewritten when its value changes.
+ * When `refresh` is set to `true`, the cookie will be re-written
+ * on every explicit assignment (e.g. `cookie.value = cookie.value`),
+ * extending its expiration even if the value is the same.
+ *
+ * Note: the expiration is not refreshed automatically — you must
+ * assign to `cookie.value` to trigger the refresh.
+ *
+ * @default false
+ */
+ refresh?: boolean
+}
+
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type
+export interface CookieRef<T> extends Ref<T> {}
+
+const CookieDefaults = {
+ path: '/',
+ watch: true,
+ decode: val => val ? parseCookieValue(decodeURIComponent(val)) : val,
+ encode: (val) => {
+ // JSON-quote strings that would be coerced on decode (e.g. '42', 'true', 'null', 'undefined')
+ if (typeof val !== 'string' || val === 'undefined') {
+ return encodeURIComponent(JSON.stringify(val))
+ }
+
+ try {
+ if (typeof JSON.parse(val) !== 'string') {
+ return encodeURIComponent(JSON.stringify(val))
+ }
+ } catch {
+ // ignore - value is not JSON, so encode as-is
+ }
+ return encodeURIComponent(val)
+ },
+ refresh: false,
+} satisfies CookieOptions<any>
+
+// we use globalThis to avoid crashes in web workers
+const store = import.meta.client && cookieStore ? globalThis.cookieStore : undefined
+
+/** @since 3.0.0 */
+export function useCookie<T = string | null | undefined> (name: string, _opts?: CookieOptions<T> & { readonly?: false }): CookieRef<T>
+export function useCookie<T = string | null | undefined> (name: string, _opts: CookieOptions<T> & { readonly: true }): Readonly<CookieRef<T>>
+export function useCookie<T = string | null | undefined> (name: string, _opts?: CookieOptions<T>): CookieRef<T> {
+ const opts = { ...CookieDefaults, ..._opts }
+ opts.filter ??= key => key === name
+ const cookies = readRawCookies(opts) || {}
+
+ let delay: number | undefined
+
+ if (opts.maxAge !== undefined) {
+ delay = opts.maxAge * 1000 // convert to ms for setTimeout
+ } else if (opts.expires) {
+ // getTime() already returns time in ms
+ delay = opts.expires.getTime() - Date.now()
+ }
+
+ const hasExpired = delay !== undefined && delay <= 0
+ const shouldSetInitialClientCookie = import.meta.client && (hasExpired || cookies[name] === undefined || cookies[name] === null)
+ const cookieValue = klona(hasExpired ? undefined : (cookies[name] as any) ?? opts.default?.())
+
+ // use a custom ref to expire the cookie on client side otherwise use a plain ref (or cookieServerRef on the server to track writes for the `refresh` option)
+ const cookie = import.meta.client && delay && !hasExpired
+ ? cookieRef<T | undefined>(cookieValue, delay, opts.watch && opts.watch !== 'shallow')
+ : import.meta.server
+ ? cookieServerRef<T | undefined>(name, cookieValue)
+ : ref<T | undefined>(cookieValue)
+
+ if (import.meta.dev && hasExpired) {
+ console.warn(`[nuxt] not setting cookie \`${name}\` as it has already expired.`)
+ }
+
+ if (import.meta.client) {
+ let channel: null | BroadcastChannel = null
+ try {
+ if (!store && typeof BroadcastChannel !== 'undefined') {
+ channel = new BroadcastChannel(`nuxt:cookies:${name}`)
+ }
+ } catch {
+ // BroadcastChannel will fail in certain situations when cookies are disabled
+ // or running in an iframe: see https://github.com/nuxt/nuxt/issues/26338
+ }
+ const callback = (force = false) => {
+ if (!force) {
+ if (opts.readonly || isEqual(cookie.value, cookies[name])) { return }
+ }
+ const encoded = cookie.value === null || cookie.value === undefined
+ ? undefined
+ : opts.encode(cookie.value as T)
+ writeClientCookie(name, encoded, opts)
+
+ cookies[name] = klona(cookie.value)
+ channel?.postMessage({ value: opts.encode(cookie.value as T) })
+ }
+
+ const handleChange = (data: { value?: string | null, refresh?: boolean }) => {
+ const value = data.refresh ? readRawCookies(opts)?.[name] : opts.decode(data.value)
+ watchPaused = true
+ cookie.value = value
+ cookies[name] = klona(value)
+ nextTick(() => { watchPaused = false })
+ }
+
+ let watchPaused = false
+
+ const hasScope = !!getCurrentScope()
+
+ if (hasScope) {
+ onScopeDispose(() => {
+ watchPaused = true
+ callback()
+ channel?.close()
+ })
+ }
+
+ if (store) {
+ /* event is of type CookieChangeEvent */
+ const changeHandler = (event: CookieChangeEvent) => {
+ const changedCookie = event.changed.find(c => c.name === name)
+ const removedCookie = event.deleted.find(c => c.name === name)
+
+ if (changedCookie) {
+ handleChange({ value: changedCookie.value })
+ }
+
+ if (removedCookie) {
+ handleChange({ value: null })
+ }
+ }
+ store.addEventListener('change', changeHandler)
+ if (hasScope) {
+ onScopeDispose(() => store.removeEventListener('change', changeHandler))
+ }
+ } else if (channel) {
+ channel.onmessage = ({ data }) => handleChange(data)
+ }
+
+ if (opts.watch) {
+ watch(cookie, () => {
+ if (watchPaused) { return }
+ callback(opts.refresh)
+ },
+ { deep: opts.watch !== 'shallow' })
+ }
+
+ if (shouldSetInitialClientCookie) {
+ callback(shouldSetInitialClientCookie)
+ }
+ } else if (import.meta.server) {
+ const nuxtApp = useNuxtApp()
+ const writeFinalCookieValue = () => {
+ const valueIsSame = isEqual(cookie.value, cookies[name])
+
+ if (
+ opts.readonly
+ || (valueIsSame && !opts.refresh)
+ ) { return }
+
+ nuxtApp._cookiesChanged ||= {}
+ if (valueIsSame && opts.refresh && !nuxtApp._cookiesChanged[name]) {
+ return
+ }
+
+ nuxtApp._cookies ||= {}
+ if (name in nuxtApp._cookies) {
+ // do not append a second `set-cookie` header
+ if (isEqual(cookie.value, nuxtApp._cookies[name])) { return }
+ // warn in dev mode
+ if (import.meta.dev) {
+ console.warn(`[nuxt] cookie \`${name}\` was previously set to \`${opts.encode(nuxtApp._cookies[name] as any)}\` and is being overridden to \`${opts.encode(cookie.value as any)}\`. This may cause unexpected issues.`)
+ }
+ }
+ nuxtApp._cookies[name] = cookie.value
+ const encoded = cookie.value === null || cookie.value === undefined
+ ? undefined
+ : opts.encode(cookie.value as T)
+ writeServerCookie(useRequestEvent(nuxtApp)!, name, encoded, opts)
+ }
+ const unhook = nuxtApp.hooks.hookOnce('app:rendered', writeFinalCookieValue)
+ nuxtApp.hooks.hookOnce('app:error', () => {
+ unhook() // don't write cookie subsequently when app:rendered is called
+ return writeFinalCookieValue()
+ })
+ }
+
+ return cookie as CookieRef<T>
+}
+/** @since 3.10.0 */
+export function refreshCookie (name: string): void {
+ if (import.meta.server || store || typeof BroadcastChannel === 'undefined') { return }
+
+ try {
+ const channel = new BroadcastChannel(`nuxt:cookies:${name}`)
+ channel.postMessage({ refresh: true })
+ channel.close()
+ } catch {
+ // BroadcastChannel will fail in certain situations when cookies are disabled
+ // or running in an iframe: see https://github.com/nuxt/nuxt/issues/26338
+ }
+}
+
+function readRawCookies (opts: CookieOptions = {}): Record<string, unknown> | undefined {
+ if (import.meta.server) {
+ return parse(useRequestEvent()!.req.headers.get('cookie') || '', opts)
+ } else if (import.meta.client) {
+ return parse(document.cookie, opts)
+ }
+}
+
+// value is expected to be already encoded via `opts.encode`; pass through as-is
+const identityEncode = (val: string) => val
+
+function toSerializeOptions (opts: CookieOptions): CookieSerializeOptions {
+ const { encode: _encode, decode: _decode, ...rest } = opts
+ return { ...rest, encode: identityEncode }
+}
+
+function serializeCookie (name: string, value: string | undefined, opts: CookieOptions = {}) {
+ const serializeOpts = toSerializeOptions(opts)
+ if (value === undefined) {
+ return serialize(name, '', { ...serializeOpts, maxAge: -1 })
+ }
+ return serialize(name, value, serializeOpts)
+}
+
+function writeClientCookie (name: string, value: string | undefined, opts: CookieOptions = {}) {
+ if (import.meta.client) {
+ document.cookie = serializeCookie(name, value, opts)
+ }
+}
+
+function writeServerCookie (event: H3Event, name: string, value: string | undefined, opts: CookieOptions = {}) {
+ if (event) {
+ const serializeOpts = toSerializeOptions(opts)
+ // update if value is set
+ if (value !== undefined) {
+ return setCookie(event, name, value, serializeOpts)
+ }
+
+ // delete if cookie exists in browser and value is null/undefined
+ if (getCookie(event, name) !== undefined) {
+ return deleteCookie(event, name, serializeOpts)
+ }
+
+ // else ignore if cookie doesn't exist in browser and value is null/undefined
+ }
+}
+
+/**
+ * The maximum value allowed on a timeout delay.
+ *
+ * Reference: https://developer.mozilla.org/en-US/docs/Web/API/Window/setTimeout#maximum_delay_value
+ */
+const MAX_TIMEOUT_DELAY = 2_147_483_647
+
+// custom ref that will update the value to undefined if the cookie expires
+function cookieRef<T> (value: T | undefined, delay: number, shouldWatch: boolean) {
+ let timeout: NodeJS.Timeout
+ let unsubscribe: (() => void) | undefined
+ let elapsed = 0
+ const internalRef = shouldWatch ? ref(value) : { value }
+ if (getCurrentScope()) {
+ onScopeDispose(() => {
+ unsubscribe?.()
+ clearTimeout(timeout)
+ })
+ }
+
+ return customRef((track, trigger) => {
+ if (shouldWatch) { unsubscribe = watch(internalRef, trigger) }
+
+ function scheduleTimeout () {
+ const timeRemaining = delay - elapsed
+ const timeoutLength = timeRemaining < MAX_TIMEOUT_DELAY ? timeRemaining : MAX_TIMEOUT_DELAY
+ timeout = setTimeout(() => {
+ elapsed += timeoutLength
+ if (elapsed < delay) { return scheduleTimeout() }
+
+ internalRef.value = undefined
+ trigger()
+ }, timeoutLength)
+ }
+
+ function createExpirationTimeout () {
+ elapsed = 0
+ clearTimeout(timeout)
+ scheduleTimeout()
+ }
+
+ return {
+ get () {
+ track()
+ return internalRef.value
+ },
+ set (newValue) {
+ createExpirationTimeout()
+
+ internalRef.value = newValue
+ trigger()
+ },
+ }
+ })
+}
+
+/**
+ * Custom ref that tracks explicit cookie writes on the server.
+ *
+ * This is required for the `refresh` option to ensure the cookie is
+ * re-written on SSR even when the value remains unchanged.
+ */
+function cookieServerRef<T> (name: string, value: T | undefined) {
+ const internalRef = ref(value)
+ const nuxtApp = useNuxtApp()
+
+ return customRef((track, trigger) => {
+ return {
+ get () {
+ track()
+ return internalRef.value
+ },
+ set (newValue) {
+ nuxtApp._cookiesChanged ||= {}
+ nuxtApp._cookiesChanged[name] = true
+
+ internalRef.value = newValue
+ trigger()
+ },
+ }
+ })
+}
diff --git a/packages/nuxt/src/app/composables/error.ts b/packages/nuxt/src/app/composables/error.ts
new file mode 100644
index 000000000000..ffc58a879d49
--- /dev/null
+++ b/packages/nuxt/src/app/composables/error.ts
@@ -0,0 +1,73 @@
+import { HTTPError } from '@nuxt/nitro-server/h3'
+import { toRef } from 'vue'
+import type { Ref } from 'vue'
+import { useNuxtApp } from '../nuxt'
+import type { NuxtPayload } from '../nuxt'
+import { useRouter } from './router'
+
+export const NUXT_ERROR_SIGNATURE = '__nuxt_error' as const
+
+/** @since 3.0.0 */
+/* @__NO_SIDE_EFFECTS__ */
+export const useError = (): Ref<NuxtPayload['error']> => toRef(useNuxtApp().payload, 'error')
+
+/** @since 3.0.0 */
+export const showError = <DataT = unknown>(
+ error: string | Error | (Partial<NuxtError<DataT>> & {
+ status?: number
+ statusText?: string
+ }),
+): NuxtError<DataT> => {
+ const nuxtError = createError<DataT>(error)
+
+ try {
+ const error = useError()
+
+ if (import.meta.client) {
+ const nuxtApp = useNuxtApp()
+ nuxtApp.hooks.callHook('app:error', nuxtError)
+ }
+
+ error.value ||= nuxtError
+ } catch {
+ throw nuxtError
+ }
+
+ return nuxtError
+}
+
+/** @since 3.0.0 */
+export const clearError = async (options: { redirect?: string } = {}): Promise<void> => {
+ const nuxtApp = useNuxtApp()
+ const error = useError()
+
+ nuxtApp.callHook('app:error:cleared', options)
+
+ if (options.redirect) {
+ await useRouter().replace(options.redirect)
+ }
+
+ error.value = undefined
+}
+
+/** @since 3.0.0 */
+export const isNuxtError = <DataT = unknown>(error: unknown): error is NuxtError<DataT> => {
+ return !!error && typeof error === 'object' && NUXT_ERROR_SIGNATURE in error
+}
+
+export class NuxtError<DataT = unknown> extends HTTPError<DataT> {
+ readonly __nuxt_error = true as const
+ readonly fatal: boolean
+
+ constructor (message = '', opts: Partial<NuxtError<DataT>> = {}) {
+ super(message, opts)
+ this.fatal = opts.fatal ?? !!opts.unhandled
+ }
+}
+
+/** @since 3.0.0 */
+export const createError = <DataT = unknown>(error: string | Error | Partial<NuxtError<DataT>>): NuxtError<DataT> => {
+ return typeof error === 'string'
+ ? new NuxtError<DataT>(error)
+ : new NuxtError<DataT>(error.message, error)
+}
diff --git a/packages/nuxt/src/app/composables/fetch.ts b/packages/nuxt/src/app/composables/fetch.ts
new file mode 100644
index 000000000000..98af49102e93
--- /dev/null
+++ b/packages/nuxt/src/app/composables/fetch.ts
@@ -0,0 +1,377 @@
+import type { FetchError, FetchOptions, ResponseType as _ResponseType } from 'ofetch'
+import type { $Fetch, NitroFetchRequest, TypedInternalResponse, AvailableRouterMethod as _AvailableRouterMethod } from 'nitro/types'
+import type { MaybeRef, MaybeRefOrGetter, Ref } from 'vue'
+import { computed, reactive, toValue, watch } from 'vue'
+import { hash } from 'ohash'
+
+import { isPlainObject } from '@vue/shared'
+import type { AsyncData, AsyncDataOptions, KeysOf, MultiWatchSources, PickFrom, _Transform } from './asyncData'
+import { useAsyncData } from './asyncData'
+import { defineKeyedFunctionFactory } from '../../compiler/runtime'
+
+// @ts-expect-error virtual file
+import { alwaysRunFetchOnKeyChange, fetchDefaults } from '#build/nuxt.config.mjs'
+
+// support uppercase methods, detail: https://github.com/nuxt/nuxt/issues/22313
+type AvailableRouterMethod<R extends NitroFetchRequest> = _AvailableRouterMethod<R> | Uppercase<_AvailableRouterMethod<R>>
+
+export type FetchResult<ReqT extends NitroFetchRequest, M extends AvailableRouterMethod<ReqT>> = TypedInternalResponse<ReqT, unknown, Lowercase<M>>
+
+type ComputedOptions<T extends Record<string, any>> = {
+ // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+ [K in keyof T]: T[K] extends Function ? T[K] : ComputedOptions<T[K]> | Ref<T[K]> | T[K]
+}
+
+interface NitroFetchOptions<R extends NitroFetchRequest, M extends AvailableRouterMethod<R> = AvailableRouterMethod<R>, DataT = any> extends Omit<FetchOptions<_ResponseType, DataT>, 'cache'> {
+ method?: M
+ cache?: FetchOptions<_ResponseType, DataT>['cache'] | false
+}
+
+type ComputedFetchOptions<R extends NitroFetchRequest, M extends AvailableRouterMethod<R>, DataT = any> = ComputedOptions<NitroFetchOptions<R, M, DataT>>
+
+export interface UseFetchOptions<
+ ResT,
+ DataT = ResT,
+ PickKeys extends KeysOf<DataT> = KeysOf<DataT>,
+ DefaultT = undefined,
+ R extends NitroFetchRequest = string & {},
+ M extends AvailableRouterMethod<R> = AvailableRouterMethod<R>,
+> extends Omit<AsyncDataOptions<ResT, DataT, PickKeys, DefaultT>, 'watch'>, Omit<ComputedFetchOptions<R, M, DataT>, 'timeout'> {
+ key?: MaybeRefOrGetter<string>
+ $fetch?: $Fetch
+ watch?: MultiWatchSources | false
+}
+
+export interface UseFetchOptionsWithTransform<
+ ResT,
+ DataT = ResT,
+ PickKeys extends KeysOf<DataT> = KeysOf<DataT>,
+ DefaultT = undefined,
+ R extends NitroFetchRequest = string & {},
+ M extends AvailableRouterMethod<R> = AvailableRouterMethod<R>,
+> extends Omit<UseFetchOptions<ResT, DataT, PickKeys, DefaultT, R, M>, 'transform'> {
+ transform: _Transform<ResT, DataT>
+}
+
+function generateOptionSegments<_ResT, DataT, DefaultT> (opts: UseFetchOptions<_ResT, DataT, any, DefaultT, any, any>) {
+ const segments: Array<string | undefined | Record<string, string>> = [
+ toValue(opts.method as MaybeRef<string | undefined> | undefined)?.toUpperCase() || 'GET',
+ toValue(opts.baseURL),
+ ]
+ // eslint-disable-next-line @typescript-eslint/no-deprecated
+ for (const _obj of [opts.query || opts.params]) {
+ const obj = toValue(_obj)
+ if (!obj) { continue }
+
+ const unwrapped: Record<string, string> = {}
+ for (const [key, value] of Object.entries(obj)) {
+ unwrapped[toValue(key)] = toValue(value)
+ }
+ segments.push(unwrapped)
+ }
+ if (opts.body) {
+ const value = toValue(opts.body)
+ if (!value) {
+ segments.push(hash(value))
+ } else if (value instanceof ArrayBuffer) {
+ segments.push(hash(Object.fromEntries([...new Uint8Array(value).entries()].map(([k, v]) => [k, v.toString()]))))
+ } else if (value instanceof FormData) {
+ const entries: Array<[string, string]> = []
+ for (const entry of value.entries()) {
+ const [key, val] = entry
+ entries.push([key, val instanceof File ? `${val.name}:${val.size}:${val.lastModified}` : val])
+ }
+ segments.push(hash(entries))
+ } else if (isPlainObject(value)) {
+ segments.push(hash(reactive(value)))
+ } else {
+ try {
+ segments.push(hash(value))
+ } catch {
+ console.warn('[useFetch] Failed to hash body', value)
+ }
+ }
+ }
+ return segments
+}
+
+// Type of the public-facing `useFetch` returned by the factory below.
+// Expressed as a callable interface so that all overloads survive
+// oxc's isolated-declarations dts pipeline.
+type FetchFactoryDataT<FDataT, _ResT> = [unknown] extends [FDataT] ? _ResT : FDataT
+type FetchFactoryDefaultT<FDefaultT, Fallback> = [undefined] extends [FDefaultT] ? Fallback : FDefaultT
+type FetchFactoryPickKeys<FPickKeys, PickKeys, DataT> = [Array<never>] extends [FPickKeys] ? PickKeys : FPickKeys & KeysOf<DataT>
+export interface UseFetch<FDataT = unknown, FPickKeys extends KeysOf<FDataT> = never[], FDefaultT = undefined> {
+ // Auto-key, opts with transform, default = undefined
+ <
+ ResT = void,
+ ErrorT = FetchError,
+ ReqT extends NitroFetchRequest = NitroFetchRequest,
+ Method extends AvailableRouterMethod<ReqT> = ResT extends void ? 'get' extends AvailableRouterMethod<ReqT> ? 'get' : AvailableRouterMethod<ReqT> : AvailableRouterMethod<ReqT>,
+ _ResT = ResT extends void ? FetchResult<ReqT, Method> : ResT,
+ DataT = _ResT,
+ PickKeys extends KeysOf<DataT> = KeysOf<DataT>,
+ DefaultT = FetchFactoryDefaultT<FDefaultT, undefined>,
+ >(
+ request: Ref<ReqT> | ReqT | (() => ReqT),
+ opts: UseFetchOptionsWithTransform<_ResT, DataT, PickKeys, DefaultT, ReqT, Method>,
+ ): AsyncData<PickFrom<DataT, PickKeys> | DefaultT, ErrorT | undefined>
+ // Auto-key, opts with transform, default = DataT
+ <
+ ResT = void,
+ ErrorT = FetchError,
+ ReqT extends NitroFetchRequest = NitroFetchRequest,
+ Method extends AvailableRouterMethod<ReqT> = ResT extends void ? 'get' extends AvailableRouterMethod<ReqT> ? 'get' : AvailableRouterMethod<ReqT> : AvailableRouterMethod<ReqT>,
+ _ResT = ResT extends void ? FetchResult<ReqT, Method> : ResT,
+ DataT = _ResT,
+ PickKeys extends KeysOf<DataT> = KeysOf<DataT>,
+ DefaultT = FetchFactoryDefaultT<FDefaultT, DataT>,
+ >(
+ request: Ref<ReqT> | ReqT | (() => ReqT),
+ opts: UseFetchOptionsWithTransform<_ResT, DataT, PickKeys, DefaultT, ReqT, Method>,
+ ): AsyncData<PickFrom<DataT, PickKeys> | DefaultT, ErrorT | undefined>
+ // Auto-key, default = undefined
+ <
+ ResT = void,
+ ErrorT = FetchError,
+ ReqT extends NitroFetchRequest = NitroFetchRequest,
+ Method extends AvailableRouterMethod<ReqT> = ResT extends void ? 'get' extends AvailableRouterMethod<ReqT> ? 'get' : AvailableRouterMethod<ReqT> : AvailableRouterMethod<ReqT>,
+ _ResT = ResT extends void ? FetchResult<ReqT, Method> : ResT,
+ DataT = FetchFactoryDataT<FDataT, _ResT>,
+ PickKeys extends KeysOf<DataT> = KeysOf<DataT>,
+ DefaultT = FetchFactoryDefaultT<FDefaultT, undefined>,
+ >(
+ request: Ref<ReqT> | ReqT | (() => ReqT),
+ opts?: UseFetchOptions<_ResT, DataT, PickKeys, DefaultT, ReqT, Method>,
+ ): AsyncData<PickFrom<DataT, FetchFactoryPickKeys<FPickKeys, PickKeys, DataT>> | DefaultT, ErrorT | undefined>
+ // Auto-key, default = DataT
+ <
+ ResT = void,
+ ErrorT = FetchError,
+ ReqT extends NitroFetchRequest = NitroFetchRequest,
+ Method extends AvailableRouterMethod<ReqT> = ResT extends void ? 'get' extends AvailableRouterMethod<ReqT> ? 'get' : AvailableRouterMethod<ReqT> : AvailableRouterMethod<ReqT>,
+ _ResT = ResT extends void ? FetchResult<ReqT, Method> : ResT,
+ DataT = FetchFactoryDataT<FDataT, _ResT>,
+ PickKeys extends KeysOf<DataT> = KeysOf<DataT>,
+ DefaultT = FetchFactoryDefaultT<FDefaultT, DataT>,
+ >(
+ request: Ref<ReqT> | ReqT | (() => ReqT),
+ opts?: UseFetchOptions<_ResT, DataT, PickKeys, DefaultT, ReqT, Method>,
+ ): AsyncData<PickFrom<DataT, FetchFactoryPickKeys<FPickKeys, PickKeys, DataT>> | DefaultT, ErrorT | undefined>
+ // Explicit auto-key as positional arg
+ <
+ ResT = void,
+ ErrorT = FetchError,
+ ReqT extends NitroFetchRequest = NitroFetchRequest,
+ Method extends AvailableRouterMethod<ReqT> = ResT extends void ? 'get' extends AvailableRouterMethod<ReqT> ? 'get' : AvailableRouterMethod<ReqT> : AvailableRouterMethod<ReqT>,
+ _ResT = ResT extends void ? FetchResult<ReqT, Method> : ResT,
+ DataT = _ResT,
+ PickKeys extends KeysOf<DataT> = KeysOf<DataT>,
+ DefaultT = undefined,
+ >(
+ request: Ref<ReqT> | ReqT | (() => ReqT),
+ arg1?: string | UseFetchOptions<_ResT, DataT, PickKeys, DefaultT, ReqT, Method>,
+ arg2?: string,
+ ): AsyncData<PickFrom<DataT, PickKeys> | DefaultT, ErrorT | undefined>
+}
+
+export interface CreateUseFetch {
+ <
+ FResT = void,
+ FReqT extends NitroFetchRequest = NitroFetchRequest,
+ FMethod extends AvailableRouterMethod<FReqT> = FResT extends void ? 'get' extends AvailableRouterMethod<FReqT> ? 'get' : AvailableRouterMethod<FReqT> : AvailableRouterMethod<FReqT>,
+ F_ResT = FResT extends void ? FetchResult<FReqT, FMethod> : FResT,
+ FDataT = F_ResT,
+ FPickKeys extends KeysOf<FDataT> = KeysOf<FDataT>,
+ FDefaultT = undefined,
+ >(
+ options?:
+ | Partial<UseFetchOptions<F_ResT, FDataT, FPickKeys, FDefaultT, FReqT, FMethod>>
+ | ((callerOptions: UseFetchOptions<unknown>) => Partial<UseFetchOptions<F_ResT, FDataT, FPickKeys, FDefaultT, FReqT, FMethod>>),
+ ): UseFetch<FDataT, FPickKeys, FDefaultT>
+}
+
+/**
+ * A factory function to create a custom `useFetch` composable with pre-defined default options.
+ * @since 4.2.0
+ */
+export const createUseFetch: CreateUseFetch = defineKeyedFunctionFactory<CreateUseFetch>({
+ name: 'createUseFetch',
+ factory<
+ FResT = void,
+ FReqT extends NitroFetchRequest = NitroFetchRequest,
+ FMethod extends AvailableRouterMethod<FReqT> = FResT extends void ? 'get' extends AvailableRouterMethod<FReqT> ? 'get' : AvailableRouterMethod<FReqT> : AvailableRouterMethod<FReqT>,
+ F_ResT = FResT extends void ? FetchResult<FReqT, FMethod> : FResT,
+ FDataT = F_ResT,
+ FPickKeys extends KeysOf<FDataT> = KeysOf<FDataT>,
+ FDefaultT = undefined,
+ >(options:
+ Partial<UseFetchOptions<F_ResT, FDataT, FPickKeys, FDefaultT, FReqT, FMethod>>
+ | ((callerOptions: UseFetchOptions<unknown>) => Partial<UseFetchOptions<F_ResT, FDataT, FPickKeys, FDefaultT, FReqT, FMethod>>) = {},
+ ): UseFetch<FDataT, FPickKeys, FDefaultT> {
+ /**
+ * Fetch data from an API endpoint with an SSR-friendly composable.
+ * See {@link https://nuxt.com/docs/4.x/api/composables/use-fetch}
+ * @since 3.0.0
+ * @param request The URL to fetch
+ * @param opts extends $fetch options and useAsyncData options
+ */
+ function useFetch<
+ ResT = void,
+ ErrorT = FetchError,
+ ReqT extends NitroFetchRequest = NitroFetchRequest,
+ Method extends AvailableRouterMethod<ReqT> = ResT extends void ? 'get' extends AvailableRouterMethod<ReqT> ? 'get' : AvailableRouterMethod<ReqT> : AvailableRouterMethod<ReqT>,
+ _ResT = ResT extends void ? FetchResult<ReqT, Method> : ResT,
+ DataT = _ResT,
+ PickKeys extends KeysOf<DataT> = KeysOf<DataT>,
+ DefaultT = [undefined] extends [FDefaultT] ? undefined : FDefaultT,
+ > (
+ request: Ref<ReqT> | ReqT | (() => ReqT),
+ opts: UseFetchOptionsWithTransform<_ResT, DataT, PickKeys, DefaultT, ReqT, Method>,
+ ): AsyncData<PickFrom<DataT, PickKeys> | DefaultT, ErrorT | undefined>
+ function useFetch<
+ ResT = void,
+ ErrorT = FetchError,
+ ReqT extends NitroFetchRequest = NitroFetchRequest,
+ Method extends AvailableRouterMethod<ReqT> = ResT extends void ? 'get' extends AvailableRouterMethod<ReqT> ? 'get' : AvailableRouterMethod<ReqT> : AvailableRouterMethod<ReqT>,
+ _ResT = ResT extends void ? FetchResult<ReqT, Method> : ResT,
+ DataT = _ResT,
+ PickKeys extends KeysOf<DataT> = KeysOf<DataT>,
+ DefaultT = [undefined] extends [FDefaultT] ? DataT : FDefaultT,
+ > (
+ request: Ref<ReqT> | ReqT | (() => ReqT),
+ opts: UseFetchOptionsWithTransform<_ResT, DataT, PickKeys, DefaultT, ReqT, Method>,
+ ): AsyncData<PickFrom<DataT, PickKeys> | DefaultT, ErrorT | undefined>
+ function useFetch<
+ ResT = void,
+ ErrorT = FetchError,
+ ReqT extends NitroFetchRequest = NitroFetchRequest,
+ Method extends AvailableRouterMethod<ReqT> = ResT extends void ? 'get' extends AvailableRouterMethod<ReqT> ? 'get' : AvailableRouterMethod<ReqT> : AvailableRouterMethod<ReqT>,
+ _ResT = ResT extends void ? FetchResult<ReqT, Method> : ResT,
+ DataT = [unknown] extends [FDataT] ? _ResT : FDataT,
+ PickKeys extends KeysOf<DataT> = KeysOf<DataT>,
+ DefaultT = [undefined] extends [FDefaultT] ? undefined : FDefaultT,
+ > (
+ request: Ref<ReqT> | ReqT | (() => ReqT),
+ opts?: UseFetchOptions<_ResT, DataT, PickKeys, DefaultT, ReqT, Method>,
+ ): AsyncData<PickFrom<DataT, [Array<never>] extends [FPickKeys] ? PickKeys : FPickKeys & KeysOf<DataT>> | DefaultT, ErrorT | undefined>
+ function useFetch<
+ ResT = void,
+ ErrorT = FetchError,
+ ReqT extends NitroFetchRequest = NitroFetchRequest,
+ Method extends AvailableRouterMethod<ReqT> = ResT extends void ? 'get' extends AvailableRouterMethod<ReqT> ? 'get' : AvailableRouterMethod<ReqT> : AvailableRouterMethod<ReqT>,
+ _ResT = ResT extends void ? FetchResult<ReqT, Method> : ResT,
+ DataT = [unknown] extends [FDataT] ? _ResT : FDataT,
+ PickKeys extends KeysOf<DataT> = KeysOf<DataT>,
+ DefaultT = [undefined] extends [FDefaultT] ? DataT : FDefaultT,
+ > (
+ request: Ref<ReqT> | ReqT | (() => ReqT),
+ opts?: UseFetchOptions<_ResT, DataT, PickKeys, DefaultT, ReqT, Method>,
+ ): AsyncData<PickFrom<DataT, [Array<never>] extends [FPickKeys] ? PickKeys : FPickKeys & KeysOf<DataT>> | DefaultT, ErrorT | undefined>
+ function useFetch<
+ ResT = void,
+ ErrorT = FetchError,
+ ReqT extends NitroFetchRequest = NitroFetchRequest,
+ Method extends AvailableRouterMethod<ReqT> = ResT extends void ? 'get' extends AvailableRouterMethod<ReqT> ? 'get' : AvailableRouterMethod<ReqT> : AvailableRouterMethod<ReqT>,
+ _ResT = ResT extends void ? FetchResult<ReqT, Method> : ResT,
+ DataT = _ResT,
+ PickKeys extends KeysOf<DataT> = KeysOf<DataT>,
+ DefaultT = undefined,
+ > (
+ request: Ref<ReqT> | ReqT | (() => ReqT),
+ arg1?: string | UseFetchOptions<_ResT, DataT, PickKeys, DefaultT, ReqT, Method>,
+ arg2?: string,
+ ) {
+ const [opts = {}, autoKey] = typeof arg1 === 'string' ? [{}, arg1] : [arg1, arg2]
+
+ const factoryOptions = (typeof options === 'function' ? options(opts as any) : options) as typeof opts
+
+ // Merge factory options with user options:
+ // - defaults mode (plain object): factory < user opts (factory provides defaults)
+ // - override mode (function): user opts < factory (factory overrides user opts)
+ const {
+ server,
+ lazy,
+ default: defaultFn,
+ transform,
+ pick,
+ watch: watchSources,
+ immediate,
+ getCachedData,
+ deep,
+ dedupe,
+ timeout,
+ ...fetchOptions
+ } = {
+ ...(typeof options === 'function' ? {} : factoryOptions),
+ ...opts,
+ ...(typeof options === 'function' ? factoryOptions : {}),
+ }
+
+ const _request = computed(() => toValue(request))
+
+ const key = computed(() => toValue(fetchOptions.key) || ('$f' + hash([autoKey, typeof _request.value === 'string' ? _request.value : '', ...generateOptionSegments(fetchOptions)])))
+
+ if (!fetchOptions.baseURL && typeof _request.value === 'string' && (_request.value[0] === '/' && _request.value[1] === '/')) {
+ throw new Error('[nuxt] [useFetch] the request URL must not start with "//".')
+ }
+
+ const _fetchOptions = reactive<typeof fetchOptions>({
+ ...fetchDefaults,
+ ...fetchOptions,
+ cache: typeof fetchOptions.cache === 'boolean' ? undefined : fetchOptions.cache,
+ })
+
+ const _asyncDataOptions: AsyncDataOptions<_ResT, DataT, PickKeys, DefaultT> = {
+ server,
+ lazy,
+ default: defaultFn,
+ transform,
+ pick,
+ immediate,
+ getCachedData,
+ deep,
+ dedupe,
+ timeout,
+ watch: watchSources === false ? [] : [...(watchSources || []), _fetchOptions],
+ }
+
+ if (import.meta.dev) {
+ // private property
+ (_asyncDataOptions as typeof _asyncDataOptions & { _functionName?: string })._functionName ||= (factoryOptions as typeof factoryOptions & { _functionName?: string })._functionName || 'useFetch'
+ }
+
+ if (watchSources === false) {
+ // opt-out of automatic re-execution while keeping key reactive
+ ;(_asyncDataOptions as typeof _asyncDataOptions & { _keyTriggersExecute?: boolean })._keyTriggersExecute = false
+ }
+
+ if (alwaysRunFetchOnKeyChange && !immediate) {
+ // ensure that updates to watched sources trigger an update
+ function setImmediate () {
+ _asyncDataOptions.immediate = true
+ }
+ watch(key, setImmediate, { flush: 'sync', once: true })
+ watch([...watchSources || [], _fetchOptions], setImmediate, { flush: 'sync', once: true })
+ }
+
+ const asyncData = useAsyncData<_ResT, ErrorT, DataT, PickKeys, DefaultT>(key, (_, { signal }) => {
+ const _$fetch: $Fetch<unknown, NitroFetchRequest> = fetchOptions.$fetch || $fetch
+
+ return _$fetch(_request.value, { signal, ..._fetchOptions } as any) as Promise<_ResT>
+ }, _asyncDataOptions)
+
+ return asyncData
+ }
+
+ return useFetch as unknown as UseFetch<FDataT, FPickKeys, FDefaultT>
+ },
+})
+
+export const useFetch: UseFetch = (createUseFetch as unknown as { __nuxt_factory: typeof createUseFetch }).__nuxt_factory()
+
+export const useLazyFetch: UseFetch = (createUseFetch as unknown as { __nuxt_factory: typeof createUseFetch }).__nuxt_factory({
+ lazy: true,
+ // @ts-expect-error private property
+ _functionName: 'useLazyFetch',
+}) as ReturnType<typeof createUseFetch>
diff --git a/packages/nuxt/src/app/composables/head.ts b/packages/nuxt/src/app/composables/head.ts
new file mode 100644
index 000000000000..93632701b758
--- /dev/null
+++ b/packages/nuxt/src/app/composables/head.ts
@@ -0,0 +1,2 @@
+// eslint-disable-next-line @typescript-eslint/no-deprecated
+export { injectHead, useHead, useServerHead, useSeoMeta, useServerSeoMeta, useHeadSafe, useServerHeadSafe } from '#unhead/composables'
diff --git a/packages/nuxt/src/app/composables/hydrate.ts b/packages/nuxt/src/app/composables/hydrate.ts
new file mode 100644
index 000000000000..0845477e3c56
--- /dev/null
+++ b/packages/nuxt/src/app/composables/hydrate.ts
@@ -0,0 +1,25 @@
+import { useNuxtApp } from '../nuxt'
+import type { NuxtPayload } from '../nuxt'
+
+/**
+ * Allows full control of the hydration cycle to set and receive data from the server.
+ * @param key a unique key to identify the data in the Nuxt payload
+ * @param get a function that returns the value to set the initial data
+ * @param set a function that will receive the data on the client-side
+ * @since 3.0.0
+ */
+export const useHydration = <K extends keyof NuxtPayload, T = NuxtPayload[K]> (key: K, get: () => T, set: (value: T) => void): void => {
+ const nuxtApp = useNuxtApp()
+
+ if (import.meta.server) {
+ nuxtApp.hooks.hook('app:rendered', () => {
+ nuxtApp.payload[key] = get()
+ })
+ }
+
+ if (import.meta.client) {
+ nuxtApp.hooks.hook('app:created', () => {
+ set(nuxtApp.payload[key] as T)
+ })
+ }
+}
diff --git a/packages/nuxt/src/app/composables/id.ts b/packages/nuxt/src/app/composables/id.ts
new file mode 100644
index 000000000000..53a1f90cbdea
--- /dev/null
+++ b/packages/nuxt/src/app/composables/id.ts
@@ -0,0 +1,4 @@
+import { useId as _useId } from 'vue'
+
+/** @deprecated Use `useId` from `vue` */
+export const useId: typeof _useId = _useId
diff --git a/packages/nuxt/src/app/composables/index.ts b/packages/nuxt/src/app/composables/index.ts
new file mode 100644
index 000000000000..8335d47f3a42
--- /dev/null
+++ b/packages/nuxt/src/app/composables/index.ts
@@ -0,0 +1,35 @@
+export { defineNuxtComponent } from './component'
+export { useAsyncData, useLazyAsyncData, useNuxtData, refreshNuxtData, clearNuxtData } from './asyncData'
+export type { AsyncDataOptions, AsyncDataOptionsWithTransform, AsyncData, AsyncDataRequestStatus } from './asyncData'
+export { useHydration } from './hydrate'
+export { callOnce } from './once'
+export { useState, clearNuxtState } from './state'
+export { clearError, createError, isNuxtError, showError, useError } from './error'
+export type { NuxtError } from './error'
+export { useFetch, useLazyFetch } from './fetch'
+export type { FetchResult, UseFetchOptions } from './fetch'
+export { useCookie, refreshCookie } from './cookie'
+export type { CookieOptions, CookieRef } from './cookie'
+// eslint-disable-next-line @typescript-eslint/no-deprecated
+export { onPrehydrate, prerenderRoutes, useRequestHeaders, useRequestEvent, useRequestFetch, setResponseStatus, useResponseHeader } from './ssr'
+export { onNuxtReady } from './ready'
+export { abortNavigation, addRouteMiddleware, defineNuxtRouteMiddleware, onBeforeRouteLeave, onBeforeRouteUpdate, setPageLayout, navigateTo, useRoute, useRouter } from './router'
+export type { AddRouteMiddlewareOptions, RouteMiddleware } from './router'
+export { preloadComponents, prefetchComponents, preloadRouteComponents } from './preload'
+export { isPrerendered, loadPayload, preloadPayload, definePayloadReducer, definePayloadReviver } from './payload'
+// eslint-disable-next-line @typescript-eslint/no-deprecated
+export { getAppManifest, getRouteRules } from './manifest'
+export type { NuxtAppManifest, NuxtAppManifestMeta } from './manifest'
+export type { ReloadNuxtAppOptions } from './chunk'
+export { reloadNuxtApp } from './chunk'
+export { useRequestURL } from './url'
+export { usePreviewMode } from './preview'
+// eslint-disable-next-line @typescript-eslint/no-deprecated
+export { useId } from './id'
+export { useRouteAnnouncer } from './route-announcer'
+export type { Politeness } from './route-announcer'
+export { useAnnouncer } from './announcer'
+export type { AnnouncerPoliteness, NuxtAnnouncer, NuxtAnnouncerOpts } from './announcer'
+export { useRuntimeHook } from './runtime-hook'
+// eslint-disable-next-line @typescript-eslint/no-deprecated
+export { injectHead, useHead, useHeadSafe, useSeoMeta, useServerHead, useServerHeadSafe, useServerSeoMeta } from './head'
diff --git a/packages/nuxt/src/app/composables/lazy-hydration.ts b/packages/nuxt/src/app/composables/lazy-hydration.ts
new file mode 100644
index 000000000000..59f7de16f84b
--- /dev/null
+++ b/packages/nuxt/src/app/composables/lazy-hydration.ts
@@ -0,0 +1,13 @@
+import type { AsyncComponentLoader, Component, ComponentPublicInstance, DefineComponent } from 'vue'
+
+type LazyHydrationComponent<T extends Component, Props> = T & DefineComponent<Props, {}, {}, {}, {}, {}, {}, { hydrated: () => void }>
+
+export function defineLazyHydrationComponent<T extends Component = { new (): ComponentPublicInstance }> (strategy: 'visible', source: AsyncComponentLoader<T>): LazyHydrationComponent<T, { hydrateOnVisible?: IntersectionObserverInit | true }>
+export function defineLazyHydrationComponent<T extends Component = { new (): ComponentPublicInstance }> (strategy: 'idle', source: AsyncComponentLoader<T>): LazyHydrationComponent<T, { hydrateOnIdle?: number | true }>
+export function defineLazyHydrationComponent<T extends Component = { new (): ComponentPublicInstance }> (strategy: 'interaction', source: AsyncComponentLoader<T>): LazyHydrationComponent<T, { hydrateOnInteraction?: keyof HTMLElementEventMap | Array<keyof HTMLElementEventMap> }>
+export function defineLazyHydrationComponent<T extends Component = { new (): ComponentPublicInstance }> (strategy: 'mediaQuery', source: AsyncComponentLoader<T>): LazyHydrationComponent<T, { hydrateOnMediaQuery: string }>
+export function defineLazyHydrationComponent<T extends Component = { new (): ComponentPublicInstance }> (strategy: 'if', source: AsyncComponentLoader<T>): LazyHydrationComponent<T, { hydrateWhen: boolean }>
+export function defineLazyHydrationComponent<T extends Component = { new (): ComponentPublicInstance }> (strategy: 'time', source: AsyncComponentLoader<T>): LazyHydrationComponent<T, { hydrateAfter: number | true }>
+export function defineLazyHydrationComponent<T extends Component = { new (): ComponentPublicInstance }> (strategy: 'never', source: AsyncComponentLoader<T>): LazyHydrationComponent<T, { hydrateNever?: true }>
+
+export function defineLazyHydrationComponent (_strategy: string, _source: AsyncComponentLoader<any>): any {}
diff --git a/packages/nuxt/src/app/composables/loading-indicator.ts b/packages/nuxt/src/app/composables/loading-indicator.ts
new file mode 100644
index 000000000000..e55b5073164e
--- /dev/null
+++ b/packages/nuxt/src/app/composables/loading-indicator.ts
@@ -0,0 +1,189 @@
+import { getCurrentScope, onScopeDispose, shallowReadonly, shallowRef } from 'vue'
+import type { ShallowRef } from 'vue'
+import { useNuxtApp } from '../nuxt'
+
+export type LoadingIndicatorOpts = {
+ /** @default 2000 */
+ duration: number
+ /** @default 200 */
+ throttle: number
+ /** @default 500 */
+ hideDelay: number
+ /** @default 400 */
+ resetDelay: number
+ /**
+ * You can provide a custom function to customize the progress estimation,
+ * which is a function that receives the duration of the loading bar (above)
+ * and the elapsed time. It should return a value between 0 and 100.
+ */
+ estimatedProgress?: (duration: number, elapsed: number) => number
+}
+
+export type LoadingIndicator = {
+ _cleanup: () => void
+ progress: Readonly<ShallowRef<number>>
+ isLoading: Readonly<ShallowRef<boolean>>
+ error: Readonly<ShallowRef<boolean>>
+ start: (opts?: { force?: boolean }) => void
+ set: (value: number, opts?: { force?: boolean }) => void
+ finish: (opts?: { force?: boolean, error?: boolean }) => void
+ clear: () => void
+}
+
+function defaultEstimatedProgress (duration: number, elapsed: number): number {
+ const completionPercentage = elapsed / duration * 100
+ return (2 / Math.PI * 100) * Math.atan(completionPercentage / 50)
+}
+
+function createLoadingIndicator (opts: Partial<LoadingIndicatorOpts> = {}) {
+ const { duration = 2000, throttle = 200, hideDelay = 500, resetDelay = 400 } = opts
+ const getProgress = opts.estimatedProgress || defaultEstimatedProgress
+ const nuxtApp = useNuxtApp()
+ const progress = shallowRef(0)
+ const isLoading = shallowRef(false)
+ const error = shallowRef(false)
+ let done = false
+ let rafId: number
+
+ let throttleTimeout: number | NodeJS.Timeout
+ let hideTimeout: number | NodeJS.Timeout
+ let resetTimeout: number | NodeJS.Timeout
+
+ const start = (opts: { force?: boolean } = {}) => {
+ _clearTimeouts()
+ error.value = false
+ set(0, opts)
+ }
+
+ function set (at = 0, opts: { force?: boolean } = {}) {
+ if (nuxtApp.isHydrating) {
+ return
+ }
+ if (at >= 100) { return finish({ force: opts.force }) }
+ clear()
+ progress.value = at < 0 ? 0 : at
+ const throttleTime = opts.force ? 0 : throttle
+ if (throttleTime && import.meta.client) {
+ throttleTimeout = setTimeout(() => {
+ isLoading.value = true
+ _startProgress()
+ }, throttleTime)
+ } else {
+ isLoading.value = true
+ _startProgress()
+ }
+ }
+
+ function _hide () {
+ if (import.meta.client) {
+ hideTimeout = setTimeout(() => {
+ isLoading.value = false
+ resetTimeout = setTimeout(() => { progress.value = 0 }, resetDelay)
+ }, hideDelay)
+ }
+ }
+
+ function finish (opts: { force?: boolean, error?: boolean } = {}) {
+ progress.value = 100
+ done = true
+ clear()
+ _clearTimeouts()
+ if (opts.error) {
+ error.value = true
+ }
+ if (opts.force) {
+ progress.value = 0
+ isLoading.value = false
+ } else {
+ _hide()
+ }
+ }
+
+ function _clearTimeouts () {
+ if (import.meta.client) {
+ clearTimeout(hideTimeout)
+ clearTimeout(resetTimeout)
+ }
+ }
+
+ function clear () {
+ if (import.meta.client) {
+ clearTimeout(throttleTimeout)
+ cancelAnimationFrame(rafId)
+ }
+ }
+
+ function _startProgress () {
+ done = false
+ let startTimeStamp: number
+
+ function step (timeStamp: number): void {
+ if (done) { return }
+
+ startTimeStamp ??= timeStamp
+ const elapsed = timeStamp - startTimeStamp
+ progress.value = Math.max(0, Math.min(100, getProgress(duration, elapsed)))
+ if (import.meta.client) {
+ rafId = requestAnimationFrame(step)
+ }
+ }
+
+ if (import.meta.client) {
+ rafId = requestAnimationFrame(step)
+ }
+ }
+
+ let _cleanup = () => {}
+ if (import.meta.client) {
+ const unsubLoadingStartHook = nuxtApp.hook('page:loading:start', () => {
+ start()
+ })
+ const unsubLoadingFinishHook = nuxtApp.hook('page:loading:end', () => {
+ finish()
+ })
+ const unsubError = nuxtApp.hook('vue:error', () => finish({ error: true }))
+
+ _cleanup = () => {
+ unsubError()
+ unsubLoadingStartHook()
+ unsubLoadingFinishHook()
+ clear()
+ _clearTimeouts()
+ }
+ }
+
+ return {
+ _cleanup,
+ progress: shallowReadonly(progress),
+ isLoading: shallowReadonly(isLoading),
+ error: shallowReadonly(error),
+ start,
+ set,
+ finish,
+ clear,
+ }
+}
+
+/**
+ * composable to handle the loading state of the page
+ * @since 3.9.0
+ */
+export function useLoadingIndicator (opts: Partial<LoadingIndicatorOpts> = {}): Omit<LoadingIndicator, '_cleanup'> {
+ const nuxtApp = useNuxtApp()
+
+ // Initialise global loading indicator if it doesn't exist already
+ const indicator = nuxtApp._loadingIndicator ||= createLoadingIndicator(opts)
+ if (import.meta.client && getCurrentScope()) {
+ nuxtApp._loadingIndicatorDeps ||= 0
+ nuxtApp._loadingIndicatorDeps++
+ onScopeDispose(() => {
+ nuxtApp._loadingIndicatorDeps!--
+ if (nuxtApp._loadingIndicatorDeps === 0) {
+ indicator._cleanup()
+ delete nuxtApp._loadingIndicator
+ }
+ })
+ }
+
+ return indicator
+}
diff --git a/packages/nuxt/src/app/composables/manifest.ts b/packages/nuxt/src/app/composables/manifest.ts
new file mode 100644
index 000000000000..19fe577bad28
--- /dev/null
+++ b/packages/nuxt/src/app/composables/manifest.ts
@@ -0,0 +1,76 @@
+import type { H3Event } from '@nuxt/nitro-server/h3'
+import type { NitroRouteRules } from 'nitro/types'
+import { useRuntimeConfig } from '../nuxt'
+// @ts-expect-error virtual file
+import { appManifest as isAppManifestEnabled } from '#build/nuxt.config.mjs'
+// @ts-expect-error virtual file
+import { buildAssetsURL } from '#internal/nuxt/paths'
+// @ts-expect-error virtual file
+import _routeRulesMatcher from '#build/route-rules.mjs'
+
+const routeRulesMatcher = _routeRulesMatcher as (path: string) => NitroRouteRules
+
+export interface NuxtAppManifestMeta {
+ id: string
+ timestamp: number
+}
+
+export interface NuxtAppManifest extends NuxtAppManifestMeta {
+ prerendered: string[]
+}
+
+let manifest: Promise<NuxtAppManifest> | undefined
+
+function fetchManifest (): Promise<NuxtAppManifest> {
+ if (!isAppManifestEnabled) {
+ throw new Error('[nuxt] app manifest should be enabled with `experimental.appManifest`')
+ }
+ let _manifest: Promise<NuxtAppManifest>
+ if (import.meta.server) {
+ // @ts-expect-error virtual file
+ _manifest = import(/* webpackIgnore: true */ /* @vite-ignore */ '#app-manifest')
+ } else {
+ _manifest = $fetch<NuxtAppManifest>(buildAssetsURL(`builds/meta/${useRuntimeConfig().app.buildId}.json`), {
+ responseType: 'json',
+ }).then((res) => {
+ // handle errors fetching manifest, e.g. from an improperly configured proxy
+ if (!res || typeof res !== 'object' || !Array.isArray((res as NuxtAppManifest).prerendered)) {
+ throw new Error('[nuxt] Received malformed app manifest. Ensure that `builds/meta/*.json` is served as JSON by your hosting/proxy and not rewritten to an HTML fallback.')
+ }
+ return res
+ })
+ }
+ manifest = _manifest
+ _manifest.catch((e) => {
+ // Reset so subsequent calls to getAppManifest() retry instead of
+ // returning the same rejected promise permanently.
+ if (manifest === _manifest) {
+ manifest = undefined
+ }
+ console.error('[nuxt] Error fetching app manifest.', e)
+ })
+ return _manifest
+}
+
+/** @since 3.7.4 */
+export function getAppManifest (): Promise<NuxtAppManifest> {
+ if (!isAppManifestEnabled) {
+ throw new Error('[nuxt] app manifest should be enabled with `experimental.appManifest`')
+ }
+ return manifest || fetchManifest()
+}
+
+/** @since 3.7.4 */
+export function getRouteRules (event: H3Event): NitroRouteRules
+export function getRouteRules (options: { path: string }): Record<string, any>
+/** @deprecated use `getRouteRules({ path })` instead */
+export function getRouteRules (url: string): Record<string, any>
+export function getRouteRules (arg: string | H3Event | { path: string }) {
+ const path = typeof arg === 'string' ? arg : 'url' in arg ? arg.url.pathname : arg.path
+ try {
+ return routeRulesMatcher(path)
+ } catch (e) {
+ console.error('[nuxt] Error matching route rules.', e)
+ return {}
+ }
+}
diff --git a/packages/nuxt/src/app/composables/once.ts b/packages/nuxt/src/app/composables/once.ts
new file mode 100644
index 000000000000..52f0ddd19622
--- /dev/null
+++ b/packages/nuxt/src/app/composables/once.ts
@@ -0,0 +1,71 @@
+import { useRouter } from './router'
+import { useNuxtApp } from '../nuxt'
+
+type CallOnceOptions = {
+ mode?: 'navigation' | 'render'
+}
+
+let _isHmrUpdating = false
+
+/**
+ * An SSR-friendly utility to call a method once
+ * @param key a unique key ensuring the function can be properly de-duplicated across requests
+ * @param fn a function to call
+ * @param options Setup the mode, e.g. to re-execute on navigation
+ * @see https://nuxt.com/docs/4.x/api/utils/call-once
+ * @since 3.9.0
+ */
+export function callOnce (key?: string, fn?: (() => any | Promise<any>), options?: CallOnceOptions): Promise<void>
+export function callOnce (fn?: (() => any | Promise<any>), options?: CallOnceOptions): Promise<void>
+export async function callOnce (...args: any[]): Promise<void> {
+ const autoKey = typeof args[args.length - 1] === 'string' ? args.pop() : undefined
+ if (typeof args[0] !== 'string') { args.unshift(autoKey) }
+ const [_key, fn, options] = args as [string, (() => any | Promise<any>), CallOnceOptions | undefined]
+ if (!_key || typeof _key !== 'string') {
+ throw new TypeError('[nuxt] [callOnce] key must be a string: ' + _key)
+ }
+ if (fn !== undefined && typeof fn !== 'function') {
+ throw new Error('[nuxt] [callOnce] fn must be a function: ' + fn)
+ }
+ const nuxtApp = useNuxtApp()
+
+ if (options?.mode === 'navigation') {
+ const removeGuard = useRouter().beforeResolve(() => {
+ nuxtApp.payload.once.delete(_key)
+ removeGuard()
+ })
+ }
+
+ // If key already ran
+ if (nuxtApp.payload.once.has(_key)) {
+ // Allow re-execution during HMR
+ if (!import.meta.dev || !_isHmrUpdating) {
+ return
+ }
+ }
+
+ nuxtApp._once ||= {}
+ nuxtApp._once[_key] ||= fn() || true
+ try {
+ await nuxtApp._once[_key]
+ } catch (e) {
+ delete nuxtApp._once[_key]
+ throw e
+ }
+ nuxtApp.payload.once.add(_key)
+ delete nuxtApp._once[_key]
+}
+
+if (import.meta.hot) {
+ import.meta.hot.on('vite:beforeUpdate', (payload) => {
+ if (payload.updates.some((u: any) => u.type === 'js-update')) {
+ _isHmrUpdating = true
+ }
+ })
+
+ import.meta.hot.on('vite:afterUpdate', (payload) => {
+ if (payload.updates.some((u: any) => u.type === 'js-update')) {
+ _isHmrUpdating = false
+ }
+ })
+}
diff --git a/packages/nuxt/src/app/composables/pages.ts b/packages/nuxt/src/app/composables/pages.ts
new file mode 100644
index 000000000000..c512f803a74b
--- /dev/null
+++ b/packages/nuxt/src/app/composables/pages.ts
@@ -0,0 +1,3 @@
+export type { PageMeta } from '#pages/composables'
+
+export { definePageMeta, defineRouteRules } from '#pages/composables'
diff --git a/packages/nuxt/src/app/composables/payload.ts b/packages/nuxt/src/app/composables/payload.ts
new file mode 100644
index 000000000000..45984c4ba9c4
--- /dev/null
+++ b/packages/nuxt/src/app/composables/payload.ts
@@ -0,0 +1,223 @@
+import { hasProtocol, joinURL } from 'ufo'
+import { parse } from 'devalue'
+import { defineLink } from '@unhead/vue'
+import { getCurrentInstance, onServerPrefetch, reactive } from 'vue'
+import { useNuxtApp, useRuntimeConfig } from '../nuxt'
+import type { NuxtPayload } from '../nuxt'
+import { useHead } from './head'
+
+import { useRoute } from './router'
+import { getAppManifest, getRouteRules } from './manifest'
+
+// @ts-expect-error virtual import
+import { appId, appManifest, multiApp, payloadExtraction } from '#build/nuxt.config.mjs'
+
+interface LoadPayloadOptions {
+ fresh?: boolean
+ hash?: string
+}
+
+/** @since 3.0.0 */
+export async function loadPayload (url: string, opts: LoadPayloadOptions = {}): Promise<Record<string, any> | null> {
+ if (import.meta.server || !payloadExtraction) { return null }
+ if (await shouldLoadPayload(url)) {
+ const payloadURL = await _getPayloadURL(url, opts)
+ return await _importPayload(payloadURL) || null
+ }
+ return null
+}
+let linkRelType: string | undefined
+function detectLinkRelType () {
+ if (import.meta.server) { return 'preload' }
+ if (linkRelType) { return linkRelType }
+ const relList = document.createElement('link').relList
+ linkRelType = relList && relList.supports && relList.supports('prefetch') ? 'prefetch' : 'preload'
+ return linkRelType
+}
+/** @since 3.0.0 */
+export function preloadPayload (url: string, opts: LoadPayloadOptions = {}): Promise<void> {
+ const nuxtApp = useNuxtApp()
+ const promise = shouldLoadPayload(url).then(async (shouldPreload) => {
+ if (!shouldPreload) {
+ return
+ }
+ const payloadURL = await _getPayloadURL(url, opts)
+ const rel = detectLinkRelType()
+ const link = defineLink({ rel, as: 'fetch', crossorigin: 'anonymous', href: payloadURL })
+
+ if (import.meta.server) {
+ nuxtApp.runWithContext(() => useHead({ link: [link] }))
+ } else {
+ const linkEl = document.createElement('link')
+ linkEl.rel = rel
+ linkEl.setAttribute('as', 'fetch')
+ linkEl.crossOrigin = 'anonymous'
+ linkEl.href = payloadURL
+ document.head.appendChild(linkEl)
+ return new Promise<void>((resolve, reject) => {
+ linkEl.addEventListener('load', () => resolve())
+ linkEl.addEventListener('error', () => reject())
+ })
+ }
+ })
+ if (import.meta.server) {
+ onServerPrefetch(() => promise)
+ }
+ return promise
+}
+
+// --- Internal ---
+
+const filename = '_payload.json'
+async function _getPayloadURL (url: string, opts: LoadPayloadOptions = {}) {
+ const u = new URL(url, 'http://localhost')
+ if (u.host !== 'localhost' || hasProtocol(u.pathname, { acceptRelative: true })) {
+ throw new Error('Payload URL must not include hostname: ' + url)
+ }
+ const config = useRuntimeConfig()
+ const hash = opts.hash || (opts.fresh || import.meta.dev ? Date.now() : config.app.buildId)
+ const cdnURL = config.app.cdnURL
+ const baseOrCdnURL = cdnURL && await isPrerendered(url) ? cdnURL : config.app.baseURL
+ return joinURL(baseOrCdnURL, u.pathname, filename + (hash ? `?${hash}` : ''))
+}
+
+async function _importPayload (payloadURL: string) {
+ if (import.meta.server || !payloadExtraction) { return null }
+ try {
+ const res = await fetch(payloadURL, import.meta.dev ? {} : { cache: 'force-cache' })
+ if (!res.ok) {
+ if (import.meta.dev) {
+ console.warn(`[nuxt] Cannot load payload ${payloadURL}: ${res.status} ${res.statusText}`)
+ }
+ return null
+ }
+ return await parsePayload(await res.text())
+ } catch (err) {
+ console.warn('[nuxt] Cannot load payload ', payloadURL, err)
+ }
+ return null
+}
+
+function _shouldLoadPrerenderedPayload (rules: Record<string, any>) {
+ if (rules.redirect) {
+ return false
+ }
+ if (rules.prerender) {
+ return true
+ }
+}
+
+async function _isPrerenderedInManifest (url: string) {
+ // Note: Alternative for server is checking x-nitro-prerender header
+ if (!appManifest) {
+ return false
+ }
+ url = url === '/' ? url : url.replace(/\/$/, '')
+ try {
+ const manifest = await getAppManifest()
+ return manifest.prerendered.includes(url)
+ } catch {
+ // handle errors fetching manifest
+ return false
+ }
+}
+
+/**
+ * @internal
+ */
+export async function shouldLoadPayload (url: string = useRoute().path): Promise<boolean> {
+ const rules = getRouteRules({ path: url })
+ if (rules.ssr === false) {
+ return false
+ }
+ const res = _shouldLoadPrerenderedPayload(rules)
+ if (res !== undefined) {
+ return res
+ }
+
+ if (rules.payload) {
+ return true
+ }
+
+ const prerendered = await _isPrerenderedInManifest(url)
+ return prerendered
+}
+
+/** @since 3.0.0 */
+export async function isPrerendered (url: string = useRoute().path): Promise<boolean> {
+ const res = _shouldLoadPrerenderedPayload(getRouteRules({ path: url }))
+ if (res !== undefined) {
+ return res
+ }
+
+ const prerendered = await _isPrerenderedInManifest(url)
+ return prerendered
+}
+
+let payloadCache: NuxtPayload | null = null
+
+/** @since 3.4.0 */
+export async function getNuxtClientPayload (): Promise<NuxtPayload | Partial<NuxtPayload> | null> {
+ if (import.meta.server) {
+ return null
+ }
+ if (payloadCache) {
+ return payloadCache
+ }
+
+ const el = multiApp ? document.querySelector(`[data-nuxt-data="${appId}"]`) as HTMLElement : document.getElementById('__NUXT_DATA__')
+ if (!el) {
+ return {} as Partial<NuxtPayload>
+ }
+
+ const inlineData = await parsePayload(el.textContent || '')
+
+ const externalData = el.dataset.src ? await _importPayload(el.dataset.src) : undefined
+
+ payloadCache = {
+ ...inlineData,
+ ...externalData,
+ ...(multiApp ? window.__NUXT__?.[appId] : window.__NUXT__),
+ }
+
+ if (payloadCache!.config?.public) {
+ payloadCache!.config.public = reactive(payloadCache!.config.public)
+ }
+
+ return payloadCache
+}
+
+export async function parsePayload (payload: string): Promise<any> {
+ return await parse(payload, useNuxtApp()._payloadRevivers)
+}
+
+/**
+ * This is an experimental function for configuring passing rich data from server -> client.
+ * @since 3.4.0
+ */
+export function definePayloadReducer (
+ name: string,
+ reduce: (data: any) => any,
+): void {
+ if (import.meta.server) {
+ useNuxtApp().ssrContext!['~payloadReducers'][name] = reduce
+ }
+}
+
+/**
+ * This is an experimental function for configuring passing rich data from server -> client.
+ *
+ * This function _must_ be called in a Nuxt plugin that is `unshift`ed to the beginning of the Nuxt plugins array.
+ * @since 3.4.0
+ */
+export function definePayloadReviver (
+ name: string,
+ revive: (data: any) => any | undefined,
+): void {
+ if (import.meta.dev && getCurrentInstance()) {
+ console.warn('[nuxt] [definePayloadReviver] This function must be called in a Nuxt plugin that is `unshift`ed to the beginning of the Nuxt plugins array.')
+ }
+ if (import.meta.client) {
+ useNuxtApp()._payloadRevivers[name] = revive
+ }
+}
diff --git a/packages/nuxt/src/app/composables/preload.ts b/packages/nuxt/src/app/composables/preload.ts
new file mode 100644
index 000000000000..6ec142d03f97
--- /dev/null
+++ b/packages/nuxt/src/app/composables/preload.ts
@@ -0,0 +1,76 @@
+import type { Component } from 'vue'
+import type { RouteLocationRaw, Router } from 'vue-router'
+import { useNuxtApp } from '../nuxt'
+import { toArray } from '../utils'
+import { useRouter } from './router'
+
+/**
+ * Preload a component or components that have been globally registered.
+ * @param components Pascal-cased name or names of components to prefetch
+ * @since 3.0.0
+ */
+export const preloadComponents = async (components: string | string[]): Promise<void> => {
+ if (import.meta.server) { return }
+ const nuxtApp = useNuxtApp()
+
+ components = toArray(components)
+ await Promise.all(components.map((name) => {
+ const component = nuxtApp.vueApp._context.components[name]
+ if (component) {
+ return _loadAsyncComponent(component)
+ }
+ }))
+}
+
+/**
+ * Prefetch a component or components that have been globally registered.
+ * @param components Pascal-cased name or names of components to prefetch
+ * @since 3.0.0
+ */
+export const prefetchComponents = (components: string | string[]): Promise<void> | undefined => {
+ if (import.meta.server) { return }
+
+ // TODO
+ return preloadComponents(components)
+}
+
+// --- Internal ---
+
+export function _loadAsyncComponent (component: Component): unknown {
+ if ((component as any)?.__asyncLoader && !(component as any).__asyncResolved) {
+ return (component as any).__asyncLoader()
+ }
+}
+
+/** @since 3.0.0 */
+export async function preloadRouteComponents (to: RouteLocationRaw, router: Router & { _routePreloaded?: Set<string>, _preloadPromises?: Array<Promise<unknown>> } = useRouter()): Promise<void> {
+ if (import.meta.server) { return }
+
+ const { path, matched } = router.resolve(to)
+
+ if (!matched.length) { return }
+ router._routePreloaded ||= new Set()
+ if (router._routePreloaded.has(path)) { return }
+
+ const promises = router._preloadPromises ||= []
+
+ if (promises.length > 4) {
+ // Defer adding new preload requests until the existing ones have resolved
+ return Promise.all(promises).then(() => preloadRouteComponents(to, router))
+ }
+
+ router._routePreloaded.add(path)
+
+ for (const route of matched) {
+ const component = route.components?.default
+ if (typeof component !== 'function') {
+ continue
+ }
+ const promise = Promise.resolve((component as () => unknown)())
+ .catch(() => {})
+ .finally(() => promises.splice(promises.indexOf(promise), 1))
+ promises.push(promise)
+ }
+
+ await Promise.all(promises)
+}
diff --git a/packages/nuxt/src/app/composables/preview.ts b/packages/nuxt/src/app/composables/preview.ts
new file mode 100644
index 000000000000..f7fb2cff3978
--- /dev/null
+++ b/packages/nuxt/src/app/composables/preview.ts
@@ -0,0 +1,115 @@
+import { toRef, watch } from 'vue'
+import type { Ref } from 'vue'
+
+import { useState } from './state'
+import { refreshNuxtData } from './asyncData'
+import { useRoute, useRouter } from './router'
+
+interface Preview {
+ enabled: boolean
+ state: Record<any, unknown>
+ _initialized?: boolean
+}
+
+/**
+ * Options for configuring preview mode.
+ */
+interface PreviewModeOptions<S> {
+ /**
+ * A function that determines whether preview mode should be enabled based on the current state.
+ * @param {Record<any, unknown>} state - The state of the preview.
+ * @returns {boolean} A boolean indicating whether the preview mode is enabled.
+ */
+ shouldEnable?: (state: Preview['state']) => boolean
+ /**
+ * A function that retrieves the current state.
+ * The `getState` function will append returned values to current state, so be careful not to accidentally overwrite important state.
+ * @param {Record<any, unknown>} state - The preview state.
+ * @returns {Record<any, unknown>} The preview state.
+ */
+ getState?: (state: Preview['state']) => S
+ /**
+ * A function to be called when the preview mode is enabled.
+ */
+ onEnable?: () => void
+ /**
+ * A function to be called when the preview mode is disabled.
+ */
+ onDisable?: () => void
+}
+
+type EnteredState = Record<any, unknown> | null | undefined | void
+
+let unregisterRefreshHook: (() => any) | undefined
+
+/** @since 3.11.0 */
+export function usePreviewMode<S extends EnteredState> (options: PreviewModeOptions<S> = {}): { enabled: Ref<boolean>, state: S extends void ? Preview['state'] : (NonNullable<S> & Preview['state']) } {
+ const preview = useState<Preview>('_preview-state', () => ({
+ enabled: false,
+ state: {},
+ }))
+
+ if (preview.value._initialized) {
+ return {
+ enabled: toRef(preview.value, 'enabled'),
+ state: preview.value.state as S extends void ? Preview['state'] : (NonNullable<S> & Preview['state']),
+ }
+ }
+
+ if (import.meta.client) {
+ preview.value._initialized = true
+ }
+
+ if (!preview.value.enabled) {
+ const shouldEnable = options.shouldEnable ?? defaultShouldEnable
+ const result = shouldEnable(preview.value.state)
+
+ if (typeof result === 'boolean') { preview.value.enabled = result }
+ }
+
+ watch(() => preview.value.enabled, (value) => {
+ if (value) {
+ const getState = options.getState ?? getDefaultState
+ const newState = getState(preview.value.state)
+
+ if (newState !== preview.value.state) {
+ Object.assign(preview.value.state, newState)
+ }
+
+ if (import.meta.client && !unregisterRefreshHook) {
+ const onEnable = options.onEnable ?? refreshNuxtData
+ onEnable()
+
+ unregisterRefreshHook = options.onDisable ?? useRouter().afterEach(() => refreshNuxtData())
+ }
+ } else if (unregisterRefreshHook) {
+ unregisterRefreshHook()
+
+ unregisterRefreshHook = undefined
+ }
+ }, { immediate: true, flush: 'sync' })
+
+ return {
+ enabled: toRef(preview.value, 'enabled'),
+ state: preview.value.state as S extends void ? Preview['state'] : (NonNullable<S> & Preview['state']),
+ }
+}
+
+function defaultShouldEnable (): boolean {
+ const route = useRoute()
+ const previewQueryName = 'preview'
+
+ return route.query[previewQueryName] === 'true'
+}
+
+function getDefaultState (state: Preview['state']): Preview['state'] {
+ if (state.token !== undefined) {
+ return state
+ }
+
+ const route = useRoute()
+
+ state.token = Array.isArray(route.query.token) ? route.query.token[0] : route.query.token
+
+ return state
+}
diff --git a/packages/nuxt/src/app/composables/ready.ts b/packages/nuxt/src/app/composables/ready.ts
new file mode 100644
index 000000000000..79dd27b6fa39
--- /dev/null
+++ b/packages/nuxt/src/app/composables/ready.ts
@@ -0,0 +1,14 @@
+import { useNuxtApp } from '../nuxt'
+import { requestIdleCallback } from '../compat/idle-callback'
+
+/** @since 3.1.0 */
+export const onNuxtReady = (callback: () => any): void => {
+ if (import.meta.server) { return }
+
+ const nuxtApp = useNuxtApp()
+ if (nuxtApp.isHydrating) {
+ nuxtApp.hooks.hookOnce('app:suspense:resolve', () => { requestIdleCallback(() => callback()) })
+ } else {
+ requestIdleCallback(() => callback())
+ }
+}
diff --git a/packages/nuxt/src/app/composables/route-announcer.ts b/packages/nuxt/src/app/composables/route-announcer.ts
new file mode 100644
index 000000000000..16aa11719ccc
--- /dev/null
+++ b/packages/nuxt/src/app/composables/route-announcer.ts
@@ -0,0 +1,89 @@
+import type { Ref } from 'vue'
+import { getCurrentScope, onScopeDispose, shallowRef } from 'vue'
+import { useNuxtApp } from '../nuxt'
+import { injectHead } from './head'
+
+export type Politeness = 'assertive' | 'polite' | 'off'
+
+export type NuxtRouteAnnouncerOpts = {
+ /** @default 'polite' */
+ politeness?: Politeness
+}
+
+export type RouteAnnouncer = {
+ message: Ref<string>
+ politeness: Ref<Politeness>
+ set: (message: string, politeness?: Politeness) => void
+ polite: (message: string) => void
+ assertive: (message: string) => void
+ _cleanup: () => void
+}
+
+function createRouteAnnouncer (opts: NuxtRouteAnnouncerOpts = {}) {
+ const message = shallowRef('')
+ const politeness = shallowRef<Politeness>(opts.politeness || 'polite')
+ const activeHead = injectHead()
+
+ function set (messageValue: string = '', politenessSetting: Politeness = 'polite') {
+ message.value = messageValue
+ politeness.value = politenessSetting
+ }
+
+ function polite (msg: string) {
+ set(msg, 'polite')
+ }
+
+ function assertive (msg: string) {
+ set(msg, 'assertive')
+ }
+
+ function _updateMessageWithPageHeading () {
+ set(document?.title?.trim(), politeness.value)
+ }
+
+ function _cleanup () {
+ activeHead?.hooks?.removeHook('dom:rendered', _updateMessageWithPageHeading)
+ }
+
+ _updateMessageWithPageHeading()
+
+ activeHead?.hooks?.hook('dom:rendered', _updateMessageWithPageHeading)
+
+ return {
+ _cleanup,
+ message,
+ politeness,
+ set,
+ polite,
+ assertive,
+ }
+}
+
+/**
+ * composable to handle the route announcer
+ * @since 3.12.0
+ */
+export function useRouteAnnouncer (opts: NuxtRouteAnnouncerOpts = {}): Omit<RouteAnnouncer, '_cleanup'> {
+ const nuxtApp = useNuxtApp()
+
+ // Initialise global route announcer if it doesn't exist already
+ const announcer = nuxtApp._routeAnnouncer ||= createRouteAnnouncer(opts)
+
+ // Update politeness if different from current
+ if (opts.politeness && opts.politeness !== announcer.politeness.value) {
+ announcer.politeness.value = opts.politeness
+ }
+ if (import.meta.client && getCurrentScope()) {
+ nuxtApp._routeAnnouncerDeps ||= 0
+ nuxtApp._routeAnnouncerDeps++
+ onScopeDispose(() => {
+ nuxtApp._routeAnnouncerDeps!--
+ if (nuxtApp._routeAnnouncerDeps === 0) {
+ announcer._cleanup()
+ delete nuxtApp._routeAnnouncer
+ }
+ })
+ }
+
+ return announcer
+}
diff --git a/packages/nuxt/src/app/composables/router.ts b/packages/nuxt/src/app/composables/router.ts
new file mode 100644
index 000000000000..2cad9672004e
--- /dev/null
+++ b/packages/nuxt/src/app/composables/router.ts
@@ -0,0 +1,356 @@
+import { getCurrentInstance, hasInjectionContext, inject, onScopeDispose } from 'vue'
+import type { Ref } from 'vue'
+import type { NavigationFailure, NavigationGuard, RouteLocationNormalized, RouteLocationRaw, Router, useRoute as _useRoute, useRouter as _useRouter } from 'vue-router'
+import { sanitizeStatusCode } from '@nuxt/nitro-server/h3'
+import { decodePath, encodePath, hasProtocol, isScriptProtocol, joinURL, parseQuery, parseURL, withQuery } from 'ufo'
+
+import type { NuxtLayouts, PageMeta } from '../../pages/runtime/composables'
+
+import { useNuxtApp, useRuntimeConfig } from '../nuxt'
+import { PageRouteSymbol } from '../components/injections'
+import type { NuxtError } from './error'
+import { createError, showError } from './error'
+import { getUserTrace } from '../utils'
+import type { MakeSerializableObject } from '../../pages/runtime/utils'
+
+/** @since 3.0.0 */
+export const useRouter: typeof _useRouter = () => {
+ return useNuxtApp()?.$router as Router
+}
+
+/** @since 3.0.0 */
+export const useRoute: typeof _useRoute = () => {
+ if (import.meta.dev && !getCurrentInstance() && isProcessingMiddleware()) {
+ const middleware = useNuxtApp()._processingMiddleware
+ const trace = getUserTrace().map(({ source, line, column }) => `at ${source}:${line}:${column}`).join('\n')
+ console.warn(`[nuxt] \`useRoute\` was called within middleware${typeof middleware === 'string' ? ` (\`${middleware}\`)` : ''}. This may lead to misleading results. Instead, use the (to, from) arguments passed to the middleware to access the new and old routes. Learn more: https://nuxt.com/docs/4.x/directory-structure/app/middleware#accessing-route-in-middleware` + ('\n' + trace))
+ }
+ if (hasInjectionContext()) {
+ return inject(PageRouteSymbol, useNuxtApp()._route)
+ }
+ return useNuxtApp()._route
+}
+
+/** @since 3.0.0 */
+export const onBeforeRouteLeave = (guard: NavigationGuard): void => {
+ const unsubscribe = useRouter().beforeEach((to, from, next) => {
+ if (to === from) { return }
+ return guard(to, from, next)
+ })
+ onScopeDispose(unsubscribe)
+}
+
+/** @since 3.0.0 */
+export const onBeforeRouteUpdate = (guard: NavigationGuard): void => {
+ const unsubscribe = useRouter().beforeEach(guard)
+ onScopeDispose(unsubscribe)
+}
+
+export interface RouteMiddleware {
+ (to: RouteLocationNormalized, from: RouteLocationNormalized): ReturnType<NavigationGuard>
+}
+
+/** @since 3.0.0 */
+/* @__NO_SIDE_EFFECTS__ */
+export function defineNuxtRouteMiddleware (middleware: RouteMiddleware): RouteMiddleware {
+ return middleware
+}
+
+export interface AddRouteMiddlewareOptions {
+ global?: boolean
+}
+
+interface AddRouteMiddleware {
+ (name: string, middleware: RouteMiddleware, options?: AddRouteMiddlewareOptions): void
+ (middleware: RouteMiddleware): void
+}
+
+/** @since 3.0.0 */
+export const addRouteMiddleware: AddRouteMiddleware = (name: string | RouteMiddleware, middleware?: RouteMiddleware, options: AddRouteMiddlewareOptions = {}) => {
+ const nuxtApp = useNuxtApp()
+ const global = options.global || typeof name !== 'string'
+ const mw = typeof name !== 'string' ? name : middleware
+ if (!mw) {
+ console.warn('[nuxt] No route middleware passed to `addRouteMiddleware`.', name)
+ return
+ }
+ if (global) {
+ nuxtApp._middleware.global.push(mw)
+ } else {
+ nuxtApp._middleware.named[name] = mw
+ }
+}
+
+/** @since 3.0.0 */
+const isProcessingMiddleware = () => {
+ try {
+ if (useNuxtApp()._processingMiddleware) {
+ return true
+ }
+ } catch {
+ return false
+ }
+ return false
+}
+
+// Conditional types, either one or other
+type Without<T, U> = { [P in Exclude<keyof T, keyof U>]?: never }
+type XOR<T, U> = (T | U) extends object ? (Without<T, U> & U) | (Without<U, T> & T) : T | U
+
+export type OpenWindowFeatures = {
+ popup?: boolean
+ noopener?: boolean
+ noreferrer?: boolean
+} & XOR<{ width?: number }, { innerWidth?: number }>
+ & XOR<{ height?: number }, { innerHeight?: number }>
+ & XOR<{ left?: number }, { screenX?: number }>
+ & XOR<{ top?: number }, { screenY?: number }>
+
+export type OpenOptions = {
+ target: '_blank' | '_parent' | '_self' | '_top' | (string & {})
+ windowFeatures?: OpenWindowFeatures
+}
+
+export interface NavigateToOptions {
+ /**
+ * Whether or not the given route should replace the current route in the navigation history, rather than push it.
+ */
+ replace?: boolean
+ /**
+ * The status code to emit with the navigation. Defaults to `302 Found` when used on server side redirects.
+ */
+ redirectCode?: number
+ /**
+ * Whether or not the given route is a website/resource from a different origin. By default, navigating to external resources without setting `external: true` would result in an error.
+ */
+ external?: boolean
+ open?: OpenOptions
+}
+
+const HTML_ATTR_UNSAFE_RE = /[&"'<>]/g
+const HTML_ATTR_ENCODE_MAP: Record<string, string> = {
+ '&': '%26',
+ '"': '%22',
+ '\'': '%27',
+ '<': '%3C',
+ '>': '%3E',
+}
+function encodeForHtmlAttr (value: string): string {
+ return value.replace(HTML_ATTR_UNSAFE_RE, c => HTML_ATTR_ENCODE_MAP[c]!)
+}
+
+/**
+ * A helper that aids in programmatic navigation within your Nuxt application.
+ *
+ * Can be called on the server and on the client, within pages, route middleware, plugins, and more.
+ * @param {RouteLocationRaw | undefined | null} [to] - The route to navigate to. Accepts a route object, string path, `undefined`, or `null`. Defaults to '/'.
+ * @param {NavigateToOptions} [options] - Optional customization for controlling the behavior of the navigation.
+ * @returns {Promise<void | NavigationFailure | false> | false | void | RouteLocationRaw} The navigation result, which varies depending on context and options.
+ * @see https://nuxt.com/docs/4.x/api/utils/navigate-to
+ * @since 3.0.0
+ */
+export const navigateTo = (to: RouteLocationRaw | undefined | null, options?: NavigateToOptions): Promise<void | NavigationFailure | false> | false | void | RouteLocationRaw => {
+ to ||= '/'
+
+ const toPath = typeof to === 'string' ? to : 'path' in to ? resolveRouteObject(to) : useRouter().resolve(to).href
+
+ // Early open handler
+ if (import.meta.client && options?.open) {
+ const { target = '_blank', windowFeatures = {} } = options.open
+
+ const features: string[] = []
+ for (const [feature, value] of Object.entries(windowFeatures)) {
+ if (value !== undefined) {
+ features.push(`${feature.toLowerCase()}=${value}`)
+ }
+ }
+
+ open(toPath, target, features.join(', '))
+ return Promise.resolve()
+ }
+
+ const isExternalHost = hasProtocol(toPath, { acceptRelative: true })
+ const isExternal = options?.external || isExternalHost
+ if (isExternal) {
+ if (!options?.external) {
+ throw new Error('Navigating to an external URL is not allowed by default. Use `navigateTo(url, { external: true })`.')
+ }
+ const { protocol } = new URL(toPath, import.meta.client ? window.location.href : 'http://localhost')
+ if (protocol && isScriptProtocol(protocol)) {
+ throw new Error(`Cannot navigate to a URL with '${protocol}' protocol.`)
+ }
+ }
+
+ const inMiddleware = isProcessingMiddleware()
+
+ // Early redirect on client-side
+ if (import.meta.client && !isExternal && inMiddleware) {
+ if (options?.replace) {
+ if (typeof to === 'string') {
+ const { pathname, search, hash } = parseURL(to)
+ return {
+ path: pathname,
+ ...(search && { query: parseQuery(search) }),
+ ...(hash && { hash }),
+ replace: true,
+ }
+ }
+ return { ...to, replace: true }
+ }
+ return to
+ }
+
+ const router = useRouter()
+
+ const nuxtApp = useNuxtApp()
+
+ if (import.meta.server) {
+ if (nuxtApp.ssrContext) {
+ const fullPath = typeof to === 'string' || isExternal ? toPath : router.resolve(to).fullPath || '/'
+ const location = isExternal ? toPath : joinURL(useRuntimeConfig().app.baseURL, fullPath)
+
+ const redirect = async function (response: any) {
+ // TODO: consider deprecating in favour of `app:rendered` and removing
+ await nuxtApp.callHook('app:redirected')
+ const encodedLoc = encodeForHtmlAttr(location)
+ const encodedHeader = encodeURL(location, isExternalHost)
+
+ nuxtApp.ssrContext!['~renderResponse'] = {
+ status: sanitizeStatusCode(options?.redirectCode || 302, 302),
+ body: `<!DOCTYPE html><html><head><meta http-equiv="refresh" content="0; url=${encodedLoc}"></head></html>`,
+ headers: { location: encodedHeader },
+ }
+ return response
+ }
+
+ // We wait to perform the redirect last in case any other middleware will intercept the redirect
+ // and redirect somewhere else instead.
+ if (!isExternal && inMiddleware) {
+ router.afterEach(final => final.fullPath === fullPath ? redirect(false) : undefined)
+ return to
+ }
+ return redirect(!inMiddleware ? undefined : /* abort route navigation */ false)
+ }
+ }
+
+ // Client-side redirection using vue-router
+ if (isExternal) {
+ // Run any cleanup steps for the current scope, like ending BroadcastChannel
+ nuxtApp._scope.stop()
+ if (options?.replace) {
+ location.replace(toPath)
+ } else {
+ location.href = toPath
+ }
+ // Within in a Nuxt route middleware handler
+ if (inMiddleware) {
+ // Abort navigation when app is hydrated
+ if (!nuxtApp.isHydrating) {
+ return false
+ }
+ // When app is hydrating (i.e. on page load), we don't want to abort navigation as
+ // it would lead to a 404 error / page that's blinking before location changes.
+ return new Promise(() => {})
+ }
+ return Promise.resolve()
+ }
+
+ // Encode the path portion of string locations to match vue-router's
+ // percent-encoded route records.
+ const encodedTo = typeof to === 'string' ? encodeRoutePath(to) : to
+ return options?.replace ? router.replace(encodedTo) : router.push(encodedTo)
+}
+
+/**
+ * This will abort navigation within a Nuxt route middleware handler.
+ * @since 3.0.0
+ */
+export const abortNavigation = (err?: string | Partial<NuxtError>) => {
+ if (import.meta.dev && !isProcessingMiddleware()) {
+ throw new Error('abortNavigation() is only usable inside a route middleware handler.')
+ }
+
+ if (!err) { return false }
+
+ err = createError(err)
+
+ if (err.fatal) {
+ useNuxtApp().runWithContext(() => showError(err as NuxtError))
+ }
+
+ throw err
+}
+
+/**
+ * Sets the layout for the current page.
+ * @since 3.0.0
+ */
+export const setPageLayout = <Layout extends keyof NuxtLayouts>(layout: unknown extends Layout ? string : Layout, props?: typeof layout extends Layout ? MakeSerializableObject<NuxtLayouts[Layout]> : never): void => {
+ const nuxtApp = useNuxtApp()
+ if (import.meta.server) {
+ if (import.meta.dev && getCurrentInstance() && nuxtApp.payload.state._layout !== layout) {
+ console.warn('[nuxt] `setPageLayout` should not be called to change the layout on the server within a component as this will cause hydration errors.')
+ }
+ nuxtApp.payload.state._layout = layout
+ nuxtApp.payload.state._layoutProps = props
+ }
+ if (import.meta.dev && nuxtApp.isHydrating && nuxtApp.payload.serverRendered && nuxtApp.payload.state._layout !== layout) {
+ console.warn('[nuxt] `setPageLayout` should not be called to change the layout during hydration as this will cause hydration errors.')
+ }
+ const inMiddleware = isProcessingMiddleware()
+ if (inMiddleware || import.meta.server || nuxtApp.isHydrating) {
+ const unsubscribe = useRouter().beforeResolve((to) => {
+ to.meta.layout = layout as Exclude<PageMeta['layout'], Ref | false>
+ to.meta.layoutProps = props
+ unsubscribe()
+ })
+ }
+ if (!inMiddleware) {
+ const route = useRoute()
+ route.meta.layout = layout as Exclude<PageMeta['layout'], Ref | false>
+ route.meta.layoutProps = props
+ if (import.meta.client) {
+ const unsubscribe = useRouter().beforeResolve((to, from) => {
+ if (to.path === from.path) {
+ to.meta.layout = layout as Exclude<PageMeta['layout'], Ref | false>
+ to.meta.layoutProps = props
+ } else {
+ unsubscribe()
+ }
+ })
+ onScopeDispose(unsubscribe, true)
+ }
+ }
+}
+
+/**
+ * @internal
+ */
+export function resolveRouteObject (to: Exclude<RouteLocationRaw, string>): string {
+ return withQuery(to.path || '', to.query || {}) + (to.hash || '')
+}
+
+/**
+ * @internal
+ */
+export function encodeURL (location: string, isExternalHost = false): string {
+ const url = new URL(location, 'http://localhost')
+ if (!isExternalHost) {
+ return url.pathname + url.search + url.hash
+ }
+ if (location.startsWith('//')) {
+ return url.toString().replace(url.protocol, '')
+ }
+ return url.toString()
+}
+
+/**
+ * Encode the pathname of a route location string. Ensures decoded paths like
+ * `/café` are percent-encoded to match vue-router's encoded route records.
+ * Already-encoded paths are not double-encoded.
+ * @internal
+ */
+export function encodeRoutePath (url: string): string {
+ const parsed = parseURL(url)
+ return encodePath(decodePath(parsed.pathname)) + parsed.search + parsed.hash
+}
diff --git a/packages/nuxt/src/app/composables/runtime-hook.ts b/packages/nuxt/src/app/composables/runtime-hook.ts
new file mode 100644
index 000000000000..a1249efeda11
--- /dev/null
+++ b/packages/nuxt/src/app/composables/runtime-hook.ts
@@ -0,0 +1,21 @@
+import { onScopeDispose } from 'vue'
+import type { HookCallback } from 'hookable'
+import { useNuxtApp } from '../nuxt'
+import type { RuntimeNuxtHooks } from '../nuxt'
+
+/**
+ * Registers a runtime hook in a Nuxt application and ensures it is properly disposed of when the scope is destroyed.
+ * @param name - The name of the hook to register.
+ * @param fn - The callback function to be executed when the hook is triggered.
+ * @since 3.14.0
+ */
+export function useRuntimeHook<THookName extends keyof RuntimeNuxtHooks> (
+ name: THookName,
+ fn: RuntimeNuxtHooks[THookName] extends HookCallback ? RuntimeNuxtHooks[THookName] : never,
+): void {
+ const nuxtApp = useNuxtApp()
+
+ const unregister = nuxtApp.hook(name, fn)
+
+ onScopeDispose(unregister)
+}
diff --git a/packages/nuxt/src/app/composables/script-stubs.ts b/packages/nuxt/src/app/composables/script-stubs.ts
new file mode 100644
index 000000000000..a46edb6c1977
--- /dev/null
+++ b/packages/nuxt/src/app/composables/script-stubs.ts
@@ -0,0 +1,198 @@
+import type { UseScriptInput } from '@unhead/vue/scripts'
+import { createError } from './error'
+
+function renderStubMessage (name: string): void {
+ const message = `\`${name}\` is provided by @nuxt/scripts. Check your console to install it or run 'npx nuxt module add @nuxt/scripts' to install it.`
+ if (import.meta.client) {
+ throw createError({
+ fatal: true,
+ status: 500,
+ statusText: message,
+ })
+ }
+}
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScript<T extends Record<string | symbol, any>> (input: UseScriptInput, options?: Record<string, unknown>): void {
+ renderStubMessage('useScript')
+}
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptTriggerElement (...args: unknown[]): void {
+ renderStubMessage('useScriptTriggerElement')
+}
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptTriggerConsent (...args: unknown[]): void {
+ renderStubMessage('useScriptTriggerConsent')
+}
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptEventPage (...args: unknown[]): void {
+ renderStubMessage('useScriptEventPage')
+}
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptGoogleAnalytics (...args: unknown[]): void {
+ renderStubMessage('useScriptGoogleAnalytics')
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptPlausibleAnalytics (...args: unknown[]): void {
+ renderStubMessage('useScriptPlausibleAnalytics')
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptCloudflareWebAnalytics (...args: unknown[]): void {
+ renderStubMessage('useScriptCloudflareWebAnalytics')
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptCrisp (...args: unknown[]): void {
+ renderStubMessage('useScriptCrisp')
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptFathomAnalytics (...args: unknown[]): void {
+ renderStubMessage('useScriptFathomAnalytics')
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptMatomoAnalytics (...args: unknown[]): void {
+ renderStubMessage('useScriptMatomoAnalytics')
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptGoogleTagManager (...args: unknown[]): void {
+ renderStubMessage('useScriptGoogleTagManager')
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptSegment (...args: unknown[]): void {
+ renderStubMessage('useScriptSegment')
+}
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptClarity (...args: unknown[]): void {
+ renderStubMessage('useScriptClarity')
+}
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptMetaPixel (...args: unknown[]): void {
+ renderStubMessage('useScriptMetaPixel')
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptXPixel (...args: unknown[]): void {
+ renderStubMessage('useScriptXPixel')
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptIntercom (...args: unknown[]): void {
+ renderStubMessage('useScriptIntercom')
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptHotjar (...args: unknown[]): void {
+ renderStubMessage('useScriptHotjar')
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptStripe (...args: unknown[]): void {
+ renderStubMessage('useScriptStripe')
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptLemonSqueezy (...args: unknown[]): void {
+ renderStubMessage('useScriptLemonSqueezy')
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptVimeoPlayer (...args: unknown[]): void {
+ renderStubMessage('useScriptVimeoPlayer')
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptYouTubeIframe (...args: unknown[]): void {
+ renderStubMessage('useScriptYouTubeIframe')
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptGoogleMaps (...args: unknown[]): void {
+ renderStubMessage('useScriptGoogleMaps')
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptNpm (...args: unknown[]): void {
+ renderStubMessage('useScriptNpm')
+}
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptGoogleAdsense (...args: unknown[]): void {
+ renderStubMessage('useScriptGoogleAdsense')
+}
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptYouTubePlayer (...args: unknown[]): void {
+ renderStubMessage('useScriptYouTubePlayer')
+}
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptUmamiAnalytics (...args: unknown[]): void {
+ renderStubMessage('useScriptUmamiAnalytics')
+}
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptSnapchatPixel (...args: unknown[]): void {
+ renderStubMessage('useScriptSnapchatPixel')
+}
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptRybbitAnalytics (...args: unknown[]): void {
+ renderStubMessage('useScriptRybbitAnalytics')
+}
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptDatabuddyAnalytics (...args: unknown[]): void {
+ renderStubMessage('useScriptDatabuddyAnalytics')
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptRedditPixel (...args: unknown[]): void {
+ renderStubMessage('useScriptRedditPixel')
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptPayPal (...args: unknown[]): void {
+ renderStubMessage('useScriptPayPal')
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptVercelAnalytics (...args: unknown[]): void {
+ renderStubMessage('useScriptVercelAnalytics')
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptPostHog (...args: unknown[]): void {
+ renderStubMessage('useScriptPostHog')
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptMixpanelAnalytics (...args: unknown[]): void {
+ renderStubMessage('useScriptMixpanelAnalytics')
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptBingUet (...args: unknown[]): void {
+ renderStubMessage('useScriptBingUet')
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptTikTokPixel (...args: unknown[]): void {
+ renderStubMessage('useScriptTikTokPixel')
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptGoogleRecaptcha (...args: unknown[]): void {
+ renderStubMessage('useScriptGoogleRecaptcha')
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptGoogleSignIn (...args: unknown[]): void {
+ renderStubMessage('useScriptGoogleSignIn')
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptGravatar (...args: unknown[]): void {
+ renderStubMessage('useScriptGravatar')
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptAhrefsAnalytics (...args: unknown[]): void {
+ renderStubMessage('useScriptAhrefsAnalytics')
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptLinkedInInsight (...args: unknown[]): void {
+ renderStubMessage('useScriptLinkedInInsight')
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptCalendly (...args: unknown[]): void {
+ renderStubMessage('useScriptCalendly')
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function useScriptUsercentrics (...args: unknown[]): void {
+ renderStubMessage('useScriptUsercentrics')
+}
diff --git a/packages/nuxt/src/app/composables/ssr.ts b/packages/nuxt/src/app/composables/ssr.ts
new file mode 100644
index 000000000000..a5cf06035af2
--- /dev/null
+++ b/packages/nuxt/src/app/composables/ssr.ts
@@ -0,0 +1,147 @@
+import type { H3Event } from '@nuxt/nitro-server/h3'
+import { computed, getCurrentInstance, ref } from 'vue'
+import type { $Fetch } from 'nitro/types'
+
+import type { NuxtApp } from '../nuxt'
+import { useNuxtApp } from '../nuxt'
+import { toArray } from '../utils'
+import { useHead } from './head'
+
+/** @since 3.0.0 */
+export function useRequestEvent (nuxtApp?: NuxtApp): H3Event | undefined {
+ if (import.meta.client) { return }
+ nuxtApp ||= useNuxtApp()
+ return nuxtApp.ssrContext?.event
+}
+
+/**
+ * @since 3.0.0
+ * @deprecated Use useRequestEvent().req.headers
+ */
+export function useRequestHeaders<K extends string = string> (include: K[]): { [key in Lowercase<K>]?: string }
+export function useRequestHeaders (): Readonly<Record<string, string>>
+export function useRequestHeaders (include?: any[]): Readonly<Record<string, string>> {
+ if (import.meta.client) { return {} }
+ const event = useRequestEvent()
+ const _headers = event ? Object.fromEntries(event.req.headers.entries()) : {}
+ if (!include || !event) { return _headers }
+ const headers = Object.create(null)
+ for (const _key of include) {
+ const key = _key.toLowerCase()
+ const header = _headers[key]
+ if (header) {
+ headers[key] = header
+ }
+ }
+ return headers
+}
+
+/** @since 3.9.0 */
+export function useRequestHeader (header: string): string | null | undefined {
+ if (import.meta.client) { return undefined }
+ const event = useRequestEvent()
+ return event ? event.req.headers.get(header) : undefined
+}
+
+/** @since 3.2.0 */
+export function useRequestFetch (): $Fetch {
+ return $fetch as $Fetch
+}
+
+/** @since 3.0.0 */
+export function setResponseStatus (event: H3Event, code?: number, message?: string): void
+/** @deprecated Pass `event` as first option. */
+export function setResponseStatus (code: number, message?: string): void
+export function setResponseStatus (arg1: H3Event | number | undefined, arg2?: number | string, arg3?: string): void {
+ if (import.meta.client) { return }
+ if (arg1 && typeof arg1 !== 'number') {
+ arg1.res.status = arg2 as number | undefined
+ arg1.res.statusText = arg3
+ return
+ }
+ const event = useRequestEvent()
+ if (event) {
+ event.res.status = arg1 as number
+ event.res.statusText = arg2 as string | undefined
+ }
+}
+
+/** @since 3.14.0 */
+export function useResponseHeader (header: string): import('vue').WritableComputedRef<string | null | undefined> | import('vue').Ref<string | null | undefined> {
+ if (import.meta.client) {
+ if (import.meta.dev) {
+ return computed({
+ get: () => undefined,
+ set: () => console.warn('[nuxt] Setting response headers is not supported in the browser.'),
+ })
+ }
+ return ref()
+ }
+
+ const event = useRequestEvent()!
+
+ return computed({
+ get () {
+ return event.res.headers.get(header)
+ },
+ set (newValue) {
+ if (!newValue) {
+ return event.res.headers.delete(header)
+ }
+
+ return event.res.headers.set(header, newValue)
+ },
+ })
+}
+
+/** @since 3.8.0 */
+export function prerenderRoutes (path: string | string[]): void {
+ if (!import.meta.server || !import.meta.prerender) { return }
+
+ const paths = toArray(path)
+ useRequestEvent()?.res.headers.append('x-nitro-prerender', paths.map(p => encodeURIComponent(p)).join(', '))
+}
+
+const PREHYDRATE_ATTR_KEY = 'data-prehydrate-id'
+
+/**
+ * `onPrehydrate` is a composable lifecycle hook that allows you to run a callback on the client immediately before
+ * Nuxt hydrates the page. This is an advanced feature.
+ *
+ * The callback will be stringified and inlined in the HTML so it should not have any external
+ * dependencies (such as auto-imports) or refer to variables defined outside the callback.
+ *
+ * The callback will run before Nuxt runtime initializes so it should not rely on the Nuxt or Vue context.
+ * @since 3.12.0
+ */
+export function onPrehydrate (callback: (el: HTMLElement) => void): void
+export function onPrehydrate (callback: string | ((el: HTMLElement) => void), key?: string): undefined | string {
+ if (import.meta.client) { return }
+
+ if (typeof callback !== 'string') {
+ throw new TypeError('[nuxt] To transform a callback into a string, `onPrehydrate` must be processed by the Nuxt build pipeline. If it is called in a third-party library, make sure to add the library to `build.transpile`.')
+ }
+
+ const vm = getCurrentInstance()
+ if (vm && key) {
+ vm.attrs[PREHYDRATE_ATTR_KEY] ||= ''
+ key = ':' + key + ':'
+ if (!(vm.attrs[PREHYDRATE_ATTR_KEY] as string).includes(key)) {
+ vm.attrs[PREHYDRATE_ATTR_KEY] += key
+ }
+ }
+ const code = vm && key
+ ? `document.querySelectorAll('[${PREHYDRATE_ATTR_KEY}*=${JSON.stringify(key)}]').forEach` + callback
+ : (callback + '()')
+
+ useHead({
+ script: [{
+ key: vm && key ? key : undefined,
+ tagPosition: 'bodyClose',
+ tagPriority: 'critical',
+ innerHTML: code,
+ }],
+ })
+
+ return vm && key ? vm.attrs[PREHYDRATE_ATTR_KEY] as string : undefined
+}
diff --git a/packages/nuxt/src/app/composables/state.ts b/packages/nuxt/src/app/composables/state.ts
new file mode 100644
index 000000000000..f39c85c2655d
--- /dev/null
+++ b/packages/nuxt/src/app/composables/state.ts
@@ -0,0 +1,90 @@
+import { isRef, toRef } from 'vue'
+import type { Ref } from 'vue'
+import { useNuxtApp } from '../nuxt'
+import { toArray } from '../utils'
+
+// @ts-expect-error virtual file
+import { useStateDefaults } from '#build/nuxt.config.mjs'
+
+const useStateKeyPrefix = '$s'
+
+/**
+ * Create a global reactive ref that will be hydrated but not shared across ssr requests
+ * @since 3.0.0
+ * @param key a unique key ensuring that data fetching can be properly de-duplicated across requests
+ * @param init a function that provides initial value for the state when it's not initiated
+ */
+export function useState<T> (key?: string, init?: (() => T | Ref<T>)): Ref<T>
+export function useState<T> (init?: (() => T | Ref<T>)): Ref<T>
+export function useState<T> (...args: any): Ref<T> {
+ const autoKey = typeof args[args.length - 1] === 'string' ? args.pop() : undefined
+ if (typeof args[0] !== 'string') { args.unshift(autoKey) }
+ const [_key, init] = args as [string, (() => T | Ref<T>)]
+ if (!_key || typeof _key !== 'string') {
+ throw new TypeError('[nuxt] [useState] key must be a string: ' + _key)
+ }
+ if (init !== undefined && typeof init !== 'function') {
+ throw new Error('[nuxt] [useState] init must be a function: ' + init)
+ }
+ const key = useStateKeyPrefix + _key
+
+ const nuxtApp = useNuxtApp()
+ const state = toRef(nuxtApp.payload.state, key)
+
+ // Register the init function for reset support
+ if (init) {
+ nuxtApp._state[key] ??= { _default: init }
+ }
+
+ if (state.value === undefined && init) {
+ const initialValue = init()
+ if (isRef(initialValue)) {
+ // vue will unwrap the ref for us
+ nuxtApp.payload.state[key] = initialValue
+ return initialValue as Ref<T>
+ }
+ state.value = initialValue
+ }
+ return state
+}
+
+export interface ClearNuxtStateOptions {
+ /**
+ * Reset the state to the initial value provided by the `init` function of `useState`
+ * instead of setting it to `undefined`.
+ *
+ * When not specified, this defaults to the value of `experimental.defaults.useState.resetOnClear`
+ * in your Nuxt config (which defaults to `true` with `compatibilityVersion: 5`).
+ */
+ reset?: boolean
+}
+
+/** @since 3.6.0 */
+export function clearNuxtState (
+ keys?: string | string[] | ((key: string) => boolean),
+ opts?: ClearNuxtStateOptions,
+): void {
+ const reset = opts?.reset ?? useStateDefaults.resetOnClear
+
+ const nuxtApp = useNuxtApp()
+ const _allKeys = Object.keys(nuxtApp.payload.state)
+ .filter(key => key.startsWith(useStateKeyPrefix))
+ .map(key => key.substring(useStateKeyPrefix.length))
+
+ const _keys: string[] = !keys
+ ? _allKeys
+ : typeof keys === 'function'
+ ? _allKeys.filter(keys)
+ : toArray(keys)
+
+ for (const _key of _keys) {
+ const key = useStateKeyPrefix + _key
+ if (key in nuxtApp.payload.state) {
+ if (reset && nuxtApp._state[key]) {
+ nuxtApp.payload.state[key] = nuxtApp._state[key]._default()
+ } else {
+ delete nuxtApp.payload.state[key]
+ }
+ }
+ }
+}
diff --git a/packages/nuxt/src/app/composables/url.ts b/packages/nuxt/src/app/composables/url.ts
new file mode 100644
index 000000000000..494e131be74c
--- /dev/null
+++ b/packages/nuxt/src/app/composables/url.ts
@@ -0,0 +1,11 @@
+import { getRequestURL } from '@nuxt/nitro-server/h3'
+import { useRequestEvent } from './ssr'
+
+/** @since 3.5.0 */
+export function useRequestURL (opts?: Parameters<typeof getRequestURL>[1]): URL {
+ if (import.meta.server) {
+ return getRequestURL(useRequestEvent()!, opts)
+ }
+ // we use globalThis to avoid crashes in web workers
+ return new URL(globalThis.location.href)
+}
diff --git a/packages/nuxt/src/app/config.ts b/packages/nuxt/src/app/config.ts
new file mode 100644
index 000000000000..0f4727e4e03c
--- /dev/null
+++ b/packages/nuxt/src/app/config.ts
@@ -0,0 +1,102 @@
+import { reactive } from 'vue'
+import { klona } from 'klona'
+import { useNuxtApp } from './nuxt'
+import type { AppConfig } from 'nuxt/schema'
+// @ts-expect-error virtual file
+import __appConfig from '#build/app.config.mjs'
+
+// eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+export type DeepPartial<T> = T extends Function ? T : T extends Record<string, any> ? { [P in keyof T]?: DeepPartial<T[P]> } : T
+
+// Workaround for vite HMR with virtual modules
+export const _getAppConfig = () => __appConfig as AppConfig
+
+function isPojoOrArray (val: unknown): val is object {
+ return (
+ Array.isArray(val) ||
+ (!!val &&
+ typeof val === 'object' &&
+ val.constructor?.name === 'Object')
+ )
+}
+
+function deepDelete (obj: any, newObj: any) {
+ if (Array.isArray(obj) && Array.isArray(newObj)) {
+ obj.length = 0
+ obj.push(...newObj)
+ return
+ }
+
+ for (const key in obj) {
+ const val = newObj[key]
+ if (!(key in newObj)) {
+ delete (obj as any)[key]
+ }
+
+ if (isPojoOrArray(val)) {
+ deepDelete(obj[key], newObj[key])
+ }
+ }
+}
+
+function deepAssign (obj: any, newObj: any) {
+ for (const key in newObj) {
+ if (key === '__proto__' || key === 'constructor') { continue }
+ const val = newObj[key]
+ if (isPojoOrArray(val)) {
+ const defaultVal = Array.isArray(val) ? [] : {}
+ if (Array.isArray(obj[key]) !== Array.isArray(val)) {
+ obj[key] = defaultVal
+ } else {
+ obj[key] ??= defaultVal
+ }
+
+ deepAssign(obj[key], val)
+ } else {
+ obj[key] = val
+ }
+ }
+}
+
+export function useAppConfig (): AppConfig {
+ const nuxtApp = useNuxtApp()
+ nuxtApp._appConfig ||= (import.meta.server ? klona(__appConfig) : reactive(__appConfig)) as AppConfig
+ return nuxtApp._appConfig
+}
+
+export function _replaceAppConfig (newConfig: AppConfig): void {
+ const appConfig = useAppConfig()
+
+ deepAssign(appConfig, newConfig)
+ deepDelete(appConfig, newConfig)
+}
+
+/**
+ * Deep assign the current appConfig with the new one.
+ *
+ * Will preserve existing properties.
+ */
+export function updateAppConfig (appConfig: DeepPartial<AppConfig>): void {
+ const _appConfig = useAppConfig()
+ deepAssign(_appConfig, appConfig)
+}
+
+// HMR Support
+if (import.meta.dev) {
+ // Vite
+ if (import.meta.hot) {
+ import.meta.hot.accept((newModule) => {
+ const newConfig = newModule?._getAppConfig()
+ if (newConfig) {
+ _replaceAppConfig(newConfig)
+ }
+ })
+ }
+
+ // webpack
+ if (import.meta.webpackHot) {
+ import.meta.webpackHot.accept('#build/app.config.mjs', () => {
+ _replaceAppConfig(__appConfig)
+ })
+ }
+}
diff --git a/packages/nuxt/src/app/entry-spa.ts b/packages/nuxt/src/app/entry-spa.ts
new file mode 100644
index 000000000000..01b5afdde6c7
--- /dev/null
+++ b/packages/nuxt/src/app/entry-spa.ts
@@ -0,0 +1 @@
+export default (): void => {}
diff --git a/packages/nuxt/src/app/entry.async.ts b/packages/nuxt/src/app/entry.async.ts
new file mode 100644
index 000000000000..7ee91256f413
--- /dev/null
+++ b/packages/nuxt/src/app/entry.async.ts
@@ -0,0 +1,11 @@
+import type { Entry } from './entry'
+
+const entry: Entry | (() => Promise<Entry>) = import.meta.server
+ ? ctx => import('#app/entry').then(m => m.default(ctx))
+ : () => import('#app/entry').then(m => m.default)
+
+if (import.meta.client) {
+ entry()
+}
+
+export default entry
diff --git a/packages/nuxt/src/app/entry.ts b/packages/nuxt/src/app/entry.ts
new file mode 100644
index 000000000000..9c7234f83b07
--- /dev/null
+++ b/packages/nuxt/src/app/entry.ts
@@ -0,0 +1,114 @@
+import { createApp, createSSRApp, nextTick } from 'vue'
+import type { App } from 'vue'
+
+// This file must be imported first as we set globalThis.$fetch via this import
+// @ts-expect-error virtual file
+import '#build/fetch'
+// @ts-expect-error virtual file
+import '#build/global-polyfills.mjs'
+
+import { applyPlugins, createNuxtApp } from './nuxt'
+import type { CreateOptions, NuxtSSRContext } from './nuxt'
+
+import { createError } from './composables/error'
+
+// @ts-expect-error virtual file
+import '#build/css'
+// @ts-expect-error virtual file
+import plugins from '#build/plugins'
+// @ts-expect-error virtual file
+import RootComponent from '#build/root-component.mjs'
+// @ts-expect-error virtual file
+import { appId, appSpaLoaderAttrs, multiApp, spaLoadingTemplateOutside, vueAppRootContainer } from '#build/nuxt.config.mjs'
+
+export type Entry = (ssrContext?: NuxtSSRContext) => Promise<App<Element>>
+
+let entry: Entry
+
+if (import.meta.server) {
+ entry = async function createNuxtAppServer (ssrContext: CreateOptions['ssrContext']) {
+ const vueApp = createApp(RootComponent)
+
+ const nuxt = createNuxtApp({ vueApp, ssrContext })
+
+ try {
+ await applyPlugins(nuxt, plugins)
+ await nuxt.hooks.callHook('app:created', vueApp)
+ } catch (error) {
+ await nuxt.hooks.callHook('app:error', error)
+ nuxt.payload.error ||= createError(error as any)
+ }
+ if (ssrContext?.['~renderResponse']) { throw new Error('skipping render') }
+
+ return vueApp
+ }
+}
+
+if (import.meta.client) {
+ // TODO: temporary webpack 5 HMR fix
+ // https://github.com/webpack/webpack-hot-middleware/issues/390
+ if (import.meta.dev && import.meta.webpackHot) {
+ import.meta.webpackHot.accept()
+ }
+
+ // eslint-disable-next-line prefer-const
+ let vueAppPromise: Promise<App<Element>>
+
+ entry = async function initApp () {
+ if (vueAppPromise) { return vueAppPromise }
+
+ const isSSR = Boolean(
+ (multiApp ? window.__NUXT__?.[appId] : window.__NUXT__)?.serverRendered ??
+ (multiApp ? document.querySelector(`[data-nuxt-data="${appId}"]`) as HTMLElement : document.getElementById('__NUXT_DATA__'))?.dataset.ssr === 'true',
+ )
+ const vueApp = isSSR ? createSSRApp(RootComponent) : createApp(RootComponent)
+
+ const nuxt = createNuxtApp({ vueApp })
+
+ async function handleVueError (error: any) {
+ await nuxt.callHook('app:error', error)
+ nuxt.payload.error ||= createError(error as any)
+ }
+ // marker so nuxt-root.vue can skip re-invoking the default handler from
+ // its onErrorCaptured (which already calls `app:error` via showError)
+ ;(handleVueError as any).__nuxt_default = true
+
+ vueApp.config.errorHandler = handleVueError
+ // If the errorHandler is not overridden by the user, we unset it after the app is hydrated
+ nuxt.hook('app:suspense:resolve', () => {
+ if (vueApp.config.errorHandler === handleVueError) { vueApp.config.errorHandler = undefined }
+ })
+
+ if (spaLoadingTemplateOutside && !isSSR && appSpaLoaderAttrs.id) {
+ // Remove spa loader if present
+ nuxt.hook('app:suspense:resolve', () => {
+ document.getElementById(appSpaLoaderAttrs.id)?.remove()
+ })
+ }
+
+ try {
+ await applyPlugins(nuxt, plugins)
+ } catch (err) {
+ handleVueError(err)
+ }
+
+ try {
+ await nuxt.hooks.callHook('app:created', vueApp)
+ await nuxt.hooks.callHook('app:beforeMount', vueApp)
+ vueApp.mount(vueAppRootContainer)
+ await nuxt.hooks.callHook('app:mounted', vueApp)
+ await nextTick()
+ } catch (err) {
+ handleVueError(err)
+ }
+
+ return vueApp
+ }
+
+ vueAppPromise = entry().catch((error: unknown) => {
+ console.error('Error while mounting app:', error)
+ throw error
+ })
+}
+
+export default (ssrContext => entry(ssrContext)) as Entry
diff --git a/packages/nuxt/src/app/index.ts b/packages/nuxt/src/app/index.ts
new file mode 100644
index 000000000000..01f9423ded77
--- /dev/null
+++ b/packages/nuxt/src/app/index.ts
@@ -0,0 +1,23 @@
+// Reference the dist copy so the source `src/app/types/augments.ts` isn't
+// also loaded at typecheck time. Both copies define identical `declare global`
+// blocks but resolve `NuxtApp` from different module paths (src vs dist), so
+// loading both triggers TS2717.
+import type { _NuxtAugmentsAnchor } from '../../dist/app/types/augments'
+// re-export so the side-effect import survives tree-shaking.
+export type { _NuxtAugmentsAnchor as _NuxtAugments }
+
+export { applyPlugin, applyPlugins, callWithNuxt, createNuxtApp, defineAppConfig, defineNuxtPlugin, definePayloadPlugin, isNuxtPlugin, registerPluginHooks, tryUseNuxtApp, useNuxtApp, useRuntimeConfig } from './nuxt'
+export type { CreateOptions, NuxtApp, NuxtPayload, NuxtPluginIndicator, NuxtSSRContext, ObjectPlugin, Plugin, PluginEnvContext, PluginMeta, ResolvedPluginMeta, RuntimeNuxtHooks } from './nuxt'
+
+// eslint-disable-next-line @typescript-eslint/no-deprecated
+export { defineNuxtComponent, useAsyncData, useLazyAsyncData, useNuxtData, refreshNuxtData, clearNuxtData, useHydration, callOnce, useState, clearNuxtState, clearError, createError, isNuxtError, showError, useError, useFetch, useLazyFetch, useCookie, refreshCookie, onPrehydrate, prerenderRoutes, useRequestHeaders, useRequestEvent, useRequestFetch, setResponseStatus, useResponseHeader, onNuxtReady, abortNavigation, addRouteMiddleware, defineNuxtRouteMiddleware, onBeforeRouteLeave, onBeforeRouteUpdate, setPageLayout, navigateTo, useRoute, useRouter, preloadComponents, prefetchComponents, preloadRouteComponents, isPrerendered, loadPayload, preloadPayload, definePayloadReducer, definePayloadReviver, getAppManifest, getRouteRules, reloadNuxtApp, useRequestURL, usePreviewMode, useId, useRouteAnnouncer, useAnnouncer, useHead, useHeadSafe, useServerSeoMeta, useServerHeadSafe, useServerHead, useSeoMeta, injectHead, useRuntimeHook } from './composables/index'
+export type { AddRouteMiddlewareOptions, AnnouncerPoliteness, AsyncData, AsyncDataOptions, AsyncDataRequestStatus, CookieOptions, CookieRef, FetchResult, NuxtAnnouncer, NuxtAnnouncerOpts, NuxtAppManifest, NuxtAppManifestMeta, NuxtError, Politeness, ReloadNuxtAppOptions, RouteMiddleware, UseFetchOptions } from './composables/index'
+
+export { defineNuxtLink } from './components/index'
+export type { NuxtLinkOptions, NuxtLinkProps, NuxtTimeProps } from './components/index'
+export { _getAppConfig, updateAppConfig, useAppConfig } from './config'
+export { cancelIdleCallback, requestIdleCallback } from './compat/idle-callback'
+export type { NuxtAppLiterals, NuxtIslandContext, NuxtIslandResponse, NuxtRenderHTMLContext, PageMeta, NuxtPageProps, NuxtLayouts } from './types'
+
+export const isVue2 = false
+export const isVue3 = true
diff --git a/packages/nuxt/src/app/island-hash.ts b/packages/nuxt/src/app/island-hash.ts
new file mode 100644
index 000000000000..6ec276836a1d
--- /dev/null
+++ b/packages/nuxt/src/app/island-hash.ts
@@ -0,0 +1,39 @@
+import { hash } from 'ohash'
+
+/**
+ * Strip Vue scoped-style attributes (`data-v-*`) from island props before hashing
+ * or rendering. Scoped-id markers leak in from parent components and are not part
+ * of the logical island input.
+ *
+ * Used by both `<NuxtIsland>` (client) and the `/__nuxt_island/*` handler (server)
+ * to derive the URL-resident `hashId`.
+ *
+ * @internal
+ */
+export function filterIslandProps (props: Record<string, any> | null | undefined): Record<string, any> {
+ if (!props) { return {} }
+ const out: Record<string, any> = {}
+ for (const key in props) {
+ if (!key.startsWith('data-v-')) {
+ out[key] = props[key]
+ }
+ }
+ return out
+}
+
+/**
+ * Compute the `hashId` segment embedded in an island URL (`/__nuxt_island/<Name>_<hashId>.json`).
+ *
+ * The hash binds the response to the requested `(name, props, context, source)` tuple,
+ * so the server can reject requests whose URL hash does not match the supplied query/body.
+ *
+ * @internal
+ */
+export function computeIslandHash (
+ name: string,
+ filteredProps: Record<string, any>,
+ context: Record<string, any>,
+ source: string | undefined,
+): string {
+ return hash([name, filteredProps, context, source]).replace(/[-_]/g, '')
+}
diff --git a/packages/nuxt/src/app/middleware/route-rules.ts b/packages/nuxt/src/app/middleware/route-rules.ts
new file mode 100644
index 000000000000..610d8454d2f4
--- /dev/null
+++ b/packages/nuxt/src/app/middleware/route-rules.ts
@@ -0,0 +1,19 @@
+import { hasProtocol } from 'ufo'
+import { defineNuxtRouteMiddleware } from '../composables/router'
+import type { RouteMiddleware } from '../composables/router'
+import { getRouteRules } from '../composables/manifest'
+
+const middleware: RouteMiddleware = defineNuxtRouteMiddleware((to) => {
+ if (import.meta.server || import.meta.test) { return }
+ const rules = getRouteRules({ path: to.path })
+ if (rules.redirect) {
+ const path = rules.redirect.includes('#') ? rules.redirect : (rules.redirect + to.hash)
+ if (hasProtocol(path, { acceptRelative: true })) {
+ window.location.href = path
+ return false
+ }
+ return path
+ }
+})
+
+export default middleware
diff --git a/packages/nuxt/src/app/nuxt.ts b/packages/nuxt/src/app/nuxt.ts
new file mode 100644
index 000000000000..7b2b6a7d4f55
--- /dev/null
+++ b/packages/nuxt/src/app/nuxt.ts
@@ -0,0 +1,635 @@
+import { effectScope, getCurrentInstance, getCurrentScope, hasInjectionContext, reactive, shallowReactive } from 'vue'
+import type { App, EffectScope, Ref, VNode, onErrorCaptured } from 'vue'
+import type { RouteLocationNormalizedLoaded } from 'vue-router'
+import type { HookCallback, Hookable } from 'hookable'
+import { createHooks } from 'hookable'
+import { getContext } from 'unctx'
+import type { UseContext } from 'unctx'
+import type { SSRContext, createRenderer } from 'vue-bundle-renderer/runtime'
+import type { EventHandlerRequest, H3Event } from '@nuxt/nitro-server/h3'
+import type { RenderResponse } from 'nitro/types'
+import type { LogObject } from 'consola'
+import type { VueHeadClient } from '@unhead/vue/types'
+
+import type { NuxtAppLiterals } from 'nuxt/app'
+
+import type { NuxtIslandContext } from './types'
+import type { RouteMiddleware } from './composables/router'
+import type { NuxtError } from './composables/error'
+import type { AsyncDataExecuteOptions, AsyncDataRequestStatus, DebouncedReturn } from './composables/asyncData'
+import type { NuxtAppManifestMeta } from './composables/manifest'
+import type { LoadingIndicator } from './composables/loading-indicator'
+import type { RouteAnnouncer } from './composables/route-announcer'
+import type { NuxtAnnouncer } from './composables/announcer'
+import type { AppConfig, AppConfigInput, RuntimeConfig } from 'nuxt/schema'
+
+// @ts-expect-error virtual file
+import { appId, asyncCallHook, chunkErrorEvent, multiApp } from '#build/nuxt.config.mjs'
+
+export function getNuxtAppCtx (id: string = appId || 'nuxt-app'): UseContext<NuxtApp> {
+ return getContext<NuxtApp>(id, {
+ asyncContext: !!__NUXT_ASYNC_CONTEXT__ && import.meta.server,
+ })
+}
+
+type HookResult = Promise<void> | void
+
+type AppRenderedContext = { ssrContext: NuxtApp['ssrContext'], renderResult: null | Awaited<ReturnType<ReturnType<typeof createRenderer>['renderToString']>> }
+export interface RuntimeNuxtHooks {
+ 'app:created': (app: App<Element>) => HookResult
+ 'app:beforeMount': (app: App<Element>) => HookResult
+ 'app:mounted': (app: App<Element>) => HookResult
+ 'app:rendered': (ctx: AppRenderedContext) => HookResult
+ 'app:redirected': () => HookResult
+ 'app:suspense:resolve': (Component?: VNode) => HookResult
+ 'app:error': (err: any) => HookResult
+ 'app:error:cleared': (options: { redirect?: string }) => HookResult
+ 'app:chunkError': (options: { error: any }) => HookResult
+ 'app:data:refresh': (keys?: string[]) => HookResult
+ 'app:manifest:update': (meta?: NuxtAppManifestMeta) => HookResult
+ 'dev:ssr-logs': (logs: LogObject[]) => HookResult
+ 'link:prefetch': (link: string) => HookResult
+ 'page:start': (Component?: VNode) => HookResult
+ 'page:finish': (Component?: VNode) => HookResult
+ 'page:transition:finish': (Component?: VNode) => HookResult
+ 'page:view-transition:start': (transition: ViewTransition) => HookResult
+ 'page:loading:start': () => HookResult
+ 'page:loading:end': () => HookResult
+ 'vue:setup': () => void
+ 'vue:error': (...args: Parameters<Parameters<typeof onErrorCaptured>[0]>) => HookResult
+}
+
+export interface NuxtSSRContext extends SSRContext {
+ url: string
+ event: H3Event
+ runtimeConfig: RuntimeConfig
+ noSSR: boolean
+ /** whether we are rendering an SSR error */
+ error?: boolean
+ nuxt: _NuxtApp
+ payload: Partial<NuxtPayload>
+ head: VueHeadClient
+ /** This is used solely to render runtime config with SPA renderer. */
+ config?: Pick<RuntimeConfig, 'public' | 'app'>
+ teleports?: Record<string, string>
+ islandContext?: NuxtIslandContext
+ /** @internal */
+ ['~renderResponse']?: Partial<RenderResponse>
+ /** @internal */
+ ['~payloadReducers']: Record<string, (data: any) => any>
+ /** @internal */
+ ['~sharedPrerenderCache']?: {
+ get<T = unknown> (key: string): Promise<T> | undefined
+ set<T> (key: string, value: Promise<T>): Promise<void>
+ }
+ /** @internal */
+ ['~preloadManifest']?: boolean
+ /** @internal */
+ ['~lazyHydratedModules']?: Set<string>
+}
+
+export interface NuxtPayload {
+ path?: string
+ serverRendered?: boolean
+ prerenderedAt?: number
+ data: Record<string, any>
+ state: Record<string, any>
+ once: Set<string>
+ config?: Pick<RuntimeConfig, 'public' | 'app'>
+ error?: NuxtError | undefined
+ _errors: Record<string, NuxtError | undefined>
+ /**
+ * Forwarded `<link rel="preload">` / `<link rel="modulepreload">` hints from the destination route, populated when `experimental.prefetchPreloadTags` is enabled.
+ * @internal
+ */
+ prefetchLinks?: Array<Record<string, string | boolean>>
+ [key: string]: unknown
+}
+
+interface _NuxtApp {
+ 'vueApp': App<Element>
+ 'versions': Record<string, string>
+
+ 'hooks': Hookable<RuntimeNuxtHooks>
+ 'hook': _NuxtApp['hooks']['hook']
+ 'callHook': _NuxtApp['hooks']['callHook']
+
+ 'runWithContext': <T extends () => any>(fn: T) => ReturnType<T> | Promise<Awaited<ReturnType<T>>>
+
+ [key: string]: unknown
+
+ /** @internal */
+ '_cookies'?: Record<string, unknown>
+ '_cookiesChanged'?: Record<string, boolean>
+ /**
+ * The id of the Nuxt application.
+ * @internal */
+ '_id': string
+ /** @internal */
+ '_scope': EffectScope
+ /** @internal */
+ '_asyncDataPromises': Record<string, Promise<any> | undefined>
+ /** @internal */
+ '_asyncData': Record<string, {
+ data: Ref<unknown>
+ pending: Ref<boolean>
+ error: Ref<Error | undefined>
+ status: Ref<AsyncDataRequestStatus>
+ execute: (opts?: AsyncDataExecuteOptions) => Promise<void>
+ /** @internal */
+ _default: () => unknown
+ /** @internal */
+ _deps: number
+ /** @internal */
+ _off: () => void
+ /** @internal */
+ _init: boolean
+ /** @internal */
+ _execute: DebouncedReturn<[opts?: AsyncDataExecuteOptions | undefined], void>
+ /** @internal */
+ _hash?: Record<string, string | undefined>
+ /** @internal */
+ _abortController?: AbortController
+ /** @internal */
+ _initialCachedData?: unknown
+ } | undefined>
+
+ /** @internal */
+ '_state': Record<string, {
+ /** @internal */
+ _default: () => unknown
+ } | undefined>
+
+ /** @internal */
+ '_loadingIndicator'?: LoadingIndicator
+ /** @internal */
+ '_loadingIndicatorDeps'?: number
+
+ /** @internal */
+ '_middleware': {
+ global: RouteMiddleware[]
+ named: Record<string, RouteMiddleware>
+ }
+
+ /** @internal */
+ '_processingMiddleware'?: string | boolean
+
+ /** @internal */
+ '_once': {
+ [key: string]: Promise<any>
+ }
+
+ /** @internal */
+ '_observer'?: { observe: (element: Element, callback: () => void) => () => void }
+
+ /** @internal */
+ '_appConfig': AppConfig
+ /** @internal */
+ '_route': RouteLocationNormalizedLoaded & {
+ sync?: () => void
+ }
+
+ /** @internal */
+ '_islandPromises'?: Record<string, Promise<any>>
+
+ /** @internal */
+ '_payloadRevivers': Record<string, (data: any) => any>
+
+ /** @internal */
+ '_routeAnnouncer'?: RouteAnnouncer
+ /** @internal */
+ '_routeAnnouncerDeps'?: number
+
+ /** @internal */
+ '~transitionPromise'?: Promise<void>
+ /** @internal */
+ '~transitionFinish'?: () => void
+
+ /** @internal */
+ '_announcer'?: NuxtAnnouncer
+ /** @internal */
+ '_announcerDeps'?: number
+
+ // Nuxt injections
+ '$config': RuntimeConfig
+
+ 'isHydrating'?: boolean
+ 'deferHydration': () => () => void | Promise<void>
+
+ 'ssrContext'?: NuxtSSRContext
+ 'payload': NuxtPayload
+ 'static': {
+ data: Record<string, any>
+ }
+
+ 'provide': (name: string, value: any) => void
+}
+
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type
+export interface NuxtApp extends _NuxtApp {}
+
+export const NuxtPluginIndicator = '__nuxt_plugin'
+
+export interface PluginMeta {
+ name?: string
+ enforce?: 'pre' | 'default' | 'post'
+ /**
+ * Await for other named plugins to finish before running this plugin.
+ */
+ dependsOn?: NuxtAppLiterals['pluginName'][]
+ /**
+ * This allows more granular control over plugin order and should only be used by advanced users.
+ * It overrides the value of `enforce` and is used to sort plugins.
+ */
+ order?: number
+}
+
+export interface PluginEnvContext {
+ /**
+ * This enable the plugin for islands components.
+ * Require `experimental.componentsIslands`.
+ * @default true
+ */
+ islands?: boolean
+}
+
+export interface ResolvedPluginMeta {
+ name?: string
+ parallel?: boolean
+}
+
+export interface Plugin<Injections extends Record<string, unknown> = Record<string, unknown>> {
+ (nuxt: _NuxtApp): Promise<void> | Promise<{ provide?: Injections }> | void | { provide?: Injections }
+ [NuxtPluginIndicator]?: true
+ meta?: ResolvedPluginMeta
+}
+
+export interface ObjectPlugin<Injections extends Record<string, unknown> = Record<string, unknown>> extends PluginMeta {
+ hooks?: Partial<RuntimeNuxtHooks>
+ setup?: Plugin<Injections>
+ env?: PluginEnvContext
+ /**
+ * Execute plugin in parallel with other parallel plugins.
+ * @default false
+ */
+ parallel?: boolean
+ /**
+ * @internal
+ */
+ _name?: string
+}
+
+/** @deprecated Use `ObjectPlugin` */
+export type ObjectPluginInput<Injections extends Record<string, unknown> = Record<string, unknown>> = ObjectPlugin<Injections>
+
+export interface CreateOptions {
+ vueApp: NuxtApp['vueApp']
+ ssrContext?: NuxtApp['ssrContext']
+ /**
+ * The id of the Nuxt application, overrides the default id specified in the Nuxt config (default: `nuxt-app`).
+ */
+ id?: NuxtApp['_id']
+}
+
+/** @since 3.0.0 */
+export function createNuxtApp (options: CreateOptions): NuxtApp {
+ let hydratingCount = 0
+ const nuxtApp: NuxtApp = {
+ _id: options.id || appId || 'nuxt-app',
+ _scope: effectScope(),
+ provide: undefined,
+ versions: {
+ get nuxt () { return __NUXT_VERSION__ },
+ get vue () { return nuxtApp.vueApp.version },
+ },
+ payload: shallowReactive({
+ ...options.ssrContext?.payload || {},
+ data: shallowReactive({}),
+ state: reactive({}),
+ once: new Set<string>(),
+ _errors: shallowReactive({}),
+ }),
+ static: {
+ data: {},
+ },
+ runWithContext <T>(fn: () => T) {
+ if (nuxtApp._scope.active && !getCurrentScope()) {
+ return nuxtApp._scope.run(() => callWithNuxt(nuxtApp, fn))
+ }
+ return callWithNuxt(nuxtApp, fn)
+ },
+ isHydrating: import.meta.client,
+ deferHydration () {
+ if (!nuxtApp.isHydrating) { return () => {} }
+
+ hydratingCount++
+ let called = false
+
+ return () => {
+ if (called) { return }
+
+ called = true
+ hydratingCount--
+
+ if (hydratingCount === 0) {
+ nuxtApp.isHydrating = false
+ return nuxtApp.callHook('app:suspense:resolve')
+ }
+ }
+ },
+ _asyncDataPromises: {},
+ _asyncData: shallowReactive({}),
+ _state: shallowReactive({}),
+ _payloadRevivers: {},
+ ...options,
+ } as any as NuxtApp
+
+ if (import.meta.server) {
+ nuxtApp.payload.serverRendered = true
+ }
+
+ if (import.meta.server && nuxtApp.ssrContext) {
+ nuxtApp.payload.path = nuxtApp.ssrContext.url
+
+ // Expose nuxt to the renderContext
+ nuxtApp.ssrContext.nuxt = nuxtApp
+ nuxtApp.ssrContext.payload = nuxtApp.payload
+
+ // Expose client runtime-config to the payload
+ nuxtApp.ssrContext.config = {
+ public: nuxtApp.ssrContext.runtimeConfig.public,
+ app: nuxtApp.ssrContext.runtimeConfig.app,
+ }
+ }
+
+ if (import.meta.client) {
+ const __NUXT__ = multiApp ? window.__NUXT__?.[nuxtApp._id] : window.__NUXT__
+ // TODO: remove/refactor in https://github.com/nuxt/nuxt/issues/25336
+ if (__NUXT__) {
+ for (const key in __NUXT__) {
+ switch (key) {
+ case 'data':
+ case 'state':
+ case '_errors':
+ // Preserve reactivity for non-rich payload support
+ Object.assign(nuxtApp.payload[key], __NUXT__[key])
+ break
+
+ default:
+ nuxtApp.payload[key] = __NUXT__[key]
+ }
+ }
+ }
+ }
+
+ nuxtApp.hooks = createHooks<RuntimeNuxtHooks>()
+ nuxtApp.hook = nuxtApp.hooks.hook
+
+ if (import.meta.server) {
+ const contextCaller = async function (hooks: HookCallback[], args: any[]) {
+ for (const hook of hooks) {
+ await nuxtApp.runWithContext(() => hook(...args))
+ }
+ }
+ // Patch callHook to preserve NuxtApp context on server
+ // TODO: Refactor after https://github.com/unjs/hookable/issues/74
+ nuxtApp.hooks.callHook = (name: any, ...args: any[]) => nuxtApp.hooks.callHookWith(contextCaller, name, args)
+ } else if (asyncCallHook) {
+ const _callHook = nuxtApp.hooks.callHook
+ nuxtApp.hooks.callHook = (name: any, ...args: any[]) => Promise.resolve().then(() => _callHook(name, ...args))
+ }
+
+ nuxtApp.callHook = nuxtApp.hooks.callHook
+
+ nuxtApp.provide = (name: string, value: any) => {
+ const $name = '$' + name
+ defineGetter(nuxtApp, $name, value)
+ defineGetter(nuxtApp.vueApp.config.globalProperties, $name, value)
+ }
+
+ // Inject $nuxt
+ defineGetter(nuxtApp.vueApp, '$nuxt', nuxtApp)
+ defineGetter(nuxtApp.vueApp.config.globalProperties, '$nuxt', nuxtApp)
+
+ if (import.meta.client) {
+ // Listen to chunk load errors
+ if (chunkErrorEvent) {
+ window.addEventListener(chunkErrorEvent, (event) => {
+ nuxtApp.callHook('app:chunkError', { error: (event as Event & { payload: Error }).payload })
+ if (event.payload?.message?.includes('Unable to preload CSS')) {
+ event.preventDefault()
+ }
+ })
+ }
+ window.useNuxtApp ||= useNuxtApp
+
+ // Log errors captured when running plugins, in the `app:created` and `app:beforeMount` hooks
+ // as well as when mounting the app.
+ const unreg = nuxtApp.hook('app:error', (...args) => { console.error('[nuxt] error caught during app initialization', ...args) })
+ nuxtApp.hook('app:mounted', unreg)
+ }
+
+ // Expose runtime config
+ const runtimeConfig = import.meta.server ? options.ssrContext!.runtimeConfig : nuxtApp.payload.config!
+ nuxtApp.provide('config', import.meta.client && import.meta.dev ? wrappedConfig(runtimeConfig) : runtimeConfig)
+
+ return nuxtApp
+}
+
+/** @since 3.12.0 */
+export function registerPluginHooks (nuxtApp: NuxtApp, plugin: Plugin & ObjectPlugin<any>): void {
+ if (plugin.hooks) {
+ nuxtApp.hooks.addHooks(plugin.hooks)
+ }
+}
+
+/** @since 3.0.0 */
+export async function applyPlugin (nuxtApp: NuxtApp, plugin: Plugin & ObjectPlugin<any>): Promise<void> {
+ if (typeof plugin === 'function') {
+ const { provide } = await nuxtApp.runWithContext(() => plugin(nuxtApp)) || {}
+ if (provide && typeof provide === 'object') {
+ for (const key in provide) {
+ nuxtApp.provide(key, provide[key])
+ }
+ }
+ }
+}
+
+/** @since 3.0.0 */
+export async function applyPlugins (nuxtApp: NuxtApp, plugins: Array<Plugin & ObjectPlugin<any>>): Promise<void> {
+ const resolvedPlugins: Set<string> = new Set()
+ const unresolvedPlugins: [Set<string>, Plugin & ObjectPlugin<any>][] = []
+ const parallels: Promise<any>[] = []
+ let error: Error | undefined = undefined
+ let promiseDepth = 0
+
+ async function executePlugin (plugin: Plugin & ObjectPlugin<any>) {
+ const unresolvedPluginsForThisPlugin = plugin.dependsOn?.filter(name => plugins.some(p => p._name === name) && !resolvedPlugins.has(name)) ?? []
+ if (unresolvedPluginsForThisPlugin.length > 0) {
+ unresolvedPlugins.push([new Set(unresolvedPluginsForThisPlugin), plugin])
+ } else {
+ const promise = applyPlugin(nuxtApp, plugin).then(async () => {
+ if (plugin._name) {
+ resolvedPlugins.add(plugin._name)
+ await Promise.all(unresolvedPlugins.map(async ([dependsOn, unexecutedPlugin]) => {
+ if (dependsOn.has(plugin._name!)) {
+ dependsOn.delete(plugin._name!)
+ if (dependsOn.size === 0) {
+ promiseDepth++
+ await executePlugin(unexecutedPlugin)
+ }
+ }
+ }))
+ }
+ }).catch((e) => {
+ // short circuit if we are not rendering `error.vue`
+ if (!plugin.parallel && !nuxtApp.payload.error) {
+ throw e
+ }
+ error ||= e
+ })
+
+ if (plugin.parallel) {
+ parallels.push(promise)
+ } else {
+ await promise
+ }
+ }
+ }
+
+ for (const plugin of plugins) {
+ if (import.meta.server && nuxtApp.ssrContext?.islandContext && plugin.env?.islands === false) { continue }
+ registerPluginHooks(nuxtApp, plugin)
+ }
+
+ for (const plugin of plugins) {
+ if (import.meta.server && nuxtApp.ssrContext?.islandContext && plugin.env?.islands === false) { continue }
+ await executePlugin(plugin)
+ }
+
+ await Promise.all(parallels)
+ if (promiseDepth) {
+ for (let i = 0; i < promiseDepth; i++) {
+ await Promise.all(parallels)
+ }
+ }
+
+ if (error) { throw nuxtApp.payload.error || error }
+}
+
+/** @since 3.0.0 */
+/* @__NO_SIDE_EFFECTS__ */
+export function defineNuxtPlugin<T extends Record<string, unknown>> (plugin: Plugin<T> | ObjectPlugin<T>): Plugin<T> & ObjectPlugin<T> {
+ if (typeof plugin === 'function') { return plugin }
+
+ const _name = plugin._name || plugin.name
+ delete plugin.name
+ return Object.assign(plugin.setup || (() => {}), plugin, { [NuxtPluginIndicator]: true, _name } as const)
+}
+
+/* @__NO_SIDE_EFFECTS__ */
+export const definePayloadPlugin: typeof defineNuxtPlugin = defineNuxtPlugin
+
+/** @since 3.0.0 */
+export function isNuxtPlugin (plugin: unknown): plugin is Plugin {
+ return typeof plugin === 'function' && NuxtPluginIndicator in plugin
+}
+
+/**
+ * Ensures that the setup function passed in has access to the Nuxt instance via `useNuxtApp`.
+ * @param nuxt A Nuxt instance
+ * @param setup The function to call
+ * @since 3.0.0
+ */
+export function callWithNuxt<T extends (...args: any[]) => any> (nuxt: NuxtApp | _NuxtApp, setup: T, args?: Parameters<T>): Promise<ReturnType<T>> {
+ const fn: () => ReturnType<T> = () => args ? setup(...args as Parameters<T>) : setup()
+ const nuxtAppCtx = getNuxtAppCtx(nuxt._id)
+ if (import.meta.server) {
+ return nuxt.vueApp.runWithContext(() => nuxtAppCtx.callAsync(nuxt as NuxtApp, fn))
+ } else {
+ // In client side we could assume nuxt app is singleton
+ nuxtAppCtx.set(nuxt as NuxtApp)
+ return nuxt.vueApp.runWithContext(fn)
+ }
+}
+
+/* @__NO_SIDE_EFFECTS__ */
+/**
+ * Returns the current Nuxt instance.
+ *
+ * Returns `null` if Nuxt instance is unavailable.
+ * @since 3.10.0
+ */
+export function tryUseNuxtApp (): NuxtApp | null
+export function tryUseNuxtApp (id?: string): NuxtApp | null {
+ let nuxtAppInstance
+ if (hasInjectionContext()) {
+ nuxtAppInstance = getCurrentInstance()?.appContext.app.$nuxt
+ }
+
+ nuxtAppInstance ||= getNuxtAppCtx(id).tryUse()
+
+ return nuxtAppInstance || null
+}
+
+/* @__NO_SIDE_EFFECTS__ */
+/**
+ * Returns the current Nuxt instance.
+ *
+ * Throws an error if Nuxt instance is unavailable.
+ * @since 3.0.0
+ */
+export function useNuxtApp (): NuxtApp
+export function useNuxtApp (id?: string): NuxtApp {
+ // @ts-expect-error internal usage of id
+ const nuxtAppInstance = tryUseNuxtApp(id)
+
+ if (!nuxtAppInstance) {
+ if (import.meta.dev) {
+ throw new Error('[nuxt] A composable that requires access to the Nuxt instance was called outside of a plugin, Nuxt hook, Nuxt middleware, or Vue setup function. This is probably not a Nuxt bug. Find out more at `https://nuxt.com/docs/4.x/guide/concepts/auto-imports#vue-and-nuxt-composables`.')
+ } else {
+ throw new Error('[nuxt] instance unavailable')
+ }
+ }
+
+ return nuxtAppInstance
+}
+
+/** @since 3.0.0 */
+/* @__NO_SIDE_EFFECTS__ */
+export function useRuntimeConfig (_event?: H3Event<EventHandlerRequest>): RuntimeConfig {
+ return useNuxtApp().$config
+}
+
+function defineGetter<K extends string | number | symbol, V> (obj: Record<K, V>, key: K, val: V) {
+ Object.defineProperty(obj, key, { get: () => val })
+}
+
+/** @since 3.0.0 */
+export function defineAppConfig<C extends AppConfigInput> (config: C): C {
+ return config
+}
+
+/**
+ * Configure error getter on runtime secret property access that doesn't exist on the client side
+ */
+const loggedKeys = new Set<string>()
+function wrappedConfig (runtimeConfig: Record<string, unknown>) {
+ if (!import.meta.dev || import.meta.server) { return runtimeConfig }
+ const keys: string[] = []
+ for (const key in runtimeConfig) {
+ keys.push(`\`${key}\``)
+ }
+ const lastKey = keys.pop()
+ return new Proxy(runtimeConfig, {
+ get (target, p, receiver) {
+ if (typeof p === 'string' && p !== 'public' && !(p in target) && !p.startsWith('__v') /* vue check for reactivity, e.g. `__v_isRef` */) {
+ if (!loggedKeys.has(p)) {
+ loggedKeys.add(p)
+ console.warn(`[nuxt] Could not access \`${p}\`. The only available runtime config keys on the client side are ${keys.join(', ')} and ${lastKey}. See https://nuxt.com/docs/4.x/guide/going-further/runtime-config for more information.`)
+ }
+ }
+ return Reflect.get(target, p, receiver)
+ },
+ })
+}
diff --git a/packages/nuxt/src/app/plugins/browser-devtools-timing.client.ts b/packages/nuxt/src/app/plugins/browser-devtools-timing.client.ts
new file mode 100644
index 000000000000..0430f6d87663
--- /dev/null
+++ b/packages/nuxt/src/app/plugins/browser-devtools-timing.client.ts
@@ -0,0 +1,45 @@
+import { defineNuxtPlugin } from '../nuxt'
+import type { ObjectPlugin, Plugin } from '../nuxt'
+
+const plugin: Plugin & ObjectPlugin = defineNuxtPlugin({
+ name: 'nuxt:browser-devtools-timing',
+ enforce: 'pre',
+ setup (nuxtApp) {
+ nuxtApp.hooks.beforeEach((event) => {
+ // @ts-expect-error __startTime is not a public API
+ event.__startTime = performance.now()
+ })
+
+ // After each
+ nuxtApp.hooks.afterEach((event) => {
+ performance.measure(event.name, {
+ // @ts-expect-error __startTime is not a public API
+ start: event.__startTime,
+ detail: {
+ devtools: {
+ dataType: 'track-entry',
+ track: 'nuxt',
+ color: 'tertiary-dark',
+ } satisfies ExtensionTrackEntryPayload,
+ },
+ })
+ })
+ },
+})
+
+type DevToolsColor =
+ 'primary' | 'primary-light' | 'primary-dark' |
+ 'secondary' | 'secondary-light' | 'secondary-dark' |
+ 'tertiary' | 'tertiary-light' | 'tertiary-dark' |
+ 'error'
+
+interface ExtensionTrackEntryPayload {
+ dataType?: 'track-entry' // Defaults to "track-entry"
+ color?: DevToolsColor // Defaults to "primary"
+ track: string // Required: Name of the custom track
+ trackGroup?: string // Optional: Group for organizing tracks
+ properties?: [string, string][] // Key-value pairs for detailed view
+ tooltipText?: string // Short description for tooltip
+}
+
+export default plugin
diff --git a/packages/nuxt/src/app/plugins/check-if-layout-used.ts b/packages/nuxt/src/app/plugins/check-if-layout-used.ts
new file mode 100644
index 000000000000..9b0944384f13
--- /dev/null
+++ b/packages/nuxt/src/app/plugins/check-if-layout-used.ts
@@ -0,0 +1,35 @@
+import { nextTick } from 'vue'
+import { defineNuxtPlugin } from '../nuxt'
+import type { ObjectPlugin, Plugin } from '../nuxt'
+import { onNuxtReady } from '../composables/ready'
+import { useError } from '../composables/error'
+
+// @ts-expect-error virtual file
+import layouts from '#build/layouts'
+
+const plugin: Plugin & ObjectPlugin = defineNuxtPlugin({
+ name: 'nuxt:checkIfLayoutUsed',
+ setup (nuxtApp) {
+ const error = useError()
+
+ function checkIfLayoutUsed () {
+ if (!error.value && !nuxtApp._isNuxtLayoutUsed && Object.keys(layouts).length > 0) {
+ console.warn('[nuxt] Your project has layouts but the `<NuxtLayout />` component has not been used.')
+ }
+ }
+ if (import.meta.server) {
+ nuxtApp.hook('app:rendered', ({ renderResult }) => {
+ if (renderResult?.html) {
+ nextTick(checkIfLayoutUsed)
+ }
+ })
+ } else {
+ onNuxtReady(checkIfLayoutUsed)
+ }
+ },
+ env: {
+ islands: false,
+ },
+})
+
+export default plugin
diff --git a/packages/nuxt/src/app/plugins/check-outdated-build.client.ts b/packages/nuxt/src/app/plugins/check-outdated-build.client.ts
new file mode 100644
index 000000000000..7e7528cb2f3e
--- /dev/null
+++ b/packages/nuxt/src/app/plugins/check-outdated-build.client.ts
@@ -0,0 +1,45 @@
+import type { FetchError } from 'ofetch'
+import { defineNuxtPlugin } from '../nuxt'
+import type { ObjectPlugin, Plugin } from '../nuxt'
+import { getAppManifest } from '../composables/manifest'
+import type { NuxtAppManifestMeta } from '../composables/manifest'
+import { onNuxtReady } from '../composables/ready'
+// @ts-expect-error virtual file
+import { buildAssetsURL } from '#internal/nuxt/paths'
+// @ts-expect-error virtual file
+import { outdatedBuildInterval } from '#build/nuxt.config.mjs'
+
+const plugin: Plugin & ObjectPlugin = defineNuxtPlugin((nuxtApp) => {
+ if (import.meta.test) { return }
+
+ let timeout: ReturnType<typeof setTimeout>
+
+ async function getLatestManifest () {
+ let currentManifest: NuxtAppManifestMeta | undefined
+ try {
+ currentManifest = await getAppManifest()
+ } catch (e) {
+ const err = e as FetchError | Error
+ // The build is already outdated but the manifest was not cached
+ if (!('status' in err && (err.status === 404 || err.status === 403))) {
+ throw err
+ }
+ }
+ if (timeout) { clearTimeout(timeout) }
+ timeout = setTimeout(getLatestManifest, outdatedBuildInterval)
+ try {
+ const meta = await $fetch<NuxtAppManifestMeta>(buildAssetsURL('builds/latest.json') + `?${Date.now()}`)
+ if (meta.id !== currentManifest?.id) {
+ // There is a newer build which we will let the user handle
+ nuxtApp.hooks.callHook('app:manifest:update', meta)
+ if (timeout) { clearTimeout(timeout) }
+ }
+ } catch {
+ // fail gracefully on network issue
+ }
+ }
+
+ onNuxtReady(() => { timeout = setTimeout(getLatestManifest, outdatedBuildInterval) })
+})
+
+export default plugin
diff --git a/packages/nuxt/src/app/plugins/chunk-reload-immediate.client.ts b/packages/nuxt/src/app/plugins/chunk-reload-immediate.client.ts
new file mode 100644
index 000000000000..4da6b298294c
--- /dev/null
+++ b/packages/nuxt/src/app/plugins/chunk-reload-immediate.client.ts
@@ -0,0 +1,35 @@
+import type { RouteLocationNormalized } from 'vue-router'
+import { joinURL } from 'ufo'
+import { defineNuxtPlugin, useRuntimeConfig } from '../nuxt'
+import type { ObjectPlugin, Plugin } from '../nuxt'
+import { reloadNuxtApp } from '../composables/chunk'
+import { addRouteMiddleware } from '../composables/router'
+
+// See https://github.com/nuxt/nuxt/issues/23612 for more context
+const plugin: Plugin & ObjectPlugin = defineNuxtPlugin({
+ name: 'nuxt:chunk-reload-immediate',
+ setup (nuxtApp) {
+ // Remember `to.path` when navigating to a new path: A `chunkError` may occur during navigation, we then want to then reload at `to.path`
+ let currentlyNavigationTo: RouteLocationNormalized | null = null
+
+ addRouteMiddleware((to) => {
+ currentlyNavigationTo = to
+ })
+
+ const config = useRuntimeConfig()
+
+ function reloadAppAtPath (to: RouteLocationNormalized) {
+ const path = joinURL(config.app.baseURL, to.fullPath)
+
+ reloadNuxtApp({ path, persistState: true })
+ }
+
+ // Reload when a `chunkError` is thrown
+ nuxtApp.hook('app:chunkError', () => reloadAppAtPath(currentlyNavigationTo ?? nuxtApp._route))
+
+ // Reload when the app manifest updates
+ nuxtApp.hook('app:manifest:update', () => reloadAppAtPath(nuxtApp._route))
+ },
+})
+
+export default plugin
diff --git a/packages/nuxt/src/app/plugins/chunk-reload.client.ts b/packages/nuxt/src/app/plugins/chunk-reload.client.ts
new file mode 100644
index 000000000000..7f65e39cf495
--- /dev/null
+++ b/packages/nuxt/src/app/plugins/chunk-reload.client.ts
@@ -0,0 +1,38 @@
+import { joinURL } from 'ufo'
+import type { RouteLocationNormalized } from 'vue-router'
+import { defineNuxtPlugin, useRuntimeConfig } from '../nuxt'
+import type { ObjectPlugin, Plugin } from '../nuxt'
+import { useRouter } from '../composables/router'
+import { reloadNuxtApp } from '../composables/chunk'
+
+const plugin: Plugin & ObjectPlugin = defineNuxtPlugin({
+ name: 'nuxt:chunk-reload',
+ setup (nuxtApp) {
+ const router = useRouter()
+ const config = useRuntimeConfig()
+
+ const chunkErrors = new Set<Error>()
+
+ router.beforeEach(() => { chunkErrors.clear() })
+
+ nuxtApp.hook('app:chunkError', ({ error }) => { chunkErrors.add(error) })
+
+ function reloadAppAtPath (to: RouteLocationNormalized) {
+ const path = joinURL(config.app.baseURL, to.fullPath)
+
+ reloadNuxtApp({ path, persistState: true })
+ }
+
+ nuxtApp.hook('app:manifest:update', () => {
+ router.beforeResolve(reloadAppAtPath)
+ })
+
+ router.onError((error, to) => {
+ if (chunkErrors.has(error)) {
+ reloadAppAtPath(to)
+ }
+ })
+ },
+})
+
+export default plugin
diff --git a/packages/nuxt/src/app/plugins/cross-origin-prefetch.client.ts b/packages/nuxt/src/app/plugins/cross-origin-prefetch.client.ts
new file mode 100644
index 000000000000..3c0497d5f926
--- /dev/null
+++ b/packages/nuxt/src/app/plugins/cross-origin-prefetch.client.ts
@@ -0,0 +1,44 @@
+import { ref } from 'vue'
+import { defineScript } from '@unhead/vue'
+import { defineNuxtPlugin } from '../nuxt'
+import type { ObjectPlugin, Plugin } from '../nuxt'
+import { useHead } from '../composables/head'
+
+const SUPPORTED_PROTOCOLS = new Set(['http:', 'https:'])
+
+const plugin: Plugin & ObjectPlugin = defineNuxtPlugin({
+ name: 'nuxt:cross-origin-prefetch',
+ setup (nuxtApp) {
+ const externalURLs = ref(new Set<string>())
+ function generateRules () {
+ return defineScript({
+ type: 'speculationrules',
+ key: 'speculationrules',
+ // unhead v3 JSON-stringifies object innerHTML for <script> tags
+ innerHTML: {
+ prefetch: [
+ {
+ source: 'list',
+ urls: [...externalURLs.value],
+ requires: ['anonymous-client-ip-when-cross-origin'],
+ },
+ ],
+ },
+ })
+ }
+ const head = useHead({
+ script: [generateRules()],
+ })
+ nuxtApp.hook('link:prefetch', (url) => {
+ for (const protocol of SUPPORTED_PROTOCOLS) {
+ if (url.startsWith(protocol) && SUPPORTED_PROTOCOLS.has(new URL(url).protocol)) {
+ externalURLs.value.add(url)
+ head?.patch({ script: [generateRules()] })
+ return
+ }
+ }
+ })
+ },
+})
+
+export default plugin
diff --git a/packages/nuxt/src/app/plugins/debug-hooks.ts b/packages/nuxt/src/app/plugins/debug-hooks.ts
new file mode 100644
index 000000000000..3de4955f2283
--- /dev/null
+++ b/packages/nuxt/src/app/plugins/debug-hooks.ts
@@ -0,0 +1,13 @@
+import { createDebugger } from 'hookable'
+import { defineNuxtPlugin } from '../nuxt'
+import type { ObjectPlugin, Plugin } from '../nuxt'
+
+const plugin: Plugin & ObjectPlugin = defineNuxtPlugin({
+ name: 'nuxt:debug:hooks',
+ enforce: 'pre',
+ setup (nuxtApp) {
+ createDebugger(nuxtApp.hooks, { tag: 'nuxt-app' })
+ },
+})
+
+export default plugin
diff --git a/packages/nuxt/src/app/plugins/dev-server-logs.ts b/packages/nuxt/src/app/plugins/dev-server-logs.ts
new file mode 100644
index 000000000000..284a3a4ef830
--- /dev/null
+++ b/packages/nuxt/src/app/plugins/dev-server-logs.ts
@@ -0,0 +1,75 @@
+import { createConsola } from 'consola'
+import type { LogObject } from 'consola'
+import { parse } from 'devalue'
+import type { ParsedTrace } from 'errx'
+
+import { h } from 'vue'
+import { defineNuxtPlugin } from '../nuxt'
+import type { ObjectPlugin, Plugin } from '../nuxt'
+
+// @ts-expect-error virtual file
+import { devLogs, devRootDir } from '#build/nuxt.config.mjs'
+
+const devRevivers: Record<string, (data: any) => any> = import.meta.server
+ ? {}
+ : {
+ VNode: data => h(data.type, data.props),
+ URL: data => new URL(data),
+ Symbol: data => Symbol.for(data),
+ }
+
+const plugin: Plugin & ObjectPlugin = defineNuxtPlugin(async (nuxtApp) => {
+ if (import.meta.test) { return }
+
+ if (import.meta.server) {
+ nuxtApp.ssrContext!.event.context['~payloadReducers'] = nuxtApp.ssrContext!['~payloadReducers']
+ return
+ }
+
+ // Show things in console
+ if (devLogs !== 'silent') {
+ const logger = createConsola({
+ formatOptions: {
+ colors: true,
+ date: true,
+ },
+ })
+ nuxtApp.hook('dev:ssr-logs', (logs) => {
+ for (const log of logs) {
+ logger.log(normalizeServerLog({ ...log }))
+ }
+ })
+ }
+
+ if (typeof window !== 'undefined') {
+ const nuxtLogsElement = document.querySelector(`[data-nuxt-logs="${nuxtApp._id}"]`)
+ const content = nuxtLogsElement?.textContent
+ const logs = content ? parse(content, { ...devRevivers, ...nuxtApp._payloadRevivers }) as LogObject[] : []
+ await nuxtApp.hooks.callHook('dev:ssr-logs', logs)
+ }
+})
+
+function normalizeFilenames (stack?: ParsedTrace[]) {
+ if (!stack) {
+ return ''
+ }
+ let message = ''
+ for (const item of stack) {
+ const source = item.source.replace(`${devRootDir}/`, '')
+ if (item.function) {
+ message += ` at ${item.function} (${source})\n`
+ } else {
+ message += ` at ${source}\n`
+ }
+ }
+ return message
+}
+
+function normalizeServerLog (log: LogObject) {
+ log.additional = normalizeFilenames(log.stack as ParsedTrace[])
+ log.tag = 'ssr'
+ delete log.stack
+ return log
+}
+
+export default plugin
diff --git a/packages/nuxt/src/app/plugins/navigation-repaint.client.ts b/packages/nuxt/src/app/plugins/navigation-repaint.client.ts
new file mode 100644
index 000000000000..544fef0d0aa5
--- /dev/null
+++ b/packages/nuxt/src/app/plugins/navigation-repaint.client.ts
@@ -0,0 +1,26 @@
+import { defineNuxtPlugin } from '../nuxt'
+import type { ObjectPlugin, Plugin } from '../nuxt'
+import { onNuxtReady } from '../composables/ready'
+import { useRouter } from '../composables/router'
+
+const plugin: Plugin & ObjectPlugin = defineNuxtPlugin(() => {
+ const router = useRouter()
+ onNuxtReady(() => {
+ router.beforeResolve(async () => {
+ /**
+ * This gives an opportunity for the browser to repaint, acknowledging user interaction.
+ * It can reduce INP when navigating on prerendered routes.
+ *
+ * @see https://github.com/nuxt/nuxt/issues/26271#issuecomment-2178582037
+ * @see https://vercel.com/blog/demystifying-inp-new-tools-and-actionable-insights
+ */
+ await new Promise((resolve) => {
+ // Ensure we always resolve, even if the animation frame never fires
+ setTimeout(resolve, 100)
+ requestAnimationFrame(() => { setTimeout(resolve, 0) })
+ })
+ })
+ })
+})
+
+export default plugin
diff --git a/packages/nuxt/src/app/plugins/payload.client.ts b/packages/nuxt/src/app/plugins/payload.client.ts
new file mode 100644
index 000000000000..c3eadc419fcb
--- /dev/null
+++ b/packages/nuxt/src/app/plugins/payload.client.ts
@@ -0,0 +1,74 @@
+import { defineNuxtPlugin } from '../nuxt'
+import type { ObjectPlugin, Plugin } from '../nuxt'
+import { loadPayload } from '../composables/payload'
+import { onNuxtReady } from '../composables/ready'
+import { useRouter } from '../composables/router'
+import { getAppManifest } from '../composables/manifest'
+import { injectHead } from '../composables/head'
+
+// @ts-expect-error virtual file
+import { appManifest as isAppManifestEnabled, prefetchPreloadTags, purgeCachedData } from '#build/nuxt.config.mjs'
+
+// track the active head entry per URL for forwarded preload hints
+interface ActiveHeadEntryLike { dispose: () => void }
+const forwardedPrefetchEntries = new Map<string, ActiveHeadEntryLike>()
+
+const plugin: Plugin & ObjectPlugin = defineNuxtPlugin({
+ name: 'nuxt:payload',
+ setup (nuxtApp) {
+ // Load payload after middleware & once final route is resolved
+ const staticKeysToRemove = new Set<string>()
+ useRouter().beforeResolve(async (to, from) => {
+ if (to.path === from.path) { return }
+ if (prefetchPreloadTags) {
+ // drop forwarded `rel="prefetch" hints so they don't linger indefinitely.
+ const entry = forwardedPrefetchEntries.get(to.path)
+ if (entry) {
+ entry.dispose()
+ forwardedPrefetchEntries.delete(to.path)
+ }
+ }
+ const payload = await loadPayload(to.path)
+ if (!payload) { return }
+ if (purgeCachedData) {
+ for (const key of staticKeysToRemove) {
+ delete nuxtApp.static.data[key]
+ }
+ }
+ for (const key in payload.data) {
+ if (purgeCachedData) {
+ if (!(key in nuxtApp.static.data)) {
+ staticKeysToRemove.add(key)
+ }
+ }
+ nuxtApp.static.data[key] = payload.data[key]
+ }
+ })
+
+ onNuxtReady(() => {
+ // Load payload into cache
+ const head = prefetchPreloadTags ? injectHead(nuxtApp) : null
+ nuxtApp.hooks.hook('link:prefetch', async (url) => {
+ const { hostname } = new URL(url, window.location.href)
+ if (hostname !== window.location.hostname) { return }
+ // TODO: use preloadPayload instead once we can support preloading islands too
+ const payload = await loadPayload(url).catch(() => { console.warn('[nuxt] Error preloading payload for', url) })
+ if (head && payload?.prefetchLinks?.length && !forwardedPrefetchEntries.has(url)) {
+ const entry = head.push({
+ link: payload.prefetchLinks.map((link: Record<string, string | boolean>) => {
+ // downgrade preload (and modulepreload) to prefetch
+ const { rel: _rel, ...rest } = link
+ return { ...rest, rel: 'prefetch' }
+ }),
+ })
+ forwardedPrefetchEntries.set(url, entry)
+ }
+ })
+ if (isAppManifestEnabled && navigator.connection?.effectiveType !== 'slow-2g') {
+ setTimeout(getAppManifest, 1000)
+ }
+ })
+ },
+})
+
+export default plugin
diff --git a/packages/nuxt/src/app/plugins/prefetch-preload-tags.server.ts b/packages/nuxt/src/app/plugins/prefetch-preload-tags.server.ts
new file mode 100644
index 000000000000..38e6c823cfa0
--- /dev/null
+++ b/packages/nuxt/src/app/plugins/prefetch-preload-tags.server.ts
@@ -0,0 +1,51 @@
+import { resolveTags } from 'unhead/utils'
+import { defineNuxtPlugin } from '../nuxt'
+
+// subset of the resolved unhead tag shape we forward to the client
+interface SerialisablePrefetchLink {
+ rel: string
+ href: string
+ [key: string]: string | boolean
+}
+
+const FORWARDED_RELS = new Set(['preload', 'modulepreload'])
+
+export default defineNuxtPlugin({
+ name: 'nuxt:prefetch-preload-tags',
+ hooks: {
+ 'app:rendered': ({ ssrContext }) => {
+ if (!ssrContext) { return }
+
+ // resolveTags walks the entries unhead has collected so far. We hook on
+ // `app:rendered`, which fires before the renderer pushes its own build-
+ // generated module preload / payload preload / script entries, so what we
+ // see here is the user-defined head only (appHead + useHead + nuxt/image
+ // <NuxtImg preload>, etc.).
+ const tags = resolveTags(ssrContext.head)
+
+ const links: SerialisablePrefetchLink[] = []
+ for (const tag of tags) {
+ if (tag.tag !== 'link') { continue }
+ const props = tag.props
+ if (!props) { continue }
+ const rel = props.rel
+ const href = props.href
+ if (typeof rel !== 'string' || typeof href !== 'string') { continue }
+ if (!FORWARDED_RELS.has(rel)) { continue }
+ const link: SerialisablePrefetchLink = { rel, href }
+ for (const key in props) {
+ if (key === 'rel' || key === 'href') { continue }
+ const value = props[key]
+ if (typeof value === 'string' || typeof value === 'boolean') {
+ link[key] = value
+ }
+ }
+ links.push(link)
+ }
+
+ if (links.length) {
+ ssrContext.payload.prefetchLinks = links
+ }
+ },
+ },
+})
diff --git a/packages/nuxt/src/app/plugins/preload.server.ts b/packages/nuxt/src/app/plugins/preload.server.ts
new file mode 100644
index 000000000000..142d52a3c3e2
--- /dev/null
+++ b/packages/nuxt/src/app/plugins/preload.server.ts
@@ -0,0 +1,19 @@
+import { defineNuxtPlugin } from '../nuxt'
+import type { ObjectPlugin, Plugin } from '../nuxt'
+
+const plugin: Plugin & ObjectPlugin = defineNuxtPlugin({
+ name: 'nuxt:webpack-preload',
+ setup (nuxtApp) {
+ nuxtApp.vueApp.mixin({
+ beforeCreate () {
+ const { modules } = this.$nuxt.ssrContext
+ const { __moduleIdentifier } = this.$options
+ if (__moduleIdentifier) {
+ modules.add(__moduleIdentifier)
+ }
+ },
+ })
+ },
+})
+
+export default plugin
diff --git a/packages/nuxt/src/app/plugins/restore-state.client.ts b/packages/nuxt/src/app/plugins/restore-state.client.ts
new file mode 100644
index 000000000000..0d37997523d6
--- /dev/null
+++ b/packages/nuxt/src/app/plugins/restore-state.client.ts
@@ -0,0 +1,22 @@
+import { defineNuxtPlugin, useNuxtApp } from '../nuxt'
+import type { ObjectPlugin, Plugin } from '../nuxt'
+
+const plugin: Plugin & ObjectPlugin = defineNuxtPlugin({
+ name: 'nuxt:restore-state',
+ hooks: {
+ 'app:mounted' () {
+ const nuxtApp = useNuxtApp()
+ try {
+ const state = sessionStorage.getItem('nuxt:reload:state')
+ if (state) {
+ sessionStorage.removeItem('nuxt:reload:state')
+ Object.assign(nuxtApp.payload.state, JSON.parse(state)?.state)
+ }
+ } catch {
+ // don't throw an error if we have issues reading sessionStorage
+ }
+ },
+ },
+})
+
+export default plugin
diff --git a/packages/nuxt/src/app/plugins/revive-payload.client.ts b/packages/nuxt/src/app/plugins/revive-payload.client.ts
new file mode 100644
index 000000000000..b718eee9ed8e
--- /dev/null
+++ b/packages/nuxt/src/app/plugins/revive-payload.client.ts
@@ -0,0 +1,59 @@
+import { reactive, ref, shallowReactive, shallowRef } from 'vue'
+import { definePayloadReviver, getNuxtClientPayload } from '../composables/payload'
+import { createError } from '../composables/error'
+import { defineNuxtPlugin, useNuxtApp } from '../nuxt'
+import type { ObjectPlugin, Plugin } from '../nuxt'
+
+// @ts-expect-error Virtual file.
+import { componentIslands } from '#build/nuxt.config.mjs'
+
+function parseRevivedData (data: string) {
+ try {
+ return JSON.parse(data)
+ } catch {
+ return data
+ }
+}
+
+const revivers: [string, (data: any) => any][] = [
+ ['NuxtError', data => createError(data)],
+ ['EmptyShallowRef', data => shallowRef(data === '_' ? undefined : data === '0n' ? BigInt(0) : parseRevivedData(data))],
+ ['EmptyRef', data => ref(data === '_' ? undefined : data === '0n' ? BigInt(0) : parseRevivedData(data))],
+ ['ShallowRef', data => shallowRef(data)],
+ ['ShallowReactive', data => shallowReactive(data)],
+ ['Ref', data => ref(data)],
+ ['Reactive', data => reactive(data)],
+]
+
+if (componentIslands) {
+ revivers.push(['Island', ({ key, params, result }: any) => {
+ const nuxtApp = useNuxtApp()
+ if (!nuxtApp.isHydrating) {
+ nuxtApp.payload.data[key] ||= $fetch(`/__nuxt_island/${key}.json`, {
+ responseType: 'json',
+ ...params ? { params } : {},
+ }).then((r) => {
+ nuxtApp.payload.data[key] = r
+ return r
+ })
+ }
+ return {
+ html: '',
+ ...result,
+ }
+ }])
+}
+
+const plugin: Plugin & ObjectPlugin = defineNuxtPlugin({
+ name: 'nuxt:revive-payload:client',
+ order: -30,
+ async setup (nuxtApp) {
+ for (const [reviver, fn] of revivers) {
+ definePayloadReviver(reviver, fn)
+ }
+ Object.assign(nuxtApp.payload, await nuxtApp.runWithContext(getNuxtClientPayload))
+ delete window.__NUXT__
+ },
+})
+
+export default plugin
diff --git a/packages/nuxt/src/app/plugins/revive-payload.server.ts b/packages/nuxt/src/app/plugins/revive-payload.server.ts
new file mode 100644
index 000000000000..57f8a52ccafb
--- /dev/null
+++ b/packages/nuxt/src/app/plugins/revive-payload.server.ts
@@ -0,0 +1,34 @@
+import { isReactive, isRef, isShallow, toRaw } from 'vue'
+import { definePayloadReducer } from '../composables/payload'
+import { isNuxtError } from '../composables/error'
+import { defineNuxtPlugin } from '../nuxt'
+import type { ObjectPlugin, Plugin } from '../nuxt'
+
+// @ts-expect-error Virtual file.
+import { componentIslands } from '#build/nuxt.config.mjs'
+import { isValidIslandKey } from './utils'
+
+const reducers: [string, (data: any) => any][] = [
+ ['NuxtError', data => isNuxtError(data) && data.toJSON()],
+ ['EmptyShallowRef', data => isRef(data) && isShallow(data) && !data.value && (typeof data.value === 'bigint' ? '0n' : (JSON.stringify(data.value) || '_'))],
+ ['EmptyRef', data => isRef(data) && !data.value && (typeof data.value === 'bigint' ? '0n' : (JSON.stringify(data.value) || '_'))],
+ ['ShallowRef', data => isRef(data) && isShallow(data) && data.value],
+ ['ShallowReactive', data => isReactive(data) && isShallow(data) && toRaw(data)],
+ ['Ref', data => isRef(data) && data.value],
+ ['Reactive', data => isReactive(data) && toRaw(data)],
+]
+
+if (componentIslands) {
+ reducers.push(['Island', data => data && data?.__nuxt_island && isValidIslandKey(data.__nuxt_island.key) && data.__nuxt_island])
+}
+
+const plugin: Plugin & ObjectPlugin = defineNuxtPlugin({
+ name: 'nuxt:revive-payload:server',
+ setup () {
+ for (const [reducer, fn] of reducers) {
+ definePayloadReducer(reducer, fn)
+ }
+ },
+})
+
+export default plugin
diff --git a/packages/nuxt/src/app/plugins/router.ts b/packages/nuxt/src/app/plugins/router.ts
new file mode 100644
index 000000000000..11e4df22ac8b
--- /dev/null
+++ b/packages/nuxt/src/app/plugins/router.ts
@@ -0,0 +1,308 @@
+import type { Ref } from 'vue'
+import { computed, defineComponent, h, isReadonly, reactive } from 'vue'
+import { isEqual, joinURL, parseQuery, stringifyParsedURL, stringifyQuery, withoutBase } from 'ufo'
+import { HTTPError } from '@nuxt/nitro-server/h3'
+import { defineNuxtPlugin, useRuntimeConfig } from '../nuxt'
+import type { ObjectPlugin, Plugin } from '../nuxt'
+import { getRouteRules } from '../composables/manifest'
+import { clearError, showError } from '../composables/error'
+import { navigateTo } from '../composables/router'
+
+// @ts-expect-error virtual file
+import { globalMiddleware } from '#build/middleware'
+
+interface Route {
+ /** Percentage encoded pathname section of the URL. */
+ path: string
+ /** The whole location including the `search` and `hash`. */
+ fullPath: string
+ /** Object representation of the `search` property of the current location. */
+ query: Record<string, any>
+ /** Hash of the current location. If present, starts with a `#`. */
+ hash: string
+ /** Name of the matched record */
+ name: string | null | undefined
+ /** Object of decoded params extracted from the `path`. */
+ params: Record<string, any>
+ /**
+ * The location we were initially trying to access before ending up
+ * on the current location.
+ */
+ redirectedFrom: Route | undefined
+ /** Merged `meta` properties from all of the matched route records. */
+ meta: Record<string, any>
+ /** compatibility type for vue-router */
+ matched: never[]
+}
+
+function getRouteFromPath (fullPath: string | Partial<Route>) {
+ const route = fullPath && typeof fullPath === 'object' ? fullPath : {}
+
+ if (typeof fullPath === 'object') {
+ fullPath = stringifyParsedURL({
+ pathname: fullPath.path || '',
+ search: stringifyQuery(fullPath.query || {}),
+ hash: fullPath.hash || '',
+ })
+ }
+
+ const url = new URL(fullPath.toString(), import.meta.client ? window.location.href : 'http://localhost')
+ return {
+ path: url.pathname,
+ fullPath,
+ query: parseQuery(url.search),
+ hash: url.hash,
+ // stub properties for compat with vue-router
+ params: route.params || {},
+ name: undefined,
+ matched: route.matched || [],
+ redirectedFrom: undefined,
+ meta: route.meta || {},
+ href: fullPath,
+ }
+}
+
+type RouteGuardReturn = void | Error | string | boolean
+
+interface RouteGuard {
+ (to: Route, from: Route): RouteGuardReturn | Promise<RouteGuardReturn>
+}
+
+interface RouterHooks {
+ 'resolve:before': (to: Route, from: Route) => RouteGuardReturn | Promise<RouteGuardReturn>
+ 'navigate:before': (to: Route, from: Route) => RouteGuardReturn | Promise<RouteGuardReturn>
+ 'navigate:after': (to: Route, from: Route) => void | Promise<void>
+ 'error': (err: any) => void | Promise<void>
+}
+
+interface Router {
+ currentRoute: Ref<Route>
+ isReady: () => Promise<void>
+ options: Record<string, unknown>
+ install: () => Promise<void>
+ // Navigation
+ push: (url: string) => Promise<void>
+ replace: (url: string) => Promise<void>
+ back: () => void
+ go: (delta: number) => void
+ forward: () => void
+ // Guards
+ beforeResolve: (guard: RouterHooks['resolve:before']) => () => void
+ beforeEach: (guard: RouterHooks['navigate:before']) => () => void
+ afterEach: (guard: RouterHooks['navigate:after']) => () => void
+ onError: (handler: RouterHooks['error']) => () => void
+ // Routes
+ resolve: (url: string | Partial<Route>) => Route
+ addRoute: (parentName: string, route: Route) => void
+ getRoutes: () => any[]
+ hasRoute: (name: string) => boolean
+ removeRoute: (name: string) => void
+}
+
+const plugin: Plugin<{ route: Route, router: Router }> & ObjectPlugin<{ route: Route, router: Router }> = defineNuxtPlugin<{ route: Route, router: Router }>({
+ name: 'nuxt:router',
+ enforce: 'pre',
+ setup (nuxtApp) {
+ const initialURL = import.meta.client
+ ? withoutBase(window.location.pathname, useRuntimeConfig().app.baseURL) + window.location.search + window.location.hash
+ : nuxtApp.ssrContext!.url
+
+ const routes: Route[] = []
+
+ const hooks: { [key in keyof RouterHooks]: RouterHooks[key][] } = {
+ 'navigate:before': [],
+ 'resolve:before': [],
+ 'navigate:after': [],
+ 'error': [],
+ }
+
+ const registerHook = <T extends keyof RouterHooks> (hook: T, guard: RouterHooks[T]) => {
+ hooks[hook].push(guard)
+ return () => hooks[hook].splice(hooks[hook].indexOf(guard), 1)
+ }
+ const baseURL = useRuntimeConfig().app.baseURL
+
+ const route: Route = reactive(getRouteFromPath(initialURL))
+ async function handleNavigation (url: string | Partial<Route>, replace?: boolean): Promise<void> {
+ try {
+ // Resolve route
+ const to = getRouteFromPath(url)
+
+ // Run beforeEach hooks
+ for (const middleware of hooks['navigate:before']) {
+ const result = await middleware(to, route)
+ // Cancel navigation
+ if (result === false || result instanceof Error) { return }
+ // Redirect
+ if (typeof result === 'string' && result.length) { return await handleNavigation(result, true) }
+ }
+
+ for (const handler of hooks['resolve:before']) {
+ await handler(to, route)
+ }
+ // Perform navigation
+ Object.assign(route, to)
+ if (import.meta.client) {
+ window.history[replace ? 'replaceState' : 'pushState']({}, '', joinURL(baseURL, to.fullPath))
+ if (!nuxtApp.isHydrating) {
+ // Clear any existing errors
+ await nuxtApp.runWithContext(clearError)
+ }
+ }
+ // Run afterEach hooks
+ for (const middleware of hooks['navigate:after']) {
+ await middleware(to, route)
+ }
+ } catch (err) {
+ if (import.meta.dev && !hooks.error.length) {
+ console.warn('No error handlers registered to handle middleware errors. You can register an error handler with `router.onError()`', err)
+ }
+ for (const handler of hooks.error) {
+ await handler(err)
+ }
+ }
+ }
+
+ const currentRoute = computed(() => route)
+
+ const router: Router = {
+ currentRoute,
+ isReady: () => Promise.resolve(),
+ // These options provide a similar API to vue-router but have no effect
+ options: {},
+ install: () => Promise.resolve(),
+ // Navigation
+ push: (url: string) => handleNavigation(url, false),
+ replace: (url: string) => handleNavigation(url, true),
+ back: () => window.history.go(-1),
+ go: (delta: number) => window.history.go(delta),
+ forward: () => window.history.go(1),
+ // Guards
+ beforeResolve: (guard: RouterHooks['resolve:before']) => registerHook('resolve:before', guard),
+ beforeEach: (guard: RouterHooks['navigate:before']) => registerHook('navigate:before', guard),
+ afterEach: (guard: RouterHooks['navigate:after']) => registerHook('navigate:after', guard),
+ onError: (handler: RouterHooks['error']) => registerHook('error', handler),
+ // Routes
+ resolve: getRouteFromPath,
+ addRoute: (parentName: string, route: Route) => { routes.push(route) },
+ getRoutes: () => routes,
+ hasRoute: (name: string) => routes.some(route => route.name === name),
+ removeRoute: (name: string) => {
+ const index = routes.findIndex(route => route.name === name)
+ if (index !== -1) {
+ routes.splice(index, 1)
+ }
+ },
+ }
+
+ nuxtApp.vueApp.component('RouterLink', defineComponent({
+ functional: true,
+ props: {
+ to: {
+ type: String,
+ required: true,
+ },
+ custom: Boolean,
+ replace: Boolean,
+ // Not implemented
+ activeClass: String,
+ exactActiveClass: String,
+ ariaCurrentValue: String,
+ },
+ setup: (props, { slots }) => {
+ const navigate = () => handleNavigation(props.to!, props.replace)
+ return () => {
+ const route = router.resolve(props.to!)
+ return props.custom
+ ? slots.default?.({ href: props.to, navigate, route })
+ : h('a', { href: props.to, onClick: (e: MouseEvent) => { e.preventDefault(); return navigate() } }, slots)
+ }
+ },
+ }))
+
+ if (import.meta.client) {
+ window.addEventListener('popstate', (event) => {
+ const location = (event.target as Window).location
+ router.replace(location.href.replace(location.origin, ''))
+ })
+ }
+
+ // @ts-expect-error vue-router types diverge from our Route type above
+ nuxtApp._route = route
+
+ // Handle middleware
+ nuxtApp._middleware ||= {
+ global: [],
+ named: {},
+ }
+
+ const initialLayout = nuxtApp.payload.state._layout
+ const initialLayoutProps = nuxtApp.payload.state._layoutProps
+ nuxtApp.hooks.hookOnce('app:created', async () => {
+ router.beforeEach(async (to, from) => {
+ to.meta = reactive(to.meta || {})
+ if (nuxtApp.isHydrating && initialLayout && !isReadonly(to.meta.layout)) {
+ to.meta.layout = initialLayout
+ to.meta.layoutProps = initialLayoutProps
+ }
+ nuxtApp._processingMiddleware = true
+
+ if (import.meta.client || !nuxtApp.ssrContext?.islandContext) {
+ const middlewareEntries = new Set<RouteGuard>([...globalMiddleware, ...nuxtApp._middleware.global])
+
+ const routeRules = getRouteRules({ path: to.path })
+ if (routeRules.appMiddleware) {
+ for (const key in routeRules.appMiddleware) {
+ const guard = nuxtApp._middleware.named[key] as RouteGuard | undefined
+ if (!guard) { continue }
+
+ if (routeRules.appMiddleware[key]) {
+ middlewareEntries.add(guard)
+ } else {
+ middlewareEntries.delete(guard)
+ }
+ }
+ }
+
+ for (const middleware of middlewareEntries) {
+ if (import.meta.dev) {
+ nuxtApp._processingMiddleware = (middleware as any)._path || true
+ }
+ const result = await nuxtApp.runWithContext(() => middleware(to, from))
+ if (import.meta.server) {
+ if (result === false || result instanceof Error) {
+ const error = result || new HTTPError({
+ status: 404,
+ statusText: `Page Not Found: ${initialURL}`,
+ data: {
+ path: initialURL,
+ },
+ })
+ delete nuxtApp._processingMiddleware
+ return nuxtApp.runWithContext(() => showError(error))
+ }
+ }
+ if (result === true) { continue }
+ if (result || result === false) { return result }
+ }
+ }
+ })
+
+ router.afterEach(() => { delete nuxtApp._processingMiddleware })
+
+ await router.replace(initialURL)
+ if (!isEqual(route.fullPath, initialURL)) {
+ await nuxtApp.runWithContext(() => navigateTo(route.fullPath))
+ }
+ })
+
+ return {
+ provide: {
+ route,
+ router,
+ },
+ }
+ },
+})
+
+export default plugin
diff --git a/packages/nuxt/src/app/plugins/utils.ts b/packages/nuxt/src/app/plugins/utils.ts
new file mode 100644
index 000000000000..d7be1f1dbc9e
--- /dev/null
+++ b/packages/nuxt/src/app/plugins/utils.ts
@@ -0,0 +1,5 @@
+const VALID_ISLAND_KEY_RE = /^[a-z][a-z\d-]*_[a-z\d]+$/i
+/* @__PURE__ */
+export function isValidIslandKey (key: string): boolean {
+ return typeof key === 'string' && VALID_ISLAND_KEY_RE.test(key) && key.length <= 100
+}
diff --git a/packages/nuxt/src/app/plugins/view-transitions.client.ts b/packages/nuxt/src/app/plugins/view-transitions.client.ts
new file mode 100644
index 000000000000..ca76c94bf520
--- /dev/null
+++ b/packages/nuxt/src/app/plugins/view-transitions.client.ts
@@ -0,0 +1,125 @@
+import { isChangingPage } from '../components/utils'
+import { useRouter } from '../composables/router'
+import { defineNuxtPlugin } from '../nuxt'
+import type { ObjectPlugin, Plugin } from '../nuxt'
+import type { ViewTransitionPageOptions } from 'nuxt/schema'
+// @ts-expect-error virtual file
+import { appViewTransition as defaultViewTransition } from '#build/nuxt.config.mjs'
+
+const plugin: Plugin & ObjectPlugin = defineNuxtPlugin((nuxtApp) => {
+ if (!document.startViewTransition) {
+ return
+ }
+
+ let transition: undefined | ViewTransition
+ let hasUAVisualTransition = false
+ let finishTransition: undefined | (() => void)
+ let abortTransition: undefined | (() => void)
+
+ const resetTransitionState = () => {
+ transition = undefined
+ hasUAVisualTransition = false
+ abortTransition = undefined
+ finishTransition = undefined
+ }
+
+ window.addEventListener('popstate', (event) => {
+ hasUAVisualTransition = event.hasUAVisualTransition
+ if (hasUAVisualTransition) { transition?.skipTransition() }
+ })
+
+ const router = useRouter()
+
+ const normalizeViewTransitionOptions = (value: unknown): Partial<ViewTransitionPageOptions> => {
+ if (typeof value === 'boolean' || value === 'always') {
+ return { enabled: value }
+ }
+ if (value && typeof value === 'object') {
+ return value as ViewTransitionPageOptions
+ }
+ return {}
+ }
+
+ router.beforeResolve(async (to, from) => {
+ if (to.matched.length === 0) { return }
+
+ const toViewTransitionOptions = normalizeViewTransitionOptions(to.meta.viewTransition)
+ const fromViewTransitionOptions = normalizeViewTransitionOptions(from.meta.viewTransition)
+ const viewTransitionMode = toViewTransitionOptions.enabled ?? defaultViewTransition.enabled
+ const prefersReducedMotion = window.matchMedia('(prefers-reduced-motion: reduce)').matches
+ const prefersNoTransition = prefersReducedMotion && viewTransitionMode !== 'always'
+
+ if (
+ viewTransitionMode === false ||
+ prefersNoTransition ||
+ hasUAVisualTransition ||
+ !isChangingPage(to, from)
+ ) {
+ return
+ }
+
+ const resolveViewTransitionTypes = (types: ViewTransitionPageOptions['types']) => {
+ return types ? typeof types === 'function' ? types(to, from) : types : undefined
+ }
+
+ const viewTransitionBaseTypes =
+ resolveViewTransitionTypes(toViewTransitionOptions.types) ??
+ resolveViewTransitionTypes(defaultViewTransition.types) ??
+ []
+ const viewTransitionFromTypes = resolveViewTransitionTypes(fromViewTransitionOptions.fromTypes) ?? []
+ const viewTransitionToTypes = resolveViewTransitionTypes(toViewTransitionOptions.toTypes) ?? []
+
+ const allTypes = [
+ ...viewTransitionBaseTypes,
+ ...viewTransitionFromTypes,
+ ...viewTransitionToTypes,
+ ]
+
+ const promise = new Promise<void>((resolve, reject) => {
+ finishTransition = resolve
+ abortTransition = reject
+ })
+
+ let changeRoute: () => void
+ const ready = new Promise<void>(resolve => (changeRoute = resolve))
+
+ const update = () => {
+ changeRoute()
+ return promise
+ }
+
+ // Use the object form (Level 2) only when types are specified,
+ // falling back to the callback form (Level 1) for broader browser support.
+ transition = allTypes.length > 0
+ ? document.startViewTransition!({ update, types: allTypes })
+ : document.startViewTransition!(update)
+
+ transition.finished.catch(() => {}).finally(resetTransitionState)
+
+ await nuxtApp.callHook('page:view-transition:start', transition)
+
+ return ready
+ })
+
+ router.onError(() => {
+ abortTransition?.()
+ resetTransitionState()
+ })
+
+ nuxtApp.hook('app:error', () => {
+ abortTransition?.()
+ resetTransitionState()
+ })
+
+ nuxtApp.hook('vue:error', () => {
+ abortTransition?.()
+ resetTransitionState()
+ })
+
+ nuxtApp.hook('page:finish', () => {
+ finishTransition?.()
+ resetTransitionState()
+ })
+})
+
+export default plugin
diff --git a/packages/nuxt/src/app/plugins/warn.dev.server.ts b/packages/nuxt/src/app/plugins/warn.dev.server.ts
new file mode 100644
index 000000000000..07315ec130ca
--- /dev/null
+++ b/packages/nuxt/src/app/plugins/warn.dev.server.ts
@@ -0,0 +1,10 @@
+import { defineNuxtPlugin } from '../nuxt'
+import type { ObjectPlugin, Plugin } from '../nuxt'
+
+const plugin: Plugin & ObjectPlugin = defineNuxtPlugin((nuxtApp) => {
+ nuxtApp.vueApp.config.warnHandler ??= (msg, _instance, trace) => {
+ console.warn(`[Vue warn]: ${msg}`, trace)
+ }
+})
+
+export default plugin
diff --git a/packages/nuxt/src/app/types.ts b/packages/nuxt/src/app/types.ts
new file mode 100644
index 000000000000..cb0959f43481
--- /dev/null
+++ b/packages/nuxt/src/app/types.ts
@@ -0,0 +1,46 @@
+import type { SerializableHead } from '@unhead/vue'
+
+export type { PageMeta, NuxtPageProps, NuxtLayouts } from '../pages/runtime/index'
+
+export interface NuxtAppLiterals {
+ [key: string]: string
+}
+
+export interface NuxtIslandSlotResponse {
+ props: Array<unknown>
+ fallback?: string
+}
+
+export interface NuxtIslandClientResponse {
+ html: string
+ props: unknown
+ chunk: string
+ slots?: Record<string, string>
+}
+
+export interface NuxtIslandContext {
+ id?: string
+ name: string
+ props?: Record<string, any>
+ url: string
+ slots: Record<string, Omit<NuxtIslandSlotResponse, 'fallback'>>
+ components: Record<string, Omit<NuxtIslandClientResponse, 'html'>>
+}
+
+export interface NuxtIslandResponse {
+ id?: string
+ html: string
+ head: SerializableHead
+ props?: Record<string, Record<string, any>>
+ components?: Record<string, NuxtIslandClientResponse>
+ slots?: Record<string, NuxtIslandSlotResponse>
+}
+
+export interface NuxtRenderHTMLContext {
+ htmlAttrs: string[]
+ head: string[]
+ bodyAttrs: string[]
+ bodyPrepend: string[]
+ body: string[]
+ bodyAppend: string[]
+}
diff --git a/packages/nuxt/src/app/types/augments.ts b/packages/nuxt/src/app/types/augments.ts
new file mode 100644
index 000000000000..44c83d49958a
--- /dev/null
+++ b/packages/nuxt/src/app/types/augments.ts
@@ -0,0 +1,63 @@
+import type { UseHeadInput } from '@unhead/vue/types'
+import type { $Fetch } from 'nitro/types'
+import type { NuxtApp, useNuxtApp } from '../nuxt'
+
+declare global {
+ // eslint-disable-next-line @typescript-eslint/no-namespace
+ namespace NodeJS {
+ interface Process {
+ /** @deprecated Use `import.meta.browser` instead. This may be removed in Nuxt v5 or a future major version. */
+ browser: boolean
+ /** @deprecated Use `import.meta.client` instead. This may be removed in Nuxt v5 or a future major version. */
+ client: boolean
+ /** @deprecated Use `import.meta.dev` instead. This may be removed in Nuxt v5 or a future major version. */
+ dev: boolean
+ /** @deprecated Use `import.meta.server` instead. This may be removed in Nuxt v5 or a future major version. */
+ server: boolean
+ /** @deprecated Use `import.meta.test` instead. This may be removed in Nuxt v5 or a future major version. */
+ test: boolean
+ }
+ }
+
+ interface ImportMeta {
+ browser: boolean
+ client: boolean
+ dev: boolean
+ envName: string
+ server: boolean
+ test: boolean
+ }
+
+ interface Window {
+ __NUXT__?: Record<string, any> | Record<string, Record<string, any>>
+ useNuxtApp?: typeof useNuxtApp
+ }
+
+ // TODO: typed fetch
+ // @ts-expect-error type is coming in from `nitropack` v2
+ const $fetch: $Fetch
+}
+
+declare module 'vue' {
+ // eslint-disable-next-line @typescript-eslint/no-unused-vars
+ interface App<HostElement> {
+ $nuxt: NuxtApp
+ }
+ interface ComponentCustomProperties {
+ $nuxt: NuxtApp
+ }
+ interface ComponentInternalInstance {
+ _nuxtOnBeforeMountCbs: Array<() => void | Promise<void>>
+ _nuxtIdIndex?: Record<string, number>
+ _nuxtClientOnly?: boolean
+ }
+ interface ComponentCustomOptions {
+ /**
+ * Available exclusively for `defineNuxtComponent`.
+ * It will not be executed when using `defineComponent`.
+ */
+ head?(nuxtApp: NuxtApp): UseHeadInput
+ }
+}
+
+export type _NuxtAugmentsAnchor = NuxtApp
diff --git a/packages/nuxt/src/app/utils.ts b/packages/nuxt/src/app/utils.ts
new file mode 100644
index 000000000000..08c58abf8fec
--- /dev/null
+++ b/packages/nuxt/src/app/utils.ts
@@ -0,0 +1,44 @@
+import { captureStackTrace } from 'errx'
+
+/** @since 3.9.0 */
+export function toArray<T> (value: T | T[]): T[] {
+ return Array.isArray(value) ? value : [value]
+}
+
+const distURL = import.meta.url.replace(/\/app\/.*$/, '/')
+type Trace = { source: string, line?: number, column?: number }
+
+export function getUserTrace (): Trace[] {
+ if (!import.meta.dev) {
+ return []
+ }
+
+ const trace = captureStackTrace()
+ const start = trace.findIndex(entry => !entry.source.startsWith(distURL))
+ const end = trace.toReversed().findIndex(entry => !entry.source.includes('node_modules') && !entry.source.startsWith(distURL))
+ if (start === -1 || end === -1) {
+ return []
+ }
+ return trace.slice(start, end > 0 ? -end : undefined).map(i => ({
+ ...i,
+ source: i.source.replace(/^file:\/\//, ''),
+ }))
+}
+
+export function getUserCaller (): Trace | null {
+ if (!import.meta.dev) {
+ return null
+ }
+
+ const { source, line, column } = captureStackTrace().find(entry => !entry.source.startsWith(distURL)) ?? {}
+
+ if (!source) {
+ return null
+ }
+
+ return {
+ source: source.replace(/^file:\/\//, ''),
+ line,
+ column,
+ }
+}
diff --git a/packages/nuxt/src/compiler/module.ts b/packages/nuxt/src/compiler/module.ts
new file mode 100644
index 000000000000..21df6db6131e
--- /dev/null
+++ b/packages/nuxt/src/compiler/module.ts
@@ -0,0 +1,210 @@
+import { addBuildPlugin, defineNuxtModule, resolveFiles, resolvePath } from '@nuxt/kit'
+import type { CompilerScanDir, KeyedFunction, NuxtCompilerOptions } from '@nuxt/schema'
+import type { ScanPlugin, ScanPluginFilter } from './types.ts'
+import { resolve } from 'pathe'
+import { DECLARATION_EXTENSIONS, isDirectorySync, logger, normalizeExtension, toArray } from '../utils.ts'
+import { createScanPluginContext, matchWithStringOrRegex } from './utils.ts'
+import { readFile } from 'node:fs/promises'
+import { KeyedFunctionFactoriesPlugin, KeyedFunctionFactoriesScanPlugin, scanFileForFactories } from './plugins/keyed-function-factories.ts'
+import type { KeyedFunctionFactoriesScanResult } from './plugins/keyed-function-factories.ts'
+import type { Unimport } from 'unimport'
+import { KeyedFunctionsPlugin } from './plugins/keyed-functions.ts'
+
+export default defineNuxtModule<Partial<NuxtCompilerOptions>>({
+ meta: {
+ name: 'nuxt:compiler',
+ configKey: 'compiler',
+ },
+ defaults: {
+ scan: true,
+ },
+ setup (_options, nuxt) {
+ let unimport: Unimport | undefined
+ nuxt.hook('imports:context', (ctx) => {
+ unimport = ctx
+ })
+
+ // Shared state for HMR — populated during build:before, accessed by builder:watch
+ let scanResult: KeyedFunctionFactoriesScanResult | undefined
+ let scanDirPaths: string[] = []
+ let normalizedKeyedFunctions: KeyedFunction[] = []
+
+ nuxt.hook('build:before', async () => {
+ // Replace keyed function factory compiler macro placeholders with actual factories.
+ addBuildPlugin(KeyedFunctionFactoriesPlugin({
+ factories: nuxt.options.optimization.keyedComposableFactories,
+ alias: nuxt.options.alias,
+ getAutoImports: () => unimport?.getImports() || Promise.resolve([]),
+ }))
+
+ // Scan user composables directories for factory-created keyed functions
+ if (_options.scan) {
+ const scanPlugin = KeyedFunctionFactoriesScanPlugin({
+ factories: nuxt.options.optimization.keyedComposableFactories,
+ alias: nuxt.options.alias,
+ })
+ scanResult = scanPlugin.result
+ await runScanPlugins([scanPlugin])
+ }
+
+ // Add keys for useFetch, useAsyncData, etc.
+ // Maintained as a mutable list so HMR can add/remove entries
+ normalizedKeyedFunctions = await Promise.all(nuxt.options.optimization.keyedComposables.map(async ({ source, ...rest }) => ({
+ ...rest,
+ source: typeof source === 'string' ? await resolvePath(source, { fallbackToOriginal: true }) : source,
+ })))
+
+ addBuildPlugin(KeyedFunctionsPlugin({
+ keyedFunctions: normalizedKeyedFunctions,
+ getKeyedFunctions: () => normalizedKeyedFunctions,
+ alias: nuxt.options.alias,
+ getAutoImports: () => unimport?.getImports() || Promise.resolve([]),
+ appDir: nuxt.options.appDir,
+ dev: nuxt.options.dev,
+ }))
+ })
+
+ async function runScanPlugins (plugins: ScanPlugin[]) {
+ const autoImports = await unimport?.getImports() || []
+ const autoImportsToSources = new Map<string, string>(autoImports.map(i => [i.as || i.name, i.from]))
+
+ // Collect composables directories from each layer
+ const dirPaths = new Set<string>()
+ const scanDirs: Required<CompilerScanDir>[] = []
+
+ for (const layer of nuxt.options._layers) {
+ if (layer.config?.compiler?.scan === false) {
+ continue
+ }
+
+ const composablesDir = resolve(layer.config.srcDir, 'composables')
+ if (!isDirectorySync(composablesDir) || dirPaths.has(composablesDir)) {
+ continue
+ }
+
+ dirPaths.add(composablesDir)
+ const extensions = nuxt.options.extensions.map(e => normalizeExtension(e))
+
+ scanDirs.push({
+ path: composablesDir,
+ extensions,
+ pattern: `**/*.{${extensions.join(',')}}`,
+ ignore: [`**/*.{${DECLARATION_EXTENSIONS.join(',')}}`],
+ })
+ }
+
+ // Store dir paths for HMR watch handler
+ scanDirPaths = scanDirs.map(d => d.path)
+
+ // Resolve files from scan directories
+ const _filePaths: string[] = []
+ await Promise.all(scanDirs.map(async (dir) => {
+ const files = await resolveFiles(dir.path, dir.pattern, { ignore: dir.ignore })
+ _filePaths.push(...files)
+ }))
+
+ const filePaths = await Promise.all(_filePaths.map(filePath => resolvePath(filePath)))
+
+ // Scan the files
+ for (const filePath of filePaths) {
+ const isFileWantedByPlugin = plugins.some((p) => {
+ if (!p.filter?.id) { return true }
+ return matchFilter(filePath, p.filter.id)
+ })
+
+ if (!isFileWantedByPlugin) { continue }
+
+ try {
+ const contents = await readFile(filePath, 'utf-8')
+ const pluginScanThisContext = createScanPluginContext(contents, filePath)
+
+ await Promise.all(plugins.map(async (plugin) => {
+ if (plugin.filter?.id && !matchFilter(filePath, plugin.filter.id)) { return }
+ if (plugin.filter?.code && !matchFilter(contents, plugin.filter.code)) { return }
+
+ try {
+ await plugin.scan.call(pluginScanThisContext, { id: filePath, code: contents, nuxt, autoImportsToSources })
+ } catch (e) {
+ logger.error(`[nuxt:compiler] Plugin \`${plugin.name}\` failed to scan file \`${filePath}\``, e)
+ }
+ }))
+ } catch (e) {
+ logger.error(`[nuxt:compiler] Cannot read file \`${filePath}\``, e)
+ }
+ }
+
+ await Promise.all(plugins.map(async (plugin) => {
+ if (!plugin.afterScan) { return }
+ try {
+ await plugin.afterScan(nuxt)
+ } catch (e) {
+ logger.error(`[nuxt:compiler] Error in \`afterScan\` hook of plugin \`${plugin.name}\``, e)
+ }
+ }))
+ }
+
+ // HMR: incrementally re-scan files when composable directories change
+ if (nuxt.options.dev && _options.scan) {
+ nuxt.hook('builder:watch', async (event, relativePath) => {
+ if (!scanResult || !['add', 'change', 'unlink'].includes(event)) { return }
+
+ const absolutePath = resolve(nuxt.options.srcDir, relativePath)
+ const isInScanDir = scanDirPaths.some(dir => absolutePath === dir || absolutePath.startsWith(dir + '/'))
+ if (!isInScanDir) { return }
+
+ const { fileResults, factoryNamesRegex, namesToFactoryMeta } = scanResult
+
+ // Remove old entries for this file from normalizedKeyedFunctions
+ const oldEntries = fileResults.get(absolutePath)
+ if (oldEntries?.length) {
+ const resolvedSource = await resolvePath(absolutePath, { fallbackToOriginal: true })
+ for (let i = normalizedKeyedFunctions.length - 1; i >= 0; i--) {
+ if (normalizedKeyedFunctions[i]!.source === resolvedSource) {
+ normalizedKeyedFunctions.splice(i, 1)
+ }
+ }
+ fileResults.delete(absolutePath)
+ }
+
+ if (event === 'unlink') { return }
+
+ let contents: string
+ try {
+ contents = await readFile(absolutePath, 'utf-8')
+ } catch {
+ return
+ }
+
+ if (!factoryNamesRegex.test(contents)) { return }
+
+ const autoImports = await unimport?.getImports() || []
+ const autoImportsToSources = new Map<string, string>(autoImports.map(i => [i.as || i.name, i.from]))
+
+ const newEntries = scanFileForFactories(
+ absolutePath,
+ contents,
+ namesToFactoryMeta,
+ autoImportsToSources,
+ nuxt.options.alias,
+ )
+
+ if (newEntries.length) {
+ fileResults.set(absolutePath, newEntries)
+
+ const normalized = await Promise.all(newEntries.map(async ({ source, ...rest }) => ({
+ ...rest,
+ source: typeof source === 'string' ? await resolvePath(source, { fallbackToOriginal: true }) : source,
+ })))
+ normalizedKeyedFunctions.push(...normalized)
+ }
+ })
+ }
+ },
+})
+
+function matchFilter (input: string, filter: ScanPluginFilter) {
+ if (typeof filter === 'function') { return filter(input) }
+ const include = filter.include ? toArray(filter.include).some(v => matchWithStringOrRegex(input, v)) : true
+ const exclude = filter.exclude ? toArray(filter.exclude).some(v => matchWithStringOrRegex(input, v)) : false
+ return include && !exclude
+}
diff --git a/packages/nuxt/src/compiler/plugins/keyed-function-factories.ts b/packages/nuxt/src/compiler/plugins/keyed-function-factories.ts
new file mode 100644
index 000000000000..0914203b3ca8
--- /dev/null
+++ b/packages/nuxt/src/compiler/plugins/keyed-function-factories.ts
@@ -0,0 +1,486 @@
+import { resolveAlias } from '@nuxt/kit'
+import escapeRE from 'escape-string-regexp'
+import { JS_EXT_RE, MACRO_QUERY_RE, NUXT_LIB_RE, STYLE_QUERY_RE, logger, stripExtension } from '../../utils.ts'
+import type { ESTree } from 'rolldown/utils'
+import { isAbsolute, join, parse } from 'pathe'
+import { createUnplugin } from 'unplugin'
+import { generateTransform, rolldownString } from 'rolldown-string'
+import { ScopeTracker, type ScopeTrackerNode, parseAndWalk, walk } from 'oxc-walker'
+import { type ParsedStaticImport, findStaticImports, parseStaticImport } from 'mlly'
+import type { KeyedFunction, KeyedFunctionFactory } from '@nuxt/schema'
+import type { ScanPlugin } from '../types.ts'
+import type { Import } from 'unimport'
+import { type FunctionCallMetadata, parseStaticFunctionCall, processImports } from '../../core/utils/parse-utils.ts'
+import { createScanPluginContext } from '../utils.ts'
+
+interface ParsedKeyedFunctionFactory {
+ factoryName: string
+ factoryNode: FunctionCallMetadata['node']
+ functionName: string
+ namespace: string | null
+}
+
+/**
+ * Check if the node is a named export of a keyed function factory, and if so,
+ * return its VariableDeclarator node.
+ */
+export function parseKeyedFunctionFactory (node: ESTree.ExportNamedDeclaration | ESTree.ExportDefaultDeclaration, filter: RegExp, scopeTracker: ScopeTracker): ParsedKeyedFunctionFactory[] {
+ if (node.type === 'ExportNamedDeclaration') {
+ const parsed: ParsedKeyedFunctionFactory[] = []
+
+ function processVariableDeclarator (node: ESTree.VariableDeclarator) {
+ if (node.init?.type !== 'CallExpression' && node.init?.type !== 'ChainExpression') { return }
+ const functionCallMeta = parseStaticFunctionCall(node.init, filter)
+ if (functionCallMeta && node?.id.type === 'Identifier') {
+ parsed.push({
+ factoryName: functionCallMeta.name,
+ factoryNode: functionCallMeta.node,
+ functionName: node.id.name,
+ namespace: functionCallMeta.namespace,
+ })
+ }
+ }
+
+ // export const useFetch = createUseFetch()
+ if (node.declaration?.type === 'VariableDeclaration') {
+ for (const d of node.declaration.declarations) {
+ processVariableDeclarator(d)
+ }
+ // export { useFetch }
+ } else if (node.specifiers.length) {
+ for (const specifier of node.specifiers) {
+ if (specifier.type !== 'ExportSpecifier' || specifier.exported.type !== 'Identifier' || specifier.local.type !== 'Identifier') { continue }
+ const declaration = scopeTracker.getDeclaration(specifier.local.name)
+ if (declaration?.type !== 'Variable') { continue }
+
+ for (const d of declaration.variableNode.declarations) {
+ processVariableDeclarator(d)
+ }
+ }
+ }
+
+ return parsed
+ }
+
+ if (node.type === 'ExportDefaultDeclaration' && node.declaration.type === 'CallExpression') {
+ const functionCallMeta = parseStaticFunctionCall(node.declaration, filter)
+ if (functionCallMeta) {
+ return [{
+ factoryName: functionCallMeta.name,
+ factoryNode: functionCallMeta.node,
+ functionName: 'default',
+ namespace: functionCallMeta.namespace,
+ }]
+ }
+ return []
+ }
+
+ return []
+}
+
+/**
+ * @param filePath
+ * @param scopeTracker
+ * @param namesToFactoryMeta - map of factory function names to their metadata; it is expected that the `source`s have had their aliases resolved and are without extensions
+ * @param imports
+ * @param autoImportsToSources
+ * @param alias
+ */
+function createFactoryProcessor (
+ filePath: string,
+ scopeTracker: ScopeTracker,
+ namesToFactoryMeta: Map<string, KeyedFunctionFactory>,
+ imports: ParsedStaticImport[],
+ autoImportsToSources: Map<string, string> | undefined,
+ alias: Record<string, string>,
+) {
+ const { directImports, namespaces } = processImports(imports, alias)
+
+ const localFactoryNames = new Set<string>(namesToFactoryMeta.keys())
+ for (const [localName, directImport] of directImports) {
+ if (namesToFactoryMeta.has(directImport.originalName)) {
+ localFactoryNames.add(localName)
+ }
+ }
+ const LOCAL_FACTORY_NAMES_RE = new RegExp(`\\b(${[...localFactoryNames].map(f => escapeRE(f)).join('|')})\\b`)
+
+ // TODO: use async walker or create sync version of `resolvePath` from kit
+ function _resolvePath (path: string) {
+ let p = path
+ if (isAbsolute(p)) { return p }
+ p = resolveAlias(p, alias)
+ if (isAbsolute(p)) { return p }
+ return join(parse(filePath).dir, p)
+ }
+
+ function getFactoryByLocalName (localName: string | undefined) {
+ if (!localName) { return undefined }
+ const directImport = directImports.get(localName)
+ if (directImport) {
+ return namesToFactoryMeta.get(directImport.originalName)
+ }
+ return namesToFactoryMeta.get(localName)
+ }
+
+ function processFactory (
+ walkContext: ThisParameterType<NonNullable<Parameters<typeof walk>[1]['enter']>>, // TODO: export type from `oxc-walker`
+ node: ESTree.ExportNamedDeclaration | ESTree.ExportDefaultDeclaration,
+ handler: (ctx: { parseFactoryResult: ParsedKeyedFunctionFactory, factory: KeyedFunctionFactory }) => void,
+ ) {
+ const parsedFactoryCalls = parseKeyedFunctionFactory(node, LOCAL_FACTORY_NAMES_RE, scopeTracker)
+ if (!parsedFactoryCalls.length) { return }
+
+ for (const parsedFactoryCall of parsedFactoryCalls) {
+ const factoryMeta = getFactoryByLocalName(parsedFactoryCall.factoryName)
+ if (!factoryMeta) {
+ logger.error(`[nuxt:compiler] No factory function found for \`${parsedFactoryCall.functionName}\` in file \`${filePath}\`. This is a Nuxt bug.`)
+ continue
+ }
+
+ const scopeTrackerNode = scopeTracker.getDeclaration(!parsedFactoryCall.namespace ? parsedFactoryCall.factoryName : parsedFactoryCall.namespace)
+
+ function isFactoryImport (node: ScopeTrackerNode | null): node is ScopeTrackerNode & { type: 'Import' } {
+ return node?.type === 'Import' && node.importNode.importKind !== 'type'
+ }
+
+ // import source WITHOUT EXTENSION and with resolved alias
+ let importSourceResolved: string | undefined
+
+ if (isFactoryImport(scopeTrackerNode)) {
+ importSourceResolved = stripExtension(_resolvePath(scopeTrackerNode.importNode.source.value))
+ } else if (!scopeTrackerNode) {
+ const autoImportedSource = autoImportsToSources?.get(factoryMeta.name)
+ if (autoImportedSource) {
+ importSourceResolved = stripExtension(_resolvePath(autoImportedSource))
+ }
+ }
+
+ if (!importSourceResolved) {
+ continue
+ }
+
+ // resolved source WITHOUT an extension
+ const resolvedFactorySource = factoryMeta.source
+
+ // the factory is called directly
+ // `createUseFetch()`
+ if (
+ !parsedFactoryCall.namespace && (
+ // and the factory is imported directly
+ (
+ isFactoryImport(scopeTrackerNode) && (
+ (
+ // import { createUseFetch } from '...'
+ scopeTrackerNode.node.type === 'ImportSpecifier'
+ && scopeTrackerNode.node.importKind !== 'type'
+ )
+ // import createUseFetch from '...'
+ || (
+ scopeTrackerNode.node.type === 'ImportDefaultSpecifier'
+ && factoryMeta.name === 'default'
+ )
+ )
+ // from the correct source
+ && importSourceResolved === resolvedFactorySource
+ )
+ // or the factory is auto-imported
+ || (!scopeTrackerNode && importSourceResolved === resolvedFactorySource)
+ // we deliberately do not support scanning for factories used in the same file they are defined in
+ )
+ ) {
+ handler({ parseFactoryResult: parsedFactoryCall, factory: factoryMeta })
+ walkContext.skip()
+ continue
+ }
+
+ // the function is called as a member of a namespace import
+ // `namespace.createUseFetch()`
+ if (parsedFactoryCall.namespace) {
+ const namespacedImportMeta = namespaces.get(resolvedFactorySource)
+ const namespaceScopeTrackerNode = scopeTracker.getDeclaration(parsedFactoryCall.namespace)
+
+ if (namespacedImportMeta && namespacedImportMeta.namespaces.has(parsedFactoryCall.namespace)
+ // the namespace is not shadowed
+ && namespaceScopeTrackerNode?.type === 'Import' && namespaceScopeTrackerNode.node.type === 'ImportNamespaceSpecifier'
+ ) {
+ handler({ parseFactoryResult: parsedFactoryCall, factory: factoryMeta })
+ }
+
+ // prevent descending into CallExpression of a ChainExpression
+ walkContext.skip()
+ continue
+ }
+
+ logger.debug(`[nuxt:compiler] The factory function \`${factoryMeta.name}\` used to create \`${parsedFactoryCall.functionName}\` in file \`${filePath}\` is not imported and is not in auto-imports. Skipping processing.`)
+ }
+ }
+
+ return {
+ processFactory,
+ }
+}
+
+// -------- compiler scan plugin for scanning keyed function factories --------
+
+interface KeyedFunctionFactoriesScanPluginOptions {
+ /**
+ * The factory functions that create keyed functions.
+ * Aliases in `source` have not been resolved yet.
+ */
+ factories: KeyedFunctionFactory[]
+ alias: Record<string, string>
+}
+
+/**
+ * Scans raw source files for factory functions that need auto-injected keys
+ * so that it can register them for key injection.
+ */
+/**
+ * Scans a single file for factory function calls and returns the keyed functions found.
+ * Extracted as a standalone function so it can be reused for HMR (incremental re-scan).
+ */
+export function scanFileForFactories (
+ id: string,
+ code: string,
+ namesToFactoryMeta: Map<string, KeyedFunctionFactory>,
+ autoImportsToSources: Map<string, string>,
+ alias: Record<string, string>,
+): KeyedFunction[] {
+ const results: KeyedFunction[] = []
+ const context = createScanPluginContext(code, id)
+
+ const scopeTracker = new ScopeTracker({
+ preserveExitedScopes: true,
+ })
+ const { processFactory } = createFactoryProcessor(id, scopeTracker, namesToFactoryMeta, context.getParsedStaticImports(), autoImportsToSources, alias)
+
+ context.walkParsed({
+ scopeTracker,
+ })
+
+ scopeTracker.freeze()
+
+ let isWalkingSupportedSubtree = false
+
+ context.walkParsed({
+ scopeTracker,
+ enter (node) {
+ if (node.type !== 'Program' && !isWalkingSupportedSubtree && node.type !== 'ExportNamedDeclaration' && node.type !== 'ExportDefaultDeclaration' && node.type !== 'ImportDeclaration') {
+ this.skip()
+ }
+ if (node.type !== 'ExportNamedDeclaration' && node.type !== 'ExportDefaultDeclaration') {
+ return
+ }
+ isWalkingSupportedSubtree = true
+
+ processFactory(this, node, ({ parseFactoryResult, factory }) => {
+ results.push({
+ name: parseFactoryResult.functionName,
+ source: id,
+ argumentLength: factory.argumentLength,
+ })
+ })
+ },
+ leave (node) {
+ if (node.type === 'ExportNamedDeclaration' || node.type === 'ExportDefaultDeclaration' || node.type === 'ImportDeclaration') {
+ isWalkingSupportedSubtree = false
+ }
+ },
+ })
+
+ return results
+}
+
+export interface KeyedFunctionFactoriesScanResult {
+ /** Per-file map of scanned keyed functions */
+ fileResults: Map<string, KeyedFunction[]>
+ /** Regex matching factory function names, for use as a fast prefilter */
+ factoryNamesRegex: RegExp
+ /** Resolved factory metadata map */
+ namesToFactoryMeta: Map<string, KeyedFunctionFactory>
+}
+
+export const KeyedFunctionFactoriesScanPlugin = (options: KeyedFunctionFactoriesScanPluginOptions): ScanPlugin & { result: KeyedFunctionFactoriesScanResult } => {
+ // Per-file tracking of discovered keyed functions
+ const fileResults = new Map<string, KeyedFunction[]>()
+
+ // DO NOT USE IN SCAN - this is a global copy that doesn't include local import renames
+ // - the `source`s have resolved aliases
+ const namesToFactoryMeta = new Map<string, KeyedFunctionFactory>(options.factories.map(f => [f.name, {
+ ...f,
+ source: stripExtension(resolveAlias(f.source, options.alias)),
+ }]))
+
+ // TODO: support default import, which won't have the factory name
+ const KEYED_FUNCTION_FACTORY_NAMES_RE = new RegExp(`\\b(${options.factories.map(f => escapeRE(f.name)).join('|')})\\b`)
+
+ const result: KeyedFunctionFactoriesScanResult = {
+ fileResults,
+ factoryNamesRegex: KEYED_FUNCTION_FACTORY_NAMES_RE,
+ namesToFactoryMeta,
+ }
+
+ return {
+ result,
+ name: 'nuxt:keyed-function-factories',
+ filter: {
+ id: { include: JS_EXT_RE },
+ code: { include: KEYED_FUNCTION_FACTORY_NAMES_RE },
+ },
+ scan ({ id, autoImportsToSources }) {
+ const results: KeyedFunction[] = []
+
+ const scopeTracker = new ScopeTracker({
+ preserveExitedScopes: true,
+ })
+ const { processFactory } = createFactoryProcessor(id, scopeTracker, namesToFactoryMeta, this.getParsedStaticImports(), autoImportsToSources, options.alias)
+
+ this.walkParsed({
+ scopeTracker,
+ })
+
+ scopeTracker.freeze()
+
+ let isWalkingSupportedSubtree = false
+
+ this.walkParsed({
+ scopeTracker,
+ enter (node) {
+ if (node.type !== 'Program' && !isWalkingSupportedSubtree && node.type !== 'ExportNamedDeclaration' && node.type !== 'ExportDefaultDeclaration' && node.type !== 'ImportDeclaration') {
+ this.skip()
+ }
+ if (node.type !== 'ExportNamedDeclaration' && node.type !== 'ExportDefaultDeclaration') {
+ return
+ }
+ isWalkingSupportedSubtree = true
+
+ processFactory(this, node, ({ parseFactoryResult, factory }) => {
+ results.push({
+ name: parseFactoryResult.functionName,
+ source: id,
+ argumentLength: factory.argumentLength,
+ })
+ })
+ },
+ leave (node) {
+ if (node.type === 'ExportNamedDeclaration' || node.type === 'ExportDefaultDeclaration' || node.type === 'ImportDeclaration') {
+ isWalkingSupportedSubtree = false
+ }
+ },
+ })
+
+ fileResults.set(id, results)
+ },
+ afterScan: (nuxt) => {
+ for (const functions of fileResults.values()) {
+ nuxt.options.optimization.keyedComposables.push(...functions)
+ }
+ },
+ }
+}
+
+// -------- unplugin for replacing keyed factory macros --------
+
+interface KeyedFunctionFactoriesPluginOptions {
+ factories: KeyedFunctionFactory[]
+ alias: Record<string, string>
+ getAutoImports: () => Promise<Import[]>
+}
+
+/**
+ * A plugin that replaces placeholder macros with actual factory functions.
+ * This is necessary to ensure that the user is notified when the factory function isn't correctly
+ * registered - in which case, the resulting function created by the factory will not be registered for key injection.
+ *
+ * The plugin assumes that the code being processed has all imports added.
+ */
+export const KeyedFunctionFactoriesPlugin = (options: KeyedFunctionFactoriesPluginOptions) => createUnplugin(() => {
+ // DO NOT USE IN TRANSFORM - this is a global copy that doesn't include local import renames
+ // - the `source`s have resolved aliases
+ const namesToFactoryMeta = new Map<string, KeyedFunctionFactory>(options.factories.map(f => [f.name, {
+ ...f,
+ source: stripExtension(resolveAlias(f.source, options.alias)),
+ }]))
+
+ // TODO: support default import, which won't have the factory name
+ const KEYED_FUNCTION_FACTORY_NAMES_RE = new RegExp(`\\b(${options.factories.map(f => escapeRE(f.name)).join('|')})\\b`)
+
+ return {
+ name: 'nuxt:compiler:keyed-function-factories',
+ enforce: 'post',
+ transform: {
+ filter: {
+ id: {
+ include: JS_EXT_RE,
+ exclude: [NUXT_LIB_RE, STYLE_QUERY_RE, MACRO_QUERY_RE],
+ },
+ code: { include: KEYED_FUNCTION_FACTORY_NAMES_RE },
+ },
+ async handler (code, id, meta?: unknown) {
+ const s = rolldownString(code, id, meta)
+ const scopeTracker = new ScopeTracker({
+ preserveExitedScopes: true,
+ })
+ const autoImports = await options.getAutoImports()
+ const autoImportsToSources = new Map<string, string>(autoImports.map(i => [i.as || i.name, i.from]))
+ const { processFactory } = createFactoryProcessor(
+ id,
+ scopeTracker,
+ namesToFactoryMeta,
+ findStaticImports(code).map(i => parseStaticImport(i)),
+ autoImportsToSources,
+ options.alias,
+ )
+
+ function rewriteFactoryMacro (node: ESTree.IdentifierReference | ESTree.MemberExpression | ESTree.ParenthesizedExpression) {
+ // TODO: use sth more robust for rewriting optionals
+ if (node.type === 'Identifier') {
+ // createUseFetch?.() -> createUseFetch?.__nuxt_factory()
+ if (code[node.end] === '?' && code[node.end + 1] === '.') {
+ s.overwrite(
+ node.start,
+ node.end + 2,
+ `${node.name}?.__nuxt_factory`,
+ )
+ } else {
+ // createUseFetch() -> createUseFetch.__nuxt_factory()
+ s.overwrite(
+ node.start,
+ node.end,
+ `${node.name}.__nuxt_factory`,
+ )
+ }
+ } else if (code[node.end] === '?' && code[node.end + 1] === '.') {
+ // ['createUseFetch']?.() -> ['createUseFetch']?.__nuxt_factory()
+ s.appendLeft(node.end + 2, '__nuxt_factory')
+ } else {
+ // ['createUseFetch']() -> ['createUseFetch'].__nuxt_factory()
+ s.appendLeft(node.end, '.__nuxt_factory')
+ }
+ }
+
+ const { program } = parseAndWalk(code, id, {
+ scopeTracker,
+ })
+
+ scopeTracker.freeze()
+
+ walk(program, {
+ // no need for a scope tracker pre-pass, since we only care about imports
+ // and we only consider the root scope (because that's where an export would be - so no shadowing)
+ scopeTracker,
+ enter (node) {
+ if (node.type !== 'ExportNamedDeclaration' && node.type !== 'ExportDefaultDeclaration') {
+ return
+ }
+ processFactory(this, node, ({ parseFactoryResult }) => {
+ rewriteFactoryMacro(parseFactoryResult.factoryNode)
+ })
+ },
+ })
+
+ return generateTransform(s, id)
+ },
+ },
+ }
+})
diff --git a/packages/nuxt/src/compiler/plugins/keyed-functions.ts b/packages/nuxt/src/compiler/plugins/keyed-functions.ts
new file mode 100644
index 000000000000..63e4c6722769
--- /dev/null
+++ b/packages/nuxt/src/compiler/plugins/keyed-functions.ts
@@ -0,0 +1,434 @@
+import { createUnplugin } from 'unplugin'
+import { generateTransform, rolldownString } from 'rolldown-string'
+import { hash } from 'ohash'
+
+import { isAbsolute, join, parse } from 'pathe'
+import { camelCase } from 'scule'
+import escapeRE from 'escape-string-regexp'
+import { findStaticImports, parseStaticImport } from 'mlly'
+import { ScopeTracker, type ScopeTrackerNode, parseAndWalk, walk } from 'oxc-walker'
+import { resolveAlias } from '@nuxt/kit'
+import type { KeyedFunction } from '@nuxt/schema'
+import type { ESTree } from 'rolldown/utils'
+import type { Import } from 'unimport'
+
+import { MACRO_QUERY_RE, NUXT_LIB_RE, STYLE_QUERY_RE, isWhitespace, logger, stripExtension } from '../../utils.ts'
+import { type FunctionCallMetadata, parseStaticExportIdentifiers, parseStaticFunctionCall, processImports } from '../../core/utils/parse-utils.ts'
+
+interface KeyedFunctionsOptions {
+ keyedFunctions: KeyedFunction[]
+ getKeyedFunctions?: () => KeyedFunction[]
+ alias: Record<string, string>
+ // TODO: remove in Nuxt 5
+ getAutoImports: () => Promise<Import[]>
+ // TODO: remove in Nuxt 5
+ appDir: string
+ dev?: boolean
+}
+
+const stringTypes: Array<string | undefined> = ['Literal', 'TemplateLiteral']
+const SUPPORTED_EXT_RE = /^[^?]*\.(?:m?[jt]sx?|vue)(?:$|\?)/
+const SCRIPT_RE = /(?<=<script[^>]*>)[\s\S]*?(?=<\/script>)/i
+const NUXT_INJECTED_MARKER = '/* nuxt-injected */'
+
+// TODO: remove in Nuxt 5
+type BackwardsCompatibleKeyedFunction = Omit<KeyedFunction, 'source'> & { source?: KeyedFunction['source'] | RegExp }
+
+/**
+ * Builds the lookup state from a list of keyed functions.
+ *
+ * Note: `namesToSourcesToFunctionMeta` is a global copy that maps exported names to sources.
+ * It does NOT include local import renames — the transform handler builds per-file local
+ * name mappings separately. The `source`s have resolved aliases and are without extensions.
+ */
+function buildKeyedFunctionsState (keyedFunctions: KeyedFunction[]) {
+ const namesToSourcesToFunctionMeta = new Map<string, Map<string, BackwardsCompatibleKeyedFunction>>()
+ // filenames (without extension) of files that have a `default` keyed function export
+ const defaultExportSources = new Set<string>()
+
+ for (const f of keyedFunctions) {
+ let functionName = f.name
+ const fnSource = typeof f.source === 'string' ? stripExtension(f.source) : ''
+
+ if (f.name === 'default') {
+ const parsedSource = parse(f.source)
+ defaultExportSources.add(parsedSource.name)
+ functionName = camelCase(parsedSource.name)
+ }
+
+ if (import.meta.dev) {
+ const sourcesToFunctionMeta = namesToSourcesToFunctionMeta.get(functionName)
+ const existingEntry = sourcesToFunctionMeta?.get(fnSource)
+ if (existingEntry?.source && existingEntry.source === fnSource) {
+ logger.warn(`[nuxt:compiler] [keyed-functions] Duplicate function name \`${functionName}\`${functionName !== f.name ? ` defined as \`${f.name}\`` : ''} with ${f.source ? `the same source \`${f.source}\`` : 'no source'} found. Overwriting the existing entry.`)
+ }
+ }
+
+ let sourcesToFunctionMeta = namesToSourcesToFunctionMeta.get(functionName)
+ if (!sourcesToFunctionMeta) {
+ sourcesToFunctionMeta = new Map<string, KeyedFunction>()
+ namesToSourcesToFunctionMeta.set(functionName, sourcesToFunctionMeta)
+ }
+
+ sourcesToFunctionMeta.set(fnSource, {
+ ...f,
+ // TODO: use only `fnSource` in Nuxt 5
+ source: typeof f.source === 'string' ? fnSource : f.source,
+ })
+ }
+
+ // resolved paths of all the sources WITHOUT EXTENSIONS
+ const sources = new Set<string>()
+ for (const sourcesToFunctionMeta of namesToSourcesToFunctionMeta.values()) {
+ for (const f of sourcesToFunctionMeta.values()) {
+ // TODO: remove check in Nuxt 5 (keeping it at the moment for the case when there is a RegExp in `source`)
+ if (f.source && typeof f.source === 'string') {
+ sources.add(f.source)
+ }
+ }
+ }
+
+ // TODO: come up with a better way to include files importing a `default` export (imported name can be arbitrary)
+ const codeIncludeRE = new RegExp(`\\b(${[...namesToSourcesToFunctionMeta.keys(), ...defaultExportSources].map(f => escapeRE(f)).join('|')})\\b`)
+
+ return { namesToSourcesToFunctionMeta, defaultExportSources, sources, codeIncludeRE }
+}
+
+export const KeyedFunctionsPlugin = (options: KeyedFunctionsOptions) => createUnplugin(() => {
+ // Build initial state from the static keyedFunctions list
+ let state = buildKeyedFunctionsState(options.keyedFunctions)
+ let lastKeyedFunctionsLength = options.keyedFunctions.length
+
+ // In dev mode with a reactive getter, rebuild state when data changes
+ function getState () {
+ if (options.dev && options.getKeyedFunctions) {
+ const current = options.getKeyedFunctions()
+ if (current.length !== lastKeyedFunctionsLength) {
+ state = buildKeyedFunctionsState(current)
+ lastKeyedFunctionsLength = current.length
+ }
+ }
+ return state
+ }
+
+ return {
+ name: 'nuxt:compiler:keyed-functions',
+ enforce: 'post',
+ transform: {
+ filter: {
+ id: {
+ include: SUPPORTED_EXT_RE,
+ exclude: [NUXT_LIB_RE, STYLE_QUERY_RE, MACRO_QUERY_RE],
+ },
+ // In dev mode, skip the static code filter to allow HMR-added composables to be processed.
+ // In production, use the static regex for performance.
+ ...(!options.dev && { code: { include: state.codeIncludeRE } }),
+ },
+ async handler (code, _id, meta?: unknown) {
+ const { namesToSourcesToFunctionMeta, sources } = getState()
+
+ // In dev mode, do an early return if no known composable names appear in the code
+ if (options.dev) {
+ const { codeIncludeRE } = getState()
+ if (!codeIncludeRE.test(code)) { return }
+ }
+
+ const { 0: script = code, index: codeIndex = 0 } = code.match(SCRIPT_RE) || { 0: code, index: 0 }
+ const id = stripExtension(_id)
+
+ const { directImports, namespaces } = processImports(findStaticImports(script).map(i => parseStaticImport(i)), options.alias)
+
+ // consider exports when processing a file that exports a keyed function
+ const shouldConsiderExports = sources.has(id)
+
+ // all local names that refer to a keyed function
+ // mapped to their exported names
+ const localNamesToExportedName = new Map<string, string>()
+
+ const possibleLocalFunctionNames = new Set<string>(namesToSourcesToFunctionMeta.keys())
+ for (const [localName, directImport] of directImports) {
+ // add import names that refer to keyed functions
+ const functionName = directImport.originalName === 'default'
+ ? camelCase(parse(directImport.source).name)
+ : directImport.originalName
+ if (namesToSourcesToFunctionMeta.has(functionName)) {
+ possibleLocalFunctionNames.add(localName)
+ }
+ }
+
+ const autoImports = await options.getAutoImports()
+ // auto-imported name -> source (without alias resolution and with extension)
+ const autoImportsToSources = new Map<string, string>(autoImports.map(i => [i.as || i.name, i.from]))
+
+ /**
+ * @param localName the local name of the function to get the meta for
+ * @param source the resolved source of the function to get the meta for (needs to be WITHOUT EXTENSION)
+ */
+ function getFunctionMetaByLocalName (localName: string, source: string): BackwardsCompatibleKeyedFunction | undefined {
+ if (!localName) { return }
+ // check exports (higher priority)
+ const exportedName = localNamesToExportedName.get(localName)
+ if (exportedName) {
+ return namesToSourcesToFunctionMeta.get(exportedName)?.get(source)
+ }
+ // check static direct imports
+ const directImport = directImports.get(localName)
+ if (directImport) {
+ const functionName = directImport.originalName === 'default'
+ ? camelCase(parse(directImport.source).name)
+ : directImport.originalName
+
+ // TODO: remove auto-import checks in Nuxt 5
+ const sourcesToMetas = namesToSourcesToFunctionMeta.get(functionName)
+ if (!sourcesToMetas) { return }
+
+ const fnMeta = sourcesToMetas.get(source)
+ if (fnMeta) { return fnMeta }
+
+ // TODO: remove in Nuxt 5
+ if (source.startsWith(options.appDir)) {
+ for (const [fnSource, meta] of sourcesToMetas) {
+ if (meta.name !== functionName || !fnSource.startsWith(options.appDir)) { continue }
+ return meta
+ }
+ }
+
+ const backwardsCompatibleFnMeta = sourcesToMetas.get('') // functions without a source or with a regex fall under ''
+ if (backwardsCompatibleFnMeta?.source === undefined) {
+ const autoImportResolvedSource = stripExtension(resolveAlias(autoImportsToSources.get(localName) ?? ''))
+ if (autoImportResolvedSource === source) {
+ return backwardsCompatibleFnMeta
+ }
+ } else if (backwardsCompatibleFnMeta.source instanceof RegExp && backwardsCompatibleFnMeta.source.test(source)) {
+ return backwardsCompatibleFnMeta
+ }
+
+ return
+ }
+
+ // check local names
+ return namesToSourcesToFunctionMeta.get(localName)?.get(source)
+ }
+
+ // TODO: use async walker or create sync version of `resolvePath` from kit
+ function _resolvePath (path: string) {
+ let p = path
+ if (isAbsolute(p)) { return p }
+ p = resolveAlias(p, options.alias)
+ if (isAbsolute(p)) { return p }
+ return join(parse(id).dir, p)
+ }
+
+ const s = rolldownString(code, _id, meta)
+ let count = 0
+
+ const scopeTracker = new ScopeTracker({
+ preserveExitedScopes: true,
+ })
+
+ // pre-pass to collect hoisted identifiers & exports
+ const { program } = parseAndWalk(code, _id, {
+ scopeTracker,
+ enter (node) {
+ if (!shouldConsiderExports) { return }
+ if (node.type !== 'ExportNamedDeclaration' && node.type !== 'ExportDefaultDeclaration') { return }
+
+ const result = parseStaticExportIdentifiers(node)
+ for (const exportMeta of result) {
+ const { localName, exportedName } = exportMeta
+ const functionName = exportedName === 'default'
+ ? camelCase(parse(id).name)
+ // the function cannot look up function meta by local names yet,
+ // so we need to use the `exportedName` instead because that is the one
+ // that's used in the keyed functions definition
+ : getFunctionMetaByLocalName(exportedName, id)?.name
+ if (!functionName) { continue }
+ localNamesToExportedName.set(localName, functionName)
+ }
+ },
+ })
+
+ scopeTracker.freeze()
+
+ // add exported local identifiers that refer to keyed functions
+ for (const localName of localNamesToExportedName.keys()) {
+ possibleLocalFunctionNames.add(localName)
+ }
+
+ const LOCAL_FUNCTION_NAMES_RE = new RegExp(`\\b(${[...possibleLocalFunctionNames].map(f => escapeRE(f)).join('|')})\\b`)
+
+ function processKeyedFunction (
+ walkContext: ThisParameterType<NonNullable<Parameters<typeof walk>[1]['enter']>>, // TODO: export type from `oxc-walker`
+ node: ESTree.Node,
+ handler: (ctx: { parsedCall: FunctionCallMetadata, fnMeta: BackwardsCompatibleKeyedFunction }) => void,
+ ) {
+ if (node.type !== 'CallExpression' && node.type !== 'ChainExpression') { return }
+ const parsedCall = parseStaticFunctionCall(node, LOCAL_FUNCTION_NAMES_RE)
+ if (!parsedCall) { return }
+
+ const functionScopeTrackerNode = scopeTracker.getDeclaration(!parsedCall.namespace ? parsedCall.name : parsedCall.namespace)
+
+ function isKeyedFunctionImport (node: ScopeTrackerNode | null): node is ScopeTrackerNode & { type: 'Import' } {
+ return node?.type === 'Import' && node.importNode.importKind !== 'type'
+ }
+
+ // import source WITHOUT EXTENSION and with resolved aliases
+ let importSourceResolved: string | undefined
+
+ // check for exports with a higher priority
+ if (localNamesToExportedName.has(parsedCall.name) && functionScopeTrackerNode?.scope === '') { // TODO: add support for checking root scope in `oxc-walker`
+ importSourceResolved = id
+ } else if (isKeyedFunctionImport(functionScopeTrackerNode)) {
+ importSourceResolved = stripExtension(_resolvePath(functionScopeTrackerNode.importNode.source.value))
+ }
+
+ if (!importSourceResolved) {
+ walkContext.skip()
+ return
+ }
+
+ const fnMeta = getFunctionMetaByLocalName(parsedCall.name, importSourceResolved)
+
+ if (!fnMeta) {
+ walkContext.skip()
+ return
+ }
+
+ // the function is called directly
+ // `useKeyed()`
+ if (!parsedCall.namespace) {
+ // skip if there are more arguments than allowed
+ if (
+ parsedCall.callExpression.arguments.length >= fnMeta.argumentLength
+ // do not skip when there is a spread element (we don't know how many arguments there are)
+ && !parsedCall.callExpression.arguments.some(a => a.type === 'SpreadElement')
+ ) {
+ walkContext.skip()
+ return
+ }
+
+ if (
+ // the function is imported
+ (
+ isKeyedFunctionImport(functionScopeTrackerNode) && (
+ // import { useKeyed } from '...'
+ (
+ functionScopeTrackerNode.node.type === 'ImportSpecifier'
+ && functionScopeTrackerNode.node.importKind !== 'type'
+ )
+ // import useKeyed from '...'
+ || (
+ functionScopeTrackerNode.node.type === 'ImportDefaultSpecifier'
+ && fnMeta.name === 'default'
+ )
+ )
+ && (
+ // the function is imported from the correct source when `source` is specified
+ (typeof fnMeta.source === 'string' && (stripExtension(fnMeta.source) === importSourceResolved))
+ // TODO: remove the checks below in Nuxt 5
+ // or the function is auto-imported when there is no source specified
+ || (!fnMeta.source && stripExtension(_resolvePath(autoImportsToSources.get(parsedCall.name) ?? '')) === importSourceResolved)
+ // or the specified function's source RegExp matches the import source
+ || (fnMeta.source instanceof RegExp && fnMeta.source.test(importSourceResolved))
+ // or the function is from the Nuxt source (`#app` barrel export, for example)
+ || (typeof fnMeta.source === 'string' && fnMeta.source.startsWith(options.appDir))
+ )
+ )
+ // or the function is defined in the current file, and we're considering the root level scope declaration
+ || (localNamesToExportedName.has(parsedCall.name) && functionScopeTrackerNode?.scope === '') // TODO: add support for checking root scope in `oxc-walker`
+ ) {
+ handler({ parsedCall, fnMeta })
+ }
+
+ walkContext.skip()
+ return
+ }
+
+ // the function is called as a member of a namespace import
+ // `namespace.useKeyed()`
+ if (parsedCall.namespace) {
+ const namespacedImportMeta = namespaces.get(importSourceResolved)
+ const namespaceScopeTrackerNode = scopeTracker.getDeclaration(parsedCall.namespace)
+
+ if (
+ namespacedImportMeta && namespacedImportMeta.namespaces.has(parsedCall.namespace)
+ // the namespace is not shadowed
+ && namespaceScopeTrackerNode?.type === 'Import' && namespaceScopeTrackerNode.node.type === 'ImportNamespaceSpecifier'
+ ) {
+ handler({ parsedCall, fnMeta })
+ }
+
+ // prevent descending into CallExpression of a ChainExpression
+ walkContext.skip()
+ return
+ }
+ }
+
+ walk(program, {
+ scopeTracker,
+ enter (node) {
+ processKeyedFunction(this, node, ({ parsedCall, fnMeta }) => {
+ // (workaround for webpack calling the build plugin multiple times on the same file in some cases)
+ // skip key injection if we already injected one
+ const lastArgument = parsedCall.callExpression.arguments[parsedCall.callExpression.arguments.length - 1]
+ if (
+ lastArgument?.type === 'Literal' && typeof lastArgument.value === 'string'
+ // there is a magic comment with a space before it after the last string argument
+ && lastArgument.end + NUXT_INJECTED_MARKER.length + 1 < parsedCall.callExpression.end
+ ) {
+ let wasKeyInjected = true
+ for (let i = 0; i < NUXT_INJECTED_MARKER.length; i++) {
+ // the magic comment does not match, we have not injected a key yet
+ if (code[codeIndex + lastArgument.end + 1 + i] !== NUXT_INJECTED_MARKER[i]) {
+ wasKeyInjected = false
+ break
+ }
+ }
+ if (wasKeyInjected) { return }
+ }
+
+ // skip key injection for Nuxt internal composables when they already have a key
+ switch (parsedCall.name) {
+ case 'useState':
+ if (
+ stringTypes.includes(parsedCall.callExpression.arguments[0]?.type)
+ && typeof fnMeta.source === 'string' && stripExtension(fnMeta.source) === stripExtension(resolveAlias('#app/composables/state', options.alias))
+ ) { return }
+ break
+ case 'useFetch':
+ case 'useLazyFetch':
+ if (
+ stringTypes.includes(parsedCall.callExpression.arguments[1]?.type)
+ && typeof fnMeta.source === 'string' && stripExtension(fnMeta.source) === stripExtension(resolveAlias('#app/composables/fetch', options.alias))
+ ) { return }
+ break
+
+ case 'useAsyncData':
+ case 'useLazyAsyncData':
+ if (
+ stringTypes.includes(parsedCall.callExpression.arguments[0]?.type)
+ && typeof fnMeta.source === 'string' && stripExtension(fnMeta.source) === stripExtension(resolveAlias('#app/composables/asyncData', options.alias))
+ ) { return }
+ break
+ }
+
+ // inject a key to the function call
+ let i = codeIndex + parsedCall.callExpression.end - 2 // char before the closing `)`
+ while (i >= codeIndex + parsedCall.callExpression.start && isWhitespace(code[i])) {
+ i--
+ }
+ const endsWithComma = code[i] === ','
+
+ s.appendLeft(
+ codeIndex + parsedCall.callExpression.end - 1,
+ (parsedCall.callExpression.arguments.length && !endsWithComma ? ', ' : '') + '\'$' + hash(`${_id}-${++count}`).slice(0, 10) + `' ${NUXT_INJECTED_MARKER}`,
+ )
+ })
+ },
+ })
+
+ return generateTransform(s, _id)
+ },
+ },
+ }
+})
diff --git a/packages/nuxt/src/compiler/runtime/index.ts b/packages/nuxt/src/compiler/runtime/index.ts
new file mode 100644
index 000000000000..5b1edc94a3a9
--- /dev/null
+++ b/packages/nuxt/src/compiler/runtime/index.ts
@@ -0,0 +1,34 @@
+import { kebabCase } from 'scule'
+
+// eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+export interface ObjectFactory<T extends Function> {
+ /**
+ * The name of the factory function.
+ * @example 'createUseFetch'
+ */
+ name: string
+ factory: T
+}
+
+/**
+ * Define a factory for a function that should be registered for automatic key injection.
+ * @since 4.2.0
+ * @param factory
+ */
+// eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+export function defineKeyedFunctionFactory<T extends Function> (factory: ObjectFactory<T>): T {
+ const placeholder = function () {
+ if (import.meta.dev) {
+ throw new Error(
+ `[nuxt:compiler] \`${factory.name}\` is a compiler macro that is only usable inside ` +
+ `the directories scanned by the Nuxt compiler as an exported function and imported statically. Learn more: \`https://nuxt.com/docs/4.x/api/composables/${kebabCase(factory.name)}\``,
+ )
+ }
+ throw new Error(`[nuxt] \`${factory.name}\` is a compiler macro and cannot be called at runtime.`)
+ }
+
+ return Object.defineProperty(placeholder, '__nuxt_factory', {
+ enumerable: false,
+ get: () => factory.factory,
+ }) as unknown as T
+}
diff --git a/packages/nuxt/src/compiler/types.ts b/packages/nuxt/src/compiler/types.ts
new file mode 100644
index 000000000000..cd7998f85a9f
--- /dev/null
+++ b/packages/nuxt/src/compiler/types.ts
@@ -0,0 +1,47 @@
+import type { Nuxt } from '@nuxt/schema'
+import type { parseAndWalk } from 'oxc-walker'
+import type { ParsedStaticImport } from 'mlly'
+import type { ParseResult } from 'rolldown/utils'
+
+type Awaitable<T> = T | Promise<T>
+
+export interface ScanPluginHandlerContext {
+ /** The identifier of the file being scanned. (usually the file path) */
+ id: string
+ /** The string contents of the file being scanned. */
+ code: string
+ /** The global Nuxt instance. */
+ nuxt: Nuxt
+ /** A map of auto-imported identifiers to their source module. */
+ autoImportsToSources: Map<string, string>
+}
+
+/** A context object scoped to the current file, shared across all plugins that scan it. */
+export interface ScanPluginHandlerThisContext {
+ /** A shared walk function from `oxc-walker` that re-uses the same AST in all plugins for the same file. */
+ walkParsed: (options: Parameters<typeof parseAndWalk>[2]) => ParseResult | null
+ /** A shared utility to get the parsed static imports that re-uses the same result in all plugins for the same file. */
+ getParsedStaticImports: () => ParsedStaticImport[]
+}
+
+type ScanPluginHandler = (this: ScanPluginHandlerThisContext, ctx: ScanPluginHandlerContext) => Awaitable<void>
+
+type FilterPattern = string | RegExp | Array<string | RegExp>
+type ScanPluginPatternFilter =
+ | { include: FilterPattern, exclude?: FilterPattern }
+ | { include?: FilterPattern, exclude: FilterPattern }
+
+export type ScanPluginFilter<T = string> = ((input: T) => boolean) | ScanPluginPatternFilter
+
+export interface ScanPlugin {
+ name: string
+ filter?: {
+ /** Filter the files by their identifier. */
+ id?: ScanPluginFilter
+ /** Filter the files by their contents. */
+ code?: ScanPluginFilter
+ }
+ scan: ScanPluginHandler
+ /** Called after the scan is complete. */
+ afterScan?: (nuxt: Nuxt) => Awaitable<void>
+}
diff --git a/packages/nuxt/src/compiler/utils.ts b/packages/nuxt/src/compiler/utils.ts
new file mode 100644
index 000000000000..eccde6a08f19
--- /dev/null
+++ b/packages/nuxt/src/compiler/utils.ts
@@ -0,0 +1,48 @@
+import { findStaticImports, parseStaticImport } from 'mlly'
+import type { ParsedStaticImport } from 'mlly'
+import { parseAndWalk, walk } from 'oxc-walker'
+import type { ScanPlugin } from './types.ts'
+import type { ParseResult } from 'rolldown/utils'
+
+/**
+ * Creates a context object for scan plugins scoped to a specific file being scanned.
+ * All plugins scanning this file will share the same context instance.
+ */
+export function createScanPluginContext (code: string, filePath: string) {
+ // create the context for sharing the parse result between plugins
+ let parseResult: ParseResult | null = null
+ let parsedStaticImports: ParsedStaticImport[] | null = null
+
+ const pluginScanThisContext: ThisParameterType<ScanPlugin['scan']> = {
+ walkParsed: (...args) => {
+ if (parseResult) {
+ const options: Parameters<typeof walk>[1] = typeof args[0] === 'function' ? { enter: args[0] } : args[0]
+ walk(parseResult.program, options)
+ return parseResult
+ }
+
+ parseResult = parseAndWalk.call(null, code, filePath, args[0])
+ return parseResult
+ },
+ getParsedStaticImports: () => {
+ if (parsedStaticImports) {
+ return parsedStaticImports
+ }
+
+ const imports = findStaticImports(code)
+ parsedStaticImports = imports.map(i => parseStaticImport(i))
+ return parsedStaticImports
+ },
+ }
+ return pluginScanThisContext
+}
+
+export function matchWithStringOrRegex (value: string, matcher: string | RegExp) {
+ if (typeof matcher === 'string') {
+ return value === matcher
+ } else if (matcher instanceof RegExp) {
+ return matcher.test(value)
+ }
+
+ return false
+}
diff --git a/packages/nuxt/src/components/module.ts b/packages/nuxt/src/components/module.ts
new file mode 100644
index 000000000000..136892500233
--- /dev/null
+++ b/packages/nuxt/src/components/module.ts
@@ -0,0 +1,339 @@
+import { existsSync } from 'node:fs'
+import { isAbsolute, join, normalize, relative, resolve } from 'pathe'
+import { addBuildPlugin, addImportsSources, addPluginTemplate, addTemplate, addTypeTemplate, addVitePlugin, defineNuxtModule, findPath, resolveAlias } from '@nuxt/kit'
+
+import { resolveModulePath } from 'exsolve'
+import { distDir } from '../dirs.ts'
+import { DECLARATION_EXTENSIONS, isDirectorySync, logger } from '../utils.ts'
+import { lazyHydrationMacroPreset } from '../imports/presets.ts'
+import { componentNamesTemplate, componentsDeclarationTemplate, componentsIslandsTemplate, componentsMetadataTemplate, componentsPluginTemplate, componentsTypeTemplate } from './templates.ts'
+import { scanComponents } from './scan.ts'
+
+import { LoaderPlugin } from './plugins/loader.ts'
+import { ComponentsChunkPlugin, IslandsTransformPlugin } from './plugins/islands-transform.ts'
+import { TransformPlugin } from './plugins/transform.ts'
+import { TreeShakeTemplatePlugin } from './plugins/tree-shake.ts'
+import { ComponentNamePlugin } from './plugins/component-names.ts'
+import { LazyHydrationTransformPlugin } from './plugins/lazy-hydration-transform.ts'
+import { LazyHydrationMacroTransformPlugin } from './plugins/lazy-hydration-macro-transform.ts'
+import type { Component, ComponentsDir, ComponentsOptions, NuxtPage } from 'nuxt/schema'
+
+const isPureObjectOrString = (val: unknown): val is object | string => (!Array.isArray(val) && typeof val === 'object') || typeof val === 'string'
+const SLASH_SEPARATOR_RE = /[\\/]/
+/**
+ * Compare two directory entries by the number of path segments.
+ *
+ * Returns a sort comparator value based on the count of path segments (split on slashes). Deeper (more segments) paths are ordered before shallower ones.
+ *
+ * @param dirA - First directory
+ * @param dirA.path - Path string
+ * @param dirB - Second directory
+ * @param dirB.path - Path string
+ * @returns A negative number if the first directory should come before the second, positive if after, or 0 if equal
+ */
+function compareDirByPathLength ({ path: pathA }: { path: string }, { path: pathB }: { path: string }) {
+ return pathB.split(SLASH_SEPARATOR_RE).filter(Boolean).length - pathA.split(SLASH_SEPARATOR_RE).filter(Boolean).length
+}
+
+const DEFAULT_COMPONENTS_DIRS_RE = /\/components(?:\/(?:global|islands))?$/
+const STARTER_DOT_RE = /^\./g
+
+export type getComponentsT = (mode?: 'client' | 'server' | 'all') => Component[]
+
+export default defineNuxtModule<ComponentsOptions>({
+ meta: {
+ name: 'nuxt:components',
+ configKey: 'components',
+ },
+ defaults: {
+ dirs: [],
+ },
+ async setup (moduleOptions, nuxt) {
+ let componentDirs: ComponentsDir[] = []
+ const context = {
+ components: [] as Component[],
+ }
+
+ const getComponents: getComponentsT = (mode) => {
+ return (mode && mode !== 'all')
+ ? context.components.filter(c => c.mode === mode || c.mode === 'all' || (c.mode === 'server' && !context.components.some(otherComponent => otherComponent.mode !== 'server' && otherComponent.pascalName === c.pascalName)))
+ : context.components
+ }
+
+ // TODO: remove in Nuxt v5
+ if (nuxt.options.experimental.normalizeComponentNames) {
+ addBuildPlugin(ComponentNamePlugin({ getComponents }))
+ }
+
+ // Resolve dirs
+ nuxt.hook('app:resolve', async () => {
+ // components/ dirs from all layers
+ const allDirs: ComponentsDir[] = []
+ const layerCount = nuxt.options._layers.length
+ for (const [i, layer] of nuxt.options._layers.entries()) {
+ // Assign priority based on layer position: lower index = higher priority
+ // This ensures correct override order: root > auto-scanned > extends layers
+ const priority = layerCount - i
+ const layerDirs = normalizeDirs(layer.config.components, layer.config.srcDir, { priority })
+ allDirs.push(...layerDirs)
+ }
+
+ await nuxt.callHook('components:dirs', allDirs)
+
+ const userComponentDirs: ComponentsDir[] = []
+ const libraryComponentDirs: ComponentsDir[] = []
+
+ for (const dir of allDirs) {
+ if (!isPureObjectOrString(dir)) {
+ continue
+ }
+
+ const dirOptions = typeof dir === 'object' ? dir : { path: dir }
+ const dirPath = resolveAlias(dirOptions.path)
+ const extensions = (dirOptions.extensions || nuxt.options.extensions).map(e => e.replace(STARTER_DOT_RE, ''))
+ const _transpile = typeof dirOptions.transpile === 'boolean' ? dirOptions.transpile : 'auto'
+ const transpile = _transpile === 'auto' ? dirPath.includes('node_modules') : _transpile
+ if (transpile) {
+ nuxt.options.build.transpile.push(dirPath)
+ }
+
+ const present = isDirectorySync(dirPath)
+ if (!present && !DEFAULT_COMPONENTS_DIRS_RE.test(dirOptions.path)) {
+ logger.warn('Components directory not found: `' + dirPath + '`')
+ }
+
+ const dirs = dirPath.includes('node_modules') ? libraryComponentDirs : userComponentDirs
+
+ dirs.push({
+ global: moduleOptions.global,
+ ...dirOptions,
+ path: dirPath,
+ extensions,
+ pattern: dirOptions.pattern || (extensions.length > 1 ? `**/*.{${extensions.join(',')}}` : `**/*.${extensions[0] || '*'}`),
+ ignore: [
+ '**/*{M,.m,-m}ixin.{js,ts,jsx,tsx}', // ignore mixins
+ `**/*.{${DECLARATION_EXTENSIONS.join(',')},}`, // .d.ts files
+ ...(dirOptions.ignore || []),
+ ],
+ transpile,
+ })
+ }
+
+ componentDirs = [
+ ...userComponentDirs,
+ ...libraryComponentDirs,
+ ]
+ })
+
+ // components.d.ts
+ addTemplate(componentsDeclarationTemplate)
+ // types/components.d.ts
+ addTypeTemplate(componentsTypeTemplate)
+ // components.plugin.mjs
+ addPluginTemplate(componentsPluginTemplate)
+ // component-names.mjs
+ addTemplate(componentNamesTemplate)
+ // components.islands.mjs
+ addTemplate(componentsIslandsTemplate)
+
+ if (moduleOptions.generateMetadata) {
+ addTemplate(componentsMetadataTemplate)
+ }
+
+ const serverComponentRuntime = await findPath(join(distDir, 'components/runtime/server-component')) ?? join(distDir, 'components/runtime/server-component')
+ addBuildPlugin(TransformPlugin(nuxt, { getComponents, serverComponentRuntime, mode: 'server' }), { server: true, client: false })
+ addBuildPlugin(TransformPlugin(nuxt, { getComponents, serverComponentRuntime, mode: 'client' }), { server: false, client: true })
+
+ // Do not prefetch global components chunks
+ nuxt.hook('build:manifest', (manifest) => {
+ const sourceFiles = new Set<string>()
+ for (const c of getComponents()) {
+ if (c.global) {
+ sourceFiles.add(relative(nuxt.options.srcDir, c.filePath))
+ }
+ }
+
+ for (const chunk of Object.values(manifest)) {
+ if (chunk.isEntry) {
+ chunk.dynamicImports = chunk.dynamicImports?.filter(i => !sourceFiles.has(i))
+ }
+ }
+ })
+
+ // Restart dev server when component directories are added/removed
+ const restartEvents = new Set(['addDir', 'unlinkDir'])
+ // const restartPaths
+ nuxt.hook('builder:watch', (event, relativePath) => {
+ if (!restartEvents.has(event)) {
+ return
+ }
+
+ const path = resolve(nuxt.options.srcDir, relativePath)
+ if (componentDirs.some(dir => dir.path === path)) {
+ logger.info(`Directory \`${relativePath}/\` ${event === 'addDir' ? 'created' : 'removed'}`)
+ return nuxt.callHook('restart')
+ }
+ })
+
+ const serverPlaceholderPath = await findPath(join(distDir, 'app/components/server-placeholder')) ?? join(distDir, 'app/components/server-placeholder')
+
+ // Scan components and add to plugin
+ nuxt.hook('app:templates', async (app) => {
+ const newComponents = await scanComponents(componentDirs, nuxt.options.srcDir!)
+ await nuxt.callHook('components:extend', newComponents)
+ // add server placeholder for .client components server side. issue: #7085
+ for (const component of newComponents) {
+ if (!(component as any /* untyped internal property */)._scanned && !(component.filePath in nuxt.vfs) && isAbsolute(component.filePath) && !existsSync(component.filePath)) {
+ // attempt to resolve component path
+ component.filePath = resolveModulePath(resolveAlias(component.filePath), { try: true, extensions: nuxt.options.extensions }) ?? component.filePath
+ }
+ if (component.mode === 'client' && !newComponents.some(c => c.pascalName === component.pascalName && c.mode === 'server')) {
+ newComponents.push({
+ ...component,
+ _raw: true,
+ mode: 'server',
+ filePath: serverPlaceholderPath,
+ chunkName: 'components/' + component.kebabName,
+ })
+ }
+ if (component.mode === 'server' && !nuxt.options.ssr && !newComponents.some(other => other.pascalName === component.pascalName && other.mode === 'client')) {
+ logger.warn(`Using server components with \`ssr: false\` is not supported with auto-detected component islands. If you need to use server component \`${component.pascalName}\`, set \`experimental.componentIslands\` to \`true\`.`)
+ }
+ }
+ context.components = newComponents
+ app.components = newComponents
+ })
+
+ nuxt.hook('prepare:types', ({ tsConfig }) => {
+ tsConfig.compilerOptions!.paths['#components'] = [resolve(nuxt.options.buildDir, 'components')]
+ })
+
+ addBuildPlugin(TreeShakeTemplatePlugin({ getComponents }), { client: false })
+
+ const clientDelayedComponentRuntime = await findPath(join(distDir, 'components/runtime/lazy-hydrated-component')) ?? join(distDir, 'components/runtime/lazy-hydrated-component')
+
+ const sharedLoaderOptions = {
+ getComponents,
+ clientDelayedComponentRuntime,
+ serverComponentRuntime,
+ srcDir: nuxt.options.srcDir,
+ transform: typeof nuxt.options.components === 'object' && !Array.isArray(nuxt.options.components) ? nuxt.options.components.transform : undefined,
+ experimentalComponentIslands: !!nuxt.options.experimental.componentIslands,
+ }
+
+ addBuildPlugin(LoaderPlugin({ ...sharedLoaderOptions, mode: 'client' }), { server: false })
+ addBuildPlugin(LoaderPlugin({ ...sharedLoaderOptions, mode: 'server' }), { client: false })
+
+ if (nuxt.options.experimental.lazyHydration) {
+ addBuildPlugin(LazyHydrationTransformPlugin({
+ ...sharedLoaderOptions,
+ }), { prepend: true })
+
+ addBuildPlugin(LazyHydrationMacroTransformPlugin({
+ ...sharedLoaderOptions,
+ alias: nuxt.options.alias,
+ }))
+
+ addImportsSources(lazyHydrationMacroPreset)
+ }
+
+ if (nuxt.options.experimental.componentIslands) {
+ const selectiveClient = typeof nuxt.options.experimental.componentIslands === 'object' && nuxt.options.experimental.componentIslands.selectiveClient
+
+ addVitePlugin({
+ name: 'nuxt-server-component-hmr',
+ handleHotUpdate (ctx) {
+ const components = getComponents()
+ const filePath = normalize(ctx.file)
+ const comp = components.find(c => c.filePath === filePath)
+ if (comp?.mode === 'server') {
+ ctx.server.ws.send({
+ event: `nuxt-server-component:${comp.pascalName}`,
+ type: 'custom',
+ })
+ }
+ },
+ }, { server: false })
+
+ function getServerPages (): string[] {
+ const paths: string[] = []
+ function visit (pages: NuxtPage[]) {
+ for (const page of pages) {
+ if (page.mode === 'server' && page.file) {
+ paths.push(normalize(page.file))
+ }
+ if (page.children?.length) { visit(page.children) }
+ }
+ }
+ for (const app of Object.values(nuxt.apps)) {
+ if (app.pages) { visit(app.pages) }
+ }
+ return paths
+ }
+
+ addBuildPlugin(IslandsTransformPlugin({ getComponents, getServerPages, selectiveClient }), { client: false, prepend: true })
+
+ if (selectiveClient && nuxt.options.builder === '@nuxt/vite-builder') {
+ addVitePlugin(() => ComponentsChunkPlugin({ dev: nuxt.options.dev, getComponents }))
+ } else {
+ addTemplate({
+ filename: 'component-chunk.mjs',
+ getContents: () => `export default {}`,
+ })
+ }
+ }
+ },
+})
+
+/**
+ * Normalize the various user-provided `components.dirs` shapes into a flat array of ComponentsDir entries.
+ *
+ * Handles:
+ * - Arrays (recursively flattened and sorted by path depth),
+ * - `true`/`undefined` (returns default islands, global, and components dirs under `cwd`),
+ * - Strings (resolved against `cwd` and alias resolution),
+ * - Objects (either a single dir shape or an object with a `dirs` array).
+ *
+ * Each resulting entry has its `path` resolved via `resolveAlias` and `cwd`, receives a `priority` from `options.priority` (default 0), and entries without a `path` are skipped. The final list is sorted by path depth (shallowest first).
+ *
+ * @param dir - The raw `dirs` configuration value (single entry, array, true/undefined for defaults, or an options object).
+ * @param cwd - Base directory used to resolve relative `path` values.
+ * @param options - Optional settings; currently supports `priority` to assign a priority to all returned entries.
+ * @param options.priority - Priority number to assign to all returned entries (default 0).
+ * @returns A normalized, flat, and sorted array of ComponentsDir objects ready for component scanning.
+ */
+function normalizeDirs (dir: undefined | boolean | ComponentsOptions | ComponentsOptions['dirs'] | ComponentsOptions['dirs'][number], cwd: string, options?: { priority?: number }): ComponentsDir[] {
+ if (Array.isArray(dir)) {
+ return dir.map(dir => normalizeDirs(dir, cwd, options)).flat().sort(compareDirByPathLength)
+ }
+ if (dir === true || dir === undefined) {
+ return [
+ { priority: options?.priority || 0, path: resolve(cwd, 'components/islands'), island: true },
+ { priority: options?.priority || 0, path: resolve(cwd, 'components/global'), global: true },
+ { priority: options?.priority || 0, path: resolve(cwd, 'components') },
+ ]
+ }
+ if (typeof dir === 'string') {
+ return [
+ { priority: options?.priority || 0, path: resolve(cwd, resolveAlias(dir)) },
+ ]
+ }
+ if (!dir) {
+ return []
+ }
+
+ const normalizedDirs: ComponentsDir[] = []
+ for (const d of ('dirs' in dir ? dir.dirs || [] : [dir])) {
+ const normalizedDir = typeof d === 'string' ? { path: d } : d
+ if (!normalizedDir.path) {
+ continue
+ }
+ normalizedDirs.push({
+ priority: options?.priority || 0,
+ ...normalizedDir,
+ path: resolve(cwd, resolveAlias(normalizedDir.path)),
+ })
+ }
+
+ return normalizedDirs.sort(compareDirByPathLength)
+}
diff --git a/packages/nuxt/src/components/plugins/component-names.ts b/packages/nuxt/src/components/plugins/component-names.ts
new file mode 100644
index 000000000000..0228183c8437
--- /dev/null
+++ b/packages/nuxt/src/components/plugins/component-names.ts
@@ -0,0 +1,62 @@
+import { createUnplugin } from 'unplugin'
+import { generateTransform, rolldownString } from 'rolldown-string'
+import { parseAndWalk } from 'oxc-walker'
+
+import { SX_RE, isVue } from '../../core/utils/index.ts'
+import type { Component } from 'nuxt/schema'
+
+interface NameDevPluginOptions {
+ getComponents: () => Component[]
+}
+const FILENAME_RE = /([^/\\]+)\.\w+$/
+/**
+ * Set the default name of components to their PascalCase name
+ */
+export const ComponentNamePlugin = (options: NameDevPluginOptions) => createUnplugin(() => {
+ return {
+ name: 'nuxt:component-name-plugin',
+ enforce: 'post',
+ transformInclude (id) {
+ /* v8 ignore next 2 */
+ return isVue(id) || !!id.match(SX_RE)
+ },
+ transform: {
+ filter: {
+ id: { include: FILENAME_RE },
+ },
+ handler (code, id, meta?: unknown) {
+ const filename = id.match(FILENAME_RE)?.[1]
+ if (!filename) {
+ return
+ }
+ const component = options.getComponents().find(c => c.filePath === id)
+
+ if (!component) {
+ return
+ }
+
+ const NAME_RE = new RegExp(`__name:\\s*['"]${filename}['"]`)
+ const s = rolldownString(code, id, meta)
+ const nameMatch = NAME_RE.exec(code)
+ if (nameMatch) {
+ s.overwrite(nameMatch.index, nameMatch.index + nameMatch[0].length, `__name: ${JSON.stringify(component.pascalName)}`)
+ }
+
+ // Without setup function, vue compiler does not generate __name
+ if (!nameMatch) {
+ parseAndWalk(code, id, function (node) {
+ if (node.type !== 'ExportDefaultDeclaration') {
+ return
+ }
+
+ const { start, end } = node.declaration
+ s.overwrite(start, end, `Object.assign(${code.slice(start, end)}, { __name: ${JSON.stringify(component.pascalName)} })`)
+ this.skip()
+ })
+ }
+
+ return generateTransform(s, id)
+ },
+ },
+ }
+})
diff --git a/packages/nuxt/src/components/plugins/islands-transform.ts b/packages/nuxt/src/components/plugins/islands-transform.ts
new file mode 100644
index 000000000000..59ebdc343f10
--- /dev/null
+++ b/packages/nuxt/src/components/plugins/islands-transform.ts
@@ -0,0 +1,275 @@
+import type { Component } from '@nuxt/schema'
+import { createUnplugin } from 'unplugin'
+import { generateTransform, rolldownString } from 'rolldown-string'
+import { ELEMENT_NODE, parse, walk } from 'ultrahtml'
+import { genObjectFromRawEntries, genString } from 'knitwork'
+import type { Plugin } from 'vite'
+import { normalize } from 'pathe'
+import { isVue, parseModuleId } from '../../core/utils/index.ts'
+
+interface ServerOnlyComponentTransformPluginOptions {
+ getComponents: () => Component[]
+ /**
+ * Returns the resolved file paths of pages that should be rendered as islands
+ * (i.e. `pages/*.server.vue`). These need the same `<slot>` / `nuxt-client`
+ * transform as island components, but they live in the pages registry rather
+ * than the components registry.
+ */
+ getServerPages?: () => string[]
+ /**
+ * allow using `nuxt-client` attribute on components
+ */
+ selectiveClient?: boolean | 'deep'
+}
+
+const SCRIPT_RE = /<script[^>]*>/i
+const SCRIPT_RE_GLOBAL = /<script[^>]*>/gi
+const HAS_SLOT_OR_CLIENT_RE = /<slot[^>]*>|nuxt-client/
+const TEMPLATE_RE = /<template>[\s\S]*<\/template>/
+const NUXTCLIENT_ATTR_RE = /\s:?nuxt-client(?:="[^"]*")?/g
+const IMPORT_CODE = '\nimport { mergeProps as __mergeProps } from \'vue\'' + '\nimport { vforToArray as __vforToArray } from \'#app/components/utils\'' + '\nimport NuxtTeleportIslandComponent from \'#app/components/nuxt-teleport-island-component\'' + '\nimport NuxtTeleportSsrSlot from \'#app/components/nuxt-teleport-island-slot\''
+const EXTRACTED_ATTRS_RE = /v-(?:if|else-if|else)(?:="[^"]*")?/g
+const KEY_RE = /:?key="[^"]"/g
+
+function wrapWithVForDiv (code: string, vfor: string): string {
+ return `<div v-for="${vfor}" style="display: contents;">${code}</div>`
+}
+
+export const IslandsTransformPlugin = (options: ServerOnlyComponentTransformPluginOptions) => createUnplugin((_options, meta) => {
+ const isVite = meta.framework === 'vite'
+ return {
+ name: 'nuxt:server-only-component-transform',
+ enforce: 'pre',
+ transformInclude (id) {
+ if (!isVue(id)) { return false }
+ if (isVite && options.selectiveClient === 'deep') { return true }
+ const { pathname } = parseModuleId(normalize(id))
+ return isIslandFile(pathname, options)
+ },
+ transform: {
+ filter: {
+ code: {
+ include: [HAS_SLOT_OR_CLIENT_RE],
+ },
+ },
+ async handler (code, id, transformMeta?: unknown) {
+ const template = code.match(TEMPLATE_RE)
+ if (!template) { return }
+ const startingIndex = template.index || 0
+ const s = rolldownString(code, id, transformMeta)
+
+ const { pathname } = parseModuleId(normalize(id))
+ const isIsland = isIslandFile(pathname, options)
+
+ if (!SCRIPT_RE.test(code)) {
+ s.prepend('<script setup>' + IMPORT_CODE + '</script>')
+ } else {
+ for (const match of code.matchAll(SCRIPT_RE_GLOBAL)) {
+ s.appendRight(match.index + match[0].length, IMPORT_CODE)
+ }
+ }
+
+ let hasNuxtClient = false
+
+ const ast = parse(template[0])
+ await walk(ast, (node) => {
+ if (node.type !== ELEMENT_NODE) {
+ return
+ }
+ if (node.name === 'slot') {
+ if (!isIsland) { return }
+ const { attributes, children, loc } = node
+
+ const slotName = attributes.name ?? 'default'
+
+ if (attributes.name) { delete attributes.name }
+ if (attributes['v-bind']) {
+ attributes._bind = extractAttributes(attributes, ['v-bind'])['v-bind']!
+ }
+ const teleportAttributes = extractAttributes(attributes, ['v-if', 'v-else-if', 'v-else'])
+ const bindings = getPropsToString(attributes)
+ // add the wrapper
+ s.appendLeft(startingIndex + loc[0].start, `<NuxtTeleportSsrSlot${attributeToString(teleportAttributes)} name="${slotName}" :props="${bindings}">`)
+
+ if (children.length) {
+ // pass slot fallback to NuxtTeleportSsrSlot fallback
+ const attrString = attributeToString(attributes)
+ const slice = code.slice(startingIndex + loc[0].end, startingIndex + loc[1].start).replaceAll(KEY_RE, '')
+ s.overwrite(startingIndex + loc[0].start, startingIndex + loc[1].end, `<slot${attrString.replaceAll(EXTRACTED_ATTRS_RE, '')}/><template #fallback>${attributes['v-for'] ? wrapWithVForDiv(slice, attributes['v-for']) : slice}</template>`)
+ } else {
+ s.overwrite(startingIndex + loc[0].start, startingIndex + loc[0].end, code.slice(startingIndex + loc[0].start, startingIndex + loc[0].end).replaceAll(EXTRACTED_ATTRS_RE, ''))
+ }
+
+ s.appendRight(startingIndex + loc[1].end, '</NuxtTeleportSsrSlot>')
+ return
+ }
+
+ if (node.name === 'NuxtTeleportIslandComponent') {
+ return
+ }
+
+ if (!('nuxt-client' in node.attributes) && !(':nuxt-client' in node.attributes)) {
+ return
+ }
+
+ hasNuxtClient = true
+
+ if (!isVite || !options.selectiveClient) {
+ return
+ }
+
+ const { loc, attributes } = node
+ const attributeValue = attributes[':nuxt-client'] || attributes['nuxt-client'] || 'true'
+ const wrapperAttributes = extractAttributes(attributes, ['v-if', 'v-else-if', 'v-else'])
+
+ let startTag = code.slice(startingIndex + loc[0].start, startingIndex + loc[0].end).replace(NUXTCLIENT_ATTR_RE, '')
+ if (wrapperAttributes) {
+ startTag = startTag.replaceAll(EXTRACTED_ATTRS_RE, '')
+ }
+
+ s.appendLeft(startingIndex + loc[0].start, `<NuxtTeleportIslandComponent${attributeToString(wrapperAttributes)} :nuxt-client="${attributeValue}">`)
+ s.overwrite(startingIndex + loc[0].start, startingIndex + loc[0].end, startTag)
+ s.appendRight(startingIndex + loc[1].end, '</NuxtTeleportIslandComponent>')
+ })
+
+ if (hasNuxtClient) {
+ if (!options.selectiveClient) {
+ console.warn(`The \`nuxt-client\` attribute and client components within islands are only supported when \`experimental.componentIslands.selectiveClient\` is enabled. file: ${id}`)
+ } else if (!isVite) {
+ console.warn(`The \`nuxt-client\` attribute and client components within islands are only supported with Vite. file: ${id}`)
+ }
+ }
+
+ return generateTransform(s, id)
+ },
+ },
+ }
+})
+
+function isIslandFile (pathname: string, options: ServerOnlyComponentTransformPluginOptions): boolean {
+ const components = options.getComponents()
+ const isIslandComponent = components.some(component =>
+ component.filePath === pathname &&
+ (component.island || (component.mode === 'server' && !components.some(c => c.pascalName === component.pascalName && c.mode === 'client'))),
+ )
+ if (isIslandComponent) { return true }
+ return options.getServerPages?.().includes(pathname) ?? false
+}
+
+/**
+ * extract attributes from a node
+ */
+function extractAttributes (attributes: Record<string, string>, names: string[]) {
+ const extracted: Record<string, string> = {}
+ for (const name of names) {
+ if (name in attributes) {
+ extracted[name] = attributes[name]!
+ delete attributes[name]
+ }
+ }
+ return extracted
+}
+
+function attributeToString (attributes: Record<string, string>) {
+ return Object.entries(attributes).map(([name, value]) => value ? ` ${name}="${value}"` : ` ${name}`).join('')
+}
+
+function isBinding (attr: string): boolean {
+ return attr.startsWith(':')
+}
+
+function getPropsToString (bindings: Record<string, string>): string {
+ const vfor = bindings['v-for']?.split(' in ').map((v: string) => v.trim()) as [string, string] | undefined
+ if (Object.keys(bindings).length === 0) { return 'undefined' }
+ const contentParts: string[] = []
+ for (const [name, value] of Object.entries(bindings)) {
+ if (name && (name !== '_bind' && name !== 'v-for')) {
+ contentParts.push(isBinding(name) ? `[\`${name.slice(1)}\`]: ${value}` : `[\`${name}\`]: \`${value}\``)
+ }
+ }
+ const content = contentParts.join(',')
+ const data = bindings._bind ? `__mergeProps(${bindings._bind}, { ${content} })` : `{ ${content} }`
+ if (!vfor) {
+ return `[${data}]`
+ } else {
+ return `__vforToArray(${vfor[1]}).map(${vfor[0]} => (${data}))`
+ }
+}
+
+type ChunkPluginOptions = {
+ dev: boolean
+ getComponents: () => Component[]
+}
+
+const COMPONENT_CHUNK_ID = `#build/component-chunk`
+const COMPONENT_CHUNK_RESOLVED_ID = '\0nuxt-component-chunk'
+
+export const ComponentsChunkPlugin = (options: ChunkPluginOptions): Plugin[] => {
+ const chunkIds = new Map<string, string>()
+ const paths = new Map<string, string>()
+ return [
+ {
+ name: 'nuxt:components-chunk:client',
+ apply: () => !options.dev,
+ applyToEnvironment: environment => environment.name === 'client',
+ buildStart () {
+ for (const c of options.getComponents()) {
+ if (!c.filePath || c.mode === 'server') {
+ continue
+ }
+ chunkIds.set(c.pascalName, this.emitFile({
+ type: 'chunk',
+ name: `${c.pascalName}-chunk.mjs`,
+ id: c.filePath,
+ preserveSignature: 'strict',
+ }))
+ }
+ },
+ generateBundle (_, bundle) {
+ const ids = new Set<string>()
+ for (const [name, id] of chunkIds.entries()) {
+ const filename = this.getFileName(id)
+ ids.add(filename)
+ paths.set(name, filename)
+ }
+ for (const chunk of Object.values(bundle)) {
+ if (chunk.type === 'chunk') {
+ if (ids.has(chunk.fileName)) {
+ chunk.isEntry = false
+ }
+ }
+ }
+ },
+ },
+ {
+ name: 'nuxt:components-chunk:server',
+ resolveId: {
+ order: 'pre',
+ handler (id) {
+ if (id === COMPONENT_CHUNK_ID) {
+ return COMPONENT_CHUNK_RESOLVED_ID
+ }
+ },
+ },
+ load (id) {
+ if (id === COMPONENT_CHUNK_RESOLVED_ID) {
+ if (options.dev) {
+ const filePaths: Record<string, string> = {}
+ for (const c of options.getComponents()) {
+ if (!c.filePath || c.mode === 'server') {
+ continue
+ }
+ filePaths[c.pascalName] = `@fs/${c.filePath}`
+ }
+ return `export default ${genObjectFromRawEntries(Object.entries(filePaths).map(([name, path]) => [name, genString(path)]))}`
+ }
+
+ return `export default ${
+ genObjectFromRawEntries(Array.from(paths.entries())
+ .map(([name, id]) => [name, genString('/' + id)]))
+ }`
+ }
+ },
+ },
+ ]
+}
diff --git a/packages/nuxt/src/components/plugins/lazy-hydration-macro-transform.ts b/packages/nuxt/src/components/plugins/lazy-hydration-macro-transform.ts
new file mode 100644
index 000000000000..5e486a4b3ead
--- /dev/null
+++ b/packages/nuxt/src/components/plugins/lazy-hydration-macro-transform.ts
@@ -0,0 +1,138 @@
+import { createUnplugin } from 'unplugin'
+import { relative } from 'pathe'
+import { resolveAlias } from 'pathe/utils'
+import { generateTransform, rolldownString } from 'rolldown-string'
+import { genImport } from 'knitwork'
+import { isJS, isVue } from '../../core/utils/index.ts'
+import type { ComponentsOptions } from 'nuxt/schema'
+import { parseAndWalk } from 'oxc-walker'
+import type { ESTree } from 'rolldown/utils'
+
+interface LoaderOptions {
+ srcDir: string
+ transform?: ComponentsOptions['transform']
+ clientDelayedComponentRuntime: string
+ alias: Record<string, string>
+}
+
+const LAZY_HYDRATION_MACRO_RE = /\bdefineLazyHydrationComponent\s*\(/
+
+const HYDRATION_TO_FACTORY = new Map<string, string>([
+ ['visible', 'createLazyVisibleComponent'],
+ ['idle', 'createLazyIdleComponent'],
+ ['interaction', 'createLazyInteractionComponent'],
+ ['mediaQuery', 'createLazyMediaQueryComponent'],
+ ['if', 'createLazyIfComponent'],
+ ['time', 'createLazyTimeComponent'],
+ ['never', 'createLazyNeverComponent'],
+])
+
+export const LazyHydrationMacroTransformPlugin = (options: LoaderOptions) => createUnplugin(() => {
+ const exclude = options.transform?.exclude || []
+ const include = options.transform?.include || []
+
+ return {
+ name: 'nuxt:lazy-hydration-macro',
+ enforce: 'post',
+ transformInclude (id) {
+ if (exclude.some(pattern => pattern.test(id))) {
+ return false
+ }
+ if (include.some(pattern => pattern.test(id))) {
+ return true
+ }
+ return isVue(id, { type: ['template', 'script'] }) || isJS(id)
+ },
+
+ transform: {
+ filter: {
+ code: {
+ include: LAZY_HYDRATION_MACRO_RE,
+ },
+ },
+ handler (code, id, meta?: unknown) {
+ const s = rolldownString(code, id, meta)
+ const names = new Set<string>()
+ type Edit = { start: number, end: number, replacement: string }
+ const edits: Edit[] = []
+
+ parseAndWalk(code, id, (node, parent) => {
+ if (node.type !== 'CallExpression') { return }
+ if (node.callee?.type !== 'Identifier') { return }
+ if (node.callee.name !== 'defineLazyHydrationComponent') { return }
+
+ if (parent?.type !== 'VariableDeclarator') { return }
+ if (parent.id.type !== 'Identifier') { return }
+
+ if (node.arguments.length < 2) { return }
+ const [strategyArgument, loaderArgument] = node.arguments
+
+ if (!isStringLiteral(strategyArgument)) { return }
+ const strategy: string = strategyArgument.value
+
+ const functionName = HYDRATION_TO_FACTORY.get(strategy)
+ if (!functionName) { return }
+
+ if (loaderArgument?.type !== 'ArrowFunctionExpression') { return }
+
+ const { importExpression, importLiteral } = findImportExpression(loaderArgument.body)
+ if (!importExpression || !isStringLiteral(importLiteral)) { return }
+
+ const rawPath = importLiteral.value
+ const filePath = resolveAlias(rawPath, options.alias || {})
+ const relativePath = relative(options.srcDir, filePath)
+
+ const originalLoader = code.slice(loaderArgument.start, loaderArgument.end)
+ const replacement = `__${functionName}(${JSON.stringify(relativePath)}, ${originalLoader})`
+
+ edits.push({ start: node.start, end: node.end, replacement })
+ names.add(functionName)
+ })
+
+ for (const edit of edits) {
+ s.overwrite(edit.start, edit.end, edit.replacement)
+ }
+
+ if (names.size) {
+ const imports = genImport(options.clientDelayedComponentRuntime, [...names].map(name => ({ name, as: `__${name}` })))
+ s.prepend(imports)
+ }
+
+ return generateTransform(s, id)
+ },
+ },
+ }
+})
+
+function isStringLiteral (node: ESTree.Argument | undefined) {
+ return !!node && node.type === 'Literal' && typeof node.value === 'string'
+}
+
+function findImportExpression (node: ESTree.Expression | ESTree.FunctionBody): { importExpression?: ESTree.ImportExpression, importLiteral?: ESTree.Expression } {
+ if (node.type === 'ImportExpression') {
+ return { importExpression: node, importLiteral: node.source }
+ }
+ if (node.type === 'BlockStatement') {
+ const returnStmt = node.body.find(stmt => stmt.type === 'ReturnStatement')
+ if (returnStmt && returnStmt.argument) {
+ return findImportExpression(returnStmt.argument)
+ }
+ return {}
+ }
+ if (node.type === 'ParenthesizedExpression') {
+ return findImportExpression(node.expression)
+ }
+ if (node.type === 'AwaitExpression') {
+ return findImportExpression(node.argument)
+ }
+ if (node.type === 'ConditionalExpression') {
+ return findImportExpression(node.consequent) || findImportExpression(node.alternate)
+ }
+ if (node.type === 'MemberExpression') {
+ return findImportExpression(node.object)
+ }
+ if (node.type === 'CallExpression') {
+ return findImportExpression(node.callee)
+ }
+ return {}
+}
diff --git a/packages/nuxt/src/components/plugins/lazy-hydration-transform.ts b/packages/nuxt/src/components/plugins/lazy-hydration-transform.ts
new file mode 100644
index 000000000000..7b9ddc1d220b
--- /dev/null
+++ b/packages/nuxt/src/components/plugins/lazy-hydration-transform.ts
@@ -0,0 +1,131 @@
+import { createUnplugin } from 'unplugin'
+import { generateTransform, rolldownString } from 'rolldown-string'
+import { camelCase, pascalCase } from 'scule'
+
+import { tryUseNuxt } from '@nuxt/kit'
+import { parse, walk } from 'ultrahtml'
+import { ScopeTracker, parseAndWalk } from 'oxc-walker'
+import { isVue } from '../../core/utils/index.ts'
+import { logger, resolveToAlias } from '../../utils.ts'
+import type { Component, ComponentsOptions } from 'nuxt/schema'
+
+interface LoaderOptions {
+ getComponents (): Component[]
+ transform?: ComponentsOptions['transform']
+}
+
+const SCRIPT_RE = /(?<=<script[^>]*>)[\s\S]*?(?=<\/script>)/gi
+const TEMPLATE_RE = /<template>([\s\S]*)<\/template>/
+const hydrationStrategyMap = {
+ hydrateOnIdle: 'Idle',
+ hydrateOnVisible: 'Visible',
+ hydrateOnInteraction: 'Interaction',
+ hydrateOnMediaQuery: 'MediaQuery',
+ hydrateAfter: 'Time',
+ hydrateWhen: 'If',
+ hydrateNever: 'Never',
+}
+
+const TEMPLATE_WITH_LAZY_HYDRATION_RE = /<template>[\s\S]*\b(?:hydrate-on-idle|hydrateOnIdle|hydrate-on-visible|hydrateOnVisible|hydrate-on-interaction|hydrateOnInteraction|hydrate-on-media-query|hydrateOnMediaQuery|hydrate-after|hydrateAfter|hydrate-when|hydrateWhen|hydrate-never|hydrateNever)\b[\s\S]*<\/template>/
+
+export const LazyHydrationTransformPlugin = (options: LoaderOptions) => createUnplugin(() => {
+ const exclude = options.transform?.exclude || []
+ const include = options.transform?.include || []
+ const nuxt = tryUseNuxt()
+
+ return {
+ name: 'nuxt:components-loader-pre',
+ enforce: 'pre',
+ transformInclude (id) {
+ if (exclude.some(pattern => pattern.test(id))) {
+ return false
+ }
+ if (include.some(pattern => pattern.test(id))) {
+ return true
+ }
+ return isVue(id)
+ },
+ transform: {
+ filter: {
+ code: { include: TEMPLATE_WITH_LAZY_HYDRATION_RE },
+ },
+
+ async handler (code, id, meta?: unknown) {
+ // change <LazyMyComponent hydrate-on-idle /> to <LazyIdleMyComponent hydrate-on-idle />
+ const { 0: template, index: offset = 0 } = code.match(TEMPLATE_RE) || {}
+ if (!template) {
+ return
+ }
+ try {
+ const ast = parse(template)
+
+ const scopeTracker = new ScopeTracker({ preserveExitedScopes: true })
+ for (const { 0: script } of code.matchAll(SCRIPT_RE)) {
+ if (!script) { continue }
+ try {
+ parseAndWalk(script, id, { scopeTracker })
+ } catch { /* ignore */ }
+ }
+
+ const s = rolldownString(code, id, meta)
+
+ const components = new Set(options.getComponents().map(c => c.pascalName))
+ await walk(ast, (node) => {
+ if (node.type !== 1 /* ELEMENT_NODE */) {
+ return
+ }
+
+ if (scopeTracker.getDeclaration(node.name)) {
+ return
+ }
+
+ const pascalName = pascalCase(node.name.replace(/^(?:Lazy|lazy-)/, ''))
+ if (!components.has(pascalName)) {
+ // not auto-imported
+ return
+ }
+
+ let strategy: string | undefined
+
+ for (const attr in node.attributes) {
+ const isDynamic = attr.startsWith(':')
+ const prop = camelCase(isDynamic ? attr.slice(1) : attr)
+ if (prop in hydrationStrategyMap) {
+ if (strategy) {
+ logger.warn(`Multiple hydration strategies are not supported in the same component`)
+ } else {
+ strategy = hydrationStrategyMap[prop as keyof typeof hydrationStrategyMap]
+ }
+ }
+ }
+
+ if (strategy && !/^(?:Lazy|lazy-)/.test(node.name)) {
+ if (node.name !== 'template' && (nuxt?.options.dev || nuxt?.options.test)) {
+ const relativePath = resolveToAlias(id, nuxt)
+ logger.warn(`Component \`<${node.name}>\` (used in \`${relativePath}\`) has lazy-hydration props but is not declared as a lazy component.\n` +
+ `Rename it to \`<Lazy${pascalCase(node.name)} />\` or remove the lazy-hydration props to avoid unexpected behavior.`)
+ }
+ return
+ }
+
+ if (strategy) {
+ const newName = 'Lazy' + strategy + pascalName
+ const chunk = template.slice(node.loc[0].start, node.loc.at(-1)!.end)
+ const chunkOffset = node.loc[0].start + offset
+ const { 0: startingChunk, index: startingPoint = 0 } = chunk.match(new RegExp(`<${node.name}[^>]*>`)) || {}
+ s.overwrite(startingPoint + chunkOffset, startingPoint + chunkOffset + startingChunk!.length, startingChunk!.replace(node.name, newName))
+
+ const { 0: endingChunk, index: endingPoint } = chunk.match(new RegExp(`<\\/${node.name}[^>]*>$`)) || {}
+ if (endingChunk && endingPoint) {
+ s.overwrite(endingPoint + chunkOffset, endingPoint + chunkOffset + endingChunk.length, endingChunk.replace(node.name, newName))
+ }
+ }
+ })
+ return generateTransform(s, id)
+ } catch {
+ // ignore errors if it's not html-like
+ }
+ },
+ },
+ }
+})
diff --git a/packages/nuxt/src/components/plugins/loader.ts b/packages/nuxt/src/components/plugins/loader.ts
new file mode 100644
index 000000000000..2274836c400a
--- /dev/null
+++ b/packages/nuxt/src/components/plugins/loader.ts
@@ -0,0 +1,188 @@
+import { createUnplugin } from 'unplugin'
+import { genDynamicImport, genImport } from 'knitwork'
+import { generateTransform, rolldownString } from 'rolldown-string'
+import { pascalCase } from 'scule'
+import { relative } from 'pathe'
+
+import { tryUseNuxt } from '@nuxt/kit'
+import { QUOTE_RE, SX_RE, isVue } from '../../core/utils/index.ts'
+import { installNuxtModule } from '../../core/features.ts'
+import { logger, resolveToAlias } from '../../utils.ts'
+import type { Component, ComponentsOptions } from 'nuxt/schema'
+
+interface LoaderOptions {
+ getComponents (): Component[]
+ mode: 'server' | 'client'
+ srcDir: string
+ serverComponentRuntime: string
+ clientDelayedComponentRuntime: string
+ transform?: ComponentsOptions['transform']
+ experimentalComponentIslands?: boolean
+}
+
+// Match both:
+// 1. _resolveComponent("ComponentName") - Vue's component resolution.
+// `\d*` allows for deduplicated forms (e.g. `_resolveComponent2`) emitted by
+// `@vue/compiler-sfc` when the same helper is imported more than once in a
+// single SFC, which happens when a `<script setup lang="[jt]sx">` block
+// references components from the template (nuxt/nuxt#30929).
+// 2. h(ComponentName, ...) - JSX h() calls with PascalCase component identifiers
+const REPLACE_COMPONENT_TO_DIRECT_IMPORT_RE = /(?<=[\s(=;])_?resolveComponent\d*\s*\(\s*(?<quote>["'`])(?<lazy>lazy-|Lazy(?=[A-Z]))?(?<modifier>Idle|Visible|idle-|visible-|Interaction|interaction-|MediaQuery|media-query-|If|if-|Never|never-|Time|time-)?(?<name>[^'"`]*)\k<quote>[^)]*\)|(?<=\bh\s*\(\s*)(?<hLazy>lazy-|Lazy(?=[A-Z]))?(?<hModifier>Idle|Visible|idle-|visible-|Interaction|interaction-|MediaQuery|media-query-|If|if-|Never|never-|Time|time-)?(?<hName>[A-Z][\w$]*)\b/g
+
+export const LoaderPlugin = (options: LoaderOptions) => createUnplugin(() => {
+ const exclude = options.transform?.exclude || []
+ const include = options.transform?.include || []
+ const nuxt = tryUseNuxt()
+
+ return {
+ name: 'nuxt:components-loader',
+ enforce: 'post',
+ transformInclude (id) {
+ if (exclude.some(pattern => pattern.test(id))) {
+ return false
+ }
+ if (include.some(pattern => pattern.test(id))) {
+ return true
+ }
+ return isVue(id, { type: ['template', 'script'] }) || !!id.match(SX_RE)
+ },
+ transform (code, id, meta?: unknown) {
+ const components = options.getComponents()
+
+ let num = 0
+ const imports = new Set<string>()
+ const map = new Map<Component, string>()
+ const s = rolldownString(code, id, meta)
+ // replace `_resolveComponent("...")` to direct import
+ for (const match of code.matchAll(REPLACE_COMPONENT_TO_DIRECT_IMPORT_RE)) {
+ const groups = match.groups!
+ const lazy = groups.hLazy || groups.lazy
+ const modifier = groups.hModifier || groups.modifier
+ const name = groups.hName || groups.name
+ const normalComponent = findComponent(components, name!, options.mode)
+ const modifierComponent = !normalComponent && modifier ? findComponent(components, modifier + name, options.mode) : null
+ const component = normalComponent || modifierComponent
+
+ if (component) {
+ // TODO: refactor to @nuxt/cli
+ const internalInstall = ((component as any)._internal_install) as string
+ if (internalInstall && nuxt?.options.test === false) {
+ if (!nuxt.options.dev) {
+ throw new Error(`[nuxt] \`${resolveToAlias(id, nuxt)}\` is using \`${component.pascalName}\` which requires \`${internalInstall}\``)
+ }
+ installNuxtModule(internalInstall)
+ }
+ let identifier = map.get(component) || `__nuxt_component_${num++}`
+ map.set(component, identifier)
+
+ const isServerOnly = !component._raw && component.mode === 'server' &&
+ !components.some(c => c.pascalName === component.pascalName && c.mode === 'client')
+ if (isServerOnly) {
+ imports.add(genImport(options.serverComponentRuntime, [{ name: 'createServerComponent' }]))
+ imports.add(`const ${identifier} = createServerComponent(${JSON.stringify(component.pascalName)})`)
+ if (!options.experimentalComponentIslands) {
+ logger.warn(`Standalone server components (\`${name}\`) are not yet supported without enabling \`experimental.componentIslands\`.`)
+ }
+ s.overwrite(match.index, match.index + match[0].length, identifier)
+ continue
+ }
+
+ const isClientOnly = !component._raw && component.mode === 'client'
+ if (isClientOnly) {
+ imports.add(genImport('#app/components/client-only', [{ name: 'createClientOnly' }]))
+ identifier += '_client'
+ }
+
+ if (lazy) {
+ const dynamicImport = `${genDynamicImport(component.filePath, { interopDefault: false })}.then(c => c.${component.export ?? 'default'} || c)`
+ if (modifier && normalComponent) {
+ const relativePath = relative(options.srcDir, component.filePath)
+ switch (modifier) {
+ case 'Visible':
+ case 'visible-':
+ imports.add(genImport(options.clientDelayedComponentRuntime, [{ name: 'createLazyVisibleComponent' }]))
+ identifier += '_lazy_visible'
+ imports.add(`const ${identifier} = createLazyVisibleComponent(${JSON.stringify(relativePath)}, ${dynamicImport})`)
+ break
+ case 'Interaction':
+ case 'interaction-':
+ imports.add(genImport(options.clientDelayedComponentRuntime, [{ name: 'createLazyInteractionComponent' }]))
+ identifier += '_lazy_event'
+ imports.add(`const ${identifier} = createLazyInteractionComponent(${JSON.stringify(relativePath)}, ${dynamicImport})`)
+ break
+ case 'Idle':
+ case 'idle-':
+ imports.add(genImport(options.clientDelayedComponentRuntime, [{ name: 'createLazyIdleComponent' }]))
+ identifier += '_lazy_idle'
+ imports.add(`const ${identifier} = createLazyIdleComponent(${JSON.stringify(relativePath)}, ${dynamicImport})`)
+ break
+ case 'MediaQuery':
+ case 'media-query-':
+ imports.add(genImport(options.clientDelayedComponentRuntime, [{ name: 'createLazyMediaQueryComponent' }]))
+ identifier += '_lazy_media'
+ imports.add(`const ${identifier} = createLazyMediaQueryComponent(${JSON.stringify(relativePath)}, ${dynamicImport})`)
+ break
+ case 'If':
+ case 'if-':
+ imports.add(genImport(options.clientDelayedComponentRuntime, [{ name: 'createLazyIfComponent' }]))
+ identifier += '_lazy_if'
+ imports.add(`const ${identifier} = createLazyIfComponent(${JSON.stringify(relativePath)}, ${dynamicImport})`)
+ break
+ case 'Never':
+ case 'never-':
+ imports.add(genImport(options.clientDelayedComponentRuntime, [{ name: 'createLazyNeverComponent' }]))
+ identifier += '_lazy_never'
+ imports.add(`const ${identifier} = createLazyNeverComponent(${JSON.stringify(relativePath)}, ${dynamicImport})`)
+ break
+ case 'Time':
+ case 'time-':
+ imports.add(genImport(options.clientDelayedComponentRuntime, [{ name: 'createLazyTimeComponent' }]))
+ identifier += '_lazy_time'
+ imports.add(`const ${identifier} = createLazyTimeComponent(${JSON.stringify(relativePath)}, ${dynamicImport})`)
+ break
+ }
+ } else {
+ imports.add(genImport('vue', [{ name: 'defineAsyncComponent', as: '__defineAsyncComponent' }]))
+ identifier += '_lazy'
+ imports.add(`const ${identifier} = __defineAsyncComponent(${dynamicImport}${isClientOnly ? '.then(c => createClientOnly(c))' : ''})`)
+ }
+ } else {
+ imports.add(genImport(component.filePath, [{ name: component._raw ? 'default' : component.export, as: identifier }]))
+
+ if (isClientOnly) {
+ imports.add(`const ${identifier}_wrapped = createClientOnly(${identifier})`)
+ identifier += '_wrapped'
+ }
+ }
+
+ s.overwrite(match.index, match.index + match[0].length, identifier)
+ }
+ }
+
+ if (imports.size) {
+ s.prepend([...imports, ''].join('\n'))
+ }
+
+ return generateTransform(s, id)
+ },
+ }
+})
+
+function findComponent (components: Component[], name: string, mode: LoaderOptions['mode']) {
+ const id = pascalCase(name).replace(QUOTE_RE, '')
+ // Prefer exact match
+ const validModes = new Set(['all', mode, undefined])
+ const component = components.find(component => id === component.pascalName && validModes.has(component.mode))
+ if (component) { return component }
+
+ const otherModeComponent = components.find(component => id === component.pascalName)
+
+ // Render client-only components on the server with <ServerPlaceholder>
+ if (mode === 'server' && otherModeComponent) {
+ return components.find(c => c.pascalName === 'ServerPlaceholder')
+ }
+
+ // Return the other-mode component in all other cases - we'll handle createClientOnly
+ // and createServerComponent above
+ return otherModeComponent
+}
diff --git a/packages/nuxt/src/components/plugins/transform.ts b/packages/nuxt/src/components/plugins/transform.ts
new file mode 100644
index 000000000000..278380aaab12
--- /dev/null
+++ b/packages/nuxt/src/components/plugins/transform.ts
@@ -0,0 +1,161 @@
+import { isObject } from '@vue/shared'
+import { isIgnored } from '@nuxt/kit'
+import type { Import } from 'unimport'
+import { createUnimport } from 'unimport'
+import { createUnplugin } from 'unplugin'
+import { parseModuleId } from '../../core/utils/plugins.ts'
+import { isAbsolute, normalize } from 'pathe'
+import { type PackageJson, readPackage } from 'pkg-types'
+import { genImport } from 'knitwork'
+import type { getComponentsT } from '../module.ts'
+import type { Nuxt } from 'nuxt/schema'
+
+const COMPONENT_QUERY_RE = /[?&]nuxt_component=/
+
+interface TransformPluginOptions {
+ getComponents: getComponentsT
+ mode: 'client' | 'server' | 'all'
+ serverComponentRuntime: string
+}
+
+export function TransformPlugin (nuxt: Nuxt, options: TransformPluginOptions) {
+ const componentUnimport = createUnimport({
+ imports: [
+ {
+ name: 'componentNames',
+ from: '#build/component-names',
+ },
+ ],
+ virtualImports: ['#components'],
+ injectAtEnd: true,
+ })
+
+ const rootDirWithSlash = nuxt.options.rootDir.replace(/\/?$/, '/')
+
+ function getComponentsImports (): Import[] {
+ const components = options.getComponents(options.mode)
+ const clientOrServerModes = new Set(['client', 'server'])
+ return components.flatMap((c): Import[] => {
+ const withMode = (mode: string | undefined) => mode
+ ? `${c.filePath}${c.filePath.includes('?') ? '&' : '?'}nuxt_component=${mode}&nuxt_component_name=${c.pascalName}&nuxt_component_export=${c.export || 'default'}`
+ : c.filePath
+
+ const mode = !c._raw && c.mode && clientOrServerModes.has(c.mode) ? c.mode : undefined
+
+ return [
+ {
+ as: c.pascalName,
+ from: withMode(mode),
+ name: c.export || 'default',
+ },
+ {
+ as: 'Lazy' + c.pascalName,
+ from: withMode([mode, 'async'].filter(Boolean).join(',')),
+ name: c.export || 'default',
+ },
+ ]
+ })
+ }
+
+ return createUnplugin(() => [
+ {
+ name: 'nuxt:components:imports-wrapper',
+ enforce: 'post',
+ transformInclude (id) {
+ id = normalize(id)
+ return id.startsWith('virtual:') || id.startsWith('\0virtual:') || id.startsWith(nuxt.options.buildDir) || !isIgnored(id, undefined, nuxt)
+ },
+ transform: {
+ filter: {
+ id: COMPONENT_QUERY_RE,
+ },
+ handler (_code, id) {
+ // Virtual component wrapper
+ const { search } = parseModuleId(id)
+ const params = new URLSearchParams(search)
+ const mode = params.get('nuxt_component')
+ const bare = id.replace(/\?.*/, '')
+ const componentExport = params.get('nuxt_component_export') || 'default'
+ const exportWording = componentExport === 'default' ? 'export default' : `export const ${componentExport} =`
+ if (mode === 'async') {
+ return {
+ code: [
+ 'import { defineAsyncComponent } from "vue"',
+ `${exportWording} defineAsyncComponent(() => import(${JSON.stringify(bare)}).then(r => r[${JSON.stringify(componentExport)}] || r.default || r))`,
+ ].join('\n'),
+ map: null,
+ }
+ } else if (mode === 'client') {
+ return {
+ code: [
+ genImport(bare, [{ name: componentExport, as: '__component' }]),
+ 'import { createClientOnly } from "#app/components/client-only"',
+ `${exportWording} createClientOnly(__component)`,
+ ].join('\n'),
+ map: null,
+ }
+ } else if (mode === 'client,async') {
+ return {
+ code: [
+ 'import { defineAsyncComponent } from "vue"',
+ 'import { createClientOnly } from "#app/components/client-only"',
+ `${exportWording} defineAsyncComponent(() => import(${JSON.stringify(bare)}).then(r => createClientOnly(r[${JSON.stringify(componentExport)}] || r.default || r)))`,
+ ].join('\n'),
+ map: null,
+ }
+ } else if (mode === 'server' || mode === 'server,async') {
+ const name = params.get('nuxt_component_name')
+ return {
+ code: [
+ `import { createServerComponent } from ${JSON.stringify(options.serverComponentRuntime)}`,
+ `${exportWording} createServerComponent(${JSON.stringify(name)})`,
+ ].join('\n'),
+ map: null,
+ }
+ } else {
+ throw new Error(`Unknown component mode: ${mode}, this might be an internal bug of Nuxt.`)
+ }
+ },
+ },
+ },
+ {
+ name: 'nuxt:components:imports-alias',
+ enforce: 'post',
+ transformInclude (id) {
+ id = normalize(id)
+ return id.startsWith('virtual:') || id.startsWith('\0virtual:') || id.startsWith(nuxt.options.buildDir) || !isIgnored(id, undefined, nuxt)
+ },
+ transform: {
+ filter: {
+ code: /#components/,
+ },
+ async handler (code, id) {
+ // If package defines a "#components" import mapping, assume is used internally by the package.
+ if (isAbsolute(id) && (/node_modules[\\/](?!\.virtual)/.test(id) || !id.includes(rootDirWithSlash))) {
+ let pkg: PackageJson | undefined
+ try { pkg = await readPackage(id) } catch { /* ignore */ }
+ if (isObject(pkg) && isObject(pkg.imports) && Object.keys(pkg.imports).some(k => k.includes('#components'))) {
+ return
+ }
+ }
+
+ componentUnimport.modifyDynamicImports((imports) => {
+ imports.length = 0
+ imports.push(...getComponentsImports())
+ return imports
+ })
+
+ const result = await componentUnimport.injectImports(code, id, { autoImport: false, transformVirtualImports: true })
+ if (!result) { return }
+
+ return {
+ code: result.code,
+ map: nuxt.options.sourcemap.server || nuxt.options.sourcemap.client
+ ? result.s.generateMap({ hires: true })
+ : undefined,
+ }
+ },
+ },
+ },
+ ])
+}
diff --git a/packages/nuxt/src/components/plugins/tree-shake.ts b/packages/nuxt/src/components/plugins/tree-shake.ts
new file mode 100644
index 000000000000..3b33315d415c
--- /dev/null
+++ b/packages/nuxt/src/components/plugins/tree-shake.ts
@@ -0,0 +1,279 @@
+import type { RolldownString } from 'rolldown-string'
+import { generateTransform, rolldownString } from 'rolldown-string'
+import { createUnplugin } from 'unplugin'
+import type { Component } from '@nuxt/schema'
+import { resolve } from 'pathe'
+
+import { parseAndWalk, walk } from 'oxc-walker'
+import type { ESTree } from 'rolldown/utils'
+import { distDir } from '../../dirs.ts'
+import { VUE_ID_RE } from '../../core/utils/plugins.ts'
+
+interface TreeShakeTemplatePluginOptions {
+ getComponents (): Component[]
+}
+
+const SSR_RENDER_RE = /ssrRenderComponent/
+const PLACEHOLDER_EXACT_RE = /^(?:fallback|placeholder)$/
+const CLIENT_ONLY_NAME_RE = /^(?:_unref\()?(?:_component_)?(?:Lazy|lazy_)?(?:client_only|ClientOnly\)?)$/
+
+export const TreeShakeTemplatePlugin = (options: TreeShakeTemplatePluginOptions) => createUnplugin(() => {
+ const regexpMap = new WeakMap<Component[], [RegExp, RegExp, string[]]>()
+ return {
+ name: 'nuxt:tree-shake-template',
+ enforce: 'post',
+ transform: {
+ filter: {
+ id: { include: VUE_ID_RE },
+ },
+ handler (code, id, meta?: unknown) {
+ const components = options.getComponents()
+
+ if (!regexpMap.has(components)) {
+ const serverPlaceholderPath = resolve(distDir, 'app/components/server-placeholder')
+ const clientOnlyComponents = components
+ .filter(c => c.mode === 'client' && !components.some(other => other.mode !== 'client' && other.pascalName === c.pascalName && !other.filePath.startsWith(serverPlaceholderPath)))
+ .flatMap(c => [c.pascalName, c.kebabName.replaceAll('-', '_')])
+ .concat(['ClientOnly', 'client_only'])
+
+ regexpMap.set(components, [new RegExp(`(${clientOnlyComponents.join('|')})`), new RegExp(`^(${clientOnlyComponents.map(c => `(?:(?:_unref\\()?(?:_component_)?(?:Lazy|lazy_)?${c}\\)?)`).join('|')})$`), clientOnlyComponents])
+ }
+
+ const s = rolldownString(code, id, meta)
+
+ const [COMPONENTS_RE, COMPONENTS_IDENTIFIERS_RE] = regexpMap.get(components)!
+ if (!COMPONENTS_RE.test(code)) { return }
+
+ const componentsToRemoveSet = new Set<string>()
+
+ // remove client only components or components called in ClientOnly default slot
+ const { program: ast } = parseAndWalk(code, id, (node) => {
+ if (!isSsrRender(node)) {
+ return
+ }
+
+ const [componentCall, _, children] = node.arguments
+ if (!componentCall) { return }
+
+ if (componentCall.type === 'Identifier' || componentCall.type === 'MemberExpression' || componentCall.type === 'CallExpression') {
+ const componentName = getComponentName(node)
+ if (!componentName || !COMPONENTS_IDENTIFIERS_RE.test(componentName) || children?.type !== 'ObjectExpression') { return }
+
+ const isClientOnlyComponent = CLIENT_ONLY_NAME_RE.test(componentName)
+ const slotsToRemove = isClientOnlyComponent ? children.properties.filter(prop => prop.type === 'Property' && prop.key.type === 'Identifier' && !PLACEHOLDER_EXACT_RE.test(prop.key.name)) : children.properties
+
+ for (const slot of slotsToRemove) {
+ s.remove(slot.start, slot.end + 1)
+ const removedCode = `({${code.slice(slot.start, slot.end + 1)}})`
+ const currentState = s.toString()
+
+ parseAndWalk(removedCode, id, (node) => {
+ if (!isSsrRender(node)) { return }
+ const name = getComponentName(node)
+ if (!name) { return }
+
+ // detect if the component is called else where
+ const nameToRemove = isComponentNotCalledInSetup(currentState, id, name)
+ if (nameToRemove) {
+ componentsToRemoveSet.add(nameToRemove)
+ }
+ })
+ }
+ }
+ })
+
+ const componentsToRemove = [...componentsToRemoveSet]
+ const removedNodes = new WeakSet<ESTree.Node>()
+
+ for (const componentName of componentsToRemove) {
+ // remove import declaration if it exists
+ removeImportDeclaration(ast, componentName, s)
+ // remove variable declaration
+ removeVariableDeclarator(ast, componentName, s, removedNodes)
+ // remove from setup return statement
+ removeFromSetupReturn(ast, componentName, s)
+ }
+
+ return generateTransform(s, id)
+ },
+ },
+ }
+})
+
+/**
+ * find and remove all property with the name parameter from the setup return statement and the __returned__ object
+ */
+function removeFromSetupReturn (codeAst: ESTree.Program, name: string, magicString: RolldownString) {
+ let walkedInSetup = false
+ walk(codeAst, {
+ enter (node) {
+ if (walkedInSetup) {
+ this.skip()
+ } else if (node.type === 'Property' && node.key.type === 'Identifier' && node.key.name === 'setup' && (node.value.type === 'FunctionExpression' || node.value.type === 'ArrowFunctionExpression')) {
+ // walk into the setup function
+ walkedInSetup = true
+ if (node.value.body?.type === 'BlockStatement') {
+ const returnStatement = node.value.body.body.find(statement => statement.type === 'ReturnStatement') as ESTree.ReturnStatement
+ if (returnStatement && returnStatement.argument?.type === 'ObjectExpression') {
+ // remove from return statement
+ removePropertyFromObject(returnStatement.argument, name, magicString)
+ }
+
+ // remove from __returned__
+ const variableList = node.value.body.body.filter((statement): statement is ESTree.VariableDeclaration => statement.type === 'VariableDeclaration')
+ const returnedVariableDeclaration = variableList.find(declaration => declaration.declarations[0]?.id.type === 'Identifier' && declaration.declarations[0]?.id.name === '__returned__' && declaration.declarations[0]?.init?.type === 'ObjectExpression')
+ if (returnedVariableDeclaration) {
+ const init = returnedVariableDeclaration.declarations[0]?.init as ESTree.ObjectExpression | undefined
+ if (init) {
+ removePropertyFromObject(init, name, magicString)
+ }
+ }
+ }
+ }
+ },
+ })
+}
+
+/**
+ * remove a property from an object expression
+ */
+function removePropertyFromObject (node: ESTree.ObjectExpression, name: string, magicString: RolldownString) {
+ for (const property of node.properties) {
+ if (property.type === 'Property' && property.key.type === 'Identifier' && property.key.name === name) {
+ magicString.remove(property.start, property.end + 1)
+ return true
+ }
+ }
+ return false
+}
+
+/**
+ * is the node a call expression ssrRenderComponent()
+ */
+function isSsrRender (node: ESTree.Node): node is ESTree.CallExpression {
+ return node.type === 'CallExpression' && node.callee.type === 'Identifier' && SSR_RENDER_RE.test(node.callee.name)
+}
+
+function removeImportDeclaration (ast: ESTree.Program, importName: string, magicString: RolldownString): boolean {
+ for (const node of ast.body) {
+ if (node.type !== 'ImportDeclaration' || !node.specifiers) {
+ continue
+ }
+ const specifierIndex = node.specifiers.findIndex(s => s.local.name === importName)
+ if (specifierIndex > -1) {
+ if (node.specifiers!.length > 1) {
+ const specifier = node.specifiers![specifierIndex]!
+ magicString.remove(specifier.start, specifier.end + 1)
+ node.specifiers!.splice(specifierIndex, 1)
+ } else {
+ magicString.remove(node.start, node.end)
+ }
+ return true
+ }
+ }
+ return false
+}
+
+/**
+ * detect if the component is called else where
+ * ImportDeclarations and VariableDeclarations are ignored
+ * return the name of the component if is not called
+ */
+function isComponentNotCalledInSetup (code: string, id: string, name: string): string | void {
+ if (!name) { return }
+ let found = false
+ parseAndWalk(code, id, function (node) {
+ if ((node.type === 'Property' && node.key.type === 'Identifier' && node.value.type === 'FunctionExpression' && node.key.name === 'setup') || (node.type === 'FunctionDeclaration' && (node.id?.name === '_sfc_ssrRender' || node.id?.name === 'ssrRender'))) {
+ // walk through the setup function node or the ssrRender function
+ walk(node, {
+ enter (node) {
+ if (found || node.type === 'VariableDeclaration') {
+ this.skip()
+ } else if (node.type === 'Identifier' && node.name === name) {
+ found = true
+ } else if (node.type === 'MemberExpression') {
+ // dev only with $setup or _ctx
+ found = (node.property.type === 'Literal' && node.property.value === name) || (node.property.type === 'Identifier' && node.property.name === name)
+ }
+ },
+ })
+ }
+ })
+ if (!found) { return name }
+}
+
+/**
+ * retrieve the component identifier being used on ssrRender callExpression
+ * @param ssrRenderNode - ssrRender callExpression
+ */
+function getComponentName (ssrRenderNode: ESTree.CallExpression): string | undefined {
+ const componentCall = ssrRenderNode.arguments[0]
+ if (!componentCall) { return }
+
+ if (componentCall.type === 'Identifier') {
+ return componentCall.name
+ } else if (componentCall.type === 'MemberExpression') {
+ if (componentCall.property.type === 'Literal') {
+ return componentCall.property.value as string
+ }
+ } else if (componentCall.type === 'CallExpression') {
+ return getComponentName(componentCall)
+ }
+}
+
+/**
+ * remove a variable declaration within the code
+ */
+function removeVariableDeclarator (codeAst: ESTree.Program, name: string, magicString: RolldownString, removedNodes: WeakSet<ESTree.Node>): ESTree.Node | void {
+ // remove variables
+ walk(codeAst, {
+ enter (node) {
+ if (node.type !== 'VariableDeclaration') { return }
+ for (const declarator of node.declarations) {
+ const toRemove = findMatchingPatternToRemove(declarator.id, node, name, removedNodes)
+ if (toRemove) {
+ magicString.remove(toRemove.start, toRemove.end + 1)
+ removedNodes.add(toRemove)
+ }
+ }
+ },
+ })
+}
+
+/**
+ * find the Pattern to remove which the identifier is equal to the name parameter.
+ */
+function findMatchingPatternToRemove (node: ESTree.BindingPattern, toRemoveIfMatched: ESTree.Node, name: string, removedNodeSet: WeakSet<ESTree.Node>): ESTree.Node | undefined {
+ if (node.type === 'Identifier') {
+ if (node.name === name) {
+ return toRemoveIfMatched
+ }
+ } else if (node.type === 'ArrayPattern') {
+ const elements = node.elements.filter((e): e is ESTree.BindingPattern => e !== null && !removedNodeSet.has(e))
+
+ for (const element of elements) {
+ const matched = findMatchingPatternToRemove(element, elements.length > 1 ? element : toRemoveIfMatched, name, removedNodeSet)
+ if (matched) { return matched }
+ }
+ } else if (node.type === 'ObjectPattern') {
+ const properties = node.properties.filter((e): e is ESTree.BindingProperty => e.type === 'Property' && !removedNodeSet.has(e))
+
+ for (const [index, property] of properties.entries()) {
+ let nodeToRemove: ESTree.Node = property
+ if (properties.length < 2) {
+ nodeToRemove = toRemoveIfMatched
+ }
+
+ const matched = findMatchingPatternToRemove(property.value, nodeToRemove, name, removedNodeSet)
+ if (matched) {
+ if (matched === property) {
+ properties.splice(index, 1)
+ }
+ return matched
+ }
+ }
+ } else if (node.type === 'AssignmentPattern') {
+ const matched = findMatchingPatternToRemove(node.left, toRemoveIfMatched, name, removedNodeSet)
+ if (matched) { return matched }
+ }
+}
diff --git a/packages/nuxt/src/components/runtime/client-component.ts b/packages/nuxt/src/components/runtime/client-component.ts
new file mode 100644
index 000000000000..49967a0d69fd
--- /dev/null
+++ b/packages/nuxt/src/components/runtime/client-component.ts
@@ -0,0 +1,86 @@
+import { createCommentVNode, getCurrentInstance, h, onMounted, provide, shallowRef } from 'vue'
+import type { AsyncComponentLoader, Component, ComponentOptions } from 'vue'
+import { isPromise } from '@vue/shared'
+import { useNuxtApp } from '#app/nuxt'
+// @ts-expect-error virtual file
+import { clientNodePlaceholder } from '#build/nuxt.config.mjs'
+import ServerPlaceholder from '#app/components/server-placeholder'
+import { clientOnlySymbol } from '#app/components/client-only'
+
+function createPlaceholder () {
+ return clientNodePlaceholder ? createCommentVNode('placeholder') : h('div')
+}
+
+/* @__NO_SIDE_EFFECTS__ */
+export async function createClientPage (loader: AsyncComponentLoader): Promise<Component> {
+ // vue-router: Write "() => import('./MyPage.vue')" instead of "defineAsyncComponent(() => import('./MyPage.vue'))".
+ const m = await loader()
+ const c = m.default || m
+ if (import.meta.dev) {
+ // mark component as client-only for `definePageMeta`
+ c.__clientOnlyPage = true
+ }
+ return pageToClientOnly(c)
+}
+
+const cache = new WeakMap()
+
+function pageToClientOnly<T extends ComponentOptions> (component: T) {
+ if (import.meta.server) {
+ return ServerPlaceholder
+ }
+
+ if (cache.has(component)) {
+ return cache.get(component)
+ }
+
+ const clone = { ...component }
+
+ if (clone.render) {
+ // override the component render (non script setup component) or dev mode
+ clone.render = (ctx: any, cache: any, $props: any, $setup: any, $data: any, $options: any) => ($setup.mounted$ ?? ctx.mounted$)
+ ? h(component.render?.bind(ctx)(ctx, cache, $props, $setup, $data, $options))
+ : createPlaceholder()
+ } else {
+ // handle runtime-compiler template
+ const placeholderTemplate = clientNodePlaceholder ? '<!--placeholder-->' : '<div></div>'
+ clone.template &&= `
+ <template v-if="mounted$">${component.template}</template>
+ <template v-else>${placeholderTemplate}</template>
+ `
+ }
+
+ clone.setup = (props, ctx) => {
+ const nuxtApp = useNuxtApp()
+ const mounted$ = shallowRef(nuxtApp.isHydrating === false)
+ provide(clientOnlySymbol, true)
+ const vm = getCurrentInstance()
+ if (vm) {
+ vm._nuxtClientOnly = true
+ }
+ onMounted(() => {
+ mounted$.value = true
+ })
+ const setupState = component.setup?.(props, ctx) || {}
+ if (isPromise(setupState)) {
+ return Promise.resolve(setupState).then((setupState: any) => {
+ if (typeof setupState !== 'function') {
+ setupState ||= {}
+ setupState.mounted$ = mounted$
+ return setupState
+ }
+ return (...args: any[]) => (mounted$.value || !nuxtApp.isHydrating) ? h(setupState(...args)) : createPlaceholder()
+ })
+ } else {
+ return typeof setupState === 'function'
+ ? (...args: any[]) => (mounted$.value || !nuxtApp.isHydrating)
+ ? h(setupState(...args))
+ : createPlaceholder()
+ : Object.assign(setupState, { mounted$ })
+ }
+ }
+
+ cache.set(component, clone)
+
+ return clone
+}
diff --git a/packages/nuxt/src/components/runtime/lazy-hydrated-component.ts b/packages/nuxt/src/components/runtime/lazy-hydrated-component.ts
new file mode 100644
index 000000000000..467ada248eb2
--- /dev/null
+++ b/packages/nuxt/src/components/runtime/lazy-hydrated-component.ts
@@ -0,0 +1,136 @@
+import { defineAsyncComponent, defineComponent, h, hydrateOnIdle, hydrateOnInteraction, hydrateOnMediaQuery, hydrateOnVisible, mergeProps } from 'vue'
+import type { AsyncComponentLoader, ComponentObjectPropsOptions, DefineSetupFnComponent, ExtractPropTypes, HydrationStrategy } from 'vue'
+import { useNuxtApp } from '#app/nuxt'
+
+type LazyHydrationEmits = {
+ hydrated: () => void
+}
+
+type LazyComponentFactory<Props extends Record<string, any>> = (id: string, loader: AsyncComponentLoader) => DefineSetupFnComponent<Props, LazyHydrationEmits>
+
+function defineLazyComponent<P extends ComponentObjectPropsOptions, Props extends Record<string, any> = ExtractPropTypes<P>> (props: P, defineStrategy: (props: ExtractPropTypes<P>) => HydrationStrategy | undefined): LazyComponentFactory<Props> {
+ return (id: string, loader: AsyncComponentLoader) => defineComponent({
+ inheritAttrs: false,
+ props,
+ emits: ['hydrated'],
+ setup (props, ctx) {
+ if (import.meta.server) {
+ const nuxtApp = useNuxtApp()
+ nuxtApp.hook('app:rendered', ({ ssrContext }) => {
+ // track lazy hydrated components so prefetch/preload tags are not rendered for them
+ // but keep them in modules so CSS links are still rendered
+ ssrContext!['~lazyHydratedModules'] ||= new Set()
+ ssrContext!['~lazyHydratedModules'].add(id)
+ })
+ }
+ // wrap the async component in a second component to avoid loading the chunk too soon
+ const child = defineAsyncComponent({ loader })
+ const comp = defineAsyncComponent({
+ hydrate: defineStrategy(props as ExtractPropTypes<P>),
+ loader: () => Promise.resolve(child),
+ })
+ const onVnodeMounted = () => { ctx.emit('hydrated') }
+ return () => h(comp, mergeProps(ctx.attrs, { onVnodeMounted }), ctx.slots)
+ },
+ }) as unknown as DefineSetupFnComponent<Props, LazyHydrationEmits>
+}
+
+interface LazyVisibleProps { hydrateOnVisible?: true | IntersectionObserverInit }
+
+/* @__NO_SIDE_EFFECTS__ */
+export const createLazyVisibleComponent: LazyComponentFactory<LazyVisibleProps> = defineLazyComponent({
+ hydrateOnVisible: {
+ type: [Object, Boolean] as unknown as () => true | IntersectionObserverInit,
+ required: false,
+ default: true,
+ },
+},
+props => hydrateOnVisible(props.hydrateOnVisible === true ? undefined : props.hydrateOnVisible),
+)
+
+interface LazyIdleProps { hydrateOnIdle?: true | number }
+
+/* @__NO_SIDE_EFFECTS__ */
+export const createLazyIdleComponent: LazyComponentFactory<LazyIdleProps> = defineLazyComponent({
+ hydrateOnIdle: {
+ type: [Number, Boolean] as unknown as () => true | number,
+ required: false,
+ default: true,
+ },
+},
+props => props.hydrateOnIdle === 0
+ ? undefined /* hydrate immediately */
+ : hydrateOnIdle(props.hydrateOnIdle === true ? undefined : props.hydrateOnIdle),
+)
+
+const defaultInteractionEvents: Array<keyof HTMLElementEventMap> = ['pointerenter', 'click', 'focus']
+
+interface LazyInteractionProps { hydrateOnInteraction?: keyof HTMLElementEventMap | Array<keyof HTMLElementEventMap> | true }
+
+/* @__NO_SIDE_EFFECTS__ */
+export const createLazyInteractionComponent: LazyComponentFactory<LazyInteractionProps> = defineLazyComponent({
+ hydrateOnInteraction: {
+ type: [String, Array] as unknown as () => keyof HTMLElementEventMap | Array<keyof HTMLElementEventMap> | true,
+ required: false,
+ default: (): Array<keyof HTMLElementEventMap> => defaultInteractionEvents,
+ },
+},
+props => hydrateOnInteraction(props.hydrateOnInteraction === true ? defaultInteractionEvents : (props.hydrateOnInteraction || defaultInteractionEvents)),
+)
+
+interface LazyMediaQueryProps { hydrateOnMediaQuery: string }
+
+/* @__NO_SIDE_EFFECTS__ */
+export const createLazyMediaQueryComponent: LazyComponentFactory<LazyMediaQueryProps> = defineLazyComponent({
+ hydrateOnMediaQuery: {
+ type: String as unknown as () => string,
+ required: true,
+ },
+},
+props => hydrateOnMediaQuery(props.hydrateOnMediaQuery),
+)
+
+interface LazyIfProps { hydrateWhen?: boolean }
+
+/* @__NO_SIDE_EFFECTS__ */
+export const createLazyIfComponent: LazyComponentFactory<LazyIfProps> = defineLazyComponent({
+ hydrateWhen: {
+ type: Boolean,
+ default: true,
+ },
+},
+props => props.hydrateWhen
+ ? undefined /* hydrate immediately */
+ : () => {}, /* Vue will trigger the hydration automatically when the prop changes */
+)
+
+interface LazyTimeProps { hydrateAfter: number }
+
+/* @__NO_SIDE_EFFECTS__ */
+export const createLazyTimeComponent: LazyComponentFactory<LazyTimeProps> = defineLazyComponent({
+ hydrateAfter: {
+ type: Number,
+ required: true,
+ },
+},
+props => props.hydrateAfter === 0
+ ? undefined /* hydrate immediately */
+ : (hydrate) => {
+ const id = setTimeout(hydrate, props.hydrateAfter)
+ return () => clearTimeout(id)
+ },
+)
+
+interface LazyNeverProps { hydrateNever?: true }
+
+/* @__NO_SIDE_EFFECTS__ */
+const hydrateNever = (): void => {}
+export const createLazyNeverComponent: LazyComponentFactory<LazyNeverProps> = defineLazyComponent({
+ hydrateNever: {
+ type: Boolean as () => true,
+ required: false,
+ default: true,
+ },
+},
+() => hydrateNever,
+)
diff --git a/packages/nuxt/src/components/runtime/server-component.ts b/packages/nuxt/src/components/runtime/server-component.ts
new file mode 100644
index 000000000000..a4bc2720977b
--- /dev/null
+++ b/packages/nuxt/src/components/runtime/server-component.ts
@@ -0,0 +1,93 @@
+import { defineComponent, getCurrentInstance, h, ref } from 'vue'
+import type { DefineSetupFnComponent } from 'vue'
+import NuxtIsland from '#app/components/nuxt-island'
+import { useRoute } from '#app/composables/router'
+import { isPrerendered } from '#app/composables/payload'
+import { createError, showError } from '#app/composables/error'
+import { useNuxtApp } from '#app/nuxt'
+
+interface ServerComponentProps {
+ lazy?: boolean
+}
+
+type ServerComponentEmits = {
+ error: (error: unknown) => void
+}
+
+type ServerComponentType = DefineSetupFnComponent<ServerComponentProps, ServerComponentEmits>
+type IslandPageType = DefineSetupFnComponent<ServerComponentProps>
+
+/* @__NO_SIDE_EFFECTS__ */
+export const createServerComponent = (name: string): ServerComponentType => {
+ return defineComponent({
+ name,
+ inheritAttrs: false,
+ props: { lazy: Boolean },
+ emits: ['error'],
+ setup (props, { attrs, slots, expose, emit }) {
+ const vm = getCurrentInstance()
+ const islandRef = ref<{ refresh: () => Promise<void> } | null>(null)
+
+ expose({
+ refresh: () => islandRef.value?.refresh(),
+ })
+
+ return () => {
+ return h(NuxtIsland, {
+ name,
+ lazy: props.lazy,
+ props: attrs,
+ scopeId: vm?.vnode.scopeId,
+ ref: islandRef,
+ onError: (err) => {
+ emit('error', err)
+ },
+ }, slots)
+ }
+ },
+ }) as unknown as ServerComponentType
+}
+
+/* @__NO_SIDE_EFFECTS__ */
+export const createIslandPage = (name: string, islandKey?: string): IslandPageType => {
+ const component = defineComponent({
+ name,
+ inheritAttrs: false,
+ props: { lazy: Boolean },
+ async setup (props, { slots, expose }) {
+ const islandRef = ref<{ refresh: () => Promise<void> } | null>(null)
+
+ expose({
+ refresh: () => islandRef.value?.refresh(),
+ })
+ const nuxtApp = useNuxtApp()
+ const route = useRoute()
+ const path = import.meta.client && await isPrerendered(route.path) ? route.path : route.fullPath.replace(/#.*$/, '')
+ return () => {
+ return h('div', [
+ h(NuxtIsland, {
+ name: `page_${name}`,
+ lazy: props.lazy,
+ ref: islandRef,
+ context: { url: path },
+ onError: (e: unknown) => {
+ if (e instanceof Error && e.cause && e.cause instanceof Response) {
+ throw createError({
+ status: e.cause.status,
+ statusText: e.cause.statusText,
+ })
+ }
+ nuxtApp.runWithContext(() => showError(e as Error))
+ },
+ }, slots),
+ ])
+ }
+ },
+ })
+
+ // we use this to validate that a server page is rendering the correct url
+ if (import.meta.server && islandKey) {
+ (component as any).__nuxt_island = islandKey
+ }
+ return component as unknown as IslandPageType
+}
diff --git a/packages/nuxt/src/components/scan.ts b/packages/nuxt/src/components/scan.ts
new file mode 100644
index 000000000000..bdfaf00696ba
--- /dev/null
+++ b/packages/nuxt/src/components/scan.ts
@@ -0,0 +1,180 @@
+import { readdir } from 'node:fs/promises'
+import { basename, dirname, extname, join, relative } from 'pathe'
+import { glob } from 'tinyglobby'
+import { kebabCase, pascalCase, splitByCase } from 'scule'
+import { isIgnored, useNuxt } from '@nuxt/kit'
+import { withTrailingSlash } from 'ufo'
+
+import { QUOTE_RE, resolveComponentNameSegments } from '../core/utils/index.ts'
+import { logger, resolveToAlias } from '../utils.ts'
+import type { Component, ComponentsDir } from 'nuxt/schema'
+
+const ISLAND_RE = /\.island(?:\.global)?$/
+const GLOBAL_RE = /\.global(?:\.island)?$/
+const COMPONENT_MODE_RE = /(?<=\.)(client|server)(?:\.global|\.island)*$/
+const MODE_REPLACEMENT_RE = /(?:\.(?:client|server))?(?:\.global|\.island)*$/
+/**
+ * Scan the components inside different components folders
+ * and return a unique list of components
+ * @param dirs all folders where components are defined
+ * @param srcDir src path of your app
+ * @returns {Promise} Component found promise
+ */
+export async function scanComponents (dirs: ComponentsDir[], srcDir: string): Promise<Component[]> {
+ // All scanned components
+ const components: Component[] = []
+
+ // Keep resolved path to avoid duplicates
+ const filePaths = new Set<string>()
+
+ // All scanned paths
+ const scannedPaths: string[] = []
+
+ for (const dir of dirs) {
+ // A map from resolved path to component name (used for making duplicate warning message)
+ const resolvedNames = new Map<string, string>()
+
+ const files = (await glob(dir.pattern!, { cwd: dir.path, ignore: dir.ignore })).sort()
+
+ // Check if the directory exists (globby will otherwise read it case insensitively on MacOS)
+ if (files.length) {
+ const siblings = new Set(await readdir(dirname(dir.path)).catch(() => [] as string[]))
+ const directory = basename(dir.path)
+ if (!siblings.has(directory)) {
+ const directoryLowerCase = directory.toLowerCase()
+ for (const sibling of siblings) {
+ if (sibling.toLowerCase() === directoryLowerCase) {
+ const nuxt = useNuxt()
+ const original = resolveToAlias(dir.path, nuxt)
+ const corrected = resolveToAlias(join(dirname(dir.path), sibling), nuxt)
+ logger.warn(`Components not scanned from \`${corrected}\`. Did you mean to name the directory \`${original}\` instead?`)
+ break
+ }
+ }
+ }
+ }
+
+ for (const _file of files) {
+ const filePath = join(dir.path, _file)
+
+ if (scannedPaths.find(d => filePath.startsWith(withTrailingSlash(d))) || isIgnored(filePath)) {
+ continue
+ }
+
+ // Avoid duplicate paths
+ if (filePaths.has(filePath)) { continue }
+
+ filePaths.add(filePath)
+
+ /**
+ * Create an array of prefixes base on the prefix config
+ * Empty prefix will be an empty array
+ * @example prefix: 'nuxt' -> ['nuxt']
+ * @example prefix: 'nuxt-test' -> ['nuxt', 'test']
+ */
+ const prefixParts = ([] as string[]).concat(
+ dir.prefix ? splitByCase(dir.prefix) : [],
+ (dir.pathPrefix !== false) ? splitByCase(relative(dir.path, dirname(filePath))) : [],
+ )
+
+ /**
+ * In case we have index as filename the component become the parent path
+ * @example third-components/index.vue -> third-component
+ * if not take the filename
+ * @example third-components/Awesome.vue -> Awesome
+ */
+ let fileName = basename(filePath, extname(filePath))
+
+ const island = ISLAND_RE.test(fileName) || dir.island
+ const global = GLOBAL_RE.test(fileName) || dir.global
+ const mode = island ? 'server' : (fileName.match(COMPONENT_MODE_RE)?.[1] || 'all') as 'client' | 'server' | 'all'
+ fileName = fileName.replace(MODE_REPLACEMENT_RE, '')
+
+ if (fileName.toLowerCase() === 'index') {
+ fileName = dir.pathPrefix === false ? basename(dirname(filePath)) : '' /* inherits from path */
+ }
+
+ const suffix = (mode !== 'all' ? `-${mode}` : '')
+ const componentNameSegments = resolveComponentNameSegments(fileName.replace(QUOTE_RE, ''), prefixParts)
+ const pascalName = pascalCase(componentNameSegments)
+
+ if (LAZY_COMPONENT_NAME_REGEX.test(pascalName)) {
+ logger.warn(`The component \`${pascalName}\` (in \`${filePath}\`) is using the reserved "Lazy" prefix used for dynamic imports, which may cause it to break at runtime.`)
+ }
+
+ if (resolvedNames.has(pascalName + suffix) || resolvedNames.has(pascalName)) {
+ warnAboutDuplicateComponent(pascalName, filePath, resolvedNames.get(pascalName) || resolvedNames.get(pascalName + suffix)!)
+ continue
+ }
+ resolvedNames.set(pascalName + suffix, filePath)
+
+ const kebabName = kebabCase(componentNameSegments)
+ const shortPath = relative(srcDir, filePath)
+ const chunkName = 'components/' + kebabName + suffix
+
+ let component: Component = {
+ // inheritable from directory configuration
+ mode,
+ global,
+ island,
+ prefetch: Boolean(dir.prefetch),
+ preload: Boolean(dir.preload),
+ // specific to the file
+ filePath,
+ declarationPath: filePath,
+ pascalName,
+ kebabName,
+ chunkName,
+ shortPath,
+ export: 'default',
+ // by default, give priority to scanned components
+ priority: dir.priority ?? 1,
+ // @ts-expect-error untyped property
+ _scanned: true,
+ }
+
+ if (typeof dir.extendComponent === 'function') {
+ component = (await dir.extendComponent(component)) || component
+ }
+
+ // Ignore files like `~/components/index.vue` which end up not having a name at all
+ if (!pascalName) {
+ logger.warn(`Component did not resolve to a file name in \`${resolveToAlias(filePath)}\`.`)
+ continue
+ }
+
+ const validModes = new Set(['all', component.mode])
+ const existingComponent = components.find(c => c.pascalName === component.pascalName && validModes.has(c.mode))
+ // Ignore component if component is already defined (with same mode)
+ if (existingComponent) {
+ const existingPriority = existingComponent.priority ?? 0
+ const newPriority = component.priority ?? 0
+
+ // Replace component if priority is higher
+ if (newPriority > existingPriority) {
+ components.splice(components.indexOf(existingComponent), 1, component)
+ }
+ // Warn if a user-defined (or prioritized) component conflicts with a previously scanned component
+ if (newPriority > 0 && newPriority === existingPriority) {
+ warnAboutDuplicateComponent(pascalName, filePath, existingComponent.filePath)
+ }
+
+ continue
+ }
+
+ components.push(component)
+ }
+ scannedPaths.push(dir.path)
+ }
+
+ return components
+}
+
+function warnAboutDuplicateComponent (componentName: string, filePath: string, duplicatePath: string) {
+ logger.warn(`Two component files resolving to the same name \`${componentName}\`:\n` +
+ `\n - ${filePath}` +
+ `\n - ${duplicatePath}`,
+ )
+}
+
+const LAZY_COMPONENT_NAME_REGEX = /^Lazy(?=[A-Z])/
diff --git a/packages/nuxt/src/components/templates.ts b/packages/nuxt/src/components/templates.ts
new file mode 100644
index 000000000000..df01e7d352cd
--- /dev/null
+++ b/packages/nuxt/src/components/templates.ts
@@ -0,0 +1,219 @@
+import { isAbsolute, join, relative, resolve } from 'pathe'
+import { genDynamicImport, genDynamicTypeImport, genObjectKey } from 'knitwork'
+import { hash } from 'ohash'
+import { distDir } from '../dirs.ts'
+import type { NuxtApp, NuxtPluginTemplate, NuxtTemplate } from 'nuxt/schema'
+
+type ImportMagicCommentsOptions = {
+ chunkName: string
+ prefetch?: boolean | number
+ preload?: boolean | number
+}
+
+const createImportMagicComments = (options: ImportMagicCommentsOptions) => {
+ const { chunkName, prefetch, preload } = options
+ return [
+ `webpackChunkName: "${chunkName}"`,
+ prefetch === true || typeof prefetch === 'number' ? `webpackPrefetch: ${prefetch}` : false,
+ preload === true || typeof preload === 'number' ? `webpackPreload: ${preload}` : false,
+ ].filter(Boolean).join(', ')
+}
+
+const emptyComponentsPlugin = `
+import { defineNuxtPlugin } from '#app/nuxt'
+export default defineNuxtPlugin({
+ name: 'nuxt:global-components',
+})
+`
+
+export const componentsPluginTemplate: NuxtPluginTemplate = {
+ filename: 'components.plugin.mjs',
+ getContents ({ app }) {
+ const lazyGlobalComponents = new Set<string>()
+ const syncGlobalComponents = new Set<string>()
+ for (const component of app.components) {
+ if (component.global === 'sync') {
+ syncGlobalComponents.add(component.pascalName)
+ } else if (component.global) {
+ lazyGlobalComponents.add(component.pascalName)
+ }
+ }
+ if (!lazyGlobalComponents.size && !syncGlobalComponents.size) { return emptyComponentsPlugin }
+
+ const lazyComponents = [...lazyGlobalComponents]
+ const syncComponents = [...syncGlobalComponents]
+
+ return `import { defineNuxtPlugin } from '#app/nuxt'
+import { ${[...lazyComponents.map(c => 'Lazy' + c), ...syncComponents].join(', ')} } from '#components'
+const lazyGlobalComponents = [
+ ${lazyComponents.map(c => `["${c}", Lazy${c}]`).join(',\n')},
+ ${syncComponents.map(c => `["${c}", ${c}]`).join(',\n')}
+]
+
+export default defineNuxtPlugin({
+ name: 'nuxt:global-components',
+ setup (nuxtApp) {
+ for (const [name, component] of lazyGlobalComponents) {
+ nuxtApp.vueApp.component(name, component)
+ nuxtApp.vueApp.component('Lazy' + name, component)
+ }
+ }
+})
+`
+ },
+}
+
+export const componentNamesTemplate: NuxtTemplate = {
+ filename: 'component-names.mjs',
+ getContents ({ app }) {
+ const componentNames = new Set<string>()
+ for (const c of app.components) {
+ if (!c.island) {
+ componentNames.add(c.pascalName)
+ }
+ }
+ return `export const componentNames = ${JSON.stringify([...componentNames])}`
+ },
+}
+
+export const componentsIslandsTemplate: NuxtTemplate = {
+ filename: 'components.islands.mjs',
+ getContents ({ app, nuxt }) {
+ if (!nuxt.options.experimental.componentIslands) {
+ return 'export const islandComponents = {}\nexport const pageIslandRoutes = {}'
+ }
+
+ const components = app.components
+ const pages = app.pages
+ const islands = components.filter(component =>
+ component.island ||
+ // .server components without a corresponding .client component will need to be rendered as an island
+ (component.mode === 'server' && !components.some(c => c.pascalName === component.pascalName && c.mode === 'client')),
+ )
+
+ const serverPages = pages?.filter(p => (p.mode === 'server' && p.file && p.name)) || []
+ const pageExports = serverPages.map((p) => {
+ return `"page_${p.name}": defineAsyncComponent(${genDynamicImport(p.file!)}.then(c => c.default || c))`
+ })
+ // map each `page_<name>` to a stable, opaque marker derived from the page's file path.
+ const pageIslandRoutes = serverPages.map((p) => {
+ return ` "page_${p.name}": ${JSON.stringify(hash(relative(nuxt.options.rootDir, p.file!)))}`
+ })
+
+ return [
+ 'import { defineAsyncComponent } from \'vue\'',
+ 'export const islandComponents = import.meta.client ? {} : {',
+ islands.map(
+ (c) => {
+ const exp = c.export === 'default' ? 'c.default || c' : `c['${c.export}']`
+ const comment = createImportMagicComments(c)
+ return ` "${c.pascalName}": defineAsyncComponent(${genDynamicImport(c.filePath, { comment })}.then(c => ${exp}))`
+ },
+ ).concat(pageExports).join(',\n'),
+ '}',
+ 'export const pageIslandRoutes = import.meta.client ? {} : {',
+ pageIslandRoutes.join(',\n'),
+ '}',
+ ].join('\n')
+ },
+}
+
+const NON_VUE_RE = /\b\.(?!vue)\w+$/g
+function resolveComponentTypes (app: NuxtApp, baseDir: string, dynamic: boolean) {
+ const serverPlaceholderPath = resolve(distDir, 'app/components/server-placeholder')
+ const componentTypes: Array<[string, string]> = []
+ for (const c of app.components) {
+ if (c.island) {
+ continue
+ }
+ // Use declarationPath if provided, otherwise fall back to filePath
+ const filePath = c.declarationPath || c.filePath
+ let type = dynamic ? renderDynamicTypeImport(baseDir, filePath, c.export) : renderLegacyTypeImport(baseDir, filePath, c.export)
+
+ if (c.mode === 'server') {
+ if (app.components.some(other => other.pascalName === c.pascalName && other.mode === 'client')) {
+ if (c.filePath.startsWith(serverPlaceholderPath)) {
+ continue
+ }
+ } else {
+ type = `IslandComponent<${type}>`
+ }
+ }
+ componentTypes.push([c.pascalName, type])
+ }
+
+ return componentTypes
+}
+
+function renderDynamicTypeImport (baseDir: string, filePath: string, exportName: string) {
+ return genDynamicTypeImport(isAbsolute(filePath)
+ ? relative(baseDir, filePath).replace(NON_VUE_RE, '')
+ : filePath.replace(NON_VUE_RE, ''), exportName)
+}
+
+// TODO: remove when https://youtrack.jetbrains.com/issue/WEB-76306/ is fixed
+function renderLegacyTypeImport (baseDir: string, filePath: string, exportName: string) {
+ return `typeof ${genDynamicImport(isAbsolute(filePath)
+ ? relative(baseDir, filePath).replace(NON_VUE_RE, '')
+ : filePath.replace(NON_VUE_RE, ''), { wrapper: false })
+ }['${exportName}']`
+}
+
+const islandType = 'type IslandComponent<T> = DefineComponent<{}, {refresh: () => Promise<void>}, {}, {}, {}, {}, {}, {}, {}, {}, {}, {}, SlotsType<{ fallback: { error: unknown } }>> & T'
+const hydrationTypes = `
+type HydrationStrategies = {
+ hydrateOnVisible?: IntersectionObserverInit | true
+ hydrateOnIdle?: number | true
+ hydrateOnInteraction?: keyof HTMLElementEventMap | Array<keyof HTMLElementEventMap> | true
+ hydrateOnMediaQuery?: string
+ hydrateAfter?: number
+ hydrateWhen?: boolean
+ hydrateNever?: true
+}
+type LazyComponent<T> = DefineComponent<HydrationStrategies, {}, {}, {}, {}, {}, {}, { hydrated: () => void }> & T
+`
+export const componentsDeclarationTemplate = {
+ filename: 'components.d.ts' as const,
+ write: true,
+ getContents: ({ app, nuxt }) => {
+ const componentTypes = resolveComponentTypes(app, nuxt.options.buildDir, nuxt.options.experimental.typescriptPlugin)
+ return `
+import type { DefineComponent, SlotsType } from 'vue'
+${nuxt.options.experimental.componentIslands ? islandType : ''}
+${hydrationTypes}
+
+${componentTypes.map(([pascalName, type]) => `export const ${pascalName}: ${type}`).join('\n')}
+${componentTypes.map(([pascalName, type]) => `export const Lazy${pascalName}: LazyComponent<${type}>`).join('\n')}
+
+export const componentNames: string[]
+`
+ },
+} satisfies NuxtTemplate
+
+export const componentsTypeTemplate = {
+ filename: 'types/components.d.ts' as const,
+ getContents: ({ app, nuxt }) => {
+ const componentTypes = resolveComponentTypes(app, join(nuxt.options.buildDir, 'types'), nuxt.options.experimental.typescriptPlugin)
+ return `
+import type { DefineComponent, SlotsType } from 'vue'
+${nuxt.options.experimental.componentIslands ? islandType : ''}
+${hydrationTypes}
+interface _GlobalComponents {
+${componentTypes.map(([pascalName, type]) => ` ${genObjectKey(pascalName)}: ${type}`).join('\n')}
+${componentTypes.map(([pascalName, type]) => ` ${genObjectKey(`Lazy${pascalName}`)}: LazyComponent<${type}>`).join('\n')}
+}
+
+declare module 'vue' {
+ export interface GlobalComponents extends _GlobalComponents { }
+}
+
+export {}
+`
+ },
+} satisfies NuxtTemplate
+
+export const componentsMetadataTemplate: NuxtTemplate = {
+ filename: 'components.json',
+ write: true,
+ getContents: ({ app }) => JSON.stringify(app.components, null, 2),
+}
diff --git a/packages/nuxt/src/core/app.ts b/packages/nuxt/src/core/app.ts
new file mode 100644
index 000000000000..374c974a8ab5
--- /dev/null
+++ b/packages/nuxt/src/core/app.ts
@@ -0,0 +1,300 @@
+import { promises as fsp, mkdirSync, writeFileSync } from 'node:fs'
+import process from 'node:process'
+import { performance } from 'node:perf_hooks'
+import { dirname, join, relative, resolve } from 'pathe'
+import { defu } from 'defu'
+import { findPath, getLayerDirectories, normalizePlugin, normalizeTemplate, resolveFiles, resolvePath } from '@nuxt/kit'
+
+import type { PluginMeta } from 'nuxt/app'
+
+import { logger, resolveToAlias } from '../utils.ts'
+import * as defaultTemplates from './templates.ts'
+import { getNameFromPath, hasSuffix, uniqueBy } from './utils/index.ts'
+import { extractMetadata, orderMap } from './plugins/plugin-metadata.ts'
+import type { Nuxt, NuxtApp, NuxtPlugin, NuxtTemplate, ResolvedNuxtTemplate } from 'nuxt/schema'
+
+export function createApp (nuxt: Nuxt, options: Partial<NuxtApp> = {}): NuxtApp {
+ return defu(options, {
+ dir: nuxt.options.srcDir,
+ extensions: nuxt.options.extensions,
+ plugins: [],
+ components: [],
+ templates: [],
+ } as unknown as NuxtApp) as NuxtApp
+}
+
+const postTemplates = new Set([
+ defaultTemplates.clientPluginTemplate.filename,
+ defaultTemplates.serverPluginTemplate.filename,
+ defaultTemplates.pluginsDeclaration.filename,
+])
+
+export async function generateApp (nuxt: Nuxt, app: NuxtApp, options: { filter?: (template: ResolvedNuxtTemplate<any>) => boolean } = {}) {
+ // Resolve app
+ await resolveApp(nuxt, app)
+
+ // User templates from options.build.templates
+ app.templates = Object.values(defaultTemplates).concat(nuxt.options.build.templates) as NuxtTemplate[]
+
+ // Extend templates with hook
+ await nuxt.callHook('app:templates', app)
+
+ // Normalize templates
+ app.templates = app.templates.map(tmpl => normalizeTemplate(tmpl, nuxt.options.buildDir))
+
+ // compile plugins first as they are needed within the nuxt.vfs
+ // in order to annotate templated plugins
+ const filteredTemplates: Record<'pre' | 'post', Array<ResolvedNuxtTemplate<any>>> = {
+ pre: [],
+ post: [],
+ }
+
+ for (const template of app.templates as Array<ResolvedNuxtTemplate<any>>) {
+ if (options.filter && !options.filter(template)) { continue }
+ const key = template.filename && postTemplates.has(template.filename) ? 'post' : 'pre'
+ filteredTemplates[key].push(template)
+ }
+
+ // Compile templates into vfs
+ const templateContext = { nuxt, app }
+
+ const writes: Array<() => void> = []
+ const dirs = new Set<string>()
+ const changedTemplates: Array<ResolvedNuxtTemplate<any>> = []
+ const FORWARD_SLASH_RE = /\//g
+ async function processTemplate (template: ResolvedNuxtTemplate) {
+ const fullPath = template.dst || resolve(nuxt.options.buildDir, template.filename!)
+ const start = performance.now()
+ const oldContents = nuxt.vfs[fullPath]
+ const contents = await compileTemplate(template, templateContext).catch((e) => {
+ logger.error(`Could not compile template \`${template.filename}\`.`)
+ logger.error(e)
+ throw e
+ })
+
+ template.modified = oldContents !== contents
+ if (template.modified) {
+ nuxt.vfs[fullPath] = contents
+
+ const aliasPath = '#build/' + template.filename
+ nuxt.vfs[aliasPath] = contents
+
+ // In case a non-normalized absolute path is called for on Windows
+ if (process.platform === 'win32') {
+ nuxt.vfs[fullPath.replace(FORWARD_SLASH_RE, '\\')] = contents
+ }
+
+ changedTemplates.push(template)
+ }
+
+ const perf = performance.now() - start
+ const compileTime = Math.round((perf * 100)) / 100
+
+ if ((nuxt.options.debug && nuxt.options.debug.templates) || compileTime > 500) {
+ logger.info(`Compiled \`${template.filename}\` in ${compileTime}ms`)
+ }
+
+ if (template.modified && template.write) {
+ dirs.add(dirname(fullPath))
+ writes.push(() => writeFileSync(fullPath, contents, 'utf8'))
+ }
+ }
+
+ await Promise.allSettled(filteredTemplates.pre.map(processTemplate))
+ await Promise.allSettled(filteredTemplates.post.map(processTemplate))
+
+ // Write template files in single synchronous step to avoid (possible) additional
+ // runtime overhead of cascading HMRs from vite/webpack
+ for (const dir of dirs) {
+ mkdirSync(dir, { recursive: true })
+ }
+ for (const write of writes) {
+ write()
+ }
+
+ if (changedTemplates.length) {
+ await nuxt.callHook('app:templatesGenerated', app, changedTemplates, options)
+ }
+}
+
+/** @internal */
+async function compileTemplate<T> (template: NuxtTemplate<T>, ctx: { nuxt: Nuxt, app: NuxtApp, utils?: unknown }) {
+ delete ctx.utils
+
+ if (template.src) {
+ try {
+ return await fsp.readFile(template.src, 'utf-8')
+ } catch (err) {
+ logger.error(`[nuxt] Error reading template from \`${template.src}\``)
+ throw err
+ }
+ }
+ if (template.getContents) {
+ return template.getContents({ ...ctx, options: template.options! })
+ }
+
+ throw new Error('[nuxt] Invalid template. Templates must have either `src` or `getContents`: ' + JSON.stringify(template))
+}
+
+export async function resolveApp (nuxt: Nuxt, app: NuxtApp) {
+ // resolve layer
+ const layerDirs = getLayerDirectories(nuxt)
+ const reversedLayerDirs = layerDirs.toReversed()
+
+ // Resolve main (app.vue)
+ app.mainComponent ||= await findPath(layerDirs.flatMap(d => [join(d.app, 'App'), join(d.app, 'app')]))
+ app.mainComponent ||= resolve(nuxt.options.appDir, 'components/welcome.vue')
+
+ // Resolve root component
+ app.rootComponent ||= await findPath(['~/app.root', resolve(nuxt.options.appDir, 'components/nuxt-root.vue')])
+
+ // Resolve error component
+ app.errorComponent ||= await findPath(layerDirs.map(d => join(d.app, 'error'))) ?? resolve(nuxt.options.appDir, 'components/nuxt-error-page.vue')
+
+ const extensionGlob = nuxt.options.extensions.join(',')
+
+ // Resolve layouts/ from all config layers
+ const layouts: NuxtApp['layouts'] = {}
+ for (const dirs of layerDirs) {
+ const layoutFiles = await resolveFiles(dirs.appLayouts, `**/*{${extensionGlob}}`)
+ for (const file of layoutFiles) {
+ const name = getNameFromPath(file, dirs.appLayouts)
+ if (!name) {
+ // Ignore files like `~/layouts/index.vue` which end up not having a name at all
+ logger.warn(`No layout name could be resolved for \`${resolveToAlias(file, nuxt)}\`. Bear in mind that \`index\` is ignored for the purpose of creating a layout name.`)
+ continue
+ }
+ layouts[name] ||= { name, file }
+ }
+ }
+
+ // Resolve middleware/ from all config layers, layers first
+ let middleware: NuxtApp['middleware'] = []
+ for (const dirs of reversedLayerDirs) {
+ const middlewareFiles = await resolveFiles(dirs.appMiddleware, [
+ `*{${extensionGlob}}`,
+ `*/index{${extensionGlob}}`,
+ ])
+ for (const file of middlewareFiles) {
+ const name = getNameFromPath(file)
+ if (!name) {
+ // Ignore files like `~/middleware/index.vue` which end up not having a name at all
+ logger.warn(`No middleware name could be resolved for \`${resolveToAlias(file, nuxt)}\`. Bear in mind that \`index\` is ignored for the purpose of creating a middleware name.`)
+ continue
+ }
+ middleware.push({ name, path: file, global: hasSuffix(file, '.global') })
+ }
+ }
+
+ const reversedLayers = nuxt.options._layers.slice().reverse()
+ // Resolve plugins, first extended layers and then base
+ let plugins: NuxtApp['plugins'] = []
+ for (let i = 0; i < reversedLayerDirs.length; i++) {
+ const config = reversedLayers[i]!.config
+ const dirs = reversedLayerDirs[i]!
+ plugins.push(...[
+ ...(config.plugins || []),
+ ...await resolveFiles(dirs.appPlugins, [
+ `*{${extensionGlob}}`,
+ `*/index{${extensionGlob}}`,
+ ]),
+ ].map(plugin => normalizePlugin(plugin as NuxtPlugin)))
+ }
+
+ // Add back plugins not specified in layers or user config
+ for (const p of nuxt.options.plugins.toReversed()) {
+ const plugin = normalizePlugin(p)
+ if (!plugins.some(p => p.src === plugin.src)) {
+ plugins.unshift(plugin)
+ }
+ }
+
+ // Normalize and de-duplicate plugins and middleware
+ middleware = uniqueBy(await resolvePaths(nuxt, middleware.toReversed(), 'path'), 'name').reverse()
+ plugins = uniqueBy(await resolvePaths(nuxt, plugins, 'src'), 'src')
+
+ // Resolve app.config
+ const configs: NuxtApp['configs'] = []
+ for (const dirs of layerDirs) {
+ const appConfigPath = await findPath(join(dirs.app, 'app.config'))
+ if (appConfigPath) {
+ configs.push(appConfigPath)
+ }
+ }
+
+ Object.assign(app, { middleware, plugins, configs, layouts })
+
+ // Extend app
+ await nuxt.callHook('app:resolve', app)
+
+ // Normalize and de-duplicate plugins, middleware and app configs
+ app.middleware = uniqueBy(await resolvePaths(nuxt, app.middleware, 'path'), 'name')
+ app.plugins = uniqueBy(await resolvePaths(nuxt, app.plugins, 'src'), 'src')
+ app.configs = [...new Set(app.configs)]
+}
+
+function resolvePaths<Item extends Record<string, any>> (nuxt: Nuxt, items: Item[], key: { [K in keyof Item]: Item[K] extends string ? K : never }[keyof Item]) {
+ return Promise.all(items.map(async (item) => {
+ if (!item[key]) { return item }
+ return {
+ ...item,
+ [key]: await resolvePath(item[key], {
+ alias: nuxt.options.alias,
+ extensions: nuxt.options.extensions,
+ fallbackToOriginal: true,
+ virtual: true,
+ }),
+ }
+ }))
+}
+
+const IS_TSX = /\.[jt]sx$/
+
+export async function annotatePlugins (nuxt: Nuxt, plugins: NuxtPlugin[]) {
+ const _plugins: Array<NuxtPlugin & Omit<PluginMeta, 'enforce'>> = []
+ for (const plugin of plugins) {
+ try {
+ const code = nuxt.vfs[plugin.src] ?? await fsp.readFile(plugin.src!, 'utf-8')
+ _plugins.push({
+ ...await extractMetadata(code, IS_TSX.test(plugin.src) ? 'tsx' : 'ts'),
+ ...plugin,
+ })
+ } catch (e) {
+ const relativePluginSrc = relative(nuxt.options.rootDir, plugin.src)
+ if ((e as Error).message === 'Invalid plugin metadata') {
+ logger.warn(`Failed to parse static properties from plugin \`${relativePluginSrc}\`, falling back to non-optimized runtime meta. Learn more: https://nuxt.com/docs/4.x/directory-structure/app/plugins#object-syntax-plugins`)
+ } else {
+ logger.warn(`Failed to parse static properties from plugin \`${relativePluginSrc}\`.`, e)
+ }
+ _plugins.push(plugin)
+ }
+ }
+
+ return _plugins.sort((a, b) => (a.order ?? orderMap.default) - (b.order ?? orderMap.default))
+}
+
+export function checkForCircularDependencies (_plugins: Array<NuxtPlugin & Omit<PluginMeta, 'enforce'>>) {
+ const deps: Record<string, string[]> = Object.create(null)
+ const pluginNames = new Set(_plugins.map(plugin => plugin.name))
+ for (const plugin of _plugins) {
+ // Make sure dependency plugins are registered
+ if (plugin.dependsOn && plugin.dependsOn.some(name => !pluginNames.has(name))) {
+ console.error(`Plugin \`${plugin.name}\` depends on \`${plugin.dependsOn.filter(name => !pluginNames.has(name)).join(', ')}\` but they are not registered.`)
+ }
+ // Make graph to detect circular dependencies
+ if (plugin.name) {
+ deps[plugin.name] = plugin.dependsOn || []
+ }
+ }
+ const checkDeps = (name: string, visited: string[] = []): string[] => {
+ if (visited.includes(name)) {
+ console.error(`Circular dependency detected in plugins: ${visited.join(' -> ')} -> ${name}`)
+ return []
+ }
+ visited.push(name)
+ return deps[name]?.length ? deps[name].flatMap(dep => checkDeps(dep, [...visited])) : []
+ }
+ for (const name in deps) {
+ checkDeps(name)
+ }
+}
diff --git a/packages/nuxt/src/core/builder.ts b/packages/nuxt/src/core/builder.ts
new file mode 100644
index 000000000000..89fe3e71433a
--- /dev/null
+++ b/packages/nuxt/src/core/builder.ts
@@ -0,0 +1,356 @@
+import type { EventType } from '@parcel/watcher'
+import type { FSWatcher } from 'chokidar'
+import { watch as chokidarWatch } from 'chokidar'
+import { createIsIgnored, directoryToURL, getLayerDirectories, importModule, isIgnored, useNuxt } from '@nuxt/kit'
+import { debounce } from 'perfect-debounce'
+import { dirname, join, normalize, relative, resolve } from 'pathe'
+
+import { isDirectory, logger } from '../utils.ts'
+import { generateApp as _generateApp, createApp } from './app.ts'
+import { checkForExternalConfigurationFiles } from './external-config-files.ts'
+import { cleanupCaches, getVueHash } from './cache.ts'
+import type { Nuxt, NuxtBuilder, NuxtHooks } from 'nuxt/schema'
+
+export async function build (nuxt: Nuxt): Promise<void> {
+ nuxt._perf?.startPhase('app:generate')
+ const app = createApp(nuxt)
+ nuxt.apps.default = app
+
+ const generateApp = debounce(() => _generateApp(nuxt, app), undefined, { leading: true })
+ await generateApp()
+ nuxt._perf?.endPhase('app:generate')
+
+ const builder = nuxt.options._prepare ? undefined : await resolveBuilder(nuxt)
+
+ if (nuxt.options.dev) {
+ if (nuxt.options.experimental.watcher === 'builder' && builder?.setupWatcher) {
+ await builder.setupWatcher(nuxt)
+ } else {
+ if (nuxt.options.experimental.watcher === 'builder') {
+ logger.warn('`experimental.watcher: "builder"` is set but the active builder does not implement `setupWatcher`. Falling back to the default file watcher.')
+ }
+ watch(nuxt)
+ }
+ nuxt.hook('builder:watch', async (event, relativePath) => {
+ // Unset mainComponent and errorComponent if app or error component is changed
+ if (event === 'add' || event === 'unlink') {
+ const path = resolve(nuxt.options.srcDir, relativePath)
+ for (const dirs of getLayerDirectories(nuxt)) {
+ const relativePath = relative(dirs.app, path)
+ if (/^app\./i.test(relativePath)) {
+ app.mainComponent = undefined
+ break
+ }
+ if (/^error\./i.test(relativePath)) {
+ app.errorComponent = undefined
+ break
+ }
+ }
+ }
+
+ // Recompile app templates
+ await generateApp()
+ })
+ nuxt.hook('builder:generateApp', (options) => {
+ // Bypass debounce if we are selectively invalidating templates
+ if (options) { return _generateApp(nuxt, app, options) }
+ return generateApp()
+ })
+ }
+
+ if (!nuxt.options._prepare && !nuxt.options.dev && nuxt.options.experimental.buildCache) {
+ const { restoreCache, collectCache } = await getVueHash(nuxt)
+ if (await restoreCache()) {
+ await nuxt.callHook('build:done')
+ await nuxt.callHook('close', nuxt)
+ return
+ }
+ nuxt.hooks.hookOnce('nitro:build:before', () => collectCache())
+ nuxt.hooks.hookOnce('close', () => cleanupCaches(nuxt))
+ }
+
+ await nuxt.callHook('build:before')
+ if (nuxt.options._prepare) {
+ nuxt.hook('prepare:types', () => nuxt.close())
+ return
+ }
+
+ if (nuxt.options.dev && !nuxt.options.test) {
+ nuxt.hooks.hookOnce('build:done', () => {
+ checkForExternalConfigurationFiles()
+ .catch(e => logger.warn('Problem checking for external configuration files.', e))
+ })
+ }
+
+ nuxt._perf?.startPhase('build:bundle')
+ await builder?.bundle(nuxt)
+ nuxt._perf?.endPhase('build:bundle')
+
+ // release hooks that will never fire again.
+ if (!nuxt.options.dev && nuxt.options.experimental.clearBuildHooks) {
+ clearBuildHooks(nuxt)
+ }
+
+ // allow GC to reclaim any now-unreferenced bundler memory
+ if (!nuxt.options.dev && typeof globalThis.gc === 'function') {
+ nuxt._perf?.startPhase('build:gc')
+ globalThis.gc()
+ nuxt._perf?.endPhase('build:gc')
+ }
+
+ await nuxt.callHook('build:done')
+
+ if (!nuxt.options.dev) {
+ await nuxt.callHook('close', nuxt)
+ }
+}
+
+const watchEvents: Record<EventType, 'add' | 'addDir' | 'change' | 'unlink' | 'unlinkDir'> = {
+ create: 'add',
+ delete: 'unlink',
+ update: 'change',
+}
+
+async function watch (nuxt: Nuxt) {
+ if (nuxt.options.experimental.watcher === 'parcel') {
+ const success = await createParcelWatcher()
+ if (success) { return }
+ }
+
+ if (nuxt.options.experimental.watcher === 'chokidar') {
+ return createWatcher()
+ }
+
+ return createGranularWatcher()
+}
+
+function createWatcher () {
+ const nuxt = useNuxt()
+ const isIgnored = createIsIgnored(nuxt)
+
+ const layerDirs = getLayerDirectories(nuxt)
+ const paths: string[] = []
+ for (const layer of layerDirs) {
+ paths.push(layer.app)
+ // Only add server if it's not inside app (avoid double-watching)
+ if (!layer.server.startsWith(layer.app.replace(/\/?$/, '/'))) {
+ paths.push(layer.server)
+ }
+ }
+
+ const watcher = chokidarWatch(paths, {
+ ...nuxt.options.watchers.chokidar,
+ ignoreInitial: true,
+ ignored: [isIgnored, /[\\/]node_modules[\\/]/],
+ })
+
+ const restartPaths = new Set<string>()
+ const srcDir = nuxt.options.srcDir.replace(/\/?$/, '/')
+ for (const pattern of nuxt.options.watch) {
+ if (typeof pattern !== 'string') { continue }
+ const path = resolve(nuxt.options.srcDir, pattern)
+ if (!path.startsWith(srcDir)) {
+ restartPaths.add(path)
+ }
+ }
+
+ watcher.add([...restartPaths])
+
+ watcher.on('all', (event, path) => {
+ if (event === 'all' || event === 'ready' || event === 'error' || event === 'raw') {
+ return
+ }
+ nuxt.callHook('builder:watch', event, normalize(path))
+ })
+ nuxt.hook('close', () => watcher?.close())
+}
+
+function createGranularWatcher () {
+ const nuxt = useNuxt()
+ const isIgnored = createIsIgnored(nuxt)
+
+ if (nuxt.options.debug && nuxt.options.debug.watchers) {
+ // eslint-disable-next-line no-console
+ console.time('[nuxt] builder:chokidar:watch')
+ }
+
+ let pending = 0
+
+ const ignoredDirs = new Set([...nuxt.options.modulesDir, nuxt.options.buildDir])
+ const pathsToWatch = resolvePathsToWatch(nuxt)
+ for (const dir of pathsToWatch) {
+ pending++
+ const watcher = chokidarWatch(dir, { ...nuxt.options.watchers.chokidar, ignoreInitial: false, depth: 0, ignored: [isIgnored, /[\\/]node_modules[\\/]/] })
+ const watchers: Record<string, FSWatcher> = {}
+
+ watcher.on('all', (event, path) => {
+ if (event === 'all' || event === 'ready' || event === 'error' || event === 'raw') {
+ return
+ }
+ path = normalize(path)
+ if (!pending) {
+ nuxt.callHook('builder:watch', event, path)
+ }
+ if (event === 'unlinkDir' && path in watchers) {
+ watchers[path]?.close()
+ delete watchers[path]
+ }
+ if (event === 'addDir' && path !== dir && !ignoredDirs.has(path) && !pathsToWatch.has(path) && !(path in watchers) && !isIgnored(path)) {
+ const pathWatcher = watchers[path] = chokidarWatch(path, { ...nuxt.options.watchers.chokidar, ignored: [isIgnored] })
+ pathWatcher.on('all', (event, p) => {
+ if (event === 'all' || event === 'ready' || event === 'error' || event === 'raw') {
+ return
+ }
+ nuxt.callHook('builder:watch', event, normalize(p))
+ })
+ nuxt.hook('close', () => pathWatcher?.close())
+ }
+ })
+ watcher.on('ready', () => {
+ pending--
+ if (nuxt.options.debug && nuxt.options.debug.watchers && !pending) {
+ // eslint-disable-next-line no-console
+ console.timeEnd('[nuxt] builder:chokidar:watch')
+ }
+ })
+ nuxt.hook('close', () => watcher?.close())
+ }
+}
+
+async function createParcelWatcher () {
+ const nuxt = useNuxt()
+ if (nuxt.options.debug && nuxt.options.debug.watchers) {
+ // eslint-disable-next-line no-console
+ console.time('[nuxt] builder:parcel:watch')
+ }
+ try {
+ const { subscribe } = await importModule<typeof import('@parcel/watcher')>('@parcel/watcher', { url: [nuxt.options.rootDir, ...nuxt.options.modulesDir].map(d => directoryToURL(d)) })
+ const pathsToWatch = resolvePathsToWatch(nuxt, { parentDirectories: true })
+ for (const dir of pathsToWatch) {
+ if (!await isDirectory(dir)) { continue }
+ const subscription = await subscribe(dir, (err, events) => {
+ if (err) { return }
+ for (const event of events) {
+ if (isIgnored(event.path)) { continue }
+ nuxt.callHook('builder:watch', watchEvents[event.type], normalize(event.path))
+ }
+ }, {
+ ignore: [
+ ...nuxt.options.ignore,
+ 'node_modules',
+ ],
+ })
+ nuxt.hook('close', () => subscription.unsubscribe())
+ }
+ if (nuxt.options.debug && nuxt.options.debug.watchers) {
+ // eslint-disable-next-line no-console
+ console.timeEnd('[nuxt] builder:parcel:watch')
+ }
+ return true
+ } catch {
+ logger.warn('Falling back to `chokidar-granular` as `@parcel/watcher` cannot be resolved in your project.')
+ return false
+ }
+}
+
+async function resolveBuilder (nuxt: Nuxt): Promise<NuxtBuilder> {
+ const source = typeof nuxt.options.builder === 'string'
+ ? await loadBuilder(nuxt, nuxt.options.builder)
+ : nuxt.options.builder
+
+ // Wrap `bundle` so the `build:error` hook fires for any builder, including
+ // user-supplied ones, without each caller having to remember to do it.
+ return {
+ ...source,
+ async bundle (nuxt) {
+ try {
+ await source.bundle(nuxt)
+ } catch (error: any) {
+ await nuxt.callHook('build:error', error)
+ throw error
+ }
+ },
+ }
+}
+
+async function loadBuilder (nuxt: Nuxt, builder: string): Promise<NuxtBuilder> {
+ try {
+ // prefer our own dependency tree before walking up from rootDir
+ if (builder === '@nuxt/vite-builder') {
+ return await import(builder)
+ }
+ return await importModule(builder, { url: [new URL(import.meta.url), directoryToURL(nuxt.options.rootDir)] })
+ } catch (err: any) {
+ if (builder === '@nuxt/webpack-builder' && err?.toString?.().includes('Cannot find module \'@nuxt/webpack-builder\'')) {
+ throw new Error('Could not load `@nuxt/webpack-builder`. You may need to add it to your project dependencies, following the steps in `https://github.com/nuxt/framework/pull/2812`.', { cause: err })
+ }
+ throw new Error(`Loading \`${builder}\` builder failed. You can read more about the nuxt \`builder\` option at: \`https://nuxt.com/docs/4.x/api/nuxt-config#builder\``, { cause: err })
+ }
+}
+
+const hooksToClear: Array<keyof NuxtHooks> = [
+ // config-phase hooks that fire before the build starts
+ 'vite:extend',
+ 'vite:extendConfig',
+ 'vite:configResolved',
+ 'vite:compiled',
+ 'webpack:config',
+ 'webpack:configResolved',
+ 'webpack:compile',
+ 'webpack:compiled',
+ 'webpack:change',
+ 'webpack:error',
+ 'webpack:done',
+ 'webpack:progress',
+ 'rspack:config',
+ 'rspack:configResolved',
+ 'rspack:compile',
+ 'rspack:compiled',
+ 'rspack:change',
+ 'rspack:error',
+ 'rspack:done',
+ // manifest hook - fires after build
+ 'build:manifest',
+ // builder hooks
+ 'builder:watch',
+ 'builder:generateApp',
+ 'app:templatesGenerated',
+]
+
+function clearBuildHooks (nuxt: Nuxt): void {
+ for (const name of hooksToClear) {
+ nuxt.hooks.clearHook(name)
+ }
+}
+
+function resolvePathsToWatch (nuxt: Nuxt, opts: { parentDirectories?: boolean } = {}): Set<string> {
+ const pathsToWatch = new Set<string>()
+ for (const dirs of getLayerDirectories(nuxt)) {
+ if (!isIgnored(dirs.app)) {
+ pathsToWatch.add(dirs.app)
+ }
+ // Only add server if it's not inside app (avoid double-watching)
+ if (!isIgnored(dirs.server) && !dirs.server.startsWith(dirs.app.replace(/\/?$/, '/'))) {
+ pathsToWatch.add(dirs.server)
+ }
+ }
+ for (const pattern of nuxt.options.watch) {
+ if (typeof pattern !== 'string') { continue }
+ const path = opts?.parentDirectories
+ ? join(dirname(resolve(nuxt.options.srcDir, pattern)), '')
+ : resolve(nuxt.options.srcDir, pattern)
+ let shouldAdd = true
+ for (const w of [...pathsToWatch]) {
+ if (w.startsWith(path)) {
+ pathsToWatch.delete(w)
+ }
+ if (path.startsWith(w)) {
+ shouldAdd = false
+ }
+ }
+ if (shouldAdd) {
+ pathsToWatch.add(path)
+ }
+ }
+ return pathsToWatch
+}
diff --git a/packages/nuxt/src/core/cache.ts b/packages/nuxt/src/core/cache.ts
new file mode 100644
index 000000000000..bb8b95ae9ea8
--- /dev/null
+++ b/packages/nuxt/src/core/cache.ts
@@ -0,0 +1,337 @@
+import { mkdir, open, readFile, stat, unlink, writeFile } from 'node:fs/promises'
+import type { FileHandle } from 'node:fs/promises'
+import { existsSync } from 'node:fs'
+import { createIsIgnored } from '@nuxt/kit'
+import type { Nuxt, NuxtConfig, NuxtConfigLayer } from '@nuxt/schema'
+import { hash, serialize } from 'ohash'
+import { glob } from 'tinyglobby'
+import { consola } from 'consola'
+import { dirname, join, relative, resolve } from 'pathe'
+import { createTar, parseTar } from 'nanotar'
+import type { TarFileInput } from 'nanotar'
+
+export async function getVueHash (nuxt: Nuxt) {
+ const id = 'vue'
+
+ const { hash } = await getHashes(nuxt, {
+ id,
+ cwd: layer => layer.config.srcDir || layer.cwd,
+ patterns: (layer) => {
+ const srcDir = layer.config.srcDir || layer.cwd
+ return [
+ '**',
+ `!${relative(srcDir, layer.config.serverDir || join(layer.cwd, 'server'))}/**`,
+ `!${relative(srcDir, resolve(layer.cwd, layer.config.dir?.public || 'public'))}/**`,
+ '!node_modules/**',
+ '!nuxt.config.*',
+ ]
+ },
+ configOverrides: {
+ buildId: undefined,
+ serverDir: undefined,
+ nitro: undefined,
+ devServer: undefined,
+ runtimeConfig: undefined,
+ logLevel: undefined,
+ devServerHandlers: undefined,
+ devtools: undefined,
+ },
+ })
+
+ const cacheFile = join(getCacheDir(nuxt), id, hash + '.tar')
+ const buildIdCacheFile = cacheFile.replace('.tar', '.buildid')
+
+ return {
+ hash,
+ async collectCache () {
+ const start = Date.now()
+ await writeCache(nuxt.options.buildDir, nuxt.options.buildDir, cacheFile)
+
+ // Cache buildId so it can be restored before modules are initialised on the next build
+ await mkdir(dirname(buildIdCacheFile), { recursive: true })
+ await writeFile(buildIdCacheFile, nuxt.options.buildId)
+
+ const elapsed = Date.now() - start
+ consola.success(`Cached Vue client and server builds in \`${elapsed}ms\`.`)
+ },
+ async restoreCache () {
+ const start = Date.now()
+ const res = await restoreCacheFromFile(nuxt.options.buildDir, cacheFile)
+ const elapsed = Date.now() - start
+ if (res) {
+ consola.success(`Restored Vue client and server builds from cache in \`${elapsed}ms\`.`)
+ }
+ return res
+ },
+ }
+}
+
+/**
+ * Restore cached buildId before modules are initialised.
+ *
+ * Modules and the nitro builder require `buildId`, so we must set
+ * `nuxt.options.buildId` and `nuxt.options.runtimeConfig.app.buildId`
+ * before modules install. This ensures the manifest and all downstream
+ * consumers use the same buildId that was used when the Vue build was cached.
+ */
+export async function restoreCachedBuildId (nuxt: Nuxt) {
+ const { hash } = await getVueHash(nuxt)
+ const cacheDir = getCacheDir(nuxt)
+ const buildIdCacheFile = join(cacheDir, 'vue', hash + '.buildid')
+
+ if (!existsSync(buildIdCacheFile)) {
+ return
+ }
+
+ const cachedBuildId = (await readFile(buildIdCacheFile, 'utf-8')).trim()
+ if (!cachedBuildId || !/^[\w-]+$/.test(cachedBuildId)) {
+ return
+ }
+
+ nuxt.options.buildId = cachedBuildId
+ nuxt.options.runtimeConfig.app.buildId = cachedBuildId
+ consola.debug(`Restored cached buildId: ${cachedBuildId}`)
+}
+
+export async function cleanupCaches (nuxt: Nuxt) {
+ const start = Date.now()
+ const caches = await glob(['*/*.tar', '*/*.buildid'], {
+ cwd: getCacheDir(nuxt),
+ absolute: true,
+ })
+ if (caches.length >= 10) {
+ const cachesWithMeta = await Promise.all(caches.map(async (cache) => {
+ return [cache, await stat(cache).then(r => r.mtime.getTime()).catch(() => 0)] as const
+ }))
+ cachesWithMeta.sort((a, b) => a[1] - b[1])
+ for (const [cache] of cachesWithMeta.slice(0, cachesWithMeta.length - 10)) {
+ await unlink(cache)
+ }
+ const elapsed = Date.now() - start
+ consola.success(`Cleaned up old build caches in \`${elapsed}ms\`.`)
+ }
+}
+
+// internal
+
+type HashSource = { name: string, data: any }
+type Hashes = { hash: string, sources: HashSource[] }
+
+interface GetHashOptions {
+ id: string
+ cwd: (layer: NuxtConfigLayer) => string
+ patterns: (layer: NuxtConfigLayer) => string[]
+ configOverrides: Partial<Record<keyof NuxtConfig, unknown>>
+}
+
+async function getHashes (nuxt: Nuxt, options: GetHashOptions): Promise<Hashes> {
+ if ((nuxt as any)[`_${options.id}BuildHash`]) {
+ return (nuxt as any)[`_${options.id}BuildHash`]
+ }
+
+ const start = Date.now()
+ const hashSources: HashSource[] = []
+
+ // Layers
+ let layerCtr = 0
+ for (const layer of nuxt.options._layers) {
+ if (layer.cwd.includes('node_modules')) { continue }
+
+ const layerName = `layer#${layerCtr++}`
+ hashSources.push({
+ name: `${layerName}:config`,
+ data: serialize({
+ ...layer.config,
+ ...options.configOverrides || {},
+ }),
+ })
+
+ const normalizeFiles = (files: Awaited<ReturnType<typeof readFilesRecursive>>) => files.map(f => ({
+ name: f.name,
+ size: f.attrs?.size,
+ data: hash(f.data),
+ })).sort((a, b) => a.name.localeCompare(b.name))
+
+ const isIgnored = createIsIgnored(nuxt)
+ const sourceFiles = await readFilesRecursive(options.cwd(layer), {
+ shouldIgnore: isIgnored, // TODO: Validate if works with absolute paths
+ cwd: nuxt.options.rootDir,
+ patterns: options.patterns(layer),
+ })
+
+ hashSources.push({
+ name: `${layerName}:src`,
+ data: normalizeFiles(sourceFiles),
+ })
+
+ const rootFiles = await readFilesRecursive(layer.config?.rootDir || layer.cwd, {
+ shouldIgnore: isIgnored, // TODO: Validate if works with absolute paths
+ cwd: nuxt.options.rootDir,
+ patterns: [
+ '.nuxtrc',
+ '.npmrc',
+ 'package.json',
+ 'package-lock.json',
+ 'yarn.lock',
+ 'pnpm-lock.yaml',
+ 'tsconfig.json',
+ 'bun.lock',
+ 'bun.lockb',
+ ],
+ })
+
+ hashSources.push({
+ name: `${layerName}:root`,
+ data: normalizeFiles(rootFiles),
+ })
+ }
+
+ hashSources.sort((a, b) => a.name.localeCompare(b.name))
+
+ const res = ((nuxt as any)[`_${options.id}BuildHash`] = {
+ hash: hash(hashSources),
+ sources: hashSources,
+ })
+
+ const elapsed = Date.now() - start
+ consola.debug(`Computed \`${options.id}\` build hash in \`${elapsed}ms\`.`)
+
+ return res
+}
+
+type FileWithMeta = TarFileInput & {
+ attrs: {
+ mtime: number
+ size: number
+ }
+}
+
+interface ReadFilesRecursiveOptions {
+ shouldIgnore?: (name: string) => boolean
+ patterns: string[]
+ cwd: string
+}
+
+async function readFilesRecursive (dir: string | string[], opts: ReadFilesRecursiveOptions): Promise<FileWithMeta[]> {
+ if (Array.isArray(dir)) {
+ return (await Promise.all(dir.map(d => readFilesRecursive(d, opts)))).flat()
+ }
+
+ const files = await glob(opts.patterns, { cwd: dir })
+
+ const fileEntries = await Promise.all(files.map(async (fileName) => {
+ if (!opts.shouldIgnore?.(fileName)) {
+ const file = await readFileWithMeta(dir, fileName)
+ if (!file) { return }
+ return {
+ ...file,
+ name: relative(opts.cwd, join(dir, file.name)),
+ }
+ }
+ }))
+
+ return fileEntries.filter(Boolean) as FileWithMeta[]
+}
+
+async function readFileWithMeta (dir: string, fileName: string, count = 0): Promise<FileWithMeta | undefined> {
+ let fd: FileHandle | undefined = undefined
+
+ try {
+ fd = await open(resolve(dir, fileName))
+ const stats = await fd.stat()
+
+ if (!stats?.isFile()) { return }
+
+ const mtime = stats.mtime.getTime()
+ const data = await fd.readFile()
+
+ // retry if file has changed during read
+ if ((await fd.stat()).mtime.getTime() !== mtime) {
+ await fd.close()
+ fd = undefined
+ if (count < 5) {
+ return await readFileWithMeta(dir, fileName, count + 1)
+ }
+ console.warn(`Failed to read file \`${fileName}\` as it changed during read.`)
+ return
+ }
+
+ return {
+ name: fileName,
+ data,
+ attrs: {
+ mtime,
+ size: stats.size,
+ },
+ }
+ } catch (err) {
+ console.warn(`Failed to read file \`${fileName}\`:`, err)
+ } finally {
+ await fd?.close()
+ }
+}
+
+async function restoreCacheFromFile (cwd: string, cacheFile: string) {
+ if (!existsSync(cacheFile)) {
+ return false
+ }
+
+ const resolvedCwd = resolve(cwd) + '/'
+ const files = parseTar(await readFile(cacheFile))
+ for (const file of files) {
+ let fd: FileHandle | undefined = undefined
+ try {
+ const filePath = resolve(cwd, file.name)
+
+ // Prevent path traversal attacks
+ if (!filePath.startsWith(resolvedCwd)) {
+ consola.warn(`Skipping unsafe cache path: ${file.name}`)
+ continue
+ }
+
+ await mkdir(dirname(filePath), { recursive: true })
+
+ // Stat before open('w') since it truncates the file
+ const existingStats = await stat(filePath).catch(() => null)
+ const cachedSize = file.data?.byteLength ?? 0
+ if (existingStats?.isFile() && existingStats.size === cachedSize) {
+ const lastModified = Number.parseInt(file.attrs?.mtime?.toString().padEnd(13, '0') || '0')
+ if (existingStats.mtime.getTime() >= lastModified) {
+ consola.debug(`Skipping \`${file.name}\` (up to date or newer than cache)`)
+ continue
+ }
+ }
+
+ fd = await open(filePath, 'w')
+ await fd.writeFile(file.data!)
+ } catch (err) {
+ console.error(err)
+ } finally {
+ await fd?.close()
+ }
+ }
+ return true
+}
+
+async function writeCache (cwd: string, sources: string | string[], cacheFile: string) {
+ const fileEntries = await readFilesRecursive(sources, {
+ patterns: ['**/*', '!analyze/**'],
+ cwd,
+ })
+ const tarData = createTar(fileEntries)
+ await mkdir(dirname(cacheFile), { recursive: true })
+ await writeFile(cacheFile, tarData)
+}
+
+function getCacheDir (nuxt: Nuxt) {
+ let cacheDir = join(nuxt.options.workspaceDir, 'node_modules')
+ if (!existsSync(cacheDir)) {
+ for (const dir of nuxt.options.modulesDir.toSorted((a, b) => a.length - b.length)) {
+ if (existsSync(dir)) {
+ cacheDir = dir
+ break
+ }
+ }
+ }
+ return join(cacheDir, '.cache/nuxt/builds')
+}
diff --git a/packages/nuxt/src/core/external-config-files.ts b/packages/nuxt/src/core/external-config-files.ts
new file mode 100644
index 000000000000..b1dce7e773a5
--- /dev/null
+++ b/packages/nuxt/src/core/external-config-files.ts
@@ -0,0 +1,76 @@
+import { findPath } from '@nuxt/kit'
+import { basename } from 'pathe'
+import { logger } from '../utils.ts'
+
+/**
+ * Check for those external configuration files that are not compatible with Nuxt,
+ * and warns the user about them.
+ * @see {@link https://nuxt.com/docs/4.x/getting-started/configuration#external-configuration-files}
+ */
+export async function checkForExternalConfigurationFiles () {
+ const checkResults = await Promise.all([checkViteConfig(), checkWebpackConfig(), checkNitroConfig(), checkPostCSSConfig()])
+ const warningMessages = checkResults.filter(Boolean) as string[]
+
+ if (!warningMessages.length) {
+ return
+ }
+
+ const foundOneExternalConfig = warningMessages.length === 1
+ if (foundOneExternalConfig) {
+ logger.warn(warningMessages[0])
+ } else {
+ const warningsAsList = warningMessages.map(message => `- ${message}`).join('\n')
+ const warning = `Found multiple external configuration files: \n\n${warningsAsList}`
+ logger.warn(warning)
+ }
+}
+
+function checkViteConfig () {
+ // https://github.com/vitejs/vite/blob/8fe69524d25d45290179175ba9b9956cbce87a91/packages/vite/src/node/constants.ts#L38
+ return checkAndWarnAboutConfigFileExistence({
+ fileName: 'vite.config',
+ extensions: ['.js', '.mjs', '.ts', '.cjs', '.mts', '.cts'],
+ createWarningMessage: foundFile => `Using \`${foundFile}\` is not supported together with Nuxt. Use \`options.vite\` instead. You can read more in \`https://nuxt.com/docs/4.x/api/nuxt-config#vite\`.`,
+ })
+}
+
+function checkWebpackConfig () {
+ // https://webpack.js.org/configuration/configuration-languages/
+ return checkAndWarnAboutConfigFileExistence({
+ fileName: 'webpack.config',
+ extensions: ['.js', '.mjs', '.ts', '.cjs', '.mts', '.cts', 'coffee'],
+ createWarningMessage: foundFile => `Using \`${foundFile}\` is not supported together with Nuxt. Use \`options.webpack\` instead. You can read more in \`https://nuxt.com/docs/4.x/api/nuxt-config#webpack-1\`.`,
+ })
+}
+
+function checkNitroConfig () {
+ // https://nitro.build/config
+ return checkAndWarnAboutConfigFileExistence({
+ fileName: 'nitro.config',
+ extensions: ['.ts', '.mts'],
+ createWarningMessage: foundFile => `Using \`${foundFile}\` is not supported together with Nuxt. Use \`options.nitro\` instead. You can read more in \`https://nuxt.com/docs/4.x/api/nuxt-config#nitro\`.`,
+ })
+}
+
+function checkPostCSSConfig () {
+ return checkAndWarnAboutConfigFileExistence({
+ fileName: 'postcss.config',
+ extensions: ['.js', '.cjs'],
+ createWarningMessage: foundFile => `Using \`${foundFile}\` is not supported together with Nuxt. Use \`options.postcss\` instead. You can read more in \`https://nuxt.com/docs/4.x/api/nuxt-config#postcss\`.`,
+ })
+}
+
+interface CheckAndWarnAboutConfigFileExistenceOptions {
+ fileName: string
+ extensions: string[]
+ createWarningMessage: (foundFile: string) => string
+}
+
+async function checkAndWarnAboutConfigFileExistence (options: CheckAndWarnAboutConfigFileExistenceOptions) {
+ const { fileName, extensions, createWarningMessage } = options
+
+ const configFile = await findPath(fileName, { extensions }).catch(() => null)
+ if (configFile) {
+ return createWarningMessage(basename(configFile))
+ }
+}
diff --git a/packages/nuxt/src/core/features.ts b/packages/nuxt/src/core/features.ts
new file mode 100644
index 000000000000..84b571cb2ca9
--- /dev/null
+++ b/packages/nuxt/src/core/features.ts
@@ -0,0 +1,50 @@
+import { resolvePackageJSON } from 'pkg-types'
+import { useNuxt } from '@nuxt/kit'
+import { isCI, provider } from 'std-env'
+import { logger } from '../utils.ts'
+
+const installPrompts = new Set<string>()
+
+export async function installNuxtModule (name: string, options?: { rootDir?: string, searchPaths?: string[], prompt?: boolean }) {
+ if (installPrompts.has(name)) { return }
+ installPrompts.add(name)
+
+ const nuxt = useNuxt()
+ const rootDir = options?.rootDir || nuxt.options.rootDir
+ const searchPaths = options?.searchPaths || nuxt.options.modulesDir
+
+ for (const parent of searchPaths) {
+ if (await resolvePackageJSON(name, { parent }).catch(() => null)) {
+ return true
+ }
+ }
+
+ logger.info(`Package ${name} is missing`)
+
+ if (isCI) {
+ return false
+ }
+
+ if (options?.prompt === true || (options?.prompt !== false && provider !== 'stackblitz')) {
+ const confirm = await logger.prompt(`Do you want to install ${name} package?`, {
+ type: 'confirm',
+ name: 'confirm',
+ initial: true,
+ })
+
+ if (confirm !== true) {
+ return false
+ }
+ }
+
+ logger.info(`Installing ${name}...`)
+ try {
+ const { runCommand } = await import('@nuxt/cli')
+ await runCommand('module', ['add', name, '--cwd', rootDir])
+ logger.success(`Installed ${name}`)
+ return true
+ } catch (err) {
+ logger.error(err)
+ return false
+ }
+}
diff --git a/packages/nuxt/src/core/modules.ts b/packages/nuxt/src/core/modules.ts
new file mode 100644
index 000000000000..5cb77dcd1585
--- /dev/null
+++ b/packages/nuxt/src/core/modules.ts
@@ -0,0 +1,30 @@
+import { normalizeModuleTranspilePath } from '@nuxt/kit'
+import type { Nuxt } from '@nuxt/schema'
+import escapeStringRegexp from 'escape-string-regexp'
+
+export const addModuleTranspiles = (nuxt: Nuxt) => {
+ // Try to sanitize modules to better match imports
+ const transpile: RegExp[] = []
+ for (const t of nuxt.options.build.transpile) {
+ if (t instanceof Function) {
+ continue
+ }
+ if (typeof t === 'string') {
+ transpile.push(new RegExp(escapeStringRegexp(t)))
+ } else {
+ transpile.push(t)
+ }
+ }
+
+ for (const m of [...nuxt.options.modules, ...nuxt.options._modules]) {
+ const mod = typeof m === 'string' ? m : Array.isArray(m) ? m[0] : m.src
+ if (typeof mod !== 'string') {
+ continue
+ }
+ const path = normalizeModuleTranspilePath(mod)
+ // Automatically add used modules to the transpile
+ if (!transpile.some(t => t.test(path))) {
+ nuxt.options.build.transpile.push(path)
+ }
+ }
+}
diff --git a/packages/nuxt/src/core/nuxt.ts b/packages/nuxt/src/core/nuxt.ts
new file mode 100644
index 000000000000..5054f1163d28
--- /dev/null
+++ b/packages/nuxt/src/core/nuxt.ts
@@ -0,0 +1,1116 @@
+import process from 'node:process'
+import { existsSync } from 'node:fs'
+import { rm } from 'node:fs/promises'
+import { randomUUID } from 'node:crypto'
+import { AsyncLocalStorage } from 'node:async_hooks'
+import { join, normalize, relative, resolve } from 'pathe'
+import { createDebugger, createHooks } from 'hookable'
+import ignore from 'ignore'
+import type { LoadNuxtOptions } from '@nuxt/kit'
+import { addBuildPlugin, addComponent, addPlugin, addPluginTemplate, addRouteMiddleware, addTypeTemplate, addVitePlugin, ensureDependencyInstalled, getLayerDirectories, installModules, loadNuxtConfig, nuxtCtx, resolveFiles, resolveIgnorePatterns, resolveModuleWithOptions, runWithNuxtContext } from '@nuxt/kit'
+import type { PackageJson } from 'pkg-types'
+import { readPackageJSON } from 'pkg-types'
+import { hash } from 'ohash'
+import { consola } from 'consola'
+import onChange from 'on-change'
+import { colors } from 'consola/utils'
+import { formatDate, resolveCompatibilityDatesFromEnv } from 'compatx'
+import type { DateString } from 'compatx'
+import escapeRE from 'escape-string-regexp'
+import { withoutLeadingSlash } from 'ufo'
+import { ImpoundPlugin } from 'impound'
+import { defu } from 'defu'
+import { coerce, satisfies } from 'semver'
+import { hasTTY, isCI } from 'std-env'
+import { genImport, genString } from 'knitwork'
+import { resolveModulePath } from 'exsolve'
+import type { Nuxt, NuxtHooks, NuxtModule, NuxtOptions } from 'nuxt/schema'
+
+import { installNuxtModule } from '../core/features.ts'
+import pagesModule from '../pages/module.ts'
+import metaModule from '../head/module.ts'
+import componentsModule from '../components/module.ts'
+import importsModule from '../imports/module.ts'
+import compilerModule from '../compiler/module.ts'
+
+import { restoreCachedBuildId } from './cache.ts'
+import { distDir, pkgDir } from '../dirs.ts'
+import { runtimeDependencies } from '../../meta.js'
+import pkg from '../../package.json' with { type: 'json' }
+import { scriptsStubsPreset } from '../imports/presets.ts'
+import { logger } from '../utils.ts'
+import { resolveTypePaths } from './utils/types.ts'
+import { createImportProtectionPatterns } from './plugins/import-protection.ts'
+import { UnctxTransformPlugin } from './plugins/unctx.ts'
+import { TreeShakeComposablesPlugin } from './plugins/tree-shake.ts'
+import { DevOnlyPlugin } from './plugins/dev-only.ts'
+import { LayerAliasingPlugin } from './plugins/layer-aliasing.ts'
+import { addModuleTranspiles } from './modules.ts'
+import { bundleServer } from './server.ts'
+import { NuxtPerfProfiler } from './perf.ts'
+import schemaModule from './schema.ts'
+import { RemovePluginMetadataPlugin } from './plugins/plugin-metadata.ts'
+import { AsyncContextInjectionPlugin } from './plugins/async-context.ts'
+import { PrehydrateTransformPlugin } from './plugins/prehydrate.ts'
+import { ExtractAsyncDataHandlersPlugin } from './plugins/extract-async-data-handlers.ts'
+import { VirtualFSPlugin } from './plugins/virtual.ts'
+
+export function createNuxt (options: NuxtOptions): Nuxt {
+ const hooks = createHooks<NuxtHooks>()
+
+ const { callHook, callHookParallel, callHookWith } = hooks
+ if (options.experimental.asyncCallHook) {
+ hooks.callHook = (...args) => Promise.resolve().then(() => runWithNuxtContext(nuxt, () => callHook(...args)))
+ hooks.callHookParallel = (...args) => Promise.resolve().then(() => runWithNuxtContext(nuxt, () => callHookParallel(...args)) ?? [])
+ } else {
+ hooks.callHook = (...args) => runWithNuxtContext(nuxt, () => callHook(...args))
+ hooks.callHookParallel = (...args) => runWithNuxtContext(nuxt, () => callHookParallel(...args))
+ }
+ hooks.callHookWith = (...args) => runWithNuxtContext(nuxt, () => callHookWith(...args))
+
+ const nuxt: Nuxt = {
+ __name: randomUUID(),
+ _version: pkg.version,
+ _asyncLocalStorageModule: options.experimental.debugModuleMutation ? new AsyncLocalStorage() : undefined,
+ hooks,
+ callHook: hooks.callHook,
+ addHooks: hooks.addHooks,
+ hook: hooks.hook,
+ ready: () => runWithNuxtContext(nuxt, () => initNuxt(nuxt)),
+ close: async () => { await hooks.callHook('close', nuxt) },
+ vfs: {},
+ apps: {},
+ runWithContext: fn => runWithNuxtContext(nuxt, fn),
+ options,
+ }
+
+ if (options.experimental.debugModuleMutation) {
+ const proxiedOptions = new WeakMap<NuxtModule, NuxtOptions>()
+
+ Object.defineProperty(nuxt, 'options', {
+ get () {
+ const currentModule = nuxt._asyncLocalStorageModule!.getStore()
+ if (!currentModule) {
+ return options
+ }
+
+ if (proxiedOptions.has(currentModule)) {
+ return proxiedOptions.get(currentModule)!
+ }
+
+ nuxt._debug ||= {}
+ nuxt._debug.moduleMutationRecords ||= []
+
+ const proxied = onChange(options, (keys, newValue, previousValue, applyData) => {
+ if (newValue === previousValue && !applyData) {
+ return
+ }
+ let value = applyData?.args ?? newValue
+ // Make a shallow copy of the value
+ if (Array.isArray(value)) {
+ value = [...value]
+ } else if (typeof value === 'object') {
+ value = { ...(value as any) }
+ }
+ nuxt._debug!.moduleMutationRecords!.push({
+ module: currentModule,
+ keys,
+ target: 'nuxt.options',
+ value,
+ timestamp: Date.now(),
+ method: applyData?.name,
+ })
+ }, {
+ ignoreUnderscores: true,
+ ignoreSymbols: true,
+ pathAsArray: true,
+ })
+
+ proxiedOptions.set(currentModule, proxied)
+ return proxied
+ },
+ })
+ }
+
+ // TODO: remove in nuxt v5
+ // eslint-disable-next-line @typescript-eslint/no-deprecated
+ if (!nuxtCtx.tryUse()) {
+ // backward compatibility with 3.x
+ // eslint-disable-next-line @typescript-eslint/no-deprecated
+ nuxtCtx.set(nuxt)
+ nuxt.hook('close', () => {
+ // eslint-disable-next-line @typescript-eslint/no-deprecated
+ nuxtCtx.unset()
+ })
+ }
+
+ hooks.hookOnce('close', () => { hooks.removeAllHooks() })
+
+ return nuxt
+}
+
+const fallbackCompatibilityDate = '2025-07-15' as DateString
+
+const nightlies = {
+ 'nitropack': 'nitropack-nightly',
+ 'nitro': 'nitro-nightly',
+ 'h3': 'h3-nightly',
+ 'nuxt': 'nuxt-nightly',
+ '@nuxt/schema': '@nuxt/schema-nightly',
+ '@nuxt/kit': '@nuxt/kit-nightly',
+}
+
+export const keyDependencies: string[] = [
+ '@nuxt/kit',
+]
+
+let warnedAboutCompatDate = false
+
+async function initNuxt (nuxt: Nuxt) {
+ nuxt._perf?.startPhase('init')
+
+ const layerDirs = getLayerDirectories(nuxt)
+
+ // Register user hooks
+ for (const config of nuxt.options._layers.map(layer => layer.config).reverse()) {
+ if (config.hooks) {
+ nuxt.hooks.addHooks(config.hooks)
+ }
+ }
+
+ // Prompt to set compatibility date
+ nuxt.options.compatibilityDate = resolveCompatibilityDatesFromEnv(nuxt.options.compatibilityDate)
+
+ if (!nuxt.options.compatibilityDate.default) {
+ nuxt.options.compatibilityDate.default = fallbackCompatibilityDate
+
+ if (nuxt.options.dev && hasTTY && !isCI && !nuxt.options.test && !warnedAboutCompatDate) {
+ warnedAboutCompatDate = true
+ consola.warn(`We recommend adding \`compatibilityDate: '${formatDate('latest')}'\` to your \`nuxt.config\` file.\nUsing \`${fallbackCompatibilityDate}\` as fallback. More info at: ${colors.underline('https://nitro.build/deploy#compatibility-date')}`)
+ }
+ }
+
+ // Restart Nuxt when layer directories are added or removed
+ const layersDir = withTrailingSlash(resolve(nuxt.options.rootDir, 'layers'))
+ nuxt.hook('builder:watch', (event, relativePath) => {
+ const path = resolve(nuxt.options.srcDir, relativePath)
+ if (event === 'addDir' || event === 'unlinkDir') {
+ if (path.startsWith(layersDir)) {
+ return nuxt.callHook('restart', { hard: true })
+ }
+ }
+ })
+
+ addTypeTemplate({
+ filename: 'types/nitro-layouts.d.ts',
+ getContents: ({ app }) => {
+ return [
+ `export type LayoutKey = ${Object.keys(app.layouts).map(name => genString(name)).join(' | ') || 'string'}`,
+ 'declare module \'nitro/types\' {',
+ ' interface NitroRouteConfig {',
+ ' appLayout?: LayoutKey | false',
+ ' }',
+ ' interface NitroRouteRules {',
+ ' appLayout?: LayoutKey | false',
+ ' }',
+ '}',
+ ].join('\n')
+ },
+ }, { nuxt: true, nitro: true, node: true })
+
+ // Disable environment types entirely if `typescript.builder` is false
+ if (nuxt.options.typescript.builder !== false) {
+ const envMap = {
+ // defaults from `builder` based on package name
+ '@nuxt/rspack-builder': '@rspack/core/module',
+ '@nuxt/vite-builder': 'vite/client',
+ '@nuxt/webpack-builder': 'webpack/module',
+ // simpler overrides from `typescript.builder` for better DX
+ 'rspack': '@rspack/core/module',
+ 'vite': 'vite/client',
+ 'webpack': 'webpack/module',
+ // default 'merged' builder environment for module authors
+ 'shared': '@nuxt/schema/builder-env',
+ }
+
+ const overrideEnv = nuxt.options.typescript.builder && envMap[nuxt.options.typescript.builder]
+ // If there's no override, infer based on builder. If a custom builder is provided, we disable shared types
+ const defaultEnv = typeof nuxt.options.builder === 'string' ? envMap[nuxt.options.builder] : false
+ const environmentTypes = overrideEnv || defaultEnv
+
+ if (environmentTypes) {
+ nuxt.options.typescript.hoist.push(environmentTypes)
+ addTypeTemplate({
+ filename: 'types/builder-env.d.ts',
+ getContents: () => genImport(environmentTypes),
+ })
+ }
+ }
+
+ const packageJSON = await readPackageJSON(nuxt.options.rootDir).catch(() => ({}) as PackageJson)
+ nuxt._dependencies = new Set([...Object.keys(packageJSON.dependencies || {}), ...Object.keys(packageJSON.devDependencies || {})])
+ nuxt['~runtimeDependencies'] = [...runtimeDependencies]
+
+ // Set nitro resolutions for types that might be obscured with shamefully-hoist=false
+ let paths: Record<string, [string]> | undefined
+ nuxt.hook('nitro:config', async (nitroConfig) => {
+ paths ||= await resolveTypescriptPaths(nuxt)
+ nitroConfig.typescript = defu(nitroConfig.typescript, {
+ tsConfig: { compilerOptions: { paths: { ...paths } } },
+ })
+ })
+
+ const serverBuilderReference = typeof nuxt.options.server.builder === 'string'
+ ? nuxt.options.server.builder === '@nuxt/nitro-server'
+ ? { path: resolveModulePath(nuxt.options.server.builder, { from: import.meta.url }).replace('.mjs', '.d.mts') }
+ : { types: nuxt.options.server.builder }
+ : undefined
+
+ // Add nuxt types
+ nuxt.hook('prepare:types', async (opts) => {
+ opts.references.push({ path: resolve(nuxt.options.buildDir, 'types/plugins.d.ts') })
+ // Add vue shim
+ if (nuxt.options.typescript.shim) {
+ opts.references.push({ path: resolve(nuxt.options.buildDir, 'types/vue-shim.d.ts') })
+ }
+
+ // Add shims for `#build/*` imports that do not already have matching types
+ opts.references.push({ path: resolve(nuxt.options.buildDir, 'types/build.d.ts') })
+ opts.references.push({ path: resolve(nuxt.options.buildDir, 'types/app.config.d.ts') })
+ opts.references.push({ path: resolve(nuxt.options.buildDir, 'types/runtime-config.d.ts') })
+ opts.references.push({ types: 'nuxt/app' })
+
+ // Add module augmentations directly to NuxtConfig
+ opts.nodeReferences.push({ path: resolve(nuxt.options.buildDir, 'types/modules.d.ts') })
+ opts.nodeReferences.push({ path: resolve(nuxt.options.buildDir, 'types/runtime-config.d.ts') })
+ opts.nodeReferences.push({ path: resolve(nuxt.options.buildDir, 'types/app.config.d.ts') })
+ opts.nodeReferences.push({ types: 'nuxt' })
+ opts.nodeReferences.push({ path: resolveModulePath('@nuxt/vite-builder', { from: import.meta.url }).replace('.mjs', '.d.mts') })
+ if (typeof nuxt.options.builder === 'string' && nuxt.options.builder !== '@nuxt/vite-builder') {
+ opts.nodeReferences.push({ types: nuxt.options.builder })
+ }
+
+ if (serverBuilderReference) {
+ opts.references.push(serverBuilderReference)
+ opts.nodeReferences.push(serverBuilderReference)
+ }
+
+ opts.sharedReferences.push({ path: resolve(nuxt.options.buildDir, 'types/runtime-config.d.ts') })
+ opts.sharedReferences.push({ path: resolve(nuxt.options.buildDir, 'types/app.config.d.ts') })
+ opts.sharedReferences.push({ path: resolve(nuxt.options.buildDir, 'types/shared-imports.d.ts') })
+
+ // Set Nuxt resolutions for types that might be obscured with shamefully-hoist=false
+ paths ||= await resolveTypescriptPaths(nuxt)
+ opts.tsConfig.compilerOptions = defu(opts.tsConfig.compilerOptions, { paths: { ...paths } })
+ opts.nodeTsConfig.compilerOptions = defu(opts.nodeTsConfig.compilerOptions, { paths: { ...paths } })
+ opts.sharedTsConfig.compilerOptions = defu(opts.sharedTsConfig.compilerOptions, { paths: { ...paths } })
+
+ for (const dirs of layerDirs) {
+ const declaration = join(dirs.root, 'index.d.ts')
+ if (existsSync(declaration)) {
+ opts.references.push({ path: declaration })
+ opts.nodeReferences.push({ path: declaration })
+ opts.sharedReferences.push({ path: declaration })
+ }
+ }
+ })
+
+ // Add nitro types
+ nuxt.hook('nitro:prepare:types', (opts) => {
+ opts.references.push({ path: resolve(nuxt.options.buildDir, 'types/app.config.d.ts') })
+ opts.references.push({ path: resolve(nuxt.options.buildDir, 'types/runtime-config.d.ts') })
+
+ if (serverBuilderReference) {
+ opts.references.push(serverBuilderReference)
+ }
+ })
+
+ // Prompt to install `@nuxt/scripts` if user has configured it
+ // @ts-expect-error scripts types are not present as the module is not installed
+ if (nuxt.options.scripts) {
+ if (!nuxt.options._modules.some(m => m === '@nuxt/scripts' || m === '@nuxt/scripts-nightly')) {
+ installNuxtModule('@nuxt/scripts')
+ }
+ }
+
+ // Support Nuxt VFS
+ addBuildPlugin(VirtualFSPlugin(nuxt, { mode: 'server' }), { client: false })
+ addBuildPlugin(VirtualFSPlugin(nuxt, {
+ mode: 'client',
+ alias: {
+ '#internal/nitro': join(nuxt.options.buildDir, 'nitro.client.mjs'),
+ 'nitro/runtime-config': join(nuxt.options.buildDir, 'nitro.client.mjs'),
+ 'nitropack/runtime': join(nuxt.options.buildDir, 'nitro.client.mjs'),
+ },
+ }), { server: false })
+
+ // Add plugin normalization plugin
+ addBuildPlugin(RemovePluginMetadataPlugin(nuxt))
+
+ // Add transform for `onPrehydrate` lifecycle hook
+ addBuildPlugin(PrehydrateTransformPlugin())
+
+ if (nuxt.options.experimental.localLayerAliases) {
+ // Add layer aliasing support for ~, ~~, @ and @@ aliases
+ addBuildPlugin(LayerAliasingPlugin({
+ dev: nuxt.options.dev,
+ root: nuxt.options.srcDir,
+ // skip top-level layer (user's project) as the aliases will already be correctly resolved
+ layers: nuxt.options._layers.slice(1),
+ }))
+ }
+
+ nuxt.hook('modules:done', () => {
+ // Add unctx transform
+ addBuildPlugin(UnctxTransformPlugin({
+ sourcemap: !!nuxt.options.sourcemap.server || !!nuxt.options.sourcemap.client,
+ transformerOptions: {
+ ...nuxt.options.optimization.asyncTransforms,
+ helperModule: 'unctx',
+ },
+ }))
+
+ // Add composable tree-shaking optimisations
+ if (Object.keys(nuxt.options.optimization.treeShake.composables.server).length) {
+ addBuildPlugin(TreeShakeComposablesPlugin({
+ composables: nuxt.options.optimization.treeShake.composables.server,
+ }), { client: false })
+ }
+ if (Object.keys(nuxt.options.optimization.treeShake.composables.client).length) {
+ addBuildPlugin(TreeShakeComposablesPlugin({
+ composables: nuxt.options.optimization.treeShake.composables.client,
+ }), { server: false })
+ }
+
+ // shared folder import protection
+ if (!nuxt.options.test) {
+ const sharedDir = withTrailingSlash(resolve(nuxt.options.rootDir, nuxt.options.dir.shared))
+ const relativeSharedDir = withTrailingSlash(relative(nuxt.options.rootDir, resolve(nuxt.options.rootDir, nuxt.options.dir.shared)))
+ const sharedPatterns = [/^#shared\//, new RegExp('^' + escapeRE(sharedDir)), new RegExp('^' + escapeRE(relativeSharedDir))]
+ const sharedProtectionConfig = {
+ cwd: nuxt.options.rootDir,
+ trace: true,
+ include: sharedPatterns,
+ patterns: createImportProtectionPatterns(nuxt, { context: 'shared' }),
+ }
+ addBuildPlugin({
+ vite: () => ImpoundPlugin.vite(sharedProtectionConfig),
+ webpack: () => ImpoundPlugin.webpack(sharedProtectionConfig),
+ rspack: () => ImpoundPlugin.rspack(sharedProtectionConfig),
+ }, { server: false, prepend: true })
+
+ // Add import protection
+ const nuxtProtectionConfig = {
+ cwd: nuxt.options.rootDir,
+ trace: true,
+ // Exclude top-level resolutions by plugins
+ exclude: [relative(nuxt.options.rootDir, join(nuxt.options.srcDir, 'index.html')), ...sharedPatterns],
+ patterns: createImportProtectionPatterns(nuxt, { context: 'nuxt-app' }),
+ }
+ addBuildPlugin({
+ webpack: () => ImpoundPlugin.webpack(nuxtProtectionConfig),
+ rspack: () => ImpoundPlugin.rspack(nuxtProtectionConfig),
+ })
+
+ // Register Vite import protection plugins with split enforce:
+ // - The main impound plugin (resolveId) needs prepend to run before Vite's resolver
+ // - The impound:trace plugin (transform) should run after SFC compilation so
+ // es-module-lexer can parse the compiled JS and produce accurate code snippets
+ for (const envOptions of [
+ { client: false } as const,
+ { server: false } as const,
+ ]) {
+ const error = envOptions.client === false ? false : true
+ const vitePlugins = [ImpoundPlugin.vite({ ...nuxtProtectionConfig, error, ...(error === false && { warn: 'once' as const }) })].flat()
+ .map(p => Object.assign(p, { name: `nuxt:import-protection:${p.name}` }))
+ const mainPlugins = vitePlugins.filter(p => !p.name.includes('trace'))
+ const tracePlugins = vitePlugins.filter(p => p.name.includes('trace'))
+ if (mainPlugins.length) {
+ addVitePlugin(() => mainPlugins, { ...envOptions, prepend: true })
+ }
+ if (tracePlugins.length) {
+ addVitePlugin(() => tracePlugins, envOptions)
+ }
+ }
+ }
+ })
+
+ if (!nuxt.options.dev) {
+ // DevOnly component tree-shaking - build time only
+ addBuildPlugin(DevOnlyPlugin())
+
+ // Extract async data handlers into separate chunks for better performance
+ if (nuxt.options.experimental.extractAsyncDataHandlers) {
+ addBuildPlugin(ExtractAsyncDataHandlersPlugin({
+ sourcemap: !!nuxt.options.sourcemap.client,
+ rootDir: nuxt.options.rootDir,
+ }), { server: false })
+ }
+ }
+
+ if (nuxt.options.dev) {
+ // Add plugin to check if layouts are defined without NuxtLayout being instantiated
+ addPlugin(resolve(nuxt.options.appDir, 'plugins/check-if-layout-used'))
+
+ // add plugin to make warnings less verbose in dev mode
+ addPlugin(resolve(nuxt.options.appDir, 'plugins/warn.dev.server'))
+ }
+
+ // Transform initial composable call within `<script setup>` to preserve context
+ if (nuxt.options.experimental.asyncContext) {
+ addBuildPlugin(AsyncContextInjectionPlugin(nuxt), { client: false })
+ }
+
+ // TODO: [Experimental] Avoid emitting assets when flag is enabled
+ if (nuxt.options.features.noScripts && !nuxt.options.dev) {
+ nuxt.hook('build:manifest', async (manifest) => {
+ for (const chunk of Object.values(manifest)) {
+ if (chunk.resourceType === 'script') {
+ await rm(resolve(nuxt.options.buildDir, 'dist/client', withoutLeadingSlash(nuxt.options.app.buildAssetsDir), chunk.file), { force: true })
+ chunk.file = ''
+ }
+ }
+ })
+ }
+
+ // Transpile #app if it is imported directly from subpath export
+ nuxt.options.build.transpile.push('nuxt/app')
+
+ // Transpile layers within node_modules
+ for (const layer of layerDirs) {
+ if (layer.root.includes('node_modules')) {
+ nuxt.options.build.transpile.push(layer.root.replace(/\/$/, ''))
+ }
+ }
+
+ // Ensure we can resolve dependencies within layers - filtering out local `~~/layers` directories
+ const locallyScannedLayersDirs = layerDirs.map(l => join(l.root, 'layers/'))
+ const rootWithTrailingSlash = withTrailingSlash(nuxt.options.rootDir)
+ for (const dirs of layerDirs) {
+ if (dirs.root === rootWithTrailingSlash) {
+ continue
+ }
+ if (locallyScannedLayersDirs.every(dir => !dirs.root.startsWith(dir))) {
+ nuxt.options.modulesDir.push(join(dirs.root, 'node_modules'))
+ }
+ }
+
+ // Init user modules
+ nuxt._perf?.endPhase('init')
+ nuxt._perf?.startPhase('modules')
+ await nuxt.callHook('modules:before')
+
+ const { paths: watchedModulePaths, resolvedModulePaths, modules } = await resolveModules(nuxt)
+
+ nuxt.options.watch.push(...watchedModulePaths)
+
+ // Add <NuxtWelcome>
+ // TODO: revert when deep server component config is properly bundle-split: https://github.com/nuxt/nuxt/pull/29956
+ const islandsConfig = nuxt.options.experimental.componentIslands
+ if (nuxt.options.dev || !(typeof islandsConfig === 'object' && islandsConfig.selectiveClient === 'deep')) {
+ addComponent({
+ name: 'NuxtWelcome',
+ priority: 10, // built-in that we do not expect the user to override
+ filePath: resolve(nuxt.options.appDir, 'components/welcome'),
+ })
+ }
+
+ addComponent({
+ name: 'NuxtLayout',
+ priority: 10, // built-in that we do not expect the user to override
+ filePath: resolve(nuxt.options.appDir, 'components/nuxt-layout'),
+ })
+
+ // Add <NuxtErrorBoundary>
+ addComponent({
+ name: 'NuxtErrorBoundary',
+ priority: 10, // built-in that we do not expect the user to override
+ filePath: resolve(nuxt.options.appDir, 'components/nuxt-error-boundary'),
+ })
+
+ // Add <ClientOnly>
+ addComponent({
+ name: 'ClientOnly',
+ priority: 10, // built-in that we do not expect the user to override
+ filePath: resolve(nuxt.options.appDir, 'components/client-only'),
+ })
+
+ // Add <DevOnly>
+ addComponent({
+ name: 'DevOnly',
+ priority: 10, // built-in that we do not expect the user to override
+ filePath: resolve(nuxt.options.appDir, 'components/dev-only'),
+ })
+
+ // Add <ServerPlaceholder>
+ addComponent({
+ name: 'ServerPlaceholder',
+ priority: 10, // built-in that we do not expect the user to override
+ filePath: resolve(nuxt.options.appDir, 'components/server-placeholder'),
+ })
+
+ // Add <NuxtLink>
+ addComponent({
+ name: 'NuxtLink',
+ priority: 10, // built-in that we do not expect the user to override
+ filePath: resolve(nuxt.options.appDir, 'components/nuxt-link'),
+ })
+
+ // Add <NuxtLoadingIndicator>
+ addComponent({
+ name: 'NuxtLoadingIndicator',
+ priority: 10, // built-in that we do not expect the user to override
+ filePath: resolve(nuxt.options.appDir, 'components/nuxt-loading-indicator'),
+ })
+
+ // Add <NuxtTime>
+ addComponent({
+ name: 'NuxtTime',
+ priority: 10, // built-in that we do not expect the user to override
+ filePath: resolve(nuxt.options.appDir, 'components/nuxt-time.vue'),
+ })
+
+ // Add <NuxtRouteAnnouncer>
+ addComponent({
+ name: 'NuxtRouteAnnouncer',
+ priority: 10, // built-in that we do not expect the user to override
+ filePath: resolve(nuxt.options.appDir, 'components/nuxt-route-announcer'),
+ mode: 'client',
+ })
+
+ // Add <NuxtAnnouncer>
+ addComponent({
+ name: 'NuxtAnnouncer',
+ priority: 10, // built-in that we do not expect the user to override
+ filePath: resolve(nuxt.options.appDir, 'components/nuxt-announcer'),
+ mode: 'client',
+ })
+
+ // Add <NuxtClientFallback>
+ if (nuxt.options.experimental.clientFallback) {
+ addComponent({
+ name: 'NuxtClientFallback',
+ _raw: true,
+ priority: 10, // built-in that we do not expect the user to override
+ filePath: resolve(nuxt.options.appDir, 'components/client-fallback.client'),
+ mode: 'client',
+ })
+
+ addComponent({
+ name: 'NuxtClientFallback',
+ _raw: true,
+ priority: 10, // built-in that we do not expect the user to override
+ filePath: resolve(nuxt.options.appDir, 'components/client-fallback.server'),
+ mode: 'server',
+ })
+ }
+
+ // Add stubs for <NuxtImg> and <NuxtPicture>
+ for (const name of ['NuxtImg', 'NuxtPicture']) {
+ addComponent({
+ name,
+ export: name,
+ priority: -1,
+ filePath: resolve(nuxt.options.appDir, 'components/nuxt-stubs'),
+ // @ts-expect-error TODO: refactor to @nuxt/cli
+ _internal_install: '@nuxt/image',
+ })
+ }
+
+ // Track components used to render for webpack
+ if (nuxt.options.builder === '@nuxt/webpack-builder' || nuxt.options.builder === '@nuxt/rspack-builder') {
+ addPlugin(resolve(nuxt.options.appDir, 'plugins/preload.server'))
+ }
+
+ // Add nuxt app hooks debugger
+ if (
+ nuxt.options.debug
+ && nuxt.options.debug.hooks
+ && (nuxt.options.debug.hooks === true || nuxt.options.debug.hooks.client)
+ ) {
+ addPlugin(resolve(nuxt.options.appDir, 'plugins/debug-hooks'))
+ }
+
+ // Add experimental Chrome devtools timings support
+ // https://developer.chrome.com/docs/devtools/performance/extension
+ if (nuxt.options.experimental.browserDevtoolsTiming) {
+ addPlugin(resolve(nuxt.options.appDir, 'plugins/browser-devtools-timing.client'))
+ }
+
+ await installModules(modules, resolvedModulePaths, nuxt)
+
+ // (Re)initialise ignore handler with resolved ignores from modules
+ nuxt._ignore = ignore(nuxt.options.ignoreOptions)
+ nuxt._ignore.add(resolveIgnorePatterns())
+
+ await nuxt.callHook('modules:done')
+ nuxt._perf?.endPhase('modules')
+ nuxt._perf?.collectModuleTimings(nuxt.options._installedModules)
+
+ // remove duplicate css after modules are done
+ nuxt.options.css = nuxt.options.css
+ .filter((value, index, array) => !array.includes(value, index + 1))
+
+ // Add <NuxtIsland>
+ if (nuxt.options.experimental.componentIslands) {
+ addComponent({
+ name: 'NuxtIsland',
+ priority: 10, // built-in that we do not expect the user to override
+ filePath: resolve(nuxt.options.appDir, 'components/nuxt-island'),
+ })
+ }
+
+ // Add experimental cross-origin prefetch support using Speculation Rules API
+ if (nuxt.options.experimental.crossOriginPrefetch) {
+ addPlugin(resolve(nuxt.options.appDir, 'plugins/cross-origin-prefetch.client'))
+ }
+
+ // Add experimental page reload support
+ if (nuxt.options.experimental.emitRouteChunkError === 'automatic') {
+ addPlugin(resolve(nuxt.options.appDir, 'plugins/chunk-reload.client'))
+ }
+ // Add experimental immediate page reload support
+ if (nuxt.options.experimental.emitRouteChunkError === 'automatic-immediate') {
+ addPlugin(resolve(nuxt.options.appDir, 'plugins/chunk-reload-immediate.client'))
+ }
+
+ // Add experimental session restoration support
+ if (nuxt.options.experimental.restoreState) {
+ addPlugin(resolve(nuxt.options.appDir, 'plugins/restore-state.client'))
+ }
+
+ // Add experimental automatic view transition api support
+ if (nuxt.options.experimental.viewTransition) {
+ addPlugin(resolve(nuxt.options.appDir, 'plugins/view-transitions.client'))
+ }
+
+ // Add support for custom types in JSON payload
+ addPlugin(resolve(nuxt.options.appDir, 'plugins/revive-payload.client'))
+ addPlugin(resolve(nuxt.options.appDir, 'plugins/revive-payload.server'))
+
+ addRouteMiddleware({
+ name: 'manifest-route-rule',
+ path: resolve(nuxt.options.appDir, 'middleware/route-rules'),
+ global: true,
+ })
+
+ if (nuxt.options.experimental.appManifest) {
+ if (nuxt.options.experimental.checkOutdatedBuildInterval !== false) {
+ addPlugin(resolve(nuxt.options.appDir, 'plugins/check-outdated-build.client'))
+ }
+ }
+
+ if (nuxt.options.experimental.navigationRepaint) {
+ addPlugin({
+ src: resolve(nuxt.options.appDir, 'plugins/navigation-repaint.client'),
+ })
+ }
+
+ if (nuxt.options.vue.config && Object.values(nuxt.options.vue.config).some(v => v !== null && v !== undefined)) {
+ addPluginTemplate({
+ filename: 'vue-app-config.mjs',
+ getContents: () => `
+import { defineNuxtPlugin } from '#app/nuxt'
+export default defineNuxtPlugin({
+ name: 'nuxt:vue-app-config',
+ enforce: 'pre',
+ setup (nuxtApp) {
+ ${Object.keys(nuxt.options.vue.config!).map(k => ` nuxtApp.vueApp.config[${JSON.stringify(k)}] = ${JSON.stringify(nuxt.options.vue.config![k as 'idPrefix'])}`).join('\n')}
+ }
+})`,
+ })
+ }
+
+ nuxt.hooks.hook('builder:watch', (event, relativePath) => {
+ const path = resolve(nuxt.options.srcDir, relativePath)
+ // Local module patterns
+ if (watchedModulePaths.has(path)) {
+ return nuxt.callHook('restart', { hard: true })
+ }
+
+ // User provided patterns
+ const layerRelativePaths = new Set(getLayerDirectories(nuxt).map(l => relative(l.app, path)))
+ for (const pattern of nuxt.options.watch) {
+ if (typeof pattern === 'string') {
+ // Test (normalized) strings against absolute path and relative path to any layer `srcDir`
+ if (pattern === path || layerRelativePaths.has(pattern)) { return nuxt.callHook('restart') }
+ continue
+ }
+ // Test regular expressions against path to _any_ layer `srcDir`
+ for (const p of layerRelativePaths) {
+ if (pattern.test(p)) {
+ return nuxt.callHook('restart')
+ }
+ }
+ }
+
+ // Restart Nuxt when new `app/` dir is added
+ if (event === 'addDir' && path === resolve(nuxt.options.srcDir, 'app')) {
+ logger.info(`\`${path}/\` ${event === 'addDir' ? 'created' : 'removed'}`)
+ return nuxt.callHook('restart', { hard: true })
+ }
+
+ // Core Nuxt files: app.vue, error.vue and app.config.ts
+ const isFileChange = ['add', 'unlink'].includes(event)
+ if (isFileChange && RESTART_RE.test(path)) {
+ logger.info(`\`${path}\` ${event === 'add' ? 'created' : 'removed'}`)
+ return nuxt.callHook('restart')
+ }
+ })
+
+ nuxt.options.build.transpile = nuxt.options.build.transpile.map((t) => {
+ if (typeof t !== 'string') {
+ return t
+ }
+ // Normalize windows transpile paths added by modules
+ return normalize(t).split('node_modules/').pop()!
+ })
+
+ addModuleTranspiles(nuxt)
+
+ // Init nitro
+ await bundleServer(nuxt)
+ nuxt._perf?.startPhase('ready')
+
+ // Add prerender payload support
+ if (nuxt.options.experimental.payloadExtraction) {
+ addPlugin(resolve(nuxt.options.appDir, 'plugins/payload.client'))
+ if (nuxt.options.experimental.prefetchPreloadTags) {
+ addPlugin(resolve(nuxt.options.appDir, 'plugins/prefetch-preload-tags.server'))
+ }
+ }
+
+ // Show compatibility version banner when Nuxt is running with a compatibility version
+ // that is different from the current major version
+ if (!(satisfies(coerce(nuxt._version) ?? nuxt._version, nuxt.options.future.compatibilityVersion + '.x'))) {
+ logger.info(`Running with compatibility version \`${nuxt.options.future.compatibilityVersion}\``)
+ }
+
+ await nuxt.callHook('ready', nuxt)
+ nuxt._perf?.endPhase('ready')
+}
+
+export async function loadNuxt (opts: LoadNuxtOptions): Promise<Nuxt> {
+ // Early-init profiler when CLI passes perf overrides (captures config loading).
+ // Otherwise, create after config resolves from nuxt.config / env vars.
+ let perf: NuxtPerfProfiler | undefined
+ const cliStartTime = (globalThis as any).__nuxt_cli__?.startTime as number | undefined
+ const perfOverride = typeof opts.overrides?.debug === 'object' && opts.overrides.debug.perf
+ if (perfOverride) {
+ perf = new NuxtPerfProfiler({ startTime: cliStartTime })
+ perf.startPhase('config')
+ }
+
+ const options = await loadNuxtConfig(opts)
+
+ if (!perf && typeof options.debug === 'object' && options.debug.perf) {
+ perf = new NuxtPerfProfiler({ startTime: cliStartTime })
+ }
+ perf?.endPhase('config')
+
+ // Temporary until finding better placement for each
+ options.appDir = options.alias['#app'] = withTrailingSlash(resolve(distDir, 'app'))
+ options._majorVersion = 4
+
+ // De-duplicate key arrays
+ for (const key in options.app.head || {}) {
+ options.app.head[key as 'link'] = deduplicateArray(options.app.head[key as 'link'])
+ }
+
+ // Nuxt DevTools only works for Vite
+ if (options.builder === '@nuxt/vite-builder') {
+ const isDevToolsEnabled = typeof options.devtools === 'boolean'
+ ? options.devtools
+ : options.devtools?.enabled !== false // enabled by default unless explicitly disabled
+
+ if (isDevToolsEnabled) {
+ if (!options._modules.some(m => m === '@nuxt/devtools' || m === '@nuxt/devtools-nightly' || m === '@nuxt/devtools-edge')) {
+ options._modules.push('@nuxt/devtools')
+ }
+ }
+ }
+
+ if (!options._modules.some(m => m === '@nuxt/scripts' || m === '@nuxt/scripts-nightly')) {
+ options.imports = defu(options.imports, {
+ presets: [scriptsStubsPreset],
+ })
+ }
+
+ // Nuxt Webpack Builder is currently opt-in
+ if (options.builder === '@nuxt/webpack-builder') {
+ if (!await ensureDependencyInstalled('@nuxt/webpack-builder', {
+ rootDir: options.rootDir,
+ searchPaths: options.modulesDir,
+ })) {
+ logger.warn('Failed to install `@nuxt/webpack-builder`, please install it manually, or change the `builder` option to vite in `nuxt.config`')
+ }
+ }
+
+ // Add core modules
+ options._modules.push(pagesModule, metaModule, componentsModule)
+ options._modules.push(compilerModule)
+ const importIncludes: RegExp[] = []
+ for (const layer of options._layers) {
+ if (layer.cwd && layer.cwd.includes('node_modules')) {
+ importIncludes.push(new RegExp(`(^|\\/)${escapeRE(layer.cwd.split('node_modules/').pop()!)}(\\/|$)(?!node_modules\\/)`))
+ }
+ }
+ options._modules.push([importsModule, {
+ transform: {
+ include: importIncludes,
+ },
+ }])
+ options._modules.push(schemaModule)
+ options.modulesDir.push(resolve(options.workspaceDir, 'node_modules'))
+ options.modulesDir.push(resolve(pkgDir, 'node_modules'))
+ options.build.transpile.push(
+ 'mocked-exports',
+ 'std-env', // we need to statically replace process.env when used in runtime code
+ )
+ options.alias['vue-demi'] = resolve(options.appDir, 'compat/vue-demi')
+ options.alias['@vue/composition-api'] = resolve(options.appDir, 'compat/capi')
+ if (options.telemetry !== false && !process.env.NUXT_TELEMETRY_DISABLED) {
+ options._modules.push('@nuxt/telemetry')
+ }
+ if (options.experimental.typescriptPlugin) {
+ options._modules.push('@dxup/nuxt')
+ }
+
+ // warn if user is using reserved namespaces
+ const allowedKeys = new Set(['baseURL', 'buildAssetsDir', 'cdnURL', 'buildId'])
+ for (const key in options.runtimeConfig.app) {
+ if (!allowedKeys.has(key)) {
+ logger.warn(`The \`app\` namespace is reserved for Nuxt and is exposed to the browser. Please move \`runtimeConfig.app.${key}\` to a different namespace.`)
+ delete options.runtimeConfig.app[key]
+ }
+ }
+
+ // Ensure we share key config between Nuxt and Nitro
+ const nitroOptions = options.nitro
+ createPortalProperties(nitroOptions.runtimeConfig, options, ['nitro.runtimeConfig', 'runtimeConfig'])
+ createPortalProperties(nitroOptions.routeRules, options, ['nitro.routeRules', 'routeRules'])
+ if (nitroOptions.handlers?.length && nitroOptions.handlers !== options.serverHandlers) {
+ options.serverHandlers.unshift(...nitroOptions.handlers)
+ }
+ createPortalProperties(options.serverHandlers, options, ['nitro.handlers', 'serverHandlers'])
+ if (nitroOptions.devHandlers?.length && nitroOptions.devHandlers !== options.devServerHandlers) {
+ options.devServerHandlers.unshift(...nitroOptions.devHandlers)
+ }
+ createPortalProperties(options.devServerHandlers, options, ['nitro.devHandlers', 'devServerHandlers'])
+
+ // prevent replacement of options.nitro
+ Object.defineProperties(options, {
+ nitro: {
+ configurable: true,
+ enumerable: true,
+ get: () => nitroOptions,
+ set (value) {
+ Object.assign(nitroOptions, value)
+ },
+ },
+ })
+
+ const nuxt = createNuxt(options)
+
+ if (perf) {
+ nuxt._perf = perf
+ perf.installHookInterceptors(nuxt.hooks)
+
+ const quiet = typeof options.debug === 'object' && options.debug.perf === 'quiet'
+ const title = nuxt.options.dev ? 'Nuxt Performance Report' : 'Nuxt Build Performance'
+
+ let flushed = false
+ const flush = () => {
+ if (flushed || !perf) { return }
+ flushed = true
+ if (!quiet) { perf.printReport({ title }) }
+ perf.writeReport(nuxt.options.buildDir, { quiet })
+ perf.dispose()
+ }
+
+ nuxt.hook('close', flush)
+ process.once('exit', flush)
+ nuxt.hook('close', () => { process.off('exit', flush) })
+ }
+
+ nuxt.runWithContext(() => {
+ // We register hooks layer-by-layer so any overrides need to be registered separately
+ if (opts.overrides?.hooks) {
+ nuxt.hooks.addHooks(opts.overrides.hooks)
+ }
+
+ if (
+ nuxt.options.debug
+ && nuxt.options.debug.hooks
+ && (nuxt.options.debug.hooks === true || nuxt.options.debug.hooks.server)
+ ) {
+ createDebugger(nuxt.hooks, { tag: 'nuxt' })
+ }
+ })
+
+ // Restore cached buildId before modules are initialised so that the nitro
+ // module (which captures buildId at init time) uses the correct value.
+ if (!nuxt.options._prepare && !nuxt.options.dev && nuxt.options.experimental.buildCache) {
+ nuxt.hooks.hookOnce('modules:before', () => restoreCachedBuildId(nuxt))
+ }
+
+ if (opts.ready !== false) {
+ await nuxt.ready()
+ }
+
+ return nuxt
+}
+
+const RESTART_RE = /^(?:app|error|app\.config)\.(?:js|ts|mjs|jsx|tsx|vue)$/i
+
+function deduplicateArray<T = unknown> (maybeArray: T): T {
+ if (!Array.isArray(maybeArray)) { return maybeArray }
+
+ const fresh: any[] = []
+ const hashes = new Set<string>()
+ for (const item of maybeArray) {
+ const _hash = hash(item)
+ if (!hashes.has(_hash)) {
+ hashes.add(_hash)
+ fresh.push(item)
+ }
+ }
+ return fresh as T
+}
+
+function createPortalProperties (sourceValue: any, options: NuxtOptions, paths: string[]) {
+ let sharedValue = sourceValue
+
+ for (const path of paths) {
+ const segments = path.split('.')
+ const key = segments.pop()!
+ let parent: Record<string, any> = options
+
+ while (segments.length) {
+ const key = segments.shift()!
+ parent = parent[key] ||= {}
+ }
+
+ delete parent[key]
+
+ Object.defineProperties(parent, {
+ [key]: {
+ configurable: true,
+ enumerable: true,
+ get: () => sharedValue,
+ set (value) {
+ sharedValue = value
+ },
+ },
+ })
+ }
+}
+
+async function resolveModules (nuxt: Nuxt) {
+ const modules = new Map<string | NuxtModule, Record<string, any>>()
+ const paths = new Set<string>()
+ const resolvedModulePaths = new Set<string>()
+
+ // Loop layers in reverse order, so that the extends are loaded first and project is the last
+ const configs = nuxt.options._layers.map(layer => layer.config).reverse()
+ for (const config of configs) {
+ // First register modules defined in layer's config
+ const definedModules = config.modules ?? []
+ for (const module of definedModules) {
+ const resolvedModule = resolveModuleWithOptions(module, nuxt)
+ if (resolvedModule && (!resolvedModule.resolvedPath || !resolvedModulePaths.has(resolvedModule.resolvedPath))) {
+ modules.set(resolvedModule.module, resolvedModule.options)
+ const path = resolvedModule.resolvedPath || resolvedModule.module
+ if (typeof path === 'string') {
+ resolvedModulePaths.add(path)
+ }
+ }
+ }
+
+ // Secondly automatically register modules from layer's module directory
+ const modulesDir = resolve(config.srcDir, (config.rootDir === nuxt.options.rootDir ? nuxt.options.dir : config.dir)?.modules || 'modules')
+ const layerModules = await resolveFiles(modulesDir, [
+ `*{${nuxt.options.extensions.join(',')}}`,
+ `*/index{${nuxt.options.extensions.join(',')}}`,
+ ])
+
+ for (const module of layerModules) {
+ // add path to watch
+ paths.add(module)
+
+ if (!modules.has(module)) {
+ modules.set(module, {})
+ }
+ }
+ }
+
+ // Lastly register private modules and modules added after loading config
+ for (const key of ['modules', '_modules'] as const) {
+ for (const module of nuxt.options[key as 'modules']) {
+ const resolvedModule = resolveModuleWithOptions(module, nuxt)
+
+ if (resolvedModule && !modules.has(resolvedModule.module) && (!resolvedModule.resolvedPath || !resolvedModulePaths.has(resolvedModule.resolvedPath))) {
+ modules.set(resolvedModule.module, resolvedModule.options)
+ const path = resolvedModule.resolvedPath || resolvedModule.module
+ if (typeof path === 'string') {
+ resolvedModulePaths.add(path)
+ }
+ }
+ }
+ }
+
+ return {
+ paths,
+ resolvedModulePaths,
+ modules,
+ }
+}
+
+const NESTED_PKG_RE = /^[^@]+\//
+async function resolveTypescriptPaths (nuxt: Nuxt): Promise<Record<string, [string]>> {
+ nuxt.options.typescript.hoist ||= []
+
+ const packagesToResolve: string[] = []
+ const nightlyAliases = new Map<string, string>() // nightly -> original
+
+ for (const pkg of nuxt.options.typescript.hoist) {
+ const [_pkg = pkg] = NESTED_PKG_RE.test(pkg) ? pkg.split('/') : [pkg]
+
+ // ignore packages that exist in `package.json` as these can be resolved by TypeScript
+ if (nuxt._dependencies?.has(_pkg) && !(_pkg in nightlies)) { continue }
+
+ // deduplicate types for nightly releases
+ if (_pkg in nightlies) {
+ const nightly = nightlies[_pkg as keyof typeof nightlies]
+ const nightlyPkg = pkg.replace(_pkg, nightly)
+ packagesToResolve.push(nightlyPkg)
+ nightlyAliases.set(nightlyPkg, pkg)
+ }
+
+ packagesToResolve.push(pkg)
+ }
+
+ const resolved = await resolveTypePaths(packagesToResolve, nuxt.options.modulesDir)
+
+ const paths: Record<string, [string]> = {}
+ const nightlyResolved = new Set<string>() // track which originals were resolved via nightly
+
+ for (const [pkg, path] of resolved) {
+ if (nightlyAliases.has(pkg)) {
+ // This is a nightly resolution - map to both the original and nightly name
+ const original = nightlyAliases.get(pkg)!
+ paths[original] = [path]
+ paths[pkg] = [path]
+ nightlyResolved.add(original)
+ } else if (!nightlyResolved.has(pkg)) {
+ // Only use direct resolution if nightly didn't already resolve
+ paths[pkg] = [path]
+ }
+ }
+
+ return paths
+}
+
+function withTrailingSlash (dir: string) {
+ return dir.replace(/[^/]$/, '$&/')
+}
diff --git a/packages/nuxt/src/core/perf.ts b/packages/nuxt/src/core/perf.ts
new file mode 100644
index 000000000000..9e9767ed6e38
--- /dev/null
+++ b/packages/nuxt/src/core/perf.ts
@@ -0,0 +1,766 @@
+import { performance } from 'node:perf_hooks'
+import process from 'node:process'
+import { mkdirSync, writeFileSync } from 'node:fs'
+import { join, relative } from 'pathe'
+import { consola } from 'consola'
+import { colors } from 'consola/utils'
+import type { Hookable } from 'hookable'
+import type { NuxtHooks } from 'nuxt/schema'
+
+export interface MemorySnapshot {
+ rss: number
+ heapUsed: number
+ heapTotal: number
+}
+
+interface PerfPhase {
+ name: string
+ startTime: number
+ endTime: number
+ duration: number
+ memoryBefore: MemorySnapshot
+ memoryAfter: MemorySnapshot
+ memoryDelta: { rss: number, heapUsed: number }
+ retainedMemory?: MemorySnapshot
+}
+
+interface OpenPhase {
+ name: string
+ startTime: number
+ memoryBefore: MemorySnapshot
+}
+
+export interface SlowHook {
+ name: string
+ duration: number
+ ownDuration: number
+ phase: string
+}
+
+export interface ModuleTiming {
+ name: string
+ setupTime: number
+}
+
+export interface PluginHookTiming {
+ totalTime: number
+ count: number
+ maxTime: number
+ avgTime: number
+}
+
+export interface BundlerPluginTiming {
+ name: string
+ hooks: Record<string, PluginHookTiming>
+}
+
+export interface PerfReport {
+ totalDuration: number
+ totalMemoryDelta: { rss: number, heapUsed: number }
+ hasGCSnapshots: boolean
+ phases: Array<{
+ name: string
+ duration: number
+ ownDuration: number
+ memoryBefore: MemorySnapshot
+ memoryAfter: MemorySnapshot
+ memoryDelta: { rss: number, heapUsed: number }
+ ownMemoryDelta: { rss: number, heapUsed: number }
+ retainedHeap?: number
+ }>
+ slowHooks: SlowHook[]
+ modules: ModuleTiming[]
+ bundlerPlugins: BundlerPluginTiming[]
+ timestamp: string
+}
+
+const hasGC = typeof globalThis.gc === 'function'
+
+function getMemorySnapshot (): MemorySnapshot {
+ const mem = process.memoryUsage()
+ return { rss: mem.rss, heapUsed: mem.heapUsed, heapTotal: mem.heapTotal }
+}
+
+function getRetainedMemorySnapshot (): MemorySnapshot {
+ if (hasGC) {
+ globalThis.gc!()
+ }
+ const mem = process.memoryUsage()
+ return { rss: mem.rss, heapUsed: mem.heapUsed, heapTotal: mem.heapTotal }
+}
+
+function formatBytes (bytes: number): string {
+ const abs = Math.abs(bytes)
+ if (abs < 1024) { return `${bytes} B` }
+ if (abs < 1024 * 1024) { return `${(bytes / 1024).toFixed(1)} KB` }
+ return `${(bytes / (1024 * 1024)).toFixed(1)} MB`
+}
+
+function formatDuration (ms: number): string {
+ if (ms < 1) { return `${Math.round(ms * 1000)}µs` }
+ if (ms < 1000) { return `${Math.round(ms)}ms` }
+ if (ms < 60_000) { return `${(ms / 1000).toFixed(1)}s` }
+ return `${(ms / 60_000).toFixed(1)}min`
+}
+
+// eslint-disable-next-line no-control-regex
+const ANSI_RE = /\x1B\[[0-9;]*m/g
+
+function pad (str: string, width: number, align: 'left' | 'right' = 'left'): string {
+ const stripped = str.replace(ANSI_RE, '')
+ const diff = width - stripped.length
+ if (diff <= 0) { return str }
+ const padding = ' '.repeat(diff)
+ return align === 'right' ? padding + str : str + padding
+}
+
+function round (n: number): number {
+ return Math.round(n * 100) / 100
+}
+
+/** Chrome Trace Event format (subset used by Perfetto / chrome://tracing) */
+interface TraceEvent {
+ /** Event name */
+ name: string
+ /** Category */
+ cat: string
+ /** Phase: 'X' = complete, 'M' = metadata, 'C' = counter */
+ ph: string
+ /** Timestamp in microseconds */
+ ts: number
+ /** Duration in microseconds (for ph='X') */
+ dur?: number
+ /** Process ID */
+ pid: number
+ /** Thread ID */
+ tid: number
+ /** Arguments */
+ args?: Record<string, unknown>
+}
+
+const SLOW_HOOK_THRESHOLD_MS = Number(process.env.NUXT_PERF_SLOW_HOOK_MS) || 50
+
+const HOOK_PHASE_THRESHOLD_MS = 5
+
+export class NuxtPerfProfiler {
+ #phases: PerfPhase[] = []
+ #phaseStack: OpenPhase[] = []
+ #hookPhases: PerfPhase[] = []
+ #hookStartStack: Array<{ name: string, time: number, memory: MemorySnapshot }> = []
+ #modules: ModuleTiming[] = []
+ #bundlerPluginTimings = new Map<string, Map<string, { totalTime: number, count: number, maxTime: number }>>()
+ #bundlerPluginSpans: Array<{ pluginName: string, hookName: string, startTime: number, durationMs: number }> = []
+ #globalStart: number
+ #globalMemoryBefore: MemorySnapshot
+ #unsubscribe?: () => void
+ /** Offset to convert performance.now() (ms) to epoch microseconds for trace events */
+ #baseTs: number
+
+ constructor (options?: { startTime?: number }) {
+ if (options?.startTime) {
+ // Convert absolute Date.now() timestamp to performance.now() space
+ this.#globalStart = performance.now() - (Date.now() - options.startTime)
+ } else {
+ this.#globalStart = performance.now()
+ }
+ this.#globalMemoryBefore = getMemorySnapshot()
+ // Compute offset: epoch_us = (performance.now() * 1000) + baseTs
+ this.#baseTs = Date.now() * 1000 - this.#globalStart * 1000
+ }
+
+ installHookInterceptors (hooks: Hookable<NuxtHooks>): void {
+ const unsubBefore = hooks.beforeEach((event) => {
+ this.#hookStartStack.push({
+ name: event.name,
+ time: performance.now(),
+ memory: getMemorySnapshot(),
+ })
+ })
+
+ const unsubAfter = hooks.afterEach((event) => {
+ let startIdx = -1
+ for (let i = this.#hookStartStack.length - 1; i >= 0; i--) {
+ if (this.#hookStartStack[i]!.name === event.name) {
+ startIdx = i
+ break
+ }
+ }
+ if (startIdx === -1) { return }
+ const start = this.#hookStartStack.splice(startIdx, 1)[0]!
+
+ const endTime = performance.now()
+ const memoryAfter = getMemorySnapshot()
+ const duration = round(endTime - start.time)
+
+ this.#hookPhases.push({
+ name: `hook:${event.name}`,
+ startTime: start.time,
+ endTime,
+ duration,
+ memoryBefore: start.memory,
+ memoryAfter,
+ memoryDelta: {
+ rss: memoryAfter.rss - start.memory.rss,
+ heapUsed: memoryAfter.heapUsed - start.memory.heapUsed,
+ },
+ })
+ })
+
+ this.#unsubscribe = () => {
+ unsubBefore()
+ unsubAfter()
+ }
+ }
+
+ startPhase (name: string): void {
+ this.#phaseStack.push({
+ name,
+ startTime: performance.now(),
+ memoryBefore: getMemorySnapshot(),
+ })
+ }
+
+ endPhase (name?: string): void {
+ let phaseIdx = this.#phaseStack.length - 1
+ if (name) {
+ phaseIdx = -1
+ for (let i = this.#phaseStack.length - 1; i >= 0; i--) {
+ if (this.#phaseStack[i]!.name === name) {
+ phaseIdx = i
+ break
+ }
+ }
+ if (phaseIdx === -1) { return }
+ }
+ if (phaseIdx < 0) { return }
+
+ const open = this.#phaseStack.splice(phaseIdx, 1)[0]!
+ const endTime = performance.now()
+ const memoryAfter = getMemorySnapshot()
+
+ // For top-level phases (nothing else on the stack), take a GC'd snapshot
+ // to measure truly retained memory. This is expensive so we only do it
+ // at major phase boundaries when --expose-gc is available.
+ const isTopLevel = this.#phaseStack.length === 0
+ const retainedMemory = isTopLevel && hasGC ? getRetainedMemorySnapshot() : undefined
+
+ this.#phases.push({
+ name: open.name,
+ startTime: open.startTime,
+ endTime,
+ duration: round(endTime - open.startTime),
+ memoryBefore: open.memoryBefore,
+ memoryAfter,
+ memoryDelta: {
+ rss: memoryAfter.rss - open.memoryBefore.rss,
+ heapUsed: memoryAfter.heapUsed - open.memoryBefore.heapUsed,
+ },
+ retainedMemory,
+ })
+ }
+
+ recordBundlerPluginHook (pluginName: string, hookName: string, durationMs: number, startTime?: number): void {
+ let plugin = this.#bundlerPluginTimings.get(pluginName)
+ if (!plugin) {
+ plugin = new Map()
+ this.#bundlerPluginTimings.set(pluginName, plugin)
+ }
+ const entry = plugin.get(hookName)
+ if (entry) {
+ entry.totalTime += durationMs
+ entry.count++
+ if (durationMs > entry.maxTime) { entry.maxTime = durationMs }
+ } else {
+ plugin.set(hookName, { totalTime: durationMs, count: 1, maxTime: durationMs })
+ }
+ // Store per-invocation span for trace file (only if startTime provided and duration significant)
+ if (startTime != null && durationMs > 0.1) {
+ this.#bundlerPluginSpans.push({ pluginName, hookName, startTime, durationMs })
+ }
+ }
+
+ collectModuleTimings (installedModules: Array<{ meta?: { name?: string }, timings?: Record<string, number | undefined> }>): void {
+ for (const mod of installedModules) {
+ const name = mod.meta?.name || '(anonymous)'
+ const setupTime = mod.timings?.setup
+ if (setupTime != null) {
+ this.#modules.push({ name, setupTime })
+ }
+ }
+ }
+
+ getReport (): PerfReport {
+ const totalDuration = round(performance.now() - this.#globalStart)
+ const globalMemoryAfter = getMemorySnapshot()
+
+ // Merge manual phases with hook phases that exceeded the threshold
+ // and aren't already covered by a manual phase.
+ const allPhases: PerfPhase[] = [...this.#phases]
+ for (const hp of this.#hookPhases) {
+ if (hp.duration < HOOK_PHASE_THRESHOLD_MS) { continue }
+ const hookName = hp.name.slice(5) // strip "hook:" prefix
+ const alreadyCovered = this.#phases.some(p =>
+ p.name === hookName && p.startTime <= hp.startTime && p.endTime >= hp.endTime,
+ )
+ if (!alreadyCovered) {
+ allPhases.push({ ...hp, name: hookName })
+ }
+ }
+
+ // Sort by start time for correct display order
+ allPhases.sort((a, b) => a.startTime - b.startTime)
+
+ // Compute own-time and own-memory for each phase by subtracting
+ // child phases nested inside it.
+ function computeOwn (phase: PerfPhase) {
+ // Find direct children: phases nested inside this one that aren't
+ // themselves nested inside another child (to avoid double-subtraction).
+ const children = allPhases.filter(other =>
+ other !== phase
+ && other.startTime >= phase.startTime
+ && other.endTime <= phase.endTime,
+ )
+ const directChildren = children.filter(child =>
+ !children.some(other =>
+ other !== child
+ && child.startTime >= other.startTime
+ && child.endTime <= other.endTime,
+ ),
+ )
+
+ let childTime = 0
+ let childRss = 0
+ let childHeap = 0
+ for (const child of directChildren) {
+ childTime += child.duration
+ childRss += child.memoryDelta.rss
+ childHeap += child.memoryDelta.heapUsed
+ }
+ return {
+ ownDuration: round(Math.max(0, phase.duration - childTime)),
+ ownMemoryDelta: {
+ rss: phase.memoryDelta.rss - childRss,
+ heapUsed: phase.memoryDelta.heapUsed - childHeap,
+ },
+ }
+ }
+
+ return {
+ totalDuration,
+ totalMemoryDelta: {
+ rss: globalMemoryAfter.rss - this.#globalMemoryBefore.rss,
+ heapUsed: globalMemoryAfter.heapUsed - this.#globalMemoryBefore.heapUsed,
+ },
+ hasGCSnapshots: hasGC,
+ phases: allPhases.map((p) => {
+ const own = computeOwn(p)
+ return {
+ name: p.name,
+ duration: p.duration,
+ ownDuration: own.ownDuration,
+ memoryBefore: p.memoryBefore,
+ memoryAfter: p.memoryAfter,
+ memoryDelta: p.memoryDelta,
+ ownMemoryDelta: own.ownMemoryDelta,
+ retainedHeap: p.retainedMemory?.heapUsed,
+ }
+ }),
+ slowHooks: this.#computeSlowHooks(new Set(allPhases.map(p => p.name))),
+ modules: this.#modules.toSorted((a, b) => b.setupTime - a.setupTime),
+ bundlerPlugins: [...this.#bundlerPluginTimings.entries()]
+ .map(([name, hookMap]) => {
+ const hooks: Record<string, PluginHookTiming> = {}
+ for (const [hookName, t] of hookMap) {
+ hooks[hookName] = {
+ totalTime: round(t.totalTime),
+ count: t.count,
+ maxTime: round(t.maxTime),
+ avgTime: round(t.totalTime / t.count),
+ }
+ }
+ return { name, hooks }
+ })
+ .sort((a, b) => {
+ const aTotal = Object.values(a.hooks).reduce((s, h) => s + h.totalTime, 0)
+ const bTotal = Object.values(b.hooks).reduce((s, h) => s + h.totalTime, 0)
+ return bTotal - aTotal
+ }),
+ timestamp: new Date().toISOString(),
+ }
+ }
+
+ printReport (options?: { title?: string }): void {
+ const report = this.getReport()
+
+ // Sub-phases are module:* and vite:* - everything else goes in the main table
+ const isSubPhase = (name: string) => name.startsWith('module:') || name.startsWith('vite:')
+ const topPhases = report.phases.filter(p => !isSubPhase(p.name))
+ const subPhases = report.phases.filter(p => isSubPhase(p.name))
+
+ consola.log('')
+ consola.log(colors.bold(colors.cyan(` ${options?.title || 'Nuxt Performance Report'}`)))
+ consola.log('')
+
+ const colPhase = 24
+ const colDuration = 10
+ const colRss = 14
+ const colHeap = 14
+ const colRetained = 16
+ const showRetained = report.hasGCSnapshots
+ const maxDuration = Math.max(...topPhases.map(p => p.ownDuration), 1)
+
+ const headerCols = [
+ pad(colors.bold('Phase'), colPhase),
+ pad(colors.bold('Duration'), colDuration, 'right'),
+ pad(colors.bold('RSS Delta'), colRss, 'right'),
+ pad(colors.bold('Heap Delta'), colHeap, 'right'),
+ ]
+ if (showRetained) {
+ headerCols.push(pad(colors.bold('Retained Heap'), colRetained, 'right'))
+ }
+ consola.log(` ${headerCols.join(' ')}`)
+
+ const separatorWidth = colPhase + colDuration + colRss + colHeap + 6 + (showRetained ? colRetained + 2 : 0)
+ const separator = ' ' + colors.dim('─'.repeat(separatorWidth))
+ consola.log(separator)
+
+ const maxRss = Math.max(...topPhases.map(p => Math.abs(p.ownMemoryDelta.rss)), 1)
+ const barMax = 20
+
+ for (const phase of topPhases) {
+ const dur = phase.ownDuration
+ const rss = phase.ownMemoryDelta.rss
+ const heap = phase.ownMemoryDelta.heapUsed
+
+ // Duration bar: log scale so small phases are still visible next to dominant ones
+ const durBar = dur > 0
+ ? Math.max(1, Math.round((Math.log(dur + 1) / Math.log(maxDuration + 1)) * (barMax / 2)))
+ : 0
+ // Memory bar: proportional to RSS delta
+ const memBar = Math.abs(rss) > 0
+ ? Math.max(0, Math.round((Math.abs(rss) / maxRss) * (barMax / 2)))
+ : 0
+
+ const durColor = dur > 1000 ? colors.red : dur > 200 ? colors.yellow : colors.green
+ const memColor = Math.abs(rss) > 50 * 1024 * 1024 ? colors.red : Math.abs(rss) > 10 * 1024 * 1024 ? colors.yellow : colors.green
+
+ const bar = durColor('█'.repeat(durBar)) + memColor('░'.repeat(memBar))
+
+ const rowCols = [
+ pad(phase.name, colPhase),
+ pad(durColor(formatDuration(dur)), colDuration, 'right'),
+ pad(memColor((rss >= 0 ? '+' : '') + formatBytes(rss)), colRss, 'right'),
+ pad((heap >= 0 ? '+' : '') + formatBytes(heap), colHeap, 'right'),
+ ]
+ if (showRetained) {
+ if (phase.retainedHeap != null) {
+ const retainedColor = phase.retainedHeap > 200 * 1024 * 1024 ? colors.red : phase.retainedHeap > 100 * 1024 * 1024 ? colors.yellow : colors.green
+ rowCols.push(pad(retainedColor(formatBytes(phase.retainedHeap)), colRetained, 'right'))
+ } else {
+ rowCols.push(pad(colors.dim('—'), colRetained, 'right'))
+ }
+ }
+ consola.log(` ${rowCols.join(' ')} ${bar}`)
+ }
+
+ consola.log(separator)
+ const totalCols = [
+ pad(colors.bold('Total'), colPhase),
+ pad(colors.bold(formatDuration(report.totalDuration)), colDuration, 'right'),
+ pad(colors.bold((report.totalMemoryDelta.rss >= 0 ? '+' : '') + formatBytes(report.totalMemoryDelta.rss)), colRss, 'right'),
+ pad(colors.bold((report.totalMemoryDelta.heapUsed >= 0 ? '+' : '') + formatBytes(report.totalMemoryDelta.heapUsed)), colHeap, 'right'),
+ ]
+ if (showRetained) {
+ totalCols.push(pad('', colRetained))
+ }
+ consola.log(` ${totalCols.join(' ')}`)
+ if (!showRetained) {
+ consola.log(colors.dim(' Tip: run with NODE_OPTIONS=--expose-gc to see retained heap per phase'))
+ }
+ consola.log('')
+
+ const significantModules = report.modules.filter(m => m.setupTime > 5)
+ if (significantModules.length > 0) {
+ consola.log(colors.bold(` Modules`))
+ consola.log('')
+ for (const mod of significantModules) {
+ const durColor = mod.setupTime > 500 ? colors.red : mod.setupTime > 100 ? colors.yellow : colors.dim
+ consola.log(` ${colors.dim('•')} ${mod.name} ${colors.dim('—')} ${durColor(formatDuration(mod.setupTime))}`)
+ }
+ consola.log('')
+ }
+
+ if (report.bundlerPlugins.length > 0) {
+ const rows: Array<{ plugin: string, hook: string, timing: PluginHookTiming }> = []
+ for (const plugin of report.bundlerPlugins) {
+ for (const [hook, timing] of Object.entries(plugin.hooks)) {
+ if (timing.avgTime > 0.5) {
+ rows.push({ plugin: plugin.name, hook, timing })
+ }
+ }
+ }
+ rows.sort((a, b) => b.timing.avgTime - a.timing.avgTime)
+
+ if (rows.length > 0) {
+ consola.log(colors.bold(` Bundler Plugins`))
+ consola.log('')
+ for (const { plugin, hook, timing } of rows.slice(0, 15)) {
+ const durColor = timing.avgTime > 10 ? colors.red : timing.avgTime > 2 ? colors.yellow : colors.dim
+ const avgLabel = formatDuration(timing.avgTime) + '/file'
+ const maxLabel = timing.maxTime > timing.avgTime * 2 ? `, max ${formatDuration(timing.maxTime)}` : ''
+ consola.log(` ${colors.dim('•')} ${plugin} ${colors.dim(hook)} ${colors.dim('—')} ${durColor(avgLabel)}${colors.dim(maxLabel)} ${colors.dim(`(${timing.count} calls)`)}`)
+ }
+ consola.log('')
+ }
+ }
+
+ if (report.slowHooks.length > 0) {
+ consola.log(colors.bold(colors.yellow(` Slow Hooks (>${SLOW_HOOK_THRESHOLD_MS}ms own time)`)))
+ consola.log('')
+ for (const hook of report.slowHooks) {
+ const durColor = hook.ownDuration > 500 ? colors.red : hook.ownDuration > 200 ? colors.yellow : colors.dim
+ const ownLabel = hook.ownDuration !== hook.duration
+ ? `${formatDuration(hook.ownDuration)} own / ${formatDuration(hook.duration)} total`
+ : formatDuration(hook.ownDuration)
+ consola.log(` ${colors.dim('•')} ${hook.name} ${colors.dim('—')} ${durColor(ownLabel)} ${colors.dim(`(${hook.phase})`)}`)
+ }
+ consola.log('')
+ }
+
+ const significantSubs = subPhases.filter(p => p.duration > 5)
+ if (significantSubs.length > 0) {
+ consola.log(colors.bold(` Details`))
+ consola.log('')
+ for (const phase of significantSubs) {
+ const durColor = phase.duration > 500 ? colors.red : phase.duration > 100 ? colors.yellow : colors.dim
+ consola.log(` ${colors.dim('•')} ${phase.name} ${colors.dim('—')} ${durColor(formatDuration(phase.duration))}`)
+ }
+ consola.log('')
+ }
+ }
+
+ /**
+ * Generate trace events in Chrome Trace Event format.
+ * The output can be loaded in chrome://tracing or https://ui.perfetto.dev
+ */
+ getTraceEvents (): TraceEvent[] {
+ const events: TraceEvent[] = []
+ const pid = 1
+ const tidPhases = 1
+ const tidHooks = 2
+ // Bundler plugin spans use dynamic tids starting from this base
+ const tidPluginBase = 10
+
+ /** Convert performance.now() (ms) to epoch microseconds (integer) */
+ const toUs = (ms: number) => Math.round(ms * 1000 + this.#baseTs)
+
+ // Process/thread metadata
+ events.push(
+ { name: 'process_name', ph: 'M', ts: 0, pid, tid: 0, cat: '', args: { name: 'Nuxt Build' } },
+ { name: 'thread_name', ph: 'M', ts: 0, pid, tid: tidPhases, cat: '', args: { name: 'Build' } },
+ { name: 'thread_name', ph: 'M', ts: 0, pid, tid: tidHooks, cat: '', args: { name: 'Hooks' } },
+ )
+
+ /** Convert ms duration to integer microseconds */
+ const durUs = (ms: number) => Math.round(ms * 1000)
+
+ // Root span using B/E (begin/end) pair so nested phases display correctly
+ const globalEnd = performance.now()
+ events.push(
+ { name: 'nuxt build', cat: 'build', ph: 'B', ts: toUs(this.#globalStart), pid, tid: tidPhases },
+ { name: 'nuxt build', cat: 'build', ph: 'E', ts: toUs(globalEnd), pid, tid: tidPhases },
+ )
+
+ // Manual phases as B/E pairs (they nest: e.g. module:* inside modules, vite:* inside build:bundle)
+ for (const phase of this.#phases) {
+ events.push(
+ {
+ name: phase.name,
+ cat: 'phase',
+ ph: 'B',
+ ts: toUs(phase.startTime),
+ pid,
+ tid: tidPhases,
+ args: {
+ memoryBefore: { rss: phase.memoryBefore.rss, heapUsed: phase.memoryBefore.heapUsed },
+ },
+ },
+ {
+ name: phase.name,
+ cat: 'phase',
+ ph: 'E',
+ ts: toUs(phase.endTime),
+ pid,
+ tid: tidPhases,
+ args: {
+ memoryDelta: { rss: phase.memoryDelta.rss, heapUsed: phase.memoryDelta.heapUsed },
+ },
+ },
+ )
+ }
+
+ // Hook invocations as B/E pairs (hooks can nest when one hook triggers another)
+ for (const hp of this.#hookPhases) {
+ const name = hp.name.startsWith('hook:') ? hp.name.slice(5) : hp.name
+ events.push(
+ { name, cat: 'hook', ph: 'B', ts: toUs(hp.startTime), pid, tid: tidHooks },
+ { name, cat: 'hook', ph: 'E', ts: toUs(hp.endTime), pid, tid: tidHooks },
+ )
+ }
+
+ // Bundler plugin per-invocation spans
+ // These can overlap (parallel transforms), so we assign dynamic thread IDs.
+ // Group by prefix (vite vs nitro) and use a simple lane allocator per group.
+ const viteSpans = this.#bundlerPluginSpans.filter(s => !s.pluginName.startsWith('nitro:'))
+ const nitroSpans = this.#bundlerPluginSpans.filter(s => s.pluginName.startsWith('nitro:'))
+
+ const emitPluginSpans = (spans: typeof viteSpans, label: string, baseTid: number) => {
+ if (spans.length === 0) { return }
+ // Sort by start time for lane allocation
+ const sorted = spans.toSorted((a, b) => a.startTime - b.startTime)
+ // Each lane tracks when it becomes free (end time in ms)
+ const laneEnds: number[] = []
+
+ for (const span of sorted) {
+ const endTime = span.startTime + span.durationMs
+ // Find a lane that's free (strictly ended before this span starts)
+ let lane = laneEnds.findIndex(end => end < span.startTime)
+ if (lane === -1) {
+ lane = laneEnds.length
+ laneEnds.push(0)
+ }
+ laneEnds[lane] = endTime
+
+ const tid = baseTid + lane
+ events.push({
+ name: `${span.pluginName}:${span.hookName}`,
+ cat: label,
+ ph: 'X',
+ ts: toUs(span.startTime),
+ dur: durUs(span.durationMs),
+ pid,
+ tid,
+ })
+ }
+
+ // Add thread name metadata for each lane used
+ for (let i = 0; i < laneEnds.length; i++) {
+ const suffix = laneEnds.length > 1 ? ` ${i + 1}` : ''
+ events.push({
+ name: 'thread_name', ph: 'M', ts: 0, pid, tid: baseTid + i, cat: '',
+ args: { name: `${label}${suffix}` },
+ })
+ }
+ }
+
+ emitPluginSpans(viteSpans, 'Vite Plugins', tidPluginBase)
+ emitPluginSpans(nitroSpans, 'Nitro Plugins', tidPluginBase + 100)
+
+ // Memory counter events at phase boundaries
+ for (const phase of this.#phases) {
+ events.push(
+ {
+ name: 'Memory',
+ cat: 'memory',
+ ph: 'C',
+ ts: toUs(phase.startTime),
+ pid,
+ tid: 0,
+ args: { rss: phase.memoryBefore.rss, heapUsed: phase.memoryBefore.heapUsed },
+ },
+ {
+ name: 'Memory',
+ cat: 'memory',
+ ph: 'C',
+ ts: toUs(phase.endTime),
+ pid,
+ tid: 0,
+ args: { rss: phase.memoryAfter.rss, heapUsed: phase.memoryAfter.heapUsed },
+ },
+ )
+ // If we have a GC'd retained memory snapshot, emit it as a separate counter
+ // so it's visible in Perfetto as a distinct series
+ if (phase.retainedMemory) {
+ events.push({
+ name: 'Retained Memory',
+ cat: 'memory',
+ ph: 'C',
+ ts: toUs(phase.endTime) + 1, // slightly after to ensure ordering
+ pid,
+ tid: 0,
+ args: { heapRetained: phase.retainedMemory.heapUsed, rssRetained: phase.retainedMemory.rss },
+ })
+ }
+ }
+
+ return events
+ }
+
+ writeReport (buildDir: string, options?: { quiet?: boolean }): string {
+ const report = this.getReport()
+ const reportPath = join(buildDir, 'perf-report.json')
+ const relativeReportPath = relative(process.cwd(), reportPath).replace(/^(?![^.]{1,2}\/)/, './')
+ const tracePath = join(buildDir, 'perf-trace.json')
+ const relativeTracePath = relative(process.cwd(), tracePath).replace(/^(?![^.]{1,2}\/)/, './')
+ try {
+ mkdirSync(buildDir, { recursive: true })
+ writeFileSync(reportPath, JSON.stringify(report, null, 2), 'utf-8')
+ writeFileSync(tracePath, JSON.stringify({ traceEvents: this.getTraceEvents() }), 'utf-8')
+ if (!options?.quiet) {
+ consola.log(colors.dim(` Data dump written to ${relativeReportPath}`))
+ consola.log(colors.dim(` Trace written to ${relativeTracePath} (load in \`https://ui.perfetto.dev\`)`))
+ consola.log('')
+ }
+ } catch {
+ // don't throw an error if we can't write the file
+ }
+ return reportPath
+ }
+
+ dispose (): void {
+ this.#unsubscribe?.()
+ }
+
+ #computeSlowHooks (reportedPhaseNames: Set<string>): SlowHook[] {
+ const hooks: SlowHook[] = []
+ for (const hp of this.#hookPhases) {
+ if (hp.duration < SLOW_HOOK_THRESHOLD_MS) { continue }
+
+ const hookName = hp.name.slice(5) // strip "hook:" prefix
+
+ // Skip hooks already shown as phases in the main table
+ if (reportedPhaseNames.has(hookName)) { continue }
+
+ // Subtract time attributed to phases (manual + promoted hooks) that overlap
+ let attributedTime = 0
+ for (const phase of this.#phases) {
+ const overlapStart = Math.max(phase.startTime, hp.startTime)
+ const overlapEnd = Math.min(phase.endTime, hp.endTime)
+ if (overlapEnd > overlapStart) {
+ attributedTime += overlapEnd - overlapStart
+ }
+ }
+ // Also subtract time from other hook phases that are nested inside this one
+ for (const other of this.#hookPhases) {
+ if (other === hp) { continue }
+ if (other.startTime >= hp.startTime && other.endTime <= hp.endTime) {
+ attributedTime += other.duration
+ }
+ }
+
+ const ownDuration = round(hp.duration - round(attributedTime))
+ if (ownDuration >= SLOW_HOOK_THRESHOLD_MS) {
+ const parentPhase = this.#phases.find(p =>
+ p.startTime <= hp.startTime && p.endTime >= hp.endTime,
+ )
+ hooks.push({
+ name: hookName,
+ duration: hp.duration,
+ ownDuration,
+ phase: parentPhase?.name || '(between phases)',
+ })
+ }
+ }
+ return hooks.sort((a, b) => b.ownDuration - a.ownDuration)
+ }
+}
diff --git a/packages/nuxt/src/core/plugins/async-context.ts b/packages/nuxt/src/core/plugins/async-context.ts
new file mode 100644
index 000000000000..de228002679e
--- /dev/null
+++ b/packages/nuxt/src/core/plugins/async-context.ts
@@ -0,0 +1,29 @@
+import { createUnplugin } from 'unplugin'
+import { generateTransform, rolldownString } from 'rolldown-string'
+import type { Nuxt } from '@nuxt/schema'
+import { isVue } from '../utils/index.ts'
+
+const WITH_ASYNC_CONTEXT_IMPORT_RE = /withAsyncContext as _withAsyncContext,?/
+
+export const AsyncContextInjectionPlugin = (_nuxt: Nuxt) => createUnplugin(() => {
+ return {
+ name: 'nuxt:vue-async-context',
+ transformInclude (id) {
+ return isVue(id, { type: ['template', 'script'] })
+ },
+ transform: {
+ filter: {
+ code: { include: /_withAsyncContext/ },
+ },
+ handler (code, id, meta?: unknown) {
+ const s = rolldownString(code, id, meta)
+ s.prepend('import { withAsyncContext as _withAsyncContext } from "#app/composables/asyncContext";\n')
+ const match = WITH_ASYNC_CONTEXT_IMPORT_RE.exec(code)
+ if (match) {
+ s.remove(match.index, match.index + match[0].length)
+ }
+ return generateTransform(s, id)
+ },
+ },
+ }
+})
diff --git a/packages/nuxt/src/core/plugins/dev-only.ts b/packages/nuxt/src/core/plugins/dev-only.ts
new file mode 100644
index 000000000000..6610feee4d96
--- /dev/null
+++ b/packages/nuxt/src/core/plugins/dev-only.ts
@@ -0,0 +1,37 @@
+import { generateTransform, rolldownString } from 'rolldown-string'
+import { createUnplugin } from 'unplugin'
+import { parse } from 'ultrahtml'
+import type { Node } from 'ultrahtml'
+import { isVue } from '../utils/index.ts'
+
+const DEVONLY_COMP_SINGLE_RE = /<(?:dev-only|DevOnly|lazy-dev-only|LazyDevOnly)(?:\s(?:[^>"']|"[^"]*"|'[^']*')*)?>[\s\S]*?<\/(?:dev-only|DevOnly|lazy-dev-only|LazyDevOnly)>/
+const DEVONLY_COMP_RE = /<(?:dev-only|DevOnly|lazy-dev-only|LazyDevOnly)(?:\s(?:[^>"']|"[^"]*"|'[^']*')*)?>[\s\S]*?<\/(?:dev-only|DevOnly|lazy-dev-only|LazyDevOnly)>/g
+
+export const DevOnlyPlugin = () => createUnplugin(() => {
+ return {
+ name: 'nuxt:server-devonly:transform',
+ enforce: 'pre',
+ transformInclude (id) {
+ return isVue(id, { type: ['template'] })
+ },
+ transform: {
+ filter: {
+ code: { include: DEVONLY_COMP_SINGLE_RE },
+ },
+ handler (code, id, meta?: unknown) {
+ const s = rolldownString(code, id, meta)
+ for (const match of code.matchAll(DEVONLY_COMP_RE)) {
+ const ast: Node = parse(match[0]).children[0]
+ const fallback: Node | undefined = ast.children?.find((n: Node) => {
+ if (n.name !== 'template') { return false }
+ return 'fallback' in n.attributes || '#fallback' in n.attributes || 'v-slot:fallback' in n.attributes
+ })
+ const replacement = fallback ? match[0].slice(fallback.loc[0].end, fallback.loc.at(-1).start) : ''
+ s.overwrite(match.index!, match.index! + match[0].length, replacement)
+ }
+
+ return generateTransform(s, id)
+ },
+ },
+ }
+})
diff --git a/packages/nuxt/src/core/plugins/extract-async-data-handlers.ts b/packages/nuxt/src/core/plugins/extract-async-data-handlers.ts
new file mode 100644
index 000000000000..d306fd4c65ea
--- /dev/null
+++ b/packages/nuxt/src/core/plugins/extract-async-data-handlers.ts
@@ -0,0 +1,182 @@
+import type { SourceMapInput } from 'rollup'
+import { createUnplugin } from 'unplugin'
+import { generateTransform, rolldownString } from 'rolldown-string'
+import type { RolldownString } from 'rolldown-string'
+import { dirname } from 'pathe'
+import { ScopeTracker, parseAndWalk, walk } from 'oxc-walker'
+import type { ESTree } from 'rolldown/utils'
+
+const functionsToExtract = new Set(['useAsyncData', 'useLazyAsyncData'])
+const FUNCTIONS_RE = /\buse(?:Lazy)?AsyncData\b/
+const SUPPORTED_EXT_RE = /^[^?]*\.(?:m?[jt]sx?|vue)(?:$|\?)/
+const SCRIPT_RE = /(?<=<script[^>]*>)[\s\S]*?(?=<\/script>)/i
+const STYLE_QUERY_RE = /[?&]type=style/
+const MACRO_QUERY_RE = /[?&]macro(?:=|&|$)/
+
+export interface ExtractAsyncDataHandlersOptions {
+ sourcemap: boolean
+ rootDir: string
+}
+
+export const ExtractAsyncDataHandlersPlugin = (options: ExtractAsyncDataHandlersOptions) => createUnplugin(() => {
+ const asyncDatas: Record<string, { code: string, map?: SourceMapInput }> = {}
+
+ let count = 0
+
+ return {
+ name: 'nuxt:extract-async-data-handlers',
+ enforce: 'post',
+ resolveId (source) {
+ if (source in asyncDatas) {
+ return source
+ }
+ },
+ load (id) {
+ if (id in asyncDatas) {
+ return asyncDatas[id]
+ }
+ },
+ transform: {
+ filter: {
+ id: {
+ include: SUPPORTED_EXT_RE,
+ exclude: [/nuxt\/(src|dist)\/app/, STYLE_QUERY_RE, MACRO_QUERY_RE],
+ },
+ code: { include: FUNCTIONS_RE },
+ },
+ handler (code, id, meta?: unknown) {
+ const { 0: script = code, index: codeIndex = 0 } = code.match(SCRIPT_RE) || { index: 0, 0: code }
+
+ let s: RolldownString | undefined
+
+ const scopeTracker = new ScopeTracker({ preserveExitedScopes: true })
+ const parseResult = parseAndWalk(script, id, { scopeTracker })
+ scopeTracker.freeze()
+
+ walk(parseResult.program, {
+ scopeTracker,
+ enter (node) {
+ if (node.type !== 'CallExpression' || node.callee.type !== 'Identifier' || !functionsToExtract.has(node.callee.name)) {
+ return
+ }
+
+ const callExpression = node
+
+ const fetcherFunction = callExpression.arguments.find((fn): fn is ESTree.Function | ESTree.ArrowFunctionExpression => fn.type === 'ArrowFunctionExpression' || fn.type === 'FunctionExpression')
+
+ if (!fetcherFunction || (fetcherFunction.type !== 'ArrowFunctionExpression' && fetcherFunction.type !== 'FunctionExpression') || !fetcherFunction.body) {
+ return
+ }
+
+ s ||= rolldownString(code, id, meta)
+
+ const referencedVariables = new Set<string>()
+ const imports = new Set<string>()
+
+ // Walk the function body to find all identifiers
+ walk(fetcherFunction.body, {
+ scopeTracker,
+ enter (innerNode, parent) {
+ if (innerNode.type !== 'Identifier') {
+ return
+ }
+
+ // Skip identifiers that are property keys (not variable references)
+ if (parent) {
+ // Skip non-computed member expression properties (e.g., the "data" in response.data)
+ if (parent.type === 'MemberExpression' && parent.property === innerNode && parent.computed === false) {
+ return
+ }
+ // Skip non-computed object property keys (e.g., { data: value })
+ if (parent.type === 'Property' && parent.key === innerNode && parent.computed === false) {
+ return
+ }
+ // Skip non-computed class method keys
+ if (parent.type === 'MethodDefinition' && parent.key === innerNode && parent.computed === false) {
+ return
+ }
+ // Skip non-computed property definition keys
+ if (parent.type === 'PropertyDefinition' && parent.key === innerNode && parent.computed === false) {
+ return
+ }
+ }
+
+ const declaration = scopeTracker.getDeclaration(innerNode.name)
+ if (!declaration) {
+ return
+ }
+
+ if (declaration.type === 'Import') {
+ // This is an imported variable, we need to include the import
+ imports.add(innerNode.name)
+ } else if (declaration.type !== 'FunctionParam') {
+ const functionBodyStart = fetcherFunction.body!.start
+ const functionBodyEnd = fetcherFunction.body!.end
+
+ // If the declaration is not within the function body, it's external
+ if (declaration.start < functionBodyStart || declaration.end > functionBodyEnd) {
+ referencedVariables.add(innerNode.name)
+ }
+ }
+ },
+ })
+
+ // Collect import statements for the referenced imports
+ const importStatements = new Set<string>()
+ walk(parseResult.program, {
+ enter (importDecl) {
+ if (importDecl.type !== 'ImportDeclaration') {
+ return
+ }
+
+ // Check if this import declaration contains any of our referenced imports
+ if (importDecl.specifiers?.some(spec => spec.local && imports.has(spec.local.name))) {
+ importStatements.add(script.slice(importDecl.start, importDecl.end))
+ }
+ },
+ })
+
+ const imps = Array.from(importStatements).join('\n')
+
+ // Generate a unique key for the extracted chunk
+ const key = `${dirname(id)}/async-data-chunk-${count++}.js`
+
+ // Get the function body content
+ const isBlockStatement = fetcherFunction.body.type === 'BlockStatement'
+
+ const startOffset = codeIndex + fetcherFunction.body.start
+ const endOffset = codeIndex + fetcherFunction.body.end
+
+ // Create the extracted chunk
+ const chunk = s.clone()
+ const parameters = [...referencedVariables].join(', ')
+ const returnPrefix = isBlockStatement ? '' : 'return '
+ const preface = `${imps}\nexport default async function (${parameters}) { ${returnPrefix}`
+ const suffix = ` }`
+
+ if (isBlockStatement) {
+ // For block statements, we need to extract the content inside the braces
+ chunk.overwrite(0, startOffset + 1, preface)
+ chunk.overwrite(endOffset - 1, code.length, suffix)
+ } else {
+ // For expression bodies, wrap in return statement
+ chunk.overwrite(0, startOffset, preface)
+ chunk.overwrite(endOffset, code.length, suffix)
+ }
+
+ asyncDatas[key] = {
+ code: chunk.toString(),
+ map: options.sourcemap ? chunk.generateMap({ hires: true }) : undefined,
+ }
+
+ // Replace the original function with a dynamic import
+ const importCall = `() => import('${key}').then(r => (r.default || r)(${parameters}))`
+ s.overwrite(codeIndex + fetcherFunction.start, codeIndex + fetcherFunction.end, importCall)
+ },
+ })
+
+ return generateTransform(s, id)
+ },
+ },
+ }
+})
diff --git a/packages/nuxt/src/core/plugins/import-protection.ts b/packages/nuxt/src/core/plugins/import-protection.ts
new file mode 100644
index 000000000000..b9938d4dda55
--- /dev/null
+++ b/packages/nuxt/src/core/plugins/import-protection.ts
@@ -0,0 +1,93 @@
+import { relative, resolve } from 'pathe'
+import escapeRE from 'escape-string-regexp'
+import type { NuxtOptions } from 'nuxt/schema'
+
+type ImportPattern = [importPattern: string | RegExp | ((id: string, importer: string) => boolean | string), warning?: string, suggestions?: string[]]
+
+interface ImportProtectionOptions {
+ rootDir: string
+ modulesDir: string[]
+ patterns: ImportPattern[]
+ exclude?: Array<RegExp | string>
+}
+
+interface NuxtImportProtectionOptions {
+ context: 'nuxt-app' | 'nitro-app' | 'shared'
+}
+
+export function createImportProtectionPatterns (nuxt: { options: NuxtOptions }, options: NuxtImportProtectionOptions) {
+ const patterns: ImportProtectionOptions['patterns'] = []
+ const context = contextFlags[options.context]
+
+ patterns.push([
+ /^(nuxt|nuxt3|nuxt-nightly)$/,
+ `\`nuxt\` or \`nuxt-nightly\` cannot be imported directly in ${context}.`,
+ options.context === 'nuxt-app'
+ ? ['Import runtime Nuxt composables from `#app` or `#imports` instead.']
+ : ['Use `#app` or `#imports` for runtime composables in your Vue app code.'],
+ ])
+
+ patterns.push([
+ /^((~|~~|@|@@)?\/)?nuxt\.config(\.|$)/,
+ 'Importing directly from a `nuxt.config` file is not allowed.',
+ ['Use `useRuntimeConfig()` to access runtime config in your app.', 'Use `useAppConfig()` to access config that doesn\'t need to be changed at runtime.', 'Use a Nuxt module to access build-time configuration.'],
+ ])
+
+ patterns.push([/(^|node_modules\/)@vue\/composition-api/])
+
+ for (const mod of nuxt.options._installedModules) {
+ if (mod.entryPath) {
+ patterns.push([
+ new RegExp(`^${escapeRE(mod.entryPath)}$`),
+ 'Importing directly from module entry-points is not allowed.',
+ ['Import from the module\'s runtime directory instead (e.g. `my-module/runtime/...`).'],
+ ])
+ }
+ }
+
+ for (const i of [
+ /(^|node_modules\/)@nuxt\/(cli|kit|test-utils)/,
+ /(^|node_modules\/)nuxi/,
+ /(^|node_modules\/)nitropack(?:-nightly)?(?:$|\/)(?!(?:dist\/)?(?:node_modules|presets|runtime|types))/,
+ /(^|node_modules\/)nitro(?:-nightly)?\/(builder|meta|vite|tsconfig)/,
+ /(^|node_modules\/)nuxt\/(config|kit|schema)/,
+ ]) {
+ patterns.push([
+ i,
+ `This module cannot be imported in ${context}.`,
+ ['These are build-time only packages and cannot be used at runtime.'],
+ ])
+ }
+
+ if (options.context === 'nitro-app' || options.context === 'shared') {
+ for (const i of ['#app', /^#build(\/|$)/]) {
+ patterns.push([
+ i,
+ `Vue app aliases are not allowed in ${context}.`,
+ ['Move this code to your Vue app directory or use a shared utility.'],
+ ])
+ }
+ }
+
+ if (options.context === 'nuxt-app' || options.context === 'shared') {
+ const serverRelative = escapeRE(relative(nuxt.options.rootDir, resolve(nuxt.options.srcDir, nuxt.options.serverDir || 'server')))
+ patterns.push([
+ new RegExp('^' + serverRelative + '\\/(api|routes|middleware|plugins)\\/'),
+ `Importing from server is not allowed in ${context}.`,
+ ['Use `$fetch()` or `useFetch()` to fetch data from server routes.', 'Move shared logic to the `shared/` directory.'],
+ ])
+ patterns.push([
+ /^#server(\/|$)/,
+ `Server aliases are not allowed in ${context}.`,
+ ['Use `$fetch()` or `useFetch()` to call server endpoints.', 'Move shared logic to the `shared/` directory.'],
+ ])
+ }
+
+ return patterns
+}
+
+const contextFlags = {
+ 'nitro-app': 'server runtime',
+ 'nuxt-app': 'the Vue part of your app',
+ 'shared': 'the #shared directory',
+} as const
diff --git a/packages/nuxt/src/core/plugins/layer-aliasing.ts b/packages/nuxt/src/core/plugins/layer-aliasing.ts
new file mode 100644
index 000000000000..3f9652bae277
--- /dev/null
+++ b/packages/nuxt/src/core/plugins/layer-aliasing.ts
@@ -0,0 +1,92 @@
+import { type UnpluginOptions, createUnplugin } from 'unplugin'
+import { resolveAlias } from '@nuxt/kit'
+import { normalize } from 'pathe'
+import { generateTransform, rolldownString } from 'rolldown-string'
+import type { NuxtConfigLayer } from 'nuxt/schema'
+
+interface LayerAliasingOptions {
+ root: string
+ dev: boolean
+ layers: NuxtConfigLayer[]
+}
+
+const ALIAS_RE = /(?<=['"])[~@]{1,2}(?=\/)/g
+const ALIAS_RE_SINGLE = /(?<=['"])[~@]{1,2}(?=\/)/
+const ALIAS_ID_RE = /^[~@]{1,2}\//
+const CSS_LANG_RE = /\.(?:css|less|sass|scss|styl|stylus|pcss|postcss|sss)(?:\?|$)/
+
+export const LayerAliasingPlugin = (options: LayerAliasingOptions) => createUnplugin((_options, meta) => {
+ const aliases: Record<string, Record<string, string>> = {}
+ for (const layer of options.layers) {
+ const srcDir = layer.config.srcDir || layer.cwd
+ const rootDir = layer.config.rootDir || layer.cwd
+
+ aliases[srcDir] = {
+ '~': layer.config?.alias?.['~'] || srcDir,
+ '@': layer.config?.alias?.['@'] || srcDir,
+ '~~': layer.config?.alias?.['~~'] || rootDir,
+ '@@': layer.config?.alias?.['@@'] || rootDir,
+ }
+ }
+ const layers = Object.keys(aliases).sort((a, b) => b.length - a.length)
+
+ // On vite, JS imports are handled by the `resolveId` hook below; the
+ // textual rewrite is only needed for CSS files, whose `@import` / `url()`
+ // resolution skips plugin `resolveId`. Webpack/rspack rely on the textual
+ // rewrite for everything.
+ const isCssLikeOnly = meta.framework === 'vite'
+ const transformInclude: UnpluginOptions['transformInclude'] = (id) => {
+ const _id = normalize(id)
+ if (!layers.some(dir => _id.startsWith(dir))) { return false }
+ if (isCssLikeOnly && !CSS_LANG_RE.test(id)) { return false }
+ return true
+ }
+ const transform: UnpluginOptions['transform'] = {
+ filter: {
+ code: { include: ALIAS_RE_SINGLE },
+ },
+ handler (code, id, meta?: unknown) {
+ const _id = normalize(id)
+ const layer = layers.find(l => _id.startsWith(l))
+ if (!layer) { return }
+
+ const s = rolldownString(code, id, meta)
+ for (const match of code.matchAll(ALIAS_RE)) {
+ const replacement = aliases[layer]?.[match[0] as '~']
+ if (replacement && replacement !== match[0]) {
+ s.overwrite(match.index, match.index + match[0].length, replacement)
+ }
+ }
+
+ return generateTransform(s, id)
+ },
+ }
+
+ return {
+ name: 'nuxt:layer-aliasing',
+ enforce: 'pre',
+ vite: {
+ resolveId: {
+ order: 'pre',
+ filter: {
+ id: ALIAS_ID_RE,
+ },
+ handler (id, importer) {
+ if (!importer) { return }
+
+ const layer = layers.find(l => importer.startsWith(l))
+ if (!layer) { return }
+
+ const resolvedId = resolveAlias(id, aliases[layer])
+ if (resolvedId !== id) {
+ return this.resolve(resolvedId, importer, { skipSelf: true })
+ }
+ },
+ },
+ },
+
+ // https://github.com/nuxt/nuxt/issues/24427
+ transformInclude,
+ transform,
+ }
+})
diff --git a/packages/nuxt/src/core/plugins/plugin-metadata.ts b/packages/nuxt/src/core/plugins/plugin-metadata.ts
new file mode 100644
index 000000000000..164028e13224
--- /dev/null
+++ b/packages/nuxt/src/core/plugins/plugin-metadata.ts
@@ -0,0 +1,188 @@
+import type { Literal } from 'estree'
+import { defu } from 'defu'
+import { findExports } from 'mlly'
+import type { Nuxt } from '@nuxt/schema'
+import { createUnplugin } from 'unplugin'
+import { generateTransform, rolldownString } from 'rolldown-string'
+import { normalize } from 'pathe'
+import type { NuxtAppLiterals, ObjectPlugin, PluginMeta } from 'nuxt/app'
+
+import { parseAndWalk } from 'oxc-walker'
+import type { ESTree } from 'rolldown/utils'
+import { logger } from '../../utils.ts'
+
+const internalOrderMap = {
+ // -50: pre-all (nuxt)
+ 'nuxt-pre-all': -50,
+ // -40: custom payload revivers (user)
+ 'user-revivers': -40,
+ // -30: payload reviving (nuxt)
+ 'nuxt-revivers': -30,
+ // -20: pre (user) <-- pre mapped to this
+ 'user-pre': -20,
+ // -10: default (nuxt)
+ 'nuxt-default': -10,
+ // 0: default (user) <-- default behavior
+ 'user-default': 0,
+ // +10: post (nuxt)
+ 'nuxt-post': 10,
+ // +20: post (user) <-- post mapped to this
+ 'user-post': 20,
+ // +30: post-all (nuxt)
+ 'nuxt-post-all': 30,
+}
+
+export const orderMap: Record<NonNullable<ObjectPlugin['enforce']>, number> = {
+ pre: internalOrderMap['user-pre'],
+ default: internalOrderMap['user-default'],
+ post: internalOrderMap['user-post'],
+}
+
+const metaCache: Record<string, Omit<PluginMeta, 'enforce'>> = {}
+export function extractMetadata (code: string, loader = 'ts' as 'ts' | 'tsx') {
+ let meta: PluginMeta = {}
+ if (metaCache[code]) {
+ return metaCache[code]
+ }
+ // non-object syntax plugin
+ if (/defineNuxtPlugin\s*\([\w(]/.test(code)) {
+ return {}
+ }
+ parseAndWalk(code, `file.${loader}`, (node) => {
+ if (node.type !== 'CallExpression' || node.callee.type !== 'Identifier') { return }
+
+ const name = 'name' in node.callee && node.callee.name
+ if (name !== 'defineNuxtPlugin' && name !== 'definePayloadPlugin') { return }
+
+ if (name === 'definePayloadPlugin') {
+ meta.order = internalOrderMap['user-revivers']
+ }
+
+ const metaArg = node.arguments[1]
+ if (metaArg) {
+ if (metaArg.type !== 'ObjectExpression') {
+ throw new Error('Invalid plugin metadata')
+ }
+ meta = extractMetaFromObject(metaArg.properties)
+ }
+
+ const plugin = node.arguments[0]
+ if (plugin?.type === 'ObjectExpression') {
+ meta = defu(extractMetaFromObject(plugin.properties), meta)
+ }
+
+ meta.order ||= orderMap[meta.enforce || 'default'] || orderMap.default
+ delete meta.enforce
+ })
+ metaCache[code] = meta
+ return meta as Omit<PluginMeta, 'enforce'>
+}
+
+type PluginMetaKey = keyof PluginMeta
+const keys: Record<PluginMetaKey, string> = {
+ name: 'name',
+ order: 'order',
+ enforce: 'enforce',
+ dependsOn: 'dependsOn',
+}
+function isMetadataKey (key: string | ESTree.IdentifierName): key is PluginMetaKey {
+ return typeof key !== 'string' ? key.name in keys : key in keys
+}
+
+function extractMetaFromObject (properties: Array<ESTree.ObjectPropertyKind>) {
+ const meta: PluginMeta = {}
+ for (const property of properties) {
+ if (property.type === 'SpreadElement' || !('name' in property.key)) {
+ throw new Error('Invalid plugin metadata')
+ }
+ const propertyKey = property.key.name
+ if (!isMetadataKey(propertyKey)) { continue }
+ if (property.value.type === 'Literal') {
+ meta[propertyKey] = property.value.value as any
+ }
+ if (property.value.type === 'UnaryExpression' && property.value.argument.type === 'Literal') {
+ meta[propertyKey] = JSON.parse(property.value.operator + property.value.argument.raw!)
+ }
+ if (propertyKey === 'dependsOn' && property.value.type === 'ArrayExpression') {
+ if (property.value.elements.some(e => !e || e.type !== 'Literal' || typeof e.value !== 'string')) {
+ throw new Error('dependsOn must take an array of string literals')
+ }
+ meta[propertyKey] = property.value.elements.map(e => (e as Literal)!.value as NuxtAppLiterals['pluginName'])
+ }
+ }
+ return meta
+}
+
+export const RemovePluginMetadataPlugin = (nuxt: Nuxt) => createUnplugin(() => {
+ return {
+ name: 'nuxt:remove-plugin-metadata',
+ transform (code, id, meta?: unknown) {
+ id = normalize(id)
+ const plugin = nuxt.apps.default?.plugins.find(p => p.src === id)
+ if (!plugin) { return }
+
+ if (!code.trim()) {
+ logger.warn(`Plugin \`${plugin.src}\` has no content.`)
+
+ return {
+ code: 'export default () => {}',
+ map: null,
+ }
+ }
+
+ const exports = findExports(code)
+ const defaultExport = exports.find(e => e.type === 'default' || e.name === 'default')
+ if (!defaultExport) {
+ logger.warn(`Plugin \`${plugin.src}\` has no default export and will be ignored at build time. Add \`export default defineNuxtPlugin(() => {})\` to your plugin.`)
+ return {
+ code: 'export default () => {}',
+ map: null,
+ }
+ }
+
+ const s = rolldownString(code, id, meta)
+ let wrapped = false
+ const wrapperNames = new Set(['defineNuxtPlugin', 'definePayloadPlugin'])
+
+ try {
+ parseAndWalk(code, id, (node) => {
+ if (node.type === 'ImportSpecifier' && node.imported.type === 'Identifier' && (node.imported.name === 'defineNuxtPlugin' || node.imported.name === 'definePayloadPlugin')) {
+ wrapperNames.add(node.local.name)
+ }
+ if (node.type !== 'CallExpression' || node.callee.type !== 'Identifier') { return }
+
+ const name = 'name' in node.callee && node.callee.name
+ if (!name || !wrapperNames.has(name)) { return }
+ wrapped = true
+
+ // Remove metadata that already has been extracted
+ if (!('order' in plugin) && !('name' in plugin)) { return }
+ for (const [argIndex, arg] of node.arguments.entries()) {
+ if (arg.type !== 'ObjectExpression') { continue }
+
+ for (const [propertyIndex, property] of arg.properties.entries()) {
+ if (property.type === 'SpreadElement' || !('name' in property.key)) { continue }
+
+ const propertyKey = property.key.name
+ if (propertyKey === 'order' || propertyKey === 'enforce' || propertyKey === 'name') {
+ const nextNode = arg.properties[propertyIndex + 1] || node.arguments[argIndex + 1]
+ const nextIndex = nextNode?.start || (arg.end - 1)
+
+ s.remove(property.start, nextIndex)
+ }
+ }
+ }
+ })
+ } catch (e) {
+ logger.error(e)
+ return
+ }
+
+ if (!wrapped) {
+ logger.warn(`Plugin \`${plugin.src}\` is not wrapped in \`defineNuxtPlugin\`. It is advised to wrap your plugins as in the future this may enable enhancements.`)
+ }
+
+ return generateTransform(s, id)
+ },
+ }
+})
diff --git a/packages/nuxt/src/core/plugins/prehydrate.ts b/packages/nuxt/src/core/plugins/prehydrate.ts
new file mode 100644
index 000000000000..9a793f73adbc
--- /dev/null
+++ b/packages/nuxt/src/core/plugins/prehydrate.ts
@@ -0,0 +1,46 @@
+import { createUnplugin } from 'unplugin'
+import { generateTransform, rolldownString } from 'rolldown-string'
+import { hash } from 'ohash'
+
+import { parseAndWalk } from 'oxc-walker'
+import { transformAndMinify } from '../../core/utils/parse.ts'
+import { isJS, isVue } from '../utils/index.ts'
+
+export function PrehydrateTransformPlugin () {
+ return createUnplugin(() => ({
+ name: 'nuxt:prehydrate-transform',
+ transformInclude (id) {
+ return isJS(id) || isVue(id, { type: ['script'] })
+ },
+ transform: {
+ filter: {
+ code: { include: /onPrehydrate\(/ },
+ },
+ handler (code, id, meta?: unknown) {
+ const s = rolldownString(code, id, meta)
+
+ parseAndWalk(code, id, (node) => {
+ if (node.type !== 'CallExpression' || node.callee.type !== 'Identifier') {
+ return
+ }
+ if (node.callee.name === 'onPrehydrate') {
+ const callback = node.arguments[0]
+ if (!callback) { return }
+ if (callback.type !== 'ArrowFunctionExpression' && callback.type !== 'FunctionExpression') { return }
+
+ const needsAttr = callback.params.length > 0
+ const { code: result } = transformAndMinify(`forEach(${code.slice(callback.start, callback.end)})`, { lang: 'ts' })
+ const cleaned = result.slice('forEach'.length).replace(/;$/, '')
+ const args = [JSON.stringify(cleaned)]
+ if (needsAttr) {
+ args.push(JSON.stringify(hash(result).slice(0, 10)))
+ }
+ s.overwrite(callback.start, callback.end, args.join(', '))
+ }
+ })
+
+ return generateTransform(s, id)
+ },
+ },
+ }))
+}
diff --git a/packages/nuxt/src/core/plugins/tree-shake.ts b/packages/nuxt/src/core/plugins/tree-shake.ts
new file mode 100644
index 000000000000..edb46d3117f8
--- /dev/null
+++ b/packages/nuxt/src/core/plugins/tree-shake.ts
@@ -0,0 +1,94 @@
+import { generateTransform, rolldownString } from 'rolldown-string'
+import { createUnplugin } from 'unplugin'
+import { ScopeTracker, parseAndWalk, walk } from 'oxc-walker'
+import escapeStringRegexp from 'escape-string-regexp'
+
+import { isJS, isVue } from '../utils/index.ts'
+
+type ImportPath = string
+
+interface TreeShakeComposablesPluginOptions {
+ composables: Record<ImportPath, string[]>
+}
+
+export const TreeShakeComposablesPlugin = (options: TreeShakeComposablesPluginOptions) => createUnplugin(() => {
+ // Create a fast lookup for all composable names
+ const allComposableNames = new Set(Object.values(options.composables).flat())
+
+ if (!allComposableNames.size) {
+ return []
+ }
+
+ return {
+ name: 'nuxt:tree-shake-composables:transform',
+ enforce: 'post',
+ transformInclude (id) {
+ return isVue(id, { type: ['script'] }) || isJS(id)
+ },
+ transform: {
+ filter: {
+ code: { include: new RegExp(`\\b(?:${[...allComposableNames].map(r => escapeStringRegexp(r)).join('|')})\\b`) },
+ },
+ handler (code, id, meta?: unknown) {
+ const s = rolldownString(code, id, meta)
+
+ // Parse and collect scope information
+ const scopeTracker = new ScopeTracker({ preserveExitedScopes: true })
+ const parseResult = parseAndWalk(code, id, {
+ scopeTracker,
+ })
+ scopeTracker.freeze()
+
+ // Process nodes and check for tree-shaking opportunities
+ walk(parseResult.program, {
+ scopeTracker,
+ enter (node) {
+ if (node.type !== 'CallExpression' || node.callee.type !== 'Identifier') {
+ return
+ }
+
+ const functionName = node.callee.name
+ const scopeTrackerNode = scopeTracker.getDeclaration(functionName)
+
+ if (scopeTrackerNode) {
+ // don't tree-shake if there's a local declaration
+ if (scopeTrackerNode.type !== 'Import') {
+ return
+ }
+
+ if (scopeTrackerNode.importNode.type !== 'ImportDeclaration') {
+ return
+ }
+
+ // check if import is from an allowed source and composable
+ const importPath = scopeTrackerNode.importNode.source.value
+
+ const importSpecifier = scopeTrackerNode.node
+ const importedName = importSpecifier.type === 'ImportSpecifier' && importSpecifier.imported.type === 'Identifier'
+ ? importSpecifier.imported.name
+ : importSpecifier.local.name
+
+ const isFromAllowedPath = importPath === '#imports'
+ ? allComposableNames.has(importedName)
+ : options.composables[importPath]?.includes(importedName)
+
+ if (!isFromAllowedPath) {
+ return
+ }
+ }
+
+ if (!scopeTrackerNode && !allComposableNames.has(functionName)) {
+ return
+ }
+
+ // TODO: validate function name against actual auto-imports registry
+ s.overwrite(node.start, node.end, ` false && /*@__PURE__*/ ${functionName}${code.slice(node.callee.end, node.end)}`)
+ this.skip()
+ },
+ })
+
+ return generateTransform(s, id)
+ },
+ },
+ }
+})
diff --git a/packages/nuxt/src/core/plugins/unctx.ts b/packages/nuxt/src/core/plugins/unctx.ts
new file mode 100644
index 000000000000..8427c6f51b87
--- /dev/null
+++ b/packages/nuxt/src/core/plugins/unctx.ts
@@ -0,0 +1,47 @@
+import type { TransformerOptions } from 'unctx/transform'
+import { createTransformer } from 'unctx/transform'
+import { createUnplugin } from 'unplugin'
+
+import { isJS, isVue } from '../utils/index.ts'
+
+const TRANSFORM_MARKER = '/* _processed_nuxt_unctx_transform */\n'
+const TRANSFORM_MARKER_RE = /^\/\* _processed_nuxt_unctx_transform \*\/\n/
+
+interface UnctxTransformPluginOptions {
+ sourcemap?: boolean
+ transformerOptions: TransformerOptions
+}
+
+export const UnctxTransformPlugin = (options: UnctxTransformPluginOptions) => createUnplugin(() => {
+ const transformer = createTransformer(options.transformerOptions)
+
+ return {
+ name: 'unctx:transform',
+ enforce: 'post',
+ transformInclude (id) {
+ return isVue(id, { type: ['template', 'script'] }) || isJS(id)
+ },
+ transform: {
+ filter: {
+ ...transformer.filter,
+ code: {
+ ...transformer.filter.code,
+ exclude: TRANSFORM_MARKER_RE,
+ },
+ },
+ handler (code) {
+ // TODO: needed for webpack - update transform in unctx/unplugin?
+ if (!transformer.shouldTransform(code)) { return }
+ const result = transformer.transform(code)
+ if (result) {
+ return {
+ code: TRANSFORM_MARKER + result.code,
+ map: options.sourcemap
+ ? result.magicString.generateMap({ hires: true })
+ : undefined,
+ }
+ }
+ },
+ },
+ }
+})
diff --git a/packages/nuxt/src/core/plugins/virtual.ts b/packages/nuxt/src/core/plugins/virtual.ts
new file mode 100644
index 000000000000..e4abd9f70d19
--- /dev/null
+++ b/packages/nuxt/src/core/plugins/virtual.ts
@@ -0,0 +1,136 @@
+import process from 'node:process'
+import { resolveAlias } from '@nuxt/kit'
+import type { Nuxt } from '@nuxt/schema'
+import { dirname, isAbsolute, resolve } from 'pathe'
+import { createUnplugin } from 'unplugin'
+import escapeStringRegexp from 'escape-string-regexp'
+
+const PREFIX = 'virtual:nuxt:'
+const PREFIX_RE = /^\/?virtual:nuxt:/
+
+interface VirtualFSPluginOptions {
+ mode: 'client' | 'server'
+ alias?: Record<string, string>
+}
+
+const RELATIVE_ID_RE = /^\.{1,2}[\\/]/
+export const VirtualFSPlugin = (nuxt: Nuxt, options: VirtualFSPluginOptions) => createUnplugin((_, meta) => {
+ const extensions = ['', ...nuxt.options.extensions]
+ const alias = { ...nuxt.options.alias, ...options.alias }
+
+ const resolveWithExt = (id: string) => {
+ for (const suffix of ['', '.' + options.mode]) {
+ for (const ext of extensions) {
+ const rId = id + suffix + ext
+ if (rId in nuxt.vfs) {
+ return rId
+ }
+ }
+ }
+ }
+
+ function resolveId (id: string, importer?: string) {
+ id = resolveAlias(id, alias)
+
+ if (PREFIX_RE.test(id)) {
+ id = withoutPrefix(decodeURIComponent(id))
+ }
+
+ const search = id.match(QUERY_RE)?.[0] || ''
+ id = withoutQuery(id)
+
+ if (process.platform === 'win32' && isAbsolute(id)) {
+ // Add back C: prefix on Windows
+ id = resolve(id)
+ }
+
+ const resolvedId = resolveWithExt(id)
+ if (resolvedId) {
+ return PREFIX + encodeURIComponent(resolvedId) + search
+ }
+
+ if (importer && RELATIVE_ID_RE.test(id)) {
+ const path = resolve(dirname(withoutPrefix(decodeURIComponent(importer))), id)
+ // resolve relative paths to virtual files
+ const resolved = resolveWithExt(path)
+ if (resolved) {
+ return PREFIX + encodeURIComponent(resolved) + search
+ }
+ }
+ }
+
+ const relevantAliases = new Set<string>()
+ for (const key in alias) {
+ const value = alias[key]
+ if (value && Object.keys(nuxt.vfs).some(vfsPath => vfsPath.startsWith(value))) {
+ relevantAliases.add(escapeDirectory(key))
+ }
+ }
+
+ const vfsEntries = new Set<string>()
+ for (const key in nuxt.vfs) {
+ if (!key.startsWith('#build/') && !key.startsWith(nuxt.options.buildDir)) {
+ vfsEntries.add(escapeDirectory(dirname(key)))
+ }
+ }
+
+ const filter = {
+ id: [
+ PREFIX_RE,
+ RELATIVE_ID_RE,
+ /^#build\//,
+ new RegExp('^(\\w:)?' + escapeDirectory(nuxt.options.buildDir)),
+ ...Array.from(vfsEntries).map(id => new RegExp('^' + id)),
+ ...relevantAliases.size ? [new RegExp('^' + Array.from(relevantAliases).join('|') + '([\\\\/]|$)')] : [],
+ ],
+ }
+
+ return {
+ name: 'nuxt:virtual',
+
+ resolveId: meta.framework === 'vite' ? undefined : { order: 'pre', filter, handler: resolveId },
+
+ vite: {
+ resolveId: {
+ order: 'pre',
+ filter,
+ handler (id, importer) {
+ const res = resolveId(id, importer)
+ if (res) {
+ return res
+ }
+ if (importer && PREFIX_RE.test(importer) && RELATIVE_ID_RE.test(id)) {
+ return this.resolve?.(id, withoutPrefix(decodeURIComponent(importer)), { skipSelf: true })
+ }
+ },
+ },
+ },
+
+ load: {
+ filter: {
+ id: PREFIX_RE,
+ },
+ handler (id) {
+ const key = withoutQuery(withoutPrefix(decodeURIComponent(id)))
+ return {
+ code: nuxt.vfs[key] || '',
+ map: null,
+ }
+ },
+ },
+ }
+})
+
+function withoutPrefix (id: string) {
+ return id.replace(PREFIX_RE, '')
+}
+
+const QUERY_RE = /\?.*$/
+
+function withoutQuery (id: string) {
+ return id.replace(QUERY_RE, '')
+}
+
+function escapeDirectory (path: string) {
+ return escapeStringRegexp(path).replace(/\//g, '[\\\\/]')
+}
diff --git a/packages/nuxt/src/core/schema.ts b/packages/nuxt/src/core/schema.ts
new file mode 100644
index 000000000000..7f22ee166bb1
--- /dev/null
+++ b/packages/nuxt/src/core/schema.ts
@@ -0,0 +1,184 @@
+import { existsSync } from 'node:fs'
+import { mkdir, writeFile } from 'node:fs/promises'
+import { fileURLToPath } from 'node:url'
+import { join, relative, resolve } from 'pathe'
+import { watch } from 'chokidar'
+import { defu } from 'defu'
+import { debounce } from 'perfect-debounce'
+import { createIsIgnored, createResolver, defineNuxtModule, directoryToURL, getLayerDirectories, importModule } from '@nuxt/kit'
+import { generateTypes, resolveSchema as resolveUntypedSchema } from 'untyped'
+import type { Schema, SchemaDefinition } from 'untyped'
+import untypedPlugin from 'untyped/babel-plugin'
+import { createJiti } from 'jiti'
+import { logger } from '../utils.ts'
+
+export default defineNuxtModule({
+ meta: {
+ name: 'nuxt:nuxt-config-schema',
+ },
+ async setup (_, nuxt) {
+ const resolver = createResolver(import.meta.url)
+
+ // Initialize untyped/jiti loader
+ const _resolveSchema = createJiti(fileURLToPath(import.meta.url), {
+ cache: false,
+ transformOptions: {
+ babel: {
+ plugins: [untypedPlugin],
+ },
+ },
+ })
+
+ // Register module types
+ nuxt.hook('prepare:types', async (ctx) => {
+ ctx.references.push({ path: 'schema/nuxt.schema.d.ts' })
+ ctx.sharedReferences.push({ path: 'schema/nuxt.schema.d.ts' })
+ ctx.nodeReferences.push({ path: 'schema/nuxt.schema.d.ts' })
+
+ ctx.nodeTsConfig.include ||= []
+ ctx.nodeTsConfig.include.push(
+ relative(nuxt.options.buildDir, join(nuxt.options.rootDir, 'nuxt.schema.*')),
+ relative(nuxt.options.buildDir, join(nuxt.options.rootDir, 'layers/*/nuxt.schema.*')),
+ )
+
+ if (nuxt.options._prepare) {
+ await writeSchema(schema)
+ }
+ })
+
+ // Resolve schema after all modules initialized
+ let schema: Schema
+ nuxt.hook('modules:done', async () => {
+ schema = await resolveSchema()
+ })
+
+ // Write schema after build to allow further modifications
+ nuxt.hooks.hook('build:done', () => writeSchema(schema))
+
+ const layerDirs = getLayerDirectories(nuxt)
+
+ // Watch for schema changes in development mode
+ if (nuxt.options.dev) {
+ const onChange = debounce(async () => {
+ schema = await resolveSchema()
+ await writeSchema(schema)
+ })
+
+ if (nuxt.options.experimental.watcher === 'parcel') {
+ try {
+ const { subscribe } = await importModule<typeof import('@parcel/watcher')>('@parcel/watcher', {
+ url: [nuxt.options.rootDir, ...nuxt.options.modulesDir].map(dir => directoryToURL(dir)),
+ })
+ for (const dirs of layerDirs) {
+ const subscription = await subscribe(dirs.root, onChange, {
+ ignore: ['!nuxt.schema.*'],
+ })
+ nuxt.hook('close', () => subscription.unsubscribe())
+ }
+ return
+ } catch {
+ logger.warn('Falling back to `chokidar` as `@parcel/watcher` cannot be resolved in your project.')
+ }
+ }
+
+ const isIgnored = createIsIgnored(nuxt)
+ const rootDirs = layerDirs.map(layer => layer.root)
+ const SCHEMA_RE = /(?:^|\/)nuxt.schema.\w+$/
+ const watcher = watch(rootDirs, {
+ ...nuxt.options.watchers.chokidar,
+ depth: 1,
+ ignored: [
+ (path, stats) => (stats && !stats.isFile()) || !SCHEMA_RE.test(path),
+ isIgnored,
+ /[\\/]node_modules[\\/]/,
+ ],
+ ignoreInitial: true,
+ })
+ watcher.on('all', onChange)
+ nuxt.hook('close', () => watcher.close())
+ }
+
+ // --- utils ---
+
+ async function resolveSchema () {
+ // Global import
+ // @ts-expect-error adding to globalThis for 'auto-import' support within nuxt.config file
+ globalThis.defineNuxtSchema = (val: any) => val
+
+ // Load schema from layers
+ const schemaDefs: SchemaDefinition[] = [nuxt.options.$schema]
+ for (const dirs of layerDirs) {
+ const filePath = await resolver.resolvePath(join(dirs.root, 'nuxt.schema'))
+ if (filePath && existsSync(filePath)) {
+ let loadedConfig: SchemaDefinition
+ try {
+ // TODO: fix type for second argument of `import`
+ loadedConfig = await _resolveSchema.import(filePath, { default: true }) as SchemaDefinition
+ } catch (err) {
+ logger.warn(
+ 'Unable to load schema from',
+ filePath,
+ err,
+ )
+ continue
+ }
+ schemaDefs.push(loadedConfig)
+ }
+ }
+
+ // Allow hooking to extend custom schemas
+ await nuxt.hooks.callHook('schema:extend', schemaDefs)
+
+ // Resolve and merge schemas
+ const schemas = await Promise.all(
+ schemaDefs.map(schemaDef => resolveUntypedSchema(schemaDef)),
+ )
+
+ // Merge after normalization
+ const schema = defu(...schemas as [Schema, Schema])
+
+ // Allow hooking to extend resolved schema
+ await nuxt.hooks.callHook('schema:resolved', schema)
+
+ return schema
+ }
+
+ async function writeSchema (schema: Schema) {
+ await nuxt.hooks.callHook('schema:beforeWrite', schema)
+ // Write it to build dir
+ await mkdir(resolve(nuxt.options.buildDir, 'schema'), { recursive: true })
+ await writeFile(
+ resolve(nuxt.options.buildDir, 'schema/nuxt.schema.json'),
+ JSON.stringify(schema, null, 2),
+ 'utf8',
+ )
+ const _types = generateTypes(schema, {
+ addExport: true,
+ interfaceName: 'NuxtCustomSchema',
+ partial: true,
+ allowExtraKeys: false,
+ })
+ const types =
+ _types +
+ `
+export type CustomAppConfig = Exclude<NuxtCustomSchema['appConfig'], undefined>
+type _CustomAppConfig = CustomAppConfig
+
+declare module '@nuxt/schema' {
+ interface NuxtConfig extends Omit<NuxtCustomSchema, 'appConfig'> {}
+ interface NuxtOptions extends Omit<NuxtCustomSchema, 'appConfig'> {}
+ interface CustomAppConfig extends _CustomAppConfig {}
+}
+
+declare module 'nuxt/schema' {
+ interface NuxtConfig extends Omit<NuxtCustomSchema, 'appConfig'> {}
+ interface NuxtOptions extends Omit<NuxtCustomSchema, 'appConfig'> {}
+ interface CustomAppConfig extends _CustomAppConfig {}
+}
+`
+ const typesPath = resolve(nuxt.options.buildDir, 'schema/nuxt.schema.d.ts')
+ await writeFile(typesPath, types, 'utf8')
+ await nuxt.hooks.callHook('schema:written')
+ }
+ },
+})
diff --git a/packages/nuxt/src/core/server.ts b/packages/nuxt/src/core/server.ts
new file mode 100644
index 000000000000..e2c114cb9195
--- /dev/null
+++ b/packages/nuxt/src/core/server.ts
@@ -0,0 +1,29 @@
+import { directoryToURL, importModule } from '@nuxt/kit'
+
+import type { Nuxt, NuxtBuilder } from 'nuxt/schema'
+
+export async function bundleServer (nuxt: Nuxt) {
+ try {
+ const { bundle } = !nuxt.options.server.builder || typeof nuxt.options.server.builder === 'string'
+ ? await loadServerBuilder(nuxt, nuxt.options.server.builder)
+ : nuxt.options.server.builder
+
+ await bundle(nuxt)
+ } catch (error: any) {
+ await nuxt.callHook('build:error', error)
+
+ throw error
+ }
+}
+
+async function loadServerBuilder (nuxt: Nuxt, builder = '@nuxt/nitro-server'): Promise<NuxtBuilder> {
+ try {
+ // prefer our own dependency tree before walking up from rootDir
+ if (builder === '@nuxt/nitro-server') {
+ return await import(builder)
+ }
+ return await importModule(builder, { url: [new URL(import.meta.url), directoryToURL(nuxt.options.rootDir)] })
+ } catch (err) {
+ throw new Error(`Loading \`${builder}\` server builder failed. You can read more about the nuxt \`server.builder\` option at: \`https://nuxt.com/docs/4.x/api/nuxt-config#builder-1\``, { cause: err })
+ }
+}
diff --git a/packages/nuxt/src/core/templates.ts b/packages/nuxt/src/core/templates.ts
new file mode 100644
index 000000000000..6aa5785d08d6
--- /dev/null
+++ b/packages/nuxt/src/core/templates.ts
@@ -0,0 +1,608 @@
+import { existsSync } from 'node:fs'
+import { genArrayFromRaw, genDynamicImport, genExport, genImport, genObjectFromRawEntries, genSafeVariableName, genString } from 'knitwork'
+import { join, relative, resolve } from 'pathe'
+import type { JSValue } from 'untyped'
+import { generateTypes, resolveSchema } from 'untyped'
+import escapeRE from 'escape-string-regexp'
+import { hash } from 'ohash'
+import { camelCase } from 'scule'
+import { filename, reverseResolveAlias } from 'pathe/utils'
+import { useNitro } from '@nuxt/kit'
+
+import { annotatePlugins, checkForCircularDependencies } from './app.ts'
+import { EXTENSION_RE } from './utils/index.ts'
+import type { NuxtOptions, NuxtTemplate } from 'nuxt/schema'
+import type { Nitro } from 'nitro/types'
+
+export const vueShim: NuxtTemplate = {
+ filename: 'types/vue-shim.d.ts',
+ getContents: ({ nuxt }) => {
+ if (!nuxt.options.typescript.shim) {
+ return ''
+ }
+
+ return [
+ 'declare module \'*.vue\' {',
+ ' import { DefineComponent } from \'vue\'',
+ ' const component: DefineComponent<{}, {}, any>',
+ ' export default component',
+ '}',
+ ].join('\n')
+ },
+}
+
+// TODO: Use an alias
+export const appComponentTemplate: NuxtTemplate = {
+ filename: 'app-component.mjs',
+ getContents: ctx => genExport(ctx.app.mainComponent!, ['default']),
+}
+// TODO: Use an alias
+export const rootComponentTemplate: NuxtTemplate = {
+ filename: 'root-component.mjs',
+ // TODO: fix upstream in vite - this ensures that vite generates a module graph for islands
+ // but should not be necessary (and has a warmup performance cost). See https://github.com/nuxt/nuxt/pull/24584.
+ getContents: ctx => (ctx.nuxt.options.dev ? 'import \'#build/components.islands.mjs\';\n' : '') + genExport(ctx.app.rootComponent!, ['default']),
+}
+// TODO: Use an alias
+export const errorComponentTemplate: NuxtTemplate = {
+ filename: 'error-component.mjs',
+ getContents: ctx => genExport(ctx.app.errorComponent!, ['default']),
+}
+// TODO: Use an alias
+export const testComponentWrapperTemplate: NuxtTemplate = {
+ filename: 'test-component-wrapper.mjs',
+ getContents: ctx => genExport(resolve(ctx.nuxt.options.appDir, 'components/test-component-wrapper'), ['default']),
+}
+
+export const cssTemplate: NuxtTemplate = {
+ filename: 'css.mjs',
+ getContents: ctx => ctx.nuxt.options.css.map(i => genImport(i)).join('\n'),
+}
+
+const PLUGIN_TEMPLATE_RE = /_(?:45|46|47)/g
+export const clientPluginTemplate: NuxtTemplate = {
+ filename: 'plugins.client.mjs',
+ async getContents (ctx) {
+ const clientPlugins = await annotatePlugins(ctx.nuxt, ctx.app.plugins.filter(p => !p.mode || p.mode !== 'server'))
+ checkForCircularDependencies(clientPlugins)
+ const exports: string[] = []
+ const imports: string[] = []
+ for (const plugin of clientPlugins) {
+ const path = relative(ctx.nuxt.options.rootDir, plugin.src)
+ const variable = genSafeVariableName(filename(plugin.src) || path).replace(PLUGIN_TEMPLATE_RE, '_') + '_' + hash(path).replace(/-/g, '_')
+ exports.push(variable)
+ imports.push(genImport(plugin.src, variable))
+ }
+ return [
+ ...imports,
+ `export default ${genArrayFromRaw(exports)}`,
+ ].join('\n')
+ },
+}
+
+export const serverPluginTemplate: NuxtTemplate = {
+ filename: 'plugins.server.mjs',
+ async getContents (ctx) {
+ const serverPlugins = await annotatePlugins(ctx.nuxt, ctx.app.plugins.filter(p => !p.mode || p.mode !== 'client'))
+ checkForCircularDependencies(serverPlugins)
+ const exports: string[] = []
+ const imports: string[] = []
+ for (const plugin of serverPlugins) {
+ const path = relative(ctx.nuxt.options.rootDir, plugin.src)
+ const variable = genSafeVariableName(filename(plugin.src) || path).replace(PLUGIN_TEMPLATE_RE, '_') + '_' + hash(path).replace(/-/g, '_')
+ exports.push(variable)
+ imports.push(genImport(plugin.src, variable))
+ }
+ return [
+ ...imports,
+ `export default ${genArrayFromRaw(exports)}`,
+ ].join('\n')
+ },
+}
+
+const TS_RE = /\.[cm]?tsx?$/
+const JS_LETTER_RE = /\.(?<letter>[cm])?jsx?$/
+const JS_RE = /\.[cm]jsx?$/
+const JS_CAPTURE_RE = /\.[cm](jsx?)$/
+export const pluginsDeclaration: NuxtTemplate = {
+ filename: 'types/plugins.d.ts',
+ getContents: async ({ nuxt, app }) => {
+ const EXTENSION_RE = new RegExp(`(?<=\\w)(${nuxt.options.extensions.map(e => escapeRE(e)).join('|')})$`, 'g')
+
+ const typesDir = join(nuxt.options.buildDir, 'types')
+ const tsImports: string[] = []
+ const pluginNames: string[] = []
+
+ function exists (path: string) {
+ return app.templates.some(t => t.write && path === t.dst) || existsSync(path)
+ }
+
+ for (const plugin of await annotatePlugins(nuxt, app.plugins)) {
+ if (plugin.name) {
+ pluginNames.push(`'${plugin.name}'`)
+ }
+
+ const pluginPath = resolve(typesDir, plugin.src)
+ const relativePath = relative(typesDir, pluginPath)
+
+ const correspondingDeclaration = pluginPath.replace(JS_LETTER_RE, '.d.$<letter>ts')
+ // if `.d.ts` file exists alongside a `.js` plugin, or if `.d.mts` file exists alongside a `.mjs` plugin, we can use the entire path
+ if (correspondingDeclaration !== pluginPath && exists(correspondingDeclaration)) {
+ tsImports.push(relativePath)
+ continue
+ }
+
+ const incorrectDeclaration = pluginPath.replace(JS_RE, '.d.ts')
+ // if `.d.ts` file exists, but plugin is `.mjs`, add `.js` extension to the import
+ // to hotfix issue until ecosystem updates to `@nuxt/module-builder@>=0.8.0`
+ if (incorrectDeclaration !== pluginPath && exists(incorrectDeclaration)) {
+ tsImports.push(relativePath.replace(JS_CAPTURE_RE, '.$1'))
+ continue
+ }
+
+ // if there is no declaration we only want to remove the extension if it's a TypeScript file
+ if (exists(pluginPath)) {
+ if (TS_RE.test(pluginPath)) {
+ tsImports.push(relativePath.replace(EXTENSION_RE, ''))
+ continue
+ }
+ tsImports.push(relativePath)
+ }
+
+ // No declaration found that TypeScript can use
+ }
+
+ return `// Generated by Nuxt'
+import type { Plugin } from '#app'
+
+type Decorate<T extends Record<string, any>> = { [K in keyof T as K extends string ? \`$\${K}\` : never]: T[K] }
+
+type InjectionType<A extends Plugin> = A extends {default: Plugin<infer T>} ? Decorate<T> : unknown
+
+type NuxtAppInjections = \n ${tsImports.map(p => `InjectionType<typeof ${genDynamicImport(p, { wrapper: false })}>`).join(' &\n ')}
+
+declare module '#app' {
+ interface NuxtApp extends NuxtAppInjections { }
+
+ interface NuxtAppLiterals {
+ pluginName: ${pluginNames.join(' | ')}
+ }
+}
+
+declare module 'vue' {
+ interface ComponentCustomProperties extends NuxtAppInjections { }
+}
+
+export { }
+`
+ },
+}
+
+const IMPORT_NAME_RE = /\.\w+$/
+const GIT_RE = /^git\+/
+export const schemaTemplate: NuxtTemplate = {
+ filename: 'types/runtime-config.d.ts',
+ getContents: async ({ nuxt }) => {
+ const privateRuntimeConfig = Object.create(null)
+ for (const key in nuxt.options.runtimeConfig) {
+ if (key !== 'public') {
+ privateRuntimeConfig[key] = nuxt.options.runtimeConfig[key]
+ }
+ }
+
+ return [
+ `import { RuntimeConfig as UserRuntimeConfig, PublicRuntimeConfig as UserPublicRuntimeConfig } from 'nuxt/schema'`,
+ generateTypes(await resolveSchema(privateRuntimeConfig as Record<string, JSValue>),
+ {
+ interfaceName: 'SharedRuntimeConfig',
+ addExport: false,
+ addDefaults: false,
+ allowExtraKeys: false,
+ indentation: 2,
+ }),
+ generateTypes(await resolveSchema(nuxt.options.runtimeConfig.public as Record<string, JSValue>),
+ {
+ interfaceName: 'SharedPublicRuntimeConfig',
+ addExport: false,
+ addDefaults: false,
+ allowExtraKeys: false,
+ indentation: 2,
+ }),
+ `declare module '@nuxt/schema' {`,
+ ` interface RuntimeConfig extends UserRuntimeConfig {}`,
+ ` interface PublicRuntimeConfig extends UserPublicRuntimeConfig {}`,
+ `}`,
+ `declare module 'nuxt/schema' {`,
+ ` interface RuntimeConfig extends SharedRuntimeConfig {}`,
+ ` interface PublicRuntimeConfig extends SharedPublicRuntimeConfig {}`,
+ '}',
+ `declare module 'vue' {
+ interface ComponentCustomProperties {
+ $config: UserRuntimeConfig
+ }
+ }`,
+ ].join('\n')
+ },
+}
+export const schemaNodeTemplate: NuxtTemplate = {
+ filename: 'types/modules.d.ts',
+ getContents: ({ nuxt }) => {
+ const relativeRoot = relative(resolve(nuxt.options.buildDir, 'types'), nuxt.options.rootDir)
+ const getImportName = (name: string) => (name[0] === '.' ? './' + join(relativeRoot, name) : name).replace(IMPORT_NAME_RE, '')
+
+ const modules: [string, string, NuxtOptions['_installedModules'][number]][] = []
+ for (const m of nuxt.options._installedModules) {
+ // modules without sufficient metadata
+ if (!m.meta || !m.meta.configKey || !m.meta.name) {
+ continue
+ }
+ // core nuxt modules
+ if (m.meta.name.startsWith('nuxt:') || m.meta.name === 'nuxt-config-schema') {
+ continue
+ }
+ modules.push([genString(m.meta.configKey), getImportName(m.entryPath || m.meta.name), m])
+ }
+
+ const moduleOptionsInterface = (options: { addJSDocTags: boolean, unresolved: boolean }) => [
+ ...modules.flatMap(([configKey, importName, mod]) => {
+ let link: string | undefined
+
+ // If it's not a local module, provide a link based on its name
+ if (!mod.meta?.rawPath) {
+ link = `https://www.npmjs.com/package/${importName}`
+ }
+
+ if (typeof mod.meta?.docs === 'string') {
+ link = mod.meta.docs
+ } else if (mod.meta?.repository) {
+ if (typeof mod.meta.repository === 'string') {
+ link = mod.meta.repository
+ } else if (typeof mod.meta.repository === 'object' && 'url' in mod.meta.repository && typeof mod.meta.repository.url === 'string') {
+ link = mod.meta.repository.url
+ }
+ if (link) {
+ if (link.startsWith('git+')) {
+ link = link.replace(GIT_RE, '')
+ }
+ if (!link.startsWith('http')) {
+ link = 'https://github.com/' + link
+ }
+ }
+ }
+
+ return [
+ ` /**`,
+ ` * Configuration for \`${importName}\``,
+ ...options.addJSDocTags && link ? [` * @see ${link}`] : [],
+ ` */`,
+ ` [${configKey}]${options.unresolved ? '?' : ''}: typeof ${genDynamicImport(importName, { wrapper: false })}.default extends NuxtModule<infer O, unknown, boolean> ? ${options.unresolved ? 'Partial<O>' : 'O'} | false : Record<string, any> | false`,
+ ]
+ }),
+ modules.length > 0 && options.unresolved ? ` modules?: (undefined | null | false | NuxtModule<any> | string | [NuxtModule | string, Record<string, any>] | ${modules.map(([configKey, importName, mod]) => `[${genString(mod.meta?.rawPath || importName)}, Exclude<NuxtConfig[${configKey}], boolean>]`).join(' | ')})[],` : '',
+ ].filter(Boolean)
+
+ const moduleDependencies = modules.flatMap(([_configKey, importName, mod]) => [
+ ` [${genString(mod.meta.name || importName)}]?: ModuleDependencyMeta<typeof ${genDynamicImport(importName, { wrapper: false })}.default extends NuxtModule<infer O> ? O | false : Record<string, unknown>> | false`,
+ ]).join('\n')
+
+ return [
+ 'import { NuxtModule, ModuleDependencyMeta } from \'@nuxt/schema\'',
+ 'declare module \'@nuxt/schema\' {',
+ ' interface ModuleDependencies {',
+ moduleDependencies,
+ ' }',
+ ' interface NuxtOptions {',
+ ...moduleOptionsInterface({ addJSDocTags: false, unresolved: false }),
+ ' }',
+ ' interface NuxtConfig {',
+ // TypeScript will duplicate the jsdoc tags if we augment it twice
+ // So here we only generate tags for `nuxt/schema`
+ ...moduleOptionsInterface({ addJSDocTags: false, unresolved: true }),
+ ' }',
+ '}',
+ 'declare module \'nuxt/schema\' {',
+ ' interface ModuleDependencies {',
+ moduleDependencies,
+ ' }',
+ ' interface NuxtOptions {',
+ ...moduleOptionsInterface({ addJSDocTags: true, unresolved: false }),
+ ' }',
+ ' interface NuxtConfig {',
+ ...moduleOptionsInterface({ addJSDocTags: true, unresolved: true }),
+ ' }',
+ '}',
+ ].join('\n')
+ },
+}
+
+// Add layouts template
+export const layoutTemplate: NuxtTemplate = {
+ filename: 'layouts.mjs',
+ getContents ({ app }) {
+ const layoutsObject = genObjectFromRawEntries(Object.values(app.layouts).map(({ name, file }) => {
+ return [name, `defineAsyncComponent(${genDynamicImport(file, { interopDefault: true })})`]
+ }))
+ return [
+ `import { defineAsyncComponent } from 'vue'`,
+ `export default ${layoutsObject}`,
+ ].join('\n')
+ },
+}
+
+// Add middleware template
+export const middlewareTemplate: NuxtTemplate = {
+ filename: 'middleware.mjs',
+ getContents ({ app, nuxt }) {
+ const globalMiddleware = app.middleware.filter(mw => mw.global)
+ const namedMiddleware = app.middleware.filter(mw => !mw.global)
+ const alias = nuxt.options.dev ? { ...nuxt?.options.alias || {}, ...strippedAtAliases } : {}
+ return [
+ ...globalMiddleware.map(mw => genImport(mw.path, genSafeVariableName(mw.name))),
+ ...!nuxt.options.dev
+ ? [
+ `export const globalMiddleware = ${genArrayFromRaw(globalMiddleware.map(mw => genSafeVariableName(mw.name)))}`,
+ `export const namedMiddleware = ${genObjectFromRawEntries(namedMiddleware.map(mw => [mw.name, genDynamicImport(mw.path)]))}`,
+ ]
+ : [
+ `const _globalMiddleware = ${genObjectFromRawEntries(globalMiddleware.map(mw => [reverseResolveAlias(mw.path, alias).pop() || mw.path, genSafeVariableName(mw.name)]))}`,
+ `for (const path in _globalMiddleware) {`,
+ ` Object.defineProperty(_globalMiddleware[path], '_path', { value: path, configurable: true })`,
+ `}`,
+ `export const globalMiddleware = Object.values(_globalMiddleware)`,
+ `const _namedMiddleware = ${genArrayFromRaw(namedMiddleware.map(mw => ({
+ name: genString(mw.name),
+ path: genString(reverseResolveAlias(mw.path, alias).pop() || mw.path),
+ import: genDynamicImport(mw.path),
+ })))}`,
+ `for (const mw of _namedMiddleware) {`,
+ ` const i = mw.import`,
+ ` mw.import = () => i().then(r => {`,
+ ` Object.defineProperty(r.default || r, '_path', { value: mw.path, configurable: true })`,
+ ` return r`,
+ ` })`,
+ `}`,
+ `export const namedMiddleware = Object.fromEntries(_namedMiddleware.map(mw => [mw.name, mw.import]))`,
+ ],
+
+ ].join('\n')
+ },
+}
+
+export const clientConfigTemplate: NuxtTemplate = {
+ filename: 'nitro.client.mjs',
+ getContents: ({ nuxt }) => {
+ const appId = JSON.stringify(nuxt.options.appId)
+ return [
+ 'export const useRuntimeConfig = () => ',
+ (!nuxt.options.future.multiApp
+ ? 'window?.__NUXT__?.config || window?.useNuxtApp?.().payload?.config'
+ : `window?.__NUXT__?.[${appId}]?.config || window?.useNuxtApp?.(${appId}).payload?.config`)
+ || {},
+ ].join('\n')
+ },
+}
+
+export const appConfigDeclarationTemplate: NuxtTemplate = {
+ filename: 'types/app.config.d.ts',
+ getContents ({ app, nuxt }) {
+ const typesDir = join(nuxt.options.buildDir, 'types')
+ const configPaths = app.configs.map(path => relative(typesDir, path).replace(EXTENSION_RE, ''))
+
+ return `
+import type { AppConfigInput, CustomAppConfig } from 'nuxt/schema'
+import type { Defu } from 'defu'
+${configPaths.map((id: string, index: number) => `import ${`cfg${index}`} from ${JSON.stringify(id)}`).join('\n')}
+
+declare global {
+ const defineAppConfig: <C extends AppConfigInput> (config: C) => C
+}
+
+declare const inlineConfig = ${JSON.stringify(nuxt.options.appConfig, null, 2)}
+type ResolvedAppConfig = Defu<typeof inlineConfig, [${app.configs.map((_id: string, index: number) => `typeof cfg${index}`).join(', ')}]>
+type IsAny<T> = 0 extends 1 & T ? true : false
+
+type MergedAppConfig<Resolved extends Record<string, unknown>, Custom extends Record<string, unknown>> = {
+ [K in keyof (Resolved & Custom)]: K extends keyof Custom
+ ? unknown extends Custom[K]
+ ? Resolved[K]
+ : IsAny<Custom[K]> extends true
+ ? Resolved[K]
+ : Custom[K] extends Record<string, any>
+ ? Resolved[K] extends Record<string, any>
+ ? MergedAppConfig<Resolved[K], Custom[K]>
+ : Exclude<Custom[K], undefined>
+ : Exclude<Custom[K], undefined>
+ : Resolved[K]
+}
+
+declare module 'nuxt/schema' {
+ interface AppConfig extends MergedAppConfig<ResolvedAppConfig, CustomAppConfig> { }
+}
+declare module '@nuxt/schema' {
+ interface AppConfig extends MergedAppConfig<ResolvedAppConfig, CustomAppConfig> { }
+}
+`
+ },
+}
+
+export const appConfigTemplate: NuxtTemplate = {
+ filename: 'app.config.mjs',
+ write: true,
+ getContents ({ app, nuxt }) {
+ return `
+import { defuFn } from 'defu'
+
+const inlineConfig = ${JSON.stringify(nuxt.options.appConfig, null, 2)}
+
+/** client **/
+import { _replaceAppConfig } from '#app/config'
+
+// Vite - webpack is handled directly in #app/config
+if (import.meta.dev && !import.meta.nitro && import.meta.hot) {
+ import.meta.hot.accept((newModule) => {
+ _replaceAppConfig(newModule.default)
+ })
+}
+/** client-end **/
+
+${app.configs.map((id: string, index: number) => `import ${`cfg${index}`} from ${JSON.stringify(id)}`).join('\n')}
+
+export default /*@__PURE__*/ defuFn(${app.configs.map((_id: string, index: number) => `cfg${index}`).concat(['inlineConfig']).join(', ')})
+`
+ },
+}
+
+export const publicPathTemplate: NuxtTemplate = {
+ filename: 'paths.mjs',
+ getContents ({ nuxt }) {
+ return [
+ 'import { joinRelativeURL } from \'ufo\'',
+ !nuxt.options.dev && 'import { useRuntimeConfig } from \'nitro/runtime-config\'',
+
+ nuxt.options.dev
+ ? `const getAppConfig = () => (${JSON.stringify(nuxt.options.app)})`
+ : 'const getAppConfig = () => useRuntimeConfig().app',
+
+ 'export const baseURL = () => getAppConfig().baseURL',
+ 'export const buildAssetsDir = () => getAppConfig().buildAssetsDir',
+
+ 'export const buildAssetsURL = (...path) => joinRelativeURL(publicAssetsURL(), buildAssetsDir(), ...path)',
+
+ 'export const publicAssetsURL = (...path) => {',
+ ' const appConfig = getAppConfig()',
+ ' const publicBase = appConfig.cdnURL || appConfig.baseURL',
+ ' return path.length ? joinRelativeURL(publicBase, ...path) : publicBase',
+ '}',
+
+ // On server these are registered directly in packages/nuxt/src/core/runtime/nitro/handlers/renderer.ts
+ 'if (import.meta.client) {',
+ ' globalThis.__buildAssetsURL = buildAssetsURL',
+ ' globalThis.__publicAssetsURL = publicAssetsURL',
+ '}',
+ ].filter(Boolean).join('\n')
+ },
+}
+
+export const globalPolyfillsTemplate: NuxtTemplate = {
+ filename: 'global-polyfills.mjs',
+ getContents () {
+ // Node.js compatibility
+ return `
+if (!("global" in globalThis)) {
+ globalThis.global = globalThis;
+}`
+ },
+}
+
+export const dollarFetchTemplate: NuxtTemplate = {
+ filename: 'fetch.server.mjs',
+ getContents () {
+ return [
+ 'import { $fetch } from \'ofetch\'',
+ 'import { baseURL } from \'#internal/nuxt/paths\'',
+ 'import { serverFetch } from "nitro";',
+ 'globalThis.fetch = serverFetch',
+ 'if (!globalThis.$fetch) {',
+ ' globalThis.$fetch = $fetch.create({',
+ ' baseURL: baseURL()',
+ ' })',
+ '}',
+ ].join('\n')
+ },
+}
+
+export const dollarFetchClientTemplate: NuxtTemplate = {
+ filename: 'fetch.client.mjs',
+ getContents () {
+ return [
+ 'import { $fetch } from \'ofetch\'',
+ 'import { baseURL } from \'#internal/nuxt/paths\'',
+ 'if (!globalThis.$fetch) {',
+ ' globalThis.$fetch = $fetch.create({',
+ ' baseURL: baseURL()',
+ ' })',
+ '}',
+ ].join('\n')
+ },
+}
+
+// Allow direct access to specific exposed nuxt.config
+export const nuxtConfigTemplate: NuxtTemplate = {
+ filename: 'nuxt.config.mjs',
+ getContents: (ctx) => {
+ const fetchDefaults = {
+ ...ctx.nuxt.options.experimental.defaults.useFetch,
+ baseURL: undefined,
+ headers: undefined,
+ }
+ const shouldEnableComponentIslands = ctx.nuxt.options.experimental.componentIslands && (
+ ctx.nuxt.options.dev || ctx.nuxt.options.experimental.componentIslands !== 'auto' || ctx.app.pages?.some(p => p.mode === 'server') || ctx.app.components?.some(c => c.mode === 'server' && !ctx.app.components.some(other => other.pascalName === c.pascalName && other.mode === 'client'))
+ )
+ const nitro = useNitro() as Nitro
+
+ const hasCachedRoutes = nitro.routing.routeRules.routes.some(r => r.data.isr || r.data.cache)
+ const payloadExtraction = !!ctx.nuxt.options.experimental.payloadExtraction && (nitro.options.static || hasCachedRoutes || (nitro.options.prerender.routes && nitro.options.prerender.routes.length > 0) || nitro.routing.routeRules.routes.some(r => r.data.prerender))
+ return [
+ ...Object.entries(ctx.nuxt.options.app).map(([k, v]) => `export const ${camelCase('app-' + k)} = ${JSON.stringify(v)}`),
+ `export const componentIslands = ${shouldEnableComponentIslands}`,
+ `export const payloadExtraction = ${payloadExtraction}`,
+ `export const prefetchPreloadTags = ${!!ctx.nuxt.options.experimental.prefetchPreloadTags}`,
+ `export const cookieStore = ${!!ctx.nuxt.options.experimental.cookieStore}`,
+ `export const appManifest = ${!!ctx.nuxt.options.experimental.appManifest}`,
+ `export const remoteComponentIslands = ${typeof ctx.nuxt.options.experimental.componentIslands === 'object' && ctx.nuxt.options.experimental.componentIslands.remoteIsland}`,
+ `export const selectiveClient = ${typeof ctx.nuxt.options.experimental.componentIslands === 'object' && Boolean(ctx.nuxt.options.experimental.componentIslands.selectiveClient)}`,
+ `export const devPagesDir = ${ctx.nuxt.options.dev ? JSON.stringify(ctx.nuxt.options.dir.pages) : 'null'}`,
+ `export const devRootDir = ${ctx.nuxt.options.dev ? JSON.stringify(ctx.nuxt.options.rootDir) : 'null'}`,
+ `export const devLogs = ${JSON.stringify(ctx.nuxt.options.features.devLogs)}`,
+ `export const nuxtLinkDefaults = ${JSON.stringify(ctx.nuxt.options.experimental.defaults.nuxtLink)}`,
+ `export const asyncDataDefaults = ${JSON.stringify(ctx.nuxt.options.experimental.defaults.useAsyncData)}`,
+ `export const useStateDefaults = ${JSON.stringify(ctx.nuxt.options.experimental.defaults.useState)}`,
+ `export const fetchDefaults = ${JSON.stringify(fetchDefaults)}`,
+ `export const vueAppRootContainer = ${ctx.nuxt.options.app.rootAttrs.id ? `'#${ctx.nuxt.options.app.rootAttrs.id}'` : `'body > ${ctx.nuxt.options.app.rootTag}'`}`,
+ `export const viewTransition = ${ctx.nuxt.options.experimental.viewTransition}`,
+ `export const appId = ${JSON.stringify(ctx.nuxt.options.appId)}`,
+ `export const outdatedBuildInterval = ${ctx.nuxt.options.experimental.checkOutdatedBuildInterval}`,
+ `export const multiApp = ${!!ctx.nuxt.options.future.multiApp}`,
+ `export const chunkErrorEvent = ${ctx.nuxt.options.experimental.emitRouteChunkError ? ctx.nuxt.options.builder === '@nuxt/vite-builder' ? '"vite:preloadError"' : '"nuxt:preloadError"' : 'false'}`,
+ `export const crawlLinks = ${!!nitro.options.prerender.crawlLinks}`,
+ `export const spaLoadingTemplateOutside = ${ctx.nuxt.options.experimental.spaLoadingTemplateLocation === 'body'}`,
+ `export const purgeCachedData = ${!!ctx.nuxt.options.experimental.purgeCachedData}`,
+ `export const granularCachedData = ${!!ctx.nuxt.options.experimental.granularCachedData}`,
+ `export const pendingWhenIdle = ${!!ctx.nuxt.options.experimental.pendingWhenIdle}`,
+ `export const alwaysRunFetchOnKeyChange = ${!!ctx.nuxt.options.experimental.alwaysRunFetchOnKeyChange}`,
+ `export const asyncCallHook = ${!!ctx.nuxt.options.experimental.asyncCallHook}`,
+ `export const clientNodePlaceholder = ${!!ctx.nuxt.options.experimental.clientNodePlaceholder}`,
+ ].join('\n\n')
+ },
+}
+
+const TYPE_FILENAME_RE = /\.([cm])?[jt]s$/
+const DECLARATION_RE = /\.d\.[cm]?ts$/
+export const buildTypeTemplate: NuxtTemplate = {
+ filename: 'types/build.d.ts',
+ getContents ({ app }) {
+ let declarations = ''
+
+ for (const file of app.templates) {
+ if (file.write || !file.filename || DECLARATION_RE.test(file.filename)) {
+ continue
+ }
+
+ if (TYPE_FILENAME_RE.test(file.filename)) {
+ const typeFilenames = new Set([file.filename.replace(TYPE_FILENAME_RE, '.d.$1ts'), file.filename.replace(TYPE_FILENAME_RE, '.d.ts')])
+ if (app.templates.some(f => f.filename && typeFilenames.has(f.filename))) {
+ continue
+ }
+ }
+
+ declarations += 'declare module ' + JSON.stringify(join('#build', file.filename)) + ';\n'
+ }
+
+ return declarations
+ },
+}
+
+const strippedAtAliases = {
+ '@': '',
+ '@@': '',
+}
diff --git a/packages/nuxt/src/core/utils/index.ts b/packages/nuxt/src/core/utils/index.ts
new file mode 100644
index 000000000000..bf5be0bbdd3a
--- /dev/null
+++ b/packages/nuxt/src/core/utils/index.ts
@@ -0,0 +1,20 @@
+export { getNameFromPath, hasSuffix, resolveComponentNameSegments } from './names.ts'
+export { getLoader, isJS, isVue, parseModuleId } from './plugins.ts'
+
+export function uniqueBy<T, K extends keyof T> (arr: T[], key: K) {
+ if (arr.length < 2) {
+ return arr
+ }
+ const res: T[] = []
+ const seen = new Set<T[K]>()
+ for (const item of arr) {
+ if (seen.has(item[key])) { continue }
+ seen.add(item[key])
+ res.push(item)
+ }
+ return res
+}
+
+export const QUOTE_RE = /["']/g
+export const EXTENSION_RE = /\b\.\w+$/g
+export const SX_RE = /\.[tj]sx$/
diff --git a/packages/nuxt/src/core/utils/names.ts b/packages/nuxt/src/core/utils/names.ts
new file mode 100644
index 000000000000..4ba78b1b3bee
--- /dev/null
+++ b/packages/nuxt/src/core/utils/names.ts
@@ -0,0 +1,45 @@
+import { basename, dirname, extname, normalize } from 'pathe'
+import { kebabCase, splitByCase } from 'scule'
+import { withTrailingSlash } from 'ufo'
+import { QUOTE_RE } from './index.ts'
+
+export function getNameFromPath (path: string, relativeTo?: string) {
+ const relativePath = relativeTo
+ ? normalize(path).replace(withTrailingSlash(normalize(relativeTo)), '')
+ : basename(path)
+ const prefixParts = splitByCase(dirname(relativePath))
+ const fileName = basename(relativePath, extname(relativePath))
+ const segments = resolveComponentNameSegments(fileName.toLowerCase() === 'index' ? '' : fileName, prefixParts).filter(Boolean)
+ return kebabCase(segments).replace(QUOTE_RE, '')
+}
+
+export function hasSuffix (path: string, suffix: string) {
+ return basename(path, extname(path)).endsWith(suffix)
+}
+
+export function resolveComponentNameSegments (fileName: string, prefixParts: string[]) {
+ /**
+ * Array of fileName parts split by case, / or -
+ * @example third-component -> ['third', 'component']
+ * @example AwesomeComponent -> ['Awesome', 'Component']
+ */
+ const fileNameParts = splitByCase(fileName)
+ const fileNamePartsContent = fileNameParts.join('/').toLowerCase()
+ const componentNameParts: string[] = prefixParts.flatMap(p => splitByCase(p))
+ let index = prefixParts.length - 1
+ const matchedSuffix: string[] = []
+ while (index >= 0) {
+ const prefixPart = prefixParts[index]!
+ matchedSuffix.unshift(...splitByCase(prefixPart).map(p => p.toLowerCase()))
+ const matchedSuffixContent = matchedSuffix.join('/')
+ if ((fileNamePartsContent === matchedSuffixContent || fileNamePartsContent.startsWith(matchedSuffixContent + '/')) ||
+ // e.g. Item/Item/Item.vue -> Item
+ (prefixPart.toLowerCase() === fileNamePartsContent &&
+ prefixParts[index + 1] &&
+ prefixParts[index] === prefixParts[index + 1])) {
+ componentNameParts.length = index
+ }
+ index--
+ }
+ return [...componentNameParts, ...fileNameParts]
+}
diff --git a/packages/nuxt/src/core/utils/parse-utils.ts b/packages/nuxt/src/core/utils/parse-utils.ts
new file mode 100644
index 000000000000..9172750e46f0
--- /dev/null
+++ b/packages/nuxt/src/core/utils/parse-utils.ts
@@ -0,0 +1,369 @@
+import type { ESTree } from 'rolldown/utils'
+import type { ParsedStaticImport } from 'mlly'
+import { resolveAlias } from '@nuxt/kit'
+
+import { stripExtension } from '../../utils.ts'
+
+export function processImports (imports: ParsedStaticImport[], alias: Record<string, string>) {
+ /**
+ * import alias -> original name; source with aliases resolved and without extension
+ */
+ const directImports = new Map<string, {
+ originalName: string
+ /**
+ * import source with aliases resolved and without extension
+ */
+ source: string
+ }>()
+
+ /**
+ * import source with aliases resolved and without extension -> set of namespaces from that source
+ */
+ const namespaces = new Map<string, {
+ namespaces: Set<string>
+ }>()
+
+ for (const i of imports) {
+ const resolvedSpecifier = stripExtension(resolveAlias(i.specifier, alias))
+
+ // handle named imports
+ const namedImports = i.namedImports ?? {}
+
+ for (const originalIdentifier in namedImports) {
+ const localIdentifier = namedImports[originalIdentifier] || originalIdentifier
+ directImports.set(localIdentifier, {
+ originalName: originalIdentifier,
+ source: resolvedSpecifier,
+ })
+ }
+
+ if (i.namespacedImport || i.defaultImport) {
+ if (!namespaces.has(resolvedSpecifier)) {
+ namespaces.set(resolvedSpecifier, {
+ namespaces: new Set(),
+ })
+ }
+ }
+
+ if (i.defaultImport) {
+ // handle default import
+ const namespace = i.defaultImport
+ const entry = namespaces.get(resolvedSpecifier)!
+ entry.namespaces.add(namespace)
+ directImports.set(i.defaultImport, {
+ originalName: 'default',
+ source: resolvedSpecifier,
+ })
+ } else if (i.namespacedImport) {
+ // handle namespace import
+ const namespace = i.namespacedImport
+ const entry = namespaces.get(resolvedSpecifier)!
+ entry.namespaces.add(namespace)
+ }
+ }
+
+ return {
+ directImports,
+ namespaces,
+ }
+}
+
+export interface FunctionCallMetadata {
+ name: string
+ /**
+ * The name of the single-level namespace (object) the function belongs to,
+ * or null if it's a top-level function.
+ *
+ * @example
+ * foo() //-> null
+ * foo.bar() //-> 'foo'
+ * (foo.bar)() //-> 'foo'
+ * foo['bar']() //-> 'foo'
+ */
+ namespace: string | null
+ /**
+ * The callee node representing the function being called
+ * or the property being accessed in case of a member expression.
+ *
+ * @example
+ * foo() //-> Identifier node for `foo`
+ * foo.bar() //-> Identifier node for `bar`
+ * (foo.bar)() //-> Parenthesized Expression node for `foo.bar`
+ * foo['bar']() //-> Member Expression node for `foo['bar']`
+ */
+ node: ESTree.IdentifierReference | ESTree.MemberExpression | ESTree.ParenthesizedExpression
+ callExpression: ESTree.CallExpression
+}
+
+/**
+ * Checks if a node is a statically analyzable function call matching the given filter and returns parsed metadata about it.
+ *
+ * This is meant to statically identify functions and their origin in combination with scope tracking & imports analysis.
+ * @param node The AST node to check.
+ * @param filter A regular expression to match the function name.
+ * @returns An object containing the metadata about the function call, or null if it doesn't match.
+ */
+export function parseStaticFunctionCall (node: ESTree.CallExpression | ESTree.ChainExpression, filter: RegExp): FunctionCallMetadata | null {
+ // unwrap call expression
+ const callExpression = node.type === 'CallExpression'
+ ? node
+ : node.type === 'ChainExpression' && node.expression.type === 'CallExpression'
+ ? node.expression
+ : null
+ if (!callExpression) { return null }
+
+ // Simple function calls
+
+ let functionName: string | undefined
+ let identifierNode: FunctionCallMetadata['node'] | undefined
+ // foo()
+ if (callExpression.callee.type === 'Identifier') {
+ functionName = callExpression.callee.name
+ identifierNode = callExpression.callee
+ // (<identifier>)()
+ } else if (callExpression.callee.type === 'ParenthesizedExpression') {
+ // (foo)()
+ if (callExpression.callee.expression.type === 'Identifier') {
+ functionName = callExpression.callee.expression.name
+ identifierNode = callExpression.callee
+ // (foo as any)()
+ // (<any>foo)()
+ // (foo!)()
+ } else if (
+ (
+ callExpression.callee.expression.type === 'TSAsExpression'
+ || callExpression.callee.expression.type === 'TSTypeAssertion'
+ || callExpression.callee.expression.type === 'TSNonNullExpression'
+ )
+ && callExpression.callee.expression.expression.type === 'Identifier'
+ ) {
+ functionName = callExpression.callee.expression.expression.name
+ identifierNode = callExpression.callee
+ }
+ }
+
+ if (functionName && identifierNode && filter.test(functionName)) {
+ return {
+ name: functionName,
+ namespace: null,
+ node: identifierNode,
+ callExpression,
+ }
+ }
+
+ function getParsedMemberExpression (memberExpression: ESTree.MemberExpression): Omit<FunctionCallMetadata, 'callExpression'> | null {
+ // <object name>
+ let memberObjectName: string | undefined
+ // foo.bar()
+ if (memberExpression.object.type === 'Identifier') {
+ memberObjectName = memberExpression.object.name
+ // (foo).bar()
+ } else if (memberExpression.object.type === 'ParenthesizedExpression') {
+ if (memberExpression.object.expression.type === 'Identifier') {
+ memberObjectName = memberExpression.object.expression.name
+ // (foo as any).bar()
+ // (<any>foo).bar()
+ // (foo!).bar()
+ } else if (
+ (
+ memberExpression.object.expression.type === 'TSAsExpression'
+ || memberExpression.object.expression.type === 'TSTypeAssertion'
+ || memberExpression.object.expression.type === 'TSNonNullExpression'
+ )
+ && memberExpression.object.expression.expression.type === 'Identifier'
+ ) {
+ memberObjectName = memberExpression.object.expression.expression.name
+ }
+ }
+
+ // <property name>
+ if (memberObjectName) {
+ // foo.bar()
+ if (memberExpression.property.type === 'Identifier' && filter.test(memberExpression.property.name)) {
+ return {
+ name: memberExpression.property.name,
+ namespace: memberObjectName,
+ node: memberExpression.property,
+ }
+ }
+
+ // foo['bar']()
+ if (memberExpression.property.type === 'Literal' && typeof memberExpression.property.value === 'string' && filter.test(memberExpression.property.value)) {
+ return {
+ name: memberExpression.property.value,
+ namespace: memberObjectName,
+ node: memberExpression,
+ }
+ }
+ }
+
+ return null
+ }
+
+ // Member Expressions
+ // foo.bar()
+ if (callExpression.callee.type === 'MemberExpression') {
+ const val = getParsedMemberExpression(callExpression.callee)
+ if (val) {
+ return {
+ ...val,
+ callExpression,
+ }
+ }
+ } else if (callExpression.callee.type === 'ParenthesizedExpression') {
+ let innerExpression = callExpression.callee.expression
+
+ // (foo.bar as any)()
+ // (<any>foo.bar)()
+ // (foo.bar!)()
+ if (
+ (
+ innerExpression.type === 'TSAsExpression'
+ || innerExpression.type === 'TSTypeAssertion'
+ || innerExpression.type === 'TSNonNullExpression'
+ )
+ ) {
+ innerExpression = innerExpression.expression
+ }
+
+ // (foo.bar)()
+ if (innerExpression.type === 'MemberExpression') {
+ const val = getParsedMemberExpression(innerExpression)
+ if (val) {
+ return {
+ ...val,
+ node: callExpression.callee,
+ callExpression,
+ }
+ }
+ }
+ }
+
+ return null
+}
+
+export interface ExportMetadata {
+ localName: string
+ exportedName: string
+}
+
+/**
+ * Parses static export declarations to extract local and exported identifiers.
+ * Considers only runtime value exports (not types).
+ *
+ * Doesn't handle barrel exports, destructured exports, literals in export names, etc.
+ *
+ * @example
+ * ```ts
+ * export const foo = 1 // { localName: 'foo', exportedName: 'foo' }
+ * export function bar() {} // { localName: 'bar', exportedName: 'bar' }
+ * export class Baz {} // { localName: 'Baz', exportedName: 'Baz' }
+ * export { foo } // { localName: 'foo', exportedName: 'foo' }
+ * export { foo as bar } // { localName: 'foo', exportedName: 'bar' }
+ * export default function foo() {} // { localName: 'foo', exportedName: 'default' }
+ * export default class Bar {} // { localName: 'Bar', exportedName: 'default' }
+ * ```
+ * @param node the export declaration node to parse
+ * @param filter optional regex to filter based on exported names
+ */
+export function parseStaticExportIdentifiers (node: ESTree.ExportNamedDeclaration | ESTree.ExportDefaultDeclaration | ESTree.TSExportAssignment, filter?: RegExp): ExportMetadata[] {
+ // NAMED EXPORT -------------------------
+ if (node.type === 'ExportNamedDeclaration' && node.exportKind !== 'type') {
+ // export const, let, var
+ if (node.declaration?.type === 'VariableDeclaration') {
+ return node.declaration.declarations.map((d) => {
+ if (d.id.type === 'Identifier' && (!filter || filter.test(d.id.name))) {
+ return {
+ localName: d.id.name,
+ exportedName: d.id.name,
+ }
+ }
+ return null
+ }).filter((v): v is ExportMetadata => !!v)
+ }
+
+ // export function
+ if (node.declaration?.type === 'FunctionDeclaration') {
+ if (node.declaration.id?.type === 'Identifier' && (!filter || filter.test(node.declaration.id.name))) {
+ return [{
+ localName: node.declaration.id.name,
+ exportedName: node.declaration.id.name,
+ }]
+ }
+ return []
+ }
+
+ // export class
+ if (node.declaration?.type === 'ClassDeclaration') {
+ if (node.declaration.id?.type === 'Identifier' && (!filter || filter.test(node.declaration.id.name))) {
+ return [{
+ localName: node.declaration.id.name,
+ exportedName: node.declaration.id.name,
+ }]
+ }
+ return []
+ }
+
+ // export { foo, bar as baz }
+ if (node.specifiers && node.specifiers.length) {
+ return node.specifiers.map((s) => {
+ if (s.exported.type === 'Identifier' && s.exportKind !== 'type' && s.local.type === 'Identifier' && (!filter || filter.test(s.exported.name))) {
+ return {
+ localName: s.local.name,
+ exportedName: s.exported.name,
+ }
+ }
+ return null
+ }).filter((v): v is ExportMetadata => !!v)
+ }
+
+ return []
+ }
+
+ // DEFAULT EXPORT -------------------------
+ if (node.type === 'ExportDefaultDeclaration' && (!node.exportKind || node.exportKind === 'value')) {
+ // export default <identifier>
+ if (node.declaration.type === 'Identifier') {
+ return [{
+ localName: node.declaration.name,
+ exportedName: 'default',
+ }]
+ }
+
+ // export default function
+ if (node.declaration.type === 'FunctionDeclaration') {
+ if (node.declaration.id?.type === 'Identifier') {
+ return [{
+ localName: node.declaration.id.name,
+ exportedName: 'default',
+ }]
+ }
+ return []
+ }
+
+ // export default class
+ if (node.declaration.type === 'ClassDeclaration') {
+ if (node.declaration.id?.type === 'Identifier') {
+ return [{
+ localName: node.declaration.id.name,
+ exportedName: 'default',
+ }]
+ }
+ return []
+ }
+ }
+
+ if (node.type === 'TSExportAssignment') {
+ // export = <identifier>
+ if (node.expression.type === 'Identifier') {
+ if (!filter || filter.test(node.expression.name)) {
+ return [{
+ localName: node.expression.name,
+ exportedName: 'default',
+ }]
+ }
+ }
+ }
+
+ return []
+}
diff --git a/packages/nuxt/src/core/utils/parse.ts b/packages/nuxt/src/core/utils/parse.ts
new file mode 100644
index 000000000000..f492bc0a1cb7
--- /dev/null
+++ b/packages/nuxt/src/core/utils/parse.ts
@@ -0,0 +1,14 @@
+import { tryUseNuxt } from '@nuxt/kit'
+import { minifySync, transformSync } from 'rolldown/utils'
+import type { MinifyResult, TransformOptions, TransformResult } from 'rolldown/utils'
+
+export function transformAndMinify (input: string, options?: TransformOptions): TransformResult | MinifyResult {
+ const oxcOptions = tryUseNuxt()?.options.oxc
+ const transformResult = transformSync('', input, { tsconfig: false, ...oxcOptions?.transform.options, ...options })
+ const minifyResult = minifySync('', transformResult.code, { compress: { target: oxcOptions?.transform.options.target as 'esnext' || 'esnext' } })
+
+ return {
+ ...transformResult,
+ ...minifyResult,
+ }
+}
diff --git a/packages/nuxt/src/core/utils/plugins.ts b/packages/nuxt/src/core/utils/plugins.ts
new file mode 100644
index 000000000000..5744438375f5
--- /dev/null
+++ b/packages/nuxt/src/core/utils/plugins.ts
@@ -0,0 +1,82 @@
+import { extname } from 'pathe'
+
+/**
+ * Split a bundler module ID into its pathname and search (query) parts.
+ *
+ * Module IDs from Vite/webpack are already-normalized filesystem paths
+ * that may carry query strings (e.g. `?vue&type=style&lang=css`).
+ */
+export function parseModuleId (id: string): { pathname: string, search: string } {
+ const qIndex = id.indexOf('?')
+ if (qIndex === -1) {
+ return { pathname: id, search: '' }
+ }
+ return { pathname: id.slice(0, qIndex), search: id.slice(qIndex) }
+}
+
+const NUXT_COMPONENT_RE = /[?&]nuxt_component=/
+const MACRO_RE = /[?&]macro=/
+const VUE_QUERY_RE = /[?&]vue(?:&|$)/
+const SETUP_QUERY_RE = /[?&]setup(?:=|&|$)/
+const TYPE_QUERY_RE = /[?&]type=([^&]*)/
+
+export function isVue (id: string, opts: { type?: Array<'template' | 'script' | 'style'> } = {}) {
+ const { search } = parseModuleId(id)
+
+ // Bare `.vue` file (in Vite)
+ if (id.endsWith('.vue') && !search) {
+ return true
+ }
+
+ if (!search) {
+ return false
+ }
+
+ // Component async/lazy wrapper
+ if (NUXT_COMPONENT_RE.test(search)) {
+ return false
+ }
+
+ // Macro
+ if (MACRO_RE.test(search) && (search === '?macro=true' || !opts.type || opts.type.includes('script'))) {
+ return true
+ }
+
+ // Non-Vue or Styles
+ if (!VUE_QUERY_RE.test(search)) {
+ return false
+ }
+
+ if (opts.type) {
+ const type = SETUP_QUERY_RE.test(search) ? 'script' : TYPE_QUERY_RE.exec(search)?.[1] as 'script' | 'template' | 'style' | undefined
+ if (!type || !opts.type.includes(type)) {
+ return false
+ }
+ }
+
+ // Query `?vue&type=template` (in Webpack or external template)
+ return true
+}
+
+const JS_RE = /\.(?:[cm]?j|t)sx?$/
+
+/** Matches module IDs for Vue files (ignoring query strings). */
+export const VUE_ID_RE = /\.vue(?:\?|$)/
+
+export function isJS (id: string) {
+ // JavaScript files
+ const { pathname } = parseModuleId(id)
+ return JS_RE.test(pathname)
+}
+
+export function getLoader (id: string): 'vue' | 'ts' | 'tsx' | null {
+ const { pathname } = parseModuleId(id)
+ const ext = extname(pathname)
+ if (ext === '.vue') {
+ return 'vue'
+ }
+ if (!JS_RE.test(ext)) {
+ return null
+ }
+ return ext.endsWith('x') ? 'tsx' : 'ts'
+}
diff --git a/packages/nuxt/src/core/utils/types.ts b/packages/nuxt/src/core/utils/types.ts
new file mode 100644
index 000000000000..10701de5b840
--- /dev/null
+++ b/packages/nuxt/src/core/utils/types.ts
@@ -0,0 +1,61 @@
+import { resolvePackageJSON } from 'pkg-types'
+import { resolveModulePath } from 'exsolve'
+import { dirname } from 'pathe'
+import { directoryToURL } from '@nuxt/kit'
+
+const TYPE_RESOLVE_OPTIONS = {
+ conditions: ['types', 'import', 'require'] as string[],
+ extensions: ['.js', '.mjs', '.cjs', '.ts', '.mts', '.cts'],
+}
+
+const rootCache = new Map<string, Promise<string | undefined>>()
+
+function resolveRoot (basePkg: string, from: Array<string | URL> | undefined): Promise<string | undefined> {
+ if (rootCache.has(basePkg)) {
+ return rootCache.get(basePkg)!
+ }
+ const promise = _resolveRoot(basePkg, from)
+ rootCache.set(basePkg, promise)
+ return promise
+}
+
+async function _resolveRoot (basePkg: string, from: Array<string | URL> | undefined): Promise<string | undefined> {
+ try {
+ const r = resolveModulePath(basePkg, { from, ...TYPE_RESOLVE_OPTIONS })
+ const rootPath = await resolvePackageJSON(r)
+ return dirname(rootPath)
+ } catch {
+ return undefined
+ }
+}
+
+const NESTED_RE = /^[^@]+\//
+
+export async function resolveTypePaths (packages: string[], searchPaths: string[]): Promise<Array<[string, string]>> {
+ const results: Array<[string, string]> = []
+
+ const from = searchPaths.map(d => directoryToURL(d))
+
+ await Promise.allSettled(packages.map(async (pkg) => {
+ const [basePkg = pkg, sub] = NESTED_RE.test(pkg) ? pkg.split('/') : [pkg]
+ const subpath = sub ? '/' + sub : ''
+
+ const root = await resolveRoot(basePkg, from)
+ if (!root) {
+ return
+ }
+
+ if (!subpath) {
+ return results.push([pkg, root])
+ }
+
+ const r = resolveModulePath(pkg, {
+ from: directoryToURL(root),
+ ...TYPE_RESOLVE_OPTIONS,
+ })
+
+ results.push([pkg, r.replace(/(?:\.d)?\.[mc]?[jt]s$/, '')])
+ }))
+
+ return results
+}
diff --git a/packages/nuxt/src/dirs.ts b/packages/nuxt/src/dirs.ts
new file mode 100644
index 000000000000..1c9702bb5fb7
--- /dev/null
+++ b/packages/nuxt/src/dirs.ts
@@ -0,0 +1,7 @@
+import { fileURLToPath } from 'node:url'
+import { dirname, resolve } from 'pathe'
+
+let _distDir = dirname(fileURLToPath(import.meta.url))
+if (/(?:chunks|shared)$/.test(_distDir)) { _distDir = dirname(_distDir) }
+export const distDir = _distDir
+export const pkgDir = resolve(distDir, '..')
diff --git a/packages/nuxt/src/head/module.ts b/packages/nuxt/src/head/module.ts
new file mode 100644
index 000000000000..f7325011921c
--- /dev/null
+++ b/packages/nuxt/src/head/module.ts
@@ -0,0 +1,170 @@
+import { pathToFileURL } from 'node:url'
+import { resolve } from 'pathe'
+import { addBuildPlugin, addComponent, addPlugin, addTemplate, addVitePlugin, defineNuxtModule, directoryToURL, useLogger } from '@nuxt/kit'
+import type { NuxtOptions } from '@nuxt/schema'
+import { resolveModulePath } from 'exsolve'
+import { distDir } from '../dirs.ts'
+import { UnheadImportsPlugin } from './plugins/unhead-imports.ts'
+
+const components = ['NoScript', 'Link', 'Base', 'Title', 'Meta', 'Style', 'Head', 'Html', 'Body']
+
+export default defineNuxtModule<NuxtOptions['unhead']>({
+ meta: {
+ name: 'nuxt:meta',
+ configKey: 'unhead',
+ },
+ setup (options, nuxt) {
+ const logger = useLogger('nuxt:unhead')
+ const runtimeDir = resolve(distDir, 'head/runtime')
+
+ /* eslint-disable @typescript-eslint/no-deprecated */
+ const legacy = options.legacy
+ const headNext = nuxt.options.experimental.headNext
+ /* eslint-enable @typescript-eslint/no-deprecated */
+
+ // Transpile @unhead/vue
+ nuxt.options.build.transpile.push('@unhead/vue')
+
+ // Register components
+ const componentsPath = resolve(runtimeDir, 'components')
+ for (const componentName of components) {
+ addComponent({
+ name: componentName,
+ filePath: componentsPath,
+ export: componentName,
+ // built-in that we do not expect the user to override
+ priority: 10,
+ // kebab case version of these tags is not valid
+ kebabName: componentName,
+ })
+ }
+
+ nuxt.options.alias['#unhead/composables'] = resolve(runtimeDir, 'composables')
+ addBuildPlugin(UnheadImportsPlugin({
+ rootDir: nuxt.options.rootDir,
+ }))
+
+ // v5 users get tree-shaking via the @unhead/vue/vite plugin registered below.
+ // On v4 we fall back to Nuxt's composable tree-shaker so server composables
+ // still get stripped from the client bundle in production builds.
+ if (nuxt.options.future.compatibilityVersion < 5 && !nuxt.options.dev) {
+ nuxt.options.optimization.treeShake.composables.client['@unhead/vue'] = [
+ 'useServerHead', 'useServerSeoMeta', 'useServerHeadSafe',
+ ]
+ }
+
+ const importPaths = nuxt.options.modulesDir.map(d => directoryToURL(d))
+
+ // Register @unhead/vue/vite plugin for v5 compat mode
+ // Vite 8+ ships rolldown and lightningcss as direct deps, so minifiers
+ // are always available when using the vite builder. We resolve paths at
+ // setup time so dynamic imports resolve from vite's deps, not nuxt's.
+ if (nuxt.options.future.compatibilityVersion >= 5 && options.vite !== false && nuxt.options.builder === '@nuxt/vite-builder') {
+ const rolldownPath = resolveModulePath('rolldown/experimental', { try: true, from: importPaths })
+ const lightningcssPath = resolveModulePath('lightningcss', { try: true, from: importPaths })
+ // Convert to file:// URLs for Windows compatibility with dynamic import()
+ const rolldownURL = rolldownPath ? pathToFileURL(rolldownPath).href : undefined
+ const lightningcssURL = lightningcssPath ? pathToFileURL(lightningcssPath).href : undefined
+
+ addVitePlugin(async () => {
+ const { Unhead } = await import('@unhead/vue/vite')
+ const viteOptions = options.vite || {}
+ return Unhead({
+ validate: !nuxt.options.test,
+ minify: {
+ js: rolldownURL
+ ? async (code) => {
+ const { minify } = await import(rolldownURL)
+ return (await minify('inline.js', code)).code.trim()
+ }
+ : undefined,
+ css: lightningcssURL
+ ? async (code) => {
+ const { transform } = await import(lightningcssURL)
+ return new TextDecoder().decode(transform({
+ filename: 'inline.css',
+ code: new TextEncoder().encode(code),
+ minify: true,
+ }).code).trim()
+ }
+ : undefined,
+ },
+ ...viteOptions,
+ })
+ })
+ }
+
+ const unheadLegacy = resolveModulePath('@unhead/vue/legacy', { try: true, from: importPaths }) || '@unhead/vue/legacy'
+ const unheadPlugins = resolveModulePath('@unhead/vue/plugins', { try: true, from: importPaths }) || '@unhead/vue/plugins'
+
+ addTemplate({
+ filename: 'unhead-options.mjs',
+ getContents () {
+ const isV5 = nuxt.options.future.compatibilityVersion >= 5
+
+ // legacy is forced false on v5 by the schema resolver (which warns there), so only v4 reaches this
+ if (legacy) {
+ logger.warn('`unhead.legacy` is deprecated and will be removed. Remove deprecated head patterns (hid, vmid, children, body:true) and migrate promise values to resolved values before passing to useHead.')
+ }
+
+ if (headNext === false) {
+ logger.warn('`experimental.headNext` is deprecated. CAPO sorting is now the default; set `unhead.legacy: true` to opt out temporarily.')
+ }
+
+ const disableCapoSorting = !isV5 && (legacy || headNext === false)
+
+ const lines: string[] = []
+ // v4 parity with v2 defaults: restore the plugin set that unhead v3 no
+ // longer auto-loads (DeprecationsPlugin, PromisesPlugin, TemplateParamsPlugin,
+ // AliasSortingPlugin). v5 keeps TemplateParamsPlugin because %s / %siteName
+ // / %separator title interpolation is a core Nuxt SEO idiom; other plugins
+ // must be registered explicitly.
+ if (!isV5) {
+ lines.push(`import { legacyPlugins } from ${JSON.stringify(unheadLegacy)};`)
+ } else {
+ lines.push(`import { TemplateParamsPlugin } from ${JSON.stringify(unheadPlugins)};`)
+ }
+ lines.push(`export default {`)
+ lines.push(` disableDefaults: true,`)
+ if (disableCapoSorting) {
+ lines.push(` disableCapoSorting: true,`)
+ }
+ lines.push(` plugins: ${isV5 ? '[TemplateParamsPlugin]' : 'legacyPlugins'},`)
+ lines.push(`}`)
+ return lines.join('\n')
+ },
+ })
+
+ addTemplate({
+ filename: 'unhead.config.mjs',
+ getContents () {
+ return [
+ `export const renderSSRHeadOptions = ${JSON.stringify(options.renderSSRHeadOptions || {})}`,
+ ].join('\n')
+ },
+ })
+
+ // template is only exposed in nuxt context, expose in nitro context as well
+ nuxt.hooks.hook('nitro:config', (config) => {
+ config.virtual!['#internal/unhead-options.mjs'] = () => nuxt.vfs['#build/unhead-options.mjs'] || ''
+ config.virtual!['#internal/unhead.config.mjs'] = () => nuxt.vfs['#build/unhead.config.mjs'] || ''
+ })
+
+ // Remove deprecated server composables from auto-imports in v5
+ if (nuxt.options.future.compatibilityVersion >= 5) {
+ const deprecated = new Set(['useServerHead', 'useServerHeadSafe', 'useServerSeoMeta'])
+ nuxt.hooks.hook('imports:sources', (sources) => {
+ for (const source of sources) {
+ if ('from' in source && source.from === '#app/composables/head' && 'imports' in source && Array.isArray(source.imports)) {
+ source.imports = (source.imports as (string | { name: string })[]).filter(
+ i => !deprecated.has(typeof i === 'string' ? i : i.name),
+ )
+ }
+ }
+ })
+ }
+
+ // Add library-specific plugin
+ addPlugin({ src: resolve(runtimeDir, 'plugins/unhead') })
+ },
+})
diff --git a/packages/nuxt/src/head/plugins/unhead-imports.ts b/packages/nuxt/src/head/plugins/unhead-imports.ts
new file mode 100644
index 000000000000..f0fc00fb7b14
--- /dev/null
+++ b/packages/nuxt/src/head/plugins/unhead-imports.ts
@@ -0,0 +1,81 @@
+import { createUnplugin } from 'unplugin'
+import { generateTransform, rolldownString } from 'rolldown-string'
+import type { Identifier, ImportSpecifier } from 'estree'
+import { normalize, relative } from 'pathe'
+import { unheadVueComposablesImports } from '@unhead/vue'
+import { genImport } from 'knitwork'
+import { parseAndWalk } from 'oxc-walker'
+import { isJS, isVue } from '../../core/utils/index.ts'
+import { distDir } from '../../dirs.ts'
+import { logger } from '../../utils.ts'
+
+interface UnheadImportsPluginOptions {
+ rootDir: string
+}
+
+const UNHEAD_LIB_RE = /node_modules[/\\](?:@unhead[/\\][^/\\]+|unhead)[/\\]/
+const NUXT_HEAD_RE = /node_modules[/\\]nuxt[/\\]dist[/\\]head[/\\]runtime[/\\]/
+
+function toImports (specifiers: ImportSpecifier[]) {
+ return specifiers.map((specifier) => {
+ const imported = specifier.imported as Identifier | null
+ const isNamedImport = imported && imported.name !== specifier.local.name
+ return isNamedImport ? `${imported.name} as ${specifier.local.name}` : specifier.local.name
+ })
+}
+
+const UnheadVue = '@unhead/vue'
+const UnheadVueRE = /@unhead\/vue/
+
+/**
+ * To use composable in an async context we need to pass Nuxt context to the Unhead composables.
+ *
+ * We swap imports from @unhead/vue to #app/composables/head and warn users for type safety.
+ */
+export const UnheadImportsPlugin = (options: UnheadImportsPluginOptions) => createUnplugin(() => {
+ return {
+ name: 'nuxt:head:unhead-imports',
+ enforce: 'post',
+ transformInclude (id) {
+ id = normalize(id)
+ return (
+ (isJS(id) || isVue(id, { type: ['script'] })) &&
+ !id.startsWith('virtual:') &&
+ !id.startsWith(normalize(distDir)) &&
+ !UNHEAD_LIB_RE.test(id) &&
+ !NUXT_HEAD_RE.test(id)
+ )
+ },
+ transform: {
+ filter: {
+ code: { include: UnheadVueRE },
+ },
+ handler (code, id, meta?: unknown) {
+ const s = rolldownString(code, id, meta)
+ const importsToAdd: ImportSpecifier[] = []
+ parseAndWalk(code, id, function (node) {
+ if (node.type === 'ImportDeclaration' && [UnheadVue, '#app/composables/head'].includes(String(node.source.value))) {
+ importsToAdd.push(...node.specifiers as ImportSpecifier[])
+ const { start, end } = node
+ s.remove(start, end)
+ }
+ })
+
+ const importsFromUnhead = importsToAdd.filter(specifier => unheadVueComposablesImports[UnheadVue].includes((specifier.imported as Identifier)?.name))
+ const importsFromHead = importsToAdd.filter(specifier => !unheadVueComposablesImports[UnheadVue].includes((specifier.imported as Identifier)?.name))
+ if (importsFromUnhead.length) {
+ // warn if user has imported from @unhead/vue themselves
+ if (!normalize(id).includes('node_modules')) {
+ logger.warn(`You are importing from \`${UnheadVue}\` in \`./${relative(normalize(options.rootDir), normalize(id))}\`. Please import from \`#imports\` instead for full type safety.`)
+ }
+ s.prepend(`${genImport('#app/composables/head', toImports(importsFromUnhead))}\n`)
+ }
+ if (importsFromHead.length) {
+ s.prepend(`${genImport(UnheadVue, toImports(importsFromHead))}\n`)
+ }
+
+ return generateTransform(s, id)
+ },
+ },
+ }
+})
diff --git a/packages/nuxt/src/head/runtime/components.ts b/packages/nuxt/src/head/runtime/components.ts
new file mode 100644
index 000000000000..c69b9175939c
--- /dev/null
+++ b/packages/nuxt/src/head/runtime/components.ts
@@ -0,0 +1,499 @@
+import { defineComponent, getCurrentInstance, inject, onUnmounted, provide, reactive } from 'vue'
+import type { DefineSetupFnComponent, PropType, SlotsType, VNode, VNodeNormalizedChildren } from 'vue'
+import type {
+ BodyAttributes,
+ HtmlAttributes,
+ Noscript,
+ Base as UnheadBase,
+ Link as UnheadLink,
+ Meta as UnheadMeta,
+ Style as UnheadStyle,
+} from '@unhead/vue/types'
+import type {
+ CrossOrigin,
+ FetchPriority,
+ HTTPEquiv,
+ LinkRelationship,
+ ReferrerPolicy,
+ Target,
+} from './types'
+import { useHead } from '#app/composables/head'
+
+interface HeadComponents {
+ base?: UnheadBase | null
+ bodyAttrs?: BodyAttributes | null
+ htmlAttrs?: HtmlAttributes | null
+ link?: (UnheadLink | null)[]
+ meta?: (UnheadMeta | null)[]
+ noscript?: (Noscript | null)[]
+ style?: (UnheadStyle | null)[]
+ title?: string | null
+}
+type HeadComponentCtx = { input: HeadComponents, entry: ReturnType<typeof useHead>, update: () => void }
+const HeadComponentCtxSymbol = Symbol('head-component')
+
+const TagPositionProps = {
+ /**
+ * @deprecated Use tagPosition
+ */
+ body: { type: Boolean, default: undefined },
+ tagPosition: { type: String as PropType<UnheadStyle['tagPosition']> },
+}
+
+function normalizeProps<T extends Record<string, any>> (_props: T, key?: string): Partial<T> {
+ const props = Object.fromEntries(
+ Object.entries(_props).filter(([_, value]) => value !== undefined),
+ ) as Partial<T> & { tagPosition?: UnheadStyle['tagPosition'], tagPriority: UnheadStyle['tagPriority'] }
+ if (typeof props.body !== 'undefined') {
+ props.tagPosition = props.body ? 'bodyClose' : 'head'
+ }
+ if (typeof props.renderPriority !== 'undefined') {
+ props.tagPriority = props.renderPriority
+ }
+ return {
+ ...props,
+ key,
+ }
+}
+
+function useVNodeStringKey () {
+ const vnodeKey = getCurrentInstance()?.vnode.key
+ return vnodeKey != null && typeof vnodeKey !== 'symbol' ? String(vnodeKey) : undefined
+}
+
+function useHeadComponentCtx (): HeadComponentCtx {
+ return inject<HeadComponentCtx>(HeadComponentCtxSymbol, createHeadComponentCtx, true)
+}
+
+function createHeadComponentCtx (): HeadComponentCtx {
+ // avoid creating multiple contexts
+ const prev = inject<HeadComponentCtx | null>(HeadComponentCtxSymbol, null)
+ if (prev) {
+ return prev
+ }
+ const input = reactive({})
+ const entry = useHead(input)
+ const ctx: HeadComponentCtx = { input, entry, update: () => entry.patch(input) }
+ provide(HeadComponentCtxSymbol, ctx)
+ return ctx
+}
+
+const globalProps = {
+ accesskey: String,
+ autocapitalize: String,
+ autofocus: {
+ type: Boolean,
+ default: undefined,
+ },
+ class: { type: [String, Object, Array], default: undefined },
+ contenteditable: {
+ type: Boolean,
+ default: undefined,
+ },
+ contextmenu: String,
+ dir: String,
+ draggable: {
+ type: Boolean,
+ default: undefined,
+ },
+ enterkeyhint: String,
+ exportparts: String,
+ hidden: {
+ type: Boolean,
+ default: undefined,
+ },
+ id: String,
+ inputmode: String,
+ is: String,
+ itemid: String,
+ itemprop: String,
+ itemref: String,
+ itemscope: String,
+ itemtype: String,
+ lang: String,
+ nonce: String,
+ part: String,
+ slot: String,
+ spellcheck: {
+ type: Boolean,
+ default: undefined,
+ },
+ style: { type: [String, Object, Array], default: undefined },
+ tabindex: String,
+ title: String,
+ translate: String,
+ /**
+ * @deprecated Use tagPriority
+ */
+ renderPriority: [String, Number],
+ /**
+ * Unhead prop to modify the priority of the tag.
+ */
+ tagPriority: { type: [String, Number] as PropType<UnheadStyle['tagPriority']> },
+}
+
+interface GlobalProps {
+ accesskey?: string
+ autocapitalize?: string
+ autofocus?: boolean
+ class?: string | Record<string, any> | Array<any>
+ contenteditable?: boolean
+ contextmenu?: string
+ dir?: string
+ draggable?: boolean
+ enterkeyhint?: string
+ exportparts?: string
+ hidden?: boolean
+ id?: string
+ inputmode?: string
+ is?: string
+ itemid?: string
+ itemprop?: string
+ itemref?: string
+ itemscope?: string
+ itemtype?: string
+ lang?: string
+ nonce?: string
+ part?: string
+ slot?: string
+ spellcheck?: boolean
+ style?: string | Record<string, any> | Array<any>
+ tabindex?: string
+ title?: string
+ translate?: string
+ /**
+ * @deprecated Use tagPriority
+ */
+ renderPriority?: string | number
+ /**
+ * Unhead prop to modify the priority of the tag.
+ */
+ tagPriority?: UnheadStyle['tagPriority']
+}
+
+interface TagPositionPropsType {
+ /**
+ * @deprecated Use tagPosition
+ */
+ body?: boolean
+ tagPosition?: UnheadStyle['tagPosition']
+}
+
+type SlotWithDefault = SlotsType<{ default?: () => VNode[] }>
+
+// <noscript>
+export const NoScript: DefineSetupFnComponent<GlobalProps & TagPositionPropsType & { title?: string }, {}, SlotWithDefault> = defineComponent({
+ name: 'NoScript',
+ inheritAttrs: false,
+ props: {
+ ...globalProps,
+ ...TagPositionProps,
+ title: String,
+ },
+ setup (props, { slots }) {
+ const { input, update } = useHeadComponentCtx()
+ input.noscript ||= []
+ const idx: keyof typeof input.noscript = input.noscript.push({}) - 1
+ onUnmounted(() => {
+ input.noscript![idx] = null
+ update()
+ })
+ const key = useVNodeStringKey()
+ return () => {
+ const noscript = normalizeProps(props, key) as Noscript
+ const slotVnodes = slots.default?.()
+ const textContent: VNodeNormalizedChildren[] = []
+ if (slotVnodes) {
+ for (const vnode of slotVnodes) {
+ if (vnode.children) {
+ textContent.push(vnode.children)
+ }
+ }
+ }
+ if (textContent.length > 0) {
+ noscript.innerHTML = textContent.join('')
+ }
+ input.noscript![idx] = noscript
+ update()
+ return null
+ }
+ },
+}) as unknown as DefineSetupFnComponent<GlobalProps & TagPositionPropsType & { title?: string }, {}, SlotWithDefault>
+
+interface LinkComponentProps extends GlobalProps, TagPositionPropsType {
+ as?: string
+ crossorigin?: CrossOrigin
+ disabled?: boolean
+ fetchpriority?: FetchPriority
+ href?: string
+ hreflang?: string
+ imagesizes?: string
+ imagesrcset?: string
+ integrity?: string
+ media?: string
+ prefetch?: boolean
+ referrerpolicy?: ReferrerPolicy
+ rel?: LinkRelationship
+ sizes?: string
+ title?: string
+ type?: string
+ /** @deprecated **/
+ methods?: string
+ /** @deprecated **/
+ target?: Target
+}
+
+// <link>
+export const Link: DefineSetupFnComponent<LinkComponentProps> = defineComponent({
+ name: 'Link',
+ inheritAttrs: false,
+ props: {
+ ...globalProps,
+ ...TagPositionProps,
+ as: String,
+ crossorigin: String as PropType<CrossOrigin>,
+ disabled: Boolean,
+ fetchpriority: String as PropType<FetchPriority>,
+ href: String,
+ hreflang: String,
+ imagesizes: String,
+ imagesrcset: String,
+ integrity: String,
+ media: String,
+ prefetch: {
+ type: Boolean,
+ default: undefined,
+ },
+ referrerpolicy: String as PropType<ReferrerPolicy>,
+ rel: String as PropType<LinkRelationship>,
+ sizes: String,
+ title: String,
+ type: String,
+ /** @deprecated **/
+ methods: String,
+ /** @deprecated **/
+ target: String as PropType<Target>,
+ },
+ setup (props) {
+ const { input, update } = useHeadComponentCtx()
+ input.link ||= []
+ const idx: keyof typeof input.link = input.link.push(null) - 1
+ const key = useVNodeStringKey()
+
+ onUnmounted(() => {
+ input.link![idx] = null
+ update()
+ })
+
+ return () => {
+ input.link![idx] = normalizeProps(props, key) as UnheadLink
+ update()
+ return null
+ }
+ },
+}) as unknown as DefineSetupFnComponent<LinkComponentProps>
+
+interface BaseComponentProps extends GlobalProps {
+ href?: string
+ target?: Target
+}
+
+// <base>
+export const Base: DefineSetupFnComponent<BaseComponentProps> = defineComponent({
+ name: 'Base',
+ inheritAttrs: false,
+ props: {
+ ...globalProps,
+ href: String,
+ target: String as PropType<Target>,
+ },
+ setup (props) {
+ const { input, update } = useHeadComponentCtx()
+ const key = useVNodeStringKey()
+ onUnmounted(() => {
+ input.base = null
+ update()
+ })
+ return () => {
+ input.base = normalizeProps(props, key) as UnheadBase
+ update()
+ return null
+ }
+ },
+}) as unknown as DefineSetupFnComponent<BaseComponentProps>
+
+// <title>
+export const Title: DefineSetupFnComponent<{}, {}, SlotWithDefault> = defineComponent({
+ name: 'Title',
+ inheritAttrs: false,
+ setup (_, { slots }) {
+ const { input, update } = useHeadComponentCtx()
+ onUnmounted(() => {
+ input.title = null
+ update()
+ })
+ return () => {
+ const defaultSlot = slots.default?.()
+ input.title = defaultSlot?.[0]?.children ? String(defaultSlot?.[0]?.children) : undefined
+ if (import.meta.dev) {
+ if (defaultSlot && (defaultSlot.length > 1 || (defaultSlot[0] && typeof defaultSlot[0].children !== 'string'))) {
+ console.error('<Title> can take only one string in its default slot.')
+ }
+ }
+ update()
+ return null
+ }
+ },
+}) as unknown as DefineSetupFnComponent<{}, {}, SlotWithDefault>
+
+interface MetaComponentProps extends GlobalProps {
+ charset?: string
+ content?: string
+ httpEquiv?: HTTPEquiv
+ name?: string
+ property?: string
+}
+
+// <meta>
+export const Meta: DefineSetupFnComponent<MetaComponentProps> = defineComponent({
+ name: 'Meta',
+ inheritAttrs: false,
+ props: {
+ ...globalProps,
+ charset: String,
+ content: String,
+ httpEquiv: String as PropType<HTTPEquiv>,
+ name: String,
+ property: String,
+ },
+ setup (props) {
+ const { input, update } = useHeadComponentCtx()
+ const key = useVNodeStringKey()
+ input.meta ||= []
+ const idx: keyof typeof input.meta = input.meta.push(null) - 1
+ onUnmounted(() => {
+ input.meta![idx] = null
+ update()
+ })
+ return () => {
+ const meta = { 'http-equiv': props.httpEquiv, ...normalizeProps(props, key) } as UnheadMeta
+ // fix casing for http-equiv
+ if ('httpEquiv' in meta) {
+ delete meta.httpEquiv
+ }
+ input.meta![idx] = meta
+ update()
+ return null
+ }
+ },
+}) as unknown as DefineSetupFnComponent<MetaComponentProps>
+
+interface StyleComponentProps extends GlobalProps, TagPositionPropsType {
+ type?: string
+ media?: string
+ nonce?: string
+ title?: string
+ /** @deprecated **/
+ scoped?: boolean
+}
+
+// <style>
+export const Style: DefineSetupFnComponent<StyleComponentProps, {}, SlotWithDefault> = defineComponent({
+ name: 'Style',
+ inheritAttrs: false,
+ props: {
+ ...globalProps,
+ ...TagPositionProps,
+ type: String,
+ media: String,
+ nonce: String,
+ title: String,
+ /** @deprecated **/
+ scoped: {
+ type: Boolean,
+ default: undefined,
+ },
+ },
+ setup (props, { slots }) {
+ const { input, update } = useHeadComponentCtx()
+ const key = useVNodeStringKey()
+ input.style ||= []
+ const idx: keyof typeof input.style = input.style.push({}) - 1
+ onUnmounted(() => {
+ input.style![idx] = null
+ update()
+ })
+ return () => {
+ const style = normalizeProps(props, key) as UnheadStyle
+ const textContent = slots.default?.()?.[0]?.children
+ if (textContent) {
+ if (import.meta.dev && typeof textContent !== 'string') {
+ console.error('<Style> can only take a string in its default slot.')
+ }
+ input.style![idx] = style
+ style.textContent = textContent as string
+ }
+ update()
+ return null
+ }
+ },
+}) as unknown as DefineSetupFnComponent<StyleComponentProps, {}, SlotWithDefault>
+
+// <head>
+export const Head: DefineSetupFnComponent<{}, {}, SlotWithDefault> = defineComponent({
+ name: 'Head',
+ inheritAttrs: false,
+ setup: (_props, ctx) => {
+ createHeadComponentCtx()
+ return () => ctx.slots.default?.()
+ },
+}) as unknown as DefineSetupFnComponent<{}, {}, SlotWithDefault>
+
+interface HtmlComponentProps extends GlobalProps {
+ manifest?: string
+ version?: string
+ xmlns?: string
+}
+
+// <html>
+export const Html: DefineSetupFnComponent<HtmlComponentProps, {}, SlotWithDefault> = defineComponent({
+ name: 'Html',
+ inheritAttrs: false,
+ props: {
+ ...globalProps,
+ manifest: String,
+ version: String,
+ xmlns: String,
+ },
+ setup (_props, ctx) {
+ const { input, update } = useHeadComponentCtx()
+ onUnmounted(() => {
+ input.htmlAttrs = null
+ update()
+ })
+ return () => {
+ input.htmlAttrs = { ..._props, ...ctx.attrs } as HtmlAttributes
+ update()
+ return ctx.slots.default?.()
+ }
+ },
+}) as unknown as DefineSetupFnComponent<HtmlComponentProps, {}, SlotWithDefault>
+
+// <body>
+export const Body: DefineSetupFnComponent<GlobalProps, {}, SlotWithDefault> = defineComponent({
+ name: 'Body',
+ inheritAttrs: false,
+ props: globalProps,
+ setup (_props, ctx) {
+ const { input, update } = useHeadComponentCtx()
+ onUnmounted(() => {
+ input.bodyAttrs = null
+ update()
+ })
+ return () => {
+ input.bodyAttrs = { ..._props, ...ctx.attrs } as BodyAttributes
+ update()
+ return ctx.slots.default?.()
+ }
+ },
+}) as unknown as DefineSetupFnComponent<GlobalProps, {}, SlotWithDefault>
diff --git a/packages/nuxt/src/head/runtime/composables.ts b/packages/nuxt/src/head/runtime/composables.ts
new file mode 100644
index 000000000000..4914988b625c
--- /dev/null
+++ b/packages/nuxt/src/head/runtime/composables.ts
@@ -0,0 +1,75 @@
+import type { ActiveHeadEntry, UseHeadInput, UseHeadOptions, UseHeadSafeInput, UseSeoMetaInput, VueHeadClient } from '@unhead/vue/types'
+import { hasInjectionContext, inject } from 'vue'
+import {
+ useHead as headCore,
+ useHeadSafe as headSafe,
+ headSymbol,
+ useSeoMeta as seoMeta, useServerHead as serverHead, useServerHeadSafe as serverHeadSafe,
+ useServerSeoMeta as serverSeoMeta,
+} from '@unhead/vue'
+import { useNuxtApp } from '#app/nuxt'
+import type { NuxtApp } from '#app/nuxt'
+
+/**
+ * Injects the head client from the Nuxt context or Vue inject.
+ */
+export function injectHead (nuxtApp?: NuxtApp): VueHeadClient {
+ // Nuxt 4 will throw an error if the context is missing
+ const nuxt = nuxtApp || useNuxtApp()
+ return nuxt.ssrContext?.head || nuxt.runWithContext(() => {
+ if (hasInjectionContext()) {
+ const head = inject<VueHeadClient>(headSymbol)
+ // should not be possible
+ if (!head) {
+ throw new Error('[nuxt] [unhead] Missing Unhead instance.')
+ }
+ return head
+ }
+ }) as VueHeadClient
+}
+
+interface NuxtUseHeadOptions extends UseHeadOptions {
+ nuxt?: NuxtApp
+}
+
+export function useHead (input: UseHeadInput, options: NuxtUseHeadOptions = {}): ActiveHeadEntry<UseHeadInput> {
+ const head = options.head || injectHead(options.nuxt)
+ return headCore(input, { head, ...options }) as ActiveHeadEntry<UseHeadInput>
+}
+
+export function useHeadSafe (input: UseHeadSafeInput, options: NuxtUseHeadOptions = {}): ActiveHeadEntry<UseHeadSafeInput> {
+ const head = options.head || injectHead(options.nuxt)
+ return headSafe(input, { head, ...options }) as ActiveHeadEntry<UseHeadSafeInput>
+}
+
+export function useSeoMeta (input: UseSeoMetaInput, options: NuxtUseHeadOptions = {}): ActiveHeadEntry<UseSeoMetaInput> {
+ const head = options.head || injectHead(options.nuxt)
+ return seoMeta(input, { head, ...options }) as ActiveHeadEntry<UseSeoMetaInput>
+}
+
+/**
+ * @deprecated Use `useHead` instead and wrap with `if (import.meta.server)`
+ */
+export function useServerHead (input: UseHeadInput, options: NuxtUseHeadOptions = {}): ActiveHeadEntry<UseHeadInput> {
+ const head = options.head || injectHead(options.nuxt)
+ // eslint-disable-next-line @typescript-eslint/no-deprecated
+ return serverHead(input, { head, ...options }) as ActiveHeadEntry<UseHeadInput>
+}
+
+/**
+ * @deprecated Use `useHeadSafe` instead and wrap with `if (import.meta.server)`
+ */
+export function useServerHeadSafe (input: UseHeadSafeInput, options: NuxtUseHeadOptions = {}): ActiveHeadEntry<UseHeadSafeInput> {
+ const head = options.head || injectHead(options.nuxt)
+ // eslint-disable-next-line @typescript-eslint/no-deprecated
+ return serverHeadSafe(input, { head, ...options }) as ActiveHeadEntry<UseHeadSafeInput>
+}
+
+/**
+ * @deprecated Use `useSeoMeta` instead and wrap with `if (import.meta.server)`
+ */
+export function useServerSeoMeta (input: UseSeoMetaInput, options: NuxtUseHeadOptions = {}): ActiveHeadEntry<UseSeoMetaInput> {
+ const head = options.head || injectHead(options.nuxt)
+ // eslint-disable-next-line @typescript-eslint/no-deprecated
+ return serverSeoMeta(input, { head, ...options }) as ActiveHeadEntry<UseSeoMetaInput>
+}
diff --git a/packages/nuxt/src/head/runtime/island-head.ts b/packages/nuxt/src/head/runtime/island-head.ts
new file mode 100644
index 000000000000..a2107679448a
--- /dev/null
+++ b/packages/nuxt/src/head/runtime/island-head.ts
@@ -0,0 +1,13 @@
+import type { VueHeadClient } from '@unhead/vue/types'
+
+/**
+ * No-op `head.push` until the returned `unfreeze` runs. Plugin/transformer
+ * augmentations on the same head are unaffected.
+ */
+export function freezeHead (head: VueHeadClient): () => void {
+ const realPush = head.push
+ head.push = () => ({ dispose: () => {}, patch: () => {}, _i: 0 }) as ReturnType<typeof head.push>
+ return () => {
+ head.push = realPush
+ }
+}
diff --git a/packages/nuxt/src/head/runtime/plugins/unhead.ts b/packages/nuxt/src/head/runtime/plugins/unhead.ts
new file mode 100644
index 000000000000..da4530837cec
--- /dev/null
+++ b/packages/nuxt/src/head/runtime/plugins/unhead.ts
@@ -0,0 +1,67 @@
+import { createHead as createClientHead } from '@unhead/vue/client'
+import type { ActiveHeadEntry } from '@unhead/vue'
+import { defineNuxtPlugin } from '#app/nuxt'
+import type { ObjectPlugin, Plugin } from '#app/nuxt'
+import { freezeHead } from '../island-head'
+
+// @ts-expect-error virtual file
+import unheadOptions from '#build/unhead-options.mjs'
+
+const plugin: Plugin & ObjectPlugin = defineNuxtPlugin({
+ name: 'nuxt:head',
+ enforce: 'pre',
+ setup (nuxtApp) {
+ const head = import.meta.server
+ ? nuxtApp.ssrContext!.head
+ : createClientHead(unheadOptions)
+
+ // Drop plugin-phase `useHead` writes for islands -- they belong to the
+ // surrounding route, not the island response. Unfreeze on `app:created`
+ // (after `applyPlugins` resolves) so island components write normally.
+ if (import.meta.server && nuxtApp.ssrContext!.islandContext) {
+ const unfreeze = freezeHead(head)
+ nuxtApp.hooks.hookOnce('app:created', unfreeze)
+ }
+
+ // nuxt.config appHead is set server-side within the renderer
+ nuxtApp.vueApp.use(head)
+
+ if (import.meta.client) {
+ // pause dom updates until page is ready and between page transitions
+ let pauseDOMUpdates = true
+ const syncHead = () => {
+ pauseDOMUpdates = false
+ head.render()
+ }
+ head.hooks?.hook('dom:beforeRender', (context) => { context.shouldRender = !pauseDOMUpdates })
+ nuxtApp.hooks.hook('page:start', () => { pauseDOMUpdates = true })
+ // wait for new page before unpausing dom updates (triggered after suspense resolved)
+ nuxtApp.hooks.hook('page:finish', () => {
+ // app:suspense:resolve hook will unpause the DOM
+ if (!nuxtApp.isHydrating) { syncHead() }
+ })
+ // unpause on error
+ nuxtApp.hooks.hook('app:error', syncHead)
+ // unpause the DOM once the mount suspense is resolved
+ nuxtApp.hooks.hook('app:suspense:resolve', syncHead)
+
+ // Defer head-entry disposal during a page transition.
+ const originalPush = head.push.bind(head)
+ head.push = ((input: Parameters<typeof head.push>[0], options?: Parameters<typeof head.push>[1]) => {
+ const entry = originalPush(input, options) as ActiveHeadEntry<typeof input>
+ const originalDispose = entry.dispose.bind(entry)
+ entry.dispose = () => {
+ const transitionPromise = nuxtApp['~transitionPromise']
+ if (transitionPromise) {
+ transitionPromise.then(originalDispose)
+ } else {
+ originalDispose()
+ }
+ }
+ return entry
+ }) as typeof head.push
+ }
+ },
+})
+
+export default plugin
diff --git a/packages/nuxt/src/head/runtime/types.ts b/packages/nuxt/src/head/runtime/types.ts
new file mode 100644
index 000000000000..c7569922a8a0
--- /dev/null
+++ b/packages/nuxt/src/head/runtime/types.ts
@@ -0,0 +1,47 @@
+export type Props = Readonly<Record<string, any>>
+
+export type FetchPriority = 'high' | 'low' | 'auto'
+
+export type CrossOrigin = '' | 'anonymous' | 'use-credentials'
+
+export type HTTPEquiv =
+ | 'content-security-policy'
+ | 'content-type'
+ | 'default-style'
+ | 'refresh'
+ | 'x-ua-compatible'
+
+export type ReferrerPolicy =
+ | ''
+ | 'no-referrer'
+ | 'no-referrer-when-downgrade'
+ | 'same-origin'
+ | 'origin'
+ | 'strict-origin'
+ | 'origin-when-cross-origin'
+ | 'strict-origin-when-cross-origin'
+ | 'unsafe-url'
+
+export type LinkRelationship =
+ | 'alternate'
+ | 'author'
+ | 'canonical'
+ | 'dns-prefetch'
+ | 'help'
+ | 'icon'
+ | 'license'
+ | 'manifest'
+ | 'me'
+ | 'modulepreload'
+ | 'next'
+ | 'pingback'
+ | 'preconnect'
+ | 'prefetch'
+ | 'preload'
+ | 'prerender'
+ | 'prev'
+ | 'search'
+ | 'stylesheet'
+ | (string & {})
+
+export type Target = '_blank' | '_self' | '_parent' | '_top' | (string & {})
diff --git a/packages/nuxt/src/imports/module.ts b/packages/nuxt/src/imports/module.ts
new file mode 100644
index 000000000000..55cc878f6bee
--- /dev/null
+++ b/packages/nuxt/src/imports/module.ts
@@ -0,0 +1,322 @@
+import { existsSync } from 'node:fs'
+import { addBuildPlugin, addTemplate, addTypeTemplate, createIsIgnored, defineNuxtModule, directoryToURL, getLayerDirectories, resolveAlias, tryResolveModule, updateTemplates, useNitro, useNuxt } from '@nuxt/kit'
+import { isAbsolute, join, normalize, relative, resolve } from 'pathe'
+import type { Import, InlinePreset, Unimport } from 'unimport'
+import { createUnimport, scanDirExports, toExports, toTypeDeclarationFile, toTypeReExports } from 'unimport'
+import escapeRE from 'escape-string-regexp'
+
+import { lookupNodeModuleSubpath, parseNodeModulePath } from 'mlly'
+import { isDirectory, logger, resolveToAlias } from '../utils.ts'
+import { TransformPlugin } from './transform.ts'
+import { appCompatPresets, defaultPresets } from './presets.ts'
+import type { ImportsOptions, ResolvedNuxtTemplate } from 'nuxt/schema'
+
+import { pagesImportPresets, routeRulesPresets } from '../pages/module.ts'
+
+const allNuxtPresets = [
+ ...pagesImportPresets,
+ ...routeRulesPresets,
+ ...defaultPresets,
+]
+
+export default defineNuxtModule<Partial<ImportsOptions>>({
+ meta: {
+ name: 'nuxt:imports',
+ configKey: 'imports',
+ },
+ defaults: nuxt => ({
+ autoImport: true,
+ scan: true,
+ presets: defaultPresets,
+ global: false,
+ imports: [],
+ dirs: [],
+ transform: {
+ include: [
+ new RegExp('^' + escapeRE(nuxt.options.buildDir)),
+ ],
+ exclude: undefined,
+ },
+ virtualImports: ['#imports'],
+ polyfills: true,
+ }),
+ setup (options, nuxt) {
+ // TODO: fix sharing of defaults between invocations of modules
+ const presets: InlinePreset[] = JSON.parse(JSON.stringify(options.presets))
+
+ if (options.polyfills) {
+ presets.push(...appCompatPresets)
+ }
+
+ // composables/ dirs from all layers
+ let composablesDirs: string[] = []
+ if (options.scan) {
+ for (const layer of nuxt.options._layers) {
+ // Layer disabled scanning for itself
+ if (layer.config?.imports?.scan === false) {
+ continue
+ }
+
+ composablesDirs.push(
+ resolve(layer.config.srcDir, 'composables'),
+ resolve(layer.config.srcDir, 'utils'),
+ resolve(layer.config.rootDir, layer.config.dir?.shared ?? 'shared', 'utils'),
+ resolve(layer.config.rootDir, layer.config.dir?.shared ?? 'shared', 'types'),
+ )
+
+ for (const dir of (layer.config.imports?.dirs ?? [])) {
+ if (dir) {
+ composablesDirs.push(resolve(layer.config.srcDir, resolveAlias(dir, nuxt.options.alias)))
+ }
+ }
+ }
+
+ nuxt.hook('modules:done', async () => {
+ await nuxt.callHook('imports:dirs', composablesDirs)
+ composablesDirs = composablesDirs.map(dir => normalize(dir))
+ })
+
+ // Restart nuxt when composable directories are added/removed
+ nuxt.hook('builder:watch', (event, relativePath) => {
+ if (!['addDir', 'unlinkDir'].includes(event)) { return }
+
+ const path = resolve(nuxt.options.srcDir, relativePath)
+ if (composablesDirs.includes(path)) {
+ logger.info(`Directory \`${relativePath}/\` ${event === 'addDir' ? 'created' : 'removed'}`)
+ return nuxt.callHook('restart')
+ }
+ })
+ }
+
+ let ctx: Unimport
+
+ // initialise unimport only after all modules
+ // have had a chance to register their hooks
+ nuxt.hook('modules:done', async () => {
+ await nuxt.callHook('imports:sources', presets)
+
+ const { addons: inlineAddons, ...rest } = options
+ const [addons, addonsOptions] = Array.isArray(inlineAddons) ? [inlineAddons] : [[], inlineAddons]
+
+ // Create a context to share state between module internals
+ ctx = createUnimport({
+ injectAtEnd: true,
+ ...rest,
+ addons: {
+ addons,
+ vueTemplate: options.autoImport,
+ vueDirectives: options.autoImport === false ? undefined : true,
+ ...addonsOptions,
+ },
+ presets,
+ })
+
+ await nuxt.callHook('imports:context', ctx)
+ })
+
+ // Support for importing from '#imports'
+ addTemplate({
+ filename: 'imports.mjs',
+ getContents: async () => toExports(await ctx.getImports()) + '\nif (import.meta.dev) { console.warn("[nuxt] `#imports` should be transformed with real imports. There seems to be something wrong with the imports plugin.") }',
+ })
+ nuxt.options.alias['#imports'] = join(nuxt.options.buildDir, 'imports')
+
+ // Transform to inject imports in production mode
+ addBuildPlugin(TransformPlugin({
+ ctx: {
+ injectImports: (code, id, options) => ctx.injectImports(code, id, options),
+ },
+ options,
+ sourcemap: !!nuxt.options.sourcemap.server || !!nuxt.options.sourcemap.client,
+ }))
+
+ const priorities = getLayerDirectories(nuxt).map((dirs, i) => [dirs.app, -i] as const).sort(([a], [b]) => b.length - a.length)
+
+ const IMPORTS_TEMPLATE_RE = /\/imports\.(?:d\.ts|mjs)$/
+ function isImportsTemplate (template: ResolvedNuxtTemplate) {
+ return IMPORTS_TEMPLATE_RE.test(template.filename)
+ }
+
+ const isIgnored = createIsIgnored(nuxt)
+ const nuxtImportSources = new Set(allNuxtPresets.flatMap(i => i.from))
+ const nuxtImports = new Set(presets.flatMap(p => nuxtImportSources.has(p.from) ? p.imports : []))
+ const regenerateImports = async () => {
+ await ctx.modifyDynamicImports(async (imports) => {
+ // Clear old imports
+ imports.length = 0
+
+ // Scan for `composables/` and `utils/` directories
+ if (options.scan) {
+ const scannedImports = await scanDirExports(composablesDirs, {
+ fileFilter: file => !isIgnored(file),
+ })
+ for (const i of scannedImports) {
+ i.priority ||= priorities.find(([dir]) => i.from.startsWith(dir))?.[1]
+ }
+ imports.push(...scannedImports)
+ }
+
+ // Modules extending
+ await nuxt.callHook('imports:extend', imports)
+ for (const i of imports) {
+ if (!nuxtImportSources.has(i.from)) {
+ const value = i.as || i.name
+ if (nuxtImports.has(value) && (!i.priority || i.priority >= 0 /* default priority */)) {
+ const relativePath = isAbsolute(i.from) ? `${resolveToAlias(i.from, nuxt)}` : i.from
+ logger.error(`\`${value}\` is an auto-imported function that is in use by Nuxt. Overriding it will likely cause issues. Please consider renaming \`${value}\` in \`${relativePath}\`.`)
+ }
+ }
+ }
+
+ return imports
+ })
+
+ await updateTemplates({
+ filter: isImportsTemplate,
+ })
+ }
+
+ nuxt.hook('modules:done', () => regenerateImports())
+
+ // Generate types
+ addDeclarationTemplates({
+ generateTypeDeclarations: options => ctx.generateTypeDeclarations(options),
+ getImports: () => ctx.getImports(),
+ }, options)
+
+ // Watch composables/ directory
+ nuxt.hook('builder:watch', async (_, relativePath) => {
+ const path = resolve(nuxt.options.srcDir, relativePath)
+ if (options.scan && composablesDirs.some(dir => dir === path || path.startsWith(dir + '/'))) {
+ await regenerateImports()
+ }
+ })
+
+ // Watch for template generation
+ nuxt.hook('app:templatesGenerated', async (_app, templates) => {
+ // Only regenerate when non-imports templates are updated
+ if (templates.some(t => !isImportsTemplate(t))) {
+ await regenerateImports()
+ }
+ })
+ },
+})
+
+function addDeclarationTemplates (ctx: Pick<Unimport, 'getImports' | 'generateTypeDeclarations'>, options: Partial<ImportsOptions>) {
+ const nuxt = useNuxt()
+
+ const resolvedImportPathMap = new Map<string, string>()
+ const r = (i: Import) => resolvedImportPathMap.get(i.typeFrom || i.from)
+
+ const SUPPORTED_EXTENSION_RE = new RegExp(`\\.(?:${nuxt.options.extensions.map(i => i.replace('.', '')).join('|')})$`)
+
+ const importPaths = nuxt.options.modulesDir.map(dir => directoryToURL(dir))
+
+ async function cacheImportPaths (imports: Import[]) {
+ const importSource = Array.from(new Set(imports.map(i => i.typeFrom || i.from)))
+ // skip relative import paths for node_modules that are explicitly installed
+ await Promise.all(importSource.map(async (from) => {
+ if (resolvedImportPathMap.has(from) || nuxt._dependencies?.has(from)) {
+ return
+ }
+ let path = resolveAlias(from)
+ if (!isAbsolute(path)) {
+ path = await tryResolveModule(from, importPaths).then(async (r) => {
+ if (!r) { return r }
+
+ const { dir, name } = parseNodeModulePath(r)
+ if (name && nuxt._dependencies?.has(name)) { return from }
+
+ if (!dir || !name) { return r }
+ const subpath = await lookupNodeModuleSubpath(r)
+ return join(dir, name, subpath || '')
+ }) ?? path
+ }
+
+ if (existsSync(path) && !(await isDirectory(path))) {
+ path = path.replace(SUPPORTED_EXTENSION_RE, '')
+ }
+
+ if (isAbsolute(path)) {
+ path = relative(join(nuxt.options.buildDir, 'types'), path)
+ }
+
+ resolvedImportPathMap.set(from, path)
+ }))
+ }
+
+ addTypeTemplate({
+ filename: 'imports.d.ts',
+ getContents: async ({ nuxt }) => toExports(await ctx.getImports(), nuxt.options.buildDir, true, { declaration: true }),
+ })
+
+ const GENERATED_BY_COMMENT = '// Generated by auto imports\n'
+ const AUTO_IMPORTS_DISABLED_COMMENT = '// Implicit auto importing is disabled, you can explicitly import from `#imports` instead.\n'
+
+ addTypeTemplate({
+ filename: 'types/imports.d.ts',
+ getContents: async () => {
+ const imports = await ctx.getImports()
+ await cacheImportPaths(imports)
+ return GENERATED_BY_COMMENT + (
+ options.autoImport
+ ? await ctx.generateTypeDeclarations({ resolvePath: r })
+ : AUTO_IMPORTS_DISABLED_COMMENT
+ )
+ },
+ })
+
+ addTemplate({
+ filename: 'types/shared-imports.d.ts',
+ getContents: async () => {
+ if (!options.autoImport) {
+ return GENERATED_BY_COMMENT + AUTO_IMPORTS_DISABLED_COMMENT
+ }
+ const nitro = useNitro()
+
+ const nuxtImports = await ctx.getImports()
+
+ const nitroImports = await nitro.unimport?.getImports() ?? []
+ const nitroImportsByName = new Map<string, Import>(nitroImports.map(i => [i.as || i.name, i]))
+
+ const sharedImports: Import[] = []
+
+ for (const i of nuxtImports) {
+ const importName = i.as || i.name
+ const nitroImport = nitroImportsByName.get(importName)
+ if (!nitroImport || i.dtsDisabled || nitroImport.dtsDisabled) { continue }
+
+ // Only include if both contexts import from the same source
+ // to avoid polluting shared space with nitro- or nuxt-only types (as a side-effect)
+ if (i.from !== nitroImport.from) { continue }
+
+ sharedImports.push(i)
+ }
+
+ await cacheImportPaths(sharedImports)
+
+ // Utilities that exist in both Nuxt and Nitro contexts but with different implementations.
+ // These are safe to use in the shared context.
+ const handCraftedDeclarations = `
+ const useRuntimeConfig: (event?: import('h3').H3Event) => import('nuxt/schema').RuntimeConfig
+ const useAppConfig: () => import('nuxt/schema').AppConfig
+ const defineAppConfig: <C extends import('nuxt/schema').AppConfigInput>(config: C) => C
+ const createError: typeof import('h3')['createError']
+ const setResponseStatus: typeof import('h3')['setResponseStatus']`
+
+ const valueImports = sharedImports.filter(i => !i.type)
+ const typeImports = sharedImports.filter(i => i.type)
+
+ let dts = toTypeDeclarationFile(valueImports, { resolvePath: r }).replace(
+ /^declare global \{$/m,
+ `declare global {${handCraftedDeclarations}`,
+ )
+
+ if (typeImports.length) {
+ dts += '\n' + toTypeReExports(typeImports, { resolvePath: r })
+ }
+
+ return GENERATED_BY_COMMENT + dts
+ },
+ })
+}
diff --git a/packages/nuxt/src/imports/presets.ts b/packages/nuxt/src/imports/presets.ts
new file mode 100644
index 000000000000..4110dc510279
--- /dev/null
+++ b/packages/nuxt/src/imports/presets.ts
@@ -0,0 +1,301 @@
+import type { InlinePreset } from 'unimport'
+import { defineUnimportPreset } from 'unimport'
+
+const commonPresets: InlinePreset[] = [
+ // vue-demi (mocked)
+ defineUnimportPreset({
+ from: 'vue-demi',
+ imports: [
+ 'isVue2',
+ 'isVue3',
+ ],
+ }),
+]
+
+const granularAppPresets: InlinePreset[] = [
+ {
+ from: '#app/components/nuxt-link',
+ imports: ['defineNuxtLink'],
+ },
+ {
+ imports: ['useNuxtApp', 'tryUseNuxtApp', 'defineNuxtPlugin', 'definePayloadPlugin', 'useRuntimeConfig', 'defineAppConfig'],
+ from: '#app/nuxt',
+ },
+ {
+ imports: ['useAppConfig', 'updateAppConfig'],
+ from: '#app/config',
+ },
+ {
+ imports: ['defineNuxtComponent'],
+ from: '#app/composables/component',
+ },
+ {
+ imports: ['useAsyncData', 'useLazyAsyncData', 'useNuxtData', 'refreshNuxtData', 'clearNuxtData', 'createUseAsyncData'],
+ from: '#app/composables/asyncData',
+ },
+ {
+ imports: ['useHydration'],
+ from: '#app/composables/hydrate',
+ },
+ {
+ imports: ['callOnce'],
+ from: '#app/composables/once',
+ },
+ {
+ imports: ['useState', 'clearNuxtState'],
+ from: '#app/composables/state',
+ },
+ {
+ imports: ['clearError', 'createError', 'isNuxtError', 'showError', 'useError'],
+ from: '#app/composables/error',
+ },
+ {
+ imports: ['useFetch', 'useLazyFetch', 'createUseFetch'],
+ from: '#app/composables/fetch',
+ },
+ {
+ imports: ['useCookie', 'refreshCookie'],
+ from: '#app/composables/cookie',
+ },
+ {
+ imports: ['onPrehydrate', 'prerenderRoutes', 'useRequestHeader', 'useRequestHeaders', 'useResponseHeader', 'useRequestEvent', 'useRequestFetch', 'setResponseStatus'],
+ from: '#app/composables/ssr',
+ },
+ {
+ imports: ['onNuxtReady'],
+ from: '#app/composables/ready',
+ },
+ {
+ imports: ['preloadComponents', 'prefetchComponents', 'preloadRouteComponents'],
+ from: '#app/composables/preload',
+ },
+ {
+ imports: ['abortNavigation', 'addRouteMiddleware', 'defineNuxtRouteMiddleware', 'setPageLayout', 'navigateTo', 'useRoute', 'useRouter'],
+ from: '#app/composables/router',
+ },
+ {
+ imports: ['isPrerendered', 'loadPayload', 'preloadPayload', 'definePayloadReducer', 'definePayloadReviver'],
+ from: '#app/composables/payload',
+ },
+ {
+ imports: ['useLoadingIndicator'],
+ from: '#app/composables/loading-indicator',
+ },
+ {
+ imports: ['getAppManifest', 'getRouteRules'],
+ from: '#app/composables/manifest',
+ },
+ {
+ imports: ['reloadNuxtApp'],
+ from: '#app/composables/chunk',
+ },
+ {
+ imports: ['useRequestURL'],
+ from: '#app/composables/url',
+ },
+ {
+ imports: ['usePreviewMode'],
+ from: '#app/composables/preview',
+ },
+ {
+ imports: ['useRouteAnnouncer'],
+ from: '#app/composables/route-announcer',
+ },
+ {
+ imports: ['useAnnouncer'],
+ from: '#app/composables/announcer',
+ },
+ {
+ imports: ['useRuntimeHook'],
+ from: '#app/composables/runtime-hook',
+ },
+ {
+ imports: ['useHead', 'useHeadSafe', 'useServerHeadSafe', 'useServerHead', 'useSeoMeta', 'useServerSeoMeta', 'injectHead'],
+ from: '#app/composables/head',
+ },
+]
+
+export const scriptsStubsPreset = {
+ imports: [
+ 'useScriptTriggerConsent',
+ 'useScriptEventPage',
+ 'useScriptTriggerElement',
+ 'useScript',
+ 'useScriptGoogleAnalytics',
+ 'useScriptPlausibleAnalytics',
+ 'useScriptCrisp',
+ 'useScriptClarity',
+ 'useScriptCloudflareWebAnalytics',
+ 'useScriptVercelAnalytics',
+ 'useScriptPostHog',
+ 'useScriptFathomAnalytics',
+ 'useScriptMatomoAnalytics',
+ 'useScriptMixpanelAnalytics',
+ 'useScriptBingUet',
+ 'useScriptGoogleTagManager',
+ 'useScriptGoogleAdsense',
+ 'useScriptGoogleRecaptcha',
+ 'useScriptGoogleSignIn',
+ 'useScriptSegment',
+ 'useScriptMetaPixel',
+ 'useScriptXPixel',
+ 'useScriptTikTokPixel',
+ 'useScriptIntercom',
+ 'useScriptHotjar',
+ 'useScriptStripe',
+ 'useScriptLemonSqueezy',
+ 'useScriptVimeoPlayer',
+ 'useScriptYouTubePlayer',
+ 'useScriptGoogleMaps',
+ 'useScriptNpm',
+ 'useScriptUmamiAnalytics',
+ 'useScriptSnapchatPixel',
+ 'useScriptRybbitAnalytics',
+ 'useScriptDatabuddyAnalytics',
+ 'useScriptRedditPixel',
+ 'useScriptPayPal',
+ 'useScriptGravatar',
+ 'useScriptAhrefsAnalytics',
+ 'useScriptLinkedInInsight',
+ 'useScriptCalendly',
+ 'useScriptUsercentrics',
+ ],
+ priority: -1,
+ from: '#app/composables/script-stubs',
+} satisfies InlinePreset
+
+// This is a separate preset as we'll swap these out for import from `vue-router` itself in `pages` module
+const routerPreset = defineUnimportPreset({
+ imports: ['onBeforeRouteLeave', 'onBeforeRouteUpdate'],
+ from: '#app/composables/router',
+})
+
+// vue
+const vuePreset = defineUnimportPreset({
+ from: 'vue',
+ imports: [
+ // <script setup>
+ 'withCtx',
+ 'withDirectives',
+ 'withKeys',
+ 'withMemo',
+ 'withModifiers',
+ 'withScopeId',
+
+ // Lifecycle
+ 'onActivated',
+ 'onBeforeMount',
+ 'onBeforeUnmount',
+ 'onBeforeUpdate',
+ 'onDeactivated',
+ 'onErrorCaptured',
+ 'onMounted',
+ 'onRenderTracked',
+ 'onRenderTriggered',
+ 'onServerPrefetch',
+ 'onUnmounted',
+ 'onUpdated',
+
+ // Reactivity
+ 'computed',
+ 'customRef',
+ 'isProxy',
+ 'isReactive',
+ 'isReadonly',
+ 'isRef',
+ 'markRaw',
+ 'proxyRefs',
+ 'reactive',
+ 'readonly',
+ 'ref',
+ 'shallowReactive',
+ 'shallowReadonly',
+ 'shallowRef',
+ 'toRaw',
+ 'toRef',
+ 'toRefs',
+ 'triggerRef',
+ 'unref',
+ 'watch',
+ 'watchEffect',
+ 'watchPostEffect',
+ 'watchSyncEffect',
+ 'onWatcherCleanup',
+ 'isShallow',
+
+ // effect
+ 'effect',
+ 'effectScope',
+ 'getCurrentScope',
+ 'onScopeDispose',
+
+ // Component
+ 'defineComponent',
+ 'defineAsyncComponent',
+ 'resolveComponent',
+ 'getCurrentInstance',
+ 'h',
+ 'inject',
+ 'hasInjectionContext',
+ 'nextTick',
+ 'provide',
+ 'toValue',
+ 'useModel',
+ 'useAttrs',
+ 'useCssModule',
+ 'useCssVars',
+ 'useSlots',
+ 'useTransitionState',
+ 'useId',
+ 'useTemplateRef',
+ 'useShadowRoot',
+ 'useCssVars',
+ ],
+})
+
+const vueTypesPreset = defineUnimportPreset({
+ from: 'vue',
+ type: true,
+ imports: [
+ 'Component',
+ 'ComponentPublicInstance',
+ 'ComputedRef',
+ 'DirectiveBinding',
+ 'ExtractDefaultPropTypes',
+ 'ExtractPropTypes',
+ 'ExtractPublicPropTypes',
+ 'InjectionKey',
+ 'PropType',
+ 'Ref',
+ 'MaybeRef',
+ 'MaybeRefOrGetter',
+ 'VNode',
+ 'WritableComputedRef',
+ ],
+})
+
+export const appCompatPresets: InlinePreset[] = [
+ {
+ imports: ['requestIdleCallback', 'cancelIdleCallback'],
+ from: '#app/compat/idle-callback',
+ },
+ {
+ imports: ['setInterval'],
+ from: '#app/compat/interval',
+ },
+]
+
+export const lazyHydrationMacroPreset = [
+ {
+ imports: ['defineLazyHydrationComponent'],
+ from: '#app/composables/lazy-hydration',
+ },
+]
+
+export const defaultPresets: InlinePreset[] = [
+ ...commonPresets,
+ ...granularAppPresets,
+ routerPreset,
+ vuePreset,
+ vueTypesPreset,
+]
diff --git a/packages/nuxt/src/imports/transform.ts b/packages/nuxt/src/imports/transform.ts
new file mode 100644
index 000000000000..9c814f4617e2
--- /dev/null
+++ b/packages/nuxt/src/imports/transform.ts
@@ -0,0 +1,64 @@
+import { createUnplugin } from 'unplugin'
+import type { Unimport } from 'unimport'
+import { normalize } from 'pathe'
+import { tryUseNuxt } from '@nuxt/kit'
+
+import { isJS, isVue } from '../core/utils/index.ts'
+import { installNuxtModule } from '../core/features.ts'
+import type { ImportsOptions } from 'nuxt/schema'
+
+const NODE_MODULES_RE = /[\\/]node_modules[\\/]/
+const IMPORTS_RE = /(['"])#imports\1/
+
+interface TransformPluginOptions {
+ ctx: Pick<Unimport, 'injectImports'>
+ options: Partial<ImportsOptions>
+ sourcemap?: boolean
+}
+
+export const TransformPlugin = ({ ctx, options, sourcemap }: TransformPluginOptions) => createUnplugin(() => {
+ return {
+ name: 'nuxt:imports-transform',
+ enforce: 'post',
+ transformInclude (id) {
+ // Included
+ if (options.transform?.include?.some(pattern => pattern.test(id))) {
+ return true
+ }
+ // Excluded
+ if (options.transform?.exclude?.some(pattern => pattern.test(id))) {
+ return false
+ }
+
+ // Vue files
+ if (isVue(id, { type: ['script', 'template'] })) {
+ return true
+ }
+
+ // JavaScript files
+ return isJS(id)
+ },
+ async transform (code, id) {
+ id = normalize(id)
+ const isNodeModule = NODE_MODULES_RE.test(id) && !options.transform?.include?.some(pattern => pattern.test(id))
+ // For modules in node_modules, we only transform `#imports` but not doing imports
+ if (isNodeModule && !IMPORTS_RE.test(code)) {
+ return
+ }
+
+ const { s, imports } = await ctx.injectImports(code, id, { autoImport: options.autoImport && !isNodeModule })
+ if (imports.some(i => i.from === '#app/composables/script-stubs') && tryUseNuxt()?.options.test === false) {
+ installNuxtModule('@nuxt/scripts')
+ }
+
+ if (s.hasChanged()) {
+ return {
+ code: s.toString(),
+ map: sourcemap
+ ? s.generateMap({ hires: true })
+ : undefined,
+ }
+ }
+ },
+ }
+})
diff --git a/packages/nuxt/src/index.ts b/packages/nuxt/src/index.ts
new file mode 100644
index 000000000000..a799c76fccc4
--- /dev/null
+++ b/packages/nuxt/src/index.ts
@@ -0,0 +1,2 @@
+export { createNuxt, loadNuxt } from './core/nuxt.ts'
+export { build } from './core/builder.ts'
diff --git a/packages/nuxt/src/pages/build.d.ts b/packages/nuxt/src/pages/build.d.ts
new file mode 100644
index 000000000000..c004fca77019
--- /dev/null
+++ b/packages/nuxt/src/pages/build.d.ts
@@ -0,0 +1,17 @@
+declare module '#build/router.options.mjs' {
+ import type { RouterOptions } from '@nuxt/schema'
+
+ export const hashMode: boolean
+ const _default: RouterOptions
+ export default _default
+}
+
+declare module '#build/routes' {
+ import type { RouterOptions } from '@nuxt/schema'
+ import type { Router, RouterOptions as VueRouterOptions } from 'vue-router'
+
+ export const handleHotUpdate: (_router: Router, _generateRoutes: RouterOptions['routes']) => void
+
+ const _default: VueRouterOptions['routes']
+ export default _default
+}
diff --git a/packages/nuxt/src/pages/module.ts b/packages/nuxt/src/pages/module.ts
new file mode 100644
index 000000000000..c9a4332b6bfb
--- /dev/null
+++ b/packages/nuxt/src/pages/module.ts
@@ -0,0 +1,784 @@
+import { existsSync, readdirSync } from 'node:fs'
+import { mkdir, readFile } from 'node:fs/promises'
+import { addBuildPlugin, addComponent, addPlugin, addTemplate, addTypeTemplate, defineNuxtModule, findPath, getLayerDirectories, isIgnored, resolvePath, useNitro } from '@nuxt/kit'
+import { dirname, join, relative, resolve } from 'pathe'
+import { genImport, genInlineTypeImport, genObjectFromRawEntries, genObjectKey, genString } from 'knitwork'
+import { joinURL } from 'ufo'
+import { createRoutesContext, resolveOptions } from 'vue-router/unplugin'
+import type { EditableTreeNode, Options as TypedRouterOptions } from 'vue-router/unplugin'
+import type { NitroRouteConfig } from 'nitro/types'
+import { defu } from 'defu'
+import { isEqual } from 'ohash'
+import { distDir } from '../dirs.ts'
+import { resolveTypePaths } from '../core/utils/types.ts'
+import { logger } from '../utils.ts'
+import picomatch from 'picomatch'
+import { resolvePagesRoutes as _resolvePagesRoutes, augmentAndResolve, createPagesContext, defaultExtractionKeys, normalizeRoutes, resolveRoutePaths, toRou3Patterns } from './utils.ts'
+import type { PagesContext } from './utils.ts'
+import { globRouteRulesFromPages, removePagesRules } from './route-rules.ts'
+import { PageMetaPlugin } from './plugins/page-meta.ts'
+import { RouteInjectionPlugin } from './plugins/route-injection.ts'
+import type { Nuxt, NuxtPage } from 'nuxt/schema'
+import type { InlinePreset } from 'unimport'
+
+const OPTIONAL_PARAM_RE = /^\/?:.*(?:\?|\(\.\*\)\*)$/
+
+export const pagesImportPresets: InlinePreset[] = [
+ { imports: ['definePageMeta'], from: '#app/composables/pages' },
+ { imports: ['PageMeta'], from: '#app/composables/pages', type: true },
+ { imports: ['useLink'], from: 'vue-router' },
+]
+
+export const routeRulesPresets: InlinePreset[] = [
+ { imports: ['defineRouteRules'], from: '#app/composables/pages' },
+]
+
+async function resolveRouterOptions (nuxt: Nuxt, builtInRouterOptions: string) {
+ const context = {
+ files: [] as Array<{ path: string, optional?: boolean }>,
+ }
+
+ for (const layer of nuxt.options._layers) {
+ const path = await findPath(resolve(layer.config.srcDir, layer.config.dir?.app || 'app', 'router.options'))
+ if (path) { context.files.unshift({ path }) }
+ }
+
+ // Add default options at beginning
+ context.files.unshift({ path: builtInRouterOptions, optional: true })
+
+ await nuxt.callHook('pages:routerOptions', context)
+ return context.files
+}
+
+export default defineNuxtModule({
+ meta: {
+ name: 'nuxt:pages',
+ configKey: 'pages',
+ },
+ defaults: nuxt => ({
+ enabled: typeof nuxt.options.pages === 'boolean' ? nuxt.options.pages : undefined as undefined | boolean,
+ pattern: `**/*{${nuxt.options.extensions.join(',')}}` as string | string[],
+ }),
+ async setup (_options, nuxt) {
+ const runtimeDir = resolve(distDir, 'pages/runtime')
+
+ const options = typeof _options === 'boolean' ? { enabled: _options ?? nuxt.options.pages, pattern: `**/*{${nuxt.options.extensions.join(',')}}` } : { ..._options }
+ options.pattern = Array.isArray(options.pattern) ? [...new Set(options.pattern)] : options.pattern
+
+ let inlineRulesCache: Record<string, NitroRouteConfig> = {}
+ let updateRouteConfig: (inlineRules: Record<string, NitroRouteConfig>) => void | Promise<void>
+ if (nuxt.options.experimental.inlineRouteRules) {
+ nuxt.hook('nitro:init', (nitro) => {
+ updateRouteConfig = async (inlineRules) => {
+ if (!isEqual(inlineRulesCache, inlineRules)) {
+ await nitro.updateConfig({ routeRules: defu(inlineRules, nitro.options._config.routeRules) })
+ nitro.routing.sync()
+ inlineRulesCache = inlineRules
+ }
+ }
+ })
+ }
+
+ const useExperimentalTypedPages = nuxt.options.experimental.typedPages
+ const builtInRouterOptions = await findPath(resolve(runtimeDir, 'router.options')) || resolve(runtimeDir, 'router.options')
+
+ const pagesDirs = getLayerDirectories(nuxt).map(dirs => dirs.appPages)
+
+ // Persistent route tree for incremental dev-mode updates
+ const pagesCtx: PagesContext | undefined = nuxt.options.dev
+ ? createPagesContext({
+ roots: pagesDirs,
+ shouldUseServerComponents: !!nuxt.options.experimental.componentIslands,
+ })
+ : undefined
+
+ // Compile page pattern to a fast matcher for watcher add events
+ const isPagePattern = picomatch(
+ Array.isArray(options.pattern) ? options.pattern : [options.pattern],
+ )
+
+ const handleRouteRules = async (pages: NuxtPage[]) => {
+ if (nuxt.options.experimental.inlineRouteRules) {
+ const routeRules = globRouteRulesFromPages(pages)
+ await updateRouteConfig?.(routeRules)
+ } else {
+ removePagesRules(pages)
+ }
+ }
+
+ const resolvePagesRoutes = async (pattern: string | string[], nuxt: Nuxt) => {
+ const pages = await _resolvePagesRoutes(pattern, nuxt, pagesCtx)
+ await handleRouteRules(pages)
+ return pages
+ }
+
+ /** Emit from existing tree + augment + hooks + route rules (used for incremental updates). */
+ const augmentAndResolvePages = async (pages: NuxtPage[], trackedFiles: Set<string>, nuxt: Nuxt) => {
+ const resolved = await augmentAndResolve(pages, trackedFiles, nuxt)
+ await handleRouteRules(resolved)
+ return resolved
+ }
+
+ nuxt.options.alias['#vue-router'] = 'vue-router'
+ const routerPath = (await resolveTypePaths(['vue-router'], nuxt.options.modulesDir))[0]?.[1] || 'vue-router'
+ nuxt.hook('prepare:types', ({ tsConfig }) => {
+ tsConfig.compilerOptions ||= {}
+ tsConfig.compilerOptions.paths ||= {}
+ tsConfig.compilerOptions.paths['#vue-router'] = [routerPath]
+ delete tsConfig.compilerOptions.paths['#vue-router/*']
+ })
+
+ // Disable module (and use universal router) if pages dir do not exists or user has disabled it
+ const isNonEmptyDir = (dir: string) => existsSync(dir) && readdirSync(dir).length
+ const userPreference = options.enabled
+ const isPagesEnabled = async () => {
+ if (typeof userPreference === 'boolean') {
+ return userPreference
+ }
+ const routerOptionsFiles = await resolveRouterOptions(nuxt, builtInRouterOptions)
+ if (routerOptionsFiles.filter(p => !p.optional).length > 0) {
+ return true
+ }
+ if (pagesDirs.some(dir => isNonEmptyDir(dir))) {
+ return true
+ }
+
+ const pages = await resolvePagesRoutes(options.pattern, nuxt)
+ if (pages.length) {
+ if (nuxt.apps.default) {
+ nuxt.apps.default.pages = pages
+ }
+ return true
+ }
+
+ return false
+ }
+ options.enabled = await isPagesEnabled()
+ nuxt.options.pages = options
+ // For backwards compatibility with `@nuxtjs/i18n` and other modules that serialize `nuxt.options.pages` directly
+ // TODO: remove in a future major
+ Object.defineProperty(nuxt.options.pages, 'toString', {
+ enumerable: false,
+ get: () => () => options.enabled,
+ })
+
+ if (nuxt.options.dev && options.enabled) {
+ // Add plugin to check if pages are enabled without NuxtPage being instantiated
+ addPlugin(resolve(runtimeDir, 'plugins/check-if-page-unused'))
+ }
+
+ nuxt.hook('app:templates', (app) => {
+ if (!nuxt.options.ssr && app.pages?.some(p => p.mode === 'server')) {
+ logger.warn('Using server pages with `ssr: false` is not supported with auto-detected component islands. Set `experimental.componentIslands` to `true`.')
+ }
+ })
+
+ // Restart Nuxt when pages dir is added or removed
+ const restartPaths = nuxt.options._layers.flatMap((layer) => {
+ const pagesDir = (layer.config.rootDir === nuxt.options.rootDir ? nuxt.options.dir : layer.config.dir)?.pages || 'pages'
+ return [
+ resolve(layer.config.srcDir || layer.cwd, layer.config.dir?.app || 'app', 'router.options.ts'),
+ resolve(layer.config.srcDir || layer.cwd, pagesDir),
+ ]
+ })
+
+ nuxt.hooks.hook('builder:watch', async (event, relativePath) => {
+ const path = resolve(nuxt.options.srcDir, relativePath)
+ if (restartPaths.some(p => p === path || path.startsWith(p + '/'))) {
+ const newSetting = await isPagesEnabled()
+ if (options.enabled !== newSetting) {
+ logger.info('Pages', newSetting ? 'enabled' : 'disabled')
+ return nuxt.callHook('restart')
+ }
+ }
+ })
+
+ if (!options.enabled) {
+ addPlugin(resolve(distDir, 'app/plugins/router'))
+ addTemplate({
+ filename: 'pages.mjs',
+ getContents: () => [
+ 'export { useRoute } from \'#app/composables/router\'',
+ 'export const START_LOCATION = Symbol(\'router:start-location\')',
+ ].join('\n'),
+ })
+ // used by `<NuxtLink>`
+ addTemplate({
+ filename: 'router.options.mjs',
+ getContents: () => {
+ return [
+ 'export const hashMode = false',
+ 'export default {}',
+ ].join('\n')
+ },
+ })
+ addTypeTemplate({
+ filename: 'types/middleware.d.ts',
+ getContents: () => [
+ 'declare module \'nitro/types\' {',
+ ' interface NitroRouteConfig {',
+ ' appMiddleware?: string | string[] | Record<string, boolean>',
+ ' }',
+ '}',
+ 'declare module \'nitro\' {',
+ ' interface NitroRouteConfig {',
+ ' appMiddleware?: string | string[] | Record<string, boolean>',
+ ' }',
+ '}',
+ 'export {}',
+ ].join('\n'),
+ }, { nuxt: true, nitro: true, node: true })
+ addComponent({
+ name: 'NuxtPage',
+ priority: 10, // built-in that we do not expect the user to override
+ filePath: resolve(distDir, 'pages/runtime/page-placeholder'),
+ })
+ // Prerender index if pages integration is not enabled
+ nuxt.hook('nitro:init', (nitro) => {
+ if (nuxt.options.dev || !nuxt.options.ssr || !nitro.options.static || !nitro.options.prerender.crawlLinks) { return }
+
+ nitro.options.prerender.routes ||= []
+ nitro.options.prerender.routes.push('/')
+ })
+ return
+ }
+
+ if (useExperimentalTypedPages) {
+ const declarationFile = resolve(nuxt.options.buildDir, 'types/typed-router.d.ts')
+
+ const typedRouterOptions: TypedRouterOptions = {
+ routesFolder: [],
+ dts: declarationFile,
+ logs: nuxt.options.debug && nuxt.options.debug.router,
+ async beforeWriteFiles (rootPage) {
+ for (const child of rootPage.children) {
+ child.delete()
+ }
+ const pages = nuxt.apps.default?.pages || await resolvePagesRoutes(options.pattern, nuxt)
+ if (nuxt.apps.default) {
+ nuxt.apps.default.pages = pages
+ }
+ const addedPagePaths = new Set<string>()
+ function addPage (parent: EditableTreeNode, page: NuxtPage, basePath: string = '') {
+ // Avoid duplicate keys in the generated RouteNamedMap type
+ const absolutePagePath = joinURL(basePath, page.path)
+
+ // way to add a route without a file, which must be possible
+ const route = addedPagePaths.has(absolutePagePath)
+ ? parent
+ : page.path[0] === '/'
+ // @ts-expect-error TODO: either fix types upstream or figure out another
+ // way to add a route without a file, which must be possible
+ ? rootPage.insert(page.path, page.file)
+ // @ts-expect-error TODO: either fix types upstream or figure out another
+ // way to add a route without a file, which must be possible
+ : parent.insert(page.path, page.file)
+
+ addedPagePaths.add(absolutePagePath)
+ if (page.meta) {
+ route.addToMeta(page.meta)
+ }
+ if (page.alias) {
+ route.addAlias(Array.isArray(page.alias) ? page.alias : [page.alias])
+ }
+ if (page.name) {
+ route.name = page.name
+ }
+ // TODO: implement redirect support
+ // if (page.redirect) {}
+ if (page.children) {
+ for (const child of page.children) {
+ addPage(route, child, absolutePagePath)
+ }
+ }
+ }
+
+ for (const page of pages) {
+ addPage(rootPage, page)
+ }
+ },
+ }
+
+ nuxt.hook('prepare:types', ({ references }) => {
+ // This file will be generated by vue-router
+ references.push({ path: declarationFile })
+ })
+
+ const context = createRoutesContext(resolveOptions(typedRouterOptions))
+ await mkdir(dirname(declarationFile), { recursive: true })
+ await context.scanPages(false)
+
+ if (nuxt.options._prepare || !nuxt.options.dev) {
+ // TODO: could we generate this from context instead?
+ const dts = await readFile(declarationFile, 'utf-8')
+ addTemplate({
+ filename: 'types/typed-router.d.ts',
+ getContents: () => dts,
+ })
+ }
+
+ // Regenerate types/typed-router.d.ts when adding or removing pages
+ nuxt.hook('app:templatesGenerated', async (_app, _templates, options) => {
+ if (!options?.filter || options.filter({ filename: 'routes.mjs' } as any)) {
+ await context.scanPages()
+ }
+ })
+ }
+
+ // Add $router types and vue-router volar plugins
+ nuxt.hook('prepare:types', ({ references, tsConfig }) => {
+ references.push({ types: useExperimentalTypedPages ? 'vue-router/auto-routes' : 'vue-router' })
+
+ // Add vue-router volar plugins to tsconfig
+ tsConfig.vueCompilerOptions ||= {}
+ tsConfig.vueCompilerOptions.plugins ||= []
+
+ // Always add <route> block support
+ tsConfig.vueCompilerOptions.plugins.push('vue-router/volar/sfc-route-blocks')
+
+ // Add typed useRoute() when typedPages is enabled
+ if (useExperimentalTypedPages) {
+ tsConfig.vueCompilerOptions.plugins.push({
+ name: 'vue-router/volar/sfc-typed-router',
+ options: { rootDir: nuxt.options.rootDir },
+ })
+ }
+ })
+
+ // Add vue-router route guard imports
+ nuxt.hook('imports:sources', (sources) => {
+ const routerImports = sources.find(s => typeof s === 'object' && 'from' in s && s.from === '#app/composables/router' && s.imports.includes('onBeforeRouteLeave')) as InlinePreset | undefined
+ if (routerImports) {
+ routerImports.from = 'vue-router'
+ }
+ })
+
+ // Regenerate templates when adding or removing pages
+ const updateTemplatePaths = getLayerDirectories(nuxt)
+ .flatMap(dirs => [
+ dirs.appPages,
+ dirs.appLayouts,
+ dirs.appMiddleware,
+ ])
+
+ function isPage (file: string, pages = nuxt.apps.default?.pages): boolean {
+ if (!pages) { return false }
+ return pages.some(page => page.file === file) || pages.some(page => page.children && isPage(file, page.children))
+ }
+
+ nuxt.hooks.hookOnce('app:templates', async (app) => {
+ app.pages ||= await resolvePagesRoutes(options.pattern, nuxt)
+ })
+
+ nuxt.hook('builder:watch', async (event, relativePath) => {
+ const path = resolve(nuxt.options.srcDir, relativePath)
+ const shouldAlwaysRegenerate = nuxt.options.experimental.scanPageMeta && isPage(path)
+
+ if (event === 'change' && !shouldAlwaysRegenerate) { return }
+
+ // Attempt incremental tree update for page file add/unlink in dev mode
+ const layerIndex = pagesDirs.findIndex(dir => path.startsWith(dir))
+ const isInPagesDir = layerIndex !== -1
+
+ if (pagesCtx && isInPagesDir && !shouldAlwaysRegenerate) {
+ try {
+ if (event === 'add') {
+ const relativeToDir = relative(pagesDirs[layerIndex]!, path)
+ if (!isPagePattern(relativeToDir) || isIgnored(path)) { return }
+ pagesCtx.addFile(path, layerIndex)
+ } else if (event === 'unlink') {
+ if (!pagesCtx.removeFile(path)) { return }
+ }
+ // Re-emit from mutated tree + run downstream pipeline
+ const pages = pagesCtx.emit()
+ nuxt.apps.default!.pages = await augmentAndResolvePages(pages, pagesCtx.trackedFiles, nuxt)
+ } catch (err) {
+ // Fallback: full rebuild on unexpected tree error
+ logger.warn('Incremental route update failed, performing full rebuild', err)
+ nuxt.apps.default!.pages = await resolvePagesRoutes(options.pattern, nuxt)
+ }
+ } else if (shouldAlwaysRegenerate || updateTemplatePaths.some(dir => path.startsWith(dir))) {
+ // Full rebuild: scanPageMeta content change, layout/middleware change, or no pagesCtx
+ nuxt.apps.default!.pages = await resolvePagesRoutes(options.pattern, nuxt)
+ }
+ })
+
+ nuxt.hook('app:resolve', (app) => {
+ // Add default layout for pages
+ if (app.mainComponent === resolve(nuxt.options.appDir, 'components/welcome.vue')) {
+ app.mainComponent = resolve(runtimeDir, 'app.vue')
+ }
+ app.middleware.unshift({
+ name: 'validate',
+ path: resolve(runtimeDir, 'validate'),
+ global: true,
+ })
+ })
+
+ nuxt.hook('app:resolve', (app) => {
+ const nitro = useNitro()
+ if (nitro.options.prerender.crawlLinks || ('routing' in nitro && nitro.routing.routeRules.routes.some(r => r.data.prerender))) {
+ app.plugins.push({
+ src: resolve(runtimeDir, 'plugins/prerender.server'),
+ mode: 'server',
+ })
+ }
+ })
+
+ // Record all pages for use in prerendering
+ const prerenderRoutes = new Set<string>()
+
+ function processPages (pages: NuxtPage[], currentPath = '/') {
+ for (const page of pages) {
+ // Skip internal stub routes (redirects, test routes) from prerendering
+ if (page._sync) { continue }
+
+ // Add root of optional dynamic paths and catchalls
+ if (OPTIONAL_PARAM_RE.test(page.path) && !page.children?.length) {
+ prerenderRoutes.add(currentPath)
+ }
+
+ // Skip dynamic paths
+ if (page.path.includes(':')) { continue }
+
+ const route = joinURL(currentPath, page.path)
+ prerenderRoutes.add(route)
+
+ if (page.children) {
+ processPages(page.children, route)
+ }
+ }
+ }
+
+ nuxt.hook('pages:resolved', (pages) => {
+ if (nuxt.options.dev) { return }
+
+ prerenderRoutes.clear()
+ processPages(pages)
+ })
+
+ nuxt.hook('nitro:build:before', (nitro) => {
+ if (nuxt.options.dev || nuxt.options.router.options.hashMode) { return }
+
+ nitro.options.ssrRoutes = [
+ ...nitro.options.ssrRoutes || [],
+ ...toRou3Patterns(nuxt.apps.default?.pages || []),
+ ]
+
+ nitro.options.prerender.routes ||= []
+
+ // Inject page patterns that explicitly match `prerender: true` route rule
+ if (!nitro.options.static) {
+ for (const route of prerenderRoutes) {
+ const rules = defu({} as Record<string, any>, ...nitro.routing.routeRules.matchAll('', route).reverse())
+ if (rules.prerender) {
+ nitro.options.prerender.routes.push(route)
+ }
+ }
+ }
+
+ if (!nitro.options.static || !nitro.options.prerender.crawlLinks) { return }
+
+ // Only hint the first route when `ssr: true` and no routes are provided
+ // as the rest will be injected at runtime when this is prerendered
+ if (nuxt.options.ssr) {
+ const [firstPage] = [...prerenderRoutes].sort()
+ nitro.options.prerender.routes.push(firstPage || '/')
+ return
+ }
+
+ // Prerender all non-dynamic page routes when generating `ssr: false` app
+ for (const route of nitro.options.prerender.routes || []) {
+ prerenderRoutes.add(route)
+ }
+ nitro.options.prerender.routes = Array.from(prerenderRoutes)
+ })
+
+ nuxt.hook('imports:sources', (sources) => {
+ sources.push(...pagesImportPresets)
+ if (nuxt.options.experimental.inlineRouteRules) {
+ sources.push(...routeRulesPresets)
+ }
+ })
+
+ const componentStubPath = await resolvePath(resolve(runtimeDir, 'component-stub'))
+ if (nuxt.options.test && nuxt.options.dev) {
+ // add component testing route so 404 won't be triggered
+ nuxt.hook('pages:extend', (routes) => {
+ routes.push({
+ _sync: true,
+ path: '/__nuxt_component_test__/:pathMatch(.*)',
+ file: componentStubPath,
+ })
+ })
+ }
+
+ // Add all redirect paths as valid routes to router; we will handle these in a client-side middleware.
+ nuxt.hook('pages:extend', (routes) => {
+ const nitro = useNitro()
+ let resolvedRoutes: string[]
+ for (const route of 'routing' in nitro ? nitro.routing.routeRules.routes : []) {
+ if (!route.data.redirect) { continue }
+ resolvedRoutes ||= routes.flatMap(route => resolveRoutePaths(route))
+ // skip if there's already a route matching this path
+ if (resolvedRoutes.includes(route.route)) { continue }
+ routes.push({
+ _sync: true,
+ path: route.route.replace(/\/[^/]*\*\*/, '/:pathMatch(.*)'),
+ file: componentStubPath,
+ })
+ }
+ })
+
+ // Extract macros from pages
+ const extraPageMetaExtractionKeys = nuxt.options?.experimental?.extraPageMetaExtractionKeys || []
+ const extractedKeys = [
+ ...defaultExtractionKeys,
+ ...extraPageMetaExtractionKeys,
+ ]
+
+ nuxt.hook('modules:done', () => {
+ addBuildPlugin(PageMetaPlugin({
+ dev: nuxt.options.dev,
+ isPage,
+ routesPath: resolve(nuxt.options.buildDir, 'routes.mjs'),
+ extractedKeys: nuxt.options.experimental.scanPageMeta ? extractedKeys : [],
+ }))
+ })
+
+ // Add prefetching support for middleware & layouts
+ addPlugin(resolve(runtimeDir, 'plugins/prefetch.client'))
+
+ // Add build plugin to ensure template $route is kept in sync with `<NuxtPage>`
+ if (nuxt.options.experimental.templateRouteInjection) {
+ addBuildPlugin(RouteInjectionPlugin(nuxt), { server: false })
+ }
+
+ // Add router plugin
+ addPlugin(resolve(runtimeDir, 'plugins/router'))
+
+ const getSources = (pages: NuxtPage[]): string[] => pages
+ .filter(p => Boolean(p.file))
+ .flatMap(p =>
+ [relative(nuxt.options.srcDir, p.file as string), ...(p.children?.length ? getSources(p.children) : [])],
+ )
+
+ // Do not prefetch page chunks
+ nuxt.hook('build:manifest', (manifest) => {
+ if (nuxt.options.dev) { return }
+ const sourceFiles = nuxt.apps.default?.pages?.length ? getSources(nuxt.apps.default.pages) : []
+
+ for (const [key, chunk] of Object.entries(manifest)) {
+ if (chunk.src && Object.values(nuxt.apps).some(app => app.pages?.some(page => page.mode === 'server' && page.file === join(nuxt.options.srcDir, chunk.src!)))) {
+ delete manifest[key]
+ continue
+ }
+ if (chunk.isEntry) {
+ chunk.dynamicImports =
+ chunk.dynamicImports?.filter(i => !sourceFiles.includes(i))
+ }
+ }
+ })
+
+ const serverComponentRuntime = await findPath(join(distDir, 'components/runtime/server-component')) ?? join(distDir, 'components/runtime/server-component')
+ const clientComponentRuntime = await findPath(join(distDir, 'components/runtime/client-component')) ?? join(distDir, 'components/runtime/client-component')
+
+ // Add routes template
+ addTemplate({
+ filename: 'routes.mjs',
+ getContents ({ app }) {
+ if (!app.pages) { return ROUTES_HMR_CODE + 'export default []' }
+ const { routes, imports } = normalizeRoutes(app.pages, new Set(), {
+ serverComponentRuntime,
+ clientComponentRuntime,
+ overrideMeta: !!nuxt.options.experimental.scanPageMeta,
+ })
+ return ROUTES_HMR_CODE + [...imports, `export default ${routes}`].join('\n')
+ },
+ })
+
+ // Add vue-router import for `<NuxtLayout>` integration
+ addTemplate({
+ filename: 'pages.mjs',
+ getContents: () => 'export { START_LOCATION, useRoute } from \'vue-router\'',
+ })
+
+ nuxt.options.vite.resolve ||= {}
+ nuxt.options.vite.resolve.dedupe ||= []
+ nuxt.options.vite.resolve.dedupe.push('vue-router')
+
+ // Add router options template
+ addTemplate({
+ filename: 'router.options.mjs',
+ getContents: async ({ nuxt }) => {
+ // Scan and register app/router.options files
+ const routerOptionsFiles = await resolveRouterOptions(nuxt, builtInRouterOptions)
+
+ const configRouterOptions = genObjectFromRawEntries(Object.entries(nuxt.options.router.options)
+ .map(([key, value]) => [key, genString(value as string)]))
+
+ const hashModes: string[] = []
+ for (let index = 0; index < routerOptionsFiles.length; index++) {
+ const file = routerOptionsFiles[index]!
+ if (file.path !== builtInRouterOptions) {
+ hashModes.unshift(`routerOptions${index}.hashMode`)
+ }
+ }
+
+ return [
+ ...routerOptionsFiles.map((file, index) => genImport(file.path, `routerOptions${index}`)),
+ `const configRouterOptions = ${configRouterOptions}`,
+ `export const hashMode = ${[
+ ...hashModes,
+ nuxt.options.router.options.hashMode,
+ ].join(' ?? ')}`,
+ 'export default {',
+ '...configRouterOptions,',
+ ...routerOptionsFiles.map((_, index) => `...routerOptions${index},`),
+ '}',
+ ].join('\n')
+ },
+ })
+
+ addTypeTemplate({
+ filename: 'types/middleware.d.ts',
+ getContents: ({ app }) => {
+ const namedMiddleware = app.middleware.filter(mw => !mw.global)
+ return [
+ 'import type { NavigationGuard } from \'vue-router\'',
+ `export type MiddlewareKey = ${namedMiddleware.map(mw => genString(mw.name)).join(' | ') || 'never'}`,
+ 'declare module \'nuxt/app\' {',
+ ' interface PageMeta {',
+ ' middleware?: MiddlewareKey | NavigationGuard | Array<MiddlewareKey | NavigationGuard>',
+ ' }',
+ '}',
+ ].join('\n')
+ },
+ })
+
+ addTypeTemplate({
+ filename: 'types/nitro-middleware.d.ts',
+ getContents: ({ app }) => {
+ const namedMiddleware = app.middleware.filter(mw => !mw.global)
+ return [
+ `export type MiddlewareKey = ${namedMiddleware.map(mw => genString(mw.name)).join(' | ') || 'never'}`,
+ 'declare module \'nitro/types\' {',
+ ' interface NitroRouteConfig {',
+ ' appMiddleware?: MiddlewareKey | MiddlewareKey[] | Record<MiddlewareKey, boolean>',
+ ' }',
+ '}',
+ 'declare module \'nitro\' {',
+ ' interface NitroRouteConfig {',
+ ' appMiddleware?: MiddlewareKey | MiddlewareKey[] | Record<MiddlewareKey, boolean>',
+ ' }',
+ '}',
+ ].join('\n')
+ },
+ }, { nuxt: true, nitro: true, node: true })
+
+ addTypeTemplate({
+ filename: 'types/layouts.d.ts',
+ getContents: ({ app }) => {
+ return [
+ 'import type { ComputedRef, MaybeRef } from \'vue\'',
+ '',
+ 'type ComponentProps<T> = T extends new(...args: any) => { $props: infer P } ? NonNullable<P>',
+ ' : T extends (props: infer P, ...args: any) => any ? P',
+ ' : {}',
+ '',
+ 'declare module \'nuxt/app\' {',
+ ' interface NuxtLayouts {',
+ ...Object.values(app.layouts).map(layout => ` ${genObjectKey(layout.name)}: ComponentProps<${genInlineTypeImport(layout.file)}>`),
+ ' }',
+ ' export type LayoutKey = keyof NuxtLayouts extends never ? string : keyof NuxtLayouts',
+ ' interface PageMeta {',
+ ' layout?: MaybeRef<LayoutKey | false> | ComputedRef<LayoutKey | false> | {',
+ ' [K in LayoutKey]: {',
+ ' name?: MaybeRef<K | false> | ComputedRef<K | false>',
+ ' props?: NuxtLayouts[K]',
+ ' }',
+ ' }[LayoutKey]',
+ ' }',
+ '}',
+ ].join('\n')
+ },
+ })
+
+ // add page meta types if enabled
+ if (nuxt.options.experimental.viewTransition) {
+ addTypeTemplate({
+ filename: 'types/view-transitions.d.ts',
+ getContents: () => {
+ return [
+ 'import type { ViewTransitionPageOptions } from \'../types/config\'',
+ 'declare module \'nuxt/app\' {',
+ ' interface PageMeta {',
+ ' viewTransition?: ViewTransitionPageOptions[\'enabled\'] | ViewTransitionPageOptions',
+ ' }',
+ '}',
+ 'export {}',
+ ].join('\n')
+ },
+ })
+ }
+
+ // Add <NuxtPage>
+ addComponent({
+ name: 'NuxtPage',
+ priority: 10, // built-in that we do not expect the user to override
+ filePath: resolve(distDir, 'pages/runtime/page'),
+ })
+ },
+})
+
+const ROUTES_HMR_CODE = /* js */`
+if (import.meta.hot) {
+ import.meta.hot.accept((mod) => {
+ const router = import.meta.hot.data.router
+ const generateRoutes = import.meta.hot.data.generateRoutes
+ if (!router || !generateRoutes) {
+ import.meta.hot.invalidate('[nuxt] Cannot replace routes because there is no active router. Reloading.')
+ return
+ }
+ const addedRoutes = router.getRoutes().filter(r => !r._initial)
+ router.clearRoutes()
+ const routes = generateRoutes(mod.default || mod)
+ function addRoutes (routes) {
+ for (const route of routes) {
+ router.addRoute(route)
+ }
+ for (const route of router.getRoutes()) {
+ route._initial = true
+ }
+ for (const route of addedRoutes) {
+ router.addRoute(route)
+ }
+ router.isReady().then(() => {
+ // Resolve the current path against the new routes to get updated meta
+ const newRoute = router.resolve(router.currentRoute.value.fullPath)
+ // Clear old meta values and assign new ones
+ for (const key of Object.keys(router.currentRoute.value.meta)) {
+ delete router.currentRoute.value.meta[key]
+ }
+ Object.assign(router.currentRoute.value.meta, newRoute.meta)
+ })
+ }
+ if (routes && 'then' in routes) {
+ routes.then(addRoutes)
+ } else {
+ addRoutes(routes)
+ }
+ })
+}
+
+export function handleHotUpdate(_router, _generateRoutes) {
+ if (import.meta.hot) {
+ import.meta.hot.data ||= {}
+ import.meta.hot.data.router = _router
+ import.meta.hot.data.generateRoutes = _generateRoutes
+ for (const route of _router.getRoutes()) {
+ route._initial = true
+ }
+ }
+}
+`
diff --git a/packages/nuxt/src/pages/plugins/page-meta.ts b/packages/nuxt/src/pages/plugins/page-meta.ts
new file mode 100644
index 000000000000..313d4f1d7153
--- /dev/null
+++ b/packages/nuxt/src/pages/plugins/page-meta.ts
@@ -0,0 +1,395 @@
+import { createUnplugin } from 'unplugin'
+import type { StaticImport } from 'mlly'
+import { findExports, findStaticImports, parseStaticImport } from 'mlly'
+import MagicString from 'magic-string'
+import { generateTransform, rolldownString } from 'rolldown-string'
+import { ScopeTracker, getUndeclaredIdentifiersInFunction, isBindingIdentifier, parseAndWalk, walk } from 'oxc-walker'
+import type { ScopeTrackerNode } from 'oxc-walker'
+
+import { logger } from '../../utils.ts'
+import { parseModuleId } from '../../core/utils/plugins.ts'
+import { isSerializable } from '../utils.ts'
+import type { ESTree, ParserOptions } from 'rolldown/utils'
+
+interface PageMetaPluginOptions {
+ dev?: boolean
+ isPage?: (file: string) => boolean
+ routesPath?: string
+ extractedKeys?: string[]
+}
+
+const HAS_MACRO_RE = /\bdefinePageMeta\s*\(\s*/
+
+const CODE_EMPTY = `
+const __nuxt_page_meta = null
+export default __nuxt_page_meta
+`
+
+const CODE_DEV_EMPTY = `
+const __nuxt_page_meta = {}
+export default __nuxt_page_meta
+`
+
+const CODE_HMR = `
+// Vite
+if (import.meta.hot) {
+ import.meta.hot.accept(mod => {
+ Object.assign(__nuxt_page_meta, mod)
+ })
+}
+// webpack
+if (import.meta.webpackHot) {
+ import.meta.webpackHot.accept((err) => {
+ if (err) { window.location = window.location.href }
+ })
+}`
+
+export const PageMetaPlugin = (options: PageMetaPluginOptions = {}) => createUnplugin(() => {
+ return {
+ name: 'nuxt:pages-macros-transform',
+ enforce: 'post',
+ transform: {
+ filter: {
+ id: {
+ include: /[?&]macro=true\b/,
+ exclude: [/(?:\?|%3F).*type=(?:style|template)/],
+ },
+ code: {
+ include: [
+ HAS_MACRO_RE,
+ /\bfrom\s+["'][^"'?]*\?[^"']*type=script[^"']*["']/,
+ /export\s+\{\s*default\s*\}\s+from\s+["'][^"'?]*\?[^"']*type=script[^"']*["']/,
+ /^(?!.*__nuxt_page_meta)(?!.*export\s+\{\s*default\s*\})(?!.*\bdefinePageMeta\s*\()[\s\S]*$/,
+ ],
+ },
+ },
+ handler (code, id, transformMeta?: unknown) {
+ const query = parseMacroQuery(id)
+ if (query.type && query.type !== 'script') { return }
+
+ const s = rolldownString(code, id, transformMeta)
+ function result () {
+ return generateTransform(s, id)
+ }
+
+ const hasMacro = HAS_MACRO_RE.test(code)
+
+ const imports = findStaticImports(code)
+
+ // [vite] Re-export any script imports
+ const scriptImport = imports.find(i => parseMacroQuery(i.specifier).type === 'script')
+ if (scriptImport) {
+ const reorderedQuery = rewriteQuery(scriptImport.specifier)
+ // Avoid using JSON.stringify which can add extra escapes to paths with non-ASCII characters
+ const quotedSpecifier = getQuotedSpecifier(scriptImport.code)?.replace(scriptImport.specifier, reorderedQuery) ?? JSON.stringify(reorderedQuery)
+ s.overwrite(0, code.length, `export { default } from ${quotedSpecifier}`)
+ return result()
+ }
+
+ // [webpack] Re-export any exports from script blocks in the components
+ const currentExports = findExports(code)
+ for (const match of currentExports) {
+ if (match.type !== 'default' || !match.specifier) {
+ continue
+ }
+
+ const reorderedQuery = rewriteQuery(match.specifier)
+ // Avoid using JSON.stringify which can add extra escapes to paths with non-ASCII characters
+ const quotedSpecifier = getQuotedSpecifier(match.code)?.replace(match.specifier, reorderedQuery) ?? JSON.stringify(reorderedQuery)
+ s.overwrite(0, code.length, `export { default } from ${quotedSpecifier}`)
+ return result()
+ }
+
+ if (!hasMacro && !code.includes('export { default }') && !code.includes('__nuxt_page_meta')) {
+ if (!code) {
+ s.append(options.dev ? (CODE_DEV_EMPTY + CODE_HMR) : CODE_EMPTY)
+ const { pathname } = parseModuleId(id)
+ logger.error(`The file \`${pathname}\` is not a valid page as it has no content.`)
+ } else {
+ s.overwrite(0, code.length, options.dev ? (CODE_DEV_EMPTY + CODE_HMR) : CODE_EMPTY)
+ }
+
+ return result()
+ }
+
+ const importMap = new Map<string, StaticImport>()
+ const addedImports = new Set()
+ for (const i of imports) {
+ const parsed = parseStaticImport(i)
+ for (const name of [
+ parsed.defaultImport,
+ ...Object.values(parsed.namedImports || {}),
+ parsed.namespacedImport,
+ ].filter(Boolean) as string[]) {
+ importMap.set(name, i)
+ }
+ }
+
+ function isStaticIdentifier (name: string | false): name is string {
+ return !!(name && importMap.has(name))
+ }
+
+ function addImport (name: string | false) {
+ if (!isStaticIdentifier(name)) { return }
+ const importValue = importMap.get(name)!.code.trim()
+ if (!addedImports.has(importValue)) {
+ addedImports.add(importValue)
+ }
+ }
+
+ const declarationNodes: ScopeTrackerNode[] = []
+ const addedDeclarations = new Set<string>()
+
+ function addDeclaration (node: ScopeTrackerNode) {
+ const codeSectionKey = `${resolveStart(node)}-${resolveEnd(node)}`
+ if (addedDeclarations.has(codeSectionKey)) { return }
+ addedDeclarations.add(codeSectionKey)
+ declarationNodes.push(node)
+ }
+
+ /**
+ * Adds an import or a declaration to the extracted code.
+ * @param name The name of the import or declaration to add.
+ * @param node The node that is currently being processed. (To detect self-references)
+ */
+ function addImportOrDeclaration (name: string, node?: ScopeTrackerNode) {
+ if (isStaticIdentifier(name)) {
+ addImport(name)
+ } else {
+ const declaration = scopeTracker.getDeclaration(name)
+ /*
+ Without checking for `declaration !== node`, we would end up in an infinite loop
+ when, for example, a variable is declared and then used in its own initializer.
+ (we shouldn't mask the underlying error by throwing a `Maximum call stack size exceeded` error)
+
+ ```ts
+ const a = { b: a }
+ ```
+ */
+ if (declaration && declaration !== node) {
+ processDeclaration(declaration)
+ }
+ }
+ }
+
+ const scopeTracker = new ScopeTracker({
+ preserveExitedScopes: true,
+ })
+
+ function processDeclaration (scopeTrackerNode: ScopeTrackerNode | null) {
+ if (scopeTrackerNode?.type === 'Variable') {
+ addDeclaration(scopeTrackerNode)
+
+ for (const decl of scopeTrackerNode.variableNode.declarations) {
+ if (!decl.init) { continue }
+ walk(decl.init, {
+ enter: (node, parent) => {
+ if (node.type === 'AwaitExpression') {
+ logger.error(`Await expressions are not supported in definePageMeta. File: '${id}'`)
+ throw new Error('await in definePageMeta')
+ }
+ if (
+ isBindingIdentifier(node, parent)
+ || node.type !== 'Identifier' // checking for `node.type` to narrow down the type
+ ) { return }
+
+ addImportOrDeclaration(node.name, scopeTrackerNode)
+ },
+ })
+ }
+ } else if (scopeTrackerNode?.type === 'Function') {
+ // arrow functions are going to be assigned to a variable
+ if (scopeTrackerNode.node.type === 'ArrowFunctionExpression') { return }
+ const name = scopeTrackerNode.node.id?.name
+ if (!name) { return }
+ addDeclaration(scopeTrackerNode)
+
+ const undeclaredIdentifiers = getUndeclaredIdentifiersInFunction(scopeTrackerNode.node)
+ for (const name of undeclaredIdentifiers) {
+ addImportOrDeclaration(name)
+ }
+ }
+ }
+
+ const { program: ast } = parseAndWalk(code, id, {
+ scopeTracker,
+ parseOptions: {
+ lang: query.lang ?? 'ts',
+ },
+ })
+
+ scopeTracker.freeze()
+
+ let instances = 0
+
+ walk(ast, {
+ scopeTracker,
+ enter: (node) => {
+ if (node.type !== 'CallExpression' || node.callee.type !== 'Identifier') { return }
+ if (!('name' in node.callee) || node.callee.name !== 'definePageMeta') { return }
+
+ instances++
+ const meta = node.arguments[0]
+
+ if (!meta) { return }
+ const metaCode = code!.slice(meta.start, meta.end)
+ const m = new MagicString(metaCode)
+
+ if (meta.type === 'ObjectExpression') {
+ const omitProp = (prop: ESTree.ObjectPropertyKind, i: number) => {
+ const nextProperty = meta.properties[i + 1]
+ if (nextProperty) {
+ m.overwrite(prop.start - meta.start, nextProperty.start - meta.start, '')
+ } else if (code[prop.end] === ',') {
+ m.overwrite(prop.start - meta.start, prop.end - meta.start + 1, '')
+ } else {
+ m.overwrite(prop.start - meta.start, prop.end - meta.start, '')
+ }
+ }
+
+ for (let i = 0; i < meta.properties.length; i++) {
+ const prop = meta.properties[i]!
+ if (prop.type !== 'Property' || prop.key.type !== 'Identifier') {
+ continue
+ }
+
+ if (options.extractedKeys?.includes(prop.key.name)) {
+ const { serializable } = isSerializable(metaCode, prop.value)
+ if (serializable) {
+ omitProp(prop, i)
+ }
+ } else if (prop.key.name === 'layout' && prop.value.type === 'ObjectExpression') {
+ for (const layoutProp of prop.value.properties) {
+ if (layoutProp.type !== 'Property' || layoutProp.key.type !== 'Identifier') {
+ continue
+ }
+ if (layoutProp.key.name === 'name') {
+ m.appendLeft(
+ prop.start - meta.start,
+ `layout: ${code.slice(layoutProp.value.start, layoutProp.value.end)},\n`,
+ )
+ } else if (layoutProp.key.name === 'props') {
+ m.appendLeft(
+ prop.start - meta.start,
+ `layoutProps: ${code.slice(layoutProp.value.start, layoutProp.value.end)},\n`,
+ )
+ }
+ }
+ omitProp(prop, i)
+ }
+ }
+ }
+
+ const definePageMetaScope = scopeTracker.getCurrentScope()
+
+ walk(meta, {
+ scopeTracker,
+ enter (node, parent) {
+ if (
+ isBindingIdentifier(node, parent)
+ || node.type !== 'Identifier' // checking for `node.type` to narrow down the type
+ ) { return }
+
+ const declaration = scopeTracker.getDeclaration(node.name)
+ if (declaration) {
+ // check if the declaration was made inside `definePageMeta` and if so, do not process it
+ // (ensures that we don't hoist local variables in inline middleware, for example)
+ if (
+ declaration.isUnderScope(definePageMetaScope)
+ // ensures that we compare the correct declaration to the reference
+ // (when in the same scope, the declaration must come before the reference, otherwise it must be in a parent scope)
+ && (scopeTracker.isCurrentScopeUnder(declaration.scope) || resolveStart(declaration) < node.start)
+ ) {
+ return
+ }
+ }
+
+ if (isStaticIdentifier(node.name)) {
+ addImport(node.name)
+ } else if (declaration) {
+ processDeclaration(declaration)
+ }
+ },
+ })
+
+ const importStatements = Array.from(addedImports).join('\n')
+
+ const declarations = declarationNodes
+ .sort((a, b) => resolveStart(a) - resolveStart(b))
+ .map(node => code.slice(resolveStart(node), resolveEnd(node)))
+ .join('\n')
+
+ const extracted = [
+ importStatements,
+ declarations,
+ `const __nuxt_page_meta = ${m.toString() || 'null'}\nexport default __nuxt_page_meta` + (options.dev ? CODE_HMR : ''),
+ ].join('\n')
+
+ s.overwrite(0, code.length, extracted.trim())
+ },
+ })
+
+ if (instances > 1) {
+ throw new Error('Multiple `definePageMeta` calls are not supported. File: ' + id.replace(/\?.+$/, ''))
+ }
+
+ if (!s.hasChanged() && !code.includes('__nuxt_page_meta')) {
+ s.overwrite(0, code.length, options.dev ? (CODE_DEV_EMPTY + CODE_HMR) : CODE_EMPTY)
+ }
+
+ return result()
+ },
+ },
+ vite: {
+ handleHotUpdate: {
+ order: 'post',
+ handler: ({ file, modules, server }) => {
+ if (options.routesPath && options.isPage?.(file)) {
+ const macroModule = server.moduleGraph.getModuleById(file + '?macro=true')
+ const routesModule = server.moduleGraph.getModuleById('virtual:nuxt:' + encodeURIComponent(options.routesPath))
+ return [
+ ...modules,
+ ...macroModule ? [macroModule] : [],
+ ...routesModule ? [routesModule] : [],
+ ]
+ }
+ },
+ },
+ },
+ }
+})
+
+// https://github.com/vuejs/vue-loader/pull/1911
+// https://github.com/vitejs/vite-plugin-vue/issues/23
+const QUERY_START_RE = /^\?/
+const MACRO_RE = /¯o=true/
+function rewriteQuery (id: string) {
+ return id.replace(/\?.+$/, r => '?macro=true&' + r.replace(QUERY_START_RE, '').replace(MACRO_RE, ''))
+}
+
+const MACRO_QUERY_RE = /[?&]macro=true(?:&|$)/
+const TYPE_PARAM_RE = /[?&]type=([^?&]+)/
+const LANG_PARAM_RE = /[?&]lang=([^?&]+)/
+function parseMacroQuery (id: string) {
+ const { search } = parseModuleId(id)
+ const query: { macro?: string, type?: string, lang?: ParserOptions['lang'] } = {
+ type: TYPE_PARAM_RE.exec(search)?.[1],
+ lang: LANG_PARAM_RE.exec(search)?.[1] as ParserOptions['lang'] ?? undefined,
+ }
+ if (MACRO_QUERY_RE.test(search)) {
+ query.macro = 'true'
+ }
+ return query
+}
+
+const QUOTED_SPECIFIER_RE = /(["']).*\1/
+function getQuotedSpecifier (id: string) {
+ return id.match(QUOTED_SPECIFIER_RE)?.[0]
+}
+
+function resolveStart (node: ScopeTrackerNode) {
+ return 'fnNode' in node ? node.fnNode.start : node.start
+}
+function resolveEnd (node: ScopeTrackerNode) {
+ return 'fnNode' in node ? node.fnNode.end : node.end
+}
diff --git a/packages/nuxt/src/pages/plugins/route-injection.ts b/packages/nuxt/src/pages/plugins/route-injection.ts
new file mode 100644
index 000000000000..9eb457b4681b
--- /dev/null
+++ b/packages/nuxt/src/pages/plugins/route-injection.ts
@@ -0,0 +1,52 @@
+import { createUnplugin } from 'unplugin'
+import { generateTransform, rolldownString } from 'rolldown-string'
+import type { Nuxt } from '@nuxt/schema'
+import { parseAndWalk } from 'oxc-walker'
+import { isVue } from '../../core/utils/index.ts'
+
+const INJECTION_SINGLE_RE = /\bthis\.\$route\b|\b_ctx\.\$route\b/
+
+export const RouteInjectionPlugin = (_nuxt: Nuxt) => createUnplugin(() => {
+ return {
+ name: 'nuxt:route-injection-plugin',
+ enforce: 'post',
+ transformInclude (id) {
+ return isVue(id, { type: ['template', 'script'] })
+ },
+ transform: {
+ filter: {
+ code: {
+ include: INJECTION_SINGLE_RE,
+ exclude: [
+ `_ctx._.provides[__nuxt_route_symbol`,
+ 'this._.provides[__nuxt_route_symbol',
+ ],
+ },
+ },
+ handler (code, id, meta?: unknown) {
+ const s = rolldownString(code, id, meta)
+
+ parseAndWalk(code, id, (node) => {
+ if (node.type !== 'MemberExpression') { return }
+
+ // Check for this.$route pattern
+ if (node.object.type === 'ThisExpression' && node.property.type === 'Identifier' && node.property.name === '$route') {
+ s.overwrite(node.start, node.end, '(this._.provides[__nuxt_route_symbol] || this.$route)')
+ return
+ }
+
+ // Check for _ctx.$route pattern
+ if (node.object.type === 'Identifier' && node.object.name === '_ctx' && node.property.type === 'Identifier' && node.property.name === '$route') {
+ s.overwrite(node.start, node.end, '(_ctx._.provides[__nuxt_route_symbol] || _ctx.$route)')
+ }
+ })
+
+ if (s.hasChanged()) {
+ s.prepend('import { PageRouteSymbol as __nuxt_route_symbol } from \'#app/components/injections\';\n')
+ }
+ return generateTransform(s, id)
+ },
+ },
+
+ }
+})
diff --git a/packages/nuxt/src/pages/route-rules.ts b/packages/nuxt/src/pages/route-rules.ts
new file mode 100644
index 000000000000..c422208a431e
--- /dev/null
+++ b/packages/nuxt/src/pages/route-rules.ts
@@ -0,0 +1,32 @@
+import type { NuxtPage } from '@nuxt/schema'
+import type { NitroRouteConfig } from 'nitro/types'
+
+import { pathToNitroGlob } from './utils.ts'
+
+export function globRouteRulesFromPages (pages: NuxtPage[], paths = {} as { [glob: string]: NitroRouteConfig }, prefix = '') {
+ for (const page of pages) {
+ if (page.rules) {
+ if (Object.keys(page.rules).length) {
+ const glob = pathToNitroGlob(prefix + page.path)
+ if (glob) {
+ paths[glob] = page.rules
+ }
+ }
+ // remove rules to prevent exposing in build
+ delete page.rules
+ }
+ if (page.children?.length) {
+ globRouteRulesFromPages(page.children, paths, prefix + page.path + '/')
+ }
+ }
+ return paths
+}
+
+export function removePagesRules (routes: NuxtPage[]) {
+ for (const route of routes) {
+ delete route.rules
+ if (route.children?.length) {
+ removePagesRules(route.children)
+ }
+ }
+}
diff --git a/packages/nuxt/src/pages/runtime/app.vue b/packages/nuxt/src/pages/runtime/app.vue
new file mode 100644
index 000000000000..d9b51aeb757c
--- /dev/null
+++ b/packages/nuxt/src/pages/runtime/app.vue
@@ -0,0 +1,6 @@
+<template>
+ <NuxtLayout>
+ <NuxtRouteAnnouncer />
+ <NuxtPage />
+ </NuxtLayout>
+</template>
diff --git a/packages/nuxt/src/pages/runtime/component-stub.ts b/packages/nuxt/src/pages/runtime/component-stub.ts
new file mode 100644
index 000000000000..b1c6ea436a54
--- /dev/null
+++ b/packages/nuxt/src/pages/runtime/component-stub.ts
@@ -0,0 +1 @@
+export default {}
diff --git a/packages/nuxt/src/pages/runtime/composables.ts b/packages/nuxt/src/pages/runtime/composables.ts
new file mode 100644
index 000000000000..2bac292cdfc2
--- /dev/null
+++ b/packages/nuxt/src/pages/runtime/composables.ts
@@ -0,0 +1,105 @@
+import type { KeepAliveProps, TransitionProps, UnwrapRef } from 'vue'
+import { getCurrentInstance } from 'vue'
+import type { RouteLocationNormalized, RouteLocationNormalizedLoaded, RouteRecordRaw, RouteRecordRedirectOption } from 'vue-router'
+import { useRoute } from 'vue-router'
+import type { NitroRouteConfig } from 'nitro/types'
+import type { NuxtError } from 'nuxt/app'
+import { useNuxtApp } from '#app/nuxt'
+import type { SerializableValue } from './utils'
+
+// Generated at runtime to be extended
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type
+export interface NuxtLayouts {
+
+}
+
+export interface PageMeta {
+ [key: string]: unknown
+ /**
+ * Validate whether a given route can validly be rendered with this page.
+ *
+ * Return true if it is valid, or false if not. If another match can't be found,
+ * this will mean a 404. You can also directly return an object with
+ * status/statusText to respond immediately with an error (other matches
+ * will not be checked).
+ */
+ validate?: (route: RouteLocationNormalized) => boolean | Partial<NuxtError> | Promise<boolean | Partial<NuxtError>>
+ /**
+ * Where to redirect if the route is directly matched. The redirection happens
+ * before any navigation guard and triggers a new navigation with the new
+ * target location.
+ */
+ redirect?: RouteRecordRedirectOption
+ /**
+ * Aliases for the record. Allows defining extra paths that will behave like a
+ * copy of the record. Allows having paths shorthands like `/users/:id` and
+ * `/u/:id`. All `alias` and `path` values must share the same params.
+ */
+ alias?: string | string[]
+ pageTransition?: boolean | TransitionProps
+ layoutTransition?: boolean | TransitionProps
+ key?: false | string | ((route: RouteLocationNormalizedLoaded) => string)
+ keepalive?: boolean | KeepAliveProps
+ /** You may define a name for this page's route. */
+ name?: string
+ /** You may define a path matcher, if you have a more complex pattern than can be expressed with the file name. */
+ path?: string
+ /** Route groups based on the file path, like `/(protected)/users/profile` -> ['protected'] */
+ groups?: string[]
+ /**
+ * Allows accessing the route `params` as props passed to the page component.
+ * @see https://router.vuejs.org/guide/essentials/passing-props
+ */
+ props?: RouteRecordRaw['props']
+ /** Set to `false` to avoid scrolling to top on page navigations */
+ scrollToTop?: boolean | ((to: RouteLocationNormalizedLoaded, from: RouteLocationNormalizedLoaded) => boolean)
+}
+
+declare module 'vue-router' {
+
+ interface RouteMeta extends UnwrapRef<PageMeta> {
+ /**
+ * @internal
+ */
+ layoutProps?: Record<string, SerializableValue>
+ }
+}
+
+const warnRuntimeUsage = (method: string) => {
+ console.warn(
+ `${method}() is a compiler-hint helper that is only usable inside ` +
+ 'the script block of a single file component which is also a page. Its arguments should be ' +
+ 'compiled away and passing it at runtime has no effect.',
+ )
+}
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export const definePageMeta = (meta: PageMeta): void => {
+ if (import.meta.dev) {
+ const component = getCurrentInstance()?.type
+ try {
+ const isRouteComponent = component && useRoute().matched.some(p => Object.values(p.components || {}).includes(component))
+ const isRenderingServerPage = import.meta.server && useNuxtApp().ssrContext?.islandContext
+ if (isRouteComponent || isRenderingServerPage || ((component as any)?.__clientOnlyPage)) {
+ // don't warn if it's being used in a route component (or server page)
+ return
+ }
+ } catch {
+ // ignore any errors with accessing current instance or route
+ }
+ warnRuntimeUsage('definePageMeta')
+ }
+}
+
+/**
+ * You can define route rules for the current page. Matching route rules will be created, based on the page's _path_.
+ *
+ * For example, a rule defined in `~/pages/foo/bar.vue` will be applied to `/foo/bar` requests. A rule in
+ * `~/pages/foo/[id].vue` will be applied to `/foo/**` requests.
+ *
+ * For more control, such as if you are using a custom `path` or `alias` set in the page's `definePageMeta`, you
+ * should set `routeRules` directly within your `nuxt.config`.
+ */
+/* @__NO_SIDE_EFFECTS__ */
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export const defineRouteRules = (rules: NitroRouteConfig): void => {}
diff --git a/packages/nuxt/src/pages/runtime/index.ts b/packages/nuxt/src/pages/runtime/index.ts
new file mode 100644
index 000000000000..9521da2b4fa7
--- /dev/null
+++ b/packages/nuxt/src/pages/runtime/index.ts
@@ -0,0 +1,3 @@
+export { definePageMeta, defineRouteRules } from './composables'
+export type { PageMeta, NuxtLayouts } from './composables'
+export type { NuxtPageProps } from './page'
diff --git a/packages/nuxt/src/pages/runtime/page-placeholder.ts b/packages/nuxt/src/pages/runtime/page-placeholder.ts
new file mode 100644
index 000000000000..7b371ad8ac21
--- /dev/null
+++ b/packages/nuxt/src/pages/runtime/page-placeholder.ts
@@ -0,0 +1,20 @@
+import { defineComponent } from 'vue'
+import type { DefineSetupFnComponent, SlotsType, VNode } from 'vue'
+// @ts-expect-error virtual file
+import { devPagesDir } from '#build/nuxt.config.mjs'
+
+type PagePlaceholderSlots = SlotsType<{
+ default?: () => VNode[]
+}>
+
+const PagePlaceholder = defineComponent({
+ name: 'NuxtPage',
+ setup (_, props) {
+ if (import.meta.dev) {
+ console.warn(`Create a Vue component in the \`${devPagesDir}/\` directory to enable \`<NuxtPage>\``)
+ }
+ return () => props.slots.default?.()
+ },
+}) as unknown as DefineSetupFnComponent<{}, {}, PagePlaceholderSlots>
+
+export default PagePlaceholder
diff --git a/packages/nuxt/src/pages/runtime/page.ts b/packages/nuxt/src/pages/runtime/page.ts
new file mode 100644
index 000000000000..eb4f54ee16ed
--- /dev/null
+++ b/packages/nuxt/src/pages/runtime/page.ts
@@ -0,0 +1,297 @@
+import { Fragment, Suspense, defineComponent, h, inject, nextTick, onBeforeUnmount, ref, watch } from 'vue'
+import type { AllowedComponentProps, Component, ComponentCustomProps, ComponentPublicInstance, KeepAliveProps, Slot, TransitionProps, VNode, VNodeProps } from 'vue'
+import { RouterView } from 'vue-router'
+import type { RouteLocationNormalized, RouteLocationNormalizedLoaded, RouterViewProps } from 'vue-router'
+
+import { generateRouteKey, wrapInKeepAlive } from './utils'
+import type { RouterViewSlotProps } from './utils'
+import { RouteProvider, defineRouteProvider } from '#app/components/route-provider'
+import { useNuxtApp } from '#app/nuxt'
+import { useRouter } from '#app/composables/router'
+import { _mergeTransitionProps, _wrapInTransition } from '#app/components/utils'
+import { LayoutMetaSymbol, PageRouteSymbol } from '#app/components/injections'
+// @ts-expect-error virtual file
+import { appKeepalive as defaultKeepaliveConfig, appPageTransition as defaultPageTransition } from '#build/nuxt.config.mjs'
+
+export interface NuxtPageProps extends RouterViewProps {
+ /**
+ * Define global transitions for all pages rendered with the `NuxtPage` component.
+ */
+ transition?: boolean | TransitionProps
+
+ /**
+ * Control state preservation of pages rendered with the `NuxtPage` component.
+ */
+ keepalive?: boolean | KeepAliveProps
+
+ /**
+ * Control when the `NuxtPage` component is re-rendered.
+ */
+ pageKey?: string | ((route: RouteLocationNormalizedLoaded) => string)
+}
+
+const _routeProviders = import.meta.dev ? new Map<string, ReturnType<typeof defineRouteProvider> | undefined>() : new WeakMap<Component, ReturnType<typeof defineRouteProvider> | undefined>()
+
+export default defineComponent({
+ name: 'NuxtPage',
+ inheritAttrs: false,
+ props: {
+ name: {
+ type: String,
+ },
+ transition: {
+ type: [Boolean, Object] as any as () => boolean | TransitionProps,
+ default: undefined,
+ },
+ keepalive: {
+ type: [Boolean, Object] as any as () => boolean | KeepAliveProps,
+ default: undefined,
+ },
+ route: {
+ type: Object as () => RouteLocationNormalized,
+ },
+ pageKey: {
+ type: [Function, String] as unknown as () => string | ((route: RouteLocationNormalizedLoaded) => string),
+ default: null,
+ },
+ },
+ setup (props, { attrs, slots, expose }) {
+ const nuxtApp = useNuxtApp()
+ const pageRef = ref()
+ const forkRoute = inject(PageRouteSymbol, null)
+ let previousPageKey: string | undefined | false
+
+ expose({ pageRef })
+
+ const _layoutMeta = inject(LayoutMetaSymbol, null)
+ let vnode: VNode | undefined
+
+ const done = nuxtApp.deferHydration()
+ let isSuspensePending = false
+ let hasResolvedOnce = false
+ let suspenseKey = 0
+ if (import.meta.client && nuxtApp.isHydrating) {
+ const removeErrorHook = nuxtApp.hooks.hookOnce('app:error', done)
+ const removeGuard = useRouter().beforeEach(() => {
+ removeErrorHook()
+ removeGuard()
+ })
+ }
+ if (import.meta.client && props.pageKey) {
+ watch(() => props.pageKey, (next, prev) => {
+ if (next !== prev) {
+ nuxtApp.callHook('page:loading:start')
+ }
+ })
+ }
+
+ if (import.meta.dev) {
+ nuxtApp._isNuxtPageUsed = true
+ }
+
+ let pageLoadingEndHookAlreadyCalled = false
+ if (import.meta.client) {
+ const unsub = useRouter().beforeResolve(() => {
+ pageLoadingEndHookAlreadyCalled = false
+ })
+ onBeforeUnmount(() => {
+ unsub()
+ // Ensure hydration completes if unmounted before Suspense resolves (e.g., layout change)
+ done()
+ })
+ }
+
+ return () => {
+ return h(RouterView, { name: props.name, route: props.route, ...attrs }, {
+ default: import.meta.server
+ ? (routeProps: RouterViewSlotProps) => {
+ return h(Suspense, { suspensible: true }, {
+ default () {
+ return h(RouteProvider, {
+ vnode: slots.default ? normalizeSlot(slots.default, routeProps) : routeProps.Component,
+ route: routeProps.route,
+ vnodeRef: pageRef,
+ })
+ },
+ })
+ }
+ : (routeProps: RouterViewSlotProps) => {
+ const isRenderingNewRouteInOldFork = haveParentRoutesRendered(forkRoute, routeProps.route, routeProps.Component)
+ const hasSameChildren = forkRoute && forkRoute.matched.length === routeProps.route.matched.length
+
+ if (!routeProps.Component) {
+ // If we're rendering a `<NuxtPage>` child route on navigation to a route which lacks a child page
+ // we'll render the old vnode until the new route finishes resolving
+ if (vnode && !hasSameChildren && !isStaleVNode(vnode)) {
+ return vnode
+ }
+ done()
+ return
+ }
+
+ // Return old vnode if we are rendering _new_ page suspense fork in _old_ layout suspense fork
+ if (vnode && _layoutMeta && !isStaleVNode(vnode) && !_layoutMeta.isCurrent(routeProps.route)) {
+ return vnode
+ }
+
+ if (isRenderingNewRouteInOldFork && forkRoute && (!_layoutMeta || _layoutMeta?.isCurrent(forkRoute))) {
+ // if leaving a route with an existing child route, render the old vnode
+ if ((hasSameChildren || vnode) && !isStaleVNode(vnode)) {
+ return vnode
+ }
+ // If _leaving_ null child route, return null vnode
+ return null
+ }
+
+ const key = generateRouteKey(routeProps, props.pageKey)
+
+ const willRenderAnotherChild = hasChildrenRoutes(forkRoute, routeProps.route, routeProps.Component)
+ if (!nuxtApp.isHydrating && previousPageKey === key && !willRenderAnotherChild) {
+ nextTick(() => {
+ if (!pageLoadingEndHookAlreadyCalled) {
+ pageLoadingEndHookAlreadyCalled = true
+ nuxtApp.callHook('page:loading:end')
+ }
+ })
+ }
+
+ // remount suspense on rapid navigation, but not before the first resolve:
+ // tearing down a never-resolved suspensible Suspense strands its parent. See #28425, #34683.
+ if (isSuspensePending && previousPageKey !== key && hasResolvedOnce) {
+ suspenseKey++
+ }
+
+ previousPageKey = key
+
+ const hasTransition = !!(props.transition ?? routeProps.route.meta.pageTransition ?? defaultPageTransition)
+ const transitionProps = hasTransition && _mergeTransitionProps([
+ props.transition,
+ routeProps.route.meta.pageTransition,
+ defaultPageTransition,
+ {
+ onAfterLeave () {
+ nuxtApp['~transitionFinish']?.()
+ delete nuxtApp['~transitionFinish']
+ delete nuxtApp['~transitionPromise']
+ nuxtApp.callHook('page:transition:finish', routeProps.Component)
+ },
+ },
+ ])
+
+ const keepaliveConfig = props.keepalive ?? routeProps.route.meta.keepalive ?? (defaultKeepaliveConfig as KeepAliveProps)
+ vnode = _wrapInTransition(hasTransition && transitionProps,
+ wrapInKeepAlive(keepaliveConfig, h(Suspense, {
+ key: suspenseKey,
+ suspensible: true,
+ onPending: () => {
+ isSuspensePending = true
+ if (hasTransition && !nuxtApp['~transitionPromise']) {
+ nuxtApp['~transitionPromise'] = new Promise((resolve) => {
+ nuxtApp['~transitionFinish'] = resolve
+ })
+ }
+ nuxtApp.callHook('page:start', routeProps.Component)
+ },
+ onResolve: async () => {
+ isSuspensePending = false
+ hasResolvedOnce = true
+ try {
+ await nextTick()
+ nuxtApp._route.sync?.()
+ await nuxtApp.callHook('page:finish', routeProps.Component)
+ if (!pageLoadingEndHookAlreadyCalled && !willRenderAnotherChild) {
+ pageLoadingEndHookAlreadyCalled = true
+ await nuxtApp.callHook('page:loading:end')
+ }
+ } finally {
+ done()
+ }
+ },
+ }, {
+ default: () => {
+ const routeProviderProps = {
+ key: key || undefined,
+ vnode: slots.default ? normalizeSlot(slots.default, routeProps) : routeProps.Component,
+ route: routeProps.route,
+ renderKey: key || undefined,
+ trackRootNodes: hasTransition,
+ vnodeRef: pageRef,
+ }
+
+ if (!keepaliveConfig) {
+ return h(RouteProvider, routeProviderProps)
+ }
+
+ const routerComponentType = routeProps.Component.type as any
+ const routeProviderKey = import.meta.dev ? routerComponentType.name || routerComponentType.__name : routerComponentType
+ let PageRouteProvider = _routeProviders.get(routeProviderKey)
+
+ if (!PageRouteProvider) {
+ PageRouteProvider = defineRouteProvider(routerComponentType.name || routerComponentType.__name)
+ _routeProviders.set(routeProviderKey, PageRouteProvider)
+ }
+
+ return h(PageRouteProvider, routeProviderProps)
+ },
+ }),
+ )).default()
+
+ return vnode
+ },
+ })
+ }
+ },
+}) as unknown as {
+ new(): {
+ $props: AllowedComponentProps &
+ ComponentCustomProps &
+ VNodeProps &
+ NuxtPageProps
+
+ $slots: {
+ default?: (routeProps: RouterViewSlotProps) => VNode[]
+ }
+
+ // expose
+ /**
+ * Reference to the page component instance
+ */
+ pageRef: Element | ComponentPublicInstance | null
+ }
+}
+
+function haveParentRoutesRendered (fork: RouteLocationNormalizedLoaded | null, newRoute: RouteLocationNormalizedLoaded, Component?: VNode) {
+ if (!fork) { return false }
+
+ const index = newRoute.matched.findIndex(m => m.components?.default === Component?.type)
+ if (index === -1) { return false }
+
+ // Parent routes without a component are transparent — Vue Router renders the child directly
+ // at the parent's depth (see #34967), so they don't contribute a "parent render" above us.
+ const newParents = newRoute.matched.slice(0, index).filter(m => m.components?.default)
+ if (!newParents.length) { return false }
+ const forkParents = fork.matched.filter(m => m.components?.default)
+
+ // we only care whether the parent route components have had to rerender
+ return newParents.some((c, i) => c.components?.default !== forkParents[i]?.components?.default) ||
+ (Component && generateRouteKey({ route: newRoute, Component }) !== generateRouteKey({ route: fork, Component }))
+}
+
+function hasChildrenRoutes (fork: RouteLocationNormalizedLoaded | null, newRoute: RouteLocationNormalizedLoaded, Component?: VNode) {
+ if (!fork) { return false }
+
+ const index = newRoute.matched.findIndex(m => m.components?.default === Component?.type)
+ return index < newRoute.matched.length - 1
+}
+
+function normalizeSlot (slot: Slot, data: RouterViewSlotProps) {
+ const slotContent = slot(data)
+ return slotContent.length === 1 ? h(slotContent[0]!) : h(Fragment, undefined, slotContent)
+}
+
+// A previously-stored Suspense vnode whose boundary has already been unmounted carries a stale
+// `el` reference; returning it would put Vue on the hydration code path during a fresh mount and
+// throw `Cannot read properties of null (reading 'nodeType' / 'exposed')`. See nuxt/nuxt#23232.
+function isStaleVNode (vnode: VNode | undefined): boolean {
+ return !!vnode && (!!vnode.suspense?.isUnmounted || !!vnode.component?.isUnmounted)
+}
diff --git a/packages/nuxt/src/pages/runtime/plugins/check-if-page-unused.ts b/packages/nuxt/src/pages/runtime/plugins/check-if-page-unused.ts
new file mode 100644
index 000000000000..4b97af12a291
--- /dev/null
+++ b/packages/nuxt/src/pages/runtime/plugins/check-if-page-unused.ts
@@ -0,0 +1,37 @@
+import { nextTick } from 'vue'
+import { defineNuxtPlugin } from '#app/nuxt'
+import type { ObjectPlugin, Plugin } from '#app/nuxt'
+import { onNuxtReady } from '#app/composables/ready'
+import { useError } from '#app/composables/error'
+
+const plugin: Plugin & ObjectPlugin = defineNuxtPlugin({
+ name: 'nuxt:checkIfPageUnused',
+ setup (nuxtApp) {
+ const error = useError()
+
+ function checkIfPageUnused () {
+ if (!error.value && !nuxtApp._isNuxtPageUsed) {
+ console.warn(
+ '[nuxt] Your project has pages but the `<NuxtPage />` component has not been used.' +
+ ' You might be using the `<RouterView />` component instead, which will not work correctly in Nuxt.' +
+ ' You can set `pages: false` in `nuxt.config` if you do not wish to use the Nuxt `vue-router` integration.',
+ )
+ }
+ }
+
+ if (import.meta.server) {
+ nuxtApp.hook('app:rendered', ({ renderResult }) => {
+ if (renderResult?.html) {
+ nextTick(checkIfPageUnused)
+ }
+ })
+ } else {
+ onNuxtReady(checkIfPageUnused)
+ }
+ },
+ env: {
+ islands: false,
+ },
+})
+
+export default plugin
diff --git a/packages/nuxt/src/pages/runtime/plugins/prefetch.client.ts b/packages/nuxt/src/pages/runtime/plugins/prefetch.client.ts
new file mode 100644
index 000000000000..5a326f0d4099
--- /dev/null
+++ b/packages/nuxt/src/pages/runtime/plugins/prefetch.client.ts
@@ -0,0 +1,48 @@
+import { hasProtocol } from 'ufo'
+import { toArray } from '../utils'
+import { defineNuxtPlugin } from '#app/nuxt'
+import type { ObjectPlugin, Plugin } from '#app/nuxt'
+import { useRouter } from '#app/composables/router'
+// @ts-expect-error virtual file
+import layouts from '#build/layouts'
+// @ts-expect-error virtual file
+import { namedMiddleware } from '#build/middleware'
+import { _loadAsyncComponent } from '#app/composables/preload'
+
+const plugin: Plugin & ObjectPlugin = defineNuxtPlugin({
+ name: 'nuxt:prefetch',
+ setup (nuxtApp) {
+ const router = useRouter()
+
+ // Force layout prefetch on route changes
+ nuxtApp.hooks.hook('app:mounted', () => {
+ router.beforeEach(async (to) => {
+ const layout = to?.meta?.layout
+ if (layout && typeof layouts[layout] === 'function') {
+ await layouts[layout]()
+ }
+ })
+ })
+ // Prefetch layouts & middleware
+ nuxtApp.hooks.hook('link:prefetch', (url) => {
+ if (hasProtocol(url)) { return }
+ const route = router.resolve(url)
+ if (!route) { return }
+ const layout = route.meta.layout
+ let middleware = toArray(route.meta.middleware)
+ middleware = middleware.filter(m => typeof m === 'string')
+
+ for (const name of middleware) {
+ if (typeof namedMiddleware[name] === 'function') {
+ namedMiddleware[name]()
+ }
+ }
+
+ if (typeof layout === 'string' && layout in layouts) {
+ _loadAsyncComponent(layouts[layout])
+ }
+ })
+ },
+})
+
+export default plugin
diff --git a/packages/nuxt/src/pages/runtime/plugins/prerender.server.ts b/packages/nuxt/src/pages/runtime/plugins/prerender.server.ts
new file mode 100644
index 000000000000..30fa46c1974e
--- /dev/null
+++ b/packages/nuxt/src/pages/runtime/plugins/prerender.server.ts
@@ -0,0 +1,59 @@
+import type { RouteRecordRaw } from 'vue-router'
+import { joinURL } from 'ufo'
+import type { NitroRouteRules } from 'nitro/types'
+
+import { defineNuxtPlugin } from '#app/nuxt'
+import type { ObjectPlugin, Plugin } from '#app/nuxt'
+import { prerenderRoutes } from '#app/composables/ssr'
+import _routes from '#build/routes'
+import routerOptions, { hashMode } from '#build/router.options.mjs'
+// @ts-expect-error virtual file
+import { crawlLinks } from '#build/nuxt.config.mjs'
+// @ts-expect-error virtual file
+import _routeRulesMatcher from '#build/route-rules.mjs'
+
+const routeRulesMatcher = _routeRulesMatcher as (path: string) => NitroRouteRules
+
+let routes: string[]
+
+const plugin: Plugin & ObjectPlugin = defineNuxtPlugin(async () => {
+ if (!import.meta.server || !import.meta.prerender || hashMode) {
+ return
+ }
+ if (routes && !routes.length) { return }
+
+ routes ||= Array.from(processRoutes(await routerOptions.routes?.(_routes) ?? _routes))
+ const batch = routes.splice(0, 10)
+ prerenderRoutes(batch)
+})
+
+export default plugin
+
+// Implementation
+
+const OPTIONAL_PARAM_RE = /^\/?:.*(?:\?|\(\.\*\)\*)$/
+
+function shouldPrerender (path: string) {
+ return crawlLinks || !!routeRulesMatcher(path).prerender
+}
+
+function processRoutes (routes: readonly RouteRecordRaw[], currentPath = '/', routesToPrerender = new Set<string>()) {
+ for (const route of routes) {
+ // Add root of optional dynamic paths and catchalls
+ if (OPTIONAL_PARAM_RE.test(route.path) && !route.children?.length && shouldPrerender(currentPath)) {
+ routesToPrerender.add(currentPath)
+ }
+ // Skip dynamic paths
+ if (route.path.includes(':')) {
+ continue
+ }
+ const fullPath = joinURL(currentPath, route.path)
+ if (shouldPrerender(fullPath)) {
+ routesToPrerender.add(fullPath)
+ }
+ if (route.children) {
+ processRoutes(route.children, fullPath, routesToPrerender)
+ }
+ }
+ return routesToPrerender
+}
diff --git a/packages/nuxt/src/pages/runtime/plugins/router.ts b/packages/nuxt/src/pages/runtime/plugins/router.ts
new file mode 100644
index 000000000000..cf1f5a6c1d66
--- /dev/null
+++ b/packages/nuxt/src/pages/runtime/plugins/router.ts
@@ -0,0 +1,349 @@
+import { isReadonly, reactive, shallowReactive, shallowRef } from 'vue'
+import type { Ref } from 'vue'
+import type { RouteLocationNormalizedLoadedGeneric, Router, RouterScrollBehavior } from 'vue-router'
+import { START_LOCATION, createMemoryHistory, createRouter, createWebHashHistory, createWebHistory } from 'vue-router'
+import { isSamePath, withoutBase } from 'ufo'
+
+import type { NuxtApp, Plugin, RouteMiddleware } from 'nuxt/app'
+import type { PageMeta } from '../composables'
+
+import { toArray } from '../utils'
+
+import { getRouteRules } from '#app/composables/manifest'
+import { defineNuxtPlugin, useRuntimeConfig } from '#app/nuxt'
+import { clearError, createError, isNuxtError, showError, useError } from '#app/composables/error'
+import { navigateTo } from '#app/composables/router'
+
+import _routes, { handleHotUpdate } from '#build/routes'
+import routerOptions, { hashMode } from '#build/router.options.mjs'
+// @ts-expect-error virtual file
+import { globalMiddleware, namedMiddleware } from '#build/middleware'
+// @ts-expect-error virtual file
+import { pageIslandRoutes } from '#build/components.islands.mjs'
+
+// https://github.com/vuejs/router/blob/4a0cc8b9c1e642cdf47cc007fa5bbebde70afc66/packages/router/src/history/html5.ts#L37
+function createCurrentLocation (
+ base: string,
+ location: Location,
+ renderedPath?: string,
+): string {
+ const { pathname, search, hash } = location
+ // allows hash bases like #, /#, #/, #!, #!/, /#!/, or even /folder#end
+ const hashPos = base.indexOf('#')
+ if (hashPos > -1) {
+ const slicePos = hash.includes(base.slice(hashPos))
+ ? base.slice(hashPos).length
+ : 1
+ let pathFromHash = hash.slice(slicePos)
+ // prepend the starting slash to hash so the url starts with /#
+ if (pathFromHash[0] !== '/') { pathFromHash = '/' + pathFromHash }
+ return withoutBase(pathFromHash, '')
+ }
+ const displayedPath = withoutBase(pathname, base)
+ const path = !renderedPath || isSamePath(displayedPath, renderedPath) ? displayedPath : renderedPath
+ return path + (path.includes('?') ? '' : search) + hash
+}
+
+const plugin: Plugin<{ router: Router }> = defineNuxtPlugin({
+ name: 'nuxt:router',
+ enforce: 'pre',
+ async setup (nuxtApp) {
+ let routerBase = useRuntimeConfig().app.baseURL
+ if (hashMode && !routerBase.includes('#')) {
+ // allow the user to provide a `#` in the middle: `/base/#/app`
+ routerBase += '#'
+ }
+
+ const history = routerOptions.history?.(routerBase) ?? (import.meta.client
+ ? (hashMode ? createWebHashHistory(routerBase) : createWebHistory(routerBase))
+ : createMemoryHistory(routerBase)
+ )
+
+ const routes = routerOptions.routes ? await routerOptions.routes(_routes) ?? _routes : _routes
+
+ let startPosition: Parameters<RouterScrollBehavior>[2] | null
+
+ const router = createRouter({
+ ...routerOptions,
+ scrollBehavior: (to, from, savedPosition) => {
+ if (from === START_LOCATION) {
+ startPosition = savedPosition
+ return
+ }
+ if (routerOptions.scrollBehavior) {
+ // reset scroll behavior to initial value
+ router.options.scrollBehavior = routerOptions.scrollBehavior
+ if ('scrollRestoration' in window.history) {
+ const unsub = router.beforeEach(() => {
+ unsub()
+ window.history.scrollRestoration = 'manual'
+ })
+ }
+ return routerOptions.scrollBehavior(to, START_LOCATION, startPosition || savedPosition)
+ }
+ },
+ history,
+ routes,
+ })
+
+ if (import.meta.hot) {
+ handleHotUpdate(router, routerOptions.routes ? routerOptions.routes : routes => routes)
+ }
+
+ if (import.meta.client && 'scrollRestoration' in window.history) {
+ window.history.scrollRestoration = 'auto'
+ }
+ nuxtApp.vueApp.use(router)
+
+ const previousRoute = shallowRef(router.currentRoute.value)
+ router.afterEach((_to, from) => {
+ previousRoute.value = from
+ })
+
+ Object.defineProperty(nuxtApp.vueApp.config.globalProperties, 'previousRoute', {
+ get: () => previousRoute.value,
+ })
+
+ const initialURL = import.meta.server
+ ? nuxtApp.ssrContext!.url
+ : createCurrentLocation(routerBase, window.location, nuxtApp.payload.path)
+
+ // Allows suspending the route object until page navigation completes
+ const _route = shallowRef(router.currentRoute.value)
+ const syncCurrentRoute = () => { _route.value = router.currentRoute.value }
+ router.afterEach((to, from) => {
+ // `_route` is usually re-synced by `<NuxtPage>`'s `Suspense.onResolve`. When no Suspense
+ // remounts (leaf component reused, or navigating up the tree) we sync manually.
+ const lastTo = to.matched.at(-1)?.components?.default
+ const lastFrom = from.matched.at(-1)?.components?.default
+ if (lastTo === lastFrom) {
+ syncCurrentRoute()
+ return
+ }
+ if (to.matched.length < from.matched.length && to.matched.every((m, i) => m.components?.default === from.matched[i]?.components?.default)) {
+ syncCurrentRoute()
+ }
+ })
+
+ // https://github.com/vuejs/router/blob/8487c3e18882a0883e464a0f25fb28fa50eeda38/packages/router/src/router.ts#L1283-L1289
+ const route = { sync: syncCurrentRoute } as NuxtApp['_route']
+ for (const key in _route.value) {
+ Object.defineProperty(route, key, {
+ get: () => _route.value[key as keyof RouteLocationNormalizedLoadedGeneric],
+ enumerable: true,
+ })
+ }
+
+ nuxtApp._route = shallowReactive(route)
+
+ nuxtApp._middleware ||= {
+ global: [],
+ named: {},
+ }
+
+ const error = useError()
+ // we only skip redirect handlers for component islands, not page islands
+ const isServerPage = import.meta.server && nuxtApp.ssrContext?.islandContext?.name?.startsWith('page_')
+ if (import.meta.client || !nuxtApp.ssrContext?.islandContext || isServerPage) {
+ router.afterEach(async (to, _from, failure) => {
+ delete nuxtApp._processingMiddleware
+
+ if (import.meta.client && !nuxtApp.isHydrating && error.value) {
+ // Clear any existing errors
+ await nuxtApp.runWithContext(clearError)
+ }
+ if (failure) {
+ await nuxtApp.callHook('page:loading:end')
+ }
+ if (import.meta.server && failure?.type === 4 /* ErrorTypes.NAVIGATION_ABORTED */) {
+ return
+ }
+
+ if (import.meta.server && to.redirectedFrom && to.fullPath !== initialURL) {
+ await nuxtApp.runWithContext(() => navigateTo(to.fullPath || '/'))
+ }
+ })
+ }
+
+ try {
+ if (import.meta.server) {
+ await router.push(initialURL)
+ }
+ await router.isReady()
+ } catch (error: any) {
+ // We'll catch 404s here
+ await nuxtApp.runWithContext(() => showError(error))
+ }
+
+ // #4920, #4982
+ const resolvedInitialRoute = import.meta.client && initialURL !== router.currentRoute.value.fullPath
+ ? router.resolve(initialURL)
+ : router.currentRoute.value
+
+ // Detect if we're hydrating a prerendered page that doesn't match the current URL
+ // (for example, if the browser URL has different query params than the
+ // prerendered payload).
+ const hasDeferredRoute = import.meta.client
+ && nuxtApp.isHydrating
+ && nuxtApp.payload.prerenderedAt
+ && nuxtApp.payload.path
+ && initialURL !== nuxtApp.payload.path
+ && isSamePath(router.currentRoute.value.path, nuxtApp.payload.path)
+
+ syncCurrentRoute()
+
+ if (import.meta.server && nuxtApp.ssrContext?.islandContext && !isServerPage) {
+ // we don't need to handle middleware or redirections for non-page islands
+ return { provide: { router } }
+ }
+
+ const initialLayout = nuxtApp.payload.state._layout
+ router.beforeEach(async (to, from) => {
+ await nuxtApp.callHook('page:loading:start')
+ to.meta = reactive(to.meta)
+ if (nuxtApp.isHydrating && initialLayout && !isReadonly(to.meta.layout)) {
+ to.meta.layout = initialLayout as Exclude<PageMeta['layout'], Ref | false>
+ }
+ nuxtApp._processingMiddleware = true
+
+ if (import.meta.client || !nuxtApp.ssrContext?.islandContext || isServerPage) {
+ type MiddlewareDef = string | RouteMiddleware
+ const middlewareEntries = new Set<MiddlewareDef>([...globalMiddleware, ...nuxtApp._middleware.global])
+ for (const component of to.matched) {
+ const componentMiddleware = component.meta.middleware as MiddlewareDef | MiddlewareDef[]
+ if (!componentMiddleware) { continue }
+ for (const entry of toArray(componentMiddleware)) {
+ middlewareEntries.add(entry)
+ }
+ }
+
+ const routeRules = getRouteRules({ path: to.path })
+
+ if (routeRules.appMiddleware) {
+ for (const key in routeRules.appMiddleware) {
+ if (routeRules.appMiddleware[key]) {
+ middlewareEntries.add(key)
+ } else {
+ middlewareEntries.delete(key)
+ }
+ }
+ }
+
+ for (const entry of middlewareEntries) {
+ const middleware: RouteMiddleware = typeof entry === 'string' ? nuxtApp._middleware.named[entry] || await namedMiddleware[entry]?.().then((r: any) => r.default || r) : entry
+
+ if (!middleware) {
+ if (import.meta.dev) {
+ throw new Error(`Unknown route middleware: '${entry}'. Valid middleware: ${Object.keys(namedMiddleware).map(mw => `'${mw}'`).join(', ')}.`)
+ }
+ throw new Error(`Unknown route middleware: '${entry}'.`)
+ }
+
+ try {
+ if (import.meta.dev) {
+ nuxtApp._processingMiddleware = (middleware as any)._path || (typeof entry === 'string' ? entry : true)
+ }
+ const result = await nuxtApp.runWithContext(() => middleware(to, from))
+ if (import.meta.server || (!nuxtApp.payload.serverRendered && nuxtApp.isHydrating)) {
+ if (result === false || result instanceof Error) {
+ const error = result || createError({
+ status: 404,
+ statusText: `Page Not Found: ${initialURL}`,
+ })
+ await nuxtApp.runWithContext(() => showError(error))
+ return false
+ }
+ }
+
+ if (result === true) { continue }
+ if (result === false) {
+ return result
+ }
+ if (result) {
+ if (isNuxtError(result) && result.fatal) {
+ await nuxtApp.runWithContext(() => showError(result))
+ }
+ return result
+ }
+ } catch (err: any) {
+ const error = createError(err)
+ if (error.fatal) {
+ await nuxtApp.runWithContext(() => showError(error))
+ }
+ return error
+ }
+ }
+ }
+ })
+
+ if (isServerPage) {
+ // validate that a server page is rendering the correct url
+ router.beforeResolve((to) => {
+ const expected = pageIslandRoutes[nuxtApp.ssrContext!.islandContext!.name]
+ const actual = to.matched.find(m => (m.components?.default as any)?.__nuxt_island)
+ ?.components?.default as any
+ if (!expected || expected !== actual?.__nuxt_island) {
+ nuxtApp.ssrContext!['~renderResponse'] = {
+ status: 400,
+ statusText: 'Invalid island request path',
+ }
+ return false
+ }
+ })
+ }
+
+ router.onError(async () => {
+ delete nuxtApp._processingMiddleware
+ await nuxtApp.callHook('page:loading:end')
+ })
+
+ router.afterEach((to) => {
+ if (to.matched.length === 0 && !error.value) {
+ return nuxtApp.runWithContext(() => showError(createError({
+ status: 404,
+ fatal: false,
+ statusText: `Page not found: ${to.fullPath}`,
+ data: {
+ path: to.fullPath,
+ },
+ })))
+ }
+ })
+
+ nuxtApp.hooks.hookOnce('app:created', async () => {
+ try {
+ if ('name' in resolvedInitialRoute) {
+ resolvedInitialRoute.name = undefined
+ }
+
+ if (hasDeferredRoute) {
+ // First apply the route that was prerendered to avoid hydration mismatches,
+ // then replace it after hydration with the actual resolved initial route
+ const payloadRoute = router.resolve(nuxtApp.payload.path!)
+ if ('name' in payloadRoute) {
+ payloadRoute.name = undefined
+ }
+ await router.replace({ ...payloadRoute, force: true })
+
+ nuxtApp.hooks.hookOnce('app:suspense:resolve', async () => {
+ await router.replace({ ...resolvedInitialRoute, force: true })
+ })
+ } else {
+ await router.replace({
+ ...resolvedInitialRoute,
+ force: true,
+ })
+ }
+ // reset scroll behavior to initial value
+ router.options.scrollBehavior = routerOptions.scrollBehavior
+ } catch (error: any) {
+ // We'll catch middleware errors or deliberate exceptions here
+ await nuxtApp.runWithContext(() => showError(error))
+ }
+ })
+
+ return { provide: { router } }
+ },
+})
+
+export default plugin
diff --git a/packages/nuxt/src/pages/runtime/router.options.ts b/packages/nuxt/src/pages/runtime/router.options.ts
new file mode 100644
index 000000000000..c7fb9addca89
--- /dev/null
+++ b/packages/nuxt/src/pages/runtime/router.options.ts
@@ -0,0 +1,91 @@
+import { START_LOCATION } from 'vue-router'
+import type { RouteLocationNormalized, RouterScrollBehavior } from 'vue-router'
+import type { RouterConfig } from 'nuxt/schema'
+import { useNuxtApp } from '#app/nuxt'
+import { isChangingPage } from '#app/components/utils'
+import { useRouter } from '#app/composables/router'
+
+type ScrollPosition = Awaited<ReturnType<RouterScrollBehavior>>
+
+// Default router options
+// https://router.vuejs.org/api/interfaces/routeroptions
+export default <RouterConfig>{
+ scrollBehavior (to, from, savedPosition) {
+ const nuxtApp = useNuxtApp()
+ // @ts-expect-error untyped, nuxt-injected option
+ const hashScrollBehaviour = useRouter().options?.scrollBehaviorType ?? 'auto'
+
+ // Hash routes on the same page, no page hook is fired so resolve here
+ if (to.path.replace(/\/$/, '') === from.path.replace(/\/$/, '')) {
+ if (from.hash && !to.hash) {
+ return { left: 0, top: 0 }
+ }
+ if (to.hash) {
+ return { el: to.hash, top: _getHashElementScrollMarginTop(to.hash), behavior: hashScrollBehaviour }
+ }
+ // The route isn't changing so keep current scroll position
+ return false
+ }
+
+ const routeAllowsScrollToTop = typeof to.meta.scrollToTop === 'function' ? to.meta.scrollToTop(to, from) : to.meta.scrollToTop
+
+ if (routeAllowsScrollToTop === false) { return false }
+
+ if (from === START_LOCATION) {
+ return _calculatePosition(to, from, savedPosition, hashScrollBehaviour)
+ }
+
+ return new Promise((resolve) => {
+ const doScroll = () => {
+ requestAnimationFrame(() => resolve(_calculatePosition(to, from, savedPosition, hashScrollBehaviour)))
+ }
+ nuxtApp.hooks.hookOnce('page:loading:end', () => {
+ const transitionPromise = nuxtApp['~transitionPromise'] as Promise<void> | undefined
+ if (transitionPromise) {
+ transitionPromise.then(doScroll)
+ } else {
+ doScroll()
+ }
+ })
+ })
+ },
+}
+
+function _getHashElementScrollMarginTop (selector: string): number {
+ try {
+ const elem = document.querySelector(selector)
+ if (elem) {
+ return (Number.parseFloat(getComputedStyle(elem).scrollMarginTop) || 0) + (Number.parseFloat(getComputedStyle(document.documentElement).scrollPaddingTop) || 0)
+ }
+ } catch {
+ // ignore any errors parsing scrollMarginTop
+ }
+ return 0
+}
+
+function _calculatePosition (
+ to: RouteLocationNormalized,
+ from: RouteLocationNormalized,
+ savedPosition: ScrollPosition | null,
+ defaultHashScrollBehaviour: ScrollBehavior,
+): ScrollPosition {
+ // By default when the returned position is falsy or an empty object, vue-router will retain the current scroll position
+ // savedPosition is only available for popstate navigations (back button)
+ if (savedPosition) {
+ return savedPosition
+ }
+
+ // Scroll to the element specified in the URL hash, if present
+ if (to.hash) {
+ return {
+ el: to.hash,
+ top: _getHashElementScrollMarginTop(to.hash),
+ behavior: isChangingPage(to, from) ? defaultHashScrollBehaviour : 'instant',
+ }
+ }
+
+ return {
+ left: 0,
+ top: 0,
+ }
+}
diff --git a/packages/nuxt/src/pages/runtime/utils.ts b/packages/nuxt/src/pages/runtime/utils.ts
new file mode 100644
index 000000000000..ce7e7d468e5b
--- /dev/null
+++ b/packages/nuxt/src/pages/runtime/utils.ts
@@ -0,0 +1,49 @@
+import { KeepAlive, h } from 'vue'
+import type { VNode } from 'vue'
+import type { RouteLocationMatched, RouteLocationNormalizedLoaded, RouterView } from 'vue-router'
+
+type InstanceOf<T> = T extends new (...args: any[]) => infer R ? R : never
+type RouterViewSlot = Exclude<InstanceOf<typeof RouterView>['$slots']['default'], undefined>
+export type RouterViewSlotProps = Parameters<RouterViewSlot>[0]
+
+type SerializablePrimitive = string | number | boolean | null | undefined
+
+export type MaybeArray<T> = T | T[]
+
+/** JSON-serializable value (non-recursive definition to avoid excessive type depth) */
+export type SerializableValue = MaybeArray<SerializablePrimitive | Record<string, SerializablePrimitive>>
+
+/** Constrains T to only contain serializable properties. Non-serializable properties become `never`. */
+// eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+export type MakeSerializableObject<T> = T extends Function | symbol
+ ? never
+ : {
+ [K in keyof T]: T[K] extends SerializableValue
+ ? T[K]
+ : never
+ }
+
+const ROUTE_KEY_PARENTHESES_RE = /(:\w+)\([^)]+\)/g
+const ROUTE_KEY_SYMBOLS_RE = /(:\w+)[?+*]/g
+const ROUTE_KEY_NORMAL_RE = /:\w+/g
+const interpolatePath = (route: RouteLocationNormalizedLoaded, match: RouteLocationMatched) => {
+ return match.path
+ .replace(ROUTE_KEY_PARENTHESES_RE, '$1')
+ .replace(ROUTE_KEY_SYMBOLS_RE, '$1')
+ .replace(ROUTE_KEY_NORMAL_RE, r => route.params[r.slice(1)]?.toString() || '')
+}
+
+export const generateRouteKey = (routeProps: RouterViewSlotProps, override?: string | ((route: RouteLocationNormalizedLoaded) => string)): string | false | undefined => {
+ const matchedRoute = routeProps.route.matched.find(m => m.components?.default === routeProps.Component.type)
+ const source = override ?? matchedRoute?.meta.key ?? (matchedRoute && interpolatePath(routeProps.route, matchedRoute))
+ return typeof source === 'function' ? source(routeProps.route) : source
+}
+
+export const wrapInKeepAlive = (props: any, children: any): { default: () => VNode } => {
+ return { default: () => import.meta.client && props ? h(KeepAlive, props === true ? {} : props, children) : children }
+}
+
+/** @since 3.9.0 */
+export function toArray<T> (value: T | T[]): T[] {
+ return Array.isArray(value) ? value : [value]
+}
diff --git a/packages/nuxt/src/pages/runtime/validate.ts b/packages/nuxt/src/pages/runtime/validate.ts
new file mode 100644
index 000000000000..5d6d9bd7e7b9
--- /dev/null
+++ b/packages/nuxt/src/pages/runtime/validate.ts
@@ -0,0 +1,32 @@
+import { createError } from '#app/composables/error'
+import { defineNuxtRouteMiddleware } from '#app/composables/router'
+import type { RouteMiddleware } from '#app/composables/router'
+
+const middleware: RouteMiddleware = defineNuxtRouteMiddleware(async (to, from) => {
+ if (!to.meta?.validate) { return }
+
+ const result = await Promise.resolve(to.meta.validate(to))
+ if (result === true) {
+ return
+ }
+
+ const error = createError({
+ fatal: import.meta.client,
+ status: (result && result.status) || 404,
+ statusText: (result && result.statusText) || `Page Not Found: ${to.fullPath}`,
+ data: {
+ path: to.fullPath,
+ },
+ })
+
+ // We pretend to have navigated to the invalid route so
+ // that the user can return to the previous page with
+ // the back button.
+ if (typeof window !== 'undefined') {
+ window.history.pushState({}, '', from.fullPath)
+ }
+
+ return error
+})
+
+export default middleware
diff --git a/packages/nuxt/src/pages/utils.ts b/packages/nuxt/src/pages/utils.ts
new file mode 100644
index 000000000000..3c8cdf0bd8d5
--- /dev/null
+++ b/packages/nuxt/src/pages/utils.ts
@@ -0,0 +1,607 @@
+import { runInNewContext } from 'node:vm'
+import fs from 'node:fs'
+
+import { normalize, relative } from 'pathe'
+import { joinURL } from 'ufo'
+import { getLayerDirectories, resolveFiles, resolvePath, useNuxt } from '@nuxt/kit'
+import { genArrayFromRaw, genDynamicImport, genImport, genSafeVariableName } from 'knitwork'
+import { filename } from 'pathe/utils'
+import { hash } from 'ohash'
+import { defu } from 'defu'
+import { klona } from 'klona'
+import { parseAndWalk } from 'oxc-walker'
+import { parseSync, transformSync } from 'rolldown/utils'
+import type { ESTree } from 'rolldown/utils'
+import { addFile, buildTree, compileParsePath, removeFile, toVueRouter4 } from 'unrouting'
+import type { BuildTreeOptions, InputFile, RouteTree, VueRouterEmitOptions } from 'unrouting'
+
+import { getLoader } from '../core/utils/index.ts'
+import { logger, toArray } from '../utils.ts'
+import type { NuxtPage } from 'nuxt/schema'
+
+// ---------------------------------------------------------------------------
+// PagesContext — persistent route tree for incremental dev-mode updates
+// ---------------------------------------------------------------------------
+
+export interface PagesContext {
+ /** Emit NuxtPage[] from the current tree state. */
+ emit: () => NuxtPage[]
+ /** Add a file to the tree (incremental). */
+ addFile: (filePath: string, priority?: number) => void
+ /** Remove a file from the tree. Returns `true` if the file was found and removed. */
+ removeFile: (filePath: string) => boolean
+ /** Full rebuild — replace tree contents from a fresh file list. */
+ rebuild: (files: InputFile[]) => void
+ /** Set of absolute file paths currently tracked in the tree. */
+ trackedFiles: Set<string>
+}
+
+export interface PagesContextOptions {
+ roots?: string[]
+ shouldUseServerComponents?: boolean
+}
+
+export function createPagesContext (options: PagesContextOptions = {}): PagesContext {
+ const modes = options.shouldUseServerComponents ? ['server', 'client'] : ['client']
+ const treeOptions: BuildTreeOptions = {
+ roots: options.roots,
+ modes,
+ warn: msg => logger.warn(msg),
+ }
+ const emitOptions: VueRouterEmitOptions = {
+ onDuplicateRouteName: (_name, file, existingFile) => {
+ logger.warn(`Route name generated for \`${file}\` is the same as \`${existingFile}\`. You may wish to set a custom name using \`definePageMeta\` within the page file.`)
+ },
+ attrs: { mode: modes },
+ }
+
+ const compiledParse = compileParsePath(treeOptions)
+
+ let tree: RouteTree = buildTree([], treeOptions)
+ const trackedFiles = new Set<string>()
+
+ return {
+ emit () {
+ return toVueRouter4(tree, emitOptions)
+ },
+ addFile (filePath: string, priority = 0) {
+ addFile(tree, { path: filePath, priority }, compiledParse)
+ trackedFiles.add(filePath)
+ },
+ removeFile (filePath: string) {
+ const removed = removeFile(tree, filePath)
+ if (removed) {
+ trackedFiles.delete(filePath)
+ }
+ return removed
+ },
+ rebuild (files: InputFile[]) {
+ tree = buildTree(files, treeOptions)
+ trackedFiles.clear()
+ for (const f of files) {
+ trackedFiles.add(f.path)
+ }
+ },
+ trackedFiles,
+ }
+}
+
+// ---------------------------------------------------------------------------
+// resolvePagesRoutes — full glob + build (initial load & fallback)
+// ---------------------------------------------------------------------------
+
+export async function resolvePagesRoutes (pattern: string | string[], nuxt = useNuxt(), ctx?: PagesContext): Promise<NuxtPage[]> {
+ const pagesDirs = getLayerDirectories(nuxt).map(d => d.appPages)
+
+ const inputFiles: InputFile[] = []
+ for (let priority = 0; priority < pagesDirs.length; priority++) {
+ const dir = pagesDirs[priority]!
+ const files = await resolveFiles(dir, pattern)
+ for (const file of files) {
+ inputFiles.push({ path: file, priority })
+ }
+ }
+
+ let pages: NuxtPage[]
+ if (ctx) {
+ ctx.rebuild(inputFiles)
+ pages = ctx.emit()
+ } else {
+ // One-shot for production / no-context case
+ const oneShot = createPagesContext({ roots: pagesDirs, shouldUseServerComponents: !!nuxt.options.experimental.componentIslands })
+ oneShot.rebuild(inputFiles)
+ pages = oneShot.emit()
+ }
+
+ return augmentAndResolve(pages, ctx?.trackedFiles ?? new Set(inputFiles.map(f => f.path)), nuxt)
+}
+
+// ---------------------------------------------------------------------------
+// augmentAndResolve — downstream pipeline (augmentation + hooks)
+// ---------------------------------------------------------------------------
+
+export async function augmentAndResolve (pages: NuxtPage[], trackedFiles: Set<string>, nuxt = useNuxt()): Promise<NuxtPage[]> {
+ const shouldAugment = nuxt.options.experimental.scanPageMeta || nuxt.options.experimental.typedPages
+
+ if (shouldAugment === false) {
+ await nuxt.callHook('pages:extend', pages)
+ return pages
+ }
+
+ const extraPageMetaExtractionKeys = nuxt.options?.experimental?.extraPageMetaExtractionKeys || []
+
+ const augmentCtx = {
+ extraExtractionKeys: new Set([
+ 'middleware',
+ ...extraPageMetaExtractionKeys,
+ ]),
+ fullyResolvedPaths: trackedFiles,
+ }
+ if (shouldAugment === 'after-resolve') {
+ await nuxt.callHook('pages:extend', pages)
+ await augmentPages(pages, nuxt.vfs, augmentCtx)
+ } else {
+ const augmentedPages = await augmentPages(pages, nuxt.vfs, augmentCtx)
+ await nuxt.callHook('pages:extend', pages)
+ await augmentPages(pages, nuxt.vfs, { pagesToSkip: augmentedPages, ...augmentCtx })
+ augmentedPages?.clear()
+ }
+
+ await nuxt.callHook('pages:resolved', pages)
+
+ return pages
+}
+
+interface AugmentPagesContext {
+ fullyResolvedPaths?: Set<string>
+ pagesToSkip?: Set<string>
+ augmentedPages?: Set<string>
+ extraExtractionKeys?: Set<string>
+}
+
+export async function augmentPages (routes: NuxtPage[], vfs: Record<string, string>, ctx: AugmentPagesContext = {}) {
+ ctx.augmentedPages ??= new Set()
+ for (const route of routes) {
+ if (route.file && !ctx.pagesToSkip?.has(route.file)) {
+ const fileContent = vfs[route.file] ?? fs.readFileSync(ctx.fullyResolvedPaths?.has(route.file) ? route.file : await resolvePath(route.file), 'utf-8')
+ const routeMeta = getRouteMeta(fileContent, route.file, ctx.extraExtractionKeys)
+ if (route.meta) {
+ routeMeta.meta = defu({}, routeMeta.meta, route.meta)
+ }
+ if (route.rules) {
+ routeMeta.rules = defu({}, routeMeta.rules, route.rules)
+ }
+
+ Object.assign(route, routeMeta)
+ ctx.augmentedPages.add(route.file)
+ }
+
+ if (route.children && route.children.length > 0) {
+ await augmentPages(route.children, vfs, ctx)
+ }
+ }
+ return ctx.augmentedPages
+}
+
+const SFC_SCRIPT_RE = /<script(?=\s|>)(?<attrs>[^>]*)>(?<content>[\s\S]*?)<\/script\s*>/gi
+export function extractScriptContent (sfc: string) {
+ const contents: Array<{ loader: 'tsx' | 'ts', code: string }> = []
+ for (const match of sfc.matchAll(SFC_SCRIPT_RE)) {
+ if (match?.groups?.content) {
+ contents.push({
+ loader: match.groups.attrs && /[tj]sx/.test(match.groups.attrs) ? 'tsx' : 'ts',
+ code: match.groups.content.trim(),
+ })
+ }
+ }
+
+ return contents
+}
+
+const PAGE_EXTRACT_RE = /(definePageMeta|defineRouteRules)\([\s\S]*?\)/g
+export const defaultExtractionKeys = ['name', 'path', 'props', 'alias', 'redirect', 'middleware'] as const
+const DYNAMIC_META_KEY = '__nuxt_dynamic_meta_key' as const
+
+const pageContentsCache: Record<string, string> = {}
+const extractCache: Record<string, Partial<Record<keyof NuxtPage, any>>> = {}
+export function getRouteMeta (contents: string, absolutePath: string, extraExtractionKeys: Set<string> = new Set()): Partial<Record<keyof NuxtPage, any>> {
+ // set/update pageContentsCache, invalidate extractCache on cache mismatch
+ if (!(absolutePath in pageContentsCache) || pageContentsCache[absolutePath] !== contents) {
+ pageContentsCache[absolutePath] = contents
+ delete extractCache[absolutePath]
+ }
+
+ if (absolutePath in extractCache && extractCache[absolutePath]) {
+ return klona(extractCache[absolutePath])
+ }
+
+ const loader = getLoader(absolutePath)
+ const scriptBlocks = !loader ? null : loader === 'vue' ? extractScriptContent(contents) : [{ code: contents, loader }]
+ if (!scriptBlocks) {
+ extractCache[absolutePath] = {}
+ return {}
+ }
+
+ const extractedData: Partial<Record<keyof NuxtPage, any>> = {}
+
+ const extractionKeys = new Set<keyof NuxtPage>([...defaultExtractionKeys, ...extraExtractionKeys as Set<keyof NuxtPage>])
+
+ for (const script of scriptBlocks) {
+ const found: Record<string, boolean> = {}
+ // properties track which macros need to be extracted
+ for (const macro of script.code.matchAll(PAGE_EXTRACT_RE)) {
+ found[macro[1]!] = false
+ }
+
+ if (Object.keys(found).length === 0) {
+ continue
+ }
+
+ const dynamicProperties = new Set<keyof NuxtPage>()
+
+ parseAndWalk(script.code, absolutePath.replace(/\.\w+$/, '.' + script.loader), (node) => {
+ if (node.type !== 'ExpressionStatement' || node.expression.type !== 'CallExpression' || node.expression.callee.type !== 'Identifier') { return }
+
+ // function name is one of the extracted macro functions and not yet found
+ const fnName = node.expression.callee.name
+ if (fnName in found === false || found[fnName] !== false) { return }
+ found[fnName] = true
+
+ let code = script.code
+ let pageExtractArgument = node.expression.arguments[0]
+
+ // TODO: always true because `extractScriptContent` only detects ts/tsx loader
+ if (/tsx?/.test(script.loader)) {
+ // slice, transform and parse the `define...` macro node to avoid parsing the whole file
+ const transformed = transformSync(absolutePath, script.code.slice(node.start, node.end), { lang: script.loader, tsconfig: false })
+ if (transformed.errors.length) {
+ for (const error of transformed.errors) {
+ logger.warn(`Error while transforming \`${fnName}()\`\n` + error.message)
+ }
+ return
+ }
+
+ // we already know that the first statement is a call expression
+ pageExtractArgument = ((parseSync('', transformed.code, { lang: 'js' }).program.body[0]! as ESTree.ExpressionStatement).expression as ESTree.CallExpression).arguments[0]
+ code = transformed.code
+ }
+
+ if (pageExtractArgument?.type !== 'ObjectExpression') {
+ logger.warn(`\`${fnName}\` must be called with an object literal (reading \`${absolutePath}\`), found ${pageExtractArgument?.type} instead.`)
+ return
+ }
+
+ if (fnName === 'defineRouteRules') {
+ const { value, serializable } = isSerializable(code, pageExtractArgument)
+ if (!serializable) {
+ logger.warn(`\`${fnName}\` must be called with a serializable object literal (reading \`${absolutePath}\`).`)
+ return
+ }
+
+ extractedData.rules = value
+ return
+ }
+
+ if (fnName === 'definePageMeta') {
+ for (const key of extractionKeys) {
+ const property = pageExtractArgument.properties.find((property): property is ESTree.ObjectProperty => property.type === 'Property' && property.key.type === 'Identifier' && property.key.name === key)
+ if (!property) { continue }
+
+ const { value, serializable } = isSerializable(code, property.value)
+ if (!serializable) {
+ logger.debug(`Skipping extraction of \`${key}\` metadata as it is not JSON-serializable (reading \`${absolutePath}\`).`)
+ dynamicProperties.add(extraExtractionKeys.has(key) ? 'meta' : key)
+ continue
+ }
+
+ if (extraExtractionKeys.has(key)) {
+ extractedData.meta ??= {}
+ extractedData.meta[key] = value
+ } else {
+ extractedData[key] = value
+ }
+ }
+
+ for (const property of pageExtractArgument.properties) {
+ if (property.type !== 'Property') {
+ continue
+ }
+ const isIdentifierOrLiteral = property.key.type === 'Literal' || property.key.type === 'Identifier'
+ if (!isIdentifierOrLiteral) {
+ continue
+ }
+ const name = property.key.type === 'Identifier' ? property.key.name : String(property.value)
+ if (!extractionKeys.has(name as keyof NuxtPage)) {
+ dynamicProperties.add('meta')
+ break
+ }
+ }
+
+ if (dynamicProperties.size) {
+ extractedData.meta ??= {}
+ extractedData.meta[DYNAMIC_META_KEY] = dynamicProperties
+ }
+ }
+ })
+ }
+
+ extractCache[absolutePath] = extractedData
+ return klona(extractedData)
+}
+
+function serializeRouteValue (value: any, skipSerialisation = false) {
+ if (skipSerialisation || value === undefined) { return undefined }
+ return JSON.stringify(value)
+}
+
+type NormalizedRoute = Partial<Record<Exclude<keyof NuxtPage, 'file'>, string>> & { component?: string }
+type NormalizedRouteKeys = (keyof NormalizedRoute)[]
+interface NormalizeRoutesOptions {
+ overrideMeta?: boolean
+ serverComponentRuntime: string
+ clientComponentRuntime: string
+}
+
+function normalizeComponent (page: NuxtPage, pageImport: string, routeName: string | undefined, islandKey: string | undefined): string {
+ if (page.mode === 'server') {
+ return `() => createIslandPage(${routeName}, import.meta.server ? ${islandKey} : undefined)`
+ }
+ if (page.mode === 'client') {
+ return `() => createClientPage(${pageImport})`
+ }
+ return pageImport
+}
+
+function normalizeComponentWithName (page: NuxtPage, isSyncImport: boolean | undefined, pageImportName: string, pageImport: string, routeName: string | undefined, metaRouteName: string, islandKey: string | undefined): string {
+ if (isSyncImport) {
+ return `Object.assign(${pageImportName}, { __name: ${metaRouteName} })`
+ }
+ // Server components already receive the name via createIslandPage(name)
+ if (page.mode === 'server') {
+ return `() => createIslandPage(${routeName}, import.meta.server ? ${islandKey} : undefined)`
+ }
+ // Client components return a processed component (not a module with .default)
+ if (page.mode === 'client') {
+ return `() => createClientPage(${pageImport}).then((c) => Object.assign(c, { __name: ${metaRouteName} }))`
+ }
+ return `${pageImport}.then((m) => Object.assign(m.default, { __name: ${metaRouteName} }))`
+}
+
+export function normalizeRoutes (routes: NuxtPage[], metaImports: Set<string> = new Set(), options: NormalizeRoutesOptions): { imports: Set<string>, routes: string } {
+ const nuxt = useNuxt()
+ return {
+ imports: metaImports,
+ routes: genArrayFromRaw(routes.map((page) => {
+ const markedDynamic = page.meta?.[DYNAMIC_META_KEY] ?? new Set()
+ const metaFiltered: Record<string, any> = {}
+ let skipMeta = true
+ for (const key in page.meta || {}) {
+ if (key !== DYNAMIC_META_KEY && page.meta![key] !== undefined) {
+ skipMeta = false
+ metaFiltered[key] = page.meta![key]
+ }
+ }
+
+ const skipAlias = toArray(page.alias).every(val => !val)
+
+ const route: NormalizedRoute = {
+ path: serializeRouteValue(page.path),
+ props: serializeRouteValue(page.props),
+ name: serializeRouteValue(page.name),
+ meta: serializeRouteValue(metaFiltered, skipMeta),
+ alias: serializeRouteValue(toArray(page.alias), skipAlias),
+ redirect: serializeRouteValue(page.redirect),
+ }
+
+ for (const key of [...defaultExtractionKeys, 'meta'] satisfies NormalizedRouteKeys) {
+ if (route[key] === undefined) {
+ delete route[key]
+ }
+ }
+
+ if (page.children?.length) {
+ route.children = normalizeRoutes(page.children, metaImports, options).routes
+ }
+
+ // Without a file, we can't use `definePageMeta` to extract route-level meta from the file
+ if (!page.file) {
+ return route
+ }
+
+ const file = normalize(page.file)
+ const pageImportName = genSafeVariableName(filename(file) + hash(file).replace(/-/g, '_'))
+ const metaImportName = pageImportName + 'Meta'
+ metaImports.add(genImport(`${file}?macro=true`, [{ name: 'default', as: metaImportName }]))
+
+ if (page._sync) {
+ metaImports.add(genImport(file, [{ name: 'default', as: pageImportName }]))
+ }
+
+ const isSyncImport = page._sync && page.mode !== 'client'
+ const pageImport = isSyncImport ? pageImportName : genDynamicImport(file)
+ const metaRouteName = `${metaImportName}?.name ?? ${route.name}`
+
+ // we use this to validate that a server page is rendering the correct url
+ const islandKey = page.mode === 'server' && page.file
+ ? JSON.stringify(hash(relative(nuxt.options.rootDir, page.file)))
+ : undefined
+
+ const component = nuxt.options.experimental.normalizePageNames
+ ? normalizeComponentWithName(page, isSyncImport, pageImportName, pageImport, route.name, metaRouteName, islandKey)
+ : normalizeComponent(page, pageImport, route.name, islandKey)
+
+ // Named views from the `name@view.vue` filename convention. The scanner
+ // emits `components: { default: <file>, <view>: <file> }`.
+ // https://router.vuejs.org/guide/essentials/named-views.html
+ let componentsObject: string | undefined
+ if (page.components) {
+ const viewEntries: string[] = []
+ for (const viewName in page.components) {
+ if (viewName === 'default') { continue }
+ const viewFile = normalize(page.components[viewName]!)
+ viewEntries.push(`${JSON.stringify(viewName)}: ${genDynamicImport(viewFile)}`)
+ }
+ if (viewEntries.length > 0) {
+ componentsObject = `{ default: ${component}, ${viewEntries.join(', ')} }`
+ }
+ }
+
+ const metaRoute: NormalizedRoute = {
+ name: metaRouteName,
+ path: `${metaImportName}?.path ?? ${route.path}`,
+ props: `${metaImportName}?.props ?? ${route.props ?? false}`,
+ meta: `${metaImportName} || {}`,
+ alias: `${metaImportName}?.alias || []`,
+ redirect: `${metaImportName}?.redirect`,
+ component,
+ }
+ if (componentsObject) {
+ metaRoute.components = componentsObject
+ }
+
+ if (page.mode === 'server') {
+ metaImports.add(`
+let _createIslandPage
+async function createIslandPage (name, islandKey) {
+ _createIslandPage ||= await import(${JSON.stringify(options?.serverComponentRuntime)}).then(r => r.createIslandPage)
+ return _createIslandPage(name, islandKey)
+};`)
+ } else if (page.mode === 'client') {
+ metaImports.add(`
+let _createClientPage
+async function createClientPage(loader) {
+ _createClientPage ||= await import(${JSON.stringify(options?.clientComponentRuntime)}).then(r => r.createClientPage)
+ return _createClientPage(loader);
+}`)
+ }
+
+ if (route.children) {
+ metaRoute.children = route.children
+ }
+
+ if (route.meta) {
+ metaRoute.meta = `{ ...(${metaImportName} || {}), ...${route.meta} }`
+ }
+
+ if (options?.overrideMeta) {
+ // skip and retain fallback if marked dynamic
+ // set to extracted value or fallback if none extracted
+ for (const key of ['name', 'path'] satisfies NormalizedRouteKeys) {
+ if (markedDynamic.has(key)) { continue }
+ metaRoute[key] = route[key] ?? `${metaImportName}?.${key}`
+ }
+
+ // set to extracted value or delete if none extracted
+ for (const key of ['meta', 'alias', 'redirect', 'props'] satisfies NormalizedRouteKeys) {
+ if (markedDynamic.has(key)) { continue }
+
+ if (route[key] == null) {
+ delete metaRoute[key]
+ continue
+ }
+
+ metaRoute[key] = route[key]
+ }
+ } else {
+ if (route.alias != null) {
+ metaRoute.alias = `${route.alias}.concat(${metaImportName}?.alias || [])`
+ }
+
+ if (route.redirect != null) {
+ metaRoute.redirect = route.redirect
+ }
+ }
+
+ return metaRoute
+ })),
+ }
+}
+
+const PATH_TO_NITRO_GLOB_RE = /\/[^:/]*:\w.*$/
+export function pathToNitroGlob (path: string) {
+ if (!path) {
+ return null
+ }
+ // Ignore pages with multiple dynamic parameters.
+ if (path.indexOf(':') !== path.lastIndexOf(':')) {
+ return null
+ }
+
+ return path.replace(PATH_TO_NITRO_GLOB_RE, '/**')
+}
+
+export function resolveRoutePaths (page: NuxtPage, parent = '/'): string[] {
+ return [
+ joinURL(parent, page.path),
+ ...page.children?.flatMap(child => resolveRoutePaths(child, joinURL(parent, page.path))) || [],
+ ]
+}
+
+export function isSerializable (code: string, node: ESTree.Node): { value?: any, serializable: boolean } {
+ if (node.type === 'ObjectExpression') {
+ const valueString = code.slice(node.start, node.end)
+ try {
+ return {
+ value: JSON.parse(runInNewContext(`JSON.stringify(${valueString})`, {})),
+ serializable: true,
+ }
+ } catch {
+ return {
+ serializable: false,
+ }
+ }
+ }
+
+ if (node.type === 'ArrayExpression') {
+ const values: string[] = []
+ for (const element of node.elements) {
+ if (!element) {
+ continue
+ }
+ const { serializable, value } = isSerializable(code, element)
+ if (!serializable) {
+ return {
+ serializable: false,
+ }
+ }
+ values.push(value)
+ }
+
+ return {
+ value: values,
+ serializable: true,
+ }
+ }
+
+ if (node.type === 'Literal' && (typeof node.value === 'string' || typeof node.value === 'boolean' || typeof node.value === 'number' || node.value === null)) {
+ return {
+ value: node.value,
+ serializable: true,
+ }
+ }
+
+ return {
+ serializable: false,
+ }
+}
+
+export function toRou3Patterns (pages: NuxtPage[], prefix = '/'): string[] {
+ const routes: string[] = []
+ for (const page of pages) {
+ // convert to rou3-compatible path (https://github.com/h3js/rou3)
+ const path = page.path
+ // remove all regex patterns
+ .replace(/\([^)]*\)/g, '')
+ // catchalls: `:name([^/]*)*` or `:catchall(.*)*`
+ .replace(/:(\w+)\*.*/g, (_, name) => `**:${name}`)
+ // dynamic paths, including custom patterns, e.g. :id([^/]*)*/suffix
+ .replace(/:([^/*]*)/g, (_, name) => `:${name.replace(/\W/g, (r: string) => r === '?' ? '' : '_')}`)
+
+ routes.push(joinURL(prefix, path))
+
+ if (page.children) {
+ routes.push(...toRou3Patterns(page.children, joinURL(prefix, path)))
+ }
+ }
+ return routes
+}
diff --git a/packages/nuxt/src/utils.ts b/packages/nuxt/src/utils.ts
new file mode 100644
index 000000000000..9f300c5a3edf
--- /dev/null
+++ b/packages/nuxt/src/utils.ts
@@ -0,0 +1,65 @@
+import { promises as fsp, statSync } from 'node:fs'
+import { tryUseNuxt, useLogger } from '@nuxt/kit'
+import { reverseResolveAlias } from 'pathe/utils'
+
+/** @since 3.9.0 */
+export function toArray<T> (value: T | T[]): T[] {
+ return Array.isArray(value) ? value : [value]
+}
+
+export async function isDirectory (path: string) {
+ return (await fsp.lstat(path)).isDirectory()
+}
+
+export function isDirectorySync (path: string) {
+ try {
+ return statSync(path, { throwIfNoEntry: false })?.isDirectory() ?? false
+ } catch (err) {
+ // ENOTDIR should be treated as "not a directory" instead of an error
+ if ((err as NodeJS.ErrnoException).code === 'ENOTDIR') { return false }
+ throw err
+ }
+}
+
+const LEADING_DOT_RE = /^\.+/g
+
+/**
+ * Normalizes a file extension from a string to just the extension part (without the dot).
+ * In case the string does not contain a dot, it returns the string as is.
+ *
+ * @example
+ * normalizeExtension('.ts') // 'ts'
+ * normalizeExtension('.d.ts') // 'd.ts'
+ * normalizeExtension('ts') // 'ts'
+ * normalizeExtension('d.ts') // 'ts'
+ */
+export function normalizeExtension (input: string) {
+ return input.replace(LEADING_DOT_RE, '')
+}
+
+export function stripExtension (path: string) {
+ return path.replace(/\.[^./\\]+$/, '')
+}
+
+export function isWhitespace (char: number | string | undefined | null): boolean {
+ const c = typeof char === 'string' ? char.charCodeAt(0) : char
+ // ' ' (32), '\t' (9), '\n' (10), '\r' (13), '\f' (12)
+ return c === 32 || c === 9 || c === 10 || c === 13 || c === 12
+}
+
+export const JS_EXT_RE = /^[^?]*\.(?:[jt]sx?|[cm][jt]s)(?:$|\?)/
+export const NUXT_LIB_RE = /^[^?]*node_modules\/(?:nuxt|nuxt3|nuxt-nightly|@nuxt)\//
+export const STYLE_QUERY_RE = /[?&]type=style/
+export const MACRO_QUERY_RE = /[?&]macro(?:=|&|$)/
+export const DECLARATION_EXTENSIONS = ['d.ts', 'd.mts', 'd.cts', 'd.vue.ts', 'd.vue.mts', 'd.vue.cts']
+
+export const logger = useLogger('nuxt')
+
+export function resolveToAlias (path: string, nuxt = tryUseNuxt()) {
+ return reverseResolveAlias(path, { ...nuxt?.options.alias || {}, ...strippedAtAliases }).pop() || path
+}
+
+const strippedAtAliases = {
+ '@': '',
+ '@@': '',
+}
diff --git a/packages/nuxt/test/__snapshots__/components-tree-shake.test.ts.snap b/packages/nuxt/test/__snapshots__/components-tree-shake.test.ts.snap
new file mode 100644
index 000000000000..adc24ea63534
Binary files /dev/null and b/packages/nuxt/test/__snapshots__/components-tree-shake.test.ts.snap differ
diff --git a/packages/nuxt/test/__snapshots__/pages-override-meta-disabled.test.ts.snap b/packages/nuxt/test/__snapshots__/pages-override-meta-disabled.test.ts.snap
new file mode 100644
index 000000000000..cd8faef777b7
--- /dev/null
+++ b/packages/nuxt/test/__snapshots__/pages-override-meta-disabled.test.ts.snap
@@ -0,0 +1,730 @@
+{
+ "pushed route, skips generation from file": [
+ {
+ "alias": "["pushed-route-alias"].concat(mockMeta?.alias || [])",
+ "component": "() => import("pages/route-file.vue")",
+ "meta": "{ ...(mockMeta || {}), ...{"someMetaData":true} }",
+ "name": "mockMeta?.name ?? "pushed-route"",
+ "path": "mockMeta?.path ?? "/"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "route without file": [
+ {
+ "alias": "["sweet-home"]",
+ "meta": "{"hello":"world"}",
+ "name": ""home"",
+ "path": ""/"",
+ },
+ ],
+ "route.meta generated from file": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/page-with-meta.vue")",
+ "meta": "{ ...(mockMeta || {}), ...{"test":1} }",
+ "name": "mockMeta?.name ?? "page-with-meta"",
+ "path": "mockMeta?.path ?? "/page-with-meta"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "route.meta props generate by file": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/page-with-props.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "page-with-props"",
+ "path": "mockMeta?.path ?? "/page-with-props"",
+ "props": "mockMeta?.props ?? true",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "should allow pages with `:` in their path": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/test:name.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "test:name"",
+ "path": "mockMeta?.path ?? "/test\\:name"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "should correctly merge nested routes": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "children": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("layer/pages/wrapper-expose/other/index.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "wrapper-expose-other"",
+ "path": "mockMeta?.path ?? """,
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/wrapper-expose/other/sibling.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "wrapper-expose-other-sibling"",
+ "path": "mockMeta?.path ?? "sibling"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "component": "() => import("pages/wrapper-expose/other.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? undefined",
+ "path": "mockMeta?.path ?? "/wrapper-expose/other"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ {
+ "alias": "mockMeta?.alias || []",
+ "children": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "children": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/param/index/index.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "param-index"",
+ "path": "mockMeta?.path ?? """,
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("layer/pages/param/index/sibling.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "param-index-sibling"",
+ "path": "mockMeta?.path ?? "sibling"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "component": "() => import("layer/pages/param/index.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? undefined",
+ "path": "mockMeta?.path ?? """,
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/param/sibling.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "param-sibling"",
+ "path": "mockMeta?.path ?? "sibling"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "component": "() => import("pages/param.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? undefined",
+ "path": "mockMeta?.path ?? "/param"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "should escape special chars in static paths": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/a&b.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "a&b"",
+ "path": "mockMeta?.path ?? "/a%26b"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/a/b.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "a\\b"",
+ "path": "mockMeta?.path ?? "/a%5Cb"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "should extract serializable values and override fallback when normalized with `overrideMeta: true`": [
+ {
+ "alias": "["sweet-home"].concat(mockMeta?.alias || [])",
+ "component": "() => import("pages/index.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "home"",
+ "path": "mockMeta?.path ?? "/"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": ""/"",
+ },
+ ],
+ "should generate correct catch-all route": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "children": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/[...slug]/[id].vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "slug-id"",
+ "path": "mockMeta?.path ?? ":id()"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "component": "() => import("pages/[...slug].vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "slug"",
+ "path": "mockMeta?.path ?? "/:slug(.*)*"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/index.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "index"",
+ "path": "mockMeta?.path ?? "/"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "should generate correct dynamic routes": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "children": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/[[foo]]/index.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "foo"",
+ "path": "mockMeta?.path ?? """,
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "component": "() => import("pages/[[foo]]")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? undefined",
+ "path": "mockMeta?.path ?? "/:foo?"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/[[sub]]/route-[slug].vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "sub-route-slug"",
+ "path": "mockMeta?.path ?? "/:sub?/route-:slug()"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/[slug].vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "slug"",
+ "path": "mockMeta?.path ?? "/:slug()"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/optional/prefix-[[opt]].vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "optional-prefix-opt"",
+ "path": "mockMeta?.path ?? "/optional/prefix-:opt?"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/optional/prefix-[[opt]]-postfix.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "optional-prefix-opt-postfix"",
+ "path": "mockMeta?.path ?? "/optional/prefix-:opt?-postfix"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/optional/[[opt]].vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "optional-opt"",
+ "path": "mockMeta?.path ?? "/optional/:opt?"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/optional/[[opt]]-postfix.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "optional-opt-postfix"",
+ "path": "mockMeta?.path ?? "/optional/:opt?-postfix"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/opt/[[slug]].vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "opt-slug"",
+ "path": "mockMeta?.path ?? "/opt/:slug?"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/nonopt/[slug].vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "nonopt-slug"",
+ "path": "mockMeta?.path ?? "/nonopt/:slug()"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/index.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "index"",
+ "path": "mockMeta?.path ?? "/"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/[bar]/index.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "bar"",
+ "path": "mockMeta?.path ?? "/:bar()"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "should generate correct id for catchall (order 1)": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/[...stories].vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "stories"",
+ "path": "mockMeta?.path ?? "/:stories(.*)*"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/stories/[id].vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "stories-id"",
+ "path": "mockMeta?.path ?? "/stories/:id()"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "should generate correct id for catchall (order 2)": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/[...stories].vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "stories"",
+ "path": "mockMeta?.path ?? "/:stories(.*)*"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/stories/[id].vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "stories-id"",
+ "path": "mockMeta?.path ?? "/stories/:id()"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "should generate correct route for kebab-case file": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/kebab-case.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "kebab-case"",
+ "path": "mockMeta?.path ?? "/kebab-case"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "should generate correct route for snake_case file": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/snake_case.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "snake_case"",
+ "path": "mockMeta?.path ?? "/snake_case"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "should generate correct routes for index pages": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/parent/index.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "parent"",
+ "path": "mockMeta?.path ?? "/parent"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/parent/child/index.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "parent-child"",
+ "path": "mockMeta?.path ?? "/parent/child"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/index.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "index"",
+ "path": "mockMeta?.path ?? "/"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "should generate correct routes for nested pages": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "children": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/page1/index.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "page1"",
+ "path": "mockMeta?.path ?? """,
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/page1/[id].vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "page1-id"",
+ "path": "mockMeta?.path ?? ":id()"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "component": "() => import("pages/page1.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? undefined",
+ "path": "mockMeta?.path ?? "/page1"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "should generate correct routes for parent/child": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "children": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/parent/child.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "parent-child"",
+ "path": "mockMeta?.path ?? "child"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "component": "() => import("pages/parent.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "parent"",
+ "path": "mockMeta?.path ?? "/parent"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "should handle route groups": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "children": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "children": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/(bar)/about/(foo)/index.vue")",
+ "meta": "{ ...(mockMeta || {}), ...{"groups":["bar","foo"]} }",
+ "name": "mockMeta?.name ?? "about"",
+ "path": "mockMeta?.path ?? """,
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "component": "() => import("pages/(bar)/about/index.vue")",
+ "meta": "{ ...(mockMeta || {}), ...{"groups":["bar"]} }",
+ "name": "mockMeta?.name ?? undefined",
+ "path": "mockMeta?.path ?? """,
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "component": "() => import("pages/(foo)/about.vue")",
+ "meta": "{ ...(mockMeta || {}), ...{"groups":["foo"]} }",
+ "name": "mockMeta?.name ?? undefined",
+ "path": "mockMeta?.path ?? "/about"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/(foo)/index.vue")",
+ "meta": "{ ...(mockMeta || {}), ...{"groups":["foo"]} }",
+ "name": "mockMeta?.name ?? "index"",
+ "path": "mockMeta?.path ?? "/"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "should handle trailing slashes with index routes": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "children": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/index/index/all.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "index-index-all"",
+ "path": "mockMeta?.path ?? "all"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "component": "() => import("pages/index/index.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "index"",
+ "path": "mockMeta?.path ?? "/"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "should handle unicode and special characters in page paths": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/测试.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "测试"",
+ "path": "mockMeta?.path ?? "/%E6%B5%8B%E8%AF%95"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ {
+ "alias": "mockMeta?.alias || []",
+ "children": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/文档/介绍.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "文档-介绍"",
+ "path": "mockMeta?.path ?? "%E4%BB%8B%E7%BB%8D"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "component": "() => import("pages/文档.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "文档"",
+ "path": "mockMeta?.path ?? "/%E6%96%87%E6%A1%A3"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/خاص:جديد.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "خاص:جديد"",
+ "path": "mockMeta?.path ?? "/%D8%AE%D8%A7%D8%B5\\:%D8%AC%D8%AF%D9%8A%D8%AF"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "should handle unicode characters in alias paths": [
+ {
+ "alias": "["/товары","/produits","/製品"].concat(mockMeta?.alias || [])",
+ "component": "() => import("pages/products.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "products"",
+ "path": "mockMeta?.path ?? "/products"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "should merge route.meta with meta from file": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/page-with-meta.vue")",
+ "meta": "{ ...(mockMeta || {}), ...{"test":1,"extracted":{"foo":"foo","bar":"bar"}} }",
+ "name": "mockMeta?.name ?? "page-with-meta"",
+ "path": "mockMeta?.path ?? "/page-with-meta"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "should not generate colliding route names when hyphens are in file name": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/parent/[child].vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "parent-child"",
+ "path": "mockMeta?.path ?? "/parent/:child()"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/parent-[child].vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "parent-child"",
+ "path": "mockMeta?.path ?? "/parent-:child()"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "should not merge required param as a child of optional param": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/[foo].vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "foo"",
+ "path": "mockMeta?.path ?? "/:foo()"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/[[foo]].vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "foo"",
+ "path": "mockMeta?.path ?? "/:foo?"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "should only allow "_" & "." as special character for dynamic route": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/[[d4-4d]].vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "d44d"",
+ "path": "mockMeta?.path ?? "/:d44d?"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/[[c3@3c]].vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "c33c"",
+ "path": "mockMeta?.path ?? "/:c33c?"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/[b2.2b].vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "b2.2b"",
+ "path": "mockMeta?.path ?? "/:b2.2b()"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/[b2]_[2b].vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "b2_2b"",
+ "path": "mockMeta?.path ?? "/:b2()_:2b()"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/[a1_1a].vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "a1_1a"",
+ "path": "mockMeta?.path ?? "/:a1_1a()"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "should preserve named views from the `name@view.vue` filename convention": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "children": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/foo/bar.vue")",
+ "components": "{ default: () => import("pages/foo/bar.vue"), "left": () => import("pages/foo/bar@left.vue") }",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "foo-bar"",
+ "path": "mockMeta?.path ?? "bar"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "component": "() => import("pages/foo.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "foo"",
+ "path": "mockMeta?.path ?? "/foo"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "should properly override route name if definePageMeta name override is defined.": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/index.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "home"",
+ "path": "mockMeta?.path ?? "/"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "should use fallbacks when normalized with `overrideMeta: true`": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/index.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "index"",
+ "path": "mockMeta?.path ?? "/"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "should use more performant regexp when catchall is used in middle of path": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/[...id]/index.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "id"",
+ "path": "mockMeta?.path ?? "/:id(.*)*"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/[...id]/suffix.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "id-suffix"",
+ "path": "mockMeta?.path ?? "/:id([^/]*)*/suffix"",
+ "props": "mockMeta?.props ?? false",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+}
\ No newline at end of file
diff --git a/packages/nuxt/test/__snapshots__/pages-override-meta-enabled.test.ts.snap b/packages/nuxt/test/__snapshots__/pages-override-meta-enabled.test.ts.snap
new file mode 100644
index 000000000000..ecf7041d2a0e
--- /dev/null
+++ b/packages/nuxt/test/__snapshots__/pages-override-meta-enabled.test.ts.snap
@@ -0,0 +1,462 @@
+{
+ "pushed route, skips generation from file": [
+ {
+ "alias": "["pushed-route-alias"]",
+ "component": "() => import("pages/route-file.vue")",
+ "meta": "{"someMetaData":true}",
+ "name": ""pushed-route"",
+ "path": ""/"",
+ },
+ ],
+ "route without file": [
+ {
+ "alias": "["sweet-home"]",
+ "meta": "{"hello":"world"}",
+ "name": ""home"",
+ "path": ""/"",
+ },
+ ],
+ "route.meta generated from file": [
+ {
+ "component": "() => import("pages/page-with-meta.vue")",
+ "meta": "{"test":1}",
+ "name": ""page-with-meta"",
+ "path": ""/page-with-meta"",
+ },
+ ],
+ "route.meta props generate by file": [
+ {
+ "component": "() => import("pages/page-with-props.vue")",
+ "name": ""page-with-props"",
+ "path": ""/page-with-props"",
+ "props": "true",
+ },
+ ],
+ "should allow pages with `:` in their path": [
+ {
+ "component": "() => import("pages/test:name.vue")",
+ "name": ""test:name"",
+ "path": ""/test\\:name"",
+ },
+ ],
+ "should correctly merge nested routes": [
+ {
+ "children": [
+ {
+ "component": "() => import("layer/pages/wrapper-expose/other/index.vue")",
+ "name": ""wrapper-expose-other"",
+ "path": """",
+ },
+ {
+ "component": "() => import("pages/wrapper-expose/other/sibling.vue")",
+ "name": ""wrapper-expose-other-sibling"",
+ "path": ""sibling"",
+ },
+ ],
+ "component": "() => import("pages/wrapper-expose/other.vue")",
+ "name": "mockMeta?.name",
+ "path": ""/wrapper-expose/other"",
+ },
+ {
+ "children": [
+ {
+ "children": [
+ {
+ "component": "() => import("pages/param/index/index.vue")",
+ "name": ""param-index"",
+ "path": """",
+ },
+ {
+ "component": "() => import("layer/pages/param/index/sibling.vue")",
+ "name": ""param-index-sibling"",
+ "path": ""sibling"",
+ },
+ ],
+ "component": "() => import("layer/pages/param/index.vue")",
+ "name": "mockMeta?.name",
+ "path": """",
+ },
+ {
+ "component": "() => import("pages/param/sibling.vue")",
+ "name": ""param-sibling"",
+ "path": ""sibling"",
+ },
+ ],
+ "component": "() => import("pages/param.vue")",
+ "name": "mockMeta?.name",
+ "path": ""/param"",
+ },
+ ],
+ "should escape special chars in static paths": [
+ {
+ "component": "() => import("pages/a&b.vue")",
+ "name": ""a&b"",
+ "path": ""/a%26b"",
+ },
+ {
+ "component": "() => import("pages/a/b.vue")",
+ "name": ""a\\b"",
+ "path": ""/a%5Cb"",
+ },
+ ],
+ "should extract serializable values and override fallback when normalized with `overrideMeta: true`": [
+ {
+ "alias": "["sweet-home"]",
+ "component": "() => import("pages/index.vue")",
+ "meta": "mockMeta || {}",
+ "name": ""home"",
+ "path": ""/"",
+ "redirect": ""/"",
+ },
+ ],
+ "should generate correct catch-all route": [
+ {
+ "children": [
+ {
+ "component": "() => import("pages/[...slug]/[id].vue")",
+ "name": ""slug-id"",
+ "path": "":id()"",
+ },
+ ],
+ "component": "() => import("pages/[...slug].vue")",
+ "name": ""slug"",
+ "path": ""/:slug(.*)*"",
+ },
+ {
+ "component": "() => import("pages/index.vue")",
+ "name": ""index"",
+ "path": ""/"",
+ },
+ ],
+ "should generate correct dynamic routes": [
+ {
+ "children": [
+ {
+ "component": "() => import("pages/[[foo]]/index.vue")",
+ "name": ""foo"",
+ "path": """",
+ },
+ ],
+ "component": "() => import("pages/[[foo]]")",
+ "name": "mockMeta?.name",
+ "path": ""/:foo?"",
+ },
+ {
+ "component": "() => import("pages/[[sub]]/route-[slug].vue")",
+ "name": ""sub-route-slug"",
+ "path": ""/:sub?/route-:slug()"",
+ },
+ {
+ "component": "() => import("pages/[slug].vue")",
+ "name": ""slug"",
+ "path": ""/:slug()"",
+ },
+ {
+ "component": "() => import("pages/optional/prefix-[[opt]].vue")",
+ "name": ""optional-prefix-opt"",
+ "path": ""/optional/prefix-:opt?"",
+ },
+ {
+ "component": "() => import("pages/optional/prefix-[[opt]]-postfix.vue")",
+ "name": ""optional-prefix-opt-postfix"",
+ "path": ""/optional/prefix-:opt?-postfix"",
+ },
+ {
+ "component": "() => import("pages/optional/[[opt]].vue")",
+ "name": ""optional-opt"",
+ "path": ""/optional/:opt?"",
+ },
+ {
+ "component": "() => import("pages/optional/[[opt]]-postfix.vue")",
+ "name": ""optional-opt-postfix"",
+ "path": ""/optional/:opt?-postfix"",
+ },
+ {
+ "component": "() => import("pages/opt/[[slug]].vue")",
+ "name": ""opt-slug"",
+ "path": ""/opt/:slug?"",
+ },
+ {
+ "component": "() => import("pages/nonopt/[slug].vue")",
+ "name": ""nonopt-slug"",
+ "path": ""/nonopt/:slug()"",
+ },
+ {
+ "component": "() => import("pages/index.vue")",
+ "name": ""index"",
+ "path": ""/"",
+ },
+ {
+ "component": "() => import("pages/[bar]/index.vue")",
+ "name": ""bar"",
+ "path": ""/:bar()"",
+ },
+ ],
+ "should generate correct id for catchall (order 1)": [
+ {
+ "component": "() => import("pages/[...stories].vue")",
+ "name": ""stories"",
+ "path": ""/:stories(.*)*"",
+ },
+ {
+ "component": "() => import("pages/stories/[id].vue")",
+ "name": ""stories-id"",
+ "path": ""/stories/:id()"",
+ },
+ ],
+ "should generate correct id for catchall (order 2)": [
+ {
+ "component": "() => import("pages/[...stories].vue")",
+ "name": ""stories"",
+ "path": ""/:stories(.*)*"",
+ },
+ {
+ "component": "() => import("pages/stories/[id].vue")",
+ "name": ""stories-id"",
+ "path": ""/stories/:id()"",
+ },
+ ],
+ "should generate correct route for kebab-case file": [
+ {
+ "component": "() => import("pages/kebab-case.vue")",
+ "name": ""kebab-case"",
+ "path": ""/kebab-case"",
+ },
+ ],
+ "should generate correct route for snake_case file": [
+ {
+ "component": "() => import("pages/snake_case.vue")",
+ "name": ""snake_case"",
+ "path": ""/snake_case"",
+ },
+ ],
+ "should generate correct routes for index pages": [
+ {
+ "component": "() => import("pages/parent/index.vue")",
+ "name": ""parent"",
+ "path": ""/parent"",
+ },
+ {
+ "component": "() => import("pages/parent/child/index.vue")",
+ "name": ""parent-child"",
+ "path": ""/parent/child"",
+ },
+ {
+ "component": "() => import("pages/index.vue")",
+ "name": ""index"",
+ "path": ""/"",
+ },
+ ],
+ "should generate correct routes for nested pages": [
+ {
+ "children": [
+ {
+ "component": "() => import("pages/page1/index.vue")",
+ "name": ""page1"",
+ "path": """",
+ },
+ {
+ "component": "() => import("pages/page1/[id].vue")",
+ "name": ""page1-id"",
+ "path": "":id()"",
+ },
+ ],
+ "component": "() => import("pages/page1.vue")",
+ "name": "mockMeta?.name",
+ "path": ""/page1"",
+ },
+ ],
+ "should generate correct routes for parent/child": [
+ {
+ "children": [
+ {
+ "component": "() => import("pages/parent/child.vue")",
+ "name": ""parent-child"",
+ "path": ""child"",
+ },
+ ],
+ "component": "() => import("pages/parent.vue")",
+ "name": ""parent"",
+ "path": ""/parent"",
+ },
+ ],
+ "should handle route groups": [
+ {
+ "children": [
+ {
+ "children": [
+ {
+ "component": "() => import("pages/(bar)/about/(foo)/index.vue")",
+ "meta": "{"groups":["bar","foo"]}",
+ "name": ""about"",
+ "path": """",
+ },
+ ],
+ "component": "() => import("pages/(bar)/about/index.vue")",
+ "meta": "{"groups":["bar"]}",
+ "name": "mockMeta?.name",
+ "path": """",
+ },
+ ],
+ "component": "() => import("pages/(foo)/about.vue")",
+ "meta": "{"groups":["foo"]}",
+ "name": "mockMeta?.name",
+ "path": ""/about"",
+ },
+ {
+ "component": "() => import("pages/(foo)/index.vue")",
+ "meta": "{"groups":["foo"]}",
+ "name": ""index"",
+ "path": ""/"",
+ },
+ ],
+ "should handle trailing slashes with index routes": [
+ {
+ "children": [
+ {
+ "component": "() => import("pages/index/index/all.vue")",
+ "name": ""index-index-all"",
+ "path": ""all"",
+ },
+ ],
+ "component": "() => import("pages/index/index.vue")",
+ "name": ""index"",
+ "path": ""/"",
+ },
+ ],
+ "should handle unicode and special characters in page paths": [
+ {
+ "component": "() => import("pages/测试.vue")",
+ "name": ""测试"",
+ "path": ""/%E6%B5%8B%E8%AF%95"",
+ },
+ {
+ "children": [
+ {
+ "component": "() => import("pages/文档/介绍.vue")",
+ "name": ""文档-介绍"",
+ "path": ""%E4%BB%8B%E7%BB%8D"",
+ },
+ ],
+ "component": "() => import("pages/文档.vue")",
+ "name": ""文档"",
+ "path": ""/%E6%96%87%E6%A1%A3"",
+ },
+ {
+ "component": "() => import("pages/خاص:جديد.vue")",
+ "name": ""خاص:جديد"",
+ "path": ""/%D8%AE%D8%A7%D8%B5\\:%D8%AC%D8%AF%D9%8A%D8%AF"",
+ },
+ ],
+ "should handle unicode characters in alias paths": [
+ {
+ "alias": "["/товары","/produits","/製品"]",
+ "component": "() => import("pages/products.vue")",
+ "name": ""products"",
+ "path": ""/products"",
+ },
+ ],
+ "should merge route.meta with meta from file": [
+ {
+ "component": "() => import("pages/page-with-meta.vue")",
+ "meta": "{ ...(mockMeta || {}), ...{"test":1,"extracted":{"foo":"foo","bar":"bar"}} }",
+ "name": ""page-with-meta"",
+ "path": ""/page-with-meta"",
+ },
+ ],
+ "should not generate colliding route names when hyphens are in file name": [
+ {
+ "component": "() => import("pages/parent/[child].vue")",
+ "name": ""parent-child"",
+ "path": ""/parent/:child()"",
+ },
+ {
+ "component": "() => import("pages/parent-[child].vue")",
+ "name": ""parent-child"",
+ "path": ""/parent-:child()"",
+ },
+ ],
+ "should not merge required param as a child of optional param": [
+ {
+ "component": "() => import("pages/[foo].vue")",
+ "name": ""foo"",
+ "path": ""/:foo()"",
+ },
+ {
+ "component": "() => import("pages/[[foo]].vue")",
+ "name": ""foo"",
+ "path": ""/:foo?"",
+ },
+ ],
+ "should only allow "_" & "." as special character for dynamic route": [
+ {
+ "component": "() => import("pages/[[d4-4d]].vue")",
+ "name": ""d44d"",
+ "path": ""/:d44d?"",
+ },
+ {
+ "component": "() => import("pages/[[c3@3c]].vue")",
+ "name": ""c33c"",
+ "path": ""/:c33c?"",
+ },
+ {
+ "component": "() => import("pages/[b2.2b].vue")",
+ "name": ""b2.2b"",
+ "path": ""/:b2.2b()"",
+ },
+ {
+ "component": "() => import("pages/[b2]_[2b].vue")",
+ "name": ""b2_2b"",
+ "path": ""/:b2()_:2b()"",
+ },
+ {
+ "component": "() => import("pages/[a1_1a].vue")",
+ "name": ""a1_1a"",
+ "path": ""/:a1_1a()"",
+ },
+ ],
+ "should preserve named views from the `name@view.vue` filename convention": [
+ {
+ "children": [
+ {
+ "component": "() => import("pages/foo/bar.vue")",
+ "components": "{ default: () => import("pages/foo/bar.vue"), "left": () => import("pages/foo/bar@left.vue") }",
+ "name": ""foo-bar"",
+ "path": ""bar"",
+ },
+ ],
+ "component": "() => import("pages/foo.vue")",
+ "name": ""foo"",
+ "path": ""/foo"",
+ },
+ ],
+ "should properly override route name if definePageMeta name override is defined.": [
+ {
+ "component": "() => import("pages/index.vue")",
+ "name": ""home"",
+ "path": ""/"",
+ },
+ ],
+ "should use fallbacks when normalized with `overrideMeta: true`": [
+ {
+ "alias": "mockMeta?.alias || []",
+ "component": "() => import("pages/index.vue")",
+ "meta": "mockMeta || {}",
+ "name": "mockMeta?.name ?? "index"",
+ "path": ""/"",
+ "redirect": "mockMeta?.redirect",
+ },
+ ],
+ "should use more performant regexp when catchall is used in middle of path": [
+ {
+ "component": "() => import("pages/[...id]/index.vue")",
+ "name": ""id"",
+ "path": ""/:id(.*)*"",
+ },
+ {
+ "component": "() => import("pages/[...id]/suffix.vue")",
+ "name": ""id-suffix"",
+ "path": ""/:id([^/]*)*/suffix"",
+ },
+ ],
+}
\ No newline at end of file
diff --git a/packages/nuxt/test/app-config.test.ts b/packages/nuxt/test/app-config.test.ts
new file mode 100644
index 000000000000..e20585cb4825
--- /dev/null
+++ b/packages/nuxt/test/app-config.test.ts
@@ -0,0 +1,124 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest'
+import { _replaceAppConfig } from '../src/app/config.ts'
+
+const mockNuxt = {
+ _appConfig: {} as Partial<{
+ apiUrl: string
+ featureFlags: Record<string, boolean>
+ entries: Array<{ label: string }>
+ }>,
+}
+
+vi.mock('../src/app/nuxt', () => ({
+ useNuxtApp: () => mockNuxt,
+}))
+
+describe('_replaceAppConfig', () => {
+ beforeEach(() => {
+ mockNuxt._appConfig = {
+ apiUrl: 'https://api.example.com',
+ featureFlags: { foo: false },
+ entries: [{ label: 'foo' }, { label: 'bar' }],
+ }
+ })
+
+ it('should remove properties not in new config', () => {
+ const newConfig = {
+ featureFlags: { baz: true },
+ entries: [{ label: 'baz' }],
+ }
+
+ _replaceAppConfig(newConfig)
+ expect(mockNuxt._appConfig).toEqual({
+ featureFlags: { baz: true },
+ entries: [{ label: 'baz' }],
+ })
+ })
+
+ it('should add new properties from new config', () => {
+ const newConfig = {
+ apiUrl: 'https://api.newexample.com',
+ featureFlags: { foo: true, baz: true },
+ entries: [{ label: 'foo' }, { label: 'bar' }, { label: 'baz' }],
+ }
+
+ _replaceAppConfig(newConfig)
+
+ expect(mockNuxt._appConfig).toEqual({
+ apiUrl: 'https://api.newexample.com',
+ featureFlags: { foo: true, baz: true },
+ entries: [{ label: 'foo' }, { label: 'bar' }, { label: 'baz' }],
+ })
+
+ expect(mockNuxt._appConfig.entries?.length).toEqual(3)
+ })
+
+ it('should update properties in arrays', () => {
+ const newConfig = {
+ entries: [{ label: 'updated-foo' }, { label: 'updated-bar' }],
+ }
+
+ _replaceAppConfig(newConfig)
+
+ expect(mockNuxt._appConfig.entries).toEqual([
+ { label: 'updated-foo' },
+ { label: 'updated-bar' },
+ ])
+ })
+
+ it('should handle replacing arrays with objects and vice versa', () => {
+ const newConfig = {
+ entries: { first: { label: 'only-entry' } },
+ }
+
+ _replaceAppConfig(newConfig)
+
+ expect(mockNuxt._appConfig.entries).toEqual({ first: { label: 'only-entry' } })
+
+ const anotherNewConfig = {
+ entries: [{ label: 'restored-entry' }],
+ }
+
+ _replaceAppConfig(anotherNewConfig)
+
+ expect(mockNuxt._appConfig.entries).toEqual([{ label: 'restored-entry' }])
+ })
+
+ it('should preserve element order in arrays', () => {
+ const newConfig = {
+ entries: [{ label: 'foo' }, { label: 'baz' }, { label: 'bar' }],
+ }
+
+ _replaceAppConfig(newConfig)
+
+ expect(mockNuxt._appConfig.entries).toEqual([
+ { label: 'foo' },
+ { label: 'baz' },
+ { label: 'bar' },
+ ])
+ })
+
+ it('should preserve object references for unchanged properties', () => {
+ const originalFeatureFlags = mockNuxt._appConfig.featureFlags
+ const newConfig = {
+ apiUrl: 'https://api.example.com',
+ featureFlags: { foo: false }, // unchanged
+ entries: [{ label: 'new-entry' }],
+ }
+
+ _replaceAppConfig(newConfig)
+
+ expect(mockNuxt._appConfig.featureFlags).toBe(originalFeatureFlags)
+ })
+
+ it('should preserve object references in arrays for unchanged elements', () => {
+ const originalEntries = mockNuxt._appConfig.entries
+ const newConfig = {
+ entries: [originalEntries![0], { label: 'new-bar' }],
+ }
+
+ _replaceAppConfig(newConfig)
+
+ expect(mockNuxt._appConfig.entries![0]).toBe(originalEntries![0])
+ })
+})
diff --git a/packages/nuxt/test/app.test.ts b/packages/nuxt/test/app.test.ts
new file mode 100644
index 000000000000..fa8cf31ea28c
--- /dev/null
+++ b/packages/nuxt/test/app.test.ts
@@ -0,0 +1,342 @@
+import { mkdir, rm, writeFile } from 'node:fs/promises'
+import { randomUUID } from 'node:crypto'
+import { afterAll, describe, expect, it } from 'vitest'
+import { dirname, join, resolve } from 'pathe'
+import { findWorkspaceDir } from 'pkg-types'
+import { createApp, resolveApp } from '../src/core/app.ts'
+import { loadNuxt } from '../src/index.ts'
+
+const repoRoot = await findWorkspaceDir()
+
+describe('resolveApp', () => {
+ afterAll(async () => {
+ await rm(resolve(repoRoot, '.fixture'), { recursive: true, force: true })
+ })
+ it('resolves app with default configuration', async () => {
+ const app = await getResolvedApp([])
+ expect(app).toMatchInlineSnapshot(`
+ {
+ "components": [],
+ "configs": [],
+ "dir": "<rootDir>",
+ "errorComponent": "<repoRoot>/packages/nuxt/src/app/components/nuxt-error-page.vue",
+ "extensions": [
+ ".js",
+ ".jsx",
+ ".mjs",
+ ".ts",
+ ".tsx",
+ ".vue",
+ ],
+ "layouts": {},
+ "mainComponent": "<repoRoot>/packages/nuxt/src/app/components/welcome.vue",
+ "middleware": [
+ {
+ "global": true,
+ "name": "manifest-route-rule",
+ "path": "<repoRoot>/packages/nuxt/src/app/middleware/route-rules.ts",
+ },
+ ],
+ "plugins": [
+ {
+ "mode": "client",
+ "src": "<repoRoot>/packages/nuxt/src/app/plugins/payload.client.ts",
+ },
+ {
+ "mode": "client",
+ "src": "<repoRoot>/packages/nuxt/src/app/plugins/navigation-repaint.client.ts",
+ },
+ {
+ "mode": "client",
+ "src": "<repoRoot>/packages/nuxt/src/app/plugins/check-outdated-build.client.ts",
+ },
+ {
+ "mode": "server",
+ "src": "<repoRoot>/packages/nuxt/src/app/plugins/revive-payload.server.ts",
+ },
+ {
+ "mode": "client",
+ "src": "<repoRoot>/packages/nuxt/src/app/plugins/revive-payload.client.ts",
+ },
+ {
+ "mode": "client",
+ "src": "<repoRoot>/packages/nuxt/src/app/plugins/chunk-reload.client.ts",
+ },
+ {
+ "filename": "components.plugin.mjs",
+ "getContents": [Function],
+ "mode": "all",
+ "src": "<rootDir>/.nuxt/components.plugin.mjs",
+ },
+ {
+ "mode": "all",
+ "src": "<repoRoot>/packages/nuxt/src/head/runtime/plugins/unhead.ts",
+ },
+ {
+ "mode": "all",
+ "src": "<repoRoot>/packages/nuxt/src/app/plugins/router.ts",
+ },
+ ],
+ "rootComponent": "<repoRoot>/packages/nuxt/src/app/components/nuxt-root.vue",
+ "templates": [],
+ }
+ `)
+ })
+
+ it('resolves layouts and middleware correctly', async () => {
+ const app = await getResolvedApp([
+ 'middleware/index.ts',
+ 'middleware/auth/index.ts',
+ 'middleware/other.ts',
+ 'layouts/index.vue',
+ 'layouts/default/index.vue',
+ 'layouts/other.vue',
+ ])
+ // Middleware are not resolved in a nested manner
+ expect(app.middleware.filter(m => m.path.startsWith('<rootDir>'))).toMatchInlineSnapshot(`
+ [
+ {
+ "global": false,
+ "name": "other",
+ "path": "<rootDir>/middleware/other.ts",
+ },
+ ]
+ `)
+ expect(app.layouts).toMatchInlineSnapshot(`
+ {
+ "default": {
+ "file": "<rootDir>/layouts/default/index.vue",
+ "name": "default",
+ },
+ "other": {
+ "file": "<rootDir>/layouts/other.vue",
+ "name": "other",
+ },
+ }
+ `)
+ })
+
+ it('resolves layer plugins in correct order', async () => {
+ const app = await getResolvedApp([
+ // layer 1
+ 'layer1/plugins/02.plugin.ts',
+ 'layer1/plugins/object-named.ts',
+ 'layer1/plugins/override-test.ts',
+ 'layer1/nuxt.config.ts',
+ // layer 2
+ 'layer2/plugins/01.plugin.ts',
+ 'layer2/plugins/object-named.ts',
+ 'layer2/plugins/override-test.ts',
+ 'layer2/nuxt.config.ts',
+ // final (user) layer
+ 'plugins/00.plugin.ts',
+ 'plugins/object-named.ts',
+ {
+ name: 'nuxt.config.ts',
+ contents: 'export default defineNuxtConfig({ extends: [\'./layer2\', \'./layer1\'] })',
+ },
+ ])
+ const fixturePlugins = app.plugins.filter(p => !('getContents' in p) && p.src.includes('<rootDir>')).map(p => p.src)
+ // TODO: support overriding named plugins
+ expect(fixturePlugins).toMatchInlineSnapshot(`
+ [
+ "<rootDir>/layer1/plugins/02.plugin.ts",
+ "<rootDir>/layer1/plugins/object-named.ts",
+ "<rootDir>/layer1/plugins/override-test.ts",
+ "<rootDir>/layer2/plugins/01.plugin.ts",
+ "<rootDir>/layer2/plugins/object-named.ts",
+ "<rootDir>/layer2/plugins/override-test.ts",
+ "<rootDir>/plugins/00.plugin.ts",
+ "<rootDir>/plugins/object-named.ts",
+ ]
+ `)
+ })
+
+ it('resolves layer middleware in correct order', async () => {
+ const app = await getResolvedApp([
+ // layer 1
+ 'layer1/middleware/global.global.ts',
+ 'layer1/middleware/named-from-layer.ts',
+ 'layer1/middleware/named-override.ts',
+ 'layer1/nuxt.config.ts',
+ // layer 2
+ 'layer2/middleware/global.global.ts',
+ 'layer2/middleware/named-from-layer.ts',
+ 'layer2/middleware/named-override.ts',
+ 'layer2/plugins/override-test.ts',
+ 'layer2/nuxt.config.ts',
+ // final (user) layer
+ 'middleware/named-override.ts',
+ 'middleware/named.ts',
+ {
+ name: 'nuxt.config.ts',
+ contents: 'export default defineNuxtConfig({ extends: [\'./layer2\', \'./layer1\'] })',
+ },
+ ])
+ const fixtureMiddleware = app.middleware.filter(p => p.path.includes('<rootDir>')).map(p => p.path)
+ // TODO: fix this
+ expect(fixtureMiddleware).toMatchInlineSnapshot(`
+ [
+ "<rootDir>/layer2/middleware/global.global.ts",
+ "<rootDir>/layer2/middleware/named-from-layer.ts",
+ "<rootDir>/middleware/named-override.ts",
+ "<rootDir>/middleware/named.ts",
+ ]
+ `)
+ })
+
+ it('resolves layer layouts correctly', async () => {
+ const app = await getResolvedApp([
+ // layer 1
+ 'layer1/layouts/default.vue',
+ 'layer1/layouts/layer.vue',
+ 'layer1/nuxt.config.ts',
+ // layer 2
+ 'layer2/layouts/default.vue',
+ 'layer2/layouts/layer.vue',
+ 'layer2/nuxt.config.ts',
+ // final (user) layer
+ 'layouts/default.vue',
+ {
+ name: 'nuxt.config.ts',
+ contents: 'export default defineNuxtConfig({ extends: [\'./layer2\', \'./layer1\'] })',
+ },
+ ])
+ expect(app.layouts).toMatchInlineSnapshot(`
+ {
+ "default": {
+ "file": "<rootDir>/layouts/default.vue",
+ "name": "default",
+ },
+ "layer": {
+ "file": "<rootDir>/layer2/layouts/layer.vue",
+ "name": "layer",
+ },
+ }
+ `)
+ })
+
+ it('resolves nested layouts correctly', async () => {
+ const app = await getResolvedApp([
+ 'layouts/default.vue',
+ 'layouts/some/layout.vue',
+ 'layouts/SomeOther.vue',
+ 'layouts/SomeOther/Thing/Index.vue',
+ 'layouts/thing/thing/thing.vue',
+ 'layouts/desktop-base/base.vue',
+ 'layouts/some.vue',
+ 'layouts/SomeOther/layout.ts',
+ ])
+ expect(app.layouts).toMatchInlineSnapshot(`
+ {
+ "default": {
+ "file": "<rootDir>/layouts/default.vue",
+ "name": "default",
+ },
+ "desktop-base": {
+ "file": "<rootDir>/layouts/desktop-base/base.vue",
+ "name": "desktop-base",
+ },
+ "some": {
+ "file": "<rootDir>/layouts/some.vue",
+ "name": "some",
+ },
+ "some-layout": {
+ "file": "<rootDir>/layouts/some/layout.vue",
+ "name": "some-layout",
+ },
+ "some-other": {
+ "file": "<rootDir>/layouts/SomeOther.vue",
+ "name": "some-other",
+ },
+ "some-other-layout": {
+ "file": "<rootDir>/layouts/SomeOther/layout.ts",
+ "name": "some-other-layout",
+ },
+ "some-other-thing": {
+ "file": "<rootDir>/layouts/SomeOther/Thing/Index.vue",
+ "name": "some-other-thing",
+ },
+ "thing": {
+ "file": "<rootDir>/layouts/thing/thing/thing.vue",
+ "name": "thing",
+ },
+ }
+ `)
+ })
+
+ it('does not allow parallel access to freshly created app components', async () => {
+ const rootDir = resolve(repoRoot, 'node_modules/.fixture', randomUUID())
+ await mkdir(join(rootDir, 'app/layouts'), { recursive: true })
+ await mkdir(join(rootDir, 'app/middleware'), { recursive: true })
+ await mkdir(join(rootDir, 'app/plugins'), { recursive: true })
+
+ await writeFile(join(rootDir, 'nuxt.config.ts'), 'export default {}')
+ await writeFile(join(rootDir, 'app/layouts/default.vue'), '<template><div>Default Layout</div></template>')
+ await writeFile(join(rootDir, 'app/middleware/global.global.ts'), 'export default defineNuxtRouteMiddleware(() => {})')
+ await writeFile(join(rootDir, 'app/plugins/my-plugin.ts'), 'export default defineNuxtPlugin(() => {})')
+
+ const nuxt = await loadNuxt({ cwd: rootDir })
+ const _app = createApp(nuxt)
+ const app = new Proxy(_app, {
+ get (target, p, receiver) {
+ return Reflect.get(target, p, receiver)
+ },
+ set (target, p, newValue, receiver) {
+ if (p === 'middleware' || p === 'plugins') {
+ expect(newValue).not.toEqual([])
+ }
+ if (p === 'layouts') {
+ expect(newValue).not.toEqual({})
+ }
+ return Reflect.set(target, p, newValue, receiver)
+ },
+ })
+
+ await resolveApp(nuxt, app)
+
+ await nuxt.close()
+ await rm(rootDir, { recursive: true, force: true })
+ })
+})
+
+async function getResolvedApp (files: Array<string | { name: string, contents: string }>) {
+ const rootDir = resolve(repoRoot, 'node_modules/.fixture', randomUUID())
+ await mkdir(rootDir, { recursive: true })
+ for (const file of files) {
+ const filename = typeof file === 'string' ? join(rootDir, file) : join(rootDir, file.name)
+ await mkdir(dirname(filename), { recursive: true })
+ await writeFile(filename, typeof file === 'string' ? '' : file.contents || '')
+ }
+
+ const nuxt = await loadNuxt({ cwd: rootDir })
+ const app = createApp(nuxt)
+ await resolveApp(nuxt, app)
+
+ const normaliseToRepo = (id?: string | null) =>
+ id?.replace(rootDir, '<rootDir>').replace(repoRoot, '<repoRoot>').replace(/.*node_modules\//, '')
+
+ app.dir = normaliseToRepo(app.dir)!
+
+ const componentKeys = ['rootComponent', 'errorComponent', 'mainComponent'] as const
+ for (const _key of componentKeys) {
+ const key = _key as typeof componentKeys[number]
+ app[key] = normaliseToRepo(app[key])
+ }
+ for (const plugin of app.plugins) {
+ plugin.src = normaliseToRepo(plugin.src)!
+ // @ts-expect-error untyped symbol
+ delete plugin[Symbol.for('nuxt plugin')]
+ }
+ for (const mw of app.middleware) {
+ mw.path = normaliseToRepo(mw.path)!
+ }
+
+ for (const layout of Object.values(app.layouts)) {
+ layout.file = normaliseToRepo(layout.file)!
+ }
+
+ await nuxt.close()
+
+ return app
+}
diff --git a/packages/nuxt/test/auto-imports.test.ts b/packages/nuxt/test/auto-imports.test.ts
new file mode 100644
index 000000000000..6bb07517a55d
--- /dev/null
+++ b/packages/nuxt/test/auto-imports.test.ts
@@ -0,0 +1,232 @@
+import { readFileSync } from 'node:fs'
+import { fileURLToPath } from 'node:url'
+import { describe, expect, it } from 'vitest'
+import { findExports } from 'mlly'
+import * as VueFunctions from 'vue'
+import type { Import } from 'unimport'
+import { createUnimport } from 'unimport'
+import type { Plugin } from 'vite'
+import { registry as scriptRegistry } from '@nuxt/scripts/registry'
+import { TransformPlugin } from '../src/imports/transform.ts'
+import { defaultPresets, scriptsStubsPreset } from '../src/imports/presets.ts'
+
+describe('imports:transform', () => {
+ const imports: Import[] = [
+ { name: 'ref', as: 'ref', from: 'vue' },
+ { name: 'computed', as: 'computed', from: 'bar' },
+ { name: 'foo', as: 'foo', from: 'excluded' },
+ ]
+
+ const ctx = createUnimport({
+ injectAtEnd: true,
+ imports,
+ })
+
+ const transformPlugin = TransformPlugin({ ctx, options: { transform: { exclude: [/node_modules/] } } }).raw({}, { framework: 'rollup' }) as Plugin
+ const transform = async (source: string) => {
+ // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+ const result = await (transformPlugin.transform! as Function).call({ error: null, warn: null } as any, source, '')
+ return typeof result === 'string' ? result : result?.code
+ }
+
+ it('should correct inject', async () => {
+ expect(await transform('const a = ref(0)')).toMatchInlineSnapshot('"import { ref } from \'vue\';\nconst a = ref(0)"')
+ })
+
+ it('should ignore existing imported', async () => {
+ expect(await transform('import { ref } from "foo"; const a = ref(0)')).to.equal(undefined)
+ expect(await transform('import { computed as ref } from "foo"; const a = ref(0)')).to.equal(undefined)
+ expect(await transform('import ref from "foo"; const a = ref(0)')).to.equal(undefined)
+ expect(await transform('import { z as ref } from "foo"; const a = ref(0)')).to.equal(undefined)
+ expect(await transform('let ref = () => {}; const a = ref(0)')).to.equal(undefined)
+ expect(await transform('let { ref } = Vue; const a = ref(0)')).to.equal(undefined)
+ expect(await transform('let [\ncomputed,\nref\n] = Vue; const a = ref(0); const b = ref(0)')).to.equal(undefined)
+ })
+
+ it('should ignore comments', async () => {
+ const result = await transform('// import { computed } from "foo"\n;const a = computed(0)')
+ expect(result).toMatchInlineSnapshot(`
+ "import { computed } from 'bar';
+ // import { computed } from "foo"
+ ;const a = computed(0)"
+ `)
+ })
+
+ it('should exclude files from transform', async () => {
+ expect(await transform('excluded')).toEqual(undefined)
+ })
+})
+
+const excludedNuxtHelpers = ['useHydration', 'useHead', 'useSeoMeta', 'useServerSeoMeta', 'useId']
+
+describe('imports:nuxt', () => {
+ try {
+ const entrypointPath = fileURLToPath(new URL('../src/app/composables/index.ts', import.meta.url))
+ const entrypointContents = readFileSync(entrypointPath, 'utf8')
+
+ const names = findExports(entrypointContents).flatMap(i => i.names || i.name)
+ for (let name of names) {
+ name = name.replace(/\/\*.*\*\//, '').trim()
+ if (excludedNuxtHelpers.includes(name)) {
+ continue
+ }
+ it(`should register ${name} globally`, () => {
+ expect(defaultPresets.flatMap(a => a.from.startsWith('#app/') ? a.imports : [])).to.include(name)
+ })
+ }
+ } catch (e) {
+ it('should import composables', () => {
+ console.error(e)
+ expect(false).toBe(true)
+ })
+ }
+})
+
+const excludedVueHelpers = [
+ // Already globally registered
+ 'defineEmits',
+ 'defineExpose',
+ 'defineModel',
+ 'defineOptions',
+ 'defineProps',
+ 'defineSlots',
+ 'withDefaults',
+ 'stop',
+ //
+ '__esModule',
+ 'devtools',
+ 'EffectScope',
+ 'ReactiveEffect',
+ 'stop',
+ 'assertNumber',
+ 'camelize',
+ 'capitalize',
+ 'normalizeClass',
+ 'normalizeProps',
+ 'normalizeStyle',
+ 'toDisplayString',
+ 'toHandlerKey',
+ 'BaseTransition',
+ 'BaseTransitionPropsValidators',
+ 'Comment',
+ 'Fragment',
+ 'KeepAlive',
+ 'Static',
+ 'Suspense',
+ 'Teleport',
+ 'Text',
+ 'callWithAsyncErrorHandling',
+ 'callWithErrorHandling',
+ 'cloneVNode',
+ 'compatUtils',
+ 'createBlock',
+ 'createCommentVNode',
+ 'createElementBlock',
+ 'createElementVNode',
+ 'createHydrationRenderer',
+ 'createPropsRestProxy',
+ 'createRenderer',
+ 'createSlots',
+ 'createStaticVNode',
+ 'createTextVNode',
+ 'createVNode',
+ 'getTransitionRawChildren',
+ 'guardReactiveProps',
+ 'handleError',
+ 'initCustomFormatter',
+ 'isMemoSame',
+ 'isRuntimeOnly',
+ 'isVNode',
+ 'mergeDefaults',
+ 'mergeModels',
+ 'mergeProps',
+ 'openBlock',
+ 'popScopeId',
+ 'pushScopeId',
+ 'queuePostFlushCb',
+ 'registerRuntimeCompiler',
+ 'renderList',
+ 'renderSlot',
+ 'resolveComponent',
+ 'resolveDirective',
+ 'resolveDynamicComponent',
+ 'resolveFilter',
+ 'resolveTransitionHooks',
+ 'setBlockTracking',
+ 'setDevtoolsHook',
+ 'setTransitionHooks',
+ 'ssrContextKey',
+ 'ssrUtils',
+ 'toHandlers',
+ 'transformVNodeArgs',
+ 'useSSRContext',
+ 'version',
+ 'warn',
+ 'watchPostEffect',
+ 'watchSyncEffect',
+ 'withAsyncContext',
+ 'Transition',
+ 'TransitionGroup',
+ 'VueElement',
+ 'ErrorTypeStrings',
+ 'createApp',
+ 'createSSRApp',
+ 'defineCustomElement',
+ 'defineSSRCustomElement',
+ 'hydrate',
+ 'initDirectivesForSSR',
+ 'render',
+ 'vModelCheckbox',
+ 'vModelDynamic',
+ 'vModelRadio',
+ 'vModelSelect',
+ 'vModelText',
+ 'vShow',
+ 'compile',
+ 'DeprecationTypes',
+ 'ErrorCodes',
+ 'TrackOpTypes',
+ 'TriggerOpTypes',
+ 'useHost',
+ 'hydrateOnVisible',
+ 'hydrateOnMediaQuery',
+ 'hydrateOnInteraction',
+ 'hydrateOnIdle',
+ 'onWatcherCleanup',
+ 'getCurrentWatcher',
+ 'patchProp',
+ 'nodeOps',
+ 'module.exports',
+]
+
+describe('imports:vue', () => {
+ for (const name of Object.keys(VueFunctions)) {
+ if (excludedVueHelpers.includes(name)) {
+ continue
+ }
+ it(`should register ${name} globally`, () => {
+ expect(defaultPresets.find(a => a.from === 'vue')!.imports).toContain(name)
+ })
+ }
+})
+
+describe('imports:nuxt/scripts', async () => {
+ const scripts = await scriptRegistry().then(r => r.map(s => s.import?.name).filter(Boolean))
+ const globalScripts = new Set([
+ 'useScript',
+ 'useScriptEventPage',
+ 'useScriptTriggerElement',
+ 'useScriptTriggerConsent',
+ // registered separately
+ 'useScriptGoogleTagManager',
+ 'useScriptGoogleAnalytics',
+ ])
+ it.each(scriptsStubsPreset.imports)(`should register %s from @nuxt/scripts`, (name) => {
+ if (globalScripts.has(name)) { return }
+
+ expect(scripts).toContain(name)
+ })
+ it.each(scripts)(`should register %s from @nuxt/scripts`, (name) => {
+ expect(scriptsStubsPreset.imports).toContain(name)
+ })
+})
diff --git a/packages/nuxt/test/build-plugins.bench.ts b/packages/nuxt/test/build-plugins.bench.ts
new file mode 100644
index 000000000000..8709761f6f23
--- /dev/null
+++ b/packages/nuxt/test/build-plugins.bench.ts
@@ -0,0 +1,41 @@
+import { rm } from 'node:fs/promises'
+import { afterAll, beforeAll, bench, describe } from 'vitest'
+import { join } from 'pathe'
+import type { Nuxt } from '@nuxt/schema'
+import { build, loadNuxt } from 'nuxt'
+import { findWorkspaceDir } from 'pkg-types'
+
+const repoRoot = await findWorkspaceDir()
+const basicTestFixtureDir = join(repoRoot, 'test/fixtures/minimal')
+
+describe('build', () => {
+ let nuxt: Nuxt
+ beforeAll(async () => {
+ await rm(join(basicTestFixtureDir, 'node_modules/build-plugins/.nuxt'), { recursive: true, force: true })
+ nuxt = await loadNuxt({
+ cwd: basicTestFixtureDir,
+ ready: true,
+ overrides: {
+ buildDir: join(basicTestFixtureDir, 'node_modules/build-plugins/.nuxt'),
+ ssr: false,
+ sourcemap: false,
+ experimental: { clearBuildHooks: false },
+ hooks: {
+ 'build:done': () => {
+ throw new Error('bypass nitro build')
+ },
+ },
+ },
+ })
+ })
+
+ afterAll(() => nuxt?.close())
+
+ bench('initial production build in the minimal test fixture', async () => {
+ await build(nuxt).catch((e) => {
+ if (!e?.toString().includes('bypass nitro build')) {
+ throw e
+ }
+ })
+ })
+})
diff --git a/packages/nuxt/test/build.bench.ts b/packages/nuxt/test/build.bench.ts
new file mode 100644
index 000000000000..6835029c3ae9
--- /dev/null
+++ b/packages/nuxt/test/build.bench.ts
@@ -0,0 +1,33 @@
+import { rm } from 'node:fs/promises'
+import { beforeAll, bench, describe } from 'vitest'
+import { join } from 'pathe'
+import { build, loadNuxt } from 'nuxt'
+import { findWorkspaceDir } from 'pkg-types'
+
+const repoRoot = await findWorkspaceDir()
+const basicTestFixtureDir = join(repoRoot, 'test/fixtures/basic')
+
+describe('build', () => {
+ beforeAll(async () => {
+ await rm(join(basicTestFixtureDir, 'node_modules/build/.nuxt'), { recursive: true, force: true })
+ })
+
+ bench('initial dev server build in the basic test fixture', async () => {
+ await new Promise((resolve) => {
+ loadNuxt({
+ cwd: basicTestFixtureDir,
+ ready: true,
+ overrides: {
+ dev: true,
+ buildDir: join(basicTestFixtureDir, 'node_modules/build/.nuxt'),
+ sourcemap: false,
+ builder: {
+ async bundle (nuxt) {
+ resolve(await nuxt.close())
+ },
+ },
+ },
+ }).then(build)
+ })
+ })
+})
diff --git a/packages/nuxt/test/builder.test.ts b/packages/nuxt/test/builder.test.ts
new file mode 100644
index 000000000000..260c5bedd74c
--- /dev/null
+++ b/packages/nuxt/test/builder.test.ts
@@ -0,0 +1,111 @@
+import { writeFileSync } from 'node:fs'
+import { mkdir, rm } from 'node:fs/promises'
+
+import type { FSWatcher } from 'vite'
+import { join, relative, resolve } from 'pathe'
+import { findWorkspaceDir } from 'pkg-types'
+import { afterAll, beforeEach, describe, expect, it } from 'vitest'
+import { build, loadNuxt } from 'nuxt'
+
+describe('builder:watch', { sequential: true }, async () => {
+ const tmpDir = join(await findWorkspaceDir(), '.test/builder-watch')
+ beforeEach(async () => {
+ await rm(tmpDir, { recursive: true, force: true })
+ await mkdir(join(tmpDir, 'project/node_modules'), { recursive: true })
+ })
+ afterAll(async () => {
+ await rm(tmpDir, { recursive: true, force: true })
+ })
+ const watcherStrategies = ['chokidar', 'chokidar-granular', 'parcel'] as const
+ it.each(watcherStrategies)('should restart Nuxt when a file is added with %s strategy', async (watcher) => {
+ const rootDir = join(tmpDir, 'project')
+ const nuxt = await loadNuxt({
+ cwd: rootDir,
+ ready: true,
+ overrides: {
+ experimental: { watcher },
+ dev: true,
+ watch: ['test', join(rootDir, 'other'), resolve(rootDir, '../higher')],
+ },
+ })
+ let restarts = 0
+ const events: string[] = []
+
+ nuxt.hook('restart', () => { restarts++ })
+ nuxt.hook('builder:watch', (event, path) => {
+ if (event === 'add') {
+ events.push(relative(rootDir, path))
+ }
+ })
+
+ await build(nuxt)
+
+ const watchPromise = new Promise(resolve => nuxt.hooks.hookOnce('builder:watch', resolve))
+ writeFileSync(resolve(rootDir, '../higher'), 'something')
+ writeFileSync(join(rootDir, 'test'), 'something')
+ writeFileSync(join(rootDir, 'other'), 'something')
+ await watchPromise
+
+ await nuxt.close()
+
+ expect.soft(restarts).toBe(3)
+ expect.soft(events.sort()).toStrictEqual([
+ '../higher',
+ 'other',
+ 'test',
+ ])
+ })
+
+ it('should restart Nuxt when a file is added with builder strategy', async () => {
+ const rootDir = join(tmpDir, 'project')
+ const nuxt = await loadNuxt({
+ cwd: rootDir,
+ ready: true,
+ overrides: {
+ experimental: { watcher: 'builder' },
+ dev: true,
+ watch: ['test', join(rootDir, 'other'), resolve(rootDir, '../higher')],
+ },
+ })
+ const targets = new Set(['../higher', 'other', 'test'])
+ const seenAdds = new Set<string>()
+ let resolveAll: () => void
+ const allSeen = new Promise<void>((resolve) => { resolveAll = resolve })
+
+ nuxt.hook('builder:watch', (event, path) => {
+ if (event !== 'add') { return }
+ const rel = relative(rootDir, path)
+ if (targets.has(rel) && !seenAdds.has(rel)) {
+ seenAdds.add(rel)
+ if (seenAdds.size === targets.size) { resolveAll() }
+ }
+ })
+
+ let viteWatcher: FSWatcher | undefined
+ nuxt.hook('vite:serverCreated', (server, { isClient }) => {
+ if (isClient) {
+ viteWatcher = server.watcher
+ }
+ })
+
+ await build(nuxt)
+
+ const watcher = viteWatcher!
+ if (!(watcher as FSWatcher & { _readyEmitted?: boolean })._readyEmitted) {
+ await new Promise<void>(r => watcher.once('ready', r))
+ }
+
+ writeFileSync(resolve(rootDir, '../higher'), 'something')
+ writeFileSync(join(rootDir, 'test'), 'something')
+ writeFileSync(join(rootDir, 'other'), 'something')
+ await allSeen
+
+ await nuxt.close()
+
+ expect.soft([...seenAdds].sort()).toStrictEqual([
+ '../higher',
+ 'other',
+ 'test',
+ ])
+ })
+})
diff --git a/packages/nuxt/test/cache.test.ts b/packages/nuxt/test/cache.test.ts
new file mode 100644
index 000000000000..93f38766bc5d
--- /dev/null
+++ b/packages/nuxt/test/cache.test.ts
@@ -0,0 +1,146 @@
+import { mkdir, readFile, rm, writeFile } from 'node:fs/promises'
+import { existsSync } from 'node:fs'
+
+import { join } from 'pathe'
+import { findWorkspaceDir } from 'pkg-types'
+import { afterAll, beforeEach, describe, expect, it } from 'vitest'
+import { build, loadNuxt } from 'nuxt'
+
+describe('buildCache', { sequential: true, timeout: 120_000 }, async () => {
+ const workspaceDir = await findWorkspaceDir()
+ const tmpDir = join(workspaceDir, '.test/build-cache')
+
+ beforeEach(async () => {
+ await rm(tmpDir, { recursive: true, force: true })
+ await mkdir(join(tmpDir, 'project/node_modules'), { recursive: true })
+ // Create a minimal app.vue so the build has something to compile
+ await writeFile(join(tmpDir, 'project/app.vue'), '<template><div>hello</div></template>')
+ })
+
+ afterAll(async () => {
+ await rm(tmpDir, { recursive: true, force: true })
+ })
+
+ it('should preserve buildId across cached builds', async () => {
+ const rootDir = join(tmpDir, 'project')
+
+ // First build (cache miss) with an explicit buildId
+ const nuxt1 = await loadNuxt({
+ cwd: rootDir,
+ overrides: {
+ buildId: 'preserved-id',
+ experimental: { buildCache: true },
+ dev: false,
+ // Isolate the cache directory to avoid interference from other builds
+ workspaceDir: tmpDir,
+ },
+ })
+ expect(nuxt1.options.buildId).toBe('preserved-id')
+ await build(nuxt1)
+
+ // Read the buildId from the output manifest
+ const manifestDir = join(nuxt1.options.buildDir, 'manifest')
+ const latestJson = JSON.parse(await readFile(join(manifestDir, 'latest.json'), 'utf-8'))
+ expect(latestJson.id).toBe('preserved-id')
+
+ // Second build (cache hit) — provide a DIFFERENT buildId to prove the
+ // cached one gets restored over this new one.
+ const nuxt2 = await loadNuxt({
+ cwd: rootDir,
+ overrides: {
+ buildId: 'new-id-should-be-overridden',
+ experimental: { buildCache: true },
+ dev: false,
+ workspaceDir: tmpDir,
+ },
+ })
+
+ // The buildId should have been restored to the cached value before modules
+ // were initialised, overriding the 'new-id-should-be-overridden' value.
+ expect(nuxt2.options.buildId).toBe('preserved-id')
+ expect(nuxt2.options.runtimeConfig.app.buildId).toBe('preserved-id')
+
+ await build(nuxt2)
+
+ // Verify the manifest was written with the preserved buildId
+ const latestJson2 = JSON.parse(await readFile(join(nuxt2.options.buildDir, 'manifest', 'latest.json'), 'utf-8'))
+ expect(latestJson2.id).toBe('preserved-id')
+
+ // Verify the per-build manifest exists
+ const metaFile = join(nuxt2.options.buildDir, 'manifest', 'meta', 'preserved-id.json')
+ expect(existsSync(metaFile)).toBe(true)
+ })
+
+ it('should fire build:done on cache hit', async () => {
+ const rootDir = join(tmpDir, 'project')
+
+ // First build (cache miss)
+ const nuxt1 = await loadNuxt({
+ cwd: rootDir,
+ overrides: {
+ buildId: 'done-test',
+ experimental: { buildCache: true },
+ dev: false,
+ workspaceDir: tmpDir,
+ },
+ })
+ await build(nuxt1)
+
+ // Second build (cache hit) — build:done should fire
+ let buildDoneFired = false
+ const nuxt2 = await loadNuxt({
+ cwd: rootDir,
+ overrides: {
+ buildId: 'done-test-new',
+ experimental: { buildCache: true },
+ dev: false,
+ workspaceDir: tmpDir,
+ hooks: {
+ 'build:done': () => { buildDoneFired = true },
+ },
+ },
+ })
+ await build(nuxt2)
+
+ expect(buildDoneFired).toBe(true)
+ })
+
+ it('should generate a new buildId when sources change', async () => {
+ const rootDir = join(tmpDir, 'project')
+
+ // First build with explicit buildId
+ const nuxt1 = await loadNuxt({
+ cwd: rootDir,
+ overrides: {
+ buildId: 'build-1',
+ experimental: { buildCache: true },
+ dev: false,
+ workspaceDir: tmpDir,
+ },
+ })
+ await build(nuxt1)
+
+ // Change app.vue to invalidate the cache
+ await writeFile(join(rootDir, 'app.vue'), '<template><div>updated</div></template>')
+
+ // Second build with a different explicit buildId (cache miss due to source change)
+ const nuxt2 = await loadNuxt({
+ cwd: rootDir,
+ overrides: {
+ buildId: 'build-2',
+ experimental: { buildCache: true },
+ dev: false,
+ workspaceDir: tmpDir,
+ },
+ })
+
+ // buildId should NOT be restored to 'build-1' because the sources changed
+ // (different hash means the .buildid file from the first build doesn't match)
+ expect(nuxt2.options.buildId).toBe('build-2')
+ await build(nuxt2)
+
+ // Verify manifest uses the new buildId
+ const latestJson = JSON.parse(await readFile(join(nuxt2.options.buildDir, 'manifest', 'latest.json'), 'utf-8'))
+ expect(latestJson.id).toBe('build-2')
+ })
+})
diff --git a/packages/nuxt/test/compiler.test.ts b/packages/nuxt/test/compiler.test.ts
new file mode 100644
index 000000000000..60bd906d88ee
--- /dev/null
+++ b/packages/nuxt/test/compiler.test.ts
@@ -0,0 +1,811 @@
+import { afterEach, assert, beforeEach, describe, expect, expectTypeOf, it, vi } from 'vitest'
+import { defineKeyedFunctionFactory } from '../src/compiler/runtime'
+import {
+ type ExportMetadata,
+ type FunctionCallMetadata,
+ parseStaticExportIdentifiers,
+ parseStaticFunctionCall,
+} from '../src/core/utils/parse-utils.ts'
+import { createScanPluginContext } from '../src/compiler/utils.ts'
+import * as oxcWalker from 'oxc-walker'
+import { ScopeTracker, parseAndWalk } from 'oxc-walker'
+import type { ESTree } from 'rolldown/utils'
+
+vi.mock('oxc-walker', async importOriginal => ({ ...await importOriginal() }))
+
+function transformFactory<T extends (...args: any[]) => any> (factory: T): T {
+ return (factory as unknown as { __nuxt_factory: T }).__nuxt_factory
+}
+
+describe('defineKeyedFunctionFactory', () => {
+ const fn = (a: string, b: number): string => {
+ return `${a}-${b}-value`
+ }
+
+ it('should produce factory that throws an error in dev when not transformed', () => {
+ // mock import.meta.dev to `true`
+ vi.stubGlobal('__TEST_DEV__', true)
+
+ const factory = defineKeyedFunctionFactory({
+ name: 'createUseFetch',
+ factory: fn,
+ })
+
+ expect(() => factory('a', 1)).toThrowErrorMatchingInlineSnapshot(`[Error: [nuxt:compiler] \`createUseFetch\` is a compiler macro that is only usable inside the directories scanned by the Nuxt compiler as an exported function and imported statically. Learn more: \`https://nuxt.com/docs/4.x/api/composables/create-use-fetch\`]`)
+
+ vi.unstubAllGlobals()
+ })
+
+ it('should produce factory that throws in production when not transformed', () => {
+ const factory = defineKeyedFunctionFactory({
+ name: 'createUseFetch',
+ factory: fn,
+ })
+
+ expect(() => factory('a', 1)).toThrowErrorMatchingInlineSnapshot(`[Error: [nuxt] \`createUseFetch\` is a compiler macro and cannot be called at runtime.]`)
+ })
+
+ it('should have a non-enumerable `__nuxt_factory` property', () => {
+ const fn = (a: string): string => a
+
+ const factory = defineKeyedFunctionFactory({
+ name: 'testFactory',
+ factory: fn,
+ })
+
+ const descriptor = Object.getOwnPropertyDescriptor(factory, '__nuxt_factory')
+
+ // property descriptor checks
+ expect(descriptor).toBeDefined()
+ expect(descriptor?.enumerable).toBe(false)
+ expect(descriptor?.get?.()).toBe(fn)
+
+ // sanity check
+ expect(Object.keys(factory)).not.toContain('__nuxt_factory')
+ })
+
+ it('should return the factory function when transformed', () => {
+ const factory = defineKeyedFunctionFactory({
+ name: 'createUseFetch',
+ factory: fn,
+ })
+
+ const transformedFactory = transformFactory(factory)
+
+ expect(transformedFactory).toBeDefined()
+ expect(typeof transformedFactory).toBe('function')
+ expect(transformedFactory.length).toBe(fn.length)
+ expect(transformedFactory('a', 1)).toBe('a-1-value')
+ })
+
+ it('should not catch errors from the factory function', () => {
+ const errorFn = () => {
+ throw new Error('Factory error')
+ }
+ const factory = defineKeyedFunctionFactory({
+ name: 'errorFactory',
+ factory: errorFn,
+ })
+
+ const transformedFactory = transformFactory(factory)
+
+ expect(() => transformedFactory()).toThrow('Factory error')
+ })
+
+ it('should preserve parameter and return types', () => {
+ type Args = [id: string, label: string, options?: { silent?: boolean }]
+ type Ret = { id: number, label: string, ok: true }
+
+ const fn = (..._args: Args): Ret => {
+ return undefined as unknown as Ret
+ }
+
+ const factory = defineKeyedFunctionFactory({
+ name: 'createUseFetch',
+ factory: fn,
+ })
+
+ // callable type
+ expectTypeOf(factory).not.toBeAny()
+ expectTypeOf(factory).toEqualTypeOf<typeof fn>()
+ expectTypeOf(factory).parameters.toEqualTypeOf<Args>()
+ expectTypeOf(factory).returns.toEqualTypeOf<Ret>()
+ })
+
+ it('should work with generics in the real factory', () => {
+ const fn = <T extends { id: string }>(entity: T, flag: boolean) => {
+ return { entity, flag, kind: 'ok' as const }
+ }
+
+ const generic = defineKeyedFunctionFactory({
+ name: 'createGeneric',
+ factory: fn,
+ })
+
+ // check that generics are preserved on call signature
+ expectTypeOf(generic).toBeCallableWith({ id: 'x' }, true)
+
+ // parameter and return types stay generic
+ expectTypeOf(generic).parameter(0).toEqualTypeOf<{ id: string }>()
+
+ // verify generics work through the transformed factory
+ const transformed = transformFactory(generic)
+ expectTypeOf(transformed<{ id: 'a' }>({ id: 'a' }, true)).toMatchObjectType<{ entity: { id: 'a' }, flag: boolean, kind: 'ok' }>()
+ })
+})
+
+describe('createScanPluginContext', () => {
+ const code = `
+ const a: number = 1
+ `
+
+ describe('mocked `oxc-walker`', () => {
+ let parseAndWalkSpy: ReturnType<typeof vi.fn>
+ let walkSpy: ReturnType<typeof vi.fn>
+
+ beforeEach(() => {
+ parseAndWalkSpy = vi.spyOn(oxcWalker, 'parseAndWalk').mockReturnValue({ program: {} } as any) as any
+ walkSpy = vi.spyOn(oxcWalker, 'walk').mockImplementation((() => {}) as any) as any
+ })
+
+ afterEach(() => {
+ vi.restoreAllMocks()
+ })
+
+ it('should generate context', () => {
+ const context = createScanPluginContext(code, 'file.ts')
+
+ expect(context).toBeDefined()
+ expect(context).toHaveProperty('walkParsed')
+ expect(typeof context.walkParsed).toBe('function')
+ })
+
+ it('should call `parseAndWalk` on first `walkParsed` call', () => {
+ const enterCallback = { enter: vi.fn() }
+ const mockParseResult = { program: {} }
+
+ parseAndWalkSpy.mockReturnValue(mockParseResult)
+
+ const context = createScanPluginContext(code, 'file.ts')
+ const result = context.walkParsed(enterCallback)
+
+ expect(parseAndWalkSpy).toHaveBeenCalledWith(code, 'file.ts', enterCallback)
+ expect(result).toBe(mockParseResult)
+ })
+
+ it('should reuse parse result and call `walk` on subsequent `walkParsed` calls', () => {
+ const firstCallback = { enter: vi.fn() }
+ const secondCallback = { enter: vi.fn() }
+ const mockParseResult = { program: {} }
+
+ parseAndWalkSpy.mockReturnValue(mockParseResult)
+
+ const context = createScanPluginContext(code, 'file.ts')
+ context.walkParsed(firstCallback)
+
+ parseAndWalkSpy.mockClear()
+ const result = context.walkParsed(secondCallback)
+
+ expect(parseAndWalkSpy).not.toHaveBeenCalled() // not called again - reused
+ expect(walkSpy).toHaveBeenCalledWith(mockParseResult.program, secondCallback)
+ expect(result).toBe(mockParseResult)
+ })
+ })
+
+ it('should parse and walk the AST and track variables', () => {
+ const code = `const a: number = 1`
+ const nodes: ESTree.Node[] = []
+ const context = createScanPluginContext(code, 'file.ts')
+
+ const scopeTracker = new ScopeTracker()
+ let foundDecl = false
+
+ context.walkParsed({
+ scopeTracker,
+ enter (node) {
+ nodes.push(node)
+ if (node.type === 'Identifier' && node.name === 'a') {
+ const decl = scopeTracker.getDeclaration(node.name)
+ expect(decl?.type).toBe('Variable')
+ foundDecl = true
+ }
+ },
+ })
+
+ // ensure scope tracking worked
+ expect(foundDecl).toBe(true)
+
+ // ensure we walked the AST
+ expect(nodes.length).toBe(7)
+ expect(nodes.some(n => n.type === 'Program')).toBe(true)
+ expect(nodes.some(n => n.type === 'VariableDeclarator')).toBe(true)
+ expect(nodes.some(n => n.type === 'Identifier' && n.name === 'a')).toBe(true)
+ })
+})
+
+describe('parseFunctionCall', () => {
+ function getFirstParsedFunctionCall (code: string, functions: RegExp): FunctionCallMetadata | null {
+ let result: FunctionCallMetadata | null = null
+
+ parseAndWalk(code, 'file.ts', {
+ enter (node) {
+ if (node.type !== 'CallExpression' && node.type !== 'ChainExpression') {
+ return
+ }
+ const res = parseStaticFunctionCall(node, functions)
+ if (res) {
+ result = res
+ this.skip()
+ }
+ },
+ })
+
+ return result
+ }
+
+ function expectFunctionCallMeta (meta: FunctionCallMetadata | null, expected: {
+ name: string
+ namespace?: string | null
+ }) {
+ expect(meta).not.toBeNull()
+ expect(meta?.name).toBe(expected.name)
+ expect(meta?.namespace || null).toBe(expected.namespace || null)
+ if (meta?.node.type === 'Identifier' && !meta.namespace) {
+ expect(meta.node.name).toBe(expected.name)
+ } else if (meta?.node.type === 'MemberExpression') {
+ if (meta.node.property.type === 'Identifier') {
+ expect(meta.node.property.name).toBe(expected.name)
+ } else if (meta.node.property.type === 'Literal') {
+ expect(meta.node.property.value).toBe(expected.name)
+ } else {
+ assert.fail(`Unexpected node property type ${meta.node.property.type}`)
+ }
+ }
+ expect(meta?.callExpression.type).toBe('CallExpression')
+ }
+
+ it('should parse simple function call', () => {
+ const code = `const data = useFetch('key')`
+ const result = getFirstParsedFunctionCall(code, /useFetch/)
+ expectFunctionCallMeta(result, { name: 'useFetch' })
+
+ const code2 = `const data = useFetch()`
+ const result2 = getFirstParsedFunctionCall(code2, /useFetch/)
+ expectFunctionCallMeta(result2, { name: 'useFetch' })
+ })
+
+ it('should parse member call', () => {
+ const code = `const x = factories.createUseFetch()`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expectFunctionCallMeta(result, { name: 'createUseFetch', namespace: 'factories' })
+ })
+
+ it('should parse bracket member call', () => {
+ const code = `const x = factories['createUseFetch']()`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expectFunctionCallMeta(result, { name: 'createUseFetch', namespace: 'factories' })
+ })
+
+ it('should parse optional-chained member call', () => {
+ const code = `const x = factories?.createUseFetch?.()`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expectFunctionCallMeta(result, { name: 'createUseFetch', namespace: 'factories' })
+ })
+
+ it('should parse optional-chained bracket call', () => {
+ const code = `const x = factories?.['createUseFetch']?.()`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expectFunctionCallMeta(result, { name: 'createUseFetch', namespace: 'factories' })
+
+ const code2 = `const x = factories?.['createUseFetch']()`
+ const result2 = getFirstParsedFunctionCall(code2, /createUseFetch/)
+ expectFunctionCallMeta(result2, { name: 'createUseFetch', namespace: 'factories' })
+ })
+
+ it('should parse call with await', () => {
+ const code = `async function f(){ return await createUseFetch() }`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expectFunctionCallMeta(result, { name: 'createUseFetch' })
+ })
+
+ it('should parse optional chain under await', () => {
+ const code = `async function f(){ return await factories?.createUseFetch?.() }`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expectFunctionCallMeta(result, { name: 'createUseFetch', namespace: 'factories' })
+ })
+
+ it('should be robust to global regex (/g) by not relying on lastIndex', () => {
+ const code = `createUseFetch(); createUseFetch();`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/g)
+ expectFunctionCallMeta(result, { name: 'createUseFetch' })
+ })
+
+ it('should parse inside template expressions', () => {
+ const code = 'const s = `${factories.createUseFetch()}`'
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expectFunctionCallMeta(result, { name: 'createUseFetch', namespace: 'factories' })
+ })
+
+ it('should parse chained call result usage', () => {
+ const code = `const y = (factories.createUseFetch())('key')`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expectFunctionCallMeta(result, { name: 'createUseFetch', namespace: 'factories' })
+ })
+
+ it('should handle parenthesized callee', () => {
+ const code = `(createUseFetch)()`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ // callee is a ParenthesizedExpression, not Identifier
+ expectFunctionCallMeta(result, { name: 'createUseFetch' })
+ })
+
+ it('should handle parenthesized optional call', () => {
+ const code = `(createUseFetch)?.()`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expectFunctionCallMeta(result, { name: 'createUseFetch' })
+
+ const code2 = `const x = (factories.createUseFetch)?.()`
+ const result2 = getFirstParsedFunctionCall(code2, /createUseFetch/)
+ expectFunctionCallMeta(result2, { name: 'createUseFetch', namespace: 'factories' })
+ })
+
+ it('should handle a TS as-cast callee', () => {
+ const code = `const x = (createUseFetch as any)()`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expectFunctionCallMeta(result, { name: 'createUseFetch' })
+ })
+
+ it('should handle a TS as-cast in member expression object', () => {
+ const code = `const x = (factories as any).createUseFetch()`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expectFunctionCallMeta(result, { name: 'createUseFetch', namespace: 'factories' })
+ })
+
+ it('should handle a TS as-cast wrapping a member expression callee', () => {
+ const code = `const x = (factories.createUseFetch as any)()`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expectFunctionCallMeta(result, { name: 'createUseFetch', namespace: 'factories' })
+ })
+
+ it('should handle a TS non-null assertion callee', () => {
+ const code = `const x = (createUseFetch!)()`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expectFunctionCallMeta(result, { name: 'createUseFetch' })
+ })
+
+ it('should handle a TS non-null assertion in member expression object', () => {
+ const code = `const x = (factories!).createUseFetch()`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expectFunctionCallMeta(result, { name: 'createUseFetch', namespace: 'factories' })
+ })
+
+ it('should handle a TS non-null assertion wrapping a member expression callee', () => {
+ const code = `const x = (factories.createUseFetch!)()`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expectFunctionCallMeta(result, { name: 'createUseFetch', namespace: 'factories' })
+ })
+
+ it('should handle a TS type-assertion in parenthesized expression callee', () => {
+ const code = `const x = (<any>createUseFetch)()`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expectFunctionCallMeta(result, { name: 'createUseFetch' })
+ })
+
+ it('should handle a TS type-assertion in member expression object', () => {
+ const code = `const x = (<any>factories).createUseFetch()`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expectFunctionCallMeta(result, { name: 'createUseFetch', namespace: 'factories' })
+ })
+
+ it('should handle a TS type-assertion wrapping a member expression callee', () => {
+ const code = `const x = (<any>factories.createUseFetch)()`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expectFunctionCallMeta(result, { name: 'createUseFetch', namespace: 'factories' })
+ })
+
+ it('should ignore similar names that do not match the filter', () => {
+ const code = `createUseFetchX(); factories.createUseFetchX(); factories['createUseFetchX']()`
+ const result = getFirstParsedFunctionCall(code, /\bcreateUseFetch\b/)
+ expect(result).toBeNull()
+ })
+
+ it('should work with anchors in filter', () => {
+ const code = `factories.createUseFetch()`
+ const result = getFirstParsedFunctionCall(code, /^createUseFetch$/)
+ expectFunctionCallMeta(result, { name: 'createUseFetch', namespace: 'factories' })
+ })
+
+ it('should handle calling class static methods', () => {
+ const code = `class C{ static createUseFetch(){} } C.createUseFetch()`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expectFunctionCallMeta(result, { name: 'createUseFetch', namespace: 'C' })
+ })
+
+ // non-statically analyzable cases:
+
+ it('should return null for member expression object that is a call', () => {
+ const code = `const x = getFactory().createUseFetch()`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expect(result).toBeNull()
+ })
+
+ it('should return null for multi-level member expression object', () => {
+ const code = `const x = pkg.factories.createUseFetch()`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expect(result).toBeNull()
+ })
+
+ it('should ignore non-matching calls', () => {
+ const code = `fn(); other();`
+ const result = getFirstParsedFunctionCall(code, /doesNotExist/)
+ expect(result).toBeNull()
+ })
+
+ it('should return null for dynamic expression calls', () => {
+ const code = `const x = (ok ? factories.createUseFetch : noop)()`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expect(result).toBeNull()
+ })
+
+ it('should return null for sequence callee', () => {
+ const code = `(0, createUseFetch)()`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expect(result).toBeNull()
+ })
+
+ it('should return null for logical callee', () => {
+ const code = `(ok && createUseFetch)()`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expect(result).toBeNull()
+ })
+
+ it('should return null for conditional callee', () => {
+ const code = `(ok ? createUseFetch : other)()`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expect(result).toBeNull()
+ })
+
+ it('should return null for `this` member object', () => {
+ const code = `this.createUseFetch()`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expect(result).toBeNull()
+ })
+
+ it('should return null for `super` member object', () => {
+ const code = `class A extends B { m(){ super.createUseFetch() } }`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expect(result).toBeNull()
+ })
+
+ it('should return null for private field call', () => {
+ const code = `class X{ #createUseFetch(){}; f(obj){ obj.#createUseFetch() } }`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expect(result).toBeNull()
+ })
+
+ it('should return null for template literal access on namespace', () => {
+ const code = 'const x = factories[`createUseFetch`]()'
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expect(result).toBeNull()
+ })
+
+ it('should return null for computed binary expression access on namespace', () => {
+ const code = 'const x = factories["create" + "UseFetch"]()'
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expect(result).toBeNull()
+ })
+
+ it('should return null for identifier template tag', () => {
+ const code = 'const x = createUseFetch`tagged`'
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ // TaggedTemplateExpression, not CallExpression
+ expect(result).toBeNull()
+ })
+
+ it('should return null for constructor call', () => {
+ const code = `const x = new createUseFetch()`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ // NewExpression, not CallExpression
+ expect(result).toBeNull()
+ })
+
+ it('should return null for dynamic import', () => {
+ const code = `async function f(){ return import('createUseFetch') }`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expect(result).toBeNull()
+ })
+
+ it('should handle identifier inside ChainExpression root', () => {
+ const code = `createUseFetch?.()`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expectFunctionCallMeta(result, { name: 'createUseFetch' })
+ })
+
+ it('should return null for multi-level optional chain: pkg?.factories?.createUseFetch()', () => {
+ const code = `pkg?.factories?.createUseFetch()`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expect(result).toBeNull()
+ })
+
+ it('should return null for call made via bind', () => {
+ const code = `createUseFetch.bind(null)()`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expect(result).toBeNull()
+ })
+
+ it ('should return null for call made via call', () => {
+ const code = `createUseFetch.call(null)`
+ const result = getFirstParsedFunctionCall(code, /createUseFetch/)
+ expect(result).toBeNull()
+ })
+})
+
+describe('parseExport', () => {
+ function getAllParsedExports (code: string, exportedNameFilter?: RegExp) {
+ const results: ExportMetadata[] = []
+
+ parseAndWalk(code, 'file.ts', {
+ enter (node) {
+ if (node.type === 'ExportNamedDeclaration' || node.type === 'ExportDefaultDeclaration' || node.type === 'TSExportAssignment') {
+ results.push(...parseStaticExportIdentifiers(node, exportedNameFilter))
+ }
+ },
+ })
+
+ return results
+ }
+
+ it('should handle named exports', () => {
+ const code = `
+ export const a = 1
+ export let b = 1
+ export var c = 1
+ export function d() {}
+ export class E {}
+ const f = 'f'
+ export const foo = () => {}, bar = () => {}
+ export const baz = (arg1) => {}
+ export { f }
+ const g = 'g'
+ const h = 'h'
+ export { g as renamed, h as default }
+ `
+ expect(getAllParsedExports(code)).toMatchInlineSnapshot(`
+ [
+ {
+ "exportedName": "a",
+ "localName": "a",
+ },
+ {
+ "exportedName": "b",
+ "localName": "b",
+ },
+ {
+ "exportedName": "c",
+ "localName": "c",
+ },
+ {
+ "exportedName": "d",
+ "localName": "d",
+ },
+ {
+ "exportedName": "E",
+ "localName": "E",
+ },
+ {
+ "exportedName": "foo",
+ "localName": "foo",
+ },
+ {
+ "exportedName": "bar",
+ "localName": "bar",
+ },
+ {
+ "exportedName": "baz",
+ "localName": "baz",
+ },
+ {
+ "exportedName": "f",
+ "localName": "f",
+ },
+ {
+ "exportedName": "renamed",
+ "localName": "g",
+ },
+ {
+ "exportedName": "default",
+ "localName": "h",
+ },
+ ]
+ `)
+ })
+
+ it('should filter out named export exported names', () => {
+ const code = `
+ export const a = 1
+ export const _a = 1
+ export let b = 1
+ export let _b = 1
+ export var c = 1
+ export var _c = 1
+ export function d() {}
+ export function _d() {}
+ export class E {}
+ export class _E {}
+ const f = 'f'
+ const _f = 'f'
+ export const foo = () => {}, bar = () => {}
+ export const _foo = () => {}, _bar = () => {}
+ export { f }
+ export { _f }
+ const g = 'g'
+ const _g = 'g'
+ export { _g as renamed }
+ export { g as _renamed }
+ `
+ expect(getAllParsedExports(code, /^(?!_).+/)).toMatchInlineSnapshot(`
+ [
+ {
+ "exportedName": "a",
+ "localName": "a",
+ },
+ {
+ "exportedName": "b",
+ "localName": "b",
+ },
+ {
+ "exportedName": "c",
+ "localName": "c",
+ },
+ {
+ "exportedName": "d",
+ "localName": "d",
+ },
+ {
+ "exportedName": "E",
+ "localName": "E",
+ },
+ {
+ "exportedName": "foo",
+ "localName": "foo",
+ },
+ {
+ "exportedName": "bar",
+ "localName": "bar",
+ },
+ {
+ "exportedName": "f",
+ "localName": "f",
+ },
+ {
+ "exportedName": "renamed",
+ "localName": "_g",
+ },
+ ]
+ `)
+ })
+
+ it('should handle default export', () => {
+ expect(getAllParsedExports('export default function foo() {}')).toMatchInlineSnapshot(`
+ [
+ {
+ "exportedName": "default",
+ "localName": "foo",
+ },
+ ]
+ `)
+ expect(getAllParsedExports('export default class Foo {}')).toMatchInlineSnapshot(`
+ [
+ {
+ "exportedName": "default",
+ "localName": "Foo",
+ },
+ ]
+ `)
+ expect(getAllParsedExports('export default () => {}')).toMatchInlineSnapshot(`[]`)
+ expect(getAllParsedExports('const foo = \'foo\'; export default foo')).toMatchInlineSnapshot(`
+ [
+ {
+ "exportedName": "default",
+ "localName": "foo",
+ },
+ ]
+ `)
+ expect(getAllParsedExports('const foo = \'foo\'; export = foo')).toMatchInlineSnapshot(`
+ [
+ {
+ "exportedName": "default",
+ "localName": "foo",
+ },
+ ]
+ `)
+ })
+
+ it('shouldn\'t filter default export local name', () => {
+ const code = `
+ const _default = 'default'
+ export { _default as default }
+ `
+ expect(getAllParsedExports(code, /^(?!_).+/)).toMatchInlineSnapshot(`
+ [
+ {
+ "exportedName": "default",
+ "localName": "_default",
+ },
+ ]
+ `)
+
+ const code2 = `
+ function _foo() {}
+ export default _foo
+ `
+ expect(getAllParsedExports(code2, /^(?!_).+/)).toMatchInlineSnapshot(`
+ [
+ {
+ "exportedName": "default",
+ "localName": "_foo",
+ },
+ ]
+ `)
+
+ const code3 = `
+ class _Bar {}
+ export default _Bar
+ `
+ expect(getAllParsedExports(code3, /^(?!_).+/)).toMatchInlineSnapshot(`
+ [
+ {
+ "exportedName": "default",
+ "localName": "_Bar",
+ },
+ ]
+ `)
+
+ const code4 = `
+ export default function _baz() {}
+ `
+ expect(getAllParsedExports(code4, /^(?!_).+/)).toMatchInlineSnapshot(`
+ [
+ {
+ "exportedName": "default",
+ "localName": "_baz",
+ },
+ ]
+ `)
+ })
+
+ it('should ignore non-supported exports', () => {
+ const code = `
+ export const { a, b } = obj
+ export const [x, y] = arr
+ export default 42
+ export { a + b as sum }
+ export * from 'module'
+ export { a } from 'module'
+ `
+ expect(getAllParsedExports(code)).toMatchInlineSnapshot(`[]`)
+ })
+
+ it('should ignore non-export nodes', () => {
+ const code = `
+ import { x } from 'module'
+ const a = 1
+ function f() {}
+ class C {}
+ `
+ expect(getAllParsedExports(code)).toMatchInlineSnapshot(`[]`)
+ })
+
+ it('ignores type-exports', () => {
+ const code = `
+ export type T = { a: number }
+ export interface I { b: string }
+ type U = number | string
+ export type { U }
+ export type { U as V }
+ export { type U }
+ export { type U as V }
+ `
+ expect(getAllParsedExports(code)).toMatchInlineSnapshot(`[]`)
+ })
+})
diff --git a/packages/nuxt/test/component-layer-priority.test.ts b/packages/nuxt/test/component-layer-priority.test.ts
new file mode 100644
index 000000000000..1aa72d742da7
--- /dev/null
+++ b/packages/nuxt/test/component-layer-priority.test.ts
@@ -0,0 +1,56 @@
+import { fileURLToPath } from 'node:url'
+import { normalize } from 'pathe'
+import { withoutTrailingSlash } from 'ufo'
+import { describe, expect, it } from 'vitest'
+import { loadNuxt } from '../src/index.ts'
+import { buildNuxt } from '@nuxt/kit'
+import type { ComponentsDir } from 'nuxt/schema'
+
+const layerFixtureDir = withoutTrailingSlash(normalize(fileURLToPath(new URL('./layers-fixture', import.meta.url))))
+
+describe('components layer priority', () => {
+ it('assigns priorities to component dirs based on layer order', async () => {
+ const captured: ComponentsDir[] = []
+
+ const nuxt = await loadNuxt({
+ cwd: layerFixtureDir,
+ ready: true,
+ overrides: {
+ builder: {
+ bundle: () => {
+ nuxt.hooks.removeAllHooks()
+ return Promise.resolve()
+ },
+ },
+ },
+ })
+
+ nuxt.hook('components:dirs', (dirs) => {
+ captured.push(...dirs as any[])
+ })
+
+ await buildNuxt(nuxt)
+
+ const dirs = captured.map(dir => [
+ dir.path.replace(layerFixtureDir, '<root>'),
+ dir.priority,
+ ])
+
+ expect(Object.fromEntries(dirs)).toStrictEqual({
+ // user project: highest priority
+ '<root>/components': 3,
+ '<root>/components/global': 3,
+ '<root>/components/islands': 3,
+ // local layer
+ '<root>/layers/auto/components': 2,
+ '<root>/layers/auto/components/global': 2,
+ '<root>/layers/auto/components/islands': 2,
+ // explicitly extended layer
+ '<root>/custom/components': 1,
+ '<root>/custom/components/global': 1,
+ '<root>/custom/components/islands': 1,
+ })
+
+ await nuxt.close()
+ })
+})
diff --git a/packages/nuxt/test/component-loader.test.ts b/packages/nuxt/test/component-loader.test.ts
new file mode 100644
index 000000000000..386b17dce9dc
--- /dev/null
+++ b/packages/nuxt/test/component-loader.test.ts
@@ -0,0 +1,350 @@
+import { describe, expect, it } from 'vitest'
+import { kebabCase, pascalCase } from 'scule'
+import { rolldown } from 'rolldown'
+import vuePlugin from '@vitejs/plugin-vue'
+import vuePluginJsx from '@vitejs/plugin-vue-jsx'
+import type { AddComponentOptions } from '@nuxt/kit'
+import { LoaderPlugin } from '../src/components/plugins/loader.ts'
+import { LazyHydrationTransformPlugin } from '../src/components/plugins/lazy-hydration-transform.ts'
+
+describe('components:loader', () => {
+ it('should correctly resolve components', async () => {
+ const sfc = `
+ <template>
+ <MyComponent />
+ <LazyMyComponent />
+ <RouterLink />
+ <NamedComponent />
+ </template>
+
+ <script setup>
+ const NamedComponent = resolveComponent('MyComponent')
+ </script>
+ `
+ const code = await transform(sfc, '/pages/index.vue')
+ expect(normalizeCode(code)).toMatchInlineSnapshot(`
+ "import __nuxt_component_0 from "/components/MyComponent.vue";
+ import { Fragment, createElementBlock, createVNode, defineAsyncComponent, openBlock, resolveComponent, unref } from "vue";
+ //#region /pages/index.vue
+ const __nuxt_component_0_lazy = defineAsyncComponent(() => import("/components/MyComponent.vue").then((c) => c.default || c));
+ const _sfc_main = {
+ __name: "index",
+ setup(__props) {
+ const NamedComponent = __nuxt_component_0;
+ return (_ctx, _cache) => {
+ const _component_MyComponent = __nuxt_component_0;
+ const _component_LazyMyComponent = __nuxt_component_0_lazy;
+ const _component_RouterLink = resolveComponent("RouterLink");
+ return openBlock(), createElementBlock(Fragment, null, [
+ createVNode(_component_MyComponent),
+ createVNode(_component_LazyMyComponent),
+ createVNode(_component_RouterLink),
+ createVNode(unref(NamedComponent))
+ ], 64);
+ };
+ }
+ };
+ //#endregion
+ export { _sfc_main as default };"
+ `)
+ })
+
+ it('should correctly resolve components with minifyWhitespace (esbuild) #32290', async () => {
+ const content = `import { createHotContext as __vite__createHotContext } from "/_nuxt/@vite/client";import.meta.hot = __vite__createHotContext("/app.vue");import { recordPosition as _tracerRecordPosition } from "vite-plugin-vue-tracer/dist/client/record.mjs"
+import{defineComponent as _defineComponent}from"vue";const _sfc_main=_defineComponent({__name:"app",setup(__props,{expose:__expose}){__expose();console.log("111");const __returned__={};Object.defineProperty(__returned__,"__isScriptSetup",{enumerable:false,value:true});return __returned__}});import{resolveComponent as _resolveComponent,createVNode as _createVNode,openBlock as _openBlock,createElementBlock as _createElementBlock}from"/_nuxt/node_modules/.pnpm/vue@3.5.16_typescript@5.8.3/node_modules/vue/dist/vue.runtime.esm-bundler.js?v=cbc061e8";function _sfc_render(_ctx,_cache,$props,$setup,$data,$options){const _component_NuxtRouteAnnouncer=_resolveComponent("MyComponent");const _component_NuxtWelcome=_resolveComponent("MyComponent");return _openBlock(),_tracer(2,2,_createElementBlock("div",null,[_tracer(3,4,_createVNode(_component_NuxtRouteAnnouncer)),_tracer(4,4,_createVNode(_component_NuxtWelcome))]))}_sfc_main.__hmrId="938b83b0";typeof __VUE_HMR_RUNTIME__!=="undefined"&&__VUE_HMR_RUNTIME__.createRecord(_sfc_main.__hmrId,_sfc_main);import.meta.hot.on("file-changed",({file})=>{__VUE_HMR_RUNTIME__.CHANGED_FILE=file});import.meta.hot.accept(mod=>{if(!mod)return;const{default:updated,_rerender_only}=mod;if(_rerender_only){__VUE_HMR_RUNTIME__.rerender(updated.__hmrId,updated.render)}else{__VUE_HMR_RUNTIME__.reload(updated.__hmrId,updated)}});import _export_sfc from"/_nuxt/@id/__x00__plugin-vue:export-helper";export default _export_sfc(_sfc_main,[["render",_sfc_render],["__file","/project/workspace/app.vue"]]);
+
+function _tracer(line, column, vnode) { return _tracerRecordPosition("app.vue", line, column, vnode) }
+`
+ const code = await ((plugin.raw({}, { framework: 'vite' }) as { transform: (code: string, id: string) => { code: string, map?: unknown } | null }).transform(
+ content,
+ '/app.vue',
+ ))
+ expect(code?.map).toBeDefined()
+ delete code?.map
+ expect(code).toMatchInlineSnapshot(`
+ {
+ "code": "import { default as __nuxt_component_0 } from "/components/MyComponent.vue";
+ import { createHotContext as __vite__createHotContext } from "/_nuxt/@vite/client";import.meta.hot = __vite__createHotContext("/app.vue");import { recordPosition as _tracerRecordPosition } from "vite-plugin-vue-tracer/dist/client/record.mjs"
+ import{defineComponent as _defineComponent}from"vue";const _sfc_main=_defineComponent({__name:"app",setup(__props,{expose:__expose}){__expose();console.log("111");const __returned__={};Object.defineProperty(__returned__,"__isScriptSetup",{enumerable:false,value:true});return __returned__}});import{resolveComponent as _resolveComponent,createVNode as _createVNode,openBlock as _openBlock,createElementBlock as _createElementBlock}from"/_nuxt/node_modules/.pnpm/vue@3.5.16_typescript@5.8.3/node_modules/vue/dist/vue.runtime.esm-bundler.js?v=cbc061e8";function _sfc_render(_ctx,_cache,$props,$setup,$data,$options){const _component_NuxtRouteAnnouncer=__nuxt_component_0;const _component_NuxtWelcome=__nuxt_component_0;return _openBlock(),_tracer(2,2,_createElementBlock("div",null,[_tracer(3,4,_createVNode(_component_NuxtRouteAnnouncer)),_tracer(4,4,_createVNode(_component_NuxtWelcome))]))}_sfc_main.__hmrId="938b83b0";typeof __VUE_HMR_RUNTIME__!=="undefined"&&__VUE_HMR_RUNTIME__.createRecord(_sfc_main.__hmrId,_sfc_main);import.meta.hot.on("file-changed",({file})=>{__VUE_HMR_RUNTIME__.CHANGED_FILE=file});import.meta.hot.accept(mod=>{if(!mod)return;const{default:updated,_rerender_only}=mod;if(_rerender_only){__VUE_HMR_RUNTIME__.rerender(updated.__hmrId,updated.render)}else{__VUE_HMR_RUNTIME__.reload(updated.__hmrId,updated)}});import _export_sfc from"/_nuxt/@id/__x00__plugin-vue:export-helper";export default _export_sfc(_sfc_main,[["render",_sfc_render],["__file","/project/workspace/app.vue"]]);
+
+ function _tracer(line, column, vnode) { return _tracerRecordPosition("app.vue", line, column, vnode) }
+ ",
+ }
+ `)
+
+ expect(code?.code).toContain('__nuxt_component_0')
+ })
+
+ it('should work in jsx', async () => {
+ const component = `
+ import { defineComponent } from 'vue'
+ export default defineComponent({
+ setup () {
+ const NamedComponent = resolveComponent('MyComponent')
+ return () => <div>
+ <MyComponent />
+ <LazyMyComponent />
+ <RouterLink />
+ <NamedComponent />
+ </div>
+ }
+ })
+ `
+ const code = await transform(component, '/pages/about.tsx')
+ expect(normalizeCode(code)).toMatchInlineSnapshot(`
+ "import __nuxt_component_0 from "/components/MyComponent.vue";
+ import { createVNode, defineAsyncComponent, defineComponent, resolveComponent } from "vue";
+ //#region /pages/about.tsx
+ const __nuxt_component_0_lazy = defineAsyncComponent(() => import("/components/MyComponent.vue").then((c) => c.default || c));
+ var about_default = /* @__PURE__ */ defineComponent({ setup() {
+ const NamedComponent = __nuxt_component_0;
+ return () => createVNode("div", null, [
+ createVNode(__nuxt_component_0, null, null),
+ createVNode(__nuxt_component_0_lazy, null, null),
+ createVNode(resolveComponent("RouterLink"), null, null),
+ createVNode(NamedComponent, null, null)
+ ]);
+ } });
+ //#endregion
+ export { about_default as default };"
+ `)
+ })
+
+ it('should auto-import deduplicated _resolveComponent calls (#30929)', async () => {
+ // Mimics what `@vue/compiler-sfc` emits for an SFC whose `<script setup lang="jsx">`
+ // block calls `resolveComponent` (via JSX) and whose `<template>` also calls
+ // `resolveComponent`: the second import is suffixed (`_resolveComponent2`) and
+ // the JSX-site is rewritten to `_createVNode(_resolveComponent2("MyComponent"), …)`.
+ const content = `import { resolveComponent as _resolveComponent, createVNode as _createVNode, resolveComponent as _resolveComponent2, createVNode as _createVNode2 } from "vue";
+export default {
+ __name: 'app',
+ setup(__props) {
+ const Jsx = _createVNode2(_resolveComponent2("MyComponent"), null, null);
+ return (_ctx, _cache) => {
+ const _component_OtherComponent = _resolveComponent("OtherComponent");
+ return _createVNode(_component_OtherComponent);
+ };
+ }
+};
+`
+ const code = await ((plugin.raw({}, { framework: 'vite' }) as { transform: (code: string, id: string) => { code: string } | null }).transform(
+ content,
+ '/app.vue?vue&type=script&setup=true&lang.jsx',
+ ))
+ expect(code?.code).toContain('import { default as __nuxt_component_0 } from "/components/MyComponent.vue"')
+ expect(code?.code).toContain('_createVNode2(__nuxt_component_0, null, null)')
+ })
+
+ it('should auto-import JSX components with h() calls', async () => {
+ const component = `
+ import { h } from 'vue'
+ export default {
+ render() {
+ return h('div', [
+ h(MyComponent, { foo: 'bar' }),
+ h(MyComponent, null, 'Hello')
+ ])
+ }
+ }
+ `
+ const code = await transform(component, '/pages/jsx-h.tsx')
+ expect(code).toContain('import __nuxt_component_0 from')
+ expect(code).toContain('/components/MyComponent.vue')
+ expect(code).toContain('h(__nuxt_component_0,')
+ })
+
+ it('should auto-import JSX components in various contexts', async () => {
+ const component = `
+ import { h, defineComponent } from 'vue'
+ export default defineComponent({
+ setup() {
+ return () => h('div', [
+ h(MyComponent),
+ h(MyComponent, {}),
+ h(MyComponent, { prop: true }),
+ h(MyComponent, null, ['children']),
+ ])
+ }
+ })
+ `
+ const code = await transform(component, '/pages/contexts.tsx')
+ expect(code).toContain('import __nuxt_component_0 from')
+ expect(code).toContain('/components/MyComponent.vue')
+ // Should replace all h(MyComponent) instances
+ const matches = code.match(/h\(__nuxt_component_0/g)
+ expect(matches).toHaveLength(4)
+ })
+
+ it('should handle multiple different JSX components', async () => {
+ const component = `
+ import { h } from 'vue'
+ export default {
+ render() {
+ return h('div', [
+ h(MyComponent, { id: 1 }),
+ h(OtherComponent, { id: 2 }),
+ h(MyComponent, { id: 3 })
+ ])
+ }
+ }
+ `
+ const code = await transform(component, '/pages/multiple.tsx')
+ expect(code).toContain('import __nuxt_component_0 from')
+ expect(code).toContain('/components/MyComponent.vue')
+ // MyComponent should appear twice
+ const myComponentMatches = code.match(/h\(__nuxt_component_0/g)
+ expect(myComponentMatches).toHaveLength(2)
+ // OtherComponent should not be replaced (not in components list)
+ expect(code).toContain('h(OtherComponent,')
+ })
+
+ it('should not replace h() calls with lowercase component names', async () => {
+ const component = `
+ import { h } from 'vue'
+ export default {
+ render() {
+ return h('div', [
+ h(myComponent),
+ h(myOtherComponent)
+ ])
+ }
+ }
+ `
+ const code = await transform(component, '/pages/lowercase.tsx')
+ // Should not auto-import lowercase identifiers
+ expect(code).not.toContain('import __nuxt_component')
+ expect(code).toContain('h(myComponent')
+ expect(code).toContain('h(myOtherComponent')
+ })
+
+ it('should handle JSX with lazy components in JSX syntax', async () => {
+ const component = `
+ import { defineComponent } from 'vue'
+ export default defineComponent({
+ setup() {
+ return () => <div>
+ <LazyMyComponent foo="bar" />
+ </div>
+ }
+ })
+ `
+ const code = await transform(component, '/pages/lazy-jsx.tsx')
+ expect(code).toContain('defineAsyncComponent')
+ expect(code).toContain('__nuxt_component_0_lazy')
+ expect(code).toContain('createVNode(__nuxt_component_0_lazy,')
+ })
+
+ it('should correctly resolve lazy hydration components', async () => {
+ const sfc = `
+ <template>
+ <LazyMyComponent :hydrate-on-idle="3000" />
+ <LazyMyComponent :hydrate-on-visible="{threshold: 0.2}" />
+ <LazyMyComponent :hydrate-on-interaction="['click','mouseover']" />
+ <LazyMyComponent hydrate-on-media-query="(max-width: 500px)" />
+ <LazyMyComponent :hydrate-after="3000" />
+ <LazyMyComponent :hydrateAfter="3000" />
+ <LazyMyComponent :hydrate-on-idle>
+ <LazyMyComponent hydrate-when="true" />
+ </LazyMyComponent>
+ <LazyMyComponent hydrate-on-visible />
+ <LazyMyComponent hydrate-never />
+ </template>
+ `
+ const lines = await transform(sfc, '/pages/index.vue').then(r => r.split('\n'))
+ const imports = lines.filter(l => l.startsWith('import'))
+ expect(imports.join('\n')).toMatchInlineSnapshot(`
+ "import { createLazyIdleComponent, createLazyIfComponent, createLazyInteractionComponent, createLazyMediaQueryComponent, createLazyNeverComponent, createLazyTimeComponent, createLazyVisibleComponent } from "/client-runtime.mjs";
+ import { Fragment, createElementBlock, createVNode, openBlock, withCtx } from "vue";"
+ `)
+ const components = lines.filter(l => l.startsWith('const __nuxt_component'))
+ expect(components.join('\n')).toMatchInlineSnapshot(`
+ "const __nuxt_component_0_lazy_idle = createLazyIdleComponent("components/MyComponent.vue", () => import("/components/MyComponent.vue").then((c) => c.default || c));
+ const __nuxt_component_0_lazy_visible = createLazyVisibleComponent("components/MyComponent.vue", () => import("/components/MyComponent.vue").then((c) => c.default || c));
+ const __nuxt_component_0_lazy_event = createLazyInteractionComponent("components/MyComponent.vue", () => import("/components/MyComponent.vue").then((c) => c.default || c));
+ const __nuxt_component_0_lazy_media = createLazyMediaQueryComponent("components/MyComponent.vue", () => import("/components/MyComponent.vue").then((c) => c.default || c));
+ const __nuxt_component_0_lazy_time = createLazyTimeComponent("components/MyComponent.vue", () => import("/components/MyComponent.vue").then((c) => c.default || c));
+ const __nuxt_component_0_lazy_if = createLazyIfComponent("components/MyComponent.vue", () => import("/components/MyComponent.vue").then((c) => c.default || c));
+ const __nuxt_component_0_lazy_never = createLazyNeverComponent("components/MyComponent.vue", () => import("/components/MyComponent.vue").then((c) => c.default || c));"
+ `)
+ })
+
+ it.each([
+ ['hydrate-on-idle', 'createLazyIdleComponent'],
+ ['hydrate-on-visible', 'createLazyVisibleComponent'],
+ ['hydrate-on-interaction', 'createLazyInteractionComponent'],
+ ['hydrate-on-media-query', 'createLazyMediaQueryComponent'],
+ ['hydrate-after', 'createLazyTimeComponent'],
+ ['hydrate-when', 'createLazyIfComponent'],
+ ['hydrate-never', 'createLazyNeverComponent'],
+ ['hydrateOnIdle', 'createLazyIdleComponent'],
+ ['hydrateOnVisible', 'createLazyVisibleComponent'],
+ ['hydrateOnInteraction', 'createLazyInteractionComponent'],
+ ['hydrateOnMediaQuery', 'createLazyMediaQueryComponent'],
+ ['hydrateAfter', 'createLazyTimeComponent'],
+ ['hydrateWhen', 'createLazyIfComponent'],
+ ['hydrateNever', 'createLazyNeverComponent'],
+ ])('should correctly resolve lazy hydration components %s', async (prop, component) => {
+ const sfc = `
+ <template>
+ <LazyMyComponent ${prop} />
+ </template>
+ `
+ const result = await transform(sfc, '/pages/index.vue').then(r => r.split('\n'))
+ expect(result.join('\n')).toContain(component)
+ })
+})
+const components = ([{ name: 'MyComponent', filePath: '/components/MyComponent.vue' }] as AddComponentOptions[]).map(opts => ({
+ export: opts.export || 'default',
+ chunkName: 'components/' + kebabCase(opts.name),
+ global: opts.global ?? false,
+ kebabName: kebabCase(opts.name || ''),
+ pascalName: pascalCase(opts.name || ''),
+ prefetch: false,
+ preload: false,
+ mode: 'all' as const,
+ shortPath: opts.filePath,
+ priority: 0,
+ meta: {},
+ ...opts,
+}))
+
+const plugin = LoaderPlugin({
+ clientDelayedComponentRuntime: '/client-runtime.mjs',
+ serverComponentRuntime: '/server-runtime.mjs',
+ getComponents: () => components,
+ srcDir: '/',
+ mode: 'server',
+})
+
+/** Normalize rolldown output to be stable across different working directories */
+function normalizeCode (code: string) {
+ return code.replace(/\t/g, ' ').replace(/\/\/#region (?:\.\.\/)+/g, '//#region /')
+}
+
+async function transform (code: string, filename: string) {
+ const bundle = await rolldown({
+ input: filename,
+ external: id => id !== filename,
+ plugins: [
+ {
+ name: 'entry',
+ resolveId (id) {
+ if (id === filename) {
+ return id
+ }
+ },
+ load (id) {
+ if (id === filename) {
+ return code
+ }
+ },
+ },
+ LazyHydrationTransformPlugin({ getComponents: () => components }).rolldown(),
+ vuePlugin(),
+ vuePluginJsx(),
+ plugin.rolldown(),
+ ],
+ })
+ const { output: [chunk] } = await bundle.generate({})
+ return chunk.code.trim()
+}
diff --git a/packages/nuxt/test/component-names.test.ts b/packages/nuxt/test/component-names.test.ts
new file mode 100644
index 000000000000..509e3b87119f
--- /dev/null
+++ b/packages/nuxt/test/component-names.test.ts
@@ -0,0 +1,58 @@
+import { describe, expect, it } from 'vitest'
+import type { Component } from '@nuxt/schema'
+import { compileScript, parse } from '@vue/compiler-sfc'
+
+import { ComponentNamePlugin } from '../src/components/plugins/component-names.ts'
+
+describe('component names', () => {
+ const components = [
+ {
+ filePath: 'test.ts',
+ pascalName: 'TestMe',
+ },
+ {
+ filePath: 'test.vue',
+ pascalName: 'TestMe',
+ },
+ ] as [Component, Component]
+
+ const transformPlugin = ComponentNamePlugin({ getComponents: () => components }).raw({}, {} as any) as { transform: { handler: (code: string, id: string) => { code: string } | null } }
+
+ it('should ignore files that are not components ', () => {
+ const res = transformPlugin.transform.handler('export default {}', 'some-other-file.ts')
+ expect(res?.code).toBeUndefined()
+ })
+
+ it('should process simple default exports', () => {
+ const res = transformPlugin.transform.handler('export default {}', 'test.vue')
+ expect(res?.code).toMatchInlineSnapshot(`"export default Object.assign({}, { __name: "TestMe" })"`)
+ })
+
+ it('should add correct default component names', () => {
+ const sfc = `
+<script setup>
+onMounted(() => {
+ window.a = 32
+})
+</script>
+ `
+ const res = compileScript(parse(sfc).descriptor, { id: 'test.vue' })
+ const { code } = transformPlugin.transform.handler(res.content, components[0].filePath) ?? {}
+ expect(code?.trim()).toMatchInlineSnapshot(`
+ "export default Object.assign({
+ setup(__props, { expose: __expose }) {
+ __expose();
+
+ onMounted(() => {
+ window.a = 32
+ })
+
+ const __returned__ = { }
+ Object.defineProperty(__returned__, '__isScriptSetup', { enumerable: false, value: true })
+ return __returned__
+ }
+
+ }, { __name: "TestMe" })"
+ `)
+ })
+})
diff --git a/packages/nuxt/test/components-fixture/components/HelloWorld.vue b/packages/nuxt/test/components-fixture/components/HelloWorld.vue
new file mode 100644
index 000000000000..92f324eb3eac
--- /dev/null
+++ b/packages/nuxt/test/components-fixture/components/HelloWorld.vue
@@ -0,0 +1,5 @@
+<template>
+ <div>
+ This is HelloWorld component!
+ </div>
+</template>
diff --git a/packages/nuxt/test/components-fixture/components/Nuxt3.client.vue b/packages/nuxt/test/components-fixture/components/Nuxt3.client.vue
new file mode 100644
index 000000000000..3ba30acf09f7
--- /dev/null
+++ b/packages/nuxt/test/components-fixture/components/Nuxt3.client.vue
@@ -0,0 +1,7 @@
+<!-- eslint-disable vue/multi-word-component-names -->
+
+<template>
+ <b style="color: #00C58E">
+ From Nuxt 3
+ </b>
+</template>
diff --git a/packages/nuxt/test/components-fixture/components/Nuxt3.server.vue b/packages/nuxt/test/components-fixture/components/Nuxt3.server.vue
new file mode 100644
index 000000000000..3ba30acf09f7
--- /dev/null
+++ b/packages/nuxt/test/components-fixture/components/Nuxt3.server.vue
@@ -0,0 +1,7 @@
+<!-- eslint-disable vue/multi-word-component-names -->
+
+<template>
+ <b style="color: #00C58E">
+ From Nuxt 3
+ </b>
+</template>
diff --git a/packages/nuxt/test/components-fixture/components/client/ComponentWithProps.vue b/packages/nuxt/test/components-fixture/components/client/ComponentWithProps.vue
new file mode 100644
index 000000000000..da711f929e9d
--- /dev/null
+++ b/packages/nuxt/test/components-fixture/components/client/ComponentWithProps.vue
@@ -0,0 +1,11 @@
+<template>
+ <div>
+ Awesome Component count: {{ count }}
+ </div>
+</template>
+
+<script setup lang="ts">
+defineProps<{
+ count?: number
+}>()
+</script>
diff --git a/packages/nuxt/test/components-fixture/components/client/WithClientOnlySetup.vue b/packages/nuxt/test/components-fixture/components/client/WithClientOnlySetup.vue
new file mode 100644
index 000000000000..91710ff08018
--- /dev/null
+++ b/packages/nuxt/test/components-fixture/components/client/WithClientOnlySetup.vue
@@ -0,0 +1,149 @@
+<template>
+ <div>
+ <NotDotClientComponent>
+ <ByeBye />
+ </NotDotClientComponent>
+ <div>
+ <Glob />
+ </div>
+ {{ hello }}
+ <div class="not-client">
+ Hello
+ </div>
+ <DotClientComponent>
+ <HelloWorld />
+ <Glob />
+ <SomeGlob />
+ <SomeIsland />
+ <NotToBeTreeShaken />
+ <ObjectPattern />
+ <ObjectPatternDeclaration />
+ <AutoImportedNotTreeShakenComponent />
+ <AutoImportedComponent />
+ <Halllo />
+ <Both />
+ <AreTreeshaken />
+ </DotClientComponent>
+ <ClientOnly>
+ <div class="should-be-treeshaken">
+ this should not be visible
+ </div>
+ <ClientImport />
+ <Treeshaken />
+ <ResolvedImport />
+ <FromArray />
+ <Please />
+ <Doo />
+ <What />
+ <Deep />
+ <Pattern />
+ <DontRemoveThisSinceItIsUsedInSetup />
+ </ClientOnly>
+ <ButShouldNotBeTreeShaken />
+ <Dont />
+ <That />
+ <NotToBeTreeShaken />
+ <AutoImportedNotTreeShakenComponent />
+ </div>
+</template>
+
+<script setup>
+import { Treeshaken } from 'somepath'
+import HelloWorld from '../HelloWorld.vue'
+import DontRemoveThisSinceItIsUsedInSetup from './ComponentWithProps.vue'
+import { ClientImport, Glob } from '#components'
+import { AreTreeshaken, Both } from '#imports'
+
+const hello = 'world'
+const ByeBye = defineAsyncComponent(() => import('../some-glob.global.vue'))
+
+const NotDotClientComponent = defineAsyncComponent(() => import('../some.island.vue'))
+const SomeIsland = defineAsyncComponent(async () => {
+ if (import.meta.client) {
+ return (await import('../some.island.vue'))
+ }
+
+ return {}
+})
+
+const NotToBeTreeShaken = defineAsyncComponent(async () => {
+ if (import.meta.client) {
+ return (await import('../HelloWorld.vue'))
+ }
+
+ return {}
+})
+
+const { ObjectPattern } = defineAsyncComponent(async () => {
+ if (import.meta.client) {
+ return (await import('../HelloWorld.vue'))
+ }
+
+ return {}
+})
+
+const { ObjectPattern: ObjectPatternDeclaration } = defineAsyncComponent(async () => {
+ if (import.meta.client) {
+ return (await import('../HelloWorld.vue'))
+ }
+
+ return {}
+})
+
+const { ObjectPattern: Halllo, ButShouldNotBeTreeShaken } = defineAsyncComponent(async () => {
+ if (import.meta.client) {
+ return (await import('../HelloWorld.vue'))
+ }
+
+ return {}
+})
+const isThis = {}
+
+const { woooooo, What = isThis } = defineAsyncComponent(async () => {
+ if (import.meta.client) {
+ return (await import('../HelloWorld.vue'))
+ }
+
+ return {}
+})
+
+if (import.meta.client) {
+ // eslint-disable-next-line no-console
+ console.log(woooooo)
+}
+
+const { Deep, assignment: { Pattern = ofComponent } } = defineAsyncComponent(async () => {
+ if (import.meta.client) {
+ return (await import('../HelloWorld.vue'))
+ }
+
+ return {}
+})
+
+const [FromArray] = defineAsyncComponent(async () => {
+ if (import.meta.client) {
+ return (await import('../HelloWorld.vue'))
+ }
+
+ return {}
+})
+
+const [Please, { Dont, Doo }, That] = defineAsyncComponent(async () => {
+ if (import.meta.client) {
+ return (await import('../HelloWorld.vue'))
+ }
+
+ return {}
+})
+
+if (import.meta.client) {
+ // eslint-disable-next-line no-console
+ console.log(DontRemoveThisSinceItIsUsedInSetup.props)
+}
+</script>
+
+<style scoped>
+ .not-client {
+ color: "red";
+ }
+</style>
diff --git a/packages/nuxt/test/components-fixture/components/global/Glob.vue b/packages/nuxt/test/components-fixture/components/global/Glob.vue
new file mode 100644
index 000000000000..76d4486c409a
--- /dev/null
+++ b/packages/nuxt/test/components-fixture/components/global/Glob.vue
@@ -0,0 +1,5 @@
+<template>
+ <div>
+ Global component from folder
+ </div>
+</template>
diff --git a/packages/nuxt/test/components-fixture/components/islands/Isle.vue b/packages/nuxt/test/components-fixture/components/islands/Isle.vue
new file mode 100644
index 000000000000..48b2f5e7bd59
--- /dev/null
+++ b/packages/nuxt/test/components-fixture/components/islands/Isle.vue
@@ -0,0 +1,5 @@
+<template>
+ <div>
+ Island from folder
+ </div>
+</template>
diff --git a/packages/nuxt/test/components-fixture/components/parent-folder/index.server.vue b/packages/nuxt/test/components-fixture/components/parent-folder/index.server.vue
new file mode 100644
index 000000000000..e2e823e6a88a
--- /dev/null
+++ b/packages/nuxt/test/components-fixture/components/parent-folder/index.server.vue
@@ -0,0 +1,5 @@
+<template>
+ <div>
+ Awesome Component
+ </div>
+</template>
diff --git a/packages/nuxt/test/components-fixture/components/same-name/same/Same.vue b/packages/nuxt/test/components-fixture/components/same-name/same/Same.vue
new file mode 100644
index 000000000000..e3f25ea61791
--- /dev/null
+++ b/packages/nuxt/test/components-fixture/components/same-name/same/Same.vue
@@ -0,0 +1,8 @@
+<template>
+ <div>
+ This is Same name component!
+ </div>
+</template>
+
+<script setup>
+</script>
diff --git a/packages/nuxt/test/components-fixture/components/some-glob.global.vue b/packages/nuxt/test/components-fixture/components/some-glob.global.vue
new file mode 100644
index 000000000000..02137b917571
--- /dev/null
+++ b/packages/nuxt/test/components-fixture/components/some-glob.global.vue
@@ -0,0 +1,5 @@
+<template>
+ <div>
+ Global component from suffix
+ </div>
+</template>
diff --git a/packages/nuxt/test/components-fixture/components/some.island.vue b/packages/nuxt/test/components-fixture/components/some.island.vue
new file mode 100644
index 000000000000..9f53eba6f763
--- /dev/null
+++ b/packages/nuxt/test/components-fixture/components/some.island.vue
@@ -0,0 +1,7 @@
+<!-- eslint-disable vue/multi-word-component-names -->
+
+<template>
+ <div>
+ Island defined with suffix
+ </div>
+</template>
diff --git a/packages/nuxt/test/components-transform.test.ts b/packages/nuxt/test/components-transform.test.ts
new file mode 100644
index 000000000000..07ed3da63f1b
--- /dev/null
+++ b/packages/nuxt/test/components-transform.test.ts
@@ -0,0 +1,144 @@
+import { fileURLToPath } from 'node:url'
+import { describe, expect, it } from 'vitest'
+import type { Component, Nuxt } from '@nuxt/schema'
+import { kebabCase } from 'scule'
+import { join, normalize } from 'pathe'
+import { findWorkspaceDir } from 'pkg-types'
+
+import { TransformPlugin } from '../src/components/plugins/transform.ts'
+
+describe('components:transform', () => {
+ it('should transform #components imports', async () => {
+ const transform = createTransformer([
+ createComponent('Foo'),
+ createComponent('Bar', { export: 'Bar' }),
+ ])
+
+ const code = await transform('import { Foo, Bar } from \'#components\'', '/app.vue')
+ expect(code).toMatchInlineSnapshot(`
+ "
+ import Foo from '/Foo.vue';
+ import { Bar } from '/Bar.vue';
+ "
+ `)
+ })
+
+ it('should ignore #components import mapping inside packages that use it internally', async () => {
+ const transform = createTransformer([
+ createComponent('Foo'),
+ createComponent('Bar', { export: 'Bar' }),
+ ])
+
+ const dependency = fileURLToPath(new URL('./package-fixture/root/node_modules/pkg/', import.meta.url))
+ const dependencyFile = join(dependency, 'foo', 'bar', 'baz')
+ const dependencyImports = await transform('import { Internal, Private } from \'#components\'', dependencyFile)
+
+ const externalPackage = fileURLToPath(new URL('./package-fixture/pkg/', import.meta.url))
+ const externalPackageFile = join(externalPackage, 'foo', 'bar', 'baz')
+ const externalPackageImports = await transform('import { Internal, Private } from \'#components\'', externalPackageFile)
+
+ expect(dependencyImports).toMatchInlineSnapshot(`undefined`)
+ expect(externalPackageImports).toMatchInlineSnapshot(`undefined`)
+ })
+
+ it('should correctly resolve server-only components', async () => {
+ const transform = createTransformer([
+ createComponent('Foo', { mode: 'server' }),
+ ])
+
+ const code = await transform('import { Foo, LazyFoo } from \'#components\'', '/app.vue')
+ expect(code).toMatchInlineSnapshot(`
+ "
+ import Foo from '/Foo.vue?nuxt_component=server&nuxt_component_name=Foo&nuxt_component_export=default';
+ import LazyFoo from '/Foo.vue?nuxt_component=server,async&nuxt_component_name=Foo&nuxt_component_export=default';
+ "
+ `)
+
+ expect(await transform('', '/Foo.vue?nuxt_component=server&nuxt_component_name=Foo&nuxt_component_export=default')).toMatchInlineSnapshot(`
+ "import { createServerComponent } from "<repo>/nuxt/src/components/runtime/server-component"
+ export default createServerComponent("Foo")"
+ `)
+ expect(await transform('', '/Foo.vue?nuxt_component=server,async&nuxt_component_name=Foo&nuxt_component_export=default')).toMatchInlineSnapshot(`
+ "import { createServerComponent } from "<repo>/nuxt/src/components/runtime/server-component"
+ export default createServerComponent("Foo")"
+ `)
+ expect(await transform('', '/Foo.vue?nuxt_component=server&nuxt_component_name=Foo&nuxt_component_export=Foo')).toMatchInlineSnapshot(`
+ "import { createServerComponent } from "<repo>/nuxt/src/components/runtime/server-component"
+ export const Foo = createServerComponent("Foo")"
+ `)
+ })
+
+ it('should correctly resolve client-only components', async () => {
+ const transform = createTransformer([
+ createComponent('Foo', { mode: 'client' }),
+ ])
+
+ const code = await transform('import { Foo, LazyFoo } from \'#components\'', '/app.vue')
+ expect(code).toMatchInlineSnapshot(`
+ "
+ import Foo from '/Foo.vue?nuxt_component=client&nuxt_component_name=Foo&nuxt_component_export=default';
+ import LazyFoo from '/Foo.vue?nuxt_component=client,async&nuxt_component_name=Foo&nuxt_component_export=default';
+ "
+ `)
+
+ expect(await transform('', '/Foo.vue?nuxt_component=client&nuxt_component_name=Foo&nuxt_component_export=default')).toMatchInlineSnapshot(`
+ "import { default as __component } from "/Foo.vue";
+ import { createClientOnly } from "#app/components/client-only"
+ export default createClientOnly(__component)"
+ `)
+ expect(await transform('', '/Foo.vue?nuxt_component=client,async&nuxt_component_name=Foo&nuxt_component_export=default')).toMatchInlineSnapshot(`
+ "import { defineAsyncComponent } from "vue"
+ import { createClientOnly } from "#app/components/client-only"
+ export default defineAsyncComponent(() => import("/Foo.vue").then(r => createClientOnly(r["default"] || r.default || r)))"
+ `)
+ expect(await transform('', '/Foo.vue?nuxt_component=client,async&nuxt_component_name=Foo&nuxt_component_export=Foo')).toMatchInlineSnapshot(`
+ "import { defineAsyncComponent } from "vue"
+ import { createClientOnly } from "#app/components/client-only"
+ export const Foo = defineAsyncComponent(() => import("/Foo.vue").then(r => createClientOnly(r["Foo"] || r.default || r)))"
+ `)
+ })
+})
+
+const repoRoot = await findWorkspaceDir()
+
+function createTransformer (components: Component[], mode: 'client' | 'server' | 'all' = 'all') {
+ const stubNuxt = {
+ options: {
+ rootDir: fileURLToPath(new URL('./package-fixture/root/', import.meta.url)),
+ buildDir: '/',
+ sourcemap: {
+ server: false,
+ client: false,
+ },
+ },
+ } as Nuxt
+ const plugins = TransformPlugin(stubNuxt, {
+ mode,
+ getComponents: () => components,
+ serverComponentRuntime: '<repo>/nuxt/src/components/runtime/server-component',
+ }).vite()
+
+ return async (code: string, id: string) => {
+ let transformResult: string | undefined
+ for (const plugin of plugins as any[]) {
+ const result = await plugin.transform.handler(transformResult || code, id)
+ transformResult = (typeof result === 'string' ? result : result?.code) || transformResult
+ }
+ return transformResult?.replaceAll(normalize(repoRoot), '<repo>/')
+ }
+}
+
+function createComponent (pascalName: string, options: Partial<Component> = {}) {
+ return {
+ filePath: `/${pascalName}.vue`,
+ pascalName,
+ export: 'default',
+ chunkName: `components/${pascalName.toLowerCase()}`,
+ kebabName: kebabCase(pascalName),
+ mode: 'all',
+ prefetch: false,
+ preload: false,
+ shortPath: `components/${pascalName}.vue`,
+ ...options,
+ } satisfies Component
+}
diff --git a/packages/nuxt/test/components-tree-shake.test.ts b/packages/nuxt/test/components-tree-shake.test.ts
new file mode 100644
index 000000000000..b9b01bd5eece
--- /dev/null
+++ b/packages/nuxt/test/components-tree-shake.test.ts
@@ -0,0 +1,215 @@
+import { readFileSync } from 'node:fs'
+import path from 'node:path'
+import process from 'node:process'
+import { describe, expect, it, vi } from 'vitest'
+import * as VueCompilerSFC from 'vue/compiler-sfc'
+import type { Plugin } from 'vite'
+import { createLogger } from 'vite'
+import type { Options } from '@vitejs/plugin-vue'
+import _vuePlugin from '@vitejs/plugin-vue'
+import { TreeShakeTemplatePlugin } from '../src/components/plugins/tree-shake.ts'
+import { componentsFixtureDir, normalizeLineEndings } from './utils.ts'
+
+// mock due to differences of results between windows and linux
+vi.spyOn(path, 'relative').mockImplementation((from: string, to: string) => {
+ if (to.includes('SomeComponent')) {
+ return to
+ }
+ return path.resolve(from, to)
+})
+
+function vuePlugin (options: Options) {
+ return {
+ ..._vuePlugin(options),
+ handleHotUpdate () {},
+ configureDevServer () {},
+ }
+}
+
+const WithClientOnly = normalizeLineEndings(readFileSync(path.resolve(componentsFixtureDir, './components/client/WithClientOnlySetup.vue')).toString())
+
+const treeshakeTemplatePlugin = TreeShakeTemplatePlugin({
+ getComponents () {
+ return [{
+ pascalName: 'NotDotClientComponent',
+ kebabName: 'not-dot-client-component',
+ export: 'default',
+ filePath: 'dummypath',
+ shortPath: 'dummypath',
+ chunkName: '123',
+ prefetch: false,
+ preload: false,
+ mode: 'client',
+ }, {
+ pascalName: 'DotClientComponent',
+ kebabName: 'dot-client-component',
+ export: 'default',
+ filePath: 'dummypath',
+ shortPath: 'dummypath',
+ chunkName: '123',
+ prefetch: false,
+ preload: false,
+ mode: 'client',
+ }]
+ },
+}).raw({}, { framework: 'rollup' }) as Plugin
+
+const treeshake = async (source: string): Promise<string> => {
+ // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+ const result = await ((treeshakeTemplatePlugin.transform as any)!.handler as Function)(source, 'test.vue')
+ return typeof result === 'string' ? result : result?.code
+}
+
+async function SFCCompile (name: string, source: string, options: Options, ssr = false): Promise<string> {
+ const plugin = vuePlugin({
+ compiler: VueCompilerSFC,
+ ...options,
+ })
+ // @ts-expect-error Types are not correct as they are too generic
+ plugin.configResolved!({
+ logger: createLogger(),
+ isProduction: options.isProduction,
+ command: 'build',
+ root: process.cwd(),
+ build: { sourcemap: false },
+ define: {},
+ })
+ // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+ const result = await ((plugin.transform as any)!.handler as Function)(source, name, { ssr })
+
+ return typeof result === 'string' ? result : result?.code
+}
+
+const stateToTest: { index: number, name: string, options: Partial<Options & { devServer: { config: { server: any } } }> }[] = [
+ {
+ index: 0,
+ name: 'prod',
+ options: {
+ isProduction: true,
+ },
+ },
+ {
+ index: 1,
+ name: 'dev',
+ options: {
+ isProduction: false,
+ devServer: {
+ config: {
+ // trigger dev behavior
+ server: false,
+ },
+ },
+ },
+ },
+]
+
+describe('treeshake client only in ssr', () => {
+ vi.spyOn(process, 'cwd').mockImplementation(() => '')
+ it.each(stateToTest)(`should treeshake ClientOnly correctly in $name`, async (state) => {
+ // add index to avoid using vite vue plugin cache
+ const clientResult = await SFCCompile(`SomeComponent${state.index}.vue`, WithClientOnly, state.options)
+
+ const ssrResult = await SFCCompile(`SomeComponent${state.index}.vue`, WithClientOnly, state.options, true)
+
+ const treeshaken = await treeshake(ssrResult)
+ const [_, scopeId] = clientResult.match(/['"]__scopeId['"],\s*['"](data-v-[^'"]+)['"]/)!
+
+ // ensure the id is correctly passed between server and client
+ expect(clientResult).toContain(`'__scopeId',"${scopeId}"`)
+ expect(treeshaken).toContain(`<div ${scopeId}>`)
+
+ expect(clientResult).toContain('should-be-treeshaken')
+ expect(treeshaken).not.toContain('should-be-treeshaken')
+
+ expect(treeshaken).not.toContain('import HelloWorld from \'../HelloWorld.vue\'')
+ expect(clientResult).toContain('import HelloWorld from \'../HelloWorld.vue\'')
+
+ expect(treeshaken).not.toContain('import { Treeshaken } from \'somepath\'')
+ expect(clientResult).toContain('import { Treeshaken } from \'somepath\'')
+
+ // remove resolved import
+ expect(treeshaken).not.toContain('const _component_ResolvedImport =')
+ expect(clientResult).toContain('const _component_ResolvedImport =')
+
+ // treeshake multi line variable declaration
+ expect(clientResult).toContain('const SomeIsland = defineAsyncComponent(async () => {')
+ expect(treeshaken).not.toContain('const SomeIsland = defineAsyncComponent(async () => {')
+ expect(treeshaken).not.toContain('return (await import(\'./../some.island.vue\'))')
+ expect(treeshaken).toContain('const NotToBeTreeShaken = defineAsyncComponent(async () => {')
+
+ // treeshake object and array declaration
+ expect(treeshaken).not.toContain('const { ObjectPattern } = await import(\'nuxt.com\')')
+ expect(treeshaken).not.toContain('const { ObjectPattern: ObjectPatternDeclaration } = await import(\'nuxt.com\')')
+ expect(treeshaken).toContain('const { ButShouldNotBeTreeShaken } = defineAsyncComponent(async () => {')
+ expect(treeshaken).toContain('const [ { Dont, }, That] = defineAsyncComponent(async () => {')
+
+ // treeshake object that has an assignment pattern
+ expect(treeshaken).toContain('const { woooooo, } = defineAsyncComponent(async () => {')
+ expect(treeshaken).not.toContain('const { Deep, assignment: { Pattern = ofComponent } } = defineAsyncComponent(async () => {')
+
+ // expect no empty ObjectPattern on treeshaking
+ expect(treeshaken).not.toContain('const { } = defineAsyncComponent')
+ expect(treeshaken).not.toContain('import { } from')
+
+ // expect components used in setup to not be removed
+ expect(treeshaken).toContain('import DontRemoveThisSinceItIsUsedInSetup from \'./ComponentWithProps.vue\'')
+
+ // expect import of ClientImport to be treeshaken but not Glob since it is also used outside <ClientOnly>
+ expect(treeshaken).not.toContain('ClientImport')
+ expect(treeshaken).toContain('import { Glob } from \'#components\'')
+
+ // treeshake .client slot
+ expect(treeshaken).not.toContain('ByeBye')
+ // don't treeshake variables that has the same name as .client components
+ expect(treeshaken).toContain('NotDotClientComponent')
+ expect(treeshaken).not.toContain('(DotClientComponent')
+
+ expect(treeshaken).not.toContain('AutoImportedComponent')
+ expect(treeshaken).toContain('AutoImportedNotTreeShakenComponent')
+
+ expect(treeshaken).not.toContain('Both')
+ expect(treeshaken).not.toContain('AreTreeshaken')
+
+ if (state.options.isProduction === false) {
+ // treeshake at inlined template
+ expect(treeshaken).not.toContain('ssrRenderComponent($setup["HelloWorld"]')
+ expect(treeshaken).toContain('ssrRenderComponent($setup["Glob"]')
+ } else {
+ // treeshake unref
+ expect(treeshaken).not.toContain('ssrRenderComponent(_unref(HelloWorld')
+ expect(treeshaken).toContain('ssrRenderComponent(_unref(Glob')
+ }
+ expect(treeshaken.replace(/data-v-\w{8}/g, 'data-v-one-hash').replace(/scoped=\w{8}/g, 'scoped=one-hash')).toMatchSnapshot()
+ })
+
+ it('should not treeshake reused component #26137', async () => {
+ const treeshaken = await treeshake(`import { resolveComponent as _resolveComponent, withCtx as _withCtx, createVNode as _createVNode } from "vue"
+ import { ssrRenderComponent as _ssrRenderComponent, ssrRenderAttrs as _ssrRenderAttrs } from "vue/server-renderer"
+
+ export function ssrRender(_ctx, _push, _parent, _attrs) {
+ const _component_AppIcon = _resolveComponent("AppIcon")
+ const _component_ClientOnly = _resolveComponent("ClientOnly")
+
+ _push(\`<div\${_ssrRenderAttrs(_attrs)}>\`)
+ _push(_ssrRenderComponent(_component_AppIcon, { name: "caret-left" }, null, _parent))
+ _push(_ssrRenderComponent(_component_ClientOnly, null, {
+ default: _withCtx((_, _push, _parent, _scopeId) => {
+ if (_push) {
+ _push(\`<span\${_scopeId}>TEST</span>\`)
+ _push(_ssrRenderComponent(_component_AppIcon, { name: "caret-up" }, null, _parent, _scopeId))
+ } else {
+ return [
+ _createVNode("span", null, "TEST"),
+ _createVNode(_component_AppIcon, { name: "caret-up" })
+ ]
+ }
+ }),
+ _: 1 /* STABLE */
+ }, _parent))
+ _push(\`</div>\`)
+ }`)
+
+ expect(treeshaken).toContain('resolveComponent("AppIcon")')
+ expect(treeshaken).not.toContain('caret-up')
+ })
+})
diff --git a/packages/nuxt/test/devonly.test.ts b/packages/nuxt/test/devonly.test.ts
new file mode 100644
index 000000000000..ec82e6c9bb67
--- /dev/null
+++ b/packages/nuxt/test/devonly.test.ts
@@ -0,0 +1,83 @@
+import { describe, expect, it } from 'vitest'
+import { DevOnlyPlugin } from '../src/core/plugins/dev-only.ts'
+import { normalizeLineEndings } from './utils.ts'
+
+const pluginVite = DevOnlyPlugin().raw({}, { framework: 'vite' }) as { transform: { handler: (code: string, id: string) => { code: string } | null } }
+
+const viteTransform = async (source: string, id: string) => {
+ // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+ const result = await (pluginVite.transform.handler as Function)(source, id)
+ return typeof result === 'string' ? result : result?.code
+}
+
+describe('test devonly transform ', () => {
+ it('test dev only treeshaking', async () => {
+ const result = await viteTransform(`<template>
+ <div>
+ <LazyDevOnly>
+ <SomeDevOnlyComponent></SomeDevOnlyComponent>
+ </LazyDevOnly>
+ </div>
+ <SomeComponent>
+ <lazy-dev-only>
+ test
+ </lazy-dev-only>
+ </SomeComponent>
+ <div>
+ <DevOnly>
+ <SomeDevOnlyComponent></SomeDevOnlyComponent>
+ </DevOnly>
+ </div>
+ <SomeComponent>
+ <dev-only>
+ test
+ </dev-only>
+ </SomeComponent>
+ </template>`, 'some id')
+
+ expect(normalizeLineEndings(result)).toMatchInlineSnapshot(`
+ "<template>
+ <div>
+
+ </div>
+ <SomeComponent>
+
+ </SomeComponent>
+ <div>
+
+ </div>
+ <SomeComponent>
+
+ </SomeComponent>
+ </template>"
+ `)
+
+ expect(result).not.toContain('dev-only')
+ expect(result).not.toContain('DevOnly')
+ expect(result).not.toContain('lazy-dev-only')
+ expect(result).not.toContain('LazyDevOnly')
+ })
+
+ it('should not remove class -> nuxt#24491', async () => {
+ const source = `<template>
+ <DevOnly>
+ <div class="red">This is red.</div>
+ <template #fallback>
+ <div class="red">This should also be red.</div>
+ </template>
+ </DevOnly>
+ </template>
+ `
+
+ const result = await viteTransform(source, 'some id')
+
+ expect(result).toMatchInlineSnapshot(`
+ "<template>
+
+ <div class="red">This should also be red.</div>
+
+ </template>
+ "
+ `)
+ })
+})
diff --git a/packages/nuxt/test/disabled-modules-fixture/layers/base/layer-module-a.ts b/packages/nuxt/test/disabled-modules-fixture/layers/base/layer-module-a.ts
new file mode 100644
index 000000000000..9372be17d13a
--- /dev/null
+++ b/packages/nuxt/test/disabled-modules-fixture/layers/base/layer-module-a.ts
@@ -0,0 +1,10 @@
+import { defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ meta: {
+ name: 'layer-module-a',
+ },
+ setup (_options, nuxt) {
+ nuxt.options.appConfig.layerModuleA = true
+ },
+})
diff --git a/packages/nuxt/test/disabled-modules-fixture/layers/base/layer-module-b.ts b/packages/nuxt/test/disabled-modules-fixture/layers/base/layer-module-b.ts
new file mode 100644
index 000000000000..cb849bca8e58
--- /dev/null
+++ b/packages/nuxt/test/disabled-modules-fixture/layers/base/layer-module-b.ts
@@ -0,0 +1,11 @@
+import { defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ meta: {
+ name: 'layer-module-b',
+ configKey: 'layerModuleB',
+ },
+ setup (_options, nuxt) {
+ nuxt.options.appConfig.layerModuleB = true
+ },
+})
diff --git a/packages/nuxt/test/disabled-modules-fixture/layers/base/layer-module-c.ts b/packages/nuxt/test/disabled-modules-fixture/layers/base/layer-module-c.ts
new file mode 100644
index 000000000000..80620eccecae
--- /dev/null
+++ b/packages/nuxt/test/disabled-modules-fixture/layers/base/layer-module-c.ts
@@ -0,0 +1,11 @@
+import { defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ meta: {
+ name: 'layer-module-c',
+ configKey: 'layerModuleC',
+ },
+ setup (_options, nuxt) {
+ nuxt.options.appConfig.layerModuleC = true
+ },
+})
diff --git a/packages/nuxt/test/disabled-modules-fixture/layers/base/nuxt.config.ts b/packages/nuxt/test/disabled-modules-fixture/layers/base/nuxt.config.ts
new file mode 100644
index 000000000000..cf6b49646676
--- /dev/null
+++ b/packages/nuxt/test/disabled-modules-fixture/layers/base/nuxt.config.ts
@@ -0,0 +1,7 @@
+export default defineNuxtConfig({
+ modules: [
+ import.meta.dirname + '/layer-module-a',
+ import.meta.dirname + '/layer-module-b',
+ import.meta.dirname + '/layer-module-c',
+ ],
+})
diff --git a/packages/nuxt/test/disabled-modules-fixture/nuxt.config.ts b/packages/nuxt/test/disabled-modules-fixture/nuxt.config.ts
new file mode 100644
index 000000000000..f65a7bf09360
--- /dev/null
+++ b/packages/nuxt/test/disabled-modules-fixture/nuxt.config.ts
@@ -0,0 +1,6 @@
+export default defineNuxtConfig({
+ extends: ['./layers/base'],
+ modules: [
+ import.meta.dirname + '/project-module',
+ ],
+})
diff --git a/packages/nuxt/test/disabled-modules-fixture/project-module.ts b/packages/nuxt/test/disabled-modules-fixture/project-module.ts
new file mode 100644
index 000000000000..b5165ba623e4
--- /dev/null
+++ b/packages/nuxt/test/disabled-modules-fixture/project-module.ts
@@ -0,0 +1,11 @@
+import { defineNuxtModule } from '@nuxt/kit'
+
+export default defineNuxtModule({
+ meta: {
+ name: 'project-module',
+ configKey: 'projectModule',
+ },
+ setup (_options, nuxt) {
+ nuxt.options.appConfig.projectModule = true
+ },
+})
diff --git a/packages/nuxt/test/disabled-modules.test.ts b/packages/nuxt/test/disabled-modules.test.ts
new file mode 100644
index 000000000000..8170346f7865
--- /dev/null
+++ b/packages/nuxt/test/disabled-modules.test.ts
@@ -0,0 +1,130 @@
+import { fileURLToPath } from 'node:url'
+import { describe, expect, it } from 'vitest'
+import { normalize } from 'pathe'
+import { withoutTrailingSlash } from 'ufo'
+import { loadNuxt } from '../src'
+
+const fixtureDir = withoutTrailingSlash(normalize(fileURLToPath(new URL('./disabled-modules-fixture', import.meta.url))))
+
+describe('disable modules with false', () => {
+ it('loads all modules when no module is disabled', async () => {
+ const nuxt = await loadNuxt({
+ cwd: fixtureDir,
+ })
+ await nuxt.close()
+
+ const moduleNames = nuxt.options._installedModules
+ .map(m => m.meta.name ?? m.module.name)
+ .filter(name => name?.startsWith('layer-module') || name?.startsWith('project-module'))
+
+ // All modules should be installed
+ expect(moduleNames).toContain('layer-module-a')
+ expect(moduleNames).toContain('layer-module-b')
+ expect(moduleNames).toContain('layer-module-c')
+ expect(moduleNames).toContain('project-module')
+
+ // All module setups should have run
+ expect(nuxt.options.appConfig.layerModuleA).toBe(true)
+ expect(nuxt.options.appConfig.layerModuleB).toBe(true)
+ expect(nuxt.options.appConfig.layerModuleC).toBe(true)
+ })
+
+ it('disables a single module from layer', async () => {
+ const nuxt = await loadNuxt({
+ cwd: fixtureDir,
+ overrides: {
+ 'layer-module-a': false,
+ } as Record<string, unknown>,
+ })
+ await nuxt.close()
+
+ const moduleNames = nuxt.options._installedModules
+ .map(m => m.meta.name ?? m.module.name)
+ .filter(name => name?.startsWith('layer-module') || name?.startsWith('project-module'))
+
+ // Module is still registered (for type generation)
+ expect(moduleNames).toContain('layer-module-a')
+ expect(moduleNames).toContain('layer-module-b')
+ expect(moduleNames).toContain('layer-module-c')
+ expect(moduleNames).toContain('project-module')
+
+ // But disabled module's setup was NOT executed
+ expect(nuxt.options.appConfig.layerModuleA).toBeUndefined()
+ // Other modules' setup should have run
+ expect(nuxt.options.appConfig.layerModuleB).toBe(true)
+ expect(nuxt.options.appConfig.layerModuleC).toBe(true)
+ })
+
+ it('disables multiple modules from layer', async () => {
+ const nuxt = await loadNuxt({
+ cwd: fixtureDir,
+ overrides: {
+ 'layer-module-a': false,
+ 'layerModuleC': false,
+ } as Record<string, unknown>,
+ })
+ await nuxt.close()
+
+ const moduleNames = nuxt.options._installedModules
+ .map(m => m.meta.name ?? m.module.name)
+ .filter(name => name?.startsWith('layer-module') || name?.startsWith('project-module'))
+
+ // All modules are still registered (for type generation)
+ expect(moduleNames).toContain('layer-module-a')
+ expect(moduleNames).toContain('layer-module-b')
+ expect(moduleNames).toContain('layer-module-c')
+ expect(moduleNames).toContain('project-module')
+
+ // But disabled modules' setup was NOT executed
+ expect(nuxt.options.appConfig.layerModuleA).toBeUndefined()
+ expect(nuxt.options.appConfig.layerModuleC).toBeUndefined()
+ // Other modules' setup should have run
+ expect(nuxt.options.appConfig.layerModuleB).toBe(true)
+ })
+
+ it('disables project modules', async () => {
+ const nuxt = await loadNuxt({
+ cwd: fixtureDir,
+ overrides: {
+ 'projectModule': false,
+ } as Record<string, unknown>,
+ })
+ await nuxt.close()
+
+ const moduleNames = nuxt.options._installedModules
+ .map(m => m.meta.name ?? m.module.name)
+ .filter(name => name?.startsWith('layer-module') || name?.startsWith('project-module'))
+
+ // Project module is still registered (for type generation)
+ expect(moduleNames).toContain('project-module')
+ // But disabled module's setup was NOT executed
+ expect(nuxt.options.appConfig.projectModule).toBeUndefined()
+ })
+
+ it('disables all modules from layer when all are set to false', async () => {
+ const nuxt = await loadNuxt({
+ cwd: fixtureDir,
+ overrides: {
+ 'layer-module-a': false,
+ 'layerModuleB': false,
+ 'layerModuleC': false,
+ } as Record<string, unknown>,
+ })
+ await nuxt.close()
+
+ const moduleNames = nuxt.options._installedModules
+ .map(m => m.meta.name ?? m.module.name)
+ .filter(name => name?.startsWith('layer-module') || name?.startsWith('project-module'))
+
+ // All modules are still registered (for type generation)
+ expect(moduleNames).toContain('layer-module-a')
+ expect(moduleNames).toContain('layer-module-b')
+ expect(moduleNames).toContain('layer-module-c')
+ expect(moduleNames).toContain('project-module')
+
+ // But all disabled modules' setup was NOT executed
+ expect(nuxt.options.appConfig.layerModuleA).toBeUndefined()
+ expect(nuxt.options.appConfig.layerModuleB).toBeUndefined()
+ expect(nuxt.options.appConfig.layerModuleC).toBeUndefined()
+ })
+})
diff --git a/packages/nuxt/test/extract-async-data-handlers.test.ts b/packages/nuxt/test/extract-async-data-handlers.test.ts
new file mode 100644
index 000000000000..3b3e3c99065d
--- /dev/null
+++ b/packages/nuxt/test/extract-async-data-handlers.test.ts
@@ -0,0 +1,347 @@
+import { describe, expect, it } from 'vitest'
+import { ExtractAsyncDataHandlersPlugin } from '../src/core/plugins/extract-async-data-handlers.ts'
+import { clean } from './utils.ts'
+
+describe('extract async data handlers plugin', () => {
+ const defaultOptions = {
+ enabled: true,
+ sourcemap: false,
+ rootDir: '/app',
+ }
+
+ function createTransform (options = defaultOptions) {
+ const plugin = ExtractAsyncDataHandlersPlugin(options).raw({}, { framework: 'rollup' }) as {
+ load: (id: string) => { code: string } | undefined
+ transform: { handler: (code: string, id: string) => { code: string } | undefined }
+ }
+ const fn = (code: string, id = '/app/test.ts') => {
+ const result = plugin.transform.handler(code, id)
+ return result?.code ? clean(result.code) : result?.code
+ }
+ return Object.assign(fn, { load: (id: string) => clean(plugin.load(id)?.code) || undefined })
+ }
+
+ describe('basic functionality', () => {
+ it('should not transform when no async data functions are present', async () => {
+ const transform = createTransform()
+ const code = `
+ const data = ref('hello')
+ const count = computed(() => data.value.length)
+ `
+ const result = await transform(code)
+ expect(result).toBeUndefined()
+ expect(transform.load('/app/async-data-chunk-0.js')).toBeUndefined()
+ })
+ })
+
+ describe('useAsyncData transformation', () => {
+ it('should extract simple arrow function handler', async () => {
+ const transform = createTransform()
+ const code = `
+ const { data } = await useAsyncData('key', async () => {
+ return await $fetch('/api/data')
+ })
+ `
+ const result = await transform(code)
+
+ expect(result).toMatchInlineSnapshot(`"const { data } = await useAsyncData('key', () => import('/app/async-data-chunk-0.js').then(r => (r.default || r)()))"`)
+
+ expect(transform.load('/app/async-data-chunk-0.js')).toMatchInlineSnapshot(
+ `
+ "export default async function () {
+ return await $fetch('/api/data')
+ }"
+ `,
+ )
+ })
+
+ it('should extract function with external variable references', async () => {
+ const transform = createTransform()
+ const code = `
+ const userId = ref(123)
+ const { data } = await useAsyncData('user', async () => {
+ return await $fetch(\`/api/users/\${userId.value}\`)
+ })
+ `
+ const result = await transform(code)
+
+ expect(result).toMatchInlineSnapshot(`
+ "const userId = ref(123)
+ const { data } = await useAsyncData('user', () => import('/app/async-data-chunk-0.js').then(r => (r.default || r)(userId)))"
+ `)
+
+ expect(transform.load('/app/async-data-chunk-0.js')).toMatchInlineSnapshot(
+ `
+ "export default async function (userId) {
+ return await $fetch(\`/api/users/\${userId.value}\`)
+ }"
+ `,
+ )
+ })
+
+ it('should correctly handle variables in scope', async () => {
+ const transform = createTransform()
+ const code = `
+ useAsyncData(async () => {
+ const distTags = {}
+ return [].map(tag => distTags[tag])
+ })
+ `
+ const result = await transform(code)
+ expect(result).toMatchInlineSnapshot(`"useAsyncData(() => import('/app/async-data-chunk-0.js').then(r => (r.default || r)()))"`)
+
+ expect(transform.load('/app/async-data-chunk-0.js')).toMatchInlineSnapshot(
+ `
+ "export default async function () {
+ const distTags = {}
+ return [].map(tag => distTags[tag])
+ }"
+ `,
+ )
+ })
+
+ it('should correctly handle auto-imported functions in scope', async () => {
+ const transform = createTransform()
+ const code = `
+ const { data: page } = await useAsyncData(() => queryCollection('landing').path('/enterprise/jobs').first())
+ `
+ const result = await transform(code)
+ expect(result).toMatchInlineSnapshot(
+ `"const { data: page } = await useAsyncData(() => import('/app/async-data-chunk-0.js').then(r => (r.default || r)()))"`,
+ )
+ expect(transform.load('/app/async-data-chunk-0.js')).toMatchInlineSnapshot(
+ `"export default async function () { return queryCollection('landing').path('/enterprise/jobs').first() }"`,
+ )
+ })
+
+ it('should handle imported functions in handlers', async () => {
+ const transform = createTransform()
+ const code = `
+ import { $fetch } from 'ofetch'
+
+ const { data } = await useAsyncData('key', async () => {
+ return await $fetch('/api/data')
+ })
+ `
+ const result = await transform(code)
+
+ expect(result).toMatchInlineSnapshot(`
+ "import { $fetch } from 'ofetch'
+ const { data } = await useAsyncData('key', () => import('/app/async-data-chunk-0.js').then(r => (r.default || r)()))"
+ `)
+
+ expect(transform.load('/app/async-data-chunk-0.js')).toMatchInlineSnapshot(
+ `
+ "import { $fetch } from 'ofetch'
+ export default async function () {
+ return await $fetch('/api/data')
+ }"
+ `,
+ )
+ })
+
+ it('should handle block statement function bodies', async () => {
+ const transform = createTransform()
+ const code = `
+ const { data } = await useAsyncData('key', async () => {
+ const response = await $fetch('/api/data')
+ return response.data
+ })
+ `
+ const result = await transform(code)
+
+ expect(result).toMatchInlineSnapshot(`"const { data } = await useAsyncData('key', () => import('/app/async-data-chunk-0.js').then(r => (r.default || r)()))"`)
+
+ expect(transform.load('/app/async-data-chunk-0.js')).toMatchInlineSnapshot(
+ `
+ "export default async function () {
+ const response = await $fetch('/api/data')
+ return response.data
+ }"
+ `,
+ )
+ })
+
+ it('should handle expression function bodies', async () => {
+ const transform = createTransform()
+ const code = `
+ const { data } = await useAsyncData('key', async () => $fetch('/api/data'))
+ `
+ const result = await transform(code)
+
+ expect(result).toMatchInlineSnapshot(`"const { data } = await useAsyncData('key', () => import('/app/async-data-chunk-0.js').then(r => (r.default || r)()))"`)
+
+ expect(transform.load('/app/async-data-chunk-0.js')).toMatchInlineSnapshot(
+ `"export default async function () { return $fetch('/api/data') }"`,
+ )
+ })
+ })
+
+ describe('useLazyAsyncData transformation', () => {
+ it('should extract useLazyAsyncData handlers', async () => {
+ const transform = createTransform()
+ const code = `
+ const { data } = await useLazyAsyncData('key', async () => {
+ return await $fetch('/api/data')
+ })
+ `
+ const result = await transform(code)
+
+ expect(result).toMatchInlineSnapshot(`"const { data } = await useLazyAsyncData('key', () => import('/app/async-data-chunk-0.js').then(r => (r.default || r)()))"`)
+
+ expect(transform.load('/app/async-data-chunk-0.js')).toMatchInlineSnapshot(
+ `
+ "export default async function () {
+ return await $fetch('/api/data')
+ }"
+ `,
+ )
+ })
+ })
+
+ describe('edge cases', () => {
+ it('should not transform when handler is not a function', async () => {
+ const transform = createTransform()
+ const code = `
+ const handler = async () => $fetch('/api/data')
+ const { data } = await useAsyncData('key', handler)
+ `
+ const result = await transform(code)
+
+ expect(result).toBeUndefined()
+ expect(transform.load('/app/async-data-chunk-0.js')).toBeUndefined()
+ })
+
+ it('should not transform when no handler is provided', async () => {
+ const transform = createTransform()
+ const code = `
+ const { data } = await useAsyncData('key')
+ `
+ const result = await transform(code)
+
+ expect(result).toBeUndefined()
+ expect(transform.load('/app/async-data-chunk-0.js')).toBeUndefined()
+ })
+
+ it('should handle multiple useAsyncData calls', async () => {
+ const transform = createTransform()
+ const code = `
+ const { data: users } = await useAsyncData('users', async () => {
+ return await $fetch('/api/users')
+ })
+
+ const { data: posts } = await useAsyncData('posts', async () => {
+ return await $fetch('/api/posts')
+ })
+ `
+ const result = await transform(code)
+
+ expect(result).toMatchInlineSnapshot(`
+ "const { data: users } = await useAsyncData('users', () => import('/app/async-data-chunk-0.js').then(r => (r.default || r)()))
+ const { data: posts } = await useAsyncData('posts', () => import('/app/async-data-chunk-1.js').then(r => (r.default || r)()))"
+ `)
+ expect(transform.load('/app/async-data-chunk-0.js')).toMatchInlineSnapshot(`
+ "export default async function () {
+ return await $fetch('/api/users')
+ }"
+ `)
+ expect(transform.load('/app/async-data-chunk-1.js')).toMatchInlineSnapshot(`
+ "export default async function () {
+ return await $fetch('/api/posts')
+ }"
+ `)
+ })
+
+ it('should handle Vue SFC script blocks', async () => {
+ const transform = createTransform()
+ const code = `
+ <template>
+ <div>{{ data }}</div>
+ </template>
+
+ <script setup>
+ const { data } = await useAsyncData('key', async () => {
+ return await $fetch('/api/data')
+ })
+ </script>
+ `
+ const result = await transform(code, '/app/test.vue')
+
+ expect(result).toBeDefined()
+ expect(result).toContain('() => import(')
+ })
+ })
+
+ describe('variable scope handling', () => {
+ it('should not capture property names as variables (regression test for TDZ errors)', async () => {
+ const transform = createTransform()
+ // This test case previously caused TDZ ReferenceError because property names
+ // like "data" in "response.data" or "foo" in "{ foo: 42 }" were incorrectly
+ // treated as variable references and captured as parameters
+ const code = `
+ const { data } = await useAsyncData('test', async () => {
+ const response = await $fetch('/api')
+ const obj = { foo: response.data.bar }
+ return obj.foo
+ })
+ `
+ const result = await transform(code)
+
+ // Should not capture any parameters (no external variable references)
+ expect(result).toMatchInlineSnapshot(
+ `"const { data } = await useAsyncData('test', () => import('/app/async-data-chunk-0.js').then(r => (r.default || r)()))"`,
+ )
+ expect(transform.load('/app/async-data-chunk-0.js')).toMatchInlineSnapshot(`
+ "export default async function () {
+ const response = await $fetch('/api')
+ const obj = { foo: response.data.bar }
+ return obj.foo
+ }"
+ `)
+ })
+
+ it('should capture variables from outer scope', async () => {
+ const transform = createTransform()
+ const code = `
+ const apiUrl = ref('/api/data')
+ const params = { limit: 10 }
+
+ const { data } = await useAsyncData('key', async () => {
+ return await $fetch(apiUrl.value, { query: params })
+ })
+ `
+ const result = await transform(code)
+
+ expect(result).toMatchInlineSnapshot(`
+ "const apiUrl = ref('/api/data')
+ const params = { limit: 10 }
+ const { data } = await useAsyncData('key', () => import('/app/async-data-chunk-0.js').then(r => (r.default || r)(apiUrl, params)))"
+ `)
+
+ expect(transform.load('/app/async-data-chunk-0.js')).toMatchInlineSnapshot(`
+ "export default async function (apiUrl, params) {
+ return await $fetch(apiUrl.value, { query: params })
+ }"
+ `)
+ })
+
+ it('should not capture variables declared within the function', async () => {
+ const transform = createTransform()
+ const code = `
+ const { data } = await useAsyncData('key', async () => {
+ const localVar = 'local'
+ return await $fetch('/api/data', { headers: { 'x-local': localVar } })
+ })
+ `
+ const result = await transform(code)
+
+ expect(result).toMatchInlineSnapshot(`"const { data } = await useAsyncData('key', () => import('/app/async-data-chunk-0.js').then(r => (r.default || r)()))"`)
+ expect(transform.load('/app/async-data-chunk-0.js')).toMatchInlineSnapshot(`
+ "export default async function () {
+ const localVar = 'local'
+ return await $fetch('/api/data', { headers: { 'x-local': localVar } })
+ }"
+ `)
+ })
+ })
+})
diff --git a/packages/nuxt/test/import-protection.test.ts b/packages/nuxt/test/import-protection.test.ts
new file mode 100644
index 000000000000..4c272cfb6a97
--- /dev/null
+++ b/packages/nuxt/test/import-protection.test.ts
@@ -0,0 +1,68 @@
+import { describe, expect, it } from 'vitest'
+import { ImpoundPlugin } from 'impound'
+import { createImportProtectionPatterns } from '../src/core/plugins/import-protection.ts'
+import type { NuxtOptions } from '../schema.ts'
+
+const testsToTriggerOn = [
+ ['~/nuxt.config', 'app.vue', true],
+ ['./nuxt.config', 'app.vue', true],
+ ['./nuxt.config.ts', 'app.vue', true],
+ ['nuxt.config.ts', 'app.vue', true],
+ ['./.nuxt/nuxt.config', 'app.vue', false],
+ ['.nuxt/nuxt.config', 'app.vue', false],
+ ['nuxt', 'components/Component.vue', true],
+ ['nuxt3', 'components/Component.vue', true],
+ ['nuxt-nightly', 'components/Component.vue', true],
+ ['/root/node_modules/@vue/composition-api', 'components/Component.vue', true],
+ ['@vue/composition-api', 'components/Component.vue', true],
+ ['@nuxt/kit', 'components/Component.vue', true],
+ ['nuxt/config', 'components/Component.vue', true],
+ ['nuxt/kit', 'components/Component.vue', true],
+ ['nuxt/schema', 'components/Component.vue', true],
+ ['/root/node_modules/@nuxt/kit', 'components/Component.vue', true],
+ ['some-nuxt-module', 'components/Component.vue', true],
+ ['some-nuxt-module/runtime/something.vue', 'components/Component.vue', false],
+ ['/root/src/server/api/test.ts', 'components/Component.vue', true],
+ ['src/server/api/test.ts', 'components/Component.vue', true],
+ ['node_modules/nitropack/node_modules/crossws/dist/adapters/bun.mjs', 'node_modules/nitropack/dist/presets/bun/runtime/bun.mjs', false],
+ ['nitro/builder', 'components/Component.vue', true],
+ ['nitro/meta', 'components/Component.vue', true],
+ ['nitro/vite', 'components/Component.vue', true],
+ ['nitro/h3', 'components/Component.vue', false],
+ ['nitro/app', 'components/Component.vue', false],
+ ['nitro/runtime-config', 'components/Component.vue', false],
+ ['nitro/types', 'components/Component.vue', false],
+ ['nitro', 'components/Component.vue', false],
+ ['node_modules/some-pkg/server/api/helper.ts', 'components/Component.vue', false],
+] as const
+
+describe('import protection', () => {
+ it.each(testsToTriggerOn)('should protect %s', async (id, importer, isProtected) => {
+ const result = await transformWithImportProtection(id, importer, 'nuxt-app')
+ if (!isProtected) {
+ expect(result).toBeNull()
+ } else {
+ expect(result).toBeDefined()
+ expect(result).toContain('impound:proxy')
+ }
+ })
+})
+
+const transformWithImportProtection = (id: string, importer: string, context: 'nitro-app' | 'nuxt-app' | 'shared') => {
+ const plugin = ImpoundPlugin.rollup({
+ cwd: '/root',
+ patterns: createImportProtectionPatterns({
+ options: {
+ _installedModules: [
+ // @ts-expect-error an incomplete module
+ { entryPath: 'some-nuxt-module' },
+ ],
+ rootDir: '/root',
+ srcDir: '/root/src/',
+ serverDir: '/root/src/server',
+ } satisfies Partial<NuxtOptions> as NuxtOptions,
+ }, { context }),
+ })
+
+ return (plugin as any).resolveId.call({ error: () => {} }, id, importer)
+}
diff --git a/packages/nuxt/test/island-hash.test.ts b/packages/nuxt/test/island-hash.test.ts
new file mode 100644
index 000000000000..0e8007b3c16f
--- /dev/null
+++ b/packages/nuxt/test/island-hash.test.ts
@@ -0,0 +1,73 @@
+import { describe, expect, it } from 'vitest'
+import { hash } from 'ohash'
+import { computeIslandHash, filterIslandProps } from '#app/island-hash'
+
+describe('filterIslandProps', () => {
+ it('returns an empty object for nullish input', () => {
+ expect(filterIslandProps(undefined)).toEqual({})
+ expect(filterIslandProps(null)).toEqual({})
+ })
+
+ it('passes through ordinary props', () => {
+ expect(filterIslandProps({ a: 1, b: 'x', c: { nested: true } })).toEqual({
+ a: 1,
+ b: 'x',
+ c: { nested: true },
+ })
+ })
+
+ it('strips Vue scoped-style markers', () => {
+ expect(filterIslandProps({
+ 'data-v-abc123': '',
+ 'data-v-def456': '',
+ 'count': 3,
+ 'label': 'hi',
+ })).toEqual({ count: 3, label: 'hi' })
+ })
+
+ it('preserves keys that merely contain "data-v-"', () => {
+ // Only the prefix is stripped — keys like `extra-data-v-x` are legitimate.
+ expect(filterIslandProps({ 'extra-data-v-x': 1, 'data-v-x': 2 })).toEqual({ 'extra-data-v-x': 1 })
+ })
+})
+
+describe('computeIslandHash', () => {
+ it('matches the ohash-based shape the client embeds in the URL', () => {
+ const name = 'PureComponent'
+ const props = { count: 3, label: 'hi' }
+ const context = { url: '/foo' }
+ const expected = hash([name, props, context, undefined]).replace(/[-_]/g, '')
+ expect(computeIslandHash(name, props, context, undefined)).toBe(expected)
+ })
+
+ it('changes when props change', () => {
+ const a = computeIslandHash('X', { n: 1 }, {}, undefined)
+ const b = computeIslandHash('X', { n: 2 }, {}, undefined)
+ expect(a).not.toBe(b)
+ })
+
+ it('changes when context changes', () => {
+ const a = computeIslandHash('X', {}, { url: '/a' }, undefined)
+ const b = computeIslandHash('X', {}, { url: '/b' }, undefined)
+ expect(a).not.toBe(b)
+ })
+
+ it('changes when name changes', () => {
+ const a = computeIslandHash('A', {}, {}, undefined)
+ const b = computeIslandHash('B', {}, {}, undefined)
+ expect(a).not.toBe(b)
+ })
+
+ it('changes when source changes', () => {
+ const a = computeIslandHash('X', {}, {}, undefined)
+ const b = computeIslandHash('X', {}, {}, 'https://remote.example')
+ expect(a).not.toBe(b)
+ })
+
+ it('produces URL-safe output (no - or _)', () => {
+ for (let i = 0; i < 20; i++) {
+ const h = computeIslandHash('Comp', { i, salt: `${i}-${i}` }, {}, undefined)
+ expect(h).not.toMatch(/[-_]/)
+ }
+ })
+})
diff --git a/packages/nuxt/test/island-transform.test.ts b/packages/nuxt/test/island-transform.test.ts
new file mode 100644
index 000000000000..bdca5a5e6686
--- /dev/null
+++ b/packages/nuxt/test/island-transform.test.ts
@@ -0,0 +1,540 @@
+import { describe, expect, it, vi } from 'vitest'
+import type { Component } from '@nuxt/schema'
+import { IslandsTransformPlugin } from '../src/components/plugins/islands-transform.ts'
+import { normalizeLineEndings } from './utils.ts'
+
+const getComponents = () => [{
+ filePath: 'hello.server.vue',
+ mode: 'server',
+ pascalName: 'HelloWorld',
+ island: true,
+ kebabName: 'hello-world',
+ chunkName: 'components/hello-world',
+ export: 'default',
+ shortPath: '',
+ prefetch: false,
+ preload: false,
+}] as Component[]
+
+const pluginWebpack = IslandsTransformPlugin({
+ getComponents,
+ selectiveClient: true,
+}).raw({}, { framework: 'webpack', webpack: { compiler: {} as any } }) as { transform: { handler: (code: string, id: string) => { code: string } | null } }
+
+async function viteTransform (source: string, id: string, selectiveClient: boolean | 'deep' = false, getServerPages: () => string[] = () => []) {
+ const vitePlugin = IslandsTransformPlugin({
+ getComponents,
+ getServerPages,
+ selectiveClient,
+ }).raw({}, { framework: 'vite' }) as { transform: { handler: (code: string, id: string) => { code: string } | null } }
+
+ const result = await vitePlugin.transform.handler(source, id)
+ return typeof result === 'string' ? result : result!.code
+}
+
+const webpackTransform = async (source: string, id: string) => {
+ // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+ const result = await (pluginWebpack.transform.handler! as Function)(source, id)
+ return typeof result === 'string' ? result : result?.code
+}
+
+describe('islandTransform - server and island components', () => {
+ describe('slots', () => {
+ it('expect slot transform to match inline snapshot', async () => {
+ const result = await viteTransform(`<template>
+ <div>
+ <slot />
+
+ <slot name="named" :some-data="someData" />
+ <slot
+ name="other"
+ :some-data="someData"
+ />
+ </div>
+ </template>
+ <script setup lang="ts">
+ const someData = 'some data'
+
+ </script>`,
+ 'hello.server.vue')
+
+ expect(normalizeLineEndings(result)).toMatchInlineSnapshot(`
+ "<template>
+ <div>
+ <NuxtTeleportSsrSlot name="default" :props="undefined"><slot /></NuxtTeleportSsrSlot>
+
+ <NuxtTeleportSsrSlot name="named" :props="[{ [\`some-data\`]: someData }]"><slot name="named" :some-data="someData" /></NuxtTeleportSsrSlot>
+ <NuxtTeleportSsrSlot name="other" :props="[{ [\`some-data\`]: someData }]"><slot
+ name="other"
+ :some-data="someData"
+ /></NuxtTeleportSsrSlot>
+ </div>
+ </template>
+ <script setup lang="ts">
+ import { mergeProps as __mergeProps } from 'vue'
+ import { vforToArray as __vforToArray } from '#app/components/utils'
+ import NuxtTeleportIslandComponent from '#app/components/nuxt-teleport-island-component'
+ import NuxtTeleportSsrSlot from '#app/components/nuxt-teleport-island-slot'
+ const someData = 'some data'
+
+ </script>"
+ `)
+ })
+
+ it('generates bindings when props are needed to be merged', async () => {
+ const result = await viteTransform(`<script setup lang="ts">
+withDefaults(defineProps<{ things?: any[]; somethingElse?: string }>(), {
+ things: () => [],
+ somethingElse: "yay",
+});
+</script>
+
+<template>
+ <template v-for="thing in things">
+ <slot name="thing" v-bind="thing" />
+ </template>
+</template>
+`, 'hello.server.vue')
+
+ expect(normalizeLineEndings(result)).toMatchInlineSnapshot(`
+ "<script setup lang="ts">
+ import { mergeProps as __mergeProps } from 'vue'
+ import { vforToArray as __vforToArray } from '#app/components/utils'
+ import NuxtTeleportIslandComponent from '#app/components/nuxt-teleport-island-component'
+ import NuxtTeleportSsrSlot from '#app/components/nuxt-teleport-island-slot'
+ withDefaults(defineProps<{ things?: any[]; somethingElse?: string }>(), {
+ things: () => [],
+ somethingElse: "yay",
+ });
+ </script>
+
+ <template>
+ <template v-for="thing in things">
+ <NuxtTeleportSsrSlot name="thing" :props="[__mergeProps(thing, { })]"><slot name="thing" v-bind="thing" /></NuxtTeleportSsrSlot>
+ </template>
+ </template>
+ "
+ `)
+ })
+
+ it('expect slot fallback transform to match inline snapshot', async () => {
+ const result = await viteTransform(`<template>
+ <div>
+ <slot :some-data="someData">
+ <div>fallback</div>
+ </slot>
+ </div>
+ </template>
+ <script setup lang="ts">
+ const someData = 'some data'
+
+ </script>`,
+ 'hello.server.vue')
+
+ expect(normalizeLineEndings(result)).toMatchInlineSnapshot(`
+ "<template>
+ <div>
+ <NuxtTeleportSsrSlot name="default" :props="[{ [\`some-data\`]: someData }]"><slot :some-data="someData"/><template #fallback>
+ <div>fallback</div>
+ </template></NuxtTeleportSsrSlot>
+ </div>
+ </template>
+ <script setup lang="ts">
+ import { mergeProps as __mergeProps } from 'vue'
+ import { vforToArray as __vforToArray } from '#app/components/utils'
+ import NuxtTeleportIslandComponent from '#app/components/nuxt-teleport-island-component'
+ import NuxtTeleportSsrSlot from '#app/components/nuxt-teleport-island-slot'
+ const someData = 'some data'
+
+ </script>"
+ `)
+ })
+
+ it('expect slot transform with fallback and no name to match inline snapshot #23209', async () => {
+ const result = await viteTransform(`<template>
+ <div>
+ <UCard>
+ <template #header>
+ <h3>Partial Hydration Example - Server - {{ count }}</h3>
+ </template>
+ <template #default>
+ <p>message: {{ message }}</p>
+ <p>Below is the slot I want to be hydrated on the client</p>
+ <div>
+ <slot>
+ This is the default content of the slot, I should not see this after
+ the client loading has completed.
+ </slot>
+ </div>
+ <p>Above is the slot I want to be hydrated on the client</p>
+ </template>
+ </UCard>
+ </div>
+ </template>
+
+ <script setup lang="ts">
+ export interface Props {
+ count?: number;
+ }
+ const props = withDefaults(defineProps<Props>(), { count: 0 });
+
+ const message = "Hello World";
+ </script>
+ `,
+ 'hello.server.vue')
+
+ expect(normalizeLineEndings(result)).toMatchInlineSnapshot(`
+ "<template>
+ <div>
+ <UCard>
+ <template #header>
+ <h3>Partial Hydration Example - Server - {{ count }}</h3>
+ </template>
+ <template #default>
+ <p>message: {{ message }}</p>
+ <p>Below is the slot I want to be hydrated on the client</p>
+ <div>
+ <NuxtTeleportSsrSlot name="default" :props="undefined"><slot/><template #fallback>
+ This is the default content of the slot, I should not see this after
+ the client loading has completed.
+ </template></NuxtTeleportSsrSlot>
+ </div>
+ <p>Above is the slot I want to be hydrated on the client</p>
+ </template>
+ </UCard>
+ </div>
+ </template>
+
+ <script setup lang="ts">
+ import { mergeProps as __mergeProps } from 'vue'
+ import { vforToArray as __vforToArray } from '#app/components/utils'
+ import NuxtTeleportIslandComponent from '#app/components/nuxt-teleport-island-component'
+ import NuxtTeleportSsrSlot from '#app/components/nuxt-teleport-island-slot'
+ export interface Props {
+ count?: number;
+ }
+ const props = withDefaults(defineProps<Props>(), { count: 0 });
+
+ const message = "Hello World";
+ </script>
+ "
+ `)
+ })
+
+ it('expect v-if/v-else/v-else-if to be set in teleport component wrapper', async () => {
+ const result = await viteTransform(`<script setup lang="ts">
+ const foo = true;
+ </script>
+ <template>
+ <slot v-if="foo" />
+ <slot v-else-if="test" />
+ <slot v-else />
+ </template>
+ `, 'hello.server.vue', true)
+
+ expect(normalizeLineEndings(result)).toMatchInlineSnapshot(`
+ "<script setup lang="ts">
+ import { mergeProps as __mergeProps } from 'vue'
+ import { vforToArray as __vforToArray } from '#app/components/utils'
+ import NuxtTeleportIslandComponent from '#app/components/nuxt-teleport-island-component'
+ import NuxtTeleportSsrSlot from '#app/components/nuxt-teleport-island-slot'
+ const foo = true;
+ </script>
+ <template>
+ <NuxtTeleportSsrSlot v-if="foo" name="default" :props="undefined"><slot /></NuxtTeleportSsrSlot>
+ <NuxtTeleportSsrSlot v-else-if="test" name="default" :props="undefined"><slot /></NuxtTeleportSsrSlot>
+ <NuxtTeleportSsrSlot v-else name="default" :props="undefined"><slot /></NuxtTeleportSsrSlot>
+ </template>
+ "
+ `)
+ })
+ })
+
+ describe('nuxt-client', () => {
+ describe('vite', () => {
+ it('test transform with vite', async () => {
+ const result = await viteTransform(`<template>
+ <div>
+ <HelloWorld />
+ <HelloWorld nuxt-client />
+ </div>
+ </template>
+
+ <script setup lang="ts">
+ import HelloWorld from './HelloWorld.vue'
+ </script>
+ `, 'hello.server.vue', true)
+
+ expect(normalizeLineEndings(result)).toMatchInlineSnapshot(`
+ "<template>
+ <div>
+ <HelloWorld />
+ <NuxtTeleportIslandComponent :nuxt-client="true"><HelloWorld /></NuxtTeleportIslandComponent>
+ </div>
+ </template>
+
+ <script setup lang="ts">
+ import { mergeProps as __mergeProps } from 'vue'
+ import { vforToArray as __vforToArray } from '#app/components/utils'
+ import NuxtTeleportIslandComponent from '#app/components/nuxt-teleport-island-component'
+ import NuxtTeleportSsrSlot from '#app/components/nuxt-teleport-island-slot'
+ import HelloWorld from './HelloWorld.vue'
+ </script>
+ "
+ `)
+ })
+
+ it('test dynamic nuxt-client', async () => {
+ const result = await viteTransform(`<template>
+ <div>
+ <HelloWorld />
+ <HelloWorld :nuxt-client="nuxtClient" />
+ </div>
+ </template>
+
+ <script setup lang="ts">
+ import HelloWorld from './HelloWorld.vue'
+
+ const nuxtClient = false
+ </script>
+ `, 'hello.server.vue', true)
+
+ expect(normalizeLineEndings(result)).toMatchInlineSnapshot(`
+ "<template>
+ <div>
+ <HelloWorld />
+ <NuxtTeleportIslandComponent :nuxt-client="nuxtClient"><HelloWorld /></NuxtTeleportIslandComponent>
+ </div>
+ </template>
+
+ <script setup lang="ts">
+ import { mergeProps as __mergeProps } from 'vue'
+ import { vforToArray as __vforToArray } from '#app/components/utils'
+ import NuxtTeleportIslandComponent from '#app/components/nuxt-teleport-island-component'
+ import NuxtTeleportSsrSlot from '#app/components/nuxt-teleport-island-slot'
+ import HelloWorld from './HelloWorld.vue'
+
+ const nuxtClient = false
+ </script>
+ "
+ `)
+ })
+
+ it('should not transform if disabled', async () => {
+ const result = await viteTransform(`<template>
+ <div>
+ <HelloWorld />
+ <HelloWorld :nuxt-client="nuxtClient" />
+ </div>
+ </template>
+
+ <script setup lang="ts">
+ import HelloWorld from './HelloWorld.vue'
+
+ const nuxtClient = false
+ </script>
+ `, 'hello.server.vue', false)
+
+ expect(normalizeLineEndings(result)).toMatchInlineSnapshot(`
+ "<template>
+ <div>
+ <HelloWorld />
+ <HelloWorld :nuxt-client="nuxtClient" />
+ </div>
+ </template>
+
+ <script setup lang="ts">
+ import { mergeProps as __mergeProps } from 'vue'
+ import { vforToArray as __vforToArray } from '#app/components/utils'
+ import NuxtTeleportIslandComponent from '#app/components/nuxt-teleport-island-component'
+ import NuxtTeleportSsrSlot from '#app/components/nuxt-teleport-island-slot'
+ import HelloWorld from './HelloWorld.vue'
+
+ const nuxtClient = false
+ </script>
+ "
+ `)
+ })
+
+ it('should add import if there is no scripts in the SFC', async () => {
+ const result = await viteTransform(`<template>
+ <div>
+ <HelloWorld />
+ <HelloWorld nuxt-client />
+ </div>
+ </template>
+
+ `, 'hello.server.vue', true)
+
+ expect(result).toMatchInlineSnapshot(`
+ "<script setup>
+ import { mergeProps as __mergeProps } from 'vue'
+ import { vforToArray as __vforToArray } from '#app/components/utils'
+ import NuxtTeleportIslandComponent from '#app/components/nuxt-teleport-island-component'
+ import NuxtTeleportSsrSlot from '#app/components/nuxt-teleport-island-slot'</script><template>
+ <div>
+ <HelloWorld />
+ <NuxtTeleportIslandComponent :nuxt-client="true"><HelloWorld /></NuxtTeleportIslandComponent>
+ </div>
+ </template>
+
+ "
+ `)
+ expect(result).toContain('import NuxtTeleportIslandComponent from \'#app/components/nuxt-teleport-island-component\'')
+ })
+
+ it('should not wrap an existing NuxtTeleportIslandComponent (#34817)', async () => {
+ const result = await viteTransform(`<template>
+ <div>
+ <NuxtTeleportIslandComponent :nuxt-client="true">
+ <HelloWorld />
+ </NuxtTeleportIslandComponent>
+ </div>
+ </template>
+
+ <script setup lang="ts">
+ import HelloWorld from './HelloWorld.vue'
+ </script>
+ `, 'hello.server.vue', true)
+
+ const openTags = result.match(/<NuxtTeleportIslandComponent\b/g) ?? []
+ const closeTags = result.match(/<\/NuxtTeleportIslandComponent>/g) ?? []
+ expect(openTags).toHaveLength(1)
+ expect(closeTags).toHaveLength(1)
+ expect(result).not.toMatch(/<NuxtTeleportIslandComponent[^>]*>\s*<NuxtTeleportIslandComponent/)
+ })
+
+ it('should move v-if to the wrapper component', async () => {
+ const result = await viteTransform(`<template>
+ <div>
+ <HelloWorld v-if="false" nuxt-client />
+ <HelloWorld v-else-if="true" nuxt-client />
+ <HelloWorld v-else nuxt-client />
+ </div>
+ </template>
+ `, 'hello.server.vue', true)
+
+ expect(result).toMatchInlineSnapshot(`
+ "<script setup>
+ import { mergeProps as __mergeProps } from 'vue'
+ import { vforToArray as __vforToArray } from '#app/components/utils'
+ import NuxtTeleportIslandComponent from '#app/components/nuxt-teleport-island-component'
+ import NuxtTeleportSsrSlot from '#app/components/nuxt-teleport-island-slot'</script><template>
+ <div>
+ <NuxtTeleportIslandComponent v-if="false" :nuxt-client="true"><HelloWorld /></NuxtTeleportIslandComponent>
+ <NuxtTeleportIslandComponent v-else-if="true" :nuxt-client="true"><HelloWorld /></NuxtTeleportIslandComponent>
+ <NuxtTeleportIslandComponent v-else :nuxt-client="true"><HelloWorld /></NuxtTeleportIslandComponent>
+ </div>
+ </template>
+ "
+ `)
+ })
+ })
+
+ describe('webpack', () => {
+ it('test transform with webpack', async () => {
+ const spyOnWarn = vi.spyOn(console, 'warn')
+ const result = await webpackTransform(`<template>
+ <div>
+ <!-- should not be wrapped by NuxtTeleportIslandComponent -->
+ <HelloWorld />
+
+ <!-- should be not wrapped by NuxtTeleportIslandComponent for now -->
+ <HelloWorld nuxt-client />
+ </div>
+ </template>
+
+ <script setup lang="ts">
+ import HelloWorld from './HelloWorld.vue'
+
+ const someData = 'some data'
+ </script>
+ `, 'hello.server.vue')
+ expect(normalizeLineEndings(result)).toMatchInlineSnapshot(`
+ "<template>
+ <div>
+ <!-- should not be wrapped by NuxtTeleportIslandComponent -->
+ <HelloWorld />
+
+ <!-- should be not wrapped by NuxtTeleportIslandComponent for now -->
+ <HelloWorld nuxt-client />
+ </div>
+ </template>
+
+ <script setup lang="ts">
+ import { mergeProps as __mergeProps } from 'vue'
+ import { vforToArray as __vforToArray } from '#app/components/utils'
+ import NuxtTeleportIslandComponent from '#app/components/nuxt-teleport-island-component'
+ import NuxtTeleportSsrSlot from '#app/components/nuxt-teleport-island-slot'
+ import HelloWorld from './HelloWorld.vue'
+
+ const someData = 'some data'
+ </script>
+ "
+ `)
+
+ expect(spyOnWarn).toHaveBeenCalledWith('The `nuxt-client` attribute and client components within islands are only supported with Vite. file: hello.server.vue')
+ })
+ })
+ })
+
+ // https://github.com/nuxt/nuxt/issues/30005
+ describe('selectiveClient: "deep" with non-island components', () => {
+ it('does not wrap <slot/> in NuxtTeleportSsrSlot for non-island Vue files', async () => {
+ const source = `<script setup lang="ts">
+defineProps<{ to: string }>()
+</script>
+
+<template>
+<a :href="to"><slot /></a>
+</template>
+`
+ const result = await viteTransform(source, 'components/Link.vue', 'deep')
+ // Link.vue is a regular component (not registered as an island);
+ // its <slot/> must remain a normal Vue slot so its contents render.
+ expect(result).toContain('<a :href="to"><slot /></a>')
+ expect(result).not.toContain('<NuxtTeleportSsrSlot')
+ })
+
+ it('still wraps <slot/> in NuxtTeleportSsrSlot for island components in deep mode', async () => {
+ const source = `<template>
+<div><slot /></div>
+</template>
+`
+ const result = await viteTransform(source, 'hello.server.vue', 'deep')
+ expect(result).toContain('<NuxtTeleportSsrSlot')
+ })
+
+ it('still wraps nuxt-client on non-island components in deep mode', async () => {
+ const source = `<template>
+<div><HelloWorld nuxt-client /></div>
+</template>
+
+<script setup lang="ts">
+import HelloWorld from './HelloWorld.vue'
+</script>
+`
+ const result = await viteTransform(source, 'components/Wrapper.vue', 'deep')
+ // The nuxt-client wrapping is the whole point of `'deep'` mode and
+ // must keep working for non-island files.
+ expect(result).toContain('<NuxtTeleportIslandComponent :nuxt-client=')
+ })
+ })
+
+ // https://github.com/nuxt/nuxt/issues/30016
+ describe('selectiveClient: true with island pages', () => {
+ it('wraps nuxt-client used directly inside a server page', async () => {
+ const source = `<template>
+<div><InteractiveButton nuxt-client /></div>
+</template>
+
+<script setup lang="ts">
+import InteractiveButton from '~/components/InteractiveButton.vue'
+</script>
+`
+ const pageFile = 'pages/index.server.vue'
+ const result = await viteTransform(source, pageFile, true, () => [pageFile])
+ expect(result).toContain('<NuxtTeleportIslandComponent :nuxt-client=')
+ })
+ })
+})
diff --git a/packages/nuxt/test/keyed-function-factories.test.ts b/packages/nuxt/test/keyed-function-factories.test.ts
new file mode 100644
index 000000000000..6f5a33099a08
--- /dev/null
+++ b/packages/nuxt/test/keyed-function-factories.test.ts
@@ -0,0 +1,1039 @@
+import { beforeEach, describe, expect, it } from 'vitest'
+import {
+ KeyedFunctionFactoriesPlugin,
+ KeyedFunctionFactoriesScanPlugin,
+ scanFileForFactories,
+} from '../src/compiler/plugins/keyed-function-factories'
+import type { KeyedFunctionFactory, Nuxt } from '@nuxt/schema'
+import { createScanPluginContext } from '../src/compiler/utils'
+import type { DeepPartial } from '#app/config.ts'
+import type { Import } from 'unimport'
+
+// -------- compiler scan plugin for scanning keyed function factories --------
+
+function createMockNuxt (): Nuxt {
+ return ({
+ options: {
+ alias: {
+ '@': '/app',
+ '#app': '/nuxt/app',
+ },
+ optimization: {
+ keyedComposables: [],
+ },
+ },
+ } satisfies DeepPartial<Nuxt>) as unknown as Nuxt
+}
+
+describe('keyed function factories scan plugin', () => {
+ const factories: KeyedFunctionFactory[] = [
+ {
+ name: 'createUseFetch',
+ source: '#app/composables/fetch',
+ argumentLength: 3,
+ },
+ {
+ name: 'createUseAsyncData',
+ source: '#app/composables/async-data',
+ argumentLength: 2,
+ },
+ {
+ name: 'createUseKey',
+ source: '~/composables/useKey.ts', // deliberately using an extension here
+ argumentLength: 1,
+ },
+ ]
+
+ const autoImportsToSources = new Map<string, string>([
+ ['createUseFetch', '#app/composables/fetch'],
+ ])
+
+ async function callScanPlugin (id: string, code: string, nuxt: Nuxt, overrides?: {
+ autoImportsToSources?: Map<string, string>
+ }) {
+ const plugin = KeyedFunctionFactoriesScanPlugin({ factories, alias: nuxt.options.alias })
+ const context = createScanPluginContext(code, id)
+ await plugin.scan.call(context, {
+ id,
+ code,
+ nuxt,
+ autoImportsToSources: overrides?.autoImportsToSources ?? autoImportsToSources,
+ })
+ plugin.afterScan?.(nuxt)
+ }
+
+ let mockNuxt: Nuxt
+ beforeEach(() => {
+ mockNuxt = createMockNuxt()
+ })
+
+ it('should collect keyed functions created by factories', async () => {
+ const code = `
+ import { createUseFetch } from '#app/composables/fetch'
+ export const useFetch = createUseFetch({
+ defaults: {
+ baseURL: 'https://example.com',
+ },
+ })
+ export const useAnotherFetch = createUseFetch()
+ `
+
+ await callScanPlugin('fetch.ts', code, mockNuxt)
+
+ expect(mockNuxt.options.optimization.keyedComposables).toMatchInlineSnapshot(`
+ [
+ {
+ "argumentLength": 3,
+ "name": "useFetch",
+ "source": "fetch.ts",
+ },
+ {
+ "argumentLength": 3,
+ "name": "useAnotherFetch",
+ "source": "fetch.ts",
+ },
+ ]
+ `)
+ })
+
+ it('should collect keyed function from default export', async () => {
+ const code = `
+ import { createUseFetch } from '#app/composables/fetch'
+ export default createUseFetch()
+ `
+
+ // check that it converts to camel case from kebab case file name
+ await callScanPlugin('@/composables/use-my-api.ts', code, mockNuxt)
+
+ expect(mockNuxt.options.optimization.keyedComposables).toMatchInlineSnapshot(`
+ [
+ {
+ "argumentLength": 3,
+ "name": "default",
+ "source": "@/composables/use-my-api.ts",
+ },
+ ]
+ `)
+ })
+
+ it('should keep casing in named exports', async () => {
+ const code = `
+ import { createUseFetch } from '#app/composables/fetch'
+ export const use_my_api = createUseFetch()
+ `
+
+ await callScanPlugin('@/composables/use-my-api.ts', code, mockNuxt)
+
+ expect(mockNuxt.options.optimization.keyedComposables).toMatchInlineSnapshot(`
+ [
+ {
+ "argumentLength": 3,
+ "name": "use_my_api",
+ "source": "@/composables/use-my-api.ts",
+ },
+ ]
+ `)
+ })
+
+ it('should not collect functions that are not exported', async () => {
+ const code = `
+ import { createUseFetch } from '#app/composables/fetch'
+ const useFetch = createUseFetch()
+
+ export const useExportedFetch = createUseFetch()
+
+ function foo() {
+ const useAnotherFetch = createUseFetch()
+ }
+
+ try {
+ const useTryFetch = createUseFetch()
+ } catch (e) {
+ }
+ `
+
+ await callScanPlugin('fetch.ts', code, mockNuxt)
+
+ expect(mockNuxt.options.optimization.keyedComposables).toMatchInlineSnapshot(`
+ [
+ {
+ "argumentLength": 3,
+ "name": "useExportedFetch",
+ "source": "fetch.ts",
+ },
+ ]
+ `)
+ })
+
+ it('should collect same-name functions from different modules', async () => {
+ const code = `
+ import { createUseFetch } from '#app/composables/fetch'
+ export const useFetch = createUseFetch()
+ `
+
+ await callScanPlugin('file1.ts', code, mockNuxt)
+ await callScanPlugin('file2.ts', code, mockNuxt)
+
+ expect(mockNuxt.options.optimization.keyedComposables).toMatchInlineSnapshot(`
+ [
+ {
+ "argumentLength": 3,
+ "name": "useFetch",
+ "source": "file1.ts",
+ },
+ {
+ "argumentLength": 3,
+ "name": "useFetch",
+ "source": "file2.ts",
+ },
+ ]
+ `)
+ })
+
+ it('should not collect functions created by factories from non-matching sources', async () => {
+ const code = `
+ import { createUseFetch } from '#app/some-other-place'
+ export const useFetch = createUseFetch()
+ `
+
+ await callScanPlugin('fetch.ts', code, mockNuxt)
+
+ expect(mockNuxt.options.optimization.keyedComposables).toMatchInlineSnapshot('[]')
+ })
+
+ it('should collect functions created by renamed factories ', async () => {
+ const code = `
+ import { createUseFetch as renamedCreateUseFetch } from '#app/composables/fetch'
+ export const useFetch = renamedCreateUseFetch()
+ `
+
+ await callScanPlugin('fetch.ts', code, mockNuxt)
+
+ expect(mockNuxt.options.optimization.keyedComposables).toMatchInlineSnapshot(`
+ [
+ {
+ "argumentLength": 3,
+ "name": "useFetch",
+ "source": "fetch.ts",
+ },
+ ]
+ `)
+ })
+
+ it('should collect functions created by auto-imported factories with matching source', async () => {
+ const code = `
+ export const useFetch = createUseFetch()
+ `
+
+ await callScanPlugin('fetch.ts', code, mockNuxt)
+
+ expect(mockNuxt.options.optimization.keyedComposables).toMatchInlineSnapshot(`
+ [
+ {
+ "argumentLength": 3,
+ "name": "useFetch",
+ "source": "fetch.ts",
+ },
+ ]
+ `)
+ })
+
+ it('should not collect functions created by auto-imported factories with non-matching source', async () => {
+ const code = `
+ export const useFetch = createUseFetch()
+ `
+
+ const autoImportsToSources = new Map<string, string>([
+ // different `createUseFetch` function, not the real factory defined in `factories: KeyedFunctionFactory[]`
+ ['createUseFetch', '#app/some-other-place'],
+ ])
+
+ await callScanPlugin('fetch.ts', code, mockNuxt, { autoImportsToSources })
+
+ expect(mockNuxt.options.optimization.keyedComposables).toMatchInlineSnapshot('[]')
+ })
+
+ it('should not collect functions created by auto-imported factories when there are no auto-imports', async () => {
+ const code = `
+ export const useFetch = createUseFetch()
+ `
+
+ await callScanPlugin('fetch.ts', code, mockNuxt, { autoImportsToSources: new Map() })
+
+ expect(mockNuxt.options.optimization.keyedComposables).toMatchInlineSnapshot('[]')
+ })
+
+ it('should collect functions when factory is imported with or without an extension', async () => {
+ const code = `
+ import { createUseFetch } from '#app/composables/fetch.ts'
+ import { createUseKey } from '~/composables/useKey'
+ export const useFetch = createUseFetch()
+ export const useKey = createUseKey()
+ `
+
+ await callScanPlugin('file.ts', code, mockNuxt)
+ expect(mockNuxt.options.optimization.keyedComposables).toMatchInlineSnapshot(`
+ [
+ {
+ "argumentLength": 3,
+ "name": "useFetch",
+ "source": "file.ts",
+ },
+ {
+ "argumentLength": 1,
+ "name": "useKey",
+ "source": "file.ts",
+ },
+ ]
+ `)
+ })
+
+ it('should collect functions from factories imported through a namespace', async () => {
+ const code = `
+ import * as factories from '#app/composables/fetch'
+ export const useFetch = factories.createUseFetch()
+ `
+
+ await callScanPlugin('fetch.ts', code, mockNuxt)
+
+ expect(mockNuxt.options.optimization.keyedComposables).toMatchInlineSnapshot(`
+ [
+ {
+ "argumentLength": 3,
+ "name": "useFetch",
+ "source": "fetch.ts",
+ },
+ ]
+ `)
+ })
+
+ it('should collect functions from factories accessed via bracket notation on a namespace', async () => {
+ const code = `
+ import * as factories from '#app/composables/fetch'
+ export const useFetch = factories['createUseFetch']()
+ `
+ await callScanPlugin('fetch.ts', code, mockNuxt)
+ expect(mockNuxt.options.optimization.keyedComposables).toMatchInlineSnapshot(`
+ [
+ {
+ "argumentLength": 3,
+ "name": "useFetch",
+ "source": "fetch.ts",
+ },
+ ]
+ `)
+ })
+
+ it('should collect functions from factories when using a chain expression', async () => {
+ const code = `
+ import * as factories from '#app/composables/fetch'
+ export const useFetch = factories?.createUseFetch?.()
+ export const useSecondFetch = factories?.['createUseFetch']?.()
+ export const useThirdFetch = factories?.['createUseFetch']()
+ export const useFourthFetch = factories.createUseFetch?.()
+ export const useFifthFetch = factories['createUseFetch']?.()
+ `
+ await callScanPlugin('fetch.ts', code, mockNuxt)
+ expect(mockNuxt.options.optimization.keyedComposables).toMatchInlineSnapshot(`
+ [
+ {
+ "argumentLength": 3,
+ "name": "useFetch",
+ "source": "fetch.ts",
+ },
+ {
+ "argumentLength": 3,
+ "name": "useSecondFetch",
+ "source": "fetch.ts",
+ },
+ {
+ "argumentLength": 3,
+ "name": "useThirdFetch",
+ "source": "fetch.ts",
+ },
+ {
+ "argumentLength": 3,
+ "name": "useFourthFetch",
+ "source": "fetch.ts",
+ },
+ {
+ "argumentLength": 3,
+ "name": "useFifthFetch",
+ "source": "fetch.ts",
+ },
+ ]
+ `)
+ })
+
+ it('should not collect function when accessed through a namespace of a different source', async () => {
+ const code = `
+ import * as namespace from '#app/composables/fetch'
+ import * as wrongNamespace from '#app/somewhere-else'
+ export const useFetch = wrongNamespace.createUseFetch()
+ `
+
+ await callScanPlugin('fetch.ts', code, mockNuxt)
+
+ expect(mockNuxt.options.optimization.keyedComposables).toMatchInlineSnapshot('[]')
+ })
+
+ it('should collect function when accessed through one of multiple namespaces of the correct source', async () => {
+ const code = `
+ import * as namespace from '#app/composables/fetch'
+ import * as anotherNamespace from '#app/composables/fetch'
+ export const useFetch1 = namespace.createUseFetch()
+ export const useFetch2 = anotherNamespace.createUseFetch()
+ `
+
+ await callScanPlugin('fetch.ts', code, mockNuxt)
+
+ expect(mockNuxt.options.optimization.keyedComposables).toMatchInlineSnapshot(`
+ [
+ {
+ "argumentLength": 3,
+ "name": "useFetch1",
+ "source": "fetch.ts",
+ },
+ {
+ "argumentLength": 3,
+ "name": "useFetch2",
+ "source": "fetch.ts",
+ },
+ ]
+ `)
+ })
+
+ it('should not collect functions from factories imported normally when accessed through the wrong namespace', async () => {
+ const code = `
+ import { createUseFetch } from '#app/composables/fetch'
+ import * as somewhereElse from '#app/somewhere-else'
+ export const useFetch = somewhereElse.createUseFetch()
+ `
+
+ await callScanPlugin('fetch.ts', code, mockNuxt)
+
+ expect(mockNuxt.options.optimization.keyedComposables).toMatchInlineSnapshot('[]')
+ })
+
+ it('should collect functions when factory is imported both normally and via *', async () => {
+ const code = `
+ import { createUseFetch } from '#app/composables/fetch'
+ import * as factories from '#app/composables/fetch'
+ export const useFetch1 = createUseFetch()
+ export const useFetch2 = factories.createUseFetch()
+ `
+
+ await callScanPlugin('fetch.ts', code, mockNuxt)
+
+ expect(mockNuxt.options.optimization.keyedComposables).toMatchInlineSnapshot(`
+ [
+ {
+ "argumentLength": 3,
+ "name": "useFetch1",
+ "source": "fetch.ts",
+ },
+ {
+ "argumentLength": 3,
+ "name": "useFetch2",
+ "source": "fetch.ts",
+ },
+ ]
+ `)
+ })
+
+ it('should not collect functions from factories imported via renamed * when not accessed through the namespace', async () => {
+ const code = `
+ import * as factories from '#app/composables/fetch'
+ export const useFetch = createUseFetch()
+ `
+
+ await callScanPlugin('fetch.ts', code, mockNuxt, {
+ // no auto-imports to prevent `createUseFetch()` from being recognized
+ autoImportsToSources: new Map(),
+ })
+
+ expect(mockNuxt.options.optimization.keyedComposables).toMatchInlineSnapshot('[]')
+ })
+
+ it('should collect functions from default export of factories accessed via a namespace', async () => {
+ const code = `
+ import * as everything from '#app/composables/fetch'
+ export default everything.createUseFetch()
+ `
+
+ await callScanPlugin('useFetch.ts', code, mockNuxt)
+
+ expect(mockNuxt.options.optimization.keyedComposables).toMatchInlineSnapshot(`
+ [
+ {
+ "argumentLength": 3,
+ "name": "default",
+ "source": "useFetch.ts",
+ },
+ ]
+ `)
+ })
+
+ it('ignores locally shadowed factory names', async () => {
+ const code = `
+ import { createUseFetch } from '#app/composables/fetch'
+ export const useFetch1 = createUseFetch()
+ function createUseFetch() { return () => {} }
+ export const useFetch2 = createUseFetch()
+ `
+ await callScanPlugin('fetch.ts', code, mockNuxt)
+ expect(mockNuxt.options.optimization.keyedComposables).toMatchInlineSnapshot(`[]`)
+ })
+
+ it('does not collect when factory is pulled out of a namespace via destructuring', async () => {
+ const code = `
+ import * as factories from '#app/composables/fetch'
+ const { createUseFetch } = factories
+ export const useFetch = createUseFetch()
+ `
+ await callScanPlugin('fetch.ts', code, mockNuxt)
+ expect(mockNuxt.options.optimization.keyedComposables).toMatchInlineSnapshot('[]')
+ })
+
+ it('does not collect when factory is assigned to an alias variable before calling', async () => {
+ const code = `
+ import { createUseFetch } from '#app/composables/fetch'
+ const mk = createUseFetch
+ export const useFetch = mk()
+ `
+ await callScanPlugin('fetch.ts', code, mockNuxt)
+ expect(mockNuxt.options.optimization.keyedComposables).toMatchInlineSnapshot('[]')
+ })
+
+ it('should ignore type-only named import', async () => {
+ const code = `
+ import type { createUseFetch } from '#app/composables/fetch'
+ // @ts-expect-error: createUseFetch is a type-only import, cannot be called
+ export const useFetch = createUseFetch()
+ `
+ await callScanPlugin('fetch.ts', code, mockNuxt)
+ expect(mockNuxt.options.optimization.keyedComposables).toMatchInlineSnapshot(`[]`)
+ })
+
+ it('should ignore type-modified specifier', async () => {
+ const code = `
+ import { type createUseFetch } from '#app/composables/fetch'
+ // @ts-expect-error: type-only import
+ export const useFetch = createUseFetch()
+ `
+ await callScanPlugin('fetch.ts', code, mockNuxt)
+ expect(mockNuxt.options.optimization.keyedComposables).toMatchInlineSnapshot(`[]`)
+ })
+
+ it('should ignore type-only namespace import', async () => {
+ const code = `
+ import type * as factories from '#app/composables/fetch'
+ // @ts-expect-error: factories is type-only
+ export const useFetch = factories.createUseFetch()
+ `
+ await callScanPlugin('fetch.ts', code, mockNuxt)
+ expect(mockNuxt.options.optimization.keyedComposables).toMatchInlineSnapshot(`[]`)
+ })
+})
+
+// -------- scanFileForFactories (standalone, for HMR) --------
+
+describe('scanFileForFactories', () => {
+ const alias = { '#app': '/nuxt/app', '@': '/app' }
+ const factories: KeyedFunctionFactory[] = [
+ { name: 'createUseFetch', source: '#app/composables/fetch', argumentLength: 3 },
+ ]
+ const namesToFactoryMeta = new Map(factories.map(f => [f.name, {
+ ...f,
+ source: f.source.replace('#app', '/nuxt/app').replace(/\.[^.]+$/, ''),
+ }]))
+ const autoImportsToSources = new Map([
+ ['createUseFetch', '#app/composables/fetch'],
+ ])
+
+ it('should find factory calls in a file', () => {
+ const code = `
+ import { createUseFetch } from '#app/composables/fetch'
+ export const useApiFetch = createUseFetch({ baseURL: '/api' })
+ `
+ const results = scanFileForFactories('/app/composables/api.ts', code, namesToFactoryMeta, autoImportsToSources, alias)
+ expect(results).toMatchInlineSnapshot(`
+ [
+ {
+ "argumentLength": 3,
+ "name": "useApiFetch",
+ "source": "/app/composables/api.ts",
+ },
+ ]
+ `)
+ })
+
+ it('should find auto-imported factory calls', () => {
+ const code = `
+ export const useApiFetch = createUseFetch({ baseURL: '/api' })
+ `
+ const results = scanFileForFactories('/app/composables/api.ts', code, namesToFactoryMeta, autoImportsToSources, alias)
+ expect(results).toMatchInlineSnapshot(`
+ [
+ {
+ "argumentLength": 3,
+ "name": "useApiFetch",
+ "source": "/app/composables/api.ts",
+ },
+ ]
+ `)
+ })
+
+ it('should return empty array when no factories found', () => {
+ const code = `
+ export const myHelper = () => 'hello'
+ `
+ const results = scanFileForFactories('/app/composables/helper.ts', code, namesToFactoryMeta, autoImportsToSources, alias)
+ expect(results).toEqual([])
+ })
+})
+
+// -------- per-file tracking in scan plugin --------
+
+describe('keyed function factories scan plugin per-file tracking', () => {
+ const factories: KeyedFunctionFactory[] = [
+ { name: 'createUseFetch', source: '#app/composables/fetch', argumentLength: 3 },
+ ]
+ const autoImportsToSources = new Map([
+ ['createUseFetch', '#app/composables/fetch'],
+ ])
+
+ it('should track results per file', async () => {
+ const plugin = KeyedFunctionFactoriesScanPlugin({ factories, alias: { '#app': '/nuxt/app' } })
+
+ const file1 = `
+ import { createUseFetch } from '#app/composables/fetch'
+ export const useApiFetch = createUseFetch()
+ `
+ const file2 = `
+ import { createUseFetch } from '#app/composables/fetch'
+ export const useOtherFetch = createUseFetch()
+ export const useThirdFetch = createUseFetch()
+ `
+
+ const ctx1 = createScanPluginContext(file1, '/app/composables/api.ts')
+ await plugin.scan.call(ctx1, { id: '/app/composables/api.ts', code: file1, nuxt: createMockNuxt(), autoImportsToSources })
+
+ const ctx2 = createScanPluginContext(file2, '/app/composables/other.ts')
+ await plugin.scan.call(ctx2, { id: '/app/composables/other.ts', code: file2, nuxt: createMockNuxt(), autoImportsToSources })
+
+ expect(plugin.result.fileResults.get('/app/composables/api.ts')).toHaveLength(1)
+ expect(plugin.result.fileResults.get('/app/composables/other.ts')).toHaveLength(2)
+ expect(plugin.result.fileResults.size).toBe(2)
+ })
+
+ it('should overwrite previous results when re-scanning a file', async () => {
+ const plugin = KeyedFunctionFactoriesScanPlugin({ factories, alias: { '#app': '/nuxt/app' } })
+
+ const original = `
+ import { createUseFetch } from '#app/composables/fetch'
+ export const useApiFetch = createUseFetch()
+ `
+ const ctx1 = createScanPluginContext(original, '/app/composables/api.ts')
+ await plugin.scan.call(ctx1, { id: '/app/composables/api.ts', code: original, nuxt: createMockNuxt(), autoImportsToSources })
+
+ expect(plugin.result.fileResults.get('/app/composables/api.ts')).toHaveLength(1)
+
+ // Re-scan with updated file that adds a second export
+ const updated = `
+ import { createUseFetch } from '#app/composables/fetch'
+ export const useApiFetch = createUseFetch()
+ export const useApiFetch2 = createUseFetch()
+ `
+ const ctx2 = createScanPluginContext(updated, '/app/composables/api.ts')
+ await plugin.scan.call(ctx2, { id: '/app/composables/api.ts', code: updated, nuxt: createMockNuxt(), autoImportsToSources })
+
+ expect(plugin.result.fileResults.get('/app/composables/api.ts')).toHaveLength(2)
+ expect(plugin.result.fileResults.size).toBe(1)
+ })
+
+ it('should flatten all per-file results in afterScan', async () => {
+ const plugin = KeyedFunctionFactoriesScanPlugin({ factories, alias: { '#app': '/nuxt/app' } })
+ const nuxt = createMockNuxt()
+
+ const file1 = `
+ import { createUseFetch } from '#app/composables/fetch'
+ export const useApiFetch = createUseFetch()
+ `
+ const file2 = `
+ import { createUseFetch } from '#app/composables/fetch'
+ export const useOtherFetch = createUseFetch()
+ `
+
+ const ctx1 = createScanPluginContext(file1, '/app/composables/api.ts')
+ await plugin.scan.call(ctx1, { id: '/app/composables/api.ts', code: file1, nuxt, autoImportsToSources })
+
+ const ctx2 = createScanPluginContext(file2, '/app/composables/other.ts')
+ await plugin.scan.call(ctx2, { id: '/app/composables/other.ts', code: file2, nuxt, autoImportsToSources })
+
+ plugin.afterScan?.(nuxt)
+
+ expect(nuxt.options.optimization.keyedComposables).toHaveLength(2)
+ expect(nuxt.options.optimization.keyedComposables.map(k => k.name)).toEqual(['useApiFetch', 'useOtherFetch'])
+ })
+})
+
+// -------- unplugin for replacing keyed factory macros --------
+
+describe('keyed function factories plugin', () => {
+ const factories: KeyedFunctionFactory[] = [
+ {
+ name: 'createUseFetch',
+ source: '#app/composables/fetch',
+ argumentLength: 3,
+ },
+ {
+ name: 'createUseKey',
+ source: '~/composables/useKey.ts', // deliberately using an extension here
+ argumentLength: 1,
+ },
+ ]
+
+ const transformPlugin = KeyedFunctionFactoriesPlugin({ factories, alias: {}, getAutoImports: () => Promise.resolve([]) }).raw({}, {} as any) as {
+ transform: { handler: (code: string, id: string) => Promise<{ code: string } | null> }
+ }
+
+ it('should replace placeholder macro with actual factory', async () => {
+ const code = `
+ import { createUseFetch } from '#app/composables/fetch'
+ export const useFetch = createUseFetch()
+ `
+
+ expect((await transformPlugin.transform.handler(code, 'fetch.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import { createUseFetch } from '#app/composables/fetch'
+ export const useFetch = createUseFetch.__nuxt_factory()"
+ `)
+ })
+
+ it('should handle multiple declarations on a single line', async () => {
+ const code = `
+ import { createUseFetch } from '#app/composables/fetch'
+ export const useFetch = createUseFetch(), another = createUseFetch()
+ `
+
+ expect((await transformPlugin.transform.handler(code, 'fetch.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import { createUseFetch } from '#app/composables/fetch'
+ export const useFetch = createUseFetch.__nuxt_factory(), another = createUseFetch.__nuxt_factory()"
+ `)
+ })
+
+ it('should not transform different functions with the same name', async () => {
+ const code = `
+ import { createUseFetch } from '#app/some-other-place'
+ export const useFetch = createUseFetch()
+ `
+
+ expect((await transformPlugin.transform.handler(code, 'fetch.ts'))?.code.trim()).toBeUndefined()
+ })
+
+ it('should transform factories when imported with or without an extension', async () => {
+ const code = `
+ import { createUseFetch } from '#app/composables/fetch.ts'
+ import { createUseKey } from '~/composables/useKey'
+ export const useFetch = createUseFetch()
+ export const useKey = createUseKey()
+ `
+
+ expect((await transformPlugin.transform.handler(code, 'fetch.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import { createUseFetch } from '#app/composables/fetch.ts'
+ import { createUseKey } from '~/composables/useKey'
+ export const useFetch = createUseFetch.__nuxt_factory()
+ export const useKey = createUseKey.__nuxt_factory()"
+ `)
+ })
+
+ it('should transform factories renamed in import', async () => {
+ const code = `
+ import { createUseFetch as renamedCreateUseFetch } from '#app/composables/fetch'
+ export const useFetch = renamedCreateUseFetch()
+ `
+
+ expect((await transformPlugin.transform.handler(code, 'fetch.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import { createUseFetch as renamedCreateUseFetch } from '#app/composables/fetch'
+ export const useFetch = renamedCreateUseFetch.__nuxt_factory()"
+ `)
+ })
+
+ it('should not transform factories without specific import source', async () => {
+ // in this case, we don't need to test for auto-imports, since the transform plugin will
+ // run only after the imports have been injected
+ const code = `
+ export const useFetch = createUseFetch()
+ `
+
+ expect((await transformPlugin.transform.handler(code, 'fetch.ts'))?.code.trim()).toBeUndefined()
+ })
+
+ it('should transform factory accessed through namespaced import', async () => {
+ const code = `
+ import * as factories from '#app/composables/fetch'
+ export const useFetch = factories.createUseFetch()
+ `
+
+ expect((await transformPlugin.transform.handler(code, 'fetch.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import * as factories from '#app/composables/fetch'
+ export const useFetch = factories.createUseFetch.__nuxt_factory()"
+ `)
+ })
+
+ it('should transform factory accessed through bracket notation on a namespace', async () => {
+ const code = `
+ import * as factories from '#app/composables/fetch'
+ export const useFetch = factories['createUseFetch']()
+ `
+
+ expect((await transformPlugin.transform.handler(code, 'fetch.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import * as factories from '#app/composables/fetch'
+ export const useFetch = factories['createUseFetch'].__nuxt_factory()"
+ `)
+ })
+
+ it('should only transform factories from the allowed source when same name exists from elsewhere', async () => {
+ const code = `
+ import { createUseFetch as a } from '#app/composables/fetch'
+ import { createUseFetch as b } from '#app/other'
+ export const x = a()
+ export const y = b()
+ `
+ expect((await transformPlugin.transform.handler(code, 'fetch.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import { createUseFetch as a } from '#app/composables/fetch'
+ import { createUseFetch as b } from '#app/other'
+ export const x = a.__nuxt_factory()
+ export const y = b()"
+ `)
+ })
+
+ it('should transform factory when using optional chaining', async () => {
+ const code = `
+ import * as factories from '#app/composables/fetch'
+ export const a = factories.createUseFetch?.()
+ export const b = factories?.createUseFetch()
+ export const c = factories?.createUseFetch?.()
+ export const d = (factories.createUseFetch)?.()
+ export const e = factories['createUseFetch']?.()
+ export const f = factories?.['createUseFetch']()
+ export const g = factories?.['createUseFetch']?.()
+ export const h = (factories['createUseFetch'])?.()
+ `
+
+ expect((await transformPlugin.transform.handler(code, 'fetch.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import * as factories from '#app/composables/fetch'
+ export const a = factories.createUseFetch?.__nuxt_factory()
+ export const b = factories?.createUseFetch.__nuxt_factory()
+ export const c = factories?.createUseFetch?.__nuxt_factory()
+ export const d = (factories.createUseFetch)?.__nuxt_factory()
+ export const e = factories['createUseFetch']?.__nuxt_factory()
+ export const f = factories?.['createUseFetch'].__nuxt_factory()
+ export const g = factories?.['createUseFetch']?.__nuxt_factory()
+ export const h = (factories['createUseFetch'])?.__nuxt_factory()"
+ `)
+ })
+
+ it('should not transform factory when not accessed through namespace', async () => {
+ const code = `
+ import * as factories from '#app/composables/fetch'
+ export const useFetch = createUseFetch()
+ export const useOptionalFetch = factories?.someOtherFunction?.()
+ `
+
+ expect((await transformPlugin.transform.handler(code, 'fetch.ts'))?.code.trim()).toBeUndefined()
+ })
+
+ it('should transform local factories with separate declaration and export', async () => {
+ const code = `
+ import { createUseFetch } from '#app/composables/fetch'
+ const useFetch = createUseFetch()
+ const useAnother = createUseFetch()
+ const useNotTransformed = createUseFetch()
+
+ export { useFetch, useAnother }
+ `
+
+ expect((await transformPlugin.transform.handler(code, 'fetch.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import { createUseFetch } from '#app/composables/fetch'
+ const useFetch = createUseFetch.__nuxt_factory()
+ const useAnother = createUseFetch.__nuxt_factory()
+ const useNotTransformed = createUseFetch()
+
+ export { useFetch, useAnother }"
+ `)
+ })
+
+ it('should transform local factories when result is renamed in export', async () => {
+ const code = `
+ import { createUseFetch } from '#app/composables/fetch'
+ const useFetch = createUseFetch()
+
+ export { useFetch as renamedUseFetch }
+ `
+
+ expect((await transformPlugin.transform.handler(code, 'fetch.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import { createUseFetch } from '#app/composables/fetch'
+ const useFetch = createUseFetch.__nuxt_factory()
+
+ export { useFetch as renamedUseFetch }"
+ `)
+ })
+
+ it('should not transform local factories when result is not exported', async () => {
+ const code = `
+ import { createUseFetch } from '#app/composables/fetch'
+ const useFetch = createUseFetch()
+ `
+
+ expect((await transformPlugin.transform.handler(code, 'fetch.ts'))?.code.trim()).toBeUndefined()
+ })
+
+ it('should not transform factories in non-top level', async () => {
+ const code = `
+ import { createUseFetch } from '#app/composables/fetch'
+ {
+ const useFetch = createUseFetch()
+ }
+
+ function factory() {
+ const useFetch = createUseFetch()
+ return useFetch
+ }
+ `
+
+ expect((await transformPlugin.transform.handler(code, 'fetch.ts'))?.code.trim()).toMatchInlineSnapshot(`undefined`)
+ })
+
+ it('should not transform when local variable shadows the factory', async () => {
+ const code = `
+ import { createUseFetch as importedCreateUseFetch } from '#app/composables/fetch'
+ const createUseFetch = () => () => {}
+ export const useFetch = createUseFetch()
+ `
+ expect((await transformPlugin.transform.handler(code, 'fetch.ts'))?.code).toBeUndefined()
+ })
+
+ it('should transform when only an inner-scope binding shadows the name', async () => {
+ const code = `
+ import { createUseFetch } from '#app/composables/fetch'
+ { const createUseFetch = () => () => {} }
+ export const useFetch = createUseFetch()
+ `
+ expect((await transformPlugin.transform.handler(code, 'fetch.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import { createUseFetch } from '#app/composables/fetch'
+ { const createUseFetch = () => () => {} }
+ export const useFetch = createUseFetch.__nuxt_factory()"
+ `)
+ })
+
+ it('should not transform when property is computed dynamically', async () => {
+ const code = `
+ import * as factories from '#app/composables/fetch'
+ const key = 'createUseFetch'
+ export const useFetch = factories[key]()
+ `
+ expect((await transformPlugin.transform.handler(code, 'fetch.ts'))?.code.trim()).toBeUndefined()
+ })
+
+ it('should not transform when property is computed via template literal', async () => {
+ const code = `
+ import * as factories from '#app/composables/fetch'
+ export const useFetch = factories[\`createUseFetch\`]()
+ `
+ expect((await transformPlugin.transform.handler(code, 'fetch.ts'))?.code.trim()).toBeUndefined()
+ })
+
+ it('should transform default export', async () => {
+ const code = `
+ import { createUseFetch } from '#app/composables/fetch'
+ export default createUseFetch()
+ `
+ expect((await transformPlugin.transform.handler(code, 'fetch.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import { createUseFetch } from '#app/composables/fetch'
+ export default createUseFetch.__nuxt_factory()"
+ `)
+ })
+
+ it('should ignore re-exports of the factory', async () => {
+ const code = `
+ export { createUseFetch } from '#app/composables/fetch'
+ `
+ expect((await transformPlugin.transform.handler(code, 'fetch.ts'))?.code.trim()).toBeUndefined()
+ })
+
+ it('should not transform dynamic import', async () => {
+ const code = `
+ export const make = async () => {
+ const m = await import('#app/composables/fetch')
+ return m.createUseFetch()
+ }
+ `
+ expect((await transformPlugin.transform.handler(code, 'fetch.ts'))?.code.trim()).toBeUndefined()
+ })
+
+ describe('auto-imports', () => {
+ const alias = { '#app': '/nuxt/app' }
+ const autoImports: Import[] = [
+ { from: '#app/composables/fetch', name: 'createUseFetch', as: 'createUseFetch' },
+ ]
+
+ const factoriesWithAlias: KeyedFunctionFactory[] = [
+ {
+ name: 'createUseFetch',
+ source: '#app/composables/fetch',
+ argumentLength: 3,
+ },
+ ]
+
+ const transformPluginWithAutoImports = KeyedFunctionFactoriesPlugin({
+ factories: factoriesWithAlias,
+ alias,
+ getAutoImports: () => Promise.resolve(autoImports),
+ }).raw({}, {} as any) as {
+ transform: { handler: (code: string, id: string) => Promise<{ code: string } | null> }
+ }
+
+ it('should transform auto-imported factory without explicit import', async () => {
+ const code = `
+ export const useApiFetch = createUseFetch({ baseURL: '/api' })
+ `
+
+ expect((await transformPluginWithAutoImports.transform.handler(code, '/app/composables/useApiFetch.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "export const useApiFetch = createUseFetch.__nuxt_factory({ baseURL: '/api' })"
+ `)
+ })
+
+ it('should not transform auto-imported factory from wrong source', async () => {
+ const wrongAutoImports: Import[] = [
+ { from: '#app/some-other-place', name: 'createUseFetch', as: 'createUseFetch' },
+ ]
+
+ const plugin = KeyedFunctionFactoriesPlugin({
+ factories: factoriesWithAlias,
+ alias,
+ getAutoImports: () => Promise.resolve(wrongAutoImports),
+ }).raw({}, {} as any) as {
+ transform: { handler: (code: string, id: string) => Promise<{ code: string } | null> }
+ }
+
+ const code = `
+ export const useApiFetch = createUseFetch({ baseURL: '/api' })
+ `
+
+ expect((await plugin.transform.handler(code, '/app/composables/useApiFetch.ts'))?.code.trim()).toBeUndefined()
+ })
+
+ it('should prefer explicit import over auto-import', async () => {
+ const code = `
+ import { createUseFetch } from '#app/composables/fetch'
+ export const useApiFetch = createUseFetch({ baseURL: '/api' })
+ `
+
+ expect((await transformPluginWithAutoImports.transform.handler(code, '/app/composables/useApiFetch.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import { createUseFetch } from '#app/composables/fetch'
+ export const useApiFetch = createUseFetch.__nuxt_factory({ baseURL: '/api' })"
+ `)
+ })
+ })
+})
diff --git a/packages/nuxt/test/keyed-functions.test.ts b/packages/nuxt/test/keyed-functions.test.ts
new file mode 100644
index 000000000000..3e3b1c451fd0
--- /dev/null
+++ b/packages/nuxt/test/keyed-functions.test.ts
@@ -0,0 +1,1028 @@
+import type { KeyedFunction } from '@nuxt/schema'
+import { describe, expect, it, vi } from 'vitest'
+import { KeyedFunctionsPlugin } from '../src/compiler/plugins/keyed-functions'
+import { logger } from '../src/utils'
+import type { Import } from 'unimport'
+
+describe('keyed functions plugin - reactive getter (dev mode)', () => {
+ it('should pick up dynamically added keyed functions', async () => {
+ const keyedFunctions: KeyedFunction[] = [
+ { name: 'useExisting', source: '#app', argumentLength: 1 },
+ ]
+
+ const plugin = KeyedFunctionsPlugin({
+ keyedFunctions,
+ getKeyedFunctions: () => keyedFunctions,
+ alias: {},
+ getAutoImports: () => Promise.resolve([]),
+ appDir: '/nuxt/dist/app/',
+ dev: true,
+ }).raw({}, {} as any) as {
+ transform: { handler: (code: string, id: string) => Promise<{ code: string } | null> }
+ }
+
+ // Initially, only useExisting is known
+ const code1 = `
+import { useExisting } from '#app'
+useExisting()
+ `
+ expect((await plugin.transform.handler(code1, 'plugin.ts'))?.code).toContain('/* nuxt-injected */')
+
+ // useNewComposable is not yet known
+ const code2 = `
+import { useNewComposable } from '#app/composables/new'
+useNewComposable()
+ `
+ expect(await plugin.transform.handler(code2, 'plugin.ts')).toBeUndefined()
+
+ // Simulate HMR: add a new keyed function to the list
+ keyedFunctions.push({ name: 'useNewComposable', source: '#app/composables/new', argumentLength: 1 })
+
+ // Now useNewComposable should be recognized
+ const result = await plugin.transform.handler(code2, 'plugin.ts')
+ expect(result?.code).toContain('/* nuxt-injected */')
+ })
+
+ it('should not rebuild state when list length has not changed', async () => {
+ const keyedFunctions: KeyedFunction[] = [
+ { name: 'useExisting', source: '#app', argumentLength: 1 },
+ ]
+
+ const plugin = KeyedFunctionsPlugin({
+ keyedFunctions,
+ getKeyedFunctions: () => keyedFunctions,
+ alias: {},
+ getAutoImports: () => Promise.resolve([]),
+ appDir: '/nuxt/dist/app/',
+ dev: true,
+ }).raw({}, {} as any) as {
+ transform: { handler: (code: string, id: string) => Promise<{ code: string } | null> }
+ }
+
+ const code = `
+import { useExisting } from '#app'
+useExisting()
+ `
+
+ // Both calls should succeed without rebuilding (same length)
+ const result1 = await plugin.transform.handler(code, 'plugin.ts')
+ const result2 = await plugin.transform.handler(code, 'other.ts')
+ expect(result1?.code).toContain('/* nuxt-injected */')
+ expect(result2?.code).toContain('/* nuxt-injected */')
+ })
+
+ it('should use static code filter in production mode', () => {
+ const keyedFunctions: KeyedFunction[] = [
+ { name: 'useExisting', source: '#app', argumentLength: 1 },
+ ]
+
+ const plugin = KeyedFunctionsPlugin({
+ keyedFunctions,
+ getKeyedFunctions: () => keyedFunctions,
+ alias: {},
+ getAutoImports: () => Promise.resolve([]),
+ appDir: '/nuxt/dist/app/',
+ dev: false,
+ }).raw({}, {} as any) as {
+ transform: { filter: { code?: { include: RegExp } }, handler: (code: string, id: string) => Promise<{ code: string } | null> }
+ }
+
+ // In production mode, code filter should be present (static regex)
+ expect(plugin.transform.filter.code).toBeDefined()
+ expect(plugin.transform.filter.code!.include).toBeInstanceOf(RegExp)
+ })
+})
+
+describe('keyed functions plugin', () => {
+ const keyedFunctions: KeyedFunction[] = [
+ {
+ name: 'useKey',
+ source: '#app',
+ argumentLength: 1,
+ },
+ {
+ name: 'useKey',
+ source: '#app/useKeyTwo',
+ argumentLength: 2,
+ },
+ {
+ name: 'useKeyTwo',
+ source: '#app',
+ argumentLength: 2,
+ },
+ {
+ name: 'useKeyTwo', // duplicate entry
+ source: '#app',
+ argumentLength: 2,
+ },
+ {
+ name: 'useKeyTwoRenamed',
+ source: 'renamed.ts',
+ argumentLength: 2,
+ },
+ {
+ name: 'default',
+ source: '#app/defaultExport',
+ argumentLength: 1,
+ },
+ {
+ name: 'default',
+ source: 'composables/use-default-key.ts',
+ argumentLength: 1,
+ },
+ // TODO: remove entries without source in Nuxt 5
+ // @ts-expect-error - `source` wasn't required before
+ {
+ name: 'useAutoImported',
+ argumentLength: 1,
+ },
+ {
+ name: 'useRegexKey',
+ argumentLength: 1,
+ // @ts-expect-error - regex was supported before
+ source: /regex/,
+ },
+ ]
+
+ const autoImports: Import[] = [
+ {
+ from: '#app',
+ name: 'useAutoImported',
+ as: 'useAutoImported',
+ },
+ ]
+
+ const transformPlugin = KeyedFunctionsPlugin({ keyedFunctions, alias: {}, getAutoImports: () => Promise.resolve(autoImports), appDir: '/nuxt/dist/app/' }).raw({}, {} as any) as { transform: { handler: (code: string, id: string) => Promise<{ code: string } | null> } }
+
+ it('should add hash when there is none already provided', async () => {
+ const code = `
+import { useKey, useKeyTwo } from '#app'
+useKey()
+useKeyTwo(() => {})
+ `
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import { useKey, useKeyTwo } from '#app'
+ useKey('$HJiaryoL2y' /* nuxt-injected */)
+ useKeyTwo(() => {}, '$yysMIARJHe' /* nuxt-injected */)"
+ `)
+ })
+
+ it('should use different hash for each call of the same function', async () => {
+ const code = `
+import { useKey } from '#app'
+useKey()
+useKey()
+ `
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import { useKey } from '#app'
+ useKey('$HJiaryoL2y' /* nuxt-injected */)
+ useKey('$yysMIARJHe' /* nuxt-injected */)"
+ `)
+ })
+
+ it('should not add hash when one exists', async () => {
+ const code = `
+import { useKey, useKeyTwo } from '#app'
+useKey('$existingKey')
+useKeyTwo(() => {}, '$existingKey')
+`
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`undefined`)
+ })
+
+ it('should add add hash to function from default import', async () => {
+ const code = `
+import useDefaultKey from 'composables/use-default-key.ts'
+useDefaultKey()`
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import useDefaultKey from 'composables/use-default-key.ts'
+ useDefaultKey('$HJiaryoL2y' /* nuxt-injected */)"
+ `)
+ })
+
+ it('should add hash to function from default import with different name', async () => {
+ const code = `
+ import useRenamedFunctionThatIsNotInKeyedFunctions from 'composables/use-default-key.ts'
+ useRenamedFunctionThatIsNotInKeyedFunctions()`
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import useRenamedFunctionThatIsNotInKeyedFunctions from 'composables/use-default-key.ts'
+ useRenamedFunctionThatIsNotInKeyedFunctions('$HJiaryoL2y' /* nuxt-injected */)"
+ `)
+ })
+
+ it('should add hash to function from default import when renamed', async () => {
+ const code = `
+import { default as useRenamedDefault } from '#app/defaultExport'
+useRenamedDefault()`
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import { default as useRenamedDefault } from '#app/defaultExport'
+ useRenamedDefault('$HJiaryoL2y' /* nuxt-injected */)"
+ `)
+ })
+
+ it('should correctly identify same-name functions from different sources', async () => {
+ const code = `
+ import { useKey as useKeyOne } from '#app'
+ import { useKey as useKeyTwo } from '#app/useKeyTwo'
+ useKeyOne()
+ useKeyTwo('first')
+ `
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import { useKey as useKeyOne } from '#app'
+ import { useKey as useKeyTwo } from '#app/useKeyTwo'
+ useKeyOne('$HJiaryoL2y' /* nuxt-injected */)
+ useKeyTwo('first', '$yysMIARJHe' /* nuxt-injected */)"
+ `)
+ })
+
+ it('should warn if there are duplicate entries in keyed functions', () => {
+ vi.stubGlobal('__TEST_DEV__', true)
+
+ const warn = vi.spyOn(logger, 'warn').mockImplementation(() => {})
+
+ KeyedFunctionsPlugin({ keyedFunctions, alias: {}, getAutoImports: () => Promise.resolve(autoImports), appDir: '/nuxt/dist/app/' }).raw({}, {} as any)
+
+ expect(warn).toHaveBeenCalledWith(expect.stringMatching(
+ /\[nuxt:compiler\] \[keyed-functions\] Duplicate function name `useKeyTwo` with the same source `#app` found. Overwriting the existing entry./,
+ ))
+ warn.mockRestore()
+ vi.unstubAllGlobals()
+ })
+
+ it('should handle multi-line parameters', async () => {
+ const code = `
+import { useKey, useKeyTwo } from '#app'
+useKey(
+)
+useKeyTwo(
+ () => {}
+)
+
+useKeyTwo(
+
+
+ () => {}
+)
+
+useKeyTwo(
+ () => {
+ })
+ `
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import { useKey, useKeyTwo } from '#app'
+ useKey(
+ '$HJiaryoL2y' /* nuxt-injected */)
+ useKeyTwo(
+ () => {}
+ , '$yysMIARJHe' /* nuxt-injected */)
+
+ useKeyTwo(
+
+
+ () => {}
+ , '$Cy7hQH5X5O' /* nuxt-injected */)
+
+ useKeyTwo(
+ () => {
+ }, '$Fl_F5LB-IM' /* nuxt-injected */)"
+ `)
+ })
+
+ it('should handle trailing commas in parameters', async () => {
+ const code = `
+import { useKeyTwo } from '#app'
+useKeyTwo(
+ () => {},
+)
+
+useKeyTwo(
+ () => {}
+ ,)
+
+useKeyTwo(
+
+ () => {}
+
+ ,
+ )
+ `
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import { useKeyTwo } from '#app'
+ useKeyTwo(
+ () => {},
+ '$HJiaryoL2y' /* nuxt-injected */)
+
+ useKeyTwo(
+ () => {}
+ ,'$yysMIARJHe' /* nuxt-injected */)
+
+ useKeyTwo(
+
+ () => {}
+
+ ,
+ '$Cy7hQH5X5O' /* nuxt-injected */)"
+ `)
+ })
+
+ it('should not add hash for non-matching function names', async () => {
+ const code = `
+import { useKeyThree } from '#app'
+useKeyThree()
+`
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`undefined`)
+ })
+
+ it('should add hash in child scopes', async () => {
+ const code = `
+import { useKey } from '#app'
+function foo() {
+ useKey()
+
+ if (true) {
+ useKey()
+ }
+}
+`
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import { useKey } from '#app'
+ function foo() {
+ useKey('$HJiaryoL2y' /* nuxt-injected */)
+
+ if (true) {
+ useKey('$yysMIARJHe' /* nuxt-injected */)
+ }
+ }"
+ `)
+ })
+
+ it('should handle function shadowing', async () => {
+ const code = `
+import { useKey } from '#app'
+
+function foo() {
+ useKey()
+ function useKey() { return 'local' }
+}
+
+useKey()
+ `
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import { useKey } from '#app'
+
+ function foo() {
+ useKey()
+ function useKey() { return 'local' }
+ }
+
+ useKey('$HJiaryoL2y' /* nuxt-injected */)"
+ `)
+ })
+
+ it('should handle variable shadowing', async () => {
+ const code = `
+import { useKey } from '#app'
+
+function foo() {
+ const useKey = () => 'local'
+ useKey()
+}
+
+useKey()
+ `
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import { useKey } from '#app'
+
+ function foo() {
+ const useKey = () => 'local'
+ useKey()
+ }
+
+ useKey('$HJiaryoL2y' /* nuxt-injected */)"
+ `)
+ })
+
+ it('should handle function parameters shadowing', async () => {
+ const code = `
+import { useKey } from '#app'
+
+function foo(useKey) {
+ useKey()
+}
+
+const bar = useKey => useKey()
+
+useKey()
+ `
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import { useKey } from '#app'
+
+ function foo(useKey) {
+ useKey()
+ }
+
+ const bar = useKey => useKey()
+
+ useKey('$HJiaryoL2y' /* nuxt-injected */)"
+ `)
+ })
+
+ it('should add hash when processing file in `source` for exported functions', async () => {
+ const code = `
+useKeyTwo()
+export const useKey = (arg1) => {}
+useKey()
+export function useKeyTwo(arg1, arg2) {}
+ `
+ expect((await transformPlugin.transform.handler(code, '#app'))?.code.trim()).toMatchInlineSnapshot(`
+ "useKeyTwo('$QQV3F06xQZ' /* nuxt-injected */)
+ export const useKey = (arg1) => {}
+ useKey('$Bil3ev-zNC' /* nuxt-injected */)
+ export function useKeyTwo(arg1, arg2) {}"
+ `)
+ })
+
+ it('should not add hash to non-exported matching functions in `source`', async () => {
+ const code = `
+useKeyTwo()
+const useKey = (arg1) => {}
+useKey()
+function useKeyTwo(arg1, arg2) {}
+ `
+ expect((await transformPlugin.transform.handler(code, '#app'))?.code.trim()).toMatchInlineSnapshot(`undefined`)
+ })
+
+ it('should handle standalone export declaration in `source`', async () => {
+ const code = `
+useKey()
+function useKey(arg) {}
+export { useKey }
+`
+ expect((await transformPlugin.transform.handler(code, '#app'))?.code.trim()).toMatchInlineSnapshot(`
+ "useKey('$QQV3F06xQZ' /* nuxt-injected */)
+ function useKey(arg) {}
+ export { useKey }"
+ `)
+ })
+
+ it('should not add hash to matching function names in `source` when renamed in export', async () => {
+ const code = `
+function useRenamedKey(arg) {}
+useKey()
+useRenamedKey()
+function useKey(arg) {}
+export { useKey as useRenamedKey }
+`
+ // we renamed the export, so the defined `useKey` is not exported and therefore should not get a hash
+ // `useRenamedKey`, on the other hand, is not defined in keyed functions, so it should not get a hash either
+ expect((await transformPlugin.transform.handler(code, '#app'))?.code.trim()).toMatchInlineSnapshot(`undefined`)
+ })
+
+ it('should add hash to original function in `source` with when renamed in export', async () => {
+ const code = `
+ foo()
+ function foo(arg) {}
+ function bar() {
+ const foo = () => 'local'
+ // still respects shadowing
+ foo()
+ }
+ foo()
+ export { foo as useKey }
+ `
+
+ expect((await transformPlugin.transform.handler(code, '#app'))?.code.trim()).toMatchInlineSnapshot(`
+ "foo('$QQV3F06xQZ' /* nuxt-injected */)
+ function foo(arg) {}
+ function bar() {
+ const foo = () => 'local'
+ // still respects shadowing
+ foo()
+ }
+ foo('$Bil3ev-zNC' /* nuxt-injected */)
+ export { foo as useKey }"
+ `)
+ })
+
+ it('should add hash to imported keyed function in `source` when renamed in export', async () => {
+ const code = `
+import { useKey } from '#app'
+useKey('add-key-after')
+export { useKey as useKeyTwoRenamed }
+ `
+ expect((await transformPlugin.transform.handler(code, 'renamed.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import { useKey } from '#app'
+ useKey('add-key-after', '$Ja9NP0cDY0' /* nuxt-injected */)
+ export { useKey as useKeyTwoRenamed }"
+ `)
+ })
+
+ it('should handle shadowing in `source`', async () => {
+ const code = `
+useKey()
+function useKey(arg) {}
+function foo() {
+ useKey()
+ function useKey() { return 'local' }
+ useKey()
+}
+function bar() {
+ const useKey = () => 'local'
+ useKey()
+}
+useKey()
+export { useKey }
+ `
+ expect((await transformPlugin.transform.handler(code, '#app'))?.code.trim()).toMatchInlineSnapshot(`
+ "useKey('$QQV3F06xQZ' /* nuxt-injected */)
+ function useKey(arg) {}
+ function foo() {
+ useKey()
+ function useKey() { return 'local' }
+ useKey()
+ }
+ function bar() {
+ const useKey = () => 'local'
+ useKey()
+ }
+ useKey('$Bil3ev-zNC' /* nuxt-injected */)
+ export { useKey }"
+ `)
+ })
+
+ it('should not add key to default export if no default was specified for `source`', async () => {
+ const code = `
+useKey()
+function useKey(arg) {}
+export default useKey
+ `
+ expect((await transformPlugin.transform.handler(code, '#app'))?.code.trim()).toMatchInlineSnapshot(`undefined`)
+ })
+
+ it('should not add key to anonymous default export if no default was specified for `source`', async () => {
+ const code = `
+useKey()
+export default function useKey(arg) {}
+ `
+ expect((await transformPlugin.transform.handler(code, '#app'))?.code.trim()).toMatchInlineSnapshot(`undefined`)
+ })
+
+ it('should handle default export in `source`', async () => {
+ const code = `
+useFoo()
+function useFoo(arg) {}
+export default useFoo
+ `
+ expect((await transformPlugin.transform.handler(code, '#app/defaultExport'))?.code.trim()).toMatchInlineSnapshot(`
+ "useFoo('$gvnasIOzix' /* nuxt-injected */)
+ function useFoo(arg) {}
+ export default useFoo"
+ `)
+ })
+
+ it('should handle arrow function default export in `source`', async () => {
+ const code = `
+const useFoo = (arg) => {}
+useFoo()
+export default useFoo
+ `
+ expect((await transformPlugin.transform.handler(code, '#app/defaultExport'))?.code.trim()).toMatchInlineSnapshot(`
+ "const useFoo = (arg) => {}
+ useFoo('$gvnasIOzix' /* nuxt-injected */)
+ export default useFoo"
+ `)
+ })
+
+ it('should handle anonymous default export in `source`', async () => {
+ const code = `
+useFoo()
+export default function useFoo(arg) {}
+ `
+ expect((await transformPlugin.transform.handler(code, '#app/defaultExport'))?.code.trim()).toMatchInlineSnapshot(`
+ "useFoo('$gvnasIOzix' /* nuxt-injected */)
+ export default function useFoo(arg) {}"
+ `)
+ })
+
+ it('should not add hash for imports from other sources', async () => {
+ const code = `
+import { useKey } from 'some-other-source'
+import { useKeyTwo } from '#application' // deliberately using an alias starting with #app
+useKey()
+useKeyTwo()
+`
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`undefined`)
+ })
+
+ it('should add hash when renamed in import', async () => {
+ const code = `
+ import { useKey as useRenamedKey } from '#app'
+ import { useKeyTwo as shouldNotAddHash } from './somewhere-else'
+
+ useRenamedKey()
+ shouldNotAddHash()
+ `
+
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import { useKey as useRenamedKey } from '#app'
+ import { useKeyTwo as shouldNotAddHash } from './somewhere-else'
+
+ useRenamedKey('$HJiaryoL2y' /* nuxt-injected */)
+ shouldNotAddHash()"
+ `)
+ })
+
+ it('should add hash for default import', async () => {
+ const code = `
+import useDefault from '#app/defaultExport'
+useDefault()
+ `
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import useDefault from '#app/defaultExport'
+ useDefault('$HJiaryoL2y' /* nuxt-injected */)"
+ `)
+ })
+
+ it('should add hash for renamed default import', async () => {
+ const code = `
+import { default as useRenamedDefault } from '#app/defaultExport'
+useRenamedDefault()
+ `
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import { default as useRenamedDefault } from '#app/defaultExport'
+ useRenamedDefault('$HJiaryoL2y' /* nuxt-injected */)"
+ `)
+ })
+
+ it('should not add hash for non-matching default import', async () => {
+ const code = `
+import useDefault from '#app'
+useDefault()
+ `
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`undefined`)
+ })
+
+ it('should add hash for namespace import', async () => {
+ const code = `
+import * as app from '#app'
+app.useKey()
+useKey()
+ `
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import * as app from '#app'
+ app.useKey('$HJiaryoL2y' /* nuxt-injected */)
+ useKey()"
+ `)
+ })
+
+ it('should handle namespace shadowing', async () => {
+ const code = `
+import * as app from '#app'
+function foo() {
+ const app = { useKey: () => 'local' }
+ app.useKey()
+}
+app.useKey()
+ `
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import * as app from '#app'
+ function foo() {
+ const app = { useKey: () => 'local' }
+ app.useKey()
+ }
+ app.useKey('$HJiaryoL2y' /* nuxt-injected */)"
+ `)
+ })
+
+ it('should not add hash for non-matching namespace import', async () => {
+ const code = `
+import * as other from 'some-other-source'
+other.useKey()
+ `
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`undefined`)
+ })
+
+ it('should handle bracket access on namespace', async () => {
+ const code = `
+import * as app from '#app'
+app['useKey']()
+useKey()
+ `
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import * as app from '#app'
+ app['useKey']('$HJiaryoL2y' /* nuxt-injected */)
+ useKey()"
+ `)
+ })
+
+ it('should not add hash for dynamic bracket access on namespace', async () => {
+ const code = `
+import * as app from '#app'
+app['useKey']() // has key
+const keyName = 'useKey'
+app[keyName]()
+app['use' + 'Key']()
+ `
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import * as app from '#app'
+ app['useKey']('$HJiaryoL2y' /* nuxt-injected */) // has key
+ const keyName = 'useKey'
+ app[keyName]()
+ app['use' + 'Key']()"
+ `)
+ })
+
+ it('should not add hash for template literal access on a namespace', async () => {
+ const code = `
+import * as app from '#app'
+app[\`useKey\`]()
+ `
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`undefined`)
+ })
+
+ it('should not add hash for dynamic import', async () => {
+ const code = `
+const mod = await import('#app')
+mod.useKey()
+ `
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`undefined`)
+ })
+
+ it('should not add hash for destructured namespace', async () => {
+ const code = `
+import * as app from '#app'
+const { useKey } = app
+useKey()
+ `
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`undefined`)
+ })
+
+ it('should not add hash for type-only imports', async () => {
+ const code = `
+import type { useKey } from '#app'
+useKey()
+ `
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`undefined`)
+ })
+
+ it('should handle mixed imports', async () => {
+ const code = `
+import useDefault, { useKey as useRenamedKey, useKeyTwo } from '#app'
+import useDefaultKey from '#app/defaultExport'
+useDefault()
+useDefaultKey()
+useRenamedKey()
+useKeyTwo(() => {})
+ `
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import useDefault, { useKey as useRenamedKey, useKeyTwo } from '#app'
+ import useDefaultKey from '#app/defaultExport'
+ useDefault()
+ useDefaultKey('$HJiaryoL2y' /* nuxt-injected */)
+ useRenamedKey('$yysMIARJHe' /* nuxt-injected */)
+ useKeyTwo(() => {}, '$Cy7hQH5X5O' /* nuxt-injected */)"
+ `)
+ })
+
+ it('should handle renamed same-name function from different source', async () => {
+ const code = `
+import { useKey } from '#app'
+import { useKey as useOtherKey } from 'some-other-source'
+useKey()
+useOtherKey()
+ `
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import { useKey } from '#app'
+ import { useKey as useOtherKey } from 'some-other-source'
+ useKey('$HJiaryoL2y' /* nuxt-injected */)
+ useOtherKey()"
+ `)
+ })
+
+ it('should not add key to tagged templates', async () => {
+ const code = `
+import { useKeyTwo } from '#app'
+useKeyTwo\`template string\`
+ `
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`undefined`)
+ })
+
+ it('should not add key to a conditional callee', async () => {
+ const code = `
+import { useKey } from '#app'
+(Math.random() > 0.5 ? useKey : () => {})()
+Math.random() > 0.5 ? useKey() : null
+ `
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import { useKey } from '#app'
+ (Math.random() > 0.5 ? useKey : () => {})()
+ Math.random() > 0.5 ? useKey('$HJiaryoL2y' /* nuxt-injected */) : null"
+ `)
+ })
+
+ it('should not add key to `call` or `apply`', async () => {
+ const code = `
+import { useKeyTwo } from '#app'
+useKeyTwo.call(this)
+useKeyTwo.apply(this, [])
+ `
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`undefined`)
+ })
+
+ it('should always add key when there is a spread element in the arguments', async () => {
+ const code = `
+import { useKey, useKeyTwo } from '#app'
+useKey(...args)
+useKeyTwo(...args)
+ `
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import { useKey, useKeyTwo } from '#app'
+ useKey(...args, '$HJiaryoL2y' /* nuxt-injected */)
+ useKeyTwo(...args, '$yysMIARJHe' /* nuxt-injected */)"
+ `)
+ })
+
+ it('should not add key when accessed as a deep property', async () => {
+ const code = `
+import * as app from '#app'
+const pkg = { app }
+
+pkg.app.useKey()
+ `
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`undefined`)
+ })
+
+ it('should not add key when processing the same file multiple times (webpack problem)', async () => {
+ const code = `
+ import { useKeyTwo } from '#app'
+ useKeyTwo('$HJiaryoL2y' /* nuxt-injected */)
+ `
+
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`undefined`)
+ })
+
+ // backwards compatibility
+ it('should inject keys for auto-imported functions', async () => {
+ const code = `
+ import { useAutoImported } from '#app'
+ useAutoImported()
+ `
+
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import { useAutoImported } from '#app'
+ useAutoImported('$HJiaryoL2y' /* nuxt-injected */)"
+ `)
+ })
+
+ it('should inject keys for regex-matched function sources', async () => {
+ const code = `
+ import { useRegexKey } from 'some-regex-matched-source'
+ useRegexKey()
+ `
+
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import { useRegexKey } from 'some-regex-matched-source'
+ useRegexKey('$HJiaryoL2y' /* nuxt-injected */)"
+ `)
+ })
+})
+
+describe('core keyed functions', () => {
+ const keyedFunctions: KeyedFunction[] = [
+ // these entries need to 100% match the ones defined in
+ // packages/schema/src/config/build.ts
+ // because some values are hard-coded in the plugin implementation
+ { name: 'callOnce', argumentLength: 3, source: '#app/composables/once' },
+ { name: 'defineNuxtComponent', argumentLength: 2, source: '#app/composables/component' },
+ { name: 'useState', argumentLength: 2, source: '#app/composables/state' },
+ { name: 'useFetch', argumentLength: 3, source: '#app/composables/fetch' },
+ { name: 'useAsyncData', argumentLength: 3, source: '#app/composables/asyncData' },
+ { name: 'useLazyAsyncData', argumentLength: 3, source: '#app/composables/asyncData' },
+ { name: 'useLazyFetch', argumentLength: 3, source: '#app/composables/fetch' },
+ ]
+ const transformPlugin = KeyedFunctionsPlugin({ keyedFunctions, alias: {}, getAutoImports: () => Promise.resolve([]), appDir: '/nuxt/dist/app/' }).raw({}, {} as any) as { transform: { handler: (code: string, id: string) => Promise<{ code: string } | null> } }
+
+ it('should detect string type keys and not add a hash', async () => {
+ const code = `
+ import { useState } from '#app/composables/state'
+ useState('stringKey')
+ useState(\`templateStringKey\`)
+ useState(\`template\${dynamic}StringKey\`)
+ useState("doubleQuotedStringKey")
+ `
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`undefined`)
+ })
+
+ it('should add a hash when key type cannot be determined statically', async () => {
+ const code = `
+ import { useState } from '#app/composables/state'
+ useState('some' + 'key')
+ useState(someVariable)
+ useState(getKey())
+ useState(obj.prop)
+ useState(obj['prop'])
+ useState(obj.met())
+ `
+
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import { useState } from '#app/composables/state'
+ useState('some' + 'key', '$HJiaryoL2y' /* nuxt-injected */)
+ useState(someVariable, '$yysMIARJHe' /* nuxt-injected */)
+ useState(getKey(), '$Cy7hQH5X5O' /* nuxt-injected */)
+ useState(obj.prop, '$Fl_F5LB-IM' /* nuxt-injected */)
+ useState(obj['prop'], '$1GDT7saTf0' /* nuxt-injected */)
+ useState(obj.met(), '$8YFL1gGJy8' /* nuxt-injected */)"
+ `)
+ })
+
+ // --- useState ---
+ describe('useState', () => {
+ it('should add hash when none was provided', async () => {
+ const code = `
+import { useState } from '#app/composables/state'
+useState(() => 1)
+ `
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import { useState } from '#app/composables/state'
+ useState(() => 1, '$HJiaryoL2y' /* nuxt-injected */)"
+ `)
+ })
+
+ it('should not add hash when one was provided as the first argument', async () => {
+ const code = `
+import { useState } from '#app/composables/state'
+useState('key')
+useState('$existingKey', () => 1)
+ `
+
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`undefined`)
+ })
+ })
+
+ // --- useFetch / useLazyFetch ---
+ describe('useFetch', () => {
+ it('should always add a hash', async () => {
+ const code = `
+import { useFetch, useLazyFetch } from '#app/composables/fetch'
+useFetch('/api/data')
+useFetch(() => '/api/data')
+useFetch(url)
+useFetch('/api/data', { method: 'POST' })
+useFetch(() => '/api/data', { method: 'POST' })
+useFetch(url, options)
+
+useLazyFetch('/api/data')
+useLazyFetch(() => '/api/data')
+useLazyFetch(url)
+useLazyFetch('/api/data', { method: 'POST' })
+useLazyFetch(() => '/api/data', { method: 'POST' })
+useLazyFetch(url, options)
+ `
+
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import { useFetch, useLazyFetch } from '#app/composables/fetch'
+ useFetch('/api/data', '$HJiaryoL2y' /* nuxt-injected */)
+ useFetch(() => '/api/data', '$yysMIARJHe' /* nuxt-injected */)
+ useFetch(url, '$Cy7hQH5X5O' /* nuxt-injected */)
+ useFetch('/api/data', { method: 'POST' }, '$Fl_F5LB-IM' /* nuxt-injected */)
+ useFetch(() => '/api/data', { method: 'POST' }, '$1GDT7saTf0' /* nuxt-injected */)
+ useFetch(url, options, '$8YFL1gGJy8' /* nuxt-injected */)
+
+ useLazyFetch('/api/data', '$-6Jq0e1X0N' /* nuxt-injected */)
+ useLazyFetch(() => '/api/data', '$PysQIWKhwV' /* nuxt-injected */)
+ useLazyFetch(url, '$wjhr0zrAT4' /* nuxt-injected */)
+ useLazyFetch('/api/data', { method: 'POST' }, '$H_jcqrI1sJ' /* nuxt-injected */)
+ useLazyFetch(() => '/api/data', { method: 'POST' }, '$_jtliZGAeJ' /* nuxt-injected */)
+ useLazyFetch(url, options, '$TtqJmekP-n' /* nuxt-injected */)"
+ `)
+ })
+ })
+
+ // --- useAsyncData / useLazyAsyncData ---
+ describe('useAsyncData', () => {
+ it('should add key when there was none provided', async () => {
+ const code = `
+import { useAsyncData, useLazyAsyncData } from '#app/composables/asyncData'
+useAsyncData(() => $fetch('/api/data'))
+useAsyncData(() => $fetch('/api/data'), { server: false })
+ `
+
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`
+ "import { useAsyncData, useLazyAsyncData } from '#app/composables/asyncData'
+ useAsyncData(() => $fetch('/api/data'), '$HJiaryoL2y' /* nuxt-injected */)
+ useAsyncData(() => $fetch('/api/data'), { server: false }, '$yysMIARJHe' /* nuxt-injected */)"
+ `)
+ })
+
+ it('should not add key when one was provided as the first or last argument', async () => {
+ const code = `
+import { useAsyncData, useLazyAsyncData } from '#app/composables/asyncData'
+useAsyncData('key', () => $fetch('/api/data'))
+useAsyncData('key', () => $fetch('/api/data'), { server: false })
+
+useLazyAsyncData('key', () => $fetch('/api/data'))
+useLazyAsyncData('key', () => $fetch('/api/data'), { server: false })
+ `
+ expect((await transformPlugin.transform.handler(code, 'plugin.ts'))?.code.trim()).toMatchInlineSnapshot(`undefined`)
+ })
+ })
+})
diff --git a/packages/nuxt/test/layer-aliasing.test.ts b/packages/nuxt/test/layer-aliasing.test.ts
new file mode 100644
index 000000000000..8536c99dfb78
--- /dev/null
+++ b/packages/nuxt/test/layer-aliasing.test.ts
@@ -0,0 +1,137 @@
+import type { NuxtConfigLayer } from 'nuxt/schema'
+import type { UnpluginContextMeta } from 'unplugin'
+import { describe, expect, it } from 'vitest'
+
+import { LayerAliasingPlugin } from '../src/core/plugins/layer-aliasing'
+
+interface TransformHandler {
+ (this: unknown, code: string, id: string): { code: string } | undefined
+}
+
+interface RawPlugin {
+ transformInclude?: (id: string) => boolean | null | undefined
+ transform?: { handler: TransformHandler }
+}
+
+function makeLayer (cwd: string): NuxtConfigLayer {
+ return { cwd, config: { srcDir: cwd, rootDir: cwd } } as NuxtConfigLayer
+}
+
+function createPlugin (layers: NuxtConfigLayer[], framework: 'vite' | 'webpack' = 'vite') {
+ const meta = { framework, webpack: { compiler: {} } } as unknown as UnpluginContextMeta
+ const raw = LayerAliasingPlugin({ root: '/', dev: false, layers }).raw({}, meta)
+ const entry = (Array.isArray(raw) ? raw[0] : raw) as RawPlugin
+ return {
+ transformInclude: entry.transformInclude!,
+ transform: (code: string, id: string) => entry.transform!.handler.call({}, code, id),
+ }
+}
+
+describe('LayerAliasingPlugin transform', () => {
+ const layerDir = '/abs/layer'
+ const otherLayerDir = '/abs/other-layer'
+
+ it('rewrites quoted layer-relative aliases inside layer files', () => {
+ const { transform } = createPlugin([makeLayer(layerDir)])
+
+ const result = transform(
+ `@use '@/styles/global' as g;\n@import "~/styles/extra";`,
+ `${layerDir}/components/UiButton.vue`,
+ )
+
+ expect(result?.code).toBe(`@use '${layerDir}/styles/global' as g;\n@import "${layerDir}/styles/extra";`)
+ })
+
+ it('rewrites url() references that use quoted aliases', () => {
+ const { transform } = createPlugin([makeLayer(layerDir)])
+
+ const result = transform(
+ `.x { background-image: url('@/assets/icon.svg'); }`,
+ `${layerDir}/components/UrlRef.vue`,
+ )
+
+ expect(result?.code).toBe(`.x { background-image: url('${layerDir}/assets/icon.svg'); }`)
+ })
+
+ it('handles `@@`/`~~` root aliases distinctly from `@`/`~`', () => {
+ const layer: NuxtConfigLayer = {
+ cwd: layerDir,
+ config: { srcDir: `${layerDir}/src`, rootDir: layerDir },
+ } as NuxtConfigLayer
+ const { transform } = createPlugin([layer])
+
+ const result = transform(
+ `@use '@/a';\n@use '@@/b';`,
+ `${layer.config.srcDir}/components/X.vue`,
+ )
+
+ expect(result?.code).toBe(`@use '${layerDir}/src/a';\n@use '${layerDir}/b';`)
+ })
+
+ it('picks the longest matching layer srcDir (nested layers)', () => {
+ const parent = makeLayer('/abs')
+ const child = makeLayer('/abs/nested')
+ const { transform } = createPlugin([parent, child])
+
+ const result = transform(
+ `@use '@/foo';`,
+ `/abs/nested/components/X.vue`,
+ )
+
+ expect(result?.code).toBe(`@use '/abs/nested/foo';`)
+ })
+
+ it('does not touch files outside any registered layer', () => {
+ const { transform } = createPlugin([makeLayer(layerDir)])
+
+ expect(transform(`@use '@/styles/global';`, `/other/path/file.scss`)).toBeUndefined()
+ })
+
+ it('does not touch unquoted occurrences (e.g. comments, identifiers)', () => {
+ const { transform } = createPlugin([makeLayer(layerDir)])
+
+ expect(transform(`// see @/styles/global for tokens`, `${layerDir}/file.ts`)).toBeUndefined()
+ })
+
+ it('runs the same way under non-vite frameworks', () => {
+ const { transform } = createPlugin([makeLayer(layerDir)], 'webpack')
+
+ const result = transform(
+ `import x from '@/utils'`,
+ `${layerDir}/components/X.vue`,
+ )
+
+ expect(result?.code).toBe(`import x from '${layerDir}/utils'`)
+ })
+
+ it('on vite, only transforms CSS-flavoured files inside a registered layer', () => {
+ const { transformInclude } = createPlugin([makeLayer(layerDir), makeLayer(otherLayerDir)])
+
+ // Plain `.vue` and `.ts` files are handled by `vite.resolveId` instead.
+ expect(transformInclude(`${layerDir}/components/X.vue`)).toBe(false)
+ expect(transformInclude(`${layerDir}/utils.ts`)).toBe(false)
+
+ // Vite emits virtual sub-IDs for `<style>` blocks; those should be transformed.
+ expect(transformInclude(`${layerDir}/components/X.vue?vue&type=style&index=0&lang.scss`)).toBe(true)
+ expect(transformInclude(`${layerDir}/components/X.vue?vue&type=style&index=0&lang.css`)).toBe(true)
+
+ // Standalone style files in any registered layer are transformed.
+ expect(transformInclude(`${layerDir}/styles/global.scss`)).toBe(true)
+ expect(transformInclude(`${layerDir}/styles/global.sass`)).toBe(true)
+ expect(transformInclude(`${layerDir}/styles/global.less`)).toBe(true)
+ expect(transformInclude(`${layerDir}/styles/global.css`)).toBe(true)
+ expect(transformInclude(`${otherLayerDir}/styles/global.scss`)).toBe(true)
+
+ // Outside any layer: never transformed.
+ expect(transformInclude(`/somewhere/else/global.scss`)).toBe(false)
+ })
+
+ it('on non-vite, transforms any file inside a registered layer', () => {
+ const { transformInclude } = createPlugin([makeLayer(layerDir)], 'webpack')
+
+ expect(transformInclude(`${layerDir}/components/X.vue`)).toBe(true)
+ expect(transformInclude(`${layerDir}/utils.ts`)).toBe(true)
+ expect(transformInclude(`${layerDir}/styles/global.scss`)).toBe(true)
+ expect(transformInclude(`/somewhere/else/file.ts`)).toBe(false)
+ })
+})
diff --git a/packages/nuxt/test/layers-fixture/custom/module.ts b/packages/nuxt/test/layers-fixture/custom/module.ts
new file mode 100644
index 000000000000..510e0b6f569d
--- /dev/null
+++ b/packages/nuxt/test/layers-fixture/custom/module.ts
@@ -0,0 +1 @@
+export default function customLayerModule () {}
diff --git a/packages/nuxt/test/layers-fixture/custom/modules/module.ts b/packages/nuxt/test/layers-fixture/custom/modules/module.ts
new file mode 100644
index 000000000000..0680e9a55400
--- /dev/null
+++ b/packages/nuxt/test/layers-fixture/custom/modules/module.ts
@@ -0,0 +1 @@
+export default function customLayerAutoModule () {}
diff --git a/packages/nuxt/test/layers-fixture/custom/nuxt.config.ts b/packages/nuxt/test/layers-fixture/custom/nuxt.config.ts
new file mode 100644
index 000000000000..2e558b418497
--- /dev/null
+++ b/packages/nuxt/test/layers-fixture/custom/nuxt.config.ts
@@ -0,0 +1,7 @@
+export default defineNuxtConfig({
+ modules: [
+ function customLayerInlineModule () {},
+ import.meta.dirname + '/module',
+ ],
+ css: ['custom.css'],
+})
diff --git a/packages/nuxt/test/layers-fixture/layers/auto/module.ts b/packages/nuxt/test/layers-fixture/layers/auto/module.ts
new file mode 100644
index 000000000000..9fd29852cd14
--- /dev/null
+++ b/packages/nuxt/test/layers-fixture/layers/auto/module.ts
@@ -0,0 +1 @@
+export default function autoLayerModule () {}
diff --git a/packages/nuxt/test/layers-fixture/layers/auto/modules/module.ts b/packages/nuxt/test/layers-fixture/layers/auto/modules/module.ts
new file mode 100644
index 000000000000..f4554ca4379c
--- /dev/null
+++ b/packages/nuxt/test/layers-fixture/layers/auto/modules/module.ts
@@ -0,0 +1 @@
+export default function autoLayerAutoModule () {}
diff --git a/packages/nuxt/test/layers-fixture/layers/auto/nuxt.config.ts b/packages/nuxt/test/layers-fixture/layers/auto/nuxt.config.ts
new file mode 100644
index 000000000000..ea41ed73362b
--- /dev/null
+++ b/packages/nuxt/test/layers-fixture/layers/auto/nuxt.config.ts
@@ -0,0 +1,7 @@
+export default defineNuxtConfig({
+ modules: [
+ function autoLayerInlineModule () {},
+ import.meta.dirname + '/module',
+ ],
+ css: ['duplicate.css', 'auto.css'],
+})
diff --git a/packages/nuxt/test/layers-fixture/module.ts b/packages/nuxt/test/layers-fixture/module.ts
new file mode 100644
index 000000000000..6d50895f1e69
--- /dev/null
+++ b/packages/nuxt/test/layers-fixture/module.ts
@@ -0,0 +1 @@
+export default function projectModule () {}
diff --git a/packages/nuxt/test/layers-fixture/modules/module.ts b/packages/nuxt/test/layers-fixture/modules/module.ts
new file mode 100644
index 000000000000..5f4a210294b3
--- /dev/null
+++ b/packages/nuxt/test/layers-fixture/modules/module.ts
@@ -0,0 +1 @@
+export default function projectAutoModule () {}
diff --git a/packages/nuxt/test/layers-fixture/nuxt.config.ts b/packages/nuxt/test/layers-fixture/nuxt.config.ts
new file mode 100644
index 000000000000..340c5dade90a
--- /dev/null
+++ b/packages/nuxt/test/layers-fixture/nuxt.config.ts
@@ -0,0 +1,11 @@
+export default defineNuxtConfig({
+ extends: ['./custom'],
+ modules: [
+ import.meta.dirname + '/module',
+ function projectInlineModule () {},
+ function css (_options, nuxt) {
+ nuxt.options.css.push('new-css-added-by-module.css')
+ },
+ ],
+ css: ['final-project.css', 'duplicate.css'],
+})
diff --git a/packages/nuxt/test/lazy-hydration-macro-transform.test.ts b/packages/nuxt/test/lazy-hydration-macro-transform.test.ts
new file mode 100644
index 000000000000..637123474387
--- /dev/null
+++ b/packages/nuxt/test/lazy-hydration-macro-transform.test.ts
@@ -0,0 +1,349 @@
+import { describe, expect, it } from 'vitest'
+import { kebabCase, pascalCase } from 'scule'
+import { rolldown } from 'rolldown'
+import vuePlugin from '@vitejs/plugin-vue'
+import vuePluginJsx from '@vitejs/plugin-vue-jsx'
+import type { AddComponentOptions } from '@nuxt/kit'
+
+import { LoaderPlugin } from '../src/components/plugins/loader.ts'
+import { LazyHydrationTransformPlugin } from '../src/components/plugins/lazy-hydration-transform.ts'
+import { LazyHydrationMacroTransformPlugin } from '../src/components/plugins/lazy-hydration-macro-transform.ts'
+
+describe('lazy hydration macro transform', () => {
+ it ('should correctly transform lazy hydration macro in sfc', async () => {
+ const sfc = `
+ <script setup>
+ const LazyHydrationVisibleMyComponent = defineLazyHydrationComponent('visible', () => import('~/components/MyComponent.vue'))
+ const LazyHydrationIdleMyComponent = defineLazyHydrationComponent('idle', () => import('~/components/MyComponent.vue'))
+ const LazyHydrationInteractionMyComponent = defineLazyHydrationComponent('interaction', () => import('~/components/MyComponent.vue'))
+ const LazyHydrationMediaQueryMyComponent = defineLazyHydrationComponent('mediaQuery', () => import('~/components/MyComponent.vue'))
+ const LazyHydrationIfMyComponent = defineLazyHydrationComponent('if', () => import('~/components/MyComponent.vue'))
+ const LazyHydrationTimeMyComponent = defineLazyHydrationComponent('time', () => import('~/components/MyComponent.vue'))
+ const LazyHydrationNeverMyComponent = defineLazyHydrationComponent('never', () => import('~/components/MyComponent.vue'))
+ </script>
+
+ <template>
+ <LazyHydrationVisibleMyComponent />
+ <LazyHydrationIdleMyComponent />
+ <LazyHydrationInteractionMyComponent />
+ <LazyHydrationMediaQueryMyComponent />
+ <LazyHydrationIfMyComponent />
+ <LazyHydrationTimeMyComponent />
+ <LazyHydrationNeverMyComponent />
+ </template>
+ `
+
+ const code = await transform(sfc, '/pages/index.vue')
+ for (const fn of ['createLazyVisibleComponent', 'createLazyIdleComponent', 'createLazyInteractionComponent', 'createLazyMediaQueryComponent', 'createLazyIfComponent', 'createLazyTimeComponent', 'createLazyNeverComponent']) {
+ expect(code).toContain(fn)
+ }
+ expect(code).toContain('from "/client-runtime.mjs"')
+
+ const components = code.split('\n').map(line => line.trim()).filter(line => line.startsWith('const LazyHydration'))
+ expect(components).toHaveLength(7)
+ expect(components.join('\n')).toContain('createLazyVisibleComponent("components/MyComponent.vue"')
+ expect(components.join('\n')).toContain('createLazyIdleComponent("components/MyComponent.vue"')
+ expect(components.join('\n')).toContain('createLazyInteractionComponent("components/MyComponent.vue"')
+ expect(components.join('\n')).toContain('createLazyMediaQueryComponent("components/MyComponent.vue"')
+ expect(components.join('\n')).toContain('createLazyIfComponent("components/MyComponent.vue"')
+ expect(components.join('\n')).toContain('createLazyTimeComponent("components/MyComponent.vue"')
+ expect(components.join('\n')).toContain('createLazyNeverComponent("components/MyComponent.vue"')
+ })
+
+ it ('should correctly transform lazy hydration macro in sfc with non-auto-imported components', async () => {
+ const sfc = `
+ <script setup>
+ const LazyHydrationIfMyComponent = defineLazyHydrationComponent('if', () => import('~/components/MyComponent.vue'))
+ </script>
+
+ <template>
+ <LazyHydrationIfMyComponent />
+ </template>
+ `
+
+ const code = await transform(sfc, '/pages/index.vue', true)
+ expect(code).toContain(`import { createLazyIfComponent } from "/client-runtime.mjs";`)
+
+ const component = code.split('\n').map(line => line.trim()).find(line => line.startsWith('const LazyHydration'))
+ expect(component).toMatchInlineSnapshot(`"const LazyHydrationIfMyComponent = createLazyIfComponent("components/MyComponent.vue", () => import("~/components/MyComponent.vue"));"`)
+ })
+
+ it ('should correctly transform lazy hydration macro in jsx', async () => {
+ const component = `
+ import { defineComponent } from 'vue'
+ export default defineComponent({
+ setup () {
+ const LazyHydrationVisibleMyComponent = defineLazyHydrationComponent('visible', () => import('~/components/MyComponent.vue'))
+ const LazyHydrationIdleMyComponent = defineLazyHydrationComponent('idle', () => import('~/components/MyComponent.vue'))
+ const LazyHydrationInteractionMyComponent = defineLazyHydrationComponent('interaction', () => import('~/components/MyComponent.vue'))
+ const LazyHydrationMediaQueryMyComponent = defineLazyHydrationComponent('mediaQuery', () => import('~/components/MyComponent.vue'))
+ const LazyHydrationIfMyComponent = defineLazyHydrationComponent('if', () => import('~/components/MyComponent.vue'))
+ const LazyHydrationTimeMyComponent = defineLazyHydrationComponent('time', () => import('~/components/MyComponent.vue'))
+ const LazyHydrationNeverMyComponent = defineLazyHydrationComponent('never', () => import('~/components/MyComponent.vue'))
+
+ return () => <>
+ <LazyHydrationVisibleMyComponent />
+ <LazyHydrationIdleMyComponent />
+ <LazyHydrationInteractionMyComponent />
+ <LazyHydrationMediaQueryMyComponent />
+ <LazyHydrationIfMyComponent />
+ <LazyHydrationTimeMyComponent />
+ <LazyHydrationNeverMyComponent />
+ </>
+ }
+ })
+ `
+
+ const code = await transform(component, '/pages/index.tsx')
+ for (const fn of ['createLazyVisibleComponent', 'createLazyIdleComponent', 'createLazyInteractionComponent', 'createLazyMediaQueryComponent', 'createLazyIfComponent', 'createLazyTimeComponent', 'createLazyNeverComponent']) {
+ expect(code).toContain(fn)
+ }
+ expect(code).toContain('from "/client-runtime.mjs"')
+
+ const components = code.split('\n').map(line => line.trim()).filter(line => line.startsWith('const LazyHydration'))
+ expect(components).toHaveLength(7)
+ expect(components.join('\n')).toContain('createLazyVisibleComponent("components/MyComponent.vue"')
+ expect(components.join('\n')).toContain('createLazyNeverComponent("components/MyComponent.vue"')
+ })
+
+ it ('should correctly transform lazy hydration macro in ts', async () => {
+ const component = `
+ import { defineComponent, h } from 'vue'
+ export default defineComponent({
+ setup () {
+ const LazyHydrationVisibleMyComponent = defineLazyHydrationComponent('visible', () => import('~/components/MyComponent.vue'))
+ const LazyHydrationIdleMyComponent = defineLazyHydrationComponent('idle', () => import('~/components/MyComponent.vue'))
+ const LazyHydrationInteractionMyComponent = defineLazyHydrationComponent('interaction', () => import('~/components/MyComponent.vue'))
+ const LazyHydrationMediaQueryMyComponent = defineLazyHydrationComponent('mediaQuery', () => import('~/components/MyComponent.vue'))
+ const LazyHydrationIfMyComponent = defineLazyHydrationComponent('if', () => import('~/components/MyComponent.vue'))
+ const LazyHydrationTimeMyComponent = defineLazyHydrationComponent('time', () => import('~/components/MyComponent.vue'))
+ const LazyHydrationNeverMyComponent = defineLazyHydrationComponent('never', () => import('~/components/MyComponent.vue'))
+
+ return () => h('div', undefined, [
+ h(LazyHydrationVisibleMyComponent),
+ h(LazyHydrationIdleMyComponent),
+ h(LazyHydrationInteractionMyComponent),
+ h(LazyHydrationMediaQueryMyComponent),
+ h(LazyHydrationIfMyComponent),
+ h(LazyHydrationTimeMyComponent),
+ h(LazyHydrationNeverMyComponent),
+ ])
+ }
+ })
+ `
+
+ const code = await transform(component, '/pages/index.tsx')
+ for (const fn of ['createLazyVisibleComponent', 'createLazyIdleComponent', 'createLazyInteractionComponent', 'createLazyMediaQueryComponent', 'createLazyIfComponent', 'createLazyTimeComponent', 'createLazyNeverComponent']) {
+ expect(code).toContain(fn)
+ }
+ expect(code).toContain('from "/client-runtime.mjs"')
+
+ const components = code.split('\n').map(line => line.trim()).filter(line => line.startsWith('const LazyHydration'))
+ expect(components).toHaveLength(7)
+ expect(components.join('\n')).toContain('createLazyVisibleComponent("components/MyComponent.vue"')
+ expect(components.join('\n')).toContain('createLazyNeverComponent("components/MyComponent.vue"')
+ })
+
+ it('should handle arrow functions with block statements', async () => {
+ const sfc = `
+ <script setup>
+ const LazyHydrationVisibleMyComponent = defineLazyHydrationComponent('visible', () => {
+ return import('~/components/MyComponent.vue')
+ })
+ const LazyHydrationIdleMyComponent = defineLazyHydrationComponent('idle', () => {
+ // Some comment
+ return import('~/components/MyComponent.vue')
+ })
+ </script>
+
+ <template>
+ <LazyHydrationVisibleMyComponent />
+ <LazyHydrationIdleMyComponent />
+ </template>
+ `
+
+ const code = await transform(sfc, '/pages/index.vue')
+ expect(code).toContain('createLazyVisibleComponent')
+ expect(code).toContain('createLazyIdleComponent')
+ expect(code).toContain('from "/client-runtime.mjs"')
+
+ const components = code.split('\n').map(line => line.trim()).filter(line => line.startsWith('const LazyHydration')).join('\n')
+ expect(components).toContain(`const LazyHydrationVisibleMyComponent = createLazyVisibleComponent("components/MyComponent.vue"`)
+ expect(components).toContain(`const LazyHydrationIdleMyComponent = createLazyIdleComponent("components/MyComponent.vue"`)
+ })
+
+ it('should handle async/await patterns', async () => {
+ const sfc = `
+ <script setup>
+ const LazyHydrationVisibleMyComponent = defineLazyHydrationComponent('visible', async () => await import('~/components/MyComponent.vue'))
+ const LazyHydrationIdleMyComponent = defineLazyHydrationComponent('idle', async () => {
+ return await import('~/components/MyComponent.vue')
+ })
+ </script>
+
+ <template>
+ <LazyHydrationVisibleMyComponent />
+ <LazyHydrationIdleMyComponent />
+ </template>
+ `
+
+ const code = await transform(sfc, '/pages/index.vue')
+ expect(code).toContain('createLazyVisibleComponent')
+ expect(code).toContain('createLazyIdleComponent')
+ expect(code).toContain('from "/client-runtime.mjs"')
+
+ const components = code.split('\n').map(line => line.trim()).filter(line => line.startsWith('const LazyHydration')).join('\n')
+ expect(components).toContain(`const LazyHydrationVisibleMyComponent = createLazyVisibleComponent("components/MyComponent.vue"`)
+ expect(components).toContain(`const LazyHydrationIdleMyComponent = createLazyIdleComponent("components/MyComponent.vue"`)
+ })
+
+ it('should handle parenthesized expressions', async () => {
+ const sfc = `
+ <script setup>
+ const LazyHydrationVisibleMyComponent = defineLazyHydrationComponent('visible', () => (import('~/components/MyComponent.vue')))
+ const LazyHydrationIdleMyComponent = defineLazyHydrationComponent('idle', () => {
+ return (import('~/components/MyComponent.vue'))
+ })
+ </script>
+
+ <template>
+ <LazyHydrationVisibleMyComponent />
+ <LazyHydrationIdleMyComponent />
+ </template>
+ `
+
+ const code = await transform(sfc, '/pages/index.vue')
+ expect(code).toContain('createLazyVisibleComponent')
+ expect(code).toContain('createLazyIdleComponent')
+ expect(code).toContain('from "/client-runtime.mjs"')
+
+ const components = code.split('\n').map(line => line.trim()).filter(line => line.startsWith('const LazyHydration')).join('\n')
+ expect(components).toContain(`const LazyHydrationVisibleMyComponent = createLazyVisibleComponent("components/MyComponent.vue"`)
+ expect(components).toContain(`const LazyHydrationIdleMyComponent = createLazyIdleComponent("components/MyComponent.vue"`)
+ })
+
+ it('should handle member expressions and method chaining', async () => {
+ const sfc = `
+ <script setup>
+ const LazyHydrationVisibleMyComponent = defineLazyHydrationComponent('visible', () => import('~/components/MyComponent.vue').then(m => m.default))
+ const LazyHydrationIdleMyComponent = defineLazyHydrationComponent('idle', () => {
+ return import('~/components/MyComponent.vue').then(m => m.default)
+ })
+ </script>
+
+ <template>
+ <LazyHydrationVisibleMyComponent />
+ <LazyHydrationIdleMyComponent />
+ </template>
+ `
+
+ const code = await transform(sfc, '/pages/index.vue')
+ expect(code).toContain('createLazyVisibleComponent')
+ expect(code).toContain('createLazyIdleComponent')
+ expect(code).toContain('from "/client-runtime.mjs"')
+
+ const components = code.split('\n').map(line => line.trim()).filter(line => line.startsWith('const LazyHydration')).join('\n')
+ expect(components).toContain(`const LazyHydrationVisibleMyComponent = createLazyVisibleComponent("components/MyComponent.vue"`)
+ expect(components).toContain(`const LazyHydrationIdleMyComponent = createLazyIdleComponent("components/MyComponent.vue"`)
+ })
+
+ it('should handle conditional expressions', async () => {
+ const sfc = `
+ <script setup>
+ const LazyHydrationVisibleMyComponent = defineLazyHydrationComponent('visible', () =>
+ process.env.NODE_ENV === 'development'
+ ? import('~/components/MyComponent.vue')
+ : import('~/components/MyComponent.vue')
+ )
+ </script>
+
+ <template>
+ <LazyHydrationVisibleMyComponent />
+ </template>
+ `
+
+ const code = await transform(sfc, '/pages/index.vue')
+ expect(code).toContain(`import { createLazyVisibleComponent } from "/client-runtime.mjs";`)
+
+ const component = code.split('\n').map(line => line.trim()).find(line => line.startsWith('const LazyHydration'))
+ expect(component).toContain(`createLazyVisibleComponent("components/MyComponent.vue"`)
+ })
+
+ it('should handle complex nested patterns', async () => {
+ const sfc = `
+ <script setup>
+ const LazyHydrationVisibleMyComponent = defineLazyHydrationComponent('visible', async () => {
+ return await (import('~/components/MyComponent.vue')).then(m => m.default)
+ })
+ </script>
+
+ <template>
+ <LazyHydrationVisibleMyComponent />
+ </template>
+ `
+
+ const code = await transform(sfc, '/pages/index.vue')
+ expect(code).toContain(`import { createLazyVisibleComponent } from "/client-runtime.mjs";`)
+
+ const components = code.split('\n').map(line => line.trim()).filter(line => line.startsWith('const LazyHydration')).join('\n')
+ expect(components).toContain(`createLazyVisibleComponent("components/MyComponent.vue"`)
+ })
+})
+
+async function transform (code: string, filename: string, noComponents?: boolean) {
+ const components = noComponents
+ ? []
+ : ([{ name: 'MyComponent', filePath: '/components/MyComponent.vue' }] as AddComponentOptions[]).map(opts => ({
+ export: opts.export || 'default',
+ chunkName: 'components/' + kebabCase(opts.name),
+ global: opts.global ?? false,
+ kebabName: kebabCase(opts.name || ''),
+ pascalName: pascalCase(opts.name || ''),
+ prefetch: false,
+ preload: false,
+ mode: 'all' as const,
+ shortPath: opts.filePath,
+ priority: 0,
+ meta: {},
+ ...opts,
+ }))
+
+ const bundle = await rolldown({
+ input: filename,
+ external: id => id !== filename,
+ plugins: [
+ {
+ name: 'entry',
+ resolveId (id) {
+ if (id === filename) {
+ return id
+ }
+ },
+ load (id) {
+ if (id === filename) {
+ return code
+ }
+ },
+ },
+ LazyHydrationTransformPlugin({ getComponents: () => components }).rolldown(),
+ vuePlugin(),
+ vuePluginJsx(),
+ LoaderPlugin({
+ clientDelayedComponentRuntime: '/client-runtime.mjs',
+ serverComponentRuntime: '/server-runtime.mjs',
+ getComponents: () => components,
+ srcDir: '/',
+ mode: 'server',
+ }).rolldown(),
+ LazyHydrationMacroTransformPlugin({
+ clientDelayedComponentRuntime: '/client-runtime.mjs',
+ srcDir: '/',
+ alias: {
+ '~/': '/',
+ },
+ }).rolldown(),
+ ],
+ })
+ const { output: [chunk] } = await bundle.generate({})
+ return chunk.code.trim()
+}
diff --git a/packages/nuxt/test/load-nuxt.bench.ts b/packages/nuxt/test/load-nuxt.bench.ts
new file mode 100644
index 000000000000..c9fd44338062
--- /dev/null
+++ b/packages/nuxt/test/load-nuxt.bench.ts
@@ -0,0 +1,41 @@
+import { rm } from 'node:fs/promises'
+import { beforeAll, bench, describe } from 'vitest'
+import { join } from 'pathe'
+import { loadNuxt } from 'nuxt'
+import { findWorkspaceDir } from 'pkg-types'
+
+const repoRoot = await findWorkspaceDir()
+
+const emptyDir = join(repoRoot, 'node_modules/fixture')
+const basicTestFixtureDir = join(repoRoot, 'test/fixtures/basic')
+
+describe('loadNuxt', () => {
+ beforeAll(async () => {
+ await Promise.all([
+ rm(join(emptyDir, 'node_modules/load-nuxt/.nuxt'), { recursive: true, force: true }),
+ rm(join(basicTestFixtureDir, 'node_modules/load-nuxt/.nuxt'), { recursive: true, force: true }),
+ ])
+ })
+
+ bench('loadNuxt in an empty directory', async () => {
+ const nuxt = await loadNuxt({
+ cwd: emptyDir,
+ ready: true,
+ overrides: {
+ buildDir: join(emptyDir, 'node_modules/load-nuxt/.nuxt'),
+ },
+ })
+ await nuxt.close()
+ })
+
+ bench('loadNuxt in the basic test fixture', async () => {
+ const nuxt = await loadNuxt({
+ cwd: basicTestFixtureDir,
+ ready: true,
+ overrides: {
+ buildDir: join(basicTestFixtureDir, 'node_modules/load-nuxt/.nuxt'),
+ },
+ })
+ await nuxt.close()
+ })
+})
diff --git a/packages/nuxt/test/load-nuxt.test.ts b/packages/nuxt/test/load-nuxt.test.ts
new file mode 100644
index 000000000000..71db4050e6e6
--- /dev/null
+++ b/packages/nuxt/test/load-nuxt.test.ts
@@ -0,0 +1,189 @@
+import { fileURLToPath } from 'node:url'
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
+import { normalize } from 'pathe'
+import { withoutTrailingSlash } from 'ufo'
+import { logger, tryUseNuxt, useNuxt } from '@nuxt/kit'
+import { findWorkspaceDir } from 'pkg-types'
+import { loadNuxt } from '../src/index.ts'
+import type { NuxtConfig } from '../schema.ts'
+
+const repoRoot = await findWorkspaceDir()
+
+vi.stubGlobal('console', {
+ ...console,
+ error: vi.fn(console.error),
+ warn: vi.fn(console.warn),
+})
+
+const loggerWarn = vi.spyOn(logger, 'warn')
+vi.mock('pkg-types', async (og) => {
+ const originalPkgTypes = (await og<typeof import('pkg-types')>())
+ return {
+ ...originalPkgTypes,
+ readPackageJSON: vi.fn(originalPkgTypes.readPackageJSON),
+ }
+})
+
+beforeEach(() => {
+ loggerWarn.mockClear()
+})
+afterEach(() => {
+ vi.clearAllMocks()
+})
+
+describe('loadNuxt', () => {
+ it('respects hook overrides', async () => {
+ let hookRan = false
+ const nuxt = await loadNuxt({
+ cwd: repoRoot,
+ ready: true,
+ overrides: {
+ hooks: {
+ ready () {
+ hookRan = true
+ },
+ },
+ },
+ })
+ await nuxt.close()
+ expect(hookRan).toBe(true)
+ })
+
+ it('ensures layer CSS remains in order', async () => {
+ const layerFixtureDir = withoutTrailingSlash(normalize(fileURLToPath(new URL('./layers-fixture', import.meta.url))))
+ const nuxt = await loadNuxt({
+ cwd: layerFixtureDir,
+ overrides: {
+ css: ['override.css'],
+ },
+ })
+ await nuxt.close()
+
+ expect(nuxt.options.css).toMatchInlineSnapshot(`
+ [
+ "custom.css",
+ "auto.css",
+ "final-project.css",
+ "duplicate.css",
+ "override.css",
+ "new-css-added-by-module.css",
+ ]
+ `)
+ })
+
+ it('load multiple nuxt', async () => {
+ await Promise.all([
+ loadNuxt({
+ cwd: repoRoot,
+ }),
+ loadNuxt({
+ cwd: repoRoot,
+ }),
+ ])
+ expect(loggerWarn).not.toHaveBeenCalled()
+ })
+
+ it('expect hooks to get the correct context outside of initNuxt', async () => {
+ const nuxt = await loadNuxt({
+ cwd: repoRoot,
+ })
+
+ // @ts-expect-error - random hook
+ nuxt.hook('test', () => {
+ expect(useNuxt().__name).toBe(nuxt.__name)
+ })
+
+ expect(tryUseNuxt()?.__name).not.toBe(nuxt.__name)
+
+ // second nuxt context
+ const second = await loadNuxt({
+ cwd: repoRoot,
+ })
+
+ expect(second.__name).not.toBe(nuxt.__name)
+ expect(tryUseNuxt()?.__name).not.toBe(nuxt.__name)
+
+ // @ts-expect-error - random hook
+ await nuxt.callHook('test')
+
+ expect(loggerWarn).not.toHaveBeenCalled()
+ })
+
+ it('ensures layer modules remain in order', async () => {
+ const layerFixtureDir = withoutTrailingSlash(normalize(fileURLToPath(new URL('./layers-fixture', import.meta.url))))
+ const nuxt = await loadNuxt({ cwd: layerFixtureDir })
+ await nuxt.close()
+
+ const modules = nuxt.options._installedModules.map(item => item.meta.name ?? item.module.name)
+
+ expect(modules).toMatchInlineSnapshot(`
+ [
+ "customLayerInlineModule",
+ "customLayerModule",
+ "customLayerAutoModule",
+ "autoLayerInlineModule",
+ "autoLayerModule",
+ "autoLayerAutoModule",
+ "projectModule",
+ "projectInlineModule",
+ "css",
+ "projectAutoModule",
+ "@nuxt/devtools",
+ "nuxt:pages",
+ "nuxt:meta",
+ "nuxt:components",
+ "nuxt:compiler",
+ "nuxt:imports",
+ "nuxt:nuxt-config-schema",
+ "@nuxt/telemetry",
+ ]
+ `)
+ })
+
+ it('includes layer server directories in nitro tsconfig', async () => {
+ const layerFixtureDir = withoutTrailingSlash(
+ normalize(fileURLToPath(new URL('./layers-fixture', import.meta.url))),
+ )
+
+ const nuxt = await loadNuxt({ cwd: layerFixtureDir, ready: true })
+
+ const tsConfigInclude = (nuxt as any)._nitro?.options.typescript?.tsConfig?.include ?? []
+
+ const hasLayerServer = tsConfigInclude.some((p: string) =>
+ p.replace(/\\/g, '/').includes('layers/auto/server'),
+ )
+
+ expect(hasLayerServer).toBe(true)
+
+ await nuxt.close()
+ })
+
+ it('includes #server alias in nitro tsconfig paths', async () => {
+ const nuxt = await loadNuxt({ cwd: repoRoot, ready: true })
+
+ const tsConfigPaths = (nuxt as any)._nitro?.options.typescript?.tsConfig?.compilerOptions?.paths ?? {}
+
+ expect(tsConfigPaths).toHaveProperty('#server')
+ expect(tsConfigPaths).toHaveProperty('#server/*')
+
+ await nuxt.close()
+ })
+})
+
+const pagesDetectionTests: [test: string, overrides: NuxtConfig, result: NuxtConfig['pages']][] = [
+ ['pages dir', {}, { enabled: true }],
+ ['pages dir empty', { dir: { pages: 'empty-dir' } }, { enabled: false }],
+ ['user config', { pages: false }, { enabled: false }],
+ ['user config', { pages: { enabled: false } }, { enabled: false }],
+ ['user config', { pages: { enabled: true, pattern: '**/*{.vue}' } }, { enabled: true, pattern: '**/*{.vue}' }],
+]
+
+const pagesFixtureDir = withoutTrailingSlash(normalize(fileURLToPath(new URL('./pages-fixture', import.meta.url))))
+describe('pages detection', () => {
+ it.each(pagesDetectionTests)('%s `%s`', async (_, overrides, result) => {
+ const nuxt = await loadNuxt({ cwd: pagesFixtureDir, overrides, ready: true })
+ // @ts-expect-error should resolve to object?
+ expect(nuxt.options.pages).toMatchObject(result)
+ await nuxt.close()
+ })
+})
diff --git a/packages/nuxt/test/naming.test.ts b/packages/nuxt/test/naming.test.ts
new file mode 100644
index 000000000000..e3d01f0aa8b4
--- /dev/null
+++ b/packages/nuxt/test/naming.test.ts
@@ -0,0 +1,42 @@
+import { describe, expect, it } from 'vitest'
+import { pascalCase } from 'scule'
+import { getNameFromPath, resolveComponentNameSegments } from '../src/core/utils/index.ts'
+
+describe('getNameFromPath', () => {
+ const cases: Record<string, string> = {
+ 'base.vue': 'base',
+ 'base/base.vue': 'base',
+ 'base/base-layout.vue': 'base-layout',
+ 'base-1-layout': 'base-1-layout',
+ }
+ it.each(Object.keys(cases))('correctly deduplicates segments - %s', (filename) => {
+ expect(getNameFromPath(filename)).toEqual(cases[filename])
+ })
+})
+
+const tests: Array<[string, string[], string]> = [
+ ['WithClientOnlySetup', ['Client'], 'ClientWithClientOnlySetup'],
+ ['ItemHolderItem', ['Item', 'Holder', 'Item'], 'ItemHolderItem'],
+ ['Item', ['Item'], 'Item'],
+ ['Item', ['Item', 'Item'], 'Item'],
+ ['ItemTest', ['Item', 'Test'], 'ItemTest'],
+ ['ThingItemTest', ['Item', 'Thing'], 'ItemThingItemTest'],
+ ['Item', ['Thing', 'Item'], 'ThingItem'],
+ ['Item', ['Item', 'Holder', 'Item'], 'ItemHolderItem'],
+ ['ItemHolder', ['Item', 'Holder', 'Item'], 'ItemHolderItemHolder'],
+ ['ThingItemTest', ['Item', 'Thing', 'Foo'], 'ItemThingFooThingItemTest'],
+ ['ItemIn', ['Item', 'Holder', 'Item', 'In'], 'ItemHolderItemIn'],
+ ['Item', ['Item', 'Holder', 'Test'], 'ItemHolderTestItem'],
+ ['ItemHolderItem', ['Item', 'Holder', 'Item', 'Holder'], 'ItemHolderItemHolderItem'],
+ ['Icones', ['Icon'], 'IconIcones'],
+ ['Icon', ['Icones'], 'IconesIcon'],
+ ['IconHolder', ['IconHolder'], 'IconHolder'],
+ ['GameList', ['Desktop', 'ShareGame', 'Review', 'Detail'], 'DesktopShareGameReviewDetailGameList'],
+ ['base-1-layout', [], 'Base1Layout'],
+]
+
+describe('components:resolveComponentNameSegments', () => {
+ it.each(tests)('resolves %s with prefix parts %s and filename %s', (fileName, prefixParts: string[], result) => {
+ expect(pascalCase(resolveComponentNameSegments(fileName, prefixParts))).toBe(result)
+ })
+})
diff --git a/packages/nuxt/test/nitro-ssr-routes.test.ts b/packages/nuxt/test/nitro-ssr-routes.test.ts
new file mode 100644
index 000000000000..419070f8df44
--- /dev/null
+++ b/packages/nuxt/test/nitro-ssr-routes.test.ts
@@ -0,0 +1,86 @@
+import { describe, expect, it } from 'vitest'
+
+import { pageTests } from './pages.test.ts'
+import { toRou3Patterns } from '../src/pages/utils.ts'
+
+describe('nitro-ssr-routes', () => {
+ it('should resolve SSR routes correctly', () => {
+ const paths = pageTests.map(test => test.output!).filter(Boolean).flat()
+ expect(toRou3Patterns(paths)).toMatchInlineSnapshot(`
+ [
+ "/",
+ "/parent",
+ "/parent/child",
+ "/parent",
+ "/parent/child",
+ "/parent/:child",
+ "/parent-:child",
+ "/**:stories",
+ "/stories/:id",
+ "/stories/:id",
+ "/**:stories",
+ "/snake_case",
+ "/kebab-case",
+ "/:foo",
+ "/:foo",
+ "/",
+ "/:slug",
+ "/:bar",
+ "/opt/:slug",
+ "/nonopt/:slug",
+ "/optional/:opt",
+ "/:sub/route-:slug",
+ "/optional/prefix-:opt",
+ "/optional/:opt_postfix",
+ "/optional/prefix-:opt_postfix",
+ "/",
+ "/**:slug",
+ "/**:slug/:id",
+ "/:a1_1a",
+ "/:b2_2b",
+ "/:b2__2b",
+ "/:c33c",
+ "/:d44d",
+ "/",
+ "/test\\:name",
+ "/%E6%B5%8B%E8%AF%95",
+ "/%E6%96%87%E6%A1%A3",
+ "/%E6%96%87%E6%A1%A3/%E4%BB%8B%E7%BB%8D",
+ "/%D8%AE%D8%A7%D8%B5\\:_D8_AC_D8_AF_D9_8A_D8_AF",
+ "/a%26b",
+ "/a%5Cb",
+ "/:foo",
+ "/:foo",
+ "/param",
+ "/param/sibling",
+ "/param",
+ "/param/sibling",
+ "/param",
+ "/wrapper-expose/other",
+ "/wrapper-expose/other/sibling",
+ "/wrapper-expose/other",
+ "/",
+ "/all",
+ "/page1",
+ "/page1/:id",
+ "/page1",
+ "/",
+ "/",
+ "/products",
+ "/",
+ "/",
+ "/page-with-meta",
+ "/**:id",
+ "/**:id",
+ "/page-with-meta",
+ "/page-with-props",
+ "/",
+ "/about",
+ "/about",
+ "/about",
+ "/foo",
+ "/foo/bar",
+ ]
+ `)
+ })
+})
diff --git a/packages/nuxt/test/nitro/render-index.ts b/packages/nuxt/test/nitro/render-index.ts
new file mode 100644
index 000000000000..283cf8adc24c
--- /dev/null
+++ b/packages/nuxt/test/nitro/render-index.ts
@@ -0,0 +1,16 @@
+// @ts-expect-error untyped
+import '#nitro-internal-pollyfills'
+import { useNitroApp } from 'nitro/app'
+
+const nitroApp = useNitroApp()
+
+async function renderIndex () {
+ const res = await nitroApp.fetch(new Request('/'))
+ if (!res.ok) {
+ throw new Error(`Failed to render /: ${res.status} ${res.statusText}`)
+ }
+ // eslint-disable-next-line no-console
+ console.log(await res.text())
+}
+
+renderIndex()
diff --git a/packages/nuxt/test/nuxt-link.test.ts b/packages/nuxt/test/nuxt-link.test.ts
new file mode 100644
index 000000000000..c7302bb540f8
--- /dev/null
+++ b/packages/nuxt/test/nuxt-link.test.ts
@@ -0,0 +1,479 @@
+import { describe, expect, it, vi } from 'vitest'
+import type { RouteLocation, RouteLocationRaw } from 'vue-router'
+import { ref } from 'vue'
+import { withQuery } from 'ufo'
+import type { NuxtLinkOptions, NuxtLinkProps } from '../src/app/components/nuxt-link.ts'
+import { defineNuxtLink } from '../src/app/components/nuxt-link.ts'
+import { useRuntimeConfig } from '../src/app/nuxt.ts'
+
+// mocks `useRuntimeConfig()`
+vi.mock('../src/app/nuxt', () => ({
+ useRuntimeConfig: vi.fn(() => ({
+ app: {
+ baseURL: '/',
+ },
+ })),
+}))
+
+// Mocks `h()`
+vi.mock('vue', async () => {
+ const vue: Record<string, unknown> = await vi.importActual('vue')
+ return {
+ ...vue,
+ resolveComponent: (name: string) => name,
+ h: (...args: any[]) => args,
+ }
+})
+
+// Mocks Nuxt `useRouter()` and `navigateTo()`
+const navigateToMock = vi.fn()
+vi.mock('../src/app/composables/router', () => ({
+ resolveRouteObject (to: Exclude<RouteLocationRaw, string>) {
+ return withQuery(to.path || '', to.query || {}) + (to.hash || '')
+ },
+ navigateTo: (...args: unknown[]) => navigateToMock(...args),
+ useRouter: () => ({
+ resolve: (route: string | RouteLocation): Partial<RouteLocation> & { href: string } => {
+ if (typeof route === 'string') {
+ return { path: route, href: route }
+ }
+ return {
+ path: route.path || `/${route.name?.toString()}`,
+ query: route.query || undefined,
+ hash: route.hash || undefined,
+ href: route.path || `/${route.name?.toString()}`,
+ }
+ },
+ currentRoute: { value: { path: '/' } },
+ }),
+}))
+
+// Helpers for test visibility
+const EXTERNAL = 'a'
+const INTERNAL = 'RouterLink'
+
+// Renders a `<NuxtLink />`
+const nuxtLink = (
+ props: NuxtLinkProps = {},
+ nuxtLinkOptions: Partial<NuxtLinkOptions> = {},
+): { type: string, props: Record<string, unknown>, slots: unknown } => {
+ const component = defineNuxtLink({ componentName: 'NuxtLink', ...nuxtLinkOptions })
+
+ const [type, _props, slots] = (
+ component as unknown as { setup: (props: NuxtLinkProps, context: { slots: Record<string, () => unknown> }) => () => [string, Record<string, unknown>, unknown] }
+ ).setup(props, { slots: { default: () => null } })()
+
+ return { type, props: _props, slots }
+}
+
+describe('nuxt-link:to', () => {
+ it('renders link with `to` prop', () => {
+ expect(nuxtLink({ to: '/to' }).props.to).toBe('/to')
+ })
+
+ it('renders link with `href` prop', () => {
+ expect(nuxtLink({ href: '/href' }).props.to).toBe('/href')
+ })
+
+ it('renders link with `to` prop and warns about `href` prop conflict', () => {
+ const consoleWarnSpy = vi.spyOn(console, 'warn').mockImplementation(vi.fn() as any)
+
+ expect(nuxtLink({ to: '/to', href: '/href' }).props.to).toBe('/to')
+ // TODO: Uncomment when `dev` mode for tests is available
+ // expect(consoleWarnSpy).toHaveBeenCalledOnce()
+
+ consoleWarnSpy.mockRestore()
+ })
+
+ it('without to and href', () => {
+ const link = nuxtLink()
+ expect(link.props.href).toBe(null)
+ expect(link.props.rel).toBe(null)
+ })
+})
+
+describe('nuxt-link:isExternal', () => {
+ it('returns based on `to` value', () => {
+ // Internal
+ expect(nuxtLink({ to: '/foo' }).type).toBe(INTERNAL)
+ expect(nuxtLink({ to: '/foo/bar' }).type).toBe(INTERNAL)
+ expect(nuxtLink({ to: '/foo/bar?baz=qux' }).type).toBe(INTERNAL)
+
+ // External
+ expect(nuxtLink({ to: 'https://nuxtjs.org' }).type).toBe(EXTERNAL)
+ expect(nuxtLink({ to: '//nuxtjs.org' }).type).toBe(EXTERNAL)
+ expect(nuxtLink({ to: 'tel:0123456789' }).type).toBe(EXTERNAL)
+ expect(nuxtLink({ to: 'mailto:hello@nuxtlabs.com' }).type).toBe(EXTERNAL)
+ })
+
+ it('returns `false` when `to` is a route location object', () => {
+ expect(nuxtLink({ to: { path: '/to' } }).type).toBe(INTERNAL)
+ })
+
+ it('returns `true` when `to` has a `target`', () => {
+ expect(nuxtLink({ to: { path: '/to' }, target: '_blank' }).type).toBe(EXTERNAL)
+ })
+
+ it('honors `external` prop', () => {
+ expect(nuxtLink({ to: '/to', external: true }).type).toBe(EXTERNAL)
+ expect(nuxtLink({ to: '/to', external: false }).type).toBe(INTERNAL)
+ })
+
+ it('returns `true` when using the `target` prop', () => {
+ expect(nuxtLink({ to: '/foo', target: '_blank' }).type).toBe(EXTERNAL)
+ expect(nuxtLink({ to: '/foo/bar', target: '_blank' }).type).toBe(EXTERNAL)
+ expect(nuxtLink({ to: '/foo/bar?baz=qux', target: '_blank' }).type).toBe(EXTERNAL)
+ })
+
+ it('returns `true` if link starts with hash', () => {
+ expect(nuxtLink({ href: '#hash' }).type).toBe(EXTERNAL)
+ expect(nuxtLink({ to: '#hash' }).type).toBe(EXTERNAL)
+ })
+})
+
+describe('nuxt-link:propsOrAttributes', () => {
+ describe('`isExternal` is `true`', () => {
+ describe('href', () => {
+ it('forwards `to` value', () => {
+ expect(nuxtLink({ to: 'https://nuxtjs.org' }).props.href).toBe('https://nuxtjs.org')
+ })
+
+ it('resolves route location object', () => {
+ expect(nuxtLink({ to: { path: '/to' }, external: true }).props.href).toBe('/to')
+ })
+
+ it('resolves route location object with name', () => {
+ expect(nuxtLink({ to: { name: 'to' }, external: true }).props.href).toBe('/to')
+ })
+
+ it('applies trailing slash behaviour', () => {
+ expect(nuxtLink({ to: { path: '/to' }, external: true }, { trailingSlash: 'append' }).props.href).toBe('/to/')
+ expect(nuxtLink({ to: '/to', external: true }, { trailingSlash: 'append' }).props.href).toBe('/to/')
+ })
+ })
+
+ describe('target', () => {
+ it('forwards `target` prop', () => {
+ expect(nuxtLink({ to: 'https://nuxtjs.org', target: '_blank' }).props.target).toBe('_blank')
+ expect(nuxtLink({ to: 'https://nuxtjs.org', target: null }).props.target).toBe(null)
+ })
+
+ it('defaults to `null`', () => {
+ expect(nuxtLink({ to: 'https://nuxtjs.org' }).props.target).toBe(null)
+ })
+
+ it('prefixes target="_blank" internal links with baseURL', () => {
+ vi.mocked(useRuntimeConfig).withImplementation(() => {
+ return {
+ app: {
+ baseURL: '/base',
+ },
+ } as any
+ }, () => {
+ expect(nuxtLink({ to: '/', target: '_blank' }).props.href).toBe('/base')
+ expect(nuxtLink({ to: '/base', target: '_blank' }).props.href).toBe('/base/base')
+ expect(nuxtLink({ to: '/to', target: '_blank' }).props.href).toBe('/base/to')
+ expect(nuxtLink({ to: '/base/to', target: '_blank' }).props.href).toBe('/base/base/to')
+ expect(nuxtLink({ to: '//base/to', target: '_blank' }).props.href).toBe('//base/to')
+ expect(nuxtLink({ to: '//to.com/thing', target: '_blank' }).props.href).toBe('//to.com/thing')
+ expect(nuxtLink({ to: 'https://test.com/to', target: '_blank' }).props.href).toBe('https://test.com/to')
+
+ expect(nuxtLink({ to: '/', target: '_blank' }, { trailingSlash: 'append' }).props.href).toBe('/base/')
+ expect(nuxtLink({ to: '/base/', target: '_blank' }, { trailingSlash: 'remove' }).props.href).toBe('/base/base')
+ })
+ })
+
+ it('excludes the baseURL for external links', () => {
+ vi.mocked(useRuntimeConfig).withImplementation(() => {
+ return {
+ app: {
+ baseURL: '/base',
+ },
+ } as any
+ }, () => {
+ expect(nuxtLink({ to: 'http://nuxtjs.org/app/about', target: '_blank' }).props.href).toBe('http://nuxtjs.org/app/about')
+ expect(nuxtLink({ to: '//nuxtjs.org/app/about', target: '_blank' }).props.href).toBe('//nuxtjs.org/app/about')
+ expect(nuxtLink({ to: { path: '/' }, external: true }).props.href).toBe('/')
+ expect(nuxtLink({ to: '/', external: true }).props.href).toBe('/')
+ })
+ })
+ })
+
+ describe('rel', () => {
+ it('uses framework\'s default', () => {
+ expect(nuxtLink({ to: 'https://nuxtjs.org' }).props.rel).toBe('noopener noreferrer')
+ })
+
+ it('uses user\'s default', () => {
+ expect(nuxtLink({ to: 'https://nuxtjs.org' }, { externalRelAttribute: 'foo' }).props.rel).toBe('foo')
+ expect(nuxtLink({ to: 'https://nuxtjs.org' }, { externalRelAttribute: null }).props.rel).toBe(null)
+ })
+
+ it('uses and favors `rel` prop', () => {
+ expect(nuxtLink({ to: 'https://nuxtjs.org', rel: 'foo' }).props.rel).toBe('foo')
+ expect(nuxtLink({ to: 'https://nuxtjs.org', rel: 'foo' }, { externalRelAttribute: 'bar' }).props.rel).toBe('foo')
+ expect(nuxtLink({ to: 'https://nuxtjs.org', rel: null }, { externalRelAttribute: 'bar' }).props.rel).toBe(null)
+ expect(nuxtLink({ to: 'https://nuxtjs.org', rel: '' }, { externalRelAttribute: 'bar' }).props.rel).toBe(null)
+ })
+
+ it('honors `noRel` prop', () => {
+ expect(nuxtLink({ to: 'https://nuxtjs.org', noRel: true }).props.rel).toBe(null)
+ expect(nuxtLink({ to: 'https://nuxtjs.org', noRel: false }).props.rel).toBe('noopener noreferrer')
+ })
+
+ it('honors `noRel` prop and warns about `rel` prop conflict', () => {
+ const consoleWarnSpy = vi.spyOn(console, 'warn').mockImplementation(vi.fn() as any)
+
+ expect(nuxtLink({ to: 'https://nuxtjs.org', noRel: true, rel: 'foo' }).props.rel).toBe(null)
+ // TODO: Uncomment when `dev` mode for tests is available
+ // expect(consoleWarnSpy).toHaveBeenCalledOnce()
+
+ consoleWarnSpy.mockRestore()
+ })
+ })
+ })
+
+ describe('`isExternal` is `false`', () => {
+ describe('to', () => {
+ it('forwards `to` prop', () => {
+ expect(nuxtLink({ to: '/to' }).props.to).toBe('/to')
+ expect(nuxtLink({ to: { path: '/to' } }).props.to).toEqual({ path: '/to' })
+ expect(nuxtLink({ to: { name: 'to' } }).props.to).toEqual({ name: 'to' })
+ })
+ })
+
+ describe('activeClass', () => {
+ it('uses framework\'s default', () => {
+ expect(nuxtLink({ to: '/to' }).props.activeClass).toBe(undefined)
+ })
+
+ it('uses user\'s default', () => {
+ expect(nuxtLink({ to: '/to' }, { activeClass: 'activeClass' }).props.activeClass).toBe('activeClass')
+ })
+
+ it('uses and favors `activeClass` prop', () => {
+ expect(nuxtLink({ to: '/to', activeClass: 'propActiveClass' }).props.activeClass).toBe('propActiveClass')
+ expect(nuxtLink({ to: '/to', activeClass: 'propActiveClass' }, { activeClass: 'activeClass' }).props.activeClass).toBe('propActiveClass')
+ })
+ })
+
+ describe('exactActiveClass', () => {
+ it('uses framework\'s default', () => {
+ expect(nuxtLink({ to: '/to' }).props.exactActiveClass).toBe(undefined)
+ })
+
+ it('uses user\'s default', () => {
+ expect(nuxtLink({ to: '/to' }, { exactActiveClass: 'exactActiveClass' }).props.exactActiveClass).toBe('exactActiveClass')
+ })
+
+ it('uses and favors `exactActiveClass` prop', () => {
+ expect(nuxtLink({ to: '/to', exactActiveClass: 'propExactActiveClass' }).props.exactActiveClass).toBe('propExactActiveClass')
+ expect(nuxtLink({ to: '/to', exactActiveClass: 'propExactActiveClass' }, { exactActiveClass: 'exactActiveClass' }).props.exactActiveClass).toBe('propExactActiveClass')
+ })
+ })
+
+ describe('replace', () => {
+ it('forwards `replace` prop', () => {
+ expect(nuxtLink({ to: '/to', replace: true }).props.replace).toBe(true)
+ expect(nuxtLink({ to: '/to', replace: false }).props.replace).toBe(false)
+ })
+ })
+
+ describe('ariaCurrentValue', () => {
+ it('forwards `ariaCurrentValue` prop', () => {
+ expect(nuxtLink({ to: '/to', ariaCurrentValue: 'page' }).props.ariaCurrentValue).toBe('page')
+ expect(nuxtLink({ to: '/to', ariaCurrentValue: 'step' }).props.ariaCurrentValue).toBe('step')
+ })
+ })
+
+ describe('trailingSlashBehavior', () => {
+ it('append slash using options', () => {
+ const appendSlashOptions: NuxtLinkOptions = { trailingSlash: 'append' }
+
+ expect(nuxtLink({ to: '/to' }, appendSlashOptions).props.to).toEqual('/to/')
+ expect(nuxtLink({ to: '/to/' }, appendSlashOptions).props.to).toEqual('/to/')
+ expect(nuxtLink({ to: '/to#abc' }, appendSlashOptions).props.to).toEqual('/to/#abc')
+ expect(nuxtLink({ to: { name: 'to' } }, appendSlashOptions).props.to).toHaveProperty('path', '/to/')
+ expect(nuxtLink({ to: { path: '/to' } }, appendSlashOptions).props.to).toHaveProperty('path', '/to/')
+ expect(nuxtLink({ to: { path: '/to#abc' } }, appendSlashOptions).props.to).toHaveProperty('path', '/to/#abc')
+ expect(nuxtLink({ href: '/to' }, appendSlashOptions).props.to).toEqual('/to/')
+ expect(nuxtLink({ href: '/to#abc' }, appendSlashOptions).props.to).toEqual('/to/#abc')
+ expect(nuxtLink({ to: '/to?param=1' }, appendSlashOptions).props.to).toEqual('/to/?param=1')
+ expect(nuxtLink({ to: '/to?param=1#abc' }, appendSlashOptions).props.to).toEqual('/to/?param=1#abc')
+ expect(nuxtLink({ href: 'mailto:test@example.com' }, appendSlashOptions).props.href).toEqual('mailto:test@example.com')
+ })
+
+ it('remove slash using options', () => {
+ const removeSlashOptions: NuxtLinkOptions = { trailingSlash: 'remove' }
+
+ expect(nuxtLink({ to: '/to' }, removeSlashOptions).props.to).toEqual('/to')
+ expect(nuxtLink({ to: '/to/' }, removeSlashOptions).props.to).toEqual('/to')
+ expect(nuxtLink({ to: '/to/#abc' }, removeSlashOptions).props.to).toEqual('/to#abc')
+ expect(nuxtLink({ to: { name: 'to' } }, removeSlashOptions).props.to).toHaveProperty('path', '/to')
+ expect(nuxtLink({ to: { path: '/to/' } }, removeSlashOptions).props.to).toHaveProperty('path', '/to')
+ expect(nuxtLink({ to: { path: '/to/#abc' } }, removeSlashOptions).props.to).toHaveProperty('path', '/to#abc')
+ expect(nuxtLink({ href: '/to/' }, removeSlashOptions).props.to).toEqual('/to')
+ expect(nuxtLink({ to: '/to/?param=1' }, removeSlashOptions).props.to).toEqual('/to?param=1')
+ expect(nuxtLink({ to: '/to/?param=1#abc' }, removeSlashOptions).props.to).toEqual('/to?param=1#abc')
+ expect(nuxtLink({ href: 'mailto:test@example.com' }, removeSlashOptions).props.href).toEqual('mailto:test@example.com')
+ })
+
+ it('prop overrides option: append', () => {
+ const removeSlashOptions: NuxtLinkOptions = { trailingSlash: 'remove' }
+ // Prop takes priority
+ expect(nuxtLink({ to: '/to', trailingSlash: 'append' }, removeSlashOptions).props.to).toEqual('/to/')
+ expect(nuxtLink({ to: '/to/', trailingSlash: 'append' }, removeSlashOptions).props.to).toEqual('/to/')
+ expect(nuxtLink({ to: { path: '/to' }, trailingSlash: 'append' }, removeSlashOptions).props.to).toHaveProperty('path', '/to/')
+ // External links
+ expect(nuxtLink({ to: '/to', external: true, trailingSlash: 'append' }, removeSlashOptions).props.href).toBe('/to/')
+ })
+
+ it('prop overrides option: remove', () => {
+ const appendSlashOptions: NuxtLinkOptions = { trailingSlash: 'append' }
+ // Prop takes priority
+ expect(nuxtLink({ to: '/to/', trailingSlash: 'remove' }, appendSlashOptions).props.to).toEqual('/to')
+ expect(nuxtLink({ to: '/to', trailingSlash: 'remove' }, appendSlashOptions).props.to).toEqual('/to')
+ expect(nuxtLink({ to: { path: '/to/' }, trailingSlash: 'remove' }, appendSlashOptions).props.to).toHaveProperty('path', '/to')
+ // External links
+ expect(nuxtLink({ to: '/to/', external: true, trailingSlash: 'remove' }, appendSlashOptions).props.href).toBe('/to')
+ })
+
+ it('uses option when prop is not provided', () => {
+ const appendSlashOptions: NuxtLinkOptions = { trailingSlash: 'append' }
+ const removeSlashOptions: NuxtLinkOptions = { trailingSlash: 'remove' }
+
+ // Use append option
+ expect(nuxtLink({ to: '/to' }, appendSlashOptions).props.to).toEqual('/to/')
+ // Use remove option
+ expect(nuxtLink({ to: '/to/' }, removeSlashOptions).props.to).toEqual('/to')
+ // External links with options
+ expect(nuxtLink({ to: '/to', external: true }, appendSlashOptions).props.href).toBe('/to/')
+ expect(nuxtLink({ to: '/to/', external: true }, removeSlashOptions).props.href).toBe('/to')
+ })
+ })
+ })
+})
+
+describe('nuxt-link:useLink', () => {
+ it('accepts plain values for `to`', () => {
+ const component = defineNuxtLink({ componentName: 'NuxtLink' })
+ const link = component.useLink({ to: '/about' })
+ expect(link.href.value).toBe('/about')
+ expect(link.isExternal.value).toBe(false)
+ })
+
+ it('accepts a Ref for `to`', () => {
+ const component = defineNuxtLink({ componentName: 'NuxtLink' })
+ const to = ref('/about')
+ const link = component.useLink({ to })
+ expect(link.href.value).toBe('/about')
+ expect(link.isExternal.value).toBe(false)
+ })
+
+ it('reacts to changes in a Ref `to`', () => {
+ const component = defineNuxtLink({ componentName: 'NuxtLink' })
+ const to = ref('/about')
+ const link = component.useLink({ to })
+ expect(link.href.value).toBe('/about')
+ to.value = '/contact'
+ expect(link.href.value).toBe('/contact')
+ })
+
+ it('correctly identifies external links via Ref `to`', () => {
+ const component = defineNuxtLink({ componentName: 'NuxtLink' })
+ const to = ref('https://nuxtjs.org')
+ const link = component.useLink({ to })
+ expect(link.isExternal.value).toBe(true)
+ expect(link.href.value).toBe('https://nuxtjs.org')
+ })
+
+ it('accepts a Ref for `href`', () => {
+ const component = defineNuxtLink({ componentName: 'NuxtLink' })
+ const href = ref('/about')
+ const link = component.useLink({ href })
+ expect(link.href.value).toBe('/about')
+ expect(link.isExternal.value).toBe(false)
+ })
+
+ it('reacts to changes in a Ref `href`', () => {
+ const component = defineNuxtLink({ componentName: 'NuxtLink' })
+ const href = ref('/about')
+ const link = component.useLink({ href })
+ expect(link.href.value).toBe('/about')
+ href.value = '/contact'
+ expect(link.href.value).toBe('/contact')
+ })
+
+ it('accepts a Ref for `external`', () => {
+ const component = defineNuxtLink({ componentName: 'NuxtLink' })
+ const external = ref(true)
+ const link = component.useLink({ to: '/about', external })
+ expect(link.isExternal.value).toBe(true)
+ })
+
+ it('reacts to changes in a Ref `external`', () => {
+ const component = defineNuxtLink({ componentName: 'NuxtLink' })
+ const external = ref(false)
+ const link = component.useLink({ to: '/about', external })
+ expect(link.isExternal.value).toBe(false)
+ external.value = true
+ expect(link.isExternal.value).toBe(true)
+ })
+
+ it('accepts a Ref for `target`', () => {
+ const component = defineNuxtLink({ componentName: 'NuxtLink' })
+ const target = ref<string | null>('_blank')
+ const link = component.useLink({ to: '/about', target })
+ expect(link.hasTarget.value).toBe(true)
+ })
+
+ it('reacts to changes in a Ref `target`', () => {
+ const component = defineNuxtLink({ componentName: 'NuxtLink' })
+ const target = ref<string | null>(null)
+ const link = component.useLink({ to: '/about', target })
+ expect(link.hasTarget.value).toBe(false)
+ target.value = '_blank'
+ expect(link.hasTarget.value).toBe(true)
+ })
+
+ it('navigate() calls navigateTo with correct href', async () => {
+ navigateToMock.mockClear()
+ const component = defineNuxtLink({ componentName: 'NuxtLink' })
+ const link = component.useLink({ to: '/about' })
+ await link.navigate()
+ expect(navigateToMock).toHaveBeenCalledWith('/about', { replace: undefined, external: false })
+ })
+
+ it('navigate() uses current Ref value for href', async () => {
+ navigateToMock.mockClear()
+ const component = defineNuxtLink({ componentName: 'NuxtLink' })
+ const to = ref('/about')
+ const link = component.useLink({ to })
+ to.value = '/contact'
+ await link.navigate()
+ expect(navigateToMock).toHaveBeenCalledWith('/contact', { replace: undefined, external: false })
+ })
+
+ it('navigate() respects Ref `replace` prop', async () => {
+ navigateToMock.mockClear()
+ const component = defineNuxtLink({ componentName: 'NuxtLink' })
+ const replace = ref(true)
+ const link = component.useLink({ to: '/about', replace })
+ await link.navigate()
+ expect(navigateToMock).toHaveBeenCalledWith('/about', { replace: true, external: false })
+ })
+
+ it('applies trailingSlash with Ref `to`', () => {
+ const component = defineNuxtLink({ componentName: 'NuxtLink', trailingSlash: 'append' })
+ const to = ref('/about')
+ const link = component.useLink({ to })
+ expect(link.href.value).toBe('/about/')
+ })
+
+ it('applies Ref `trailingSlash` prop', () => {
+ const component = defineNuxtLink({ componentName: 'NuxtLink' })
+ const trailingSlash = ref<'append' | 'remove'>('append')
+ const link = component.useLink({ to: '/about', trailingSlash })
+ expect(link.to.value).toBe('/about/')
+ })
+})
diff --git a/packages/nuxt/test/package-fixture/pkg/package.json b/packages/nuxt/test/package-fixture/pkg/package.json
new file mode 100644
index 000000000000..02606e1af7a0
--- /dev/null
+++ b/packages/nuxt/test/package-fixture/pkg/package.json
@@ -0,0 +1,8 @@
+{
+ "name": "package-fixture",
+ "description": "This package uses the #components import mapping internally and is used to test the components TransformPlugin",
+ "private": true,
+ "imports": {
+ "#components": "./index.js"
+ }
+}
\ No newline at end of file
diff --git a/packages/nuxt/test/package-fixture/root/node_modules/pkg/package.json b/packages/nuxt/test/package-fixture/root/node_modules/pkg/package.json
new file mode 100644
index 000000000000..4fe62794e60f
--- /dev/null
+++ b/packages/nuxt/test/package-fixture/root/node_modules/pkg/package.json
@@ -0,0 +1,7 @@
+{
+ "name": "pkg",
+ "private": true,
+ "imports": {
+ "#components": "./index.js"
+ }
+}
\ No newline at end of file
diff --git a/packages/nuxt/test/page-metadata.test.ts b/packages/nuxt/test/page-metadata.test.ts
new file mode 100644
index 000000000000..2eb48e9e4610
--- /dev/null
+++ b/packages/nuxt/test/page-metadata.test.ts
@@ -0,0 +1,950 @@
+import { describe, expect, it, vi } from 'vitest'
+import type { MockedFunction } from 'vitest'
+import { compileScript, parse } from '@vue/compiler-sfc'
+import { klona } from 'klona'
+import { parse as toAst } from 'acorn'
+
+import { PageMetaPlugin } from '../src/pages/plugins/page-meta.ts'
+import { getRouteMeta, normalizeRoutes } from '../src/pages/utils.ts'
+import type { NuxtPage } from '../schema.ts'
+
+const filePath = '/app/pages/index.vue'
+
+vi.mock('klona', { spy: true })
+vi.mock('@nuxt/kit', async (original) => {
+ const mod = await original<typeof import('@nuxt/kit')>()
+ return {
+ ...mod,
+ useNuxt: vi.fn(() => {
+ return {
+ options: {
+ experimental: {
+ normalizePageNames: false,
+ },
+ },
+ }
+ }),
+ }
+})
+describe('page metadata', () => {
+ it('should not extract metadata from empty files', () => {
+ expect(getRouteMeta('', filePath)).toEqual({})
+ expect(getRouteMeta('<template><div>Hi</div></template>', filePath)).toEqual({})
+ })
+
+ it('should not confuse Script* component tags with <script> blocks', () => {
+ const meta = getRouteMeta(`
+<template>
+ <div>
+ <ScriptYouTubePlayer video-id="dQw4w9WgXcQ" />
+ </div>
+</template>
+
+<script setup lang="ts">
+definePageMeta({
+ layout: 'dark',
+})
+</script>`, filePath)
+
+ expect(meta).toStrictEqual({
+ meta: {
+ __nuxt_dynamic_meta_key: new Set(['meta']),
+ },
+ })
+ })
+
+ it('should handle multiple script blocks and escaped closing tags', () => {
+ const meta = getRouteMeta(`
+<script>
+export default { inheritAttrs: false }
+</script>
+
+<script setup lang="ts">
+const snippet = '<\\/script>'
+definePageMeta({
+ name: 'multi',
+})
+</script>
+
+<template><div /></template>`, filePath)
+
+ expect(meta).toStrictEqual({
+ name: 'multi',
+ })
+ })
+
+ it('should handle script tag references inside template without extracting them', () => {
+ const meta = getRouteMeta(`
+<template>
+ <div>
+ <script-placeholder />
+ <component is="script" />
+ </div>
+</template>
+
+<script setup lang="ts">
+definePageMeta({
+ path: '/safe',
+})
+</script>`, filePath)
+
+ expect(meta).toStrictEqual({
+ path: '/safe',
+ })
+ })
+
+ it('should extract metadata from JS/JSX files', () => {
+ const fileContents = `definePageMeta({ name: 'bar' })`
+ for (const ext of ['js', 'jsx', 'ts', 'tsx', 'mjs', 'cjs']) {
+ const meta = getRouteMeta(fileContents, `/app/pages/index.${ext}`)
+ expect(meta).toStrictEqual({
+ name: 'bar',
+ })
+ }
+ })
+
+ it('should parse JSX files', () => {
+ const fileContents = `
+export default {
+ setup () {
+ definePageMeta({ name: 'bar' })
+ return () => <div></div>
+ }
+}
+ `
+ const meta = getRouteMeta(fileContents, `/app/pages/index.jsx`)
+ expect(meta).toStrictEqual({
+ name: 'bar',
+ })
+ })
+
+ it('should parse lang="jsx" from vue files', () => {
+ const fileContents = `
+ <script setup lang="jsx">
+ const foo = <></>;
+ definePageMeta({ name: 'bar' })
+ </script>`
+
+ const meta = getRouteMeta(fileContents, `/app/pages/index.vue`)
+ expect(meta).toStrictEqual({
+ name: 'bar',
+ })
+ })
+
+ it('should handle experimental decorators', () => {
+ const fileContents = `
+<script setup lang="ts">
+function something (_method: () => unknown) {
+ return () => 'decorated'
+}
+class SomeClass {
+ @something
+ public someMethod () {
+ return 'initial'
+ }
+}
+definePageMeta({ name: 'bar' })
+</script>
+ `
+ const meta = getRouteMeta(fileContents, `/app/pages/index.vue`)
+ expect(meta).toStrictEqual({
+ name: 'bar',
+ })
+ })
+
+ it('should use and invalidate cache', () => {
+ const _klona = klona as unknown as MockedFunction<typeof klona>
+ _klona.mockImplementation(obj => obj)
+ const fileContents = `<script setup>definePageMeta({ foo: 'bar' })</script>`
+ const meta = getRouteMeta(fileContents, filePath)
+ expect(meta === getRouteMeta(fileContents, filePath)).toBeTruthy()
+ expect(meta === getRouteMeta(fileContents, '/app/pages/other.vue')).toBeFalsy()
+ expect(meta === getRouteMeta('<template><div>Hi</div></template>' + fileContents, filePath)).toBeFalsy()
+ _klona.mockReset()
+ })
+
+ it('should not share state between page metadata', () => {
+ const fileContents = `<script setup>definePageMeta({ foo: 'bar' })</script>`
+ const meta = getRouteMeta(fileContents, filePath)
+ expect(meta === getRouteMeta(fileContents, filePath)).toBeFalsy()
+ })
+
+ it('should extract serialisable metadata', () => {
+ const meta = getRouteMeta(`
+ <script setup>
+ definePageMeta({
+ path: '/some-custom-path',
+ validate: () => true,
+ middleware: [
+ function () {},
+ ],
+ otherValue: {
+ foo: 'bar',
+ },
+ // 'name', 'props' and 'alias' are part of 'defaultExtractionKeys'; they're extracted from the component, so we should test the AST walking for different value types
+ name: 'some-custom-name',
+ props: {
+ foo: 'bar',
+ },
+ alias: ['/alias'],
+ })
+ </script>
+ `, filePath)
+
+ expect(meta).toMatchInlineSnapshot(`
+ {
+ "alias": [
+ "/alias",
+ ],
+ "meta": {
+ "__nuxt_dynamic_meta_key": Set {
+ "middleware",
+ "meta",
+ },
+ },
+ "name": "some-custom-name",
+ "path": "/some-custom-path",
+ "props": {
+ "foo": "bar",
+ },
+ }
+ `)
+ })
+
+ it('should extract metadata containing TS expressions', () => {
+ const meta = getRouteMeta(`
+ <script setup lang="ts">
+ type PageName = 'name-from-page-meta' | 'whatever';
+
+ definePageMeta({
+ name: 'name-from-page-meta' as PageName,
+ path: ('/some-custom-path') as const,
+ props: <{ foo: string }>{
+ foo: 'bar' satisfies string,
+ },
+ } as const);
+ </script>
+ `, filePath)
+
+ expect(meta).toMatchInlineSnapshot(`
+ {
+ "name": "name-from-page-meta",
+ "path": "/some-custom-path",
+ "props": {
+ "foo": "bar",
+ },
+ }
+ `)
+ })
+
+ it('should not extract non-serialisable meta', () => {
+ const meta = getRouteMeta(`
+ <script setup>
+ definePageMeta({
+ redirect: () => '/',
+ })
+ </script>
+ `, filePath)
+
+ expect(meta).toMatchInlineSnapshot(`
+ {
+ "meta": {
+ "__nuxt_dynamic_meta_key": Set {
+ "redirect",
+ },
+ },
+ }
+ `)
+ })
+
+ it('should extract serialisable metadata from files with multiple blocks', () => {
+ const meta = getRouteMeta(`
+ <script lang="ts">
+ export default {
+ name: 'thing'
+ }
+ </script>
+ <script setup>
+ definePageMeta({
+ name: 'some-custom-name',
+ path: '/some-custom-path',
+ validate: () => true,
+ middleware: [
+ function () {},
+ ],
+ otherValue: {
+ foo: 'bar',
+ },
+ })
+ </script>
+ `, filePath)
+
+ expect(meta).toMatchInlineSnapshot(`
+ {
+ "meta": {
+ "__nuxt_dynamic_meta_key": Set {
+ "middleware",
+ "meta",
+ },
+ },
+ "name": "some-custom-name",
+ "path": "/some-custom-path",
+ }
+ `)
+ })
+
+ it('should extract serialisable metadata in options api', () => {
+ const meta = getRouteMeta(`
+ <script>
+ export default {
+ setup() {
+ definePageMeta({
+ name: 'some-custom-name',
+ path: '/some-custom-path',
+ middleware: (from, to) => console.warn('middleware'),
+ })
+ },
+ };
+ </script>
+ `, filePath)
+
+ expect(meta).toMatchInlineSnapshot(`
+ {
+ "meta": {
+ "__nuxt_dynamic_meta_key": Set {
+ "middleware",
+ },
+ },
+ "name": "some-custom-name",
+ "path": "/some-custom-path",
+ }
+ `)
+ })
+
+ it('should extract serialisable metadata all quoted', () => {
+ const meta = getRouteMeta(`
+ <script setup>
+ definePageMeta({
+ "otherValue": {
+ foo: 'bar',
+ },
+ })
+ </script>
+ `, filePath)
+
+ expect(meta).toMatchInlineSnapshot(`
+ {
+ "meta": {
+ "__nuxt_dynamic_meta_key": Set {
+ "meta",
+ },
+ },
+ }
+ `)
+ })
+
+ it('should extract configured extra meta and add it into the page meta', () => {
+ const meta = getRouteMeta(`
+ <script setup>
+ definePageMeta({
+ foo: 'bar',
+ bar: true,
+ })
+ </script>
+ `, filePath, new Set(['bar', 'foo']))
+
+ expect(meta).toMatchInlineSnapshot(`
+ {
+ "meta": {
+ "bar": true,
+ "foo": "bar",
+ },
+ }
+ `)
+ })
+
+ it('should not set default extraction keys into NuxtPage.meta', () => {
+ const meta = getRouteMeta(`
+ <script setup>
+ definePageMeta({
+ alias: '/alias',
+ bar: true,
+ })
+ </script>
+ `, filePath, new Set(['bar']))
+
+ expect(meta).toMatchInlineSnapshot(`
+ {
+ "alias": "/alias",
+ "meta": {
+ "bar": true,
+ },
+ }
+ `)
+ })
+})
+
+describe('normalizeRoutes', () => {
+ it('should produce valid route objects when used with extracted meta', () => {
+ const page: NuxtPage = { path: '/', file: filePath }
+ Object.assign(page, getRouteMeta(`
+ <script setup>
+ definePageMeta({
+ name: 'some-custom-name',
+ path: ref('/some-custom-path'), /* dynamic */
+ validate: () => true,
+ redirect: '/',
+ middleware: [
+ function () {},
+ ],
+ otherValue: {
+ foo: 'bar',
+ },
+ })
+ </script>
+ `, filePath))
+
+ page.meta ||= {}
+ page.meta.layout = 'test'
+ page.meta.foo = 'bar'
+
+ const { routes, imports } = normalizeRoutes([page], new Set(), {
+ clientComponentRuntime: '<client-component-runtime>',
+ serverComponentRuntime: '<server-component-runtime>',
+ overrideMeta: true,
+ })
+ expect({ routes, imports }).toMatchInlineSnapshot(`
+ {
+ "imports": Set {
+ "import { default as indexndqPXFtP262szLmLJV4PriPTgAg5k_7f05QyTfosBXQMeta } from "/app/pages/index.vue?macro=true";",
+ },
+ "routes": "[
+ {
+ name: "some-custom-name",
+ path: indexndqPXFtP262szLmLJV4PriPTgAg5k_7f05QyTfosBXQMeta?.path ?? "/",
+ meta: { ...(indexndqPXFtP262szLmLJV4PriPTgAg5k_7f05QyTfosBXQMeta || {}), ...{"layout":"test","foo":"bar"} },
+ redirect: "/",
+ component: () => import("/app/pages/index.vue")
+ }
+ ]",
+ }
+ `)
+ })
+
+ it('should produce valid route objects when used without extracted meta', () => {
+ const page: NuxtPage = { path: '/', file: filePath }
+ page.meta ||= {}
+ page.meta.layout = 'test'
+ page.meta.foo = 'bar'
+
+ const { routes, imports } = normalizeRoutes([page], new Set(), {
+ clientComponentRuntime: '<client-component-runtime>',
+ serverComponentRuntime: '<server-component-runtime>',
+ overrideMeta: false,
+ })
+ expect({ routes, imports }).toMatchInlineSnapshot(`
+ {
+ "imports": Set {
+ "import { default as indexndqPXFtP262szLmLJV4PriPTgAg5k_7f05QyTfosBXQMeta } from "/app/pages/index.vue?macro=true";",
+ },
+ "routes": "[
+ {
+ name: indexndqPXFtP262szLmLJV4PriPTgAg5k_7f05QyTfosBXQMeta?.name ?? undefined,
+ path: indexndqPXFtP262szLmLJV4PriPTgAg5k_7f05QyTfosBXQMeta?.path ?? "/",
+ props: indexndqPXFtP262szLmLJV4PriPTgAg5k_7f05QyTfosBXQMeta?.props ?? false,
+ meta: { ...(indexndqPXFtP262szLmLJV4PriPTgAg5k_7f05QyTfosBXQMeta || {}), ...{"layout":"test","foo":"bar"} },
+ alias: indexndqPXFtP262szLmLJV4PriPTgAg5k_7f05QyTfosBXQMeta?.alias || [],
+ redirect: indexndqPXFtP262szLmLJV4PriPTgAg5k_7f05QyTfosBXQMeta?.redirect,
+ component: () => import("/app/pages/index.vue")
+ }
+ ]",
+ }
+ `)
+ })
+})
+
+describe('rewrite page meta', () => {
+ const transformPlugin = PageMetaPlugin({ extractedKeys: ['extracted'] }).raw({}, {} as any) as { transform: { handler: (code: string, id: string) => { code: string } | null } }
+
+ it('should throw when multiple definePageMeta', () => {
+ const sfc = `
+<script setup lang="ts">
+
+ definePageMeta({ name: 'hi' })
+
+ definePageMeta({
+ layout: 'hi'
+})
+
+</script>
+ `
+ const res = compileScript(parse(sfc).descriptor, { id: 'component.vue' })
+ expect(() => transformPlugin.transform.handler(res.content, 'component.vue?macro=true')).toThrowErrorMatchingInlineSnapshot(`[Error: Multiple \`definePageMeta\` calls are not supported. File: component.vue]`)
+ })
+
+ it('should extract metadata from vue components', () => {
+ const sfc = `
+<script setup lang="ts">
+definePageMeta({
+ name: 'hi',
+ other: 'value'
+})
+</script>
+ `
+ const res = compileScript(parse(sfc).descriptor, { id: 'component.vue' })
+ expect(transformPlugin.transform.handler(res.content, 'component.vue?macro=true')?.code).toMatchInlineSnapshot(`
+ "const __nuxt_page_meta = {
+ name: 'hi',
+ other: 'value'
+ }
+ export default __nuxt_page_meta"
+ `)
+ })
+
+ it('should extract local functions', () => {
+ const sfc = `
+<script setup lang="ts">
+function isNumber(value) {
+ return value && !isNaN(Number(value))
+}
+
+function validateIdParam (route) {
+ return isNumber(route.params.id)
+}
+
+definePageMeta({
+ validate: validateIdParam,
+ test: () => 'hello',
+})
+</script>
+ `
+ const res = compileScript(parse(sfc).descriptor, { id: 'component.vue' })
+ expect(transformPlugin.transform.handler(res.content, 'component.vue?macro=true')?.code).toMatchInlineSnapshot(`
+ "function isNumber(value) {
+ return value && !isNaN(Number(value))
+ }
+ function validateIdParam (route) {
+ return isNumber(route.params.id)
+ }
+ const __nuxt_page_meta = {
+ validate: validateIdParam,
+ test: () => 'hello',
+ }
+ export default __nuxt_page_meta"
+ `)
+ })
+
+ it('should extract user imports', () => {
+ const sfc = `
+<script setup lang="ts">
+import { validateIdParam } from './utils.ts'
+
+definePageMeta({
+ validate: validateIdParam,
+ dynamic: ref(true),
+})
+</script>
+ `
+ const res = compileScript(parse(sfc).descriptor, { id: 'component.vue' })
+ expect(transformPlugin.transform.handler(res.content, 'component.vue?macro=true')?.code).toMatchInlineSnapshot(`
+ "import { validateIdParam } from './utils.ts'
+
+ const __nuxt_page_meta = {
+ validate: validateIdParam,
+ dynamic: ref(true),
+ }
+ export default __nuxt_page_meta"
+ `)
+ })
+
+ it('should not import static identifiers when shadowed in the same scope', () => {
+ const sfc = `
+<script setup lang="ts">
+import { useState } from '#app/composables/state'
+
+definePageMeta({
+ middleware: () => {
+ const useState = (key) => ({ value: { isLoggedIn: false } })
+ const auth = useState('auth')
+ if (!auth.value.isLoggedIn) {
+ return navigateTo('/login')
+ }
+ },
+})
+</script>
+ `
+ const res = compileScript(parse(sfc).descriptor, { id: 'component.vue' })
+ expect(transformPlugin.transform.handler(res.content, 'component.vue?macro=true')?.code).toMatchInlineSnapshot(`
+ "const __nuxt_page_meta = {
+ middleware: () => {
+ const useState = (key) => ({ value: { isLoggedIn: false } })
+ const auth = useState('auth')
+ if (!auth.value.isLoggedIn) {
+ return navigateTo('/login')
+ }
+ },
+ }
+ export default __nuxt_page_meta"
+ `)
+ })
+
+ it('should not import static identifiers when shadowed in parent scope', () => {
+ const sfc = `
+<script setup lang="ts">
+import { useState } from '#app/composables/state'
+
+definePageMeta({
+ middleware: () => {
+ function isLoggedIn() {
+ const auth = useState('auth')
+ return auth.value.isLoggedIn
+ }
+
+ const useState = (key) => ({ value: { isLoggedIn: false } })
+ if (!isLoggedIn()) {
+ return navigateTo('/login')
+ }
+ },
+})
+</script>
+ `
+ const res = compileScript(parse(sfc).descriptor, { id: 'component.vue' })
+ expect(transformPlugin.transform.handler(res.content, 'component.vue?macro=true')?.code).toMatchInlineSnapshot(`
+ "const __nuxt_page_meta = {
+ middleware: () => {
+ function isLoggedIn() {
+ const auth = useState('auth')
+ return auth.value.isLoggedIn
+ }
+
+ const useState = (key) => ({ value: { isLoggedIn: false } })
+ if (!isLoggedIn()) {
+ return navigateTo('/login')
+ }
+ },
+ }
+ export default __nuxt_page_meta"
+ `)
+ })
+
+ it('should import static identifiers when a shadowed and a non-shadowed one is used', () => {
+ const sfc = `
+<script setup lang="ts">
+import { useState } from '#app/composables/state'
+
+definePageMeta({
+ middleware: [
+ () => {
+ const useState = (key) => ({ value: { isLoggedIn: false } })
+ const auth = useState('auth')
+ if (!auth.value.isLoggedIn) {
+ return navigateTo('/login')
+ }
+ },
+ () => {
+ const auth = useState('auth')
+ if (!auth.value.isLoggedIn) {
+ return navigateTo('/login')
+ }
+ }
+ ]
+})
+</script>
+ `
+ const res = compileScript(parse(sfc).descriptor, { id: 'component.vue' })
+ expect(transformPlugin.transform.handler(res.content, 'component.vue?macro=true')?.code).toMatchInlineSnapshot(`
+ "import { useState } from '#app/composables/state'
+
+ const __nuxt_page_meta = {
+ middleware: [
+ () => {
+ const useState = (key) => ({ value: { isLoggedIn: false } })
+ const auth = useState('auth')
+ if (!auth.value.isLoggedIn) {
+ return navigateTo('/login')
+ }
+ },
+ () => {
+ const auth = useState('auth')
+ if (!auth.value.isLoggedIn) {
+ return navigateTo('/login')
+ }
+ }
+ ]
+ }
+ export default __nuxt_page_meta"
+ `)
+ })
+
+ it('should import static identifiers when a shadowed and a non-shadowed one is used in the same scope', () => {
+ const sfc = `
+<script setup lang="ts">
+import { useState } from '#app/composables/state'
+
+definePageMeta({
+ middleware: () => {
+ const auth1 = useState('auth')
+ const useState = (key) => ({ value: { isLoggedIn: false } })
+ const auth2 = useState('auth')
+ if (!auth1.value.isLoggedIn || !auth2.value.isLoggedIn) {
+ return navigateTo('/login')
+ }
+ },
+})
+</script>
+ `
+ const res = compileScript(parse(sfc).descriptor, { id: 'component.vue' })
+ expect(transformPlugin.transform.handler(res.content, 'component.vue?macro=true')?.code).toMatchInlineSnapshot(`
+ "import { useState } from '#app/composables/state'
+
+ const __nuxt_page_meta = {
+ middleware: () => {
+ const auth1 = useState('auth')
+ const useState = (key) => ({ value: { isLoggedIn: false } })
+ const auth2 = useState('auth')
+ if (!auth1.value.isLoggedIn || !auth2.value.isLoggedIn) {
+ return navigateTo('/login')
+ }
+ },
+ }
+ export default __nuxt_page_meta"
+ `)
+ })
+
+ it('should work when keeping names = true', () => {
+ const sfc = `
+<script setup lang="ts">
+import { foo } from './utils.ts'
+
+const checkNum = (value) => {
+ return !isNaN(Number(foo(value)))
+}
+
+function isNumber (value) {
+ return value && checkNum(value)
+}
+
+definePageMeta({
+ validate: ({ params }) => {
+ return isNumber(params.id)
+ },
+})
+</script>
+ `
+ const compiled = compileScript(parse(sfc).descriptor, { id: 'component.vue' })
+ expect(transformPlugin.transform.handler(compiled.content, 'component.vue?macro=true')?.code).toMatchInlineSnapshot(`
+ "import { foo } from './utils.ts'
+ const checkNum = (value) => {
+ return !isNaN(Number(foo(value)))
+ }
+ function isNumber (value) {
+ return value && checkNum(value)
+ }
+ const __nuxt_page_meta = {
+ validate: ({ params }) => {
+ return isNumber(params.id)
+ },
+ }
+ export default __nuxt_page_meta"
+ `)
+ })
+
+ it('should throw for await expressions', () => {
+ const sfc = `
+<script setup lang="ts">
+const asyncValue = await Promise.resolve('test')
+
+definePageMeta({
+ key: asyncValue,
+})
+</script>
+ `
+ const compiled = compileScript(parse(sfc).descriptor, { id: 'component.vue' })
+
+ let wasErrorThrown = false
+
+ try {
+ transformPlugin.transform.handler(compiled.content, 'component.vue?macro=true')
+ } catch (e) {
+ if (e instanceof Error) {
+ expect(e.message).toMatch(/await in definePageMeta/)
+ wasErrorThrown = true
+ }
+ }
+
+ expect(wasErrorThrown).toBe(true)
+ })
+
+ it('should only add definitions for reference identifiers', () => {
+ const sfc = `
+<script setup lang="ts">
+const foo = 'foo'
+const bar = { bar: 'bar' }.bar, baz = { baz: 'baz' }.baz, x = { foo }
+const test = 'test'
+const prop = 'prop'
+const num = 1
+
+const val = 'val'
+
+const useVal = () => ({ val: 'val' })
+
+function recursive () {
+ recursive()
+}
+
+const route = useRoute()
+
+definePageMeta({
+ middleware: [
+ () => {
+ console.log(bar, baz)
+ recursive()
+
+ const val = useVal().val
+ const obj = {
+ num,
+ prop: 'prop',
+ }
+
+ const c = class test {
+ prop = 'prop'
+ test () {}
+ }
+
+ const someFunction = () => {
+ const someValue = 'someValue'
+ console.log(someValue)
+ }
+
+ console.log(hoisted.value, val)
+ },
+ ],
+ validate: (route) => {
+ return route.params.id === 'test'
+ }
+})
+
+// the order of a ref relative to the 'definePageMeta' call should be preserved (in contrast to a simple const)
+// this tests whether the extraction handles all variables in the upper scope
+const hoisted = ref('hoisted')
+
+</script>
+ `
+ const res = compileScript(parse(sfc).descriptor, { id: 'component.vue' })
+ expect(transformPlugin.transform.handler(res.content, 'component.vue?macro=true')?.code).toMatchInlineSnapshot(`
+ "const foo = 'foo'
+ const num = 1
+ const bar = { bar: 'bar' }.bar, baz = { baz: 'baz' }.baz, x = { foo }
+ const useVal = () => ({ val: 'val' })
+ function recursive () {
+ recursive()
+ }
+ const hoisted = ref('hoisted')
+ const __nuxt_page_meta = {
+ middleware: [
+ () => {
+ console.log(bar, baz)
+ recursive()
+
+ const val = useVal().val
+ const obj = {
+ num,
+ prop: 'prop',
+ }
+
+ const c = class test {
+ prop = 'prop'
+ test () {}
+ }
+
+ const someFunction = () => {
+ const someValue = 'someValue'
+ console.log(someValue)
+ }
+
+ console.log(hoisted.value, val)
+ },
+ ],
+ validate: (route) => {
+ return route.params.id === 'test'
+ }
+ }
+ export default __nuxt_page_meta"
+ `)
+ })
+
+ it('should transform layout written in object syntax', () => {
+ const sfc = `
+<script setup lang="ts">
+definePageMeta({
+ layout: {
+ name: 'foo',
+ props: {
+ bar: 'bar',
+ },
+ },
+})
+</script>
+ `
+ const res = compileScript(parse(sfc).descriptor, { id: 'component.vue' })
+ expect(transformPlugin.transform.handler(res.content, 'component.vue?macro=true')?.code).toMatchInlineSnapshot(`
+ "const __nuxt_page_meta = {
+ layout: 'foo',
+ layoutProps: {
+ bar: 'bar',
+ },
+
+ }
+ export default __nuxt_page_meta"
+ `)
+ })
+
+ describe('strip extracted metadata', () => {
+ it.each([
+ {
+ input: `
+<script setup>
+definePageMeta({
+ foo :'foo',
+ extracted: 'value', })
+</script>
+ `,
+ },
+ {
+ input: `
+<script setup>
+definePageMeta({
+ extracted: 'value',foo :'foo'})
+</script>
+ `,
+ },
+ {
+ input: `
+<script setup>
+definePageMeta({
+ extracted: 'value',
+})
+</script>
+ `,
+ },
+ {
+ input: `
+<script setup>
+definePageMeta({
+ extracted: 'value'
+})
+</script>
+ `,
+ },
+ ])(`should strip extracted metadata from the script block`, ({ input }) => {
+ const res = compileScript(parse(input).descriptor, { id: 'component.vue' })
+ const result = transformPlugin.transform.handler(res.content, 'component.vue?macro=true')?.code
+ expect.soft(result).not.contain('extracted')
+ if (input.includes('foo')) {
+ expect.soft(result).contain('foo')
+ }
+ // verify for valid JS
+ expect(() => toAst(result!, { ecmaVersion: 'latest', sourceType: 'module' })).not.toThrow()
+ })
+ })
+})
diff --git a/packages/nuxt/test/pages-dev.bench.ts b/packages/nuxt/test/pages-dev.bench.ts
new file mode 100644
index 000000000000..0f40489e7853
--- /dev/null
+++ b/packages/nuxt/test/pages-dev.bench.ts
@@ -0,0 +1,161 @@
+import { bench, describe } from 'vitest'
+import { createPagesContext } from '../src/pages/utils.ts'
+
+const pagesDir = 'pages'
+const roots = [`${pagesDir}/`]
+
+const smallAppPaths = [
+ `${pagesDir}/index.vue`,
+ `${pagesDir}/about.vue`,
+ `${pagesDir}/contact.vue`,
+ `${pagesDir}/blog.vue`,
+ `${pagesDir}/blog/[slug].vue`,
+ `${pagesDir}/users.vue`,
+ `${pagesDir}/users/[id].vue`,
+ `${pagesDir}/users/[id]/settings.vue`,
+ `${pagesDir}/[...slug].vue`,
+ `${pagesDir}/login.vue`,
+]
+
+const mediumAppPaths = [
+ `${pagesDir}/index.vue`, `${pagesDir}/about.vue`, `${pagesDir}/contact.vue`,
+ `${pagesDir}/blog.vue`, `${pagesDir}/blog/[slug].vue`, `${pagesDir}/blog/index.vue`,
+ `${pagesDir}/blog/categories.vue`, `${pagesDir}/blog/categories/[cat].vue`,
+ `${pagesDir}/blog/tags/[tag].vue`, `${pagesDir}/users.vue`, `${pagesDir}/users/[id].vue`,
+ `${pagesDir}/users/[id]/settings.vue`, `${pagesDir}/[...slug].vue`, `${pagesDir}/login.vue`,
+ `${pagesDir}/dashboard.vue`, `${pagesDir}/dashboard/index.vue`,
+ `${pagesDir}/dashboard/analytics.vue`, `${pagesDir}/dashboard/settings.vue`,
+ `${pagesDir}/dashboard/settings/profile.vue`, `${pagesDir}/dashboard/settings/notifications.vue`,
+ `${pagesDir}/dashboard/settings/security.vue`, `${pagesDir}/dashboard/projects.vue`,
+ `${pagesDir}/dashboard/projects/[id].vue`, `${pagesDir}/dashboard/projects/[id]/tasks.vue`,
+ `${pagesDir}/dashboard/projects/[id]/members.vue`, `${pagesDir}/api/auth.vue`,
+ `${pagesDir}/api/users.vue`, `${pagesDir}/api/posts.vue`,
+ `${pagesDir}/(admin)/manage.vue`, `${pagesDir}/(admin)/manage/users.vue`,
+ `${pagesDir}/(admin)/manage/roles.vue`, `${pagesDir}/products.vue`,
+ `${pagesDir}/products/index.vue`, `${pagesDir}/products/[category].vue`,
+ `${pagesDir}/products/[category]/[id].vue`, `${pagesDir}/products/[[category]]/featured.vue`,
+ `${pagesDir}/docs/[...slug].vue`, `${pagesDir}/docs/index.vue`,
+ `${pagesDir}/pricing.vue`, `${pagesDir}/terms.vue`, `${pagesDir}/privacy.vue`,
+ `${pagesDir}/faq.vue`, `${pagesDir}/support.vue`, `${pagesDir}/support/[ticket].vue`,
+ `${pagesDir}/auth/login.vue`, `${pagesDir}/auth/register.vue`,
+ `${pagesDir}/auth/forgot-password.vue`, `${pagesDir}/auth/reset-password/[token].vue`,
+ `${pagesDir}/settings.vue`, `${pagesDir}/settings/index.vue`,
+ `${pagesDir}/settings/account.vue`, `${pagesDir}/settings/billing.vue`,
+]
+
+function generateLargeAppPaths (): string[] {
+ const files: string[] = [...mediumAppPaths]
+ const sections = ['shop', 'learn', 'community', 'enterprise', 'developer']
+ for (const section of sections) {
+ files.push(`${pagesDir}/${section}.vue`)
+ files.push(`${pagesDir}/${section}/index.vue`)
+ for (let i = 0; i < 20; i++) {
+ files.push(`${pagesDir}/${section}/page-${i}.vue`)
+ if (i % 3 === 0) { files.push(`${pagesDir}/${section}/[id]-${i}.vue`) }
+ }
+ files.push(`${pagesDir}/${section}/[...slug].vue`)
+ }
+ return files
+}
+
+const largeAppPaths = generateLargeAppPaths()
+
+type ContextOptions = { roots: string[] }
+
+interface DevSimulator {
+ /** Build the initial route tree from all files. */
+ coldStart: () => void
+ /** Emit routes from the current state (no fs change). */
+ emit: () => void
+ /** Add a single file and emit routes. */
+ addFile: (path: string) => void
+ /** Remove a single file and emit routes. */
+ removeFile: (path: string) => void
+}
+
+function createSimulator (filePaths: string[], opts: ContextOptions): DevSimulator {
+ const createCtx = createPagesContext
+ let ctx = createCtx(opts)
+ const files = filePaths.map(p => ({ path: p }))
+
+ return {
+ coldStart () {
+ ctx = createCtx(opts)
+ ctx.rebuild(files)
+ ctx.emit()
+ },
+ emit () {
+ ctx.emit()
+ },
+ addFile (path: string) {
+ ctx.addFile(path)
+ ctx.emit()
+ },
+ removeFile (path: string) {
+ ctx.removeFile(path)
+ ctx.emit()
+ },
+ }
+}
+
+const newFile = `${pagesDir}/new-feature/dashboard.vue`
+const existingFile = largeAppPaths[Math.floor(largeAppPaths.length / 2)]!
+
+describe(`dev server simulation - small app (${smallAppPaths.length} files)`, () => {
+ const sim = createSimulator(smallAppPaths, { roots })
+ sim.coldStart()
+
+ bench(`cold start (initial build + emit) - small (${smallAppPaths.length} files)`, () => {
+ sim.coldStart()
+ })
+
+ bench(`emit (no fs change) - small (${smallAppPaths.length} files)`, () => {
+ sim.emit()
+ })
+})
+
+describe(`dev server simulation - medium app (${mediumAppPaths.length} files)`, () => {
+ const sim = createSimulator(mediumAppPaths, { roots })
+ sim.coldStart()
+
+ bench(`cold start (initial build + emit) - medium (${mediumAppPaths.length} files)`, () => {
+ sim.coldStart()
+ })
+
+ bench(`emit (no fs change) - medium (${mediumAppPaths.length} files)`, () => {
+ sim.emit()
+ })
+
+ bench(`add file + emit - medium (${mediumAppPaths.length} files)`, () => {
+ sim.addFile(newFile)
+ sim.removeFile(newFile) // reset
+ })
+
+ bench(`remove file + emit - medium (${mediumAppPaths.length} files)`, () => {
+ sim.removeFile(mediumAppPaths[Math.floor(mediumAppPaths.length / 2)]!)
+ sim.addFile(mediumAppPaths[Math.floor(mediumAppPaths.length / 2)]!) // reset
+ })
+})
+
+describe(`dev server simulation - large app (${largeAppPaths.length} files)`, () => {
+ const sim = createSimulator(largeAppPaths, { roots })
+ sim.coldStart()
+
+ bench(`cold start (initial build + emit) - large (${largeAppPaths.length} files)`, () => {
+ sim.coldStart()
+ })
+
+ bench(`emit (no fs change) - large (${largeAppPaths.length} files)`, () => {
+ sim.emit()
+ })
+
+ bench(`add file + emit - large (${largeAppPaths.length} files)`, () => {
+ sim.addFile(newFile)
+ sim.removeFile(newFile) // reset
+ })
+
+ bench(`remove file + emit - large (${largeAppPaths.length} files)`, () => {
+ sim.removeFile(existingFile)
+ sim.addFile(existingFile) // reset
+ })
+})
diff --git a/packages/nuxt/test/pages-fixture/nuxt.config.ts b/packages/nuxt/test/pages-fixture/nuxt.config.ts
new file mode 100644
index 000000000000..268da7f8c110
--- /dev/null
+++ b/packages/nuxt/test/pages-fixture/nuxt.config.ts
@@ -0,0 +1 @@
+export default defineNuxtConfig({})
diff --git a/packages/nuxt/test/pages-fixture/pages/index.vue b/packages/nuxt/test/pages-fixture/pages/index.vue
new file mode 100644
index 000000000000..04d85e1bdb5c
--- /dev/null
+++ b/packages/nuxt/test/pages-fixture/pages/index.vue
@@ -0,0 +1,3 @@
+<template>
+ <div />
+</template>
diff --git a/packages/nuxt/test/pages.test.ts b/packages/nuxt/test/pages.test.ts
new file mode 100644
index 000000000000..cdb1ab5aba4c
--- /dev/null
+++ b/packages/nuxt/test/pages.test.ts
@@ -0,0 +1,1261 @@
+import type { TestAPI } from 'vitest'
+import { describe, expect, it, vi } from 'vitest'
+import type { RouteLocationNormalizedLoaded } from 'vue-router'
+import { type PagesContextOptions, augmentPages, createPagesContext, normalizeRoutes, pathToNitroGlob } from '../src/pages/utils.ts'
+import type { RouterViewSlotProps } from '../src/pages/runtime/utils.ts'
+import { generateRouteKey } from '../src/pages/runtime/utils.ts'
+import type { NuxtPage } from 'nuxt/schema'
+import { useNuxt } from '@nuxt/kit'
+import type { InputFile } from 'unrouting'
+
+vi.mock('@nuxt/kit', async (original) => {
+ const mod = await original<typeof import('@nuxt/kit')>()
+ return {
+ ...mod,
+ useNuxt: vi.fn(() => {
+ return {
+ options: {
+ experimental: {
+ normalizePageNames: false,
+ },
+ },
+ }
+ }),
+ }
+})
+
+export function generateRoutesFromFiles (files: InputFile[], options: PagesContextOptions = {}): NuxtPage[] {
+ if (!files.length) { return [] }
+ const ctx = createPagesContext(options)
+ ctx.rebuild(files)
+ return ctx.emit()
+}
+
+describe('pages:generateRoutesFromFiles', () => {
+ vi.mock('knitwork', async (original) => {
+ return {
+ ...(await original<typeof import('knitwork')>()),
+ genArrayFromRaw: (val: any) => val,
+ genSafeVariableName: (..._args: string[]) => {
+ return 'mock'
+ },
+ }
+ })
+
+ const normalizedResults: Record<string, any> = {}
+ const normalizedOverrideMetaResults: Record<string, any> = {}
+
+ const enUSComparator = new Intl.Collator('en-US')
+ function sortRoutes (routes: NuxtPage[]) {
+ for (const route of routes) {
+ route.children &&= sortRoutes(route.children)
+ }
+ return routes.toSorted((a, b) => enUSComparator.compare(b.path, a.path))
+ }
+
+ // Sort normalized route arrays by their serialized path for order-independent snapshots
+ function sortNormalizedArray (arr: any[]): any[] {
+ return arr.map((item) => {
+ if (item && typeof item === 'object' && item.children) {
+ return { ...item, children: sortNormalizedArray(item.children) }
+ }
+ return item
+ }).sort((a, b) => {
+ const aPath = typeof a === 'string' ? a : JSON.stringify(a)
+ const bPath = typeof b === 'string' ? b : JSON.stringify(b)
+ return enUSComparator.compare(bPath, aPath)
+ })
+ }
+
+ function sortNormalizedResults (results: Record<string, any>) {
+ const sorted: Record<string, any> = {}
+ for (const [key, value] of Object.entries(results)) {
+ sorted[key] = Array.isArray(value) ? sortNormalizedArray(value) : value
+ }
+ return sorted
+ }
+
+ for (const test of pageTests) {
+ const _it = test.it || it
+ _it(test.description, async () => {
+ let result
+ if (test.files) {
+ const vfs = Object.fromEntries(
+ test.files.map(file => [file.path, 'template' in file ? file.template : '']),
+ ) as Record<string, string>
+
+ try {
+ const files = test.files.map(file => ({ path: file.path }))
+
+ result = generateRoutesFromFiles(files, { roots: ['pages/', 'layer/pages/'] }).map((route, index) => {
+ return {
+ ...route,
+ meta: test.files![index]!.meta ?? route.meta,
+ }
+ })
+
+ await augmentPages(result, vfs, { extraExtractionKeys: new Set(['extracted']) })
+ } catch (error: any) {
+ expect(error.message).toEqual(test.error)
+ }
+ } else {
+ result = test.output ?? []
+ }
+
+ if (result) {
+ expect.soft(sortRoutes(result)).toEqual(test.output ? sortRoutes(test.output) : undefined)
+
+ normalizedResults[test.description] = normalizeRoutes(result, new Set(), {
+ clientComponentRuntime: '<client-component-runtime>',
+ serverComponentRuntime: '<server-component-runtime>',
+ overrideMeta: false,
+ }).routes
+
+ normalizedOverrideMetaResults[test.description] = normalizeRoutes(result, new Set(), {
+ clientComponentRuntime: '<client-component-runtime>',
+ serverComponentRuntime: '<server-component-runtime>',
+ overrideMeta: true,
+ }).routes
+ }
+ })
+ }
+
+ it('should consistently normalize routes', async () => {
+ // Sort each test case's routes array for order-independent comparison
+ const sorted = sortNormalizedResults(normalizedResults)
+ await expect(sorted).toMatchFileSnapshot('./__snapshots__/pages-override-meta-disabled.test.ts.snap')
+ })
+
+ describe('pages:normalizePageNames', () => {
+ it('should assign __name via Object.assign for sync imports when normalizePageNames is enabled', () => {
+ vi.mocked(useNuxt).mockReturnValueOnce({
+ options: {
+ // @ts-expect-error partial
+ experimental: { normalizePageNames: true },
+ },
+ })
+
+ const pages: NuxtPage[] = [
+ {
+ file: '/pages/sync.vue',
+ name: 'sync',
+ path: '/sync',
+ _sync: true,
+ } as unknown as NuxtPage,
+ ]
+
+ const { routes } = normalizeRoutes(pages, new Set(), {
+ clientComponentRuntime: '<client>',
+ serverComponentRuntime: '<server>',
+ })
+
+ const r0: any = (routes as any)[0]
+ expect(r0.component).toContain('Object.assign(')
+ expect(r0.component).toContain('__name')
+ })
+
+ it('should append then(...Object.assign(m.default, { __name })) for async imports when normalizePageNames is enabled', () => {
+ vi.mocked(useNuxt).mockReturnValueOnce({
+ options: {
+ // @ts-expect-error partial
+ experimental: { normalizePageNames: true },
+ },
+ })
+
+ const pages: NuxtPage[] = [
+ {
+ file: '/pages/async.vue',
+ name: 'async',
+ path: '/async',
+ } as unknown as NuxtPage,
+ ]
+
+ const { routes } = normalizeRoutes(pages, new Set(), {
+ clientComponentRuntime: '<client>',
+ serverComponentRuntime: '<server>',
+ })
+
+ const r0: any = (routes as any)[0]
+ expect(r0.component).toContain('.then((m) => Object.assign(m.default')
+ expect(r0.component).toContain('__name')
+ })
+
+ it('should use createIslandPage without __name for server mode pages', () => {
+ vi.mocked(useNuxt).mockReturnValueOnce({
+ options: {
+ // @ts-expect-error partial
+ experimental: { normalizePageNames: true },
+ },
+ })
+
+ const pages: NuxtPage[] = [
+ {
+ file: '/pages/server.vue',
+ name: 'server-page',
+ path: '/server',
+ mode: 'server',
+ } as unknown as NuxtPage,
+ ]
+
+ const { routes } = normalizeRoutes(pages, new Set(), {
+ clientComponentRuntime: '<client>',
+ serverComponentRuntime: '<server>',
+ })
+
+ const r0: any = (routes as any)[0]
+ expect(r0.component).toContain('createIslandPage(')
+ expect(r0.component).not.toContain('__name')
+ expect(r0.component).not.toContain('.then')
+ })
+
+ it('should assign __name to the resolved component for client mode pages', () => {
+ vi.mocked(useNuxt).mockReturnValueOnce({
+ options: {
+ // @ts-expect-error partial
+ experimental: { normalizePageNames: true },
+ },
+ })
+
+ const pages: NuxtPage[] = [
+ {
+ file: '/pages/client.vue',
+ name: 'client-page',
+ path: '/client',
+ mode: 'client',
+ } as unknown as NuxtPage,
+ ]
+
+ const { routes } = normalizeRoutes(pages, new Set(), {
+ clientComponentRuntime: '<client>',
+ serverComponentRuntime: '<server>',
+ })
+
+ const r0: any = (routes as any)[0]
+ expect(r0.component).toContain('createClientPage(')
+ expect(r0.component).toContain('.then((c) => Object.assign(c,')
+ expect(r0.component).toContain('__name')
+ expect(r0.component).not.toContain('m.default')
+ })
+ })
+
+ describe('pages:namedViews', () => {
+ it('emits a `components` map alongside `component` when the scanner reports named views', () => {
+ const pages: NuxtPage[] = [
+ {
+ name: 'foo-bar',
+ path: 'bar',
+ file: '/pages/foo/bar.vue',
+ components: {
+ default: '/pages/foo/bar.vue',
+ left: '/pages/foo/bar@left.vue',
+ },
+ } as unknown as NuxtPage,
+ ]
+
+ const { routes } = normalizeRoutes(pages, new Set(), {
+ clientComponentRuntime: '<client>',
+ serverComponentRuntime: '<server>',
+ overrideMeta: false,
+ })
+
+ const r0: any = (routes as any)[0]
+ expect(r0.component).toBeTruthy()
+ expect(r0.components).toBeTruthy()
+ expect(r0.components).toContain('default:')
+ expect(r0.components).toContain('"left":')
+ expect(r0.components).toContain('/pages/foo/bar@left.vue')
+ })
+
+ it('does not emit `components` when only the default view is present', () => {
+ const pages: NuxtPage[] = [
+ {
+ name: 'foo-bar',
+ path: 'bar',
+ file: '/pages/foo/bar.vue',
+ components: {
+ default: '/pages/foo/bar.vue',
+ },
+ } as unknown as NuxtPage,
+ ]
+
+ const { routes } = normalizeRoutes(pages, new Set(), {
+ clientComponentRuntime: '<client>',
+ serverComponentRuntime: '<server>',
+ overrideMeta: false,
+ })
+
+ const r0: any = (routes as any)[0]
+ expect(r0.component).toBeTruthy()
+ expect(r0.components).toBeUndefined()
+ })
+ })
+
+ it('should consistently normalize routes when overriding meta', async () => {
+ const sorted = sortNormalizedResults(normalizedOverrideMetaResults)
+ await expect(sorted).toMatchFileSnapshot('./__snapshots__/pages-override-meta-enabled.test.ts.snap')
+ })
+})
+
+describe('pages:generateRouteKey', () => {
+ const defaultComponent = { type: {} }
+ const getRouteProps = (matchedRoute = {}) => ({
+ Component: defaultComponent,
+ route: {
+ meta: { key: 'route-meta-key' },
+ params: {
+ id: 'foo',
+ optional: 'bar',
+ array: ['a', 'b'],
+ },
+ matched: [
+ {
+ components: { default: {} },
+ meta: { key: 'other-meta-key' },
+ },
+ {
+ components: { default: defaultComponent.type },
+ meta: { key: 'matched-meta-key' },
+ ...matchedRoute,
+ },
+ ],
+ },
+ } as unknown as RouterViewSlotProps)
+
+ const tests: Array<{
+ description: string
+ route: RouterViewSlotProps
+ override?: string | ((route: RouteLocationNormalizedLoaded) => string)
+ output?: string | false
+ it?: TestAPI
+ }> = [
+ { description: 'should handle overrides', override: 'key', route: getRouteProps(), output: 'key' },
+ { description: 'should handle overrides', override: route => route.meta.key as string, route: getRouteProps(), output: 'route-meta-key' },
+ {
+ description: 'should handle overrides',
+ // @ts-expect-error testing behaviour with invalid prop
+ override: false,
+ route: getRouteProps(),
+ output: false,
+ },
+ {
+ description: 'should key dynamic routes without keys',
+ route: getRouteProps({
+ path: '/test/:id',
+ meta: {},
+ }),
+ output: '/test/foo',
+ },
+ {
+ description: 'should key dynamic routes without keys',
+ route: getRouteProps({
+ path: '/test/:id(\\d+)',
+ meta: {},
+ }),
+ output: '/test/foo',
+ },
+ {
+ description: 'should key dynamic routes with optional params',
+ route: getRouteProps({
+ path: '/test/:optional?',
+ meta: {},
+ }),
+ output: '/test/bar',
+ },
+ {
+ description: 'should key dynamic routes with optional params',
+ route: getRouteProps({
+ path: '/test/:optional(\\d+)?',
+ meta: {},
+ }),
+ output: '/test/bar',
+ },
+ {
+ description: 'should key dynamic routes with optional params',
+ route: getRouteProps({
+ path: '/test/:undefined(\\d+)?',
+ meta: {},
+ }),
+ output: '/test/',
+ },
+ {
+ description: 'should key dynamic routes with array params',
+ route: getRouteProps({
+ path: '/:array+',
+ meta: {},
+ }),
+ output: '/a,b',
+ },
+ {
+ description: 'should key dynamic routes with array params',
+ route: getRouteProps({
+ path: '/test/:array*',
+ meta: {},
+ }),
+ output: '/test/a,b',
+ },
+ {
+ description: 'should key dynamic routes with array params',
+ route: getRouteProps({
+ path: '/test/:other*',
+ meta: {},
+ }),
+ output: '/test/',
+ },
+ ]
+
+ for (const test of tests) {
+ const _it = test.it || it
+ _it(test.description, () => {
+ expect(generateRouteKey(test.route, test.override)).to.deep.equal(test.output)
+ })
+ }
+})
+
+const pathToNitroGlobTests = {
+ '/': '/',
+ '/:id': '/**',
+ '/:id()': '/**',
+ '/:id?': '/**',
+ '/some-:id?': '/**',
+ '/other/some-:id?': '/other/**',
+ '/other/some-:id()-more': '/other/**',
+ '/other/nested': '/other/nested',
+}
+
+describe('pages:pathToNitroGlob', () => {
+ it.each(Object.entries(pathToNitroGlobTests))('should convert %s to %s', (path, expected) => {
+ expect(pathToNitroGlob(path)).to.equal(expected)
+ })
+})
+
+describe('page:extends', () => {
+ const DYNAMIC_META_KEY = '__nuxt_dynamic_meta_key' as const
+ it('should preserve distinct metadata for multiple routes referencing the same file', async () => {
+ const files: NuxtPage[] = [
+ { path: 'home', file: `pages/index.vue` },
+ { path: 'home1', file: `pages/index.vue`, meta: { test: true } },
+ { path: 'home2', file: `pages/index.vue`, meta: { snap: true } },
+ ]
+ const vfs = Object.fromEntries(
+ files.map(file => [file.file, `
+ <script setup lang="ts">
+ definePageMeta({
+ hello: 'world'
+ })
+ </script>
+ `]),
+ ) as Record<string, string>
+ await augmentPages(files, vfs)
+ expect(files).toEqual([
+ {
+ path: 'home',
+ file: `pages/index.vue`,
+ meta: { [DYNAMIC_META_KEY]: new Set(['meta']) },
+ },
+ {
+ path: 'home1',
+ file: `pages/index.vue`,
+ meta: { [DYNAMIC_META_KEY]: new Set(['meta']), test: true },
+ },
+ {
+ path: 'home2',
+ file: `pages/index.vue`,
+ meta: { [DYNAMIC_META_KEY]: new Set(['meta']), snap: true },
+ },
+ ])
+ })
+})
+
+const pagesDir = 'pages'
+const layerDir = 'layer/pages'
+const DYNAMIC_META_KEY = '__nuxt_dynamic_meta_key' as const
+
+export const pageTests: Array<{
+ description: string
+ files?: Array<{ path: string, template?: string, meta?: Record<string, any> }>
+ output?: NuxtPage[]
+ it?: TestAPI
+ normalized?: Record<string, any>[]
+ error?: string
+}> = [
+ {
+ description: 'should generate correct routes for index pages',
+ files: [
+ { path: `${pagesDir}/index.vue` },
+ { path: `${pagesDir}/parent/index.vue` },
+ { path: `${pagesDir}/parent/child/index.vue` },
+ ],
+ output: [
+ {
+ name: 'index',
+ path: '/',
+ file: `${pagesDir}/index.vue`,
+ children: [],
+ },
+ {
+ name: 'parent',
+ path: '/parent',
+ file: `${pagesDir}/parent/index.vue`,
+ children: [],
+ },
+ {
+ name: 'parent-child',
+ path: '/parent/child',
+ file: `${pagesDir}/parent/child/index.vue`,
+ children: [],
+ },
+ ],
+ },
+ {
+ description: 'should generate correct routes for parent/child',
+ files: [
+ { path: `${pagesDir}/parent.vue` },
+ { path: `${pagesDir}/parent/child.vue` },
+ ],
+ output: [
+ {
+ name: 'parent',
+ path: '/parent',
+ file: `${pagesDir}/parent.vue`,
+ children: [
+ {
+ name: 'parent-child',
+ path: 'child',
+ file: `${pagesDir}/parent/child.vue`,
+ children: [],
+ },
+ ],
+ },
+ ],
+ },
+ {
+ description: 'should not generate colliding route names when hyphens are in file name',
+ files: [
+ { path: `${pagesDir}/parent/[child].vue` },
+ { path: `${pagesDir}/parent-[child].vue` },
+ ],
+ output: [
+ {
+ name: 'parent-child',
+ path: '/parent/:child()',
+ file: `${pagesDir}/parent/[child].vue`,
+ children: [],
+ },
+ {
+ name: 'parent-child',
+ path: '/parent-:child()',
+ file: `${pagesDir}/parent-[child].vue`,
+ children: [],
+ },
+ ],
+ },
+ {
+ description: 'should generate correct id for catchall (order 1)',
+ files: [
+ { path: `${pagesDir}/[...stories].vue` },
+ { path: `${pagesDir}/stories/[id].vue` },
+ ],
+ output: [
+ {
+ name: 'stories',
+ path: '/:stories(.*)*',
+ file: `${pagesDir}/[...stories].vue`,
+ children: [],
+ },
+ {
+ name: 'stories-id',
+ path: '/stories/:id()',
+ file: `${pagesDir}/stories/[id].vue`,
+ children: [],
+ },
+ ],
+ },
+ {
+ description: 'should generate correct id for catchall (order 2)',
+ files: [
+ { path: `${pagesDir}/stories/[id].vue` },
+ { path: `${pagesDir}/[...stories].vue` },
+ ],
+ output: [
+ {
+ name: 'stories-id',
+ path: '/stories/:id()',
+ file: `${pagesDir}/stories/[id].vue`,
+ children: [],
+ },
+ {
+ name: 'stories',
+ path: '/:stories(.*)*',
+ file: `${pagesDir}/[...stories].vue`,
+ children: [],
+ },
+ ],
+ },
+ {
+ description: 'should generate correct route for snake_case file',
+ files: [
+ { path: `${pagesDir}/snake_case.vue` },
+ ],
+ output: [
+ {
+ name: 'snake_case',
+ path: '/snake_case',
+ file: `${pagesDir}/snake_case.vue`,
+ children: [],
+ },
+ ],
+ },
+ {
+ description: 'should generate correct route for kebab-case file',
+ files: [{ path: `${pagesDir}/kebab-case.vue` }],
+ output: [
+ {
+ name: 'kebab-case',
+ path: '/kebab-case',
+ file: `${pagesDir}/kebab-case.vue`,
+ children: [],
+ },
+ ],
+ },
+ {
+ description: 'should generate correct dynamic routes',
+ files: [
+ { path: `${pagesDir}/index.vue` },
+ { path: `${pagesDir}/[slug].vue` },
+ { path: `${pagesDir}/[[foo]]` },
+ { path: `${pagesDir}/[[foo]]/index.vue` },
+ { path: `${pagesDir}/optional/[[opt]].vue` },
+ { path: `${pagesDir}/optional/prefix-[[opt]].vue` },
+ { path: `${pagesDir}/optional/[[opt]]-postfix.vue` },
+ { path: `${pagesDir}/optional/prefix-[[opt]]-postfix.vue` },
+ { path: `${pagesDir}/[bar]/index.vue` },
+ { path: `${pagesDir}/nonopt/[slug].vue` },
+ { path: `${pagesDir}/opt/[[slug]].vue` },
+ { path: `${pagesDir}/[[sub]]/route-[slug].vue` },
+ ],
+ output: [
+ {
+ children: [
+ {
+
+ name: 'foo',
+ path: '',
+ file: `${pagesDir}/[[foo]]/index.vue`,
+ children: [],
+ },
+ ],
+ file: `${pagesDir}/[[foo]]`,
+ path: '/:foo?',
+ },
+ {
+ name: 'index',
+ path: '/',
+ file: `${pagesDir}/index.vue`,
+ children: [],
+ },
+ {
+ children: [],
+ name: 'slug',
+ file: `${pagesDir}/[slug].vue`,
+ path: '/:slug()',
+ },
+ {
+ children: [],
+ name: 'bar',
+ file: `${pagesDir}/[bar]/index.vue`,
+ path: '/:bar()',
+ },
+ {
+ name: 'opt-slug',
+ path: '/opt/:slug?',
+ file: `${pagesDir}/opt/[[slug]].vue`,
+ children: [],
+ },
+ {
+ name: 'nonopt-slug',
+ path: '/nonopt/:slug()',
+ file: `${pagesDir}/nonopt/[slug].vue`,
+ children: [],
+ },
+ {
+ children: [],
+ path: '/optional/:opt?',
+ name: 'optional-opt',
+ file: `${pagesDir}/optional/[[opt]].vue`,
+ },
+ {
+ name: 'sub-route-slug',
+ path: '/:sub?/route-:slug()',
+ file: `${pagesDir}/[[sub]]/route-[slug].vue`,
+ children: [],
+ },
+ {
+ children: [],
+ path: '/optional/prefix-:opt?',
+ name: 'optional-prefix-opt',
+ file: `${pagesDir}/optional/prefix-[[opt]].vue`,
+ },
+
+ {
+ children: [],
+ path: '/optional/:opt?-postfix',
+ name: 'optional-opt-postfix',
+ file: `${pagesDir}/optional/[[opt]]-postfix.vue`,
+ },
+ {
+ children: [],
+ path: '/optional/prefix-:opt?-postfix',
+ name: 'optional-prefix-opt-postfix',
+ file: `${pagesDir}/optional/prefix-[[opt]]-postfix.vue`,
+ },
+ ],
+ },
+ {
+ description: 'should generate correct catch-all route',
+ files: [{ path: `${pagesDir}/[...slug].vue` }, { path: `${pagesDir}/index.vue` }, { path: `${pagesDir}/[...slug]/[id].vue` }],
+ output: [
+ {
+ name: 'index',
+ path: '/',
+ file: `${pagesDir}/index.vue`,
+ children: [],
+ },
+ {
+ name: 'slug',
+ path: '/:slug(.*)*',
+ file: `${pagesDir}/[...slug].vue`,
+ children: [
+ {
+ name: 'slug-id',
+ path: ':id()',
+ file: `${pagesDir}/[...slug]/[id].vue`,
+ children: [],
+ }],
+ },
+ ],
+ },
+ {
+ description: 'should throw unfinished param error for dynamic route',
+ files: [{ path: `${pagesDir}/[slug.vue` }],
+ error: 'Unfinished param "slug"',
+ },
+ {
+ description: 'should throw empty param error for dynamic route',
+ files: [
+ { path: `${pagesDir}/[].vue` },
+ ],
+ error: 'Empty param',
+ },
+ {
+ description: 'should only allow "_" & "." as special character for dynamic route',
+ files: [
+ { path: `${pagesDir}/[a1_1a].vue` },
+ { path: `${pagesDir}/[b2.2b].vue` },
+ { path: `${pagesDir}/[b2]_[2b].vue` },
+ { path: `${pagesDir}/[[c3@3c]].vue` },
+ { path: `${pagesDir}/[[d4-4d]].vue` },
+ ],
+ output: [
+ {
+ name: 'a1_1a',
+ path: '/:a1_1a()',
+ file: `${pagesDir}/[a1_1a].vue`,
+ children: [],
+ },
+ {
+ name: 'b2.2b',
+ path: '/:b2.2b()',
+ file: `${pagesDir}/[b2.2b].vue`,
+ children: [],
+ },
+ {
+ name: 'b2_2b',
+ path: '/:b2()_:2b()',
+ file: `${pagesDir}/[b2]_[2b].vue`,
+ children: [],
+ },
+ {
+ name: 'c33c',
+ path: '/:c33c?',
+ file: `${pagesDir}/[[c3@3c]].vue`,
+ children: [],
+ },
+ {
+ name: 'd44d',
+ path: '/:d44d?',
+ file: `${pagesDir}/[[d4-4d]].vue`,
+ children: [],
+ },
+ ],
+ },
+ {
+ description: 'should properly override route name if definePageMeta name override is defined.',
+ files: [
+ {
+ path: `${pagesDir}/index.vue`,
+ template: `
+ <script setup lang="ts">
+ definePageMeta({
+ name: 'home'
+ })
+ </script>
+ `,
+ },
+ ],
+ output: [
+ {
+ name: 'home',
+ path: '/',
+ file: `${pagesDir}/index.vue`,
+ children: [],
+ },
+ ],
+ },
+ {
+ description: 'should allow pages with `:` in their path',
+ files: [
+ { path: `${pagesDir}/test:name.vue` },
+ ],
+ output: [
+ {
+ name: 'test:name',
+ path: '/test\\:name',
+ file: `${pagesDir}/test:name.vue`,
+ children: [],
+ },
+ ],
+ },
+ {
+ description: 'should handle unicode and special characters in page paths',
+ files: [
+ { path: `${pagesDir}/测试.vue` },
+ { path: `${pagesDir}/文档.vue` },
+ { path: `${pagesDir}/文档/介绍.vue` },
+ { path: `${pagesDir}/خاص:جديد.vue` },
+ ],
+ output: [
+ { name: '测试', path: `/${encodeURIComponent('测试')}`, file: `${pagesDir}/测试.vue`, children: [] },
+ { name: '文档', path: `/${encodeURIComponent('文档')}`, file: `${pagesDir}/文档.vue`, children: [
+ { name: '文档-介绍', path: encodeURIComponent('介绍'), file: `${pagesDir}/文档/介绍.vue`, children: [] },
+ ] },
+ { name: 'خاص:جديد', path: `/${encodeURIComponent('خاص')}\\:${encodeURIComponent('جديد')}`, file: `${pagesDir}/خاص:جديد.vue`, children: [] },
+ ],
+ },
+ {
+ description: 'should escape special chars in static paths',
+ files: [
+ { path: `${pagesDir}/a&b.vue` },
+ { path: `${pagesDir}/a\\b.vue` },
+ ],
+ output: [
+ { name: 'a&b', path: `/a${encodeURIComponent('&')}b`, file: `${pagesDir}/a&b.vue`, children: [] },
+ { name: 'a\\b', path: `/a${encodeURIComponent('\\')}b`, file: `${pagesDir}/a\\b.vue`, children: [] },
+ ],
+ },
+ {
+ description: 'should not merge required param as a child of optional param',
+ files: [
+ { path: `${pagesDir}/[[foo]].vue` },
+ { path: `${pagesDir}/[foo].vue` },
+ ],
+ output: [
+ {
+ name: 'foo',
+ path: '/:foo()',
+ file: `${pagesDir}/[foo].vue`,
+ children: [],
+ },
+ {
+ name: 'foo',
+ path: '/:foo?',
+ file: `${pagesDir}/[[foo]].vue`,
+ children: [
+ ],
+ },
+ ],
+ },
+ {
+ description: 'should correctly merge nested routes',
+ files: [
+ { path: `${pagesDir}/param.vue` },
+ { path: `${layerDir}/param/index.vue` },
+ { path: `${pagesDir}/param/index/index.vue` },
+ { path: `${layerDir}/param/index/sibling.vue` },
+ { path: `${pagesDir}/wrapper-expose/other.vue` },
+ { path: `${layerDir}/wrapper-expose/other/index.vue` },
+ { path: `${pagesDir}/wrapper-expose/other/sibling.vue` },
+ { path: `${pagesDir}/param/sibling.vue` },
+ ],
+ output: [
+ {
+ children: [
+ {
+ children: [
+ {
+ children: [],
+ file: `${pagesDir}/param/index/index.vue`,
+ name: 'param-index',
+ path: '',
+ },
+ {
+ children: [],
+ file: `${layerDir}/param/index/sibling.vue`,
+ name: 'param-index-sibling',
+ path: 'sibling',
+ },
+ ],
+ file: `${layerDir}/param/index.vue`,
+ path: '',
+ },
+ {
+ children: [],
+ file: `${pagesDir}/param/sibling.vue`,
+ name: 'param-sibling',
+ path: 'sibling',
+ },
+ ],
+ file: `${pagesDir}/param.vue`,
+ path: '/param',
+ },
+ {
+ children: [
+ {
+ children: [],
+ file: `${layerDir}/wrapper-expose/other/index.vue`,
+ name: 'wrapper-expose-other',
+ path: '',
+ },
+ {
+ children: [],
+ file: `${pagesDir}/wrapper-expose/other/sibling.vue`,
+ name: 'wrapper-expose-other-sibling',
+ path: 'sibling',
+ },
+ ],
+ file: `${pagesDir}/wrapper-expose/other.vue`,
+ path: '/wrapper-expose/other',
+ },
+ ],
+ },
+ {
+ description: 'should handle trailing slashes with index routes',
+ files: [
+ { path: `${pagesDir}/index/index.vue` },
+ { path: `${pagesDir}/index/index/all.vue` },
+ ],
+ output: [
+ {
+ children: [
+ {
+ children: [],
+ file: `${pagesDir}/index/index/all.vue`,
+ name: 'index-index-all',
+ path: 'all',
+ },
+ ],
+ file: `${pagesDir}/index/index.vue`,
+ name: 'index',
+ path: '/',
+ },
+ ],
+ },
+ {
+ description: 'should generate correct routes for nested pages',
+ files: [
+ { path: `${pagesDir}/page1/index.vue` },
+ { path: `${pagesDir}/page1/[id].vue` },
+ { path: `${pagesDir}/page1.vue` },
+ ],
+ output: [
+ {
+ children: [
+ {
+ children: [],
+ file: `${pagesDir}/page1/[id].vue`,
+ name: 'page1-id',
+ path: ':id()',
+ },
+ {
+ children: [],
+ file: `${pagesDir}/page1/index.vue`,
+ name: 'page1',
+ path: '',
+ },
+ ],
+ file: `${pagesDir}/page1.vue`,
+ path: '/page1',
+ },
+ ],
+ },
+ {
+ description: 'should use fallbacks when normalized with `overrideMeta: true`',
+ files: [
+ {
+ path: `${pagesDir}/index.vue`,
+ template: `
+ <script setup lang="ts">
+ const routeName = ref('home')
+ const routeAliases = ref(['sweet-home'])
+ definePageMeta({
+ name: routeName.value,
+ alias: routeAliases.value,
+ hello: 'world',
+ redirect: () => '/'
+ })
+ </script>
+ `,
+ },
+ ],
+ output: [
+ {
+ name: 'index',
+ path: '/',
+ file: `${pagesDir}/index.vue`,
+ meta: { [DYNAMIC_META_KEY]: new Set(['name', 'alias', 'redirect', 'meta']) },
+ children: [],
+ },
+ ],
+ },
+ {
+ description: 'should extract serializable values and override fallback when normalized with `overrideMeta: true`',
+ files: [
+ {
+ path: `${pagesDir}/index.vue`,
+ template: `
+ <script setup lang="ts">
+ definePageMeta({
+ name: 'home',
+ alias: ['sweet-home'],
+ redirect: '/',
+ hello: 'world'
+ })
+ </script>
+ `,
+ },
+ ],
+ output: [
+ {
+ name: 'home',
+ path: '/',
+ file: `${pagesDir}/index.vue`,
+ alias: ['sweet-home'],
+ redirect: '/',
+ children: [],
+ meta: { [DYNAMIC_META_KEY]: new Set(['meta']) },
+ },
+ ],
+ },
+ {
+ description: 'should handle unicode characters in alias paths',
+ files: [
+ {
+ path: `${pagesDir}/products.vue`,
+ template: `
+ <script setup lang="ts">
+ definePageMeta({
+ alias: ['/товары', '/produits', '/製品']
+ })
+ </script>
+ `,
+ },
+ ],
+ output: [
+ {
+ name: 'products',
+ path: '/products',
+ file: `${pagesDir}/products.vue`,
+ alias: ['/товары', '/produits', '/製品'],
+ children: [],
+ },
+ ],
+ },
+ {
+ description: 'route without file',
+ output: [
+ {
+ name: 'home',
+ path: '/',
+ alias: ['sweet-home'],
+ meta: { hello: 'world' },
+ },
+ ],
+ },
+ {
+ description: 'pushed route, skips generation from file',
+ output: [
+ {
+ name: 'pushed-route',
+ path: '/',
+ alias: ['pushed-route-alias'],
+ meta: { someMetaData: true },
+ file: `${pagesDir}/route-file.vue`,
+ },
+ ],
+ },
+ {
+ description: 'route.meta generated from file',
+ files: [
+ {
+ path: `${pagesDir}/page-with-meta.vue`,
+ meta: {
+ test: 1,
+ },
+ },
+ ],
+ output: [
+ {
+ name: 'page-with-meta',
+ path: '/page-with-meta',
+ file: `${pagesDir}/page-with-meta.vue`,
+ children: [],
+ meta: { test: 1 },
+ },
+ ],
+ },
+ {
+ description: 'should use more performant regexp when catchall is used in middle of path',
+ files: [
+ {
+ path: `${pagesDir}/[...id]/suffix.vue`,
+ },
+ {
+ path: `${pagesDir}/[...id]/index.vue`,
+ },
+ ],
+ output: [
+ {
+ name: 'id',
+ meta: undefined,
+ path: '/:id(.*)*',
+ file: `${pagesDir}/[...id]/index.vue`,
+ children: [],
+ },
+ {
+ name: 'id-suffix',
+ meta: undefined,
+ path: '/:id([^/]*)*/suffix',
+ file: `${pagesDir}/[...id]/suffix.vue`,
+ children: [],
+ },
+ ],
+ },
+ {
+ description: 'should merge route.meta with meta from file',
+ files: [
+ {
+ path: `${pagesDir}/page-with-meta.vue`,
+ meta: {
+ test: 1,
+ extracted: { foo: 'foo' },
+ },
+ template: `
+ <script setup lang="ts">
+ definePageMeta({
+ hello: 'world',
+ extracted: { bar: 'bar' },
+ })
+ </script>
+ `,
+ },
+ ],
+ output: [
+ {
+ name: 'page-with-meta',
+ path: '/page-with-meta',
+ file: `${pagesDir}/page-with-meta.vue`,
+ children: [],
+ meta: { [DYNAMIC_META_KEY]: new Set(['meta']), test: 1, extracted: { foo: 'foo', bar: 'bar' } },
+ },
+ ],
+ },
+ {
+ description: 'route.meta props generate by file',
+ files: [
+ {
+ path: `${pagesDir}/page-with-props.vue`,
+ template: `
+ <script setup lang="ts">
+ definePageMeta({
+ props: true
+ })
+ </script>
+ `,
+ },
+ ],
+ output: [
+ {
+ name: 'page-with-props',
+ path: '/page-with-props',
+ file: `${pagesDir}/page-with-props.vue`,
+ children: [],
+ props: true,
+ },
+ ],
+ },
+ {
+ description: 'should handle route groups',
+ files: [
+ { path: `${pagesDir}/(foo)/index.vue` },
+ { path: `${pagesDir}/(foo)/about.vue` },
+ { path: `${pagesDir}/(bar)/about/index.vue` },
+ { path: `${pagesDir}/(bar)/about/(foo)/index.vue` },
+ ],
+ output: [
+ {
+ name: 'index',
+ path: '/',
+ file: `${pagesDir}/(foo)/index.vue`,
+ meta: { groups: ['foo'] },
+ children: [],
+ },
+ {
+ path: '/about',
+ file: `${pagesDir}/(foo)/about.vue`,
+ meta: { groups: ['foo'] },
+ children: [
+ {
+ path: '',
+ file: `${pagesDir}/(bar)/about/index.vue`,
+ meta: { groups: ['bar'] },
+ children: [
+ {
+ name: 'about',
+ path: '',
+ file: `${pagesDir}/(bar)/about/(foo)/index.vue`,
+ meta: { groups: ['bar', 'foo'] },
+ children: [],
+ },
+ ],
+ },
+ ],
+ },
+ ],
+ },
+ {
+ description: 'should preserve named views from the `name@view.vue` filename convention',
+ files: [
+ { path: `${pagesDir}/foo.vue` },
+ { path: `${pagesDir}/foo/bar.vue` },
+ { path: `${pagesDir}/foo/bar@left.vue` },
+ ],
+ output: [
+ {
+ name: 'foo',
+ path: '/foo',
+ file: `${pagesDir}/foo.vue`,
+ children: [
+ {
+ name: 'foo-bar',
+ path: 'bar',
+ file: `${pagesDir}/foo/bar.vue`,
+ children: [],
+ components: {
+ default: `${pagesDir}/foo/bar.vue`,
+ left: `${pagesDir}/foo/bar@left.vue`,
+ },
+ },
+ ],
+ },
+ ],
+ },
+]
diff --git a/packages/nuxt/test/plugin-metadata.test.ts b/packages/nuxt/test/plugin-metadata.test.ts
new file mode 100644
index 000000000000..716643f28add
--- /dev/null
+++ b/packages/nuxt/test/plugin-metadata.test.ts
@@ -0,0 +1,107 @@
+import { describe, expect, it, vi } from 'vitest'
+
+import { RemovePluginMetadataPlugin, extractMetadata } from '../src/core/plugins/plugin-metadata.ts'
+import { checkForCircularDependencies } from '../src/core/app.ts'
+
+describe('plugin-metadata', () => {
+ const properties = Object.entries({
+ name: 'test',
+ enforce: 'post',
+ hooks: { 'app:mounted': () => {} },
+ setup: () => { return { provide: { jsx: '[JSX]' } } },
+ order: 1,
+ })
+ it.each(properties)('should extract metadata from object-syntax plugins', (k, value) => {
+ const obj = [...properties.filter(([key]) => key !== k), [k, value]]
+
+ const meta = extractMetadata([
+ 'export default defineNuxtPlugin({',
+ ...obj.map(([key, value]) => `${key}: ${typeof value === 'function' ? value.toString().replace('"[JSX]"', '() => <span>JSX</span>') : JSON.stringify(value)},`),
+ '})',
+ ].join('\n'), 'tsx')
+
+ expect(meta).toEqual({
+ 'name': 'test',
+ 'order': 1,
+ })
+ })
+
+ const transformPlugin: any = RemovePluginMetadataPlugin({
+ options: { sourcemap: { client: true } },
+ apps: { default: { plugins: [{ src: 'my-plugin.mjs', order: 10 }] } },
+ } as any).raw({}, {} as any)
+
+ it('should overwrite invalid plugins', () => {
+ const invalidPlugins = [
+ 'export const plugin = {}',
+ ]
+ for (const plugin of invalidPlugins) {
+ expect(transformPlugin.transform(plugin, 'my-plugin.mjs').code).toBe('export default () => {}')
+ }
+ })
+
+ it('should remove order/name properties from object-syntax plugins', () => {
+ const plugin = `
+ export default defineNuxtPlugin({
+ name: 'test',
+ enforce: 'post',
+ setup: () => {},
+ }, { order: 10, name: test })
+ `
+ expect(transformPlugin.transform(plugin, 'my-plugin.mjs').code).toMatchInlineSnapshot(`
+ "
+ export default defineNuxtPlugin({
+ setup: () => {},
+ }, { })
+ "
+ `)
+ })
+})
+
+describe('plugin sanity checking', () => {
+ it('non-existent depends are warned', () => {
+ vi.spyOn(console, 'error')
+ checkForCircularDependencies([
+ {
+ name: 'A',
+ src: '',
+ },
+ {
+ name: 'B',
+ dependsOn: ['D'],
+ src: '',
+ },
+ {
+ name: 'C',
+ src: '',
+ },
+ ])
+ expect(console.error).toHaveBeenCalledWith('Plugin `B` depends on `D` but they are not registered.')
+ vi.restoreAllMocks()
+ })
+
+ it('circular dependencies are warned', () => {
+ vi.spyOn(console, 'error')
+ checkForCircularDependencies([
+ {
+ name: 'A',
+ dependsOn: ['B'],
+ src: '',
+ },
+ {
+ name: 'B',
+ dependsOn: ['C'],
+ src: '',
+ },
+ {
+ name: 'C',
+ dependsOn: ['A'],
+ src: '',
+ },
+ ])
+ expect(console.error).toHaveBeenCalledWith('Circular dependency detected in plugins: A -> B -> C -> A')
+ expect(console.error).toHaveBeenCalledWith('Circular dependency detected in plugins: B -> C -> A -> B')
+ expect(console.error).toHaveBeenCalledWith('Circular dependency detected in plugins: C -> A -> B -> C')
+ vi.restoreAllMocks()
+ })
+})
diff --git a/packages/nuxt/test/plugin-utils.test.ts b/packages/nuxt/test/plugin-utils.test.ts
new file mode 100644
index 000000000000..b2fa2301e6c9
--- /dev/null
+++ b/packages/nuxt/test/plugin-utils.test.ts
@@ -0,0 +1,85 @@
+import { isValidIslandKey } from '#app/plugins/utils'
+import { describe, expect, it } from 'vitest'
+import { hash } from 'ohash'
+import { randomUUID } from 'node:crypto'
+
+describe('isValidIslandKey util', () => {
+ it('should accept valid island keys', () => {
+ // Valid keys following the componentName_hashId pattern
+ expect(isValidIslandKey('MyComponent_abc123')).toBe(true)
+ expect(isValidIslandKey('UserCard_def456')).toBe(true)
+ expect(isValidIslandKey('NavBar_xyz789')).toBe(true)
+ expect(isValidIslandKey('A_1')).toBe(true)
+ expect(isValidIslandKey('Component123_hash456')).toBe(true)
+ expect(isValidIslandKey('my-component_hash123')).toBe(true)
+ expect(isValidIslandKey('Component-Name_hash123')).toBe(true)
+ const sampleHash = hash({ props: randomUUID() }).replace(/[-_]/g, '')
+ expect(isValidIslandKey('ComponentName_' + sampleHash)).toBe(true)
+ })
+
+ it('should reject invalid island keys', () => {
+ // Empty or null/undefined
+ expect(isValidIslandKey('')).toBe(false)
+ expect(isValidIslandKey(null as any)).toBe(false)
+ expect(isValidIslandKey(undefined as any)).toBe(false)
+
+ // Missing underscore separator
+ expect(isValidIslandKey('ComponentName')).toBe(false)
+ expect(isValidIslandKey('hash123')).toBe(false)
+
+ // Invalid characters
+ expect(isValidIslandKey('Component/Name_hash123')).toBe(false)
+ expect(isValidIslandKey('Component\\Name_hash123')).toBe(false)
+ expect(isValidIslandKey('Component..Name_hash123')).toBe(false)
+ expect(isValidIslandKey('Component Name_hash123')).toBe(false)
+ expect(isValidIslandKey('Component<script>_hash123')).toBe(false)
+ expect(isValidIslandKey('Component"_hash123')).toBe(false)
+ expect(isValidIslandKey('Component\'_hash123')).toBe(false)
+
+ // Starting with invalid characters
+ expect(isValidIslandKey('123Component_hash123')).toBe(false)
+ expect(isValidIslandKey('_Component_hash123')).toBe(false)
+ expect(isValidIslandKey('-Component_hash123')).toBe(false)
+
+ // Path traversal attempts
+ expect(isValidIslandKey('../Component_hash123')).toBe(false)
+ expect(isValidIslandKey('../../Component_hash123')).toBe(false)
+ expect(isValidIslandKey('Component_../hash123')).toBe(false)
+ expect(isValidIslandKey('Component_../../hash123')).toBe(false)
+
+ // URL/protocol attempts
+ expect(isValidIslandKey('http://evil.com_hash123')).toBe(false)
+ expect(isValidIslandKey('file:///etc/passwd_hash123')).toBe(false)
+ expect(isValidIslandKey('Component_http://evil.com')).toBe(false)
+
+ const longKey = 'A'.repeat(95) + '_' + 'B'.repeat(10)
+ expect(isValidIslandKey(longKey)).toBe(false)
+
+ expect(isValidIslandKey('Component_Name_hash123')).toBe(false)
+ expect(isValidIslandKey('Component__hash123')).toBe(false)
+ })
+
+ it('should handle edge cases', () => {
+ // Maximum allowed length (100 chars)
+ const maxLengthKey = 'A'.repeat(94) + '_' + 'B'.repeat(5) // 100 chars total
+ expect(isValidIslandKey(maxLengthKey)).toBe(true)
+
+ // Just over maximum length
+ const overLengthKey = 'A'.repeat(95) + '_' + 'B'.repeat(6) // 102 chars total
+ expect(isValidIslandKey(overLengthKey)).toBe(false)
+
+ // Minimum valid length
+ expect(isValidIslandKey('A_1')).toBe(true)
+
+ // Single character component name with long hash
+ expect(isValidIslandKey('A_' + 'B'.repeat(97))).toBe(true) // 100 chars total
+ })
+
+ it('should reject non-string inputs', () => {
+ expect(isValidIslandKey(123 as any)).toBe(false)
+ expect(isValidIslandKey({} as any)).toBe(false)
+ expect(isValidIslandKey([] as any)).toBe(false)
+ expect(isValidIslandKey(true as any)).toBe(false)
+ expect(isValidIslandKey(Symbol('test') as any)).toBe(false)
+ })
+})
diff --git a/packages/nuxt/test/prehydrate.test.ts b/packages/nuxt/test/prehydrate.test.ts
new file mode 100644
index 000000000000..95f588b629f0
--- /dev/null
+++ b/packages/nuxt/test/prehydrate.test.ts
@@ -0,0 +1,40 @@
+import { describe, expect, it } from 'vitest'
+
+import { PrehydrateTransformPlugin } from '../src/core/plugins/prehydrate.ts'
+
+describe('prehydrate', () => {
+ const transformPlugin = PrehydrateTransformPlugin().raw({}, {} as any) as { transform: { handler: (code: string, id: string) => { code: string } | null } }
+
+ it('should extract and minify code in onPrehydrate', async () => {
+ const snippet = `
+onPrehydrate(() => {
+ console.log('hello world')
+})
+ `
+ const snippet2 = `
+export default {
+ async setup () {
+ onPrehydrate(() => {
+ console.log('hello world')
+ })
+ }
+}
+ `
+
+ for (const item of [snippet, snippet2]) {
+ const { code } = await transformPlugin.transform.handler(item, 'test.ts') ?? {}
+ expect(code).toContain(`onPrehydrate("(()=>{console.log(\`hello world\`)})")`)
+ }
+ })
+
+ it('should add hash if required', async () => {
+ const snippet = `
+onPrehydrate((attr) => {
+ console.log('hello world')
+})
+ `
+
+ const { code } = await transformPlugin.transform.handler(snippet, 'test.ts') ?? {}
+ expect(code?.trim()).toMatchInlineSnapshot(`"onPrehydrate("(e=>{console.log(\`hello world\`)})", "LPWqofgLVF")"`)
+ })
+})
diff --git a/packages/nuxt/test/render.bench.ts b/packages/nuxt/test/render.bench.ts
new file mode 100644
index 000000000000..459e9dfd6844
--- /dev/null
+++ b/packages/nuxt/test/render.bench.ts
@@ -0,0 +1,42 @@
+import { fileURLToPath } from 'node:url'
+import { rm } from 'node:fs/promises'
+import { beforeAll, bench, describe, expect } from 'vitest'
+import { join } from 'pathe'
+import { x } from 'tinyexec'
+import { build, loadNuxt } from 'nuxt'
+import { findWorkspaceDir } from 'pkg-types'
+
+const repoRoot = await findWorkspaceDir()
+const basicTestFixtureDir = join(repoRoot, 'test/fixtures/basic')
+const outputDir = join(repoRoot, 'node_modules/.test/render')
+
+describe.todo('render', () => {
+ beforeAll(async () => {
+ await rm(join(basicTestFixtureDir, 'node_modules/render/.nuxt'), { recursive: true, force: true })
+ const nuxt = await loadNuxt({
+ cwd: basicTestFixtureDir,
+ ready: true,
+ overrides: {
+ buildDir: join(basicTestFixtureDir, 'node_modules/render/.nuxt'),
+ nitro: {
+ output: {
+ dir: outputDir,
+ },
+ },
+ sourcemap: false,
+ },
+ })
+ nuxt.hook('nitro:build:before', (nitro) => {
+ nitro.options.entry = fileURLToPath(new URL('./nitro/render-index', import.meta.url))
+ })
+ await build(nuxt)
+ await nuxt.close()
+ }, 200_000)
+
+ bench('index route in the basic test fixture', async () => {
+ const res = await x('node', [join(outputDir, 'server/index.mjs')], {
+ nodeOptions: { stdio: 'pipe' },
+ })
+ expect(res.stdout).toContain('Hello Nuxt 3!')
+ })
+})
diff --git a/packages/nuxt/test/resolve-type-paths.test.ts b/packages/nuxt/test/resolve-type-paths.test.ts
new file mode 100644
index 000000000000..c143fc9fa2eb
--- /dev/null
+++ b/packages/nuxt/test/resolve-type-paths.test.ts
@@ -0,0 +1,151 @@
+import { afterEach, describe, expect, it, vi } from 'vitest'
+
+vi.mock('exsolve', () => ({
+ resolveModulePath: vi.fn(),
+}))
+
+vi.mock('pkg-types', () => ({
+ resolvePackageJSON: vi.fn(),
+}))
+
+const { resolveModulePath } = await import('exsolve')
+const { resolvePackageJSON } = await import('pkg-types')
+
+const mockedResolveModulePath = vi.mocked(resolveModulePath)
+const mockedResolvePackageJSON = vi.mocked(resolvePackageJSON)
+
+// Re-import resolveTypePaths for each test to reset the module-level rootCache
+function freshImport () {
+ vi.resetModules()
+
+ // Re-setup mocks after module reset (they get cleared too)
+ vi.doMock('exsolve', () => ({ resolveModulePath: mockedResolveModulePath }))
+ vi.doMock('pkg-types', () => ({ resolvePackageJSON: mockedResolvePackageJSON }))
+
+ return import('../src/core/utils/types.ts')
+}
+
+describe('resolveTypePaths', () => {
+ afterEach(() => {
+ vi.clearAllMocks()
+ })
+
+ it('resolves a base package to its root directory', async () => {
+ const { resolveTypePaths } = await freshImport()
+
+ mockedResolveModulePath.mockReturnValue('/node_modules/vue/dist/vue.mjs')
+ mockedResolvePackageJSON.mockResolvedValue('/node_modules/vue/package.json')
+
+ const results = await resolveTypePaths(['vue'], ['/project/node_modules'])
+
+ expect(results).toEqual([['vue', '/node_modules/vue']])
+ })
+
+ it('resolves a subpath entry via the base package root', async () => {
+ const { resolveTypePaths } = await freshImport()
+
+ mockedResolveModulePath.mockImplementation((path) => {
+ if (path === 'nitro') { return '/node_modules/nitro/dist/index.mjs' }
+ if (path === 'nitro/app') { return '/node_modules/nitro/dist/app.d.mts' }
+ throw new Error('MODULE_NOT_FOUND')
+ })
+ mockedResolvePackageJSON.mockResolvedValue('/node_modules/nitro/package.json')
+
+ const results = await resolveTypePaths(['nitro/app'], ['/project/node_modules'])
+
+ expect(results).toEqual([['nitro/app', '/node_modules/nitro/dist/app']])
+ })
+
+ it('caches base package root across multiple subpath entries', async () => {
+ const { resolveTypePaths } = await freshImport()
+
+ mockedResolveModulePath.mockImplementation((path) => {
+ if (path === 'nitro') { return '/node_modules/nitro/dist/index.mjs' }
+ if (path === 'nitro/app') { return '/node_modules/nitro/dist/app.d.mts' }
+ if (path === 'nitro/builder') { return '/node_modules/nitro/dist/builder.d.mts' }
+ throw new Error('MODULE_NOT_FOUND')
+ })
+ mockedResolvePackageJSON.mockResolvedValue('/node_modules/nitro/package.json')
+
+ const results = await resolveTypePaths(['nitro/app', 'nitro/builder'], ['/project/node_modules'])
+
+ expect(results).toHaveLength(2)
+ expect(results).toContainEqual(['nitro/app', '/node_modules/nitro/dist/app'])
+ expect(results).toContainEqual(['nitro/builder', '/node_modules/nitro/dist/builder'])
+
+ // resolvePackageJSON called only once (for the base 'nitro', then cached)
+ expect(mockedResolvePackageJSON).toHaveBeenCalledTimes(1)
+ })
+
+ it('skips subpath entries when base package cannot be resolved', async () => {
+ const { resolveTypePaths } = await freshImport()
+
+ mockedResolveModulePath.mockImplementation(() => {
+ throw new Error('MODULE_NOT_FOUND')
+ })
+
+ const results = await resolveTypePaths(['missing/app', 'missing/builder'], ['/project/node_modules'])
+
+ expect(results).toEqual([])
+ })
+
+ it('handles a mix of base packages and subpath entries', async () => {
+ const { resolveTypePaths } = await freshImport()
+
+ mockedResolveModulePath.mockImplementation((path) => {
+ const map: Record<string, string> = {
+ 'vue': '/node_modules/vue/dist/vue.mjs',
+ 'nitro': '/node_modules/nitro/dist/index.mjs',
+ 'nitro/app': '/node_modules/nitro/dist/app.d.mts',
+ 'nitro/types': '/node_modules/nitro/dist/types.d.mts',
+ }
+ if (typeof path === 'string' && path in map) { return map[path]! }
+ throw new Error('MODULE_NOT_FOUND')
+ })
+
+ // eslint-disable-next-line require-await
+ mockedResolvePackageJSON.mockImplementation(async (r) => {
+ if (r?.includes('vue')) { return '/node_modules/vue/package.json' }
+ if (r?.includes('nitro')) { return '/node_modules/nitro/package.json' }
+ throw new Error('not found')
+ })
+
+ const results = await resolveTypePaths(['vue', 'nitro/app', 'nitro/types'], ['/project/node_modules'])
+
+ expect(results).toHaveLength(3)
+ expect(results).toContainEqual(['vue', '/node_modules/vue'])
+ expect(results).toContainEqual(['nitro/app', '/node_modules/nitro/dist/app'])
+ expect(results).toContainEqual(['nitro/types', '/node_modules/nitro/dist/types'])
+ })
+
+ it('strips various type extensions from subpath resolutions', async () => {
+ const { resolveTypePaths } = await freshImport()
+
+ mockedResolveModulePath.mockImplementation((path) => {
+ if (path === 'nitro') { return '/node_modules/nitro/dist/index.mjs' }
+ if (path === 'nitro/app') { return '/node_modules/nitro/dist/app.d.mts' }
+ throw new Error('MODULE_NOT_FOUND')
+ })
+ mockedResolvePackageJSON.mockResolvedValue('/node_modules/nitro/package.json')
+
+ const results = await resolveTypePaths(['nitro/app'], ['/project/node_modules'])
+
+ // .d.mts should be stripped
+ expect(results[0]![1]).toBe('/node_modules/nitro/dist/app')
+ })
+
+ it('handles resolution errors gracefully for individual packages', async () => {
+ const { resolveTypePaths } = await freshImport()
+
+ mockedResolveModulePath.mockImplementation((path) => {
+ if (path === 'vue') { return '/node_modules/vue/dist/vue.mjs' }
+ throw new Error('MODULE_NOT_FOUND')
+ })
+ mockedResolvePackageJSON.mockResolvedValue('/node_modules/vue/package.json')
+
+ const results = await resolveTypePaths(['vue', 'nonexistent'], ['/project/node_modules'])
+
+ // vue resolves, nonexistent is silently skipped
+ expect(results).toEqual([['vue', '/node_modules/vue']])
+ })
+})
diff --git a/packages/nuxt/test/route-injection.test.ts b/packages/nuxt/test/route-injection.test.ts
new file mode 100644
index 000000000000..27e48bbd2c4c
--- /dev/null
+++ b/packages/nuxt/test/route-injection.test.ts
@@ -0,0 +1,71 @@
+import { describe, expect, it } from 'vitest'
+import { compileScript, compileTemplate, parse } from '@vue/compiler-sfc'
+import type { Nuxt } from '@nuxt/schema'
+import { RouteInjectionPlugin } from '../src/pages/plugins/route-injection.ts'
+
+describe('route-injection:transform', () => {
+ const injectionPlugin = RouteInjectionPlugin({ options: { sourcemap: { client: false, server: false } } } as Nuxt).raw({}, { framework: 'rollup' }) as { transform: { handler: (code: string, id: string) => { code: string } | null } }
+
+ const transform = async (source: string) => {
+ const result = await injectionPlugin.transform.handler.call({ error: null, warn: null } as any, source, 'test.vue')
+ const code: string = typeof result === 'string' ? result : result!.code
+ let depth = 0
+ return code.split('\n').map((l) => {
+ l = l.trim()
+ if (l.match(/^[}\]]/)) { depth-- }
+ const res = ''.padStart(depth * 2, ' ') + l
+ if (l.match(/[{[]$/)) { depth++ }
+ return res
+ }).join('\n')
+ }
+
+ it('should correctly inject route in template', async () => {
+ const sfc = `<template>{{ $route.path }}</template>`
+ const res = compileTemplate({
+ filename: 'test.vue',
+ id: 'test.vue',
+ source: sfc,
+ })
+ const transformResult = await transform(res.code)
+ expect(transformResult).toMatchInlineSnapshot(`
+ "import { PageRouteSymbol as __nuxt_route_symbol } from '#app/components/injections';
+ import { toDisplayString as _toDisplayString, createTextVNode as _createTextVNode, openBlock as _openBlock, createElementBlock as _createElementBlock } from "vue"
+
+ export function render(_ctx, _cache) {
+ return (_openBlock(), _createElementBlock("template", null, [
+ _createTextVNode(_toDisplayString((_ctx._.provides[__nuxt_route_symbol] || _ctx.$route).path), 1 /* TEXT */)
+ ]))
+ }"
+ `)
+ })
+
+ it('should correctly inject route in options api', async () => {
+ const sfc = `
+ <template>{{ thing }}</template>
+ <script>
+ export default {
+ computed: {
+ thing () {
+ return this.$route.path
+ }
+ }
+ }
+ </script>
+ `
+
+ const res = compileScript(parse(sfc).descriptor, { id: 'test.vue' })
+ const transformResult = await transform(res.content)
+ expect(transformResult).toMatchInlineSnapshot(`
+ "import { PageRouteSymbol as __nuxt_route_symbol } from '#app/components/injections';
+
+ export default {
+ computed: {
+ thing () {
+ return (this._.provides[__nuxt_route_symbol] || this.$route).path
+ }
+ }
+ }
+ "
+ `)
+ })
+})
diff --git a/packages/nuxt/test/route-rules.test.ts b/packages/nuxt/test/route-rules.test.ts
new file mode 100644
index 000000000000..9ef2c10e2158
--- /dev/null
+++ b/packages/nuxt/test/route-rules.test.ts
@@ -0,0 +1,56 @@
+import { describe, expect, it } from 'vitest'
+
+import { globRouteRulesFromPages, removePagesRules } from '../src/pages/route-rules.ts'
+
+describe('routeRules from page meta', () => {
+ const getPages = () => [
+ {
+ path: '/',
+ rules: { prerender: true },
+ },
+ // parent without routeRules
+ {
+ path: '/users',
+ children: [{ path: ':id', rules: { prerender: true } }],
+ },
+ // nested paths
+ {
+ path: '/some',
+ children: [
+ {
+ path: 'nested',
+ children: [{ path: 'page', rules: { prerender: true } }],
+ },
+ ],
+ },
+ // page with empty routeRules
+ {
+ path: '/contact',
+ rules: {},
+ },
+ ]
+
+ it('extracts route rules from pages', () => {
+ const pages = getPages()
+ const result = globRouteRulesFromPages(pages)
+ expect(result).toEqual({
+ '/': { prerender: true },
+ '/some/nested/page': { prerender: true },
+ '/users/**': { prerender: true },
+ })
+ })
+
+ it('removes route rules from pages', () => {
+ const pages = getPages()
+ removePagesRules(pages)
+ expect(pages).toEqual([
+ { path: '/' },
+ { path: '/users', children: [{ path: ':id' }] },
+ {
+ path: '/some',
+ children: [{ path: 'nested', children: [{ path: 'page' }] }],
+ },
+ { path: '/contact' },
+ ])
+ })
+})
diff --git a/packages/nuxt/test/scan-components.test.ts b/packages/nuxt/test/scan-components.test.ts
new file mode 100644
index 000000000000..d40367e53074
--- /dev/null
+++ b/packages/nuxt/test/scan-components.test.ts
@@ -0,0 +1,254 @@
+import { resolve } from 'pathe'
+import { consola } from 'consola'
+import { expect, it, vi } from 'vitest'
+
+import { scanComponents } from '../src/components/scan.ts'
+import { componentsFixtureDir } from './utils.ts'
+import type { ComponentsDir } from 'nuxt/schema'
+
+const rFixture = (...p: string[]) => resolve(componentsFixtureDir, ...p)
+
+vi.mock('@nuxt/kit', () => ({
+ isIgnored: () => false,
+ useLogger: () => consola.create({}).withTag('nuxt'),
+}))
+
+const dirs: ComponentsDir[] = [
+ {
+ path: rFixture('components/islands'),
+ extensions: [
+ 'vue',
+ ],
+ pattern: '**/*.{vue,}',
+ ignore: [
+ '**/*.stories.{js,ts,jsx,tsx}',
+ '**/*{M,.m,-m}ixin.{js,ts,jsx,tsx}',
+ '**/*.d.ts',
+ ],
+ transpile: false,
+ island: true,
+ },
+ {
+ path: rFixture('components/global'),
+ extensions: [
+ 'vue',
+ ],
+ pattern: '**/*.{vue,}',
+ ignore: [
+ '**/*.stories.{js,ts,jsx,tsx}',
+ '**/*{M,.m,-m}ixin.{js,ts,jsx,tsx}',
+ '**/*.d.ts',
+ ],
+ transpile: false,
+ global: true,
+ },
+ {
+ path: rFixture('components'),
+ extensions: [
+ 'vue',
+ ],
+ pattern: '**/*.{vue,}',
+ ignore: [
+ '**/*.stories.{js,ts,jsx,tsx}',
+ '**/*{M,.m,-m}ixin.{js,ts,jsx,tsx}',
+ '**/*.d.ts',
+ ],
+ transpile: false,
+ },
+ {
+ path: rFixture('components'),
+ extensions: [
+ 'vue',
+ ],
+ pattern: '**/*.{vue,}',
+ ignore: [
+ '**/*.stories.{js,ts,jsx,tsx}',
+ '**/*{M,.m,-m}ixin.{js,ts,jsx,tsx}',
+ '**/*.d.ts',
+ ],
+ transpile: false,
+ },
+ {
+ path: rFixture('components'),
+ extensions: [
+ 'vue',
+ ],
+ prefix: 'nuxt',
+ pattern: '**/*.{vue,}',
+ ignore: [
+ '**/*.stories.{js,ts,jsx,tsx}',
+ '**/*{M,.m,-m}ixin.{js,ts,jsx,tsx}',
+ '**/*.d.ts',
+ ],
+ transpile: false,
+ },
+]
+const expectedComponents = [
+ {
+ chunkName: 'components/isle-server',
+ declarationPath: rFixture('components/islands/Isle.vue'),
+ export: 'default',
+ global: undefined,
+ island: true,
+ kebabName: 'isle',
+ mode: 'server',
+ pascalName: 'Isle',
+ prefetch: false,
+ preload: false,
+ priority: 1,
+ shortPath: 'components/islands/Isle.vue',
+ },
+ {
+ chunkName: 'components/glob',
+ declarationPath: rFixture('components/global/Glob.vue'),
+ export: 'default',
+ global: true,
+ island: undefined,
+ kebabName: 'glob',
+ mode: 'all',
+ pascalName: 'Glob',
+ prefetch: false,
+ preload: false,
+ priority: 1,
+ shortPath: 'components/global/Glob.vue',
+ },
+ {
+ mode: 'all',
+ pascalName: 'HelloWorld',
+ kebabName: 'hello-world',
+ chunkName: 'components/hello-world',
+ declarationPath: rFixture('components/HelloWorld.vue'),
+ shortPath: 'components/HelloWorld.vue',
+ export: 'default',
+ global: undefined,
+ island: undefined,
+ prefetch: false,
+ preload: false,
+ priority: 1,
+ },
+ {
+ mode: 'client',
+ pascalName: 'Nuxt3',
+ kebabName: 'nuxt3',
+ chunkName: 'components/nuxt3-client',
+ declarationPath: rFixture('components/Nuxt3.client.vue'),
+ shortPath: 'components/Nuxt3.client.vue',
+ export: 'default',
+ global: undefined,
+ island: undefined,
+ prefetch: false,
+ preload: false,
+ priority: 1,
+ },
+ {
+ mode: 'server',
+ pascalName: 'Nuxt3',
+ kebabName: 'nuxt3',
+ chunkName: 'components/nuxt3-server',
+ declarationPath: rFixture('components/Nuxt3.server.vue'),
+ shortPath: 'components/Nuxt3.server.vue',
+ export: 'default',
+ global: undefined,
+ island: undefined,
+ prefetch: false,
+ preload: false,
+ priority: 1,
+ },
+ {
+ chunkName: 'components/client-component-with-props',
+ declarationPath: rFixture('components/client/ComponentWithProps.vue'),
+ export: 'default',
+ global: undefined,
+ island: undefined,
+ kebabName: 'client-component-with-props',
+ mode: 'all',
+ pascalName: 'ClientComponentWithProps',
+ prefetch: false,
+ preload: false,
+ priority: 1,
+ shortPath: 'components/client/ComponentWithProps.vue',
+ },
+ {
+ chunkName: 'components/client-with-client-only-setup',
+ declarationPath: rFixture('components/client/WithClientOnlySetup.vue'),
+ export: 'default',
+ global: undefined,
+ island: undefined,
+ kebabName: 'client-with-client-only-setup',
+ mode: 'all',
+ pascalName: 'ClientWithClientOnlySetup',
+ prefetch: false,
+ preload: false,
+ priority: 1,
+ shortPath: 'components/client/WithClientOnlySetup.vue',
+ },
+ {
+ mode: 'server',
+ pascalName: 'ParentFolder',
+ kebabName: 'parent-folder',
+ chunkName: 'components/parent-folder-server',
+ declarationPath: rFixture('components/parent-folder/index.server.vue'),
+ shortPath: 'components/parent-folder/index.server.vue',
+ export: 'default',
+ global: undefined,
+ island: undefined,
+ prefetch: false,
+ preload: false,
+ priority: 1,
+ },
+ {
+ chunkName: 'components/same-name-same',
+ declarationPath: rFixture('components/same-name/same/Same.vue'),
+ export: 'default',
+ global: undefined,
+ island: undefined,
+ kebabName: 'same-name-same',
+ mode: 'all',
+ pascalName: 'SameNameSame',
+ prefetch: false,
+ preload: false,
+ priority: 1,
+ shortPath: 'components/same-name/same/Same.vue',
+ },
+ {
+ chunkName: 'components/some-glob',
+ declarationPath: rFixture('components/some-glob.global.vue'),
+ export: 'default',
+ global: true,
+ island: undefined,
+ kebabName: 'some-glob',
+ mode: 'all',
+ pascalName: 'SomeGlob',
+ prefetch: false,
+ preload: false,
+ priority: 1,
+ shortPath: 'components/some-glob.global.vue',
+ },
+ {
+ chunkName: 'components/some-server',
+ declarationPath: rFixture('components/some.island.vue'),
+ export: 'default',
+ global: undefined,
+ island: true,
+ kebabName: 'some',
+ mode: 'server',
+ pascalName: 'Some',
+ prefetch: false,
+ preload: false,
+ priority: 1,
+ shortPath: 'components/some.island.vue',
+ },
+]
+
+const srcDir = rFixture('.')
+
+it('components:scanComponents', async () => {
+ const scannedComponents = await scanComponents(dirs, srcDir)
+ for (const c of scannedComponents) {
+ // @ts-expect-error filePath is not optional but we don't want it to be in the snapshot
+ delete c.filePath
+ // @ts-expect-error _scanned is added internally but we don't want it to be in the snapshot
+ delete c._scanned
+ }
+ expect(scannedComponents).deep.eq(expectedComponents)
+})
diff --git a/packages/nuxt/test/shared-dir-config.test.ts b/packages/nuxt/test/shared-dir-config.test.ts
new file mode 100644
index 000000000000..f134f5ae2b44
--- /dev/null
+++ b/packages/nuxt/test/shared-dir-config.test.ts
@@ -0,0 +1,54 @@
+import { describe, expect, it } from 'vitest'
+import { join } from 'pathe'
+import type { NuxtConfig } from '@nuxt/schema'
+import { loadNuxt } from '../src/index.ts'
+import { findWorkspaceDir } from 'pkg-types'
+
+const repoRoot = await findWorkspaceDir()
+const fixtureDir = join(repoRoot, 'test/fixtures/basic')
+
+describe('loadNuxt', () => {
+ it('adds shared directories for layers to nitro auto-imports in v4', async () => {
+ const importDirs = await getNitroImportDirs()
+ expect(normalizePaths(importDirs)).toMatchInlineSnapshot(`
+ [
+ "<rootDir>/shared/utils",
+ "<rootDir>/shared/types",
+ "<rootDir>/extends/bar/shared/utils",
+ "<rootDir>/extends/bar/shared/types",
+ "<rootDir>/layers/bar/shared/utils",
+ "<rootDir>/layers/bar/shared/types",
+ "<rootDir>/extends/node_modules/foo/shared/utils",
+ "<rootDir>/extends/node_modules/foo/shared/types",
+ ]
+ `)
+ })
+})
+
+function normalizePaths (arr: unknown[]) {
+ const normalized = []
+ for (const dir of arr) {
+ normalized.push(typeof dir === 'string' ? dir.replace(fixtureDir, '<rootDir>') : dir)
+ }
+ return normalized
+}
+
+async function getNitroImportDirs (overrides?: NuxtConfig) {
+ const importDirs: unknown[] = []
+ const nuxt = await loadNuxt({
+ cwd: fixtureDir,
+ ready: true,
+ overrides: {
+ ...overrides,
+ hooks: {
+ 'nitro:config' (config) {
+ if (config.imports) {
+ importDirs.push(...config.imports.dirs || [])
+ }
+ },
+ },
+ },
+ })
+ await nuxt.close()
+ return importDirs
+}
diff --git a/packages/nuxt/test/tree-shake.test.ts b/packages/nuxt/test/tree-shake.test.ts
new file mode 100644
index 000000000000..0885f24adce5
--- /dev/null
+++ b/packages/nuxt/test/tree-shake.test.ts
@@ -0,0 +1,196 @@
+import { describe, expect, it } from 'vitest'
+
+import { TreeShakeComposablesPlugin } from '../src/core/plugins/tree-shake.ts'
+import { clean } from './utils.ts'
+
+describe('tree-shake', () => {
+ const transformPlugin: any = TreeShakeComposablesPlugin({
+ composables: { 'vue': ['onMounted'] },
+ }).raw({}, {} as any)
+
+ it('should tree shake composables from source code', () => {
+ const code = `
+ onMounted(() => {})
+ console.log('Hello World')
+ `
+ const { code: result } = transformPlugin.transform.handler(code, 'test.js')
+ expect(clean(result)).toMatchInlineSnapshot(`
+ " false && /*@__PURE__*/ onMounted(() => {})
+ console.log('Hello World')"
+ `)
+ })
+
+ it('should tree-shake explicitly-imported composables', () => {
+ const code = `
+ import { onMounted as _onMounted } from 'vue'
+ _onMounted(() => {})
+ console.log('Hello World')
+ `
+ const { code: result } = transformPlugin.transform.handler(code, 'test.js')
+ expect(clean(result)).toMatchInlineSnapshot(`
+ "import { onMounted as _onMounted } from 'vue'
+ false && /*@__PURE__*/ _onMounted(() => {})
+ console.log('Hello World')"
+ `)
+ })
+
+ it('should not error when tree-shaking composables within other tree-shaken composables', () => {
+ const code = `
+ import { onMounted } from 'vue'
+ onMounted(() => {
+ onMounted(() => {})
+ })
+ onMounted(() => {})
+ `
+ const { code: result } = transformPlugin.transform.handler(code, 'test.js')
+ expect(clean(result)).toMatchInlineSnapshot(`
+ "import { onMounted } from 'vue'
+ false && /*@__PURE__*/ onMounted(() => {
+ onMounted(() => {})
+ })
+ false && /*@__PURE__*/ onMounted(() => {})"
+ `)
+ })
+
+ it('should tree-shake explicitly-imported composables from #imports', () => {
+ const code = `
+ import { onMounted } from '#imports'
+ onMounted(() => {})
+ console.log('Hello World')
+ `
+ const { code: result } = transformPlugin.transform.handler(code, 'test.js')
+ expect(clean(result)).toMatchInlineSnapshot(`
+ "import { onMounted } from '#imports'
+ false && /*@__PURE__*/ onMounted(() => {})
+ console.log('Hello World')"
+ `)
+ })
+
+ it('should not tree-shake composables from other paths', () => {
+ const code = `
+ import { onMounted } from 'other-path'
+ onMounted(() => {})
+ console.log('Hello World')
+ `
+ const result = transformPlugin.transform.handler(code, 'test.js')
+ expect(result).toBeUndefined()
+ })
+
+ it('should not tree-shake object properties', () => {
+ const code = `
+ console.log({
+ onMounted(_) {}
+ })
+ `
+ const result = transformPlugin.transform.handler(code, 'test.js')
+ expect(result).toBeUndefined()
+ })
+
+ it('should handle shadowing of outer-scope composables', () => {
+ const code = `
+ import { onMounted } from '#imports'
+
+ onMounted(() => console.log('treeshake this'))
+
+ function foo() {
+ onMounted()
+
+ function onMounted() {
+ console.log('do not treeshake this')
+ }
+ }
+ `
+ const { code: result } = transformPlugin.transform.handler(code, 'test.js')
+ expect(clean(result)).toMatchInlineSnapshot(`
+ "import { onMounted } from '#imports'
+ false && /*@__PURE__*/ onMounted(() => console.log('treeshake this'))
+ function foo() {
+ onMounted()
+ function onMounted() {
+ console.log('do not treeshake this')
+ }
+ }"
+ `)
+ })
+
+ it('should handle variable shadowing', () => {
+ const code = `
+ import { onMounted } from '#imports'
+
+ onMounted()
+
+ function test() {
+ const onMounted = () => 'local'
+ onMounted()
+ }
+ `
+ const { code: result } = transformPlugin.transform.handler(code, 'test.js')
+ expect(clean(result)).toMatchInlineSnapshot(`
+ "import { onMounted } from '#imports'
+ false && /*@__PURE__*/ onMounted()
+ function test() {
+ const onMounted = () => 'local'
+ onMounted()
+ }"
+ `)
+ })
+
+ it('should handle usage in function parameter', () => {
+ const code = `
+ import { onMounted } from '#imports'
+ test(123, onMounted(), 456)
+ `
+ const { code: result } = transformPlugin.transform.handler(code, 'test.js')
+ expect(clean(result)).toMatchInlineSnapshot(`
+ "import { onMounted } from '#imports'
+ test(123, false && /*@__PURE__*/ onMounted(), 456)"
+ `)
+ })
+
+ it('should handle assignments', () => {
+ const code = `
+ import { onMounted } from '#imports'
+
+ let a
+ a = onMounted()
+ b = 3
+ `
+ const { code: result } = transformPlugin.transform.handler(code, 'test.js')
+ expect(clean(result)).toMatchInlineSnapshot(`
+ "import { onMounted } from '#imports'
+ let a
+ a = false && /*@__PURE__*/ onMounted()
+ b = 3"
+ `)
+ })
+
+ it('should handle conditional/test/logical contexts', () => {
+ const code = `
+ import { onMounted } from 'vue'
+ if (onMounted()) {}
+ onMounted() && doThing()
+ doThing() || onMounted()
+ const x = cond ? onMounted() : 0
+ `
+ const { code: result } = transformPlugin.transform.handler(code, 'test.js')
+ expect(clean(result)).toMatchInlineSnapshot(`
+ "import { onMounted } from 'vue'
+ if ( false && /*@__PURE__*/ onMounted()) {}
+ false && /*@__PURE__*/ onMounted() && doThing()
+ doThing() || false && /*@__PURE__*/ onMounted()
+ const x = cond ? false && /*@__PURE__*/ onMounted() : 0"
+ `)
+ })
+
+ it('should handle sequence in expression statement', () => {
+ const code = `
+ import { onMounted } from 'vue'
+ (foo(), onMounted(), bar())
+ `
+ const { code: result } = transformPlugin.transform.handler(code, 'test.js')
+ expect(clean(result)).toMatchInlineSnapshot(`
+ "import { onMounted } from 'vue'
+ (foo(), false && /*@__PURE__*/ onMounted(), bar())"
+ `)
+ })
+})
diff --git a/packages/nuxt/test/unctx-transform.test.ts b/packages/nuxt/test/unctx-transform.test.ts
new file mode 100644
index 000000000000..408098fa5c29
--- /dev/null
+++ b/packages/nuxt/test/unctx-transform.test.ts
@@ -0,0 +1,67 @@
+import { describe, expect, it } from 'vitest'
+
+import { UnctxTransformPlugin } from '../src/core/plugins/unctx.ts'
+
+describe('unctx transform in nuxt', () => {
+ it('should transform nuxt plugins', async () => {
+ const code = `
+ export default defineNuxtPlugin({
+ async setup () {
+ await Promise.resolve()
+ }
+ })
+ `
+ expect(await transform(code)).toMatchInlineSnapshot(`
+ "/* _processed_nuxt_unctx_transform */
+ import { executeAsync as __executeAsync } from "unctx";
+ export default defineNuxtPlugin({
+ async setup () {let __temp, __restore;
+ ;(([__temp,__restore]=__executeAsync(()=>Promise.resolve())),await __temp,__restore());
+ }
+ },1)"
+ `)
+ })
+
+ it('should transform vue components using defineNuxtComponent', async () => {
+ const code = `
+ definePageMeta({
+ async middleware() {
+ await Promise.resolve()
+ }
+ })
+ export default defineNuxtComponent({
+ async setup () {
+ await Promise.resolve()
+ }
+ })
+ `
+ expect(await transform(code, 'app.ts')).toMatchInlineSnapshot(`
+ "/* _processed_nuxt_unctx_transform */
+ import { executeAsync as __executeAsync } from "unctx";
+ definePageMeta({
+ async middleware() {let __temp, __restore;
+ ;(([__temp,__restore]=__executeAsync(()=>Promise.resolve())),await __temp,__restore());
+ }
+ })
+ export default defineNuxtComponent({
+ async setup () {let __temp, __restore;
+ ;(([__temp,__restore]=__executeAsync(()=>Promise.resolve())),await __temp,__restore());
+ }
+ })"
+ `)
+ })
+})
+
+function transform (code: string, id = 'app.vue') {
+ const transformerOptions = {
+ helperModule: 'unctx',
+ asyncFunctions: ['defineNuxtPlugin', 'defineNuxtRouteMiddleware'],
+ objectDefinitions: {
+ defineNuxtComponent: ['asyncData', 'setup'],
+ defineNuxtPlugin: ['setup'],
+ definePageMeta: ['middleware', 'validate'],
+ },
+ }
+ const plugin = UnctxTransformPlugin({ sourcemap: false, transformerOptions }).raw({}, {} as any) as any
+ return plugin.transformInclude(id) ? Promise.resolve(plugin.transform.handler(code)).then((r: any) => r?.code.replace(/^ {6}/gm, '').trim()) : null
+}
diff --git a/packages/nuxt/test/unhead-imports.test.ts b/packages/nuxt/test/unhead-imports.test.ts
new file mode 100644
index 000000000000..3f65c3396b6a
--- /dev/null
+++ b/packages/nuxt/test/unhead-imports.test.ts
@@ -0,0 +1,220 @@
+// @vitest-environment node
+import process from 'node:process'
+import { describe, expect, it } from 'vitest'
+import { compileScript, parse } from '@vue/compiler-sfc'
+import { UnheadImportsPlugin } from '../src/head/plugins/unhead-imports.ts'
+
+describe('UnheadImportsPlugin', () => {
+ // Helper function to transform code
+ function transform (code: string, id = 'app.vue') {
+ const plugin = UnheadImportsPlugin({ rootDir: import.meta.dirname }).raw({}, {} as any) as any
+ return plugin.transformInclude(id) ? Promise.resolve(plugin.transform.handler(code, id)).then((r: any) => r?.code.replace(/^ {6}/gm, '').trim()) : null
+ }
+
+ describe('transformInclude', () => {
+ // @ts-expect-error untyped
+ const transformInclude = UnheadImportsPlugin({ rootDir: process.cwd() }).raw({}, {} as any).transformInclude
+
+ it('should include JS files', () => {
+ expect(transformInclude('/project/components/MyComponent.js')).toBe(true)
+ })
+
+ it('should include TypeScript files', () => {
+ expect(transformInclude('/project/components/MyComponent.ts')).toBe(true)
+ })
+
+ it('should include Vue files', () => {
+ expect(transformInclude('/project/components/MyComponent.vue')).toBe(true)
+ })
+
+ it('should exclude virtual files', () => {
+ expect(transformInclude('virtual:my-plugin')).toBe(false)
+ })
+
+ it('should exclude files from unhead libraries', () => {
+ expect(transformInclude('/project/node_modules/@unhead/vue/index.js')).toBe(false)
+ expect(transformInclude('/project/node_modules/unhead/index.js')).toBe(false)
+ })
+
+ it('should exclude nuxt head runtime composables', () => {
+ // Unix paths
+ expect(transformInclude('/project/node_modules/nuxt/dist/head/runtime/composables.js')).toBe(false)
+ expect(transformInclude('/project/node_modules/nuxt/dist/head/runtime/index.js')).toBe(false)
+ // Windows paths
+ expect(transformInclude('C:\\project\\node_modules\\nuxt\\dist\\head\\runtime\\composables.js')).toBe(false)
+ // Should NOT exclude - different paths
+ expect(transformInclude('/project/node_modules/nuxt/dist/head/plugin.js')).toBe(true)
+ expect(transformInclude('/project/node_modules/nuxt/dist/app/composables.js')).toBe(true)
+ })
+ })
+
+ describe('transform', () => {
+ it('should not transform code that does not include @unhead/vue', async () => {
+ const code = `import { renderSSRHead } from '@unhead/ssr'`
+ const result = await transform(code, '/project/components/MyComponent.vue')
+ expect(result).toBeUndefined()
+ })
+
+ it('should transform imports from @unhead/vue in .vue files', async () => {
+ const sfc = `
+<script lang="ts" setup>
+import { useHead } from '@unhead/vue'
+useHead({ title: 'My Page' })
+</script>
+`
+ const res = compileScript(parse(sfc).descriptor, { id: 'component.vue' })
+
+ const result = await transform(res.content, '/project/components/MyComponent.vue')
+
+ expect(result).toBeDefined()
+ expect(result).toContain('import { useHead } from "#app/composables/head"')
+ expect(result).not.toContain('import { useHead } from "@unhead/vue"')
+ })
+
+ it('should transform imports from @unhead/vue in JS files', async () => {
+ const code = `import { useHead } from '@unhead/vue'`
+ const result = await transform(code, '/project/composables/head.ts')
+
+ expect(result).toBeDefined()
+ expect(result).toContain('import { useHead } from "#app/composables/head"')
+ expect(result).not.toContain('import { useHead } from "@unhead/vue"')
+ })
+
+ it('should handle mixed imports correctly', async () => {
+ const code = `
+import { useHead } from '@unhead/vue'
+import { useSeoMeta } from '#app/composables/head'
+ `
+ const result = await transform(code, '/project/components/MyComponent.vue')
+
+ expect(result).toBeDefined()
+ expect(result).toContain('import { useHead, useSeoMeta } from "#app/composables/head"')
+ // Since we're not mocking the AST parsing, we need to rely on the actual behavior
+ // of the plugin for handling imports from #app/composables/head
+ })
+
+ it('should handle renamed imports correctly', async () => {
+ const code = `import { useHead as useHeadAlias } from '@unhead/vue'`
+ const result = await transform(code, '/project/components/MyComponent.vue')
+
+ expect(result).toBeDefined()
+ expect(result).toContain('import { useHead as useHeadAlias } from "#app/composables/head"')
+ expect(result).not.toContain('import { useHead as useHeadAlias } from "@unhead/vue"')
+ })
+
+ it('should handle multiple imports correctly', async () => {
+ const code = `import { useHead, useSeoMeta } from '@unhead/vue'`
+ const result = await transform(code, '/project/components/MyComponent.vue')
+
+ expect(result).toBeDefined()
+ expect(result).toContain('import { useHead, useSeoMeta } from "#app/composables/head"')
+ expect(result).not.toContain('import { useHead, useSeoMeta } from "@unhead/vue"')
+ })
+ })
+
+ describe('Integration tests', () => {
+ it('should handle a Vue component correctly', async () => {
+ const sfc = `
+<template>
+ <div>
+ <h1>{{ title }}</h1>
+ </div>
+</template>
+
+<script setup lang="ts">
+import { ref } from 'vue'
+import { useHead } from '@unhead/vue'
+
+const title = ref('Hello World')
+
+useHead({
+ title: 'My Page'
+})
+</script>
+ `
+ const res = compileScript(parse(sfc).descriptor, { id: 'component.vue' })
+
+ const result = await transform(res.content, '/project/components/MyComponent.vue')
+
+ expect(result).toBeDefined()
+ expect(result).toContain('import { useHead } from "#app/composables/head"')
+ expect(result).not.toContain('import { useHead } from "@unhead/vue"')
+ })
+
+ it('should handle a Nuxt plugin correctly', async () => {
+ const code = `
+import { useHead } from '@unhead/vue'
+
+export default defineNuxtPlugin((nuxtApp) => {
+ useHead({
+ titleTemplate: '%s - My Site'
+ })
+})
+ `
+
+ const result = await transform(code, '/project/plugins/head.ts')
+
+ expect(result).toBeDefined()
+ expect(result).toContain('import { useHead } from "#app/composables/head"')
+ expect(result).not.toContain('import { useHead } from "@unhead/vue"')
+ })
+
+ it('should handle TypeScript file in a nested directory correctly', async () => {
+ const code = `
+import { useHead } from '@unhead/vue'
+
+export function setupHead() {
+ useHead({
+ meta: [
+ { name: 'description', content: 'My website description' }
+ ]
+ })
+}
+ `
+
+ const result = await transform(code, '/project/utils/head/setup.ts')
+
+ expect(result).toBeDefined()
+ expect(result).toContain('import { useHead } from "#app/composables/head"')
+ expect(result).not.toContain('import { useHead } from "@unhead/vue"')
+ })
+
+ it('should handle multiple imports from different sources', async () => {
+ const code = `
+import { useHead, useSeoMeta } from '@unhead/vue'
+import { ref, computed } from 'vue'
+import { useRouter } from 'vue-router'
+ `
+
+ const result = await transform(code, '/project/pages/index.vue')
+
+ expect(result).toBeDefined()
+ expect(result).toContain('import { useHead, useSeoMeta } from "#app/composables/head"')
+ expect(result).not.toContain('@unhead/vue')
+ })
+
+ it('should handle imports across multiple lines', async () => {
+ const code = `
+import {
+ useHead,
+ useSeoMeta
+} from '@unhead/vue'
+ `
+
+ const result = await transform(code, '/project/components/Header.vue')
+
+ expect(result).toBeDefined()
+ // The actual behavior will depend on how the AST parser handles multi-line imports
+ // This test will verify the behavior is consistent
+ })
+
+ it('should handle different quote styles in imports', async () => {
+ const code = `import { useHead } from "@unhead/vue"`
+ const result = await transform(code, '/project/components/MyComponent.vue')
+
+ expect(result).toBeDefined()
+ expect(result).toContain('import { useHead } from "#app/composables/head"')
+ expect(result).not.toContain('import { useHead } from "@unhead/vue"')
+ })
+ })
+})
diff --git a/packages/nuxt/test/utils.test.ts b/packages/nuxt/test/utils.test.ts
new file mode 100644
index 000000000000..fa24a6a59d9a
--- /dev/null
+++ b/packages/nuxt/test/utils.test.ts
@@ -0,0 +1,37 @@
+import { mkdtempSync, rmSync, writeFileSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+import { afterAll, beforeAll, describe, expect, it } from 'vitest'
+
+import { isDirectorySync } from '../src/utils.ts'
+
+describe('isDirectorySync', () => {
+ let dir: string
+ let file: string
+
+ beforeAll(() => {
+ dir = mkdtempSync(join(tmpdir(), 'nuxt-isdir'))
+ file = join(dir, 'testfile.txt')
+ writeFileSync(file, '')
+ })
+
+ afterAll(() => {
+ rmSync(dir, { recursive: true, force: true })
+ })
+
+ it('returns true for an existing directory', () => {
+ expect(isDirectorySync(dir)).toBe(true)
+ })
+
+ it('returns false for an existing file', () => {
+ expect(isDirectorySync(file)).toBe(false)
+ })
+
+ it('returns false for a non-existent path (ENOENT)', () => {
+ expect(isDirectorySync(join(dir, 'nope'))).toBe(false)
+ })
+
+ it('returns false when a path segment is a file, not a directory (ENOTDIR)', () => {
+ expect(isDirectorySync(join(file, 'child'))).toBe(false)
+ })
+})
diff --git a/packages/nuxt/test/utils.ts b/packages/nuxt/test/utils.ts
new file mode 100644
index 000000000000..e8aa656ed997
--- /dev/null
+++ b/packages/nuxt/test/utils.ts
@@ -0,0 +1,18 @@
+import { fileURLToPath } from 'node:url'
+
+export const componentsFixtureDir = fileURLToPath(new URL('components-fixture', import.meta.url))
+
+export function normalizeLineEndings (str: string, normalized = '\n') {
+ return str.replace(/\r?\n/g, normalized)
+}
+
+export function clean (string?: string) {
+ const lines = string?.split('\n').filter(l => l.trim()) || []
+ const indent = lines.reduce((prev, curr) => {
+ const length = curr.match(/^\s+/)?.[0].length ?? 0
+ return length < prev ? length : prev
+ }, Infinity)
+
+ const re = new RegExp(`^\\s{${indent}}`)
+ return lines.map(l => l.replace(re, '')).join('\n')
+}
diff --git a/packages/nuxt/test/virtual.test.ts b/packages/nuxt/test/virtual.test.ts
new file mode 100644
index 000000000000..1af74f545b42
--- /dev/null
+++ b/packages/nuxt/test/virtual.test.ts
@@ -0,0 +1,89 @@
+import { describe, expect, it } from 'vitest'
+import type { Nuxt } from '@nuxt/schema'
+import { rolldown } from 'rolldown'
+
+import { VirtualFSPlugin } from '../src/core/plugins/virtual.ts'
+
+describe('virtual fs plugin', () => {
+ it('should support loading files virtually', async () => {
+ const code = await generateCode('export { foo } from "#build/foo"', {
+ vfs: {
+ '/.nuxt/foo': 'export const foo = "hello world"',
+ },
+ })
+ expect(code).toMatchInlineSnapshot(`
+ "//#region virtual:nuxt:%2F.nuxt%2Ffoo
+ const foo = "hello world";
+ //#endregion
+ export { foo };"
+ `)
+ })
+
+ it('should support loading virtual files by suffix', async () => {
+ const code = await generateCode('export { foo } from "#build/foo"', {
+ mode: 'client',
+ vfs: {
+ '/.nuxt/foo.server.ts': 'export const foo = "foo server file"',
+ '/.nuxt/foo.client.ts': 'export const foo = "foo client file"',
+ },
+ })
+ expect(code).toMatchInlineSnapshot(`
+ "//#region virtual:nuxt:%2F.nuxt%2Ffoo.client.ts
+ const foo = "foo client file";
+ //#endregion
+ export { foo };"
+ `)
+ })
+
+ it('should support loading files referenced relatively', async () => {
+ const code = await generateCode('export { foo } from "#build/foo"', {
+ vfs: {
+ '/.nuxt/foo': 'export { foo } from "./bar"',
+ '/.nuxt/bar': 'export const foo = "relative import"',
+ },
+ })
+ expect(code).toMatchInlineSnapshot(`
+ "//#region virtual:nuxt:%2F.nuxt%2Fbar
+ const foo = "relative import";
+ //#endregion
+ export { foo };"
+ `)
+ })
+})
+
+async function generateCode (input: string, options: { mode?: 'client' | 'server', vfs: Record<string, string> }) {
+ const stubNuxt = {
+ options: {
+ extensions: ['.ts', '.js'],
+ buildDir: '/.nuxt',
+ alias: {
+ '~': '/',
+ '#build': '/.nuxt',
+ },
+ },
+ vfs: options.vfs,
+ } as unknown as Nuxt
+
+ const bundle = await rolldown({
+ input: 'entry.ts',
+ plugins: [
+ {
+ name: 'entry',
+ resolveId (id) {
+ if (id === 'entry.ts') {
+ return id
+ }
+ },
+ load (id) {
+ if (id === 'entry.ts') {
+ return input
+ }
+ },
+ },
+ VirtualFSPlugin(stubNuxt, { mode: options.mode || 'client', alias: stubNuxt.options.alias }).rolldown(),
+ ],
+ })
+ const { output: [chunk] } = await bundle.generate({})
+ // Rolldown may wrap output in an IIFE or add runtime code; extract the meaningful part
+ return chunk.code.trim()
+}
diff --git a/packages/nuxt/types.d.mts b/packages/nuxt/types.d.mts
new file mode 100644
index 000000000000..7e16edfa6572
--- /dev/null
+++ b/packages/nuxt/types.d.mts
@@ -0,0 +1,14 @@
+import type { SchemaDefinition } from 'nuxt/schema'
+import type { DefineNuxtConfig } from 'nuxt/config'
+
+export * from './dist/index.js'
+
+declare global {
+ const defineNuxtConfig: DefineNuxtConfig
+ const defineNuxtSchema: (schema: SchemaDefinition) => SchemaDefinition
+
+ interface ImportMeta {
+ url: string
+ readonly env: ImportMetaEnv
+ }
+}
diff --git a/packages/nuxt/types.d.ts b/packages/nuxt/types.d.ts
new file mode 100644
index 000000000000..b74d4b17d0d8
--- /dev/null
+++ b/packages/nuxt/types.d.ts
@@ -0,0 +1,14 @@
+import type { SchemaDefinition } from 'nuxt/schema'
+import type { DefineNuxtConfig } from 'nuxt/config'
+
+export * from './dist/index.ts'
+
+declare global {
+ const defineNuxtConfig: DefineNuxtConfig
+ const defineNuxtSchema: (schema: SchemaDefinition) => SchemaDefinition
+
+ interface ImportMeta {
+ url: string
+ readonly env: ImportMetaEnv
+ }
+}
diff --git a/packages/rspack/.attw.json b/packages/rspack/.attw.json
new file mode 100644
index 000000000000..ac2579855eb0
--- /dev/null
+++ b/packages/rspack/.attw.json
@@ -0,0 +1,3 @@
+{
+ "ignoreRules": ["cjs-resolves-to-esm"]
+}
diff --git a/packages/rspack/build.config.ts b/packages/rspack/build.config.ts
new file mode 100644
index 000000000000..1fddeb03de7a
--- /dev/null
+++ b/packages/rspack/build.config.ts
@@ -0,0 +1,22 @@
+import { defineBuildConfig } from 'obuild/config'
+
+export default defineBuildConfig({
+ entries: [
+ {
+ type: 'bundle',
+ input: 'src/index',
+ dts: { oxc: true },
+ rolldown: {
+ external: [
+ '@nuxt/schema',
+ '#builder',
+ ],
+ },
+ },
+ {
+ type: 'bundle',
+ input: 'src/loaders/vue-module-identifier',
+ dts: false,
+ },
+ ],
+})
diff --git a/packages/rspack/builder.mjs b/packages/rspack/builder.mjs
new file mode 100644
index 000000000000..5e3a647f4e1b
--- /dev/null
+++ b/packages/rspack/builder.mjs
@@ -0,0 +1,9 @@
+import webpack from '@rspack/core'
+
+export { default as WebpackBarPlugin } from 'webpackbar/rspack'
+
+export const builder = 'rspack'
+export { webpack }
+export const MiniCssExtractPlugin = webpack.CssExtractRspackPlugin
+
+export { TsCheckerRspackPlugin as TsCheckerPlugin } from 'ts-checker-rspack-plugin'
diff --git a/packages/rspack/package.json b/packages/rspack/package.json
new file mode 100644
index 000000000000..9523862b08b6
--- /dev/null
+++ b/packages/rspack/package.json
@@ -0,0 +1,91 @@
+{
+ "name": "@nuxt/rspack-builder",
+ "version": "4.3.1",
+ "repository": {
+ "type": "git",
+ "url": "git+https://github.com/nuxt/nuxt.git",
+ "directory": "packages/rspack"
+ },
+ "description": "rspack bundler for Nuxt",
+ "homepage": "https://nuxt.com",
+ "license": "MIT",
+ "type": "module",
+ "types": "./dist/index.d.mts",
+ "imports": {
+ "#builder": "./builder.mjs",
+ "#vue-module-identifier": "./dist/loaders/vue-module-identifier.mjs"
+ },
+ "exports": {
+ ".": "./dist/index.mjs",
+ "./dist/*": "./dist/*"
+ },
+ "files": [
+ "dist",
+ "builder.mjs"
+ ],
+ "scripts": {
+ "prepack": "obuild",
+ "build:stub": "obuild --stub",
+ "test:attw": "attw --pack"
+ },
+ "dependencies": {
+ "@nuxt/friendly-errors-webpack-plugin": "^2.6.0",
+ "@nuxt/kit": "workspace:*",
+ "@rspack/core": "^2.0.3",
+ "@vue/compiler-sfc": "3.5.34",
+ "autoprefixer": "^10.5.0",
+ "css-loader": "^7.1.4",
+ "css-minimizer-webpack-plugin": "^8.0.0",
+ "cssnano": "^8.0.1",
+ "defu": "^6.1.7",
+ "esbuild-loader": "^4.4.3",
+ "escape-string-regexp": "^5.0.0",
+ "exsolve": "^1.0.8",
+ "file-loader": "^6.2.0",
+ "jiti": "^2.7.0",
+ "knitwork": "^1.3.0",
+ "memfs": "^4.57.2",
+ "mlly": "^1.8.2",
+ "ohash": "^2.0.11",
+ "pathe": "^2.0.3",
+ "pify": "^6.1.0",
+ "postcss": "^8.5.14",
+ "postcss-import": "^16.1.1",
+ "postcss-import-resolver": "^2.0.0",
+ "postcss-loader": "^8.2.1",
+ "postcss-url": "^10.1.3",
+ "pug-plain-loader": "^1.1.0",
+ "rolldown-string": "^0.3.0",
+ "seroval": "^1.5.4",
+ "time-fix-plugin": "^2.0.7",
+ "tinyglobby": "^0.2.16",
+ "ts-checker-rspack-plugin": "^1.3.0",
+ "ufo": "^1.6.4",
+ "unenv": "^2.0.0-rc.24",
+ "unplugin": "^3.0.0",
+ "url-loader": "^4.1.1",
+ "vue-bundle-renderer": "^2.2.0",
+ "vue-loader": "^17.4.2",
+ "webpack-bundle-analyzer": "^5.3.0",
+ "webpack-dev-middleware": "^8.0.3",
+ "webpack-hot-middleware": "^2.26.1",
+ "webpackbar": "^7.0.0"
+ },
+ "devDependencies": {
+ "@nuxt/schema": "workspace:*",
+ "@types/webpack-bundle-analyzer": "4.7.0",
+ "@types/webpack-hot-middleware": "2.25.12",
+ "h3": "1.15.11",
+ "h3-next": "npm:h3@2.0.1-rc.22",
+ "obuild": "0.4.36",
+ "rollup": "4.60.4",
+ "vue": "3.5.34"
+ },
+ "peerDependencies": {
+ "nuxt": "workspace:*",
+ "vue": "^3.3.4"
+ },
+ "engines": {
+ "node": "^22.12.0 || ^24.11.0 || >=26.0.0"
+ }
+}
diff --git a/packages/rspack/src/index.ts b/packages/rspack/src/index.ts
new file mode 100644
index 000000000000..bf21d3def952
--- /dev/null
+++ b/packages/rspack/src/index.ts
@@ -0,0 +1 @@
+export * from '../../webpack/src/index.ts'
diff --git a/packages/rspack/src/loaders/vue-module-identifier.ts b/packages/rspack/src/loaders/vue-module-identifier.ts
new file mode 100644
index 000000000000..30098ce6e7d6
--- /dev/null
+++ b/packages/rspack/src/loaders/vue-module-identifier.ts
@@ -0,0 +1 @@
+export { default } from '../../../webpack/src/loaders/vue-module-identifier.ts'
diff --git a/packages/schema/.attw.json b/packages/schema/.attw.json
new file mode 100644
index 000000000000..7aa79ea413cf
--- /dev/null
+++ b/packages/schema/.attw.json
@@ -0,0 +1,5 @@
+{
+ "ignoreRules": [
+ "cjs-resolves-to-esm"
+ ]
+}
diff --git a/packages/schema/.gitignore b/packages/schema/.gitignore
new file mode 100644
index 000000000000..c4d83b97fd45
--- /dev/null
+++ b/packages/schema/.gitignore
@@ -0,0 +1 @@
+/schema
diff --git a/packages/schema/build.config.ts b/packages/schema/build.config.ts
new file mode 100644
index 000000000000..8e691dfb8cc5
--- /dev/null
+++ b/packages/schema/build.config.ts
@@ -0,0 +1,57 @@
+import { defineBuildConfig } from 'obuild/config'
+
+export default defineBuildConfig({
+ entries: [
+ {
+ type: 'bundle',
+ input: ['src/index', 'src/builder-env'],
+ dts: { oxc: true },
+ rolldown: {
+ external: [
+ // Type imports
+ '@unhead/vue/types',
+ '@unhead/vue/vite',
+ '@vitejs/plugin-vue',
+ '@vitejs/plugin-vue-jsx',
+ '@vue/compiler-core',
+ '@vue/compiler-sfc',
+ '@vue/language-core',
+ 'c12',
+ 'chokidar',
+ 'compatx',
+ 'css-minimizer-webpack-plugin',
+ 'esbuild',
+ 'esbuild-loader',
+ 'file-loader',
+ 'h3',
+ 'hookable',
+ 'ignore',
+ 'mini-css-extract-plugin',
+ 'nuxt/app',
+ 'ofetch',
+ 'oxc-transform',
+ 'postcss',
+ 'pug',
+ 'rollup-plugin-visualizer',
+ 'sass-loader',
+ 'scule',
+ 'unctx/transform',
+ 'unimport',
+ 'untyped',
+ 'vite',
+ 'vue',
+ 'vue-bundle-renderer',
+ 'vue-loader',
+ 'vue-router',
+ 'webpack',
+ 'webpack-bundle-analyzer',
+ 'webpack-dev-middleware',
+ 'webpack-hot-middleware',
+ // Implicit
+ 'autoprefixer',
+ 'cssnano',
+ ],
+ },
+ },
+ ],
+})
diff --git a/packages/schema/builder-env.d.ts b/packages/schema/builder-env.d.ts
new file mode 100644
index 000000000000..a06c65f969f6
--- /dev/null
+++ b/packages/schema/builder-env.d.ts
@@ -0,0 +1 @@
+export * from './dist/builder-env.mts'
diff --git a/packages/schema/package.json b/packages/schema/package.json
new file mode 100644
index 000000000000..104131620e70
--- /dev/null
+++ b/packages/schema/package.json
@@ -0,0 +1,83 @@
+{
+ "name": "@nuxt/schema",
+ "version": "4.3.1",
+ "repository": {
+ "type": "git",
+ "url": "git+https://github.com/nuxt/nuxt.git",
+ "directory": "packages/schema"
+ },
+ "description": "Nuxt types and default configuration",
+ "homepage": "https://nuxt.com",
+ "license": "MIT",
+ "type": "module",
+ "types": "./dist/index.d.mts",
+ "sideEffects": false,
+ "exports": {
+ ".": "./dist/index.mjs",
+ "./builder-env": "./dist/builder-env.mjs",
+ "./package.json": "./package.json"
+ },
+ "files": [
+ "dist",
+ "schema",
+ "builder-env.d.ts",
+ "env.d.ts"
+ ],
+ "scripts": {
+ "prepack": "obuild",
+ "build:stub": "obuild --stub",
+ "test:attw": "attw --pack"
+ },
+ "dependencies": {
+ "@vue/shared": "^3.5.34",
+ "defu": "^6.1.7",
+ "pathe": "^2.0.3",
+ "pkg-types": "^2.3.1",
+ "std-env": "^4.1.0"
+ },
+ "devDependencies": {
+ "@types/pug": "2.0.10",
+ "@types/webpack-bundle-analyzer": "4.7.0",
+ "@types/webpack-hot-middleware": "2.25.12",
+ "@unhead/vue": "3.1.0",
+ "@vitejs/plugin-vue": "6.0.7",
+ "@vitejs/plugin-vue-jsx": "5.1.5",
+ "@vue/compiler-core": "3.5.34",
+ "@vue/compiler-sfc": "3.5.34",
+ "@vue/language-core": "3.2.9",
+ "autoprefixer": "10.5.0",
+ "c12": "3.3.4",
+ "chokidar": "5.0.0",
+ "compatx": "0.2.0",
+ "css-minimizer-webpack-plugin": "8.0.0",
+ "cssnano": "8.0.1",
+ "esbuild": "0.28.0",
+ "esbuild-loader": "4.4.3",
+ "file-loader": "6.2.0",
+ "h3": "2.0.1-rc.22",
+ "hookable": "6.1.1",
+ "ignore": "7.0.5",
+ "mini-css-extract-plugin": "2.10.2",
+ "nitro": "3.0.260311-beta",
+ "obuild": "0.4.36",
+ "ofetch": "2.0.0-alpha.3",
+ "oxc-transform": "0.131.0",
+ "postcss": "8.5.14",
+ "rollup-plugin-visualizer": "7.0.1",
+ "sass-loader": "17.0.0",
+ "scule": "1.3.0",
+ "unctx": "2.5.0",
+ "unimport": "6.3.0",
+ "untyped": "2.0.0",
+ "vite": "8.0.12",
+ "vue": "3.5.34",
+ "vue-bundle-renderer": "2.2.0",
+ "vue-loader": "17.4.2",
+ "vue-router": "5.0.7",
+ "webpack": "5.106.2",
+ "webpack-dev-middleware": "8.0.3"
+ },
+ "engines": {
+ "node": "^14.18.0 || >=16.10.0"
+ }
+}
diff --git a/packages/schema/src/builder-env.ts b/packages/schema/src/builder-env.ts
new file mode 100644
index 000000000000..4058e959b0c7
--- /dev/null
+++ b/packages/schema/src/builder-env.ts
@@ -0,0 +1,12 @@
+import type { BundlerImportMeta } from './types/builder-env/index.ts'
+
+declare global {
+ interface ImportMeta extends BundlerImportMeta {
+ /** the `file:` url of the current file (similar to `__filename` but as file url) */
+ url: string
+
+ readonly env: Record<string, string | boolean | undefined>
+ }
+}
+
+export const builders = ['vite', 'webpack'] as const
diff --git a/packages/schema/src/config/adhoc.ts b/packages/schema/src/config/adhoc.ts
new file mode 100644
index 000000000000..eb60847f5cb2
--- /dev/null
+++ b/packages/schema/src/config/adhoc.ts
@@ -0,0 +1,30 @@
+import { defineResolvers } from '../utils/definition.ts'
+
+export default defineResolvers({
+ components: {
+ $resolve: (val) => {
+ if (Array.isArray(val)) {
+ return { dirs: val }
+ }
+ if (val === false) {
+ return { dirs: [] }
+ }
+ return {
+ dirs: [{ path: '~/components/global', global: true }, '~/components'],
+ ...typeof val === 'object' ? val : {},
+ }
+ },
+ },
+
+ imports: {
+ global: false,
+ scan: true,
+ dirs: [],
+ },
+
+ pages: undefined,
+
+ telemetry: undefined,
+
+ devtools: {},
+})
diff --git a/packages/schema/src/config/app.ts b/packages/schema/src/config/app.ts
new file mode 100644
index 000000000000..eeb087ee5cf4
--- /dev/null
+++ b/packages/schema/src/config/app.ts
@@ -0,0 +1,196 @@
+import process from 'node:process'
+import { defu } from 'defu'
+import { resolve } from 'pathe'
+import { defineResolvers } from '../utils/definition.ts'
+import type { AppHeadMetaObject } from '../types/head.ts'
+import type { NuxtAppConfig, ViewTransitionOptions } from '../types/config.ts'
+
+export default defineResolvers({
+ vue: {
+ transformAssetUrls: {
+ video: ['src', 'poster'],
+ source: ['src'],
+ img: ['src'],
+ image: ['xlink:href', 'href'],
+ use: ['xlink:href', 'href'],
+ },
+ compilerOptions: {},
+ runtimeCompiler: {
+ $resolve: (val) => {
+ return typeof val === 'boolean' ? val : false
+ },
+ },
+ propsDestructure: true,
+
+ config: {},
+ },
+ app: {
+ baseURL: {
+ $resolve: (val) => {
+ if (typeof val === 'string') {
+ return val
+ }
+ return process.env.NUXT_APP_BASE_URL || '/'
+ },
+ },
+ buildAssetsDir: {
+ $resolve: (val) => {
+ if (typeof val === 'string') {
+ return val
+ }
+ return process.env.NUXT_APP_BUILD_ASSETS_DIR || '/_nuxt/'
+ },
+ },
+
+ cdnURL: {
+ $resolve: async (val, get) => {
+ if (await get('dev')) {
+ return ''
+ }
+ return process.env.NUXT_APP_CDN_URL || (typeof val === 'string' ? val : '')
+ },
+ },
+
+ head: {
+ $resolve: (_val) => {
+ const val: Partial<NuxtAppConfig['head']> = _val && typeof _val === 'object' ? _val : {}
+
+ type NormalizedMetaObject = Required<Pick<AppHeadMetaObject, 'meta' | 'link' | 'style' | 'script' | 'noscript'>>
+
+ const resolved: NuxtAppConfig['head'] & NormalizedMetaObject = defu(val, {
+ meta: [],
+ link: [],
+ style: [],
+ script: [],
+ noscript: [],
+ } satisfies NormalizedMetaObject)
+
+ // provides default charset and viewport if not set
+ if (!resolved.meta.find(m => m?.charset)?.charset) {
+ resolved.meta.unshift({ charset: resolved.charset || 'utf-8' })
+ }
+ if (!resolved.meta.find(m => m?.name === 'viewport')?.content) {
+ resolved.meta.unshift({ name: 'viewport', content: resolved.viewport || 'width=device-width, initial-scale=1' })
+ }
+
+ resolved.meta = resolved.meta.filter(Boolean)
+ resolved.link = resolved.link.filter(Boolean)
+ resolved.style = resolved.style.filter(Boolean)
+ resolved.script = resolved.script.filter(Boolean)
+ resolved.noscript = resolved.noscript.filter(Boolean)
+
+ return resolved
+ },
+ },
+ layoutTransition: false,
+ pageTransition: false,
+ viewTransition: {
+ $resolve: async (val, get) => {
+ const isEnabled = (val === 'always' || typeof val === 'boolean')
+ const hasEnabled = val && typeof val === 'object' && 'enabled' in val
+ const hasTypes = val && typeof val === 'object' && 'types' in val
+
+ const appOptions: Partial<ViewTransitionOptions> = {
+ enabled: isEnabled ? val : (hasEnabled ? val.enabled as ViewTransitionOptions['enabled'] : undefined),
+ types: hasTypes ? val.types as ViewTransitionOptions['types'] : undefined,
+ }
+
+ if (appOptions.enabled !== undefined && appOptions.types !== undefined) {
+ return appOptions as ViewTransitionOptions
+ }
+
+ const _configOptions = await get('experimental').then(e => e.viewTransition) ?? { enabled: false }
+ const configOptions = typeof _configOptions === 'object' ? _configOptions : { enabled: _configOptions }
+
+ return {
+ enabled: appOptions.enabled ?? configOptions.enabled,
+ types: appOptions.types ?? configOptions.types,
+ }
+ },
+ },
+ keepalive: false,
+ rootId: {
+ $resolve: val => val === false ? false : (val && typeof val === 'string' ? val : '__nuxt'),
+ },
+ rootTag: {
+ $resolve: val => val && typeof val === 'string' ? val : 'div',
+ },
+ rootAttrs: {
+ $resolve: async (val, get) => {
+ const rootId = await get('app.rootId')
+ return {
+ id: rootId === false ? undefined : (rootId || '__nuxt'),
+ ...typeof val === 'object' ? val : {},
+ }
+ },
+ },
+ teleportTag: {
+ $resolve: val => val && typeof val === 'string' ? val : 'div',
+ },
+ teleportId: {
+ $resolve: val => val === false ? false : (val && typeof val === 'string' ? val : 'teleports'),
+ },
+ teleportAttrs: {
+ $resolve: async (val, get) => {
+ const teleportId = await get('app.teleportId')
+ return {
+ id: teleportId === false ? undefined : (teleportId || 'teleports'),
+ ...typeof val === 'object' ? val : {},
+ }
+ },
+ },
+ spaLoaderTag: {
+ $resolve: val => val && typeof val === 'string' ? val : 'div',
+ },
+ spaLoaderAttrs: {
+ id: '__nuxt-loader',
+ },
+ },
+ spaLoadingTemplate: {
+ $resolve: async (val, get) => {
+ if (typeof val === 'string') {
+ return resolve(await get('srcDir'), val)
+ }
+ if (typeof val === 'boolean') {
+ return val
+ }
+ return null
+ },
+ },
+ plugins: [],
+ css: {
+ $resolve: (val) => {
+ if (!Array.isArray(val)) {
+ return []
+ }
+ const css: string[] = []
+ for (const item of val) {
+ if (typeof item === 'string') {
+ css.push(item)
+ }
+ }
+ return css
+ },
+ },
+ unhead: {
+ legacy: {
+ $resolve: async (val, get) => {
+ if (typeof val !== 'boolean') { return false }
+ if ((await get('future.compatibilityVersion') as number) >= 5) {
+ if (val) {
+ console.warn('`unhead.legacy` is ignored when `future.compatibilityVersion` >= 5. Remove deprecated head patterns (`hid`, `vmid`, `children`, `body: true`, `renderPriority`) and resolve promise values before passing to `useHead`.')
+ }
+ return false
+ }
+ return val
+ },
+ },
+ vite: {},
+ renderSSRHeadOptions: {
+ $resolve: (val: unknown) => ({
+ omitLineBreaks: true,
+ ...typeof val === 'object' ? val : {},
+ }),
+ },
+ },
+})
diff --git a/packages/schema/src/config/build.ts b/packages/schema/src/config/build.ts
new file mode 100644
index 000000000000..4eaa1364f71c
--- /dev/null
+++ b/packages/schema/src/config/build.ts
@@ -0,0 +1,136 @@
+import { defu } from 'defu'
+import { join } from 'pathe'
+import type { Nuxt } from '../types/nuxt.ts'
+import { defineResolvers } from '../utils/definition.ts'
+
+export default defineResolvers({
+ builder: {
+ $resolve: (val) => {
+ if (val && typeof val === 'object' && 'bundle' in val) {
+ return val as { bundle: (nuxt: Nuxt) => Promise<void> }
+ }
+ const map = {
+ rspack: '@nuxt/rspack-builder',
+ vite: '@nuxt/vite-builder',
+ webpack: '@nuxt/webpack-builder',
+ }
+ type Builder = 'vite' | 'webpack' | 'rspack'
+ if (typeof val === 'string' && val in map) {
+ // TODO: improve normalisation inference
+ return map[val as keyof typeof map] as Builder
+ }
+ return map.vite as Builder
+ },
+ },
+ sourcemap: {
+ $resolve: async (val, get) => {
+ if (typeof val === 'boolean') {
+ return { server: val, client: val }
+ }
+ return {
+ server: true,
+ client: await get('dev'),
+ ...typeof val === 'object' ? val : {},
+ }
+ },
+ },
+ logLevel: {
+ $resolve: async (val, get) => {
+ if (val && typeof val === 'string' && !['silent', 'info', 'verbose'].includes(val)) {
+ console.warn(`Invalid \`logLevel\` option: \`${val}\`. Must be one of: \`silent\`, \`info\`, \`verbose\`.`)
+ }
+ return val && typeof val === 'string' ? val as 'silent' | 'info' | 'verbose' : (await get('test') ? 'silent' : 'info')
+ },
+ },
+ build: {
+ transpile: {
+ $resolve: (val) => {
+ const transpile: Array<string | RegExp | ((ctx: { isClient?: boolean, isServer?: boolean, isDev: boolean }) => string | RegExp | false)> = []
+ if (Array.isArray(val)) {
+ for (const pattern of val) {
+ if (!pattern) {
+ continue
+ }
+ if (typeof pattern === 'string' || typeof pattern === 'function' || pattern instanceof RegExp) {
+ transpile.push(pattern)
+ }
+ }
+ }
+ return transpile
+ },
+ },
+ templates: [],
+ analyze: {
+ $resolve: async (val, get) => {
+ const [rootDir, analyzeDir] = await Promise.all([get('rootDir'), get('analyzeDir')])
+ return {
+ template: 'treemap',
+ projectRoot: rootDir,
+ filename: join(analyzeDir, '{name}.html'),
+ ...typeof val === 'boolean' ? { enabled: val } : typeof val === 'object' ? val : {},
+ }
+ },
+ },
+ },
+ optimization: {
+ keyedComposables: {
+ $resolve: val => [
+ { name: 'callOnce', argumentLength: 3, source: '#app/composables/once' },
+ { name: 'defineNuxtComponent', argumentLength: 2, source: '#app/composables/component' },
+ { name: 'useState', argumentLength: 2, source: '#app/composables/state' },
+ { name: 'useFetch', argumentLength: 3, source: '#app/composables/fetch' },
+ { name: 'useAsyncData', argumentLength: 3, source: '#app/composables/asyncData' },
+ { name: 'useLazyAsyncData', argumentLength: 3, source: '#app/composables/asyncData' },
+ { name: 'useLazyFetch', argumentLength: 3, source: '#app/composables/fetch' },
+ ...Array.isArray(val) ? val : [],
+ ].filter(Boolean),
+ },
+ keyedComposableFactories: {
+ $resolve: val => [
+ {
+ name: 'createUseFetch',
+ source: '#app/composables/fetch',
+ argumentLength: 3,
+ },
+ {
+ name: 'createUseAsyncData',
+ source: '#app/composables/asyncData',
+ argumentLength: 3,
+ },
+ ...Array.isArray(val) ? val : [],
+ ].filter(Boolean),
+ },
+ treeShake: {
+ composables: {
+ server: {
+ $resolve: async (val, get) => defu(typeof val === 'object' ? val as Record<string, string[]> || {} : {},
+ await get('dev')
+ ? {}
+ : {
+ 'vue': ['onMounted', 'onUpdated', 'onUnmounted', 'onBeforeMount', 'onBeforeUpdate', 'onBeforeUnmount', 'onRenderTracked', 'onRenderTriggered', 'onActivated', 'onDeactivated'],
+ '#app': ['definePayloadReviver', 'definePageMeta'],
+ },
+ ),
+ },
+ client: {
+ $resolve: async (val, get) => defu(typeof val === 'object' ? val as Record<string, string[]> || {} : {},
+ await get('dev')
+ ? {}
+ : {
+ 'vue': ['onRenderTracked', 'onRenderTriggered', 'onServerPrefetch'],
+ '#app': ['definePayloadReducer', 'definePageMeta', 'onPrehydrate'],
+ },
+ ),
+ },
+ },
+ },
+ asyncTransforms: {
+ asyncFunctions: ['defineNuxtPlugin', 'defineNuxtRouteMiddleware'],
+ objectDefinitions: {
+ defineNuxtComponent: ['asyncData', 'setup'],
+ defineNuxtPlugin: ['setup'],
+ definePageMeta: ['middleware', 'validate'],
+ },
+ },
+ },
+})
diff --git a/packages/schema/src/config/common.ts b/packages/schema/src/config/common.ts
new file mode 100644
index 000000000000..fdc9bcc66404
--- /dev/null
+++ b/packages/schema/src/config/common.ts
@@ -0,0 +1,325 @@
+import process from 'node:process'
+import { existsSync } from 'node:fs'
+import { readdir } from 'node:fs/promises'
+import { randomUUID } from 'node:crypto'
+import { relative, resolve } from 'pathe'
+import { isDebug, isDevelopment, isTest } from 'std-env'
+import { defu } from 'defu'
+import { findWorkspaceDir } from 'pkg-types'
+
+import type { NuxtDebugOptions } from '../types/debug.ts'
+import type { NuxtModule } from '../types/module.ts'
+import { defineResolvers } from '../utils/definition.ts'
+
+export default defineResolvers({
+ extends: undefined,
+ compatibilityDate: undefined,
+ theme: undefined,
+ rootDir: {
+ $resolve: val => typeof val === 'string' ? resolve(val) : process.cwd(),
+ },
+ workspaceDir: {
+ $resolve: async (val, get) => {
+ const rootDir = await get('rootDir')
+ return val && typeof val === 'string'
+ ? resolve(rootDir, val)
+ : findWorkspaceDir(rootDir, {
+ gitConfig: 'closest',
+ try: true,
+ }).catch(() => rootDir)
+ },
+ },
+ srcDir: {
+ $resolve: async (val, get) => {
+ if (val && typeof val === 'string') {
+ return resolve(await get('rootDir'), val)
+ }
+
+ const rootDir = await get('rootDir')
+
+ const srcDir = resolve(rootDir, 'app')
+ if (!existsSync(srcDir)) {
+ return rootDir
+ }
+
+ const srcDirFiles = new Set<string>()
+ const files = await readdir(srcDir).catch(() => [])
+ for (const file of files) {
+ if (file !== 'spa-loading-template.html' && !file.startsWith('router.options')) {
+ srcDirFiles.add(file)
+ }
+ }
+ if (srcDirFiles.size === 0) {
+ for (const file of ['app.vue', 'App.vue']) {
+ if (existsSync(resolve(rootDir, file))) {
+ return rootDir
+ }
+ }
+ const keys = ['assets', 'layouts', 'middleware', 'pages', 'plugins'] as const
+ const dirs = await Promise.all(keys.map(key => get(`dir.${key}`)))
+ for (const dir of dirs) {
+ if (existsSync(resolve(rootDir, dir))) {
+ return rootDir
+ }
+ }
+ }
+ return srcDir
+ },
+ },
+ serverDir: {
+ $resolve: async (val, get) => {
+ const rootDir = await get('rootDir')
+ return resolve(rootDir, val && typeof val === 'string' ? val : 'server')
+ },
+ },
+ buildDir: {
+ $resolve: async (val, get) => {
+ const rootDir = await get('rootDir')
+ return resolve(rootDir, val && typeof val === 'string' ? val : '.nuxt')
+ },
+ },
+ appId: {
+ $resolve: val => val && typeof val === 'string' ? val : 'nuxt-app',
+ },
+ buildId: {
+ $resolve: async (val, get): Promise<string> => {
+ if (typeof val === 'string') { return val }
+
+ const [isDev, isTest] = await Promise.all([get('dev') as Promise<boolean>, get('test') as Promise<boolean>])
+ return isDev ? 'dev' : isTest ? 'test' : randomUUID()
+ },
+ },
+ modulesDir: {
+ $default: ['node_modules'],
+ $resolve: async (val, get) => {
+ const rootDir = await get('rootDir')
+ const modulesDir = new Set<string>([resolve(rootDir, 'node_modules')])
+ if (Array.isArray(val)) {
+ for (const dir of val) {
+ if (dir && typeof dir === 'string') {
+ modulesDir.add(resolve(rootDir, dir))
+ }
+ }
+ }
+ return [...modulesDir]
+ },
+ },
+ analyzeDir: {
+ $resolve: async (val, get) => val && typeof val === 'string'
+ ? resolve(await get('rootDir'), val)
+ : resolve(await get('buildDir'), 'analyze'),
+ },
+ dev: {
+ $resolve: val => typeof val === 'boolean' ? val : Boolean(isDevelopment),
+ },
+ test: {
+ $resolve: val => typeof val === 'boolean' ? val : Boolean(isTest),
+ },
+ envName: {
+ $resolve: async (val, get) => {
+ if (typeof val === 'string') {
+ return val
+ }
+ const isDev = await get('dev') as boolean
+ return isDev ? 'development' : 'production'
+ },
+ },
+ debug: {
+ $resolve: (val) => {
+ val ??= isDebug
+ if (val === true) {
+ return {
+ templates: true,
+ modules: true,
+ watchers: true,
+ hooks: {
+ client: true,
+ server: true,
+ },
+ nitro: true,
+ router: true,
+ hydration: true,
+ perf: process.env.NUXT_DEBUG_PERF === 'quiet' ? 'quiet' : true,
+ } satisfies Required<NuxtDebugOptions>
+ }
+ if (val && typeof val === 'object') {
+ // Support NUXT_DEBUG_PERF env var to enable perf profiling
+ if (process.env.NUXT_DEBUG_PERF) {
+ (val as NuxtDebugOptions).perf = process.env.NUXT_DEBUG_PERF === 'quiet' ? 'quiet' : true
+ }
+ return val
+ }
+ // Support NUXT_DEBUG_PERF env var without other debug options
+ if (process.env.NUXT_DEBUG_PERF) {
+ const perf: boolean | 'quiet' = process.env.NUXT_DEBUG_PERF === 'quiet' ? 'quiet' : true
+ return { perf } satisfies Partial<NuxtDebugOptions>
+ }
+ return false
+ },
+ },
+ ssr: {
+ $resolve: val => typeof val === 'boolean' ? val : true,
+ },
+ modules: {
+ $resolve: (val) => {
+ const modules: Array<string | NuxtModule | [NuxtModule | string, Record<string, any>]> = []
+ if (Array.isArray(val)) {
+ for (const mod of val) {
+ if (!mod) {
+ continue
+ }
+ if (typeof mod === 'string' || typeof mod === 'function' || (Array.isArray(mod) && mod[0])) {
+ modules.push(mod)
+ }
+ }
+ }
+ return modules
+ },
+ },
+ dir: {
+ app: {
+ $resolve: async (val, get) => {
+ const [srcDir, rootDir] = await Promise.all([get('srcDir'), get('rootDir')])
+ return resolve(await get('srcDir'), val && typeof val === 'string' ? val : (srcDir === rootDir ? 'app' : '.'))
+ },
+ },
+ assets: 'assets',
+ layouts: 'layouts',
+ middleware: 'middleware',
+ modules: {
+ $resolve: async (val, get) => {
+ return resolve(await get('rootDir'), val && typeof val === 'string' ? val : 'modules')
+ },
+ },
+ pages: 'pages',
+ plugins: 'plugins',
+ shared: {
+ $resolve: (val) => {
+ return val && typeof val === 'string' ? val : 'shared'
+ },
+ },
+ public: {
+ $resolve: async (val, get) => {
+ return resolve(await get('rootDir'), val && typeof val === 'string' ? val : 'public')
+ },
+ },
+ },
+ extensions: {
+ $resolve: (val): string[] => {
+ const extensions = ['.js', '.jsx', '.mjs', '.ts', '.tsx', '.vue']
+ if (Array.isArray(val)) {
+ for (const item of val) {
+ if (item && typeof item === 'string') {
+ extensions.push(item)
+ }
+ }
+ }
+ return extensions
+ },
+ },
+ alias: {
+ $resolve: async (val, get) => {
+ const [srcDir, rootDir, buildDir, sharedDir, serverDir] = await Promise.all([get('srcDir'), get('rootDir'), get('buildDir'), get('dir.shared'), get('serverDir')])
+ const srcWithTrailingSlash = withTrailingSlash(srcDir)
+ const rootWithTrailingSlash = withTrailingSlash(rootDir)
+ return {
+ '~': srcWithTrailingSlash,
+ '@': srcWithTrailingSlash,
+ '~~': rootWithTrailingSlash,
+ '@@': rootWithTrailingSlash,
+ '#shared': withTrailingSlash(resolve(rootDir, sharedDir)),
+ '#server': withTrailingSlash(serverDir),
+ '#build': withTrailingSlash(buildDir),
+ '#internal/nuxt/paths': resolve(buildDir, 'paths.mjs'),
+ ...typeof val === 'object' ? val : {},
+ }
+ },
+ },
+ ignoreOptions: undefined,
+ ignorePrefix: {
+ $resolve: val => val && typeof val === 'string' ? val : '-',
+ },
+ ignore: {
+ $resolve: async (val, get): Promise<string[]> => {
+ const [rootDir, ignorePrefix, analyzeDir, buildDir] = await Promise.all([get('rootDir'), get('ignorePrefix'), get('analyzeDir'), get('buildDir')])
+ const ignore = new Set<string>([
+ '**/*.stories.{js,cts,mts,ts,jsx,tsx}', // ignore storybook files
+ '**/*.{spec,test}.{js,cts,mts,ts,jsx,tsx}', // ignore tests
+ '**/*.d.{cts,mts,ts}', // ignore type declarations
+ '**/*.d.vue.{cts,mts,ts}',
+ '**/.{pnpm-store,vercel,netlify,output,git,cache,data,direnv}',
+ '/vendor',
+ '**/node-compile-cache',
+ '**/test-results',
+ '**/*.sock',
+ relative(rootDir, analyzeDir),
+ relative(rootDir, buildDir),
+ ])
+ if (ignorePrefix) {
+ ignore.add(`**/${ignorePrefix}*.*`)
+ }
+ if (Array.isArray(val)) {
+ for (const pattern of val) {
+ if (pattern) {
+ ignore.add(pattern)
+ }
+ }
+ }
+ return [...ignore]
+ },
+ },
+ watch: {
+ $resolve: (val) => {
+ if (Array.isArray(val)) {
+ return val.filter((b: unknown) => typeof b === 'string' || b instanceof RegExp)
+ }
+ return []
+ },
+ },
+ watchers: {
+ rewatchOnRawEvents: undefined,
+ webpack: {
+ aggregateTimeout: 1000,
+ },
+ chokidar: {
+ ignoreInitial: true,
+ ignorePermissionErrors: true,
+ },
+ },
+ hooks: undefined,
+ runtimeConfig: {
+ $resolve: async (_val, get) => {
+ const val = _val && typeof _val === 'object' ? _val : {}
+ const [app, buildId] = await Promise.all([get('app'), get('buildId')])
+ provideFallbackValues(val)
+ return defu(val, {
+ public: {},
+ app: {
+ buildId,
+ baseURL: app.baseURL,
+ buildAssetsDir: app.buildAssetsDir,
+ cdnURL: app.cdnURL,
+ },
+ })
+ },
+ },
+ appConfig: {
+ nuxt: {},
+ },
+
+ $schema: {},
+})
+
+function provideFallbackValues (obj: Record<string, any>) {
+ for (const key in obj) {
+ if (typeof obj[key] === 'undefined' || obj[key] === null) {
+ obj[key] = ''
+ } else if (typeof obj[key] === 'object') {
+ provideFallbackValues(obj[key])
+ }
+ }
+}
+
+function withTrailingSlash (str: string) {
+ return str.replace(/\/?$/, '/')
+}
diff --git a/packages/schema/src/config/dev.ts b/packages/schema/src/config/dev.ts
new file mode 100644
index 000000000000..b08be9d25e91
--- /dev/null
+++ b/packages/schema/src/config/dev.ts
@@ -0,0 +1,16 @@
+import process from 'node:process'
+import { defineResolvers } from '../utils/definition.ts'
+import { template as loadingTemplate } from '../../../ui-templates/dist/templates/loading.ts'
+
+export default defineResolvers({
+ devServer: {
+ https: false,
+ port: Number(process.env.NUXT_PORT || process.env.NITRO_PORT || process.env.PORT || 3000),
+ host: process.env.NUXT_HOST || process.env.NITRO_HOST || process.env.HOST || undefined,
+ url: 'http://localhost:3000',
+ loadingTemplate,
+ cors: {
+ origin: [/^https?:\/\/(?:(?:[^:]+\.)?localhost|127\.0\.0\.1|\[::1\])(?::\d+)?$/],
+ },
+ },
+})
diff --git a/packages/schema/src/config/esbuild.ts b/packages/schema/src/config/esbuild.ts
new file mode 100644
index 000000000000..3b2bbefd20cb
--- /dev/null
+++ b/packages/schema/src/config/esbuild.ts
@@ -0,0 +1,48 @@
+import { defu } from 'defu'
+import type { TransformOptions } from 'esbuild'
+import { defineResolvers } from '../utils/definition.ts'
+
+export default defineResolvers({
+ esbuild: {
+ options: {
+ target: {
+ $resolve: async (val, get) => {
+ if (typeof val === 'string') {
+ return val
+ }
+ // Only lower to es2024 for non-vite builders (webpack/rspack) where
+ // esbuild handles decorator lowering. The vite builder uses Babel instead.
+ const builder = await get('builder')
+ const isVite = !builder || builder === 'vite' || (builder as any) === '@nuxt/vite-builder'
+ if (isVite) {
+ return 'esnext'
+ }
+ // https://github.com/vitejs/vite-plugin-vue/issues/528
+ const useDecorators = await get('experimental').then(r => r?.decorators === true)
+ if (useDecorators) {
+ return 'es2024'
+ }
+ return 'esnext'
+ },
+ },
+ jsxFactory: 'h',
+ jsxFragment: 'Fragment',
+ tsconfigRaw: {
+ $resolve: async (_val, get) => {
+ const val: NonNullable<Exclude<TransformOptions['tsconfigRaw'], string>> = typeof _val === 'string' ? JSON.parse(_val) : (_val && typeof _val === 'object' ? _val : {})
+
+ const useDecorators = await get('experimental').then(r => r?.decorators === true)
+ if (!useDecorators) {
+ return val
+ }
+ // Force experimentalDecorators to false if decorators are enabled
+ return defu({
+ compilerOptions: {
+ experimentalDecorators: false,
+ },
+ } satisfies TransformOptions['tsconfigRaw'], val)
+ },
+ },
+ },
+ },
+})
diff --git a/packages/schema/src/config/experimental.ts b/packages/schema/src/config/experimental.ts
new file mode 100644
index 000000000000..98ad06742471
--- /dev/null
+++ b/packages/schema/src/config/experimental.ts
@@ -0,0 +1,268 @@
+import { defineResolvers } from '../utils/definition.ts'
+
+export default defineResolvers({
+ future: {
+ compatibilityVersion: {
+ $resolve: val => typeof val === 'number' ? val as 4 | 5 : 5,
+ },
+ multiApp: false,
+ typescriptBundlerResolution: {
+ async $resolve (val, get) {
+ // @ts-expect-error TODO: remove in v3.10
+ val = typeof val === 'boolean' ? val : await (get('experimental')).then(e => e?.typescriptBundlerResolution as string | undefined)
+ if (typeof val === 'boolean') { return val }
+ const setting = await get('typescript.tsConfig').then(r => r?.compilerOptions?.moduleResolution)
+ if (setting) {
+ return setting.toLowerCase() === 'bundler'
+ }
+ return true
+ },
+ },
+ },
+ features: {
+ inlineStyles: {
+ async $resolve (_val, get) {
+ const val = typeof _val === 'boolean' || typeof _val === 'function'
+ ? _val
+ // @ts-expect-error TODO: legacy property - remove in v3.10
+ : await (get('experimental')).then(e => e?.inlineSSRStyles) as undefined | boolean
+ if (
+ val === false ||
+ (await get('dev')) ||
+ (await get('ssr')) === false
+ ) {
+ return false
+ }
+ // Enabled by default for prod with ssr (for vue components)
+ return val ?? ((id?: string) => !!id && id.includes('.vue'))
+ },
+ },
+ devLogs: {
+ async $resolve (val, get) {
+ if (typeof val === 'boolean' || val === 'silent') {
+ return val
+ }
+ const [isDev, isTest] = await Promise.all([get('dev'), get('test')])
+ return isDev && !isTest
+ },
+ },
+ noScripts: {
+ async $resolve (val, get) {
+ const isValidLiteral = (val: unknown): val is 'production' | 'all' => {
+ return typeof val === 'string' && ['production', 'all'].includes(val)
+ }
+ return val === true
+ ? 'production'
+ : val === false || isValidLiteral(val)
+ ? val
+ // @ts-expect-error TODO: legacy property - remove in v3.10
+ : (await (get('experimental')).then(e => e?.noScripts as boolean | undefined && 'production') ?? false)
+ },
+ },
+ },
+ experimental: {
+ runtimeBaseURL: false,
+ decorators: false,
+ asyncEntry: {
+ $resolve: val => typeof val === 'boolean' ? val : false,
+ },
+
+ serverAppConfig: true,
+ emitRouteChunkError: {
+ $resolve: (val) => {
+ if (val === true) {
+ return 'manual'
+ }
+ if (val === 'reload') {
+ return 'automatic'
+ }
+ if (val === false) {
+ return false
+ }
+
+ const validOptions = new Set(['manual', 'automatic', 'automatic-immediate'] as const)
+ type EmitRouteChunkError = typeof validOptions extends Set<infer Option> ? Option : never
+ if (typeof val === 'string' && validOptions.has(val as EmitRouteChunkError)) {
+ return val as EmitRouteChunkError
+ }
+
+ return 'automatic'
+ },
+ },
+ templateRouteInjection: true,
+ restoreState: false,
+ noVueServer: false,
+ payloadExtraction: {
+ $resolve: async (val, get) => {
+ if ((await get('ssr')) === false) { return false }
+ if (val === 'client' || typeof val === 'boolean') { return val }
+ return (await get('future.compatibilityVersion')) >= 5 ? 'client' as const : true
+ },
+ },
+ clientFallback: false,
+ crossOriginPrefetch: false,
+
+ /**
+ * Enable View Transition API integration with client-side router.
+ * @see [View Transitions API](https://developer.chrome.com/docs/web-platform/view-transitions)
+ * @type {ViewTransitionOptions['enabled'] | ViewTransitionOptions}
+ */
+ viewTransition: false,
+ writeEarlyHints: false,
+ componentIslands: {
+ $resolve: (val) => {
+ if (val === 'local+remote') {
+ return { remoteIsland: true }
+ }
+ if (val === 'local') {
+ return true
+ }
+ return val ?? 'auto'
+ },
+ },
+ localLayerAliases: true,
+ typedPages: false,
+ appManifest: true,
+ checkOutdatedBuildInterval: 1000 * 60 * 60,
+ watcher: {
+ $resolve: async (val, get) => {
+ const validOptions = new Set(['chokidar', 'parcel', 'chokidar-granular', 'builder'] as const)
+ type WatcherOption = typeof validOptions extends Set<infer Option> ? Option : never
+ if (typeof val === 'string' && validOptions.has(val as WatcherOption)) {
+ return val as WatcherOption
+ }
+ if ((await get('future.compatibilityVersion')) >= 5) {
+ return 'builder' as const
+ }
+ const [srcDir, rootDir] = await Promise.all([get('srcDir'), get('rootDir')])
+ if (srcDir === rootDir) {
+ return 'chokidar-granular' as const
+ }
+ return 'chokidar' as const
+ },
+ },
+ asyncContext: false,
+ headNext: true,
+ inlineRouteRules: false,
+ scanPageMeta: {
+ $resolve (val) {
+ return typeof val === 'boolean' || val === 'after-resolve' ? val : 'after-resolve'
+ },
+ },
+ extraPageMetaExtractionKeys: [],
+ sharedPrerenderData: {
+ $resolve (val) {
+ return typeof val === 'boolean' ? val : true
+ },
+ },
+ cookieStore: true,
+ defaults: {
+ nuxtLink: {
+ componentName: 'NuxtLink',
+ prefetch: true,
+ prefetchOn: {
+ visibility: true,
+ },
+ },
+ useAsyncData: {
+ deep: false,
+ },
+ useState: {
+ resetOnClear: {
+ $resolve: async (val, get) => {
+ return typeof val === 'boolean' ? val : (await get('future.compatibilityVersion')) >= 5
+ },
+ },
+ },
+ useFetch: {},
+ },
+ clientNodeCompat: false,
+ navigationRepaint: true,
+ buildCache: false,
+ normalizeComponentNames: {
+ $resolve: (val) => {
+ return typeof val === 'boolean' ? val : true
+ },
+ },
+ normalizePageNames: {
+ $resolve: async (val, get) => {
+ return typeof val === 'boolean' ? val : (await get('future.compatibilityVersion')) >= 5
+ },
+ },
+ spaLoadingTemplateLocation: {
+ $resolve: (val) => {
+ const validOptions = new Set(['body', 'within'] as const)
+ type SpaLoadingTemplateLocation = typeof validOptions extends Set<infer Option> ? Option : never
+ return typeof val === 'string' && validOptions.has(val as SpaLoadingTemplateLocation) ? val as SpaLoadingTemplateLocation : 'body'
+ },
+ },
+ browserDevtoolsTiming: {
+ $resolve: (val, get) => typeof val === 'boolean' ? val : get('dev'),
+ },
+ chromeDevtoolsProjectSettings: true,
+ debugModuleMutation: {
+ $resolve: async (val, get) => {
+ return typeof val === 'boolean' ? val : Boolean(await get('debug'))
+ },
+ },
+ lazyHydration: {
+ $resolve: (val) => {
+ return typeof val === 'boolean' ? val : true
+ },
+ },
+ templateImportResolution: true,
+ purgeCachedData: {
+ $resolve: (val) => {
+ return typeof val === 'boolean' ? val : true
+ },
+ },
+ prefetchPreloadTags: {
+ $resolve: (val) => {
+ return typeof val === 'boolean' ? val : false
+ },
+ },
+ granularCachedData: {
+ $resolve: (val) => {
+ return typeof val === 'boolean' ? val : true
+ },
+ },
+ alwaysRunFetchOnKeyChange: {
+ $resolve: (val) => {
+ return typeof val === 'boolean' ? val : false
+ },
+ },
+ parseErrorData: {
+ $resolve: (val) => {
+ return typeof val === 'boolean' ? val : true
+ },
+ },
+ enforceModuleCompatibility: false,
+ pendingWhenIdle: {
+ $resolve: (val) => {
+ return typeof val === 'boolean' ? val : false
+ },
+ },
+ entryImportMap: true,
+ extractAsyncDataHandlers: {
+ $resolve: (val) => {
+ return typeof val === 'boolean' ? val : false
+ },
+ },
+ nitroAutoImports: {
+ $resolve: async (val, get) => {
+ return typeof val === 'boolean' ? val : (await get('future.compatibilityVersion')) < 5
+ },
+ },
+ asyncCallHook: {
+ $resolve: async (val, get) => {
+ return typeof val === 'boolean' ? val : (await get('future.compatibilityVersion')) < 5
+ },
+ },
+ clientNodePlaceholder: {
+ $resolve: async (val, get) => {
+ return typeof val === 'boolean' ? val : (await get('future.compatibilityVersion')) >= 5
+ },
+ },
+ clearBuildHooks: true,
+ },
+})
diff --git a/packages/schema/src/config/generate.ts b/packages/schema/src/config/generate.ts
new file mode 100644
index 000000000000..9afe5915407c
--- /dev/null
+++ b/packages/schema/src/config/generate.ts
@@ -0,0 +1,9 @@
+import { defineResolvers } from '../utils/definition.ts'
+
+export default defineResolvers({
+ // @ts-expect-error TODO: remove in nuxt v5
+ generate: {
+ routes: [],
+ exclude: [],
+ },
+})
diff --git a/packages/schema/src/config/index.ts b/packages/schema/src/config/index.ts
new file mode 100644
index 000000000000..d3a362b8acca
--- /dev/null
+++ b/packages/schema/src/config/index.ts
@@ -0,0 +1,36 @@
+import adhoc from './adhoc.ts'
+import app from './app.ts'
+import build from './build.ts'
+import common from './common.ts'
+import dev from './dev.ts'
+import esbuild from './esbuild.ts'
+import oxc from './oxc.ts'
+import experimental from './experimental.ts'
+import generate from './generate.ts'
+import internal from './internal.ts'
+import nitro from './nitro.ts'
+import postcss from './postcss.ts'
+import router from './router.ts'
+import typescript from './typescript.ts'
+import vite from './vite.ts'
+import webpack from './webpack.ts'
+import type { InputObject } from 'untyped'
+
+export default {
+ ...adhoc,
+ ...app,
+ ...build,
+ ...common,
+ ...dev,
+ ...experimental,
+ ...generate,
+ ...internal,
+ ...nitro,
+ ...postcss,
+ ...router,
+ ...typescript,
+ ...esbuild,
+ ...oxc,
+ ...vite,
+ ...webpack,
+} as InputObject
diff --git a/packages/schema/src/config/internal.ts b/packages/schema/src/config/internal.ts
new file mode 100644
index 000000000000..341d8b34cab8
--- /dev/null
+++ b/packages/schema/src/config/internal.ts
@@ -0,0 +1,18 @@
+import { defineResolvers } from '../utils/definition.ts'
+
+export default defineResolvers({
+ _majorVersion: 4,
+ _legacyGenerate: false,
+ _start: false,
+ _build: false,
+ _generate: false,
+ _prepare: false,
+ _cli: false,
+ _requiredModules: {},
+ _loadOptions: undefined,
+ _nuxtConfigFile: undefined,
+ _nuxtConfigFiles: [],
+ appDir: '',
+ _installedModules: [],
+ _modules: [],
+})
diff --git a/packages/schema/src/config/nitro.ts b/packages/schema/src/config/nitro.ts
new file mode 100644
index 000000000000..f940bddacc1b
--- /dev/null
+++ b/packages/schema/src/config/nitro.ts
@@ -0,0 +1,48 @@
+import { defineResolvers } from '../utils/definition.ts'
+
+export default defineResolvers({
+ server: {
+ builder: {
+ $resolve: (val) => {
+ if (typeof val === 'string') {
+ return val
+ }
+ if (val && typeof val === 'object' && 'bundle' in val) {
+ return val
+ }
+ return '@nuxt/nitro-server'
+ },
+ },
+ },
+ nitro: {
+ runtimeConfig: {
+ $resolve: async (val, get) => {
+ const runtimeConfig = await get('runtimeConfig')
+ return {
+ ...runtimeConfig,
+ app: {
+ ...runtimeConfig.app,
+ baseURL: runtimeConfig.app.baseURL.startsWith('./')
+ ? runtimeConfig.app.baseURL.slice(1)
+ : runtimeConfig.app.baseURL,
+ },
+ nitro: {
+ envPrefix: 'NUXT_',
+ ...runtimeConfig.nitro,
+ },
+ }
+ },
+ },
+ routeRules: {
+ $resolve: async (val, get) => {
+ return {
+ ...await get('routeRules'),
+ ...(val && typeof val === 'object' ? val : {}),
+ }
+ },
+ },
+ },
+ routeRules: {},
+ serverHandlers: [],
+ devServerHandlers: [],
+})
diff --git a/packages/schema/src/config/oxc.ts b/packages/schema/src/config/oxc.ts
new file mode 100644
index 000000000000..d748cc515815
--- /dev/null
+++ b/packages/schema/src/config/oxc.ts
@@ -0,0 +1,13 @@
+import { defineResolvers } from '../utils/definition.ts'
+
+export default defineResolvers({
+ oxc: {
+ transform: {
+ options: {
+ target: 'esnext',
+ jsxFactory: 'h',
+ jsxFragment: 'Fragment',
+ },
+ },
+ },
+})
diff --git a/packages/schema/src/config/postcss.ts b/packages/schema/src/config/postcss.ts
new file mode 100644
index 000000000000..1dcca8a5a7f6
--- /dev/null
+++ b/packages/schema/src/config/postcss.ts
@@ -0,0 +1,41 @@
+import { defineResolvers } from '../utils/definition.ts'
+
+const ensureItemIsLast = (item: string) => (arr: string[]) => {
+ const index = arr.indexOf(item)
+ if (index !== -1) {
+ arr.splice(index, 1)
+ arr.push(item)
+ }
+ return arr
+}
+
+const orderPresets = {
+ cssnanoLast: ensureItemIsLast('cssnano'),
+ autoprefixerLast: ensureItemIsLast('autoprefixer'),
+ autoprefixerAndCssnanoLast (names: string[]) {
+ return orderPresets.cssnanoLast(orderPresets.autoprefixerLast(names))
+ },
+}
+
+export default defineResolvers({
+ postcss: {
+ order: {
+ $resolve: (val) => {
+ if (typeof val === 'string') {
+ if (!(val in orderPresets)) {
+ throw new Error(`[nuxt] Unknown PostCSS order preset: ${val}`)
+ }
+ return orderPresets[val as keyof typeof orderPresets]
+ }
+ if (typeof val === 'function') {
+ return val as (names: string[]) => string[]
+ }
+ if (Array.isArray(val)) {
+ return val
+ }
+ return orderPresets.autoprefixerAndCssnanoLast
+ },
+ },
+ plugins: {},
+ },
+})
diff --git a/packages/schema/src/config/router.ts b/packages/schema/src/config/router.ts
new file mode 100644
index 000000000000..242a9cb5a326
--- /dev/null
+++ b/packages/schema/src/config/router.ts
@@ -0,0 +1,10 @@
+import { defineResolvers } from '../utils/definition.ts'
+
+export default defineResolvers({
+ router: {
+ options: {
+ hashMode: false,
+ scrollBehaviorType: 'auto',
+ },
+ },
+})
diff --git a/packages/schema/src/config/typescript.ts b/packages/schema/src/config/typescript.ts
new file mode 100644
index 000000000000..20fd31c846a6
--- /dev/null
+++ b/packages/schema/src/config/typescript.ts
@@ -0,0 +1,41 @@
+import { defineResolvers } from '../utils/definition.ts'
+
+export default defineResolvers({
+ typescript: {
+ strict: true,
+ builder: {
+ $resolve: (val) => {
+ const validBuilderTypes = new Set(['vite', 'webpack', 'rspack', 'shared'] as const)
+ type ValidBuilderType = typeof validBuilderTypes extends Set<infer Option> ? Option : never
+ if (typeof val === 'string' && validBuilderTypes.has(val as ValidBuilderType)) {
+ return val as ValidBuilderType
+ }
+ if (val === false) {
+ return false
+ }
+ return null
+ },
+ },
+ hoist: {
+ $resolve: (val) => {
+ const defaults = [
+ // Key nuxt dependencies
+ '@unhead/vue',
+ '@nuxt/devtools',
+ 'vue',
+ '@vue/runtime-core',
+ '@vue/compiler-sfc',
+ 'vue-router',
+ 'vue-router/auto-routes',
+ '@nuxt/schema',
+ 'nuxt',
+ ]
+ return val === false ? [] : (Array.isArray(val) ? val.concat(defaults) : defaults)
+ },
+ },
+ includeWorkspace: false,
+ typeCheck: false,
+ tsConfig: {},
+ shim: false,
+ },
+})
diff --git a/packages/schema/src/config/vite.ts b/packages/schema/src/config/vite.ts
new file mode 100644
index 000000000000..1093f15a21f4
--- /dev/null
+++ b/packages/schema/src/config/vite.ts
@@ -0,0 +1,114 @@
+import { resolve } from 'pathe'
+import { defineResolvers } from '../utils/definition.ts'
+
+export default defineResolvers({
+ vite: {
+ root: {
+ $resolve: (val, get) => typeof val === 'string' ? val : (get('srcDir')),
+ },
+ mode: {
+ $resolve: async (val, get) => typeof val === 'string' ? val : (await get('dev') ? 'development' : 'production'),
+ },
+ define: {
+ $resolve: async (_val, get) => {
+ const [isDev, isTest, isDebug] = await Promise.all([get('dev'), get('test'), get('debug')])
+ return {
+ '__VUE_PROD_HYDRATION_MISMATCH_DETAILS__': Boolean(isDebug && (isDebug === true || isDebug.hydration)),
+ 'process.dev': isDev,
+ 'import.meta.dev': isDev,
+ 'process.test': isTest,
+ 'import.meta.test': isTest,
+ ..._val && typeof _val === 'object' ? _val : {},
+ }
+ },
+ },
+ resolve: {
+ extensions: ['.mjs', '.js', '.ts', '.jsx', '.tsx', '.json', '.vue'],
+ },
+ publicDir: {
+ $resolve: (val) => {
+ if (val) {
+ console.warn('Directly configuring the `vite.publicDir` option is not supported. Instead, set `dir.public`. You can read more in `https://nuxt.com/docs/4.x/api/nuxt-config#public`.')
+ }
+ // this is missing from our `vite` types deliberately, so users do not configure it
+ return false as never
+ },
+ },
+ vue: {
+ isProduction: {
+ $resolve: async (val, get) => typeof val === 'boolean' ? val : !(await get('dev')),
+ },
+ template: {
+ compilerOptions: {
+ $resolve: async (val, get) => val ?? (await get('vue')).compilerOptions,
+ },
+ transformAssetUrls: {
+ $resolve: async (val, get) => val ?? (await get('vue')).transformAssetUrls,
+ },
+ },
+ script: {
+ hoistStatic: {
+ $resolve: async (val, get) => typeof val === 'boolean' ? val : (await get('vue')).compilerOptions?.hoistStatic,
+ },
+ },
+ features: {
+ propsDestructure: {
+ $resolve: async (val, get) => {
+ if (typeof val === 'boolean') {
+ return val
+ }
+ const vueOptions = await get('vue') || {}
+ return Boolean(
+ // @ts-expect-error TODO: remove in future: supporting a legacy schema
+ vueOptions.script?.propsDestructure
+ ?? vueOptions.propsDestructure,
+ )
+ },
+ },
+ },
+ },
+ vueJsx: {
+ $resolve: async (val, get) => {
+ return {
+ // TODO: investigate type divergence between types for @vue/compiler-core and @vue/babel-plugin-jsx
+ isCustomElement: (await get('vue')).compilerOptions?.isCustomElement as undefined | ((tag: string) => boolean),
+ ...typeof val === 'object' ? val : {},
+ }
+ },
+ },
+ optimizeDeps: {
+ exclude: {
+ $resolve: val => [
+ ...Array.isArray(val) ? val : [],
+ 'vue-demi',
+ ],
+ },
+ },
+ clearScreen: true,
+ build: {
+ assetsDir: {
+ $resolve: async (val, get) => typeof val === 'string' ? val : (await get('app')).buildAssetsDir?.replace(/^\/+/, ''),
+ },
+ emptyOutDir: false,
+ },
+ server: {
+ fs: {
+ allow: {
+ $resolve: async (val, get) => {
+ const [buildDir, srcDir, rootDir, workspaceDir] = await Promise.all([get('buildDir'), get('srcDir'), get('rootDir'), get('workspaceDir')])
+ return [...new Set([
+ buildDir,
+ srcDir,
+ rootDir,
+ workspaceDir,
+ ...Array.isArray(val) ? val : [],
+ ])]
+ },
+ },
+ },
+ },
+ cacheDir: {
+ $resolve: async (val, get) => typeof val === 'string' ? val : resolve(await get('rootDir'), 'node_modules/.cache/vite'),
+ },
+ },
+})
diff --git a/packages/schema/src/config/webpack.ts b/packages/schema/src/config/webpack.ts
new file mode 100644
index 000000000000..c41fca840ea7
--- /dev/null
+++ b/packages/schema/src/config/webpack.ts
@@ -0,0 +1,132 @@
+import process from 'node:process'
+import { defu } from 'defu'
+import { defineResolvers } from '../utils/definition.ts'
+
+export default defineResolvers({
+ webpack: {
+ analyze: {
+ $resolve: async (val, get) => {
+ const value = typeof val === 'boolean' ? { enabled: val } : (val && typeof val === 'object' ? val : {})
+ return defu(value, await get('build.analyze') as { enabled?: boolean } | Record<string, unknown>)
+ },
+ },
+ profile: process.argv.includes('--profile'),
+ extractCSS: true,
+ cssSourceMap: {
+ $resolve: (val, get) => typeof val === 'boolean' ? val : get('dev'),
+ },
+ serverURLPolyfill: 'url',
+ filenames: {
+ app: ({ isDev }: { isDev: boolean }) => isDev ? '[name].js' : '[contenthash:7].js',
+ chunk: ({ isDev }: { isDev: boolean }) => isDev ? '[name].js' : '[contenthash:7].js',
+ css: ({ isDev }: { isDev: boolean }) => isDev ? '[name].css' : 'css/[contenthash:7].css',
+ img: ({ isDev }: { isDev: boolean }) => isDev ? '[path][name].[ext]' : 'img/[name].[contenthash:7].[ext]',
+ font: ({ isDev }: { isDev: boolean }) => isDev ? '[path][name].[ext]' : 'fonts/[name].[contenthash:7].[ext]',
+ video: ({ isDev }: { isDev: boolean }) => isDev ? '[path][name].[ext]' : 'videos/[name].[contenthash:7].[ext]',
+ },
+ loaders: {
+ $resolve: async (val, get) => {
+ const loaders: Record<string, any> = val && typeof val === 'object' ? val : {}
+ const styleLoaders = [
+ 'css', 'cssModules', 'less',
+ 'sass', 'scss', 'stylus', 'vueStyle',
+ ]
+ for (const name of styleLoaders) {
+ const loader = loaders[name]
+ if (loader && loader.sourceMap === undefined) {
+ loader.sourceMap = Boolean(
+ // @ts-expect-error TODO: remove legacay configuration
+ await get('build.cssSourceMap'),
+ )
+ }
+ }
+ return loaders
+ },
+ esbuild: {
+ $resolve: async (val, get) => {
+ return defu(val && typeof val === 'object' ? val : {}, await get('esbuild.options'))
+ },
+ },
+ file: { esModule: false, limit: 1000 },
+ fontUrl: { esModule: false, limit: 1000 },
+ imgUrl: { esModule: false, limit: 1000 },
+ pugPlain: {},
+ vue: {
+ transformAssetUrls: {
+ $resolve: async (val, get) => (val ?? (await get('vue.transformAssetUrls'))),
+ },
+ compilerOptions: {
+ $resolve: async (val, get) => (val ?? (await get('vue.compilerOptions'))),
+ },
+ propsDestructure: {
+ $resolve: async (val, get) => Boolean(val ?? await get('vue.propsDestructure')),
+ },
+ },
+ css: {
+ importLoaders: 0,
+ url: {
+ filter: (url: string, _resourcePath: string) => url[0] !== '/',
+ },
+ esModule: false,
+ },
+ cssModules: {
+ importLoaders: 0,
+ url: {
+ filter: (url: string, _resourcePath: string) => url[0] !== '/',
+ },
+ esModule: false,
+ modules: {
+ localIdentName: '[local]_[hash:base64:5]',
+ },
+ },
+ less: {},
+ sass: {
+ sassOptions: {
+ indentedSyntax: true,
+ },
+ },
+ scss: {},
+ stylus: {},
+
+ vueStyle: {},
+ },
+ plugins: [],
+ aggressiveCodeRemoval: false,
+ optimizeCSS: {
+ $resolve: async (val, get) => {
+ if (val === false || (val && typeof val === 'object')) {
+ return val
+ }
+ // @ts-expect-error TODO: remove legacy configuration
+ const extractCSS = await get('build.extractCSS')
+ return extractCSS ? {} : false
+ },
+ },
+ optimization: {
+ runtimeChunk: 'single',
+ minimize: {
+ $resolve: async (val, get) => typeof val === 'boolean' ? val : !(await get('dev')),
+ },
+ minimizer: undefined,
+ splitChunks: {
+ chunks: 'all',
+ automaticNameDelimiter: '/',
+ cacheGroups: {},
+ },
+ },
+ postcss: {
+ postcssOptions: {
+ plugins: {
+ $resolve: (val, get) => val && typeof val === 'object' ? val : (get('postcss.plugins')),
+ },
+ },
+ },
+ devMiddleware: {
+ stats: 'none',
+ },
+ hotMiddleware: {},
+ friendlyErrors: true,
+ warningIgnoreFilters: [],
+ experiments: {},
+ },
+})
diff --git a/packages/schema/src/index.ts b/packages/schema/src/index.ts
new file mode 100644
index 000000000000..02d3ccc980d9
--- /dev/null
+++ b/packages/schema/src/index.ts
@@ -0,0 +1,18 @@
+// Types
+export type { NuxtCompatibility, NuxtCompatibilityIssue, NuxtCompatibilityIssues } from './types/compatibility.ts'
+export type { Component, ComponentMeta, ComponentsDir, ComponentsOptions, ScanDir } from './types/components.ts'
+export type { NuxtCompilerOptions, KeyedFunction, KeyedFunctionFactory, CompilerScanDir } from './types/compiler.ts'
+export type { AppConfig, AppConfigInput, CustomAppConfig, DefineNuxtConfig, NuxtAppConfig, NuxtBuilder, NuxtConfig, NuxtConfigLayer, NuxtOptions, PublicRuntimeConfig, RuntimeConfig, RuntimeValue, SchemaDefinition, UpperSnakeCase, ViteConfig, ViteOptions, ViewTransitionOptions, ViewTransitionPageOptions } from './types/config.ts'
+// eslint-disable-next-line @typescript-eslint/no-deprecated
+export type { ImportPresetWithDeprecation } from './types/hooks.ts'
+export type { GenerateAppOptions, HookResult, NuxtAnalyzeMeta, NuxtHookName, NuxtHooks, NuxtLayout, NuxtMiddleware, NuxtPage, TSReference, VueTSConfig, WatchEvent } from './types/hooks.ts'
+export type { ImportsOptions } from './types/imports.ts'
+export type { AppHeadMetaObject, MetaObject, MetaObjectRaw } from './types/head.ts'
+export type { ModuleDefinition, ModuleDependencies, ModuleDependencyMeta, ModuleMeta, ModuleOptions, ModuleSetupInstallResult, ModuleSetupReturn, NuxtModule, ResolvedModuleOptions } from './types/module.ts'
+export type { Nuxt, NuxtApp, NuxtPlugin, NuxtPluginTemplate, NuxtTemplate, NuxtTypeTemplate, NuxtServerTemplate, ResolvedNuxtTemplate } from './types/nuxt.ts'
+export type { RouterConfig, RouterConfigSerializable, RouterOptions } from './types/router.ts'
+export type { ConfigSchema } from './types/schema.ts'
+export type { NuxtDebugContext, NuxtDebugOptions, NuxtDebugModuleMutationRecord } from './types/debug.ts'
+
+// Schema
+export { default as NuxtConfigSchema } from './config/index.ts'
diff --git a/packages/schema/src/types/builder-env/index.ts b/packages/schema/src/types/builder-env/index.ts
new file mode 100644
index 000000000000..477a4bf9749c
--- /dev/null
+++ b/packages/schema/src/types/builder-env/index.ts
@@ -0,0 +1,4 @@
+import type { ViteImportMeta } from './vite.ts'
+import type { WebpackImportMeta } from './webpack.ts'
+
+export type BundlerImportMeta = ViteImportMeta & WebpackImportMeta
diff --git a/packages/schema/src/types/builder-env/vite.ts b/packages/schema/src/types/builder-env/vite.ts
new file mode 100644
index 000000000000..a57407d50aae
--- /dev/null
+++ b/packages/schema/src/types/builder-env/vite.ts
@@ -0,0 +1,101 @@
+/**
+ * Reference: https://github.com/vitejs/vite/blob/main/packages/vite/types/importMeta.d.ts
+ */
+export type ModuleNamespace = Record<string, any> & {
+ [Symbol.toStringTag]: 'Module'
+}
+
+export interface ViteHot {
+ readonly data: any
+
+ accept (): void
+ accept (cb: (mod: ModuleNamespace | undefined) => void): void
+ accept (dep: string, cb: (mod: ModuleNamespace | undefined) => void): void
+ accept (deps: readonly string[], cb: (mods: Array<ModuleNamespace | undefined>) => void): void
+ acceptExports (exportNames: string | readonly string[], cb?: (mod: ModuleNamespace | undefined) => void): void
+
+ dispose (cb: (data: any) => void): void
+ prune (cb: (data: any) => void): void
+ invalidate (message?: string): void
+
+ on (event: any, cb: (payload: any) => void): void
+ send (event: any, data?: any): void
+}
+
+export interface KnownAsTypeMap {
+ raw: string
+ url: string
+ worker: Worker
+}
+
+export interface ImportGlobOptions<
+ Eager extends boolean,
+ AsType extends string,
+> {
+ /**
+ * Import type for the import url.
+ */
+ as?: AsType
+ /**
+ * Import as static or dynamic
+ */
+ eager?: Eager
+ /**
+ * Import only the specific named export. Set to `default` to import the default export.
+ */
+ import?: string
+ /**
+ * Custom queries
+ */
+ query?: string | Record<string, string | number | boolean>
+ /**
+ * Search files also inside `node_modules/` and hidden directories (e.g. `.git/`). This might have impact on performance.
+ */
+ exhaustive?: boolean
+}
+
+export interface ImportGlobFunction {
+ /**
+ * Import a list of files with a glob pattern.
+ *
+ * Overload 1: No generic provided, infer the type from `eager` and `as`
+ */
+ <
+ Eager extends boolean,
+ As extends string,
+ T = As extends keyof KnownAsTypeMap ? KnownAsTypeMap[As] : unknown,
+ >(
+ glob: string | string[],
+ options?: ImportGlobOptions<Eager, As>
+ ): (Eager extends true
+ ? true
+ : false) extends true
+ ? Record<string, T>
+ : Record<string, () => Promise<T>>
+ /**
+ * Import a list of files with a glob pattern.
+ *
+ * Overload 2: Module generic provided, infer the type from `eager: false`
+ */
+ <M>(
+ glob: string | string[],
+ options?: ImportGlobOptions<false, string>
+ ): Record<string, () => Promise<M>>
+ /**
+ * Import a list of files with a glob pattern.
+ *
+ * Overload 3: Module generic provided, infer the type from `eager: true`
+ */
+ <M>(
+ glob: string | string[],
+ options: ImportGlobOptions<true, string>
+ ): Record<string, M>
+}
+
+export interface ViteImportMeta {
+ /** Vite client HMR API - see https://vite.dev/guide/api-hmr */
+ readonly hot?: ViteHot
+
+ /** vite glob import utility - https://vite.dev/guide/features.html#glob-import */
+ glob: ImportGlobFunction
+}
diff --git a/packages/schema/src/types/builder-env/webpack.ts b/packages/schema/src/types/builder-env/webpack.ts
new file mode 100644
index 000000000000..061d654a3475
--- /dev/null
+++ b/packages/schema/src/types/builder-env/webpack.ts
@@ -0,0 +1,208 @@
+/**
+ * Reference: https://github.com/DefinitelyTyped/DefinitelyTyped/blob/master/types/webpack-env/index.d.ts
+ */
+
+export type WebpackModuleId = string | number
+
+export interface HotNotifierInfo {
+ type:
+ | 'self-declined'
+ | 'declined'
+ | 'unaccepted'
+ | 'accepted'
+ | 'disposed'
+ | 'accept-errored'
+ | 'self-accept-errored'
+ | 'self-accept-error-handler-errored'
+ /**
+ * The module in question.
+ */
+ moduleId: number
+ /**
+ * For errors: the module id owning the accept handler.
+ */
+ dependencyId?: number | undefined
+ /**
+ * For declined/accepted/unaccepted: the chain from where the update was propagated.
+ */
+ chain?: number[] | undefined
+ /**
+ * For declined: the module id of the declining parent
+ */
+ parentId?: number | undefined
+ /**
+ * For accepted: the modules that are outdated and will be disposed
+ */
+ outdatedModules?: number[] | undefined
+ /**
+ * For accepted: The location of accept handlers that will handle the update
+ */
+ outdatedDependencies?: {
+ [dependencyId: number]: number[]
+ } | undefined
+ /**
+ * For errors: the thrown error
+ */
+ error?: Error | undefined
+ /**
+ * For self-accept-error-handler-errored: the error thrown by the module
+ * before the error handler tried to handle it.
+ */
+ originalError?: Error | undefined
+}
+
+export interface AcceptOptions {
+ /**
+ * If true the update process continues even if some modules are not accepted (and would bubble to the entry point).
+ */
+ ignoreUnaccepted?: boolean | undefined
+ /**
+ * Ignore changes made to declined modules.
+ */
+ ignoreDeclined?: boolean | undefined
+ /**
+ * Ignore errors throw in accept handlers, error handlers and while reevaluating module.
+ */
+ ignoreErrored?: boolean | undefined
+ /**
+ * Notifier for declined modules.
+ */
+ onDeclined?: ((info: HotNotifierInfo) => void) | undefined
+ /**
+ * Notifier for unaccepted modules.
+ */
+ onUnaccepted?: ((info: HotNotifierInfo) => void) | undefined
+ /**
+ * Notifier for accepted modules.
+ */
+ onAccepted?: ((info: HotNotifierInfo) => void) | undefined
+ /**
+ * Notifier for disposed modules.
+ */
+ onDisposed?: ((info: HotNotifierInfo) => void) | undefined
+ /**
+ * Notifier for errors.
+ */
+ onErrored?: ((info: HotNotifierInfo) => void) | undefined
+ /**
+ * Indicates that apply() is automatically called by check function
+ */
+ autoApply?: boolean | undefined
+}
+
+export interface WebpackHot {
+ /**
+ * Accept code updates for the specified dependencies. The callback is called when dependencies were replaced.
+ * @param dependencies
+ * @param callback
+ * @param errorHandler
+ */
+ accept (dependencies: string[], callback?: (updatedDependencies: WebpackModuleId[]) => void, errorHandler?: (err: Error) => void): void
+ /**
+ * Accept code updates for the specified dependencies. The callback is called when dependencies were replaced.
+ * @param dependency
+ * @param callback
+ * @param errorHandler
+ */
+ accept (dependency: string, callback?: () => void, errorHandler?: (err: Error) => void): void
+ /**
+ * Accept code updates for this module without notification of parents.
+ * This should only be used if the module doesn’t export anything.
+ * The errHandler can be used to handle errors that occur while loading the updated module.
+ * @param errHandler
+ */
+ accept (errHandler?: (err: Error) => void): void
+ /**
+ * Do not accept updates for the specified dependencies. If any dependencies is updated, the code update fails with code "decline".
+ */
+ decline (dependencies: string[]): void
+ /**
+ * Do not accept updates for the specified dependencies. If any dependencies is updated, the code update fails with code "decline".
+ */
+ decline (dependency: string): void
+ /**
+ * Flag the current module as not update-able. If updated the update code would fail with code "decline".
+ */
+ decline (): void
+ /**
+ * Add a one time handler, which is executed when the current module code is replaced.
+ * Here you should destroy/remove any persistent resource you have claimed/created.
+ * If you want to transfer state to the new module, add it to data object.
+ * The data will be available at module.hot.data on the new module.
+ * @param callback
+ */
+ dispose (callback: (data: any) => void): void
+ dispose (callback: <T>(data: T) => void): void
+ /**
+ * Add a one time handler, which is executed when the current module code is replaced.
+ * Here you should destroy/remove any persistent resource you have claimed/created.
+ * If you want to transfer state to the new module, add it to data object.
+ * The data will be available at module.hot.data on the new module.
+ * @param callback
+ */
+ addDisposeHandler (callback: (data: any) => void): void
+ addDisposeHandler<T> (callback: (data: T) => void): void
+ /**
+ * Remove a handler.
+ * This can useful to add a temporary dispose handler. You could i. e. replace code while in the middle of a multi-step async function.
+ * @param callback
+ */
+ removeDisposeHandler (callback: (data: any) => void): void
+ removeDisposeHandler<T> (callback: (data: T) => void): void
+ /**
+ * Throws an exceptions if status() is not idle.
+ * Check all currently loaded modules for updates and apply updates if found.
+ * If no update was found, the callback is called with null.
+ * If autoApply is truthy the callback will be called with all modules that were disposed.
+ * apply() is automatically called with autoApply as options parameter.
+ * If autoApply is not set the callback will be called with all modules that will be disposed on apply().
+ * @param autoApply
+ * @param callback
+ */
+ check (autoApply: boolean, callback: (err: Error, outdatedModules: WebpackModuleId[]) => void): void
+ /**
+ * Throws an exceptions if status() is not idle.
+ * Check all currently loaded modules for updates and apply updates if found.
+ * If no update was found, the callback is called with null.
+ * The callback will be called with all modules that will be disposed on apply().
+ * @param callback
+ */
+ check (callback: (err: Error, outdatedModules: WebpackModuleId[]) => void): void
+ /**
+ * If status() != "ready" it throws an error.
+ * Continue the update process.
+ * @param options
+ * @param callback
+ */
+ apply (options: AcceptOptions, callback: (err: Error, outdatedModules: WebpackModuleId[]) => void): void
+ /**
+ * If status() != "ready" it throws an error.
+ * Continue the update process.
+ * @param callback
+ */
+ apply (callback: (err: Error, outdatedModules: WebpackModuleId[]) => void): void
+ /**
+ * Return one of idle, check, watch, watch-delay, prepare, ready, dispose, apply, abort or fail.
+ */
+ status (): string
+ /** Register a callback on status change. */
+ status (callback: (status: string) => void): void
+ /** Register a callback on status change. */
+ addStatusHandler (callback: (status: string) => void): void
+ /**
+ * Remove a registered status change handler.
+ * @param callback
+ */
+ removeStatusHandler (callback: (status: string) => void): void
+
+ active: boolean
+ data: any
+}
+
+export interface WebpackImportMeta {
+ /** an alias for `module.hot` - see https://webpack.js.org/api/hot-module-replacement/ */
+ webpackHot?: WebpackHot | undefined
+
+ /** the webpack major version as number */
+ webpack?: number
+}
diff --git a/packages/schema/src/types/compatibility.ts b/packages/schema/src/types/compatibility.ts
new file mode 100644
index 000000000000..209b373072c5
--- /dev/null
+++ b/packages/schema/src/types/compatibility.ts
@@ -0,0 +1,42 @@
+export interface NuxtCompatibility {
+ /**
+ * Required nuxt version in semver format.
+ * @example `^3.2.0` or `>=3.13.0`.
+ */
+ nuxt?: string
+
+ /**
+ * Mark a builder as incompatible, or require a particular version.
+ *
+ * @example
+ * ```ts
+ * export default defineNuxtModule({
+ * meta: {
+ * name: 'my-module',
+ * compatibility: {
+ * builder: {
+ * // marking as incompatible
+ * webpack: false,
+ * // you can require a (semver-compatible) version
+ * vite: '^5'
+ * }
+ * }
+ * }
+ * // ...
+ * })
+ * ```
+ */
+ builder?: Partial<Record<'vite' | 'webpack' | 'rspack' | (string & {}), false | string>>
+}
+
+export interface NuxtCompatibilityIssue {
+ name: string
+ message: string
+}
+
+export interface NuxtCompatibilityIssues extends Array<NuxtCompatibilityIssue> {
+ /**
+ * Return formatted error message.
+ */
+ toString(): string
+}
diff --git a/packages/schema/src/types/compiler.ts b/packages/schema/src/types/compiler.ts
new file mode 100644
index 000000000000..777d5debd690
--- /dev/null
+++ b/packages/schema/src/types/compiler.ts
@@ -0,0 +1,72 @@
+import type { JavascriptExtension } from '../utils/definition.ts'
+
+export interface KeyedFunction {
+ /**
+ * The name of the function.
+ *
+ * Use 'default' to target a module's default export. In that case, the callable name
+ * is derived from the filename (camel-cased) for matching during analysis.
+ */
+ name: string
+ /**
+ * The path to the file where the function is defined.
+ * You can use Nuxt aliases (~ or @) to refer to directories inside the project or directly use an npm package path similar to require.
+ */
+ source: string
+ /**
+ * The maximum number of arguments the function can accept.
+ * In the case that the function is called with fewer arguments than this number,
+ * the compiler will inject an auto-generated key as an additional argument.
+ *
+ * The key is unique based on the location of the function being invoked within the file.
+ *
+ * @example `{ name: 'useKey', source: '~/composables/useKey', argumentLength: 2 }`
+ *
+ * ```ts
+ * useKey() // will be transformed to: useKey('\$KzLSZ0O59L')
+ * useKey('first') // will be transformed to: useKey('first', '\$KzLSZ0O59L')
+ * useKey('first', 'second') // will not be transformed
+ * ```
+ */
+ argumentLength: number
+}
+
+export interface KeyedFunctionFactory extends Pick<KeyedFunction, 'argumentLength'> {
+ /**
+ * The name of the factory function.
+ * @example 'createUseFetch'
+ */
+ name: string
+ source: string
+}
+
+export interface NuxtCompilerOptions {
+ /**
+ * Enable scanning of directories for Nuxt compiler transformations.
+ */
+ scan?: boolean
+}
+
+export interface CompilerScanDir {
+ /**
+ * Path (absolute or relative) to the directory to scan for files.
+ * Relative paths are resolved against the Nuxt source directory of the project.
+ *
+ * You can use Nuxt aliases (~ or @) to refer to directories inside the project or directly use an NPM package path similar to `require()`.
+ */
+ path: string
+ /**
+ * The file extensions to scan in the specified path.
+ *
+ * This has no effect if `pattern` is specified.
+ */
+ extensions?: (JavascriptExtension | (string & {}))[]
+ /**
+ * Accept Pattern that will be run against the specified path.
+ */
+ pattern?: string | string[]
+ /**
+ * Ignore patterns that will be run against the specified path.
+ */
+ ignore?: string[]
+}
diff --git a/packages/schema/src/types/components.ts b/packages/schema/src/types/components.ts
new file mode 100644
index 000000000000..3f0952f44752
--- /dev/null
+++ b/packages/schema/src/types/components.ts
@@ -0,0 +1,121 @@
+import type { CompilerScanDir } from './compiler.ts'
+import type { AugmentProperty, VueExtension } from '../utils/definition.ts'
+
+export interface ComponentMeta {
+ [key: string]: unknown
+}
+
+export interface Component {
+ pascalName: string
+ kebabName: string
+ export: string
+ filePath: string
+ shortPath: string
+ chunkName: string
+ prefetch: boolean
+ preload: boolean
+ global?: boolean | 'sync'
+ island?: boolean
+ meta?: ComponentMeta
+ mode?: 'client' | 'server' | 'all'
+ /**
+ * This number allows configuring the behavior of overriding Nuxt components.
+ * If multiple components are provided with the same name, then higher priority
+ * components will be used instead of lower priority components.
+ */
+ priority?: number
+ /**
+ * Path to component's declaration file
+ * Used for type generation when different from filePath
+ * @default filePath
+ */
+ declarationPath?: string
+ /**
+ * Allow bypassing client/server transforms for internal Nuxt components like
+ * ServerPlaceholder and NuxtClientFallback.
+ *
+ * @internal
+ */
+ _raw?: boolean
+}
+
+// TODO: Move component-related properties to ComponentsDir
+
+export interface ScanDir extends Omit<CompilerScanDir, 'extensions'> {
+ /**
+ * Prefix all matched components.
+ */
+ prefix?: string
+ /**
+ * Prefix component name by its path.
+ */
+ pathPrefix?: boolean
+ /**
+ * 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
+ */
+ prefetch?: boolean
+ /**
+ * 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
+ /**
+ * This flag indicates, component should be loaded async (with a separate chunk) regardless of using Lazy prefix or not.
+ */
+ isAsync?: boolean
+ extendComponent?: (component: Component) => Promise<Component | void> | (Component | void)
+ /**
+ * If enabled, registers components to be globally available.
+ *
+ */
+ global?: boolean
+ /**
+ * If enabled, registers components as islands
+ */
+ island?: boolean
+}
+
+export interface ComponentsDir extends ScanDir, AugmentProperty<Pick<CompilerScanDir, 'extensions'>, 'extensions', VueExtension> {
+ /**
+ * Watch specified path for changes, including file additions and file deletions.
+ */
+ watch?: boolean
+ /**
+ * Transpile specified path using build.transpile.
+ * By default ('auto') it will set transpile: true if node_modules/ is in path.
+ */
+ transpile?: 'auto' | boolean
+ /**
+ * This number allows configuring the behavior of overriding Nuxt components.
+ * It will be inherited by any components within the directory.
+ *
+ * If multiple components are provided with the same name, then higher priority
+ * components will be used instead of lower priority components.
+ */
+ priority?: number
+}
+
+export interface ComponentsOptions {
+ dirs: (string | ComponentsDir)[]
+ /**
+ * The default value for whether to globally register components.
+ *
+ * When components are registered globally, they will still be directly imported where used,
+ * but they can also be used dynamically, for example `<component :is="`icon-${myIcon}`">`.
+ *
+ * This can be overridden by an individual component directory entry.
+ */
+ global?: boolean
+ /**
+ * Whether to write metadata to the build directory with information about the components that
+ * are auto-registered in your app.
+ */
+ generateMetadata?: boolean
+ loader?: boolean
+
+ transform?: {
+ exclude?: RegExp[]
+ include?: RegExp[]
+ }
+}
diff --git a/packages/schema/src/types/config.ts b/packages/schema/src/types/config.ts
new file mode 100644
index 000000000000..8fee3cea7ecd
--- /dev/null
+++ b/packages/schema/src/types/config.ts
@@ -0,0 +1,190 @@
+import type { KeepAliveProps, TransitionProps, AppConfig as VueAppConfig } from 'vue'
+import type { ServerOptions as ViteServerOptions, UserConfig as ViteUserConfig } from 'vite'
+import type { Options as VuePluginOptions } from '@vitejs/plugin-vue'
+import type { Options as VueJsxPluginOptions } from '@vitejs/plugin-vue-jsx'
+import type { SchemaDefinition } from 'untyped'
+import type { SnakeCase } from 'scule'
+import type { ConfigLayerMeta, DefineConfig, ResolvedConfig, UserInputConfig } from 'c12'
+import type { RouteLocationNormalizedGeneric } from 'vue-router'
+import type { ConfigSchema } from './schema.ts'
+import type { Nuxt } from './nuxt.ts'
+import type { AppHeadMetaObject } from './head.ts'
+
+export type { SchemaDefinition } from 'untyped'
+
+// eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+type DeepPartial<T> = T extends Function ? T : T extends Record<string, any> ? { [P in keyof T]?: DeepPartial<T[P]> } : T
+
+export type UpperSnakeCase<S extends string> = Uppercase<SnakeCase<S>>
+
+const message: symbol = Symbol('message')
+export type RuntimeValue<T, B extends string> = T & { [message]?: B } | T
+type Overrideable<T extends Record<string, any>, Path extends string = ''> = {
+ [K in keyof T]?: K extends string
+ ? unknown extends T[K]
+ ? unknown
+ : T[K] extends Record<string, unknown>
+ ? RuntimeValue<Overrideable<T[K], `${Path}_${UpperSnakeCase<K>}`>, `You can override this value at runtime with NUXT${Path}_${UpperSnakeCase<K>}`>
+ : RuntimeValue<T[K], `You can override this value at runtime with NUXT${Path}_${UpperSnakeCase<K>}`>
+ : K extends number
+ ? T[K]
+ : never
+}
+
+// Runtime Config
+
+type RuntimeConfigNamespace = Record<string, unknown>
+
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type
+export interface PublicRuntimeConfig extends RuntimeConfigNamespace { }
+
+export interface RuntimeConfig extends RuntimeConfigNamespace {
+ public: PublicRuntimeConfig
+}
+
+// Avoid DeepPartial for some problematic config, including:
+// - nitro config interface (#31908) located in packages/nitro-server/src/augments.ts
+// - vite config interface (#4772)
+
+/**
+ * User configuration in `nuxt.config` file
+ */
+export interface NuxtConfig extends DeepPartial<Omit<ConfigSchema, 'components' | 'vue' | 'vite' | 'runtimeConfig' | 'webpack' | 'nitro'>> {
+ components?: ConfigSchema['components']
+ vue?: Omit<DeepPartial<ConfigSchema['vue']>, 'config'> & { config?: Partial<Filter<VueAppConfig, string | boolean>> }
+ vite?: ConfigSchema['vite']
+ runtimeConfig?: Overrideable<RuntimeConfig>
+ webpack?: DeepPartial<ConfigSchema['webpack']> & {
+ $client?: DeepPartial<ConfigSchema['webpack']>
+ $server?: DeepPartial<ConfigSchema['webpack']>
+ }
+
+ /**
+ * Experimental custom config schema
+ * @see [Nuxt Issue #15592](https://github.com/nuxt/nuxt/issues/15592)
+ */
+ $schema?: SchemaDefinition
+}
+
+export type NuxtConfigLayer = ResolvedConfig<NuxtConfig & {
+ srcDir: ConfigSchema['srcDir']
+ rootDir: ConfigSchema['rootDir']
+}> & {
+ cwd: string
+ configFile: string
+}
+
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type
+export interface DefineNuxtConfig<Config extends UserInputConfig = NuxtConfig> extends DefineConfig<Config, ConfigLayerMeta> {}
+
+export interface NuxtBuilder {
+ bundle: (nuxt: Nuxt) => Promise<void>
+ /**
+ * Optional. If provided and the user opts in via `experimental.watcher: 'builder'`,
+ * Nuxt will call this instead of starting its own file watcher in dev mode,
+ * allowing the builder to reuse its own watcher.
+ *
+ * The builder is expected to register its own `nuxt.hook('close', ...)` to
+ * clean up any resources it allocates.
+ */
+ setupWatcher?: (nuxt: Nuxt) => Promise<void> | void
+}
+
+// Normalized Nuxt options available as `nuxt.options.*`
+export interface NuxtOptions extends Omit<ConfigSchema, 'vue' | 'sourcemap' | 'debug' | 'builder' | 'postcss' | 'webpack'> {
+ vue: Omit<ConfigSchema['vue'], 'config'> & { config?: Partial<Filter<VueAppConfig, string | boolean>> }
+ sourcemap: Required<Exclude<ConfigSchema['sourcemap'], boolean>>
+ debug: Required<Exclude<ConfigSchema['debug'], true>>
+ builder: '@nuxt/vite-builder' | '@nuxt/webpack-builder' | '@nuxt/rspack-builder' | NuxtBuilder
+ postcss: Omit<ConfigSchema['postcss'], 'order'> & { order: Exclude<ConfigSchema['postcss']['order'], string> }
+ webpack: ConfigSchema['webpack'] & {
+ $client: ConfigSchema['webpack']
+ $server: ConfigSchema['webpack']
+ }
+ _layers: readonly NuxtConfigLayer[]
+ $schema: SchemaDefinition
+}
+
+export interface ViteConfig extends Omit<ViteUserConfig, 'publicDir'> {
+ /** The path to the entrypoint for the Vite build. */
+ entry?: string
+ /**
+ * Options passed to @vitejs/plugin-vue.
+ * @see [@vitejs/plugin-vue](https://github.com/vitejs/vite-plugin-vue/tree/main/packages/plugin-vue)
+ */
+ vue?: VuePluginOptions
+
+ /**
+ * Options passed to @vitejs/plugin-vue-jsx.
+ * @see [@vitejs/plugin-vue-jsx.](https://github.com/vitejs/vite-plugin-vue/tree/main/packages/plugin-vue-jsx)
+ */
+ vueJsx?: VueJsxPluginOptions
+
+ /**
+ * Warmup vite entrypoint caches on dev startup.
+ */
+ warmupEntry?: boolean
+
+ /**
+ * Use environment variables or top level `server` options to configure Nuxt server.
+ */
+ server?: Omit<ViteServerOptions, 'port' | 'host'>
+ /**
+ * Directly configuring the `vite.publicDir` option is not supported. Instead, set `dir.public`.
+ *
+ * You can read more in <https://nuxt.com/docs/4.x/api/nuxt-config#public>.
+ * @deprecated
+ */
+ publicDir?: never
+}
+
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type
+export interface ViteOptions extends ViteConfig {}
+
+// App Config
+export interface CustomAppConfig {
+ [key: string]: unknown
+}
+
+export interface AppConfigInput extends CustomAppConfig {
+ /** @deprecated reserved */
+ private?: never
+ /** @deprecated reserved */
+ nuxt?: never
+ /** @deprecated reserved */
+ nitro?: never
+ /** @deprecated reserved */
+ server?: never
+}
+
+// eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+export type Serializable<T> = T extends Function ? never : T extends Promise<infer U> ? Serializable<U> : T extends string & {} ? T : T extends Record<string, any> ? { [K in keyof T]: Serializable<T[K]> } : T
+
+type ValueOf<T> = T[keyof T]
+type Filter<T extends Record<string, any>, V> = Pick<T, ValueOf<{ [K in keyof T]: NonNullable<T[K]> extends V ? K : never }>>
+
+export interface NuxtAppConfig {
+ head: Serializable<AppHeadMetaObject>
+ layoutTransition: boolean | Serializable<TransitionProps>
+ pageTransition: boolean | Serializable<TransitionProps>
+ viewTransition?: ViewTransitionOptions['enabled'] | ViewTransitionOptions
+ keepalive: boolean | Serializable<KeepAliveProps>
+}
+
+export interface AppConfig {
+ [key: string]: unknown
+}
+
+export interface ViewTransitionOptions {
+ enabled: boolean | 'always'
+ types?: string[]
+}
+
+type ViewTransitionTypesFn = (to: RouteLocationNormalizedGeneric, from: RouteLocationNormalizedGeneric) => string[]
+
+export interface ViewTransitionPageOptions {
+ enabled?: boolean | 'always'
+ types?: string[] | ViewTransitionTypesFn
+ toTypes?: string[] | ViewTransitionTypesFn
+ fromTypes?: string[] | ViewTransitionTypesFn
+}
diff --git a/packages/schema/src/types/debug.ts b/packages/schema/src/types/debug.ts
new file mode 100644
index 000000000000..bdc964762254
--- /dev/null
+++ b/packages/schema/src/types/debug.ts
@@ -0,0 +1,46 @@
+import type { NuxtModule } from './module.ts'
+
+export interface NuxtDebugContext {
+ /**
+ * Module mutation records to the `nuxt` instance.
+ */
+ moduleMutationRecords?: NuxtDebugModuleMutationRecord[]
+}
+
+export interface NuxtDebugModuleMutationRecord {
+ module: NuxtModule
+ keys: (string | symbol)[]
+ target: 'nuxt.options'
+ value: any
+ method?: string
+ timestamp: number
+}
+
+export interface NuxtDebugOptions {
+ /** Debug for Nuxt templates */
+ templates?: boolean
+ /** Debug for modules setup timings */
+ modules?: boolean
+ /** Debug for file watchers */
+ watchers?: boolean
+ /** Debug for production hydration mismatch */
+ hydration?: boolean
+ /** Debug for Vue Router */
+ router?: boolean
+ /** Debug for hooks, can be set to `true` or an object with `server` and `client` keys */
+ hooks?: boolean | {
+ server?: boolean
+ client?: boolean
+ }
+ /**
+ * Profile startup/build performance.
+ *
+ * - `true` — full report printed to console, JSON + `.cpuprofile` written on exit
+ * - `'quiet'` — JSON + `.cpuprofile` written on exit with no console output
+ *
+ * Activated via `nuxi dev --profile=verbose`, `nuxi dev --profile` (quiet),
+ * `NUXT_DEBUG_PERF=1` (or `=quiet`), or `debug: { perf: true }` in nuxt.config.
+ * @since 4.4.0
+ */
+ perf?: boolean | 'quiet'
+}
diff --git a/packages/schema/src/types/head.ts b/packages/schema/src/types/head.ts
new file mode 100644
index 000000000000..13e61c8effc5
--- /dev/null
+++ b/packages/schema/src/types/head.ts
@@ -0,0 +1,18 @@
+import type { AriaAttributes, DataKeys, GlobalAttributes, SerializableHead } from '@unhead/vue/types'
+
+export type MetaObjectRaw = SerializableHead
+export type MetaObject = MetaObjectRaw
+
+export type AppHeadMetaObject = MetaObjectRaw & {
+ /**
+ * The character encoding in which the document is encoded => `<meta charset="<value>" />`
+ */
+ charset?: string
+ /**
+ * Configuration of the viewport (the area of the window in which web content can be seen),
+ * mapped to => `<meta name="viewport" content="<value>" />`
+ */
+ viewport?: string
+}
+
+export type SerializableHtmlAttributes = GlobalAttributes & AriaAttributes & DataKeys
diff --git a/packages/schema/src/types/hooks.ts b/packages/schema/src/types/hooks.ts
new file mode 100644
index 000000000000..83fbba891133
--- /dev/null
+++ b/packages/schema/src/types/hooks.ts
@@ -0,0 +1,476 @@
+import type { Server as HttpServer } from 'node:http'
+import type { Server as HttpsServer } from 'node:https'
+import type { TSConfig } from 'pkg-types'
+import type { ViteDevServer } from 'vite'
+import type { Manifest } from 'vue-bundle-renderer'
+import type { Import, InlinePreset, Preset, Unimport } from 'unimport'
+import type { Compiler, Configuration, Stats } from 'webpack'
+import type { Schema, SchemaDefinition } from 'untyped'
+import type { RouteLocationRaw, RouteRecordRaw } from 'vue-router'
+import type { RawVueCompilerOptions } from '@vue/language-core'
+import type { ViteConfig } from './config.ts'
+import type { NuxtCompatibility, NuxtCompatibilityIssues } from './compatibility.ts'
+import type { Component, ComponentsOptions } from './components.ts'
+import type { Nuxt, NuxtApp, ResolvedNuxtTemplate } from './nuxt.ts'
+
+export type HookResult = Promise<void> | void
+
+// https://www.typescriptlang.org/docs/handbook/triple-slash-directives.html
+export type TSReference = { types: string } | { path: string }
+
+export type WatchEvent = 'add' | 'addDir' | 'change' | 'unlink' | 'unlinkDir'
+
+// If the user does not have `@vue/language-core` installed, RawVueCompilerOptions will be typed as `any`,
+// thus making the whole `VueTSConfig` type `any`. We only augment TSConfig if RawVueCompilerOptions is available.
+export type VueTSConfig = 0 extends 1 & RawVueCompilerOptions ? TSConfig : TSConfig & { vueCompilerOptions?: RawVueCompilerOptions }
+
+export interface NuxtPage {
+ name?: string
+ path: string
+ props?: RouteRecordRaw['props']
+ file?: string
+ /**
+ * Named view files keyed by view name, including `default`. Populated by the
+ * page scanner from the `name@view.vue` filename convention. When set, the
+ * keys are wired up to vue-router's [`components`](https://router.vuejs.org/guide/essentials/named-views.html)
+ * option so multiple `<NuxtPage name="..." />` outlets can render.
+ */
+ components?: Record<string, string>
+ meta?: Record<string, any>
+ alias?: string[] | string
+ redirect?: RouteLocationRaw
+ children?: NuxtPage[]
+ middleware?: string[] | string
+ /**
+ * Set the render mode.
+ *
+ * `all` means the page will be rendered isomorphically - with JavaScript both on client and server.
+ *
+ * `server` means pages are automatically rendered with server components, so there will be no JavaScript to render the page in your client bundle.
+ *
+ * `client` means that page will render on the client-side only.
+ */
+ mode?: 'client' | 'server' | 'all'
+ /** @internal */
+ _sync?: boolean
+}
+
+export type NuxtMiddleware = {
+ name: string
+ path: string
+ global?: boolean
+}
+
+export type NuxtLayout = {
+ name: string
+ file: string
+}
+
+/**
+ * @deprecated Use {@link InlinePreset}
+ */
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type
+export interface ImportPresetWithDeprecation extends InlinePreset {
+}
+
+export interface GenerateAppOptions {
+ filter?: (template: ResolvedNuxtTemplate<any>) => boolean
+}
+
+export interface NuxtAnalyzeMeta {
+ name: string
+ slug: string
+ startTime: number
+ endTime: number
+ analyzeDir: string
+ buildDir: string
+ outDir: string
+}
+
+/**
+ * The listeners to Nuxt build time events
+ */
+export interface NuxtHooks {
+ // Kit
+ /**
+ * Allows extending compatibility checks.
+ * @param compatibility Compatibility object
+ * @param issues Issues to be mapped
+ * @returns Promise
+ */
+ 'kit:compatibility': (compatibility: NuxtCompatibility, issues: NuxtCompatibilityIssues) => HookResult
+
+ // Nuxt
+ /**
+ * Called after Nuxt initialization, when the Nuxt instance is ready to work.
+ * @param nuxt The configured Nuxt object
+ * @returns Promise
+ */
+ 'ready': (nuxt: Nuxt) => HookResult
+ /**
+ * Called when Nuxt instance is gracefully closing.
+ * @param nuxt The configured Nuxt object
+ * @returns Promise
+ */
+ 'close': (nuxt: Nuxt) => HookResult
+ /**
+ * Called to restart the current Nuxt instance.
+ * @returns Promise
+ */
+ 'restart': (options?: {
+ /**
+ * Try to restart the whole process if supported
+ */
+ hard?: boolean
+ }) => HookResult
+
+ /**
+ * Called during Nuxt initialization, before installing user modules.
+ * @returns Promise
+ */
+ 'modules:before': () => HookResult
+ /**
+ * Called during Nuxt initialization, after installing user modules.
+ * @returns Promise
+ */
+ 'modules:done': () => HookResult
+
+ /**
+ * Called after resolving the `app` instance.
+ * @param app The resolved `NuxtApp` object
+ * @returns Promise
+ */
+ 'app:resolve': (app: NuxtApp) => HookResult
+ /**
+ * Called during `NuxtApp` generation, to allow customizing, modifying or adding new files to the build directory (either virtually or to written to `.nuxt`).
+ * @param app The configured `NuxtApp` object
+ * @returns Promise
+ */
+ 'app:templates': (app: NuxtApp) => HookResult
+ /**
+ * Called after templates are compiled into the [virtual file system](https://nuxt.com/docs/4.x/directory-structure/nuxt) (vfs).
+ * @param app The configured `NuxtApp` object
+ * @returns Promise
+ */
+ 'app:templatesGenerated': (app: NuxtApp, templates: ResolvedNuxtTemplate[], options?: GenerateAppOptions) => HookResult
+
+ /**
+ * Called before Nuxt bundle builder.
+ * @returns Promise
+ */
+ 'build:before': () => HookResult
+ /**
+ * Called after Nuxt bundle builder is complete.
+ * @returns Promise
+ */
+ 'build:done': () => HookResult
+ /**
+ * 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.
+ * @param manifest The manifest object to build
+ * @returns Promise
+ */
+ 'build:manifest': (manifest: Manifest) => HookResult
+
+ /**
+ * Called when `nuxt analyze` is finished
+ * @param meta the analyze meta object, mutations will be saved to `meta.json`
+ * @returns Promise
+ */
+ 'build:analyze:done': (meta: NuxtAnalyzeMeta) => HookResult
+
+ /**
+ * Called before generating the app.
+ * @param options GenerateAppOptions object
+ * @returns Promise
+ */
+ 'builder:generateApp': (options?: GenerateAppOptions) => HookResult
+ /**
+ * Called at build time in development when the watcher spots a change to a file or directory in the project.
+ * @param event "add" | "addDir" | "change" | "unlink" | "unlinkDir"
+ * @param path the path to the watched file
+ * @returns Promise
+ */
+ 'builder:watch': (event: WatchEvent, path: string) => HookResult
+
+ /**
+ * Called after page routes are scanned from the file system.
+ * @param pages Array containing scanned pages
+ * @returns Promise
+ */
+ 'pages:extend': (pages: NuxtPage[]) => HookResult
+
+ /**
+ * Called after page routes have been augmented with scanned metadata.
+ * @param pages Array containing resolved pages
+ * @returns Promise
+ */
+ 'pages:resolved': (pages: NuxtPage[]) => HookResult
+
+ /**
+ * Called when resolving `app/router.options` files. It allows modifying the detected router options files
+ * and adding new ones.
+ *
+ * Later items in the array override earlier ones.
+ *
+ * Adding a router options file will switch on page-based routing, unless `optional` is set, in which case
+ * it will only apply when page-based routing is already enabled.
+ * @param context An object with `files` containing an array of router options files.
+ * @param context.files Array of router options files
+ * @returns Promise
+ */
+ 'pages:routerOptions': (context: { files: Array<{ path: string, optional?: boolean }> }) => HookResult
+
+ /**
+ * Called at setup allowing modules to extend sources.
+ * @param presets Array containing presets objects
+ * @returns Promise
+ */
+ 'imports:sources': (presets: Preset[]) => HookResult
+ /**
+ * Called at setup allowing modules to extend imports.
+ * @param imports Array containing the imports to extend
+ * @returns Promise
+ */
+ 'imports:extend': (imports: Import[]) => HookResult
+ /**
+ * Called when the [unimport](https://github.com/unjs/unimport) context is created.
+ * @param context The Unimport context
+ * @returns Promise
+ */
+ 'imports:context': (context: Unimport) => HookResult
+ /**
+ * Allows extending import directories.
+ * @param dirs Array containing directories as string
+ * @returns Promise
+ */
+ 'imports:dirs': (dirs: string[]) => HookResult
+
+ // Components
+ /**
+ * Called within `app:resolve` allowing to extend the directories that are scanned for auto-importable components.
+ * @param dirs The `dirs` option to push new items
+ * @returns Promise
+ */
+ 'components:dirs': (dirs: ComponentsOptions['dirs']) => HookResult
+ /**
+ * Allows extending new components.
+ * @param components The `components` array to push new items
+ * @returns Promise
+ */
+ 'components:extend': (components: Component[]) => HookResult
+
+ /**
+ * Allows extending the routes to be pre-rendered.
+ * @param ctx Nuxt context
+ * @param ctx.routes Set of routes to be pre-rendered
+ * @returns Promise
+ */
+ 'prerender:routes': (ctx: { routes: Set<string> }) => HookResult
+
+ // @nuxt/cli
+ /**
+ * Called when an error occurs at build time.
+ * @param error Error object
+ * @returns Promise
+ */
+ 'build:error': (error: Error) => HookResult
+ /**
+ * Called before @nuxt/cli writes `.nuxt/tsconfig.json` and `.nuxt/nuxt.d.ts`, allowing addition of custom references and declarations in `nuxt.d.ts`, or directly modifying the options in `tsconfig.json`
+ * @param options Objects containing `references`, `declarations`, `tsConfig`
+ * @param options.references Array of TypeScript references to add
+ * @param options.declarations Array of declaration strings to add
+ * @param options.tsConfig The Vue TypeScript config object
+ * @param options.nodeTsConfig The Node TypeScript config object
+ * @param options.nodeReferences Array of Node TypeScript references
+ * @param options.sharedTsConfig The shared TypeScript config object
+ * @param options.sharedReferences Array of shared TypeScript references
+ * @returns Promise
+ */
+ 'prepare:types': (options: { references: TSReference[], declarations: string[], tsConfig: VueTSConfig, nodeTsConfig: TSConfig, nodeReferences: TSReference[], sharedTsConfig: TSConfig, sharedReferences: TSReference[] }) => HookResult
+ /**
+ * Called when the dev server is loading.
+ * @param listenerServer The HTTP/HTTPS server object
+ * @param listener The server's listener object
+ * @returns Promise
+ */
+ 'listen': (listenerServer: HttpServer | HttpsServer, listener: any) => HookResult
+
+ // Schema
+ /**
+ * Allows extending default schemas.
+ * @param schemas Schemas to be extend
+ * @returns void
+ */
+ 'schema:extend': (schemas: SchemaDefinition[]) => void
+ /**
+ * Allows extending resolved schema.
+ * @param schema Schema object
+ * @returns void
+ */
+ 'schema:resolved': (schema: Schema) => void
+ /**
+ * Called before writing the given schema.
+ * @param schema Schema object
+ * @returns void
+ */
+ 'schema:beforeWrite': (schema: Schema) => void
+ /**
+ * Called after the schema is written.
+ * @returns void
+ */
+ 'schema:written': () => void
+
+ // Vite
+ /**
+ * Allows to extend Vite default context.
+ * @param viteBuildContext The vite build context object
+ * @param viteBuildContext.nuxt The Nuxt instance
+ * @param viteBuildContext.config The Vite config object
+ * @returns Promise
+ */
+ 'vite:extend': (viteBuildContext: { nuxt: Nuxt, config: ViteConfig }) => HookResult
+ /**
+ * Allows to extend Vite default config.
+ * @param viteInlineConfig The vite inline config object
+ * @param env Server or client
+ * @param env.isClient Whether the config is for the client build
+ * @param env.isServer Whether the config is for the server build
+ * @returns Promise
+ * @deprecated
+ */
+ 'vite:extendConfig': (viteInlineConfig: Readonly<ViteConfig>, env: { isClient: boolean, isServer: boolean }) => HookResult
+ /**
+ * Allows to read the resolved Vite config.
+ * @param viteInlineConfig The vite inline config object
+ * @param env Server or client
+ * @param env.isClient Whether the config is for the client build
+ * @param env.isServer Whether the config is for the server build
+ * @returns Promise
+ * @deprecated
+ */
+ 'vite:configResolved': (viteInlineConfig: Readonly<ViteConfig>, env: { isClient: boolean, isServer: boolean }) => HookResult
+ /**
+ * Called when the Vite server is created.
+ * @param viteServer Vite development server
+ * @param env Server or client
+ * @param env.isClient Whether the server is for the client build
+ * @param env.isServer Whether the server is for the server build
+ * @returns Promise
+ */
+ 'vite:serverCreated': (viteServer: ViteDevServer, env: { isClient: boolean, isServer: boolean }) => HookResult
+ /**
+ * Called after Vite server is compiled.
+ * @returns Promise
+ */
+ 'vite:compiled': () => HookResult
+
+ // webpack
+ /**
+ * Called before configuring the webpack compiler.
+ * @param webpackConfigs Configs objects to be pushed to the compiler
+ * @returns Promise
+ */
+ 'webpack:config': (webpackConfigs: Configuration[]) => HookResult
+ /**
+ * Allows to read the resolved webpack config
+ * @param webpackConfigs Configs objects to be pushed to the compiler
+ * @returns Promise
+ */
+ 'webpack:configResolved': (webpackConfigs: Readonly<Configuration>[]) => HookResult
+ /**
+ * Called right before compilation.
+ * @param options The options to be added
+ * @param options.name The name of the compiler
+ * @param options.compiler The webpack compiler instance
+ * @returns Promise
+ */
+ 'webpack:compile': (options: { name: string, compiler: Compiler }) => HookResult
+ /**
+ * Called after resources are loaded.
+ * @param options The compiler options
+ * @param options.name The name of the compiler
+ * @param options.compiler The webpack compiler instance
+ * @param options.stats The webpack compilation stats
+ * @returns Promise
+ */
+ 'webpack:compiled': (options: { name: string, compiler: Compiler, stats: Stats }) => HookResult
+
+ /**
+ * Called on `change` on WebpackBar.
+ * @param shortPath the short path
+ * @returns void
+ */
+ 'webpack:change': (shortPath: string) => void
+ /**
+ * Called on `done` if has errors on WebpackBar.
+ * @returns void
+ */
+ 'webpack:error': () => void
+ /**
+ * Called on `allDone` on WebpackBar.
+ * @returns void
+ */
+ 'webpack:done': () => void
+ /**
+ * Called on `progress` on WebpackBar.
+ * @param statesArray The array containing the states on progress
+ * @returns void
+ */
+ 'webpack:progress': (statesArray: any[]) => void
+
+ // rspack
+ /**
+ * Called before configuring the webpack compiler.
+ * @param webpackConfigs Configs objects to be pushed to the compiler
+ * @returns Promise
+ */
+ 'rspack:config': (webpackConfigs: Configuration[]) => HookResult
+ /**
+ * Allows to read the resolved webpack config
+ * @param webpackConfigs Configs objects to be pushed to the compiler
+ * @returns Promise
+ */
+ 'rspack:configResolved': (webpackConfigs: Readonly<Configuration>[]) => HookResult
+ /**
+ * Called right before compilation.
+ * @param options The options to be added
+ * @param options.name The name of the compiler
+ * @param options.compiler The rspack compiler instance
+ * @returns Promise
+ */
+ 'rspack:compile': (options: { name: string, compiler: Compiler }) => HookResult
+ /**
+ * Called after resources are loaded.
+ * @param options The compiler options
+ * @param options.name The name of the compiler
+ * @param options.compiler The rspack compiler instance
+ * @param options.stats The rspack compilation stats
+ * @returns Promise
+ */
+ 'rspack:compiled': (options: { name: string, compiler: Compiler, stats: Stats }) => HookResult
+
+ /**
+ * Called on `change` on WebpackBar.
+ * @param shortPath the short path
+ * @returns void
+ */
+ 'rspack:change': (shortPath: string) => void
+ /**
+ * Called on `done` if has errors on WebpackBar.
+ * @returns void
+ */
+ 'rspack:error': () => void
+ /**
+ * Called on `allDone` on WebpackBar.
+ * @returns void
+ */
+ 'rspack:done': () => void
+ /**
+ * Called on `progress` on WebpackBar.
+ * @param statesArray The array containing the states on progress
+ * @returns void
+ */
+ 'rspack:progress': (statesArray: any[]) => void
+}
+
+export type NuxtHookName = keyof NuxtHooks
diff --git a/packages/schema/src/types/imports.ts b/packages/schema/src/types/imports.ts
new file mode 100644
index 000000000000..6f6ab3f8a962
--- /dev/null
+++ b/packages/schema/src/types/imports.ts
@@ -0,0 +1,36 @@
+import type { UnimportOptions } from 'unimport'
+
+export interface ImportsOptions extends UnimportOptions {
+ /**
+ * Enable implicit auto import from Vue, Nuxt and module contributed utilities.
+ * Generate global TypeScript definitions.
+ */
+ autoImport?: boolean
+
+ /**
+ * Directories to scan for auto imports.
+ * @see https://nuxt.com/docs/4.x/directory-structure/app/composables#how-files-are-scanned
+ */
+ dirs?: string[]
+
+ /**
+ * Enabled scan for local directories for auto imports.
+ * When this is disabled, `dirs` options will be ignored.
+ */
+ scan?: boolean
+
+ /**
+ * Assign auto imported utilities to `globalThis` instead of using built time transformation.
+ */
+ global?: boolean
+
+ transform?: {
+ exclude?: RegExp[]
+ include?: RegExp[]
+ }
+
+ /**
+ * Add polyfills for setInterval, requestIdleCallback, and others
+ */
+ polyfills?: boolean
+}
diff --git a/packages/schema/src/types/module.ts b/packages/schema/src/types/module.ts
new file mode 100644
index 000000000000..03e6bc3d171a
--- /dev/null
+++ b/packages/schema/src/types/module.ts
@@ -0,0 +1,135 @@
+import type { Defu } from 'defu'
+import type { NuxtHooks } from './hooks.ts'
+import type { Nuxt } from './nuxt.ts'
+import type { NuxtCompatibility } from './compatibility.ts'
+
+export interface ModuleMeta {
+ /** Module name. */
+ name?: string
+
+ /** Module version. */
+ version?: string
+
+ /**
+ * The configuration key used within `nuxt.config` for this module's options.
+ * For example, `@nuxtjs/axios` uses `axios`.
+ */
+ configKey?: string
+
+ /**
+ * Constraints for the versions of Nuxt or features this module requires.
+ */
+ compatibility?: NuxtCompatibility
+
+ /**
+ * Fully resolved path used internally by Nuxt. Do not depend on this value.
+ * @internal
+ */
+ rawPath?: string
+
+ /**
+ * Whether the module has been disabled in the Nuxt configuration.
+ * @internal
+ */
+ disabled?: boolean
+
+ [key: string]: unknown
+}
+
+/** The options received. */
+export type ModuleOptions = Record<string, any>
+
+export type ModuleSetupInstallResult = {
+ /**
+ * Timing information for the initial setup
+ */
+ timings?: {
+ /** Total time took for module setup in ms */
+ setup?: number
+ [key: string]: number | undefined
+ }
+}
+
+type Awaitable<T> = T | Promise<T>
+
+type Prettify<T> = {
+ [K in keyof T]: T[K];
+} & {}
+
+export type ModuleSetupReturn = Awaitable<false | void | ModuleSetupInstallResult>
+
+export type ResolvedModuleOptions<
+ TOptions extends ModuleOptions,
+ TOptionsDefaults extends Partial<TOptions>,
+> =
+ Prettify<
+ Defu<
+ Partial<TOptions>,
+ [Partial<TOptions>, TOptionsDefaults]
+ >
+ >
+
+export interface ModuleDependencyMeta<T = Record<string, unknown>> {
+ version?: string
+ overrides?: Partial<T>
+ defaults?: Partial<T>
+ optional?: boolean
+}
+
+export interface ModuleDependencies {
+ [key: string]: ModuleDependencyMeta<Record<string, unknown>>
+}
+
+/** Module definition passed to 'defineNuxtModule(...)' or 'defineNuxtModule().with(...)'. */
+export interface ModuleDefinition<
+ TOptions extends ModuleOptions,
+ TOptionsDefaults extends Partial<TOptions>,
+ TWith extends boolean,
+> {
+ meta?: ModuleMeta
+ defaults?: TOptionsDefaults | ((nuxt: Nuxt) => Awaitable<TOptionsDefaults>)
+ schema?: TOptions
+ hooks?: Partial<NuxtHooks>
+ moduleDependencies?: ModuleDependencies | ((nuxt: Nuxt) => Awaitable<ModuleDependencies>)
+ onInstall?: (nuxt: Nuxt) => Awaitable<void>
+ onUpgrade?: (nuxt: Nuxt, options: TOptions, previousVersion: string) => Awaitable<void>
+ setup?: (
+ this: void,
+ resolvedOptions: TWith extends true
+ ? ResolvedModuleOptions<TOptions, TOptionsDefaults>
+ : TOptions,
+ nuxt: Nuxt,
+ ) => ModuleSetupReturn
+}
+
+export interface NuxtModule<
+ TOptions extends ModuleOptions = ModuleOptions,
+ TOptionsDefaults extends Partial<TOptions> = Partial<TOptions>,
+ TWith extends boolean = false,
+> {
+ (
+ this: void,
+ resolvedOptions: TWith extends true
+ ? ResolvedModuleOptions<TOptions, TOptionsDefaults>
+ : TOptions,
+ nuxt: Nuxt
+ ): ModuleSetupReturn
+ getOptions?: (
+ inlineOptions?: Partial<TOptions>,
+ nuxt?: Nuxt,
+ ) => Promise<
+ TWith extends true
+ ? ResolvedModuleOptions<TOptions, TOptionsDefaults>
+ : TOptions
+ >
+ getModuleDependencies?: (nuxt: Nuxt) => Awaitable<ModuleDependencies> | undefined
+ getMeta?: () => Promise<ModuleMeta>
+ onInstall?: (nuxt: Nuxt) => Awaitable<void>
+ onUpgrade?: (
+ nuxt: Nuxt,
+ options: TWith extends true
+ ? ResolvedModuleOptions<TOptions, TOptionsDefaults>
+ : TOptions,
+ previousVersion: string,
+ ) => Awaitable<void>
+}
diff --git a/packages/schema/src/types/nuxt.ts b/packages/schema/src/types/nuxt.ts
new file mode 100644
index 000000000000..cbe660952f2f
--- /dev/null
+++ b/packages/schema/src/types/nuxt.ts
@@ -0,0 +1,135 @@
+import type { AsyncLocalStorage } from 'node:async_hooks'
+import type { Hookable } from 'hookable'
+import type { Ignore } from 'ignore'
+import type { NuxtModule } from './module.ts'
+import type { NuxtHooks, NuxtLayout, NuxtMiddleware, NuxtPage } from './hooks.ts'
+import type { Component } from './components.ts'
+import type { NuxtOptions } from './config.ts'
+import type { NuxtDebugContext } from './debug.ts'
+
+export interface NuxtPlugin {
+ /** @deprecated use mode */
+ ssr?: boolean
+ src: string
+ mode?: 'all' | 'server' | 'client'
+ /**
+ * This allows more granular control over plugin order and should only be used by advanced users.
+ * Lower numbers run first, and user plugins default to `0`.
+ *
+ * Default Nuxt priorities can be seen at [here](https://github.com/nuxt/nuxt/blob/9904849bc87c53dfbd3ea3528140a5684c63c8d8/packages/nuxt/src/core/plugins/plugin-metadata.ts#L15-L34).
+ */
+ order?: number
+ /**
+ * @internal
+ */
+ name?: string
+}
+
+// Internal type for simpler NuxtTemplate interface extension
+
+type TemplateDefaultOptions = Record<string, any>
+
+export interface NuxtTemplate<Options = TemplateDefaultOptions> {
+ /** resolved output file path (generated) */
+ dst?: string
+ /** The target filename once the template is copied into the Nuxt buildDir */
+ filename?: string
+ /** An options object that will be accessible within the template via `<% options %>` */
+ options?: Options
+ /** The resolved path to the source file to be template */
+ src?: string
+ /** Provided compile option instead of src */
+
+ getContents?: (data: { nuxt: Nuxt, app: NuxtApp, options: Options }) => string | Promise<string>
+ /** Write to filesystem */
+ write?: boolean
+ /**
+ * The source path of the template (to try resolving dependencies from).
+ * @internal
+ */
+ _path?: string
+}
+
+export interface NuxtServerTemplate {
+ /** The target filename once the template is copied into the Nuxt buildDir */
+ filename: string
+ getContents: () => string | Promise<string>
+}
+
+export interface ResolvedNuxtTemplate<Options = TemplateDefaultOptions> extends NuxtTemplate<Options> {
+ filename: string
+ dst: string
+ modified?: boolean
+}
+
+export interface NuxtTypeTemplate<Options = TemplateDefaultOptions> extends Omit<NuxtTemplate<Options>, 'write' | 'filename'> {
+ filename: `${string}.d.ts`
+ write?: true
+}
+
+type _TemplatePlugin<Options> = Omit<NuxtPlugin, 'src'> & NuxtTemplate<Options>
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type
+export interface NuxtPluginTemplate<Options = TemplateDefaultOptions> extends _TemplatePlugin<Options> { }
+
+export interface NuxtApp {
+ mainComponent?: string | null
+ rootComponent?: string | null
+ errorComponent?: string | null
+ dir: string
+ extensions: string[]
+ plugins: NuxtPlugin[]
+ components: Component[]
+ layouts: Record<string, NuxtLayout>
+ middleware: NuxtMiddleware[]
+ templates: NuxtTemplate[]
+ configs: string[]
+ pages?: NuxtPage[]
+}
+
+export interface Nuxt {
+ // Private fields.
+ '__name': string
+ '_version': string
+ '_ignore'?: Ignore
+ '_dependencies'?: Set<string>
+ '~runtimeDependencies'?: string[]
+ '_debug'?: NuxtDebugContext
+ /**
+ * Performance profiler instance, available when `debug.perf` is enabled.
+ * @internal
+ */
+ '_perf'?: {
+ startPhase: (name: string) => void
+ endPhase: (name?: string) => void
+ collectModuleTimings: (modules: Array<{ meta?: { name?: string }, timings?: Record<string, number | undefined> }>) => void
+ recordBundlerPluginHook: (pluginName: string, hookName: string, durationMs: number, startTime?: number) => void
+ printReport: (options?: { title?: string }) => void
+ writeReport: (buildDir: string, options?: { quiet?: boolean }) => string
+ dispose: () => void
+ }
+ /** Async local storage for current running Nuxt module instance. */
+ '_asyncLocalStorageModule'?: AsyncLocalStorage<NuxtModule>
+ /**
+ * Module options functions collected from moduleDependencies.
+ * @internal
+ */
+ '_moduleOptionsFunctions'?: Map<string | NuxtModule, Array<() => { defaults?: Record<string, unknown>, overrides?: Record<string, unknown> }>>
+
+ /** The resolved Nuxt configuration. */
+ 'options': NuxtOptions
+ 'hooks': Hookable<NuxtHooks>
+ 'hook': Nuxt['hooks']['hook']
+ 'callHook': Nuxt['hooks']['callHook']
+ 'addHooks': Nuxt['hooks']['addHooks']
+ 'runWithContext': <T extends (...args: any[]) => any>(fn: T) => ReturnType<T>
+
+ 'ready': () => Promise<void>
+ 'close': () => Promise<void>
+
+ /** The production or development server. */
+ 'server'?: any
+
+ 'vfs': Record<string, string>
+
+ 'apps': Record<string, NuxtApp>
+}
diff --git a/packages/schema/src/types/router.ts b/packages/schema/src/types/router.ts
new file mode 100644
index 000000000000..950a46df3220
--- /dev/null
+++ b/packages/schema/src/types/router.ts
@@ -0,0 +1,15 @@
+import type { RouterHistory, RouterOptions as _RouterOptions } from 'vue-router'
+
+export type RouterOptions = Partial<Omit<_RouterOptions, 'history' | 'routes'>> & {
+ history?: (baseURL?: string) => RouterHistory | null | undefined
+ routes?: (_routes: _RouterOptions['routes']) => _RouterOptions['routes'] | Promise<_RouterOptions['routes']>
+ hashMode?: boolean
+ scrollBehaviorType?: 'smooth' | 'auto'
+}
+
+export type RouterConfig = RouterOptions
+
+/**
+ * Only JSON serializable router options are configurable from nuxt config
+ */
+export type RouterConfigSerializable = Pick<RouterConfig, 'linkActiveClass' | 'linkExactActiveClass' | 'end' | 'sensitive' | 'strict' | 'hashMode' | 'scrollBehaviorType'>
diff --git a/packages/schema/src/types/schema.ts b/packages/schema/src/types/schema.ts
new file mode 100644
index 000000000000..8fae0d15f708
--- /dev/null
+++ b/packages/schema/src/types/schema.ts
@@ -0,0 +1,2108 @@
+import type { IncomingMessage, ServerResponse } from 'node:http'
+import type { AssetURLTagConfig } from '@vue/compiler-sfc'
+import type { CompilerOptions } from '@vue/compiler-core'
+import type { RenderSSRHeadOptions } from '@unhead/vue/types'
+import type { UnheadVueViteOptions } from '@unhead/vue/vite'
+import type { BundleAnalyzerPlugin } from 'webpack-bundle-analyzer'
+import type { PluginVisualizerOptions } from 'rollup-plugin-visualizer'
+import type { TransformerOptions } from 'unctx/transform'
+import type { DotenvOptions, SourceOptions } from 'c12'
+import type { CompatibilityDateSpec } from 'compatx'
+import type { Options } from 'ignore'
+import type { ChokidarOptions } from 'chokidar'
+// @ts-expect-error compatibility import for h3 (v1 + v2)
+import type { CorsOptions, H3CorsOptions } from 'h3'
+import type { NuxtLinkOptions } from 'nuxt/app'
+import type { FetchOptions } from 'ofetch'
+import type { Options as AutoprefixerOptions } from 'autoprefixer'
+import type { Options as CssnanoOptions } from 'cssnano'
+import type { TSConfig } from 'pkg-types'
+import type { RawVueCompilerOptions } from '@vue/language-core'
+import type { PluginOptions } from 'mini-css-extract-plugin'
+import type { LoaderOptions } from 'esbuild-loader'
+import type { Options as PugOptions } from 'pug'
+import type { VueLoaderOptions } from 'vue-loader'
+import type { BasePluginOptions, DefinedDefaultMinimizerAndOptions } from 'css-minimizer-webpack-plugin'
+import type { Configuration, WebpackError } from 'webpack'
+import type { ProcessOptions } from 'postcss'
+import type { Options as WebpackDevMiddlewareOptions } from 'webpack-dev-middleware'
+import type { ClientOptions, MiddlewareOptions } from 'webpack-hot-middleware'
+import type { AppConfig as VueAppConfig } from 'vue'
+import type { TransformOptions as OxcTransformOptions } from 'oxc-transform'
+import type { TransformOptions as EsbuildTransformOptions } from 'esbuild'
+
+import type { RouterConfigSerializable } from './router.ts'
+import type { NuxtHooks } from './hooks.ts'
+import type { ModuleMeta, NuxtModule } from './module.ts'
+import type { NuxtDebugOptions } from './debug.ts'
+import type { Nuxt, NuxtPlugin, NuxtTemplate } from './nuxt.ts'
+import type { SerializableHtmlAttributes } from './head.ts'
+import type { AppConfig, NuxtAppConfig, NuxtOptions, RuntimeConfig, Serializable, ViewTransitionOptions, ViteOptions } from './config.ts'
+import type { ImportsOptions } from './imports.ts'
+import type { ComponentsOptions } from './components.ts'
+import type { KeyedFunction, KeyedFunctionFactory, NuxtCompilerOptions } from './compiler.ts'
+
+export interface ConfigSchema {
+ /**
+ * Configure Nuxt component auto-registration.
+ *
+ * Any components in the directories configured here can be used throughout your pages, layouts (and other components) without needing to explicitly import them.
+ *
+ * @see [`components/` directory documentation](https://nuxt.com/docs/4.x/directory-structure/app/components)
+ */
+ components: boolean | ComponentsOptions | ComponentsOptions['dirs']
+
+ /**
+ * Configure how Nuxt auto-imports composables into your application.
+ *
+ * @see [Nuxt documentation](https://nuxt.com/docs/4.x/directory-structure/app/composables)
+ */
+ imports: ImportsOptions
+
+ /**
+ * Configure the Nuxt compiler.
+ */
+ compiler: NuxtCompilerOptions
+
+ /**
+ * Whether to use the vue-router integration in Nuxt 3. If you do not provide a value it will be enabled if you have a `pages/` directory in your source folder.
+ *
+ * Additionally, you can provide a glob pattern or an array of patterns to scan only certain files for pages.
+ *
+ * @example
+ * ```js
+ * pages: {
+ * pattern: ['**\/*\/*.vue', '!**\/*.spec.*'],
+ * }
+ * ```
+ */
+ pages: boolean | { enabled?: boolean, pattern?: string | string[] }
+
+ /**
+ * Manually disable nuxt telemetry.
+ *
+ * @see [Nuxt Telemetry](https://github.com/nuxt/telemetry) for more information.
+ */
+ telemetry: boolean | Record<string, any>
+
+ /**
+ * Enable Nuxt DevTools for development.
+ *
+ * Breaking changes for devtools might not reflect on the version of Nuxt.
+ *
+ * @see [Nuxt DevTools](https://devtools.nuxt.com/) for more information.
+ */
+ devtools: boolean | { enabled: boolean, [key: string]: any }
+
+ /**
+ * Vue.js config
+ */
+ vue: {
+ transformAssetUrls: AssetURLTagConfig
+
+ /**
+ * Options for the Vue compiler that will be passed at build time.
+ *
+ * @see [Vue documentation](https://vuejs.org/api/application#app-config-compileroptions)
+ */
+ compilerOptions: CompilerOptions
+
+ /**
+ * Include Vue compiler in runtime bundle.
+ */
+ runtimeCompiler: boolean
+
+ /**
+ * Enable reactive destructure for `defineProps`
+ */
+ propsDestructure: boolean
+
+ /**
+ * It is possible to pass configure the Vue app globally. Only serializable options may be set in your `nuxt.config`. All other options should be set at runtime in a Nuxt plugin.
+ *
+ * @see [Vue app config documentation](https://vuejs.org/api/application#app-config)
+ */
+ config: Serializable<VueAppConfig>
+ }
+
+ /**
+ * Nuxt App configuration.
+ */
+ app: {
+ /**
+ * The base path of your Nuxt application.
+ *
+ * For example:
+ *
+ *
+ * @example
+ * ```ts
+ * export default defineNuxtConfig({
+ * app: {
+ * baseURL: '/prefix/'
+ * }
+ * })
+ * ```
+ *
+ * This can also be set at runtime by setting the NUXT_APP_BASE_URL environment variable.
+ *
+ * @example
+ * ```bash
+ * NUXT_APP_BASE_URL=/prefix/ NODE_ENV=production node .output/server/index.mjs
+ * ```
+ */
+ baseURL: string
+
+ /**
+ * The folder name for the built site assets, relative to `baseURL` (or `cdnURL` if set). This is set at build time and should not be customized at runtime.
+ */
+ buildAssetsDir: string
+
+ /**
+ * An absolute URL to serve the public folder from (production-only).
+ *
+ * For example:
+ *
+ * @example
+ * ```ts
+ * export default defineNuxtConfig({
+ * app: {
+ * cdnURL: 'https://mycdn.org/'
+ * }
+ * })
+ * ```
+ *
+ * This can be set to a different value at runtime by setting the `NUXT_APP_CDN_URL` environment variable.
+ *
+ * @example
+ * ```bash
+ * NUXT_APP_CDN_URL=https://mycdn.org/ NODE_ENV=production node .output/server/index.mjs
+ * ```
+ */
+ cdnURL: string
+
+ /**
+ * Set default configuration for `<head>` on every page.
+ *
+ * @example
+ * ```js
+ * app: {
+ * head: {
+ * meta: [
+ * // <meta name="viewport" content="width=device-width, initial-scale=1">
+ * { name: 'viewport', content: 'width=device-width, initial-scale=1' }
+ * ],
+ * script: [
+ * // <script src="https://myawesome-lib.js"></script>
+ * { src: 'https://awesome-lib.js' }
+ * ],
+ * link: [
+ * // <link rel="stylesheet" href="https://myawesome-lib.css">
+ * { rel: 'stylesheet', href: 'https://awesome-lib.css' }
+ * ],
+ * // please note that this is an area that is likely to change
+ * style: [
+ * // <style>:root { color: red }</style>
+ * { textContent: ':root { color: red }' }
+ * ],
+ * noscript: [
+ * // <noscript>JavaScript is required</noscript>
+ * { textContent: 'JavaScript is required' }
+ * ]
+ * }
+ * }
+ * ```
+ */
+ head: NuxtAppConfig['head']
+
+ /**
+ * Default values for layout transitions.
+ *
+ * This can be overridden with `definePageMeta` on an individual page. Only JSON-serializable values are allowed.
+ *
+ * @see [Vue Transition docs](https://vuejs.org/api/built-in-components#transition)
+ */
+ layoutTransition: NuxtAppConfig['layoutTransition']
+
+ /**
+ * Default values for page transitions.
+ *
+ * This can be overridden with `definePageMeta` on an individual page. Only JSON-serializable values are allowed.
+ *
+ * @see [Vue Transition docs](https://vuejs.org/api/built-in-components#transition)
+ */
+ pageTransition: NuxtAppConfig['pageTransition']
+
+ /**
+ * Default values for view transitions.
+ *
+ * This only has an effect when **experimental** support for View Transitions is [enabled in your nuxt.config file](https://nuxt.com/docs/4.x/getting-started/transitions#view-transitions-api-experimental).
+ * This can be overridden with `definePageMeta` on an individual page.
+ *
+ * @see [Nuxt View Transition API docs](https://nuxt.com/docs/4.x/getting-started/transitions#view-transitions-api-experimental)
+ */
+ viewTransition: NuxtAppConfig['viewTransition']
+
+ /**
+ * Default values for KeepAlive configuration between pages.
+ *
+ * This can be overridden with `definePageMeta` on an individual page. Only JSON-serializable values are allowed.
+ *
+ * @see [Vue KeepAlive](https://vuejs.org/api/built-in-components#keepalive)
+ */
+ keepalive: NuxtAppConfig['keepalive']
+
+ /**
+ * Customize Nuxt root element id.
+ *
+ * @deprecated Prefer `rootAttrs.id` instead
+ */
+ rootId: string | false
+
+ /**
+ * Customize Nuxt root element tag.
+ */
+ rootTag: string
+
+ /**
+ * Customize Nuxt root element id.
+ */
+ rootAttrs: SerializableHtmlAttributes
+
+ /**
+ * Customize Nuxt Teleport element tag.
+ */
+ teleportTag: string
+
+ /**
+ * Customize Nuxt Teleport element id.
+ *
+ * @deprecated Prefer `teleportAttrs.id` instead
+ */
+ teleportId: string | false
+
+ /**
+ * Customize Nuxt Teleport element attributes.
+ */
+ teleportAttrs: SerializableHtmlAttributes
+
+ /**
+ * Customize Nuxt SpaLoader element tag.
+ */
+ spaLoaderTag: string
+
+ /**
+ * Customize Nuxt SPA loading template element attributes.
+ */
+ spaLoaderAttrs: SerializableHtmlAttributes
+ }
+
+ /**
+ * Boolean or a path to an HTML file with the contents of which will be inserted into any HTML page rendered with `ssr: false`.
+ *
+ * - If it is unset, it will use `~/spa-loading-template.html` file in one of your layers, if it exists. - If it is false, no SPA loading indicator will be loaded. - If true, Nuxt will look for `~/spa-loading-template.html` file in one of your layers, or a
+ * default Nuxt image will be used.
+ * Some good sources for spinners are [SpinKit](https://github.com/tobiasahlin/SpinKit) or [SVG Spinners](https://icones.js.org/collection/svg-spinners).
+ *
+ * @example ~/spa-loading-template.html
+ * ```html
+ * <!-- https://github.com/barelyhuman/snips/blob/dev/pages/css-loader.md -->
+ * <div class="loader"></div>
+ * <style>
+ * .loader {
+ * display: block;
+ * position: fixed;
+ * z-index: 1031;
+ * top: 50%;
+ * left: 50%;
+ * transform: translate(-50%, -50%);
+ * width: 18px;
+ * height: 18px;
+ * box-sizing: border-box;
+ * border: solid 2px transparent;
+ * border-top-color: #000;
+ * border-left-color: #000;
+ * border-bottom-color: #efefef;
+ * border-right-color: #efefef;
+ * border-radius: 50%;
+ * -webkit-animation: loader 400ms linear infinite;
+ * animation: loader 400ms linear infinite;
+ * }
+ *
+ * @-webkit-keyframes loader {
+ * 0% {
+ * -webkit-transform: translate(-50%, -50%) rotate(0deg);
+ * }
+ * 100% {
+ * -webkit-transform: translate(-50%, -50%) rotate(360deg);
+ * }
+ * }
+ * @keyframes loader {
+ * 0% {
+ * transform: translate(-50%, -50%) rotate(0deg);
+ * }
+ * 100% {
+ * transform: translate(-50%, -50%) rotate(360deg);
+ * }
+ * }
+ * </style>
+ * ```
+ */
+ spaLoadingTemplate: string | boolean | undefined | null
+
+ /**
+ * An array of nuxt app plugins.
+ *
+ * Each plugin can be a string (which can be an absolute or relative path to a file). If it ends with `.client` or `.server` then it will be automatically loaded only in the appropriate context.
+ * It can also be an object with `src` and `mode` keys.
+ *
+ * @note Plugins are also auto-registered from the `~/plugins` directory
+ * 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 [`plugins/` directory documentation](https://nuxt.com/docs/4.x/directory-structure/app/plugins)
+ *
+ * @example
+ * ```js
+ * plugins: [
+ * '~/plugins/foo.client.js', // only in client side
+ * '~/plugins/bar.server.js', // only in server side
+ * '~/plugins/baz.js', // both client & server
+ * { src: '~/plugins/both-sides.js' },
+ * { src: '~/plugins/client-only.js', mode: 'client' }, // only on client side
+ * { src: '~/plugins/server-only.js', mode: 'server' } // only on server side
+ * ]
+ * ```
+ */
+ plugins: (NuxtPlugin | string)[]
+
+ /**
+ * You can define the CSS files/modules/libraries you want to set globally (included in every page).
+ *
+ * Nuxt will automatically guess the file type by its extension and use the appropriate pre-processor. You will still need to install the required loader if you need to use them.
+ *
+ * @example
+ * ```js
+ * css: [
+ * // Load a Node.js module directly (here it's a Sass file).
+ * 'bulma',
+ * // CSS file in the project
+ * '~/assets/css/main.css',
+ * // SCSS file in the project
+ * '~/assets/css/main.scss'
+ * ]
+ * ```
+ */
+ css: string[]
+
+ /**
+ * An object that allows us to configure the `unhead` nuxt module.
+ */
+ unhead: {
+ /**
+ * Disables Capo.js head tag sorting.
+ *
+ * On compat v4, the unhead legacy plugin set (`DeprecationsPlugin`, `PromisesPlugin`,
+ * `TemplateParamsPlugin`, `AliasSortingPlugin`) is always loaded so existing head patterns
+ * (`hid`, `vmid`, `children`, `body: true`, promise values, `%s` template params)
+ * keep working.
+ *
+ * Forced to `false` when `future.compatibilityVersion` >= 5.
+ *
+ * @deprecated Will be removed. Migrate off the deprecated head patterns and resolve promise
+ * values before passing to `useHead`.
+ * @default false
+ */
+ legacy: boolean
+
+ /**
+ * An object that will be passed to `renderSSRHead` to customize the output.
+ */
+ renderSSRHeadOptions: RenderSSRHeadOptions
+
+ /**
+ * Options for the `@unhead/vue/vite` build plugin. Provides tree-shaking, `useSeoMeta` transform,
+ * minification, and validation.
+ *
+ * Set to `false` to disable the plugin entirely.
+ *
+ * Only applies when `future.compatibilityVersion` >= 5.
+ *
+ * @default {}
+ */
+ vite: false | Omit<UnheadVueViteOptions, 'streaming' | '_framework'>
+ }
+
+ /**
+ * The builder to use for bundling the Vue part of your application.
+ *
+ */
+ builder: 'vite' | 'webpack' | 'rspack' | { bundle: (nuxt: Nuxt) => Promise<void> }
+
+ /**
+ * Configures whether and how sourcemaps are generated for server and/or client bundles.
+ *
+ * If set to a single boolean, that value applies to both server and client. Additionally, the `'hidden'` option is also available for both server and client.
+ * Available options for both client and server: - `true`: Generates sourcemaps and includes source references in the final bundle. - `false`: Does not generate any sourcemaps. - `'hidden'`: Generates sourcemaps but does not include references in the final bundle.
+ */
+ sourcemap: boolean | { server?: boolean | 'hidden', client?: boolean | 'hidden' }
+
+ /**
+ * Log level when building logs.
+ *
+ * Defaults to 'silent' when running in CI or when a TTY is not available. This option is then used as 'silent' in Vite and 'none' in Webpack
+ *
+ */
+ logLevel: 'silent' | 'info' | 'verbose'
+
+ /**
+ * Shared build configuration.
+ */
+ build: {
+ /**
+ * If you want to transpile specific dependencies with Babel, you can add them here. Each item in transpile can be a package name, a function, a string or regex object matching the dependency's file name.
+ *
+ * You can also use a function to conditionally transpile. The function will receive an object ({ isDev, isServer, isClient, isModern, isLegacy }).
+ *
+ * @example
+ * ```js
+ * transpile: [({ isLegacy }) => isLegacy && 'ky']
+ * ```
+ */
+ transpile: Array<string | RegExp | ((ctx: { isClient?: boolean, isServer?: boolean, isDev: boolean }) => string | RegExp | false)>
+
+ /**
+ * It is recommended to use `addTemplate` from `@nuxt/kit` instead of this option.
+ *
+ * @example
+ * ```js
+ * templates: [
+ * {
+ * src: '~/modules/support/plugin.js', // `src` can be absolute or relative
+ * dst: 'support.js', // `dst` is relative to project `.nuxt` dir
+ * }
+ * ]
+ * ```
+ */
+ templates: NuxtTemplate<any>[]
+
+ /**
+ * Nuxt allows visualizing your bundles and how to optimize them.
+ *
+ * Set to `true` to enable bundle analysis, or pass an object with options: [for webpack](https://github.com/webpack/webpack-bundle-analyzer#options-for-plugin) or [for vite](https://github.com/btd/rollup-plugin-visualizer#options).
+ *
+ * @example
+ * ```js
+ * analyze: {
+ * analyzerMode: 'static'
+ * }
+ * ```
+ */
+ analyze: boolean | { enabled?: boolean } & ((0 extends 1 & BundleAnalyzerPlugin.Options ? Record<string, unknown> : BundleAnalyzerPlugin.Options) | PluginVisualizerOptions)
+ }
+
+ /**
+ * Build time optimization configuration.
+ */
+ optimization: {
+ /**
+ * Functions to inject a key for.
+ *
+ * As long as the number of arguments passed to the function is lower than `argumentLength`, an additional magic string will be injected that can be used to deduplicate requests between server and client. You will need to take steps to handle this additional key.
+ * The key will be unique based on the location of the function being invoked within the file.
+ *
+ */
+ keyedComposables: KeyedFunction[]
+ /**
+ * Factories for functions that should be registered for automatic key injection.
+ *
+ * @see keyedComposables
+ */
+ keyedComposableFactories: KeyedFunctionFactory[]
+
+ /**
+ * Tree shake code from specific builds.
+ */
+ treeShake: {
+ /**
+ * Tree shake composables from the server or client builds.
+ *
+ *
+ * @example
+ * ```js
+ * treeShake: { client: { myPackage: ['useServerOnlyComposable'] } }
+ * ```
+ */
+ composables: {
+ server: Record<string, string[]>
+ client: Record<string, string[]>
+ }
+ }
+
+ /**
+ * Options passed directly to the transformer from `unctx` that preserves async context after `await`.
+ */
+ asyncTransforms: TransformerOptions
+ }
+
+ /**
+ * Extend project from multiple local or remote sources.
+ *
+ * Value should be either a string or array of strings pointing to source directories or config path relative to current config.
+ * You can use `github:`, `gh:` `gitlab:` or `bitbucket:`
+ *
+ * @see [`c12` docs on extending config layers](https://github.com/unjs/c12#extending-config-layer-from-remote-sources)
+ *
+ * @see [`giget` documentation](https://github.com/unjs/giget)
+ */
+ extends: string | [string, SourceOptions?] | (string | [string, SourceOptions?])[]
+
+ /**
+ * Specify a compatibility date for your app.
+ *
+ * This is used to control the behavior of presets in Nitro, Nuxt Image and other modules that may change behavior without a major version bump.
+ * We plan to improve the tooling around this feature in the future.
+ */
+ compatibilityDate: CompatibilityDateSpec
+
+ /**
+ * Extend project from a local or remote source.
+ *
+ * Value should be a string pointing to source directory or config path relative to current config.
+ * You can use `github:`, `gitlab:`, `bitbucket:` or `https://` to extend from a remote git repository.
+ */
+ theme: string
+
+ /**
+ * Define the root directory of your application.
+ *
+ * This property can be overwritten (for example, running `nuxt ./my-app/` will set the `rootDir` to the absolute path of `./my-app/` from the current/working directory.
+ * It is normally not needed to configure this option.
+ *
+ */
+ rootDir: string
+
+ /**
+ * Define the workspace directory of your application.
+ *
+ * Often this is used when in a monorepo setup. Nuxt will attempt to detect your workspace directory automatically, but you can override it here.
+ * It is normally not needed to configure this option.
+ *
+ */
+ workspaceDir: string
+
+ /**
+ * Define the source directory of your Nuxt application.
+ *
+ * If a relative path is specified, it will be relative to the `rootDir`.
+ *
+ *
+ * @example
+ * ```js
+ * export default {
+ * srcDir: 'app/'
+ * }
+ * ```
+ * This expects the following folder structure:
+ * ```bash
+ * -| app/
+ * ---| assets/
+ * ---| components/
+ * ---| layouts/
+ * ---| middleware/
+ * ---| pages/
+ * ---| plugins/
+ * ---| app.config.ts
+ * ---| app.vue
+ * ---| error.vue
+ * -| server/
+ * -| public/
+ * -| modules/
+ * -| nuxt.config.js
+ * -| package.json
+ * ```
+ */
+ srcDir: string
+
+ /**
+ * Define the server directory of your Nuxt application, where Nitro routes, middleware and plugins are kept.
+ *
+ * If a relative path is specified, it will be relative to your `rootDir`.
+ *
+ */
+ serverDir: string
+
+ /**
+ * Define the directory where your built Nuxt files will be placed.
+ *
+ * Many tools assume that `.nuxt` is a hidden directory (because it starts with a `.`). If that is a problem, you can use this option to prevent that.
+ *
+ *
+ * @example
+ * ```js
+ * export default {
+ * buildDir: 'nuxt-build'
+ * }
+ * ```
+ */
+ buildDir: string
+
+ /**
+ * For multi-app projects, the unique id of the Nuxt application.
+ *
+ * Defaults to `nuxt-app`.
+ *
+ */
+ appId: string
+
+ /**
+ * A unique identifier matching the build. This may contain the hash of the current state of the project.
+ *
+ */
+ buildId: string
+
+ /**
+ * Used to set the modules directories for path resolving (for example, webpack's `resolveLoading`, `nodeExternals` and `postcss`).
+ *
+ * The configuration path is relative to `options.rootDir` (default is current working directory).
+ * Setting this field may be necessary if your project is organized as a yarn workspace-styled mono-repository.
+ *
+ *
+ * @example
+ * ```js
+ * export default {
+ * modulesDir: ['../../node_modules']
+ * }
+ * ```
+ */
+ modulesDir: Array<string>
+
+ /**
+ * The directory where Nuxt will store the generated files when running `nuxt analyze`.
+ *
+ * If a relative path is specified, it will be relative to your `rootDir`.
+ *
+ */
+ analyzeDir: string
+
+ /**
+ * Whether Nuxt is running in development mode.
+ *
+ * Normally, you should not need to set this.
+ *
+ */
+ dev: boolean
+
+ /**
+ * Whether your app is being unit tested.
+ *
+ */
+ test: boolean
+
+ /**
+ * The active Nuxt environment name, used by `c12` to select configuration
+ * overrides (e.g. `$env.staging`). Defaults to the explicit `envName` passed to
+ * `loadNuxtConfig` (e.g. via `nuxt --envName`), falling back to `'development'`
+ * in dev mode and `'production'` otherwise.
+ *
+ * Exposed to runtime app code as `import.meta.envName`.
+ *
+ */
+ envName: string
+
+ /**
+ * Set to `true` to enable debug mode.
+ *
+ * At the moment, it prints out hook names and timings on the server, and logs hook arguments as well in the browser.
+ * You can also set this to an object to enable specific debug options.
+ *
+ */
+ debug: boolean | (NuxtDebugOptions) | undefined
+
+ /**
+ * Whether to enable rendering of HTML - either dynamically (in server mode) or at generate time. If set to `false` generated pages will have no content.
+ *
+ */
+ ssr: boolean
+
+ /**
+ * Modules are Nuxt extensions which can extend its core functionality and add endless integrations.
+ *
+ * Each module is either a string (which can refer to a package, or be a path to a file), a tuple with the module as first string and the options as a second object, or an inline module function.
+ * Nuxt tries to resolve each item in the modules array using node require path (in `node_modules`) and then will be resolved from project `srcDir` if `~` alias is used.
+ *
+ * @note Modules are executed sequentially so the order is important. First, the modules defined in `nuxt.config.ts` are loaded. Then, modules found in the `modules/`
+ * directory are executed, and they load in alphabetical order.
+ *
+ * @example
+ * ```js
+ * modules: [
+ * // Using package name
+ * '@nuxtjs/axios',
+ * // Relative to your project srcDir
+ * '~/modules/awesome.js',
+ * // Providing options
+ * ['@nuxtjs/google-analytics', { ua: 'X1234567' }],
+ * // Inline definition
+ * function () {}
+ * ]
+ * ```
+ */
+ modules: (NuxtModule<any> | string | [NuxtModule | string, Record<string, any>] | undefined | null | false)[]
+
+ /**
+ * Customize default directory structure used by Nuxt.
+ *
+ * It is better to stick with defaults unless needed.
+ */
+ dir: {
+ app: string
+
+ /**
+ * The assets directory (aliased as `~assets` in your build).
+ */
+ assets: string
+
+ /**
+ * The layouts directory, each file of which will be auto-registered as a Nuxt layout.
+ */
+ layouts: string
+
+ /**
+ * The middleware directory, each file of which will be auto-registered as a Nuxt middleware.
+ */
+ middleware: string
+
+ /**
+ * The modules directory, each file in which will be auto-registered as a Nuxt module.
+ */
+ modules: string
+
+ /**
+ * The directory which will be processed to auto-generate your application page routes.
+ */
+ pages: string
+
+ /**
+ * The plugins directory, each file of which will be auto-registered as a Nuxt plugin.
+ */
+ plugins: string
+
+ /**
+ * The shared directory. This directory is shared between the app and the server.
+ */
+ shared: string
+
+ /**
+ * The directory containing your static files, which will be directly accessible via the Nuxt server and copied across into your `dist` folder when your app is generated.
+ */
+ public: string
+ }
+
+ /**
+ * The extensions that should be resolved by the Nuxt resolver.
+ *
+ */
+ extensions: Array<string>
+
+ /**
+ * You can improve your DX by defining additional aliases to access custom directories within your JavaScript and CSS.
+ *
+ * @note Within a webpack context (image sources, CSS - but not JavaScript) you _must_ access
+ * your alias by prefixing it with `~`.
+ *
+ * @note These aliases will be automatically added to the generated `.nuxt/tsconfig.json` so you can get full
+ * type support and path auto-complete. In case you need to extend options provided by `./.nuxt/tsconfig.json`
+ * further, make sure to add them here or within the `typescript.tsConfig` property in `nuxt.config`.
+ *
+ * @example
+ * ```js
+ * export default {
+ * alias: {
+ * 'images': fileURLToPath(new URL('./assets/images', import.meta.url)),
+ * 'style': fileURLToPath(new URL('./assets/style', import.meta.url)),
+ * 'data': fileURLToPath(new URL('./assets/other/data', import.meta.url))
+ * }
+ * }
+ * ```
+ *
+ * ```html
+ * <template>
+ * <img src="~images/main-bg.jpg">
+ * </template>
+ *
+ * <script>
+ * import data from 'data/test.json'
+ * </script>
+ *
+ * <style>
+ * // Uncomment the below
+ * //@import '~style/variables.scss';
+ * //@import '~style/utils.scss';
+ * //@import '~style/base.scss';
+ * body {
+ * background-image: url('~images/main-bg.jpg');
+ * }
+ * </style>
+ * ```
+ */
+ alias: Record<string, string>
+
+ /**
+ * Pass options directly to `node-ignore` (which is used by Nuxt to ignore files).
+ *
+ * @see [node-ignore](https://github.com/kaelzhang/node-ignore)
+ *
+ * @example
+ * ```js
+ * ignoreOptions: {
+ * ignorecase: false
+ * }
+ * ```
+ */
+ ignoreOptions: Options
+
+ /**
+ * Any file in `pages/`, `layouts/`, `middleware/`, and `public/` directories will be ignored during the build process if its filename starts with the prefix specified by `ignorePrefix`. This is intended to prevent certain files from being processed or served in the built application. By default, the `ignorePrefix` is set to '-', ignoring any files starting with '-'.
+ *
+ */
+ ignorePrefix: string
+
+ /**
+ * More customizable than `ignorePrefix`: all files matching glob patterns specified inside the `ignore` array will be ignored in building.
+ *
+ */
+ ignore: Array<string>
+
+ /**
+ * The watch property lets you define patterns that will restart the Nuxt dev server when changed.
+ *
+ * It is an array of strings or regular expressions. Strings should be either absolute paths or relative to the `srcDir` (and the `srcDir` of any layers). Regular expressions will be matched against the path relative to the project `srcDir` (and the `srcDir` of any layers).
+ */
+ watch: Array<string | RegExp>
+
+ /**
+ * The watchers property lets you overwrite watchers configuration in your `nuxt.config`.
+ */
+ watchers: {
+ /**
+ * An array of event types, which, when received, will cause the watcher to restart.
+ */
+ rewatchOnRawEvents: string[]
+
+ /**
+ * `watchOptions` to pass directly to webpack.
+ *
+ * @see [webpack@4 watch options](https://v4.webpack.js.org/configuration/watch/#watchoptions).
+ */
+ webpack: {
+ aggregateTimeout: number
+ }
+
+ /**
+ * Options to pass directly to `chokidar`.
+ *
+ * @see [chokidar](https://github.com/paulmillr/chokidar)
+ */
+ chokidar: ChokidarOptions
+ }
+
+ /**
+ * Hooks are listeners to Nuxt events that are typically used in modules, but are also available in `nuxt.config`.
+ *
+ * Internally, hooks follow a naming pattern using colons (e.g., build:done).
+ * For ease of configuration, you can also structure them as an hierarchical object in `nuxt.config` (as below).
+ *
+ * @example
+ * ```js
+ * import fs from 'node:fs'
+ * import path from 'node:path'
+ * export default {
+ * hooks: {
+ * build: {
+ * done(builder) {
+ * const extraFilePath = path.join(
+ * builder.nuxt.options.buildDir,
+ * 'extra-file'
+ * )
+ * fs.writeFileSync(extraFilePath, 'Something extra')
+ * }
+ * }
+ * }
+ * }
+ * ```
+ */
+ hooks: NuxtHooks
+
+ /**
+ * Runtime config allows passing dynamic config and environment variables to the Nuxt app context.
+ *
+ * The value of this object is accessible from server only using `useRuntimeConfig`.
+ * It mainly should hold _private_ configuration which is not exposed on the frontend. This could include a reference to your API secret tokens.
+ * Anything under `public` and `app` will be exposed to the frontend as well.
+ * Values are automatically replaced by matching env variables at runtime, e.g. setting an environment variable `NUXT_API_KEY=my-api-key NUXT_PUBLIC_BASE_URL=/foo/` would overwrite the two values in the example below.
+ *
+ * @example
+ * ```js
+ * export default {
+ * runtimeConfig: {
+ * apiKey: '', // Default to an empty string, automatically set at runtime using process.env.NUXT_API_KEY
+ * public: {
+ * baseURL: '' // Exposed to the frontend as well.
+ * }
+ * }
+ * }
+ * ```
+ */
+ runtimeConfig: RuntimeConfig
+
+ /**
+ * Additional app configuration
+ *
+ * For programmatic usage and type support, you can directly provide app config with this option. It will be merged with `app.config` file as default value.
+ */
+ appConfig: AppConfig
+
+ devServer: {
+ /**
+ * Whether to enable HTTPS.
+ *
+ *
+ * @example
+ * ```ts
+ * export default defineNuxtConfig({
+ * devServer: {
+ * https: {
+ * key: './server.key',
+ * cert: './server.crt'
+ * }
+ * }
+ * })
+ * ```
+ */
+ https: boolean | { key: string, cert: string } | { pfx: string, passphrase: string }
+
+ /**
+ * Dev server listening port
+ */
+ port: number
+
+ /**
+ * Dev server listening host
+ */
+ host: string | undefined
+
+ /**
+ * Listening dev server URL.
+ *
+ * This should not be set directly as it will always be overridden by the dev server with the full URL (for module and internal use).
+ */
+ url: string
+
+ /**
+ * Template to show a loading screen
+ */
+ loadingTemplate: (data: { loading?: string }) => string
+
+ /**
+ * Set CORS options for the dev server
+ */
+ cors: 'origin' extends keyof H3CorsOptions
+ ? 'origin' extends keyof CorsOptions
+ ? CorsOptions | H3CorsOptions
+ : H3CorsOptions
+ : CorsOptions
+ }
+
+ /**
+ * `future` is for early opting-in to new features that will become default in a future (possibly major) version of the framework.
+ */
+ future: {
+ /**
+ * Enable early access to future features or flags.
+ *
+ */
+ compatibilityVersion: 4 | 5
+
+ /**
+ * This enables early access to the experimental multi-app support.
+ *
+ * @see [Nuxt Issue #21635](https://github.com/nuxt/nuxt/issues/21635)
+ */
+ multiApp: boolean
+
+ /**
+ * This enables 'Bundler' module resolution mode for TypeScript, which is the recommended setting for frameworks like Nuxt and Vite.
+ *
+ * It improves type support when using modern libraries with `exports`.
+ * You can set it to false to use the legacy 'Node' mode, which is the default for TypeScript.
+ *
+ * @see [TypeScript PR implementing `bundler` module resolution](https://github.com/microsoft/TypeScript/pull/51669)
+ */
+ typescriptBundlerResolution: boolean
+ }
+
+ /**
+ * Some features of Nuxt are available on an opt-in basis, or can be disabled based on your needs.
+ */
+ features: {
+ /**
+ * Inline styles when rendering HTML (currently vite only).
+ *
+ * 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.
+ */
+ inlineStyles: boolean | ((id?: string) => boolean)
+
+ /**
+ * Stream server logs to the client as you are developing. These logs can be handled in the `dev:ssr-logs` hook.
+ *
+ * If set to `silent`, the logs will not be printed to the browser console.
+ */
+ devLogs: boolean | 'silent'
+
+ /**
+ * Turn off rendering of Nuxt scripts and JS resource hints. You can also disable scripts more granularly within `routeRules`.
+ *
+ * If set to 'production' or `true`, JS will be disabled in production mode only.
+ */
+ noScripts: 'production' | 'all' | boolean
+ }
+
+ experimental: {
+ /**
+ * Enable to use experimental decorators in Nuxt and Nitro.
+ *
+ * @default false
+ * @see https://github.com/tc39/proposal-decorators
+ */
+ decorators: boolean
+
+ /**
+ * Set to true to generate an async entry point for the Vue bundle (for module federation support).
+ *
+ * @default false
+ */
+ asyncEntry: boolean
+
+ /**
+ * Enable accessing `appConfig` from server routes.
+ *
+ * @default true
+ * @deprecated This option is not recommended.
+ */
+ serverAppConfig: boolean
+
+ /**
+ * Emit `app:chunkError` hook when there is an error loading vite/webpack chunks.
+ *
+ * By default, Nuxt will also perform a reload of the new route when a chunk fails to load when navigating to a new route (`automatic`).
+ * Setting `automatic-immediate` will lead Nuxt to perform a reload of the current route right when a chunk fails to load (instead of waiting for navigation).
+ * You can disable automatic handling by setting this to `false`, or handle chunk errors manually by setting it to `manual`.
+ *
+ * @default 'automatic'
+ * @see [Nuxt PR #19038](https://github.com/nuxt/nuxt/pull/19038)
+ */
+ emitRouteChunkError: false | 'manual' | 'automatic' | 'automatic-immediate'
+
+ /**
+ * By default the route object returned by the auto-imported `useRoute()` composable is kept in sync with the current page in view in `<NuxtPage>`. This is not true for `vue-router`'s exported `useRoute` or for the default `$route` object available in your Vue templates.
+ *
+ * By enabling this option a mixin will be injected to keep the `$route` template object in sync with Nuxt's managed `useRoute()`.
+ *
+ * @default true
+ */
+ templateRouteInjection: boolean
+
+ /**
+ * Whether to restore Nuxt app state from `sessionStorage` when reloading the page after a chunk error or manual `reloadNuxtApp()` call.
+ *
+ * To avoid hydration errors, it will be applied only after the Vue app has been mounted, meaning there may be a flicker on initial load.
+ * Consider carefully before enabling this as it can cause unexpected behavior, and consider providing explicit keys to `useState` as auto-generated keys may not match across builds.
+ *
+ * @default false
+ */
+ restoreState: boolean
+
+ /**
+ * Disable vue server renderer endpoint within nitro.
+ *
+ * @default false
+ */
+ noVueServer: boolean
+
+ /**
+ * Controls how payload data is delivered for prerendered and cached (ISR/SWR) pages.
+ *
+ * - `'client'` - Payload is inlined in HTML for the initial server render, and extracted to
+ * `_payload.json` files for client-side navigation. This avoids a separate request on
+ * initial load while still enabling efficient client-side navigation.
+ * - `true` - Payload is extracted to a separate `_payload.json` file for both the initial
+ * server render and client-side navigation.
+ * - `false` - Payload extraction is disabled entirely. Payload is always inlined in HTML and
+ * no `_payload.json` files are generated.
+ *
+ * `@default` true (or 'client' when compatibilityVersion >= 5)
+ */
+ payloadExtraction: 'client' | boolean | undefined
+
+ /**
+ * Whether to enable the experimental `<NuxtClientFallback>` component for rendering content on the client if there's an error in SSR.
+ *
+ * @default false
+ */
+ clientFallback: boolean
+
+ /**
+ * Enable cross-origin prefetch using the Speculation Rules API.
+ *
+ * @default false
+ */
+ crossOriginPrefetch: boolean
+
+ /**
+ * Enable View Transition API integration with client-side router.
+ *
+ * @default false
+ * @see [View Transitions API](https://developer.chrome.com/docs/web-platform/view-transitions)
+ */
+ viewTransition: ViewTransitionOptions | ViewTransitionOptions['enabled']
+
+ /**
+ * Write early hints when using node server.
+ *
+ * @default false
+ * @note nginx does not support 103 Early hints in the current version.
+ */
+ writeEarlyHints: boolean
+
+ /**
+ * Experimental component islands support with `<NuxtIsland>` and `.island.vue` files.
+ *
+ * By default it is set to 'auto', which means it will be enabled only when there are islands, server components or server pages in your app.
+ *
+ * @default 'auto'
+ */
+ componentIslands: true | 'auto' | 'local' | 'local+remote' | Partial<{ remoteIsland: boolean, selectiveClient: boolean | 'deep' }> | false
+
+ /**
+ * Resolve `~`, `~~`, `@` and `@@` aliases located within layers with respect to their layer source and root directories.
+ *
+ * @default true
+ */
+ localLayerAliases: boolean
+
+ /**
+ * Enable the new experimental typed router using vue-router.
+ *
+ * @default false
+ */
+ typedPages: boolean
+
+ /**
+ * Use app manifests to respect route rules on client-side.
+ *
+ * @default true
+ */
+ appManifest: boolean
+
+ /**
+ * Set the time interval (in ms) to check for new builds. Disabled when `experimental.appManifest` is `false`.
+ *
+ * Set to `false` to disable.
+ * @default 3600000 (1 hour)
+ */
+ checkOutdatedBuildInterval: number | false
+
+ /**
+ * Set an alternative watcher that will be used as the watching service for Nuxt.
+ *
+ * Nuxt uses 'chokidar-granular' if your source directory is the same as your root directory . This will ignore top-level directories (like `node_modules` and `.git`) that are excluded from watching.
+ * You can set this instead to `parcel` to use `@parcel/watcher`, which may improve performance in large projects or on Windows platforms.
+ * You can also set this to `chokidar` to watch all files in your source directory.
+ *
+ * Set to `'builder'` to reuse the active builder's own file watcher (e.g. Vite's `server.watcher`) instead of starting a second one. If the active builder does not provide a watcher, Nuxt falls back to its default selection.
+ *
+ * @see [chokidar](https://github.com/paulmillr/chokidar)
+ *
+ * @see [@parcel/watcher](https://github.com/parcel-bundler/watcher)
+ *
+ * @default 'builder' if `future.compatibilityVersion` >= 5, otherwise 'chokidar-granular' if `srcDir` is the same as `rootDir`, otherwise 'chokidar'
+ */
+ watcher: 'chokidar' | 'parcel' | 'chokidar-granular' | 'builder'
+
+ /**
+ * Enable native async context to be accessible for nested composables
+ *
+ * @default false
+ * @see [Nuxt PR #20918](https://github.com/nuxt/nuxt/pull/20918)
+ */
+ asyncContext: boolean
+
+ /**
+ * Use new experimental head optimisations:
+ *
+ * - Add the capo.js head plugin in order to render tags in of the head in a more performant way. - Uses the hash hydration plugin to reduce initial hydration
+ *
+ * @deprecated CAPO sorting is now the default in unhead v3. Set `unhead.legacy: true` to opt out
+ * temporarily on compat v4.
+ * @default true
+ * @see [Nuxt Discussion #22632](https://github.com/nuxt/nuxt/discussions/22632)
+ */
+ headNext: boolean
+
+ /**
+ * Allow defining `routeRules` directly within your `~/pages` directory using `defineRouteRules`.
+ *
+ * Rules are converted (based on the path) and applied for server requests. For example, a rule defined in `~/pages/foo/bar.vue` will be applied to `/foo/bar` requests. A rule in `~/pages/foo/[id].vue` will be applied to `/foo/**` requests.
+ * For more control, such as if you are using a custom `path` or `alias` set in the page's `definePageMeta`, you should set `routeRules` directly within your `nuxt.config`.
+ *
+ * @default false
+ */
+ inlineRouteRules: boolean
+
+ /**
+ * Allow exposing some route metadata defined in `definePageMeta` at build-time to modules (alias, name, path, redirect, props, middleware).
+ *
+ * This only works with static or strings/arrays rather than variables or conditional assignment.
+ *
+ * @default 'after-resolve'
+ * @see [Nuxt Issues #24770](https://github.com/nuxt/nuxt/issues/24770)
+ */
+ scanPageMeta: boolean | 'after-resolve'
+
+ /**
+ * Configure additional keys to extract from the page metadata when using `scanPageMeta`.
+ *
+ * This allows modules to access additional metadata from the page metadata. It's recommended to augment the NuxtPage types with your keys.
+ *
+ * @default []
+ */
+ extraPageMetaExtractionKeys: string[]
+
+ /**
+ * Automatically share payload _data_ between pages that are prerendered. This can result in a significant performance improvement when prerendering sites that use `useAsyncData` or `useFetch` and fetch the same data in different pages.
+ *
+ * It is particularly important when enabling this feature to make sure that any unique key of your data is always resolvable to the same data. For example, if you are using `useAsyncData` to fetch data related to a particular page, you should provide a key that uniquely matches that data. (`useFetch` should do this automatically for you.)
+ *
+ * @default true
+ * @example
+ * ```ts
+ * // This would be unsafe in a dynamic page (e.g. `[slug].vue`) because the route slug makes a difference
+ * // to the data fetched, but Nuxt can't know that because it's not reflected in the key.
+ * const route = useRoute()
+ * const { data } = await useAsyncData(async () => {
+ * return await $fetch(`/api/my-page/${route.params.slug}`)
+ * })
+ * // Instead, you should use a key that uniquely identifies the data fetched.
+ * const { data } = await useAsyncData(route.params.slug, async () => {
+ * return await $fetch(`/api/my-page/${route.params.slug}`)
+ * })
+ * ```
+ */
+ sharedPrerenderData: boolean
+
+ /**
+ * Enables CookieStore support to listen for cookie updates (if supported by the browser) and refresh `useCookie` ref values.
+ *
+ * @default true
+ * @see [CookieStore](https://developer.mozilla.org/en-US/docs/Web/API/CookieStore)
+ */
+ cookieStore: boolean
+
+ /**
+ * This allows specifying the default options for core Nuxt components and composables.
+ *
+ * These options will likely be moved elsewhere in the future, such as into `app.config` or into the `app/` directory.
+ */
+ defaults: {
+ /**
+ * @default { componentName: 'NuxtLink', prefetch: true, prefetchOn: { visibility: true }}
+ */
+ nuxtLink: NuxtLinkOptions
+
+ /**
+ * Options that apply to `useAsyncData` (and also therefore `useFetch`)
+ * @default { deep: false }
+ */
+ useAsyncData: {
+ deep: boolean
+ }
+
+ /**
+ * Options that apply to `useState` and `clearNuxtState`.
+ * @default { resetOnClear: false }
+ * @default { resetOnClear: true } with compatibilityVersion >= 5
+ */
+ useState: {
+ /**
+ * When `true`, `clearNuxtState` will reset state to its initial value (provided by the `init`
+ * function of `useState`) instead of setting it to `undefined`.
+ *
+ * This aligns `clearNuxtState` behavior with `clearNuxtData`, which already resets to defaults.
+ *
+ * @default false
+ * @default true with compatibilityVersion >= 5
+ */
+ resetOnClear: boolean
+ }
+
+ useFetch: Pick<FetchOptions, 'timeout' | 'retry' | 'retryDelay' | 'retryStatusCodes'>
+ }
+
+ /**
+ * Automatically polyfill Node.js imports in the client build using `unenv`.
+ *
+ * @default false
+ * @see [unenv](https://github.com/unjs/unenv)
+ *
+ * **Note:** To make globals like `Buffer` work in the browser, you need to manually inject them.
+ *
+ * ```ts
+ * import { Buffer } from 'node:buffer'
+ *
+ * globalThis.Buffer = globalThis.Buffer || Buffer
+ * ```
+ */
+ clientNodeCompat: boolean
+
+ /**
+ * Wait for a single animation frame before navigation, which gives an opportunity for the browser to repaint, acknowledging user interaction.
+ *
+ * It can reduce INP when navigating on prerendered routes.
+ *
+ * @default true
+ */
+ navigationRepaint: boolean
+
+ /**
+ * Cache Nuxt/Nitro build artifacts based on a hash of the configuration and source files.
+ *
+ * This only works for source files within `srcDir` and `serverDir` for the Vue/Nitro parts of your app.
+ * @default false
+ */
+ buildCache: boolean
+
+ /**
+ * Ensure that auto-generated Vue component names match the full component name you would use to auto-import the component.
+ * @default true
+ */
+ normalizeComponentNames: boolean
+
+ /**
+ * Ensure that page component names match their route names.
+ *
+ * This is useful when using `<KeepAlive>` with `include`/`exclude` filters, as Vue's
+ * `<KeepAlive>` relies on the component `name` option to identify components.
+ * Without this, page components may have generic names (like `index`) that don't
+ * correspond to their route names, making name-based `<KeepAlive>` filtering unreliable.
+ * @default false
+ * @default true with compatibilityVersion >= 5
+ */
+ normalizePageNames: boolean
+
+ /**
+ * Keep showing the spa-loading-template until suspense:resolve
+ *
+ * @default 'body'
+ * @see [Nuxt Issues #21721](https://github.com/nuxt/nuxt/issues/21721)
+ */
+ spaLoadingTemplateLocation: 'body' | 'within'
+
+ /**
+ * Enable timings for Nuxt application hooks in the performance panel of Chromium-based browsers.
+ *
+ * This feature adds performance markers for Nuxt hooks, allowing you to track their execution time in the browser's Performance tab. This is particularly useful for debugging performance issues.
+ *
+ * @example
+ * ```ts
+ * // nuxt.config.ts
+ * export default defineNuxtConfig({
+ * experimental: {
+ * // Enable performance markers for Nuxt hooks in browser devtools
+ * browserDevtoolsTiming: true
+ * }
+ * })
+ * ```
+ *
+ * @default {isDev}
+ *
+ * @see [PR #29922](https://github.com/nuxt/nuxt/pull/29922)
+ *
+ * @see [Chrome DevTools Performance API](https://developer.chrome.com/docs/devtools/performance/extension#tracks)
+ */
+ browserDevtoolsTiming: boolean
+
+ /**
+ * Enable integration with Chrome DevTools Workspaces
+ * for Nuxt projects.
+ *
+ * @default true
+ * @see [Chrome DevTools Project Settings](https://docs.google.com/document/d/1rfKPnxsNuXhnF7AiQZhu9kIwdiMS5hnAI05HBwFuBSM/edit)
+ */
+ chromeDevtoolsProjectSettings: boolean
+
+ /**
+ * Record mutations to `nuxt.options` in module context, helping to debug configuration changes made by modules during the Nuxt initialization phase.
+ *
+ * When enabled, Nuxt will track which modules modify configuration options, making it easier to trace unexpected configuration changes.
+ *
+ * @default false
+ * @example
+ * ```ts
+ * // nuxt.config.ts
+ * export default defineNuxtConfig({
+ * experimental: {
+ * // Enable tracking of config mutations by modules
+ * debugModuleMutation: true
+ * }
+ * })
+ * ```
+ *
+ * @see [PR #30555](https://github.com/nuxt/nuxt/pull/30555)
+ */
+ debugModuleMutation: boolean
+
+ /**
+ * Enable automatic configuration of hydration strategies for `<Lazy>` components.
+ *
+ * This feature intelligently determines when to hydrate lazy components based on visibility, idle time, or other triggers, improving performance by deferring hydration of components until they're needed.
+ *
+ * @default true
+ * @example
+ * ```ts
+ * // nuxt.config.ts
+ * export default defineNuxtConfig({
+ * experimental: {
+ * lazyHydration: true // Enable smart hydration strategies for Lazy components
+ * }
+ * })
+ *
+ * // In your Vue components
+ * <template>
+ * <Lazy>
+ * <ExpensiveComponent />
+ * </Lazy>
+ * </template>
+ * ```
+ *
+ * @see [PR #26468](https://github.com/nuxt/nuxt/pull/26468)
+ */
+ lazyHydration: boolean
+
+ /**
+ * Disable resolving imports into Nuxt templates from the path of the module that added the template.
+ *
+ * By default, Nuxt attempts to resolve imports in templates relative to the module that added them. Setting this to `false` disables this behavior, which may be useful if you're experiencing resolution conflicts in certain environments.
+ *
+ * @default true
+ * @example
+ * ```ts
+ * // nuxt.config.ts
+ * export default defineNuxtConfig({
+ * experimental: {
+ * // Disable template import resolution from module path
+ * templateImportResolution: false
+ * }
+ * })
+ * ```
+ *
+ * @see [PR #31175](https://github.com/nuxt/nuxt/pull/31175)
+ */
+ templateImportResolution: boolean
+
+ /**
+ * Whether to clean up Nuxt static and asyncData caches on route navigation.
+ *
+ * Nuxt will automatically purge cached data from `useAsyncData` and `nuxtApp.static.data`. This helps prevent memory leaks and ensures fresh data is loaded when needed, but it is possible to disable it.
+ * @default true
+ * @example
+ * ```ts
+ * // nuxt.config.ts
+ * export default defineNuxtConfig({
+ * experimental: {
+ * // Disable automatic cache cleanup (default is true)
+ * purgeCachedData: false
+ * }
+ * })
+ * ```
+ *
+ * @see [PR #31379](https://github.com/nuxt/nuxt/pull/31379)
+ */
+ purgeCachedData: boolean
+
+ /**
+ * When a `<NuxtLink>` is prefetched and the destination route has payload extraction enabled (the default for prerendered and cached routes), forward any `<link rel="preload">` hints that the destination set via `useHead` (or via modules like `@nuxt/image`'s `<NuxtImg preload>`) into the current document.
+ *
+ * The forwarded links are downgraded from `rel="preload"` to `rel="prefetch"` so they don't compete with the current page's critical resources. Only user-defined head tags are forwarded; build-time JS/CSS chunk preloads are not.
+ *
+ * @default false
+ * @see [Issue #34953](https://github.com/nuxt/nuxt/issues/34953)
+ */
+ prefetchPreloadTags: boolean
+
+ /**
+ * Whether to call and use the result from `getCachedData` on manual refresh for `useAsyncData` and `useFetch`.
+ *
+ * @default true
+ */
+ granularCachedData: boolean
+
+ /**
+ * Whether to run `useFetch` when the key changes, even if it is set to `immediate: false` and it has not been triggered yet.
+ *
+ * `useFetch` and `useAsyncData` will always run when the key changes if `immediate: true` or if it has been already triggered.
+ *
+ * @default false
+ */
+ alwaysRunFetchOnKeyChange: boolean
+
+ /**
+ * Whether to parse `error.data` when rendering a server error page.
+ *
+ * @default true
+ */
+ parseErrorData: boolean
+
+ /**
+ * Whether Nuxt should stop if a Nuxt module is incompatible.
+ *
+ * @default false
+ */
+ enforceModuleCompatibility: boolean
+
+ /**
+ * For `useAsyncData` and `useFetch`, whether `pending` should be `true` when data has not yet started to be fetched.
+ *
+ * @default false
+ */
+ pendingWhenIdle: boolean
+
+ /**
+ * Whether to improve chunk stability by using an import map to resolve the entry chunk of the bundle.
+ *
+ * @default true
+ */
+ entryImportMap: boolean
+
+ /**
+ * Extract async data handler functions into separate chunks for better performance and caching.
+ *
+ * When enabled, handler functions passed to `useAsyncData` and `useLazyAsyncData` will be extracted
+ * into separate chunks and dynamically imported, allowing for better code splitting and caching.
+ *
+ * @default false
+ * @experimental This is an experimental feature and API may change in the future.
+ */
+ extractAsyncDataHandlers: boolean
+
+ /**
+ * Whether to enable `@dxup/nuxt` module for better TypeScript DX.
+ *
+ * @default false
+ * @see https://github.com/KazariEX/dxup
+ */
+ typescriptPlugin: boolean
+ /**
+ * Whether to add a middleware to handle changes of base URL at runtime (has a performance overhead)
+ *
+ * This option only has effect when using Nitro v3+.
+ * @default false
+ */
+ runtimeBaseURL: boolean
+
+ /**
+ * Whether to enable a compatibility layer for Nitro auto imports.
+ * We recommend migrating to direct imports instead.
+ * @default true
+ * @default false with compatibilityVersion >= 5
+ */
+ nitroAutoImports: boolean
+
+ /**
+ * Whether `callHook` always returns a `Promise`, wrapping synchronous hook results.
+ *
+ * Hookable v6 may return `void` instead of `Promise<void>` when there are no registered
+ * hooks or all hooks are synchronous. When this option is enabled, Nuxt wraps `callHook`
+ * with `Promise.resolve()` so that `.then()` and `.catch()` chaining always works.
+ *
+ * Set to `false` for better performance if your code and modules use `await` with `callHook`.
+ * @default true
+ * @default false with compatibilityVersion >= 5
+ */
+ asyncCallHook: boolean
+
+ /**
+ * Whether to use comment nodes instead of `<div>` elements as placeholders for client-only
+ * components during server-side rendering.
+ *
+ * When enabled, `.client.vue` components and `createClientOnly()` wrappers render an HTML
+ * comment (`<!--placeholder-->`) on the server instead of an empty `<div>`. This fixes a
+ * Vue hydration issue where scoped styles may not be applied when the placeholder `<div>`
+ * and the actual component root share the same tag name.
+ *
+ * Note: enabling this means attributes (class, style, etc.) passed to `.client.vue`
+ * components will not be rendered in the SSR HTML. If you need styled placeholders,
+ * use `<ClientOnly>` with a `#fallback` slot instead.
+ * @default false
+ * @default true with compatibilityVersion >= 5
+ */
+ clientNodePlaceholder: boolean
+
+ /**
+ * When enabled, Nuxt will clear build-related hooks after bundling, freeing
+ * memory before the Nitro build. Disable this if you need to call `build()`
+ * multiple times on the same Nuxt instance (e.g. in benchmarks).
+ */
+ clearBuildHooks: boolean
+ }
+
+ /**
+ *
+ * @private
+ */
+ _majorVersion: number
+
+ /**
+ *
+ * @private
+ */
+ _prepare: boolean
+
+ /**
+ *
+ * @private
+ */
+ _requiredModules: Record<string, boolean>
+
+ /**
+ *
+ * @private
+ */
+ _loadOptions: { dotenv?: boolean | DotenvOptions, envName?: string | false }
+
+ /**
+ *
+ * @private
+ */
+ _nuxtConfigFile: string
+
+ /**
+ *
+ * @private
+ */
+ _nuxtConfigFiles: Array<string>
+
+ /**
+ *
+ * @private
+ */
+ appDir: string
+
+ /**
+ *
+ * @private
+ */
+ _installedModules: Array<{ meta: ModuleMeta, module: NuxtModule, timings?: Record<string, number | undefined>, entryPath?: string }>
+
+ /**
+ *
+ * @private
+ */
+ _modules: Array<any>
+
+ /**
+ * Configuration for Nuxt's server builder.
+ */
+ server: {
+ builder?: '@nuxt/nitro-server' | (string & {}) | { bundle: (nuxt: Nuxt) => Promise<void> }
+ }
+
+ postcss: {
+ /**
+ * A strategy for ordering PostCSS plugins.
+ */
+ order: 'cssnanoLast' | 'autoprefixerLast' | 'autoprefixerAndCssnanoLast' | string[] | ((names: string[]) => string[])
+
+ /**
+ * Options for configuring PostCSS plugins.
+ *
+ * @see [PostCSS docs](https://postcss.org/)
+ */
+ plugins: Record<string, unknown> & { autoprefixer?: false | AutoprefixerOptions, cssnano?: false | CssnanoOptions }
+ }
+
+ router: {
+ /**
+ * Additional router options passed to `vue-router`. On top of the options for `vue-router`, Nuxt offers additional options to customize the router (see below).
+ *
+ * @note Only JSON serializable options should be passed by Nuxt config.
+ * For more control, you can use `app/router.options.ts` file.
+ *
+ * @see [Vue Router documentation](https://router.vuejs.org/api/interfaces/routeroptions)
+ */
+ options: RouterConfigSerializable
+ }
+
+ /**
+ * Configuration for Nuxt's TypeScript integration.
+ */
+ typescript: {
+ /**
+ * TypeScript comes with certain checks to give you more safety and analysis of your program. Once you’ve converted your codebase to TypeScript, you can start enabling these checks for greater safety. [Read More](https://www.typescriptlang.org/docs/handbook/migrating-from-javascript.html#getting-stricter-checks)
+ *
+ */
+ strict: boolean
+
+ /**
+ * Which builder types to include for your project.
+ *
+ * By default Nuxt infers this based on your `builder` option (defaulting to 'vite') but you can either turn off builder environment types (with `false`) to handle this fully yourself, or opt for a 'shared' option.
+ * The 'shared' option is advised for module authors, who will want to support multiple possible builders.
+ */
+ builder: 'vite' | 'webpack' | 'rspack' | 'shared' | false | undefined | null
+
+ /**
+ * Modules to generate deep aliases for within `compilerOptions.paths`. This does not yet support subpaths. It may be necessary when using Nuxt within a pnpm monorepo with `shamefully-hoist=false`.
+ */
+ hoist: Array<string>
+
+ /**
+ * Include parent workspace in the Nuxt project. Mostly useful for themes and module authors.
+ */
+ includeWorkspace: boolean
+
+ /**
+ * Enable build-time type checking.
+ *
+ * If set to true, this will type check in development. You can restrict this to build-time type checking by setting it to `build`. Requires to install `typescript` and `vue-tsc` as dev dependencies.
+ *
+ * @see [Nuxt TypeScript docs](https://nuxt.com/docs/4.x/guide/concepts/typescript)
+ */
+ typeCheck: boolean | 'build'
+
+ /**
+ * You can extend the generated `.nuxt/tsconfig.app.json` (and legacy `.nuxt/tsconfig.json`) using this option.
+ */
+ tsConfig: 0 extends 1 & RawVueCompilerOptions ? TSConfig : TSConfig & { vueCompilerOptions?: RawVueCompilerOptions }
+
+ /**
+ * You can extend the generated `.nuxt/tsconfig.node.json` using this option.
+ */
+ nodeTsConfig: TSConfig
+
+ /**
+ * You can extend the generated `.nuxt/tsconfig.shared.json` using this option.
+ */
+ sharedTsConfig: TSConfig
+
+ /**
+ * Generate a `*.vue` shim.
+ *
+ * We recommend instead letting the [official Vue extension](https://marketplace.visualstudio.com/items?itemName=Vue.volar) generate accurate types for your components.
+ * Note that you may wish to set this to `true` if you are using other libraries, such as ESLint, that are unable to understand the type of `.vue` files.
+ */
+ shim: boolean
+ }
+
+ esbuild: {
+ /**
+ * Configure shared esbuild options used within Nuxt and passed to other builders, such as Vite or Webpack.
+ */
+ options: EsbuildTransformOptions
+ }
+
+ oxc: {
+ transform: {
+ options: OxcTransformOptions
+ }
+ }
+
+ /**
+ * Configuration that will be passed directly to Vite.
+ *
+ * @see [Vite configuration docs](https://vite.dev/config/) for more information.
+ * Please note that not all vite options are supported in Nuxt.
+ */
+ vite: ViteOptions
+
+ webpack: {
+ /**
+ * Nuxt uses `webpack-bundle-analyzer` to visualize your bundles and how to optimize them.
+ *
+ * Set to `true` to enable bundle analysis, or pass an object with options: [for webpack](https://github.com/webpack/webpack-bundle-analyzer#options-for-plugin) or [for vite](https://github.com/btd/rollup-plugin-visualizer#options).
+ *
+ * @example
+ * ```js
+ * analyze: {
+ * analyzerMode: 'static'
+ * }
+ * ```
+ */
+ analyze: boolean | { enabled?: boolean } & BundleAnalyzerPlugin.Options
+
+ /**
+ * Enable the profiler in webpackbar.
+ *
+ * It is normally enabled by CLI argument `--profile`.
+ *
+ * @see [webpackbar](https://github.com/unjs/webpackbar#profile).
+ */
+ profile: boolean
+
+ /**
+ * Enables Common CSS Extraction.
+ *
+ * Using [mini-css-extract-plugin](https://github.com/webpack/mini-css-extract-plugin) under the hood, your CSS will be extracted into separate files, usually one per component. This allows caching your CSS and JavaScript separately.
+ *
+ * @example
+ * ```js
+ * export default {
+ * webpack: {
+ * extractCSS: true,
+ * // or
+ * extractCSS: {
+ * ignoreOrder: true
+ * }
+ * }
+ * }
+ * ```
+ *
+ * If you want to extract all your CSS to a single file, there is a workaround for this.
+ * However, note that it is not recommended to extract everything into a single file.
+ * Extracting into multiple CSS files is better for caching and preload isolation. It
+ * can also improve page performance by downloading and resolving only those resources
+ * that are needed.
+ *
+ * @example
+ * ```js
+ * export default {
+ * webpack: {
+ * extractCSS: true,
+ * optimization: {
+ * splitChunks: {
+ * cacheGroups: {
+ * styles: {
+ * name: 'styles',
+ * test: /\.(css|vue)$/,
+ * chunks: 'all',
+ * enforce: true
+ * }
+ * }
+ * }
+ * }
+ * }
+ * }
+ * ```
+ */
+ extractCSS: boolean | PluginOptions
+
+ /**
+ * Enables CSS source map support (defaults to `true` in development).
+ */
+ cssSourceMap: boolean
+
+ /**
+ * The polyfill library to load to provide URL and URLSearchParams.
+ *
+ * Defaults to `'url'` ([see package](https://www.npmjs.com/package/url)).
+ */
+ serverURLPolyfill: string
+
+ /**
+ * Customize bundle filenames.
+ *
+ * To understand a bit more about the use of manifests, take a look at [webpack documentation](https://webpack.js.org/guides/code-splitting/).
+ *
+ * @note Be careful when using non-hashed based filenames in production
+ * as most browsers will cache the asset and not detect the changes on first load.
+ *
+ * This example changes fancy chunk names to numerical ids:
+ *
+ * @example
+ * ```js
+ * filenames: {
+ * chunk: ({ isDev }) => (isDev ? '[name].js' : '[id].[contenthash].js')
+ * }
+ * ```
+ */
+ filenames:
+ Record<string, string | ((
+ ctx: {
+ nuxt: Nuxt
+ options: NuxtOptions
+ name: string
+ isDev: boolean
+ isServer: boolean
+ isClient: boolean
+ alias: { [index: string]: string | false | string[] }
+ transpile: RegExp[]
+ }) => string)
+ >
+
+ /**
+ * Customize the options of Nuxt's integrated webpack loaders.
+ */
+ loaders: {
+ /**
+ * @see [esbuild loader](https://github.com/privatenumber/esbuild-loader)
+ */
+ esbuild: Omit<LoaderOptions, 'loader'>
+
+ /**
+ * @see [`file-loader` Options](https://github.com/webpack/file-loader#options)
+ */
+ file: {
+ esModule: boolean
+
+ limit: number
+ }
+
+ /**
+ * @see [`file-loader` Options](https://github.com/webpack/file-loader#options)
+ */
+ fontUrl: {
+ esModule: boolean
+
+ limit: number
+ }
+
+ /**
+ * @see [`file-loader` Options](https://github.com/webpack/file-loader#options)
+ */
+ imgUrl: {
+ esModule: boolean
+
+ limit: number
+ }
+
+ /**
+ * @see [`pug` options](https://pugjs.org/api/reference.html#options)
+ */
+ pugPlain: PugOptions
+
+ /**
+ * See [vue-loader](https://github.com/vuejs/vue-loader) for available options.
+ */
+ vue: Partial<VueLoaderOptions>
+
+ /**
+ * See [css-loader](https://github.com/webpack/css-loader) for available options.
+ */
+ css: {
+ importLoaders: number
+
+ url: boolean | { filter: (url: string, resourcePath: string) => boolean }
+
+ esModule: boolean
+ }
+
+ /**
+ * See [css-loader](https://github.com/webpack/css-loader) for available options.
+ */
+ cssModules: {
+ importLoaders: number
+
+ url: boolean | { filter: (url: string, resourcePath: string) => boolean }
+
+ esModule: boolean
+
+ modules: {
+ localIdentName: string
+ }
+ }
+
+ /**
+ * @see [`less-loader` Options](https://github.com/webpack/less-loader#options)
+ */
+ less: any
+
+ /**
+ * @see [`sass-loader` Options](https://github.com/webpack/sass-loader#options)
+ */
+ sass: {
+ sassOptions: {
+ indentedSyntax: boolean
+ }
+ }
+
+ /**
+ * @see [`sass-loader` Options](https://github.com/webpack/sass-loader#options)
+ */
+ scss: any
+
+ /**
+ * @see [`stylus-loader` Options](https://github.com/webpack/stylus-loader#options)
+ */
+ stylus: any
+
+ vueStyle: any
+ }
+
+ /**
+ * Add webpack plugins.
+ *
+ * @example
+ * ```js
+ * import webpack from 'webpack'
+ * import { version } from './package.json.ts'
+ * // ...
+ * plugins: [
+ * new webpack.DefinePlugin({
+ * 'process.VERSION': version
+ * })
+ * ]
+ * ```
+ */
+ plugins: Array<any>
+
+ /**
+ * Hard-replaces `typeof process`, `typeof window` and `typeof document` to tree-shake bundle.
+ */
+ aggressiveCodeRemoval: boolean
+
+ /**
+ * OptimizeCSSAssets plugin options.
+ *
+ * Defaults to true when `extractCSS` is enabled.
+ *
+ * @see [css-minimizer-webpack-plugin documentation](https://github.com/webpack/css-minimizer-webpack-plugin).
+ */
+ // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ optimizeCSS: false | BasePluginOptions & DefinedDefaultMinimizerAndOptions<{}>
+
+ /**
+ * Configure [webpack optimization](https://webpack.js.org/configuration/optimization/).
+ */
+ optimization: false | Configuration['optimization']
+
+ /**
+ * Customize PostCSS Loader. same options as [`postcss-loader` options](https://github.com/webpack/postcss-loader#options)
+ */
+ postcss: { execute?: boolean, postcssOptions: ProcessOptions & { plugins: Record<string, unknown> & { autoprefixer?: AutoprefixerOptions, cssnano?: CssnanoOptions } }, sourceMap?: boolean, implementation?: any }
+
+ /**
+ * See [webpack-dev-middleware](https://github.com/webpack/webpack-dev-middleware) for available options.
+ */
+ devMiddleware: WebpackDevMiddlewareOptions<IncomingMessage, ServerResponse>
+
+ /**
+ * See [webpack-hot-middleware](https://github.com/webpack/webpack-hot-middleware) for available options.
+ */
+ hotMiddleware: MiddlewareOptions & { client?: ClientOptions }
+
+ /**
+ * Set to `false` to disable the overlay provided by [FriendlyErrorsWebpackPlugin](https://github.com/nuxt/friendly-errors-webpack-plugin).
+ */
+ friendlyErrors: boolean
+
+ /**
+ * Filters to hide build warnings.
+ */
+ warningIgnoreFilters: Array<(warn: WebpackError | Error) => boolean>
+
+ /**
+ * Configure [webpack experiments](https://webpack.js.org/configuration/experiments/)
+ */
+ experiments: false | Configuration['experiments']
+ }
+}
diff --git a/packages/schema/src/utils/definition.ts b/packages/schema/src/utils/definition.ts
new file mode 100644
index 000000000000..ebdc1a24a82d
--- /dev/null
+++ b/packages/schema/src/utils/definition.ts
@@ -0,0 +1,66 @@
+import type { InputObject } from 'untyped'
+
+import type { ConfigSchema } from '../types/schema.ts'
+
+type KeysOf<T, Prefix extends string | unknown = unknown> = keyof T extends string
+ ?
+ {
+ [K in keyof T]: K extends string
+ ? string extends K
+ ? never // exclude generic 'string' type
+ : unknown extends Prefix
+ ? `${K | KeysOf<T[K], K>}`
+ : Prefix extends string
+ ? `${Prefix}.${K | KeysOf<T[K], `hey.${Prefix}.${K}`>}`
+ : never
+ : never
+ }[keyof T]
+ : never
+
+type ReturnFromKey<T, K extends string> = keyof T extends string
+ ? K extends keyof T
+ ? T[K]
+ : K extends `${keyof T}.${string}`
+ ? K extends `${infer Prefix}.${string}`
+ ? Prefix extends keyof T
+ ? K extends `${Prefix}.${infer Suffix}`
+ ? ReturnFromKey<T[Prefix], Suffix>
+ : never
+ : never
+ : never
+ : never
+ : never
+
+export type Awaitable<T> = T | Promise<T>
+export type MaybeArray<T> = T | T[]
+
+export type JavascriptExtension = 'js' | 'ts' | 'tsx' | 'jsx' | 'mjs' | 'cjs' | 'mts' | 'cts'
+export type VueExtension = 'vue'
+
+/**
+ * Allows adding additional types to a property of an object.
+ * If the property is an array, the type will be added to the array items.
+ */
+export type AugmentProperty<T extends Record<string, any>, K extends keyof T, V> = {
+ [key in keyof T]: key extends K
+ ? NonNullable<T[key]> extends Array<infer U>
+ ? (U | V)[]
+ : T[key]
+ : T[key]
+}
+
+interface Resolvers<ReturnValue> {
+ $resolve: (val: unknown, get: <K extends KeysOf<ConfigSchema>>(key: K) => Promise<ReturnFromKey<ConfigSchema, K>>) => Awaitable<ReturnValue>
+ $schema?: InputObject['$schema']
+ $default?: ReturnValue
+}
+
+type Resolvable<Namespace> = keyof Exclude<NonNullable<Namespace>, boolean | string | (() => any)> extends string
+ ? {
+ [K in keyof Namespace]: Partial<Resolvable<Namespace[K]>> | Resolvers<Namespace[K]>
+ } | Namespace
+ : Namespace | Resolvers<Namespace>
+
+export function defineResolvers<C extends Partial<Resolvable<ConfigSchema>>> (config: C) {
+ return config as any
+}
diff --git a/packages/schema/test/experimental.spec.ts b/packages/schema/test/experimental.spec.ts
new file mode 100644
index 000000000000..3ccb1353ace8
--- /dev/null
+++ b/packages/schema/test/experimental.spec.ts
@@ -0,0 +1,31 @@
+import { describe, expect, it, vi } from 'vitest'
+import { applyDefaults } from 'untyped'
+
+import { NuxtConfigSchema } from '../src/index.ts'
+import type { NuxtOptions } from '../src/index.ts'
+
+vi.mock('node:fs', () => ({
+ existsSync: (id: string) => id.endsWith('app'),
+}))
+
+describe('experimental.watcher default', () => {
+ it('defaults to `builder` when compatibilityVersion is 5', async () => {
+ const result = await applyDefaults(NuxtConfigSchema, { future: { compatibilityVersion: 5 } })
+ expect((result as unknown as NuxtOptions).experimental.watcher).toBe('builder')
+ })
+
+ it('defaults to `chokidar-granular` for v3-style layout (srcDir === rootDir)', async () => {
+ const result = await applyDefaults(NuxtConfigSchema, { future: { compatibilityVersion: 3 }, srcDir: '/test', rootDir: '/test' })
+ expect((result as unknown as NuxtOptions).experimental.watcher).toBe('chokidar-granular')
+ })
+
+ it('defaults to `chokidar` for v3 when srcDir differs from rootDir', async () => {
+ const result = await applyDefaults(NuxtConfigSchema, { future: { compatibilityVersion: 3 }, srcDir: 'src/', rootDir: '/test' })
+ expect((result as unknown as NuxtOptions).experimental.watcher).toBe('chokidar')
+ })
+
+ it('respects an explicit string value', async () => {
+ const result = await applyDefaults(NuxtConfigSchema, { future: { compatibilityVersion: 5 }, experimental: { watcher: 'parcel' } })
+ expect((result as unknown as NuxtOptions).experimental.watcher).toBe('parcel')
+ })
+})
diff --git a/packages/schema/test/folder-structure.spec.ts b/packages/schema/test/folder-structure.spec.ts
new file mode 100644
index 000000000000..2deee0ceb11c
--- /dev/null
+++ b/packages/schema/test/folder-structure.spec.ts
@@ -0,0 +1,115 @@
+import { describe, expect, it, vi } from 'vitest'
+import { applyDefaults } from 'untyped'
+import process from 'node:process'
+
+import { normalize } from 'pathe'
+import { NuxtConfigSchema } from '../src/index.ts'
+import type { NuxtOptions } from '../src/index.ts'
+
+vi.mock('node:fs', () => ({
+ existsSync: (id: string) => id.endsWith('app'),
+}))
+
+describe('nuxt folder structure', () => {
+ it('should resolve directories for v3 setup correctly', async () => {
+ const result = await applyDefaults(NuxtConfigSchema, {})
+ expect(getDirs(result as unknown as NuxtOptions)).toMatchInlineSnapshot(`
+ {
+ "dir": {
+ "app": "<cwd>/app",
+ "modules": "<cwd>/modules",
+ "public": "<cwd>/public",
+ },
+ "rootDir": "<cwd>",
+ "serverDir": "<cwd>/server",
+ "srcDir": "<cwd>/app",
+ "workspaceDir": "<cwd>",
+ }
+ `)
+ })
+
+ it('should resolve directories with a custom `srcDir` and `rootDir`', async () => {
+ const result = await applyDefaults(NuxtConfigSchema, { srcDir: 'src/', rootDir: '/test' })
+ expect(getDirs(result as unknown as NuxtOptions)).toMatchInlineSnapshot(`
+ {
+ "dir": {
+ "app": "/test/src",
+ "modules": "/test/modules",
+ "public": "/test/public",
+ },
+ "rootDir": "/test",
+ "serverDir": "/test/server",
+ "srcDir": "/test/src",
+ "workspaceDir": "/test",
+ }
+ `)
+ })
+
+ it('should resolve directories', async () => {
+ const result = await applyDefaults(NuxtConfigSchema, {})
+ expect(getDirs(result as unknown as NuxtOptions)).toMatchInlineSnapshot(`
+ {
+ "dir": {
+ "app": "<cwd>/app",
+ "modules": "<cwd>/modules",
+ "public": "<cwd>/public",
+ },
+ "rootDir": "<cwd>",
+ "serverDir": "<cwd>/server",
+ "srcDir": "<cwd>/app",
+ "workspaceDir": "<cwd>",
+ }
+ `)
+ })
+
+ it('should resolve directories when opting-in to v4 schema with a custom `srcDir` and `rootDir`', async () => {
+ const result = await applyDefaults(NuxtConfigSchema, { srcDir: 'customApp/', rootDir: '/test' })
+ expect(getDirs(result as unknown as NuxtOptions)).toMatchInlineSnapshot(`
+ {
+ "dir": {
+ "app": "/test/customApp",
+ "modules": "/test/modules",
+ "public": "/test/public",
+ },
+ "rootDir": "/test",
+ "serverDir": "/test/server",
+ "srcDir": "/test/customApp",
+ "workspaceDir": "/test",
+ }
+ `)
+ })
+
+ it('should not override value from user for serverDir', async () => {
+ const result = await applyDefaults(NuxtConfigSchema, { serverDir: '/myServer' })
+ expect(getDirs(result as unknown as NuxtOptions)).toMatchInlineSnapshot(`
+ {
+ "dir": {
+ "app": "<cwd>/app",
+ "modules": "<cwd>/modules",
+ "public": "<cwd>/public",
+ },
+ "rootDir": "<cwd>",
+ "serverDir": "/myServer",
+ "srcDir": "<cwd>/app",
+ "workspaceDir": "<cwd>",
+ }
+ `)
+ })
+})
+
+function getDirs (options: NuxtOptions) {
+ const stripRoot = (dir: string) => {
+ return normalize(dir).replace(normalize(process.cwd()), '<cwd>')
+ }
+ return {
+ rootDir: stripRoot(options.rootDir),
+ serverDir: stripRoot(options.serverDir),
+ srcDir: stripRoot(options.srcDir),
+ dir: {
+ app: stripRoot(options.dir.app),
+ modules: stripRoot(options.dir.modules),
+ public: stripRoot(options.dir.public),
+ },
+ workspaceDir: stripRoot(options.workspaceDir!),
+ }
+}
diff --git a/packages/server/package.js b/packages/server/package.js
deleted file mode 100644
index 2f78f772eec0..000000000000
--- a/packages/server/package.js
+++ /dev/null
@@ -1,6 +0,0 @@
-export default {
- build: true,
- rollup: {
- externals: ['jsdom']
- }
-}
diff --git a/packages/server/package.json b/packages/server/package.json
deleted file mode 100644
index d3af57dd6a10..000000000000
--- a/packages/server/package.json
+++ /dev/null
@@ -1,33 +0,0 @@
-{
- "name": "@nuxt/server",
- "version": "2.12.1",
- "repository": "nuxt/nuxt.js",
- "license": "MIT",
- "main": "dist/server.js",
- "files": [
- "dist"
- ],
- "dependencies": {
- "@nuxt/config": "2.12.1",
- "@nuxt/utils": "2.12.1",
- "@nuxt/vue-renderer": "2.12.1",
- "@nuxtjs/youch": "^4.2.3",
- "chalk": "^3.0.0",
- "compression": "^1.7.4",
- "connect": "^3.7.0",
- "consola": "^2.11.3",
- "etag": "^1.8.1",
- "fresh": "^0.5.2",
- "fs-extra": "^8.1.0",
- "ip": "^1.1.5",
- "launch-editor-middleware": "^2.2.1",
- "on-headers": "^1.0.2",
- "pify": "^4.0.1",
- "serve-placeholder": "^1.2.2",
- "serve-static": "^1.14.1",
- "server-destroy": "^1.0.1"
- },
- "publishConfig": {
- "access": "public"
- }
-}
diff --git a/packages/server/src/context.js b/packages/server/src/context.js
deleted file mode 100644
index 99dc07c3218a..000000000000
--- a/packages/server/src/context.js
+++ /dev/null
@@ -1,8 +0,0 @@
-export default class ServerContext {
- constructor (server) {
- this.nuxt = server.nuxt
- this.globals = server.globals
- this.options = server.options
- this.resources = server.resources
- }
-}
diff --git a/packages/server/src/index.js b/packages/server/src/index.js
deleted file mode 100644
index 854a01a63b59..000000000000
--- a/packages/server/src/index.js
+++ /dev/null
@@ -1,2 +0,0 @@
-export { default as Server } from './server'
-export { default as Listener } from './listener'
diff --git a/packages/server/src/jsdom.js b/packages/server/src/jsdom.js
deleted file mode 100644
index 9a18df8bd324..000000000000
--- a/packages/server/src/jsdom.js
+++ /dev/null
@@ -1,75 +0,0 @@
-import consola from 'consola'
-import { timeout } from '@nuxt/utils'
-
-export default async function renderAndGetWindow (
- url = 'http://localhost:3000',
- jsdomOpts = {},
- {
- loadedCallback,
- loadingTimeout = 2000,
- ssr,
- globals
- } = {}
-) {
- const jsdom = await import('jsdom')
- .then(m => m.default || m)
- .catch((e) => {
- consola.error(`
- jsdom is not installed. Please install jsdom with:
- $ yarn add --dev jsdom
- OR
- $ npm install --dev jsdom
- `)
- throw e
- })
-
- const options = Object.assign({
- // Load subresources (https://github.com/tmpvar/jsdom#loading-subresources)
- resources: 'usable',
- runScripts: 'dangerously',
- virtualConsole: true,
- beforeParse (window) {
- // Mock window.scrollTo
- window.scrollTo = () => {}
- }
- }, jsdomOpts)
-
- const jsdomErrHandler = (err) => {
- throw err
- }
-
- if (options.virtualConsole) {
- if (options.virtualConsole === true) {
- options.virtualConsole = new jsdom.VirtualConsole().sendTo(consola)
- }
- // Throw error when window creation failed
- options.virtualConsole.on('jsdomError', jsdomErrHandler)
- }
-
- const { window } = await jsdom.JSDOM.fromURL(url, options)
-
- // If Nuxt could not be loaded (error from the server-side)
- const nuxtExists = window.document.body.innerHTML.includes(
- ssr ? `window.${globals.context}` : `<div id="${globals.id}">`
- )
-
- if (!nuxtExists) {
- const error = new Error('Could not load the nuxt app')
- error.body = window.document.body.innerHTML
- window.close()
- throw error
- }
-
- // Used by Nuxt.js to say when the components are loaded and the app ready
- await timeout(new Promise((resolve) => {
- window[loadedCallback] = () => resolve(window)
- }), loadingTimeout, `Components loading in renderAndGetWindow was not completed in ${loadingTimeout / 1000}s`)
-
- if (options.virtualConsole) {
- // After window initialized successfully
- options.virtualConsole.removeListener('jsdomError', jsdomErrHandler)
- }
-
- // Send back window object
- return window
-}
diff --git a/packages/server/src/listener.js b/packages/server/src/listener.js
deleted file mode 100644
index 125a566f6c8a..000000000000
--- a/packages/server/src/listener.js
+++ /dev/null
@@ -1,119 +0,0 @@
-import http from 'http'
-import https from 'https'
-import enableDestroy from 'server-destroy'
-import ip from 'ip'
-import consola from 'consola'
-import pify from 'pify'
-
-let RANDOM_PORT = '0'
-
-export default class Listener {
- constructor ({ port, host, socket, https, app, dev, baseURL }) {
- // Options
- this.port = port
- this.host = host
- this.socket = socket
- this.https = https
- this.app = app
- this.dev = dev
- this.baseURL = baseURL
-
- // After listen
- this.listening = false
- this._server = null
- this.server = null
- this.address = null
- this.url = null
- }
-
- async close () {
- // Destroy server by forcing every connection to be closed
- if (this.server && this.server.listening) {
- await this.server.destroy()
- consola.debug('server closed')
- }
-
- // Delete references
- this.listening = false
- this._server = null
- this.server = null
- this.address = null
- this.url = null
- }
-
- computeURL () {
- const address = this.server.address()
- if (!this.socket) {
- switch (address.address) {
- case '127.0.0.1': this.host = 'localhost'; break
- case '0.0.0.0': this.host = ip.address(); break
- }
- this.port = address.port
- this.url = `http${this.https ? 's' : ''}://${this.host}:${this.port}${this.baseURL}`
- return
- }
- this.url = `unix+http://${address}`
- }
-
- async listen () {
- // Prevent multi calls
- if (this.listening) {
- return
- }
-
- // Initialize underlying http(s) server
- const protocol = this.https ? https : http
- const protocolOpts = this.https ? [this.https] : []
- this._server = protocol.createServer.apply(protocol, protocolOpts.concat(this.app))
-
- // Call server.listen
- // Prepare listenArgs
- const listenArgs = this.socket ? { path: this.socket } : { host: this.host, port: this.port }
- listenArgs.exclusive = false
-
- // Call server.listen
- try {
- this.server = await new Promise((resolve, reject) => {
- this._server.on('error', error => reject(error))
- const s = this._server.listen(listenArgs, error => error ? reject(error) : resolve(s))
- })
- } catch (error) {
- return this.serverErrorHandler(error)
- }
-
- // Enable destroy support
- enableDestroy(this.server)
- pify(this.server.destroy)
-
- // Compute listen URL
- this.computeURL()
-
- // Set this.listening to true
- this.listening = true
- }
-
- async serverErrorHandler (error) {
- // Detect if port is not available
- const addressInUse = error.code === 'EADDRINUSE'
-
- // Use better error message
- if (addressInUse) {
- const address = this.socket || `${this.host}:${this.port}`
- error.message = `Address \`${address}\` is already in use.`
-
- // Listen to a random port on dev as a fallback
- if (this.dev && !this.socket && this.port !== RANDOM_PORT) {
- consola.warn(error.message)
- consola.info('Trying a random port...')
- this.port = RANDOM_PORT
- await this.close()
- await this.listen()
- RANDOM_PORT = this.port
- return
- }
- }
-
- // Throw error
- throw error
- }
-}
diff --git a/packages/server/src/middleware/error.js b/packages/server/src/middleware/error.js
deleted file mode 100644
index 05e61ffaa753..000000000000
--- a/packages/server/src/middleware/error.js
+++ /dev/null
@@ -1,128 +0,0 @@
-import path from 'path'
-import fs from 'fs-extra'
-import consola from 'consola'
-
-import Youch from '@nuxtjs/youch'
-
-export default ({ resources, options }) => async function errorMiddleware (err, req, res, next) {
- // ensure statusCode, message and name fields
-
- const error = {
- statusCode: err.statusCode || 500,
- message: err.message || 'Nuxt Server Error',
- name: !err.name || err.name === 'Error' ? 'NuxtServerError' : err.name,
- headers: err.headers
- }
-
- const sendResponse = (content, type = 'text/html') => {
- // Set Headers
- res.statusCode = error.statusCode
- res.statusMessage = error.name
- res.setHeader('Content-Type', type + '; charset=utf-8')
- res.setHeader('Content-Length', Buffer.byteLength(content))
- res.setHeader('Cache-Control', 'no-cache, no-store, max-age=0, must-revalidate')
-
- // Error headers
- if (error.headers) {
- for (const name in error.headers) {
- res.setHeader(name, error.headers[name])
- }
- }
-
- // Send Response
- res.end(content, 'utf-8')
- }
-
- // Check if request accepts JSON
- const hasReqHeader = (header, includes) =>
- req.headers[header] && req.headers[header].toLowerCase().includes(includes)
- const isJson =
- hasReqHeader('accept', 'application/json') ||
- hasReqHeader('user-agent', 'curl/')
-
- // Use basic errors when debug mode is disabled
- if (!options.debug) {
- // We hide actual errors from end users, so show them on server logs
- if (err.statusCode !== 404) {
- consola.error(err)
- }
- // Json format is compatible with Youch json responses
- const json = {
- status: error.statusCode,
- message: error.message,
- name: error.name
- }
- if (isJson) {
- sendResponse(JSON.stringify(json, undefined, 2), 'text/json')
- return
- }
- const html = resources.errorTemplate(json)
- sendResponse(html)
- return
- }
-
- const errorFull = err instanceof Error
- ? err
- : typeof err === 'string'
- ? new Error(err)
- : new Error(err.message || JSON.stringify(err))
-
- errorFull.name = error.name
- errorFull.statusCode = error.statusCode
- errorFull.stack = err.stack || undefined
-
- // Show stack trace
- const youch = new Youch(
- errorFull,
- req,
- readSourceFactory({
- srcDir: options.srcDir,
- rootDir: options.rootDir,
- buildDir: options.buildDir
- }),
- options.router.base,
- true
- )
- if (isJson) {
- const json = await youch.toJSON()
- sendResponse(JSON.stringify(json, undefined, 2), 'text/json')
- return
- }
-
- const html = await youch.toHTML()
- sendResponse(html)
-}
-
-const readSourceFactory = ({ srcDir, rootDir, buildDir }) => async function readSource (frame) {
- // Remove webpack:/// & query string from the end
- const sanitizeName = name => name ? name.replace('webpack:///', '').split('?')[0] : null
- frame.fileName = sanitizeName(frame.fileName)
-
- // Return if fileName is unknown
- if (!frame.fileName) {
- return
- }
-
- // Possible paths for file
- const searchPath = [
- srcDir,
- rootDir,
- path.join(buildDir, 'dist', 'server'),
- buildDir,
- process.cwd()
- ]
-
- // Scan filesystem for real source
- for (const pathDir of searchPath) {
- const fullPath = path.resolve(pathDir, frame.fileName)
- const source = await fs.readFile(fullPath, 'utf-8').catch(() => null)
- if (source) {
- frame.contents = source
- frame.fullPath = fullPath
- if (path.isAbsolute(frame.fileName)) {
- frame.fileName = path.relative(rootDir, fullPath)
- }
- return
- }
- }
-}
diff --git a/packages/server/src/middleware/nuxt.js b/packages/server/src/middleware/nuxt.js
deleted file mode 100644
index ed9058be07ae..000000000000
--- a/packages/server/src/middleware/nuxt.js
+++ /dev/null
@@ -1,154 +0,0 @@
-import generateETag from 'etag'
-import fresh from 'fresh'
-import consola from 'consola'
-
-import { getContext } from '@nuxt/utils'
-
-export default ({ options, nuxt, renderRoute, resources }) => async function nuxtMiddleware (req, res, next) {
- // Get context
- const context = getContext(req, res)
-
- try {
- const url = decodeURI(req.url)
- res.statusCode = 200
- const result = await renderRoute(url, context)
-
- // If result is falsy, call renderLoading
- if (!result) {
- await nuxt.callHook('server:nuxt:renderLoading', req, res)
- return
- }
-
- await nuxt.callHook('render:route', url, result, context)
- const {
- html,
- cspScriptSrcHashes,
- error,
- redirected,
- preloadFiles
- } = result
-
- if (redirected) {
- await nuxt.callHook('render:routeDone', url, result, context)
- return html
- }
- if (error) {
- res.statusCode = context.nuxt.error.statusCode || 500
- }
-
- // Add ETag header
- if (!error && options.render.etag) {
- const { hash } = options.render.etag
- const etag = hash ? hash(html, options.render.etag) : generateETag(html, options.render.etag)
- if (fresh(req.headers, { etag })) {
- res.statusCode = 304
- res.end()
- await nuxt.callHook('render:routeDone', url, result, context)
- return
- }
- res.setHeader('ETag', etag)
- }
-
- // HTTP2 push headers for preload assets
- if (!error && options.render.http2.push) {
- // Parse resourceHints to extract HTTP.2 prefetch/push headers
- // https://w3c.github.io/preload/#server-push-http-2
- const { shouldPush, pushAssets } = options.render.http2
- const { publicPath } = resources.clientManifest
-
- const links = pushAssets
- ? pushAssets(req, res, publicPath, preloadFiles)
- : defaultPushAssets(preloadFiles, shouldPush, publicPath, options)
-
- // Pass with single Link header
- // https://blog.cloudflare.com/http-2-server-push-with-multiple-assets-per-link-header
- // https://www.w3.org/Protocols/9707-link-header.html
- if (links.length > 0) {
- res.setHeader('Link', links.join(', '))
- }
- }
-
- if (options.render.csp && cspScriptSrcHashes) {
- const { allowedSources, policies } = options.render.csp
- const cspHeader = options.render.csp.reportOnly ? 'Content-Security-Policy-Report-Only' : 'Content-Security-Policy'
-
- res.setHeader(cspHeader, getCspString({ cspScriptSrcHashes, allowedSources, policies, isDev: options.dev }))
- }
-
- // Send response
- res.setHeader('Content-Type', 'text/html; charset=utf-8')
- res.setHeader('Accept-Ranges', 'none') // #3870
- res.setHeader('Content-Length', Buffer.byteLength(html))
- res.end(html, 'utf8')
- await nuxt.callHook('render:routeDone', url, result, context)
- return html
- } catch (err) {
- if (context && context.redirected) {
- consola.error(err)
- return err
- }
-
- if (err.name === 'URIError') {
- err.statusCode = 400
- }
- next(err)
- }
-}
-
-const defaultPushAssets = (preloadFiles, shouldPush, publicPath, options) => {
- if (shouldPush && options.dev) {
- consola.warn('http2.shouldPush is deprecated. Use http2.pushAssets function')
- }
-
- const links = []
- preloadFiles.forEach(({ file, asType, fileWithoutQuery, modern }) => {
- // By default, we only preload scripts or css
- if (!shouldPush && asType !== 'script' && asType !== 'style') {
- return
- }
-
- // User wants to explicitly control what to preload
- if (shouldPush && !shouldPush(fileWithoutQuery, asType)) {
- return
- }
-
- const { crossorigin } = options.render
- const cors = `${crossorigin ? ` crossorigin=${crossorigin};` : ''}`
- // `modulepreload` rel attribute only supports script-like `as` value
- // https://html.spec.whatwg.org/multipage/links.html#link-type-modulepreload
- const rel = modern && asType === 'script' ? 'modulepreload' : 'preload'
-
- links.push(`<${publicPath}${file}>; rel=${rel};${cors} as=${asType}`)
- })
- return links
-}
-
-const getCspString = ({ cspScriptSrcHashes, allowedSources, policies, isDev }) => {
- const joinedHashes = cspScriptSrcHashes.join(' ')
- const baseCspStr = `script-src 'self'${isDev ? ' \'unsafe-eval\'' : ''} ${joinedHashes}`
-
- if (Array.isArray(allowedSources) && allowedSources.length) {
- return `${baseCspStr} ${allowedSources.join(' ')}`
- }
-
- const policyObjectAvailable = typeof policies === 'object' && policies !== null && !Array.isArray(policies)
-
- if (policyObjectAvailable) {
- const transformedPolicyObject = transformPolicyObject(policies, cspScriptSrcHashes)
-
- return Object.entries(transformedPolicyObject).map(([k, v]) => `${k} ${v.join(' ')}`).join('; ')
- }
-
- return baseCspStr
-}
-
-const transformPolicyObject = (policies, cspScriptSrcHashes) => {
- const userHasDefinedScriptSrc = policies['script-src'] && Array.isArray(policies['script-src'])
-
- const additionalPolicies = userHasDefinedScriptSrc ? policies['script-src'] : []
-
- // Self is always needed for inline-scripts, so add it, no matter if the user specified script-src himself.
- const hashAndPolicyList = cspScriptSrcHashes.concat('\'self\'', additionalPolicies)
-
- return { ...policies, 'script-src': hashAndPolicyList }
-}
diff --git a/packages/server/src/middleware/timing.js b/packages/server/src/middleware/timing.js
deleted file mode 100644
index b8438c742eb0..000000000000
--- a/packages/server/src/middleware/timing.js
+++ /dev/null
@@ -1,56 +0,0 @@
-import consola from 'consola'
-import onHeaders from 'on-headers'
-import { Timer } from '@nuxt/utils'
-
-export default options => (req, res, next) => {
- if (res.timing) {
- consola.warn('server-timing is already registered.')
- }
- res.timing = new ServerTiming()
-
- if (options && options.total) {
- res.timing.start('total', 'Nuxt Server Time')
- }
-
- onHeaders(res, () => {
- res.timing.end('total')
-
- if (res.timing.headers.length > 0) {
- res.setHeader(
- 'Server-Timing',
- []
- .concat(res.getHeader('Server-Timing') || [])
- .concat(res.timing.headers)
- .join(', ')
- )
- }
- res.timing.clear()
- })
-
- next()
-}
-
-class ServerTiming extends Timer {
- constructor (...args) {
- super(...args)
- this.headers = []
- }
-
- end (...args) {
- const time = super.end(...args)
- if (time) {
- this.headers.push(this.formatHeader(time))
- }
- return time
- }
-
- clear () {
- super.clear()
- this.headers.length = 0
- }
-
- formatHeader (time) {
- const desc = time.description ? `;desc="${time.description}"` : ''
- return `${time.name};dur=${time.duration}${desc}`
- }
-}
diff --git a/packages/server/src/server.js b/packages/server/src/server.js
deleted file mode 100644
index 1496e357dc6f..000000000000
--- a/packages/server/src/server.js
+++ /dev/null
@@ -1,381 +0,0 @@
-import path from 'path'
-import consola from 'consola'
-import launchMiddleware from 'launch-editor-middleware'
-import serveStatic from 'serve-static'
-import servePlaceholder from 'serve-placeholder'
-import connect from 'connect'
-import { determineGlobals, isUrl } from '@nuxt/utils'
-
-import ServerContext from './context'
-import renderAndGetWindow from './jsdom'
-import nuxtMiddleware from './middleware/nuxt'
-import errorMiddleware from './middleware/error'
-import Listener from './listener'
-import createTimingMiddleware from './middleware/timing'
-
-export default class Server {
- constructor (nuxt) {
- this.nuxt = nuxt
- this.options = nuxt.options
-
- this.globals = determineGlobals(nuxt.options.globalName, nuxt.options.globals)
-
- this.publicPath = isUrl(this.options.build.publicPath)
- ? this.options.build._publicPath
- : this.options.build.publicPath
-
- // Runtime shared resources
- this.resources = {}
-
- // Will be set after listen
- this.listeners = []
-
- // Create new connect instance
- this.app = connect()
-
- // Close hook
- this.nuxt.hook('close', () => this.close())
-
- // devMiddleware placeholder
- if (this.options.dev) {
- this.nuxt.hook('server:devMiddleware', (devMiddleware) => {
- this.devMiddleware = devMiddleware
- })
- }
- }
-
- async ready () {
- if (this._readyCalled) {
- return this
- }
- this._readyCalled = true
-
- await this.nuxt.callHook('render:before', this, this.options.render)
-
- // Initialize vue-renderer
- const { VueRenderer } = await import('@nuxt/vue-renderer')
-
- this.serverContext = new ServerContext(this)
- this.renderer = new VueRenderer(this.serverContext)
- await this.renderer.ready()
-
- // Setup nuxt middleware
- await this.setupMiddleware()
-
- // Call done hook
- await this.nuxt.callHook('render:done', this)
-
- return this
- }
-
- async setupMiddleware () {
- // Apply setupMiddleware from modules first
- await this.nuxt.callHook('render:setupMiddleware', this.app)
-
- // Compression middleware for production
- if (!this.options.dev) {
- const { compressor } = this.options.render
- if (typeof compressor === 'object') {
- // If only setting for `compression` are provided, require the module and insert
- const compression = this.nuxt.resolver.requireModule('compression')
- this.useMiddleware(compression(compressor))
- } else if (compressor) {
- // Else, require own compression middleware if compressor is actually truthy
- this.useMiddleware(compressor)
- }
- }
-
- if (this.options.server.timing) {
- this.useMiddleware(createTimingMiddleware(this.options.server.timing))
- }
-
- // For serving static/ files to /
- const staticMiddleware = serveStatic(
- path.resolve(this.options.srcDir, this.options.dir.static),
- this.options.render.static
- )
- staticMiddleware.prefix = this.options.render.static.prefix
- this.useMiddleware(staticMiddleware)
-
- // Serve .nuxt/dist/client files only for production
- // For dev they will be served with devMiddleware
- if (!this.options.dev) {
- const distDir = path.resolve(this.options.buildDir, 'dist', 'client')
- this.useMiddleware({
- path: this.publicPath,
- handler: serveStatic(
- distDir,
- this.options.render.dist
- )
- })
- }
-
- // Dev middleware
- if (this.options.dev) {
- this.useMiddleware((req, res, next) => {
- if (!this.devMiddleware) {
- return next()
- }
- this.devMiddleware(req, res, next)
- })
-
- // open in editor for debug mode only
- if (this.options.debug) {
- this.useMiddleware({
- path: '__open-in-editor',
- handler: launchMiddleware(this.options.editor)
- })
- }
- }
-
- // Add user provided middleware
- for (const m of this.options.serverMiddleware) {
- this.useMiddleware(m)
- }
-
- // Graceful 404 error handler
- const { fallback } = this.options.render
- if (fallback) {
- // Dist files
- if (fallback.dist) {
- this.useMiddleware({
- path: this.publicPath,
- handler: servePlaceholder(fallback.dist)
- })
- }
-
- // Other paths
- if (fallback.static) {
- this.useMiddleware({
- path: '/',
- handler: servePlaceholder(fallback.static)
- })
- }
- }
-
- // Finally use nuxtMiddleware
- this.useMiddleware(nuxtMiddleware({
- options: this.options,
- nuxt: this.nuxt,
- renderRoute: this.renderRoute.bind(this),
- resources: this.resources
- }))
-
- // Apply errorMiddleware from modules first
- await this.nuxt.callHook('render:errorMiddleware', this.app)
-
- // Error middleware for errors that occurred in middleware that declared above
- this.useMiddleware(errorMiddleware({
- resources: this.resources,
- options: this.options
- }))
- }
-
- _normalizeMiddleware (middleware) {
- // Normalize plain function
- if (typeof middleware === 'function') {
- middleware = { handle: middleware }
- }
-
- // If a plain string provided as path to middleware
- if (typeof middleware === 'string') {
- middleware = this._requireMiddleware(middleware)
- }
-
- // Normalize handler to handle (backward compatibility)
- if (middleware.handler && !middleware.handle) {
- middleware.handle = middleware.handler
- delete middleware.handler
- }
-
- // Normalize path to route (backward compatibility)
- if (middleware.path && !middleware.route) {
- middleware.route = middleware.path
- delete middleware.path
- }
-
- // If handle is a string pointing to path
- if (typeof middleware.handle === 'string') {
- Object.assign(middleware, this._requireMiddleware(middleware.handle))
- }
-
- // No handle
- if (!middleware.handle) {
- middleware.handle = (req, res, next) => {
- next(new Error('ServerMiddleware should expose a handle: ' + middleware.entry))
- }
- }
-
- // Prefix on handle (proxy-module)
- if (middleware.handle.prefix !== undefined && middleware.prefix === undefined) {
- middleware.prefix = middleware.handle.prefix
- }
-
- // sub-app (express)
- if (typeof middleware.handle.handle === 'function') {
- const server = middleware.handle
- middleware.handle = server.handle.bind(server)
- }
-
- return middleware
- }
-
- _requireMiddleware (entry) {
- // Resolve entry
- entry = this.nuxt.resolver.resolvePath(entry)
-
- // Require middleware
- let middleware
- try {
- middleware = this.nuxt.resolver.requireModule(entry)
- } catch (error) {
- // Show full error
- consola.error('ServerMiddleware Error:', error)
-
- // Placeholder for error
- middleware = (req, res, next) => { next(error) }
- }
-
- // Normalize
- middleware = this._normalizeMiddleware(middleware)
-
- // Set entry
- middleware.entry = entry
-
- return middleware
- }
-
- resolveMiddleware (middleware, fallbackRoute = '/') {
- // Ensure middleware is normalized
- middleware = this._normalizeMiddleware(middleware)
-
- // Fallback route
- if (!middleware.route) {
- middleware.route = fallbackRoute
- }
-
- // Resolve final route
- middleware.route = (
- (middleware.prefix !== false ? this.options.router.base : '') +
- (typeof middleware.route === 'string' ? middleware.route : '')
- ).replace(/\/\//g, '/')
-
- // Strip trailing slash
- if (middleware.route.endsWith('/')) {
- middleware.route = middleware.route.slice(0, -1)
- }
-
- // Assign _middleware to handle to make accessible from app.stack
- middleware.handle._middleware = middleware
-
- return middleware
- }
-
- useMiddleware (middleware) {
- const { route, handle } = this.resolveMiddleware(middleware)
- this.app.use(route, handle)
- }
-
- replaceMiddleware (query, middleware) {
- let serverStackItem
-
- if (typeof query === 'string') {
- // Search by entry
- serverStackItem = this.app.stack.find(({ handle }) => handle._middleware && handle._middleware.entry === query)
- } else {
- // Search by reference
- serverStackItem = this.app.stack.find(({ handle }) => handle === query)
- }
-
- // Stop if item not found
- if (!serverStackItem) {
- return
- }
-
- // Resolve middleware
- const { route, handle } = this.resolveMiddleware(middleware, serverStackItem.route)
-
- // Update serverStackItem
- serverStackItem.handle = handle
-
- // Error State
- serverStackItem.route = route
-
- // Return updated item
- return serverStackItem
- }
-
- serverMiddlewarePaths () {
- return this.app.stack.map(({ handle }) => handle._middleware && handle._middleware.entry).filter(Boolean)
- }
-
- renderRoute () {
- return this.renderer.renderRoute.apply(this.renderer, arguments)
- }
-
- loadResources () {
- return this.renderer.loadResources.apply(this.renderer, arguments)
- }
-
- renderAndGetWindow (url, opts = {}, {
- loadingTimeout = 2000,
- loadedCallback = this.globals.loadedCallback,
- ssr = this.options.render.ssr,
- globals = this.globals
- } = {}) {
- return renderAndGetWindow(url, opts, {
- loadingTimeout,
- loadedCallback,
- ssr,
- globals
- })
- }
-
- async listen (port, host, socket) {
- // Ensure nuxt is ready
- await this.nuxt.ready()
-
- // Create a new listener
- const listener = new Listener({
- port: isNaN(parseInt(port)) ? this.options.server.port : port,
- host: host || this.options.server.host,
- socket: socket || this.options.server.socket,
- https: this.options.server.https,
- app: this.app,
- dev: this.options.dev,
- baseURL: this.options.router.base
- })
-
- // Listen
- await listener.listen()
-
- // Push listener to this.listeners
- this.listeners.push(listener)
-
- await this.nuxt.callHook('listen', listener.server, listener)
-
- return listener
- }
-
- async close () {
- if (this.__closed) {
- return
- }
- this.__closed = true
-
- await Promise.all(this.listeners.map(l => l.close()))
-
- this.listeners = []
-
- if (typeof this.renderer.close === 'function') {
- await this.renderer.close()
- }
-
- this.app.removeAllListeners()
- this.app = null
-
- for (const key in this.resources) {
- delete this.resources[key]
- }
- }
-}
diff --git a/packages/server/test/contest.test.js b/packages/server/test/contest.test.js
deleted file mode 100644
index 62415264c232..000000000000
--- a/packages/server/test/contest.test.js
+++ /dev/null
@@ -1,17 +0,0 @@
-import ServerContext from '../src/context'
-
-describe('server: ServerContext', () => {
- test('should construct context', () => {
- const server = {
- nuxt: { id: 'test-contest-nuxt' },
- globals: { id: 'test-contest-globals' },
- options: { id: 'test-contest-options' },
- resources: { id: 'test-contest-resources' }
- }
- const context = new ServerContext(server)
- expect(context.nuxt).toBe(server.nuxt)
- expect(context.globals).toEqual(server.globals)
- expect(context.options).toEqual(server.options)
- expect(context.resources).toEqual(server.resources)
- })
-})
diff --git a/packages/server/test/index.test.js b/packages/server/test/index.test.js
deleted file mode 100644
index 44ea20615aa8..000000000000
--- a/packages/server/test/index.test.js
+++ /dev/null
@@ -1,14 +0,0 @@
-import { Server, Listener } from '../src'
-
-jest.mock('../src/server', () => ({
- server: true
-})).mock('../src/listener', () => ({
- listener: true
-}))
-
-describe('server: entry', () => {
- test('should export Server and Listener', () => {
- expect(Server.server).toEqual(true)
- expect(Listener.listener).toEqual(true)
- })
-})
diff --git a/packages/server/test/listener.test.js b/packages/server/test/listener.test.js
deleted file mode 100644
index 860daaf14639..000000000000
--- a/packages/server/test/listener.test.js
+++ /dev/null
@@ -1,428 +0,0 @@
-import http from 'http'
-import https from 'https'
-import enableDestroy from 'server-destroy'
-import ip from 'ip'
-import consola from 'consola'
-import pify from 'pify'
-
-import Listener from '../src/listener'
-
-jest.mock('http')
-jest.mock('https')
-jest.mock('server-destroy')
-jest.mock('ip')
-jest.mock('pify')
-
-describe('server: listener', () => {
- const mockServer = () => {
- const server = {
- address: jest.fn(),
- on: jest.fn(),
- listen: jest.fn((listenArgs, callback) => {
- Promise.resolve().then(callback)
- return server
- }),
- destroy: jest.fn()
- }
- return server
- }
-
- beforeEach(() => {
- jest.clearAllMocks()
- })
-
- test('should construct listener', () => {
- const options = {
- port: 3000,
- host: 'localhost',
- socket: jest.fn(),
- https: { id: 'test-listener-https' },
- app: jest.fn(),
- dev: false
- }
- const listener = new Listener(options)
-
- expect(listener.port).toEqual(options.port)
- expect(listener.host).toEqual(options.host)
- expect(listener.socket).toEqual(options.socket)
- expect(listener.https).toEqual(options.https)
- expect(listener.app).toEqual(options.app)
- expect(listener.dev).toEqual(options.dev)
- expect(listener.listening).toEqual(false)
- expect(listener._server).toBe(null)
- expect(listener.server).toBe(null)
- expect(listener.address).toBe(null)
- expect(listener.url).toBe(null)
- })
-
- test('should listen http host and port', async () => {
- const server = mockServer()
- http.createServer.mockReturnValueOnce(server)
-
- const options = {
- port: 3000,
- host: 'localhost',
- https: false,
- app: jest.fn(),
- dev: false
- }
- const listener = new Listener(options)
- listener.computeURL = jest.fn()
-
- await listener.listen()
-
- expect(http.createServer).toBeCalledTimes(1)
- expect(http.createServer).toBeCalledWith(options.app)
- expect(server.on).toBeCalledTimes(1)
- expect(server.on).toBeCalledWith('error', expect.any(Function))
- expect(server.listen).toBeCalledTimes(1)
- expect(server.listen).toBeCalledWith(
- {
- host: options.host,
- port: options.port,
- exclusive: false
- },
- expect.any(Function)
- )
- expect(listener.server).toBe(server)
- expect(enableDestroy).toBeCalledTimes(1)
- expect(enableDestroy).toBeCalledWith(listener.server)
- expect(pify).toBeCalledTimes(1)
- expect(pify).toBeCalledWith(listener.server.destroy)
- expect(listener.computeURL).toBeCalledTimes(1)
- expect(listener.listening).toEqual(true)
- })
-
- test('should listen https host and port', async () => {
- const server = mockServer()
- https.createServer.mockReturnValueOnce(server)
-
- const options = {
- port: 3000,
- host: 'localhost',
- https: { key: 'test-listener' },
- app: jest.fn(),
- dev: false
- }
- const listener = new Listener(options)
- listener.computeURL = jest.fn()
-
- await listener.listen()
-
- expect(https.createServer).toBeCalledTimes(1)
- expect(https.createServer).toBeCalledWith(options.https, options.app)
- expect(server.on).toBeCalledTimes(1)
- expect(server.on).toBeCalledWith('error', expect.any(Function))
- expect(server.listen).toBeCalledTimes(1)
- expect(server.listen).toBeCalledWith(
- {
- host: options.host,
- port: options.port,
- exclusive: false
- },
- expect.any(Function)
- )
- expect(listener.server).toBe(server)
- expect(enableDestroy).toBeCalledTimes(1)
- expect(enableDestroy).toBeCalledWith(listener.server)
- expect(pify).toBeCalledTimes(1)
- expect(pify).toBeCalledWith(listener.server.destroy)
- expect(listener.computeURL).toBeCalledTimes(1)
- expect(listener.listening).toEqual(true)
- })
-
- test('should listen unix socket host and port', async () => {
- const server = mockServer()
- http.createServer.mockReturnValueOnce(server)
-
- const options = {
- port: 3000,
- host: 'localhost',
- https: false,
- socket: '/var/nuxt/unix.socket',
- app: jest.fn(),
- dev: false
- }
- const listener = new Listener(options)
- listener.computeURL = jest.fn()
-
- await listener.listen()
-
- expect(http.createServer).toBeCalledTimes(1)
- expect(http.createServer).toBeCalledWith(options.app)
- expect(server.on).toBeCalledTimes(1)
- expect(server.on).toBeCalledWith('error', expect.any(Function))
- expect(server.listen).toBeCalledTimes(1)
- expect(server.listen).toBeCalledWith(
- {
- path: options.socket,
- exclusive: false
- },
- expect.any(Function)
- )
- expect(listener.server).toBe(server)
- expect(enableDestroy).toBeCalledTimes(1)
- expect(enableDestroy).toBeCalledWith(listener.server)
- expect(pify).toBeCalledTimes(1)
- expect(pify).toBeCalledWith(listener.server.destroy)
- expect(listener.computeURL).toBeCalledTimes(1)
- expect(listener.listening).toEqual(true)
- })
-
- test('should prevent listening multiple times', async () => {
- const options = {
- port: 3000,
- host: 'localhost',
- https: false,
- app: jest.fn(),
- dev: false
- }
- const listener = new Listener(options)
- listener.computeURL = jest.fn()
-
- listener.listening = true
- await listener.listen()
-
- expect(http.createServer).not.toBeCalled()
- })
-
- test('should throw error if error occurred or listen failed', async () => {
- const server = mockServer()
- http.createServer.mockReturnValueOnce(server)
-
- const options = {
- port: 3000,
- host: 'localhost',
- https: false,
- app: jest.fn(),
- dev: false
- }
- const listener = new Listener(options)
- listener.computeURL = jest.fn()
- listener.serverErrorHandler = jest.fn()
-
- const serverError = new Error('error occurred')
- server.listen.mockImplementationOnce((listenArgs, callback) => {
- Promise.resolve().then(callback)
- const errorListener = server.on.mock.calls[0][1]
- errorListener(serverError)
- return server
- })
- await listener.listen()
- expect(listener.serverErrorHandler).toBeCalledTimes(1)
- expect(listener.serverErrorHandler).toBeCalledWith(serverError)
-
- http.createServer.mockReturnValueOnce(server)
- listener.serverErrorHandler.mockClear()
-
- const listenError = new Error('listen failed')
- server.listen.mockImplementationOnce((listenArgs, callback) => {
- Promise.resolve().then(() => callback(listenError))
- return server
- })
- await listener.listen()
- expect(listener.serverErrorHandler).toBeCalledTimes(1)
- expect(listener.serverErrorHandler).toBeCalledWith(listenError)
- })
-
- test('should compute http url', () => {
- const options = {
- port: 3000,
- host: 'localhost',
- baseURL: '/'
- }
- const listener = new Listener(options)
- listener.server = mockServer()
-
- listener.server.address.mockReturnValueOnce({
- address: 'localhost',
- port: 3000
- })
- listener.computeURL()
- expect(listener.host).toEqual('localhost')
- expect(listener.port).toEqual(3000)
- expect(listener.url).toEqual('http://localhost:3000/')
-
- listener.server.address.mockReturnValueOnce({
- address: '127.0.0.1',
- port: 3001
- })
- listener.computeURL()
- expect(listener.host).toEqual('localhost')
- expect(listener.port).toEqual(3001)
- expect(listener.url).toEqual('http://localhost:3001/')
-
- ip.address.mockReturnValueOnce('192.168.0.1')
- listener.server.address.mockReturnValueOnce({
- address: '0.0.0.0',
- port: 3002
- })
- listener.computeURL()
- expect(listener.host).toEqual('192.168.0.1')
- expect(listener.port).toEqual(3002)
- expect(listener.url).toEqual('http://192.168.0.1:3002/')
- })
-
- test('should compute https url', () => {
- const options = {
- port: 3000,
- host: 'localhost',
- https: true,
- baseURL: '/'
- }
- const listener = new Listener(options)
- listener.server = mockServer()
-
- listener.server.address.mockReturnValueOnce({
- address: 'localhost',
- port: 3000
- })
- listener.computeURL()
- expect(listener.host).toEqual('localhost')
- expect(listener.port).toEqual(3000)
- expect(listener.url).toEqual('https://localhost:3000/')
-
- listener.server.address.mockReturnValueOnce({
- address: '127.0.0.1',
- port: 3001
- })
- listener.computeURL()
- expect(listener.host).toEqual('localhost')
- expect(listener.port).toEqual(3001)
- expect(listener.url).toEqual('https://localhost:3001/')
-
- ip.address.mockReturnValueOnce('192.168.0.1')
- listener.server.address.mockReturnValueOnce({
- address: '0.0.0.0',
- port: 3002
- })
- listener.computeURL()
- expect(listener.host).toEqual('192.168.0.1')
- expect(listener.port).toEqual(3002)
- expect(listener.url).toEqual('https://192.168.0.1:3002/')
- })
-
- test('should compute unix socket url', () => {
- const options = {
- socket: true
- }
- const listener = new Listener(options)
- listener.server = mockServer()
-
- listener.server.address.mockReturnValueOnce('/var/nuxt/unix.socket')
- listener.computeURL()
-
- expect(listener.url).toEqual('unix+http:///var/nuxt/unix.socket')
- })
-
- test('should throw error in serverErrorHandler', () => {
- const listener = new Listener({})
-
- const error = new Error('server error')
- expect(listener.serverErrorHandler(error)).rejects.toThrow(error)
- })
-
- test('should throw address in use error', () => {
- const listener = new Listener({})
- listener.host = 'localhost'
- listener.port = 3000
-
- const addressInUse = new Error()
- addressInUse.code = 'EADDRINUSE'
- expect(listener.serverErrorHandler(addressInUse)).rejects.toThrow('Address `localhost:3000` is already in use.')
- })
-
- test('should throw address in use error for socket', () => {
- const listener = new Listener({})
- listener.socket = 'nuxt.socket'
-
- const addressInUse = new Error()
- addressInUse.code = 'EADDRINUSE'
- expect(listener.serverErrorHandler(addressInUse)).rejects.toThrow('Address `nuxt.socket` is already in use.')
- })
-
- test('should fallback to a random port in address in use error', async () => {
- const listener = new Listener({ dev: true })
- listener.host = 'localhost'
- listener.port = 3000
- listener.close = jest.fn(() => Promise.resolve())
- listener.listen = jest.fn()
-
- const addressInUse = new Error()
- addressInUse.code = 'EADDRINUSE'
-
- await listener.serverErrorHandler(addressInUse)
-
- expect(consola.warn).toBeCalledTimes(1)
- expect(consola.warn).toBeCalledWith('Address `localhost:3000` is already in use.')
- expect(consola.info).toBeCalledTimes(1)
- expect(consola.info).toBeCalledWith('Trying a random port...')
- expect(listener.port).toEqual('0')
- expect(listener.close).toBeCalledTimes(1)
- expect(listener.listen).toBeCalledTimes(1)
- })
-
- test('should reuse last random port', async () => {
- const listener = new Listener({ dev: true, host: 'localhost', port: 3000 })
- listener.host = 'localhost'
- listener.close = jest.fn()
- listener.listen = function () {
- if (this.port === '0') {
- this.port = Math.random()
- }
- }
-
- const addressInUse = new Error()
- addressInUse.code = 'EADDRINUSE'
-
- await listener.serverErrorHandler(addressInUse).catch(() => { })
- const port1 = listener.port
- await listener.serverErrorHandler(addressInUse).catch(() => { })
- const port2 = listener.port
-
- expect(port1).not.toBe(3000)
- expect(port2).toBe(port1)
- })
-
- test('should close server', async () => {
- const listener = new Listener({})
- const server = mockServer()
- listener.listening = true
- listener._server = server
- listener.server = server
- listener.server.listening = true
- listener.address = 'localhost'
- listener.url = 'http://localhost:3000'
-
- await listener.close()
-
- expect(server.destroy).toBeCalledTimes(1)
- expect(consola.debug).toBeCalledTimes(1)
- expect(consola.debug).toBeCalledWith('server closed')
- expect(listener.listening).toEqual(false)
- expect(listener._server).toBe(null)
- expect(listener.server).toBe(null)
- expect(listener.address).toBe(null)
- expect(listener.url).toBe(null)
- })
-
- test('should prevent destroying server if server is not listening', async () => {
- const listener = new Listener({})
- const server = mockServer()
- listener.listening = true
- listener._server = server
- listener.server = server
- listener.address = 'localhost'
- listener.url = 'http://localhost:3000'
-
- await listener.close()
-
- expect(server.destroy).not.toBeCalled()
- expect(consola.debug).not.toBeCalled()
- expect(listener.listening).toEqual(false)
- expect(listener._server).toBe(null)
- expect(listener.server).toBe(null)
- expect(listener.address).toBe(null)
- expect(listener.url).toBe(null)
- })
-})
diff --git a/packages/server/test/middleware/error.test.js b/packages/server/test/middleware/error.test.js
deleted file mode 100644
index fd8e5a09d3d8..000000000000
--- a/packages/server/test/middleware/error.test.js
+++ /dev/null
@@ -1,279 +0,0 @@
-import path from 'path'
-import fs from 'fs-extra'
-import consola from 'consola'
-
-import Youch from '@nuxtjs/youch'
-
-import createErrorMiddleware from '../../src/middleware/error'
-
-jest.mock('path')
-jest.mock('fs-extra')
-jest.mock('@nuxtjs/youch', () => jest.fn(() => ({
- toHTML: jest.fn(() => 'youch html'),
- toJSON: jest.fn(() => 'youch json')
-})))
-
-const createParams = () => ({
- resources: { errorTemplate: jest.fn(() => 'error template') },
- options: {
- srcDir: '/var/nuxt/src',
- rootDir: '/var/nuxt',
- buildDir: '/var/nuxt/dist',
- router: { base: '/' }
- }
-})
-
-const createServerContext = () => ({
- req: { headers: {} },
- res: { setHeader: jest.fn(), end: jest.fn() },
- next: jest.fn()
-})
-
-describe('server: errorMiddleware', () => {
- beforeAll(() => {
- path.join.mockImplementation((...args) => `join(${args.join(', ')})`)
- path.resolve.mockImplementation((...args) => `resolve(${args.join(', ')})`)
- fs.readFile.mockImplementation(() => Promise.resolve())
- })
-
- beforeEach(() => {
- jest.clearAllMocks()
- })
-
- test('should return error middleware', () => {
- const errorMiddleware = createErrorMiddleware({})
- expect(errorMiddleware).toBeInstanceOf(Function)
- })
-
- test('should send html error response', async () => {
- const params = createParams()
- const errorMiddleware = createErrorMiddleware(params)
- const error = new Error()
- error.headers = { 'Custom-Header': 'test' }
- const ctx = createServerContext()
-
- await errorMiddleware(error, ctx.req, ctx.res, ctx.next)
-
- expect(consola.error).toBeCalledWith(error)
- expect(ctx.res.statusCode).toEqual(500)
- expect(ctx.res.statusMessage).toEqual('NuxtServerError')
- expect(ctx.res.setHeader).toBeCalledTimes(4)
- expect(ctx.res.setHeader).nthCalledWith(1, 'Content-Type', 'text/html; charset=utf-8')
- expect(ctx.res.setHeader).nthCalledWith(2, 'Content-Length', Buffer.byteLength('error template'))
- expect(ctx.res.setHeader).nthCalledWith(3, 'Cache-Control', 'no-cache, no-store, max-age=0, must-revalidate')
- expect(ctx.res.setHeader).nthCalledWith(4, 'Custom-Header', 'test')
- expect(params.resources.errorTemplate).toBeCalledTimes(1)
- expect(params.resources.errorTemplate).toBeCalledWith({
- status: 500,
- message: 'Nuxt Server Error',
- name: 'NuxtServerError'
- })
- expect(ctx.res.end).toBeCalledTimes(1)
- expect(ctx.res.end).toBeCalledWith('error template', 'utf-8')
- })
-
- test('should send json error response', async () => {
- const params = createParams()
- const errorMiddleware = createErrorMiddleware(params)
- const error = {
- statusCode: 404,
- name: 'NuxtTestError',
- message: 'test error'
- }
- const ctx = createServerContext()
- ctx.req.headers.accept = 'application/json'
-
- await errorMiddleware(error, ctx.req, ctx.res, ctx.next)
-
- const errJson = JSON.stringify({
- status: error.statusCode,
- message: error.message,
- name: error.name
- }, undefined, 2)
- expect(consola.error).not.toBeCalled()
- expect(ctx.res.statusCode).toEqual(404)
- expect(ctx.res.statusMessage).toEqual(error.name)
- expect(ctx.res.setHeader).toBeCalledTimes(3)
- expect(ctx.res.setHeader).nthCalledWith(1, 'Content-Type', 'text/json; charset=utf-8')
- expect(ctx.res.setHeader).nthCalledWith(2, 'Content-Length', Buffer.byteLength(errJson))
- expect(ctx.res.setHeader).nthCalledWith(3, 'Cache-Control', 'no-cache, no-store, max-age=0, must-revalidate')
- expect(params.resources.errorTemplate).not.toBeCalled()
- expect(ctx.res.end).toBeCalledTimes(1)
- expect(ctx.res.end).toBeCalledWith(errJson, 'utf-8')
- })
-
- test('should send html error response by youch in debug mode', async () => {
- const params = createParams()
- params.options.debug = true
- const errorMiddleware = createErrorMiddleware(params)
- const error = new Error('test error')
- error.statusCode = 503
- error.name = 'NuxtTestError'
- const ctx = createServerContext()
-
- await errorMiddleware(error, ctx.req, ctx.res, ctx.next)
-
- const errHtml = 'youch html'
- expect(Youch).toBeCalledTimes(1)
- expect(Youch).toBeCalledWith(
- error,
- ctx.req,
- expect.any(Function),
- params.options.router.base,
- true
- )
- expect(ctx.res.statusCode).toEqual(503)
- expect(ctx.res.statusMessage).toEqual(error.name)
- expect(ctx.res.setHeader).toBeCalledTimes(3)
- expect(ctx.res.setHeader).nthCalledWith(1, 'Content-Type', 'text/html; charset=utf-8')
- expect(ctx.res.setHeader).nthCalledWith(2, 'Content-Length', Buffer.byteLength(errHtml))
- expect(ctx.res.setHeader).nthCalledWith(3, 'Cache-Control', 'no-cache, no-store, max-age=0, must-revalidate')
- expect(params.resources.errorTemplate).not.toBeCalled()
- expect(ctx.res.end).toBeCalledTimes(1)
- expect(ctx.res.end).toBeCalledWith(errHtml, 'utf-8')
- })
-
- test('should send json error response by youch in debug mode', async () => {
- const params = createParams()
- params.options.debug = true
- const errorMiddleware = createErrorMiddleware(params)
- const error = {
- statusCode: 404,
- name: 'NuxtTestError',
- message: 'test error'
- }
- const ctx = createServerContext()
- ctx.req.headers.accept = 'application/json'
-
- await errorMiddleware(error, ctx.req, ctx.res, ctx.next)
-
- const errJson = JSON.stringify('youch json', undefined, 2)
- const errorFull = new Error(error.message)
- errorFull.name = error.name
- errorFull.statusCode = error.statusCode
- errorFull.stack = undefined
- expect(Youch).toBeCalledTimes(1)
- expect(Youch).toBeCalledWith(
- errorFull,
- ctx.req,
- expect.any(Function),
- params.options.router.base,
- true
- )
- expect(ctx.res.statusCode).toEqual(404)
- expect(ctx.res.statusMessage).toEqual(error.name)
- expect(ctx.res.setHeader).toBeCalledTimes(3)
- expect(ctx.res.setHeader).nthCalledWith(1, 'Content-Type', 'text/json; charset=utf-8')
- expect(ctx.res.setHeader).nthCalledWith(2, 'Content-Length', Buffer.byteLength(errJson))
- expect(ctx.res.setHeader).nthCalledWith(3, 'Cache-Control', 'no-cache, no-store, max-age=0, must-revalidate')
- expect(params.resources.errorTemplate).not.toBeCalled()
- expect(ctx.res.end).toBeCalledTimes(1)
- expect(ctx.res.end).toBeCalledWith(errJson, 'utf-8')
- })
-
- test('should search all possible paths when read source', async () => {
- const params = createParams()
- params.options.debug = true
- const errorMiddleware = createErrorMiddleware(params)
- const error = {}
- const ctx = createServerContext()
-
- await errorMiddleware(error, ctx.req, ctx.res, ctx.next)
-
- const frame = { fileName: 'webpack:///test-error.js?desc=test' }
- const readSource = Youch.mock.calls[0][2]
- await readSource(frame)
-
- const fileName = 'test-error.js'
- expect(frame).toEqual({ fileName })
- expect(path.resolve).toBeCalledTimes(5)
- expect(fs.readFile).toBeCalledTimes(5)
- expect(fs.readFile).nthCalledWith(1, `resolve(${params.options.srcDir}, ${fileName})`, 'utf-8')
- expect(fs.readFile).nthCalledWith(2, `resolve(${params.options.rootDir}, ${fileName})`, 'utf-8')
- expect(fs.readFile).nthCalledWith(3, `resolve(join(${params.options.buildDir}, dist, server), ${fileName})`, 'utf-8')
- expect(fs.readFile).nthCalledWith(4, `resolve(${params.options.buildDir}, ${fileName})`, 'utf-8')
- expect(fs.readFile).nthCalledWith(5, `resolve(${process.cwd()}, ${fileName})`, 'utf-8')
- })
-
- test('should return source content after read source', async () => {
- const params = createParams()
- params.options.debug = true
- const errorMiddleware = createErrorMiddleware(params)
- const error = {}
- const ctx = createServerContext()
-
- await errorMiddleware(error, ctx.req, ctx.res, ctx.next)
-
- const frame = { fileName: 'webpack:///test-error.js?desc=test' }
- const readSource = Youch.mock.calls[0][2]
- fs.readFile.mockImplementationOnce(() => Promise.resolve('source content'))
- await readSource(frame)
-
- const fileName = 'test-error.js'
- expect(frame).toEqual({
- fileName,
- contents: 'source content',
- fullPath: `resolve(${params.options.srcDir}, ${fileName})`
- })
- })
-
- test('should return relative fileName if fileName is absolute path', async () => {
- const params = createParams()
- params.options.debug = true
- const errorMiddleware = createErrorMiddleware(params)
- const error = {}
- const ctx = createServerContext()
-
- await errorMiddleware(error, ctx.req, ctx.res, ctx.next)
-
- const frame = { fileName: 'webpack:///test-error.js?desc=test' }
- const readSource = Youch.mock.calls[0][2]
- fs.readFile.mockImplementationOnce(() => Promise.resolve('source content'))
- path.isAbsolute.mockReturnValueOnce(true)
- path.relative.mockImplementationOnce((...args) => `relative(${args.join(', ')})`)
- await readSource(frame)
-
- const fullPath = `resolve(${params.options.srcDir}, test-error.js)`
- expect(frame).toEqual({
- fileName: `relative(${params.options.rootDir}, ${fullPath})`,
- contents: 'source content',
- fullPath
- })
- })
-
- test('should ignore error when reading source', async () => {
- const params = createParams()
- params.options.debug = true
- const errorMiddleware = createErrorMiddleware(params)
- const error = {}
- const ctx = createServerContext()
-
- await errorMiddleware(error, ctx.req, ctx.res, ctx.next)
-
- const frame = { fileName: 'webpack:///test-error.js?desc=test' }
- const readSource = Youch.mock.calls[0][2]
- fs.readFile.mockReturnValueOnce(Promise.reject(new Error('read failed')))
- await readSource(frame)
-
- const fileName = 'test-error.js'
- expect(frame).toEqual({ fileName })
- expect(path.resolve).toBeCalledTimes(5)
- expect(fs.readFile).toBeCalledTimes(5)
- })
-
- test('should return if fileName is unknown when read source', async () => {
- const params = createParams()
- params.options.debug = true
- const errorMiddleware = createErrorMiddleware(params)
- const error = {}
- const ctx = createServerContext()
-
- await errorMiddleware(error, ctx.req, ctx.res, ctx.next)
-
- const frame = {}
- const readSource = Youch.mock.calls[0][2]
- await readSource(frame)
-
- expect(frame.fileName).toBeNull()
- })
-})
diff --git a/packages/server/test/middleware/nuxt.test.js b/packages/server/test/middleware/nuxt.test.js
deleted file mode 100644
index 5027a1797484..000000000000
--- a/packages/server/test/middleware/nuxt.test.js
+++ /dev/null
@@ -1,340 +0,0 @@
-import generateETag from 'etag'
-import fresh from 'fresh'
-import consola from 'consola'
-
-import createNuxtMiddleware from '../../src/middleware/nuxt'
-
-jest.mock('etag', () => jest.fn(() => 'etag-hash'))
-jest.mock('fresh')
-
-const createContext = () => ({
- options: {
- render: { http2: false },
- build: {}
- },
- nuxt: {
- callHook: jest.fn()
- },
- renderRoute: jest.fn(),
- resources: {}
-})
-
-const createServerContext = () => ({
- req: { headers: {}, url: 'http://localhost/test/server' },
- res: { headers: {}, setHeader: jest.fn(), end: jest.fn() },
- next: jest.fn()
-})
-
-describe('server: nuxtMiddleware', () => {
- beforeEach(() => {
- jest.clearAllMocks()
- })
-
- test('should return nuxt middleware', () => {
- const nuxtMiddleware = createNuxtMiddleware({})
- expect(nuxtMiddleware).toBeInstanceOf(Function)
- })
-
- test('should render route in nuxt middleware', async () => {
- const context = createContext()
- const result = { html: 'rendered html' }
- context.renderRoute.mockReturnValue(result)
- const nuxtMiddleware = createNuxtMiddleware(context)
- const { req, res, next } = createServerContext()
-
- const html = await nuxtMiddleware(req, res, next)
-
- expect(context.renderRoute).toBeCalledTimes(1)
- expect(context.renderRoute).toBeCalledWith(req.url, { req, res })
-
- expect(context.nuxt.callHook).toBeCalledTimes(2)
- expect(context.nuxt.callHook).nthCalledWith(1, 'render:route', req.url, result, { req, res })
- expect(context.nuxt.callHook).nthCalledWith(2, 'render:routeDone', req.url, result, { req, res })
-
- expect(res.setHeader).toBeCalledTimes(3)
- expect(res.setHeader).nthCalledWith(1, 'Content-Type', 'text/html; charset=utf-8')
- expect(res.setHeader).nthCalledWith(2, 'Accept-Ranges', 'none')
- expect(res.setHeader).nthCalledWith(3, 'Content-Length', Buffer.byteLength(result.html))
-
- expect(res.end).toBeCalledTimes(1)
- expect(res.end).toBeCalledWith(result.html, 'utf8')
- expect(res.statusCode).toEqual(200)
- expect(html).toEqual(result.html)
- })
-
- test('should early return if route is redirected', async () => {
- const context = createContext()
- const result = { html: 'rendered html', redirected: true }
- context.renderRoute.mockReturnValue(result)
- const nuxtMiddleware = createNuxtMiddleware(context)
- const { req, res, next } = createServerContext()
-
- const html = await nuxtMiddleware(req, res, next)
-
- expect(context.nuxt.callHook).toBeCalledTimes(2)
- expect(context.nuxt.callHook).nthCalledWith(1, 'render:route', req.url, result, { req, res })
- expect(context.nuxt.callHook).nthCalledWith(2, 'render:routeDone', req.url, result, { req, res })
-
- expect(res.setHeader).not.toBeCalled()
- expect(res.end).not.toBeCalled()
- expect(res.statusCode).toEqual(200)
- expect(html).toEqual(result.html)
- })
-
- test('should set error status code when error occurred', async () => {
- const context = createContext()
- const result = { html: 'rendered html', error: new Error('render error') }
- const nuxt = { error: { statusCode: 404 } }
- context.renderRoute.mockImplementation((url, ctx) => {
- ctx.nuxt = nuxt
- return result
- })
- const nuxtMiddleware = createNuxtMiddleware(context)
- const { req, res, next } = createServerContext()
-
- const html = await nuxtMiddleware(req, res, next)
-
- expect(context.nuxt.callHook).toBeCalledTimes(2)
- expect(context.nuxt.callHook).nthCalledWith(1, 'render:route', req.url, result, { req, res, nuxt })
- expect(context.nuxt.callHook).nthCalledWith(2, 'render:routeDone', req.url, result, { req, res, nuxt })
-
- expect(res.statusCode).toEqual(404)
- expect(html).toEqual(result.html)
- })
-
- test('should add etag after rendering', async () => {
- const context = createContext()
- const result = { html: 'rendered html' }
- context.renderRoute.mockReturnValue(result)
- context.options.render.etag = true
- const nuxtMiddleware = createNuxtMiddleware(context)
- const { req, res, next } = createServerContext()
-
- await nuxtMiddleware(req, res, next)
-
- expect(generateETag).toBeCalledTimes(1)
- expect(generateETag).toBeCalledWith('rendered html', true)
- expect(res.setHeader).nthCalledWith(1, 'ETag', 'etag-hash')
- })
-
- test('should set etag after rendering through hook', async () => {
- const context = createContext()
- const hash = jest.fn(() => 'etag-hook')
- context.options.render.etag = { hash }
-
- const result = { html: 'rendered html' }
- context.renderRoute.mockReturnValue(result)
- const nuxtMiddleware = createNuxtMiddleware(context)
- const { req, res, next } = createServerContext()
-
- await nuxtMiddleware(req, res, next)
-
- expect(hash).toBeCalledWith('rendered html', expect.any(Object))
- expect(res.setHeader).nthCalledWith(1, 'ETag', 'etag-hook')
- })
-
- test('should return 304 if request is fresh', async () => {
- const context = createContext()
- const result = { html: 'rendered html' }
- context.renderRoute.mockReturnValue(result)
- context.options.render.etag = true
- const nuxtMiddleware = createNuxtMiddleware(context)
- const { req, res, next } = createServerContext()
- fresh.mockReturnValue(true)
-
- await nuxtMiddleware(req, res, next)
-
- expect(res.statusCode).toEqual(304)
- expect(res.end).toBeCalledTimes(1)
- expect(res.end).toBeCalledWith()
- })
-
- test('should add http2 links header if http2 push is enabled', async () => {
- const context = createContext()
- const result = {
- html: 'rendered html',
- preloadFiles: ['/nuxt/preload1.js', '/nuxt/preload2.js']
- }
- context.renderRoute.mockReturnValue(result)
- const pushAssets = jest.fn((req, res, publicPath, preloadFiles) => preloadFiles)
- context.options.render.http2 = { push: true, pushAssets }
- context.resources = { clientManifest: { publicPath: '/nuxt' } }
-
- const nuxtMiddleware = createNuxtMiddleware(context)
- const { req, res, next } = createServerContext()
- fresh.mockReturnValue(true)
-
- await nuxtMiddleware(req, res, next)
-
- expect(pushAssets).toBeCalledWith(req, res, '/nuxt', ['/nuxt/preload1.js', '/nuxt/preload2.js'])
- expect(res.setHeader).nthCalledWith(1, 'Link', '/nuxt/preload1.js, /nuxt/preload2.js')
- })
-
- test('should only include script and style in http2 push by default', async () => {
- const context = createContext()
- const result = {
- html: 'rendered html',
- preloadFiles: [
- { file: '/nuxt/preload1.js', asType: 'script' },
- { file: '/nuxt/preload2.js', asType: 'script' },
- { file: '/nuxt/style.css', asType: 'style' },
- { file: '/nuxt/font.woff', asType: 'font' }
- ]
- }
- context.renderRoute.mockReturnValue(result)
- context.options.render.http2 = { push: true }
- context.resources = { clientManifest: { publicPath: '/nuxt' } }
-
- const nuxtMiddleware = createNuxtMiddleware(context)
- const { req, res, next } = createServerContext()
- fresh.mockReturnValue(true)
-
- await nuxtMiddleware(req, res, next)
-
- expect(res.setHeader).nthCalledWith(1, 'Link', '</nuxt/nuxt/preload1.js>; rel=preload; as=script, </nuxt/nuxt/preload2.js>; rel=preload; as=script, </nuxt/nuxt/style.css>; rel=preload; as=style')
- })
-
- test('should ignore preload files which are excluded by shouldPush', async () => {
- const context = createContext()
- const result = {
- html: 'rendered html',
- preloadFiles: [
- { file: '/nuxt/preload1.js', asType: 'script' },
- { file: '/nuxt/preload2.js', asType: 'script', modern: true },
- { file: '/nuxt/style.css', asType: 'style' },
- { file: '/nuxt/font.woff', asType: 'font' }
- ]
- }
- context.renderRoute.mockReturnValue(result)
- context.options.dev = true
- context.options.render.crossorigin = 'use-credentials'
- context.options.render.http2 = {
- push: true,
- shouldPush: jest.fn((fileWithoutQuery, asType) => asType === 'script')
- }
- context.resources = { clientManifest: { publicPath: '/nuxt' } }
-
- const nuxtMiddleware = createNuxtMiddleware(context)
- const { req, res, next } = createServerContext()
- fresh.mockReturnValue(true)
-
- await nuxtMiddleware(req, res, next)
-
- expect(consola.warn).toBeCalledWith('http2.shouldPush is deprecated. Use http2.pushAssets function')
- expect(context.options.render.http2.shouldPush).toBeCalledTimes(4)
- expect(res.setHeader).nthCalledWith(1, 'Link', '</nuxt/nuxt/preload1.js>; rel=preload; crossorigin=use-credentials; as=script, </nuxt/nuxt/preload2.js>; rel=modulepreload; crossorigin=use-credentials; as=script')
- })
-
- test('should add csp header if csp is enabled', async () => {
- const context = createContext()
- const result = { html: 'rendered html', cspScriptSrcHashes: ['sha256-hashes'] }
- context.renderRoute.mockReturnValue(result)
- context.options.render.csp = true
-
- const nuxtMiddleware = createNuxtMiddleware(context)
- const { req, res, next } = createServerContext()
- fresh.mockReturnValue(true)
-
- await nuxtMiddleware(req, res, next)
-
- expect(res.setHeader).nthCalledWith(1, 'Content-Security-Policy', "script-src 'self' sha256-hashes")
- })
-
- test('should support allowedSources for setting csp header', async () => {
- const context = createContext()
- const result = { html: 'rendered html', cspScriptSrcHashes: ['sha256-hashes'] }
- context.renderRoute.mockReturnValue(result)
- context.options.dev = true
- context.options.render.csp = {
- reportOnly: true,
- allowedSources: ['/nuxt/*.js', '/nuxt/images/*']
- }
-
- const nuxtMiddleware = createNuxtMiddleware(context)
- const { req, res, next } = createServerContext()
- fresh.mockReturnValue(true)
-
- await nuxtMiddleware(req, res, next)
-
- expect(res.setHeader).nthCalledWith(
- 1,
- 'Content-Security-Policy-Report-Only',
- "script-src 'self' 'unsafe-eval' sha256-hashes /nuxt/*.js /nuxt/images/*"
- )
- })
-
- test('should support policies for setting csp header', async () => {
- const context = createContext()
- const result = { html: 'rendered html', cspScriptSrcHashes: ['sha256-hashes'] }
- context.renderRoute.mockReturnValue(result)
- context.options.dev = true
- context.options.render.csp = {
- policies: {
- 'script-src': [
- '/nuxt.js',
- '/test.js'
- ],
- 'report-uri': [
- '/report'
- ]
- }
- }
-
- const nuxtMiddleware = createNuxtMiddleware(context)
- const { req, res, next } = createServerContext()
- fresh.mockReturnValue(true)
-
- await nuxtMiddleware(req, res, next)
-
- expect(res.setHeader).nthCalledWith(
- 1,
- 'Content-Security-Policy',
- "script-src sha256-hashes 'self' /nuxt.js /test.js; report-uri /report"
- )
- })
-
- test('should catch error during running nuxt middleware', async () => {
- const context = createContext()
- const err = Error('render error')
- context.renderRoute.mockImplementation(() => {
- throw err
- })
- const nuxtMiddleware = createNuxtMiddleware(context)
- const { req, res, next } = createServerContext()
- fresh.mockReturnValue(true)
-
- await nuxtMiddleware(req, res, next)
-
- expect(next).toBeCalledWith(err)
- })
-
- test('should log and return error during redirecting in nuxt middleware', async () => {
- const context = createContext()
- const err = Error('render error')
- context.renderRoute.mockImplementation((url, ctx) => {
- ctx.redirected = true
- throw err
- })
- const nuxtMiddleware = createNuxtMiddleware(context)
- const { req, res, next } = createServerContext()
- fresh.mockReturnValue(true)
-
- expect(await nuxtMiddleware(req, res, next)).toBe(err)
- expect(consola.error).toBeCalledWith(err)
- })
-
- test('should return 400 if request is uri error', async () => {
- const context = createContext()
- const result = { html: 'rendered html' }
- context.renderRoute.mockReturnValue(result)
- const nuxtMiddleware = createNuxtMiddleware(context)
- const { req, res, next } = createServerContext()
-
- const err = Error('URI malformed')
- err.name = 'URIError'
-
- await nuxtMiddleware({ ...req, url: 'http://localhost/test/server/%c1%81' }, res, next)
-
- expect(next).toBeCalledWith(err)
- })
-})
diff --git a/packages/server/test/middleware/timing.test.js b/packages/server/test/middleware/timing.test.js
deleted file mode 100644
index 89f0793c4a42..000000000000
--- a/packages/server/test/middleware/timing.test.js
+++ /dev/null
@@ -1,103 +0,0 @@
-import consola from 'consola'
-import onHeaders from 'on-headers'
-import { Timer } from '@nuxt/utils'
-
-import createTimingMiddleware from '../../src/middleware/timing'
-
-jest.mock('on-headers')
-jest.mock('@nuxt/utils')
-
-const createServerContext = () => ({
- req: {},
- res: {
- getHeader: jest.fn(),
- setHeader: jest.fn()
- },
- next: jest.fn()
-})
-
-describe('server: timingMiddleware', () => {
- beforeEach(() => {
- jest.clearAllMocks()
- })
-
- test('should return timing middleware', () => {
- const timingMiddleware = createTimingMiddleware({})
- expect(timingMiddleware).toBeInstanceOf(Function)
- })
-
- test('should warn duplicate registration', () => {
- const timingMiddleware = createTimingMiddleware({})
- const ctx = createServerContext()
-
- ctx.res.timing = true
- timingMiddleware(ctx.req, ctx.res, ctx.next)
-
- expect(consola.warn).toBeCalledWith('server-timing is already registered.')
- })
-
- test('should register timer for recording timing', () => {
- const timingMiddleware = createTimingMiddleware({ total: true })
- const ctx = createServerContext()
-
- timingMiddleware(ctx.req, ctx.res, ctx.next)
-
- expect(ctx.res.timing).toBeDefined()
- expect(Timer.prototype.start).toBeCalledTimes(1)
- expect(Timer.prototype.start).toBeCalledWith('total', 'Nuxt Server Time')
- expect(onHeaders).toBeCalledTimes(1)
- expect(onHeaders).toBeCalledWith(ctx.res, expect.any(Function))
- expect(ctx.next).toBeCalledTimes(1)
- })
-
- test('should add Server-Timing header before sending header', () => {
- const timingMiddleware = createTimingMiddleware({ total: true })
- const ctx = createServerContext()
-
- timingMiddleware(ctx.req, ctx.res, ctx.next)
-
- const headerCallback = onHeaders.mock.calls[0][1]
- Timer.prototype.end.mockReturnValueOnce({
- name: 'total',
- duration: 300,
- description: 'Nuxt Server Time'
- })
- headerCallback()
-
- expect(ctx.res.timing.end).toBeCalledTimes(1)
- expect(ctx.res.timing.end).toBeCalledWith('total')
- expect(ctx.res.getHeader).toBeCalledTimes(1)
- expect(ctx.res.getHeader).toBeCalledWith('Server-Timing')
- expect(ctx.res.setHeader).toBeCalledTimes(1)
- expect(ctx.res.setHeader).toBeCalledWith('Server-Timing', 'total;dur=300;desc="Nuxt Server Time"')
- })
-
- test('should ignore desc if empty', () => {
- const timingMiddleware = createTimingMiddleware({})
- const ctx = createServerContext()
-
- timingMiddleware(ctx.req, ctx.res, ctx.next)
-
- expect(
- ctx.res.timing.formatHeader({
- name: 'timing-test',
- duration: 300
- })
- ).toEqual('timing-test;dur=300')
- })
-
- test('should not send Server-Timing header if empty', () => {
- const timingMiddleware = createTimingMiddleware({ total: true })
- const ctx = createServerContext()
-
- timingMiddleware(ctx.req, ctx.res, ctx.next)
-
- const headerCallback = onHeaders.mock.calls[0][1]
- headerCallback()
-
- expect(ctx.res.timing.end).toBeCalledTimes(1)
- expect(ctx.res.timing.end).toBeCalledWith('total')
- expect(ctx.res.getHeader).not.toBeCalled()
- expect(ctx.res.setHeader).not.toBeCalled()
- })
-})
diff --git a/packages/server/test/server.test.js b/packages/server/test/server.test.js
deleted file mode 100644
index 798e23f20d8c..000000000000
--- a/packages/server/test/server.test.js
+++ /dev/null
@@ -1,545 +0,0 @@
-import path from 'path'
-import connect from 'connect'
-import consola from 'consola'
-import serveStatic from 'serve-static'
-import servePlaceholder from 'serve-placeholder'
-import launchMiddleware from 'launch-editor-middleware'
-import { determineGlobals, isUrl } from '@nuxt/utils'
-import { VueRenderer } from '@nuxt/vue-renderer'
-
-import Server from '../src/server'
-import Listener from '../src/listener'
-import ServerContext from '../src/context'
-import renderAndGetWindow from '../src/jsdom'
-import nuxtMiddleware from '../src/middleware/nuxt'
-import errorMiddleware from '../src/middleware/error'
-import createTimingMiddleware from '../src/middleware/timing'
-
-jest.mock('connect')
-jest.mock('serve-static')
-jest.mock('serve-placeholder')
-jest.mock('launch-editor-middleware')
-jest.mock('@nuxt/utils')
-jest.mock('@nuxt/vue-renderer')
-jest.mock('../src/listener')
-jest.mock('../src/context')
-jest.mock('../src/jsdom')
-jest.mock('../src/middleware/nuxt')
-jest.mock('../src/middleware/error')
-jest.mock('../src/middleware/timing')
-
-describe('server: server', () => {
- const createNuxt = () => ({
- options: {
- dir: {
- static: 'var/nuxt/static'
- },
- srcDir: '/var/nuxt/src',
- buildDir: '/var/nuxt/build',
- globalName: 'test-global-name',
- globals: { id: 'test-globals' },
- build: {
- publicPath: '__nuxt_test'
- },
- router: {
- base: '/foo/'
- },
- render: {
- id: 'test-render',
- dist: {
- id: 'test-render-dist'
- },
- static: {
- id: 'test-render-static',
- prefix: 'test-render-static-prefix'
- }
- },
- server: {},
- serverMiddleware: []
- },
- hook: jest.fn(),
- ready: jest.fn(),
- callHook: jest.fn(),
- resolver: {
- requireModule: jest.fn(),
- resolvePath: jest.fn().mockImplementation(p => p)
- }
- })
-
- beforeAll(() => {
- jest.spyOn(path, 'join').mockImplementation((...args) => `join(${args.join(', ')})`)
- jest.spyOn(path, 'resolve').mockImplementation((...args) => `resolve(${args.join(', ')})`)
- connect.mockReturnValue({ use: jest.fn() })
- serveStatic.mockImplementation(dir => ({ id: 'test-serve-static', dir }))
- nuxtMiddleware.mockImplementation(options => ({
- id: 'test-nuxt-middleware',
- ...options
- }))
- errorMiddleware.mockImplementation(options => ({
- id: 'test-error-middleware',
- ...options
- }))
- createTimingMiddleware.mockImplementation(options => ({
- id: 'test-timing-middleware',
- ...options
- }))
- launchMiddleware.mockImplementation(options => ({
- id: 'test-open-in-editor-middleware',
- ...options
- }))
- servePlaceholder.mockImplementation(options => ({
- key: 'test-serve-placeholder',
- ...options
- }))
- })
-
- afterAll(() => {
- path.join.mockRestore()
- path.resolve.mockRestore()
- })
-
- beforeEach(() => {
- jest.clearAllMocks()
- })
-
- test('should construct server', () => {
- const nuxt = createNuxt()
- determineGlobals.mockReturnValueOnce({
- ...nuxt.options.globals,
- name: nuxt.options.globalName
- })
- let server = new Server(nuxt)
-
- expect(server.nuxt).toBe(nuxt)
- expect(server.options).toBe(nuxt.options)
- expect(server.publicPath).toBe('__nuxt_test')
- expect(server.resources).toEqual({})
- expect(server.listeners).toEqual([])
- expect(connect).toBeCalledTimes(1)
- expect(server.nuxt.hook).toBeCalledTimes(1)
- expect(server.nuxt.hook).toBeCalledWith('close', expect.any(Function))
-
- const closeHook = server.nuxt.hook.mock.calls[0][1]
- server.close = jest.fn()
- expect(server.close).not.toBeCalled()
- closeHook()
- expect(server.close).toBeCalledTimes(1)
-
- nuxt.options.build._publicPath = 'http://localhost:3000/test'
- isUrl.mockReturnValueOnce(true)
- server = new Server(nuxt)
- expect(server.publicPath).toBe(nuxt.options.build._publicPath)
- })
-
- test('should be ready for listening', async () => {
- const nuxt = createNuxt()
- const server = new Server(nuxt)
- const renderer = {
- ready: jest.fn()
- }
- const context = jest.fn()
- VueRenderer.mockImplementationOnce(() => renderer)
- ServerContext.mockImplementationOnce(() => context)
- server.setupMiddleware = jest.fn()
- path.join.mockRestore()
- path.resolve.mockRestore()
-
- await server.ready()
-
- expect(server.nuxt.callHook).toBeCalledTimes(2)
- expect(server.nuxt.callHook).nthCalledWith(1, 'render:before', server, server.options.render)
- expect(server.nuxt.callHook).nthCalledWith(2, 'render:done', server)
- expect(ServerContext).toBeCalledTimes(1)
- expect(ServerContext).toBeCalledWith(server)
- expect(VueRenderer).toBeCalledTimes(1)
- expect(VueRenderer).toBeCalledWith(context)
- expect(server.renderer).toBe(renderer)
- expect(renderer.ready).toBeCalledTimes(1)
- expect(server.setupMiddleware).toBeCalledTimes(1)
-
- jest.spyOn(path, 'join').mockImplementation((...args) => `join(${args.join(', ')})`)
- jest.spyOn(path, 'resolve').mockImplementation((...args) => `resolve(${args.join(', ')})`)
- })
-
- test('should setup middleware', async () => {
- const nuxt = createNuxt()
- const server = new Server(nuxt)
- server.useMiddleware = jest.fn()
- server.serverContext = { id: 'test-server-context' }
-
- await server.setupMiddleware()
-
- expect(server.nuxt.callHook).toBeCalledTimes(2)
- expect(server.nuxt.callHook).nthCalledWith(1, 'render:setupMiddleware', server.app)
- expect(server.nuxt.callHook).nthCalledWith(2, 'render:errorMiddleware', server.app)
-
- expect(server.useMiddleware).toBeCalledTimes(4)
- expect(serveStatic).toBeCalledTimes(2)
- expect(serveStatic).nthCalledWith(1, 'resolve(/var/nuxt/src, var/nuxt/static)', server.options.render.static)
- expect(server.useMiddleware).nthCalledWith(1, {
- dir: 'resolve(/var/nuxt/src, var/nuxt/static)',
- id: 'test-serve-static',
- prefix: 'test-render-static-prefix'
- })
- expect(serveStatic).nthCalledWith(2, 'resolve(/var/nuxt/build, dist, client)', server.options.render.dist)
- expect(server.useMiddleware).nthCalledWith(2, {
- handler: {
- dir: 'resolve(/var/nuxt/build, dist, client)',
- id: 'test-serve-static'
- },
- path: '__nuxt_test'
- })
-
- const nuxtMiddlewareOpts = {
- options: server.options,
- nuxt: server.nuxt,
- renderRoute: expect.any(Function),
- resources: server.resources
- }
- expect(nuxtMiddleware).toBeCalledTimes(1)
- expect(nuxtMiddleware).toBeCalledWith(nuxtMiddlewareOpts)
- expect(server.useMiddleware).nthCalledWith(3, {
- id: 'test-nuxt-middleware',
- ...nuxtMiddlewareOpts
- })
-
- const errorMiddlewareOpts = {
- resources: server.resources,
- options: server.options
- }
- expect(errorMiddleware).toBeCalledTimes(1)
- expect(errorMiddleware).toBeCalledWith(errorMiddlewareOpts)
- expect(server.useMiddleware).nthCalledWith(4, {
- id: 'test-error-middleware',
- ...errorMiddlewareOpts
- })
- })
-
- test('should setup compressor middleware', async () => {
- const nuxt = createNuxt()
- nuxt.options.render.compressor = jest.fn()
- const server = new Server(nuxt)
- server.useMiddleware = jest.fn()
- server.renderer = {
- context: { id: 'test-server-context' }
- }
-
- await server.setupMiddleware()
- expect(server.useMiddleware).nthCalledWith(1, nuxt.options.render.compressor)
-
- server.useMiddleware.mockClear()
- nuxt.options.render.compressor = { id: 'test-render-compressor' }
- nuxt.resolver.requireModule.mockImplementationOnce(name => jest.fn(options => ({
- name,
- ...options
- })))
- await server.setupMiddleware()
- expect(nuxt.resolver.requireModule).nthCalledWith(1, 'compression')
- expect(server.useMiddleware).nthCalledWith(1, {
- id: 'test-render-compressor',
- name: 'compression'
- })
- })
-
- test('should setup timing middleware', async () => {
- const nuxt = createNuxt()
- nuxt.options.server.timing = { id: 'test-server-timing' }
- const server = new Server(nuxt)
- server.useMiddleware = jest.fn()
- server.renderer = {
- context: { id: 'test-server-context' }
- }
-
- await server.setupMiddleware()
-
- expect(createTimingMiddleware).nthCalledWith(1, { id: 'test-server-timing' })
- expect(server.useMiddleware).nthCalledWith(1, { id: 'test-server-timing' })
- })
-
- test('should setup open-in-editor middleware', async () => {
- const nuxt = createNuxt()
- nuxt.options.dev = true
- nuxt.options.debug = true
- nuxt.options.editor = { id: 'test-editor' }
- const server = new Server(nuxt)
- server.useMiddleware = jest.fn()
- server.renderer = {
- context: { id: 'test-server-context' }
- }
-
- await server.setupMiddleware()
-
- expect(launchMiddleware).toBeCalledTimes(1)
- expect(launchMiddleware).toBeCalledWith({ id: 'test-editor' })
-
- expect(server.useMiddleware).nthCalledWith(3, {
- handler: { id: 'test-editor' },
- path: '__open-in-editor'
- })
- })
-
- test('should setup server middleware', async () => {
- const nuxt = createNuxt()
- nuxt.options.serverMiddleware = [
- { id: 'test-server-middleware-1' },
- { id: 'test-server-middleware-2' }
- ]
- const server = new Server(nuxt)
- server.useMiddleware = jest.fn()
- server.renderer = {
- context: { id: 'test-server-context' }
- }
-
- await server.setupMiddleware()
-
- expect(server.useMiddleware).nthCalledWith(3, { id: 'test-server-middleware-1' })
- expect(server.useMiddleware).nthCalledWith(4, { id: 'test-server-middleware-2' })
- })
-
- test('should setup fallback middleware', async () => {
- const nuxt = createNuxt()
- nuxt.options.render.fallback = {
- dist: { id: 'test-render-fallback-dist' },
- static: { id: 'test-render-fallback-static' }
- }
- const server = new Server(nuxt)
- server.useMiddleware = jest.fn()
- server.renderer = {
- context: { id: 'test-server-context' }
- }
-
- await server.setupMiddleware()
- expect(servePlaceholder).toBeCalledTimes(2)
- expect(server.useMiddleware).nthCalledWith(3, {
- handler: {
- id: 'test-render-fallback-dist',
- key: 'test-serve-placeholder'
- },
- path: '__nuxt_test'
- })
- expect(server.useMiddleware).nthCalledWith(4, {
- handler: {
- id: 'test-render-fallback-static',
- key: 'test-serve-placeholder'
- },
- path: '/'
- })
-
- servePlaceholder.mockClear()
- nuxt.options.render.fallback = {}
- await server.setupMiddleware()
- expect(servePlaceholder).not.toBeCalled()
- })
-
- test('should use object middleware', () => {
- const nuxt = createNuxt()
- nuxt.options.router = { base: '' }
- const server = new Server(nuxt)
- const handler = jest.fn()
-
- server.useMiddleware({
- handler
- })
-
- expect(nuxt.resolver.requireModule).not.toBeCalled()
- expect(server.app.use).toBeCalledTimes(1)
- expect(server.app.use).toBeCalledWith(nuxt.options.router.base, handler)
- })
-
- test('should use function module middleware', () => {
- const nuxt = createNuxt()
- nuxt.options.router = { base: '' }
- const server = new Server(nuxt)
- const handler = jest.fn()
- nuxt.resolver.requireModule.mockReturnValueOnce(handler)
-
- server.useMiddleware('test-middleware')
-
- expect(nuxt.resolver.requireModule).toBeCalledTimes(1)
- expect(nuxt.resolver.requireModule).toBeCalledWith('test-middleware')
- expect(server.app.use).toBeCalledTimes(1)
- expect(server.app.use).toBeCalledWith(nuxt.options.router.base, handler)
- })
-
- test('should use object module middleware', () => {
- const nuxt = createNuxt()
- nuxt.options.router = { base: '/' }
- const server = new Server(nuxt)
- const handler = jest.fn()
- nuxt.resolver.requireModule.mockReturnValueOnce({
- handler,
- prefix: false,
- path: '//middleware'
- })
-
- server.useMiddleware('test-middleware')
-
- expect(nuxt.resolver.requireModule).toBeCalledTimes(1)
- expect(nuxt.resolver.requireModule).toBeCalledWith('test-middleware')
- expect(server.app.use).toBeCalledTimes(1)
- expect(server.app.use).toBeCalledWith('/middleware', handler)
- })
-
- test('should show error when module require failed', () => {
- const nuxt = createNuxt()
- nuxt.options.router = { base: '/' }
- const server = new Server(nuxt)
- const error = Error('middleware resolves failed')
- nuxt.resolver.requireModule.mockImplementationOnce(() => {
- throw error
- })
-
- server.useMiddleware('test-middleware')
-
- expect(consola.error).toBeCalledTimes(1)
- expect(consola.error).toBeCalledWith('ServerMiddleware Error:', error)
- })
-
- test('should only log error when module resolves failed in dev mode', () => {
- const nuxt = createNuxt()
- nuxt.options.dev = true
- nuxt.options.router = { base: '/' }
- const server = new Server(nuxt)
- const error = Error('middleware resolves failed')
- nuxt.resolver.requireModule.mockImplementationOnce(() => {
- throw error
- })
-
- server.useMiddleware('test-middleware')
-
- expect(consola.error).toBeCalledTimes(1)
- expect(consola.error).toBeCalledWith('ServerMiddleware Error:', error)
- })
-
- test('should render route via renderer', () => {
- const nuxt = createNuxt()
- const server = new Server(nuxt)
- server.renderer = { renderRoute: jest.fn() }
-
- server.renderRoute('test-render-route')
-
- expect(server.renderer.renderRoute).toBeCalledTimes(1)
- expect(server.renderer.renderRoute).toBeCalledWith('test-render-route')
- })
-
- test('should load resources via renderer', () => {
- const nuxt = createNuxt()
- const server = new Server(nuxt)
- server.renderer = { loadResources: jest.fn() }
-
- server.loadResources('test-load-resources')
-
- expect(server.renderer.loadResources).toBeCalledTimes(1)
- expect(server.renderer.loadResources).toBeCalledWith('test-load-resources')
- })
-
- test('should render and get window', () => {
- const nuxt = createNuxt()
- const globals = {
- ...nuxt.options.globals,
- name: nuxt.options.globalName,
- loadedCallback: jest.fn()
- }
- determineGlobals.mockReturnValueOnce(globals)
- const server = new Server(nuxt)
-
- server.renderAndGetWindow('/render/window')
-
- expect(renderAndGetWindow).toBeCalledTimes(1)
- expect(renderAndGetWindow).toBeCalledWith('/render/window', {}, {
- loadingTimeout: 2000,
- loadedCallback: globals.loadedCallback,
- ssr: nuxt.options.render.ssr,
- globals
- })
- })
-
- test('should listen server', async () => {
- const nuxt = createNuxt()
- const server = new Server(nuxt)
- const listener = {
- listen: jest.fn(),
- server: jest.fn()
- }
- Listener.mockImplementationOnce(() => {
- return listener
- })
-
- await server.listen(3000, 'localhost', '/var/nuxt/unix.socket')
-
- expect(Listener).toBeCalledWith({
- port: 3000,
- host: 'localhost',
- socket: '/var/nuxt/unix.socket',
- https: undefined,
- app: server.app,
- dev: server.options.dev,
- baseURL: '/foo/'
- })
- expect(listener.listen).toBeCalledTimes(1)
- expect(server.listeners).toEqual([listener])
- expect(server.nuxt.callHook).toBeCalledTimes(1)
- expect(server.nuxt.callHook).toBeCalledWith('listen', listener.server, listener)
- })
-
- test('should listen server via options.server', async () => {
- const nuxt = createNuxt()
- nuxt.options.server = {
- host: 'localhost',
- port: '3000',
- socket: '/var/nuxt/unix.socket',
- https: true
- }
- const server = new Server(nuxt)
-
- await server.listen()
-
- expect(Listener).toBeCalledWith({
- ...nuxt.options.server,
- app: server.app,
- dev: server.options.dev,
- baseURL: '/foo/'
- })
- })
-
- test('should close server', async () => {
- const removeAllListeners = jest.fn()
- connect.mockReturnValueOnce({ use: jest.fn(), removeAllListeners })
- const nuxt = createNuxt()
- const server = new Server(nuxt)
- const listener = { close: jest.fn() }
- server.listeners = [listener]
- server.renderer = { close: jest.fn() }
- server.resources = { id: 'test-resources' }
-
- await server.close()
-
- expect(server.__closed).toEqual(true)
- expect(listener.close).toBeCalledTimes(1)
- expect(server.listeners).toEqual([])
- expect(server.renderer.close).toBeCalledTimes(1)
- expect(removeAllListeners).toBeCalledTimes(1)
- expect(server.app).toBeNull()
- expect(server.resources).toEqual({})
- })
-
- test('should prevent closing server multiple times', async () => {
- const removeAllListeners = jest.fn()
- connect.mockReturnValueOnce({ use: jest.fn(), removeAllListeners })
- const nuxt = createNuxt()
- const server = new Server(nuxt)
- server.renderer = {}
-
- await server.close()
-
- expect(server.__closed).toEqual(true)
- expect(removeAllListeners).toBeCalledTimes(1)
-
- removeAllListeners.mockClear()
-
- await server.close()
-
- expect(server.__closed).toEqual(true)
- expect(removeAllListeners).not.toBeCalled()
- })
-})
diff --git a/packages/test-utils/README.md b/packages/test-utils/README.md
new file mode 100644
index 000000000000..bf877e0d9d55
--- /dev/null
+++ b/packages/test-utils/README.md
@@ -0,0 +1,5 @@
+# Nuxt Test Utils
+
+🧪 Test utilities for [Nuxt](https://nuxt.com).
+
+- 👉 View on GitHub at https://github.com/nuxt/test-utils
diff --git a/packages/ui-templates/README.md b/packages/ui-templates/README.md
new file mode 100644
index 000000000000..cdb49675fd69
--- /dev/null
+++ b/packages/ui-templates/README.md
@@ -0,0 +1,11 @@
+# `@nuxt/ui-templates`
+
+<a href="https://www.npmjs.com/package/@nuxt/ui-templates-edge"><img src="https://flat.badgen.net/npm/v/@nuxt/ui-templates-edge"></a>
+
+Pre-compiled html templates for internal pages.
+
+🏀 [Online Playground](https://templates.ui.nuxtjs.org)
+
+# License
+
+[MIT](https://github.com/nuxt/nuxt/tree/main/LICENSE)
diff --git a/packages/ui-templates/index.html b/packages/ui-templates/index.html
new file mode 100644
index 000000000000..60710321daa5
--- /dev/null
+++ b/packages/ui-templates/index.html
@@ -0,0 +1,17 @@
+<!DOCTYPE html>
+<html>
+ <head>
+ <script src="https://cdn.jsdelivr.net/npm/petite-vue" defer init></script>
+ <script type="module" src="/styles.ts"></script>
+ </head>
+ <body v-scope='{{ data }}'>
+ <div class="container mx-auto pt-10">
+ <h1 class="text-4xl mb-8">Nuxt Templates</h1>
+ <ul>
+ <li v-for="name in templateNames.filter(name => !name.includes('.json'))">
+ <a :href="`/templates/${name}`" class="block border p-4 mb-2 hover:border-black">{{ name }}</a>
+ </li>
+ </ul>
+ </div>
+ </body>
+</html>
diff --git a/packages/ui-templates/lib/dev.ts b/packages/ui-templates/lib/dev.ts
new file mode 100644
index 000000000000..2dacff83ee42
--- /dev/null
+++ b/packages/ui-templates/lib/dev.ts
@@ -0,0 +1,47 @@
+import { runInNewContext } from 'node:vm'
+import { join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { promises as fsp } from 'node:fs'
+import type { Plugin } from 'vite'
+import genericMessages from '../templates/messages.json' with { type: 'json' }
+import pkg from '../../nuxt/package.json' with { type: 'json' }
+
+const templatesRoot = fileURLToPath(new URL('..', import.meta.url))
+
+const r = (...path: string[]) => resolve(join(templatesRoot, ...path))
+
+export const DevRenderingPlugin = () => {
+ return <Plugin>{
+ name: 'dev-rendering',
+ async transformIndexHtml (html: string, context) {
+ const page = context.originalUrl || '/'
+
+ if (page.endsWith('.png')) { return }
+
+ if (page === '/') {
+ const templateNames = await fsp.readdir(r('templates'))
+ const serializedData = JSON.stringify({ templateNames })
+ return html.replace('{{ data }}', serializedData)
+ }
+
+ const contents = await fsp.readFile(r(page, 'index.html'), 'utf-8')
+
+ const messages = JSON.parse(await fsp.readFile(r(page, 'messages.json'), 'utf-8'))
+
+ const chunks = contents.split(/\{{2,3}[^{}]+\}{2,3}/)
+ let templateString = chunks.shift()
+ for (const expression of contents.matchAll(/\{{2,3}([^{}]+)\}{2,3}/g)) {
+ const value = runInNewContext(expression[1]!.trim(), {
+ version: pkg.version,
+ messages: { ...genericMessages, ...messages },
+ })
+ templateString += `${value}${chunks.shift()}`
+ }
+ if (chunks.length > 0) {
+ templateString += chunks.join('')
+ }
+
+ return templateString
+ },
+ }
+}
diff --git a/packages/ui-templates/lib/prerender.ts b/packages/ui-templates/lib/prerender.ts
new file mode 100644
index 000000000000..053de489279c
--- /dev/null
+++ b/packages/ui-templates/lib/prerender.ts
@@ -0,0 +1,20 @@
+import { fileURLToPath } from 'node:url'
+import { promises as fsp } from 'node:fs'
+import { glob } from 'tinyglobby'
+
+const templatesRoot = fileURLToPath(new URL('..', import.meta.url))
+
+async function main () {
+ const templates = await glob(['dist/templates/*.js'], { cwd: templatesRoot })
+ for (const file of templates) {
+ const { template } = await import(file)
+ const updated = template({
+ // messages: {},
+ name: '{{ name }}', // TODO
+ })
+ await fsp.mkdir(file.replace('.js', ''))
+ await fsp.writeFile(file.replace('.js', '/index.html'), updated)
+ }
+}
+
+main().catch(console.error)
diff --git a/packages/ui-templates/lib/render.ts b/packages/ui-templates/lib/render.ts
new file mode 100644
index 000000000000..b9740c60d285
--- /dev/null
+++ b/packages/ui-templates/lib/render.ts
@@ -0,0 +1,211 @@
+import { fileURLToPath } from 'node:url'
+import { readFileSync, rmdirSync, unlinkSync, writeFileSync } from 'node:fs'
+import { copyFile, mkdir } from 'node:fs/promises'
+import { basename, dirname, join } from 'pathe'
+import type { Plugin } from 'vite'
+import Beasties from 'beasties'
+import { genObjectFromRawEntries } from 'knitwork'
+import htmlnano from 'htmlnano'
+import { glob } from 'tinyglobby'
+import { camelCase } from 'scule'
+
+import pkg from '../../nuxt/package.json' with { type: 'json' }
+import genericMessages from '../templates/messages.json' with { type: 'json' }
+
+const r = (path: string) => fileURLToPath(new URL(join('..', path), import.meta.url))
+const replaceAll = (input: string, search: string | RegExp, replace: string) => input.split(search).join(replace)
+
+export const RenderPlugin = () => {
+ let outputDir: string
+ return <Plugin> {
+ name: 'render',
+ configResolved (config) {
+ outputDir = r(config.build.outDir)
+ },
+ enforce: 'post',
+ async writeBundle () {
+ const critters = new Beasties({ path: outputDir })
+ const htmlFiles = await glob(['templates/**/*.html'], {
+ cwd: outputDir,
+ absolute: true,
+ })
+
+ const templateExports: Array<{
+ exportName: string
+ templateName: string
+ types: string
+ }> = []
+
+ for (const fileName of htmlFiles) {
+ // Infer template name
+ const templateName = basename(dirname(fileName))
+
+ // eslint-disable-next-line no-console
+ console.log('Processing', templateName)
+
+ // Read source template
+ let html = readFileSync(fileName, 'utf-8')
+ const isCompleteHTML = html.includes('<!DOCTYPE html>')
+
+ if (html.includes('<html')) {
+ // Apply critters to inline styles
+ html = await critters.process(html)
+ }
+ html = html.replace(/<html[^>]*>/, '<html lang="en">')
+ // We no longer need references to external CSS
+ html = html.replace(/<link[^>]*>/g, '')
+
+ // Inline SVGs
+ const svgSources: string[] = []
+
+ for (const [_, src] of html.matchAll(/src="([^"]+)"|url\([^)]+\)/g)) {
+ if (src?.match(/\.svg$/)) {
+ svgSources.push(src)
+ }
+ }
+
+ for (const src of svgSources) {
+ const svg = readFileSync(join(outputDir, src), 'utf-8')
+ const base64Source = `data:image/svg+xml;charset=utf-8,${encodeURIComponent(svg)}`
+ html = replaceAll(html, src, base64Source)
+ }
+
+ // Inline our scripts
+ const scriptSources: [string, string][] = []
+
+ for (const [block, src] of html.matchAll(/<script[^>]*src="([^"]*)"[^>]*>[\s\S]*?<\/script>/g)) {
+ if (src?.match(/^\/.*\.js$/)) {
+ scriptSources.push([block, src])
+ }
+ }
+
+ for (const [scriptBlock, src] of scriptSources) {
+ let contents = readFileSync(join(outputDir, src), 'utf-8')
+ contents = replaceAll(contents, '/* empty css */', '').trim()
+ html = html.replace(scriptBlock, contents.length ? `<script>${contents}</script>` : '')
+ }
+
+ // Minify HTML
+ html = await htmlnano.process(html, { collapseWhitespace: 'aggressive' }).then(r => r.html)
+
+ if (!isCompleteHTML) {
+ html = html.replace('<html><head></head><body>', '')
+ html = html.replace('</body></html>', '')
+ }
+
+ html = html.replace(/\{\{ version \}\}/g, pkg.version)
+
+ // Load messages
+ const messages = JSON.parse(readFileSync(r(`templates/${templateName}/messages.json`), 'utf-8'))
+
+ // Serialize into a js function
+ const chunks = html.split(/\{{2,3}[^{}]+\}{2,3}/).map(chunk => JSON.stringify(chunk))
+ const hasMessages = chunks.length > 1
+ let hasExpression = false
+ let templateString = chunks.shift()
+ for (const [_, expression] of html.matchAll(/\{{2,3}([^{}]+)\}{2,3}/g)) {
+ if (expression) {
+ hasExpression = true
+ templateString += ` + escapeHtml(${expression.trim()}) + ${chunks.shift()}`
+ }
+ }
+ if (chunks.length > 0) {
+ templateString += ' + ' + chunks.join(' + ')
+ }
+ const functionalCode = [
+ hasExpression ? 'import { escapeHtml } from \'@vue/shared\'\n' : '',
+ hasMessages ? `export type DefaultMessages = Record<${Object.keys({ ...genericMessages, ...messages }).map(a => `"${a}"`).join(' | ') || 'string'}, string | boolean | number >` : '',
+ hasMessages ? `const _messages = ${JSON.stringify({ ...genericMessages, ...messages })}` : '',
+ `export const template = (${hasMessages ? 'messages: Partial<DefaultMessages>' : ''}): string => {`,
+ hasMessages ? ' messages = { ..._messages, ...messages }' : '',
+ ` return ${templateString}`,
+ '}',
+ ].join('\n')
+
+ const templateContent = html
+ .match(/<body[^>]*>[\s\S]*<\/body>/)?.[0]
+ .replace(/(?<=<\/|<)body/g, 'div')
+ .replace(/messages\./g, '')
+ .replace(/<script[^>]*>[\s\S]*?<\/script>/g, '')
+ .replace(/<a href="(\/[^"]*)"([^>]*)>([\s\S]*)<\/a>/g, '<NuxtLink to="$1"$2>\n$3\n</NuxtLink>')
+
+ .replace(/<([^>]+) ([a-z]+)="([^"]*)\{\{\s*(\w+)\s*\}\}([^"]*)"([^>]*)>/g, '<$1 :$2="`$3${$4}$5`"$6>')
+ .replace(/>\{\{\s*(\w+)\s*\}\}<\/[\w-]*>/g, ' v-text="$1" />')
+ .replace(/>\{\{\{\s*(\w+)\s*\}\}\}<\/[\w-]*>/g, ' v-html="$1" />')
+ // We are not matching <link> <script> and <meta> tags as these aren't used yet in nuxt/ui
+ // and should be taken care of wherever this SFC is used
+ const title = html.match(/<title[^>]*>([\s\S]*)<\/title>/)?.[1]?.replace(/\{\{[\s\S]+?\}\}/g, (r) => {
+ return `\${${r.slice(2, -2)}}`.replace(/messages\./g, 'props.')
+ })
+ const styleContent = Array.from(html.matchAll(/<style[^>]*>([\s\S]*?)<\/style>/g)).map(block => block[1]).join('\n')
+ const globalStyles = styleContent.replace(/(?:\.[^{\d][^{]*\{[^}]*\})+.?/g, (r) => {
+ const lastChar = r[r.length - 1]
+ if (lastChar && !['}', '.', '@', '*', ':'].includes(lastChar)) {
+ return ';' + lastChar
+ }
+ return lastChar || ''
+ }).replace(/@media[^{]*\{\}/g, '')
+
+ const inlineScripts: string[] = []
+ for (const [_, i] of html.matchAll(/<script>([\s\S]*?)<\/script>/g)) {
+ if (i && !i.includes('const t=document.createElement("link")')) {
+ inlineScripts.push(i)
+ }
+ }
+
+ const props = genObjectFromRawEntries(Object.entries({ ...genericMessages, ...messages }).map(([key, value]) => [key, {
+ type: typeof value === 'string' ? 'String' : typeof value === 'number' ? 'Number' : typeof value === 'boolean' ? 'Boolean' : 'undefined',
+ default: JSON.stringify(value),
+ }]))
+ const vueCode = [
+ '<script setup>',
+ title && 'import { useHead } from \'#imports\'',
+ `const props = defineProps(${props})`,
+ title && 'useHead(' + genObjectFromRawEntries([
+ ['title', `\`${title}\``],
+ ['script', inlineScripts.map(s => ({ innerHTML: `\`${s.replace(/[`$]/g, '\\$&')}\`` }))],
+ ['style', [{ innerHTML: `\`${globalStyles.replace(/[`$]/g, '\\$&')}\`` }]],
+ ]) + ')',
+ '</script>',
+ '<template>',
+ templateContent,
+ '</template>',
+ '<style scoped>',
+ styleContent.replace(globalStyles, ''),
+ '</style>',
+ ].filter(Boolean).join('\n').trim()
+
+ // Generate types
+ const types = [
+ `export type DefaultMessages = Record<${Object.keys(messages).map(a => `"${a}"`).join(' | ') || 'string'}, string | boolean | number >`,
+ 'declare const template: (data: Partial<DefaultMessages>) => string',
+ 'export { template }',
+ ].join('\n')
+
+ // Register exports
+ templateExports.push({
+ exportName: camelCase(templateName),
+ templateName,
+ types,
+ })
+
+ // Write new template
+ writeFileSync(fileName.replace('/index.html', '.ts'), functionalCode)
+ writeFileSync(fileName.replace('/index.html', '.vue'), vueCode)
+
+ // Remove original html file
+ unlinkSync(fileName)
+ rmdirSync(dirname(fileName))
+ }
+
+ // we manually copy files across rather than using symbolic links for better windows support
+ const nuxtRoot = r('../nuxt')
+ const nitroRoot = r('../nitro-server')
+ for (const file of ['error-404.vue', 'error-500.vue', 'welcome.vue']) {
+ await copyFile(r(`dist/templates/${file}`), join(nuxtRoot, 'src/app/components', file))
+ }
+ await mkdir(join(nitroRoot, 'src/runtime/templates'), { recursive: true })
+ await copyFile(r(`dist/templates/error-500.ts`), join(nitroRoot, 'src/runtime/templates/error-500.ts'))
+ },
+ }
+}
diff --git a/packages/ui-templates/package.json b/packages/ui-templates/package.json
new file mode 100644
index 000000000000..ca466b73d3c9
--- /dev/null
+++ b/packages/ui-templates/package.json
@@ -0,0 +1,35 @@
+{
+ "name": "@nuxt/ui-templates",
+ "version": "1.3.3",
+ "private": true,
+ "repository": {
+ "type": "git",
+ "url": "git+https://github.com/nuxt/nuxt.git",
+ "directory": "packages/ui-templates"
+ },
+ "license": "MIT",
+ "type": "module",
+ "scripts": {
+ "build": "vite build",
+ "dev": "vite",
+ "optimize-assets": "npx svgo public/assets/**/*.svg",
+ "postinstall": "pnpm build",
+ "prerender": "pnpm build && node ./lib/prerender.ts"
+ },
+ "devDependencies": {
+ "@unocss/reset": "66.6.8",
+ "@vue/shared": "3.5.34",
+ "beasties": "0.4.2",
+ "html-validate": "11.2.0",
+ "htmlnano": "3.3.1",
+ "knitwork": "1.3.0",
+ "pathe": "2.0.3",
+ "prettier": "3.8.3",
+ "scule": "1.3.0",
+ "svgo": "4.0.1",
+ "tinyexec": "1.1.2",
+ "tinyglobby": "0.2.16",
+ "unocss": "66.6.8",
+ "vite": "8.0.12"
+ }
+}
diff --git a/packages/ui-templates/public/icons/MiniGem.svg b/packages/ui-templates/public/icons/MiniGem.svg
new file mode 100644
index 000000000000..12fc2180af23
--- /dev/null
+++ b/packages/ui-templates/public/icons/MiniGem.svg
@@ -0,0 +1 @@
+<svg width="14" height="14" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="m6.667 0 4.041 7H2.625l4.042-7zm0 14L2.625 7h8.083l-4.041 7z" opacity=".9" fill="#00DC82"/></svg>
\ No newline at end of file
diff --git a/packages/ui-templates/public/icons/book-open-solid 1.svg b/packages/ui-templates/public/icons/book-open-solid 1.svg
new file mode 100644
index 000000000000..26ee7d73eb66
--- /dev/null
+++ b/packages/ui-templates/public/icons/book-open-solid 1.svg
@@ -0,0 +1 @@
+<svg width="150" height="150" fill="none" xmlns="http://www.w3.org/2000/svg"><g clip-path="url(#a)"><path d="M163.796 9.64c-16.555.935-49.457 4.34-69.77 16.72-1.401.855-2.196 2.374-2.196 3.962v109.445c0 3.474 3.816 5.67 7.033 4.058 20.898-10.474 51.121-13.331 66.065-14.113 5.103-.268 9.069-4.34 9.069-9.222V18.874c.003-5.327-4.637-9.547-10.201-9.234zM79.971 26.36C59.66 13.98 26.758 10.58 10.204 9.64 4.64 9.327 0 13.547 0 18.874v101.619c0 4.885 3.966 8.957 9.069 9.222 14.95.782 45.188 3.642 66.086 14.122 3.208 1.609 7.012-.584 7.012-4.049V30.268c0-1.591-.792-3.05-2.197-3.908z" fill="#D1E2E2"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h150v150H0z"/></clipPath></defs></svg>
\ No newline at end of file
diff --git a/packages/ui-templates/public/icons/discord-brands 1.svg b/packages/ui-templates/public/icons/discord-brands 1.svg
new file mode 100644
index 000000000000..232cf6fc8c04
--- /dev/null
+++ b/packages/ui-templates/public/icons/discord-brands 1.svg
@@ -0,0 +1 @@
+<svg width="80" height="80" fill="none" xmlns="http://www.w3.org/2000/svg"><g clip-path="url(#a)"><path d="M63.69 51.775c0 3.325-2.47 6.05-5.596 6.05-3.072 0-5.596-2.726-5.596-6.05 0-3.325 2.469-6.05 5.596-6.05 3.127 0 5.595 2.725 5.595 6.05zm-25.62-6.05c-3.126 0-5.595 2.725-5.595 6.05 0 3.325 2.524 6.05 5.596 6.05 3.127 0 5.595-2.726 5.595-6.05.055-3.325-2.468-6.05-5.595-6.05zM96 11.227V109c-13.82-12.133-9.4-8.117-25.454-22.945l2.908 10.083H11.246C5.046 96.138 0 91.124 0 84.911V11.227C0 5.014 5.047 0 11.246 0h73.508C90.954 0 96 5.014 96 11.227zM80.366 62.893c0-17.549-7.9-31.774-7.9-31.774-7.9-5.886-15.415-5.722-15.415-5.722l-.768.872c9.326 2.834 13.66 6.922 13.66 6.922-13.031-7.096-28.338-7.097-40.978-1.581-2.03.926-3.237 1.58-3.237 1.58s4.553-4.305 14.427-7.139l-.548-.654s-7.516-.163-15.415 5.723c0 0-7.9 14.224-7.9 31.773 0 0 4.609 7.903 16.732 8.284 0 0 2.03-2.453 3.675-4.524-6.966-2.07-9.6-6.43-9.6-6.43.807.56 2.138 1.288 2.25 1.362 9.259 5.152 22.411 6.84 34.23 1.907 1.92-.708 4.06-1.743 6.309-3.215 0 0-2.743 4.469-9.93 6.486 1.647 2.07 3.621 4.414 3.621 4.414 12.124-.382 16.787-8.284 16.787-8.284z" fill="#D1E2E2"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h80v80H0z"/></clipPath></defs></svg>
\ No newline at end of file
diff --git a/packages/ui-templates/public/icons/documentation-color-light.svg b/packages/ui-templates/public/icons/documentation-color-light.svg
new file mode 100644
index 000000000000..4d53e26b548f
--- /dev/null
+++ b/packages/ui-templates/public/icons/documentation-color-light.svg
@@ -0,0 +1,71 @@
+<svg width="342" height="165" viewBox="0 0 342 165" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_2687_3947)">
+<path d="M0.152832 131.851H154.28" stroke="#E4E4E7"/>
+<path d="M215.399 107.359H349.153" stroke="#E4E4E7"/>
+<path d="M0.152832 77.2178L116.191 77.2178" stroke="#E4E4E7"/>
+<path d="M36.1528 106.921L152.191 106.921" stroke="#E4E4E7"/>
+<path d="M202.153 42.9209L317.305 42.9209" stroke="#E4E4E7"/>
+<path d="M218.153 76.9209L345.305 76.9209" stroke="#E4E4E7"/>
+<path d="M285.947 8.45605V166.979" stroke="#E4E4E7"/>
+<path d="M252.602 16.8311V107.36" stroke="#E4E4E7"/>
+<path d="M171.153 16.9209V107.45" stroke="#E4E4E7"/>
+<path d="M218.153 16.9209V43.4501" stroke="#E4E4E7"/>
+<path d="M122.153 16.9211L327.45 16.9209" stroke="#E4E4E7"/>
+<path d="M1.92432 43.3086H148.163" stroke="#E4E4E7"/>
+<path d="M122.392 16.4209V55.3659" stroke="#E4E4E7"/>
+<path d="M36.084 0.920898L36.084 176.921" stroke="#E4E4E7"/>
+<path d="M75.4448 43.249V175.152" stroke="#E4E4E7"/>
+<circle opacity="0.7" cx="75.4448" cy="77.2178" r="3.5" fill="#00DC82"/>
+<circle opacity="0.7" cx="36.1528" cy="131.85" r="3.5" fill="#00DC82"/>
+<circle opacity="0.7" cx="285.947" cy="42.9209" r="3.5" fill="#00DC82"/>
+<circle opacity="0.7" cx="252.602" cy="107.359" r="3.5" fill="#00DC82"/>
+<g filter="url(#filter0_d_2687_3947)">
+<path d="M122.846 50.7109L163.067 26.0929C166.656 23.9507 171.117 23.8611 174.77 25.8579L217.894 49.0819C221.524 51.0665 223.807 54.8133 223.892 58.9246L224.15 104.352C224.235 108.448 222.13 112.287 218.609 114.46L177.783 139.658C174.174 141.886 169.638 142.011 165.931 139.984L123.774 116.935C120.045 114.896 117.125 111.001 117.153 106.776L117.153 60.5974C117.18 56.5529 119.338 52.8048 122.846 50.7109Z" fill="white"/>
+<path d="M222.151 104.393C222.22 107.764 220.487 110.944 217.571 112.75C217.567 112.753 217.563 112.755 217.559 112.758L176.733 137.956C173.748 139.798 169.96 139.907 166.89 138.229L124.733 115.18C121.469 113.395 119.131 110.069 119.153 106.79L119.153 106.776L119.153 60.6107C119.153 60.6086 119.153 60.6065 119.153 60.6044C119.178 57.2703 120.958 54.1669 123.871 52.4282L123.881 52.4225L123.89 52.4167L164.101 27.8047C164.101 27.8047 164.101 27.8047 164.101 27.8047C164.106 27.8022 164.11 27.7997 164.114 27.7972C167.078 26.0385 170.793 25.9632 173.81 27.6128L173.81 27.6128L173.821 27.6188L216.934 50.8367C216.936 50.8377 216.938 50.8387 216.94 50.8397C219.935 52.4801 221.817 55.5878 221.892 58.9515L222.15 104.363L222.15 104.378L222.151 104.393Z" stroke="url(#paint0_linear_2687_3947)" stroke-width="4"/>
+</g>
+<path d="M192.349 96.9158L190.63 90.5186L183.778 64.9088C183.55 64.0605 182.994 63.3375 182.233 62.8988C181.472 62.4601 180.568 62.3416 179.72 62.5693L173.323 64.2877L173.116 64.3498C172.807 63.945 172.409 63.6168 171.953 63.3906C171.497 63.1644 170.995 63.0463 170.486 63.0455H163.861C163.279 63.0471 162.707 63.2043 162.205 63.501C161.703 63.2043 161.132 63.0471 160.549 63.0455H153.924C153.045 63.0455 152.203 63.3945 151.582 64.0157C150.96 64.6369 150.611 65.4795 150.611 66.358V99.483C150.611 100.362 150.96 101.204 151.582 101.825C152.203 102.447 153.045 102.796 153.924 102.796H160.549C161.132 102.794 161.703 102.637 162.205 102.34C162.707 102.637 163.279 102.794 163.861 102.796H170.486C171.365 102.796 172.207 102.447 172.829 101.825C173.45 101.204 173.799 100.362 173.799 99.483V78.8627L177.836 93.9346L179.554 100.332C179.742 101.039 180.158 101.665 180.739 102.11C181.32 102.556 182.031 102.797 182.763 102.796C183.049 102.791 183.334 102.756 183.612 102.692L190.009 100.974C190.43 100.861 190.824 100.665 191.169 100.399C191.514 100.132 191.802 99.7997 192.018 99.4209C192.238 99.047 192.381 98.6325 192.438 98.2021C192.495 97.7717 192.465 97.3342 192.349 96.9158V96.9158ZM176.325 75.4881L182.722 73.7697L187.007 89.7732L180.61 91.4916L176.325 75.4881ZM180.569 65.7783L181.873 70.5607L175.476 72.2791L174.171 67.4967L180.569 65.7783ZM170.486 66.358V91.2018H163.861V66.358H170.486ZM160.549 66.358V71.3268H153.924V66.358H160.549ZM153.924 99.483V74.6393H160.549V99.483H153.924ZM170.486 99.483H163.861V94.5143H170.486V99.483ZM189.161 97.7646L182.763 99.483L181.459 94.6799L187.877 92.9615L189.161 97.7646V97.7646Z" fill="url(#paint1_linear_2687_3947)"/>
+<rect x="2.15283" y="-3.0791" width="327" height="23" fill="url(#paint2_linear_2687_3947)"/>
+<rect width="327" height="25" transform="matrix(1 0 0 -1 2.15283 166.921)" fill="url(#paint3_linear_2687_3947)"/>
+<rect width="327" height="25" transform="matrix(0 1 1 0 0.152832 -17.0791)" fill="url(#paint4_linear_2687_3947)"/>
+<rect x="342.153" y="-17.0791" width="327" height="25" transform="rotate(90 342.153 -17.0791)" fill="url(#paint5_linear_2687_3947)"/>
+</g>
+<defs>
+<filter id="filter0_d_2687_3947" x="86.1528" y="-6.5791" width="169" height="179" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+<feFlood flood-opacity="0" result="BackgroundImageFix"/>
+<feColorMatrix in="SourceAlpha" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0" result="hardAlpha"/>
+<feOffset/>
+<feGaussianBlur stdDeviation="15.5"/>
+<feComposite in2="hardAlpha" operator="out"/>
+<feColorMatrix type="matrix" values="0 0 0 0 1 0 0 0 0 1 0 0 0 0 1 0 0 0 0.07 0"/>
+<feBlend mode="normal" in2="BackgroundImageFix" result="effect1_dropShadow_2687_3947"/>
+<feBlend mode="normal" in="SourceGraphic" in2="effect1_dropShadow_2687_3947" result="shape"/>
+</filter>
+<linearGradient id="paint0_linear_2687_3947" x1="118.202" y1="60.3042" x2="223.159" y2="113.509" gradientUnits="userSpaceOnUse">
+<stop stop-color="#00DC82"/>
+<stop offset="1" stop-color="#003F25"/>
+</linearGradient>
+<linearGradient id="paint1_linear_2687_3947" x1="150.495" y1="71.0767" x2="191.769" y2="94.1139" gradientUnits="userSpaceOnUse">
+<stop stop-color="#00DC82"/>
+<stop offset="1" stop-color="#003F25"/>
+</linearGradient>
+<linearGradient id="paint2_linear_2687_3947" x1="165.653" y1="-3.0791" x2="166.153" y2="19.9209" gradientUnits="userSpaceOnUse">
+<stop stop-color="white"/>
+<stop offset="1" stop-color="white" stop-opacity="0"/>
+</linearGradient>
+<linearGradient id="paint3_linear_2687_3947" x1="163.5" y1="-2.30278e-07" x2="164.091" y2="24.9979" gradientUnits="userSpaceOnUse">
+<stop stop-color="white"/>
+<stop offset="1" stop-color="white" stop-opacity="0"/>
+</linearGradient>
+<linearGradient id="paint4_linear_2687_3947" x1="163.5" y1="-2.30278e-07" x2="164.091" y2="24.9979" gradientUnits="userSpaceOnUse">
+<stop stop-color="white"/>
+<stop offset="1" stop-color="white" stop-opacity="0"/>
+</linearGradient>
+<linearGradient id="paint5_linear_2687_3947" x1="505.653" y1="-17.0791" x2="506.244" y2="7.91876" gradientUnits="userSpaceOnUse">
+<stop stop-color="white"/>
+<stop offset="1" stop-color="white" stop-opacity="0"/>
+</linearGradient>
+<clipPath id="clip0_2687_3947">
+<rect width="341" height="164" fill="white" transform="translate(0.152832 0.920898)"/>
+</clipPath>
+</defs>
+</svg>
diff --git a/packages/ui-templates/public/icons/documentation-color.svg b/packages/ui-templates/public/icons/documentation-color.svg
new file mode 100644
index 000000000000..9f35f39caedf
--- /dev/null
+++ b/packages/ui-templates/public/icons/documentation-color.svg
@@ -0,0 +1,71 @@
+<svg width="342" height="165" viewBox="0 0 342 165" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_2595_7273)">
+<path d="M0.152832 131.851H154.28" stroke="#27272A"/>
+<path d="M215.399 107.359H349.153" stroke="#27272A"/>
+<path d="M0.152832 77.2178L116.191 77.2178" stroke="#27272A"/>
+<path d="M36.1528 106.921L152.191 106.921" stroke="#27272A"/>
+<path d="M202.153 42.9209L317.305 42.9209" stroke="#27272A"/>
+<path d="M218.153 76.9209L345.305 76.9209" stroke="#27272A"/>
+<path d="M285.947 8.45605V166.979" stroke="#27272A"/>
+<path d="M252.602 16.8311V107.36" stroke="#27272A"/>
+<path d="M171.153 16.9209V107.45" stroke="#27272A"/>
+<path d="M218.153 16.9209V43.4501" stroke="#27272A"/>
+<path d="M122.153 16.9211L327.45 16.9209" stroke="#27272A"/>
+<path d="M1.92432 43.3086H148.163" stroke="#27272A"/>
+<path d="M122.392 16.4209V55.3659" stroke="#27272A"/>
+<path d="M36.084 0.920898L36.084 176.921" stroke="#27272A"/>
+<path d="M75.4448 43.249V175.152" stroke="#27272A"/>
+<circle opacity="0.14" cx="75.4448" cy="77.2178" r="3.5" fill="#00DC82"/>
+<circle opacity="0.14" cx="36.1528" cy="131.85" r="3.5" fill="#00DC82"/>
+<circle opacity="0.14" cx="285.947" cy="42.9209" r="3.5" fill="#00DC82"/>
+<circle opacity="0.14" cx="252.602" cy="107.359" r="3.5" fill="#00DC82"/>
+<g filter="url(#filter0_d_2595_7273)">
+<path d="M122.846 50.7109L163.067 26.0929C166.656 23.9507 171.117 23.8611 174.77 25.8579L217.894 49.0819C221.524 51.0665 223.807 54.8133 223.892 58.9246L224.15 104.352C224.235 108.448 222.13 112.287 218.609 114.46L177.783 139.658C174.174 141.886 169.638 142.011 165.931 139.984L123.774 116.935C120.045 114.896 117.125 111.001 117.153 106.776L117.153 60.5974C117.18 56.5529 119.338 52.8048 122.846 50.7109Z" fill="#18181B"/>
+<path d="M123.871 52.4282L123.881 52.4225L123.89 52.4167L164.101 27.8047C167.083 26.0291 170.786 25.9592 173.81 27.6128L173.81 27.6128L173.821 27.6188L216.934 50.8367C216.936 50.8376 216.938 50.8386 216.939 50.8395C219.938 52.4814 221.817 55.5694 221.892 58.9515L222.15 104.363L222.15 104.378L222.151 104.393C222.221 107.772 220.485 110.952 217.559 112.758L176.733 137.956C173.732 139.808 169.963 139.909 166.89 138.229L124.733 115.18C121.465 113.393 119.131 110.089 119.153 106.79L119.153 106.776L119.153 60.6107C119.153 60.6086 119.153 60.6065 119.153 60.6044C119.178 57.2703 120.958 54.1669 123.871 52.4282Z" stroke="url(#paint0_linear_2595_7273)" stroke-width="4"/>
+</g>
+<path d="M192.349 96.9158L190.63 90.5186L183.778 64.9088C183.55 64.0605 182.994 63.3375 182.233 62.8988C181.472 62.4601 180.568 62.3416 179.72 62.5693L173.323 64.2877L173.116 64.3498C172.807 63.945 172.409 63.6168 171.953 63.3906C171.497 63.1644 170.995 63.0463 170.486 63.0455H163.861C163.279 63.0471 162.707 63.2043 162.205 63.501C161.703 63.2043 161.132 63.0471 160.549 63.0455H153.924C153.045 63.0455 152.203 63.3945 151.582 64.0157C150.96 64.6369 150.611 65.4795 150.611 66.358V99.483C150.611 100.362 150.96 101.204 151.582 101.825C152.203 102.447 153.045 102.796 153.924 102.796H160.549C161.132 102.794 161.703 102.637 162.205 102.34C162.707 102.637 163.279 102.794 163.861 102.796H170.486C171.365 102.796 172.207 102.447 172.829 101.825C173.45 101.204 173.799 100.362 173.799 99.483V78.8627L177.836 93.9346L179.554 100.332C179.742 101.039 180.158 101.665 180.739 102.11C181.32 102.556 182.031 102.797 182.763 102.796C183.049 102.791 183.334 102.756 183.612 102.692L190.009 100.974C190.43 100.861 190.824 100.665 191.169 100.399C191.514 100.132 191.802 99.7998 192.018 99.4209C192.238 99.047 192.381 98.6325 192.438 98.2021C192.495 97.7717 192.465 97.3342 192.349 96.9158ZM176.325 75.4881L182.722 73.7697L187.007 89.7732L180.61 91.4916L176.325 75.4881ZM180.569 65.7783L181.873 70.5607L175.476 72.2791L174.171 67.4967L180.569 65.7783ZM170.486 66.358V91.2018H163.861V66.358H170.486ZM160.549 66.358V71.3268H153.924V66.358H160.549ZM153.924 99.483V74.6393H160.549V99.483H153.924ZM170.486 99.483H163.861V94.5143H170.486V99.483ZM189.161 97.7646L182.763 99.483L181.459 94.6799L187.877 92.9615L189.161 97.7646Z" fill="url(#paint1_linear_2595_7273)"/>
+<rect x="2.15283" y="-3.0791" width="327" height="23" fill="url(#paint2_linear_2595_7273)"/>
+<rect width="327" height="25" transform="matrix(1 0 0 -1 2.15283 166.921)" fill="url(#paint3_linear_2595_7273)"/>
+<rect width="327" height="25" transform="matrix(0 1 1 0 0.152832 -17.0791)" fill="url(#paint4_linear_2595_7273)"/>
+<rect x="342.153" y="-17.0791" width="327" height="25" transform="rotate(90 342.153 -17.0791)" fill="url(#paint5_linear_2595_7273)"/>
+</g>
+<defs>
+<filter id="filter0_d_2595_7273" x="86.1528" y="-6.5791" width="169" height="179" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+<feFlood flood-opacity="0" result="BackgroundImageFix"/>
+<feColorMatrix in="SourceAlpha" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0" result="hardAlpha"/>
+<feOffset/>
+<feGaussianBlur stdDeviation="15.5"/>
+<feComposite in2="hardAlpha" operator="out"/>
+<feColorMatrix type="matrix" values="0 0 0 0 1 0 0 0 0 1 0 0 0 0 1 0 0 0 0.07 0"/>
+<feBlend mode="normal" in2="BackgroundImageFix" result="effect1_dropShadow_2595_7273"/>
+<feBlend mode="normal" in="SourceGraphic" in2="effect1_dropShadow_2595_7273" result="shape"/>
+</filter>
+<linearGradient id="paint0_linear_2595_7273" x1="118.202" y1="60.3042" x2="223.159" y2="113.509" gradientUnits="userSpaceOnUse">
+<stop stop-color="#00DC82"/>
+<stop offset="1" stop-color="#003F25"/>
+</linearGradient>
+<linearGradient id="paint1_linear_2595_7273" x1="150.495" y1="71.0767" x2="191.769" y2="94.1139" gradientUnits="userSpaceOnUse">
+<stop stop-color="#00DC82"/>
+<stop offset="1" stop-color="#003F25"/>
+</linearGradient>
+<linearGradient id="paint2_linear_2595_7273" x1="165.653" y1="-3.0791" x2="166.153" y2="19.9209" gradientUnits="userSpaceOnUse">
+<stop stop-color="#18181B"/>
+<stop offset="1" stop-color="#18181B" stop-opacity="0"/>
+</linearGradient>
+<linearGradient id="paint3_linear_2595_7273" x1="163.5" y1="-2.30278e-07" x2="164.091" y2="24.9979" gradientUnits="userSpaceOnUse">
+<stop stop-color="#18181B"/>
+<stop offset="1" stop-color="#18181B" stop-opacity="0"/>
+</linearGradient>
+<linearGradient id="paint4_linear_2595_7273" x1="163.5" y1="-2.30278e-07" x2="164.091" y2="24.9979" gradientUnits="userSpaceOnUse">
+<stop stop-color="#18181B"/>
+<stop offset="1" stop-color="#18181B" stop-opacity="0"/>
+</linearGradient>
+<linearGradient id="paint5_linear_2595_7273" x1="505.653" y1="-17.0791" x2="506.244" y2="7.91876" gradientUnits="userSpaceOnUse">
+<stop stop-color="#18181B"/>
+<stop offset="1" stop-color="#18181B" stop-opacity="0"/>
+</linearGradient>
+<clipPath id="clip0_2595_7273">
+<rect width="341" height="164" fill="white" transform="translate(0.152832 0.920898)"/>
+</clipPath>
+</defs>
+</svg>
diff --git a/packages/ui-templates/public/icons/documentation-light.svg b/packages/ui-templates/public/icons/documentation-light.svg
new file mode 100644
index 000000000000..43ba152c71ad
--- /dev/null
+++ b/packages/ui-templates/public/icons/documentation-light.svg
@@ -0,0 +1,71 @@
+<svg width="342" height="165" viewBox="0 0 342 165" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_2687_3977)">
+<path d="M0.152832 131.851H154.28" stroke="#E4E4E7"/>
+<path d="M215.399 107.359H349.153" stroke="#E4E4E7"/>
+<path d="M0.152832 77.2178L116.191 77.2178" stroke="#E4E4E7"/>
+<path d="M36.1528 106.921L152.191 106.921" stroke="#E4E4E7"/>
+<path d="M202.153 42.9209L317.305 42.9209" stroke="#E4E4E7"/>
+<path d="M218.153 76.9209L345.305 76.9209" stroke="#E4E4E7"/>
+<path d="M285.947 8.45605V166.979" stroke="#E4E4E7"/>
+<path d="M252.602 16.8311V107.36" stroke="#E4E4E7"/>
+<path d="M171.153 16.9209V107.45" stroke="#E4E4E7"/>
+<path d="M218.153 16.9209V43.4501" stroke="#E4E4E7"/>
+<path d="M122.153 16.9211L327.45 16.9209" stroke="#E4E4E7"/>
+<path d="M1.92432 43.3086H148.163" stroke="#E4E4E7"/>
+<path d="M122.392 16.4209V55.3659" stroke="#E4E4E7"/>
+<path d="M36.084 0.920898L36.084 176.921" stroke="#E4E4E7"/>
+<path d="M75.4448 43.249V175.152" stroke="#E4E4E7"/>
+<circle opacity="0.7" cx="75.4448" cy="77.2178" r="3.5" fill="#A1A1AA"/>
+<circle opacity="0.7" cx="36.1528" cy="131.85" r="3.5" fill="#A1A1AA"/>
+<circle opacity="0.7" cx="285.947" cy="42.9209" r="3.5" fill="#A1A1AA"/>
+<circle opacity="0.7" cx="252.602" cy="107.359" r="3.5" fill="#A1A1AA"/>
+<g filter="url(#filter0_d_2687_3977)">
+<path d="M122.846 50.7109L163.067 26.0929C166.656 23.9507 171.117 23.8611 174.77 25.8579L217.894 49.0819C221.524 51.0665 223.807 54.8133 223.892 58.9246L224.15 104.352C224.235 108.448 222.13 112.287 218.609 114.46L177.783 139.658C174.174 141.886 169.638 142.011 165.931 139.984L123.774 116.935C120.045 114.896 117.125 111.001 117.153 106.776L117.153 60.5974C117.18 56.5529 119.338 52.8048 122.846 50.7109Z" fill="white"/>
+<path d="M222.151 104.393C222.22 107.764 220.487 110.944 217.571 112.75C217.567 112.753 217.563 112.755 217.559 112.758L176.733 137.956C173.748 139.798 169.96 139.907 166.89 138.229L124.733 115.18C121.469 113.395 119.131 110.069 119.153 106.79L119.153 106.776L119.153 60.6107C119.153 60.6086 119.153 60.6065 119.153 60.6044C119.178 57.2703 120.958 54.1669 123.871 52.4282L123.881 52.4225L123.89 52.4167L164.101 27.8047C164.101 27.8047 164.101 27.8047 164.101 27.8047C164.106 27.8022 164.11 27.7997 164.114 27.7972C167.078 26.0385 170.793 25.9632 173.81 27.6128L173.81 27.6128L173.821 27.6188L216.934 50.8367C216.936 50.8377 216.938 50.8387 216.94 50.8397C219.935 52.4801 221.817 55.5878 221.892 58.9515L222.15 104.363L222.15 104.378L222.151 104.393Z" stroke="url(#paint0_linear_2687_3977)" stroke-width="4"/>
+</g>
+<path d="M192.349 96.9158L190.63 90.5186L183.778 64.9088C183.55 64.0605 182.994 63.3375 182.233 62.8988C181.472 62.4601 180.568 62.3416 179.72 62.5693L173.323 64.2877L173.116 64.3498C172.807 63.945 172.409 63.6168 171.953 63.3906C171.497 63.1644 170.995 63.0463 170.486 63.0455H163.861C163.279 63.0471 162.707 63.2043 162.205 63.501C161.703 63.2043 161.132 63.0471 160.549 63.0455H153.924C153.045 63.0455 152.203 63.3945 151.582 64.0157C150.96 64.6369 150.611 65.4795 150.611 66.358V99.483C150.611 100.362 150.96 101.204 151.582 101.825C152.203 102.447 153.045 102.796 153.924 102.796H160.549C161.132 102.794 161.703 102.637 162.205 102.34C162.707 102.637 163.279 102.794 163.861 102.796H170.486C171.365 102.796 172.207 102.447 172.829 101.825C173.45 101.204 173.799 100.362 173.799 99.483V78.8627L177.836 93.9346L179.554 100.332C179.742 101.039 180.158 101.665 180.739 102.11C181.32 102.556 182.031 102.797 182.763 102.796C183.049 102.791 183.334 102.756 183.612 102.692L190.009 100.974C190.43 100.861 190.824 100.665 191.169 100.399C191.514 100.132 191.802 99.7997 192.018 99.4209C192.238 99.047 192.381 98.6325 192.438 98.2021C192.495 97.7717 192.465 97.3342 192.349 96.9158V96.9158ZM176.325 75.4881L182.722 73.7697L187.007 89.7732L180.61 91.4916L176.325 75.4881ZM180.569 65.7783L181.873 70.5607L175.476 72.2791L174.171 67.4967L180.569 65.7783ZM170.486 66.358V91.2018H163.861V66.358H170.486ZM160.549 66.358V71.3268H153.924V66.358H160.549ZM153.924 99.483V74.6393H160.549V99.483H153.924ZM170.486 99.483H163.861V94.5143H170.486V99.483ZM189.161 97.7646L182.763 99.483L181.459 94.6799L187.877 92.9615L189.161 97.7646V97.7646Z" fill="url(#paint1_linear_2687_3977)"/>
+<rect x="2.15283" y="-3.0791" width="327" height="23" fill="url(#paint2_linear_2687_3977)"/>
+<rect width="327" height="25" transform="matrix(1 0 0 -1 2.15283 166.921)" fill="url(#paint3_linear_2687_3977)"/>
+<rect width="327" height="25" transform="matrix(0 1 1 0 0.152832 -17.0791)" fill="url(#paint4_linear_2687_3977)"/>
+<rect x="342.153" y="-17.0791" width="327" height="25" transform="rotate(90 342.153 -17.0791)" fill="url(#paint5_linear_2687_3977)"/>
+</g>
+<defs>
+<filter id="filter0_d_2687_3977" x="86.1528" y="-6.5791" width="169" height="179" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+<feFlood flood-opacity="0" result="BackgroundImageFix"/>
+<feColorMatrix in="SourceAlpha" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0" result="hardAlpha"/>
+<feOffset/>
+<feGaussianBlur stdDeviation="15.5"/>
+<feComposite in2="hardAlpha" operator="out"/>
+<feColorMatrix type="matrix" values="0 0 0 0 0.831373 0 0 0 0 0.831373 0 0 0 0 0.847059 0 0 0 0.07 0"/>
+<feBlend mode="normal" in2="BackgroundImageFix" result="effect1_dropShadow_2687_3977"/>
+<feBlend mode="normal" in="SourceGraphic" in2="effect1_dropShadow_2687_3977" result="shape"/>
+</filter>
+<linearGradient id="paint0_linear_2687_3977" x1="118.202" y1="60.3042" x2="223.159" y2="113.509" gradientUnits="userSpaceOnUse">
+<stop stop-color="#D4D4D8"/>
+<stop offset="1" stop-color="#3F3F46"/>
+</linearGradient>
+<linearGradient id="paint1_linear_2687_3977" x1="150.495" y1="71.0767" x2="191.769" y2="94.1139" gradientUnits="userSpaceOnUse">
+<stop stop-color="#D4D4D8"/>
+<stop offset="1" stop-color="#3F3F46"/>
+</linearGradient>
+<linearGradient id="paint2_linear_2687_3977" x1="165.653" y1="-3.0791" x2="166.153" y2="19.9209" gradientUnits="userSpaceOnUse">
+<stop stop-color="white"/>
+<stop offset="1" stop-color="white" stop-opacity="0"/>
+</linearGradient>
+<linearGradient id="paint3_linear_2687_3977" x1="163.5" y1="-2.30278e-07" x2="164.091" y2="24.9979" gradientUnits="userSpaceOnUse">
+<stop stop-color="white"/>
+<stop offset="1" stop-color="white" stop-opacity="0"/>
+</linearGradient>
+<linearGradient id="paint4_linear_2687_3977" x1="163.5" y1="-2.30278e-07" x2="164.091" y2="24.9979" gradientUnits="userSpaceOnUse">
+<stop stop-color="white"/>
+<stop offset="1" stop-color="white" stop-opacity="0"/>
+</linearGradient>
+<linearGradient id="paint5_linear_2687_3977" x1="505.653" y1="-17.0791" x2="506.244" y2="7.91876" gradientUnits="userSpaceOnUse">
+<stop stop-color="white"/>
+<stop offset="1" stop-color="white" stop-opacity="0"/>
+</linearGradient>
+<clipPath id="clip0_2687_3977">
+<rect width="341" height="164" fill="white" transform="translate(0.152832 0.920898)"/>
+</clipPath>
+</defs>
+</svg>
diff --git a/packages/ui-templates/public/icons/documentation.svg b/packages/ui-templates/public/icons/documentation.svg
new file mode 100644
index 000000000000..e30b52137d4d
--- /dev/null
+++ b/packages/ui-templates/public/icons/documentation.svg
@@ -0,0 +1,71 @@
+<svg width="342" height="165" viewBox="0 0 342 165" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_2595_7193)">
+<path d="M0.152832 131.851H154.28" stroke="#27272A"/>
+<path d="M215.399 107.359H349.153" stroke="#27272A"/>
+<path d="M0.152832 77.2178L116.191 77.2178" stroke="#27272A"/>
+<path d="M36.1528 106.921L152.191 106.921" stroke="#27272A"/>
+<path d="M202.153 42.9209L317.305 42.9209" stroke="#27272A"/>
+<path d="M218.153 76.9209L345.305 76.9209" stroke="#27272A"/>
+<path d="M285.947 8.45605V166.979" stroke="#27272A"/>
+<path d="M252.602 16.8311V107.36" stroke="#27272A"/>
+<path d="M171.153 16.9209V107.45" stroke="#27272A"/>
+<path d="M218.153 16.9209V43.4501" stroke="#27272A"/>
+<path d="M122.153 16.9211L327.45 16.9209" stroke="#27272A"/>
+<path d="M1.92432 43.3086H148.163" stroke="#27272A"/>
+<path d="M122.392 16.4209V55.3659" stroke="#27272A"/>
+<path d="M36.084 0.920898L36.084 176.921" stroke="#27272A"/>
+<path d="M75.4448 43.249V175.152" stroke="#27272A"/>
+<circle opacity="0.14" cx="75.4448" cy="77.2178" r="3.5" fill="white"/>
+<circle opacity="0.14" cx="36.1528" cy="131.85" r="3.5" fill="white"/>
+<circle opacity="0.14" cx="285.947" cy="42.9209" r="3.5" fill="white"/>
+<circle opacity="0.14" cx="252.602" cy="107.359" r="3.5" fill="white"/>
+<g filter="url(#filter0_d_2595_7193)">
+<path d="M122.846 50.7109L163.067 26.0929C166.656 23.9507 171.117 23.8611 174.77 25.8579L217.894 49.0819C221.524 51.0665 223.807 54.8133 223.892 58.9246L224.15 104.352C224.235 108.448 222.13 112.287 218.609 114.46L177.783 139.658C174.174 141.886 169.638 142.011 165.931 139.984L123.774 116.935C120.045 114.896 117.125 111.001 117.153 106.776L117.153 60.5974C117.18 56.5529 119.338 52.8048 122.846 50.7109Z" fill="#18181B"/>
+<path d="M123.871 52.4282L123.881 52.4225L123.89 52.4167L164.101 27.8047C167.083 26.0291 170.786 25.9592 173.81 27.6128L173.81 27.6128L173.821 27.6188L216.934 50.8367C216.936 50.8376 216.938 50.8386 216.939 50.8395C219.938 52.4814 221.817 55.5694 221.892 58.9515L222.15 104.363L222.15 104.378L222.151 104.393C222.221 107.772 220.485 110.952 217.559 112.758L176.733 137.956C173.732 139.808 169.963 139.909 166.89 138.229L124.733 115.18C121.465 113.393 119.131 110.089 119.153 106.79L119.153 106.776L119.153 60.6107C119.153 60.6086 119.153 60.6065 119.153 60.6044C119.178 57.2703 120.958 54.1669 123.871 52.4282Z" stroke="url(#paint0_linear_2595_7193)" stroke-width="4"/>
+</g>
+<path d="M192.349 96.9158L190.63 90.5186L183.778 64.9088C183.55 64.0605 182.994 63.3375 182.233 62.8988C181.472 62.4601 180.568 62.3416 179.72 62.5693L173.323 64.2877L173.116 64.3498C172.807 63.945 172.409 63.6168 171.953 63.3906C171.497 63.1644 170.995 63.0463 170.486 63.0455H163.861C163.279 63.0471 162.707 63.2043 162.205 63.501C161.703 63.2043 161.132 63.0471 160.549 63.0455H153.924C153.045 63.0455 152.203 63.3945 151.582 64.0157C150.96 64.6369 150.611 65.4795 150.611 66.358V99.483C150.611 100.362 150.96 101.204 151.582 101.825C152.203 102.447 153.045 102.796 153.924 102.796H160.549C161.132 102.794 161.703 102.637 162.205 102.34C162.707 102.637 163.279 102.794 163.861 102.796H170.486C171.365 102.796 172.207 102.447 172.829 101.825C173.45 101.204 173.799 100.362 173.799 99.483V78.8627L177.836 93.9346L179.554 100.332C179.742 101.039 180.158 101.665 180.739 102.11C181.32 102.556 182.031 102.797 182.763 102.796C183.049 102.791 183.334 102.756 183.612 102.692L190.009 100.974C190.43 100.861 190.824 100.665 191.169 100.399C191.514 100.132 191.802 99.7998 192.018 99.4209C192.238 99.047 192.381 98.6325 192.438 98.2021C192.495 97.7717 192.465 97.3342 192.349 96.9158ZM176.325 75.4881L182.722 73.7697L187.007 89.7732L180.61 91.4916L176.325 75.4881ZM180.569 65.7783L181.873 70.5607L175.476 72.2791L174.171 67.4967L180.569 65.7783ZM170.486 66.358V91.2018H163.861V66.358H170.486ZM160.549 66.358V71.3268H153.924V66.358H160.549ZM153.924 99.483V74.6393H160.549V99.483H153.924ZM170.486 99.483H163.861V94.5143H170.486V99.483ZM189.161 97.7646L182.763 99.483L181.459 94.6799L187.877 92.9615L189.161 97.7646Z" fill="url(#paint1_linear_2595_7193)"/>
+<rect x="2.15283" y="-3.0791" width="327" height="23" fill="url(#paint2_linear_2595_7193)"/>
+<rect width="327" height="25" transform="matrix(1 0 0 -1 2.15283 166.921)" fill="url(#paint3_linear_2595_7193)"/>
+<rect width="327" height="25" transform="matrix(0 1 1 0 0.152832 -17.0791)" fill="url(#paint4_linear_2595_7193)"/>
+<rect x="342.153" y="-17.0791" width="327" height="25" transform="rotate(90 342.153 -17.0791)" fill="url(#paint5_linear_2595_7193)"/>
+</g>
+<defs>
+<filter id="filter0_d_2595_7193" x="86.1528" y="-6.5791" width="169" height="179" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+<feFlood flood-opacity="0" result="BackgroundImageFix"/>
+<feColorMatrix in="SourceAlpha" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0" result="hardAlpha"/>
+<feOffset/>
+<feGaussianBlur stdDeviation="15.5"/>
+<feComposite in2="hardAlpha" operator="out"/>
+<feColorMatrix type="matrix" values="0 0 0 0 1 0 0 0 0 1 0 0 0 0 1 0 0 0 0.07 0"/>
+<feBlend mode="normal" in2="BackgroundImageFix" result="effect1_dropShadow_2595_7193"/>
+<feBlend mode="normal" in="SourceGraphic" in2="effect1_dropShadow_2595_7193" result="shape"/>
+</filter>
+<linearGradient id="paint0_linear_2595_7193" x1="118.202" y1="60.3042" x2="223.159" y2="113.509" gradientUnits="userSpaceOnUse">
+<stop stop-color="white"/>
+<stop offset="1" stop-color="#71717A"/>
+</linearGradient>
+<linearGradient id="paint1_linear_2595_7193" x1="150.495" y1="71.0767" x2="191.769" y2="94.1139" gradientUnits="userSpaceOnUse">
+<stop stop-color="white"/>
+<stop offset="1" stop-color="#71717A"/>
+</linearGradient>
+<linearGradient id="paint2_linear_2595_7193" x1="165.653" y1="-3.0791" x2="166.153" y2="19.9209" gradientUnits="userSpaceOnUse">
+<stop stop-color="#18181B"/>
+<stop offset="1" stop-color="#18181B" stop-opacity="0"/>
+</linearGradient>
+<linearGradient id="paint3_linear_2595_7193" x1="163.5" y1="-2.30278e-07" x2="164.091" y2="24.9979" gradientUnits="userSpaceOnUse">
+<stop stop-color="#18181B"/>
+<stop offset="1" stop-color="#18181B" stop-opacity="0"/>
+</linearGradient>
+<linearGradient id="paint4_linear_2595_7193" x1="163.5" y1="-2.30278e-07" x2="164.091" y2="24.9979" gradientUnits="userSpaceOnUse">
+<stop stop-color="#18181B"/>
+<stop offset="1" stop-color="#18181B" stop-opacity="0"/>
+</linearGradient>
+<linearGradient id="paint5_linear_2595_7193" x1="505.653" y1="-17.0791" x2="506.244" y2="7.91876" gradientUnits="userSpaceOnUse">
+<stop stop-color="#18181B"/>
+<stop offset="1" stop-color="#18181B" stop-opacity="0"/>
+</linearGradient>
+<clipPath id="clip0_2595_7193">
+<rect width="341" height="164" fill="white" transform="translate(0.152832 0.920898)"/>
+</clipPath>
+</defs>
+</svg>
diff --git a/packages/ui-templates/public/icons/examples-color-light.svg b/packages/ui-templates/public/icons/examples-color-light.svg
new file mode 100644
index 000000000000..56bf71461fdf
--- /dev/null
+++ b/packages/ui-templates/public/icons/examples-color-light.svg
@@ -0,0 +1,14 @@
+<svg width="53" height="58" viewBox="0 0 53 58" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M49.1971 43.7595C49.1113 43.8209 49.0231 43.8796 48.9325 43.9357L29.0918 56.2117C27.6504 57.1035 25.8212 57.1564 24.3387 56.3439L3.85107 45.1148C2.27157 44.2491 1.14238 42.6366 1.15291 41.0494L1.15293 41.0427L1.153 18.552C1.15301 18.5509 1.15302 18.5499 1.15302 18.5488C1.16485 16.9324 2.02611 15.4289 3.43319 14.5869L3.43322 14.587L3.44269 14.5812L22.9844 2.59084C24.4169 1.73583 26.2139 1.69824 27.6729 2.49791L27.6729 2.49792L27.6784 2.50094L48.6303 13.8121C48.6313 13.8126 48.6322 13.8131 48.6331 13.8136C50.0797 14.6078 50.9898 16.1132 51.026 17.7438L51.1517 39.8672L51.1517 39.8746L51.1519 39.8821C51.1834 41.4138 50.4491 42.8635 49.1971 43.7595Z" fill="white" stroke="url(#paint0_linear_2613_3941)" stroke-width="2"/>
+<path d="M37.1528 17.9209H15.1528C14.6224 17.9209 14.1137 18.1316 13.7386 18.5067C13.3635 18.8818 13.1528 19.3905 13.1528 19.9209V37.9209C13.1528 38.4513 13.3635 38.96 13.7386 39.3351C14.1137 39.7102 14.6224 39.9209 15.1528 39.9209H37.1528C37.6833 39.9209 38.192 39.7102 38.567 39.3351C38.9421 38.96 39.1528 38.4513 39.1528 37.9209V19.9209C39.1528 19.3905 38.9421 18.8818 38.567 18.5067C38.192 18.1316 37.6833 17.9209 37.1528 17.9209V17.9209ZM15.1528 19.9209H37.1528V24.9209H15.1528V19.9209ZM15.1528 26.9209H22.1528V37.9209H15.1528V26.9209ZM37.1528 37.9209H24.1528V26.9209H37.1528V37.9209Z" fill="url(#paint1_linear_2613_3941)"/>
+<defs>
+<linearGradient id="paint0_linear_2613_3941" x1="0.662695" y1="18.4025" x2="51.7209" y2="44.2212" gradientUnits="userSpaceOnUse">
+<stop stop-color="#8DEAFF"/>
+<stop offset="1" stop-color="#008AA9"/>
+</linearGradient>
+<linearGradient id="paint1_linear_2613_3941" x1="13.0804" y1="22.6224" x2="37.028" y2="37.847" gradientUnits="userSpaceOnUse">
+<stop stop-color="#8DEAFF"/>
+<stop offset="1" stop-color="#008AA9"/>
+</linearGradient>
+</defs>
+</svg>
diff --git a/packages/ui-templates/public/icons/examples-color.svg b/packages/ui-templates/public/icons/examples-color.svg
new file mode 100644
index 000000000000..205303bc3bea
--- /dev/null
+++ b/packages/ui-templates/public/icons/examples-color.svg
@@ -0,0 +1,14 @@
+<svg width="53" height="58" viewBox="0 0 53 58" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M3.43319 14.5869L3.43322 14.587L3.44269 14.5812L22.9844 2.59084C24.4246 1.73116 26.2124 1.69742 27.6729 2.49791L27.6729 2.49792L27.6784 2.50094L48.6303 13.8121C48.6313 13.8126 48.6322 13.8131 48.6331 13.8137C50.0812 14.6086 50.9896 16.1043 51.026 17.7437L51.1517 39.8672L51.1517 39.8746L51.1519 39.8821C51.1856 41.5203 50.346 43.0611 48.9325 43.9357L29.0918 56.2117C27.6424 57.1085 25.8227 57.1572 24.3387 56.3439L3.85107 45.1148C2.26984 44.2481 1.14232 42.646 1.15293 41.0494V41.0427L1.153 18.552C1.15301 18.5509 1.15302 18.5499 1.15302 18.5488C1.16485 16.9324 2.02611 15.4289 3.43319 14.5869Z" fill="#18181B" stroke="url(#paint0_linear_2595_7426)" stroke-width="2"/>
+<path d="M37.1528 17.9209H15.1528C14.6224 17.9209 14.1137 18.1316 13.7386 18.5067C13.3635 18.8818 13.1528 19.3905 13.1528 19.9209V37.9209C13.1528 38.4513 13.3635 38.96 13.7386 39.3351C14.1137 39.7102 14.6224 39.9209 15.1528 39.9209H37.1528C37.6833 39.9209 38.192 39.7102 38.567 39.3351C38.9421 38.96 39.1528 38.4513 39.1528 37.9209V19.9209C39.1528 19.3905 38.9421 18.8818 38.567 18.5067C38.192 18.1316 37.6833 17.9209 37.1528 17.9209ZM15.1528 19.9209H37.1528V24.9209H15.1528V19.9209ZM15.1528 26.9209H22.1528V37.9209H15.1528V26.9209ZM37.1528 37.9209H24.1528V26.9209H37.1528V37.9209Z" fill="url(#paint1_linear_2595_7426)"/>
+<defs>
+<linearGradient id="paint0_linear_2595_7426" x1="0.662695" y1="18.4025" x2="51.7209" y2="44.2212" gradientUnits="userSpaceOnUse">
+<stop stop-color="#8DEAFF"/>
+<stop offset="1" stop-color="#008AA9"/>
+</linearGradient>
+<linearGradient id="paint1_linear_2595_7426" x1="13.0804" y1="22.6224" x2="37.028" y2="37.847" gradientUnits="userSpaceOnUse">
+<stop stop-color="#8DEAFF"/>
+<stop offset="1" stop-color="#008AA9"/>
+</linearGradient>
+</defs>
+</svg>
diff --git a/packages/ui-templates/public/icons/examples-light.svg b/packages/ui-templates/public/icons/examples-light.svg
new file mode 100644
index 000000000000..8fd136728f86
--- /dev/null
+++ b/packages/ui-templates/public/icons/examples-light.svg
@@ -0,0 +1,14 @@
+<svg width="53" height="58" viewBox="0 0 53 58" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M49.1971 43.7595C49.1113 43.8209 49.0231 43.8796 48.9325 43.9357L29.0918 56.2117C27.6504 57.1035 25.8212 57.1564 24.3387 56.3439L3.85107 45.1148C2.27157 44.2491 1.14238 42.6366 1.15291 41.0494L1.15293 41.0427L1.153 18.552C1.15301 18.5509 1.15302 18.5499 1.15302 18.5488C1.16485 16.9324 2.02611 15.4289 3.43319 14.5869L3.43322 14.587L3.44269 14.5812L22.9844 2.59084C24.4169 1.73583 26.2139 1.69824 27.6729 2.49791L27.6729 2.49792L27.6784 2.50094L48.6303 13.8121C48.6313 13.8126 48.6322 13.8131 48.6331 13.8136C50.0797 14.6078 50.9898 16.1132 51.026 17.7438L51.1517 39.8672L51.1517 39.8746L51.1519 39.8821C51.1834 41.4138 50.4491 42.8635 49.1971 43.7595Z" fill="white" stroke="url(#paint0_linear_2691_4397)" stroke-width="2"/>
+<path d="M37.1528 17.9209H15.1528C14.6224 17.9209 14.1137 18.1316 13.7386 18.5067C13.3635 18.8818 13.1528 19.3905 13.1528 19.9209V37.9209C13.1528 38.4513 13.3635 38.96 13.7386 39.3351C14.1137 39.7102 14.6224 39.9209 15.1528 39.9209H37.1528C37.6833 39.9209 38.192 39.7102 38.567 39.3351C38.9421 38.96 39.1528 38.4513 39.1528 37.9209V19.9209C39.1528 19.3905 38.9421 18.8818 38.567 18.5067C38.192 18.1316 37.6833 17.9209 37.1528 17.9209V17.9209ZM15.1528 19.9209H37.1528V24.9209H15.1528V19.9209ZM15.1528 26.9209H22.1528V37.9209H15.1528V26.9209ZM37.1528 37.9209H24.1528V26.9209H37.1528V37.9209Z" fill="url(#paint1_linear_2691_4397)"/>
+<defs>
+<linearGradient id="paint0_linear_2691_4397" x1="0.662695" y1="18.4025" x2="51.7209" y2="44.2212" gradientUnits="userSpaceOnUse">
+<stop stop-color="#D4D4D8"/>
+<stop offset="1" stop-color="#71717A"/>
+</linearGradient>
+<linearGradient id="paint1_linear_2691_4397" x1="13.0804" y1="22.6224" x2="37.028" y2="37.847" gradientUnits="userSpaceOnUse">
+<stop stop-color="#D4D4D8"/>
+<stop offset="1" stop-color="#71717A"/>
+</linearGradient>
+</defs>
+</svg>
diff --git a/packages/ui-templates/public/icons/examples.svg b/packages/ui-templates/public/icons/examples.svg
new file mode 100644
index 000000000000..4ddf85946399
--- /dev/null
+++ b/packages/ui-templates/public/icons/examples.svg
@@ -0,0 +1,14 @@
+<svg width="53" height="58" viewBox="0 0 53 58" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M3.43319 14.5869L3.43322 14.587L3.44269 14.5812L22.9844 2.59084C24.4246 1.73116 26.2124 1.69742 27.6729 2.49791L27.6729 2.49792L27.6784 2.50094L48.6303 13.8121C48.6313 13.8126 48.6322 13.8131 48.6331 13.8137C50.0812 14.6086 50.9896 16.1043 51.026 17.7437L51.1517 39.8672L51.1517 39.8746L51.1519 39.8821C51.1856 41.5203 50.346 43.0611 48.9325 43.9357L29.0918 56.2117C27.6424 57.1085 25.8227 57.1572 24.3387 56.3439L3.85107 45.1148C2.26984 44.2481 1.14232 42.646 1.15293 41.0494V41.0427L1.153 18.552C1.15301 18.5509 1.15302 18.5499 1.15302 18.5488C1.16485 16.9324 2.02611 15.4289 3.43319 14.5869Z" fill="#18181B" stroke="url(#paint0_linear_2595_7182)" stroke-width="2"/>
+<path d="M37.1528 17.9209H15.1528C14.6224 17.9209 14.1137 18.1316 13.7386 18.5067C13.3635 18.8818 13.1528 19.3905 13.1528 19.9209V37.9209C13.1528 38.4513 13.3635 38.96 13.7386 39.3351C14.1137 39.7102 14.6224 39.9209 15.1528 39.9209H37.1528C37.6833 39.9209 38.192 39.7102 38.567 39.3351C38.9421 38.96 39.1528 38.4513 39.1528 37.9209V19.9209C39.1528 19.3905 38.9421 18.8818 38.567 18.5067C38.192 18.1316 37.6833 17.9209 37.1528 17.9209ZM15.1528 19.9209H37.1528V24.9209H15.1528V19.9209ZM15.1528 26.9209H22.1528V37.9209H15.1528V26.9209ZM37.1528 37.9209H24.1528V26.9209H37.1528V37.9209Z" fill="url(#paint1_linear_2595_7182)"/>
+<defs>
+<linearGradient id="paint0_linear_2595_7182" x1="0.662695" y1="18.4025" x2="51.7209" y2="44.2212" gradientUnits="userSpaceOnUse">
+<stop stop-color="white"/>
+<stop offset="1" stop-color="#71717A"/>
+</linearGradient>
+<linearGradient id="paint1_linear_2595_7182" x1="13.0804" y1="22.6224" x2="37.028" y2="37.847" gradientUnits="userSpaceOnUse">
+<stop stop-color="white"/>
+<stop offset="1" stop-color="#71717A"/>
+</linearGradient>
+</defs>
+</svg>
diff --git a/packages/ui-templates/public/icons/get-started-light.svg b/packages/ui-templates/public/icons/get-started-light.svg
new file mode 100644
index 000000000000..0e659c79615d
--- /dev/null
+++ b/packages/ui-templates/public/icons/get-started-light.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="105" height="116" fill="none"><g filter="url(#a)"><path fill="#fff" d="M17.203 33.223 46.9 14.286a8.416 8.416 0 0 1 8.64-.18L87.38 31.97c2.68 1.527 4.365 4.409 4.428 7.571l.191 34.944c.063 3.151-1.491 6.104-4.091 7.776l-30.143 19.383a8.417 8.417 0 0 1-8.75.251l-31.126-17.73C15.135 82.595 12.98 79.6 13 76.35V40.828c.02-3.111 1.614-5.994 4.203-7.605Z"/><path stroke="url(#b)" stroke-width="2" d="M46.9 14.286 17.202 33.223c-2.59 1.61-4.183 4.494-4.203 7.605V76.35m33.9-62.064a8.416 8.416 0 0 1 8.64-.18m-8.64.18a8.435 8.435 0 0 1 8.64-.18M13 76.35c-.02 3.25 2.135 6.246 4.888 7.814M13 76.35c-.02 3.233 2.136 6.247 4.888 7.814m0 0 31.126 17.731m0 0a8.417 8.417 0 0 0 8.75-.251m-8.75.251a8.438 8.438 0 0 0 8.75-.251m0 0 30.143-19.383m0 0c2.598-1.67 4.154-4.627 4.091-7.776m-4.091 7.776c2.6-1.672 4.154-4.625 4.091-7.776m0 0-.19-34.944m0 0c-.064-3.162-1.75-6.044-4.43-7.571m4.43 7.571c-.063-3.147-1.75-6.045-4.43-7.571m0 0L55.54 14.105"/></g><path fill="#fff" d="M32 37h42v42H32z"/><path fill="url(#c)" d="M48.669 67.697c-.886 2.69-3.02 4.659-6.153 5.709-1.41.465-2.88.72-4.364.755a1.313 1.313 0 0 1-1.312-1.313c.035-1.484.29-2.954.754-4.364 1.05-3.134 3.02-5.266 5.71-6.152a1.314 1.314 0 1 1 .836 2.477c-3.232 1.083-4.232 4.577-4.544 6.595 2.018-.311 5.512-1.312 6.595-4.544a1.313 1.313 0 0 1 2.477.837Zm16.39-12.486-1.46 1.477v10.057a2.657 2.657 0 0 1-.772 1.854l-5.316 5.3a2.559 2.559 0 0 1-1.853.77 2.413 2.413 0 0 1-.755-.115 2.626 2.626 0 0 1-1.821-2.001l-1.296-6.48-6.858-6.858-6.48-1.297a2.625 2.625 0 0 1-2.002-1.82 2.609 2.609 0 0 1 .656-2.61l5.3-5.315a2.658 2.658 0 0 1 1.853-.771h10.057l1.477-1.46c4.692-4.692 9.499-4.561 11.353-4.282a2.576 2.576 0 0 1 2.198 2.198c.28 1.854.41 6.661-4.282 11.353Zm-26.103.132 6.185 1.23 6.546-6.546h-7.432l-5.299 5.316ZM47.438 58 53 63.562l10.205-10.204c1.28-1.28 4.2-4.725 3.543-9.106-4.38-.656-7.826 2.264-9.105 3.544L47.438 58Zm13.535 1.313-6.546 6.546 1.23 6.185 5.316-5.299v-7.432Z"/><defs><linearGradient id="b" x1="57.994" x2="92" y1="58" y2="58" gradientUnits="userSpaceOnUse"><stop stop-color="#00DC82"/><stop offset=".5" stop-color="#1DE0B1"/><stop offset="1" stop-color="#36E4DA"/></linearGradient><linearGradient id="c" x1="55.197" x2="69.453" y1="58.108" y2="58.108" gradientUnits="userSpaceOnUse"><stop stop-color="#00DC82"/><stop offset=".5" stop-color="#1DE0B1"/><stop offset="1" stop-color="#36E4DA"/></linearGradient><filter id="a" width="104.897" height="115.897" x=".052" y=".052" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feColorMatrix in="SourceAlpha" result="hardAlpha" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0"/><feOffset/><feGaussianBlur stdDeviation="5.974"/><feComposite in2="hardAlpha" operator="out"/><feColorMatrix values="0 0 0 0 1 0 0 0 0 1 0 0 0 0 1 0 0 0 0.07 0"/><feBlend in2="BackgroundImageFix" result="effect1_dropShadow_2726_4054"/><feBlend in="SourceGraphic" in2="effect1_dropShadow_2726_4054" result="shape"/></filter></defs></svg>
diff --git a/packages/ui-templates/public/icons/get-started.svg b/packages/ui-templates/public/icons/get-started.svg
new file mode 100644
index 000000000000..c03dfddb824a
--- /dev/null
+++ b/packages/ui-templates/public/icons/get-started.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="105" height="116" fill="none"><g filter="url(#a)" shape-rendering="geometricPrecision"><path fill="#18181B" d="M17.203 33.223 46.9 14.286a8.416 8.416 0 0 1 8.64-.18L87.38 31.97c2.68 1.527 4.365 4.409 4.428 7.571l.191 34.944c.063 3.151-1.491 6.104-4.091 7.776l-30.143 19.383a8.417 8.417 0 0 1-8.75.251l-31.126-17.73C15.135 82.595 12.98 79.6 13 76.35V40.828c.02-3.111 1.614-5.994 4.203-7.605Z"/><path stroke="url(#b)" stroke-width="2" d="M46.9 14.286 17.202 33.223c-2.59 1.61-4.183 4.494-4.203 7.605V76.35m33.9-62.064a8.416 8.416 0 0 1 8.64-.18m-8.64.18a8.435 8.435 0 0 1 8.64-.18M13 76.35c-.02 3.25 2.135 6.246 4.888 7.814M13 76.35c-.02 3.233 2.136 6.247 4.888 7.814m0 0 31.126 17.731m0 0a8.417 8.417 0 0 0 8.75-.251m-8.75.251a8.438 8.438 0 0 0 8.75-.251m0 0 30.143-19.383m0 0c2.598-1.67 4.154-4.627 4.091-7.776m-4.091 7.776c2.6-1.672 4.154-4.625 4.091-7.776m0 0-.19-34.944m0 0c-.064-3.162-1.75-6.044-4.43-7.571m4.43 7.571c-.063-3.147-1.75-6.045-4.43-7.571m0 0L55.54 14.105"/></g><path fill="url(#c)" d="M48.669 67.696c-.886 2.69-3.02 4.659-6.153 5.709-1.41.465-2.88.72-4.364.755a1.313 1.313 0 0 1-1.312-1.313c.035-1.484.29-2.954.754-4.364 1.05-3.133 3.02-5.266 5.71-6.152a1.312 1.312 0 1 1 .836 2.477c-3.232 1.083-4.232 4.577-4.544 6.595 2.018-.311 5.512-1.312 6.595-4.544a1.313 1.313 0 0 1 2.477.837Zm16.39-12.486-1.46 1.477v10.057a2.657 2.657 0 0 1-.772 1.854l-5.316 5.3a2.559 2.559 0 0 1-1.853.77 2.413 2.413 0 0 1-.755-.115 2.624 2.624 0 0 1-1.821-2.001l-1.296-6.48-6.858-6.858-6.48-1.297a2.625 2.625 0 0 1-2.002-1.82 2.609 2.609 0 0 1 .656-2.61l5.3-5.315a2.658 2.658 0 0 1 1.853-.771h10.057l1.477-1.46c4.692-4.692 9.499-4.561 11.353-4.282a2.576 2.576 0 0 1 2.198 2.198c.28 1.854.41 6.661-4.282 11.353Zm-26.103.132 6.185 1.23 6.546-6.546h-7.432l-5.299 5.316Zm8.482 2.657L53 63.561l10.205-10.205c1.28-1.28 4.2-4.724 3.543-9.105-4.38-.656-7.826 2.264-9.105 3.544L47.438 57.999Zm13.535 1.313-6.546 6.546 1.23 6.185 5.316-5.299v-7.432Z" shape-rendering="geometricPrecision"/><defs><linearGradient id="b" x1="57.994" x2="92" y1="58" y2="58" gradientUnits="userSpaceOnUse"><stop stop-color="#00DC82"/><stop offset=".5" stop-color="#1DE0B1"/><stop offset="1" stop-color="#36E4DA"/></linearGradient><linearGradient id="c" x1="55.197" x2="69.453" y1="58.107" y2="58.107" gradientUnits="userSpaceOnUse"><stop stop-color="#00DC82"/><stop offset=".5" stop-color="#1DE0B1"/><stop offset="1" stop-color="#36E4DA"/></linearGradient><filter id="a" width="104.897" height="115.897" x=".052" y=".052" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feColorMatrix in="SourceAlpha" result="hardAlpha" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0"/><feOffset/><feGaussianBlur stdDeviation="5.974"/><feComposite in2="hardAlpha" operator="out"/><feColorMatrix values="0 0 0 0 1 0 0 0 0 1 0 0 0 0 1 0 0 0 0.07 0"/><feBlend in2="BackgroundImageFix" result="effect1_dropShadow_2724_4091"/><feBlend in="SourceGraphic" in2="effect1_dropShadow_2724_4091" result="shape"/></filter></defs></svg>
diff --git a/packages/ui-templates/public/icons/github-brands 1.svg b/packages/ui-templates/public/icons/github-brands 1.svg
new file mode 100644
index 000000000000..fea66eaa58f2
--- /dev/null
+++ b/packages/ui-templates/public/icons/github-brands 1.svg
@@ -0,0 +1 @@
+<svg width="80" height="87" fill="none" xmlns="http://www.w3.org/2000/svg"><g clip-path="url(#a)"><path d="M31.44 75.289c0 .379-.435.682-.985.682-.625.056-1.061-.247-1.061-.682 0-.38.436-.682.985-.682.569-.057 1.062.246 1.062.682zm-5.893-.853c-.133.379.246.815.815.928.492.19 1.061 0 1.175-.379.113-.378-.247-.814-.815-.985-.493-.132-1.043.057-1.175.436zm8.376-.322c-.55.133-.928.493-.871.928.056.38.55.626 1.118.493.55-.133.928-.493.871-.871-.056-.36-.568-.607-1.118-.55zm12.47-72.598C20.109 1.516 0 21.465 0 47.742c0 21.01 13.228 38.99 32.123 45.317 2.426.436 3.279-1.06 3.279-2.292 0-1.175-.057-7.654-.057-11.632 0 0-13.266 2.841-16.052-5.646 0 0-2.16-5.513-5.269-6.934 0 0-4.34-2.975.303-2.918 0 0 4.72.38 7.316 4.888 4.15 7.313 11.105 5.21 13.816 3.96.435-3.031 1.667-5.134 3.032-6.385-10.594-1.174-21.283-2.709-21.283-20.934 0-5.21 1.44-7.825 4.473-11.16-.493-1.23-2.104-6.308.492-12.863 3.961-1.232 13.077 5.115 13.077 5.115 3.79-1.06 7.865-1.61 11.902-1.61 4.036 0 8.11.55 11.901 1.61 0 0 9.116-6.365 13.077-5.115 2.596 6.574.985 11.632.493 12.864 3.032 3.353 4.89 5.968 4.89 11.159 0 18.282-11.163 19.74-21.757 20.934 1.743 1.497 3.221 4.339 3.221 8.79 0 6.385-.056 14.286-.056 15.84 0 1.23.871 2.727 3.278 2.291C81.151 86.731 94 68.752 94 47.742 94 21.465 72.68 1.516 46.394 1.516zM18.422 66.858c-.246.19-.19.625.133.985.303.303.739.436.985.19.246-.19.19-.626-.133-.986-.303-.303-.739-.435-.985-.189zm-2.047-1.535c-.133.247.057.55.436.74.303.189.682.132.815-.133.133-.247-.057-.55-.436-.74-.379-.113-.682-.056-.815.133zm6.14 6.745c-.303.246-.189.815.247 1.175.436.435.985.492 1.232.189.246-.246.132-.815-.247-1.175-.417-.435-.985-.492-1.231-.189zm-2.16-2.785c-.303.19-.303.682 0 1.118.303.436.815.625 1.061.436.303-.247.303-.74 0-1.175-.265-.436-.758-.625-1.061-.379z" fill="#D1E2E2"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h80v86.761H0z"/></clipPath></defs></svg>
\ No newline at end of file
diff --git a/packages/ui-templates/public/icons/logo.svg b/packages/ui-templates/public/icons/logo.svg
new file mode 100644
index 000000000000..619081c4ab7e
--- /dev/null
+++ b/packages/ui-templates/public/icons/logo.svg
@@ -0,0 +1,3 @@
+<svg width="61" height="42" viewBox="0 0 61 42" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M33.9869 41.2211H56.412C57.1243 41.2212 57.824 41.0336 58.4408 40.6772C59.0576 40.3209 59.5698 39.8083 59.9258 39.191C60.2818 38.5737 60.469 37.8736 60.4687 37.1609C60.4684 36.4482 60.2805 35.7482 59.924 35.1313L44.864 9.03129C44.508 8.41416 43.996 7.90168 43.3793 7.54537C42.7626 7.18906 42.063 7.00147 41.3509 7.00147C40.6387 7.00147 39.9391 7.18906 39.3225 7.54537C38.7058 7.90168 38.1937 8.41416 37.8377 9.03129L33.9869 15.7093L26.458 2.65061C26.1018 2.03354 25.5895 1.52113 24.9726 1.16489C24.3557 0.808639 23.656 0.621094 22.9438 0.621094C22.2316 0.621094 21.5318 0.808639 20.915 1.16489C20.2981 1.52113 19.7858 2.03354 19.4296 2.65061L0.689224 35.1313C0.332704 35.7482 0.144842 36.4482 0.144532 37.1609C0.144222 37.8736 0.331476 38.5737 0.687459 39.191C1.04344 39.8083 1.5556 40.3209 2.17243 40.6772C2.78925 41.0336 3.48899 41.2212 4.20126 41.2211H18.2778C23.8551 41.2211 27.9682 38.7699 30.7984 33.9876L37.6694 22.0813L41.3498 15.7093L52.3951 34.8492H37.6694L33.9869 41.2211ZM18.0484 34.8426L8.2247 34.8404L22.9504 9.32211L30.2979 22.0813L25.3784 30.6092C23.4989 33.7121 21.3637 34.8426 18.0484 34.8426Z" fill="#00DC82"/>
+</svg>
diff --git a/packages/ui-templates/public/icons/modules-color-light.svg b/packages/ui-templates/public/icons/modules-color-light.svg
new file mode 100644
index 000000000000..161ab3921d7a
--- /dev/null
+++ b/packages/ui-templates/public/icons/modules-color-light.svg
@@ -0,0 +1,19 @@
+<svg width="53" height="58" viewBox="0 0 53 58" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_2613_3853)">
+<path d="M51.1519 39.8821C51.154 39.9844 51.1527 40.0863 51.148 40.1877C51.0782 41.7091 50.2566 43.1165 48.9325 43.9357L29.0918 56.2117C27.6504 57.1035 25.8212 57.1564 24.3387 56.3439L3.85107 45.1148C2.27157 44.2491 1.14238 42.6366 1.15291 41.0494L1.15293 41.0427L1.153 18.552C1.15301 18.5509 1.15302 18.5499 1.15302 18.5488C1.16485 16.9324 2.02611 15.4289 3.43319 14.5869L3.43322 14.587L3.44269 14.5812L22.9844 2.59084C24.4169 1.73583 26.2139 1.69824 27.6729 2.49791L27.6729 2.49792L27.6784 2.50094L48.6303 13.8121C48.6313 13.8126 48.6322 13.8131 48.6331 13.8136C50.0797 14.6078 50.9898 16.1132 51.026 17.7438L51.1517 39.8672L51.1517 39.8746L51.1519 39.8821Z" fill="white" stroke="url(#paint0_linear_2613_3853)" stroke-width="2"/>
+<path d="M33.8193 42.2552H17.8193C16.7585 42.2552 15.7411 41.8337 14.9909 41.0836C14.2408 40.3334 13.8193 39.316 13.8193 38.2552V24.9218C13.8193 23.861 14.2408 22.8435 14.9909 22.0934C15.7411 21.3433 16.7585 20.9218 17.8193 20.9218H19.1527C19.1751 19.792 19.5558 18.6985 20.2399 17.7991C20.924 16.8996 21.8761 16.2407 22.9589 15.9173C24.0416 15.594 25.1992 15.6229 26.2644 16C27.3297 16.377 28.2477 17.0827 28.886 18.0152C29.4839 18.8674 29.8094 19.8808 29.8193 20.9218H33.8193C34.173 20.9218 34.5121 21.0623 34.7621 21.3124C35.0122 21.5624 35.1527 21.9015 35.1527 22.2552V26.2552C36.2825 26.2776 37.376 26.6583 38.2754 27.3424C39.1749 28.0265 39.8338 28.9786 40.1572 30.0613C40.4805 31.1441 40.4516 32.3016 40.0745 33.3669C39.6975 34.4322 38.9918 35.3502 38.0593 35.9885C37.2071 36.5864 36.1937 36.9118 35.1527 36.9218V36.9218V40.9218C35.1527 41.2755 35.0122 41.6146 34.7621 41.8646C34.5121 42.1147 34.173 42.2552 33.8193 42.2552ZM17.8193 23.5885C17.4657 23.5885 17.1266 23.729 16.8765 23.979C16.6265 24.2291 16.486 24.5682 16.486 24.9218V38.2552C16.486 38.6088 16.6265 38.9479 16.8765 39.198C17.1266 39.448 17.4657 39.5885 17.8193 39.5885H32.486V35.3485C32.4849 35.1347 32.5351 34.9238 32.6326 34.7335C32.7301 34.5432 32.8718 34.3792 33.046 34.2552C33.2196 34.1313 33.4204 34.051 33.6316 34.0208C33.8427 33.9907 34.058 34.0116 34.2593 34.0818C34.6393 34.2368 35.0532 34.2901 35.46 34.2363C35.8669 34.1825 36.2527 34.0236 36.5793 33.7752C36.9045 33.5769 37.1834 33.3113 37.3973 32.9962C37.6111 32.6811 37.7551 32.3239 37.8193 31.9485C37.8708 31.5699 37.8402 31.1847 37.7298 30.8189C37.6194 30.4532 37.4317 30.1154 37.1793 29.8285C36.8381 29.414 36.3734 29.1193 35.8529 28.9874C35.3325 28.8555 34.7835 28.8932 34.286 29.0952C34.0846 29.1654 33.8694 29.1863 33.6582 29.1562C33.4471 29.126 33.2463 29.0457 33.0727 28.9218C32.8985 28.7978 32.7567 28.6338 32.6593 28.4435C32.5618 28.2532 32.5115 28.0423 32.5127 27.8285V23.5885H28.246C28.0269 23.6009 27.8081 23.559 27.609 23.4666C27.4099 23.3742 27.2368 23.234 27.1049 23.0586C26.973 22.8832 26.8864 22.6779 26.8529 22.461C26.8194 22.2441 26.8399 22.0222 26.9127 21.8152C27.0677 21.4352 27.1209 21.0213 27.0671 20.6145C27.0134 20.2076 26.8544 19.8218 26.606 19.4952C26.4091 19.1607 26.1395 18.8749 25.8172 18.6588C25.4948 18.4427 25.128 18.3019 24.7438 18.2468C24.3597 18.1917 23.9681 18.2238 23.598 18.3407C23.2279 18.4575 22.8889 18.6561 22.606 18.9218C22.3433 19.1824 22.1377 19.4948 22.0023 19.8391C21.8668 20.1834 21.8045 20.5521 21.8193 20.9218C21.8224 21.2277 21.8812 21.5304 21.9927 21.8152C22.0632 22.0168 22.0842 22.2324 22.054 22.4438C22.0237 22.6553 21.9432 22.8564 21.819 23.0302C21.6949 23.204 21.5308 23.3454 21.3406 23.4426C21.1504 23.5397 20.9396 23.5898 20.726 23.5885H17.8193Z" fill="url(#paint1_linear_2613_3853)"/>
+</g>
+<defs>
+<linearGradient id="paint0_linear_2613_3853" x1="0.662695" y1="18.4025" x2="51.7209" y2="44.2212" gradientUnits="userSpaceOnUse">
+<stop stop-color="#F7D14C"/>
+<stop offset="1" stop-color="#A38108"/>
+</linearGradient>
+<linearGradient id="paint1_linear_2613_3853" x1="13.7453" y1="21.3705" x2="40.3876" y2="35.7024" gradientUnits="userSpaceOnUse">
+<stop stop-color="#F7D14C"/>
+<stop offset="1" stop-color="#A38108"/>
+</linearGradient>
+<clipPath id="clip0_2613_3853">
+<rect width="52" height="57" fill="white" transform="translate(0.152832 0.920898)"/>
+</clipPath>
+</defs>
+</svg>
diff --git a/packages/ui-templates/public/icons/modules-color.svg b/packages/ui-templates/public/icons/modules-color.svg
new file mode 100644
index 000000000000..3101d01195bf
--- /dev/null
+++ b/packages/ui-templates/public/icons/modules-color.svg
@@ -0,0 +1,14 @@
+<svg width="53" height="58" viewBox="0 0 53 58" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M3.43319 14.5869L3.43322 14.587L3.44269 14.5812L22.9844 2.59084C24.4246 1.73116 26.2124 1.69742 27.6729 2.49791L27.6729 2.49792L27.6784 2.50094L48.6303 13.8121C48.6313 13.8126 48.6322 13.8131 48.6331 13.8137C50.0812 14.6086 50.9896 16.1043 51.026 17.7437L51.1517 39.8672L51.1517 39.8746L51.1519 39.8821C51.1856 41.5204 50.346 43.0611 48.9325 43.9357L29.0918 56.2117C27.6424 57.1085 25.8227 57.1572 24.3387 56.3439L3.85107 45.1148C2.26984 44.2481 1.14232 42.646 1.15293 41.0494V41.0427L1.153 18.552C1.15301 18.5509 1.15302 18.5499 1.15302 18.5488C1.16485 16.9324 2.02611 15.4289 3.43319 14.5869Z" fill="#18181B" stroke="url(#paint0_linear_2595_7337)" stroke-width="2"/>
+<path d="M33.8193 42.2542H17.8193C16.7585 42.2542 15.7411 41.8328 14.9909 41.0826C14.2408 40.3325 13.8193 39.3151 13.8193 38.2542V24.9209C13.8193 23.86 14.2408 22.8426 14.9909 22.0924C15.7411 21.3423 16.7585 20.9209 17.8193 20.9209H19.1527C19.1751 19.791 19.5558 18.6975 20.2399 17.7981C20.924 16.8986 21.8761 16.2397 22.9589 15.9164C24.0416 15.593 25.1992 15.6219 26.2644 15.999C27.3297 16.376 28.2477 17.0817 28.886 18.0142C29.4839 18.8664 29.8094 19.8799 29.8193 20.9209H33.8193C34.173 20.9209 34.5121 21.0613 34.7621 21.3114C35.0122 21.5614 35.1527 21.9006 35.1527 22.2542V26.2542C36.2825 26.2766 37.376 26.6573 38.2754 27.3414C39.1749 28.0255 39.8338 28.9776 40.1572 30.0604C40.4805 31.1432 40.4516 32.3007 40.0745 33.366C39.6975 34.4312 38.9918 35.3492 38.0593 35.9875C37.2071 36.5854 36.1937 36.9109 35.1527 36.9209V40.9209C35.1527 41.2745 35.0122 41.6136 34.7621 41.8637C34.5121 42.1137 34.173 42.2542 33.8193 42.2542ZM17.8193 23.5875C17.4657 23.5875 17.1266 23.728 16.8765 23.978C16.6265 24.2281 16.486 24.5672 16.486 24.9209V38.2542C16.486 38.6078 16.6265 38.9469 16.8765 39.197C17.1266 39.447 17.4657 39.5875 17.8193 39.5875H32.486V35.3475C32.4849 35.1337 32.5351 34.9228 32.6326 34.7325C32.7301 34.5422 32.8718 34.3782 33.046 34.2542C33.2196 34.1304 33.4205 34.05 33.6316 34.0198C33.8427 33.9897 34.058 34.0106 34.2593 34.0809C34.6393 34.2359 35.0532 34.2891 35.46 34.2353C35.8669 34.1816 36.2527 34.0226 36.5793 33.7742C36.9045 33.5759 37.1834 33.3103 37.3973 32.9952C37.6111 32.6801 37.7551 32.3229 37.8193 31.9475C37.8708 31.5689 37.8402 31.1837 37.7298 30.8179C37.6194 30.4522 37.4317 30.1144 37.1793 29.8275C36.8381 29.413 36.3734 29.1183 35.8529 28.9864C35.3325 28.8545 34.7835 28.8923 34.286 29.0942C34.0846 29.1644 33.8694 29.1854 33.6582 29.1552C33.4471 29.125 33.2463 29.0447 33.0727 28.9209C32.8985 28.7969 32.7567 28.6328 32.6593 28.4425C32.5618 28.2522 32.5115 28.0413 32.5127 27.8275V23.5875H28.246C28.0269 23.5999 27.8081 23.5581 27.609 23.4656C27.4099 23.3732 27.2368 23.233 27.1049 23.0576C26.973 22.8822 26.8864 22.6769 26.8529 22.46C26.8194 22.2431 26.8399 22.0213 26.9127 21.8142C27.0677 21.4342 27.1209 21.0204 27.0671 20.6135C27.0134 20.2066 26.8544 19.8208 26.606 19.4942C26.4091 19.1597 26.1395 18.8739 25.8172 18.6578C25.4948 18.4417 25.128 18.3009 24.7438 18.2458C24.3597 18.1908 23.9681 18.2228 23.598 18.3397C23.2279 18.4565 22.8889 18.6552 22.606 18.9209C22.3433 19.1814 22.1377 19.4938 22.0023 19.8381C21.8668 20.1824 21.8045 20.5512 21.8193 20.9209C21.8224 21.2267 21.8812 21.5294 21.9927 21.8142C22.0632 22.0158 22.0842 22.2314 22.054 22.4429C22.0237 22.6543 21.9432 22.8554 21.819 23.0292C21.6949 23.203 21.5308 23.3444 21.3406 23.4416C21.1504 23.5388 20.9396 23.5888 20.726 23.5875H17.8193Z" fill="url(#paint1_linear_2595_7337)"/>
+<defs>
+<linearGradient id="paint0_linear_2595_7337" x1="0.662695" y1="18.4025" x2="51.7209" y2="44.2212" gradientUnits="userSpaceOnUse">
+<stop stop-color="#F7D14C"/>
+<stop offset="1" stop-color="#A38108"/>
+</linearGradient>
+<linearGradient id="paint1_linear_2595_7337" x1="13.7453" y1="21.3695" x2="40.3876" y2="35.7015" gradientUnits="userSpaceOnUse">
+<stop stop-color="#F7D14C"/>
+<stop offset="1" stop-color="#A38108"/>
+</linearGradient>
+</defs>
+</svg>
diff --git a/packages/ui-templates/public/icons/modules-light.svg b/packages/ui-templates/public/icons/modules-light.svg
new file mode 100644
index 000000000000..2d478129a85a
--- /dev/null
+++ b/packages/ui-templates/public/icons/modules-light.svg
@@ -0,0 +1,19 @@
+<svg width="53" height="58" viewBox="0 0 53 58" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_2691_4389)">
+<path d="M51.1519 39.8821C51.154 39.9844 51.1527 40.0863 51.148 40.1877C51.0782 41.7091 50.2566 43.1165 48.9325 43.9357L29.0918 56.2117C27.6504 57.1035 25.8212 57.1564 24.3387 56.3439L3.85107 45.1148C2.27157 44.2491 1.14238 42.6366 1.15291 41.0494L1.15293 41.0427L1.153 18.552C1.15301 18.5509 1.15302 18.5499 1.15302 18.5488C1.16485 16.9324 2.02611 15.4289 3.43319 14.5869L3.43322 14.587L3.44269 14.5812L22.9844 2.59084C24.4169 1.73583 26.2139 1.69824 27.6729 2.49791L27.6729 2.49792L27.6784 2.50094L48.6303 13.8121C48.6313 13.8126 48.6322 13.8131 48.6331 13.8136C50.0797 14.6078 50.9898 16.1132 51.026 17.7438L51.1517 39.8672L51.1517 39.8746L51.1519 39.8821Z" fill="white" stroke="url(#paint0_linear_2691_4389)" stroke-width="2"/>
+<path d="M33.8193 42.2542H17.8193C16.7585 42.2542 15.7411 41.8328 14.9909 41.0826C14.2408 40.3325 13.8193 39.3151 13.8193 38.2542V24.9209C13.8193 23.86 14.2408 22.8426 14.9909 22.0924C15.7411 21.3423 16.7585 20.9209 17.8193 20.9209H19.1527C19.1751 19.791 19.5558 18.6975 20.2399 17.7981C20.924 16.8986 21.8761 16.2397 22.9589 15.9164C24.0416 15.593 25.1992 15.6219 26.2644 15.999C27.3297 16.376 28.2477 17.0817 28.886 18.0142C29.4839 18.8664 29.8094 19.8799 29.8193 20.9209H33.8193C34.173 20.9209 34.5121 21.0613 34.7621 21.3114C35.0122 21.5614 35.1527 21.9006 35.1527 22.2542V26.2542C36.2825 26.2766 37.376 26.6573 38.2754 27.3414C39.1749 28.0255 39.8338 28.9776 40.1572 30.0604C40.4805 31.1432 40.4516 32.3007 40.0745 33.366C39.6975 34.4312 38.9918 35.3492 38.0593 35.9875C37.2071 36.5854 36.1937 36.9109 35.1527 36.9209V36.9209V40.9209C35.1527 41.2745 35.0122 41.6136 34.7621 41.8637C34.5121 42.1137 34.173 42.2542 33.8193 42.2542ZM17.8193 23.5875C17.4657 23.5875 17.1266 23.728 16.8765 23.978C16.6265 24.2281 16.486 24.5672 16.486 24.9209V38.2542C16.486 38.6078 16.6265 38.9469 16.8765 39.197C17.1266 39.447 17.4657 39.5875 17.8193 39.5875H32.486V35.3475C32.4849 35.1337 32.5351 34.9228 32.6326 34.7325C32.7301 34.5422 32.8718 34.3782 33.046 34.2542C33.2196 34.1304 33.4204 34.05 33.6316 34.0198C33.8427 33.9897 34.058 34.0106 34.2593 34.0809C34.6393 34.2359 35.0532 34.2891 35.46 34.2353C35.8669 34.1816 36.2527 34.0226 36.5793 33.7742C36.9045 33.5759 37.1834 33.3103 37.3973 32.9952C37.6111 32.6801 37.7551 32.3229 37.8193 31.9475C37.8708 31.5689 37.8402 31.1837 37.7298 30.8179C37.6194 30.4522 37.4317 30.1144 37.1793 29.8275C36.8381 29.413 36.3734 29.1183 35.8529 28.9864C35.3325 28.8545 34.7835 28.8923 34.286 29.0942C34.0846 29.1644 33.8694 29.1854 33.6582 29.1552C33.4471 29.125 33.2463 29.0447 33.0727 28.9209C32.8985 28.7969 32.7567 28.6328 32.6593 28.4425C32.5618 28.2522 32.5115 28.0413 32.5127 27.8275V23.5875H28.246C28.0269 23.5999 27.8081 23.5581 27.609 23.4656C27.4099 23.3732 27.2368 23.233 27.1049 23.0576C26.973 22.8822 26.8864 22.6769 26.8529 22.46C26.8194 22.2431 26.8399 22.0213 26.9127 21.8142C27.0677 21.4342 27.1209 21.0204 27.0671 20.6135C27.0134 20.2066 26.8544 19.8208 26.606 19.4942C26.4091 19.1597 26.1395 18.8739 25.8172 18.6578C25.4948 18.4417 25.128 18.3009 24.7438 18.2458C24.3597 18.1908 23.9681 18.2228 23.598 18.3397C23.2279 18.4565 22.8889 18.6552 22.606 18.9209C22.3433 19.1814 22.1377 19.4938 22.0023 19.8381C21.8668 20.1824 21.8045 20.5512 21.8193 20.9209C21.8224 21.2267 21.8812 21.5294 21.9927 21.8142C22.0632 22.0158 22.0842 22.2314 22.054 22.4429C22.0237 22.6543 21.9432 22.8554 21.819 23.0292C21.6949 23.203 21.5308 23.3444 21.3406 23.4416C21.1504 23.5388 20.9396 23.5888 20.726 23.5875H17.8193Z" fill="url(#paint1_linear_2691_4389)"/>
+</g>
+<defs>
+<linearGradient id="paint0_linear_2691_4389" x1="0.662695" y1="18.4025" x2="51.7209" y2="44.2212" gradientUnits="userSpaceOnUse">
+<stop stop-color="#D4D4D8"/>
+<stop offset="1" stop-color="#71717A"/>
+</linearGradient>
+<linearGradient id="paint1_linear_2691_4389" x1="13.7453" y1="21.3695" x2="40.3876" y2="35.7015" gradientUnits="userSpaceOnUse">
+<stop stop-color="#D4D4D8"/>
+<stop offset="1" stop-color="#71717A"/>
+</linearGradient>
+<clipPath id="clip0_2691_4389">
+<rect width="52" height="57" fill="white" transform="translate(0.152832 0.920898)"/>
+</clipPath>
+</defs>
+</svg>
diff --git a/packages/ui-templates/public/icons/modules.svg b/packages/ui-templates/public/icons/modules.svg
new file mode 100644
index 000000000000..496593d5ed52
--- /dev/null
+++ b/packages/ui-templates/public/icons/modules.svg
@@ -0,0 +1,14 @@
+<svg width="53" height="58" viewBox="0 0 53 58" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M3.43319 14.5869L3.43322 14.587L3.44269 14.5812L22.9844 2.59084C24.4246 1.73116 26.2124 1.69742 27.6729 2.49791L27.6729 2.49792L27.6784 2.50094L48.6303 13.8121C48.6313 13.8126 48.6322 13.8131 48.6331 13.8137C50.0812 14.6086 50.9896 16.1043 51.026 17.7437L51.1517 39.8672L51.1517 39.8746L51.1519 39.8821C51.1856 41.5203 50.346 43.0611 48.9325 43.9357L29.0918 56.2117C27.6424 57.1085 25.8227 57.1572 24.3387 56.3439L3.85107 45.1148C2.26984 44.2481 1.14232 42.646 1.15293 41.0494V41.0427L1.153 18.552C1.15301 18.5509 1.15302 18.5499 1.15302 18.5488C1.16485 16.9324 2.02611 15.4289 3.43319 14.5869Z" fill="#18181B" stroke="url(#paint0_linear_2595_7175)" stroke-width="2"/>
+<path d="M33.8193 42.2542H17.8193C16.7585 42.2542 15.7411 41.8328 14.9909 41.0826C14.2408 40.3325 13.8193 39.3151 13.8193 38.2542V24.9209C13.8193 23.86 14.2408 22.8426 14.9909 22.0924C15.7411 21.3423 16.7585 20.9209 17.8193 20.9209H19.1527C19.1751 19.791 19.5558 18.6975 20.2399 17.7981C20.924 16.8986 21.8761 16.2397 22.9589 15.9164C24.0416 15.593 25.1992 15.6219 26.2644 15.999C27.3297 16.376 28.2477 17.0817 28.886 18.0142C29.4839 18.8664 29.8094 19.8799 29.8193 20.9209H33.8193C34.173 20.9209 34.5121 21.0613 34.7621 21.3114C35.0122 21.5614 35.1527 21.9006 35.1527 22.2542V26.2542C36.2825 26.2766 37.376 26.6573 38.2754 27.3414C39.1749 28.0255 39.8338 28.9776 40.1572 30.0604C40.4805 31.1432 40.4516 32.3007 40.0745 33.366C39.6975 34.4312 38.9918 35.3492 38.0593 35.9875C37.2071 36.5854 36.1937 36.9109 35.1527 36.9209V40.9209C35.1527 41.2745 35.0122 41.6136 34.7621 41.8637C34.5121 42.1137 34.173 42.2542 33.8193 42.2542ZM17.8193 23.5875C17.4657 23.5875 17.1266 23.728 16.8765 23.978C16.6265 24.2281 16.486 24.5672 16.486 24.9209V38.2542C16.486 38.6078 16.6265 38.9469 16.8765 39.197C17.1266 39.447 17.4657 39.5875 17.8193 39.5875H32.486V35.3475C32.4849 35.1337 32.5351 34.9228 32.6326 34.7325C32.7301 34.5422 32.8718 34.3782 33.046 34.2542C33.2196 34.1304 33.4205 34.05 33.6316 34.0198C33.8427 33.9897 34.058 34.0106 34.2593 34.0809C34.6393 34.2359 35.0532 34.2891 35.46 34.2353C35.8669 34.1816 36.2527 34.0226 36.5793 33.7742C36.9045 33.5759 37.1834 33.3103 37.3973 32.9952C37.6111 32.6801 37.7551 32.3229 37.8193 31.9475C37.8708 31.5689 37.8402 31.1837 37.7298 30.8179C37.6194 30.4522 37.4317 30.1144 37.1793 29.8275C36.8381 29.413 36.3734 29.1183 35.8529 28.9864C35.3325 28.8545 34.7835 28.8923 34.286 29.0942C34.0846 29.1644 33.8694 29.1854 33.6582 29.1552C33.4471 29.125 33.2463 29.0447 33.0727 28.9209C32.8985 28.7969 32.7567 28.6328 32.6593 28.4425C32.5618 28.2522 32.5115 28.0413 32.5127 27.8275V23.5875H28.246C28.0269 23.5999 27.8081 23.5581 27.609 23.4656C27.4099 23.3732 27.2368 23.233 27.1049 23.0576C26.973 22.8822 26.8864 22.6769 26.8529 22.46C26.8194 22.2431 26.8399 22.0213 26.9127 21.8142C27.0677 21.4342 27.1209 21.0204 27.0671 20.6135C27.0134 20.2066 26.8544 19.8208 26.606 19.4942C26.4091 19.1597 26.1395 18.8739 25.8172 18.6578C25.4948 18.4417 25.128 18.3009 24.7438 18.2458C24.3597 18.1908 23.9681 18.2228 23.598 18.3397C23.2279 18.4565 22.8889 18.6552 22.606 18.9209C22.3433 19.1814 22.1377 19.4938 22.0023 19.8381C21.8668 20.1824 21.8045 20.5512 21.8193 20.9209C21.8224 21.2267 21.8812 21.5294 21.9927 21.8142C22.0632 22.0158 22.0842 22.2314 22.054 22.4429C22.0237 22.6543 21.9432 22.8554 21.819 23.0292C21.6949 23.203 21.5308 23.3444 21.3406 23.4416C21.1504 23.5388 20.9396 23.5888 20.726 23.5875H17.8193Z" fill="url(#paint1_linear_2595_7175)"/>
+<defs>
+<linearGradient id="paint0_linear_2595_7175" x1="0.662695" y1="18.4025" x2="51.7209" y2="44.2212" gradientUnits="userSpaceOnUse">
+<stop stop-color="white"/>
+<stop offset="1" stop-color="#71717A"/>
+</linearGradient>
+<linearGradient id="paint1_linear_2595_7175" x1="13.7453" y1="21.3695" x2="40.3876" y2="35.7015" gradientUnits="userSpaceOnUse">
+<stop stop-color="white"/>
+<stop offset="1" stop-color="#71717A"/>
+</linearGradient>
+</defs>
+</svg>
diff --git a/packages/ui-templates/public/icons/twitter-brands 1.svg b/packages/ui-templates/public/icons/twitter-brands 1.svg
new file mode 100644
index 000000000000..f090128a6bd4
--- /dev/null
+++ b/packages/ui-templates/public/icons/twitter-brands 1.svg
@@ -0,0 +1 @@
+<svg width="80" height="80" fill="none" xmlns="http://www.w3.org/2000/svg"><g clip-path="url(#a)"><path d="M87.926 29.04c.063.87.063 1.74.063 2.611 0 26.552-20.21 57.146-57.146 57.146-11.38 0-21.95-3.296-30.843-9.016 1.617.186 3.171.248 4.85.248 9.39 0 18.033-3.171 24.935-8.58-8.83-.188-16.23-5.97-18.779-13.93 1.244.187 2.488.31 3.793.31a21.24 21.24 0 0 0 5.286-.683C10.882 55.28 3.98 47.196 3.98 37.434v-.249a20.227 20.227 0 0 0 9.078 2.55c-5.41-3.607-8.954-9.763-8.954-16.727 0-3.731.995-7.151 2.736-10.136C16.727 25.06 31.589 33.019 48.253 33.89a22.677 22.677 0 0 1-.497-4.602c0-11.068 8.954-20.085 20.085-20.085a20.037 20.037 0 0 1 14.675 6.343c4.54-.87 8.892-2.55 12.748-4.85-1.493 4.663-4.664 8.58-8.83 11.068 4.042-.435 7.96-1.555 11.566-3.109a43.177 43.177 0 0 1-10.074 10.384z" fill="#D1E2E2"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h80v80H0z"/></clipPath></defs></svg>
\ No newline at end of file
diff --git a/packages/ui-templates/styles.ts b/packages/ui-templates/styles.ts
new file mode 100644
index 000000000000..71cffbe488ca
--- /dev/null
+++ b/packages/ui-templates/styles.ts
@@ -0,0 +1,4 @@
+// @ts-expect-error untyped css file
+import '@unocss/reset/tailwind.css'
+// @ts-expect-error untyped css file
+import 'uno.css'
diff --git a/packages/ui-templates/templates/error-404/index.html b/packages/ui-templates/templates/error-404/index.html
new file mode 100644
index 000000000000..531b53ff5b5d
--- /dev/null
+++ b/packages/ui-templates/templates/error-404/index.html
@@ -0,0 +1,25 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+ <title>{{ messages.status }} - {{ messages.statusText }} | {{ messages.appName }}
+
+
+
+
+
+
+
+
{{ messages.status }}
+
{{ messages.statusText }}
+
{{ messages.description }}
+
+
+
+
+
diff --git a/packages/ui-templates/templates/error-404/messages.json b/packages/ui-templates/templates/error-404/messages.json
new file mode 100644
index 000000000000..e2b788f9c5fe
--- /dev/null
+++ b/packages/ui-templates/templates/error-404/messages.json
@@ -0,0 +1,6 @@
+{
+ "status": 404,
+ "statusText": "Page not found",
+ "description": "Sorry, the page you are looking for could not be found.",
+ "backHome": "Go back home"
+}
diff --git a/packages/ui-templates/templates/error-500/index.html b/packages/ui-templates/templates/error-500/index.html
new file mode 100644
index 000000000000..c484ace42371
--- /dev/null
+++ b/packages/ui-templates/templates/error-500/index.html
@@ -0,0 +1,20 @@
+
+
+
+
+
{{ messages.status }} - {{ messages.statusText }} | {{ messages.appName }}
+
+
+
+
+
+
+
+
{{ messages.status }}
+
{{ messages.statusText }}
+
{{ messages.description }}
+
+
+
+
diff --git a/packages/ui-templates/templates/error-500/messages.json b/packages/ui-templates/templates/error-500/messages.json
new file mode 100644
index 000000000000..729337de57b8
--- /dev/null
+++ b/packages/ui-templates/templates/error-500/messages.json
@@ -0,0 +1,6 @@
+{
+ "status": 500,
+ "statusText": "Internal server error",
+ "description": "This page is temporarily unavailable.",
+ "refresh": "Refresh this page"
+}
diff --git a/packages/ui-templates/templates/loading/index.html b/packages/ui-templates/templates/loading/index.html
new file mode 100644
index 000000000000..500c7aafa6c0
--- /dev/null
+++ b/packages/ui-templates/templates/loading/index.html
@@ -0,0 +1,166 @@
+
+
+
+
{{ messages.loading }} | {{ messages.appName }}
+
+
+
+
+
+
+
+
+ {{ version }}
+
+
+
+
+
+
diff --git a/packages/ui-templates/templates/loading/messages.json b/packages/ui-templates/templates/loading/messages.json
new file mode 100644
index 000000000000..382bdcde3a09
--- /dev/null
+++ b/packages/ui-templates/templates/loading/messages.json
@@ -0,0 +1,4 @@
+{
+ "loading": "Loading",
+ "version": "4.0"
+}
diff --git a/packages/ui-templates/templates/messages.json b/packages/ui-templates/templates/messages.json
new file mode 100644
index 000000000000..706304321276
--- /dev/null
+++ b/packages/ui-templates/templates/messages.json
@@ -0,0 +1,3 @@
+{
+ "appName": "Nuxt"
+}
diff --git a/packages/ui-templates/templates/spa-loading-icon/index.html b/packages/ui-templates/templates/spa-loading-icon/index.html
new file mode 100644
index 000000000000..c698cfc761d4
--- /dev/null
+++ b/packages/ui-templates/templates/spa-loading-icon/index.html
@@ -0,0 +1,29 @@
+
+
+
diff --git a/packages/ui-templates/templates/spa-loading-icon/messages.json b/packages/ui-templates/templates/spa-loading-icon/messages.json
new file mode 100644
index 000000000000..0967ef424bce
--- /dev/null
+++ b/packages/ui-templates/templates/spa-loading-icon/messages.json
@@ -0,0 +1 @@
+{}
diff --git a/packages/ui-templates/templates/welcome/index.html b/packages/ui-templates/templates/welcome/index.html
new file mode 100644
index 000000000000..ff78e4d44077
--- /dev/null
+++ b/packages/ui-templates/templates/welcome/index.html
@@ -0,0 +1,120 @@
+
+
+
+
{{ messages.title }}
+
+
+
+
+
+
+
+
+
diff --git a/packages/ui-templates/templates/welcome/messages.json b/packages/ui-templates/templates/welcome/messages.json
new file mode 100644
index 000000000000..cd03b5fed2d1
--- /dev/null
+++ b/packages/ui-templates/templates/welcome/messages.json
@@ -0,0 +1,3 @@
+{
+ "title": "Welcome to Nuxt!"
+}
diff --git a/packages/ui-templates/test/__snapshots__/templates.spec.ts.snap b/packages/ui-templates/test/__snapshots__/templates.spec.ts.snap
new file mode 100644
index 000000000000..d34f086c8f7c
--- /dev/null
+++ b/packages/ui-templates/test/__snapshots__/templates.spec.ts.snap
@@ -0,0 +1,1195 @@
+// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
+
+exports[`template > produces correct output for error-404 template 1`] = `
+".grid {
+ display: grid;
+}
+.mb-2 {
+ margin-bottom: 0.5rem;
+}
+.mb-4 {
+ margin-bottom: 1rem;
+}
+.max-w-520px {
+ max-width: 520px;
+}
+.min-h-screen {
+ min-height: 100vh;
+}
+.w-full {
+ width: 100%;
+}
+.flex {
+ display: flex;
+}
+.place-content-center {
+ place-content: center;
+}
+.items-center {
+ align-items: center;
+}
+.justify-center {
+ justify-content: center;
+}
+.overflow-hidden {
+ overflow: hidden;
+}
+.bg-white {
+ --un-bg-opacity: 1;
+ background-color: rgb(255 255 255 / var(--un-bg-opacity));
+}
+.px-2 {
+ padding-left: 0.5rem;
+ padding-right: 0.5rem;
+}
+.text-center {
+ text-align: center;
+}
+.text-\\[80px\\] {
+ font-size: 80px;
+}
+.text-2xl {
+ font-size: 1.5rem;
+ line-height: 2rem;
+}
+.text-sm {
+ font-size: 0.875rem;
+ line-height: 1.25rem;
+}
+.text-\\[\\#020420\\] {
+ --un-text-opacity: 1;
+ color: rgb(2 4 32 / var(--un-text-opacity));
+}
+.text-\\[\\#64748B\\] {
+ --un-text-opacity: 1;
+ color: rgb(100 116 139 / var(--un-text-opacity));
+}
+.hover\\:text-\\[\\#00DC82\\]:hover {
+ --un-text-opacity: 1;
+ color: rgb(0 220 130 / var(--un-text-opacity));
+}
+.font-medium {
+ font-weight: 500;
+}
+.font-semibold {
+ font-weight: 600;
+}
+.leading-none {
+ line-height: 1;
+}
+.tracking-wide {
+ letter-spacing: 0.025em;
+}
+.font-sans {
+ font-family:
+ ui-sans-serif,
+ system-ui,
+ -apple-system,
+ BlinkMacSystemFont,
+ Segoe UI,
+ Roboto,
+ Helvetica Neue,
+ Arial,
+ Noto Sans,
+ sans-serif,
+ Apple Color Emoji,
+ Segoe UI Emoji,
+ Segoe UI Symbol,
+ Noto Color Emoji;
+}
+.tabular-nums {
+ --un-numeric-spacing: tabular-nums;
+ font-variant-numeric: var(--un-ordinal) var(--un-slashed-zero)
+ var(--un-numeric-figure) var(--un-numeric-spacing)
+ var(--un-numeric-fraction);
+}
+.underline {
+ text-decoration-line: underline;
+}
+.underline-offset-3 {
+ text-underline-offset: 3px;
+}
+.antialiased {
+ -webkit-font-smoothing: antialiased;
+ -moz-osx-font-smoothing: grayscale;
+}
+@media (prefers-color-scheme: dark) {
+ .dark\\:bg-\\[\\#020420\\] {
+ --un-bg-opacity: 1;
+ background-color: rgb(2 4 32 / var(--un-bg-opacity));
+ }
+ .dark\\:text-white {
+ --un-text-opacity: 1;
+ color: rgb(255 255 255 / var(--un-text-opacity));
+ }
+}
+@media (width>=640px) {
+ .sm\\:text-\\[110px\\] {
+ font-size: 110px;
+ }
+ .sm\\:text-3xl {
+ font-size: 1.875rem;
+ line-height: 2.25rem;
+ }
+}
+"
+`;
+
+exports[`template > produces correct output for error-404 template 2`] = `
+"*,
+:after,
+:before {
+ box-sizing: border-box;
+ border-style: solid;
+ border-width: 0;
+ border-color: var(--un-default-border-color, #e5e7eb);
+}
+:after,
+:before {
+ --un-content: "";
+}
+html {
+ -webkit-text-size-adjust: 100%;
+ tab-size: 4;
+ font-feature-settings: normal;
+ font-variation-settings: normal;
+ -webkit-tap-highlight-color: transparent;
+ font-family:
+ ui-sans-serif,
+ system-ui,
+ sans-serif,
+ Apple Color Emoji,
+ Segoe UI Emoji,
+ Segoe UI Symbol,
+ Noto Color Emoji;
+ line-height: 1.5;
+}
+body {
+ line-height: inherit;
+ margin: 0;
+}
+h1,
+h2 {
+ font-size: inherit;
+ font-weight: inherit;
+}
+a {
+ color: inherit;
+ -webkit-text-decoration: inherit;
+ text-decoration: inherit;
+}
+h1,
+h2,
+p {
+ margin: 0;
+}
+*,
+:after,
+:before {
+ --un-rotate: 0;
+ --un-rotate-x: 0;
+ --un-rotate-y: 0;
+ --un-rotate-z: 0;
+ --un-scale-x: 1;
+ --un-scale-y: 1;
+ --un-scale-z: 1;
+ --un-skew-x: 0;
+ --un-skew-y: 0;
+ --un-translate-x: 0;
+ --un-translate-y: 0;
+ --un-translate-z: 0;
+ --un-pan-x: ;
+ --un-pan-y: ;
+ --un-pinch-zoom: ;
+ --un-scroll-snap-strictness: proximity;
+ --un-ordinal: ;
+ --un-slashed-zero: ;
+ --un-numeric-figure: ;
+ --un-numeric-spacing: ;
+ --un-numeric-fraction: ;
+ --un-border-spacing-x: 0;
+ --un-border-spacing-y: 0;
+ --un-ring-offset-shadow: 0 0 #0000;
+ --un-ring-shadow: 0 0 #0000;
+ --un-shadow-inset: ;
+ --un-shadow: 0 0 #0000;
+ --un-ring-inset: ;
+ --un-ring-offset-width: 0px;
+ --un-ring-offset-color: #fff;
+ --un-ring-width: 0px;
+ --un-ring-color: #93c5fd80;
+ --un-blur: ;
+ --un-brightness: ;
+ --un-contrast: ;
+ --un-drop-shadow: ;
+ --un-grayscale: ;
+ --un-hue-rotate: ;
+ --un-invert: ;
+ --un-saturate: ;
+ --un-sepia: ;
+ --un-backdrop-blur: ;
+ --un-backdrop-brightness: ;
+ --un-backdrop-contrast: ;
+ --un-backdrop-grayscale: ;
+ --un-backdrop-hue-rotate: ;
+ --un-backdrop-invert: ;
+ --un-backdrop-opacity: ;
+ --un-backdrop-saturate: ;
+ --un-backdrop-sepia: ;
+}
+"
+`;
+
+exports[`template > produces correct output for error-500 template 1`] = `
+".grid {
+ display: grid;
+}
+.mb-2 {
+ margin-bottom: 0.5rem;
+}
+.mb-4 {
+ margin-bottom: 1rem;
+}
+.max-w-520px {
+ max-width: 520px;
+}
+.min-h-screen {
+ min-height: 100vh;
+}
+.place-content-center {
+ place-content: center;
+}
+.overflow-hidden {
+ overflow: hidden;
+}
+.bg-white {
+ --un-bg-opacity: 1;
+ background-color: rgb(255 255 255 / var(--un-bg-opacity));
+}
+.px-2 {
+ padding-left: 0.5rem;
+ padding-right: 0.5rem;
+}
+.text-center {
+ text-align: center;
+}
+.text-\\[80px\\] {
+ font-size: 80px;
+}
+.text-2xl {
+ font-size: 1.5rem;
+ line-height: 2rem;
+}
+.text-\\[\\#020420\\] {
+ --un-text-opacity: 1;
+ color: rgb(2 4 32 / var(--un-text-opacity));
+}
+.text-\\[\\#64748B\\] {
+ --un-text-opacity: 1;
+ color: rgb(100 116 139 / var(--un-text-opacity));
+}
+.font-semibold {
+ font-weight: 600;
+}
+.leading-none {
+ line-height: 1;
+}
+.tracking-wide {
+ letter-spacing: 0.025em;
+}
+.font-sans {
+ font-family:
+ ui-sans-serif,
+ system-ui,
+ -apple-system,
+ BlinkMacSystemFont,
+ Segoe UI,
+ Roboto,
+ Helvetica Neue,
+ Arial,
+ Noto Sans,
+ sans-serif,
+ Apple Color Emoji,
+ Segoe UI Emoji,
+ Segoe UI Symbol,
+ Noto Color Emoji;
+}
+.tabular-nums {
+ --un-numeric-spacing: tabular-nums;
+ font-variant-numeric: var(--un-ordinal) var(--un-slashed-zero)
+ var(--un-numeric-figure) var(--un-numeric-spacing)
+ var(--un-numeric-fraction);
+}
+.antialiased {
+ -webkit-font-smoothing: antialiased;
+ -moz-osx-font-smoothing: grayscale;
+}
+@media (prefers-color-scheme: dark) {
+ .dark\\:bg-\\[\\#020420\\] {
+ --un-bg-opacity: 1;
+ background-color: rgb(2 4 32 / var(--un-bg-opacity));
+ }
+ .dark\\:text-white {
+ --un-text-opacity: 1;
+ color: rgb(255 255 255 / var(--un-text-opacity));
+ }
+}
+@media (width>=640px) {
+ .sm\\:text-\\[110px\\] {
+ font-size: 110px;
+ }
+ .sm\\:text-3xl {
+ font-size: 1.875rem;
+ line-height: 2.25rem;
+ }
+}
+"
+`;
+
+exports[`template > produces correct output for error-500 template 2`] = `
+"*,
+:after,
+:before {
+ box-sizing: border-box;
+ border-style: solid;
+ border-width: 0;
+ border-color: var(--un-default-border-color, #e5e7eb);
+}
+:after,
+:before {
+ --un-content: "";
+}
+html {
+ -webkit-text-size-adjust: 100%;
+ tab-size: 4;
+ font-feature-settings: normal;
+ font-variation-settings: normal;
+ -webkit-tap-highlight-color: transparent;
+ font-family:
+ ui-sans-serif,
+ system-ui,
+ sans-serif,
+ Apple Color Emoji,
+ Segoe UI Emoji,
+ Segoe UI Symbol,
+ Noto Color Emoji;
+ line-height: 1.5;
+}
+body {
+ line-height: inherit;
+ margin: 0;
+}
+h1,
+h2 {
+ font-size: inherit;
+ font-weight: inherit;
+}
+h1,
+h2,
+p {
+ margin: 0;
+}
+*,
+:after,
+:before {
+ --un-rotate: 0;
+ --un-rotate-x: 0;
+ --un-rotate-y: 0;
+ --un-rotate-z: 0;
+ --un-scale-x: 1;
+ --un-scale-y: 1;
+ --un-scale-z: 1;
+ --un-skew-x: 0;
+ --un-skew-y: 0;
+ --un-translate-x: 0;
+ --un-translate-y: 0;
+ --un-translate-z: 0;
+ --un-pan-x: ;
+ --un-pan-y: ;
+ --un-pinch-zoom: ;
+ --un-scroll-snap-strictness: proximity;
+ --un-ordinal: ;
+ --un-slashed-zero: ;
+ --un-numeric-figure: ;
+ --un-numeric-spacing: ;
+ --un-numeric-fraction: ;
+ --un-border-spacing-x: 0;
+ --un-border-spacing-y: 0;
+ --un-ring-offset-shadow: 0 0 #0000;
+ --un-ring-shadow: 0 0 #0000;
+ --un-shadow-inset: ;
+ --un-shadow: 0 0 #0000;
+ --un-ring-inset: ;
+ --un-ring-offset-width: 0px;
+ --un-ring-offset-color: #fff;
+ --un-ring-width: 0px;
+ --un-ring-color: #93c5fd80;
+ --un-blur: ;
+ --un-brightness: ;
+ --un-contrast: ;
+ --un-drop-shadow: ;
+ --un-grayscale: ;
+ --un-hue-rotate: ;
+ --un-invert: ;
+ --un-saturate: ;
+ --un-sepia: ;
+ --un-backdrop-blur: ;
+ --un-backdrop-brightness: ;
+ --un-backdrop-contrast: ;
+ --un-backdrop-grayscale: ;
+ --un-backdrop-hue-rotate: ;
+ --un-backdrop-invert: ;
+ --un-backdrop-opacity: ;
+ --un-backdrop-saturate: ;
+ --un-backdrop-sepia: ;
+}
+"
+`;
+
+exports[`template > produces correct output for loading template 1`] = `
+".nuxt-loader-bar {
+ background: #00dc82;
+ position: fixed;
+ bottom: 0;
+ left: 0;
+ right: 0;
+ height: 3px;
+}
+.triangle-loading {
+ position: absolute;
+}
+.triangle-loading > path {
+ fill: none;
+ stroke-width: 4px;
+ stroke-linecap: round;
+ stroke-linejoin: round;
+ stroke-dasharray: 128;
+ stroke-dashoffset: 128;
+ animation: nuxt-loading-move 3s linear infinite;
+}
+.nuxt-logo:hover .triangle-loading > path {
+ animation-play-state: paused;
+}
+.relative {
+ position: relative;
+}
+.inline-block {
+ display: inline-block;
+}
+.min-h-screen {
+ min-height: 100vh;
+}
+.flex {
+ display: flex;
+}
+.flex-col {
+ flex-direction: column;
+}
+.items-end {
+ align-items: flex-end;
+}
+.items-center {
+ align-items: center;
+}
+.justify-center {
+ justify-content: center;
+}
+.gap-4 {
+ gap: 1rem;
+}
+.overflow-hidden {
+ overflow: hidden;
+}
+.border {
+ border-width: 1px;
+}
+.border-\\[\\#00DC42\\]\\/50 {
+ border-color: #00dc4280;
+}
+.group:hover .group-hover\\:border-\\[\\#00DC42\\] {
+ --un-border-opacity: 1;
+ border-color: rgb(0 220 66 / var(--un-border-opacity));
+}
+.rounded {
+ border-radius: 0.25rem;
+}
+.bg-\\[\\#00DC42\\]\\/10 {
+ background-color: #00dc421a;
+}
+.bg-white {
+ --un-bg-opacity: 1;
+ background-color: rgb(255 255 255 / var(--un-bg-opacity));
+}
+.group:hover .group-hover\\:bg-\\[\\#00DC42\\]\\/15 {
+ background-color: #00dc4226;
+}
+.px-2\\.5 {
+ padding-left: 0.625rem;
+ padding-right: 0.625rem;
+}
+.py-1\\.5 {
+ padding-top: 0.375rem;
+ padding-bottom: 0.375rem;
+}
+.text-center {
+ text-align: center;
+}
+.text-\\[16px\\] {
+ font-size: 16px;
+}
+.group:hover .group-hover\\:text-\\[\\#00DC82\\],
+.text-\\[\\#00DC82\\] {
+ --un-text-opacity: 1;
+ color: rgb(0 220 130 / var(--un-text-opacity));
+}
+.text-\\[\\#00DC82\\]\\/80 {
+ color: #00dc82cc;
+}
+.group:hover .group-hover\\:text-\\[\\#020420\\],
+.text-\\[\\#020420\\] {
+ --un-text-opacity: 1;
+ color: rgb(2 4 32 / var(--un-text-opacity));
+}
+.text-\\[\\#020420\\]\\/80 {
+ color: #020420cc;
+}
+.font-semibold {
+ font-weight: 600;
+}
+.leading-none {
+ line-height: 1;
+}
+.font-mono {
+ font-family:
+ ui-monospace,
+ SFMono-Regular,
+ Menlo,
+ Monaco,
+ Consolas,
+ Liberation Mono,
+ Courier New,
+ monospace;
+}
+.font-sans {
+ font-family:
+ ui-sans-serif,
+ system-ui,
+ -apple-system,
+ BlinkMacSystemFont,
+ Segoe UI,
+ Roboto,
+ Helvetica Neue,
+ Arial,
+ Noto Sans,
+ sans-serif,
+ Apple Color Emoji,
+ Segoe UI Emoji,
+ Segoe UI Symbol,
+ Noto Color Emoji;
+}
+.antialiased {
+ -webkit-font-smoothing: antialiased;
+ -moz-osx-font-smoothing: grayscale;
+}
+@media (prefers-color-scheme: dark) {
+ .dark\\:bg-\\[\\#020420\\] {
+ --un-bg-opacity: 1;
+ background-color: rgb(2 4 32 / var(--un-bg-opacity));
+ }
+ .dark\\:text-gray-200 {
+ --un-text-opacity: 1;
+ color: rgb(224 224 224 / var(--un-text-opacity));
+ }
+ .dark\\:text-white,
+ .group:hover .dark\\:group-hover\\:text-white {
+ --un-text-opacity: 1;
+ color: rgb(255 255 255 / var(--un-text-opacity));
+ }
+}
+"
+`;
+
+exports[`template > produces correct output for loading template 2`] = `
+"@keyframes nuxt-loading-move {
+ to {
+ stroke-dashoffset: -128;
+ }
+}
+@media (prefers-color-scheme: dark) {
+ body,
+ html {
+ color: #fff;
+ color-scheme: dark;
+ }
+}
+*,
+:after,
+:before {
+ box-sizing: border-box;
+ border-style: solid;
+ border-width: 0;
+ border-color: var(--un-default-border-color, #e5e7eb);
+}
+:after,
+:before {
+ --un-content: "";
+}
+html {
+ -webkit-text-size-adjust: 100%;
+ tab-size: 4;
+ font-feature-settings: normal;
+ font-variation-settings: normal;
+ -webkit-tap-highlight-color: transparent;
+ font-family:
+ ui-sans-serif,
+ system-ui,
+ sans-serif,
+ Apple Color Emoji,
+ Segoe UI Emoji,
+ Segoe UI Symbol,
+ Noto Color Emoji;
+ line-height: 1.5;
+}
+body {
+ line-height: inherit;
+ margin: 0;
+}
+a {
+ color: inherit;
+ -webkit-text-decoration: inherit;
+ text-decoration: inherit;
+}
+svg {
+ vertical-align: middle;
+ display: block;
+}
+*,
+:after,
+:before {
+ --un-rotate: 0;
+ --un-rotate-x: 0;
+ --un-rotate-y: 0;
+ --un-rotate-z: 0;
+ --un-scale-x: 1;
+ --un-scale-y: 1;
+ --un-scale-z: 1;
+ --un-skew-x: 0;
+ --un-skew-y: 0;
+ --un-translate-x: 0;
+ --un-translate-y: 0;
+ --un-translate-z: 0;
+ --un-pan-x: ;
+ --un-pan-y: ;
+ --un-pinch-zoom: ;
+ --un-scroll-snap-strictness: proximity;
+ --un-ordinal: ;
+ --un-slashed-zero: ;
+ --un-numeric-figure: ;
+ --un-numeric-spacing: ;
+ --un-numeric-fraction: ;
+ --un-border-spacing-x: 0;
+ --un-border-spacing-y: 0;
+ --un-ring-offset-shadow: 0 0 #0000;
+ --un-ring-shadow: 0 0 #0000;
+ --un-shadow-inset: ;
+ --un-shadow: 0 0 #0000;
+ --un-ring-inset: ;
+ --un-ring-offset-width: 0px;
+ --un-ring-offset-color: #fff;
+ --un-ring-width: 0px;
+ --un-ring-color: #93c5fd80;
+ --un-blur: ;
+ --un-brightness: ;
+ --un-contrast: ;
+ --un-drop-shadow: ;
+ --un-grayscale: ;
+ --un-hue-rotate: ;
+ --un-invert: ;
+ --un-saturate: ;
+ --un-sepia: ;
+ --un-backdrop-blur: ;
+ --un-backdrop-brightness: ;
+ --un-backdrop-contrast: ;
+ --un-backdrop-grayscale: ;
+ --un-backdrop-hue-rotate: ;
+ --un-backdrop-invert: ;
+ --un-backdrop-opacity: ;
+ --un-backdrop-saturate: ;
+ --un-backdrop-sepia: ;
+}
+"
+`;
+
+exports[`template > produces correct output for welcome template 1`] = `
+".sr-only {
+ clip: rect(0, 0, 0, 0);
+ white-space: nowrap;
+ border-width: 0;
+ width: 1px;
+ height: 1px;
+ margin: -1px;
+ padding: 0;
+ overflow: hidden;
+}
+.absolute,
+.sr-only {
+ position: absolute;
+}
+.relative {
+ position: relative;
+}
+.right-4 {
+ right: 1rem;
+}
+.top-4 {
+ top: 1rem;
+}
+.grid {
+ display: grid;
+}
+.grid-cols-1 {
+ grid-template-columns: repeat(1, minmax(0, 1fr));
+}
+.mx-auto {
+ margin-left: auto;
+ margin-right: auto;
+}
+.mb-6 {
+ margin-bottom: 1.5rem;
+}
+.mt-1 {
+ margin-top: 0.25rem;
+}
+.mt-4 {
+ margin-top: 1rem;
+}
+.mt-6 {
+ margin-top: 1.5rem;
+}
+.inline-block {
+ display: inline-block;
+}
+.size-\\[18px\\] {
+ width: 18px;
+ height: 18px;
+}
+.size-4 {
+ width: 1rem;
+ height: 1rem;
+}
+.group:hover .group-hover\\:size-5,
+.size-5 {
+ width: 1.25rem;
+ height: 1.25rem;
+}
+.h-\\[32px\\] {
+ height: 32px;
+}
+.h-8 {
+ height: 2rem;
+}
+.max-w-\\[980px\\] {
+ max-width: 980px;
+}
+.min-h-screen {
+ min-height: 100vh;
+}
+.w-\\[32px\\] {
+ width: 32px;
+}
+.w-full {
+ width: 100%;
+}
+.flex {
+ display: flex;
+}
+.inline-flex {
+ display: inline-flex;
+}
+.flex-col {
+ flex-direction: column;
+}
+.place-content-center {
+ place-content: center;
+}
+.items-end {
+ align-items: flex-end;
+}
+.items-center {
+ align-items: center;
+}
+.justify-center {
+ justify-content: center;
+}
+.gap-1 {
+ gap: 0.25rem;
+}
+.gap-4 {
+ gap: 1rem;
+}
+.gap-y-4 {
+ row-gap: 1rem;
+}
+.border {
+ border-width: 1px;
+}
+.border-\\[\\#00DC42\\]\\/50 {
+ border-color: #00dc4280;
+}
+.border-\\[\\#00DC82\\] {
+ --un-border-opacity: 1;
+ border-color: rgb(0 220 130 / var(--un-border-opacity));
+}
+.border-gray-200 {
+ --un-border-opacity: 1;
+ border-color: rgb(224 224 224 / var(--un-border-opacity));
+}
+.border-green-600\\/10 {
+ border-color: #00bb6a1a;
+}
+.border-green-600\\/20 {
+ border-color: #00bb6a33;
+}
+.hover\\:border-\\[\\#00DC82\\]:hover {
+ --un-border-opacity: 1;
+ border-color: rgb(0 220 130 / var(--un-border-opacity));
+}
+.rounded {
+ border-radius: 0.25rem;
+}
+.rounded-lg {
+ border-radius: 0.5rem;
+}
+.bg-\\[\\#00DC42\\]\\/10 {
+ background-color: #00dc421a;
+}
+.bg-\\[\\#00DC82\\]\\/5 {
+ background-color: #00dc820d;
+}
+.bg-gray-50\\/10 {
+ background-color: #f5f5f51a;
+}
+.bg-green-50 {
+ --un-bg-opacity: 1;
+ background-color: rgb(208 252 222 / var(--un-bg-opacity));
+}
+.bg-white {
+ --un-bg-opacity: 1;
+ background-color: rgb(255 255 255 / var(--un-bg-opacity));
+}
+.p-1 {
+ padding: 0.25rem;
+}
+.p-6 {
+ padding: 1.5rem;
+}
+.px-2 {
+ padding-left: 0.5rem;
+ padding-right: 0.5rem;
+}
+.px-4 {
+ padding-left: 1rem;
+ padding-right: 1rem;
+}
+.py-1 {
+ padding-top: 0.25rem;
+ padding-bottom: 0.25rem;
+}
+.text-\\[12px\\] {
+ font-size: 12px;
+}
+.text-base {
+ font-size: 1rem;
+ line-height: 1.5rem;
+}
+.text-sm {
+ font-size: 0.875rem;
+ line-height: 1.25rem;
+}
+.group:hover .group-hover\\:text-\\[\\#00DC82\\],
+.text-\\[\\#00DC82\\] {
+ --un-text-opacity: 1;
+ color: rgb(0 220 130 / var(--un-text-opacity));
+}
+.text-\\[\\#020420\\] {
+ --un-text-opacity: 1;
+ color: rgb(2 4 32 / var(--un-text-opacity));
+}
+.text-\\[\\#020420\\]\\/20 {
+ color: #02042033;
+}
+.text-gray-500 {
+ --un-text-opacity: 1;
+ color: rgb(117 117 117 / var(--un-text-opacity));
+}
+.text-gray-700 {
+ --un-text-opacity: 1;
+ color: rgb(66 66 66 / var(--un-text-opacity));
+}
+.text-green-700 {
+ --un-text-opacity: 1;
+ color: rgb(0 153 86 / var(--un-text-opacity));
+}
+.hover\\:text-\\[\\#020420\\]:hover {
+ --un-text-opacity: 1;
+ color: rgb(2 4 32 / var(--un-text-opacity));
+}
+.font-bold {
+ font-weight: 700;
+}
+.font-semibold {
+ font-weight: 600;
+}
+.leading-none {
+ line-height: 1;
+}
+.font-mono {
+ font-family:
+ ui-monospace,
+ SFMono-Regular,
+ Menlo,
+ Monaco,
+ Consolas,
+ Liberation Mono,
+ Courier New,
+ monospace;
+}
+.antialiased {
+ -webkit-font-smoothing: antialiased;
+ -moz-osx-font-smoothing: grayscale;
+}
+.focus-visible\\:ring-2:focus-visible {
+ --un-ring-width: 2px;
+ --un-ring-offset-shadow: var(--un-ring-inset) 0 0 0
+ var(--un-ring-offset-width) var(--un-ring-offset-color);
+ --un-ring-shadow: var(--un-ring-inset) 0 0 0
+ calc(var(--un-ring-width) + var(--un-ring-offset-width))
+ var(--un-ring-color);
+ box-shadow:
+ var(--un-ring-offset-shadow), var(--un-ring-shadow), var(--un-shadow);
+}
+.transition-all {
+ transition-property: all;
+ transition-duration: 0.15s;
+ transition-timing-function: cubic-bezier(0.4, 0, 0.2, 1);
+}
+@media (prefers-color-scheme: dark) {
+ .dark\\:border-\\[\\#00DC82\\]\\/50 {
+ border-color: #00dc8280;
+ }
+ .dark\\:border-\\[\\#00DC82\\]\\/80,
+ .group:hover .group-hover\\:dark\\:border-\\[\\#00DC82\\]\\/80 {
+ border-color: #00dc82cc;
+ }
+ .dark\\:border-white\\/10 {
+ border-color: #ffffff1a;
+ }
+ .dark\\:border-white\\/20 {
+ border-color: #fff3;
+ }
+ .hover\\:dark\\:border-\\[\\#00DC82\\]:hover {
+ --un-border-opacity: 1;
+ border-color: rgb(0 220 130 / var(--un-border-opacity));
+ }
+ .dark\\:bg-\\[\\#020420\\] {
+ --un-bg-opacity: 1;
+ background-color: rgb(2 4 32 / var(--un-bg-opacity));
+ }
+ .dark\\:bg-white\\/5 {
+ background-color: #ffffff0d;
+ }
+ .dark\\:text-\\[\\#00DC82\\] {
+ --un-text-opacity: 1;
+ color: rgb(0 220 130 / var(--un-text-opacity));
+ }
+ .dark\\:text-gray-200 {
+ --un-text-opacity: 1;
+ color: rgb(224 224 224 / var(--un-text-opacity));
+ }
+ .dark\\:text-gray-400 {
+ --un-text-opacity: 1;
+ color: rgb(158 158 158 / var(--un-text-opacity));
+ }
+ .dark\\:text-white {
+ --un-text-opacity: 1;
+ color: rgb(255 255 255 / var(--un-text-opacity));
+ }
+ .dark\\:text-white\\/40 {
+ color: #fff6;
+ }
+ .dark\\:hover\\:text-white:hover {
+ --un-text-opacity: 1;
+ color: rgb(255 255 255 / var(--un-text-opacity));
+ }
+ .group:hover .group-hover\\:dark\\:text-gray-100 {
+ --un-text-opacity: 1;
+ color: rgb(238 238 238 / var(--un-text-opacity));
+ }
+}
+@media (width>=640px) {
+ .sm\\:col-span-2 {
+ grid-column: span 2 / span 2;
+ }
+ .sm\\:grid-cols-3 {
+ grid-template-columns: repeat(3, minmax(0, 1fr));
+ }
+ .sm\\:mb-0 {
+ margin-bottom: 0;
+ }
+ .sm\\:mt-0 {
+ margin-top: 0;
+ }
+ .sm\\:mt-10 {
+ margin-top: 2.5rem;
+ }
+ .sm\\:mt-6 {
+ margin-top: 1.5rem;
+ }
+ .sm\\:h-12 {
+ height: 3rem;
+ }
+ .sm\\:gap-6 {
+ gap: 1.5rem;
+ }
+ .sm\\:px-2\\.5 {
+ padding-left: 0.625rem;
+ padding-right: 0.625rem;
+ }
+ .sm\\:px-6 {
+ padding-left: 1.5rem;
+ padding-right: 1.5rem;
+ }
+ .sm\\:py-1\\.5 {
+ padding-top: 0.375rem;
+ padding-bottom: 0.375rem;
+ }
+ .sm\\:text-\\[14px\\] {
+ font-size: 14px;
+ }
+ .sm\\:text-base {
+ font-size: 1rem;
+ line-height: 1.5rem;
+ }
+}
+@media (width>=1024px) {
+ .lg\\:px-8 {
+ padding-left: 2rem;
+ padding-right: 2rem;
+ }
+}
+"
+`;
+
+exports[`template > produces correct output for welcome template 2`] = `
+"*,
+:after,
+:before {
+ box-sizing: border-box;
+ border-style: solid;
+ border-width: 0;
+ border-color: var(--un-default-border-color, #e5e7eb);
+}
+:after,
+:before {
+ --un-content: "";
+}
+html {
+ -webkit-text-size-adjust: 100%;
+ tab-size: 4;
+ font-feature-settings: normal;
+ font-variation-settings: normal;
+ -webkit-tap-highlight-color: transparent;
+ font-family:
+ ui-sans-serif,
+ system-ui,
+ sans-serif,
+ Apple Color Emoji,
+ Segoe UI Emoji,
+ Segoe UI Symbol,
+ Noto Color Emoji;
+ line-height: 1.5;
+}
+body {
+ line-height: inherit;
+ margin: 0;
+}
+h1,
+h2 {
+ font-size: inherit;
+ font-weight: inherit;
+}
+a {
+ color: inherit;
+ -webkit-text-decoration: inherit;
+ text-decoration: inherit;
+}
+h1,
+h2,
+p,
+ul {
+ margin: 0;
+}
+ul {
+ padding: 0;
+ list-style: none;
+}
+svg {
+ vertical-align: middle;
+ display: block;
+}
+*,
+:after,
+:before {
+ --un-rotate: 0;
+ --un-rotate-x: 0;
+ --un-rotate-y: 0;
+ --un-rotate-z: 0;
+ --un-scale-x: 1;
+ --un-scale-y: 1;
+ --un-scale-z: 1;
+ --un-skew-x: 0;
+ --un-skew-y: 0;
+ --un-translate-x: 0;
+ --un-translate-y: 0;
+ --un-translate-z: 0;
+ --un-pan-x: ;
+ --un-pan-y: ;
+ --un-pinch-zoom: ;
+ --un-scroll-snap-strictness: proximity;
+ --un-ordinal: ;
+ --un-slashed-zero: ;
+ --un-numeric-figure: ;
+ --un-numeric-spacing: ;
+ --un-numeric-fraction: ;
+ --un-border-spacing-x: 0;
+ --un-border-spacing-y: 0;
+ --un-ring-offset-shadow: 0 0 #0000;
+ --un-ring-shadow: 0 0 #0000;
+ --un-shadow-inset: ;
+ --un-shadow: 0 0 #0000;
+ --un-ring-inset: ;
+ --un-ring-offset-width: 0px;
+ --un-ring-offset-color: #fff;
+ --un-ring-width: 0px;
+ --un-ring-color: #93c5fd80;
+ --un-blur: ;
+ --un-brightness: ;
+ --un-contrast: ;
+ --un-drop-shadow: ;
+ --un-grayscale: ;
+ --un-hue-rotate: ;
+ --un-invert: ;
+ --un-saturate: ;
+ --un-sepia: ;
+ --un-backdrop-blur: ;
+ --un-backdrop-brightness: ;
+ --un-backdrop-contrast: ;
+ --un-backdrop-grayscale: ;
+ --un-backdrop-hue-rotate: ;
+ --un-backdrop-invert: ;
+ --un-backdrop-opacity: ;
+ --un-backdrop-saturate: ;
+ --un-backdrop-sepia: ;
+}
+"
+`;
diff --git a/packages/ui-templates/test/templates.spec.ts b/packages/ui-templates/test/templates.spec.ts
new file mode 100644
index 000000000000..36797231e556
--- /dev/null
+++ b/packages/ui-templates/test/templates.spec.ts
@@ -0,0 +1,67 @@
+import { fileURLToPath } from 'node:url'
+import { readFileSync } from 'node:fs'
+import { rm } from 'node:fs/promises'
+import { afterAll, beforeAll, describe, expect, it } from 'vitest'
+import { exec } from 'tinyexec'
+import { format } from 'prettier'
+import { HtmlValidate } from 'html-validate'
+
+const distDir = fileURLToPath(new URL('../node_modules/.temp/dist/templates', import.meta.url))
+
+describe('template', () => {
+ beforeAll(async () => {
+ await exec('pnpm', ['build'], {
+ nodeOptions: {
+ cwd: fileURLToPath(new URL('..', import.meta.url)),
+ env: {
+ OUTPUT_DIR: './node_modules/.temp/dist',
+ },
+ },
+ })
+ })
+ afterAll(() => rm(distDir, { force: true, recursive: true }))
+
+ function formatCss (css: string) {
+ return format(css, {
+ parser: 'css',
+ })
+ }
+
+ const validator = new HtmlValidate({
+ extends: [
+ 'html-validate:document',
+ 'html-validate:recommended',
+ 'html-validate:standard',
+ ],
+ rules: {
+ //
+ 'svg-focusable': 'off',
+ 'no-unknown-elements': 'error',
+ // Conflicts or not needed as we use prettier formatting
+ 'void-style': 'off',
+ 'no-trailing-whitespace': 'off',
+ // Conflict with Nuxt defaults
+ 'require-sri': 'off',
+ 'attribute-boolean-style': 'off',
+ 'doctype-style': 'off',
+ // Unreasonable rule
+ 'no-inline-style': 'off',
+ },
+ })
+
+ it.each(['error-404', 'error-500', 'loading', 'welcome'])('produces correct output for %s template', async (file) => {
+ const contents = readFileSync(`${distDir}/${file}.vue`, 'utf-8')
+
+ const scopedStyle = contents.match(/
diff --git a/packages/vue-app/template/components/nuxt-child.js b/packages/vue-app/template/components/nuxt-child.js
deleted file mode 100644
index 0b36b3491fbb..000000000000
--- a/packages/vue-app/template/components/nuxt-child.js
+++ /dev/null
@@ -1,128 +0,0 @@
-<%= isTest ? '// @vue/component' : '' %>
-export default {
- name: 'NuxtChild',
- functional: true,
- props: {
- nuxtChildKey: {
- type: String,
- default: ''
- },
- keepAlive: Boolean,
- keepAliveProps: {
- type: Object,
- default: undefined
- }
- },
- render (_, { parent, data, props }) {
- const h = parent.$createElement
- <% if (features.transitions) { %>
- data.nuxtChild = true
- const _parent = parent
- const transitions = parent.<%= globals.nuxt %>.nuxt.transitions
- const defaultTransition = parent.<%= globals.nuxt %>.nuxt.defaultTransition
-
- let depth = 0
- while (parent) {
- if (parent.$vnode && parent.$vnode.data.nuxtChild) {
- depth++
- }
- parent = parent.$parent
- }
- data.nuxtChildDepth = depth
- const transition = transitions[depth] || defaultTransition
- const transitionProps = {}
- transitionsKeys.forEach((key) => {
- if (typeof transition[key] !== 'undefined') {
- transitionProps[key] = transition[key]
- }
- })
-
- const listeners = {}
- listenersKeys.forEach((key) => {
- if (typeof transition[key] === 'function') {
- listeners[key] = transition[key].bind(_parent)
- }
- })
- if (process.client) {
- // Add triggerScroll event on beforeEnter (fix #1376)
- const beforeEnter = listeners.beforeEnter
- listeners.beforeEnter = (el) => {
- // Ensure to trigger scroll event after calling scrollBehavior
- window.<%= globals.nuxt %>.$nextTick(() => {
- window.<%= globals.nuxt %>.$emit('triggerScroll')
- })
- if (beforeEnter) {
- return beforeEnter.call(_parent, el)
- }
- }
- }
-
- // make sure that leave is called asynchronous (fix #5703)
- if (transition.css === false) {
- const leave = listeners.leave
-
- // only add leave listener when user didnt provide one
- // or when it misses the done argument
- if (!leave || leave.length < 2) {
- listeners.leave = (el, done) => {
- if (leave) {
- leave.call(_parent, el)
- }
-
- _parent.$nextTick(done)
- }
- }
- }
- <% } %>
- let routerView = h('routerView', data)
-
- if (props.keepAlive) {
- routerView = h('keep-alive', { props: props.keepAliveProps }, [routerView])
- }
-
- <% if (features.transitions) { %>
- return h('transition', {
- props: transitionProps,
- on: listeners
- }, [routerView])
- <% } else { %>
- return routerView
- <% } %>
- }
-}
-
-<% if (features.transitions) { %>
-const transitionsKeys = [
- 'name',
- 'mode',
- 'appear',
- 'css',
- 'type',
- 'duration',
- 'enterClass',
- 'leaveClass',
- 'appearClass',
- 'enterActiveClass',
- 'enterActiveClass',
- 'leaveActiveClass',
- 'appearActiveClass',
- 'enterToClass',
- 'leaveToClass',
- 'appearToClass'
-]
-
-const listenersKeys = [
- 'beforeEnter',
- 'enter',
- 'afterEnter',
- 'enterCancelled',
- 'beforeLeave',
- 'leave',
- 'afterLeave',
- 'leaveCancelled',
- 'beforeAppear',
- 'appear',
- 'afterAppear',
- 'appearCancelled'
-]
-<% } %>
diff --git a/packages/vue-app/template/components/nuxt-error.vue b/packages/vue-app/template/components/nuxt-error.vue
deleted file mode 100644
index 8bab98f36a92..000000000000
--- a/packages/vue-app/template/components/nuxt-error.vue
+++ /dev/null
@@ -1,98 +0,0 @@
-
-
-
-
-
-
-
{{ message }}
-
- <%= messages.back_to_home %>
-
- <% if(debug) { %>
-
<%= messages.client_error_details %>
- <% } %>
-
-
-
-
-
-
-
-
diff --git a/packages/vue-app/template/components/nuxt-link.client.js b/packages/vue-app/template/components/nuxt-link.client.js
deleted file mode 100644
index 3b17f91b10b4..000000000000
--- a/packages/vue-app/template/components/nuxt-link.client.js
+++ /dev/null
@@ -1,114 +0,0 @@
-import Vue from 'vue'
-
-const requestIdleCallback = window.requestIdleCallback ||
- function (cb) {
- const start = Date.now()
- return setTimeout(function () {
- cb({
- didTimeout: false,
- timeRemaining: () => Math.max(0, 50 - (Date.now() - start))
- })
- }, 1)
- }
-
-const cancelIdleCallback = window.cancelIdleCallback || function (id) {
- clearTimeout(id)
-}
-
-const observer = window.IntersectionObserver && new window.IntersectionObserver((entries) => {
- entries.forEach(({ intersectionRatio, target: link }) => {
- if (intersectionRatio <= 0) {
- return
- }
- link.__prefetch()
- })
-})
-
-<%= isTest ? '// @vue/component' : '' %>
-export default {
- name: 'NuxtLink',
- extends: Vue.component('RouterLink'),
- props: {
- prefetch: {
- type: Boolean,
- default: <%= router.prefetchLinks ? 'true' : 'false' %>
- },
- noPrefetch: {
- type: Boolean,
- default: false
- }<% if (router.linkPrefetchedClass) { %>,
- prefetchedClass: {
- type: String,
- default: '<%= router.linkPrefetchedClass %>'
- }<% } %>
- },
- mounted () {
- if (this.prefetch && !this.noPrefetch) {
- this.handleId = requestIdleCallback(this.observe, { timeout: 2e3 })
- }
- },
- beforeDestroy () {
- cancelIdleCallback(this.handleId)
-
- if (this.__observed) {
- observer.unobserve(this.$el)
- delete this.$el.__prefetch
- }
- },
- methods: {
- observe () {
- // If no IntersectionObserver, avoid prefetching
- if (!observer) {
- return
- }
- // Add to observer
- if (this.shouldPrefetch()) {
- this.$el.__prefetch = this.prefetchLink.bind(this)
- observer.observe(this.$el)
- this.__observed = true
- }<% if (router.linkPrefetchedClass) { %> else {
- this.addPrefetchedClass()
- }<% } %>
- },
- shouldPrefetch () {
- return this.getPrefetchComponents().length > 0
- },
- canPrefetch () {
- const conn = navigator.connection
- const hasBadConnection = this.<%= globals.nuxt %>.isOffline || (conn && ((conn.effectiveType || '').includes('2g') || conn.saveData))
-
- return !hasBadConnection
- },
- getPrefetchComponents () {
- const ref = this.$router.resolve(this.to, this.$route, this.append)
- const Components = ref.resolved.matched.map(r => r.components.default)
-
- return Components.filter(Component => typeof Component === 'function' && !Component.options && !Component.__prefetched)
- },
- prefetchLink () {
- if (!this.canPrefetch()) {
- return
- }
- // Stop observing this link (in case of internet connection changes)
- observer.unobserve(this.$el)
- const Components = this.getPrefetchComponents()
- <% if (router.linkPrefetchedClass) { %>const promises = []<% } %>
-
- for (const Component of Components) {
- const componentOrPromise = Component()
- if (componentOrPromise instanceof Promise) {
- componentOrPromise.catch(() => {})
- <% if (router.linkPrefetchedClass) { %>promises.push(componentOrPromise)<% } %>
- }
- Component.__prefetched = true
- }<% if (router.linkPrefetchedClass) { %>
- return Promise.all(promises).then(() => this.addPrefetchedClass())
- <% } %>
- }<% if (router.linkPrefetchedClass) { %>,
- addPrefetchedClass () {
- if (this.prefetchedClass !== 'false') {
- this.$el.className = (this.$el.className + ' ' + this.prefetchedClass).trim()
- }
- }<% } %>
- }
-}
diff --git a/packages/vue-app/template/components/nuxt-link.server.js b/packages/vue-app/template/components/nuxt-link.server.js
deleted file mode 100644
index 9a228f94097a..000000000000
--- a/packages/vue-app/template/components/nuxt-link.server.js
+++ /dev/null
@@ -1,17 +0,0 @@
-import Vue from 'vue'
-
-<%= isTest ? '// @vue/component' : '' %>
-export default {
- name: 'NuxtLink',
- extends: Vue.component('RouterLink'),
- props: {
- prefetch: {
- type: Boolean,
- default: <%= router.prefetchLinks ? 'true' : 'false' %>
- },
- noPrefetch: {
- type: Boolean,
- default: false
- }
- }
-}
diff --git a/packages/vue-app/template/components/nuxt-loading.vue b/packages/vue-app/template/components/nuxt-loading.vue
deleted file mode 100644
index fa19f8b4a116..000000000000
--- a/packages/vue-app/template/components/nuxt-loading.vue
+++ /dev/null
@@ -1,177 +0,0 @@
-
-<% if (loading && loading.css) { %>
-<% } %>
diff --git a/packages/vue-app/template/components/nuxt.js b/packages/vue-app/template/components/nuxt.js
deleted file mode 100644
index 7f3ab778982f..000000000000
--- a/packages/vue-app/template/components/nuxt.js
+++ /dev/null
@@ -1,109 +0,0 @@
-import Vue from 'vue'
-import { compile } from '../utils'
-
-<% if (components.ErrorPage) { %>
- <% if (('~@').includes(components.ErrorPage.charAt(0))) { %>
-import NuxtError from '<%= components.ErrorPage %>'
- <% } else { %>
-import NuxtError from '<%= "../" + components.ErrorPage %>'
- <% } %>
-<% } else { %>
-import NuxtError from './nuxt-error.vue'
-<% } /* components */ %>
-import NuxtChild from './nuxt-child'
-
-<%= isTest ? '// @vue/component' : '' %>
-export default {
- name: 'Nuxt',
- components: {
- NuxtChild,
- NuxtError
- },
- props: {
- nuxtChildKey: {
- type: String,
- default: undefined
- },
- keepAlive: Boolean,
- keepAliveProps: {
- type: Object,
- default: undefined
- },
- name: {
- type: String,
- default: 'default'
- }
- },
- errorCaptured (error) {
- // if we receive and error while showing the NuxtError component
- // capture the error and force an immediate update so we re-render
- // without the NuxtError component
- if (this.displayingNuxtError) {
- this.errorFromNuxtError = error
- this.$forceUpdate()
- }
- },
- computed: {
- routerViewKey () {
- // If nuxtChildKey prop is given or current route has children
- if (typeof this.nuxtChildKey !== 'undefined' || this.$route.matched.length > 1) {
- return this.nuxtChildKey || compile(this.$route.matched[0].path)(this.$route.params)
- }
-
- const [matchedRoute] = this.$route.matched
-
- if (!matchedRoute) {
- return this.$route.path
- }
-
- const Component = matchedRoute.components.default
-
- if (Component && Component.options) {
- const { options } = Component
-
- if (options.key) {
- return (typeof options.key === 'function' ? options.key(this.$route) : options.key)
- }
- }
-
- const strict = /\/$/.test(matchedRoute.path)
- return strict ? this.$route.path : this.$route.path.replace(/\/$/, '')
- }
- },
- beforeCreate () {
- Vue.util.defineReactive(this, 'nuxt', this.$root.$options.nuxt)
- },
- render (h) {
- // if there is no error
- if (!this.nuxt.err) {
- // Directly return nuxt child
- return h('NuxtChild', {
- key: this.routerViewKey,
- props: this.$props
- })
- }
-
- // if an error occurred within NuxtError show a simple
- // error message instead to prevent looping
- if (this.errorFromNuxtError) {
- this.$nextTick(() => (this.errorFromNuxtError = false))
-
- return h('div', {}, [
- h('h2', 'An error occurred while showing the error page'),
- h('p', 'Unfortunately an error occurred and while showing the error page another error occurred'),
- h('p', `Error details: ${this.errorFromNuxtError.toString()}`),
- h('nuxt-link', { props: { to: '/' } }, 'Go back to home')
- ])
- }
-
- // track if we are showing the NuxtError component
- this.displayingNuxtError = true
- this.$nextTick(() => (this.displayingNuxtError = false))
-
- return h(NuxtError, {
- props: {
- error: this.nuxt.err
- }
- })
- }
-}
diff --git a/packages/vue-app/template/empty.js b/packages/vue-app/template/empty.js
deleted file mode 100644
index a3ac0d8486f3..000000000000
--- a/packages/vue-app/template/empty.js
+++ /dev/null
@@ -1 +0,0 @@
-// This file is intentionally left empty for noop aliases
diff --git a/packages/vue-app/template/index.js b/packages/vue-app/template/index.js
deleted file mode 100644
index 02bba81f9166..000000000000
--- a/packages/vue-app/template/index.js
+++ /dev/null
@@ -1,256 +0,0 @@
-import Vue from 'vue'
-<% if (features.meta) { %>import Meta from 'vue-meta'<% } %>
-<% if (features.componentClientOnly) { %>import ClientOnly from 'vue-client-only'<% } %>
-<% if (features.deprecations) { %>import NoSsr from 'vue-no-ssr'<% } %>
-import { createRouter } from './router.js'
-import NuxtChild from './components/nuxt-child.js'
-import NuxtError from '<%= components.ErrorPage ? components.ErrorPage : "./components/nuxt-error.vue" %>'
-import Nuxt from './components/nuxt.js'
-import App from '<%= appPath %>'
-import { setContext, getLocation, getRouteData, normalizeError } from './utils'
-<% if (store) { %>import { createStore } from './store.js'<% } %>
-
-/* Plugins */
-<%= isTest ? '/* eslint-disable camelcase */' : '' %>
-<% plugins.forEach((plugin) => { %>import <%= plugin.name %> from '<%= plugin.name %>' // Source: <%= relativeToBuild(plugin.src) %> (mode: '<%= plugin.mode %>')
-<% }) %>
-<%= isTest ? '/* eslint-enable camelcase */' : '' %>
-
-<% if (features.componentClientOnly) { %>
-// Component:
-Vue.component(ClientOnly.name, ClientOnly)
-<% } %>
-<% if (features.deprecations) { %>
-// TODO: Remove in Nuxt 3:
-Vue.component(NoSsr.name, {
- ...NoSsr,
- render (h, ctx) {
- if (process.client && !NoSsr._warned) {
- NoSsr._warned = true
- <%= isTest ? '// eslint-disable-next-line no-console' : '' %>
- console.warn(' has been deprecated and will be removed in Nuxt 3, please use instead')
- }
- return NoSsr.render(h, ctx)
- }
-})
-<% } %>
-// Component:
-Vue.component(NuxtChild.name, NuxtChild)
-<% if (features.componentAliases) { %>Vue.component('NChild', NuxtChild)<% } %>
-
-// Component NuxtLink is imported in server.js or client.js
-
-// Component:
-Vue.component(Nuxt.name, Nuxt)
-
-<% if (features.meta) {
-// vue-meta configuration
-const vueMetaOptions = {
- ...nuxtOptions.vueMeta,
- keyName: 'head', // the component option name that vue-meta looks for meta info on.
- attribute: 'data-n-head', // the attribute name vue-meta adds to the tags it observes
- ssrAttribute: 'data-n-head-ssr', // the attribute name that lets vue-meta know that meta info has already been server-rendered
- tagIDKeyName: 'hid' // the property name that vue-meta uses to determine whether to overwrite or append a tag
-}
-%>
-Vue.use(Meta, <%= JSON.stringify(vueMetaOptions) %>)<%= isTest ? '// eslint-disable-line' : '' %>
-<% } %>
-
-<% if (features.transitions) { %>
-const defaultTransition = <%=
- serialize(pageTransition)
- .replace('beforeEnter(', 'function(').replace('enter(', 'function(').replace('afterEnter(', 'function(')
- .replace('enterCancelled(', 'function(').replace('beforeLeave(', 'function(').replace('leave(', 'function(')
- .replace('afterLeave(', 'function(').replace('leaveCancelled(', 'function(').replace('beforeAppear(', 'function(')
- .replace('appear(', 'function(').replace('afterAppear(', 'function(').replace('appearCancelled(', 'function(')
-%><%= isTest ? '// eslint-disable-line' : '' %>
-<% } %>
-
-async function createApp (ssrContext) {
- const router = await createRouter(ssrContext)
-
- <% if (store) { %>
- const store = createStore(ssrContext)
- // Add this.$router into store actions/mutations
- store.$router = router
- <% if (mode === 'universal') { %>
- // Fix SSR caveat https://github.com/nuxt/nuxt.js/issues/3757#issuecomment-414689141
- const registerModule = store.registerModule
- store.registerModule = (path, rawModule, options) => registerModule.call(store, path, rawModule, Object.assign({ preserveState: process.client }, options))
- <% } %>
- <% } %>
-
- // Create Root instance
-
- // here we inject the router and store to all child components,
- // making them available everywhere as `this.$router` and `this.$store`.
- const app = {
- <% if (features.meta) { %>
- <%= isTest ? '/* eslint-disable array-bracket-spacing, quotes, quote-props, semi, indent, comma-spacing, key-spacing, object-curly-spacing, space-before-function-paren, object-shorthand */' : '' %>
- head: <%= serializeFunction(head) %>,
- <%= isTest ? '/* eslint-enable array-bracket-spacing, quotes, quote-props, semi, indent, comma-spacing, key-spacing, object-curly-spacing, space-before-function-paren, object-shorthand */' : '' %>
- <% } %>
- <% if (store) { %>store,<% } %>
- router,
- nuxt: {
- <% if (features.transitions) { %>
- defaultTransition,
- transitions: [defaultTransition],
- setTransitions (transitions) {
- if (!Array.isArray(transitions)) {
- transitions = [transitions]
- }
- transitions = transitions.map((transition) => {
- if (!transition) {
- transition = defaultTransition
- } else if (typeof transition === 'string') {
- transition = Object.assign({}, defaultTransition, { name: transition })
- } else {
- transition = Object.assign({}, defaultTransition, transition)
- }
- return transition
- })
- this.$options.nuxt.transitions = transitions
- return transitions
- },
- <% } %>
- err: null,
- dateErr: null,
- error (err) {
- err = err || null
- app.context._errored = Boolean(err)
- err = err ? normalizeError(err) : null
- let nuxt = app.nuxt // to work with @vue/composition-api, see https://github.com/nuxt/nuxt.js/issues/6517#issuecomment-573280207
- if (this) {
- nuxt = this.nuxt || this.$options.nuxt
- }
- nuxt.dateErr = Date.now()
- nuxt.err = err
- // Used in src/server.js
- if (ssrContext) {
- ssrContext.nuxt.error = err
- }
- return err
- }
- },
- ...App
- }
- <% if (store) { %>
- // Make app available into store via this.app
- store.app = app
- <% } %>
- const next = ssrContext ? ssrContext.next : location => app.router.push(location)
- // Resolve route
- let route
- if (ssrContext) {
- route = router.resolve(ssrContext.url).route
- } else {
- const path = getLocation(router.options.base, router.options.mode)
- route = router.resolve(path).route
- }
-
- // Set context to app.context
- await setContext(app, {
- <% if (store) { %>store,<% } %>
- route,
- next,
- error: app.nuxt.error.bind(app),
- payload: ssrContext ? ssrContext.payload : undefined,
- req: ssrContext ? ssrContext.req : undefined,
- res: ssrContext ? ssrContext.res : undefined,
- beforeRenderFns: ssrContext ? ssrContext.beforeRenderFns : undefined,
- ssrContext
- })
-
- <% if (plugins.length) { %>
- const inject = function (key, value) {
- if (!key) {
- throw new Error('inject(key, value) has no key provided')
- }
- if (value === undefined) {
- throw new Error(`inject('${key}', value) has no value provided`)
- }
-
- key = '$' + key
- // Add into app
- app[key] = value
- // Add into context
- if (!app.context[key]) {
- app.context[key] = value
- }
- <% if (store) { %>
- // Add into store
- store[key] = app[key]
- <% } %>
- // Check if plugin not already installed
- const installKey = '__<%= globals.pluginPrefix %>_' + key + '_installed__'
- if (Vue[installKey]) {
- return
- }
- Vue[installKey] = true
- // Call Vue.use() to install the plugin into vm
- Vue.use(() => {
- if (!Object.prototype.hasOwnProperty.call(Vue, key)) {
- Object.defineProperty(Vue.prototype, key, {
- get () {
- return this.$root.$options[key]
- }
- })
- }
- })
- }
- <% } %>
-
- <% if (store) { %>
- if (process.client) {
- // Replace store state before plugins execution
- if (window.<%= globals.context %> && window.<%= globals.context %>.state) {
- store.replaceState(window.<%= globals.context %>.state)
- }
- }
- <% } %>
-
- // Plugin execution
- <%= isTest ? '/* eslint-disable camelcase */' : '' %>
- <% plugins.forEach((plugin) => { %>
- <% if (plugin.mode == 'client') { %>
- if (process.client && typeof <%= plugin.name %> === 'function') {
- await <%= plugin.name %>(app.context, inject)
- }
- <% } else if (plugin.mode == 'server') { %>
- if (process.server && typeof <%= plugin.name %> === 'function') {
- await <%= plugin.name %>(app.context, inject)
- }
- <% } else { %>
- if (typeof <%= plugin.name %> === 'function') {
- await <%= plugin.name %>(app.context, inject)
- }
- <% } %>
- <% }) %>
- <%= isTest ? '/* eslint-enable camelcase */' : '' %>
-
- // If server-side, wait for async component to be resolved first
- if (process.server && ssrContext && ssrContext.url) {
- await new Promise((resolve, reject) => {
- router.push(ssrContext.url, resolve, () => {
- // navigated to a different route in router guard
- const unregister = router.afterEach(async (to, from, next) => {
- ssrContext.url = to.fullPath
- app.context.route = await getRouteData(to)
- app.context.params = to.params || {}
- app.context.query = to.query || {}
- unregister()
- resolve()
- })
- })
- })
- }
-
- return {
- <% if(store) { %>store,<% } %>
- app,
- router
- }
-}
-
-export { createApp, NuxtError }
diff --git a/packages/vue-app/template/layouts/default.vue b/packages/vue-app/template/layouts/default.vue
deleted file mode 100644
index 5d3ae9c407bd..000000000000
--- a/packages/vue-app/template/layouts/default.vue
+++ /dev/null
@@ -1,3 +0,0 @@
-
-
diff --git a/packages/vue-app/template/middleware.js b/packages/vue-app/template/middleware.js
deleted file mode 100644
index aff1f17005ff..000000000000
--- a/packages/vue-app/template/middleware.js
+++ /dev/null
@@ -1,12 +0,0 @@
-const middleware = {}
-<%= isTest ? '/* eslint-disable dot-notation */' : '' %>
-<% for (const m of middleware) {
- // TODO: remove duplicate logic in v3 (see builder.resolveMiddleware)
- const name = m.name || m.src.replace(new RegExp(`\\.(${extensions})$`), '')
- const dst = m.dst || relativeToBuild(srcDir, dir.middleware, m.src)
-%>
-middleware['<%= name %>'] = require('<%= dst %>')
-middleware['<%= name %>'] = middleware['<%= name %>'].default || middleware['<%= name %>']
-<% } %>
-<%= isTest ? '/* eslint-enable dot-notation */' : '' %>
-export default middleware
diff --git a/packages/vue-app/template/mixins/fetch.client.js b/packages/vue-app/template/mixins/fetch.client.js
deleted file mode 100644
index 1cb99350beed..000000000000
--- a/packages/vue-app/template/mixins/fetch.client.js
+++ /dev/null
@@ -1,88 +0,0 @@
-import Vue from 'vue'
-import { hasFetch, normalizeError, addLifecycleHook } from '../utils'
-
-const isSsrHydration = (vm) => vm.$vnode && vm.$vnode.elm && vm.$vnode.elm.dataset && vm.$vnode.elm.dataset.fetchKey
-const nuxtState = window.<%= globals.context %>
-
-export default {
- beforeCreate () {
- if (!hasFetch(this)) {
- return
- }
-
- this._fetchDelay = typeof this.$options.fetchDelay === 'number' ? this.$options.fetchDelay : 200
-
- Vue.util.defineReactive(this, '$fetchState', {
- pending: false,
- error: null,
- timestamp: Date.now()
- })
-
- this.$fetch = $fetch.bind(this)
- addLifecycleHook(this, 'created', created)
- addLifecycleHook(this, 'beforeMount', beforeMount)
- }
-}
-
-function beforeMount() {
- if (!this._hydrated) {
- return this.$fetch()
- }
-}
-
-function created() {
- if (!isSsrHydration(this)) {
- return
- }
-
- // Hydrate component
- this._hydrated = true
- this._fetchKey = +this.$vnode.elm.dataset.fetchKey
- const data = nuxtState.fetch[this._fetchKey]
-
- // If fetch error
- if (data && data._error) {
- this.$fetchState.error = data._error
- return
- }
-
- // Merge data
- for (const key in data) {
- Vue.set(this.$data, key, data[key])
- }
-}
-
-function $fetch() {
- if (!this._fetchPromise) {
- this._fetchPromise = $_fetch.call(this)
- .then(() => { delete this._fetchPromise })
- }
- return this._fetchPromise
-}
-
-async function $_fetch() {
- this.<%= globals.nuxt %>.nbFetching++
- this.$fetchState.pending = true
- this.$fetchState.error = null
- this._hydrated = false
- let error = null
- const startTime = Date.now()
-
- try {
- await this.$options.fetch.call(this)
- } catch (err) {
- error = normalizeError(err)
- }
-
- const delayLeft = this._fetchDelay - (Date.now() - startTime)
- if (delayLeft > 0) {
- await new Promise(resolve => setTimeout(resolve, delayLeft))
- }
-
- this.$fetchState.error = error
- this.$fetchState.pending = false
- this.$fetchState.timestamp = Date.now()
-
- this.$nextTick(() => this.<%= globals.nuxt %>.nbFetching--)
-}
-
diff --git a/packages/vue-app/template/mixins/fetch.server.js b/packages/vue-app/template/mixins/fetch.server.js
deleted file mode 100644
index 263a25fb4bf1..000000000000
--- a/packages/vue-app/template/mixins/fetch.server.js
+++ /dev/null
@@ -1,49 +0,0 @@
-import Vue from 'vue'
-import { hasFetch, normalizeError, addLifecycleHook } from '../utils'
-
-async function serverPrefetch() {
- if (!this._fetchOnServer) {
- return
- }
-
- // Call and await on $fetch
- try {
- await this.$options.fetch.call(this)
- } catch (err) {
- this.$fetchState.error = normalizeError(err)
- }
- this.$fetchState.pending = false
-
-
- // Define an ssrKey for hydration
- this._fetchKey = this.$ssrContext.nuxt.fetch.length
-
- // Add data-fetch-key on parent element of Component
- const attrs = this.$vnode.data.attrs = this.$vnode.data.attrs || {}
- attrs['data-fetch-key'] = this._fetchKey
-
- // Add to ssrContext for window.__NUXT__.fetch
- this.$ssrContext.nuxt.fetch.push(this.$fetchState.error ? { _error: this.$fetchState.error } : this._data)
-}
-
-export default {
- beforeCreate() {
- if (!hasFetch(this)) {
- return
- }
-
- if (typeof this.$options.fetchOnServer === 'function') {
- this._fetchOnServer = this.$options.fetchOnServer.call(this) !== false
- } else {
- this._fetchOnServer = this.$options.fetchOnServer !== false
- }
-
- Vue.util.defineReactive(this, '$fetchState', {
- pending: true,
- error: null,
- timestamp: Date.now()
- })
-
- addLifecycleHook(this, 'serverPrefetch', serverPrefetch)
- }
-}
diff --git a/packages/vue-app/template/pages/index.vue b/packages/vue-app/template/pages/index.vue
deleted file mode 100644
index c2d3284bed6f..000000000000
--- a/packages/vue-app/template/pages/index.vue
+++ /dev/null
@@ -1,108 +0,0 @@
-
-
-
-
-
diff --git a/packages/vue-app/template/router.js b/packages/vue-app/template/router.js
deleted file mode 100644
index bcbc109d4020..000000000000
--- a/packages/vue-app/template/router.js
+++ /dev/null
@@ -1,110 +0,0 @@
-import Vue from 'vue'
-import Router from 'vue-router'
-import { interopDefault } from './utils'<%= isTest ? '// eslint-disable-line no-unused-vars' : '' %>
-import scrollBehavior from './router.scrollBehavior.js'
-
-<% function recursiveRoutes(routes, tab, components, indentCount) {
- let res = ''
- const baseIndent = tab.repeat(indentCount)
- const firstIndent = '\n' + tab.repeat(indentCount + 1)
- const nextIndent = ',' + firstIndent
- routes.forEach((route, i) => {
- let resMap = ''
- // If need to handle named views
- if (route.components) {
- let _name = '_' + hash(route.components.default)
- if (splitChunks.pages) {
- resMap += `${firstIndent}${tab}default: ${_name}`
- } else {
- resMap += `${firstIndent}${tab}default: () => ${_name}.default || ${_name}`
- }
- for (const k in route.components) {
- _name = '_' + hash(route.components[k])
- const component = { _name, component: route.components[k] }
- if (k === 'default') {
- components.push({
- ...component,
- name: route.name,
- chunkName: route.chunkName
- })
- } else {
- components.push({
- ...component,
- name: `${route.name}-${k}`,
- chunkName: route.chunkNames[k]
- })
- if (splitChunks.pages) {
- resMap += `${nextIndent}${tab}${k}: ${_name}`
- } else {
- resMap += `${nextIndent}${tab}${k}: () => ${_name}.default || ${_name}`
- }
- }
- }
- route.component = false
- } else {
- route._name = '_' + hash(route.component)
- components.push({ _name: route._name, component: route.component, name: route.name, chunkName: route.chunkName })
- }
- // @see: https://router.vuejs.org/api/#router-construction-options
- res += '{'
- res += firstIndent + 'path: ' + JSON.stringify(route.path)
- res += (route.components) ? nextIndent + 'components: {' + resMap + '\n' + baseIndent + tab + '}' : ''
- res += (route.component) ? nextIndent + 'component: ' + route._name : ''
- res += (route.redirect) ? nextIndent + 'redirect: ' + JSON.stringify(route.redirect) : ''
- res += (route.meta) ? nextIndent + 'meta: ' + JSON.stringify(route.meta) : ''
- res += (typeof route.props !== 'undefined') ? nextIndent + 'props: ' + (typeof route.props === 'function' ? serialize(route.props) : JSON.stringify(route.props)) : ''
- res += (typeof route.caseSensitive !== 'undefined') ? nextIndent + 'caseSensitive: ' + JSON.stringify(route.caseSensitive) : ''
- res += (route.alias) ? nextIndent + 'alias: ' + JSON.stringify(route.alias) : ''
- res += (route.pathToRegexpOptions) ? nextIndent + 'pathToRegexpOptions: ' + JSON.stringify(route.pathToRegexpOptions) : ''
- res += (route.name) ? nextIndent + 'name: ' + JSON.stringify(route.name) : ''
- if (route.beforeEnter) {
- if(isTest) { res += ',\n/* eslint-disable indent, semi */' }
- res += (isTest ? firstIndent : nextIndent) + 'beforeEnter: ' + serialize(route.beforeEnter)
- if(isTest) { res += firstIndent + '/* eslint-enable indent, semi */' }
- }
- res += (route.children) ? nextIndent + 'children: [' + recursiveRoutes(routes[i].children, tab, components, indentCount + 1) + ']' : ''
- res += '\n' + baseIndent + '}' + (i + 1 === routes.length ? '' : ', ')
- })
- return res
-}
-const _components = []
-const _routes = recursiveRoutes(router.routes, ' ', _components, 1)
-%><%= uniqBy(_components, '_name').map((route) => {
- if (!route.component) return ''
- const path = relativeToBuild(route.component)
- const chunkName = wChunk(route.chunkName)
- const name = route._name
-
- if (splitChunks.pages) {
- return `const ${name} = () => interopDefault(import('${path}' /* webpackChunkName: "${chunkName}" */))`
- } else {
- return `import ${name} from '${path}'`
- }
-}).join('\n')%>
-
-// TODO: remove in Nuxt 3
-const emptyFn = () => {}
-const originalPush = Router.prototype.push
-Router.prototype.push = function push (location, onComplete = emptyFn, onAbort) {
- return originalPush.call(this, location, onComplete, onAbort)
-}
-
-Vue.use(Router)
-
-export const routerOptions = {
- mode: '<%= router.mode %>',
- base: decodeURI('<%= router.base %>'),
- linkActiveClass: '<%= router.linkActiveClass %>',
- linkExactActiveClass: '<%= router.linkExactActiveClass %>',
- scrollBehavior,
- <%= isTest ? '/* eslint-disable array-bracket-spacing, quotes, quote-props, object-curly-spacing, key-spacing */' : '' %>
- routes: [<%= _routes %>],
- <%= isTest ? '/* eslint-enable array-bracket-spacing, quotes, quote-props, object-curly-spacing, key-spacing */' : '' %>
- <% if (router.parseQuery) { %>parseQuery: <%= serializeFunction(router.parseQuery) %>,<% } %>
- <% if (router.stringifyQuery) { %>stringifyQuery: <%= serializeFunction(router.stringifyQuery) %>,<% } %>
- fallback: <%= router.fallback %>
-}
-
-export function createRouter () {
- return new Router(routerOptions)
-}
diff --git a/packages/vue-app/template/router.scrollBehavior.js b/packages/vue-app/template/router.scrollBehavior.js
deleted file mode 100644
index 2d124c1257d1..000000000000
--- a/packages/vue-app/template/router.scrollBehavior.js
+++ /dev/null
@@ -1,80 +0,0 @@
-<% if (router.scrollBehavior) { %>
-<%= isTest ? '/* eslint-disable quotes, semi, indent, comma-spacing, key-spacing, object-curly-spacing, space-before-function-paren */' : '' %>
-export default <%= serializeFunction(router.scrollBehavior) %>
-<%= isTest ? '/* eslint-enable quotes, semi, indent, comma-spacing, key-spacing, object-curly-spacing, space-before-function-paren */' : '' %>
-<% } else { %>import { getMatchedComponents } from './utils'
-
-if (process.client) {
- if ('scrollRestoration' in window.history) {
- window.history.scrollRestoration = 'manual'
-
- // reset scrollRestoration to auto when leaving page, allowing page reload
- // and back-navigation from other pages to use the browser to restore the
- // scrolling position.
- window.addEventListener('beforeunload', () => {
- window.history.scrollRestoration = 'auto'
- })
-
- // Setting scrollRestoration to manual again when returning to this page.
- window.addEventListener('load', () => {
- window.history.scrollRestoration = 'manual'
- })
- }
-}
-
-export default function (to, from, savedPosition) {
- // if the returned position is falsy or an empty object,
- // will retain current scroll position.
- let position = false
-
- // if no children detected and scrollToTop is not explicitly disabled
- const Pages = getMatchedComponents(to)
- if (
- Pages.length < 2 &&
- Pages.every(Page => Page.options.scrollToTop !== false)
- ) {
- // scroll to the top of the page
- position = { x: 0, y: 0 }
- } else if (Pages.some(Page => Page.options.scrollToTop)) {
- // if one of the children has scrollToTop option set to true
- position = { x: 0, y: 0 }
- }
-
- // savedPosition is only available for popstate navigations (back button)
- if (savedPosition) {
- position = savedPosition
- }
-
- const nuxt = window.<%= globals.nuxt %>
-
- // triggerScroll is only fired when a new component is loaded
- if (to.path === from.path && to.hash !== from.hash) {
- nuxt.$nextTick(() => nuxt.$emit('triggerScroll'))
- }
-
- return new Promise((resolve) => {
- // wait for the out transition to complete (if necessary)
- nuxt.$once('triggerScroll', () => {
- // coords will be used if no selector is provided,
- // or if the selector didn't match any element.
- if (to.hash) {
- let hash = to.hash
- // CSS.escape() is not supported with IE and Edge.
- if (typeof window.CSS !== 'undefined' && typeof window.CSS.escape !== 'undefined') {
- hash = '#' + window.CSS.escape(hash.substr(1))
- }
- try {
- if (document.querySelector(hash)) {
- // scroll to anchor by returning the selector
- position = { selector: hash }
- }
- } catch (e) {
- <%= isTest ? '// eslint-disable-next-line no-console' : '' %>
- console.warn('Failed to save scroll position. Please add CSS.escape() polyfill (https://github.com/mathiasbynens/CSS.escape).')
- }
- }
- resolve(position)
- })
- })
-}
-<% } %>
diff --git a/packages/vue-app/template/server.js b/packages/vue-app/template/server.js
deleted file mode 100644
index 4e05b54a41ff..000000000000
--- a/packages/vue-app/template/server.js
+++ /dev/null
@@ -1,312 +0,0 @@
-import { stringify } from 'querystring'
-import Vue from 'vue'
-<% if (fetch.server) { %>import fetch from 'node-fetch'<% } %>
-<% if (features.middleware) { %>import middleware from './middleware.js'<% } %>
-import {
- <% if (features.asyncData) { %>applyAsyncData,<% } %>
- <% if (features.middleware) { %>middlewareSeries,<% } %>
- <% if (features.middleware && features.layouts) { %>sanitizeComponent,<% } %>
- getMatchedComponents,
- promisify
-} from './utils.js'
-<% if (features.fetch) { %>import fetchMixin from './mixins/fetch.server'<% } %>
-import { createApp<% if (features.layouts) { %>, NuxtError<% } %> } from './index.js'
-import NuxtLink from './components/nuxt-link.server.js' // should be included after ./index.js
-
-<% if (features.fetch) { %>
-// Update serverPrefetch strategy
-Vue.config.optionMergeStrategies.serverPrefetch = Vue.config.optionMergeStrategies.created
-
-// Fetch mixin
-if (!Vue.__nuxt__fetch__mixin__) {
- Vue.mixin(fetchMixin)
- Vue.__nuxt__fetch__mixin__ = true
-}
-<% } %>
-
-// Component:
-Vue.component(NuxtLink.name, NuxtLink)
-<% if (features.componentAliases) { %>Vue.component('NLink', NuxtLink)<% } %>
-
-<% if (fetch.server) { %>if (!global.fetch) { global.fetch = fetch }<% } %>
-
-const noopApp = () => new Vue({ render: h => h('div') })
-
-function urlJoin () {
- return Array.prototype.slice.call(arguments).join('/').replace(/\/+/g, '/')
-}
-
-const createNext = ssrContext => (opts) => {
- ssrContext.redirected = opts
- // If nuxt generate
- if (!ssrContext.res) {
- ssrContext.nuxt.serverRendered = false
- return
- }
- opts.query = stringify(opts.query)
- opts.path = opts.path + (opts.query ? '?' + opts.query : '')
- const routerBase = '<%= router.base %>'
- if (!opts.path.startsWith('http') && (routerBase !== '/' && !opts.path.startsWith(routerBase))) {
- opts.path = urlJoin(routerBase, opts.path)
- }
- // Avoid loop redirect
- if (opts.path === ssrContext.url) {
- ssrContext.redirected = false
- return
- }
- ssrContext.res.writeHead(opts.status, {
- Location: opts.path
- })
- ssrContext.res.end()
-}
-
-// This exported function will be called by `bundleRenderer`.
-// This is where we perform data-prefetching to determine the
-// state of our application before actually rendering it.
-// Since data fetching is async, this function is expected to
-// return a Promise that resolves to the app instance.
-export default async (ssrContext) => {
- // Create ssrContext.next for simulate next() of beforeEach() when wanted to redirect
- ssrContext.redirected = false
- ssrContext.next = createNext(ssrContext)
- // Used for beforeNuxtRender({ Components, nuxtState })
- ssrContext.beforeRenderFns = []
- // Nuxt object (window{{globals.context}}, defaults to window.__NUXT__)
- ssrContext.nuxt = { <% if (features.layouts) { %>layout: 'default', <% } %>data: [], <% if (features.fetch) { %>fetch: [], <% } %>error: null<%= (store ? ', state: null' : '') %>, serverRendered: true, routePath: '' }
- // Create the app definition and the instance (created for each request)
- const { app, router<%= (store ? ', store' : '') %> } = await createApp(ssrContext)
- const _app = new Vue(app)
- // Add ssr route path to nuxt context so we can account for page navigation between ssr and csr
- ssrContext.nuxt.routePath = app.context.route.path
-
- <% if (features.meta) { %>
- // Add meta infos (used in renderer.js)
- ssrContext.meta = _app.$meta()
- <% } %>
- <% if (features.asyncData) { %>
- // Keep asyncData for each matched component in ssrContext (used in app/utils.js via this.$ssrContext)
- ssrContext.asyncData = {}
- <% } %>
-
- const beforeRender = async () => {
- // Call beforeNuxtRender() methods
- await Promise.all(ssrContext.beforeRenderFns.map(fn => promisify(fn, { Components, nuxtState: ssrContext.nuxt })))
- <% if (store) { %>
- ssrContext.rendered = () => {
- // Add the state from the vuex store
- ssrContext.nuxt.state = store.state
- }
- <% } %>
- }
-
- const renderErrorPage = async () => {
- <% if (features.layouts) { %>
- // Load layout for error page
- const layout = (NuxtError.options || NuxtError).layout
- const errLayout = typeof layout === 'function' ? layout.call(NuxtError, app.context) : layout
- ssrContext.nuxt.layout = errLayout || 'default'
- await _app.loadLayout(errLayout)
- _app.setLayout(errLayout)
- <% } %>
- await beforeRender()
- return _app
- }
- const render404Page = () => {
- app.context.error({ statusCode: 404, path: ssrContext.url, message: '<%= messages.error_404 %>' })
- return renderErrorPage()
- }
-
- <% if (debug) { %>const s = Date.now()<% } %>
-
- // Components are already resolved by setContext -> getRouteData (app/utils.js)
- const Components = getMatchedComponents(router.match(ssrContext.url))
-
- <% if (store) { %>
- /*
- ** Dispatch store nuxtServerInit
- */
- if (store._actions && store._actions.nuxtServerInit) {
- try {
- await store.dispatch('nuxtServerInit', app.context)
- } catch (err) {
- console.debug('Error occurred when calling nuxtServerInit: ', err.message)<%= isTest ? '// eslint-disable-line no-console' : '' %>
- throw err
- }
- }
- // ...If there is a redirect or an error, stop the process
- if (ssrContext.redirected) {
- return noopApp()
- }
- if (ssrContext.nuxt.error) {
- return renderErrorPage()
- }
- <% } %>
-
- <% if (features.middleware) { %>
- /*
- ** Call global middleware (nuxt.config.js)
- */
- let midd = <%= serialize(router.middleware).replace('middleware(', 'function(') %><%= isTest ? '// eslint-disable-line' : '' %>
- midd = midd.map((name) => {
- if (typeof name === 'function') {
- return name
- }
- if (typeof middleware[name] !== 'function') {
- app.context.error({ statusCode: 500, message: 'Unknown middleware ' + name })
- }
- return middleware[name]
- })
- await middlewareSeries(midd, app.context)
- // ...If there is a redirect or an error, stop the process
- if (ssrContext.redirected) {
- return noopApp()
- }
- if (ssrContext.nuxt.error) {
- return renderErrorPage()
- }
- <% } %>
-
- <% if (features.layouts) { %>
- /*
- ** Set layout
- */
- let layout = Components.length ? Components[0].options.layout : NuxtError.layout
- if (typeof layout === 'function') {
- layout = layout(app.context)
- }
- await _app.loadLayout(layout)
- if (ssrContext.nuxt.error) {
- return renderErrorPage()
- }
- layout = _app.setLayout(layout)
- ssrContext.nuxt.layout = _app.layoutName
- <% } %>
-
- <% if (features.middleware) { %>
- /*
- ** Call middleware (layout + pages)
- */
- midd = []
- <% if (features.layouts) { %>
- layout = sanitizeComponent(layout)
- if (layout.options.middleware) {
- midd = midd.concat(layout.options.middleware)
- }
- <% } %>
- Components.forEach((Component) => {
- if (Component.options.middleware) {
- midd = midd.concat(Component.options.middleware)
- }
- })
- midd = midd.map((name) => {
- if (typeof name === 'function') {
- return name
- }
- if (typeof middleware[name] !== 'function') {
- app.context.error({ statusCode: 500, message: 'Unknown middleware ' + name })
- }
- return middleware[name]
- })
- await middlewareSeries(midd, app.context)
- // ...If there is a redirect or an error, stop the process
- if (ssrContext.redirected) {
- return noopApp()
- }
- if (ssrContext.nuxt.error) {
- return renderErrorPage()
- }
- <% } %>
-
- <% if (features.validate) { %>
- /*
- ** Call .validate()
- */
- let isValid = true
- try {
- for (const Component of Components) {
- if (typeof Component.options.validate !== 'function') {
- continue
- }
-
- isValid = await Component.options.validate(app.context)
-
- if (!isValid) {
- break
- }
- }
- } catch (validationError) {
- // ...If .validate() threw an error
- app.context.error({
- statusCode: validationError.statusCode || '500',
- message: validationError.message
- })
- return renderErrorPage()
- }
-
- // ...If .validate() returned false
- if (!isValid) {
- // Don't server-render the page in generate mode
- if (ssrContext._generate) {
- ssrContext.nuxt.serverRendered = false
- }
- // Render a 404 error page
- return render404Page()
- }
- <% } %>
-
- // If no Components found, returns 404
- if (!Components.length) {
- return render404Page()
- }
-
- <% if (features.asyncData || features.fetch) { %>
- // Call asyncData & fetch hooks on components matched by the route.
- const asyncDatas = await Promise.all(Components.map((Component) => {
- const promises = []
-
- <% if (features.asyncData) { %>
- // Call asyncData(context)
- if (Component.options.asyncData && typeof Component.options.asyncData === 'function') {
- const promise = promisify(Component.options.asyncData, app.context)
- promise.then((asyncDataResult) => {
- ssrContext.asyncData[Component.cid] = asyncDataResult
- applyAsyncData(Component)
- return asyncDataResult
- })
- promises.push(promise)
- } else {
- promises.push(null)
- }
- <% } %>
-
- <% if (features.fetch) { %>
- // Call fetch(context)
- if (Component.options.fetch && Component.options.fetch.length) {
- promises.push(Component.options.fetch(app.context))
- } else {
- promises.push(null)
- }
- <% } %>
-
- return Promise.all(promises)
- }))
-
- <% if (debug) { %>if (process.env.DEBUG && asyncDatas.length) console.debug('Data fetching ' + ssrContext.url + ': ' + (Date.now() - s) + 'ms')<% } %>
-
- // datas are the first row of each
- ssrContext.nuxt.data = asyncDatas.map(r => r[0] || {})
- <% } %>
-
- // ...If there is a redirect or an error, stop the process
- if (ssrContext.redirected) {
- return noopApp()
- }
- if (ssrContext.nuxt.error) {
- return renderErrorPage()
- }
-
- // Call beforeNuxtRender methods & add store state
- await beforeRender()
-
- return _app
-}
diff --git a/packages/vue-app/template/store.js b/packages/vue-app/template/store.js
deleted file mode 100644
index 445125a35199..000000000000
--- a/packages/vue-app/template/store.js
+++ /dev/null
@@ -1,158 +0,0 @@
-import Vue from 'vue'
-import Vuex from 'vuex'
-
-Vue.use(Vuex)
-
-<%
-const willResolveStoreModules = storeModules.some(s => s.src.indexOf('index.') !== 0)
-if (willResolveStoreModules) { %>
-const VUEX_PROPERTIES = ['state', 'getters', 'actions', 'mutations']
-<% } %>
-let store = {};
-
-(function updateModules () {
- <% storeModules.some(s => {
- if(s.src.indexOf('index.') === 0) { %>
- store = normalizeRoot(require('<%= relativeToBuild(srcDir, dir.store, s.src) %>'), '<%= dir.store %>/<%= s.src %>')
- <% return true }}) %>
-
- // If store is an exported method = classic mode (deprecated)
- <% if (isDev) { %>
- if (typeof store === 'function') {
- <%= isTest ? '// eslint-disable-next-line no-console' : '' %>
- return console.warn('Classic mode for store/ is deprecated and will be removed in Nuxt 3.')
- }<% } %>
-
- // Enforce store modules
- store.modules = store.modules || {}
-
- <% storeModules.forEach(s => {
- if(s.src.indexOf('index.') !== 0) { %>
- resolveStoreModules(require('<%= relativeToBuild(srcDir, dir.store, s.src) %>'), '<%= s.src %>')<% }}) %>
-
- // If the environment supports hot reloading...
- <% if (isDev) { %>
- if (process.client && module.hot) {
- // Whenever any Vuex module is updated...
- module.hot.accept([<% storeModules.forEach(s => { %>
- '<%= relativeToBuild(srcDir, dir.store, s.src) %>',<% }) %>
- ], () => {
- // Update `root.modules` with the latest definitions.
- updateModules()
- // Trigger a hot update in the store.
- window.<%= globals.nuxt %>.$store.hotUpdate(store)
- })
- }<% } %>
-})()
-
-// createStore
-export const createStore = store instanceof Function ? store : () => {
- return new Vuex.Store(Object.assign({
- strict: (process.env.NODE_ENV !== 'production')
- }, store))
-}
-
-function normalizeRoot (moduleData, filePath) {
- moduleData = moduleData.default || moduleData
-
- if (moduleData.commit) {
- throw new Error(`[nuxt] ${filePath} should export a method that returns a Vuex instance.`)
- }
-
- if (typeof moduleData !== 'function') {
- // Avoid TypeError: setting a property that has only a getter when overwriting top level keys
- moduleData = Object.assign({}, moduleData)
- }
- return normalizeModule(moduleData, filePath)
-}
-
-function normalizeModule (moduleData, filePath) {
- if (moduleData.state && typeof moduleData.state !== 'function') {
- <%= isTest ? '// eslint-disable-next-line no-console' : '' %>
- console.warn(`'state' should be a method that returns an object in ${filePath}`)
-
- const state = Object.assign({}, moduleData.state)
- // Avoid TypeError: setting a property that has only a getter when overwriting top level keys
- moduleData = Object.assign({}, moduleData, { state: () => state })
- }
- return moduleData
-}
-
-<% if (willResolveStoreModules) { %>
-function resolveStoreModules (moduleData, filename) {
- moduleData = moduleData.default || moduleData
- // Remove store src + extension (./foo/index.js -> foo/index)
- const namespace = filename.replace(/\.(<%= extensions %>)$/, '')
- const namespaces = namespace.split('/')
- let moduleName = namespaces[namespaces.length - 1]
- const filePath = `<%= dir.store %>/${filename}`
-
- moduleData = moduleName === 'state'
- ? normalizeState(moduleData, filePath)
- : normalizeModule(moduleData, filePath)
-
- // If src is a known Vuex property
- if (VUEX_PROPERTIES.includes(moduleName)) {
- const property = moduleName
- const storeModule = getStoreModule(store, namespaces, { isProperty: true })
-
- // Replace state since it's a function
- mergeProperty(storeModule, moduleData, property)
- return
- }
-
- // If file is foo/index.js, it should be saved as foo
- const isIndexModule = (moduleName === 'index')
- if (isIndexModule) {
- namespaces.pop()
- moduleName = namespaces[namespaces.length - 1]
- }
-
- const storeModule = getStoreModule(store, namespaces)
-
- for (const property of VUEX_PROPERTIES) {
- mergeProperty(storeModule, moduleData[property], property)
- }
-
- if (moduleData.namespaced === false) {
- delete storeModule.namespaced
- }
-}
-
-function normalizeState (moduleData, filePath) {
- if (typeof moduleData !== 'function') {
- <%= isTest ? '// eslint-disable-next-line no-console' : '' %>
- console.warn(`${filePath} should export a method that returns an object`)
- const state = Object.assign({}, moduleData)
- return () => state
- }
- return normalizeModule(moduleData, filePath)
-}
-
-function getStoreModule (storeModule, namespaces, { isProperty = false } = {}) {
- // If ./mutations.js
- if (!namespaces.length || (isProperty && namespaces.length === 1)) {
- return storeModule
- }
-
- const namespace = namespaces.shift()
-
- storeModule.modules[namespace] = storeModule.modules[namespace] || {}
- storeModule.modules[namespace].namespaced = true
- storeModule.modules[namespace].modules = storeModule.modules[namespace].modules || {}
-
- return getStoreModule(storeModule.modules[namespace], namespaces, { isProperty })
-}
-
-function mergeProperty (storeModule, moduleData, property) {
- if (!moduleData) {
- return
- }
-
- if (property === 'state') {
- storeModule.state = moduleData || storeModule.state
- } else {
- storeModule[property] = Object.assign({}, storeModule[property], moduleData)
- }
-}
-<% } %>
diff --git a/packages/vue-app/template/utils.js b/packages/vue-app/template/utils.js
deleted file mode 100644
index 96d89a87ce96..000000000000
--- a/packages/vue-app/template/utils.js
+++ /dev/null
@@ -1,644 +0,0 @@
-import Vue from 'vue'
-
-// window.{{globals.loadedCallback}} hook
-// Useful for jsdom testing or plugins (https://github.com/tmpvar/jsdom#dealing-with-asynchronous-script-loading)
-if (process.client) {
- window.<%= globals.readyCallback %>Cbs = []
- window.<%= globals.readyCallback %> = (cb) => {
- window.<%= globals.readyCallback %>Cbs.push(cb)
- }
-}
-
-export function empty () {}
-
-export function globalHandleError (error) {
- if (Vue.config.errorHandler) {
- Vue.config.errorHandler(error)
- }
-}
-
-export function interopDefault (promise) {
- return promise.then(m => m.default || m)
-}
-
-<% if (features.fetch) { %>
-export function hasFetch(vm) {
- return vm.$options && typeof vm.$options.fetch === 'function' && !vm.$options.fetch.length
-}
-export function getChildrenComponentInstancesUsingFetch(vm, instances = []) {
- const children = vm.$children || []
- for (const child of children) {
- if (child.$fetch) {
- instances.push(child)
- continue; // Don't get the children since it will reload the template
- }
- if (child.$children) {
- getChildrenComponentInstancesUsingFetch(child, instances)
- }
- }
- return instances
-}
-<% } %>
-<% if (features.asyncData) { %>
-export function applyAsyncData (Component, asyncData) {
- if (
- // For SSR, we once all this function without second param to just apply asyncData
- // Prevent doing this for each SSR request
- !asyncData && Component.options.__hasNuxtData
- ) {
- return
- }
-
- const ComponentData = Component.options._originDataFn || Component.options.data || function () { return {} }
- Component.options._originDataFn = ComponentData
-
- Component.options.data = function () {
- const data = ComponentData.call(this, this)
- if (this.$ssrContext) {
- asyncData = this.$ssrContext.asyncData[Component.cid]
- }
- return { ...data, ...asyncData }
- }
-
- Component.options.__hasNuxtData = true
-
- if (Component._Ctor && Component._Ctor.options) {
- Component._Ctor.options.data = Component.options.data
- }
-}
-<% } %>
-
-export function sanitizeComponent (Component) {
- // If Component already sanitized
- if (Component.options && Component._Ctor === Component) {
- return Component
- }
- if (!Component.options) {
- Component = Vue.extend(Component) // fix issue #6
- Component._Ctor = Component
- } else {
- Component._Ctor = Component
- Component.extendOptions = Component.options
- }
- // If no component name defined, set file path as name, (also fixes #5703)
- if (!Component.options.name && Component.options.__file) {
- Component.options.name = Component.options.__file
- }
- return Component
-}
-
-export function getMatchedComponents (route, matches = false, prop = 'components') {
- return Array.prototype.concat.apply([], route.matched.map((m, index) => {
- return Object.keys(m[prop]).map((key) => {
- matches && matches.push(index)
- return m[prop][key]
- })
- }))
-}
-
-export function getMatchedComponentsInstances (route, matches = false) {
- return getMatchedComponents(route, matches, 'instances')
-}
-
-export function flatMapComponents (route, fn) {
- return Array.prototype.concat.apply([], route.matched.map((m, index) => {
- return Object.keys(m.components).reduce((promises, key) => {
- if (m.components[key]) {
- promises.push(fn(m.components[key], m.instances[key], m, key, index))
- } else {
- delete m.components[key]
- }
- return promises
- }, [])
- }))
-}
-
-export function resolveRouteComponents (route, fn) {
- return Promise.all(
- flatMapComponents(route, async (Component, instance, match, key) => {
- // If component is a function, resolve it
- if (typeof Component === 'function' && !Component.options) {
- Component = await Component()
- }
- match.components[key] = Component = sanitizeComponent(Component)
- return typeof fn === 'function' ? fn(Component, instance, match, key) : Component
- })
- )
-}
-
-export async function getRouteData (route) {
- if (!route) {
- return
- }
- // Make sure the components are resolved (code-splitting)
- await resolveRouteComponents(route)
- // Send back a copy of route with meta based on Component definition
- return {
- ...route,
- meta: getMatchedComponents(route).map((Component, index) => {
- return { ...Component.options.meta, ...(route.matched[index] || {}).meta }
- })
- }
-}
-
-export async function setContext (app, context) {
- // If context not defined, create it
- if (!app.context) {
- app.context = {
- isStatic: process.static,
- isDev: <%= isDev %>,
- isHMR: false,
- app,
- <%= (store ? 'store: app.store,' : '') %>
- payload: context.payload,
- error: context.error,
- base: '<%= router.base %>',
- env: <%= JSON.stringify(env) %><%= isTest ? '// eslint-disable-line' : '' %>
- }
- // Only set once
- if (context.req) {
- app.context.req = context.req
- }
- if (context.res) {
- app.context.res = context.res
- }
- if (context.ssrContext) {
- app.context.ssrContext = context.ssrContext
- }
- app.context.redirect = (status, path, query) => {
- if (!status) {
- return
- }
- app.context._redirected = true
- // if only 1 or 2 arguments: redirect('/') or redirect('/', { foo: 'bar' })
- let pathType = typeof path
- if (typeof status !== 'number' && (pathType === 'undefined' || pathType === 'object')) {
- query = path || {}
- path = status
- pathType = typeof path
- status = 302
- }
- if (pathType === 'object') {
- path = app.router.resolve(path).route.fullPath
- }
- // "/absolute/route", "./relative/route" or "../relative/route"
- if (/(^[.]{1,2}\/)|(^\/(?!\/))/.test(path)) {
- app.context.next({
- path,
- query,
- status
- })
- } else {
- path = formatUrl(path, query)
- if (process.server) {
- app.context.next({
- path,
- status
- })
- }
- if (process.client) {
- // https://developer.mozilla.org/en-US/docs/Web/API/Location/replace
- window.location.replace(path)
-
- // Throw a redirect error
- throw new Error('ERR_REDIRECT')
- }
- }
- }
- if (process.server) {
- app.context.beforeNuxtRender = fn => context.beforeRenderFns.push(fn)
- }
- if (process.client) {
- app.context.nuxtState = window.<%= globals.context %>
- }
- }
-
- // Dynamic keys
- const [currentRouteData, fromRouteData] = await Promise.all([
- getRouteData(context.route),
- getRouteData(context.from)
- ])
-
- if (context.route) {
- app.context.route = currentRouteData
- }
-
- if (context.from) {
- app.context.from = fromRouteData
- }
-
- app.context.next = context.next
- app.context._redirected = false
- app.context._errored = false
- app.context.isHMR = <% if(isDev) { %>Boolean(context.isHMR)<% } else { %>false<% } %>
- app.context.params = app.context.route.params || {}
- app.context.query = app.context.route.query || {}
-}
-<% if (features.middleware) { %>
-export function middlewareSeries (promises, appContext) {
- if (!promises.length || appContext._redirected || appContext._errored) {
- return Promise.resolve()
- }
- return promisify(promises[0], appContext)
- .then(() => {
- return middlewareSeries(promises.slice(1), appContext)
- })
-}
-<% } %>
-export function promisify (fn, context) {
- <% if (features.deprecations) { %>
- let promise
- if (fn.length === 2) {
- <% if (isDev) { %>
- console.warn('Callback-based asyncData, fetch or middleware calls are deprecated. ' +
- 'Please switch to promises or async/await syntax')
- <% } %>
-
- // fn(context, callback)
- promise = new Promise((resolve) => {
- fn(context, function (err, data) {
- if (err) {
- context.error(err)
- }
- data = data || {}
- resolve(data)
- })
- })
- } else {
- promise = fn(context)
- }
- <% } else { %>
- const promise = fn(context)
- <% } %>
- if (promise && promise instanceof Promise && typeof promise.then === 'function') {
- return promise
- }
- return Promise.resolve(promise)
-}
-
-// Imported from vue-router
-export function getLocation (base, mode) {
- let path = decodeURI(window.location.pathname)
- if (mode === 'hash') {
- return window.location.hash.replace(/^#\//, '')
- }
- if (base && path.indexOf(base) === 0) {
- path = path.slice(base.length)
- }
- return (path || '/') + window.location.search + window.location.hash
-}
-
-// Imported from path-to-regexp
-
-/**
- * Compile a string to a template function for the path.
- *
- * @param {string} str
- * @param {Object=} options
- * @return {!function(Object=, Object=)}
- */
-export function compile (str, options) {
- return tokensToFunction(parse(str, options), options)
-}
-
-export function getQueryDiff (toQuery, fromQuery) {
- const diff = {}
- const queries = { ...toQuery, ...fromQuery }
- for (const k in queries) {
- if (String(toQuery[k]) !== String(fromQuery[k])) {
- diff[k] = true
- }
- }
- return diff
-}
-
-export function normalizeError (err) {
- let message
- if (!(err.message || typeof err === 'string')) {
- try {
- message = JSON.stringify(err, null, 2)
- } catch (e) {
- message = `[${err.constructor.name}]`
- }
- } else {
- message = err.message || err
- }
- return {
- ...err,
- message,
- statusCode: (err.statusCode || err.status || (err.response && err.response.status) || 500)
- }
-}
-
-/**
- * The main path matching regexp utility.
- *
- * @type {RegExp}
- */
-const PATH_REGEXP = new RegExp([
- // Match escaped characters that would otherwise appear in future matches.
- // This allows the user to escape special characters that won't transform.
- '(\\\\.)',
- // Match Express-style parameters and un-named parameters with a prefix
- // and optional suffixes. Matches appear as:
- //
- // "/:test(\\d+)?" => ["/", "test", "\d+", undefined, "?", undefined]
- // "/route(\\d+)" => [undefined, undefined, undefined, "\d+", undefined, undefined]
- // "/*" => ["/", undefined, undefined, undefined, undefined, "*"]
- '([\\/.])?(?:(?:\\:(\\w+)(?:\\(((?:\\\\.|[^\\\\()])+)\\))?|\\(((?:\\\\.|[^\\\\()])+)\\))([+*?])?|(\\*))'
-].join('|'), 'g')
-
-/**
- * Parse a string for the raw tokens.
- *
- * @param {string} str
- * @param {Object=} options
- * @return {!Array}
- */
-function parse (str, options) {
- const tokens = []
- let key = 0
- let index = 0
- let path = ''
- const defaultDelimiter = (options && options.delimiter) || '/'
- let res
-
- while ((res = PATH_REGEXP.exec(str)) != null) {
- const m = res[0]
- const escaped = res[1]
- const offset = res.index
- path += str.slice(index, offset)
- index = offset + m.length
-
- // Ignore already escaped sequences.
- if (escaped) {
- path += escaped[1]
- continue
- }
-
- const next = str[index]
- const prefix = res[2]
- const name = res[3]
- const capture = res[4]
- const group = res[5]
- const modifier = res[6]
- const asterisk = res[7]
-
- // Push the current path onto the tokens.
- if (path) {
- tokens.push(path)
- path = ''
- }
-
- const partial = prefix != null && next != null && next !== prefix
- const repeat = modifier === '+' || modifier === '*'
- const optional = modifier === '?' || modifier === '*'
- const delimiter = res[2] || defaultDelimiter
- const pattern = capture || group
-
- tokens.push({
- name: name || key++,
- prefix: prefix || '',
- delimiter,
- optional,
- repeat,
- partial,
- asterisk: Boolean(asterisk),
- pattern: pattern ? escapeGroup(pattern) : (asterisk ? '.*' : '[^' + escapeString(delimiter) + ']+?')
- })
- }
-
- // Match any characters still remaining.
- if (index < str.length) {
- path += str.substr(index)
- }
-
- // If the path exists, push it onto the end.
- if (path) {
- tokens.push(path)
- }
-
- return tokens
-}
-
-/**
- * Prettier encoding of URI path segments.
- *
- * @param {string}
- * @return {string}
- */
-function encodeURIComponentPretty (str, slashAllowed) {
- const re = slashAllowed ? /[?#]/g : /[/?#]/g
- return encodeURI(str).replace(re, (c) => {
- return '%' + c.charCodeAt(0).toString(16).toUpperCase()
- })
-}
-
-/**
- * Encode the asterisk parameter. Similar to `pretty`, but allows slashes.
- *
- * @param {string}
- * @return {string}
- */
-function encodeAsterisk (str) {
- return encodeURIComponentPretty(str, true)
-}
-
-/**
- * Escape a regular expression string.
- *
- * @param {string} str
- * @return {string}
- */
-function escapeString (str) {
- return str.replace(/([.+*?=^!:${}()[\]|/\\])/g, '\\$1')
-}
-
-/**
- * Escape the capturing group by escaping special characters and meaning.
- *
- * @param {string} group
- * @return {string}
- */
-function escapeGroup (group) {
- return group.replace(/([=!:$/()])/g, '\\$1')
-}
-
-/**
- * Expose a method for transforming tokens into the path function.
- */
-function tokensToFunction (tokens, options) {
- // Compile all the tokens into regexps.
- const matches = new Array(tokens.length)
-
- // Compile all the patterns before compilation.
- for (let i = 0; i < tokens.length; i++) {
- if (typeof tokens[i] === 'object') {
- matches[i] = new RegExp('^(?:' + tokens[i].pattern + ')$', flags(options))
- }
- }
-
- return function (obj, opts) {
- let path = ''
- const data = obj || {}
- const options = opts || {}
- const encode = options.pretty ? encodeURIComponentPretty : encodeURIComponent
-
- for (let i = 0; i < tokens.length; i++) {
- const token = tokens[i]
-
- if (typeof token === 'string') {
- path += token
-
- continue
- }
-
- const value = data[token.name || 'pathMatch']
- let segment
-
- if (value == null) {
- if (token.optional) {
- // Prepend partial segment prefixes.
- if (token.partial) {
- path += token.prefix
- }
-
- continue
- } else {
- throw new TypeError('Expected "' + token.name + '" to be defined')
- }
- }
-
- if (Array.isArray(value)) {
- if (!token.repeat) {
- throw new TypeError('Expected "' + token.name + '" to not repeat, but received `' + JSON.stringify(value) + '`')
- }
-
- if (value.length === 0) {
- if (token.optional) {
- continue
- } else {
- throw new TypeError('Expected "' + token.name + '" to not be empty')
- }
- }
-
- for (let j = 0; j < value.length; j++) {
- segment = encode(value[j])
-
- if (!matches[i].test(segment)) {
- throw new TypeError('Expected all "' + token.name + '" to match "' + token.pattern + '", but received `' + JSON.stringify(segment) + '`')
- }
-
- path += (j === 0 ? token.prefix : token.delimiter) + segment
- }
-
- continue
- }
-
- segment = token.asterisk ? encodeAsterisk(value) : encode(value)
-
- if (!matches[i].test(segment)) {
- throw new TypeError('Expected "' + token.name + '" to match "' + token.pattern + '", but received "' + segment + '"')
- }
-
- path += token.prefix + segment
- }
-
- return path
- }
-}
-
-/**
- * Get the flags for a regexp from the options.
- *
- * @param {Object} options
- * @return {string}
- */
-function flags (options) {
- return options && options.sensitive ? '' : 'i'
-}
-
-/**
- * Format given url, append query to url query string
- *
- * @param {string} url
- * @param {string} query
- * @return {string}
- */
-function formatUrl (url, query) {
- <% if (features.clientUseUrl) { %>
- url = new URL(url, top.location.href)
- for (const key in query) {
- const value = query[key]
- if (value == null) {
- continue
- }
- if (Array.isArray(value)) {
- for (const arrayValue of value) {
- url.searchParams.append(key, arrayValue)
- }
- continue
- }
- url.searchParams.append(key, value)
- }
- url.searchParams.sort()
- return url.toString()
- <% } else { %>
- let protocol
- const index = url.indexOf('://')
- if (index !== -1) {
- protocol = url.substring(0, index)
- url = url.substring(index + 3)
- } else if (url.startsWith('//')) {
- url = url.substring(2)
- }
-
- let parts = url.split('/')
- let result = (protocol ? protocol + '://' : '//') + parts.shift()
-
- let path = parts.filter(Boolean).join('/')
- let hash
- parts = path.split('#')
- if (parts.length === 2) {
- [path, hash] = parts
- }
-
- result += path ? '/' + path : ''
-
- if (query && JSON.stringify(query) !== '{}') {
- result += (url.split('?').length === 2 ? '&' : '?') + formatQuery(query)
- }
- result += hash ? '#' + hash : ''
-
- return result
- <% } %>
-}
-<% if (!features.clientUseUrl) { %>
-/**
- * Transform data object to query string
- *
- * @param {object} query
- * @return {string}
- */
-function formatQuery (query) {
- return Object.keys(query).sort().map((key) => {
- const val = query[key]
- if (val == null) {
- return ''
- }
- if (Array.isArray(val)) {
- return val.slice().map(val2 => [key, '=', val2].join('')).join('&')
- }
- return key + '=' + val
- }).filter(Boolean).join('&')
-}
-<% } %>
-
-export function addLifecycleHook(vm, hook, fn) {
- if (!vm.$options[hook]) {
- vm.$options[hook] = []
- }
- if (!vm.$options[hook].includes(fn)) {
- vm.$options[hook].push(fn)
- }
-}
diff --git a/packages/vue-app/template/views/app.template.html b/packages/vue-app/template/views/app.template.html
deleted file mode 100644
index 3427d3ea2321..000000000000
--- a/packages/vue-app/template/views/app.template.html
+++ /dev/null
@@ -1,9 +0,0 @@
-
-
-
- {{ HEAD }}
-
-
- {{ APP }}
-
-
diff --git a/packages/vue-app/template/views/error.html b/packages/vue-app/template/views/error.html
deleted file mode 100644
index d769cf4300ac..000000000000
--- a/packages/vue-app/template/views/error.html
+++ /dev/null
@@ -1,23 +0,0 @@
-
-
-
-<%= messages.server_error %>
-
-
-
-
<%= messages.server_error %>
-
<% if (debug) { %>{{ message }}<% } else { %><%= messages.server_error_details %><% } %>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Loading...
-
-
-<%= options.dev ? '' : '' %>
diff --git a/packages/vue-app/template/views/loading/three-bounce.html b/packages/vue-app/template/views/loading/three-bounce.html
deleted file mode 100644
index c2cbf2c5c7be..000000000000
--- a/packages/vue-app/template/views/loading/three-bounce.html
+++ /dev/null
@@ -1,61 +0,0 @@
-
-
-
-
-<%= options.dev ? '' : '' %>
diff --git a/packages/vue-app/template/views/loading/wandering-cubes.html b/packages/vue-app/template/views/loading/wandering-cubes.html
deleted file mode 100644
index 0e3f7890e959..000000000000
--- a/packages/vue-app/template/views/loading/wandering-cubes.html
+++ /dev/null
@@ -1,68 +0,0 @@
-
-
-
-
-<%= options.dev ? '' : '' %>
diff --git a/packages/vue-app/test/__utils__/index.js b/packages/vue-app/test/__utils__/index.js
deleted file mode 100644
index 7a38577cdac3..000000000000
--- a/packages/vue-app/test/__utils__/index.js
+++ /dev/null
@@ -1,73 +0,0 @@
-import path from 'path'
-import { remove } from 'fs-extra'
-import consola from 'consola'
-import { getNuxtConfig, Nuxt, Builder } from '../../../../test/utils'
-
-const rootDir = path.resolve(__dirname, '..')
-
-export async function compileTemplate (template, destination, options = {}) {
- if (arguments.length < 3) {
- options = destination || {}
- destination = undefined
- }
-
- const config = getNuxtConfig(options)
-
- config.rootDir = rootDir
- config.dev = false
- config.test = false
- config.server = false
-
- const nuxt = new Nuxt(config)
- const builder = new Builder(nuxt)
-
- const templateContext = builder.createTemplateContext()
-
- const multipleTemplates = Array.isArray(template)
- if (!multipleTemplates) {
- template = [template]
- }
-
- templateContext.templateFiles = template.map((template) => {
- if (typeof template === 'string') {
- return {
- src: path.resolve(rootDir, '../template', template),
- dst: path.join(rootDir, '.nuxt', destination || path.basename(template)),
- custom: false
- }
- }
-
- return {
- src: path.resolve(rootDir, '../template', template.src),
- dst: path.join(rootDir, '.nuxt', template.dst),
- custom: template.custom
- }
- })
-
- try {
- // clear all destinations
- await Promise.all(templateContext.templateFiles.map(({ dst }) => remove(dst)))
-
- await builder.compileTemplates(templateContext)
-
- if (multipleTemplates) {
- return templateContext.templateFiles.map(template => template.dst)
- }
-
- const [template] = templateContext.templateFiles
- return template.dst
- } catch (err) {
- consola.error('Could not compile template', err.message, template)
- return false
- }
-}
-
-export function importComponent (componentPath) {
- return import(componentPath).then(m => m.default || m)
-}
-
-export const vmTick = (vm) => {
- return new Promise((resolve) => {
- vm.$nextTick(resolve)
- })
-}
diff --git a/packages/vue-app/test/nuxt-link.client.prefetch.test.js b/packages/vue-app/test/nuxt-link.client.prefetch.test.js
deleted file mode 100644
index 1f4330b6f277..000000000000
--- a/packages/vue-app/test/nuxt-link.client.prefetch.test.js
+++ /dev/null
@@ -1,163 +0,0 @@
-/**
- * @jest-environment jsdom
- */
-import { mount, RouterLinkStub } from '@vue/test-utils'
-import { vmTick, compileTemplate, importComponent } from './__utils__'
-
-/* eslint-disable no-console */
-describe('nuxt-link prefetch', () => {
- beforeAll(() => {
- jest.useFakeTimers()
-
- jest.spyOn(console, 'warn')
- jest.spyOn(console, 'error')
- })
-
- afterAll(() => jest.restoreAllMocks())
-
- test('when router.prefetchLinks is set to false, link with no prop should not be prefetched',
- async () => {
- const compiledTemplatePath = await compileTemplate(
- 'components/nuxt-link.client.js',
- 'nuxt-link.client.prefetch.0.js',
- { router: { prefetchLinks: false } }
- )
-
- const Component = await importComponent(compiledTemplatePath)
- Component.extends = RouterLinkStub
-
- const methods = { observe: jest.fn() }
-
- const wrapper = mount(Component, {
- propsData: { to: '/link' },
- methods
- })
-
- jest.runAllTimers()
- await vmTick(wrapper.vm)
-
- expect(console.warn).not.toHaveBeenCalled()
- expect(console.error).not.toHaveBeenCalled()
-
- expect(wrapper.props('prefetch')).toBe(false)
- expect(wrapper.props('noPrefetch')).toBe(false)
- expect(methods.observe).not.toHaveBeenCalled()
- })
-
- test('when router.prefetchLinks is set to false, link with prefetch prop set to true should be prefetched',
- async () => {
- const compiledTemplatePath = await compileTemplate(
- 'components/nuxt-link.client.js',
- 'nuxt-link.client.prefetch.1.js',
- { router: { prefetchLinks: false } }
- )
-
- const Component = await importComponent(compiledTemplatePath)
- Component.extends = RouterLinkStub
-
- const methods = { observe: jest.fn() }
-
- const wrapper = mount(Component, {
- propsData: { to: '/link', prefetch: true },
- methods
- })
-
- jest.runAllTimers()
- await vmTick(wrapper.vm)
-
- expect(console.warn).not.toHaveBeenCalled()
- expect(console.error).not.toHaveBeenCalled()
-
- expect(wrapper.props('prefetch')).toBe(true)
- expect(wrapper.props('noPrefetch')).toBe(false)
- expect(methods.observe).toHaveBeenCalled()
- })
-
- test('when router.prefetchLinks is set to true (default), link with no prop should be prefetched',
- async () => {
- const compiledTemplatePath = await compileTemplate(
- 'components/nuxt-link.client.js',
- 'nuxt-link.client.prefetch.2.js',
- {}
- )
-
- const Component = await importComponent(compiledTemplatePath)
- Component.extends = RouterLinkStub
-
- const methods = { observe: jest.fn() }
-
- const wrapper = mount(Component, {
- propsData: { to: '/link' },
- methods
- })
-
- jest.runAllTimers()
- await vmTick(wrapper.vm)
-
- expect(console.warn).not.toHaveBeenCalled()
- expect(console.error).not.toHaveBeenCalled()
-
- expect(wrapper.props('prefetch')).toBe(true)
- expect(wrapper.props('noPrefetch')).toBe(false)
- expect(methods.observe).toHaveBeenCalled()
- })
-
- test('when router.prefetchLinks is set to true (default), link with prefetch prop set to false should not be prefetched',
- async () => {
- const compiledTemplatePath = await compileTemplate(
- 'components/nuxt-link.client.js',
- 'nuxt-link.client.prefetch.3.js',
- {}
- )
-
- const Component = await importComponent(compiledTemplatePath)
- Component.extends = RouterLinkStub
-
- const methods = { observe: jest.fn() }
-
- const wrapper = mount(Component, {
- propsData: { to: '/link', prefetch: false },
- methods
- })
-
- jest.runAllTimers()
- await vmTick(wrapper.vm)
-
- expect(console.warn).not.toHaveBeenCalled()
- expect(console.error).not.toHaveBeenCalled()
-
- expect(wrapper.props('prefetch')).toBe(false)
- expect(wrapper.props('noPrefetch')).toBe(false)
- expect(methods.observe).not.toHaveBeenCalled()
- })
-
- test('when router.prefetchLinks is set to true (default), link with noPrefetch prop should not be prefetched',
- async () => {
- const compiledTemplatePath = await compileTemplate(
- 'components/nuxt-link.client.js',
- 'nuxt-link.client.prefetch.4.js',
- {}
- )
-
- const Component = await importComponent(compiledTemplatePath)
- Component.extends = RouterLinkStub
-
- const methods = { observe: jest.fn() }
-
- const wrapper = mount(Component, {
- propsData: { to: '/link', noPrefetch: true },
- methods
- })
-
- jest.runAllTimers()
- await vmTick(wrapper.vm)
-
- expect(console.warn).not.toHaveBeenCalled()
- expect(console.error).not.toHaveBeenCalled()
-
- expect(wrapper.props('prefetch')).toBe(true)
- expect(wrapper.props('noPrefetch')).toBe(true)
- expect(methods.observe).not.toHaveBeenCalled()
- })
-})
-/* eslint-enable no-console */
diff --git a/packages/vue-app/test/nuxt-loading.test.js b/packages/vue-app/test/nuxt-loading.test.js
deleted file mode 100644
index db6d8f6f537c..000000000000
--- a/packages/vue-app/test/nuxt-loading.test.js
+++ /dev/null
@@ -1,189 +0,0 @@
-/**
- * @jest-environment jsdom
- */
-import { mount, createLocalVue } from '@vue/test-utils'
-import { renderToString } from '@vue/server-test-utils'
-import { compileTemplate, importComponent, vmTick } from './__utils__'
-
-jest.useFakeTimers()
-
-describe('nuxt-loading', () => {
- let localVue
- let Component
-
- beforeAll(async () => {
- const compiledTemplate = await compileTemplate('components/nuxt-loading.vue')
- Component = await importComponent(compiledTemplate)
-
- localVue = createLocalVue()
- })
-
- afterEach(() => jest.clearAllTimers())
-
- test('removed when not loading', async () => {
- const str = await renderToString(Component)
- expect(str).toBe('')
- })
-
- test('added when loading', async () => {
- const wrapper = mount(Component)
- wrapper.setData({ throttle: 0 })
- wrapper.vm.start()
-
- await vmTick(wrapper.vm)
-
- expect(wrapper.html()).toBe('
')
- })
-
- test('percentage changed after 1s', async () => {
- const wrapper = mount(Component, { localVue })
- wrapper.setData({
- duration: 1000,
- throttle: 0
- })
-
- wrapper.vm.start()
-
- jest.advanceTimersByTime(250)
- await vmTick(wrapper.vm)
-
- const html = wrapper.html()
- expect(html).not.toBe('
')
- expect(wrapper.vm.get()).not.toBe(0)
- })
-
- test('can be finished', async () => {
- const wrapper = mount(Component, { localVue })
-
- wrapper.setData({
- duration: 1000,
- throttle: 0
- })
-
- wrapper.vm.start()
- wrapper.vm.finish()
-
- await vmTick(wrapper.vm)
-
- let html = wrapper.html()
- expect(html).toBe('
')
- expect(wrapper.vm.get()).toBe(100)
-
- jest.runAllTimers()
- await vmTick(wrapper.vm)
-
- html = wrapper.html()
- expect(html).toBe('')
- expect(wrapper.vm.get()).toBe(0)
- })
-
- test('can fail', async () => {
- const wrapper = mount(Component, { localVue })
-
- wrapper.vm.set(50)
- wrapper.vm.fail()
-
- await vmTick(wrapper.vm)
-
- const html = wrapper.html()
- expect(html).toBe('
')
- })
-
- test('not shown until throttle', async () => {
- const wrapper = mount(Component, { localVue })
-
- wrapper.setData({
- duration: 2000,
- throttle: 1000
- })
-
- wrapper.vm.start()
-
- await vmTick(wrapper.vm)
-
- jest.advanceTimersByTime(250)
-
- await vmTick(wrapper.vm)
-
- let html = wrapper.html()
- expect(html).toBe('')
-
- jest.advanceTimersByTime(1000)
-
- await vmTick(wrapper.vm)
-
- html = wrapper.html()
- expect(html).not.toBe('
')
- expect(html).toContain(' {
- const wrapper = mount(Component, { localVue })
-
- wrapper.setData({
- duration: 2000,
- throttle: 0
- })
-
- wrapper.vm.start()
- jest.advanceTimersByTime(250)
-
- await vmTick(wrapper.vm)
-
- let html = wrapper.html()
- expect(html).toContain('
{
- const wrapper = mount(Component, { localVue })
-
- wrapper.setData({
- continuous: true,
- duration: 500,
- rtl: false,
- throttle: 0
- })
-
- wrapper.vm.start()
-
- await vmTick(wrapper.vm)
-
- jest.advanceTimersByTime(500)
-
- await vmTick(wrapper.vm)
-
- let html = wrapper.html()
- expect(html).toBe('
')
-
- jest.advanceTimersByTime(250)
-
- await vmTick(wrapper.vm)
-
- html = wrapper.html()
- expect(wrapper.vm.reversed).toBe(true)
- expect(html).toContain('
, useful to make transitions inside a dynamic page and different route. Default: `$route.fullPath`"
- },
- "to": {
- "description": "Denotes the target route of the link. When clicked, the value of the to prop will be passed to router.push() internally, so the value can be either a string or a location descriptor object."
- },
- "prefetch": {
- "type": "boolean",
- "description": "Prefetch route target (overrides router.prefetchLinks value in nuxt.config.js)."
- },
- "no-prefetch": {
- "description": "Avoid prefetching route target."
- },
- "replace": {
- "type": "boolean",
- "description": "Setting replace prop will call router.replace() instead of router.push() when clicked, so the navigation will not leave a history record."
- },
- "append": {
- "type": "boolean",
- "description": "Setting append prop always appends the relative path to the current path. For example, assuming we are navigating from /a to a relative link b, without append we will end up at /b, but with append we will end up at /a/b."
- },
- "tag": {
- "description": "Specify which tag to render to, and it will still listen to click events for navigation."
- },
- "active-class": {
- "description": "Configure the active CSS class applied when the link is active."
- },
- "exact": {
- "description": "The default active class matching behavior is inclusive match. For example,
will get this class applied as long as the current path starts with /a/ or is /a.\nOne consequence of this is that will be active for every route! To force the link into \"exact match mode\", use the exact prop: "
- },
- "event": {
- "description": "Specify the event(s) that can trigger the link navigation."
- },
- "exact-active-class": {
- "description": "Configure the active CSS class applied when the link is active with exact match. Note the default value can also be configured globally via the linkExactActiveClass router constructor option."
- }
-}
diff --git a/packages/vue-app/vetur/nuxt-tags.json b/packages/vue-app/vetur/nuxt-tags.json
deleted file mode 100644
index 3fc2c2819464..000000000000
--- a/packages/vue-app/vetur/nuxt-tags.json
+++ /dev/null
@@ -1,47 +0,0 @@
-{
- "nuxt": {
- "attributes": [
- "nuxtChildKey"
- ],
- "description": "Component to render the current nuxt page."
- },
- "n-child": {
- "description": "Component for displaying the children components in a nested route."
- },
- "nuxt-child": {
- "description": "Component for displaying the children components in a nested route."
- },
- "n-link": {
- "attributes": [
- "to",
- "replace",
- "append",
- "tag",
- "active-class",
- "exact",
- "event",
- "exact-active-class",
- "prefetch",
- "no-prefetch"
- ],
- "description": "Component for navigating between Nuxt pages."
- },
- "nuxt-link": {
- "attributes": [
- "to",
- "replace",
- "append",
- "tag",
- "active-class",
- "exact",
- "event",
- "exact-active-class",
- "prefetch",
- "no-prefetch"
- ],
- "description": "Component for navigating between Nuxt pages."
- },
- "no-ssr": {
- "description": "Component for excluding a part of your app from server-side rendering."
- }
-}
diff --git a/packages/vue-renderer/package.js b/packages/vue-renderer/package.js
deleted file mode 100644
index 19d0ef6e2d14..000000000000
--- a/packages/vue-renderer/package.js
+++ /dev/null
@@ -1,3 +0,0 @@
-export default {
- build: true
-}
diff --git a/packages/vue-renderer/package.json b/packages/vue-renderer/package.json
deleted file mode 100644
index 2515e4f38ecd..000000000000
--- a/packages/vue-renderer/package.json
+++ /dev/null
@@ -1,23 +0,0 @@
-{
- "name": "@nuxt/vue-renderer",
- "version": "2.12.1",
- "repository": "nuxt/nuxt.js",
- "license": "MIT",
- "main": "dist/vue-renderer.js",
- "files": [
- "dist"
- ],
- "dependencies": {
- "@nuxt/devalue": "^1.2.4",
- "@nuxt/utils": "2.12.1",
- "consola": "^2.11.3",
- "fs-extra": "^8.1.0",
- "lru-cache": "^5.1.1",
- "vue": "^2.6.11",
- "vue-meta": "^2.3.3",
- "vue-server-renderer": "^2.6.11"
- },
- "publishConfig": {
- "access": "public"
- }
-}
diff --git a/packages/vue-renderer/src/index.js b/packages/vue-renderer/src/index.js
deleted file mode 100644
index 0567e6025fe4..000000000000
--- a/packages/vue-renderer/src/index.js
+++ /dev/null
@@ -1 +0,0 @@
-export { default as VueRenderer } from './renderer'
diff --git a/packages/vue-renderer/src/renderer.js b/packages/vue-renderer/src/renderer.js
deleted file mode 100644
index d34887ff68fd..000000000000
--- a/packages/vue-renderer/src/renderer.js
+++ /dev/null
@@ -1,377 +0,0 @@
-import path from 'path'
-import fs from 'fs-extra'
-import consola from 'consola'
-import template from 'lodash/template'
-import { isModernRequest, waitFor } from '@nuxt/utils'
-
-import SPARenderer from './renderers/spa'
-import SSRRenderer from './renderers/ssr'
-import ModernRenderer from './renderers/modern'
-
-export default class VueRenderer {
- constructor (context) {
- this.serverContext = context
- this.options = this.serverContext.options
-
- // Will be set by createRenderer
- this.renderer = {
- ssr: undefined,
- modern: undefined,
- spa: undefined
- }
-
- // Renderer runtime resources
- Object.assign(this.serverContext.resources, {
- clientManifest: undefined,
- modernManifest: undefined,
- serverManifest: undefined,
- ssrTemplate: undefined,
- spaTemplate: undefined,
- errorTemplate: this.parseTemplate('Nuxt.js Internal Server Error')
- })
-
- // Default status
- this._state = 'created'
- this._error = null
- }
-
- ready () {
- if (!this._readyPromise) {
- this._state = 'loading'
- this._readyPromise = this._ready()
- .then(() => {
- this._state = 'ready'
- return this
- })
- .catch((error) => {
- this._state = 'error'
- this._error = error
- throw error
- })
- }
-
- return this._readyPromise
- }
-
- async _ready () {
- // Resolve dist path
- this.distPath = path.resolve(this.options.buildDir, 'dist', 'server')
-
- // -- Development mode --
- if (this.options.dev) {
- this.serverContext.nuxt.hook('build:resources', mfs => this.loadResources(mfs))
- return
- }
-
- // -- Production mode --
-
- // Try once to load SSR resources from fs
- await this.loadResources(fs)
-
- // Without using `nuxt start` (programmatic, tests and generate)
- if (!this.options._start) {
- this.serverContext.nuxt.hook('build:resources', () => this.loadResources(fs))
- return
- }
-
- // Verify resources
- if (this.options.modern && !this.isModernReady) {
- throw new Error(
- `No modern build files found in ${this.distPath}.\nUse either \`nuxt build --modern\` or \`modern\` option to build modern files.`
- )
- } else if (!this.isReady) {
- throw new Error(
- `No build files found in ${this.distPath}.\nUse either \`nuxt build\` or \`builder.build()\` or start nuxt in development mode.`
- )
- }
- }
-
- async loadResources (_fs) {
- const updated = []
-
- const readResource = async (fileName, encoding) => {
- try {
- const fullPath = path.resolve(this.distPath, fileName)
-
- if (!await _fs.exists(fullPath)) {
- return
- }
- const contents = await _fs.readFile(fullPath, encoding)
-
- return contents
- } catch (err) {
- consola.error('Unable to load resource:', fileName, err)
- }
- }
-
- for (const resourceName in this.resourceMap) {
- const { fileName, transform, encoding } = this.resourceMap[resourceName]
-
- // Load resource
- let resource = await readResource(fileName, encoding)
-
- // Skip unavailable resources
- if (!resource) {
- continue
- }
-
- // Apply transforms
- if (typeof transform === 'function') {
- resource = await transform(resource, { readResource })
- }
-
- // Update resource
- this.serverContext.resources[resourceName] = resource
- updated.push(resourceName)
- }
-
- // Load templates
- await this.loadTemplates()
-
- await this.serverContext.nuxt.callHook('render:resourcesLoaded', this.serverContext.resources)
-
- // Detect if any resource updated
- if (updated.length > 0) {
- // Create new renderer
- this.createRenderer()
- }
- }
-
- async loadTemplates () {
- // Reload error template
- const errorTemplatePath = path.resolve(this.options.buildDir, 'views/error.html')
-
- if (await fs.exists(errorTemplatePath)) {
- const errorTemplate = await fs.readFile(errorTemplatePath, 'utf8')
- this.serverContext.resources.errorTemplate = this.parseTemplate(errorTemplate)
- }
-
- // Reload loading template
- const loadingHTMLPath = path.resolve(this.options.buildDir, 'loading.html')
-
- if (await fs.exists(loadingHTMLPath)) {
- this.serverContext.resources.loadingHTML = await fs.readFile(loadingHTMLPath, 'utf8')
- this.serverContext.resources.loadingHTML = this.serverContext.resources.loadingHTML.replace(/\r|\n|[\t\s]{3,}/g, '')
- } else {
- this.serverContext.resources.loadingHTML = ''
- }
- }
-
- // TODO: Remove in Nuxt 3
- get noSSR () { /* Backward compatibility */
- return this.options.render.ssr === false
- }
-
- get SSR () {
- return this.options.render.ssr === true
- }
-
- get isReady () {
- // SPA
- if (!this.serverContext.resources.spaTemplate || !this.renderer.spa) {
- return false
- }
-
- // SSR
- if (this.SSR && (!this.serverContext.resources.ssrTemplate || !this.renderer.ssr)) {
- return false
- }
-
- return true
- }
-
- get isModernReady () {
- return this.isReady && this.serverContext.resources.modernManifest
- }
-
- // TODO: Remove in Nuxt 3
- get isResourcesAvailable () { /* Backward compatibility */
- return this.isReady
- }
-
- detectModernBuild () {
- const { options, resources } = this.serverContext
- if ([false, 'client', 'server'].includes(options.modern)) {
- return
- }
-
- if (!resources.modernManifest) {
- options.modern = false
- return
- }
-
- options.modern = options.render.ssr ? 'server' : 'client'
- consola.info(`Modern bundles are detected. Modern mode (\`${options.modern}\`) is enabled now.`)
- }
-
- createRenderer () {
- // Resource clientManifest is always required
- if (!this.serverContext.resources.clientManifest) {
- return
- }
-
- this.detectModernBuild()
-
- // Create SPA renderer
- if (this.serverContext.resources.spaTemplate) {
- this.renderer.spa = new SPARenderer(this.serverContext)
- }
-
- // Skip the rest if SSR resources are not available
- if (this.serverContext.resources.ssrTemplate && this.serverContext.resources.serverManifest) {
- // Create bundle renderer for SSR
- this.renderer.ssr = new SSRRenderer(this.serverContext)
-
- if (this.options.modern !== false) {
- this.renderer.modern = new ModernRenderer(this.serverContext)
- }
- }
- }
-
- renderSPA (renderContext) {
- return this.renderer.spa.render(renderContext)
- }
-
- renderSSR (renderContext) {
- // Call renderToString from the bundleRenderer and generate the HTML (will update the renderContext as well)
- const renderer = renderContext.modern ? this.renderer.modern : this.renderer.ssr
- return renderer.render(renderContext)
- }
-
- async renderRoute (url, renderContext = {}, _retried = 0) {
- /* istanbul ignore if */
- if (!this.isReady) {
- // Fall-back to loading-screen if enabled
- if (this.options.build.loadingScreen) {
- // Tell nuxt middleware to use `server:nuxt:renderLoading hook
- return false
- }
-
- // Retry
- const retryLimit = this.options.dev ? 60 : 3
- if (_retried < retryLimit && this._state !== 'error') {
- await this.ready().then(() => waitFor(1000))
- return this.renderRoute(url, renderContext, _retried + 1)
- }
-
- // Throw Error
- switch (this._state) {
- case 'created':
- throw new Error('Renderer ready() is not called! Please ensure `nuxt.ready()` is called and awaited.')
- case 'loading':
- throw new Error('Renderer is loading.')
- case 'error':
- throw this._error
- case 'ready':
- throw new Error(`Renderer resources are not loaded! Please check possible console errors and ensure dist (${this.distPath}) exists.`)
- default:
- throw new Error('Renderer is in unknown state!')
- }
- }
-
- // Log rendered url
- consola.debug(`Rendering url ${url}`)
-
- // Add url to the renderContext
- renderContext.url = url
-
- const { req = {} } = renderContext
-
- // renderContext.spa
- if (renderContext.spa === undefined) {
- // TODO: Remove reading from renderContext.res in Nuxt3
- renderContext.spa = !this.SSR || req.spa || (renderContext.res && renderContext.res.spa)
- }
-
- // renderContext.modern
- if (renderContext.modern === undefined) {
- const modernMode = this.options.modern
- renderContext.modern = modernMode === 'client' || isModernRequest(req, modernMode)
- }
-
- // Call renderContext hook
- await this.serverContext.nuxt.callHook('vue-renderer:context', renderContext)
-
- // Render SPA or SSR
- return renderContext.spa
- ? this.renderSPA(renderContext)
- : this.renderSSR(renderContext)
- }
-
- get resourceMap () {
- return {
- clientManifest: {
- fileName: 'client.manifest.json',
- transform: src => JSON.parse(src)
- },
- modernManifest: {
- fileName: 'modern.manifest.json',
- transform: src => JSON.parse(src)
- },
- serverManifest: {
- fileName: 'server.manifest.json',
- // BundleRenderer needs resolved contents
- transform: async (src, { readResource }) => {
- const serverManifest = JSON.parse(src)
-
- const readResources = async (obj) => {
- const _obj = {}
- await Promise.all(Object.keys(obj).map(async (key) => {
- _obj[key] = await readResource(obj[key])
- }))
- return _obj
- }
-
- const [files, maps] = await Promise.all([
- readResources(serverManifest.files),
- readResources(serverManifest.maps)
- ])
-
- // Try to parse sourcemaps
- for (const map in maps) {
- if (maps[map] && maps[map].version) {
- continue
- }
- try {
- maps[map] = JSON.parse(maps[map])
- } catch (e) {
- maps[map] = { version: 3, sources: [], mappings: '' }
- }
- }
-
- return {
- ...serverManifest,
- files,
- maps
- }
- }
- },
- ssrTemplate: {
- fileName: 'index.ssr.html',
- transform: src => this.parseTemplate(src)
- },
- spaTemplate: {
- fileName: 'index.spa.html',
- transform: src => this.parseTemplate(src)
- }
- }
- }
-
- parseTemplate (templateStr) {
- return template(templateStr, {
- interpolate: /{{([\s\S]+?)}}/g,
- evaluate: /{%([\s\S]+?)%}/g
- })
- }
-
- close () {
- if (this.__closed) {
- return
- }
- this.__closed = true
-
- for (const key in this.renderer) {
- delete this.renderer[key]
- }
- }
-}
diff --git a/packages/vue-renderer/src/renderers/base.js b/packages/vue-renderer/src/renderers/base.js
deleted file mode 100644
index 65a23958db46..000000000000
--- a/packages/vue-renderer/src/renderers/base.js
+++ /dev/null
@@ -1,25 +0,0 @@
-export default class BaseRenderer {
- constructor (serverContext) {
- this.serverContext = serverContext
- this.options = serverContext.options
-
- this.vueRenderer = this.createRenderer()
- }
-
- createRenderer () {
- throw new Error('`createRenderer()` needs to be implemented')
- }
-
- renderTemplate (templateFn, opts) {
- // Fix problem with HTMLPlugin's minify option (#3392)
- opts.html_attrs = opts.HTML_ATTRS
- opts.head_attrs = opts.HEAD_ATTRS
- opts.body_attrs = opts.BODY_ATTRS
-
- return templateFn(opts)
- }
-
- render () {
- throw new Error('`render()` needs to be implemented')
- }
-}
diff --git a/packages/vue-renderer/src/renderers/modern.js b/packages/vue-renderer/src/renderers/modern.js
deleted file mode 100644
index 539252d0a203..000000000000
--- a/packages/vue-renderer/src/renderers/modern.js
+++ /dev/null
@@ -1,122 +0,0 @@
-import invert from 'lodash/invert'
-import { isUrl, urlJoin, safariNoModuleFix } from '@nuxt/utils'
-import SSRRenderer from './ssr'
-
-export default class ModernRenderer extends SSRRenderer {
- constructor (serverContext) {
- super(serverContext)
-
- const { build: { publicPath }, router: { base } } = this.options
- this.publicPath = isUrl(publicPath) ? publicPath : urlJoin(base, publicPath)
- }
-
- get assetsMapping () {
- if (this._assetsMapping) {
- return this._assetsMapping
- }
-
- const { clientManifest, modernManifest } = this.serverContext.resources
- const legacyAssets = clientManifest.assetsMapping
- const modernAssets = invert(modernManifest.assetsMapping)
- const mapping = {}
-
- for (const legacyJsFile in legacyAssets) {
- const chunkNamesHash = legacyAssets[legacyJsFile]
- mapping[legacyJsFile] = modernAssets[chunkNamesHash]
- }
- delete clientManifest.assetsMapping
- delete modernManifest.assetsMapping
- this._assetsMapping = mapping
-
- return mapping
- }
-
- get isServerMode () {
- return this.options.modern === 'server'
- }
-
- get rendererOptions () {
- const rendererOptions = super.rendererOptions
- if (this.isServerMode) {
- rendererOptions.clientManifest = this.serverContext.resources.modernManifest
- }
- return rendererOptions
- }
-
- renderScripts (renderContext) {
- const scripts = super.renderScripts(renderContext)
-
- if (this.isServerMode) {
- return scripts
- }
-
- const scriptPattern = /]*?src="([^"]*?)" defer><\/script>/g
-
- const modernScripts = scripts.replace(scriptPattern, (scriptTag, jsFile) => {
- const legacyJsFile = jsFile.replace(this.publicPath, '')
- const modernJsFile = this.assetsMapping[legacyJsFile]
- if (!modernJsFile) {
- return scriptTag
- }
- const moduleTag = scriptTag
- .replace('${safariNoModuleFix}`
-
- return safariNoModuleFixScript + modernScripts
- }
-
- getModernFiles (legacyFiles = []) {
- const modernFiles = []
-
- for (const legacyJsFile of legacyFiles) {
- const modernFile = { ...legacyJsFile, modern: true }
- if (modernFile.asType === 'script') {
- const file = this.assetsMapping[legacyJsFile.file]
- modernFile.file = file
- modernFile.fileWithoutQuery = file.replace(/\?.*/, '')
- }
- modernFiles.push(modernFile)
- }
-
- return modernFiles
- }
-
- getPreloadFiles (renderContext) {
- const preloadFiles = super.getPreloadFiles(renderContext)
- // In eligible server modern mode, preloadFiles are modern bundles from modern renderer
- return this.isServerMode ? preloadFiles : this.getModernFiles(preloadFiles)
- }
-
- renderResourceHints (renderContext) {
- const resourceHints = super.renderResourceHints(renderContext)
- if (this.isServerMode) {
- return resourceHints
- }
-
- const linkPattern = /]*?href="([^"]*?)"[^>]*?as="script"[^>]*?>/g
-
- return resourceHints.replace(linkPattern, (linkTag, jsFile) => {
- const legacyJsFile = jsFile.replace(this.publicPath, '')
- const modernJsFile = this.assetsMapping[legacyJsFile]
- if (!modernJsFile) {
- return ''
- }
- return linkTag
- .replace('rel="preload"', `rel="modulepreload"`)
- .replace(legacyJsFile, modernJsFile)
- })
- }
-
- render (renderContext) {
- if (this.isServerMode) {
- renderContext.res.setHeader('Vary', 'User-Agent')
- }
- return super.render(renderContext)
- }
-}
diff --git a/packages/vue-renderer/src/renderers/spa.js b/packages/vue-renderer/src/renderers/spa.js
deleted file mode 100644
index 35ab76b58b12..000000000000
--- a/packages/vue-renderer/src/renderers/spa.js
+++ /dev/null
@@ -1,202 +0,0 @@
-import { extname } from 'path'
-import cloneDeep from 'lodash/cloneDeep'
-import VueMeta from 'vue-meta'
-import { createRenderer } from 'vue-server-renderer'
-import LRU from 'lru-cache'
-import { isModernRequest } from '@nuxt/utils'
-import BaseRenderer from './base'
-
-export default class SPARenderer extends BaseRenderer {
- constructor (serverContext) {
- super(serverContext)
-
- this.cache = new LRU()
-
- this.vueMetaConfig = {
- ssrAppId: '1',
- ...this.options.vueMeta,
- keyName: 'head',
- attribute: 'data-n-head',
- ssrAttribute: 'data-n-head-ssr',
- tagIDKeyName: 'hid'
- }
- }
-
- createRenderer () {
- return createRenderer()
- }
-
- async render (renderContext) {
- const { url = '/', req = {}, _generate } = renderContext
- const modernMode = this.options.modern
- const modern = (modernMode && _generate) || isModernRequest(req, modernMode)
- const cacheKey = `${modern ? 'modern:' : 'legacy:'}${url}`
- let meta = this.cache.get(cacheKey)
-
- if (meta) {
- // Return a copy of the content, so that future
- // modifications do not effect the data in cache
- return cloneDeep(meta)
- }
-
- meta = {
- HTML_ATTRS: '',
- HEAD_ATTRS: '',
- BODY_ATTRS: '',
- HEAD: '',
- BODY_SCRIPTS_PREPEND: '',
- BODY_SCRIPTS: ''
- }
-
- if (this.options.features.meta) {
- // Get vue-meta context
- let head
- if (typeof this.options.head === 'function') {
- head = this.options.head()
- } else {
- head = cloneDeep(this.options.head)
- }
-
- const m = VueMeta.generate(head || {}, this.vueMetaConfig)
-
- // HTML_ATTRS
- meta.HTML_ATTRS = m.htmlAttrs.text()
-
- // HEAD_ATTRS
- meta.HEAD_ATTRS = m.headAttrs.text()
-
- // BODY_ATTRS
- meta.BODY_ATTRS = m.bodyAttrs.text()
-
- // HEAD tags
- meta.HEAD =
- m.title.text() +
- m.meta.text() +
- m.link.text() +
- m.style.text() +
- m.script.text() +
- m.noscript.text()
-
- // Add ${this.serverContext.resources.loadingHTML}
${meta.BODY_SCRIPTS}`
-
- // Prepare template params
- const templateParams = {
- ...meta,
- APP,
- ENV: this.options.env
- }
-
- // Call spa:templateParams hook
- await this.serverContext.nuxt.callHook('vue-renderer:spa:templateParams', templateParams)
-
- // Render with SPA template
- const html = this.renderTemplate(this.serverContext.resources.spaTemplate, templateParams)
- const content = {
- html,
- preloadFiles: meta.preloadFiles || []
- }
-
- // Set meta tags inside cache
- this.cache.set(cacheKey, content)
-
- // Return a copy of the content, so that future
- // modifications do not effect the data in cache
- return cloneDeep(content)
- }
-
- static normalizeFile (file) {
- const withoutQuery = file.replace(/\?.*/, '')
- const extension = extname(withoutQuery).slice(1)
- return {
- file,
- extension,
- fileWithoutQuery: withoutQuery,
- asType: SPARenderer.getPreloadType(extension)
- }
- }
-
- static getPreloadType (ext) {
- if (ext === 'js') {
- return 'script'
- } else if (ext === 'css') {
- return 'style'
- } else if (/jpe?g|png|svg|gif|webp|ico/.test(ext)) {
- return 'image'
- } else if (/woff2?|ttf|otf|eot/.test(ext)) {
- return 'font'
- } else {
- return ''
- }
- }
-}
diff --git a/packages/vue-renderer/src/renderers/ssr.js b/packages/vue-renderer/src/renderers/ssr.js
deleted file mode 100644
index 5804c2a13d59..000000000000
--- a/packages/vue-renderer/src/renderers/ssr.js
+++ /dev/null
@@ -1,231 +0,0 @@
-import path from 'path'
-import crypto from 'crypto'
-import { format } from 'util'
-import fs from 'fs-extra'
-import consola from 'consola'
-import devalue from '@nuxt/devalue'
-import { createBundleRenderer } from 'vue-server-renderer'
-import BaseRenderer from './base'
-
-export default class SSRRenderer extends BaseRenderer {
- get rendererOptions () {
- const hasModules = fs.existsSync(path.resolve(this.options.rootDir, 'node_modules'))
-
- return {
- clientManifest: this.serverContext.resources.clientManifest,
- // for globally installed nuxt command, search dependencies in global dir
- basedir: hasModules ? this.options.rootDir : __dirname,
- ...this.options.render.bundleRenderer
- }
- }
-
- renderScripts (renderContext) {
- const scripts = renderContext.renderScripts()
- const { render: { crossorigin } } = this.options
- if (!crossorigin) {
- return scripts
- }
- return scripts.replace(
- /`
- }
-
- // Calculate CSP hashes
- const cspScriptSrcHashes = []
- if (csp) {
- if (shouldHashCspScriptSrc) {
- const hash = crypto.createHash(csp.hashAlgorithm)
- hash.update(serializedSession)
- cspScriptSrcHashes.push(`'${csp.hashAlgorithm}-${hash.digest('base64')}'`)
- }
-
- // Call ssr:csp hook
- await this.serverContext.nuxt.callHook('vue-renderer:ssr:csp', cspScriptSrcHashes)
-
- // Add csp meta tags
- if (csp.addMeta) {
- HEAD += `()
+
+ // Resolve global CSS paths from nuxt.options.css
+ for (const css of ctx.options.css) {
+ if (typeof css === 'string') {
+ const resolved = resolveAlias(css, ctx.options.alias)
+ globalCSSPaths.add(normalize(resolved))
+ }
+ }
+
+ if (globalCSSPaths.size > 0) {
+ ctx.config.optimization ||= {}
+ ctx.config.optimization.splitChunks ||= {}
+ ctx.config.optimization.splitChunks.cacheGroups ||= {}
+
+ ctx.config.optimization.splitChunks.cacheGroups.nuxtGlobalCSS = {
+ name: 'nuxt-global-css',
+ chunks: 'all',
+ enforce: true,
+ test: (module: Module) => {
+ if (module.type !== 'css/mini-extract') { return false }
+ const identifier = normalize(module.identifier())
+ for (const globalPath of globalCSSPaths) {
+ if (identifier.includes(globalPath)) {
+ return true
+ }
+ }
+ return false
+ },
+ }
+ }
+}
+
+function clientPlugins (ctx: WebpackConfigContext) {
+ // webpack Bundle Analyzer
+ // https://github.com/webpack/webpack-bundle-analyzer
+ if (!ctx.isDev && !ctx.nuxt.options.test && ctx.name === 'client' && ctx.userConfig.analyze && (ctx.userConfig.analyze === true || ctx.userConfig.analyze.enabled)) {
+ const statsDir = resolve(ctx.options.analyzeDir)
+
+ ctx.config.plugins!.push(new BundleAnalyzerPlugin({
+ analyzerMode: 'static',
+ defaultSizes: 'gzip',
+ generateStatsFile: true,
+ openAnalyzer: true,
+ reportFilename: resolve(statsDir, `${ctx.name}.html`),
+ statsFilename: resolve(statsDir, `${ctx.name}.json`),
+ ...ctx.userConfig.analyze === true ? {} : ctx.userConfig.analyze,
+ }))
+ }
+
+ // Normally type checking runs in server config, but in `ssr: false` there is
+ // no server build, so we inject here instead.
+ if (!ctx.nuxt.options.ssr) {
+ if (!ctx.nuxt.options.test && (ctx.nuxt.options.typescript.typeCheck === true || (ctx.nuxt.options.typescript.typeCheck === 'build' && !ctx.nuxt.options.dev))) {
+ ctx.config.plugins!.push(new TsCheckerPlugin({
+ logger,
+ }))
+ }
+ }
+}
diff --git a/packages/webpack/src/configs/index.ts b/packages/webpack/src/configs/index.ts
new file mode 100644
index 000000000000..81246fafb2ae
--- /dev/null
+++ b/packages/webpack/src/configs/index.ts
@@ -0,0 +1,2 @@
+export { client } from './client.ts'
+export { server } from './server.ts'
diff --git a/packages/webpack/src/configs/server.ts b/packages/webpack/src/configs/server.ts
new file mode 100644
index 000000000000..b84d0389e9f8
--- /dev/null
+++ b/packages/webpack/src/configs/server.ts
@@ -0,0 +1,157 @@
+import { isAbsolute, normalize, resolve } from 'pathe'
+import { directoryToURL, logger, resolveAlias } from '@nuxt/kit'
+import { parseNodeModulePath } from 'mlly'
+import { resolveModulePath } from 'exsolve'
+import type { WebpackConfigContext } from '../utils/config.ts'
+import { applyPresets } from '../utils/config.ts'
+import { nuxt } from '../presets/nuxt.ts'
+import { node } from '../presets/node.ts'
+import { TsCheckerPlugin, webpack } from '#builder'
+
+const assetPattern = /\.(?:css|s[ca]ss|png|jpe?g|gif|svg|woff2?|eot|ttf|otf|webp|webm|mp4|ogv)(?:\?.*)?$/i
+const VIRTUAL_RE = /^\0?virtual:(?:nuxt:)?/
+
+export async function server (ctx: WebpackConfigContext) {
+ ctx.name = 'server'
+ ctx.isServer = true
+
+ await applyPresets(ctx, [
+ nuxt,
+ node,
+ serverStandalone,
+ serverPreset,
+ serverPlugins,
+ ])
+}
+
+function serverPreset (ctx: WebpackConfigContext) {
+ ctx.config.output!.filename = 'server.mjs'
+
+ if (ctx.nuxt.options.sourcemap.server) {
+ const prefix = ctx.nuxt.options.sourcemap.server === 'hidden' ? 'hidden-' : ''
+ ctx.config.devtool = prefix + (ctx.isDev ? 'cheap-module-source-map' : 'source-map')
+ } else {
+ ctx.config.devtool = false
+ }
+
+ ctx.config.optimization = {
+ splitChunks: false,
+ minimize: false,
+ }
+
+ if (ctx.isDev) {
+ ctx.config.output!.asyncChunks = false
+ }
+}
+
+function serverStandalone (ctx: WebpackConfigContext) {
+ // TODO: Refactor this out of webpack
+ const inline = [
+ 'src/',
+ '#app',
+ 'nuxt',
+ 'nuxt3',
+ 'nuxt-nightly',
+ '!',
+ '-!',
+ '~',
+ '@/',
+ '#',
+ ...ctx.options.build.transpile,
+ ]
+
+ const external = new Set([
+ 'nitro/runtime-config',
+ // TODO: remove in v5
+ '#internal/nitro',
+ 'nitropack/runtime',
+ '#shared',
+ resolve(ctx.nuxt.options.rootDir, ctx.nuxt.options.dir.shared),
+ ...ctx.nuxt['~runtimeDependencies'] || [],
+ ])
+ if (!ctx.nuxt.options.dev) {
+ external.add('#internal/nuxt/paths')
+ external.add('#internal/nuxt/app-config')
+ external.add('#app-manifest')
+ }
+
+ if (!Array.isArray(ctx.config.externals)) { return }
+
+ // Resolve conditions for server build
+ const conditions = [
+ ctx.nuxt.options.dev ? 'development' : 'production',
+ 'node',
+ 'import',
+ 'require',
+ ]
+
+ ctx.config.externals.push(({ request, context }, cb) => {
+ if (!request) {
+ return cb(undefined, false)
+ }
+ if (external.has(request)) {
+ // Resolve to absolute path so nitro can handle version resolution
+ const resolved = resolveModulePath(request, {
+ from: context ? [context, ...ctx.nuxt.options.modulesDir].map(d => directoryToURL(d)) : ctx.nuxt.options.modulesDir.map(d => directoryToURL(d)),
+ suffixes: ['', 'index'],
+ conditions,
+ try: true,
+ })
+ if (resolved && isAbsolute(resolved)) {
+ return cb(undefined, resolved)
+ }
+ return cb(undefined, true)
+ }
+ if (
+ request[0] === '.' ||
+ isAbsolute(request) ||
+ inline.find(prefix => typeof prefix === 'string' && request.startsWith(prefix)) ||
+ assetPattern.test(request)
+ ) {
+ // console.log('Inline', request)
+ return cb(undefined, false)
+ }
+
+ if (context && request && !request.startsWith('node:') && (isAbsolute(context) || VIRTUAL_RE.test(context))) {
+ try {
+ const normalisedRequest = resolveAlias(normalize(request), ctx.nuxt.options.alias)
+ const dir = parseNodeModulePath(context).dir || ctx.nuxt.options.rootDir
+
+ const resolved = resolveModulePath(normalisedRequest, {
+ from: [dir, ...ctx.nuxt.options.modulesDir].map(d => directoryToURL(d)),
+ suffixes: ['', 'index'],
+ conditions,
+ try: true,
+ })
+
+ if (resolved && isAbsolute(resolved)) {
+ return cb(undefined, false)
+ }
+ } catch {
+ // Ignore resolution errors, fall through to externalize
+ }
+ }
+
+ // console.log('Ext', request)
+ return cb(undefined, true)
+ })
+}
+
+function serverPlugins (ctx: WebpackConfigContext) {
+ ctx.config.plugins ||= []
+
+ // Server polyfills
+ if (ctx.userConfig.serverURLPolyfill) {
+ ctx.config.plugins.push(new webpack.ProvidePlugin({
+ URL: [ctx.userConfig.serverURLPolyfill, 'URL'],
+ URLSearchParams: [ctx.userConfig.serverURLPolyfill, 'URLSearchParams'],
+ }))
+ }
+
+ // Add type-checking
+ if (!ctx.nuxt.options.test && (ctx.nuxt.options.typescript.typeCheck === true || (ctx.nuxt.options.typescript.typeCheck === 'build' && !ctx.nuxt.options.dev))) {
+ ctx.config.plugins!.push(new TsCheckerPlugin({
+ logger,
+ }))
+ }
+}
diff --git a/packages/webpack/src/index.js b/packages/webpack/src/index.js
deleted file mode 100644
index 80ab70900192..000000000000
--- a/packages/webpack/src/index.js
+++ /dev/null
@@ -1 +0,0 @@
-export { WebpackBundler as BundleBuilder } from './builder'
diff --git a/packages/webpack/src/index.ts b/packages/webpack/src/index.ts
new file mode 100644
index 000000000000..09c7b6305b6d
--- /dev/null
+++ b/packages/webpack/src/index.ts
@@ -0,0 +1 @@
+export { bundle } from './webpack.ts'
diff --git a/packages/webpack/src/loaders/vue-module-identifier.ts b/packages/webpack/src/loaders/vue-module-identifier.ts
new file mode 100644
index 000000000000..c3446af03bf5
--- /dev/null
+++ b/packages/webpack/src/loaders/vue-module-identifier.ts
@@ -0,0 +1,26 @@
+import type { LoaderDefinitionFunction } from 'webpack'
+import { normalize, relative } from 'pathe'
+
+interface LoaderOptions {
+ srcDir?: string
+}
+
+const vueModuleIdentifierLoader: LoaderDefinitionFunction = function (source) {
+ this.cacheable?.()
+
+ const { srcDir } = this.getOptions() || {}
+
+ const resourcePath = this.resourcePath || this._module?.resource
+ if (!resourcePath || !source.includes('__exports__')) {
+ return source
+ }
+
+ const context = srcDir || this.rootContext || this.context || this._compiler?.options?.context
+ const relativePath = context ? relative(context, resourcePath) : resourcePath
+ const moduleId = normalize(relativePath).replace(/^\.\//, '').replace(/\\/g, '/')
+
+ const snippet = `\n;__exports__.__moduleIdentifier = ${JSON.stringify(moduleId)};`
+ return source + snippet
+}
+
+export default vueModuleIdentifierLoader
diff --git a/packages/webpack/src/plugins/chunk.ts b/packages/webpack/src/plugins/chunk.ts
new file mode 100644
index 000000000000..6384d3a0b0ad
--- /dev/null
+++ b/packages/webpack/src/plugins/chunk.ts
@@ -0,0 +1,42 @@
+import type { Compiler } from 'webpack'
+import { webpack } from '#builder'
+
+const pluginName = 'ChunkErrorPlugin'
+
+export class ChunkErrorPlugin {
+ apply (compiler: Compiler) {
+ compiler.hooks.thisCompilation.tap(pluginName, (compilation) => {
+ compilation.hooks.runtimeRequirementInTree
+ .for(webpack.RuntimeGlobals.ensureChunk)
+ .tap(pluginName, (chunk) => {
+ compilation.addRuntimeModule(
+ chunk,
+ new ChunkErrorRuntimeModule(),
+ )
+ })
+ })
+ }
+}
+
+class ChunkErrorRuntimeModule extends webpack.RuntimeModule {
+ constructor () {
+ super('chunk preload error handler', webpack.RuntimeModule.STAGE_ATTACH)
+ }
+
+ override generate () {
+ const { ensureChunk } = webpack.RuntimeGlobals
+ return `
+if (typeof ${ensureChunk} !== "undefined") {
+ var _ensureChunk = ${ensureChunk};
+ ${ensureChunk} = function (chunkId) {
+ return Promise.resolve(_ensureChunk(chunkId)).catch(function(error) {
+ var e = new Event('nuxt:preloadError', { cancelable: true });
+ e.payload = error;
+ window.dispatchEvent(e);
+ throw error;
+ });
+ };
+}
+`
+ }
+}
diff --git a/packages/webpack/src/plugins/dynamic-base.ts b/packages/webpack/src/plugins/dynamic-base.ts
new file mode 100644
index 000000000000..aa6187ba2835
--- /dev/null
+++ b/packages/webpack/src/plugins/dynamic-base.ts
@@ -0,0 +1,22 @@
+import { createUnplugin } from 'unplugin'
+import { generateTransform, rolldownString } from 'rolldown-string'
+
+const ENTRY_RE = /import ["']#build\/css["'];/
+
+export const DynamicBasePlugin = createUnplugin(() => {
+ return {
+ name: 'nuxt:dynamic-base-path',
+ enforce: 'post' as const,
+ transform: {
+ filter: {
+ id: { include: /entry/ },
+ code: { include: ENTRY_RE },
+ },
+ handler (code, id, meta?: unknown) {
+ const s = rolldownString(code, id, meta)
+ s.prepend(`import { buildAssetsURL } from '#internal/nuxt/paths';\n__webpack_public_path__ = buildAssetsURL();\n`)
+ return generateTransform(s, id)
+ },
+ },
+ }
+})
diff --git a/packages/webpack/src/plugins/rollup-compat-dynamic-import.ts b/packages/webpack/src/plugins/rollup-compat-dynamic-import.ts
new file mode 100644
index 000000000000..c1b5d06eb31b
--- /dev/null
+++ b/packages/webpack/src/plugins/rollup-compat-dynamic-import.ts
@@ -0,0 +1,133 @@
+import { genObjectFromRawEntries, genString } from 'knitwork'
+import type { Compilation, Compiler, WebpackPluginInstance } from 'webpack'
+import { isJS } from './vue/util.ts'
+
+const DYNAMIC_IMPORT_RE = /import\([^)]*\+\s*__webpack_require__[^+]*\)\.then/
+const DYNAMIC_IMPORT_REPLACE_RE = /import\([^)]*\+\s*(__webpack_require__[^+]*)\)\.then/g
+const HELPER_FILENAME = '_dynamic-import-helper.mjs'
+const HELPER_IMPORT = `import { _rollupDynamicImport } from "./${HELPER_FILENAME}";\n`
+
+/**
+ * Webpack plugin that generates rollup-compatible dynamic imports.
+ * This plugin uses webpack's native compilation hooks to override dynamic import generation
+ * and create rollup-compatible code directly during webpack's compilation process.
+ */
+export class RollupCompatDynamicImportPlugin implements WebpackPluginInstance {
+ apply (compiler: Compiler) {
+ compiler.hooks.compilation.tap('RollupCompatDynamicImportPlugin', (compilation) => {
+ compilation.hooks.processAssets.tapAsync({
+ name: 'RollupCompatDynamicImportPlugin',
+ stage: compiler.webpack.Compilation.PROCESS_ASSETS_STAGE_OPTIMIZE_INLINE,
+ }, (assets, callback) => {
+ try {
+ const targetFiles = new Set()
+
+ for (const chunk of compilation.chunks) {
+ // Include entry chunks and runtime chunks as they contain webpack runtime
+ if (chunk.canBeInitial() || chunk.hasRuntime()) {
+ for (const file of chunk.files || []) {
+ targetFiles.add(file)
+ }
+ }
+ }
+
+ // Transform JavaScript files that contain dynamic imports
+ for (const [filename, asset] of Object.entries(assets)) {
+ if (!isJS(filename)) {
+ continue
+ }
+
+ // Skip non-target chunks to improve performance
+ if (!targetFiles.has(filename)) {
+ continue
+ }
+
+ const source = asset.source()
+ const originalCode = typeof source === 'string' ? source : source.toString()
+
+ if (!DYNAMIC_IMPORT_RE.test(originalCode)) {
+ continue
+ }
+
+ // Transform dynamic imports in this file
+ const transformedCode = this.transformDynamicImports(originalCode)
+
+ if (transformedCode !== originalCode) {
+ assets[filename] = new compiler.webpack.sources.RawSource(transformedCode)
+ }
+ }
+
+ // Generate helper file
+ this.generateDynamicImportHelper(compilation)
+ callback()
+ } catch (error) {
+ callback(error as Error)
+ }
+ },
+ )
+ })
+ }
+
+ private transformDynamicImports (source: string): string {
+ let transformed = source
+ let needsHelperImport = false
+
+ // Transform webpack-style dynamic imports to rollup-compatible ones
+ transformed = transformed.replace(DYNAMIC_IMPORT_REPLACE_RE, (match, filename) => {
+ needsHelperImport = true
+ // Generate a rollup-compatible dynamic import using the module ID
+ return `_rollupDynamicImport(${filename}).then`
+ })
+
+ // Add import statement at the top if we made any transformations
+ if (needsHelperImport && !transformed.includes(HELPER_IMPORT)) {
+ transformed = HELPER_IMPORT + transformed
+ }
+
+ return transformed
+ }
+
+ private generateDynamicImportHelper (compilation: Compilation) {
+ const chunkFiles: string[] = []
+ for (const chunk of compilation.chunks) {
+ // Skip runtime chunks as they don't contain loadable modules
+ if (chunk.hasRuntime()) {
+ continue
+ }
+
+ for (const filename of chunk.files) {
+ if (filename && isJS(filename)) {
+ chunkFiles.push(filename)
+ }
+ }
+ }
+
+ if (chunkFiles.length === 0) {
+ return
+ }
+
+ // Generate the helper that provides rollup-compatible dynamic imports
+ const helperContent = this.generateHelperContent(chunkFiles)
+ compilation.emitAsset(HELPER_FILENAME, new compilation.compiler.webpack.sources.RawSource(helperContent))
+ }
+
+ private generateHelperContent (chunkFiles: string[]): string {
+ return `
+// Rollup-compatible dynamic import helper generated by webpack
+// This helper enables rollup to consume webpack chunks directly
+
+const chunkMap = ${genObjectFromRawEntries(chunkFiles.map(filename => [filename, `() => import(${genString('./' + filename)})`]))}
+
+// Dynamic import function that rollup can understand
+export function _rollupDynamicImport(chunkId) {
+ const chunk = chunkMap[chunkId]
+ if (!chunk) {
+ return Promise.reject(new Error(\`Chunk \${chunkId} not found in chunkMap. Available chunks: \${Object.keys(chunkMap).join(', ')}\`))
+ }
+
+ // Use actual dynamic import for the chunk
+ return chunk()
+}
+`
+ }
+}
diff --git a/packages/webpack/src/plugins/ssr-styles.ts b/packages/webpack/src/plugins/ssr-styles.ts
new file mode 100644
index 000000000000..39547d545132
--- /dev/null
+++ b/packages/webpack/src/plugins/ssr-styles.ts
@@ -0,0 +1,494 @@
+import { existsSync, readFileSync } from 'node:fs'
+import { createRequire } from 'node:module'
+import { isAbsolute, normalize, relative, resolve } from 'pathe'
+import { withTrailingSlash } from 'ufo'
+import { genArrayFromRaw, genObjectFromRawEntries } from 'knitwork'
+import type { Nuxt } from '@nuxt/schema'
+import { resolveAlias, useNitro } from '@nuxt/kit'
+import { parseModuleId } from '../../../nuxt/src/core/utils/plugins.ts'
+import type { Compilation, Compiler, Module, NormalModule } from 'webpack'
+import type { CssModule } from 'mini-css-extract-plugin'
+import { compileStyle, parse } from '@vue/compiler-sfc'
+import { createHash } from 'node:crypto'
+
+const CSS_URL_RE = /url\((['"]?)(\/[^)]+?)\1\)/g
+
+const isVueFile = (id: string) => /\.vue(?:\?|$)/.test(id)
+const isCSSLike = (name: string) => /\.(?:css|scss|sass|less|styl(?:us)?|postcss|pcss)(?:\?|$)/.test(name)
+
+function normalizePath (nuxt: Nuxt, id?: string | null): string | null {
+ if (!id) { return null }
+ const { pathname } = parseModuleId(id)
+ const rel = relative(nuxt.options.srcDir, pathname)
+ if (rel.startsWith('..')) { return null }
+ return rel
+}
+
+function resolveFilePath (id?: string | null): string | null {
+ if (!id) { return null }
+ return parseModuleId(normalize(id)).pathname || null
+}
+
+function sanitizeStyleAssetName (rel: string) {
+ return rel.replace(/[\\/]/g, '_').replace(/\.{2,}/g, '_')
+}
+
+function normalizeCSSContent (css: string) {
+ return css
+ .trim()
+ .replace(/(--[^:]+):\s*'([^']*)'/g, '$1:"$2"')
+ .replace(/:\s+/g, ':')
+ .replace(/\s*\{\s*/g, '{')
+ .replace(/;\s*\}/g, '}')
+ .replace(/\s*\}\s*/g, '}')
+}
+
+// Fallback to extract styles directly from .vue files
+// (for server-only components not in client build)
+// Uses vue-compiler-sfc to properly process scoped styles
+function extractVueStyles (filePath: string): string[] {
+ try {
+ const src = readFileSync(filePath, 'utf8')
+ const { descriptor } = parse(src, { filename: filePath })
+ const styles: string[] = []
+
+ // Generate scope ID using the same format as vue-loader (8-char hex hash)
+ const scopeId = createHash('sha256').update(filePath).digest('hex').slice(0, 8)
+
+ for (let i = 0; i < descriptor.styles.length; i++) {
+ const style = descriptor.styles[i]!
+ const result = compileStyle({
+ source: style.content,
+ filename: filePath,
+ id: `data-v-${scopeId}`,
+ scoped: style.scoped,
+ })
+
+ if (!result.errors.length && result.code) {
+ styles.push(normalizeCSSContent(result.code))
+ }
+ }
+
+ return styles
+ } catch {
+ return []
+ }
+}
+
+export class SSRStylesPlugin {
+ private nuxt: Nuxt
+ private clientCSSByIssuer = new Map>()
+ private chunksWithInlinedCSS = new Set()
+ private globalCSSPaths = new Set()
+
+ constructor (nuxt: Nuxt) {
+ this.nuxt = nuxt
+ this.globalCSSPaths = this.resolveGlobalCSS()
+
+ // Remove CSS entries from manifest for global CSS and files that will have inlined styles
+ nuxt.hook('build:manifest', (manifest) => {
+ for (const [id, chunk] of Object.entries(manifest)) {
+ if (chunk.isEntry && chunk.src) {
+ // Track entry modules
+ this.chunksWithInlinedCSS.add(chunk.src)
+ } else if (this.chunksWithInlinedCSS.has(id)) {
+ // Remove CSS for chunks with inlined styles
+ chunk.css &&= []
+ }
+
+ // Remove global CSS from all chunks
+ if (chunk.css?.length) {
+ chunk.css = chunk.css.filter((cssPath) => {
+ // Check if this CSS file corresponds to a global CSS module
+ for (const globalPath of this.globalCSSPaths) {
+ if (cssPath.includes(globalPath.split('/').pop() || '')) {
+ return false
+ }
+ }
+ return true
+ })
+ }
+ }
+ })
+ }
+
+ private shouldInline (mod: Module) {
+ const shouldInline = this.nuxt.options.features.inlineStyles
+ if (typeof shouldInline === 'boolean') {
+ return shouldInline
+ }
+ return shouldInline(mod.identifier())
+ }
+
+ private escapeTemplateLiteral (str: string) {
+ return str.replace(/[`\\$]/g, m => m === '$' ? '\\$' : `\\${m}`)
+ }
+
+ private isBuildAsset (url: string) {
+ const buildDir = withTrailingSlash(this.nuxt.options.app.buildAssetsDir || '/_nuxt/')
+ return url.startsWith(buildDir)
+ }
+
+ private isPublicAsset (url: string, nitro: ReturnType) {
+ const cleaned = url.replace(/[?#].*$/, '')
+ for (const dir of nitro.options.publicAssets) {
+ const base = withTrailingSlash(dir.baseURL || '/')
+ if (!url.startsWith(base)) { continue }
+ const path = cleaned.replace(base, withTrailingSlash(dir.dir))
+ if (existsSync(path)) {
+ return true
+ }
+ }
+ return false
+ }
+
+ private rewriteStyle (css: string, nitro: ReturnType) {
+ let changed = false
+ let needsPublicAsset = false
+ let needsBuildAsset = false
+ let lastIndex = 0
+ let out = '`'
+
+ for (const match of css.matchAll(CSS_URL_RE)) {
+ const index = match.index ?? 0
+ const before = css.slice(lastIndex, index)
+ if (before) {
+ out += this.escapeTemplateLiteral(before)
+ }
+
+ const full = match[0]
+ const rawUrl = match[2] || ''
+ const stripped = rawUrl.replace(/[?#].*$/, '')
+
+ if (this.isPublicAsset(stripped, nitro)) {
+ needsPublicAsset = true
+ changed = true
+ out += '${publicAssetsURL(' + JSON.stringify(rawUrl) + ')}'
+ } else if (this.isBuildAsset(stripped)) {
+ needsBuildAsset = true
+ changed = true
+ out += '${buildAssetsURL(' + JSON.stringify(rawUrl) + ')}'
+ } else {
+ out += this.escapeTemplateLiteral(full)
+ }
+
+ lastIndex = index + full.length
+ }
+
+ const tail = css.slice(lastIndex)
+ if (tail) {
+ out += this.escapeTemplateLiteral(tail)
+ }
+ out += '`'
+
+ return {
+ code: changed ? out : JSON.stringify(css),
+ needsPublicAsset,
+ needsBuildAsset,
+ }
+ }
+
+ private resolveGlobalCSS (): Set {
+ const req = createRequire(this.nuxt.options.rootDir)
+ const resolved = new Set()
+ const entries = (this.nuxt.options.css as GlobalCSSEntry[] | undefined) || []
+
+ for (const entry of entries) {
+ const src = typeof entry === 'string' ? entry : entry?.src
+ if (!src) { continue }
+ const path = this.resolveCSSRequest(src, req)
+ if (path) {
+ resolved.add(path)
+ }
+ }
+
+ return resolved
+ }
+
+ private resolveCSSRequest (request: string, req: ReturnType): string | null {
+ const candidates = new Set()
+
+ const resolved = resolveAlias(request, this.nuxt.options.alias)
+ if (isAbsolute(resolved)) {
+ candidates.add(resolved)
+ } else {
+ candidates.add(resolve(this.nuxt.options.srcDir, resolved))
+ }
+
+ try {
+ candidates.add(req.resolve(request))
+ } catch {
+ // ignore modules that can't be found
+ }
+
+ for (const candidate of candidates) {
+ const path = resolveFilePath(candidate)
+ if (path) {
+ return path
+ }
+ }
+
+ return null
+ }
+
+ apply (compiler: Compiler) {
+ if (this.nuxt.options.dev) { return }
+ const isClient = compiler.options.name === 'client'
+ const isServer = compiler.options.name === 'server'
+ if (!isClient && !isServer) { return }
+
+ compiler.hooks.thisCompilation.tap('SSRStylesPlugin', (compilation) => {
+ // Server build may have server-only components (islands) not in client build
+ this.collectCSS(compilation)
+
+ if (isClient) {
+ this.removeGlobalCSSFromClient(compilation)
+ }
+
+ if (isServer) {
+ this.emitServerStyles(compilation)
+ }
+ })
+ }
+
+ private emitServerStyles (compilation: Compilation) {
+ const { webpack } = compilation.compiler
+ const stage = webpack.Compilation.PROCESS_ASSETS_STAGE_SUMMARIZE
+ compilation.hooks.processAssets.tap({ name: 'SSRStylesPlugin', stage }, () => {
+ const nitro = useNitro()
+ // Start with client CSS as baseline, then add server-specific CSS from bundle parsing
+ // Client CSS includes styles from mini-css-extract-plugin that may not appear in server bundle
+ const collected = new Map>(this.clientCSSByIssuer)
+
+ // Collect entry module IDs first (including CSS files and Vue files)
+ const entryModules = new Set()
+ for (const entrypoint of compilation.entrypoints.values()) {
+ const primaryChunk = typeof entrypoint.getEntrypointChunk === 'function' ? entrypoint.getEntrypointChunk() : undefined
+ const chunks = primaryChunk ? [primaryChunk] : entrypoint.chunks
+ for (const chunk of chunks) {
+ for (const mod of compilation.chunkGraph.getChunkModulesIterable(chunk)) {
+ if ('resource' in mod && typeof mod.resource === 'string') {
+ // For entry modules, use resolveFilePath to get the absolute path
+ const resolved = resolveFilePath(mod.resource)
+ if (resolved) {
+ // Try normalized path first (relative to srcDir)
+ const rel = normalizePath(this.nuxt, resolved)
+ if (rel) {
+ entryModules.add(rel)
+ } else {
+ // For files outside srcDir, use the absolute path
+ entryModules.add(resolved)
+ }
+ }
+ }
+ }
+ }
+ }
+
+ // Fallback: extract styles from server-only Vue components
+ for (const module of compilation.modules) {
+ const normal = module as NormalModule
+ const resource = normal.resource
+ if (!resource || !isVueFile(resource)) { continue }
+ const rel = normalizePath(this.nuxt, resource)
+ if (!rel) { continue }
+ if (collected.has(rel)) { continue }
+
+ const vueStyles = extractVueStyles(resolveFilePath(resource) || resource)
+ if (vueStyles.length) {
+ collected.set(rel, new Set(vueStyles))
+ }
+ }
+
+ const emitted: Record = {}
+ const rawSource = webpack.sources.RawSource
+
+ for (const [rel, cssSet] of collected.entries()) {
+ if (!cssSet.size) { continue }
+ const stylesArray = Array.from(cssSet)
+ const transformed = stylesArray.map(style => this.rewriteStyle(style, nitro))
+ const needsPublicAssets = transformed.some(t => t.needsPublicAsset)
+ const needsBuildAssets = transformed.some(t => t.needsBuildAsset)
+ const imports: string[] = []
+ if (needsPublicAssets || needsBuildAssets) {
+ const names = [] as string[]
+ if (needsBuildAssets) { names.push('buildAssetsURL') }
+ if (needsPublicAssets) { names.push('publicAssetsURL') }
+ imports.push(`import { ${names.join(', ')} } from '#internal/nuxt/paths'`)
+ }
+ const moduleSource = [
+ ...imports,
+ `export default ${genArrayFromRaw(transformed.map(t => t.code))}`,
+ ].filter(Boolean).join('\n')
+ const styleModuleName = `${sanitizeStyleAssetName(rel)}-styles.mjs`
+ compilation.emitAsset(styleModuleName, new rawSource(moduleSource))
+ emitted[rel] = styleModuleName
+ this.chunksWithInlinedCSS.add(rel)
+ }
+
+ const stylesSource = [
+ 'const interopDefault = r => r.default || r || []',
+ `export default ${genObjectFromRawEntries(
+ Object.entries(emitted).map(([key, value]) => [key, `() => import('./${value}').then(interopDefault)`]) as [string, string][],
+ )}`,
+ ].join('\n')
+
+ compilation.emitAsset('styles.mjs', new rawSource(stylesSource))
+
+ const entryIds = Array.from(this.chunksWithInlinedCSS).filter(id => entryModules.has(id))
+ nitro.options.virtual['#internal/nuxt/entry-ids.mjs'] = () => `export default ${JSON.stringify(entryIds)}`
+ nitro.options._config.virtual ||= {}
+ nitro.options._config.virtual['#internal/nuxt/entry-ids.mjs'] = nitro.options.virtual['#internal/nuxt/entry-ids.mjs']
+ })
+ }
+
+ private findIssuerPath (compilation: Compilation, mod: Module): string | null {
+ let issuer: Module | null | undefined = compilation.moduleGraph.getIssuer(mod)
+ while (issuer) {
+ if ('resource' in issuer && typeof issuer.resource === 'string') {
+ return issuer.resource
+ }
+ issuer = compilation.moduleGraph.getIssuer(issuer)
+ }
+ return null
+ }
+
+ private removeGlobalCSSFromClient (compilation: Compilation) {
+ // this runs at stage 650, before the main CSS collection at stage 700.
+ const stage = 650
+
+ compilation.hooks.processAssets.tap({ name: 'SSRStylesPlugin:RemoveGlobalCSS', stage }, () => {
+ for (const chunk of compilation.chunks) {
+ if (chunk.name === 'nuxt-global-css') {
+ // collect CSS from this chunk before deleting
+ const cssAssets: string[] = []
+ for (const file of Array.from(chunk.files)) {
+ const filename = String(file)
+ if (isCSSLike(filename)) {
+ const asset = compilation.getAsset(filename)
+ const source = asset?.source
+ const content = source && typeof source.source === 'function' ? source.source() : null
+ const text = typeof content === 'string' ? content : (content instanceof Buffer ? content.toString('utf8') : '')
+ if (text) {
+ cssAssets.push(text)
+ }
+ }
+ }
+
+ // store CSS for all modules in this chunk
+ if (cssAssets.length > 0) {
+ for (const mod of compilation.chunkGraph.getChunkModulesIterable(chunk)) {
+ const issuerPath = this.findIssuerPath(compilation, mod) || ('resource' in mod && typeof mod.resource === 'string' ? mod.resource : null)
+ const normalized = normalizePath(this.nuxt, issuerPath)
+ if (!normalized) { continue }
+ const set = this.clientCSSByIssuer.get(normalized) || new Set()
+ for (const css of cssAssets) {
+ set.add(normalizeCSSContent(css))
+ }
+ this.clientCSSByIssuer.set(normalized, set)
+ }
+ }
+
+ // delete the CSS files from the client build
+ for (const file of Array.from(chunk.files)) {
+ const filename = String(file)
+ if (isCSSLike(filename)) {
+ compilation.deleteAsset(filename)
+ chunk.files.delete(file)
+ }
+ }
+ }
+ }
+ })
+ }
+
+ private collectCSS (compilation: Compilation) {
+ const { webpack } = compilation.compiler
+ const isServer = compilation.compiler.options.name === 'server'
+ const stage = isServer
+ ? webpack.Compilation.PROCESS_ASSETS_STAGE_ADDITIONS
+ : webpack.Compilation.PROCESS_ASSETS_STAGE_OPTIMIZE_TRANSFER
+
+ const chunkCSSMeta = new Map()
+
+ compilation.hooks.processAssets.tap({ name: 'SSRStylesPlugin', stage }, () => {
+ // First, associate emitted CSS assets with the modules in their chunks
+ const cssAssetsByChunk = new Map()
+ for (const chunk of compilation.chunks) {
+ const cssAssets: string[] = []
+ const chunkCSSFiles: string[] = []
+ for (const file of chunk.files) {
+ if (!isCSSLike(file)) { continue }
+ chunkCSSFiles.push(file)
+ const asset = compilation.getAsset(file)
+ const source = asset?.source
+ const content = source && typeof source.source === 'function' ? source.source() : null
+ const text = typeof content === 'string' ? content : (content instanceof Buffer ? content.toString('utf8') : '')
+ if (text) {
+ cssAssets.push(text)
+ }
+ }
+ if (chunkCSSFiles.length) {
+ const chunkCSSModules = Array.from(compilation.chunkGraph.getChunkModulesIterable(chunk)) as NormalModule[]
+ chunkCSSMeta.set(chunk, { files: chunkCSSFiles, modules: chunkCSSModules })
+ }
+ if (cssAssets.length) {
+ cssAssetsByChunk.set(chunk, cssAssets)
+ }
+ }
+
+ for (const [chunk, cssAssets] of cssAssetsByChunk) {
+ for (const mod of compilation.chunkGraph.getChunkModulesIterable(chunk)) {
+ if (!this.shouldInline(mod)) {
+ continue
+ }
+ const issuerPath = this.findIssuerPath(compilation, mod) || ('resource' in mod && typeof mod.resource === 'string' ? mod.resource : null)
+ const normalized = normalizePath(this.nuxt, issuerPath)
+ if (!normalized) { continue }
+ const set = this.clientCSSByIssuer.get(normalized) || new Set()
+ for (const css of cssAssets) {
+ set.add(normalizeCSSContent(css))
+ }
+ this.clientCSSByIssuer.set(normalized, set)
+ }
+ }
+
+ for (const mod of compilation.modules) {
+ if (!this.shouldInline(mod)) {
+ continue
+ }
+ const issuerPath = this.findIssuerPath(compilation, mod)
+ const normalized = normalizePath(this.nuxt, issuerPath)
+ if (!normalized) {
+ continue
+ }
+
+ const cssChunks = this.getModuleCSS(mod, compilation)
+
+ if (!cssChunks.length) { continue }
+ const set = this.clientCSSByIssuer.get(normalized) || new Set()
+ set.add(cssChunks.join('\n'))
+ this.clientCSSByIssuer.set(normalized, set)
+ }
+ })
+ }
+
+ private getModuleCSS (mod: Module, _compilation: Compilation): string[] {
+ const cssModule = mod as CssModule
+ const cssChunks: string[] = []
+
+ // Extract from mini-css-extract-plugin modules which have processed CSS
+ if (mod.type === 'css/mini-extract' && Array.isArray(cssModule.content)) {
+ for (const part of cssModule.content as Array<[string, string]>) {
+ const css = part?.[1]
+ if (css && typeof css === 'string') {
+ cssChunks.push(normalizeCSSContent(css))
+ }
+ }
+ }
+
+ return cssChunks
+ }
+}
+
+type GlobalCSSEntry = string | { src?: string }
diff --git a/packages/webpack/src/plugins/vue/client.js b/packages/webpack/src/plugins/vue/client.js
deleted file mode 100644
index afa44180a829..000000000000
--- a/packages/webpack/src/plugins/vue/client.js
+++ /dev/null
@@ -1,92 +0,0 @@
-/**
- * This file is based on Vue.js (MIT) webpack plugins
- * https://github.com/vuejs/vue/blob/dev/src/server/webpack-plugin/client.js
- */
-
-import hash from 'hash-sum'
-import uniq from 'lodash/uniq'
-
-import { isJS, isCSS } from './util'
-
-export default class VueSSRClientPlugin {
- constructor (options = {}) {
- this.options = Object.assign({
- filename: null
- }, options)
- }
-
- apply (compiler) {
- compiler.hooks.emit.tapAsync('vue-client-plugin', (compilation, cb) => {
- const stats = compilation.getStats().toJson()
-
- const allFiles = uniq(stats.assets
- .map(a => a.name))
-
- const initialFiles = uniq(Object.keys(stats.entrypoints)
- .map(name => stats.entrypoints[name].assets)
- .reduce((assets, all) => all.concat(assets), [])
- .filter(file => isJS(file) || isCSS(file)))
-
- const asyncFiles = allFiles
- .filter(file => isJS(file) || isCSS(file))
- .filter(file => !initialFiles.includes(file))
-
- const assetsMapping = {}
- stats.assets
- .filter(({ name }) => isJS(name))
- .forEach(({ name, chunkNames }) => {
- assetsMapping[name] = hash(chunkNames.join('|'))
- })
-
- const manifest = {
- publicPath: stats.publicPath,
- all: allFiles,
- initial: initialFiles,
- async: asyncFiles,
- modules: { /* [identifier: string]: Array */ },
- assetsMapping
- }
-
- const assetModules = stats.modules.filter(m => m.assets.length)
- const fileToIndex = file => manifest.all.indexOf(file)
- stats.modules.forEach((m) => {
- // Ignore modules duplicated in multiple chunks
- if (m.chunks.length === 1) {
- const [cid] = m.chunks
- const chunk = stats.chunks.find(c => c.id === cid)
- if (!chunk || !chunk.files) {
- return
- }
- const id = m.identifier.replace(/\s\w+$/, '') // remove appended hash
- const files = manifest.modules[hash(id)] = chunk.files.map(fileToIndex)
-
- // In production mode, modules may be concatenated by scope hoisting
- // Include ConcatenatedModule for not losing module-component mapping
- if (Array.isArray(m.modules)) {
- for (const concatenatedModule of m.modules) {
- const id = hash(concatenatedModule.identifier.replace(/\s\w+$/, ''))
- if (!manifest.modules[id]) {
- manifest.modules[id] = files
- }
- }
- }
-
- // Find all asset modules associated with the same chunk
- assetModules.forEach((m) => {
- if (m.chunks.some(id => id === cid)) {
- files.push.apply(files, m.assets.map(fileToIndex))
- }
- })
- }
- })
-
- const src = JSON.stringify(manifest, null, 2)
-
- compilation.assets[this.options.filename] = {
- source: () => src,
- size: () => src.length
- }
- cb()
- })
- }
-}
diff --git a/packages/webpack/src/plugins/vue/client.ts b/packages/webpack/src/plugins/vue/client.ts
new file mode 100644
index 000000000000..825a02e3f050
--- /dev/null
+++ b/packages/webpack/src/plugins/vue/client.ts
@@ -0,0 +1,180 @@
+/**
+ * This file is based on Vue.js (MIT) webpack plugins
+ * https://github.com/vuejs/vue/blob/dev/src/server/webpack-plugin/client.js
+ */
+
+import { mkdir, writeFile } from 'node:fs/promises'
+
+import { normalizeWebpackManifest, precomputeDependencies } from 'vue-bundle-renderer'
+import { join, normalize, relative, resolve } from 'pathe'
+import { hash } from 'ohash'
+import { serialize } from 'seroval'
+
+import type { Nuxt } from '@nuxt/schema'
+import type { Compilation, Compiler } from 'webpack'
+import { useNitro } from '@nuxt/kit'
+
+import { isCSS, isHotUpdate, isJS } from './util.ts'
+
+interface PluginOptions {
+ nuxt: Nuxt
+}
+
+export default class VueSSRClientPlugin {
+ serverDist: string
+ nuxt: Nuxt
+ precomputedCode = 'export default undefined'
+ manifestCode?: string
+
+ vfs = {
+ 'client.precomputed.mjs': () => this.precomputedCode,
+ 'client.manifest.mjs': () => this.manifestCode,
+ }
+
+ constructor (options: PluginOptions) {
+ this.serverDist = resolve(options.nuxt.options.buildDir, 'dist/server')
+ this.nuxt = options.nuxt
+
+ const nitro = useNitro()
+ nitro.options.virtual ||= {}
+ nitro.options._config.virtual ||= {}
+
+ for (const key in this.vfs) {
+ const filename = `#build/dist/server/${key}`
+ nitro.options.virtual[filename] = this.vfs[key as keyof typeof this.vfs] as () => string
+ nitro.options._config.virtual[filename] = this.vfs[key as keyof typeof this.vfs] as () => string
+ }
+ }
+
+ private getRelativeModuleId (identifier: string, context: string): string {
+ const id = identifier.replace(/\s\w+$/, '') // remove appended hash
+ // Module identifier format: /path/loaders!resource?query
+ const resourceMatch = id.match(/([^!]*\.vue)(?:\?|$)/)
+ // Extract relative resource path
+ return resourceMatch && resourceMatch[1]
+ ? normalize(relative(context, resourceMatch[1])).replace(/^\.\//, '').replace(/\\/g, '/')
+ : id
+ }
+
+ apply (compiler: Compiler) {
+ compiler.hooks.afterEmit.tap('VueSSRClientPlugin', async (compilation: Compilation) => {
+ const stats = compilation.getStats().toJson({
+ modules: true,
+ assets: true,
+ chunks: true,
+ chunkGroups: true,
+ entrypoints: true,
+ })
+ const context = this.nuxt.options.srcDir
+
+ const initialFiles = new Set()
+ for (const { assets } of Object.values(stats.entrypoints!)) {
+ if (!assets) { continue }
+
+ for (const asset of assets) {
+ const file = asset.name
+ if ((isJS(file) || isCSS(file)) && !isHotUpdate(file)) {
+ initialFiles.add(file)
+ }
+ }
+ }
+
+ const allFiles = new Set()
+ const asyncFiles = new Set()
+ const assetsMapping: Record = {}
+
+ for (const { name: file, chunkNames = [] } of stats.assets!) {
+ if (isHotUpdate(file)) { continue }
+ allFiles.add(file)
+ const isFileJS = isJS(file)
+ if (!initialFiles.has(file) && (isFileJS || isCSS(file))) {
+ asyncFiles.add(file)
+ }
+ if (isFileJS) {
+ const componentHash = hash(chunkNames.join('|'))
+ const map = assetsMapping[componentHash] ||= []
+ map.push(file)
+ }
+ }
+
+ const webpackManifest = {
+ publicPath: stats.publicPath,
+ all: [...allFiles],
+ initial: [...initialFiles],
+ async: [...asyncFiles],
+ modules: { /* [identifier: string]: Array */ } as Record,
+ assetsMapping,
+ }
+
+ const { entrypoints = {}, namedChunkGroups = {} } = stats
+ const fileToIndex = (file: string | number) => webpackManifest.all.indexOf(String(file))
+ for (const m of stats.modules!) {
+ // Ignore modules duplicated in multiple chunks
+ if (m.chunks?.length !== 1) { continue }
+
+ const [cid] = m.chunks
+ const chunk = stats.chunks!.find(c => c.id === cid)
+ if (!chunk || !chunk.files || !cid) {
+ continue
+ }
+ const relativeId = this.getRelativeModuleId(m.identifier!, context)
+
+ const filesSet = new Set()
+ for (const file of chunk.files) {
+ const index = fileToIndex(file)
+ if (index !== -1) {
+ filesSet.add(index)
+ }
+ }
+
+ for (const chunkName of chunk.names!) {
+ if (!entrypoints[chunkName]) {
+ const chunkGroup = namedChunkGroups[chunkName]
+ if (chunkGroup) {
+ for (const asset of chunkGroup.assets!) {
+ filesSet.add(fileToIndex(asset.name))
+ }
+ }
+ }
+ }
+
+ const files = Array.from(filesSet)
+ webpackManifest.modules[relativeId] = files
+
+ // In production mode, modules may be concatenated by scope hoisting
+ // Include ConcatenatedModule for not losing module-component mapping
+ if (Array.isArray(m.modules)) {
+ for (const concatenatedModule of m.modules) {
+ const relativeId = this.getRelativeModuleId(concatenatedModule.identifier!, context)
+ webpackManifest.modules[relativeId] ||= files
+ }
+ }
+
+ // Find all asset modules associated with the same chunk
+ if (stats.modules) {
+ for (const m of stats.modules) {
+ if (m.assets?.length && m.chunks?.includes(cid)) {
+ files.push(...m.assets.map(fileToIndex))
+ }
+ }
+ }
+ }
+
+ const manifest = normalizeWebpackManifest(webpackManifest as any)
+ await this.nuxt.callHook('build:manifest', manifest)
+ this.precomputedCode = 'export default ' + serialize(precomputeDependencies(manifest))
+ this.manifestCode = 'export default ' + serialize(manifest)
+
+ if (!this.nuxt.options.dev && this.nuxt.options.experimental.buildCache) {
+ await mkdir(this.serverDist, { recursive: true })
+ await writeFile(join(this.serverDist, 'client.manifest.mjs'), this.manifestCode, 'utf8')
+ await writeFile(join(this.serverDist, 'client.precomputed.mjs'), this.precomputedCode, 'utf8')
+ }
+
+ // assets[this.options.filename] = {
+ // source: () => src,
+ // size: () => src.length
+ // }
+ })
+ }
+}
diff --git a/packages/webpack/src/plugins/vue/cors.js b/packages/webpack/src/plugins/vue/cors.js
deleted file mode 100644
index 3f0a1948d3c4..000000000000
--- a/packages/webpack/src/plugins/vue/cors.js
+++ /dev/null
@@ -1,23 +0,0 @@
-export default class CorsPlugin {
- constructor ({ crossorigin }) {
- this.crossorigin = crossorigin
- }
-
- apply (compiler) {
- const ID = 'vue-cors-plugin'
- compiler.hooks.compilation.tap(ID, (compilation) => {
- compilation.hooks.htmlWebpackPluginAlterAssetTags.tap(ID, (data) => {
- if (!this.crossorigin) {
- return
- }
- [...data.head, ...data.body].forEach((tag) => {
- if (['script', 'link'].includes(tag.tagName)) {
- if (tag.attributes) {
- tag.attributes.crossorigin = this.crossorigin
- }
- }
- })
- })
- })
- }
-}
diff --git a/packages/webpack/src/plugins/vue/modern.js b/packages/webpack/src/plugins/vue/modern.js
deleted file mode 100644
index 25cb104e78ba..000000000000
--- a/packages/webpack/src/plugins/vue/modern.js
+++ /dev/null
@@ -1,103 +0,0 @@
-/*
-* This file is based on @vue/cli-service (MIT) ModernModePlugin
-* https://github.com/vuejs/vue-cli/blob/dev/packages/@vue/cli-service/lib/webpack/ModernModePlugin.js
-*/
-
-import EventEmitter from 'events'
-import { safariNoModuleFix } from '@nuxt/utils'
-
-const assetsMap = {}
-const watcher = new EventEmitter()
-
-export default class ModernModePlugin {
- constructor ({ targetDir, isModernBuild }) {
- this.targetDir = targetDir
- this.isModernBuild = isModernBuild
- }
-
- apply (compiler) {
- if (!this.isModernBuild) {
- this.applyLegacy(compiler)
- } else {
- this.applyModern(compiler)
- }
- }
-
- set assets ({ name, content }) {
- assetsMap[name] = content
- watcher.emit(name)
- }
-
- getAssets (name) {
- return assetsMap[name] ||
- new Promise((resolve) => {
- watcher.once(name, () => {
- return assetsMap[name] && resolve(assetsMap[name])
- })
- return assetsMap[name] && resolve(assetsMap[name])
- })
- }
-
- applyLegacy (compiler) {
- const ID = 'nuxt-legacy-bundle'
- compiler.hooks.compilation.tap(ID, (compilation) => {
- // For html-webpack-plugin 4.0
- // HtmlWebpackPlugin.getHooks(compilation).alterAssetTags.tapAsync(ID, async (data, cb) => {
- compilation.hooks.htmlWebpackPluginAlterAssetTags.tapAsync(ID, (data, cb) => {
- // get stats, write to disk
- this.assets = {
- name: data.plugin.options.filename,
- content: data.body
- }
-
- cb()
- })
- })
- }
-
- applyModern (compiler) {
- const ID = 'nuxt-modern-bundle'
- compiler.hooks.compilation.tap(ID, (compilation) => {
- // For html-webpack-plugin 4.0
- // HtmlWebpackPlugin.getHooks(compilation).alterAssetTags.tapAsync(ID, async (data, cb) => {
- compilation.hooks.htmlWebpackPluginAlterAssetTags.tapAsync(ID, async (data, cb) => {
- // use
+
+
+
+
+ Nuxt Playground
+
+
+
+
diff --git a/playground/nuxt.config.ts b/playground/nuxt.config.ts
new file mode 100644
index 000000000000..205488c96a83
--- /dev/null
+++ b/playground/nuxt.config.ts
@@ -0,0 +1,4 @@
+export default defineNuxtConfig({
+ devtools: { enabled: true },
+ compatibilityDate: 'latest',
+})
diff --git a/playground/package.json b/playground/package.json
new file mode 100644
index 000000000000..98a3811945c0
--- /dev/null
+++ b/playground/package.json
@@ -0,0 +1,16 @@
+{
+ "name": "nuxt-playground",
+ "private": true,
+ "type": "module",
+ "scripts": {
+ "dev": "nuxt dev",
+ "build": "nuxt build",
+ "start": "nuxt preview"
+ },
+ "dependencies": {
+ "nuxt": "workspace:*"
+ },
+ "engines": {
+ "node": "^22.12.0 || ^24.11.0 || >=26.0.0"
+ }
+}
diff --git a/playground/server/api/test.ts b/playground/server/api/test.ts
new file mode 100644
index 000000000000..16be9e4121da
--- /dev/null
+++ b/playground/server/api/test.ts
@@ -0,0 +1,3 @@
+export default eventHandler((_event) => {
+ return 'Hello!'
+})
diff --git a/playground/tsconfig.json b/playground/tsconfig.json
new file mode 100644
index 000000000000..6ae5970c766b
--- /dev/null
+++ b/playground/tsconfig.json
@@ -0,0 +1,17 @@
+{
+ "files": [],
+ "references": [
+ {
+ "path": "./.nuxt/tsconfig.app.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.server.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.shared.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.node.json"
+ }
+ ]
+}
diff --git a/playwright.config.ts b/playwright.config.ts
new file mode 100644
index 000000000000..c9e8013f3012
--- /dev/null
+++ b/playwright.config.ts
@@ -0,0 +1,87 @@
+import { defineConfig, devices } from '@playwright/test'
+import type { ConfigOptions } from '@nuxt/test-utils/playwright'
+import { isCI, isWindows } from 'std-env'
+import type { MatrixOptions } from './test/e2e/test-utils'
+
+type E2eConfigOptions = ConfigOptions & MatrixOptions
+
+const e2eMatrix = [
+ { builder: 'vite', isDev: true },
+ { builder: 'vite', isDev: false },
+ { builder: 'rspack', isDev: false },
+ { builder: 'webpack', isDev: false },
+] as const
+
+const devOnlyTests = ['**/hmr.test.ts']
+const builtOnlyTests = ['**/spa-preloader-*.test.ts', '**/lazy-hydration.test.ts']
+const viteOnlyTests = ['**/lazy-hydration.test.ts']
+
+function testIgnoreForProject (entry: typeof e2eMatrix[number]) {
+ const ignore: string[] = []
+ if (entry.isDev) {
+ ignore.push(...builtOnlyTests)
+ } else {
+ ignore.push(...devOnlyTests)
+ }
+ if (entry.builder !== 'vite') {
+ ignore.push(...viteOnlyTests)
+ }
+ return ignore
+}
+
+/**
+ * Playwright configuration for Nuxt e2e tests
+ * @see https://playwright.dev/docs/test-configuration
+ */
+export default defineConfig({
+ testDir: './test/e2e',
+ testMatch: '**/*.test.ts',
+ timeout: (isWindows ? 360 : 120) * 1000,
+ fullyParallel: !isCI,
+ forbidOnly: !!isCI,
+ retries: isCI ? 2 : 0,
+ workers: isCI ? 1 : undefined,
+ reporter: 'html',
+ projects: [
+ {
+ name: 'setup fixtures',
+ testMatch: /global\.setup\.ts/,
+ teardown: 'cleanup fixtures',
+ },
+ {
+ name: 'cleanup fixtures',
+ testMatch: /global\.teardown\.ts/,
+ },
+ ...e2eMatrix.map((entry) => {
+ const name = `e2e-${entry.builder}-${entry.isDev ? 'dev' : 'built'}`
+ return {
+ name,
+ testIgnore: testIgnoreForProject(entry),
+ use: {
+ ...devices['Desktop Chrome'],
+ isDev: entry.isDev,
+ isBuilt: !entry.isDev,
+ isWebpack: entry.builder === 'webpack' || entry.builder === 'rspack',
+ builder: entry.builder,
+ defaults: {
+ nuxt: {
+ dev: entry.isDev,
+ nuxtConfig: {
+ builder: entry.builder,
+ devtools: { enabled: false },
+ experimental: {
+ appManifest: true,
+ },
+ },
+ env: {
+ TEST_BUILDER: entry.builder,
+ TEST_ENV: entry.isDev ? 'dev' : 'built',
+ },
+ },
+ },
+ },
+ dependencies: ['setup fixtures'],
+ }
+ }),
+ ],
+})
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
new file mode 100644
index 000000000000..d58a9756eab0
--- /dev/null
+++ b/pnpm-lock.yaml
@@ -0,0 +1,19730 @@
+lockfileVersion: '9.0'
+
+settings:
+ autoInstallPeers: true
+ excludeLinksFromLockfile: false
+
+overrides:
+ '@nuxt/kit': workspace:*
+ '@nuxt/schema': workspace:*
+ nuxt: workspace:*
+ vite: 8.0.12
+ vue: 3.5.34
+
+patchedDependencies:
+ changelogen: 8aee9e31504b2889cfb6b9bae91ba797bea8acef312c723134cb1e70cc7e4c2b
+
+importers:
+
+ .:
+ devDependencies:
+ '@arethetypeswrong/cli':
+ specifier: 0.18.2
+ version: 0.18.2
+ '@babel/core':
+ specifier: 7.29.0
+ version: 7.29.0
+ '@babel/helper-plugin-utils':
+ specifier: 7.28.6
+ version: 7.28.6
+ '@codspeed/core':
+ specifier: 5.4.0
+ version: 5.4.0
+ '@codspeed/vitest-plugin':
+ specifier: 5.4.0
+ version: 5.4.0(tinybench@2.9.0)(vite@8.0.12)(vitest@4.1.7)
+ '@eslint/markdown':
+ specifier: 8.0.1
+ version: 8.0.1
+ '@nuxt/cli':
+ specifier: 3.35.2
+ version: 3.35.2(@nuxt/schema@packages+schema)(magicast@0.5.3)
+ '@nuxt/eslint-config':
+ specifier: 1.15.2
+ version: 1.15.2(@typescript-eslint/utils@8.59.4(eslint@9.39.4(jiti@2.7.0))(typescript@6.0.3))(@vue/compiler-sfc@3.5.34)(eslint@9.39.4(jiti@2.7.0))(typescript@6.0.3)
+ '@nuxt/kit':
+ specifier: workspace:*
+ version: link:packages/kit
+ '@nuxt/rspack-builder':
+ specifier: workspace:*
+ version: link:packages/rspack
+ '@nuxt/test-utils':
+ specifier: 4.0.3
+ version: 4.0.3(@playwright/test@1.60.0)(@testing-library/vue@8.1.0(@vue/compiler-dom@3.5.34)(@vue/compiler-sfc@3.5.34)(@vue/server-renderer@3.5.34(vue@3.5.34(typescript@6.0.3)))(vue@3.5.34(typescript@6.0.3)))(@vue/test-utils@2.4.10(@vue/compiler-dom@3.5.34)(@vue/server-renderer@3.5.34(vue@3.5.34(typescript@6.0.3)))(vue@3.5.34(typescript@6.0.3)))(crossws@0.4.5(srvx@0.11.15))(happy-dom@20.9.0)(magicast@0.5.3)(playwright-core@1.60.0)(typescript@6.0.3)(vite@8.0.12)(vitest@4.1.7)
+ '@nuxt/webpack-builder':
+ specifier: workspace:*
+ version: link:packages/webpack
+ '@playwright/test':
+ specifier: 1.60.0
+ version: 1.60.0
+ '@rspack/core':
+ specifier: 2.0.3
+ version: 2.0.3
+ '@testing-library/vue':
+ specifier: 8.1.0
+ version: 8.1.0(@vue/compiler-dom@3.5.34)(@vue/compiler-sfc@3.5.34)(@vue/server-renderer@3.5.34(vue@3.5.34(typescript@6.0.3)))(vue@3.5.34(typescript@6.0.3))
+ '@types/babel__core':
+ specifier: 7.20.5
+ version: 7.20.5
+ '@types/babel__helper-plugin-utils':
+ specifier: 7.10.3
+ version: 7.10.3
+ '@types/node':
+ specifier: 24.12.4
+ version: 24.12.4
+ '@types/semver':
+ specifier: 7.7.1
+ version: 7.7.1
+ '@typescript-eslint/parser':
+ specifier: 8.59.3
+ version: 8.59.3(eslint@9.39.4(jiti@2.7.0))(typescript@6.0.3)
+ '@unhead/vue':
+ specifier: 3.1.0
+ version: 3.1.0(crossws@0.4.5(srvx@0.11.15))(esbuild@0.28.0)(lightningcss@1.32.0)(rolldown@1.0.2)(typescript@6.0.3)(vite@8.0.12)(vue@3.5.34(typescript@6.0.3))(webpack@5.106.2(esbuild@0.28.0)(lightningcss@1.32.0))
+ '@vitest/coverage-v8':
+ specifier: 4.1.7
+ version: 4.1.7(vitest@4.1.7)
+ '@vue/test-utils':
+ specifier: 2.4.10
+ version: 2.4.10(@vue/compiler-dom@3.5.34)(@vue/server-renderer@3.5.34(vue@3.5.34(typescript@6.0.3)))(vue@3.5.34(typescript@6.0.3))
+ acorn:
+ specifier: 8.16.0
+ version: 8.16.0
+ case-police:
+ specifier: 2.2.1
+ version: 2.2.1
+ changelogen:
+ specifier: 0.6.2
+ version: 0.6.2(patch_hash=8aee9e31504b2889cfb6b9bae91ba797bea8acef312c723134cb1e70cc7e4c2b)(magicast@0.5.3)
+ consola:
+ specifier: 3.4.2
+ version: 3.4.2
+ defu:
+ specifier: 6.1.7
+ version: 6.1.7
+ destr:
+ specifier: 2.0.5
+ version: 2.0.5
+ devalue:
+ specifier: 5.8.1
+ version: 5.8.1
+ eslint:
+ specifier: 9.39.4
+ version: 9.39.4(jiti@2.7.0)
+ eslint-plugin-import-x:
+ specifier: 4.16.2
+ version: 4.16.2(@typescript-eslint/utils@8.59.4(eslint@9.39.4(jiti@2.7.0))(typescript@6.0.3))(eslint@9.39.4(jiti@2.7.0))
+ eslint-plugin-no-only-tests:
+ specifier: 3.4.0
+ version: 3.4.0
+ eslint-plugin-perfectionist:
+ specifier: 5.9.0
+ version: 5.9.0(eslint@9.39.4(jiti@2.7.0))(typescript@6.0.3)
+ eslint-typegen:
+ specifier: 2.3.1
+ version: 2.3.1(eslint@9.39.4(jiti@2.7.0))
+ estree-walker:
+ specifier: 3.0.3
+ version: 3.0.3
+ get-port-please:
+ specifier: 3.2.0
+ version: 3.2.0
+ h3:
+ specifier: 2.0.1-rc.22
+ version: 2.0.1-rc.22(crossws@0.4.5(srvx@0.11.15))
+ happy-dom:
+ specifier: 20.9.0
+ version: 20.9.0
+ installed-check:
+ specifier: 10.0.1
+ version: 10.0.1
+ knip:
+ specifier: 6.14.1
+ version: 6.14.1(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0)
+ magic-regexp:
+ specifier: 0.11.0
+ version: 0.11.0
+ magic-string:
+ specifier: 0.30.21
+ version: 0.30.21
+ markdownlint-cli:
+ specifier: 0.48.0
+ version: 0.48.0
+ memfs:
+ specifier: 4.57.2
+ version: 4.57.2(tslib@2.8.1)
+ nitro:
+ specifier: 3.0.260311-beta
+ version: 3.0.260311-beta(chokidar@5.0.0)(dotenv@17.4.2)(giget@3.2.0)(ioredis@5.10.1)(jiti@2.7.0)(lru-cache@11.5.0)(rollup@4.60.4)(vite@8.0.12)
+ nuxt:
+ specifier: workspace:*
+ version: link:packages/nuxt
+ nuxt-content-twoslash:
+ specifier: 0.4.0
+ version: 0.4.0(@nuxtjs/mdc@0.22.0)
+ ofetch:
+ specifier: 2.0.0-alpha.3
+ version: 2.0.0-alpha.3
+ pathe:
+ specifier: 2.0.3
+ version: 2.0.3
+ pkg-pr-new:
+ specifier: 0.0.74
+ version: 0.0.74
+ playwright-core:
+ specifier: 1.60.0
+ version: 1.60.0
+ rolldown-string:
+ specifier: 0.3.0
+ version: 0.3.0(rolldown@1.0.2)
+ rollup:
+ specifier: 4.60.4
+ version: 4.60.4
+ semver:
+ specifier: 7.8.0
+ version: 7.8.0
+ sherif:
+ specifier: 1.11.1
+ version: 1.11.1
+ srvx:
+ specifier: 0.11.15
+ version: 0.11.15
+ std-env:
+ specifier: 4.1.0
+ version: 4.1.0
+ tinyexec:
+ specifier: 1.1.2
+ version: 1.1.2
+ tinyglobby:
+ specifier: 0.2.16
+ version: 0.2.16
+ ts-blank-space:
+ specifier: 0.9.0
+ version: 0.9.0
+ typescript:
+ specifier: 6.0.3
+ version: 6.0.3
+ ufo:
+ specifier: 1.6.4
+ version: 1.6.4
+ vite:
+ specifier: 8.0.12
+ version: 8.0.12(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0)
+ vitest:
+ specifier: 4.1.7
+ version: 4.1.7(@types/node@24.12.4)(@vitest/coverage-v8@4.1.7)(happy-dom@20.9.0)(vite@8.0.12)
+ vitest-environment-nuxt:
+ specifier: 2.0.0
+ version: 2.0.0(@playwright/test@1.60.0)(@testing-library/vue@8.1.0(@vue/compiler-dom@3.5.34)(@vue/compiler-sfc@3.5.34)(@vue/server-renderer@3.5.34(vue@3.5.34(typescript@6.0.3)))(vue@3.5.34(typescript@6.0.3)))(@vue/test-utils@2.4.10(@vue/compiler-dom@3.5.34)(@vue/server-renderer@3.5.34(vue@3.5.34(typescript@6.0.3)))(vue@3.5.34(typescript@6.0.3)))(crossws@0.4.5(srvx@0.11.15))(happy-dom@20.9.0)(magicast@0.5.3)(playwright-core@1.60.0)(typescript@6.0.3)(vite@8.0.12)(vitest@4.1.7)
+ vue:
+ specifier: 3.5.34
+ version: 3.5.34(typescript@6.0.3)
+ vue-tsc:
+ specifier: 3.2.9
+ version: 3.2.9(typescript@6.0.3)
+ webpack:
+ specifier: 5.106.2
+ version: 5.106.2(esbuild@0.28.0)(lightningcss@1.32.0)
+
+ docs: {}
+
+ packages/kit:
+ dependencies:
+ c12:
+ specifier: ^3.3.4
+ version: 3.3.4(magicast@0.5.3)
+ consola:
+ specifier: ^3.4.2
+ version: 3.4.2
+ defu:
+ specifier: ^6.1.7
+ version: 6.1.7
+ destr:
+ specifier: ^2.0.5
+ version: 2.0.5
+ errx:
+ specifier: ^0.1.0
+ version: 0.1.0
+ exsolve:
+ specifier: ^1.0.8
+ version: 1.0.8
+ ignore:
+ specifier: ^7.0.5
+ version: 7.0.5
+ jiti:
+ specifier: ^2.7.0
+ version: 2.7.0
+ klona:
+ specifier: ^2.0.6
+ version: 2.0.6
+ mlly:
+ specifier: ^1.8.2
+ version: 1.8.2
+ nypm:
+ specifier: ^0.6.6
+ version: 0.6.6
+ ohash:
+ specifier: ^2.0.11
+ version: 2.0.11
+ pathe:
+ specifier: ^2.0.3
+ version: 2.0.3
+ pkg-types:
+ specifier: ^2.3.1
+ version: 2.3.1
+ rc9:
+ specifier: ^3.0.1
+ version: 3.0.1
+ scule:
+ specifier: ^1.3.0
+ version: 1.3.0
+ semver:
+ specifier: ^7.8.0
+ version: 7.8.0
+ tinyglobby:
+ specifier: ^0.2.16
+ version: 0.2.16
+ ufo:
+ specifier: ^1.6.4
+ version: 1.6.4
+ unctx:
+ specifier: ^2.5.0
+ version: 2.5.0
+ untyped:
+ specifier: ^2.0.0
+ version: 2.0.0
+ devDependencies:
+ '@nuxt/schema':
+ specifier: workspace:*
+ version: link:../schema
+ '@rspack/core':
+ specifier: 2.0.3
+ version: 2.0.3
+ '@types/semver':
+ specifier: 7.7.1
+ version: 7.7.1
+ hookable:
+ specifier: 6.1.1
+ version: 6.1.1
+ nitro:
+ specifier: 3.0.260311-beta
+ version: 3.0.260311-beta(chokidar@5.0.0)(dotenv@17.4.2)(giget@3.2.0)(ioredis@5.10.1)(jiti@2.7.0)(lru-cache@11.5.0)(rollup@4.60.4)(vite@8.0.12)
+ nitropack:
+ specifier: 2.13.4
+ version: 2.13.4(oxc-parser@0.130.0)(rolldown@1.0.2)(srvx@0.11.15)
+ obuild:
+ specifier: 0.4.36
+ version: 0.4.36(chokidar@5.0.0)(dotenv@17.4.2)(giget@3.2.0)(jiti@2.7.0)(magicast@0.5.3)(oxc-resolver@11.19.1(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0))(typescript@6.0.3)(vue-tsc@3.2.9(typescript@6.0.3))
+ unimport:
+ specifier: 6.3.0
+ version: 6.3.0(oxc-parser@0.130.0)(rolldown@1.0.2)
+ vite:
+ specifier: 8.0.12
+ version: 8.0.12(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0)
+ vitest:
+ specifier: 4.1.7
+ version: 4.1.7(@types/node@24.12.4)(@vitest/coverage-v8@4.1.7)(happy-dom@20.9.0)(vite@8.0.12)
+ webpack:
+ specifier: 5.106.2
+ version: 5.106.2(esbuild@0.28.0)(lightningcss@1.32.0)
+
+ packages/nitro-server:
+ dependencies:
+ '@nuxt/kit':
+ specifier: workspace:*
+ version: link:../kit
+ '@unhead/vue':
+ specifier: ^3.1.0
+ version: 3.1.0(crossws@0.4.5(srvx@0.11.15))(esbuild@0.28.0)(lightningcss@1.32.0)(rolldown@1.0.2)(typescript@6.0.3)(vite@8.0.12)(vue@3.5.34(typescript@6.0.3))(webpack@5.106.2(esbuild@0.28.0)(lightningcss@1.32.0))
+ '@vue/shared':
+ specifier: 3.5.34
+ version: 3.5.34
+ consola:
+ specifier: ^3.4.2
+ version: 3.4.2
+ defu:
+ specifier: ^6.1.7
+ version: 6.1.7
+ destr:
+ specifier: ^2.0.5
+ version: 2.0.5
+ devalue:
+ specifier: ^5.8.1
+ version: 5.8.1
+ errx:
+ specifier: ^0.1.0
+ version: 0.1.0
+ escape-string-regexp:
+ specifier: ^5.0.0
+ version: 5.0.0
+ exsolve:
+ specifier: ^1.0.8
+ version: 1.0.8
+ impound:
+ specifier: ^1.1.5
+ version: 1.1.5
+ klona:
+ specifier: ^2.0.6
+ version: 2.0.6
+ lru-cache:
+ specifier: ^11.4.0
+ version: 11.5.0
+ mlly:
+ specifier: ^1.8.2
+ version: 1.8.2
+ mocked-exports:
+ specifier: ^0.1.1
+ version: 0.1.1
+ nitro:
+ specifier: ^3.0.260311-beta
+ version: 3.0.260311-beta(chokidar@5.0.0)(dotenv@17.4.2)(giget@3.2.0)(ioredis@5.10.1)(jiti@2.7.0)(lru-cache@11.5.0)(rollup@4.60.4)(vite@8.0.12)
+ ohash:
+ specifier: ^2.0.11
+ version: 2.0.11
+ pathe:
+ specifier: ^2.0.3
+ version: 2.0.3
+ srvx:
+ specifier: ^0.11.15
+ version: 0.11.15
+ std-env:
+ specifier: ^4.1.0
+ version: 4.1.0
+ ufo:
+ specifier: ^1.6.4
+ version: 1.6.4
+ unctx:
+ specifier: ^2.5.0
+ version: 2.5.0
+ unstorage:
+ specifier: ^2.0.0-alpha.7
+ version: 2.0.0-alpha.7(chokidar@5.0.0)(db0@0.3.4)(ioredis@5.10.1)(lru-cache@11.5.0)(ofetch@1.5.1)
+ vue:
+ specifier: 3.5.34
+ version: 3.5.34(typescript@6.0.3)
+ vue-bundle-renderer:
+ specifier: ^2.2.0
+ version: 2.2.0
+ vue-devtools-stub:
+ specifier: ^0.1.0
+ version: 0.1.0
+ devDependencies:
+ '@babel/plugin-proposal-decorators':
+ specifier: 7.29.0
+ version: 7.29.0(@babel/core@7.29.0)
+ '@babel/plugin-syntax-typescript':
+ specifier: 7.28.6
+ version: 7.28.6(@babel/core@7.29.0)
+ '@nuxt/schema':
+ specifier: workspace:*
+ version: link:../schema
+ '@rollup/plugin-babel':
+ specifier: 7.0.0
+ version: 7.0.0(@babel/core@7.29.0)(@types/babel__core@7.20.5)(rollup@4.60.4)
+ hookable:
+ specifier: 6.1.1
+ version: 6.1.1
+ nuxt:
+ specifier: workspace:*
+ version: link:../nuxt
+ obuild:
+ specifier: 0.4.36
+ version: 0.4.36(chokidar@5.0.0)(dotenv@17.4.2)(giget@3.2.0)(jiti@2.7.0)(magicast@0.5.3)(oxc-resolver@11.19.1(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0))(typescript@6.0.3)(vue-tsc@3.2.9(typescript@6.0.3))
+ vitest:
+ specifier: 4.1.7
+ version: 4.1.7(@types/node@24.12.4)(@vitest/coverage-v8@4.1.7)(happy-dom@20.9.0)(vite@8.0.12)
+
+ packages/nuxt:
+ dependencies:
+ '@dxup/nuxt':
+ specifier: ^0.4.1
+ version: 0.4.1(typescript@6.0.3)
+ '@nuxt/cli':
+ specifier: ^3.35.2
+ version: 3.35.2(@nuxt/schema@packages+schema)(magicast@0.5.3)
+ '@nuxt/devtools':
+ specifier: ^4.0.0-alpha.4
+ version: 4.0.0-alpha.4(@pnpm/logger@1001.0.1)(crossws@0.4.5(srvx@0.11.15))(db0@0.3.4)(ioredis@5.10.1)(typescript@6.0.3)(vite@8.0.12)(vue@3.5.34(typescript@6.0.3))
+ '@nuxt/kit':
+ specifier: workspace:*
+ version: link:../kit
+ '@nuxt/nitro-server':
+ specifier: workspace:*
+ version: link:../nitro-server
+ '@nuxt/schema':
+ specifier: workspace:*
+ version: link:../schema
+ '@nuxt/telemetry':
+ specifier: ^2.8.0
+ version: 2.8.0(@nuxt/kit@packages+kit)
+ '@nuxt/vite-builder':
+ specifier: workspace:*
+ version: link:../vite
+ '@types/node':
+ specifier: '>=18.12.0'
+ version: 24.12.4
+ '@unhead/vue':
+ specifier: ^3.1.0
+ version: 3.1.0(crossws@0.4.5(srvx@0.11.15))(esbuild@0.28.0)(lightningcss@1.32.0)(rolldown@1.0.2)(typescript@6.0.3)(vite@8.0.12)(vue@3.5.34(typescript@6.0.3))(webpack@5.106.2(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ '@vue/shared':
+ specifier: ^3.5.34
+ version: 3.5.34
+ chokidar:
+ specifier: ^5.0.0
+ version: 5.0.0
+ compatx:
+ specifier: ^0.2.0
+ version: 0.2.0
+ consola:
+ specifier: ^3.4.2
+ version: 3.4.2
+ cookie-es:
+ specifier: ^3.1.1
+ version: 3.1.1
+ defu:
+ specifier: ^6.1.7
+ version: 6.1.7
+ devalue:
+ specifier: ^5.8.1
+ version: 5.8.1
+ errx:
+ specifier: ^0.1.0
+ version: 0.1.0
+ escape-string-regexp:
+ specifier: ^5.0.0
+ version: 5.0.0
+ exsolve:
+ specifier: ^1.0.8
+ version: 1.0.8
+ hookable:
+ specifier: ^6.1.1
+ version: 6.1.1
+ ignore:
+ specifier: ^7.0.5
+ version: 7.0.5
+ impound:
+ specifier: ^1.1.5
+ version: 1.1.5
+ jiti:
+ specifier: ^2.7.0
+ version: 2.7.0
+ klona:
+ specifier: ^2.0.6
+ version: 2.0.6
+ knitwork:
+ specifier: ^1.3.0
+ version: 1.3.0
+ magic-string:
+ specifier: ^0.30.21
+ version: 0.30.21
+ mlly:
+ specifier: ^1.8.2
+ version: 1.8.2
+ nanotar:
+ specifier: ^0.3.0
+ version: 0.3.0
+ ofetch:
+ specifier: ^2.0.0-alpha.3
+ version: 2.0.0-alpha.3
+ ohash:
+ specifier: ^2.0.11
+ version: 2.0.11
+ on-change:
+ specifier: ^6.0.2
+ version: 6.0.2
+ oxc-walker:
+ specifier: ^1.0.0
+ version: 1.0.0(oxc-parser@0.130.0)(rolldown@1.0.2)
+ pathe:
+ specifier: ^2.0.3
+ version: 2.0.3
+ perfect-debounce:
+ specifier: ^2.1.0
+ version: 2.1.0
+ picomatch:
+ specifier: ^4.0.4
+ version: 4.0.4
+ pkg-types:
+ specifier: ^2.3.1
+ version: 2.3.1
+ rolldown:
+ specifier: ^1.0.2
+ version: 1.0.2
+ rolldown-string:
+ specifier: ^0.3.0
+ version: 0.3.0(rolldown@1.0.2)
+ scule:
+ specifier: ^1.3.0
+ version: 1.3.0
+ semver:
+ specifier: ^7.8.0
+ version: 7.8.0
+ std-env:
+ specifier: ^4.1.0
+ version: 4.1.0
+ tinyglobby:
+ specifier: ^0.2.16
+ version: 0.2.16
+ ufo:
+ specifier: ^1.6.4
+ version: 1.6.4
+ ultrahtml:
+ specifier: ^1.6.0
+ version: 1.6.0
+ uncrypto:
+ specifier: ^0.1.3
+ version: 0.1.3
+ unctx:
+ specifier: ^2.5.0
+ version: 2.5.0
+ unhead:
+ specifier: ^3.1.0
+ version: 3.1.0(vite@8.0.12)
+ unimport:
+ specifier: ^6.3.0
+ version: 6.3.0(oxc-parser@0.130.0)(rolldown@1.0.2)
+ unplugin:
+ specifier: ^3.0.0
+ version: 3.0.0
+ unrouting:
+ specifier: ^0.1.7
+ version: 0.1.7
+ untyped:
+ specifier: ^2.0.0
+ version: 2.0.0
+ vue:
+ specifier: 3.5.34
+ version: 3.5.34(typescript@6.0.3)
+ vue-router:
+ specifier: ^5.0.7
+ version: 5.0.7(@vue/compiler-sfc@3.5.34)(vue@3.5.34(typescript@6.0.3))
+ devDependencies:
+ '@nuxt/scripts':
+ specifier: 1.1.0
+ version: 1.1.0(@unhead/vue@3.1.0(crossws@0.4.5(srvx@0.11.15))(esbuild@0.28.0)(lightningcss@1.32.0)(rolldown@1.0.2)(typescript@6.0.3)(vite@8.0.12)(vue@3.5.34(typescript@6.0.3))(webpack@5.106.2(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)))(db0@0.3.4)(ioredis@5.10.1)(rolldown@1.0.2)(typescript@6.0.3)(vite@8.0.12)(vue@3.5.34(typescript@6.0.3))
+ '@oxc-project/types':
+ specifier: 0.131.0
+ version: 0.131.0
+ '@parcel/watcher':
+ specifier: 2.5.6
+ version: 2.5.6
+ '@types/estree':
+ specifier: 1.0.9
+ version: 1.0.9
+ '@types/picomatch':
+ specifier: 4.0.3
+ version: 4.0.3
+ '@vitejs/plugin-vue':
+ specifier: 6.0.7
+ version: 6.0.7(vite@8.0.12)(vue@3.5.34(typescript@6.0.3))
+ '@vitejs/plugin-vue-jsx':
+ specifier: 5.1.5
+ version: 5.1.5(vite@8.0.12)(vue@3.5.34(typescript@6.0.3))
+ '@vue/compiler-sfc':
+ specifier: 3.5.34
+ version: 3.5.34
+ unbuild:
+ specifier: 3.6.1
+ version: 3.6.1(typescript@6.0.3)(vue-sfc-transformer@0.1.17(@vue/compiler-core@3.5.34)(esbuild@0.28.0)(vue@3.5.34(typescript@6.0.3)))(vue-tsc@3.2.9(typescript@6.0.3))(vue@3.5.34(typescript@6.0.3))
+ vite:
+ specifier: 8.0.12
+ version: 8.0.12(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0)
+ vitest:
+ specifier: 4.1.7
+ version: 4.1.7(@types/node@24.12.4)(@vitest/coverage-v8@4.1.7)(happy-dom@20.9.0)(vite@8.0.12)
+ vue-bundle-renderer:
+ specifier: 2.2.0
+ version: 2.2.0
+ vue-sfc-transformer:
+ specifier: 0.1.17
+ version: 0.1.17(@vue/compiler-core@3.5.34)(esbuild@0.28.0)(vue@3.5.34(typescript@6.0.3))
+
+ packages/rspack:
+ dependencies:
+ '@nuxt/friendly-errors-webpack-plugin':
+ specifier: ^2.6.0
+ version: 2.6.0(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ '@nuxt/kit':
+ specifier: workspace:*
+ version: link:../kit
+ '@rspack/core':
+ specifier: ^2.0.3
+ version: 2.0.3
+ '@vue/compiler-sfc':
+ specifier: 3.5.34
+ version: 3.5.34
+ autoprefixer:
+ specifier: ^10.5.0
+ version: 10.5.0(postcss@8.5.14)
+ css-loader:
+ specifier: ^7.1.4
+ version: 7.1.4(@rspack/core@2.0.3)(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ css-minimizer-webpack-plugin:
+ specifier: ^8.0.0
+ version: 8.0.0(esbuild@0.28.0)(lightningcss@1.32.0)(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ cssnano:
+ specifier: ^8.0.1
+ version: 8.0.1(postcss@8.5.14)
+ defu:
+ specifier: ^6.1.7
+ version: 6.1.7
+ esbuild-loader:
+ specifier: ^4.4.3
+ version: 4.4.3(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ escape-string-regexp:
+ specifier: ^5.0.0
+ version: 5.0.0
+ exsolve:
+ specifier: ^1.0.8
+ version: 1.0.8
+ file-loader:
+ specifier: ^6.2.0
+ version: 6.2.0(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ jiti:
+ specifier: ^2.7.0
+ version: 2.7.0
+ knitwork:
+ specifier: ^1.3.0
+ version: 1.3.0
+ memfs:
+ specifier: ^4.57.2
+ version: 4.57.2(tslib@2.8.1)
+ mlly:
+ specifier: ^1.8.2
+ version: 1.8.2
+ nuxt:
+ specifier: workspace:*
+ version: link:../nuxt
+ ohash:
+ specifier: ^2.0.11
+ version: 2.0.11
+ pathe:
+ specifier: ^2.0.3
+ version: 2.0.3
+ pify:
+ specifier: ^6.1.0
+ version: 6.1.0
+ postcss:
+ specifier: ^8.5.14
+ version: 8.5.14
+ postcss-import:
+ specifier: ^16.1.1
+ version: 16.1.1(postcss@8.5.14)
+ postcss-import-resolver:
+ specifier: ^2.0.0
+ version: 2.0.0
+ postcss-loader:
+ specifier: ^8.2.1
+ version: 8.2.1(@rspack/core@2.0.3)(postcss@8.5.14)(typescript@6.0.3)(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ postcss-url:
+ specifier: ^10.1.3
+ version: 10.1.4(postcss@8.5.14)
+ pug-plain-loader:
+ specifier: ^1.1.0
+ version: 1.1.0(pug@3.0.4)
+ rolldown-string:
+ specifier: ^0.3.0
+ version: 0.3.0(rolldown@1.0.2)
+ seroval:
+ specifier: ^1.5.4
+ version: 1.5.4
+ time-fix-plugin:
+ specifier: ^2.0.7
+ version: 2.0.7(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ tinyglobby:
+ specifier: ^0.2.16
+ version: 0.2.16
+ ts-checker-rspack-plugin:
+ specifier: ^1.3.0
+ version: 1.3.0(@rspack/core@2.0.3)(tslib@2.8.1)(typescript@6.0.3)
+ ufo:
+ specifier: ^1.6.4
+ version: 1.6.4
+ unenv:
+ specifier: ^2.0.0-rc.24
+ version: 2.0.0-rc.24
+ unplugin:
+ specifier: ^3.0.0
+ version: 3.0.0
+ url-loader:
+ specifier: ^4.1.1
+ version: 4.1.1(file-loader@6.2.0(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)))(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ vue-bundle-renderer:
+ specifier: ^2.2.0
+ version: 2.2.0
+ vue-loader:
+ specifier: ^17.4.2
+ version: 17.4.2(@vue/compiler-sfc@3.5.34)(vue@3.5.34(typescript@6.0.3))(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ webpack-bundle-analyzer:
+ specifier: ^5.3.0
+ version: 5.3.0
+ webpack-dev-middleware:
+ specifier: ^8.0.3
+ version: 8.0.3(tslib@2.8.1)(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ webpack-hot-middleware:
+ specifier: ^2.26.1
+ version: 2.26.1
+ webpackbar:
+ specifier: ^7.0.0
+ version: 7.0.0(@rspack/core@2.0.3)(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ devDependencies:
+ '@nuxt/schema':
+ specifier: workspace:*
+ version: link:../schema
+ '@types/webpack-bundle-analyzer':
+ specifier: 4.7.0
+ version: 4.7.0(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)
+ '@types/webpack-hot-middleware':
+ specifier: 2.25.12
+ version: 2.25.12(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)
+ h3:
+ specifier: 1.15.11
+ version: 1.15.11
+ h3-next:
+ specifier: npm:h3@2.0.1-rc.22
+ version: h3@2.0.1-rc.22(crossws@0.4.5(srvx@0.11.15))
+ obuild:
+ specifier: 0.4.36
+ version: 0.4.36(chokidar@5.0.0)(dotenv@17.4.2)(giget@3.2.0)(jiti@2.7.0)(magicast@0.5.3)(oxc-resolver@11.19.1(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0))(typescript@6.0.3)(vue-tsc@3.2.9(typescript@6.0.3))
+ rollup:
+ specifier: 4.60.4
+ version: 4.60.4
+ vue:
+ specifier: 3.5.34
+ version: 3.5.34(typescript@6.0.3)
+
+ packages/schema:
+ dependencies:
+ '@vue/shared':
+ specifier: ^3.5.34
+ version: 3.5.34
+ defu:
+ specifier: ^6.1.7
+ version: 6.1.7
+ pathe:
+ specifier: ^2.0.3
+ version: 2.0.3
+ pkg-types:
+ specifier: ^2.3.1
+ version: 2.3.1
+ std-env:
+ specifier: ^4.1.0
+ version: 4.1.0
+ devDependencies:
+ '@types/pug':
+ specifier: 2.0.10
+ version: 2.0.10
+ '@types/webpack-bundle-analyzer':
+ specifier: 4.7.0
+ version: 4.7.0(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)
+ '@types/webpack-hot-middleware':
+ specifier: 2.25.12
+ version: 2.25.12(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)
+ '@unhead/vue':
+ specifier: 3.1.0
+ version: 3.1.0(crossws@0.4.5(srvx@0.11.15))(esbuild@0.28.0)(lightningcss@1.32.0)(rolldown@1.0.2)(typescript@6.0.3)(vite@8.0.12)(vue@3.5.34(typescript@6.0.3))(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ '@vitejs/plugin-vue':
+ specifier: 6.0.7
+ version: 6.0.7(vite@8.0.12)(vue@3.5.34(typescript@6.0.3))
+ '@vitejs/plugin-vue-jsx':
+ specifier: 5.1.5
+ version: 5.1.5(vite@8.0.12)(vue@3.5.34(typescript@6.0.3))
+ '@vue/compiler-core':
+ specifier: 3.5.34
+ version: 3.5.34
+ '@vue/compiler-sfc':
+ specifier: 3.5.34
+ version: 3.5.34
+ '@vue/language-core':
+ specifier: 3.2.9
+ version: 3.2.9
+ autoprefixer:
+ specifier: 10.5.0
+ version: 10.5.0(postcss@8.5.14)
+ c12:
+ specifier: 3.3.4
+ version: 3.3.4(magicast@0.5.3)
+ chokidar:
+ specifier: 5.0.0
+ version: 5.0.0
+ compatx:
+ specifier: 0.2.0
+ version: 0.2.0
+ css-minimizer-webpack-plugin:
+ specifier: 8.0.0
+ version: 8.0.0(esbuild@0.28.0)(lightningcss@1.32.0)(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ cssnano:
+ specifier: 8.0.1
+ version: 8.0.1(postcss@8.5.14)
+ esbuild:
+ specifier: 0.28.0
+ version: 0.28.0
+ esbuild-loader:
+ specifier: 4.4.3
+ version: 4.4.3(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ file-loader:
+ specifier: 6.2.0
+ version: 6.2.0(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ h3:
+ specifier: 2.0.1-rc.22
+ version: 2.0.1-rc.22(crossws@0.4.5(srvx@0.11.15))
+ hookable:
+ specifier: 6.1.1
+ version: 6.1.1
+ ignore:
+ specifier: 7.0.5
+ version: 7.0.5
+ mini-css-extract-plugin:
+ specifier: 2.10.2
+ version: 2.10.2(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ nitro:
+ specifier: 3.0.260311-beta
+ version: 3.0.260311-beta(chokidar@5.0.0)(dotenv@17.4.2)(giget@3.2.0)(ioredis@5.10.1)(jiti@2.7.0)(lru-cache@11.5.0)(rollup@4.60.4)(vite@8.0.12)
+ obuild:
+ specifier: 0.4.36
+ version: 0.4.36(chokidar@5.0.0)(dotenv@17.4.2)(giget@3.2.0)(jiti@2.7.0)(magicast@0.5.3)(oxc-resolver@11.19.1(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0))(typescript@6.0.3)(vue-tsc@3.2.9(typescript@6.0.3))
+ ofetch:
+ specifier: 2.0.0-alpha.3
+ version: 2.0.0-alpha.3
+ oxc-transform:
+ specifier: 0.131.0
+ version: 0.131.0
+ postcss:
+ specifier: 8.5.14
+ version: 8.5.14
+ rollup-plugin-visualizer:
+ specifier: 7.0.1
+ version: 7.0.1(rolldown@1.0.2)(rollup@4.60.4)
+ sass-loader:
+ specifier: 17.0.0
+ version: 17.0.0(@rspack/core@2.0.3)(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ scule:
+ specifier: 1.3.0
+ version: 1.3.0
+ unctx:
+ specifier: 2.5.0
+ version: 2.5.0
+ unimport:
+ specifier: 6.3.0
+ version: 6.3.0(oxc-parser@0.130.0)(rolldown@1.0.2)
+ untyped:
+ specifier: 2.0.0
+ version: 2.0.0
+ vite:
+ specifier: 8.0.12
+ version: 8.0.12(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0)
+ vue:
+ specifier: 3.5.34
+ version: 3.5.34(typescript@6.0.3)
+ vue-bundle-renderer:
+ specifier: 2.2.0
+ version: 2.2.0
+ vue-loader:
+ specifier: 17.4.2
+ version: 17.4.2(@vue/compiler-sfc@3.5.34)(vue@3.5.34(typescript@6.0.3))(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ vue-router:
+ specifier: 5.0.7
+ version: 5.0.7(@vue/compiler-sfc@3.5.34)(vue@3.5.34(typescript@6.0.3))
+ webpack:
+ specifier: 5.106.2
+ version: 5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)
+ webpack-dev-middleware:
+ specifier: 8.0.3
+ version: 8.0.3(tslib@2.8.1)(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+
+ packages/ui-templates:
+ devDependencies:
+ '@unocss/reset':
+ specifier: 66.6.8
+ version: 66.6.8
+ '@vue/shared':
+ specifier: 3.5.34
+ version: 3.5.34
+ beasties:
+ specifier: 0.4.2
+ version: 0.4.2
+ html-validate:
+ specifier: 11.2.0
+ version: 11.2.0(@vitest/expect@4.1.7)(vitest@4.1.7)
+ htmlnano:
+ specifier: 3.3.1
+ version: 3.3.1(cssnano@8.0.1(postcss@8.5.14))(postcss@8.5.14)(svgo@4.0.1)(terser@5.48.0)(typescript@6.0.3)
+ knitwork:
+ specifier: 1.3.0
+ version: 1.3.0
+ pathe:
+ specifier: 2.0.3
+ version: 2.0.3
+ prettier:
+ specifier: 3.8.3
+ version: 3.8.3
+ scule:
+ specifier: 1.3.0
+ version: 1.3.0
+ svgo:
+ specifier: 4.0.1
+ version: 4.0.1
+ tinyexec:
+ specifier: 1.1.2
+ version: 1.1.2
+ tinyglobby:
+ specifier: 0.2.16
+ version: 0.2.16
+ unocss:
+ specifier: 66.6.8
+ version: 66.6.8(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0)(vite@8.0.12)
+ vite:
+ specifier: 8.0.12
+ version: 8.0.12(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0)
+
+ packages/vite:
+ dependencies:
+ '@nuxt/kit':
+ specifier: workspace:*
+ version: link:../kit
+ '@vitejs/plugin-vue':
+ specifier: ^6.0.7
+ version: 6.0.7(vite@8.0.12)(vue@3.5.34(typescript@6.0.3))
+ consola:
+ specifier: ^3.4.2
+ version: 3.4.2
+ defu:
+ specifier: ^6.1.7
+ version: 6.1.7
+ escape-string-regexp:
+ specifier: ^5.0.0
+ version: 5.0.0
+ exsolve:
+ specifier: ^1.0.8
+ version: 1.0.8
+ get-port-please:
+ specifier: ^3.2.0
+ version: 3.2.0
+ jiti:
+ specifier: ^2.7.0
+ version: 2.7.0
+ knitwork:
+ specifier: ^1.3.0
+ version: 1.3.0
+ mlly:
+ specifier: ^1.8.2
+ version: 1.8.2
+ mocked-exports:
+ specifier: ^0.1.1
+ version: 0.1.1
+ nuxt:
+ specifier: workspace:*
+ version: link:../nuxt
+ pathe:
+ specifier: ^2.0.3
+ version: 2.0.3
+ pkg-types:
+ specifier: ^2.3.1
+ version: 2.3.1
+ rolldown-string:
+ specifier: ^0.3.0
+ version: 0.3.0(rolldown@1.0.2)
+ seroval:
+ specifier: ^1.5.4
+ version: 1.5.4
+ std-env:
+ specifier: ^4.1.0
+ version: 4.1.0
+ ufo:
+ specifier: ^1.6.4
+ version: 1.6.4
+ unenv:
+ specifier: ^2.0.0-rc.24
+ version: 2.0.0-rc.24
+ vite:
+ specifier: 8.0.12
+ version: 8.0.12(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0)
+ vite-node:
+ specifier: ^6.0.0
+ version: 6.0.0(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0)
+ vite-plugin-checker:
+ specifier: ^0.13.0
+ version: 0.13.0(eslint@9.39.4(jiti@2.7.0))(optionator@0.9.4)(typescript@6.0.3)(vite@8.0.12)(vue-tsc@3.2.9(typescript@6.0.3))
+ vue-bundle-renderer:
+ specifier: ^2.2.0
+ version: 2.2.0
+ devDependencies:
+ '@babel/plugin-proposal-decorators':
+ specifier: 7.29.0
+ version: 7.29.0(@babel/core@7.29.0)
+ '@babel/plugin-syntax-jsx':
+ specifier: 7.28.6
+ version: 7.28.6(@babel/core@7.29.0)
+ '@nuxt/schema':
+ specifier: workspace:*
+ version: link:../schema
+ '@vitejs/plugin-vue-jsx':
+ specifier: 5.1.5
+ version: 5.1.5(vite@8.0.12)(vue@3.5.34(typescript@6.0.3))
+ autoprefixer:
+ specifier: 10.5.0
+ version: 10.5.0(postcss@8.5.14)
+ cssnano:
+ specifier: 8.0.1
+ version: 8.0.1(postcss@8.5.14)
+ h3:
+ specifier: 1.15.11
+ version: 1.15.11
+ h3-next:
+ specifier: npm:h3@2.0.1-rc.22
+ version: h3@2.0.1-rc.22(crossws@0.4.5(srvx@0.11.15))
+ nitropack:
+ specifier: 2.13.4
+ version: 2.13.4(oxc-parser@0.130.0)(rolldown@1.0.2)(srvx@0.11.15)
+ obuild:
+ specifier: 0.4.36
+ version: 0.4.36(chokidar@5.0.0)(dotenv@17.4.2)(giget@3.2.0)(jiti@2.7.0)(magicast@0.5.3)(oxc-resolver@11.19.1(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0))(typescript@6.0.3)(vue-tsc@3.2.9(typescript@6.0.3))
+ postcss:
+ specifier: 8.5.14
+ version: 8.5.14
+ rolldown:
+ specifier: 1.0.2
+ version: 1.0.2
+ rollup:
+ specifier: 4.60.4
+ version: 4.60.4
+ rollup-plugin-visualizer:
+ specifier: 7.0.1
+ version: 7.0.1(rolldown@1.0.2)(rollup@4.60.4)
+ vue:
+ specifier: 3.5.34
+ version: 3.5.34(typescript@6.0.3)
+
+ packages/webpack:
+ dependencies:
+ '@nuxt/friendly-errors-webpack-plugin':
+ specifier: ^2.6.0
+ version: 2.6.0(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ '@nuxt/kit':
+ specifier: workspace:*
+ version: link:../kit
+ '@vue/compiler-sfc':
+ specifier: 3.5.34
+ version: 3.5.34
+ autoprefixer:
+ specifier: ^10.5.0
+ version: 10.5.0(postcss@8.5.14)
+ css-loader:
+ specifier: ^7.1.4
+ version: 7.1.4(@rspack/core@2.0.3)(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ css-minimizer-webpack-plugin:
+ specifier: ^8.0.0
+ version: 8.0.0(esbuild@0.28.0)(lightningcss@1.32.0)(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ cssnano:
+ specifier: ^8.0.1
+ version: 8.0.1(postcss@8.5.14)
+ defu:
+ specifier: ^6.1.7
+ version: 6.1.7
+ esbuild-loader:
+ specifier: ^4.4.3
+ version: 4.4.3(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ escape-string-regexp:
+ specifier: ^5.0.0
+ version: 5.0.0
+ exsolve:
+ specifier: ^1.0.8
+ version: 1.0.8
+ file-loader:
+ specifier: ^6.2.0
+ version: 6.2.0(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ fork-ts-checker-webpack-plugin:
+ specifier: ^9.1.0
+ version: 9.1.0(typescript@6.0.3)(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ jiti:
+ specifier: ^2.7.0
+ version: 2.7.0
+ knitwork:
+ specifier: ^1.3.0
+ version: 1.3.0
+ memfs:
+ specifier: ^4.57.2
+ version: 4.57.2(tslib@2.8.1)
+ mini-css-extract-plugin:
+ specifier: ^2.10.2
+ version: 2.10.2(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ mlly:
+ specifier: ^1.8.2
+ version: 1.8.2
+ nuxt:
+ specifier: workspace:*
+ version: link:../nuxt
+ ohash:
+ specifier: ^2.0.11
+ version: 2.0.11
+ pathe:
+ specifier: ^2.0.3
+ version: 2.0.3
+ pify:
+ specifier: ^6.1.0
+ version: 6.1.0
+ postcss:
+ specifier: ^8.5.14
+ version: 8.5.14
+ postcss-import:
+ specifier: ^16.1.1
+ version: 16.1.1(postcss@8.5.14)
+ postcss-import-resolver:
+ specifier: ^2.0.0
+ version: 2.0.0
+ postcss-loader:
+ specifier: ^8.2.1
+ version: 8.2.1(@rspack/core@2.0.3)(postcss@8.5.14)(typescript@6.0.3)(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ postcss-url:
+ specifier: ^10.1.3
+ version: 10.1.4(postcss@8.5.14)
+ pug-plain-loader:
+ specifier: ^1.1.0
+ version: 1.1.0(pug@3.0.4)
+ rolldown-string:
+ specifier: ^0.3.0
+ version: 0.3.0(rolldown@1.0.2)
+ seroval:
+ specifier: ^1.5.4
+ version: 1.5.4
+ time-fix-plugin:
+ specifier: ^2.0.7
+ version: 2.0.7(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ tinyglobby:
+ specifier: ^0.2.16
+ version: 0.2.16
+ ufo:
+ specifier: ^1.6.4
+ version: 1.6.4
+ unenv:
+ specifier: ^2.0.0-rc.24
+ version: 2.0.0-rc.24
+ unplugin:
+ specifier: ^3.0.0
+ version: 3.0.0
+ url-loader:
+ specifier: ^4.1.1
+ version: 4.1.1(file-loader@6.2.0(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)))(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ vue-bundle-renderer:
+ specifier: ^2.2.0
+ version: 2.2.0
+ vue-loader:
+ specifier: ^17.4.2
+ version: 17.4.2(@vue/compiler-sfc@3.5.34)(vue@3.5.34(typescript@6.0.3))(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ webpack:
+ specifier: ^5.106.2
+ version: 5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)
+ webpack-bundle-analyzer:
+ specifier: ^5.3.0
+ version: 5.3.0
+ webpack-dev-middleware:
+ specifier: ^8.0.3
+ version: 8.0.3(tslib@2.8.1)(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ webpack-hot-middleware:
+ specifier: ^2.26.1
+ version: 2.26.1
+ webpackbar:
+ specifier: ^7.0.0
+ version: 7.0.0(@rspack/core@2.0.3)(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ devDependencies:
+ '@nuxt/schema':
+ specifier: workspace:*
+ version: link:../schema
+ '@rspack/core':
+ specifier: 2.0.3
+ version: 2.0.3
+ '@types/webpack-bundle-analyzer':
+ specifier: 4.7.0
+ version: 4.7.0(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)
+ '@types/webpack-hot-middleware':
+ specifier: 2.25.12
+ version: 2.25.12(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)
+ h3:
+ specifier: 1.15.11
+ version: 1.15.11
+ h3-next:
+ specifier: npm:h3@2.0.1-rc.22
+ version: h3@2.0.1-rc.22(crossws@0.4.5(srvx@0.11.15))
+ obuild:
+ specifier: 0.4.36
+ version: 0.4.36(chokidar@5.0.0)(dotenv@17.4.2)(giget@3.2.0)(jiti@2.7.0)(magicast@0.5.3)(oxc-resolver@11.19.1(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0))(typescript@6.0.3)(vue-tsc@3.2.9(typescript@6.0.3))
+ rollup:
+ specifier: 4.60.4
+ version: 4.60.4
+ vue:
+ specifier: 3.5.34
+ version: 3.5.34(typescript@6.0.3)
+
+ playground:
+ dependencies:
+ nuxt:
+ specifier: workspace:*
+ version: link:../packages/nuxt
+
+ test/fixtures/basic:
+ dependencies:
+ '@nuxt/rspack-builder':
+ specifier: workspace:*
+ version: link:../../../packages/rspack
+ '@nuxt/webpack-builder':
+ specifier: workspace:*
+ version: link:../../../packages/webpack
+ nuxt:
+ specifier: workspace:*
+ version: link:../../../packages/nuxt
+ devDependencies:
+ '@vue/devtools-api':
+ specifier: ^8.1.2
+ version: 8.1.2
+ defu:
+ specifier: ^6.1.7
+ version: 6.1.7
+ postcss:
+ specifier: ^8.5.14
+ version: 8.5.14
+ ufo:
+ specifier: ^1.6.4
+ version: 1.6.4
+ unplugin:
+ specifier: ^3.0.0
+ version: 3.0.0
+ vue:
+ specifier: 3.5.34
+ version: 3.5.34(typescript@6.0.3)
+
+ test/fixtures/basic-types:
+ dependencies:
+ hook-augmenting-module:
+ specifier: workspace:*
+ version: link:_local-modules/hook-augmenting-module
+ nuxt:
+ specifier: workspace:*
+ version: link:../../../packages/nuxt
+ ofetch:
+ specifier: ^2.0.0-alpha.3
+ version: 2.0.0-alpha.3
+ vue:
+ specifier: 3.5.34
+ version: 3.5.34(typescript@6.0.3)
+ vue-router:
+ specifier: ^5.0.6
+ version: 5.0.7(@vue/compiler-sfc@3.5.34)(vue@3.5.34(typescript@6.0.3))
+ devDependencies:
+ vitest:
+ specifier: 4.1.6
+ version: 4.1.6(@types/node@24.12.4)(@vitest/coverage-v8@4.1.7(vitest@4.1.7))(happy-dom@20.9.0)(vite@8.0.12)
+
+ test/fixtures/basic-types/_local-modules/hook-augmenting-module: {}
+
+ test/fixtures/build-assets-dir-collision:
+ dependencies:
+ nuxt:
+ specifier: workspace:*
+ version: link:../../../packages/nuxt
+
+ test/fixtures/external-vue-resolution:
+ dependencies:
+ nuxt:
+ specifier: workspace:*
+ version: link:../../../packages/nuxt
+
+ test/fixtures/hmr:
+ dependencies:
+ nuxt:
+ specifier: workspace:*
+ version: link:../../../packages/nuxt
+
+ test/fixtures/hmr-sibling-layer:
+ dependencies:
+ nuxt:
+ specifier: workspace:*
+ version: link:../../../packages/nuxt
+
+ test/fixtures/inline-styles:
+ dependencies:
+ nuxt:
+ specifier: workspace:*
+ version: link:../../../packages/nuxt
+
+ test/fixtures/lazy-hydration:
+ dependencies:
+ nuxt:
+ specifier: workspace:*
+ version: link:../../../packages/nuxt
+
+ test/fixtures/minimal:
+ dependencies:
+ nuxt:
+ specifier: workspace:*
+ version: link:../../../packages/nuxt
+
+ test/fixtures/minimal-pages:
+ dependencies:
+ nuxt:
+ specifier: workspace:*
+ version: link:../../../packages/nuxt
+
+ test/fixtures/minimal-types:
+ dependencies:
+ nuxt:
+ specifier: workspace:*
+ version: link:../../../packages/nuxt
+
+ test/fixtures/runtime-compiler:
+ dependencies:
+ nuxt:
+ specifier: workspace:*
+ version: link:../../../packages/nuxt
+
+ test/fixtures/server-components:
+ dependencies:
+ nuxt:
+ specifier: workspace:*
+ version: link:../../../packages/nuxt
+
+ test/fixtures/spa-loader:
+ dependencies:
+ nuxt:
+ specifier: workspace:*
+ version: link:../../../packages/nuxt
+
+ test/fixtures/suspense:
+ dependencies:
+ nuxt:
+ specifier: workspace:*
+ version: link:../../../packages/nuxt
+ devDependencies:
+ typescript:
+ specifier: 5.9.3
+ version: 5.9.3
+
+ test/fixtures/suspense-layout:
+ dependencies:
+ nuxt:
+ specifier: workspace:*
+ version: link:../../../packages/nuxt
+ devDependencies:
+ typescript:
+ specifier: 5.9.3
+ version: 5.9.3
+
+packages:
+
+ '@andrewbranch/untar.js@1.0.3':
+ resolution: {integrity: sha512-Jh15/qVmrLGhkKJBdXlK1+9tY4lZruYjsgkDFj08ZmDiWVBLJcqkok7Z0/R0In+i1rScBpJlSvrTS2Lm41Pbnw==}
+
+ '@antfu/install-pkg@1.1.0':
+ resolution: {integrity: sha512-MGQsmw10ZyI+EJo45CdSER4zEb+p31LpDAFp2Z3gkSd1yqVZGi0Ebx++YTEMonJy4oChEMLsxZ64j8FH6sSqtQ==}
+
+ '@apidevtools/json-schema-ref-parser@14.2.1':
+ resolution: {integrity: sha512-HmdFw9CDYqM6B25pqGBpNeLCKvGPlIx1EbLrVL0zPvj50CJQUHyBNBw45Muk0kEIkogo1VZvOKHajdMuAzSxRg==}
+ engines: {node: '>= 20'}
+ peerDependencies:
+ '@types/json-schema': ^7.0.15
+
+ '@arethetypeswrong/cli@0.18.2':
+ resolution: {integrity: sha512-PcFM20JNlevEDKBg4Re29Rtv2xvjvQZzg7ENnrWFSS0PHgdP2njibVFw+dRUhNkPgNfac9iUqO0ohAXqQL4hbw==}
+ engines: {node: '>=20'}
+ hasBin: true
+
+ '@arethetypeswrong/core@0.18.2':
+ resolution: {integrity: sha512-GiwTmBFOU1/+UVNqqCGzFJYfBXEytUkiI+iRZ6Qx7KmUVtLm00sYySkfe203C9QtPG11yOz1ZaMek8dT/xnlgg==}
+ engines: {node: '>=20'}
+
+ '@babel/code-frame@7.29.0':
+ resolution: {integrity: sha512-9NhCeYjq9+3uxgdtp20LSiJXJvN0FeCtNGpJxuMFZ1Kv3cWUNb6DOhJwUvcVCzKGR66cw4njwM6hrJLqgOwbcw==}
+ engines: {node: '>=6.9.0'}
+
+ '@babel/compat-data@7.29.3':
+ resolution: {integrity: sha512-LIVqM46zQWZhj17qA8wb4nW/ixr2y1Nw+r1etiAWgRM6U1IqP+LNhL1yg440jYZR72jCWcWbLWzIosH+uP1fqg==}
+ engines: {node: '>=6.9.0'}
+
+ '@babel/core@7.29.0':
+ resolution: {integrity: sha512-CGOfOJqWjg2qW/Mb6zNsDm+u5vFQ8DxXfbM09z69p5Z6+mE1ikP2jUXw+j42Pf1XTYED2Rni5f95npYeuwMDQA==}
+ engines: {node: '>=6.9.0'}
+
+ '@babel/generator@7.29.1':
+ resolution: {integrity: sha512-qsaF+9Qcm2Qv8SRIMMscAvG4O3lJ0F1GuMo5HR/Bp02LopNgnZBC/EkbevHFeGs4ls/oPz9v+Bsmzbkbe+0dUw==}
+ engines: {node: '>=6.9.0'}
+
+ '@babel/generator@8.0.0-rc.5':
+ resolution: {integrity: sha512-nFZPWz3FHIS7y6rMIVoa/WBwjdutfIaRJIBQjzn+t3RnecZoRNlGmGcyR2wb0T/IgSd50Kz/6dG8/LvMCRunjg==}
+ engines: {node: ^22.18.0 || >=24.11.0}
+
+ '@babel/helper-annotate-as-pure@7.27.3':
+ resolution: {integrity: sha512-fXSwMQqitTGeHLBC08Eq5yXz2m37E4pJX1qAU1+2cNedz/ifv/bVXft90VeSav5nFO61EcNgwr0aJxbyPaWBPg==}
+ engines: {node: '>=6.9.0'}
+
+ '@babel/helper-compilation-targets@7.28.6':
+ resolution: {integrity: sha512-JYtls3hqi15fcx5GaSNL7SCTJ2MNmjrkHXg4FSpOA/grxK8KwyZ5bubHsCq8FXCkua6xhuaaBit+3b7+VZRfcA==}
+ engines: {node: '>=6.9.0'}
+
+ '@babel/helper-create-class-features-plugin@7.29.3':
+ resolution: {integrity: sha512-RpLYy2sb51oNLjuu1iD3bwBqCBWUzjO0ocp+iaCP/lJtb2CPLcnC2Fftw+4sAzaMELGeWTgExSKADbdo0GFVzA==}
+ engines: {node: '>=6.9.0'}
+ peerDependencies:
+ '@babel/core': ^7.0.0
+
+ '@babel/helper-globals@7.28.0':
+ resolution: {integrity: sha512-+W6cISkXFa1jXsDEdYA8HeevQT/FULhxzR99pxphltZcVaugps53THCeiWA8SguxxpSp3gKPiuYfSWopkLQ4hw==}
+ engines: {node: '>=6.9.0'}
+
+ '@babel/helper-member-expression-to-functions@7.28.5':
+ resolution: {integrity: sha512-cwM7SBRZcPCLgl8a7cY0soT1SptSzAlMH39vwiRpOQkJlh53r5hdHwLSCZpQdVLT39sZt+CRpNwYG4Y2v77atg==}
+ engines: {node: '>=6.9.0'}
+
+ '@babel/helper-module-imports@7.28.6':
+ resolution: {integrity: sha512-l5XkZK7r7wa9LucGw9LwZyyCUscb4x37JWTPz7swwFE/0FMQAGpiWUZn8u9DzkSBWEcK25jmvubfpw2dnAMdbw==}
+ engines: {node: '>=6.9.0'}
+
+ '@babel/helper-module-transforms@7.28.6':
+ resolution: {integrity: sha512-67oXFAYr2cDLDVGLXTEABjdBJZ6drElUSI7WKp70NrpyISso3plG9SAGEF6y7zbha/wOzUByWWTJvEDVNIUGcA==}
+ engines: {node: '>=6.9.0'}
+ peerDependencies:
+ '@babel/core': ^7.0.0
+
+ '@babel/helper-optimise-call-expression@7.27.1':
+ resolution: {integrity: sha512-URMGH08NzYFhubNSGJrpUEphGKQwMQYBySzat5cAByY1/YgIRkULnIy3tAMeszlL/so2HbeilYloUmSpd7GdVw==}
+ engines: {node: '>=6.9.0'}
+
+ '@babel/helper-plugin-utils@7.28.6':
+ resolution: {integrity: sha512-S9gzZ/bz83GRysI7gAD4wPT/AI3uCnY+9xn+Mx/KPs2JwHJIz1W8PZkg2cqyt3RNOBM8ejcXhV6y8Og7ly/Dug==}
+ engines: {node: '>=6.9.0'}
+
+ '@babel/helper-replace-supers@7.28.6':
+ resolution: {integrity: sha512-mq8e+laIk94/yFec3DxSjCRD2Z0TAjhVbEJY3UQrlwVo15Lmt7C2wAUbK4bjnTs4APkwsYLTahXRraQXhb1WCg==}
+ engines: {node: '>=6.9.0'}
+ peerDependencies:
+ '@babel/core': ^7.0.0
+
+ '@babel/helper-skip-transparent-expression-wrappers@7.27.1':
+ resolution: {integrity: sha512-Tub4ZKEXqbPjXgWLl2+3JpQAYBJ8+ikpQ2Ocj/q/r0LwE3UhENh7EUabyHjz2kCEsrRY83ew2DQdHluuiDQFzg==}
+ engines: {node: '>=6.9.0'}
+
+ '@babel/helper-string-parser@7.27.1':
+ resolution: {integrity: sha512-qMlSxKbpRlAridDExk92nSobyDdpPijUq2DW6oDnUqd0iOGxmQjyqhMIihI9+zv4LPyZdRje2cavWPbCbWm3eA==}
+ engines: {node: '>=6.9.0'}
+
+ '@babel/helper-string-parser@8.0.0-rc.5':
+ resolution: {integrity: sha512-sN7R8rBvDurfaziNfDEIjIntlazmlkCDGO4SNl2RJ3wRCn+QxspLV7hzYAE8WWVd2joVuT8sUxeePdLp2idI1A==}
+ engines: {node: ^22.18.0 || >=24.11.0}
+
+ '@babel/helper-validator-identifier@7.28.5':
+ resolution: {integrity: sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q==}
+ engines: {node: '>=6.9.0'}
+
+ '@babel/helper-validator-identifier@8.0.0-rc.5':
+ resolution: {integrity: sha512-ehJDxHvtbZ85RtX/L2fi0h9AGsBNqB5Euv1EB8RMAvGYvD+2X+QbpzzOpbklnNXO+WSZJNOaetw2BBj27xsWVg==}
+ engines: {node: ^22.18.0 || >=24.11.0}
+
+ '@babel/helper-validator-option@7.27.1':
+ resolution: {integrity: sha512-YvjJow9FxbhFFKDSuFnVCe2WxXk1zWc22fFePVNEaWJEu8IrZVlda6N0uHwzZrUM1il7NC9Mlp4MaJYbYd9JSg==}
+ engines: {node: '>=6.9.0'}
+
+ '@babel/helpers@7.29.2':
+ resolution: {integrity: sha512-HoGuUs4sCZNezVEKdVcwqmZN8GoHirLUcLaYVNBK2J0DadGtdcqgr3BCbvH8+XUo4NGjNl3VOtSjEKNzqfFgKw==}
+ engines: {node: '>=6.9.0'}
+
+ '@babel/parser@7.29.3':
+ resolution: {integrity: sha512-b3ctpQwp+PROvU/cttc4OYl4MzfJUWy6FZg+PMXfzmt/+39iHVF0sDfqay8TQM3JA2EUOyKcFZt75jWriQijsA==}
+ engines: {node: '>=6.0.0'}
+ hasBin: true
+
+ '@babel/parser@8.0.0-rc.4':
+ resolution: {integrity: sha512-0S/1yefMa15N4i2v3t8Fw9pgMHhf2gF6Lc1UEXI96Ls6FNAjqvHHZouZ2ZS/deqLhbMFtmfVeFac6iTsvFbLwA==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ hasBin: true
+
+ '@babel/parser@8.0.0-rc.5':
+ resolution: {integrity: sha512-/Mfg83rK3+jsRbl4Vbd0jqxc6M1A1/WNFtgrowRM1unEsD3XcNnrBdMM0JWakd0/RN9lseQKwPduW1TiEwKOlQ==}
+ engines: {node: ^22.18.0 || >=24.11.0}
+ hasBin: true
+
+ '@babel/plugin-proposal-decorators@7.29.0':
+ resolution: {integrity: sha512-CVBVv3VY/XRMxRYq5dwr2DS7/MvqPm23cOCjbwNnVrfOqcWlnefua1uUs0sjdKOGjvPUG633o07uWzJq4oI6dA==}
+ engines: {node: '>=6.9.0'}
+ peerDependencies:
+ '@babel/core': ^7.0.0-0
+
+ '@babel/plugin-syntax-decorators@7.28.6':
+ resolution: {integrity: sha512-71EYI0ONURHJBL4rSFXnITXqXrrY8q4P0q006DPfN+Rk+ASM+++IBXem/ruokgBZR8YNEWZ8R6B+rCb8VcUTqA==}
+ engines: {node: '>=6.9.0'}
+ peerDependencies:
+ '@babel/core': ^7.0.0-0
+
+ '@babel/plugin-syntax-jsx@7.28.6':
+ resolution: {integrity: sha512-wgEmr06G6sIpqr8YDwA2dSRTE3bJ+V0IfpzfSY3Lfgd7YWOaAdlykvJi13ZKBt8cZHfgH1IXN+CL656W3uUa4w==}
+ engines: {node: '>=6.9.0'}
+ peerDependencies:
+ '@babel/core': ^7.0.0-0
+
+ '@babel/plugin-syntax-typescript@7.28.6':
+ resolution: {integrity: sha512-+nDNmQye7nlnuuHDboPbGm00Vqg3oO8niRRL27/4LYHUsHYh0zJ1xWOz0uRwNFmM1Avzk8wZbc6rdiYhomzv/A==}
+ engines: {node: '>=6.9.0'}
+ peerDependencies:
+ '@babel/core': ^7.0.0-0
+
+ '@babel/plugin-transform-typescript@7.28.6':
+ resolution: {integrity: sha512-0YWL2RFxOqEm9Efk5PvreamxPME8OyY0wM5wh5lHjF+VtVhdneCWGzZeSqzOfiobVqQaNCd2z0tQvnI9DaPWPw==}
+ engines: {node: '>=6.9.0'}
+ peerDependencies:
+ '@babel/core': ^7.0.0-0
+
+ '@babel/runtime@7.29.2':
+ resolution: {integrity: sha512-JiDShH45zKHWyGe4ZNVRrCjBz8Nh9TMmZG1kh4QTK8hCBTWBi8Da+i7s1fJw7/lYpM4ccepSNfqzZ/QvABBi5g==}
+ engines: {node: '>=6.9.0'}
+
+ '@babel/template@7.28.6':
+ resolution: {integrity: sha512-YA6Ma2KsCdGb+WC6UpBVFJGXL58MDA6oyONbjyF/+5sBgxY/dwkhLogbMT2GXXyU84/IhRw/2D1Os1B/giz+BQ==}
+ engines: {node: '>=6.9.0'}
+
+ '@babel/traverse@7.29.0':
+ resolution: {integrity: sha512-4HPiQr0X7+waHfyXPZpWPfWL/J7dcN1mx9gL6WdQVMbPnF3+ZhSMs8tCxN7oHddJE9fhNE7+lxdnlyemKfJRuA==}
+ engines: {node: '>=6.9.0'}
+
+ '@babel/types@7.29.0':
+ resolution: {integrity: sha512-LwdZHpScM4Qz8Xw2iKSzS+cfglZzJGvofQICy7W7v4caru4EaAmyUuO6BGrbyQ2mYV11W0U8j5mBhd14dd3B0A==}
+ engines: {node: '>=6.9.0'}
+
+ '@babel/types@8.0.0-rc.5':
+ resolution: {integrity: sha512-JeSVu/m8x/zpp4CLjYHVNXuhEyOkhPXuxM8YOXjh6L4LlvQNKuUNOTo5KdBuKAcTDHw8DquToTaEkhsBqPXOaA==}
+ engines: {node: ^22.18.0 || >=24.11.0}
+
+ '@bcoe/v8-coverage@1.0.2':
+ resolution: {integrity: sha512-6zABk/ECA/QYSCQ1NGiVwwbQerUCZ+TQbp64Q3AgmfNvurHH0j8TtXa1qbShXA6qqkpAj4V5W8pP6mLe1mcMqA==}
+ engines: {node: '>=18'}
+
+ '@bomb.sh/tab@0.0.15':
+ resolution: {integrity: sha512-Y90ub44TAvbdO9P8mcD/XPyQjFhiR5xmd4Fk7JErmWmEWEUimNnjWiBrVZ16Tj3GA1rLZ+uvCN2V/pzLawv31g==}
+ hasBin: true
+ peerDependencies:
+ cac: ^6.7.14
+ citty: ^0.1.6 || ^0.2.0
+ commander: ^13.1.0
+ peerDependenciesMeta:
+ cac:
+ optional: true
+ citty:
+ optional: true
+ commander:
+ optional: true
+
+ '@braidai/lang@1.1.2':
+ resolution: {integrity: sha512-qBcknbBufNHlui137Hft8xauQMTZDKdophmLFv05r2eNmdIv/MlPuP4TdUknHG68UdWLgVZwgxVe735HzJNIwA==}
+
+ '@clack/core@1.2.0':
+ resolution: {integrity: sha512-qfxof/3T3t9DPU/Rj3OmcFyZInceqj/NVtO9rwIuJqCUgh32gwPjpFQQp/ben07qKlhpwq7GzfWpST4qdJ5Drg==}
+
+ '@clack/core@1.3.1':
+ resolution: {integrity: sha512-fT1qHVGAag4IEkrupZ6lRRbNCs1vS9P01KB/sG8zKgvUztbYtFBtQpjSITNwooDZ83tpsPzP0mRNs1/KVszCRA==}
+ engines: {node: '>= 20.12.0'}
+
+ '@clack/prompts@1.2.0':
+ resolution: {integrity: sha512-4jmztR9fMqPMjz6H/UZXj0zEmE43ha1euENwkckKKel4XpSfokExPo5AiVStdHSAlHekz4d0CA/r45Ok1E4D3w==}
+
+ '@clack/prompts@1.4.0':
+ resolution: {integrity: sha512-S0My7XPGIgpRWMDG8uRqalbgT+a6FmCUdOW+HaIOVVpUPHOb7RrpvjTjiODadKp06fsrVDJZlIzc6yCTp4AnxA==}
+ engines: {node: '>= 20.12.0'}
+
+ '@cloudflare/kv-asset-handler@0.4.2':
+ resolution: {integrity: sha512-SIOD2DxrRRwQ+jgzlXCqoEFiKOFqaPjhnNTGKXSRLvp1HiOvapLaFG2kEr9dYQTYe8rKrd9uvDUzmAITeNyaHQ==}
+ engines: {node: '>=18.0.0'}
+
+ '@codspeed/core@5.4.0':
+ resolution: {integrity: sha512-SwGjXDixN/zX1awBR95LzS0KxIs931qwf7Hbk7BRWv1jAdlMYf9o9GlSnWER4zGBHz941BvzFQJ1O2RIofW3cg==}
+
+ '@codspeed/vitest-plugin@5.4.0':
+ resolution: {integrity: sha512-Xa9HaZHUjYXn1T39bTipV5hmguk1vIuDZs3Gc5OYA8X4ohftYbKfyoFtBqVFfB/ii/p1ihuwt+tltraKMcRDsA==}
+ peerDependencies:
+ tinybench: '>=2.9.0'
+ vite: 8.0.12
+ vitest: ^3.2 || ^4
+
+ '@colordx/core@5.4.3':
+ resolution: {integrity: sha512-kIxYSfA5T8HXjav55UaaH/o/cKivF6jCCGIb8eqtcsfI46wsvlSiT8jMDyrl779qLec3c2c2oHBZo4oAhvbjrQ==}
+
+ '@colors/colors@1.5.0':
+ resolution: {integrity: sha512-ooWCrlZP11i8GImSjTHYHLkvFDP48nS4+204nGb1RiX/WXYHmJA2III9/e2DWVabCESdW7hBAEzHRqUn9OUVvQ==}
+ engines: {node: '>=0.1.90'}
+
+ '@discoveryjs/json-ext@0.6.3':
+ resolution: {integrity: sha512-4B4OijXeVNOPZlYA2oEwWOTkzyltLao+xbotHQeqN++Rv27Y6s818+n2Qkp8q+Fxhn0t/5lA5X1Mxktud8eayQ==}
+ engines: {node: '>=14.17.0'}
+
+ '@dxup/nuxt@0.4.1':
+ resolution: {integrity: sha512-gtYffW6OfWNvoLW+XD3Mx/K8uUq08PMGLYJoDxc92EzZAWqR0FhcR5iaLm5r/OxyGTKz+P5f5Y7Aoir9+SjYaw==}
+ peerDependencies:
+ typescript: '*'
+ peerDependenciesMeta:
+ typescript:
+ optional: true
+
+ '@dxup/unimport@0.1.2':
+ resolution: {integrity: sha512-/B8YJGPzaYq1NbsQmwgP8EZqg40NpTw4ZB3suuI0TplbxKHeK94jeaawLmVhCv+YwUnOpiWEz9U6SeThku/8JQ==}
+
+ '@emnapi/core@1.10.0':
+ resolution: {integrity: sha512-yq6OkJ4p82CAfPl0u9mQebQHKPJkY7WrIuk205cTYnYe+k2Z8YBh11FrbRG/H6ihirqcacOgl2BIO8oyMQLeXw==}
+
+ '@emnapi/core@1.9.2':
+ resolution: {integrity: sha512-UC+ZhH3XtczQYfOlu3lNEkdW/p4dsJ1r/bP7H8+rhao3TTTMO1ATq/4DdIi23XuGoFY+Cz0JmCbdVl0hz9jZcA==}
+
+ '@emnapi/runtime@1.10.0':
+ resolution: {integrity: sha512-ewvYlk86xUoGI0zQRNq/mC+16R1QeDlKQy21Ki3oSYXNgLb45GV1P6A0M+/s6nyCuNDqe5VpaY84BzXGwVbwFA==}
+
+ '@emnapi/runtime@1.9.2':
+ resolution: {integrity: sha512-3U4+MIWHImeyu1wnmVygh5WlgfYDtyf0k8AbLhMFxOipihf6nrWC4syIm/SwEeec0mNSafiiNnMJwbza/Is6Lw==}
+
+ '@emnapi/wasi-threads@1.2.1':
+ resolution: {integrity: sha512-uTII7OYF+/Mes/MrcIOYp5yOtSMLBWSIoLPpcgwipoiKbli6k322tcoFsxoIIxPDqW01SQGAgko4EzZi2BNv2w==}
+
+ '@es-joy/jsdoccomment@0.86.0':
+ resolution: {integrity: sha512-ukZmRQ81WiTpDWO6D/cTBM7XbrNtutHKvAVnZN/8pldAwLoJArGOvkNyxPTBGsPjsoaQBJxlH+tE2TNA/92Qgw==}
+ engines: {node: ^20.19.0 || ^22.13.0 || >=24}
+
+ '@es-joy/resolve.exports@1.2.0':
+ resolution: {integrity: sha512-Q9hjxWI5xBM+qW2enxfe8wDKdFWMfd0Z29k5ZJnuBqD/CasY5Zryj09aCA6owbGATWz+39p5uIdaHXpopOcG8g==}
+ engines: {node: '>=10'}
+
+ '@esbuild/aix-ppc64@0.25.12':
+ resolution: {integrity: sha512-Hhmwd6CInZ3dwpuGTF8fJG6yoWmsToE+vYgD4nytZVxcu1ulHpUQRAB1UJ8+N1Am3Mz4+xOByoQoSZf4D+CpkA==}
+ engines: {node: '>=18'}
+ cpu: [ppc64]
+ os: [aix]
+
+ '@esbuild/aix-ppc64@0.27.7':
+ resolution: {integrity: sha512-EKX3Qwmhz1eMdEJokhALr0YiD0lhQNwDqkPYyPhiSwKrh7/4KRjQc04sZ8db+5DVVnZ1LmbNDI1uAMPEUBnQPg==}
+ engines: {node: '>=18'}
+ cpu: [ppc64]
+ os: [aix]
+
+ '@esbuild/aix-ppc64@0.28.0':
+ resolution: {integrity: sha512-lhRUCeuOyJQURhTxl4WkpFTjIsbDayJHih5kZC1giwE+MhIzAb7mEsQMqMf18rHLsrb5qI1tafG20mLxEWcWlA==}
+ engines: {node: '>=18'}
+ cpu: [ppc64]
+ os: [aix]
+
+ '@esbuild/android-arm64@0.25.12':
+ resolution: {integrity: sha512-6AAmLG7zwD1Z159jCKPvAxZd4y/VTO0VkprYy+3N2FtJ8+BQWFXU+OxARIwA46c5tdD9SsKGZ/1ocqBS/gAKHg==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [android]
+
+ '@esbuild/android-arm64@0.27.7':
+ resolution: {integrity: sha512-62dPZHpIXzvChfvfLJow3q5dDtiNMkwiRzPylSCfriLvZeq0a1bWChrGx/BbUbPwOrsWKMn8idSllklzBy+dgQ==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [android]
+
+ '@esbuild/android-arm64@0.28.0':
+ resolution: {integrity: sha512-+WzIXQOSaGs33tLEgYPYe/yQHf0WTU0X42Jca3y8NWMbUVhp7rUnw+vAsRC/QiDrdD31IszMrZy+qwPOPjd+rw==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [android]
+
+ '@esbuild/android-arm@0.25.12':
+ resolution: {integrity: sha512-VJ+sKvNA/GE7Ccacc9Cha7bpS8nyzVv0jdVgwNDaR4gDMC/2TTRc33Ip8qrNYUcpkOHUT5OZ0bUcNNVZQ9RLlg==}
+ engines: {node: '>=18'}
+ cpu: [arm]
+ os: [android]
+
+ '@esbuild/android-arm@0.27.7':
+ resolution: {integrity: sha512-jbPXvB4Yj2yBV7HUfE2KHe4GJX51QplCN1pGbYjvsyCZbQmies29EoJbkEc+vYuU5o45AfQn37vZlyXy4YJ8RQ==}
+ engines: {node: '>=18'}
+ cpu: [arm]
+ os: [android]
+
+ '@esbuild/android-arm@0.28.0':
+ resolution: {integrity: sha512-wqh0ByljabXLKHeWXYLqoJ5jKC4XBaw6Hk08OfMrCRd2nP2ZQ5eleDZC41XHyCNgktBGYMbqnrJKq/K/lzPMSQ==}
+ engines: {node: '>=18'}
+ cpu: [arm]
+ os: [android]
+
+ '@esbuild/android-x64@0.25.12':
+ resolution: {integrity: sha512-5jbb+2hhDHx5phYR2By8GTWEzn6I9UqR11Kwf22iKbNpYrsmRB18aX/9ivc5cabcUiAT/wM+YIZ6SG9QO6a8kg==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [android]
+
+ '@esbuild/android-x64@0.27.7':
+ resolution: {integrity: sha512-x5VpMODneVDb70PYV2VQOmIUUiBtY3D3mPBG8NxVk5CogneYhkR7MmM3yR/uMdITLrC1ml/NV1rj4bMJuy9MCg==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [android]
+
+ '@esbuild/android-x64@0.28.0':
+ resolution: {integrity: sha512-+VJggoaKhk2VNNqVL7f6S189UzShHC/mR9EE8rDdSkdpN0KflSwWY/gWjDrNxxisg8Fp1ZCD9jLMo4m0OUfeUA==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [android]
+
+ '@esbuild/darwin-arm64@0.25.12':
+ resolution: {integrity: sha512-N3zl+lxHCifgIlcMUP5016ESkeQjLj/959RxxNYIthIg+CQHInujFuXeWbWMgnTo4cp5XVHqFPmpyu9J65C1Yg==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [darwin]
+
+ '@esbuild/darwin-arm64@0.27.7':
+ resolution: {integrity: sha512-5lckdqeuBPlKUwvoCXIgI2D9/ABmPq3Rdp7IfL70393YgaASt7tbju3Ac+ePVi3KDH6N2RqePfHnXkaDtY9fkw==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [darwin]
+
+ '@esbuild/darwin-arm64@0.28.0':
+ resolution: {integrity: sha512-0T+A9WZm+bZ84nZBtk1ckYsOvyA3x7e2Acj1KdVfV4/2tdG4fzUp91YHx+GArWLtwqp77pBXVCPn2We7Letr0Q==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [darwin]
+
+ '@esbuild/darwin-x64@0.25.12':
+ resolution: {integrity: sha512-HQ9ka4Kx21qHXwtlTUVbKJOAnmG1ipXhdWTmNXiPzPfWKpXqASVcWdnf2bnL73wgjNrFXAa3yYvBSd9pzfEIpA==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [darwin]
+
+ '@esbuild/darwin-x64@0.27.7':
+ resolution: {integrity: sha512-rYnXrKcXuT7Z+WL5K980jVFdvVKhCHhUwid+dDYQpH+qu+TefcomiMAJpIiC2EM3Rjtq0sO3StMV/+3w3MyyqQ==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [darwin]
+
+ '@esbuild/darwin-x64@0.28.0':
+ resolution: {integrity: sha512-fyzLm/DLDl/84OCfp2f/XQ4flmORsjU7VKt8HLjvIXChJoFFOIL6pLJPH4Yhd1n1gGFF9mPwtlN5Wf82DZs+LQ==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [darwin]
+
+ '@esbuild/freebsd-arm64@0.25.12':
+ resolution: {integrity: sha512-gA0Bx759+7Jve03K1S0vkOu5Lg/85dou3EseOGUes8flVOGxbhDDh/iZaoek11Y8mtyKPGF3vP8XhnkDEAmzeg==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [freebsd]
+
+ '@esbuild/freebsd-arm64@0.27.7':
+ resolution: {integrity: sha512-B48PqeCsEgOtzME2GbNM2roU29AMTuOIN91dsMO30t+Ydis3z/3Ngoj5hhnsOSSwNzS+6JppqWsuhTp6E82l2w==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [freebsd]
+
+ '@esbuild/freebsd-arm64@0.28.0':
+ resolution: {integrity: sha512-l9GeW5UZBT9k9brBYI+0WDffcRxgHQD8ShN2Ur4xWq/NFzUKm3k5lsH4PdaRgb2w7mI9u61nr2gI2mLI27Nh3Q==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [freebsd]
+
+ '@esbuild/freebsd-x64@0.25.12':
+ resolution: {integrity: sha512-TGbO26Yw2xsHzxtbVFGEXBFH0FRAP7gtcPE7P5yP7wGy7cXK2oO7RyOhL5NLiqTlBh47XhmIUXuGciXEqYFfBQ==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [freebsd]
+
+ '@esbuild/freebsd-x64@0.27.7':
+ resolution: {integrity: sha512-jOBDK5XEjA4m5IJK3bpAQF9/Lelu/Z9ZcdhTRLf4cajlB+8VEhFFRjWgfy3M1O4rO2GQ/b2dLwCUGpiF/eATNQ==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [freebsd]
+
+ '@esbuild/freebsd-x64@0.28.0':
+ resolution: {integrity: sha512-BXoQai/A0wPO6Es3yFJ7APCiKGc1tdAEOgeTNy3SsB491S3aHn4S4r3e976eUnPdU+NbdtmBuLncYir2tMU9Nw==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [freebsd]
+
+ '@esbuild/linux-arm64@0.25.12':
+ resolution: {integrity: sha512-8bwX7a8FghIgrupcxb4aUmYDLp8pX06rGh5HqDT7bB+8Rdells6mHvrFHHW2JAOPZUbnjUpKTLg6ECyzvas2AQ==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [linux]
+
+ '@esbuild/linux-arm64@0.27.7':
+ resolution: {integrity: sha512-RZPHBoxXuNnPQO9rvjh5jdkRmVizktkT7TCDkDmQ0W2SwHInKCAV95GRuvdSvA7w4VMwfCjUiPwDi0ZO6Nfe9A==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [linux]
+
+ '@esbuild/linux-arm64@0.28.0':
+ resolution: {integrity: sha512-RVyzfb3FWsGA55n6WY0MEIEPURL1FcbhFE6BffZEMEekfCzCIMtB5yyDcFnVbTnwk+CLAgTujmV/Lgvih56W+A==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [linux]
+
+ '@esbuild/linux-arm@0.25.12':
+ resolution: {integrity: sha512-lPDGyC1JPDou8kGcywY0YILzWlhhnRjdof3UlcoqYmS9El818LLfJJc3PXXgZHrHCAKs/Z2SeZtDJr5MrkxtOw==}
+ engines: {node: '>=18'}
+ cpu: [arm]
+ os: [linux]
+
+ '@esbuild/linux-arm@0.27.7':
+ resolution: {integrity: sha512-RkT/YXYBTSULo3+af8Ib0ykH8u2MBh57o7q/DAs3lTJlyVQkgQvlrPTnjIzzRPQyavxtPtfg0EopvDyIt0j1rA==}
+ engines: {node: '>=18'}
+ cpu: [arm]
+ os: [linux]
+
+ '@esbuild/linux-arm@0.28.0':
+ resolution: {integrity: sha512-CjaaREJagqJp7iTaNQjjidaNbCKYcd4IDkzbwwxtSvjI7NZm79qiHc8HqciMddQ6CKvJT6aBd8lO9kN/ZudLlw==}
+ engines: {node: '>=18'}
+ cpu: [arm]
+ os: [linux]
+
+ '@esbuild/linux-ia32@0.25.12':
+ resolution: {integrity: sha512-0y9KrdVnbMM2/vG8KfU0byhUN+EFCny9+8g202gYqSSVMonbsCfLjUO+rCci7pM0WBEtz+oK/PIwHkzxkyharA==}
+ engines: {node: '>=18'}
+ cpu: [ia32]
+ os: [linux]
+
+ '@esbuild/linux-ia32@0.27.7':
+ resolution: {integrity: sha512-GA48aKNkyQDbd3KtkplYWT102C5sn/EZTY4XROkxONgruHPU72l+gW+FfF8tf2cFjeHaRbWpOYa/uRBz/Xq1Pg==}
+ engines: {node: '>=18'}
+ cpu: [ia32]
+ os: [linux]
+
+ '@esbuild/linux-ia32@0.28.0':
+ resolution: {integrity: sha512-KBnSTt1kxl9x70q+ydterVdl+Cn0H18ngRMRCEQfrbqdUuntQQ0LoMZv47uB97NljZFzY6HcfqEZ2SAyIUTQBQ==}
+ engines: {node: '>=18'}
+ cpu: [ia32]
+ os: [linux]
+
+ '@esbuild/linux-loong64@0.25.12':
+ resolution: {integrity: sha512-h///Lr5a9rib/v1GGqXVGzjL4TMvVTv+s1DPoxQdz7l/AYv6LDSxdIwzxkrPW438oUXiDtwM10o9PmwS/6Z0Ng==}
+ engines: {node: '>=18'}
+ cpu: [loong64]
+ os: [linux]
+
+ '@esbuild/linux-loong64@0.27.7':
+ resolution: {integrity: sha512-a4POruNM2oWsD4WKvBSEKGIiWQF8fZOAsycHOt6JBpZ+JN2n2JH9WAv56SOyu9X5IqAjqSIPTaJkqN8F7XOQ5Q==}
+ engines: {node: '>=18'}
+ cpu: [loong64]
+ os: [linux]
+
+ '@esbuild/linux-loong64@0.28.0':
+ resolution: {integrity: sha512-zpSlUce1mnxzgBADvxKXX5sl8aYQHo2ezvMNI8I0lbblJtp8V4odlm3Yzlj7gPyt3T8ReksE6bK+pT3WD+aJRg==}
+ engines: {node: '>=18'}
+ cpu: [loong64]
+ os: [linux]
+
+ '@esbuild/linux-mips64el@0.25.12':
+ resolution: {integrity: sha512-iyRrM1Pzy9GFMDLsXn1iHUm18nhKnNMWscjmp4+hpafcZjrr2WbT//d20xaGljXDBYHqRcl8HnxbX6uaA/eGVw==}
+ engines: {node: '>=18'}
+ cpu: [mips64el]
+ os: [linux]
+
+ '@esbuild/linux-mips64el@0.27.7':
+ resolution: {integrity: sha512-KabT5I6StirGfIz0FMgl1I+R1H73Gp0ofL9A3nG3i/cYFJzKHhouBV5VWK1CSgKvVaG4q1RNpCTR2LuTVB3fIw==}
+ engines: {node: '>=18'}
+ cpu: [mips64el]
+ os: [linux]
+
+ '@esbuild/linux-mips64el@0.28.0':
+ resolution: {integrity: sha512-2jIfP6mmjkdmeTlsX/9vmdmhBmKADrWqN7zcdtHIeNSCH1SqIoNI63cYsjQR8J+wGa4Y5izRcSHSm8K3QWmk3w==}
+ engines: {node: '>=18'}
+ cpu: [mips64el]
+ os: [linux]
+
+ '@esbuild/linux-ppc64@0.25.12':
+ resolution: {integrity: sha512-9meM/lRXxMi5PSUqEXRCtVjEZBGwB7P/D4yT8UG/mwIdze2aV4Vo6U5gD3+RsoHXKkHCfSxZKzmDssVlRj1QQA==}
+ engines: {node: '>=18'}
+ cpu: [ppc64]
+ os: [linux]
+
+ '@esbuild/linux-ppc64@0.27.7':
+ resolution: {integrity: sha512-gRsL4x6wsGHGRqhtI+ifpN/vpOFTQtnbsupUF5R5YTAg+y/lKelYR1hXbnBdzDjGbMYjVJLJTd2OFmMewAgwlQ==}
+ engines: {node: '>=18'}
+ cpu: [ppc64]
+ os: [linux]
+
+ '@esbuild/linux-ppc64@0.28.0':
+ resolution: {integrity: sha512-bc0FE9wWeC0WBm49IQMPSPILRocGTQt3j5KPCA8os6VprfuJ7KD+5PzESSrJ6GmPIPJK965ZJHTUlSA6GNYEhg==}
+ engines: {node: '>=18'}
+ cpu: [ppc64]
+ os: [linux]
+
+ '@esbuild/linux-riscv64@0.25.12':
+ resolution: {integrity: sha512-Zr7KR4hgKUpWAwb1f3o5ygT04MzqVrGEGXGLnj15YQDJErYu/BGg+wmFlIDOdJp0PmB0lLvxFIOXZgFRrdjR0w==}
+ engines: {node: '>=18'}
+ cpu: [riscv64]
+ os: [linux]
+
+ '@esbuild/linux-riscv64@0.27.7':
+ resolution: {integrity: sha512-hL25LbxO1QOngGzu2U5xeXtxXcW+/GvMN3ejANqXkxZ/opySAZMrc+9LY/WyjAan41unrR3YrmtTsUpwT66InQ==}
+ engines: {node: '>=18'}
+ cpu: [riscv64]
+ os: [linux]
+
+ '@esbuild/linux-riscv64@0.28.0':
+ resolution: {integrity: sha512-SQPZOwoTTT/HXFXQJG/vBX8sOFagGqvZyXcgLA3NhIqcBv1BJU1d46c0rGcrij2B56Z2rNiSLaZOYW5cUk7yLQ==}
+ engines: {node: '>=18'}
+ cpu: [riscv64]
+ os: [linux]
+
+ '@esbuild/linux-s390x@0.25.12':
+ resolution: {integrity: sha512-MsKncOcgTNvdtiISc/jZs/Zf8d0cl/t3gYWX8J9ubBnVOwlk65UIEEvgBORTiljloIWnBzLs4qhzPkJcitIzIg==}
+ engines: {node: '>=18'}
+ cpu: [s390x]
+ os: [linux]
+
+ '@esbuild/linux-s390x@0.27.7':
+ resolution: {integrity: sha512-2k8go8Ycu1Kb46vEelhu1vqEP+UeRVj2zY1pSuPdgvbd5ykAw82Lrro28vXUrRmzEsUV0NzCf54yARIK8r0fdw==}
+ engines: {node: '>=18'}
+ cpu: [s390x]
+ os: [linux]
+
+ '@esbuild/linux-s390x@0.28.0':
+ resolution: {integrity: sha512-SCfR0HN8CEEjnYnySJTd2cw0k9OHB/YFzt5zgJEwa+wL/T/raGWYMBqwDNAC6dqFKmJYZoQBRfHjgwLHGSrn3Q==}
+ engines: {node: '>=18'}
+ cpu: [s390x]
+ os: [linux]
+
+ '@esbuild/linux-x64@0.25.12':
+ resolution: {integrity: sha512-uqZMTLr/zR/ed4jIGnwSLkaHmPjOjJvnm6TVVitAa08SLS9Z0VM8wIRx7gWbJB5/J54YuIMInDquWyYvQLZkgw==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [linux]
+
+ '@esbuild/linux-x64@0.27.7':
+ resolution: {integrity: sha512-hzznmADPt+OmsYzw1EE33ccA+HPdIqiCRq7cQeL1Jlq2gb1+OyWBkMCrYGBJ+sxVzve2ZJEVeePbLM2iEIZSxA==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [linux]
+
+ '@esbuild/linux-x64@0.28.0':
+ resolution: {integrity: sha512-us0dSb9iFxIi8srnpl931Nvs65it/Jd2a2K3qs7fz2WfGPHqzfzZTfec7oxZJRNPXPnNYZtanmRc4AL/JwVzHQ==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [linux]
+
+ '@esbuild/netbsd-arm64@0.25.12':
+ resolution: {integrity: sha512-xXwcTq4GhRM7J9A8Gv5boanHhRa/Q9KLVmcyXHCTaM4wKfIpWkdXiMog/KsnxzJ0A1+nD+zoecuzqPmCRyBGjg==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [netbsd]
+
+ '@esbuild/netbsd-arm64@0.27.7':
+ resolution: {integrity: sha512-b6pqtrQdigZBwZxAn1UpazEisvwaIDvdbMbmrly7cDTMFnw/+3lVxxCTGOrkPVnsYIosJJXAsILG9XcQS+Yu6w==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [netbsd]
+
+ '@esbuild/netbsd-arm64@0.28.0':
+ resolution: {integrity: sha512-CR/RYotgtCKwtftMwJlUU7xCVNg3lMYZ0RzTmAHSfLCXw3NtZtNpswLEj/Kkf6kEL3Gw+BpOekRX0BYCtklhUw==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [netbsd]
+
+ '@esbuild/netbsd-x64@0.25.12':
+ resolution: {integrity: sha512-Ld5pTlzPy3YwGec4OuHh1aCVCRvOXdH8DgRjfDy/oumVovmuSzWfnSJg+VtakB9Cm0gxNO9BzWkj6mtO1FMXkQ==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [netbsd]
+
+ '@esbuild/netbsd-x64@0.27.7':
+ resolution: {integrity: sha512-OfatkLojr6U+WN5EDYuoQhtM+1xco+/6FSzJJnuWiUw5eVcicbyK3dq5EeV/QHT1uy6GoDhGbFpprUiHUYggrw==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [netbsd]
+
+ '@esbuild/netbsd-x64@0.28.0':
+ resolution: {integrity: sha512-nU1yhmYutL+fQ71Kxnhg8uEOdC0pwEW9entHykTgEbna2pw2dkbFSMeqjjyHZoCmt8SBkOSvV+yNmm94aUrrqw==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [netbsd]
+
+ '@esbuild/openbsd-arm64@0.25.12':
+ resolution: {integrity: sha512-fF96T6KsBo/pkQI950FARU9apGNTSlZGsv1jZBAlcLL1MLjLNIWPBkj5NlSz8aAzYKg+eNqknrUJ24QBybeR5A==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [openbsd]
+
+ '@esbuild/openbsd-arm64@0.27.7':
+ resolution: {integrity: sha512-AFuojMQTxAz75Fo8idVcqoQWEHIXFRbOc1TrVcFSgCZtQfSdc1RXgB3tjOn/krRHENUB4j00bfGjyl2mJrU37A==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [openbsd]
+
+ '@esbuild/openbsd-arm64@0.28.0':
+ resolution: {integrity: sha512-cXb5vApOsRsxsEl4mcZ1XY3D4DzcoMxR/nnc4IyqYs0rTI8ZKmW6kyyg+11Z8yvgMfAEldKzP7AdP64HnSC/6g==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [openbsd]
+
+ '@esbuild/openbsd-x64@0.25.12':
+ resolution: {integrity: sha512-MZyXUkZHjQxUvzK7rN8DJ3SRmrVrke8ZyRusHlP+kuwqTcfWLyqMOE3sScPPyeIXN/mDJIfGXvcMqCgYKekoQw==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [openbsd]
+
+ '@esbuild/openbsd-x64@0.27.7':
+ resolution: {integrity: sha512-+A1NJmfM8WNDv5CLVQYJ5PshuRm/4cI6WMZRg1by1GwPIQPCTs1GLEUHwiiQGT5zDdyLiRM/l1G0Pv54gvtKIg==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [openbsd]
+
+ '@esbuild/openbsd-x64@0.28.0':
+ resolution: {integrity: sha512-8wZM2qqtv9UP3mzy7HiGYNH/zjTA355mpeuA+859TyR+e+Tc08IHYpLJuMsfpDJwoLo1ikIJI8jC3GFjnRClzA==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [openbsd]
+
+ '@esbuild/openharmony-arm64@0.25.12':
+ resolution: {integrity: sha512-rm0YWsqUSRrjncSXGA7Zv78Nbnw4XL6/dzr20cyrQf7ZmRcsovpcRBdhD43Nuk3y7XIoW2OxMVvwuRvk9XdASg==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [openharmony]
+
+ '@esbuild/openharmony-arm64@0.27.7':
+ resolution: {integrity: sha512-+KrvYb/C8zA9CU/g0sR6w2RBw7IGc5J2BPnc3dYc5VJxHCSF1yNMxTV5LQ7GuKteQXZtspjFbiuW5/dOj7H4Yw==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [openharmony]
+
+ '@esbuild/openharmony-arm64@0.28.0':
+ resolution: {integrity: sha512-FLGfyizszcef5C3YtoyQDACyg95+dndv79i2EekILBofh5wpCa1KuBqOWKrEHZg3zrL3t5ouE5jgr94vA+Wb2w==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [openharmony]
+
+ '@esbuild/sunos-x64@0.25.12':
+ resolution: {integrity: sha512-3wGSCDyuTHQUzt0nV7bocDy72r2lI33QL3gkDNGkod22EsYl04sMf0qLb8luNKTOmgF/eDEDP5BFNwoBKH441w==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [sunos]
+
+ '@esbuild/sunos-x64@0.27.7':
+ resolution: {integrity: sha512-ikktIhFBzQNt/QDyOL580ti9+5mL/YZeUPKU2ivGtGjdTYoqz6jObj6nOMfhASpS4GU4Q/Clh1QtxWAvcYKamA==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [sunos]
+
+ '@esbuild/sunos-x64@0.28.0':
+ resolution: {integrity: sha512-1ZgjUoEdHZZl/YlV76TSCz9Hqj9h9YmMGAgAPYd+q4SicWNX3G5GCyx9uhQWSLcbvPW8Ni7lj4gDa1T40akdlw==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [sunos]
+
+ '@esbuild/win32-arm64@0.25.12':
+ resolution: {integrity: sha512-rMmLrur64A7+DKlnSuwqUdRKyd3UE7oPJZmnljqEptesKM8wx9J8gx5u0+9Pq0fQQW8vqeKebwNXdfOyP+8Bsg==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [win32]
+
+ '@esbuild/win32-arm64@0.27.7':
+ resolution: {integrity: sha512-7yRhbHvPqSpRUV7Q20VuDwbjW5kIMwTHpptuUzV+AA46kiPze5Z7qgt6CLCK3pWFrHeNfDd1VKgyP4O+ng17CA==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [win32]
+
+ '@esbuild/win32-arm64@0.28.0':
+ resolution: {integrity: sha512-Q9StnDmQ/enxnpxCCLSg0oo4+34B9TdXpuyPeTedN/6+iXBJ4J+zwfQI28u/Jl40nOYAxGoNi7mFP40RUtkmUA==}
+ engines: {node: '>=18'}
+ cpu: [arm64]
+ os: [win32]
+
+ '@esbuild/win32-ia32@0.25.12':
+ resolution: {integrity: sha512-HkqnmmBoCbCwxUKKNPBixiWDGCpQGVsrQfJoVGYLPT41XWF8lHuE5N6WhVia2n4o5QK5M4tYr21827fNhi4byQ==}
+ engines: {node: '>=18'}
+ cpu: [ia32]
+ os: [win32]
+
+ '@esbuild/win32-ia32@0.27.7':
+ resolution: {integrity: sha512-SmwKXe6VHIyZYbBLJrhOoCJRB/Z1tckzmgTLfFYOfpMAx63BJEaL9ExI8x7v0oAO3Zh6D/Oi1gVxEYr5oUCFhw==}
+ engines: {node: '>=18'}
+ cpu: [ia32]
+ os: [win32]
+
+ '@esbuild/win32-ia32@0.28.0':
+ resolution: {integrity: sha512-zF3ag/gfiCe6U2iczcRzSYJKH1DCI+ByzSENHlM2FcDbEeo5Zd2C86Aq0tKUYAJJ1obRP84ymxIAksZUcdztHA==}
+ engines: {node: '>=18'}
+ cpu: [ia32]
+ os: [win32]
+
+ '@esbuild/win32-x64@0.25.12':
+ resolution: {integrity: sha512-alJC0uCZpTFrSL0CCDjcgleBXPnCrEAhTBILpeAp7M/OFgoqtAetfBzX0xM00MUsVVPpVjlPuMbREqnZCXaTnA==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [win32]
+
+ '@esbuild/win32-x64@0.27.7':
+ resolution: {integrity: sha512-56hiAJPhwQ1R4i+21FVF7V8kSD5zZTdHcVuRFMW0hn753vVfQN8xlx4uOPT4xoGH0Z/oVATuR82AiqSTDIpaHg==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [win32]
+
+ '@esbuild/win32-x64@0.28.0':
+ resolution: {integrity: sha512-pEl1bO9mfAmIC+tW5btTmrKaujg3zGtUmWNdCw/xs70FBjwAL3o9OEKNHvNmnyylD6ubxUERiEhdsL0xBQ9efw==}
+ engines: {node: '>=18'}
+ cpu: [x64]
+ os: [win32]
+
+ '@eslint-community/eslint-utils@4.9.1':
+ resolution: {integrity: sha512-phrYmNiYppR7znFEdqgfWHXR6NCkZEK7hwWDHZUjit/2/U0r6XvkDl0SYnoM51Hq7FhCGdLDT6zxCCOY1hexsQ==}
+ engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0}
+ peerDependencies:
+ eslint: ^6.0.0 || ^7.0.0 || >=8.0.0
+
+ '@eslint-community/regexpp@4.12.2':
+ resolution: {integrity: sha512-EriSTlt5OC9/7SXkRSCAhfSxxoSUgBm33OH+IkwbdpgoqsSsUg7y3uh+IICI/Qg4BBWr3U2i39RpmycbxMq4ew==}
+ engines: {node: ^12.0.0 || ^14.0.0 || >=16.0.0}
+
+ '@eslint/compat@2.1.0':
+ resolution: {integrity: sha512-LgaSCymEpw7tF53xvDw9SNsraPb1IBHxpdABIOM0hW8UAlP8znrjYtuxfR58FSJ3L9BhwD+FaPRFQpZq84Nh6g==}
+ engines: {node: ^20.19.0 || ^22.13.0 || >=24}
+ peerDependencies:
+ eslint: ^8.40 || 9 || 10
+ peerDependenciesMeta:
+ eslint:
+ optional: true
+
+ '@eslint/config-array@0.21.2':
+ resolution: {integrity: sha512-nJl2KGTlrf9GjLimgIru+V/mzgSK0ABCDQRvxw5BjURL7WfH5uoWmizbH7QB6MmnMBd8cIC9uceWnezL1VZWWw==}
+ engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+
+ '@eslint/config-helpers@0.4.2':
+ resolution: {integrity: sha512-gBrxN88gOIf3R7ja5K9slwNayVcZgK6SOUORm2uBzTeIEfeVaIhOpCtTox3P6R7o2jLFwLFTLnC7kU/RGcYEgw==}
+ engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+
+ '@eslint/config-helpers@0.5.5':
+ resolution: {integrity: sha512-eIJYKTCECbP/nsKaaruF6LW967mtbQbsw4JTtSVkUQc9MneSkbrgPJAbKl9nWr0ZeowV8BfsarBmPpBzGelA2w==}
+ engines: {node: ^20.19.0 || ^22.13.0 || >=24}
+
+ '@eslint/core@0.17.0':
+ resolution: {integrity: sha512-yL/sLrpmtDaFEiUj1osRP4TI2MDz1AddJL+jZ7KSqvBuliN4xqYY54IfdN8qD8Toa6g1iloph1fxQNkjOxrrpQ==}
+ engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+
+ '@eslint/core@1.2.1':
+ resolution: {integrity: sha512-MwcE1P+AZ4C6DWlpin/OmOA54mmIZ/+xZuJiQd4SyB29oAJjN30UW9wkKNptW2ctp4cEsvhlLY/CsQ1uoHDloQ==}
+ engines: {node: ^20.19.0 || ^22.13.0 || >=24}
+
+ '@eslint/eslintrc@3.3.5':
+ resolution: {integrity: sha512-4IlJx0X0qftVsN5E+/vGujTRIFtwuLbNsVUe7TO6zYPDR1O6nFwvwhIKEKSrl6dZchmYBITazxKoUYOjdtjlRg==}
+ engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+
+ '@eslint/js@9.39.4':
+ resolution: {integrity: sha512-nE7DEIchvtiFTwBw4Lfbu59PG+kCofhjsKaCWzxTpt4lfRjRMqG6uMBzKXuEcyXhOHoUp9riAm7/aWYGhXZ9cw==}
+ engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+
+ '@eslint/markdown@8.0.1':
+ resolution: {integrity: sha512-WWKmld/EyNdEB8GMq7JMPX1SDWgyJAM1uhtCi5ySrqYQM4HQjmg11EX/q3ZpnpRXHfdccFtli3NBvvGaYjWyQw==}
+ engines: {node: ^20.19.0 || ^22.13.0 || >=24}
+
+ '@eslint/object-schema@2.1.7':
+ resolution: {integrity: sha512-VtAOaymWVfZcmZbp6E2mympDIHvyjXs/12LqWYjVw6qjrfF+VK+fyG33kChz3nnK+SU5/NeHOqrTEHS8sXO3OA==}
+ engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+
+ '@eslint/plugin-kit@0.4.1':
+ resolution: {integrity: sha512-43/qtrDUokr7LJqoF2c3+RInu/t4zfrpYdoSDfYyhg52rwLV6TnOvdG4fXm7IkSB3wErkcmJS9iEhjVtOSEjjA==}
+ engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+
+ '@eslint/plugin-kit@0.6.1':
+ resolution: {integrity: sha512-iH1B076HoAshH1mLpHMgwdGeTs0CYwL0SPMkGuSebZrwBp16v415e9NZXg2jtrqPVQjf6IANe2Vtlr5KswtcZQ==}
+ engines: {node: ^20.19.0 || ^22.13.0 || >=24}
+
+ '@floating-ui/core@1.7.5':
+ resolution: {integrity: sha512-1Ih4WTWyw0+lKyFMcBHGbb5U5FtuHJuujoyyr5zTaWS5EYMeT6Jb2AuDeftsCsEuchO+mM2ij5+q9crhydzLhQ==}
+
+ '@floating-ui/dom@1.1.1':
+ resolution: {integrity: sha512-TpIO93+DIujg3g7SykEAGZMDtbJRrmnYRCNYSjJlvIbGhBjRSNTLVbNeDQBrzy9qDgUbiWdc7KA0uZHZ2tJmiw==}
+
+ '@floating-ui/dom@1.7.6':
+ resolution: {integrity: sha512-9gZSAI5XM36880PPMm//9dfiEngYoC6Am2izES1FF406YFsjvyBMmeJ2g4SAju3xWwtuynNRFL2s9hgxpLI5SQ==}
+
+ '@floating-ui/utils@0.2.11':
+ resolution: {integrity: sha512-RiB/yIh78pcIxl6lLMG0CgBXAZ2Y0eVHqMPYugu+9U0AeT6YBeiJpf7lbdJNIugFP5SIjwNRgo4DhR1Qxi26Gg==}
+
+ '@gwhitney/detect-indent@7.0.1':
+ resolution: {integrity: sha512-7bQW+gkKa2kKZPeJf6+c6gFK9ARxQfn+FKy9ScTBppyKRWH2KzsmweXUoklqeEiHiNVWaeP5csIdsNq6w7QhzA==}
+ engines: {node: '>=12.20'}
+
+ '@html-validate/stylish@6.0.0':
+ resolution: {integrity: sha512-d1/lI3qIXhGVJF3+MmKEBn1dRX6U4Z+BDaOdDI3E6SXcO+OQ7hC/3mSo6BIjwQlcuV6NdDOKm6QCrzIQL1EezQ==}
+ engines: {node: ^22.16.0 || >= 24.0.0}
+
+ '@humanfs/core@0.19.2':
+ resolution: {integrity: sha512-UhXNm+CFMWcbChXywFwkmhqjs3PRCmcSa/hfBgLIb7oQ5HNb1wS0icWsGtSAUNgefHeI+eBrA8I1fxmbHsGdvA==}
+ engines: {node: '>=18.18.0'}
+
+ '@humanfs/node@0.16.8':
+ resolution: {integrity: sha512-gE1eQNZ3R++kTzFUpdGlpmy8kDZD/MLyHqDwqjkVQI0JMdI1D51sy1H958PNXYkM2rAac7e5/CnIKZrHtPh3BQ==}
+ engines: {node: '>=18.18.0'}
+
+ '@humanfs/types@0.15.0':
+ resolution: {integrity: sha512-ZZ1w0aoQkwuUuC7Yf+7sdeaNfqQiiLcSRbfI08oAxqLtpXQr9AIVX7Ay7HLDuiLYAaFPu8oBYNq/QIi9URHJ3Q==}
+ engines: {node: '>=18.18.0'}
+
+ '@humanwhocodes/module-importer@1.0.1':
+ resolution: {integrity: sha512-bxveV4V8v5Yb4ncFTT3rPSgZBOpCkjfK0y4oVVVJwIuDVBRMDXrPyXRL988i5ap9m9bnyEEjWfm5WkBmtffLfA==}
+ engines: {node: '>=12.22'}
+
+ '@humanwhocodes/retry@0.4.3':
+ resolution: {integrity: sha512-bV0Tgo9K4hfPCek+aMAn81RppFKv2ySDQeMoSZuvTASywNTnVJCArCZE2FWqpvIatKu7VMRLWlR1EazvVhDyhQ==}
+ engines: {node: '>=18.18'}
+
+ '@iconify/types@2.0.0':
+ resolution: {integrity: sha512-+wluvCrRhXrhyOmRDJ3q8mux9JkKy5SJ/v8ol2tu4FVjyYvtEzkc/3pK15ET6RKg4b4w4BmTk1+gsCUhf21Ykg==}
+
+ '@iconify/utils@3.1.3':
+ resolution: {integrity: sha512-LPKOXPn/zV+zis1oOfGWogaXVpqUybF3ZS6SCZIsz8vg0ivVp9+fVqyYB7xq0aiST/VhUQYGO1qo6uoYSiEJqw==}
+
+ '@ioredis/commands@1.5.1':
+ resolution: {integrity: sha512-JH8ZL/ywcJyR9MmJ5BNqZllXNZQqQbnVZOqpPQqE1vHiFgAw4NHbvE0FOduNU8IX9babitBT46571OnPTT0Zcw==}
+
+ '@isaacs/cliui@8.0.2':
+ resolution: {integrity: sha512-O8jcjabXaleOG9DQ0+ARXWZBTfnP4WNAqzuiJK7ll44AmxGKv/J2M4TPjxjY3znBCfvBXFzucm1twdyFybFqEA==}
+ engines: {node: '>=12'}
+
+ '@isaacs/fs-minipass@4.0.1':
+ resolution: {integrity: sha512-wgm9Ehl2jpeqP3zw/7mo3kRHFp5MEDhqAdwy1fTGkHAwnkGOVsgpvQhL8B5n1qlb01jV3n/bI0ZfZp5lWA1k4w==}
+ engines: {node: '>=18.0.0'}
+
+ '@jest/pattern@30.4.0':
+ resolution: {integrity: sha512-RAWn3+f9u8BsHijKJ71uHcFp6vmyEt6VvoWXkl6hKF3qVIuWNmudVjg12DlBPGup/frIl5UcUlH5HfEuvHpEXg==}
+ engines: {node: ^18.14.0 || ^20.0.0 || ^22.0.0 || >=24.0.0}
+
+ '@jest/schemas@30.4.1':
+ resolution: {integrity: sha512-i6b4qw5qnP8c5FEeBJg/uZQ4ddrkN6Ca8qISJh0pr7a5hfn3h3v5x60BEbOC7OYAGZNMs1LfFLwnW2CuK8F57Q==}
+ engines: {node: ^18.14.0 || ^20.0.0 || ^22.0.0 || >=24.0.0}
+
+ '@jest/types@30.4.1':
+ resolution: {integrity: sha512-f1x/vJXIfjOlEmejYpbkbgw1gOqpPECwMvMEtBqe47j7H2Hg8h8w3o3ikhSXq3MI15kg+oQ0exWO0uCtTNJLoQ==}
+ engines: {node: ^18.14.0 || ^20.0.0 || ^22.0.0 || >=24.0.0}
+
+ '@jridgewell/gen-mapping@0.3.13':
+ resolution: {integrity: sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA==}
+
+ '@jridgewell/remapping@2.3.5':
+ resolution: {integrity: sha512-LI9u/+laYG4Ds1TDKSJW2YPrIlcVYOwi2fUC6xB43lueCjgxV4lffOCZCtYFiH6TNOX+tQKXx97T4IKHbhyHEQ==}
+
+ '@jridgewell/resolve-uri@3.1.2':
+ resolution: {integrity: sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==}
+ engines: {node: '>=6.0.0'}
+
+ '@jridgewell/source-map@0.3.11':
+ resolution: {integrity: sha512-ZMp1V8ZFcPG5dIWnQLr3NSI1MiCU7UETdS/A0G8V/XWHvJv3ZsFqutJn1Y5RPmAPX6F3BiE397OqveU/9NCuIA==}
+
+ '@jridgewell/sourcemap-codec@1.5.5':
+ resolution: {integrity: sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==}
+
+ '@jridgewell/trace-mapping@0.3.31':
+ resolution: {integrity: sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==}
+
+ '@jsonjoy.com/base64@1.1.2':
+ resolution: {integrity: sha512-q6XAnWQDIMA3+FTiOYajoYqySkO+JSat0ytXGSuRdq9uXE7o92gzuQwQM14xaCRlBLGq3v5miDGC4vkVTn54xA==}
+ engines: {node: '>=10.0'}
+ peerDependencies:
+ tslib: '2'
+
+ '@jsonjoy.com/base64@17.67.0':
+ resolution: {integrity: sha512-5SEsJGsm15aP8TQGkDfJvz9axgPwAEm98S5DxOuYe8e1EbfajcDmgeXXzccEjh+mLnjqEKrkBdjHWS5vFNwDdw==}
+ engines: {node: '>=10.0'}
+ peerDependencies:
+ tslib: '2'
+
+ '@jsonjoy.com/buffers@1.2.1':
+ resolution: {integrity: sha512-12cdlDwX4RUM3QxmUbVJWqZ/mrK6dFQH4Zxq6+r1YXKXYBNgZXndx2qbCJwh3+WWkCSn67IjnlG3XYTvmvYtgA==}
+ engines: {node: '>=10.0'}
+ peerDependencies:
+ tslib: '2'
+
+ '@jsonjoy.com/buffers@17.67.0':
+ resolution: {integrity: sha512-tfExRpYxBvi32vPs9ZHaTjSP4fHAfzSmcahOfNxtvGHcyJel+aibkPlGeBB+7AoC6hL7lXIE++8okecBxx7lcw==}
+ engines: {node: '>=10.0'}
+ peerDependencies:
+ tslib: '2'
+
+ '@jsonjoy.com/codegen@1.0.0':
+ resolution: {integrity: sha512-E8Oy+08cmCf0EK/NMxpaJZmOxPqM+6iSe2S4nlSBrPZOORoDJILxtbSUEDKQyTamm/BVAhIGllOBNU79/dwf0g==}
+ engines: {node: '>=10.0'}
+ peerDependencies:
+ tslib: '2'
+
+ '@jsonjoy.com/codegen@17.67.0':
+ resolution: {integrity: sha512-idnkUplROpdBOV0HMcwhsCUS5TRUi9poagdGs70A6S4ux9+/aPuKbh8+UYRTLYQHtXvAdNfQWXDqZEx5k4Dj2Q==}
+ engines: {node: '>=10.0'}
+ peerDependencies:
+ tslib: '2'
+
+ '@jsonjoy.com/fs-core@4.57.2':
+ resolution: {integrity: sha512-SVjwklkpIV5wrynpYtuYnfYH1QF4/nDuLBX7VXdb+3miglcAgBVZb/5y0cOsehRV/9Vb+3UqhkMq3/NR3ztdkQ==}
+ engines: {node: '>=10.0'}
+ peerDependencies:
+ tslib: '2'
+
+ '@jsonjoy.com/fs-fsa@4.57.2':
+ resolution: {integrity: sha512-fhO8+iR2I+OCw668ISDJdn1aArc9zx033sWejIyzQ8RBeXa9bDSaUeA3ix0poYOfrj1KdOzytmYNv2/uLDfV6g==}
+ engines: {node: '>=10.0'}
+ peerDependencies:
+ tslib: '2'
+
+ '@jsonjoy.com/fs-node-builtins@4.57.2':
+ resolution: {integrity: sha512-xhiegylRmhw43Ki2HO1ZBL7DQ5ja/qpRsL29VtQ2xuUHiuDGbgf2uD4p9Qd8hJI5P6RCtGYD50IXHXVq/Ocjcg==}
+ engines: {node: '>=10.0'}
+ peerDependencies:
+ tslib: '2'
+
+ '@jsonjoy.com/fs-node-to-fsa@4.57.2':
+ resolution: {integrity: sha512-18LmWTSONhoAPW+IWRuf8w/+zRolPFGPeGwMxlAhhfY11EKzX+5XHDBPAw67dBF5dxDErHJbl40U+3IXSDRXSQ==}
+ engines: {node: '>=10.0'}
+ peerDependencies:
+ tslib: '2'
+
+ '@jsonjoy.com/fs-node-utils@4.57.2':
+ resolution: {integrity: sha512-rsPSJgekz43IlNbLyAM/Ab+ouYLWGp5DDBfYBNNEqDaSpsbXfthBn29Q4muFA9L0F+Z3mKo+CWlgSCXrf+mOyQ==}
+ engines: {node: '>=10.0'}
+ peerDependencies:
+ tslib: '2'
+
+ '@jsonjoy.com/fs-node@4.57.2':
+ resolution: {integrity: sha512-nX2AdL6cOFwLdju9G4/nbRnYevmCJbh7N7hvR3gGm97Cs60uEjyd0rpR+YBS7cTg175zzl22pGKXR5USaQMvKg==}
+ engines: {node: '>=10.0'}
+ peerDependencies:
+ tslib: '2'
+
+ '@jsonjoy.com/fs-print@4.57.2':
+ resolution: {integrity: sha512-wK9NSow48i4DbDl9F1CQE5TqnyZOJ04elU3WFG5aJ76p+YxO/ulyBBQvKsessPxdo381Bc2pcEoyPujMOhcRqQ==}
+ engines: {node: '>=10.0'}
+ peerDependencies:
+ tslib: '2'
+
+ '@jsonjoy.com/fs-snapshot@4.57.2':
+ resolution: {integrity: sha512-GdduDZuoP5V/QCgJkx9+BZ6SC0EZ/smXAdTS7PfMqgMTGXLlt/bH/FqMYaqB9JmLf05sJPtO0XRbAwwkEEPbVw==}
+ engines: {node: '>=10.0'}
+ peerDependencies:
+ tslib: '2'
+
+ '@jsonjoy.com/json-pack@1.21.0':
+ resolution: {integrity: sha512-+AKG+R2cfZMShzrF2uQw34v3zbeDYUqnQ+jg7ORic3BGtfw9p/+N6RJbq/kkV8JmYZaINknaEQ2m0/f693ZPpg==}
+ engines: {node: '>=10.0'}
+ peerDependencies:
+ tslib: '2'
+
+ '@jsonjoy.com/json-pack@17.67.0':
+ resolution: {integrity: sha512-t0ejURcGaZsn1ClbJ/3kFqSOjlryd92eQY465IYrezsXmPcfHPE/av4twRSxf6WE+TkZgLY+71vCZbiIiFKA/w==}
+ engines: {node: '>=10.0'}
+ peerDependencies:
+ tslib: '2'
+
+ '@jsonjoy.com/json-pointer@1.0.2':
+ resolution: {integrity: sha512-Fsn6wM2zlDzY1U+v4Nc8bo3bVqgfNTGcn6dMgs6FjrEnt4ZCe60o6ByKRjOGlI2gow0aE/Q41QOigdTqkyK5fg==}
+ engines: {node: '>=10.0'}
+ peerDependencies:
+ tslib: '2'
+
+ '@jsonjoy.com/json-pointer@17.67.0':
+ resolution: {integrity: sha512-+iqOFInH+QZGmSuaybBUNdh7yvNrXvqR+h3wjXm0N/3JK1EyyFAeGJvqnmQL61d1ARLlk/wJdFKSL+LHJ1eaUA==}
+ engines: {node: '>=10.0'}
+ peerDependencies:
+ tslib: '2'
+
+ '@jsonjoy.com/util@1.9.0':
+ resolution: {integrity: sha512-pLuQo+VPRnN8hfPqUTLTHk126wuYdXVxE6aDmjSeV4NCAgyxWbiOIeNJVtID3h1Vzpoi9m4jXezf73I6LgabgQ==}
+ engines: {node: '>=10.0'}
+ peerDependencies:
+ tslib: '2'
+
+ '@jsonjoy.com/util@17.67.0':
+ resolution: {integrity: sha512-6+8xBaz1rLSohlGh68D1pdw3AwDi9xydm8QNlAFkvnavCJYSze+pxoW2VKP8p308jtlMRLs5NTHfPlZLd4w7ew==}
+ engines: {node: '>=10.0'}
+ peerDependencies:
+ tslib: '2'
+
+ '@loaderkit/resolve@1.0.6':
+ resolution: {integrity: sha512-G8FdIoF5CypfwmD9rl8BXod5HDn8JqB0CCNBXDTaRZ+yRYhARrrSToX1zg1zy9jX3zLqigsELwhT4gNtkdQAUg==}
+
+ '@mapbox/node-pre-gyp@2.0.3':
+ resolution: {integrity: sha512-uwPAhccfFJlsfCxMYTwOdVfOz3xqyj8xYL3zJj8f0pb30tLohnnFPhLuqp4/qoEz8sNxe4SESZedcBojRefIzg==}
+ engines: {node: '>=18'}
+ hasBin: true
+
+ '@napi-rs/wasm-runtime@1.1.4':
+ resolution: {integrity: sha512-3NQNNgA1YSlJb/kMH1ildASP9HW7/7kYnRI2szWJaofaS1hWmbGI4H+d3+22aGzXXN9IJ+n+GiFVcGipJP18ow==}
+ peerDependencies:
+ '@emnapi/core': ^1.7.1
+ '@emnapi/runtime': ^1.7.1
+
+ '@nodelib/fs.scandir@2.1.5':
+ resolution: {integrity: sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==}
+ engines: {node: '>= 8'}
+
+ '@nodelib/fs.stat@2.0.5':
+ resolution: {integrity: sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==}
+ engines: {node: '>= 8'}
+
+ '@nodelib/fs.walk@1.2.8':
+ resolution: {integrity: sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==}
+ engines: {node: '>= 8'}
+
+ '@npmcli/map-workspaces@3.0.6':
+ resolution: {integrity: sha512-tkYs0OYnzQm6iIRdfy+LcLBjcKuQCeE5YLb8KnrIlutJfheNaPvPpgoFEyEFgbjzl5PLZ3IA/BWAwRU0eHuQDA==}
+ engines: {node: ^14.17.0 || ^16.13.0 || >=18.0.0}
+
+ '@npmcli/name-from-folder@2.0.0':
+ resolution: {integrity: sha512-pwK+BfEBZJbKdNYpHHRTNBwBoqrN/iIMO0AiGvYsp3Hoaq0WbgGSWQR6SCldZovoDpY3yje5lkFUe6gsDgJ2vg==}
+ engines: {node: ^14.17.0 || ^16.13.0 || >=18.0.0}
+
+ '@nuxt/cli@3.35.2':
+ resolution: {integrity: sha512-sCxNnFuYamqippdj+Cj4Nue55yaUvasaneyf2mnowK5/F1TKln/WVqTH18McxQ4baLlIlVapIFovKjJx1L8XMQ==}
+ engines: {node: ^16.14.0 || >=18.0.0}
+ hasBin: true
+ peerDependencies:
+ '@nuxt/schema': workspace:*
+ peerDependenciesMeta:
+ '@nuxt/schema':
+ optional: true
+
+ '@nuxt/devtools-kit@2.7.0':
+ resolution: {integrity: sha512-MIJdah6CF6YOW2GhfKnb8Sivu6HpcQheqdjOlZqShBr+1DyjtKQbAKSCAyKPaoIzZP4QOo2SmTFV6aN8jBeEIQ==}
+ peerDependencies:
+ vite: 8.0.12
+
+ '@nuxt/devtools-kit@3.2.4':
+ resolution: {integrity: sha512-Yxy2Xgmq5hf3dQy983V0xh0OJV2mYwRZz9eVIGc3EaribdFGPDNGMMbYqX9qCty3Pbxn/bCF3J0UyPaNlHVayQ==}
+ peerDependencies:
+ vite: 8.0.12
+
+ '@nuxt/devtools-kit@4.0.0-alpha.4':
+ resolution: {integrity: sha512-y8IJJZMFf9igUUSVUt7zQTQHhc1rVKGRQUN9VfVHPWpYGOB+w2Owgy6mU6tv63zbz6RxyEJ1ZMKhQQaqFOzAWQ==}
+ peerDependencies:
+ vite: 8.0.12
+
+ '@nuxt/devtools@4.0.0-alpha.4':
+ resolution: {integrity: sha512-RHxJ7hk4RZazvwvgnT88QmZd2Li8NNWRi68p3Ocj9nCoYEkHZrbgWTfyEvilBW0PpPzvneDfKzOAZBx5wEuAyw==}
+ peerDependencies:
+ vite: 8.0.12
+
+ '@nuxt/eslint-config@1.15.2':
+ resolution: {integrity: sha512-vS6mWB87tYjB8h3TxG/QziaZ6CGJpEOBd7N/j+64/tjNipUJzNgKwDzyGoOifNqyDDnlvgi6T3m9XpeYm4qRaA==}
+ peerDependencies:
+ eslint: ^9.0.0 || ^10.0.0
+ eslint-plugin-format: '*'
+ peerDependenciesMeta:
+ eslint-plugin-format:
+ optional: true
+
+ '@nuxt/eslint-plugin@1.15.2':
+ resolution: {integrity: sha512-LZ4gEcPP5GjzAkb6Kk04a4v0vvkTLOpmnEvdDatnkSlxtQLUSwX8v11vcDGXL92ZQ98dFoC1Q1IA6Tz3jdFIig==}
+ peerDependencies:
+ eslint: ^9.0.0 || ^10.0.0
+
+ '@nuxt/friendly-errors-webpack-plugin@2.6.0':
+ resolution: {integrity: sha512-3IZj6MXbzlvUxDncAxgBMLQwGPY/JlNhy2i+AGyOHCAReR5HcBxYjVRBvyaKM9R3s5k4OODYKeHAbrToZH/47w==}
+ engines: {node: '>=14.18.0', npm: '>=5.0.0'}
+ peerDependencies:
+ webpack: ^2.0.0 || ^3.0.0 || ^4.0.0 || ^5.0.0
+
+ '@nuxt/scripts@1.1.0':
+ resolution: {integrity: sha512-kUD1IfWMgrd/FCKUwpob7NciwUHfUuEr2kIzAaTilb0SSjScxvuvVNN38LyJE8O5bFOrFNqOUaloLvdGT/Bckw==}
+ hasBin: true
+ peerDependencies:
+ '@googlemaps/markerclusterer': ^2.6.2
+ '@paypal/paypal-js': ^8.1.2 || ^9.0.0
+ '@stripe/stripe-js': ^7.0.0 || ^8.0.0 || ^9.0.0
+ '@types/google.maps': ^3.58.1
+ '@types/vimeo__player': ^2.18.3
+ '@types/youtube': ^0.1.0
+ '@unhead/vue': ^2.0.3
+ posthog-js: ^1.0.0
+ peerDependenciesMeta:
+ '@googlemaps/markerclusterer':
+ optional: true
+ '@paypal/paypal-js':
+ optional: true
+ '@stripe/stripe-js':
+ optional: true
+ '@types/google.maps':
+ optional: true
+ '@types/vimeo__player':
+ optional: true
+ '@types/youtube':
+ optional: true
+ posthog-js:
+ optional: true
+
+ '@nuxt/telemetry@2.8.0':
+ resolution: {integrity: sha512-zAwXY24KYvpLTmiV+osagd2EHkfs5IF+7oDZYTQoit5r0kPlwaCNlzHp5I/wUAWT4LBw6lG8gZ6bWidAdv/erQ==}
+ engines: {node: '>=18.12.0'}
+ hasBin: true
+ peerDependencies:
+ '@nuxt/kit': workspace:*
+
+ '@nuxt/test-utils@4.0.3':
+ resolution: {integrity: sha512-HwF3B+GIwzWeIioskhHIjq+TQttP7+g0GUO39hpivGWFZzYXD3lIspzfmliJkgwwA3m5Xl2Z8XXqX1zAolKX6w==}
+ engines: {node: ^20.19.0 || ^22.12.0 || >=24.0.0}
+ peerDependencies:
+ '@cucumber/cucumber': '>=11.0.0'
+ '@jest/globals': '>=30.0.0'
+ '@playwright/test': ^1.43.1
+ '@testing-library/vue': ^8.0.1
+ '@vitest/ui': '*'
+ '@vue/test-utils': ^2.4.2
+ happy-dom: '>=20.0.11'
+ jsdom: '>=27.4.0'
+ playwright-core: ^1.43.1
+ vitest: ^4.0.2
+ peerDependenciesMeta:
+ '@cucumber/cucumber':
+ optional: true
+ '@jest/globals':
+ optional: true
+ '@playwright/test':
+ optional: true
+ '@testing-library/vue':
+ optional: true
+ '@vitest/ui':
+ optional: true
+ '@vue/test-utils':
+ optional: true
+ happy-dom:
+ optional: true
+ jsdom:
+ optional: true
+ playwright-core:
+ optional: true
+ vitest:
+ optional: true
+
+ '@nuxtjs/mdc@0.22.0':
+ resolution: {integrity: sha512-4jVc967snO5oOZtVhDnLi2Nu8kSsvGU66bsufKGU/Ixsj5lzA3HdaLMJEkFNs8AXtVXJUbkZ2PhvTttFHo8Kgw==}
+
+ '@one-ini/wasm@0.1.1':
+ resolution: {integrity: sha512-XuySG1E38YScSJoMlqovLru4KTUNSjgVTIjyh7qMX6aNN5HY5Ct5LhRJdxO79JtTzKfzV/bnWpz+zquYrISsvw==}
+
+ '@oxc-parser/binding-android-arm-eabi@0.124.0':
+ resolution: {integrity: sha512-+R9zCafSL8ovjokdPtorUp3sXrh8zQ2AC2L0ivXNvlLR0WS+5WdPkNVrnENq5UvzagM4Xgl0NPsJKz3Hv9+y8g==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm]
+ os: [android]
+
+ '@oxc-parser/binding-android-arm-eabi@0.126.0':
+ resolution: {integrity: sha512-svyoHt25J4741QJ5aa4R+h0iiBeSRt63Lr3aAZcxy2c/NeSE1IfDeMnSij6rIg7EjxkdlXzz613wUjeCeilBNA==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm]
+ os: [android]
+
+ '@oxc-parser/binding-android-arm-eabi@0.127.0':
+ resolution: {integrity: sha512-0LC7ye4hvqbIKxAzThzvswgHLFu2AURKzYLeSVvLdu2TBOYWQDmHnTqPLeA597BcUCxiLqLsS4CJ5uoI5WYWCQ==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm]
+ os: [android]
+
+ '@oxc-parser/binding-android-arm-eabi@0.130.0':
+ resolution: {integrity: sha512-h/xYU8/7ADWzVSf5I+YalLpj33LOy9CI/zgbJNIZ5eunRBG+Czqa3lZsvuPHHf3rOt6z1c5+UzoxjbAzAvhwVw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm]
+ os: [android]
+
+ '@oxc-parser/binding-android-arm64@0.124.0':
+ resolution: {integrity: sha512-ULHC/gVZ+nP4pd3kNNQTYaQ/e066BW/KuY5qUsvwkVWwOUQGDg+WpfyVOmQ4xfxoue6cMlkKkJ+ntdzfDXpNlg==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [android]
+
+ '@oxc-parser/binding-android-arm64@0.126.0':
+ resolution: {integrity: sha512-hPEBRKgplp1mG9GkINFsr4JVMDNrGJLOqfDaadTWpAoTnzYR5Rmv8RMvB3hJZpiNvbk1aacopdHUP1pggMQ/cw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [android]
+
+ '@oxc-parser/binding-android-arm64@0.127.0':
+ resolution: {integrity: sha512-b5jtVTH6AU5CJXHNdj7Jj9IEiR9yVjjnwHzPJhGyHGPdcsZSzBCkS9GBbV33niRMvKthDwQRFRJfI4a+k4PvYg==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [android]
+
+ '@oxc-parser/binding-android-arm64@0.130.0':
+ resolution: {integrity: sha512-oFWFJrsGv9siFM4HjMqKNB7IuIZD/SMmZdCXl8xyx7lDplGvPKyewpOo272rSWgMXe2Wx7bWI0Yj+gkHv4qbeg==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [android]
+
+ '@oxc-parser/binding-darwin-arm64@0.124.0':
+ resolution: {integrity: sha512-fGJ2hw7bnbUYn6UvTjp0m4WJ9zXz3cohgcwcgeo7gUZehpPNpvcVEVeIVHNmHnAuAw/ysf4YJR8DA1E+xCA4Lw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [darwin]
+
+ '@oxc-parser/binding-darwin-arm64@0.126.0':
+ resolution: {integrity: sha512-ccRpu9sdYmznePJQG5halhs0FW5tw5a8zRSoZXOzM1OjoeZ4jiRRruFiPclsD59edoVAK1l83dvfjWz1nQi6lg==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [darwin]
+
+ '@oxc-parser/binding-darwin-arm64@0.127.0':
+ resolution: {integrity: sha512-obCE8B7ISKkJidjlhv9xRGJPOSDG2Yu6PRga9Ruaz35uintHxbp1Ki/Yc71wx4rj3Edrm0a1kzG1TAwit0wFpg==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [darwin]
+
+ '@oxc-parser/binding-darwin-arm64@0.130.0':
+ resolution: {integrity: sha512-sGUzupdTplK9jQg7eJZ878HfEgQjJNBc6dAYVWJ9W5aU+J8rLfRJhTVsKThiu1pNwm6Y1qKCcbC6WhNWSXR3Ig==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [darwin]
+
+ '@oxc-parser/binding-darwin-x64@0.124.0':
+ resolution: {integrity: sha512-j0+re9pgps5BH2Tk3fm59Hi3QuLP3C4KhqXi6A+wRHHHJWDFR8mc/KI9mBrfk2JRT+15doGo+zv1eN75/9DuOw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [darwin]
+
+ '@oxc-parser/binding-darwin-x64@0.126.0':
+ resolution: {integrity: sha512-CHB4zVjNSKqx8Fw9pHowzQQnjjuq04i4Ng0Avj+DixlwhwAoMYqlFbocYIlbg+q3zOLGlm7vEHm83jqEMitnyg==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [darwin]
+
+ '@oxc-parser/binding-darwin-x64@0.127.0':
+ resolution: {integrity: sha512-JL6Xb5IwPQT8rUzlpsX7E+AgfcdNklXNPFp8pjCQQ5MQOQo5rtEB2ui+3Hgg9Sn7Y9Egj6YOLLiHhLpdAe12Aw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [darwin]
+
+ '@oxc-parser/binding-darwin-x64@0.130.0':
+ resolution: {integrity: sha512-PsB4cdCISbC00Uy8eiD8bc2AkGWjZqrSrJnkBFuG2ptrrf6mZ2F5gLFSjOAVMMgZPg8B1D7OydJwLWSfyI2Plg==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [darwin]
+
+ '@oxc-parser/binding-freebsd-x64@0.124.0':
+ resolution: {integrity: sha512-0k5mS0npnrhKy72UfF51lpOZ2ESoPWn6gdFw+RdeRWcokraDW1O2kSx3laQ+yk7cCEavQdJSpWCYS/GvBbUCXQ==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [freebsd]
+
+ '@oxc-parser/binding-freebsd-x64@0.126.0':
+ resolution: {integrity: sha512-RQ3nEJdcDKBfBjmLJ3Vl1d0KQERPV1P8eUrnBm7+VTYyoaJSPLVFuPg1mlD1hk3n0/879VLFMfusFkBal4ssWQ==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [freebsd]
+
+ '@oxc-parser/binding-freebsd-x64@0.127.0':
+ resolution: {integrity: sha512-SDQ/3MQFw58fqQz3Z1PhSKFF3JoCF4gmlNjziDm8X02tTahCw0qJbd7FGPDKw1i4VTBZene9JPyC3mHtSvi+wA==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [freebsd]
+
+ '@oxc-parser/binding-freebsd-x64@0.130.0':
+ resolution: {integrity: sha512-DgABp3l38hS77JbXCV4qk1+n6DPym5u8zzwuweokezm2tX194nDSJDENbDRECxVsiNbprKATLbk+Z5wlHT0OHw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [freebsd]
+
+ '@oxc-parser/binding-linux-arm-gnueabihf@0.124.0':
+ resolution: {integrity: sha512-P/i4eguRWvAUfGdfhQYg1jpwYkyUV6D3gefIH7HhmRl1Ph6P4IqTIEVcyJr1i/3vr1V5OHU4wonH6/ue/Qzvrw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm]
+ os: [linux]
+
+ '@oxc-parser/binding-linux-arm-gnueabihf@0.126.0':
+ resolution: {integrity: sha512-onipc2wCDA7Bauzb4KK1mab0GsEDf4ujiIfWECdnmY/2LlzAoX3xdQRLAUyEDB1kn3yilHBrkmXDdHluyHXxiw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm]
+ os: [linux]
+
+ '@oxc-parser/binding-linux-arm-gnueabihf@0.127.0':
+ resolution: {integrity: sha512-Av+D1MIqzV0YMGPT9we2SIZaMKD7Cxs4CvXSx/yxaWHewZjYEjScpOf5igc8IILASViw4WTnjlwUdI1KzVtDHQ==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm]
+ os: [linux]
+
+ '@oxc-parser/binding-linux-arm-gnueabihf@0.130.0':
+ resolution: {integrity: sha512-4Kn3CTEmwFrzhTSC/JuUW16qovmaMdX7jeSKbL8w0pLtLww7To1a2XJi9Z5uD8QWUkfUHhqfV+VD6dVzBnWzoA==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm]
+ os: [linux]
+
+ '@oxc-parser/binding-linux-arm-musleabihf@0.124.0':
+ resolution: {integrity: sha512-/ameqFQH5fFP+66Atr8Ynv/2rYe4utcU7L4MoWS5JtrFLVO78g4qDLavyIlJxa6caSwYOvG/eO3c/DXqY5/6Rw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm]
+ os: [linux]
+
+ '@oxc-parser/binding-linux-arm-musleabihf@0.126.0':
+ resolution: {integrity: sha512-5BuJJPohrV5NJ8lmcYOMbfRCUGoYH5J9HZHeuqOLwkHXWAuPMN3X1h8bC/2mWjmosdbfTtmyIdX3spS/TkqKNg==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm]
+ os: [linux]
+
+ '@oxc-parser/binding-linux-arm-musleabihf@0.127.0':
+ resolution: {integrity: sha512-Cs2fdJ8cPpFdeebj6p4dag8A4+56hPvZ0AhQQzlaLswGz1tz7bXt1nETLeorrM9+AMcWFFkqxcXwDGfTVidY8g==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm]
+ os: [linux]
+
+ '@oxc-parser/binding-linux-arm-musleabihf@0.130.0':
+ resolution: {integrity: sha512-D35KZM3F4rRu1uAFKyBlg3Gaf/ybCjyaPR1hfgvk5ex8NtcTmRgc0JgSighEyNg96TPrFhemFba68SZuxaha8w==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm]
+ os: [linux]
+
+ '@oxc-parser/binding-linux-arm64-gnu@0.124.0':
+ resolution: {integrity: sha512-gNeyEcXTtfrRCbj2EfxWU85Fs0wIX3p44Y3twnvuMfkWlLrb9M1Z25AYNSKjJM+fdAjeeQCjw0on47zFuBYwQw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [linux]
+ libc: [glibc]
+
+ '@oxc-parser/binding-linux-arm64-gnu@0.126.0':
+ resolution: {integrity: sha512-r2KApRgm2pOJaduRm6GOT8x0whcr67AyejNkSdzPt34GJ+Y3axcXN2mwlTs+8lfO/SSmpO5ZJGYiHYnxEE0jkw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [linux]
+ libc: [glibc]
+
+ '@oxc-parser/binding-linux-arm64-gnu@0.127.0':
+ resolution: {integrity: sha512-qdOfTcT6SY8gsJrrV92uyEUyjqMGPpIB5JZUG6QN5dukYd+7/j0kX6MwK1DgQj39jtUYixxPiaRUiEN1+0CXgQ==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [linux]
+ libc: [glibc]
+
+ '@oxc-parser/binding-linux-arm64-gnu@0.130.0':
+ resolution: {integrity: sha512-Q9o7oVlo955KHwS8l1u0bCzIx+JsZUA3XToLXC+MsMhye/9LeBQbt84nh120cl2XLy+TEzvugYDiHShg5yaX6Q==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [linux]
+ libc: [glibc]
+
+ '@oxc-parser/binding-linux-arm64-musl@0.124.0':
+ resolution: {integrity: sha512-uvG7v4Tz9S8/PVqY0SP0DLHxo4hZGe+Pv2tGVnwcsjKCCUPjplbrFVvDzXq+kOaEoUkiCY0Kt1hlZ6FDJ1LKNQ==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [linux]
+ libc: [musl]
+
+ '@oxc-parser/binding-linux-arm64-musl@0.126.0':
+ resolution: {integrity: sha512-FQ+MMh7MT0Dr/u8+RWmWKlfoeWPQyHDbhhxJShJlYtROXXPHsRs9EvmQOZZ3sx4Nn7JU8NX+oyw2YzQ7anBJcA==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [linux]
+ libc: [musl]
+
+ '@oxc-parser/binding-linux-arm64-musl@0.127.0':
+ resolution: {integrity: sha512-EoTCZneNFU/P2qrpEM+RHmQwt+CvDkyGESG6qhr7KaegXLZwePfbrkCDfAk8/rhxbDUVGsZILX+2tqPzFtoFWA==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [linux]
+ libc: [musl]
+
+ '@oxc-parser/binding-linux-arm64-musl@0.130.0':
+ resolution: {integrity: sha512-EiJ/gC0ljbcwVpycC8YWw6ggMbtsPX8XMOt0mPx0aqWeMsNR+L9m05Flbvd5T+GlivG+GkSWQL7tM9SRFpM/dw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [linux]
+ libc: [musl]
+
+ '@oxc-parser/binding-linux-ppc64-gnu@0.124.0':
+ resolution: {integrity: sha512-t7KZaaUhfp2au0MRpoENEFqwLKYDdptEry6V7pTAVdPEcFG4P6ii8yeGU9m6p5vb+b8WEKmdpGMNXBEYy7iJdw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [ppc64]
+ os: [linux]
+ libc: [glibc]
+
+ '@oxc-parser/binding-linux-ppc64-gnu@0.126.0':
+ resolution: {integrity: sha512-Wv/T8C98hRQhGTlx2XFyLn5raRMp9U1lOQD+YnXNgAr7wHbJJpZ8mDBU7Rw+M3WytGcGTFcr6kqgfyQeHVtLbQ==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [ppc64]
+ os: [linux]
+ libc: [glibc]
+
+ '@oxc-parser/binding-linux-ppc64-gnu@0.127.0':
+ resolution: {integrity: sha512-zALjmZYgxFLHjXeudcDF0xFGNydTAtkAeXAr2EuC17ywCyFxcmQra4w0BMde0Yi/re4Bi4iwEoEXtYN7l6eBLQ==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [ppc64]
+ os: [linux]
+ libc: [glibc]
+
+ '@oxc-parser/binding-linux-ppc64-gnu@0.130.0':
+ resolution: {integrity: sha512-b+h/lsLLurp756dMGizNs5uPaJfyEdWrTcV5t8M609jWm1DEHB1StpRXCkyvwtkJx3m+qL5BNQ0dEKan/4yGFA==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [ppc64]
+ os: [linux]
+ libc: [glibc]
+
+ '@oxc-parser/binding-linux-riscv64-gnu@0.124.0':
+ resolution: {integrity: sha512-eurGGaxHZiIQ+fBSageS8TAkRqZgdOiBeqNrWAqAPup9hXBTmQ0WcBjwsLElf+3jvDL9NhnX0dOgOqPfsjSjdg==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [riscv64]
+ os: [linux]
+ libc: [glibc]
+
+ '@oxc-parser/binding-linux-riscv64-gnu@0.126.0':
+ resolution: {integrity: sha512-DHx1rT1zauW0ZbLHOiQh5AC9Xs3UkWx2XmfZHs+7nnWYr3sagrufoUQC+/XPwwjMIlCFXiFGM0sFh3TyOCZwqA==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [riscv64]
+ os: [linux]
+ libc: [glibc]
+
+ '@oxc-parser/binding-linux-riscv64-gnu@0.127.0':
+ resolution: {integrity: sha512-fPP8M6zQLS7Jz7o9d5ArUSuAuSK3e+WCYVrCpdzeCOejidtZExJ9tjhDrAd3HEPqARBCPmdpqxESPFqy44vkBQ==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [riscv64]
+ os: [linux]
+ libc: [glibc]
+
+ '@oxc-parser/binding-linux-riscv64-gnu@0.130.0':
+ resolution: {integrity: sha512-O19Cil83XAyjEFfo8WhkMwY58ALqZ7ckjGL+25mjMIuF84urWBeANH0FC8B8BsSSygWU3/1aY3ADdDbp+wlBnw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [riscv64]
+ os: [linux]
+ libc: [glibc]
+
+ '@oxc-parser/binding-linux-riscv64-musl@0.124.0':
+ resolution: {integrity: sha512-d1V7/ll1i/LhqE/gZy6Wbz6evlk0egh2XKkwMI3epiojtbtUwQSLIER0Y3yDBBocPuWOjJdvmjtEmPTTLXje/w==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [riscv64]
+ os: [linux]
+ libc: [musl]
+
+ '@oxc-parser/binding-linux-riscv64-musl@0.126.0':
+ resolution: {integrity: sha512-umDc2mTShH0U2zcEYf8mIJ163seLJNn54ZUZYeI5jD4qlg9izPwoLrC2aNPKlMJTu6u/ysmQWiEvIiaAG+INkw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [riscv64]
+ os: [linux]
+ libc: [musl]
+
+ '@oxc-parser/binding-linux-riscv64-musl@0.127.0':
+ resolution: {integrity: sha512-7IcC4Ao02oGpfnjt+X/oF4U2mllo2qoSkw5xxiXNKL9MCTsTiAC6616beOuehdxGcnz1bRoPC1RQ2f1GQDdN+g==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [riscv64]
+ os: [linux]
+ libc: [musl]
+
+ '@oxc-parser/binding-linux-riscv64-musl@0.130.0':
+ resolution: {integrity: sha512-BgXRVC0+83n3YzCscLQjj6nbyeBIVeZYPTI4fFMAE4WNm2+4RXhWp03IVizL7esIz36kgmT48aebk1iM+cs8sw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [riscv64]
+ os: [linux]
+ libc: [musl]
+
+ '@oxc-parser/binding-linux-s390x-gnu@0.124.0':
+ resolution: {integrity: sha512-w1+cBvriUteOpox6ATqCFVkpGL47PFdcfCPGmgUZbd78Fw44U0gQkc+kVGvAOTvGrptMYgwomD1c6OTVvkrpGg==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [s390x]
+ os: [linux]
+ libc: [glibc]
+
+ '@oxc-parser/binding-linux-s390x-gnu@0.126.0':
+ resolution: {integrity: sha512-PXXeWayclRtO1pxQEeCpiqIglQdhK2mAI2VX5xnsWdImzSB5GpoQ8TNw7vTCKk2k+GZuxl+q1knncidjCyUP9w==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [s390x]
+ os: [linux]
+ libc: [glibc]
+
+ '@oxc-parser/binding-linux-s390x-gnu@0.127.0':
+ resolution: {integrity: sha512-pbXIhiNFHoqWeqDNLiJ9JkpHz1IM9k4DXa66x+1GTWMG7iLxtkXgE53iiuKSXwmk3zIYmaPVfBvgcAhS583K4Q==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [s390x]
+ os: [linux]
+ libc: [glibc]
+
+ '@oxc-parser/binding-linux-s390x-gnu@0.130.0':
+ resolution: {integrity: sha512-6tJz0xvnGhsokE7N1WlUSBXibpYmT9xSJFS1Ce41Km/+8gQvdlW8MLhRv8PD0L7ix8vRG0FDDepp3jdOFzdVdw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [s390x]
+ os: [linux]
+ libc: [glibc]
+
+ '@oxc-parser/binding-linux-x64-gnu@0.124.0':
+ resolution: {integrity: sha512-RRB1evQiXRtMCsQQiAh9U0H3HzguLpE0ytfStuhRgmOj7tqUCOVxkHsvM9geZjAax6NqVRj7VXx32qjjkZPsBw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [linux]
+ libc: [glibc]
+
+ '@oxc-parser/binding-linux-x64-gnu@0.126.0':
+ resolution: {integrity: sha512-wzocjxm34TbB3bFlqG65JiLtvf6ZDg2ZxRkLLbgXwDQUNU+0MPjQN8zy/0jBKNA5fnPLk3XeVdZ7Uin+7+CVkg==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [linux]
+ libc: [glibc]
+
+ '@oxc-parser/binding-linux-x64-gnu@0.127.0':
+ resolution: {integrity: sha512-MYCguB9RvBvlSd6gbuNI7QwiLoCCAlGnlRJFPrzLI6U1/9wkC/WK6LtBAUln55H1Ctqw45PWmqrobKoMhsYQzQ==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [linux]
+ libc: [glibc]
+
+ '@oxc-parser/binding-linux-x64-gnu@0.130.0':
+ resolution: {integrity: sha512-9aCWj83dp3heTQGmGnZGdIWgxjZrr/7VQ0TGFHH5PKByxJKF2Hcr4qvaSUHhhGEa3MSsDjTL1YDP8RAgdL5/Cg==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [linux]
+ libc: [glibc]
+
+ '@oxc-parser/binding-linux-x64-musl@0.124.0':
+ resolution: {integrity: sha512-asVYN0qmSHlCU8H9Q47SmeJ/Z5EG4IWCC+QGxkfFboI5qh15aLlJnHmnrV61MwQRPXGnVC/sC3qKhrUyqGxUqw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [linux]
+ libc: [musl]
+
+ '@oxc-parser/binding-linux-x64-musl@0.126.0':
+ resolution: {integrity: sha512-e83uftP60jmkPs2+CW6T6A1GYzN2H6IumDAiTntv9WyHR73PI3ImHNBkYqnA3ukeKI3xjcCbhSh9QeJWmufxGQ==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [linux]
+ libc: [musl]
+
+ '@oxc-parser/binding-linux-x64-musl@0.127.0':
+ resolution: {integrity: sha512-5eY0B/bxf1xIUxb4NOTvOI3KWtBQfPWYyKAzgcrCt0mDibSZygVpO1Pz8bkeiSZ5Jj9+M09dkggG3H8I5d0Uyg==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [linux]
+ libc: [musl]
+
+ '@oxc-parser/binding-linux-x64-musl@0.130.0':
+ resolution: {integrity: sha512-afXt87aZBqrUVli8TB/I8H1G50RDWcwirjWtXGXYqJ2ZqWEiErH7V72j3LUSDZaivmtu2OLX0KQ/mbhP81mr7A==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [linux]
+ libc: [musl]
+
+ '@oxc-parser/binding-openharmony-arm64@0.124.0':
+ resolution: {integrity: sha512-nhwuxm6B8pn9lzAzMUfa571L5hCXYwQo8C8cx5aGOuHWCzruR8gPJnRRXGBci+uGaIIQEZDyU/U6HDgrSp/JlQ==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [openharmony]
+
+ '@oxc-parser/binding-openharmony-arm64@0.126.0':
+ resolution: {integrity: sha512-4WiOILHnPrTDY2/L4mE6PZCYwLN1d3ghma6BuTJ452CCgzRMt3uFplCtR+o3r9zdUWJYb370UizpI9CUcWXr1A==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [openharmony]
+
+ '@oxc-parser/binding-openharmony-arm64@0.127.0':
+ resolution: {integrity: sha512-Gld0ajrFTUXNtdw20fVBuTQx66FA75nIVg+//pPfR3sXkuABB4mTBhl3r9JNzrJpgW//qiwxf0nWXUWGJSL3UQ==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [openharmony]
+
+ '@oxc-parser/binding-openharmony-arm64@0.130.0':
+ resolution: {integrity: sha512-I0NCrZV/YZuCGWgqwNN/GO/iXlLF2z+Wgc7u+Aa9N4P51oYeIa0XT+zVBUne4csO9GqxskXgI4g8JzzWGRpfOw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [openharmony]
+
+ '@oxc-parser/binding-wasm32-wasi@0.124.0':
+ resolution: {integrity: sha512-LWuq4Dl9tff7n+HjJcqoBjDlVCtruc0shgtdtGM+rTUIE9aFxHA/P+wCYR+aWMjN8m9vNaRME/sKXErmhmeKrA==}
+ engines: {node: '>=14.0.0'}
+ cpu: [wasm32]
+
+ '@oxc-parser/binding-wasm32-wasi@0.126.0':
+ resolution: {integrity: sha512-Y17hhnrQTrxgAxAyAq401vnN9URsAL4s5AjqpG1NDsXSlhe1yBNnns+rC2P6xcMoitgX5nKH2ryYt9oiFRlzLw==}
+ engines: {node: '>=14.0.0'}
+ cpu: [wasm32]
+
+ '@oxc-parser/binding-wasm32-wasi@0.127.0':
+ resolution: {integrity: sha512-T6KVD7rhLzFlwGRXMnxUFfkCZD8FHnb968wVXW1mXzgRFc5RNXOBY2mPPDZ77x5Ln76ltLMgtPg0cOkU1NSrEQ==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [wasm32]
+
+ '@oxc-parser/binding-wasm32-wasi@0.130.0':
+ resolution: {integrity: sha512-sJgQkGaBX0WJvPUDfwciex6IcTk5O5NLQ1bhEb6f3nBruh1GshKMRSMt2bxZlYrgBzjyBbJzsnO+InPG0bg+fA==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [wasm32]
+
+ '@oxc-parser/binding-win32-arm64-msvc@0.124.0':
+ resolution: {integrity: sha512-aOh3Lf3AeH0dgzT4yBXcArFZ8VhqNXwZ/xlN0GqBtgVaGoHOOqL2YHlcVIgT+ghsXPVR2PTtYgBiQ1CNK7jp5A==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [win32]
+
+ '@oxc-parser/binding-win32-arm64-msvc@0.126.0':
+ resolution: {integrity: sha512-Znug1u1iRvT4VC3jANz6nhGBHsFwEFMxuimYpJFwMtsB6H5FcEoZRMmH26tHkSTD03JvDmG+gB65W3ajLjPcSw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [win32]
+
+ '@oxc-parser/binding-win32-arm64-msvc@0.127.0':
+ resolution: {integrity: sha512-Ujvw4X+LD1CCGULcsQcvb4YNVoBGqt+JHgNNzGGaCImELiZLk477ifUH53gIbE7EKd933NdTi25JWEr9K2HwXw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [win32]
+
+ '@oxc-parser/binding-win32-arm64-msvc@0.130.0':
+ resolution: {integrity: sha512-bjcma99sQrNh6RY4mPO9yTkfxql6TDFoN3HWdK31RCKXwNhcDgJXW/l8PUtzKNiQ+9vpKJfJtQq+LklBuxSOBA==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [win32]
+
+ '@oxc-parser/binding-win32-ia32-msvc@0.124.0':
+ resolution: {integrity: sha512-sib5xC0nz/+SCpaETBuHBz4SXS02KuG5HtyOcHsO/SK5ZvLRGhOZx0elDKawjb6adFkD7dQCqpXUS25wY6ELKQ==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [ia32]
+ os: [win32]
+
+ '@oxc-parser/binding-win32-ia32-msvc@0.126.0':
+ resolution: {integrity: sha512-qrw7mx5hFFTxVSXToOA40hpnjgNB/DJprZchtB4rDKNLKqkD3F26HbzaQeH1nxAKej0efSZfJd5Sw3qdtOLGhw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [ia32]
+ os: [win32]
+
+ '@oxc-parser/binding-win32-ia32-msvc@0.127.0':
+ resolution: {integrity: sha512-0cwxKO7KHQQQfo4Uf4B2SQrhgm+cJaP9OvFFhx52Tkg4bezsacu83GB2/In5bC415Ueeym+kXdnge/57rbSfTw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [ia32]
+ os: [win32]
+
+ '@oxc-parser/binding-win32-ia32-msvc@0.130.0':
+ resolution: {integrity: sha512-hRYbv6HhpSTzT4xTiIkadLI7upLQxuOdLPR/9nL1fTjwhgutBTPXrwaAPb/jTFVx6/8C7Jb5HcUKhmNwloTbFA==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [ia32]
+ os: [win32]
+
+ '@oxc-parser/binding-win32-x64-msvc@0.124.0':
+ resolution: {integrity: sha512-UgojtjGUgZgAZQYt7SC6VO65OVdxEkRe2q+2vbHJO//18qw3Hrk6UvHGQKldsQKgbVcIBT/YBrt85YberiYIPQ==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [win32]
+
+ '@oxc-parser/binding-win32-x64-msvc@0.126.0':
+ resolution: {integrity: sha512-ibB1s+mPUFXvS7MFJO2jpw/aCNs/P6ifnWlRyTYB+WYBpniOiCcHQQskZneJtwcjQMDRol3RGG3ihoYnzXSY4w==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [win32]
+
+ '@oxc-parser/binding-win32-x64-msvc@0.127.0':
+ resolution: {integrity: sha512-rOrnSQSCbhI2kowr9XxE7m9a8oQXnBHjnS6j95LxxAnEZ0+Fz20WlRXG4ondQb+ejjt2KOsa65sE6++L6kUd+w==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [win32]
+
+ '@oxc-parser/binding-win32-x64-msvc@0.130.0':
+ resolution: {integrity: sha512-RBpA9TsRucJq6HNVNCFF1iKg+QeTkLdZf7hi4xaOGCPvMZWvDHjQgSOEZMUpuW4JNciHbxNhLEYmz5CVygjVGQ==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [win32]
+
+ '@oxc-project/types@0.124.0':
+ resolution: {integrity: sha512-VBFWMTBvHxS11Z5Lvlr3IWgrwhMTXV+Md+EQF0Xf60+wAdsGFTBx7X7K/hP4pi8N7dcm1RvcHwDxZ16Qx8keUg==}
+
+ '@oxc-project/types@0.126.0':
+ resolution: {integrity: sha512-oGfVtjAgwQVVpfBrbtk4e1XDyWHRFta6BS3GWVzrF8xYBT2VGQAk39yJS/wFSMrZqoiCU4oghT3Ch0HaHGIHcQ==}
+
+ '@oxc-project/types@0.127.0':
+ resolution: {integrity: sha512-aIYXQBo4lCbO4z0R3FHeucQHpF46l2LbMdxRvqvuRuW2OxdnSkcng5B8+K12spgLDj93rtN3+J2Vac/TIO+ciQ==}
+
+ '@oxc-project/types@0.129.0':
+ resolution: {integrity: sha512-3oz8m3FGdr2nDXVqmFUw7jolKliC4MoyXYIG2c7gpjBnzUWQpUGIYcXYKxTdTi+N2jusvt610ckTMkxdwHkYEg==}
+
+ '@oxc-project/types@0.130.0':
+ resolution: {integrity: sha512-ibD2usx9JRu7f5pu2tMKMI4cpA4NgXJQoYRP4pQ7Pxmn1l6k/53qWtQWZayhYy3X4QZkt90Ot+mJEaeXouio6Q==}
+
+ '@oxc-project/types@0.131.0':
+ resolution: {integrity: sha512-PgnWDfV0h+b16XNKbXU7Daib/BFSt/J2mEzfYIBu6JB/wNdlU+kVYXCkGA1A9fWkTbOgbjh4e6NhPeQOYvFhEA==}
+
+ '@oxc-project/types@0.132.0':
+ resolution: {integrity: sha512-FESMOxil5Se014ui/Eq8fT5uHJo6nIRwH0PfJrZJXs6Gek3ZVFOrpUv3YIZT20m+extU98Hg1Ym72U58rlsxUQ==}
+
+ '@oxc-resolver/binding-android-arm-eabi@11.19.1':
+ resolution: {integrity: sha512-aUs47y+xyXHUKlbhqHUjBABjvycq6YSD7bpxSW7vplUmdzAlJ93yXY6ZR0c1o1x5A/QKbENCvs3+NlY8IpIVzg==}
+ cpu: [arm]
+ os: [android]
+
+ '@oxc-resolver/binding-android-arm64@11.19.1':
+ resolution: {integrity: sha512-oolbkRX+m7Pq2LNjr/kKgYeC7bRDMVTWPgxBGMjSpZi/+UskVo4jsMU3MLheZV55jL6c3rNelPl4oD60ggYmqA==}
+ cpu: [arm64]
+ os: [android]
+
+ '@oxc-resolver/binding-darwin-arm64@11.19.1':
+ resolution: {integrity: sha512-nUC6d2i3R5B12sUW4O646qD5cnMXf2oBGPLIIeaRfU9doJRORAbE2SGv4eW6rMqhD+G7nf2Y8TTJTLiiO3Q/dQ==}
+ cpu: [arm64]
+ os: [darwin]
+
+ '@oxc-resolver/binding-darwin-x64@11.19.1':
+ resolution: {integrity: sha512-cV50vE5+uAgNcFa3QY1JOeKDSkM/9ReIcc/9wn4TavhW/itkDGrXhw9jaKnkQnGbjJ198Yh5nbX/Gr2mr4Z5jQ==}
+ cpu: [x64]
+ os: [darwin]
+
+ '@oxc-resolver/binding-freebsd-x64@11.19.1':
+ resolution: {integrity: sha512-xZOQiYGFxtk48PBKff+Zwoym7ScPAIVp4c14lfLxizO2LTTTJe5sx9vQNGrBymrf/vatSPNMD4FgsaaRigPkqw==}
+ cpu: [x64]
+ os: [freebsd]
+
+ '@oxc-resolver/binding-linux-arm-gnueabihf@11.19.1':
+ resolution: {integrity: sha512-lXZYWAC6kaGe/ky2su94e9jN9t6M0/6c+GrSlCqL//XO1cxi5lpAhnJYdyrKfm0ZEr/c7RNyAx3P7FSBcBd5+A==}
+ cpu: [arm]
+ os: [linux]
+
+ '@oxc-resolver/binding-linux-arm-musleabihf@11.19.1':
+ resolution: {integrity: sha512-veG1kKsuK5+t2IsO9q0DErYVSw2azvCVvWHnfTOS73WE0STdLLB7Q1bB9WR+yHPQM76ASkFyRbogWo1GR1+WbQ==}
+ cpu: [arm]
+ os: [linux]
+
+ '@oxc-resolver/binding-linux-arm64-gnu@11.19.1':
+ resolution: {integrity: sha512-heV2+jmXyYnUrpUXSPugqWDRpnsQcDm2AX4wzTuvgdlZfoNYO0O3W2AVpJYaDn9AG4JdM6Kxom8+foE7/BcSig==}
+ cpu: [arm64]
+ os: [linux]
+ libc: [glibc]
+
+ '@oxc-resolver/binding-linux-arm64-musl@11.19.1':
+ resolution: {integrity: sha512-jvo2Pjs1c9KPxMuMPIeQsgu0mOJF9rEb3y3TdpsrqwxRM+AN6/nDDwv45n5ZrUnQMsdBy5gIabioMKnQfWo9ew==}
+ cpu: [arm64]
+ os: [linux]
+ libc: [musl]
+
+ '@oxc-resolver/binding-linux-ppc64-gnu@11.19.1':
+ resolution: {integrity: sha512-vLmdNxWCdN7Uo5suays6A/+ywBby2PWBBPXctWPg5V0+eVuzsJxgAn6MMB4mPlshskYbppjpN2Zg83ArHze9gQ==}
+ cpu: [ppc64]
+ os: [linux]
+ libc: [glibc]
+
+ '@oxc-resolver/binding-linux-riscv64-gnu@11.19.1':
+ resolution: {integrity: sha512-/b+WgR+VTSBxzgOhDO7TlMXC1ufPIMR6Vj1zN+/x+MnyXGW7prTLzU9eW85Aj7Th7CCEG9ArCbTeqxCzFWdg2w==}
+ cpu: [riscv64]
+ os: [linux]
+ libc: [glibc]
+
+ '@oxc-resolver/binding-linux-riscv64-musl@11.19.1':
+ resolution: {integrity: sha512-YlRdeWb9j42p29ROh+h4eg/OQ3dTJlpHSa+84pUM9+p6i3djtPz1q55yLJhgW9XfDch7FN1pQ/Vd6YP+xfRIuw==}
+ cpu: [riscv64]
+ os: [linux]
+ libc: [musl]
+
+ '@oxc-resolver/binding-linux-s390x-gnu@11.19.1':
+ resolution: {integrity: sha512-EDpafVOQWF8/MJynsjOGFThcqhRHy417sRyLfQmeiamJ8qVhSKAn2Dn2VVKUGCjVB9C46VGjhNo7nOPUi1x6uA==}
+ cpu: [s390x]
+ os: [linux]
+ libc: [glibc]
+
+ '@oxc-resolver/binding-linux-x64-gnu@11.19.1':
+ resolution: {integrity: sha512-NxjZe+rqWhr+RT8/Ik+5ptA3oz7tUw361Wa5RWQXKnfqwSSHdHyrw6IdcTfYuml9dM856AlKWZIUXDmA9kkiBQ==}
+ cpu: [x64]
+ os: [linux]
+ libc: [glibc]
+
+ '@oxc-resolver/binding-linux-x64-musl@11.19.1':
+ resolution: {integrity: sha512-cM/hQwsO3ReJg5kR+SpI69DMfvNCp+A/eVR4b4YClE5bVZwz8rh2Nh05InhwI5HR/9cArbEkzMjcKgTHS6UaNw==}
+ cpu: [x64]
+ os: [linux]
+ libc: [musl]
+
+ '@oxc-resolver/binding-openharmony-arm64@11.19.1':
+ resolution: {integrity: sha512-QF080IowFB0+9Rh6RcD19bdgh49BpQHUW5TajG1qvWHvmrQznTZZjYlgE2ltLXyKY+qs4F/v5xuX1XS7Is+3qA==}
+ cpu: [arm64]
+ os: [openharmony]
+
+ '@oxc-resolver/binding-wasm32-wasi@11.19.1':
+ resolution: {integrity: sha512-w8UCKhX826cP/ZLokXDS6+milN8y4X7zidsAttEdWlVoamTNf6lhBJldaWr3ukTDiye7s4HRcuPEPOXNC432Vg==}
+ engines: {node: '>=14.0.0'}
+ cpu: [wasm32]
+
+ '@oxc-resolver/binding-win32-arm64-msvc@11.19.1':
+ resolution: {integrity: sha512-nJ4AsUVZrVKwnU/QRdzPCCrO0TrabBqgJ8pJhXITdZGYOV28TIYystV1VFLbQ7DtAcaBHpocT5/ZJnF78YJPtQ==}
+ cpu: [arm64]
+ os: [win32]
+
+ '@oxc-resolver/binding-win32-ia32-msvc@11.19.1':
+ resolution: {integrity: sha512-EW+ND5q2Tl+a3pH81l1QbfgbF3HmqgwLfDfVithRFheac8OTcnbXt/JxqD2GbDkb7xYEqy1zNaVFRr3oeG8npA==}
+ cpu: [ia32]
+ os: [win32]
+
+ '@oxc-resolver/binding-win32-x64-msvc@11.19.1':
+ resolution: {integrity: sha512-6hIU3RQu45B+VNTY4Ru8ppFwjVS/S5qwYyGhBotmjxfEKk41I2DlGtRfGJndZ5+6lneE2pwloqunlOyZuX/XAw==}
+ cpu: [x64]
+ os: [win32]
+
+ '@oxc-transform/binding-android-arm-eabi@0.131.0':
+ resolution: {integrity: sha512-rcNvLlbNnxTfYVlZVF+Rev2AyCpJDpwVPphG4HOJxauaT1+w5VxL+kRdxCReof4A8ZsszbvIYlvkqvaJKO4Mog==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm]
+ os: [android]
+
+ '@oxc-transform/binding-android-arm64@0.131.0':
+ resolution: {integrity: sha512-/y+EH6QYQB2ZDQNvMlzItc36mw16GZwCDlvGYbQ4GCTE+7ZtSmx9E/rJOYzYyzMghz0c5dhJquRKScXdOZHpnQ==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [android]
+
+ '@oxc-transform/binding-darwin-arm64@0.131.0':
+ resolution: {integrity: sha512-x1Va8zFomdYghAI0Zkt7kUmG50S65XH1u0EbIDr80M9idfXrQgd08ZGl3ejwRGLBrkbA8tkkmeOu1rWVFf7BXg==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [darwin]
+
+ '@oxc-transform/binding-darwin-x64@0.131.0':
+ resolution: {integrity: sha512-EwacackWpYYXGZsl0Aj4NKvDdLuxWZg7LQDneFyMwuftpAxPQLRkHFwZib7r6wpIJm4NELhHW261A4vZ8OQqXQ==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [darwin]
+
+ '@oxc-transform/binding-freebsd-x64@0.131.0':
+ resolution: {integrity: sha512-EhXqWOtL1PWcJ3ktdplV4Wrez2PRuTBSDdB7KF6CN4zuZhohUjxC1bxqDNRbNSX46yaZ27IzJLafah1J6mSA8Q==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [freebsd]
+
+ '@oxc-transform/binding-linux-arm-gnueabihf@0.131.0':
+ resolution: {integrity: sha512-NfNACr3aqBKeeUh6HCoGGPSjdMkLvyXUZQywCg/DwRkEpqZo55KX65saW1sQdgBcu0SKXrAReTjIm/HDO/OI0Q==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm]
+ os: [linux]
+
+ '@oxc-transform/binding-linux-arm-musleabihf@0.131.0':
+ resolution: {integrity: sha512-ABp6KGhbYFGDaAdB4gGZW12DYa55OF/Cu+6Rw6/Di0skuwpiDwnBOLHWz9VBq0QTcREy/qIUOnKW+vZHQLOT8A==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm]
+ os: [linux]
+
+ '@oxc-transform/binding-linux-arm64-gnu@0.131.0':
+ resolution: {integrity: sha512-4nKYkHHjRela+jpt+VO4++jxgHoJQFxAeAGtfQ4x11dQMJllzqo3Yu8gfcfLEMsAfflwN/gY+KBbMD/y0exitg==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [linux]
+ libc: [glibc]
+
+ '@oxc-transform/binding-linux-arm64-musl@0.131.0':
+ resolution: {integrity: sha512-cW0Ab1s0sxfiyP1+gdd94f0vUjwGzJF4F3DepF3VnR9nFTGMmFLugwtrBS3DYjTnbugiUH3Fp+16yys1FhNzIA==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [linux]
+ libc: [musl]
+
+ '@oxc-transform/binding-linux-ppc64-gnu@0.131.0':
+ resolution: {integrity: sha512-wunAU/lzE1nPGKL47uI0g+4Nsv/12xveOXNu4M70xe85kNBm7mQdMpZIeoVYCxtXew0iHxFKJDT6qK5mYFSA3w==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [ppc64]
+ os: [linux]
+ libc: [glibc]
+
+ '@oxc-transform/binding-linux-riscv64-gnu@0.131.0':
+ resolution: {integrity: sha512-r4sMt4OB4TryDcVWW9KnsXOf/ea7tIGX2QASNrpetzPocsBZqhHIFDbZ8EkBDjmlmWGHg6BgjVx6lLcMXX4Dcw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [riscv64]
+ os: [linux]
+ libc: [glibc]
+
+ '@oxc-transform/binding-linux-riscv64-musl@0.131.0':
+ resolution: {integrity: sha512-/rLVLItsBjKrnZFLiGrwRB3fs0dAjXZLqY7F42omvacFJjZsceQ3481oQX1bBs3RwoDDyDy/9ZkIN7kYIkv5Gw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [riscv64]
+ os: [linux]
+ libc: [musl]
+
+ '@oxc-transform/binding-linux-s390x-gnu@0.131.0':
+ resolution: {integrity: sha512-fUprJgJauI1A7e7cDgY/Z3mwLVtE3aswB4lvS96KpRNDHrwOh8bnCJOWf+0CYveDQzghDVFiZWVDo56pO4Wr9Q==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [s390x]
+ os: [linux]
+ libc: [glibc]
+
+ '@oxc-transform/binding-linux-x64-gnu@0.131.0':
+ resolution: {integrity: sha512-XdbvDT1GPNxrTLXSRt4RU2uCH112q3nINTT05DZqTYYcAxaCPImnMoZe2TlBv5j2376Gk+2pcVnJs6xut47aSw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [linux]
+ libc: [glibc]
+
+ '@oxc-transform/binding-linux-x64-musl@0.131.0':
+ resolution: {integrity: sha512-Du2CxlBfC98EV3hOAmLVSUgP0JgqM9F47lRv9v43T4sGPcQVOjs9wffUybGUUraG9unmBZ4dgpMAqlCq0k3dGw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [linux]
+ libc: [musl]
+
+ '@oxc-transform/binding-openharmony-arm64@0.131.0':
+ resolution: {integrity: sha512-wTj2FkOgNhgdisnA0a15QQksyj6AH2snmpgYgAtj098i477x5LpHHdqfuk60jsA/QHSjmUc6dm4P88yI5GY4xA==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [openharmony]
+
+ '@oxc-transform/binding-wasm32-wasi@0.131.0':
+ resolution: {integrity: sha512-lE9UaZL0KomAlbATiB6FKoJ9no6W49yXs/MujJqY75AkHHMeOCsHSN9HvriyWz2FOIQgV7C5cmNj0jf+IaBtQg==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [wasm32]
+
+ '@oxc-transform/binding-win32-arm64-msvc@0.131.0':
+ resolution: {integrity: sha512-8KUfPnuxbEfa9H+OQ5XNPFq9JIEWVCg8kczJaD8PvTprr515mz1lmSLSUoOW8mrLaN0mZaGg6pemuvTawOLoPg==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [win32]
+
+ '@oxc-transform/binding-win32-ia32-msvc@0.131.0':
+ resolution: {integrity: sha512-pXSu2A7L6H//1Uvsg5RJHb91BDZpCTho0r9oAwxPqKJM2LWV7Zph/ikWEIXt/YLbKF3WpkHrKQ5hbQGP9gWmHg==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [ia32]
+ os: [win32]
+
+ '@oxc-transform/binding-win32-x64-msvc@0.131.0':
+ resolution: {integrity: sha512-VXgk106WLl3NpBO/6G2gxkWBHguCJm01mGqAq2Q0l2o7hnbglsND0UWSCtM3a9MlsDimfJkLWFQveZu4UtnRvA==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [win32]
+
+ '@package-json/types@0.0.12':
+ resolution: {integrity: sha512-uu43FGU34B5VM9mCNjXCwLaGHYjXdNincqKLaraaCW+7S2+SmiBg1Nv8bPnmschrIfZmfKNY9f3fC376MRrObw==}
+
+ '@parcel/watcher-android-arm64@2.5.6':
+ resolution: {integrity: sha512-YQxSS34tPF/6ZG7r/Ih9xy+kP/WwediEUsqmtf0cuCV5TPPKw/PQHRhueUo6JdeFJaqV3pyjm0GdYjZotbRt/A==}
+ engines: {node: '>= 10.0.0'}
+ cpu: [arm64]
+ os: [android]
+
+ '@parcel/watcher-darwin-arm64@2.5.6':
+ resolution: {integrity: sha512-Z2ZdrnwyXvvvdtRHLmM4knydIdU9adO3D4n/0cVipF3rRiwP+3/sfzpAwA/qKFL6i1ModaabkU7IbpeMBgiVEA==}
+ engines: {node: '>= 10.0.0'}
+ cpu: [arm64]
+ os: [darwin]
+
+ '@parcel/watcher-darwin-x64@2.5.6':
+ resolution: {integrity: sha512-HgvOf3W9dhithcwOWX9uDZyn1lW9R+7tPZ4sug+NGrGIo4Rk1hAXLEbcH1TQSqxts0NYXXlOWqVpvS1SFS4fRg==}
+ engines: {node: '>= 10.0.0'}
+ cpu: [x64]
+ os: [darwin]
+
+ '@parcel/watcher-freebsd-x64@2.5.6':
+ resolution: {integrity: sha512-vJVi8yd/qzJxEKHkeemh7w3YAn6RJCtYlE4HPMoVnCpIXEzSrxErBW5SJBgKLbXU3WdIpkjBTeUNtyBVn8TRng==}
+ engines: {node: '>= 10.0.0'}
+ cpu: [x64]
+ os: [freebsd]
+
+ '@parcel/watcher-linux-arm-glibc@2.5.6':
+ resolution: {integrity: sha512-9JiYfB6h6BgV50CCfasfLf/uvOcJskMSwcdH1PHH9rvS1IrNy8zad6IUVPVUfmXr+u+Km9IxcfMLzgdOudz9EQ==}
+ engines: {node: '>= 10.0.0'}
+ cpu: [arm]
+ os: [linux]
+ libc: [glibc]
+
+ '@parcel/watcher-linux-arm-musl@2.5.6':
+ resolution: {integrity: sha512-Ve3gUCG57nuUUSyjBq/MAM0CzArtuIOxsBdQ+ftz6ho8n7s1i9E1Nmk/xmP323r2YL0SONs1EuwqBp2u1k5fxg==}
+ engines: {node: '>= 10.0.0'}
+ cpu: [arm]
+ os: [linux]
+ libc: [musl]
+
+ '@parcel/watcher-linux-arm64-glibc@2.5.6':
+ resolution: {integrity: sha512-f2g/DT3NhGPdBmMWYoxixqYr3v/UXcmLOYy16Bx0TM20Tchduwr4EaCbmxh1321TABqPGDpS8D/ggOTaljijOA==}
+ engines: {node: '>= 10.0.0'}
+ cpu: [arm64]
+ os: [linux]
+ libc: [glibc]
+
+ '@parcel/watcher-linux-arm64-musl@2.5.6':
+ resolution: {integrity: sha512-qb6naMDGlbCwdhLj6hgoVKJl2odL34z2sqkC7Z6kzir8b5W65WYDpLB6R06KabvZdgoHI/zxke4b3zR0wAbDTA==}
+ engines: {node: '>= 10.0.0'}
+ cpu: [arm64]
+ os: [linux]
+ libc: [musl]
+
+ '@parcel/watcher-linux-x64-glibc@2.5.6':
+ resolution: {integrity: sha512-kbT5wvNQlx7NaGjzPFu8nVIW1rWqV780O7ZtkjuWaPUgpv2NMFpjYERVi0UYj1msZNyCzGlaCWEtzc+exjMGbQ==}
+ engines: {node: '>= 10.0.0'}
+ cpu: [x64]
+ os: [linux]
+ libc: [glibc]
+
+ '@parcel/watcher-linux-x64-musl@2.5.6':
+ resolution: {integrity: sha512-1JRFeC+h7RdXwldHzTsmdtYR/Ku8SylLgTU/reMuqdVD7CtLwf0VR1FqeprZ0eHQkO0vqsbvFLXUmYm/uNKJBg==}
+ engines: {node: '>= 10.0.0'}
+ cpu: [x64]
+ os: [linux]
+ libc: [musl]
+
+ '@parcel/watcher-wasm@2.5.6':
+ resolution: {integrity: sha512-byAiBZ1t3tXQvc8dMD/eoyE7lTXYorhn+6uVW5AC+JGI1KtJC/LvDche5cfUE+qiefH+Ybq0bUCJU0aB1cSHUA==}
+ engines: {node: '>= 10.0.0'}
+ bundledDependencies:
+ - napi-wasm
+
+ '@parcel/watcher-win32-arm64@2.5.6':
+ resolution: {integrity: sha512-3ukyebjc6eGlw9yRt678DxVF7rjXatWiHvTXqphZLvo7aC5NdEgFufVwjFfY51ijYEWpXbqF5jtrK275z52D4Q==}
+ engines: {node: '>= 10.0.0'}
+ cpu: [arm64]
+ os: [win32]
+
+ '@parcel/watcher-win32-ia32@2.5.6':
+ resolution: {integrity: sha512-k35yLp1ZMwwee3Ez/pxBi5cf4AoBKYXj00CZ80jUz5h8prpiaQsiRPKQMxoLstNuqe2vR4RNPEAEcjEFzhEz/g==}
+ engines: {node: '>= 10.0.0'}
+ cpu: [ia32]
+ os: [win32]
+
+ '@parcel/watcher-win32-x64@2.5.6':
+ resolution: {integrity: sha512-hbQlYcCq5dlAX9Qx+kFb0FHue6vbjlf0FrNzSKdYK2APUf7tGfGxQCk2ihEREmbR6ZMc0MVAD5RIX/41gpUzTw==}
+ engines: {node: '>= 10.0.0'}
+ cpu: [x64]
+ os: [win32]
+
+ '@parcel/watcher@2.5.6':
+ resolution: {integrity: sha512-tmmZ3lQxAe/k/+rNnXQRawJ4NjxO2hqiOLTHvWchtGZULp4RyFeh6aU4XdOYBFe2KE1oShQTv4AblOs2iOrNnQ==}
+ engines: {node: '>= 10.0.0'}
+
+ '@pkgjs/parseargs@0.11.0':
+ resolution: {integrity: sha512-+1VkjdD0QBLPodGrJUeqarH8VAIvQODIbwh9XpP5Syisf7YoQgsJKPNFoqqLQlu+VQ/tVSshMR6loPMn8U+dPg==}
+ engines: {node: '>=14'}
+
+ '@playwright/test@1.60.0':
+ resolution: {integrity: sha512-O71yZIbAh/PxDMNGns37GHBIfrVkEVyn+AXyIa5dOTfb4/xNvRWV+Vv/NMbNCtODB/pO7vLlF2OTmMVLhmr7Ag==}
+ engines: {node: '>=18'}
+ hasBin: true
+
+ '@pnpm/constants@10.0.0':
+ resolution: {integrity: sha512-dxIXcW1F1dxIGfye2JXE7Q8WVwYB0axVzdBOkvE1WKIVR4xjB8e6k/Dkjo7DpbyfW5Vu2k21p6dyM32YLSAWoQ==}
+ engines: {node: '>=18.12'}
+
+ '@pnpm/constants@1001.3.1':
+ resolution: {integrity: sha512-2hf0s4pVrVEH8RvdJJ7YRKjQdiG8m0iAT26TTqXnCbK30kKwJW69VLmP5tED5zstmDRXcOeH5eRcrpkdwczQ9g==}
+ engines: {node: '>=18.12'}
+
+ '@pnpm/core-loggers@1001.0.9':
+ resolution: {integrity: sha512-pW58m3ssrwVjwhlmTXDW1dh1sv2y6R2Gl5YvQInjM2d01/5mre/sYAY4MK3XfgEShZJQxv6wVXDUvyHHJ0oizg==}
+ engines: {node: '>=18.12'}
+ peerDependencies:
+ '@pnpm/logger': '>=1001.0.0 <1002.0.0'
+
+ '@pnpm/error@1000.1.0':
+ resolution: {integrity: sha512-Dqc2IJJPjUatwc9Letw+vG29rnaMrDGi5g6WCx1HiZYm0obXbTmLygeRafMbgf+sLKXrWE1shOeiayQuczBdoA==}
+ engines: {node: '>=18.12'}
+
+ '@pnpm/error@6.0.3':
+ resolution: {integrity: sha512-OIYhG7HQh4zUFh2s8/6bp7glVRjNxms7bpzXVOLV7pyRa+rSYFmqJ8zDsBC64k58nuaxS85Ip+SCDjFxsFGeOg==}
+ engines: {node: '>=18.12'}
+
+ '@pnpm/graceful-fs@1000.1.0':
+ resolution: {integrity: sha512-EsMX4slK0qJN2AR0/AYohY5m0HQNYGMNe+jhN74O994zp22/WbX+PbkIKyw3UQn39yQm2+z6SgwklDxbeapsmQ==}
+ engines: {node: '>=18.12'}
+
+ '@pnpm/logger@1001.0.1':
+ resolution: {integrity: sha512-gdwlAMXC4Wc0s7Dmg/4wNybMEd/4lSd9LsXQxeg/piWY0PPXjgz1IXJWnVScx6dZRaaodWP3c1ornrw8mZdFZw==}
+ engines: {node: '>=18.12'}
+
+ '@pnpm/manifest-utils@1002.0.5':
+ resolution: {integrity: sha512-2DSwQ6pP73IuJS5mCCtPd5fibJwuAdufXKuSL/Oq1n6AggCqy8616Xea1X3RH3z5dL4mn7Z4EZ+vnX8jX3Wrfw==}
+ engines: {node: '>=18.12'}
+ peerDependencies:
+ '@pnpm/logger': ^1001.0.1
+
+ '@pnpm/read-project-manifest@1001.2.6':
+ resolution: {integrity: sha512-BcNO50lAkE4m9JaJ0WmG3m/DH/qLSvMgZywtmb/dfyyLVu5nDZfDqmOd8U+f1NhLcLMbBK6AnS3hyUqZYvw9Vg==}
+ engines: {node: '>=18.12'}
+ peerDependencies:
+ '@pnpm/logger': ^1001.0.1
+
+ '@pnpm/semver.peer-range@1000.0.0':
+ resolution: {integrity: sha512-r6VzkrdH7ZKjPmAogTNvxuV/UyS/xwHNme+ZuEFiG0UthZgqudDftYtKmG20fcfrjG1lgJbbWICA8KvZy7mmbw==}
+ engines: {node: '>=18.12'}
+
+ '@pnpm/text.comments-parser@1000.0.0':
+ resolution: {integrity: sha512-ivv/esrETOq9uMiKOC0ddVZ1BktEGsfsMQ9RWmrDpwPiqFSqWsIspnquxTBmm5GflC5N06fbqjGOpulZVYo3vQ==}
+ engines: {node: '>=18.12'}
+
+ '@pnpm/types@1001.3.0':
+ resolution: {integrity: sha512-NLTXheat/u7OEGg5M5vF6Z85zx8uKUZE0+whtX/sbFV2XL48RdnOWGPTKYuVVkv8M+launaLUTgGEXNs/ess2w==}
+ engines: {node: '>=18.12'}
+
+ '@pnpm/workspace.read-manifest@2.2.2':
+ resolution: {integrity: sha512-ryiFUKQfu5sYAtX/jsYRHsTHoB6p6rNBZQkXODlmMczcGeIE78cuz1xf5+xS6Dq2CayiqImuSmCiWbT5uT90Nw==}
+ engines: {node: '>=18.12'}
+
+ '@pnpm/write-project-manifest@1000.0.16':
+ resolution: {integrity: sha512-zG68fk03ryot7TWUl9S/ShQ91uHWzIL9sVr2aQCuNHJo8G9kjsG6S0p58Zj/voahdDQeakZYYBSJ0mjNZeiJnw==}
+ engines: {node: '>=18.12'}
+
+ '@polka/url@1.0.0-next.29':
+ resolution: {integrity: sha512-wwQAWhWSuHaag8c4q/KN/vCoeOJYshAIvMQwD4GpSb3OiZklFfvAgmj0VCBBImRpuF/aFgIRzllXlVX93Jevww==}
+
+ '@poppinss/colors@4.1.6':
+ resolution: {integrity: sha512-H9xkIdFswbS8n1d6vmRd8+c10t2Qe+rZITbbDHHkQixH5+2x1FDGmi/0K+WgWiqQFKPSlIYB7jlH6Kpfn6Fleg==}
+
+ '@poppinss/dumper@0.7.0':
+ resolution: {integrity: sha512-0UTYalzk2t6S4rA2uHOz5bSSW2CHdv4vggJI6Alg90yvl0UgXs6XSXpH96OH+bRkX4J/06djv29pqXJ0lq5Kag==}
+
+ '@poppinss/exception@1.2.3':
+ resolution: {integrity: sha512-dCED+QRChTVatE9ibtoaxc+WkdzOSjYTKi/+uacHWIsfodVfpsueo3+DKpgU5Px8qXjgmXkSvhXvSCz3fnP9lw==}
+
+ '@publint/pack@0.1.4':
+ resolution: {integrity: sha512-HDVTWq3H0uTXiU0eeSQntcVUTPP3GamzeXI41+x7uU9J65JgWQh3qWZHblR1i0npXfFtF+mxBiU2nJH8znxWnQ==}
+ engines: {node: '>=18'}
+
+ '@quansync/fs@1.0.0':
+ resolution: {integrity: sha512-4TJ3DFtlf1L5LDMaM6CanJ/0lckGNtJcMjQ1NAV6zDmA0tEHKZtxNKin8EgPaVX1YzljbxckyT2tJrpQKAtngQ==}
+
+ '@rolldown/binding-android-arm64@1.0.0':
+ resolution: {integrity: sha512-TWMZnRLMe63C2Lhyicviu7ZHaU4kxa6PS3rofvc9GmcvptzNN11BcfQ4Sl7MwTOsisQoa2keB/EBdNCAnUo8vA==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [android]
+
+ '@rolldown/binding-android-arm64@1.0.2':
+ resolution: {integrity: sha512-ZS4D1JPGn/MYQN/SYDWftIE/nVsM8j/AFOYEzAoOE2O3NktQOZru+/vYXGbR/qtdLdIfGCP0lcoJiYVzsEz+iQ==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [android]
+
+ '@rolldown/binding-darwin-arm64@1.0.0':
+ resolution: {integrity: sha512-6XcD+8k0gPVItNagEw78/qqcBDwKcwDYS8V2hRmVsfUSIrd8cWe/CBvRDI5toqFyPfj+FJr6t8U6Xj2P2prEew==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [darwin]
+
+ '@rolldown/binding-darwin-arm64@1.0.2':
+ resolution: {integrity: sha512-vdFA9+C/rekyGce7WqHs/xoT0ioZEWaOFyZLIV1mEeNFaFDUQrPIo8Vs2GvJ6eetb3rzDUtUBgzto3ExpXJB3w==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [darwin]
+
+ '@rolldown/binding-darwin-x64@1.0.0':
+ resolution: {integrity: sha512-iN/tWVXRQDWvmZlKdceP1Dwug9GDpEymhb9p4xnEe6zvCg5lFmzVljl+1qR1NVx3yfGpr2Na+CuLmv5IU8uzfQ==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [darwin]
+
+ '@rolldown/binding-darwin-x64@1.0.2':
+ resolution: {integrity: sha512-BewSOwTHazv77DTYiAZXSqqKZ4KP/KonFisDMVU7PImxoWfB2aepnPhd2E4SWz3zDzYgDNbs6jBmTdgNnF02GA==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [darwin]
+
+ '@rolldown/binding-freebsd-x64@1.0.0':
+ resolution: {integrity: sha512-jjQMDvvwSOuhOwMszD/klSOjyWMM3zI64hWTj9KT5x4MxRbZAf+7vLQ6qouRhtsLVFHr3f0ILaJAfgENPiQdAQ==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [freebsd]
+
+ '@rolldown/binding-freebsd-x64@1.0.2':
+ resolution: {integrity: sha512-m41o7M0YWtUdqk61Tb+jnKb2rN++iRdIASlExkUoKfIAH30DOHCB8fVLzSUpbWHHU8esmEioY62PxzexE8MBuA==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [freebsd]
+
+ '@rolldown/binding-linux-arm-gnueabihf@1.0.0':
+ resolution: {integrity: sha512-d//Dtg2x6/m3mbV64yUGNnDGNZaDGRpDLLNGerHQUVObuNaIQaaDp25yUiqGXtHEXX+NP2d0wAlmKgpYgIAJ2A==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm]
+ os: [linux]
+
+ '@rolldown/binding-linux-arm-gnueabihf@1.0.2':
+ resolution: {integrity: sha512-jcojB9H7W/jS29pMKWAK1N+fU99vXodHDTatS3b3y/XSOCiHo0kkA74pL3jJmkoQtYpOCxDvaKs1fo2Ij/1X5w==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm]
+ os: [linux]
+
+ '@rolldown/binding-linux-arm64-gnu@1.0.0':
+ resolution: {integrity: sha512-n7Ofp0mx+aB2cC+Sdy5YtMnXtY9lchnHbY+3Yt0uq9JsWQExf4f5Whu0tK0R8Jdc9S6RchTHjIFY7uc92puOVQ==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [linux]
+ libc: [glibc]
+
+ '@rolldown/binding-linux-arm64-gnu@1.0.2':
+ resolution: {integrity: sha512-1jn6qDU5iiOgFgygDzKUuKP0maTi0/f1+sBLgvij/76C77Nm3ts6ufz9Bjg5q5dduxiUIxtq86JIoBvo1xQ4Ig==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [linux]
+ libc: [glibc]
+
+ '@rolldown/binding-linux-arm64-musl@1.0.0':
+ resolution: {integrity: sha512-EIVjy2cgd7uuMMo94FVkBp7F6DhcZAUwNURkSG3RwUmvAXR6s0ISxM81U+IydcZByPG0pZIHsf1b6kTxoFDgJA==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [linux]
+ libc: [musl]
+
+ '@rolldown/binding-linux-arm64-musl@1.0.2':
+ resolution: {integrity: sha512-QVLO/czFMdoMFSqlX3bcswcJNm/23r+qoa/jgtmFc/qEp6/jXmIkDjF/XIo8dPfGaiwy1xfQn8o77L79GeXFgw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [linux]
+ libc: [musl]
+
+ '@rolldown/binding-linux-ppc64-gnu@1.0.0':
+ resolution: {integrity: sha512-JEwwOPcwTLAcpDQlqSmjEmfs63xJnSiUNIGvLcDLUHCWK4XowpS/7c7tUsUH6uT/ct6bMUTdXKfI8967FYj6mg==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [ppc64]
+ os: [linux]
+ libc: [glibc]
+
+ '@rolldown/binding-linux-ppc64-gnu@1.0.2':
+ resolution: {integrity: sha512-hgO5Abm0w5UL6FEa2iFnZqo2KlK7TQ5QhV5x09hujBf7t5KzHQ1VmfPuTpqRy/rNlSxua3eWH374xxiVrP+lcA==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [ppc64]
+ os: [linux]
+ libc: [glibc]
+
+ '@rolldown/binding-linux-s390x-gnu@1.0.0':
+ resolution: {integrity: sha512-0wjCFhLrihtAubnT9iA0N++0pSV0z5Hg7tNGdNJ4RFaINceHadoF+kiFGyY1qSSNVIAZtLotG8Ju1bgDPkjnFA==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [s390x]
+ os: [linux]
+ libc: [glibc]
+
+ '@rolldown/binding-linux-s390x-gnu@1.0.2':
+ resolution: {integrity: sha512-fy8rXxuYEu602abC8MUNaPjYLIFzReOaEIEMKMUa0rFEUxNpVXhs15KSSQ4qlqSaM7B6rcj9rDZgADh/IGDzLQ==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [s390x]
+ os: [linux]
+ libc: [glibc]
+
+ '@rolldown/binding-linux-x64-gnu@1.0.0':
+ resolution: {integrity: sha512-Dfn7iak9BcMMePxcoJfpSbWqnEyrp/dRF63/8qW/eHBdOZov6x5aShLLEYGYdIeSJ6vMLK/XCVB+lGIxm41bQA==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [linux]
+ libc: [glibc]
+
+ '@rolldown/binding-linux-x64-gnu@1.0.2':
+ resolution: {integrity: sha512-0+bOkiQ779+r1WpoHOWHqncvyySci0vKph+myNDYb+im6meJAzHQXay6oEgnkHuUGouM1LKTZwqKpBow6Kj7CQ==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [linux]
+ libc: [glibc]
+
+ '@rolldown/binding-linux-x64-musl@1.0.0':
+ resolution: {integrity: sha512-5/utzzDmD/pD/bmuaUcbTf/sZYy0aztwIVlfpoW1fTjCZ0BaPOMVWGZL1zvgxyi7ZIVYWlxKONHmSbHuiOh8Jw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [linux]
+ libc: [musl]
+
+ '@rolldown/binding-linux-x64-musl@1.0.2':
+ resolution: {integrity: sha512-mjSkrzZK5Qsl0a9d1JgILOiuZOSDTVdKENcSXBoqbzSrspLR/4/IRVDo5wd2GgZjNss/viBFJdeq+j7qH2nypw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [linux]
+ libc: [musl]
+
+ '@rolldown/binding-openharmony-arm64@1.0.0':
+ resolution: {integrity: sha512-ouJs8VcUomfLfpbUECqFMRqdV4x6aeAK3MA4m6vTrJJjKyWTV5KnxZx7Jd9G+GlDaQQxubcba00x16OyJ1meig==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [openharmony]
+
+ '@rolldown/binding-openharmony-arm64@1.0.2':
+ resolution: {integrity: sha512-1v5vHasdfQAZoEHakBV72LIFAC9JjnymsiKxp+GEr/ma3+NJCPSaYK+qavInOovJkgwFrs7GccX2d6IgDA3Z5w==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [openharmony]
+
+ '@rolldown/binding-wasm32-wasi@1.0.0':
+ resolution: {integrity: sha512-E+oHKGiDA+lsKMmFtffDDw91EryDT7uJocrIuCHqhm6bCTM6xFK+3gaCkYOHfPwQr0cCNarSM2xaELoQDz9jJg==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [wasm32]
+
+ '@rolldown/binding-wasm32-wasi@1.0.2':
+ resolution: {integrity: sha512-mb1VobWn6NheziTk5/WEaR6AKVbrwT5sOi6C7zk3gy/pD1qtJfU1j4PgTo2NJnOtbL9Dl3Aeei8w9jJ7qC2jZQ==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [wasm32]
+
+ '@rolldown/binding-win32-arm64-msvc@1.0.0':
+ resolution: {integrity: sha512-yYK02n8Rngo+gbm1y6G0+7jk1sJ/2Wt7K0me0Y7k/ErBpyf+LJ2gFpqWVTcRV1rUepBlQRmpgWkTQCiiwrK0Ow==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [win32]
+
+ '@rolldown/binding-win32-arm64-msvc@1.0.2':
+ resolution: {integrity: sha512-SqKonF56vA/L2yHwHYcEp2P34URpOZ7d1fS635cTkpDnUtEGdUbhI6NzsPdqeSWvAAeGDrxjWjNmibDIdFf9/A==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [arm64]
+ os: [win32]
+
+ '@rolldown/binding-win32-x64-msvc@1.0.0':
+ resolution: {integrity: sha512-14bpChMahXRRXiTwahSl+zzHPW6qQTXtkMuJBFlbo+pqSAews2d4BdCSHfrJ/MBsCZtpmTafsY+1QhBzitcmdg==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [win32]
+
+ '@rolldown/binding-win32-x64-msvc@1.0.2':
+ resolution: {integrity: sha512-v7qRI7gXLRINcOGXt+7YmAZ6iFuyZVMIoXAxhd8oP+DR9dLfL9GfNIx7PLMxmhZdvq8waUJBQiWN9EKNy+TRBQ==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ cpu: [x64]
+ os: [win32]
+
+ '@rolldown/debug@1.0.2':
+ resolution: {integrity: sha512-W3V3SWZVRdEWWb8u4Ppci2sQlzj0S0rh/U8BaUmbrzHZ58jz1+UPLxwCZqSqB6UkbbcE1nMu/rXlSXTQ2tszSw==}
+
+ '@rolldown/pluginutils@1.0.0':
+ resolution: {integrity: sha512-aKs/3GSWyV0mrhNmt/96/Z3yczC3yvrzYATCiCXQebBsGyYzjNdUphRVLeJQ67ySKVXRfMxt2lm12pmXvbPFQQ==}
+
+ '@rolldown/pluginutils@1.0.1':
+ resolution: {integrity: sha512-2j9bGt5Jh8hj+vPtgzPtl72j0yRxHAyumoo6TNfAjsLB04UtpSvPbPcDcBMxz7n+9CYB0c1GxQFxYRg2jimqGw==}
+
+ '@rollup/plugin-alias@5.1.1':
+ resolution: {integrity: sha512-PR9zDb+rOzkRb2VD+EuKB7UC41vU5DIwZ5qqCpk0KJudcWAyi8rvYOhS7+L5aZCspw1stTViLgN5v6FF1p5cgQ==}
+ engines: {node: '>=14.0.0'}
+ peerDependencies:
+ rollup: ^1.20.0||^2.0.0||^3.0.0||^4.0.0
+ peerDependenciesMeta:
+ rollup:
+ optional: true
+
+ '@rollup/plugin-alias@6.0.0':
+ resolution: {integrity: sha512-tPCzJOtS7uuVZd+xPhoy5W4vThe6KWXNmsFCNktaAh5RTqcLiSfT4huPQIXkgJ6YCOjJHvecOAzQxLFhPxKr+g==}
+ engines: {node: '>=20.19.0'}
+ peerDependencies:
+ rollup: '>=4.0.0'
+ peerDependenciesMeta:
+ rollup:
+ optional: true
+
+ '@rollup/plugin-babel@7.0.0':
+ resolution: {integrity: sha512-NS2+P7v80N3MQqehZEjgpaFb9UyX3URNMW/zvoECKGo4PY4DvJfQusTI7BX/Ks+CPvtTfk3TqcR6S9VYBi/C+A==}
+ engines: {node: '>=14.0.0'}
+ peerDependencies:
+ '@babel/core': ^7.0.0
+ '@types/babel__core': ^7.1.9
+ rollup: ^2.0.0||^3.0.0||^4.0.0
+ peerDependenciesMeta:
+ '@types/babel__core':
+ optional: true
+ rollup:
+ optional: true
+
+ '@rollup/plugin-commonjs@28.0.9':
+ resolution: {integrity: sha512-PIR4/OHZ79romx0BVVll/PkwWpJ7e5lsqFa3gFfcrFPWwLXLV39JVUzQV9RKjWerE7B845Hqjj9VYlQeieZ2dA==}
+ engines: {node: '>=16.0.0 || 14 >= 14.17'}
+ peerDependencies:
+ rollup: ^2.68.0||^3.0.0||^4.0.0
+ peerDependenciesMeta:
+ rollup:
+ optional: true
+
+ '@rollup/plugin-commonjs@29.0.2':
+ resolution: {integrity: sha512-S/ggWH1LU7jTyi9DxZOKyxpVd4hF/OZ0JrEbeLjXk/DFXwRny0tjD2c992zOUYQobLrVkRVMDdmHP16HKP7GRg==}
+ engines: {node: '>=16.0.0 || 14 >= 14.17'}
+ peerDependencies:
+ rollup: ^2.68.0||^3.0.0||^4.0.0
+ peerDependenciesMeta:
+ rollup:
+ optional: true
+
+ '@rollup/plugin-inject@5.0.5':
+ resolution: {integrity: sha512-2+DEJbNBoPROPkgTDNe8/1YXWcqxbN5DTjASVIOx8HS+pITXushyNiBV56RB08zuptzz8gT3YfkqriTBVycepg==}
+ engines: {node: '>=14.0.0'}
+ peerDependencies:
+ rollup: ^1.20.0||^2.0.0||^3.0.0||^4.0.0
+ peerDependenciesMeta:
+ rollup:
+ optional: true
+
+ '@rollup/plugin-json@6.1.0':
+ resolution: {integrity: sha512-EGI2te5ENk1coGeADSIwZ7G2Q8CJS2sF120T7jLw4xFw9n7wIOXHo+kIYRAoVpJAN+kmqZSoO3Fp4JtoNF4ReA==}
+ engines: {node: '>=14.0.0'}
+ peerDependencies:
+ rollup: ^1.20.0||^2.0.0||^3.0.0||^4.0.0
+ peerDependenciesMeta:
+ rollup:
+ optional: true
+
+ '@rollup/plugin-node-resolve@16.0.3':
+ resolution: {integrity: sha512-lUYM3UBGuM93CnMPG1YocWu7X802BrNF3jW2zny5gQyLQgRFJhV1Sq0Zi74+dh/6NBx1DxFC4b4GXg9wUCG5Qg==}
+ engines: {node: '>=14.0.0'}
+ peerDependencies:
+ rollup: ^2.78.0||^3.0.0||^4.0.0
+ peerDependenciesMeta:
+ rollup:
+ optional: true
+
+ '@rollup/plugin-replace@6.0.3':
+ resolution: {integrity: sha512-J4RZarRvQAm5IF0/LwUUg+obsm+xZhYnbMXmXROyoSE1ATJe3oXSb9L5MMppdxP2ylNSjv6zFBwKYjcKMucVfA==}
+ engines: {node: '>=14.0.0'}
+ peerDependencies:
+ rollup: ^1.20.0||^2.0.0||^3.0.0||^4.0.0
+ peerDependenciesMeta:
+ rollup:
+ optional: true
+
+ '@rollup/plugin-terser@1.0.0':
+ resolution: {integrity: sha512-FnCxhTBx6bMOYQrar6C8h3scPt8/JwIzw3+AJ2K++6guogH5fYaIFia+zZuhqv0eo1RN7W1Pz630SyvLbDjhtQ==}
+ engines: {node: '>=20.0.0'}
+ peerDependencies:
+ rollup: ^2.0.0||^3.0.0||^4.0.0
+ peerDependenciesMeta:
+ rollup:
+ optional: true
+
+ '@rollup/pluginutils@5.3.0':
+ resolution: {integrity: sha512-5EdhGZtnu3V88ces7s53hhfK5KSASnJZv8Lulpc04cWO3REESroJXg73DFsOmgbU2BhwV0E20bu2IDZb3VKW4Q==}
+ engines: {node: '>=14.0.0'}
+ peerDependencies:
+ rollup: ^1.20.0||^2.0.0||^3.0.0||^4.0.0
+ peerDependenciesMeta:
+ rollup:
+ optional: true
+
+ '@rollup/rollup-android-arm-eabi@4.60.4':
+ resolution: {integrity: sha512-F5QXMSiFebS9hKZj02XhWLLnRpJ3B3AROP0tWbFBSj+6kCbg5m9j5JoHKd4mmSVy5mS/IMQloYgYxCuJC0fxEQ==}
+ cpu: [arm]
+ os: [android]
+
+ '@rollup/rollup-android-arm64@4.60.4':
+ resolution: {integrity: sha512-GxxTKApUpzRhof7poWvCJHRF51C67u1R7D6DiluBE8wKU1u5GWE8t+v81JvJYtbawoBFX1hLv5Ei4eVjkWokaw==}
+ cpu: [arm64]
+ os: [android]
+
+ '@rollup/rollup-darwin-arm64@4.60.4':
+ resolution: {integrity: sha512-tua0TaJxMOB1R0V0RS1jFZ/RpURFDJIOR2A6jWwQeawuFyS4gBW+rntLRaQd0EQ4bd6Vp44Z2rXW+YYDBsj6IA==}
+ cpu: [arm64]
+ os: [darwin]
+
+ '@rollup/rollup-darwin-x64@4.60.4':
+ resolution: {integrity: sha512-CSKq7MsP+5PFIcydhAiR1K0UhEI1A2jWXVKHPCBZ151yOutENwvnPocgVHkivu2kviURtCEB6zUQw0vs8RrhMg==}
+ cpu: [x64]
+ os: [darwin]
+
+ '@rollup/rollup-freebsd-arm64@4.60.4':
+ resolution: {integrity: sha512-+O8OkVdyvXMtJEciu2wS/pzm1IxntEEQx3z5TAVy4l32G0etZn+RsA48ARRrFm6Ri8fvqPQfgrvNxSjKAbnd3g==}
+ cpu: [arm64]
+ os: [freebsd]
+
+ '@rollup/rollup-freebsd-x64@4.60.4':
+ resolution: {integrity: sha512-Iw3oMskH3AfNuhU0MSN7vNbdi4me/NiYo2azqPz/Le16zHSa+3RRmliCMWWQmh4lcndccU40xcJuTYJZxNo/lw==}
+ cpu: [x64]
+ os: [freebsd]
+
+ '@rollup/rollup-linux-arm-gnueabihf@4.60.4':
+ resolution: {integrity: sha512-EIPRXTVQpHyF8WOo219AD2yEltPehLTcTMz2fn6JsatLYSzQf00hj3rulF+yauOlF9/FtM2WpkT/hJh/KJFGhA==}
+ cpu: [arm]
+ os: [linux]
+ libc: [glibc]
+
+ '@rollup/rollup-linux-arm-musleabihf@4.60.4':
+ resolution: {integrity: sha512-J3Yh9PzzF1Ovah2At+lHiGQdsYgArxBbXv/zHfSyaiFQEqvNv7DcW98pCrmdjCZBrqBiKrKKe2V+aaSGWuBe/w==}
+ cpu: [arm]
+ os: [linux]
+ libc: [musl]
+
+ '@rollup/rollup-linux-arm64-gnu@4.60.4':
+ resolution: {integrity: sha512-BFDEZMYfUvLn37ONE1yMBojPxnMlTFsdyNoqncT0qFq1mAfllL+ATMMJd8TeuVMiX84s1KbcxcZbXInmcO2mRg==}
+ cpu: [arm64]
+ os: [linux]
+ libc: [glibc]
+
+ '@rollup/rollup-linux-arm64-musl@4.60.4':
+ resolution: {integrity: sha512-pc9EYOSlOgdQ2uPl1o9PF6/kLSgaUosia7gOuS8mB69IxJvlclko1MECXysjs5ryez1/5zjYqx3+xYU0TU6R1A==}
+ cpu: [arm64]
+ os: [linux]
+ libc: [musl]
+
+ '@rollup/rollup-linux-loong64-gnu@4.60.4':
+ resolution: {integrity: sha512-NxnomyxYerDh5n4iLrNa+sH+Z+U4BMEE46V2PgQ/hoB909i8gV1M5wPojWg9fk1jWpO3IQnOs20K4wyZuFLEFQ==}
+ cpu: [loong64]
+ os: [linux]
+ libc: [glibc]
+
+ '@rollup/rollup-linux-loong64-musl@4.60.4':
+ resolution: {integrity: sha512-nbJnQ8a3z1mtmrwImCYhc6BGpThAyYVRQxw9uKSKG4wR6aAYno9sVjJ0zaZcW9BPJX1GbrDPf+SvdWjgTuDmnw==}
+ cpu: [loong64]
+ os: [linux]
+ libc: [musl]
+
+ '@rollup/rollup-linux-ppc64-gnu@4.60.4':
+ resolution: {integrity: sha512-2EU6acNrQLd8tYvo/LXW535wupT3m6fo7HKo6lr7ktQoItxTyOL1ZCR/GfGCuXl2vR+zmfI6eRXkSemafv+iVg==}
+ cpu: [ppc64]
+ os: [linux]
+ libc: [glibc]
+
+ '@rollup/rollup-linux-ppc64-musl@4.60.4':
+ resolution: {integrity: sha512-WeBtoMuaMxiiIrO2IYP3xs6GMWkJP2C0EoT8beTLkUPmzV1i/UcOSVw1d5r9KBODtHKilG5yFxsGRnBbK3wJ4A==}
+ cpu: [ppc64]
+ os: [linux]
+ libc: [musl]
+
+ '@rollup/rollup-linux-riscv64-gnu@4.60.4':
+ resolution: {integrity: sha512-FJHFfqpKUI3A10WrWKiFbBZ7yVbGT4q4B5o1qKFFojqpaYoh9LrQgqWCmmcxQzVSXYtyB5bzkXrYzlHTs21MYA==}
+ cpu: [riscv64]
+ os: [linux]
+ libc: [glibc]
+
+ '@rollup/rollup-linux-riscv64-musl@4.60.4':
+ resolution: {integrity: sha512-mcEl6CUT5IAUmQf1m9FYSmVqCJlpQ8r8eyftFUHG8i9OhY7BkBXSUdnLH5DOf0wCOjcP9v/QO93zpmF1SptCCw==}
+ cpu: [riscv64]
+ os: [linux]
+ libc: [musl]
+
+ '@rollup/rollup-linux-s390x-gnu@4.60.4':
+ resolution: {integrity: sha512-ynt3JxVd2w2buzoKDWIyiV1pJW93xlQic1THVLXilz429oijRpSHivZAgp65KBu+cMcgf1eVVjdnTLvPxgCuoQ==}
+ cpu: [s390x]
+ os: [linux]
+ libc: [glibc]
+
+ '@rollup/rollup-linux-x64-gnu@4.60.4':
+ resolution: {integrity: sha512-Boiz5+MsaROEWDf+GGEwF8VMHGhlUoQMtIPjOgA5fv4osupqTVnJteQNKJwUcnUog2G55jYXH7KZFFiJe0TEzQ==}
+ cpu: [x64]
+ os: [linux]
+ libc: [glibc]
+
+ '@rollup/rollup-linux-x64-musl@4.60.4':
+ resolution: {integrity: sha512-+qfSY27qIrFfI/Hom04KYFw3GKZSGU4lXus51wsb5EuySfFlWRwjkKWoE9emgRw/ukoT4Udsj4W/+xxG8VbPKg==}
+ cpu: [x64]
+ os: [linux]
+ libc: [musl]
+
+ '@rollup/rollup-openbsd-x64@4.60.4':
+ resolution: {integrity: sha512-VpTfOPHgVXEBeeR8hZ2O0F3aSso+JDWqTWmTmzcQKted54IAdUVbxE+j/MVxUsKa8L20HJhv3vUezVPoquqWjA==}
+ cpu: [x64]
+ os: [openbsd]
+
+ '@rollup/rollup-openharmony-arm64@4.60.4':
+ resolution: {integrity: sha512-IPOsh5aRYuLv/nkU51X10Bf75Bsf6+gZdx1X+QP5QM6lIJFHHqbHLG0uJn/hWthzo13UAc2umiUorqZy3axoZg==}
+ cpu: [arm64]
+ os: [openharmony]
+
+ '@rollup/rollup-win32-arm64-msvc@4.60.4':
+ resolution: {integrity: sha512-4QzE9E81OohJ/HKzHhsqU+zcYYojVOXlFMs1DdyMT6qXl/niOH7AVElmmEdUNHHS/oRkc++d5k6Vy85zFs0DEw==}
+ cpu: [arm64]
+ os: [win32]
+
+ '@rollup/rollup-win32-ia32-msvc@4.60.4':
+ resolution: {integrity: sha512-zTPgT1YuHHcd+Tmx7h8aml0FWFVelV5N54oHow9SLj+GfoDy/huQ+UV396N/C7KpMDMiPspRktzM1/0r1usYEA==}
+ cpu: [ia32]
+ os: [win32]
+
+ '@rollup/rollup-win32-x64-gnu@4.60.4':
+ resolution: {integrity: sha512-DRS4G7mi9lJxqEDezIkKCaUIKCrLUUDCUaCsTPCi/rtqaC6D/jjwslMQyiDU50Ka0JKpeXeRBFBAXwArY52vBw==}
+ cpu: [x64]
+ os: [win32]
+
+ '@rollup/rollup-win32-x64-msvc@4.60.4':
+ resolution: {integrity: sha512-QVTUovf40zgTqlFVrKA1uXMVvU2QWEFWfAH8Wdc48IxLvrJMQVMBRjuQyUpzZCDkakImib9eVazbWlC6ksWtJw==}
+ cpu: [x64]
+ os: [win32]
+
+ '@rspack/binding-darwin-arm64@2.0.3':
+ resolution: {integrity: sha512-4UyCjLJwU/WxR6K1/gG4u3+jUsoaRHJ5rNu9fto/UbvrItwdlVNULChAApqZFw6mcSetMddSjSICeuj5pSB6sA==}
+ cpu: [arm64]
+ os: [darwin]
+
+ '@rspack/binding-darwin-x64@2.0.3':
+ resolution: {integrity: sha512-K3evrbTgZNa8emEqk+AjDtbuoXZp5tPZz3pcEgETxuu3KanW8Zu+Fb+TUp1DEUcL0xOmHPPox8H2cZ3pF4Zmug==}
+ cpu: [x64]
+ os: [darwin]
+
+ '@rspack/binding-linux-arm64-gnu@2.0.3':
+ resolution: {integrity: sha512-aPLDaaTtX1wqjLYAIHc2MGDQZtv1Hbjx47oaaefbWz5GbAnSA4P8jdYIeeGRyrqvQ0WqJXIWXgT0d/iXtes00A==}
+ cpu: [arm64]
+ os: [linux]
+ libc: [glibc]
+
+ '@rspack/binding-linux-arm64-musl@2.0.3':
+ resolution: {integrity: sha512-0WulUQPop6vmSDfrTxghmVlm+6crU8/XqD2f0dOWbEniZVuDZJ5/Y/cBqTRyk3rjl0vrmUv3lc87/t7UgQJQSw==}
+ cpu: [arm64]
+ os: [linux]
+ libc: [musl]
+
+ '@rspack/binding-linux-x64-gnu@2.0.3':
+ resolution: {integrity: sha512-fAhiMuV5omT53YMft+f3Y9euAFgspuyBAk9ZpeW2buL2TkuUMwP07adhhvQfKdQ5gpELfzmjQaRDGqaIT8UWiA==}
+ cpu: [x64]
+ os: [linux]
+ libc: [glibc]
+
+ '@rspack/binding-linux-x64-musl@2.0.3':
+ resolution: {integrity: sha512-0kcuFoZ8vy2iNWoISFOZt+/Ujo7LRLrzE7h07AV5r+oN/mv+/v14Sd/8NUtDIScCkrYOszYq/QS31e6t0UrVfw==}
+ cpu: [x64]
+ os: [linux]
+ libc: [musl]
+
+ '@rspack/binding-wasm32-wasi@2.0.3':
+ resolution: {integrity: sha512-x2fsw7GzNZEnw444ikj4/b8kVjM0Y0TllxmizHpYZ9gmaQrOk5OXo9RQdz+l4zzoGors0l2IZP5Cc4GJNCaSoQ==}
+ cpu: [wasm32]
+
+ '@rspack/binding-win32-arm64-msvc@2.0.3':
+ resolution: {integrity: sha512-jqlxuVPdrgMuwj/HEjSkC/jmhl4fAuKyob36zJXq2uAusn2FRJ4kClGe1fLFpfxRXFVQAWwlAOwLJg8T0suuaA==}
+ cpu: [arm64]
+ os: [win32]
+
+ '@rspack/binding-win32-ia32-msvc@2.0.3':
+ resolution: {integrity: sha512-QM4JEuyk5QaZ5gnvnAIaCwVQzCkrD2E4Sud77kx/MVGDsRkcOlMx3blMC5QNHPDamRmWGk+7314YOQvRhKuWyg==}
+ cpu: [ia32]
+ os: [win32]
+
+ '@rspack/binding-win32-x64-msvc@2.0.3':
+ resolution: {integrity: sha512-vSQNnAy0wswG6AfNRuArTHQBiXOXl+A9ddQxBFup4PMHUzXxKtsBLQzw7BgFC0EgrPeHbt+30j7sXVZKYukj4A==}
+ cpu: [x64]
+ os: [win32]
+
+ '@rspack/binding@2.0.3':
+ resolution: {integrity: sha512-4exVNhGhW5RFHjK87XeTKbkA/qAgI5NHJlT1jNqiJv0gcUXLqTOEU3w7f8+f9zUo4JMFvPc0c9veOi4M19YYTg==}
+
+ '@rspack/core@2.0.3':
+ resolution: {integrity: sha512-2ufO/8FHIA/lX6UOgSsKPhpDvHr0sh9lYq/n/LsIZsTwu3973BGbu2fg1Akvuu3rEnskPqXjsqH2EPBzEA42uA==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ peerDependencies:
+ '@module-federation/runtime-tools': ^0.24.1 || ^2.0.0
+ '@swc/helpers': '>=0.5.1'
+ peerDependenciesMeta:
+ '@module-federation/runtime-tools':
+ optional: true
+ '@swc/helpers':
+ optional: true
+
+ '@rspack/lite-tapable@1.1.0':
+ resolution: {integrity: sha512-E2B0JhYFmVAwdDiG14+DW0Di4Ze4Jg10Pc4/lILUrd5DRCaklduz2OvJ5HYQ6G+hd+WTzqQb3QnDNfK4yvAFYw==}
+
+ '@shikijs/core@4.1.0':
+ resolution: {integrity: sha512-jLJtSJeuFffqX6/inRE1zqU5aFv2hrszvYgq3OjbAgFRZiWv7abKMDdQzYxuSDfmUPQozZvI/kuy6VMTvnvqTQ==}
+ engines: {node: '>=20'}
+
+ '@shikijs/engine-javascript@4.1.0':
+ resolution: {integrity: sha512-YquhawCUgaBfhsS72e2Y/dI59gCBNPHu3fEO/tvLaXrTssxZrY5ddjtNLTwndrMgPo8b3IscE+xoICDzpTmlFQ==}
+ engines: {node: '>=20'}
+
+ '@shikijs/engine-oniguruma@4.1.0':
+ resolution: {integrity: sha512-axLpjVs45YBvvINa+dJF+NPW+KtFkNXsFr4SDw2BMj9GdeMnGxVB9PQb2xXlJYovslt/nz6giedAyOANkfc7hg==}
+ engines: {node: '>=20'}
+
+ '@shikijs/langs@4.1.0':
+ resolution: {integrity: sha512-nwOMruEkbgdZfQ/b8CgpNBVOpvG1k0N5tbmgiFeqsan401+x3ILqlzZJowSla4Agmq4hG2Uf2wh5jLTEhR8VSg==}
+ engines: {node: '>=20'}
+
+ '@shikijs/primitive@4.1.0':
+ resolution: {integrity: sha512-zx2/2Uwj2q9X3KSyYREEhXO23xBw5WUhP4orK2lE4r+t9JGITmEe0JH+wPmJhqHpOT2bRRs6lAL945+LDvOAGw==}
+ engines: {node: '>=20'}
+
+ '@shikijs/themes@4.1.0':
+ resolution: {integrity: sha512-emCcTnUM7yO2wltYbaxm+yLvcCI4+h8XBKc4KmJ7EZUXoSGjcCHifkI//R4OFit9ewpg7H2/9tjOuXrT2v/Knw==}
+ engines: {node: '>=20'}
+
+ '@shikijs/transformers@4.1.0':
+ resolution: {integrity: sha512-YbuOcAA3kwqKDU9YSt00dtFLrY5lBXjKU3dWaMATyEyPSqBm9Jqblk/uVICxz7lcjwAHzYaEvIiMWX3mTpogkA==}
+ engines: {node: '>=20'}
+
+ '@shikijs/twoslash@4.1.0':
+ resolution: {integrity: sha512-XD7d3LqLXOaL6PbFKGwtdnfcyBdOfKWfxb1+c4MVknVTemwnMQxqj1wYhhWBLRdk8H3Fp9pyf/FILfy2Nzeg8g==}
+ engines: {node: '>=20'}
+ peerDependencies:
+ typescript: '>=5.5.0'
+
+ '@shikijs/types@4.1.0':
+ resolution: {integrity: sha512-3EQWX54fMpniOrDblzAhiwiJwpiTMW6+B9DWyUd9ska483tbayFYuw47UxwuPknI31bKnySfVQ/QW+jFL4rFdA==}
+ engines: {node: '>=20'}
+
+ '@shikijs/vitepress-twoslash@4.1.0':
+ resolution: {integrity: sha512-/eXm6H0fAcLKjU+DyEKBNjQeqpIoeCbY10IO8i8FftB7juVAX1Or49AFBJGRYfrKgTrXOaLsNaocL3jV/dgoTg==}
+ engines: {node: '>=20'}
+
+ '@shikijs/vscode-textmate@10.0.2':
+ resolution: {integrity: sha512-83yeghZ2xxin3Nj8z1NMd/NCuca+gsYXswywDy5bHvwlWL8tpTQmzGeUuHd9FC3E/SBEMvzJRwWEOz5gGes9Qg==}
+
+ '@sidvind/better-ajv-errors@7.0.0':
+ resolution: {integrity: sha512-imVsp5D3KxJ8+uUmu2dsLKnFg3qdX952v/L1gZoCa0NO2ivhQWHMpYM2KmpFrRXHWFjlqkNZ/935nxiTqXEi1A==}
+ engines: {node: ^22.12 || >= 24.0}
+ peerDependencies:
+ ajv: ^8.0.0
+
+ '@sinclair/typebox@0.34.49':
+ resolution: {integrity: sha512-brySQQs7Jtn0joV8Xh9ZV/hZb9Ozb0pmazDIASBkYKCjXrXU3mpcFahmK/z4YDhGkQvP9mWJbVyahdtU5wQA+A==}
+
+ '@sindresorhus/base62@1.0.0':
+ resolution: {integrity: sha512-TeheYy0ILzBEI/CO55CP6zJCSdSWeRtGnHy8U8dWSUH4I68iqTsy7HkMktR4xakThc9jotkPQUXT4ITdbV7cHA==}
+ engines: {node: '>=18'}
+
+ '@sindresorhus/is@4.6.0':
+ resolution: {integrity: sha512-t09vSN3MdfsyCHoFcTRCH/iUtG7OJ0CsjzB8cjAmKc/va/kIgeDI/TxsigdncE/4be734m0cvIYwNaV4i2XqAw==}
+ engines: {node: '>=10'}
+
+ '@sindresorhus/is@7.2.0':
+ resolution: {integrity: sha512-P1Cz1dWaFfR4IR+U13mqqiGsLFf1KbayybWwdd2vfctdV6hDpUkgCY0nKOLLTMSoRd/jJNjtbqzf13K8DCCXQw==}
+ engines: {node: '>=18'}
+
+ '@sindresorhus/merge-streams@4.0.0':
+ resolution: {integrity: sha512-tlqY9xq5ukxTUZBmoOp+m61cqwQD5pHJtFY3Mn8CA8ps6yghLH/Hw8UPdqg4OLmFW3IFlcXnQNmo/dh8HzXYIQ==}
+ engines: {node: '>=18'}
+
+ '@speed-highlight/core@1.2.15':
+ resolution: {integrity: sha512-BMq1K3DsElxDWawkX6eLg9+CKJrTVGCBAWVuHXVUV2u0s2711qiChLSId6ikYPfxhdYocLNt3wWwSvDiTvFabw==}
+
+ '@standard-schema/spec@1.1.0':
+ resolution: {integrity: sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w==}
+
+ '@stylistic/eslint-plugin@5.10.0':
+ resolution: {integrity: sha512-nPK52ZHvot8Ju/0A4ucSX1dcPV2/1clx0kLcH5wDmrE4naKso7TUC/voUyU1O9OTKTrR6MYip6LP0ogEMQ9jPQ==}
+ engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+ peerDependencies:
+ eslint: ^9.0.0 || ^10.0.0
+
+ '@testing-library/dom@9.3.4':
+ resolution: {integrity: sha512-FlS4ZWlp97iiNWig0Muq8p+3rVDjRiYE+YKGbAqXOu9nwJFFOdL00kFpz42M+4huzYi86vAK1sOOfyOG45muIQ==}
+ engines: {node: '>=14'}
+
+ '@testing-library/vue@8.1.0':
+ resolution: {integrity: sha512-ls4RiHO1ta4mxqqajWRh8158uFObVrrtAPoxk7cIp4HrnQUj/ScKzqz53HxYpG3X6Zb7H2v+0eTGLSoy8HQ2nA==}
+ engines: {node: '>=14'}
+ peerDependencies:
+ '@vue/compiler-sfc': '>= 3'
+ vue: 3.5.34
+ peerDependenciesMeta:
+ '@vue/compiler-sfc':
+ optional: true
+
+ '@tybys/wasm-util@0.10.2':
+ resolution: {integrity: sha512-RoBvJ2X0wuKlWFIjrwffGw1IqZHKQqzIchKaadZZfnNpsAYp2mM0h36JtPCjNDAHGgYez/15uMBpfGwchhiMgg==}
+
+ '@types/aria-query@5.0.4':
+ resolution: {integrity: sha512-rfT93uj5s0PRL7EzccGMs3brplhcrghnDoV26NqKhCAS1hVo+WdNsPvE/yb6ilfr5hi2MEk6d5EWJTKdxg8jVw==}
+
+ '@types/babel__core@7.20.5':
+ resolution: {integrity: sha512-qoQprZvz5wQFJwMDqeseRXWv3rqMvhgpbXFfVyWhbx9X47POIA6i/+dXefEmZKoAgOaTdaIgNSMqMIU61yRyzA==}
+
+ '@types/babel__generator@7.27.0':
+ resolution: {integrity: sha512-ufFd2Xi92OAVPYsy+P4n7/U7e68fex0+Ee8gSG9KX7eo084CWiQ4sdxktvdl0bOPupXtVJPY19zk6EwWqUQ8lg==}
+
+ '@types/babel__helper-plugin-utils@7.10.3':
+ resolution: {integrity: sha512-FcLBBPXInqKfULB2nvOBskQPcnSMZ0s1Y2q76u9H1NPPWaLcTeq38xBeKfF/RBUECK333qeaqRdYoPSwW7rTNQ==}
+
+ '@types/babel__template@7.4.4':
+ resolution: {integrity: sha512-h/NUaSyG5EyxBIp8YRxo4RMe2/qQgvyowRwVMzhYhBCONbW8PUsg4lkFMrhgZhUe5z3L3MiLDuvyJ/CaPa2A8A==}
+
+ '@types/babel__traverse@7.28.0':
+ resolution: {integrity: sha512-8PvcXf70gTDZBgt9ptxJ8elBeBjcLOAcOtoO/mPJjtji1+CdGbHgm77om1GrsPxsiE+uXIpNSK64UYaIwQXd4Q==}
+
+ '@types/chai@5.2.3':
+ resolution: {integrity: sha512-Mw558oeA9fFbv65/y4mHtXDs9bPnFMZAL/jxdPFUpOHHIXX91mcgEHbS5Lahr+pwZFR8A7GQleRWeI6cGFC2UA==}
+
+ '@types/connect@3.4.38':
+ resolution: {integrity: sha512-K6uROf1LD88uDQqJCktA4yzL1YYAK6NgfsI0v/mTgyPKWsX1CnJ0XPSDhViejru1GcRkLWb8RlzFYJRqGUbaug==}
+
+ '@types/debug@4.1.13':
+ resolution: {integrity: sha512-KSVgmQmzMwPlmtljOomayoR89W4FynCAi3E8PPs7vmDVPe84hT+vGPKkJfThkmXs0x0jAaa9U8uW8bbfyS2fWw==}
+
+ '@types/deep-eql@4.0.2':
+ resolution: {integrity: sha512-c9h9dVVMigMPc4bwTvC5dxqtqJZwQPePsWjPlpSOnojbor6pGqdk541lfA7AqFQr5pB1BRdq0juY9db81BwyFw==}
+
+ '@types/eslint-scope@3.7.7':
+ resolution: {integrity: sha512-MzMFlSLBqNF2gcHWO0G1vP/YQyfvrxZ0bF+u7mzUdZ1/xK4A4sru+nraZz5i3iEIk1l1uyicaDVTB4QbbEkAYg==}
+
+ '@types/eslint@9.6.1':
+ resolution: {integrity: sha512-FXx2pKgId/WyYo2jXw63kk7/+TY7u7AziEJxJAnSFzHlqTAS3Ync6SvgYAN/k4/PQpnnVuzoMuVnByKK2qp0ag==}
+
+ '@types/esrecurse@4.3.1':
+ resolution: {integrity: sha512-xJBAbDifo5hpffDBuHl0Y8ywswbiAp/Wi7Y/GtAgSlZyIABppyurxVueOPE8LUQOxdlgi6Zqce7uoEpqNTeiUw==}
+
+ '@types/estree@1.0.8':
+ resolution: {integrity: sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==}
+
+ '@types/estree@1.0.9':
+ resolution: {integrity: sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==}
+
+ '@types/hast@3.0.4':
+ resolution: {integrity: sha512-WPs+bbQw5aCj+x6laNGWLH3wviHtoCv/P3+otBhbOhJgG8qtpdAMlTCxLtsTWA7LH1Oh/bFCHsBn0TPS5m30EQ==}
+
+ '@types/istanbul-lib-coverage@2.0.6':
+ resolution: {integrity: sha512-2QF/t/auWm0lsy8XtKVPG19v3sSOQlJe/YHZgfjb/KBBHOGSV+J2q/S671rcq9uTBrLAXmZpqJiaQbMT+zNU1w==}
+
+ '@types/istanbul-lib-report@3.0.3':
+ resolution: {integrity: sha512-NQn7AHQnk/RSLOxrBbGyJM/aVQ+pjj5HCgasFxc0K/KhoATfQ/47AyUl15I2yBUpihjmas+a+VJBOqecrFH+uA==}
+
+ '@types/istanbul-reports@3.0.4':
+ resolution: {integrity: sha512-pk2B1NWalF9toCRu6gjBzR69syFjP4Od8WRAX+0mmf9lAjCRicLOWc+ZrxZHx/0XRjotgkF9t6iaMJ+aXcOdZQ==}
+
+ '@types/jsesc@2.5.1':
+ resolution: {integrity: sha512-9VN+6yxLOPLOav+7PwjZbxiID2bVaeq0ED4qSQmdQTdjnXJSaCVKTR58t15oqH1H5t8Ng2ZX1SabJVoN9Q34bw==}
+
+ '@types/json-schema@7.0.15':
+ resolution: {integrity: sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==}
+
+ '@types/katex@0.16.8':
+ resolution: {integrity: sha512-trgaNyfU+Xh2Tc+ABIb44a5AYUpicB3uwirOioeOkNPPbmgRNtcWyDeeFRzjPZENO9Vq8gvVqfhaaXWLlevVwg==}
+
+ '@types/mdast@4.0.4':
+ resolution: {integrity: sha512-kGaNbPh1k7AFzgpud/gMdvIm5xuECykRR+JnWKQno9TAXVa6WIVCGTPvYGekIDL4uwCZQSYbUxNBSb1aUo79oA==}
+
+ '@types/ms@2.1.0':
+ resolution: {integrity: sha512-GsCCIZDE/p3i96vtEqx+7dBUGXrc7zeSK3wwPHIaRThS+9OhWIXRqzs4d6k1SVU8g91DrNRWxWUGhp5KXQb2VA==}
+
+ '@types/node@24.12.4':
+ resolution: {integrity: sha512-GUUEShf+PBCGW2KaXwcIt3Yk+e3pkKwWKb9GSyM9WQVE+ep2jzmHdGsHzu4wgcZy5fN9FBdVzjpBQsYlpfpgLA==}
+
+ '@types/normalize-package-data@2.4.4':
+ resolution: {integrity: sha512-37i+OaWTh9qeK4LSHPsyRC7NahnGotNuZvjLSgcPzblpHB3rrCJxAOgI5gCdKm7coonsaX1Of0ILiTcnZjbfxA==}
+
+ '@types/picomatch@4.0.3':
+ resolution: {integrity: sha512-iG0T6+nYJ9FAPmx9SsUlnwcq1ZVRuCXcVEvWnntoPlrOpwtSTKNDC9uVAxTsC3PUvJ+99n4RpAcNgBbHX3JSnQ==}
+
+ '@types/pug@2.0.10':
+ resolution: {integrity: sha512-Sk/uYFOBAB7mb74XcpizmH0KOR2Pv3D2Hmrh1Dmy5BmK3MpdSa5kqZcg6EKBdklU0bFXX9gCfzvpnyUehrPIuA==}
+
+ '@types/relateurl@0.2.33':
+ resolution: {integrity: sha512-bTQCKsVbIdzLqZhLkF5fcJQreE4y1ro4DIyVrlDNSCJRRwHhB8Z+4zXXa8jN6eDvc2HbRsEYgbvrnGvi54EpSw==}
+
+ '@types/resolve@1.20.2':
+ resolution: {integrity: sha512-60BCwRFOZCQhDncwQdxxeOEEkbc5dIMccYLwbxsS4TUNeVECQ/pBJ0j09mrHOl/JJvpRPGwO9SvE4nR2Nb/a4Q==}
+
+ '@types/semver@7.7.1':
+ resolution: {integrity: sha512-FmgJfu+MOcQ370SD0ev7EI8TlCAfKYU+B4m5T3yXc1CiRN94g/SZPtsCkk506aUDtlMnFZvasDwHHUcZUEaYuA==}
+
+ '@types/unist@2.0.11':
+ resolution: {integrity: sha512-CmBKiL6NNo/OqgmMn95Fk9Whlp2mtvIv+KNpQKN2F4SjvrEesubTRWGYSg+BnWZOnlCaSTU1sMpsBOzgbYhnsA==}
+
+ '@types/unist@3.0.3':
+ resolution: {integrity: sha512-ko/gIFJRv177XgZsZcBwnqJN5x/Gien8qNOn0D5bQU/zAzVf9Zt3BlcUiLqhV9y4ARk0GbT3tnUiPNgnTXzc/Q==}
+
+ '@types/web-bluetooth@0.0.21':
+ resolution: {integrity: sha512-oIQLCGWtcFZy2JW77j9k8nHzAOpqMHLQejDA48XXMWH6tjCQHz5RCFz1bzsmROyL6PUm+LLnUiI4BCn221inxA==}
+
+ '@types/webpack-bundle-analyzer@4.7.0':
+ resolution: {integrity: sha512-c5i2ThslSNSG8W891BRvOd/RoCjI2zwph8maD22b1adtSns20j+0azDDMCK06DiVrzTgnwiDl5Ntmu1YRJw8Sg==}
+
+ '@types/webpack-hot-middleware@2.25.12':
+ resolution: {integrity: sha512-3CHRpHNHrdXcXqIyL51UmnoqhxNIZSMpJT4Y2EezZa9DCst7+a03Y1iWUtwYb0oYiZJJkCwhGnW2bwgmaEwsAg==}
+
+ '@types/whatwg-mimetype@3.0.2':
+ resolution: {integrity: sha512-c2AKvDT8ToxLIOUlN51gTiHXflsfIFisS4pO7pDPoKouJCESkhZnEy623gwP9laCy5lnLDAw1vAzu2vM2YLOrA==}
+
+ '@types/ws@8.18.1':
+ resolution: {integrity: sha512-ThVF6DCVhA8kUGy+aazFQ4kXQ7E1Ty7A3ypFOe0IcJV8O/M511G99AW24irKrW56Wt44yG9+ij8FaqoBGkuBXg==}
+
+ '@types/yargs-parser@21.0.3':
+ resolution: {integrity: sha512-I4q9QU9MQv4oEOz4tAHJtNz1cwuLxn2F3xcc2iV5WdqLPpUnj30aUuxt1mAxYTG+oe8CZMV/+6rU4S4gRDzqtQ==}
+
+ '@types/yargs@17.0.35':
+ resolution: {integrity: sha512-qUHkeCyQFxMXg79wQfTtfndEC+N9ZZg76HJftDJp+qH2tV7Gj4OJi7l+PiWwJ+pWtW8GwSmqsDj/oymhrTWXjg==}
+
+ '@typescript-eslint/eslint-plugin@8.59.4':
+ resolution: {integrity: sha512-PegsU+XfyJJNjd4+u/k6f9yTyp0lEXXiPopUNobZcIAUJFGICFLN+sP0Rb3JehVmiij1Ph0dFGYqODoRo/2+6A==}
+ engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+ peerDependencies:
+ '@typescript-eslint/parser': ^8.59.4
+ eslint: ^8.57.0 || ^9.0.0 || ^10.0.0
+ typescript: '>=4.8.4 <6.1.0'
+
+ '@typescript-eslint/parser@8.59.3':
+ resolution: {integrity: sha512-HPwA+hVkfcriajbNvTmZv4VRauibay+cWArYUYq7u7W7PmGShMxbPxLvrwDme55a6d5alG3nrYfhyJ/G28XlLg==}
+ engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+ peerDependencies:
+ eslint: ^8.57.0 || ^9.0.0 || ^10.0.0
+ typescript: '>=4.8.4 <6.1.0'
+
+ '@typescript-eslint/project-service@8.59.3':
+ resolution: {integrity: sha512-ECiUWa/KYRGDFUqTNehaRgzDshnJfkTABJxVemHk4ko22gcr0ukloKjWvyQ64g8YCV/UI47kN1dbmjf/GaQYng==}
+ engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+ peerDependencies:
+ typescript: '>=4.8.4 <6.1.0'
+
+ '@typescript-eslint/project-service@8.59.4':
+ resolution: {integrity: sha512-Ly00Vu4oAacfDeHp2Zg85ioNG6l8HG+tN1D7J+xTHSxu9y0awYKJ2zH1rFBn8ZSfuGK+7FxK3Cgl3uAz0aZZLg==}
+ engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+ peerDependencies:
+ typescript: '>=4.8.4 <6.1.0'
+
+ '@typescript-eslint/scope-manager@8.59.3':
+ resolution: {integrity: sha512-t2LvZnoEfzKtnPjgeEu41xw5gxq9mQVfYy4OoZ4Vlt0sk3JwxmhCca/AR7DwOiHrjWgjAj6as4AhRLKSDfvZIA==}
+ engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+
+ '@typescript-eslint/scope-manager@8.59.4':
+ resolution: {integrity: sha512-mUeR/3H1WrTAddJrwut8OoPjfauaztMQmRwV5fQTUyNVJCLiUXXe4lGEyYIL2oFDpP7UtgbGJXCt72wT0z2S3Q==}
+ engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+
+ '@typescript-eslint/tsconfig-utils@8.59.3':
+ resolution: {integrity: sha512-PcIJHjmaREXLgIAIzLnSY9VucEzz8FKXsRgFa1DmdGCK/5tJpW03TKJF01Q6VZd1lLdz2sIKPWaDUZN9dp//dw==}
+ engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+ peerDependencies:
+ typescript: '>=4.8.4 <6.1.0'
+
+ '@typescript-eslint/tsconfig-utils@8.59.4':
+ resolution: {integrity: sha512-DLCpnKgD4alVxTBSKulK+gU1KCqOgUXfDRDXh2mZgzokQKa/70ax93I2uVO3m/LLvIAtWZIFoiifudmIqAxpMA==}
+ engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+ peerDependencies:
+ typescript: '>=4.8.4 <6.1.0'
+
+ '@typescript-eslint/type-utils@8.59.4':
+ resolution: {integrity: sha512-uonTuPAAKr9XaBGqJ3LjYTh72zy5DyGesljO9gtmk/eFW0W1fRHjnwVYKB35Lm8d5Q5CluEW3gPHjTvZTmgrfA==}
+ engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+ peerDependencies:
+ eslint: ^8.57.0 || ^9.0.0 || ^10.0.0
+ typescript: '>=4.8.4 <6.1.0'
+
+ '@typescript-eslint/types@8.59.3':
+ resolution: {integrity: sha512-ePFoH0g4ludssdRFqqDxQePCxU4WQyRa9+XVwjm7yLn0FKhMeoetC+qBEEI1Eyb1pGSDveTIT09Bvw2WhlGayg==}
+ engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+
+ '@typescript-eslint/types@8.59.4':
+ resolution: {integrity: sha512-F1o7WJcCq+bc8dwcO/YsSEOudAH8RDtaOhM6wcAQhcUsFhnWQl81JKy48q1hoxAU0qrzM89+31GYh1515Zde3Q==}
+ engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+
+ '@typescript-eslint/typescript-estree@8.59.3':
+ resolution: {integrity: sha512-CbRjVRAf7Lr9Kr8RopKcbY45p2VfmmHrm0ygOCYFi7oU8q19m0Fs/6iHS7kNOmwpp+ob07ZVcAqlxUod9lYdmg==}
+ engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+ peerDependencies:
+ typescript: '>=4.8.4 <6.1.0'
+
+ '@typescript-eslint/typescript-estree@8.59.4':
+ resolution: {integrity: sha512-F+RuOmcDXo4+TPdfd/TCLS3m2nw8gE9XXyZLrA3JBfaA5tz9TtdkyD3YJFmPxulyc2cKbEok/CvFE3MgSLWnag==}
+ engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+ peerDependencies:
+ typescript: '>=4.8.4 <6.1.0'
+
+ '@typescript-eslint/utils@8.59.4':
+ resolution: {integrity: sha512-cYXeNAUsG4lJo5dbc1FcKm+JwIWrj1/UpTORsC6tGMjEZ81DYcvIr9/ueikhMa/Y/gDQYGp+YX9/xQrXje5BJw==}
+ engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+ peerDependencies:
+ eslint: ^8.57.0 || ^9.0.0 || ^10.0.0
+ typescript: '>=4.8.4 <6.1.0'
+
+ '@typescript-eslint/visitor-keys@8.59.3':
+ resolution: {integrity: sha512-f1UQF7ggd42YiwI5wGrRaPsa+P0CINBlrkLPmGfpq/u/I/oVtecoEIfFR9ag/oa1sLOsRNZ6xehf6qMZhQGBDg==}
+ engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+
+ '@typescript-eslint/visitor-keys@8.59.4':
+ resolution: {integrity: sha512-U3gxVaDVnuZKhSspW/MzMxE1kq7zOdc072FcSNoqA1I9p8HyKbBFfEHoWckBAMgNMph4MamwS5iTVzFmrnt8TQ==}
+ engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+
+ '@typescript/vfs@1.6.4':
+ resolution: {integrity: sha512-PJFXFS4ZJKiJ9Qiuix6Dz/OwEIqHD7Dme1UwZhTK11vR+5dqW2ACbdndWQexBzCx+CPuMe5WBYQWCsFyGlQLlQ==}
+ peerDependencies:
+ typescript: '*'
+
+ '@ungap/structured-clone@1.3.1':
+ resolution: {integrity: sha512-mUFwbeTqrVgDQxFveS+df2yfap6iuP20NAKAsBt5jDEoOTDew+zwLAOilHCeQJOVSvmgCX4ogqIrA0mnyr08yQ==}
+
+ '@unhead/bundler@3.1.0':
+ resolution: {integrity: sha512-PzIa26mo1fk2t3KJ6ACJXTi1MD1nDJXb4hl/P8+UTMmdK0EWyDo3LMttePsIgKKR5PTnrtSeyhd43Pdoym4z2g==}
+ peerDependencies:
+ '@unhead/cli': ^3.1.0
+ esbuild: '>=0.17.0'
+ lightningcss: '>=1.20.0'
+ rolldown: '>=1.0.0-beta.0'
+ unhead: ^3.1.0
+ vite: 8.0.12
+ webpack: '>=5.0.0'
+ peerDependenciesMeta:
+ '@unhead/cli':
+ optional: true
+ esbuild:
+ optional: true
+ lightningcss:
+ optional: true
+ rolldown:
+ optional: true
+ vite:
+ optional: true
+ webpack:
+ optional: true
+
+ '@unhead/vue@3.1.0':
+ resolution: {integrity: sha512-ib0YCfaoD0lL40Dg1FEQJksZhZ5Q+LMESXUxyfMrtlSUb43+Ha7btUIPyQuAfkjhlTihE1x5i9QdswEdhe0LWg==}
+ peerDependencies:
+ vite: 8.0.12
+ vue: 3.5.34
+ webpack: '>=5.0.0'
+ peerDependenciesMeta:
+ vite:
+ optional: true
+ webpack:
+ optional: true
+
+ '@unocss/cli@66.6.8':
+ resolution: {integrity: sha512-dJ4AmrhCtQwEDJtpFG7AgJ4Qi4GWnNgWWlLWq4DhKBOCcvldr9k98mscdhs3MOwph25DIxU5MdLRAg/OS1JryQ==}
+ engines: {node: '>=14'}
+ hasBin: true
+
+ '@unocss/config@66.6.8':
+ resolution: {integrity: sha512-f+a8OyhD7ZoK8Pa1b3Cbx1RQc3n5x+Qht/cHg3wh/g4DNQIjBI2EqwSLfBigWhdO96zIqFAdyTlO3onmrJwUOw==}
+ engines: {node: '>=14'}
+
+ '@unocss/core@66.6.8':
+ resolution: {integrity: sha512-P9IlQfgms+8/nka7fBhiiWU4SPwrTNKbTdK0z1SLnttXMHHjsB2zpG+Vi1JQDpICfY9Y1/2pWtguPE+zeOVu9Q==}
+
+ '@unocss/extractor-arbitrary-variants@66.6.8':
+ resolution: {integrity: sha512-cOXstpPTOLt/HYcL0OsqFkNau0e8ktZ5Q8fgnXBZjmLGmi+VzdESNlwxZyCXLuamZGnbrZ8lDsKdsGG7P1pMKQ==}
+
+ '@unocss/inspector@66.6.8':
+ resolution: {integrity: sha512-g8uRzXDdmoNRjXX/mZP7m0rWXLtOimyOW7+VFK6FNxRWBmvIGYgTLHkutF6Wyh9lLPDYx3pkkEmfgL35BDT3Sg==}
+
+ '@unocss/preset-attributify@66.6.8':
+ resolution: {integrity: sha512-YxyRSF5rq0WbY8kCG0gpj3DSXPL89QGxZeqABmceCzPJbXJBBHEJz/pgBPmzSa2Ziulgs0AEkHzWFPfpb2uGTA==}
+
+ '@unocss/preset-icons@66.6.8':
+ resolution: {integrity: sha512-+zD5TNGZIXvVOMcvDIYaTXinffpDMERGj6Ch8WTtJluA6qHHBvRuFexoU2bY8nF1r0HZkYzNT9C+RujFSP+6TA==}
+
+ '@unocss/preset-mini@66.6.8':
+ resolution: {integrity: sha512-vAechrReO7LtWzFAeF54P7CintG2m65SlVlBsi1x2Ru7IdgUNJEHII0MfXUvf9r1x8vsIlhATyaqqtBVT6ps/w==}
+
+ '@unocss/preset-tagify@66.6.8':
+ resolution: {integrity: sha512-cG6zBYswtWTpeQe/Lb1Bh+IzU4Ck+VI8rpYvrnvSGl22rJjAsXd+buB1P0PjyDpoe924rq0bLTayZ8r6Ayyyvw==}
+
+ '@unocss/preset-typography@66.6.8':
+ resolution: {integrity: sha512-wOApJpE0QfeOTWN5RuQts8zS6PXhTZIfjpt6cBj8dmv7+GlIQlwopxL7wcDb2wVwdCByuMvUbWl7nC3kz/iFTA==}
+
+ '@unocss/preset-uno@66.6.8':
+ resolution: {integrity: sha512-z01Rw/rBuahRulwQRnobUFnGqyU+UenOLz72KGn4p0Yh8gBC44fPlNHsOWA0TNediHRJg33HptX4kx16HCVWDg==}
+
+ '@unocss/preset-web-fonts@66.6.8':
+ resolution: {integrity: sha512-AgEHO8h0AkeOT57AOE9PS7dJOa5Rfr0gIyz/FxA7vJ/FwgQL70uX+bRW8kmoH81zcjo5xBP2IX3Z6A8VAOo3Vw==}
+
+ '@unocss/preset-wind3@66.6.8':
+ resolution: {integrity: sha512-WNTeDAYCatmEFjBJ4itUmz0TElBvNFqjh5i2/ianDJO/vkd+IYUb03jEPLUppVlvMhy8bN8AunP0AtW3Xf2psA==}
+
+ '@unocss/preset-wind4@66.6.8':
+ resolution: {integrity: sha512-CheOm7KXOsTI5t4RXgeYz95CO5p589F6jsyYp+inOCk4N0/d+DWiDHrQ+V0x0HWs3JXWlD+/Va/yXjlc3o2sIw==}
+
+ '@unocss/preset-wind@66.6.8':
+ resolution: {integrity: sha512-F0mdmwK/HelYOgBRMHl+Yx/VyARCQJtPlcgPBejI3E9ZWOZlKS7hvPqPrgvS63WTGMHgM3/22cGuYYFjpi/ugA==}
+
+ '@unocss/reset@66.6.8':
+ resolution: {integrity: sha512-H+YP3ltizUiPO9FzFgFhv8WGsefO7fTgT1If1/9ritPDqZlvzTqMmjelhcq8D8MGoQ1RQBUvtkZ5HJoKVY0Tgw==}
+
+ '@unocss/rule-utils@66.6.8':
+ resolution: {integrity: sha512-WR35L07mLP6PElD4hlUHo5KbQ48uz2HT/XCuJyAsHP+15Gv6539hPWA5SresPuva9r8rl+PeGIgMSIKf4A5Ihw==}
+ engines: {node: '>=14'}
+
+ '@unocss/transformer-attributify-jsx@66.6.8':
+ resolution: {integrity: sha512-g+7lvm+8V1MnJ21ialTxFBonCTtenn/KcZQbm0JfvQjgG+KuuSnt3BGEcXAHQZu3eBDGuJuasTHiXWwzCYIRBQ==}
+
+ '@unocss/transformer-compile-class@66.6.8':
+ resolution: {integrity: sha512-37dFuzgYo8ki033KmuvyZXugQRVH1c3+/z5kcWLPhcMR8UJscAtjgRx80S1UvWup2q6TPxPpmy/rMbqWvs3jfg==}
+
+ '@unocss/transformer-directives@66.6.8':
+ resolution: {integrity: sha512-9hC3mQ8eycliW/igI9le0LovTIMBKoL6crucTkr4MmWuNqICMvNxTmGj5Xh64olBPnascevFwam6xsy+J1lX4Q==}
+
+ '@unocss/transformer-variant-group@66.6.8':
+ resolution: {integrity: sha512-+t7gJDW3W3z3/f8zBf0DfV2UZyGyFOwG5CIsIj5ofu3VJ91mKD/5ZAH8fD3cryXCBSqslj4yv+8R+BLV07T5AA==}
+
+ '@unocss/vite@66.6.8':
+ resolution: {integrity: sha512-bXfEnEHdW7zTGLIYU16MsfKSFy3Q47Pevhrt5f9fOGzC4UI1JGkkoQSfoFpXZGliDrhoSFK4Msz9Jt43Ta4j+w==}
+ peerDependencies:
+ vite: 8.0.12
+
+ '@unrs/resolver-binding-android-arm-eabi@1.12.2':
+ resolution: {integrity: sha512-g5T90pqg1bo/7mytQx6F4iBNC0Wsh9cu+z9veDbFjc7HjpesJFWD7QMS0NGStXM075+7dJPPVvBbpZlnrdpi/w==}
+ cpu: [arm]
+ os: [android]
+
+ '@unrs/resolver-binding-android-arm64@1.12.2':
+ resolution: {integrity: sha512-YGCRZv/9GLhwmz6mYDeTsm/92BAyR28l6c2ReweVW5pWgfsitWLY8upvfRlGdoyD8HjeTHSYJWyZGD4KJA/nFQ==}
+ cpu: [arm64]
+ os: [android]
+
+ '@unrs/resolver-binding-darwin-arm64@1.12.2':
+ resolution: {integrity: sha512-u9DiNT1auQMO20A9SyTuG3wUgQWB9Z7KjAg0uFuCDR1FsAY8A0CG2S6JpHS1xwm/w1G08bjXZDcyOCjv1WAm2w==}
+ cpu: [arm64]
+ os: [darwin]
+
+ '@unrs/resolver-binding-darwin-x64@1.12.2':
+ resolution: {integrity: sha512-f7rPLi/T1HVKZu/u6t87lroib16n8vrSzcyxI7lg4BGO9UF26KhQL44sd9eOUgrTYhvRXtWOIZT5PejdPyJfUA==}
+ cpu: [x64]
+ os: [darwin]
+
+ '@unrs/resolver-binding-freebsd-x64@1.12.2':
+ resolution: {integrity: sha512-BpcOjWCJub6nRZUS2zA20pmLvjtqAtGejETaIyRLiZiQf++cbrjltLA5NN/xaXfqeOBOSlMFbemIl5/S5tljmg==}
+ cpu: [x64]
+ os: [freebsd]
+
+ '@unrs/resolver-binding-linux-arm-gnueabihf@1.12.2':
+ resolution: {integrity: sha512-vZTDvdSISZjJx66OzJqtsOhzifbqRjbmI1Mnu49fQDwog5GtDI4QidRiEAYbZCRj9C8YZEW+3ZjqsyS9GR4k2A==}
+ cpu: [arm]
+ os: [linux]
+
+ '@unrs/resolver-binding-linux-arm-musleabihf@1.12.2':
+ resolution: {integrity: sha512-BiPI+IrIlwcW4nLLMM21+B1dFPzd55yAVgVGrdgDjNef+ch03GdxrcyaIz8X9SsQirh/kCQ7mviyWlMxdh2D7g==}
+ cpu: [arm]
+ os: [linux]
+
+ '@unrs/resolver-binding-linux-arm64-gnu@1.12.2':
+ resolution: {integrity: sha512-zJc0H99FEPoFfSrNpa91HYfxzfAJCr502oxNK1cfdC9hlaFI43RT+JFCann9JUgZmLzzntChHyn13Sgn9ljHNg==}
+ cpu: [arm64]
+ os: [linux]
+ libc: [glibc]
+
+ '@unrs/resolver-binding-linux-arm64-musl@1.12.2':
+ resolution: {integrity: sha512-KQ3Lki6l+Pz1k/eBipN41ES+YUK30beLGb9YqcB1O542cyLCNE6GaxrfcY3T6EezmGGk84wb5XyO9loTM9tkcA==}
+ cpu: [arm64]
+ os: [linux]
+ libc: [musl]
+
+ '@unrs/resolver-binding-linux-loong64-gnu@1.12.2':
+ resolution: {integrity: sha512-3SJGEh1DborhG6pyxvhPzCT4bbSIVihsvgJc13P1bHG7KLdNDaF9T3gsTwFc7Jw/5Y5/iWOjkEx7Zy0NvCGX3Q==}
+ cpu: [loong64]
+ os: [linux]
+ libc: [glibc]
+
+ '@unrs/resolver-binding-linux-loong64-musl@1.12.2':
+ resolution: {integrity: sha512-jiuG/Obbel7uw1PwHNFfrkiKhLAF6mnyZ6aWlOAVN9WqKm8v0OFGnciJIHu8+CMvXLQ8AD51LPzAoUfT21D5Ew==}
+ cpu: [loong64]
+ os: [linux]
+ libc: [musl]
+
+ '@unrs/resolver-binding-linux-ppc64-gnu@1.12.2':
+ resolution: {integrity: sha512-q7xRvVpmcfeL+LlZg8Pbbo6QaTZwDU5BaGZbwfhkEsXJn3Was8xYfE0RBH266xZt0rM6B7i8xAYIvjthuUIWHg==}
+ cpu: [ppc64]
+ os: [linux]
+ libc: [glibc]
+
+ '@unrs/resolver-binding-linux-riscv64-gnu@1.12.2':
+ resolution: {integrity: sha512-0CVdx6lcnT3Q9inOH8tsMIOJ6ImndllMjqJHg8RLVdB7Vq4SfkEXl9mCSsVNuNA4MCYycRicCUxPCabVHJRr6A==}
+ cpu: [riscv64]
+ os: [linux]
+ libc: [glibc]
+
+ '@unrs/resolver-binding-linux-riscv64-musl@1.12.2':
+ resolution: {integrity: sha512-iOwlRo9vnp6R6ohHQS11n0NnfdXx/omhkocmIfaPRpQhKZ+3BDMkkdRVh53qjkFkpPddf+FETA28NwGN7l5l+w==}
+ cpu: [riscv64]
+ os: [linux]
+ libc: [musl]
+
+ '@unrs/resolver-binding-linux-s390x-gnu@1.12.2':
+ resolution: {integrity: sha512-HYJtLfXq94q8iZNFT1lknx258wlkkWhZeUXJRqzKBBUJ00CvZ+N33zgbCqimLjsyw5Va6uUxhVa12mI+kaveEw==}
+ cpu: [s390x]
+ os: [linux]
+ libc: [glibc]
+
+ '@unrs/resolver-binding-linux-x64-gnu@1.12.2':
+ resolution: {integrity: sha512-mPsUhunKKDih5O96Y6enDQyHc1SqBPlY1E/SfMWDM3EdJ95Z9CArPeCVwCCqbP45ljvivdEk8Fxn+SIb1rDAJQ==}
+ cpu: [x64]
+ os: [linux]
+ libc: [glibc]
+
+ '@unrs/resolver-binding-linux-x64-musl@1.12.2':
+ resolution: {integrity: sha512-azrt6+5ydLd8Vt210AAFis/lZevSfPw93EJRIJG+xPu4WCJ8K0kppCTpMyLPcKT7H15M4Jnt2tMp5bOvCkRC6A==}
+ cpu: [x64]
+ os: [linux]
+ libc: [musl]
+
+ '@unrs/resolver-binding-openharmony-arm64@1.12.2':
+ resolution: {integrity: sha512-YZ9hP4O0X9PQb8eO980qmLNGH4zT3I9+SZTdt0Pr0YyuGQhYKoOZkV02VzrzyOZJ5xIJ3UFIenKkUkGg8GjgWQ==}
+ cpu: [arm64]
+ os: [openharmony]
+
+ '@unrs/resolver-binding-wasm32-wasi@1.12.2':
+ resolution: {integrity: sha512-tYFDIkMxSflfEc/h92ZWNsZlHSwgimbNHSO3PL2JWQHfCuC2q316jMyYU9TIWZsFK2bQwyK5VAdYgn8ygPj69A==}
+ engines: {node: '>=14.0.0'}
+ cpu: [wasm32]
+
+ '@unrs/resolver-binding-win32-arm64-msvc@1.12.2':
+ resolution: {integrity: sha512-qzNyg3xL0VPQmCaUh+N5jSitce6k+uCBfMDesWRnlULOZaqUkaJ0ybdT+UqlAWJoQjuqfIU/0Ptx9bteN4D82g==}
+ cpu: [arm64]
+ os: [win32]
+
+ '@unrs/resolver-binding-win32-ia32-msvc@1.12.2':
+ resolution: {integrity: sha512-WD9sY00OfpHVGfsnHZoA8jVT+esS/Bg8z8jzxp5BnDCjjwsuKsPQrzswwpFy4J1AUJbXPRfkpcX0mXrzeXW79g==}
+ cpu: [ia32]
+ os: [win32]
+
+ '@unrs/resolver-binding-win32-x64-msvc@1.12.2':
+ resolution: {integrity: sha512-nAB74NfSNKknqQ1RrYj6uz8FcXEomu/MATJZxh/x+BArzN2U3JbOYC0APYzUIGhVY3m5hRxA8VPNdPBoG8txlA==}
+ cpu: [x64]
+ os: [win32]
+
+ '@valibot/to-json-schema@1.7.0':
+ resolution: {integrity: sha512-Y3pPVibbIOHzohrlxSINvO7w/bvXkoYS3BQHoImV9ynE+bXKf171bdMucPurV2zp7gdmt0L1HCcNAsbo7cFRQw==}
+ peerDependencies:
+ valibot: ^1.4.0
+
+ '@vercel/nft@1.5.0':
+ resolution: {integrity: sha512-IWTDeIoWhQ7ZtRO/JRKH+jhmeQvZYhtGPmzw/QGDY+wDCQqfm25P9yIdoAFagu4fWsK4IwZXDFIjrmp5rRm/sA==}
+ engines: {node: '>=20'}
+ hasBin: true
+
+ '@vitejs/devtools-kit@0.1.24':
+ resolution: {integrity: sha512-sHM4i80Rrx4HTv/c2d28pQpeMz99GQe/2lVvJvna9t/YcoVouqpsms8oKiF/NcX8474A5gx3TtJHXWvqbov1dg==}
+ peerDependencies:
+ vite: 8.0.12
+
+ '@vitejs/devtools-rolldown@0.1.24':
+ resolution: {integrity: sha512-KN3Bd7O0/xAq9KKjH9R1hrbw5GK3eKq563IExw8jf/FjiTllppR/iNUnlg6JHBLG3wVBFrhxL6bHjgQUAaBDBQ==}
+
+ '@vitejs/devtools@0.1.24':
+ resolution: {integrity: sha512-XPsNo8fTXtshuQrK5ddnlZzE9wtGJWs1Xfu9g1bMKZoM/XI+ool1zPSM1k8RHE09LPiUf/5E29KykResyyKx/w==}
+ hasBin: true
+ peerDependencies:
+ vite: 8.0.12
+
+ '@vitejs/plugin-vue-jsx@5.1.5':
+ resolution: {integrity: sha512-jIAsvHOEtWpslLOI2MeElGFxH7M8pM83BU/Tor4RLyiwH0FM4nUW3xdvbw20EeU9wc5IspQwMq225K3CMnJEpA==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ peerDependencies:
+ vite: 8.0.12
+ vue: 3.5.34
+
+ '@vitejs/plugin-vue@6.0.7':
+ resolution: {integrity: sha512-km+p+XdSz9Sxm5rqUbqcSfZYaAniKxWBj1KURl+Jr7UaPvvX7BmaWMdP69I5rrFDeQGyxAG7NXdc57vz+snhWg==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ peerDependencies:
+ vite: 8.0.12
+ vue: 3.5.34
+
+ '@vitest/coverage-v8@4.1.7':
+ resolution: {integrity: sha512-qsYPeXc5Q9dFLd1i8Ap+Bx8sQgcp+rFVQo4R0dDsWNBzl26ldVF1qOO+RL24K7FDrR6pA+50XedRLSoSG24bVQ==}
+ peerDependencies:
+ '@vitest/browser': 4.1.7
+ vitest: 4.1.7
+ peerDependenciesMeta:
+ '@vitest/browser':
+ optional: true
+
+ '@vitest/expect@4.1.6':
+ resolution: {integrity: sha512-7EHDquPthALSV0jhhjgEW8FXaviMx7rSqu8W6oqCoAuOhKov814P99QDV1pxMA3QPv21YudvJngIhjrNI4opLg==}
+
+ '@vitest/expect@4.1.7':
+ resolution: {integrity: sha512-1R+tw0ortHEbZDGMymm+pN7/AFQ/RkFFdtd7EN+VBpynKmLbP8A3rpEXdshBJ7+8hQ9zBJh/i1s0yKNtxAnU7w==}
+
+ '@vitest/mocker@4.1.6':
+ resolution: {integrity: sha512-MCFc63czMjEInOlcY2cpQCvCN+KgbAn+60xu9cMgP4sKaLC5JNAKw7JH8QdAnoAC88hW1IiSNZ+GgVXlN1UcMQ==}
+ peerDependencies:
+ msw: ^2.4.9
+ vite: 8.0.12
+ peerDependenciesMeta:
+ msw:
+ optional: true
+ vite:
+ optional: true
+
+ '@vitest/mocker@4.1.7':
+ resolution: {integrity: sha512-vY7nuamKgfvpA1Koa3oYIw/k7D6kZnpGyNMZW8loow2bsBYla1TFdqTaXncWdRn4pgwNs+90RhnXhJScDwQeJA==}
+ peerDependencies:
+ msw: ^2.4.9
+ vite: 8.0.12
+ peerDependenciesMeta:
+ msw:
+ optional: true
+ vite:
+ optional: true
+
+ '@vitest/pretty-format@4.1.6':
+ resolution: {integrity: sha512-h5SxD/IzNhZYnrSZRsUZQIC+vD0GY8cUvq0iwsmkFKixRCKLLWqCXa/FIQ4S1R+sI+PGoojkHsdNrbZiM9Qpgw==}
+
+ '@vitest/pretty-format@4.1.7':
+ resolution: {integrity: sha512-umgCarTOYQWIaDMvGDRZij+6b9oVeLIyJzfN+AS88e0ZOU3QTgNNSTtjQOpcvWr3np1N0j4WgZj+sb3oYBDscw==}
+
+ '@vitest/runner@4.1.6':
+ resolution: {integrity: sha512-nOPCmn2+yD0ZNmKdsXGv/UxMMWbMuKeD6GyYncNwdkYDxpQvrPSKYj2rWuDjC2Y4b6w6hjip5dBKFzEUuZe3vA==}
+
+ '@vitest/runner@4.1.7':
+ resolution: {integrity: sha512-BapjmAQ2aI78WdMEfeUWivnfVzB+VPGwWRQcJE0OUq7qEeEcBsCSf+0T5iREBNE5nBb4wA5Ya0W6IA+sghdEFw==}
+
+ '@vitest/snapshot@4.1.6':
+ resolution: {integrity: sha512-YhsdE6xAVfTDmzjxL2ZDUvjj+ZsgyOKe+TdQzqkD72wIOmHka8NuGQ6NpTNZv9D2Z63fbwWKJPeVpEw4EQgYxw==}
+
+ '@vitest/snapshot@4.1.7':
+ resolution: {integrity: sha512-ZacLzja+TmJeZ1h14xW2FB/WpeimUD3haBXQPyJqxvo8jQTmfeA8zv58mtjN2C7EHXZDYVcVYdYmAxjkWVvKCw==}
+
+ '@vitest/spy@4.1.6':
+ resolution: {integrity: sha512-JFKxMx6udhwKh/Ldo270e17QX710vgunMkuPAvXjHSvC6oqLWAHhVhjg/I71q0u0CBSErIODV1Kjv0FQNSWjdg==}
+
+ '@vitest/spy@4.1.7':
+ resolution: {integrity: sha512-kbkI5LMWakyuTIvs6fUJ5qdIVb1XVKsYJAT4OJ938cHMROYMSfmoQdZy0aaAnjbbc8F61vkoTqz/Az+/HiIu5Q==}
+
+ '@vitest/utils@4.1.6':
+ resolution: {integrity: sha512-FxIY+U81R3LGKCxaHHFRQ5+g6/iRgGLmeHWdp2Amj4ljQRrEIWHmZyDfDYBRZlpyqA7qKxtS9DD1dhk8RnRIVQ==}
+
+ '@vitest/utils@4.1.7':
+ resolution: {integrity: sha512-T532WBu791cBxJlCl6SO+J14l81DQx6uQHm1bQbmCDY7nqlEIgkza/UFnSBNaUtSf41unldDFjdOBYEQC4b5Hw==}
+
+ '@volar/language-core@2.4.28':
+ resolution: {integrity: sha512-w4qhIJ8ZSitgLAkVay6AbcnC7gP3glYM3fYwKV3srj8m494E3xtrCv6E+bWviiK/8hs6e6t1ij1s2Endql7vzQ==}
+
+ '@volar/source-map@2.4.28':
+ resolution: {integrity: sha512-yX2BDBqJkRXfKw8my8VarTyjv48QwxdJtvRgUpNE5erCsgEUdI2DsLbpa+rOQVAJYshY99szEcRDmyHbF10ggQ==}
+
+ '@volar/typescript@2.4.28':
+ resolution: {integrity: sha512-Ja6yvWrbis2QtN4ClAKreeUZPVYMARDYZl9LMEv1iQ1QdepB6wn0jTRxA9MftYmYa4DQ4k/DaSZpFPUfxl8giw==}
+
+ '@voxpelli/semver-set@6.0.2':
+ resolution: {integrity: sha512-bkmaFfnA95aRxDpj6Q+hOwm+JS2t8avwwgPmtJA2OuEWivRE/qkImZ07MoWLl6W59XKmtmrv4GrBylacTNmwaw==}
+ engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+
+ '@voxpelli/type-helpers@3.5.0':
+ resolution: {integrity: sha512-dDfyGwMLmbdYZ7t+IgUJdN2esdTg/CXbRB9HEVslTyqrV4rM4daJBjafqqAdHMmWTi0qMA1Ea5ag2QWht0XblQ==}
+ engines: {node: '>=18.0.0'}
+
+ '@voxpelli/typed-utils@1.10.2':
+ resolution: {integrity: sha512-icXQSR6SeGL6kr9koJw9zkDZqWyFXgpJG8kTaDydjZhy9/V0MQB9tYyibvRgJHlk98SDJJhPLCouTdqOdn+riw==}
+ engines: {node: '>=18.0.0'}
+
+ '@vue-macros/common@3.1.2':
+ resolution: {integrity: sha512-h9t4ArDdniO9ekYHAD95t9AZcAbb19lEGK+26iAjUODOIJKmObDNBSe4+6ELQAA3vtYiFPPBtHh7+cQCKi3Dng==}
+ engines: {node: '>=20.19.0'}
+ peerDependencies:
+ vue: 3.5.34
+ peerDependenciesMeta:
+ vue:
+ optional: true
+
+ '@vue/babel-helper-vue-transform-on@2.0.1':
+ resolution: {integrity: sha512-uZ66EaFbnnZSYqYEyplWvn46GhZ1KuYSThdT68p+am7MgBNbQ3hphTL9L+xSIsWkdktwhPYLwPgVWqo96jDdRA==}
+
+ '@vue/babel-plugin-jsx@2.0.1':
+ resolution: {integrity: sha512-a8CaLQjD/s4PVdhrLD/zT574ZNPnZBOY+IhdtKWRB4HRZ0I2tXBi5ne7d9eCfaYwp5gU5+4KIyFTV1W1YL9xZA==}
+ peerDependencies:
+ '@babel/core': ^7.0.0-0
+ peerDependenciesMeta:
+ '@babel/core':
+ optional: true
+
+ '@vue/babel-plugin-resolve-type@2.0.1':
+ resolution: {integrity: sha512-ybwgIuRGRRBhOU37GImDoWQoz+TlSqap65qVI6iwg/J7FfLTLmMf97TS7xQH9I7Qtr/gp161kYVdhr1ZMraSYQ==}
+ peerDependencies:
+ '@babel/core': ^7.0.0-0
+
+ '@vue/compiler-core@3.5.34':
+ resolution: {integrity: sha512-s9cLyK5mLcvZ4Agva5QgRsQyLKvts9WbU9DB6NqiZkkGEdwmcEiylj5Jbwkp680drF/NNCV8OlAJSe+yMLxaJw==}
+
+ '@vue/compiler-dom@3.5.34':
+ resolution: {integrity: sha512-EbF/T++k0e2MMZlJsBhzK8Sgwt0HcIPOhzn1CTB/lv6sQcyk+OWf8YeiLxZp3ro7MbbLcAfAJ6sEvjFWuNgUCw==}
+
+ '@vue/compiler-sfc@3.5.34':
+ resolution: {integrity: sha512-D/ihr6uZeIt6r+pVZf46RWT1fAsLFMbUP7k8G1VkiiWexriED9GrX3echHd4Abbt17zjlfiFJ8z7a3BxZOPNjg==}
+
+ '@vue/compiler-ssr@3.5.34':
+ resolution: {integrity: sha512-cDtTHKibkThKGHH1SP+WdccquNRYQDFH6rRjQCqT9G2ltFAfoR5pUftpab/z+aM5mW9HLLVQW7hfKKQe/1GBeQ==}
+
+ '@vue/devtools-api@8.1.2':
+ resolution: {integrity: sha512-vA0O112YqyDuNA1s7Yb2gCgToQ/OxOWiFDO5ThLCcDy0ldHnSd1dUTaSYhOldbqoNgumE4dxtGAoAaSUKUD1Zg==}
+
+ '@vue/devtools-core@8.1.2':
+ resolution: {integrity: sha512-ZGGyaSBP4/+bN2Nd9ZHNYAVDRIzMw1rv2RyXWtyZlo6mQal+IDmTvKY4V+DjAEBhaXt30mHmsgYp1yXJ/2tIWg==}
+ peerDependencies:
+ vue: 3.5.34
+
+ '@vue/devtools-kit@8.1.2':
+ resolution: {integrity: sha512-f75/upc+GCyjXErpgPGz4582ujS0L/adAltGy+tqXMGUJpgAcfGr6CxnnhpZY8BHuMYt6KpbF8uaFrrQG66rGQ==}
+
+ '@vue/devtools-shared@8.1.2':
+ resolution: {integrity: sha512-X9RyVFYAdkBe4IUf5v48TxBF/6QPmF8CmWrDAjXzfUHrgQ/HGfTC1A6TqgXqZ03ye66l3AD51BAGD69IvKM9sw==}
+
+ '@vue/language-core@3.2.9':
+ resolution: {integrity: sha512-ie0ojt/0fU/GfIogh+zgHbaYRPlt9S+cLOxcWwF7nTSFh897BVgnFKL2byT4kpp1mlqYWZ2psGwSniyE2xsxYw==}
+
+ '@vue/reactivity@3.5.34':
+ resolution: {integrity: sha512-y9XDjCEuBp+98k+UL5dbYkh57AHU4o6cxZedOPXw3bmrZZYLQsVHguGurq7hVrPCSrQtrnz1f9dssyFr+dMXfQ==}
+
+ '@vue/runtime-core@3.5.34':
+ resolution: {integrity: sha512-mKeBYvu8tcMSLhypAHBmriUFfWXKTCF/23Z4jiCoYK3UtWepkliViNLuR90V9XOyD62mUxs9p1jsrpK3CCGIzw==}
+
+ '@vue/runtime-dom@3.5.34':
+ resolution: {integrity: sha512-e8kZzERmCwUnBRVsgSQlAfrfU2rGoy0FFKPBXSlfEjc/O3KfA7QP0t1/2ZylrbchjmIKB4dPTd07A6WPr0eOrg==}
+
+ '@vue/server-renderer@3.5.34':
+ resolution: {integrity: sha512-nHxmJoTrKsmrkbILRhkC9gY1G3moZbJTqCzDd7DOOzG5KH9oeJ0Unqrff5f9v0pW//jES05ZkJcNtfE8JjOIew==}
+ peerDependencies:
+ vue: 3.5.34
+
+ '@vue/shared@3.5.34':
+ resolution: {integrity: sha512-24uqU4OIiX29ryC3MeWid/Xf2fa2EFRUVLb77nRhk+UrTVrh/XiGtFAFmJBAtBRbjwNdsPRP+jj/OL27Eg1NDA==}
+
+ '@vue/test-utils@2.4.10':
+ resolution: {integrity: sha512-SmoZ5EA1kYiAFs9NkYdiFFQF+cSnUwnvlYEbY+DogWQZUiqOm/Y29eSbc5T6yi75SgSF9863SBeXniIEoPajCA==}
+ peerDependencies:
+ '@vue/compiler-dom': 3.x
+ '@vue/server-renderer': 3.x
+ vue: 3.5.34
+ peerDependenciesMeta:
+ '@vue/server-renderer':
+ optional: true
+
+ '@vueuse/core@14.3.0':
+ resolution: {integrity: sha512-aHfz47g0ZhMtTVHmIzMVpJy8ePhhOy68GY5bv110+5DVtZ+W7BsOx+m61UNQqfrWyPztIHIanWa3E2tib3NFIw==}
+ peerDependencies:
+ vue: 3.5.34
+
+ '@vueuse/metadata@14.3.0':
+ resolution: {integrity: sha512-BwxmbAzwAVF50+MW57GXOUEV61nFBGnlBvrTqj49PqWJu3uw7hdu72ztXeZ33RdZtDY6kO+bfCAE1PCn88Tktw==}
+
+ '@vueuse/shared@14.3.0':
+ resolution: {integrity: sha512-bZpge9eSXwa4ToSiqJ7j6KRwhAsneMFoSz3LMWKQDkqimm3D/tbFlrklrs/IOqC8tEcYmXQZJ6N0UrjhBirVCg==}
+ peerDependencies:
+ vue: 3.5.34
+
+ '@webassemblyjs/ast@1.14.1':
+ resolution: {integrity: sha512-nuBEDgQfm1ccRp/8bCQrx1frohyufl4JlbMMZ4P1wpeOfDhF6FQkxZJ1b/e+PLwr6X1Nhw6OLme5usuBWYBvuQ==}
+
+ '@webassemblyjs/floating-point-hex-parser@1.13.2':
+ resolution: {integrity: sha512-6oXyTOzbKxGH4steLbLNOu71Oj+C8Lg34n6CqRvqfS2O71BxY6ByfMDRhBytzknj9yGUPVJ1qIKhRlAwO1AovA==}
+
+ '@webassemblyjs/helper-api-error@1.13.2':
+ resolution: {integrity: sha512-U56GMYxy4ZQCbDZd6JuvvNV/WFildOjsaWD3Tzzvmw/mas3cXzRJPMjP83JqEsgSbyrmaGjBfDtV7KDXV9UzFQ==}
+
+ '@webassemblyjs/helper-buffer@1.14.1':
+ resolution: {integrity: sha512-jyH7wtcHiKssDtFPRB+iQdxlDf96m0E39yb0k5uJVhFGleZFoNw1c4aeIcVUPPbXUVJ94wwnMOAqUHyzoEPVMA==}
+
+ '@webassemblyjs/helper-numbers@1.13.2':
+ resolution: {integrity: sha512-FE8aCmS5Q6eQYcV3gI35O4J789wlQA+7JrqTTpJqn5emA4U2hvwJmvFRC0HODS+3Ye6WioDklgd6scJ3+PLnEA==}
+
+ '@webassemblyjs/helper-wasm-bytecode@1.13.2':
+ resolution: {integrity: sha512-3QbLKy93F0EAIXLh0ogEVR6rOubA9AoZ+WRYhNbFyuB70j3dRdwH9g+qXhLAO0kiYGlg3TxDV+I4rQTr/YNXkA==}
+
+ '@webassemblyjs/helper-wasm-section@1.14.1':
+ resolution: {integrity: sha512-ds5mXEqTJ6oxRoqjhWDU83OgzAYjwsCV8Lo/N+oRsNDmx/ZDpqalmrtgOMkHwxsG0iI//3BwWAErYRHtgn0dZw==}
+
+ '@webassemblyjs/ieee754@1.13.2':
+ resolution: {integrity: sha512-4LtOzh58S/5lX4ITKxnAK2USuNEvpdVV9AlgGQb8rJDHaLeHciwG4zlGr0j/SNWlr7x3vO1lDEsuePvtcDNCkw==}
+
+ '@webassemblyjs/leb128@1.13.2':
+ resolution: {integrity: sha512-Lde1oNoIdzVzdkNEAWZ1dZ5orIbff80YPdHx20mrHwHrVNNTjNr8E3xz9BdpcGqRQbAEa+fkrCb+fRFTl/6sQw==}
+
+ '@webassemblyjs/utf8@1.13.2':
+ resolution: {integrity: sha512-3NQWGjKTASY1xV5m7Hr0iPeXD9+RDobLll3T9d2AO+g3my8xy5peVyjSag4I50mR1bBSN/Ct12lo+R9tJk0NZQ==}
+
+ '@webassemblyjs/wasm-edit@1.14.1':
+ resolution: {integrity: sha512-RNJUIQH/J8iA/1NzlE4N7KtyZNHi3w7at7hDjvRNm5rcUXa00z1vRz3glZoULfJ5mpvYhLybmVcwcjGrC1pRrQ==}
+
+ '@webassemblyjs/wasm-gen@1.14.1':
+ resolution: {integrity: sha512-AmomSIjP8ZbfGQhumkNvgC33AY7qtMCXnN6bL2u2Js4gVCg8fp735aEiMSBbDR7UQIj90n4wKAFUSEd0QN2Ukg==}
+
+ '@webassemblyjs/wasm-opt@1.14.1':
+ resolution: {integrity: sha512-PTcKLUNvBqnY2U6E5bdOQcSM+oVP/PmrDY9NzowJjislEjwP/C4an2303MCVS2Mg9d3AJpIGdUFIQQWbPds0Sw==}
+
+ '@webassemblyjs/wasm-parser@1.14.1':
+ resolution: {integrity: sha512-JLBl+KZ0R5qB7mCnud/yyX08jWFw5MsoalJ1pQ4EdFlgj9VdXKGuENGsiCIjegI1W7p91rUlcB/LB5yRJKNTcQ==}
+
+ '@webassemblyjs/wast-printer@1.14.1':
+ resolution: {integrity: sha512-kPSSXE6De1XOR820C90RIo2ogvZG+c3KiHzqUoO/F34Y2shGzesfqv7o57xrxovZJH/MetF5UjroJ/R/3isoiw==}
+
+ '@xtuc/ieee754@1.2.0':
+ resolution: {integrity: sha512-DX8nKgqcGwsc0eJSqYt5lwP4DH5FlHnmuWWBRy7X0NcaGR0ZtuyeESgMwTYVEtxmsNGY+qit4QYT/MIYTOTPeA==}
+
+ '@xtuc/long@4.2.2':
+ resolution: {integrity: sha512-NuHqBY1PB/D8xU6s/thBgOAiAP7HOYDQ32+BFZILJ8ivkUkAHQnWfn6WhL79Owj1qmUnoN/YPhktdIoucipkAQ==}
+
+ abbrev@2.0.0:
+ resolution: {integrity: sha512-6/mh1E2u2YgEsCHdY0Yx5oW+61gZU+1vXaoiHHrpKeuRNNgFvS+/jrwHiQhB5apAf5oB7UB7E19ol2R2LKH8hQ==}
+ engines: {node: ^14.17.0 || ^16.13.0 || >=18.0.0}
+
+ abbrev@3.0.1:
+ resolution: {integrity: sha512-AO2ac6pjRB3SJmGJo+v5/aK6Omggp6fsLrs6wN9bd35ulu4cCwaAU9+7ZhXjeqHVkaHThLuzH0nZr0YpCDhygg==}
+ engines: {node: ^18.17.0 || >=20.5.0}
+
+ abort-controller@3.0.0:
+ resolution: {integrity: sha512-h8lQ8tacZYnR3vNQTgibj+tODHI5/+l06Au2Pcriv/Gmet0eaj4TwWH41sO9wnHDiQsEj19q0drzdWdeAHtweg==}
+ engines: {node: '>=6.5'}
+
+ acorn-import-attributes@1.9.5:
+ resolution: {integrity: sha512-n02Vykv5uA3eHGM/Z2dQrcD56kL8TyDb2p1+0P83PClMnC/nc+anbQRhIOWnSq4Ke/KvDPrY3C9hDtC/A3eHnQ==}
+ peerDependencies:
+ acorn: ^8
+
+ acorn-import-phases@1.0.4:
+ resolution: {integrity: sha512-wKmbr/DDiIXzEOiWrTTUcDm24kQ2vGfZQvM2fwg2vXqR5uW6aapr7ObPtj1th32b9u90/Pf4AItvdTh42fBmVQ==}
+ engines: {node: '>=10.13.0'}
+ peerDependencies:
+ acorn: ^8.14.0
+
+ acorn-jsx@5.3.2:
+ resolution: {integrity: sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ==}
+ peerDependencies:
+ acorn: ^6.0.0 || ^7.0.0 || ^8.0.0
+
+ acorn-walk@8.3.5:
+ resolution: {integrity: sha512-HEHNfbars9v4pgpW6SO1KSPkfoS0xVOM/9UzkJltjlsHZmJasxg8aXkuZa7SMf8vKGIBhpUsPluQSqhJFCqebw==}
+ engines: {node: '>=0.4.0'}
+
+ acorn@7.4.1:
+ resolution: {integrity: sha512-nQyp0o1/mNdbTO1PO6kHkwSrmgZ0MT/jCCpNiwbUjGoRN4dlBhqJtoQuCnEOKzgTVwg0ZWiCoQy6SxMebQVh8A==}
+ engines: {node: '>=0.4.0'}
+ hasBin: true
+
+ acorn@8.16.0:
+ resolution: {integrity: sha512-UVJyE9MttOsBQIDKw1skb9nAwQuR5wuGD3+82K6JgJlm/Y+KI92oNsMNGZCYdDsVtRHSak0pcV5Dno5+4jh9sw==}
+ engines: {node: '>=0.4.0'}
+ hasBin: true
+
+ agent-base@6.0.2:
+ resolution: {integrity: sha512-RZNwNclF7+MS/8bDg70amg32dyeZGZxiDuQmZxKLAlQjr3jGyLx+4Kkk58UO7D2QdgFIQCovuSuZESne6RG6XQ==}
+ engines: {node: '>= 6.0.0'}
+
+ agent-base@7.1.4:
+ resolution: {integrity: sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ==}
+ engines: {node: '>= 14'}
+
+ ajv-formats@2.1.1:
+ resolution: {integrity: sha512-Wx0Kx52hxE7C18hkMEggYlEifqWZtYaRgouJor+WMdPnQyEK13vgEWyVNup7SoeeoLMsr4kf5h6dOW11I15MUA==}
+ peerDependencies:
+ ajv: ^8.0.0
+ peerDependenciesMeta:
+ ajv:
+ optional: true
+
+ ajv-keywords@3.5.2:
+ resolution: {integrity: sha512-5p6WTN0DdTGVQk6VjcEju19IgaHudalcfabD7yhDGeA6bcQnmL+CpveLJq/3hvfwd1aof6L386Ougkx6RfyMIQ==}
+ peerDependencies:
+ ajv: ^6.9.1
+
+ ajv-keywords@5.1.0:
+ resolution: {integrity: sha512-YCS/JNFAUyr5vAuhk1DWm1CBxRHW9LbJ2ozWeemrIqpbsqKjHVxYPyi5GC0rjZIT5JxJ3virVTS8wk4i/Z+krw==}
+ peerDependencies:
+ ajv: ^8.8.2
+
+ ajv@6.15.0:
+ resolution: {integrity: sha512-fgFx7Hfoq60ytK2c7DhnF8jIvzYgOMxfugjLOSMHjLIPgenqa7S7oaagATUq99mV6IYvN2tRmC0wnTYX6iPbMw==}
+
+ ajv@8.20.0:
+ resolution: {integrity: sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA==}
+
+ alien-signals@3.2.1:
+ resolution: {integrity: sha512-I8FjmltrfnDFoZedi5CG8DghVYNhzb/Ijluz7tCSJH0xpd0484Kowhbb1XDYOxfJpU1p5wnM2X54dA+IfGyD1g==}
+
+ ansi-escapes@7.3.0:
+ resolution: {integrity: sha512-BvU8nYgGQBxcmMuEeUEmNTvrMVjJNSH7RgW24vXexN4Ven6qCvy4TntnvlnwnMLTVlcRQQdbRY8NKnaIoeWDNg==}
+ engines: {node: '>=18'}
+
+ ansi-html-community@0.0.8:
+ resolution: {integrity: sha512-1APHAyr3+PCamwNw3bXCPp4HFLONZt/yIH0sZp0/469KWNTEy+qN5jQ3GVX6DMZ1UXAi34yVwtTeaG/HpBuuzw==}
+ engines: {'0': node >= 0.8.0}
+ hasBin: true
+
+ ansi-regex@5.0.1:
+ resolution: {integrity: sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==}
+ engines: {node: '>=8'}
+
+ ansi-regex@6.2.2:
+ resolution: {integrity: sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg==}
+ engines: {node: '>=12'}
+
+ ansi-styles@3.2.1:
+ resolution: {integrity: sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==}
+ engines: {node: '>=4'}
+
+ ansi-styles@4.3.0:
+ resolution: {integrity: sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==}
+ engines: {node: '>=8'}
+
+ ansi-styles@5.2.0:
+ resolution: {integrity: sha512-Cxwpt2SfTzTtXcfOlzGEee8O+c+MmUgGrNiBcXnuWxuFJHe6a5Hz7qwhwe5OgaSYI0IJvkLqWX1ASG+cJOkEiA==}
+ engines: {node: '>=10'}
+
+ ansi-styles@6.2.3:
+ resolution: {integrity: sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==}
+ engines: {node: '>=12'}
+
+ ansis@3.17.0:
+ resolution: {integrity: sha512-0qWUglt9JEqLFr3w1I1pbrChn1grhaiAR2ocX1PP/flRmxgtwTzPFFFnfIlD6aMOLQZgSuCRlidD70lvx8yhzg==}
+ engines: {node: '>=14'}
+
+ ansis@4.3.0:
+ resolution: {integrity: sha512-44mvgtPvohuU/70DdY5Oz2AIrLJ9k6/5x4KmoSvPwO+5Moijo0+N9D0fKbbYZQWP1hNm5CpOf+E01jhxG/r8xg==}
+ engines: {node: '>=14'}
+
+ any-promise@1.3.0:
+ resolution: {integrity: sha512-7UvmKalWRt1wgjL1RrGxoSJW/0QZFIegpeGvZG9kjp8vrRu55XTHbwnqq2GpXm9uLbcuhxm3IqX9OB4MZR1b2A==}
+
+ anymatch@3.1.3:
+ resolution: {integrity: sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==}
+ engines: {node: '>= 8'}
+
+ archiver-utils@5.0.2:
+ resolution: {integrity: sha512-wuLJMmIBQYCsGZgYLTy5FIB2pF6Lfb6cXMSF8Qywwk3t20zWnAi7zLcQFdKQmIB8wyZpY5ER38x08GbwtR2cLA==}
+ engines: {node: '>= 14'}
+
+ archiver@7.0.1:
+ resolution: {integrity: sha512-ZcbTaIqJOfCc03QwD468Unz/5Ir8ATtvAHsK+FdXbDIbGfihqh9mrvdcYunQzqn4HrvWWaFyaxJhGZagaJJpPQ==}
+ engines: {node: '>= 14'}
+
+ are-docs-informative@0.0.2:
+ resolution: {integrity: sha512-ixiS0nLNNG5jNQzgZJNoUpBKdo9yTYZMGJ+QgT2jmjR7G7+QHRCc4v6LQ3NgE7EBJq+o0ams3waJwkrlBom8Ig==}
+ engines: {node: '>=14'}
+
+ argparse@2.0.1:
+ resolution: {integrity: sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==}
+
+ aria-query@5.1.3:
+ resolution: {integrity: sha512-R5iJ5lkuHybztUfuOAznmboyjWq8O6sqNqtK7CLOqdydi54VNbORp49mb14KbWgG1QD3JFO9hJdZ+y4KutfdOQ==}
+
+ array-buffer-byte-length@1.0.2:
+ resolution: {integrity: sha512-LHE+8BuR7RYGDKvnrmcuSq3tDcKv9OFEXQt/HpbZhY7V6h0zlUXutnAD82GiFx9rdieCMjkvtcsPqBwgUl1Iiw==}
+ engines: {node: '>= 0.4'}
+
+ asap@2.0.6:
+ resolution: {integrity: sha512-BSHWgDSAiKs50o2Re8ppvp3seVHXSRM44cdSsT9FfNEUUZLOGWVCsiWaRPWM1Znn+mqZ1OfVZ3z3DWEzSp7hRA==}
+
+ assert-never@1.4.0:
+ resolution: {integrity: sha512-5oJg84os6NMQNl27T9LnZkvvqzvAnHu03ShCnoj6bsJwS7L8AO4lf+C/XjK/nvzEqQB744moC6V128RucQd1jA==}
+
+ assertion-error@2.0.1:
+ resolution: {integrity: sha512-Izi8RQcffqCeNVgFigKli1ssklIbpHnCYc6AknXGYoB6grJqyeby7jv12JUQgmTAnIDnbck1uxksT4dzN3PWBA==}
+ engines: {node: '>=12'}
+
+ ast-kit@2.2.0:
+ resolution: {integrity: sha512-m1Q/RaVOnTp9JxPX+F+Zn7IcLYMzM8kZofDImfsKZd8MbR+ikdOzTeztStWqfrqIxZnYWryyI9ePm3NGjnZgGw==}
+ engines: {node: '>=20.19.0'}
+
+ ast-kit@3.0.0-beta.1:
+ resolution: {integrity: sha512-trmleAnZ2PxN/loHWVhhx1qeOHSRXq4TDsBBxq3GqeJitfk3+jTQ+v/C1km/KYq9M7wKqCewMh+/NAvVH7m+bw==}
+ engines: {node: '>=20.19.0'}
+
+ ast-v8-to-istanbul@1.0.0:
+ resolution: {integrity: sha512-1fSfIwuDICFA4LKkCzRPO7F0hzFf0B7+Xqrl27ynQaa+Rh0e1Es0v6kWHPott3lU10AyAr7oKHa65OppjLn3Rg==}
+
+ ast-walker-scope@0.8.3:
+ resolution: {integrity: sha512-cbdCP0PGOBq0ASG+sjnKIoYkWMKhhz+F/h9pRexUdX2Hd38+WOlBkRKlqkGOSm0YQpcFMQBJeK4WspUAkwsEdg==}
+ engines: {node: '>=20.19.0'}
+
+ async-sema@3.1.1:
+ resolution: {integrity: sha512-tLRNUXati5MFePdAk8dw7Qt7DpxPB60ofAgn8WRhW6a2rcimZnYBP9oxHiv0OHy+Wz7kPMG+t4LGdt31+4EmGg==}
+
+ async@3.2.6:
+ resolution: {integrity: sha512-htCUDlxyyCLMgaM3xXg0C0LW2xqfuQ6p05pCEIsXuyQ+a1koYKTuBMzRNwmybfLgvJDMd0r1LTn4+E0Ti6C2AA==}
+
+ asynckit@0.4.0:
+ resolution: {integrity: sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==}
+
+ autoprefixer@10.5.0:
+ resolution: {integrity: sha512-FMhOoZV4+qR6aTUALKX2rEqGG+oyATvwBt9IIzVR5rMa2HRWPkxf+P+PAJLD1I/H5/II+HuZcBJYEFBpq39ong==}
+ engines: {node: ^10 || ^12 || >=14}
+ hasBin: true
+ peerDependencies:
+ postcss: ^8.1.0
+
+ available-typed-arrays@1.0.7:
+ resolution: {integrity: sha512-wvUjBtSGN7+7SjNpq/9M2Tg350UZD3q62IFZLbRAR1bSMlCo1ZaeW+BJ+D090e4hIIZLBcTDWe4Mh4jvUDajzQ==}
+ engines: {node: '>= 0.4'}
+
+ axios@1.16.1:
+ resolution: {integrity: sha512-caYkukvroVPO8KrzuJEb50Hm07KwfBZPEC3VeFHTsqWHvKTsy54hjJz9BS/cdaypROE2rH6xvm9mHX4fgWkr3A==}
+
+ b4a@1.8.1:
+ resolution: {integrity: sha512-aiqre1Nr0B/6DgE2N5vwTc+2/oQZ4Wh1t4NznYY4E00y8LCt6NqdRv81so00oo27D8MVKTpUa/MwUUtBLXCoDw==}
+ peerDependencies:
+ react-native-b4a: '*'
+ peerDependenciesMeta:
+ react-native-b4a:
+ optional: true
+
+ babel-walk@3.0.0-canary-5:
+ resolution: {integrity: sha512-GAwkz0AihzY5bkwIY5QDR+LvsRQgB/B+1foMPvi0FZPMl5fjD7ICiznUiBdLYMH1QYe6vqu4gWYytZOccLouFw==}
+ engines: {node: '>= 10.0.0'}
+
+ bail@2.0.2:
+ resolution: {integrity: sha512-0xO6mYd7JB2YesxDKplafRpsiOzPt9V02ddPCLbY1xYGPOX24NTyN50qnUxgCPcSoYMhKpAuBTjQoRZCAkUDRw==}
+
+ balanced-match@1.0.2:
+ resolution: {integrity: sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==}
+
+ balanced-match@4.0.4:
+ resolution: {integrity: sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA==}
+ engines: {node: 18 || 20 || >=22}
+
+ bare-events@2.8.3:
+ resolution: {integrity: sha512-HdUm8EMQBLaJvGUdidNNbqpA1kYkwNcb+MYxkxCLAPJGQzlv9J0C24h8V65Z4c5GLd/JEALDvpFCQgpLJqc0zw==}
+ peerDependencies:
+ bare-abort-controller: '*'
+ peerDependenciesMeta:
+ bare-abort-controller:
+ optional: true
+
+ bare-fs@4.7.1:
+ resolution: {integrity: sha512-WDRsyVN52eAx/lBamKD6uyw8H4228h/x0sGGGegOamM2cd7Pag88GfMQalobXI+HaEUxpCkbKQUDOQqt9wawRw==}
+ engines: {bare: '>=1.16.0'}
+ peerDependencies:
+ bare-buffer: '*'
+ peerDependenciesMeta:
+ bare-buffer:
+ optional: true
+
+ bare-os@3.9.1:
+ resolution: {integrity: sha512-6M5XjcnsygQNPMCMPXSK379xrJFiZ/AEMNBmFEmQW8d/789VQATvriyi5r0HYTL9TkQ26rn3kgdTG3aisbrXkQ==}
+ engines: {bare: '>=1.14.0'}
+
+ bare-path@3.0.0:
+ resolution: {integrity: sha512-tyfW2cQcB5NN8Saijrhqn0Zh7AnFNsnczRcuWODH0eYAXBsJ5gVxAUuNr7tsHSC6IZ77cA0SitzT+s47kot8Mw==}
+
+ bare-stream@2.13.1:
+ resolution: {integrity: sha512-Vp0cnjYyrEC4whYTymQ+YZi6pBpfiICZO3cfRG8sy67ZNWe951urv1x4eW1BKNngw3U+3fPYb5JQvHbCtxH7Ow==}
+ peerDependencies:
+ bare-abort-controller: '*'
+ bare-buffer: '*'
+ bare-events: '*'
+ peerDependenciesMeta:
+ bare-abort-controller:
+ optional: true
+ bare-buffer:
+ optional: true
+ bare-events:
+ optional: true
+
+ bare-url@2.4.3:
+ resolution: {integrity: sha512-Kccpc7ACfXaxfeInfqKcZtW4pT5YBn1mesc4sCsun6sRwtbJ4h+sNOaksUpYEJUKfN65YWC6Bw2OJEFiKxq8nQ==}
+
+ base64-js@1.5.1:
+ resolution: {integrity: sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==}
+
+ baseline-browser-mapping@2.10.32:
+ resolution: {integrity: sha512-wbPvpyjJPC0zdfdKXxqEL3Ea+bOMD/87X4lftiJkkaBiuG6ALQy1SLmEd7BSmVCuwCQsBrCamgBoLyfFDD1EPg==}
+ engines: {node: '>=6.0.0'}
+ hasBin: true
+
+ beasties@0.4.2:
+ resolution: {integrity: sha512-NvcGjG/7AVUAfRbvrJmHunDQS9uHnE6Q/7AkaPr8oKE8HjOlpjRG5075z/th2Tmlezk3VlaaS8+X9I1RwHJMQw==}
+ engines: {node: '>=18.0.0'}
+
+ big.js@5.2.2:
+ resolution: {integrity: sha512-vyL2OymJxmarO8gxMr0mhChsO9QGwhynfuu4+MHTAW6czfq9humCB7rKpUjDd9YUiDPU4mzpyupFSvOClAwbmQ==}
+
+ binary-extensions@2.3.0:
+ resolution: {integrity: sha512-Ceh+7ox5qe7LJuLHoY0feh3pHuUDHAcRUeyL2VYghZwfpkNIy/+8Ocg0a3UuSoYzavmylwuLWQOf3hl0jjMMIw==}
+ engines: {node: '>=8'}
+
+ bindings@1.5.0:
+ resolution: {integrity: sha512-p2q/t/mhvuOj/UeLlV6566GD/guowlr0hHxClI0W9m7MWYkL1F0hLo+0Aexs9HSPCtR1SXQ0TD3MMKrXZajbiQ==}
+
+ birpc@2.9.0:
+ resolution: {integrity: sha512-KrayHS5pBi69Xi9JmvoqrIgYGDkD6mcSe/i6YKi3w5kekCLzrX4+nawcXqrj2tIp50Kw/mT/s3p+GVK0A0sKxw==}
+
+ birpc@4.0.0:
+ resolution: {integrity: sha512-LShSxJP0KTmd101b6DRyGBj57LZxSDYWKitQNW/mi8GRMvZb078Uf9+pveax1DrVL89vm7mWe+TovdI/UDOuPw==}
+
+ bole@5.0.29:
+ resolution: {integrity: sha512-eYR9i2ubLv5/4TFGyZsQ1cVH4jF9+qLJA72Aow+E7ZZQfqHqQNUZeX3w+pVWF76PQyjl5eDKf2xylyOOX76ozA==}
+
+ boolbase@1.0.0:
+ resolution: {integrity: sha512-JZOSA7Mo9sNGB8+UjSgzdLtokWAky1zbztM3WRLCbZ70/3cTANmQmOdR7y2g+J0e2WXywy1yS468tY+IruqEww==}
+
+ brace-expansion@1.1.14:
+ resolution: {integrity: sha512-MWPGfDxnyzKU7rNOW9SP/c50vi3xrmrua/+6hfPbCS2ABNWfx24vPidzvC7krjU/RTo235sV776ymlsMtGKj8g==}
+
+ brace-expansion@2.1.0:
+ resolution: {integrity: sha512-TN1kCZAgdgweJhWWpgKYrQaMNHcDULHkWwQIspdtjV4Y5aurRdZpjAqn6yX3FPqTA9ngHCc4hJxMAMgGfve85w==}
+
+ brace-expansion@5.0.6:
+ resolution: {integrity: sha512-kLpxurY4Z4r9sgMsyG0Z9uzsBlgiU/EFKhj/h91/8yHu0edo7XuixOIH3VcJ8kkxs6/jPzoI6U9Vj3WqbMQ94g==}
+ engines: {node: 18 || 20 || >=22}
+
+ braces@3.0.3:
+ resolution: {integrity: sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==}
+ engines: {node: '>=8'}
+
+ browserslist@4.28.2:
+ resolution: {integrity: sha512-48xSriZYYg+8qXna9kwqjIVzuQxi+KYWp2+5nCYnYKPTr0LvD89Jqk2Or5ogxz0NUMfIjhh2lIUX/LyX9B4oIg==}
+ engines: {node: ^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7}
+ hasBin: true
+
+ buffer-crc32@1.0.0:
+ resolution: {integrity: sha512-Db1SbgBS/fg/392AblrMJk97KggmvYhr4pB5ZIMTWtaivCPMWLkmb7m21cJvpvgK+J3nsU2CmmixNBZx4vFj/w==}
+ engines: {node: '>=8.0.0'}
+
+ buffer-from@1.1.2:
+ resolution: {integrity: sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==}
+
+ buffer@6.0.3:
+ resolution: {integrity: sha512-FTiCpNxtwiZZHEZbcbTIcZjERVICn9yq/pDFkTl95/AxzD1naBctN7YO68riM/gLSDY7sdrMby8hofADYuuqOA==}
+
+ buffered-async-iterable@1.0.1:
+ resolution: {integrity: sha512-QqoUm0XP17Bu6zzyvpK92K7jNYMoFYgKM0ZKr0OkoDlElpTTeucGmdJL8I7W+reFIfvgUWOm1PgJC+OxM2lMEQ==}
+ engines: {node: '>=18.6.0'}
+
+ builtin-modules@5.2.0:
+ resolution: {integrity: sha512-02yxLeyxF4dNl6SlY6/5HfRSrSdZ/sCPoxy2kZNP5dZZX8LSAD9aE2gtJIUgWrsQTiMPl3mxESyrobSwvRGisQ==}
+ engines: {node: '>=18.20'}
+
+ bundle-name@4.1.0:
+ resolution: {integrity: sha512-tjwM5exMg6BGRI+kNmTntNsvdZS1X8BFYS6tnJ2hdH0kVxM6/eVZ2xy+FqStSWvYmtfFMDLIxurorHwDKfDz5Q==}
+ engines: {node: '>=18'}
+
+ c12@3.3.4:
+ resolution: {integrity: sha512-cM0ApFQSBXuourJejzwv/AuPRvAxordTyParRVcHjjtXirtkzM0uK2L9TTn9s0cXZbG7E55jCivRQzoxYmRAlA==}
+ peerDependencies:
+ magicast: '*'
+ peerDependenciesMeta:
+ magicast:
+ optional: true
+
+ c12@4.0.0-beta.5:
+ resolution: {integrity: sha512-yWGCPCQGJeFq4R0mFg5HOhC3Rg+B0PCdM+ldXWUhughoGgeeq8/tjRmXh4/lmhKWyhf+KOFxB/JMXf0Yv1Fd5A==}
+ peerDependencies:
+ chokidar: ^5
+ dotenv: '*'
+ giget: '*'
+ jiti: '*'
+ magicast: '*'
+ peerDependenciesMeta:
+ chokidar:
+ optional: true
+ dotenv:
+ optional: true
+ giget:
+ optional: true
+ jiti:
+ optional: true
+ magicast:
+ optional: true
+
+ cac@7.0.0:
+ resolution: {integrity: sha512-tixWYgm5ZoOD+3g6UTea91eow5z6AAHaho3g0V9CNSNb45gM8SmflpAc+GRd1InC4AqN/07Unrgp56Y94N9hJQ==}
+ engines: {node: '>=20.19.0'}
+
+ call-bind-apply-helpers@1.0.2:
+ resolution: {integrity: sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==}
+ engines: {node: '>= 0.4'}
+
+ call-bind@1.0.9:
+ resolution: {integrity: sha512-a/hy+pNsFUTR+Iz8TCJvXudKVLAnz/DyeSUo10I5yvFDQJBFU2s9uqQpoSrJlroHUKoKqzg+epxyP9lqFdzfBQ==}
+ engines: {node: '>= 0.4'}
+
+ call-bound@1.0.4:
+ resolution: {integrity: sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==}
+ engines: {node: '>= 0.4'}
+
+ callsites@3.1.0:
+ resolution: {integrity: sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==}
+ engines: {node: '>=6'}
+
+ caniuse-api@3.0.0:
+ resolution: {integrity: sha512-bsTwuIg/BZZK/vreVTYYbSWoe2F+71P7K5QGEX+pT250DZbfU1MQ5prOKpPR+LL6uWKK3KMwMCAS74QB3Um1uw==}
+
+ caniuse-lite@1.0.30001793:
+ resolution: {integrity: sha512-iwSsYWaCOoh26cV8NwNRViHlrfUvYsHDfRVcbtmw0Kg6PJIZZXwMkj1442FYLBGkeUf1juAsU3DTfxW579mrPA==}
+
+ case-police@2.2.1:
+ resolution: {integrity: sha512-EZlL1YgE36hPbgkbSh32RvfITFE1K/z6K6DHlLLUDq/QctI/jON/pTTIS4C4eqyaVn5pvG118HanhEFry420Ow==}
+ hasBin: true
+
+ ccount@2.0.1:
+ resolution: {integrity: sha512-eyrF0jiFpY+3drT6383f1qhkbGsLSifNAjA61IUjZjmLCWjItY6LB9ft9YhoDgwfmclB2zhu51Lc7+95b8NRAg==}
+
+ chai@6.2.2:
+ resolution: {integrity: sha512-NUPRluOfOiTKBKvWPtSD4PhFvWCqOi0BGStNWs57X9js7XGTprSmFoz5F0tWhR4WPjNeR9jXqdC7/UpSJTnlRg==}
+ engines: {node: '>=18'}
+
+ chalk@2.4.2:
+ resolution: {integrity: sha512-Mti+f9lpJNcwF4tWV8/OrTTtF1gZi+f8FqlyAdouralcFWFQWF2+NgCHShjkCb+IFBLq9buZwE1xckQU4peSuQ==}
+ engines: {node: '>=4'}
+
+ chalk@4.1.2:
+ resolution: {integrity: sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==}
+ engines: {node: '>=10'}
+
+ chalk@5.6.2:
+ resolution: {integrity: sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA==}
+ engines: {node: ^12.17.0 || ^14.13 || >=16.0.0}
+
+ change-case@5.4.4:
+ resolution: {integrity: sha512-HRQyTk2/YPEkt9TnUPbOpr64Uw3KOicFWPVBb+xiHvd6eBx/qPr9xqfBFDT8P2vWsvvz4jbEkfDe71W3VyNu2w==}
+
+ changelogen@0.6.2:
+ resolution: {integrity: sha512-QtC7+r9BxoUm+XDAwhLbz3CgU134J1ytfE3iCpLpA4KFzX2P1e6s21RrWDwUBzfx66b1Rv+6lOA2nS2btprd+A==}
+ hasBin: true
+
+ char-regex@1.0.2:
+ resolution: {integrity: sha512-kWWXztvZ5SBQV+eRgKFeh8q5sLuZY2+8WUIzlxWVTg+oGwY14qylx1KbKzHd8P6ZYkAg0xyIDU9JMHhyJMZ1jw==}
+ engines: {node: '>=10'}
+
+ character-entities-html4@2.1.0:
+ resolution: {integrity: sha512-1v7fgQRj6hnSwFpq1Eu0ynr/CDEw0rXo2B61qXrLNdHZmPKgb7fqS1a2JwF0rISo9q77jDI8VMEHoApn8qDoZA==}
+
+ character-entities-legacy@3.0.0:
+ resolution: {integrity: sha512-RpPp0asT/6ufRm//AJVwpViZbGM/MkjQFxJccQRHmISF/22NBtsHqAWmL+/pmkPWoIUJdWyeVleTl1wydHATVQ==}
+
+ character-entities@2.0.2:
+ resolution: {integrity: sha512-shx7oQ0Awen/BRIdkjkvz54PnEEI/EjwXDSIZp86/KKdbafHh1Df/RYGBhn4hbe2+uKC9FnT5UCEdyPz3ai9hQ==}
+
+ character-parser@2.2.0:
+ resolution: {integrity: sha512-+UqJQjFEFaTAs3bNsF2j2kEN1baG/zghZbdqoYEDxGZtJo9LBzl1A+m0D4n3qKx8N2FNv8/Xp6yV9mQmBuptaw==}
+
+ character-reference-invalid@2.0.1:
+ resolution: {integrity: sha512-iBZ4F4wRbyORVsu0jPV7gXkOsGYjGHPmAyv+HiHG8gi5PtC9KI2j1+v8/tlibRvjoWX027ypmG/n0HtO5t7unw==}
+
+ chokidar@3.6.0:
+ resolution: {integrity: sha512-7VT13fmjotKpGipCW9JEQAusEPE+Ei8nl6/g4FBAmIm0GOOLMua9NDDo/DWp0ZAxCr3cPq5ZpBqmPAQgDda2Pw==}
+ engines: {node: '>= 8.10.0'}
+
+ chokidar@4.0.3:
+ resolution: {integrity: sha512-Qgzu8kfBvo+cA4962jnP1KkS6Dop5NS6g7R5LFYJr4b8Ub94PPQXUksCw9PvXoeXPRRddRNC5C1JQUR2SMGtnA==}
+ engines: {node: '>= 14.16.0'}
+
+ chokidar@5.0.0:
+ resolution: {integrity: sha512-TQMmc3w+5AxjpL8iIiwebF73dRDF4fBIieAqGn9RGCWaEVwQ6Fb2cGe31Yns0RRIzii5goJ1Y7xbMwo1TxMplw==}
+ engines: {node: '>= 20.19.0'}
+
+ chownr@3.0.0:
+ resolution: {integrity: sha512-+IxzY9BZOQd/XuYPRmrvEVjF/nqj5kgT4kEq7VofrDoM1MxoRjEWkrCC3EtLi59TVawxTAn+orJwFQcrqEN1+g==}
+ engines: {node: '>=18'}
+
+ chrome-trace-event@1.0.4:
+ resolution: {integrity: sha512-rNjApaLzuwaOTjCiT8lSDdGN1APCiqkChLMJxJPWLunPAt5fy8xgU9/jNOchV84wfIxrA0lRQB7oCT8jrn/wrQ==}
+ engines: {node: '>=6.0'}
+
+ ci-info@4.4.0:
+ resolution: {integrity: sha512-77PSwercCZU2Fc4sX94eF8k8Pxte6JAwL4/ICZLFjJLqegs7kCuAsqqj/70NQF6TvDpgFjkubQB2FW2ZZddvQg==}
+ engines: {node: '>=8'}
+
+ citty@0.1.6:
+ resolution: {integrity: sha512-tskPPKEs8D2KPafUypv2gxwJP8h/OaJmC82QQGGDQcHvXX43xF2VDACcJVmZ0EuSxkpO9Kc4MlrA3q0+FG58AQ==}
+
+ citty@0.2.2:
+ resolution: {integrity: sha512-+6vJA3L98yv+IdfKGZHBNiGW5KHn22e/JwID0Strsz8h4S/csAu/OuICwxrg44k5MRiZHWIo8XXuJgQTriRP4w==}
+
+ cjs-module-lexer@1.4.3:
+ resolution: {integrity: sha512-9z8TZaGM1pfswYeXrUpzPrkx8UnWYdhJclsiYMm6x/w5+nN+8Tf/LnAgfLGQCm59qAOxU8WwHEq2vNwF6i4j+Q==}
+
+ clean-regexp@1.0.0:
+ resolution: {integrity: sha512-GfisEZEJvzKrmGWkvfhgzcz/BllN1USeqD2V6tg14OAOgaCD2Z/PUEuxnAZ/nPvmaHRG7a8y77p1T/IRQ4D1Hw==}
+ engines: {node: '>=4'}
+
+ cli-highlight@2.1.11:
+ resolution: {integrity: sha512-9KDcoEVwyUXrjcJNvHD0NFc/hiwe/WPVYIleQh2O1N2Zro5gWJZ/K+3DGn8w8P/F6FxOgzyC5bxDyHIgCSPhGg==}
+ engines: {node: '>=8.0.0', npm: '>=5.0.0'}
+ hasBin: true
+
+ cli-table3@0.6.5:
+ resolution: {integrity: sha512-+W/5efTR7y5HRD7gACw9yQjqMVvEMLBHmboM/kPWam+H+Hmyrgjh6YncVKK122YZkXrLudzTuAukUw9FnMf7IQ==}
+ engines: {node: 10.* || >= 12.*}
+
+ cliui@7.0.4:
+ resolution: {integrity: sha512-OcRE68cOsVMXp1Yvonl/fzkQOyjLSu/8bhPDfQt0e0/Eb283TKP20Fs2MqoPsr9SwA595rRCA+QMzYc9nBP+JQ==}
+
+ cliui@9.0.1:
+ resolution: {integrity: sha512-k7ndgKhwoQveBL+/1tqGJYNz097I7WOvwbmmU2AR5+magtbjPWQTS1C5vzGkBC8Ym8UWRzfKUzUUqFLypY4Q+w==}
+ engines: {node: '>=20'}
+
+ cluster-key-slot@1.1.2:
+ resolution: {integrity: sha512-RMr0FhtfXemyinomL4hrWcYJxmX6deFdCxpJzhDttxgO1+bcCnkk+9drydLVDmAMG7NE6aN/fl4F7ucU/90gAA==}
+ engines: {node: '>=0.10.0'}
+
+ color-convert@1.9.3:
+ resolution: {integrity: sha512-QfAUtd+vFdAtFQcC8CCyYt1fYWxSqAiK2cSD6zDB8N3cpsEBAvRxp9zOGg6G/SHHJYAT88/az/IuDGALsNVbGg==}
+
+ color-convert@2.0.1:
+ resolution: {integrity: sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==}
+ engines: {node: '>=7.0.0'}
+
+ color-name@1.1.3:
+ resolution: {integrity: sha512-72fSenhMw2HZMTVHeCA9KCmpEIbzWiQsjN+BHcBbS9vr1mtt+vJjPdksIBNUmKAW8TFUDPJK5SUU3QhE9NEXDw==}
+
+ color-name@1.1.4:
+ resolution: {integrity: sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==}
+
+ colorette@2.0.20:
+ resolution: {integrity: sha512-IfEDxwoWIjkeXL1eXcDiow4UbKjhLdq6/EuSVR9GMN7KVH3r9gQ83e73hsz1Nd1T3ijd5xv1wcWRYO+D6kCI2w==}
+
+ combined-stream@1.0.8:
+ resolution: {integrity: sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==}
+ engines: {node: '>= 0.8'}
+
+ comma-separated-tokens@2.0.3:
+ resolution: {integrity: sha512-Fu4hJdvzeylCfQPp9SGWidpzrMs7tTrlu6Vb8XGaRGck8QSNZJJp538Wrb60Lax4fPwR64ViY468OIUTbRlGZg==}
+
+ commander@10.0.1:
+ resolution: {integrity: sha512-y4Mg2tXshplEbSGzx7amzPwKKOCGuoSRP/CjEdwwk0FOGlUbq6lKuoyDZTNZkmxHdJtp54hdfY/JUrdL7Xfdug==}
+ engines: {node: '>=14'}
+
+ commander@11.1.0:
+ resolution: {integrity: sha512-yPVavfyCcRhmorC7rWlkHn15b4wDVgVmBA7kV4QVBsF7kv/9TKJAbAXVTxvTnwP8HHKjRCJDClKbciiYS7p0DQ==}
+ engines: {node: '>=16'}
+
+ commander@14.0.3:
+ resolution: {integrity: sha512-H+y0Jo/T1RZ9qPP4Eh1pkcQcLRglraJaSLoyOtHxu6AapkjWVCy2Sit1QQ4x3Dng8qDlSsZEet7g5Pq06MvTgw==}
+ engines: {node: '>=20'}
+
+ commander@2.20.3:
+ resolution: {integrity: sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ==}
+
+ commander@8.3.0:
+ resolution: {integrity: sha512-OkTL9umf+He2DZkUq8f8J9of7yL6RJKI24dVITBmNfZBmri9zYZQrKkuXiKhyfPSu8tUhnVBB1iKXevvnlR4Ww==}
+ engines: {node: '>= 12'}
+
+ comment-parser@1.4.6:
+ resolution: {integrity: sha512-ObxuY6vnbWTN6Od72xfwN9DbzC7Y2vv8u1Soi9ahRKL37gb6y1qk6/dgjs+3JWuXJHWvsg3BXIwzd/rkmAwavg==}
+ engines: {node: '>= 12.0.0'}
+
+ commondir@1.0.1:
+ resolution: {integrity: sha512-W9pAhw0ja1Edb5GVdIF1mjZw/ASI0AlShXM83UUGe2DVr5TdAPEA1OA8m/g8zWp9x6On7gqufY+FatDbC3MDQg==}
+
+ compatx@0.2.0:
+ resolution: {integrity: sha512-6gLRNt4ygsi5NyMVhceOCFv14CIdDFN7fQjX1U4+47qVE/+kjPoXMK65KWK+dWxmFzMTuKazoQ9sch6pM0p5oA==}
+
+ compress-commons@6.0.2:
+ resolution: {integrity: sha512-6FqVXeETqWPoGcfzrXb37E50NP0LXT8kAMu5ooZayhWWdgEY4lBEEcbQNXtkuKQsGduxiIcI4gOTsxTmuq/bSg==}
+ engines: {node: '>= 14'}
+
+ concat-map@0.0.1:
+ resolution: {integrity: sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==}
+
+ confbox@0.1.8:
+ resolution: {integrity: sha512-RMtmw0iFkeR4YV+fUOSucriAQNb9g8zFR52MWCtl+cCZOFRNL6zeB395vPzFhEjjn4fMxXudmELnl/KF/WrK6w==}
+
+ confbox@0.2.4:
+ resolution: {integrity: sha512-ysOGlgTFbN2/Y6Cg3Iye8YKulHw+R2fNXHrgSmXISQdMnomY6eNDprVdW9R5xBguEqI954+S6709UyiO7B+6OQ==}
+
+ config-chain@1.1.13:
+ resolution: {integrity: sha512-qj+f8APARXHrM0hraqXYb2/bOVSV4PvJQlNZ/DVj0QrmNM2q2euizkeuVckQ57J+W0mRH6Hvi+k50M4Jul2VRQ==}
+
+ consola@3.4.2:
+ resolution: {integrity: sha512-5IKcdX0nnYavi6G7TtOhwkYzyjfJlatbjMjuLSfE2kYT5pMDOilZ4OvMhi637CcDICTmz3wARPoyhqyX1Y+XvA==}
+ engines: {node: ^14.18.0 || >=16.10.0}
+
+ constantinople@4.0.1:
+ resolution: {integrity: sha512-vCrqcSIq4//Gx74TXXCGnHpulY1dskqLTFGDmhrGxzeXL8lF8kvXv6mpNWlJj1uD4DW23D4ljAqbY4RRaaUZIw==}
+
+ convert-gitmoji@0.1.5:
+ resolution: {integrity: sha512-4wqOafJdk2tqZC++cjcbGcaJ13BZ3kwldf06PTiAQRAB76Z1KJwZNL1SaRZMi2w1FM9RYTgZ6QErS8NUl/GBmQ==}
+
+ convert-source-map@2.0.0:
+ resolution: {integrity: sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==}
+
+ cookie-es@1.2.3:
+ resolution: {integrity: sha512-lXVyvUvrNXblMqzIRrxHb57UUVmqsSWlxqt3XIjCkUP0wDAf6uicO6KMbEgYrMNtEvWgWHwe42CKxPu9MYAnWw==}
+
+ cookie-es@2.0.1:
+ resolution: {integrity: sha512-aVf4A4hI2w70LnF7GG+7xDQUkliwiXWXFvTjkip4+b64ygDQ2sJPRSKFDHbxn8o0xu9QzPkMuuiWIXyFSE2slA==}
+
+ cookie-es@3.1.1:
+ resolution: {integrity: sha512-UaXxwISYJPTr9hwQxMFYZ7kNhSXboMXP+Z3TRX6f1/NyaGPfuNUZOWP1pUEb75B2HjfklIYLVRfWiFZJyC6Npg==}
+
+ core-js-compat@3.49.0:
+ resolution: {integrity: sha512-VQXt1jr9cBz03b331DFDCCP90b3fanciLkgiOoy8SBHy06gNf+vQ1A3WFLqG7I8TipYIKeYK9wxd0tUrvHcOZA==}
+
+ core-util-is@1.0.3:
+ resolution: {integrity: sha512-ZQBvi1DcpJ4GDqanjucZ2Hj3wEO5pZDS89BWbkcrvdxksJorwUDDZamX9ldFkp9aw2lmBDLgkObEA4DWNJ9FYQ==}
+
+ cosmiconfig@8.3.6:
+ resolution: {integrity: sha512-kcZ6+W5QzcJ3P1Mt+83OUv/oHFqZHIx8DuxG6eZ5RGMERoLqp4BuGjhHLYGK+Kf5XVkQvqBSmAy/nGWN3qDgEA==}
+ engines: {node: '>=14'}
+ peerDependencies:
+ typescript: '>=4.9.5'
+ peerDependenciesMeta:
+ typescript:
+ optional: true
+
+ cosmiconfig@9.0.1:
+ resolution: {integrity: sha512-hr4ihw+DBqcvrsEDioRO31Z17x71pUYoNe/4h6Z0wB72p7MU7/9gH8Q3s12NFhHPfYBBOV3qyfUxmr/Yn3shnQ==}
+ engines: {node: '>=14'}
+ peerDependencies:
+ typescript: '>=4.9.5'
+ peerDependenciesMeta:
+ typescript:
+ optional: true
+
+ crc-32@1.2.2:
+ resolution: {integrity: sha512-ROmzCKrTnOwybPcJApAA6WBWij23HVfGVNKqqrZpuyZOHqK2CwHSvpGuyt/UNNvaIjEd8X5IFGp4Mh+Ie1IHJQ==}
+ engines: {node: '>=0.8'}
+ hasBin: true
+
+ crc32-stream@6.0.0:
+ resolution: {integrity: sha512-piICUB6ei4IlTv1+653yq5+KoqfBYmj9bw6LqXoOneTMDXk5nM1qt12mFW1caG3LlJXEKW1Bp0WggEmIfQB34g==}
+ engines: {node: '>= 14'}
+
+ croner@10.0.1:
+ resolution: {integrity: sha512-ixNtAJndqh173VQ4KodSdJEI6nuioBWI0V1ITNKhZZsO0pEMoDxz539T4FTTbSZ/xIOSuDnzxLVRqBVSvPNE2g==}
+ engines: {node: '>=18.0'}
+
+ cross-spawn@7.0.6:
+ resolution: {integrity: sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==}
+ engines: {node: '>= 8'}
+
+ crossws@0.3.5:
+ resolution: {integrity: sha512-ojKiDvcmByhwa8YYqbQI/hg7MEU0NC03+pSdEq4ZUnZR9xXpwk7E43SMNGkn+JxJGPFtNvQ48+vV2p+P1ml5PA==}
+
+ crossws@0.4.5:
+ resolution: {integrity: sha512-wUR89x/Rw7/8t+vn0CmGDYM9TD6VtARGb0LD5jq2wjtMy1vCP4M+sm6N6TigWeTYvnA8MoW29NqqXD0ep0rfBA==}
+ peerDependencies:
+ srvx: '>=0.11.5'
+ peerDependenciesMeta:
+ srvx:
+ optional: true
+
+ css-declaration-sorter@7.4.0:
+ resolution: {integrity: sha512-LTuzjPoyA2vMGKKcaOqKSp7Ub2eGrNfKiZH4LpezxpNrsICGCSFvsQOI29psISxNZtaXibkC2CXzrQ5enMeGGw==}
+ engines: {node: ^14 || ^16 || >=18}
+ peerDependencies:
+ postcss: ^8.0.9
+
+ css-loader@7.1.4:
+ resolution: {integrity: sha512-vv3J9tlOl04WjiMvHQI/9tmIrCxVrj6PFbHemBB1iihpeRbi/I4h033eoFIhwxBBqLhI0KYFS7yvynBFhIZfTw==}
+ engines: {node: '>= 18.12.0'}
+ peerDependencies:
+ '@rspack/core': 0.x || ^1.0.0 || ^2.0.0-0
+ webpack: ^5.27.0
+ peerDependenciesMeta:
+ '@rspack/core':
+ optional: true
+ webpack:
+ optional: true
+
+ css-minimizer-webpack-plugin@8.0.0:
+ resolution: {integrity: sha512-9bEpzHs8gEq6/cbEj418jXL/YWjBUD2YTLLk905Npt2JODqnRITin0+So5Vx4Dp5vyi2Lpt9pp2QHzQ7fdxNrw==}
+ engines: {node: '>= 20.9.0'}
+ peerDependencies:
+ '@parcel/css': '*'
+ '@swc/css': '*'
+ clean-css: '*'
+ csso: '*'
+ esbuild: '*'
+ lightningcss: '*'
+ webpack: ^5.0.0
+ peerDependenciesMeta:
+ '@parcel/css':
+ optional: true
+ '@swc/css':
+ optional: true
+ clean-css:
+ optional: true
+ csso:
+ optional: true
+ esbuild:
+ optional: true
+ lightningcss:
+ optional: true
+
+ css-select@5.2.2:
+ resolution: {integrity: sha512-TizTzUddG/xYLA3NXodFM0fSbNizXjOKhqiQQwvhlspadZokn1KDy0NZFS0wuEubIYAV5/c1/lAr0TaaFXEXzw==}
+
+ css-select@6.0.0:
+ resolution: {integrity: sha512-rZZVSLle8v0+EY8QAkDWrKhpgt6SA5OtHsgBnsj6ZaLb5dmDVOWUDtQitd9ydxxvEjhewNudS6eTVU7uOyzvXw==}
+
+ css-tree@2.2.1:
+ resolution: {integrity: sha512-OA0mILzGc1kCOCSJerOeqDxDQ4HOh+G8NbOJFOTgOCzpw7fCBubk0fEyxp8AgOL/jvLgYA/uV0cMbe43ElF1JA==}
+ engines: {node: ^10 || ^12.20.0 || ^14.13.0 || >=15.0.0, npm: '>=7.0.0'}
+
+ css-tree@3.2.1:
+ resolution: {integrity: sha512-X7sjQzceUhu1u7Y/ylrRZFU2FS6LRiFVp6rKLPg23y3x3c3DOKAwuXGDp+PAGjh6CSnCjYeAul8pcT8bAl+lSA==}
+ engines: {node: ^10 || ^12.20.0 || ^14.13.0 || >=15.0.0}
+
+ css-what@6.2.2:
+ resolution: {integrity: sha512-u/O3vwbptzhMs3L1fQE82ZSLHQQfto5gyZzwteVIEyeaY5Fc7R4dapF/BvRoSYFeqfBk4m0V1Vafq5Pjv25wvA==}
+ engines: {node: '>= 6'}
+
+ css-what@7.0.0:
+ resolution: {integrity: sha512-wD5oz5xibMOPHzy13CyGmogB3phdvcDaB5t0W/Nr5Z2O/agcB8YwOz6e2Lsp10pNDzBoDO9nVa3RGs/2BttpHQ==}
+ engines: {node: '>= 6'}
+
+ cssesc@3.0.0:
+ resolution: {integrity: sha512-/Tb/JcjK111nNScGob5MNtsntNM1aCNUDipB/TkwZFhyDrrE47SOx/18wF2bbjgc3ZzCSKW1T5nt5EbFoAz/Vg==}
+ engines: {node: '>=4'}
+ hasBin: true
+
+ cssnano-preset-default@7.0.17:
+ resolution: {integrity: sha512-11qO63A+czwguQFJCaTdICvbaxn0pJzz/XghLlv+OT7WyToDxAMR0Xb3/26/l0y0hQJywwNbj/SLSQlGBHE1OA==}
+ engines: {node: ^18.12.0 || ^20.9.0 || >=22.0}
+ peerDependencies:
+ postcss: ^8.5.13
+
+ cssnano-preset-default@8.0.1:
+ resolution: {integrity: sha512-OTdKeYMlvQ8KBgyej5ysktnWJoeyo7rGrVnm+bdpIHGvxhbTGPsOkB+7T1EdTuX00dGlQQb2UEbSPB1OpMXULw==}
+ engines: {node: ^22.11.0 || ^24.11.0 || >=26.0}
+ peerDependencies:
+ postcss: ^8.5.14
+
+ cssnano-utils@5.0.3:
+ resolution: {integrity: sha512-ynIREMICLxkxm7e9bCR9sh75s4Q5drICi0ua1yxo5jH2XPBqSKkl4dOh4EbFqtUmnTMhRffHgYL0EKKkMjtJTg==}
+ engines: {node: ^18.12.0 || ^20.9.0 || >=22.0}
+ peerDependencies:
+ postcss: ^8.5.13
+
+ cssnano-utils@6.0.0:
+ resolution: {integrity: sha512-ztS9W/+uaDn+bkYmDhs+GdMveHJ3CL8IPNHpRqDUQXv5GJOTQAJjV1XUOInr9esLXSabQV1pLRZlJpyUwEqDyQ==}
+ engines: {node: ^22.11.0 || ^24.11.0 || >=26.0}
+ peerDependencies:
+ postcss: ^8.5.14
+
+ cssnano@7.1.9:
+ resolution: {integrity: sha512-uPR75+5Dk/WJ/YSPR1/YDHdwMM9c5FsaARljfKWgeCKLKOtJ0we21xy/RcCjn53fZnD/f6yYEIZ8pu18+GnbNQ==}
+ engines: {node: ^18.12.0 || ^20.9.0 || >=22.0}
+ peerDependencies:
+ postcss: ^8.5.13
+
+ cssnano@8.0.1:
+ resolution: {integrity: sha512-oSiOnPQNNYjusTUlYJiE6xvFQG4don3N0QavaoV1BxIsC1zjvxOwikXlR7lG1EVmZNDDaJkHbQx1VRB8kaoMHA==}
+ engines: {node: ^22.11.0 || ^24.11.0 || >=26.0}
+ peerDependencies:
+ postcss: ^8.5.14
+
+ csso@5.0.5:
+ resolution: {integrity: sha512-0LrrStPOdJj+SPCCrGhzryycLjwcgUSHBtxNA8aIDxf0GLsRh1cKYhB00Gd1lDOS4yGH69+SNn13+TWbVHETFQ==}
+ engines: {node: ^10 || ^12.20.0 || ^14.13.0 || >=15.0.0, npm: '>=7.0.0'}
+
+ csstype@3.2.3:
+ resolution: {integrity: sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==}
+
+ cuint@0.2.2:
+ resolution: {integrity: sha512-d4ZVpCW31eWwCMe1YT3ur7mUDnTXbgwyzaL320DrcRT45rfjYxkt5QWLrmOJ+/UEAI2+fQgKe/fCjR8l4TpRgw==}
+
+ d3-path@3.1.0:
+ resolution: {integrity: sha512-p3KP5HCf/bvjBSSKuXid6Zqijx7wIfNW+J/maPs+iwR35at5JCbLUT0LzF1cnjbCHWhqzQTIN2Jpe8pRebIEFQ==}
+ engines: {node: '>=12'}
+
+ d3-shape@3.2.0:
+ resolution: {integrity: sha512-SaLBuwGm3MOViRq2ABk3eLoxwZELpH6zhl3FbAoJ7Vm1gofKx6El1Ib5z23NUEhF9AsGl7y+dzLe5Cw2AArGTA==}
+ engines: {node: '>=12'}
+
+ db0@0.3.4:
+ resolution: {integrity: sha512-RiXXi4WaNzPTHEOu8UPQKMooIbqOEyqA1t7Z6MsdxSCeb8iUC9ko3LcmsLmeUt2SM5bctfArZKkRQggKZz7JNw==}
+ peerDependencies:
+ '@electric-sql/pglite': '*'
+ '@libsql/client': '*'
+ better-sqlite3: '*'
+ drizzle-orm: '*'
+ mysql2: '*'
+ sqlite3: '*'
+ peerDependenciesMeta:
+ '@electric-sql/pglite':
+ optional: true
+ '@libsql/client':
+ optional: true
+ better-sqlite3:
+ optional: true
+ drizzle-orm:
+ optional: true
+ mysql2:
+ optional: true
+ sqlite3:
+ optional: true
+
+ debug@4.4.3:
+ resolution: {integrity: sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==}
+ engines: {node: '>=6.0'}
+ peerDependencies:
+ supports-color: '*'
+ peerDependenciesMeta:
+ supports-color:
+ optional: true
+
+ decode-named-character-reference@1.3.0:
+ resolution: {integrity: sha512-GtpQYB283KrPp6nRw50q3U9/VfOutZOe103qlN7BPP6Ad27xYnOIWv4lPzo8HCAL+mMZofJ9KEy30fq6MfaK6Q==}
+
+ deep-equal@2.2.3:
+ resolution: {integrity: sha512-ZIwpnevOurS8bpT4192sqAowWM76JDKSHYzMLty3BZGSswgq6pBaH3DhCSW5xVAZICZyKdOBPjwww5wfgT/6PA==}
+ engines: {node: '>= 0.4'}
+
+ deep-extend@0.6.0:
+ resolution: {integrity: sha512-LOHxIOaPYdHlJRtCQfDIVZtfw/ufM8+rVj649RIHzcm/vGwQRXFt6OPqIFWsm2XEMrNIEtWR64sY1LEKD2vAOA==}
+ engines: {node: '>=4.0.0'}
+
+ deep-is@0.1.4:
+ resolution: {integrity: sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==}
+
+ deepmerge@4.3.1:
+ resolution: {integrity: sha512-3sUqbMEc77XqpdNO7FRyRog+eW3ph+GYCbj+rK+uYyRMuwsVy0rMiVtPn+QJlKFvWP/1PYpapqYn0Me2knFn+A==}
+ engines: {node: '>=0.10.0'}
+
+ default-browser-id@5.0.1:
+ resolution: {integrity: sha512-x1VCxdX4t+8wVfd1so/9w+vQ4vx7lKd2Qp5tDRutErwmR85OgmfX7RlLRMWafRMY7hbEiXIbudNrjOAPa/hL8Q==}
+ engines: {node: '>=18'}
+
+ default-browser@5.5.0:
+ resolution: {integrity: sha512-H9LMLr5zwIbSxrmvikGuI/5KGhZ8E2zH3stkMgM5LpOWDutGM2JZaj460Udnf1a+946zc7YBgrqEWwbk7zHvGw==}
+ engines: {node: '>=18'}
+
+ define-data-property@1.1.4:
+ resolution: {integrity: sha512-rBMvIzlpA8v6E+SJZoo++HAYqsLrkg7MSfIinMPFhmkorw7X+dOXVJQs+QT69zGkzMyfDnIMN2Wid1+NbL3T+A==}
+ engines: {node: '>= 0.4'}
+
+ define-lazy-prop@3.0.0:
+ resolution: {integrity: sha512-N+MeXYoqr3pOgn8xfyRPREN7gHakLYjhsHhWGT3fWAiL4IkAt0iDw14QiiEm2bE30c5XX5q0FtAA3CK5f9/BUg==}
+ engines: {node: '>=12'}
+
+ define-properties@1.2.1:
+ resolution: {integrity: sha512-8QmQKqEASLd5nx0U1B1okLElbUuuttJ/AnYmRXbbbGDWh6uS208EjD4Xqq/I9wK7u0v6O08XhTWnt5XtEbR6Dg==}
+ engines: {node: '>= 0.4'}
+
+ defu@6.1.7:
+ resolution: {integrity: sha512-7z22QmUWiQ/2d0KkdYmANbRUVABpZ9SNYyH5vx6PZ+nE5bcC0l7uFvEfHlyld/HcGBFTL536ClDt3DEcSlEJAQ==}
+
+ delayed-stream@1.0.0:
+ resolution: {integrity: sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==}
+ engines: {node: '>=0.4.0'}
+
+ denque@2.1.0:
+ resolution: {integrity: sha512-HVQE3AAb/pxF8fQAoiqpvg9i3evqug3hoiwakOyZAwJm+6vZehbkYXZ0l4JxS+I3QxM97v5aaRNhj8v5oBhekw==}
+ engines: {node: '>=0.10'}
+
+ depd@2.0.0:
+ resolution: {integrity: sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==}
+ engines: {node: '>= 0.8'}
+
+ dequal@2.0.3:
+ resolution: {integrity: sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA==}
+ engines: {node: '>=6'}
+
+ destr@2.0.5:
+ resolution: {integrity: sha512-ugFTXCtDZunbzasqBxrK93Ik/DRYsO6S/fedkWEMKqt04xZ4csmnmwGDBAb07QWNaGMAmnTIemsYZCksjATwsA==}
+
+ detab@3.0.2:
+ resolution: {integrity: sha512-7Bp16Bk8sk0Y6gdXiCtnpGbghn8atnTJdd/82aWvS5ESnlcNvgUc10U2NYS0PAiDSGjWiI8qs/Cv1b2uSGdQ8w==}
+
+ detect-libc@2.1.2:
+ resolution: {integrity: sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==}
+ engines: {node: '>=8'}
+
+ devalue@5.8.1:
+ resolution: {integrity: sha512-4CXDYRBGqN+57wVJkuXBYmpAVUSg3L6JAQa/DFqm238G73E1wuyc/JhGQJzN7vUf/CMphYau2zXbfWzDR5aTEw==}
+
+ devframe@0.2.2:
+ resolution: {integrity: sha512-nB5xJR0XREJSVD7Me7j9UUY1NIpPlBGYI/b6EMigeoVPaUv7/RwKf/uyc/94P00yMMxQzSMy/94NzWemDd70SQ==}
+ peerDependencies:
+ '@modelcontextprotocol/sdk': ^1.0.0
+ peerDependenciesMeta:
+ '@modelcontextprotocol/sdk':
+ optional: true
+
+ devlop@1.1.0:
+ resolution: {integrity: sha512-RWmIqhcFf1lRYBvNmr7qTNuyCt/7/ns2jbpp1+PalgE/rDQcBT0fioSMUpJ93irlUhC5hrg4cYqe6U+0ImW0rA==}
+
+ diff@9.0.0:
+ resolution: {integrity: sha512-svtcdpS8CgJyqAjEQIXdb3OjhFVVYjzGAPO8WGCmRbrml64SPw/jJD4GoE98aR7r25A0XcgrK3F02yw9R/vhQw==}
+ engines: {node: '>=0.3.1'}
+
+ doctypes@1.1.0:
+ resolution: {integrity: sha512-LLBi6pEqS6Do3EKQ3J0NqHWV5hhb78Pi8vvESYwyOy2c31ZEZVdtitdzsQsKb7878PEERhzUk0ftqGhG6Mz+pQ==}
+
+ dom-accessibility-api@0.5.16:
+ resolution: {integrity: sha512-X7BJ2yElsnOJ30pZF4uIIDfBEVgF4XEBxL9Bxhy6dnrm5hkzqmsWHGTiHqRiITNhMyFLyAiWndIJP7Z1NTteDg==}
+
+ dom-serializer@1.4.1:
+ resolution: {integrity: sha512-VHwB3KfrcOOkelEG2ZOfxqLZdfkil8PtJi4P8N2MMXucZq2yLp75ClViUlOVwyoHEDjYU433Aq+5zWP61+RGag==}
+
+ dom-serializer@2.0.0:
+ resolution: {integrity: sha512-wIkAryiqt/nV5EQKqQpo3SToSOV9J0DnbJqwK7Wv/Trc92zIAYZ4FlMu+JPFW1DfGFt81ZTCGgDEabffXeLyJg==}
+
+ domelementtype@2.3.0:
+ resolution: {integrity: sha512-OLETBj6w0OsagBwdXnPdN0cnMfF9opN69co+7ZrbfPGrdpPVNBUj02spi6B1N7wChLQiPn4CSH/zJvXw56gmHw==}
+
+ domhandler@4.3.1:
+ resolution: {integrity: sha512-GrwoxYN+uWlzO8uhUXRl0P+kHE4GtVPfYzVLcUxPL7KNdHKj66vvlhiweIHqYYXWlw+T8iLMp42Lm67ghw4WMQ==}
+ engines: {node: '>= 4'}
+
+ domhandler@5.0.3:
+ resolution: {integrity: sha512-cgwlv/1iFQiFnU96XXgROh8xTeetsnJiDsTc7TYCLFd9+/WNkIqPTxiM/8pSd8VIrhXGTf1Ny1q1hquVqDJB5w==}
+ engines: {node: '>= 4'}
+
+ domutils@2.8.0:
+ resolution: {integrity: sha512-w96Cjofp72M5IIhpjgobBimYEfoPjx1Vx0BSX9P30WBdZW2WIKU0T1Bd0kz2eNZ9ikjKgHbEyKx8BB6H1L3h3A==}
+
+ domutils@3.2.2:
+ resolution: {integrity: sha512-6kZKyUajlDuqlHKVX1w7gyslj9MPIXzIFiz/rGu35uC1wMi+kMhQwGhl4lt9unC9Vb9INnY9Z3/ZA3+FhASLaw==}
+
+ dot-prop@10.1.0:
+ resolution: {integrity: sha512-MVUtAugQMOff5RnBy2d9N31iG0lNwg1qAoAOn7pOK5wf94WIaE3My2p3uwTQuvS2AcqchkcR3bHByjaM0mmi7Q==}
+ engines: {node: '>=20'}
+
+ dotenv@17.4.2:
+ resolution: {integrity: sha512-nI4U3TottKAcAD9LLud4Cb7b2QztQMUEfHbvhTH09bqXTxnSie8WnjPALV/WMCrJZ6UV/qHJ6L03OqO3LcdYZw==}
+ engines: {node: '>=12'}
+
+ dts-resolver@3.0.0:
+ resolution: {integrity: sha512-1T1f+z+4tl9XD+m+0HBgWoL/nm0bOIffyWaUuUSBlFg/86IWvfx+wjNaO/ybU0AJzG9/Mi5hBUgGV6zCmWEN7Q==}
+ engines: {node: ^22.18.0 || >=24.0.0}
+ peerDependencies:
+ oxc-resolver: '>=11.0.0'
+ peerDependenciesMeta:
+ oxc-resolver:
+ optional: true
+
+ dunder-proto@1.0.1:
+ resolution: {integrity: sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==}
+ engines: {node: '>= 0.4'}
+
+ duplexer@0.1.2:
+ resolution: {integrity: sha512-jtD6YG370ZCIi/9GTaJKQxWTZD045+4R4hTk/x1UyoqadyJ9x9CgSi1RlVDQF8U2sxLLSnFkCaMihqljHIWgMg==}
+
+ eastasianwidth@0.2.0:
+ resolution: {integrity: sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA==}
+
+ editorconfig@1.0.7:
+ resolution: {integrity: sha512-e0GOtq/aTQhVdNyDU9e02+wz9oDDM+SIOQxWME2QRjzRX5yyLAuHDE+0aE8vHb9XRC8XD37eO2u57+F09JqFhw==}
+ engines: {node: '>=14'}
+ hasBin: true
+
+ ee-first@1.1.1:
+ resolution: {integrity: sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==}
+
+ electron-to-chromium@1.5.361:
+ resolution: {integrity: sha512-Q6Hts7N9FnJc5LeGRINFvLhCI9xZmNtTDe5ZbcVezQz7cU4a8Aua3GH1b8J2XY8Al9PF+OCwYqhgsOOheMdvkA==}
+
+ emoji-regex@10.6.0:
+ resolution: {integrity: sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A==}
+
+ emoji-regex@8.0.0:
+ resolution: {integrity: sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==}
+
+ emoji-regex@9.2.2:
+ resolution: {integrity: sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==}
+
+ emojilib@2.4.0:
+ resolution: {integrity: sha512-5U0rVMU5Y2n2+ykNLQqMoqklN9ICBT/KsvC1Gz6vqHbz2AXXGkG+Pm5rMWk/8Vjrr/mY9985Hi8DYzn1F09Nyw==}
+
+ emojis-list@3.0.0:
+ resolution: {integrity: sha512-/kyM18EfinwXZbno9FyUGeFh87KC8HRQBQGildHZbEuRyWFOmv1U10o9BBp8XVZDVNNuQKyIGIu5ZYAAXJ0V2Q==}
+ engines: {node: '>= 4'}
+
+ emoticon@4.1.0:
+ resolution: {integrity: sha512-VWZfnxqwNcc51hIy/sbOdEem6D+cVtpPzEEtVAFdaas30+1dgkyaOQ4sQ6Bp0tOMqWO1v+HQfYaoodOkdhK6SQ==}
+
+ encodeurl@2.0.0:
+ resolution: {integrity: sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==}
+ engines: {node: '>= 0.8'}
+
+ enhanced-resolve@4.5.0:
+ resolution: {integrity: sha512-Nv9m36S/vxpsI+Hc4/ZGRs0n9mXqSWGGq49zxb/cJfPAQMbUtttJAlNPS4AQzaBdw/pKskw5bMbekT/Y7W/Wlg==}
+ engines: {node: '>=6.9.0'}
+
+ enhanced-resolve@5.22.0:
+ resolution: {integrity: sha512-xYcDWrpELkFzz9SpZ3PlI6Eu6eD93Yf0WLDRxikGhWJ3MAir2SNZTIVCVZqZ/NUyx8AdMc2gT9C0gPiw18kG+A==}
+ engines: {node: '>=10.13.0'}
+
+ entities@2.2.0:
+ resolution: {integrity: sha512-p92if5Nz619I0w+akJrLZH0MX0Pb5DX39XOwQTtXSdQQOaYH03S1uIQp4mhOZtAXrxq4ViO67YTiLBo2638o9A==}
+
+ entities@3.0.1:
+ resolution: {integrity: sha512-WiyBqoomrwMdFG1e0kqvASYfnlb0lp8M5o5Fw2OFq1hNZxxcNk8Ik0Xm7LxzBhuidnZB/UtBqVCgUz3kBOP51Q==}
+ engines: {node: '>=0.12'}
+
+ entities@4.5.0:
+ resolution: {integrity: sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw==}
+ engines: {node: '>=0.12'}
+
+ entities@6.0.1:
+ resolution: {integrity: sha512-aN97NXWF6AWBTahfVOIrB/NShkzi5H7F9r1s9mD3cDj4Ko5f2qhhVoYMibXF7GlLveb/D2ioWay8lxI97Ven3g==}
+ engines: {node: '>=0.12'}
+
+ entities@7.0.1:
+ resolution: {integrity: sha512-TWrgLOFUQTH994YUyl1yT4uyavY5nNB5muff+RtWaqNVCAK408b5ZnnbNAUEWLTCpum9w6arT70i1XdQ4UeOPA==}
+ engines: {node: '>=0.12'}
+
+ entities@8.0.0:
+ resolution: {integrity: sha512-zwfzJecQ/Uej6tusMqwAqU/6KL2XaB2VZ2Jg54Je6ahNBGNH6Ek6g3jjNCF0fG9EWQKGZNddNjU5F1ZQn/sBnA==}
+ engines: {node: '>=20.19.0'}
+
+ env-paths@2.2.1:
+ resolution: {integrity: sha512-+h1lkLKhZMTYjog1VEpJNG7NZJWcuc2DDk/qsqSTRRCOXiLjeQ1d1/udrUGhqMxUgAlwKNZ0cf2uqan5GLuS2A==}
+ engines: {node: '>=6'}
+
+ env-runner@0.1.9:
+ resolution: {integrity: sha512-W9AiZlPx0uXtghAJiTBkeZOgyQdecVvoln3cHoOEZswPq0cVMi+WBhUQjdUn+JcZFAFgOt+i5fcO7C2zniZoCg==}
+ hasBin: true
+ peerDependencies:
+ '@netlify/runtime': ^4.1.23
+ '@vercel/queue': ^0.2.0
+ miniflare: ^4.20260515.0
+ peerDependenciesMeta:
+ '@netlify/runtime':
+ optional: true
+ '@vercel/queue':
+ optional: true
+ miniflare:
+ optional: true
+
+ environment@1.1.0:
+ resolution: {integrity: sha512-xUtoPkMggbz0MPyPiIWr1Kp4aeWJjDZ6SMvURhimjdZgsRuDplF5/s9hcgGhyXMhs+6vpnuoiZ2kFiu3FMnS8Q==}
+ engines: {node: '>=18'}
+
+ errno@0.1.8:
+ resolution: {integrity: sha512-dJ6oBr5SQ1VSd9qkk7ByRgb/1SH4JZjCHSW/mr63/QcXO9zLVxvJ6Oy13nio03rxpSnVDDjFor75SjVeZWPW/A==}
+ hasBin: true
+
+ error-ex@1.3.4:
+ resolution: {integrity: sha512-sqQamAnR14VgCr1A618A3sGrygcpK+HEbenA/HiEAkkUwcZIIB/tgWqHFxWgOyDh4nB4JCRimh79dR5Ywc9MDQ==}
+
+ error-stack-parser-es@1.0.5:
+ resolution: {integrity: sha512-5qucVt2XcuGMcEGgWI7i+yZpmpByQ8J1lHhcL7PwqCwu9FPP3VUXzT4ltHe5i2z9dePwEHcDVOAfSnHsOlCXRA==}
+
+ error-stack-parser@2.1.4:
+ resolution: {integrity: sha512-Sk5V6wVazPhq5MhpO+AUxJn5x7XSXGl1R93Vn7i+zS15KDVxQijejNCrz8340/2bgLBjR9GtEG8ZVKONDjcqGQ==}
+
+ errx@0.1.0:
+ resolution: {integrity: sha512-fZmsRiDNv07K6s2KkKFTiD2aIvECa7++PKyD5NC32tpRw46qZA3sOz+aM+/V9V0GDHxVTKLziveV4JhzBHDp9Q==}
+
+ es-define-property@1.0.1:
+ resolution: {integrity: sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==}
+ engines: {node: '>= 0.4'}
+
+ es-errors@1.3.0:
+ resolution: {integrity: sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==}
+ engines: {node: '>= 0.4'}
+
+ es-get-iterator@1.1.3:
+ resolution: {integrity: sha512-sPZmqHBe6JIiTfN5q2pEi//TwxmAFHwj/XEuYjTuse78i8KxaqMTTzxPoFKuzRpDpTJ+0NAbpfenkmH2rePtuw==}
+
+ es-module-lexer@2.1.0:
+ resolution: {integrity: sha512-n27zTYMjYu1aj4MjCWzSP7G9r75utsaoc8m61weK+W8JMBGGQybd43GstCXZ3WNmSFtGT9wi59qQTW6mhTR5LQ==}
+
+ es-object-atoms@1.1.2:
+ resolution: {integrity: sha512-HWcBoN6NileqtSydK2FqHbS/LoDd2pqrnQHLyJzBj4kOp/ky2MWMN694xOfkK8/SnUsW2DH7EfyVlydKCsm1Zw==}
+ engines: {node: '>= 0.4'}
+
+ es-set-tostringtag@2.1.0:
+ resolution: {integrity: sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==}
+ engines: {node: '>= 0.4'}
+
+ esbuild-loader@4.4.3:
+ resolution: {integrity: sha512-Wpui03EzqC151xFteKlgJQhbyZl5CgnBpUHXVuao02nItULlkaTeiLdEMPTmR2zdwpEBWkXVNoT5dDOYJluUzg==}
+ peerDependencies:
+ webpack: ^4.40.0 || ^5.0.0
+
+ esbuild@0.25.12:
+ resolution: {integrity: sha512-bbPBYYrtZbkt6Os6FiTLCTFxvq4tt3JKall1vRwshA3fdVztsLAatFaZobhkBC8/BrPetoa0oksYoKXoG4ryJg==}
+ engines: {node: '>=18'}
+ hasBin: true
+
+ esbuild@0.27.7:
+ resolution: {integrity: sha512-IxpibTjyVnmrIQo5aqNpCgoACA/dTKLTlhMHihVHhdkxKyPO1uBBthumT0rdHmcsk9uMonIWS0m4FljWzILh3w==}
+ engines: {node: '>=18'}
+ hasBin: true
+
+ esbuild@0.28.0:
+ resolution: {integrity: sha512-sNR9MHpXSUV/XB4zmsFKN+QgVG82Cc7+/aaxJ8Adi8hyOac+EXptIp45QBPaVyX3N70664wRbTcLTOemCAnyqw==}
+ engines: {node: '>=18'}
+ hasBin: true
+
+ escalade@3.2.0:
+ resolution: {integrity: sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==}
+ engines: {node: '>=6'}
+
+ escape-html@1.0.3:
+ resolution: {integrity: sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==}
+
+ escape-string-regexp@1.0.5:
+ resolution: {integrity: sha512-vbRorB5FUQWvla16U8R/qgaFIya2qGzwDrNmCZuYKrbdSUMG6I1ZCGQRefkRVhuOkIGVne7BQ35DSfo1qvJqFg==}
+ engines: {node: '>=0.8.0'}
+
+ escape-string-regexp@4.0.0:
+ resolution: {integrity: sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==}
+ engines: {node: '>=10'}
+
+ escape-string-regexp@5.0.0:
+ resolution: {integrity: sha512-/veY75JbMK4j1yjvuUxuVsiS/hr/4iHs9FTT6cgTexxdE0Ly/glccBAkloH/DofkjRbZU3bnoj38mOmhkZ0lHw==}
+ engines: {node: '>=12'}
+
+ eslint-config-flat-gitignore@2.3.0:
+ resolution: {integrity: sha512-bg4ZLGgoARg1naWfsINUUb/52Ksw/K22K+T16D38Y8v+/sGwwIYrGvH/JBjOin+RQtxxC9tzNNiy4shnGtGyyQ==}
+ peerDependencies:
+ eslint: ^9.5.0 || ^10.0.0
+
+ eslint-flat-config-utils@3.2.0:
+ resolution: {integrity: sha512-PHgo1X5uqIorJONLVD9BIaOSdoYFD3z/AeJljdqDPlWVRpeCYkDbK9k0AXoYVqqNJr6FEYIEr5Rm2TSktLQcHw==}
+
+ eslint-import-context@0.1.9:
+ resolution: {integrity: sha512-K9Hb+yRaGAGUbwjhFNHvSmmkZs9+zbuoe3kFQ4V1wYjrepUFYM2dZAfNtjbbj3qsPfUfsA68Bx/ICWQMi+C8Eg==}
+ engines: {node: ^12.20.0 || ^14.18.0 || >=16.0.0}
+ peerDependencies:
+ unrs-resolver: ^1.0.0
+ peerDependenciesMeta:
+ unrs-resolver:
+ optional: true
+
+ eslint-merge-processors@2.0.0:
+ resolution: {integrity: sha512-sUuhSf3IrJdGooquEUB5TNpGNpBoQccbnaLHsb1XkBLUPPqCNivCpY05ZcpCOiV9uHwO2yxXEWVczVclzMxYlA==}
+ peerDependencies:
+ eslint: '*'
+
+ eslint-plugin-import-lite@0.5.2:
+ resolution: {integrity: sha512-XvfdWOC5dSLEI9krIPRlNmKSI2ViIE9pVylzfV9fCq0ZpDaNeUk6o0wZv0OzN83QdadgXp1NsY0qjLINxwYCsw==}
+ engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+ peerDependencies:
+ eslint: '>=9.0.0'
+
+ eslint-plugin-import-x@4.16.2:
+ resolution: {integrity: sha512-rM9K8UBHcWKpzQzStn1YRN2T5NvdeIfSVoKu/lKF41znQXHAUcBbYXe5wd6GNjZjTrP7viQ49n1D83x/2gYgIw==}
+ engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+ peerDependencies:
+ '@typescript-eslint/utils': ^8.56.0
+ eslint: ^8.57.0 || ^9.0.0 || ^10.0.0
+ eslint-import-resolver-node: '*'
+ peerDependenciesMeta:
+ '@typescript-eslint/utils':
+ optional: true
+ eslint-import-resolver-node:
+ optional: true
+
+ eslint-plugin-jsdoc@62.9.0:
+ resolution: {integrity: sha512-PY7/X4jrVgoIDncUmITlUqK546Ltmx/Pd4Hdsu4CvSjryQZJI2mEV4vrdMufyTetMiZ5taNSqvK//BTgVUlNkA==}
+ engines: {node: ^20.19.0 || ^22.13.0 || >=24}
+ peerDependencies:
+ eslint: ^7.0.0 || ^8.0.0 || ^9.0.0 || ^10.0.0
+
+ eslint-plugin-no-only-tests@3.4.0:
+ resolution: {integrity: sha512-4S3/9Nb7A2tiMcpzEQE9bQSlpeOz6WJkgryBuou/SA8W2x2c8Zf4j0NvTKBjv6qNhF9T79tmkecm/0CHqV0UGg==}
+ engines: {node: '>=5.0.0'}
+
+ eslint-plugin-perfectionist@5.9.0:
+ resolution: {integrity: sha512-8TWzg02zmnBdZwCkWLi8jhzqXI+fE7Z/RwV8SL6xD45tJ8Bp3wGuYL2XtQgfe/Wd0eBqOUX+s6ey73IyszvKTA==}
+ engines: {node: ^20.0.0 || >=22.0.0}
+ peerDependencies:
+ eslint: ^8.45.0 || ^9.0.0 || ^10.0.0
+
+ eslint-plugin-regexp@3.1.0:
+ resolution: {integrity: sha512-qGXIC3DIKZHcK1H9A9+Byz9gmndY6TTSRkSMTZpNXdyCw2ObSehRgccJv35n9AdUakEjQp5VFNLas6BMXizCZg==}
+ engines: {node: ^20.19.0 || ^22.13.0 || >=24}
+ peerDependencies:
+ eslint: '>=9.38.0'
+
+ eslint-plugin-unicorn@63.0.0:
+ resolution: {integrity: sha512-Iqecl9118uQEXYh7adylgEmGfkn5es3/mlQTLLkd4pXkIk9CTGrAbeUux+YljSa2ohXCBmQQ0+Ej1kZaFgcfkA==}
+ engines: {node: ^20.10.0 || >=21.0.0}
+ peerDependencies:
+ eslint: '>=9.38.0'
+
+ eslint-plugin-vue@10.9.1:
+ resolution: {integrity: sha512-cHB0Tf4Duvzwecwd/AqWzZvF/QszE13BhjVUpVXWCy9AeMR5GjkAjP3i85vqgLgOuTmkHR1OJ5oMeqLHtuw8zg==}
+ engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+ peerDependencies:
+ '@stylistic/eslint-plugin': ^2.0.0 || ^3.0.0 || ^4.0.0 || ^5.0.0
+ '@typescript-eslint/parser': ^7.0.0 || ^8.0.0
+ eslint: ^8.57.0 || ^9.0.0 || ^10.0.0
+ vue-eslint-parser: ^10.3.0
+ peerDependenciesMeta:
+ '@stylistic/eslint-plugin':
+ optional: true
+ '@typescript-eslint/parser':
+ optional: true
+
+ eslint-processor-vue-blocks@2.0.0:
+ resolution: {integrity: sha512-u4W0CJwGoWY3bjXAuFpc/b6eK3NQEI8MoeW7ritKj3G3z/WtHrKjkqf+wk8mPEy5rlMGS+k6AZYOw2XBoN/02Q==}
+ peerDependencies:
+ '@vue/compiler-sfc': ^3.3.0
+ eslint: '>=9.0.0'
+
+ eslint-scope@5.1.1:
+ resolution: {integrity: sha512-2NxwbF/hZ0KpepYN0cNbo+FN6XoK7GaHlQhgx/hIZl6Va0bF45RQOOwhLIy8lQDbuCiadSLCBnH2CFYquit5bw==}
+ engines: {node: '>=8.0.0'}
+
+ eslint-scope@8.4.0:
+ resolution: {integrity: sha512-sNXOfKCn74rt8RICKMvJS7XKV/Xk9kA7DyJr8mJik3S7Cwgy3qlkkmyS2uQB3jiJg6VNdZd/pDBJu0nvG2NlTg==}
+ engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+
+ eslint-scope@9.1.2:
+ resolution: {integrity: sha512-xS90H51cKw0jltxmvmHy2Iai1LIqrfbw57b79w/J7MfvDfkIkFZ+kj6zC3BjtUwh150HsSSdxXZcsuv72miDFQ==}
+ engines: {node: ^20.19.0 || ^22.13.0 || >=24}
+
+ eslint-typegen@2.3.1:
+ resolution: {integrity: sha512-zVdh8rThBvv2o5T/K524Fr5iy1Jo0q09rHL7y7FbOhgMB177T2gw+shxfC4ChCEqdq6/y6LJA4j8Fbr/Xls9aw==}
+ peerDependencies:
+ eslint: ^9.0.0 || ^10.0.0
+
+ eslint-visitor-keys@3.4.3:
+ resolution: {integrity: sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag==}
+ engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0}
+
+ eslint-visitor-keys@4.2.1:
+ resolution: {integrity: sha512-Uhdk5sfqcee/9H/rCOJikYz67o0a2Tw2hGRPOG2Y1R2dg7brRe1uG0yaNQDHu+TO/uQPF/5eCapvYSmHUjt7JQ==}
+ engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+
+ eslint-visitor-keys@5.0.1:
+ resolution: {integrity: sha512-tD40eHxA35h0PEIZNeIjkHoDR4YjjJp34biM0mDvplBe//mB+IHCqHDGV7pxF+7MklTvighcCPPZC7ynWyjdTA==}
+ engines: {node: ^20.19.0 || ^22.13.0 || >=24}
+
+ eslint@9.39.4:
+ resolution: {integrity: sha512-XoMjdBOwe/esVgEvLmNsD3IRHkm7fbKIUGvrleloJXUZgDHig2IPWNniv+GwjyJXzuNqVjlr5+4yVUZjycJwfQ==}
+ engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+ hasBin: true
+ peerDependencies:
+ jiti: '*'
+ peerDependenciesMeta:
+ jiti:
+ optional: true
+
+ espree@10.4.0:
+ resolution: {integrity: sha512-j6PAQ2uUr79PZhBjP5C5fhl8e39FmRnOjsD5lGnWrFU8i2G776tBK7+nP8KuQUTTyAZUwfQqXAgrVH5MbH9CYQ==}
+ engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+
+ espree@11.2.0:
+ resolution: {integrity: sha512-7p3DrVEIopW1B1avAGLuCSh1jubc01H2JHc8B4qqGblmg5gI9yumBgACjWo4JlIc04ufug4xJ3SQI8HkS/Rgzw==}
+ engines: {node: ^20.19.0 || ^22.13.0 || >=24}
+
+ esquery@1.7.0:
+ resolution: {integrity: sha512-Ap6G0WQwcU/LHsvLwON1fAQX9Zp0A2Y6Y/cJBl9r/JbW90Zyg4/zbG6zzKa2OTALELarYHmKu0GhpM5EO+7T0g==}
+ engines: {node: '>=0.10'}
+
+ esrecurse@4.3.0:
+ resolution: {integrity: sha512-KmfKL3b6G+RXvP8N1vr3Tq1kL/oCFgn2NYXEtqP8/L3pKapUA4G8cFVaoF3SU323CD4XypR/ffioHmkti6/Tag==}
+ engines: {node: '>=4.0'}
+
+ estraverse@4.3.0:
+ resolution: {integrity: sha512-39nnKffWz8xN1BU/2c79n9nB9HDzo0niYUqx6xyqUnyoAnQyyWpOTdZEeiCch8BBu515t4wp9ZmgVfVhn9EBpw==}
+ engines: {node: '>=4.0'}
+
+ estraverse@5.3.0:
+ resolution: {integrity: sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA==}
+ engines: {node: '>=4.0'}
+
+ estree-walker@2.0.2:
+ resolution: {integrity: sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==}
+
+ estree-walker@3.0.3:
+ resolution: {integrity: sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==}
+
+ esutils@2.0.3:
+ resolution: {integrity: sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==}
+ engines: {node: '>=0.10.0'}
+
+ etag@1.8.1:
+ resolution: {integrity: sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==}
+ engines: {node: '>= 0.6'}
+
+ event-target-shim@5.0.1:
+ resolution: {integrity: sha512-i/2XbnSz/uxRCU6+NdVJgKWDTM427+MqYbkQzD321DuCQJUqOuJKIA0IM2+W2xtYHdKOmZ4dR6fExsd4SXL+WQ==}
+ engines: {node: '>=6'}
+
+ events-universal@1.0.1:
+ resolution: {integrity: sha512-LUd5euvbMLpwOF8m6ivPCbhQeSiYVNb8Vs0fQ8QjXo0JTkEHpz8pxdQf0gStltaPpw0Cca8b39KxvK9cfKRiAw==}
+
+ events@3.3.0:
+ resolution: {integrity: sha512-mQw+2fkQbALzQ7V0MY0IqdnXNOeTtP4r0lN9z7AAawCXgqea7bDii20AYrIBrFd/Hx0M2Ocz6S111CaFkUcb0Q==}
+ engines: {node: '>=0.8.x'}
+
+ execa@8.0.1:
+ resolution: {integrity: sha512-VyhnebXciFV2DESc+p6B+y0LjSm0krU4OgJN44qFAhBY0TJ+1V61tYD2+wHusZ6F9n5K+vl8k0sTy7PEfV4qpg==}
+ engines: {node: '>=16.17'}
+
+ expect-type@1.3.0:
+ resolution: {integrity: sha512-knvyeauYhqjOYvQ66MznSMs83wmHrCycNEN6Ao+2AeYEfxUIkuiVxdEa1qlGEPK+We3n0THiDciYSsCcgW/DoA==}
+ engines: {node: '>=12.0.0'}
+
+ exsolve@1.0.8:
+ resolution: {integrity: sha512-LmDxfWXwcTArk8fUEnOfSZpHOJ6zOMUJKOtFLFqJLoKJetuQG874Uc7/Kki7zFLzYybmZhp1M7+98pfMqeX8yA==}
+
+ extend@3.0.2:
+ resolution: {integrity: sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g==}
+
+ fake-indexeddb@6.2.5:
+ resolution: {integrity: sha512-CGnyrvbhPlWYMngksqrSSUT1BAVP49dZocrHuK0SvtR0D5TMs5wP0o3j7jexDJW01KSadjBp1M/71o/KR3nD1w==}
+ engines: {node: '>=18'}
+
+ fast-deep-equal@3.1.3:
+ resolution: {integrity: sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==}
+
+ fast-fifo@1.3.2:
+ resolution: {integrity: sha512-/d9sfos4yxzpwkDkuN7k2SqFKtYNmCTzgfEpz82x34IM9/zc8KGxQoXg1liNC/izpRM/MBdt44Nmx41ZWqk+FQ==}
+
+ fast-glob@3.3.3:
+ resolution: {integrity: sha512-7MptL8U0cqcFdzIzwOTHoilX9x5BrNqye7Z/LuC7kCMRio1EMSyqRK3BEAUD7sXRq4iT4AzTVuZdhgQ2TCvYLg==}
+ engines: {node: '>=8.6.0'}
+
+ fast-json-stable-stringify@2.1.0:
+ resolution: {integrity: sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==}
+
+ fast-levenshtein@2.0.6:
+ resolution: {integrity: sha512-DCXu6Ifhqcks7TZKY3Hxp3y6qphY5SJZmrWMDrKcERSOXWQdMhU9Ig/PYrzyw/ul9jOIyh0N4M0tbC5hodg8dw==}
+
+ fast-npm-meta@1.5.1:
+ resolution: {integrity: sha512-tWhw7z4jFuQgZB9tbQyUh5BY9nNd/wimM+fBLfmmJjakkJDNvbJKm0nQ5ruPKC0us1HGg7L6iBk1fxpSzcgSaA==}
+ hasBin: true
+
+ fast-safe-stringify@2.1.1:
+ resolution: {integrity: sha512-W+KJc2dmILlPplD/H4K9l9LcAHAfPtP6BY84uVLXQ6Evcz9Lcg33Y2z1IVblT6xdY54PXYVHEv+0Wpq8Io6zkA==}
+
+ fast-string-truncated-width@1.2.1:
+ resolution: {integrity: sha512-Q9acT/+Uu3GwGj+5w/zsGuQjh9O1TyywhIwAxHudtWrgF09nHOPrvTLhQevPbttcxjr/SNN7mJmfOw/B1bXgow==}
+
+ fast-string-truncated-width@3.0.3:
+ resolution: {integrity: sha512-0jjjIEL6+0jag3l2XWWizO64/aZVtpiGE3t0Zgqxv0DPuxiMjvB3M24fCyhZUO4KomJQPj3LTSUnDP3GpdwC0g==}
+
+ fast-string-width@1.1.0:
+ resolution: {integrity: sha512-O3fwIVIH5gKB38QNbdg+3760ZmGz0SZMgvwJbA1b2TGXceKE6A2cOlfogh1iw8lr049zPyd7YADHy+B7U4W9bQ==}
+
+ fast-string-width@3.0.2:
+ resolution: {integrity: sha512-gX8LrtNEI5hq8DVUfRQMbr5lpaS4nMIWV+7XEbXk2b8kiQIizgnlr12B4dA3ZEx3308ze0O4Q1R+cHts8kyUJg==}
+
+ fast-uri@3.1.2:
+ resolution: {integrity: sha512-rVjf7ArG3LTk+FS6Yw81V1DLuZl1bRbNrev6Tmd/9RaroeeRRJhAt7jg/6YFxbvAQXUCavSoZhPPj6oOx+5KjQ==}
+
+ fast-wrap-ansi@0.1.6:
+ resolution: {integrity: sha512-HlUwET7a5gqjURj70D5jl7aC3Zmy4weA1SHUfM0JFI0Ptq987NH2TwbBFLoERhfwk+E+eaq4EK3jXoT+R3yp3w==}
+
+ fast-wrap-ansi@0.2.2:
+ resolution: {integrity: sha512-7F2Fl+TjRSenLqlU3UjSH0iyqopqoZIu7eZVpEirP2g1GtWa2G/ecEmBdgz31+Mxr+ELclgg6sokpSFIQiZ02Q==}
+
+ fastq@1.20.1:
+ resolution: {integrity: sha512-GGToxJ/w1x32s/D2EKND7kTil4n8OVk/9mycTc4VDza13lOvpUZTGX3mFSCtV9ksdGBVzvsyAVLM6mHFThxXxw==}
+
+ fault@2.0.1:
+ resolution: {integrity: sha512-WtySTkS4OKev5JtpHXnib4Gxiurzh5NCGvWrFaZ34m6JehfTUhKZvn9njTfw48t6JumVQOmrKqpmGcdwxnhqBQ==}
+
+ fd-package-json@2.0.0:
+ resolution: {integrity: sha512-jKmm9YtsNXN789RS/0mSzOC1NUq9mkVd65vbSSVsKdjGvYXBuE4oWe2QOEoFeRmJg+lPuZxpmrfFclNhoRMneQ==}
+
+ fdir@6.5.0:
+ resolution: {integrity: sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==}
+ engines: {node: '>=12.0.0'}
+ peerDependencies:
+ picomatch: ^3 || ^4
+ peerDependenciesMeta:
+ picomatch:
+ optional: true
+
+ fflate@0.8.3:
+ resolution: {integrity: sha512-tbZNuJrLwGUp3zshBtdy4W+ORxZuIh8a5ilyIEQDC5rY1f3U20JMry0Ll3WBzU58EZKsEuJFXhb5gwv8CsPvgA==}
+
+ file-entry-cache@8.0.0:
+ resolution: {integrity: sha512-XXTUwCvisa5oacNGRP9SfNtYBNAMi+RPwBFmblZEF7N7swHYQS6/Zfk7SRwx4D5j3CH211YNRco1DEMNVfZCnQ==}
+ engines: {node: '>=16.0.0'}
+
+ file-loader@6.2.0:
+ resolution: {integrity: sha512-qo3glqyTa61Ytg4u73GultjHGjdRyig3tG6lPtyX/jOEJvHif9uB0/OCI2Kif6ctF3caQTW2G5gym21oAsI4pw==}
+ engines: {node: '>= 10.13.0'}
+ peerDependencies:
+ webpack: ^4.0.0 || ^5.0.0
+
+ file-uri-to-path@1.0.0:
+ resolution: {integrity: sha512-0Zt+s3L7Vf1biwWZ29aARiVYLx7iMGnEUl9x33fbB/j3jR81u/O2LbqK+Bm1CDSNDKVtJ/YjwY7TUd5SkeLQLw==}
+
+ fill-range@7.1.1:
+ resolution: {integrity: sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==}
+ engines: {node: '>=8'}
+
+ find-up-simple@1.0.1:
+ resolution: {integrity: sha512-afd4O7zpqHeRyg4PfDQsXmlDe2PfdHtJt6Akt8jOWaApLOZk5JXs6VMR29lz03pRe9mpykrRCYIYxaJYcfpncQ==}
+ engines: {node: '>=18'}
+
+ find-up@5.0.0:
+ resolution: {integrity: sha512-78/PXT1wlLLDgTzDs7sjq9hzz0vXD+zn+7wypEe4fXQxCmdmqfGsEPQxmiCSQI3ajFV91bVSsvNtrJRiW6nGng==}
+ engines: {node: '>=10'}
+
+ find-up@6.3.0:
+ resolution: {integrity: sha512-v2ZsoEuVHYy8ZIlYqwPe/39Cy+cFDzp4dXPaxNvkEuouymu+2Jbz0PxpKarJHYJTmv2HWT3O382qY8l4jMWthw==}
+ engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0}
+
+ fix-dts-default-cjs-exports@1.0.1:
+ resolution: {integrity: sha512-pVIECanWFC61Hzl2+oOCtoJ3F17kglZC/6N94eRWycFgBH35hHx0Li604ZIzhseh97mf2p0cv7vVrOZGoqhlEg==}
+
+ flat-cache@4.0.1:
+ resolution: {integrity: sha512-f7ccFPK3SXFHpx15UIGyRJ/FJQctuKZ0zVuN3frBo4HnK3cay9VEW0R6yPYFHC0AgqhukPzKjq22t5DmAyqGyw==}
+ engines: {node: '>=16'}
+
+ flat@6.0.1:
+ resolution: {integrity: sha512-/3FfIa8mbrg3xE7+wAhWeV+bd7L2Mof+xtZb5dRDKZ+wDvYJK4WDYeIOuOhre5Yv5aQObZrlbRmk3RTSiuQBtw==}
+ engines: {node: '>=18'}
+ hasBin: true
+
+ flatted@3.4.2:
+ resolution: {integrity: sha512-PjDse7RzhcPkIJwy5t7KPWQSZ9cAbzQXcafsetQoD7sOJRQlGikNbx7yZp2OotDnJyrDcbyRq3Ttb18iYOqkxA==}
+
+ floating-vue@5.2.2:
+ resolution: {integrity: sha512-afW+h2CFafo+7Y9Lvw/xsqjaQlKLdJV7h1fCHfcYQ1C4SVMlu7OAekqWgu5d4SgvkBVU0pVpLlVsrSTBURFRkg==}
+ peerDependencies:
+ '@nuxt/kit': workspace:*
+ vue: 3.5.34
+ peerDependenciesMeta:
+ '@nuxt/kit':
+ optional: true
+
+ follow-redirects@1.16.0:
+ resolution: {integrity: sha512-y5rN/uOsadFT/JfYwhxRS5R7Qce+g3zG97+JrtFZlC9klX/W5hD7iiLzScI4nZqUS7DNUdhPgw4xI8W2LuXlUw==}
+ engines: {node: '>=4.0'}
+ peerDependencies:
+ debug: '*'
+ peerDependenciesMeta:
+ debug:
+ optional: true
+
+ for-each@0.3.5:
+ resolution: {integrity: sha512-dKx12eRCVIzqCxFGplyFKJMPvLEWgmNtUrpTiJIR5u97zEhRG8ySrtboPHZXx7daLxQVrl643cTzbab2tkQjxg==}
+ engines: {node: '>= 0.4'}
+
+ foreground-child@3.3.1:
+ resolution: {integrity: sha512-gIXjKqtFuWEgzFRJA9WCQeSJLZDjgJUOMCMzxtvFq/37KojM1BFGufqsCy0r4qSQmYLsZYMeyRqzIWOMup03sw==}
+ engines: {node: '>=14'}
+
+ fork-ts-checker-webpack-plugin@9.1.0:
+ resolution: {integrity: sha512-mpafl89VFPJmhnJ1ssH+8wmM2b50n+Rew5x42NeI2U78aRWgtkEtGmctp7iT16UjquJTjorEmIfESj3DxdW84Q==}
+ engines: {node: '>=14.21.3'}
+ peerDependencies:
+ typescript: '>3.6.0'
+ webpack: ^5.11.0
+
+ form-data@4.0.5:
+ resolution: {integrity: sha512-8RipRLol37bNs2bhoV67fiTEvdTrbMUYcFTiy3+wuuOnUog2QBHCZWXDRijWQfAkhBj2Uf5UnVaiWwA5vdd82w==}
+ engines: {node: '>= 6'}
+
+ format@0.2.2:
+ resolution: {integrity: sha512-wzsgA6WOq+09wrU1tsJ09udeR/YZRaeArL9e1wPbFg3GG2yDnC2ldKpxs4xunpFF9DgqCqOIra3bc1HWrJ37Ww==}
+ engines: {node: '>=0.4.x'}
+
+ formatly@0.3.0:
+ resolution: {integrity: sha512-9XNj/o4wrRFyhSMJOvsuyMwy8aUfBaZ1VrqHVfohyXf0Sw0e+yfKG+xZaY3arGCOMdwFsqObtzVOc1gU9KiT9w==}
+ engines: {node: '>=18.3.0'}
+ hasBin: true
+
+ fraction.js@5.3.4:
+ resolution: {integrity: sha512-1X1NTtiJphryn/uLQz3whtY6jK3fTqoE3ohKs0tT+Ujr1W59oopxmoEh7Lu5p6vBaPbgoM0bzveAW4Qi5RyWDQ==}
+
+ fresh@2.0.0:
+ resolution: {integrity: sha512-Rx/WycZ60HOaqLKAi6cHRKKI7zxWbJ31MhntmtwMoaTeF7XFH9hhBp8vITaMidfljRQ6eYWCKkaTK+ykVJHP2A==}
+ engines: {node: '>= 0.8'}
+
+ fs-extra@10.1.0:
+ resolution: {integrity: sha512-oRXApq54ETRj4eMiFzGnHWGy+zo5raudjuxN0b8H7s/RU2oW0Wvsx9O0ACRN/kRq9E8Vu/ReskGB5o3ji+FzHQ==}
+ engines: {node: '>=12'}
+
+ fs-monkey@1.1.0:
+ resolution: {integrity: sha512-QMUezzXWII9EV5aTFXW1UBVUO77wYPpjqIF8/AviUCThNeSYZykpoTixUeaNNBwmCev0AMDWMAni+f8Hxb1IFw==}
+
+ fsevents@2.3.2:
+ resolution: {integrity: sha512-xiqMQR4xAeHTuB9uWm+fFRcIOgKBMiOBP+eXiyT7jsgVCq1bkVygt00oASowB7EdtpOHaaPgKt812P9ab+DDKA==}
+ engines: {node: ^8.16.0 || ^10.6.0 || >=11.0.0}
+ os: [darwin]
+
+ fsevents@2.3.3:
+ resolution: {integrity: sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==}
+ engines: {node: ^8.16.0 || ^10.6.0 || >=11.0.0}
+ os: [darwin]
+
+ function-bind@1.1.2:
+ resolution: {integrity: sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==}
+
+ functions-have-names@1.2.3:
+ resolution: {integrity: sha512-xckBUXyTIqT97tq2x2AMb+g163b5JFysYk0x4qxNFwbfQkmNZoiRHb6sPzI9/QV33WeuvVYBUIiD4NzNIyqaRQ==}
+
+ fuse.js@7.3.0:
+ resolution: {integrity: sha512-plz8RVjfcDedTGfVngWH1jmJvBvAwi1v2jecfDerbEnMcmOYUEEwKFTHbNoCiYyzaK2Ws8lABkTCcRSqCY1q4w==}
+ engines: {node: '>=10'}
+
+ fzf@0.5.2:
+ resolution: {integrity: sha512-Tt4kuxLXFKHy8KT40zwsUPUkg1CrsgY25FxA2U/j/0WgEDCk3ddc/zLTCCcbSHX9FcKtLuVaDGtGE/STWC+j3Q==}
+
+ gensync@1.0.0-beta.2:
+ resolution: {integrity: sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==}
+ engines: {node: '>=6.9.0'}
+
+ get-caller-file@2.0.5:
+ resolution: {integrity: sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==}
+ engines: {node: 6.* || 8.* || >= 10.*}
+
+ get-east-asian-width@1.6.0:
+ resolution: {integrity: sha512-QRbvDIbx6YklUe6RxeTeleMR0yv3cYH6PsPZHcnVn7xv7zO1BHN8r0XETu8n6Ye3Q+ahtSarc3WgtNWmehIBfA==}
+ engines: {node: '>=18'}
+
+ get-intrinsic@1.3.0:
+ resolution: {integrity: sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==}
+ engines: {node: '>= 0.4'}
+
+ get-port-please@3.2.0:
+ resolution: {integrity: sha512-I9QVvBw5U/hw3RmWpYKRumUeaDgxTPd401x364rLmWBJcOQ753eov1eTgzDqRG9bqFIfDc7gfzcQEWrUri3o1A==}
+
+ get-proto@1.0.1:
+ resolution: {integrity: sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==}
+ engines: {node: '>= 0.4'}
+
+ get-stream@8.0.1:
+ resolution: {integrity: sha512-VaUJspBffn/LMCJVoMvSAdmscJyS1auj5Zulnn5UoYcY531UWmdwhRWkcGKnGU93m5HSXP9LP2usOryrBtQowA==}
+ engines: {node: '>=16'}
+
+ get-tsconfig@4.14.0:
+ resolution: {integrity: sha512-yTb+8DXzDREzgvYmh6s9vHsSVCHeC0G3PI5bEXNBHtmshPnO+S5O7qgLEOn0I5QvMy6kpZN8K1NKGyilLb93wA==}
+
+ get-tsconfig@5.0.0-beta.5:
+ resolution: {integrity: sha512-/6gFNr0N04nob252sTQxyFLi3eKFRqIg1I87YcqAMT1i6SQrSF6KujUEQrtrjMV0H/eejTCltLdDSTEMzHbnsQ==}
+ engines: {node: '>=20.20.0'}
+
+ giget@3.2.0:
+ resolution: {integrity: sha512-GvHTWcykIR/fP8cj8dMpuMMkvaeJfPvYnhq0oW+chSeIr+ldX21ifU2Ms6KBoyKZQZmVaUAAhQ2EZ68KJF8a7A==}
+ hasBin: true
+
+ github-slugger@2.0.0:
+ resolution: {integrity: sha512-IaOQ9puYtjrkq7Y0Ygl9KDZnrf/aiUJYUpVf89y8kyaxbRG7Y1SrX/jaumrv81vc61+kiMempujsM3Yw7w5qcw==}
+
+ glob-parent@5.1.2:
+ resolution: {integrity: sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==}
+ engines: {node: '>= 6'}
+
+ glob-parent@6.0.2:
+ resolution: {integrity: sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A==}
+ engines: {node: '>=10.13.0'}
+
+ glob-to-regex.js@1.2.0:
+ resolution: {integrity: sha512-QMwlOQKU/IzqMUOAZWubUOT8Qft+Y0KQWnX9nK3ch0CJg0tTp4TvGZsTfudYKv2NzoQSyPcnA6TYeIQ3jGichQ==}
+ engines: {node: '>=10.0'}
+ peerDependencies:
+ tslib: '2'
+
+ glob-to-regexp@0.4.1:
+ resolution: {integrity: sha512-lkX1HJXwyMcprw/5YUZc2s7DrpAiHB21/V+E1rHUrVNokkvB6bqMzT0VfV6/86ZNabt1k14YOIaT7nDvOX3Iiw==}
+
+ glob@10.5.0:
+ resolution: {integrity: sha512-DfXN8DfhJ7NH3Oe7cFmu3NCu1wKbkReJ8TorzSAFbSKrlNaQSKfIzqYqVY8zlbs2NLBbWpRiU52GX2PbaBVNkg==}
+ deprecated: Old versions of glob are not supported, and contain widely publicized security vulnerabilities, which have been fixed in the current version. Please update. Support for old versions may be purchased (at exorbitant rates) by contacting i@izs.me
+ hasBin: true
+
+ glob@13.0.6:
+ resolution: {integrity: sha512-Wjlyrolmm8uDpm/ogGyXZXb1Z+Ca2B8NbJwqBVg0axK9GbBeoS7yGV6vjXnYdGm6X53iehEuxxbyiKp8QmN4Vw==}
+ engines: {node: 18 || 20 || >=22}
+
+ globals@14.0.0:
+ resolution: {integrity: sha512-oahGvuMGQlPw/ivIYBjVSrWAfWLBeku5tpPE2fOPLi+WHffIWbuh2tCjhyQhTBPMf5E9jDEH4FOmTYgYwbKwtQ==}
+ engines: {node: '>=18'}
+
+ globals@16.5.0:
+ resolution: {integrity: sha512-c/c15i26VrJ4IRt5Z89DnIzCGDn9EcebibhAOjw5ibqEHsE1wLUgkPn9RDmNcUKyU87GeaL633nyJ+pplFR2ZQ==}
+ engines: {node: '>=18'}
+
+ globals@17.6.0:
+ resolution: {integrity: sha512-sepffkT8stwnIYbsMBpoCHJuJM5l98FUF2AnE07hfvE0m/qp3R586hw4jF4uadbhvg1ooIdzuu7CsfD2jzCaNA==}
+ engines: {node: '>=18'}
+
+ globby@16.2.0:
+ resolution: {integrity: sha512-QrJia2qDf5BB/V6HYlDTs0I0lBahyjLzpGQg3KT7FnCdTonAyPy2RtY802m2k4ALx6Dp752f82WsOczEVr3l6Q==}
+ engines: {node: '>=20'}
+
+ gopd@1.2.0:
+ resolution: {integrity: sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==}
+ engines: {node: '>= 0.4'}
+
+ graceful-fs@4.2.11:
+ resolution: {integrity: sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==}
+
+ gzip-size@6.0.0:
+ resolution: {integrity: sha512-ax7ZYomf6jqPTQ4+XCpUGyXKHk5WweS+e05MBO4/y3WJ5RkmPXNKvX+bx1behVILVwr6JSQvZAku021CHPXG3Q==}
+ engines: {node: '>=10'}
+
+ gzip-size@7.0.0:
+ resolution: {integrity: sha512-O1Ld7Dr+nqPnmGpdhzLmMTQ4vAsD+rHwMm1NLUmoUFFymBOMKxCCrtDxqdBRYXdeEPEi3SyoR4TizJLQrnKBNA==}
+ engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0}
+
+ h3@1.15.11:
+ resolution: {integrity: sha512-L3THSe2MPeBwgIZVSH5zLdBBU90TOxarvhK9d04IDY2AmVS8j2Jz2LIWtwsGOU3lu2I5jCN7FNvVfY2+XyF+mg==}
+
+ h3@2.0.1-rc.20:
+ resolution: {integrity: sha512-28ljodXuUp0fZovdiSRq4G9OgrxCztrJe5VdYzXAB7ueRvI7pIUqLU14Xi3XqdYJ/khXjfpUOOD2EQa6CmBgsg==}
+ engines: {node: '>=20.11.1'}
+ hasBin: true
+ peerDependencies:
+ crossws: ^0.4.1
+ peerDependenciesMeta:
+ crossws:
+ optional: true
+
+ h3@2.0.1-rc.22:
+ resolution: {integrity: sha512-Esv0DMIuPkCTSWCA0vO73vcTqwzH1wjSrAO1TXNu/K3up1sZHa9EKMapbmxCDYBeymC3fVTk4qxp7ogQWQ+KgA==}
+ engines: {node: '>=20.11.1'}
+ hasBin: true
+ peerDependencies:
+ crossws: ^0.4.1
+ peerDependenciesMeta:
+ crossws:
+ optional: true
+
+ happy-dom@20.9.0:
+ resolution: {integrity: sha512-GZZ9mKe8r646NUAf/zemnGbjYh4Bt8/MqASJY+pSm5ZDtc3YQox+4gsLI7yi1hba6o+eCsGxpHn5+iEVn31/FQ==}
+ engines: {node: '>=20.0.0'}
+
+ has-bigints@1.1.0:
+ resolution: {integrity: sha512-R3pbpkcIqv2Pm3dUwgjclDRVmWpTJW2DcMzcIhEXEx1oh/CEMObMm3KLmRJOdvhM7o4uQBnwr8pzRK2sJWIqfg==}
+ engines: {node: '>= 0.4'}
+
+ has-flag@3.0.0:
+ resolution: {integrity: sha512-sKJf1+ceQBr4SMkvQnBDNDtf4TXpVhVGateu0t918bl30FnbE2m4vNLX+VWe/dpjlb+HugGYzW7uQXH98HPEYw==}
+ engines: {node: '>=4'}
+
+ has-flag@4.0.0:
+ resolution: {integrity: sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==}
+ engines: {node: '>=8'}
+
+ has-property-descriptors@1.0.2:
+ resolution: {integrity: sha512-55JNKuIW+vq4Ke1BjOTjM2YctQIvCT7GFzHwmfZPGo5wnrgkid0YQtnAleFSqumZm4az3n2BS+erby5ipJdgrg==}
+
+ has-symbols@1.1.0:
+ resolution: {integrity: sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==}
+ engines: {node: '>= 0.4'}
+
+ has-tostringtag@1.0.2:
+ resolution: {integrity: sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==}
+ engines: {node: '>= 0.4'}
+
+ hash-sum@2.0.0:
+ resolution: {integrity: sha512-WdZTbAByD+pHfl/g9QSsBIIwy8IT+EsPiKDs0KNX+zSHhdDLFKdZu0BQHljvO+0QI/BasbMSUa8wYNCZTvhslg==}
+
+ hasown@2.0.3:
+ resolution: {integrity: sha512-ej4AhfhfL2Q2zpMmLo7U1Uv9+PyhIZpgQLGT1F9miIGmiCJIoCgSmczFdrc97mWT4kVY72KA+WnnhJ5pghSvSg==}
+ engines: {node: '>= 0.4'}
+
+ hast-util-embedded@3.0.0:
+ resolution: {integrity: sha512-naH8sld4Pe2ep03qqULEtvYr7EjrLK2QHY8KJR6RJkTUjPGObe1vnx585uzem2hGra+s1q08DZZpfgDVYRbaXA==}
+
+ hast-util-format@1.1.0:
+ resolution: {integrity: sha512-yY1UDz6bC9rDvCWHpx12aIBGRG7krurX0p0Fm6pT547LwDIZZiNr8a+IHDogorAdreULSEzP82Nlv5SZkHZcjA==}
+
+ hast-util-from-parse5@8.0.3:
+ resolution: {integrity: sha512-3kxEVkEKt0zvcZ3hCRYI8rqrgwtlIOFMWkbclACvjlDw8Li9S2hk/d51OI0nr/gIpdMHNepwgOKqZ/sy0Clpyg==}
+
+ hast-util-has-property@3.0.0:
+ resolution: {integrity: sha512-MNilsvEKLFpV604hwfhVStK0usFY/QmM5zX16bo7EjnAEGofr5YyI37kzopBlZJkHD4t887i+q/C8/tr5Q94cA==}
+
+ hast-util-heading-rank@3.0.0:
+ resolution: {integrity: sha512-EJKb8oMUXVHcWZTDepnr+WNbfnXKFNf9duMesmr4S8SXTJBJ9M4Yok08pu9vxdJwdlGRhVumk9mEhkEvKGifwA==}
+
+ hast-util-is-body-ok-link@3.0.1:
+ resolution: {integrity: sha512-0qpnzOBLztXHbHQenVB8uNuxTnm/QBFUOmdOSsEn7GnBtyY07+ENTWVFBAnXd/zEgd9/SUG3lRY7hSIBWRgGpQ==}
+
+ hast-util-is-element@3.0.0:
+ resolution: {integrity: sha512-Val9mnv2IWpLbNPqc/pUem+a7Ipj2aHacCwgNfTiK0vJKl0LF+4Ba4+v1oPHFpf3bLYmreq0/l3Gud9S5OH42g==}
+
+ hast-util-minify-whitespace@1.0.1:
+ resolution: {integrity: sha512-L96fPOVpnclQE0xzdWb/D12VT5FabA7SnZOUMtL1DbXmYiHJMXZvFkIZfiMmTCNJHUeO2K9UYNXoVyfz+QHuOw==}
+
+ hast-util-parse-selector@4.0.0:
+ resolution: {integrity: sha512-wkQCkSYoOGCRKERFWcxMVMOcYE2K1AaNLU8DXS9arxnLOUEWbOXKXiJUNzEpqZ3JOKpnha3jkFrumEjVliDe7A==}
+
+ hast-util-phrasing@3.0.1:
+ resolution: {integrity: sha512-6h60VfI3uBQUxHqTyMymMZnEbNl1XmEGtOxxKYL7stY2o601COo62AWAYBQR9lZbYXYSBoxag8UpPRXK+9fqSQ==}
+
+ hast-util-raw@9.1.0:
+ resolution: {integrity: sha512-Y8/SBAHkZGoNkpzqqfCldijcuUKh7/su31kEBp67cFY09Wy0mTRgtsLYsiIxMJxlu0f6AA5SUTbDR8K0rxnbUw==}
+
+ hast-util-to-html@9.0.5:
+ resolution: {integrity: sha512-OguPdidb+fbHQSU4Q4ZiLKnzWo8Wwsf5bZfbvu7//a9oTYoqD/fWpe96NuHkoS9h0ccGOTe0C4NGXdtS0iObOw==}
+
+ hast-util-to-mdast@10.1.2:
+ resolution: {integrity: sha512-FiCRI7NmOvM4y+f5w32jPRzcxDIz+PUqDwEqn1A+1q2cdp3B8Gx7aVrXORdOKjMNDQsD1ogOr896+0jJHW1EFQ==}
+
+ hast-util-to-parse5@8.0.1:
+ resolution: {integrity: sha512-MlWT6Pjt4CG9lFCjiz4BH7l9wmrMkfkJYCxFwKQic8+RTZgWPuWxwAfjJElsXkex7DJjfSJsQIt931ilUgmwdA==}
+
+ hast-util-to-string@3.0.1:
+ resolution: {integrity: sha512-XelQVTDWvqcl3axRfI0xSeoVKzyIFPwsAGSLIsKdJKQMXDYJS4WYrBNF/8J7RdhIcFI2BOHgAifggsvsxp/3+A==}
+
+ hast-util-to-text@4.0.2:
+ resolution: {integrity: sha512-KK6y/BN8lbaq654j7JgBydev7wuNMcID54lkRav1P0CaE1e47P72AWWPiGKXTJU271ooYzcvTAn/Zt0REnvc7A==}
+
+ hast-util-whitespace@3.0.0:
+ resolution: {integrity: sha512-88JUN06ipLwsnv+dVn+OIYOvAuvBMy/Qoi6O7mQHxdPXpjy+Cd6xRkWwux7DKO+4sYILtLBRIKgsdpS2gQc7qw==}
+
+ hastscript@9.0.1:
+ resolution: {integrity: sha512-g7df9rMFX/SPi34tyGCyUBREQoKkapwdY/T04Qn9TDWfHhAYt4/I0gMVirzK5wEzeUqIjEB+LXC/ypb7Aqno5w==}
+
+ highlight.js@10.7.3:
+ resolution: {integrity: sha512-tzcUFauisWKNHaRkN4Wjl/ZA07gENAjFl3J/c480dprkGTg5EQstgaNFqBfUqCq54kZRIEcreTsAgF/m2quD7A==}
+
+ hookable@5.5.3:
+ resolution: {integrity: sha512-Yc+BQe8SvoXH1643Qez1zqLRmbA5rCL+sSmk6TVos0LWVfNIB7PGncdlId77WzLGSIB5KaWgTaNTs2lNVEI6VQ==}
+
+ hookable@6.1.1:
+ resolution: {integrity: sha512-U9LYDy1CwhMCnprUfeAZWZGByVbhd54hwepegYTK7Pi5NvqEj63ifz5z+xukznehT7i6NIZRu89Ay1AZmRsLEQ==}
+
+ hosted-git-info@7.0.2:
+ resolution: {integrity: sha512-puUZAUKT5m8Zzvs72XWy3HtvVbTWljRE66cP60bxJzAqf2DgICo7lYTY2IHUmLnNpjYvw5bvmoHvPc0QO2a62w==}
+ engines: {node: ^16.14.0 || >=18.0.0}
+
+ html-entities@2.6.0:
+ resolution: {integrity: sha512-kig+rMn/QOVRvr7c86gQ8lWXq+Hkv6CbAH1hLu+RG338StTpE8Z0b44SDVaqVu7HGKf27frdmUYEs9hTUX/cLQ==}
+
+ html-escaper@2.0.2:
+ resolution: {integrity: sha512-H2iMtd0I4Mt5eYiapRdIDjp+XzelXQ0tFE4JS7YFwFevXXMmOp9myNrUvCg0D6ws8iqkRPBfKHgbwig1SmlLfg==}
+
+ html-escaper@3.0.3:
+ resolution: {integrity: sha512-RuMffC89BOWQoY0WKGpIhn5gX3iI54O6nRA0yC124NYVtzjmFWBIiFd8M0x+ZdX0P9R4lADg1mgP8C7PxGOWuQ==}
+
+ html-validate@11.2.0:
+ resolution: {integrity: sha512-6aHphdi3SPs4CbliRNjoXUVgn23yeUvnQMIzy/W9Stq0MbLOXe2M97gsdpIIQpgeReQFoEaYnhYFqVTA4j7v/w==}
+ engines: {node: ^22.17.0 || >= 24.0.0}
+ hasBin: true
+ peerDependencies:
+ '@jest/globals': ^29.0.3 || ^30.0.0
+ '@vitest/expect': ^3.0.0 || ^4.0.1
+ jest: ^29.0.3 || ^30.0.0
+ jest-snapshot: ^29.0.3 || ^30.0.0
+ vitest: ^3.0.0 || ^4.0.1
+ peerDependenciesMeta:
+ '@jest/globals':
+ optional: true
+ '@vitest/expect':
+ optional: true
+ jest:
+ optional: true
+ jest-snapshot:
+ optional: true
+ vitest:
+ optional: true
+
+ html-void-elements@3.0.0:
+ resolution: {integrity: sha512-bEqo66MRXsUGxWHV5IP0PUiAWwoEjba4VCzg0LjFJBpchPaTfyfCKTG6bc5F8ucKec3q5y6qOdGyYTSBEvhCrg==}
+
+ html-whitespace-sensitive-tag-names@3.0.1:
+ resolution: {integrity: sha512-q+310vW8zmymYHALr1da4HyXUQ0zgiIwIicEfotYPWGN0OJVEN/58IJ3A4GBYcEq3LGAZqKb+ugvP0GNB9CEAA==}
+
+ htmlnano@3.3.1:
+ resolution: {integrity: sha512-UXOwkDA1WUFSamPXpCzJz131mqbuaenm4Agra3VTpP6lpbuCytILqXEAG5kwzkeksDnFQ+JG3EhVVqpBPsh51w==}
+ hasBin: true
+ peerDependencies:
+ cssnano: ^8.0.0
+ postcss: ^8.3.11
+ purgecss: ^8.0.0
+ relateurl: ^0.2.7
+ srcset: ^5.0.1
+ svgo: ^4.0.0
+ terser: ^5.21.0
+ uncss: ^0.17.3
+ peerDependenciesMeta:
+ cssnano:
+ optional: true
+ postcss:
+ optional: true
+ purgecss:
+ optional: true
+ relateurl:
+ optional: true
+ srcset:
+ optional: true
+ svgo:
+ optional: true
+ terser:
+ optional: true
+ uncss:
+ optional: true
+
+ htmlparser2@10.1.0:
+ resolution: {integrity: sha512-VTZkM9GWRAtEpveh7MSF6SjjrpNVNNVJfFup7xTY3UpFtm67foy9HDVXneLtFVt4pMz5kZtgNcvCniNFb1hlEQ==}
+
+ htmlparser2@7.2.0:
+ resolution: {integrity: sha512-H7MImA4MS6cw7nbyURtLPO1Tms7C5H602LRETv95z1MxO/7CP7rDVROehUYeYBUYEON94NXXDEPmZuq+hX4sog==}
+
+ http-errors@2.0.1:
+ resolution: {integrity: sha512-4FbRdAX+bSdmo4AUFuS0WNiPz8NgFt+r8ThgNWmlrjQjt1Q7ZR9+zTlce2859x4KSXrwIsaeTqDoKQmtP8pLmQ==}
+ engines: {node: '>= 0.8'}
+
+ http-shutdown@1.2.2:
+ resolution: {integrity: sha512-S9wWkJ/VSY9/k4qcjG318bqJNruzE4HySUhFYknwmu6LBP97KLLfwNf+n4V1BHurvFNkSKLFnK/RsuUnRTf9Vw==}
+ engines: {iojs: '>= 1.0.0', node: '>= 0.12.0'}
+
+ https-proxy-agent@5.0.1:
+ resolution: {integrity: sha512-dFcAjpTQFgoLMzC2VwU+C/CbS7uRL0lWmxDITmqm7C+7F0Odmj6s9l6alZc6AELXhrnggM2CeWSXHGOdX2YtwA==}
+ engines: {node: '>= 6'}
+
+ https-proxy-agent@7.0.6:
+ resolution: {integrity: sha512-vK9P5/iUfdl95AI+JVyUuIcVtd4ofvtrOr3HNtM2yxC9bnMbEdp3x01OhQNnjb8IJYi38VlTE3mBXwcfvywuSw==}
+ engines: {node: '>= 14'}
+
+ httpxy@0.5.3:
+ resolution: {integrity: sha512-SMS9V6Sn7VWaS11lYhoAr0ceoaiolTWf4jYdJn0NJhCdKMu9R2H9Fh0LBDWBHQF6HRLI1PmaePYsjanSpE5PEw==}
+
+ human-signals@5.0.0:
+ resolution: {integrity: sha512-AXcZb6vzzrFAUE61HnN4mpLqd/cSIwNQjtNWR0euPm6y0iqx3G4gOXaIDdtdDwZmhwe82LA6+zinmW4UBWVePQ==}
+ engines: {node: '>=16.17.0'}
+
+ hyperdyperid@1.2.0:
+ resolution: {integrity: sha512-Y93lCzHYgGWdrJ66yIktxiaGULYc6oGiABxhcO5AufBeOyoIdZF7bIfLaOrbM0iGIOXQQgxxRrFEnb+Y6w1n4A==}
+ engines: {node: '>=10.18'}
+
+ icss-utils@5.1.0:
+ resolution: {integrity: sha512-soFhflCVWLfRNOPU3iv5Z9VUdT44xFRbzjLsEzSr5AQmgqPMTHdU3PMT1Cf1ssx8fLNJDA1juftYl+PUcv3MqA==}
+ engines: {node: ^10 || ^12 || >= 14}
+ peerDependencies:
+ postcss: ^8.1.0
+
+ ieee754@1.2.1:
+ resolution: {integrity: sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==}
+
+ ignore@5.3.2:
+ resolution: {integrity: sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==}
+ engines: {node: '>= 4'}
+
+ ignore@7.0.5:
+ resolution: {integrity: sha512-Hs59xBNfUIunMFgWAbGX5cq6893IbWg4KnrjbYwX3tx0ztorVgTDA6B2sxf8ejHJ4wz8BqGUMYlnzNBer5NvGg==}
+ engines: {node: '>= 4'}
+
+ image-meta@0.2.2:
+ resolution: {integrity: sha512-3MOLanc3sb3LNGWQl1RlQlNWURE5g32aUphrDyFeCsxBTk08iE3VNe4CwsUZ0Qs1X+EfX0+r29Sxdpza4B+yRA==}
+
+ import-fresh@3.3.1:
+ resolution: {integrity: sha512-TR3KfrTZTYLPB6jUjfx6MF9WcWrHL9su5TObK4ZkYgBdWKPOFoSoQIdEuTuR82pmtxH2spWG9h6etwfr1pLBqQ==}
+ engines: {node: '>=6'}
+
+ import-meta-resolve@4.2.0:
+ resolution: {integrity: sha512-Iqv2fzaTQN28s/FwZAoFq0ZSs/7hMAHJVX+w8PZl3cY19Pxk6jFFalxQoIfW2826i/fDLXv8IiEZRIT0lDuWcg==}
+
+ impound@1.1.5:
+ resolution: {integrity: sha512-5AUn+QE0UofqNHu5f2Skf6Svukdg4ehOIq8O0EtqIx4jta0CDZYBPqpIHt0zrlUTiFVYlLpeH39DoikXBjPKpA==}
+
+ imurmurhash@0.1.4:
+ resolution: {integrity: sha512-JmXMZ6wuvDmLiHEml9ykzqO6lwFbof0GG4IkcGaENdCRDDmMVnny7s5HsIgHCbaq0w2MyPhDqkhTUgS2LU2PHA==}
+ engines: {node: '>=0.8.19'}
+
+ indent-string@5.0.0:
+ resolution: {integrity: sha512-m6FAo/spmsW2Ab2fU35JTYwtOKa2yAwXSwgjSv1TJzh4Mh7mC3lzAOVLBprb72XsTrgkEIsl7YrFNAiDiRhIGg==}
+ engines: {node: '>=12'}
+
+ index-to-position@1.2.0:
+ resolution: {integrity: sha512-Yg7+ztRkqslMAS2iFaU+Oa4KTSidr63OsFGlOrJoW981kIYO3CGCS3wA95P1mUi/IVSJkn0D479KTJpVpvFNuw==}
+ engines: {node: '>=18'}
+
+ individual@3.0.0:
+ resolution: {integrity: sha512-rUY5vtT748NMRbEMrTNiFfy29BgGZwGXUi2NFUVMWQrogSLzlJvQV9eeMWi+g1aVaQ53tpyLAQtd5x/JH0Nh1g==}
+
+ inherits@2.0.4:
+ resolution: {integrity: sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==}
+
+ ini@1.3.8:
+ resolution: {integrity: sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew==}
+
+ ini@4.1.3:
+ resolution: {integrity: sha512-X7rqawQBvfdjS10YU1y1YVreA3SsLrW9dX2CewP2EbBJM4ypVNLDkO5y04gejPwKIY9lR+7r9gn3rFPt/kmWFg==}
+ engines: {node: ^14.17.0 || ^16.13.0 || >=18.0.0}
+
+ installed-check-core@8.3.1:
+ resolution: {integrity: sha512-5yH+YyCw2AO1OQpOSce2yUaooOSrK8XXmkOn2xdVpdtpt0pqwfdqU77FIpWN4fPHDcINKUf4R7hgDEfqpy1Z9g==}
+ engines: {node: '>=18.6.0'}
+
+ installed-check@10.0.1:
+ resolution: {integrity: sha512-jJDj07Sm2K5fwpnFjnwZjyjeUrWnTx1bHYZu1Lcj2C/l1mYpsujUUhiNpgsxQdKuFbcdvngqHV5MUaYFppZtDA==}
+ engines: {node: ^20.19.0 || ^22.13.0 || >=24}
+ hasBin: true
+
+ internal-slot@1.1.0:
+ resolution: {integrity: sha512-4gd7VpWNQNB4UKKCFFVcp1AVv+FMOgs9NKzjHKusc8jTMhd5eL1NqQqOpE0KzMds804/yHlglp3uxgluOqAPLw==}
+ engines: {node: '>= 0.4'}
+
+ ioredis@5.10.1:
+ resolution: {integrity: sha512-HuEDBTI70aYdx1v6U97SbNx9F1+svQKBDo30o0b9fw055LMepzpOOd0Ccg9Q6tbqmBSJaMuY0fB7yw9/vjBYCA==}
+ engines: {node: '>=12.22.0'}
+
+ iron-webcrypto@1.2.1:
+ resolution: {integrity: sha512-feOM6FaSr6rEABp/eDfVseKyTMDt+KGpeB35SkVn9Tyn0CqvVsY3EwI0v5i8nMHyJnzCIQf7nsy3p41TPkJZhg==}
+
+ is-absolute-url@4.0.1:
+ resolution: {integrity: sha512-/51/TKE88Lmm7Gc4/8btclNXWS+g50wXhYJq8HWIBAGUBnoAdRu1aXeh364t/O7wXDAcTJDP8PNuNKWUDWie+A==}
+ engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0}
+
+ is-alphabetical@2.0.1:
+ resolution: {integrity: sha512-FWyyY60MeTNyeSRpkM2Iry0G9hpr7/9kD40mD/cGQEuilcZYS4okz8SN2Q6rLCJ8gbCt6fN+rC+6tMGS99LaxQ==}
+
+ is-alphanumerical@2.0.1:
+ resolution: {integrity: sha512-hmbYhX/9MUMF5uh7tOXyK/n0ZvWpad5caBA17GsC6vyuCqaWliRG5K1qS9inmUhEMaOBIW7/whAnSwveW/LtZw==}
+
+ is-arguments@1.2.0:
+ resolution: {integrity: sha512-7bVbi0huj/wrIAOzb8U1aszg9kdi3KN/CyU19CTI7tAoZYEZoL9yCDXpbXN+uPsuWnP02cyug1gleqq+TU+YCA==}
+ engines: {node: '>= 0.4'}
+
+ is-array-buffer@3.0.5:
+ resolution: {integrity: sha512-DDfANUiiG2wC1qawP66qlTugJeL5HyzMpfr8lLK+jMQirGzNod0B12cFB/9q838Ru27sBwfw78/rdoU7RERz6A==}
+ engines: {node: '>= 0.4'}
+
+ is-arrayish@0.2.1:
+ resolution: {integrity: sha512-zz06S8t0ozoDXMG+ube26zeCTNXcKIPJZJi8hBrF4idCLms4CG9QtK7qBl1boi5ODzFpjswb5JPmHCbMpjaYzg==}
+
+ is-bigint@1.1.0:
+ resolution: {integrity: sha512-n4ZT37wG78iz03xPRKJrHTdZbe3IicyucEtdRsV5yglwc3GyUfbAfpSeD0FJ41NbUNSt5wbhqfp1fS+BgnvDFQ==}
+ engines: {node: '>= 0.4'}
+
+ is-binary-path@2.1.0:
+ resolution: {integrity: sha512-ZMERYes6pDydyuGidse7OsHxtbI7WVeUEozgR/g7rd0xUimYNlvZRE/K2MgZTjWy725IfelLeVcEM97mmtRGXw==}
+ engines: {node: '>=8'}
+
+ is-boolean-object@1.2.2:
+ resolution: {integrity: sha512-wa56o2/ElJMYqjCjGkXri7it5FbebW5usLw/nPmCMs5DeZ7eziSYZhSmPRn0txqeW4LnAmQQU7FgqLpsEFKM4A==}
+ engines: {node: '>= 0.4'}
+
+ is-builtin-module@5.0.0:
+ resolution: {integrity: sha512-f4RqJKBUe5rQkJ2eJEJBXSticB3hGbN9j0yxxMQFqIW89Jp9WYFtzfTcRlstDKVUTRzSOTLKRfO9vIztenwtxA==}
+ engines: {node: '>=18.20'}
+
+ is-callable@1.2.7:
+ resolution: {integrity: sha512-1BC0BVFhS/p0qtw6enp8e+8OD0UrK0oFLztSjNzhcKA3WDuJxxAPXzPuPtKkjEY9UUoEWlX/8fgKeu2S8i9JTA==}
+ engines: {node: '>= 0.4'}
+
+ is-core-module@2.16.2:
+ resolution: {integrity: sha512-evOr8xfXKxE6qSR0hSXL2r3sd7ALj8+7jQEUvPYcm5sgZFdJ+AYzT6yNmJenvIYQBgIGwfwz08sL8zoL7yq2BA==}
+ engines: {node: '>= 0.4'}
+
+ is-date-object@1.1.0:
+ resolution: {integrity: sha512-PwwhEakHVKTdRNVOw+/Gyh0+MzlCl4R6qKvkhuvLtPMggI1WAHt9sOwZxQLSGpUaDnrdyDsomoRgNnCfKNSXXg==}
+ engines: {node: '>= 0.4'}
+
+ is-decimal@2.0.1:
+ resolution: {integrity: sha512-AAB9hiomQs5DXWcRB1rqsxGUstbRroFOPPVAomNk/3XHR5JyEZChOyTWe2oayKnsSsr/kcGqF+z6yuH6HHpN0A==}
+
+ is-docker@3.0.0:
+ resolution: {integrity: sha512-eljcgEDlEns/7AXFosB5K/2nCM4P7FQPkGc/DWLy5rmFEWvZayGrik1d9/QIY5nJ4f9YsVvBkA6kJpHn9rISdQ==}
+ engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0}
+ hasBin: true
+
+ is-expression@4.0.0:
+ resolution: {integrity: sha512-zMIXX63sxzG3XrkHkrAPvm/OVZVSCPNkwMHU8oTX7/U3AL78I0QXCEICXUM13BIa8TYGZ68PiTKfQz3yaTNr4A==}
+
+ is-extglob@2.1.1:
+ resolution: {integrity: sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==}
+ engines: {node: '>=0.10.0'}
+
+ is-fullwidth-code-point@3.0.0:
+ resolution: {integrity: sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==}
+ engines: {node: '>=8'}
+
+ is-glob@4.0.3:
+ resolution: {integrity: sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==}
+ engines: {node: '>=0.10.0'}
+
+ is-hexadecimal@2.0.1:
+ resolution: {integrity: sha512-DgZQp241c8oO6cA1SbTEWiXeoxV42vlcJxgH+B3hi1AiqqKruZR3ZGF8In3fj4+/y/7rHvlOZLZtgJ/4ttYGZg==}
+
+ is-in-ssh@1.0.0:
+ resolution: {integrity: sha512-jYa6Q9rH90kR1vKB6NM7qqd1mge3Fx4Dhw5TVlK1MUBqhEOuCagrEHMevNuCcbECmXZ0ThXkRm+Ymr51HwEPAw==}
+ engines: {node: '>=20'}
+
+ is-inside-container@1.0.0:
+ resolution: {integrity: sha512-KIYLCCJghfHZxqjYBE7rEy0OBuTd5xCHS7tHVgvCLkx7StIoaxwNW3hCALgEUjFfeRk+MG/Qxmp/vtETEF3tRA==}
+ engines: {node: '>=14.16'}
+ hasBin: true
+
+ is-json@2.0.1:
+ resolution: {integrity: sha512-6BEnpVn1rcf3ngfmViLM6vjUjGErbdrL4rwlv+u1NO1XO8kqT4YGL8+19Q+Z/bas8tY90BTWMk2+fW1g6hQjbA==}
+
+ is-map@2.0.3:
+ resolution: {integrity: sha512-1Qed0/Hr2m+YqxnM09CjA2d/i6YZNfF6R2oRAOj36eUdS6qIV/huPJNSEpKbupewFs+ZsJlxsjjPbc0/afW6Lw==}
+ engines: {node: '>= 0.4'}
+
+ is-module@1.0.0:
+ resolution: {integrity: sha512-51ypPSPCoTEIN9dy5Oy+h4pShgJmPCygKfyRCISBI+JoWT/2oJvK8QPxmwv7b/p239jXrm9M1mlQbyKJ5A152g==}
+
+ is-number-object@1.1.1:
+ resolution: {integrity: sha512-lZhclumE1G6VYD8VHe35wFaIif+CTy5SJIi5+3y4psDgWu4wPDoBhF8NxUOinEc7pHgiTsT6MaBb92rKhhD+Xw==}
+ engines: {node: '>= 0.4'}
+
+ is-number@7.0.0:
+ resolution: {integrity: sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==}
+ engines: {node: '>=0.12.0'}
+
+ is-path-inside@4.0.0:
+ resolution: {integrity: sha512-lJJV/5dYS+RcL8uQdBDW9c9uWFLLBNRyFhnAKXw5tVqLlKZ4RMGZKv+YQ/IA3OhD+RpbJa1LLFM1FQPGyIXvOA==}
+ engines: {node: '>=12'}
+
+ is-plain-obj@4.1.0:
+ resolution: {integrity: sha512-+Pgi+vMuUNkJyExiMBt5IlFoMyKnr5zhJ4Uspz58WOhBF5QoIZkFyNHIbBAtHwzVAgk5RtndVNsDRN61/mmDqg==}
+ engines: {node: '>=12'}
+
+ is-promise@2.2.2:
+ resolution: {integrity: sha512-+lP4/6lKUBfQjZ2pdxThZvLUAafmZb8OAxFb8XXtiQmS35INgr85hdOGoEs124ez1FCnZJt6jau/T+alh58QFQ==}
+
+ is-reference@1.2.1:
+ resolution: {integrity: sha512-U82MsXXiFIrjCK4otLT+o2NA2Cd2g5MLoOVXUZjIOhLurrRxpEXzI8O0KZHr3IjLvlAH1kTPYSuqer5T9ZVBKQ==}
+
+ is-regex@1.2.1:
+ resolution: {integrity: sha512-MjYsKHO5O7mCsmRGxWcLWheFqN9DJ/2TmngvjKXihe6efViPqc274+Fx/4fYj/r03+ESvBdTXK0V6tA3rgez1g==}
+ engines: {node: '>= 0.4'}
+
+ is-set@2.0.3:
+ resolution: {integrity: sha512-iPAjerrse27/ygGLxw+EBR9agv9Y6uLeYVJMu+QNCoouJ1/1ri0mGrcWpfCqFZuzzx3WjtwxG098X+n4OuRkPg==}
+ engines: {node: '>= 0.4'}
+
+ is-shared-array-buffer@1.0.4:
+ resolution: {integrity: sha512-ISWac8drv4ZGfwKl5slpHG9OwPNty4jOWPRIhBpxOoD+hqITiwuipOQ2bNthAzwA3B4fIjO4Nln74N0S9byq8A==}
+ engines: {node: '>= 0.4'}
+
+ is-stream@2.0.1:
+ resolution: {integrity: sha512-hFoiJiTl63nn+kstHGBtewWSKnQLpyb155KHheA1l39uvtO9nWIop1p3udqPcUd/xbF1VLMO4n7OI6p7RbngDg==}
+ engines: {node: '>=8'}
+
+ is-stream@3.0.0:
+ resolution: {integrity: sha512-LnQR4bZ9IADDRSkvpqMGvt/tEJWclzklNgSw48V5EAaAeDd6qGvN8ei6k5p0tvxSR171VmGyHuTiAOfxAbr8kA==}
+ engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0}
+
+ is-string@1.1.1:
+ resolution: {integrity: sha512-BtEeSsoaQjlSPBemMQIrY1MY0uM6vnS1g5fmufYOtnxLGUZM2178PKbhsk7Ffv58IX+ZtcvoGwccYsh0PglkAA==}
+ engines: {node: '>= 0.4'}
+
+ is-symbol@1.1.1:
+ resolution: {integrity: sha512-9gGx6GTtCQM73BgmHQXfDmLtfjjTUDSyoxTCbp5WtoixAhfgsDirWIcVQ/IHpvI5Vgd5i/J5F7B9cN/WlVbC/w==}
+ engines: {node: '>= 0.4'}
+
+ is-weakmap@2.0.2:
+ resolution: {integrity: sha512-K5pXYOm9wqY1RgjpL3YTkF39tni1XajUIkawTLUo9EZEVUFga5gSQJF8nNS7ZwJQ02y+1YCNYcMh+HIf1ZqE+w==}
+ engines: {node: '>= 0.4'}
+
+ is-weakset@2.0.4:
+ resolution: {integrity: sha512-mfcwb6IzQyOKTs84CQMrOwW4gQcaTOAWJ0zzJCl2WSPDrWk/OzDaImWFH3djXhb24g4eudZfLRozAvPGw4d9hQ==}
+ engines: {node: '>= 0.4'}
+
+ is-windows@1.0.2:
+ resolution: {integrity: sha512-eXK1UInq2bPmjyX6e3VHIzMLobc4J94i4AWn+Hpq3OU5KkrRC96OAcR3PRJ/pGu6m8TRnBHP9dkXQVsT/COVIA==}
+ engines: {node: '>=0.10.0'}
+
+ is-wsl@3.1.1:
+ resolution: {integrity: sha512-e6rvdUCiQCAuumZslxRJWR/Doq4VpPR82kqclvcS0efgt430SlGIk05vdCN58+VrzgtIcfNODjozVielycD4Sw==}
+ engines: {node: '>=16'}
+
+ isarray@1.0.0:
+ resolution: {integrity: sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ==}
+
+ isarray@2.0.5:
+ resolution: {integrity: sha512-xHjhDr3cNBK0BzdUJSPXZntQUx/mwMS5Rw4A7lPJ90XGAO6ISP/ePDNuo0vhqOZU+UD5JoodwCAAoZQd3FeAKw==}
+
+ isexe@2.0.0:
+ resolution: {integrity: sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==}
+
+ isexe@4.0.0:
+ resolution: {integrity: sha512-FFUtZMpoZ8RqHS3XeXEmHWLA4thH+ZxCv2lOiPIn1Xc7CxrqhWzNSDzD+/chS/zbYezmiwWLdQC09JdQKmthOw==}
+ engines: {node: '>=20'}
+
+ istanbul-lib-coverage@3.2.2:
+ resolution: {integrity: sha512-O8dpsF+r0WV/8MNRKfnmrtCWhuKjxrq2w+jpzBL5UZKTi2LeVWnWOmWRxFlesJONmc+wLAGvKQZEOanko0LFTg==}
+ engines: {node: '>=8'}
+
+ istanbul-lib-report@3.0.1:
+ resolution: {integrity: sha512-GCfE1mtsHGOELCU8e/Z7YWzpmybrx/+dSTfLrvY8qRmaY6zXTKWn6WQIjaAFw069icm6GVMNkgu0NzI4iPZUNw==}
+ engines: {node: '>=10'}
+
+ istanbul-reports@3.2.0:
+ resolution: {integrity: sha512-HGYWWS/ehqTV3xN10i23tkPkpH46MLCIMFNCaaKNavAXTF1RkqxawEPtnjnGZ6XKSInBKkiOA5BKS+aZiY3AvA==}
+ engines: {node: '>=8'}
+
+ jackspeak@3.4.3:
+ resolution: {integrity: sha512-OGlZQpz2yfahA/Rd1Y8Cd9SIEsqvXkLVoSw/cgwhnhFMDbsQFeZYoJJ7bIZBS9BcamUW96asq/npPWugM+RQBw==}
+
+ jest-regex-util@30.4.0:
+ resolution: {integrity: sha512-mWlvLviKIgIQ8VCuM1xRdD0TWp3zlzionlmDBjuXVBs+VkmXq6FgW9T4Emr7oGz/Rk6feDCGyiugolcQEyp3mg==}
+ engines: {node: ^18.14.0 || ^20.0.0 || ^22.0.0 || >=24.0.0}
+
+ jest-util@30.4.1:
+ resolution: {integrity: sha512-vjQb1sACEiv13DKJMDToJpzVW0joCsIQrmbg0fi7CyOOt+g9jTuQl2A216pWRBYhOVt53XbL/2LbMKg1BECWOw==}
+ engines: {node: ^18.14.0 || ^20.0.0 || ^22.0.0 || >=24.0.0}
+
+ jest-worker@27.5.1:
+ resolution: {integrity: sha512-7vuh85V5cdDofPyxn58nrPjBktZo0u9x1g8WtjQol+jZDaE+fhN+cIvTj11GndBnMnyfrUOG1sZQxCdjKh+DKg==}
+ engines: {node: '>= 10.13.0'}
+
+ jest-worker@30.4.1:
+ resolution: {integrity: sha512-SHynN/q/QD++iNyvMdy+WMmbCGk8jIsNcRxycXbWubSOhvo6T+j2afcfUSl+3hYsiBebOTo0cT7c2H7CXugu1g==}
+ engines: {node: ^18.14.0 || ^20.0.0 || ^22.0.0 || >=24.0.0}
+
+ jiti@1.21.7:
+ resolution: {integrity: sha512-/imKNG4EbWNrVjoNC/1H5/9GFy+tqjGBHCaSsN+P2RnPqjsLmv6UD3Ej+Kj8nBWaRAwyk7kK5ZUc+OEatnTR3A==}
+ hasBin: true
+
+ jiti@2.7.0:
+ resolution: {integrity: sha512-AC/7JofJvZGrrneWNaEnJeOLUx+JlGt7tNa0wZiRPT4MY1wmfKjt2+6O2p2uz2+skll8OZZmJMNqeke7kKbNgQ==}
+ hasBin: true
+
+ js-beautify@1.15.4:
+ resolution: {integrity: sha512-9/KXeZUKKJwqCXUdBxFJ3vPh467OCckSBmYDwSK/EtV090K+iMJ7zx2S3HLVDIWFQdqMIsZWbnaGiba18aWhaA==}
+ engines: {node: '>=14'}
+ hasBin: true
+
+ js-cookie@3.0.7:
+ resolution: {integrity: sha512-z/wZZgDrkNV1eA0ULjM/F9/50Ya8fbzgKneSpoPsXSGd0KnpdtHfOZWK+GcwLk+EZbS4F9RBhU+K2RgzuDaItw==}
+ engines: {node: '>=20'}
+
+ js-stringify@1.0.2:
+ resolution: {integrity: sha512-rtS5ATOo2Q5k1G+DADISilDA6lv79zIiwFd6CcjuIxGKLFm5C+RLImRscVap9k55i+MOZwgliw+NejvkLuGD5g==}
+
+ js-tokens@10.0.0:
+ resolution: {integrity: sha512-lM/UBzQmfJRo9ABXbPWemivdCW8V2G8FHaHdypQaIy523snUjog0W71ayWXTjiR+ixeMyVHN2XcpnTd/liPg/Q==}
+
+ js-tokens@4.0.0:
+ resolution: {integrity: sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==}
+
+ js-tokens@9.0.1:
+ resolution: {integrity: sha512-mxa9E9ITFOt0ban3j6L5MpjwegGz6lBQmM1IJkWeBZGcMxto50+eWdjC/52xDbS2vy0k7vIMK0Fe2wfL9OQSpQ==}
+
+ js-yaml@4.1.1:
+ resolution: {integrity: sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA==}
+ hasBin: true
+
+ jsdoc-type-pratt-parser@7.2.0:
+ resolution: {integrity: sha512-dh140MMgjyg3JhJZY/+iEzW+NO5xR2gpbDFKHqotCmexElVntw7GjWjt511+C/Ef02RU5TKYrJo/Xlzk+OLaTw==}
+ engines: {node: '>=20.0.0'}
+
+ jsesc@3.1.0:
+ resolution: {integrity: sha512-/sM3dO2FOzXjKQhJuo0Q173wf2KOo8t4I8vHy6lF9poUp7bKT0/NHE8fPX23PwfhnykfqnC2xRxOnVw5XuGIaA==}
+ engines: {node: '>=6'}
+ hasBin: true
+
+ json-buffer@3.0.1:
+ resolution: {integrity: sha512-4bV5BfR2mqfQTJm+V5tPPdf+ZpuhiIvTuAB5g8kcrXOZpTT/QwwVRWBywX1ozr6lEuPdbHxwaJlm9G6mI2sfSQ==}
+
+ json-parse-even-better-errors@2.3.1:
+ resolution: {integrity: sha512-xyFwyhro/JEof6Ghe2iz2NcXoj2sloNsWr/XsERDK/oiPCfaNhl5ONfp+jQdAZRQQ0IJWNzH9zIZF7li91kh2w==}
+
+ json-parse-even-better-errors@3.0.2:
+ resolution: {integrity: sha512-fi0NG4bPjCHunUJffmLd0gxssIgkNmArMvis4iNah6Owg1MCJjWhEcDLmsK6iGkJq3tHwbDkTlce70/tmXN4cQ==}
+ engines: {node: ^14.17.0 || ^16.13.0 || >=18.0.0}
+
+ json-schema-to-typescript-lite@15.0.0:
+ resolution: {integrity: sha512-5mMORSQm9oTLyjM4mWnyNBi2T042Fhg1/0gCIB6X8U/LVpM2A+Nmj2yEyArqVouDmFThDxpEXcnTgSrjkGJRFA==}
+
+ json-schema-traverse@0.4.1:
+ resolution: {integrity: sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==}
+
+ json-schema-traverse@1.0.0:
+ resolution: {integrity: sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==}
+
+ json-stable-stringify-without-jsonify@1.0.1:
+ resolution: {integrity: sha512-Bdboy+l7tA3OGW6FjyFHWkP5LuByj1Tk33Ljyq0axyzdk9//JSi2u3fP1QSmd1KNwq6VOKYGlAu87CisVir6Pw==}
+
+ json5@1.0.2:
+ resolution: {integrity: sha512-g1MWMLBiz8FKi1e4w0UyVL3w+iJceWAFBAaBnnGKOpNa5f8TLktkbre1+s6oICydWAm+HRUGTmI+//xv2hvXYA==}
+ hasBin: true
+
+ json5@2.2.3:
+ resolution: {integrity: sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==}
+ engines: {node: '>=6'}
+ hasBin: true
+
+ jsonc-parser@3.3.1:
+ resolution: {integrity: sha512-HUgH65KyejrUFPvHFPbqOY0rsFip3Bo5wb4ngvdi1EpCYWUQDC5V+Y7mZws+DLkr4M//zQJoanu1SP+87Dv1oQ==}
+
+ jsonfile@6.2.1:
+ resolution: {integrity: sha512-zwOTdL3rFQ/lRdBnntKVOX6k5cKJwEc1HdilT71BWEu7J41gXIB2MRp+vxduPSwZJPWBxEzv4yH1wYLJGUHX4Q==}
+
+ jsonpointer@5.0.1:
+ resolution: {integrity: sha512-p/nXbhSEcu3pZRdkW1OfJhpsVtW1gd4Wa1fnQc9YLiTfAjn0312eMKimbdIQzuZl9aa9xUGaRlP9T/CJE/ditQ==}
+ engines: {node: '>=0.10.0'}
+
+ jstransformer@1.0.0:
+ resolution: {integrity: sha512-C9YK3Rf8q6VAPDCCU9fnqo3mAfOH6vUGnMcP4AQAYIEpWtfGLpwOTmZ+igtdK5y+VvI2n3CyYSzy4Qh34eq24A==}
+
+ katex@0.16.47:
+ resolution: {integrity: sha512-Eeo8Ys1doU1z+x8AZsPpQu+p/QcZBI5PeOo7QGQdy2x2m0MU/hYagBbGOmXwr5KVbEfVuWv9LpnQWeehogurjg==}
+ hasBin: true
+
+ keyv@4.5.4:
+ resolution: {integrity: sha512-oxVHkHR/EJf2CNXnWxRLW6mg7JyCCUcG0DtEGmL2ctUo1PNTin1PUil+r/+4r5MpVgC/fn1kjsx7mjSujKqIpw==}
+
+ kleur@3.0.3:
+ resolution: {integrity: sha512-eTIzlVOSUR+JxdDFepEYcBMtZ9Qqdef+rnzWdRZuMbOywu5tO2w2N7rqjoANZ5k9vywhL6Br1VRjUIgTQx4E8w==}
+ engines: {node: '>=6'}
+
+ kleur@4.1.5:
+ resolution: {integrity: sha512-o+NO+8WrRiQEE4/7nwRJhN1HWpVmJm511pBHUxPLtp0BUISzlBplORYSmTclCnJvQq2tKu/sgl3xVpkc7ZWuQQ==}
+ engines: {node: '>=6'}
+
+ klona@2.0.6:
+ resolution: {integrity: sha512-dhG34DXATL5hSxJbIexCft8FChFXtmskoZYnoPWjXQuebWYCNkVeV3KkGegCK9CP1oswI/vQibS2GY7Em/sJJA==}
+ engines: {node: '>= 8'}
+
+ knip@6.14.1:
+ resolution: {integrity: sha512-SN3Ly0ixzj5CQkY/rc4OPHpWrCC0XRIIjgdP76G9Cni5k72ur5jBYOyvJuF5oPTM14v8eHcMUgPbElHa+lnR0g==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ hasBin: true
+
+ knitwork@1.3.0:
+ resolution: {integrity: sha512-4LqMNoONzR43B1W0ek0fhXMsDNW/zxa1NdFAVMY+k28pgZLovR4G3PB5MrpTxCy1QaZCqNoiaKPr5w5qZHfSNw==}
+
+ launch-editor@2.13.2:
+ resolution: {integrity: sha512-4VVDnbOpLXy/s8rdRCSXb+zfMeFR0WlJWpET1iA9CQdlZDfwyLjUuGQzXU4VeOoey6AicSAluWan7Etga6Kcmg==}
+
+ lazystream@1.0.1:
+ resolution: {integrity: sha512-b94GiNHQNy6JNTrt5w6zNyffMrNkXZb3KTkCZJb2V1xaEGCk093vkZ2jk3tpaeP33/OiXC+WvK9AxUebnf5nbw==}
+ engines: {node: '>= 0.6.3'}
+
+ levn@0.4.1:
+ resolution: {integrity: sha512-+bT2uH4E5LGE7h/n3evcS/sQlJXCpIp6ym8OWJ5eV6+67Dsql/LaaT7qJBAt2rzfoa/5QBGBhxDix1dMt2kQKQ==}
+ engines: {node: '>= 0.8.0'}
+
+ lightningcss-android-arm64@1.32.0:
+ resolution: {integrity: sha512-YK7/ClTt4kAK0vo6w3X+Pnm0D2cf2vPHbhOXdoNti1Ga0al1P4TBZhwjATvjNwLEBCnKvjJc2jQgHXH0NEwlAg==}
+ engines: {node: '>= 12.0.0'}
+ cpu: [arm64]
+ os: [android]
+
+ lightningcss-darwin-arm64@1.32.0:
+ resolution: {integrity: sha512-RzeG9Ju5bag2Bv1/lwlVJvBE3q6TtXskdZLLCyfg5pt+HLz9BqlICO7LZM7VHNTTn/5PRhHFBSjk5lc4cmscPQ==}
+ engines: {node: '>= 12.0.0'}
+ cpu: [arm64]
+ os: [darwin]
+
+ lightningcss-darwin-x64@1.32.0:
+ resolution: {integrity: sha512-U+QsBp2m/s2wqpUYT/6wnlagdZbtZdndSmut/NJqlCcMLTWp5muCrID+K5UJ6jqD2BFshejCYXniPDbNh73V8w==}
+ engines: {node: '>= 12.0.0'}
+ cpu: [x64]
+ os: [darwin]
+
+ lightningcss-freebsd-x64@1.32.0:
+ resolution: {integrity: sha512-JCTigedEksZk3tHTTthnMdVfGf61Fky8Ji2E4YjUTEQX14xiy/lTzXnu1vwiZe3bYe0q+SpsSH/CTeDXK6WHig==}
+ engines: {node: '>= 12.0.0'}
+ cpu: [x64]
+ os: [freebsd]
+
+ lightningcss-linux-arm-gnueabihf@1.32.0:
+ resolution: {integrity: sha512-x6rnnpRa2GL0zQOkt6rts3YDPzduLpWvwAF6EMhXFVZXD4tPrBkEFqzGowzCsIWsPjqSK+tyNEODUBXeeVHSkw==}
+ engines: {node: '>= 12.0.0'}
+ cpu: [arm]
+ os: [linux]
+
+ lightningcss-linux-arm64-gnu@1.32.0:
+ resolution: {integrity: sha512-0nnMyoyOLRJXfbMOilaSRcLH3Jw5z9HDNGfT/gwCPgaDjnx0i8w7vBzFLFR1f6CMLKF8gVbebmkUN3fa/kQJpQ==}
+ engines: {node: '>= 12.0.0'}
+ cpu: [arm64]
+ os: [linux]
+ libc: [glibc]
+
+ lightningcss-linux-arm64-musl@1.32.0:
+ resolution: {integrity: sha512-UpQkoenr4UJEzgVIYpI80lDFvRmPVg6oqboNHfoH4CQIfNA+HOrZ7Mo7KZP02dC6LjghPQJeBsvXhJod/wnIBg==}
+ engines: {node: '>= 12.0.0'}
+ cpu: [arm64]
+ os: [linux]
+ libc: [musl]
+
+ lightningcss-linux-x64-gnu@1.32.0:
+ resolution: {integrity: sha512-V7Qr52IhZmdKPVr+Vtw8o+WLsQJYCTd8loIfpDaMRWGUZfBOYEJeyJIkqGIDMZPwPx24pUMfwSxxI8phr/MbOA==}
+ engines: {node: '>= 12.0.0'}
+ cpu: [x64]
+ os: [linux]
+ libc: [glibc]
+
+ lightningcss-linux-x64-musl@1.32.0:
+ resolution: {integrity: sha512-bYcLp+Vb0awsiXg/80uCRezCYHNg1/l3mt0gzHnWV9XP1W5sKa5/TCdGWaR/zBM2PeF/HbsQv/j2URNOiVuxWg==}
+ engines: {node: '>= 12.0.0'}
+ cpu: [x64]
+ os: [linux]
+ libc: [musl]
+
+ lightningcss-win32-arm64-msvc@1.32.0:
+ resolution: {integrity: sha512-8SbC8BR40pS6baCM8sbtYDSwEVQd4JlFTOlaD3gWGHfThTcABnNDBda6eTZeqbofalIJhFx0qKzgHJmcPTnGdw==}
+ engines: {node: '>= 12.0.0'}
+ cpu: [arm64]
+ os: [win32]
+
+ lightningcss-win32-x64-msvc@1.32.0:
+ resolution: {integrity: sha512-Amq9B/SoZYdDi1kFrojnoqPLxYhQ4Wo5XiL8EVJrVsB8ARoC1PWW6VGtT0WKCemjy8aC+louJnjS7U18x3b06Q==}
+ engines: {node: '>= 12.0.0'}
+ cpu: [x64]
+ os: [win32]
+
+ lightningcss@1.32.0:
+ resolution: {integrity: sha512-NXYBzinNrblfraPGyrbPoD19C1h9lfI/1mzgWYvXUTe414Gz/X1FD2XBZSZM7rRTrMA8JL3OtAaGifrIKhQ5yQ==}
+ engines: {node: '>= 12.0.0'}
+
+ lilconfig@3.1.3:
+ resolution: {integrity: sha512-/vlFKAoH5Cgt3Ie+JLhRbwOsCQePABiU3tJ1egGvyQ+33R/vcwM2Zl2QR/LzjsBeItPt3oSVXapn+m4nQDvpzw==}
+ engines: {node: '>=14'}
+
+ lines-and-columns@1.2.4:
+ resolution: {integrity: sha512-7ylylesZQ/PV29jhEDl3Ufjo6ZX7gCqJr5F7PKrqc93v7fzSymt1BpwEU8nAUXs8qzzvqhbjhK5QZg6Mt/HkBg==}
+
+ linkify-it@5.0.0:
+ resolution: {integrity: sha512-5aHCbzQRADcdP+ATqnDuhhJ/MRIqDkZX5pyjFHRRysS8vZ5AbqGEoFIb6pYHPZ+L/OC2Lc+xT8uHVVR5CAK/wQ==}
+
+ list-installed@5.3.1:
+ resolution: {integrity: sha512-MLK5hj3vViLbs/RDgi/tY7rhi9ifiwnKppUF21mH2DqqMznvZhZ8TnjI0W6ZS0iCsl1qGAiHrUIMhjK7xrJstg==}
+ engines: {node: '>=18.6.0'}
+
+ listhen@1.10.0:
+ resolution: {integrity: sha512-kfz4C0OrC6IpaVMtYDJtf6PFjurxe9NBBoDAh/o2p587INryFOO4DQ9OetbCdDrWFt1m1CJKvYrzkGsuPHw8nQ==}
+ hasBin: true
+
+ loader-runner@4.3.2:
+ resolution: {integrity: sha512-DFEqQ3ihfS9blba08cLfYf1NRAIEm+dDjic073DRDc3/JspI/8wYmtDsHwd3+4hwvdxSK7PGaElfTmm0awWJ4w==}
+ engines: {node: '>=6.11.5'}
+
+ loader-utils@1.4.2:
+ resolution: {integrity: sha512-I5d00Pd/jwMD2QCduo657+YM/6L3KZu++pmX9VFncxaxvHcru9jx1lBaFft+r4Mt2jK0Yhp41XlRAihzPxHNCg==}
+ engines: {node: '>=4.0.0'}
+
+ loader-utils@2.0.4:
+ resolution: {integrity: sha512-xXqpXoINfFhgua9xiqD8fPFHgkoq1mmmpE92WlDbm9rNRd/EbRb+Gqf908T2DMfuHjjJlksiK2RbHVOdD/MqSw==}
+ engines: {node: '>=8.9.0'}
+
+ local-pkg@1.2.1:
+ resolution: {integrity: sha512-++gUqRDEvcnN6Zhqrr+y/CkVEHhlrR96vZn3nZZPYzMcBUyBtTKzB9NadClFIsIVSsu+3i9tfk/erqy9kAmt7Q==}
+ engines: {node: '>=14'}
+
+ locate-path@6.0.0:
+ resolution: {integrity: sha512-iPZK6eYjbxRu3uB4/WZ3EsEIMJFMqAoopl3R+zuq0UjcAm/MO6KCweDgPfP3elTztoKP3KtnVHxTn2NHBSDVUw==}
+ engines: {node: '>=10'}
+
+ locate-path@7.2.0:
+ resolution: {integrity: sha512-gvVijfZvn7R+2qyPX8mAuKcFGDf6Nc61GdvGafQsHL0sBIxfKzA+usWn4GFC/bk+QdwPUD4kWFJLhElipq+0VA==}
+ engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0}
+
+ lodash.defaults@4.2.0:
+ resolution: {integrity: sha512-qjxPLHd3r5DnsdGacqOMU6pb/avJzdh9tFX2ymgoZE27BmjXrNy/y4LoaiTeAb+O3gL8AfpJGtqfX/ae2leYYQ==}
+
+ lodash.isarguments@3.1.0:
+ resolution: {integrity: sha512-chi4NHZlZqZD18a0imDHnZPrDeBbTtVN7GXMwuGdRH9qotxAjYs3aVLKc7zNOG9eddR5Ksd8rvFEBc9SsggPpg==}
+
+ lodash.memoize@4.1.2:
+ resolution: {integrity: sha512-t7j+NzmgnQzTAYXcsHYLgimltOV1MXHtlOWf6GjL9Kj8GK5FInw5JotxvbOs+IvV1/Dzo04/fCGfLVs7aXb4Ag==}
+
+ lodash.merge@4.6.2:
+ resolution: {integrity: sha512-0KpjqXRVvrYyCsX1swR/XTK0va6VQkQM6MNo7PqW77ByjAhoARA8EfrP1N4+KlKj8YS0ZUCtRT/YUuhyYDujIQ==}
+
+ lodash.uniq@4.5.0:
+ resolution: {integrity: sha512-xfBaXQd9ryd9dlSDvnvI0lvxfLJlYAZzXomUYzLKtUeOQvOP5piqAWuGtrhWeqaXK9hhoM/iyJc5AV+XfsX3HQ==}
+
+ lodash@4.18.1:
+ resolution: {integrity: sha512-dMInicTPVE8d1e5otfwmmjlxkZoUpiVLwyeTdUsi/Caj/gfzzblBcCE5sRHV/AsjuCmxWrte2TNGSYuCeCq+0Q==}
+
+ logs-sdk@0.0.6:
+ resolution: {integrity: sha512-G4M1C9aLLBOIWpmw/Lqk4zrap/T2IJsoUOuUDjRcVSLy6lHQqxr3wCqIT1FvvpYTUYpEwvu4utsMY42jTNvx8Q==}
+
+ longest-streak@3.1.0:
+ resolution: {integrity: sha512-9Ri+o0JYgehTaVBBDoMqIl8GXtbWg711O3srftcHhZ0dqnETqLaoIK0x17fUw9rFSlK/0NlsKe0Ahhyl5pXE2g==}
+
+ lru-cache@10.4.3:
+ resolution: {integrity: sha512-JNAzZcXrCt42VGLuYz0zfAzDfAvJWW6AfYlDBQyDV5DClI2m5sAmK+OIO7s59XfsRsWHp02jAJrRadPRGTt6SQ==}
+
+ lru-cache@11.5.0:
+ resolution: {integrity: sha512-5YgH9UJd7wVb9hIouI2adWpgqrrICkt070Dnj8EUY1+B4B2P9eRLPAkAAo6NICA7CEhOIeBHl46u9zSNpNu7zA==}
+ engines: {node: 20 || >=22}
+
+ lru-cache@5.1.1:
+ resolution: {integrity: sha512-KpNARQA3Iwv+jTA0utUVVbrh+Jlrr1Fv0e56GGzAFOXN7dk/FviaDW8LHmK52DlcH4WP2n6gI8vN1aesBFgo9w==}
+
+ lz-string@1.5.0:
+ resolution: {integrity: sha512-h5bgJWpxJNswbU7qCrV0tIKQCaS3blPDrqKWx+QxzuzL1zGUzij9XCWLrSLsJPu5t+eWA/ycetzYAO5IOMcWAQ==}
+ hasBin: true
+
+ magic-regexp@0.10.0:
+ resolution: {integrity: sha512-Uly1Bu4lO1hwHUW0CQeSWuRtzCMNO00CmXtS8N6fyvB3B979GOEEeAkiTUDsmbYLAbvpUS/Kt5c4ibosAzVyVg==}
+
+ magic-regexp@0.11.0:
+ resolution: {integrity: sha512-LG77Z/gVnwz7oaDpD4heX6ryl+lcr4l1B2gnP4MMvt2pGhGC1Dfj7dl1pXpP4ih+VQFLuAadeKVa+lARAzfW+Q==}
+
+ magic-string-ast@1.0.3:
+ resolution: {integrity: sha512-CvkkH1i81zl7mmb94DsRiFeG9V2fR2JeuK8yDgS8oiZSFa++wWLEgZ5ufEOyLHbvSbD1gTRKv9NdX69Rnvr9JA==}
+ engines: {node: '>=20.19.0'}
+
+ magic-string@0.30.21:
+ resolution: {integrity: sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==}
+
+ magicast@0.5.3:
+ resolution: {integrity: sha512-pVKE4UdSQ7DvHzivsCIFx2BJn1mHG6KsyrFcaxFx6tONdneEuThrDx0Cj3AMg58KyN4pzYT+LHOotxDQDjNvkw==}
+
+ make-dir@3.1.0:
+ resolution: {integrity: sha512-g3FeP20LNwhALb/6Cz6Dd4F2ngze0jz7tbzrD2wAV+o9FeNHe4rL+yK2md0J/fiSf1sa1ADhXqi5+oVwOM/eGw==}
+ engines: {node: '>=8'}
+
+ make-dir@4.0.0:
+ resolution: {integrity: sha512-hXdUTZYIVOt1Ex//jAQi+wTZZpUpwBj/0QsOzqegb3rGMMeJiSEu5xLHnYfBrRV4RH2+OCSOO95Is/7x1WJ4bw==}
+ engines: {node: '>=10'}
+
+ markdown-it@14.1.1:
+ resolution: {integrity: sha512-BuU2qnTti9YKgK5N+IeMubp14ZUKUUw7yeJbkjtosvHiP0AZ5c8IAgEMk79D0eC8F23r4Ac/q8cAIFdm2FtyoA==}
+ hasBin: true
+
+ markdown-table@3.0.4:
+ resolution: {integrity: sha512-wiYz4+JrLyb/DqW2hkFJxP7Vd7JuTDm77fvbM8VfEQdmSMqcImWeeRbHwZjBjIFki/VaMK2BhFi7oUUZeM5bqw==}
+
+ markdownlint-cli@0.48.0:
+ resolution: {integrity: sha512-NkZQNu2E0Q5qLEEHwWj674eYISTLD4jMHkBzDobujXd1kv+yCxi8jOaD/rZoQNW1FBBMMGQpuW5So8B51N/e0A==}
+ engines: {node: '>=20'}
+ hasBin: true
+
+ markdownlint@0.40.0:
+ resolution: {integrity: sha512-UKybllYNheWac61Ia7T6fzuQNDZimFIpCg2w6hHjgV1Qu0w1TV0LlSgryUGzM0bkKQCBhy2FDhEELB73Kb0kAg==}
+ engines: {node: '>=20'}
+
+ marked-terminal@7.3.0:
+ resolution: {integrity: sha512-t4rBvPsHc57uE/2nJOLmMbZCQ4tgAccAED3ngXQqW6g+TxA488JzJ+FK3lQkzBQOI1mRV/r/Kq+1ZlJ4D0owQw==}
+ engines: {node: '>=16.0.0'}
+ peerDependencies:
+ marked: '>=1 <16'
+
+ marked@9.1.6:
+ resolution: {integrity: sha512-jcByLnIFkd5gSXZmjNvS1TlmRhCXZjIzHYlaGkPlLIekG55JDR2Z4va9tZwCiP+/RDERiNhMOFu01xd6O5ct1Q==}
+ engines: {node: '>= 16'}
+ hasBin: true
+
+ math-intrinsics@1.1.0:
+ resolution: {integrity: sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==}
+ engines: {node: '>= 0.4'}
+
+ mdast-util-find-and-replace@3.0.2:
+ resolution: {integrity: sha512-Tmd1Vg/m3Xz43afeNxDIhWRtFZgM2VLyaf4vSTYwudTyeuTneoL3qtWMA5jeLyz/O1vDJmmV4QuScFCA2tBPwg==}
+
+ mdast-util-from-markdown@2.0.3:
+ resolution: {integrity: sha512-W4mAWTvSlKvf8L6J+VN9yLSqQ9AOAAvHuoDAmPkz4dHf553m5gVj2ejadHJhoJmcmxEnOv6Pa8XJhpxE93kb8Q==}
+
+ mdast-util-frontmatter@2.0.1:
+ resolution: {integrity: sha512-LRqI9+wdgC25P0URIJY9vwocIzCcksduHQ9OF2joxQoyTNVduwLAFUzjoopuRJbJAReaKrNQKAZKL3uCMugWJA==}
+
+ mdast-util-gfm-autolink-literal@2.0.1:
+ resolution: {integrity: sha512-5HVP2MKaP6L+G6YaxPNjuL0BPrq9orG3TsrZ9YXbA3vDw/ACI4MEsnoDpn6ZNm7GnZgtAcONJyPhOP8tNJQavQ==}
+
+ mdast-util-gfm-footnote@2.1.0:
+ resolution: {integrity: sha512-sqpDWlsHn7Ac9GNZQMeUzPQSMzR6Wv0WKRNvQRg0KqHh02fpTz69Qc1QSseNX29bhz1ROIyNyxExfawVKTm1GQ==}
+
+ mdast-util-gfm-strikethrough@2.0.0:
+ resolution: {integrity: sha512-mKKb915TF+OC5ptj5bJ7WFRPdYtuHv0yTRxK2tJvi+BDqbkiG7h7u/9SI89nRAYcmap2xHQL9D+QG/6wSrTtXg==}
+
+ mdast-util-gfm-table@2.0.0:
+ resolution: {integrity: sha512-78UEvebzz/rJIxLvE7ZtDd/vIQ0RHv+3Mh5DR96p7cS7HsBhYIICDBCu8csTNWNO6tBWfqXPWekRuj2FNOGOZg==}
+
+ mdast-util-gfm-task-list-item@2.0.0:
+ resolution: {integrity: sha512-IrtvNvjxC1o06taBAVJznEnkiHxLFTzgonUdy8hzFVeDun0uTjxxrRGVaNFqkU1wJR3RBPEfsxmU6jDWPofrTQ==}
+
+ mdast-util-gfm@3.1.0:
+ resolution: {integrity: sha512-0ulfdQOM3ysHhCJ1p06l0b0VKlhU0wuQs3thxZQagjcjPrlFRqY215uZGHHJan9GEAXd9MbfPjFJz+qMkVR6zQ==}
+
+ mdast-util-math@3.0.0:
+ resolution: {integrity: sha512-Tl9GBNeG/AhJnQM221bJR2HPvLOSnLE/T9cJI9tlc6zwQk2nPk/4f0cHkOdEixQPC/j8UtKDdITswvLAy1OZ1w==}
+
+ mdast-util-phrasing@4.1.0:
+ resolution: {integrity: sha512-TqICwyvJJpBwvGAMZjj4J2n0X8QWp21b9l0o7eXyVJ25YNWYbJDVIyD1bZXE6WtV6RmKJVYmQAKWa0zWOABz2w==}
+
+ mdast-util-to-hast@13.2.1:
+ resolution: {integrity: sha512-cctsq2wp5vTsLIcaymblUriiTcZd0CwWtCbLvrOzYCDZoWyMNV8sZ7krj09FSnsiJi3WVsHLM4k6Dq/yaPyCXA==}
+
+ mdast-util-to-markdown@2.1.2:
+ resolution: {integrity: sha512-xj68wMTvGXVOKonmog6LwyJKrYXZPvlwabaryTjLh9LuvovB/KAH+kvi8Gjj+7rJjsFi23nkUxRQv1KqSroMqA==}
+
+ mdast-util-to-string@4.0.0:
+ resolution: {integrity: sha512-0H44vDimn51F0YwvxSJSm0eCDOJTRlmN0R1yBh4HLj9wiV1Dn0QoXGbvFAWj2hSItVTlCmBF1hqKlIyUBVFLPg==}
+
+ mdn-data@2.0.28:
+ resolution: {integrity: sha512-aylIc7Z9y4yzHYAJNuESG3hfhC+0Ibp/MAMiaOZgNv4pmEdFyfZhhhny4MNiAfWdBQ1RQ2mfDWmM1x8SvGyp8g==}
+
+ mdn-data@2.27.1:
+ resolution: {integrity: sha512-9Yubnt3e8A0OKwxYSXyhLymGW4sCufcLG6VdiDdUGVkPhpqLxlvP5vl1983gQjJl3tqbrM731mjaZaP68AgosQ==}
+
+ mdurl@2.0.0:
+ resolution: {integrity: sha512-Lf+9+2r+Tdp5wXDXC4PcIBjTDtq4UKjCPMQhKIuzpJNW0b96kVqSwW0bT7FhRSfmAiFYgP+SCRvdrDozfh0U5w==}
+
+ memfs@3.6.0:
+ resolution: {integrity: sha512-EGowvkkgbMcIChjMTMkESFDbZeSh8xZ7kNSF0hAiAN4Jh6jgHCRS0Ga/+C8y6Au+oqpezRHCfPsmJ2+DwAgiwQ==}
+ engines: {node: '>= 4.0.0'}
+ deprecated: this will be v4
+
+ memfs@4.57.2:
+ resolution: {integrity: sha512-2nWzSsJzrukurSDna4Z0WywuScK4Id3tSKejgu74u8KCdW4uNrseKRSIDg75C6Yw5ZRqBe0F0EtMNlTbUq8bAQ==}
+ peerDependencies:
+ tslib: '2'
+
+ memory-fs@0.5.0:
+ resolution: {integrity: sha512-jA0rdU5KoQMC0e6ppoNRtpp6vjFq6+NY7r8hywnC7V+1Xj/MtHwGIbB1QaK/dunyjWteJzmkpd7ooeWg10T7GA==}
+ engines: {node: '>=4.3.0 <5.0.0 || >=5.10'}
+
+ merge-stream@2.0.0:
+ resolution: {integrity: sha512-abv/qOcuPfk3URPfDzmZU1LKmuw8kT+0nIHvKrKgFrwifol/doWcdA4ZqsWQ8ENrFKkd67Mfpo/LovbIUsbt3w==}
+
+ merge2@1.4.1:
+ resolution: {integrity: sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==}
+ engines: {node: '>= 8'}
+
+ micromark-core-commonmark@2.0.3:
+ resolution: {integrity: sha512-RDBrHEMSxVFLg6xvnXmb1Ayr2WzLAWjeSATAoxwKYJV94TeNavgoIdA0a9ytzDSVzBy2YKFK+emCPOEibLeCrg==}
+
+ micromark-extension-directive@4.0.0:
+ resolution: {integrity: sha512-/C2nqVmXXmiseSSuCdItCMho7ybwwop6RrrRPk0KbOHW21JKoCldC+8rFOaundDoRBUWBnJJcxeA/Kvi34WQXg==}
+
+ micromark-extension-frontmatter@2.0.0:
+ resolution: {integrity: sha512-C4AkuM3dA58cgZha7zVnuVxBhDsbttIMiytjgsM2XbHAB2faRVaHRle40558FBN+DJcrLNCoqG5mlrpdU4cRtg==}
+
+ micromark-extension-gfm-autolink-literal@2.1.0:
+ resolution: {integrity: sha512-oOg7knzhicgQ3t4QCjCWgTmfNhvQbDDnJeVu9v81r7NltNCVmhPy1fJRX27pISafdjL+SVc4d3l48Gb6pbRypw==}
+
+ micromark-extension-gfm-footnote@2.1.0:
+ resolution: {integrity: sha512-/yPhxI1ntnDNsiHtzLKYnE3vf9JZ6cAisqVDauhp4CEHxlb4uoOTxOCJ+9s51bIB8U1N1FJ1RXOKTIlD5B/gqw==}
+
+ micromark-extension-gfm-strikethrough@2.1.0:
+ resolution: {integrity: sha512-ADVjpOOkjz1hhkZLlBiYA9cR2Anf8F4HqZUO6e5eDcPQd0Txw5fxLzzxnEkSkfnD0wziSGiv7sYhk/ktvbf1uw==}
+
+ micromark-extension-gfm-table@2.1.1:
+ resolution: {integrity: sha512-t2OU/dXXioARrC6yWfJ4hqB7rct14e8f7m0cbI5hUmDyyIlwv5vEtooptH8INkbLzOatzKuVbQmAYcbWoyz6Dg==}
+
+ micromark-extension-gfm-tagfilter@2.0.0:
+ resolution: {integrity: sha512-xHlTOmuCSotIA8TW1mDIM6X2O1SiX5P9IuDtqGonFhEK0qgRI4yeC6vMxEV2dgyr2TiD+2PQ10o+cOhdVAcwfg==}
+
+ micromark-extension-gfm-task-list-item@2.1.0:
+ resolution: {integrity: sha512-qIBZhqxqI6fjLDYFTBIa4eivDMnP+OZqsNwmQ3xNLE4Cxwc+zfQEfbs6tzAo2Hjq+bh6q5F+Z8/cksrLFYWQQw==}
+
+ micromark-extension-gfm@3.0.0:
+ resolution: {integrity: sha512-vsKArQsicm7t0z2GugkCKtZehqUm31oeGBV/KVSorWSy8ZlNAv7ytjFhvaryUiCUJYqs+NoE6AFhpQvBTM6Q4w==}
+
+ micromark-extension-math@3.1.0:
+ resolution: {integrity: sha512-lvEqd+fHjATVs+2v/8kg9i5Q0AP2k85H0WUOwpIVvUML8BapsMvh1XAogmQjOCsLpoKRCVQqEkQBB3NhVBcsOg==}
+
+ micromark-factory-destination@2.0.1:
+ resolution: {integrity: sha512-Xe6rDdJlkmbFRExpTOmRj9N3MaWmbAgdpSrBQvCFqhezUn4AHqJHbaEnfbVYYiexVSs//tqOdY/DxhjdCiJnIA==}
+
+ micromark-factory-label@2.0.1:
+ resolution: {integrity: sha512-VFMekyQExqIW7xIChcXn4ok29YE3rnuyveW3wZQWWqF4Nv9Wk5rgJ99KzPvHjkmPXF93FXIbBp6YdW3t71/7Vg==}
+
+ micromark-factory-space@2.0.1:
+ resolution: {integrity: sha512-zRkxjtBxxLd2Sc0d+fbnEunsTj46SWXgXciZmHq0kDYGnck/ZSGj9/wULTV95uoeYiK5hRXP2mJ98Uo4cq/LQg==}
+
+ micromark-factory-title@2.0.1:
+ resolution: {integrity: sha512-5bZ+3CjhAd9eChYTHsjy6TGxpOFSKgKKJPJxr293jTbfry2KDoWkhBb6TcPVB4NmzaPhMs1Frm9AZH7OD4Cjzw==}
+
+ micromark-factory-whitespace@2.0.1:
+ resolution: {integrity: sha512-Ob0nuZ3PKt/n0hORHyvoD9uZhr+Za8sFoP+OnMcnWK5lngSzALgQYKMr9RJVOWLqQYuyn6ulqGWSXdwf6F80lQ==}
+
+ micromark-util-character@2.1.1:
+ resolution: {integrity: sha512-wv8tdUTJ3thSFFFJKtpYKOYiGP2+v96Hvk4Tu8KpCAsTMs6yi+nVmGh1syvSCsaxz45J6Jbw+9DD6g97+NV67Q==}
+
+ micromark-util-chunked@2.0.1:
+ resolution: {integrity: sha512-QUNFEOPELfmvv+4xiNg2sRYeS/P84pTW0TCgP5zc9FpXetHY0ab7SxKyAQCNCc1eK0459uoLI1y5oO5Vc1dbhA==}
+
+ micromark-util-classify-character@2.0.1:
+ resolution: {integrity: sha512-K0kHzM6afW/MbeWYWLjoHQv1sgg2Q9EccHEDzSkxiP/EaagNzCm7T/WMKZ3rjMbvIpvBiZgwR3dKMygtA4mG1Q==}
+
+ micromark-util-combine-extensions@2.0.1:
+ resolution: {integrity: sha512-OnAnH8Ujmy59JcyZw8JSbK9cGpdVY44NKgSM7E9Eh7DiLS2E9RNQf0dONaGDzEG9yjEl5hcqeIsj4hfRkLH/Bg==}
+
+ micromark-util-decode-numeric-character-reference@2.0.2:
+ resolution: {integrity: sha512-ccUbYk6CwVdkmCQMyr64dXz42EfHGkPQlBj5p7YVGzq8I7CtjXZJrubAYezf7Rp+bjPseiROqe7G6foFd+lEuw==}
+
+ micromark-util-decode-string@2.0.1:
+ resolution: {integrity: sha512-nDV/77Fj6eH1ynwscYTOsbK7rR//Uj0bZXBwJZRfaLEJ1iGBR6kIfNmlNqaqJf649EP0F3NWNdeJi03elllNUQ==}
+
+ micromark-util-encode@2.0.1:
+ resolution: {integrity: sha512-c3cVx2y4KqUnwopcO9b/SCdo2O67LwJJ/UyqGfbigahfegL9myoEFoDYZgkT7f36T0bLrM9hZTAaAyH+PCAXjw==}
+
+ micromark-util-html-tag-name@2.0.1:
+ resolution: {integrity: sha512-2cNEiYDhCWKI+Gs9T0Tiysk136SnR13hhO8yW6BGNyhOC4qYFnwF1nKfD3HFAIXA5c45RrIG1ub11GiXeYd1xA==}
+
+ micromark-util-normalize-identifier@2.0.1:
+ resolution: {integrity: sha512-sxPqmo70LyARJs0w2UclACPUUEqltCkJ6PhKdMIDuJ3gSf/Q+/GIe3WKl0Ijb/GyH9lOpUkRAO2wp0GVkLvS9Q==}
+
+ micromark-util-resolve-all@2.0.1:
+ resolution: {integrity: sha512-VdQyxFWFT2/FGJgwQnJYbe1jjQoNTS4RjglmSjTUlpUMa95Htx9NHeYW4rGDJzbjvCsl9eLjMQwGeElsqmzcHg==}
+
+ micromark-util-sanitize-uri@2.0.1:
+ resolution: {integrity: sha512-9N9IomZ/YuGGZZmQec1MbgxtlgougxTodVwDzzEouPKo3qFWvymFHWcnDi2vzV1ff6kas9ucW+o3yzJK9YB1AQ==}
+
+ micromark-util-subtokenize@2.1.0:
+ resolution: {integrity: sha512-XQLu552iSctvnEcgXw6+Sx75GflAPNED1qx7eBJ+wydBb2KCbRZe+NwvIEEMM83uml1+2WSXpBAcp9IUCgCYWA==}
+
+ micromark-util-symbol@2.0.1:
+ resolution: {integrity: sha512-vs5t8Apaud9N28kgCrRUdEed4UJ+wWNvicHLPxCa9ENlYuAY31M0ETy5y1vA33YoNPDFTghEbnh6efaE8h4x0Q==}
+
+ micromark-util-types@2.0.2:
+ resolution: {integrity: sha512-Yw0ECSpJoViF1qTU4DC6NwtC4aWGt1EkzaQB8KPPyCRR8z9TWeV0HbEFGTO+ZY1wB22zmxnJqhPyTpOVCpeHTA==}
+
+ micromark@4.0.2:
+ resolution: {integrity: sha512-zpe98Q6kvavpCr1NPVSCMebCKfD7CA2NqZ+rykeNhONIJBpc1tFKt9hucLGwha3jNTNI8lHpctWJWoimVF4PfA==}
+
+ micromatch@4.0.8:
+ resolution: {integrity: sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==}
+ engines: {node: '>=8.6'}
+
+ mime-db@1.52.0:
+ resolution: {integrity: sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==}
+ engines: {node: '>= 0.6'}
+
+ mime-db@1.54.0:
+ resolution: {integrity: sha512-aU5EJuIN2WDemCcAp2vFBfp/m4EAhWJnUNSSw0ixs7/kXbd6Pg64EmwJkNdFhB8aWt1sH2CTXrLxo/iAGV3oPQ==}
+ engines: {node: '>= 0.6'}
+
+ mime-types@2.1.35:
+ resolution: {integrity: sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==}
+ engines: {node: '>= 0.6'}
+
+ mime-types@3.0.2:
+ resolution: {integrity: sha512-Lbgzdk0h4juoQ9fCKXW4by0UJqj+nOOrI9MJ1sSj4nI8aI2eo1qmvQEie4VD1glsS250n15LsWsYtCugiStS5A==}
+ engines: {node: '>=18'}
+
+ mime@2.5.2:
+ resolution: {integrity: sha512-tqkh47FzKeCPD2PUiPB6pkbMzsCasjxAfC62/Wap5qrUWcb+sFasXUC5I3gYM5iBM8v/Qpn4UK0x+j0iHyFPDg==}
+ engines: {node: '>=4.0.0'}
+ hasBin: true
+
+ mime@4.1.0:
+ resolution: {integrity: sha512-X5ju04+cAzsojXKes0B/S4tcYtFAJ6tTMuSPBEn9CPGlrWr8Fiw7qYeLT0XyH80HSoAoqWCaz+MWKh22P7G1cw==}
+ engines: {node: '>=16'}
+ hasBin: true
+
+ mimic-fn@4.0.0:
+ resolution: {integrity: sha512-vqiC06CuhBTUdZH+RYl8sFrL096vA45Ok5ISO6sE/Mr1jRbGH4Csnhi8f3wKVl7x8mO4Au7Ir9D3Oyv1VYMFJw==}
+ engines: {node: '>=12'}
+
+ mini-css-extract-plugin@2.10.2:
+ resolution: {integrity: sha512-AOSS0IdEB95ayVkxn5oGzNQwqAi2J0Jb/kKm43t7H73s8+f5873g0yuj0PNvK4dO75mu5DHg4nlgp4k6Kga8eg==}
+ engines: {node: '>= 12.13.0'}
+ peerDependencies:
+ webpack: ^5.0.0
+
+ minimatch@10.2.5:
+ resolution: {integrity: sha512-MULkVLfKGYDFYejP07QOurDLLQpcjk7Fw+7jXS2R2czRQzR56yHRveU5NDJEOviH+hETZKSkIk5c+T23GjFUMg==}
+ engines: {node: 18 || 20 || >=22}
+
+ minimatch@3.1.5:
+ resolution: {integrity: sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==}
+
+ minimatch@5.1.9:
+ resolution: {integrity: sha512-7o1wEA2RyMP7Iu7GNba9vc0RWWGACJOCZBJX2GJWip0ikV+wcOsgVuY9uE8CPiyQhkGFSlhuSkZPavN7u1c2Fw==}
+ engines: {node: '>=10'}
+
+ minimatch@9.0.9:
+ resolution: {integrity: sha512-OBwBN9AL4dqmETlpS2zasx+vTeWclWzkblfZk7KTA5j3jeOONz/tRCnZomUyvNg83wL5Zv9Ss6HMJXAgL8R2Yg==}
+ engines: {node: '>=16 || 14 >=14.17'}
+
+ minimist@1.2.8:
+ resolution: {integrity: sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==}
+
+ minipass@7.1.3:
+ resolution: {integrity: sha512-tEBHqDnIoM/1rXME1zgka9g6Q2lcoCkxHLuc7ODJ5BxbP5d4c2Z5cGgtXAku59200Cx7diuHTOYfSBD8n6mm8A==}
+ engines: {node: '>=16 || 14 >=14.17'}
+
+ minizlib@3.1.0:
+ resolution: {integrity: sha512-KZxYo1BUkWD2TVFLr0MQoM8vUUigWD3LlD83a/75BqC+4qE0Hb1Vo5v1FgcfaNXvfXzr+5EhQ6ing/CaBijTlw==}
+ engines: {node: '>= 18'}
+
+ mkdist@2.4.1:
+ resolution: {integrity: sha512-Ezk0gi04GJBkqMfsksICU5Rjoemc4biIekwgrONWVPor2EO/N9nBgN6MZXAf7Yw4mDDhrNyKbdETaHNevfumKg==}
+ hasBin: true
+ peerDependencies:
+ sass: ^1.92.1
+ typescript: '>=5.9.2'
+ vue: 3.5.34
+ vue-sfc-transformer: ^0.1.1
+ vue-tsc: ^1.8.27 || ^2.0.21 || ^3.0.0
+ peerDependenciesMeta:
+ sass:
+ optional: true
+ typescript:
+ optional: true
+ vue:
+ optional: true
+ vue-sfc-transformer:
+ optional: true
+ vue-tsc:
+ optional: true
+
+ mlly@1.8.2:
+ resolution: {integrity: sha512-d+ObxMQFmbt10sretNDytwt85VrbkhhUA/JBGm1MPaWJ65Cl4wOgLaB1NYvJSZ0Ef03MMEU/0xpPMXUIQ29UfA==}
+
+ mocked-exports@0.1.1:
+ resolution: {integrity: sha512-aF7yRQr/Q0O2/4pIXm6PZ5G+jAd7QS4Yu8m+WEeEHGnbo+7mE36CbLSDQiXYV8bVL3NfmdeqPJct0tUlnjVSnA==}
+
+ mri@1.2.0:
+ resolution: {integrity: sha512-tzzskb3bG8LvYGFF/mDTpq3jpI6Q9wc3LEmBaghu+DdCssd1FakN7Bc0hVNmEyGq1bq3RgfkCb3cmQLpNPOroA==}
+ engines: {node: '>=4'}
+
+ mrmime@2.0.1:
+ resolution: {integrity: sha512-Y3wQdFg2Va6etvQ5I82yUhGdsKrcYox6p7FfL1LbK2J4V01F9TGlepTIhnK24t7koZibmg82KGglhA1XK5IsLQ==}
+ engines: {node: '>=10'}
+
+ ms@2.1.3:
+ resolution: {integrity: sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==}
+
+ muggle-string@0.4.1:
+ resolution: {integrity: sha512-VNTrAak/KhO2i8dqqnqnAHOa3cYBwXEZe9h+D5h/1ZqFSTEFHdM65lR7RoIqq3tBBYavsOXV84NoHXZ0AkPyqQ==}
+
+ mz@2.7.0:
+ resolution: {integrity: sha512-z81GNO7nnYMEhrGh9LeymoE4+Yr0Wn5McHIZMK5cfQCl+NDX08sCZgUc9/6MHni9IWuFLm1Z3HTCXu2z9fN62Q==}
+
+ nanoid@3.3.12:
+ resolution: {integrity: sha512-ZB9RH/39qpq5Vu6Y+NmUaFhQR6pp+M2Xt76XBnEwDaGcVAqhlvxrl3B2bKS5D3NH3QR76v3aSrKaF/Kiy7lEtQ==}
+ engines: {node: ^10 || ^12 || ^13.7 || ^14 || >=15.0.1}
+ hasBin: true
+
+ nanotar@0.3.0:
+ resolution: {integrity: sha512-Kv2JYYiCzt16Kt5QwAc9BFG89xfPNBx+oQL4GQXD9nLqPkZBiNaqaCWtwnbk/q7UVsTYevvM1b0UF8zmEI4pCg==}
+
+ napi-postinstall@0.3.4:
+ resolution: {integrity: sha512-PHI5f1O0EP5xJ9gQmFGMS6IZcrVvTjpXjz7Na41gTE7eE2hK11lg04CECCYEEjdc17EV4DO+fkGEtt7TpTaTiQ==}
+ engines: {node: ^12.20.0 || ^14.18.0 || >=16.0.0}
+ hasBin: true
+
+ natural-compare@1.4.0:
+ resolution: {integrity: sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==}
+
+ natural-orderby@5.0.0:
+ resolution: {integrity: sha512-kKHJhxwpR/Okycz4HhQKKlhWe4ASEfPgkSWNmKFHd7+ezuQlxkA5cM3+XkBPvm1gmHen3w53qsYAv+8GwRrBlg==}
+ engines: {node: '>=18'}
+
+ neo-async@2.6.2:
+ resolution: {integrity: sha512-Yd3UES5mWCSqR+qNT93S3UoYUkqAZ9lLg8a7g9rimsWmYGK8cVToA4/sF3RrshdyV3sAGMXVUmpMYOw+dLpOuw==}
+
+ nf3@0.3.17:
+ resolution: {integrity: sha512-N9zEWySuJFw+gR0lhS5863YsvNeudOdqRyFvNb+jMXbeTJOdrjDqkCpDginIZfUm0LzT1t1nCRiDeqQm/8kirQ==}
+
+ nitro@3.0.260311-beta:
+ resolution: {integrity: sha512-0o0fJ9LUh4WKUqJNX012jyieUOtMCnadkNDWr0mHzdraoHpJP/1CGNefjRyZyMXSpoJfwoWdNEZu2iGf35TUvQ==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ hasBin: true
+ peerDependencies:
+ dotenv: '*'
+ giget: '*'
+ jiti: ^2.6.1
+ rollup: ^4.59.0
+ vite: 8.0.12
+ xml2js: ^0.6.2
+ zephyr-agent: ^0.1.15
+ peerDependenciesMeta:
+ dotenv:
+ optional: true
+ giget:
+ optional: true
+ jiti:
+ optional: true
+ rollup:
+ optional: true
+ vite:
+ optional: true
+ xml2js:
+ optional: true
+ zephyr-agent:
+ optional: true
+
+ nitropack@2.13.4:
+ resolution: {integrity: sha512-tX7bT6zxNeMwkc6hxHiZeUoTOjVrcjoh1Z3cmxOlodIqjl4HISgqfGOmkWSayky3Nv9Z5+KQH52F8nmXJY5AAA==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ hasBin: true
+ peerDependencies:
+ xml2js: ^0.6.2
+ peerDependenciesMeta:
+ xml2js:
+ optional: true
+
+ node-abort-controller@3.1.1:
+ resolution: {integrity: sha512-AGK2yQKIjRuqnc6VkX2Xj5d+QW8xZ87pa1UK6yA6ouUyuxfHuMP6umE5QK7UmTeOAymo+Zx1Fxiuw9rVx8taHQ==}
+
+ node-addon-api@7.1.1:
+ resolution: {integrity: sha512-5m3bsyrjFWE1xf7nz7YXdN4udnVtXK6/Yfgn5qnahL6bCkf2yKt4k3nuTKAtT4r3IG8JNR2ncsIMdZuAzJjHQQ==}
+
+ node-emoji@2.2.0:
+ resolution: {integrity: sha512-Z3lTE9pLaJF47NyMhd4ww1yFTAP8YhYI8SleJiHzM46Fgpm5cnNzSl9XfzFNqbaz+VlJrIj3fXQ4DeN1Rjm6cw==}
+ engines: {node: '>=18'}
+
+ node-fetch-native@1.6.7:
+ resolution: {integrity: sha512-g9yhqoedzIUm0nTnTqAQvueMPVOuIY16bqgAJJC8XOOubYFNwz6IER9qs0Gq2Xd0+CecCKFjtdDTMA4u4xG06Q==}
+
+ node-fetch@2.7.0:
+ resolution: {integrity: sha512-c4FRfUm/dbcWZ7U+1Wq0AwCyFL+3nt2bEw05wfxSz+DWpWsitgmSgYmy2dQdWyKC1694ELPqMs/YzUSNozLt8A==}
+ engines: {node: 4.x || >=6.0.0}
+ peerDependencies:
+ encoding: ^0.1.0
+ peerDependenciesMeta:
+ encoding:
+ optional: true
+
+ node-forge@1.4.0:
+ resolution: {integrity: sha512-LarFH0+6VfriEhqMMcLX2F7SwSXeWwnEAJEsYm5QKWchiVYVvJyV9v7UDvUv+w5HO23ZpQTXDv/GxdDdMyOuoQ==}
+ engines: {node: '>= 6.13.0'}
+
+ node-gyp-build@4.8.4:
+ resolution: {integrity: sha512-LA4ZjwlnUblHVgq0oBF3Jl/6h/Nvs5fzBLwdEF4nuxnFdsfajde4WfxtJr3CaiH+F6ewcIB/q4jQ4UzPyid+CQ==}
+ hasBin: true
+
+ node-mock-http@1.0.4:
+ resolution: {integrity: sha512-8DY+kFsDkNXy1sJglUfuODx1/opAGJGyrTuFqEoN90oRc2Vk0ZbD4K2qmKXBBEhZQzdKHIVfEJpDU8Ak2NJEvQ==}
+
+ node-releases@2.0.46:
+ resolution: {integrity: sha512-GYVXHE2KnrzAfsAjl4uP++evGFCrAU1jta4ubEjIG7YWt/64Gqv66a30yKwWczVjA6j3bM4nBwH7Pk1JmDHaxQ==}
+ engines: {node: '>=18'}
+
+ nopt@7.2.1:
+ resolution: {integrity: sha512-taM24ViiimT/XntxbPyJQzCG+p4EKOpgD3mxFwW38mGjVUrfERQOeY4EDHjdnptttfHuHQXFx+lTP08Q+mLa/w==}
+ engines: {node: ^14.17.0 || ^16.13.0 || >=18.0.0}
+ hasBin: true
+
+ nopt@8.1.0:
+ resolution: {integrity: sha512-ieGu42u/Qsa4TFktmaKEwM6MQH0pOWnaB3htzh0JRtx84+Mebc0cbZYN5bC+6WTZ4+77xrL9Pn5m7CV6VIkV7A==}
+ engines: {node: ^18.17.0 || >=20.5.0}
+ hasBin: true
+
+ normalize-package-data@6.0.2:
+ resolution: {integrity: sha512-V6gygoYb/5EmNI+MEGrWkC+e6+Rr7mTmfHrxDbLzxQogBkgzo76rkok0Am6thgSF7Mv2nLOajAJj5vDJZEFn7g==}
+ engines: {node: ^16.14.0 || >=18.0.0}
+
+ normalize-path@3.0.0:
+ resolution: {integrity: sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==}
+ engines: {node: '>=0.10.0'}
+
+ npm-normalize-package-bin@3.0.1:
+ resolution: {integrity: sha512-dMxCf+zZ+3zeQZXKxmyuCKlIDPGuv8EF940xbkC4kQVDTtqoh6rJFO+JTKSA6/Rwi0getWmtuy4Itup0AMcaDQ==}
+ engines: {node: ^14.17.0 || ^16.13.0 || >=18.0.0}
+
+ npm-run-path@5.3.0:
+ resolution: {integrity: sha512-ppwTtiJZq0O/ai0z7yfudtBpWIoxM8yE6nHi1X47eFR2EWORqfbu6CnPlNsjeN683eT0qG6H/Pyf9fCcvjnnnQ==}
+ engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0}
+
+ npm-run-path@6.0.0:
+ resolution: {integrity: sha512-9qny7Z9DsQU8Ou39ERsPU4OZQlSTP47ShQzuKZ6PRXpYLtIFgl/DEBYEXKlvcEa+9tHVcK8CF81Y2V72qaZhWA==}
+ engines: {node: '>=18'}
+
+ nth-check@2.1.1:
+ resolution: {integrity: sha512-lqjrjmaOoAnWfMmBPL+XNnynZh2+swxiX3WUE0s4yEHI6m+AwrK2UZOimIRl3X/4QctVqS8AiZjFqyOGrMXb/w==}
+
+ nuxt-content-twoslash@0.4.0:
+ resolution: {integrity: sha512-mfmvLTIQBSUeQD9Ydj8XdyIz1GfL8VxQ9EujS4vTb2JgfLky9n4BHTpptKs1puTlbX4uNF81od8f/skZOSnZWQ==}
+ hasBin: true
+ peerDependencies:
+ '@nuxtjs/mdc': '>=0.14.0'
+
+ nypm@0.6.6:
+ resolution: {integrity: sha512-vRyr0r4cbBapw07Xw8xrj9Teq3o7MUD35rSaTcanDbW+aK2XHDgJFiU6ZTj2GBw7Q12ysdsyFss+Vdz4hQ0Y6Q==}
+ engines: {node: '>=18'}
+ hasBin: true
+
+ object-assign@4.1.1:
+ resolution: {integrity: sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==}
+ engines: {node: '>=0.10.0'}
+
+ object-deep-merge@2.0.1:
+ resolution: {integrity: sha512-aKttDKcU3pyZqKcCkDhsMn70WmZFG2JGDQLP9EcLyTSIFQRCPWLAmBZRLJnrVUrhPG1jETEEbfdgbNtJf1LyMg==}
+
+ object-inspect@1.13.4:
+ resolution: {integrity: sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==}
+ engines: {node: '>= 0.4'}
+
+ object-is@1.1.6:
+ resolution: {integrity: sha512-F8cZ+KfGlSGi09lJT7/Nd6KJZ9ygtvYC0/UYYLI9nmQKLMnydpB9yvbv9K1uSkEu7FU9vYPmVwLg328tX+ot3Q==}
+ engines: {node: '>= 0.4'}
+
+ object-keys@1.1.1:
+ resolution: {integrity: sha512-NuAESUOUMrlIXOfHKzD6bpPu3tYt3xvjNdRIQ+FeT0lNb4K8WR70CaDxhuNguS2XG+GjkyMwOzsN5ZktImfhLA==}
+ engines: {node: '>= 0.4'}
+
+ object.assign@4.1.7:
+ resolution: {integrity: sha512-nK28WOo+QIjBkDduTINE4JkF/UJJKyf2EJxvJKfblDpyg0Q+pkOHNTL0Qwy6NP6FhE/EnzV73BxxqcJaXY9anw==}
+ engines: {node: '>= 0.4'}
+
+ obug@2.1.1:
+ resolution: {integrity: sha512-uTqF9MuPraAQ+IsnPf366RG4cP9RtUi7MLO1N3KEc+wb0a6yKpeL0lmk2IB1jY5KHPAlTc6T/JRdC/YqxHNwkQ==}
+
+ obuild@0.4.36:
+ resolution: {integrity: sha512-1kenNV3u2Xo+hsP6RSugfmQWG9sspawGJMQ3zRG1ZcE+vaDCfiWYCR5J9O7ZRRu6t/b82nyDxbHo817ZI8OeJg==}
+ hasBin: true
+
+ ocache@0.1.4:
+ resolution: {integrity: sha512-e7geNdWjxSnvsSgvLuPvgKgu7ubM10ZmTPOgpr7mz2BXYtvjMKTiLhjFi/gWU8chkuP6hNkZBsa9LzOusyaqkQ==}
+
+ ofetch@1.5.1:
+ resolution: {integrity: sha512-2W4oUZlVaqAPAil6FUg/difl6YhqhUR7x2eZY4bQCko22UXg3hptq9KLQdqFClV+Wu85UX7hNtdGTngi/1BxcA==}
+
+ ofetch@2.0.0-alpha.3:
+ resolution: {integrity: sha512-zpYTCs2byOuft65vI3z43Dd6iSdFbOZZLb9/d21aCpx2rGastVU9dOCv0lu4ykc1Ur1anAYjDi3SUvR0vq50JA==}
+
+ ohash@2.0.11:
+ resolution: {integrity: sha512-RdR9FQrFwNBNXAr4GixM8YaRZRJ5PUWbKYbE5eOsrwAjJW0q2REGcf79oYPsLyskQCZG1PLN+S/K1V00joZAoQ==}
+
+ on-change@6.0.2:
+ resolution: {integrity: sha512-08+12qcOVEA0fS9g/VxKS27HaT94nRutUT77J2dr8zv/unzXopvhBuF8tNLWsoLQ5IgrQ6eptGeGqUYat82U1w==}
+ engines: {node: '>=20'}
+
+ on-finished@2.4.1:
+ resolution: {integrity: sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==}
+ engines: {node: '>= 0.8'}
+
+ onetime@6.0.0:
+ resolution: {integrity: sha512-1FlR+gjXK7X+AsAHso35MnyN5KqGwJRi/31ft6x0M194ht7S+rWAvd7PHss9xSKMzE0asv1pyIHaJYq+BbacAQ==}
+ engines: {node: '>=12'}
+
+ oniguruma-parser@0.12.2:
+ resolution: {integrity: sha512-6HVa5oIrgMC6aA6WF6XyyqbhRPJrKR02L20+2+zpDtO5QAzGHAUGw5TKQvwi5vctNnRHkJYmjAhRVQF2EKdTQw==}
+
+ oniguruma-to-es@4.3.6:
+ resolution: {integrity: sha512-csuQ9x3Yr0cEIs/Zgx/OEt9iBw9vqIunAPQkx19R/fiMq2oGVTgcMqO/V3Ybqefr1TBvosI6jU539ksaBULJyA==}
+
+ open@10.2.0:
+ resolution: {integrity: sha512-YgBpdJHPyQ2UE5x+hlSXcnejzAvD0b22U2OuAP+8OnlJT+PjWPxtgmGqKKc+RgTM63U9gN0YzrYc71R2WT/hTA==}
+ engines: {node: '>=18'}
+
+ open@11.0.0:
+ resolution: {integrity: sha512-smsWv2LzFjP03xmvFoJ331ss6h+jixfA4UUV/Bsiyuu4YJPfN+FIQGOIiv4w9/+MoHkfkJ22UIaQWRVFRfH6Vw==}
+ engines: {node: '>=20'}
+
+ opener@1.5.2:
+ resolution: {integrity: sha512-ur5UIdyw5Y7yEj9wLzhqXiy6GZ3Mwx0yGI+5sMn2r0N0v3cKJvUmFH5yPP+WXh9e0xfyzyJX95D8l088DNFj7A==}
+ hasBin: true
+
+ optionator@0.9.4:
+ resolution: {integrity: sha512-6IpQ7mKUxRcZNLIObR0hz7lxsapSSIYNZJwXPGeF0mTVqGKFIXj1DQcMoT22S3ROcLyY/rz0PWaWZ9ayWmad9g==}
+ engines: {node: '>= 0.8.0'}
+
+ oxc-parser@0.124.0:
+ resolution: {integrity: sha512-h07SFj/tp2U3cf3+LFX6MmOguQiM9ahwpGs0ZK5CGhgL8p4kk24etrJKsEzhXAvo7mfvoKTZooZ5MLKAPRmJ1g==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+
+ oxc-parser@0.126.0:
+ resolution: {integrity: sha512-FktCvLby/mOHyuijZt22+nOt10dS24gGUZE3XwIbUg7Kf4+rer3/5T7RgwzazlNuVsCjPloZ3p8E+4ONT3A8Kw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+
+ oxc-parser@0.127.0:
+ resolution: {integrity: sha512-bkgD4qHlN7WxLdX8bLXdaU54TtQtAIg/ZBAfm0aje/mo3MRDo3P0hZSgr4U7O3xfX+fQmR5AP04JS/TGcZLcFA==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+
+ oxc-parser@0.130.0:
+ resolution: {integrity: sha512-X0PJ+NmOok8qP3vK9uaW431ngkdM9UPEK7KG466urtIL2+EYTEgbZK2yqe2MWKJKBjRlFweP/pJPx0x9muMEVw==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+
+ oxc-resolver@11.19.1:
+ resolution: {integrity: sha512-qE/CIg/spwrTBFt5aKmwe3ifeDdLfA2NESN30E42X/lII5ClF8V7Wt6WIJhcGZjp0/Q+nQ+9vgxGk//xZNX2hg==}
+
+ oxc-transform@0.131.0:
+ resolution: {integrity: sha512-ml0/elXPNnDnuHo3VHmEMN2fnybmKx7YL+0E+gMQ0fuHRZHXYJzF6YJ01KsCWg6FXY6pbZcjm7DC3xwGHnB/BA==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+
+ oxc-walker@0.7.0:
+ resolution: {integrity: sha512-54B4KUhrzbzc4sKvKwVYm7E2PgeROpGba0/2nlNZMqfDyca+yOor5IMb4WLGBatGDT0nkzYdYuzylg7n3YfB7A==}
+ peerDependencies:
+ oxc-parser: '>=0.98.0'
+
+ oxc-walker@1.0.0:
+ resolution: {integrity: sha512-eMsHflAGfOskpWxtp9xP/f5b96XLEU8ifTd2gOOCkdux9HMxKGy5S1ru0Gh1B3aPu+YbfmWUUVkcb7MrZz3XyQ==}
+ peerDependencies:
+ oxc-parser: '>=0.98.0'
+ rolldown: '>=1.0.0'
+ peerDependenciesMeta:
+ oxc-parser:
+ optional: true
+ rolldown:
+ optional: true
+
+ p-limit@3.1.0:
+ resolution: {integrity: sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ==}
+ engines: {node: '>=10'}
+
+ p-limit@4.0.0:
+ resolution: {integrity: sha512-5b0R4txpzjPWVw/cXXUResoD4hb6U/x9BH08L7nw+GN1sezDzPdxeRvpc9c433fZhBan/wusjbCsqwqm4EIBIQ==}
+ engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0}
+
+ p-limit@7.3.0:
+ resolution: {integrity: sha512-7cIXg/Z0M5WZRblrsOla88S4wAK+zOQQWeBYfV3qJuJXMr+LnbYjaadrFaS0JILfEDPVqHyKnZ1Z/1d6J9VVUw==}
+ engines: {node: '>=20'}
+
+ p-locate@5.0.0:
+ resolution: {integrity: sha512-LaNjtRWUBY++zB5nE/NwcaoMylSPk+S+ZHNB1TzdbMJMny6dynpAGt7X/tl/QYq3TIeE6nxHppbo2LGymrG5Pw==}
+ engines: {node: '>=10'}
+
+ p-locate@6.0.0:
+ resolution: {integrity: sha512-wPrq66Llhl7/4AGC6I+cqxT07LhXvWL08LNXz1fENOw0Ap4sRZZ/gZpTTJ5jpurzzzfS2W/Ge9BY3LgLjCShcw==}
+ engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0}
+
+ package-json-from-dist@1.0.1:
+ resolution: {integrity: sha512-UEZIS3/by4OC8vL3P2dTXRETpebLI2NiI5vIrjaD/5UtrkFX/tNbwjTSRAGC/+7CAo2pIcBaRgWmcBBHcsaCIw==}
+
+ package-manager-detector@1.6.0:
+ resolution: {integrity: sha512-61A5ThoTiDG/C8s8UMZwSorAGwMJ0ERVGj2OjoW5pAalsNOg15+iQiPzrLJ4jhZ1HJzmC2PIHT2oEiH3R5fzNA==}
+
+ parent-module@1.0.1:
+ resolution: {integrity: sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==}
+ engines: {node: '>=6'}
+
+ parse-entities@4.0.2:
+ resolution: {integrity: sha512-GG2AQYWoLgL877gQIKeRPGO1xF9+eG1ujIb5soS5gPvLQ1y2o8FL90w2QWNdf9I361Mpp7726c+lj3U0qK1uGw==}
+
+ parse-imports-exports@0.2.4:
+ resolution: {integrity: sha512-4s6vd6dx1AotCx/RCI2m7t7GCh5bDRUtGNvRfHSP2wbBQdMi67pPe7mtzmgwcaQ8VKK/6IB7Glfyu3qdZJPybQ==}
+
+ parse-json@5.2.0:
+ resolution: {integrity: sha512-ayCKvm/phCGxOkYRSCM82iDwct8/EonSEgCSxWxD7ve6jHggsFl4fZVQBPRNgQoKiuV/odhFrGzQXZwbifC8Rg==}
+ engines: {node: '>=8'}
+
+ parse-json@8.3.0:
+ resolution: {integrity: sha512-ybiGyvspI+fAoRQbIPRddCcSTV9/LsJbf0e/S85VLowVGzRmokfneg2kwVW/KU5rOXrPSbF1qAKPMgNTqqROQQ==}
+ engines: {node: '>=18'}
+
+ parse-statements@1.0.11:
+ resolution: {integrity: sha512-HlsyYdMBnbPQ9Jr/VgJ1YF4scnldvJpJxCVx6KgqPL4dxppsWrJHCIIxQXMJrqGnsRkNPATbeMJ8Yxu7JMsYcA==}
+
+ parse5-htmlparser2-tree-adapter@6.0.1:
+ resolution: {integrity: sha512-qPuWvbLgvDGilKc5BoicRovlT4MtYT6JfJyBOMDsKoiT+GiuP5qyrPCnR9HcPECIJJmZh5jRndyNThnhhb/vlA==}
+
+ parse5@5.1.1:
+ resolution: {integrity: sha512-ugq4DFI0Ptb+WWjAdOK16+u/nHfiIrcE+sh8kZMaM0WllQKLI9rOUq6c2b7cwPkXdzfQESqvoqK6ug7U/Yyzug==}
+
+ parse5@6.0.1:
+ resolution: {integrity: sha512-Ofn/CTFzRGTTxwpNEs9PP93gXShHcTq255nzRYSKe8AkVpZY7e1fpmTfOyoIvjP5HG7Z2ZM7VS9PPhQGW2pOpw==}
+
+ parse5@7.3.0:
+ resolution: {integrity: sha512-IInvU7fabl34qmi9gY8XOVxhYyMyuH2xUNpb2q8/Y+7552KlejkRvqvD19nMoUW/uQGGbqNpA6Tufu5FL5BZgw==}
+
+ parse5@8.0.1:
+ resolution: {integrity: sha512-z1e/HMG90obSGeidlli3hj7cbocou0/wa5HacvI3ASx34PecNjNQeaHNo5WIZpWofN9kgkqV1q5YvXe3F0FoPw==}
+
+ parseurl@1.3.3:
+ resolution: {integrity: sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==}
+ engines: {node: '>= 0.8'}
+
+ path-browserify@1.0.1:
+ resolution: {integrity: sha512-b7uo2UCUOYZcnF/3ID0lulOJi/bafxa1xPe7ZPsammBSpjSWQkjNxlt635YGS2MiR9GjvuXCtz2emr3jbsz98g==}
+
+ path-exists@4.0.0:
+ resolution: {integrity: sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==}
+ engines: {node: '>=8'}
+
+ path-exists@5.0.0:
+ resolution: {integrity: sha512-RjhtfwJOxzcFmNOi6ltcbcu4Iu+FL3zEj83dk4kAS+fVpTxXLO1b38RvJgT/0QwvV/L3aY9TAnyv0EOqW4GoMQ==}
+ engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0}
+
+ path-key@3.1.1:
+ resolution: {integrity: sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==}
+ engines: {node: '>=8'}
+
+ path-key@4.0.0:
+ resolution: {integrity: sha512-haREypq7xkM7ErfgIyA0z+Bj4AGKlMSdlQE2jvJo6huWD1EdkKYV+G/T4nq0YEF2vgTT8kqMFKo1uHn950r4SQ==}
+ engines: {node: '>=12'}
+
+ path-parse@1.0.7:
+ resolution: {integrity: sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==}
+
+ path-scurry@1.11.1:
+ resolution: {integrity: sha512-Xa4Nw17FS9ApQFJ9umLiJS4orGjm7ZzwUrwamcGQuHSzDyth9boKDaycYdDcZDuqYATXw4HFXgaqWTctW/v1HA==}
+ engines: {node: '>=16 || 14 >=14.18'}
+
+ path-scurry@2.0.2:
+ resolution: {integrity: sha512-3O/iVVsJAPsOnpwWIeD+d6z/7PmqApyQePUtCndjatj/9I5LylHvt5qluFaBT3I5h3r1ejfR056c+FCv+NnNXg==}
+ engines: {node: 18 || 20 || >=22}
+
+ path-type@4.0.0:
+ resolution: {integrity: sha512-gDKb8aZMDeD/tZWs9P6+q0J9Mwkdl6xMV8TjnGP3qJVJ06bdMgkbBlLU8IdfOsIsFz2BW1rNVT3XuNEl8zPAvw==}
+ engines: {node: '>=8'}
+
+ pathe@1.1.2:
+ resolution: {integrity: sha512-whLdWMYL2TwI08hn8/ZqAbrVemu0LNaNNJZX73O6qaIdCTfXutsLhMkjdENX0qhsQ9uIimo4/aQOmXkoon2nDQ==}
+
+ pathe@2.0.3:
+ resolution: {integrity: sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w==}
+
+ peowly@1.3.3:
+ resolution: {integrity: sha512-5UmUtvuCv3KzBX2NuQw2uF28o0t8Eq4KkPRZfUCzJs+DiNVKw7OaYn29vNDgrt/Pggs23CPlSTqgzlhHJfpT0A==}
+ engines: {node: '>=18.6.0', typescript: '>=5.8'}
+
+ perfect-debounce@2.1.0:
+ resolution: {integrity: sha512-LjgdTytVFXeUgtHZr9WYViYSM/g8MkcTPYDlPa3cDqMirHjKiSZPYd6DoL7pK8AJQr+uWkQvCjHNdiMqsrJs+g==}
+
+ picocolors@1.1.1:
+ resolution: {integrity: sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==}
+
+ picomatch@2.3.2:
+ resolution: {integrity: sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==}
+ engines: {node: '>=8.6'}
+
+ picomatch@4.0.4:
+ resolution: {integrity: sha512-QP88BAKvMam/3NxH6vj2o21R6MjxZUAd6nlwAS/pnGvN9IVLocLHxGYIzFhg6fUQ+5th6P4dv4eW9jX3DSIj7A==}
+ engines: {node: '>=12'}
+
+ pify@2.3.0:
+ resolution: {integrity: sha512-udgsAY+fTnvv7kI7aaxbqwWNb0AHiB0qBO89PZKPkoTmGOgdbrHDKD+0B2X4uTfJ/FT1R09r9gTsjUjNJotuog==}
+ engines: {node: '>=0.10.0'}
+
+ pify@6.1.0:
+ resolution: {integrity: sha512-KocF8ve28eFjjuBKKGvzOBGzG8ew2OqOOSxTTZhirkzH7h3BI1vyzqlR0qbfcDBve1Yzo3FVlWUAtCRrbVN8Fw==}
+ engines: {node: '>=14.16'}
+
+ pkg-pr-new@0.0.74:
+ resolution: {integrity: sha512-f2gScB4cjpVcMLeCMEhkrkt3KJCx3TgHTqaWZx54dUgvQcYASh+Hj+txMLjCkSN5ofHEGEmzi1gXK3lWZ2imTA==}
+ hasBin: true
+
+ pkg-types@1.3.1:
+ resolution: {integrity: sha512-/Jm5M4RvtBFVkKWRu2BLUTNP8/M2a+UwuAX+ae4770q1qVGtfjG+WTCupoZixokjmHiry8uI+dlY8KXYV5HVVQ==}
+
+ pkg-types@2.3.1:
+ resolution: {integrity: sha512-y+ichcgc2LrADuhLNAx8DFjVfgz91pRxfZdI3UDhxHvcVEZsenLO+7XaU5vOp0u/7V/wZ+plyuQxtrDlZJ+yeg==}
+
+ playwright-core@1.60.0:
+ resolution: {integrity: sha512-9bW6zvX/m0lEbgTKJ6YppOKx8H3VOPBMOCFh2irXFOT4BbHgrx5hPjwJYLT40Lu+4qtD36qKc/Hn56StUW57IA==}
+ engines: {node: '>=18'}
+ hasBin: true
+
+ playwright@1.60.0:
+ resolution: {integrity: sha512-hheHdokM8cdqCb0lcE3s+zT4t4W+vvjpGxsZlDnikarzx8tSzMebh3UiFtgqwFwnTnjYQcsyMF8ei2mCO/tpeA==}
+ engines: {node: '>=18'}
+ hasBin: true
+
+ pluralize@8.0.0:
+ resolution: {integrity: sha512-Nc3IT5yHzflTfbjgqWcCPpo7DaKy4FnpB0l/zCAW0Tc7jxAiuqSxHasntB3D7887LSrA93kDJ9IXovxJYxyLCA==}
+ engines: {node: '>=4'}
+
+ pony-cause@2.1.11:
+ resolution: {integrity: sha512-M7LhCsdNbNgiLYiP4WjsfLUuFmCfnjdF6jKe2R9NKl4WFN+HZPGHJZ9lnLP7f9ZnKe3U9nuWD0szirmj+migUg==}
+ engines: {node: '>=12.0.0'}
+
+ possible-typed-array-names@1.1.0:
+ resolution: {integrity: sha512-/+5VFTchJDoVj3bhoqi6UeymcD00DAwb1nJwamzPvHEszJ4FpF6SNNbUbOS8yI56qHzdV8eK0qEfOSiodkTdxg==}
+ engines: {node: '>= 0.4'}
+
+ postcss-calc@10.1.1:
+ resolution: {integrity: sha512-NYEsLHh8DgG/PRH2+G9BTuUdtf9ViS+vdoQ0YA5OQdGsfN4ztiwtDWNtBl9EKeqNMFnIu8IKZ0cLxEQ5r5KVMw==}
+ engines: {node: ^18.12 || ^20.9 || >=22.0}
+ peerDependencies:
+ postcss: ^8.4.38
+
+ postcss-colormin@7.0.10:
+ resolution: {integrity: sha512-yFr6JezOolHLta/buLE71VKPh2mXursp4saVe98/ol8ZnEWhL+racShqPKlvd/DKWLre/39B6HhcMXf7RZ3hxg==}
+ engines: {node: ^18.12.0 || ^20.9.0 || >=22.0}
+ peerDependencies:
+ postcss: ^8.5.13
+
+ postcss-colormin@8.0.0:
+ resolution: {integrity: sha512-KKwMmsSgsmdYXqrjQeqL3tnuIFtctiR1GEMHdjNpDpz/TCRkkkok2mMcreK2zVV3l7POWOmAkR2xYHUpRUK1DA==}
+ engines: {node: ^22.11.0 || ^24.11.0 || >=26.0}
+ peerDependencies:
+ postcss: ^8.5.14
+
+ postcss-convert-values@7.0.12:
+ resolution: {integrity: sha512-xurKu5qqk4viR3Cp3p4xBR4KfnZm4w4ys6+UBwBmeuBSNkH7+DtLnYOYnOffgtE4yx8sH9S1VZ6RAAvROXzP2Q==}
+ engines: {node: ^18.12.0 || ^20.9.0 || >=22.0}
+ peerDependencies:
+ postcss: ^8.5.13
+
+ postcss-convert-values@8.0.0:
+ resolution: {integrity: sha512-Ohtj3rNZWawTRePv5NCHTy8VJSdJ/G/uKuxcxJreOMichuqcT6uEl2TAnopVeJCJ/c13jaSqg7m63yFLM5zBsA==}
+ engines: {node: ^22.11.0 || ^24.11.0 || >=26.0}
+ peerDependencies:
+ postcss: ^8.5.14
+
+ postcss-discard-comments@7.0.8:
+ resolution: {integrity: sha512-CvvS5S9WrXblFXCEJ9nVo+4z+eA7zSC7Z88V1HEJuwlQhlFnYTIjg1xJY+BCUiG2bvICap2tXii4mP22BD108Q==}
+ engines: {node: ^18.12.0 || ^20.9.0 || >=22.0}
+ peerDependencies:
+ postcss: ^8.5.13
+
+ postcss-discard-comments@8.0.0:
+ resolution: {integrity: sha512-zGpvVLj2sbagEp+BTVETvAfkZdGVA6rALNujDK/WTIjdf1/rQOxOG8BBzkI8UQgnw8SkL6xffAfbtGMHFypadw==}
+ engines: {node: ^22.11.0 || ^24.11.0 || >=26.0}
+ peerDependencies:
+ postcss: ^8.5.14
+
+ postcss-discard-duplicates@7.0.4:
+ resolution: {integrity: sha512-VBNn1+EuMZkeGVVtz0gRfbNGtx9IFgAsAV+E2pHtXPrp4qfGBkhTIiAuE/wrb+Y6Pakg9NewAlfTpYIFAWODtw==}
+ engines: {node: ^18.12.0 || ^20.9.0 || >=22.0}
+ peerDependencies:
+ postcss: ^8.5.13
+
+ postcss-discard-duplicates@8.0.0:
+ resolution: {integrity: sha512-zjRyYmNGI3PTipKBBtCgExlmZXQn49KvKoaiNnR2g+iXxeNk7GY5Js2ULtZXPrCYeqjPagrzKIBNcBocvXCR7g==}
+ engines: {node: ^22.11.0 || ^24.11.0 || >=26.0}
+ peerDependencies:
+ postcss: ^8.5.14
+
+ postcss-discard-empty@7.0.3:
+ resolution: {integrity: sha512-M2pyjQCU+/7cMHVtL6bKTHjv0lZnPLMpicgr67Dlth7AbuV9gjVTtUqaRwn6Pp6BwSDspUzhz8SaUrRykJU5Dw==}
+ engines: {node: ^18.12.0 || ^20.9.0 || >=22.0}
+ peerDependencies:
+ postcss: ^8.5.13
+
+ postcss-discard-empty@8.0.0:
+ resolution: {integrity: sha512-kxPJg6EqahbBvm+l7hpYYCtpsv8dlz7Tv6wJXUXZaeuY0WGS61DxfGdZR4uVB/Cx+yi3iOHQVSqpSHKMFaBg6Q==}
+ engines: {node: ^22.11.0 || ^24.11.0 || >=26.0}
+ peerDependencies:
+ postcss: ^8.5.14
+
+ postcss-discard-overridden@7.0.3:
+ resolution: {integrity: sha512-aNovXo9UsZuRNLzHJtp13lHIvinDPfiXBPePpXkSjCbgp++iU2FqE+YxvjIsg6EdyPZsASFbfu+JcBFVsErXIQ==}
+ engines: {node: ^18.12.0 || ^20.9.0 || >=22.0}
+ peerDependencies:
+ postcss: ^8.5.13
+
+ postcss-discard-overridden@8.0.0:
+ resolution: {integrity: sha512-sW2OWH3l9p0FmBSVr228uztFseqroZxwgD7SGF0Ks0dRPDttSo3P8FK5ZBLtWBH2A5+chpB0J2fB/T8heKHLBw==}
+ engines: {node: ^22.11.0 || ^24.11.0 || >=26.0}
+ peerDependencies:
+ postcss: ^8.5.14
+
+ postcss-import-resolver@2.0.0:
+ resolution: {integrity: sha512-y001XYgGvVwgxyxw9J1a5kqM/vtmIQGzx34g0A0Oy44MFcy/ZboZw1hu/iN3VYFjSTRzbvd7zZJJz0Kh0AGkTw==}
+
+ postcss-import@16.1.1:
+ resolution: {integrity: sha512-2xVS1NCZAfjtVdvXiyegxzJ447GyqCeEI5V7ApgQVOWnros1p5lGNovJNapwPpMombyFBfqDwt7AD3n2l0KOfQ==}
+ engines: {node: '>=18.0.0'}
+ peerDependencies:
+ postcss: ^8.0.0
+
+ postcss-loader@8.2.1:
+ resolution: {integrity: sha512-k98jtRzthjj3f76MYTs9JTpRqV1RaaMhEU0Lpw9OTmQZQdppg4B30VZ74BojuBHt3F4KyubHJoXCMUeM8Bqeow==}
+ engines: {node: '>= 18.12.0'}
+ peerDependencies:
+ '@rspack/core': 0.x || ^1.0.0 || ^2.0.0-0
+ postcss: ^7.0.0 || ^8.0.1
+ webpack: ^5.0.0
+ peerDependenciesMeta:
+ '@rspack/core':
+ optional: true
+ webpack:
+ optional: true
+
+ postcss-media-query-parser@0.2.3:
+ resolution: {integrity: sha512-3sOlxmbKcSHMjlUXQZKQ06jOswE7oVkXPxmZdoB1r5l0q6gTFTQSHxNxOrCccElbW7dxNytifNEo8qidX2Vsig==}
+
+ postcss-merge-longhand@7.0.7:
+ resolution: {integrity: sha512-b3mfYUxR388u5Pt0HPcVIUtUDn/k15UfTY9M+ORW+meCR6JLNxoZffiYvXyOYQoRYQNZyX/UFkMCM/mNHxe1qA==}
+ engines: {node: ^18.12.0 || ^20.9.0 || >=22.0}
+ peerDependencies:
+ postcss: ^8.5.13
+
+ postcss-merge-longhand@8.0.0:
+ resolution: {integrity: sha512-YDmAmQ8H+ljfomVpSXvr9NA0GP01fraQJqjWBYoMVGg6rOT+PJLwPyeVo2ekn4WB4ZVSH5ddtK3DTRxbz6CFzg==}
+ engines: {node: ^22.11.0 || ^24.11.0 || >=26.0}
+ peerDependencies:
+ postcss: ^8.5.14
+
+ postcss-merge-rules@7.0.11:
+ resolution: {integrity: sha512-SJUPM18g2BmPhf8BVlbwqWz4aK3pLu6u6xjfwEzra7xL6IBR10sUaiB++EzqcVfadPHrKBSMlNdP+XieykhI+Q==}
+ engines: {node: ^18.12.0 || ^20.9.0 || >=22.0}
+ peerDependencies:
+ postcss: ^8.5.13
+
+ postcss-merge-rules@8.0.0:
+ resolution: {integrity: sha512-bgstL5mpi41dDpnYGDUcI3M814NWkCMcIWpwDqEHXkHg3BT7b4XRAfNEuwJncZOVn/67kVKvWzhfv/7xyrp2uQ==}
+ engines: {node: ^22.11.0 || ^24.11.0 || >=26.0}
+ peerDependencies:
+ postcss: ^8.5.14
+
+ postcss-minify-font-values@7.0.3:
+ resolution: {integrity: sha512-yilG/VOaNI74IylQvAQQxm3/wZVBkXyYUqNUAdxqwtbWUXPsbK1q8Ms0mL83v+f8YicgcyfYCRZtWACUdYajpA==}
+ engines: {node: ^18.12.0 || ^20.9.0 || >=22.0}
+ peerDependencies:
+ postcss: ^8.5.13
+
+ postcss-minify-font-values@8.0.0:
+ resolution: {integrity: sha512-EnOHQEnSt6oH5NrL1DMFAQuwB2IOimFXTCzc9bKfUeH1jREbqIF5MAK4gQJQOC4mPUwJt4sWifAmNZ1qLu6j3Q==}
+ engines: {node: ^22.11.0 || ^24.11.0 || >=26.0}
+ peerDependencies:
+ postcss: ^8.5.14
+
+ postcss-minify-gradients@7.0.5:
+ resolution: {integrity: sha512-YraROyQRg3BI1+Hg8E05B/JPdnTm8EDSVu4P2BxdM+CRiOyfmou809+chGIqo6fQqwjPGQ947nbGncSjmTU1WQ==}
+ engines: {node: ^18.12.0 || ^20.9.0 || >=22.0}
+ peerDependencies:
+ postcss: ^8.5.13
+
+ postcss-minify-gradients@8.0.0:
+ resolution: {integrity: sha512-43iAnYIGk0ZjNx5X/rkIcHi6dhmu/vEjY0kqfUfxPuJRO+V7jx8uKIdcnL0dpfNoC5J9TSh3EtzLWbq0gpqnWA==}
+ engines: {node: ^22.11.0 || ^24.11.0 || >=26.0}
+ peerDependencies:
+ postcss: ^8.5.14
+
+ postcss-minify-params@7.0.9:
+ resolution: {integrity: sha512-R8itbB8BhlpoYyBm1ou0dD+vJnQ3F6adQipR4UnkCHUwlo+S9WXJaDRg1RHjC8YVAtIdrQzSWvJl40HnGDTKjA==}
+ engines: {node: ^18.12.0 || ^20.9.0 || >=22.0}
+ peerDependencies:
+ postcss: ^8.5.13
+
+ postcss-minify-params@8.0.0:
+ resolution: {integrity: sha512-z7w4QO7G55l4vMUK1Lmx03GW7iyRLgf2V5Dz/7ioSPLnXRjeD+b7m0XfAXUGrbBYYrJ6bXPk+3LoX5u4JfAcSg==}
+ engines: {node: ^22.11.0 || ^24.11.0 || >=26.0}
+ peerDependencies:
+ postcss: ^8.5.14
+
+ postcss-minify-selectors@7.1.2:
+ resolution: {integrity: sha512-aQtrEWKwqafNlExcKHQvPGsXR2+vlUqqJtf5XsCQcgsSb5PL4wlujWBYDJuWsP4UnQX1YHDHU8qRlD+1PzTQ+Q==}
+ engines: {node: ^18.12.0 || ^20.9.0 || >=22.0}
+ peerDependencies:
+ postcss: ^8.5.13
+
+ postcss-minify-selectors@8.0.1:
+ resolution: {integrity: sha512-c31D46811kTkQDxV1KTTow79axX6gj/01AY5G7cGZg3s31KvAwP13jEFXGAzQbJ7NvOFV1pRqEia6nrAdHU7qg==}
+ engines: {node: ^22.11.0 || ^24.11.0 || >=26.0}
+ peerDependencies:
+ postcss: ^8.5.14
+
+ postcss-modules-extract-imports@3.1.0:
+ resolution: {integrity: sha512-k3kNe0aNFQDAZGbin48pL2VNidTF0w4/eASDsxlyspobzU3wZQLOGj7L9gfRe0Jo9/4uud09DsjFNH7winGv8Q==}
+ engines: {node: ^10 || ^12 || >= 14}
+ peerDependencies:
+ postcss: ^8.1.0
+
+ postcss-modules-local-by-default@4.2.0:
+ resolution: {integrity: sha512-5kcJm/zk+GJDSfw+V/42fJ5fhjL5YbFDl8nVdXkJPLLW+Vf9mTD5Xe0wqIaDnLuL2U6cDNpTr+UQ+v2HWIBhzw==}
+ engines: {node: ^10 || ^12 || >= 14}
+ peerDependencies:
+ postcss: ^8.1.0
+
+ postcss-modules-scope@3.2.1:
+ resolution: {integrity: sha512-m9jZstCVaqGjTAuny8MdgE88scJnCiQSlSrOWcTQgM2t32UBe+MUmFSO5t7VMSfAf/FJKImAxBav8ooCHJXCJA==}
+ engines: {node: ^10 || ^12 || >= 14}
+ peerDependencies:
+ postcss: ^8.1.0
+
+ postcss-modules-values@4.0.0:
+ resolution: {integrity: sha512-RDxHkAiEGI78gS2ofyvCsu7iycRv7oqw5xMWn9iMoR0N/7mf9D50ecQqUo5BZ9Zh2vH4bCUR/ktCqbB9m8vJjQ==}
+ engines: {node: ^10 || ^12 || >= 14}
+ peerDependencies:
+ postcss: ^8.1.0
+
+ postcss-nested@7.0.2:
+ resolution: {integrity: sha512-5osppouFc0VR9/VYzYxO03VaDa3e8F23Kfd6/9qcZTUI8P58GIYlArOET2Wq0ywSl2o2PjELhYOFI4W7l5QHKw==}
+ engines: {node: '>=18.0'}
+ peerDependencies:
+ postcss: ^8.2.14
+
+ postcss-normalize-charset@7.0.3:
+ resolution: {integrity: sha512-NoBfZu8PR4c2NlmjvrqQTzCzLY79hwcSRgNQ3ZiNK0ABzf9kYKloE/jNj+/8GQY1wsm8pRRgANk6ydLH8cwo0Q==}
+ engines: {node: ^18.12.0 || ^20.9.0 || >=22.0}
+ peerDependencies:
+ postcss: ^8.5.13
+
+ postcss-normalize-charset@8.0.0:
+ resolution: {integrity: sha512-s88FUNDSUD8m0wBYvTQQcubVts6zhXwBU8zCD4vkRKiecd0v8cOjHVIF9r/i+5xzS/WG3f98qq4XsOM0JqvfLA==}
+ engines: {node: ^22.11.0 || ^24.11.0 || >=26.0}
+ peerDependencies:
+ postcss: ^8.5.14
+
+ postcss-normalize-display-values@7.0.3:
+ resolution: {integrity: sha512-ldsCX0QIt05pKIOobZtVQ48wXJecr+czw4+e1/YjVhLMqslShgpVxgPtI2CefURR8oyVoYaU/l829MMwExDMLw==}
+ engines: {node: ^18.12.0 || ^20.9.0 || >=22.0}
+ peerDependencies:
+ postcss: ^8.5.13
+
+ postcss-normalize-display-values@8.0.0:
+ resolution: {integrity: sha512-gG2nBxD27fiw6Luinb1QYKdM/Co5GornRJgSD+JTwNH4PGKxImP0qyruDDav49aHUPLY3qrL3qN3LvybO7IzxQ==}
+ engines: {node: ^22.11.0 || ^24.11.0 || >=26.0}
+ peerDependencies:
+ postcss: ^8.5.14
+
+ postcss-normalize-positions@7.0.4:
+ resolution: {integrity: sha512-VEvlpeGd3Ju1Hqa/oN4jaP3+ms4laYwkEL9N9u+B6k54PZjXbW1n6wI+aVprf1BQXlCYpS5+1pl/7/vHiKgARg==}
+ engines: {node: ^18.12.0 || ^20.9.0 || >=22.0}
+ peerDependencies:
+ postcss: ^8.5.13
+
+ postcss-normalize-positions@8.0.0:
+ resolution: {integrity: sha512-t/wGqpehS20Ke7kc4QAsWpH+AJjUdMK/V5qV2RhrXkj8hO/fT1t1MJ8NL7sedWYk7ZqC7eISEJQonW5j0tU1MQ==}
+ engines: {node: ^22.11.0 || ^24.11.0 || >=26.0}
+ peerDependencies:
+ postcss: ^8.5.14
+
+ postcss-normalize-repeat-style@7.0.4:
+ resolution: {integrity: sha512-6mPKlY/8cSaDHxX502wERADarJsccwlky6yIrOapHH2ZgfoKAV94SbiTKfKEs4EEpdazuc3J72WsqeYk7hp9+Q==}
+ engines: {node: ^18.12.0 || ^20.9.0 || >=22.0}
+ peerDependencies:
+ postcss: ^8.5.13
+
+ postcss-normalize-repeat-style@8.0.0:
+ resolution: {integrity: sha512-3ebOmGdCYKrBYyGKc1xhj0unEnW7beZpVU7JohVeGl7mTxR+7T6egpaawTWAVsB0pEIhcsbJVOjPKCJSoRO6Zg==}
+ engines: {node: ^22.11.0 || ^24.11.0 || >=26.0}
+ peerDependencies:
+ postcss: ^8.5.14
+
+ postcss-normalize-string@7.0.3:
+ resolution: {integrity: sha512-HnEQPUchi1eznmDKEYrKUTqrprEq97SrpUYClgUkv7V2zRODD9DFoUsYU+m9ZOetmD5ku7fEMZB/lwy8IT6xVQ==}
+ engines: {node: ^18.12.0 || ^20.9.0 || >=22.0}
+ peerDependencies:
+ postcss: ^8.5.13
+
+ postcss-normalize-string@8.0.0:
+ resolution: {integrity: sha512-TvWCGZ/e04Tv31uJvOUtbexkfgUnqmQ3M2P5DkAaVzvOj+BvTkG2QjpA5Y71SL1SPxJcj4M23fNh+RDVCmG8kA==}
+ engines: {node: ^22.11.0 || ^24.11.0 || >=26.0}
+ peerDependencies:
+ postcss: ^8.5.14
+
+ postcss-normalize-timing-functions@7.0.3:
+ resolution: {integrity: sha512-zmEzHdvpZBZu0OKlbJSfgASQvaayyAoVuWtvyr34IJ/LyS+DaOKvvR3EvFJ9RWWtNIx+CMvO125OVophaxNYew==}
+ engines: {node: ^18.12.0 || ^20.9.0 || >=22.0}
+ peerDependencies:
+ postcss: ^8.5.13
+
+ postcss-normalize-timing-functions@8.0.0:
+ resolution: {integrity: sha512-uEfaXst5Xgqxv7geYUuz6vs9mn88K2NPY2RoIzM3BMmSjsdTSeppV9x2qIgrxsisdbSqF6IVhzI2occcte3hTA==}
+ engines: {node: ^22.11.0 || ^24.11.0 || >=26.0}
+ peerDependencies:
+ postcss: ^8.5.14
+
+ postcss-normalize-unicode@7.0.9:
+ resolution: {integrity: sha512-DRAdWfeh/TjmhLJsw91vdiWCnUod9iwvM7xyS02/nF/sLsCR3A8l3pztrSUrWG8DSBqfX7yEk9FM0USaVJ2mSg==}
+ engines: {node: ^18.12.0 || ^20.9.0 || >=22.0}
+ peerDependencies:
+ postcss: ^8.5.13
+
+ postcss-normalize-unicode@8.0.0:
+ resolution: {integrity: sha512-+WYngZaChEeTHZmWhmKtnJ4gTzWdINEaFcgWBnu6WdVu8Ftim8OBTcw768DuCC/3Aax9bZ9WkwrLGHym2Lzf+A==}
+ engines: {node: ^22.11.0 || ^24.11.0 || >=26.0}
+ peerDependencies:
+ postcss: ^8.5.14
+
+ postcss-normalize-url@7.0.3:
+ resolution: {integrity: sha512-CL93wmloq5qsffmFv+bw24MIRbmhHrp53qoh1LDAb/5TtjWEXI/np4xcP/Gw9oWCb2XyWnqHYLDUwiKRoJBA1Q==}
+ engines: {node: ^18.12.0 || ^20.9.0 || >=22.0}
+ peerDependencies:
+ postcss: ^8.5.13
+
+ postcss-normalize-url@8.0.0:
+ resolution: {integrity: sha512-4Mz9hZHn/QIB+YtFqTXrDmE2193GYxGb3F8uMfLvMicaEXCCUlDIJ658gFFJbqEGl9FYzwPtRiuNgbwlO9kkBg==}
+ engines: {node: ^22.11.0 || ^24.11.0 || >=26.0}
+ peerDependencies:
+ postcss: ^8.5.14
+
+ postcss-normalize-whitespace@7.0.3:
+ resolution: {integrity: sha512-FdHjjn+Ht5Z2ZRjNOmeCbNq6lq09sUYKpmlF/Aq0XjVNSLTL6fmHlA/3swN2wP2caY9GV/tjSDcIIyS7aN7W0A==}
+ engines: {node: ^18.12.0 || ^20.9.0 || >=22.0}
+ peerDependencies:
+ postcss: ^8.5.13
+
+ postcss-normalize-whitespace@8.0.0:
+ resolution: {integrity: sha512-V1f8tYnwIP5tscOXQFTKK8Y5EJ+R2GMpFJ6FjzwoKoQnhbqQy3IeSrDjJJb8JjVos8ut6Osi80Zybpayv/XjIQ==}
+ engines: {node: ^22.11.0 || ^24.11.0 || >=26.0}
+ peerDependencies:
+ postcss: ^8.5.14
+
+ postcss-ordered-values@7.0.4:
+ resolution: {integrity: sha512-nubSi49hDHQk4E8KIj+IbLY8Bg+8OcSUEhgyolgM+atnOvXjV7EjaR6bac4YGZoFyPa9mWoAF3EaYbWdFkKqVg==}
+ engines: {node: ^18.12.0 || ^20.9.0 || >=22.0}
+ peerDependencies:
+ postcss: ^8.5.13
+
+ postcss-ordered-values@8.0.0:
+ resolution: {integrity: sha512-Dg9+itb6lmD0bxqhQyHCtXAwYRh0wUrx6Mp4/BNXgkLoJmdYMmWi+V+Pypw79Q6iQhxA8KFMHqLBITQJV2gKMA==}
+ engines: {node: ^22.11.0 || ^24.11.0 || >=26.0}
+ peerDependencies:
+ postcss: ^8.5.14
+
+ postcss-reduce-initial@7.0.9:
+ resolution: {integrity: sha512-ztTNPdIxXTxtBcG03E9u8v44M4ElXbMIRT7pf2onlquGula0Y83nKKxqM22FA/hMgkfCjN7ohevkVlaNwI8iOQ==}
+ engines: {node: ^18.12.0 || ^20.9.0 || >=22.0}
+ peerDependencies:
+ postcss: ^8.5.13
+
+ postcss-reduce-initial@8.0.0:
+ resolution: {integrity: sha512-DChcE9d528AKrlpCTHjhsAiOsWCk4H9ApHPS1QqRT3praObWTiWyn6W1UddGpc46K9LQnHwUu4YwaPUukGtXVA==}
+ engines: {node: ^22.11.0 || ^24.11.0 || >=26.0}
+ peerDependencies:
+ postcss: ^8.5.14
+
+ postcss-reduce-transforms@7.0.3:
+ resolution: {integrity: sha512-FXsnN9ZwcZTT8Yf8cAHA8qIGUXcX6WfLd9JoYhrdDfmvsVhhfqkkv7m4AC3rwFOfz+GzkUa87OCKF9dUcicd+g==}
+ engines: {node: ^18.12.0 || ^20.9.0 || >=22.0}
+ peerDependencies:
+ postcss: ^8.5.13
+
+ postcss-reduce-transforms@8.0.0:
+ resolution: {integrity: sha512-cLZT0som7vvumQT9XQCnSKOSnRinNQZd1Hm+J723Ney13E8CIydDhw6JwzsjPtgnYThTqn9Q45906gz6wxaAsw==}
+ engines: {node: ^22.11.0 || ^24.11.0 || >=26.0}
+ peerDependencies:
+ postcss: ^8.5.14
+
+ postcss-safe-parser@7.0.1:
+ resolution: {integrity: sha512-0AioNCJZ2DPYz5ABT6bddIqlhgwhpHZ/l65YAYo0BCIn0xiDpsnTHz0gnoTGk0OXZW0JRs+cDwL8u/teRdz+8A==}
+ engines: {node: '>=18.0'}
+ peerDependencies:
+ postcss: ^8.4.31
+
+ postcss-selector-parser@7.1.1:
+ resolution: {integrity: sha512-orRsuYpJVw8LdAwqqLykBj9ecS5/cRHlI5+nvTo8LcCKmzDmqVORXtOIYEEQuL9D4BxtA1lm5isAqzQZCoQ6Eg==}
+ engines: {node: '>=4'}
+
+ postcss-svgo@7.1.3:
+ resolution: {integrity: sha512-2QfoFOYMcj8lwcVEf9WeTlkVIAm7u2QvOEhMzkQU3KUhhGX/l8hVV9EtjMv4iq3E9iI3OeeMN0YoMLbGusuigw==}
+ engines: {node: ^18.12.0 || ^20.9.0 || >= 18}
+ peerDependencies:
+ postcss: ^8.5.13
+
+ postcss-svgo@8.0.0:
+ resolution: {integrity: sha512-Q2fMSYEiNE1ioDc/3sxvI24NdgA/MJno2XLNpOxgv8aCcJbym8mZY10/lDY5+AWCIc3Aiqzy2Wcp9/zaIXBZgQ==}
+ engines: {node: ^22.11.0 || ^24.11.0 || >=26.0}
+ peerDependencies:
+ postcss: ^8.5.14
+
+ postcss-unique-selectors@7.0.7:
+ resolution: {integrity: sha512-d+sCkaRnSefghOUdH8CMJZV9yUQhj2ojpe8Nw/lA+LV1UOfeleGkLTl6XdCFFSai9UJ+DJPb69FFuqthXYsY8w==}
+ engines: {node: ^18.12.0 || ^20.9.0 || >=22.0}
+ peerDependencies:
+ postcss: ^8.5.13
+
+ postcss-unique-selectors@8.0.0:
+ resolution: {integrity: sha512-iObuolUX+ITJfMU2QQFQdh31JgSjNLPNjVs6YGAqBHvOvAWXMMNget6donQl83aQaeS32i5XeKZURUW/WBxIUw==}
+ engines: {node: ^22.11.0 || ^24.11.0 || >=26.0}
+ peerDependencies:
+ postcss: ^8.5.14
+
+ postcss-url@10.1.4:
+ resolution: {integrity: sha512-/oBzyLOHQvXvVr/7bzZOFD5lYTy1nomVE4aMA9eY5KQsHfWLDIzb86q8XoUsmrj2xKoGYMAvd884EzJEQzuXIw==}
+ engines: {node: '>=10'}
+ peerDependencies:
+ postcss: ^8.0.0
+
+ postcss-value-parser@4.2.0:
+ resolution: {integrity: sha512-1NNCs6uurfkVbeXG4S8JFT9t19m45ICnif8zWLd5oPSZ50QnwMfK+H3jv408d4jw/7Bttv5axS5IiHoLaVNHeQ==}
+
+ postcss@8.5.14:
+ resolution: {integrity: sha512-SoSL4+OSEtR99LHFZQiJLkT59C5B1amGO1NzTwj7TT1qCUgUO6hxOvzkOYxD+vMrXBM3XJIKzokoERdqQq/Zmg==}
+ engines: {node: ^10 || ^12 || >=14}
+
+ posthtml-parser@0.11.0:
+ resolution: {integrity: sha512-QecJtfLekJbWVo/dMAA+OSwY79wpRmbqS5TeXvXSX+f0c6pW4/SE6inzZ2qkU7oAMCPqIDkZDvd/bQsSFUnKyw==}
+ engines: {node: '>=12'}
+
+ posthtml-render@3.0.0:
+ resolution: {integrity: sha512-z+16RoxK3fUPgwaIgH9NGnK1HKY9XIDpydky5eQGgAFVXTCSezalv9U2jQuNV+Z9qV1fDWNzldcw4eK0SSbqKA==}
+ engines: {node: '>=12'}
+
+ posthtml@0.16.7:
+ resolution: {integrity: sha512-7Hc+IvlQ7hlaIfQFZnxlRl0jnpWq2qwibORBhQYIb0QbNtuicc5ZxvKkVT71HJ4Py1wSZ/3VR1r8LfkCtoCzhw==}
+ engines: {node: '>=12.0.0'}
+
+ powershell-utils@0.1.0:
+ resolution: {integrity: sha512-dM0jVuXJPsDN6DvRpea484tCUaMiXWjuCn++HGTqUWzGDjv5tZkEZldAJ/UMlqRYGFrD/etByo4/xOuC/snX2A==}
+ engines: {node: '>=20'}
+
+ prelude-ls@1.2.1:
+ resolution: {integrity: sha512-vkcDPrRZo1QZLbn5RLGPpg/WmIQ65qoWWhcGKf/b5eplkkarX0m9z8ppCat4mlOqUsWpyNuYgO3VRyrYHSzX5g==}
+ engines: {node: '>= 0.8.0'}
+
+ prettier@3.8.3:
+ resolution: {integrity: sha512-7igPTM53cGHMW8xWuVTydi2KO233VFiTNyF5hLJqpilHfmn8C8gPf+PS7dUT64YcXFbiMGZxS9pCSxL/Dxm/Jw==}
+ engines: {node: '>=14'}
+ hasBin: true
+
+ pretty-bytes@7.1.0:
+ resolution: {integrity: sha512-nODzvTiYVRGRqAOvE84Vk5JDPyyxsVk0/fbA/bq7RqlnhksGpset09XTxbpvLTIjoaF7K8Z8DG8yHtKGTPSYRw==}
+ engines: {node: '>=20'}
+
+ pretty-format@27.5.1:
+ resolution: {integrity: sha512-Qb1gy5OrP5+zDf2Bvnzdl3jsTf1qXVMazbvCoKhtKqVs4/YK4ozX4gKQJJVyNe+cajNPn0KoC0MC3FUmaHWEmQ==}
+ engines: {node: ^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0}
+
+ pretty-time@1.1.0:
+ resolution: {integrity: sha512-28iF6xPQrP8Oa6uxE6a1biz+lWeTOAPKggvjB8HAs6nVMKZwf5bG++632Dx614hIWgUPkgivRfG+a8uAXGTIbA==}
+ engines: {node: '>=4'}
+
+ process-nextick-args@2.0.1:
+ resolution: {integrity: sha512-3ouUOpQhtgrbOa17J7+uxOTpITYWaGP7/AhoR3+A+/1e9skrzelGi/dXzEYyvbxubEF6Wn2ypscTKiKJFFn1ag==}
+
+ process@0.11.10:
+ resolution: {integrity: sha512-cdGef/drWFoydD1JsMzuFf8100nZl+GT+yacc2bEced5f9Rjk4z+WtFUTBu9PhOi9j/jfmBPu0mMEY4wIdAF8A==}
+ engines: {node: '>= 0.6.0'}
+
+ promise@7.3.1:
+ resolution: {integrity: sha512-nolQXZ/4L+bP/UGlkfaIujX9BKxGwmQ9OT4mOt5yvy8iK1h3wqTEJCijzGANTCCl9nWjY41juyAn2K3Q1hLLTg==}
+
+ prompts@2.4.2:
+ resolution: {integrity: sha512-NxNv/kLguCA7p3jE8oL2aEBsrJWgAakBpgmgK6lpPWV+WuOmY6r2/zbAVnP+T8bQlA0nzHXSJSJW0Hq7ylaD2Q==}
+ engines: {node: '>= 6'}
+
+ proper-lockfile@4.1.2:
+ resolution: {integrity: sha512-TjNPblN4BwAWMXU8s9AEz4JmQxnD1NNL7bNOY/AKUzyamc379FWASUhc/K1pL2noVb+XmZKLL68cjzLsiOAMaA==}
+
+ property-information@7.1.0:
+ resolution: {integrity: sha512-TwEZ+X+yCJmYfL7TPUOcvBZ4QfoT5YenQiJuX//0th53DE6w0xxLEtfK3iyryQFddXuvkIk51EEgrJQ0WJkOmQ==}
+
+ proto-list@1.2.4:
+ resolution: {integrity: sha512-vtK/94akxsTMhe0/cbfpR+syPuszcuwhqVjJq26CuNDgFGj682oRBXOP5MJpv2r7JtE8MsiepGIqvvOTBwn2vA==}
+
+ proxy-from-env@2.1.0:
+ resolution: {integrity: sha512-cJ+oHTW1VAEa8cJslgmUZrc+sjRKgAKl3Zyse6+PV38hZe/V6Z14TbCuXcan9F9ghlz4QrFr2c92TNF82UkYHA==}
+ engines: {node: '>=10'}
+
+ prr@1.0.1:
+ resolution: {integrity: sha512-yPw4Sng1gWghHQWj0B3ZggWUm4qVbPwPFcRG8KyxiU7J2OHFSoEHKS+EZ3fv5l1t9CyCiop6l/ZYeWbrgoQejw==}
+
+ publint@0.3.21:
+ resolution: {integrity: sha512-OqejcnMV6E9zel2oCrUOJEiiFkGiAAni0A6ibfQNh1k9Gu5z4F+Yso8lllam7AzmV6Do0vp7u3UpZNRBwuXaHQ==}
+ engines: {node: '>=18'}
+ hasBin: true
+
+ pug-attrs@3.0.0:
+ resolution: {integrity: sha512-azINV9dUtzPMFQktvTXciNAfAuVh/L/JCl0vtPCwvOA21uZrC08K/UnmrL+SXGEVc1FwzjW62+xw5S/uaLj6cA==}
+
+ pug-code-gen@3.0.4:
+ resolution: {integrity: sha512-6okWYIKdasTyXICyEtvobmTZAVX57JkzgzIi4iRJlin8kmhG+Xry2dsus+Mun/nGCn6F2U49haHI5mkELXB14g==}
+
+ pug-error@2.1.0:
+ resolution: {integrity: sha512-lv7sU9e5Jk8IeUheHata6/UThZ7RK2jnaaNztxfPYUY+VxZyk/ePVaNZ/vwmH8WqGvDz3LrNYt/+gA55NDg6Pg==}
+
+ pug-filters@4.0.0:
+ resolution: {integrity: sha512-yeNFtq5Yxmfz0f9z2rMXGw/8/4i1cCFecw/Q7+D0V2DdtII5UvqE12VaZ2AY7ri6o5RNXiweGH79OCq+2RQU4A==}
+
+ pug-lexer@5.0.1:
+ resolution: {integrity: sha512-0I6C62+keXlZPZkOJeVam9aBLVP2EnbeDw3An+k0/QlqdwH6rv8284nko14Na7c0TtqtogfWXcRoFE4O4Ff20w==}
+
+ pug-linker@4.0.0:
+ resolution: {integrity: sha512-gjD1yzp0yxbQqnzBAdlhbgoJL5qIFJw78juN1NpTLt/mfPJ5VgC4BvkoD3G23qKzJtIIXBbcCt6FioLSFLOHdw==}
+
+ pug-load@3.0.0:
+ resolution: {integrity: sha512-OCjTEnhLWZBvS4zni/WUMjH2YSUosnsmjGBB1An7CsKQarYSWQ0GCVyd4eQPMFJqZ8w9xgs01QdiZXKVjk92EQ==}
+
+ pug-parser@6.0.0:
+ resolution: {integrity: sha512-ukiYM/9cH6Cml+AOl5kETtM9NR3WulyVP2y4HOU45DyMim1IeP/OOiyEWRr6qk5I5klpsBnbuHpwKmTx6WURnw==}
+
+ pug-plain-loader@1.1.0:
+ resolution: {integrity: sha512-1nYgIJLaahRuHJHhzSPODV44aZfb00bO7kiJiMkke6Hj4SVZftuvx6shZ4BOokk50dJc2RSFqNUBOlus0dniFQ==}
+ peerDependencies:
+ pug: ^2.0.0 || ^3.0.0
+
+ pug-runtime@3.0.1:
+ resolution: {integrity: sha512-L50zbvrQ35TkpHwv0G6aLSuueDRwc/97XdY8kL3tOT0FmhgG7UypU3VztfV/LATAvmUfYi4wNxSajhSAeNN+Kg==}
+
+ pug-strip-comments@2.0.0:
+ resolution: {integrity: sha512-zo8DsDpH7eTkPHCXFeAk1xZXJbyoTfdPlNR0bK7rpOMuhBYb0f5qUVCO1xlsitYd3w5FQTK7zpNVKb3rZoUrrQ==}
+
+ pug-walk@2.0.0:
+ resolution: {integrity: sha512-yYELe9Q5q9IQhuvqsZNwA5hfPkMJ8u92bQLIMcsMxf/VADjNtEYptU+inlufAFYcWdHlwNfZOEnOOQrZrcyJCQ==}
+
+ pug@3.0.4:
+ resolution: {integrity: sha512-kFfq5mMzrS7+wrl5pLJzZEzemx34OQ0w4SARfhy/3yxTlhbstsudDwJzhf1hP02yHzbjoVMSXUj/Sz6RNfMyXg==}
+
+ punycode.js@2.3.1:
+ resolution: {integrity: sha512-uxFIHU0YlHYhDQtV4R9J6a52SLx28BCjT+4ieh7IGbgwVJWO+km431c4yRlREUAsAmt/uMjQUyQHNEPf0M39CA==}
+ engines: {node: '>=6'}
+
+ punycode@2.3.1:
+ resolution: {integrity: sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==}
+ engines: {node: '>=6'}
+
+ quansync@0.2.11:
+ resolution: {integrity: sha512-AifT7QEbW9Nri4tAwR5M/uzpBuqfZf+zwaEM/QkzEjj7NBuFD2rBuy0K3dE+8wltbezDV7JMA0WfnCPYRSYbXA==}
+
+ quansync@1.0.0:
+ resolution: {integrity: sha512-5xZacEEufv3HSTPQuchrvV6soaiACMFnq1H8wkVioctoH3TRha9Sz66lOxRwPK/qZj7HPiSveih9yAyh98gvqA==}
+
+ queue-microtask@1.2.3:
+ resolution: {integrity: sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==}
+
+ radix3@1.1.2:
+ resolution: {integrity: sha512-b484I/7b8rDEdSDKckSSBA8knMpcdsXudlE/LNL639wFoHKwLbEkQFZHWEYwDC0wa0FKUcCY+GAF73Z7wxNVFA==}
+
+ range-parser@1.2.1:
+ resolution: {integrity: sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg==}
+ engines: {node: '>= 0.6'}
+
+ rc9@3.0.1:
+ resolution: {integrity: sha512-gMDyleLWVE+i6Sgtc0QbbY6pEKqYs97NGi6isHQPqYlLemPoO8dxQ3uGi0f4NiP98c+jMW6cG1Kx9dDwfvqARQ==}
+
+ react-is@17.0.2:
+ resolution: {integrity: sha512-w2GsyukL62IJnlaff/nRegPQR94C/XXamvMWmSHRJ4y7Ts/4ocGRmTHvOs8PSE6pB3dWOrD/nueuU5sduBsQ4w==}
+
+ read-cache@1.0.0:
+ resolution: {integrity: sha512-Owdv/Ft7IjOgm/i0xvNDZ1LrRANRfew4b2prF3OWMQLxLfu3bS8FVhCsrSCMK4lR56Y9ya+AThoTpDCTxCmpRA==}
+
+ read-package-json-fast@3.0.2:
+ resolution: {integrity: sha512-0J+Msgym3vrLOUB3hzQCuZHII0xkNGCtz/HJH9xZshwv9DbDwkw1KaE3gx/e2J5rpEY5rtOy6cyhKOPrkP7FZw==}
+ engines: {node: ^14.17.0 || ^16.13.0 || >=18.0.0}
+
+ read-pkg@9.0.1:
+ resolution: {integrity: sha512-9viLL4/n1BJUCT1NXVTdS1jtm80yDEgR5T4yCelII49Mbj0v1rZdKqj7zCiYdbB0CuCgdrvHcNogAKTFPBocFA==}
+ engines: {node: '>=18'}
+
+ read-workspaces@1.2.2:
+ resolution: {integrity: sha512-P/girX6N7FDk7mGo/i4DB2HzanhnEhuLIAG2RvBkubQxwtEimtIDtCyA1DcHG4IC22+sr6rCppFyW8IflQ5q+Q==}
+ engines: {node: '>=18.6.0'}
+
+ read-yaml-file@2.1.0:
+ resolution: {integrity: sha512-UkRNRIwnhG+y7hpqnycCL/xbTk7+ia9VuVTC0S+zVbwd65DI9eUpRMfsWIGrCWxTU/mi+JW8cHQCrv+zfCbEPQ==}
+ engines: {node: '>=10.13'}
+
+ readable-stream@2.3.8:
+ resolution: {integrity: sha512-8p0AUk4XODgIewSi0l8Epjs+EVnWiK7NoDIEGU0HhE7+ZyY8D1IMY7odu5lRrFXGg71L15KG8QrPmum45RTtdA==}
+
+ readable-stream@4.7.0:
+ resolution: {integrity: sha512-oIGGmcpTLwPga8Bn6/Z75SVaH1z5dUut2ibSyAMVhmUggWpmDn2dapB0n7f8nwaSiRtepAsfJyfXIO5DCVAODg==}
+ engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0}
+
+ readdir-glob@1.1.3:
+ resolution: {integrity: sha512-v05I2k7xN8zXvPD9N+z/uhXPaj0sUFCe2rcWZIpBsqxfP7xXFQ0tipAd/wjj1YxWyWtUS5IDJpOG82JKt2EAVA==}
+
+ readdirp@3.6.0:
+ resolution: {integrity: sha512-hOS089on8RduqdbhvQ5Z37A0ESjsqz6qnRcffsMU3495FuTdqSm+7bhJ29JvIOsBDEEnan5DPu9t3To9VRlMzA==}
+ engines: {node: '>=8.10.0'}
+
+ readdirp@4.1.2:
+ resolution: {integrity: sha512-GDhwkLfywWL2s6vEjyhri+eXmfH6j1L7JE27WhqLeYzoh/A3DBaYGEj2H/HFZCn/kMfim73FXxEJTw06WtxQwg==}
+ engines: {node: '>= 14.18.0'}
+
+ readdirp@5.0.0:
+ resolution: {integrity: sha512-9u/XQ1pvrQtYyMpZe7DXKv2p5CNvyVwzUB6uhLAnQwHMSgKMBR62lc7AHljaeteeHXn11XTAaLLUVZYVZyuRBQ==}
+ engines: {node: '>= 20.19.0'}
+
+ redis-errors@1.2.0:
+ resolution: {integrity: sha512-1qny3OExCf0UvUV/5wpYKf2YwPcOqXzkwKKSmKHiE6ZMQs5heeE/c8eXK+PNllPvmjgAbfnsbpkGZWy8cBpn9w==}
+ engines: {node: '>=4'}
+
+ redis-parser@3.0.0:
+ resolution: {integrity: sha512-DJnGAeenTdpMEH6uAJRK/uiyEIH9WVsUmoLwzudwGJUwZPp80PDBWPHXSAGNPwNvIXAbe7MSUB1zQFugFml66A==}
+ engines: {node: '>=4'}
+
+ refa@0.12.1:
+ resolution: {integrity: sha512-J8rn6v4DBb2nnFqkqwy6/NnTYMcgLA+sLr0iIO41qpv0n+ngb7ksag2tMRl0inb1bbO/esUwzW1vbJi7K0sI0g==}
+ engines: {node: ^12.0.0 || ^14.0.0 || >=16.0.0}
+
+ regex-recursion@6.0.2:
+ resolution: {integrity: sha512-0YCaSCq2VRIebiaUviZNs0cBz1kg5kVS2UKUfNIx8YVs1cN3AV7NTctO5FOKBA+UT2BPJIWZauYHPqJODG50cg==}
+
+ regex-utilities@2.3.0:
+ resolution: {integrity: sha512-8VhliFJAWRaUiVvREIiW2NXXTmHs4vMNnSzuJVhscgmGav3g9VDxLrQndI3dZZVVdp0ZO/5v0xmX516/7M9cng==}
+
+ regex@6.1.0:
+ resolution: {integrity: sha512-6VwtthbV4o/7+OaAF9I5L5V3llLEsoPyq9P1JVXkedTP33c7MfCG0/5NOPcSJn0TzXcG9YUrR0gQSWioew3LDg==}
+
+ regexp-ast-analysis@0.7.1:
+ resolution: {integrity: sha512-sZuz1dYW/ZsfG17WSAG7eS85r5a0dDsvg+7BiiYR5o6lKCAtUrEwdmRmaGF6rwVj3LcmAeYkOWKEPlbPzN3Y3A==}
+ engines: {node: ^12.0.0 || ^14.0.0 || >=16.0.0}
+
+ regexp-tree@0.1.27:
+ resolution: {integrity: sha512-iETxpjK6YoRWJG5o6hXLwvjYAoW+FEZn9os0PD/b6AP6xQwsa/Y7lCVgIixBbUPMfhu+i2LtdeAqVTgGlQarfA==}
+ hasBin: true
+
+ regexp.prototype.flags@1.5.4:
+ resolution: {integrity: sha512-dYqgNSZbDwkaJ2ceRd9ojCGjBq+mOm9LmtXnAnEGyHhN/5R7iDW2TRw3h+o/jCFxus3P2LfWIIiwowAjANm7IA==}
+ engines: {node: '>= 0.4'}
+
+ regjsparser@0.13.1:
+ resolution: {integrity: sha512-dLsljMd9sqwRkby8zhO1gSg3PnJIBFid8f4CQj/sXx+7cKx+E7u0PKhZ+U4wmhx7EfmtvnA318oVaIkAB1lRJw==}
+ hasBin: true
+
+ rehype-external-links@3.0.0:
+ resolution: {integrity: sha512-yp+e5N9V3C6bwBeAC4n796kc86M4gJCdlVhiMTxIrJG5UHDMh+PJANf9heqORJbt1nrCbDwIlAZKjANIaVBbvw==}
+
+ rehype-minify-whitespace@6.0.2:
+ resolution: {integrity: sha512-Zk0pyQ06A3Lyxhe9vGtOtzz3Z0+qZ5+7icZ/PL/2x1SHPbKao5oB/g/rlc6BCTajqBb33JcOe71Ye1oFsuYbnw==}
+
+ rehype-raw@7.0.0:
+ resolution: {integrity: sha512-/aE8hCfKlQeA8LmyeyQvQF3eBiLRGNlfBJEvWH7ivp9sBqs7TNqBL5X3v157rM4IFETqDnIOO+z5M/biZbo9Ww==}
+
+ rehype-remark@10.0.1:
+ resolution: {integrity: sha512-EmDndlb5NVwXGfUa4c9GPK+lXeItTilLhE6ADSaQuHr4JUlKw9MidzGzx4HpqZrNCt6vnHmEifXQiiA+CEnjYQ==}
+
+ rehype-slug@6.0.0:
+ resolution: {integrity: sha512-lWyvf/jwu+oS5+hL5eClVd3hNdmwM1kAC0BUvEGD19pajQMIzcNUd/k9GsfQ+FfECvX+JE+e9/btsKH0EjJT6A==}
+
+ rehype-sort-attribute-values@5.0.1:
+ resolution: {integrity: sha512-lU3ABJO5frbUgV132YS6SL7EISf//irIm9KFMaeu5ixHfgWf6jhe+09Uf/Ef8pOYUJWKOaQJDRJGCXs6cNsdsQ==}
+
+ rehype-sort-attributes@5.0.1:
+ resolution: {integrity: sha512-Bxo+AKUIELcnnAZwJDt5zUDDRpt4uzhfz9d0PVGhcxYWsbFj5Cv35xuWxu5r1LeYNFNhgGqsr9Q2QiIOM/Qctg==}
+
+ remark-emoji@5.0.2:
+ resolution: {integrity: sha512-IyIqGELcyK5AVdLFafoiNww+Eaw/F+rGrNSXoKucjo95uL267zrddgxGM83GN1wFIb68pyDuAsY3m5t2Cav1pQ==}
+ engines: {node: '>=18'}
+
+ remark-gfm@4.0.1:
+ resolution: {integrity: sha512-1quofZ2RQ9EWdeN34S79+KExV1764+wCUGop5CPL1WGdD0ocPpu91lzPGbwWMECpEpd42kJGQwzRfyov9j4yNg==}
+
+ remark-mdc@3.11.0:
+ resolution: {integrity: sha512-xFrKmGRa+xgsfAZPA2CDaKILSHSOhX2irjJBrrPLxNrxaz2NFI+gXuVjo6Bkbh2vx7fKKTB5S9yyKyIwJh+FsQ==}
+
+ remark-parse@11.0.0:
+ resolution: {integrity: sha512-FCxlKLNGknS5ba/1lmpYijMUzX2esxW5xQqjWxw2eHFfS2MSdaHVINFmhjo+qN1WhZhNimq0dZATN9pH0IDrpA==}
+
+ remark-rehype@11.1.2:
+ resolution: {integrity: sha512-Dh7l57ianaEoIpzbp0PC9UKAdCSVklD8E5Rpw7ETfbTl3FqcOOgq5q2LVDhgGCkaBv7p24JXikPdvhhmHvKMsw==}
+
+ remark-stringify@11.0.0:
+ resolution: {integrity: sha512-1OSmLd3awB/t8qdoEOMazZkNsfVTeY4fTsgzcQFdXNq8ToTN4ZGwrMnlda4K6smTFKD+GRV6O48i6Z4iKgPPpw==}
+
+ require-directory@2.1.1:
+ resolution: {integrity: sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==}
+ engines: {node: '>=0.10.0'}
+
+ require-from-string@2.0.2:
+ resolution: {integrity: sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==}
+ engines: {node: '>=0.10.0'}
+
+ reserved-identifiers@1.2.0:
+ resolution: {integrity: sha512-yE7KUfFvaBFzGPs5H3Ops1RevfUEsDc5Iz65rOwWg4lE8HJSYtle77uul3+573457oHvBKuHYDl/xqUkKpEEdw==}
+ engines: {node: '>=18'}
+
+ resolve-from@4.0.0:
+ resolution: {integrity: sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==}
+ engines: {node: '>=4'}
+
+ resolve-from@5.0.0:
+ resolution: {integrity: sha512-qYg9KP24dD5qka9J47d0aVky0N+b4fTU89LN9iDnjB5waksiC49rvMB0PrUJQGoTmH50XPiqOvAjDfaijGxYZw==}
+ engines: {node: '>=8'}
+
+ resolve-pkg-maps@1.0.0:
+ resolution: {integrity: sha512-seS2Tj26TBVOC2NIc2rOe2y2ZO7efxITtLZcGSOnHHNOQ7CkiUBfw0Iw2ck6xkIhPwLhKNLS8BO+hEpngQlqzw==}
+
+ resolve-workspace-root@2.0.1:
+ resolution: {integrity: sha512-nR23LHAvaI6aHtMg6RWoaHpdR4D881Nydkzi2CixINyg9T00KgaJdJI6Vwty+Ps8WLxZHuxsS0BseWjxSA4C+w==}
+
+ resolve@1.22.12:
+ resolution: {integrity: sha512-TyeJ1zif53BPfHootBGwPRYT1RUt6oGWsaQr8UyZW/eAm9bKoijtvruSDEmZHm92CwS9nj7/fWttqPCgzep8CA==}
+ engines: {node: '>= 0.4'}
+ hasBin: true
+
+ retry@0.12.0:
+ resolution: {integrity: sha512-9LkiTwjUh6rT555DtE9rTX+BKByPfrMzEAtnlEtdEwr3Nkffwiihqe2bWADg+OQRjt9gl6ICdmB/ZFDCGAtSow==}
+ engines: {node: '>= 4'}
+
+ reusify@1.1.0:
+ resolution: {integrity: sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==}
+ engines: {iojs: '>=1.0.0', node: '>=0.10.0'}
+
+ rolldown-plugin-dts@0.25.1:
+ resolution: {integrity: sha512-zK82aC/8z1iVW+g0bCnlQZq04Y5bNeL/RcRwTYBwsnU6wH0N+6vpIFkN7JC0kYRS5qKA+pxQyfIPvXJ6Q5xSpQ==}
+ engines: {node: ^22.18.0 || >=24.0.0}
+ peerDependencies:
+ '@ts-macro/tsc': ^0.3.6
+ '@typescript/native-preview': '>=7.0.0-dev.20260325.1'
+ rolldown: ^1.0.0
+ typescript: ^5.0.0 || ^6.0.0
+ vue-tsc: ~3.2.0
+ peerDependenciesMeta:
+ '@ts-macro/tsc':
+ optional: true
+ '@typescript/native-preview':
+ optional: true
+ typescript:
+ optional: true
+ vue-tsc:
+ optional: true
+
+ rolldown-string@0.3.0:
+ resolution: {integrity: sha512-qGhBPNSv/27uzFBQdO+Cs4YAXC/1PKznD7Jz5Fl7NIAIlteuTPBTBWBhCpJ2AFTqLsoKvvUr7wSjqSUip0Fkpg==}
+ engines: {node: '>=20.19.0'}
+ peerDependencies:
+ rolldown: '*'
+ peerDependenciesMeta:
+ rolldown:
+ optional: true
+
+ rolldown@1.0.0:
+ resolution: {integrity: sha512-yD986aXDESFGS95spT1LAv0jssywP4npMEjmMHyN2/5+eE8qQJUype2AaKkRiLgBgyD0LFlubwAht7VmY8rGoA==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ hasBin: true
+
+ rolldown@1.0.2:
+ resolution: {integrity: sha512-oZx5zVDtVB44AW3eaifgDml1gWRDZGvjcfdxonE4swNPG98PrrXjaO/KrnUjzlMnztCCRVlUueA1kCXhARGk6g==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ hasBin: true
+
+ rollup-plugin-dts@6.4.1:
+ resolution: {integrity: sha512-l//F3Zf7ID5GoOfLfD8kroBjQKEKpy1qfhtAdnpibFZMffPaylrg1CoDC2vGkPeTeyxUe4bVFCln2EFuL7IGGg==}
+ engines: {node: '>=20'}
+ peerDependencies:
+ rollup: ^3.29.4 || ^4
+ typescript: ^4.5 || ^5.0 || ^6.0
+
+ rollup-plugin-visualizer@7.0.1:
+ resolution: {integrity: sha512-UJUT4+1Ho4OcWmPYU3sYXgUqI8B8Ayfe06MX7y0qCJ1K8aGoKtR/NDd/2nZqM7ADkrzny+I99Ul7GgyoiVNAgg==}
+ engines: {node: '>=22'}
+ hasBin: true
+ peerDependencies:
+ rolldown: 1.x || ^1.0.0-beta || ^1.0.0-rc
+ rollup: 2.x || 3.x || 4.x
+ peerDependenciesMeta:
+ rolldown:
+ optional: true
+ rollup:
+ optional: true
+
+ rollup@4.60.4:
+ resolution: {integrity: sha512-WHeFSbZYsPu3+bLoNRUuAO+wavNlocOPf3wSHTP7hcFKVnJeWsYlCDbr3mTS14FCizf9ccIxXA8sGL8zKeQN3g==}
+ engines: {node: '>=18.0.0', npm: '>=8.0.0'}
+ hasBin: true
+
+ rou3@0.8.1:
+ resolution: {integrity: sha512-ePa+XGk00/3HuCqrEnK3LxJW7I0SdNg6EFzKUJG73hMAdDcOUC/i/aSz7LSDwLrGr33kal/rqOGydzwl6U7zBA==}
+
+ run-applescript@7.1.0:
+ resolution: {integrity: sha512-DPe5pVFaAsinSaV6QjQ6gdiedWDcRCbUuiQfQa2wmWV7+xC9bGulGI8+TdRmoFkAPaBXk8CrAbnlY2ISniJ47Q==}
+ engines: {node: '>=18'}
+
+ run-con@1.3.2:
+ resolution: {integrity: sha512-CcfE+mYiTcKEzg0IqS08+efdnH0oJ3zV0wSUFBNrMHMuxCtXvBCLzCJHatwuXDcu/RlhjTziTo/a1ruQik6/Yg==}
+ hasBin: true
+
+ run-parallel@1.2.0:
+ resolution: {integrity: sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==}
+
+ sade@1.8.1:
+ resolution: {integrity: sha512-xal3CZX1Xlo/k4ApwCFrHVACi9fBqJ7V+mwhBsuf/1IOKbBy098Fex+Wa/5QMubw09pSZ/u8EY8PWgevJsXp1A==}
+ engines: {node: '>=6'}
+
+ safe-buffer@5.1.2:
+ resolution: {integrity: sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==}
+
+ safe-buffer@5.2.1:
+ resolution: {integrity: sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==}
+
+ safe-regex-test@1.1.0:
+ resolution: {integrity: sha512-x/+Cz4YrimQxQccJf5mKEbIa1NzeCRNI5Ecl/ekmlYaampdNLPalVyIcCZNNH3MvmqBugV5TMYZXv0ljslUlaw==}
+ engines: {node: '>= 0.4'}
+
+ sass-loader@17.0.0:
+ resolution: {integrity: sha512-0Ybm8ohBQ9LcrycVrFQp/KQBNX5a3Wda9/smS0mE/xLffzEnwvV8nykOzrbiSWNzTE3IB/jiXx8O4QmDPG2+Gw==}
+ engines: {node: '>= 22.11.0'}
+ peerDependencies:
+ '@rspack/core': 0.x || ^1.0.0 || ^2.0.0-0
+ sass: ^1.3.0
+ sass-embedded: '*'
+ webpack: ^5.0.0
+ peerDependenciesMeta:
+ '@rspack/core':
+ optional: true
+ sass:
+ optional: true
+ sass-embedded:
+ optional: true
+ webpack:
+ optional: true
+
+ sax@1.6.0:
+ resolution: {integrity: sha512-6R3J5M4AcbtLUdZmRv2SygeVaM7IhrLXu9BmnOGmmACak8fiUtOsYNWUS4uK7upbmHIBbLBeFeI//477BKLBzA==}
+ engines: {node: '>=11.0.0'}
+
+ schema-utils@3.3.0:
+ resolution: {integrity: sha512-pN/yOAvcC+5rQ5nERGuwrjLlYvLTbCibnZ1I7B1LaiAz9BRBlE9GMgE/eqV30P7aJQUf7Ddimy/RsbYO/GrVGg==}
+ engines: {node: '>= 10.13.0'}
+
+ schema-utils@4.3.3:
+ resolution: {integrity: sha512-eflK8wEtyOE6+hsaRVPxvUKYCpRgzLqDTb8krvAsRIwOGlHoSgYLgBXoubGgLd2fT41/OUYdb48v4k4WWHQurA==}
+ engines: {node: '>= 10.13.0'}
+
+ scslre@0.3.0:
+ resolution: {integrity: sha512-3A6sD0WYP7+QrjbfNA2FN3FsOaGGFoekCVgTyypy53gPxhbkCIjtO6YWgdrfM+n/8sI8JeXZOIxsHjMTNxQ4nQ==}
+ engines: {node: ^14.0.0 || >=16.0.0}
+
+ scule@1.3.0:
+ resolution: {integrity: sha512-6FtHJEvt+pVMIB9IBY+IcCJ6Z5f1iQnytgyfKMhDKgmzYG+TeH/wx1y3l27rshSbLiSanrR9ffZDrEsmjlQF2g==}
+
+ semver@6.3.1:
+ resolution: {integrity: sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==}
+ hasBin: true
+
+ semver@7.8.0:
+ resolution: {integrity: sha512-AcM7dV/5ul4EekoQ29Agm5vri8JNqRyj39o0qpX6vDF2GZrtutZl5RwgD1XnZjiTAfncsJhMI48QQH3sN87YNA==}
+ engines: {node: '>=10'}
+ hasBin: true
+
+ send@1.2.1:
+ resolution: {integrity: sha512-1gnZf7DFcoIcajTjTwjwuDjzuz4PPcY2StKPlsGAQ1+YH20IRVrBaXSWmdjowTJ6u8Rc01PoYOGHXfP1mYcZNQ==}
+ engines: {node: '>= 18'}
+
+ serialize-javascript@7.0.5:
+ resolution: {integrity: sha512-F4LcB0UqUl1zErq+1nYEEzSHJnIwb3AF2XWB94b+afhrekOUijwooAYqFyRbjYkm2PAKBabx6oYv/xDxNi8IBw==}
+ engines: {node: '>=20.0.0'}
+
+ seroval@1.5.4:
+ resolution: {integrity: sha512-46uFvgrXTVxZcUorgSSRZ4y+ieqLLQRMlG4bnCZKW3qI6BZm7Rg4ntMW4p1mILEEBZWrFlcpp0AyIIlM6jD9iw==}
+ engines: {node: '>=10'}
+
+ serve-placeholder@2.0.2:
+ resolution: {integrity: sha512-/TMG8SboeiQbZJWRlfTCqMs2DD3SZgWp0kDQePz9yUuCnDfDh/92gf7/PxGhzXTKBIPASIHxFcZndoNbp6QOLQ==}
+
+ serve-static@2.2.1:
+ resolution: {integrity: sha512-xRXBn0pPqQTVQiC8wyQrKs2MOlX24zQ0POGaj0kultvoOCstBQM5yvOhAVSUwOMjQtTvsPWoNCHfPGwaaQJhTw==}
+ engines: {node: '>= 18'}
+
+ set-function-length@1.2.2:
+ resolution: {integrity: sha512-pgRc4hJ4/sNjWCSS9AmnS40x3bNMDTknHgL5UaMBTMyJnU90EgWh1Rz+MC9eFu4BuN/UwZjKQuY/1v3rM7HMfg==}
+ engines: {node: '>= 0.4'}
+
+ set-function-name@2.0.2:
+ resolution: {integrity: sha512-7PGFlmtwsEADb0WYyvCMa1t+yke6daIG4Wirafur5kcf+MhUnPms1UeR0CKQdTZD81yESwMHbtn+TR+dMviakQ==}
+ engines: {node: '>= 0.4'}
+
+ setprototypeof@1.2.0:
+ resolution: {integrity: sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==}
+
+ shebang-command@2.0.0:
+ resolution: {integrity: sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==}
+ engines: {node: '>=8'}
+
+ shebang-regex@3.0.0:
+ resolution: {integrity: sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==}
+ engines: {node: '>=8'}
+
+ shell-quote@1.8.4:
+ resolution: {integrity: sha512-VsC6n6vz1ihYYyZZwX7YZSF5l5x36ca17OC+a69h94YqB7X6XLwf+5MOgynYir2SLFUbl8gIYvBo8K8RoNQ6bQ==}
+ engines: {node: '>= 0.4'}
+
+ sherif-darwin-arm64@1.11.1:
+ resolution: {integrity: sha512-VoMrUv5QY6hQ2rByNa3AAhr/KGQsCb6pvAUNKa1iCh1jvnY836hQr6zNBw9hYCDkVv6t9sITFGJljwdTCQD4xw==}
+ cpu: [arm64]
+ os: [darwin]
+
+ sherif-darwin-x64@1.11.1:
+ resolution: {integrity: sha512-7j3yOCBkvVbltVT3lXoiazGfG2nb36FteYT5VZPEBSf8sTn1pPTScukAQ1Fdl+MphadGyici7XlRbDrtZ/wnvA==}
+ cpu: [x64]
+ os: [darwin]
+
+ sherif-linux-arm64-musl@1.11.1:
+ resolution: {integrity: sha512-DCf87RFqBh8ZrYgu3y+fv0x4kFn/np84m2jAEgygznwozH/VCfrXbHFVdhxW7762JCYkXbHO9dUj/ff5fkvkvw==}
+ cpu: [arm64]
+ os: [linux]
+
+ sherif-linux-arm64@1.11.1:
+ resolution: {integrity: sha512-vCZFS7RxhZ/8g9bdj3UPNVPTcZiKiWigW+FIlVQEUKEKfG0MfSOMBJqEWPVVUniyJa3rdIxtmZKSdWkG0e1x3w==}
+ cpu: [arm64]
+ os: [linux]
+
+ sherif-linux-x64-musl@1.11.1:
+ resolution: {integrity: sha512-f8xitqXdHObUFPZo4QVbz3o30Y4+gHA3B5ZobsOWocnSfJBaUGutBzJsUsjG6w2tccSRn6+mugiMUGKIbIPZmQ==}
+ cpu: [x64]
+ os: [linux]
+
+ sherif-linux-x64@1.11.1:
+ resolution: {integrity: sha512-9t+p1X3SyhU75BrJNHBbj9i/aQxHC/sF+Mdkf17V5AlokCznFgYKQUXq5EVmcmRDDhDl69RMzCTLD95EBqUSYA==}
+ cpu: [x64]
+ os: [linux]
+
+ sherif-windows-arm64@1.11.1:
+ resolution: {integrity: sha512-Dnffgcyz9zLq/8UTY2REchJzRJWcWAuMWo5Vl5O17IZGkhl71dwa7/Vi2wC3EQd8WAVK/O82yArOYggWA0dj5w==}
+ cpu: [arm64]
+ os: [win32]
+
+ sherif-windows-x64@1.11.1:
+ resolution: {integrity: sha512-xjfYUL/IQ65DwHkRsWIxiZWtglKtL5/E3UHpnLwOui3jqW1V2K88SMct415dnlBQiL3U9VEIVUo1i+KmToOBgQ==}
+ cpu: [x64]
+ os: [win32]
+
+ sherif@1.11.1:
+ resolution: {integrity: sha512-HBFce8NGaPuWPg5NXb6+aI7hJQFjTilhtbrgo+Y/BvtGlkuJAzLnkmC8nyD+p3v7oIAq4KQeA8qySKGga28xZg==}
+ hasBin: true
+
+ shiki@4.1.0:
+ resolution: {integrity: sha512-l/ABZPUR5v70jI10EzqfMS/I96vjSGv2y0ihUV+WYFzv0EfvW4s54m0Lg8wCrrL+2IkwBzFTuxkZjPf8b2NX9Q==}
+ engines: {node: '>=20'}
+
+ side-channel-list@1.0.1:
+ resolution: {integrity: sha512-mjn/0bi/oUURjc5Xl7IaWi/OJJJumuoJFQJfDDyO46+hBWsfaVM65TBHq2eoZBhzl9EchxOijpkbRC8SVBQU0w==}
+ engines: {node: '>= 0.4'}
+
+ side-channel-map@1.0.1:
+ resolution: {integrity: sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==}
+ engines: {node: '>= 0.4'}
+
+ side-channel-weakmap@1.0.2:
+ resolution: {integrity: sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==}
+ engines: {node: '>= 0.4'}
+
+ side-channel@1.1.0:
+ resolution: {integrity: sha512-ZX99e6tRweoUXqR+VBrslhda51Nh5MTQwou5tnUDgbtyM0dBgmhEDtWGP/xbKn6hqfPRHujUNwz5fy/wbbhnpw==}
+ engines: {node: '>= 0.4'}
+
+ siginfo@2.0.0:
+ resolution: {integrity: sha512-ybx0WO1/8bSBLEWXZvEd7gMW3Sn3JFlW3TvX1nREbDLRNQNaeNN8WK0meBwPdAaOI7TtRRRJn/Es1zhrrCHu7g==}
+
+ signal-exit@3.0.7:
+ resolution: {integrity: sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ==}
+
+ signal-exit@4.1.0:
+ resolution: {integrity: sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==}
+ engines: {node: '>=14'}
+
+ sirv@3.0.2:
+ resolution: {integrity: sha512-2wcC/oGxHis/BoHkkPwldgiPSYcpZK3JU28WoMVv55yHJgcZ8rlXvuG9iZggz+sU1d4bRgIGASwyWqjxu3FM0g==}
+ engines: {node: '>=18'}
+
+ sisteransi@1.0.5:
+ resolution: {integrity: sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg==}
+
+ skin-tone@2.0.0:
+ resolution: {integrity: sha512-kUMbT1oBJCpgrnKoSr0o6wPtvRWT9W9UKvGLwfJYO2WuahZRHOpEyL1ckyMGgMWh0UdpmaoFqKKD29WTomNEGA==}
+ engines: {node: '>=8'}
+
+ slash@5.1.0:
+ resolution: {integrity: sha512-ZA6oR3T/pEyuqwMgAKT0/hAv8oAXckzbkmR0UkUosQ+Mc4RxGoJkRmwHgHufaenlyAgE1Mxgpdcrf75y6XcnDg==}
+ engines: {node: '>=14.16'}
+
+ smob@1.6.2:
+ resolution: {integrity: sha512-RQsvleCbF8cVHEv+xuDGaA4pOizFqJ0GgjtMSRo6oP8pnN7WsigHgVGey6aILRBKv4W2YOMHLqbKdnB6hpB9fw==}
+ engines: {node: '>=20.0.0'}
+
+ smol-toml@1.6.1:
+ resolution: {integrity: sha512-dWUG8F5sIIARXih1DTaQAX4SsiTXhInKf1buxdY9DIg4ZYPZK5nGM1VRIYmEbDbsHt7USo99xSLFu5Q1IqTmsg==}
+ engines: {node: '>= 18'}
+
+ source-map-js@1.2.1:
+ resolution: {integrity: sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==}
+ engines: {node: '>=0.10.0'}
+
+ source-map-support@0.5.21:
+ resolution: {integrity: sha512-uBHU3L3czsIyYXKX88fdrGovxdSCoTGDRZ6SYXtSRxLZUzHg5P/66Ht6uoUlHu9EZod+inXhKo3qQgwXUT/y1w==}
+
+ source-map@0.6.1:
+ resolution: {integrity: sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==}
+ engines: {node: '>=0.10.0'}
+
+ source-map@0.7.6:
+ resolution: {integrity: sha512-i5uvt8C3ikiWeNZSVZNWcfZPItFQOsYTUAOkcUPGd8DqDy1uOUikjt5dG+uRlwyvR108Fb9DOd4GvXfT0N2/uQ==}
+ engines: {node: '>= 12'}
+
+ space-separated-tokens@2.0.2:
+ resolution: {integrity: sha512-PEGlAwrG8yXGXRjW32fGbg66JAlOAwbObuqVoJpv/mRgoWDQfgH1wDPvtzWyUSNAXBGSk8h755YDbbcEy3SH2Q==}
+
+ spdx-correct@3.2.0:
+ resolution: {integrity: sha512-kN9dJbvnySHULIluDHy32WHRUu3Og7B9sbY7tsFLctQkIqnMh3hErYgdMjTYuqmcXX+lK5T1lnUt3G7zNswmZA==}
+
+ spdx-exceptions@2.5.0:
+ resolution: {integrity: sha512-PiU42r+xO4UbUS1buo3LPJkjlO7430Xn5SVAhdpzzsPHsjbYVflnnFdATgabnLude+Cqu25p6N+g2lw/PFsa4w==}
+
+ spdx-expression-parse@3.0.1:
+ resolution: {integrity: sha512-cbqHunsQWnJNE6KhVSMsMeH5H/L9EpymbzqTQ3uLwNCLZ1Q481oWaofqH7nO6V07xlXwY6PhQdQ2IedWx/ZK4Q==}
+
+ spdx-expression-parse@4.0.0:
+ resolution: {integrity: sha512-Clya5JIij/7C6bRR22+tnGXbc4VKlibKSVj2iHvVeX5iMW7s1SIQlqu699JkODJJIhh/pUu8L0/VLh8xflD+LQ==}
+
+ spdx-license-ids@3.0.23:
+ resolution: {integrity: sha512-CWLcCCH7VLu13TgOH+r8p1O/Znwhqv/dbb6lqWy67G+pT1kHmeD/+V36AVb/vq8QMIQwVShJ6Ssl5FPh0fuSdw==}
+
+ split2@4.2.0:
+ resolution: {integrity: sha512-UcjcJOWknrNkF6PLX83qcHM6KHgVKNkV62Y8a5uYDVv9ydGQVwAHMKqHdJje1VTWpljG0WYpCDhrCdAOYH4TWg==}
+ engines: {node: '>= 10.x'}
+
+ srvx@0.11.15:
+ resolution: {integrity: sha512-iXsux0UcOjdvs0LCMa2Ws3WwcDUozA3JN3BquNXkaFPP7TpRqgunKdEgoZ/uwb1J6xaYHfxtz9Twlh6yzwM6Tg==}
+ engines: {node: '>=20.16.0'}
+ hasBin: true
+
+ stable-hash-x@0.2.0:
+ resolution: {integrity: sha512-o3yWv49B/o4QZk5ZcsALc6t0+eCelPc44zZsLtCQnZPDwFpDYSWcDnrv2TtMmMbQ7uKo3J0HTURCqckw23czNQ==}
+ engines: {node: '>=12.0.0'}
+
+ stackback@0.0.2:
+ resolution: {integrity: sha512-1XMJE5fQo1jGH6Y/7ebnwPOBEkIEnT4QF32d5R1+VXdXveM0IBMJt8zfaxX1P3QhVwrYe+576+jkANtSS2mBbw==}
+
+ stackframe@1.3.4:
+ resolution: {integrity: sha512-oeVtt7eWQS+Na6F//S4kJ2K2VbRlS9D43mAlMyVpVWovy9o+jfgH8O9agzANzaiLjclA0oYzUXEM4PurhSUChw==}
+
+ standard-as-callback@2.1.0:
+ resolution: {integrity: sha512-qoRRSyROncaz1z0mvYqIE4lCd9p2R90i6GxW3uZv5ucSu8tU7B5HXUP1gG8pVZsYNVaXjk8ClXHPttLyxAL48A==}
+
+ statuses@2.0.2:
+ resolution: {integrity: sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw==}
+ engines: {node: '>= 0.8'}
+
+ std-env@3.10.0:
+ resolution: {integrity: sha512-5GS12FdOZNliM5mAOxFRg7Ir0pWz8MdpYm6AY6VPkGpbA7ZzmbzNcBJQ0GPvvyWgcY7QAhCgf9Uy89I03faLkg==}
+
+ std-env@4.1.0:
+ resolution: {integrity: sha512-Rq7ybcX2RuC55r9oaPVEW7/xu3tj8u4GeBYHBWCychFtzMIr86A7e3PPEBPT37sHStKX3+TiX/Fr/ACmJLVlLQ==}
+
+ stop-iteration-iterator@1.1.0:
+ resolution: {integrity: sha512-eLoXW/DHyl62zxY4SCaIgnRhuMr6ri4juEYARS8E6sCEqzKpOiE521Ucofdx+KnDZl5xmvGYaaKCk5FEOxJCoQ==}
+ engines: {node: '>= 0.4'}
+
+ streamx@2.25.0:
+ resolution: {integrity: sha512-0nQuG6jf1w+wddNEEXCF4nTg3LtufWINB5eFEN+5TNZW7KWJp6x87+JFL43vaAUPyCfH1wID+mNVyW6OHtFamg==}
+
+ string-width@4.2.3:
+ resolution: {integrity: sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==}
+ engines: {node: '>=8'}
+
+ string-width@5.1.2:
+ resolution: {integrity: sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA==}
+ engines: {node: '>=12'}
+
+ string-width@7.2.0:
+ resolution: {integrity: sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==}
+ engines: {node: '>=18'}
+
+ string-width@8.1.0:
+ resolution: {integrity: sha512-Kxl3KJGb/gxkaUMOjRsQ8IrXiGW75O4E3RPjFIINOVH8AMl2SQ/yWdTzWwF3FevIX9LcMAjJW+GRwAlAbTSXdg==}
+ engines: {node: '>=20'}
+
+ string_decoder@1.1.1:
+ resolution: {integrity: sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==}
+
+ string_decoder@1.3.0:
+ resolution: {integrity: sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==}
+
+ stringify-entities@4.0.4:
+ resolution: {integrity: sha512-IwfBptatlO+QCJUo19AqvrPNqlVMpW9YEL2LIVY+Rpv2qsjCGxaDLNRgeGsQWJhfItebuJhsGSLjaBbNSQ+ieg==}
+
+ strip-ansi@6.0.1:
+ resolution: {integrity: sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==}
+ engines: {node: '>=8'}
+
+ strip-ansi@7.2.0:
+ resolution: {integrity: sha512-yDPMNjp4WyfYBkHnjIRLfca1i6KMyGCtsVgoKe/z1+6vukgaENdgGBZt+ZmKPc4gavvEZ5OgHfHdrazhgNyG7w==}
+ engines: {node: '>=12'}
+
+ strip-bom@4.0.0:
+ resolution: {integrity: sha512-3xurFv5tEgii33Zi8Jtp55wEIILR9eh34FAW00PZf+JnSsTmV/ioewSgQl97JHvgjoRGwPShsWm+IdrxB35d0w==}
+ engines: {node: '>=8'}
+
+ strip-comments-strings@1.2.0:
+ resolution: {integrity: sha512-zwF4bmnyEjZwRhaak9jUWNxc0DoeKBJ7lwSN/LEc8dQXZcUFG6auaaTQJokQWXopLdM3iTx01nQT8E4aL29DAQ==}
+
+ strip-final-newline@3.0.0:
+ resolution: {integrity: sha512-dOESqjYr96iWYylGObzd39EuNTa5VJxyvVAEm5Jnh7KGo75V43Hk1odPQkNDyXNmUR6k+gEiDVXnjB8HJ3crXw==}
+ engines: {node: '>=12'}
+
+ strip-indent@4.1.1:
+ resolution: {integrity: sha512-SlyRoSkdh1dYP0PzclLE7r0M9sgbFKKMFXpFRUMNuKhQSbC6VQIGzq3E0qsfvGJaUFJPGv6Ws1NZ/haTAjfbMA==}
+ engines: {node: '>=12'}
+
+ strip-json-comments@3.1.1:
+ resolution: {integrity: sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig==}
+ engines: {node: '>=8'}
+
+ strip-json-comments@5.0.3:
+ resolution: {integrity: sha512-1tB5mhVo7U+ETBKNf92xT4hrQa3pm0MZ0PQvuDnWgAAGHDsfp4lPSpiS6psrSiet87wyGPh9ft6wmhOMQ0hDiw==}
+ engines: {node: '>=14.16'}
+
+ strip-literal@3.1.0:
+ resolution: {integrity: sha512-8r3mkIM/2+PpjHoOtiAW8Rg3jJLHaV7xPwG+YRGrv6FP0wwk/toTpATxWYOW0BKdWwl82VT2tFYi5DlROa0Mxg==}
+
+ structured-clone-es@2.0.0:
+ resolution: {integrity: sha512-5UuAHmBLXYPCl22xWJrFuGmIhBKQzxISPVz6E7nmTmTcAOpUzlbjKJsRrCE4vADmMQ0dzeCnlWn9XufnAGf76Q==}
+
+ stylehacks@7.0.11:
+ resolution: {integrity: sha512-iODNfhXVLqc5LADs+Y6Oh5wJuK5ZcHbVng8aiK3y9pjMQdc5hLrBW0eFU6FtnpNrE6PoEg/MmFTU4waotj5WNg==}
+ engines: {node: ^18.12.0 || ^20.9.0 || >=22.0}
+ peerDependencies:
+ postcss: ^8.5.13
+
+ stylehacks@8.0.0:
+ resolution: {integrity: sha512-sWyjaJvBqHoVKYPbQ8JRvrGSPaYWtWrJsU+fGVtwKB1GE1rRPu3rC7T6UCuXLoL00Dwb+tsHe2T904r8Vnsx8w==}
+ engines: {node: ^22.11.0 || ^24.11.0 || >=26.0}
+ peerDependencies:
+ postcss: ^8.5.14
+
+ supports-color@10.2.2:
+ resolution: {integrity: sha512-SS+jx45GF1QjgEXQx4NJZV9ImqmO2NPz5FNsIHrsDjh2YsHnawpan7SNQ1o8NuhrbHZy9AZhIoCUiCeaW/C80g==}
+ engines: {node: '>=18'}
+
+ supports-color@5.5.0:
+ resolution: {integrity: sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow==}
+ engines: {node: '>=4'}
+
+ supports-color@7.2.0:
+ resolution: {integrity: sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==}
+ engines: {node: '>=8'}
+
+ supports-color@8.1.1:
+ resolution: {integrity: sha512-MpUEN2OodtUzxvKQl72cUF7RQ5EiHsGvSsVG0ia9c5RbWGL2CI4C7EpPS8UTBIplnlzZiNuV56w+FuNxy3ty2Q==}
+ engines: {node: '>=10'}
+
+ supports-hyperlinks@3.2.0:
+ resolution: {integrity: sha512-zFObLMyZeEwzAoKCyu1B91U79K2t7ApXuQfo8OuxwXLDgcKxuwM+YvcbIhm6QWqz7mHUH1TVytR1PwVVjEuMig==}
+ engines: {node: '>=14.18'}
+
+ supports-preserve-symlinks-flag@1.0.0:
+ resolution: {integrity: sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==}
+ engines: {node: '>= 0.4'}
+
+ svgo@4.0.1:
+ resolution: {integrity: sha512-XDpWUOPC6FEibaLzjfe0ucaV0YrOjYotGJO1WpF0Zd+n6ZGEQUsSugaoLq9QkEZtAfQIxT42UChcssDVPP3+/w==}
+ engines: {node: '>=16'}
+ hasBin: true
+
+ tagged-tag@1.0.0:
+ resolution: {integrity: sha512-yEFYrVhod+hdNyx7g5Bnkkb0G6si8HJurOoOEgC8B/O0uXLHlaey/65KRv6cuWBNhBgHKAROVpc7QyYqE5gFng==}
+ engines: {node: '>=20'}
+
+ tapable@1.1.3:
+ resolution: {integrity: sha512-4WK/bYZmj8xLr+HUCODHGF1ZFzsYffasLUgEiMBY4fgtltdO6B4WJtlSbPaDTLpYTcGVwM2qLnFTICEcNxs3kA==}
+ engines: {node: '>=6'}
+
+ tapable@2.3.3:
+ resolution: {integrity: sha512-uxc/zpqFg6x7C8vOE7lh6Lbda8eEL9zmVm/PLeTPBRhh1xCgdWaQ+J1CUieGpIfm2HdtsUpRv+HshiasBMcc6A==}
+ engines: {node: '>=6'}
+
+ tar-stream@3.2.0:
+ resolution: {integrity: sha512-ojzvCvVaNp6aOTFmG7jaRD0meowIAuPc3cMMhSgKiVWws1GyHbGd/xvnyuRKcKlMpt3qvxx6r0hreCNITP9hIg==}
+
+ tar@7.5.15:
+ resolution: {integrity: sha512-dzGK0boVlC4W5QFuQN1EFSl3bIDYsk7Tj40U6eIBnK2k/8ml7TZ5agbI5j5+qnoVcAA+rNtBml8SEiLxZpNqRQ==}
+ engines: {node: '>=18'}
+
+ teex@1.0.1:
+ resolution: {integrity: sha512-eYE6iEI62Ni1H8oIa7KlDU6uQBtqr4Eajni3wX7rpfXD8ysFx8z0+dri+KWEPWpBsxXfxu58x/0jvTVT1ekOSg==}
+
+ terser-webpack-plugin@5.6.0:
+ resolution: {integrity: sha512-Eum+5ajkaOhf5KbM26osvv21kLD7BaGqQ1UA4Ami4arYwylmGUQTgHFpHDdmJod1q4QXa66p0to/FBKID+J1vA==}
+ engines: {node: '>= 10.13.0'}
+ peerDependencies:
+ '@minify-html/node': '*'
+ '@swc/core': '*'
+ '@swc/css': '*'
+ '@swc/html': '*'
+ clean-css: '*'
+ cssnano: '*'
+ csso: '*'
+ esbuild: '*'
+ html-minifier-terser: '*'
+ lightningcss: '*'
+ postcss: '*'
+ uglify-js: '*'
+ webpack: ^5.1.0
+ peerDependenciesMeta:
+ '@minify-html/node':
+ optional: true
+ '@swc/core':
+ optional: true
+ '@swc/css':
+ optional: true
+ '@swc/html':
+ optional: true
+ clean-css:
+ optional: true
+ cssnano:
+ optional: true
+ csso:
+ optional: true
+ esbuild:
+ optional: true
+ html-minifier-terser:
+ optional: true
+ lightningcss:
+ optional: true
+ postcss:
+ optional: true
+ uglify-js:
+ optional: true
+
+ terser@5.48.0:
+ resolution: {integrity: sha512-J/9An6vs9Us6wKRriSFXBWdRZapREHqFzdNUKk0pmu804EMR6dr6winwo7e5JDxN4xahxQsuysyYFwlwj4XN/Q==}
+ engines: {node: '>=10'}
+ hasBin: true
+
+ text-decoder@1.2.7:
+ resolution: {integrity: sha512-vlLytXkeP4xvEq2otHeJfSQIRyWxo/oZGEbXrtEEF9Hnmrdly59sUbzZ/QgyWuLYHctCHxFF4tRQZNQ9k60ExQ==}
+
+ thenify-all@1.6.0:
+ resolution: {integrity: sha512-RNxQH/qI8/t3thXJDwcstUO4zeqo64+Uy/+sNVRBx4Xn2OX+OZ9oP+iJnNFqplFra2ZUVeKCSa2oVWi3T4uVmA==}
+ engines: {node: '>=0.8'}
+
+ thenify@3.3.1:
+ resolution: {integrity: sha512-RVZSIV5IG10Hk3enotrhvz0T9em6cyHBLkH/YAZuKqd8hRkKhSfCGIcP2KUY0EPxndzANBmNllzWPwak+bheSw==}
+
+ thingies@2.6.0:
+ resolution: {integrity: sha512-rMHRjmlFLM1R96UYPvpmnc3LYtdFrT33JIB7L9hetGue1qAPfn1N2LJeEjxUSidu1Iku+haLZXDuEXUHNGO/lg==}
+ engines: {node: '>=10.18'}
+ peerDependencies:
+ tslib: ^2
+
+ time-fix-plugin@2.0.7:
+ resolution: {integrity: sha512-uVFet1LQToeUX0rTcSiYVYVoGuBpc8gP/2jnlUzuHMHe+gux6XLsNzxLUweabMwiUj5ejhoIMsUI55nVSEa/Vw==}
+ peerDependencies:
+ webpack: '>=4.0.0'
+
+ tiny-invariant@1.3.3:
+ resolution: {integrity: sha512-+FbBPE1o9QAYvviau/qC5SE3caw21q3xkvWKBtja5vgqOWIHHJ3ioaq1VPfn/Szqctz2bU/oYeKd9/z5BL+PVg==}
+
+ tinybench@2.9.0:
+ resolution: {integrity: sha512-0+DUvqWMValLmha6lr4kD8iAMK1HzV0/aKnCtWb9v9641TnP/MFb7Pc2bxoxQjTXAErryXVgUOfv2YqNllqGeg==}
+
+ tinyclip@0.1.12:
+ resolution: {integrity: sha512-Ae3OVUqifDw0wBriIBS7yVaW44Dp6eSHQcyq4Igc7eN2TJH/2YsicswaW+J/OuMvhpDPOKEgpAZCjkb4hpoyeA==}
+ engines: {node: ^16.14.0 || >= 17.3.0}
+
+ tinyexec@1.1.2:
+ resolution: {integrity: sha512-dAqSqE/RabpBKI8+h26GfLq6Vb3JVXs30XYQjdMjaj/c2tS8IYYMbIzP599KtRj7c57/wYApb3QjgRgXmrCukA==}
+ engines: {node: '>=18'}
+
+ tinyglobby@0.2.16:
+ resolution: {integrity: sha512-pn99VhoACYR8nFHhxqix+uvsbXineAasWm5ojXoN8xEwK5Kd3/TrhNn1wByuD52UxWRLy8pu+kRMniEi6Eq9Zg==}
+ engines: {node: '>=12.0.0'}
+
+ tinyrainbow@3.1.0:
+ resolution: {integrity: sha512-Bf+ILmBgretUrdJxzXM0SgXLZ3XfiaUuOj/IKQHuTXip+05Xn+uyEYdVg0kYDipTBcLrCVyUzAPz7QmArb0mmw==}
+ engines: {node: '>=14.0.0'}
+
+ to-regex-range@5.0.1:
+ resolution: {integrity: sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==}
+ engines: {node: '>=8.0'}
+
+ to-valid-identifier@1.0.0:
+ resolution: {integrity: sha512-41wJyvKep3yT2tyPqX/4blcfybknGB4D+oETKLs7Q76UiPqRpUJK3hr1nxelyYO0PHKVzJwlu0aCeEAsGI6rpw==}
+ engines: {node: '>=20'}
+
+ toidentifier@1.0.1:
+ resolution: {integrity: sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==}
+ engines: {node: '>=0.6'}
+
+ token-stream@1.0.0:
+ resolution: {integrity: sha512-VSsyNPPW74RpHwR8Fc21uubwHY7wMDeJLys2IX5zJNih+OnAnaifKHo+1LHT7DAdloQ7apeaaWg8l7qnf/TnEg==}
+
+ totalist@3.0.1:
+ resolution: {integrity: sha512-sf4i37nQ2LBx4m3wB74y+ubopq6W/dIzXg0FDGjsYnZHVa1Da8FH853wlL2gtUhg+xJXjfk3kUZS3BRoQeoQBQ==}
+ engines: {node: '>=6'}
+
+ tr46@0.0.3:
+ resolution: {integrity: sha512-N3WMsuqV66lT30CrXNbEjx4GEwlow3v6rr4mCcv6prnfwhS01rkgyFdjPNBYd9br7LpXV1+Emh01fHnq2Gdgrw==}
+
+ tree-dump@1.1.0:
+ resolution: {integrity: sha512-rMuvhU4MCDbcbnleZTFezWsaZXRFemSqAM+7jPnzUl1fo9w3YEKOxAeui0fz3OI4EU4hf23iyA7uQRVko+UaBA==}
+ engines: {node: '>=10.0'}
+ peerDependencies:
+ tslib: '2'
+
+ trim-lines@3.0.1:
+ resolution: {integrity: sha512-kRj8B+YHZCc9kQYdWfJB2/oUl9rA99qbowYYBtr4ui4mZyAQ2JpvVBd/6U2YloATfqBhBTSMhTpgBHtU0Mf3Rg==}
+
+ trim-trailing-lines@2.1.0:
+ resolution: {integrity: sha512-5UR5Biq4VlVOtzqkm2AZlgvSlDJtME46uV0br0gENbwN4l5+mMKT4b9gJKqWtuL2zAIqajGJGuvbCbcAJUZqBg==}
+
+ trough@2.2.0:
+ resolution: {integrity: sha512-tmMpK00BjZiUyVyvrBK7knerNgmgvcV/KLVyuma/SC+TQN167GrMRciANTz09+k3zW8L8t60jWO1GpfkZdjTaw==}
+
+ ts-api-utils@2.5.0:
+ resolution: {integrity: sha512-OJ/ibxhPlqrMM0UiNHJ/0CKQkoKF243/AEmplt3qpRgkW8VG7IfOS41h7V8TjITqdByHzrjcS/2si+y4lIh8NA==}
+ engines: {node: '>=18.12'}
+ peerDependencies:
+ typescript: '>=4.8.4'
+
+ ts-blank-space@0.9.0:
+ resolution: {integrity: sha512-TU6coIZm6RxGgAjroRKmi6aCQ7Pq7cT+1I+bTKBepD6joOuWqUCOptVlz+eurqTnatnQOimlR8XB5sQZ6ULwbw==}
+ engines: {node: '>=18.0.0'}
+
+ ts-checker-rspack-plugin@1.3.0:
+ resolution: {integrity: sha512-89oK/BtApjdid1j9CGjPGiYry+EZBhsnTAM481/8ipgr/y2IOgCbW1HPnan+fs5FnzlpUgf9dWGNZ4Ayw3Bd8A==}
+ peerDependencies:
+ '@rspack/core': ^1.0.0 || ^2.0.0-0
+ typescript: '>=3.8.0'
+ peerDependenciesMeta:
+ '@rspack/core':
+ optional: true
+
+ tslib@2.8.1:
+ resolution: {integrity: sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==}
+
+ twoslash-protocol@0.3.8:
+ resolution: {integrity: sha512-HmvAHoiEviK8LqvAQyc9/irkdvwTUiR1fHmNwH/0gq8EHxyBt4PWVPixjEXg6wJu1u6yBrILEWXGK9Kw58/8yQ==}
+
+ twoslash-vue@0.3.8:
+ resolution: {integrity: sha512-5HZAnkQ1R6NXqW9mqsHx4aHVWPb5gb4gfEKiaNczi3q6U7vDZeVv9eONRuPs4qdCd5OJSAIpHeXxIDZmjr0Jww==}
+ peerDependencies:
+ typescript: ^5.5.0 || ^6.0.0
+
+ twoslash@0.3.8:
+ resolution: {integrity: sha512-OeDz0kDl8sqPUN3nr7gqcvOs70f5lZsdhKYTX3/SgB9OvdadzzoYJI/4SBXhXV1HG8E9fLc+e17itoRYTxmoig==}
+ peerDependencies:
+ typescript: ^5.5.0 || ^6.0.0
+
+ type-check@0.4.0:
+ resolution: {integrity: sha512-XleUoc9uwGXqjWwXaUTZAmzMcFZ5858QA2vvx1Ur5xIcixXIP+8LnFDgRplU30us6teqdlskFfu+ae4K79Ooew==}
+ engines: {node: '>= 0.8.0'}
+
+ type-fest@4.41.0:
+ resolution: {integrity: sha512-TeTSQ6H5YHvpqVwBRcnLDCBnDOHWYu7IvGbHT6N8AOymcr9PJGjc1GTtiWZTYg0NCgYwvnYWEkVChQAr9bjfwA==}
+ engines: {node: '>=16'}
+
+ type-fest@5.6.0:
+ resolution: {integrity: sha512-8ZiHFm91orbSAe2PSAiSVBVko18pbhbiB3U9GglSzF/zCGkR+rxpHx6sEMCUm4kxY4LjDIUGgCfUMtwfZfjfUA==}
+ engines: {node: '>=20'}
+
+ type-level-regexp@0.1.17:
+ resolution: {integrity: sha512-wTk4DH3cxwk196uGLK/E9pE45aLfeKJacKmcEgEOA/q5dnPGNxXt0cfYdFxb57L+sEpf1oJH4Dnx/pnRcku9jg==}
+
+ typescript@5.6.1-rc:
+ resolution: {integrity: sha512-E3b2+1zEFu84jB0YQi9BORDjz9+jGbwwy1Zi3G0LUNw7a7cePUrHMRNy8aPh53nXpkFGVHSxIZo5vKTfYaFiBQ==}
+ engines: {node: '>=14.17'}
+ hasBin: true
+
+ typescript@5.9.3:
+ resolution: {integrity: sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==}
+ engines: {node: '>=14.17'}
+ hasBin: true
+
+ typescript@6.0.3:
+ resolution: {integrity: sha512-y2TvuxSZPDyQakkFRPZHKFm+KKVqIisdg9/CZwm9ftvKXLP8NRWj38/ODjNbr43SsoXqNuAisEf1GdCxqWcdBw==}
+ engines: {node: '>=14.17'}
+ hasBin: true
+
+ uc.micro@2.1.0:
+ resolution: {integrity: sha512-ARDJmphmdvUk6Glw7y9DQ2bFkKBHwQHLi2lsaH6PPmz/Ka9sFOBsBluozhDltWmnv9u/cF6Rt87znRTPV+yp/A==}
+
+ ufo@1.6.4:
+ resolution: {integrity: sha512-JFNbkD1Svwe0KvGi8GOeLcP4kAWQ609twvCdcHxq1oSL8svv39ZuSvajcD8B+5D0eL4+s1Is2D/O6KN3qcTeRA==}
+
+ ultrahtml@1.6.0:
+ resolution: {integrity: sha512-R9fBn90VTJrqqLDwyMph+HGne8eqY1iPfYhPzZrvKpIfwkWZbcYlfpsb8B9dTvBfpy1/hqAD7Wi8EKfP9e8zdw==}
+
+ unbash@3.0.0:
+ resolution: {integrity: sha512-FeFPZ/WFT0mbRCuydiZzpPFlrYN8ZUpphQKoq4EeElVIYjYyGzPMxQR/simUwCOJIyVhpFk4RbtyO7RuMpMnHA==}
+ engines: {node: '>=14'}
+
+ unbuild@3.6.1:
+ resolution: {integrity: sha512-+U5CdtrdjfWkZhuO4N9l5UhyiccoeMEXIc2Lbs30Haxb+tRwB3VwB8AoZRxlAzORXunenSo+j6lh45jx+xkKgg==}
+ hasBin: true
+ peerDependencies:
+ typescript: ^5.9.2
+ peerDependenciesMeta:
+ typescript:
+ optional: true
+
+ unconfig-core@7.5.0:
+ resolution: {integrity: sha512-Su3FauozOGP44ZmKdHy2oE6LPjk51M/TRRjHv2HNCWiDvfvCoxC2lno6jevMA91MYAdCdwP05QnWdWpSbncX/w==}
+
+ unconfig@7.5.0:
+ resolution: {integrity: sha512-oi8Qy2JV4D3UQ0PsopR28CzdQ3S/5A1zwsUwp/rosSbfhJ5z7b90bIyTwi/F7hCLD4SGcZVjDzd4XoUQcEanvA==}
+
+ uncrypto@0.1.3:
+ resolution: {integrity: sha512-Ql87qFHB3s/De2ClA9e0gsnS6zXG27SkTiSJwjCc9MebbfapQfuPzumMIUMi38ezPZVNFcHI9sUIepeQfw8J8Q==}
+
+ unctx@2.5.0:
+ resolution: {integrity: sha512-p+Rz9x0R7X+CYDkT+Xg8/GhpcShTlU8n+cf9OtOEf7zEQsNcCZO1dPKNRDqvUTaq+P32PMMkxWHwfrxkqfqAYg==}
+
+ undici-types@7.16.0:
+ resolution: {integrity: sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw==}
+
+ unenv@2.0.0-rc.24:
+ resolution: {integrity: sha512-i7qRCmY42zmCwnYlh9H2SvLEypEFGye5iRmEMKjcGi7zk9UquigRjFtTLz0TYqr0ZGLZhaMHl/foy1bZR+Cwlw==}
+
+ unhead@3.1.0:
+ resolution: {integrity: sha512-SH1PAjAMspLIoBjAjE/R8hty2NYo7YcIrdu5I+PVfiW4QmmwEG4pgoiKG0MCs6WRSwiatzeha+4lqSqvHW9PEg==}
+ peerDependencies:
+ vite: 8.0.12
+ peerDependenciesMeta:
+ vite:
+ optional: true
+
+ unicode-emoji-modifier-base@1.0.0:
+ resolution: {integrity: sha512-yLSH4py7oFH3oG/9K+XWrz1pSi3dfUrWEnInbxMfArOfc1+33BlGPQtLsOYwvdMy11AwUBetYuaRxSPqgkq+8g==}
+ engines: {node: '>=4'}
+
+ unicorn-magic@0.1.0:
+ resolution: {integrity: sha512-lRfVq8fE8gz6QMBuDM6a+LO3IAzTi05H6gCVaUpir2E1Rwpo4ZUog45KpNXKC/Mn3Yb9UDuHumeFTo9iV/D9FQ==}
+ engines: {node: '>=18'}
+
+ unicorn-magic@0.3.0:
+ resolution: {integrity: sha512-+QBBXBCvifc56fsbuxZQ6Sic3wqqc3WWaqxs58gvJrcOuN83HGTCwz3oS5phzU9LthRNE9VrJCFCLUgHeeFnfA==}
+ engines: {node: '>=18'}
+
+ unicorn-magic@0.4.0:
+ resolution: {integrity: sha512-wH590V9VNgYH9g3lH9wWjTrUoKsjLF6sGLjhR4sH1LWpLmCOH0Zf7PukhDA8BiS7KHe4oPNkcTHqYkj7SOGUOw==}
+ engines: {node: '>=20'}
+
+ unified@11.0.5:
+ resolution: {integrity: sha512-xKvGhPWw3k84Qjh8bI3ZeJjqnyadK+GEFtazSfZv/rKeTkTjOJho6mFqh2SM96iIcZokxiOpg78GazTSg8+KHA==}
+
+ unimport@6.3.0:
+ resolution: {integrity: sha512-M+Dxk5W9WRd+8j56W9tp8lGW/dmMc7g5zj7BWQnEjKQhryBstqsi1V0izb0zHwSkEN8cSYV7K75/bykairV2tA==}
+ engines: {node: '>=18.12.0'}
+ peerDependencies:
+ oxc-parser: '*'
+ rolldown: ^1.0.0
+ peerDependenciesMeta:
+ oxc-parser:
+ optional: true
+ rolldown:
+ optional: true
+
+ unist-builder@4.0.0:
+ resolution: {integrity: sha512-wmRFnH+BLpZnTKpc5L7O67Kac89s9HMrtELpnNaE6TAobq5DTZZs5YaTQfAZBA9bFPECx2uVAPO31c+GVug8mg==}
+
+ unist-util-find-after@5.0.0:
+ resolution: {integrity: sha512-amQa0Ep2m6hE2g72AugUItjbuM8X8cGQnFoHk0pGfrFeT9GZhzN5SW8nRsiGKK7Aif4CrACPENkA6P/Lw6fHGQ==}
+
+ unist-util-is@6.0.1:
+ resolution: {integrity: sha512-LsiILbtBETkDz8I9p1dQ0uyRUWuaQzd/cuEeS1hoRSyW5E5XGmTzlwY1OrNzzakGowI9Dr/I8HVaw4hTtnxy8g==}
+
+ unist-util-position@5.0.0:
+ resolution: {integrity: sha512-fucsC7HjXvkB5R3kTCO7kUjRdrS0BJt3M/FPxmHMBOm8JQi2BsHAHFsy27E0EolP8rp0NzXsJ+jNPyDWvOJZPA==}
+
+ unist-util-remove-position@5.0.0:
+ resolution: {integrity: sha512-Hp5Kh3wLxv0PHj9m2yZhhLt58KzPtEYKQQ4yxfYFEO7EvHwzyDYnduhHnY1mDxoqr7VUwVuHXk9RXKIiYS1N8Q==}
+
+ unist-util-stringify-position@4.0.0:
+ resolution: {integrity: sha512-0ASV06AAoKCDkS2+xw5RXJywruurpbC4JZSm7nr7MOt1ojAzvyyaO+UxZf18j8FCF6kmzCZKcAgN/yu2gm2XgQ==}
+
+ unist-util-visit-parents@6.0.2:
+ resolution: {integrity: sha512-goh1s1TBrqSqukSc8wrjwWhL0hiJxgA8m4kFxGlQ+8FYQ3C/m11FcTs4YYem7V664AhHVvgoQLk890Ssdsr2IQ==}
+
+ unist-util-visit@5.1.0:
+ resolution: {integrity: sha512-m+vIdyeCOpdr/QeQCu2EzxX/ohgS8KbnPDgFni4dQsfSCtpz8UqDyY5GjRru8PDKuYn7Fq19j1CQ+nJSsGKOzg==}
+
+ universalify@2.0.1:
+ resolution: {integrity: sha512-gptHNQghINnc/vTGIk0SOFGFNXw7JVrlRUtConJRlvaw6DuX0wO5Jeko9sWrMBhh+PsYAZ7oXAiOnf/UKogyiw==}
+ engines: {node: '>= 10.0.0'}
+
+ unocss@66.6.8:
+ resolution: {integrity: sha512-stq9FbxedTDkoWrxnNQNnPQXOaM6L2Lobq8HzjXdR2tMc55gtfqDArqL7TESfnN7qeZsIocNYCHLNA4DXq50YQ==}
+ engines: {node: '>=14'}
+ peerDependencies:
+ '@unocss/astro': 66.6.8
+ '@unocss/postcss': 66.6.8
+ '@unocss/webpack': 66.6.8
+ peerDependenciesMeta:
+ '@unocss/astro':
+ optional: true
+ '@unocss/postcss':
+ optional: true
+ '@unocss/webpack':
+ optional: true
+
+ unplugin-utils@0.3.1:
+ resolution: {integrity: sha512-5lWVjgi6vuHhJ526bI4nlCOmkCIF3nnfXkCMDeMJrtdvxTs6ZFCM8oNufGTsDbKv/tJ/xj8RpvXjRuPBZJuJog==}
+ engines: {node: '>=20.19.0'}
+
+ unplugin@2.3.11:
+ resolution: {integrity: sha512-5uKD0nqiYVzlmCRs01Fhs2BdkEgBS3SAVP6ndrBsuK42iC2+JHyxM05Rm9G8+5mkmRtzMZGY8Ct5+mliZxU/Ww==}
+ engines: {node: '>=18.12.0'}
+
+ unplugin@3.0.0:
+ resolution: {integrity: sha512-0Mqk3AT2TZCXWKdcoaufeXNukv2mTrEZExeXlHIOZXdqYoHHr4n51pymnwV8x2BOVxwXbK2HLlI7usrqMpycdg==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+
+ unrouting@0.1.7:
+ resolution: {integrity: sha512-+0hfD+CVWtD636rc5Fn9VEjjTEDhdqgMpbwAuVoUmydSHDaMNiFW93SJG4LV++RoGSEAyvQN5uABAscYpDphpQ==}
+
+ unrs-resolver@1.12.2:
+ resolution: {integrity: sha512-dmlRxBJJayXjqTwC+JtF1HhJmgf3ftQ3YejFcZrf4+KKtJv0qDsK1pjqaaVjG7wJ5NJ6UVP1OqRMQ71Z4C3rxQ==}
+
+ unstorage@1.17.5:
+ resolution: {integrity: sha512-0i3iqvRfx29hkNntHyQvJTpf5W9dQ9ZadSoRU8+xVlhVtT7jAX57fazYO9EHvcRCfBCyi5YRya7XCDOsbTgkPg==}
+ peerDependencies:
+ '@azure/app-configuration': ^1.8.0
+ '@azure/cosmos': ^4.2.0
+ '@azure/data-tables': ^13.3.0
+ '@azure/identity': ^4.6.0
+ '@azure/keyvault-secrets': ^4.9.0
+ '@azure/storage-blob': ^12.26.0
+ '@capacitor/preferences': ^6 || ^7 || ^8
+ '@deno/kv': '>=0.9.0'
+ '@netlify/blobs': ^6.5.0 || ^7.0.0 || ^8.1.0 || ^9.0.0 || ^10.0.0
+ '@planetscale/database': ^1.19.0
+ '@upstash/redis': ^1.34.3
+ '@vercel/blob': '>=0.27.1'
+ '@vercel/functions': ^2.2.12 || ^3.0.0
+ '@vercel/kv': ^1 || ^2 || ^3
+ aws4fetch: ^1.0.20
+ db0: '>=0.2.1'
+ idb-keyval: ^6.2.1
+ ioredis: ^5.4.2
+ uploadthing: ^7.4.4
+ peerDependenciesMeta:
+ '@azure/app-configuration':
+ optional: true
+ '@azure/cosmos':
+ optional: true
+ '@azure/data-tables':
+ optional: true
+ '@azure/identity':
+ optional: true
+ '@azure/keyvault-secrets':
+ optional: true
+ '@azure/storage-blob':
+ optional: true
+ '@capacitor/preferences':
+ optional: true
+ '@deno/kv':
+ optional: true
+ '@netlify/blobs':
+ optional: true
+ '@planetscale/database':
+ optional: true
+ '@upstash/redis':
+ optional: true
+ '@vercel/blob':
+ optional: true
+ '@vercel/functions':
+ optional: true
+ '@vercel/kv':
+ optional: true
+ aws4fetch:
+ optional: true
+ db0:
+ optional: true
+ idb-keyval:
+ optional: true
+ ioredis:
+ optional: true
+ uploadthing:
+ optional: true
+
+ unstorage@2.0.0-alpha.7:
+ resolution: {integrity: sha512-ELPztchk2zgFJnakyodVY3vJWGW9jy//keJ32IOJVGUMyaPydwcA1FtVvWqT0TNRch9H+cMNEGllfVFfScImog==}
+ peerDependencies:
+ '@azure/app-configuration': ^1.11.0
+ '@azure/cosmos': ^4.9.1
+ '@azure/data-tables': ^13.3.2
+ '@azure/identity': ^4.13.0
+ '@azure/keyvault-secrets': ^4.10.0
+ '@azure/storage-blob': ^12.31.0
+ '@capacitor/preferences': ^6 || ^7 || ^8
+ '@deno/kv': '>=0.13.0'
+ '@netlify/blobs': ^6.5.0 || ^7.0.0 || ^8.1.0 || ^9.0.0 || ^10.0.0
+ '@planetscale/database': ^1.19.0
+ '@upstash/redis': ^1.36.2
+ '@vercel/blob': '>=0.27.3'
+ '@vercel/functions': ^2.2.12 || ^3.0.0
+ '@vercel/kv': ^1.0.1
+ aws4fetch: ^1.0.20
+ chokidar: ^4 || ^5
+ db0: '>=0.3.4'
+ idb-keyval: ^6.2.2
+ ioredis: ^5.9.3
+ lru-cache: ^11.2.6
+ mongodb: ^6 || ^7
+ ofetch: '*'
+ uploadthing: ^7.7.4
+ peerDependenciesMeta:
+ '@azure/app-configuration':
+ optional: true
+ '@azure/cosmos':
+ optional: true
+ '@azure/data-tables':
+ optional: true
+ '@azure/identity':
+ optional: true
+ '@azure/keyvault-secrets':
+ optional: true
+ '@azure/storage-blob':
+ optional: true
+ '@capacitor/preferences':
+ optional: true
+ '@deno/kv':
+ optional: true
+ '@netlify/blobs':
+ optional: true
+ '@planetscale/database':
+ optional: true
+ '@upstash/redis':
+ optional: true
+ '@vercel/blob':
+ optional: true
+ '@vercel/functions':
+ optional: true
+ '@vercel/kv':
+ optional: true
+ aws4fetch:
+ optional: true
+ chokidar:
+ optional: true
+ db0:
+ optional: true
+ idb-keyval:
+ optional: true
+ ioredis:
+ optional: true
+ lru-cache:
+ optional: true
+ mongodb:
+ optional: true
+ ofetch:
+ optional: true
+ uploadthing:
+ optional: true
+
+ untun@0.1.3:
+ resolution: {integrity: sha512-4luGP9LMYszMRZwsvyUd9MrxgEGZdZuZgpVQHEEX0lCYFESasVRvZd0EYpCkOIbJKHMuv0LskpXc/8Un+MJzEQ==}
+ hasBin: true
+
+ untyped@2.0.0:
+ resolution: {integrity: sha512-nwNCjxJTjNuLCgFr42fEak5OcLuB3ecca+9ksPFNvtfYSLpjf+iJqSIaSnIile6ZPbKYxI5k2AfXqeopGudK/g==}
+ hasBin: true
+
+ unwasm@0.5.3:
+ resolution: {integrity: sha512-keBgTSfp3r6+s9ZcSma+0chwxQdmLbB5+dAD9vjtB21UTMYuKAxHXCU1K2CbCtnP09EaWeRvACnXk0EJtUx+hw==}
+
+ update-browserslist-db@1.2.3:
+ resolution: {integrity: sha512-Js0m9cx+qOgDxo0eMiFGEueWztz+d4+M3rGlmKPT+T4IS/jP4ylw3Nwpu6cpTTP8R1MAC1kF4VbdLt3ARf209w==}
+ hasBin: true
+ peerDependencies:
+ browserslist: '>= 4.21.0'
+
+ uqr@0.1.3:
+ resolution: {integrity: sha512-0rjE8iEJe4YmT9TOhwsZtqCMRLc5DXZUI2UEYUUg63ikBkqqE5EYWaI0etFe/5KUcmcYwLih2RND1kq+hrUJXA==}
+
+ uri-js@4.4.1:
+ resolution: {integrity: sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==}
+
+ url-loader@4.1.1:
+ resolution: {integrity: sha512-3BTV812+AVHHOJQO8O5MkWgZ5aosP7GnROJwvzLS9hWDj00lZ6Z0wNak423Lp9PBZN05N+Jk/N5Si8jRAlGyWA==}
+ engines: {node: '>= 10.13.0'}
+ peerDependencies:
+ file-loader: '*'
+ webpack: ^4.0.0 || ^5.0.0
+ peerDependenciesMeta:
+ file-loader:
+ optional: true
+
+ util-deprecate@1.0.2:
+ resolution: {integrity: sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==}
+
+ valibot@1.4.0:
+ resolution: {integrity: sha512-iC/x7fVcSyOwlm/VSt7RlHnzNGLGvR9GnxdifUeWoCJo0q4ZZvrVkIHC6faTlkxG47I2Y4UrFquPuVHCrOnrLg==}
+ peerDependencies:
+ typescript: '>=5'
+ peerDependenciesMeta:
+ typescript:
+ optional: true
+
+ validate-npm-package-license@3.0.4:
+ resolution: {integrity: sha512-DpKm2Ui/xN7/HQKCtpZxoRWBhZ9Z0kqtygG8XCgNQ8ZlDnxuQmWhj566j8fN4Cu3/JmbhsDo7fcAJq4s9h27Ew==}
+
+ validate-npm-package-name@5.0.1:
+ resolution: {integrity: sha512-OljLrQ9SQdOUqTaQxqL5dEfZWrXExyyWsozYlAWFawPVNuD83igl7uJD2RTkNMbniIYgt8l81eCJGIdQF7avLQ==}
+ engines: {node: ^14.17.0 || ^16.13.0 || >=18.0.0}
+
+ version-guard@1.1.3:
+ resolution: {integrity: sha512-JwPr6erhX53EWH/HCSzfy1tTFrtPXUe927wdM1jqBBeYp1OM+qPHjWbsvv6pIBduqdgxxS+ScfG7S28pzyr2DQ==}
+ engines: {node: '>=0.10.48'}
+
+ vfile-location@5.0.3:
+ resolution: {integrity: sha512-5yXvWDEgqeiYiBe1lbxYF7UMAIm/IcopxMHrMQDq3nvKcjPKIhZklUKL+AE7J7uApI4kwe2snsK+eI6UTj9EHg==}
+
+ vfile-message@4.0.3:
+ resolution: {integrity: sha512-QTHzsGd1EhbZs4AsQ20JX1rC3cOlt/IWJruk893DfLRr57lcnOeMaWG4K0JrRta4mIJZKth2Au3mM3u03/JWKw==}
+
+ vfile@6.0.3:
+ resolution: {integrity: sha512-KzIbH/9tXat2u30jf+smMwFCsno4wHVdNmzFyL+T/L3UGqqk6JKfVqOFOZEpZSHADH1k40ab6NUIXZq422ov3Q==}
+
+ vite-node@6.0.0:
+ resolution: {integrity: sha512-oj4PVrT+pDh6GYf5wfUXkcZyekYS8kKPfLPXVl8qe324Ec6l4K2DUKNadRbZ3LQl0qGcDz+PyOo7ZAh00Y+JjQ==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ hasBin: true
+
+ vite-plugin-checker@0.13.0:
+ resolution: {integrity: sha512-14EkOZmfinVZNxRmg2uCNDwtqGc/33lU/UEJansHgu27+ad+r6mMBf1Xtnq57jGZWiO/xzwtiEKPYsganw7ZFQ==}
+ engines: {node: '>=16.11'}
+ peerDependencies:
+ '@biomejs/biome': '>=1.7'
+ eslint: '>=9.39.4'
+ meow: ^13.2.0 || ^14.0.0
+ optionator: ^0.9.4
+ oxlint: '>=1'
+ stylelint: '>=16.26.1'
+ typescript: '*'
+ vite: 8.0.12
+ vls: '*'
+ vti: '*'
+ vue-tsc: ~2.2.10 || ^3.0.0
+ peerDependenciesMeta:
+ '@biomejs/biome':
+ optional: true
+ eslint:
+ optional: true
+ meow:
+ optional: true
+ optionator:
+ optional: true
+ oxlint:
+ optional: true
+ stylelint:
+ optional: true
+ typescript:
+ optional: true
+ vls:
+ optional: true
+ vti:
+ optional: true
+ vue-tsc:
+ optional: true
+
+ vite-plugin-inspect@12.0.0-beta.2:
+ resolution: {integrity: sha512-hm7mzZJRKNWYqs3ms3Py2tHSueoNPw/iiSGOAD5mX+lCF/HIQPmKI6hzQ1Vs6m5bB7pctogYhhtIstsYongr9g==}
+ engines: {node: '>=14'}
+ peerDependencies:
+ '@nuxt/kit': '*'
+ vite: 8.0.12
+ peerDependenciesMeta:
+ '@nuxt/kit':
+ optional: true
+
+ vite-plugin-vue-tracer@1.4.0:
+ resolution: {integrity: sha512-0tQCjCqZWVSK6UeRW9S4ABbf47lKQ68zvrT2FNvZmiL+alDydCVyH/T3Jlfbdc3T3C2Iuyyl5aVsMbF8IQIoxA==}
+ peerDependencies:
+ vite: 8.0.12
+ vue: 3.5.34
+
+ vite@8.0.12:
+ resolution: {integrity: sha512-w2dDofOWv2QB09ZITZBsvKTVAlYvPR4IAmrY/v0ir9KvLs0xybR7i48wxhM1/oyBWO34wPns+bPGw5ZrZqDpZg==}
+ engines: {node: ^20.19.0 || >=22.12.0}
+ hasBin: true
+ peerDependencies:
+ '@types/node': ^20.19.0 || >=22.12.0
+ '@vitejs/devtools': ^0.1.18
+ esbuild: ^0.27.0 || ^0.28.0
+ jiti: '>=1.21.0'
+ less: ^4.0.0
+ sass: ^1.70.0
+ sass-embedded: ^1.70.0
+ stylus: '>=0.54.8'
+ sugarss: ^5.0.0
+ terser: ^5.16.0
+ tsx: ^4.8.1
+ yaml: ^2.4.2
+ peerDependenciesMeta:
+ '@types/node':
+ optional: true
+ '@vitejs/devtools':
+ optional: true
+ esbuild:
+ optional: true
+ jiti:
+ optional: true
+ less:
+ optional: true
+ sass:
+ optional: true
+ sass-embedded:
+ optional: true
+ stylus:
+ optional: true
+ sugarss:
+ optional: true
+ terser:
+ optional: true
+ tsx:
+ optional: true
+ yaml:
+ optional: true
+
+ vitest-environment-nuxt@2.0.0:
+ resolution: {integrity: sha512-zEGFRiCAaRR3fHnqISHKMNTRvCzkQEI1XyFeqNgR2IBD0oYkfZ1rUHwi7C+h3Cns3KPykfB0av1B3MtLEbChDw==}
+
+ vitest@4.1.6:
+ resolution: {integrity: sha512-6lvjbS3p9b4CrdCmguzbh2/4uoXhGE2q71R4OX5sqF9R1bo9Xd6fGrMAfvp5wnCzlBnFVdCOp6onuTQVbo8iUQ==}
+ engines: {node: ^20.0.0 || ^22.0.0 || >=24.0.0}
+ hasBin: true
+ peerDependencies:
+ '@edge-runtime/vm': '*'
+ '@opentelemetry/api': ^1.9.0
+ '@types/node': ^20.0.0 || ^22.0.0 || >=24.0.0
+ '@vitest/browser-playwright': 4.1.6
+ '@vitest/browser-preview': 4.1.6
+ '@vitest/browser-webdriverio': 4.1.6
+ '@vitest/coverage-istanbul': 4.1.6
+ '@vitest/coverage-v8': 4.1.6
+ '@vitest/ui': 4.1.6
+ happy-dom: '*'
+ jsdom: '*'
+ vite: 8.0.12
+ peerDependenciesMeta:
+ '@edge-runtime/vm':
+ optional: true
+ '@opentelemetry/api':
+ optional: true
+ '@types/node':
+ optional: true
+ '@vitest/browser-playwright':
+ optional: true
+ '@vitest/browser-preview':
+ optional: true
+ '@vitest/browser-webdriverio':
+ optional: true
+ '@vitest/coverage-istanbul':
+ optional: true
+ '@vitest/coverage-v8':
+ optional: true
+ '@vitest/ui':
+ optional: true
+ happy-dom:
+ optional: true
+ jsdom:
+ optional: true
+
+ vitest@4.1.7:
+ resolution: {integrity: sha512-flYyaFd2CgoCoU+0UKt3pxksgC+S02iTDN0n3LtqaMeXsI9SBcdNujc2k0DeFLzUn/0k538yNjOSdwgCqcrwJA==}
+ engines: {node: ^20.0.0 || ^22.0.0 || >=24.0.0}
+ hasBin: true
+ peerDependencies:
+ '@edge-runtime/vm': '*'
+ '@opentelemetry/api': ^1.9.0
+ '@types/node': ^20.0.0 || ^22.0.0 || >=24.0.0
+ '@vitest/browser-playwright': 4.1.7
+ '@vitest/browser-preview': 4.1.7
+ '@vitest/browser-webdriverio': 4.1.7
+ '@vitest/coverage-istanbul': 4.1.7
+ '@vitest/coverage-v8': 4.1.7
+ '@vitest/ui': 4.1.7
+ happy-dom: '*'
+ jsdom: '*'
+ vite: 8.0.12
+ peerDependenciesMeta:
+ '@edge-runtime/vm':
+ optional: true
+ '@opentelemetry/api':
+ optional: true
+ '@types/node':
+ optional: true
+ '@vitest/browser-playwright':
+ optional: true
+ '@vitest/browser-preview':
+ optional: true
+ '@vitest/browser-webdriverio':
+ optional: true
+ '@vitest/coverage-istanbul':
+ optional: true
+ '@vitest/coverage-v8':
+ optional: true
+ '@vitest/ui':
+ optional: true
+ happy-dom:
+ optional: true
+ jsdom:
+ optional: true
+
+ void-elements@3.1.0:
+ resolution: {integrity: sha512-Dhxzh5HZuiHQhbvTW9AMetFfBHDMYpo23Uo9btPXgdYP+3T5S+p+jgNy7spra+veYhBP2dCSgxR/i2Y02h5/6w==}
+ engines: {node: '>=0.10.0'}
+
+ vscode-uri@3.1.0:
+ resolution: {integrity: sha512-/BpdSx+yCQGnCvecbyXdxHDkuk55/G3xwnC0GqY4gmQ3j+A+g8kzzgB4Nk/SINjqn6+waqw3EgbVF2QKExkRxQ==}
+
+ vue-bundle-renderer@2.2.0:
+ resolution: {integrity: sha512-sz/0WEdYH1KfaOm0XaBmRZOWgYTEvUDt6yPYaUzl4E52qzgWLlknaPPTTZmp6benaPTlQAI/hN1x3tAzZygycg==}
+
+ vue-component-type-helpers@3.3.1:
+ resolution: {integrity: sha512-pu58kqxmVyEH6VfNYW1UyEfR3XAnJ27ZXT3yzXxxpjLxVzAbyC35Zk/nm/RMs7ijWnJNSd9fWkeex2OhUsx3MA==}
+
+ vue-devtools-stub@0.1.0:
+ resolution: {integrity: sha512-RutnB7X8c5hjq39NceArgXg28WZtZpGc3+J16ljMiYnFhKvd8hITxSWQSQ5bvldxMDU6gG5mkxl1MTQLXckVSQ==}
+
+ vue-eslint-parser@10.4.0:
+ resolution: {integrity: sha512-Vxi9pJdbN3ZnVGLODVtZ7y4Y2kzAAE2Cm0CZ3ZDRvydVYxZ6VrnBhLikBsRS+dpwj4Jv4UCv21PTEwF5rQ9WXg==}
+ engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+ peerDependencies:
+ eslint: ^8.57.0 || ^9.0.0 || ^10.0.0
+
+ vue-loader@17.4.2:
+ resolution: {integrity: sha512-yTKOA4R/VN4jqjw4y5HrynFL8AK0Z3/Jt7eOJXEitsm0GMRHDBjCfCiuTiLP7OESvsZYo2pATCWhDqxC5ZrM6w==}
+ peerDependencies:
+ '@vue/compiler-sfc': '*'
+ vue: '*'
+ webpack: ^4.1.0 || ^5.0.0-0
+ peerDependenciesMeta:
+ '@vue/compiler-sfc':
+ optional: true
+ vue:
+ optional: true
+
+ vue-resize@2.0.0-alpha.1:
+ resolution: {integrity: sha512-7+iqOueLU7uc9NrMfrzbG8hwMqchfVfSzpVlCMeJQe4pyibqyoifDNbKTZvwxZKDvGkB+PdFeKvnGZMoEb8esg==}
+ peerDependencies:
+ vue: 3.5.34
+
+ vue-router@5.0.7:
+ resolution: {integrity: sha512-dqfk8kvRbCutmCOCj/XLDqDEYxc1wBdAOGLuVy5M93ifYMsBd5fIjfaPN4tQAbxr5IprdBDIox1gr4wYyOx/SA==}
+ peerDependencies:
+ '@pinia/colada': '>=0.21.2'
+ '@vue/compiler-sfc': ^3.5.34
+ pinia: ^3.0.4
+ vue: 3.5.34
+ peerDependenciesMeta:
+ '@pinia/colada':
+ optional: true
+ '@vue/compiler-sfc':
+ optional: true
+ pinia:
+ optional: true
+
+ vue-sfc-transformer@0.1.17:
+ resolution: {integrity: sha512-0mpkDTWm1ybtp/Mp3vhrXP4r8yxcGF+quxGyJfrHDl2tl5naQjK3xkIGaVR5BtR5KG1LWJbdCrqn7I6f460j9A==}
+ engines: {node: '>=18.0.0'}
+ peerDependencies:
+ '@vue/compiler-core': ^3.5.13
+ esbuild: '*'
+ vue: 3.5.34
+
+ vue-tsc@3.2.9:
+ resolution: {integrity: sha512-qm8/nbo+9eZc1SCndm9wT+gq23pM+wRIdHY0wjm83B3lIginHTwcdrLUyTrKjDWXbMVNjKegNrnymhpdqnCL3A==}
+ hasBin: true
+ peerDependencies:
+ typescript: '>=5.0.0'
+
+ vue-virtual-scroller@3.0.4:
+ resolution: {integrity: sha512-3qh3c9VUVysuXynaa4fVZ3ncx3VgD7EPRiQcj+jUVZl5u/TTkD3c27XvSEu3JGJfsJt/vVTVziZ3djiiHtW4cQ==}
+ peerDependencies:
+ vue: 3.5.34
+
+ vue@3.5.34:
+ resolution: {integrity: sha512-WdLBG9gm02OgJIG9axd5Hpx0TFLdzVgfG2evFFu8Rur5O/IoGc5cMjnjh3tPL6GnRGsYvUhBSKVPYVcxRKpMCA==}
+ peerDependencies:
+ typescript: '*'
+ peerDependenciesMeta:
+ typescript:
+ optional: true
+
+ walk-up-path@4.0.0:
+ resolution: {integrity: sha512-3hu+tD8YzSLGuFYtPRb48vdhKMi0KQV5sn+uWr8+7dMEq/2G/dtLrdDinkLjqq5TIbIBjYJ4Ax/n3YiaW7QM8A==}
+ engines: {node: 20 || >=22}
+
+ watchpack@2.5.1:
+ resolution: {integrity: sha512-Zn5uXdcFNIA1+1Ei5McRd+iRzfhENPCe7LeABkJtNulSxjma+l7ltNx55BWZkRlwRnpOgHqxnjyaDgJnNXnqzg==}
+ engines: {node: '>=10.13.0'}
+
+ web-namespaces@2.0.1:
+ resolution: {integrity: sha512-bKr1DkiNa2krS7qxNtdrtHAmzuYGFQLiQ13TsorsdT6ULTkPLKuu5+GsFpDlg6JFjUTwX2DyhMPG2be8uPrqsQ==}
+
+ webidl-conversions@3.0.1:
+ resolution: {integrity: sha512-2JAn3z8AR6rjK8Sm8orRC0h/bcl/DqL7tRPdGZ4I1CjdF+EaMLmYxBHyXuKL849eucPFhvBoxMsflfOb8kxaeQ==}
+
+ webpack-bundle-analyzer@5.3.0:
+ resolution: {integrity: sha512-PEhAoqiJ+47d0uLMx/+zo5XOvaU+Vk6N2ZLht7H3n09QLy/fhyvqGNwjdRUHJDgMN8crBR2ZwVHkIswT3Xuawg==}
+ engines: {node: '>= 20.9.0'}
+ hasBin: true
+
+ webpack-dev-middleware@8.0.3:
+ resolution: {integrity: sha512-zWrde9VZDiRaFuWsjHO40wm9LxxtXEk8DdzFXdU7eU5ZpiANnZZDBbZgN3guxbEoKqUHd9YupBmynyioz42nkA==}
+ engines: {node: '>= 20.9.0'}
+ peerDependencies:
+ webpack: ^5.101.0
+ peerDependenciesMeta:
+ webpack:
+ optional: true
+
+ webpack-hot-middleware@2.26.1:
+ resolution: {integrity: sha512-khZGfAeJx6I8K9zKohEWWYN6KDlVw2DHownoe+6Vtwj1LP9WFgegXnVMSkZ/dBEBtXFwrkkydsaPFlB7f8wU2A==}
+
+ webpack-sources@3.5.0:
+ resolution: {integrity: sha512-HPuy+uuoTCaaoEoI1LQ3JN9+vrPBvEesnnX1jADHy728cHSMlq4wUc4afYqahq2B1mhQVZxCXOkNTnXltr+2vQ==}
+ engines: {node: '>=10.13.0'}
+
+ webpack-virtual-modules@0.6.2:
+ resolution: {integrity: sha512-66/V2i5hQanC51vBQKPH4aI8NMAcBW59FVBs+rC7eGHupMyfn34q7rZIE+ETlJ+XTevqfUhVVBgSUNSW2flEUQ==}
+
+ webpack@5.106.2:
+ resolution: {integrity: sha512-wGN3qcrBQIFmQ/c0AiOAQBvrZ5lmY8vbbMv4Mxfgzqd/B6+9pXtLo73WuS1dSGXM5QYY3hZnIbvx+K1xxe6FyA==}
+ engines: {node: '>=10.13.0'}
+ hasBin: true
+ peerDependencies:
+ webpack-cli: '*'
+ peerDependenciesMeta:
+ webpack-cli:
+ optional: true
+
+ webpackbar@7.0.0:
+ resolution: {integrity: sha512-aS9soqSO2iCHgqHoCrj4LbfGQUboDCYJPSFOAchEK+9psIjNrfSWW4Y0YEz67MKURNvMmfo0ycOg9d/+OOf9/Q==}
+ engines: {node: '>=14.21.3'}
+ peerDependencies:
+ '@rspack/core': '*'
+ webpack: 3 || 4 || 5
+ peerDependenciesMeta:
+ '@rspack/core':
+ optional: true
+ webpack:
+ optional: true
+
+ whatwg-mimetype@3.0.0:
+ resolution: {integrity: sha512-nt+N2dzIutVRxARx1nghPKGv1xHikU7HKdfafKkLNLindmPU/ch3U31NOCGGA/dmPcmb1VlofO0vnKAcsm0o/Q==}
+ engines: {node: '>=12'}
+
+ whatwg-url@5.0.0:
+ resolution: {integrity: sha512-saE57nupxk6v3HY35+jzBwYa0rKSy0XR8JSxZPwgLr7ys0IBzhGviA1/TUGJLmSVqs8pb9AnvICXEuOHLprYTw==}
+
+ which-boxed-primitive@1.1.1:
+ resolution: {integrity: sha512-TbX3mj8n0odCBFVlY8AxkqcHASw3L60jIuF8jFP78az3C2YhmGvqbHBpAjTRH2/xqYunrJ9g1jSyjCjpoWzIAA==}
+ engines: {node: '>= 0.4'}
+
+ which-collection@1.0.2:
+ resolution: {integrity: sha512-K4jVyjnBdgvc86Y6BkaLZEN933SwYOuBFkdmBu9ZfkcAbdVbpITnDmjvZ/aQjRXQrv5EPkTnD1s39GiiqbngCw==}
+ engines: {node: '>= 0.4'}
+
+ which-typed-array@1.1.20:
+ resolution: {integrity: sha512-LYfpUkmqwl0h9A2HL09Mms427Q1RZWuOHsukfVcKRq9q95iQxdw0ix1JQrqbcDR9PH1QDwf5Qo8OZb5lksZ8Xg==}
+ engines: {node: '>= 0.4'}
+
+ which@2.0.2:
+ resolution: {integrity: sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==}
+ engines: {node: '>= 8'}
+ hasBin: true
+
+ which@6.0.1:
+ resolution: {integrity: sha512-oGLe46MIrCRqX7ytPUf66EAYvdeMIZYn3WaocqqKZAxrBpkqHfL/qvTyJ/bTk5+AqHCjXmrv3CEWgy368zhRUg==}
+ engines: {node: ^20.17.0 || >=22.9.0}
+ hasBin: true
+
+ why-is-node-running@2.3.0:
+ resolution: {integrity: sha512-hUrmaWBdVDcxvYqnyh09zunKzROWjbZTiNy8dBEjkS7ehEDQibXJ7XvlmtbwuTclUiIyN+CyXQD4Vmko8fNm8w==}
+ engines: {node: '>=8'}
+ hasBin: true
+
+ with@7.0.2:
+ resolution: {integrity: sha512-RNGKj82nUPg3g5ygxkQl0R937xLyho1J24ItRCBTr/m1YnZkzJy1hUiHUJrc/VlsDQzsCnInEGSg3bci0Lmd4w==}
+ engines: {node: '>= 10.0.0'}
+
+ word-wrap@1.2.5:
+ resolution: {integrity: sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA==}
+ engines: {node: '>=0.10.0'}
+
+ wrap-ansi@7.0.0:
+ resolution: {integrity: sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==}
+ engines: {node: '>=10'}
+
+ wrap-ansi@8.1.0:
+ resolution: {integrity: sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ==}
+ engines: {node: '>=12'}
+
+ wrap-ansi@9.0.2:
+ resolution: {integrity: sha512-42AtmgqjV+X1VpdOfyTGOYRi0/zsoLqtXQckTmqTeybT+BDIbM/Guxo7x3pE2vtpr1ok6xRqM9OpBe+Jyoqyww==}
+ engines: {node: '>=18'}
+
+ write-file-atomic@5.0.1:
+ resolution: {integrity: sha512-+QU2zd6OTD8XWIJCbffaiQeH9U73qIqafo1x6V1snCWYGJf6cVE0cDR4D8xRzcEnfI21IFrUPzPGtcPf8AC+Rw==}
+ engines: {node: ^14.17.0 || ^16.13.0 || >=18.0.0}
+
+ write-yaml-file@5.0.0:
+ resolution: {integrity: sha512-FdNA4RyH1L43TlvGG8qOMIfcEczwA5ij+zLXUy3Z83CjxhLvcV7/Q/8pk22wnCgYw7PJhtK+7lhO+qqyT4NdvQ==}
+ engines: {node: '>=16.14'}
+
+ ws@8.21.0:
+ resolution: {integrity: sha512-Vsp28b7DRcimFQvrqu2Wek3z1iYxDCWqHYB8Qsnk/S4RfaCQzPGPyBNuVjJV3cd6UiKtUtp6sNM77gWvzcCH+g==}
+ engines: {node: '>=10.0.0'}
+ peerDependencies:
+ bufferutil: ^4.0.1
+ utf-8-validate: '>=5.0.2'
+ peerDependenciesMeta:
+ bufferutil:
+ optional: true
+ utf-8-validate:
+ optional: true
+
+ wsl-utils@0.1.0:
+ resolution: {integrity: sha512-h3Fbisa2nKGPxCpm89Hk33lBLsnaGBvctQopaBSOW/uIs6FTe1ATyAnKFJrzVs9vpGdsTe73WF3V4lIsk4Gacw==}
+ engines: {node: '>=18'}
+
+ wsl-utils@0.3.1:
+ resolution: {integrity: sha512-g/eziiSUNBSsdDJtCLB8bdYEUMj4jR7AGeUo96p/3dTafgjHhpF4RiCFPiRILwjQoDXx5MqkBr4fwWtR3Ky4Wg==}
+ engines: {node: '>=20'}
+
+ xml-name-validator@4.0.0:
+ resolution: {integrity: sha512-ICP2e+jsHvAj2E2lIHxa5tjXRlKDJo4IdvPvCXbXQGdzSfmSpNVyIKMvoZHjDY9DP0zV17iI85o90vRFXNccRw==}
+ engines: {node: '>=12'}
+
+ xxhashjs@0.2.2:
+ resolution: {integrity: sha512-AkTuIuVTET12tpsVIQo+ZU6f/qDmKuRUcjaqR+OIvm+aCBsZ95i7UVY5WJ9TMsSaZ0DA2WxoZ4acu0sPH+OKAw==}
+
+ y18n@5.0.8:
+ resolution: {integrity: sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==}
+ engines: {node: '>=10'}
+
+ yallist@3.1.1:
+ resolution: {integrity: sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g==}
+
+ yallist@5.0.0:
+ resolution: {integrity: sha512-YgvUTfwqyc7UXVMrB+SImsVYSmTS8X/tSrtdNZMImM+n7+QTriRXyXim0mBrTXNeqzVF0KWGgHPeiyViFFrNDw==}
+ engines: {node: '>=18'}
+
+ yaml@2.9.0:
+ resolution: {integrity: sha512-2AvhNX3mb8zd6Zy7INTtSpl1F15HW6Wnqj0srWlkKLcpYl/gMIMJiyuGq2KeI2YFxUPjdlB+3Lc10seMLtL4cA==}
+ engines: {node: '>= 14.6'}
+ hasBin: true
+
+ yargs-parser@20.2.9:
+ resolution: {integrity: sha512-y11nGElTIV+CT3Zv9t7VKl+Q3hTQoT9a1Qzezhhl6Rp21gJ/IVTW7Z3y9EWXhuUBC2Shnf+DX0antecpAwSP8w==}
+ engines: {node: '>=10'}
+
+ yargs-parser@22.0.0:
+ resolution: {integrity: sha512-rwu/ClNdSMpkSrUb+d6BRsSkLUq1fmfsY6TOpYzTwvwkg1/NRG85KBy3kq++A8LKQwX6lsu+aWad+2khvuXrqw==}
+ engines: {node: ^20.19.0 || ^22.12.0 || >=23}
+
+ yargs@16.2.0:
+ resolution: {integrity: sha512-D1mvvtDG0L5ft/jGWkLpG1+m0eQxOfaBvTNELraWj22wSVUMWxZUvYgJYcKh6jGGIkJFhH4IZPQhR4TKpc8mBw==}
+ engines: {node: '>=10'}
+
+ yargs@18.0.0:
+ resolution: {integrity: sha512-4UEqdc2RYGHZc7Doyqkrqiln3p9X2DZVxaGbwhn2pi7MrRagKaOcIKe8L3OxYcbhXLgLFUS3zAYuQjKBQgmuNg==}
+ engines: {node: ^20.19.0 || ^22.12.0 || >=23}
+
+ yocto-queue@0.1.0:
+ resolution: {integrity: sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==}
+ engines: {node: '>=10'}
+
+ yocto-queue@1.2.2:
+ resolution: {integrity: sha512-4LCcse/U2MHZ63HAJVE+v71o7yOdIe4cZ70Wpf8D/IyjDKYQLV5GD46B+hSTjJsvV5PztjvHoU580EftxjDZFQ==}
+ engines: {node: '>=12.20'}
+
+ youch-core@0.3.3:
+ resolution: {integrity: sha512-ho7XuGjLaJ2hWHoK8yFnsUGy2Y5uDpqSTq1FkHLK4/oqKtyUU1AFbOOxY4IpC9f0fTLjwYbslUz0Po5BpD1wrA==}
+
+ youch@4.1.1:
+ resolution: {integrity: sha512-mxW3qiSnl+GRxXsaUMzv2Mbada1Y8CDltET9UxejDQe6DBYlSekghl5U5K0ReAikcHDi0G1vKZEmmo/NWAGKLA==}
+
+ zip-stream@6.0.1:
+ resolution: {integrity: sha512-zK7YHHz4ZXpW89AHXUPbQVGKI7uvkd3hzusTdotCg1UxyaVtg0zFJSTfW/Dq5f7OBBVnq6cZIaC8Ti4hb6dtCA==}
+ engines: {node: '>= 14'}
+
+ zod@4.4.3:
+ resolution: {integrity: sha512-ytENFjIJFl2UwYglde2jchW2Hwm4GJFLDiSXWdTrJQBIN9Fcyp7n4DhxJEiWNAJMV1/BqWfW/kkg71UDcHJyTQ==}
+
+ zwitch@2.0.4:
+ resolution: {integrity: sha512-bXE4cR/kVZhKZX/RjPEflHaKVhUVl85noU3v6b8apfQEc1x4A+zBxjZ4lN8LqGd6WZ3dl98pY4o717VFmoPp+A==}
+
+snapshots:
+
+ '@andrewbranch/untar.js@1.0.3': {}
+
+ '@antfu/install-pkg@1.1.0':
+ dependencies:
+ package-manager-detector: 1.6.0
+ tinyexec: 1.1.2
+
+ '@apidevtools/json-schema-ref-parser@14.2.1(@types/json-schema@7.0.15)':
+ dependencies:
+ '@types/json-schema': 7.0.15
+ js-yaml: 4.1.1
+
+ '@arethetypeswrong/cli@0.18.2':
+ dependencies:
+ '@arethetypeswrong/core': 0.18.2
+ chalk: 4.1.2
+ cli-table3: 0.6.5
+ commander: 10.0.1
+ marked: 9.1.6
+ marked-terminal: 7.3.0(marked@9.1.6)
+ semver: 7.8.0
+
+ '@arethetypeswrong/core@0.18.2':
+ dependencies:
+ '@andrewbranch/untar.js': 1.0.3
+ '@loaderkit/resolve': 1.0.6
+ cjs-module-lexer: 1.4.3
+ fflate: 0.8.3
+ lru-cache: 11.5.0
+ semver: 7.8.0
+ typescript: 5.6.1-rc
+ validate-npm-package-name: 5.0.1
+
+ '@babel/code-frame@7.29.0':
+ dependencies:
+ '@babel/helper-validator-identifier': 7.28.5
+ js-tokens: 4.0.0
+ picocolors: 1.1.1
+
+ '@babel/compat-data@7.29.3': {}
+
+ '@babel/core@7.29.0':
+ dependencies:
+ '@babel/code-frame': 7.29.0
+ '@babel/generator': 7.29.1
+ '@babel/helper-compilation-targets': 7.28.6
+ '@babel/helper-module-transforms': 7.28.6(@babel/core@7.29.0)
+ '@babel/helpers': 7.29.2
+ '@babel/parser': 7.29.3
+ '@babel/template': 7.28.6
+ '@babel/traverse': 7.29.0
+ '@babel/types': 7.29.0
+ '@jridgewell/remapping': 2.3.5
+ convert-source-map: 2.0.0
+ debug: 4.4.3
+ gensync: 1.0.0-beta.2
+ json5: 2.2.3
+ semver: 6.3.1
+ transitivePeerDependencies:
+ - supports-color
+
+ '@babel/generator@7.29.1':
+ dependencies:
+ '@babel/parser': 7.29.3
+ '@babel/types': 7.29.0
+ '@jridgewell/gen-mapping': 0.3.13
+ '@jridgewell/trace-mapping': 0.3.31
+ jsesc: 3.1.0
+
+ '@babel/generator@8.0.0-rc.5':
+ dependencies:
+ '@babel/parser': 8.0.0-rc.5
+ '@babel/types': 8.0.0-rc.5
+ '@jridgewell/gen-mapping': 0.3.13
+ '@jridgewell/trace-mapping': 0.3.31
+ '@types/jsesc': 2.5.1
+ jsesc: 3.1.0
+
+ '@babel/helper-annotate-as-pure@7.27.3':
+ dependencies:
+ '@babel/types': 7.29.0
+
+ '@babel/helper-compilation-targets@7.28.6':
+ dependencies:
+ '@babel/compat-data': 7.29.3
+ '@babel/helper-validator-option': 7.27.1
+ browserslist: 4.28.2
+ lru-cache: 5.1.1
+ semver: 6.3.1
+
+ '@babel/helper-create-class-features-plugin@7.29.3(@babel/core@7.29.0)':
+ dependencies:
+ '@babel/core': 7.29.0
+ '@babel/helper-annotate-as-pure': 7.27.3
+ '@babel/helper-member-expression-to-functions': 7.28.5
+ '@babel/helper-optimise-call-expression': 7.27.1
+ '@babel/helper-replace-supers': 7.28.6(@babel/core@7.29.0)
+ '@babel/helper-skip-transparent-expression-wrappers': 7.27.1
+ '@babel/traverse': 7.29.0
+ semver: 6.3.1
+ transitivePeerDependencies:
+ - supports-color
+
+ '@babel/helper-globals@7.28.0': {}
+
+ '@babel/helper-member-expression-to-functions@7.28.5':
+ dependencies:
+ '@babel/traverse': 7.29.0
+ '@babel/types': 7.29.0
+ transitivePeerDependencies:
+ - supports-color
+
+ '@babel/helper-module-imports@7.28.6':
+ dependencies:
+ '@babel/traverse': 7.29.0
+ '@babel/types': 7.29.0
+ transitivePeerDependencies:
+ - supports-color
+
+ '@babel/helper-module-transforms@7.28.6(@babel/core@7.29.0)':
+ dependencies:
+ '@babel/core': 7.29.0
+ '@babel/helper-module-imports': 7.28.6
+ '@babel/helper-validator-identifier': 7.28.5
+ '@babel/traverse': 7.29.0
+ transitivePeerDependencies:
+ - supports-color
+
+ '@babel/helper-optimise-call-expression@7.27.1':
+ dependencies:
+ '@babel/types': 7.29.0
+
+ '@babel/helper-plugin-utils@7.28.6': {}
+
+ '@babel/helper-replace-supers@7.28.6(@babel/core@7.29.0)':
+ dependencies:
+ '@babel/core': 7.29.0
+ '@babel/helper-member-expression-to-functions': 7.28.5
+ '@babel/helper-optimise-call-expression': 7.27.1
+ '@babel/traverse': 7.29.0
+ transitivePeerDependencies:
+ - supports-color
+
+ '@babel/helper-skip-transparent-expression-wrappers@7.27.1':
+ dependencies:
+ '@babel/traverse': 7.29.0
+ '@babel/types': 7.29.0
+ transitivePeerDependencies:
+ - supports-color
+
+ '@babel/helper-string-parser@7.27.1': {}
+
+ '@babel/helper-string-parser@8.0.0-rc.5': {}
+
+ '@babel/helper-validator-identifier@7.28.5': {}
+
+ '@babel/helper-validator-identifier@8.0.0-rc.5': {}
+
+ '@babel/helper-validator-option@7.27.1': {}
+
+ '@babel/helpers@7.29.2':
+ dependencies:
+ '@babel/template': 7.28.6
+ '@babel/types': 7.29.0
+
+ '@babel/parser@7.29.3':
+ dependencies:
+ '@babel/types': 7.29.0
+
+ '@babel/parser@8.0.0-rc.4':
+ dependencies:
+ '@babel/types': 8.0.0-rc.5
+
+ '@babel/parser@8.0.0-rc.5':
+ dependencies:
+ '@babel/types': 8.0.0-rc.5
+
+ '@babel/plugin-proposal-decorators@7.29.0(@babel/core@7.29.0)':
+ dependencies:
+ '@babel/core': 7.29.0
+ '@babel/helper-create-class-features-plugin': 7.29.3(@babel/core@7.29.0)
+ '@babel/helper-plugin-utils': 7.28.6
+ '@babel/plugin-syntax-decorators': 7.28.6(@babel/core@7.29.0)
+ transitivePeerDependencies:
+ - supports-color
+
+ '@babel/plugin-syntax-decorators@7.28.6(@babel/core@7.29.0)':
+ dependencies:
+ '@babel/core': 7.29.0
+ '@babel/helper-plugin-utils': 7.28.6
+
+ '@babel/plugin-syntax-jsx@7.28.6(@babel/core@7.29.0)':
+ dependencies:
+ '@babel/core': 7.29.0
+ '@babel/helper-plugin-utils': 7.28.6
+
+ '@babel/plugin-syntax-typescript@7.28.6(@babel/core@7.29.0)':
+ dependencies:
+ '@babel/core': 7.29.0
+ '@babel/helper-plugin-utils': 7.28.6
+
+ '@babel/plugin-transform-typescript@7.28.6(@babel/core@7.29.0)':
+ dependencies:
+ '@babel/core': 7.29.0
+ '@babel/helper-annotate-as-pure': 7.27.3
+ '@babel/helper-create-class-features-plugin': 7.29.3(@babel/core@7.29.0)
+ '@babel/helper-plugin-utils': 7.28.6
+ '@babel/helper-skip-transparent-expression-wrappers': 7.27.1
+ '@babel/plugin-syntax-typescript': 7.28.6(@babel/core@7.29.0)
+ transitivePeerDependencies:
+ - supports-color
+
+ '@babel/runtime@7.29.2': {}
+
+ '@babel/template@7.28.6':
+ dependencies:
+ '@babel/code-frame': 7.29.0
+ '@babel/parser': 7.29.3
+ '@babel/types': 7.29.0
+
+ '@babel/traverse@7.29.0':
+ dependencies:
+ '@babel/code-frame': 7.29.0
+ '@babel/generator': 7.29.1
+ '@babel/helper-globals': 7.28.0
+ '@babel/parser': 7.29.3
+ '@babel/template': 7.28.6
+ '@babel/types': 7.29.0
+ debug: 4.4.3
+ transitivePeerDependencies:
+ - supports-color
+
+ '@babel/types@7.29.0':
+ dependencies:
+ '@babel/helper-string-parser': 7.27.1
+ '@babel/helper-validator-identifier': 7.28.5
+
+ '@babel/types@8.0.0-rc.5':
+ dependencies:
+ '@babel/helper-string-parser': 8.0.0-rc.5
+ '@babel/helper-validator-identifier': 8.0.0-rc.5
+
+ '@bcoe/v8-coverage@1.0.2': {}
+
+ '@bomb.sh/tab@0.0.15(citty@0.2.2)':
+ optionalDependencies:
+ citty: 0.2.2
+
+ '@braidai/lang@1.1.2': {}
+
+ '@clack/core@1.2.0':
+ dependencies:
+ fast-wrap-ansi: 0.1.6
+ sisteransi: 1.0.5
+
+ '@clack/core@1.3.1':
+ dependencies:
+ fast-wrap-ansi: 0.2.2
+ sisteransi: 1.0.5
+
+ '@clack/prompts@1.2.0':
+ dependencies:
+ '@clack/core': 1.2.0
+ fast-string-width: 1.1.0
+ fast-wrap-ansi: 0.1.6
+ sisteransi: 1.0.5
+
+ '@clack/prompts@1.4.0':
+ dependencies:
+ '@clack/core': 1.3.1
+ fast-string-width: 3.0.2
+ fast-wrap-ansi: 0.2.2
+ sisteransi: 1.0.5
+
+ '@cloudflare/kv-asset-handler@0.4.2': {}
+
+ '@codspeed/core@5.4.0':
+ dependencies:
+ axios: 1.16.1
+ find-up: 6.3.0
+ form-data: 4.0.5
+ node-gyp-build: 4.8.4
+ transitivePeerDependencies:
+ - debug
+ - supports-color
+
+ '@codspeed/vitest-plugin@5.4.0(tinybench@2.9.0)(vite@8.0.12)(vitest@4.1.7)':
+ dependencies:
+ '@codspeed/core': 5.4.0
+ tinybench: 2.9.0
+ vite: 8.0.12(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0)
+ vitest: 4.1.7(@types/node@24.12.4)(@vitest/coverage-v8@4.1.7)(happy-dom@20.9.0)(vite@8.0.12)
+ transitivePeerDependencies:
+ - debug
+ - supports-color
+
+ '@colordx/core@5.4.3': {}
+
+ '@colors/colors@1.5.0':
+ optional: true
+
+ '@discoveryjs/json-ext@0.6.3': {}
+
+ '@dxup/nuxt@0.4.1(typescript@6.0.3)':
+ dependencies:
+ '@dxup/unimport': 0.1.2
+ '@nuxt/kit': link:packages/kit
+ chokidar: 5.0.0
+ pathe: 2.0.3
+ tinyglobby: 0.2.16
+ optionalDependencies:
+ typescript: 6.0.3
+
+ '@dxup/unimport@0.1.2': {}
+
+ '@emnapi/core@1.10.0':
+ dependencies:
+ '@emnapi/wasi-threads': 1.2.1
+ tslib: 2.8.1
+ optional: true
+
+ '@emnapi/core@1.9.2':
+ dependencies:
+ '@emnapi/wasi-threads': 1.2.1
+ tslib: 2.8.1
+ optional: true
+
+ '@emnapi/runtime@1.10.0':
+ dependencies:
+ tslib: 2.8.1
+ optional: true
+
+ '@emnapi/runtime@1.9.2':
+ dependencies:
+ tslib: 2.8.1
+ optional: true
+
+ '@emnapi/wasi-threads@1.2.1':
+ dependencies:
+ tslib: 2.8.1
+ optional: true
+
+ '@es-joy/jsdoccomment@0.86.0':
+ dependencies:
+ '@types/estree': 1.0.9
+ '@typescript-eslint/types': 8.59.4
+ comment-parser: 1.4.6
+ esquery: 1.7.0
+ jsdoc-type-pratt-parser: 7.2.0
+
+ '@es-joy/resolve.exports@1.2.0': {}
+
+ '@esbuild/aix-ppc64@0.25.12':
+ optional: true
+
+ '@esbuild/aix-ppc64@0.27.7':
+ optional: true
+
+ '@esbuild/aix-ppc64@0.28.0':
+ optional: true
+
+ '@esbuild/android-arm64@0.25.12':
+ optional: true
+
+ '@esbuild/android-arm64@0.27.7':
+ optional: true
+
+ '@esbuild/android-arm64@0.28.0':
+ optional: true
+
+ '@esbuild/android-arm@0.25.12':
+ optional: true
+
+ '@esbuild/android-arm@0.27.7':
+ optional: true
+
+ '@esbuild/android-arm@0.28.0':
+ optional: true
+
+ '@esbuild/android-x64@0.25.12':
+ optional: true
+
+ '@esbuild/android-x64@0.27.7':
+ optional: true
+
+ '@esbuild/android-x64@0.28.0':
+ optional: true
+
+ '@esbuild/darwin-arm64@0.25.12':
+ optional: true
+
+ '@esbuild/darwin-arm64@0.27.7':
+ optional: true
+
+ '@esbuild/darwin-arm64@0.28.0':
+ optional: true
+
+ '@esbuild/darwin-x64@0.25.12':
+ optional: true
+
+ '@esbuild/darwin-x64@0.27.7':
+ optional: true
+
+ '@esbuild/darwin-x64@0.28.0':
+ optional: true
+
+ '@esbuild/freebsd-arm64@0.25.12':
+ optional: true
+
+ '@esbuild/freebsd-arm64@0.27.7':
+ optional: true
+
+ '@esbuild/freebsd-arm64@0.28.0':
+ optional: true
+
+ '@esbuild/freebsd-x64@0.25.12':
+ optional: true
+
+ '@esbuild/freebsd-x64@0.27.7':
+ optional: true
+
+ '@esbuild/freebsd-x64@0.28.0':
+ optional: true
+
+ '@esbuild/linux-arm64@0.25.12':
+ optional: true
+
+ '@esbuild/linux-arm64@0.27.7':
+ optional: true
+
+ '@esbuild/linux-arm64@0.28.0':
+ optional: true
+
+ '@esbuild/linux-arm@0.25.12':
+ optional: true
+
+ '@esbuild/linux-arm@0.27.7':
+ optional: true
+
+ '@esbuild/linux-arm@0.28.0':
+ optional: true
+
+ '@esbuild/linux-ia32@0.25.12':
+ optional: true
+
+ '@esbuild/linux-ia32@0.27.7':
+ optional: true
+
+ '@esbuild/linux-ia32@0.28.0':
+ optional: true
+
+ '@esbuild/linux-loong64@0.25.12':
+ optional: true
+
+ '@esbuild/linux-loong64@0.27.7':
+ optional: true
+
+ '@esbuild/linux-loong64@0.28.0':
+ optional: true
+
+ '@esbuild/linux-mips64el@0.25.12':
+ optional: true
+
+ '@esbuild/linux-mips64el@0.27.7':
+ optional: true
+
+ '@esbuild/linux-mips64el@0.28.0':
+ optional: true
+
+ '@esbuild/linux-ppc64@0.25.12':
+ optional: true
+
+ '@esbuild/linux-ppc64@0.27.7':
+ optional: true
+
+ '@esbuild/linux-ppc64@0.28.0':
+ optional: true
+
+ '@esbuild/linux-riscv64@0.25.12':
+ optional: true
+
+ '@esbuild/linux-riscv64@0.27.7':
+ optional: true
+
+ '@esbuild/linux-riscv64@0.28.0':
+ optional: true
+
+ '@esbuild/linux-s390x@0.25.12':
+ optional: true
+
+ '@esbuild/linux-s390x@0.27.7':
+ optional: true
+
+ '@esbuild/linux-s390x@0.28.0':
+ optional: true
+
+ '@esbuild/linux-x64@0.25.12':
+ optional: true
+
+ '@esbuild/linux-x64@0.27.7':
+ optional: true
+
+ '@esbuild/linux-x64@0.28.0':
+ optional: true
+
+ '@esbuild/netbsd-arm64@0.25.12':
+ optional: true
+
+ '@esbuild/netbsd-arm64@0.27.7':
+ optional: true
+
+ '@esbuild/netbsd-arm64@0.28.0':
+ optional: true
+
+ '@esbuild/netbsd-x64@0.25.12':
+ optional: true
+
+ '@esbuild/netbsd-x64@0.27.7':
+ optional: true
+
+ '@esbuild/netbsd-x64@0.28.0':
+ optional: true
+
+ '@esbuild/openbsd-arm64@0.25.12':
+ optional: true
+
+ '@esbuild/openbsd-arm64@0.27.7':
+ optional: true
+
+ '@esbuild/openbsd-arm64@0.28.0':
+ optional: true
+
+ '@esbuild/openbsd-x64@0.25.12':
+ optional: true
+
+ '@esbuild/openbsd-x64@0.27.7':
+ optional: true
+
+ '@esbuild/openbsd-x64@0.28.0':
+ optional: true
+
+ '@esbuild/openharmony-arm64@0.25.12':
+ optional: true
+
+ '@esbuild/openharmony-arm64@0.27.7':
+ optional: true
+
+ '@esbuild/openharmony-arm64@0.28.0':
+ optional: true
+
+ '@esbuild/sunos-x64@0.25.12':
+ optional: true
+
+ '@esbuild/sunos-x64@0.27.7':
+ optional: true
+
+ '@esbuild/sunos-x64@0.28.0':
+ optional: true
+
+ '@esbuild/win32-arm64@0.25.12':
+ optional: true
+
+ '@esbuild/win32-arm64@0.27.7':
+ optional: true
+
+ '@esbuild/win32-arm64@0.28.0':
+ optional: true
+
+ '@esbuild/win32-ia32@0.25.12':
+ optional: true
+
+ '@esbuild/win32-ia32@0.27.7':
+ optional: true
+
+ '@esbuild/win32-ia32@0.28.0':
+ optional: true
+
+ '@esbuild/win32-x64@0.25.12':
+ optional: true
+
+ '@esbuild/win32-x64@0.27.7':
+ optional: true
+
+ '@esbuild/win32-x64@0.28.0':
+ optional: true
+
+ '@eslint-community/eslint-utils@4.9.1(eslint@9.39.4(jiti@2.7.0))':
+ dependencies:
+ eslint: 9.39.4(jiti@2.7.0)
+ eslint-visitor-keys: 3.4.3
+
+ '@eslint-community/regexpp@4.12.2': {}
+
+ '@eslint/compat@2.1.0(eslint@9.39.4(jiti@2.7.0))':
+ dependencies:
+ '@eslint/core': 1.2.1
+ optionalDependencies:
+ eslint: 9.39.4(jiti@2.7.0)
+
+ '@eslint/config-array@0.21.2':
+ dependencies:
+ '@eslint/object-schema': 2.1.7
+ debug: 4.4.3
+ minimatch: 3.1.5
+ transitivePeerDependencies:
+ - supports-color
+
+ '@eslint/config-helpers@0.4.2':
+ dependencies:
+ '@eslint/core': 0.17.0
+
+ '@eslint/config-helpers@0.5.5':
+ dependencies:
+ '@eslint/core': 1.2.1
+
+ '@eslint/core@0.17.0':
+ dependencies:
+ '@types/json-schema': 7.0.15
+
+ '@eslint/core@1.2.1':
+ dependencies:
+ '@types/json-schema': 7.0.15
+
+ '@eslint/eslintrc@3.3.5':
+ dependencies:
+ ajv: 6.15.0
+ debug: 4.4.3
+ espree: 10.4.0
+ globals: 14.0.0
+ ignore: 5.3.2
+ import-fresh: 3.3.1
+ js-yaml: 4.1.1
+ minimatch: 3.1.5
+ strip-json-comments: 3.1.1
+ transitivePeerDependencies:
+ - supports-color
+
+ '@eslint/js@9.39.4': {}
+
+ '@eslint/markdown@8.0.1':
+ dependencies:
+ '@eslint/core': 1.2.1
+ '@eslint/plugin-kit': 0.6.1
+ github-slugger: 2.0.0
+ mdast-util-from-markdown: 2.0.3
+ mdast-util-frontmatter: 2.0.1
+ mdast-util-gfm: 3.1.0
+ mdast-util-math: 3.0.0
+ micromark-extension-frontmatter: 2.0.0
+ micromark-extension-gfm: 3.0.0
+ micromark-extension-math: 3.1.0
+ micromark-util-normalize-identifier: 2.0.1
+ transitivePeerDependencies:
+ - supports-color
+
+ '@eslint/object-schema@2.1.7': {}
+
+ '@eslint/plugin-kit@0.4.1':
+ dependencies:
+ '@eslint/core': 0.17.0
+ levn: 0.4.1
+
+ '@eslint/plugin-kit@0.6.1':
+ dependencies:
+ '@eslint/core': 1.2.1
+ levn: 0.4.1
+
+ '@floating-ui/core@1.7.5':
+ dependencies:
+ '@floating-ui/utils': 0.2.11
+
+ '@floating-ui/dom@1.1.1':
+ dependencies:
+ '@floating-ui/core': 1.7.5
+
+ '@floating-ui/dom@1.7.6':
+ dependencies:
+ '@floating-ui/core': 1.7.5
+ '@floating-ui/utils': 0.2.11
+
+ '@floating-ui/utils@0.2.11': {}
+
+ '@gwhitney/detect-indent@7.0.1': {}
+
+ '@html-validate/stylish@6.0.0': {}
+
+ '@humanfs/core@0.19.2':
+ dependencies:
+ '@humanfs/types': 0.15.0
+
+ '@humanfs/node@0.16.8':
+ dependencies:
+ '@humanfs/core': 0.19.2
+ '@humanfs/types': 0.15.0
+ '@humanwhocodes/retry': 0.4.3
+
+ '@humanfs/types@0.15.0': {}
+
+ '@humanwhocodes/module-importer@1.0.1': {}
+
+ '@humanwhocodes/retry@0.4.3': {}
+
+ '@iconify/types@2.0.0': {}
+
+ '@iconify/utils@3.1.3':
+ dependencies:
+ '@antfu/install-pkg': 1.1.0
+ '@iconify/types': 2.0.0
+ import-meta-resolve: 4.2.0
+
+ '@ioredis/commands@1.5.1': {}
+
+ '@isaacs/cliui@8.0.2':
+ dependencies:
+ string-width: 5.1.2
+ string-width-cjs: string-width@4.2.3
+ strip-ansi: 7.2.0
+ strip-ansi-cjs: strip-ansi@6.0.1
+ wrap-ansi: 8.1.0
+ wrap-ansi-cjs: wrap-ansi@7.0.0
+
+ '@isaacs/fs-minipass@4.0.1':
+ dependencies:
+ minipass: 7.1.3
+
+ '@jest/pattern@30.4.0':
+ dependencies:
+ '@types/node': 24.12.4
+ jest-regex-util: 30.4.0
+
+ '@jest/schemas@30.4.1':
+ dependencies:
+ '@sinclair/typebox': 0.34.49
+
+ '@jest/types@30.4.1':
+ dependencies:
+ '@jest/pattern': 30.4.0
+ '@jest/schemas': 30.4.1
+ '@types/istanbul-lib-coverage': 2.0.6
+ '@types/istanbul-reports': 3.0.4
+ '@types/node': 24.12.4
+ '@types/yargs': 17.0.35
+ chalk: 4.1.2
+
+ '@jridgewell/gen-mapping@0.3.13':
+ dependencies:
+ '@jridgewell/sourcemap-codec': 1.5.5
+ '@jridgewell/trace-mapping': 0.3.31
+
+ '@jridgewell/remapping@2.3.5':
+ dependencies:
+ '@jridgewell/gen-mapping': 0.3.13
+ '@jridgewell/trace-mapping': 0.3.31
+
+ '@jridgewell/resolve-uri@3.1.2': {}
+
+ '@jridgewell/source-map@0.3.11':
+ dependencies:
+ '@jridgewell/gen-mapping': 0.3.13
+ '@jridgewell/trace-mapping': 0.3.31
+
+ '@jridgewell/sourcemap-codec@1.5.5': {}
+
+ '@jridgewell/trace-mapping@0.3.31':
+ dependencies:
+ '@jridgewell/resolve-uri': 3.1.2
+ '@jridgewell/sourcemap-codec': 1.5.5
+
+ '@jsonjoy.com/base64@1.1.2(tslib@2.8.1)':
+ dependencies:
+ tslib: 2.8.1
+
+ '@jsonjoy.com/base64@17.67.0(tslib@2.8.1)':
+ dependencies:
+ tslib: 2.8.1
+
+ '@jsonjoy.com/buffers@1.2.1(tslib@2.8.1)':
+ dependencies:
+ tslib: 2.8.1
+
+ '@jsonjoy.com/buffers@17.67.0(tslib@2.8.1)':
+ dependencies:
+ tslib: 2.8.1
+
+ '@jsonjoy.com/codegen@1.0.0(tslib@2.8.1)':
+ dependencies:
+ tslib: 2.8.1
+
+ '@jsonjoy.com/codegen@17.67.0(tslib@2.8.1)':
+ dependencies:
+ tslib: 2.8.1
+
+ '@jsonjoy.com/fs-core@4.57.2(tslib@2.8.1)':
+ dependencies:
+ '@jsonjoy.com/fs-node-builtins': 4.57.2(tslib@2.8.1)
+ '@jsonjoy.com/fs-node-utils': 4.57.2(tslib@2.8.1)
+ thingies: 2.6.0(tslib@2.8.1)
+ tslib: 2.8.1
+
+ '@jsonjoy.com/fs-fsa@4.57.2(tslib@2.8.1)':
+ dependencies:
+ '@jsonjoy.com/fs-core': 4.57.2(tslib@2.8.1)
+ '@jsonjoy.com/fs-node-builtins': 4.57.2(tslib@2.8.1)
+ '@jsonjoy.com/fs-node-utils': 4.57.2(tslib@2.8.1)
+ thingies: 2.6.0(tslib@2.8.1)
+ tslib: 2.8.1
+
+ '@jsonjoy.com/fs-node-builtins@4.57.2(tslib@2.8.1)':
+ dependencies:
+ tslib: 2.8.1
+
+ '@jsonjoy.com/fs-node-to-fsa@4.57.2(tslib@2.8.1)':
+ dependencies:
+ '@jsonjoy.com/fs-fsa': 4.57.2(tslib@2.8.1)
+ '@jsonjoy.com/fs-node-builtins': 4.57.2(tslib@2.8.1)
+ '@jsonjoy.com/fs-node-utils': 4.57.2(tslib@2.8.1)
+ tslib: 2.8.1
+
+ '@jsonjoy.com/fs-node-utils@4.57.2(tslib@2.8.1)':
+ dependencies:
+ '@jsonjoy.com/fs-node-builtins': 4.57.2(tslib@2.8.1)
+ tslib: 2.8.1
+
+ '@jsonjoy.com/fs-node@4.57.2(tslib@2.8.1)':
+ dependencies:
+ '@jsonjoy.com/fs-core': 4.57.2(tslib@2.8.1)
+ '@jsonjoy.com/fs-node-builtins': 4.57.2(tslib@2.8.1)
+ '@jsonjoy.com/fs-node-utils': 4.57.2(tslib@2.8.1)
+ '@jsonjoy.com/fs-print': 4.57.2(tslib@2.8.1)
+ '@jsonjoy.com/fs-snapshot': 4.57.2(tslib@2.8.1)
+ glob-to-regex.js: 1.2.0(tslib@2.8.1)
+ thingies: 2.6.0(tslib@2.8.1)
+ tslib: 2.8.1
+
+ '@jsonjoy.com/fs-print@4.57.2(tslib@2.8.1)':
+ dependencies:
+ '@jsonjoy.com/fs-node-utils': 4.57.2(tslib@2.8.1)
+ tree-dump: 1.1.0(tslib@2.8.1)
+ tslib: 2.8.1
+
+ '@jsonjoy.com/fs-snapshot@4.57.2(tslib@2.8.1)':
+ dependencies:
+ '@jsonjoy.com/buffers': 17.67.0(tslib@2.8.1)
+ '@jsonjoy.com/fs-node-utils': 4.57.2(tslib@2.8.1)
+ '@jsonjoy.com/json-pack': 17.67.0(tslib@2.8.1)
+ '@jsonjoy.com/util': 17.67.0(tslib@2.8.1)
+ tslib: 2.8.1
+
+ '@jsonjoy.com/json-pack@1.21.0(tslib@2.8.1)':
+ dependencies:
+ '@jsonjoy.com/base64': 1.1.2(tslib@2.8.1)
+ '@jsonjoy.com/buffers': 1.2.1(tslib@2.8.1)
+ '@jsonjoy.com/codegen': 1.0.0(tslib@2.8.1)
+ '@jsonjoy.com/json-pointer': 1.0.2(tslib@2.8.1)
+ '@jsonjoy.com/util': 1.9.0(tslib@2.8.1)
+ hyperdyperid: 1.2.0
+ thingies: 2.6.0(tslib@2.8.1)
+ tree-dump: 1.1.0(tslib@2.8.1)
+ tslib: 2.8.1
+
+ '@jsonjoy.com/json-pack@17.67.0(tslib@2.8.1)':
+ dependencies:
+ '@jsonjoy.com/base64': 17.67.0(tslib@2.8.1)
+ '@jsonjoy.com/buffers': 17.67.0(tslib@2.8.1)
+ '@jsonjoy.com/codegen': 17.67.0(tslib@2.8.1)
+ '@jsonjoy.com/json-pointer': 17.67.0(tslib@2.8.1)
+ '@jsonjoy.com/util': 17.67.0(tslib@2.8.1)
+ hyperdyperid: 1.2.0
+ thingies: 2.6.0(tslib@2.8.1)
+ tree-dump: 1.1.0(tslib@2.8.1)
+ tslib: 2.8.1
+
+ '@jsonjoy.com/json-pointer@1.0.2(tslib@2.8.1)':
+ dependencies:
+ '@jsonjoy.com/codegen': 1.0.0(tslib@2.8.1)
+ '@jsonjoy.com/util': 1.9.0(tslib@2.8.1)
+ tslib: 2.8.1
+
+ '@jsonjoy.com/json-pointer@17.67.0(tslib@2.8.1)':
+ dependencies:
+ '@jsonjoy.com/util': 17.67.0(tslib@2.8.1)
+ tslib: 2.8.1
+
+ '@jsonjoy.com/util@1.9.0(tslib@2.8.1)':
+ dependencies:
+ '@jsonjoy.com/buffers': 1.2.1(tslib@2.8.1)
+ '@jsonjoy.com/codegen': 1.0.0(tslib@2.8.1)
+ tslib: 2.8.1
+
+ '@jsonjoy.com/util@17.67.0(tslib@2.8.1)':
+ dependencies:
+ '@jsonjoy.com/buffers': 17.67.0(tslib@2.8.1)
+ '@jsonjoy.com/codegen': 17.67.0(tslib@2.8.1)
+ tslib: 2.8.1
+
+ '@loaderkit/resolve@1.0.6':
+ dependencies:
+ '@braidai/lang': 1.1.2
+
+ '@mapbox/node-pre-gyp@2.0.3':
+ dependencies:
+ consola: 3.4.2
+ detect-libc: 2.1.2
+ https-proxy-agent: 7.0.6
+ node-fetch: 2.7.0
+ nopt: 8.1.0
+ semver: 7.8.0
+ tar: 7.5.15
+ transitivePeerDependencies:
+ - encoding
+ - supports-color
+
+ '@napi-rs/wasm-runtime@1.1.4(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0)':
+ dependencies:
+ '@emnapi/core': 1.10.0
+ '@emnapi/runtime': 1.10.0
+ '@tybys/wasm-util': 0.10.2
+ optional: true
+
+ '@napi-rs/wasm-runtime@1.1.4(@emnapi/core@1.9.2)(@emnapi/runtime@1.9.2)':
+ dependencies:
+ '@emnapi/core': 1.9.2
+ '@emnapi/runtime': 1.9.2
+ '@tybys/wasm-util': 0.10.2
+ optional: true
+
+ '@nodelib/fs.scandir@2.1.5':
+ dependencies:
+ '@nodelib/fs.stat': 2.0.5
+ run-parallel: 1.2.0
+
+ '@nodelib/fs.stat@2.0.5': {}
+
+ '@nodelib/fs.walk@1.2.8':
+ dependencies:
+ '@nodelib/fs.scandir': 2.1.5
+ fastq: 1.20.1
+
+ '@npmcli/map-workspaces@3.0.6':
+ dependencies:
+ '@npmcli/name-from-folder': 2.0.0
+ glob: 10.5.0
+ minimatch: 9.0.9
+ read-package-json-fast: 3.0.2
+
+ '@npmcli/name-from-folder@2.0.0': {}
+
+ '@nuxt/cli@3.35.2(@nuxt/schema@packages+schema)(magicast@0.5.3)':
+ dependencies:
+ '@bomb.sh/tab': 0.0.15(citty@0.2.2)
+ '@clack/prompts': 1.4.0
+ c12: 3.3.4(magicast@0.5.3)
+ citty: 0.2.2
+ confbox: 0.2.4
+ consola: 3.4.2
+ debug: 4.4.3
+ defu: 6.1.7
+ exsolve: 1.0.8
+ fuse.js: 7.3.0
+ fzf: 0.5.2
+ giget: 3.2.0
+ jiti: 2.7.0
+ listhen: 1.10.0(srvx@0.11.15)
+ nypm: 0.6.6
+ ofetch: 1.5.1
+ ohash: 2.0.11
+ pathe: 2.0.3
+ perfect-debounce: 2.1.0
+ pkg-types: 2.3.1
+ scule: 1.3.0
+ semver: 7.8.0
+ srvx: 0.11.15
+ std-env: 4.1.0
+ tinyclip: 0.1.12
+ tinyexec: 1.1.2
+ ufo: 1.6.4
+ youch: 4.1.1
+ optionalDependencies:
+ '@nuxt/schema': link:packages/schema
+ transitivePeerDependencies:
+ - cac
+ - commander
+ - magicast
+ - supports-color
+
+ '@nuxt/devtools-kit@2.7.0(vite@8.0.12)':
+ dependencies:
+ '@nuxt/kit': link:packages/kit
+ execa: 8.0.1
+ vite: 8.0.12(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0)
+
+ '@nuxt/devtools-kit@3.2.4(vite@8.0.12)':
+ dependencies:
+ '@nuxt/kit': link:packages/kit
+ execa: 8.0.1
+ vite: 8.0.12(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0)
+
+ '@nuxt/devtools-kit@4.0.0-alpha.4(vite@8.0.12)':
+ dependencies:
+ '@nuxt/kit': link:packages/kit
+ tinyexec: 1.1.2
+ vite: 8.0.12(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0)
+
+ '@nuxt/devtools@4.0.0-alpha.4(@pnpm/logger@1001.0.1)(crossws@0.4.5(srvx@0.11.15))(db0@0.3.4)(ioredis@5.10.1)(typescript@6.0.3)(vite@8.0.12)(vue@3.5.34(typescript@6.0.3))':
+ dependencies:
+ '@nuxt/devtools-kit': 4.0.0-alpha.4(vite@8.0.12)
+ '@nuxt/kit': link:packages/kit
+ '@vitejs/devtools': 0.1.24(@pnpm/logger@1001.0.1)(crossws@0.4.5(srvx@0.11.15))(db0@0.3.4)(ioredis@5.10.1)(typescript@6.0.3)(vite@8.0.12)
+ '@vitejs/devtools-kit': 0.1.24(crossws@0.4.5(srvx@0.11.15))(typescript@6.0.3)(vite@8.0.12)
+ '@vue/devtools-core': 8.1.2(vue@3.5.34(typescript@6.0.3))
+ '@vue/devtools-kit': 8.1.2
+ birpc: 4.0.0
+ consola: 3.4.2
+ destr: 2.0.5
+ error-stack-parser-es: 1.0.5
+ fast-npm-meta: 1.5.1
+ get-port-please: 3.2.0
+ hookable: 6.1.1
+ image-meta: 0.2.2
+ launch-editor: 2.13.2
+ local-pkg: 1.2.1
+ magicast: 0.5.3
+ ohash: 2.0.11
+ pathe: 2.0.3
+ perfect-debounce: 2.1.0
+ pkg-types: 2.3.1
+ semver: 7.8.0
+ sirv: 3.0.2
+ structured-clone-es: 2.0.0
+ tinyexec: 1.1.2
+ tinyglobby: 0.2.16
+ vite: 8.0.12(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0)
+ vite-plugin-inspect: 12.0.0-beta.2(@nuxt/kit@packages+kit)(crossws@0.4.5(srvx@0.11.15))(typescript@6.0.3)(vite@8.0.12)
+ vite-plugin-vue-tracer: 1.4.0(vite@8.0.12)(vue@3.5.34(typescript@6.0.3))
+ which: 6.0.1
+ ws: 8.21.0
+ transitivePeerDependencies:
+ - '@azure/app-configuration'
+ - '@azure/cosmos'
+ - '@azure/data-tables'
+ - '@azure/identity'
+ - '@azure/keyvault-secrets'
+ - '@azure/storage-blob'
+ - '@capacitor/preferences'
+ - '@deno/kv'
+ - '@modelcontextprotocol/sdk'
+ - '@netlify/blobs'
+ - '@planetscale/database'
+ - '@pnpm/logger'
+ - '@upstash/redis'
+ - '@vercel/blob'
+ - '@vercel/functions'
+ - '@vercel/kv'
+ - aws4fetch
+ - bufferutil
+ - crossws
+ - db0
+ - idb-keyval
+ - ioredis
+ - typescript
+ - uploadthing
+ - utf-8-validate
+ - vue
+
+ '@nuxt/eslint-config@1.15.2(@typescript-eslint/utils@8.59.4(eslint@9.39.4(jiti@2.7.0))(typescript@6.0.3))(@vue/compiler-sfc@3.5.34)(eslint@9.39.4(jiti@2.7.0))(typescript@6.0.3)':
+ dependencies:
+ '@antfu/install-pkg': 1.1.0
+ '@clack/prompts': 1.4.0
+ '@eslint/js': 9.39.4
+ '@nuxt/eslint-plugin': 1.15.2(eslint@9.39.4(jiti@2.7.0))(typescript@6.0.3)
+ '@stylistic/eslint-plugin': 5.10.0(eslint@9.39.4(jiti@2.7.0))
+ '@typescript-eslint/eslint-plugin': 8.59.4(@typescript-eslint/parser@8.59.3(eslint@9.39.4(jiti@2.7.0))(typescript@6.0.3))(eslint@9.39.4(jiti@2.7.0))(typescript@6.0.3)
+ '@typescript-eslint/parser': 8.59.3(eslint@9.39.4(jiti@2.7.0))(typescript@6.0.3)
+ eslint: 9.39.4(jiti@2.7.0)
+ eslint-config-flat-gitignore: 2.3.0(eslint@9.39.4(jiti@2.7.0))
+ eslint-flat-config-utils: 3.2.0
+ eslint-merge-processors: 2.0.0(eslint@9.39.4(jiti@2.7.0))
+ eslint-plugin-import-lite: 0.5.2(eslint@9.39.4(jiti@2.7.0))
+ eslint-plugin-import-x: 4.16.2(@typescript-eslint/utils@8.59.4(eslint@9.39.4(jiti@2.7.0))(typescript@6.0.3))(eslint@9.39.4(jiti@2.7.0))
+ eslint-plugin-jsdoc: 62.9.0(eslint@9.39.4(jiti@2.7.0))
+ eslint-plugin-regexp: 3.1.0(eslint@9.39.4(jiti@2.7.0))
+ eslint-plugin-unicorn: 63.0.0(eslint@9.39.4(jiti@2.7.0))
+ eslint-plugin-vue: 10.9.1(@stylistic/eslint-plugin@5.10.0(eslint@9.39.4(jiti@2.7.0)))(@typescript-eslint/parser@8.59.3(eslint@9.39.4(jiti@2.7.0))(typescript@6.0.3))(eslint@9.39.4(jiti@2.7.0))(vue-eslint-parser@10.4.0(eslint@9.39.4(jiti@2.7.0)))
+ eslint-processor-vue-blocks: 2.0.0(@vue/compiler-sfc@3.5.34)(eslint@9.39.4(jiti@2.7.0))
+ globals: 17.6.0
+ local-pkg: 1.2.1
+ pathe: 2.0.3
+ vue-eslint-parser: 10.4.0(eslint@9.39.4(jiti@2.7.0))
+ transitivePeerDependencies:
+ - '@typescript-eslint/utils'
+ - '@vue/compiler-sfc'
+ - eslint-import-resolver-node
+ - supports-color
+ - typescript
+
+ '@nuxt/eslint-plugin@1.15.2(eslint@9.39.4(jiti@2.7.0))(typescript@6.0.3)':
+ dependencies:
+ '@typescript-eslint/types': 8.59.4
+ '@typescript-eslint/utils': 8.59.4(eslint@9.39.4(jiti@2.7.0))(typescript@6.0.3)
+ eslint: 9.39.4(jiti@2.7.0)
+ transitivePeerDependencies:
+ - supports-color
+ - typescript
+
+ '@nuxt/friendly-errors-webpack-plugin@2.6.0(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))':
+ dependencies:
+ chalk: 2.4.2
+ consola: 3.4.2
+ error-stack-parser: 2.1.4
+ string-width: 4.2.3
+ webpack: 5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)
+
+ '@nuxt/scripts@1.1.0(@unhead/vue@3.1.0(crossws@0.4.5(srvx@0.11.15))(esbuild@0.28.0)(lightningcss@1.32.0)(rolldown@1.0.2)(typescript@6.0.3)(vite@8.0.12)(vue@3.5.34(typescript@6.0.3))(webpack@5.106.2(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)))(db0@0.3.4)(ioredis@5.10.1)(rolldown@1.0.2)(typescript@6.0.3)(vite@8.0.12)(vue@3.5.34(typescript@6.0.3))':
+ dependencies:
+ '@nuxt/devtools-kit': 3.2.4(vite@8.0.12)
+ '@unhead/vue': 3.1.0(crossws@0.4.5(srvx@0.11.15))(esbuild@0.28.0)(lightningcss@1.32.0)(rolldown@1.0.2)(typescript@6.0.3)(vite@8.0.12)(vue@3.5.34(typescript@6.0.3))(webpack@5.106.2(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ '@vueuse/core': 14.3.0(vue@3.5.34(typescript@6.0.3))
+ '@vueuse/shared': 14.3.0(vue@3.5.34(typescript@6.0.3))
+ consola: 3.4.2
+ defu: 6.1.7
+ h3: 1.15.11
+ magic-string: 0.30.21
+ ofetch: 1.5.1
+ ohash: 2.0.11
+ oxc-parser: 0.130.0
+ oxc-walker: 1.0.0(oxc-parser@0.130.0)(rolldown@1.0.2)
+ pathe: 2.0.3
+ pkg-types: 2.3.1
+ sirv: 3.0.2
+ std-env: 4.1.0
+ ufo: 1.6.4
+ ultrahtml: 1.6.0
+ unplugin: 3.0.0
+ unstorage: 1.17.5(db0@0.3.4)(ioredis@5.10.1)
+ valibot: 1.4.0(typescript@6.0.3)
+ transitivePeerDependencies:
+ - '@azure/app-configuration'
+ - '@azure/cosmos'
+ - '@azure/data-tables'
+ - '@azure/identity'
+ - '@azure/keyvault-secrets'
+ - '@azure/storage-blob'
+ - '@capacitor/preferences'
+ - '@deno/kv'
+ - '@netlify/blobs'
+ - '@planetscale/database'
+ - '@upstash/redis'
+ - '@vercel/blob'
+ - '@vercel/functions'
+ - '@vercel/kv'
+ - aws4fetch
+ - db0
+ - idb-keyval
+ - ioredis
+ - rolldown
+ - typescript
+ - uploadthing
+ - vite
+ - vue
+
+ '@nuxt/telemetry@2.8.0(@nuxt/kit@packages+kit)':
+ dependencies:
+ '@nuxt/kit': link:packages/kit
+ citty: 0.2.2
+ consola: 3.4.2
+ ofetch: 2.0.0-alpha.3
+ rc9: 3.0.1
+ std-env: 4.1.0
+
+ '@nuxt/test-utils@4.0.3(@playwright/test@1.60.0)(@testing-library/vue@8.1.0(@vue/compiler-dom@3.5.34)(@vue/compiler-sfc@3.5.34)(@vue/server-renderer@3.5.34(vue@3.5.34(typescript@6.0.3)))(vue@3.5.34(typescript@6.0.3)))(@vue/test-utils@2.4.10(@vue/compiler-dom@3.5.34)(@vue/server-renderer@3.5.34(vue@3.5.34(typescript@6.0.3)))(vue@3.5.34(typescript@6.0.3)))(crossws@0.4.5(srvx@0.11.15))(happy-dom@20.9.0)(magicast@0.5.3)(playwright-core@1.60.0)(typescript@6.0.3)(vite@8.0.12)(vitest@4.1.7)':
+ dependencies:
+ '@clack/prompts': 1.2.0
+ '@nuxt/devtools-kit': 2.7.0(vite@8.0.12)
+ '@nuxt/kit': link:packages/kit
+ c12: 3.3.4(magicast@0.5.3)
+ consola: 3.4.2
+ defu: 6.1.7
+ destr: 2.0.5
+ estree-walker: 3.0.3
+ exsolve: 1.0.8
+ fake-indexeddb: 6.2.5
+ get-port-please: 3.2.0
+ h3: 1.15.11
+ h3-next: h3@2.0.1-rc.20(crossws@0.4.5(srvx@0.11.15))
+ local-pkg: 1.2.1
+ magic-string: 0.30.21
+ node-fetch-native: 1.6.7
+ node-mock-http: 1.0.4
+ nypm: 0.6.6
+ ofetch: 1.5.1
+ pathe: 2.0.3
+ perfect-debounce: 2.1.0
+ radix3: 1.1.2
+ scule: 1.3.0
+ std-env: 4.1.0
+ tinyexec: 1.1.2
+ ufo: 1.6.4
+ unplugin: 3.0.0
+ vitest-environment-nuxt: 2.0.0(@playwright/test@1.60.0)(@testing-library/vue@8.1.0(@vue/compiler-dom@3.5.34)(@vue/compiler-sfc@3.5.34)(@vue/server-renderer@3.5.34(vue@3.5.34(typescript@6.0.3)))(vue@3.5.34(typescript@6.0.3)))(@vue/test-utils@2.4.10(@vue/compiler-dom@3.5.34)(@vue/server-renderer@3.5.34(vue@3.5.34(typescript@6.0.3)))(vue@3.5.34(typescript@6.0.3)))(crossws@0.4.5(srvx@0.11.15))(happy-dom@20.9.0)(magicast@0.5.3)(playwright-core@1.60.0)(typescript@6.0.3)(vite@8.0.12)(vitest@4.1.7)
+ vue: 3.5.34(typescript@6.0.3)
+ optionalDependencies:
+ '@playwright/test': 1.60.0
+ '@testing-library/vue': 8.1.0(@vue/compiler-dom@3.5.34)(@vue/compiler-sfc@3.5.34)(@vue/server-renderer@3.5.34(vue@3.5.34(typescript@6.0.3)))(vue@3.5.34(typescript@6.0.3))
+ '@vue/test-utils': 2.4.10(@vue/compiler-dom@3.5.34)(@vue/server-renderer@3.5.34(vue@3.5.34(typescript@6.0.3)))(vue@3.5.34(typescript@6.0.3))
+ happy-dom: 20.9.0
+ playwright-core: 1.60.0
+ vitest: 4.1.7(@types/node@24.12.4)(@vitest/coverage-v8@4.1.7)(happy-dom@20.9.0)(vite@8.0.12)
+ transitivePeerDependencies:
+ - crossws
+ - magicast
+ - typescript
+ - vite
+
+ '@nuxtjs/mdc@0.22.0':
+ dependencies:
+ '@nuxt/kit': link:packages/kit
+ '@shikijs/core': 4.1.0
+ '@shikijs/engine-javascript': 4.1.0
+ '@shikijs/langs': 4.1.0
+ '@shikijs/themes': 4.1.0
+ '@shikijs/transformers': 4.1.0
+ '@types/hast': 3.0.4
+ '@types/mdast': 4.0.4
+ '@vue/compiler-core': 3.5.34
+ consola: 3.4.2
+ debug: 4.4.3
+ defu: 6.1.7
+ destr: 2.0.5
+ detab: 3.0.2
+ github-slugger: 2.0.0
+ hast-util-format: 1.1.0
+ hast-util-to-mdast: 10.1.2
+ hast-util-to-string: 3.0.1
+ mdast-util-to-hast: 13.2.1
+ micromark-util-sanitize-uri: 2.0.1
+ parse5: 8.0.1
+ pathe: 2.0.3
+ property-information: 7.1.0
+ rehype-external-links: 3.0.0
+ rehype-minify-whitespace: 6.0.2
+ rehype-raw: 7.0.0
+ rehype-remark: 10.0.1
+ rehype-slug: 6.0.0
+ rehype-sort-attribute-values: 5.0.1
+ rehype-sort-attributes: 5.0.1
+ remark-emoji: 5.0.2
+ remark-gfm: 4.0.1
+ remark-mdc: 3.11.0
+ remark-parse: 11.0.0
+ remark-rehype: 11.1.2
+ remark-stringify: 11.0.0
+ scule: 1.3.0
+ shiki: 4.1.0
+ ufo: 1.6.4
+ unified: 11.0.5
+ unist-builder: 4.0.0
+ unist-util-visit: 5.1.0
+ unwasm: 0.5.3
+ vfile: 6.0.3
+ transitivePeerDependencies:
+ - supports-color
+
+ '@one-ini/wasm@0.1.1': {}
+
+ '@oxc-parser/binding-android-arm-eabi@0.124.0':
+ optional: true
+
+ '@oxc-parser/binding-android-arm-eabi@0.126.0':
+ optional: true
+
+ '@oxc-parser/binding-android-arm-eabi@0.127.0':
+ optional: true
+
+ '@oxc-parser/binding-android-arm-eabi@0.130.0':
+ optional: true
+
+ '@oxc-parser/binding-android-arm64@0.124.0':
+ optional: true
+
+ '@oxc-parser/binding-android-arm64@0.126.0':
+ optional: true
+
+ '@oxc-parser/binding-android-arm64@0.127.0':
+ optional: true
+
+ '@oxc-parser/binding-android-arm64@0.130.0':
+ optional: true
+
+ '@oxc-parser/binding-darwin-arm64@0.124.0':
+ optional: true
+
+ '@oxc-parser/binding-darwin-arm64@0.126.0':
+ optional: true
+
+ '@oxc-parser/binding-darwin-arm64@0.127.0':
+ optional: true
+
+ '@oxc-parser/binding-darwin-arm64@0.130.0':
+ optional: true
+
+ '@oxc-parser/binding-darwin-x64@0.124.0':
+ optional: true
+
+ '@oxc-parser/binding-darwin-x64@0.126.0':
+ optional: true
+
+ '@oxc-parser/binding-darwin-x64@0.127.0':
+ optional: true
+
+ '@oxc-parser/binding-darwin-x64@0.130.0':
+ optional: true
+
+ '@oxc-parser/binding-freebsd-x64@0.124.0':
+ optional: true
+
+ '@oxc-parser/binding-freebsd-x64@0.126.0':
+ optional: true
+
+ '@oxc-parser/binding-freebsd-x64@0.127.0':
+ optional: true
+
+ '@oxc-parser/binding-freebsd-x64@0.130.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-arm-gnueabihf@0.124.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-arm-gnueabihf@0.126.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-arm-gnueabihf@0.127.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-arm-gnueabihf@0.130.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-arm-musleabihf@0.124.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-arm-musleabihf@0.126.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-arm-musleabihf@0.127.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-arm-musleabihf@0.130.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-arm64-gnu@0.124.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-arm64-gnu@0.126.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-arm64-gnu@0.127.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-arm64-gnu@0.130.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-arm64-musl@0.124.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-arm64-musl@0.126.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-arm64-musl@0.127.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-arm64-musl@0.130.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-ppc64-gnu@0.124.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-ppc64-gnu@0.126.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-ppc64-gnu@0.127.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-ppc64-gnu@0.130.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-riscv64-gnu@0.124.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-riscv64-gnu@0.126.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-riscv64-gnu@0.127.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-riscv64-gnu@0.130.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-riscv64-musl@0.124.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-riscv64-musl@0.126.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-riscv64-musl@0.127.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-riscv64-musl@0.130.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-s390x-gnu@0.124.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-s390x-gnu@0.126.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-s390x-gnu@0.127.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-s390x-gnu@0.130.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-x64-gnu@0.124.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-x64-gnu@0.126.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-x64-gnu@0.127.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-x64-gnu@0.130.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-x64-musl@0.124.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-x64-musl@0.126.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-x64-musl@0.127.0':
+ optional: true
+
+ '@oxc-parser/binding-linux-x64-musl@0.130.0':
+ optional: true
+
+ '@oxc-parser/binding-openharmony-arm64@0.124.0':
+ optional: true
+
+ '@oxc-parser/binding-openharmony-arm64@0.126.0':
+ optional: true
+
+ '@oxc-parser/binding-openharmony-arm64@0.127.0':
+ optional: true
+
+ '@oxc-parser/binding-openharmony-arm64@0.130.0':
+ optional: true
+
+ '@oxc-parser/binding-wasm32-wasi@0.124.0(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0)':
+ dependencies:
+ '@napi-rs/wasm-runtime': 1.1.4(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0)
+ transitivePeerDependencies:
+ - '@emnapi/core'
+ - '@emnapi/runtime'
+ optional: true
+
+ '@oxc-parser/binding-wasm32-wasi@0.126.0':
+ dependencies:
+ '@emnapi/core': 1.9.2
+ '@emnapi/runtime': 1.9.2
+ '@napi-rs/wasm-runtime': 1.1.4(@emnapi/core@1.9.2)(@emnapi/runtime@1.9.2)
+ optional: true
+
+ '@oxc-parser/binding-wasm32-wasi@0.127.0':
+ dependencies:
+ '@emnapi/core': 1.9.2
+ '@emnapi/runtime': 1.9.2
+ '@napi-rs/wasm-runtime': 1.1.4(@emnapi/core@1.9.2)(@emnapi/runtime@1.9.2)
+ optional: true
+
+ '@oxc-parser/binding-wasm32-wasi@0.130.0':
+ dependencies:
+ '@emnapi/core': 1.10.0
+ '@emnapi/runtime': 1.10.0
+ '@napi-rs/wasm-runtime': 1.1.4(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0)
+ optional: true
+
+ '@oxc-parser/binding-win32-arm64-msvc@0.124.0':
+ optional: true
+
+ '@oxc-parser/binding-win32-arm64-msvc@0.126.0':
+ optional: true
+
+ '@oxc-parser/binding-win32-arm64-msvc@0.127.0':
+ optional: true
+
+ '@oxc-parser/binding-win32-arm64-msvc@0.130.0':
+ optional: true
+
+ '@oxc-parser/binding-win32-ia32-msvc@0.124.0':
+ optional: true
+
+ '@oxc-parser/binding-win32-ia32-msvc@0.126.0':
+ optional: true
+
+ '@oxc-parser/binding-win32-ia32-msvc@0.127.0':
+ optional: true
+
+ '@oxc-parser/binding-win32-ia32-msvc@0.130.0':
+ optional: true
+
+ '@oxc-parser/binding-win32-x64-msvc@0.124.0':
+ optional: true
+
+ '@oxc-parser/binding-win32-x64-msvc@0.126.0':
+ optional: true
+
+ '@oxc-parser/binding-win32-x64-msvc@0.127.0':
+ optional: true
+
+ '@oxc-parser/binding-win32-x64-msvc@0.130.0':
+ optional: true
+
+ '@oxc-project/types@0.124.0': {}
+
+ '@oxc-project/types@0.126.0': {}
+
+ '@oxc-project/types@0.127.0': {}
+
+ '@oxc-project/types@0.129.0': {}
+
+ '@oxc-project/types@0.130.0': {}
+
+ '@oxc-project/types@0.131.0': {}
+
+ '@oxc-project/types@0.132.0': {}
+
+ '@oxc-resolver/binding-android-arm-eabi@11.19.1':
+ optional: true
+
+ '@oxc-resolver/binding-android-arm64@11.19.1':
+ optional: true
+
+ '@oxc-resolver/binding-darwin-arm64@11.19.1':
+ optional: true
+
+ '@oxc-resolver/binding-darwin-x64@11.19.1':
+ optional: true
+
+ '@oxc-resolver/binding-freebsd-x64@11.19.1':
+ optional: true
+
+ '@oxc-resolver/binding-linux-arm-gnueabihf@11.19.1':
+ optional: true
+
+ '@oxc-resolver/binding-linux-arm-musleabihf@11.19.1':
+ optional: true
+
+ '@oxc-resolver/binding-linux-arm64-gnu@11.19.1':
+ optional: true
+
+ '@oxc-resolver/binding-linux-arm64-musl@11.19.1':
+ optional: true
+
+ '@oxc-resolver/binding-linux-ppc64-gnu@11.19.1':
+ optional: true
+
+ '@oxc-resolver/binding-linux-riscv64-gnu@11.19.1':
+ optional: true
+
+ '@oxc-resolver/binding-linux-riscv64-musl@11.19.1':
+ optional: true
+
+ '@oxc-resolver/binding-linux-s390x-gnu@11.19.1':
+ optional: true
+
+ '@oxc-resolver/binding-linux-x64-gnu@11.19.1':
+ optional: true
+
+ '@oxc-resolver/binding-linux-x64-musl@11.19.1':
+ optional: true
+
+ '@oxc-resolver/binding-openharmony-arm64@11.19.1':
+ optional: true
+
+ '@oxc-resolver/binding-wasm32-wasi@11.19.1(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0)':
+ dependencies:
+ '@napi-rs/wasm-runtime': 1.1.4(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0)
+ transitivePeerDependencies:
+ - '@emnapi/core'
+ - '@emnapi/runtime'
+ optional: true
+
+ '@oxc-resolver/binding-win32-arm64-msvc@11.19.1':
+ optional: true
+
+ '@oxc-resolver/binding-win32-ia32-msvc@11.19.1':
+ optional: true
+
+ '@oxc-resolver/binding-win32-x64-msvc@11.19.1':
+ optional: true
+
+ '@oxc-transform/binding-android-arm-eabi@0.131.0':
+ optional: true
+
+ '@oxc-transform/binding-android-arm64@0.131.0':
+ optional: true
+
+ '@oxc-transform/binding-darwin-arm64@0.131.0':
+ optional: true
+
+ '@oxc-transform/binding-darwin-x64@0.131.0':
+ optional: true
+
+ '@oxc-transform/binding-freebsd-x64@0.131.0':
+ optional: true
+
+ '@oxc-transform/binding-linux-arm-gnueabihf@0.131.0':
+ optional: true
+
+ '@oxc-transform/binding-linux-arm-musleabihf@0.131.0':
+ optional: true
+
+ '@oxc-transform/binding-linux-arm64-gnu@0.131.0':
+ optional: true
+
+ '@oxc-transform/binding-linux-arm64-musl@0.131.0':
+ optional: true
+
+ '@oxc-transform/binding-linux-ppc64-gnu@0.131.0':
+ optional: true
+
+ '@oxc-transform/binding-linux-riscv64-gnu@0.131.0':
+ optional: true
+
+ '@oxc-transform/binding-linux-riscv64-musl@0.131.0':
+ optional: true
+
+ '@oxc-transform/binding-linux-s390x-gnu@0.131.0':
+ optional: true
+
+ '@oxc-transform/binding-linux-x64-gnu@0.131.0':
+ optional: true
+
+ '@oxc-transform/binding-linux-x64-musl@0.131.0':
+ optional: true
+
+ '@oxc-transform/binding-openharmony-arm64@0.131.0':
+ optional: true
+
+ '@oxc-transform/binding-wasm32-wasi@0.131.0':
+ dependencies:
+ '@emnapi/core': 1.10.0
+ '@emnapi/runtime': 1.10.0
+ '@napi-rs/wasm-runtime': 1.1.4(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0)
+ optional: true
+
+ '@oxc-transform/binding-win32-arm64-msvc@0.131.0':
+ optional: true
+
+ '@oxc-transform/binding-win32-ia32-msvc@0.131.0':
+ optional: true
+
+ '@oxc-transform/binding-win32-x64-msvc@0.131.0':
+ optional: true
+
+ '@package-json/types@0.0.12': {}
+
+ '@parcel/watcher-android-arm64@2.5.6':
+ optional: true
+
+ '@parcel/watcher-darwin-arm64@2.5.6':
+ optional: true
+
+ '@parcel/watcher-darwin-x64@2.5.6':
+ optional: true
+
+ '@parcel/watcher-freebsd-x64@2.5.6':
+ optional: true
+
+ '@parcel/watcher-linux-arm-glibc@2.5.6':
+ optional: true
+
+ '@parcel/watcher-linux-arm-musl@2.5.6':
+ optional: true
+
+ '@parcel/watcher-linux-arm64-glibc@2.5.6':
+ optional: true
+
+ '@parcel/watcher-linux-arm64-musl@2.5.6':
+ optional: true
+
+ '@parcel/watcher-linux-x64-glibc@2.5.6':
+ optional: true
+
+ '@parcel/watcher-linux-x64-musl@2.5.6':
+ optional: true
+
+ '@parcel/watcher-wasm@2.5.6':
+ dependencies:
+ is-glob: 4.0.3
+ picomatch: 4.0.4
+
+ '@parcel/watcher-win32-arm64@2.5.6':
+ optional: true
+
+ '@parcel/watcher-win32-ia32@2.5.6':
+ optional: true
+
+ '@parcel/watcher-win32-x64@2.5.6':
+ optional: true
+
+ '@parcel/watcher@2.5.6':
+ dependencies:
+ detect-libc: 2.1.2
+ is-glob: 4.0.3
+ node-addon-api: 7.1.1
+ picomatch: 4.0.4
+ optionalDependencies:
+ '@parcel/watcher-android-arm64': 2.5.6
+ '@parcel/watcher-darwin-arm64': 2.5.6
+ '@parcel/watcher-darwin-x64': 2.5.6
+ '@parcel/watcher-freebsd-x64': 2.5.6
+ '@parcel/watcher-linux-arm-glibc': 2.5.6
+ '@parcel/watcher-linux-arm-musl': 2.5.6
+ '@parcel/watcher-linux-arm64-glibc': 2.5.6
+ '@parcel/watcher-linux-arm64-musl': 2.5.6
+ '@parcel/watcher-linux-x64-glibc': 2.5.6
+ '@parcel/watcher-linux-x64-musl': 2.5.6
+ '@parcel/watcher-win32-arm64': 2.5.6
+ '@parcel/watcher-win32-ia32': 2.5.6
+ '@parcel/watcher-win32-x64': 2.5.6
+
+ '@pkgjs/parseargs@0.11.0':
+ optional: true
+
+ '@playwright/test@1.60.0':
+ dependencies:
+ playwright: 1.60.0
+
+ '@pnpm/constants@10.0.0': {}
+
+ '@pnpm/constants@1001.3.1': {}
+
+ '@pnpm/core-loggers@1001.0.9(@pnpm/logger@1001.0.1)':
+ dependencies:
+ '@pnpm/logger': 1001.0.1
+ '@pnpm/types': 1001.3.0
+
+ '@pnpm/error@1000.1.0':
+ dependencies:
+ '@pnpm/constants': 1001.3.1
+
+ '@pnpm/error@6.0.3':
+ dependencies:
+ '@pnpm/constants': 10.0.0
+
+ '@pnpm/graceful-fs@1000.1.0':
+ dependencies:
+ graceful-fs: 4.2.11
+
+ '@pnpm/logger@1001.0.1':
+ dependencies:
+ bole: 5.0.29
+ split2: 4.2.0
+
+ '@pnpm/manifest-utils@1002.0.5(@pnpm/logger@1001.0.1)':
+ dependencies:
+ '@pnpm/core-loggers': 1001.0.9(@pnpm/logger@1001.0.1)
+ '@pnpm/error': 1000.1.0
+ '@pnpm/logger': 1001.0.1
+ '@pnpm/semver.peer-range': 1000.0.0
+ '@pnpm/types': 1001.3.0
+ semver: 7.8.0
+
+ '@pnpm/read-project-manifest@1001.2.6(@pnpm/logger@1001.0.1)':
+ dependencies:
+ '@gwhitney/detect-indent': 7.0.1
+ '@pnpm/error': 1000.1.0
+ '@pnpm/graceful-fs': 1000.1.0
+ '@pnpm/logger': 1001.0.1
+ '@pnpm/manifest-utils': 1002.0.5(@pnpm/logger@1001.0.1)
+ '@pnpm/text.comments-parser': 1000.0.0
+ '@pnpm/types': 1001.3.0
+ '@pnpm/write-project-manifest': 1000.0.16
+ fast-deep-equal: 3.1.3
+ is-windows: 1.0.2
+ json5: 2.2.3
+ parse-json: 5.2.0
+ read-yaml-file: 2.1.0
+ strip-bom: 4.0.0
+
+ '@pnpm/semver.peer-range@1000.0.0':
+ dependencies:
+ semver: 7.8.0
+
+ '@pnpm/text.comments-parser@1000.0.0':
+ dependencies:
+ strip-comments-strings: 1.2.0
+
+ '@pnpm/types@1001.3.0': {}
+
+ '@pnpm/workspace.read-manifest@2.2.2':
+ dependencies:
+ '@pnpm/constants': 10.0.0
+ '@pnpm/error': 6.0.3
+ read-yaml-file: 2.1.0
+
+ '@pnpm/write-project-manifest@1000.0.16':
+ dependencies:
+ '@pnpm/text.comments-parser': 1000.0.0
+ '@pnpm/types': 1001.3.0
+ json5: 2.2.3
+ write-file-atomic: 5.0.1
+ write-yaml-file: 5.0.0
+
+ '@polka/url@1.0.0-next.29': {}
+
+ '@poppinss/colors@4.1.6':
+ dependencies:
+ kleur: 4.1.5
+
+ '@poppinss/dumper@0.7.0':
+ dependencies:
+ '@poppinss/colors': 4.1.6
+ '@sindresorhus/is': 7.2.0
+ supports-color: 10.2.2
+
+ '@poppinss/exception@1.2.3': {}
+
+ '@publint/pack@0.1.4': {}
+
+ '@quansync/fs@1.0.0':
+ dependencies:
+ quansync: 1.0.0
+
+ '@rolldown/binding-android-arm64@1.0.0':
+ optional: true
+
+ '@rolldown/binding-android-arm64@1.0.2':
+ optional: true
+
+ '@rolldown/binding-darwin-arm64@1.0.0':
+ optional: true
+
+ '@rolldown/binding-darwin-arm64@1.0.2':
+ optional: true
+
+ '@rolldown/binding-darwin-x64@1.0.0':
+ optional: true
+
+ '@rolldown/binding-darwin-x64@1.0.2':
+ optional: true
+
+ '@rolldown/binding-freebsd-x64@1.0.0':
+ optional: true
+
+ '@rolldown/binding-freebsd-x64@1.0.2':
+ optional: true
+
+ '@rolldown/binding-linux-arm-gnueabihf@1.0.0':
+ optional: true
+
+ '@rolldown/binding-linux-arm-gnueabihf@1.0.2':
+ optional: true
+
+ '@rolldown/binding-linux-arm64-gnu@1.0.0':
+ optional: true
+
+ '@rolldown/binding-linux-arm64-gnu@1.0.2':
+ optional: true
+
+ '@rolldown/binding-linux-arm64-musl@1.0.0':
+ optional: true
+
+ '@rolldown/binding-linux-arm64-musl@1.0.2':
+ optional: true
+
+ '@rolldown/binding-linux-ppc64-gnu@1.0.0':
+ optional: true
+
+ '@rolldown/binding-linux-ppc64-gnu@1.0.2':
+ optional: true
+
+ '@rolldown/binding-linux-s390x-gnu@1.0.0':
+ optional: true
+
+ '@rolldown/binding-linux-s390x-gnu@1.0.2':
+ optional: true
+
+ '@rolldown/binding-linux-x64-gnu@1.0.0':
+ optional: true
+
+ '@rolldown/binding-linux-x64-gnu@1.0.2':
+ optional: true
+
+ '@rolldown/binding-linux-x64-musl@1.0.0':
+ optional: true
+
+ '@rolldown/binding-linux-x64-musl@1.0.2':
+ optional: true
+
+ '@rolldown/binding-openharmony-arm64@1.0.0':
+ optional: true
+
+ '@rolldown/binding-openharmony-arm64@1.0.2':
+ optional: true
+
+ '@rolldown/binding-wasm32-wasi@1.0.0':
+ dependencies:
+ '@emnapi/core': 1.10.0
+ '@emnapi/runtime': 1.10.0
+ '@napi-rs/wasm-runtime': 1.1.4(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0)
+ optional: true
+
+ '@rolldown/binding-wasm32-wasi@1.0.2':
+ dependencies:
+ '@emnapi/core': 1.10.0
+ '@emnapi/runtime': 1.10.0
+ '@napi-rs/wasm-runtime': 1.1.4(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0)
+ optional: true
+
+ '@rolldown/binding-win32-arm64-msvc@1.0.0':
+ optional: true
+
+ '@rolldown/binding-win32-arm64-msvc@1.0.2':
+ optional: true
+
+ '@rolldown/binding-win32-x64-msvc@1.0.0':
+ optional: true
+
+ '@rolldown/binding-win32-x64-msvc@1.0.2':
+ optional: true
+
+ '@rolldown/debug@1.0.2': {}
+
+ '@rolldown/pluginutils@1.0.0': {}
+
+ '@rolldown/pluginutils@1.0.1': {}
+
+ '@rollup/plugin-alias@5.1.1(rollup@4.60.4)':
+ optionalDependencies:
+ rollup: 4.60.4
+
+ '@rollup/plugin-alias@6.0.0(rollup@4.60.4)':
+ optionalDependencies:
+ rollup: 4.60.4
+
+ '@rollup/plugin-babel@7.0.0(@babel/core@7.29.0)(@types/babel__core@7.20.5)(rollup@4.60.4)':
+ dependencies:
+ '@babel/core': 7.29.0
+ '@babel/helper-module-imports': 7.28.6
+ '@rollup/pluginutils': 5.3.0(rollup@4.60.4)
+ optionalDependencies:
+ '@types/babel__core': 7.20.5
+ rollup: 4.60.4
+ transitivePeerDependencies:
+ - supports-color
+
+ '@rollup/plugin-commonjs@28.0.9(rollup@4.60.4)':
+ dependencies:
+ '@rollup/pluginutils': 5.3.0(rollup@4.60.4)
+ commondir: 1.0.1
+ estree-walker: 2.0.2
+ fdir: 6.5.0(picomatch@4.0.4)
+ is-reference: 1.2.1
+ magic-string: 0.30.21
+ picomatch: 4.0.4
+ optionalDependencies:
+ rollup: 4.60.4
+
+ '@rollup/plugin-commonjs@29.0.2(rollup@4.60.4)':
+ dependencies:
+ '@rollup/pluginutils': 5.3.0(rollup@4.60.4)
+ commondir: 1.0.1
+ estree-walker: 2.0.2
+ fdir: 6.5.0(picomatch@4.0.4)
+ is-reference: 1.2.1
+ magic-string: 0.30.21
+ picomatch: 4.0.4
+ optionalDependencies:
+ rollup: 4.60.4
+
+ '@rollup/plugin-inject@5.0.5(rollup@4.60.4)':
+ dependencies:
+ '@rollup/pluginutils': 5.3.0(rollup@4.60.4)
+ estree-walker: 2.0.2
+ magic-string: 0.30.21
+ optionalDependencies:
+ rollup: 4.60.4
+
+ '@rollup/plugin-json@6.1.0(rollup@4.60.4)':
+ dependencies:
+ '@rollup/pluginutils': 5.3.0(rollup@4.60.4)
+ optionalDependencies:
+ rollup: 4.60.4
+
+ '@rollup/plugin-node-resolve@16.0.3(rollup@4.60.4)':
+ dependencies:
+ '@rollup/pluginutils': 5.3.0(rollup@4.60.4)
+ '@types/resolve': 1.20.2
+ deepmerge: 4.3.1
+ is-module: 1.0.0
+ resolve: 1.22.12
+ optionalDependencies:
+ rollup: 4.60.4
+
+ '@rollup/plugin-replace@6.0.3(rollup@4.60.4)':
+ dependencies:
+ '@rollup/pluginutils': 5.3.0(rollup@4.60.4)
+ magic-string: 0.30.21
+ optionalDependencies:
+ rollup: 4.60.4
+
+ '@rollup/plugin-terser@1.0.0(rollup@4.60.4)':
+ dependencies:
+ serialize-javascript: 7.0.5
+ smob: 1.6.2
+ terser: 5.48.0
+ optionalDependencies:
+ rollup: 4.60.4
+
+ '@rollup/pluginutils@5.3.0(rollup@4.60.4)':
+ dependencies:
+ '@types/estree': 1.0.9
+ estree-walker: 2.0.2
+ picomatch: 4.0.4
+ optionalDependencies:
+ rollup: 4.60.4
+
+ '@rollup/rollup-android-arm-eabi@4.60.4':
+ optional: true
+
+ '@rollup/rollup-android-arm64@4.60.4':
+ optional: true
+
+ '@rollup/rollup-darwin-arm64@4.60.4':
+ optional: true
+
+ '@rollup/rollup-darwin-x64@4.60.4':
+ optional: true
+
+ '@rollup/rollup-freebsd-arm64@4.60.4':
+ optional: true
+
+ '@rollup/rollup-freebsd-x64@4.60.4':
+ optional: true
+
+ '@rollup/rollup-linux-arm-gnueabihf@4.60.4':
+ optional: true
+
+ '@rollup/rollup-linux-arm-musleabihf@4.60.4':
+ optional: true
+
+ '@rollup/rollup-linux-arm64-gnu@4.60.4':
+ optional: true
+
+ '@rollup/rollup-linux-arm64-musl@4.60.4':
+ optional: true
+
+ '@rollup/rollup-linux-loong64-gnu@4.60.4':
+ optional: true
+
+ '@rollup/rollup-linux-loong64-musl@4.60.4':
+ optional: true
+
+ '@rollup/rollup-linux-ppc64-gnu@4.60.4':
+ optional: true
+
+ '@rollup/rollup-linux-ppc64-musl@4.60.4':
+ optional: true
+
+ '@rollup/rollup-linux-riscv64-gnu@4.60.4':
+ optional: true
+
+ '@rollup/rollup-linux-riscv64-musl@4.60.4':
+ optional: true
+
+ '@rollup/rollup-linux-s390x-gnu@4.60.4':
+ optional: true
+
+ '@rollup/rollup-linux-x64-gnu@4.60.4':
+ optional: true
+
+ '@rollup/rollup-linux-x64-musl@4.60.4':
+ optional: true
+
+ '@rollup/rollup-openbsd-x64@4.60.4':
+ optional: true
+
+ '@rollup/rollup-openharmony-arm64@4.60.4':
+ optional: true
+
+ '@rollup/rollup-win32-arm64-msvc@4.60.4':
+ optional: true
+
+ '@rollup/rollup-win32-ia32-msvc@4.60.4':
+ optional: true
+
+ '@rollup/rollup-win32-x64-gnu@4.60.4':
+ optional: true
+
+ '@rollup/rollup-win32-x64-msvc@4.60.4':
+ optional: true
+
+ '@rspack/binding-darwin-arm64@2.0.3':
+ optional: true
+
+ '@rspack/binding-darwin-x64@2.0.3':
+ optional: true
+
+ '@rspack/binding-linux-arm64-gnu@2.0.3':
+ optional: true
+
+ '@rspack/binding-linux-arm64-musl@2.0.3':
+ optional: true
+
+ '@rspack/binding-linux-x64-gnu@2.0.3':
+ optional: true
+
+ '@rspack/binding-linux-x64-musl@2.0.3':
+ optional: true
+
+ '@rspack/binding-wasm32-wasi@2.0.3':
+ dependencies:
+ '@emnapi/core': 1.10.0
+ '@emnapi/runtime': 1.10.0
+ '@napi-rs/wasm-runtime': 1.1.4(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0)
+ optional: true
+
+ '@rspack/binding-win32-arm64-msvc@2.0.3':
+ optional: true
+
+ '@rspack/binding-win32-ia32-msvc@2.0.3':
+ optional: true
+
+ '@rspack/binding-win32-x64-msvc@2.0.3':
+ optional: true
+
+ '@rspack/binding@2.0.3':
+ optionalDependencies:
+ '@rspack/binding-darwin-arm64': 2.0.3
+ '@rspack/binding-darwin-x64': 2.0.3
+ '@rspack/binding-linux-arm64-gnu': 2.0.3
+ '@rspack/binding-linux-arm64-musl': 2.0.3
+ '@rspack/binding-linux-x64-gnu': 2.0.3
+ '@rspack/binding-linux-x64-musl': 2.0.3
+ '@rspack/binding-wasm32-wasi': 2.0.3
+ '@rspack/binding-win32-arm64-msvc': 2.0.3
+ '@rspack/binding-win32-ia32-msvc': 2.0.3
+ '@rspack/binding-win32-x64-msvc': 2.0.3
+
+ '@rspack/core@2.0.3':
+ dependencies:
+ '@rspack/binding': 2.0.3
+
+ '@rspack/lite-tapable@1.1.0': {}
+
+ '@shikijs/core@4.1.0':
+ dependencies:
+ '@shikijs/primitive': 4.1.0
+ '@shikijs/types': 4.1.0
+ '@shikijs/vscode-textmate': 10.0.2
+ '@types/hast': 3.0.4
+ hast-util-to-html: 9.0.5
+
+ '@shikijs/engine-javascript@4.1.0':
+ dependencies:
+ '@shikijs/types': 4.1.0
+ '@shikijs/vscode-textmate': 10.0.2
+ oniguruma-to-es: 4.3.6
+
+ '@shikijs/engine-oniguruma@4.1.0':
+ dependencies:
+ '@shikijs/types': 4.1.0
+ '@shikijs/vscode-textmate': 10.0.2
+
+ '@shikijs/langs@4.1.0':
+ dependencies:
+ '@shikijs/types': 4.1.0
+
+ '@shikijs/primitive@4.1.0':
+ dependencies:
+ '@shikijs/types': 4.1.0
+ '@shikijs/vscode-textmate': 10.0.2
+ '@types/hast': 3.0.4
+
+ '@shikijs/themes@4.1.0':
+ dependencies:
+ '@shikijs/types': 4.1.0
+
+ '@shikijs/transformers@4.1.0':
+ dependencies:
+ '@shikijs/core': 4.1.0
+ '@shikijs/types': 4.1.0
+
+ '@shikijs/twoslash@4.1.0(typescript@5.9.3)':
+ dependencies:
+ '@shikijs/core': 4.1.0
+ '@shikijs/types': 4.1.0
+ twoslash: 0.3.8(typescript@5.9.3)
+ typescript: 5.9.3
+ transitivePeerDependencies:
+ - supports-color
+
+ '@shikijs/types@4.1.0':
+ dependencies:
+ '@shikijs/vscode-textmate': 10.0.2
+ '@types/hast': 3.0.4
+
+ '@shikijs/vitepress-twoslash@4.1.0(@nuxt/kit@packages+kit)(typescript@5.9.3)':
+ dependencies:
+ '@shikijs/twoslash': 4.1.0(typescript@5.9.3)
+ floating-vue: 5.2.2(@nuxt/kit@packages+kit)(vue@3.5.34(typescript@6.0.3))
+ lz-string: 1.5.0
+ magic-string: 0.30.21
+ markdown-it: 14.1.1
+ mdast-util-from-markdown: 2.0.3
+ mdast-util-gfm: 3.1.0
+ mdast-util-to-hast: 13.2.1
+ ohash: 2.0.11
+ shiki: 4.1.0
+ twoslash: 0.3.8(typescript@5.9.3)
+ twoslash-vue: 0.3.8(typescript@5.9.3)
+ vue: 3.5.34(typescript@5.9.3)
+ transitivePeerDependencies:
+ - '@nuxt/kit'
+ - supports-color
+ - typescript
+
+ '@shikijs/vscode-textmate@10.0.2': {}
+
+ '@sidvind/better-ajv-errors@7.0.0(ajv@8.20.0)':
+ dependencies:
+ ajv: 8.20.0
+
+ '@sinclair/typebox@0.34.49': {}
+
+ '@sindresorhus/base62@1.0.0': {}
+
+ '@sindresorhus/is@4.6.0': {}
+
+ '@sindresorhus/is@7.2.0': {}
+
+ '@sindresorhus/merge-streams@4.0.0': {}
+
+ '@speed-highlight/core@1.2.15': {}
+
+ '@standard-schema/spec@1.1.0': {}
+
+ '@stylistic/eslint-plugin@5.10.0(eslint@9.39.4(jiti@2.7.0))':
+ dependencies:
+ '@eslint-community/eslint-utils': 4.9.1(eslint@9.39.4(jiti@2.7.0))
+ '@typescript-eslint/types': 8.59.4
+ eslint: 9.39.4(jiti@2.7.0)
+ eslint-visitor-keys: 4.2.1
+ espree: 10.4.0
+ estraverse: 5.3.0
+ picomatch: 4.0.4
+
+ '@testing-library/dom@9.3.4':
+ dependencies:
+ '@babel/code-frame': 7.29.0
+ '@babel/runtime': 7.29.2
+ '@types/aria-query': 5.0.4
+ aria-query: 5.1.3
+ chalk: 4.1.2
+ dom-accessibility-api: 0.5.16
+ lz-string: 1.5.0
+ pretty-format: 27.5.1
+
+ '@testing-library/vue@8.1.0(@vue/compiler-dom@3.5.34)(@vue/compiler-sfc@3.5.34)(@vue/server-renderer@3.5.34(vue@3.5.34(typescript@6.0.3)))(vue@3.5.34(typescript@6.0.3))':
+ dependencies:
+ '@babel/runtime': 7.29.2
+ '@testing-library/dom': 9.3.4
+ '@vue/test-utils': 2.4.10(@vue/compiler-dom@3.5.34)(@vue/server-renderer@3.5.34(vue@3.5.34(typescript@6.0.3)))(vue@3.5.34(typescript@6.0.3))
+ vue: 3.5.34(typescript@6.0.3)
+ optionalDependencies:
+ '@vue/compiler-sfc': 3.5.34
+ transitivePeerDependencies:
+ - '@vue/compiler-dom'
+ - '@vue/server-renderer'
+
+ '@tybys/wasm-util@0.10.2':
+ dependencies:
+ tslib: 2.8.1
+ optional: true
+
+ '@types/aria-query@5.0.4': {}
+
+ '@types/babel__core@7.20.5':
+ dependencies:
+ '@babel/parser': 7.29.3
+ '@babel/types': 7.29.0
+ '@types/babel__generator': 7.27.0
+ '@types/babel__template': 7.4.4
+ '@types/babel__traverse': 7.28.0
+
+ '@types/babel__generator@7.27.0':
+ dependencies:
+ '@babel/types': 7.29.0
+
+ '@types/babel__helper-plugin-utils@7.10.3':
+ dependencies:
+ '@types/babel__core': 7.20.5
+
+ '@types/babel__template@7.4.4':
+ dependencies:
+ '@babel/parser': 7.29.3
+ '@babel/types': 7.29.0
+
+ '@types/babel__traverse@7.28.0':
+ dependencies:
+ '@babel/types': 7.29.0
+
+ '@types/chai@5.2.3':
+ dependencies:
+ '@types/deep-eql': 4.0.2
+ assertion-error: 2.0.1
+
+ '@types/connect@3.4.38':
+ dependencies:
+ '@types/node': 24.12.4
+
+ '@types/debug@4.1.13':
+ dependencies:
+ '@types/ms': 2.1.0
+
+ '@types/deep-eql@4.0.2': {}
+
+ '@types/eslint-scope@3.7.7':
+ dependencies:
+ '@types/eslint': 9.6.1
+ '@types/estree': 1.0.9
+
+ '@types/eslint@9.6.1':
+ dependencies:
+ '@types/estree': 1.0.9
+ '@types/json-schema': 7.0.15
+
+ '@types/esrecurse@4.3.1': {}
+
+ '@types/estree@1.0.8': {}
+
+ '@types/estree@1.0.9': {}
+
+ '@types/hast@3.0.4':
+ dependencies:
+ '@types/unist': 3.0.3
+
+ '@types/istanbul-lib-coverage@2.0.6': {}
+
+ '@types/istanbul-lib-report@3.0.3':
+ dependencies:
+ '@types/istanbul-lib-coverage': 2.0.6
+
+ '@types/istanbul-reports@3.0.4':
+ dependencies:
+ '@types/istanbul-lib-report': 3.0.3
+
+ '@types/jsesc@2.5.1': {}
+
+ '@types/json-schema@7.0.15': {}
+
+ '@types/katex@0.16.8': {}
+
+ '@types/mdast@4.0.4':
+ dependencies:
+ '@types/unist': 3.0.3
+
+ '@types/ms@2.1.0': {}
+
+ '@types/node@24.12.4':
+ dependencies:
+ undici-types: 7.16.0
+
+ '@types/normalize-package-data@2.4.4': {}
+
+ '@types/picomatch@4.0.3': {}
+
+ '@types/pug@2.0.10': {}
+
+ '@types/relateurl@0.2.33': {}
+
+ '@types/resolve@1.20.2': {}
+
+ '@types/semver@7.7.1': {}
+
+ '@types/unist@2.0.11': {}
+
+ '@types/unist@3.0.3': {}
+
+ '@types/web-bluetooth@0.0.21': {}
+
+ '@types/webpack-bundle-analyzer@4.7.0(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)':
+ dependencies:
+ '@types/node': 24.12.4
+ tapable: 2.3.3
+ webpack: 5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)
+ transitivePeerDependencies:
+ - '@minify-html/node'
+ - '@swc/core'
+ - '@swc/css'
+ - '@swc/html'
+ - clean-css
+ - cssnano
+ - csso
+ - esbuild
+ - html-minifier-terser
+ - lightningcss
+ - postcss
+ - uglify-js
+ - webpack-cli
+
+ '@types/webpack-hot-middleware@2.25.12(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)':
+ dependencies:
+ '@types/connect': 3.4.38
+ tapable: 2.3.3
+ webpack: 5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)
+ transitivePeerDependencies:
+ - '@minify-html/node'
+ - '@swc/core'
+ - '@swc/css'
+ - '@swc/html'
+ - clean-css
+ - cssnano
+ - csso
+ - esbuild
+ - html-minifier-terser
+ - lightningcss
+ - postcss
+ - uglify-js
+ - webpack-cli
+
+ '@types/whatwg-mimetype@3.0.2': {}
+
+ '@types/ws@8.18.1':
+ dependencies:
+ '@types/node': 24.12.4
+
+ '@types/yargs-parser@21.0.3': {}
+
+ '@types/yargs@17.0.35':
+ dependencies:
+ '@types/yargs-parser': 21.0.3
+
+ '@typescript-eslint/eslint-plugin@8.59.4(@typescript-eslint/parser@8.59.3(eslint@9.39.4(jiti@2.7.0))(typescript@6.0.3))(eslint@9.39.4(jiti@2.7.0))(typescript@6.0.3)':
+ dependencies:
+ '@eslint-community/regexpp': 4.12.2
+ '@typescript-eslint/parser': 8.59.3(eslint@9.39.4(jiti@2.7.0))(typescript@6.0.3)
+ '@typescript-eslint/scope-manager': 8.59.4
+ '@typescript-eslint/type-utils': 8.59.4(eslint@9.39.4(jiti@2.7.0))(typescript@6.0.3)
+ '@typescript-eslint/utils': 8.59.4(eslint@9.39.4(jiti@2.7.0))(typescript@6.0.3)
+ '@typescript-eslint/visitor-keys': 8.59.4
+ eslint: 9.39.4(jiti@2.7.0)
+ ignore: 7.0.5
+ natural-compare: 1.4.0
+ ts-api-utils: 2.5.0(typescript@6.0.3)
+ typescript: 6.0.3
+ transitivePeerDependencies:
+ - supports-color
+
+ '@typescript-eslint/parser@8.59.3(eslint@9.39.4(jiti@2.7.0))(typescript@6.0.3)':
+ dependencies:
+ '@typescript-eslint/scope-manager': 8.59.3
+ '@typescript-eslint/types': 8.59.3
+ '@typescript-eslint/typescript-estree': 8.59.3(typescript@6.0.3)
+ '@typescript-eslint/visitor-keys': 8.59.3
+ debug: 4.4.3
+ eslint: 9.39.4(jiti@2.7.0)
+ typescript: 6.0.3
+ transitivePeerDependencies:
+ - supports-color
+
+ '@typescript-eslint/project-service@8.59.3(typescript@6.0.3)':
+ dependencies:
+ '@typescript-eslint/tsconfig-utils': 8.59.4(typescript@6.0.3)
+ '@typescript-eslint/types': 8.59.4
+ debug: 4.4.3
+ typescript: 6.0.3
+ transitivePeerDependencies:
+ - supports-color
+
+ '@typescript-eslint/project-service@8.59.4(typescript@6.0.3)':
+ dependencies:
+ '@typescript-eslint/tsconfig-utils': 8.59.4(typescript@6.0.3)
+ '@typescript-eslint/types': 8.59.4
+ debug: 4.4.3
+ typescript: 6.0.3
+ transitivePeerDependencies:
+ - supports-color
+
+ '@typescript-eslint/scope-manager@8.59.3':
+ dependencies:
+ '@typescript-eslint/types': 8.59.3
+ '@typescript-eslint/visitor-keys': 8.59.3
+
+ '@typescript-eslint/scope-manager@8.59.4':
+ dependencies:
+ '@typescript-eslint/types': 8.59.4
+ '@typescript-eslint/visitor-keys': 8.59.4
+
+ '@typescript-eslint/tsconfig-utils@8.59.3(typescript@6.0.3)':
+ dependencies:
+ typescript: 6.0.3
+
+ '@typescript-eslint/tsconfig-utils@8.59.4(typescript@6.0.3)':
+ dependencies:
+ typescript: 6.0.3
+
+ '@typescript-eslint/type-utils@8.59.4(eslint@9.39.4(jiti@2.7.0))(typescript@6.0.3)':
+ dependencies:
+ '@typescript-eslint/types': 8.59.4
+ '@typescript-eslint/typescript-estree': 8.59.4(typescript@6.0.3)
+ '@typescript-eslint/utils': 8.59.4(eslint@9.39.4(jiti@2.7.0))(typescript@6.0.3)
+ debug: 4.4.3
+ eslint: 9.39.4(jiti@2.7.0)
+ ts-api-utils: 2.5.0(typescript@6.0.3)
+ typescript: 6.0.3
+ transitivePeerDependencies:
+ - supports-color
+
+ '@typescript-eslint/types@8.59.3': {}
+
+ '@typescript-eslint/types@8.59.4': {}
+
+ '@typescript-eslint/typescript-estree@8.59.3(typescript@6.0.3)':
+ dependencies:
+ '@typescript-eslint/project-service': 8.59.3(typescript@6.0.3)
+ '@typescript-eslint/tsconfig-utils': 8.59.3(typescript@6.0.3)
+ '@typescript-eslint/types': 8.59.3
+ '@typescript-eslint/visitor-keys': 8.59.3
+ debug: 4.4.3
+ minimatch: 10.2.5
+ semver: 7.8.0
+ tinyglobby: 0.2.16
+ ts-api-utils: 2.5.0(typescript@6.0.3)
+ typescript: 6.0.3
+ transitivePeerDependencies:
+ - supports-color
+
+ '@typescript-eslint/typescript-estree@8.59.4(typescript@6.0.3)':
+ dependencies:
+ '@typescript-eslint/project-service': 8.59.4(typescript@6.0.3)
+ '@typescript-eslint/tsconfig-utils': 8.59.4(typescript@6.0.3)
+ '@typescript-eslint/types': 8.59.4
+ '@typescript-eslint/visitor-keys': 8.59.4
+ debug: 4.4.3
+ minimatch: 10.2.5
+ semver: 7.8.0
+ tinyglobby: 0.2.16
+ ts-api-utils: 2.5.0(typescript@6.0.3)
+ typescript: 6.0.3
+ transitivePeerDependencies:
+ - supports-color
+
+ '@typescript-eslint/utils@8.59.4(eslint@9.39.4(jiti@2.7.0))(typescript@6.0.3)':
+ dependencies:
+ '@eslint-community/eslint-utils': 4.9.1(eslint@9.39.4(jiti@2.7.0))
+ '@typescript-eslint/scope-manager': 8.59.4
+ '@typescript-eslint/types': 8.59.4
+ '@typescript-eslint/typescript-estree': 8.59.4(typescript@6.0.3)
+ eslint: 9.39.4(jiti@2.7.0)
+ typescript: 6.0.3
+ transitivePeerDependencies:
+ - supports-color
+
+ '@typescript-eslint/visitor-keys@8.59.3':
+ dependencies:
+ '@typescript-eslint/types': 8.59.3
+ eslint-visitor-keys: 5.0.1
+
+ '@typescript-eslint/visitor-keys@8.59.4':
+ dependencies:
+ '@typescript-eslint/types': 8.59.4
+ eslint-visitor-keys: 5.0.1
+
+ '@typescript/vfs@1.6.4(typescript@5.9.3)':
+ dependencies:
+ debug: 4.4.3
+ typescript: 5.9.3
+ transitivePeerDependencies:
+ - supports-color
+
+ '@ungap/structured-clone@1.3.1': {}
+
+ '@unhead/bundler@3.1.0(crossws@0.4.5(srvx@0.11.15))(esbuild@0.28.0)(lightningcss@1.32.0)(rolldown@1.0.2)(typescript@6.0.3)(unhead@3.1.0(vite@8.0.12))(vite@8.0.12)(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))':
+ dependencies:
+ '@vitejs/devtools-kit': 0.1.24(crossws@0.4.5(srvx@0.11.15))(typescript@6.0.3)(vite@8.0.12)
+ magic-string: 0.30.21
+ oxc-parser: 0.127.0
+ oxc-walker: 0.7.0(oxc-parser@0.127.0)
+ ufo: 1.6.4
+ unhead: 3.1.0(vite@8.0.12)
+ unplugin: 3.0.0
+ optionalDependencies:
+ esbuild: 0.28.0
+ lightningcss: 1.32.0
+ rolldown: 1.0.2
+ vite: 8.0.12(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0)
+ webpack: 5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)
+ transitivePeerDependencies:
+ - '@modelcontextprotocol/sdk'
+ - bufferutil
+ - crossws
+ - typescript
+ - utf-8-validate
+
+ '@unhead/bundler@3.1.0(crossws@0.4.5(srvx@0.11.15))(esbuild@0.28.0)(lightningcss@1.32.0)(rolldown@1.0.2)(typescript@6.0.3)(unhead@3.1.0(vite@8.0.12))(vite@8.0.12)(webpack@5.106.2(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))':
+ dependencies:
+ '@vitejs/devtools-kit': 0.1.24(crossws@0.4.5(srvx@0.11.15))(typescript@6.0.3)(vite@8.0.12)
+ magic-string: 0.30.21
+ oxc-parser: 0.127.0
+ oxc-walker: 0.7.0(oxc-parser@0.127.0)
+ ufo: 1.6.4
+ unhead: 3.1.0(vite@8.0.12)
+ unplugin: 3.0.0
+ optionalDependencies:
+ esbuild: 0.28.0
+ lightningcss: 1.32.0
+ rolldown: 1.0.2
+ vite: 8.0.12(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0)
+ webpack: 5.106.2(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)
+ transitivePeerDependencies:
+ - '@modelcontextprotocol/sdk'
+ - bufferutil
+ - crossws
+ - typescript
+ - utf-8-validate
+
+ '@unhead/bundler@3.1.0(crossws@0.4.5(srvx@0.11.15))(esbuild@0.28.0)(lightningcss@1.32.0)(rolldown@1.0.2)(typescript@6.0.3)(unhead@3.1.0(vite@8.0.12))(vite@8.0.12)(webpack@5.106.2(esbuild@0.28.0)(lightningcss@1.32.0))':
+ dependencies:
+ '@vitejs/devtools-kit': 0.1.24(crossws@0.4.5(srvx@0.11.15))(typescript@6.0.3)(vite@8.0.12)
+ magic-string: 0.30.21
+ oxc-parser: 0.127.0
+ oxc-walker: 0.7.0(oxc-parser@0.127.0)
+ ufo: 1.6.4
+ unhead: 3.1.0(vite@8.0.12)
+ unplugin: 3.0.0
+ optionalDependencies:
+ esbuild: 0.28.0
+ lightningcss: 1.32.0
+ rolldown: 1.0.2
+ vite: 8.0.12(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0)
+ webpack: 5.106.2(esbuild@0.28.0)(lightningcss@1.32.0)
+ transitivePeerDependencies:
+ - '@modelcontextprotocol/sdk'
+ - bufferutil
+ - crossws
+ - typescript
+ - utf-8-validate
+
+ '@unhead/vue@3.1.0(crossws@0.4.5(srvx@0.11.15))(esbuild@0.28.0)(lightningcss@1.32.0)(rolldown@1.0.2)(typescript@6.0.3)(vite@8.0.12)(vue@3.5.34(typescript@6.0.3))(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))':
+ dependencies:
+ '@unhead/bundler': 3.1.0(crossws@0.4.5(srvx@0.11.15))(esbuild@0.28.0)(lightningcss@1.32.0)(rolldown@1.0.2)(typescript@6.0.3)(unhead@3.1.0(vite@8.0.12))(vite@8.0.12)(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ hookable: 6.1.1
+ unhead: 3.1.0(vite@8.0.12)
+ unplugin: 3.0.0
+ vue: 3.5.34(typescript@6.0.3)
+ optionalDependencies:
+ vite: 8.0.12(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0)
+ webpack: 5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)
+ transitivePeerDependencies:
+ - '@modelcontextprotocol/sdk'
+ - '@unhead/cli'
+ - bufferutil
+ - crossws
+ - esbuild
+ - lightningcss
+ - rolldown
+ - typescript
+ - utf-8-validate
+
+ '@unhead/vue@3.1.0(crossws@0.4.5(srvx@0.11.15))(esbuild@0.28.0)(lightningcss@1.32.0)(rolldown@1.0.2)(typescript@6.0.3)(vite@8.0.12)(vue@3.5.34(typescript@6.0.3))(webpack@5.106.2(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))':
+ dependencies:
+ '@unhead/bundler': 3.1.0(crossws@0.4.5(srvx@0.11.15))(esbuild@0.28.0)(lightningcss@1.32.0)(rolldown@1.0.2)(typescript@6.0.3)(unhead@3.1.0(vite@8.0.12))(vite@8.0.12)(webpack@5.106.2(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ hookable: 6.1.1
+ unhead: 3.1.0(vite@8.0.12)
+ unplugin: 3.0.0
+ vue: 3.5.34(typescript@6.0.3)
+ optionalDependencies:
+ vite: 8.0.12(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0)
+ webpack: 5.106.2(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)
+ transitivePeerDependencies:
+ - '@modelcontextprotocol/sdk'
+ - '@unhead/cli'
+ - bufferutil
+ - crossws
+ - esbuild
+ - lightningcss
+ - rolldown
+ - typescript
+ - utf-8-validate
+
+ '@unhead/vue@3.1.0(crossws@0.4.5(srvx@0.11.15))(esbuild@0.28.0)(lightningcss@1.32.0)(rolldown@1.0.2)(typescript@6.0.3)(vite@8.0.12)(vue@3.5.34(typescript@6.0.3))(webpack@5.106.2(esbuild@0.28.0)(lightningcss@1.32.0))':
+ dependencies:
+ '@unhead/bundler': 3.1.0(crossws@0.4.5(srvx@0.11.15))(esbuild@0.28.0)(lightningcss@1.32.0)(rolldown@1.0.2)(typescript@6.0.3)(unhead@3.1.0(vite@8.0.12))(vite@8.0.12)(webpack@5.106.2(esbuild@0.28.0)(lightningcss@1.32.0))
+ hookable: 6.1.1
+ unhead: 3.1.0(vite@8.0.12)
+ unplugin: 3.0.0
+ vue: 3.5.34(typescript@6.0.3)
+ optionalDependencies:
+ vite: 8.0.12(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0)
+ webpack: 5.106.2(esbuild@0.28.0)(lightningcss@1.32.0)
+ transitivePeerDependencies:
+ - '@modelcontextprotocol/sdk'
+ - '@unhead/cli'
+ - bufferutil
+ - crossws
+ - esbuild
+ - lightningcss
+ - rolldown
+ - typescript
+ - utf-8-validate
+
+ '@unocss/cli@66.6.8':
+ dependencies:
+ '@jridgewell/remapping': 2.3.5
+ '@unocss/config': 66.6.8
+ '@unocss/core': 66.6.8
+ '@unocss/preset-wind3': 66.6.8
+ '@unocss/preset-wind4': 66.6.8
+ '@unocss/transformer-directives': 66.6.8
+ cac: 7.0.0
+ chokidar: 5.0.0
+ colorette: 2.0.20
+ consola: 3.4.2
+ magic-string: 0.30.21
+ pathe: 2.0.3
+ perfect-debounce: 2.1.0
+ tinyglobby: 0.2.16
+ unplugin-utils: 0.3.1
+
+ '@unocss/config@66.6.8':
+ dependencies:
+ '@unocss/core': 66.6.8
+ colorette: 2.0.20
+ consola: 3.4.2
+ unconfig: 7.5.0
+
+ '@unocss/core@66.6.8': {}
+
+ '@unocss/extractor-arbitrary-variants@66.6.8':
+ dependencies:
+ '@unocss/core': 66.6.8
+
+ '@unocss/inspector@66.6.8':
+ dependencies:
+ '@unocss/core': 66.6.8
+ '@unocss/rule-utils': 66.6.8
+ colorette: 2.0.20
+ gzip-size: 6.0.0
+ sirv: 3.0.2
+
+ '@unocss/preset-attributify@66.6.8':
+ dependencies:
+ '@unocss/core': 66.6.8
+
+ '@unocss/preset-icons@66.6.8':
+ dependencies:
+ '@iconify/utils': 3.1.3
+ '@unocss/core': 66.6.8
+ ofetch: 1.5.1
+
+ '@unocss/preset-mini@66.6.8':
+ dependencies:
+ '@unocss/core': 66.6.8
+ '@unocss/extractor-arbitrary-variants': 66.6.8
+ '@unocss/rule-utils': 66.6.8
+
+ '@unocss/preset-tagify@66.6.8':
+ dependencies:
+ '@unocss/core': 66.6.8
+
+ '@unocss/preset-typography@66.6.8':
+ dependencies:
+ '@unocss/core': 66.6.8
+ '@unocss/rule-utils': 66.6.8
+
+ '@unocss/preset-uno@66.6.8':
+ dependencies:
+ '@unocss/core': 66.6.8
+ '@unocss/preset-wind3': 66.6.8
+
+ '@unocss/preset-web-fonts@66.6.8':
+ dependencies:
+ '@unocss/core': 66.6.8
+ ofetch: 1.5.1
+
+ '@unocss/preset-wind3@66.6.8':
+ dependencies:
+ '@unocss/core': 66.6.8
+ '@unocss/preset-mini': 66.6.8
+ '@unocss/rule-utils': 66.6.8
+
+ '@unocss/preset-wind4@66.6.8':
+ dependencies:
+ '@unocss/core': 66.6.8
+ '@unocss/extractor-arbitrary-variants': 66.6.8
+ '@unocss/rule-utils': 66.6.8
+
+ '@unocss/preset-wind@66.6.8':
+ dependencies:
+ '@unocss/core': 66.6.8
+ '@unocss/preset-wind3': 66.6.8
+
+ '@unocss/reset@66.6.8': {}
+
+ '@unocss/rule-utils@66.6.8':
+ dependencies:
+ '@unocss/core': 66.6.8
+ magic-string: 0.30.21
+
+ '@unocss/transformer-attributify-jsx@66.6.8(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0)':
+ dependencies:
+ '@unocss/core': 66.6.8
+ oxc-parser: 0.124.0(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0)
+ oxc-walker: 0.7.0(oxc-parser@0.124.0(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0))
+ transitivePeerDependencies:
+ - '@emnapi/core'
+ - '@emnapi/runtime'
+
+ '@unocss/transformer-compile-class@66.6.8':
+ dependencies:
+ '@unocss/core': 66.6.8
+
+ '@unocss/transformer-directives@66.6.8':
+ dependencies:
+ '@unocss/core': 66.6.8
+ '@unocss/rule-utils': 66.6.8
+ css-tree: 3.2.1
+
+ '@unocss/transformer-variant-group@66.6.8':
+ dependencies:
+ '@unocss/core': 66.6.8
+
+ '@unocss/vite@66.6.8(vite@8.0.12)':
+ dependencies:
+ '@jridgewell/remapping': 2.3.5
+ '@unocss/config': 66.6.8
+ '@unocss/core': 66.6.8
+ '@unocss/inspector': 66.6.8
+ chokidar: 5.0.0
+ magic-string: 0.30.21
+ pathe: 2.0.3
+ tinyglobby: 0.2.16
+ unplugin-utils: 0.3.1
+ vite: 8.0.12(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0)
+
+ '@unrs/resolver-binding-android-arm-eabi@1.12.2':
+ optional: true
+
+ '@unrs/resolver-binding-android-arm64@1.12.2':
+ optional: true
+
+ '@unrs/resolver-binding-darwin-arm64@1.12.2':
+ optional: true
+
+ '@unrs/resolver-binding-darwin-x64@1.12.2':
+ optional: true
+
+ '@unrs/resolver-binding-freebsd-x64@1.12.2':
+ optional: true
+
+ '@unrs/resolver-binding-linux-arm-gnueabihf@1.12.2':
+ optional: true
+
+ '@unrs/resolver-binding-linux-arm-musleabihf@1.12.2':
+ optional: true
+
+ '@unrs/resolver-binding-linux-arm64-gnu@1.12.2':
+ optional: true
+
+ '@unrs/resolver-binding-linux-arm64-musl@1.12.2':
+ optional: true
+
+ '@unrs/resolver-binding-linux-loong64-gnu@1.12.2':
+ optional: true
+
+ '@unrs/resolver-binding-linux-loong64-musl@1.12.2':
+ optional: true
+
+ '@unrs/resolver-binding-linux-ppc64-gnu@1.12.2':
+ optional: true
+
+ '@unrs/resolver-binding-linux-riscv64-gnu@1.12.2':
+ optional: true
+
+ '@unrs/resolver-binding-linux-riscv64-musl@1.12.2':
+ optional: true
+
+ '@unrs/resolver-binding-linux-s390x-gnu@1.12.2':
+ optional: true
+
+ '@unrs/resolver-binding-linux-x64-gnu@1.12.2':
+ optional: true
+
+ '@unrs/resolver-binding-linux-x64-musl@1.12.2':
+ optional: true
+
+ '@unrs/resolver-binding-openharmony-arm64@1.12.2':
+ optional: true
+
+ '@unrs/resolver-binding-wasm32-wasi@1.12.2':
+ dependencies:
+ '@emnapi/core': 1.10.0
+ '@emnapi/runtime': 1.10.0
+ '@napi-rs/wasm-runtime': 1.1.4(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0)
+ optional: true
+
+ '@unrs/resolver-binding-win32-arm64-msvc@1.12.2':
+ optional: true
+
+ '@unrs/resolver-binding-win32-ia32-msvc@1.12.2':
+ optional: true
+
+ '@unrs/resolver-binding-win32-x64-msvc@1.12.2':
+ optional: true
+
+ '@valibot/to-json-schema@1.7.0(valibot@1.4.0(typescript@6.0.3))':
+ dependencies:
+ valibot: 1.4.0(typescript@6.0.3)
+
+ '@vercel/nft@1.5.0(rollup@4.60.4)':
+ dependencies:
+ '@mapbox/node-pre-gyp': 2.0.3
+ '@rollup/pluginutils': 5.3.0(rollup@4.60.4)
+ acorn: 8.16.0
+ acorn-import-attributes: 1.9.5(acorn@8.16.0)
+ async-sema: 3.1.1
+ bindings: 1.5.0
+ estree-walker: 2.0.2
+ glob: 13.0.6
+ graceful-fs: 4.2.11
+ node-gyp-build: 4.8.4
+ picomatch: 4.0.4
+ resolve-from: 5.0.0
+ transitivePeerDependencies:
+ - encoding
+ - rollup
+ - supports-color
+
+ '@vitejs/devtools-kit@0.1.24(crossws@0.4.5(srvx@0.11.15))(typescript@6.0.3)(vite@8.0.12)':
+ dependencies:
+ birpc: 4.0.0
+ devframe: 0.2.2(crossws@0.4.5(srvx@0.11.15))(typescript@6.0.3)
+ logs-sdk: 0.0.6
+ mlly: 1.8.2
+ pathe: 2.0.3
+ perfect-debounce: 2.1.0
+ tinyexec: 1.1.2
+ vite: 8.0.12(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0)
+ transitivePeerDependencies:
+ - '@modelcontextprotocol/sdk'
+ - bufferutil
+ - crossws
+ - typescript
+ - utf-8-validate
+
+ '@vitejs/devtools-rolldown@0.1.24(@pnpm/logger@1001.0.1)(crossws@0.4.5(srvx@0.11.15))(db0@0.3.4)(ioredis@5.10.1)(typescript@6.0.3)(vite@8.0.12)(vue@3.5.34(typescript@6.0.3))':
+ dependencies:
+ '@floating-ui/dom': 1.7.6
+ '@pnpm/read-project-manifest': 1001.2.6(@pnpm/logger@1001.0.1)
+ '@rolldown/debug': 1.0.2
+ '@vitejs/devtools-kit': 0.1.24(crossws@0.4.5(srvx@0.11.15))(typescript@6.0.3)(vite@8.0.12)
+ birpc: 4.0.0
+ cac: 7.0.0
+ d3-shape: 3.2.0
+ devframe: 0.2.2(crossws@0.4.5(srvx@0.11.15))(typescript@6.0.3)
+ diff: 9.0.0
+ get-port-please: 3.2.0
+ h3: 2.0.1-rc.22(crossws@0.4.5(srvx@0.11.15))
+ logs-sdk: 0.0.6
+ mlly: 1.8.2
+ mrmime: 2.0.1
+ p-limit: 7.3.0
+ pathe: 2.0.3
+ publint: 0.3.21
+ split2: 4.2.0
+ tinyglobby: 0.2.16
+ unconfig: 7.5.0
+ unstorage: 1.17.5(db0@0.3.4)(ioredis@5.10.1)
+ vue-virtual-scroller: 3.0.4(vue@3.5.34(typescript@6.0.3))
+ ws: 8.21.0
+ transitivePeerDependencies:
+ - '@azure/app-configuration'
+ - '@azure/cosmos'
+ - '@azure/data-tables'
+ - '@azure/identity'
+ - '@azure/keyvault-secrets'
+ - '@azure/storage-blob'
+ - '@capacitor/preferences'
+ - '@deno/kv'
+ - '@modelcontextprotocol/sdk'
+ - '@netlify/blobs'
+ - '@planetscale/database'
+ - '@pnpm/logger'
+ - '@upstash/redis'
+ - '@vercel/blob'
+ - '@vercel/functions'
+ - '@vercel/kv'
+ - aws4fetch
+ - bufferutil
+ - crossws
+ - db0
+ - idb-keyval
+ - ioredis
+ - typescript
+ - uploadthing
+ - utf-8-validate
+ - vite
+ - vue
+
+ '@vitejs/devtools@0.1.24(@pnpm/logger@1001.0.1)(crossws@0.4.5(srvx@0.11.15))(db0@0.3.4)(ioredis@5.10.1)(typescript@6.0.3)(vite@8.0.12)':
+ dependencies:
+ '@vitejs/devtools-kit': 0.1.24(crossws@0.4.5(srvx@0.11.15))(typescript@6.0.3)(vite@8.0.12)
+ '@vitejs/devtools-rolldown': 0.1.24(@pnpm/logger@1001.0.1)(crossws@0.4.5(srvx@0.11.15))(db0@0.3.4)(ioredis@5.10.1)(typescript@6.0.3)(vite@8.0.12)(vue@3.5.34(typescript@6.0.3))
+ birpc: 4.0.0
+ cac: 7.0.0
+ devframe: 0.2.2(crossws@0.4.5(srvx@0.11.15))(typescript@6.0.3)
+ h3: 2.0.1-rc.22(crossws@0.4.5(srvx@0.11.15))
+ logs-sdk: 0.0.6
+ mlly: 1.8.2
+ obug: 2.1.1
+ pathe: 2.0.3
+ perfect-debounce: 2.1.0
+ tinyexec: 1.1.2
+ vite: 8.0.12(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0)
+ vue: 3.5.34(typescript@6.0.3)
+ ws: 8.21.0
+ transitivePeerDependencies:
+ - '@azure/app-configuration'
+ - '@azure/cosmos'
+ - '@azure/data-tables'
+ - '@azure/identity'
+ - '@azure/keyvault-secrets'
+ - '@azure/storage-blob'
+ - '@capacitor/preferences'
+ - '@deno/kv'
+ - '@modelcontextprotocol/sdk'
+ - '@netlify/blobs'
+ - '@planetscale/database'
+ - '@pnpm/logger'
+ - '@upstash/redis'
+ - '@vercel/blob'
+ - '@vercel/functions'
+ - '@vercel/kv'
+ - aws4fetch
+ - bufferutil
+ - crossws
+ - db0
+ - idb-keyval
+ - ioredis
+ - typescript
+ - uploadthing
+ - utf-8-validate
+
+ '@vitejs/plugin-vue-jsx@5.1.5(vite@8.0.12)(vue@3.5.34(typescript@6.0.3))':
+ dependencies:
+ '@babel/core': 7.29.0
+ '@babel/plugin-syntax-typescript': 7.28.6(@babel/core@7.29.0)
+ '@babel/plugin-transform-typescript': 7.28.6(@babel/core@7.29.0)
+ '@rolldown/pluginutils': 1.0.1
+ '@vue/babel-plugin-jsx': 2.0.1(@babel/core@7.29.0)
+ vite: 8.0.12(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0)
+ vue: 3.5.34(typescript@6.0.3)
+ transitivePeerDependencies:
+ - supports-color
+
+ '@vitejs/plugin-vue@6.0.7(vite@8.0.12)(vue@3.5.34(typescript@6.0.3))':
+ dependencies:
+ '@rolldown/pluginutils': 1.0.1
+ vite: 8.0.12(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0)
+ vue: 3.5.34(typescript@6.0.3)
+
+ '@vitest/coverage-v8@4.1.7(vitest@4.1.7)':
+ dependencies:
+ '@bcoe/v8-coverage': 1.0.2
+ '@vitest/utils': 4.1.7
+ ast-v8-to-istanbul: 1.0.0
+ istanbul-lib-coverage: 3.2.2
+ istanbul-lib-report: 3.0.1
+ istanbul-reports: 3.2.0
+ magicast: 0.5.3
+ obug: 2.1.1
+ std-env: 4.1.0
+ tinyrainbow: 3.1.0
+ vitest: 4.1.7(@types/node@24.12.4)(@vitest/coverage-v8@4.1.7)(happy-dom@20.9.0)(vite@8.0.12)
+
+ '@vitest/expect@4.1.6':
+ dependencies:
+ '@standard-schema/spec': 1.1.0
+ '@types/chai': 5.2.3
+ '@vitest/spy': 4.1.6
+ '@vitest/utils': 4.1.6
+ chai: 6.2.2
+ tinyrainbow: 3.1.0
+
+ '@vitest/expect@4.1.7':
+ dependencies:
+ '@standard-schema/spec': 1.1.0
+ '@types/chai': 5.2.3
+ '@vitest/spy': 4.1.7
+ '@vitest/utils': 4.1.7
+ chai: 6.2.2
+ tinyrainbow: 3.1.0
+
+ '@vitest/mocker@4.1.6(vite@8.0.12)':
+ dependencies:
+ '@vitest/spy': 4.1.6
+ estree-walker: 3.0.3
+ magic-string: 0.30.21
+ optionalDependencies:
+ vite: 8.0.12(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0)
+
+ '@vitest/mocker@4.1.7(vite@8.0.12)':
+ dependencies:
+ '@vitest/spy': 4.1.7
+ estree-walker: 3.0.3
+ magic-string: 0.30.21
+ optionalDependencies:
+ vite: 8.0.12(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0)
+
+ '@vitest/pretty-format@4.1.6':
+ dependencies:
+ tinyrainbow: 3.1.0
+
+ '@vitest/pretty-format@4.1.7':
+ dependencies:
+ tinyrainbow: 3.1.0
+
+ '@vitest/runner@4.1.6':
+ dependencies:
+ '@vitest/utils': 4.1.6
+ pathe: 2.0.3
+
+ '@vitest/runner@4.1.7':
+ dependencies:
+ '@vitest/utils': 4.1.7
+ pathe: 2.0.3
+
+ '@vitest/snapshot@4.1.6':
+ dependencies:
+ '@vitest/pretty-format': 4.1.6
+ '@vitest/utils': 4.1.6
+ magic-string: 0.30.21
+ pathe: 2.0.3
+
+ '@vitest/snapshot@4.1.7':
+ dependencies:
+ '@vitest/pretty-format': 4.1.7
+ '@vitest/utils': 4.1.7
+ magic-string: 0.30.21
+ pathe: 2.0.3
+
+ '@vitest/spy@4.1.6': {}
+
+ '@vitest/spy@4.1.7': {}
+
+ '@vitest/utils@4.1.6':
+ dependencies:
+ '@vitest/pretty-format': 4.1.6
+ convert-source-map: 2.0.0
+ tinyrainbow: 3.1.0
+
+ '@vitest/utils@4.1.7':
+ dependencies:
+ '@vitest/pretty-format': 4.1.7
+ convert-source-map: 2.0.0
+ tinyrainbow: 3.1.0
+
+ '@volar/language-core@2.4.28':
+ dependencies:
+ '@volar/source-map': 2.4.28
+
+ '@volar/source-map@2.4.28': {}
+
+ '@volar/typescript@2.4.28':
+ dependencies:
+ '@volar/language-core': 2.4.28
+ path-browserify: 1.0.1
+ vscode-uri: 3.1.0
+
+ '@voxpelli/semver-set@6.0.2':
+ dependencies:
+ semver: 7.8.0
+
+ '@voxpelli/type-helpers@3.5.0': {}
+
+ '@voxpelli/typed-utils@1.10.2':
+ dependencies:
+ '@voxpelli/type-helpers': 3.5.0
+
+ '@vue-macros/common@3.1.2(vue@3.5.34(typescript@6.0.3))':
+ dependencies:
+ '@vue/compiler-sfc': 3.5.34
+ ast-kit: 2.2.0
+ local-pkg: 1.2.1
+ magic-string-ast: 1.0.3
+ unplugin-utils: 0.3.1
+ optionalDependencies:
+ vue: 3.5.34(typescript@6.0.3)
+
+ '@vue/babel-helper-vue-transform-on@2.0.1': {}
+
+ '@vue/babel-plugin-jsx@2.0.1(@babel/core@7.29.0)':
+ dependencies:
+ '@babel/helper-module-imports': 7.28.6
+ '@babel/helper-plugin-utils': 7.28.6
+ '@babel/plugin-syntax-jsx': 7.28.6(@babel/core@7.29.0)
+ '@babel/template': 7.28.6
+ '@babel/traverse': 7.29.0
+ '@babel/types': 7.29.0
+ '@vue/babel-helper-vue-transform-on': 2.0.1
+ '@vue/babel-plugin-resolve-type': 2.0.1(@babel/core@7.29.0)
+ '@vue/shared': 3.5.34
+ optionalDependencies:
+ '@babel/core': 7.29.0
+ transitivePeerDependencies:
+ - supports-color
+
+ '@vue/babel-plugin-resolve-type@2.0.1(@babel/core@7.29.0)':
+ dependencies:
+ '@babel/code-frame': 7.29.0
+ '@babel/core': 7.29.0
+ '@babel/helper-module-imports': 7.28.6
+ '@babel/helper-plugin-utils': 7.28.6
+ '@babel/parser': 7.29.3
+ '@vue/compiler-sfc': 3.5.34
+ transitivePeerDependencies:
+ - supports-color
+
+ '@vue/compiler-core@3.5.34':
+ dependencies:
+ '@babel/parser': 7.29.3
+ '@vue/shared': 3.5.34
+ entities: 7.0.1
+ estree-walker: 2.0.2
+ source-map-js: 1.2.1
+
+ '@vue/compiler-dom@3.5.34':
+ dependencies:
+ '@vue/compiler-core': 3.5.34
+ '@vue/shared': 3.5.34
+
+ '@vue/compiler-sfc@3.5.34':
+ dependencies:
+ '@babel/parser': 7.29.3
+ '@vue/compiler-core': 3.5.34
+ '@vue/compiler-dom': 3.5.34
+ '@vue/compiler-ssr': 3.5.34
+ '@vue/shared': 3.5.34
+ estree-walker: 2.0.2
+ magic-string: 0.30.21
+ postcss: 8.5.14
+ source-map-js: 1.2.1
+
+ '@vue/compiler-ssr@3.5.34':
+ dependencies:
+ '@vue/compiler-dom': 3.5.34
+ '@vue/shared': 3.5.34
+
+ '@vue/devtools-api@8.1.2':
+ dependencies:
+ '@vue/devtools-kit': 8.1.2
+
+ '@vue/devtools-core@8.1.2(vue@3.5.34(typescript@6.0.3))':
+ dependencies:
+ '@vue/devtools-kit': 8.1.2
+ '@vue/devtools-shared': 8.1.2
+ vue: 3.5.34(typescript@6.0.3)
+
+ '@vue/devtools-kit@8.1.2':
+ dependencies:
+ '@vue/devtools-shared': 8.1.2
+ birpc: 2.9.0
+ hookable: 5.5.3
+ perfect-debounce: 2.1.0
+
+ '@vue/devtools-shared@8.1.2': {}
+
+ '@vue/language-core@3.2.9':
+ dependencies:
+ '@volar/language-core': 2.4.28
+ '@vue/compiler-dom': 3.5.34
+ '@vue/shared': 3.5.34
+ alien-signals: 3.2.1
+ muggle-string: 0.4.1
+ path-browserify: 1.0.1
+ picomatch: 4.0.4
+
+ '@vue/reactivity@3.5.34':
+ dependencies:
+ '@vue/shared': 3.5.34
+
+ '@vue/runtime-core@3.5.34':
+ dependencies:
+ '@vue/reactivity': 3.5.34
+ '@vue/shared': 3.5.34
+
+ '@vue/runtime-dom@3.5.34':
+ dependencies:
+ '@vue/reactivity': 3.5.34
+ '@vue/runtime-core': 3.5.34
+ '@vue/shared': 3.5.34
+ csstype: 3.2.3
+
+ '@vue/server-renderer@3.5.34(vue@3.5.34(typescript@6.0.3))':
+ dependencies:
+ '@vue/compiler-ssr': 3.5.34
+ '@vue/shared': 3.5.34
+ vue: 3.5.34(typescript@6.0.3)
+
+ '@vue/shared@3.5.34': {}
+
+ '@vue/test-utils@2.4.10(@vue/compiler-dom@3.5.34)(@vue/server-renderer@3.5.34(vue@3.5.34(typescript@6.0.3)))(vue@3.5.34(typescript@6.0.3))':
+ dependencies:
+ '@vue/compiler-dom': 3.5.34
+ js-beautify: 1.15.4
+ vue: 3.5.34(typescript@6.0.3)
+ vue-component-type-helpers: 3.3.1
+ optionalDependencies:
+ '@vue/server-renderer': 3.5.34(vue@3.5.34(typescript@6.0.3))
+
+ '@vueuse/core@14.3.0(vue@3.5.34(typescript@6.0.3))':
+ dependencies:
+ '@types/web-bluetooth': 0.0.21
+ '@vueuse/metadata': 14.3.0
+ '@vueuse/shared': 14.3.0(vue@3.5.34(typescript@6.0.3))
+ vue: 3.5.34(typescript@6.0.3)
+
+ '@vueuse/metadata@14.3.0': {}
+
+ '@vueuse/shared@14.3.0(vue@3.5.34(typescript@6.0.3))':
+ dependencies:
+ vue: 3.5.34(typescript@6.0.3)
+
+ '@webassemblyjs/ast@1.14.1':
+ dependencies:
+ '@webassemblyjs/helper-numbers': 1.13.2
+ '@webassemblyjs/helper-wasm-bytecode': 1.13.2
+
+ '@webassemblyjs/floating-point-hex-parser@1.13.2': {}
+
+ '@webassemblyjs/helper-api-error@1.13.2': {}
+
+ '@webassemblyjs/helper-buffer@1.14.1': {}
+
+ '@webassemblyjs/helper-numbers@1.13.2':
+ dependencies:
+ '@webassemblyjs/floating-point-hex-parser': 1.13.2
+ '@webassemblyjs/helper-api-error': 1.13.2
+ '@xtuc/long': 4.2.2
+
+ '@webassemblyjs/helper-wasm-bytecode@1.13.2': {}
+
+ '@webassemblyjs/helper-wasm-section@1.14.1':
+ dependencies:
+ '@webassemblyjs/ast': 1.14.1
+ '@webassemblyjs/helper-buffer': 1.14.1
+ '@webassemblyjs/helper-wasm-bytecode': 1.13.2
+ '@webassemblyjs/wasm-gen': 1.14.1
+
+ '@webassemblyjs/ieee754@1.13.2':
+ dependencies:
+ '@xtuc/ieee754': 1.2.0
+
+ '@webassemblyjs/leb128@1.13.2':
+ dependencies:
+ '@xtuc/long': 4.2.2
+
+ '@webassemblyjs/utf8@1.13.2': {}
+
+ '@webassemblyjs/wasm-edit@1.14.1':
+ dependencies:
+ '@webassemblyjs/ast': 1.14.1
+ '@webassemblyjs/helper-buffer': 1.14.1
+ '@webassemblyjs/helper-wasm-bytecode': 1.13.2
+ '@webassemblyjs/helper-wasm-section': 1.14.1
+ '@webassemblyjs/wasm-gen': 1.14.1
+ '@webassemblyjs/wasm-opt': 1.14.1
+ '@webassemblyjs/wasm-parser': 1.14.1
+ '@webassemblyjs/wast-printer': 1.14.1
+
+ '@webassemblyjs/wasm-gen@1.14.1':
+ dependencies:
+ '@webassemblyjs/ast': 1.14.1
+ '@webassemblyjs/helper-wasm-bytecode': 1.13.2
+ '@webassemblyjs/ieee754': 1.13.2
+ '@webassemblyjs/leb128': 1.13.2
+ '@webassemblyjs/utf8': 1.13.2
+
+ '@webassemblyjs/wasm-opt@1.14.1':
+ dependencies:
+ '@webassemblyjs/ast': 1.14.1
+ '@webassemblyjs/helper-buffer': 1.14.1
+ '@webassemblyjs/wasm-gen': 1.14.1
+ '@webassemblyjs/wasm-parser': 1.14.1
+
+ '@webassemblyjs/wasm-parser@1.14.1':
+ dependencies:
+ '@webassemblyjs/ast': 1.14.1
+ '@webassemblyjs/helper-api-error': 1.13.2
+ '@webassemblyjs/helper-wasm-bytecode': 1.13.2
+ '@webassemblyjs/ieee754': 1.13.2
+ '@webassemblyjs/leb128': 1.13.2
+ '@webassemblyjs/utf8': 1.13.2
+
+ '@webassemblyjs/wast-printer@1.14.1':
+ dependencies:
+ '@webassemblyjs/ast': 1.14.1
+ '@xtuc/long': 4.2.2
+
+ '@xtuc/ieee754@1.2.0': {}
+
+ '@xtuc/long@4.2.2': {}
+
+ abbrev@2.0.0: {}
+
+ abbrev@3.0.1: {}
+
+ abort-controller@3.0.0:
+ dependencies:
+ event-target-shim: 5.0.1
+
+ acorn-import-attributes@1.9.5(acorn@8.16.0):
+ dependencies:
+ acorn: 8.16.0
+
+ acorn-import-phases@1.0.4(acorn@8.16.0):
+ dependencies:
+ acorn: 8.16.0
+
+ acorn-jsx@5.3.2(acorn@8.16.0):
+ dependencies:
+ acorn: 8.16.0
+
+ acorn-walk@8.3.5:
+ dependencies:
+ acorn: 8.16.0
+
+ acorn@7.4.1: {}
+
+ acorn@8.16.0: {}
+
+ agent-base@6.0.2:
+ dependencies:
+ debug: 4.4.3
+ transitivePeerDependencies:
+ - supports-color
+
+ agent-base@7.1.4: {}
+
+ ajv-formats@2.1.1(ajv@8.20.0):
+ optionalDependencies:
+ ajv: 8.20.0
+
+ ajv-keywords@3.5.2(ajv@6.15.0):
+ dependencies:
+ ajv: 6.15.0
+
+ ajv-keywords@5.1.0(ajv@8.20.0):
+ dependencies:
+ ajv: 8.20.0
+ fast-deep-equal: 3.1.3
+
+ ajv@6.15.0:
+ dependencies:
+ fast-deep-equal: 3.1.3
+ fast-json-stable-stringify: 2.1.0
+ json-schema-traverse: 0.4.1
+ uri-js: 4.4.1
+
+ ajv@8.20.0:
+ dependencies:
+ fast-deep-equal: 3.1.3
+ fast-uri: 3.1.2
+ json-schema-traverse: 1.0.0
+ require-from-string: 2.0.2
+
+ alien-signals@3.2.1: {}
+
+ ansi-escapes@7.3.0:
+ dependencies:
+ environment: 1.1.0
+
+ ansi-html-community@0.0.8: {}
+
+ ansi-regex@5.0.1: {}
+
+ ansi-regex@6.2.2: {}
+
+ ansi-styles@3.2.1:
+ dependencies:
+ color-convert: 1.9.3
+
+ ansi-styles@4.3.0:
+ dependencies:
+ color-convert: 2.0.1
+
+ ansi-styles@5.2.0: {}
+
+ ansi-styles@6.2.3: {}
+
+ ansis@3.17.0: {}
+
+ ansis@4.3.0: {}
+
+ any-promise@1.3.0: {}
+
+ anymatch@3.1.3:
+ dependencies:
+ normalize-path: 3.0.0
+ picomatch: 2.3.2
+
+ archiver-utils@5.0.2:
+ dependencies:
+ glob: 10.5.0
+ graceful-fs: 4.2.11
+ is-stream: 2.0.1
+ lazystream: 1.0.1
+ lodash: 4.18.1
+ normalize-path: 3.0.0
+ readable-stream: 4.7.0
+
+ archiver@7.0.1:
+ dependencies:
+ archiver-utils: 5.0.2
+ async: 3.2.6
+ buffer-crc32: 1.0.0
+ readable-stream: 4.7.0
+ readdir-glob: 1.1.3
+ tar-stream: 3.2.0
+ zip-stream: 6.0.1
+ transitivePeerDependencies:
+ - bare-abort-controller
+ - bare-buffer
+ - react-native-b4a
+
+ are-docs-informative@0.0.2: {}
+
+ argparse@2.0.1: {}
+
+ aria-query@5.1.3:
+ dependencies:
+ deep-equal: 2.2.3
+
+ array-buffer-byte-length@1.0.2:
+ dependencies:
+ call-bound: 1.0.4
+ is-array-buffer: 3.0.5
+
+ asap@2.0.6: {}
+
+ assert-never@1.4.0: {}
+
+ assertion-error@2.0.1: {}
+
+ ast-kit@2.2.0:
+ dependencies:
+ '@babel/parser': 7.29.3
+ pathe: 2.0.3
+
+ ast-kit@3.0.0-beta.1:
+ dependencies:
+ '@babel/parser': 8.0.0-rc.5
+ estree-walker: 3.0.3
+ pathe: 2.0.3
+
+ ast-v8-to-istanbul@1.0.0:
+ dependencies:
+ '@jridgewell/trace-mapping': 0.3.31
+ estree-walker: 3.0.3
+ js-tokens: 10.0.0
+
+ ast-walker-scope@0.8.3:
+ dependencies:
+ '@babel/parser': 7.29.3
+ ast-kit: 2.2.0
+
+ async-sema@3.1.1: {}
+
+ async@3.2.6: {}
+
+ asynckit@0.4.0: {}
+
+ autoprefixer@10.5.0(postcss@8.5.14):
+ dependencies:
+ browserslist: 4.28.2
+ caniuse-lite: 1.0.30001793
+ fraction.js: 5.3.4
+ picocolors: 1.1.1
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+
+ available-typed-arrays@1.0.7:
+ dependencies:
+ possible-typed-array-names: 1.1.0
+
+ axios@1.16.1:
+ dependencies:
+ follow-redirects: 1.16.0
+ form-data: 4.0.5
+ https-proxy-agent: 5.0.1
+ proxy-from-env: 2.1.0
+ transitivePeerDependencies:
+ - debug
+ - supports-color
+
+ b4a@1.8.1: {}
+
+ babel-walk@3.0.0-canary-5:
+ dependencies:
+ '@babel/types': 7.29.0
+
+ bail@2.0.2: {}
+
+ balanced-match@1.0.2: {}
+
+ balanced-match@4.0.4: {}
+
+ bare-events@2.8.3: {}
+
+ bare-fs@4.7.1:
+ dependencies:
+ bare-events: 2.8.3
+ bare-path: 3.0.0
+ bare-stream: 2.13.1(bare-events@2.8.3)
+ bare-url: 2.4.3
+ fast-fifo: 1.3.2
+ transitivePeerDependencies:
+ - bare-abort-controller
+ - react-native-b4a
+
+ bare-os@3.9.1: {}
+
+ bare-path@3.0.0:
+ dependencies:
+ bare-os: 3.9.1
+
+ bare-stream@2.13.1(bare-events@2.8.3):
+ dependencies:
+ streamx: 2.25.0
+ teex: 1.0.1
+ optionalDependencies:
+ bare-events: 2.8.3
+ transitivePeerDependencies:
+ - react-native-b4a
+
+ bare-url@2.4.3:
+ dependencies:
+ bare-path: 3.0.0
+
+ base64-js@1.5.1: {}
+
+ baseline-browser-mapping@2.10.32: {}
+
+ beasties@0.4.2:
+ dependencies:
+ css-select: 6.0.0
+ css-what: 7.0.0
+ dom-serializer: 2.0.0
+ domhandler: 5.0.3
+ htmlparser2: 10.1.0
+ picocolors: 1.1.1
+ postcss: 8.5.14
+ postcss-media-query-parser: 0.2.3
+ postcss-safe-parser: 7.0.1(postcss@8.5.14)
+
+ big.js@5.2.2: {}
+
+ binary-extensions@2.3.0: {}
+
+ bindings@1.5.0:
+ dependencies:
+ file-uri-to-path: 1.0.0
+
+ birpc@2.9.0: {}
+
+ birpc@4.0.0: {}
+
+ bole@5.0.29:
+ dependencies:
+ fast-safe-stringify: 2.1.1
+ individual: 3.0.0
+
+ boolbase@1.0.0: {}
+
+ brace-expansion@1.1.14:
+ dependencies:
+ balanced-match: 1.0.2
+ concat-map: 0.0.1
+
+ brace-expansion@2.1.0:
+ dependencies:
+ balanced-match: 1.0.2
+
+ brace-expansion@5.0.6:
+ dependencies:
+ balanced-match: 4.0.4
+
+ braces@3.0.3:
+ dependencies:
+ fill-range: 7.1.1
+
+ browserslist@4.28.2:
+ dependencies:
+ baseline-browser-mapping: 2.10.32
+ caniuse-lite: 1.0.30001793
+ electron-to-chromium: 1.5.361
+ node-releases: 2.0.46
+ update-browserslist-db: 1.2.3(browserslist@4.28.2)
+
+ buffer-crc32@1.0.0: {}
+
+ buffer-from@1.1.2: {}
+
+ buffer@6.0.3:
+ dependencies:
+ base64-js: 1.5.1
+ ieee754: 1.2.1
+
+ buffered-async-iterable@1.0.1: {}
+
+ builtin-modules@5.2.0: {}
+
+ bundle-name@4.1.0:
+ dependencies:
+ run-applescript: 7.1.0
+
+ c12@3.3.4(magicast@0.5.3):
+ dependencies:
+ chokidar: 5.0.0
+ confbox: 0.2.4
+ defu: 6.1.7
+ dotenv: 17.4.2
+ exsolve: 1.0.8
+ giget: 3.2.0
+ jiti: 2.7.0
+ ohash: 2.0.11
+ pathe: 2.0.3
+ perfect-debounce: 2.1.0
+ pkg-types: 2.3.1
+ rc9: 3.0.1
+ optionalDependencies:
+ magicast: 0.5.3
+
+ c12@4.0.0-beta.5(chokidar@5.0.0)(dotenv@17.4.2)(giget@3.2.0)(jiti@2.7.0)(magicast@0.5.3):
+ dependencies:
+ confbox: 0.2.4
+ defu: 6.1.7
+ exsolve: 1.0.8
+ pathe: 2.0.3
+ pkg-types: 2.3.1
+ rc9: 3.0.1
+ optionalDependencies:
+ chokidar: 5.0.0
+ dotenv: 17.4.2
+ giget: 3.2.0
+ jiti: 2.7.0
+ magicast: 0.5.3
+
+ cac@7.0.0: {}
+
+ call-bind-apply-helpers@1.0.2:
+ dependencies:
+ es-errors: 1.3.0
+ function-bind: 1.1.2
+
+ call-bind@1.0.9:
+ dependencies:
+ call-bind-apply-helpers: 1.0.2
+ es-define-property: 1.0.1
+ get-intrinsic: 1.3.0
+ set-function-length: 1.2.2
+
+ call-bound@1.0.4:
+ dependencies:
+ call-bind-apply-helpers: 1.0.2
+ get-intrinsic: 1.3.0
+
+ callsites@3.1.0: {}
+
+ caniuse-api@3.0.0:
+ dependencies:
+ browserslist: 4.28.2
+ caniuse-lite: 1.0.30001793
+ lodash.memoize: 4.1.2
+ lodash.uniq: 4.5.0
+
+ caniuse-lite@1.0.30001793: {}
+
+ case-police@2.2.1: {}
+
+ ccount@2.0.1: {}
+
+ chai@6.2.2: {}
+
+ chalk@2.4.2:
+ dependencies:
+ ansi-styles: 3.2.1
+ escape-string-regexp: 1.0.5
+ supports-color: 5.5.0
+
+ chalk@4.1.2:
+ dependencies:
+ ansi-styles: 4.3.0
+ supports-color: 7.2.0
+
+ chalk@5.6.2: {}
+
+ change-case@5.4.4: {}
+
+ changelogen@0.6.2(patch_hash=8aee9e31504b2889cfb6b9bae91ba797bea8acef312c723134cb1e70cc7e4c2b)(magicast@0.5.3):
+ dependencies:
+ c12: 3.3.4(magicast@0.5.3)
+ confbox: 0.2.4
+ consola: 3.4.2
+ convert-gitmoji: 0.1.5
+ mri: 1.2.0
+ node-fetch-native: 1.6.7
+ ofetch: 1.5.1
+ open: 10.2.0
+ pathe: 2.0.3
+ pkg-types: 2.3.1
+ scule: 1.3.0
+ semver: 7.8.0
+ std-env: 3.10.0
+ transitivePeerDependencies:
+ - magicast
+
+ char-regex@1.0.2: {}
+
+ character-entities-html4@2.1.0: {}
+
+ character-entities-legacy@3.0.0: {}
+
+ character-entities@2.0.2: {}
+
+ character-parser@2.2.0:
+ dependencies:
+ is-regex: 1.2.1
+
+ character-reference-invalid@2.0.1: {}
+
+ chokidar@3.6.0:
+ dependencies:
+ anymatch: 3.1.3
+ braces: 3.0.3
+ glob-parent: 5.1.2
+ is-binary-path: 2.1.0
+ is-glob: 4.0.3
+ normalize-path: 3.0.0
+ readdirp: 3.6.0
+ optionalDependencies:
+ fsevents: 2.3.3
+
+ chokidar@4.0.3:
+ dependencies:
+ readdirp: 4.1.2
+
+ chokidar@5.0.0:
+ dependencies:
+ readdirp: 5.0.0
+
+ chownr@3.0.0: {}
+
+ chrome-trace-event@1.0.4: {}
+
+ ci-info@4.4.0: {}
+
+ citty@0.1.6:
+ dependencies:
+ consola: 3.4.2
+
+ citty@0.2.2: {}
+
+ cjs-module-lexer@1.4.3: {}
+
+ clean-regexp@1.0.0:
+ dependencies:
+ escape-string-regexp: 1.0.5
+
+ cli-highlight@2.1.11:
+ dependencies:
+ chalk: 4.1.2
+ highlight.js: 10.7.3
+ mz: 2.7.0
+ parse5: 5.1.1
+ parse5-htmlparser2-tree-adapter: 6.0.1
+ yargs: 16.2.0
+
+ cli-table3@0.6.5:
+ dependencies:
+ string-width: 4.2.3
+ optionalDependencies:
+ '@colors/colors': 1.5.0
+
+ cliui@7.0.4:
+ dependencies:
+ string-width: 4.2.3
+ strip-ansi: 6.0.1
+ wrap-ansi: 7.0.0
+
+ cliui@9.0.1:
+ dependencies:
+ string-width: 7.2.0
+ strip-ansi: 7.2.0
+ wrap-ansi: 9.0.2
+
+ cluster-key-slot@1.1.2: {}
+
+ color-convert@1.9.3:
+ dependencies:
+ color-name: 1.1.3
+
+ color-convert@2.0.1:
+ dependencies:
+ color-name: 1.1.4
+
+ color-name@1.1.3: {}
+
+ color-name@1.1.4: {}
+
+ colorette@2.0.20: {}
+
+ combined-stream@1.0.8:
+ dependencies:
+ delayed-stream: 1.0.0
+
+ comma-separated-tokens@2.0.3: {}
+
+ commander@10.0.1: {}
+
+ commander@11.1.0: {}
+
+ commander@14.0.3: {}
+
+ commander@2.20.3: {}
+
+ commander@8.3.0: {}
+
+ comment-parser@1.4.6: {}
+
+ commondir@1.0.1: {}
+
+ compatx@0.2.0: {}
+
+ compress-commons@6.0.2:
+ dependencies:
+ crc-32: 1.2.2
+ crc32-stream: 6.0.0
+ is-stream: 2.0.1
+ normalize-path: 3.0.0
+ readable-stream: 4.7.0
+
+ concat-map@0.0.1: {}
+
+ confbox@0.1.8: {}
+
+ confbox@0.2.4: {}
+
+ config-chain@1.1.13:
+ dependencies:
+ ini: 1.3.8
+ proto-list: 1.2.4
+
+ consola@3.4.2: {}
+
+ constantinople@4.0.1:
+ dependencies:
+ '@babel/parser': 7.29.3
+ '@babel/types': 7.29.0
+
+ convert-gitmoji@0.1.5: {}
+
+ convert-source-map@2.0.0: {}
+
+ cookie-es@1.2.3: {}
+
+ cookie-es@2.0.1: {}
+
+ cookie-es@3.1.1: {}
+
+ core-js-compat@3.49.0:
+ dependencies:
+ browserslist: 4.28.2
+
+ core-util-is@1.0.3: {}
+
+ cosmiconfig@8.3.6(typescript@6.0.3):
+ dependencies:
+ import-fresh: 3.3.1
+ js-yaml: 4.1.1
+ parse-json: 5.2.0
+ path-type: 4.0.0
+ optionalDependencies:
+ typescript: 6.0.3
+
+ cosmiconfig@9.0.1(typescript@6.0.3):
+ dependencies:
+ env-paths: 2.2.1
+ import-fresh: 3.3.1
+ js-yaml: 4.1.1
+ parse-json: 5.2.0
+ optionalDependencies:
+ typescript: 6.0.3
+
+ crc-32@1.2.2: {}
+
+ crc32-stream@6.0.0:
+ dependencies:
+ crc-32: 1.2.2
+ readable-stream: 4.7.0
+
+ croner@10.0.1: {}
+
+ cross-spawn@7.0.6:
+ dependencies:
+ path-key: 3.1.1
+ shebang-command: 2.0.0
+ which: 2.0.2
+
+ crossws@0.3.5:
+ dependencies:
+ uncrypto: 0.1.3
+
+ crossws@0.4.5(srvx@0.11.15):
+ optionalDependencies:
+ srvx: 0.11.15
+
+ css-declaration-sorter@7.4.0(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+
+ css-loader@7.1.4(@rspack/core@2.0.3)(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)):
+ dependencies:
+ icss-utils: 5.1.0(postcss@8.5.14)
+ postcss: 8.5.14
+ postcss-modules-extract-imports: 3.1.0(postcss@8.5.14)
+ postcss-modules-local-by-default: 4.2.0(postcss@8.5.14)
+ postcss-modules-scope: 3.2.1(postcss@8.5.14)
+ postcss-modules-values: 4.0.0(postcss@8.5.14)
+ postcss-value-parser: 4.2.0
+ semver: 7.8.0
+ optionalDependencies:
+ '@rspack/core': 2.0.3
+ webpack: 5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)
+
+ css-minimizer-webpack-plugin@8.0.0(esbuild@0.28.0)(lightningcss@1.32.0)(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)):
+ dependencies:
+ '@jridgewell/trace-mapping': 0.3.31
+ cssnano: 7.1.9(postcss@8.5.14)
+ jest-worker: 30.4.1
+ postcss: 8.5.14
+ schema-utils: 4.3.3
+ serialize-javascript: 7.0.5
+ webpack: 5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)
+ optionalDependencies:
+ esbuild: 0.28.0
+ lightningcss: 1.32.0
+
+ css-select@5.2.2:
+ dependencies:
+ boolbase: 1.0.0
+ css-what: 6.2.2
+ domhandler: 5.0.3
+ domutils: 3.2.2
+ nth-check: 2.1.1
+
+ css-select@6.0.0:
+ dependencies:
+ boolbase: 1.0.0
+ css-what: 7.0.0
+ domhandler: 5.0.3
+ domutils: 3.2.2
+ nth-check: 2.1.1
+
+ css-tree@2.2.1:
+ dependencies:
+ mdn-data: 2.0.28
+ source-map-js: 1.2.1
+
+ css-tree@3.2.1:
+ dependencies:
+ mdn-data: 2.27.1
+ source-map-js: 1.2.1
+
+ css-what@6.2.2: {}
+
+ css-what@7.0.0: {}
+
+ cssesc@3.0.0: {}
+
+ cssnano-preset-default@7.0.17(postcss@8.5.14):
+ dependencies:
+ browserslist: 4.28.2
+ css-declaration-sorter: 7.4.0(postcss@8.5.14)
+ cssnano-utils: 5.0.3(postcss@8.5.14)
+ postcss: 8.5.14
+ postcss-calc: 10.1.1(postcss@8.5.14)
+ postcss-colormin: 7.0.10(postcss@8.5.14)
+ postcss-convert-values: 7.0.12(postcss@8.5.14)
+ postcss-discard-comments: 7.0.8(postcss@8.5.14)
+ postcss-discard-duplicates: 7.0.4(postcss@8.5.14)
+ postcss-discard-empty: 7.0.3(postcss@8.5.14)
+ postcss-discard-overridden: 7.0.3(postcss@8.5.14)
+ postcss-merge-longhand: 7.0.7(postcss@8.5.14)
+ postcss-merge-rules: 7.0.11(postcss@8.5.14)
+ postcss-minify-font-values: 7.0.3(postcss@8.5.14)
+ postcss-minify-gradients: 7.0.5(postcss@8.5.14)
+ postcss-minify-params: 7.0.9(postcss@8.5.14)
+ postcss-minify-selectors: 7.1.2(postcss@8.5.14)
+ postcss-normalize-charset: 7.0.3(postcss@8.5.14)
+ postcss-normalize-display-values: 7.0.3(postcss@8.5.14)
+ postcss-normalize-positions: 7.0.4(postcss@8.5.14)
+ postcss-normalize-repeat-style: 7.0.4(postcss@8.5.14)
+ postcss-normalize-string: 7.0.3(postcss@8.5.14)
+ postcss-normalize-timing-functions: 7.0.3(postcss@8.5.14)
+ postcss-normalize-unicode: 7.0.9(postcss@8.5.14)
+ postcss-normalize-url: 7.0.3(postcss@8.5.14)
+ postcss-normalize-whitespace: 7.0.3(postcss@8.5.14)
+ postcss-ordered-values: 7.0.4(postcss@8.5.14)
+ postcss-reduce-initial: 7.0.9(postcss@8.5.14)
+ postcss-reduce-transforms: 7.0.3(postcss@8.5.14)
+ postcss-svgo: 7.1.3(postcss@8.5.14)
+ postcss-unique-selectors: 7.0.7(postcss@8.5.14)
+
+ cssnano-preset-default@8.0.1(postcss@8.5.14):
+ dependencies:
+ browserslist: 4.28.2
+ cssnano-utils: 6.0.0(postcss@8.5.14)
+ postcss: 8.5.14
+ postcss-calc: 10.1.1(postcss@8.5.14)
+ postcss-colormin: 8.0.0(postcss@8.5.14)
+ postcss-convert-values: 8.0.0(postcss@8.5.14)
+ postcss-discard-comments: 8.0.0(postcss@8.5.14)
+ postcss-discard-duplicates: 8.0.0(postcss@8.5.14)
+ postcss-discard-empty: 8.0.0(postcss@8.5.14)
+ postcss-discard-overridden: 8.0.0(postcss@8.5.14)
+ postcss-merge-longhand: 8.0.0(postcss@8.5.14)
+ postcss-merge-rules: 8.0.0(postcss@8.5.14)
+ postcss-minify-font-values: 8.0.0(postcss@8.5.14)
+ postcss-minify-gradients: 8.0.0(postcss@8.5.14)
+ postcss-minify-params: 8.0.0(postcss@8.5.14)
+ postcss-minify-selectors: 8.0.1(postcss@8.5.14)
+ postcss-normalize-charset: 8.0.0(postcss@8.5.14)
+ postcss-normalize-display-values: 8.0.0(postcss@8.5.14)
+ postcss-normalize-positions: 8.0.0(postcss@8.5.14)
+ postcss-normalize-repeat-style: 8.0.0(postcss@8.5.14)
+ postcss-normalize-string: 8.0.0(postcss@8.5.14)
+ postcss-normalize-timing-functions: 8.0.0(postcss@8.5.14)
+ postcss-normalize-unicode: 8.0.0(postcss@8.5.14)
+ postcss-normalize-url: 8.0.0(postcss@8.5.14)
+ postcss-normalize-whitespace: 8.0.0(postcss@8.5.14)
+ postcss-ordered-values: 8.0.0(postcss@8.5.14)
+ postcss-reduce-initial: 8.0.0(postcss@8.5.14)
+ postcss-reduce-transforms: 8.0.0(postcss@8.5.14)
+ postcss-svgo: 8.0.0(postcss@8.5.14)
+ postcss-unique-selectors: 8.0.0(postcss@8.5.14)
+
+ cssnano-utils@5.0.3(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+
+ cssnano-utils@6.0.0(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+
+ cssnano@7.1.9(postcss@8.5.14):
+ dependencies:
+ cssnano-preset-default: 7.0.17(postcss@8.5.14)
+ lilconfig: 3.1.3
+ postcss: 8.5.14
+
+ cssnano@8.0.1(postcss@8.5.14):
+ dependencies:
+ cssnano-preset-default: 8.0.1(postcss@8.5.14)
+ lilconfig: 3.1.3
+ postcss: 8.5.14
+
+ csso@5.0.5:
+ dependencies:
+ css-tree: 2.2.1
+
+ csstype@3.2.3: {}
+
+ cuint@0.2.2: {}
+
+ d3-path@3.1.0: {}
+
+ d3-shape@3.2.0:
+ dependencies:
+ d3-path: 3.1.0
+
+ db0@0.3.4: {}
+
+ debug@4.4.3:
+ dependencies:
+ ms: 2.1.3
+
+ decode-named-character-reference@1.3.0:
+ dependencies:
+ character-entities: 2.0.2
+
+ deep-equal@2.2.3:
+ dependencies:
+ array-buffer-byte-length: 1.0.2
+ call-bind: 1.0.9
+ es-get-iterator: 1.1.3
+ get-intrinsic: 1.3.0
+ is-arguments: 1.2.0
+ is-array-buffer: 3.0.5
+ is-date-object: 1.1.0
+ is-regex: 1.2.1
+ is-shared-array-buffer: 1.0.4
+ isarray: 2.0.5
+ object-is: 1.1.6
+ object-keys: 1.1.1
+ object.assign: 4.1.7
+ regexp.prototype.flags: 1.5.4
+ side-channel: 1.1.0
+ which-boxed-primitive: 1.1.1
+ which-collection: 1.0.2
+ which-typed-array: 1.1.20
+
+ deep-extend@0.6.0: {}
+
+ deep-is@0.1.4: {}
+
+ deepmerge@4.3.1: {}
+
+ default-browser-id@5.0.1: {}
+
+ default-browser@5.5.0:
+ dependencies:
+ bundle-name: 4.1.0
+ default-browser-id: 5.0.1
+
+ define-data-property@1.1.4:
+ dependencies:
+ es-define-property: 1.0.1
+ es-errors: 1.3.0
+ gopd: 1.2.0
+
+ define-lazy-prop@3.0.0: {}
+
+ define-properties@1.2.1:
+ dependencies:
+ define-data-property: 1.1.4
+ has-property-descriptors: 1.0.2
+ object-keys: 1.1.1
+
+ defu@6.1.7: {}
+
+ delayed-stream@1.0.0: {}
+
+ denque@2.1.0: {}
+
+ depd@2.0.0: {}
+
+ dequal@2.0.3: {}
+
+ destr@2.0.5: {}
+
+ detab@3.0.2: {}
+
+ detect-libc@2.1.2: {}
+
+ devalue@5.8.1: {}
+
+ devframe@0.2.2(crossws@0.4.5(srvx@0.11.15))(typescript@6.0.3):
+ dependencies:
+ '@valibot/to-json-schema': 1.7.0(valibot@1.4.0(typescript@6.0.3))
+ birpc: 4.0.0
+ cac: 7.0.0
+ h3: 2.0.1-rc.22(crossws@0.4.5(srvx@0.11.15))
+ logs-sdk: 0.0.6
+ mrmime: 2.0.1
+ pathe: 2.0.3
+ valibot: 1.4.0(typescript@6.0.3)
+ ws: 8.21.0
+ transitivePeerDependencies:
+ - bufferutil
+ - crossws
+ - typescript
+ - utf-8-validate
+
+ devlop@1.1.0:
+ dependencies:
+ dequal: 2.0.3
+
+ diff@9.0.0: {}
+
+ doctypes@1.1.0: {}
+
+ dom-accessibility-api@0.5.16: {}
+
+ dom-serializer@1.4.1:
+ dependencies:
+ domelementtype: 2.3.0
+ domhandler: 4.3.1
+ entities: 2.2.0
+
+ dom-serializer@2.0.0:
+ dependencies:
+ domelementtype: 2.3.0
+ domhandler: 5.0.3
+ entities: 4.5.0
+
+ domelementtype@2.3.0: {}
+
+ domhandler@4.3.1:
+ dependencies:
+ domelementtype: 2.3.0
+
+ domhandler@5.0.3:
+ dependencies:
+ domelementtype: 2.3.0
+
+ domutils@2.8.0:
+ dependencies:
+ dom-serializer: 1.4.1
+ domelementtype: 2.3.0
+ domhandler: 4.3.1
+
+ domutils@3.2.2:
+ dependencies:
+ dom-serializer: 2.0.0
+ domelementtype: 2.3.0
+ domhandler: 5.0.3
+
+ dot-prop@10.1.0:
+ dependencies:
+ type-fest: 5.6.0
+
+ dotenv@17.4.2: {}
+
+ dts-resolver@3.0.0(oxc-resolver@11.19.1(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0)):
+ optionalDependencies:
+ oxc-resolver: 11.19.1(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0)
+
+ dunder-proto@1.0.1:
+ dependencies:
+ call-bind-apply-helpers: 1.0.2
+ es-errors: 1.3.0
+ gopd: 1.2.0
+
+ duplexer@0.1.2: {}
+
+ eastasianwidth@0.2.0: {}
+
+ editorconfig@1.0.7:
+ dependencies:
+ '@one-ini/wasm': 0.1.1
+ commander: 10.0.1
+ minimatch: 9.0.9
+ semver: 7.8.0
+
+ ee-first@1.1.1: {}
+
+ electron-to-chromium@1.5.361: {}
+
+ emoji-regex@10.6.0: {}
+
+ emoji-regex@8.0.0: {}
+
+ emoji-regex@9.2.2: {}
+
+ emojilib@2.4.0: {}
+
+ emojis-list@3.0.0: {}
+
+ emoticon@4.1.0: {}
+
+ encodeurl@2.0.0: {}
+
+ enhanced-resolve@4.5.0:
+ dependencies:
+ graceful-fs: 4.2.11
+ memory-fs: 0.5.0
+ tapable: 1.1.3
+
+ enhanced-resolve@5.22.0:
+ dependencies:
+ graceful-fs: 4.2.11
+ tapable: 2.3.3
+
+ entities@2.2.0: {}
+
+ entities@3.0.1: {}
+
+ entities@4.5.0: {}
+
+ entities@6.0.1: {}
+
+ entities@7.0.1: {}
+
+ entities@8.0.0: {}
+
+ env-paths@2.2.1: {}
+
+ env-runner@0.1.9:
+ dependencies:
+ crossws: 0.4.5(srvx@0.11.15)
+ exsolve: 1.0.8
+ httpxy: 0.5.3
+ srvx: 0.11.15
+
+ environment@1.1.0: {}
+
+ errno@0.1.8:
+ dependencies:
+ prr: 1.0.1
+
+ error-ex@1.3.4:
+ dependencies:
+ is-arrayish: 0.2.1
+
+ error-stack-parser-es@1.0.5: {}
+
+ error-stack-parser@2.1.4:
+ dependencies:
+ stackframe: 1.3.4
+
+ errx@0.1.0: {}
+
+ es-define-property@1.0.1: {}
+
+ es-errors@1.3.0: {}
+
+ es-get-iterator@1.1.3:
+ dependencies:
+ call-bind: 1.0.9
+ get-intrinsic: 1.3.0
+ has-symbols: 1.1.0
+ is-arguments: 1.2.0
+ is-map: 2.0.3
+ is-set: 2.0.3
+ is-string: 1.1.1
+ isarray: 2.0.5
+ stop-iteration-iterator: 1.1.0
+
+ es-module-lexer@2.1.0: {}
+
+ es-object-atoms@1.1.2:
+ dependencies:
+ es-errors: 1.3.0
+
+ es-set-tostringtag@2.1.0:
+ dependencies:
+ es-errors: 1.3.0
+ get-intrinsic: 1.3.0
+ has-tostringtag: 1.0.2
+ hasown: 2.0.3
+
+ esbuild-loader@4.4.3(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)):
+ dependencies:
+ esbuild: 0.27.7
+ get-tsconfig: 4.14.0
+ loader-utils: 2.0.4
+ webpack: 5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)
+ webpack-sources: 3.5.0
+
+ esbuild@0.25.12:
+ optionalDependencies:
+ '@esbuild/aix-ppc64': 0.25.12
+ '@esbuild/android-arm': 0.25.12
+ '@esbuild/android-arm64': 0.25.12
+ '@esbuild/android-x64': 0.25.12
+ '@esbuild/darwin-arm64': 0.25.12
+ '@esbuild/darwin-x64': 0.25.12
+ '@esbuild/freebsd-arm64': 0.25.12
+ '@esbuild/freebsd-x64': 0.25.12
+ '@esbuild/linux-arm': 0.25.12
+ '@esbuild/linux-arm64': 0.25.12
+ '@esbuild/linux-ia32': 0.25.12
+ '@esbuild/linux-loong64': 0.25.12
+ '@esbuild/linux-mips64el': 0.25.12
+ '@esbuild/linux-ppc64': 0.25.12
+ '@esbuild/linux-riscv64': 0.25.12
+ '@esbuild/linux-s390x': 0.25.12
+ '@esbuild/linux-x64': 0.25.12
+ '@esbuild/netbsd-arm64': 0.25.12
+ '@esbuild/netbsd-x64': 0.25.12
+ '@esbuild/openbsd-arm64': 0.25.12
+ '@esbuild/openbsd-x64': 0.25.12
+ '@esbuild/openharmony-arm64': 0.25.12
+ '@esbuild/sunos-x64': 0.25.12
+ '@esbuild/win32-arm64': 0.25.12
+ '@esbuild/win32-ia32': 0.25.12
+ '@esbuild/win32-x64': 0.25.12
+
+ esbuild@0.27.7:
+ optionalDependencies:
+ '@esbuild/aix-ppc64': 0.27.7
+ '@esbuild/android-arm': 0.27.7
+ '@esbuild/android-arm64': 0.27.7
+ '@esbuild/android-x64': 0.27.7
+ '@esbuild/darwin-arm64': 0.27.7
+ '@esbuild/darwin-x64': 0.27.7
+ '@esbuild/freebsd-arm64': 0.27.7
+ '@esbuild/freebsd-x64': 0.27.7
+ '@esbuild/linux-arm': 0.27.7
+ '@esbuild/linux-arm64': 0.27.7
+ '@esbuild/linux-ia32': 0.27.7
+ '@esbuild/linux-loong64': 0.27.7
+ '@esbuild/linux-mips64el': 0.27.7
+ '@esbuild/linux-ppc64': 0.27.7
+ '@esbuild/linux-riscv64': 0.27.7
+ '@esbuild/linux-s390x': 0.27.7
+ '@esbuild/linux-x64': 0.27.7
+ '@esbuild/netbsd-arm64': 0.27.7
+ '@esbuild/netbsd-x64': 0.27.7
+ '@esbuild/openbsd-arm64': 0.27.7
+ '@esbuild/openbsd-x64': 0.27.7
+ '@esbuild/openharmony-arm64': 0.27.7
+ '@esbuild/sunos-x64': 0.27.7
+ '@esbuild/win32-arm64': 0.27.7
+ '@esbuild/win32-ia32': 0.27.7
+ '@esbuild/win32-x64': 0.27.7
+
+ esbuild@0.28.0:
+ optionalDependencies:
+ '@esbuild/aix-ppc64': 0.28.0
+ '@esbuild/android-arm': 0.28.0
+ '@esbuild/android-arm64': 0.28.0
+ '@esbuild/android-x64': 0.28.0
+ '@esbuild/darwin-arm64': 0.28.0
+ '@esbuild/darwin-x64': 0.28.0
+ '@esbuild/freebsd-arm64': 0.28.0
+ '@esbuild/freebsd-x64': 0.28.0
+ '@esbuild/linux-arm': 0.28.0
+ '@esbuild/linux-arm64': 0.28.0
+ '@esbuild/linux-ia32': 0.28.0
+ '@esbuild/linux-loong64': 0.28.0
+ '@esbuild/linux-mips64el': 0.28.0
+ '@esbuild/linux-ppc64': 0.28.0
+ '@esbuild/linux-riscv64': 0.28.0
+ '@esbuild/linux-s390x': 0.28.0
+ '@esbuild/linux-x64': 0.28.0
+ '@esbuild/netbsd-arm64': 0.28.0
+ '@esbuild/netbsd-x64': 0.28.0
+ '@esbuild/openbsd-arm64': 0.28.0
+ '@esbuild/openbsd-x64': 0.28.0
+ '@esbuild/openharmony-arm64': 0.28.0
+ '@esbuild/sunos-x64': 0.28.0
+ '@esbuild/win32-arm64': 0.28.0
+ '@esbuild/win32-ia32': 0.28.0
+ '@esbuild/win32-x64': 0.28.0
+
+ escalade@3.2.0: {}
+
+ escape-html@1.0.3: {}
+
+ escape-string-regexp@1.0.5: {}
+
+ escape-string-regexp@4.0.0: {}
+
+ escape-string-regexp@5.0.0: {}
+
+ eslint-config-flat-gitignore@2.3.0(eslint@9.39.4(jiti@2.7.0)):
+ dependencies:
+ '@eslint/compat': 2.1.0(eslint@9.39.4(jiti@2.7.0))
+ eslint: 9.39.4(jiti@2.7.0)
+
+ eslint-flat-config-utils@3.2.0:
+ dependencies:
+ '@eslint/config-helpers': 0.5.5
+ pathe: 2.0.3
+
+ eslint-import-context@0.1.9(unrs-resolver@1.12.2):
+ dependencies:
+ get-tsconfig: 4.14.0
+ stable-hash-x: 0.2.0
+ optionalDependencies:
+ unrs-resolver: 1.12.2
+
+ eslint-merge-processors@2.0.0(eslint@9.39.4(jiti@2.7.0)):
+ dependencies:
+ eslint: 9.39.4(jiti@2.7.0)
+
+ eslint-plugin-import-lite@0.5.2(eslint@9.39.4(jiti@2.7.0)):
+ dependencies:
+ eslint: 9.39.4(jiti@2.7.0)
+
+ eslint-plugin-import-x@4.16.2(@typescript-eslint/utils@8.59.4(eslint@9.39.4(jiti@2.7.0))(typescript@6.0.3))(eslint@9.39.4(jiti@2.7.0)):
+ dependencies:
+ '@package-json/types': 0.0.12
+ '@typescript-eslint/types': 8.59.4
+ comment-parser: 1.4.6
+ debug: 4.4.3
+ eslint: 9.39.4(jiti@2.7.0)
+ eslint-import-context: 0.1.9(unrs-resolver@1.12.2)
+ is-glob: 4.0.3
+ minimatch: 10.2.5
+ semver: 7.8.0
+ stable-hash-x: 0.2.0
+ unrs-resolver: 1.12.2
+ optionalDependencies:
+ '@typescript-eslint/utils': 8.59.4(eslint@9.39.4(jiti@2.7.0))(typescript@6.0.3)
+ transitivePeerDependencies:
+ - supports-color
+
+ eslint-plugin-jsdoc@62.9.0(eslint@9.39.4(jiti@2.7.0)):
+ dependencies:
+ '@es-joy/jsdoccomment': 0.86.0
+ '@es-joy/resolve.exports': 1.2.0
+ are-docs-informative: 0.0.2
+ comment-parser: 1.4.6
+ debug: 4.4.3
+ escape-string-regexp: 4.0.0
+ eslint: 9.39.4(jiti@2.7.0)
+ espree: 11.2.0
+ esquery: 1.7.0
+ html-entities: 2.6.0
+ object-deep-merge: 2.0.1
+ parse-imports-exports: 0.2.4
+ semver: 7.8.0
+ spdx-expression-parse: 4.0.0
+ to-valid-identifier: 1.0.0
+ transitivePeerDependencies:
+ - supports-color
+
+ eslint-plugin-no-only-tests@3.4.0: {}
+
+ eslint-plugin-perfectionist@5.9.0(eslint@9.39.4(jiti@2.7.0))(typescript@6.0.3):
+ dependencies:
+ '@typescript-eslint/utils': 8.59.4(eslint@9.39.4(jiti@2.7.0))(typescript@6.0.3)
+ eslint: 9.39.4(jiti@2.7.0)
+ natural-orderby: 5.0.0
+ transitivePeerDependencies:
+ - supports-color
+ - typescript
+
+ eslint-plugin-regexp@3.1.0(eslint@9.39.4(jiti@2.7.0)):
+ dependencies:
+ '@eslint-community/eslint-utils': 4.9.1(eslint@9.39.4(jiti@2.7.0))
+ '@eslint-community/regexpp': 4.12.2
+ comment-parser: 1.4.6
+ eslint: 9.39.4(jiti@2.7.0)
+ jsdoc-type-pratt-parser: 7.2.0
+ refa: 0.12.1
+ regexp-ast-analysis: 0.7.1
+ scslre: 0.3.0
+
+ eslint-plugin-unicorn@63.0.0(eslint@9.39.4(jiti@2.7.0)):
+ dependencies:
+ '@babel/helper-validator-identifier': 7.28.5
+ '@eslint-community/eslint-utils': 4.9.1(eslint@9.39.4(jiti@2.7.0))
+ change-case: 5.4.4
+ ci-info: 4.4.0
+ clean-regexp: 1.0.0
+ core-js-compat: 3.49.0
+ eslint: 9.39.4(jiti@2.7.0)
+ find-up-simple: 1.0.1
+ globals: 16.5.0
+ indent-string: 5.0.0
+ is-builtin-module: 5.0.0
+ jsesc: 3.1.0
+ pluralize: 8.0.0
+ regexp-tree: 0.1.27
+ regjsparser: 0.13.1
+ semver: 7.8.0
+ strip-indent: 4.1.1
+
+ eslint-plugin-vue@10.9.1(@stylistic/eslint-plugin@5.10.0(eslint@9.39.4(jiti@2.7.0)))(@typescript-eslint/parser@8.59.3(eslint@9.39.4(jiti@2.7.0))(typescript@6.0.3))(eslint@9.39.4(jiti@2.7.0))(vue-eslint-parser@10.4.0(eslint@9.39.4(jiti@2.7.0))):
+ dependencies:
+ '@eslint-community/eslint-utils': 4.9.1(eslint@9.39.4(jiti@2.7.0))
+ eslint: 9.39.4(jiti@2.7.0)
+ natural-compare: 1.4.0
+ nth-check: 2.1.1
+ postcss-selector-parser: 7.1.1
+ semver: 7.8.0
+ vue-eslint-parser: 10.4.0(eslint@9.39.4(jiti@2.7.0))
+ xml-name-validator: 4.0.0
+ optionalDependencies:
+ '@stylistic/eslint-plugin': 5.10.0(eslint@9.39.4(jiti@2.7.0))
+ '@typescript-eslint/parser': 8.59.3(eslint@9.39.4(jiti@2.7.0))(typescript@6.0.3)
+
+ eslint-processor-vue-blocks@2.0.0(@vue/compiler-sfc@3.5.34)(eslint@9.39.4(jiti@2.7.0)):
+ dependencies:
+ '@vue/compiler-sfc': 3.5.34
+ eslint: 9.39.4(jiti@2.7.0)
+
+ eslint-scope@5.1.1:
+ dependencies:
+ esrecurse: 4.3.0
+ estraverse: 4.3.0
+
+ eslint-scope@8.4.0:
+ dependencies:
+ esrecurse: 4.3.0
+ estraverse: 5.3.0
+
+ eslint-scope@9.1.2:
+ dependencies:
+ '@types/esrecurse': 4.3.1
+ '@types/estree': 1.0.9
+ esrecurse: 4.3.0
+ estraverse: 5.3.0
+
+ eslint-typegen@2.3.1(eslint@9.39.4(jiti@2.7.0)):
+ dependencies:
+ eslint: 9.39.4(jiti@2.7.0)
+ json-schema-to-typescript-lite: 15.0.0
+ ohash: 2.0.11
+
+ eslint-visitor-keys@3.4.3: {}
+
+ eslint-visitor-keys@4.2.1: {}
+
+ eslint-visitor-keys@5.0.1: {}
+
+ eslint@9.39.4(jiti@2.7.0):
+ dependencies:
+ '@eslint-community/eslint-utils': 4.9.1(eslint@9.39.4(jiti@2.7.0))
+ '@eslint-community/regexpp': 4.12.2
+ '@eslint/config-array': 0.21.2
+ '@eslint/config-helpers': 0.4.2
+ '@eslint/core': 0.17.0
+ '@eslint/eslintrc': 3.3.5
+ '@eslint/js': 9.39.4
+ '@eslint/plugin-kit': 0.4.1
+ '@humanfs/node': 0.16.8
+ '@humanwhocodes/module-importer': 1.0.1
+ '@humanwhocodes/retry': 0.4.3
+ '@types/estree': 1.0.9
+ ajv: 6.15.0
+ chalk: 4.1.2
+ cross-spawn: 7.0.6
+ debug: 4.4.3
+ escape-string-regexp: 4.0.0
+ eslint-scope: 8.4.0
+ eslint-visitor-keys: 4.2.1
+ espree: 10.4.0
+ esquery: 1.7.0
+ esutils: 2.0.3
+ fast-deep-equal: 3.1.3
+ file-entry-cache: 8.0.0
+ find-up: 5.0.0
+ glob-parent: 6.0.2
+ ignore: 5.3.2
+ imurmurhash: 0.1.4
+ is-glob: 4.0.3
+ json-stable-stringify-without-jsonify: 1.0.1
+ lodash.merge: 4.6.2
+ minimatch: 3.1.5
+ natural-compare: 1.4.0
+ optionator: 0.9.4
+ optionalDependencies:
+ jiti: 2.7.0
+ transitivePeerDependencies:
+ - supports-color
+
+ espree@10.4.0:
+ dependencies:
+ acorn: 8.16.0
+ acorn-jsx: 5.3.2(acorn@8.16.0)
+ eslint-visitor-keys: 4.2.1
+
+ espree@11.2.0:
+ dependencies:
+ acorn: 8.16.0
+ acorn-jsx: 5.3.2(acorn@8.16.0)
+ eslint-visitor-keys: 5.0.1
+
+ esquery@1.7.0:
+ dependencies:
+ estraverse: 5.3.0
+
+ esrecurse@4.3.0:
+ dependencies:
+ estraverse: 5.3.0
+
+ estraverse@4.3.0: {}
+
+ estraverse@5.3.0: {}
+
+ estree-walker@2.0.2: {}
+
+ estree-walker@3.0.3:
+ dependencies:
+ '@types/estree': 1.0.9
+
+ esutils@2.0.3: {}
+
+ etag@1.8.1: {}
+
+ event-target-shim@5.0.1: {}
+
+ events-universal@1.0.1:
+ dependencies:
+ bare-events: 2.8.3
+ transitivePeerDependencies:
+ - bare-abort-controller
+
+ events@3.3.0: {}
+
+ execa@8.0.1:
+ dependencies:
+ cross-spawn: 7.0.6
+ get-stream: 8.0.1
+ human-signals: 5.0.0
+ is-stream: 3.0.0
+ merge-stream: 2.0.0
+ npm-run-path: 5.3.0
+ onetime: 6.0.0
+ signal-exit: 4.1.0
+ strip-final-newline: 3.0.0
+
+ expect-type@1.3.0: {}
+
+ exsolve@1.0.8: {}
+
+ extend@3.0.2: {}
+
+ fake-indexeddb@6.2.5: {}
+
+ fast-deep-equal@3.1.3: {}
+
+ fast-fifo@1.3.2: {}
+
+ fast-glob@3.3.3:
+ dependencies:
+ '@nodelib/fs.stat': 2.0.5
+ '@nodelib/fs.walk': 1.2.8
+ glob-parent: 5.1.2
+ merge2: 1.4.1
+ micromatch: 4.0.8
+
+ fast-json-stable-stringify@2.1.0: {}
+
+ fast-levenshtein@2.0.6: {}
+
+ fast-npm-meta@1.5.1: {}
+
+ fast-safe-stringify@2.1.1: {}
+
+ fast-string-truncated-width@1.2.1: {}
+
+ fast-string-truncated-width@3.0.3: {}
+
+ fast-string-width@1.1.0:
+ dependencies:
+ fast-string-truncated-width: 1.2.1
+
+ fast-string-width@3.0.2:
+ dependencies:
+ fast-string-truncated-width: 3.0.3
+
+ fast-uri@3.1.2: {}
+
+ fast-wrap-ansi@0.1.6:
+ dependencies:
+ fast-string-width: 1.1.0
+
+ fast-wrap-ansi@0.2.2:
+ dependencies:
+ fast-string-width: 3.0.2
+
+ fastq@1.20.1:
+ dependencies:
+ reusify: 1.1.0
+
+ fault@2.0.1:
+ dependencies:
+ format: 0.2.2
+
+ fd-package-json@2.0.0:
+ dependencies:
+ walk-up-path: 4.0.0
+
+ fdir@6.5.0(picomatch@4.0.4):
+ optionalDependencies:
+ picomatch: 4.0.4
+
+ fflate@0.8.3: {}
+
+ file-entry-cache@8.0.0:
+ dependencies:
+ flat-cache: 4.0.1
+
+ file-loader@6.2.0(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)):
+ dependencies:
+ loader-utils: 2.0.4
+ schema-utils: 3.3.0
+ webpack: 5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)
+
+ file-uri-to-path@1.0.0: {}
+
+ fill-range@7.1.1:
+ dependencies:
+ to-regex-range: 5.0.1
+
+ find-up-simple@1.0.1: {}
+
+ find-up@5.0.0:
+ dependencies:
+ locate-path: 6.0.0
+ path-exists: 4.0.0
+
+ find-up@6.3.0:
+ dependencies:
+ locate-path: 7.2.0
+ path-exists: 5.0.0
+
+ fix-dts-default-cjs-exports@1.0.1:
+ dependencies:
+ magic-string: 0.30.21
+ mlly: 1.8.2
+ rollup: 4.60.4
+
+ flat-cache@4.0.1:
+ dependencies:
+ flatted: 3.4.2
+ keyv: 4.5.4
+
+ flat@6.0.1: {}
+
+ flatted@3.4.2: {}
+
+ floating-vue@5.2.2(@nuxt/kit@packages+kit)(vue@3.5.34(typescript@6.0.3)):
+ dependencies:
+ '@floating-ui/dom': 1.1.1
+ vue: 3.5.34(typescript@6.0.3)
+ vue-resize: 2.0.0-alpha.1(vue@3.5.34(typescript@6.0.3))
+ optionalDependencies:
+ '@nuxt/kit': link:packages/kit
+
+ follow-redirects@1.16.0: {}
+
+ for-each@0.3.5:
+ dependencies:
+ is-callable: 1.2.7
+
+ foreground-child@3.3.1:
+ dependencies:
+ cross-spawn: 7.0.6
+ signal-exit: 4.1.0
+
+ fork-ts-checker-webpack-plugin@9.1.0(typescript@6.0.3)(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)):
+ dependencies:
+ '@babel/code-frame': 7.29.0
+ chalk: 4.1.2
+ chokidar: 4.0.3
+ cosmiconfig: 8.3.6(typescript@6.0.3)
+ deepmerge: 4.3.1
+ fs-extra: 10.1.0
+ memfs: 3.6.0
+ minimatch: 3.1.5
+ node-abort-controller: 3.1.1
+ schema-utils: 3.3.0
+ semver: 7.8.0
+ tapable: 2.3.3
+ typescript: 6.0.3
+ webpack: 5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)
+
+ form-data@4.0.5:
+ dependencies:
+ asynckit: 0.4.0
+ combined-stream: 1.0.8
+ es-set-tostringtag: 2.1.0
+ hasown: 2.0.3
+ mime-types: 2.1.35
+
+ format@0.2.2: {}
+
+ formatly@0.3.0:
+ dependencies:
+ fd-package-json: 2.0.0
+
+ fraction.js@5.3.4: {}
+
+ fresh@2.0.0: {}
+
+ fs-extra@10.1.0:
+ dependencies:
+ graceful-fs: 4.2.11
+ jsonfile: 6.2.1
+ universalify: 2.0.1
+
+ fs-monkey@1.1.0: {}
+
+ fsevents@2.3.2:
+ optional: true
+
+ fsevents@2.3.3:
+ optional: true
+
+ function-bind@1.1.2: {}
+
+ functions-have-names@1.2.3: {}
+
+ fuse.js@7.3.0: {}
+
+ fzf@0.5.2: {}
+
+ gensync@1.0.0-beta.2: {}
+
+ get-caller-file@2.0.5: {}
+
+ get-east-asian-width@1.6.0: {}
+
+ get-intrinsic@1.3.0:
+ dependencies:
+ call-bind-apply-helpers: 1.0.2
+ es-define-property: 1.0.1
+ es-errors: 1.3.0
+ es-object-atoms: 1.1.2
+ function-bind: 1.1.2
+ get-proto: 1.0.1
+ gopd: 1.2.0
+ has-symbols: 1.1.0
+ hasown: 2.0.3
+ math-intrinsics: 1.1.0
+
+ get-port-please@3.2.0: {}
+
+ get-proto@1.0.1:
+ dependencies:
+ dunder-proto: 1.0.1
+ es-object-atoms: 1.1.2
+
+ get-stream@8.0.1: {}
+
+ get-tsconfig@4.14.0:
+ dependencies:
+ resolve-pkg-maps: 1.0.0
+
+ get-tsconfig@5.0.0-beta.5:
+ dependencies:
+ resolve-pkg-maps: 1.0.0
+
+ giget@3.2.0: {}
+
+ github-slugger@2.0.0: {}
+
+ glob-parent@5.1.2:
+ dependencies:
+ is-glob: 4.0.3
+
+ glob-parent@6.0.2:
+ dependencies:
+ is-glob: 4.0.3
+
+ glob-to-regex.js@1.2.0(tslib@2.8.1):
+ dependencies:
+ tslib: 2.8.1
+
+ glob-to-regexp@0.4.1: {}
+
+ glob@10.5.0:
+ dependencies:
+ foreground-child: 3.3.1
+ jackspeak: 3.4.3
+ minimatch: 9.0.9
+ minipass: 7.1.3
+ package-json-from-dist: 1.0.1
+ path-scurry: 1.11.1
+
+ glob@13.0.6:
+ dependencies:
+ minimatch: 10.2.5
+ minipass: 7.1.3
+ path-scurry: 2.0.2
+
+ globals@14.0.0: {}
+
+ globals@16.5.0: {}
+
+ globals@17.6.0: {}
+
+ globby@16.2.0:
+ dependencies:
+ '@sindresorhus/merge-streams': 4.0.0
+ fast-glob: 3.3.3
+ ignore: 7.0.5
+ is-path-inside: 4.0.0
+ slash: 5.1.0
+ unicorn-magic: 0.4.0
+
+ gopd@1.2.0: {}
+
+ graceful-fs@4.2.11: {}
+
+ gzip-size@6.0.0:
+ dependencies:
+ duplexer: 0.1.2
+
+ gzip-size@7.0.0:
+ dependencies:
+ duplexer: 0.1.2
+
+ h3@1.15.11:
+ dependencies:
+ cookie-es: 1.2.3
+ crossws: 0.3.5
+ defu: 6.1.7
+ destr: 2.0.5
+ iron-webcrypto: 1.2.1
+ node-mock-http: 1.0.4
+ radix3: 1.1.2
+ ufo: 1.6.4
+ uncrypto: 0.1.3
+
+ h3@2.0.1-rc.20(crossws@0.4.5(srvx@0.11.15)):
+ dependencies:
+ rou3: 0.8.1
+ srvx: 0.11.15
+ optionalDependencies:
+ crossws: 0.4.5(srvx@0.11.15)
+
+ h3@2.0.1-rc.22(crossws@0.4.5(srvx@0.11.15)):
+ dependencies:
+ rou3: 0.8.1
+ srvx: 0.11.15
+ optionalDependencies:
+ crossws: 0.4.5(srvx@0.11.15)
+
+ happy-dom@20.9.0:
+ dependencies:
+ '@types/node': 24.12.4
+ '@types/whatwg-mimetype': 3.0.2
+ '@types/ws': 8.18.1
+ entities: 7.0.1
+ whatwg-mimetype: 3.0.0
+ ws: 8.21.0
+ transitivePeerDependencies:
+ - bufferutil
+ - utf-8-validate
+
+ has-bigints@1.1.0: {}
+
+ has-flag@3.0.0: {}
+
+ has-flag@4.0.0: {}
+
+ has-property-descriptors@1.0.2:
+ dependencies:
+ es-define-property: 1.0.1
+
+ has-symbols@1.1.0: {}
+
+ has-tostringtag@1.0.2:
+ dependencies:
+ has-symbols: 1.1.0
+
+ hash-sum@2.0.0: {}
+
+ hasown@2.0.3:
+ dependencies:
+ function-bind: 1.1.2
+
+ hast-util-embedded@3.0.0:
+ dependencies:
+ '@types/hast': 3.0.4
+ hast-util-is-element: 3.0.0
+
+ hast-util-format@1.1.0:
+ dependencies:
+ '@types/hast': 3.0.4
+ hast-util-embedded: 3.0.0
+ hast-util-minify-whitespace: 1.0.1
+ hast-util-phrasing: 3.0.1
+ hast-util-whitespace: 3.0.0
+ html-whitespace-sensitive-tag-names: 3.0.1
+ unist-util-visit-parents: 6.0.2
+
+ hast-util-from-parse5@8.0.3:
+ dependencies:
+ '@types/hast': 3.0.4
+ '@types/unist': 3.0.3
+ devlop: 1.1.0
+ hastscript: 9.0.1
+ property-information: 7.1.0
+ vfile: 6.0.3
+ vfile-location: 5.0.3
+ web-namespaces: 2.0.1
+
+ hast-util-has-property@3.0.0:
+ dependencies:
+ '@types/hast': 3.0.4
+
+ hast-util-heading-rank@3.0.0:
+ dependencies:
+ '@types/hast': 3.0.4
+
+ hast-util-is-body-ok-link@3.0.1:
+ dependencies:
+ '@types/hast': 3.0.4
+
+ hast-util-is-element@3.0.0:
+ dependencies:
+ '@types/hast': 3.0.4
+
+ hast-util-minify-whitespace@1.0.1:
+ dependencies:
+ '@types/hast': 3.0.4
+ hast-util-embedded: 3.0.0
+ hast-util-is-element: 3.0.0
+ hast-util-whitespace: 3.0.0
+ unist-util-is: 6.0.1
+
+ hast-util-parse-selector@4.0.0:
+ dependencies:
+ '@types/hast': 3.0.4
+
+ hast-util-phrasing@3.0.1:
+ dependencies:
+ '@types/hast': 3.0.4
+ hast-util-embedded: 3.0.0
+ hast-util-has-property: 3.0.0
+ hast-util-is-body-ok-link: 3.0.1
+ hast-util-is-element: 3.0.0
+
+ hast-util-raw@9.1.0:
+ dependencies:
+ '@types/hast': 3.0.4
+ '@types/unist': 3.0.3
+ '@ungap/structured-clone': 1.3.1
+ hast-util-from-parse5: 8.0.3
+ hast-util-to-parse5: 8.0.1
+ html-void-elements: 3.0.0
+ mdast-util-to-hast: 13.2.1
+ parse5: 7.3.0
+ unist-util-position: 5.0.0
+ unist-util-visit: 5.1.0
+ vfile: 6.0.3
+ web-namespaces: 2.0.1
+ zwitch: 2.0.4
+
+ hast-util-to-html@9.0.5:
+ dependencies:
+ '@types/hast': 3.0.4
+ '@types/unist': 3.0.3
+ ccount: 2.0.1
+ comma-separated-tokens: 2.0.3
+ hast-util-whitespace: 3.0.0
+ html-void-elements: 3.0.0
+ mdast-util-to-hast: 13.2.1
+ property-information: 7.1.0
+ space-separated-tokens: 2.0.2
+ stringify-entities: 4.0.4
+ zwitch: 2.0.4
+
+ hast-util-to-mdast@10.1.2:
+ dependencies:
+ '@types/hast': 3.0.4
+ '@types/mdast': 4.0.4
+ '@ungap/structured-clone': 1.3.1
+ hast-util-phrasing: 3.0.1
+ hast-util-to-html: 9.0.5
+ hast-util-to-text: 4.0.2
+ hast-util-whitespace: 3.0.0
+ mdast-util-phrasing: 4.1.0
+ mdast-util-to-hast: 13.2.1
+ mdast-util-to-string: 4.0.0
+ rehype-minify-whitespace: 6.0.2
+ trim-trailing-lines: 2.1.0
+ unist-util-position: 5.0.0
+ unist-util-visit: 5.1.0
+
+ hast-util-to-parse5@8.0.1:
+ dependencies:
+ '@types/hast': 3.0.4
+ comma-separated-tokens: 2.0.3
+ devlop: 1.1.0
+ property-information: 7.1.0
+ space-separated-tokens: 2.0.2
+ web-namespaces: 2.0.1
+ zwitch: 2.0.4
+
+ hast-util-to-string@3.0.1:
+ dependencies:
+ '@types/hast': 3.0.4
+
+ hast-util-to-text@4.0.2:
+ dependencies:
+ '@types/hast': 3.0.4
+ '@types/unist': 3.0.3
+ hast-util-is-element: 3.0.0
+ unist-util-find-after: 5.0.0
+
+ hast-util-whitespace@3.0.0:
+ dependencies:
+ '@types/hast': 3.0.4
+
+ hastscript@9.0.1:
+ dependencies:
+ '@types/hast': 3.0.4
+ comma-separated-tokens: 2.0.3
+ hast-util-parse-selector: 4.0.0
+ property-information: 7.1.0
+ space-separated-tokens: 2.0.2
+
+ highlight.js@10.7.3: {}
+
+ hookable@5.5.3: {}
+
+ hookable@6.1.1: {}
+
+ hosted-git-info@7.0.2:
+ dependencies:
+ lru-cache: 10.4.3
+
+ html-entities@2.6.0: {}
+
+ html-escaper@2.0.2: {}
+
+ html-escaper@3.0.3: {}
+
+ html-validate@11.2.0(@vitest/expect@4.1.7)(vitest@4.1.7):
+ dependencies:
+ '@html-validate/stylish': 6.0.0
+ '@sidvind/better-ajv-errors': 7.0.0(ajv@8.20.0)
+ ajv: 8.20.0
+ kleur: 4.1.5
+ prompts: 2.4.2
+ semver: 7.8.0
+ optionalDependencies:
+ '@vitest/expect': 4.1.7
+ vitest: 4.1.7(@types/node@24.12.4)(@vitest/coverage-v8@4.1.7)(happy-dom@20.9.0)(vite@8.0.12)
+
+ html-void-elements@3.0.0: {}
+
+ html-whitespace-sensitive-tag-names@3.0.1: {}
+
+ htmlnano@3.3.1(cssnano@8.0.1(postcss@8.5.14))(postcss@8.5.14)(svgo@4.0.1)(terser@5.48.0)(typescript@6.0.3):
+ dependencies:
+ '@types/relateurl': 0.2.33
+ commander: 14.0.3
+ cosmiconfig: 9.0.1(typescript@6.0.3)
+ posthtml: 0.16.7
+ optionalDependencies:
+ cssnano: 8.0.1(postcss@8.5.14)
+ postcss: 8.5.14
+ svgo: 4.0.1
+ terser: 5.48.0
+ transitivePeerDependencies:
+ - typescript
+
+ htmlparser2@10.1.0:
+ dependencies:
+ domelementtype: 2.3.0
+ domhandler: 5.0.3
+ domutils: 3.2.2
+ entities: 7.0.1
+
+ htmlparser2@7.2.0:
+ dependencies:
+ domelementtype: 2.3.0
+ domhandler: 4.3.1
+ domutils: 2.8.0
+ entities: 3.0.1
+
+ http-errors@2.0.1:
+ dependencies:
+ depd: 2.0.0
+ inherits: 2.0.4
+ setprototypeof: 1.2.0
+ statuses: 2.0.2
+ toidentifier: 1.0.1
+
+ http-shutdown@1.2.2: {}
+
+ https-proxy-agent@5.0.1:
+ dependencies:
+ agent-base: 6.0.2
+ debug: 4.4.3
+ transitivePeerDependencies:
+ - supports-color
+
+ https-proxy-agent@7.0.6:
+ dependencies:
+ agent-base: 7.1.4
+ debug: 4.4.3
+ transitivePeerDependencies:
+ - supports-color
+
+ httpxy@0.5.3: {}
+
+ human-signals@5.0.0: {}
+
+ hyperdyperid@1.2.0: {}
+
+ icss-utils@5.1.0(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+
+ ieee754@1.2.1: {}
+
+ ignore@5.3.2: {}
+
+ ignore@7.0.5: {}
+
+ image-meta@0.2.2: {}
+
+ import-fresh@3.3.1:
+ dependencies:
+ parent-module: 1.0.1
+ resolve-from: 4.0.0
+
+ import-meta-resolve@4.2.0: {}
+
+ impound@1.1.5:
+ dependencies:
+ '@jridgewell/trace-mapping': 0.3.31
+ es-module-lexer: 2.1.0
+ pathe: 2.0.3
+ unplugin: 3.0.0
+ unplugin-utils: 0.3.1
+
+ imurmurhash@0.1.4: {}
+
+ indent-string@5.0.0: {}
+
+ index-to-position@1.2.0: {}
+
+ individual@3.0.0: {}
+
+ inherits@2.0.4: {}
+
+ ini@1.3.8: {}
+
+ ini@4.1.3: {}
+
+ installed-check-core@8.3.1:
+ dependencies:
+ '@voxpelli/semver-set': 6.0.2
+ '@voxpelli/typed-utils': 1.10.2
+ is-glob: 4.0.3
+ list-installed: 5.3.1
+ picomatch: 4.0.4
+ semver: 7.8.0
+
+ installed-check@10.0.1:
+ dependencies:
+ chalk: 5.6.2
+ installed-check-core: 8.3.1
+ peowly: 1.3.3
+ pony-cause: 2.1.11
+ resolve-workspace-root: 2.0.1
+ version-guard: 1.1.3
+
+ internal-slot@1.1.0:
+ dependencies:
+ es-errors: 1.3.0
+ hasown: 2.0.3
+ side-channel: 1.1.0
+
+ ioredis@5.10.1:
+ dependencies:
+ '@ioredis/commands': 1.5.1
+ cluster-key-slot: 1.1.2
+ debug: 4.4.3
+ denque: 2.1.0
+ lodash.defaults: 4.2.0
+ lodash.isarguments: 3.1.0
+ redis-errors: 1.2.0
+ redis-parser: 3.0.0
+ standard-as-callback: 2.1.0
+ transitivePeerDependencies:
+ - supports-color
+
+ iron-webcrypto@1.2.1: {}
+
+ is-absolute-url@4.0.1: {}
+
+ is-alphabetical@2.0.1: {}
+
+ is-alphanumerical@2.0.1:
+ dependencies:
+ is-alphabetical: 2.0.1
+ is-decimal: 2.0.1
+
+ is-arguments@1.2.0:
+ dependencies:
+ call-bound: 1.0.4
+ has-tostringtag: 1.0.2
+
+ is-array-buffer@3.0.5:
+ dependencies:
+ call-bind: 1.0.9
+ call-bound: 1.0.4
+ get-intrinsic: 1.3.0
+
+ is-arrayish@0.2.1: {}
+
+ is-bigint@1.1.0:
+ dependencies:
+ has-bigints: 1.1.0
+
+ is-binary-path@2.1.0:
+ dependencies:
+ binary-extensions: 2.3.0
+
+ is-boolean-object@1.2.2:
+ dependencies:
+ call-bound: 1.0.4
+ has-tostringtag: 1.0.2
+
+ is-builtin-module@5.0.0:
+ dependencies:
+ builtin-modules: 5.2.0
+
+ is-callable@1.2.7: {}
+
+ is-core-module@2.16.2:
+ dependencies:
+ hasown: 2.0.3
+
+ is-date-object@1.1.0:
+ dependencies:
+ call-bound: 1.0.4
+ has-tostringtag: 1.0.2
+
+ is-decimal@2.0.1: {}
+
+ is-docker@3.0.0: {}
+
+ is-expression@4.0.0:
+ dependencies:
+ acorn: 7.4.1
+ object-assign: 4.1.1
+
+ is-extglob@2.1.1: {}
+
+ is-fullwidth-code-point@3.0.0: {}
+
+ is-glob@4.0.3:
+ dependencies:
+ is-extglob: 2.1.1
+
+ is-hexadecimal@2.0.1: {}
+
+ is-in-ssh@1.0.0: {}
+
+ is-inside-container@1.0.0:
+ dependencies:
+ is-docker: 3.0.0
+
+ is-json@2.0.1: {}
+
+ is-map@2.0.3: {}
+
+ is-module@1.0.0: {}
+
+ is-number-object@1.1.1:
+ dependencies:
+ call-bound: 1.0.4
+ has-tostringtag: 1.0.2
+
+ is-number@7.0.0: {}
+
+ is-path-inside@4.0.0: {}
+
+ is-plain-obj@4.1.0: {}
+
+ is-promise@2.2.2: {}
+
+ is-reference@1.2.1:
+ dependencies:
+ '@types/estree': 1.0.9
+
+ is-regex@1.2.1:
+ dependencies:
+ call-bound: 1.0.4
+ gopd: 1.2.0
+ has-tostringtag: 1.0.2
+ hasown: 2.0.3
+
+ is-set@2.0.3: {}
+
+ is-shared-array-buffer@1.0.4:
+ dependencies:
+ call-bound: 1.0.4
+
+ is-stream@2.0.1: {}
+
+ is-stream@3.0.0: {}
+
+ is-string@1.1.1:
+ dependencies:
+ call-bound: 1.0.4
+ has-tostringtag: 1.0.2
+
+ is-symbol@1.1.1:
+ dependencies:
+ call-bound: 1.0.4
+ has-symbols: 1.1.0
+ safe-regex-test: 1.1.0
+
+ is-weakmap@2.0.2: {}
+
+ is-weakset@2.0.4:
+ dependencies:
+ call-bound: 1.0.4
+ get-intrinsic: 1.3.0
+
+ is-windows@1.0.2: {}
+
+ is-wsl@3.1.1:
+ dependencies:
+ is-inside-container: 1.0.0
+
+ isarray@1.0.0: {}
+
+ isarray@2.0.5: {}
+
+ isexe@2.0.0: {}
+
+ isexe@4.0.0: {}
+
+ istanbul-lib-coverage@3.2.2: {}
+
+ istanbul-lib-report@3.0.1:
+ dependencies:
+ istanbul-lib-coverage: 3.2.2
+ make-dir: 4.0.0
+ supports-color: 7.2.0
+
+ istanbul-reports@3.2.0:
+ dependencies:
+ html-escaper: 2.0.2
+ istanbul-lib-report: 3.0.1
+
+ jackspeak@3.4.3:
+ dependencies:
+ '@isaacs/cliui': 8.0.2
+ optionalDependencies:
+ '@pkgjs/parseargs': 0.11.0
+
+ jest-regex-util@30.4.0: {}
+
+ jest-util@30.4.1:
+ dependencies:
+ '@jest/types': 30.4.1
+ '@types/node': 24.12.4
+ chalk: 4.1.2
+ ci-info: 4.4.0
+ graceful-fs: 4.2.11
+ picomatch: 4.0.4
+
+ jest-worker@27.5.1:
+ dependencies:
+ '@types/node': 24.12.4
+ merge-stream: 2.0.0
+ supports-color: 8.1.1
+
+ jest-worker@30.4.1:
+ dependencies:
+ '@types/node': 24.12.4
+ '@ungap/structured-clone': 1.3.1
+ jest-util: 30.4.1
+ merge-stream: 2.0.0
+ supports-color: 8.1.1
+
+ jiti@1.21.7: {}
+
+ jiti@2.7.0: {}
+
+ js-beautify@1.15.4:
+ dependencies:
+ config-chain: 1.1.13
+ editorconfig: 1.0.7
+ glob: 10.5.0
+ js-cookie: 3.0.7
+ nopt: 7.2.1
+
+ js-cookie@3.0.7: {}
+
+ js-stringify@1.0.2: {}
+
+ js-tokens@10.0.0: {}
+
+ js-tokens@4.0.0: {}
+
+ js-tokens@9.0.1: {}
+
+ js-yaml@4.1.1:
+ dependencies:
+ argparse: 2.0.1
+
+ jsdoc-type-pratt-parser@7.2.0: {}
+
+ jsesc@3.1.0: {}
+
+ json-buffer@3.0.1: {}
+
+ json-parse-even-better-errors@2.3.1: {}
+
+ json-parse-even-better-errors@3.0.2: {}
+
+ json-schema-to-typescript-lite@15.0.0:
+ dependencies:
+ '@apidevtools/json-schema-ref-parser': 14.2.1(@types/json-schema@7.0.15)
+ '@types/json-schema': 7.0.15
+
+ json-schema-traverse@0.4.1: {}
+
+ json-schema-traverse@1.0.0: {}
+
+ json-stable-stringify-without-jsonify@1.0.1: {}
+
+ json5@1.0.2:
+ dependencies:
+ minimist: 1.2.8
+
+ json5@2.2.3: {}
+
+ jsonc-parser@3.3.1: {}
+
+ jsonfile@6.2.1:
+ dependencies:
+ universalify: 2.0.1
+ optionalDependencies:
+ graceful-fs: 4.2.11
+
+ jsonpointer@5.0.1: {}
+
+ jstransformer@1.0.0:
+ dependencies:
+ is-promise: 2.2.2
+ promise: 7.3.1
+
+ katex@0.16.47:
+ dependencies:
+ commander: 8.3.0
+
+ keyv@4.5.4:
+ dependencies:
+ json-buffer: 3.0.1
+
+ kleur@3.0.3: {}
+
+ kleur@4.1.5: {}
+
+ klona@2.0.6: {}
+
+ knip@6.14.1(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0):
+ dependencies:
+ fdir: 6.5.0(picomatch@4.0.4)
+ formatly: 0.3.0
+ get-tsconfig: 4.14.0
+ jiti: 2.7.0
+ minimist: 1.2.8
+ oxc-parser: 0.130.0
+ oxc-resolver: 11.19.1(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0)
+ picomatch: 4.0.4
+ smol-toml: 1.6.1
+ strip-json-comments: 5.0.3
+ tinyglobby: 0.2.16
+ unbash: 3.0.0
+ yaml: 2.9.0
+ zod: 4.4.3
+ transitivePeerDependencies:
+ - '@emnapi/core'
+ - '@emnapi/runtime'
+
+ knitwork@1.3.0: {}
+
+ launch-editor@2.13.2:
+ dependencies:
+ picocolors: 1.1.1
+ shell-quote: 1.8.4
+
+ lazystream@1.0.1:
+ dependencies:
+ readable-stream: 2.3.8
+
+ levn@0.4.1:
+ dependencies:
+ prelude-ls: 1.2.1
+ type-check: 0.4.0
+
+ lightningcss-android-arm64@1.32.0:
+ optional: true
+
+ lightningcss-darwin-arm64@1.32.0:
+ optional: true
+
+ lightningcss-darwin-x64@1.32.0:
+ optional: true
+
+ lightningcss-freebsd-x64@1.32.0:
+ optional: true
+
+ lightningcss-linux-arm-gnueabihf@1.32.0:
+ optional: true
+
+ lightningcss-linux-arm64-gnu@1.32.0:
+ optional: true
+
+ lightningcss-linux-arm64-musl@1.32.0:
+ optional: true
+
+ lightningcss-linux-x64-gnu@1.32.0:
+ optional: true
+
+ lightningcss-linux-x64-musl@1.32.0:
+ optional: true
+
+ lightningcss-win32-arm64-msvc@1.32.0:
+ optional: true
+
+ lightningcss-win32-x64-msvc@1.32.0:
+ optional: true
+
+ lightningcss@1.32.0:
+ dependencies:
+ detect-libc: 2.1.2
+ optionalDependencies:
+ lightningcss-android-arm64: 1.32.0
+ lightningcss-darwin-arm64: 1.32.0
+ lightningcss-darwin-x64: 1.32.0
+ lightningcss-freebsd-x64: 1.32.0
+ lightningcss-linux-arm-gnueabihf: 1.32.0
+ lightningcss-linux-arm64-gnu: 1.32.0
+ lightningcss-linux-arm64-musl: 1.32.0
+ lightningcss-linux-x64-gnu: 1.32.0
+ lightningcss-linux-x64-musl: 1.32.0
+ lightningcss-win32-arm64-msvc: 1.32.0
+ lightningcss-win32-x64-msvc: 1.32.0
+
+ lilconfig@3.1.3: {}
+
+ lines-and-columns@1.2.4: {}
+
+ linkify-it@5.0.0:
+ dependencies:
+ uc.micro: 2.1.0
+
+ list-installed@5.3.1:
+ dependencies:
+ buffered-async-iterable: 1.0.1
+ pony-cause: 2.1.11
+ read-pkg: 9.0.1
+ read-workspaces: 1.2.2
+
+ listhen@1.10.0(srvx@0.11.15):
+ dependencies:
+ '@parcel/watcher': 2.5.6
+ '@parcel/watcher-wasm': 2.5.6
+ citty: 0.2.2
+ consola: 3.4.2
+ crossws: 0.4.5(srvx@0.11.15)
+ defu: 6.1.7
+ get-port-please: 3.2.0
+ h3: 1.15.11
+ http-shutdown: 1.2.2
+ jiti: 2.7.0
+ mlly: 1.8.2
+ node-forge: 1.4.0
+ pathe: 2.0.3
+ std-env: 4.1.0
+ tinyclip: 0.1.12
+ ufo: 1.6.4
+ untun: 0.1.3
+ uqr: 0.1.3
+ transitivePeerDependencies:
+ - srvx
+
+ loader-runner@4.3.2: {}
+
+ loader-utils@1.4.2:
+ dependencies:
+ big.js: 5.2.2
+ emojis-list: 3.0.0
+ json5: 1.0.2
+
+ loader-utils@2.0.4:
+ dependencies:
+ big.js: 5.2.2
+ emojis-list: 3.0.0
+ json5: 2.2.3
+
+ local-pkg@1.2.1:
+ dependencies:
+ mlly: 1.8.2
+ pkg-types: 2.3.1
+ quansync: 0.2.11
+
+ locate-path@6.0.0:
+ dependencies:
+ p-locate: 5.0.0
+
+ locate-path@7.2.0:
+ dependencies:
+ p-locate: 6.0.0
+
+ lodash.defaults@4.2.0: {}
+
+ lodash.isarguments@3.1.0: {}
+
+ lodash.memoize@4.1.2: {}
+
+ lodash.merge@4.6.2: {}
+
+ lodash.uniq@4.5.0: {}
+
+ lodash@4.18.1: {}
+
+ logs-sdk@0.0.6:
+ dependencies:
+ magic-string: 0.30.21
+ oxc-parser: 0.126.0
+ unplugin: 3.0.0
+
+ longest-streak@3.1.0: {}
+
+ lru-cache@10.4.3: {}
+
+ lru-cache@11.5.0: {}
+
+ lru-cache@5.1.1:
+ dependencies:
+ yallist: 3.1.1
+
+ lz-string@1.5.0: {}
+
+ magic-regexp@0.10.0:
+ dependencies:
+ estree-walker: 3.0.3
+ magic-string: 0.30.21
+ mlly: 1.8.2
+ regexp-tree: 0.1.27
+ type-level-regexp: 0.1.17
+ ufo: 1.6.4
+ unplugin: 2.3.11
+
+ magic-regexp@0.11.0:
+ dependencies:
+ magic-string: 0.30.21
+ regexp-tree: 0.1.27
+ type-level-regexp: 0.1.17
+ unplugin: 3.0.0
+
+ magic-string-ast@1.0.3:
+ dependencies:
+ magic-string: 0.30.21
+
+ magic-string@0.30.21:
+ dependencies:
+ '@jridgewell/sourcemap-codec': 1.5.5
+
+ magicast@0.5.3:
+ dependencies:
+ '@babel/parser': 7.29.3
+ '@babel/types': 7.29.0
+ source-map-js: 1.2.1
+
+ make-dir@3.1.0:
+ dependencies:
+ semver: 6.3.1
+
+ make-dir@4.0.0:
+ dependencies:
+ semver: 7.8.0
+
+ markdown-it@14.1.1:
+ dependencies:
+ argparse: 2.0.1
+ entities: 4.5.0
+ linkify-it: 5.0.0
+ mdurl: 2.0.0
+ punycode.js: 2.3.1
+ uc.micro: 2.1.0
+
+ markdown-table@3.0.4: {}
+
+ markdownlint-cli@0.48.0:
+ dependencies:
+ commander: 14.0.3
+ deep-extend: 0.6.0
+ ignore: 7.0.5
+ js-yaml: 4.1.1
+ jsonc-parser: 3.3.1
+ jsonpointer: 5.0.1
+ markdown-it: 14.1.1
+ markdownlint: 0.40.0
+ minimatch: 10.2.5
+ run-con: 1.3.2
+ smol-toml: 1.6.1
+ tinyglobby: 0.2.16
+ transitivePeerDependencies:
+ - supports-color
+
+ markdownlint@0.40.0:
+ dependencies:
+ micromark: 4.0.2
+ micromark-core-commonmark: 2.0.3
+ micromark-extension-directive: 4.0.0
+ micromark-extension-gfm-autolink-literal: 2.1.0
+ micromark-extension-gfm-footnote: 2.1.0
+ micromark-extension-gfm-table: 2.1.1
+ micromark-extension-math: 3.1.0
+ micromark-util-types: 2.0.2
+ string-width: 8.1.0
+ transitivePeerDependencies:
+ - supports-color
+
+ marked-terminal@7.3.0(marked@9.1.6):
+ dependencies:
+ ansi-escapes: 7.3.0
+ ansi-regex: 6.2.2
+ chalk: 5.6.2
+ cli-highlight: 2.1.11
+ cli-table3: 0.6.5
+ marked: 9.1.6
+ node-emoji: 2.2.0
+ supports-hyperlinks: 3.2.0
+
+ marked@9.1.6: {}
+
+ math-intrinsics@1.1.0: {}
+
+ mdast-util-find-and-replace@3.0.2:
+ dependencies:
+ '@types/mdast': 4.0.4
+ escape-string-regexp: 5.0.0
+ unist-util-is: 6.0.1
+ unist-util-visit-parents: 6.0.2
+
+ mdast-util-from-markdown@2.0.3:
+ dependencies:
+ '@types/mdast': 4.0.4
+ '@types/unist': 3.0.3
+ decode-named-character-reference: 1.3.0
+ devlop: 1.1.0
+ mdast-util-to-string: 4.0.0
+ micromark: 4.0.2
+ micromark-util-decode-numeric-character-reference: 2.0.2
+ micromark-util-decode-string: 2.0.1
+ micromark-util-normalize-identifier: 2.0.1
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+ unist-util-stringify-position: 4.0.0
+ transitivePeerDependencies:
+ - supports-color
+
+ mdast-util-frontmatter@2.0.1:
+ dependencies:
+ '@types/mdast': 4.0.4
+ devlop: 1.1.0
+ escape-string-regexp: 5.0.0
+ mdast-util-from-markdown: 2.0.3
+ mdast-util-to-markdown: 2.1.2
+ micromark-extension-frontmatter: 2.0.0
+ transitivePeerDependencies:
+ - supports-color
+
+ mdast-util-gfm-autolink-literal@2.0.1:
+ dependencies:
+ '@types/mdast': 4.0.4
+ ccount: 2.0.1
+ devlop: 1.1.0
+ mdast-util-find-and-replace: 3.0.2
+ micromark-util-character: 2.1.1
+
+ mdast-util-gfm-footnote@2.1.0:
+ dependencies:
+ '@types/mdast': 4.0.4
+ devlop: 1.1.0
+ mdast-util-from-markdown: 2.0.3
+ mdast-util-to-markdown: 2.1.2
+ micromark-util-normalize-identifier: 2.0.1
+ transitivePeerDependencies:
+ - supports-color
+
+ mdast-util-gfm-strikethrough@2.0.0:
+ dependencies:
+ '@types/mdast': 4.0.4
+ mdast-util-from-markdown: 2.0.3
+ mdast-util-to-markdown: 2.1.2
+ transitivePeerDependencies:
+ - supports-color
+
+ mdast-util-gfm-table@2.0.0:
+ dependencies:
+ '@types/mdast': 4.0.4
+ devlop: 1.1.0
+ markdown-table: 3.0.4
+ mdast-util-from-markdown: 2.0.3
+ mdast-util-to-markdown: 2.1.2
+ transitivePeerDependencies:
+ - supports-color
+
+ mdast-util-gfm-task-list-item@2.0.0:
+ dependencies:
+ '@types/mdast': 4.0.4
+ devlop: 1.1.0
+ mdast-util-from-markdown: 2.0.3
+ mdast-util-to-markdown: 2.1.2
+ transitivePeerDependencies:
+ - supports-color
+
+ mdast-util-gfm@3.1.0:
+ dependencies:
+ mdast-util-from-markdown: 2.0.3
+ mdast-util-gfm-autolink-literal: 2.0.1
+ mdast-util-gfm-footnote: 2.1.0
+ mdast-util-gfm-strikethrough: 2.0.0
+ mdast-util-gfm-table: 2.0.0
+ mdast-util-gfm-task-list-item: 2.0.0
+ mdast-util-to-markdown: 2.1.2
+ transitivePeerDependencies:
+ - supports-color
+
+ mdast-util-math@3.0.0:
+ dependencies:
+ '@types/hast': 3.0.4
+ '@types/mdast': 4.0.4
+ devlop: 1.1.0
+ longest-streak: 3.1.0
+ mdast-util-from-markdown: 2.0.3
+ mdast-util-to-markdown: 2.1.2
+ unist-util-remove-position: 5.0.0
+ transitivePeerDependencies:
+ - supports-color
+
+ mdast-util-phrasing@4.1.0:
+ dependencies:
+ '@types/mdast': 4.0.4
+ unist-util-is: 6.0.1
+
+ mdast-util-to-hast@13.2.1:
+ dependencies:
+ '@types/hast': 3.0.4
+ '@types/mdast': 4.0.4
+ '@ungap/structured-clone': 1.3.1
+ devlop: 1.1.0
+ micromark-util-sanitize-uri: 2.0.1
+ trim-lines: 3.0.1
+ unist-util-position: 5.0.0
+ unist-util-visit: 5.1.0
+ vfile: 6.0.3
+
+ mdast-util-to-markdown@2.1.2:
+ dependencies:
+ '@types/mdast': 4.0.4
+ '@types/unist': 3.0.3
+ longest-streak: 3.1.0
+ mdast-util-phrasing: 4.1.0
+ mdast-util-to-string: 4.0.0
+ micromark-util-classify-character: 2.0.1
+ micromark-util-decode-string: 2.0.1
+ unist-util-visit: 5.1.0
+ zwitch: 2.0.4
+
+ mdast-util-to-string@4.0.0:
+ dependencies:
+ '@types/mdast': 4.0.4
+
+ mdn-data@2.0.28: {}
+
+ mdn-data@2.27.1: {}
+
+ mdurl@2.0.0: {}
+
+ memfs@3.6.0:
+ dependencies:
+ fs-monkey: 1.1.0
+
+ memfs@4.57.2(tslib@2.8.1):
+ dependencies:
+ '@jsonjoy.com/fs-core': 4.57.2(tslib@2.8.1)
+ '@jsonjoy.com/fs-fsa': 4.57.2(tslib@2.8.1)
+ '@jsonjoy.com/fs-node': 4.57.2(tslib@2.8.1)
+ '@jsonjoy.com/fs-node-builtins': 4.57.2(tslib@2.8.1)
+ '@jsonjoy.com/fs-node-to-fsa': 4.57.2(tslib@2.8.1)
+ '@jsonjoy.com/fs-node-utils': 4.57.2(tslib@2.8.1)
+ '@jsonjoy.com/fs-print': 4.57.2(tslib@2.8.1)
+ '@jsonjoy.com/fs-snapshot': 4.57.2(tslib@2.8.1)
+ '@jsonjoy.com/json-pack': 1.21.0(tslib@2.8.1)
+ '@jsonjoy.com/util': 1.9.0(tslib@2.8.1)
+ glob-to-regex.js: 1.2.0(tslib@2.8.1)
+ thingies: 2.6.0(tslib@2.8.1)
+ tree-dump: 1.1.0(tslib@2.8.1)
+ tslib: 2.8.1
+
+ memory-fs@0.5.0:
+ dependencies:
+ errno: 0.1.8
+ readable-stream: 2.3.8
+
+ merge-stream@2.0.0: {}
+
+ merge2@1.4.1: {}
+
+ micromark-core-commonmark@2.0.3:
+ dependencies:
+ decode-named-character-reference: 1.3.0
+ devlop: 1.1.0
+ micromark-factory-destination: 2.0.1
+ micromark-factory-label: 2.0.1
+ micromark-factory-space: 2.0.1
+ micromark-factory-title: 2.0.1
+ micromark-factory-whitespace: 2.0.1
+ micromark-util-character: 2.1.1
+ micromark-util-chunked: 2.0.1
+ micromark-util-classify-character: 2.0.1
+ micromark-util-html-tag-name: 2.0.1
+ micromark-util-normalize-identifier: 2.0.1
+ micromark-util-resolve-all: 2.0.1
+ micromark-util-subtokenize: 2.1.0
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-extension-directive@4.0.0:
+ dependencies:
+ devlop: 1.1.0
+ micromark-factory-space: 2.0.1
+ micromark-factory-whitespace: 2.0.1
+ micromark-util-character: 2.1.1
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+ parse-entities: 4.0.2
+
+ micromark-extension-frontmatter@2.0.0:
+ dependencies:
+ fault: 2.0.1
+ micromark-util-character: 2.1.1
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-extension-gfm-autolink-literal@2.1.0:
+ dependencies:
+ micromark-util-character: 2.1.1
+ micromark-util-sanitize-uri: 2.0.1
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-extension-gfm-footnote@2.1.0:
+ dependencies:
+ devlop: 1.1.0
+ micromark-core-commonmark: 2.0.3
+ micromark-factory-space: 2.0.1
+ micromark-util-character: 2.1.1
+ micromark-util-normalize-identifier: 2.0.1
+ micromark-util-sanitize-uri: 2.0.1
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-extension-gfm-strikethrough@2.1.0:
+ dependencies:
+ devlop: 1.1.0
+ micromark-util-chunked: 2.0.1
+ micromark-util-classify-character: 2.0.1
+ micromark-util-resolve-all: 2.0.1
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-extension-gfm-table@2.1.1:
+ dependencies:
+ devlop: 1.1.0
+ micromark-factory-space: 2.0.1
+ micromark-util-character: 2.1.1
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-extension-gfm-tagfilter@2.0.0:
+ dependencies:
+ micromark-util-types: 2.0.2
+
+ micromark-extension-gfm-task-list-item@2.1.0:
+ dependencies:
+ devlop: 1.1.0
+ micromark-factory-space: 2.0.1
+ micromark-util-character: 2.1.1
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-extension-gfm@3.0.0:
+ dependencies:
+ micromark-extension-gfm-autolink-literal: 2.1.0
+ micromark-extension-gfm-footnote: 2.1.0
+ micromark-extension-gfm-strikethrough: 2.1.0
+ micromark-extension-gfm-table: 2.1.1
+ micromark-extension-gfm-tagfilter: 2.0.0
+ micromark-extension-gfm-task-list-item: 2.1.0
+ micromark-util-combine-extensions: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-extension-math@3.1.0:
+ dependencies:
+ '@types/katex': 0.16.8
+ devlop: 1.1.0
+ katex: 0.16.47
+ micromark-factory-space: 2.0.1
+ micromark-util-character: 2.1.1
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-factory-destination@2.0.1:
+ dependencies:
+ micromark-util-character: 2.1.1
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-factory-label@2.0.1:
+ dependencies:
+ devlop: 1.1.0
+ micromark-util-character: 2.1.1
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-factory-space@2.0.1:
+ dependencies:
+ micromark-util-character: 2.1.1
+ micromark-util-types: 2.0.2
+
+ micromark-factory-title@2.0.1:
+ dependencies:
+ micromark-factory-space: 2.0.1
+ micromark-util-character: 2.1.1
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-factory-whitespace@2.0.1:
+ dependencies:
+ micromark-factory-space: 2.0.1
+ micromark-util-character: 2.1.1
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-util-character@2.1.1:
+ dependencies:
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-util-chunked@2.0.1:
+ dependencies:
+ micromark-util-symbol: 2.0.1
+
+ micromark-util-classify-character@2.0.1:
+ dependencies:
+ micromark-util-character: 2.1.1
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-util-combine-extensions@2.0.1:
+ dependencies:
+ micromark-util-chunked: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-util-decode-numeric-character-reference@2.0.2:
+ dependencies:
+ micromark-util-symbol: 2.0.1
+
+ micromark-util-decode-string@2.0.1:
+ dependencies:
+ decode-named-character-reference: 1.3.0
+ micromark-util-character: 2.1.1
+ micromark-util-decode-numeric-character-reference: 2.0.2
+ micromark-util-symbol: 2.0.1
+
+ micromark-util-encode@2.0.1: {}
+
+ micromark-util-html-tag-name@2.0.1: {}
+
+ micromark-util-normalize-identifier@2.0.1:
+ dependencies:
+ micromark-util-symbol: 2.0.1
+
+ micromark-util-resolve-all@2.0.1:
+ dependencies:
+ micromark-util-types: 2.0.2
+
+ micromark-util-sanitize-uri@2.0.1:
+ dependencies:
+ micromark-util-character: 2.1.1
+ micromark-util-encode: 2.0.1
+ micromark-util-symbol: 2.0.1
+
+ micromark-util-subtokenize@2.1.0:
+ dependencies:
+ devlop: 1.1.0
+ micromark-util-chunked: 2.0.1
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+
+ micromark-util-symbol@2.0.1: {}
+
+ micromark-util-types@2.0.2: {}
+
+ micromark@4.0.2:
+ dependencies:
+ '@types/debug': 4.1.13
+ debug: 4.4.3
+ decode-named-character-reference: 1.3.0
+ devlop: 1.1.0
+ micromark-core-commonmark: 2.0.3
+ micromark-factory-space: 2.0.1
+ micromark-util-character: 2.1.1
+ micromark-util-chunked: 2.0.1
+ micromark-util-combine-extensions: 2.0.1
+ micromark-util-decode-numeric-character-reference: 2.0.2
+ micromark-util-encode: 2.0.1
+ micromark-util-normalize-identifier: 2.0.1
+ micromark-util-resolve-all: 2.0.1
+ micromark-util-sanitize-uri: 2.0.1
+ micromark-util-subtokenize: 2.1.0
+ micromark-util-symbol: 2.0.1
+ micromark-util-types: 2.0.2
+ transitivePeerDependencies:
+ - supports-color
+
+ micromatch@4.0.8:
+ dependencies:
+ braces: 3.0.3
+ picomatch: 2.3.2
+
+ mime-db@1.52.0: {}
+
+ mime-db@1.54.0: {}
+
+ mime-types@2.1.35:
+ dependencies:
+ mime-db: 1.52.0
+
+ mime-types@3.0.2:
+ dependencies:
+ mime-db: 1.54.0
+
+ mime@2.5.2: {}
+
+ mime@4.1.0: {}
+
+ mimic-fn@4.0.0: {}
+
+ mini-css-extract-plugin@2.10.2(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)):
+ dependencies:
+ schema-utils: 4.3.3
+ tapable: 2.3.3
+ webpack: 5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)
+
+ minimatch@10.2.5:
+ dependencies:
+ brace-expansion: 5.0.6
+
+ minimatch@3.1.5:
+ dependencies:
+ brace-expansion: 1.1.14
+
+ minimatch@5.1.9:
+ dependencies:
+ brace-expansion: 2.1.0
+
+ minimatch@9.0.9:
+ dependencies:
+ brace-expansion: 2.1.0
+
+ minimist@1.2.8: {}
+
+ minipass@7.1.3: {}
+
+ minizlib@3.1.0:
+ dependencies:
+ minipass: 7.1.3
+
+ mkdist@2.4.1(typescript@6.0.3)(vue-sfc-transformer@0.1.17(@vue/compiler-core@3.5.34)(esbuild@0.28.0)(vue@3.5.34(typescript@6.0.3)))(vue-tsc@3.2.9(typescript@6.0.3))(vue@3.5.34(typescript@6.0.3)):
+ dependencies:
+ autoprefixer: 10.5.0(postcss@8.5.14)
+ citty: 0.1.6
+ cssnano: 7.1.9(postcss@8.5.14)
+ defu: 6.1.7
+ esbuild: 0.25.12
+ jiti: 1.21.7
+ mlly: 1.8.2
+ pathe: 2.0.3
+ pkg-types: 2.3.1
+ postcss: 8.5.14
+ postcss-nested: 7.0.2(postcss@8.5.14)
+ semver: 7.8.0
+ tinyglobby: 0.2.16
+ optionalDependencies:
+ typescript: 6.0.3
+ vue: 3.5.34(typescript@6.0.3)
+ vue-sfc-transformer: 0.1.17(@vue/compiler-core@3.5.34)(esbuild@0.28.0)(vue@3.5.34(typescript@6.0.3))
+ vue-tsc: 3.2.9(typescript@6.0.3)
+
+ mlly@1.8.2:
+ dependencies:
+ acorn: 8.16.0
+ pathe: 2.0.3
+ pkg-types: 1.3.1
+ ufo: 1.6.4
+
+ mocked-exports@0.1.1: {}
+
+ mri@1.2.0: {}
+
+ mrmime@2.0.1: {}
+
+ ms@2.1.3: {}
+
+ muggle-string@0.4.1: {}
+
+ mz@2.7.0:
+ dependencies:
+ any-promise: 1.3.0
+ object-assign: 4.1.1
+ thenify-all: 1.6.0
+
+ nanoid@3.3.12: {}
+
+ nanotar@0.3.0: {}
+
+ napi-postinstall@0.3.4: {}
+
+ natural-compare@1.4.0: {}
+
+ natural-orderby@5.0.0: {}
+
+ neo-async@2.6.2: {}
+
+ nf3@0.3.17: {}
+
+ nitro@3.0.260311-beta(chokidar@5.0.0)(dotenv@17.4.2)(giget@3.2.0)(ioredis@5.10.1)(jiti@2.7.0)(lru-cache@11.5.0)(rollup@4.60.4)(vite@8.0.12):
+ dependencies:
+ consola: 3.4.2
+ crossws: 0.4.5(srvx@0.11.15)
+ db0: 0.3.4
+ env-runner: 0.1.9
+ h3: 2.0.1-rc.22(crossws@0.4.5(srvx@0.11.15))
+ hookable: 6.1.1
+ nf3: 0.3.17
+ ocache: 0.1.4
+ ofetch: 2.0.0-alpha.3
+ ohash: 2.0.11
+ rolldown: 1.0.2
+ srvx: 0.11.15
+ unenv: 2.0.0-rc.24
+ unstorage: 2.0.0-alpha.7(chokidar@5.0.0)(db0@0.3.4)(ioredis@5.10.1)(lru-cache@11.5.0)(ofetch@2.0.0-alpha.3)
+ optionalDependencies:
+ dotenv: 17.4.2
+ giget: 3.2.0
+ jiti: 2.7.0
+ rollup: 4.60.4
+ vite: 8.0.12(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0)
+ transitivePeerDependencies:
+ - '@azure/app-configuration'
+ - '@azure/cosmos'
+ - '@azure/data-tables'
+ - '@azure/identity'
+ - '@azure/keyvault-secrets'
+ - '@azure/storage-blob'
+ - '@capacitor/preferences'
+ - '@deno/kv'
+ - '@electric-sql/pglite'
+ - '@libsql/client'
+ - '@netlify/blobs'
+ - '@netlify/runtime'
+ - '@planetscale/database'
+ - '@upstash/redis'
+ - '@vercel/blob'
+ - '@vercel/functions'
+ - '@vercel/kv'
+ - '@vercel/queue'
+ - aws4fetch
+ - better-sqlite3
+ - chokidar
+ - drizzle-orm
+ - idb-keyval
+ - ioredis
+ - lru-cache
+ - miniflare
+ - mongodb
+ - mysql2
+ - sqlite3
+ - uploadthing
+
+ nitropack@2.13.4(oxc-parser@0.130.0)(rolldown@1.0.2)(srvx@0.11.15):
+ dependencies:
+ '@cloudflare/kv-asset-handler': 0.4.2
+ '@rollup/plugin-alias': 6.0.0(rollup@4.60.4)
+ '@rollup/plugin-commonjs': 29.0.2(rollup@4.60.4)
+ '@rollup/plugin-inject': 5.0.5(rollup@4.60.4)
+ '@rollup/plugin-json': 6.1.0(rollup@4.60.4)
+ '@rollup/plugin-node-resolve': 16.0.3(rollup@4.60.4)
+ '@rollup/plugin-replace': 6.0.3(rollup@4.60.4)
+ '@rollup/plugin-terser': 1.0.0(rollup@4.60.4)
+ '@vercel/nft': 1.5.0(rollup@4.60.4)
+ archiver: 7.0.1
+ c12: 3.3.4(magicast@0.5.3)
+ chokidar: 5.0.0
+ citty: 0.2.2
+ compatx: 0.2.0
+ confbox: 0.2.4
+ consola: 3.4.2
+ cookie-es: 2.0.1
+ croner: 10.0.1
+ crossws: 0.3.5
+ db0: 0.3.4
+ defu: 6.1.7
+ destr: 2.0.5
+ dot-prop: 10.1.0
+ esbuild: 0.28.0
+ escape-string-regexp: 5.0.0
+ etag: 1.8.1
+ exsolve: 1.0.8
+ globby: 16.2.0
+ gzip-size: 7.0.0
+ h3: 1.15.11
+ hookable: 5.5.3
+ httpxy: 0.5.3
+ ioredis: 5.10.1
+ jiti: 2.7.0
+ klona: 2.0.6
+ knitwork: 1.3.0
+ listhen: 1.10.0(srvx@0.11.15)
+ magic-string: 0.30.21
+ magicast: 0.5.3
+ mime: 4.1.0
+ mlly: 1.8.2
+ node-fetch-native: 1.6.7
+ node-mock-http: 1.0.4
+ ofetch: 1.5.1
+ ohash: 2.0.11
+ pathe: 2.0.3
+ perfect-debounce: 2.1.0
+ pkg-types: 2.3.1
+ pretty-bytes: 7.1.0
+ radix3: 1.1.2
+ rollup: 4.60.4
+ rollup-plugin-visualizer: 7.0.1(rolldown@1.0.2)(rollup@4.60.4)
+ scule: 1.3.0
+ semver: 7.8.0
+ serve-placeholder: 2.0.2
+ serve-static: 2.2.1
+ source-map: 0.7.6
+ std-env: 4.1.0
+ ufo: 1.6.4
+ ultrahtml: 1.6.0
+ uncrypto: 0.1.3
+ unctx: 2.5.0
+ unenv: 2.0.0-rc.24
+ unimport: 6.3.0(oxc-parser@0.130.0)(rolldown@1.0.2)
+ unplugin-utils: 0.3.1
+ unstorage: 1.17.5(db0@0.3.4)(ioredis@5.10.1)
+ untyped: 2.0.0
+ unwasm: 0.5.3
+ youch: 4.1.1
+ youch-core: 0.3.3
+ transitivePeerDependencies:
+ - '@azure/app-configuration'
+ - '@azure/cosmos'
+ - '@azure/data-tables'
+ - '@azure/identity'
+ - '@azure/keyvault-secrets'
+ - '@azure/storage-blob'
+ - '@capacitor/preferences'
+ - '@deno/kv'
+ - '@electric-sql/pglite'
+ - '@libsql/client'
+ - '@netlify/blobs'
+ - '@planetscale/database'
+ - '@upstash/redis'
+ - '@vercel/blob'
+ - '@vercel/functions'
+ - '@vercel/kv'
+ - aws4fetch
+ - bare-abort-controller
+ - bare-buffer
+ - better-sqlite3
+ - drizzle-orm
+ - encoding
+ - idb-keyval
+ - mysql2
+ - oxc-parser
+ - react-native-b4a
+ - rolldown
+ - sqlite3
+ - srvx
+ - supports-color
+ - uploadthing
+
+ node-abort-controller@3.1.1: {}
+
+ node-addon-api@7.1.1: {}
+
+ node-emoji@2.2.0:
+ dependencies:
+ '@sindresorhus/is': 4.6.0
+ char-regex: 1.0.2
+ emojilib: 2.4.0
+ skin-tone: 2.0.0
+
+ node-fetch-native@1.6.7: {}
+
+ node-fetch@2.7.0:
+ dependencies:
+ whatwg-url: 5.0.0
+
+ node-forge@1.4.0: {}
+
+ node-gyp-build@4.8.4: {}
+
+ node-mock-http@1.0.4: {}
+
+ node-releases@2.0.46: {}
+
+ nopt@7.2.1:
+ dependencies:
+ abbrev: 2.0.0
+
+ nopt@8.1.0:
+ dependencies:
+ abbrev: 3.0.1
+
+ normalize-package-data@6.0.2:
+ dependencies:
+ hosted-git-info: 7.0.2
+ semver: 7.8.0
+ validate-npm-package-license: 3.0.4
+
+ normalize-path@3.0.0: {}
+
+ npm-normalize-package-bin@3.0.1: {}
+
+ npm-run-path@5.3.0:
+ dependencies:
+ path-key: 4.0.0
+
+ npm-run-path@6.0.0:
+ dependencies:
+ path-key: 4.0.0
+ unicorn-magic: 0.3.0
+
+ nth-check@2.1.1:
+ dependencies:
+ boolbase: 1.0.0
+
+ nuxt-content-twoslash@0.4.0(@nuxtjs/mdc@0.22.0):
+ dependencies:
+ '@nuxt/kit': link:packages/kit
+ '@nuxtjs/mdc': 0.22.0
+ '@shikijs/vitepress-twoslash': 4.1.0(@nuxt/kit@packages+kit)(typescript@5.9.3)
+ ansis: 4.3.0
+ cac: 7.0.0
+ chokidar: 5.0.0
+ fast-glob: 3.3.3
+ pathe: 2.0.3
+ picomatch: 4.0.4
+ remark-parse: 11.0.0
+ shiki: 4.1.0
+ twoslash: 0.3.8(typescript@5.9.3)
+ typescript: 5.9.3
+ unified: 11.0.5
+ unist-util-visit: 5.1.0
+ transitivePeerDependencies:
+ - supports-color
+
+ nypm@0.6.6:
+ dependencies:
+ citty: 0.2.2
+ pathe: 2.0.3
+ tinyexec: 1.1.2
+
+ object-assign@4.1.1: {}
+
+ object-deep-merge@2.0.1: {}
+
+ object-inspect@1.13.4: {}
+
+ object-is@1.1.6:
+ dependencies:
+ call-bind: 1.0.9
+ define-properties: 1.2.1
+
+ object-keys@1.1.1: {}
+
+ object.assign@4.1.7:
+ dependencies:
+ call-bind: 1.0.9
+ call-bound: 1.0.4
+ define-properties: 1.2.1
+ es-object-atoms: 1.1.2
+ has-symbols: 1.1.0
+ object-keys: 1.1.1
+
+ obug@2.1.1: {}
+
+ obuild@0.4.36(chokidar@5.0.0)(dotenv@17.4.2)(giget@3.2.0)(jiti@2.7.0)(magicast@0.5.3)(oxc-resolver@11.19.1(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0))(typescript@6.0.3)(vue-tsc@3.2.9(typescript@6.0.3)):
+ dependencies:
+ c12: 4.0.0-beta.5(chokidar@5.0.0)(dotenv@17.4.2)(giget@3.2.0)(jiti@2.7.0)(magicast@0.5.3)
+ consola: 3.4.2
+ defu: 6.1.7
+ exsolve: 1.0.8
+ magic-string: 0.30.21
+ pathe: 2.0.3
+ rolldown: 1.0.2
+ rolldown-plugin-dts: 0.25.1(oxc-resolver@11.19.1(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0))(rolldown@1.0.2)(typescript@6.0.3)(vue-tsc@3.2.9(typescript@6.0.3))
+ tinyglobby: 0.2.16
+ transitivePeerDependencies:
+ - '@ts-macro/tsc'
+ - '@typescript/native-preview'
+ - chokidar
+ - dotenv
+ - giget
+ - jiti
+ - magicast
+ - oxc-resolver
+ - typescript
+ - vue-tsc
+
+ ocache@0.1.4:
+ dependencies:
+ ohash: 2.0.11
+
+ ofetch@1.5.1:
+ dependencies:
+ destr: 2.0.5
+ node-fetch-native: 1.6.7
+ ufo: 1.6.4
+
+ ofetch@2.0.0-alpha.3: {}
+
+ ohash@2.0.11: {}
+
+ on-change@6.0.2: {}
+
+ on-finished@2.4.1:
+ dependencies:
+ ee-first: 1.1.1
+
+ onetime@6.0.0:
+ dependencies:
+ mimic-fn: 4.0.0
+
+ oniguruma-parser@0.12.2: {}
+
+ oniguruma-to-es@4.3.6:
+ dependencies:
+ oniguruma-parser: 0.12.2
+ regex: 6.1.0
+ regex-recursion: 6.0.2
+
+ open@10.2.0:
+ dependencies:
+ default-browser: 5.5.0
+ define-lazy-prop: 3.0.0
+ is-inside-container: 1.0.0
+ wsl-utils: 0.1.0
+
+ open@11.0.0:
+ dependencies:
+ default-browser: 5.5.0
+ define-lazy-prop: 3.0.0
+ is-in-ssh: 1.0.0
+ is-inside-container: 1.0.0
+ powershell-utils: 0.1.0
+ wsl-utils: 0.3.1
+
+ opener@1.5.2: {}
+
+ optionator@0.9.4:
+ dependencies:
+ deep-is: 0.1.4
+ fast-levenshtein: 2.0.6
+ levn: 0.4.1
+ prelude-ls: 1.2.1
+ type-check: 0.4.0
+ word-wrap: 1.2.5
+
+ oxc-parser@0.124.0(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0):
+ dependencies:
+ '@oxc-project/types': 0.124.0
+ optionalDependencies:
+ '@oxc-parser/binding-android-arm-eabi': 0.124.0
+ '@oxc-parser/binding-android-arm64': 0.124.0
+ '@oxc-parser/binding-darwin-arm64': 0.124.0
+ '@oxc-parser/binding-darwin-x64': 0.124.0
+ '@oxc-parser/binding-freebsd-x64': 0.124.0
+ '@oxc-parser/binding-linux-arm-gnueabihf': 0.124.0
+ '@oxc-parser/binding-linux-arm-musleabihf': 0.124.0
+ '@oxc-parser/binding-linux-arm64-gnu': 0.124.0
+ '@oxc-parser/binding-linux-arm64-musl': 0.124.0
+ '@oxc-parser/binding-linux-ppc64-gnu': 0.124.0
+ '@oxc-parser/binding-linux-riscv64-gnu': 0.124.0
+ '@oxc-parser/binding-linux-riscv64-musl': 0.124.0
+ '@oxc-parser/binding-linux-s390x-gnu': 0.124.0
+ '@oxc-parser/binding-linux-x64-gnu': 0.124.0
+ '@oxc-parser/binding-linux-x64-musl': 0.124.0
+ '@oxc-parser/binding-openharmony-arm64': 0.124.0
+ '@oxc-parser/binding-wasm32-wasi': 0.124.0(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0)
+ '@oxc-parser/binding-win32-arm64-msvc': 0.124.0
+ '@oxc-parser/binding-win32-ia32-msvc': 0.124.0
+ '@oxc-parser/binding-win32-x64-msvc': 0.124.0
+ transitivePeerDependencies:
+ - '@emnapi/core'
+ - '@emnapi/runtime'
+
+ oxc-parser@0.126.0:
+ dependencies:
+ '@oxc-project/types': 0.126.0
+ optionalDependencies:
+ '@oxc-parser/binding-android-arm-eabi': 0.126.0
+ '@oxc-parser/binding-android-arm64': 0.126.0
+ '@oxc-parser/binding-darwin-arm64': 0.126.0
+ '@oxc-parser/binding-darwin-x64': 0.126.0
+ '@oxc-parser/binding-freebsd-x64': 0.126.0
+ '@oxc-parser/binding-linux-arm-gnueabihf': 0.126.0
+ '@oxc-parser/binding-linux-arm-musleabihf': 0.126.0
+ '@oxc-parser/binding-linux-arm64-gnu': 0.126.0
+ '@oxc-parser/binding-linux-arm64-musl': 0.126.0
+ '@oxc-parser/binding-linux-ppc64-gnu': 0.126.0
+ '@oxc-parser/binding-linux-riscv64-gnu': 0.126.0
+ '@oxc-parser/binding-linux-riscv64-musl': 0.126.0
+ '@oxc-parser/binding-linux-s390x-gnu': 0.126.0
+ '@oxc-parser/binding-linux-x64-gnu': 0.126.0
+ '@oxc-parser/binding-linux-x64-musl': 0.126.0
+ '@oxc-parser/binding-openharmony-arm64': 0.126.0
+ '@oxc-parser/binding-wasm32-wasi': 0.126.0
+ '@oxc-parser/binding-win32-arm64-msvc': 0.126.0
+ '@oxc-parser/binding-win32-ia32-msvc': 0.126.0
+ '@oxc-parser/binding-win32-x64-msvc': 0.126.0
+
+ oxc-parser@0.127.0:
+ dependencies:
+ '@oxc-project/types': 0.127.0
+ optionalDependencies:
+ '@oxc-parser/binding-android-arm-eabi': 0.127.0
+ '@oxc-parser/binding-android-arm64': 0.127.0
+ '@oxc-parser/binding-darwin-arm64': 0.127.0
+ '@oxc-parser/binding-darwin-x64': 0.127.0
+ '@oxc-parser/binding-freebsd-x64': 0.127.0
+ '@oxc-parser/binding-linux-arm-gnueabihf': 0.127.0
+ '@oxc-parser/binding-linux-arm-musleabihf': 0.127.0
+ '@oxc-parser/binding-linux-arm64-gnu': 0.127.0
+ '@oxc-parser/binding-linux-arm64-musl': 0.127.0
+ '@oxc-parser/binding-linux-ppc64-gnu': 0.127.0
+ '@oxc-parser/binding-linux-riscv64-gnu': 0.127.0
+ '@oxc-parser/binding-linux-riscv64-musl': 0.127.0
+ '@oxc-parser/binding-linux-s390x-gnu': 0.127.0
+ '@oxc-parser/binding-linux-x64-gnu': 0.127.0
+ '@oxc-parser/binding-linux-x64-musl': 0.127.0
+ '@oxc-parser/binding-openharmony-arm64': 0.127.0
+ '@oxc-parser/binding-wasm32-wasi': 0.127.0
+ '@oxc-parser/binding-win32-arm64-msvc': 0.127.0
+ '@oxc-parser/binding-win32-ia32-msvc': 0.127.0
+ '@oxc-parser/binding-win32-x64-msvc': 0.127.0
+
+ oxc-parser@0.130.0:
+ dependencies:
+ '@oxc-project/types': 0.130.0
+ optionalDependencies:
+ '@oxc-parser/binding-android-arm-eabi': 0.130.0
+ '@oxc-parser/binding-android-arm64': 0.130.0
+ '@oxc-parser/binding-darwin-arm64': 0.130.0
+ '@oxc-parser/binding-darwin-x64': 0.130.0
+ '@oxc-parser/binding-freebsd-x64': 0.130.0
+ '@oxc-parser/binding-linux-arm-gnueabihf': 0.130.0
+ '@oxc-parser/binding-linux-arm-musleabihf': 0.130.0
+ '@oxc-parser/binding-linux-arm64-gnu': 0.130.0
+ '@oxc-parser/binding-linux-arm64-musl': 0.130.0
+ '@oxc-parser/binding-linux-ppc64-gnu': 0.130.0
+ '@oxc-parser/binding-linux-riscv64-gnu': 0.130.0
+ '@oxc-parser/binding-linux-riscv64-musl': 0.130.0
+ '@oxc-parser/binding-linux-s390x-gnu': 0.130.0
+ '@oxc-parser/binding-linux-x64-gnu': 0.130.0
+ '@oxc-parser/binding-linux-x64-musl': 0.130.0
+ '@oxc-parser/binding-openharmony-arm64': 0.130.0
+ '@oxc-parser/binding-wasm32-wasi': 0.130.0
+ '@oxc-parser/binding-win32-arm64-msvc': 0.130.0
+ '@oxc-parser/binding-win32-ia32-msvc': 0.130.0
+ '@oxc-parser/binding-win32-x64-msvc': 0.130.0
+
+ oxc-resolver@11.19.1(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0):
+ optionalDependencies:
+ '@oxc-resolver/binding-android-arm-eabi': 11.19.1
+ '@oxc-resolver/binding-android-arm64': 11.19.1
+ '@oxc-resolver/binding-darwin-arm64': 11.19.1
+ '@oxc-resolver/binding-darwin-x64': 11.19.1
+ '@oxc-resolver/binding-freebsd-x64': 11.19.1
+ '@oxc-resolver/binding-linux-arm-gnueabihf': 11.19.1
+ '@oxc-resolver/binding-linux-arm-musleabihf': 11.19.1
+ '@oxc-resolver/binding-linux-arm64-gnu': 11.19.1
+ '@oxc-resolver/binding-linux-arm64-musl': 11.19.1
+ '@oxc-resolver/binding-linux-ppc64-gnu': 11.19.1
+ '@oxc-resolver/binding-linux-riscv64-gnu': 11.19.1
+ '@oxc-resolver/binding-linux-riscv64-musl': 11.19.1
+ '@oxc-resolver/binding-linux-s390x-gnu': 11.19.1
+ '@oxc-resolver/binding-linux-x64-gnu': 11.19.1
+ '@oxc-resolver/binding-linux-x64-musl': 11.19.1
+ '@oxc-resolver/binding-openharmony-arm64': 11.19.1
+ '@oxc-resolver/binding-wasm32-wasi': 11.19.1(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0)
+ '@oxc-resolver/binding-win32-arm64-msvc': 11.19.1
+ '@oxc-resolver/binding-win32-ia32-msvc': 11.19.1
+ '@oxc-resolver/binding-win32-x64-msvc': 11.19.1
+ transitivePeerDependencies:
+ - '@emnapi/core'
+ - '@emnapi/runtime'
+
+ oxc-transform@0.131.0:
+ optionalDependencies:
+ '@oxc-transform/binding-android-arm-eabi': 0.131.0
+ '@oxc-transform/binding-android-arm64': 0.131.0
+ '@oxc-transform/binding-darwin-arm64': 0.131.0
+ '@oxc-transform/binding-darwin-x64': 0.131.0
+ '@oxc-transform/binding-freebsd-x64': 0.131.0
+ '@oxc-transform/binding-linux-arm-gnueabihf': 0.131.0
+ '@oxc-transform/binding-linux-arm-musleabihf': 0.131.0
+ '@oxc-transform/binding-linux-arm64-gnu': 0.131.0
+ '@oxc-transform/binding-linux-arm64-musl': 0.131.0
+ '@oxc-transform/binding-linux-ppc64-gnu': 0.131.0
+ '@oxc-transform/binding-linux-riscv64-gnu': 0.131.0
+ '@oxc-transform/binding-linux-riscv64-musl': 0.131.0
+ '@oxc-transform/binding-linux-s390x-gnu': 0.131.0
+ '@oxc-transform/binding-linux-x64-gnu': 0.131.0
+ '@oxc-transform/binding-linux-x64-musl': 0.131.0
+ '@oxc-transform/binding-openharmony-arm64': 0.131.0
+ '@oxc-transform/binding-wasm32-wasi': 0.131.0
+ '@oxc-transform/binding-win32-arm64-msvc': 0.131.0
+ '@oxc-transform/binding-win32-ia32-msvc': 0.131.0
+ '@oxc-transform/binding-win32-x64-msvc': 0.131.0
+
+ oxc-walker@0.7.0(oxc-parser@0.124.0(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0)):
+ dependencies:
+ magic-regexp: 0.10.0
+ oxc-parser: 0.124.0(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0)
+
+ oxc-walker@0.7.0(oxc-parser@0.127.0):
+ dependencies:
+ magic-regexp: 0.10.0
+ oxc-parser: 0.127.0
+
+ oxc-walker@1.0.0(oxc-parser@0.130.0)(rolldown@1.0.2):
+ dependencies:
+ magic-regexp: 0.11.0
+ optionalDependencies:
+ oxc-parser: 0.130.0
+ rolldown: 1.0.2
+
+ p-limit@3.1.0:
+ dependencies:
+ yocto-queue: 0.1.0
+
+ p-limit@4.0.0:
+ dependencies:
+ yocto-queue: 1.2.2
+
+ p-limit@7.3.0:
+ dependencies:
+ yocto-queue: 1.2.2
+
+ p-locate@5.0.0:
+ dependencies:
+ p-limit: 3.1.0
+
+ p-locate@6.0.0:
+ dependencies:
+ p-limit: 4.0.0
+
+ package-json-from-dist@1.0.1: {}
+
+ package-manager-detector@1.6.0: {}
+
+ parent-module@1.0.1:
+ dependencies:
+ callsites: 3.1.0
+
+ parse-entities@4.0.2:
+ dependencies:
+ '@types/unist': 2.0.11
+ character-entities-legacy: 3.0.0
+ character-reference-invalid: 2.0.1
+ decode-named-character-reference: 1.3.0
+ is-alphanumerical: 2.0.1
+ is-decimal: 2.0.1
+ is-hexadecimal: 2.0.1
+
+ parse-imports-exports@0.2.4:
+ dependencies:
+ parse-statements: 1.0.11
+
+ parse-json@5.2.0:
+ dependencies:
+ '@babel/code-frame': 7.29.0
+ error-ex: 1.3.4
+ json-parse-even-better-errors: 2.3.1
+ lines-and-columns: 1.2.4
+
+ parse-json@8.3.0:
+ dependencies:
+ '@babel/code-frame': 7.29.0
+ index-to-position: 1.2.0
+ type-fest: 4.41.0
+
+ parse-statements@1.0.11: {}
+
+ parse5-htmlparser2-tree-adapter@6.0.1:
+ dependencies:
+ parse5: 6.0.1
+
+ parse5@5.1.1: {}
+
+ parse5@6.0.1: {}
+
+ parse5@7.3.0:
+ dependencies:
+ entities: 6.0.1
+
+ parse5@8.0.1:
+ dependencies:
+ entities: 8.0.0
+
+ parseurl@1.3.3: {}
+
+ path-browserify@1.0.1: {}
+
+ path-exists@4.0.0: {}
+
+ path-exists@5.0.0: {}
+
+ path-key@3.1.1: {}
+
+ path-key@4.0.0: {}
+
+ path-parse@1.0.7: {}
+
+ path-scurry@1.11.1:
+ dependencies:
+ lru-cache: 10.4.3
+ minipass: 7.1.3
+
+ path-scurry@2.0.2:
+ dependencies:
+ lru-cache: 11.5.0
+ minipass: 7.1.3
+
+ path-type@4.0.0: {}
+
+ pathe@1.1.2: {}
+
+ pathe@2.0.3: {}
+
+ peowly@1.3.3: {}
+
+ perfect-debounce@2.1.0: {}
+
+ picocolors@1.1.1: {}
+
+ picomatch@2.3.2: {}
+
+ picomatch@4.0.4: {}
+
+ pify@2.3.0: {}
+
+ pify@6.1.0: {}
+
+ pkg-pr-new@0.0.74: {}
+
+ pkg-types@1.3.1:
+ dependencies:
+ confbox: 0.1.8
+ mlly: 1.8.2
+ pathe: 2.0.3
+
+ pkg-types@2.3.1:
+ dependencies:
+ confbox: 0.2.4
+ exsolve: 1.0.8
+ pathe: 2.0.3
+
+ playwright-core@1.60.0: {}
+
+ playwright@1.60.0:
+ dependencies:
+ playwright-core: 1.60.0
+ optionalDependencies:
+ fsevents: 2.3.2
+
+ pluralize@8.0.0: {}
+
+ pony-cause@2.1.11: {}
+
+ possible-typed-array-names@1.1.0: {}
+
+ postcss-calc@10.1.1(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+ postcss-selector-parser: 7.1.1
+ postcss-value-parser: 4.2.0
+
+ postcss-colormin@7.0.10(postcss@8.5.14):
+ dependencies:
+ '@colordx/core': 5.4.3
+ browserslist: 4.28.2
+ caniuse-api: 3.0.0
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+
+ postcss-colormin@8.0.0(postcss@8.5.14):
+ dependencies:
+ '@colordx/core': 5.4.3
+ browserslist: 4.28.2
+ caniuse-api: 3.0.0
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+
+ postcss-convert-values@7.0.12(postcss@8.5.14):
+ dependencies:
+ browserslist: 4.28.2
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+
+ postcss-convert-values@8.0.0(postcss@8.5.14):
+ dependencies:
+ browserslist: 4.28.2
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+
+ postcss-discard-comments@7.0.8(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+ postcss-selector-parser: 7.1.1
+
+ postcss-discard-comments@8.0.0(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+ postcss-selector-parser: 7.1.1
+
+ postcss-discard-duplicates@7.0.4(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+
+ postcss-discard-duplicates@8.0.0(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+
+ postcss-discard-empty@7.0.3(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+
+ postcss-discard-empty@8.0.0(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+
+ postcss-discard-overridden@7.0.3(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+
+ postcss-discard-overridden@8.0.0(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+
+ postcss-import-resolver@2.0.0:
+ dependencies:
+ enhanced-resolve: 4.5.0
+
+ postcss-import@16.1.1(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+ read-cache: 1.0.0
+ resolve: 1.22.12
+
+ postcss-loader@8.2.1(@rspack/core@2.0.3)(postcss@8.5.14)(typescript@6.0.3)(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)):
+ dependencies:
+ cosmiconfig: 9.0.1(typescript@6.0.3)
+ jiti: 2.7.0
+ postcss: 8.5.14
+ semver: 7.8.0
+ optionalDependencies:
+ '@rspack/core': 2.0.3
+ webpack: 5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)
+ transitivePeerDependencies:
+ - typescript
+
+ postcss-media-query-parser@0.2.3: {}
+
+ postcss-merge-longhand@7.0.7(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+ stylehacks: 7.0.11(postcss@8.5.14)
+
+ postcss-merge-longhand@8.0.0(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+ stylehacks: 8.0.0(postcss@8.5.14)
+
+ postcss-merge-rules@7.0.11(postcss@8.5.14):
+ dependencies:
+ browserslist: 4.28.2
+ caniuse-api: 3.0.0
+ cssnano-utils: 5.0.3(postcss@8.5.14)
+ postcss: 8.5.14
+ postcss-selector-parser: 7.1.1
+
+ postcss-merge-rules@8.0.0(postcss@8.5.14):
+ dependencies:
+ browserslist: 4.28.2
+ caniuse-api: 3.0.0
+ cssnano-utils: 6.0.0(postcss@8.5.14)
+ postcss: 8.5.14
+ postcss-selector-parser: 7.1.1
+
+ postcss-minify-font-values@7.0.3(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+
+ postcss-minify-font-values@8.0.0(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+
+ postcss-minify-gradients@7.0.5(postcss@8.5.14):
+ dependencies:
+ '@colordx/core': 5.4.3
+ cssnano-utils: 5.0.3(postcss@8.5.14)
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+
+ postcss-minify-gradients@8.0.0(postcss@8.5.14):
+ dependencies:
+ '@colordx/core': 5.4.3
+ cssnano-utils: 6.0.0(postcss@8.5.14)
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+
+ postcss-minify-params@7.0.9(postcss@8.5.14):
+ dependencies:
+ browserslist: 4.28.2
+ cssnano-utils: 5.0.3(postcss@8.5.14)
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+
+ postcss-minify-params@8.0.0(postcss@8.5.14):
+ dependencies:
+ browserslist: 4.28.2
+ cssnano-utils: 6.0.0(postcss@8.5.14)
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+
+ postcss-minify-selectors@7.1.2(postcss@8.5.14):
+ dependencies:
+ browserslist: 4.28.2
+ caniuse-api: 3.0.0
+ cssesc: 3.0.0
+ postcss: 8.5.14
+ postcss-selector-parser: 7.1.1
+
+ postcss-minify-selectors@8.0.1(postcss@8.5.14):
+ dependencies:
+ browserslist: 4.28.2
+ caniuse-api: 3.0.0
+ cssesc: 3.0.0
+ postcss: 8.5.14
+ postcss-selector-parser: 7.1.1
+
+ postcss-modules-extract-imports@3.1.0(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+
+ postcss-modules-local-by-default@4.2.0(postcss@8.5.14):
+ dependencies:
+ icss-utils: 5.1.0(postcss@8.5.14)
+ postcss: 8.5.14
+ postcss-selector-parser: 7.1.1
+ postcss-value-parser: 4.2.0
+
+ postcss-modules-scope@3.2.1(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+ postcss-selector-parser: 7.1.1
+
+ postcss-modules-values@4.0.0(postcss@8.5.14):
+ dependencies:
+ icss-utils: 5.1.0(postcss@8.5.14)
+ postcss: 8.5.14
+
+ postcss-nested@7.0.2(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+ postcss-selector-parser: 7.1.1
+
+ postcss-normalize-charset@7.0.3(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+
+ postcss-normalize-charset@8.0.0(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+
+ postcss-normalize-display-values@7.0.3(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+
+ postcss-normalize-display-values@8.0.0(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+
+ postcss-normalize-positions@7.0.4(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+
+ postcss-normalize-positions@8.0.0(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+
+ postcss-normalize-repeat-style@7.0.4(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+
+ postcss-normalize-repeat-style@8.0.0(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+
+ postcss-normalize-string@7.0.3(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+
+ postcss-normalize-string@8.0.0(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+
+ postcss-normalize-timing-functions@7.0.3(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+
+ postcss-normalize-timing-functions@8.0.0(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+
+ postcss-normalize-unicode@7.0.9(postcss@8.5.14):
+ dependencies:
+ browserslist: 4.28.2
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+
+ postcss-normalize-unicode@8.0.0(postcss@8.5.14):
+ dependencies:
+ browserslist: 4.28.2
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+
+ postcss-normalize-url@7.0.3(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+
+ postcss-normalize-url@8.0.0(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+
+ postcss-normalize-whitespace@7.0.3(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+
+ postcss-normalize-whitespace@8.0.0(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+
+ postcss-ordered-values@7.0.4(postcss@8.5.14):
+ dependencies:
+ cssnano-utils: 5.0.3(postcss@8.5.14)
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+
+ postcss-ordered-values@8.0.0(postcss@8.5.14):
+ dependencies:
+ cssnano-utils: 6.0.0(postcss@8.5.14)
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+
+ postcss-reduce-initial@7.0.9(postcss@8.5.14):
+ dependencies:
+ browserslist: 4.28.2
+ caniuse-api: 3.0.0
+ postcss: 8.5.14
+
+ postcss-reduce-initial@8.0.0(postcss@8.5.14):
+ dependencies:
+ browserslist: 4.28.2
+ caniuse-api: 3.0.0
+ postcss: 8.5.14
+
+ postcss-reduce-transforms@7.0.3(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+
+ postcss-reduce-transforms@8.0.0(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+
+ postcss-safe-parser@7.0.1(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+
+ postcss-selector-parser@7.1.1:
+ dependencies:
+ cssesc: 3.0.0
+ util-deprecate: 1.0.2
+
+ postcss-svgo@7.1.3(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+ svgo: 4.0.1
+
+ postcss-svgo@8.0.0(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+ postcss-value-parser: 4.2.0
+ svgo: 4.0.1
+
+ postcss-unique-selectors@7.0.7(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+ postcss-selector-parser: 7.1.1
+
+ postcss-unique-selectors@8.0.0(postcss@8.5.14):
+ dependencies:
+ postcss: 8.5.14
+ postcss-selector-parser: 7.1.1
+
+ postcss-url@10.1.4(postcss@8.5.14):
+ dependencies:
+ make-dir: 3.1.0
+ mime: 2.5.2
+ minimatch: 3.1.5
+ postcss: 8.5.14
+ xxhashjs: 0.2.2
+
+ postcss-value-parser@4.2.0: {}
+
+ postcss@8.5.14:
+ dependencies:
+ nanoid: 3.3.12
+ picocolors: 1.1.1
+ source-map-js: 1.2.1
+
+ posthtml-parser@0.11.0:
+ dependencies:
+ htmlparser2: 7.2.0
+
+ posthtml-render@3.0.0:
+ dependencies:
+ is-json: 2.0.1
+
+ posthtml@0.16.7:
+ dependencies:
+ posthtml-parser: 0.11.0
+ posthtml-render: 3.0.0
+
+ powershell-utils@0.1.0: {}
+
+ prelude-ls@1.2.1: {}
+
+ prettier@3.8.3: {}
+
+ pretty-bytes@7.1.0: {}
+
+ pretty-format@27.5.1:
+ dependencies:
+ ansi-regex: 5.0.1
+ ansi-styles: 5.2.0
+ react-is: 17.0.2
+
+ pretty-time@1.1.0: {}
+
+ process-nextick-args@2.0.1: {}
+
+ process@0.11.10: {}
+
+ promise@7.3.1:
+ dependencies:
+ asap: 2.0.6
+
+ prompts@2.4.2:
+ dependencies:
+ kleur: 3.0.3
+ sisteransi: 1.0.5
+
+ proper-lockfile@4.1.2:
+ dependencies:
+ graceful-fs: 4.2.11
+ retry: 0.12.0
+ signal-exit: 3.0.7
+
+ property-information@7.1.0: {}
+
+ proto-list@1.2.4: {}
+
+ proxy-from-env@2.1.0: {}
+
+ prr@1.0.1: {}
+
+ publint@0.3.21:
+ dependencies:
+ '@publint/pack': 0.1.4
+ package-manager-detector: 1.6.0
+ picocolors: 1.1.1
+ sade: 1.8.1
+
+ pug-attrs@3.0.0:
+ dependencies:
+ constantinople: 4.0.1
+ js-stringify: 1.0.2
+ pug-runtime: 3.0.1
+
+ pug-code-gen@3.0.4:
+ dependencies:
+ constantinople: 4.0.1
+ doctypes: 1.1.0
+ js-stringify: 1.0.2
+ pug-attrs: 3.0.0
+ pug-error: 2.1.0
+ pug-runtime: 3.0.1
+ void-elements: 3.1.0
+ with: 7.0.2
+
+ pug-error@2.1.0: {}
+
+ pug-filters@4.0.0:
+ dependencies:
+ constantinople: 4.0.1
+ jstransformer: 1.0.0
+ pug-error: 2.1.0
+ pug-walk: 2.0.0
+ resolve: 1.22.12
+
+ pug-lexer@5.0.1:
+ dependencies:
+ character-parser: 2.2.0
+ is-expression: 4.0.0
+ pug-error: 2.1.0
+
+ pug-linker@4.0.0:
+ dependencies:
+ pug-error: 2.1.0
+ pug-walk: 2.0.0
+
+ pug-load@3.0.0:
+ dependencies:
+ object-assign: 4.1.1
+ pug-walk: 2.0.0
+
+ pug-parser@6.0.0:
+ dependencies:
+ pug-error: 2.1.0
+ token-stream: 1.0.0
+
+ pug-plain-loader@1.1.0(pug@3.0.4):
+ dependencies:
+ loader-utils: 1.4.2
+ pug: 3.0.4
+
+ pug-runtime@3.0.1: {}
+
+ pug-strip-comments@2.0.0:
+ dependencies:
+ pug-error: 2.1.0
+
+ pug-walk@2.0.0: {}
+
+ pug@3.0.4:
+ dependencies:
+ pug-code-gen: 3.0.4
+ pug-filters: 4.0.0
+ pug-lexer: 5.0.1
+ pug-linker: 4.0.0
+ pug-load: 3.0.0
+ pug-parser: 6.0.0
+ pug-runtime: 3.0.1
+ pug-strip-comments: 2.0.0
+
+ punycode.js@2.3.1: {}
+
+ punycode@2.3.1: {}
+
+ quansync@0.2.11: {}
+
+ quansync@1.0.0: {}
+
+ queue-microtask@1.2.3: {}
+
+ radix3@1.1.2: {}
+
+ range-parser@1.2.1: {}
+
+ rc9@3.0.1:
+ dependencies:
+ defu: 6.1.7
+ destr: 2.0.5
+
+ react-is@17.0.2: {}
+
+ read-cache@1.0.0:
+ dependencies:
+ pify: 2.3.0
+
+ read-package-json-fast@3.0.2:
+ dependencies:
+ json-parse-even-better-errors: 3.0.2
+ npm-normalize-package-bin: 3.0.1
+
+ read-pkg@9.0.1:
+ dependencies:
+ '@types/normalize-package-data': 2.4.4
+ normalize-package-data: 6.0.2
+ parse-json: 8.3.0
+ type-fest: 4.41.0
+ unicorn-magic: 0.1.0
+
+ read-workspaces@1.2.2:
+ dependencies:
+ '@npmcli/map-workspaces': 3.0.6
+ '@pnpm/workspace.read-manifest': 2.2.2
+ read-pkg: 9.0.1
+
+ read-yaml-file@2.1.0:
+ dependencies:
+ js-yaml: 4.1.1
+ strip-bom: 4.0.0
+
+ readable-stream@2.3.8:
+ dependencies:
+ core-util-is: 1.0.3
+ inherits: 2.0.4
+ isarray: 1.0.0
+ process-nextick-args: 2.0.1
+ safe-buffer: 5.1.2
+ string_decoder: 1.1.1
+ util-deprecate: 1.0.2
+
+ readable-stream@4.7.0:
+ dependencies:
+ abort-controller: 3.0.0
+ buffer: 6.0.3
+ events: 3.3.0
+ process: 0.11.10
+ string_decoder: 1.3.0
+
+ readdir-glob@1.1.3:
+ dependencies:
+ minimatch: 5.1.9
+
+ readdirp@3.6.0:
+ dependencies:
+ picomatch: 2.3.2
+
+ readdirp@4.1.2: {}
+
+ readdirp@5.0.0: {}
+
+ redis-errors@1.2.0: {}
+
+ redis-parser@3.0.0:
+ dependencies:
+ redis-errors: 1.2.0
+
+ refa@0.12.1:
+ dependencies:
+ '@eslint-community/regexpp': 4.12.2
+
+ regex-recursion@6.0.2:
+ dependencies:
+ regex-utilities: 2.3.0
+
+ regex-utilities@2.3.0: {}
+
+ regex@6.1.0:
+ dependencies:
+ regex-utilities: 2.3.0
+
+ regexp-ast-analysis@0.7.1:
+ dependencies:
+ '@eslint-community/regexpp': 4.12.2
+ refa: 0.12.1
+
+ regexp-tree@0.1.27: {}
+
+ regexp.prototype.flags@1.5.4:
+ dependencies:
+ call-bind: 1.0.9
+ define-properties: 1.2.1
+ es-errors: 1.3.0
+ get-proto: 1.0.1
+ gopd: 1.2.0
+ set-function-name: 2.0.2
+
+ regjsparser@0.13.1:
+ dependencies:
+ jsesc: 3.1.0
+
+ rehype-external-links@3.0.0:
+ dependencies:
+ '@types/hast': 3.0.4
+ '@ungap/structured-clone': 1.3.1
+ hast-util-is-element: 3.0.0
+ is-absolute-url: 4.0.1
+ space-separated-tokens: 2.0.2
+ unist-util-visit: 5.1.0
+
+ rehype-minify-whitespace@6.0.2:
+ dependencies:
+ '@types/hast': 3.0.4
+ hast-util-minify-whitespace: 1.0.1
+
+ rehype-raw@7.0.0:
+ dependencies:
+ '@types/hast': 3.0.4
+ hast-util-raw: 9.1.0
+ vfile: 6.0.3
+
+ rehype-remark@10.0.1:
+ dependencies:
+ '@types/hast': 3.0.4
+ '@types/mdast': 4.0.4
+ hast-util-to-mdast: 10.1.2
+ unified: 11.0.5
+ vfile: 6.0.3
+
+ rehype-slug@6.0.0:
+ dependencies:
+ '@types/hast': 3.0.4
+ github-slugger: 2.0.0
+ hast-util-heading-rank: 3.0.0
+ hast-util-to-string: 3.0.1
+ unist-util-visit: 5.1.0
+
+ rehype-sort-attribute-values@5.0.1:
+ dependencies:
+ '@types/hast': 3.0.4
+ hast-util-is-element: 3.0.0
+ unist-util-visit: 5.1.0
+
+ rehype-sort-attributes@5.0.1:
+ dependencies:
+ '@types/hast': 3.0.4
+ unist-util-visit: 5.1.0
+
+ remark-emoji@5.0.2:
+ dependencies:
+ '@types/mdast': 4.0.4
+ emoticon: 4.1.0
+ mdast-util-find-and-replace: 3.0.2
+ node-emoji: 2.2.0
+ unified: 11.0.5
+
+ remark-gfm@4.0.1:
+ dependencies:
+ '@types/mdast': 4.0.4
+ mdast-util-gfm: 3.1.0
+ micromark-extension-gfm: 3.0.0
+ remark-parse: 11.0.0
+ remark-stringify: 11.0.0
+ unified: 11.0.5
+ transitivePeerDependencies:
+ - supports-color
+
+ remark-mdc@3.11.0:
+ dependencies:
+ '@types/mdast': 4.0.4
+ '@types/unist': 3.0.3
+ flat: 6.0.1
+ mdast-util-from-markdown: 2.0.3
+ mdast-util-to-markdown: 2.1.2
+ micromark: 4.0.2
+ micromark-core-commonmark: 2.0.3
+ micromark-factory-space: 2.0.1
+ micromark-factory-whitespace: 2.0.1
+ micromark-util-character: 2.1.1
+ micromark-util-types: 2.0.2
+ parse-entities: 4.0.2
+ scule: 1.3.0
+ stringify-entities: 4.0.4
+ unified: 11.0.5
+ unist-util-visit: 5.1.0
+ unist-util-visit-parents: 6.0.2
+ yaml: 2.9.0
+ transitivePeerDependencies:
+ - supports-color
+
+ remark-parse@11.0.0:
+ dependencies:
+ '@types/mdast': 4.0.4
+ mdast-util-from-markdown: 2.0.3
+ micromark-util-types: 2.0.2
+ unified: 11.0.5
+ transitivePeerDependencies:
+ - supports-color
+
+ remark-rehype@11.1.2:
+ dependencies:
+ '@types/hast': 3.0.4
+ '@types/mdast': 4.0.4
+ mdast-util-to-hast: 13.2.1
+ unified: 11.0.5
+ vfile: 6.0.3
+
+ remark-stringify@11.0.0:
+ dependencies:
+ '@types/mdast': 4.0.4
+ mdast-util-to-markdown: 2.1.2
+ unified: 11.0.5
+
+ require-directory@2.1.1: {}
+
+ require-from-string@2.0.2: {}
+
+ reserved-identifiers@1.2.0: {}
+
+ resolve-from@4.0.0: {}
+
+ resolve-from@5.0.0: {}
+
+ resolve-pkg-maps@1.0.0: {}
+
+ resolve-workspace-root@2.0.1: {}
+
+ resolve@1.22.12:
+ dependencies:
+ es-errors: 1.3.0
+ is-core-module: 2.16.2
+ path-parse: 1.0.7
+ supports-preserve-symlinks-flag: 1.0.0
+
+ retry@0.12.0: {}
+
+ reusify@1.1.0: {}
+
+ rolldown-plugin-dts@0.25.1(oxc-resolver@11.19.1(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0))(rolldown@1.0.2)(typescript@6.0.3)(vue-tsc@3.2.9(typescript@6.0.3)):
+ dependencies:
+ '@babel/generator': 8.0.0-rc.5
+ '@babel/helper-validator-identifier': 8.0.0-rc.5
+ '@babel/parser': 8.0.0-rc.4
+ ast-kit: 3.0.0-beta.1
+ birpc: 4.0.0
+ dts-resolver: 3.0.0(oxc-resolver@11.19.1(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0))
+ get-tsconfig: 5.0.0-beta.5
+ obug: 2.1.1
+ rolldown: 1.0.2
+ optionalDependencies:
+ typescript: 6.0.3
+ vue-tsc: 3.2.9(typescript@6.0.3)
+ transitivePeerDependencies:
+ - oxc-resolver
+
+ rolldown-string@0.3.0(rolldown@1.0.2):
+ dependencies:
+ magic-string: 0.30.21
+ optionalDependencies:
+ rolldown: 1.0.2
+
+ rolldown@1.0.0:
+ dependencies:
+ '@oxc-project/types': 0.129.0
+ '@rolldown/pluginutils': 1.0.0
+ optionalDependencies:
+ '@rolldown/binding-android-arm64': 1.0.0
+ '@rolldown/binding-darwin-arm64': 1.0.0
+ '@rolldown/binding-darwin-x64': 1.0.0
+ '@rolldown/binding-freebsd-x64': 1.0.0
+ '@rolldown/binding-linux-arm-gnueabihf': 1.0.0
+ '@rolldown/binding-linux-arm64-gnu': 1.0.0
+ '@rolldown/binding-linux-arm64-musl': 1.0.0
+ '@rolldown/binding-linux-ppc64-gnu': 1.0.0
+ '@rolldown/binding-linux-s390x-gnu': 1.0.0
+ '@rolldown/binding-linux-x64-gnu': 1.0.0
+ '@rolldown/binding-linux-x64-musl': 1.0.0
+ '@rolldown/binding-openharmony-arm64': 1.0.0
+ '@rolldown/binding-wasm32-wasi': 1.0.0
+ '@rolldown/binding-win32-arm64-msvc': 1.0.0
+ '@rolldown/binding-win32-x64-msvc': 1.0.0
+
+ rolldown@1.0.2:
+ dependencies:
+ '@oxc-project/types': 0.132.0
+ '@rolldown/pluginutils': 1.0.1
+ optionalDependencies:
+ '@rolldown/binding-android-arm64': 1.0.2
+ '@rolldown/binding-darwin-arm64': 1.0.2
+ '@rolldown/binding-darwin-x64': 1.0.2
+ '@rolldown/binding-freebsd-x64': 1.0.2
+ '@rolldown/binding-linux-arm-gnueabihf': 1.0.2
+ '@rolldown/binding-linux-arm64-gnu': 1.0.2
+ '@rolldown/binding-linux-arm64-musl': 1.0.2
+ '@rolldown/binding-linux-ppc64-gnu': 1.0.2
+ '@rolldown/binding-linux-s390x-gnu': 1.0.2
+ '@rolldown/binding-linux-x64-gnu': 1.0.2
+ '@rolldown/binding-linux-x64-musl': 1.0.2
+ '@rolldown/binding-openharmony-arm64': 1.0.2
+ '@rolldown/binding-wasm32-wasi': 1.0.2
+ '@rolldown/binding-win32-arm64-msvc': 1.0.2
+ '@rolldown/binding-win32-x64-msvc': 1.0.2
+
+ rollup-plugin-dts@6.4.1(rollup@4.60.4)(typescript@6.0.3):
+ dependencies:
+ '@jridgewell/remapping': 2.3.5
+ '@jridgewell/sourcemap-codec': 1.5.5
+ convert-source-map: 2.0.0
+ magic-string: 0.30.21
+ rollup: 4.60.4
+ typescript: 6.0.3
+ optionalDependencies:
+ '@babel/code-frame': 7.29.0
+
+ rollup-plugin-visualizer@7.0.1(rolldown@1.0.2)(rollup@4.60.4):
+ dependencies:
+ open: 11.0.0
+ picomatch: 4.0.4
+ source-map: 0.7.6
+ yargs: 18.0.0
+ optionalDependencies:
+ rolldown: 1.0.2
+ rollup: 4.60.4
+
+ rollup@4.60.4:
+ dependencies:
+ '@types/estree': 1.0.8
+ optionalDependencies:
+ '@rollup/rollup-android-arm-eabi': 4.60.4
+ '@rollup/rollup-android-arm64': 4.60.4
+ '@rollup/rollup-darwin-arm64': 4.60.4
+ '@rollup/rollup-darwin-x64': 4.60.4
+ '@rollup/rollup-freebsd-arm64': 4.60.4
+ '@rollup/rollup-freebsd-x64': 4.60.4
+ '@rollup/rollup-linux-arm-gnueabihf': 4.60.4
+ '@rollup/rollup-linux-arm-musleabihf': 4.60.4
+ '@rollup/rollup-linux-arm64-gnu': 4.60.4
+ '@rollup/rollup-linux-arm64-musl': 4.60.4
+ '@rollup/rollup-linux-loong64-gnu': 4.60.4
+ '@rollup/rollup-linux-loong64-musl': 4.60.4
+ '@rollup/rollup-linux-ppc64-gnu': 4.60.4
+ '@rollup/rollup-linux-ppc64-musl': 4.60.4
+ '@rollup/rollup-linux-riscv64-gnu': 4.60.4
+ '@rollup/rollup-linux-riscv64-musl': 4.60.4
+ '@rollup/rollup-linux-s390x-gnu': 4.60.4
+ '@rollup/rollup-linux-x64-gnu': 4.60.4
+ '@rollup/rollup-linux-x64-musl': 4.60.4
+ '@rollup/rollup-openbsd-x64': 4.60.4
+ '@rollup/rollup-openharmony-arm64': 4.60.4
+ '@rollup/rollup-win32-arm64-msvc': 4.60.4
+ '@rollup/rollup-win32-ia32-msvc': 4.60.4
+ '@rollup/rollup-win32-x64-gnu': 4.60.4
+ '@rollup/rollup-win32-x64-msvc': 4.60.4
+ fsevents: 2.3.3
+
+ rou3@0.8.1: {}
+
+ run-applescript@7.1.0: {}
+
+ run-con@1.3.2:
+ dependencies:
+ deep-extend: 0.6.0
+ ini: 4.1.3
+ minimist: 1.2.8
+ strip-json-comments: 3.1.1
+
+ run-parallel@1.2.0:
+ dependencies:
+ queue-microtask: 1.2.3
+
+ sade@1.8.1:
+ dependencies:
+ mri: 1.2.0
+
+ safe-buffer@5.1.2: {}
+
+ safe-buffer@5.2.1: {}
+
+ safe-regex-test@1.1.0:
+ dependencies:
+ call-bound: 1.0.4
+ es-errors: 1.3.0
+ is-regex: 1.2.1
+
+ sass-loader@17.0.0(@rspack/core@2.0.3)(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)):
+ optionalDependencies:
+ '@rspack/core': 2.0.3
+ webpack: 5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)
+
+ sax@1.6.0: {}
+
+ schema-utils@3.3.0:
+ dependencies:
+ '@types/json-schema': 7.0.15
+ ajv: 6.15.0
+ ajv-keywords: 3.5.2(ajv@6.15.0)
+
+ schema-utils@4.3.3:
+ dependencies:
+ '@types/json-schema': 7.0.15
+ ajv: 8.20.0
+ ajv-formats: 2.1.1(ajv@8.20.0)
+ ajv-keywords: 5.1.0(ajv@8.20.0)
+
+ scslre@0.3.0:
+ dependencies:
+ '@eslint-community/regexpp': 4.12.2
+ refa: 0.12.1
+ regexp-ast-analysis: 0.7.1
+
+ scule@1.3.0: {}
+
+ semver@6.3.1: {}
+
+ semver@7.8.0: {}
+
+ send@1.2.1:
+ dependencies:
+ debug: 4.4.3
+ encodeurl: 2.0.0
+ escape-html: 1.0.3
+ etag: 1.8.1
+ fresh: 2.0.0
+ http-errors: 2.0.1
+ mime-types: 3.0.2
+ ms: 2.1.3
+ on-finished: 2.4.1
+ range-parser: 1.2.1
+ statuses: 2.0.2
+ transitivePeerDependencies:
+ - supports-color
+
+ serialize-javascript@7.0.5: {}
+
+ seroval@1.5.4: {}
+
+ serve-placeholder@2.0.2:
+ dependencies:
+ defu: 6.1.7
+
+ serve-static@2.2.1:
+ dependencies:
+ encodeurl: 2.0.0
+ escape-html: 1.0.3
+ parseurl: 1.3.3
+ send: 1.2.1
+ transitivePeerDependencies:
+ - supports-color
+
+ set-function-length@1.2.2:
+ dependencies:
+ define-data-property: 1.1.4
+ es-errors: 1.3.0
+ function-bind: 1.1.2
+ get-intrinsic: 1.3.0
+ gopd: 1.2.0
+ has-property-descriptors: 1.0.2
+
+ set-function-name@2.0.2:
+ dependencies:
+ define-data-property: 1.1.4
+ es-errors: 1.3.0
+ functions-have-names: 1.2.3
+ has-property-descriptors: 1.0.2
+
+ setprototypeof@1.2.0: {}
+
+ shebang-command@2.0.0:
+ dependencies:
+ shebang-regex: 3.0.0
+
+ shebang-regex@3.0.0: {}
+
+ shell-quote@1.8.4: {}
+
+ sherif-darwin-arm64@1.11.1:
+ optional: true
+
+ sherif-darwin-x64@1.11.1:
+ optional: true
+
+ sherif-linux-arm64-musl@1.11.1:
+ optional: true
+
+ sherif-linux-arm64@1.11.1:
+ optional: true
+
+ sherif-linux-x64-musl@1.11.1:
+ optional: true
+
+ sherif-linux-x64@1.11.1:
+ optional: true
+
+ sherif-windows-arm64@1.11.1:
+ optional: true
+
+ sherif-windows-x64@1.11.1:
+ optional: true
+
+ sherif@1.11.1:
+ optionalDependencies:
+ sherif-darwin-arm64: 1.11.1
+ sherif-darwin-x64: 1.11.1
+ sherif-linux-arm64: 1.11.1
+ sherif-linux-arm64-musl: 1.11.1
+ sherif-linux-x64: 1.11.1
+ sherif-linux-x64-musl: 1.11.1
+ sherif-windows-arm64: 1.11.1
+ sherif-windows-x64: 1.11.1
+
+ shiki@4.1.0:
+ dependencies:
+ '@shikijs/core': 4.1.0
+ '@shikijs/engine-javascript': 4.1.0
+ '@shikijs/engine-oniguruma': 4.1.0
+ '@shikijs/langs': 4.1.0
+ '@shikijs/themes': 4.1.0
+ '@shikijs/types': 4.1.0
+ '@shikijs/vscode-textmate': 10.0.2
+ '@types/hast': 3.0.4
+
+ side-channel-list@1.0.1:
+ dependencies:
+ es-errors: 1.3.0
+ object-inspect: 1.13.4
+
+ side-channel-map@1.0.1:
+ dependencies:
+ call-bound: 1.0.4
+ es-errors: 1.3.0
+ get-intrinsic: 1.3.0
+ object-inspect: 1.13.4
+
+ side-channel-weakmap@1.0.2:
+ dependencies:
+ call-bound: 1.0.4
+ es-errors: 1.3.0
+ get-intrinsic: 1.3.0
+ object-inspect: 1.13.4
+ side-channel-map: 1.0.1
+
+ side-channel@1.1.0:
+ dependencies:
+ es-errors: 1.3.0
+ object-inspect: 1.13.4
+ side-channel-list: 1.0.1
+ side-channel-map: 1.0.1
+ side-channel-weakmap: 1.0.2
+
+ siginfo@2.0.0: {}
+
+ signal-exit@3.0.7: {}
+
+ signal-exit@4.1.0: {}
+
+ sirv@3.0.2:
+ dependencies:
+ '@polka/url': 1.0.0-next.29
+ mrmime: 2.0.1
+ totalist: 3.0.1
+
+ sisteransi@1.0.5: {}
+
+ skin-tone@2.0.0:
+ dependencies:
+ unicode-emoji-modifier-base: 1.0.0
+
+ slash@5.1.0: {}
+
+ smob@1.6.2: {}
+
+ smol-toml@1.6.1: {}
+
+ source-map-js@1.2.1: {}
+
+ source-map-support@0.5.21:
+ dependencies:
+ buffer-from: 1.1.2
+ source-map: 0.6.1
+
+ source-map@0.6.1: {}
+
+ source-map@0.7.6: {}
+
+ space-separated-tokens@2.0.2: {}
+
+ spdx-correct@3.2.0:
+ dependencies:
+ spdx-expression-parse: 3.0.1
+ spdx-license-ids: 3.0.23
+
+ spdx-exceptions@2.5.0: {}
+
+ spdx-expression-parse@3.0.1:
+ dependencies:
+ spdx-exceptions: 2.5.0
+ spdx-license-ids: 3.0.23
+
+ spdx-expression-parse@4.0.0:
+ dependencies:
+ spdx-exceptions: 2.5.0
+ spdx-license-ids: 3.0.23
+
+ spdx-license-ids@3.0.23: {}
+
+ split2@4.2.0: {}
+
+ srvx@0.11.15: {}
+
+ stable-hash-x@0.2.0: {}
+
+ stackback@0.0.2: {}
+
+ stackframe@1.3.4: {}
+
+ standard-as-callback@2.1.0: {}
+
+ statuses@2.0.2: {}
+
+ std-env@3.10.0: {}
+
+ std-env@4.1.0: {}
+
+ stop-iteration-iterator@1.1.0:
+ dependencies:
+ es-errors: 1.3.0
+ internal-slot: 1.1.0
+
+ streamx@2.25.0:
+ dependencies:
+ events-universal: 1.0.1
+ fast-fifo: 1.3.2
+ text-decoder: 1.2.7
+ transitivePeerDependencies:
+ - bare-abort-controller
+ - react-native-b4a
+
+ string-width@4.2.3:
+ dependencies:
+ emoji-regex: 8.0.0
+ is-fullwidth-code-point: 3.0.0
+ strip-ansi: 6.0.1
+
+ string-width@5.1.2:
+ dependencies:
+ eastasianwidth: 0.2.0
+ emoji-regex: 9.2.2
+ strip-ansi: 7.2.0
+
+ string-width@7.2.0:
+ dependencies:
+ emoji-regex: 10.6.0
+ get-east-asian-width: 1.6.0
+ strip-ansi: 7.2.0
+
+ string-width@8.1.0:
+ dependencies:
+ get-east-asian-width: 1.6.0
+ strip-ansi: 7.2.0
+
+ string_decoder@1.1.1:
+ dependencies:
+ safe-buffer: 5.1.2
+
+ string_decoder@1.3.0:
+ dependencies:
+ safe-buffer: 5.2.1
+
+ stringify-entities@4.0.4:
+ dependencies:
+ character-entities-html4: 2.1.0
+ character-entities-legacy: 3.0.0
+
+ strip-ansi@6.0.1:
+ dependencies:
+ ansi-regex: 5.0.1
+
+ strip-ansi@7.2.0:
+ dependencies:
+ ansi-regex: 6.2.2
+
+ strip-bom@4.0.0: {}
+
+ strip-comments-strings@1.2.0: {}
+
+ strip-final-newline@3.0.0: {}
+
+ strip-indent@4.1.1: {}
+
+ strip-json-comments@3.1.1: {}
+
+ strip-json-comments@5.0.3: {}
+
+ strip-literal@3.1.0:
+ dependencies:
+ js-tokens: 9.0.1
+
+ structured-clone-es@2.0.0: {}
+
+ stylehacks@7.0.11(postcss@8.5.14):
+ dependencies:
+ browserslist: 4.28.2
+ postcss: 8.5.14
+ postcss-selector-parser: 7.1.1
+
+ stylehacks@8.0.0(postcss@8.5.14):
+ dependencies:
+ browserslist: 4.28.2
+ postcss: 8.5.14
+ postcss-selector-parser: 7.1.1
+
+ supports-color@10.2.2: {}
+
+ supports-color@5.5.0:
+ dependencies:
+ has-flag: 3.0.0
+
+ supports-color@7.2.0:
+ dependencies:
+ has-flag: 4.0.0
+
+ supports-color@8.1.1:
+ dependencies:
+ has-flag: 4.0.0
+
+ supports-hyperlinks@3.2.0:
+ dependencies:
+ has-flag: 4.0.0
+ supports-color: 7.2.0
+
+ supports-preserve-symlinks-flag@1.0.0: {}
+
+ svgo@4.0.1:
+ dependencies:
+ commander: 11.1.0
+ css-select: 5.2.2
+ css-tree: 3.2.1
+ css-what: 6.2.2
+ csso: 5.0.5
+ picocolors: 1.1.1
+ sax: 1.6.0
+
+ tagged-tag@1.0.0: {}
+
+ tapable@1.1.3: {}
+
+ tapable@2.3.3: {}
+
+ tar-stream@3.2.0:
+ dependencies:
+ b4a: 1.8.1
+ bare-fs: 4.7.1
+ fast-fifo: 1.3.2
+ streamx: 2.25.0
+ transitivePeerDependencies:
+ - bare-abort-controller
+ - bare-buffer
+ - react-native-b4a
+
+ tar@7.5.15:
+ dependencies:
+ '@isaacs/fs-minipass': 4.0.1
+ chownr: 3.0.0
+ minipass: 7.1.3
+ minizlib: 3.1.0
+ yallist: 5.0.0
+
+ teex@1.0.1:
+ dependencies:
+ streamx: 2.25.0
+ transitivePeerDependencies:
+ - bare-abort-controller
+ - react-native-b4a
+
+ terser-webpack-plugin@5.6.0(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)):
+ dependencies:
+ '@jridgewell/trace-mapping': 0.3.31
+ jest-worker: 27.5.1
+ schema-utils: 4.3.3
+ terser: 5.48.0
+ webpack: 5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)
+ optionalDependencies:
+ cssnano: 8.0.1(postcss@8.5.14)
+ esbuild: 0.28.0
+ lightningcss: 1.32.0
+ postcss: 8.5.14
+
+ terser-webpack-plugin@5.6.0(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)(webpack@5.106.2(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)):
+ dependencies:
+ '@jridgewell/trace-mapping': 0.3.31
+ jest-worker: 27.5.1
+ schema-utils: 4.3.3
+ terser: 5.48.0
+ webpack: 5.106.2(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)
+ optionalDependencies:
+ esbuild: 0.28.0
+ lightningcss: 1.32.0
+ postcss: 8.5.14
+ optional: true
+
+ terser-webpack-plugin@5.6.0(esbuild@0.28.0)(lightningcss@1.32.0)(webpack@5.106.2(esbuild@0.28.0)(lightningcss@1.32.0)):
+ dependencies:
+ '@jridgewell/trace-mapping': 0.3.31
+ jest-worker: 27.5.1
+ schema-utils: 4.3.3
+ terser: 5.48.0
+ webpack: 5.106.2(esbuild@0.28.0)(lightningcss@1.32.0)
+ optionalDependencies:
+ esbuild: 0.28.0
+ lightningcss: 1.32.0
+
+ terser@5.48.0:
+ dependencies:
+ '@jridgewell/source-map': 0.3.11
+ acorn: 8.16.0
+ commander: 2.20.3
+ source-map-support: 0.5.21
+
+ text-decoder@1.2.7:
+ dependencies:
+ b4a: 1.8.1
+ transitivePeerDependencies:
+ - react-native-b4a
+
+ thenify-all@1.6.0:
+ dependencies:
+ thenify: 3.3.1
+
+ thenify@3.3.1:
+ dependencies:
+ any-promise: 1.3.0
+
+ thingies@2.6.0(tslib@2.8.1):
+ dependencies:
+ tslib: 2.8.1
+
+ time-fix-plugin@2.0.7(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)):
+ dependencies:
+ webpack: 5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)
+
+ tiny-invariant@1.3.3: {}
+
+ tinybench@2.9.0: {}
+
+ tinyclip@0.1.12: {}
+
+ tinyexec@1.1.2: {}
+
+ tinyglobby@0.2.16:
+ dependencies:
+ fdir: 6.5.0(picomatch@4.0.4)
+ picomatch: 4.0.4
+
+ tinyrainbow@3.1.0: {}
+
+ to-regex-range@5.0.1:
+ dependencies:
+ is-number: 7.0.0
+
+ to-valid-identifier@1.0.0:
+ dependencies:
+ '@sindresorhus/base62': 1.0.0
+ reserved-identifiers: 1.2.0
+
+ toidentifier@1.0.1: {}
+
+ token-stream@1.0.0: {}
+
+ totalist@3.0.1: {}
+
+ tr46@0.0.3: {}
+
+ tree-dump@1.1.0(tslib@2.8.1):
+ dependencies:
+ tslib: 2.8.1
+
+ trim-lines@3.0.1: {}
+
+ trim-trailing-lines@2.1.0: {}
+
+ trough@2.2.0: {}
+
+ ts-api-utils@2.5.0(typescript@6.0.3):
+ dependencies:
+ typescript: 6.0.3
+
+ ts-blank-space@0.9.0:
+ dependencies:
+ typescript: 6.0.3
+
+ ts-checker-rspack-plugin@1.3.0(@rspack/core@2.0.3)(tslib@2.8.1)(typescript@6.0.3):
+ dependencies:
+ '@rspack/lite-tapable': 1.1.0
+ chokidar: 3.6.0
+ memfs: 4.57.2(tslib@2.8.1)
+ picocolors: 1.1.1
+ typescript: 6.0.3
+ optionalDependencies:
+ '@rspack/core': 2.0.3
+ transitivePeerDependencies:
+ - tslib
+
+ tslib@2.8.1: {}
+
+ twoslash-protocol@0.3.8: {}
+
+ twoslash-vue@0.3.8(typescript@5.9.3):
+ dependencies:
+ '@vue/language-core': 3.2.9
+ twoslash: 0.3.8(typescript@5.9.3)
+ twoslash-protocol: 0.3.8
+ typescript: 5.9.3
+ transitivePeerDependencies:
+ - supports-color
+
+ twoslash@0.3.8(typescript@5.9.3):
+ dependencies:
+ '@typescript/vfs': 1.6.4(typescript@5.9.3)
+ twoslash-protocol: 0.3.8
+ typescript: 5.9.3
+ transitivePeerDependencies:
+ - supports-color
+
+ type-check@0.4.0:
+ dependencies:
+ prelude-ls: 1.2.1
+
+ type-fest@4.41.0: {}
+
+ type-fest@5.6.0:
+ dependencies:
+ tagged-tag: 1.0.0
+
+ type-level-regexp@0.1.17: {}
+
+ typescript@5.6.1-rc: {}
+
+ typescript@5.9.3: {}
+
+ typescript@6.0.3: {}
+
+ uc.micro@2.1.0: {}
+
+ ufo@1.6.4: {}
+
+ ultrahtml@1.6.0: {}
+
+ unbash@3.0.0: {}
+
+ unbuild@3.6.1(typescript@6.0.3)(vue-sfc-transformer@0.1.17(@vue/compiler-core@3.5.34)(esbuild@0.28.0)(vue@3.5.34(typescript@6.0.3)))(vue-tsc@3.2.9(typescript@6.0.3))(vue@3.5.34(typescript@6.0.3)):
+ dependencies:
+ '@rollup/plugin-alias': 5.1.1(rollup@4.60.4)
+ '@rollup/plugin-commonjs': 28.0.9(rollup@4.60.4)
+ '@rollup/plugin-json': 6.1.0(rollup@4.60.4)
+ '@rollup/plugin-node-resolve': 16.0.3(rollup@4.60.4)
+ '@rollup/plugin-replace': 6.0.3(rollup@4.60.4)
+ '@rollup/pluginutils': 5.3.0(rollup@4.60.4)
+ citty: 0.1.6
+ consola: 3.4.2
+ defu: 6.1.7
+ esbuild: 0.25.12
+ fix-dts-default-cjs-exports: 1.0.1
+ hookable: 5.5.3
+ jiti: 2.7.0
+ magic-string: 0.30.21
+ mkdist: 2.4.1(typescript@6.0.3)(vue-sfc-transformer@0.1.17(@vue/compiler-core@3.5.34)(esbuild@0.28.0)(vue@3.5.34(typescript@6.0.3)))(vue-tsc@3.2.9(typescript@6.0.3))(vue@3.5.34(typescript@6.0.3))
+ mlly: 1.8.2
+ pathe: 2.0.3
+ pkg-types: 2.3.1
+ pretty-bytes: 7.1.0
+ rollup: 4.60.4
+ rollup-plugin-dts: 6.4.1(rollup@4.60.4)(typescript@6.0.3)
+ scule: 1.3.0
+ tinyglobby: 0.2.16
+ untyped: 2.0.0
+ optionalDependencies:
+ typescript: 6.0.3
+ transitivePeerDependencies:
+ - sass
+ - vue
+ - vue-sfc-transformer
+ - vue-tsc
+
+ unconfig-core@7.5.0:
+ dependencies:
+ '@quansync/fs': 1.0.0
+ quansync: 1.0.0
+
+ unconfig@7.5.0:
+ dependencies:
+ '@quansync/fs': 1.0.0
+ defu: 6.1.7
+ jiti: 2.7.0
+ quansync: 1.0.0
+ unconfig-core: 7.5.0
+
+ uncrypto@0.1.3: {}
+
+ unctx@2.5.0:
+ dependencies:
+ acorn: 8.16.0
+ estree-walker: 3.0.3
+ magic-string: 0.30.21
+ unplugin: 2.3.11
+
+ undici-types@7.16.0: {}
+
+ unenv@2.0.0-rc.24:
+ dependencies:
+ pathe: 2.0.3
+
+ unhead@3.1.0(vite@8.0.12):
+ dependencies:
+ hookable: 6.1.1
+ unplugin: 3.0.0
+ optionalDependencies:
+ vite: 8.0.12(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0)
+
+ unicode-emoji-modifier-base@1.0.0: {}
+
+ unicorn-magic@0.1.0: {}
+
+ unicorn-magic@0.3.0: {}
+
+ unicorn-magic@0.4.0: {}
+
+ unified@11.0.5:
+ dependencies:
+ '@types/unist': 3.0.3
+ bail: 2.0.2
+ devlop: 1.1.0
+ extend: 3.0.2
+ is-plain-obj: 4.1.0
+ trough: 2.2.0
+ vfile: 6.0.3
+
+ unimport@6.3.0(oxc-parser@0.130.0)(rolldown@1.0.2):
+ dependencies:
+ acorn: 8.16.0
+ escape-string-regexp: 5.0.0
+ estree-walker: 3.0.3
+ local-pkg: 1.2.1
+ magic-string: 0.30.21
+ mlly: 1.8.2
+ pathe: 2.0.3
+ picomatch: 4.0.4
+ pkg-types: 2.3.1
+ scule: 1.3.0
+ strip-literal: 3.1.0
+ tinyglobby: 0.2.16
+ unplugin: 3.0.0
+ unplugin-utils: 0.3.1
+ optionalDependencies:
+ oxc-parser: 0.130.0
+ rolldown: 1.0.2
+
+ unist-builder@4.0.0:
+ dependencies:
+ '@types/unist': 3.0.3
+
+ unist-util-find-after@5.0.0:
+ dependencies:
+ '@types/unist': 3.0.3
+ unist-util-is: 6.0.1
+
+ unist-util-is@6.0.1:
+ dependencies:
+ '@types/unist': 3.0.3
+
+ unist-util-position@5.0.0:
+ dependencies:
+ '@types/unist': 3.0.3
+
+ unist-util-remove-position@5.0.0:
+ dependencies:
+ '@types/unist': 3.0.3
+ unist-util-visit: 5.1.0
+
+ unist-util-stringify-position@4.0.0:
+ dependencies:
+ '@types/unist': 3.0.3
+
+ unist-util-visit-parents@6.0.2:
+ dependencies:
+ '@types/unist': 3.0.3
+ unist-util-is: 6.0.1
+
+ unist-util-visit@5.1.0:
+ dependencies:
+ '@types/unist': 3.0.3
+ unist-util-is: 6.0.1
+ unist-util-visit-parents: 6.0.2
+
+ universalify@2.0.1: {}
+
+ unocss@66.6.8(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0)(vite@8.0.12):
+ dependencies:
+ '@unocss/cli': 66.6.8
+ '@unocss/core': 66.6.8
+ '@unocss/preset-attributify': 66.6.8
+ '@unocss/preset-icons': 66.6.8
+ '@unocss/preset-mini': 66.6.8
+ '@unocss/preset-tagify': 66.6.8
+ '@unocss/preset-typography': 66.6.8
+ '@unocss/preset-uno': 66.6.8
+ '@unocss/preset-web-fonts': 66.6.8
+ '@unocss/preset-wind': 66.6.8
+ '@unocss/preset-wind3': 66.6.8
+ '@unocss/preset-wind4': 66.6.8
+ '@unocss/transformer-attributify-jsx': 66.6.8(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0)
+ '@unocss/transformer-compile-class': 66.6.8
+ '@unocss/transformer-directives': 66.6.8
+ '@unocss/transformer-variant-group': 66.6.8
+ '@unocss/vite': 66.6.8(vite@8.0.12)
+ transitivePeerDependencies:
+ - '@emnapi/core'
+ - '@emnapi/runtime'
+ - vite
+
+ unplugin-utils@0.3.1:
+ dependencies:
+ pathe: 2.0.3
+ picomatch: 4.0.4
+
+ unplugin@2.3.11:
+ dependencies:
+ '@jridgewell/remapping': 2.3.5
+ acorn: 8.16.0
+ picomatch: 4.0.4
+ webpack-virtual-modules: 0.6.2
+
+ unplugin@3.0.0:
+ dependencies:
+ '@jridgewell/remapping': 2.3.5
+ picomatch: 4.0.4
+ webpack-virtual-modules: 0.6.2
+
+ unrouting@0.1.7:
+ dependencies:
+ escape-string-regexp: 5.0.0
+ ufo: 1.6.4
+
+ unrs-resolver@1.12.2:
+ dependencies:
+ napi-postinstall: 0.3.4
+ optionalDependencies:
+ '@unrs/resolver-binding-android-arm-eabi': 1.12.2
+ '@unrs/resolver-binding-android-arm64': 1.12.2
+ '@unrs/resolver-binding-darwin-arm64': 1.12.2
+ '@unrs/resolver-binding-darwin-x64': 1.12.2
+ '@unrs/resolver-binding-freebsd-x64': 1.12.2
+ '@unrs/resolver-binding-linux-arm-gnueabihf': 1.12.2
+ '@unrs/resolver-binding-linux-arm-musleabihf': 1.12.2
+ '@unrs/resolver-binding-linux-arm64-gnu': 1.12.2
+ '@unrs/resolver-binding-linux-arm64-musl': 1.12.2
+ '@unrs/resolver-binding-linux-loong64-gnu': 1.12.2
+ '@unrs/resolver-binding-linux-loong64-musl': 1.12.2
+ '@unrs/resolver-binding-linux-ppc64-gnu': 1.12.2
+ '@unrs/resolver-binding-linux-riscv64-gnu': 1.12.2
+ '@unrs/resolver-binding-linux-riscv64-musl': 1.12.2
+ '@unrs/resolver-binding-linux-s390x-gnu': 1.12.2
+ '@unrs/resolver-binding-linux-x64-gnu': 1.12.2
+ '@unrs/resolver-binding-linux-x64-musl': 1.12.2
+ '@unrs/resolver-binding-openharmony-arm64': 1.12.2
+ '@unrs/resolver-binding-wasm32-wasi': 1.12.2
+ '@unrs/resolver-binding-win32-arm64-msvc': 1.12.2
+ '@unrs/resolver-binding-win32-ia32-msvc': 1.12.2
+ '@unrs/resolver-binding-win32-x64-msvc': 1.12.2
+
+ unstorage@1.17.5(db0@0.3.4)(ioredis@5.10.1):
+ dependencies:
+ anymatch: 3.1.3
+ chokidar: 5.0.0
+ destr: 2.0.5
+ h3: 1.15.11
+ lru-cache: 11.5.0
+ node-fetch-native: 1.6.7
+ ofetch: 1.5.1
+ ufo: 1.6.4
+ optionalDependencies:
+ db0: 0.3.4
+ ioredis: 5.10.1
+
+ unstorage@2.0.0-alpha.7(chokidar@5.0.0)(db0@0.3.4)(ioredis@5.10.1)(lru-cache@11.5.0)(ofetch@1.5.1):
+ optionalDependencies:
+ chokidar: 5.0.0
+ db0: 0.3.4
+ ioredis: 5.10.1
+ lru-cache: 11.5.0
+ ofetch: 1.5.1
+
+ unstorage@2.0.0-alpha.7(chokidar@5.0.0)(db0@0.3.4)(ioredis@5.10.1)(lru-cache@11.5.0)(ofetch@2.0.0-alpha.3):
+ optionalDependencies:
+ chokidar: 5.0.0
+ db0: 0.3.4
+ ioredis: 5.10.1
+ lru-cache: 11.5.0
+ ofetch: 2.0.0-alpha.3
+
+ untun@0.1.3:
+ dependencies:
+ citty: 0.1.6
+ consola: 3.4.2
+ pathe: 1.1.2
+
+ untyped@2.0.0:
+ dependencies:
+ citty: 0.1.6
+ defu: 6.1.7
+ jiti: 2.7.0
+ knitwork: 1.3.0
+ scule: 1.3.0
+
+ unwasm@0.5.3:
+ dependencies:
+ exsolve: 1.0.8
+ knitwork: 1.3.0
+ magic-string: 0.30.21
+ mlly: 1.8.2
+ pathe: 2.0.3
+ pkg-types: 2.3.1
+
+ update-browserslist-db@1.2.3(browserslist@4.28.2):
+ dependencies:
+ browserslist: 4.28.2
+ escalade: 3.2.0
+ picocolors: 1.1.1
+
+ uqr@0.1.3: {}
+
+ uri-js@4.4.1:
+ dependencies:
+ punycode: 2.3.1
+
+ url-loader@4.1.1(file-loader@6.2.0(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)))(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)):
+ dependencies:
+ loader-utils: 2.0.4
+ mime-types: 2.1.35
+ schema-utils: 3.3.0
+ webpack: 5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)
+ optionalDependencies:
+ file-loader: 6.2.0(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+
+ util-deprecate@1.0.2: {}
+
+ valibot@1.4.0(typescript@6.0.3):
+ optionalDependencies:
+ typescript: 6.0.3
+
+ validate-npm-package-license@3.0.4:
+ dependencies:
+ spdx-correct: 3.2.0
+ spdx-expression-parse: 3.0.1
+
+ validate-npm-package-name@5.0.1: {}
+
+ version-guard@1.1.3: {}
+
+ vfile-location@5.0.3:
+ dependencies:
+ '@types/unist': 3.0.3
+ vfile: 6.0.3
+
+ vfile-message@4.0.3:
+ dependencies:
+ '@types/unist': 3.0.3
+ unist-util-stringify-position: 4.0.0
+
+ vfile@6.0.3:
+ dependencies:
+ '@types/unist': 3.0.3
+ vfile-message: 4.0.3
+
+ vite-node@6.0.0(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0):
+ dependencies:
+ cac: 7.0.0
+ es-module-lexer: 2.1.0
+ obug: 2.1.1
+ pathe: 2.0.3
+ vite: 8.0.12(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0)
+ transitivePeerDependencies:
+ - '@types/node'
+ - '@vitejs/devtools'
+ - esbuild
+ - jiti
+ - less
+ - sass
+ - sass-embedded
+ - stylus
+ - sugarss
+ - terser
+ - tsx
+ - yaml
+
+ vite-plugin-checker@0.13.0(eslint@9.39.4(jiti@2.7.0))(optionator@0.9.4)(typescript@6.0.3)(vite@8.0.12)(vue-tsc@3.2.9(typescript@6.0.3)):
+ dependencies:
+ '@babel/code-frame': 7.29.0
+ chokidar: 4.0.3
+ npm-run-path: 6.0.0
+ picocolors: 1.1.1
+ picomatch: 4.0.4
+ proper-lockfile: 4.1.2
+ tiny-invariant: 1.3.3
+ tinyglobby: 0.2.16
+ vite: 8.0.12(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0)
+ vscode-uri: 3.1.0
+ optionalDependencies:
+ eslint: 9.39.4(jiti@2.7.0)
+ optionator: 0.9.4
+ typescript: 6.0.3
+ vue-tsc: 3.2.9(typescript@6.0.3)
+
+ vite-plugin-inspect@12.0.0-beta.2(@nuxt/kit@packages+kit)(crossws@0.4.5(srvx@0.11.15))(typescript@6.0.3)(vite@8.0.12):
+ dependencies:
+ '@vitejs/devtools-kit': 0.1.24(crossws@0.4.5(srvx@0.11.15))(typescript@6.0.3)(vite@8.0.12)
+ ansis: 4.3.0
+ error-stack-parser-es: 1.0.5
+ obug: 2.1.1
+ ohash: 2.0.11
+ open: 11.0.0
+ perfect-debounce: 2.1.0
+ sirv: 3.0.2
+ unplugin-utils: 0.3.1
+ vite: 8.0.12(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0)
+ optionalDependencies:
+ '@nuxt/kit': link:packages/kit
+ transitivePeerDependencies:
+ - '@modelcontextprotocol/sdk'
+ - bufferutil
+ - crossws
+ - typescript
+ - utf-8-validate
+
+ vite-plugin-vue-tracer@1.4.0(vite@8.0.12)(vue@3.5.34(typescript@6.0.3)):
+ dependencies:
+ estree-walker: 3.0.3
+ exsolve: 1.0.8
+ magic-string: 0.30.21
+ pathe: 2.0.3
+ source-map-js: 1.2.1
+ vite: 8.0.12(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0)
+ vue: 3.5.34(typescript@6.0.3)
+
+ vite@8.0.12(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0):
+ dependencies:
+ lightningcss: 1.32.0
+ picomatch: 4.0.4
+ postcss: 8.5.14
+ rolldown: 1.0.0
+ tinyglobby: 0.2.16
+ optionalDependencies:
+ '@types/node': 24.12.4
+ '@vitejs/devtools': 0.1.24(@pnpm/logger@1001.0.1)(crossws@0.4.5(srvx@0.11.15))(db0@0.3.4)(ioredis@5.10.1)(typescript@6.0.3)(vite@8.0.12)
+ esbuild: 0.28.0
+ fsevents: 2.3.3
+ jiti: 2.7.0
+ terser: 5.48.0
+ yaml: 2.9.0
+
+ vitest-environment-nuxt@2.0.0(@playwright/test@1.60.0)(@testing-library/vue@8.1.0(@vue/compiler-dom@3.5.34)(@vue/compiler-sfc@3.5.34)(@vue/server-renderer@3.5.34(vue@3.5.34(typescript@6.0.3)))(vue@3.5.34(typescript@6.0.3)))(@vue/test-utils@2.4.10(@vue/compiler-dom@3.5.34)(@vue/server-renderer@3.5.34(vue@3.5.34(typescript@6.0.3)))(vue@3.5.34(typescript@6.0.3)))(crossws@0.4.5(srvx@0.11.15))(happy-dom@20.9.0)(magicast@0.5.3)(playwright-core@1.60.0)(typescript@6.0.3)(vite@8.0.12)(vitest@4.1.7):
+ dependencies:
+ '@nuxt/test-utils': 4.0.3(@playwright/test@1.60.0)(@testing-library/vue@8.1.0(@vue/compiler-dom@3.5.34)(@vue/compiler-sfc@3.5.34)(@vue/server-renderer@3.5.34(vue@3.5.34(typescript@6.0.3)))(vue@3.5.34(typescript@6.0.3)))(@vue/test-utils@2.4.10(@vue/compiler-dom@3.5.34)(@vue/server-renderer@3.5.34(vue@3.5.34(typescript@6.0.3)))(vue@3.5.34(typescript@6.0.3)))(crossws@0.4.5(srvx@0.11.15))(happy-dom@20.9.0)(magicast@0.5.3)(playwright-core@1.60.0)(typescript@6.0.3)(vite@8.0.12)(vitest@4.1.7)
+ transitivePeerDependencies:
+ - '@cucumber/cucumber'
+ - '@jest/globals'
+ - '@playwright/test'
+ - '@testing-library/vue'
+ - '@vitest/ui'
+ - '@vue/test-utils'
+ - crossws
+ - happy-dom
+ - jsdom
+ - magicast
+ - playwright-core
+ - typescript
+ - vite
+ - vitest
+
+ vitest@4.1.6(@types/node@24.12.4)(@vitest/coverage-v8@4.1.7(vitest@4.1.7))(happy-dom@20.9.0)(vite@8.0.12):
+ dependencies:
+ '@vitest/expect': 4.1.6
+ '@vitest/mocker': 4.1.6(vite@8.0.12)
+ '@vitest/pretty-format': 4.1.6
+ '@vitest/runner': 4.1.6
+ '@vitest/snapshot': 4.1.6
+ '@vitest/spy': 4.1.6
+ '@vitest/utils': 4.1.6
+ es-module-lexer: 2.1.0
+ expect-type: 1.3.0
+ magic-string: 0.30.21
+ obug: 2.1.1
+ pathe: 2.0.3
+ picomatch: 4.0.4
+ std-env: 4.1.0
+ tinybench: 2.9.0
+ tinyexec: 1.1.2
+ tinyglobby: 0.2.16
+ tinyrainbow: 3.1.0
+ vite: 8.0.12(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0)
+ why-is-node-running: 2.3.0
+ optionalDependencies:
+ '@types/node': 24.12.4
+ '@vitest/coverage-v8': 4.1.7(vitest@4.1.7)
+ happy-dom: 20.9.0
+ transitivePeerDependencies:
+ - msw
+
+ vitest@4.1.7(@types/node@24.12.4)(@vitest/coverage-v8@4.1.7)(happy-dom@20.9.0)(vite@8.0.12):
+ dependencies:
+ '@vitest/expect': 4.1.7
+ '@vitest/mocker': 4.1.7(vite@8.0.12)
+ '@vitest/pretty-format': 4.1.7
+ '@vitest/runner': 4.1.7
+ '@vitest/snapshot': 4.1.7
+ '@vitest/spy': 4.1.7
+ '@vitest/utils': 4.1.7
+ es-module-lexer: 2.1.0
+ expect-type: 1.3.0
+ magic-string: 0.30.21
+ obug: 2.1.1
+ pathe: 2.0.3
+ picomatch: 4.0.4
+ std-env: 4.1.0
+ tinybench: 2.9.0
+ tinyexec: 1.1.2
+ tinyglobby: 0.2.16
+ tinyrainbow: 3.1.0
+ vite: 8.0.12(@types/node@24.12.4)(@vitejs/devtools@0.1.24)(esbuild@0.28.0)(jiti@2.7.0)(terser@5.48.0)(yaml@2.9.0)
+ why-is-node-running: 2.3.0
+ optionalDependencies:
+ '@types/node': 24.12.4
+ '@vitest/coverage-v8': 4.1.7(vitest@4.1.7)
+ happy-dom: 20.9.0
+ transitivePeerDependencies:
+ - msw
+
+ void-elements@3.1.0: {}
+
+ vscode-uri@3.1.0: {}
+
+ vue-bundle-renderer@2.2.0:
+ dependencies:
+ ufo: 1.6.4
+
+ vue-component-type-helpers@3.3.1: {}
+
+ vue-devtools-stub@0.1.0: {}
+
+ vue-eslint-parser@10.4.0(eslint@9.39.4(jiti@2.7.0)):
+ dependencies:
+ debug: 4.4.3
+ eslint: 9.39.4(jiti@2.7.0)
+ eslint-scope: 9.1.2
+ eslint-visitor-keys: 5.0.1
+ espree: 11.2.0
+ esquery: 1.7.0
+ semver: 7.8.0
+ transitivePeerDependencies:
+ - supports-color
+
+ vue-loader@17.4.2(@vue/compiler-sfc@3.5.34)(vue@3.5.34(typescript@6.0.3))(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)):
+ dependencies:
+ chalk: 4.1.2
+ hash-sum: 2.0.0
+ watchpack: 2.5.1
+ webpack: 5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)
+ optionalDependencies:
+ '@vue/compiler-sfc': 3.5.34
+ vue: 3.5.34(typescript@6.0.3)
+
+ vue-resize@2.0.0-alpha.1(vue@3.5.34(typescript@6.0.3)):
+ dependencies:
+ vue: 3.5.34(typescript@6.0.3)
+
+ vue-router@5.0.7(@vue/compiler-sfc@3.5.34)(vue@3.5.34(typescript@6.0.3)):
+ dependencies:
+ '@babel/generator': 8.0.0-rc.5
+ '@vue-macros/common': 3.1.2(vue@3.5.34(typescript@6.0.3))
+ '@vue/devtools-api': 8.1.2
+ ast-walker-scope: 0.8.3
+ chokidar: 5.0.0
+ json5: 2.2.3
+ local-pkg: 1.2.1
+ magic-string: 0.30.21
+ mlly: 1.8.2
+ muggle-string: 0.4.1
+ pathe: 2.0.3
+ picomatch: 4.0.4
+ scule: 1.3.0
+ tinyglobby: 0.2.16
+ unplugin: 3.0.0
+ unplugin-utils: 0.3.1
+ vue: 3.5.34(typescript@6.0.3)
+ yaml: 2.9.0
+ optionalDependencies:
+ '@vue/compiler-sfc': 3.5.34
+
+ vue-sfc-transformer@0.1.17(@vue/compiler-core@3.5.34)(esbuild@0.28.0)(vue@3.5.34(typescript@6.0.3)):
+ dependencies:
+ '@babel/parser': 7.29.3
+ '@vue/compiler-core': 3.5.34
+ esbuild: 0.28.0
+ vue: 3.5.34(typescript@6.0.3)
+
+ vue-tsc@3.2.9(typescript@6.0.3):
+ dependencies:
+ '@volar/typescript': 2.4.28
+ '@vue/language-core': 3.2.9
+ typescript: 6.0.3
+
+ vue-virtual-scroller@3.0.4(vue@3.5.34(typescript@6.0.3)):
+ dependencies:
+ vue: 3.5.34(typescript@6.0.3)
+
+ vue@3.5.34(typescript@5.9.3):
+ dependencies:
+ '@vue/compiler-dom': 3.5.34
+ '@vue/compiler-sfc': 3.5.34
+ '@vue/runtime-dom': 3.5.34
+ '@vue/server-renderer': 3.5.34(vue@3.5.34(typescript@6.0.3))
+ '@vue/shared': 3.5.34
+ optionalDependencies:
+ typescript: 5.9.3
+
+ vue@3.5.34(typescript@6.0.3):
+ dependencies:
+ '@vue/compiler-dom': 3.5.34
+ '@vue/compiler-sfc': 3.5.34
+ '@vue/runtime-dom': 3.5.34
+ '@vue/server-renderer': 3.5.34(vue@3.5.34(typescript@6.0.3))
+ '@vue/shared': 3.5.34
+ optionalDependencies:
+ typescript: 6.0.3
+
+ walk-up-path@4.0.0: {}
+
+ watchpack@2.5.1:
+ dependencies:
+ glob-to-regexp: 0.4.1
+ graceful-fs: 4.2.11
+
+ web-namespaces@2.0.1: {}
+
+ webidl-conversions@3.0.1: {}
+
+ webpack-bundle-analyzer@5.3.0:
+ dependencies:
+ '@discoveryjs/json-ext': 0.6.3
+ acorn: 8.16.0
+ acorn-walk: 8.3.5
+ commander: 14.0.3
+ escape-string-regexp: 5.0.0
+ html-escaper: 3.0.3
+ opener: 1.5.2
+ picocolors: 1.1.1
+ sirv: 3.0.2
+ ws: 8.21.0
+ transitivePeerDependencies:
+ - bufferutil
+ - utf-8-validate
+
+ webpack-dev-middleware@8.0.3(tslib@2.8.1)(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)):
+ dependencies:
+ memfs: 4.57.2(tslib@2.8.1)
+ mime-types: 3.0.2
+ on-finished: 2.4.1
+ range-parser: 1.2.1
+ schema-utils: 4.3.3
+ optionalDependencies:
+ webpack: 5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)
+ transitivePeerDependencies:
+ - tslib
+
+ webpack-hot-middleware@2.26.1:
+ dependencies:
+ ansi-html-community: 0.0.8
+ html-entities: 2.6.0
+ strip-ansi: 6.0.1
+
+ webpack-sources@3.5.0: {}
+
+ webpack-virtual-modules@0.6.2: {}
+
+ webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14):
+ dependencies:
+ '@types/eslint-scope': 3.7.7
+ '@types/estree': 1.0.9
+ '@types/json-schema': 7.0.15
+ '@webassemblyjs/ast': 1.14.1
+ '@webassemblyjs/wasm-edit': 1.14.1
+ '@webassemblyjs/wasm-parser': 1.14.1
+ acorn: 8.16.0
+ acorn-import-phases: 1.0.4(acorn@8.16.0)
+ browserslist: 4.28.2
+ chrome-trace-event: 1.0.4
+ enhanced-resolve: 5.22.0
+ es-module-lexer: 2.1.0
+ eslint-scope: 5.1.1
+ events: 3.3.0
+ glob-to-regexp: 0.4.1
+ graceful-fs: 4.2.11
+ loader-runner: 4.3.2
+ mime-db: 1.54.0
+ neo-async: 2.6.2
+ schema-utils: 4.3.3
+ tapable: 2.3.3
+ terser-webpack-plugin: 5.6.0(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ watchpack: 2.5.1
+ webpack-sources: 3.5.0
+ transitivePeerDependencies:
+ - '@minify-html/node'
+ - '@swc/core'
+ - '@swc/css'
+ - '@swc/html'
+ - clean-css
+ - cssnano
+ - csso
+ - esbuild
+ - html-minifier-terser
+ - lightningcss
+ - postcss
+ - uglify-js
+
+ webpack@5.106.2(esbuild@0.28.0)(lightningcss@1.32.0):
+ dependencies:
+ '@types/eslint-scope': 3.7.7
+ '@types/estree': 1.0.9
+ '@types/json-schema': 7.0.15
+ '@webassemblyjs/ast': 1.14.1
+ '@webassemblyjs/wasm-edit': 1.14.1
+ '@webassemblyjs/wasm-parser': 1.14.1
+ acorn: 8.16.0
+ acorn-import-phases: 1.0.4(acorn@8.16.0)
+ browserslist: 4.28.2
+ chrome-trace-event: 1.0.4
+ enhanced-resolve: 5.22.0
+ es-module-lexer: 2.1.0
+ eslint-scope: 5.1.1
+ events: 3.3.0
+ glob-to-regexp: 0.4.1
+ graceful-fs: 4.2.11
+ loader-runner: 4.3.2
+ mime-db: 1.54.0
+ neo-async: 2.6.2
+ schema-utils: 4.3.3
+ tapable: 2.3.3
+ terser-webpack-plugin: 5.6.0(esbuild@0.28.0)(lightningcss@1.32.0)(webpack@5.106.2(esbuild@0.28.0)(lightningcss@1.32.0))
+ watchpack: 2.5.1
+ webpack-sources: 3.5.0
+ transitivePeerDependencies:
+ - '@minify-html/node'
+ - '@swc/core'
+ - '@swc/css'
+ - '@swc/html'
+ - clean-css
+ - cssnano
+ - csso
+ - esbuild
+ - html-minifier-terser
+ - lightningcss
+ - postcss
+ - uglify-js
+
+ webpack@5.106.2(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14):
+ dependencies:
+ '@types/eslint-scope': 3.7.7
+ '@types/estree': 1.0.9
+ '@types/json-schema': 7.0.15
+ '@webassemblyjs/ast': 1.14.1
+ '@webassemblyjs/wasm-edit': 1.14.1
+ '@webassemblyjs/wasm-parser': 1.14.1
+ acorn: 8.16.0
+ acorn-import-phases: 1.0.4(acorn@8.16.0)
+ browserslist: 4.28.2
+ chrome-trace-event: 1.0.4
+ enhanced-resolve: 5.22.0
+ es-module-lexer: 2.1.0
+ eslint-scope: 5.1.1
+ events: 3.3.0
+ glob-to-regexp: 0.4.1
+ graceful-fs: 4.2.11
+ loader-runner: 4.3.2
+ mime-db: 1.54.0
+ neo-async: 2.6.2
+ schema-utils: 4.3.3
+ tapable: 2.3.3
+ terser-webpack-plugin: 5.6.0(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)(webpack@5.106.2(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14))
+ watchpack: 2.5.1
+ webpack-sources: 3.5.0
+ transitivePeerDependencies:
+ - '@minify-html/node'
+ - '@swc/core'
+ - '@swc/css'
+ - '@swc/html'
+ - clean-css
+ - cssnano
+ - csso
+ - esbuild
+ - html-minifier-terser
+ - lightningcss
+ - postcss
+ - uglify-js
+ optional: true
+
+ webpackbar@7.0.0(@rspack/core@2.0.3)(webpack@5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)):
+ dependencies:
+ ansis: 3.17.0
+ consola: 3.4.2
+ pretty-time: 1.1.0
+ std-env: 3.10.0
+ optionalDependencies:
+ '@rspack/core': 2.0.3
+ webpack: 5.106.2(cssnano@8.0.1(postcss@8.5.14))(esbuild@0.28.0)(lightningcss@1.32.0)(postcss@8.5.14)
+
+ whatwg-mimetype@3.0.0: {}
+
+ whatwg-url@5.0.0:
+ dependencies:
+ tr46: 0.0.3
+ webidl-conversions: 3.0.1
+
+ which-boxed-primitive@1.1.1:
+ dependencies:
+ is-bigint: 1.1.0
+ is-boolean-object: 1.2.2
+ is-number-object: 1.1.1
+ is-string: 1.1.1
+ is-symbol: 1.1.1
+
+ which-collection@1.0.2:
+ dependencies:
+ is-map: 2.0.3
+ is-set: 2.0.3
+ is-weakmap: 2.0.2
+ is-weakset: 2.0.4
+
+ which-typed-array@1.1.20:
+ dependencies:
+ available-typed-arrays: 1.0.7
+ call-bind: 1.0.9
+ call-bound: 1.0.4
+ for-each: 0.3.5
+ get-proto: 1.0.1
+ gopd: 1.2.0
+ has-tostringtag: 1.0.2
+
+ which@2.0.2:
+ dependencies:
+ isexe: 2.0.0
+
+ which@6.0.1:
+ dependencies:
+ isexe: 4.0.0
+
+ why-is-node-running@2.3.0:
+ dependencies:
+ siginfo: 2.0.0
+ stackback: 0.0.2
+
+ with@7.0.2:
+ dependencies:
+ '@babel/parser': 7.29.3
+ '@babel/types': 7.29.0
+ assert-never: 1.4.0
+ babel-walk: 3.0.0-canary-5
+
+ word-wrap@1.2.5: {}
+
+ wrap-ansi@7.0.0:
+ dependencies:
+ ansi-styles: 4.3.0
+ string-width: 4.2.3
+ strip-ansi: 6.0.1
+
+ wrap-ansi@8.1.0:
+ dependencies:
+ ansi-styles: 6.2.3
+ string-width: 5.1.2
+ strip-ansi: 7.2.0
+
+ wrap-ansi@9.0.2:
+ dependencies:
+ ansi-styles: 6.2.3
+ string-width: 7.2.0
+ strip-ansi: 7.2.0
+
+ write-file-atomic@5.0.1:
+ dependencies:
+ imurmurhash: 0.1.4
+ signal-exit: 4.1.0
+
+ write-yaml-file@5.0.0:
+ dependencies:
+ js-yaml: 4.1.1
+ write-file-atomic: 5.0.1
+
+ ws@8.21.0: {}
+
+ wsl-utils@0.1.0:
+ dependencies:
+ is-wsl: 3.1.1
+
+ wsl-utils@0.3.1:
+ dependencies:
+ is-wsl: 3.1.1
+ powershell-utils: 0.1.0
+
+ xml-name-validator@4.0.0: {}
+
+ xxhashjs@0.2.2:
+ dependencies:
+ cuint: 0.2.2
+
+ y18n@5.0.8: {}
+
+ yallist@3.1.1: {}
+
+ yallist@5.0.0: {}
+
+ yaml@2.9.0: {}
+
+ yargs-parser@20.2.9: {}
+
+ yargs-parser@22.0.0: {}
+
+ yargs@16.2.0:
+ dependencies:
+ cliui: 7.0.4
+ escalade: 3.2.0
+ get-caller-file: 2.0.5
+ require-directory: 2.1.1
+ string-width: 4.2.3
+ y18n: 5.0.8
+ yargs-parser: 20.2.9
+
+ yargs@18.0.0:
+ dependencies:
+ cliui: 9.0.1
+ escalade: 3.2.0
+ get-caller-file: 2.0.5
+ string-width: 7.2.0
+ y18n: 5.0.8
+ yargs-parser: 22.0.0
+
+ yocto-queue@0.1.0: {}
+
+ yocto-queue@1.2.2: {}
+
+ youch-core@0.3.3:
+ dependencies:
+ '@poppinss/exception': 1.2.3
+ error-stack-parser-es: 1.0.5
+
+ youch@4.1.1:
+ dependencies:
+ '@poppinss/colors': 4.1.6
+ '@poppinss/dumper': 0.7.0
+ '@speed-highlight/core': 1.2.15
+ cookie-es: 3.1.1
+ youch-core: 0.3.3
+
+ zip-stream@6.0.1:
+ dependencies:
+ archiver-utils: 5.0.2
+ compress-commons: 6.0.2
+ readable-stream: 4.7.0
+
+ zod@4.4.3: {}
+
+ zwitch@2.0.4: {}
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
new file mode 100644
index 000000000000..55fa46661aeb
--- /dev/null
+++ b/pnpm-workspace.yaml
@@ -0,0 +1,38 @@
+packages:
+ - docs
+ - packages/**
+ - '!packages/nuxi'
+ - '!packages/test-utils'
+ - '!packages/nuxt/test/package-fixture/pkg'
+ - playground
+ - test/fixtures/*
+ - test/fixtures/*/_local-modules/*
+
+patchedDependencies:
+ changelogen: patches/changelogen.patch
+
+publicHoistPattern:
+ - '*-loader'
+ - 'webpack-*'
+
+shellEmulator: true
+
+verifyDepsBeforeRun: install
+
+ignoreWorkspaceCycles: true
+
+overrides:
+ "@nuxt/kit": "workspace:*"
+ "@nuxt/schema": "workspace:*"
+ nuxt: "workspace:*"
+ vite: "8.0.12"
+ vue: "3.5.34"
+
+allowBuilds:
+ '@parcel/watcher': true
+ esbuild: true
+ unrs-resolver: false
+
+minimumReleaseAge: 1440
+minimumReleaseAgeExclude:
+ - '@nuxt/*'
diff --git a/renovate.json b/renovate.json
index aac65a1c7167..e1e46b55a05e 100644
--- a/renovate.json
+++ b/renovate.json
@@ -1,26 +1,83 @@
{
+ "$schema": "https://docs.renovatebot.com/renovate-schema.json",
"extends": [
- "@nuxtjs"
+ "github>nuxt/renovate-config-nuxt",
+ ":pinDevDependencies",
+ ":widenPeerDependencies"
],
- "baseBranches": [
- "dev",
- "next"
+ "baseBranchPatterns": [
+ "main",
+ "4.x",
+ "3.x"
],
"ignoreDeps": [
- "core-js",
- "memory-fs",
- "@rollup/plugin-node-resolve",
- "execa",
- "pify",
- "file-loader",
- "url-loader",
- "@babel/parser",
- "fs-extra",
- "chalk",
- "wrap-ansi",
- "@rollup/plugin-commonjs"
+ "node",
+ "npm"
],
- "lockFileMaintenance": {
- "enabled": true
+ "minimumReleaseAge": "1 day",
+ "packageRules": [
+ {
+ "groupName": "webpack",
+ "matchPackageNames": [
+ "/webpack/",
+ "/-loader/"
+ ]
+ },
+ {
+ "groupName": "vitest",
+ "matchPackageNames": [
+ "vitest",
+ "/^@vitest//"
+ ]
+ },
+ {
+ "matchBaseBranches": [
+ "main",
+ "4.x",
+ "3.x"
+ ],
+ "ignoreDeps": [
+ "nuxt",
+ "nuxt3",
+ "@nuxt/kit"
+ ]
+ },
+ {
+ "matchBaseBranches": [
+ "4.x",
+ "3.x"
+ ],
+ "matchUpdateTypes": [
+ "patch",
+ "minor",
+ "pin",
+ "digest",
+ "lockFileMaintenance"
+ ],
+ "groupName": "all non-major dependencies",
+ "groupSlug": "all-non-major",
+ "matchPackageNames": [
+ "*"
+ ]
+ },
+ {
+ "groupName": "rolldown",
+ "groupSlug": "rolldown",
+ "matchPackageNames": [
+ "rolldown",
+ "obuild"
+ ]
+ },
+ {
+ "matchPackageNames": [
+ "@nuxt/**"
+ ],
+ "minimumReleaseAge": "0"
+ }
+ ],
+ "vulnerabilityAlerts": {
+ "postUpdateOptions": [
+ "pnpmDedupe"
+ ]
}
}
diff --git a/scripts/_utils.ts b/scripts/_utils.ts
new file mode 100644
index 000000000000..db039b2f6aa3
--- /dev/null
+++ b/scripts/_utils.ts
@@ -0,0 +1,182 @@
+import process from 'node:process'
+import { promises as fsp } from 'node:fs'
+import { $fetch } from 'ofetch'
+import { resolve } from 'pathe'
+import { compare } from 'semver'
+import { glob } from 'tinyglobby'
+import { exec } from 'tinyexec'
+import { determineSemverChange, getGitDiff, loadChangelogConfig, parseCommits } from 'changelogen'
+
+export interface Dep {
+ name: string
+ range: string
+ type: string
+}
+
+type ThenArg = T extends PromiseLike ? U : T
+export type Package = ThenArg>
+
+export async function loadPackage (dir: string) {
+ const pkgPath = resolve(dir, 'package.json')
+ const data = JSON.parse(await fsp.readFile(pkgPath, 'utf-8').catch(() => '{}'))
+ const save = () => fsp.writeFile(pkgPath, JSON.stringify(data, null, 2) + '\n')
+
+ const updateDeps = (reviver: (dep: Dep) => Dep | void) => {
+ for (const type of ['dependencies', 'devDependencies', 'optionalDependencies', 'peerDependencies']) {
+ if (!data[type]) { continue }
+ for (const e of Object.entries(data[type])) {
+ const dep: Dep = { name: e[0], range: e[1] as string, type }
+ delete data[type][dep.name]
+ const updated = reviver(dep) || dep
+ data[updated.type] ||= {}
+ data[updated.type][updated.name] = updated.range
+ }
+ }
+ }
+
+ return {
+ dir,
+ data,
+ save,
+ updateDeps,
+ }
+}
+
+export async function loadWorkspace (dir: string) {
+ const workspacePkg = await loadPackage(dir)
+ const pkgDirs = (await glob(['packages/*', 'docs'], { onlyDirectories: true })).sort()
+
+ const packages: Package[] = []
+
+ for (const pkgDir of pkgDirs) {
+ const pkg = await loadPackage(pkgDir)
+ if (!pkg.data.name) { continue }
+ packages.push(pkg)
+ }
+
+ const find = (name: string) => {
+ const pkg = packages.find(pkg => pkg.data.name === name)
+ if (!pkg) {
+ throw new Error('Workspace package not found: ' + name)
+ }
+ return pkg
+ }
+
+ const rename = (from: string, to: string) => {
+ find(from).data._name = find(from).data.name
+ find(from).data.name = to
+ for (const pkg of packages) {
+ pkg.updateDeps((dep) => {
+ if (dep.name === from && !dep.range.startsWith('npm:')) {
+ dep.range = 'npm:' + to + '@' + dep.range
+ }
+ })
+ }
+ }
+
+ const setVersion = (name: string, newVersion: string, opts: { updateDeps?: boolean } = {}) => {
+ find(name).data.version = newVersion
+ if (!opts.updateDeps) { return }
+
+ for (const pkg of packages) {
+ pkg.updateDeps((dep) => {
+ if (dep.name === name) {
+ dep.range = newVersion
+ }
+ })
+ }
+ }
+
+ const save = () => Promise.all(packages.map(pkg => pkg.save()))
+
+ return {
+ dir,
+ workspacePkg,
+ packages,
+ save,
+ find,
+ rename,
+ setVersion,
+ }
+}
+
+export async function determineBumpType (since?: string) {
+ const config = await loadChangelogConfig(process.cwd())
+ const commits = await getLatestCommits(since)
+
+ return determineSemverChange(commits, config)
+}
+
+export async function getLatestTag () {
+ const { stdout: latestTag } = await exec('git', ['describe', '--tags', '--abbrev=0'])
+ return latestTag.trim()
+}
+
+export async function getLatestReleasedTag () {
+ const latestReleasedTag = await exec('git', ['tag', '-l']).then(r => r.stdout.trim().split('\n').filter(t => /v3\.\d+\.\d+/.test(t)).sort(compare)).then(r => r.pop()!.trim())
+ return latestReleasedTag
+}
+
+export async function getPreviousReleasedCommits () {
+ const config = await loadChangelogConfig(process.cwd())
+ const latestTag = await getLatestTag()
+ const latestReleasedTag = await getLatestReleasedTag()
+ const commits = parseCommits(await getGitDiff(latestTag, latestReleasedTag), config)
+ return commits
+}
+
+export async function getLatestCommits (since?: string) {
+ const config = await loadChangelogConfig(process.cwd())
+ const latestTag = await getLatestTag()
+
+ // If filtering by date, get commits with git log --since
+ if (since) {
+ const { stdout } = await exec('git', ['log', `${latestTag}..HEAD`, '--since', since, '--pretty=format:%H'])
+ const commitHashes = new Set(stdout.trim().split('\n').filter(Boolean))
+
+ const allCommits = parseCommits(await getGitDiff(latestTag), config)
+ return allCommits.filter((commit) => {
+ // Match against full hash (shortHash is abbreviated)
+ return Array.from(commitHashes).some(hash => hash.startsWith(commit.shortHash))
+ })
+ }
+
+ return parseCommits(await getGitDiff(latestTag), config)
+}
+
+export async function getContributors (since?: string) {
+ const contributors = [] as Array<{ name: string, username: string }>
+ const emails = new Set()
+ const latestTag = await getLatestTag()
+
+ const rawCommits = await getGitDiff(latestTag)
+
+ // Get commit hashes filtered by date if specified
+ let allowedHashes: Set | null = null
+ if (since) {
+ const { stdout } = await exec('git', ['log', `${latestTag}..HEAD`, '--since', since, '--pretty=format:%H'])
+ allowedHashes = new Set(stdout.trim().split('\n').filter(Boolean))
+ }
+
+ for (const commit of rawCommits) {
+ // Filter by date if specified
+ if (allowedHashes && !Array.from(allowedHashes).some(hash => hash.startsWith(commit.shortHash))) {
+ continue
+ }
+
+ if (emails.has(commit.author.email) || commit.author.name === 'renovate[bot]') { continue }
+ const { author } = await $fetch<{ author: { login: string, email: string } }>(`https://api.github.com/repos/nuxt/nuxt/commits/${commit.shortHash}`, {
+ headers: {
+ 'User-Agent': 'nuxt/nuxt',
+ 'Accept': 'application/vnd.github.v3+json',
+ 'Authorization': `token ${process.env.GITHUB_TOKEN}`,
+ },
+ }).catch(() => ({ author: null }))
+ if (!author) { continue }
+ if (!contributors.some(c => c.username === author.login)) {
+ contributors.push({ name: commit.author.name, username: author.login })
+ }
+ emails.add(author.email)
+ }
+ return contributors
+}
diff --git a/scripts/builtins.js b/scripts/builtins.js
deleted file mode 100644
index 4d6fa11f07eb..000000000000
--- a/scripts/builtins.js
+++ /dev/null
@@ -1,22 +0,0 @@
-/*
-** Core logic from https://github.com/sindresorhus/builtin-modules
-** Many thanks to @sindresorhus
-*/
-import Module from 'module'
-
-const blacklist = [
- 'sys'
-]
-
-export const builtins = Module.builtinModules
- .filter(x => !/^_|^(internal|v8|node-inspect)\/|\//.test(x) && !blacklist.includes(x))
- .sort()
-
-let builtinsObj = null
-
-const convertToObj = () => builtins.reduce((obj, builtin) => {
- obj[builtin] = true
- return obj
-}, (builtinsObj = {}))
-
-export const builtinsMap = () => builtinsObj || convertToObj()
diff --git a/scripts/bump-nightly.ts b/scripts/bump-nightly.ts
new file mode 100644
index 000000000000..32c1898a815b
--- /dev/null
+++ b/scripts/bump-nightly.ts
@@ -0,0 +1,46 @@
+import process from 'node:process'
+import { execFileSync } from 'node:child_process'
+import { inc } from 'semver'
+import { determineBumpType, getLatestTag, loadWorkspace } from './_utils.ts'
+
+const nightlyPackages = {
+ // nitro: 'nitro-nightly',
+ // h3: 'h3-nightly',
+ 'nuxi': 'nuxi-nightly',
+ '@nuxt/cli': '@nuxt/cli-nightly',
+}
+
+export async function bumpNightly () {
+ const workspace = await loadWorkspace(process.cwd())
+
+ const commit = execFileSync('git', ['rev-parse', '--short', 'HEAD'], { encoding: 'utf-8' }).trim().slice(0, 8)
+ const date = Math.round(Date.now() / (1000 * 60))
+
+ // TODO: revert after release of v4.2.0
+ // Get the date of the latest tag to filter out merged history commits
+ const latestTagName = await getLatestTag()
+ const tagDate = execFileSync('git', ['log', '-1', '--format=%ai', latestTagName], { encoding: 'utf-8' })
+ const sinceDate = tagDate.trim()
+
+ const bumpType = await determineBumpType(sinceDate)
+
+ for (const pkg of workspace.packages.filter(p => !p.data.private)) {
+ const newVersion = inc(pkg.data.version, bumpType || 'patch')
+ if (!newVersion) {
+ throw new Error(`Failed to increment version for package ${pkg.data.name} with version ${pkg.data.version}`)
+ }
+
+ workspace.setVersion(pkg.data.name, `${newVersion}-${date}.${commit}`, {
+ updateDeps: true,
+ })
+ for (const [name, nightlyName] of Object.entries(nightlyPackages)) {
+ if (pkg.data.dependencies && name in pkg.data.dependencies) {
+ pkg.data.dependencies[name] = `npm:${nightlyName}@latest`
+ }
+ }
+ const newname = pkg.data.name + '-nightly'
+ workspace.rename(pkg.data.name, newname)
+ }
+
+ await workspace.save()
+}
diff --git a/scripts/bump.ts b/scripts/bump.ts
new file mode 100644
index 000000000000..249265420cb3
--- /dev/null
+++ b/scripts/bump.ts
@@ -0,0 +1,23 @@
+import process from 'node:process'
+import { consola } from 'consola'
+import { loadWorkspace } from './_utils'
+
+async function main () {
+ const workspace = await loadWorkspace(process.cwd())
+
+ const newVersion = process.argv[2]
+ if (!newVersion) {
+ throw new Error('Please provide version!')
+ }
+
+ for (const pkg of workspace.packages.filter(p => !p.data.private)) {
+ workspace.setVersion(pkg.data.name, newVersion!)
+ }
+
+ await workspace.save()
+}
+
+main().catch((err) => {
+ consola.error(err)
+ process.exit(1)
+})
diff --git a/scripts/changelog.js b/scripts/changelog.js
deleted file mode 100644
index 99212088706d..000000000000
--- a/scripts/changelog.js
+++ /dev/null
@@ -1,153 +0,0 @@
-import consola from 'consola'
-import execa from 'execa'
-import groupBy from 'lodash/groupBy'
-import sortBy from 'lodash/sortBy'
-import uniq from 'lodash/uniq'
-import { writeFile } from 'fs-extra'
-
-const types = {
- fix: { title: '🐛 Bug Fixes' },
- feat: { title: '🚀 Features' },
- refactor: { title: '💅 Refactors' },
- perf: { title: '🔥 Performance' },
- examples: { title: '📝 Examples' },
- chore: { title: '🏡 Chore' },
- test: { title: '👓 Tests' }
-}
-
-const knownAuthors = [
- 'chopin',
- 'parsa',
- 'clark',
- 'galvez',
- 'lichter',
- 'molotkov',
- 'marrec',
- 'pim'
-]
-
-const isKnownAuthor = name => Boolean(knownAuthors.find(n => name.toLowerCase().includes(n)))
-
-const allowedTypes = Object.keys(types)
-
-async function main () {
- // Get last git tag
- const lastGitTag = await getLastGitTag()
-
- // Get current branch
- const currentGitBranch = await getCurrentGitBranch()
-
- // Get all commits from last release to current branch
- consola.log(`${currentGitBranch}...${lastGitTag}`)
- let commits = await getGitDiff(currentGitBranch, lastGitTag)
-
- // Parse commits as conventional commits
- commits = parseCommits(commits)
-
- // Filter commits
- commits = commits.filter(c =>
- allowedTypes.includes(c.type) &&
- c.scope !== 'deps'
- )
-
- // Generate markdown
- const markdown = generateMarkDown(commits)
-
- process.stdout.write('\n\n' + markdown + '\n\n')
- await writeFile('CHANGELOG.md', markdown, 'utf-8')
-}
-
-function execCommand (cmd, args) {
- return execa(cmd, args).then(r => r.stdout)
-}
-
-async function getLastGitTag () {
- const r = await execCommand('git', ['--no-pager', 'tag', '-l', '--sort=taggerdate']).then(r => r.split('\n'))
- return r[r.length - 1]
-}
-
-async function getCurrentGitBranch () {
- const r = await execCommand('git', ['rev-parse', '--abbrev-ref', 'HEAD'])
- return r
-}
-
-async function getGitDiff (from, to) {
- // # https://git-scm.com/docs/pretty-formats
- const r = await execCommand('git', ['--no-pager', 'log', `${from}...${to}`, '--pretty=%s|%h|%an|%ae'])
- return r.split('\n').map((line) => {
- const [message, commit, authorName, authorEmail] = line.split('|')
-
- return { message, commit, authorName, authorEmail }
- })
-}
-
-function parseCommits (commits) {
- return commits.filter(c => c.message.includes(':')).map((commit) => {
- let [type, ...message] = commit.message.split(':')
- message = message.join(':')
-
- // Extract references from message
- message = message.replace(/\((fixes) #\d+\)/g, '')
- const references = []
- const referencesRegex = /#[0-9]+/g
- let m
- while (m = referencesRegex.exec(message)) { // eslint-disable-line no-cond-assign
- references.push(m[0])
- }
-
- // Remove references and normalize
- message = message.replace(referencesRegex, '').replace(/\(\)/g, '').trim()
-
- // Extract scope from type
- let scope = type.match(/\((.*)\)/)
- if (scope) {
- scope = scope[1]
- }
- if (!scope) {
- scope = 'general'
- }
- type = type.split('(')[0]
-
- return {
- ...commit,
- message,
- type,
- scope,
- references
- }
- })
-}
-
-function generateMarkDown (commits) {
- const typeGroups = groupBy(commits, 'type')
-
- let markdown = ''
-
- for (const type of allowedTypes) {
- const group = typeGroups[type]
- if (!group || !group.length) {
- continue
- }
-
- const { title } = types[type]
- markdown += '\n\n' + '### ' + title + '\n\n'
-
- const scopeGroups = groupBy(group, 'scope')
- for (const scopeName in scopeGroups) {
- markdown += '- `' + scopeName + '`' + '\n'
- for (const commit of scopeGroups[scopeName]) {
- markdown += ' - ' + commit.references.join(', ') + (commit.references.length ? ' ' : '') + commit.message.replace(/^(.)/, v => v.toUpperCase()) + '\n'
- }
- }
- }
-
- const authors = sortBy(uniq(commits.map(commit => commit.authorName).filter(an => !isKnownAuthor(an))))
- if (authors.length) {
- markdown += '\n\n' + '### ' + '💖 Thanks to' + '\n\n'
- markdown += authors.map(name => '- ' + name).join('\n')
- }
-
- return markdown.trim()
-}
-
-main().catch(consola.error)
diff --git a/scripts/dev.js b/scripts/dev.js
deleted file mode 100755
index f9877cfeff8b..000000000000
--- a/scripts/dev.js
+++ /dev/null
@@ -1,72 +0,0 @@
-#!/usr/bin/env node -r esm
-import path from 'path'
-import fs from 'fs-extra'
-import consola from 'consola'
-
-import Package from './package.js'
-
-const useCjs = [
- '@nuxt/cli'
-]
-
-const stub = {
- es: 'export * from \'../src/index\'',
- cjs: `const esm = require('esm')
-
-const _require = esm(module)
-
-const execa = require('execa')
-
-global.__NUXT = {}
-Object.defineProperty(global.__NUXT, 'version', {
- enumerable: true,
- get() {
- try {
- const { stdout } = execa.sync('git', ['status', '-s', '-b', '--porcelain=2'])
-
- const status = { dirty: false }
- for (const line of stdout.split('\\n')) {
- if (line[0] === '#') {
- const match = line.match(/branch\\.([^\\s]+) (.*)$/)
- if (match && match.length) {
- status[match[1]] = match[2]
- }
- } else {
- status.dirty = true
- break
- }
- }
-
- return \`git<\${status.head}\${status.dirty ? '~' : '-'}\${(status.oid && status.oid.substr(0, 7)) || ''}>\` +
- (status.ab ? \` (\${status.ab})\` : '')
- } catch (err) {
- return 'source'
- }
- }
-})
-
-module.exports = _require('../src/index')
-`
-}
-
-async function main () {
- // Read package at current directory
- const rootPackage = new Package()
- const workspacePackages = await rootPackage.getWorkspacePackages()
-
- // Create a dev-only entrypoint to the src
- for (const pkg of workspacePackages) {
- if (!pkg.pkg.main || !pkg.options.build) {
- continue
- }
- consola.info(pkg.pkg.main)
- const distMain = pkg.resolvePath(pkg.pkg.main)
- await fs.mkdirp(path.dirname(distMain))
- await fs.writeFile(distMain, useCjs.includes(pkg.pkg.name) ? stub.cjs : stub.es)
- }
-}
-
-main().catch((error) => {
- consola.error(error)
- process.exit(1)
-})
diff --git a/scripts/example.sh b/scripts/example.sh
new file mode 100755
index 000000000000..168ed698361c
--- /dev/null
+++ b/scripts/example.sh
@@ -0,0 +1,3 @@
+#!/bin/bash
+
+pnpm --filter example-$2 $1
diff --git a/scripts/link.js b/scripts/link.js
deleted file mode 100644
index 952158c7266e..000000000000
--- a/scripts/link.js
+++ /dev/null
@@ -1,25 +0,0 @@
-const path = require('path')
-const consola = require('consola')
-const execa = require('execa')
-const fs = require('fs-extra')
-const glob = require('pify')(require('glob').glob)
-
-async function main () {
- const packageDirs = await glob('+(packages|distributions)/*')
-
- const packages = packageDirs.map(pkgDir => ({
- dir: pkgDir,
- pkg: fs.readJSONSync(path.join(pkgDir, 'package.json'))
- }))
-
- const packageNames = packages.map(p => p.pkg.name).join(' ')
-
- consola.info(`Linking ${packages.length} packages...`)
-
- await Promise.all(packages.map(pkg => execa('yarn', ['link'], { cwd: pkg.dir })))
-
- consola.log(`Link: \nyarn link ${packageNames}\n`)
- consola.log(`Unlink: \nyarn unlink ${packageNames}\n`)
-}
-
-main().catch(consola.error)
diff --git a/scripts/package b/scripts/package
deleted file mode 100755
index f008808fab18..000000000000
--- a/scripts/package
+++ /dev/null
@@ -1,57 +0,0 @@
-#!/usr/bin/env node -r esm
-
-import consola from 'consola'
-
-import Package from './package.js'
-
-async function main () {
- // Read package at current directory
- const rootPackage = new Package()
- const workspacePackages = await rootPackage.getWorkspacePackages()
-
- const watch = process.argv.includes('--watch')
-
- if (watch) {
- consola.info('Watch mode')
- }
-
- // Universal linkedDependencies based on workspace
- const linkedDependencies = workspacePackages
- .map(p => p.pkg.name.replace(p.options.suffix, ''))
-
- for (const pkg of workspacePackages) {
- pkg.options.linkedDependencies = (pkg.options.linkedDependencies || [])
- .concat(linkedDependencies)
- }
-
- // Step 1: Apply suffixes
- for (const pkg of workspacePackages) {
- if (pkg.options.suffix && pkg.options.suffix.length) {
- await pkg.suffixAndVersion()
- await pkg.writePackage()
- }
- }
-
- // Step 2: Build packages
- for (const pkg of workspacePackages) {
- if (pkg.options.build) {
- if (watch) {
- pkg.watch()
- } else {
- await pkg.build()
- }
- }
- }
-
- // Step 3: Link dependencies and Fix packages
- for (const pkg of workspacePackages) {
- pkg.syncLinkedDependencies()
- pkg.autoFix()
- pkg.writePackage()
- }
-}
-
-main().catch((error) => {
- consola.error(error)
- process.exit(1)
-})
diff --git a/scripts/package.js b/scripts/package.js
deleted file mode 100644
index 379eac6e4f09..000000000000
--- a/scripts/package.js
+++ /dev/null
@@ -1,355 +0,0 @@
-import { resolve } from 'path'
-import consola from 'consola'
-import spawn from 'cross-spawn'
-import { existsSync, readJSONSync, writeFile, copy, remove } from 'fs-extra'
-import _ from 'lodash'
-import { rollup, watch } from 'rollup'
-import { glob as _glob } from 'glob'
-import pify from 'pify'
-import sortPackageJson from 'sort-package-json'
-
-import rollupConfig from './rollup.config'
-
-const DEFAULTS = {
- rootDir: process.cwd(),
- pkgPath: 'package.json',
- configPath: 'package.js',
- distDir: 'dist',
- build: false,
- suffix: process.env.PACKAGE_SUFFIX ? `-${process.env.PACKAGE_SUFFIX}` : '',
- hooks: {}
-}
-
-const glob = pify(_glob)
-
-const sortObjectKeys = obj => _(obj).toPairs().sortBy(0).fromPairs().value()
-
-export default class Package {
- constructor (options) {
- // Assign options
- this.options = Object.assign({}, DEFAULTS, options)
-
- // Basic logger
- this.logger = consola
-
- // Init (sync)
- this._init()
- }
-
- _init () {
- // Try to read package.json
- this.readPkg()
-
- // Use tagged logger
- this.logger = consola.withTag(this.pkg.name)
-
- // Try to load config
- this.loadConfig()
- }
-
- resolvePath (...args) {
- return resolve(this.options.rootDir, ...args)
- }
-
- readPkg () {
- this.pkg = readJSONSync(this.resolvePath(this.options.pkgPath))
- }
-
- loadConfig () {
- const configPath = this.resolvePath(this.options.configPath)
-
- if (existsSync(configPath)) {
- let config = require(configPath)
- config = config.default || config
-
- Object.assign(this.options, config)
- }
- }
-
- async callHook (name, ...args) {
- let fns = this.options.hooks[name]
-
- if (!fns) {
- return
- }
-
- if (!Array.isArray(fns)) {
- fns = [fns]
- }
-
- for (const fn of fns) {
- await fn(this, ...args)
- }
- }
-
- load (relativePath, opts) {
- return new Package(Object.assign({
- rootDir: this.resolvePath(relativePath)
- }, opts))
- }
-
- async writePackage () {
- if (this.options.sortDependencies) {
- this.sortDependencies()
- }
- const pkgPath = this.resolvePath(this.options.pkgPath)
- this.logger.debug('Writing', pkgPath)
- await writeFile(pkgPath, JSON.stringify(this.pkg, null, 2) + '\n')
- }
-
- generateVersion () {
- const date = Math.round(Date.now() / (1000 * 60))
- const gitCommit = this.gitShortCommit()
- const baseVersion = this.pkg.version.split('-')[0]
- this.pkg.version = `${baseVersion}-${date}.${gitCommit}`
- }
-
- tryRequire (id) {
- try {
- return require(id)
- } catch (e) {
- }
- }
-
- suffixAndVersion () {
- this.logger.info(`Adding suffix ${this.options.suffix}`)
-
- const oldPkgName = this.pkg.name
-
- // Add suffix to the package name
- if (!oldPkgName.includes(this.options.suffix)) {
- this.pkg.name += this.options.suffix
- }
-
- // Apply suffix to all linkedDependencies
- if (this.pkg.dependencies) {
- for (const oldName of (this.options.linkedDependencies || [])) {
- const name = oldName + this.options.suffix
- const version = this.pkg.dependencies[oldName] || this.pkg.dependencies[name]
-
- delete this.pkg.dependencies[oldName]
- this.pkg.dependencies[name] = version
- }
- }
-
- if (typeof this.pkg.bin === 'string') {
- const { bin } = this.pkg
- this.pkg.bin = {
- [oldPkgName]: bin,
- [this.pkg.name]: bin
- }
- }
-
- this.generateVersion()
- }
-
- syncLinkedDependencies () {
- // Apply suffix to all linkedDependencies
- for (const _name of (this.options.linkedDependencies || [])) {
- const name = _name + (this.options.suffix || '')
-
- // Try to read pkg
- const pkg = this.tryRequire(`${name}/package.json`) ||
- this.tryRequire(`${_name}/package.json`)
-
- // Skip if pkg or dependency not found
- if (!pkg || !this.pkg.dependencies || !this.pkg.dependencies[name]) {
- continue
- }
-
- // Current version
- const currentVersion = this.pkg.dependencies[name]
- const caret = currentVersion[0] === '^'
-
- // Sync version
- this.pkg.dependencies[name] = caret ? `^${pkg.version}` : pkg.version
- }
- }
-
- async getWorkspacePackages () {
- const packages = []
-
- for (const workspace of this.pkg.workspaces || []) {
- const dirs = await glob(workspace)
- for (const dir of dirs) {
- if (existsSync(this.resolvePath(dir, 'package.json'))) {
- const pkg = new Package({ rootDir: this.resolvePath(dir) })
- packages.push(pkg)
- } else {
- consola.warn('Invalid workspace package:', dir)
- }
- }
- }
-
- return packages
- }
-
- async build (_watch = false) {
- // Prepare rollup config
- const config = {
- rootDir: this.options.rootDir,
- alias: {},
- replace: {},
- ...this.options.rollup
- }
-
- // Replace linkedDependencies with their suffixed version
- if (this.options.suffix && this.options.suffix.length) {
- for (const _name of (this.options.linkedDependencies || [])) {
- const name = _name + this.options.suffix
- config.replace[`'${_name}'`] = `'${name}'`
- config.alias[_name] = name
- }
- }
-
- // Allow extending config
- await this.callHook('build:extend', { config })
-
- // Create rollup config
- const _rollupConfig = rollupConfig(config, this.pkg)
-
- // Allow extending rollup config
- await this.callHook('build:extendRollup', {
- rollupConfig: _rollupConfig
- })
-
- if (_watch) {
- // Watch
- const watcher = watch(_rollupConfig)
- watcher.on('event', (event) => {
- switch (event.code) {
- // The watcher is (re)starting
- case 'START':
- return this.logger.debug('Watching for changes')
-
- // Building an individual bundle
- case 'BUNDLE_START':
- return this.logger.debug('Building bundle')
-
- // Finished building a bundle
- case 'BUNDLE_END':
- return
-
- // Finished building all bundles
- case 'END':
- this.emit('build:done')
- return this.logger.success('Bundle built')
-
- // Encountered an error while bundling
- case 'ERROR':
- return this.logger.error(event.error)
-
- // Encountered an unrecoverable error
- case 'FATAL':
- return this.logger.fatal(event.error)
-
- // Unknown event
- default:
- return this.logger.info(JSON.stringify(event))
- }
- })
- } else {
- // Build
- this.logger.info('Building bundle')
- try {
- const bundle = await rollup(_rollupConfig)
- await remove(_rollupConfig.output.dir)
- await bundle.write(_rollupConfig.output)
-
- this.logger.success('Bundle built')
- await this.callHook('build:done', { bundle })
-
- // Analyze bundle imports against pkg
- // if (this.pkg.dependencies) {
- // const dependencies = {}
- // for (const dep in this.pkg.dependencies) {
- // dependencies[dep] = this.pkg.dependencies[dep]
- // }
- // for (const imp of bundle.imports) {
- // delete dependencies[imp]
- // }
- // for (const dep in dependencies) {
- // this.logger.warn(`Unused dependency ${dep}@${dependencies[dep]}`)
- // }
- // }
- } catch (error) {
- this.logger.error(error)
- throw new Error('Error while building bundle')
- }
- }
- }
-
- watch () {
- return this.build(true)
- }
-
- publish (tag = 'latest') {
- this.logger.info(`publishing ${this.pkg.name}@${this.pkg.version} with tag ${tag}`)
- this.exec('npm', `publish --tag ${tag}`)
- }
-
- copyFieldsFrom (source, fields = []) {
- for (const field of fields) {
- this.pkg[field] = source.pkg[field]
- }
- }
-
- async copyFilesFrom (source, files) {
- for (const file of files || source.pkg.files || []) {
- const src = resolve(source.options.rootDir, file)
- const dst = resolve(this.options.rootDir, file)
- await copy(src, dst)
- }
- }
-
- autoFix () {
- this.pkg = sortPackageJson(this.pkg)
- this.sortDependencies()
- }
-
- sortDependencies () {
- if (this.pkg.dependencies) {
- this.pkg.dependencies = sortObjectKeys(this.pkg.dependencies)
- }
-
- if (this.pkg.devDependencies) {
- this.pkg.devDependencies = sortObjectKeys(this.pkg.devDependencies)
- }
- }
-
- exec (command, args, silent = false) {
- const r = spawn.sync(command, args.split(' '), { cwd: this.options.rootDir }, { env: process.env })
-
- if (!silent) {
- const fullCommand = command + ' ' + args
- if (r.error) {
- this.logger.error(fullCommand, r.error)
- } else {
- this.logger.success(fullCommand, r.output)
- }
- }
-
- return {
- error: r.error,
- pid: r.pid,
- status: r.status,
- signal: r.signal,
- stdout: String(r.stdout).trim(),
- stderr: String(r.stderr).trim(),
- output: (r.output || [])
- .map(l => String(l).trim())
- .filter(l => l.length)
- .join('\n')
- }
- }
-
- gitShortCommit () {
- const { stdout } = this.exec('git', 'rev-parse --short HEAD', true)
- return stdout
- }
-
- gitBranch () {
- const { stdout } = this.exec('git', 'rev-parse --abbrev-ref HEAD', true)
- return stdout
- }
-}
diff --git a/scripts/release-publish b/scripts/release-publish
deleted file mode 100755
index 05a9c2cf61fc..000000000000
--- a/scripts/release-publish
+++ /dev/null
@@ -1,14 +0,0 @@
-#!/bin/bash
-set -e
-
-if [ ! "$1" ]; then
- echo "Usage $0 [version]"
- exit 1
-fi
-
-yarn build
-
-./scripts/workspace-run npm publish -q
-
-git tag -a v$1 -m v$1
-git push --tags
diff --git a/scripts/release-version b/scripts/release-version
deleted file mode 100755
index 5881ae4e9507..000000000000
--- a/scripts/release-version
+++ /dev/null
@@ -1,4 +0,0 @@
-#!/bin/bash
-set -e
-
-yarn lerna version --no-changelog --no-git-tag-version --no-push --force-publish "*"
diff --git a/scripts/release.ts b/scripts/release.ts
new file mode 100644
index 000000000000..d1efbc3a4b78
--- /dev/null
+++ b/scripts/release.ts
@@ -0,0 +1,195 @@
+/* eslint-disable no-console */
+import process from 'node:process'
+import { execFileSync, execSync } from 'node:child_process'
+import { copyFileSync, readFileSync, readdirSync, writeFileSync } from 'node:fs'
+import { resolve } from 'node:path'
+
+interface PackageJson {
+ name: string
+ version: string
+}
+
+function execCommand (command: string, cwd?: string): void {
+ console.info(`🔧 Running: ${command}`)
+ execSync(command, { stdio: 'inherit', cwd })
+}
+
+function execFile (file: string, args: string[], cwd?: string): void {
+ console.info(`🔧 Running: ${file} ${args.join(' ')}`)
+ execFileSync(file, args, { stdio: 'inherit', cwd })
+}
+
+function readPackageJson (dir: string): PackageJson {
+ const pkgPath = resolve(dir, 'package.json')
+ return JSON.parse(readFileSync(pkgPath, 'utf-8'))
+}
+
+/**
+ * Exchange a GitHub Actions OIDC token for a short-lived npm registry token.
+ *
+ * This replicates what `npm publish` does internally with trusted publishing:
+ * 1. Request a GitHub OIDC id_token with audience "npm:registry.npmjs.org"
+ * 2. Exchange it with npm's OIDC endpoint for a scoped registry token
+ */
+async function getOidcToken (packageName: string): Promise {
+ const requestUrl = process.env.ACTIONS_ID_TOKEN_REQUEST_URL
+ const requestToken = process.env.ACTIONS_ID_TOKEN_REQUEST_TOKEN
+
+ if (!requestUrl || !requestToken) {
+ throw new Error('GitHub Actions OIDC environment not available (ACTIONS_ID_TOKEN_REQUEST_URL/TOKEN not set)')
+ }
+
+ // Step 1: Request GitHub OIDC id_token with npm audience
+ const idTokenUrl = `${requestUrl}&audience=${encodeURIComponent('npm:registry.npmjs.org')}`
+ const idTokenResponse = await fetch(idTokenUrl, {
+ headers: { authorization: `Bearer ${requestToken}` },
+ })
+ if (!idTokenResponse.ok) {
+ throw new Error(`Failed to get GitHub OIDC token: ${idTokenResponse.status} ${idTokenResponse.statusText}`)
+ }
+ const { value: idToken } = await idTokenResponse.json() as { value: string }
+
+ // Step 2: Exchange with npm registry for a short-lived publish token
+ const encodedName = packageName.replace('/', '%2f')
+ const exchangeUrl = `https://registry.npmjs.org/-/npm/v1/oidc/token/exchange/package/${encodedName}`
+ const exchangeResponse = await fetch(exchangeUrl, {
+ method: 'POST',
+ headers: { authorization: `Bearer ${idToken}` },
+ })
+ if (!exchangeResponse.ok) {
+ const body = await exchangeResponse.text()
+ throw new Error(`Failed to exchange OIDC token for npm token (${packageName}): ${exchangeResponse.status} ${exchangeResponse.statusText} - ${body}`)
+ }
+ const { token } = await exchangeResponse.json() as { token: string }
+ return token
+}
+
+/**
+ * Add a dist-tag to a package using the npm registry HTTP API.
+ *
+ * With trusted publishing (OIDC), only `npm publish` can authenticate via OIDC
+ * internally. Other commands like `npm dist-tag` cannot. This function obtains
+ * an npm token via the OIDC exchange and calls the registry dist-tags API directly.
+ */
+async function addDistTag (packageName: string, version: string, tag: string): Promise {
+ const token = await getOidcToken(packageName)
+ const encodedName = packageName.replace('/', '%2f')
+ const url = `https://registry.npmjs.org/-/package/${encodedName}/dist-tags/${encodeURIComponent(tag)}`
+
+ const response = await fetch(url, {
+ method: 'PUT',
+ headers: {
+ 'authorization': `Bearer ${token}`,
+ 'content-type': 'application/json',
+ },
+ body: JSON.stringify(version),
+ })
+
+ if (!response.ok) {
+ const body = await response.text()
+ throw new Error(`Failed to add dist-tag ${tag} to ${packageName}@${version}: ${response.status} ${response.statusText} - ${body}`)
+ }
+}
+
+async function main () {
+ const originalCwd = process.cwd()
+ const isNightly = process.argv.includes('--nightly')
+ const tagsInput = process.env.TAG || 'latest'
+ const allTags = tagsInput
+ .split(',')
+ .map(tag => tag.trim())
+ .filter(Boolean) as [string, ...string[]]
+
+ console.info(`🚀 ${isNightly ? 'Nightly' : 'Regular'} release with tags: ${allTags.join(', ')}`)
+
+ const [tag, ...additionalTags] = allTags
+
+ try {
+ // Restore all git changes
+ console.info('🔄 Restoring git changes...')
+ execCommand('git restore -s@ -SW -- packages examples docs')
+
+ if (isNightly) {
+ // Bump versions to nightly
+ console.info('🌙 Bumping versions to nightly...')
+ await import('./bump-nightly.ts').then(r => r.bumpNightly())
+ } else {
+ execCommand('pnpm build')
+ }
+
+ // Use absolute URLs for better rendering on npm
+ console.info('🔗 Updating README URLs...')
+ const originalReadme = readFileSync('README.md', 'utf-8')
+ const readme = originalReadme.replace(
+ /\.\/\.github\/assets/g,
+ 'https://github.com/nuxt/nuxt/blob/main/.github/assets',
+ )
+ writeFileSync('README.md', readme)
+
+ const repoRoot = resolve(import.meta.dirname, '..')
+
+ // Get all package directories
+ const packageDirs = [
+ ...readdirSync('packages', { withFileTypes: true })
+ .filter(dirent => dirent.isDirectory())
+ .map(dirent => `packages/${dirent.name}`),
+ 'docs',
+ ]
+
+ // Release packages
+ const packagesToSkip = ['packages/nuxi', 'packages/test-utils', 'packages/ui-templates']
+ const published: Array<{ name: string, version: string }> = []
+
+ for (const pkgDir of packageDirs) {
+ if (packagesToSkip.includes(pkgDir)) {
+ continue
+ }
+
+ console.info(`📦 Publishing ${pkgDir}`)
+ process.chdir(pkgDir)
+
+ // Copy LICENSE
+ copyFileSync(resolve(repoRoot, 'LICENSE'), 'LICENSE')
+
+ // Copy README if not docs
+ if (pkgDir !== 'docs') {
+ copyFileSync(resolve(repoRoot, 'README.md'), 'README.md')
+ }
+
+ // Publish with primary tag with trusted publishing
+ console.info(`🏷️ Publishing ${pkgDir} with tag: ${tag}`)
+ execFile('pnpm', ['publish', '--access', 'public', '--no-git-checks', '--tag', tag])
+
+ const pkg = readPackageJson('.')
+ published.push({ name: pkg.name, version: pkg.version })
+
+ process.chdir(repoRoot)
+ }
+
+ if (additionalTags.length > 0) {
+ console.info(`\n🏷️ Adding additional dist-tags: ${additionalTags.join(', ')}`)
+ for (const pkg of published) {
+ for (const additionalTag of additionalTags) {
+ try {
+ console.info(` 🏷️ Adding tag ${additionalTag} to ${pkg.name}@${pkg.version}`)
+ await addDistTag(pkg.name, pkg.version, additionalTag)
+ } catch (error) {
+ console.error(` 💥 Failed to add tag ${additionalTag} to ${pkg.name}@${pkg.version}:`, error)
+ }
+ }
+ }
+ }
+
+ // Restore README
+ writeFileSync('README.md', originalReadme)
+
+ console.info(`🎉 ${isNightly ? 'Nightly' : 'Regular'} release completed successfully!`)
+ } catch (error) {
+ console.error('💥 Release failed:', error)
+ process.exit(1)
+ } finally {
+ process.chdir(originalCwd)
+ }
+}
+
+main()
diff --git a/scripts/rollup.config.js b/scripts/rollup.config.js
deleted file mode 100644
index 8445ec1ec299..000000000000
--- a/scripts/rollup.config.js
+++ /dev/null
@@ -1,83 +0,0 @@
-import path from 'path'
-import { readJSONSync } from 'fs-extra'
-import jsonPlugin from '@rollup/plugin-json'
-import commonjsPlugin from '@rollup/plugin-commonjs'
-import replacePlugin from '@rollup/plugin-replace'
-import aliasPlugin from '@rollup/plugin-alias'
-import nodeResolvePlugin from '@rollup/plugin-node-resolve'
-import licensePlugin from 'rollup-plugin-license'
-import defaultsDeep from 'lodash/defaultsDeep'
-import consola from 'consola'
-
-import { builtins } from './builtins'
-
-export default function rollupConfig ({
- rootDir = process.cwd(),
- plugins = [],
- input = 'src/index.js',
- replace = {},
- alias = {},
- externals = [],
- resolve = {
- only: [
- /lodash/
- ]
- },
- ...options
-}, pkg) {
- if (!pkg) {
- pkg = readJSONSync(path.resolve(rootDir, 'package.json'))
- }
-
- const name = path.basename(pkg.name.replace('-edge', ''))
-
- return defaultsDeep({}, options, {
- input: path.resolve(rootDir, input),
- output: {
- dir: path.resolve(rootDir, 'dist'),
- entryFileNames: `${name}.js`,
- chunkFileNames: `${name}-[name].js`,
- format: 'cjs',
- preferConst: true
- },
- external: [
- // Dependencies that will be installed alongise with the nuxt package
- ...Object.keys(pkg.dependencies || {}),
- // Builtin node modules
- ...builtins,
- // Explicit externals
- ...externals
- ],
- plugins: [
- aliasPlugin(alias),
- replacePlugin({
- exclude: 'node_modules/**',
- delimiters: ['', ''],
- values: {
- __NODE_ENV__: process.env.NODE_ENV,
- ...replace
- }
- }),
- nodeResolvePlugin(resolve),
- commonjsPlugin(),
- jsonPlugin(),
- licensePlugin({
- banner: [
- '/*!',
- ` * ${pkg.name} v${pkg.version} (c) 2016-${new Date().getFullYear()}`,
- `${(pkg.contributors || []).map(c => ` * - ${c.name}`).join('\n')}`,
- ' * - All the amazing contributors',
- ' * Released under the MIT License.',
- ' * Website: https://nuxtjs.org',
- '*/'
- ].join('\n')
- })
- ].concat(plugins),
- onwarn (warning, warn) {
- if (warning.plugin === 'rollup-plugin-license') {
- return
- }
- consola.warn(warning)
- }
- })
-}
diff --git a/scripts/update-changelog.ts b/scripts/update-changelog.ts
new file mode 100644
index 000000000000..7530c547c210
--- /dev/null
+++ b/scripts/update-changelog.ts
@@ -0,0 +1,100 @@
+import process from 'node:process'
+import { execFileSync } from 'node:child_process'
+import { $fetch } from 'ofetch'
+import { inc } from 'semver'
+import { generateMarkDown, getCurrentGitBranch, loadChangelogConfig } from 'changelogen'
+import { consola } from 'consola'
+import { determineBumpType, getContributors, getLatestCommits, getLatestReleasedTag, getLatestTag, getPreviousReleasedCommits, loadWorkspace } from './_utils.ts'
+
+const handleSeparateBranch = false
+
+async function main () {
+ const releaseBranch = getCurrentGitBranch()
+ const workspace = await loadWorkspace(process.cwd())
+ const config = await loadChangelogConfig(process.cwd(), {})
+
+ const prevMessages = new Set(handleSeparateBranch ? await getPreviousReleasedCommits().then(r => r.map(c => c.message)) : [])
+
+ // TODO: revert after release of v4.2.0
+ // Get the date of the latest tag to filter out merged history commits
+ const latestTagName = await getLatestTag()
+ const tagDate = execFileSync('git', ['log', '-1', '--format=%ai', latestTagName], { encoding: 'utf-8' })
+ const sinceDate = tagDate.trim()
+
+ const commits = await getLatestCommits(sinceDate).then(commits => commits.filter(
+ c => config.types[c.type] && !(c.type === 'chore' && c.scope === 'deps') && !prevMessages.has(c.message),
+ ))
+ const bumpType = await determineBumpType(sinceDate) || 'patch'
+
+ const newVersion = inc(workspace.find('nuxt').data.version, bumpType)
+ const changelog = await generateMarkDown(commits, config)
+
+ // Create and push a branch with bumped versions if it has not already been created
+ const branchExists = execFileSync('git', ['ls-remote', '--heads', 'origin', `v${newVersion}`], { encoding: 'utf-8' }).trim().length > 0
+ if (!branchExists) {
+ execFileSync('git', ['config', '--global', 'user.email', 'daniel@roe.dev'])
+ execFileSync('git', ['config', '--global', 'user.name', 'Daniel Roe'])
+ execFileSync('git', ['checkout', '-b', `v${newVersion}`])
+
+ for (const pkg of workspace.packages.filter(p => !p.data.private)) {
+ workspace.setVersion(pkg.data.name, newVersion!)
+ }
+ await workspace.save()
+
+ execFileSync('git', ['commit', '-am', `v${newVersion}`])
+ execFileSync('git', ['push', '-u', 'origin', `v${newVersion}`])
+ }
+
+ // Get the current PR for this release, if it exists
+ const [currentPR] = await $fetch(`https://api.github.com/repos/nuxt/nuxt/pulls?head=nuxt:v${newVersion}`)
+ const contributors = await getContributors(sinceDate)
+
+ const latestTag = latestTagName
+ const previousReleasedTag = handleSeparateBranch ? await getLatestReleasedTag() : latestTag
+
+ const releaseNotes = [
+ currentPR?.body.replace(/## 👉 Changelog[\s\S]*$/, '') || `> ${newVersion} is the next ${bumpType} release.\n>\n> **Timetable**: to be announced.`,
+ '## 👉 Changelog',
+ changelog
+ .replace(/^## v.*\n/, '')
+ .replace(`...${releaseBranch}`, `...v${newVersion}`)
+ .replace(/### ❤️ Contributors[\s\S]*$/, '')
+ .replace(/[\n\r]+/g, '\n')
+ .replace(latestTag, previousReleasedTag),
+ '### ❤️ Contributors',
+ contributors.map(c => `- ${c.name} (@${c.username})`).join('\n'),
+ ].join('\n')
+
+ // Create a PR with release notes if none exists
+ if (!currentPR) {
+ return await $fetch('https://api.github.com/repos/nuxt/nuxt/pulls', {
+ method: 'POST',
+ headers: {
+ Authorization: `token ${process.env.GITHUB_TOKEN}`,
+ },
+ body: {
+ title: `v${newVersion}`,
+ head: `v${newVersion}`,
+ base: releaseBranch,
+ body: releaseNotes,
+ draft: true,
+ },
+ })
+ }
+
+ // Update release notes if the pull request does exist
+ await $fetch(`https://api.github.com/repos/nuxt/nuxt/pulls/${currentPR.number}`, {
+ method: 'PATCH',
+ headers: {
+ Authorization: `token ${process.env.GITHUB_TOKEN}`,
+ },
+ body: {
+ body: releaseNotes,
+ },
+ })
+}
+
+main().catch((err) => {
+ consola.error(err)
+ process.exit(1)
+})
diff --git a/scripts/workspace-run b/scripts/workspace-run
deleted file mode 100755
index 1e65e459f27e..000000000000
--- a/scripts/workspace-run
+++ /dev/null
@@ -1,10 +0,0 @@
-#!/bin/bash
-set -e
-
-for dir in packages/* distributions/* ; do
- # echo "$dir"
- pushd $dir > /dev/null
- $@
- popd > /dev/null
-done
-
diff --git a/test/basic.test.ts b/test/basic.test.ts
new file mode 100644
index 000000000000..24165ecc9f4a
--- /dev/null
+++ b/test/basic.test.ts
@@ -0,0 +1,2948 @@
+import { readdir } from 'node:fs/promises'
+import { fileURLToPath } from 'node:url'
+import { describe, expect, it, vi } from 'vitest'
+import { joinURL } from 'ufo'
+import { isCI, isWindows } from 'std-env'
+import { join } from 'pathe'
+import { $fetch, createPage, fetch, setup, startServer, url, useTestContext } from '@nuxt/test-utils/e2e'
+import { $fetchComponent } from '@nuxt/test-utils/experimental'
+import { createRegExp, exactly } from 'magic-regexp'
+
+import { asyncContext, builder, isDev, isTestingAppManifest, isWebpack } from './matrix'
+import { expectNoClientErrors, gotoPath, parseData, parsePayload, renderPage } from './utils'
+
+await setup({
+ rootDir: fileURLToPath(new URL('./fixtures/basic', import.meta.url)),
+ dev: isDev,
+ server: true,
+ browser: true,
+ setupTimeout: (isWindows ? 360 : 120) * 1000,
+ nuxtConfig: {
+ hooks: {
+ 'modules:done' () {
+ // TODO: investigate whether to upstream a fix to vite-plugin-vue or nuxt/test-utils
+ // Vite reads its `isProduction` value from NODE_ENV and passes this to some plugins
+ // like vite-plugin-vue
+ if (!isDev) {
+ process.env.NODE_ENV = 'production'
+ }
+ },
+ },
+ },
+})
+
+describe('server api', () => {
+ it('should serialize', async () => {
+ expect(await $fetch('/api/hello')).toBe('Hello API')
+ expect(await $fetch('/api/hey')).toEqual({
+ foo: 'bar',
+ baz: 'qux',
+ })
+ })
+
+ it('should preserve states', async () => {
+ expect(await $fetch('/api/counter')).toEqual({ count: 0 })
+ expect(await $fetch('/api/counter')).toEqual({ count: 1 })
+ expect(await $fetch('/api/counter')).toEqual({ count: 2 })
+ expect(await $fetch('/api/counter')).toEqual({ count: 3 })
+ })
+
+ it('should auto-import', async () => {
+ const res = await $fetch('/api/auto-imports')
+ expect(res).toMatchInlineSnapshot(`
+ {
+ "autoImported": "utils",
+ "fromServerDir": "test-utils",
+ "thisIs": "serverAutoImported",
+ }
+ `)
+ })
+})
+
+describe('route rules', () => {
+ it('should enable spa mode', async () => {
+ const headHtml = await $fetch('/route-rules/spa')
+
+ // SPA should render appHead tags
+ expect(headHtml).toContain('('/route-rules/spa')
+ expect(html).toContain('
')
+ })
+
+ it('should allow defining route rules inline', async () => {
+ const res = await fetch('/route-rules/inline')
+ expect(res.status).toEqual(200)
+ expect(res.headers.get('x-extend')).toEqual('added in routeRules')
+ })
+
+ it('test noScript routeRules', async () => {
+ const html = await $fetch('/no-scripts')
+ expect(html).not.toContain(' {
+ const { page } = await renderPage('/')
+ await page.waitForLoadState('networkidle')
+ await page.getByTestId('route-rules-redirect').click()
+ await vi.waitFor(() => page.url() === url('/#hello'), { timeout: 5_000 })
+ })
+
+ it('should run middleware defined in routeRules config', async () => {
+ const html = await $fetch('/route-rules/middleware')
+ expect(html).toContain('Hello from routeRules!')
+ })
+
+ it('should set layout defined in routeRules config', async () => {
+ const html = await $fetch('/route-rules/layout')
+ expect(html).toContain('Custom Layout')
+ })
+
+ it('should not extract payload for `ssr: false` routes with useAsyncData (#34279)', async () => {
+ const html = await $fetch('/route-rules/spa-async-data')
+ const { attrs } = parseData(html)
+ expect(attrs['data-ssr']).toEqual('false')
+ expect(attrs['data-src']).toBeUndefined()
+ expect(html).not.toContain('/route-rules/spa-async-data/_payload.json')
+ await expectNoClientErrors('/route-rules/spa-async-data')
+ })
+
+ it('should not generate payload route rules for non-wildcard ssr: false routes', () => {
+ // @ts-expect-error untyped internal property
+ const routeRules = useTestContext().nuxt._nitro.options.routeRules
+
+ expect(routeRules['/route-rules/isr-spa']).toMatchObject({
+ isr: 60,
+ ssr: false,
+ })
+ expect(routeRules['/route-rules/isr-spa/_payload.json']).toBeUndefined()
+ })
+
+ it('should generate payload route rules with explicit `ssr: true`', () => {
+ // @ts-expect-error untyped internal property
+ const routeRules = useTestContext().nuxt._nitro.options.routeRules
+
+ // https://github.com/nuxt/nuxt/issues/34856
+ expect(routeRules['/route-rules/swr-in-spa/_payload.json']).toMatchObject({
+ ssr: true,
+ cache: { swr: true },
+ })
+ })
+})
+
+describe('modules', () => {
+ it('should auto-register modules in ~/modules', async () => {
+ const result = await $fetch('/auto-registered-module')
+ expect(result).toEqual('handler added by auto-registered module')
+ })
+
+ it('should respect addServerHandler called from a nitro:config hook (#34982)', async () => {
+ const result = await $fetch('/auto-registered-module-late')
+ expect(result).toEqual('handler added from nitro:config hook')
+ })
+})
+
+describe('pages', () => {
+ it('exposes the current env name at runtime', async () => {
+ const expectedEnvName = isDev ? 'development' : 'production'
+ const { page } = await renderPage('/env-name')
+ expect(await page.getByTestId('env-name').textContent()).toBe(expectedEnvName)
+ await page.close()
+ })
+
+ it('render index', async () => {
+ const html = await $fetch('/')
+
+ // Snapshot
+ // expect(html).toMatchInlineSnapshot()
+
+ // should render text
+ expect(html).toContain('Hello Nuxt 3!')
+ // should inject runtime config
+ expect(html).toContain('RuntimeConfig | testConfig: 123')
+ expect(html).toContain('needsFallback:')
+ // composables auto import
+ expect(html).toContain('Composable | foo: auto imported from ~/composables/foo.ts')
+ expect(html).toContain('Composable | bar: auto imported from ~/utils/useBar.ts')
+ expect(html).toContain('Composable | template: auto imported from ~/composables/template.ts')
+ expect(html).toContain('Composable | star: auto imported from ~/composables/nested/bar.ts via star export')
+ // should import components
+ expect(html).toContain('This is a custom component with a named export.')
+ // should remove dev-only and replace with any fallback content
+ expect(html).toContain(isDev ? 'Some dev-only info' : 'Some prod-only info')
+ // should strip dev-only with attributes in production
+ if (isDev) {
+ expect(html).toContain('Dev-only with attributes')
+ } else {
+ expect(html).not.toContain('Dev-only with attributes')
+ }
+ // should render server-only components
+ expect(html.replaceAll(/ data-island-uid="[^"]*"/g, '')).toContain(' server-only component
server-only component child (non-server-only)
('/jsx')
+
+ // should import JSX/TSX components with custom elements
+ expect(html).toContain('TSX component')
+ expect(html).toContain('custom ')
+ expect(html).toContain('Sugar Counter 12 x 2 = 24')
+ })
+
+ it('respects aliases in page metadata', async () => {
+ const html = await $fetch('/some-alias')
+ expect(html).toContain('Hello Nuxt 3!')
+ })
+
+ it('respects redirects in page metadata', async () => {
+ const { headers } = await fetch('/redirect', { redirect: 'manual' })
+ expect(headers.get('location')).toEqual('/')
+ })
+
+ it('allows routes to be added dynamically', async () => {
+ const html = await $fetch('/add-route-test')
+ expect(html).toContain('Hello Nuxt 3!')
+ })
+
+ it('includes page metadata from pages added in pages:extend hook', async () => {
+ const res = await fetch('/page-extend')
+ expect(res.headers.get('x-extend')).toEqual('added in pages:extend')
+ })
+
+ it('preserves page metadata added in pages:extend hook', async () => {
+ const html = await $fetch('/some-custom-path')
+ // Normalise arrow function whitespace (esbuild with es2024 target strips spaces around =>)
+ expect(html.match(/([^<]*)<\/pre>/)?.[1]?.trim().replace(/"/g, '"').replace(/>/g, '>').replace(/\(\)\s*=>\s*/g, '() => ')).toMatchInlineSnapshot(`
+ "{
+ "name": "some-custom-name",
+ "path": "/some-custom-path",
+ "validate": "() => true",
+ "middleware": [
+ "() => true"
+ ],
+ "otherValue": "{\\"foo\\":\\"bar\\"}"
+ }"
+ `)
+ })
+
+ it('validates routes', async () => {
+ const { status, headers } = await fetch('/catchall/forbidden')
+ expect(status).toEqual(404)
+ expect(headers.get('Set-Cookie')).toBe('set-in-plugin=%22true%22; Path=/')
+
+ const { page } = await renderPage('/navigate-to-forbidden')
+
+ await page.getByText('should throw a 404 error').click()
+ expect(await page.getByRole('heading').textContent()).toMatchInlineSnapshot('"Page Not Found: /catchall/forbidden"')
+ expect(await page.getByTestId('path').textContent()).toMatchInlineSnapshot('" Path: /catchall/forbidden"')
+
+ await gotoPath(page, '/navigate-to-forbidden')
+ await page.getByText('should be caught by catchall').click()
+ expect(await page.getByRole('heading').textContent()).toMatchInlineSnapshot('"[...slug].vue"')
+
+ await page.close()
+ })
+
+ it('validates routes with custom statusCode and statusMessage', async () => {
+ const CUSTOM_ERROR_CODE = 401
+ const CUSTOM_ERROR_MESSAGE = 'Custom error message'
+ const ERROR_PAGE_TEXT = 'This is the error page'
+ const PAGE_TEXT = 'You should not see this'
+
+ // Check status code and message on fetch
+ const res = await fetch('/validate-custom-error')
+ const serverText = await res.text()
+
+ expect(res.status).toEqual(CUSTOM_ERROR_CODE)
+ expect(serverText).toContain(CUSTOM_ERROR_MESSAGE)
+ expect(serverText).not.toContain(PAGE_TEXT)
+
+ // Client-side navigation
+ const { page } = await renderPage('/navigate-to-validate-custom-error')
+ await page.getByText('should throw a 401 error with custom message').click()
+ // error.vue has an h1 tag
+ await page.waitForSelector('h1')
+
+ const clientText = await page.innerText('body')
+
+ expect(clientText).toContain(CUSTOM_ERROR_MESSAGE)
+ expect(clientText).toContain(ERROR_PAGE_TEXT)
+ expect(clientText).not.toContain(PAGE_TEXT)
+
+ await page.close()
+
+ // Server-side navigation
+ const { page: serverPage } = await renderPage('/validate-custom-error')
+ const serverPageText = await serverPage.innerText('body')
+
+ expect(serverPageText).toContain(CUSTOM_ERROR_MESSAGE)
+ expect(serverPageText).toContain(ERROR_PAGE_TEXT)
+ expect(serverPageText).not.toContain(PAGE_TEXT)
+
+ await serverPage.close()
+ })
+
+ it.runIf(isDev)('returns 500 when there is an infinite redirect', async () => {
+ const { status } = await fetch('/catchall/redirect-infinite', { redirect: 'manual' })
+ expect(status).toEqual(500)
+ })
+
+ it('render catchall page', async () => {
+ const res = await fetch('/catchall/not-found')
+ expect(res.status).toEqual(200)
+
+ const html = await res.text()
+
+ // Snapshot
+ // expect(html).toMatchInlineSnapshot()
+
+ expect(html).toContain('[...slug].vue')
+ expect(html).toContain('catchall at not-found')
+
+ // Middleware still runs after validation: https://github.com/nuxt/nuxt/issues/15650
+ expect(html).toContain('Middleware ran: true')
+
+ await expectNoClientErrors('/catchall/not-found')
+ })
+
+ it('should render correctly when loaded on a different path', async () => {
+ const { page, pageErrors } = await renderPage()
+ await page.goto(url('/proxy'))
+ await page.waitForFunction(() => window.useNuxtApp?.() && !window.useNuxtApp?.().isHydrating)
+
+ expect(await page.innerText('body')).toContain('Composable | foo: auto imported from ~/composables/foo.ts')
+ expect(pageErrors).toEqual([])
+
+ await page.close()
+ })
+
+ it('preserves query', async () => {
+ const html = await $fetch('/?test=true')
+
+ // Snapshot
+ // expect(html).toMatchInlineSnapshot()
+
+ // should render text
+ expect(html).toContain('Path: /?test=true')
+
+ await expectNoClientErrors('/?test=true')
+ })
+
+ it('/nested/[foo]/[bar].vue', async () => {
+ const html = await $fetch('/nested/one/two')
+
+ // Snapshot
+ // expect(html).toMatchInlineSnapshot()
+
+ expect(html).toContain('nested/[foo]/[bar].vue')
+ expect(html).toContain('foo: one')
+ expect(html).toContain('bar: two')
+ })
+
+ it('/nested/[foo]/index.vue', async () => {
+ const html = await $fetch('/nested/foobar')
+
+ // TODO: should resolved to same entry
+ // const html2 = await $fetch('/nested/foobar/index')
+ // expect(html).toEqual(html2)
+
+ // Snapshot
+ // expect(html).toMatchInlineSnapshot()
+
+ expect(html).toContain('nested/[foo]/index.vue')
+ expect(html).toContain('foo: foobar')
+
+ await expectNoClientErrors('/nested/foobar')
+ })
+
+ it('/nested/[foo]/user-[group].vue', async () => {
+ const html = await $fetch('/nested/foobar/user-admin')
+
+ // Snapshot
+ // expect(html).toMatchInlineSnapshot()
+
+ expect(html).toContain('nested/[foo]/user-[group].vue')
+ expect(html).toContain('foo: foobar')
+ expect(html).toContain('group: admin')
+
+ await expectNoClientErrors('/nested/foobar/user-admin')
+ })
+
+ it('/parent', async () => {
+ const html = await $fetch('/parent')
+ expect(html).toContain('parent/index')
+
+ await expectNoClientErrors('/parent')
+ })
+
+ it('/another-parent', async () => {
+ const html = await $fetch('/another-parent')
+ expect(html).toContain('another-parent/index')
+
+ await expectNoClientErrors('/another-parent')
+ })
+
+ it('/client-server', async () => {
+ // expect no hydration issues
+ await expectNoClientErrors('/client-server')
+ const { page } = await renderPage('/client-server')
+ const bodyHTML = await page.innerHTML('body')
+ expect(await page.locator('.placeholder-to-ensure-no-override').all()).toHaveLength(5)
+ expect(await page.locator('.server').all()).toHaveLength(0)
+ expect(await page.locator('.client-fragment-server.client').all()).toHaveLength(2)
+ expect(await page.locator('.client-fragment-server-fragment.client').all()).toHaveLength(2)
+ expect(await page.locator('.client-server.client').all()).toHaveLength(1)
+ expect(await page.locator('.client-server-fragment.client').all()).toHaveLength(1)
+ expect(await page.locator('.client-server-fragment.client').all()).toHaveLength(1)
+
+ expect(bodyHTML).not.toContain('hello')
+ expect(bodyHTML).toContain('world')
+ await page.close()
+ })
+
+ it('/client-only-components', async () => {
+ const html = await $fetch('/client-only-components')
+ expect(html).toContain('Fallback
')
+ // ensure components are not rendered server-side
+ expect(html).not.toContain('Should not be server rendered')
+
+ const { page, pageErrors } = await renderPage('/client-only-components')
+
+ const hiddenSelectors = [
+ '.string-stateful-should-be-hidden',
+ '.client-script-should-be-hidden',
+ '.string-stateful-script-should-be-hidden',
+ '.no-state-hidden',
+ ]
+ const visibleSelectors = [
+ '.string-stateful',
+ '.string-stateful-script',
+ '.client-only-script',
+ '.client-only-script-setup',
+ '.no-state',
+ ]
+
+ // ensure directives are correctly applied
+ await Promise.all(hiddenSelectors.map(selector => page.locator(selector).isHidden()))
+ .then(results => results.forEach(isHidden => expect(isHidden).toBeTruthy()))
+ // ensure hidden components are still rendered
+ await Promise.all(hiddenSelectors.map(selector => page.locator(selector).innerHTML()))
+ .then(results => results.forEach(innerHTML => expect(innerHTML).not.toBe('')))
+
+ // ensure single root node components are rendered once on client (should not be empty)
+ await Promise.all(visibleSelectors.map(selector => page.locator(selector).innerHTML()))
+ .then(results => results.forEach(innerHTML => expect(innerHTML).not.toBe('')))
+
+ // issue #20061
+ expect(await page.$eval('.client-only-script-setup', e => getComputedStyle(e).backgroundColor)).toBe('rgb(255, 0, 0)')
+
+ // ensure multi-root-node is correctly rendered
+ expect(await page.locator('.multi-root-node-count').innerHTML()).toContain('0')
+ expect(await page.locator('.multi-root-node-button').innerHTML()).toContain('add 1 to count')
+ expect(await page.locator('.multi-root-node-script-count').innerHTML()).toContain('0')
+ expect(await page.locator('.multi-root-node-script-button').innerHTML()).toContain('add 1 to count')
+
+ // ensure components reactivity
+ await page.locator('.multi-root-node-button').click()
+ await page.locator('.multi-root-node-script-button').click()
+ await page.locator('.client-only-script button').click()
+ await page.locator('.client-only-script-setup button').click()
+
+ expect(await page.locator('.multi-root-node-count').innerHTML()).toContain('1')
+ expect(await page.locator('.multi-root-node-script-count').innerHTML()).toContain('1')
+ expect(await page.locator('.client-only-script-setup button').innerHTML()).toContain('1')
+ expect(await page.locator('.client-only-script button').innerHTML()).toContain('1')
+
+ // ensure components ref is working and reactive
+ await page.locator('button.test-ref-1').click()
+ await page.locator('button.test-ref-2').click()
+ await page.locator('button.test-ref-3').click()
+ await page.locator('button.test-ref-4').click()
+ expect(await page.locator('.client-only-script-setup button').innerHTML()).toContain('2')
+ expect(await page.locator('.client-only-script button').innerHTML()).toContain('2')
+ expect(await page.locator('.string-stateful-script').innerHTML()).toContain('1')
+ expect(await page.locator('.string-stateful').innerHTML()).toContain('1')
+ const waitForConsoleLog = page.waitForEvent('console', consoleLog => consoleLog.text() === 'has $el')
+
+ // ensure directives are reactive
+ await page.locator('button#show-all').click()
+ await Promise.all(hiddenSelectors.map(selector => page.locator(selector).isVisible()))
+ .then(results => results.forEach(isVisible => expect(isVisible).toBeTruthy()))
+
+ await waitForConsoleLog
+ expect(pageErrors).toEqual([])
+ await page.close()
+ // don't expect any errors or warning on client-side navigation
+ const { page: page2, consoleLogs: consoleLogs2 } = await renderPage('/')
+ await page2.locator('#to-client-only-components').click()
+ await page2.waitForFunction(path => window.useNuxtApp?.()._route.fullPath === path, '/client-only-components')
+ expect(consoleLogs2.some(log => log.type === 'error' || log.type === 'warning')).toBeFalsy()
+ await page2.close()
+ })
+
+ it('/wrapper-expose/layout', async () => {
+ const { page, consoleLogs, pageErrors } = await renderPage('/wrapper-expose/layout')
+ await page.locator('.log-foo').first().click()
+ expect(pageErrors.at(-1)?.toString() || consoleLogs.at(-1)!.text).toContain('.logFoo is not a function')
+ await page.locator('.log-hello').first().click()
+ expect(consoleLogs.at(-1)!.text).toContain('world')
+ await page.locator('.add-count').first().click()
+ expect(await page.locator('.count').first().innerText()).toContain('1')
+
+ // change layout
+ await page.locator('.swap-layout').click()
+ await page.waitForFunction(() => document.querySelector('.count')?.innerHTML.includes('0'))
+ await page.locator('.log-foo').first().click()
+ expect(consoleLogs.at(-1)!.text).toContain('bar')
+ await page.locator('.log-hello').first().click()
+ expect(pageErrors.at(-1)?.toString() || consoleLogs.at(-1)!.text).toContain('.logHello is not a function')
+ await page.locator('.add-count').first().click()
+ await page.waitForFunction(() => document.querySelector('.count')?.innerHTML.includes('1'))
+ // change layout
+ await page.locator('.swap-layout').click()
+ await page.waitForFunction(() => document.querySelector('.count')?.innerHTML.includes('0'))
+ await page.close()
+ })
+
+ it('/client-only-explicit-import', async () => {
+ const html = await $fetch('/client-only-explicit-import')
+
+ // ensure components are not rendered server-side
+ expect(html).not.toContain('client only script')
+ await expectNoClientErrors('/client-only-explicit-import')
+ })
+
+ it('/wrapper-expose/page', async () => {
+ const { page, pageErrors, consoleLogs } = await renderPage('/wrapper-expose/page')
+ await page.waitForLoadState('networkidle')
+ await page.locator('#log-foo').click()
+ expect(consoleLogs.at(-1)?.text).toBe('bar')
+ // change page
+ await page.locator('#to-hello').click()
+ await page.locator('#log-foo').click()
+ expect(pageErrors.at(-1)?.toString() || consoleLogs.at(-1)!.text).toContain('.foo is not a function')
+ await page.locator('#log-hello').click()
+ expect(consoleLogs.at(-1)?.text).toBe('world')
+ await page.close()
+ })
+
+ it('client-fallback', async () => {
+ const classes = [
+ 'clientfallback-non-stateful-setup',
+ 'clientfallback-non-stateful',
+ 'clientfallback-stateful-setup',
+ 'clientfallback-stateful',
+ 'clientfallback-async-setup',
+ ]
+ const html = await $fetch('/client-fallback')
+ // ensure failed components are not rendered server-side
+ expect(html).not.toContain('This breaks in server-side setup.')
+ classes.forEach(c => expect(html).not.toContain(c))
+ // ensure not failed component not be rendered
+ expect(html).not.toContain('Sugar Counter 12 x 0 = 0')
+ // ensure NuxtClientFallback is being rendered with its fallback tag and attributes
+ expect(html).toContain('this failed to render ')
+ // ensure Fallback slot is being rendered server side
+ expect(html).toContain('Hello world !')
+ // ensure fallback is rendered when an async component throws inside a wrapping component
+ // (regression test for nested promises in the SSR buffer not being awaited)
+ expect(html).toContain('Nested async fallback rendered')
+ expect(html).not.toContain('break-in-async-setup-wrapper')
+
+ // ensure not failed component are correctly rendered
+ expect(html).not.toContain('
')
+ expect(html).toContain('hi')
+
+ // async setup
+ expect(html).toContain('Work with async setup')
+
+ const { page, pageErrors } = await renderPage('/client-fallback')
+ // ensure components reactivity once mounted
+ await page.locator('#increment-count').click()
+ expect(await page.locator('#sugar-counter').innerHTML()).toContain('Sugar Counter 12 x 1 = 12')
+ // keep-fallback strategy
+ expect(await page.locator('#keep-fallback').all()).toHaveLength(1)
+ // #20833
+ expect(await page.locator('body').innerHTML()).not.toContain('Hello world !')
+ expect(pageErrors).toEqual([])
+ await page.close()
+ })
+
+ it('/legacy-async-data-fail', async () => {
+ const response = await fetch('/legacy-async-data-fail').then(r => r.text())
+ expect(response).not.toContain('don\'t look at this')
+ expect(response).toContain('OH NNNNNNOOOOOOOOOOO')
+ })
+
+ it('client only page', async () => {
+ const response = await fetch('/client-only-page').then(r => r.text())
+
+ // Should not contain rendered page on initial request
+ expect(response).not.toContain('"hasAccessToWindow": true')
+ expect(response).not.toContain('"isServer": false')
+
+ const errors: string[] = []
+ const { page: clientInitialPage } = await renderPage('/client-only-page')
+
+ clientInitialPage.on('console', (message) => {
+ const type = message.type()
+ if (type === 'error' || type === 'warning') {
+ errors.push(message.text())
+ }
+ })
+
+ // But after hydration element should appear and contain this object
+ expect(await clientInitialPage.locator('#state').textContent()).toMatchInlineSnapshot(`
+ "{
+ "hasAccessToWindow": true,
+ "isServer": false
+ }"
+ `)
+
+ expect(await clientInitialPage.locator('#server-rendered').textContent()).toMatchInlineSnapshot('"false"')
+
+ // Then go to non client only page
+ await clientInitialPage.click('a')
+ await clientInitialPage.waitForFunction(() => window.useNuxtApp?.()._route.fullPath === '/client-only-page/normal')
+
+ // that page should be client rendered
+ expect(await clientInitialPage.locator('#server-rendered').textContent()).toMatchInlineSnapshot('"false"')
+ // and not contain any errors or warnings
+ expect(errors.length).toBe(0)
+
+ await clientInitialPage.close()
+ errors.length = 0
+
+ const { page: normalInitialPage } = await renderPage('/client-only-page/normal')
+
+ normalInitialPage.on('console', (message) => {
+ const type = message.type()
+ if (type === 'error' || type === 'warning') {
+ errors.push(message.text())
+ }
+ })
+
+ // Now non client only page should be sever rendered
+ expect(await normalInitialPage.locator('#server-rendered').textContent()).toMatchInlineSnapshot('"true"')
+
+ // Go to client only page
+ await normalInitialPage.click('a')
+
+ await normalInitialPage.waitForFunction(() => window.useNuxtApp?.()._route.fullPath === '/client-only-page')
+
+ // and expect same object to be present
+ expect(await normalInitialPage.locator('#state').textContent()).toMatchInlineSnapshot(`
+ "{
+ "hasAccessToWindow": true,
+ "isServer": false
+ }"
+ `)
+
+ // also there should not be any errors
+ expect(errors.length).toBe(0)
+
+ await normalInitialPage.close()
+ })
+
+ it('groups routes', async () => {
+ for (const targetRoute of ['/group-page', '/nested-group/group-page', '/nested-group']) {
+ const { status } = await fetch(targetRoute)
+
+ expect(status).toBe(200)
+ }
+ })
+
+ it.skipIf(isDev)('prerenders pages hinted with a route rule', async () => {
+ const html = await $fetch('/prerender/test')
+ expect(html).toContain('should be prerendered: true')
+ })
+
+ it('renders pages with special characters in route', async () => {
+ const html = await $fetch('/non-ascii/ç')
+ // Verify page renders successfully with layout
+ expect(html).toContain('Extended layout from foo')
+ })
+
+ it.skipIf(isDev)('prerenders pages with special characters', async () => {
+ const html = await $fetch('/prerender/ç')
+ expect(html).toContain('should be prerendered: true')
+ })
+
+ // https://github.com/nuxt/nuxt/issues/33871
+ it.skipIf(isDev)('prerenders pages whose middleware calls useFetch against the same URL', async () => {
+ const html = await $fetch('/prerender/loop-self')
+ expect(html).toContain('loop-self ok')
+ })
+
+ // https://github.com/nuxt/nuxt/issues/33871
+ it.skipIf(isDev)('prerenders parallel pages whose middleware shares a useFetch key against an unhandled URL', async () => {
+ const [a, b] = await Promise.all([
+ $fetch('/prerender/loop-shared-a'),
+ $fetch('/prerender/loop-shared-b'),
+ ])
+ expect(a).toContain('loop-shared-a ok')
+ expect(b).toContain('loop-shared-b ok')
+ })
+
+ // https://github.com/nuxt/nuxt/issues/33871 - bare $fetch path (no useFetch / shared cache).
+ it.skipIf(isDev)('prerenders pages whose middleware calls $fetch against the same URL', async () => {
+ const html = await $fetch('/prerender/loop-bare-fetch')
+ expect(html).toContain('loop-bare-fetch ok')
+ })
+
+ it('renders unicode routes correctly', async () => {
+ const html = await $fetch('/random/日本語')
+ expect(html).toContain('Japanese random route')
+ })
+
+ it.skipIf(isDev)('reactive query params in prerendered pages', async () => {
+ const { page } = await renderPage('/prerender/query-reactivity?active=true')
+
+ expect(await page.innerText('div')).toContain('true')
+ await page.waitForFunction(() => window.useNuxtApp?.()._route.query.active === 'true')
+ expect(await page.evaluate(() => window.useNuxtApp?.()._route.query.active)).toBe('true')
+ expect(await page.$eval('div', e => getComputedStyle(e).color)).toBe('rgb(255, 0, 0)')
+
+ await page.close()
+ })
+
+ it('should trigger page:loading:end only once', async () => {
+ const { page, consoleLogs } = await renderPage('/')
+
+ await page.getByText('to page load hook').click()
+ await page.waitForFunction(path => window.useNuxtApp?.()._route.fullPath === path, '/page-load-hook')
+ const loadingEndLogs = consoleLogs.filter(c => c.text.includes('page:loading:end'))
+ expect(loadingEndLogs.length).toBe(1)
+
+ await page.close()
+ })
+
+ it('should hide nuxt page load indicator after navigate back from nested page', async () => {
+ const LOAD_INDICATOR_SELECTOR = '.nuxt-loading-indicator'
+ const { page } = await renderPage('/page-load-hook')
+ await page.getByText('To sub page').click()
+ await page.waitForFunction(path => window.useNuxtApp?.()._route.fullPath === path, '/page-load-hook/subpage')
+
+ await page.waitForSelector(LOAD_INDICATOR_SELECTOR)
+ let isVisible = await page.isVisible(LOAD_INDICATOR_SELECTOR)
+ expect(isVisible).toBe(true)
+
+ await page.waitForSelector(LOAD_INDICATOR_SELECTOR, { state: 'hidden' })
+ isVisible = await page.isVisible(LOAD_INDICATOR_SELECTOR)
+ expect(isVisible).toBe(false)
+
+ await page.goBack()
+
+ await page.waitForSelector(LOAD_INDICATOR_SELECTOR)
+ isVisible = await page.isVisible(LOAD_INDICATOR_SELECTOR)
+ expect(isVisible).toBe(true)
+
+ await page.waitForSelector(LOAD_INDICATOR_SELECTOR, { state: 'hidden' })
+ isVisible = await page.isVisible(LOAD_INDICATOR_SELECTOR)
+ expect(isVisible).toBe(false)
+
+ await page.close()
+ })
+})
+
+describe('nuxt composables', () => {
+ it('has useRequestURL()', async () => {
+ const html = await $fetch('/url')
+ expect(html).toContain('path: /url')
+ })
+ it('sets cookies correctly', async () => {
+ const res = await fetch('/cookies', {
+ headers: {
+ cookie: Object.entries({
+ 'browser-accessed-but-not-used': 'provided-by-browser',
+ 'browser-accessed-with-default-value': 'provided-by-browser',
+ 'browser-set': 'provided-by-browser',
+ 'browser-set-to-null': 'provided-by-browser',
+ 'browser-set-to-null-with-default': 'provided-by-browser',
+ }).map(([key, value]) => `${key}=${value}`).join('; '),
+ },
+ })
+ const cookies = res.headers.get('set-cookie')
+ expect(cookies).toMatchInlineSnapshot('"set-in-plugin=%22true%22; Path=/, accessed-with-default-value=default; Path=/, set=set; Path=/, browser-set=set; Path=/, browser-set-to-null=; Max-Age=0; Path=/, browser-set-to-null-with-default=; Max-Age=0; Path=/, browser-object-default=%7B%22foo%22%3A%22bar%22%7D; Path=/, theCookie=show; Path=/"')
+ })
+ it('updates cookies when they are changed', async () => {
+ const { page } = await renderPage('/cookies')
+ async function extractCookie () {
+ const cookie = await page.evaluate(() => document.cookie)
+ const raw = cookie.match(/browser-object-default=([^;]*)/)![1] ?? 'null'
+ return JSON.parse(decodeURIComponent(raw))
+ }
+ expect(await extractCookie()).toEqual({ foo: 'bar' })
+ await page.getByText('Change cookie').click()
+ expect(await extractCookie()).toEqual({ foo: 'baz' })
+ let text = await page.innerText('pre')
+ expect(text).toContain('baz')
+ await page.getByText('Change cookie').click()
+ expect(await extractCookie()).toEqual({ foo: 'bar' })
+ await page.evaluate(() => { document.cookie = `browser-object-default=${encodeURIComponent('{"foo":"foobar"}')}` })
+ await page.getByText('Refresh cookie').click()
+ text = await page.innerText('pre')
+ expect(text).toContain('foobar')
+ await page.close()
+ })
+
+ it('sets cookies in composable to null in all components', async () => {
+ const { page } = await renderPage('/cookies')
+ const parentBannerText = await page.locator('#parent-banner').textContent()
+ expect(parentBannerText).toContain('parent banner')
+
+ const childBannerText = await page.locator('#child-banner').innerText()
+ expect(childBannerText).toContain('child banner')
+
+ // Clear the composable cookie
+ await page.getByText('Toggle cookie banner').click()
+ await page.evaluate(() => new Promise(resolve => setTimeout(resolve, 10)))
+
+ const parentBannerAfterToggle = await page.locator('#parent-banner').isVisible()
+ expect(parentBannerAfterToggle).toBe(false)
+
+ const childBannerAfterToggle = await page.locator('#child-banner').isVisible()
+ expect(childBannerAfterToggle).toBe(false)
+ await page.close()
+ })
+
+ it('re-sets cookie on SSR when refresh is true and value is explicitly written', async () => {
+ const res = await fetch('/cookies-refresh', {
+ headers: {
+ cookie: 'refresh-with-write=existing; refresh-without-write=existing; no-refresh-with-write=existing',
+ },
+ })
+ const cookies = res.headers.get('set-cookie') ?? ''
+
+ // refresh: true with explicit write — should re-set the cookie
+ expect(cookies).toContain('refresh-with-write=existing')
+
+ // refresh: true without explicit write — should NOT re-set the cookie
+ expect(cookies).not.toContain('refresh-without-write')
+
+ // refresh: false with same-value write — should NOT re-set the cookie
+ expect(cookies).not.toContain('no-refresh-with-write')
+ })
+
+ it('supports onPrehydrate', async () => {
+ const html = await $fetch('/composables/on-prehydrate') as string
+ /**
+ * Should look something like this:
+ *
+ * ```html
+ * onPrehydrate testing
+ *
+ *
+ *
+ * ```
+ */
+ const { id1, id2 } = html.match(/]* data-prehydrate-id=":(?[^:]+)::(?[^:]+):"> onPrehydrate testing <\/div>/)?.groups || {}
+ expect(id1).toBeTruthy()
+ const matches = [
+ html.match(/]*>\(\(\)=>\{console.log\(window\)\}\)\(\)<\/script>/),
+ html.match(new RegExp(`]*>document.querySelectorAll\\('\\[data-prehydrate-id\\*=":${id1}:"]'\\).forEach\\(e=>{console.log\\(e.outerHTML\\)}\\)`, 'i')),
+ html.match(new RegExp(`]*>document.querySelectorAll\\('\\[data-prehydrate-id\\*=":${id2}:"]'\\).forEach\\(e=>{console.log\\(\`other\`,e.outerHTML\\)}\\)`, 'i')),
+ ]
+
+ // This tests we inject all scripts correctly, and only have one occurrence of multiple calls of a composable
+ expect(matches.every(s => s?.length === 1)).toBeTruthy()
+
+ // Check for hydration/syntax errors on client side
+ await expectNoClientErrors('/composables/on-prehydrate')
+ })
+
+ it('respects preview mode with a token', async () => {
+ const token = 'hehe'
+ const page = await createPage(`/preview?preview=true&token=${token}`)
+
+ const hasRerunFetchOnClient = await new Promise((resolve) => {
+ page.on('console', (message) => {
+ setTimeout(() => resolve(false), 4000)
+
+ if (message.text() === 'true') { resolve(true) }
+ })
+ })
+
+ expect(hasRerunFetchOnClient).toBe(true)
+
+ expect(await page.locator('#fetched-on-client').textContent()).toContain('fetched on client')
+ expect(await page.locator('#preview-mode').textContent()).toContain('preview mode enabled')
+
+ await page.click('#use-fetch-check')
+ await page.waitForFunction(() => window.useNuxtApp?.()._route.fullPath.includes('/preview/with-use-fetch'))
+
+ expect(await page.locator('#token-check').textContent()).toContain(token)
+ expect(await page.locator('#correct-api-key-check').textContent()).toContain('true')
+ await page.close()
+ })
+
+ it('respects preview mode with custom state', async () => {
+ const { page } = await renderPage('/preview/with-custom-state?preview=true')
+
+ expect(await page.locator('#data1').textContent()).toContain('data1 updated')
+ expect(await page.locator('#data2').textContent()).toContain('data2')
+
+ await page.click('#toggle-preview') // manually turns off preview mode
+ await page.click('#with-use-fetch')
+ await page.waitForFunction(() => window.useNuxtApp?.()._route.fullPath.includes('/preview/with-use-fetch'))
+
+ expect(await page.locator('#enabled').textContent()).toContain('false')
+ expect(await page.locator('#token-check').textContent()).toEqual('')
+ expect(await page.locator('#correct-api-key-check').textContent()).toContain('false')
+ await page.close()
+ })
+
+ it('respects preview mode with custom enable', async () => {
+ const { page } = await renderPage('/preview/with-custom-enable?preview=true')
+
+ expect(await page.locator('#enabled').textContent()).toContain('false')
+ await page.close()
+ })
+
+ it('respects preview mode with custom enable and customPreview', async () => {
+ const { page } = await renderPage('/preview/with-custom-enable?customPreview=true')
+
+ expect(await page.locator('#enabled').textContent()).toContain('true')
+ await page.close()
+ })
+})
+
+describe('rich payloads', () => {
+ it('correctly serializes and revivifies complex types', async () => {
+ const html = await $fetch('/json-payload')
+ for (const test of [
+ 'Date: true',
+ 'BigInt: true',
+ 'Error: true',
+ 'Shallow reactive: true',
+ 'Shallow ref: true',
+ 'Undefined ref: true',
+ 'BigInt ref:',
+ 'Reactive: true',
+ 'Ref: true',
+ 'Recursive objects: true',
+ ]) {
+ expect(html).toContain(test)
+ }
+ })
+})
+
+describe('nuxt links', () => {
+ it('handles trailing slashes', async () => {
+ const html = await $fetch('/nuxt-link/trailing-slash')
+ const data: Record = {}
+ for (const selector of ['nuxt-link', 'router-link', 'link-with-trailing-slash', 'link-without-trailing-slash']) {
+ data[selector] = []
+ for (const match of html.matchAll(new RegExp(`href="([^"]*)"[^>]*class="[^"]*\\b${selector}\\b`, 'g'))) {
+ data[selector]!.push(match[1]!)
+ }
+ }
+ expect(data).toMatchInlineSnapshot(`
+ {
+ "link-with-trailing-slash": [
+ "/",
+ "/nuxt-link/trailing-slash/",
+ "/nuxt-link/trailing-slash/",
+ "/nuxt-link/trailing-slash/?test=true&thing=other/thing#thing-other",
+ "/nuxt-link/trailing-slash/?test=true&thing=other/thing#thing-other",
+ "/nuxt-link/trailing-slash/",
+ "/nuxt-link/trailing-slash/?with-state=true",
+ "/nuxt-link/trailing-slash/?without-state=true",
+ ],
+ "link-without-trailing-slash": [
+ "/",
+ "/nuxt-link/trailing-slash",
+ "/nuxt-link/trailing-slash",
+ "/nuxt-link/trailing-slash?test=true&thing=other/thing#thing-other",
+ "/nuxt-link/trailing-slash?test=true&thing=other/thing#thing-other",
+ "/nuxt-link/trailing-slash",
+ "/nuxt-link/trailing-slash?with-state=true",
+ "/nuxt-link/trailing-slash?without-state=true",
+ ],
+ "nuxt-link": [
+ "/",
+ "/nuxt-link/trailing-slash",
+ "/nuxt-link/trailing-slash/",
+ "/nuxt-link/trailing-slash?test=true&thing=other/thing#thing-other",
+ "/nuxt-link/trailing-slash/?test=true&thing=other/thing#thing-other",
+ "/nuxt-link/trailing-slash",
+ "/nuxt-link/trailing-slash?with-state=true",
+ "/nuxt-link/trailing-slash?without-state=true",
+ ],
+ "router-link": [
+ "/",
+ "/nuxt-link/trailing-slash",
+ "/nuxt-link/trailing-slash/",
+ "/nuxt-link/trailing-slash?test=true&thing=other/thing#thing-other",
+ "/nuxt-link/trailing-slash/?test=true&thing=other/thing#thing-other",
+ "/nuxt-link/trailing-slash",
+ "/nuxt-link/trailing-slash?with-state=true",
+ "/nuxt-link/trailing-slash?without-state=true",
+ ],
+ }
+ `)
+ })
+
+ it('respects external links in edge cases', async () => {
+ const html = await $fetch('/nuxt-link/custom-external')
+ const hrefs = html.match(/]*href="[^"]+"/g)
+ expect(hrefs).toMatchInlineSnapshot(`
+ [
+ " c.text.includes('No match found for location'))
+ expect(warnings).toMatchInlineSnapshot(`[]`)
+ await page.close()
+ })
+
+ it('preserves route state', async () => {
+ const { page } = await renderPage('/nuxt-link/trailing-slash')
+
+ for (const selector of ['nuxt-link', 'router-link', 'link-with-trailing-slash', 'link-without-trailing-slash']) {
+ await page.locator(`.${selector}[href*=with-state]`).click()
+ await page.getByTestId('window-state').getByText('bar').waitFor()
+
+ await page.locator(`.${selector}[href*=without-state]`).click()
+ await page.waitForFunction(() => window.useNuxtApp?.()._route.fullPath.includes('without-state'))
+ expect(await page.getByTestId('window-state').innerText()).not.toContain('bar')
+ }
+
+ await page.close()
+ })
+
+ it('expect scroll to top on routes with same component', async () => {
+ // #22402
+ const page = await createPage('/big-page-1', {
+ viewport: {
+ width: 1000,
+ height: 1000,
+ },
+ })
+ await page.waitForFunction(() => window.useNuxtApp?.()._route.fullPath === '/big-page-1')
+
+ await page.locator('#big-page-2').scrollIntoViewIfNeeded()
+ await page.waitForFunction(() => window.scrollY > 0)
+ await page.locator('#big-page-2').click()
+ await page.waitForFunction(path => window.useNuxtApp?.()._route.fullPath === path, '/big-page-2')
+ await page.waitForFunction(() => window.scrollY === 0)
+
+ await page.locator('#big-page-1').scrollIntoViewIfNeeded()
+ await page.waitForFunction(() => window.scrollY > 0)
+ await page.locator('#big-page-1').click()
+ await page.waitForFunction(path => window.useNuxtApp?.()._route.fullPath === path, '/big-page-1')
+ await page.waitForFunction(() => window.scrollY === 0)
+ await page.close()
+ })
+
+ it('expect scroll to top on nested pages', async () => {
+ // #20523
+ const page = await createPage('/nested/foo/test', {
+ viewport: {
+ width: 1000,
+ height: 1000,
+ },
+ })
+ await page.waitForFunction(path => window.useNuxtApp?.()._route.fullPath === path, '/nested/foo/test')
+
+ await page.locator('#user-test').scrollIntoViewIfNeeded()
+ await page.waitForFunction(() => window.scrollY > 0)
+ await page.locator('#user-test').click()
+ await page.waitForFunction(path => window.useNuxtApp?.()._route.fullPath === path, '/nested/foo/user-test')
+ await page.waitForFunction(() => window.scrollY === 0)
+
+ await page.locator('#test').scrollIntoViewIfNeeded()
+ await page.waitForFunction(() => window.scrollY > 0)
+ await page.locator('#test').click()
+ await page.waitForFunction(path => window.useNuxtApp?.()._route.fullPath === path, '/nested/foo/test')
+ await page.waitForFunction(() => window.scrollY === 0)
+ await page.close()
+ })
+
+ it('useLink works', async () => {
+ const html = await $fetch('/nuxt-link/use-link')
+ expect(html).toContain('useLink in NuxtLink: true
')
+ expect(html).toContain('route using useLink: /nuxt-link/trailing-slash
')
+ expect(html).toContain('href using useLink: /nuxt-link/trailing-slash
')
+ expect(html).toContain('useLink2 in NuxtLink: true
')
+ expect(html).toContain('route2 using useLink: /nuxt-link/trailing-slash
')
+ expect(html).toContain('href2 using useLink: /nuxt-link/trailing-slash
')
+ expect(html).toContain('useLink3 in NuxtLink: true
')
+ expect(html).toContain('route3 using useLink: /nuxt-link/trailing-slash
')
+ expect(html).toContain('href3 using useLink: /nuxt-link/trailing-slash
')
+ })
+ it('useLink navigate importing NuxtLink works', async () => {
+ const page = await createPage('/nuxt-link/use-link')
+ await page.waitForFunction(() => window.useNuxtApp?.()._route.fullPath === '/nuxt-link/use-link')
+
+ await page.locator('#button1').click()
+ await page.waitForFunction(path => window.useNuxtApp?.()._route.fullPath === path, '/nuxt-link/trailing-slash')
+ await page.close()
+ })
+ it('useLink navigate using resolveComponent works', async () => {
+ const page = await createPage('/nuxt-link/use-link')
+ await page.waitForFunction(() => window.useNuxtApp?.()._route.fullPath === '/nuxt-link/use-link')
+
+ await page.locator('#button2').click()
+ await page.waitForFunction(path => window.useNuxtApp?.()._route.fullPath === path, '/nuxt-link/trailing-slash')
+ await page.close()
+ })
+ it('useLink navigate using resolveDynamicComponent works', async () => {
+ const page = await createPage('/nuxt-link/use-link')
+ await page.waitForFunction(() => window.useNuxtApp?.()._route.fullPath === '/nuxt-link/use-link')
+
+ await page.locator('#button3').click()
+ await page.waitForFunction(path => window.useNuxtApp?.()._route.fullPath === path, '/nuxt-link/trailing-slash')
+ await page.close()
+ })
+})
+
+describe('head tags', () => {
+ it('SSR should render tags', async () => {
+ const headHtml = await $fetch('/head')
+
+ expect(headHtml).toContain('Using a dynamic component - Title Template Fn Change ')
+ expect(headHtml).not.toContain(']*class="html-attrs-test"/)
+ expect(headHtml).toMatch(/]*class="body-attrs-test"/)
+
+ const bodyHtml = headHtml.match(/]*>(.*)<\/body>/s)![1]
+ expect(bodyHtml).toContain('')
+
+ const indexHtml = await $fetch('/')
+ // should render charset by default
+ expect(indexHtml).toContain('Basic fixture ')
+ })
+
+ it('SSR script setup should render tags', async () => {
+ const headHtml = await $fetch('/head-script-setup')
+
+ // useHead - title & titleTemplate are working
+ expect(headHtml).toContain('head script setup - Nuxt Playground ')
+ // server-only useSeoMeta - template params
+ expect(headHtml).toContain('
+
+
+
+
diff --git a/examples/hello-world/nuxt.config.js b/test/fixtures/basic-types/app/layouts/PascalCase.ts
similarity index 100%
rename from examples/hello-world/nuxt.config.js
rename to test/fixtures/basic-types/app/layouts/PascalCase.ts
diff --git a/test/fixtures/basic-types/app/layouts/custom.vue b/test/fixtures/basic-types/app/layouts/custom.vue
new file mode 100644
index 000000000000..e7938d8f69d6
--- /dev/null
+++ b/test/fixtures/basic-types/app/layouts/custom.vue
@@ -0,0 +1,6 @@
+
+
+ Custom Layout:
+
+
diff --git a/test/fixtures/basic-types/app/layouts/with-props.vue b/test/fixtures/basic-types/app/layouts/with-props.vue
new file mode 100644
index 000000000000..3b604e2c95d5
--- /dev/null
+++ b/test/fixtures/basic-types/app/layouts/with-props.vue
@@ -0,0 +1,11 @@
+
+
+
+
+
+
diff --git a/test/fixtures/basic-types/app/middleware/global.global.ts b/test/fixtures/basic-types/app/middleware/global.global.ts
new file mode 100644
index 000000000000..a133c7ffefaa
--- /dev/null
+++ b/test/fixtures/basic-types/app/middleware/global.global.ts
@@ -0,0 +1,7 @@
+export default defineNuxtRouteMiddleware((to) => {
+ if ('abort' in to.query) {
+ return abortNavigation({
+ status: 401,
+ })
+ }
+})
diff --git a/test/fixtures/basic-types/app/middleware/named.ts b/test/fixtures/basic-types/app/middleware/named.ts
new file mode 100644
index 000000000000..30801347aefc
--- /dev/null
+++ b/test/fixtures/basic-types/app/middleware/named.ts
@@ -0,0 +1,3 @@
+export default defineNuxtRouteMiddleware((to) => {
+ to.meta.auth = 'Injected by injectAuth middleware'
+})
diff --git a/test/fixtures/basic-types/app/pages/custom-name.vue b/test/fixtures/basic-types/app/pages/custom-name.vue
new file mode 100644
index 000000000000..f196c93c236a
--- /dev/null
+++ b/test/fixtures/basic-types/app/pages/custom-name.vue
@@ -0,0 +1,15 @@
+
+
+
+
+
+
+
diff --git a/test/fixtures/basic-types/app/pages/page.vue b/test/fixtures/basic-types/app/pages/page.vue
new file mode 100644
index 000000000000..41b642051a2c
--- /dev/null
+++ b/test/fixtures/basic-types/app/pages/page.vue
@@ -0,0 +1,5 @@
+
+
+
+
+
diff --git a/test/fixtures/basic-types/app/pages/param.vue b/test/fixtures/basic-types/app/pages/param.vue
new file mode 100644
index 000000000000..41b642051a2c
--- /dev/null
+++ b/test/fixtures/basic-types/app/pages/param.vue
@@ -0,0 +1,5 @@
+
+
+
+
+
diff --git a/test/fixtures/basic-types/app/pages/param/[id].vue b/test/fixtures/basic-types/app/pages/param/[id].vue
new file mode 100644
index 000000000000..2b1be0907419
--- /dev/null
+++ b/test/fixtures/basic-types/app/pages/param/[id].vue
@@ -0,0 +1,5 @@
+
+
+
+
diff --git a/test/fixtures/basic-types/app/pages/param/[id]/view.vue b/test/fixtures/basic-types/app/pages/param/[id]/view.vue
new file mode 100644
index 000000000000..c8c9a98f2bda
--- /dev/null
+++ b/test/fixtures/basic-types/app/pages/param/[id]/view.vue
@@ -0,0 +1,13 @@
+
+
+
+
+
+
+
diff --git a/test/fixtures/basic-types/app/pages/param/index.vue b/test/fixtures/basic-types/app/pages/param/index.vue
new file mode 100644
index 000000000000..82dddbe38d9f
--- /dev/null
+++ b/test/fixtures/basic-types/app/pages/param/index.vue
@@ -0,0 +1,12 @@
+
+
+
+
+
+
+
diff --git a/test/fixtures/basic-types/app/plugins/injection.ts b/test/fixtures/basic-types/app/plugins/injection.ts
new file mode 100644
index 000000000000..4310ebd9989e
--- /dev/null
+++ b/test/fixtures/basic-types/app/plugins/injection.ts
@@ -0,0 +1,7 @@
+export default defineNuxtPlugin(() => {
+ return {
+ provide: {
+ pluginInjection: () => '',
+ },
+ }
+})
diff --git a/test/fixtures/basic-types/config-types.ts b/test/fixtures/basic-types/config-types.ts
new file mode 100644
index 000000000000..45e8e5e82db0
--- /dev/null
+++ b/test/fixtures/basic-types/config-types.ts
@@ -0,0 +1,148 @@
+import { describe, expectTypeOf, it } from 'vitest'
+
+import type { AppConfig, RuntimeValue, UpperSnakeCase } from 'nuxt/schema'
+import { defineNuxtModule } from 'nuxt/kit'
+import { defineNuxtConfig } from 'nuxt/config'
+
+describe('modules', () => {
+ it('augments schema automatically', () => {
+ defineNuxtConfig({ sampleModule: { enabled: false } })
+ // @ts-expect-error we want to ensure we throw type error on invalid option
+ defineNuxtConfig({ sampleModule: { other: false } })
+ // @ts-expect-error we want to ensure we throw type error on invalid key
+ defineNuxtConfig({ undeclaredKey: { other: false } })
+ })
+
+ it('preserves options in defineNuxtModule setup without `.with()`', () => {
+ defineNuxtModule<{ foo?: string, baz: number }>({
+ defaults: {
+ baz: 100,
+ },
+ setup: (resolvedOptions) => {
+ expectTypeOf(resolvedOptions).toEqualTypeOf<{ foo?: string, baz: number }>()
+ },
+ })
+ })
+
+ it('correctly typed resolved options in defineNuxtModule setup using `.with()`', () => {
+ defineNuxtModule<{
+ foo?: string
+ baz: number
+ }>().with({
+ defaults: {
+ foo: 'bar',
+ },
+ setup: (resolvedOptions) => {
+ expectTypeOf(resolvedOptions).toEqualTypeOf<{
+ foo: string
+ baz?: number | undefined
+ }>()
+ },
+ })
+ })
+
+ it('correctly types moduleDependencies', () => {
+ defineNuxtModule({
+ moduleDependencies: {
+ 'unknown': {
+ overrides: {
+ foo: 'bar',
+ },
+ },
+ // TODO: add back when we reenable @nuxt/devtools
+ // '@nuxt/devtools': {
+ // defaults: {
+ // enabled: true,
+ // // @ts-expect-error not a valid option
+ // foo: 'bar',
+ // },
+ // },
+ },
+ })
+ })
+})
+
+describe('runtimeConfig', () => {
+ it('provides hints on overriding these values', () => {
+ const val = defineNuxtConfig({
+ runtimeConfig: {
+ public: {
+ // @ts-expect-error this should be a number
+ testConfig: 'test',
+ ids: [1, 2],
+ },
+ },
+ })
+ expectTypeOf(val.runtimeConfig!.public!.testConfig).toEqualTypeOf>()
+ expectTypeOf(val.runtimeConfig!.privateConfig).toEqualTypeOf>()
+ expectTypeOf(val.runtimeConfig!.baseURL).toEqualTypeOf>()
+ expectTypeOf(val.runtimeConfig!.baseAPIToken).toEqualTypeOf>()
+ expectTypeOf(val.runtimeConfig!.public!.ids).toEqualTypeOf>()
+ expectTypeOf(val.runtimeConfig!.unknown).toEqualTypeOf()
+ })
+
+ it('correctly converts different kinds of names to snake case', () => {
+ expectTypeOf>().toEqualTypeOf<'TEST_APP_NAME'>()
+ expectTypeOf>().toEqualTypeOf<'TEST_APP_NAME'>()
+ expectTypeOf>().toEqualTypeOf<'TEST_APP_NAME'>()
+ expectTypeOf>().toEqualTypeOf<'TEST_APP_NAME'>()
+ expectTypeOf>().toEqualTypeOf<'TEST_APP_NAME'>()
+ expectTypeOf>().toEqualTypeOf<'TEST_APP123NAME'>()
+ expectTypeOf>().toEqualTypeOf<'TEST_APP_NAME'>()
+ expectTypeOf>().toEqualTypeOf<'TEST_APP_NAME'>()
+ expectTypeOf>().toEqualTypeOf<'TEST_APP_NAME'>()
+ expectTypeOf>().toEqualTypeOf<'TEST_APP_NAME'>()
+ expectTypeOf>().toEqualTypeOf<'T'>()
+ expectTypeOf>().toEqualTypeOf<'T'>()
+ })
+})
+
+describe('head', () => {
+ it('correctly types nuxt.config options', () => {
+ // @ts-expect-error invalid head option
+ defineNuxtConfig({ app: { head: { titleTemplate: () => 'test' } } })
+ defineNuxtConfig({
+ app: {
+ head: {
+ meta: [{ key: 'key', name: 'description', content: 'some description ' }],
+ titleTemplate: 'test %s',
+ },
+ },
+ })
+ })
+})
+
+describe('app config', () => {
+ it('merges app config as expected', () => {
+ interface ExpectedMergedAppConfig {
+ // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ nuxt: {}
+ fromLayer: boolean
+ fromNuxtConfig: boolean
+ nested: {
+ val: number
+ }
+ userConfig: 123 | 456
+ someThing?: {
+ value?: string | false
+ }
+ [key: string]: unknown
+ }
+ expectTypeOf().toEqualTypeOf()
+ })
+})
+
+describe('extends type declarations', () => {
+ it('correctly adds references to tsconfig', () => {
+ expectTypeOf().toEqualTypeOf<{ foo: 'bar' }>()
+ })
+})
+
+describe('kit utilities', () => {
+ it('addTypeTemplate', () => {
+ // @ts-expect-error Fromage is 'cheese'
+ const _fake: Fromage = 'babybel'
+
+ const _fromage: Fromage = 'cheese'
+ })
+})
diff --git a/test/fixtures/basic-types/extends/bar/app.config.ts b/test/fixtures/basic-types/extends/bar/app.config.ts
new file mode 100644
index 000000000000..e6007cc55417
--- /dev/null
+++ b/test/fixtures/basic-types/extends/bar/app.config.ts
@@ -0,0 +1,3 @@
+export default {
+ fromLayer: true,
+}
diff --git a/test/fixtures/basic-types/extends/bar/index.d.ts b/test/fixtures/basic-types/extends/bar/index.d.ts
new file mode 100644
index 000000000000..3d1121c5447b
--- /dev/null
+++ b/test/fixtures/basic-types/extends/bar/index.d.ts
@@ -0,0 +1,5 @@
+declare module 'bing' {
+ interface BingInterface {
+ foo: 'bar'
+ }
+}
diff --git a/test/fixtures/basic-types/extends/bar/layouts/override.vue b/test/fixtures/basic-types/extends/bar/layouts/override.vue
new file mode 100644
index 000000000000..7397c7ad6326
--- /dev/null
+++ b/test/fixtures/basic-types/extends/bar/layouts/override.vue
@@ -0,0 +1,6 @@
+
+
+
Extended layout from bar
+
+
diff --git a/test/fixtures/basic-types/extends/bar/middleware/override.ts b/test/fixtures/basic-types/extends/bar/middleware/override.ts
new file mode 100644
index 000000000000..00edf7812469
--- /dev/null
+++ b/test/fixtures/basic-types/extends/bar/middleware/override.ts
@@ -0,0 +1,3 @@
+export default defineNuxtRouteMiddleware((to) => {
+ to.meta.override = 'Injected by extended middleware from bar'
+})
diff --git a/test/fixtures/basic-types/extends/bar/nuxt.config.ts b/test/fixtures/basic-types/extends/bar/nuxt.config.ts
new file mode 100644
index 000000000000..268da7f8c110
--- /dev/null
+++ b/test/fixtures/basic-types/extends/bar/nuxt.config.ts
@@ -0,0 +1 @@
+export default defineNuxtConfig({})
diff --git a/test/fixtures/basic-types/extends/bar/pages/override.vue b/test/fixtures/basic-types/extends/bar/pages/override.vue
new file mode 100644
index 000000000000..bc578faa9090
--- /dev/null
+++ b/test/fixtures/basic-types/extends/bar/pages/override.vue
@@ -0,0 +1,14 @@
+
+
+
+
+
Extended page from bar
+
Middleware | override: {{ $route.meta.override }}
+
+
diff --git a/test/fixtures/basic-types/extends/node_modules/foo/layouts/default.vue b/test/fixtures/basic-types/extends/node_modules/foo/layouts/default.vue
new file mode 100644
index 000000000000..16278621894d
--- /dev/null
+++ b/test/fixtures/basic-types/extends/node_modules/foo/layouts/default.vue
@@ -0,0 +1,6 @@
+
+
+
Extended layout from foo
+
+
diff --git a/test/fixtures/basic-types/extends/node_modules/foo/layouts/override.vue b/test/fixtures/basic-types/extends/node_modules/foo/layouts/override.vue
new file mode 100644
index 000000000000..64753c4e0ad1
--- /dev/null
+++ b/test/fixtures/basic-types/extends/node_modules/foo/layouts/override.vue
@@ -0,0 +1,3 @@
+
+ This layout should be overridden by bar
+
diff --git a/test/fixtures/basic-types/extends/node_modules/foo/middleware/foo.ts b/test/fixtures/basic-types/extends/node_modules/foo/middleware/foo.ts
new file mode 100644
index 000000000000..53963c77032a
--- /dev/null
+++ b/test/fixtures/basic-types/extends/node_modules/foo/middleware/foo.ts
@@ -0,0 +1,3 @@
+export default defineNuxtRouteMiddleware((to) => {
+ to.meta.foo = 'Injected by extended middleware from foo'
+})
diff --git a/test/fixtures/basic-types/extends/node_modules/foo/middleware/override.ts b/test/fixtures/basic-types/extends/node_modules/foo/middleware/override.ts
new file mode 100644
index 000000000000..eca4b646c347
--- /dev/null
+++ b/test/fixtures/basic-types/extends/node_modules/foo/middleware/override.ts
@@ -0,0 +1,3 @@
+export default defineNuxtRouteMiddleware((to) => {
+ to.meta.override = 'This middleware should be overridden by bar'
+})
diff --git a/test/fixtures/basic-types/extends/node_modules/foo/nuxt.config.ts b/test/fixtures/basic-types/extends/node_modules/foo/nuxt.config.ts
new file mode 100644
index 000000000000..f716d9f9da91
--- /dev/null
+++ b/test/fixtures/basic-types/extends/node_modules/foo/nuxt.config.ts
@@ -0,0 +1,3 @@
+import { defineNuxtConfig } from 'nuxt/config'
+
+export default defineNuxtConfig({})
diff --git a/test/fixtures/basic-types/extends/node_modules/foo/pages/foo.vue b/test/fixtures/basic-types/extends/node_modules/foo/pages/foo.vue
new file mode 100644
index 000000000000..9599ea6eac9e
--- /dev/null
+++ b/test/fixtures/basic-types/extends/node_modules/foo/pages/foo.vue
@@ -0,0 +1,19 @@
+
+
+
+
+
{{ test }}
+
Extended page from foo
+
Middleware | foo: {{ $route.meta.foo }}
+
Composable | useExtendsFoo: {{ foo }}
+
Plugin | foo: {{ $foo() }}
+
+
diff --git a/test/fixtures/basic-types/extends/node_modules/foo/pages/override.vue b/test/fixtures/basic-types/extends/node_modules/foo/pages/override.vue
new file mode 100644
index 000000000000..28d1b37d1c53
--- /dev/null
+++ b/test/fixtures/basic-types/extends/node_modules/foo/pages/override.vue
@@ -0,0 +1,3 @@
+
+ This page should be overridden by bar
+
diff --git a/test/fixtures/basic-types/extends/node_modules/foo/plugins/foo.ts b/test/fixtures/basic-types/extends/node_modules/foo/plugins/foo.ts
new file mode 100644
index 000000000000..23534da003c6
--- /dev/null
+++ b/test/fixtures/basic-types/extends/node_modules/foo/plugins/foo.ts
@@ -0,0 +1,7 @@
+export default defineNuxtPlugin(() => {
+ return {
+ provide: {
+ foo: () => 'String generated from foo plugin!'
+ }
+ }
+})
diff --git a/test/fixtures/basic-types/extends/node_modules/foo/server/api/foo.ts b/test/fixtures/basic-types/extends/node_modules/foo/server/api/foo.ts
new file mode 100644
index 000000000000..4529f026397b
--- /dev/null
+++ b/test/fixtures/basic-types/extends/node_modules/foo/server/api/foo.ts
@@ -0,0 +1,3 @@
+import { eventHandler } from 'h3'
+
+export default eventHandler(() => 'foo')
diff --git a/test/fixtures/basic-types/index.d.ts b/test/fixtures/basic-types/index.d.ts
new file mode 100644
index 000000000000..4d653088767e
--- /dev/null
+++ b/test/fixtures/basic-types/index.d.ts
@@ -0,0 +1,7 @@
+declare module 'nuxt/schema' {
+ interface PublicRuntimeConfig {
+ ids: (1 | 2 | 3)[]
+ }
+}
+
+export {}
diff --git a/test/fixtures/basic-types/modules/auto-registered/index.ts b/test/fixtures/basic-types/modules/auto-registered/index.ts
new file mode 100644
index 000000000000..85ea6b718c8f
--- /dev/null
+++ b/test/fixtures/basic-types/modules/auto-registered/index.ts
@@ -0,0 +1,15 @@
+import { addServerHandler, createResolver, defineNuxtModule } from 'nuxt/kit'
+
+export default defineNuxtModule({
+ meta: {
+ name: 'auto-registered-module',
+ },
+ setup () {
+ const resolver = createResolver(import.meta.url)
+
+ addServerHandler({
+ handler: resolver.resolve('./runtime/handler'),
+ route: '/auto-registered-module',
+ })
+ },
+})
diff --git a/test/fixtures/basic-types/modules/auto-registered/runtime/handler.ts b/test/fixtures/basic-types/modules/auto-registered/runtime/handler.ts
new file mode 100644
index 000000000000..18413fe2d9d3
--- /dev/null
+++ b/test/fixtures/basic-types/modules/auto-registered/runtime/handler.ts
@@ -0,0 +1,3 @@
+import { defineEventHandler } from 'nitro/h3'
+
+export default defineEventHandler(() => 'handler added by auto-registered module')
diff --git a/test/fixtures/basic-types/modules/example.ts b/test/fixtures/basic-types/modules/example.ts
new file mode 100644
index 000000000000..1d8daef79a7e
--- /dev/null
+++ b/test/fixtures/basic-types/modules/example.ts
@@ -0,0 +1,35 @@
+import { addPlugin, createResolver, defineNuxtModule, useNuxt } from 'nuxt/kit'
+
+export default defineNuxtModule({
+ defaults: {
+ enabled: true,
+ typeTest: (value: boolean) => typeof value === 'boolean',
+ },
+ meta: {
+ name: 'my-module',
+ configKey: 'sampleModule',
+ },
+ setup () {
+ const resolver = createResolver(import.meta.url)
+
+ addPlugin(resolver.resolve('./runtime/plugin'))
+ useNuxt().hook('app:resolve', (app) => {
+ app.middleware.push({
+ name: 'unctx-test',
+ path: resolver.resolve('./runtime/middleware'),
+ })
+ })
+ useNuxt().hook('my-module:augmented-hook', (payload) => {
+ // Asserts the augmented hook signature is reachable from inside the
+ // module's own `useNuxt().hook(...)` call.
+ const _: string = payload.message
+ })
+ },
+})
+
+declare module '@nuxt/schema' {
+ interface NuxtHooks {
+ /** Test hook used to verify augmented hooks reach `NuxtConfig['hooks']`. */
+ 'my-module:augmented-hook': (payload: { message: string }) => void
+ }
+}
diff --git a/test/fixtures/basic-types/modules/page-extend.ts b/test/fixtures/basic-types/modules/page-extend.ts
new file mode 100644
index 000000000000..72901e6595f7
--- /dev/null
+++ b/test/fixtures/basic-types/modules/page-extend.ts
@@ -0,0 +1,19 @@
+import { createResolver, defineNuxtModule, useNuxt } from 'nuxt/kit'
+
+export default defineNuxtModule({
+ meta: {
+ name: 'page-extend',
+ },
+ setup () {
+ const nuxt = useNuxt()
+ const resolver = createResolver(import.meta.url)
+
+ nuxt.hook('pages:extend', (pages) => {
+ pages.push({
+ name: 'page-extend',
+ path: '/page-extend',
+ file: resolver.resolve('./runtime/page.vue'),
+ })
+ })
+ },
+})
diff --git a/test/fixtures/basic-types/modules/runtime/middleware.ts b/test/fixtures/basic-types/modules/runtime/middleware.ts
new file mode 100644
index 000000000000..7ddcb23d820a
--- /dev/null
+++ b/test/fixtures/basic-types/modules/runtime/middleware.ts
@@ -0,0 +1,4 @@
+export default defineNuxtRouteMiddleware(async () => {
+ await new Promise(resolve => setTimeout(resolve, 1))
+ useNuxtApp()
+})
diff --git a/test/fixtures/basic-types/modules/runtime/page.vue b/test/fixtures/basic-types/modules/runtime/page.vue
new file mode 100644
index 000000000000..9cfda735465f
--- /dev/null
+++ b/test/fixtures/basic-types/modules/runtime/page.vue
@@ -0,0 +1,17 @@
+
+
+
+
+
+
+ added in pages:extend
+
+
diff --git a/test/fixtures/basic-types/modules/runtime/plugin.ts b/test/fixtures/basic-types/modules/runtime/plugin.ts
new file mode 100644
index 000000000000..61a24ed6d201
--- /dev/null
+++ b/test/fixtures/basic-types/modules/runtime/plugin.ts
@@ -0,0 +1,4 @@
+export default defineNuxtPlugin(async () => {
+ await new Promise(resolve => setTimeout(resolve, 1))
+ useNuxtApp()
+})
diff --git a/test/fixtures/basic-types/modules/test/index.ts b/test/fixtures/basic-types/modules/test/index.ts
new file mode 100644
index 000000000000..d604033fbb5b
--- /dev/null
+++ b/test/fixtures/basic-types/modules/test/index.ts
@@ -0,0 +1,7 @@
+import { defineNuxtModule } from 'nuxt/kit'
+
+export default defineNuxtModule({
+ meta: {
+ name: 'test',
+ },
+})
diff --git a/test/fixtures/basic-types/nuxt.config.ts b/test/fixtures/basic-types/nuxt.config.ts
new file mode 100644
index 000000000000..2e748045b0a8
--- /dev/null
+++ b/test/fixtures/basic-types/nuxt.config.ts
@@ -0,0 +1,137 @@
+/// ` boundary must reach
+ // `NuxtConfig['hooks']` when read via `nuxt/schema` (the path
+ // `defineNuxtConfig` takes).
+ const _: number = payload.value
+ },
+ },
+})
diff --git a/test/fixtures/basic-types/nuxt.schema.ts b/test/fixtures/basic-types/nuxt.schema.ts
new file mode 100644
index 000000000000..23ff77b8d725
--- /dev/null
+++ b/test/fixtures/basic-types/nuxt.schema.ts
@@ -0,0 +1,9 @@
+export default defineNuxtSchema({
+ appConfig: {
+ /**
+ * This is an example app config defined in custom schema
+ * @type {123 | 456}
+ */
+ userConfig: 123,
+ },
+})
diff --git a/test/fixtures/basic-types/package.json b/test/fixtures/basic-types/package.json
new file mode 100644
index 000000000000..080de3d9e305
--- /dev/null
+++ b/test/fixtures/basic-types/package.json
@@ -0,0 +1,21 @@
+{
+ "private": true,
+ "name": "fixture-basic-types",
+ "scripts": {
+ "build": "nuxt build",
+ "test:types": "nuxt prepare && npx vue-tsc -b --noEmit"
+ },
+ "dependencies": {
+ "hook-augmenting-module": "workspace:*",
+ "nuxt": "workspace:*",
+ "ofetch": "^2.0.0-alpha.3",
+ "vue": "^3.5.34",
+ "vue-router": "^5.0.6"
+ },
+ "devDependencies": {
+ "vitest": "4.1.6"
+ },
+ "engines": {
+ "node": "^22.12.0 || ^24.11.0 || >=26.0.0"
+ }
+}
diff --git a/test/fixtures/basic-types/server/api/hello.ts b/test/fixtures/basic-types/server/api/hello.ts
new file mode 100644
index 000000000000..569613d6f79e
--- /dev/null
+++ b/test/fixtures/basic-types/server/api/hello.ts
@@ -0,0 +1 @@
+export default defineEventHandler(() => 'Hello API')
diff --git a/test/fixtures/basic-types/server/api/hey/index.get.ts b/test/fixtures/basic-types/server/api/hey/index.get.ts
new file mode 100644
index 000000000000..e937164878b1
--- /dev/null
+++ b/test/fixtures/basic-types/server/api/hey/index.get.ts
@@ -0,0 +1,4 @@
+export default defineEventHandler(() => ({
+ foo: 'bar',
+ baz: 'qux',
+}))
diff --git a/test/fixtures/basic-types/server/api/hey/index.post.ts b/test/fixtures/basic-types/server/api/hey/index.post.ts
new file mode 100644
index 000000000000..f30bc979aca8
--- /dev/null
+++ b/test/fixtures/basic-types/server/api/hey/index.post.ts
@@ -0,0 +1,3 @@
+export default defineEventHandler(() => ({
+ method: 'post' as const,
+}))
diff --git a/test/fixtures/basic-types/server/api/union.ts b/test/fixtures/basic-types/server/api/union.ts
new file mode 100644
index 000000000000..3401498fc152
--- /dev/null
+++ b/test/fixtures/basic-types/server/api/union.ts
@@ -0,0 +1,4 @@
+export default defineEventHandler(() => ({
+ type: 'a',
+ foo: 'bar',
+}) as { type: 'a', foo: string } | { type: 'b', baz: string })
diff --git a/test/fixtures/basic-types/server/type-context.ts b/test/fixtures/basic-types/server/type-context.ts
new file mode 100644
index 000000000000..8994c5a431d2
--- /dev/null
+++ b/test/fixtures/basic-types/server/type-context.ts
@@ -0,0 +1,4 @@
+// @ts-expect-error Fromage is 'cheese'
+const _fake: Fromage = 'babybel'
+
+const _fromage: Fromage = 'cheese'
diff --git a/test/fixtures/basic-types/shared/other.ts b/test/fixtures/basic-types/shared/other.ts
new file mode 100644
index 000000000000..21ec276fc7f8
--- /dev/null
+++ b/test/fixtures/basic-types/shared/other.ts
@@ -0,0 +1 @@
+export const foo = 'bar'
diff --git a/test/fixtures/basic-types/shared/shared-types.ts b/test/fixtures/basic-types/shared/shared-types.ts
new file mode 100644
index 000000000000..ea25d800277d
--- /dev/null
+++ b/test/fixtures/basic-types/shared/shared-types.ts
@@ -0,0 +1,25 @@
+import { describe, expectTypeOf, it } from 'vitest'
+
+import { foo } from '#shared/other'
+
+describe('shared folder', () => {
+ it('can reference its own aliases', () => {
+ expectTypeOf(foo).not.toBeAny()
+ expectTypeOf(foo).toEqualTypeOf()
+ })
+
+ it('can reference auto-imported utils', () => {
+ expectTypeOf(useSharedUtil()).toEqualTypeOf()
+ })
+
+ it('can reference useRuntimeConfig', () => {
+ const config = useRuntimeConfig()
+ expectTypeOf(config).not.toBeAny()
+ expectTypeOf(config.public).not.toBeAny()
+ })
+
+ it('can reference useAppConfig', () => {
+ const config = useAppConfig()
+ expectTypeOf(config).not.toBeAny()
+ })
+})
diff --git a/test/fixtures/basic-types/shared/utils/test.ts b/test/fixtures/basic-types/shared/utils/test.ts
new file mode 100644
index 000000000000..b0fd718b3839
--- /dev/null
+++ b/test/fixtures/basic-types/shared/utils/test.ts
@@ -0,0 +1 @@
+export const useSharedUtil = () => 'foo'
diff --git a/test/fixtures/basic-types/tsconfig.json b/test/fixtures/basic-types/tsconfig.json
new file mode 100644
index 000000000000..6ae5970c766b
--- /dev/null
+++ b/test/fixtures/basic-types/tsconfig.json
@@ -0,0 +1,17 @@
+{
+ "files": [],
+ "references": [
+ {
+ "path": "./.nuxt/tsconfig.app.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.server.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.shared.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.node.json"
+ }
+ ]
+}
diff --git a/test/fixtures/basic/.gitignore b/test/fixtures/basic/.gitignore
new file mode 100644
index 000000000000..2a0469def7c5
--- /dev/null
+++ b/test/fixtures/basic/.gitignore
@@ -0,0 +1 @@
+!extends/node_modules
diff --git a/test/fixtures/basic/.nuxtignore b/test/fixtures/basic/.nuxtignore
new file mode 100644
index 000000000000..59e57a945400
--- /dev/null
+++ b/test/fixtures/basic/.nuxtignore
@@ -0,0 +1,3 @@
+composables/ignored.*
+**/ignore/public-asset
+server/routes/ignore/scanned.ts
diff --git a/test/fixtures/basic/app/app.config.js b/test/fixtures/basic/app/app.config.js
new file mode 100644
index 000000000000..229ea39f714b
--- /dev/null
+++ b/test/fixtures/basic/app/app.config.js
@@ -0,0 +1,7 @@
+// eslint-disable-next-line no-undef
+export default defineAppConfig({
+ userConfig: 123,
+ nested: {
+ val: 2,
+ },
+})
diff --git a/test/fixtures/basic/app/app.vue b/test/fixtures/basic/app/app.vue
new file mode 100644
index 000000000000..6d2a415958d5
--- /dev/null
+++ b/test/fixtures/basic/app/app.vue
@@ -0,0 +1,6 @@
+
+
+
+
diff --git a/test/fixtures/basic/app/assets/assets.css b/test/fixtures/basic/app/assets/assets.css
new file mode 100644
index 000000000000..71cc96566587
--- /dev/null
+++ b/test/fixtures/basic/app/assets/assets.css
@@ -0,0 +1,3 @@
+:root {
+ --assets: 'assets';
+}
diff --git a/test/fixtures/basic/app/assets/css-only-asset.svg b/test/fixtures/basic/app/assets/css-only-asset.svg
new file mode 100644
index 000000000000..ebe18164a14b
--- /dev/null
+++ b/test/fixtures/basic/app/assets/css-only-asset.svg
@@ -0,0 +1,7 @@
+
+
+
+
+
+
diff --git a/test/fixtures/basic/app/assets/functional.css b/test/fixtures/basic/app/assets/functional.css
new file mode 100644
index 000000000000..4952c512320c
--- /dev/null
+++ b/test/fixtures/basic/app/assets/functional.css
@@ -0,0 +1,3 @@
+:root {
+ --functional: 'functional';
+}
diff --git a/test/fixtures/basic/app/assets/global.css b/test/fixtures/basic/app/assets/global.css
new file mode 100644
index 000000000000..81bead5317e4
--- /dev/null
+++ b/test/fixtures/basic/app/assets/global.css
@@ -0,0 +1,5 @@
+:root {
+ --global: 'global';
+ --asset: url('~/assets/css-only-asset.svg');
+ --public-asset: url('/css-only-public-asset.svg');
+}
diff --git a/test/fixtures/basic/app/assets/inline-only.css b/test/fixtures/basic/app/assets/inline-only.css
new file mode 100644
index 000000000000..0e377e929e3b
--- /dev/null
+++ b/test/fixtures/basic/app/assets/inline-only.css
@@ -0,0 +1,3 @@
+:root {
+ --inline-only: 'inline-only';
+}
diff --git a/test/fixtures/basic/app/assets/logo.svg b/test/fixtures/basic/app/assets/logo.svg
new file mode 100644
index 000000000000..c31de56afcf1
--- /dev/null
+++ b/test/fixtures/basic/app/assets/logo.svg
@@ -0,0 +1,18 @@
+
+
+
+
+
+
+
+
+
+
diff --git a/test/fixtures/basic/app/assets/plugin.css b/test/fixtures/basic/app/assets/plugin.css
new file mode 100644
index 000000000000..18bb69272701
--- /dev/null
+++ b/test/fixtures/basic/app/assets/plugin.css
@@ -0,0 +1,3 @@
+:root {
+ --plugin: 'plugin';
+}
diff --git a/test/fixtures/basic/app/components/1thing.island.vue b/test/fixtures/basic/app/components/1thing.island.vue
new file mode 100644
index 000000000000..fdcf405ceff6
--- /dev/null
+++ b/test/fixtures/basic/app/components/1thing.island.vue
@@ -0,0 +1,7 @@
+
+
+
+
+ Meant to detect syntax error when `components.islands.mjs` is created
+
+
diff --git a/test/fixtures/basic/app/components/AsyncServerComponent.server.vue b/test/fixtures/basic/app/components/AsyncServerComponent.server.vue
new file mode 100644
index 000000000000..a8f3df2dbd51
--- /dev/null
+++ b/test/fixtures/basic/app/components/AsyncServerComponent.server.vue
@@ -0,0 +1,20 @@
+
+
+ This is a .server (20ms) async component
+ {{ data }}
+
+ {{ count }}
+
+
+
+
+
+
+
diff --git a/test/fixtures/basic/app/components/BreakInAsyncSetup.vue b/test/fixtures/basic/app/components/BreakInAsyncSetup.vue
new file mode 100644
index 000000000000..33798a267695
--- /dev/null
+++ b/test/fixtures/basic/app/components/BreakInAsyncSetup.vue
@@ -0,0 +1,13 @@
+
+
+
+
+ This breaks in server-side async setup. {{ data.serverRendered }}
+
+
diff --git a/test/fixtures/basic/app/components/BreakInAsyncSetupDelayed.vue b/test/fixtures/basic/app/components/BreakInAsyncSetupDelayed.vue
new file mode 100644
index 000000000000..2971115f9bc1
--- /dev/null
+++ b/test/fixtures/basic/app/components/BreakInAsyncSetupDelayed.vue
@@ -0,0 +1,14 @@
+
+
+
+
+ This breaks in delayed server-side async setup. {{ data.serverRendered }}
+
+
diff --git a/test/fixtures/basic/app/components/BreakInAsyncSetupWrapper.vue b/test/fixtures/basic/app/components/BreakInAsyncSetupWrapper.vue
new file mode 100644
index 000000000000..d53eec1f0b60
--- /dev/null
+++ b/test/fixtures/basic/app/components/BreakInAsyncSetupWrapper.vue
@@ -0,0 +1,5 @@
+
+
+
+
diff --git a/test/fixtures/basic/app/components/BreakInSetup.vue b/test/fixtures/basic/app/components/BreakInSetup.vue
new file mode 100644
index 000000000000..495a80546ebe
--- /dev/null
+++ b/test/fixtures/basic/app/components/BreakInSetup.vue
@@ -0,0 +1,10 @@
+
+
+
+
+ This breaks in server-side setup. {{ data.serverRendered }}
+
+
diff --git a/test/fixtures/basic/app/components/BreaksServer.client.ts b/test/fixtures/basic/app/components/BreaksServer.client.ts
new file mode 100644
index 000000000000..73596f1da012
--- /dev/null
+++ b/test/fixtures/basic/app/components/BreaksServer.client.ts
@@ -0,0 +1,6 @@
+// @ts-expect-error assigning property to window object to break SSR
+window.test = true
+
+export default defineComponent({
+ render: () => 'hi',
+})
diff --git a/test/fixtures/basic/app/components/ClientOnlyScript.client.vue b/test/fixtures/basic/app/components/ClientOnlyScript.client.vue
new file mode 100644
index 000000000000..7dad374d301c
--- /dev/null
+++ b/test/fixtures/basic/app/components/ClientOnlyScript.client.vue
@@ -0,0 +1,31 @@
+
+
+
+
+
+ client only script component {{ foo }}
+
+
+
+
+
+
+
diff --git a/test/fixtures/basic/app/components/ClientOnlySetupScript.client.vue b/test/fixtures/basic/app/components/ClientOnlySetupScript.client.vue
new file mode 100644
index 000000000000..69ac52998bf5
--- /dev/null
+++ b/test/fixtures/basic/app/components/ClientOnlySetupScript.client.vue
@@ -0,0 +1,10 @@
+
+
+
+
+
client only script setup component {{ props.foo }}
+
+
diff --git a/test/fixtures/basic/app/components/ClientWrapped.client.vue b/test/fixtures/basic/app/components/ClientWrapped.client.vue
new file mode 100644
index 000000000000..dc2efb5cfe7d
--- /dev/null
+++ b/test/fixtures/basic/app/components/ClientWrapped.client.vue
@@ -0,0 +1,19 @@
+
+
+
+
+ client-only component
+
+
diff --git a/test/fixtures/basic/app/components/ComponentUsingCookie.vue b/test/fixtures/basic/app/components/ComponentUsingCookie.vue
new file mode 100644
index 000000000000..352a23237bd5
--- /dev/null
+++ b/test/fixtures/basic/app/components/ComponentUsingCookie.vue
@@ -0,0 +1,14 @@
+
+
+
+
+ child banner
+
+
diff --git a/test/fixtures/basic/app/components/ComponentWithIds.vue b/test/fixtures/basic/app/components/ComponentWithIds.vue
new file mode 100644
index 000000000000..1de12b43c48f
--- /dev/null
+++ b/test/fixtures/basic/app/components/ComponentWithIds.vue
@@ -0,0 +1,21 @@
+
+
+
+
+ Email
+ Password
+
+
diff --git a/test/fixtures/basic/app/components/ComponentWithRef.vue b/test/fixtures/basic/app/components/ComponentWithRef.vue
new file mode 100644
index 000000000000..298d6fad82c8
--- /dev/null
+++ b/test/fixtures/basic/app/components/ComponentWithRef.vue
@@ -0,0 +1,16 @@
+
+
+
+
+
diff --git a/test/fixtures/basic/app/components/Counter.vue b/test/fixtures/basic/app/components/Counter.vue
new file mode 100644
index 000000000000..329ffc0393ec
--- /dev/null
+++ b/test/fixtures/basic/app/components/Counter.vue
@@ -0,0 +1,17 @@
+
+
+
+
+
+ Sugar Counter {{ count }} x {{ multiplier }} = {{ doubled }}
+
+ Inc
+
+
+
diff --git a/test/fixtures/basic/app/components/DelayedComponent.vue b/test/fixtures/basic/app/components/DelayedComponent.vue
new file mode 100644
index 000000000000..1f18388f2186
--- /dev/null
+++ b/test/fixtures/basic/app/components/DelayedComponent.vue
@@ -0,0 +1,16 @@
+
+
+ This {{ mounted ? 'is' : 'is not' }} mounted.
+
+
+
+
diff --git a/test/fixtures/basic/app/components/DelayedModel.vue b/test/fixtures/basic/app/components/DelayedModel.vue
new file mode 100644
index 000000000000..baf642c109b0
--- /dev/null
+++ b/test/fixtures/basic/app/components/DelayedModel.vue
@@ -0,0 +1,15 @@
+
+
+ {{ model }}
+
+ Increment
+
+
+
+
+
diff --git a/test/fixtures/basic/app/components/EventView.vue b/test/fixtures/basic/app/components/EventView.vue
new file mode 100644
index 000000000000..c3bd807298b7
--- /dev/null
+++ b/test/fixtures/basic/app/components/EventView.vue
@@ -0,0 +1,10 @@
+
+
+ This {{ mounted ? 'is' : 'is not' }} mounted.
+
+
+
+
diff --git a/test/fixtures/basic/app/components/FunctionalComponent.ts b/test/fixtures/basic/app/components/FunctionalComponent.ts
new file mode 100644
index 000000000000..b8d04f2c3089
--- /dev/null
+++ b/test/fixtures/basic/app/components/FunctionalComponent.ts
@@ -0,0 +1,5 @@
+import '~/assets/functional.css'
+
+export default defineComponent({
+ render: () => 'hi',
+})
diff --git a/test/fixtures/basic/app/components/GlobalSync.vue b/test/fixtures/basic/app/components/GlobalSync.vue
new file mode 100644
index 000000000000..9e075fed9ef6
--- /dev/null
+++ b/test/fixtures/basic/app/components/GlobalSync.vue
@@ -0,0 +1,5 @@
+
+
+ This is a synchronously registered global component
+
+
diff --git a/test/fixtures/basic/app/components/Nested/Counter.vue b/test/fixtures/basic/app/components/Nested/Counter.vue
new file mode 100644
index 000000000000..3eddff31a764
--- /dev/null
+++ b/test/fixtures/basic/app/components/Nested/Counter.vue
@@ -0,0 +1,14 @@
+
+
+
+
+
+
diff --git a/test/fixtures/basic/app/components/ServerOnlyComponent.server.vue b/test/fixtures/basic/app/components/ServerOnlyComponent.server.vue
new file mode 100644
index 000000000000..c4085eb1338d
--- /dev/null
+++ b/test/fixtures/basic/app/components/ServerOnlyComponent.server.vue
@@ -0,0 +1,16 @@
+
+
+
+
+ server-only component
+
+
+
+
diff --git a/test/fixtures/basic/app/components/ServerOnlyComponentChild.vue b/test/fixtures/basic/app/components/ServerOnlyComponentChild.vue
new file mode 100644
index 000000000000..5283fcd9484d
--- /dev/null
+++ b/test/fixtures/basic/app/components/ServerOnlyComponentChild.vue
@@ -0,0 +1,11 @@
+
+
+ server-only component child (non-server-only)
+
+
+
+
diff --git a/test/fixtures/basic/app/components/SharedComponent.vue b/test/fixtures/basic/app/components/SharedComponent.vue
new file mode 100644
index 000000000000..ebf2e90c3f8d
--- /dev/null
+++ b/test/fixtures/basic/app/components/SharedComponent.vue
@@ -0,0 +1,9 @@
+
+
+
+
diff --git a/test/fixtures/basic/app/components/Tsx.tsx b/test/fixtures/basic/app/components/Tsx.tsx
new file mode 100644
index 000000000000..f505e22be453
--- /dev/null
+++ b/test/fixtures/basic/app/components/Tsx.tsx
@@ -0,0 +1,11 @@
+export default defineComponent({
+ render () {
+ return (
+
+ TSX component
+ custom
+
+ )
+ },
+})
diff --git a/test/fixtures/basic/app/components/WithSuffix.global.vue b/test/fixtures/basic/app/components/WithSuffix.global.vue
new file mode 100644
index 000000000000..dcf9b9df49be
--- /dev/null
+++ b/test/fixtures/basic/app/components/WithSuffix.global.vue
@@ -0,0 +1,5 @@
+
+
+ global component via suffix
+
+
diff --git a/test/fixtures/basic/app/components/WrapClientComponent.vue b/test/fixtures/basic/app/components/WrapClientComponent.vue
new file mode 100644
index 000000000000..3aebe022b955
--- /dev/null
+++ b/test/fixtures/basic/app/components/WrapClientComponent.vue
@@ -0,0 +1,16 @@
+
+
+
+
+
+
diff --git a/test/fixtures/basic/app/components/client/Binding.client.ts b/test/fixtures/basic/app/components/client/Binding.client.ts
new file mode 100644
index 000000000000..84412cc6d5a4
--- /dev/null
+++ b/test/fixtures/basic/app/components/client/Binding.client.ts
@@ -0,0 +1,11 @@
+export default defineComponent({
+ name: 'Foo',
+ methods: {
+ getMessage () {
+ return 'Hello world'
+ },
+ },
+ render () {
+ return h('div', {}, this.getMessage())
+ },
+})
diff --git a/test/fixtures/basic/app/components/client/FragmentServer.client.vue b/test/fixtures/basic/app/components/client/FragmentServer.client.vue
new file mode 100644
index 000000000000..281136bff66f
--- /dev/null
+++ b/test/fixtures/basic/app/components/client/FragmentServer.client.vue
@@ -0,0 +1,8 @@
+
+
+ world
+
+
+ world
+
+
diff --git a/test/fixtures/basic/app/components/client/FragmentServer.server.vue b/test/fixtures/basic/app/components/client/FragmentServer.server.vue
new file mode 100644
index 000000000000..28bcc947f529
--- /dev/null
+++ b/test/fixtures/basic/app/components/client/FragmentServer.server.vue
@@ -0,0 +1,5 @@
+
+
+ hello
+
+
diff --git a/test/fixtures/basic/app/components/client/FragmentServerFragment.client.vue b/test/fixtures/basic/app/components/client/FragmentServerFragment.client.vue
new file mode 100644
index 000000000000..398f0f0a565f
--- /dev/null
+++ b/test/fixtures/basic/app/components/client/FragmentServerFragment.client.vue
@@ -0,0 +1,8 @@
+
+
+ world
+
+
+ world
+
+
diff --git a/test/fixtures/basic/app/components/client/FragmentServerFragment.server.vue b/test/fixtures/basic/app/components/client/FragmentServerFragment.server.vue
new file mode 100644
index 000000000000..ca5c6c67a203
--- /dev/null
+++ b/test/fixtures/basic/app/components/client/FragmentServerFragment.server.vue
@@ -0,0 +1,8 @@
+
+
+ hello
+
+
+ hello
+
+
diff --git a/test/fixtures/basic/app/components/client/MultiRootNode.client.vue b/test/fixtures/basic/app/components/client/MultiRootNode.client.vue
new file mode 100644
index 000000000000..15fcf0e2d037
--- /dev/null
+++ b/test/fixtures/basic/app/components/client/MultiRootNode.client.vue
@@ -0,0 +1,20 @@
+
+
+ {{ count }}
+
+
+ add 1 to count
+
+
+
+
diff --git a/test/fixtures/basic/app/components/client/MultiRootNodeScript.client.vue b/test/fixtures/basic/app/components/client/MultiRootNodeScript.client.vue
new file mode 100644
index 000000000000..36ef79445f45
--- /dev/null
+++ b/test/fixtures/basic/app/components/client/MultiRootNodeScript.client.vue
@@ -0,0 +1,25 @@
+
+
+ {{ count }}
+
+
+ add 1 to count
+
+
+
+
diff --git a/test/fixtures/basic/app/components/client/NoState.client.vue b/test/fixtures/basic/app/components/client/NoState.client.vue
new file mode 100644
index 000000000000..92f3b3e3becc
--- /dev/null
+++ b/test/fixtures/basic/app/components/client/NoState.client.vue
@@ -0,0 +1,3 @@
+
+ Hello world !
+
diff --git a/test/fixtures/basic/app/components/client/Script.client.vue b/test/fixtures/basic/app/components/client/Script.client.vue
new file mode 100644
index 000000000000..728309afa607
--- /dev/null
+++ b/test/fixtures/basic/app/components/client/Script.client.vue
@@ -0,0 +1,45 @@
+
+
+
+
+
+ client only script component {{ foo }}
+
+
+ {{ count }}
+
+
+
+
+
+
+
diff --git a/test/fixtures/basic/app/components/client/Server.client.vue b/test/fixtures/basic/app/components/client/Server.client.vue
new file mode 100644
index 000000000000..4a948b67cdec
--- /dev/null
+++ b/test/fixtures/basic/app/components/client/Server.client.vue
@@ -0,0 +1,5 @@
+
+
+ world !
+
+
diff --git a/test/fixtures/basic/app/components/client/Server.server.vue b/test/fixtures/basic/app/components/client/Server.server.vue
new file mode 100644
index 000000000000..2944736ca6eb
--- /dev/null
+++ b/test/fixtures/basic/app/components/client/Server.server.vue
@@ -0,0 +1,5 @@
+
+
+ hello
+
+
diff --git a/test/fixtures/basic/app/components/client/ServerFragment.client.vue b/test/fixtures/basic/app/components/client/ServerFragment.client.vue
new file mode 100644
index 000000000000..9aa8067a42fc
--- /dev/null
+++ b/test/fixtures/basic/app/components/client/ServerFragment.client.vue
@@ -0,0 +1,5 @@
+
+
+ world
+
+
diff --git a/test/fixtures/basic/app/components/client/ServerFragment.server.vue b/test/fixtures/basic/app/components/client/ServerFragment.server.vue
new file mode 100644
index 000000000000..96e7f425867e
--- /dev/null
+++ b/test/fixtures/basic/app/components/client/ServerFragment.server.vue
@@ -0,0 +1,8 @@
+
+
+ hello
+
+
+ hello
+
+
diff --git a/test/fixtures/basic/app/components/client/SetupScript.client.vue b/test/fixtures/basic/app/components/client/SetupScript.client.vue
new file mode 100644
index 000000000000..3844c38b8b7c
--- /dev/null
+++ b/test/fixtures/basic/app/components/client/SetupScript.client.vue
@@ -0,0 +1,24 @@
+
+
+
+
+
client only script setup component {{ props.foo }}
+
+ {{ count }}
+
+
+
+
+
+
diff --git a/test/fixtures/basic/app/components/client/StringChildStateful.client.vue b/test/fixtures/basic/app/components/client/StringChildStateful.client.vue
new file mode 100644
index 000000000000..216e389daed6
--- /dev/null
+++ b/test/fixtures/basic/app/components/client/StringChildStateful.client.vue
@@ -0,0 +1,14 @@
+
+
+
+ Hi i should be rendered {{ state }}
+
diff --git a/test/fixtures/basic/app/components/client/StringChildStatefulScript.client.vue b/test/fixtures/basic/app/components/client/StringChildStatefulScript.client.vue
new file mode 100644
index 000000000000..09c136b3da6a
--- /dev/null
+++ b/test/fixtures/basic/app/components/client/StringChildStatefulScript.client.vue
@@ -0,0 +1,18 @@
+
+
+
+ Hi i should be rendered {{ state }}
+
diff --git a/test/fixtures/basic/app/components/clientFallback/AsyncSetup.vue b/test/fixtures/basic/app/components/clientFallback/AsyncSetup.vue
new file mode 100644
index 000000000000..4321cadf28dc
--- /dev/null
+++ b/test/fixtures/basic/app/components/clientFallback/AsyncSetup.vue
@@ -0,0 +1,11 @@
+
+
+ async setup
+
+
+ Work with async setup
+
+
+
diff --git a/test/fixtures/basic/app/components/clientFallback/NonStateful.vue b/test/fixtures/basic/app/components/clientFallback/NonStateful.vue
new file mode 100644
index 000000000000..e3a6560273a5
--- /dev/null
+++ b/test/fixtures/basic/app/components/clientFallback/NonStateful.vue
@@ -0,0 +1,14 @@
+
+
+ non stateful
+
+
+
+
+
+
diff --git a/test/fixtures/basic/app/components/clientFallback/NonStatefulSetup.vue b/test/fixtures/basic/app/components/clientFallback/NonStatefulSetup.vue
new file mode 100644
index 000000000000..49f2f4f77941
--- /dev/null
+++ b/test/fixtures/basic/app/components/clientFallback/NonStatefulSetup.vue
@@ -0,0 +1,8 @@
+
+
+ non stateful setup
+
+
+
+
diff --git a/test/fixtures/basic/app/components/clientFallback/Stateful.vue b/test/fixtures/basic/app/components/clientFallback/Stateful.vue
new file mode 100644
index 000000000000..dbe35fe86652
--- /dev/null
+++ b/test/fixtures/basic/app/components/clientFallback/Stateful.vue
@@ -0,0 +1,20 @@
+
+
+ stateful test {{ state }}
+
+
+
+
+
+
diff --git a/test/fixtures/basic/app/components/clientFallback/StatefulSetup.vue b/test/fixtures/basic/app/components/clientFallback/StatefulSetup.vue
new file mode 100644
index 000000000000..43a63debca73
--- /dev/null
+++ b/test/fixtures/basic/app/components/clientFallback/StatefulSetup.vue
@@ -0,0 +1,12 @@
+
+
+ stateful setup {{ state }}
+
+
+
+
+
+
diff --git a/test/fixtures/basic/app/components/global/ClientGlobal.client.vue b/test/fixtures/basic/app/components/global/ClientGlobal.client.vue
new file mode 100644
index 000000000000..dfcd008e1ba6
--- /dev/null
+++ b/test/fixtures/basic/app/components/global/ClientGlobal.client.vue
@@ -0,0 +1,5 @@
+
+
+ global component (client-only) registered automatically
+
+
diff --git a/test/fixtures/basic/app/components/global/ServerComponentGlobal.server.vue b/test/fixtures/basic/app/components/global/ServerComponentGlobal.server.vue
new file mode 100644
index 000000000000..435ce32581ec
--- /dev/null
+++ b/test/fixtures/basic/app/components/global/ServerComponentGlobal.server.vue
@@ -0,0 +1,5 @@
+
+
+ Test globally-registered server component
+
+
diff --git a/test/fixtures/basic/app/components/global/TestGlobal.vue b/test/fixtures/basic/app/components/global/TestGlobal.vue
new file mode 100644
index 000000000000..66307e17368d
--- /dev/null
+++ b/test/fixtures/basic/app/components/global/TestGlobal.vue
@@ -0,0 +1,5 @@
+
+
+ global component registered automatically
+
+
diff --git a/test/fixtures/basic/app/composables/async-context.ts b/test/fixtures/basic/app/composables/async-context.ts
new file mode 100644
index 000000000000..ab9e41aceaea
--- /dev/null
+++ b/test/fixtures/basic/app/composables/async-context.ts
@@ -0,0 +1,19 @@
+const delay = () => new Promise(resolve => setTimeout(resolve, 10))
+
+export async function nestedAsyncComposable () {
+ await delay()
+ return await fn1()
+}
+
+async function fn1 () {
+ await delay()
+ return await fn2()
+}
+
+async function fn2 () {
+ await delay()
+ const app = tryUseNuxtApp()
+ return {
+ hasApp: !!app,
+ }
+}
diff --git a/test/fixtures/basic/app/composables/asyncDataTests.ts b/test/fixtures/basic/app/composables/asyncDataTests.ts
new file mode 100644
index 000000000000..07dd078ae87c
--- /dev/null
+++ b/test/fixtures/basic/app/composables/asyncDataTests.ts
@@ -0,0 +1,7 @@
+export const useSleep = () => useAsyncData('sleep', async () => {
+ await new Promise(resolve => setTimeout(resolve, 50))
+
+ return 'Slept!'
+})
+
+export const useCounter = () => useFetch('/api/useAsyncData/count')
diff --git a/test/fixtures/basic/app/composables/badSideEffect.ts b/test/fixtures/basic/app/composables/badSideEffect.ts
new file mode 100644
index 000000000000..d722d3aa77bc
--- /dev/null
+++ b/test/fixtures/basic/app/composables/badSideEffect.ts
@@ -0,0 +1,5 @@
+export function badSideEffect () {
+ // ...
+}
+
+throw new Error('composables/badSideEffect.ts should be tree-shaken')
diff --git a/test/fixtures/basic/app/composables/cookie-manager.ts b/test/fixtures/basic/app/composables/cookie-manager.ts
new file mode 100644
index 000000000000..d728fd10545f
--- /dev/null
+++ b/test/fixtures/basic/app/composables/cookie-manager.ts
@@ -0,0 +1,18 @@
+export function useCookieManager () {
+ const theCookie = useCookie('theCookie', {
+ default: () => 'show',
+ })
+
+ const showCookieBanner = computed(() => {
+ return theCookie.value === 'show'
+ })
+
+ function toggle () {
+ theCookie.value = theCookie.value === 'show' ? null : 'show'
+ }
+
+ return {
+ showCookieBanner,
+ toggle,
+ }
+}
diff --git a/test/fixtures/basic/app/composables/export-star.ts b/test/fixtures/basic/app/composables/export-star.ts
new file mode 100644
index 000000000000..e759d92d6b3d
--- /dev/null
+++ b/test/fixtures/basic/app/composables/export-star.ts
@@ -0,0 +1 @@
+export * from './nested/bar'
diff --git a/test/fixtures/basic/app/composables/foo.ts b/test/fixtures/basic/app/composables/foo.ts
new file mode 100644
index 000000000000..be75db931049
--- /dev/null
+++ b/test/fixtures/basic/app/composables/foo.ts
@@ -0,0 +1,3 @@
+export function useFoo () {
+ return 'auto imported from ~/composables/foo.ts'
+}
diff --git a/test/fixtures/basic/app/composables/ignored.ts b/test/fixtures/basic/app/composables/ignored.ts
new file mode 100644
index 000000000000..8ba085c8a059
--- /dev/null
+++ b/test/fixtures/basic/app/composables/ignored.ts
@@ -0,0 +1,3 @@
+export function useIgnoredImport () {
+
+}
diff --git a/test/fixtures/basic/app/composables/keep-alive.ts b/test/fixtures/basic/app/composables/keep-alive.ts
new file mode 100644
index 000000000000..90999b752f1a
--- /dev/null
+++ b/test/fixtures/basic/app/composables/keep-alive.ts
@@ -0,0 +1,6 @@
+export function useLifecycleLogs (name: string) {
+ onMounted(() => console.log(`${name}: onMounted`))
+ onUnmounted(() => console.log(`${name}: onUnmounted`))
+ onActivated(() => console.log(`${name}: onActivated`))
+ onDeactivated(() => console.log(`${name}: onDeactivated`))
+}
diff --git a/test/fixtures/basic/app/composables/nested/bar.ts b/test/fixtures/basic/app/composables/nested/bar.ts
new file mode 100644
index 000000000000..c922dc2b966c
--- /dev/null
+++ b/test/fixtures/basic/app/composables/nested/bar.ts
@@ -0,0 +1,3 @@
+export function useNestedBar () {
+ return 'auto imported from ~/composables/nested/bar.ts via star export'
+}
diff --git a/test/fixtures/basic/app/composables/override-base.ts b/test/fixtures/basic/app/composables/override-base.ts
new file mode 100644
index 000000000000..2f8570e0898d
--- /dev/null
+++ b/test/fixtures/basic/app/composables/override-base.ts
@@ -0,0 +1 @@
+export const useOverridableComposable = () => 'test from project'
diff --git a/test/fixtures/basic/app/composables/random.ts b/test/fixtures/basic/app/composables/random.ts
new file mode 100644
index 000000000000..f38f1143547d
--- /dev/null
+++ b/test/fixtures/basic/app/composables/random.ts
@@ -0,0 +1,3 @@
+export function useRandomState (max = 100, name = 'default') {
+ return useState('random:' + name, () => Math.round(Math.random() * max))
+}
diff --git a/test/fixtures/basic/app/composables/template.ts b/test/fixtures/basic/app/composables/template.ts
new file mode 100644
index 000000000000..5e685f6894d5
--- /dev/null
+++ b/test/fixtures/basic/app/composables/template.ts
@@ -0,0 +1 @@
+export const templateAutoImport = 'auto imported from ~/composables/template.ts'
diff --git a/test/fixtures/basic/app/composables/tree-shake.ts b/test/fixtures/basic/app/composables/tree-shake.ts
new file mode 100644
index 000000000000..d057c120f732
--- /dev/null
+++ b/test/fixtures/basic/app/composables/tree-shake.ts
@@ -0,0 +1,16 @@
+export function useServerOnlyComposable () {
+ if (import.meta.client) {
+ throw new Error('this should not be called in the browser')
+ }
+}
+
+export function useClientOnlyComposable () {
+ // need to do some code that fails in node but not in the browser
+ if (import.meta.server) {
+ throw new Error('this should not be called on the server')
+ }
+}
+
+export function setTitleToPink () {
+ document.querySelector('h1')!.style.color = 'pink'
+}
diff --git a/test/fixtures/basic/app/error.vue b/test/fixtures/basic/app/error.vue
new file mode 100644
index 000000000000..55e7608eee5b
--- /dev/null
+++ b/test/fixtures/basic/app/error.vue
@@ -0,0 +1,22 @@
+
+
+
+
{{ error?.message }}
+ This is the error page 😱
+
+ Path: {{ error.data.path }}
+
+
+
+
+
diff --git a/packages/config/test/fixtures/app.html b/test/fixtures/basic/app/layouts/PascalCase.ts
similarity index 100%
rename from packages/config/test/fixtures/app.html
rename to test/fixtures/basic/app/layouts/PascalCase.ts
diff --git a/test/fixtures/basic/app/layouts/custom-async.vue b/test/fixtures/basic/app/layouts/custom-async.vue
new file mode 100644
index 000000000000..c93f4f6dc1ac
--- /dev/null
+++ b/test/fixtures/basic/app/layouts/custom-async.vue
@@ -0,0 +1,14 @@
+
+
+ Custom Async Layout:
+
+
+
+
diff --git a/test/fixtures/basic/app/layouts/custom.vue b/test/fixtures/basic/app/layouts/custom.vue
new file mode 100644
index 000000000000..1f567fbc7e5b
--- /dev/null
+++ b/test/fixtures/basic/app/layouts/custom.vue
@@ -0,0 +1,32 @@
+
+
+ Custom Layout:
+
+
+
+ {{ count }}
+
+
+ add count
+
+
{{ foo }}
+
+
+
diff --git a/test/fixtures/basic/app/layouts/custom2.vue b/test/fixtures/basic/app/layouts/custom2.vue
new file mode 100644
index 000000000000..ecf5021a7553
--- /dev/null
+++ b/test/fixtures/basic/app/layouts/custom2.vue
@@ -0,0 +1,28 @@
+
+
+ Custom2 Layout:
+
+
+
+ {{ count }}
+
+
+ add count
+
+
+
+
diff --git a/test/fixtures/basic/app/layouts/invalid-root.vue b/test/fixtures/basic/app/layouts/invalid-root.vue
new file mode 100644
index 000000000000..dbd7298fad30
--- /dev/null
+++ b/test/fixtures/basic/app/layouts/invalid-root.vue
@@ -0,0 +1,6 @@
+
+
+
+
+
diff --git a/test/fixtures/basic/app/layouts/with-announcer.vue b/test/fixtures/basic/app/layouts/with-announcer.vue
new file mode 100644
index 000000000000..b2d0fee54330
--- /dev/null
+++ b/test/fixtures/basic/app/layouts/with-announcer.vue
@@ -0,0 +1,6 @@
+
+
+
+
diff --git a/test/fixtures/basic/app/layouts/with-props.vue b/test/fixtures/basic/app/layouts/with-props.vue
new file mode 100644
index 000000000000..3b1de9e82032
--- /dev/null
+++ b/test/fixtures/basic/app/layouts/with-props.vue
@@ -0,0 +1,12 @@
+
+
+
+
+
diff --git a/test/fixtures/basic/app/layouts/with-route-announcer.vue b/test/fixtures/basic/app/layouts/with-route-announcer.vue
new file mode 100644
index 000000000000..3aebe7833beb
--- /dev/null
+++ b/test/fixtures/basic/app/layouts/with-route-announcer.vue
@@ -0,0 +1,6 @@
+
+
+
+
diff --git a/test/fixtures/basic/app/middleware/abort.global.ts b/test/fixtures/basic/app/middleware/abort.global.ts
new file mode 100644
index 000000000000..335882eb41d5
--- /dev/null
+++ b/test/fixtures/basic/app/middleware/abort.global.ts
@@ -0,0 +1,8 @@
+export default defineNuxtRouteMiddleware((to) => {
+ if ('abort' in to.query) {
+ return abortNavigation({
+ status: 401,
+ })
+ }
+ return true
+})
diff --git a/test/fixtures/basic/app/middleware/b.global.ts b/test/fixtures/basic/app/middleware/b.global.ts
new file mode 100644
index 000000000000..4acb1cd605a3
--- /dev/null
+++ b/test/fixtures/basic/app/middleware/b.global.ts
@@ -0,0 +1,5 @@
+export default defineNuxtRouteMiddleware((to) => {
+ if (to.path === '/middleware/ordering' && !useNuxtApp().extendsMiddleware) {
+ return createError('extendsMiddleware not set in layer')
+ }
+})
diff --git a/test/fixtures/basic/app/middleware/injectAuth.ts b/test/fixtures/basic/app/middleware/injectAuth.ts
new file mode 100644
index 000000000000..30801347aefc
--- /dev/null
+++ b/test/fixtures/basic/app/middleware/injectAuth.ts
@@ -0,0 +1,3 @@
+export default defineNuxtRouteMiddleware((to) => {
+ to.meta.auth = 'Injected by injectAuth middleware'
+})
diff --git a/test/fixtures/basic/app/middleware/prerender-loop.global.ts b/test/fixtures/basic/app/middleware/prerender-loop.global.ts
new file mode 100644
index 000000000000..081d085315d2
--- /dev/null
+++ b/test/fixtures/basic/app/middleware/prerender-loop.global.ts
@@ -0,0 +1,17 @@
+// Regression fixtures for https://github.com/nuxt/nuxt/issues/33871: prerender
+// must not deadlock when a fetch re-enters a URL already in the render chain.
+export default defineNuxtRouteMiddleware(async (to) => {
+ if (to.path === '/prerender/loop-self') {
+ await useFetch('/prerender/loop-self')
+ }
+ if (to.path === '/prerender/loop-shared-a' || to.path === '/prerender/loop-shared-b') {
+ await useFetch('/prerender/loop-shared-target', { key: 'prerender-loop-shared' })
+ }
+ if (to.path === '/prerender/loop-bare-fetch') {
+ try {
+ await $fetch('/prerender/loop-bare-fetch')
+ } catch {
+ // 508 Loop Detected — the renderer breaks the cycle so the build can finish.
+ }
+ }
+})
diff --git a/test/fixtures/basic/app/middleware/redirect.global.ts b/test/fixtures/basic/app/middleware/redirect.global.ts
new file mode 100644
index 000000000000..c79baa09f864
--- /dev/null
+++ b/test/fixtures/basic/app/middleware/redirect.global.ts
@@ -0,0 +1,26 @@
+import { withoutTrailingSlash } from 'ufo'
+
+export default defineNuxtRouteMiddleware(async (to) => {
+ const nuxtApp = useNuxtApp()
+ if (useRequestEvent()?.req.headers.get('trailing-slash') && to.fullPath.endsWith('/')) {
+ return navigateTo(withoutTrailingSlash(to.fullPath), { redirectCode: 307 })
+ }
+ if (to.path.startsWith('/redirect/')) {
+ await new Promise(resolve => setTimeout(resolve, 100))
+ return navigateTo(to.path.slice('/redirect/'.length - 1))
+ }
+ if (to.path === '/catchall/redirect-infinite') {
+ // the path will be the same in this new route and vue-router should send a 500 response
+ return navigateTo('/catchall/redirect-infinite?test=true')
+ }
+ if (to.path === '/navigate-to-external') {
+ return navigateTo('/', { external: true })
+ }
+ if (to.path === '/navigate-to-false') {
+ return false
+ }
+ const pluginPath = nuxtApp.$path()
+ if (import.meta.server && !/redirect|navigate/.test(pluginPath) && to.path !== pluginPath) {
+ throw new Error('plugin did not run before middleware')
+ }
+})
diff --git a/test/fixtures/basic/app/middleware/routeRulesMiddleware.ts b/test/fixtures/basic/app/middleware/routeRulesMiddleware.ts
new file mode 100644
index 000000000000..36ecf8c9983e
--- /dev/null
+++ b/test/fixtures/basic/app/middleware/routeRulesMiddleware.ts
@@ -0,0 +1,3 @@
+export default defineNuxtRouteMiddleware((to) => {
+ to.meta.hello = 'Hello from routeRules!'
+})
diff --git a/test/fixtures/basic/app/middleware/sets-layout.ts b/test/fixtures/basic/app/middleware/sets-layout.ts
new file mode 100644
index 000000000000..a8f6b0583385
--- /dev/null
+++ b/test/fixtures/basic/app/middleware/sets-layout.ts
@@ -0,0 +1,6 @@
+export default defineNuxtRouteMiddleware(async () => {
+ await new Promise(resolve => setTimeout(resolve, 10))
+ setPageLayout('custom', {
+ foo: 'set from sets-layouts middleware',
+ })
+})
diff --git a/test/fixtures/basic/app/other-components-folder/named-export.ts b/test/fixtures/basic/app/other-components-folder/named-export.ts
new file mode 100644
index 000000000000..d08c0bc0be12
--- /dev/null
+++ b/test/fixtures/basic/app/other-components-folder/named-export.ts
@@ -0,0 +1,3 @@
+export const namedExport = defineComponent({
+ setup: () => () => h('div', 'This is a custom component with a named export.'),
+})
diff --git a/test/fixtures/basic/app/other-composables-folder/custom-keyed-composable.ts b/test/fixtures/basic/app/other-composables-folder/custom-keyed-composable.ts
new file mode 100644
index 000000000000..f149fd358592
--- /dev/null
+++ b/test/fixtures/basic/app/other-composables-folder/custom-keyed-composable.ts
@@ -0,0 +1,3 @@
+export function useCustomKeyedComposable (arg?: string) {
+ return arg
+}
diff --git a/test/fixtures/basic/app/other-composables-folder/local.ts b/test/fixtures/basic/app/other-composables-folder/local.ts
new file mode 100644
index 000000000000..46858a277930
--- /dev/null
+++ b/test/fixtures/basic/app/other-composables-folder/local.ts
@@ -0,0 +1,5 @@
+function useAsyncData (s?: any) { return s }
+
+export const ShouldNotBeKeyed = (() => {
+ return useAsyncData()
+})()
diff --git a/test/fixtures/basic/app/pages/(new-group)/group-page.vue b/test/fixtures/basic/app/pages/(new-group)/group-page.vue
new file mode 100644
index 000000000000..171e0d1ed94f
--- /dev/null
+++ b/test/fixtures/basic/app/pages/(new-group)/group-page.vue
@@ -0,0 +1,5 @@
+
+
+ Hello from new group
+
+
diff --git a/test/fixtures/basic/app/pages/announcer.vue b/test/fixtures/basic/app/pages/announcer.vue
new file mode 100644
index 000000000000..38952b20c104
--- /dev/null
+++ b/test/fixtures/basic/app/pages/announcer.vue
@@ -0,0 +1,36 @@
+
+
+
+
+
Announcer Test Page
+
+ {{ message }}
+
+
+ Announce Polite
+
+
+ Announce Assertive
+
+
diff --git a/test/fixtures/basic/app/pages/another-parent.vue b/test/fixtures/basic/app/pages/another-parent.vue
new file mode 100644
index 000000000000..a71dcab8f2c5
--- /dev/null
+++ b/test/fixtures/basic/app/pages/another-parent.vue
@@ -0,0 +1,6 @@
+
+
+ another-parent
+
+
diff --git a/test/fixtures/basic/app/pages/another-parent/index.vue b/test/fixtures/basic/app/pages/another-parent/index.vue
new file mode 100644
index 000000000000..ff5e465ebc2d
--- /dev/null
+++ b/test/fixtures/basic/app/pages/another-parent/index.vue
@@ -0,0 +1,5 @@
+
+
+ another-parent/index
+
+
diff --git a/test/fixtures/basic/app/pages/app-config.vue b/test/fixtures/basic/app/pages/app-config.vue
new file mode 100644
index 000000000000..fe26ddcacf82
--- /dev/null
+++ b/test/fixtures/basic/app/pages/app-config.vue
@@ -0,0 +1,11 @@
+
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/assets-custom.vue b/test/fixtures/basic/app/pages/assets-custom.vue
new file mode 100644
index 000000000000..5f5f852436c4
--- /dev/null
+++ b/test/fixtures/basic/app/pages/assets-custom.vue
@@ -0,0 +1,7 @@
+
+
+
diff --git a/test/fixtures/basic/app/pages/assets.vue b/test/fixtures/basic/app/pages/assets.vue
new file mode 100644
index 000000000000..0c5a8e4bb589
--- /dev/null
+++ b/test/fixtures/basic/app/pages/assets.vue
@@ -0,0 +1,36 @@
+
+
+
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/async-context.vue b/test/fixtures/basic/app/pages/async-context.vue
new file mode 100644
index 000000000000..8979942d2bda
--- /dev/null
+++ b/test/fixtures/basic/app/pages/async-context.vue
@@ -0,0 +1,12 @@
+
+
+
+
Native Async Context
+
+ {{ data }}
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/async-parent.vue b/test/fixtures/basic/app/pages/async-parent.vue
new file mode 100644
index 000000000000..da8c96acbdd7
--- /dev/null
+++ b/test/fixtures/basic/app/pages/async-parent.vue
@@ -0,0 +1,16 @@
+
+
+ async-parent
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/async-parent/child.vue b/test/fixtures/basic/app/pages/async-parent/child.vue
new file mode 100644
index 000000000000..a3ecf7ad9f86
--- /dev/null
+++ b/test/fixtures/basic/app/pages/async-parent/child.vue
@@ -0,0 +1,15 @@
+
+
+ another-parent/child
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/auth.vue b/test/fixtures/basic/app/pages/auth.vue
new file mode 100644
index 000000000000..08726e722463
--- /dev/null
+++ b/test/fixtures/basic/app/pages/auth.vue
@@ -0,0 +1,12 @@
+
+
+
+
+
auth.vue
+
auth: {{ $route.meta.auth }}
+
diff --git a/test/fixtures/basic/app/pages/catchall/[...slug].vue b/test/fixtures/basic/app/pages/catchall/[...slug].vue
new file mode 100644
index 000000000000..4a044878e540
--- /dev/null
+++ b/test/fixtures/basic/app/pages/catchall/[...slug].vue
@@ -0,0 +1,25 @@
+
+
+
[...slug].vue
+
catchall at {{ route.params.slug?.[0] }}
+
Middleware ran: {{ !!($route.meta.override as any)?.includes('extended middleware') }}
+
+
+
diff --git a/test/fixtures/basic/app/pages/chunk-error.vue b/test/fixtures/basic/app/pages/chunk-error.vue
new file mode 100644
index 000000000000..ad5e56194086
--- /dev/null
+++ b/test/fixtures/basic/app/pages/chunk-error.vue
@@ -0,0 +1,11 @@
+
+
+
+
+ Chunk error page
+
diff --git a/test/fixtures/basic/app/pages/client-fallback.vue b/test/fixtures/basic/app/pages/client-fallback.vue
new file mode 100644
index 000000000000..60af65857887
--- /dev/null
+++ b/test/fixtures/basic/app/pages/client-fallback.vue
@@ -0,0 +1,80 @@
+
+
+ Hello World
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Hello world !
+
+
+
+
+
+
+ Nested async fallback rendered
+
+
+
+
+
+
+
+
+
+
+
+
+
+ keep fallback in client
+
+
+
+
+
+ increment count
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/client-only-components.vue b/test/fixtures/basic/app/pages/client-only-components.vue
new file mode 100644
index 000000000000..b4f9f83744af
--- /dev/null
+++ b/test/fixtures/basic/app/pages/client-only-components.vue
@@ -0,0 +1,111 @@
+
+
+
+
+
+
+
+ Hello
+
+
+
+
+ Should not be server rendered.
+
+ Fallback
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ increment count
+
+
+ increment count
+
+
+ increment count
+
+
+ increment count
+
+
+
+ Show all
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/client-only-explicit-import.vue b/test/fixtures/basic/app/pages/client-only-explicit-import.vue
new file mode 100644
index 000000000000..a741948ea510
--- /dev/null
+++ b/test/fixtures/basic/app/pages/client-only-explicit-import.vue
@@ -0,0 +1,16 @@
+
+
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/client-only-page/index.client.vue b/test/fixtures/basic/app/pages/client-only-page/index.client.vue
new file mode 100644
index 000000000000..0f06e4d49cad
--- /dev/null
+++ b/test/fixtures/basic/app/pages/client-only-page/index.client.vue
@@ -0,0 +1,40 @@
+
+
+
+
+
+ normal
+
+
+
+ {{ state }}
+
+
+
+ {{ serverRendered }}
+
+
diff --git a/test/fixtures/basic/app/pages/client-only-page/normal.vue b/test/fixtures/basic/app/pages/client-only-page/normal.vue
new file mode 100644
index 000000000000..758d9771b5b4
--- /dev/null
+++ b/test/fixtures/basic/app/pages/client-only-page/normal.vue
@@ -0,0 +1,20 @@
+
+
+
+
+
+ to client only page
+
+
+
+ {{ renderedOnServer }}
+
+
diff --git a/test/fixtures/basic/app/pages/client-server.vue b/test/fixtures/basic/app/pages/client-server.vue
new file mode 100644
index 000000000000..70bf7725672f
--- /dev/null
+++ b/test/fixtures/basic/app/pages/client-server.vue
@@ -0,0 +1,28 @@
+
+
+
+ this should not be removed by hydration
+
+
+
+
+ this should not be removed by hydration
+
+
+
+
+ this should not be removed by hydration
+
+
+
+
+ this should not be removed by hydration
+
+
+
+
+
+ this should not be removed by hydration
+
+
diff --git a/test/fixtures/basic/app/pages/client.vue b/test/fixtures/basic/app/pages/client.vue
new file mode 100644
index 000000000000..0ebc5decd7f0
--- /dev/null
+++ b/test/fixtures/basic/app/pages/client.vue
@@ -0,0 +1,75 @@
+
+
+
+
+ This page should not crash when rendered.
+
+ rendered client-side
+ Some slot content
+
+ This should render.
+
+
+ rendered client-side
+
+
+
+
+
+ i'm red
+
+
+
+
+ fallback for ClientOnly
+
+
+
+
+
+ This should be rendered client-side
+
+
+
+
+
+
+ i'm blue
+
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/components/nuxt-time.vue b/test/fixtures/basic/app/pages/components/nuxt-time.vue
new file mode 100644
index 000000000000..bdc258f1bb07
--- /dev/null
+++ b/test/fixtures/basic/app/pages/components/nuxt-time.vue
@@ -0,0 +1,59 @@
+
+
+
+
+
+ Switch locale
+
+
+ Update time
+
+
+
diff --git a/test/fixtures/basic/app/pages/composables/on-prehydrate.vue b/test/fixtures/basic/app/pages/composables/on-prehydrate.vue
new file mode 100644
index 000000000000..ceaf066aa790
--- /dev/null
+++ b/test/fixtures/basic/app/pages/composables/on-prehydrate.vue
@@ -0,0 +1,22 @@
+
+
+
+
+ onPrehydrate testing
+
+
diff --git a/test/fixtures/basic/app/pages/cookies-refresh.vue b/test/fixtures/basic/app/pages/cookies-refresh.vue
new file mode 100644
index 000000000000..3c9db5caa579
--- /dev/null
+++ b/test/fixtures/basic/app/pages/cookies-refresh.vue
@@ -0,0 +1,27 @@
+
+
+
+ cookies refresh test
+
diff --git a/test/fixtures/basic/app/pages/cookies.vue b/test/fixtures/basic/app/pages/cookies.vue
new file mode 100644
index 000000000000..22a34504cbc9
--- /dev/null
+++ b/test/fixtures/basic/app/pages/cookies.vue
@@ -0,0 +1,58 @@
+
+
+
+
+
cookies testing page
+
{{ objectCookie?.foo }}
+
{{ objectCookieSecond.foo }}
+
+ Change cookie
+
+
+ Refresh cookie
+
+
+
+
+ parent banner
+
+
+ Toggle cookie banner
+
+
diff --git a/packages/config/test/fixtures/store/index.js b/test/fixtures/basic/app/pages/empty.ts
similarity index 100%
rename from packages/config/test/fixtures/store/index.js
rename to test/fixtures/basic/app/pages/empty.ts
diff --git a/test/fixtures/basic/app/pages/env-name.vue b/test/fixtures/basic/app/pages/env-name.vue
new file mode 100644
index 000000000000..cad5603bc82d
--- /dev/null
+++ b/test/fixtures/basic/app/pages/env-name.vue
@@ -0,0 +1,9 @@
+
+
+
+
+ {{ envName }}
+
+
diff --git a/test/fixtures/basic/app/pages/error/error-boundary.vue b/test/fixtures/basic/app/pages/error/error-boundary.vue
new file mode 100644
index 000000000000..5a16a96d50e8
--- /dev/null
+++ b/test/fixtures/basic/app/pages/error/error-boundary.vue
@@ -0,0 +1,24 @@
+
+
+
+
+
+
+ This is the error rendering
+
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/error/index.vue b/test/fixtures/basic/app/pages/error/index.vue
new file mode 100644
index 000000000000..6695e1b96ab8
--- /dev/null
+++ b/test/fixtures/basic/app/pages/error/index.vue
@@ -0,0 +1,19 @@
+
+
+ {{ state.attr }}
+ {{ data.something }}
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/experimental/decorators.vue b/test/fixtures/basic/app/pages/experimental/decorators.vue
new file mode 100644
index 000000000000..dfe7a49fb73c
--- /dev/null
+++ b/test/fixtures/basic/app/pages/experimental/decorators.vue
@@ -0,0 +1,26 @@
+
+
+
+
+ {{ value }}-{{ data }}
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/experimental/node-compat.vue b/test/fixtures/basic/app/pages/experimental/node-compat.vue
new file mode 100644
index 000000000000..f6716b9c7ff6
--- /dev/null
+++ b/test/fixtures/basic/app/pages/experimental/node-compat.vue
@@ -0,0 +1,20 @@
+
+
+
+
+
+
+ {{ base64 }}
+
+
+ CWD: {{ cwd }}
+
+
+
diff --git a/test/fixtures/basic/app/pages/extends.vue b/test/fixtures/basic/app/pages/extends.vue
new file mode 100644
index 000000000000..f23f2988d001
--- /dev/null
+++ b/test/fixtures/basic/app/pages/extends.vue
@@ -0,0 +1,5 @@
+
+
+ {{ useOverridableComposable() }}
+
+
diff --git a/test/fixtures/basic/app/pages/fixed-keyed-child-parent.vue b/test/fixtures/basic/app/pages/fixed-keyed-child-parent.vue
new file mode 100644
index 000000000000..557fe9260e34
--- /dev/null
+++ b/test/fixtures/basic/app/pages/fixed-keyed-child-parent.vue
@@ -0,0 +1,6 @@
+
+
+ fixed-keyed-child-parent
+
+
diff --git a/test/fixtures/basic/app/pages/fixed-keyed-child-parent/[foo].vue b/test/fixtures/basic/app/pages/fixed-keyed-child-parent/[foo].vue
new file mode 100644
index 000000000000..bebfd82fb530
--- /dev/null
+++ b/test/fixtures/basic/app/pages/fixed-keyed-child-parent/[foo].vue
@@ -0,0 +1,19 @@
+
+
+ [fixed-keyed-child-parent/{{ route.params.foo }}]
+
+ To another
+
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/head-component.vue b/test/fixtures/basic/app/pages/head-component.vue
new file mode 100644
index 000000000000..1a97f144e804
--- /dev/null
+++ b/test/fixtures/basic/app/pages/head-component.vue
@@ -0,0 +1,15 @@
+
+
+
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/head-script-setup.vue b/test/fixtures/basic/app/pages/head-script-setup.vue
new file mode 100644
index 000000000000..aa653732f64b
--- /dev/null
+++ b/test/fixtures/basic/app/pages/head-script-setup.vue
@@ -0,0 +1,59 @@
+
+
+
+
+
head script setup
+
+
diff --git a/test/fixtures/basic/app/pages/head.vue b/test/fixtures/basic/app/pages/head.vue
new file mode 100644
index 000000000000..718d13af27ef
--- /dev/null
+++ b/test/fixtures/basic/app/pages/head.vue
@@ -0,0 +1,42 @@
+
+
+
+
+
+
Using a dynamic component
+
diff --git a/test/fixtures/basic/app/pages/hydration/layout.vue b/test/fixtures/basic/app/pages/hydration/layout.vue
new file mode 100644
index 000000000000..768f6e6b8bf9
--- /dev/null
+++ b/test/fixtures/basic/app/pages/hydration/layout.vue
@@ -0,0 +1,18 @@
+
+
+
+
+ Tests whether hydration is properly resolved within an async layout
+
+
diff --git a/test/fixtures/basic/app/pages/hydration/spa-redirection/end.vue b/test/fixtures/basic/app/pages/hydration/spa-redirection/end.vue
new file mode 100644
index 000000000000..0f117f8bbb12
--- /dev/null
+++ b/test/fixtures/basic/app/pages/hydration/spa-redirection/end.vue
@@ -0,0 +1,12 @@
+
+
+
+
+ {{ ready }}
+
+
diff --git a/test/fixtures/basic/app/pages/hydration/spa-redirection/start.vue b/test/fixtures/basic/app/pages/hydration/spa-redirection/start.vue
new file mode 100644
index 000000000000..221f7198343f
--- /dev/null
+++ b/test/fixtures/basic/app/pages/hydration/spa-redirection/start.vue
@@ -0,0 +1,11 @@
+
+
+
+
+ Tests whether hydration is properly resolved when loading
+
+
diff --git a/test/fixtures/basic/app/pages/ignore/composables.vue b/test/fixtures/basic/app/pages/ignore/composables.vue
new file mode 100644
index 000000000000..f2366fd50f76
--- /dev/null
+++ b/test/fixtures/basic/app/pages/ignore/composables.vue
@@ -0,0 +1,9 @@
+
+
+
+
+ was import ignored: {{ wasImportIgnored }}
+
+
diff --git a/test/fixtures/basic/app/pages/import-components/index.vue b/test/fixtures/basic/app/pages/import-components/index.vue
new file mode 100644
index 000000000000..8f1b927d3dfa
--- /dev/null
+++ b/test/fixtures/basic/app/pages/import-components/index.vue
@@ -0,0 +1,10 @@
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/index.vue b/test/fixtures/basic/app/pages/index.vue
new file mode 100644
index 000000000000..c30587f377c2
--- /dev/null
+++ b/test/fixtures/basic/app/pages/index.vue
@@ -0,0 +1,166 @@
+
+
+
+
Basic fixture
+
+
Hello Nuxt 3!
+
RuntimeConfig | testConfig: {{ config.public.testConfig }}
+
Composable | foo: {{ foo }}
+
Composable | bar: {{ bar }}
+
Composable | template: {{ templateAutoImport }}
+
Composable | star: {{ useNestedBar() }}
+
Some dev-only info
+
Some dev-only info
+
+ Dev-only with attributes
+
+
+
+ Some dev-only info
+
+ Some prod-only info
+
+
+
+
Path: {{ $route.fullPath }}
+
+ Link
+
+
+ Immediate remove unmounted
+
+
+ Chunk error
+
+
+ createClientOnly()
+
+
+ Middleware abort navigation
+
+
+ Middleware abort navigation with error
+
+ Some value: {{ someValue }}
+
+ Increment state
+
+
+ to no script
+
+
+
+
+
Test
+
+
+
+
+
+
+ to big 1
+
+
+ to page load hook
+
+
+
+ to redirect page with hash
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/inline-only-css.vue b/test/fixtures/basic/app/pages/inline-only-css.vue
new file mode 100644
index 000000000000..21b4da2af9db
--- /dev/null
+++ b/test/fixtures/basic/app/pages/inline-only-css.vue
@@ -0,0 +1,7 @@
+
+
+
+ {{ css }}
+
diff --git a/test/fixtures/basic/app/pages/instance/error.vue b/test/fixtures/basic/app/pages/instance/error.vue
new file mode 100644
index 000000000000..b55e11fe543d
--- /dev/null
+++ b/test/fixtures/basic/app/pages/instance/error.vue
@@ -0,0 +1,13 @@
+
+
+
+
+ This should not display.
+
+
diff --git a/test/fixtures/basic/app/pages/instance/next-request.vue b/test/fixtures/basic/app/pages/instance/next-request.vue
new file mode 100644
index 000000000000..aae0babf8ff2
--- /dev/null
+++ b/test/fixtures/basic/app/pages/instance/next-request.vue
@@ -0,0 +1,15 @@
+
+
+
+
+ This should be false: {{ $wasVueAppInstanceWronglyPreserved }}
+ This should be true: {{ isSameApp }}
+
+
diff --git a/test/fixtures/basic/app/pages/internal-layout.vue b/test/fixtures/basic/app/pages/internal-layout.vue
new file mode 100644
index 000000000000..ca9958a983c9
--- /dev/null
+++ b/test/fixtures/basic/app/pages/internal-layout.vue
@@ -0,0 +1,15 @@
+
+
+
+
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/invalid-root/1.vue b/test/fixtures/basic/app/pages/invalid-root/1.vue
new file mode 100644
index 000000000000..908dc5c7c4f4
--- /dev/null
+++ b/test/fixtures/basic/app/pages/invalid-root/1.vue
@@ -0,0 +1,4 @@
+
+
+ Test
+
diff --git a/test/fixtures/basic/app/pages/invalid-root/2.vue b/test/fixtures/basic/app/pages/invalid-root/2.vue
new file mode 100644
index 000000000000..3d0c728a380e
--- /dev/null
+++ b/test/fixtures/basic/app/pages/invalid-root/2.vue
@@ -0,0 +1,5 @@
+
+
+
+ Just some text
+
diff --git a/test/fixtures/basic/app/pages/invalid-root/3.vue b/test/fixtures/basic/app/pages/invalid-root/3.vue
new file mode 100644
index 000000000000..1ca7dbd1e679
--- /dev/null
+++ b/test/fixtures/basic/app/pages/invalid-root/3.vue
@@ -0,0 +1,5 @@
+
+
+ Multiple
+ elements
+
diff --git a/test/fixtures/basic/app/pages/invalid-root/4.vue b/test/fixtures/basic/app/pages/invalid-root/4.vue
new file mode 100644
index 000000000000..133c2c07f89c
--- /dev/null
+++ b/test/fixtures/basic/app/pages/invalid-root/4.vue
@@ -0,0 +1,7 @@
+
+ Fine
+
+
+
diff --git a/test/fixtures/basic/app/pages/invalid-root/fine.vue b/test/fixtures/basic/app/pages/invalid-root/fine.vue
new file mode 100644
index 000000000000..8a9341c99ee8
--- /dev/null
+++ b/test/fixtures/basic/app/pages/invalid-root/fine.vue
@@ -0,0 +1,12 @@
+
+
+
+ Multiple
+ elements
+
+
+
diff --git a/test/fixtures/basic/app/pages/isr.vue b/test/fixtures/basic/app/pages/isr.vue
new file mode 100644
index 000000000000..8545426d3fda
--- /dev/null
+++ b/test/fixtures/basic/app/pages/isr.vue
@@ -0,0 +1,12 @@
+
+
+
ISR Page
+
+ {{ data }}
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/json-payload.vue b/test/fixtures/basic/app/pages/json-payload.vue
new file mode 100644
index 000000000000..586db8fe3317
--- /dev/null
+++ b/test/fixtures/basic/app/pages/json-payload.vue
@@ -0,0 +1,34 @@
+
+
+
+
+
{{ state }}
+ Date: {{ state.date instanceof Date }}
+ BigInt: {{ nonDisplayedState.bigint === 0n }}
+ Error: {{ isNuxtError(state.error) }}
+ Shallow reactive: {{ isReactive(state.shallowReactive) && isShallow(state.shallowReactive) }}
+ Shallow ref: {{ isShallow(state.shallowRef) }}
+ Undefined ref: {{ isRef(state.undefined) }}
+ BigInt ref: {{ isRef(nonDisplayedState.bigintRef) && typeof nonDisplayedState.bigintRef.value === 'bigint' }}
+ Reactive: {{ isReactive(state.reactive) }}
+ Ref: {{ isRef(state.ref) }}
+ Recursive objects: {{ state.ref === state.shallowReactive.nested.ref }}
+
diff --git a/test/fixtures/basic/app/pages/jsx.vue b/test/fixtures/basic/app/pages/jsx.vue
new file mode 100644
index 000000000000..8441c33671c4
--- /dev/null
+++ b/test/fixtures/basic/app/pages/jsx.vue
@@ -0,0 +1,5 @@
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/keepalive.vue b/test/fixtures/basic/app/pages/keepalive.vue
new file mode 100644
index 000000000000..fdaa673a9469
--- /dev/null
+++ b/test/fixtures/basic/app/pages/keepalive.vue
@@ -0,0 +1,26 @@
+
+
+
+
+
Keepalive Test
+
+ Keepalive Home
+
+
+
+ {{ link }}
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/keepalive/keepalive-in-config.vue b/test/fixtures/basic/app/pages/keepalive/keepalive-in-config.vue
new file mode 100644
index 000000000000..6745b3870955
--- /dev/null
+++ b/test/fixtures/basic/app/pages/keepalive/keepalive-in-config.vue
@@ -0,0 +1,13 @@
+
+
+
+
+
Keepalive in Config
+
+
diff --git a/test/fixtures/basic/app/pages/keepalive/keepalive-in-nuxtpage-2.vue b/test/fixtures/basic/app/pages/keepalive/keepalive-in-nuxtpage-2.vue
new file mode 100644
index 000000000000..d7a2e957ec12
--- /dev/null
+++ b/test/fixtures/basic/app/pages/keepalive/keepalive-in-nuxtpage-2.vue
@@ -0,0 +1,13 @@
+
+
+
+
+
Keepalive in `nuxt-page` 2
+
+
diff --git a/test/fixtures/basic/app/pages/keepalive/keepalive-in-nuxtpage.vue b/test/fixtures/basic/app/pages/keepalive/keepalive-in-nuxtpage.vue
new file mode 100644
index 000000000000..aff8a937a585
--- /dev/null
+++ b/test/fixtures/basic/app/pages/keepalive/keepalive-in-nuxtpage.vue
@@ -0,0 +1,13 @@
+
+
+
+
+
Keepalive in `nuxt-page`
+
+
diff --git a/test/fixtures/basic/app/pages/keepalive/not-keepalive-in-nuxtpage.vue b/test/fixtures/basic/app/pages/keepalive/not-keepalive-in-nuxtpage.vue
new file mode 100644
index 000000000000..ebf1b581415d
--- /dev/null
+++ b/test/fixtures/basic/app/pages/keepalive/not-keepalive-in-nuxtpage.vue
@@ -0,0 +1,13 @@
+
+
+
+
+
Not Keepalive in `nuxt-page`
+
+
diff --git a/test/fixtures/basic/app/pages/keepalive/not-keepalive.vue b/test/fixtures/basic/app/pages/keepalive/not-keepalive.vue
new file mode 100644
index 000000000000..3fdbbd042557
--- /dev/null
+++ b/test/fixtures/basic/app/pages/keepalive/not-keepalive.vue
@@ -0,0 +1,9 @@
+
+
+
+
+
Not Keepalive
+
+
diff --git a/test/fixtures/basic/app/pages/keyed-child-parent.vue b/test/fixtures/basic/app/pages/keyed-child-parent.vue
new file mode 100644
index 000000000000..1151f3b32314
--- /dev/null
+++ b/test/fixtures/basic/app/pages/keyed-child-parent.vue
@@ -0,0 +1,6 @@
+
+
+ keyed-child-parent
+
+
diff --git a/test/fixtures/basic/app/pages/keyed-child-parent/[foo].vue b/test/fixtures/basic/app/pages/keyed-child-parent/[foo].vue
new file mode 100644
index 000000000000..bccd296ee589
--- /dev/null
+++ b/test/fixtures/basic/app/pages/keyed-child-parent/[foo].vue
@@ -0,0 +1,19 @@
+
+
+ [keyed-child-parent/{{ route.params.foo }}]
+
+ To another
+
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/keyed-composables/barrel-import.vue b/test/fixtures/basic/app/pages/keyed-composables/barrel-import.vue
new file mode 100644
index 000000000000..2018d5737d94
--- /dev/null
+++ b/test/fixtures/basic/app/pages/keyed-composables/barrel-import.vue
@@ -0,0 +1,11 @@
+
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/keyed-composables/index.vue b/test/fixtures/basic/app/pages/keyed-composables/index.vue
new file mode 100644
index 000000000000..82ca7edb44fe
--- /dev/null
+++ b/test/fixtures/basic/app/pages/keyed-composables/index.vue
@@ -0,0 +1,67 @@
+
+
+
+
+ {{ useStateTest1 === useStateTest2 }}
+ {{ useAsyncDataTest1 === useAsyncDataTest2 }}
+ {{ useLazyAsyncDataTest1 === useLazyAsyncDataTest2 }}
+ {{ useFetchTest1 === useFetchTest2 }}
+ {{ useLazyFetchTest1 === useLazyFetchTest2 }}
+ {{ !!useMyAsyncDataTest1 && useMyAsyncDataTest1 === useMyAsyncDataTest2 }}
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/keyed-composables/local.vue b/test/fixtures/basic/app/pages/keyed-composables/local.vue
new file mode 100644
index 000000000000..021bab3f226c
--- /dev/null
+++ b/test/fixtures/basic/app/pages/keyed-composables/local.vue
@@ -0,0 +1,68 @@
+
+
+
+
+ {{ skippedLocalScopedComposables }}
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/layout-switch/end.vue b/test/fixtures/basic/app/pages/layout-switch/end.vue
new file mode 100644
index 000000000000..b6c96ff3b345
--- /dev/null
+++ b/test/fixtures/basic/app/pages/layout-switch/end.vue
@@ -0,0 +1,3 @@
+
+
+
diff --git a/test/fixtures/basic/app/pages/layout-switch/start.vue b/test/fixtures/basic/app/pages/layout-switch/start.vue
new file mode 100644
index 000000000000..4dc0939ac2a1
--- /dev/null
+++ b/test/fixtures/basic/app/pages/layout-switch/start.vue
@@ -0,0 +1,13 @@
+
+
+
+ Switch layout
+
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/layouts/with-props.vue b/test/fixtures/basic/app/pages/layouts/with-props.vue
new file mode 100644
index 000000000000..d93aa9df4ee1
--- /dev/null
+++ b/test/fixtures/basic/app/pages/layouts/with-props.vue
@@ -0,0 +1,18 @@
+
+
+
+
+
+
+ some page content
+
+
+
diff --git a/test/fixtures/basic/app/pages/lazy-import-components/delayed-hydration/index.vue b/test/fixtures/basic/app/pages/lazy-import-components/delayed-hydration/index.vue
new file mode 100644
index 000000000000..363d2f3f628b
--- /dev/null
+++ b/test/fixtures/basic/app/pages/lazy-import-components/delayed-hydration/index.vue
@@ -0,0 +1,60 @@
+
+
+ hydrate-on-interaction-default:
+
+ event-view-normal-component:
+
+ hydrate-on-visible:
+
+ hydrate-never:
+
+ hydrate-on-interaction-click:
+
+ hydrate-when-always:
+
+ button-increase-state:
+
+ Increase state
+
+ hydrate-when-state:
+
+ hydrate-on-idle:
+
+
+ This is a very tall div
+
+ hydrate-on-visible-bottom:
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/lazy-import-components/delayed-hydration/macro/index.vue b/test/fixtures/basic/app/pages/lazy-import-components/delayed-hydration/macro/index.vue
new file mode 100644
index 000000000000..a8c0c6d1701c
--- /dev/null
+++ b/test/fixtures/basic/app/pages/lazy-import-components/delayed-hydration/macro/index.vue
@@ -0,0 +1,54 @@
+
+
+ hydrate-on-visible:
+
+ hydrate-on-idle:
+
+ hydrate-on-interaction-default:
+
+ hydrate-on-interaction-click:
+
+ hydrate-on-media-query:
+
+ hydrate-when-always:
+
+ hydrate-when-state:
+
+ Increase state
+
+
+ hydrate-never:
+
+
+ This is a very tall div
+
+ hydrate-on-visible-bottom:
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/lazy-import-components/delayed-hydration/macro/model-event.vue b/test/fixtures/basic/app/pages/lazy-import-components/delayed-hydration/macro/model-event.vue
new file mode 100644
index 000000000000..8425d5f0b0d2
--- /dev/null
+++ b/test/fixtures/basic/app/pages/lazy-import-components/delayed-hydration/macro/model-event.vue
@@ -0,0 +1,17 @@
+
+
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/lazy-import-components/delayed-hydration/macro/time.vue b/test/fixtures/basic/app/pages/lazy-import-components/delayed-hydration/macro/time.vue
new file mode 100644
index 000000000000..147b3b28bb71
--- /dev/null
+++ b/test/fixtures/basic/app/pages/lazy-import-components/delayed-hydration/macro/time.vue
@@ -0,0 +1,17 @@
+
+
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/lazy-import-components/delayed-hydration/model-event.vue b/test/fixtures/basic/app/pages/lazy-import-components/delayed-hydration/model-event.vue
new file mode 100644
index 000000000000..902c32f03bfc
--- /dev/null
+++ b/test/fixtures/basic/app/pages/lazy-import-components/delayed-hydration/model-event.vue
@@ -0,0 +1,16 @@
+
+
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/lazy-import-components/delayed-hydration/time.vue b/test/fixtures/basic/app/pages/lazy-import-components/delayed-hydration/time.vue
new file mode 100644
index 000000000000..0a404c0d57f4
--- /dev/null
+++ b/test/fixtures/basic/app/pages/lazy-import-components/delayed-hydration/time.vue
@@ -0,0 +1,8 @@
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/lazy-import-components/index.vue b/test/fixtures/basic/app/pages/lazy-import-components/index.vue
new file mode 100644
index 000000000000..0f46fc9dfc61
--- /dev/null
+++ b/test/fixtures/basic/app/pages/lazy-import-components/index.vue
@@ -0,0 +1,7 @@
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/legacy-async-data-fail.vue b/test/fixtures/basic/app/pages/legacy-async-data-fail.vue
new file mode 100644
index 000000000000..ef8a546a81cb
--- /dev/null
+++ b/test/fixtures/basic/app/pages/legacy-async-data-fail.vue
@@ -0,0 +1,13 @@
+
+
+ don't look at this
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/meta.vue b/test/fixtures/basic/app/pages/meta.vue
new file mode 100644
index 000000000000..1a3efea59939
--- /dev/null
+++ b/test/fixtures/basic/app/pages/meta.vue
@@ -0,0 +1,38 @@
+
+
+
+ {{ serialisedMeta }}
+
diff --git a/test/fixtures/basic/app/pages/middleware-abort-non-fatal.vue b/test/fixtures/basic/app/pages/middleware-abort-non-fatal.vue
new file mode 100644
index 000000000000..17f931cf8ba0
--- /dev/null
+++ b/test/fixtures/basic/app/pages/middleware-abort-non-fatal.vue
@@ -0,0 +1,15 @@
+
+
+ you should not see me
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/middleware-abort.vue b/test/fixtures/basic/app/pages/middleware-abort.vue
new file mode 100644
index 000000000000..bd3879cad065
--- /dev/null
+++ b/test/fixtures/basic/app/pages/middleware-abort.vue
@@ -0,0 +1,18 @@
+
+
+
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/namespace-nuxt-app.vue b/test/fixtures/basic/app/pages/namespace-nuxt-app.vue
new file mode 100644
index 000000000000..66a5a0d05fe6
--- /dev/null
+++ b/test/fixtures/basic/app/pages/namespace-nuxt-app.vue
@@ -0,0 +1,10 @@
+
+
+
+ Nuxt instance available
+
diff --git a/test/fixtures/basic/app/pages/navigate-to-api.vue b/test/fixtures/basic/app/pages/navigate-to-api.vue
new file mode 100644
index 000000000000..2fbb0c469dcb
--- /dev/null
+++ b/test/fixtures/basic/app/pages/navigate-to-api.vue
@@ -0,0 +1,7 @@
+
+ You should not see me
+
+
+
diff --git a/test/fixtures/basic/app/pages/navigate-to-error.vue b/test/fixtures/basic/app/pages/navigate-to-error.vue
new file mode 100644
index 000000000000..ce6dd3d31a8e
--- /dev/null
+++ b/test/fixtures/basic/app/pages/navigate-to-error.vue
@@ -0,0 +1,16 @@
+
+ You should not see me
+
+
+
diff --git a/test/fixtures/basic/app/pages/navigate-to-external-encode.vue b/test/fixtures/basic/app/pages/navigate-to-external-encode.vue
new file mode 100644
index 000000000000..c8126da09447
--- /dev/null
+++ b/test/fixtures/basic/app/pages/navigate-to-external-encode.vue
@@ -0,0 +1,7 @@
+
+ You should not see me
+
+
+
diff --git a/test/fixtures/basic/app/pages/navigate-to-external.vue b/test/fixtures/basic/app/pages/navigate-to-external.vue
new file mode 100644
index 000000000000..2853412703f8
--- /dev/null
+++ b/test/fixtures/basic/app/pages/navigate-to-external.vue
@@ -0,0 +1,12 @@
+
+ You should not see me
+
+
+
diff --git a/test/fixtures/basic/app/pages/navigate-to-forbidden.vue b/test/fixtures/basic/app/pages/navigate-to-forbidden.vue
new file mode 100644
index 000000000000..264923e65a5b
--- /dev/null
+++ b/test/fixtures/basic/app/pages/navigate-to-forbidden.vue
@@ -0,0 +1,18 @@
+
+
+
navigate-to-forbidden.vue
+
+ should throw a 404 error
+
+
+ should be caught by catchall
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/navigate-to-redirect.vue b/test/fixtures/basic/app/pages/navigate-to-redirect.vue
new file mode 100644
index 000000000000..36745a646a3b
--- /dev/null
+++ b/test/fixtures/basic/app/pages/navigate-to-redirect.vue
@@ -0,0 +1,18 @@
+
+ You should not see me
+
+
+
diff --git a/test/fixtures/basic/app/pages/navigate-to-validate-custom-error.vue b/test/fixtures/basic/app/pages/navigate-to-validate-custom-error.vue
new file mode 100644
index 000000000000..bfd392448d55
--- /dev/null
+++ b/test/fixtures/basic/app/pages/navigate-to-validate-custom-error.vue
@@ -0,0 +1,14 @@
+
+
+
navigate-to-validate-custom-error.vue
+
+ should throw a 401 error with custom message
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/navigate-to.vue b/test/fixtures/basic/app/pages/navigate-to.vue
new file mode 100644
index 000000000000..f06b1c4182fc
--- /dev/null
+++ b/test/fixtures/basic/app/pages/navigate-to.vue
@@ -0,0 +1,7 @@
+
+ You should not see me
+
+
+
diff --git a/test/fixtures/basic/app/pages/nested-group/(deep-group)/group-page.vue b/test/fixtures/basic/app/pages/nested-group/(deep-group)/group-page.vue
new file mode 100644
index 000000000000..3319baeb2f9b
--- /dev/null
+++ b/test/fixtures/basic/app/pages/nested-group/(deep-group)/group-page.vue
@@ -0,0 +1,5 @@
+
+
+ Page deep in group
+
+
diff --git a/test/fixtures/basic/app/pages/nested-group/(index-group)/index.vue b/test/fixtures/basic/app/pages/nested-group/(index-group)/index.vue
new file mode 100644
index 000000000000..b0555ed6f4ba
--- /dev/null
+++ b/test/fixtures/basic/app/pages/nested-group/(index-group)/index.vue
@@ -0,0 +1,5 @@
+
+
+ Index page of a group
+
+
diff --git a/test/fixtures/basic/app/pages/nested-group/more-nested/(more-deep)/group-page.vue b/test/fixtures/basic/app/pages/nested-group/more-nested/(more-deep)/group-page.vue
new file mode 100644
index 000000000000..70c10786aeee
--- /dev/null
+++ b/test/fixtures/basic/app/pages/nested-group/more-nested/(more-deep)/group-page.vue
@@ -0,0 +1,5 @@
+
+
+ Page deep, deep in group
+
+
diff --git a/test/fixtures/basic/app/pages/nested/[foo].vue b/test/fixtures/basic/app/pages/nested/[foo].vue
new file mode 100644
index 000000000000..1afdd3b4ab3b
--- /dev/null
+++ b/test/fixtures/basic/app/pages/nested/[foo].vue
@@ -0,0 +1,21 @@
+
+
+
+
+
nested/[foo]/index.vue
+
foo: {{ route.params.foo }}
+
+
+
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/nested/[foo]/[bar].vue b/test/fixtures/basic/app/pages/nested/[foo]/[bar].vue
new file mode 100644
index 000000000000..6e35b8776581
--- /dev/null
+++ b/test/fixtures/basic/app/pages/nested/[foo]/[bar].vue
@@ -0,0 +1,23 @@
+
+
+
+
+
nested/[foo]/[bar].vue
+
foo: {{ route.params.foo }}
+
bar: {{ route.params.bar }}
+
+ to /nested/foo/user-test
+
+
+ to /nested/foo/test
+
+
diff --git a/test/fixtures/basic/app/pages/nested/[foo]/user-[group].vue b/test/fixtures/basic/app/pages/nested/[foo]/user-[group].vue
new file mode 100644
index 000000000000..782a8624d5c7
--- /dev/null
+++ b/test/fixtures/basic/app/pages/nested/[foo]/user-[group].vue
@@ -0,0 +1,24 @@
+
+
+
+
+
nested/[foo]/user-[group].vue
+
foo: {{ route.params.foo }}
+
group: {{ route.params.group }}
+
+
+ to /nested/foo/user-test
+
+
+ to /nested/foo/test
+
+
diff --git a/test/fixtures/basic/app/pages/no-auth.vue b/test/fixtures/basic/app/pages/no-auth.vue
new file mode 100644
index 000000000000..f954403c63b0
--- /dev/null
+++ b/test/fixtures/basic/app/pages/no-auth.vue
@@ -0,0 +1,13 @@
+
+
+
+
+
no-auth.vue
+
auth: {{ $route.meta.auth }}
+
diff --git a/test/fixtures/basic/app/pages/no-scripts.vue b/test/fixtures/basic/app/pages/no-scripts.vue
new file mode 100644
index 000000000000..a2d01e200c1c
--- /dev/null
+++ b/test/fixtures/basic/app/pages/no-scripts.vue
@@ -0,0 +1,12 @@
+
+
+ {{ count }}
+
+ ++
+
+
+
+
+
diff --git "a/test/fixtures/basic/app/pages/non-ascii/\303\247.vue" "b/test/fixtures/basic/app/pages/non-ascii/\303\247.vue"
new file mode 100644
index 000000000000..047335e97111
--- /dev/null
+++ "b/test/fixtures/basic/app/pages/non-ascii/\303\247.vue"
@@ -0,0 +1,8 @@
+
+
+
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/nuxt-link/custom-external.vue b/test/fixtures/basic/app/pages/nuxt-link/custom-external.vue
new file mode 100644
index 000000000000..4dff81fb0d8b
--- /dev/null
+++ b/test/fixtures/basic/app/pages/nuxt-link/custom-external.vue
@@ -0,0 +1,53 @@
+
+
+
+
+
+
+ Trailing slashes should not be applied to implicit external links
+
+
+
+
+ External links within route objects should be respected and not have trailing slashes applied
+
+
+
+
+ External links within route objects should be respected and have trailing slashes applied
+
+
+
+
+ External links should be respected and have trailing slashes applied
+
+
+
+
+
+
+ Using navigate() with external link should work
+
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/nuxt-link/trailing-slash.vue b/test/fixtures/basic/app/pages/nuxt-link/trailing-slash.vue
new file mode 100644
index 000000000000..d867e5a2ac83
--- /dev/null
+++ b/test/fixtures/basic/app/pages/nuxt-link/trailing-slash.vue
@@ -0,0 +1,116 @@
+
+
+
+
+
+
+ {{ windowState }}
+
+
+
+
+
+
+ {{ href }}
+
+
+
+
+
+
+
+
+
+ {{ href }}
+
+
+
+
+
+
+
+
+
+ {{ href }}
+
+
+
+
+
+
+
+
+
+ {{ href }}
+
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/nuxt-link/use-link.vue b/test/fixtures/basic/app/pages/nuxt-link/use-link.vue
new file mode 100644
index 000000000000..21f0ac5592fa
--- /dev/null
+++ b/test/fixtures/basic/app/pages/nuxt-link/use-link.vue
@@ -0,0 +1,53 @@
+
+
+
+
+
useLink in NuxtLink: {{ useLinkPresent }}
+
route using useLink: {{ route }}
+
href using useLink: {{ href }}
+
+ Test
+
+
useLink2 in NuxtLink: {{ useLink2Present }}
+
route2 using useLink: {{ route2 }}
+
href2 using useLink: {{ href2 }}
+
+ Test
+
+
useLink3 in NuxtLink: {{ useLink3Present }}
+
route3 using useLink: {{ route3 }}
+
href3 using useLink: {{ href3 }}
+
+ Test
+
+
diff --git a/test/fixtures/basic/app/pages/nuxt-teleport.vue b/test/fixtures/basic/app/pages/nuxt-teleport.vue
new file mode 100644
index 000000000000..706c52bd2905
--- /dev/null
+++ b/test/fixtures/basic/app/pages/nuxt-teleport.vue
@@ -0,0 +1,8 @@
+
+
+
+ Nuxt Teleport
+
+
Normal content
+
diff --git a/test/fixtures/basic/app/pages/once-nav-initial.vue b/test/fixtures/basic/app/pages/once-nav-initial.vue
new file mode 100644
index 000000000000..475d2a4617a1
--- /dev/null
+++ b/test/fixtures/basic/app/pages/once-nav-initial.vue
@@ -0,0 +1,14 @@
+
+
+
+
+
once.vue
+
once: {{ counter }}
+
diff --git a/test/fixtures/basic/app/pages/once.vue b/test/fixtures/basic/app/pages/once.vue
new file mode 100644
index 000000000000..963014ee7f57
--- /dev/null
+++ b/test/fixtures/basic/app/pages/once.vue
@@ -0,0 +1,14 @@
+
+
+
+
+
once.vue
+
once: {{ counter }}
+
diff --git a/test/fixtures/basic/app/pages/page-load-hook.vue b/test/fixtures/basic/app/pages/page-load-hook.vue
new file mode 100644
index 000000000000..867cf5f0972d
--- /dev/null
+++ b/test/fixtures/basic/app/pages/page-load-hook.vue
@@ -0,0 +1,9 @@
+
+
+ Page for hook tests.
+
+ To sub page
+
+
+
diff --git a/test/fixtures/basic/app/pages/page-load-hook/[slug].vue b/test/fixtures/basic/app/pages/page-load-hook/[slug].vue
new file mode 100644
index 000000000000..6bb96bf43e5d
--- /dev/null
+++ b/test/fixtures/basic/app/pages/page-load-hook/[slug].vue
@@ -0,0 +1,7 @@
+
+
+
+ Back to parent
+
+
+
diff --git a/test/fixtures/basic/app/pages/parent.vue b/test/fixtures/basic/app/pages/parent.vue
new file mode 100644
index 000000000000..0abc4bd86d18
--- /dev/null
+++ b/test/fixtures/basic/app/pages/parent.vue
@@ -0,0 +1,6 @@
+
+
+ parent
+
+
diff --git a/test/fixtures/basic/app/pages/parent/index.vue b/test/fixtures/basic/app/pages/parent/index.vue
new file mode 100644
index 000000000000..dc432ffc8879
--- /dev/null
+++ b/test/fixtures/basic/app/pages/parent/index.vue
@@ -0,0 +1,5 @@
+
+
+ parent/index
+
+
diff --git a/test/fixtures/basic/app/pages/plugins.vue b/test/fixtures/basic/app/pages/plugins.vue
new file mode 100644
index 000000000000..1b8a0285c177
--- /dev/null
+++ b/test/fixtures/basic/app/pages/plugins.vue
@@ -0,0 +1,6 @@
+
+
+
myPlugin: {{ $myPlugin() }}
+
asyncPlugin: {{ $asyncPlugin() }}
+
diff --git a/test/fixtures/basic/app/pages/prefetch/components.vue b/test/fixtures/basic/app/pages/prefetch/components.vue
new file mode 100644
index 000000000000..6b9fe525f0eb
--- /dev/null
+++ b/test/fixtures/basic/app/pages/prefetch/components.vue
@@ -0,0 +1,9 @@
+
+
+
+
+ Testing prefetching global components
+
+
diff --git a/test/fixtures/basic/app/pages/prefetch/index.vue b/test/fixtures/basic/app/pages/prefetch/index.vue
new file mode 100644
index 000000000000..d2d7b6b254d3
--- /dev/null
+++ b/test/fixtures/basic/app/pages/prefetch/index.vue
@@ -0,0 +1,7 @@
+
+
+
+ Server components page
+
+
+
diff --git a/test/fixtures/basic/app/pages/prefetch/server-components.vue b/test/fixtures/basic/app/pages/prefetch/server-components.vue
new file mode 100644
index 000000000000..89bd1b11bc7b
--- /dev/null
+++ b/test/fixtures/basic/app/pages/prefetch/server-components.vue
@@ -0,0 +1,15 @@
+
+
+
+
+ Testing prefetching server components:
+
+
+
diff --git a/test/fixtures/basic/app/pages/prerender/loop-bare-fetch.vue b/test/fixtures/basic/app/pages/prerender/loop-bare-fetch.vue
new file mode 100644
index 000000000000..b381414dff94
--- /dev/null
+++ b/test/fixtures/basic/app/pages/prerender/loop-bare-fetch.vue
@@ -0,0 +1,3 @@
+
+ loop-bare-fetch ok
+
diff --git a/test/fixtures/basic/app/pages/prerender/loop-self.vue b/test/fixtures/basic/app/pages/prerender/loop-self.vue
new file mode 100644
index 000000000000..a8d3afbbdaaa
--- /dev/null
+++ b/test/fixtures/basic/app/pages/prerender/loop-self.vue
@@ -0,0 +1,3 @@
+
+ loop-self ok
+
diff --git a/test/fixtures/basic/app/pages/prerender/loop-shared-a.vue b/test/fixtures/basic/app/pages/prerender/loop-shared-a.vue
new file mode 100644
index 000000000000..42a7e8fe65f6
--- /dev/null
+++ b/test/fixtures/basic/app/pages/prerender/loop-shared-a.vue
@@ -0,0 +1,3 @@
+
+ loop-shared-a ok
+
diff --git a/test/fixtures/basic/app/pages/prerender/loop-shared-b.vue b/test/fixtures/basic/app/pages/prerender/loop-shared-b.vue
new file mode 100644
index 000000000000..30f25cb45ab8
--- /dev/null
+++ b/test/fixtures/basic/app/pages/prerender/loop-shared-b.vue
@@ -0,0 +1,3 @@
+
+ loop-shared-b ok
+
diff --git a/test/fixtures/basic/app/pages/prerender/query-reactivity.vue b/test/fixtures/basic/app/pages/prerender/query-reactivity.vue
new file mode 100644
index 000000000000..b28c1aa52233
--- /dev/null
+++ b/test/fixtures/basic/app/pages/prerender/query-reactivity.vue
@@ -0,0 +1,9 @@
+
+
+
+
+ Query: {{ route.query.active }}
+
+
diff --git a/test/fixtures/basic/app/pages/prerender/test.vue b/test/fixtures/basic/app/pages/prerender/test.vue
new file mode 100644
index 000000000000..8da7b99a6b9a
--- /dev/null
+++ b/test/fixtures/basic/app/pages/prerender/test.vue
@@ -0,0 +1,9 @@
+
+
+
+
+ should be prerendered: {{ wasPrerendered }}
+
+
diff --git "a/test/fixtures/basic/app/pages/prerender/\303\247.vue" "b/test/fixtures/basic/app/pages/prerender/\303\247.vue"
new file mode 100644
index 000000000000..8da7b99a6b9a
--- /dev/null
+++ "b/test/fixtures/basic/app/pages/prerender/\303\247.vue"
@@ -0,0 +1,9 @@
+
+
+
+
+ should be prerendered: {{ wasPrerendered }}
+
+
diff --git a/test/fixtures/basic/app/pages/preview/index.vue b/test/fixtures/basic/app/pages/preview/index.vue
new file mode 100644
index 000000000000..ce33ac9cd570
--- /dev/null
+++ b/test/fixtures/basic/app/pages/preview/index.vue
@@ -0,0 +1,38 @@
+
+
+
+
+
+ check useFetch
+
+
+
+ fetched on client
+
+
+
+ preview mode enabled
+
+
diff --git a/test/fixtures/basic/app/pages/preview/with-custom-enable.vue b/test/fixtures/basic/app/pages/preview/with-custom-enable.vue
new file mode 100644
index 000000000000..711457eb7c8d
--- /dev/null
+++ b/test/fixtures/basic/app/pages/preview/with-custom-enable.vue
@@ -0,0 +1,17 @@
+
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/preview/with-custom-state.vue b/test/fixtures/basic/app/pages/preview/with-custom-state.vue
new file mode 100644
index 000000000000..1d5a72e8c888
--- /dev/null
+++ b/test/fixtures/basic/app/pages/preview/with-custom-state.vue
@@ -0,0 +1,39 @@
+
+
+
+
+
+ fetch check
+
+
+
+ {{ state.data1 }}
+
+
+
+ {{ state.data2 }}
+
+
+
+ toggle preview mode
+
+
diff --git a/test/fixtures/basic/app/pages/preview/with-use-fetch.vue b/test/fixtures/basic/app/pages/preview/with-use-fetch.vue
new file mode 100644
index 000000000000..c0b2a2aae414
--- /dev/null
+++ b/test/fixtures/basic/app/pages/preview/with-use-fetch.vue
@@ -0,0 +1,25 @@
+
+
+
+
+
+ {{ enabled }}
+
+
+
+ {{ state.token }}
+
+
+
+ {{ data && data.hehe }}
+
+
diff --git a/test/fixtures/basic/app/pages/random/[id].vue b/test/fixtures/basic/app/pages/random/[id].vue
new file mode 100644
index 000000000000..240bf544e578
--- /dev/null
+++ b/test/fixtures/basic/app/pages/random/[id].vue
@@ -0,0 +1,70 @@
+
+
+
+ Home
+
+
+ Random (A)
+
+
+ Random (B)
+
+
+ Random (C)
+
+
+ Random (Japanese)
+
+
+
+
+ Random: {{ random }}
+
+ Random: (global) {{ globalRandom }}
+
+ Random page:
{{ route.params.id }}
+
+ Here are some random numbers for you:
+
+
+
+ Give me another set
+
+
+
+
+
+
diff --git "a/test/fixtures/basic/app/pages/random/\346\227\245\346\234\254\350\252\236.vue" "b/test/fixtures/basic/app/pages/random/\346\227\245\346\234\254\350\252\236.vue"
new file mode 100644
index 000000000000..1652d9dbe31d
--- /dev/null
+++ "b/test/fixtures/basic/app/pages/random/\346\227\245\346\234\254\350\252\236.vue"
@@ -0,0 +1,6 @@
+
+
+
Home
+
Japanese random route
+
diff --git a/test/fixtures/basic/app/pages/redirect-with-encode.vue b/test/fixtures/basic/app/pages/redirect-with-encode.vue
new file mode 100644
index 000000000000..fc96279bc26c
--- /dev/null
+++ b/test/fixtures/basic/app/pages/redirect-with-encode.vue
@@ -0,0 +1,9 @@
+
+
+ oh no !
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/redirect.vue b/test/fixtures/basic/app/pages/redirect.vue
new file mode 100644
index 000000000000..da7826f5a54b
--- /dev/null
+++ b/test/fixtures/basic/app/pages/redirect.vue
@@ -0,0 +1,11 @@
+
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/route-announcer.vue b/test/fixtures/basic/app/pages/route-announcer.vue
new file mode 100644
index 000000000000..c1a94410a52c
--- /dev/null
+++ b/test/fixtures/basic/app/pages/route-announcer.vue
@@ -0,0 +1,25 @@
+
+
+
+
+
+ Link
+
+
+ Button
+
+
+
diff --git a/test/fixtures/basic/app/pages/route-announcer2.vue b/test/fixtures/basic/app/pages/route-announcer2.vue
new file mode 100644
index 000000000000..f20269a7e6c4
--- /dev/null
+++ b/test/fixtures/basic/app/pages/route-announcer2.vue
@@ -0,0 +1,12 @@
+
+
+
+ Second page content
+
diff --git a/test/fixtures/basic/app/pages/route-provider/index.vue b/test/fixtures/basic/app/pages/route-provider/index.vue
new file mode 100644
index 000000000000..34b99200b709
--- /dev/null
+++ b/test/fixtures/basic/app/pages/route-provider/index.vue
@@ -0,0 +1,11 @@
+
+
+
+ foo
+
+
+ bar
+
+
+
diff --git a/test/fixtures/basic/app/pages/route-provider/index/bar.vue b/test/fixtures/basic/app/pages/route-provider/index/bar.vue
new file mode 100644
index 000000000000..425b5d3428ed
--- /dev/null
+++ b/test/fixtures/basic/app/pages/route-provider/index/bar.vue
@@ -0,0 +1,14 @@
+
+
+
+
+ bar: {{ $route.path }} - {{ route.path }}
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/route-provider/index/foo.vue b/test/fixtures/basic/app/pages/route-provider/index/foo.vue
new file mode 100644
index 000000000000..cc6f3268a778
--- /dev/null
+++ b/test/fixtures/basic/app/pages/route-provider/index/foo.vue
@@ -0,0 +1,14 @@
+
+
+
+
+ foo: {{ $route.path }} - {{ route.path }}
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/route-rules/inline.vue b/test/fixtures/basic/app/pages/route-rules/inline.vue
new file mode 100644
index 000000000000..52a5dda9d2d0
--- /dev/null
+++ b/test/fixtures/basic/app/pages/route-rules/inline.vue
@@ -0,0 +1,13 @@
+
+
+
+
+ Route rules defined inline
+
+
diff --git a/test/fixtures/basic/app/pages/route-rules/layout.vue b/test/fixtures/basic/app/pages/route-rules/layout.vue
new file mode 100644
index 000000000000..a7544c56e0ce
--- /dev/null
+++ b/test/fixtures/basic/app/pages/route-rules/layout.vue
@@ -0,0 +1,5 @@
+
+
+
Should use layout set in route-rules
+
diff --git a/test/fixtures/basic/app/pages/route-rules/middleware.vue b/test/fixtures/basic/app/pages/route-rules/middleware.vue
new file mode 100644
index 000000000000..c1d69e15147a
--- /dev/null
+++ b/test/fixtures/basic/app/pages/route-rules/middleware.vue
@@ -0,0 +1,5 @@
+
+
+
Greeting: {{ $route.meta.hello }}
+
diff --git a/test/fixtures/basic/app/pages/route-rules/redirect.vue b/test/fixtures/basic/app/pages/route-rules/redirect.vue
new file mode 100644
index 000000000000..b8a3920f0221
--- /dev/null
+++ b/test/fixtures/basic/app/pages/route-rules/redirect.vue
@@ -0,0 +1,5 @@
+
+
+ Should be redirected
+
+
diff --git a/test/fixtures/basic/app/pages/route-rules/spa-async-data.vue b/test/fixtures/basic/app/pages/route-rules/spa-async-data.vue
new file mode 100644
index 000000000000..486c810a79ce
--- /dev/null
+++ b/test/fixtures/basic/app/pages/route-rules/spa-async-data.vue
@@ -0,0 +1,9 @@
+
+
+
+ spa-async-data: {{ data }}
+
diff --git a/test/fixtures/basic/app/pages/route-rules/spa.vue b/test/fixtures/basic/app/pages/route-rules/spa.vue
new file mode 100644
index 000000000000..6777da5c5378
--- /dev/null
+++ b/test/fixtures/basic/app/pages/route-rules/spa.vue
@@ -0,0 +1,5 @@
+
+
+ should not be rendered on ssr
+
+
diff --git a/test/fixtures/basic/app/pages/route-rules/swr-in-spa.vue b/test/fixtures/basic/app/pages/route-rules/swr-in-spa.vue
new file mode 100644
index 000000000000..f9d51ba8f9c6
--- /dev/null
+++ b/test/fixtures/basic/app/pages/route-rules/swr-in-spa.vue
@@ -0,0 +1,10 @@
+
+
+
SWR-in-SPA Page
+
{{ data }}
+
+
+
diff --git a/test/fixtures/basic/app/pages/route-scroll-behavior/scroll-to-top.vue b/test/fixtures/basic/app/pages/route-scroll-behavior/scroll-to-top.vue
new file mode 100644
index 000000000000..fdf61c4fa8c7
--- /dev/null
+++ b/test/fixtures/basic/app/pages/route-scroll-behavior/scroll-to-top.vue
@@ -0,0 +1,43 @@
+
+
+
+
+
+
+
+
+
+ Back to scroll to top
+ |
+
+ Scroll to top
+ |
+
+ Do not scroll to top
+
+
diff --git a/test/fixtures/basic/app/pages/route-scroll-behavior/scroll-to-top/[id].vue b/test/fixtures/basic/app/pages/route-scroll-behavior/scroll-to-top/[id].vue
new file mode 100644
index 000000000000..fce505249660
--- /dev/null
+++ b/test/fixtures/basic/app/pages/route-scroll-behavior/scroll-to-top/[id].vue
@@ -0,0 +1,15 @@
+
+
+
+
+
{{ route.params.id }}
+
+
diff --git a/test/fixtures/basic/app/pages/ssr-modules.vue b/test/fixtures/basic/app/pages/ssr-modules.vue
new file mode 100644
index 000000000000..48424f2c32cb
--- /dev/null
+++ b/test/fixtures/basic/app/pages/ssr-modules.vue
@@ -0,0 +1,15 @@
+
+
+
+
+ SSR modules count: {{ modulesState.length }}
+
+
diff --git a/test/fixtures/basic/app/pages/styles.vue b/test/fixtures/basic/app/pages/styles.vue
new file mode 100644
index 000000000000..cde35840e320
--- /dev/null
+++ b/test/fixtures/basic/app/pages/styles.vue
@@ -0,0 +1,26 @@
+
+
+
+
+
+
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/suspense.vue b/test/fixtures/basic/app/pages/suspense.vue
new file mode 100644
index 000000000000..b85db2eaa2c1
--- /dev/null
+++ b/test/fixtures/basic/app/pages/suspense.vue
@@ -0,0 +1,56 @@
+
+
+
+
+ This exists to test synchronous transitions between nested Suspense components.
+
+
+
+
With extended layout
+
+ {{ link }}
+
+
+
+
With custom layout
+
+ {{ link }}
+
+
+
+
+ Internal layout page
+
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/suspense/async-[parent].vue b/test/fixtures/basic/app/pages/suspense/async-[parent].vue
new file mode 100644
index 000000000000..01e60b0076de
--- /dev/null
+++ b/test/fixtures/basic/app/pages/suspense/async-[parent].vue
@@ -0,0 +1,18 @@
+
+
+
+
+ Async parent: {{ route.params.parent }}
+
+
diff --git a/test/fixtures/basic/app/pages/suspense/async-[parent]/async-[child].vue b/test/fixtures/basic/app/pages/suspense/async-[parent]/async-[child].vue
new file mode 100644
index 000000000000..ca05a6452045
--- /dev/null
+++ b/test/fixtures/basic/app/pages/suspense/async-[parent]/async-[child].vue
@@ -0,0 +1,19 @@
+
+
+
+
+ Async child: {{ route.params.parent }} - {{ route.params.child }}
+
diff --git a/test/fixtures/basic/app/pages/suspense/async-[parent]/sync-[child].vue b/test/fixtures/basic/app/pages/suspense/async-[parent]/sync-[child].vue
new file mode 100644
index 000000000000..08a5d7d42f1a
--- /dev/null
+++ b/test/fixtures/basic/app/pages/suspense/async-[parent]/sync-[child].vue
@@ -0,0 +1,12 @@
+
+
+
+
+ Sync child: {{ route.params.parent }} - {{ route.params.child }}
+
+
diff --git a/test/fixtures/basic/app/pages/suspense/sync-[parent].vue b/test/fixtures/basic/app/pages/suspense/sync-[parent].vue
new file mode 100644
index 000000000000..6ab6480fa1de
--- /dev/null
+++ b/test/fixtures/basic/app/pages/suspense/sync-[parent].vue
@@ -0,0 +1,14 @@
+
+
+
+
+ Sync parent: {{ route.params.parent }}
+
+
diff --git a/test/fixtures/basic/app/pages/suspense/sync-[parent]/async-[child].vue b/test/fixtures/basic/app/pages/suspense/sync-[parent]/async-[child].vue
new file mode 100644
index 000000000000..13f87f976d9e
--- /dev/null
+++ b/test/fixtures/basic/app/pages/suspense/sync-[parent]/async-[child].vue
@@ -0,0 +1,19 @@
+
+
+
+
+ Async child: {{ route.params.parent }} - {{ route.params.child }}
+
diff --git a/test/fixtures/basic/app/pages/suspense/sync-[parent]/sync-[child].vue b/test/fixtures/basic/app/pages/suspense/sync-[parent]/sync-[child].vue
new file mode 100644
index 000000000000..bfcc47146315
--- /dev/null
+++ b/test/fixtures/basic/app/pages/suspense/sync-[parent]/sync-[child].vue
@@ -0,0 +1,12 @@
+
+
+
+
+ Sync child: {{ route.params.parent }} - {{ route.params.child }}
+
+
diff --git a/test/fixtures/basic/app/pages/swr.vue b/test/fixtures/basic/app/pages/swr.vue
new file mode 100644
index 000000000000..206ec21baaad
--- /dev/null
+++ b/test/fixtures/basic/app/pages/swr.vue
@@ -0,0 +1,12 @@
+
+
+
SWR Page
+
+ {{ data }}
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/teleport.vue b/test/fixtures/basic/app/pages/teleport.vue
new file mode 100644
index 000000000000..3e08a7c8ea8b
--- /dev/null
+++ b/test/fixtures/basic/app/pages/teleport.vue
@@ -0,0 +1,8 @@
+
+
+
+ Teleport
+
+
Normal content
+
diff --git a/test/fixtures/basic/app/pages/tree-shake.vue b/test/fixtures/basic/app/pages/tree-shake.vue
new file mode 100644
index 000000000000..c52aa9e32a61
--- /dev/null
+++ b/test/fixtures/basic/app/pages/tree-shake.vue
@@ -0,0 +1,14 @@
+
+
+
+
+
Tree Shake Example
+
+
diff --git a/test/fixtures/basic/app/pages/tsx-page-meta.vue b/test/fixtures/basic/app/pages/tsx-page-meta.vue
new file mode 100644
index 000000000000..80a36dcaffe6
--- /dev/null
+++ b/test/fixtures/basic/app/pages/tsx-page-meta.vue
@@ -0,0 +1,9 @@
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/url.vue b/test/fixtures/basic/app/pages/url.vue
new file mode 100644
index 000000000000..c3d77074b761
--- /dev/null
+++ b/test/fixtures/basic/app/pages/url.vue
@@ -0,0 +1,9 @@
+
+
+
+
+
path: {{ url.pathname }}
+
diff --git a/test/fixtures/basic/app/pages/use-id.vue b/test/fixtures/basic/app/pages/use-id.vue
new file mode 100644
index 000000000000..f5982b577b9b
--- /dev/null
+++ b/test/fixtures/basic/app/pages/use-id.vue
@@ -0,0 +1,14 @@
+
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/useAsyncData/double.vue b/test/fixtures/basic/app/pages/useAsyncData/double.vue
new file mode 100644
index 000000000000..2c7c3a86cd8d
--- /dev/null
+++ b/test/fixtures/basic/app/pages/useAsyncData/double.vue
@@ -0,0 +1,26 @@
+
+
+ Single
+
+ data1: {{ data1 }}
+ data2: {{ data2 }}
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/useAsyncData/immediate-remove-unmounted.vue b/test/fixtures/basic/app/pages/useAsyncData/immediate-remove-unmounted.vue
new file mode 100644
index 000000000000..face86f5cd55
--- /dev/null
+++ b/test/fixtures/basic/app/pages/useAsyncData/immediate-remove-unmounted.vue
@@ -0,0 +1,28 @@
+
+
+
immediate-remove-unmounted.vue
+
+ {{ data === null ? "null" : (data === undefined ? 'undefined' : data) }}
+
+
+ execute
+
+
+ index
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/useAsyncData/immediate.vue b/test/fixtures/basic/app/pages/useAsyncData/immediate.vue
new file mode 100644
index 000000000000..892229e71112
--- /dev/null
+++ b/test/fixtures/basic/app/pages/useAsyncData/immediate.vue
@@ -0,0 +1,36 @@
+
+
+ Single
+
+ data: {{ data }}
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/useAsyncData/nuxt-data.vue b/test/fixtures/basic/app/pages/useAsyncData/nuxt-data.vue
new file mode 100644
index 000000000000..f025b5b39a3f
--- /dev/null
+++ b/test/fixtures/basic/app/pages/useAsyncData/nuxt-data.vue
@@ -0,0 +1,15 @@
+
+
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/useAsyncData/promise-all.vue b/test/fixtures/basic/app/pages/useAsyncData/promise-all.vue
new file mode 100644
index 000000000000..426ebba95190
--- /dev/null
+++ b/test/fixtures/basic/app/pages/useAsyncData/promise-all.vue
@@ -0,0 +1,31 @@
+
+
+ Single
+
+ data1: {{ result1.data.value }}
+ data2: {{ result2.data.value }}
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/useAsyncData/refresh.vue b/test/fixtures/basic/app/pages/useAsyncData/refresh.vue
new file mode 100644
index 000000000000..2b357a45fa45
--- /dev/null
+++ b/test/fixtures/basic/app/pages/useAsyncData/refresh.vue
@@ -0,0 +1,38 @@
+
+
+ Single
+
+ {{ data }} - {{ data2 }}
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/useAsyncData/single.vue b/test/fixtures/basic/app/pages/useAsyncData/single.vue
new file mode 100644
index 000000000000..b4dd27588805
--- /dev/null
+++ b/test/fixtures/basic/app/pages/useAsyncData/single.vue
@@ -0,0 +1,16 @@
+
+
+ Single
+
+ {{ data }}
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/useAsyncData/status.vue b/test/fixtures/basic/app/pages/useAsyncData/status.vue
new file mode 100644
index 000000000000..13de48a78ab0
--- /dev/null
+++ b/test/fixtures/basic/app/pages/useAsyncData/status.vue
@@ -0,0 +1,49 @@
+
+
+
+
+ Status
+
+ {{ status1 === 'success' }}
+ {{ status2 === 'error' }}
+ {{ status3 === 'idle' }}
+ {{ status4 === 'success' }}
+
+
+ {{ status5Values.join(',') }}
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/useAsyncData/use-id.vue b/test/fixtures/basic/app/pages/useAsyncData/use-id.vue
new file mode 100644
index 000000000000..201cea039189
--- /dev/null
+++ b/test/fixtures/basic/app/pages/useAsyncData/use-id.vue
@@ -0,0 +1,18 @@
+
+
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/validate-custom-error.vue b/test/fixtures/basic/app/pages/validate-custom-error.vue
new file mode 100644
index 000000000000..380e4e9e4570
--- /dev/null
+++ b/test/fixtures/basic/app/pages/validate-custom-error.vue
@@ -0,0 +1,12 @@
+
+ You should not see this
+
+
+
diff --git a/test/fixtures/basic/app/pages/vueuse-head.vue b/test/fixtures/basic/app/pages/vueuse-head.vue
new file mode 100644
index 000000000000..38fb5a20f6cb
--- /dev/null
+++ b/test/fixtures/basic/app/pages/vueuse-head.vue
@@ -0,0 +1,27 @@
+
+
+
+
+
VueUse head polyfill test
+
+
diff --git a/test/fixtures/basic/app/pages/with-computed-layout.vue b/test/fixtures/basic/app/pages/with-computed-layout.vue
new file mode 100644
index 000000000000..2e256bb39211
--- /dev/null
+++ b/test/fixtures/basic/app/pages/with-computed-layout.vue
@@ -0,0 +1,11 @@
+
+
+
+
+
with-computed-layout.vue
+
diff --git a/test/fixtures/basic/app/pages/with-dynamic-layout.vue b/test/fixtures/basic/app/pages/with-dynamic-layout.vue
new file mode 100644
index 000000000000..7938ad7c5298
--- /dev/null
+++ b/test/fixtures/basic/app/pages/with-dynamic-layout.vue
@@ -0,0 +1,11 @@
+
+
+
+
+
with-dynamic-layout.vue
+
diff --git a/test/fixtures/basic/app/pages/with-layout-props.vue b/test/fixtures/basic/app/pages/with-layout-props.vue
new file mode 100644
index 000000000000..9d16f8da293b
--- /dev/null
+++ b/test/fixtures/basic/app/pages/with-layout-props.vue
@@ -0,0 +1,16 @@
+
+
+
+
+
with-layout-props.vue
+
diff --git a/test/fixtures/basic/app/pages/with-layout.vue b/test/fixtures/basic/app/pages/with-layout.vue
new file mode 100644
index 000000000000..88a2e9011292
--- /dev/null
+++ b/test/fixtures/basic/app/pages/with-layout.vue
@@ -0,0 +1,14 @@
+
+
+
+
+
with-layout.vue
+
+ to another page
+
+
diff --git a/test/fixtures/basic/app/pages/with-layout2.vue b/test/fixtures/basic/app/pages/with-layout2.vue
new file mode 100644
index 000000000000..e28c35e9145e
--- /dev/null
+++ b/test/fixtures/basic/app/pages/with-layout2.vue
@@ -0,0 +1,15 @@
+
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/wrapper-expose/layout.vue b/test/fixtures/basic/app/pages/wrapper-expose/layout.vue
new file mode 100644
index 000000000000..3e99583cbeb0
--- /dev/null
+++ b/test/fixtures/basic/app/pages/wrapper-expose/layout.vue
@@ -0,0 +1,44 @@
+
+
+
+ swap layout
+
+
+ log foo
+
+
+ log hello
+
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/wrapper-expose/page.vue b/test/fixtures/basic/app/pages/wrapper-expose/page.vue
new file mode 100644
index 000000000000..9ab676850e1c
--- /dev/null
+++ b/test/fixtures/basic/app/pages/wrapper-expose/page.vue
@@ -0,0 +1,30 @@
+
+
+
+ hello
+
+
+ foo
+
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/wrapper-expose/page/another.vue b/test/fixtures/basic/app/pages/wrapper-expose/page/another.vue
new file mode 100644
index 000000000000..e39e5ce94640
--- /dev/null
+++ b/test/fixtures/basic/app/pages/wrapper-expose/page/another.vue
@@ -0,0 +1,23 @@
+
+
+
+ hello
+
+
+ to foo
+
+
+
+
diff --git a/test/fixtures/basic/app/pages/wrapper-expose/page/index.vue b/test/fixtures/basic/app/pages/wrapper-expose/page/index.vue
new file mode 100644
index 000000000000..532bcf003104
--- /dev/null
+++ b/test/fixtures/basic/app/pages/wrapper-expose/page/index.vue
@@ -0,0 +1,21 @@
+
+
+
+
+
diff --git a/test/fixtures/basic/app/plugins/10.layer-ordering.ts b/test/fixtures/basic/app/plugins/10.layer-ordering.ts
new file mode 100644
index 000000000000..04c2e492c602
--- /dev/null
+++ b/test/fixtures/basic/app/plugins/10.layer-ordering.ts
@@ -0,0 +1,10 @@
+export default defineNuxtPlugin((nuxtApp) => {
+ if (useRoute().path === '/plugins/ordering') {
+ if (!nuxtApp.$layerPluginPre) {
+ throw createError('layer plugin failed to run before end project plugin')
+ }
+ if (!nuxtApp.$layerPluginPost) {
+ throw createError('layer plugin failed to run before end project plugin')
+ }
+ }
+})
diff --git a/test/fixtures/basic/app/plugins/add-nuxt-link-alias.ts b/test/fixtures/basic/app/plugins/add-nuxt-link-alias.ts
new file mode 100644
index 000000000000..6d0bfeadfbbd
--- /dev/null
+++ b/test/fixtures/basic/app/plugins/add-nuxt-link-alias.ts
@@ -0,0 +1,5 @@
+import { NuxtLink } from '#components'
+
+export default defineNuxtPlugin((nuxtApp) => {
+ nuxtApp.vueApp.component('NuxtLinkAlias', NuxtLink)
+})
diff --git a/test/fixtures/basic/app/plugins/add-route.ts b/test/fixtures/basic/app/plugins/add-route.ts
new file mode 100644
index 000000000000..41acc8d182e5
--- /dev/null
+++ b/test/fixtures/basic/app/plugins/add-route.ts
@@ -0,0 +1,18 @@
+export default defineNuxtPlugin((_nuxtApp) => {
+ const router = useRouter()
+
+ router.beforeEach((to) => {
+ if (to.path !== '/add-route-test') { return }
+ if (router.getRoutes().some(route => route.path === to.path)) {
+ return
+ }
+
+ router.addRoute({
+ path: to.path,
+ name: to.path,
+ component: () => import('~/pages/index.vue'),
+ })
+
+ return to.path
+ })
+})
diff --git a/test/fixtures/basic/app/plugins/async-plugin.ts b/test/fixtures/basic/app/plugins/async-plugin.ts
new file mode 100644
index 000000000000..ae3916ab20ed
--- /dev/null
+++ b/test/fixtures/basic/app/plugins/async-plugin.ts
@@ -0,0 +1,17 @@
+export default defineNuxtPlugin({
+ name: 'async-plugin',
+ async setup (/* nuxtApp */) {
+ const config1 = useRuntimeConfig()
+ await new Promise(resolve => setTimeout(resolve, 100))
+ const { data } = useFetch('/api/hey', { key: 'hey' })
+ const config2 = useRuntimeConfig()
+ return {
+ provide: {
+ asyncPlugin: () => config1 && config1 === config2
+ ? 'Async plugin works! ' + config1.public.testConfig + (data.value?.baz ? 'useFetch works!' : 'useFetch does not work')
+ : 'Async plugin failed!',
+ },
+ }
+ },
+ parallel: true,
+})
diff --git a/test/fixtures/basic/app/plugins/chunk-error.ts b/test/fixtures/basic/app/plugins/chunk-error.ts
new file mode 100644
index 000000000000..e23e5ecdd964
--- /dev/null
+++ b/test/fixtures/basic/app/plugins/chunk-error.ts
@@ -0,0 +1,5 @@
+export default defineNuxtPlugin((nuxtApp) => {
+ nuxtApp.hook('app:chunkError', () => {
+ console.log('caught chunk load error')
+ })
+})
diff --git a/test/fixtures/basic/app/plugins/context-error.ts b/test/fixtures/basic/app/plugins/context-error.ts
new file mode 100644
index 000000000000..d2fba3e086ae
--- /dev/null
+++ b/test/fixtures/basic/app/plugins/context-error.ts
@@ -0,0 +1,9 @@
+export default defineNuxtPlugin(() => {
+ // this should be undefined
+ const vueApp = getCurrentInstance()
+ return {
+ provide: {
+ wasVueAppInstanceWronglyPreserved: !!vueApp,
+ },
+ }
+})
diff --git a/test/fixtures/basic/app/plugins/cookie.ts b/test/fixtures/basic/app/plugins/cookie.ts
new file mode 100644
index 000000000000..3ada0225a8b0
--- /dev/null
+++ b/test/fixtures/basic/app/plugins/cookie.ts
@@ -0,0 +1,6 @@
+export default defineNuxtPlugin({
+ env: { islands: false },
+ setup () {
+ useCookie('set-in-plugin').value = 'true'
+ },
+})
diff --git a/test/fixtures/basic/app/plugins/custom-type-assertion.client.ts b/test/fixtures/basic/app/plugins/custom-type-assertion.client.ts
new file mode 100644
index 000000000000..3b9135428b01
--- /dev/null
+++ b/test/fixtures/basic/app/plugins/custom-type-assertion.client.ts
@@ -0,0 +1,7 @@
+export default defineNuxtPlugin((nuxtApp) => {
+ if (nuxtApp.payload.serverRendered && nuxtApp.payload.blinkable !== '' && document.querySelector('#__NUXT_DATA__')) {
+ throw createError({
+ message: 'Custom type in Nuxt payload was not revived correctly',
+ })
+ }
+})
diff --git a/test/fixtures/basic/app/plugins/custom-type-registration.ts b/test/fixtures/basic/app/plugins/custom-type-registration.ts
new file mode 100644
index 000000000000..e3e89c068e52
--- /dev/null
+++ b/test/fixtures/basic/app/plugins/custom-type-registration.ts
@@ -0,0 +1,7 @@
+export default definePayloadPlugin((nuxtApp) => {
+ definePayloadReducer('BlinkingText', data => data === '' && '_')
+ definePayloadReviver('BlinkingText', () => '')
+ if (import.meta.server) {
+ nuxtApp.payload.blinkable = ''
+ }
+})
diff --git a/test/fixtures/basic/app/plugins/dependsOnPlugin.ts b/test/fixtures/basic/app/plugins/dependsOnPlugin.ts
new file mode 100644
index 000000000000..2f190b75845c
--- /dev/null
+++ b/test/fixtures/basic/app/plugins/dependsOnPlugin.ts
@@ -0,0 +1,12 @@
+export default defineNuxtPlugin({
+ name: 'depends-on-plugin',
+ dependsOn: ['async-plugin'],
+ async setup () {
+ const nuxtApp = useNuxtApp()
+ if (!nuxtApp.$asyncPlugin) {
+ throw new Error('$asyncPlugin is not defined')
+ }
+ await new Promise(resolve => setTimeout(resolve, 100))
+ },
+ parallel: true,
+})
diff --git a/test/fixtures/basic/app/plugins/error.server.ts b/test/fixtures/basic/app/plugins/error.server.ts
new file mode 100644
index 000000000000..788232ab7242
--- /dev/null
+++ b/test/fixtures/basic/app/plugins/error.server.ts
@@ -0,0 +1,5 @@
+export default defineNuxtPlugin(async () => {
+ if (useRequestEvent()?.req.headers.get('x-test-recurse-error')) {
+ await $fetch('/api/error').catch(() => {})
+ }
+})
diff --git a/test/fixtures/basic/app/plugins/invalid-plugin-1.ts b/test/fixtures/basic/app/plugins/invalid-plugin-1.ts
new file mode 100644
index 000000000000..4a2f076d0d5a
--- /dev/null
+++ b/test/fixtures/basic/app/plugins/invalid-plugin-1.ts
@@ -0,0 +1 @@
+import 'nonexistent-package'
diff --git a/test/fixtures/basic/app/plugins/my-plugin.ts b/test/fixtures/basic/app/plugins/my-plugin.ts
new file mode 100644
index 000000000000..5b9379eaaff0
--- /dev/null
+++ b/test/fixtures/basic/app/plugins/my-plugin.ts
@@ -0,0 +1,17 @@
+export default defineNuxtPlugin(() => {
+ useHead({
+ titleTemplate: '%s - Fixture',
+ style: [{
+ innerHTML: () => 'body { color: red }',
+ tagPriority: -2,
+ id: 'plugin-style',
+ }],
+ })
+ const path = useRoute()?.path
+ return {
+ provide: {
+ myPlugin: () => 'Injected by my-plugin',
+ path: () => path,
+ },
+ }
+})
diff --git a/test/fixtures/basic/app/plugins/page-hook-plugin.ts b/test/fixtures/basic/app/plugins/page-hook-plugin.ts
new file mode 100644
index 000000000000..880f7f1ac416
--- /dev/null
+++ b/test/fixtures/basic/app/plugins/page-hook-plugin.ts
@@ -0,0 +1,8 @@
+export default defineNuxtPlugin((nuxtApp) => {
+ const route = useRoute()
+ nuxtApp.hook('page:loading:end', () => {
+ if (route.path === '/page-load-hook') {
+ console.log('page:loading:end')
+ }
+ })
+})
diff --git a/test/fixtures/basic/app/plugins/prerender.server.ts b/test/fixtures/basic/app/plugins/prerender.server.ts
new file mode 100644
index 000000000000..9eec0f831c4a
--- /dev/null
+++ b/test/fixtures/basic/app/plugins/prerender.server.ts
@@ -0,0 +1,4 @@
+export default defineNuxtPlugin((nuxtApp) => {
+ // Pretend to be prerendered
+ nuxtApp.payload.prerenderedAt = Date.now()
+})
diff --git a/test/fixtures/basic/app/plugins/register.ts b/test/fixtures/basic/app/plugins/register.ts
new file mode 100644
index 000000000000..d8cf47b33206
--- /dev/null
+++ b/test/fixtures/basic/app/plugins/register.ts
@@ -0,0 +1,13 @@
+import { defineComponent, h } from 'vue'
+
+const Spin = defineComponent({
+ setup (props, { slots }) {
+ return () => {
+ return h('div', slots.default?.())
+ }
+ },
+})
+
+export default defineNuxtPlugin((nuxtApp) => {
+ nuxtApp.vueApp.component('Spin', Spin)
+})
diff --git a/test/fixtures/basic/app/plugins/server-only.server.ts b/test/fixtures/basic/app/plugins/server-only.server.ts
new file mode 100644
index 000000000000..7fa57795c972
--- /dev/null
+++ b/test/fixtures/basic/app/plugins/server-only.server.ts
@@ -0,0 +1,12 @@
+export default defineNuxtPlugin({
+ name: 'server-only-plugin',
+ setup () {
+ const evt = useRequestEvent()
+ if (evt) {
+ evt.res.headers.set('custom-head', 'hello')
+ }
+ },
+ env: {
+ islands: false,
+ },
+})
diff --git a/test/fixtures/basic/app/plugins/style.ts b/test/fixtures/basic/app/plugins/style.ts
new file mode 100644
index 000000000000..762424e6b7fc
--- /dev/null
+++ b/test/fixtures/basic/app/plugins/style.ts
@@ -0,0 +1,14 @@
+import '~/assets/plugin.css'
+
+export class OnMountedMethod {
+ public onMounted () {
+ console.log('public onMounted')
+ }
+
+ onBeforeMount () {
+ console.log('onBeforeMount')
+ }
+}
+export default defineNuxtPlugin(() => {
+ //
+})
diff --git a/test/fixtures/basic/app/plugins/test.d.ts b/test/fixtures/basic/app/plugins/test.d.ts
new file mode 100644
index 000000000000..e408a5b9c995
--- /dev/null
+++ b/test/fixtures/basic/app/plugins/test.d.ts
@@ -0,0 +1,3 @@
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type
+interface MyInterface {}
+export {}
diff --git a/test/fixtures/basic/app/plugins/this-should-not-load.spec.js b/test/fixtures/basic/app/plugins/this-should-not-load.spec.js
new file mode 100644
index 000000000000..4b425f75543c
--- /dev/null
+++ b/test/fixtures/basic/app/plugins/this-should-not-load.spec.js
@@ -0,0 +1 @@
+throw new Error('this-should-not-load.spec.js should not be loaded')
diff --git a/test/fixtures/basic/app/some-exports.ts b/test/fixtures/basic/app/some-exports.ts
new file mode 100644
index 000000000000..f3f19d910894
--- /dev/null
+++ b/test/fixtures/basic/app/some-exports.ts
@@ -0,0 +1,2 @@
+export const importedValue = 'an imported value'
+export const importedRE = /an imported regex/
diff --git a/test/fixtures/basic/app/utils/useBar.ts b/test/fixtures/basic/app/utils/useBar.ts
new file mode 100644
index 000000000000..19a8d7fee63e
--- /dev/null
+++ b/test/fixtures/basic/app/utils/useBar.ts
@@ -0,0 +1,3 @@
+export default function () {
+ return 'auto imported from ~/utils/useBar.ts'
+}
diff --git a/test/fixtures/basic/assets/app.css b/test/fixtures/basic/assets/app.css
deleted file mode 100644
index 1c6bb11965b3..000000000000
--- a/test/fixtures/basic/assets/app.css
+++ /dev/null
@@ -1 +0,0 @@
-@import "~assets/import.css";
diff --git a/test/fixtures/basic/assets/import.css b/test/fixtures/basic/assets/import.css
deleted file mode 100644
index 4a57b86239e4..000000000000
--- a/test/fixtures/basic/assets/import.css
+++ /dev/null
@@ -1 +0,0 @@
-.import-css { color: red; }
diff --git a/test/fixtures/basic/basic.test.js b/test/fixtures/basic/basic.test.js
deleted file mode 100644
index 206687623977..000000000000
--- a/test/fixtures/basic/basic.test.js
+++ /dev/null
@@ -1,3 +0,0 @@
-import { buildFixture } from '../../utils/build'
-
-buildFixture('basic')
diff --git a/test/fixtures/basic/custom-modules/subpath/index.ts b/test/fixtures/basic/custom-modules/subpath/index.ts
new file mode 100644
index 000000000000..3c083d0b10f3
--- /dev/null
+++ b/test/fixtures/basic/custom-modules/subpath/index.ts
@@ -0,0 +1 @@
+export const someUtil = () => {}
diff --git a/test/fixtures/basic/custom-modules/subpath/module.ts b/test/fixtures/basic/custom-modules/subpath/module.ts
new file mode 100644
index 000000000000..d1f975bc9236
--- /dev/null
+++ b/test/fixtures/basic/custom-modules/subpath/module.ts
@@ -0,0 +1,5 @@
+import { defineNuxtModule } from 'nuxt/kit'
+
+export default defineNuxtModule({
+ meta: { name: 'subpath' },
+})
diff --git a/test/fixtures/basic/custom-public/file.svg b/test/fixtures/basic/custom-public/file.svg
new file mode 100644
index 000000000000..c31de56afcf1
--- /dev/null
+++ b/test/fixtures/basic/custom-public/file.svg
@@ -0,0 +1,18 @@
+
+
+
+
+
+
+
+
+
+
diff --git a/test/fixtures/basic/extends/bar/app.config.ts b/test/fixtures/basic/extends/bar/app.config.ts
new file mode 100644
index 000000000000..e6007cc55417
--- /dev/null
+++ b/test/fixtures/basic/extends/bar/app.config.ts
@@ -0,0 +1,3 @@
+export default {
+ fromLayer: true,
+}
diff --git a/test/fixtures/basic/extends/bar/app/router.options.ts b/test/fixtures/basic/extends/bar/app/router.options.ts
new file mode 100644
index 000000000000..b8e3be960f52
--- /dev/null
+++ b/test/fixtures/basic/extends/bar/app/router.options.ts
@@ -0,0 +1,5 @@
+import type { RouterOptions } from 'nuxt/schema'
+
+export default {
+ linkExactActiveClass: 'bar-exact-active-class',
+}
diff --git a/test/fixtures/basic/extends/bar/components/ExtendsOverride.vue b/test/fixtures/basic/extends/bar/components/ExtendsOverride.vue
new file mode 100644
index 000000000000..01a809c4f47f
--- /dev/null
+++ b/test/fixtures/basic/extends/bar/components/ExtendsOverride.vue
@@ -0,0 +1,4 @@
+
+ Extended component from bar
+
diff --git a/test/fixtures/basic/extends/bar/composables/base.ts b/test/fixtures/basic/extends/bar/composables/base.ts
new file mode 100644
index 000000000000..b363f9d80728
--- /dev/null
+++ b/test/fixtures/basic/extends/bar/composables/base.ts
@@ -0,0 +1 @@
+export const useOverridableComposable = () => 'test from layer'
diff --git a/test/fixtures/basic/extends/bar/index.d.ts b/test/fixtures/basic/extends/bar/index.d.ts
new file mode 100644
index 000000000000..3d1121c5447b
--- /dev/null
+++ b/test/fixtures/basic/extends/bar/index.d.ts
@@ -0,0 +1,5 @@
+declare module 'bing' {
+ interface BingInterface {
+ foo: 'bar'
+ }
+}
diff --git a/test/fixtures/basic/extends/bar/layouts/override.vue b/test/fixtures/basic/extends/bar/layouts/override.vue
new file mode 100644
index 000000000000..7397c7ad6326
--- /dev/null
+++ b/test/fixtures/basic/extends/bar/layouts/override.vue
@@ -0,0 +1,6 @@
+
+
+
Extended layout from bar
+
+
diff --git a/test/fixtures/basic/extends/bar/middleware/a.global.ts b/test/fixtures/basic/extends/bar/middleware/a.global.ts
new file mode 100644
index 000000000000..bf5731827748
--- /dev/null
+++ b/test/fixtures/basic/extends/bar/middleware/a.global.ts
@@ -0,0 +1,3 @@
+export default defineNuxtRouteMiddleware(() => {
+ useNuxtApp().extendsMiddleware = true
+})
diff --git a/test/fixtures/basic/extends/bar/middleware/override.ts b/test/fixtures/basic/extends/bar/middleware/override.ts
new file mode 100644
index 000000000000..00edf7812469
--- /dev/null
+++ b/test/fixtures/basic/extends/bar/middleware/override.ts
@@ -0,0 +1,3 @@
+export default defineNuxtRouteMiddleware((to) => {
+ to.meta.override = 'Injected by extended middleware from bar'
+})
diff --git a/test/fixtures/basic/extends/bar/nuxt.config.ts b/test/fixtures/basic/extends/bar/nuxt.config.ts
new file mode 100644
index 000000000000..f32e267e8fd8
--- /dev/null
+++ b/test/fixtures/basic/extends/bar/nuxt.config.ts
@@ -0,0 +1,11 @@
+export default defineNuxtConfig({
+ modules: [undefined],
+ app: {
+ head: {
+ meta: [
+ { name: 'viewport', content: 'width=1024, initial-scale=1' },
+ { charset: 'utf-8' },
+ ],
+ },
+ },
+})
diff --git a/test/fixtures/basic/extends/bar/pages/override.vue b/test/fixtures/basic/extends/bar/pages/override.vue
new file mode 100644
index 000000000000..f7d30cffccf3
--- /dev/null
+++ b/test/fixtures/basic/extends/bar/pages/override.vue
@@ -0,0 +1,15 @@
+
+
+
+
+
Extended page from bar
+
Middleware | override: {{ $route.meta.override }}
+
+
+
diff --git a/test/fixtures/basic/extends/bar/plugins/09.layer-plugin-pre.ts b/test/fixtures/basic/extends/bar/plugins/09.layer-plugin-pre.ts
new file mode 100644
index 000000000000..2b2f5c9f27bc
--- /dev/null
+++ b/test/fixtures/basic/extends/bar/plugins/09.layer-plugin-pre.ts
@@ -0,0 +1,3 @@
+export default defineNuxtPlugin((nuxtApp) => {
+ nuxtApp.provide('layerPluginPre', 'layer-plugin')
+})
diff --git a/test/fixtures/basic/extends/bar/plugins/11.layer-plugin-post.ts b/test/fixtures/basic/extends/bar/plugins/11.layer-plugin-post.ts
new file mode 100644
index 000000000000..786ea4113fc6
--- /dev/null
+++ b/test/fixtures/basic/extends/bar/plugins/11.layer-plugin-post.ts
@@ -0,0 +1,3 @@
+export default defineNuxtPlugin((nuxtApp) => {
+ nuxtApp.provide('layerPluginPost', 'layer-plugin')
+})
diff --git a/test/fixtures/basic/extends/bar/public/nuxt.svg b/test/fixtures/basic/extends/bar/public/nuxt.svg
new file mode 100644
index 000000000000..c31de56afcf1
--- /dev/null
+++ b/test/fixtures/basic/extends/bar/public/nuxt.svg
@@ -0,0 +1,18 @@
+
+
+
+
+
+
+
+
+
+
diff --git a/test/fixtures/basic/extends/node_modules/foo/alias/test.ts b/test/fixtures/basic/extends/node_modules/foo/alias/test.ts
new file mode 100644
index 000000000000..ef0783236145
--- /dev/null
+++ b/test/fixtures/basic/extends/node_modules/foo/alias/test.ts
@@ -0,0 +1 @@
+export const test = 'from layer alias'
diff --git a/test/fixtures/basic/extends/node_modules/foo/app/router.options.ts b/test/fixtures/basic/extends/node_modules/foo/app/router.options.ts
new file mode 100644
index 000000000000..1504a42fa634
--- /dev/null
+++ b/test/fixtures/basic/extends/node_modules/foo/app/router.options.ts
@@ -0,0 +1,6 @@
+import type { RouterOptions } from '@nuxt/schema'
+
+export default {
+ linkActiveClass: 'foo-active-class',
+ linkExactActiveClass: 'foo-exact-active-class'
+}
diff --git a/test/fixtures/basic/extends/node_modules/foo/components/ExtendsFoo.vue b/test/fixtures/basic/extends/node_modules/foo/components/ExtendsFoo.vue
new file mode 100644
index 000000000000..1cda5442d5e8
--- /dev/null
+++ b/test/fixtures/basic/extends/node_modules/foo/components/ExtendsFoo.vue
@@ -0,0 +1,3 @@
+
+ Extended component from foo
+
diff --git a/test/fixtures/basic/extends/node_modules/foo/components/ExtendsOverride.vue b/test/fixtures/basic/extends/node_modules/foo/components/ExtendsOverride.vue
new file mode 100644
index 000000000000..70a57d916aef
--- /dev/null
+++ b/test/fixtures/basic/extends/node_modules/foo/components/ExtendsOverride.vue
@@ -0,0 +1,3 @@
+
+ This component should be overridden by bar
+
diff --git a/test/fixtures/basic/extends/node_modules/foo/composables/foo.ts b/test/fixtures/basic/extends/node_modules/foo/composables/foo.ts
new file mode 100644
index 000000000000..9caa9254fc3d
--- /dev/null
+++ b/test/fixtures/basic/extends/node_modules/foo/composables/foo.ts
@@ -0,0 +1 @@
+export const useExtendsFoo = () => 'foo'
diff --git a/test/fixtures/basic/extends/node_modules/foo/layouts/default.vue b/test/fixtures/basic/extends/node_modules/foo/layouts/default.vue
new file mode 100644
index 000000000000..671b27180fc8
--- /dev/null
+++ b/test/fixtures/basic/extends/node_modules/foo/layouts/default.vue
@@ -0,0 +1,7 @@
+
+
+
+
Extended layout from foo
+
+
diff --git a/test/fixtures/basic/extends/node_modules/foo/layouts/override.vue b/test/fixtures/basic/extends/node_modules/foo/layouts/override.vue
new file mode 100644
index 000000000000..64753c4e0ad1
--- /dev/null
+++ b/test/fixtures/basic/extends/node_modules/foo/layouts/override.vue
@@ -0,0 +1,3 @@
+
+ This layout should be overridden by bar
+
diff --git a/test/fixtures/basic/extends/node_modules/foo/middleware/foo.ts b/test/fixtures/basic/extends/node_modules/foo/middleware/foo.ts
new file mode 100644
index 000000000000..53963c77032a
--- /dev/null
+++ b/test/fixtures/basic/extends/node_modules/foo/middleware/foo.ts
@@ -0,0 +1,3 @@
+export default defineNuxtRouteMiddleware((to) => {
+ to.meta.foo = 'Injected by extended middleware from foo'
+})
diff --git a/test/fixtures/basic/extends/node_modules/foo/middleware/override.ts b/test/fixtures/basic/extends/node_modules/foo/middleware/override.ts
new file mode 100644
index 000000000000..eca4b646c347
--- /dev/null
+++ b/test/fixtures/basic/extends/node_modules/foo/middleware/override.ts
@@ -0,0 +1,3 @@
+export default defineNuxtRouteMiddleware((to) => {
+ to.meta.override = 'This middleware should be overridden by bar'
+})
diff --git a/test/fixtures/basic/extends/node_modules/foo/nuxt.config.ts b/test/fixtures/basic/extends/node_modules/foo/nuxt.config.ts
new file mode 100644
index 000000000000..f716d9f9da91
--- /dev/null
+++ b/test/fixtures/basic/extends/node_modules/foo/nuxt.config.ts
@@ -0,0 +1,3 @@
+import { defineNuxtConfig } from 'nuxt/config'
+
+export default defineNuxtConfig({})
diff --git a/test/fixtures/basic/extends/node_modules/foo/pages/foo.vue b/test/fixtures/basic/extends/node_modules/foo/pages/foo.vue
new file mode 100644
index 000000000000..9599ea6eac9e
--- /dev/null
+++ b/test/fixtures/basic/extends/node_modules/foo/pages/foo.vue
@@ -0,0 +1,19 @@
+
+
+
+
+
{{ test }}
+
Extended page from foo
+
Middleware | foo: {{ $route.meta.foo }}
+
Composable | useExtendsFoo: {{ foo }}
+
Plugin | foo: {{ $foo() }}
+
+
diff --git a/test/fixtures/basic/extends/node_modules/foo/pages/override.vue b/test/fixtures/basic/extends/node_modules/foo/pages/override.vue
new file mode 100644
index 000000000000..3bb95b220e1a
--- /dev/null
+++ b/test/fixtures/basic/extends/node_modules/foo/pages/override.vue
@@ -0,0 +1,8 @@
+
+ This page should be overridden by bar
+
+
+
diff --git a/test/fixtures/basic/extends/node_modules/foo/pages/override/index.vue b/test/fixtures/basic/extends/node_modules/foo/pages/override/index.vue
new file mode 100644
index 000000000000..442e45b5f598
--- /dev/null
+++ b/test/fixtures/basic/extends/node_modules/foo/pages/override/index.vue
@@ -0,0 +1,5 @@
+
+
+ This child page should not be overridden by bar
+
+
diff --git a/test/fixtures/basic/extends/node_modules/foo/plugins/foo.ts b/test/fixtures/basic/extends/node_modules/foo/plugins/foo.ts
new file mode 100644
index 000000000000..23534da003c6
--- /dev/null
+++ b/test/fixtures/basic/extends/node_modules/foo/plugins/foo.ts
@@ -0,0 +1,7 @@
+export default defineNuxtPlugin(() => {
+ return {
+ provide: {
+ foo: () => 'String generated from foo plugin!'
+ }
+ }
+})
diff --git a/test/fixtures/basic/extends/node_modules/foo/server/api/foo.ts b/test/fixtures/basic/extends/node_modules/foo/server/api/foo.ts
new file mode 100644
index 000000000000..4529f026397b
--- /dev/null
+++ b/test/fixtures/basic/extends/node_modules/foo/server/api/foo.ts
@@ -0,0 +1,3 @@
+import { eventHandler } from 'h3'
+
+export default eventHandler(() => 'foo')
diff --git a/test/fixtures/basic/extends/node_modules/foo/server/middleware/foo.ts b/test/fixtures/basic/extends/node_modules/foo/server/middleware/foo.ts
new file mode 100644
index 000000000000..ab109cb6f4a6
--- /dev/null
+++ b/test/fixtures/basic/extends/node_modules/foo/server/middleware/foo.ts
@@ -0,0 +1,6 @@
+// TODO: add back TypeScript and auto-importing once Nitro supports it
+import { eventHandler } from 'h3'
+
+export default eventHandler((event) => {
+ event.res.headers.set('injected-header', 'foo')
+})
diff --git a/test/fixtures/basic/layers/bar/nuxt.config.ts b/test/fixtures/basic/layers/bar/nuxt.config.ts
new file mode 100644
index 000000000000..cf9614f668d9
--- /dev/null
+++ b/test/fixtures/basic/layers/bar/nuxt.config.ts
@@ -0,0 +1,8 @@
+export default defineNuxtConfig({
+ modules: [
+ function (_options, nuxt) {
+ // @ts-expect-error not valid nuxt option
+ nuxt.options.__installed_layer = true
+ },
+ ],
+})
diff --git a/test/fixtures/basic/layouts/custom.js b/test/fixtures/basic/layouts/custom.js
deleted file mode 100644
index d2ae02127c26..000000000000
--- a/test/fixtures/basic/layouts/custom.js
+++ /dev/null
@@ -1,10 +0,0 @@
-export default {
- render (h) {
- return h('div',
- [
- h('h1', 'JS Layout'),
- h('nuxt')
- ]
- )
- }
-}
diff --git a/test/fixtures/basic/layouts/default.vue b/test/fixtures/basic/layouts/default.vue
deleted file mode 100644
index 0acb4c79974f..000000000000
--- a/test/fixtures/basic/layouts/default.vue
+++ /dev/null
@@ -1,5 +0,0 @@
-
-
-
-
diff --git a/test/fixtures/basic/middleware/-ignored.js b/test/fixtures/basic/middleware/-ignored.js
deleted file mode 100644
index 99e4a7b2b17b..000000000000
--- a/test/fixtures/basic/middleware/-ignored.js
+++ /dev/null
@@ -1,3 +0,0 @@
-export default function () {
- throw new Error('Should be ignored')
-}
diff --git a/test/fixtures/basic/middleware/error.js b/test/fixtures/basic/middleware/error.js
deleted file mode 100644
index dc473a11b69a..000000000000
--- a/test/fixtures/basic/middleware/error.js
+++ /dev/null
@@ -1,3 +0,0 @@
-export default function ({ error }) {
- error({ message: 'Middleware Error', statusCode: 505 })
-}
diff --git a/test/fixtures/basic/middleware/ignored.test.js b/test/fixtures/basic/middleware/ignored.test.js
deleted file mode 100644
index 99e4a7b2b17b..000000000000
--- a/test/fixtures/basic/middleware/ignored.test.js
+++ /dev/null
@@ -1,3 +0,0 @@
-export default function () {
- throw new Error('Should be ignored')
-}
diff --git a/test/fixtures/basic/middleware/meta.js b/test/fixtures/basic/middleware/meta.js
deleted file mode 100644
index c43813140606..000000000000
--- a/test/fixtures/basic/middleware/meta.js
+++ /dev/null
@@ -1,3 +0,0 @@
-export default ({ store, route, redirect }) => {
- store.commit('setMeta', route.meta)
-}
diff --git a/test/fixtures/basic/middleware/redirect.js b/test/fixtures/basic/middleware/redirect.js
deleted file mode 100644
index 1a0784ed666d..000000000000
--- a/test/fixtures/basic/middleware/redirect.js
+++ /dev/null
@@ -1,3 +0,0 @@
-export default function ({ redirect }) {
- redirect('/')
-}
diff --git a/test/fixtures/basic/modules/auto-registered/index.ts b/test/fixtures/basic/modules/auto-registered/index.ts
new file mode 100644
index 000000000000..ff89d82728ac
--- /dev/null
+++ b/test/fixtures/basic/modules/auto-registered/index.ts
@@ -0,0 +1,34 @@
+import { addServerHandler, addServerImports, addServerImportsDir, createResolver, defineNuxtModule } from 'nuxt/kit'
+
+export default defineNuxtModule({
+ meta: {
+ name: 'auto-registered-module',
+ },
+ setup (_, nuxt) {
+ const resolver = createResolver(import.meta.url)
+
+ addServerHandler({
+ handler: resolver.resolve('./runtime/handler'),
+ route: '/auto-registered-module',
+ })
+
+ // #34982
+ nuxt.hook('nitro:config', () => {
+ addServerHandler({
+ handler: resolver.resolve('./runtime/late-handler'),
+ route: '/auto-registered-module-late',
+ })
+ })
+
+ addServerImports([{
+ from: resolver.resolve('./runtime/some-server-import'),
+ name: 'serverAutoImported',
+ as: 'autoimportedFunction',
+ }, {
+ from: resolver.resolve('./runtime/some-server-import'),
+ name: 'someUtils',
+ }])
+
+ addServerImportsDir(resolver.resolve('./runtime/server/utils'))
+ },
+})
diff --git a/test/fixtures/basic/modules/auto-registered/runtime/handler.ts b/test/fixtures/basic/modules/auto-registered/runtime/handler.ts
new file mode 100644
index 000000000000..18413fe2d9d3
--- /dev/null
+++ b/test/fixtures/basic/modules/auto-registered/runtime/handler.ts
@@ -0,0 +1,3 @@
+import { defineEventHandler } from 'nitro/h3'
+
+export default defineEventHandler(() => 'handler added by auto-registered module')
diff --git a/test/fixtures/basic/modules/auto-registered/runtime/late-handler.ts b/test/fixtures/basic/modules/auto-registered/runtime/late-handler.ts
new file mode 100644
index 000000000000..5555deec3edf
--- /dev/null
+++ b/test/fixtures/basic/modules/auto-registered/runtime/late-handler.ts
@@ -0,0 +1,3 @@
+import { defineEventHandler } from 'nitro/h3'
+
+export default defineEventHandler(() => 'handler added from nitro:config hook')
diff --git a/test/fixtures/basic/modules/auto-registered/runtime/server/utils/some-utils.ts b/test/fixtures/basic/modules/auto-registered/runtime/server/utils/some-utils.ts
new file mode 100644
index 000000000000..e31094e9e17e
--- /dev/null
+++ b/test/fixtures/basic/modules/auto-registered/runtime/server/utils/some-utils.ts
@@ -0,0 +1 @@
+export const testUtils = 'test-utils'
diff --git a/test/fixtures/basic/modules/auto-registered/runtime/some-server-import.ts b/test/fixtures/basic/modules/auto-registered/runtime/some-server-import.ts
new file mode 100644
index 000000000000..00e7322c37eb
--- /dev/null
+++ b/test/fixtures/basic/modules/auto-registered/runtime/some-server-import.ts
@@ -0,0 +1,5 @@
+export function serverAutoImported () {
+ return 'serverAutoImported'
+}
+
+export const someUtils = 'utils'
diff --git a/test/fixtures/basic/modules/example.ts b/test/fixtures/basic/modules/example.ts
new file mode 100644
index 000000000000..c3a2706d0d24
--- /dev/null
+++ b/test/fixtures/basic/modules/example.ts
@@ -0,0 +1,20 @@
+import { addPlugin, createResolver, defineNuxtModule, useNuxt } from 'nuxt/kit'
+
+export default defineNuxtModule({
+ meta: {
+ name: 'my-module',
+ configKey: 'sampleModule',
+ },
+ setup () {
+ const resolver = createResolver(import.meta.url)
+
+ addPlugin(resolver.resolve('./runtime/plugin'))
+ useNuxt().hook('app:resolve', (app) => {
+ app.middleware.push({
+ name: 'unctx-test',
+ path: resolver.resolve('./runtime/middleware'),
+ global: true,
+ })
+ })
+ },
+})
diff --git a/test/fixtures/basic/modules/functional.ts b/test/fixtures/basic/modules/functional.ts
new file mode 100644
index 000000000000..29062a9d407f
--- /dev/null
+++ b/test/fixtures/basic/modules/functional.ts
@@ -0,0 +1,9 @@
+import { join } from 'pathe'
+import { defineNuxtModule } from 'nuxt/kit'
+
+export default defineNuxtModule(
+ function (_, nuxt) {
+ nuxt.options.optimization.treeShake.composables.server[join(nuxt.options.rootDir, 'app/composables/tree-shake.ts')] = ['useClientOnlyComposable', 'setTitleToPink']
+ nuxt.options.optimization.treeShake.composables.client[join(nuxt.options.rootDir, 'app/composables/tree-shake.ts')] = ['useServerOnlyComposable']
+ },
+)
diff --git a/test/fixtures/basic/modules/import-components/index.ts b/test/fixtures/basic/modules/import-components/index.ts
new file mode 100644
index 000000000000..b25b46f0d759
--- /dev/null
+++ b/test/fixtures/basic/modules/import-components/index.ts
@@ -0,0 +1,49 @@
+import { addComponent, createResolver, defineNuxtModule } from 'nuxt/kit'
+
+export default defineNuxtModule({
+ meta: {
+ name: 'import-components',
+ },
+ setup () {
+ const resolver = createResolver(import.meta.url)
+
+ addComponent({
+ name: 'DCompClient',
+ filePath: resolver.resolve('./runtime/components'),
+ mode: 'client',
+ })
+
+ addComponent({
+ name: 'DCompServer',
+ filePath: resolver.resolve('./runtime/components'),
+ mode: 'server',
+ })
+
+ addComponent({
+ name: 'DCompAll',
+ filePath: resolver.resolve('./runtime/components'),
+ mode: 'all',
+ })
+
+ addComponent({
+ name: 'NCompClient',
+ export: 'NComp',
+ filePath: resolver.resolve('./runtime/components'),
+ mode: 'client',
+ })
+
+ addComponent({
+ name: 'NCompServer',
+ export: 'NComp',
+ filePath: resolver.resolve('./runtime/components'),
+ mode: 'server',
+ })
+
+ addComponent({
+ name: 'NCompAll',
+ export: 'NComp',
+ filePath: resolver.resolve('./runtime/components'),
+ mode: 'all',
+ })
+ },
+})
diff --git a/test/fixtures/basic/modules/import-components/runtime/components.ts b/test/fixtures/basic/modules/import-components/runtime/components.ts
new file mode 100644
index 000000000000..96f456c19f47
--- /dev/null
+++ b/test/fixtures/basic/modules/import-components/runtime/components.ts
@@ -0,0 +1,13 @@
+import { defineComponent, h } from 'vue'
+
+export default defineComponent({
+ name: 'DComp',
+ props: { message: String },
+ render: (props: any) => h('h1', props.message),
+})
+
+export const NComp = defineComponent({
+ name: 'NComp',
+ props: { message: String },
+ render: (props: any) => h('h1', props.message),
+})
diff --git a/test/fixtures/basic/modules/lazy-import-components/index.ts b/test/fixtures/basic/modules/lazy-import-components/index.ts
new file mode 100644
index 000000000000..a4f686510c8f
--- /dev/null
+++ b/test/fixtures/basic/modules/lazy-import-components/index.ts
@@ -0,0 +1,31 @@
+import { addComponent, createResolver, defineNuxtModule } from 'nuxt/kit'
+
+export default defineNuxtModule({
+ meta: {
+ name: 'lazy-import-components',
+ },
+ setup () {
+ const resolver = createResolver(import.meta.url)
+
+ addComponent({
+ name: 'NCompClient',
+ export: 'NComp',
+ filePath: resolver.resolve('./runtime/components'),
+ mode: 'client',
+ })
+
+ addComponent({
+ name: 'NCompServer',
+ export: 'NComp',
+ filePath: resolver.resolve('./runtime/components'),
+ mode: 'server',
+ })
+
+ addComponent({
+ name: 'NCompAll',
+ export: 'NComp',
+ filePath: resolver.resolve('./runtime/components'),
+ mode: 'all',
+ })
+ },
+})
diff --git a/test/fixtures/basic/modules/lazy-import-components/runtime/components.ts b/test/fixtures/basic/modules/lazy-import-components/runtime/components.ts
new file mode 100644
index 000000000000..e9781e56e54f
--- /dev/null
+++ b/test/fixtures/basic/modules/lazy-import-components/runtime/components.ts
@@ -0,0 +1,7 @@
+import { defineComponent, h } from 'vue'
+
+export const NComp = defineComponent({
+ name: 'NComp',
+ props: { message: String },
+ render: (props: any) => h('h1', props.message),
+})
diff --git a/test/fixtures/basic/modules/page-extend/index.ts b/test/fixtures/basic/modules/page-extend/index.ts
new file mode 100644
index 000000000000..a72c5a791ad6
--- /dev/null
+++ b/test/fixtures/basic/modules/page-extend/index.ts
@@ -0,0 +1,36 @@
+import { createResolver, defineNuxtModule, useNuxt } from 'nuxt/kit'
+
+export default defineNuxtModule({
+ meta: {
+ name: 'page-extend',
+ },
+ setup () {
+ const nuxt = useNuxt()
+ const resolver = createResolver(import.meta.url)
+
+ nuxt.hook('pages:extend', (pages) => {
+ pages.push({
+ name: 'page-extend',
+ path: '/page-extend',
+ file: resolver.resolve('../runtime/page.vue'),
+ })
+ })
+
+ nuxt.hook('pages:resolved', (pages) => {
+ pages.push({
+ path: '/big-page-1',
+ file: resolver.resolve('./pages/big-page.vue'),
+ meta: {
+ layout: false,
+ },
+ },
+ {
+ path: '/big-page-2',
+ file: resolver.resolve('./pages/big-page.vue'),
+ meta: {
+ layout: false,
+ },
+ })
+ })
+ },
+})
diff --git a/test/fixtures/basic/modules/page-extend/pages/big-page.vue b/test/fixtures/basic/modules/page-extend/pages/big-page.vue
new file mode 100644
index 000000000000..1ea6542112be
--- /dev/null
+++ b/test/fixtures/basic/modules/page-extend/pages/big-page.vue
@@ -0,0 +1,48 @@
+
+
+
+ big
+
+
+ page
+
+
+ to big page 1
+
+
+ to big page 2
+
+
+ to big page 2 with ?test=test
+
+
+ to big page 2 with ?test=super-test
+
+
+
+
+
+
diff --git a/test/fixtures/basic/modules/runtime/middleware.ts b/test/fixtures/basic/modules/runtime/middleware.ts
new file mode 100644
index 000000000000..7ddcb23d820a
--- /dev/null
+++ b/test/fixtures/basic/modules/runtime/middleware.ts
@@ -0,0 +1,4 @@
+export default defineNuxtRouteMiddleware(async () => {
+ await new Promise(resolve => setTimeout(resolve, 1))
+ useNuxtApp()
+})
diff --git a/test/fixtures/basic/modules/runtime/page.vue b/test/fixtures/basic/modules/runtime/page.vue
new file mode 100644
index 000000000000..9cfda735465f
--- /dev/null
+++ b/test/fixtures/basic/modules/runtime/page.vue
@@ -0,0 +1,17 @@
+
+
+
+
+
+
+ added in pages:extend
+
+
diff --git a/test/fixtures/basic/modules/runtime/plugin.ts b/test/fixtures/basic/modules/runtime/plugin.ts
new file mode 100644
index 000000000000..61a24ed6d201
--- /dev/null
+++ b/test/fixtures/basic/modules/runtime/plugin.ts
@@ -0,0 +1,4 @@
+export default defineNuxtPlugin(async () => {
+ await new Promise(resolve => setTimeout(resolve, 1))
+ useNuxtApp()
+})
diff --git a/test/fixtures/basic/modules/test/index.ts b/test/fixtures/basic/modules/test/index.ts
new file mode 100644
index 000000000000..d604033fbb5b
--- /dev/null
+++ b/test/fixtures/basic/modules/test/index.ts
@@ -0,0 +1,7 @@
+import { defineNuxtModule } from 'nuxt/kit'
+
+export default defineNuxtModule({
+ meta: {
+ name: 'test',
+ },
+})
diff --git a/test/fixtures/basic/nuxt.config.js b/test/fixtures/basic/nuxt.config.js
deleted file mode 100644
index 652c45d196d1..000000000000
--- a/test/fixtures/basic/nuxt.config.js
+++ /dev/null
@@ -1,99 +0,0 @@
-import path from 'path'
-
-let _nuxt
-
-export default {
- render: {
- dist: {
- maxAge: ((60 * 60 * 24 * 365) * 2)
- }
- },
- router: {
- extendRoutes (routes, resolve) {
- return [{
- path: '/before-enter',
- name: 'before-enter',
- beforeEnter: (to, from, next) => { next('/') }
- }, ...routes]
- }
- },
- generate: {
- routes: [
- // TODO: generate with {build: false} does not scans pages!
- '/noloading',
- '/stateless',
- '/css',
- '/stateful',
- '/head',
- '/async-data',
- '/validate',
- '/redirect',
- '/store-module',
- '/users/1',
- '/users/2',
- '/тест雨',
- { route: '/users/3', payload: { id: 3000 } }
- ],
- interval: 200
- },
- head () {
- return {
- titleTemplate (titleChunk) {
- return titleChunk ? `${titleChunk} - Nuxt.js` : 'Nuxt.js'
- }
- }
- },
- modulesDir: path.join(__dirname, '..', '..', '..', 'node_modules'),
- hooks: {
- ready (nuxt) {
- _nuxt = nuxt
- nuxt.__hook_ready_called__ = true
- },
- build: {
- done (builder) {
- builder.__hook_built_called__ = true
- }
- },
- render: {
- routeDone (url) {
- _nuxt.__hook_render_routeDone__ = url
- }
- },
- bad: null,
- '': true
- },
- pageTransition: false,
- plugins: [
- '~/plugins/vuex-module',
- '~/plugins/dir-plugin',
- '~/plugins/inject'
- ],
- serverMiddleware: [
- {
- path: '/api/test',
- handler: (_, res) => res.end('Works!')
- }
- ],
- css: [
- '~assets/app.css'
- ],
- build: {
- scopeHoisting: true,
- publicPath: '',
- followSymlinks: true,
- splitChunks: {
- layouts: true
- },
- postcss: {
- preset: {
- features: {
- 'custom-selectors': true
- }
- },
- plugins: {
- cssnano: {},
- [path.resolve(__dirname, 'plugins', 'tailwind.js')]: {}
- }
- }
- }
-}
diff --git a/test/fixtures/basic/nuxt.config.ts b/test/fixtures/basic/nuxt.config.ts
new file mode 100644
index 000000000000..de9572c1e7c1
--- /dev/null
+++ b/test/fixtures/basic/nuxt.config.ts
@@ -0,0 +1,272 @@
+import { addBuildPlugin, addComponent } from 'nuxt/kit'
+import type { NuxtPage } from 'nuxt/schema'
+import { defu } from 'defu'
+import { createUnplugin } from 'unplugin'
+import { withoutLeadingSlash } from 'ufo'
+import { isNuxtPrepare, projectSuffix, withMatrix } from '../../matrix'
+
+export default withMatrix({
+ ...(isNuxtPrepare ? {} : { buildDir: `.nuxt-${projectSuffix}` }),
+ appId: 'nuxt-app-basic',
+ extends: [
+ './extends/node_modules/foo',
+ ],
+ // this produces an order of `~` > `~/extends/bar` > `~/extends/node_modules/foo`
+ theme: './extends/bar',
+ modules: [
+ function (_options, nuxt) {
+ // ensure setting `runtimeConfig` also sets `nitro.runtimeConfig`
+ nuxt.options.runtimeConfig = defu(nuxt.options.runtimeConfig, {
+ public: {
+ testConfig: 123,
+ },
+ })
+ },
+ function (_options, nuxt) {
+ nuxt.hook('modules:done', () => {
+ // @ts-expect-error not valid nuxt option
+ if (!nuxt.options.__installed_layer) {
+ throw new Error('layer in layers/ directory was not auto-registered')
+ }
+ })
+ },
+ '~~/custom-modules/subpath',
+ './modules/test',
+ '~~/modules/example',
+ function (_, nuxt) {
+ // Virtual CSS modules only work with Vite, not with webpack/rspack
+ if (typeof nuxt.options.builder === 'string' && (nuxt.options.builder.includes('webpack') || nuxt.options.builder.includes('rspack'))) { return }
+
+ nuxt.options.css.push('virtual.css')
+ nuxt.options.build.transpile.push('virtual.css')
+ const plugin = createUnplugin(() => ({
+ name: 'virtual',
+ resolveId (id) {
+ if (id === 'virtual.css') { return 'virtual.css' }
+ },
+ load (id) {
+ if (id.includes('virtual.css')) { return ':root { --virtual: red }' }
+ },
+ }))
+ addBuildPlugin(plugin)
+ },
+ function (_options, nuxt) {
+ nuxt.hook('pages:extend', (pages) => {
+ pages.push({
+ path: '/manual-redirect',
+ redirect: '/',
+ })
+ })
+ },
+ function (_options, nuxt) {
+ const routesToDuplicate = ['/async-parent', '/fixed-keyed-child-parent', '/keyed-child-parent', '/with-layout', '/with-layout2']
+ const stripLayout = (page: NuxtPage): NuxtPage => ({
+ ...page,
+ children: page.children?.map(child => stripLayout(child)),
+ name: 'internal-' + page.name,
+ path: withoutLeadingSlash(page.path),
+ meta: {
+ ...page.meta,
+ layout: undefined,
+ _layout: page.meta?.layout,
+ },
+ })
+ nuxt.hook('pages:resolved', (pages) => {
+ const newPages = []
+ for (const page of pages) {
+ if (routesToDuplicate.includes(page.path)) {
+ newPages.push(stripLayout(page))
+ }
+ }
+ const internalParent = pages.find(page => page.path === '/internal-layout')
+ internalParent!.children = newPages
+ })
+ },
+ function (_options, nuxt) {
+ // to check that page metadata is preserved
+ nuxt.hook('pages:resolved', (pages) => {
+ const customName = pages.find(page => page.name === 'some-custom-name')
+ if (!customName) { throw new Error('Page with custom name not found') }
+ if (customName.path !== '/some-custom-path') { throw new Error('Page path not extracted') }
+
+ customName.meta ||= {}
+ customName.meta.someProp = true
+ })
+ },
+ // To test falsy module values
+ undefined,
+ ],
+ app: {
+ pageTransition: true,
+ layoutTransition: true,
+ teleportId: 'nuxt-teleport',
+ teleportTag: 'span',
+ head: {
+ charset: 'utf-8',
+ link: [undefined],
+ meta: [
+ { name: 'viewport', content: 'width=1024, initial-scale=1' },
+ { charset: 'utf-8' },
+ { name: 'description', content: 'Nuxt Fixture' },
+ ],
+ },
+ keepalive: {
+ include: ['keepalive-in-config', 'not-keepalive-in-nuxtpage'],
+ },
+ },
+ css: ['~/assets/global.css'],
+ vue: {
+ compilerOptions: {
+ isCustomElement: (tag) => {
+ return tag === 'custom-component'
+ },
+ },
+ },
+ appConfig: {
+ fromNuxtConfig: true,
+ nested: {
+ val: 1,
+ },
+ },
+ runtimeConfig: {
+ public: {
+ needsFallback: undefined,
+ },
+ },
+ build: {
+ transpile: [
+ (ctx) => {
+ if (typeof ctx.isDev !== 'boolean') { throw new TypeError('context not passed') }
+ return false
+ },
+ ],
+ },
+ optimization: {
+ keyedComposables: [
+ {
+ name: 'useCustomKeyedComposable',
+ source: '~/other-composables-folder/custom-keyed-composable',
+ argumentLength: 1,
+ },
+ ],
+ },
+ features: {
+ inlineStyles: id => !!id && !id.includes('assets.vue'),
+ },
+ experimental: {
+ nitroAutoImports: true,
+ runtimeBaseURL: true,
+ decorators: true,
+ typedPages: true,
+ clientFallback: true,
+ restoreState: true,
+ clientNodeCompat: true,
+ componentIslands: {
+ selectiveClient: 'deep',
+ },
+ inlineRouteRules: true,
+ prefetchPreloadTags: true,
+ },
+ nitro: {
+ publicAssets: [
+ {
+ dir: './custom-public',
+ baseURL: '/custom',
+ },
+ ],
+ routeRules: {
+ '/route-rules/spa': { ssr: false },
+ '/route-rules/spa-async-data': { ssr: false },
+ '/redirect/catchall': { ssr: false },
+ '/head-spa': { ssr: false },
+ '/route-rules/middleware': { appMiddleware: 'route-rules-middleware' },
+ '/route-rules/layout': { appLayout: 'custom' },
+ '/hydration/spa-redirection/**': { ssr: false },
+ '/no-scripts': { noScripts: true },
+ '/prerender/**': { prerender: true },
+ '/route-rules/redirect': { redirect: '/' },
+ '/isr': { isr: 60 },
+ '/route-rules/isr-spa': { isr: 60, ssr: false },
+ '/route-rules/swr-in-spa/**': { ssr: false },
+ '/route-rules/swr-in-spa': { ssr: true, swr: 60 },
+ '/swr': { swr: 60 },
+ },
+ prerender: {
+ routes: [
+ '/random/a',
+ '/random/b',
+ '/random/c',
+ '/prefetch/server-components',
+ ],
+ },
+ },
+ vite: {
+ $client: {
+ build: {
+ target: ['chrome107', 'edge107', 'firefox108', 'safari17'],
+ },
+ },
+ logLevel: 'silent',
+ build: {
+ assetsInlineLimit: 100, // keep SVG as assets URL
+ },
+ },
+ postcss: {
+ plugins: {
+ '~~/postcss/plugin': {},
+ },
+ },
+ telemetry: false, // for testing telemetry types - it is auto-disabled in tests
+ hooks: {
+ 'webpack:config' (configs) {
+ // in order to test bigint serialization we need to set target to a more modern one
+ for (const config of configs) {
+ const esbuildRules = config.module!.rules!.filter(
+ rule => typeof rule === 'object' && rule && 'loader' in rule && rule.loader === 'esbuild-loader',
+ )
+ for (const rule of esbuildRules) {
+ if (typeof rule === 'object' && typeof rule?.options === 'object') {
+ rule.options.target = 'es2022'
+ }
+ }
+ }
+ },
+ 'modules:done' () {
+ addComponent({
+ name: 'CustomComponent',
+ export: 'namedExport',
+ filePath: '~/other-components-folder/named-export',
+ })
+ },
+ 'components:extend' (components) {
+ for (const comp of components) {
+ if (comp.pascalName === 'GlobalSync') {
+ comp.global = 'sync'
+ }
+ }
+ },
+ 'vite:extend' ({ config }) {
+ config.plugins!.push({
+ name: 'nuxt:server',
+ enforce: 'pre',
+ configureServer (server) {
+ server.middlewares.use((req, res, next) => {
+ if (req.url === '/vite-plugin-without-path') {
+ res.end('vite-plugin without path')
+ return
+ }
+ next()
+ })
+
+ server.middlewares.use((req, res, next) => {
+ if (req.url === '/__nuxt-test') {
+ res.end('vite-plugin with __nuxt prefix')
+ return
+ }
+ next()
+ })
+ },
+ })
+ },
+ },
+})
diff --git a/test/fixtures/basic/package.json b/test/fixtures/basic/package.json
new file mode 100644
index 000000000000..e44e97c8e1d0
--- /dev/null
+++ b/test/fixtures/basic/package.json
@@ -0,0 +1,23 @@
+{
+ "private": true,
+ "name": "fixture-basic",
+ "scripts": {
+ "build": "nuxt build"
+ },
+ "dependencies": {
+ "@nuxt/rspack-builder": "workspace:*",
+ "@nuxt/webpack-builder": "workspace:*",
+ "nuxt": "workspace:*"
+ },
+ "devDependencies": {
+ "@vue/devtools-api": "^8.1.2",
+ "defu": "^6.1.7",
+ "postcss": "^8.5.14",
+ "ufo": "^1.6.4",
+ "unplugin": "^3.0.0",
+ "vue": "^3.5.34"
+ },
+ "engines": {
+ "node": "^22.12.0 || ^24.11.0 || >=26.0.0"
+ }
+}
diff --git a/test/fixtures/basic/pages/-ignored.vue b/test/fixtures/basic/pages/-ignored.vue
deleted file mode 100644
index 33c4bfdb0364..000000000000
--- a/test/fixtures/basic/pages/-ignored.vue
+++ /dev/null
@@ -1,13 +0,0 @@
-
-
- Should be ignored
-
-
-
-
-
-
diff --git a/test/fixtures/basic/pages/async-data.vue b/test/fixtures/basic/pages/async-data.vue
deleted file mode 100644
index f999fb6871c5..000000000000
--- a/test/fixtures/basic/pages/async-data.vue
+++ /dev/null
@@ -1,13 +0,0 @@
-
- {{ name }}
-
-
-
diff --git a/test/fixtures/basic/pages/await-async-data.vue b/test/fixtures/basic/pages/await-async-data.vue
deleted file mode 100644
index 7503ffe7f51f..000000000000
--- a/test/fixtures/basic/pages/await-async-data.vue
+++ /dev/null
@@ -1,18 +0,0 @@
-
- {{ name }}
-
-
-
diff --git a/test/fixtures/basic/pages/callback-async-data.vue b/test/fixtures/basic/pages/callback-async-data.vue
deleted file mode 100644
index a3c1daf281c0..000000000000
--- a/test/fixtures/basic/pages/callback-async-data.vue
+++ /dev/null
@@ -1,13 +0,0 @@
-
- {{ name }}
-
-
-
diff --git a/test/fixtures/basic/pages/client-only.vue b/test/fixtures/basic/pages/client-only.vue
deleted file mode 100644
index cbcd7a0d0955..000000000000
--- a/test/fixtures/basic/pages/client-only.vue
+++ /dev/null
@@ -1,7 +0,0 @@
-
-
-
- Displayed only on client-side
-
-
-
diff --git a/test/fixtures/basic/pages/config.vue b/test/fixtures/basic/pages/config.vue
deleted file mode 100644
index fe39ce8aac11..000000000000
--- a/test/fixtures/basic/pages/config.vue
+++ /dev/null
@@ -1,29 +0,0 @@
-
-
-
- {{ vueConfig[key] | toStr }}
-
-
-
-
-
diff --git a/test/fixtures/basic/pages/css.vue b/test/fixtures/basic/pages/css.vue
deleted file mode 100644
index 8bf4d9da7dc0..000000000000
--- a/test/fixtures/basic/pages/css.vue
+++ /dev/null
@@ -1,15 +0,0 @@
-
-
- This is red
-
-
-
-
diff --git a/test/fixtures/basic/pages/custom.js b/test/fixtures/basic/pages/custom.js
deleted file mode 100644
index 641d087226da..000000000000
--- a/test/fixtures/basic/pages/custom.js
+++ /dev/null
@@ -1,6 +0,0 @@
-export default {
- layout: 'custom',
- render (h) {
- return h('h2', 'custom page')
- }
-}
diff --git a/test/fixtures/basic/pages/error-midd.vue b/test/fixtures/basic/pages/error-midd.vue
deleted file mode 100644
index 67ec0105be7d..000000000000
--- a/test/fixtures/basic/pages/error-midd.vue
+++ /dev/null
@@ -1,13 +0,0 @@
-
- Error page midd
-
-
-
diff --git a/test/fixtures/basic/pages/error-object.vue b/test/fixtures/basic/pages/error-object.vue
deleted file mode 100644
index b73f9f28c5e1..000000000000
--- a/test/fixtures/basic/pages/error-object.vue
+++ /dev/null
@@ -1,8 +0,0 @@
-
diff --git a/test/fixtures/basic/pages/error-string.vue b/test/fixtures/basic/pages/error-string.vue
deleted file mode 100644
index 86e9a297b66c..000000000000
--- a/test/fixtures/basic/pages/error-string.vue
+++ /dev/null
@@ -1,8 +0,0 @@
-
diff --git a/test/fixtures/basic/pages/error.vue b/test/fixtures/basic/pages/error.vue
deleted file mode 100644
index 8926c5b9e6e9..000000000000
--- a/test/fixtures/basic/pages/error.vue
+++ /dev/null
@@ -1,11 +0,0 @@
-
- Error page
-
-
-
diff --git a/test/fixtures/basic/pages/error2.vue b/test/fixtures/basic/pages/error2.vue
deleted file mode 100644
index df4ccad438db..000000000000
--- a/test/fixtures/basic/pages/error2.vue
+++ /dev/null
@@ -1,11 +0,0 @@
-
- Error page
-
-
-
diff --git a/test/fixtures/basic/pages/extractCSS.vue b/test/fixtures/basic/pages/extractCSS.vue
deleted file mode 100644
index f7c6e4fbffcc..000000000000
--- a/test/fixtures/basic/pages/extractCSS.vue
+++ /dev/null
@@ -1,9 +0,0 @@
-
-
-
-
-
diff --git a/test/fixtures/basic/pages/fetch.vue b/test/fixtures/basic/pages/fetch.vue
deleted file mode 100644
index 8b35719db4ff..000000000000
--- a/test/fixtures/basic/pages/fetch.vue
+++ /dev/null
@@ -1,34 +0,0 @@
-
-
- {{ data }}
-
- Fetch
-
-
- Reload
-
-
-
-
-
diff --git a/test/fixtures/basic/pages/fn-midd.vue b/test/fixtures/basic/pages/fn-midd.vue
deleted file mode 100644
index 59fb54513cb3..000000000000
--- a/test/fixtures/basic/pages/fn-midd.vue
+++ /dev/null
@@ -1,17 +0,0 @@
-
- Date: {{ date }}
-
-
-
diff --git a/test/fixtures/basic/pages/head.vue b/test/fixtures/basic/pages/head.vue
deleted file mode 100644
index 550794d8494b..000000000000
--- a/test/fixtures/basic/pages/head.vue
+++ /dev/null
@@ -1,28 +0,0 @@
-
-
-
I can haz meta tags
-
-
-
-
diff --git a/test/fixtures/basic/pages/ignored.test.vue b/test/fixtures/basic/pages/ignored.test.vue
deleted file mode 100644
index 33c4bfdb0364..000000000000
--- a/test/fixtures/basic/pages/ignored.test.vue
+++ /dev/null
@@ -1,13 +0,0 @@
-
-
- Should be ignored
-
-
-
-
-
-
diff --git a/test/fixtures/basic/pages/index.vue b/test/fixtures/basic/pages/index.vue
deleted file mode 100644
index 53e890d488f6..000000000000
--- a/test/fixtures/basic/pages/index.vue
+++ /dev/null
@@ -1,3 +0,0 @@
-
- Index page
-
diff --git a/test/fixtures/basic/pages/js-link.js b/test/fixtures/basic/pages/js-link.js
deleted file mode 100644
index efba7fa6977a..000000000000
--- a/test/fixtures/basic/pages/js-link.js
+++ /dev/null
@@ -1,2 +0,0 @@
-export default {
-}
diff --git a/test/fixtures/basic/pages/js-link.vue b/test/fixtures/basic/pages/js-link.vue
deleted file mode 100644
index f69c87b3c538..000000000000
--- a/test/fixtures/basic/pages/js-link.vue
+++ /dev/null
@@ -1,5 +0,0 @@
-
- vue file is first-class
-
-
-
diff --git a/test/fixtures/basic/pages/jsx-link.js b/test/fixtures/basic/pages/jsx-link.js
deleted file mode 100644
index a1a02ed7d93b..000000000000
--- a/test/fixtures/basic/pages/jsx-link.js
+++ /dev/null
@@ -1,5 +0,0 @@
-import renderLink from './jsx-link2.jsx'
-
-export default {
- render: renderLink
-}
diff --git a/test/fixtures/basic/pages/jsx-link2.jsx b/test/fixtures/basic/pages/jsx-link2.jsx
deleted file mode 100644
index e36e7df03b90..000000000000
--- a/test/fixtures/basic/pages/jsx-link2.jsx
+++ /dev/null
@@ -1,5 +0,0 @@
-export default function (h) {
- return (
-
JSX Link Page
- )
-}
diff --git a/test/fixtures/basic/pages/jsx.js b/test/fixtures/basic/pages/jsx.js
deleted file mode 100644
index 70894fc396ab..000000000000
--- a/test/fixtures/basic/pages/jsx.js
+++ /dev/null
@@ -1,7 +0,0 @@
-export default {
- render () {
- return
-
JSX Page
-
- }
-}
diff --git a/test/fixtures/basic/pages/meta.vue b/test/fixtures/basic/pages/meta.vue
deleted file mode 100644
index 4649b0239078..000000000000
--- a/test/fixtures/basic/pages/meta.vue
+++ /dev/null
@@ -1,12 +0,0 @@
-
- {{ $store.state.meta }}
-
-
-
diff --git a/test/fixtures/basic/pages/no-ssr.vue b/test/fixtures/basic/pages/no-ssr.vue
deleted file mode 100644
index 16f7827aad76..000000000000
--- a/test/fixtures/basic/pages/no-ssr.vue
+++ /dev/null
@@ -1,7 +0,0 @@
-
-
-
- Displayed only on client-side
-
-
-
diff --git a/test/fixtures/basic/pages/noloading.vue b/test/fixtures/basic/pages/noloading.vue
deleted file mode 100644
index eb778a8208c3..000000000000
--- a/test/fixtures/basic/pages/noloading.vue
+++ /dev/null
@@ -1,27 +0,0 @@
-
-
-
{{ name }}
-
{{ loaded }}
-
-
-
diff --git a/test/fixtures/basic/pages/postcss.vue b/test/fixtures/basic/pages/postcss.vue
deleted file mode 100644
index 976a4f653b4c..000000000000
--- a/test/fixtures/basic/pages/postcss.vue
+++ /dev/null
@@ -1,15 +0,0 @@
-
-
- This is red
-
-
-
-
diff --git a/test/fixtures/basic/pages/redirect-external.vue b/test/fixtures/basic/pages/redirect-external.vue
deleted file mode 100644
index a1c712cb648a..000000000000
--- a/test/fixtures/basic/pages/redirect-external.vue
+++ /dev/null
@@ -1,11 +0,0 @@
-
- Redirecting...
-
-
-
diff --git a/test/fixtures/basic/pages/redirect-middleware.vue b/test/fixtures/basic/pages/redirect-middleware.vue
deleted file mode 100644
index 092193ddb287..000000000000
--- a/test/fixtures/basic/pages/redirect-middleware.vue
+++ /dev/null
@@ -1,8 +0,0 @@
-
diff --git a/test/fixtures/basic/pages/redirect-name.vue b/test/fixtures/basic/pages/redirect-name.vue
deleted file mode 100644
index 51e8eaf5cbd8..000000000000
--- a/test/fixtures/basic/pages/redirect-name.vue
+++ /dev/null
@@ -1,11 +0,0 @@
-
- Redirecting...
-
-
-
diff --git a/test/fixtures/basic/pages/redirect.vue b/test/fixtures/basic/pages/redirect.vue
deleted file mode 100644
index 2ee3d865c0e2..000000000000
--- a/test/fixtures/basic/pages/redirect.vue
+++ /dev/null
@@ -1,11 +0,0 @@
-
- Redirecting...
-
-
-
diff --git a/test/fixtures/basic/pages/refresh-page-data.vue b/test/fixtures/basic/pages/refresh-page-data.vue
deleted file mode 100644
index 491f45fb05a9..000000000000
--- a/test/fixtures/basic/pages/refresh-page-data.vue
+++ /dev/null
@@ -1,15 +0,0 @@
-
-
- Hello from {{ name }}
-
-
-
-
diff --git a/test/fixtures/basic/pages/router-guard.vue b/test/fixtures/basic/pages/router-guard.vue
deleted file mode 100644
index 03bd45b56636..000000000000
--- a/test/fixtures/basic/pages/router-guard.vue
+++ /dev/null
@@ -1,11 +0,0 @@
-
- Router Guard
-
-
-
diff --git a/test/fixtures/basic/pages/scroll-to-top/index.vue b/test/fixtures/basic/pages/scroll-to-top/index.vue
deleted file mode 100644
index 451d861a8a6e..000000000000
--- a/test/fixtures/basic/pages/scroll-to-top/index.vue
+++ /dev/null
@@ -1,24 +0,0 @@
-
-
-
- go to scroll-to-top-true
-
-
- go to scroll-to-top-false
-
-
- go to the same page
-
-
-
-
-
-
-
diff --git a/test/fixtures/basic/pages/scroll-to-top/scroll-to-top-false.vue b/test/fixtures/basic/pages/scroll-to-top/scroll-to-top-false.vue
deleted file mode 100644
index f185b8499108..000000000000
--- a/test/fixtures/basic/pages/scroll-to-top/scroll-to-top-false.vue
+++ /dev/null
@@ -1,13 +0,0 @@
-
-
-
- go to index
-
-
-
-
-
diff --git a/test/fixtures/basic/pages/scroll-to-top/scroll-to-top-true.vue b/test/fixtures/basic/pages/scroll-to-top/scroll-to-top-true.vue
deleted file mode 100644
index 050b4a773761..000000000000
--- a/test/fixtures/basic/pages/scroll-to-top/scroll-to-top-true.vue
+++ /dev/null
@@ -1,13 +0,0 @@
-
-
-
- go to index
-
-
-
-
-
diff --git a/test/fixtures/basic/pages/scroll-to-top/watch-query-array.vue b/test/fixtures/basic/pages/scroll-to-top/watch-query-array.vue
deleted file mode 100644
index 2c5ee3c60226..000000000000
--- a/test/fixtures/basic/pages/scroll-to-top/watch-query-array.vue
+++ /dev/null
@@ -1,19 +0,0 @@
-
-
-
- go to the same page
-
-
-
-
-
-
-
diff --git a/test/fixtures/basic/pages/scroll-to-top/watch-query-fn.vue b/test/fixtures/basic/pages/scroll-to-top/watch-query-fn.vue
deleted file mode 100644
index 4d49ec094a8e..000000000000
--- a/test/fixtures/basic/pages/scroll-to-top/watch-query-fn.vue
+++ /dev/null
@@ -1,24 +0,0 @@
-
-
-
- go to the same page with other test
-
-
- go to the same page with param other
-
-
-
-
-
-
-
diff --git a/test/fixtures/basic/pages/scroll-to-top/watch-query-true.vue b/test/fixtures/basic/pages/scroll-to-top/watch-query-true.vue
deleted file mode 100644
index c6df045b3b98..000000000000
--- a/test/fixtures/basic/pages/scroll-to-top/watch-query-true.vue
+++ /dev/null
@@ -1,19 +0,0 @@
-
-
-
- go to the same page
-
-
-
-
-
-
-
diff --git a/test/fixtures/basic/pages/special-state.vue b/test/fixtures/basic/pages/special-state.vue
deleted file mode 100644
index cc6aed9c87ab..000000000000
--- a/test/fixtures/basic/pages/special-state.vue
+++ /dev/null
@@ -1,15 +0,0 @@
-
- Special state in `window.__NUXT__`
-
-
-
diff --git a/test/fixtures/basic/pages/stateful.vue b/test/fixtures/basic/pages/stateful.vue
deleted file mode 100644
index 3931e79db142..000000000000
--- a/test/fixtures/basic/pages/stateful.vue
+++ /dev/null
@@ -1,16 +0,0 @@
-
-
-
The answer is {{ answer }}
-
-
-
diff --git a/test/fixtures/basic/pages/stateless.vue b/test/fixtures/basic/pages/stateless.vue
deleted file mode 100644
index fc2eef5cf0e7..000000000000
--- a/test/fixtures/basic/pages/stateless.vue
+++ /dev/null
@@ -1,3 +0,0 @@
-
- My component!
-
diff --git a/test/fixtures/basic/pages/store-module.vue b/test/fixtures/basic/pages/store-module.vue
deleted file mode 100644
index c7b8d2675921..000000000000
--- a/test/fixtures/basic/pages/store-module.vue
+++ /dev/null
@@ -1,11 +0,0 @@
-
- {{ $store.state.simpleModule.mutateMe }}
-
-
-
diff --git a/test/fixtures/basic/pages/store.vue b/test/fixtures/basic/pages/store.vue
deleted file mode 100644
index 9cb29c2bd212..000000000000
--- a/test/fixtures/basic/pages/store.vue
+++ /dev/null
@@ -1,27 +0,0 @@
-
-
-
foo/bar/baz: {{ baz }}
- index/counter: {{ $store.state.counter }}
- foo/blarg/getVal: {{ getVal }}
- foo/bab/getBabVal: {{ getBabVal }}
-
- +1
-
-
-
-
-
diff --git a/test/fixtures/basic/pages/style.vue b/test/fixtures/basic/pages/style.vue
deleted file mode 100644
index b973494ea5d5..000000000000
--- a/test/fixtures/basic/pages/style.vue
+++ /dev/null
@@ -1,18 +0,0 @@
-
-
-
H1 is rebeccapurple
- {{ $style }}
-
-
-
-
-
-
diff --git a/test/fixtures/basic/pages/symlink/deep/nested-symlinked.vue b/test/fixtures/basic/pages/symlink/deep/nested-symlinked.vue
deleted file mode 100644
index 5f2d4a4ff602..000000000000
--- a/test/fixtures/basic/pages/symlink/deep/nested-symlinked.vue
+++ /dev/null
@@ -1,3 +0,0 @@
-
- Nested symlink page
-
diff --git a/test/fixtures/basic/pages/symlink/symlinked.vue b/test/fixtures/basic/pages/symlink/symlinked.vue
deleted file mode 100644
index 2a7c4a1c978f..000000000000
--- a/test/fixtures/basic/pages/symlink/symlinked.vue
+++ /dev/null
@@ -1,3 +0,0 @@
-
- Symlinked page
-
diff --git a/test/fixtures/basic/pages/users/_id.vue b/test/fixtures/basic/pages/users/_id.vue
deleted file mode 100644
index 188dceb74f33..000000000000
--- a/test/fixtures/basic/pages/users/_id.vue
+++ /dev/null
@@ -1,12 +0,0 @@
-
- User: {{ id }}
-
-
-
diff --git a/test/fixtures/basic/pages/validate-async.vue b/test/fixtures/basic/pages/validate-async.vue
deleted file mode 100644
index 08bd68bb8a0d..000000000000
--- a/test/fixtures/basic/pages/validate-async.vue
+++ /dev/null
@@ -1,21 +0,0 @@
-
- I am valid
-
-
-
diff --git a/test/fixtures/basic/pages/validate.vue b/test/fixtures/basic/pages/validate.vue
deleted file mode 100644
index 05180f8a0d18..000000000000
--- a/test/fixtures/basic/pages/validate.vue
+++ /dev/null
@@ -1,17 +0,0 @@
-
- I am valid
-
-
-
diff --git "a/test/fixtures/basic/pages/\321\202\320\265\321\201\321\202\351\233\250.vue" "b/test/fixtures/basic/pages/\321\202\320\265\321\201\321\202\351\233\250.vue"
deleted file mode 100644
index b7953cf6c7b2..000000000000
--- "a/test/fixtures/basic/pages/\321\202\320\265\321\201\321\202\351\233\250.vue"
+++ /dev/null
@@ -1,3 +0,0 @@
-
- Hello unicode!
-
diff --git a/test/fixtures/basic/pages2/deep/nested-symlinked.vue b/test/fixtures/basic/pages2/deep/nested-symlinked.vue
deleted file mode 100644
index 5f2d4a4ff602..000000000000
--- a/test/fixtures/basic/pages2/deep/nested-symlinked.vue
+++ /dev/null
@@ -1,3 +0,0 @@
-
- Nested symlink page
-
diff --git a/test/fixtures/basic/pages2/symlinked.vue b/test/fixtures/basic/pages2/symlinked.vue
deleted file mode 100644
index 2a7c4a1c978f..000000000000
--- a/test/fixtures/basic/pages2/symlinked.vue
+++ /dev/null
@@ -1,3 +0,0 @@
-
- Symlinked page
-
diff --git a/test/fixtures/basic/plugins/dir-plugin/index.js b/test/fixtures/basic/plugins/dir-plugin/index.js
deleted file mode 100644
index 5f61014c4639..000000000000
--- a/test/fixtures/basic/plugins/dir-plugin/index.js
+++ /dev/null
@@ -1,3 +0,0 @@
-if (process.client) {
- window.__test_plugin = true
-}
diff --git a/test/fixtures/basic/plugins/inject.js b/test/fixtures/basic/plugins/inject.js
deleted file mode 100644
index d9cbae08d5e2..000000000000
--- a/test/fixtures/basic/plugins/inject.js
+++ /dev/null
@@ -1,17 +0,0 @@
-export default ({ route, params }, inject) => {
- const { injectValue } = route.query
- if (typeof injectValue === 'undefined') {
- return
- }
- const key = 'injectedProperty'
- const map = {
- undefined,
- null: null,
- false: false,
- 0: 0,
- empty: '',
- foo: 'bar'
- }
- const value = map[injectValue]
- inject(key, value)
-}
diff --git a/test/fixtures/basic/plugins/tailwind.js b/test/fixtures/basic/plugins/tailwind.js
deleted file mode 100644
index b3d0b7a30859..000000000000
--- a/test/fixtures/basic/plugins/tailwind.js
+++ /dev/null
@@ -1,6 +0,0 @@
-
-const postcss = require('postcss')
-
-module.exports = postcss.plugin('nuxt-test', () => {
- return function () {}
-})
diff --git a/test/fixtures/basic/plugins/vuex-module.js b/test/fixtures/basic/plugins/vuex-module.js
deleted file mode 100644
index c482b0571a5c..000000000000
--- a/test/fixtures/basic/plugins/vuex-module.js
+++ /dev/null
@@ -1,18 +0,0 @@
-export default function ({ store }) {
- store.registerModule('simpleModule', {
- namespaced: true,
- state: () => ({
- mutateMe: 'not mutated'
- }),
- actions: {
- mutate ({ commit }) {
- commit('mutate')
- }
- },
- mutations: {
- mutate (state) {
- state.mutateMe = 'mutated'
- }
- }
- })
-}
diff --git a/test/fixtures/basic/postcss/plugin.ts b/test/fixtures/basic/postcss/plugin.ts
new file mode 100644
index 000000000000..87fe841883ef
--- /dev/null
+++ b/test/fixtures/basic/postcss/plugin.ts
@@ -0,0 +1,11 @@
+import type { Plugin } from 'postcss'
+
+const componentRoot = (_opts = {}): Plugin => {
+ console.log('loaded custom postcss plugin')
+ return {
+ postcssPlugin: 'custom-postcss-plugin',
+ }
+}
+componentRoot.postcss = true
+
+export default componentRoot
diff --git a/test/fixtures/basic/public/css-only-public-asset.svg b/test/fixtures/basic/public/css-only-public-asset.svg
new file mode 100644
index 000000000000..dce8bc023673
--- /dev/null
+++ b/test/fixtures/basic/public/css-only-public-asset.svg
@@ -0,0 +1 @@
+
+
+
+
+
+
+
+
+
+
diff --git a/test/fixtures/basic/server/api/app-config.ts b/test/fixtures/basic/server/api/app-config.ts
new file mode 100644
index 000000000000..b58057d1dbb8
--- /dev/null
+++ b/test/fixtures/basic/server/api/app-config.ts
@@ -0,0 +1,6 @@
+export default defineEventHandler(() => {
+ const appConfig = useAppConfig()
+ return {
+ appConfig,
+ }
+})
diff --git a/test/fixtures/basic/server/api/auto-imports.ts b/test/fixtures/basic/server/api/auto-imports.ts
new file mode 100644
index 000000000000..efb188df1b74
--- /dev/null
+++ b/test/fixtures/basic/server/api/auto-imports.ts
@@ -0,0 +1,7 @@
+export default defineEventHandler(() => {
+ return {
+ thisIs: autoimportedFunction(),
+ autoImported: someUtils,
+ fromServerDir: testUtils,
+ }
+})
diff --git a/test/fixtures/basic/server/api/counter.ts b/test/fixtures/basic/server/api/counter.ts
new file mode 100644
index 000000000000..8cdb1c14aa7a
--- /dev/null
+++ b/test/fixtures/basic/server/api/counter.ts
@@ -0,0 +1,3 @@
+let counter = 0
+
+export default defineEventHandler(() => ({ count: counter++ }))
diff --git a/test/fixtures/basic/server/api/error.ts b/test/fixtures/basic/server/api/error.ts
new file mode 100644
index 000000000000..9df89d636fe2
--- /dev/null
+++ b/test/fixtures/basic/server/api/error.ts
@@ -0,0 +1,5 @@
+import { HTTPError, defineEventHandler } from 'nitro/h3'
+
+export default defineEventHandler(() => {
+ throw new HTTPError({ status: 400 })
+})
diff --git a/test/fixtures/basic/server/api/experimental/decorators.ts b/test/fixtures/basic/server/api/experimental/decorators.ts
new file mode 100644
index 000000000000..94de19fce7b2
--- /dev/null
+++ b/test/fixtures/basic/server/api/experimental/decorators.ts
@@ -0,0 +1,14 @@
+export default eventHandler((_event) => {
+ function something (_method: () => unknown) {
+ return () => 'decorated'
+ }
+
+ class SomeClass {
+ @something
+ public someMethod () {
+ return 'initial'
+ }
+ }
+
+ return new SomeClass().someMethod()
+})
diff --git a/test/fixtures/basic/server/api/hello.ts b/test/fixtures/basic/server/api/hello.ts
new file mode 100644
index 000000000000..569613d6f79e
--- /dev/null
+++ b/test/fixtures/basic/server/api/hello.ts
@@ -0,0 +1 @@
+export default defineEventHandler(() => 'Hello API')
diff --git a/test/fixtures/basic/server/api/hey/index.get.ts b/test/fixtures/basic/server/api/hey/index.get.ts
new file mode 100644
index 000000000000..e937164878b1
--- /dev/null
+++ b/test/fixtures/basic/server/api/hey/index.get.ts
@@ -0,0 +1,4 @@
+export default defineEventHandler(() => ({
+ foo: 'bar',
+ baz: 'qux',
+}))
diff --git a/test/fixtures/basic/server/api/hey/index.post.ts b/test/fixtures/basic/server/api/hey/index.post.ts
new file mode 100644
index 000000000000..f30bc979aca8
--- /dev/null
+++ b/test/fixtures/basic/server/api/hey/index.post.ts
@@ -0,0 +1,3 @@
+export default defineEventHandler(() => ({
+ method: 'post' as const,
+}))
diff --git a/test/fixtures/basic/server/api/preview.ts b/test/fixtures/basic/server/api/preview.ts
new file mode 100644
index 000000000000..2813ef2276ae
--- /dev/null
+++ b/test/fixtures/basic/server/api/preview.ts
@@ -0,0 +1,8 @@
+const apiKeyName = 'apiKey'
+const apiKey = 'hehe'
+
+export default defineEventHandler((event) => {
+ return {
+ hehe: getQuery(event)[apiKeyName] === apiKey,
+ }
+})
diff --git a/test/fixtures/basic/server/api/random.ts b/test/fixtures/basic/server/api/random.ts
new file mode 100644
index 000000000000..e30a14cdba06
--- /dev/null
+++ b/test/fixtures/basic/server/api/random.ts
@@ -0,0 +1,3 @@
+export default defineEventHandler(() => {
+ return new Array(10).fill(0).map(() => Math.round(Math.random() * 10000))
+})
diff --git a/test/fixtures/basic/server/api/union.ts b/test/fixtures/basic/server/api/union.ts
new file mode 100644
index 000000000000..3401498fc152
--- /dev/null
+++ b/test/fixtures/basic/server/api/union.ts
@@ -0,0 +1,4 @@
+export default defineEventHandler(() => ({
+ type: 'a',
+ foo: 'bar',
+}) as { type: 'a', foo: string } | { type: 'b', baz: string })
diff --git a/test/fixtures/basic/server/api/useAsyncData/count.ts b/test/fixtures/basic/server/api/useAsyncData/count.ts
new file mode 100644
index 000000000000..b529bb034ce1
--- /dev/null
+++ b/test/fixtures/basic/server/api/useAsyncData/count.ts
@@ -0,0 +1,9 @@
+let counter = 0
+
+const test = () => () => {
+ // TODO: useNuxtApp should be undefined when type-testing a nitro route
+ useNuxtApp()
+}
+test()
+
+export default defineEventHandler(() => ({ count: counter++ }))
diff --git a/test/fixtures/basic/server/api/very-long-request.ts b/test/fixtures/basic/server/api/very-long-request.ts
new file mode 100644
index 000000000000..472c16f4583a
--- /dev/null
+++ b/test/fixtures/basic/server/api/very-long-request.ts
@@ -0,0 +1,7 @@
+export default defineEventHandler(async () => {
+ await timeout(20)
+ return 'that was very long ...'
+})
+function timeout (ms: number) {
+ return new Promise(resolve => setTimeout(resolve, ms))
+}
diff --git a/test/fixtures/basic/server/plugins/headers.ts b/test/fixtures/basic/server/plugins/headers.ts
new file mode 100644
index 000000000000..0d022f70001d
--- /dev/null
+++ b/test/fixtures/basic/server/plugins/headers.ts
@@ -0,0 +1,12 @@
+import { definePlugin } from 'nitro'
+import { useNitroHooks } from 'nitro/app'
+
+export default definePlugin(() => {
+ if (!import.meta.dev) { return }
+ useNitroHooks().hook('error', (error) => {
+ // TODO: somehow add error logging assertion to @nuxt/test-utils
+ if (error.message?.includes('Cannot set headers after they are sent to the client')) {
+ process.exit(1)
+ }
+ })
+})
diff --git a/test/fixtures/basic/server/routes/ignore/scanned.ts b/test/fixtures/basic/server/routes/ignore/scanned.ts
new file mode 100644
index 000000000000..8b4f8b7d3b79
--- /dev/null
+++ b/test/fixtures/basic/server/routes/ignore/scanned.ts
@@ -0,0 +1,3 @@
+export default defineEventHandler(() => {
+ return 'this should be ignored'
+})
diff --git a/test/fixtures/basic/server/routes/proxy.ts b/test/fixtures/basic/server/routes/proxy.ts
new file mode 100644
index 000000000000..9e6cb466358b
--- /dev/null
+++ b/test/fixtures/basic/server/routes/proxy.ts
@@ -0,0 +1,7 @@
+export default defineEventHandler(async () => {
+ return new Response(await $fetch('/'), {
+ headers: {
+ 'content-type': 'text/html;charset=UTF-8',
+ },
+ })
+})
diff --git a/test/fixtures/basic/static/body.js b/test/fixtures/basic/static/body.js
deleted file mode 100644
index e1b53316d4c5..000000000000
--- a/test/fixtures/basic/static/body.js
+++ /dev/null
@@ -1,2 +0,0 @@
-/* eslint-disable no-console */
-console.log('Body script!')
diff --git a/test/fixtures/basic/store/-ignored.js b/test/fixtures/basic/store/-ignored.js
deleted file mode 100644
index 55585a388cef..000000000000
--- a/test/fixtures/basic/store/-ignored.js
+++ /dev/null
@@ -1 +0,0 @@
-throw new Error('This file should be ignored!!')
diff --git a/test/fixtures/basic/store/bab/index.js b/test/fixtures/basic/store/bab/index.js
deleted file mode 100644
index 16b0df94deff..000000000000
--- a/test/fixtures/basic/store/bab/index.js
+++ /dev/null
@@ -1,9 +0,0 @@
-export const state = () => ({
- babVal: 10
-})
-
-export const getters = {
- getBabVal (state) {
- return state.babVal
- }
-}
diff --git a/test/fixtures/basic/store/foo/bar.js b/test/fixtures/basic/store/foo/bar.js
deleted file mode 100644
index 9a709f66e74d..000000000000
--- a/test/fixtures/basic/store/foo/bar.js
+++ /dev/null
@@ -1,9 +0,0 @@
-export const state = () => ({
- baz: 'Vuex Nested Modules'
-})
-
-export const getters = {
- baz (state) {
- return state.baz
- }
-}
diff --git a/test/fixtures/basic/store/foo/blarg.js b/test/fixtures/basic/store/foo/blarg.js
deleted file mode 100644
index 6c10710f4b64..000000000000
--- a/test/fixtures/basic/store/foo/blarg.js
+++ /dev/null
@@ -1,9 +0,0 @@
-export const state = () => ({
- val: 1
-})
-
-export const getters = {
- getVal (state) {
- return 100
- }
-}
diff --git a/test/fixtures/basic/store/foo/blarg/getters.js b/test/fixtures/basic/store/foo/blarg/getters.js
deleted file mode 100644
index c319a166e830..000000000000
--- a/test/fixtures/basic/store/foo/blarg/getters.js
+++ /dev/null
@@ -1,5 +0,0 @@
-export default {
- getVal (state) {
- return state.val
- }
-}
diff --git a/test/fixtures/basic/store/foo/blarg/index.js b/test/fixtures/basic/store/foo/blarg/index.js
deleted file mode 100644
index eebf1f33dc8e..000000000000
--- a/test/fixtures/basic/store/foo/blarg/index.js
+++ /dev/null
@@ -1,9 +0,0 @@
-export const state = () => ({
- val: 2
-})
-
-export const getters = {
- getVal (state) {
- return 99
- }
-}
diff --git a/test/fixtures/basic/store/foo/blarg/state.js b/test/fixtures/basic/store/foo/blarg/state.js
deleted file mode 100644
index b5a088b8e3de..000000000000
--- a/test/fixtures/basic/store/foo/blarg/state.js
+++ /dev/null
@@ -1,3 +0,0 @@
-export default () => ({
- val: 4
-})
diff --git a/test/fixtures/basic/store/ignored.test.js b/test/fixtures/basic/store/ignored.test.js
deleted file mode 100644
index 55585a388cef..000000000000
--- a/test/fixtures/basic/store/ignored.test.js
+++ /dev/null
@@ -1 +0,0 @@
-throw new Error('This file should be ignored!!')
diff --git a/test/fixtures/basic/store/index.js b/test/fixtures/basic/store/index.js
deleted file mode 100644
index 28dd1561b451..000000000000
--- a/test/fixtures/basic/store/index.js
+++ /dev/null
@@ -1,13 +0,0 @@
-export const state = () => ({
- counter: 1,
- meta: []
-})
-
-export const mutations = {
- increment (state) {
- state.counter++
- },
- setMeta (state, meta) {
- state.meta = meta
- }
-}
diff --git a/test/fixtures/basic/tsconfig.json b/test/fixtures/basic/tsconfig.json
new file mode 100644
index 000000000000..6ae5970c766b
--- /dev/null
+++ b/test/fixtures/basic/tsconfig.json
@@ -0,0 +1,17 @@
+{
+ "files": [],
+ "references": [
+ {
+ "path": "./.nuxt/tsconfig.app.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.server.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.shared.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.node.json"
+ }
+ ]
+}
diff --git a/test/fixtures/build-assets-dir-collision/app/abc/main.css b/test/fixtures/build-assets-dir-collision/app/abc/main.css
new file mode 100644
index 000000000000..1bd72d394a26
--- /dev/null
+++ b/test/fixtures/build-assets-dir-collision/app/abc/main.css
@@ -0,0 +1 @@
+.regression-marker { color: rebeccapurple; }
diff --git a/test/fixtures/build-assets-dir-collision/app/app.vue b/test/fixtures/build-assets-dir-collision/app/app.vue
new file mode 100644
index 000000000000..131be042e3a3
--- /dev/null
+++ b/test/fixtures/build-assets-dir-collision/app/app.vue
@@ -0,0 +1,9 @@
+
+
+ hello {{ msg }}
+
+
+
+
diff --git a/test/fixtures/build-assets-dir-collision/nuxt.config.ts b/test/fixtures/build-assets-dir-collision/nuxt.config.ts
new file mode 100644
index 000000000000..0d2eb7a15ae4
--- /dev/null
+++ b/test/fixtures/build-assets-dir-collision/nuxt.config.ts
@@ -0,0 +1,9 @@
+import { withMatrix } from '../../matrix'
+
+// Regression fixture for nuxt/nuxt#24035: `buildAssetsDir` ('abc') collides
+// with a source directory of the same name that contains a CSS file
+// referenced via the `@/` alias.
+export default withMatrix({
+ app: { buildAssetsDir: 'abc' },
+ css: ['@/abc/main.css'],
+})
diff --git a/test/fixtures/build-assets-dir-collision/package.json b/test/fixtures/build-assets-dir-collision/package.json
new file mode 100644
index 000000000000..95f96b533264
--- /dev/null
+++ b/test/fixtures/build-assets-dir-collision/package.json
@@ -0,0 +1,13 @@
+{
+ "private": true,
+ "name": "fixture-build-assets-dir-collision",
+ "scripts": {
+ "build": "nuxt build"
+ },
+ "dependencies": {
+ "nuxt": "workspace:*"
+ },
+ "engines": {
+ "node": "^22.12.0 || ^24.11.0 || >=26.0.0"
+ }
+}
diff --git a/test/fixtures/build-assets-dir-collision/tsconfig.json b/test/fixtures/build-assets-dir-collision/tsconfig.json
new file mode 100644
index 000000000000..6ae5970c766b
--- /dev/null
+++ b/test/fixtures/build-assets-dir-collision/tsconfig.json
@@ -0,0 +1,17 @@
+{
+ "files": [],
+ "references": [
+ {
+ "path": "./.nuxt/tsconfig.app.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.server.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.shared.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.node.json"
+ }
+ ]
+}
diff --git a/test/fixtures/children/children.test.js b/test/fixtures/children/children.test.js
deleted file mode 100644
index bdb6719e9989..000000000000
--- a/test/fixtures/children/children.test.js
+++ /dev/null
@@ -1,3 +0,0 @@
-import { buildFixture } from '../../utils/build'
-
-buildFixture('children')
diff --git a/test/fixtures/children/layouts/patch.vue b/test/fixtures/children/layouts/patch.vue
deleted file mode 100644
index ae84f457b510..000000000000
--- a/test/fixtures/children/layouts/patch.vue
+++ /dev/null
@@ -1,62 +0,0 @@
-
-
-
-
-
-
- /patch
-
-
-
-
- /patch/1
-
-
-
-
- /patch/2
-
-
-
-
- /patch/2#test
-
-
-
-
- /patch/2/child
-
-
-
-
- /patch/2/child/1
-
-
-
-
- /patch/2/child/1?query=true
-
-
-
-
- /patch/2/child/1?query=true#test
-
-
-
-
- /patch/2/reuse
-
-
-
-
- /patch/2/reuse/1
-
-
-
-
- /patch/2/reuse/2
-
-
-
-
diff --git a/test/fixtures/children/pages/parent.vue b/test/fixtures/children/pages/parent.vue
deleted file mode 100644
index bbebc8b7dc36..000000000000
--- a/test/fixtures/children/pages/parent.vue
+++ /dev/null
@@ -1,23 +0,0 @@
-
-
-
I am the {{ name }}
-
-
-
diff --git a/test/fixtures/children/pages/parent/_id.vue b/test/fixtures/children/pages/parent/_id.vue
deleted file mode 100644
index 76f5cc0fe219..000000000000
--- a/test/fixtures/children/pages/parent/_id.vue
+++ /dev/null
@@ -1,20 +0,0 @@
-
- Id={{ id }}
-
-
-
diff --git a/test/fixtures/children/pages/parent/child.vue b/test/fixtures/children/pages/parent/child.vue
deleted file mode 100644
index 172ed67ababa..000000000000
--- a/test/fixtures/children/pages/parent/child.vue
+++ /dev/null
@@ -1,3 +0,0 @@
-
- I am the child
-
diff --git a/test/fixtures/children/pages/parent/validate-child.vue b/test/fixtures/children/pages/parent/validate-child.vue
deleted file mode 100644
index 4fd4d4bb2d04..000000000000
--- a/test/fixtures/children/pages/parent/validate-child.vue
+++ /dev/null
@@ -1,11 +0,0 @@
-
- Child valid
-
-
-
diff --git a/test/fixtures/children/pages/patch.vue b/test/fixtures/children/pages/patch.vue
deleted file mode 100644
index f6c9a175f330..000000000000
--- a/test/fixtures/children/pages/patch.vue
+++ /dev/null
@@ -1,21 +0,0 @@
-
-
-
- patch:
- {{ date }}
-
-
-
-
-
diff --git a/test/fixtures/children/pages/patch/_id.vue b/test/fixtures/children/pages/patch/_id.vue
deleted file mode 100644
index 9d3b1b09f848..000000000000
--- a/test/fixtures/children/pages/patch/_id.vue
+++ /dev/null
@@ -1,20 +0,0 @@
-
-
-
- _id:
- {{ date }}
-
-
-
-
-
diff --git a/test/fixtures/children/pages/patch/_id/child.vue b/test/fixtures/children/pages/patch/_id/child.vue
deleted file mode 100644
index f12bf2d732db..000000000000
--- a/test/fixtures/children/pages/patch/_id/child.vue
+++ /dev/null
@@ -1,20 +0,0 @@
-
-
-
- child:
- {{ date }}
-
-
-
-
-
diff --git a/test/fixtures/children/pages/patch/_id/child/_slug.vue b/test/fixtures/children/pages/patch/_id/child/_slug.vue
deleted file mode 100644
index 88b2883bfcc9..000000000000
--- a/test/fixtures/children/pages/patch/_id/child/_slug.vue
+++ /dev/null
@@ -1,62 +0,0 @@
-
-
-
- _slug:
- {{ date }}
-
-
-
-
-
-
-
diff --git a/test/fixtures/children/pages/patch/_id/index.vue b/test/fixtures/children/pages/patch/_id/index.vue
deleted file mode 100644
index d86b9896cf66..000000000000
--- a/test/fixtures/children/pages/patch/_id/index.vue
+++ /dev/null
@@ -1,3 +0,0 @@
-
- Index
-
diff --git a/test/fixtures/children/pages/patch/_id/reuse/_slug.vue b/test/fixtures/children/pages/patch/_id/reuse/_slug.vue
deleted file mode 100644
index 78f6cf066294..000000000000
--- a/test/fixtures/children/pages/patch/_id/reuse/_slug.vue
+++ /dev/null
@@ -1,20 +0,0 @@
-
-
-
- _slug:
- {{ date }}
-
-
-
-
-
-
diff --git a/test/fixtures/children/pages/patch/index.vue b/test/fixtures/children/pages/patch/index.vue
deleted file mode 100644
index 5d848671f366..000000000000
--- a/test/fixtures/children/pages/patch/index.vue
+++ /dev/null
@@ -1,3 +0,0 @@
-
- Index
-
diff --git a/test/fixtures/cli/cli.build.config.js b/test/fixtures/cli/cli.build.config.js
deleted file mode 100644
index 47c43979a0e0..000000000000
--- a/test/fixtures/cli/cli.build.config.js
+++ /dev/null
@@ -1,17 +0,0 @@
-import consola from 'consola'
-
-export default {
- test: true,
- mode: 'spa',
- hooks (hook) {
- hook('build:done', () => {
- consola.log('Compiled successfully')
- })
- hook('listen', (server, { port, host }) => {
- consola.log(`Listening on http://${host}:${port}`)
- })
- },
- build: {
- terser: false
- }
-}
diff --git a/test/fixtures/cli/cli.build.test.js b/test/fixtures/cli/cli.build.test.js
deleted file mode 100644
index a49f09f01d82..000000000000
--- a/test/fixtures/cli/cli.build.test.js
+++ /dev/null
@@ -1,20 +0,0 @@
-import { NuxtCommand, commands } from '@nuxt/cli'
-import consola from 'consola'
-
-describe('cli build', () => {
- test('nuxt build', async () => {
- const buildCommand = await commands.default('build')
-
- const argv = [
- __dirname,
- '--no-force-exit',
- '-c',
- 'cli.build.config.js'
- ]
-
- const cmd = new NuxtCommand(buildCommand, argv)
- await expect(cmd.run()).resolves.toBeUndefined()
-
- expect(consola.log).toBeCalledWith('Compiled successfully')
- })
-})
diff --git a/test/fixtures/cli/cli.gen.config.js b/test/fixtures/cli/cli.gen.config.js
deleted file mode 100644
index 906efad1f357..000000000000
--- a/test/fixtures/cli/cli.gen.config.js
+++ /dev/null
@@ -1,21 +0,0 @@
-import consola from 'consola'
-
-export default {
- test: true,
- buildDir: '.nuxt-generate/build',
- generate: {
- dir: '.nuxt-generate/generate'
- },
- hooks (hook) {
- hook('generate:done', (generator, errors) => {
- if (!errors || errors.length === 0) {
- consola.log('Generated successfully')
- } else {
- consola.log('Generated failed')
- }
- })
- },
- build: {
- terser: false
- }
-}
diff --git a/test/fixtures/cli/cli.gen.test.js b/test/fixtures/cli/cli.gen.test.js
deleted file mode 100644
index 060cb60535a8..000000000000
--- a/test/fixtures/cli/cli.gen.test.js
+++ /dev/null
@@ -1,20 +0,0 @@
-import { NuxtCommand, commands } from '@nuxt/cli'
-import consola from 'consola'
-
-describe('cli generate', () => {
- test('nuxt generate', async () => {
- const generateCommand = await commands.default('generate')
-
- const argv = [
- __dirname,
- '--no-force-exit',
- '-c',
- 'cli.gen.config.js'
- ]
-
- const cmd = new NuxtCommand(generateCommand, argv)
- await expect(cmd.run()).resolves.toBeUndefined()
-
- expect(consola.log).toBeCalledWith('Generated successfully')
- })
-})
diff --git a/test/fixtures/cli/custom.file b/test/fixtures/cli/custom.file
deleted file mode 100644
index 1a395045570b..000000000000
--- a/test/fixtures/cli/custom.file
+++ /dev/null
@@ -1 +0,0 @@
-This file is used to test custom chokidar watchers.
\ No newline at end of file
diff --git a/test/fixtures/cli/middleware.js b/test/fixtures/cli/middleware.js
deleted file mode 100644
index d855a7198d30..000000000000
--- a/test/fixtures/cli/middleware.js
+++ /dev/null
@@ -1 +0,0 @@
-// This file is used to test custom chokidar watchers.
diff --git a/test/fixtures/cli/nuxt.config.js b/test/fixtures/cli/nuxt.config.js
deleted file mode 100644
index 737cb49a13bb..000000000000
--- a/test/fixtures/cli/nuxt.config.js
+++ /dev/null
@@ -1,12 +0,0 @@
-export default {
- serverMiddleware: [
- { route: '/empty', handle: '~/middleware.js' },
- (req, res, next) => next()
- ],
- watch: ['~/custom.file'],
- hooks (hook) {
- hook('listen', (server, { port, host }) => {
- process.stdout.write(`Listening on http://${host}:${port}`)
- })
- }
-}
diff --git a/test/fixtures/cli/pages/index.vue b/test/fixtures/cli/pages/index.vue
deleted file mode 100644
index 82cb6da1cd75..000000000000
--- a/test/fixtures/cli/pages/index.vue
+++ /dev/null
@@ -1,3 +0,0 @@
-
- CLI Test
-
diff --git a/test/fixtures/config-explicit/config-explicit.test.js b/test/fixtures/config-explicit/config-explicit.test.js
deleted file mode 100644
index 1a41c3f0b7d8..000000000000
--- a/test/fixtures/config-explicit/config-explicit.test.js
+++ /dev/null
@@ -1,3 +0,0 @@
-import { buildFixture } from '../../utils/build'
-
-buildFixture('config-explicit')
diff --git a/test/fixtures/config-explicit/nuxt.config.js b/test/fixtures/config-explicit/nuxt.config.js
deleted file mode 100644
index 76f166d56a04..000000000000
--- a/test/fixtures/config-explicit/nuxt.config.js
+++ /dev/null
@@ -1,13 +0,0 @@
-import path from 'path'
-
-export default {
- modulesDir: path.join(__dirname, '..', '..', '..', 'node_modules'),
- pageTransition: false,
- vue: {
- config: {
- silent: false,
- performance: true,
- devtools: true
- }
- }
-}
diff --git a/test/fixtures/config-explicit/pages/config.vue b/test/fixtures/config-explicit/pages/config.vue
deleted file mode 100644
index 1a104a48592b..000000000000
--- a/test/fixtures/config-explicit/pages/config.vue
+++ /dev/null
@@ -1,29 +0,0 @@
-
-
-
- {{ vueConfig[key] | toStr }}
-
-
-
-
-
diff --git a/test/fixtures/custom-app-template/basic.test.js b/test/fixtures/custom-app-template/basic.test.js
deleted file mode 100644
index 3430e0bd14ab..000000000000
--- a/test/fixtures/custom-app-template/basic.test.js
+++ /dev/null
@@ -1,3 +0,0 @@
-import { buildFixture } from '../../utils/build'
-
-buildFixture('custom-app-template')
diff --git a/test/fixtures/custom-app-template/nuxt.config.js b/test/fixtures/custom-app-template/nuxt.config.js
deleted file mode 100644
index ec8138d66647..000000000000
--- a/test/fixtures/custom-app-template/nuxt.config.js
+++ /dev/null
@@ -1,6 +0,0 @@
-export default {
- appTemplatePath: './test/mytemplate.html',
- env: {
- tracker: 'ga'
- }
-}
diff --git a/test/fixtures/custom-app-template/pages/index.vue b/test/fixtures/custom-app-template/pages/index.vue
deleted file mode 100644
index 95ca5248aa37..000000000000
--- a/test/fixtures/custom-app-template/pages/index.vue
+++ /dev/null
@@ -1,3 +0,0 @@
-
- Custom!
-
diff --git a/test/fixtures/custom-app-template/test/mytemplate.html b/test/fixtures/custom-app-template/test/mytemplate.html
deleted file mode 100644
index d1ae3fc195a1..000000000000
--- a/test/fixtures/custom-app-template/test/mytemplate.html
+++ /dev/null
@@ -1,15 +0,0 @@
-
-
-
- {{ HEAD }}
- {% if (ENV.tracker === 'ga') { %}
-
- {% } else if (ENV.tracker === 'heap') { %}
-
- {% } %}
-
-
-{{ APP }}
-My Template
-
-
diff --git a/test/fixtures/custom-dirs/custom-assets/app.css b/test/fixtures/custom-dirs/custom-assets/app.css
deleted file mode 100644
index f69fcd8bbc4d..000000000000
--- a/test/fixtures/custom-dirs/custom-assets/app.css
+++ /dev/null
@@ -1,3 +0,0 @@
-.global-css-selector {
- color: red;
-}
diff --git a/test/fixtures/custom-dirs/custom-dirs.test.js b/test/fixtures/custom-dirs/custom-dirs.test.js
deleted file mode 100644
index 93c44814d5a5..000000000000
--- a/test/fixtures/custom-dirs/custom-dirs.test.js
+++ /dev/null
@@ -1,3 +0,0 @@
-import { buildFixture } from '../../utils/build'
-
-buildFixture('custom-dirs')
diff --git a/test/fixtures/custom-dirs/custom-layouts/layouts/default.vue b/test/fixtures/custom-dirs/custom-layouts/layouts/default.vue
deleted file mode 100644
index 50c73c93c2b5..000000000000
--- a/test/fixtures/custom-dirs/custom-layouts/layouts/default.vue
+++ /dev/null
@@ -1,6 +0,0 @@
-
-
-
-
I have custom layouts directory
-
diff --git a/test/fixtures/custom-dirs/custom-middleware/user-agent.js b/test/fixtures/custom-dirs/custom-middleware/user-agent.js
deleted file mode 100644
index 662a76ef028b..000000000000
--- a/test/fixtures/custom-dirs/custom-middleware/user-agent.js
+++ /dev/null
@@ -1,3 +0,0 @@
-export default function (context) {
- context.userAgent = process.server ? context.req.headers['user-agent'] : navigator.userAgent
-}
diff --git a/test/fixtures/custom-dirs/custom-pages/index.vue b/test/fixtures/custom-dirs/custom-pages/index.vue
deleted file mode 100644
index dc15a791ec1c..000000000000
--- a/test/fixtures/custom-dirs/custom-pages/index.vue
+++ /dev/null
@@ -1,5 +0,0 @@
-
-
-
I have custom pages directory
-
-
diff --git a/test/fixtures/custom-dirs/custom-pages/user-agent.vue b/test/fixtures/custom-dirs/custom-pages/user-agent.vue
deleted file mode 100644
index dff65e97d898..000000000000
--- a/test/fixtures/custom-dirs/custom-pages/user-agent.vue
+++ /dev/null
@@ -1,12 +0,0 @@
-
- {{ userAgent }}
-
-
-
diff --git a/test/fixtures/custom-dirs/custom-static/test.txt b/test/fixtures/custom-dirs/custom-static/test.txt
deleted file mode 100644
index 2913997fe435..000000000000
--- a/test/fixtures/custom-dirs/custom-static/test.txt
+++ /dev/null
@@ -1 +0,0 @@
-A test here :)
diff --git a/test/fixtures/custom-dirs/custom-store/index.js b/test/fixtures/custom-dirs/custom-store/index.js
deleted file mode 100644
index 20b0601fcf0c..000000000000
--- a/test/fixtures/custom-dirs/custom-store/index.js
+++ /dev/null
@@ -1,17 +0,0 @@
-import Vue from 'vue'
-import Vuex from 'vuex'
-
-Vue.use(Vuex)
-
-const store = () => new Vuex.Store({
- state: {
- counter: 0
- },
- mutations: {
- increment (state) {
- state.counter++
- }
- }
-})
-
-export default store
diff --git a/test/fixtures/custom-dirs/nuxt.config.js b/test/fixtures/custom-dirs/nuxt.config.js
deleted file mode 100644
index 3549bcd5e583..000000000000
--- a/test/fixtures/custom-dirs/nuxt.config.js
+++ /dev/null
@@ -1,31 +0,0 @@
-export default {
- build: {
- extractCSS: true,
- optimization: {
- splitChunks: {
- name: true
- }
- },
- postcss: {
- preset: {
- autoprefixer: {
- grid: true
- }
- }
- },
- filenames: {
- css: () => {
- return '[name].css'
- }
- }
- },
- css: [{ src: '~/custom-assets/app.css' }],
- dir: {
- assets: 'custom-assets',
- layouts: 'custom-layouts/layouts',
- middleware: 'custom-middleware',
- pages: 'custom-pages',
- static: 'custom-static',
- store: 'custom-store'
- }
-}
diff --git a/test/fixtures/dynamic-routes/dynamic-routes.test.js b/test/fixtures/dynamic-routes/dynamic-routes.test.js
deleted file mode 100644
index 060f61a301a1..000000000000
--- a/test/fixtures/dynamic-routes/dynamic-routes.test.js
+++ /dev/null
@@ -1,3 +0,0 @@
-import { buildFixture } from '../../utils/build'
-
-buildFixture('dynamic-routes')
diff --git a/test/fixtures/dynamic-routes/pages/_/_.vue b/test/fixtures/dynamic-routes/pages/_/_.vue
deleted file mode 100644
index e69de29bb2d1..000000000000
diff --git a/test/fixtures/dynamic-routes/pages/_/index.vue b/test/fixtures/dynamic-routes/pages/_/index.vue
deleted file mode 100644
index e69de29bb2d1..000000000000
diff --git a/test/fixtures/dynamic-routes/pages/_/p/_.vue b/test/fixtures/dynamic-routes/pages/_/p/_.vue
deleted file mode 100644
index e69de29bb2d1..000000000000
diff --git a/test/fixtures/dynamic-routes/pages/_key/_id.vue b/test/fixtures/dynamic-routes/pages/_key/_id.vue
deleted file mode 100644
index 91a2741e5a43..000000000000
--- a/test/fixtures/dynamic-routes/pages/_key/_id.vue
+++ /dev/null
@@ -1,3 +0,0 @@
-
- pages/_key/_id.vue
-
diff --git a/test/fixtures/dynamic-routes/pages/_slug.vue b/test/fixtures/dynamic-routes/pages/_slug.vue
deleted file mode 100644
index 5a6c5638dd3a..000000000000
--- a/test/fixtures/dynamic-routes/pages/_slug.vue
+++ /dev/null
@@ -1,3 +0,0 @@
-
- pages/_slug.vue
-
diff --git a/test/fixtures/dynamic-routes/pages/index.vue b/test/fixtures/dynamic-routes/pages/index.vue
deleted file mode 100644
index e69de29bb2d1..000000000000
diff --git a/test/fixtures/dynamic-routes/pages/parent.vue b/test/fixtures/dynamic-routes/pages/parent.vue
deleted file mode 100644
index e69de29bb2d1..000000000000
diff --git a/test/fixtures/dynamic-routes/pages/parent/child.vue b/test/fixtures/dynamic-routes/pages/parent/child.vue
deleted file mode 100644
index e69de29bb2d1..000000000000
diff --git a/test/fixtures/dynamic-routes/pages/parent/index.vue b/test/fixtures/dynamic-routes/pages/parent/index.vue
deleted file mode 100644
index e69de29bb2d1..000000000000
diff --git a/test/fixtures/dynamic-routes/pages/parent/teub.vue b/test/fixtures/dynamic-routes/pages/parent/teub.vue
deleted file mode 100644
index e69de29bb2d1..000000000000
diff --git a/test/fixtures/dynamic-routes/pages/posts.vue b/test/fixtures/dynamic-routes/pages/posts.vue
deleted file mode 100644
index e69de29bb2d1..000000000000
diff --git a/test/fixtures/dynamic-routes/pages/posts/_id.vue b/test/fixtures/dynamic-routes/pages/posts/_id.vue
deleted file mode 100644
index e69de29bb2d1..000000000000
diff --git a/test/fixtures/dynamic-routes/pages/test/_.vue b/test/fixtures/dynamic-routes/pages/test/_.vue
deleted file mode 100644
index ec21bcfdca44..000000000000
--- a/test/fixtures/dynamic-routes/pages/test/_.vue
+++ /dev/null
@@ -1,3 +0,0 @@
-
- pages/test/_.vue
-
diff --git a/test/fixtures/dynamic-routes/pages/test/index.vue b/test/fixtures/dynamic-routes/pages/test/index.vue
deleted file mode 100644
index ac8071ead45e..000000000000
--- a/test/fixtures/dynamic-routes/pages/test/index.vue
+++ /dev/null
@@ -1,3 +0,0 @@
-
- pages/test/index.vue
-
diff --git a/test/fixtures/dynamic-routes/pages/test/projects/_category.vue b/test/fixtures/dynamic-routes/pages/test/projects/_category.vue
deleted file mode 100644
index e69de29bb2d1..000000000000
diff --git a/test/fixtures/dynamic-routes/pages/test/projects/index.vue b/test/fixtures/dynamic-routes/pages/test/projects/index.vue
deleted file mode 100644
index e69de29bb2d1..000000000000
diff --git a/test/fixtures/dynamic-routes/pages/test/songs/_id.vue b/test/fixtures/dynamic-routes/pages/test/songs/_id.vue
deleted file mode 100644
index e69de29bb2d1..000000000000
diff --git a/test/fixtures/dynamic-routes/pages/test/songs/toto.vue b/test/fixtures/dynamic-routes/pages/test/songs/toto.vue
deleted file mode 100644
index e69de29bb2d1..000000000000
diff --git a/test/fixtures/dynamic-routes/pages/test/users.vue b/test/fixtures/dynamic-routes/pages/test/users.vue
deleted file mode 100644
index e69de29bb2d1..000000000000
diff --git a/test/fixtures/dynamic-routes/pages/test/users/_id.vue b/test/fixtures/dynamic-routes/pages/test/users/_id.vue
deleted file mode 100644
index e69de29bb2d1..000000000000
diff --git a/test/fixtures/dynamic-routes/pages/test/users/_index/teub.vue b/test/fixtures/dynamic-routes/pages/test/users/_index/teub.vue
deleted file mode 100644
index e69de29bb2d1..000000000000
diff --git a/test/fixtures/dynamic-routes/pages/test/users/index.vue b/test/fixtures/dynamic-routes/pages/test/users/index.vue
deleted file mode 100644
index e69de29bb2d1..000000000000
diff --git a/test/fixtures/dynamic-routes/pages/test/users/projects/_category.vue b/test/fixtures/dynamic-routes/pages/test/users/projects/_category.vue
deleted file mode 100644
index e69de29bb2d1..000000000000
diff --git a/test/fixtures/dynamic-routes/pages/test/users/projects/index.vue b/test/fixtures/dynamic-routes/pages/test/users/projects/index.vue
deleted file mode 100644
index e69de29bb2d1..000000000000
diff --git a/test/fixtures/dynamic-routes/pages/users/_id.vue b/test/fixtures/dynamic-routes/pages/users/_id.vue
deleted file mode 100644
index e69de29bb2d1..000000000000
diff --git a/test/fixtures/empty/empty.test.js b/test/fixtures/empty/empty.test.js
deleted file mode 100644
index 4deec265c3e9..000000000000
--- a/test/fixtures/empty/empty.test.js
+++ /dev/null
@@ -1,3 +0,0 @@
-import { buildFixture } from '../../utils/build'
-
-buildFixture('empty')
diff --git a/test/fixtures/empty/pages/.gitkeep b/test/fixtures/empty/pages/.gitkeep
deleted file mode 100644
index e69de29bb2d1..000000000000
diff --git a/test/fixtures/error/error.test.js b/test/fixtures/error/error.test.js
deleted file mode 100644
index aca6dd9140d2..000000000000
--- a/test/fixtures/error/error.test.js
+++ /dev/null
@@ -1,3 +0,0 @@
-import { buildFixture } from '../../utils/build'
-
-buildFixture('error')
diff --git a/test/fixtures/error/layouts/error-layout.vue b/test/fixtures/error/layouts/error-layout.vue
deleted file mode 100644
index 91cee17bd564..000000000000
--- a/test/fixtures/error/layouts/error-layout.vue
+++ /dev/null
@@ -1,12 +0,0 @@
-
-
-
-
-
-
-
diff --git a/test/fixtures/error/layouts/error.vue b/test/fixtures/error/layouts/error.vue
deleted file mode 100644
index b9441b040ee2..000000000000
--- a/test/fixtures/error/layouts/error.vue
+++ /dev/null
@@ -1,18 +0,0 @@
-
-
-
Error
-
Details: {{ this.$route.path === '/squared' ? error.response.data : error.message }}
-
-
- back
-
-
-
-
diff --git a/test/fixtures/error/pages/about.vue b/test/fixtures/error/pages/about.vue
deleted file mode 100644
index 71e48bb1a080..000000000000
--- a/test/fixtures/error/pages/about.vue
+++ /dev/null
@@ -1,8 +0,0 @@
-
-
-
About
-
- back
-
-
-
diff --git a/test/fixtures/error/pages/error.vue b/test/fixtures/error/pages/error.vue
deleted file mode 100644
index a683233742f5..000000000000
--- a/test/fixtures/error/pages/error.vue
+++ /dev/null
@@ -1,10 +0,0 @@
-
- Error page
-
-
-
diff --git a/test/fixtures/error/pages/index.vue b/test/fixtures/error/pages/index.vue
deleted file mode 100644
index 8e4c7c206359..000000000000
--- a/test/fixtures/error/pages/index.vue
+++ /dev/null
@@ -1,14 +0,0 @@
-
-
-
Error Loop incoming page
-
- Error during error
-
-
- About
-
-
- Info (with error)
-
-
-
diff --git a/test/fixtures/error/pages/info.vue b/test/fixtures/error/pages/info.vue
deleted file mode 100644
index de79ba736722..000000000000
--- a/test/fixtures/error/pages/info.vue
+++ /dev/null
@@ -1,19 +0,0 @@
-
-
-
Info
-
Details: {{ info.message.title }}
-
- back
-
-
-
-
diff --git a/test/fixtures/external-vue-resolution/app.vue b/test/fixtures/external-vue-resolution/app.vue
new file mode 100644
index 000000000000..585f495151c9
--- /dev/null
+++ b/test/fixtures/external-vue-resolution/app.vue
@@ -0,0 +1,3 @@
+
+ Hello World!
+
diff --git a/test/fixtures/external-vue-resolution/modules/ssr-resolve-check.ts b/test/fixtures/external-vue-resolution/modules/ssr-resolve-check.ts
new file mode 100644
index 000000000000..aea73d944deb
--- /dev/null
+++ b/test/fixtures/external-vue-resolution/modules/ssr-resolve-check.ts
@@ -0,0 +1,29 @@
+import { resolve } from 'node:path'
+import { addVitePlugin, defineNuxtModule } from 'nuxt/kit'
+import { resolveModulePath } from 'exsolve'
+
+// Verifies that the SSR vite environment's resolved `resolve.conditions` are
+// sufficient to resolve `vue` and `vue-router` from nuxt's own runtime files.
+export default defineNuxtModule({
+ meta: { name: 'ssr-resolve-check' },
+ setup (_options, nuxt) {
+ const importer = resolve(nuxt.options.appDir, 'entry.js')
+ addVitePlugin({
+ name: 'ssr-resolve-check',
+ configResolved (config) {
+ const ssr = config.environments?.ssr
+ if (!ssr) { return }
+ const conditions = ssr.resolve?.conditions
+ if (!conditions) {
+ throw new Error('SSR vite environment has no resolve.conditions configured. See https://github.com/nuxt/nuxt/issues/34888.')
+ }
+ for (const id of ['vue', 'vue-router']) {
+ const resolved = resolveModulePath(id, { try: true, from: importer, conditions })
+ if (!resolved) {
+ throw new Error(`SSR vite resolve conditions ${JSON.stringify(conditions)} cannot resolve '${id}' from ${importer}. See https://github.com/nuxt/nuxt/issues/34888.`)
+ }
+ }
+ },
+ })
+ },
+})
diff --git a/test/fixtures/external-vue-resolution/nuxt.config.ts b/test/fixtures/external-vue-resolution/nuxt.config.ts
new file mode 100644
index 000000000000..a3f2d171ca83
--- /dev/null
+++ b/test/fixtures/external-vue-resolution/nuxt.config.ts
@@ -0,0 +1,5 @@
+export default defineNuxtConfig({
+ devtools: { enabled: false },
+ sourcemap: false,
+ compatibilityDate: 'latest',
+})
diff --git a/test/fixtures/external-vue-resolution/package.json b/test/fixtures/external-vue-resolution/package.json
new file mode 100644
index 000000000000..228a1d51922d
--- /dev/null
+++ b/test/fixtures/external-vue-resolution/package.json
@@ -0,0 +1,13 @@
+{
+ "private": true,
+ "name": "fixture-external-vue-resolution",
+ "scripts": {
+ "build": "nuxt build"
+ },
+ "dependencies": {
+ "nuxt": "workspace:*"
+ },
+ "engines": {
+ "node": "^22.12.0 || ^24.11.0 || >=26.0.0"
+ }
+}
diff --git a/test/fixtures/external-vue-resolution/tsconfig.json b/test/fixtures/external-vue-resolution/tsconfig.json
new file mode 100644
index 000000000000..cae87c003c5f
--- /dev/null
+++ b/test/fixtures/external-vue-resolution/tsconfig.json
@@ -0,0 +1,9 @@
+{
+ "files": [],
+ "references": [
+ { "path": "./.nuxt/tsconfig.app.json" },
+ { "path": "./.nuxt/tsconfig.server.json" },
+ { "path": "./.nuxt/tsconfig.shared.json" },
+ { "path": "./.nuxt/tsconfig.node.json" }
+ ]
+}
diff --git a/test/fixtures/extract-css/assets/global.css b/test/fixtures/extract-css/assets/global.css
deleted file mode 100644
index a58e3d0e8da2..000000000000
--- a/test/fixtures/extract-css/assets/global.css
+++ /dev/null
@@ -1,15 +0,0 @@
-/* GLOBAL CSS */
-
-body {
- background-color: rgb(28, 28, 28);
- display: flex;
-
- justify-content: center;
-
- align-items: center;
-
-
- height: 100vh;
-}
-
-/* END OF GLOBAL CSS */
diff --git a/test/fixtures/extract-css/extract-css.test.js b/test/fixtures/extract-css/extract-css.test.js
deleted file mode 100644
index 73a5ab054d9e..000000000000
--- a/test/fixtures/extract-css/extract-css.test.js
+++ /dev/null
@@ -1,3 +0,0 @@
-import { buildFixture } from '../../utils/build'
-
-buildFixture('extract-css')
diff --git a/test/fixtures/extract-css/layouts/default.vue b/test/fixtures/extract-css/layouts/default.vue
deleted file mode 100644
index b483de85b588..000000000000
--- a/test/fixtures/extract-css/layouts/default.vue
+++ /dev/null
@@ -1,15 +0,0 @@
-
-
-
-
-
-
diff --git a/test/fixtures/extract-css/nuxt.config.js b/test/fixtures/extract-css/nuxt.config.js
deleted file mode 100644
index beccdb1a797d..000000000000
--- a/test/fixtures/extract-css/nuxt.config.js
+++ /dev/null
@@ -1,25 +0,0 @@
-export default {
- build: {
- extractCSS: true,
- optimization: {
- splitChunks: {
- name: true
- }
- },
- postcss: {
- preset: {
- autoprefixer: {
- grid: true
- }
- }
- },
- filenames: {
- css: () => {
- return '[name].css'
- }
- }
- },
- css: [
- '~/assets/global.css'
- ]
-}
diff --git a/test/fixtures/extract-css/pages/about.vue b/test/fixtures/extract-css/pages/about.vue
deleted file mode 100644
index b25e3435793b..000000000000
--- a/test/fixtures/extract-css/pages/about.vue
+++ /dev/null
@@ -1,13 +0,0 @@
-
-
-
- I'm BLUE
-
-
-
-
-
diff --git a/test/fixtures/extract-css/pages/index.vue b/test/fixtures/extract-css/pages/index.vue
deleted file mode 100644
index cce78256b279..000000000000
--- a/test/fixtures/extract-css/pages/index.vue
+++ /dev/null
@@ -1,36 +0,0 @@
-
-
-
I'm RED
-
-
- item-a
-
-
- item-b
-
-
- item-c
-
-
- item-d
-
-
- item-e
-
-
-
-
-
diff --git a/test/fixtures/fetch/components/Team.vue b/test/fixtures/fetch/components/Team.vue
deleted file mode 100644
index fb678b7cf133..000000000000
--- a/test/fixtures/fetch/components/Team.vue
+++ /dev/null
@@ -1,26 +0,0 @@
-
-
-
- Fetching...
-
-
- {{ $fetchState.error }}
-
-
{{ team }}
-
-
-
diff --git a/test/fixtures/fetch/fetch.test.js b/test/fixtures/fetch/fetch.test.js
deleted file mode 100644
index 8a10805c97df..000000000000
--- a/test/fixtures/fetch/fetch.test.js
+++ /dev/null
@@ -1,3 +0,0 @@
-import { buildFixture } from '../../utils/build'
-
-buildFixture('fetch')
diff --git a/test/fixtures/fetch/layouts/default.vue b/test/fixtures/fetch/layouts/default.vue
deleted file mode 100644
index 4a4ad8b5a0af..000000000000
--- a/test/fixtures/fetch/layouts/default.vue
+++ /dev/null
@@ -1,52 +0,0 @@
-
-
-
-
-
- Fetch
-
-
-
-
- Fetch on client
-
-
-
-
- Fetch conditional
-
-
-
-
- Fetch error
-
-
-
-
- Fetch delay
-
-
-
-
- Fetch button
-
-
-
-
- Fetch in component
-
-
-
-
- Fetch with deep update updates
-
-
-
-
- Deprecated fetch
-
-
-
-
-
diff --git a/test/fixtures/fetch/pages/fetch-button.vue b/test/fixtures/fetch/pages/fetch-button.vue
deleted file mode 100644
index 4617fa31bf30..000000000000
--- a/test/fixtures/fetch/pages/fetch-button.vue
+++ /dev/null
@@ -1,26 +0,0 @@
-
-
-
- Fetching...
-
-
{{ team }}
-
- Refresh
-
-
-
-
diff --git a/test/fixtures/fetch/pages/fetch-client.vue b/test/fixtures/fetch/pages/fetch-client.vue
deleted file mode 100644
index af7312c52a7d..000000000000
--- a/test/fixtures/fetch/pages/fetch-client.vue
+++ /dev/null
@@ -1,22 +0,0 @@
-
-
-
- Fetching...
-
-
{{ team }}
-
-
-
diff --git a/test/fixtures/fetch/pages/fetch-component.vue b/test/fixtures/fetch/pages/fetch-component.vue
deleted file mode 100644
index 9a3b4484dd71..000000000000
--- a/test/fixtures/fetch/pages/fetch-component.vue
+++ /dev/null
@@ -1,13 +0,0 @@
-
-
-
-
diff --git a/test/fixtures/fetch/pages/fetch-conditional.vue b/test/fixtures/fetch/pages/fetch-conditional.vue
deleted file mode 100644
index df71f3baab5e..000000000000
--- a/test/fixtures/fetch/pages/fetch-conditional.vue
+++ /dev/null
@@ -1,29 +0,0 @@
-
-
-
- Fetch on client
-
-
- Fetching...
-
-
{{ team }}
-
-
-
diff --git a/test/fixtures/fetch/pages/fetch-deep.vue b/test/fixtures/fetch/pages/fetch-deep.vue
deleted file mode 100644
index 250a3342e60e..000000000000
--- a/test/fixtures/fetch/pages/fetch-deep.vue
+++ /dev/null
@@ -1,35 +0,0 @@
-
-
-
-
-
diff --git a/test/fixtures/fetch/pages/fetch-delay.vue b/test/fixtures/fetch/pages/fetch-delay.vue
deleted file mode 100644
index 37bb499f6ae7..000000000000
--- a/test/fixtures/fetch/pages/fetch-delay.vue
+++ /dev/null
@@ -1,24 +0,0 @@
-
-
-
- Fetching for 1 second
-
-
{{ team }}
-
-
-
diff --git a/test/fixtures/fetch/pages/fetch-error.vue b/test/fixtures/fetch/pages/fetch-error.vue
deleted file mode 100644
index 035429ad7abd..000000000000
--- a/test/fixtures/fetch/pages/fetch-error.vue
+++ /dev/null
@@ -1,24 +0,0 @@
-
-
-
- Fetching...
-
-
- {{ $fetchState.error.message }}
-
-
{{ team }}
-
-
-
diff --git a/test/fixtures/fetch/pages/index.vue b/test/fixtures/fetch/pages/index.vue
deleted file mode 100644
index d2f100cdacef..000000000000
--- a/test/fixtures/fetch/pages/index.vue
+++ /dev/null
@@ -1,23 +0,0 @@
-
-
-
- Fetching...
-
-
{{ team }}
-
-
-
diff --git a/test/fixtures/fetch/pages/old-fetch.vue b/test/fixtures/fetch/pages/old-fetch.vue
deleted file mode 100644
index 24ce412bdf82..000000000000
--- a/test/fixtures/fetch/pages/old-fetch.vue
+++ /dev/null
@@ -1,18 +0,0 @@
-
-
- oldFetchData: {{ $store.state.oldFetchData }}
-
-
-
-
diff --git a/test/fixtures/fetch/static/team.json b/test/fixtures/fetch/static/team.json
deleted file mode 100644
index a39a7b61dfe0..000000000000
--- a/test/fixtures/fetch/static/team.json
+++ /dev/null
@@ -1,11 +0,0 @@
-[
- "Atinux",
- "alexchopin",
- "pi0",
- "clarkdo",
- "manniL",
- "galvez",
- "aldarund",
- "kevinmarrec",
- "pimlie"
-]
diff --git a/test/fixtures/fetch/store/index.js b/test/fixtures/fetch/store/index.js
deleted file mode 100644
index c21775336254..000000000000
--- a/test/fixtures/fetch/store/index.js
+++ /dev/null
@@ -1,9 +0,0 @@
-export const state = () => ({
- oldFetchData: 'not-set'
-})
-
-export const mutations = {
- setOldFetchData (state, data) {
- state.oldFetchData = data
- }
-}
diff --git a/test/fixtures/filenames-query-part/filenames-query-part.test.js b/test/fixtures/filenames-query-part/filenames-query-part.test.js
deleted file mode 100644
index d721c3eebc9e..000000000000
--- a/test/fixtures/filenames-query-part/filenames-query-part.test.js
+++ /dev/null
@@ -1,3 +0,0 @@
-import { buildFixture } from '../../utils/build'
-
-buildFixture('filenames-query-part')
diff --git a/test/fixtures/filenames-query-part/nuxt.config.js b/test/fixtures/filenames-query-part/nuxt.config.js
deleted file mode 100644
index fb293c9e5a1a..000000000000
--- a/test/fixtures/filenames-query-part/nuxt.config.js
+++ /dev/null
@@ -1,8 +0,0 @@
-export default {
- build: {
- filenames: {
- app: '[name].js?v=[contenthash]',
- chunk: '[name].js?v=[contenthash]'
- }
- }
-}
diff --git a/test/fixtures/filenames-query-part/pages/index.vue b/test/fixtures/filenames-query-part/pages/index.vue
deleted file mode 100644
index 24fa9df56eeb..000000000000
--- a/test/fixtures/filenames-query-part/pages/index.vue
+++ /dev/null
@@ -1,5 +0,0 @@
-
-
-
Chunks with version in query part
-
-
diff --git a/test/fixtures/hmr-sibling-layer/app/components/SiblingLayerMarker.vue b/test/fixtures/hmr-sibling-layer/app/components/SiblingLayerMarker.vue
new file mode 100644
index 000000000000..b315c040e6a5
--- /dev/null
+++ b/test/fixtures/hmr-sibling-layer/app/components/SiblingLayerMarker.vue
@@ -0,0 +1,11 @@
+
+
+
+ {{ marker }}
+
diff --git a/test/fixtures/hmr-sibling-layer/nuxt.config.ts b/test/fixtures/hmr-sibling-layer/nuxt.config.ts
new file mode 100644
index 000000000000..268da7f8c110
--- /dev/null
+++ b/test/fixtures/hmr-sibling-layer/nuxt.config.ts
@@ -0,0 +1 @@
+export default defineNuxtConfig({})
diff --git a/test/fixtures/hmr-sibling-layer/package.json b/test/fixtures/hmr-sibling-layer/package.json
new file mode 100644
index 000000000000..b04011e76104
--- /dev/null
+++ b/test/fixtures/hmr-sibling-layer/package.json
@@ -0,0 +1,10 @@
+{
+ "private": true,
+ "name": "fixture-hmr-sibling-layer",
+ "dependencies": {
+ "nuxt": "workspace:*"
+ },
+ "engines": {
+ "node": "^22.12.0 || ^24.11.0 || >=26.0.0"
+ }
+}
diff --git a/test/fixtures/hmr/app/app.vue b/test/fixtures/hmr/app/app.vue
new file mode 100644
index 000000000000..b1f0b5649ddc
--- /dev/null
+++ b/test/fixtures/hmr/app/app.vue
@@ -0,0 +1,7 @@
+
+
+
+
diff --git a/test/fixtures/hmr/app/assets/test.css b/test/fixtures/hmr/app/assets/test.css
new file mode 100644
index 000000000000..adc68fa6a4df
--- /dev/null
+++ b/test/fixtures/hmr/app/assets/test.css
@@ -0,0 +1,3 @@
+h1 {
+ color: red;
+}
diff --git a/test/fixtures/hmr/app/components/example/test.vue b/test/fixtures/hmr/app/components/example/test.vue
new file mode 100644
index 000000000000..c6c9c090fa4d
--- /dev/null
+++ b/test/fixtures/hmr/app/components/example/test.vue
@@ -0,0 +1,5 @@
+
+
+ test.vue
+
+
diff --git a/test/fixtures/hmr/app/components/islands/HmrComponent.vue b/test/fixtures/hmr/app/components/islands/HmrComponent.vue
new file mode 100644
index 000000000000..7ab0ba49b5ac
--- /dev/null
+++ b/test/fixtures/hmr/app/components/islands/HmrComponent.vue
@@ -0,0 +1,10 @@
+
+
+
+
+ HMR ID:
+ {{ hmrId }}
+
+
diff --git a/test/fixtures/hmr/app/pages/index.vue b/test/fixtures/hmr/app/pages/index.vue
new file mode 100644
index 000000000000..b0f4d634ebce
--- /dev/null
+++ b/test/fixtures/hmr/app/pages/index.vue
@@ -0,0 +1,21 @@
+
+
+
+
+
HMR fixture
+
Home page
+
+ Count:
+ {{ count }}
+
+
+ Increment
+
+
{{ $route.meta }}
+
diff --git a/test/fixtures/hmr/app/pages/issues/32177.vue b/test/fixtures/hmr/app/pages/issues/32177.vue
new file mode 100644
index 000000000000..d46b1bb83f01
--- /dev/null
+++ b/test/fixtures/hmr/app/pages/issues/32177.vue
@@ -0,0 +1,8 @@
+
+ {{ elements }}
+
+
+
diff --git a/test/fixtures/hmr/app/pages/page-meta.vue b/test/fixtures/hmr/app/pages/page-meta.vue
new file mode 100644
index 000000000000..3efc8ac17d76
--- /dev/null
+++ b/test/fixtures/hmr/app/pages/page-meta.vue
@@ -0,0 +1,11 @@
+
+
+
+
+
diff --git a/test/fixtures/hmr/app/pages/rename-component.vue b/test/fixtures/hmr/app/pages/rename-component.vue
new file mode 100644
index 000000000000..54f6fac5f2dc
--- /dev/null
+++ b/test/fixtures/hmr/app/pages/rename-component.vue
@@ -0,0 +1,3 @@
+
+
diff --git a/test/fixtures/hmr/app/pages/route-rules.vue b/test/fixtures/hmr/app/pages/route-rules.vue
new file mode 100644
index 000000000000..52a5dda9d2d0
--- /dev/null
+++ b/test/fixtures/hmr/app/pages/route-rules.vue
@@ -0,0 +1,13 @@
+
+
+
+
+ Route rules defined inline
+
+
diff --git a/test/fixtures/hmr/app/pages/routes/index.vue b/test/fixtures/hmr/app/pages/routes/index.vue
new file mode 100644
index 000000000000..aefe230be2cb
--- /dev/null
+++ b/test/fixtures/hmr/app/pages/routes/index.vue
@@ -0,0 +1,7 @@
+
+
+
+ To non-existent link
+
+
+
diff --git a/test/fixtures/hmr/app/pages/server-component.vue b/test/fixtures/hmr/app/pages/server-component.vue
new file mode 100644
index 000000000000..ad37a3b86db0
--- /dev/null
+++ b/test/fixtures/hmr/app/pages/server-component.vue
@@ -0,0 +1,5 @@
+
+
+
+
diff --git a/test/fixtures/hmr/app/pages/sibling-layer.vue b/test/fixtures/hmr/app/pages/sibling-layer.vue
new file mode 100644
index 000000000000..dfcba4f9fd81
--- /dev/null
+++ b/test/fixtures/hmr/app/pages/sibling-layer.vue
@@ -0,0 +1,6 @@
+
+
+
Sibling layer HMR
+
diff --git a/test/fixtures/hmr/app/pages/state-component.vue b/test/fixtures/hmr/app/pages/state-component.vue
new file mode 100644
index 000000000000..b72c275889d1
--- /dev/null
+++ b/test/fixtures/hmr/app/pages/state-component.vue
@@ -0,0 +1,15 @@
+
+
+ {{ count }}
+
+
+
+
+
diff --git a/test/fixtures/hmr/app/pages/top-level-await.vue b/test/fixtures/hmr/app/pages/top-level-await.vue
new file mode 100644
index 000000000000..a2d6decf4b20
--- /dev/null
+++ b/test/fixtures/hmr/app/pages/top-level-await.vue
@@ -0,0 +1,11 @@
+
+
+
+
+ {{ data?.message }}
+
+
diff --git a/test/fixtures/hmr/app/pages/virtual-module.vue b/test/fixtures/hmr/app/pages/virtual-module.vue
new file mode 100644
index 000000000000..eaafd7009a19
--- /dev/null
+++ b/test/fixtures/hmr/app/pages/virtual-module.vue
@@ -0,0 +1,13 @@
+
+
+
+
+
Virtual module HMR
+ {{ counter }}
+
+
+
diff --git a/test/fixtures/hmr/app/plugins/custom-route.ts b/test/fixtures/hmr/app/plugins/custom-route.ts
new file mode 100644
index 000000000000..c119d98e790b
--- /dev/null
+++ b/test/fixtures/hmr/app/plugins/custom-route.ts
@@ -0,0 +1,11 @@
+export default defineNuxtPlugin(() => {
+ const router = useRouter()
+
+ router.addRoute({
+ path: '/custom-route',
+ name: 'custom-route',
+ component: defineComponent({
+ render: () => h('div', { 'data-testid': 'custom-route' }, 'Custom route added via plugin'),
+ }),
+ })
+})
diff --git a/test/fixtures/hmr/nuxt.config.ts b/test/fixtures/hmr/nuxt.config.ts
new file mode 100644
index 000000000000..fe9d57cf1b76
--- /dev/null
+++ b/test/fixtures/hmr/nuxt.config.ts
@@ -0,0 +1,13 @@
+import { withMatrix } from '../../matrix'
+import { virtualCounterPlugin } from './vite/virtual-counter-plugin'
+
+export default withMatrix({
+ extends: ['../hmr-sibling-layer'],
+ experimental: {
+ nitroAutoImports: true,
+ inlineRouteRules: true,
+ },
+ vite: {
+ plugins: [virtualCounterPlugin()],
+ },
+})
diff --git a/test/fixtures/hmr/package.json b/test/fixtures/hmr/package.json
new file mode 100644
index 000000000000..93935ad64862
--- /dev/null
+++ b/test/fixtures/hmr/package.json
@@ -0,0 +1,13 @@
+{
+ "private": true,
+ "name": "fixture-hmr",
+ "scripts": {
+ "build": "nuxt build"
+ },
+ "dependencies": {
+ "nuxt": "workspace:*"
+ },
+ "engines": {
+ "node": "^22.12.0 || ^24.11.0 || >=26.0.0"
+ }
+}
diff --git a/test/fixtures/hmr/server/api/slow.ts b/test/fixtures/hmr/server/api/slow.ts
new file mode 100644
index 000000000000..9eed46707d57
--- /dev/null
+++ b/test/fixtures/hmr/server/api/slow.ts
@@ -0,0 +1,4 @@
+export default defineEventHandler(async () => {
+ await new Promise(resolve => setTimeout(resolve, 500))
+ return { message: 'loaded' }
+})
diff --git a/test/fixtures/hmr/tsconfig.json b/test/fixtures/hmr/tsconfig.json
new file mode 100644
index 000000000000..6ae5970c766b
--- /dev/null
+++ b/test/fixtures/hmr/tsconfig.json
@@ -0,0 +1,17 @@
+{
+ "files": [],
+ "references": [
+ {
+ "path": "./.nuxt/tsconfig.app.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.server.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.shared.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.node.json"
+ }
+ ]
+}
diff --git a/test/fixtures/hmr/vite/virtual-counter-plugin.ts b/test/fixtures/hmr/vite/virtual-counter-plugin.ts
new file mode 100644
index 000000000000..f9e12447b74e
--- /dev/null
+++ b/test/fixtures/hmr/vite/virtual-counter-plugin.ts
@@ -0,0 +1,33 @@
+import type { HmrContext, Plugin } from 'vite'
+
+// Used by the SSR virtual-module HMR regression test (#30169).
+// `load()` returns a monotonically incrementing counter, and
+// `handleHotUpdate` invalidates the virtual module so the SSR runner has
+// to re-evaluate it on the next render.
+export function virtualCounterPlugin (): Plugin {
+ const virtualId = 'virtual:hmr-counter'
+ const resolvedVirtualId = '\0' + virtualId
+ let counter = 0
+
+ return {
+ name: 'test:virtual-counter',
+ resolveId (id) {
+ if (id === virtualId) {
+ return resolvedVirtualId
+ }
+ },
+ load (id) {
+ if (id === resolvedVirtualId) {
+ counter += 1
+ return `export const counter = ${counter}`
+ }
+ },
+ async handleHotUpdate (ctx: HmrContext) {
+ const { server, timestamp } = ctx
+ const mod = server.moduleGraph.getModuleById(resolvedVirtualId)
+ if (!mod) { return }
+ server.moduleGraph.invalidateModule(mod, undefined, timestamp)
+ await server.reloadModule(mod)
+ },
+ }
+}
diff --git a/test/fixtures/https/https.test.js b/test/fixtures/https/https.test.js
deleted file mode 100644
index 0f1ba45df1c7..000000000000
--- a/test/fixtures/https/https.test.js
+++ /dev/null
@@ -1,3 +0,0 @@
-import { buildFixture } from '../../utils/build'
-
-buildFixture('https')
diff --git a/test/fixtures/https/nuxt.config.js b/test/fixtures/https/nuxt.config.js
deleted file mode 100644
index a9dad7610946..000000000000
--- a/test/fixtures/https/nuxt.config.js
+++ /dev/null
@@ -1,11 +0,0 @@
-import fs from 'fs'
-import path from 'path'
-
-export default {
- server: {
- https: {
- key: fs.readFileSync(path.resolve(__dirname, 'server.key')),
- cert: fs.readFileSync(path.resolve(__dirname, 'server.crt'))
- }
- }
-}
diff --git a/test/fixtures/https/pages/index.vue b/test/fixtures/https/pages/index.vue
deleted file mode 100644
index 6156839c563e..000000000000
--- a/test/fixtures/https/pages/index.vue
+++ /dev/null
@@ -1,3 +0,0 @@
-
- Served over HTTPS!
-
diff --git a/test/fixtures/https/server.crt b/test/fixtures/https/server.crt
deleted file mode 100644
index 4aad81cae2a6..000000000000
--- a/test/fixtures/https/server.crt
+++ /dev/null
@@ -1,19 +0,0 @@
------BEGIN CERTIFICATE-----
-MIIDIjCCAougAwIBAgIJALww5SutcTujMA0GCSqGSIb3DQEBCwUAMGoxCzAJBgNV
-BAYTAkJSMRIwEAYDVQQIEwlTYW8gUGF1bG8xETAPBgNVBAcTCEJhcnJldG9zMQ0w
-CwYDVQQKEwROdXh0MREwDwYDVQQLEwhGaXh0dXJlczESMBAGA1UEAxMJbG9jYWxo
-b3N0MB4XDTE4MDkwMTIzMTk0OVoXDTE4MTAwMTIzMTk0OVowajELMAkGA1UEBhMC
-QlIxEjAQBgNVBAgTCVNhbyBQYXVsbzERMA8GA1UEBxMIQmFycmV0b3MxDTALBgNV
-BAoTBE51eHQxETAPBgNVBAsTCEZpeHR1cmVzMRIwEAYDVQQDEwlsb2NhbGhvc3Qw
-gZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBALoFJlquH9KNTPS3E0jbdKWLVw+N
-oQaV+yPGPJb/IEAtg2cgMy62UlBS8eMTnMAv6JntuSuqS9wWdrvrTvcJkbbCRnKp
-P13OTPpzhXO8R9pgzsopaO0DfLM8mTpFi1UPhzRm5riRCVIcg/KYH5JybI7LVzVu
-v6LT3DhOtqp3tufRAgMBAAGjgc8wgcwwHQYDVR0OBBYEFIHCFtBMyB2w+os85zPR
-AkI05z4FMIGcBgNVHSMEgZQwgZGAFIHCFtBMyB2w+os85zPRAkI05z4FoW6kbDBq
-MQswCQYDVQQGEwJCUjESMBAGA1UECBMJU2FvIFBhdWxvMREwDwYDVQQHEwhCYXJy
-ZXRvczENMAsGA1UEChMETnV4dDERMA8GA1UECxMIRml4dHVyZXMxEjAQBgNVBAMT
-CWxvY2FsaG9zdIIJALww5SutcTujMAwGA1UdEwQFMAMBAf8wDQYJKoZIhvcNAQEL
-BQADgYEARaylCmK13yfaARc3utZLmD+vW7P1S4CO25skgaaQasKsKtABTURz92Ju
-fShBFvP6d8AQH3yvHEC2+QBUibg6tc9oT1hE1GXYczp11AvYry3hcbalB+V1vqN+
-/vMAWDmg5Y0cE/QnJ8YZi2fHFoxkxJdDIfx5/w19vvE5h18IMro=
------END CERTIFICATE-----
diff --git a/test/fixtures/https/server.key b/test/fixtures/https/server.key
deleted file mode 100644
index 4eea4ca5aa7a..000000000000
--- a/test/fixtures/https/server.key
+++ /dev/null
@@ -1,15 +0,0 @@
------BEGIN RSA PRIVATE KEY-----
-MIICXAIBAAKBgQC6BSZarh/SjUz0txNI23Sli1cPjaEGlfsjxjyW/yBALYNnIDMu
-tlJQUvHjE5zAL+iZ7bkrqkvcFna76073CZG2wkZyqT9dzkz6c4VzvEfaYM7KKWjt
-A3yzPJk6RYtVD4c0Zua4kQlSHIPymB+ScmyOy1c1br+i09w4Traqd7bn0QIDAQAB
-AoGAWZpBb0yQZ4tIllfZIi8TcOo9dXBzMAjuf7ztUo5xqnhB41rPTKDl5WsOuKKp
-zqlFEWBA4ZeWEt1/M+WUk8o4NU2M03Q5N7cubw2T6/q43pZkCjvdTScsP6sJgGK9
-zR0o4+Owu9J5j+X9e7ChfZFVeZa3WCX6dCB17AVfUdCh7EECQQDpPdkLirOsiu5x
-/b42+/dLpL4gq+mnAqLzaeHI0Eb2Gt9A8RyxPicdjZGOJ3bmGZPFWcu2xUbmEsic
-pSbAmZujAkEAzCvBLokZ2ETJN1pZJgT3luUDmd6LsaW8BJoJ42ECM/k8ARKMJfIS
-/tqZPJhdkZ6JhYc36m4lNwPaY7x4Cbxl+wJBAM1WBZ6DnWppZUI1gSAm8q9FeZyJ
-vEmrqIlizcNcmRxQy/sASaJAdW8vEtVzKNmp6s3zH8ToKGKkZriBLHyivsECQALF
-zVfOcNVpCbqAtZk4lAwui//477i34XfGh7/Yv2jpR5FUKScSxINFgLM79nlVx9RS
-Y8YBPOwkV0DnfFHVhyUCQFYYp2B8XgghJGapOcWvp7QogkDWqCra5mrSlI+jzi5W
-b1LjJqCCCq4kGK6nKEzT7gd75lb2LbcUdc5JfFHbcE0=
------END RSA PRIVATE KEY-----
diff --git a/test/fixtures/inline-styles/app.vue b/test/fixtures/inline-styles/app.vue
new file mode 100644
index 000000000000..d23f087e0c26
--- /dev/null
+++ b/test/fixtures/inline-styles/app.vue
@@ -0,0 +1,11 @@
+
+
+
+
+
+
diff --git a/test/fixtures/inline-styles/assets/css-from-js-module.css b/test/fixtures/inline-styles/assets/css-from-js-module.css
new file mode 100644
index 000000000000..91477698b179
--- /dev/null
+++ b/test/fixtures/inline-styles/assets/css-from-js-module.css
@@ -0,0 +1,3 @@
+:root {
+ --inline-js-module-token: js-module;
+}
diff --git a/test/fixtures/inline-styles/assets/preprocessor-from-script.pcss b/test/fixtures/inline-styles/assets/preprocessor-from-script.pcss
new file mode 100644
index 000000000000..9455958ba0a2
--- /dev/null
+++ b/test/fixtures/inline-styles/assets/preprocessor-from-script.pcss
@@ -0,0 +1,3 @@
+:root {
+ --inline-preprocessor-from-script-token: preprocessor-from-script;
+}
diff --git a/test/fixtures/inline-styles/assets/script-setup-css.css b/test/fixtures/inline-styles/assets/script-setup-css.css
new file mode 100644
index 000000000000..3c2de47ee48b
--- /dev/null
+++ b/test/fixtures/inline-styles/assets/script-setup-css.css
@@ -0,0 +1,3 @@
+.script-setup-css {
+ --inline-script-setup-css-token: script-setup-css;
+}
diff --git a/test/fixtures/inline-styles/components/JSModuleComponentWrapper.vue b/test/fixtures/inline-styles/components/JSModuleComponentWrapper.vue
new file mode 100644
index 000000000000..49270f75a9ed
--- /dev/null
+++ b/test/fixtures/inline-styles/components/JSModuleComponentWrapper.vue
@@ -0,0 +1,7 @@
+
+
+
+
diff --git a/test/fixtures/inline-styles/components/NormalComponent.vue b/test/fixtures/inline-styles/components/NormalComponent.vue
new file mode 100644
index 000000000000..f59b577e7e9f
--- /dev/null
+++ b/test/fixtures/inline-styles/components/NormalComponent.vue
@@ -0,0 +1,9 @@
+
+
+
+
+
diff --git a/test/fixtures/inline-styles/components/PreprocessorFromScript.vue b/test/fixtures/inline-styles/components/PreprocessorFromScript.vue
new file mode 100644
index 000000000000..6609d75038e9
--- /dev/null
+++ b/test/fixtures/inline-styles/components/PreprocessorFromScript.vue
@@ -0,0 +1,11 @@
+
+
+
+
diff --git a/test/fixtures/inline-styles/components/ScriptSetupCss.vue b/test/fixtures/inline-styles/components/ScriptSetupCss.vue
new file mode 100644
index 000000000000..6be166a9d41b
--- /dev/null
+++ b/test/fixtures/inline-styles/components/ScriptSetupCss.vue
@@ -0,0 +1,7 @@
+
+
+
+
diff --git a/test/fixtures/inline-styles/components/ServerComponent.server.vue b/test/fixtures/inline-styles/components/ServerComponent.server.vue
new file mode 100644
index 000000000000..b6627213f751
--- /dev/null
+++ b/test/fixtures/inline-styles/components/ServerComponent.server.vue
@@ -0,0 +1,3 @@
+
+
+
diff --git a/test/fixtures/inline-styles/components/js-module-component.js b/test/fixtures/inline-styles/components/js-module-component.js
new file mode 100644
index 000000000000..dbeab17e3e94
--- /dev/null
+++ b/test/fixtures/inline-styles/components/js-module-component.js
@@ -0,0 +1,8 @@
+import '~/assets/css-from-js-module.css'
+
+import { h } from 'vue'
+
+export default {
+ name: 'JSModuleComponent',
+ render: () => h('span', { class: 'js-module-component' }),
+}
diff --git a/test/fixtures/inline-styles/nuxt.config.ts b/test/fixtures/inline-styles/nuxt.config.ts
new file mode 100644
index 000000000000..af3d7f4e92f5
--- /dev/null
+++ b/test/fixtures/inline-styles/nuxt.config.ts
@@ -0,0 +1,16 @@
+import { isNuxtPrepare, projectSuffix, withMatrix } from '../../matrix'
+
+// Regression for https://github.com/nuxt/nuxt/issues/30435: when every CSS
+// module bundled into a chunk's CSS asset has also been inlined as a `
diff --git a/test/fixtures/inline-styles/pages/index.vue b/test/fixtures/inline-styles/pages/index.vue
new file mode 100644
index 000000000000..b471f37d6ab3
--- /dev/null
+++ b/test/fixtures/inline-styles/pages/index.vue
@@ -0,0 +1,12 @@
+
+
+ index page
+
+
+
+
diff --git a/test/fixtures/inline-styles/pages/js-imported-css.vue b/test/fixtures/inline-styles/pages/js-imported-css.vue
new file mode 100644
index 000000000000..7aee795c8aa9
--- /dev/null
+++ b/test/fixtures/inline-styles/pages/js-imported-css.vue
@@ -0,0 +1,7 @@
+
+
+
+
diff --git a/test/fixtures/inline-styles/tsconfig.json b/test/fixtures/inline-styles/tsconfig.json
new file mode 100644
index 000000000000..6ae5970c766b
--- /dev/null
+++ b/test/fixtures/inline-styles/tsconfig.json
@@ -0,0 +1,17 @@
+{
+ "files": [],
+ "references": [
+ {
+ "path": "./.nuxt/tsconfig.app.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.server.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.shared.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.node.json"
+ }
+ ]
+}
diff --git a/test/fixtures/lazy-hydration/app.vue b/test/fixtures/lazy-hydration/app.vue
new file mode 100644
index 000000000000..c9887246b623
--- /dev/null
+++ b/test/fixtures/lazy-hydration/app.vue
@@ -0,0 +1,5 @@
+
+
+
+
diff --git a/test/fixtures/lazy-hydration/components/HydrateNeverComponent.vue b/test/fixtures/lazy-hydration/components/HydrateNeverComponent.vue
new file mode 100644
index 000000000000..9e3f8a466983
--- /dev/null
+++ b/test/fixtures/lazy-hydration/components/HydrateNeverComponent.vue
@@ -0,0 +1,18 @@
+
+
+ Hydrate Never
+
+
+
+
diff --git a/test/fixtures/lazy-hydration/nuxt.config.ts b/test/fixtures/lazy-hydration/nuxt.config.ts
new file mode 100644
index 000000000000..681ae51a4981
--- /dev/null
+++ b/test/fixtures/lazy-hydration/nuxt.config.ts
@@ -0,0 +1,7 @@
+export default defineNuxtConfig({
+ devtools: { enabled: false },
+ features: {
+ inlineStyles: false,
+ },
+ compatibilityDate: 'latest',
+})
diff --git a/test/fixtures/lazy-hydration/package.json b/test/fixtures/lazy-hydration/package.json
new file mode 100644
index 000000000000..f7b305d4ce1b
--- /dev/null
+++ b/test/fixtures/lazy-hydration/package.json
@@ -0,0 +1,11 @@
+{
+ "name": "fixture-lazy-hydration",
+ "private": true,
+ "type": "module",
+ "dependencies": {
+ "nuxt": "workspace:*"
+ },
+ "engines": {
+ "node": "^22.12.0 || ^24.11.0 || >=26.0.0"
+ }
+}
diff --git a/test/fixtures/lazy-hydration/tsconfig.json b/test/fixtures/lazy-hydration/tsconfig.json
new file mode 100644
index 000000000000..4b34df1571f7
--- /dev/null
+++ b/test/fixtures/lazy-hydration/tsconfig.json
@@ -0,0 +1,3 @@
+{
+ "extends": "./.nuxt/tsconfig.json"
+}
diff --git a/test/fixtures/minimal-pages/app/app.vue b/test/fixtures/minimal-pages/app/app.vue
new file mode 100644
index 000000000000..8af1acfee31f
--- /dev/null
+++ b/test/fixtures/minimal-pages/app/app.vue
@@ -0,0 +1,3 @@
+
+
diff --git a/test/fixtures/minimal-pages/app/error.vue b/test/fixtures/minimal-pages/app/error.vue
new file mode 100644
index 000000000000..17b10099565a
--- /dev/null
+++ b/test/fixtures/minimal-pages/app/error.vue
@@ -0,0 +1,3 @@
+
+ Error page
+
diff --git a/test/fixtures/minimal-pages/app/layouts/default.vue b/test/fixtures/minimal-pages/app/layouts/default.vue
new file mode 100644
index 000000000000..ba4672f56db7
--- /dev/null
+++ b/test/fixtures/minimal-pages/app/layouts/default.vue
@@ -0,0 +1,3 @@
+
+
diff --git a/test/fixtures/minimal-pages/app/middleware/test.global.ts b/test/fixtures/minimal-pages/app/middleware/test.global.ts
new file mode 100644
index 000000000000..3d59968d2c4f
--- /dev/null
+++ b/test/fixtures/minimal-pages/app/middleware/test.global.ts
@@ -0,0 +1 @@
+export default defineNuxtRouteMiddleware(() => {})
diff --git a/test/fixtures/minimal-pages/app/pages/a.client.vue b/test/fixtures/minimal-pages/app/pages/a.client.vue
new file mode 100644
index 000000000000..e2bcd0be73f3
--- /dev/null
+++ b/test/fixtures/minimal-pages/app/pages/a.client.vue
@@ -0,0 +1,3 @@
+
+ Client-only page
+
diff --git a/test/fixtures/minimal-pages/app/pages/b.server.vue b/test/fixtures/minimal-pages/app/pages/b.server.vue
new file mode 100644
index 000000000000..62aecd9915f1
--- /dev/null
+++ b/test/fixtures/minimal-pages/app/pages/b.server.vue
@@ -0,0 +1,3 @@
+
+ Server-only page
+
diff --git a/test/fixtures/minimal-pages/app/pages/index.vue b/test/fixtures/minimal-pages/app/pages/index.vue
new file mode 100644
index 000000000000..585f495151c9
--- /dev/null
+++ b/test/fixtures/minimal-pages/app/pages/index.vue
@@ -0,0 +1,3 @@
+
+ Hello World!
+
diff --git a/test/fixtures/minimal-pages/app/plugins/test.ts b/test/fixtures/minimal-pages/app/plugins/test.ts
new file mode 100644
index 000000000000..0b12056e3c44
--- /dev/null
+++ b/test/fixtures/minimal-pages/app/plugins/test.ts
@@ -0,0 +1 @@
+export default defineNuxtPlugin(() => {})
diff --git a/test/fixtures/minimal-pages/nuxt.config.ts b/test/fixtures/minimal-pages/nuxt.config.ts
new file mode 100644
index 000000000000..dbd39cba5276
--- /dev/null
+++ b/test/fixtures/minimal-pages/nuxt.config.ts
@@ -0,0 +1,28 @@
+import { readFileSync } from 'node:fs'
+import { fileURLToPath } from 'node:url'
+
+const nuxtEntry = fileURLToPath(new URL('../../../packages/nuxt/dist/index.mjs', import.meta.url))
+const isStubbed = readFileSync(nuxtEntry, 'utf-8').includes('const _module = await jiti')
+
+export default defineNuxtConfig({
+ $production: {
+ vite: {
+ $client: {
+ build: {
+ rolldownOptions: {
+ output: {
+ chunkFileNames: '_nuxt/[name].js',
+ entryFileNames: '_nuxt/[name].js',
+ },
+ },
+ },
+ },
+ },
+ },
+ devtools: { enabled: false },
+ sourcemap: false,
+ compatibilityDate: 'latest',
+ typescript: {
+ typeCheck: isStubbed ? false : 'build',
+ },
+})
diff --git a/test/fixtures/minimal-pages/package.json b/test/fixtures/minimal-pages/package.json
new file mode 100644
index 000000000000..1c6e7fa93527
--- /dev/null
+++ b/test/fixtures/minimal-pages/package.json
@@ -0,0 +1,13 @@
+{
+ "private": true,
+ "name": "fixture-minimal-pages",
+ "scripts": {
+ "build": "nuxt build"
+ },
+ "dependencies": {
+ "nuxt": "workspace:*"
+ },
+ "engines": {
+ "node": "^22.12.0 || ^24.11.0 || >=26.0.0"
+ }
+}
diff --git a/test/fixtures/minimal-pages/tsconfig.json b/test/fixtures/minimal-pages/tsconfig.json
new file mode 100644
index 000000000000..6ae5970c766b
--- /dev/null
+++ b/test/fixtures/minimal-pages/tsconfig.json
@@ -0,0 +1,17 @@
+{
+ "files": [],
+ "references": [
+ {
+ "path": "./.nuxt/tsconfig.app.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.server.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.shared.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.node.json"
+ }
+ ]
+}
diff --git a/test/fixtures/minimal-types/app-types.ts b/test/fixtures/minimal-types/app-types.ts
new file mode 100644
index 000000000000..8501abc1fc3e
--- /dev/null
+++ b/test/fixtures/minimal-types/app-types.ts
@@ -0,0 +1,46 @@
+import { describe, expectTypeOf, it } from 'vitest'
+
+describe('routing utilities', () => {
+ it('allows using route composables', () => {
+ const router = useRouter()
+ router.push('/test')
+
+ expectTypeOf(useRouter()).not.toBeAny()
+ expectTypeOf(useRoute()).not.toBeAny()
+
+ navigateTo('/thing')
+ })
+})
+
+describe('auto-imports', () => {
+ it('core composables', () => {
+ ref()
+ useHead({
+ script: [],
+ // @ts-expect-error Should show error on unknown properties
+ unknown: [],
+ })
+ })
+})
+
+describe('config typings', () => {
+ it('runtimeConfig', () => {
+ const config = useRuntimeConfig()
+ expectTypeOf(config.public).toEqualTypeOf>()
+ expectTypeOf(config.app).toEqualTypeOf<{
+ baseURL: string
+ buildAssetsDir: string
+ cdnURL: string
+ [key: string]: any
+ }>()
+ })
+
+ it('appConfig', () => {
+ expectTypeOf(useAppConfig().foo).toEqualTypeOf()
+ expectTypeOf(useAppConfig()).toEqualTypeOf<{
+ // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ nuxt: {}
+ [key: string]: unknown
+ }>()
+ })
+})
diff --git a/test/fixtures/minimal-types/app.vue b/test/fixtures/minimal-types/app.vue
new file mode 100644
index 000000000000..904b174b8741
--- /dev/null
+++ b/test/fixtures/minimal-types/app.vue
@@ -0,0 +1,7 @@
+
+ Hello World!
+
+
+
diff --git a/test/fixtures/minimal-types/nuxt.config.ts b/test/fixtures/minimal-types/nuxt.config.ts
new file mode 100644
index 000000000000..98299cf1d746
--- /dev/null
+++ b/test/fixtures/minimal-types/nuxt.config.ts
@@ -0,0 +1,12 @@
+export default defineNuxtConfig({
+ modules: [],
+ devtools: { enabled: false },
+ routeRules: {
+ // Should accept any string
+ '/named': { appMiddleware: 'named' },
+ },
+ experimental: { appManifest: true },
+ compatibilityDate: 'latest',
+ // @ts-expect-error Should show error on unknown properties
+ unknownProp: '',
+})
diff --git a/test/fixtures/minimal-types/package.json b/test/fixtures/minimal-types/package.json
new file mode 100644
index 000000000000..fa33342dbfeb
--- /dev/null
+++ b/test/fixtures/minimal-types/package.json
@@ -0,0 +1,14 @@
+{
+ "private": true,
+ "name": "fixture-minimal-types",
+ "scripts": {
+ "build": "nuxt build",
+ "test:types": "nuxt prepare && npx vue-tsc -b --noEmit"
+ },
+ "dependencies": {
+ "nuxt": "workspace:*"
+ },
+ "engines": {
+ "node": "^22.12.0 || ^24.11.0 || >=26.0.0"
+ }
+}
diff --git a/test/fixtures/minimal-types/tsconfig.json b/test/fixtures/minimal-types/tsconfig.json
new file mode 100644
index 000000000000..6ae5970c766b
--- /dev/null
+++ b/test/fixtures/minimal-types/tsconfig.json
@@ -0,0 +1,17 @@
+{
+ "files": [],
+ "references": [
+ {
+ "path": "./.nuxt/tsconfig.app.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.server.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.shared.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.node.json"
+ }
+ ]
+}
diff --git a/test/fixtures/minimal/app.vue b/test/fixtures/minimal/app.vue
new file mode 100644
index 000000000000..bf036e597402
--- /dev/null
+++ b/test/fixtures/minimal/app.vue
@@ -0,0 +1,16 @@
+
+
+
+ Hello World!
+
diff --git a/test/fixtures/minimal/error.vue b/test/fixtures/minimal/error.vue
new file mode 100644
index 000000000000..17b10099565a
--- /dev/null
+++ b/test/fixtures/minimal/error.vue
@@ -0,0 +1,3 @@
+
+ Error page
+
diff --git a/test/fixtures/minimal/nuxt.config.ts b/test/fixtures/minimal/nuxt.config.ts
new file mode 100644
index 000000000000..385b1236837d
--- /dev/null
+++ b/test/fixtures/minimal/nuxt.config.ts
@@ -0,0 +1,29 @@
+import { readFileSync } from 'node:fs'
+import { fileURLToPath } from 'node:url'
+
+const nuxtEntry = fileURLToPath(new URL('../../../packages/nuxt/dist/index.mjs', import.meta.url))
+const isStubbed = readFileSync(nuxtEntry, 'utf-8').includes('const _module = await jiti')
+
+export default defineNuxtConfig({
+ $production: {
+ vite: {
+ $client: {
+ build: {
+ rolldownOptions: {
+ output: {
+ chunkFileNames: '_nuxt/[name].js',
+ entryFileNames: '_nuxt/[name].js',
+ },
+ },
+ },
+ },
+ },
+ },
+ pages: false,
+ devtools: { enabled: false },
+ sourcemap: false,
+ compatibilityDate: 'latest',
+ typescript: {
+ typeCheck: isStubbed ? false : 'build',
+ },
+})
diff --git a/test/fixtures/minimal/package.json b/test/fixtures/minimal/package.json
new file mode 100644
index 000000000000..711ba485fa1b
--- /dev/null
+++ b/test/fixtures/minimal/package.json
@@ -0,0 +1,13 @@
+{
+ "private": true,
+ "name": "fixture-minimal",
+ "scripts": {
+ "build": "nuxt build"
+ },
+ "dependencies": {
+ "nuxt": "workspace:*"
+ },
+ "engines": {
+ "node": "^22.12.0 || ^24.11.0 || >=26.0.0"
+ }
+}
diff --git a/test/fixtures/minimal/tsconfig.json b/test/fixtures/minimal/tsconfig.json
new file mode 100644
index 000000000000..6ae5970c766b
--- /dev/null
+++ b/test/fixtures/minimal/tsconfig.json
@@ -0,0 +1,17 @@
+{
+ "files": [],
+ "references": [
+ {
+ "path": "./.nuxt/tsconfig.app.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.server.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.shared.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.node.json"
+ }
+ ]
+}
diff --git a/test/fixtures/missing-pages-dir/missing-pages-dir.test.js b/test/fixtures/missing-pages-dir/missing-pages-dir.test.js
deleted file mode 100644
index 4c98210c8bf9..000000000000
--- a/test/fixtures/missing-pages-dir/missing-pages-dir.test.js
+++ /dev/null
@@ -1,10 +0,0 @@
-import consola from 'consola'
-import { buildFixture } from '../../utils/build'
-
-describe('missing-pages-dir', () => {
- buildFixture('missing-pages-dir', (builder) => {
- const { options } = builder.nuxt
- expect(consola.warn).toHaveBeenCalledTimes(1)
- expect(consola.warn).toHaveBeenCalledWith(`No \`${options.dir.pages}\` directory found in ${options.srcDir}. Using the default built-in page.`)
- })
-})
diff --git a/test/fixtures/missing-plugin/nuxt.config.js b/test/fixtures/missing-plugin/nuxt.config.js
deleted file mode 100644
index dd6fcfa08536..000000000000
--- a/test/fixtures/missing-plugin/nuxt.config.js
+++ /dev/null
@@ -1,3 +0,0 @@
-export default {
- plugins: ['~/plugins/missing.js']
-}
diff --git a/test/fixtures/missing-style-resource/nuxt.config.js b/test/fixtures/missing-style-resource/nuxt.config.js
deleted file mode 100644
index 9cca732b03e1..000000000000
--- a/test/fixtures/missing-style-resource/nuxt.config.js
+++ /dev/null
@@ -1,7 +0,0 @@
-export default {
- build: {
- styleResources: {
- stylus: './nothinghere'
- }
- }
-}
diff --git a/test/fixtures/modern/modern.test.js b/test/fixtures/modern/modern.test.js
deleted file mode 100644
index 27447d1fede5..000000000000
--- a/test/fixtures/modern/modern.test.js
+++ /dev/null
@@ -1,3 +0,0 @@
-import { buildFixture } from '../../utils/build'
-
-buildFixture('modern')
diff --git a/test/fixtures/modern/nuxt.config.js b/test/fixtures/modern/nuxt.config.js
deleted file mode 100644
index a11c4f59f203..000000000000
--- a/test/fixtures/modern/nuxt.config.js
+++ /dev/null
@@ -1,19 +0,0 @@
-export default {
- modern: true,
- build: {
- filenames: {
- app: ({ isModern }) => {
- return `${isModern ? 'modern-' : ''}[name].js`
- },
- chunk: ({ isModern }) => {
- return `${isModern ? 'modern-' : ''}[name].js`
- }
- }
- },
- render: {
- crossorigin: 'use-credentials',
- http2: {
- push: true
- }
- }
-}
diff --git a/test/fixtures/modern/pages/index.vue b/test/fixtures/modern/pages/index.vue
deleted file mode 100644
index f0ffe0a8a152..000000000000
--- a/test/fixtures/modern/pages/index.vue
+++ /dev/null
@@ -1,18 +0,0 @@
-
- Index page
-
-
-
diff --git a/test/fixtures/module/layouts/layout.vue b/test/fixtures/module/layouts/layout.vue
deleted file mode 100644
index 85562e97e60f..000000000000
--- a/test/fixtures/module/layouts/layout.vue
+++ /dev/null
@@ -1,6 +0,0 @@
-
-
-
Layouts
-
diff --git a/test/fixtures/module/module.test.js b/test/fixtures/module/module.test.js
deleted file mode 100644
index 36d977ac2ed0..000000000000
--- a/test/fixtures/module/module.test.js
+++ /dev/null
@@ -1,3 +0,0 @@
-import { buildFixture } from '../../utils/build'
-
-buildFixture('module')
diff --git a/test/fixtures/module/modules/basic/index.js b/test/fixtures/module/modules/basic/index.js
deleted file mode 100644
index f3152bbc15c9..000000000000
--- a/test/fixtures/module/modules/basic/index.js
+++ /dev/null
@@ -1,30 +0,0 @@
-import path from 'path'
-
-export default function basicModule (options) {
- // Add a plugin
- this.addPlugin(path.resolve(__dirname, 'reverse.js'))
-
- // Add a layout
- this.addLayout(path.resolve(__dirname, 'layout.vue'))
-
- // Extend build
- this.extendBuild((config, { isClient, isServer }) => {
- // Do nothing!
- })
-
- // Extend build again
- this.extendBuild((config, { isClient, isServer }) => {
- // Do nothing!
- return config
- })
-
- // Extend routes
- this.extendRoutes((routes, resolve) => {
- // Do nothing!
- return routes
- })
-
- // Require same module twice
- this.requireModule('~/modules/empty/index.js')
- this.requireModule('~/modules/empty/index.js')
-}
diff --git a/test/fixtures/module/modules/basic/layout.vue b/test/fixtures/module/modules/basic/layout.vue
deleted file mode 100644
index f0d5263c490b..000000000000
--- a/test/fixtures/module/modules/basic/layout.vue
+++ /dev/null
@@ -1,6 +0,0 @@
-
-
-
Module Layouts
-
diff --git a/test/fixtures/module/modules/basic/reverse.js b/test/fixtures/module/modules/basic/reverse.js
deleted file mode 100644
index 9b6e3e43e810..000000000000
--- a/test/fixtures/module/modules/basic/reverse.js
+++ /dev/null
@@ -1,14 +0,0 @@
-// Simple Nuxt Plugin
-
-import Vue from 'vue'
-
-function $reverseStr (str) {
- return str.split('').reverse().join('')
-}
-
-Vue.prototype.$reverseStr = $reverseStr
-
-export default undefined
-
-// Legacy support: https://github.com/nuxt/nuxt.js/issues/4350
-// <%= _.toUpper('foo') %>
diff --git a/test/fixtures/module/modules/empty/index.js b/test/fixtures/module/modules/empty/index.js
deleted file mode 100644
index 5aa3d10510d0..000000000000
--- a/test/fixtures/module/modules/empty/index.js
+++ /dev/null
@@ -1,7 +0,0 @@
-export default function middlewareModule (options) {
- // Empty module
-}
-
-module.exports.meta = {
- name: 'Empty Module!'
-}
diff --git a/test/fixtures/module/modules/hooks/index.js b/test/fixtures/module/modules/hooks/index.js
deleted file mode 100644
index 87cca8df29b1..000000000000
--- a/test/fixtures/module/modules/hooks/index.js
+++ /dev/null
@@ -1,28 +0,0 @@
-export default function () {
- let ctr = 1
-
- // Add hook for module
- this.nuxt.hook('modules:done', (moduleContainer) => {
- this.nuxt.__module_hook = moduleContainer && ctr++
- })
-
- // Add hook for renderer
- this.nuxt.hook('render:done', (renderer) => {
- this.nuxt.__renderer_hook = renderer && ctr++
- })
-
- // Get data before data sent to client
- // TODO: Remove in next major release
- this.nuxt.hook('render:context', (data) => {
- this.nuxt.__render_context = data
- })
-
- // Add hook for build
- this.nuxt.hook('build:done', (builder) => {
- this.nuxt.__builder_hook = builder && ctr++
- })
-
- this.nuxt.hook('build:done', (builder) => {
- this.nuxt.__builder_plugin = builder && ctr++
- })
-}
diff --git a/test/fixtures/module/modules/layout/index.js b/test/fixtures/module/modules/layout/index.js
deleted file mode 100644
index e4921412e784..000000000000
--- a/test/fixtures/module/modules/layout/index.js
+++ /dev/null
@@ -1,6 +0,0 @@
-import { resolve } from 'path'
-
-export default function module () {
- this.addLayout(
- { src: resolve(__dirname, 'some-error.vue') }, 'error')
-}
diff --git a/test/fixtures/module/modules/layout/some-error.vue b/test/fixtures/module/modules/layout/some-error.vue
deleted file mode 100644
index e11cbe3f2885..000000000000
--- a/test/fixtures/module/modules/layout/some-error.vue
+++ /dev/null
@@ -1,3 +0,0 @@
-
- You should see the error in a different Vue!
-
diff --git a/test/fixtures/module/modules/middleware/index.js b/test/fixtures/module/modules/middleware/index.js
deleted file mode 100644
index 90078d206f67..000000000000
--- a/test/fixtures/module/modules/middleware/index.js
+++ /dev/null
@@ -1,21 +0,0 @@
-export default function middlewareModule (options) {
- return new Promise((resolve, reject) => {
- // Add /api endpoint
- this.addServerMiddleware({
- path: '/api',
- handler (req, res, next) {
- res.end('It works!')
- }
- })
- // Add local middleware js
- this.addServerMiddleware('~/modules/middleware/log.js')
- // Add plain middleware
- this.addServerMiddleware((req, res, next) => {
- res.setHeader('x-nuxt', 'hello')
- next()
- })
- // Add file middleware
- this.addServerMiddleware('~/modules/middleware/midd1')
- resolve()
- })
-}
diff --git a/test/fixtures/module/modules/middleware/log.js b/test/fixtures/module/modules/middleware/log.js
deleted file mode 100644
index 400f47cb51b9..000000000000
--- a/test/fixtures/module/modules/middleware/log.js
+++ /dev/null
@@ -1,5 +0,0 @@
-export default function (req, res, next) {
- // eslint-disable-next-line no-console
- console.log(req.url)
- next()
-}
diff --git a/test/fixtures/module/modules/middleware/midd1.js b/test/fixtures/module/modules/middleware/midd1.js
deleted file mode 100644
index 4ccf32924dce..000000000000
--- a/test/fixtures/module/modules/middleware/midd1.js
+++ /dev/null
@@ -1,4 +0,0 @@
-export default function (req, res, next) {
- res.setHeader('x-midd-1', 'ok')
- next()
-}
diff --git a/test/fixtures/module/modules/middleware/midd2.js b/test/fixtures/module/modules/middleware/midd2.js
deleted file mode 100644
index cd0d65cbaa11..000000000000
--- a/test/fixtures/module/modules/middleware/midd2.js
+++ /dev/null
@@ -1,4 +0,0 @@
-export default function (req, res, next) {
- res.setHeader('x-midd-2', 'ok')
- next()
-}
diff --git a/test/fixtures/module/modules/middleware/midd3.js b/test/fixtures/module/modules/middleware/midd3.js
deleted file mode 100644
index 341685de2934..000000000000
--- a/test/fixtures/module/modules/middleware/midd3.js
+++ /dev/null
@@ -1,7 +0,0 @@
-export default {
- path: '/midd3',
- handler (req, res) {
- res.write('Be creative when writing test strings! Hey Mama :wave:')
- res.end()
- }
-}
diff --git a/test/fixtures/module/modules/middleware/use-middleware.js b/test/fixtures/module/modules/middleware/use-middleware.js
deleted file mode 100644
index 624ff48a830e..000000000000
--- a/test/fixtures/module/modules/middleware/use-middleware.js
+++ /dev/null
@@ -1,3 +0,0 @@
-export default function (req, res, next) {
- res.end('Use external middleware')
-}
diff --git a/test/fixtures/module/modules/template/index.js b/test/fixtures/module/modules/template/index.js
deleted file mode 100644
index 3d95885e1493..000000000000
--- a/test/fixtures/module/modules/template/index.js
+++ /dev/null
@@ -1,12 +0,0 @@
-import path from 'path'
-
-export default function () {
- // Disable parsing pages/
- this.nuxt.options.build.createRoutes = () => {}
-
- // Add /api endpoint
- this.addTemplate({
- fileName: 'router.js',
- src: path.resolve(this.options.srcDir, 'router.js')
- })
-}
diff --git a/test/fixtures/module/nuxt.config.js b/test/fixtures/module/nuxt.config.js
deleted file mode 100644
index 0f4d918f621c..000000000000
--- a/test/fixtures/module/nuxt.config.js
+++ /dev/null
@@ -1,34 +0,0 @@
-export default {
- loading: true,
- modules: [
- '~~/modules/basic',
- '~/modules/hooks',
- '~/modules/layout',
- {
- src: '~/modules/middleware',
- options: {
- foo: 'bar'
- }
- },
- ['./modules/template', { baz: 'ping' }]
- ],
- serverMiddleware: [
- './modules/middleware/midd2',
- '~/modules/middleware/midd3'
- ],
- hooks (hook) {
- hook('ready', (nuxt) => {
- nuxt.__ready_called__ = true
- })
- hook('build:done', (builder) => {
- builder.__build_done__ = true
- })
- // Add hook for renderer
- hook('render:before', (renderer) => {
- renderer.useMiddleware({
- path: '/use-middleware',
- handler: '~/modules/middleware/use-middleware'
- })
- })
- }
-}
diff --git a/test/fixtures/module/router.js b/test/fixtures/module/router.js
deleted file mode 100644
index 677775b5c638..000000000000
--- a/test/fixtures/module/router.js
+++ /dev/null
@@ -1,31 +0,0 @@
-import Vue from 'vue'
-import Router from 'vue-router'
-
-Vue.use(Router)
-
-const indexPage = () => import('~/views/index.vue').then(m => m.default || m)
-const aboutPage = () => import('~/views/about.vue').then(m => m.default || m)
-const layoutPage = () => import('~/views/layout.vue').then(m => m.default || m)
-
-export function createRouter () {
- return new Router({
- mode: 'history',
- routes: [
- {
- path: '/',
- component: indexPage,
- name: 'index'
- },
- {
- path: '/about',
- component: aboutPage,
- name: 'about'
- },
- {
- path: '/layout',
- component: layoutPage,
- name: 'layout'
- }
- ]
- })
-}
diff --git a/test/fixtures/module/views/about.vue b/test/fixtures/module/views/about.vue
deleted file mode 100644
index 9dc2dfcf6266..000000000000
--- a/test/fixtures/module/views/about.vue
+++ /dev/null
@@ -1,8 +0,0 @@
-
-
-
About page
-
- Home page
-
-
-
diff --git a/test/fixtures/module/views/index.vue b/test/fixtures/module/views/index.vue
deleted file mode 100644
index 441b548c4c50..000000000000
--- a/test/fixtures/module/views/index.vue
+++ /dev/null
@@ -1,8 +0,0 @@
-
-
-
{{ $reverseStr('NUXT') }}
-
- About page
-
-
-
diff --git a/test/fixtures/module/views/layout.vue b/test/fixtures/module/views/layout.vue
deleted file mode 100644
index 9bf372487d07..000000000000
--- a/test/fixtures/module/views/layout.vue
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
- Layout on module
-
-
-
diff --git a/test/fixtures/named-views/components/childLeft.vue b/test/fixtures/named-views/components/childLeft.vue
deleted file mode 100644
index 14f275498daa..000000000000
--- a/test/fixtures/named-views/components/childLeft.vue
+++ /dev/null
@@ -1,13 +0,0 @@
-
- Child Left content!
-
-
-
-
-
diff --git a/test/fixtures/named-views/components/mainTop.vue b/test/fixtures/named-views/components/mainTop.vue
deleted file mode 100644
index bb8a21ef07bb..000000000000
--- a/test/fixtures/named-views/components/mainTop.vue
+++ /dev/null
@@ -1,13 +0,0 @@
-
- Main Top content!
-
-
-
-
-
diff --git a/test/fixtures/named-views/layouts/default.vue b/test/fixtures/named-views/layouts/default.vue
deleted file mode 100644
index 9c37997d6645..000000000000
--- a/test/fixtures/named-views/layouts/default.vue
+++ /dev/null
@@ -1,6 +0,0 @@
-
-
- TOP:
-
diff --git a/test/fixtures/named-views/named-views.test.js b/test/fixtures/named-views/named-views.test.js
deleted file mode 100644
index a6f63f1ba040..000000000000
--- a/test/fixtures/named-views/named-views.test.js
+++ /dev/null
@@ -1,3 +0,0 @@
-import { buildFixture } from '../../utils/build'
-
-buildFixture('named-views')
diff --git a/test/fixtures/named-views/nuxt.config.js b/test/fixtures/named-views/nuxt.config.js
deleted file mode 100644
index 0f62d6c5ddd0..000000000000
--- a/test/fixtures/named-views/nuxt.config.js
+++ /dev/null
@@ -1,32 +0,0 @@
-export default {
- router: {
- extendRoutes (routes, resolve) {
- const indexRoute = routes.find(route => route.name === 'index')
- const indexChildRoute = indexRoute.children.find(route => route.name === 'index-child-id')
-
- Object.assign(indexChildRoute, {
- components: {
- default: indexChildRoute.component,
- left: resolve(__dirname, 'components/childLeft.vue')
- },
- chunkNames: {
- left: 'components/childLeft'
- }
- })
-
- routes
- .filter(route => ['main', 'another'].includes(route.name))
- .forEach((route) => {
- Object.assign(route, {
- components: {
- default: route.component,
- top: resolve(__dirname, 'components/mainTop.vue')
- },
- chunkNames: {
- top: 'components/mainTop'
- }
- })
- })
- }
- }
-}
diff --git a/test/fixtures/named-views/pages/another.vue b/test/fixtures/named-views/pages/another.vue
deleted file mode 100644
index 3a03798e5184..000000000000
--- a/test/fixtures/named-views/pages/another.vue
+++ /dev/null
@@ -1,6 +0,0 @@
-
-
- This page exists to ensure no regression on a bug. See the commit for more
- details.
-
-
diff --git a/test/fixtures/named-views/pages/index.vue b/test/fixtures/named-views/pages/index.vue
deleted file mode 100755
index f6884f13147a..000000000000
--- a/test/fixtures/named-views/pages/index.vue
+++ /dev/null
@@ -1,16 +0,0 @@
-
-
- LEFT:
-
-
-
-
-
diff --git a/test/fixtures/named-views/pages/index/child/_id/index.vue b/test/fixtures/named-views/pages/index/child/_id/index.vue
deleted file mode 100644
index ef15a0a2b804..000000000000
--- a/test/fixtures/named-views/pages/index/child/_id/index.vue
+++ /dev/null
@@ -1,21 +0,0 @@
-
- Child content ID:{{ id }}!
-
-
-
-
-
diff --git a/test/fixtures/named-views/pages/index/section.vue b/test/fixtures/named-views/pages/index/section.vue
deleted file mode 100644
index ae9b046728c9..000000000000
--- a/test/fixtures/named-views/pages/index/section.vue
+++ /dev/null
@@ -1,13 +0,0 @@
-
- This page does not have left panel.
-
-
-
-
-
diff --git a/test/fixtures/named-views/pages/main.vue b/test/fixtures/named-views/pages/main.vue
deleted file mode 100755
index 1c9634da85ee..000000000000
--- a/test/fixtures/named-views/pages/main.vue
+++ /dev/null
@@ -1,16 +0,0 @@
-
-
- LEFT:
-
-
-
-
-
diff --git a/test/fixtures/page-transitions/layouts/default.vue b/test/fixtures/page-transitions/layouts/default.vue
deleted file mode 100644
index a0fd9f00a6dd..000000000000
--- a/test/fixtures/page-transitions/layouts/default.vue
+++ /dev/null
@@ -1,6 +0,0 @@
-
-
-
diff --git a/test/fixtures/page-transitions/page-transitions.test.js b/test/fixtures/page-transitions/page-transitions.test.js
deleted file mode 100644
index 1b793798e628..000000000000
--- a/test/fixtures/page-transitions/page-transitions.test.js
+++ /dev/null
@@ -1,3 +0,0 @@
-import { buildFixture } from '../../utils/build'
-
-buildFixture('page-transitions')
diff --git a/test/fixtures/page-transitions/pages/callbacks.vue b/test/fixtures/page-transitions/pages/callbacks.vue
deleted file mode 100644
index d84dd0fa1b1e..000000000000
--- a/test/fixtures/page-transitions/pages/callbacks.vue
+++ /dev/null
@@ -1,12 +0,0 @@
-
-
-
Callbacks page
-
-
diff --git a/test/fixtures/page-transitions/pages/callbacks/child.vue b/test/fixtures/page-transitions/pages/callbacks/child.vue
deleted file mode 100644
index fdef9df4cccc..000000000000
--- a/test/fixtures/page-transitions/pages/callbacks/child.vue
+++ /dev/null
@@ -1,11 +0,0 @@
-
-
-
Callbacks child page
-
-
-
diff --git a/test/fixtures/page-transitions/pages/index.vue b/test/fixtures/page-transitions/pages/index.vue
deleted file mode 100644
index c4090b7d03e0..000000000000
--- a/test/fixtures/page-transitions/pages/index.vue
+++ /dev/null
@@ -1,11 +0,0 @@
-
-
-
Index page
-
-
-
diff --git a/test/fixtures/page-transitions/pages/transition-properties.vue b/test/fixtures/page-transitions/pages/transition-properties.vue
deleted file mode 100644
index c7a11ba46de4..000000000000
--- a/test/fixtures/page-transitions/pages/transition-properties.vue
+++ /dev/null
@@ -1,18 +0,0 @@
-
-
-
Transition properties page
-
-
-
diff --git a/test/fixtures/page-transitions/pages/transition-properties/child.vue b/test/fixtures/page-transitions/pages/transition-properties/child.vue
deleted file mode 100644
index a757f7127334..000000000000
--- a/test/fixtures/page-transitions/pages/transition-properties/child.vue
+++ /dev/null
@@ -1,18 +0,0 @@
-
-
-
Transition name child page
-
-
-
-
-
diff --git a/test/fixtures/page-transitions/utils/transition-properties.js b/test/fixtures/page-transitions/utils/transition-properties.js
deleted file mode 100644
index fa424a131914..000000000000
--- a/test/fixtures/page-transitions/utils/transition-properties.js
+++ /dev/null
@@ -1,34 +0,0 @@
-const addEvent = (componentName, callbackName, clear = false) => {
- const ul = document.querySelector('#transition-events')
- if (clear) {
- ul.innerHTML = ''
- }
- const li = document.createElement('li')
- li.textContent = `${componentName}|${callbackName}`
- ul.appendChild(li)
-}
-
-export const createTransitionObject = (componentName, transitionName = 'page', child = false) => ({
- name: transitionName,
-
- beforeEnter () {
- addEvent(componentName, 'beforeEnter', child)
- },
- enter (el, done) {
- addEvent(componentName, 'enter')
- done()
- },
- afterEnter () {
- addEvent(componentName, 'afterEnter')
- },
- beforeLeave () {
- addEvent(componentName, 'beforeLeave', true)
- },
- leave (el, done) {
- addEvent(componentName, 'leave')
- done()
- },
- afterLeave () {
- addEvent(componentName, 'afterLeave')
- }
-})
diff --git a/test/fixtures/route-name-splitter/nuxt.config.js b/test/fixtures/route-name-splitter/nuxt.config.js
deleted file mode 100644
index 8f72308a6dfb..000000000000
--- a/test/fixtures/route-name-splitter/nuxt.config.js
+++ /dev/null
@@ -1,5 +0,0 @@
-export default {
- router: {
- routeNameSplitter: '/'
- }
-}
diff --git a/test/fixtures/route-name-splitter/pages/_/_.vue b/test/fixtures/route-name-splitter/pages/_/_.vue
deleted file mode 100644
index e69de29bb2d1..000000000000
diff --git a/test/fixtures/route-name-splitter/pages/_/index.vue b/test/fixtures/route-name-splitter/pages/_/index.vue
deleted file mode 100644
index e69de29bb2d1..000000000000
diff --git a/test/fixtures/route-name-splitter/pages/_/p/_.vue b/test/fixtures/route-name-splitter/pages/_/p/_.vue
deleted file mode 100644
index e69de29bb2d1..000000000000
diff --git a/test/fixtures/route-name-splitter/pages/index.vue b/test/fixtures/route-name-splitter/pages/index.vue
deleted file mode 100644
index e69de29bb2d1..000000000000
diff --git a/test/fixtures/route-name-splitter/pages/parent/child.vue b/test/fixtures/route-name-splitter/pages/parent/child.vue
deleted file mode 100644
index e69de29bb2d1..000000000000
diff --git a/test/fixtures/route-name-splitter/pages/parent/index.vue b/test/fixtures/route-name-splitter/pages/parent/index.vue
deleted file mode 100644
index e69de29bb2d1..000000000000
diff --git a/test/fixtures/route-name-splitter/pages/posts.vue b/test/fixtures/route-name-splitter/pages/posts.vue
deleted file mode 100644
index e69de29bb2d1..000000000000
diff --git a/test/fixtures/route-name-splitter/pages/posts/_id.vue b/test/fixtures/route-name-splitter/pages/posts/_id.vue
deleted file mode 100644
index e69de29bb2d1..000000000000
diff --git a/test/fixtures/route-name-splitter/route-name-splitter.test.js b/test/fixtures/route-name-splitter/route-name-splitter.test.js
deleted file mode 100644
index 61147da103f1..000000000000
--- a/test/fixtures/route-name-splitter/route-name-splitter.test.js
+++ /dev/null
@@ -1,3 +0,0 @@
-import { buildFixture } from '../../utils/build'
-
-buildFixture('route-name-splitter')
diff --git a/test/fixtures/runtime-compiler/.gitignore b/test/fixtures/runtime-compiler/.gitignore
new file mode 100644
index 000000000000..438cb0860d12
--- /dev/null
+++ b/test/fixtures/runtime-compiler/.gitignore
@@ -0,0 +1,8 @@
+node_modules
+*.log*
+.nuxt
+.nitro
+.cache
+.output
+.env
+dist
diff --git a/test/fixtures/runtime-compiler/app/components/Helloworld.vue b/test/fixtures/runtime-compiler/app/components/Helloworld.vue
new file mode 100644
index 000000000000..cf5e32d855a2
--- /dev/null
+++ b/test/fixtures/runtime-compiler/app/components/Helloworld.vue
@@ -0,0 +1,5 @@
+
diff --git a/test/fixtures/runtime-compiler/app/components/Name.ts b/test/fixtures/runtime-compiler/app/components/Name.ts
new file mode 100644
index 000000000000..0ff7f438e5d4
--- /dev/null
+++ b/test/fixtures/runtime-compiler/app/components/Name.ts
@@ -0,0 +1,15 @@
+export default defineNuxtComponent({
+ props: ['template', 'name'],
+
+ /**
+ * most of the time, vue compiler need at least a VNode, use h() to render the component
+ */
+ render () {
+ return h({
+ props: ['name'],
+ template: this.template,
+ }, {
+ name: this.name,
+ })
+ },
+})
diff --git a/test/fixtures/runtime-compiler/app/components/ShowTemplate.vue b/test/fixtures/runtime-compiler/app/components/ShowTemplate.vue
new file mode 100644
index 000000000000..814f4fbc325e
--- /dev/null
+++ b/test/fixtures/runtime-compiler/app/components/ShowTemplate.vue
@@ -0,0 +1,37 @@
+
+
+
+
diff --git a/test/fixtures/runtime-compiler/app/layouts/default.vue b/test/fixtures/runtime-compiler/app/layouts/default.vue
new file mode 100644
index 000000000000..8351932f1b8c
--- /dev/null
+++ b/test/fixtures/runtime-compiler/app/layouts/default.vue
@@ -0,0 +1,176 @@
+
+
+
+
+ Nuxt Runtime Compiler Tests
+
+
+
+
+
+ Overview
+
+
+
+
+ Basic Component
+
+
+
+
+ Computed Template
+
+
+
+
+ TypeScript Component
+
+
+
+
+ API Template
+
+
+
+
+ Full Dynamic Component
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/test/fixtures/runtime-compiler/app/pages/api-template.vue b/test/fixtures/runtime-compiler/app/pages/api-template.vue
new file mode 100644
index 000000000000..86a232b0c82e
--- /dev/null
+++ b/test/fixtures/runtime-compiler/app/pages/api-template.vue
@@ -0,0 +1,131 @@
+
+
+
+
+
+
API Template Test
+
+
+
+ This test demonstrates using the runtime compiler with a template string
+ that is fetched from an API endpoint. This is useful when templates need to be
+ dynamically loaded or managed outside the application.
+
+
+
+
+ Loading template from API...
+
+
+
+ Component Output:
+
+
+
+ API Response (Template):
+ {{ data.templateString }}Implementation:
+
+// ShowTemplate.vue
+export default defineNuxtComponent({
+ props: {
+ template: {
+ required: true,
+ type: String,
+ },
+ name: {
+ type: String,
+ default: () => '(missing name prop)',
+ },
+ },
+ setup (props) {
+ const showIt = h({
+ template: props.template,
+ props: {
+ name: {
+ type: String,
+ default: () => '(missing name prop)',
+ },
+ },
+ })
+ return {
+ showIt,
+ }
+ },
+})
+
+// API Endpoint (server/api/template.get.ts)
+export default defineEventHandler(() => {
+ return '<div data-testid="template-content">Hello my name is : {\{ name }}, i am defined by ShowTemplate.vue and my template is retrieved from the API</div>'
+})
+
+
+
+
+
diff --git a/test/fixtures/runtime-compiler/app/pages/basic-component.vue b/test/fixtures/runtime-compiler/app/pages/basic-component.vue
new file mode 100644
index 000000000000..e57534f4c38f
--- /dev/null
+++ b/test/fixtures/runtime-compiler/app/pages/basic-component.vue
@@ -0,0 +1,63 @@
+
+
+
+
+
+
Basic Component Test
+
+
+
+ This test demonstrates rendering a basic Vue component with a template string
+ using defineNuxtComponent. The template is defined directly in the
+ component file without requiring separate compilation.
+
+
+
+
Component Output:
+
+
+
+
Implementation:
+
+// Helloworld.vue
+export default defineNuxtComponent({
+ template: '<div>hello, Helloworld.vue here ! </div>',
+})
+
+
+
+
+
diff --git a/test/fixtures/runtime-compiler/app/pages/component-in-setup.vue b/test/fixtures/runtime-compiler/app/pages/component-in-setup.vue
new file mode 100644
index 000000000000..6366b4153c4e
--- /dev/null
+++ b/test/fixtures/runtime-compiler/app/pages/component-in-setup.vue
@@ -0,0 +1,96 @@
+
+
+
+
+
+
Computed Template Test
+
+
+
+ This test demonstrates creating a component in setup with a computed template
+ that reacts to state changes. When the count changes, the component template
+ is regenerated with the new value.
+
+
+
+
Component Output:
+
+
+
+
+
+ Increment Count: {{ count }}
+
+
+
+
Implementation:
+
+const count = ref(0)
+
+// Component with a computed template that updates when count changes
+const ComponentDefinedInSetup = computed(() => defineComponent({
+ template: `
+<div class="border">
+ <div>hello i am defined in the setup of app.vue</div>
+ <div>This component template is in a computed refreshed on count</div>
+ count: <span data-testid="computed-count">${count.value}</span>.
+ I don't recommend doing this for performance reasons; prefer passing props for mutable data.
+</div>`,
+}))
+
+
+
+
+
diff --git a/test/fixtures/runtime-compiler/app/pages/full-dynamic.vue b/test/fixtures/runtime-compiler/app/pages/full-dynamic.vue
new file mode 100644
index 000000000000..aa068006e11c
--- /dev/null
+++ b/test/fixtures/runtime-compiler/app/pages/full-dynamic.vue
@@ -0,0 +1,193 @@
+
+
+
+
+
+
Full Dynamic Component Test
+
+
+
+ This test demonstrates creating a fully dynamic component where both
+ template and script logic are fetched from an API endpoint. This approach
+ enables completely runtime-defined components with reactive behavior.
+
+
+
+
+ Loading component definition from API...
+
+
+
+ Component Output:
+
+
+
+ API Response (Component Definition):
+ {{ JSON.stringify(data!.interactiveComponent, null, 2) }}
+
Interactive Test
+
+ Click the "click here" button in the component above to test reactivity.
+ The counter should increment, demonstrating that the dynamic script is
+ properly executed and reactive.
+
+
Implementation:
+
+// In your page/component
+const { data } = await useAsyncData('interactiveComponent', async () => {
+ const interactiveComponent = await $fetch('/api/full-component')
+ return { interactiveComponent }
+})
+
+const Interactive = defineComponent({
+ props: data.value?.interactiveComponent.props,
+ setup(props) {
+ return new Function(
+ 'ref',
+ 'computed',
+ 'props',
+ data.value?.interactiveComponent.setup ?? '',
+ )(ref, computed, props)
+ },
+ template: data.value?.interactiveComponent.template,
+})
+
+// API Endpoint (server/api/full-component.get.ts)
+export default defineEventHandler(() => {
+ return {
+ props: ['lastname', 'firstname'],
+ setup: `
+ const fullName = computed(() => props.lastname + ' ' + props.firstname);
+ const count = ref(0);
+ return {fullName, count}
+ `,
+ template: '<div>my name is {\{ fullName }}, <button data-testid="inc-interactive-count" @click="count++">click here</button> count: <span data-testid="interactive-count">{\{ count }}</span>. I am defined by Interactive in the setup of App.vue. My full component definition is retrieved from the api </div>',
+ }
+})
+
+
Security Note
+
+ When using this approach in production, always sanitize templates and scripts
+ from external sources. Using new Function() with untrusted content can lead to
+ security vulnerabilities including code injection.
+
+
+
+
+
+
diff --git a/test/fixtures/runtime-compiler/app/pages/index.vue b/test/fixtures/runtime-compiler/app/pages/index.vue
new file mode 100644
index 000000000000..2e8840d000f9
--- /dev/null
+++ b/test/fixtures/runtime-compiler/app/pages/index.vue
@@ -0,0 +1,87 @@
+
+
+
+
+
+
Welcome to the Nuxt Runtime Compiler Test Suite
+
+
+
This test suite verifies that Vue's Runtime Compiler works correctly within Nuxt, testing various ways of using runtime-compiled components.
+
+
+
Test Cases
+
+
+
+ Basic Component
+ Tests a basic Vue component with a template string using defineNuxtComponent.
+
+
+
+ Computed Template
+ Tests a component defined in setup with a computed template string that updates reactively.
+
+
+
+ TypeScript Component
+ Tests a TypeScript component using runtime compiler with a render function.
+
+
+
+ API Template
+ Tests a component that loads its template from an API endpoint.
+
+
+
+ Full Dynamic Component
+ Tests a component with both template and setup script loaded from an API endpoint.
+
+
+
+
+
For Developers
+
Each test case demonstrates a different use case of the runtime compiler. Feel free to use this as a reference for implementing your own runtime-compiled components.
+
+
+
+
+
diff --git a/test/fixtures/runtime-compiler/app/pages/typescript-component.vue b/test/fixtures/runtime-compiler/app/pages/typescript-component.vue
new file mode 100644
index 000000000000..9519659f5253
--- /dev/null
+++ b/test/fixtures/runtime-compiler/app/pages/typescript-component.vue
@@ -0,0 +1,100 @@
+
+
+
+
+
+
TypeScript Component Test
+
+
+
+ This test demonstrates using the runtime compiler with a TypeScript component
+ that defines a template as a prop and renders it using a render function.
+
+
+
+
Component Output:
+
+
+
+
Implementation:
+
+// Name.ts
+export default defineNuxtComponent({
+ props: ['template', 'name'],
+ /**
+ * Most of the time, Vue compiler needs at least a VNode, use h() to render the component
+ */
+ render () {
+ return h({
+ props: ['name'],
+ template: this.template,
+ }, {
+ name: this.name,
+ })
+ },
+})
+
+
+
+
Note
+
+ This approach is useful when you need to create components programmatically
+ in TypeScript with strong type checking and don't want to use string templates directly.
+
+
+
+
+
+
diff --git a/test/fixtures/runtime-compiler/nuxt.config.ts b/test/fixtures/runtime-compiler/nuxt.config.ts
new file mode 100644
index 000000000000..0a4feda5fafb
--- /dev/null
+++ b/test/fixtures/runtime-compiler/nuxt.config.ts
@@ -0,0 +1,11 @@
+import { withMatrix } from '../../matrix'
+
+// https://nuxt.com/docs/4.x/api/nuxt-config
+export default withMatrix({
+ vue: {
+ runtimeCompiler: true,
+ },
+ experimental: {
+ nitroAutoImports: true,
+ },
+})
diff --git a/test/fixtures/runtime-compiler/package.json b/test/fixtures/runtime-compiler/package.json
new file mode 100644
index 000000000000..4931b532ada4
--- /dev/null
+++ b/test/fixtures/runtime-compiler/package.json
@@ -0,0 +1,13 @@
+{
+ "private": true,
+ "name": "fixture-runtime-compiler",
+ "scripts": {
+ "build": "nuxt build"
+ },
+ "dependencies": {
+ "nuxt": "workspace:*"
+ },
+ "engines": {
+ "node": "^22.12.0 || ^24.11.0 || >=26.0.0"
+ }
+}
diff --git a/test/fixtures/runtime-compiler/public/favicon.ico b/test/fixtures/runtime-compiler/public/favicon.ico
new file mode 100644
index 000000000000..d44088fe25f6
Binary files /dev/null and b/test/fixtures/runtime-compiler/public/favicon.ico differ
diff --git a/test/fixtures/runtime-compiler/server/api/full-component.get.ts b/test/fixtures/runtime-compiler/server/api/full-component.get.ts
new file mode 100644
index 000000000000..ef25b08af815
--- /dev/null
+++ b/test/fixtures/runtime-compiler/server/api/full-component.get.ts
@@ -0,0 +1,18 @@
+/**
+ * sometimes, CMS wants to give full control on components. This might not be a good practice.
+ * SO MAKE SURE TO SANITIZE ALL YOUR STRINGS
+ */
+export default defineEventHandler(() => {
+ return {
+ props: ['lastname', 'firstname'],
+ // don't forget to sanitize
+ setup: `
+ const fullName = computed(() => props.lastname + ' ' + props.firstname);
+
+ const count = ref(0);
+
+ return {fullName, count}
+ `,
+ template: 'my name is {{ fullName }}, click here count: {{count}} . I am defined by Interactive in the setup of App.vue. My full component definition is retrieved from the api
',
+ }
+})
diff --git a/test/fixtures/runtime-compiler/server/api/template.get.ts b/test/fixtures/runtime-compiler/server/api/template.get.ts
new file mode 100644
index 000000000000..500bb1ff858b
--- /dev/null
+++ b/test/fixtures/runtime-compiler/server/api/template.get.ts
@@ -0,0 +1,7 @@
+/**
+ * mock the behavior of nuxt retrieving data from an api
+ */
+
+export default defineEventHandler(() => {
+ return 'Hello my name is : {{name}}, i am defined by ShowTemplate.vue and my template is retrieved from the API
'
+})
diff --git a/test/fixtures/runtime-compiler/tsconfig.json b/test/fixtures/runtime-compiler/tsconfig.json
new file mode 100644
index 000000000000..6ae5970c766b
--- /dev/null
+++ b/test/fixtures/runtime-compiler/tsconfig.json
@@ -0,0 +1,17 @@
+{
+ "files": [],
+ "references": [
+ {
+ "path": "./.nuxt/tsconfig.app.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.server.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.shared.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.node.json"
+ }
+ ]
+}
diff --git a/test/fixtures/server-components/app/app.vue b/test/fixtures/server-components/app/app.vue
new file mode 100644
index 000000000000..2b1be0907419
--- /dev/null
+++ b/test/fixtures/server-components/app/app.vue
@@ -0,0 +1,5 @@
+
+
+
+
diff --git a/test/fixtures/server-components/app/components/AsyncServerComponent.server.vue b/test/fixtures/server-components/app/components/AsyncServerComponent.server.vue
new file mode 100644
index 000000000000..a8f3df2dbd51
--- /dev/null
+++ b/test/fixtures/server-components/app/components/AsyncServerComponent.server.vue
@@ -0,0 +1,20 @@
+
+
+ This is a .server (20ms) async component
+ {{ data }}
+
+ {{ count }}
+
+
+
+
+
+
+
diff --git a/test/fixtures/server-components/app/components/ComponentWithRef.vue b/test/fixtures/server-components/app/components/ComponentWithRef.vue
new file mode 100644
index 000000000000..298d6fad82c8
--- /dev/null
+++ b/test/fixtures/server-components/app/components/ComponentWithRef.vue
@@ -0,0 +1,16 @@
+
+
+
+
+
diff --git a/test/fixtures/server-components/app/components/Counter.vue b/test/fixtures/server-components/app/components/Counter.vue
new file mode 100644
index 000000000000..329ffc0393ec
--- /dev/null
+++ b/test/fixtures/server-components/app/components/Counter.vue
@@ -0,0 +1,17 @@
+
+
+
+
+
+ Sugar Counter {{ count }} x {{ multiplier }} = {{ doubled }}
+
+ Inc
+
+
+
diff --git a/test/fixtures/server-components/app/components/CounterWithNuxtClient.vue b/test/fixtures/server-components/app/components/CounterWithNuxtClient.vue
new file mode 100644
index 000000000000..c16d3d5ada8f
--- /dev/null
+++ b/test/fixtures/server-components/app/components/CounterWithNuxtClient.vue
@@ -0,0 +1,9 @@
+
+
+ this is a normal component within a server component
+
+
diff --git a/test/fixtures/server-components/app/components/ServerInner.server.vue b/test/fixtures/server-components/app/components/ServerInner.server.vue
new file mode 100644
index 000000000000..49aedefe3734
--- /dev/null
+++ b/test/fixtures/server-components/app/components/ServerInner.server.vue
@@ -0,0 +1,8 @@
+
+
+
+
diff --git a/test/fixtures/server-components/app/components/ServerOuter.server.vue b/test/fixtures/server-components/app/components/ServerOuter.server.vue
new file mode 100644
index 000000000000..360a071597bb
--- /dev/null
+++ b/test/fixtures/server-components/app/components/ServerOuter.server.vue
@@ -0,0 +1,5 @@
+
+
+
+
diff --git a/test/fixtures/server-components/app/components/ServerOuterUniversalNested.server.vue b/test/fixtures/server-components/app/components/ServerOuterUniversalNested.server.vue
new file mode 100644
index 000000000000..89a7eb638f04
--- /dev/null
+++ b/test/fixtures/server-components/app/components/ServerOuterUniversalNested.server.vue
@@ -0,0 +1,5 @@
+
+
+
+
diff --git a/test/fixtures/server-components/app/components/ServerWithClient.server.vue b/test/fixtures/server-components/app/components/ServerWithClient.server.vue
new file mode 100644
index 000000000000..cdadf88e91ce
--- /dev/null
+++ b/test/fixtures/server-components/app/components/ServerWithClient.server.vue
@@ -0,0 +1,28 @@
+
+
+ ServerWithClient.server.vue :
+
count: {{ count }}
+
+ This component should not be preloaded
+
+
+ This is not interactive
+
+
+
+ The component below is not a slot but declared as interactive
+
+
+
+
+
diff --git a/test/fixtures/server-components/app/components/ServerWithNestedClient.server.vue b/test/fixtures/server-components/app/components/ServerWithNestedClient.server.vue
new file mode 100644
index 000000000000..3121e03eea0a
--- /dev/null
+++ b/test/fixtures/server-components/app/components/ServerWithNestedClient.server.vue
@@ -0,0 +1,5 @@
+
+
+
+
diff --git a/test/fixtures/server-components/app/components/SlotWrapper.vue b/test/fixtures/server-components/app/components/SlotWrapper.vue
new file mode 100644
index 000000000000..439a8e56bf5c
--- /dev/null
+++ b/test/fixtures/server-components/app/components/SlotWrapper.vue
@@ -0,0 +1,11 @@
+
+
+
+
+
+
+
+
diff --git a/test/fixtures/server-components/app/components/SlottedChild.vue b/test/fixtures/server-components/app/components/SlottedChild.vue
new file mode 100644
index 000000000000..60c68131bac5
--- /dev/null
+++ b/test/fixtures/server-components/app/components/SlottedChild.vue
@@ -0,0 +1,30 @@
+
diff --git a/test/fixtures/server-components/app/components/UniversalWithNuxtClient.vue b/test/fixtures/server-components/app/components/UniversalWithNuxtClient.vue
new file mode 100644
index 000000000000..14582056293a
--- /dev/null
+++ b/test/fixtures/server-components/app/components/UniversalWithNuxtClient.vue
@@ -0,0 +1,8 @@
+
+
+
+
diff --git a/test/fixtures/server-components/app/components/islands/LongAsyncComponent.vue b/test/fixtures/server-components/app/components/islands/LongAsyncComponent.vue
new file mode 100644
index 000000000000..d7c09666c0e4
--- /dev/null
+++ b/test/fixtures/server-components/app/components/islands/LongAsyncComponent.vue
@@ -0,0 +1,55 @@
+
+
+
+ count is above 2
+
+
+ {{ data }}
+
+ {{ count }}
+
+ {{ headers['custom-head'] }}
+
+
hello world !!!
+
+
+ fallback slot -- index: {{ index }}
+
+
+
+
+
+ {{ t }} slot -- index: {{ index }}
+
+
+ wonderful fallback
+
+
+
+
+
diff --git a/test/fixtures/server-components/app/components/islands/PureComponent.vue b/test/fixtures/server-components/app/components/islands/PureComponent.vue
new file mode 100644
index 000000000000..c60947f81540
--- /dev/null
+++ b/test/fixtures/server-components/app/components/islands/PureComponent.vue
@@ -0,0 +1,26 @@
+
+
+
+
+ Was router enabled: {{ hasRouter }}
+
+ Props:
+
+
+
+
+
diff --git a/test/fixtures/server-components/app/components/islands/RouteComponent.vue b/test/fixtures/server-components/app/components/islands/RouteComponent.vue
new file mode 100644
index 000000000000..a5f3defe1ab9
--- /dev/null
+++ b/test/fixtures/server-components/app/components/islands/RouteComponent.vue
@@ -0,0 +1,5 @@
+
+
+ Route: {{ $route.fullPath }}
+
+
diff --git a/test/fixtures/server-components/app/error.vue b/test/fixtures/server-components/app/error.vue
new file mode 100644
index 000000000000..3247d6dbde34
--- /dev/null
+++ b/test/fixtures/server-components/app/error.vue
@@ -0,0 +1,14 @@
+
+
+
{{ error?.message }}
+ This is the error page 😱
+
+
+
+
diff --git a/test/fixtures/server-components/app/middleware/island-auth.ts b/test/fixtures/server-components/app/middleware/island-auth.ts
new file mode 100644
index 000000000000..efb5d14da313
--- /dev/null
+++ b/test/fixtures/server-components/app/middleware/island-auth.ts
@@ -0,0 +1,4 @@
+export default defineNuxtRouteMiddleware(() => {
+ useCookie('island-auth-marker').value = 'set-from-island-middleware'
+ return navigateTo('/login', { redirectCode: 302 })
+})
diff --git a/test/fixtures/server-components/app/pages/gated-server-page.server.vue b/test/fixtures/server-components/app/pages/gated-server-page.server.vue
new file mode 100644
index 000000000000..a2736b26528a
--- /dev/null
+++ b/test/fixtures/server-components/app/pages/gated-server-page.server.vue
@@ -0,0 +1,11 @@
+
+
+ SUPER-SECRET-PAGE-ISLAND-BODY
+
+
+
+
diff --git a/test/fixtures/server-components/app/pages/index.vue b/test/fixtures/server-components/app/pages/index.vue
new file mode 100644
index 000000000000..bd7856e3e7f7
--- /dev/null
+++ b/test/fixtures/server-components/app/pages/index.vue
@@ -0,0 +1,25 @@
+
+
+
+ islands
+
+
+ to server page
+
+
+ to 404 server page
+
+
+ nested-nuxt-client
+
+
+ selective-client-slots
+
+
+
diff --git a/test/fixtures/server-components/app/pages/islands.vue b/test/fixtures/server-components/app/pages/islands.vue
new file mode 100644
index 000000000000..148675861b14
--- /dev/null
+++ b/test/fixtures/server-components/app/pages/islands.vue
@@ -0,0 +1,123 @@
+
+
+
+
+ Pure island component:
+
+
+ Increase
+
+
+ Route island component:
+
+
+
+ Show
+
+
+
async .server component
+
+
+ Slot with in .server component
+
+
+
+ Async component (1000ms):
+
+
+ Interactive testing slot
+
+
+
+
+ Slot with name test - scoped data {{ scoped }}
+
+
+
+
+ Slot with name hello - scoped data {{ scoped }}
+
+
+
+
+ add +1 to count
+
+
+
+
+
Island with props mounted client side
+
+ Show Interactive island
+
+
+
+ Interactive testing slot post SSR
+
+
+
+
+
+
+
+
diff --git a/test/fixtures/server-components/app/pages/nested-nuxt-client.vue b/test/fixtures/server-components/app/pages/nested-nuxt-client.vue
new file mode 100644
index 000000000000..e68834337b7c
--- /dev/null
+++ b/test/fixtures/server-components/app/pages/nested-nuxt-client.vue
@@ -0,0 +1,6 @@
+
+
+
+
diff --git a/test/fixtures/server-components/app/pages/page-transition-style/blue.vue b/test/fixtures/server-components/app/pages/page-transition-style/blue.vue
new file mode 100644
index 000000000000..4840b3dc74cd
--- /dev/null
+++ b/test/fixtures/server-components/app/pages/page-transition-style/blue.vue
@@ -0,0 +1,21 @@
+
+
+
+
+
blue
+
+ to red
+
+
+
diff --git a/test/fixtures/server-components/app/pages/page-transition-style/red.vue b/test/fixtures/server-components/app/pages/page-transition-style/red.vue
new file mode 100644
index 000000000000..b53d11993225
--- /dev/null
+++ b/test/fixtures/server-components/app/pages/page-transition-style/red.vue
@@ -0,0 +1,32 @@
+
+
+
+
+
red
+
+ to blue
+
+
+
+
+
diff --git a/test/fixtures/server-components/app/pages/prefetch/server-components.vue b/test/fixtures/server-components/app/pages/prefetch/server-components.vue
new file mode 100644
index 000000000000..cbb969ba4847
--- /dev/null
+++ b/test/fixtures/server-components/app/pages/prefetch/server-components.vue
@@ -0,0 +1,7 @@
+
+
+ Testing prefetching server components:
+
+
+
diff --git a/test/fixtures/server-components/app/pages/selective-client-slots.vue b/test/fixtures/server-components/app/pages/selective-client-slots.vue
new file mode 100644
index 000000000000..6922748a9643
--- /dev/null
+++ b/test/fixtures/server-components/app/pages/selective-client-slots.vue
@@ -0,0 +1,7 @@
+
+
+
+ click
+
+
+
diff --git a/test/fixtures/server-components/app/pages/server-components/lazy/end.vue b/test/fixtures/server-components/app/pages/server-components/lazy/end.vue
new file mode 100644
index 000000000000..cb92226c2bb0
--- /dev/null
+++ b/test/fixtures/server-components/app/pages/server-components/lazy/end.vue
@@ -0,0 +1,37 @@
+
+
+
+
+ End page
+
{{ mountedHTML }}
+
+
+
+ Loading server component
+
+
+
+
+
+
+
diff --git a/test/fixtures/server-components/app/pages/server-components/lazy/start.vue b/test/fixtures/server-components/app/pages/server-components/lazy/start.vue
new file mode 100644
index 000000000000..a14cf6eada33
--- /dev/null
+++ b/test/fixtures/server-components/app/pages/server-components/lazy/start.vue
@@ -0,0 +1,10 @@
+
+
+
+ Go to page with lazy server component
+
+
+ Go to page without lazy server component
+
+
+
diff --git a/test/fixtures/server-components/app/pages/server-components/lost-page.server.vue b/test/fixtures/server-components/app/pages/server-components/lost-page.server.vue
new file mode 100644
index 000000000000..c29598f3ea27
--- /dev/null
+++ b/test/fixtures/server-components/app/pages/server-components/lost-page.server.vue
@@ -0,0 +1,7 @@
+
+
+
+
+
diff --git a/test/fixtures/server-components/app/pages/server-page.server.vue b/test/fixtures/server-components/app/pages/server-page.server.vue
new file mode 100644
index 000000000000..b14956da0859
--- /dev/null
+++ b/test/fixtures/server-components/app/pages/server-page.server.vue
@@ -0,0 +1,22 @@
+
+
+ Hello this is a server page
+
+ to home
+
+
+
+
+
diff --git a/test/fixtures/server-components/app/plugins/title-template.ts b/test/fixtures/server-components/app/plugins/title-template.ts
new file mode 100644
index 000000000000..d2af428117e1
--- /dev/null
+++ b/test/fixtures/server-components/app/plugins/title-template.ts
@@ -0,0 +1,10 @@
+export default defineNuxtPlugin(() => {
+ useHead({
+ titleTemplate: '%s - Fixture',
+ style: [{
+ innerHTML: () => 'body { color: red }',
+ tagPriority: -2,
+ id: 'plugin-style',
+ }],
+ })
+})
diff --git a/test/fixtures/server-components/nuxt.config.ts b/test/fixtures/server-components/nuxt.config.ts
new file mode 100644
index 000000000000..9fc87f2afd81
--- /dev/null
+++ b/test/fixtures/server-components/nuxt.config.ts
@@ -0,0 +1,18 @@
+import { isNuxtPrepare, projectSuffix, withMatrix } from '../../matrix'
+
+export default withMatrix({
+ ...(isNuxtPrepare ? {} : { buildDir: `.nuxt-${projectSuffix}` }),
+ experimental: {
+ componentIslands: {
+ selectiveClient: 'deep',
+ },
+ runtimeBaseURL: true,
+ },
+ nitro: {
+ prerender: {
+ routes: [
+ '/prefetch/server-components',
+ ],
+ },
+ },
+})
diff --git a/test/fixtures/server-components/package.json b/test/fixtures/server-components/package.json
new file mode 100644
index 000000000000..8de686cb0ffe
--- /dev/null
+++ b/test/fixtures/server-components/package.json
@@ -0,0 +1,11 @@
+{
+ "name": "fixture-server-components",
+ "private": true,
+ "type": "module",
+ "dependencies": {
+ "nuxt": "workspace:*"
+ },
+ "engines": {
+ "node": "^22.12.0 || ^24.11.0 || >=26.0.0"
+ }
+}
diff --git a/test/fixtures/server-components/server/api/very-long-request.ts b/test/fixtures/server-components/server/api/very-long-request.ts
new file mode 100644
index 000000000000..06335797f518
--- /dev/null
+++ b/test/fixtures/server-components/server/api/very-long-request.ts
@@ -0,0 +1,9 @@
+import { defineEventHandler } from 'h3'
+
+export default defineEventHandler(async () => {
+ await timeout(20)
+ return 'that was very long ...'
+})
+function timeout (ms: number) {
+ return new Promise(resolve => setTimeout(resolve, ms))
+}
diff --git a/test/fixtures/server-components/tsconfig.json b/test/fixtures/server-components/tsconfig.json
new file mode 100644
index 000000000000..6ae5970c766b
--- /dev/null
+++ b/test/fixtures/server-components/tsconfig.json
@@ -0,0 +1,17 @@
+{
+ "files": [],
+ "references": [
+ {
+ "path": "./.nuxt/tsconfig.app.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.server.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.shared.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.node.json"
+ }
+ ]
+}
diff --git a/test/fixtures/sockets/nuxt.config.js b/test/fixtures/sockets/nuxt.config.js
deleted file mode 100644
index 0d36c2a012d3..000000000000
--- a/test/fixtures/sockets/nuxt.config.js
+++ /dev/null
@@ -1,7 +0,0 @@
-import path from 'path'
-
-export default {
- server: {
- socket: path.resolve(__dirname, 'nuxt.socket')
- }
-}
diff --git a/test/fixtures/sockets/pages/index.vue b/test/fixtures/sockets/pages/index.vue
deleted file mode 100644
index a96dbe71816c..000000000000
--- a/test/fixtures/sockets/pages/index.vue
+++ /dev/null
@@ -1,3 +0,0 @@
-
- Served over sockets!
-
diff --git a/test/fixtures/sockets/sockets.test.js b/test/fixtures/sockets/sockets.test.js
deleted file mode 100644
index c018dba3a40e..000000000000
--- a/test/fixtures/sockets/sockets.test.js
+++ /dev/null
@@ -1,5 +0,0 @@
-import { buildFixture } from '../../utils/build'
-
-describe.posix('unix socket', () => {
- buildFixture('sockets')
-})
diff --git a/test/fixtures/spa-hash/nuxt.config.js b/test/fixtures/spa-hash/nuxt.config.js
deleted file mode 100644
index 16c8423d0d3d..000000000000
--- a/test/fixtures/spa-hash/nuxt.config.js
+++ /dev/null
@@ -1,13 +0,0 @@
-import { resolve } from 'path'
-import defaultsDeep from 'lodash/defaultsDeep'
-import baseNuxtConfig from '../spa/nuxt.config'
-
-const config = {
- buildDir: resolve(__dirname, '.nuxt'),
- srcDir: resolve(__dirname, '..', 'spa'),
- router: {
- mode: 'hash'
- }
-}
-
-export default defaultsDeep(config, baseNuxtConfig)
diff --git a/test/fixtures/spa-loader/app.vue b/test/fixtures/spa-loader/app.vue
new file mode 100644
index 000000000000..2196bff7033b
--- /dev/null
+++ b/test/fixtures/spa-loader/app.vue
@@ -0,0 +1,13 @@
+
+
+
+
+ app content
+
+
diff --git a/test/fixtures/spa-loader/app/spa-loading-template.html b/test/fixtures/spa-loader/app/spa-loading-template.html
new file mode 100644
index 000000000000..b683d1e597d0
--- /dev/null
+++ b/test/fixtures/spa-loader/app/spa-loading-template.html
@@ -0,0 +1 @@
+loading...
diff --git a/test/fixtures/spa-loader/nuxt.config.ts b/test/fixtures/spa-loader/nuxt.config.ts
new file mode 100644
index 000000000000..c9fd5113aae2
--- /dev/null
+++ b/test/fixtures/spa-loader/nuxt.config.ts
@@ -0,0 +1,13 @@
+import { withMatrix } from '../../matrix'
+
+export default withMatrix({
+ devtools: { enabled: false },
+ spaLoadingTemplate: true,
+ routeRules: {
+ '/spa': { ssr: false },
+ '/ssr': { ssr: true },
+ },
+ experimental: {
+ spaLoadingTemplateLocation: 'within',
+ },
+})
diff --git a/test/fixtures/spa-loader/package.json b/test/fixtures/spa-loader/package.json
new file mode 100644
index 000000000000..3b6a5ddc7d89
--- /dev/null
+++ b/test/fixtures/spa-loader/package.json
@@ -0,0 +1,15 @@
+{
+ "name": "fixture-spa-loader",
+ "private": true,
+ "scripts": {
+ "dev": "nuxt dev",
+ "build": "nuxt build",
+ "start": "nuxt preview"
+ },
+ "dependencies": {
+ "nuxt": "workspace:*"
+ },
+ "engines": {
+ "node": "^22.12.0 || ^24.11.0 || >=26.0.0"
+ }
+}
diff --git a/test/fixtures/spa-loader/tsconfig.json b/test/fixtures/spa-loader/tsconfig.json
new file mode 100644
index 000000000000..6ae5970c766b
--- /dev/null
+++ b/test/fixtures/spa-loader/tsconfig.json
@@ -0,0 +1,17 @@
+{
+ "files": [],
+ "references": [
+ {
+ "path": "./.nuxt/tsconfig.app.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.server.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.shared.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.node.json"
+ }
+ ]
+}
diff --git a/test/fixtures/spa/layouts/custom.vue b/test/fixtures/spa/layouts/custom.vue
deleted file mode 100644
index da28a42595fd..000000000000
--- a/test/fixtures/spa/layouts/custom.vue
+++ /dev/null
@@ -1,7 +0,0 @@
-
-
- Custom layout
-
-
diff --git a/test/fixtures/spa/layouts/default.vue b/test/fixtures/spa/layouts/default.vue
deleted file mode 100644
index 0ac566cd1cf6..000000000000
--- a/test/fixtures/spa/layouts/default.vue
+++ /dev/null
@@ -1,7 +0,0 @@
-
-
- Default layout
-
-
diff --git a/test/fixtures/spa/middleware/middleware.js b/test/fixtures/spa/middleware/middleware.js
deleted file mode 100644
index 0fb38e4d0f1d..000000000000
--- a/test/fixtures/spa/middleware/middleware.js
+++ /dev/null
@@ -1,14 +0,0 @@
-
-export default function ({ route, redirect }) {
- const redirectPathRegexp = /^\/redirect(\d+)$/
- const match = route.path.match(redirectPathRegexp)
-
- if (match) {
- const number = parseInt(match[1])
- if (number === 1) {
- redirect('/redirect-done')
- } else {
- redirect(`/redirect${number - 1}`)
- }
- }
-}
diff --git a/test/fixtures/spa/nuxt.config.js b/test/fixtures/spa/nuxt.config.js
deleted file mode 100644
index b8ff9cfe9d1d..000000000000
--- a/test/fixtures/spa/nuxt.config.js
+++ /dev/null
@@ -1,37 +0,0 @@
-function modifyHtml (html) {
- return html.replace(
- '',
- ``
- )
-}
-
-export default {
- mode: 'spa',
- pageTransition: false,
- render: {
- http2: {
- push: true
- },
- bundleRenderer: {
- shouldPrefetch: () => true
- }
- },
- build: {
- filenames: {
- app: '[name].js',
- chunk: '[name].js'
- }
- },
- router: {
- middleware: 'middleware'
- },
- plugins: [
- '~/plugins/error.js',
- '~/plugins/path.js'
- ],
- hooks: {
- 'render:route': (url, page, { req, res }) => {
- page.html = modifyHtml(page.html)
- }
- }
-}
diff --git a/test/fixtures/spa/pages/async.vue b/test/fixtures/spa/pages/async.vue
deleted file mode 100644
index 53305c364823..000000000000
--- a/test/fixtures/spa/pages/async.vue
+++ /dev/null
@@ -1,20 +0,0 @@
-
-
- {{ debug }}
-
-
-
-
diff --git a/test/fixtures/spa/pages/custom.vue b/test/fixtures/spa/pages/custom.vue
deleted file mode 100644
index ae34a3420db1..000000000000
--- a/test/fixtures/spa/pages/custom.vue
+++ /dev/null
@@ -1,15 +0,0 @@
-
- Hello SPA!
-
-
-
diff --git a/test/fixtures/spa/pages/error-handler-async.vue b/test/fixtures/spa/pages/error-handler-async.vue
deleted file mode 100644
index c8ac369a40a2..000000000000
--- a/test/fixtures/spa/pages/error-handler-async.vue
+++ /dev/null
@@ -1,9 +0,0 @@
-
diff --git a/test/fixtures/spa/pages/error-handler-object.vue b/test/fixtures/spa/pages/error-handler-object.vue
deleted file mode 100644
index efcf70fc6a58..000000000000
--- a/test/fixtures/spa/pages/error-handler-object.vue
+++ /dev/null
@@ -1,8 +0,0 @@
-
diff --git a/test/fixtures/spa/pages/error-handler-string.vue b/test/fixtures/spa/pages/error-handler-string.vue
deleted file mode 100644
index fec8406e1ef2..000000000000
--- a/test/fixtures/spa/pages/error-handler-string.vue
+++ /dev/null
@@ -1,8 +0,0 @@
-
diff --git a/test/fixtures/spa/pages/error-handler.vue b/test/fixtures/spa/pages/error-handler.vue
deleted file mode 100644
index 82c8e8daaf41..000000000000
--- a/test/fixtures/spa/pages/error-handler.vue
+++ /dev/null
@@ -1,8 +0,0 @@
-
diff --git a/test/fixtures/spa/pages/index.vue b/test/fixtures/spa/pages/index.vue
deleted file mode 100644
index cb0d3ede1e61..000000000000
--- a/test/fixtures/spa/pages/index.vue
+++ /dev/null
@@ -1,12 +0,0 @@
-
- Hello SPA!
-
-
-
diff --git a/test/fixtures/spa/pages/mounted.vue b/test/fixtures/spa/pages/mounted.vue
deleted file mode 100644
index f70a0f33dbe5..000000000000
--- a/test/fixtures/spa/pages/mounted.vue
+++ /dev/null
@@ -1,20 +0,0 @@
-
- Test: {{ test.text }}
-
-
-
diff --git a/test/fixtures/spa/pages/redirect-done.vue b/test/fixtures/spa/pages/redirect-done.vue
deleted file mode 100644
index e19d25400c21..000000000000
--- a/test/fixtures/spa/pages/redirect-done.vue
+++ /dev/null
@@ -1,17 +0,0 @@
-
- Redirect Done Page
-
-
-
diff --git a/test/fixtures/spa/pages/route-path.vue b/test/fixtures/spa/pages/route-path.vue
deleted file mode 100644
index 6833eb7e57ba..000000000000
--- a/test/fixtures/spa/pages/route-path.vue
+++ /dev/null
@@ -1,3 +0,0 @@
-
- Route path: {{ $routeFullPath }}
-
diff --git "a/test/fixtures/spa/pages/\321\202\320\265\321\201\321\202\351\233\250.vue" "b/test/fixtures/spa/pages/\321\202\320\265\321\201\321\202\351\233\250.vue"
deleted file mode 100644
index c229b11037f0..000000000000
--- "a/test/fixtures/spa/pages/\321\202\320\265\321\201\321\202\351\233\250.vue"
+++ /dev/null
@@ -1,11 +0,0 @@
-
- Hello unicode SPA!
-
-
diff --git a/test/fixtures/spa/plugins/error.js b/test/fixtures/spa/plugins/error.js
deleted file mode 100644
index 5c6de6b278df..000000000000
--- a/test/fixtures/spa/plugins/error.js
+++ /dev/null
@@ -1,5 +0,0 @@
-import Vue from 'vue'
-
-Vue.config.errorHandler = function (err) {
- document.body.appendChild(document.createTextNode(`error handler triggered: ${err.message || err}`))
-}
diff --git a/test/fixtures/spa/plugins/path.js b/test/fixtures/spa/plugins/path.js
deleted file mode 100644
index 8a0d6fc1b841..000000000000
--- a/test/fixtures/spa/plugins/path.js
+++ /dev/null
@@ -1,4 +0,0 @@
-export default function ({ route }, inject) {
- // Inject route's fullPath as seen initially within the plugin.
- inject('routeFullPath', route.fullPath)
-}
diff --git a/test/fixtures/spa/spa.test.js b/test/fixtures/spa/spa.test.js
deleted file mode 100644
index 199675fcbca1..000000000000
--- a/test/fixtures/spa/spa.test.js
+++ /dev/null
@@ -1,6 +0,0 @@
-import { buildFixture } from '../../utils/build'
-
-// These two must not build concurrently to avoid changed-files check failing.
-// That's why building both from same test file.
-buildFixture('spa')
-buildFixture('spa-hash')
diff --git a/test/fixtures/ssr/components/test.vue b/test/fixtures/ssr/components/test.vue
deleted file mode 100644
index 49e7929d7366..000000000000
--- a/test/fixtures/ssr/components/test.vue
+++ /dev/null
@@ -1,15 +0,0 @@
-
- {{ id }}
-
-
-
diff --git a/test/fixtures/ssr/lib/db.js b/test/fixtures/ssr/lib/db.js
deleted file mode 100644
index 9c173807f6b0..000000000000
--- a/test/fixtures/ssr/lib/db.js
+++ /dev/null
@@ -1,4 +0,0 @@
-
-let idCtr = 0
-
-export const nextId = () => ++idCtr
diff --git a/test/fixtures/ssr/nuxt.config.js b/test/fixtures/ssr/nuxt.config.js
deleted file mode 100644
index 9deb34533cd0..000000000000
--- a/test/fixtures/ssr/nuxt.config.js
+++ /dev/null
@@ -1,8 +0,0 @@
-export default {
- render: {
- resourceHints: false,
- http2: {
- push: true
- }
- }
-}
diff --git a/test/fixtures/ssr/pages/asyncComponent.vue b/test/fixtures/ssr/pages/asyncComponent.vue
deleted file mode 100644
index 7b543950555c..000000000000
--- a/test/fixtures/ssr/pages/asyncComponent.vue
+++ /dev/null
@@ -1,15 +0,0 @@
-
-
-
-
-
diff --git a/test/fixtures/ssr/pages/asyncData.vue b/test/fixtures/ssr/pages/asyncData.vue
deleted file mode 100644
index e72e80e87d29..000000000000
--- a/test/fixtures/ssr/pages/asyncData.vue
+++ /dev/null
@@ -1,15 +0,0 @@
-
- {{ id }}
-
-
-
diff --git a/test/fixtures/ssr/pages/component.vue b/test/fixtures/ssr/pages/component.vue
deleted file mode 100644
index ce74b9c01a77..000000000000
--- a/test/fixtures/ssr/pages/component.vue
+++ /dev/null
@@ -1,15 +0,0 @@
-
-
-
-
-
-
diff --git a/test/fixtures/ssr/pages/data.vue b/test/fixtures/ssr/pages/data.vue
deleted file mode 100644
index 49e7929d7366..000000000000
--- a/test/fixtures/ssr/pages/data.vue
+++ /dev/null
@@ -1,15 +0,0 @@
-
- {{ id }}
-
-
-
diff --git a/test/fixtures/ssr/pages/fetch.vue b/test/fixtures/ssr/pages/fetch.vue
deleted file mode 100644
index e7bad18f6f01..000000000000
--- a/test/fixtures/ssr/pages/fetch.vue
+++ /dev/null
@@ -1,14 +0,0 @@
-
- {{ $store.__id }}
-
-
-
diff --git a/test/fixtures/ssr/pages/store.vue b/test/fixtures/ssr/pages/store.vue
deleted file mode 100644
index 55949dce1d95..000000000000
--- a/test/fixtures/ssr/pages/store.vue
+++ /dev/null
@@ -1,3 +0,0 @@
-
- {{ $store.state[$route.query.onServerInit === '1' ? 'id2': 'id'] }}
-
diff --git a/test/fixtures/ssr/ssr.test.js b/test/fixtures/ssr/ssr.test.js
deleted file mode 100644
index 4b3cea703600..000000000000
--- a/test/fixtures/ssr/ssr.test.js
+++ /dev/null
@@ -1,3 +0,0 @@
-import { buildFixture } from '../../utils/build'
-
-buildFixture('ssr')
diff --git a/test/fixtures/ssr/store/index.js b/test/fixtures/ssr/store/index.js
deleted file mode 100644
index 41777493920a..000000000000
--- a/test/fixtures/ssr/store/index.js
+++ /dev/null
@@ -1,23 +0,0 @@
-import { nextId } from '@/lib/db'
-
-export const state = () => {
- return {
- id: nextId(),
- id2: 0,
- idUndefined: undefined
- }
-}
-
-export const mutations = {
- setId2 (state, id) {
- state.id2 = id
- }
-}
-
-export const actions = {
- nuxtServerInit ({ commit, state }, { route }) {
- if (route.query.onServerInit === '1') {
- commit('setId2', nextId())
- }
- }
-}
diff --git a/test/fixtures/suspense-layout/app.vue b/test/fixtures/suspense-layout/app.vue
new file mode 100644
index 000000000000..f8eacfa737ec
--- /dev/null
+++ b/test/fixtures/suspense-layout/app.vue
@@ -0,0 +1,5 @@
+
+
+
+
diff --git a/test/fixtures/suspense-layout/layouts/alternate.vue b/test/fixtures/suspense-layout/layouts/alternate.vue
new file mode 100644
index 000000000000..9c4589199e4d
--- /dev/null
+++ b/test/fixtures/suspense-layout/layouts/alternate.vue
@@ -0,0 +1,5 @@
+
+
+
+
diff --git a/test/fixtures/suspense-layout/layouts/default.vue b/test/fixtures/suspense-layout/layouts/default.vue
new file mode 100644
index 000000000000..d285199f24fb
--- /dev/null
+++ b/test/fixtures/suspense-layout/layouts/default.vue
@@ -0,0 +1,6 @@
+
+
+
+
+
diff --git a/test/fixtures/suspense-layout/nuxt.config.ts b/test/fixtures/suspense-layout/nuxt.config.ts
new file mode 100644
index 000000000000..90923ae3d647
--- /dev/null
+++ b/test/fixtures/suspense-layout/nuxt.config.ts
@@ -0,0 +1,7 @@
+import { withMatrix } from '../../matrix'
+
+export default withMatrix({
+ routeRules: {
+ '/': { appLayout: 'alternate' },
+ },
+})
diff --git a/test/fixtures/suspense-layout/package.json b/test/fixtures/suspense-layout/package.json
new file mode 100644
index 000000000000..b35e53a372d8
--- /dev/null
+++ b/test/fixtures/suspense-layout/package.json
@@ -0,0 +1,16 @@
+{
+ "private": true,
+ "name": "fixture-suspense-layout",
+ "scripts": {
+ "build": "nuxt build"
+ },
+ "dependencies": {
+ "nuxt": "workspace:*"
+ },
+ "devDependencies": {
+ "typescript": "5.9.3"
+ },
+ "engines": {
+ "node": "^22.12.0 || ^24.11.0 || >=26.0.0"
+ }
+}
diff --git a/test/fixtures/suspense-layout/pages/asyncdata/[slug].vue b/test/fixtures/suspense-layout/pages/asyncdata/[slug].vue
new file mode 100644
index 000000000000..d48c05295f0d
--- /dev/null
+++ b/test/fixtures/suspense-layout/pages/asyncdata/[slug].vue
@@ -0,0 +1,31 @@
+
+
+
+
+
Async slug: {{ data?.slug }}
+
+ p1
+
+
+ p2
+
+
+ p3
+
+
diff --git a/test/fixtures/suspense-layout/pages/index.vue b/test/fixtures/suspense-layout/pages/index.vue
new file mode 100644
index 000000000000..dfad683759ab
--- /dev/null
+++ b/test/fixtures/suspense-layout/pages/index.vue
@@ -0,0 +1,19 @@
+
+
+
+ Index Page
+
+
+ Go via redirect
+
+
+ Async p0
+
+
+
diff --git a/test/fixtures/suspense-layout/pages/redirect.vue b/test/fixtures/suspense-layout/pages/redirect.vue
new file mode 100644
index 000000000000..bf96e870f48d
--- /dev/null
+++ b/test/fixtures/suspense-layout/pages/redirect.vue
@@ -0,0 +1,9 @@
+
+
+
+
+ Redirecting...
+
+
diff --git a/test/fixtures/suspense-layout/pages/target.vue b/test/fixtures/suspense-layout/pages/target.vue
new file mode 100644
index 000000000000..79e46049f21f
--- /dev/null
+++ b/test/fixtures/suspense-layout/pages/target.vue
@@ -0,0 +1,5 @@
+
+
+ Target Page
+
+
diff --git a/test/fixtures/suspense-layout/tsconfig.json b/test/fixtures/suspense-layout/tsconfig.json
new file mode 100644
index 000000000000..6ae5970c766b
--- /dev/null
+++ b/test/fixtures/suspense-layout/tsconfig.json
@@ -0,0 +1,17 @@
+{
+ "files": [],
+ "references": [
+ {
+ "path": "./.nuxt/tsconfig.app.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.server.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.shared.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.node.json"
+ }
+ ]
+}
diff --git a/test/fixtures/suspense/app.vue b/test/fixtures/suspense/app.vue
new file mode 100644
index 000000000000..879239a6e56a
--- /dev/null
+++ b/test/fixtures/suspense/app.vue
@@ -0,0 +1,89 @@
+
+
+
+
+
+
+ Project
+
+
+ Waiting
+
+
+
+
+
+
diff --git a/test/fixtures/suspense/nuxt.config.ts b/test/fixtures/suspense/nuxt.config.ts
new file mode 100644
index 000000000000..149b823507c9
--- /dev/null
+++ b/test/fixtures/suspense/nuxt.config.ts
@@ -0,0 +1,3 @@
+import { withMatrix } from '../../matrix'
+
+export default withMatrix({})
diff --git a/test/fixtures/suspense/package.json b/test/fixtures/suspense/package.json
new file mode 100644
index 000000000000..9c3e509e58c0
--- /dev/null
+++ b/test/fixtures/suspense/package.json
@@ -0,0 +1,16 @@
+{
+ "private": true,
+ "name": "fixture-suspense",
+ "scripts": {
+ "build": "nuxt build"
+ },
+ "dependencies": {
+ "nuxt": "workspace:*"
+ },
+ "devDependencies": {
+ "typescript": "5.9.3"
+ },
+ "engines": {
+ "node": "^22.12.0 || ^24.11.0 || >=26.0.0"
+ }
+}
diff --git a/test/fixtures/suspense/pages/index.vue b/test/fixtures/suspense/pages/index.vue
new file mode 100644
index 000000000000..91c3ed814b4e
--- /dev/null
+++ b/test/fixtures/suspense/pages/index.vue
@@ -0,0 +1,75 @@
+
+
+
+
+
+ Suspense Multiple Navigation Test
+
+
+
+
+ This test verifies that Nuxt's suspense functionality works correctly when rapidly navigating
+ between pages. It demonstrates that multiple rapid navigations don't cause errors or unexpected behavior.
+
+
+
+
Navigation Actions:
+
+
+
+ Target A
+
+
+ Target B
+
+
+ Setting / Project
+
+
+ Waiting (async)
+
+
+
+
+
+ Trigger (for manual testing)
+
+
+
+
Test Instructions
+
+ Click both buttons in rapid succession to verify that suspense handles
+ multiple navigations correctly. The final content should reflect the last
+ navigation (Target B).
+
+
+
diff --git a/test/fixtures/suspense/pages/setting.vue b/test/fixtures/suspense/pages/setting.vue
new file mode 100644
index 000000000000..520ecb378f9d
--- /dev/null
+++ b/test/fixtures/suspense/pages/setting.vue
@@ -0,0 +1,8 @@
+
+
+
+ Setting (level 1)
+
+
diff --git a/test/fixtures/suspense/pages/setting/project.vue b/test/fixtures/suspense/pages/setting/project.vue
new file mode 100644
index 000000000000..ab3378d817c3
--- /dev/null
+++ b/test/fixtures/suspense/pages/setting/project.vue
@@ -0,0 +1,15 @@
+
+
+
+ Project (level 2)
+
+
+ Create (level 3)
+
+
diff --git a/test/fixtures/suspense/pages/setting/project/create.vue b/test/fixtures/suspense/pages/setting/project/create.vue
new file mode 100644
index 000000000000..285ba8241944
--- /dev/null
+++ b/test/fixtures/suspense/pages/setting/project/create.vue
@@ -0,0 +1,14 @@
+
+
+
+ Create (level 3)
+
+
+ Back to Project
+
+
+
diff --git a/test/fixtures/suspense/pages/target.vue b/test/fixtures/suspense/pages/target.vue
new file mode 100644
index 000000000000..bf27a0ad50d2
--- /dev/null
+++ b/test/fixtures/suspense/pages/target.vue
@@ -0,0 +1,51 @@
+
+
+
+
+
Target Page
+
+
+
This page demonstrates async data loading with suspense.
+
+
+
Component Output:
+
+
+ Hello {{ id }}
+
+
+
+
+ Back to Home
+
+
+
+
+
+
diff --git a/test/fixtures/suspense/pages/waiting.vue b/test/fixtures/suspense/pages/waiting.vue
new file mode 100644
index 000000000000..1c7aefc71316
--- /dev/null
+++ b/test/fixtures/suspense/pages/waiting.vue
@@ -0,0 +1,13 @@
+
+
+
+
+
+ Waiting (top level, awaits in setup)
+
+
+
diff --git a/test/fixtures/suspense/tsconfig.json b/test/fixtures/suspense/tsconfig.json
new file mode 100644
index 000000000000..6ae5970c766b
--- /dev/null
+++ b/test/fixtures/suspense/tsconfig.json
@@ -0,0 +1,17 @@
+{
+ "files": [],
+ "references": [
+ {
+ "path": "./.nuxt/tsconfig.app.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.server.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.shared.json"
+ },
+ {
+ "path": "./.nuxt/tsconfig.node.json"
+ }
+ ]
+}
diff --git a/test/fixtures/unicode-base/nuxt.config.js b/test/fixtures/unicode-base/nuxt.config.js
deleted file mode 100644
index 53f0a271b970..000000000000
--- a/test/fixtures/unicode-base/nuxt.config.js
+++ /dev/null
@@ -1,43 +0,0 @@
-export default {
- modern: 'server',
- router: {
- base: '/%C3%B6/'
- },
- loading: false,
- loadingIndicator: false,
- fetch: {
- client: false,
- server: false
- },
- features: {
- store: false,
- layouts: false,
- meta: false,
- middleware: false,
- transitions: false,
- deprecations: false,
- validate: false,
- asyncData: false,
- fetch: false,
- clientOnline: false,
- clientPrefetch: false,
- clientUseUrl: true,
- componentAliases: false,
- componentClientOnly: false
- },
- build: {
- indicator: false,
- terser: true,
- optimization: {
- splitChunks: {
- cacheGroups: {
- nuxtApp: {
- test: /[\\/]\.nuxt[\\/]/,
- filename: 'vue-app.nuxt.js',
- enforce: true
- }
- }
- }
- }
- }
-}
diff --git a/test/fixtures/unicode-base/pages/index.vue b/test/fixtures/unicode-base/pages/index.vue
deleted file mode 100644
index 27507953b2c5..000000000000
--- a/test/fixtures/unicode-base/pages/index.vue
+++ /dev/null
@@ -1,3 +0,0 @@
-
- Unicode base works!
-
diff --git a/test/fixtures/unicode-base/unicode-base.test.js b/test/fixtures/unicode-base/unicode-base.test.js
deleted file mode 100644
index 68eaa70c38b3..000000000000
--- a/test/fixtures/unicode-base/unicode-base.test.js
+++ /dev/null
@@ -1,3 +0,0 @@
-import { buildFixture } from '../../utils/build'
-
-buildFixture('unicode-base')
diff --git a/test/fixtures/with-config/.nuxtignore b/test/fixtures/with-config/.nuxtignore
deleted file mode 100644
index d26f128cc3a4..000000000000
--- a/test/fixtures/with-config/.nuxtignore
+++ /dev/null
@@ -1,4 +0,0 @@
-layouts/test-ignore.vue
-pages/test-ignore.vue
-store/test-ignore.js
-middleware/test-ignore.js
diff --git a/test/fixtures/with-config/app.html b/test/fixtures/with-config/app.html
deleted file mode 100644
index 97480a711ef0..000000000000
--- a/test/fixtures/with-config/app.html
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
- {{ HEAD }}
-
-
- Made by Nuxt.js team
- {{ APP }}
-
-
diff --git a/test/fixtures/with-config/assets/app.pcss b/test/fixtures/with-config/assets/app.pcss
deleted file mode 100644
index 02152c1c08f7..000000000000
--- a/test/fixtures/with-config/assets/app.pcss
+++ /dev/null
@@ -1,10 +0,0 @@
-.global-css-selector {
- color: red;
-}
-
-.test-enter-active, .test-leave-active {
- transition: opacity .5s
-}
-.test-enter, .test-leave-active {
- opacity: 0
-}
diff --git a/test/fixtures/with-config/assets/app.sass b/test/fixtures/with-config/assets/app.sass
deleted file mode 100644
index c49f393c54bd..000000000000
--- a/test/fixtures/with-config/assets/app.sass
+++ /dev/null
@@ -1,2 +0,0 @@
-.sass-style
- color: palevioletred
diff --git a/test/fixtures/with-config/assets/pre-process.css b/test/fixtures/with-config/assets/pre-process.css
deleted file mode 100644
index 71bea2b0adc9..000000000000
--- a/test/fixtures/with-config/assets/pre-process.css
+++ /dev/null
@@ -1,3 +0,0 @@
-.pre-process-selector {
- color: red;
-}
diff --git a/test/fixtures/with-config/assets/roboto.woff2 b/test/fixtures/with-config/assets/roboto.woff2
deleted file mode 100644
index 555f98b12050..000000000000
Binary files a/test/fixtures/with-config/assets/roboto.woff2 and /dev/null differ
diff --git a/test/fixtures/with-config/components/loading.vue b/test/fixtures/with-config/components/loading.vue
deleted file mode 100644
index dd1c56d413f7..000000000000
--- a/test/fixtures/with-config/components/loading.vue
+++ /dev/null
@@ -1,36 +0,0 @@
-
-
-
-
-
-
-
diff --git a/test/fixtures/with-config/layouts/custom-env.vue b/test/fixtures/with-config/layouts/custom-env.vue
deleted file mode 100644
index 655c9a3c8d72..000000000000
--- a/test/fixtures/with-config/layouts/custom-env.vue
+++ /dev/null
@@ -1,6 +0,0 @@
-
-
-
Custom env layout
-
diff --git a/test/fixtures/with-config/layouts/custom.vue b/test/fixtures/with-config/layouts/custom.vue
deleted file mode 100644
index 962b80da74fa..000000000000
--- a/test/fixtures/with-config/layouts/custom.vue
+++ /dev/null
@@ -1,6 +0,0 @@
-
-
-
Custom layout
-
diff --git a/test/fixtures/with-config/layouts/default.vue b/test/fixtures/with-config/layouts/default.vue
deleted file mode 100644
index 25cba134cfed..000000000000
--- a/test/fixtures/with-config/layouts/default.vue
+++ /dev/null
@@ -1,6 +0,0 @@
-
-
-
Default layout
-
diff --git a/test/fixtures/with-config/layouts/desktop/default.vue b/test/fixtures/with-config/layouts/desktop/default.vue
deleted file mode 100644
index 886f28fa54df..000000000000
--- a/test/fixtures/with-config/layouts/desktop/default.vue
+++ /dev/null
@@ -1,6 +0,0 @@
-
-
-
Default desktop layout
-
diff --git a/test/fixtures/with-config/layouts/error.vue b/test/fixtures/with-config/layouts/error.vue
deleted file mode 100644
index f50245f85792..000000000000
--- a/test/fixtures/with-config/layouts/error.vue
+++ /dev/null
@@ -1,9 +0,0 @@
-
- Error page
-
-
-
diff --git a/test/fixtures/with-config/layouts/mobile/default.vue b/test/fixtures/with-config/layouts/mobile/default.vue
deleted file mode 100644
index 0426ae49b3fc..000000000000
--- a/test/fixtures/with-config/layouts/mobile/default.vue
+++ /dev/null
@@ -1,6 +0,0 @@
-
-
-
Default mobile layout
-
diff --git a/test/fixtures/with-config/layouts/test-ignore.vue b/test/fixtures/with-config/layouts/test-ignore.vue
deleted file mode 100644
index 55585a388cef..000000000000
--- a/test/fixtures/with-config/layouts/test-ignore.vue
+++ /dev/null
@@ -1 +0,0 @@
-throw new Error('This file should be ignored!!')
diff --git a/test/fixtures/with-config/middleware/noop.js b/test/fixtures/with-config/middleware/noop.js
deleted file mode 100644
index 335d554e10b1..000000000000
--- a/test/fixtures/with-config/middleware/noop.js
+++ /dev/null
@@ -1,3 +0,0 @@
-export default function () {
- // NOOP!
-}
diff --git a/test/fixtures/with-config/middleware/test-ignore.js b/test/fixtures/with-config/middleware/test-ignore.js
deleted file mode 100644
index 55585a388cef..000000000000
--- a/test/fixtures/with-config/middleware/test-ignore.js
+++ /dev/null
@@ -1 +0,0 @@
-throw new Error('This file should be ignored!!')
diff --git a/test/fixtures/with-config/middleware/user-agent.js b/test/fixtures/with-config/middleware/user-agent.js
deleted file mode 100644
index 662a76ef028b..000000000000
--- a/test/fixtures/with-config/middleware/user-agent.js
+++ /dev/null
@@ -1,3 +0,0 @@
-export default function (context) {
- context.userAgent = process.server ? context.req.headers['user-agent'] : navigator.userAgent
-}
diff --git a/test/fixtures/with-config/nuxt.config.js b/test/fixtures/with-config/nuxt.config.js
deleted file mode 100644
index d3cd57827ac3..000000000000
--- a/test/fixtures/with-config/nuxt.config.js
+++ /dev/null
@@ -1,117 +0,0 @@
-import path from 'path'
-import compression from 'compression'
-
-export default {
- mode: 'unknown',
- srcDir: __dirname,
- server: {
- port: 8000,
- host: '0.0.0.0',
- timing: {
- total: true
- }
- },
- vueMeta: {
- ssrAppId: 'test-ssr-app-id'
- },
- router: {
- base: '/test/',
- middleware: 'noop',
- scrollBehavior (to, from, savedPosition) {
- return { x: 0, y: 0 }
- },
- extendRoutes (routes) {
- return [
- ...routes,
- {
- name: 'about-bis',
- path: '/about-bis',
- component: '~/pages/about.vue',
- meta: { text: 'test-meta' }
- },
- {
- path: '/redirect/about-bis',
- redirect: '/about-bis'
- },
- {
- path: '/not-existed'
- }
- ]
- }
- },
- modulesDir: [path.join(__dirname, '..', '..', '..', 'node_modules')],
- pageTransition: 'test',
- layoutTransition: 'test',
- loadingIndicator: 'circle',
- extensions: 'ts',
- plugins: [
- '~/plugins/test',
- '~/plugins/doubled',
- { src: '~/plugins/test.plugin', mode: 'abc' },
- '~/plugins/test.client',
- '~/plugins/test.server',
- { src: '~/plugins/only-client.js', ssr: false }
- ],
- loading: '~/components/loading',
- env: {
- bool: true,
- num: 23,
- string: 'Nuxt.js',
- object: {
- bool: false,
- string: 'ok',
- num2: 8.23,
- obj: {
- again: true
- }
- }
- },
- build: {
- publicPath: '/orion/',
- cssSourceMap: true,
- parallel: true,
- analyze: {
- analyzerMode: 'disabled',
- generateStatsFile: true,
- logLevel: 'error'
- },
- styleResources: {
- css: './assets/pre-process.css'
- },
- babel: {
- presets ({ isServer }) {
- return null // Coverage: Return null, so defaults will be used.
- }
- },
- transpile: 'vue-test',
- extend (config, options) {
- return Object.assign({}, config, {
- devtool: 'source-map'
- })
- }
- },
- css: [
- '~/assets/app.pcss',
- '~/assets/app.sass'
- ],
- render: {
- csp: true,
- http2: {
- push: true,
- shouldPush: (file, type) => type === 'script'
- },
- bundleRenderer: {
- shouldPreload: (file, type) => {
- return ['script', 'style', 'font'].includes(type)
- }
- },
- compressor: function damn (...args) { return compression({ threshold: 9 })(...args) },
- static: {
- maxAge: '1y'
- }
- },
- globalName: 'noxxt',
- globals: {
- id: 'custom-nuxt-id'
- }
-}
diff --git a/test/fixtures/with-config/pages/about.vue b/test/fixtures/with-config/pages/about.vue
deleted file mode 100644
index 7df6400ba6ec..000000000000
--- a/test/fixtures/with-config/pages/about.vue
+++ /dev/null
@@ -1,18 +0,0 @@
-
-
-
About page
- {{ meta[0].text }}
-
- Home page
-
-
-
-
-
diff --git a/test/fixtures/with-config/pages/desktop.vue b/test/fixtures/with-config/pages/desktop.vue
deleted file mode 100644
index 53f8ae3b56c2..000000000000
--- a/test/fixtures/with-config/pages/desktop.vue
+++ /dev/null
@@ -1,11 +0,0 @@
-
-
-
Desktop page
-
-
-
-
diff --git a/test/fixtures/with-config/pages/env.vue b/test/fixtures/with-config/pages/env.vue
deleted file mode 100644
index 2262edb62651..000000000000
--- a/test/fixtures/with-config/pages/env.vue
+++ /dev/null
@@ -1,23 +0,0 @@
-
-
-
{{ env }}
-
object:
-
{{ processEnv }}
-
- Home
-
-
-
-
diff --git a/test/fixtures/with-config/pages/error.vue b/test/fixtures/with-config/pages/error.vue
deleted file mode 100644
index a707538cd612..000000000000
--- a/test/fixtures/with-config/pages/error.vue
+++ /dev/null
@@ -1,11 +0,0 @@
-
- Never displayed
-
-
-
diff --git a/test/fixtures/with-config/pages/head.vue b/test/fixtures/with-config/pages/head.vue
deleted file mode 100644
index 5dff57d8fac6..000000000000
--- a/test/fixtures/with-config/pages/head.vue
+++ /dev/null
@@ -1,13 +0,0 @@
-
-
-
Head page
-
-
-
-
diff --git a/test/fixtures/with-config/pages/index.vue b/test/fixtures/with-config/pages/index.vue
deleted file mode 100644
index ab862c7d7556..000000000000
--- a/test/fixtures/with-config/pages/index.vue
+++ /dev/null
@@ -1,21 +0,0 @@
-
-
-
I have custom configurations
-
- About page
-
-
-
-
-
diff --git a/test/fixtures/with-config/pages/mobile.vue b/test/fixtures/with-config/pages/mobile.vue
deleted file mode 100644
index 1d2dc17f9d26..000000000000
--- a/test/fixtures/with-config/pages/mobile.vue
+++ /dev/null
@@ -1,11 +0,0 @@
-
-
-
Mobile page
-
-
-
-
diff --git a/test/fixtures/with-config/pages/test-ignore.vue b/test/fixtures/with-config/pages/test-ignore.vue
deleted file mode 100644
index e69de29bb2d1..000000000000
diff --git a/test/fixtures/with-config/pages/user-agent.vue b/test/fixtures/with-config/pages/user-agent.vue
deleted file mode 100644
index dff65e97d898..000000000000
--- a/test/fixtures/with-config/pages/user-agent.vue
+++ /dev/null
@@ -1,12 +0,0 @@
-
- {{ userAgent }}
-
-
-
diff --git a/test/fixtures/with-config/plugins/doubled/index.js b/test/fixtures/with-config/plugins/doubled/index.js
deleted file mode 100644
index ead516c976e9..000000000000
--- a/test/fixtures/with-config/plugins/doubled/index.js
+++ /dev/null
@@ -1 +0,0 @@
-export default () => {}
diff --git a/test/fixtures/with-config/plugins/only-client.js b/test/fixtures/with-config/plugins/only-client.js
deleted file mode 100644
index ca1ce034f32d..000000000000
--- a/test/fixtures/with-config/plugins/only-client.js
+++ /dev/null
@@ -1 +0,0 @@
-// Custom plugin (only included on client-side)
diff --git a/test/fixtures/with-config/plugins/test.client.js b/test/fixtures/with-config/plugins/test.client.js
deleted file mode 100644
index 387e7fc54aa0..000000000000
--- a/test/fixtures/with-config/plugins/test.client.js
+++ /dev/null
@@ -1 +0,0 @@
-window.__test_plugin_client = 'test_plugin_client'
diff --git a/test/fixtures/with-config/plugins/test.js b/test/fixtures/with-config/plugins/test.js
deleted file mode 100644
index 1e30bfb3ca49..000000000000
--- a/test/fixtures/with-config/plugins/test.js
+++ /dev/null
@@ -1,7 +0,0 @@
-// Custom plugin
-
-if (process.client) {
- window.__test_plugin = true
-} else {
- global.__test_plugin = true
-}
diff --git a/test/fixtures/with-config/plugins/test.json b/test/fixtures/with-config/plugins/test.json
deleted file mode 100644
index e69de29bb2d1..000000000000
diff --git a/test/fixtures/with-config/plugins/test.plugin.js b/test/fixtures/with-config/plugins/test.plugin.js
deleted file mode 100644
index 9d36fa2f9730..000000000000
--- a/test/fixtures/with-config/plugins/test.plugin.js
+++ /dev/null
@@ -1,5 +0,0 @@
-if (process.client) {
- window.__test_plugin_ext = true
-} else {
- global.__test_plugin_ext = true
-}
diff --git a/test/fixtures/with-config/plugins/test.server.js b/test/fixtures/with-config/plugins/test.server.js
deleted file mode 100644
index 94df4661fa27..000000000000
--- a/test/fixtures/with-config/plugins/test.server.js
+++ /dev/null
@@ -1 +0,0 @@
-global.__test_plugin_server = 'test_plugin_server'
diff --git a/test/fixtures/with-config/postcss.config.js b/test/fixtures/with-config/postcss.config.js
deleted file mode 100644
index 6aa181edde8e..000000000000
--- a/test/fixtures/with-config/postcss.config.js
+++ /dev/null
@@ -1,14 +0,0 @@
-const path = require('path')
-const modulesDir = path.join(__dirname, '..', '..', '..', 'node_modules')
-const rootDir = __dirname
-
-module.exports = {
- plugins: {
- 'postcss-import': {
- root: rootDir,
- path: [rootDir, modulesDir]
- },
- 'postcss-url': {},
- 'postcss-preset-env': {}
- }
-}
diff --git a/test/fixtures/with-config/static/test.txt b/test/fixtures/with-config/static/test.txt
deleted file mode 100644
index 2913997fe435..000000000000
--- a/test/fixtures/with-config/static/test.txt
+++ /dev/null
@@ -1 +0,0 @@
-A test here :)
diff --git a/test/fixtures/with-config/store/index.js b/test/fixtures/with-config/store/index.js
deleted file mode 100644
index 20b0601fcf0c..000000000000
--- a/test/fixtures/with-config/store/index.js
+++ /dev/null
@@ -1,17 +0,0 @@
-import Vue from 'vue'
-import Vuex from 'vuex'
-
-Vue.use(Vuex)
-
-const store = () => new Vuex.Store({
- state: {
- counter: 0
- },
- mutations: {
- increment (state) {
- state.counter++
- }
- }
-})
-
-export default store
diff --git a/test/fixtures/with-config/store/test-ignore.js b/test/fixtures/with-config/store/test-ignore.js
deleted file mode 100644
index 55585a388cef..000000000000
--- a/test/fixtures/with-config/store/test-ignore.js
+++ /dev/null
@@ -1 +0,0 @@
-throw new Error('This file should be ignored!!')
diff --git a/test/fixtures/with-config/with-config.test.js b/test/fixtures/with-config/with-config.test.js
deleted file mode 100644
index 84652276cbff..000000000000
--- a/test/fixtures/with-config/with-config.test.js
+++ /dev/null
@@ -1,37 +0,0 @@
-import consola from 'consola'
-import { buildFixture } from '../../utils/build'
-
-beforeAll(() => {
- process.env.NUXT_ENV_FOO = 'manniL'
-})
-
-let customCompressionMiddlewareFunctionName
-const hooks = [
- ['render:errorMiddleware', (app) => {
- customCompressionMiddlewareFunctionName = app.stack[0].handle.name
- }]
-]
-
-describe('with-config', () => {
- buildFixture('with-config', () => {
- expect(consola.warn).toHaveBeenCalledTimes(7)
- expect(consola.fatal).toHaveBeenCalledTimes(0)
- expect(consola.warn.mock.calls).toMatchObject([
- ['`router.scrollBehavior` property is deprecated in favor of using `~/app/router.scrollBehavior.js` file, learn more: https://nuxtjs.org/api/configuration-router#scrollbehavior'],
- ['Unknown mode: unknown. Falling back to universal'],
- ['Invalid plugin mode (server/client/all): \'abc\'. Falling back to \'all\''],
- [{
- additional: expect.stringContaining('plugins/test.json'),
- message: 'Found 2 plugins that match the configuration, suggest to specify extension:'
- }],
- ['Please use `build.postcss` in your nuxt.config.js instead of an external config file. Support for such files will be removed in Nuxt 3 as they remove all defaults set by Nuxt and can cause severe problems with features like alias resolving inside your CSS.'],
- ['Using styleResources without the @nuxtjs/style-resources is not suggested and can lead to severe performance issues.', 'Please use https://github.com/nuxt-community/style-resources-module'],
- ['Notice: Please do not deploy bundles built with "analyze" mode, they\'re for analysis purposes only.']
- ])
- expect(customCompressionMiddlewareFunctionName).toBe('damn')
- }, hooks)
-})
-
-afterAll(() => {
- delete process.env.NUXT_ENV_FOO
-})
diff --git a/test/inline-styles.test.ts b/test/inline-styles.test.ts
new file mode 100644
index 000000000000..91d2ea99f755
--- /dev/null
+++ b/test/inline-styles.test.ts
@@ -0,0 +1,52 @@
+import { readFile } from 'node:fs/promises'
+import { fileURLToPath } from 'node:url'
+import { beforeAll, describe, expect, it } from 'vitest'
+import { exec } from 'tinyexec'
+import { join } from 'pathe'
+import { builder, isBuilt, projectSuffix } from './matrix'
+
+describe.skipIf(builder !== 'vite' || !isBuilt)('inline styles', () => {
+ const rootDir = fileURLToPath(new URL('./fixtures/inline-styles', import.meta.url))
+
+ beforeAll(async () => {
+ const result = await exec('pnpm', ['nuxt', 'generate', rootDir])
+ if (result.exitCode !== 0) {
+ throw new Error(`nuxt generate failed:\n${result.stderr}\n${result.stdout}`)
+ }
+ }, 120 * 1000)
+
+ const outputDir = join(rootDir, `.output-${projectSuffix}`)
+
+ // https://github.com/nuxt/nuxt/issues/30435
+ it.each([
+ ['/', 'index', '--inline-app-token:app', '--inline-page-index-token:index'],
+ ['/about', 'about', '--inline-app-token:app', '--inline-page-about-token:about'],
+ ])('drops duplicate stylesheet links for %s when its CSS is fully inlined', async (route, page, ...tokens) => {
+ const html = await readFile(join(outputDir, 'public', route === '/' ? 'index.html' : `${page}/index.html`), 'utf-8')
+ for (const token of tokens) {
+ expect(html, page).toContain(token)
+ }
+
+ const cssLinks = [...html.matchAll(/ still has its DOM mounted, the
+ // `useHead({ style })` entry registered by red.vue must still be present in
+ // — otherwise the leaving DIV becomes unstyled mid-animation. Sample
+ // the computed background-color across the leave window (rAF) starting from
+ // the click; before the fix unhead's debounced render fires within ~20ms of
+ // click, dropping the style and turning the bg transparent.
+ await page.evaluate(() => {
+ const w = window as unknown as { __samples?: Array<{ bg: string | null, hasLeave: boolean | null }> }
+ w.__samples = []
+ const start = performance.now()
+ const tick = () => {
+ const el = document.querySelector('.red-page')
+ w.__samples!.push({
+ bg: el ? getComputedStyle(el).backgroundColor : null,
+ hasLeave: el ? el.classList.contains('page-leave-active') : null,
+ })
+ if (performance.now() - start < 600) { requestAnimationFrame(tick) }
+ }
+ ;(document.querySelector('#to-blue') as HTMLAnchorElement).click()
+ requestAnimationFrame(tick)
+ })
+
+ await page.locator('.blue-page').waitFor()
+
+ const samples = await page.evaluate(() => (window as unknown as { __samples: Array<{ bg: string | null, hasLeave: boolean | null }> }).__samples)
+ const leaveSamples = samples.filter(s => s.hasLeave)
+ expect(leaveSamples.length).toBeGreaterThan(0)
+ expect(leaveSamples.every(s => s.bg === 'rgb(255, 0, 0)')).toBe(true)
+
+ await page.close()
+ })
+})
+
+function normaliseIslandResult (result: NuxtIslandResponse) {
+ if (result.head.style) {
+ for (const style of result.head.style) {
+ if (typeof style !== 'string') {
+ style.innerHTML &&=
+ (style.innerHTML as string)
+ .replace(/data-v-[a-z0-9]+/g, 'data-v-xxxxx')
+ // Vite 6 enables CSS minify by default for SSR
+ .replace(/blue/, '#00f')
+ style.key &&= style.key.replace(/-[a-z0-9]+$/i, '')
+ }
+ }
+ }
+ return result
+}
diff --git a/test/setup-env.ts b/test/setup-env.ts
new file mode 100644
index 000000000000..629883a27024
--- /dev/null
+++ b/test/setup-env.ts
@@ -0,0 +1,27 @@
+import { consola } from 'consola'
+import { vi } from 'vitest'
+import { logger } from '@nuxt/kit'
+
+consola.mockTypes(() => vi.fn())
+logger.mockTypes(() => vi.fn())
+
+const _warn = console.warn.bind(console)
+
+const hiddenWarns = [
+ '[@vue/reactivity-transform]',
+ '[Vue warn]: Component',
+ '[Vue router warn]',
+]
+
+console.warn = (arg0: any, ...args: any[]) => {
+ if ((typeof arg0 === 'string') && hiddenWarns.some(w => arg0.includes(w))) {
+ return
+ }
+ _warn(...args)
+}
+
+// for (const t of ['uncaughtException', 'unhandledRejection'] as const) {
+// process.on(t, (err) => {
+// console.error(`[nuxt test suite] [${t}]`, err)
+// })
+// }
diff --git a/test/setup-runtime.ts b/test/setup-runtime.ts
new file mode 100644
index 000000000000..e2c505e9df0f
--- /dev/null
+++ b/test/setup-runtime.ts
@@ -0,0 +1,7 @@
+import { vi } from 'vitest'
+
+vi.mock('#app/compat/idle-callback', () => ({
+ // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+ requestIdleCallback: (cb: Function) => cb(),
+ cancelIdleCallback: () => {},
+}))
diff --git a/test/typed-router.test.ts b/test/typed-router.test.ts
new file mode 100644
index 000000000000..8e6ca40f491b
--- /dev/null
+++ b/test/typed-router.test.ts
@@ -0,0 +1,19 @@
+import { readFileSync } from 'node:fs'
+import { resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { x } from 'tinyexec'
+import { describe, expect, it } from 'vitest'
+
+const rootDir = fileURLToPath(new URL('./fixtures/basic-types', import.meta.url))
+
+describe('typed router integration', () => {
+ it('does not duplicate params in RouteNamedMap when a child route overrides the path with an absolute path', async () => {
+ await x('nuxt', ['prepare', rootDir])
+ const typedRouterDtsFile = resolve(rootDir, '.nuxt/types/typed-router.d.ts')
+ const typedRouterDts = readFileSync(typedRouterDtsFile, 'utf8')
+ // Check for the route definition (accommodates both single-line and multi-line formatting)
+ expect(typedRouterDts).toMatch(/'param-id-view-custom':\s*RouteRecordInfo<\s*'param-id-view-custom',\s*'\/param\/:id\(\)\/view-custom',\s*\{\s*id:\s*ParamValue\s*\},\s*\{\s*id:\s*ParamValue\s*\}/)
+ // Ensure params are not duplicated
+ expect(typedRouterDts).not.toMatch(/\{\s*id:\s*ParamValue<\w+>,\s*id:\s*ParamValue<\w+>\s*\}/)
+ })
+})
diff --git a/test/utils.ts b/test/utils.ts
new file mode 100644
index 000000000000..ab78f676f24f
--- /dev/null
+++ b/test/utils.ts
@@ -0,0 +1,104 @@
+import { expect, vi } from 'vitest'
+import type { Page } from 'playwright-core'
+import { parse } from 'devalue'
+import { reactive, ref, shallowReactive, shallowRef } from 'vue'
+import { createError } from 'h3'
+import { getBrowser, url, useTestContext } from '@nuxt/test-utils/e2e'
+import { isCI } from 'std-env'
+
+export async function renderPage (path = '/', opts?: { retries?: number }) {
+ const ctx = useTestContext()
+ if (!ctx.options.browser) {
+ throw new Error('`renderPage` require `options.browser` to be set')
+ }
+
+ const browser = await getBrowser()
+ const page = await browser.newPage({})
+ const pageErrors: Error[] = []
+ const requests: string[] = []
+ const consoleLogs: { type: string, text: string }[] = []
+
+ page.on('console', (message) => {
+ consoleLogs.push({
+ type: message.type(),
+ text: message.text(),
+ })
+ })
+ page.on('pageerror', (err) => {
+ pageErrors.push(err)
+ })
+ page.on('request', (req) => {
+ try {
+ requests.push(req.url().replace(url('/'), '/'))
+ } catch {
+ // TODO
+ }
+ })
+
+ if (path) {
+ await gotoPath(page, path, opts?.retries)
+ }
+
+ return {
+ page,
+ pageErrors,
+ requests,
+ consoleLogs,
+ }
+}
+
+export async function expectNoClientErrors (path: string) {
+ const ctx = useTestContext()
+ if (!ctx.options.browser) {
+ return
+ }
+
+ const { page, pageErrors, consoleLogs } = (await renderPage(path))!
+
+ expect(pageErrors).toEqual([])
+ expectNoErrorsOrWarnings(consoleLogs)
+
+ await page.close()
+}
+
+export function expectNoErrorsOrWarnings (consoleLogs: Array<{ type: string, text: string }>) {
+ const consoleLogErrors = consoleLogs.filter(i => i.type === 'error')
+ const consoleLogWarnings = consoleLogs.filter(i => i.type === 'warning')
+
+ expect(consoleLogErrors).toEqual([])
+ expect(consoleLogWarnings).toEqual([])
+}
+
+const BASE_TIMEOUT = isCI ? 6_000 : 3_000
+export async function gotoPath (page: Page, path: string, retries = 0) {
+ await vi.waitFor(() => page.goto(url(path), { timeout: BASE_TIMEOUT }), { timeout: BASE_TIMEOUT * retries || BASE_TIMEOUT })
+ await page.waitForFunction(path => window.useNuxtApp?.()._route.fullPath === path && !window.useNuxtApp?.().isHydrating, path)
+}
+
+const revivers = {
+ NuxtError: (data: any) => createError(data),
+ EmptyShallowRef: (data: any) => shallowRef(JSON.parse(data)),
+ EmptyRef: (data: any) => ref(JSON.parse(data)),
+ ShallowRef: (data: any) => shallowRef(data),
+ ShallowReactive: (data: any) => shallowReactive(data),
+ Island: (key: any) => key,
+ Ref: (data: any) => ref(data),
+ Reactive: (data: any) => reactive(data),
+ // test fixture reviver only
+ BlinkingText: () => '',
+}
+export function parsePayload (payload: string) {
+ return parse(payload || '', revivers)
+}
+export function parseData (html: string) {
+ const regexp = / 
- 
- 
- 
- 
- 
- 
+
+
+# Nuxt
+
+
+ 
-
+Here are a few ways you can get involved:
+- **Reporting Bugs:** If you come across any bugs or issues, please check out the [reporting bugs guide](https://nuxt.com/docs/4.x/community/reporting-bugs) to learn how to submit a bug report.
+- **Suggestions:** Have ideas to enhance Nuxt? We'd love to hear them! Check out the [contribution guide](https://nuxt.com/docs/4.x/community/contribution) to share your suggestions.
+- **Questions:** If you have questions or need assistance, the [getting help guide](https://nuxt.com/docs/4.x/community/getting-help) provides resources to help you out.
-## Automated testing
+## 🏠 Local Development
-Thanks to [SauceLabs](https://saucelabs.com) for supporting Open Source <3
+Follow the docs to [Set Up Your Local Development Environment](https://nuxt.com/docs/4.x/community/framework-contribution#setup) to contribute to the framework and documentation.
-
+## 🛟 Professional Support
-## Security
+- Technical audit & consulting: [Nuxt Experts](https://nuxt.com/enterprise/support)
+- Custom development & more: [Nuxt Agencies Partners](https://nuxt.com/enterprise/agencies)
-If you discover a security vulnerability regarding Nuxt.js, please send an e-mail to the team via security@nuxtjs.org! All security vulnerabilities will be promptly addressed.
+## 🔗 Follow Us
-## License
+
+
+
+```
+
+## Assets Directory
+
+Nuxt uses [Vite](https://vite.dev/guide/assets) (default) or [webpack](https://webpack.js.org/guides/asset-management/) to build and bundle your application. The main function of these build tools is to process JavaScript files, but they can be extended through [plugins](https://vite.dev/plugins/) (for Vite) or [loaders](https://webpack.js.org/loaders/) (for webpack) to process other kinds of assets, like stylesheets, fonts or SVGs. This step transforms the original file, mainly for performance or caching purposes (such as stylesheet minification or browser cache invalidation).
+
+By convention, Nuxt uses the [`app/assets/`](/docs/4.x/directory-structure/app/assets) directory to store these files but there is no auto-scan functionality for this directory, and you can use any other name for it.
+
+In your application's code, you can reference a file located in the [`app/assets/`](/docs/4.x/directory-structure/app/assets) directory by using the `~/assets/` path.
+
+### Example
+
+For example, referencing an image file that will be processed if a build tool is configured to handle this file extension:
+
+```vue [app/app.vue]
+
+ 
+
+```
+
+::note
+Nuxt won't serve files in the [`app/assets/`](/docs/4.x/directory-structure/app/assets) directory at a static URL like `/assets/my-file.png`. If you need a static URL, use the [`public/`](/docs/4.x/getting-started/assets#public-directory) directory.
+::
diff --git a/docs/1.getting-started/06.styling.md b/docs/1.getting-started/06.styling.md
new file mode 100644
index 000000000000..24c866dbfe85
--- /dev/null
+++ b/docs/1.getting-started/06.styling.md
@@ -0,0 +1,583 @@
+---
+title: 'Styling'
+description: 'Learn how to style your Nuxt application.'
+navigation.icon: i-lucide-palette
+---
+
+Nuxt is highly flexible when it comes to styling. Write your own styles, or reference local and external stylesheets.
+You can use CSS preprocessors, CSS frameworks, UI libraries and Nuxt modules to style your application.
+
+## Local Stylesheets
+
+If you're writing local stylesheets, the natural place to put them is the [`app/assets/` directory](/docs/4.x/directory-structure/app/assets).
+
+### Importing Within Components
+
+You can import stylesheets in your pages, layouts and components directly.
+You can use a JavaScript import, or a CSS [`@import` statement](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/At-rules/@import).
+
+```vue [app/pages/index.vue]
+
+
+
+```
+
+::tip
+The stylesheets will be inlined in the HTML rendered by Nuxt.
+::
+
+### The CSS Property
+
+You can also use the `css` property in the Nuxt configuration.
+The natural place for your stylesheets is the [`app/assets/` directory](/docs/4.x/directory-structure/app/assets). You can then reference its path and Nuxt will include it to all the pages of your application.
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+ css: ['~/assets/css/main.css'],
+})
+```
+
+::tip
+The stylesheets will be inlined in the HTML rendered by Nuxt, injected globally and present in all pages.
+::
+
+### Working With Fonts
+
+Place your local fonts files in your `public/` directory, for example in `public/fonts`. You can then reference them in your stylesheets using `url()`.
+
+```css [assets/css/main.css]
+@font-face {
+ font-family: 'FarAwayGalaxy';
+ src: url('/fonts/FarAwayGalaxy.woff') format('woff');
+ font-weight: normal;
+ font-style: normal;
+ font-display: swap;
+}
+```
+
+Then reference your fonts by name in your stylesheets, pages or components:
+
+```vue
+
+```
+
+### Stylesheets Distributed Through NPM
+
+You can also reference stylesheets that are distributed through npm. Let's use the popular `animate.css` library as an example.
+
+::code-group{sync="pm"}
+
+```bash [npm]
+npm install animate.css
+```
+
+```bash [yarn]
+yarn add animate.css
+```
+
+```bash [pnpm]
+pnpm install animate.css
+```
+
+```bash [bun]
+bun install animate.css
+```
+
+```bash [deno]
+deno install npm:animate.css
+```
+
+::
+
+Then you can reference it directly in your pages, layouts and components:
+
+```vue [app/app.vue]
+
+
+
+```
+
+The package can also be referenced as a string in the css property of your Nuxt configuration.
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+ css: ['animate.css'],
+})
+```
+
+## External Stylesheets
+
+You can include external stylesheets in your application by adding a link element in the head section of your nuxt.config file. You can achieve this result using different methods. Note that local stylesheets can also be included this way.
+
+You can manipulate the head with the [`app.head`](/docs/4.x/api/nuxt-config#head) property of your Nuxt configuration:
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ app: {
+ head: {
+ link: [{ rel: 'stylesheet', href: 'https://cdnjs.cloudflare.com/ajax/libs/animate.css/4.1.1/animate.min.css' }],
+ },
+ },
+})
+```
+
+### Dynamically Adding Stylesheets
+
+You can use the useHead composable to dynamically set a value in your head in your code.
+
+:read-more{to="/docs/4.x/api/composables/use-head"}
+
+```ts twoslash
+useHead({
+ link: [{ rel: 'stylesheet', href: 'https://cdnjs.cloudflare.com/ajax/libs/animate.css/4.1.1/animate.min.css' }],
+})
+```
+
+Nuxt uses `unhead` under the hood, and you can refer to [its full documentation](https://unhead.unjs.io).
+
+### Modifying The Rendered Head With A Nitro Plugin
+
+If you need more advanced control, you can intercept the rendered html with a hook and modify the head programmatically.
+
+Create a plugin in `~~/server/plugins/my-plugin.ts` like this:
+
+
+
+```ts [server/plugins/my-plugin.ts]
+import { definePlugin } from 'nitro'
+
+export default definePlugin((nitro) => {
+ nitro.hooks.hook('render:html', (html) => {
+ html.head.push('')
+ })
+})
+```
+
+External stylesheets are render-blocking resources: they must be loaded and processed before the browser renders the page. Web pages that contain unnecessarily large styles take longer to render. You can read more about it on [web.dev](https://web.dev/articles/defer-non-critical-css).
+
+## Using Preprocessors
+
+To use a preprocessor like SCSS, Sass, Less or Stylus, install it first.
+
+::code-group
+
+```bash [Sass & SCSS]
+npm install -D sass
+```
+
+```bash [Less]
+npm install -D less
+```
+
+```bash [Stylus]
+npm install -D stylus
+```
+
+::
+
+The natural place to write your stylesheets is the `app/assets` directory.
+You can then import your source files in your `app.vue` (or layouts files) using your preprocessor's syntax.
+
+```vue [app/pages/app.vue]
+
+```
+
+Alternatively, you can use the `css` property of your Nuxt configuration.
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+ css: ['~/assets/scss/main.scss'],
+})
+```
+
+::tip
+In both cases, the compiled stylesheets will be inlined in the HTML rendered by Nuxt.
+::
+
+If you need to inject code in pre-processed files, like a [Sass partial](https://sass-lang.com/documentation/at-rules/use/#partials) with color variables, you can do so with the Vite [preprocessors options](https://vite.dev/config/shared-options#css-preprocessoroptions).
+
+Create some partials in your `app/assets` directory:
+
+::code-group{sync="preprocessor"}
+
+```scss [assets/_colors.scss]
+$primary: #49240F;
+$secondary: #E4A79D;
+```
+
+```sass [assets/_colors.sass]
+$primary: #49240F
+$secondary: #E4A79D
+```
+
+::
+
+Then in your `nuxt.config` :
+
+::code-group
+
+```ts twoslash [SCSS]
+export default defineNuxtConfig({
+ vite: {
+ css: {
+ preprocessorOptions: {
+ scss: {
+ additionalData: '@use "~/assets/_colors.scss" as *;',
+ },
+ },
+ },
+ },
+})
+```
+
+```ts twoslash [SASS]
+export default defineNuxtConfig({
+ vite: {
+ css: {
+ preprocessorOptions: {
+ sass: {
+ additionalData: '@use "~/assets/_colors.sass" as *\n',
+ },
+ },
+ },
+ },
+})
+```
+
+::
+
+Nuxt uses Vite by default. If you wish to use webpack instead, refer to each preprocessor loader [documentation](https://webpack.js.org/loaders/sass-loader/).
+
+### Preprocessor Workers (Experimental)
+
+Vite has made available an [experimental option](https://vite.dev/config/shared-options#css-preprocessormaxworkers) which can speed up using preprocessors.
+
+You can enable this in your `nuxt.config`:
+
+```ts
+export default defineNuxtConfig({
+ vite: {
+ css: {
+ preprocessorMaxWorkers: true, // number of CPUs minus 1
+ },
+ },
+})
+```
+
+::note
+This is an experimental option and you should refer to the Vite documentation and [provide feedback](https://github.com/vitejs/vite/discussions/15835).
+::
+
+## Single File Components (SFC) Styling
+
+One of the best things about Vue and SFC is how great it is at naturally dealing with styling. You can directly write CSS or preprocessor code in the style block of your components file, therefore you will have fantastic developer experience without having to use something like CSS-in-JS. However if you wish to use CSS-in-JS, you can find 3rd party libraries and modules that support it, such as [pinceau](https://github.com/Tahul/pinceau).
+
+You can refer to the [Vue docs](https://vuejs.org/api/sfc-css-features) for a comprehensive reference about styling components in SFC.
+
+### Class And Style Bindings
+
+You can leverage Vue SFC features to style your components with class and style attributes.
+
+::code-group
+
+```vue [Ref and Reactive]
+
+
+
+
+
+
+```
+
+```vue [Computed]
+
+
+
+
+
+```
+
+```vue [Array]
+
+
+
+
+
+```
+
+```vue [Style]
+
+
+
+
+
+
+
+```
+
+::
+
+Refer to the [Vue docs](https://vuejs.org/guide/essentials/class-and-style) for more information.
+
+### Dynamic Styles With `v-bind`
+
+You can reference JavaScript variable and expression within your style blocks with the v-bind function.
+The binding will be dynamic, meaning that if the variable value changes, the style will be updated.
+
+```vue
+
+
+
+