@nx/nuxt 23.0.0-beta.16 → 23.0.0-beta.17

package/migrations.json

@@ -3,7 +3,7 @@
     "update-22-2-0-create-ai-instructions-for-nuxt-4": {
       "version": "22.2.0-beta.0",
       "description": "Create AI Instructions to help migrate workspaces to Nuxt 4.",
-      "implementation": "./src/migrations/update-22-2-0/create-ai-instructions-for-nuxt-4"
+      "prompt": "./src/migrations/update-22-2-0/ai-instructions-for-nuxt-4.md"
     }
   },
   "packageJsonUpdates": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nx/nuxt",
-  "version": "23.0.0-beta.16",
+  "version": "23.0.0-beta.17",
   "private": false,
   "description": "The Nuxt plugin for Nx contains executors and generators for managing Nuxt applications and libraries within an Nx workspace. It provides:\n\n\n- Integration with libraries such as Vitest, Playwright, Cypress, and Storybook.\n\n- Generators for applications, libraries, and more.\n\n- Library build support for publishing packages to npm or other registries.\n\n- Utilities for automatic workspace refactoring.",
   "repository": {
@@ -45,16 +45,16 @@
   "dependencies": {
     "tslib": "^2.3.0",
     "@nuxt/kit": "^3.10.0 || ^4.0.0",
-    "@nx/devkit": "23.0.0-beta.16",
-    "@nx/js": "23.0.0-beta.16",
-    "@nx/eslint": "23.0.0-beta.16",
-    "@nx/vue": "23.0.0-beta.16",
-    "@nx/vite": "23.0.0-beta.16",
-    "@nx/vitest": "23.0.0-beta.16",
+    "@nx/devkit": "23.0.0-beta.17",
+    "@nx/js": "23.0.0-beta.17",
+    "@nx/eslint": "23.0.0-beta.17",
+    "@nx/vue": "23.0.0-beta.17",
+    "@nx/vite": "23.0.0-beta.17",
+    "@nx/vitest": "23.0.0-beta.17",
     "semver": "^7.6.3"
   },
   "devDependencies": {
-    "nx": "23.0.0-beta.16"
+    "nx": "23.0.0-beta.17"
   },
   "peerDependencies": {
     "@nuxt/schema": "^3.10.0 || ^4.0.0"

package/src/utils/add-linting.js

@@ -4,9 +4,8 @@ exports.addLinting = addLinting;
 const eslint_1 = require("@nx/eslint");
 const path_1 = require("nx/src/utils/path");
 const devkit_1 = require("@nx/devkit");
-const eslint_file_1 = require("@nx/eslint/src/generators/utils/eslint-file");
+const internal_1 = require("@nx/eslint/internal");
 const versions_1 = require("./versions");
-const flat_config_1 = require("@nx/eslint/src/utils/flat-config");
 async function addLinting(host, options) {
     const tasks = [];
     if (options.linter === 'eslint') {
@@ -20,7 +19,7 @@ async function addLinting(host, options) {
             addPlugin: true,
         });
         tasks.push(lintTask);
-        const isFlatConfig = (0, flat_config_1.useFlatConfig)(host);
+        const isFlatConfig = (0, internal_1.useFlatConfig)(host);
         // Version-aware dependencies:
         // - Flat config (v4+): use @nuxt/eslint-config ^1.10.0 with createConfigForNuxt
         // - Legacy (.eslintrc.json): use @nuxt/eslint-config ~0.5.6 with extends
@@ -29,7 +28,7 @@ async function addLinting(host, options) {
                 ? versions_1.nuxtEslintConfigVersion
                 : versions_1.nuxtEslintConfigLegacyVersion,
         };
-        if ((0, eslint_file_1.isEslintConfigSupported)(host, options.projectRoot)) {
+        if ((0, internal_1.isEslintConfigSupported)(host, options.projectRoot)) {
             if (isFlatConfig) {
                 // For flat config: Generate eslint.config.mjs using createConfigForNuxt
                 generateNuxtFlatEslintConfig(host, options.projectRoot);
@@ -37,9 +36,9 @@ async function addLinting(host, options) {
             else {
                 // For legacy: Use extends with the old @nuxt/eslint-config
                 editEslintConfigFiles(host, options.projectRoot);
-                const addExtendsTask = (0, eslint_file_1.addExtendsToLintConfig)(host, options.projectRoot, ['@nuxt/eslint-config'], true);
+                const addExtendsTask = (0, internal_1.addExtendsToLintConfig)(host, options.projectRoot, ['@nuxt/eslint-config'], true);
                 tasks.push(addExtendsTask);
-                (0, eslint_file_1.addIgnoresToLintConfig)(host, options.projectRoot, [
+                (0, internal_1.addIgnoresToLintConfig)(host, options.projectRoot, [
                     '.nuxt/**',
                     '.output/**',
                     'node_modules',
@@ -56,7 +55,7 @@ async function addLinting(host, options) {
  * This is the recommended approach for Nuxt v4+ and ESLint flat config.
  */
 function generateNuxtFlatEslintConfig(tree, projectRoot) {
-    const eslintFile = (0, eslint_file_1.findEslintFile)(tree, projectRoot);
+    const eslintFile = (0, internal_1.findEslintFile)(tree, projectRoot);
     if (!eslintFile)
         return;
     const configPath = (0, path_1.joinPathFragments)(projectRoot, eslintFile);
@@ -132,22 +131,22 @@ function editEslintConfigFiles(tree, projectRoot) {
             o.files = [o.files, '*.vue'];
         }
     };
-    if ((0, eslint_file_1.lintConfigHasOverride)(tree, projectRoot, (o) => o.parserOptions && !hasVueFiles(o), true)) {
-        (0, eslint_file_1.updateOverrideInLintConfig)(tree, projectRoot, (o) => !!o.parserOptions, (o) => {
+    if ((0, internal_1.lintConfigHasOverride)(tree, projectRoot, (o) => o.parserOptions && !hasVueFiles(o), true)) {
+        (0, internal_1.updateOverrideInLintConfig)(tree, projectRoot, (o) => !!o.parserOptions, (o) => {
             addVueFiles(o);
             return o;
         });
     }
     else {
-        (0, eslint_file_1.replaceOverridesInLintConfig)(tree, projectRoot, [
+        (0, internal_1.replaceOverridesInLintConfig)(tree, projectRoot, [
             {
                 files: ['*.ts', '*.tsx', '*.js', '*.jsx', '*.vue'],
                 rules: {},
             },
         ]);
     }
-    if ((0, eslint_file_1.lintConfigHasOverride)(tree, '', (o) => o.rules?.['@nx/enforce-module-boundaries'] && !hasVueFiles(o), true)) {
-        (0, eslint_file_1.updateOverrideInLintConfig)(tree, '', (o) => !!o.rules?.['@nx/enforce-module-boundaries'], (o) => {
+    if ((0, internal_1.lintConfigHasOverride)(tree, '', (o) => o.rules?.['@nx/enforce-module-boundaries'] && !hasVueFiles(o), true)) {
+        (0, internal_1.updateOverrideInLintConfig)(tree, '', (o) => !!o.rules?.['@nx/enforce-module-boundaries'], (o) => {
             addVueFiles(o);
             return o;
         });

package/src/migrations/update-18-1-0/add-include-tsconfig.d.ts

@@ -1,3 +0,0 @@
-import { Tree } from '@nx/devkit';
-export default function (tree: Tree): Promise<void>;
-//# sourceMappingURL=add-include-tsconfig.d.ts.map

package/src/migrations/update-18-1-0/add-include-tsconfig.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"add-include-tsconfig.d.ts","sourceRoot":"","sources":["../../../../../../packages/nuxt/src/migrations/update-18-1-0/add-include-tsconfig.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EAML,MAAM,YAAY,CAAC;AAIpB,yBAA+B,IAAI,EAAE,IAAI,iBAmCxC"}

package/src/migrations/update-18-1-0/add-include-tsconfig.js

@@ -1,48 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = default_1;
-const devkit_1 = require("@nx/devkit");
-const executor_utils_1 = require("../../utils/executor-utils");
-const path_1 = require("path");
-async function default_1(tree) {
-    const projects = (0, devkit_1.getProjects)(tree);
-    for (const project of projects.values()) {
-        const nuxtConfigPath = findNuxtConfig(tree, project.root);
-        if (!nuxtConfigPath) {
-            continue;
-        }
-        const nuxtConfig = await getInfoFromNuxtConfig(nuxtConfigPath, project.root);
-        const buildDir = nuxtConfig.buildDir ?? '.nuxt';
-        const tsConfigPath = (0, devkit_1.joinPathFragments)(project.root, 'tsconfig.json');
-        if (tree.exists(tsConfigPath)) {
-            (0, devkit_1.updateJson)(tree, tsConfigPath, (json) => {
-                if (!json.include) {
-                    json.include = [];
-                }
-                if (!json.include.includes(buildDir + '/nuxt.d.ts')) {
-                    json.include.push(buildDir + '/nuxt.d.ts');
-                }
-                return json;
-            });
-        }
-    }
-    await (0, devkit_1.formatFiles)(tree);
-}
-function findNuxtConfig(tree, projectRoot) {
-    const allowsExt = ['js', 'mjs', 'ts', 'cjs', 'mts', 'cts'];
-    for (const ext of allowsExt) {
-        if (tree.exists((0, devkit_1.joinPathFragments)(projectRoot, `nuxt.config.${ext}`))) {
-            return (0, devkit_1.joinPathFragments)(projectRoot, `nuxt.config.${ext}`);
-        }
-    }
-}
-async function getInfoFromNuxtConfig(configFilePath, projectRoot) {
-    const { loadNuxtConfig } = await (0, executor_utils_1.loadNuxtKitDynamicImport)();
-    const config = await loadNuxtConfig({
-        cwd: (0, devkit_1.joinPathFragments)(devkit_1.workspaceRoot, projectRoot),
-        configFile: (0, path_1.basename)(configFilePath),
-    });
-    return {
-        buildDir: config?.buildDir,
-    };
-}

package/src/migrations/update-22-2-0/create-ai-instructions-for-nuxt-4.d.ts

@@ -1,3 +0,0 @@
-import { Tree } from '@nx/devkit';
-export default function createAiInstructionsForNuxt(tree: Tree): Promise<string[]>;
-//# sourceMappingURL=create-ai-instructions-for-nuxt-4.d.ts.map

package/src/migrations/update-22-2-0/create-ai-instructions-for-nuxt-4.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"create-ai-instructions-for-nuxt-4.d.ts","sourceRoot":"","sources":["../../../../../../packages/nuxt/src/migrations/update-22-2-0/create-ai-instructions-for-nuxt-4.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAElC,wBAA8B,2BAA2B,CAAC,IAAI,EAAE,IAAI,qBAenE"}

package/src/migrations/update-22-2-0/create-ai-instructions-for-nuxt-4.js

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = createAiInstructionsForNuxt;
-const path_1 = require("path");
-const fs_1 = require("fs");
-async function createAiInstructionsForNuxt(tree) {
-    const pathToAiInstructions = (0, path_1.join)(__dirname, 'files', 'ai-instructions-for-nuxt-4.md');
-    if (!(0, fs_1.existsSync)(pathToAiInstructions)) {
-        return;
-    }
-    const contents = (0, fs_1.readFileSync)(pathToAiInstructions);
-    tree.write('tools/ai-migrations/MIGRATE_NUXT_4.md', contents);
-    return [
-        `We created 'tools/ai-migrations/MIGRATE_NUXT_4.md' with instructions for an AI Agent to help migrate your Nuxt projects to Nuxt 4.`,
-    ];
-}

package/src/migrations/update-22-2-0/files/ai-instructions-for-nuxt-4.md

@@ -1,531 +0,0 @@
-# Nuxt 3 to Nuxt 4 Migration Instructions
-
-This document provides instructions for an AI Agent to assist with migrating Nuxt 3 projects to Nuxt 4.
-
-## Pre-Migration Checklist
-
-Before starting the migration, run these commands to understand the scope:
-
-```bash
-# List all Nuxt projects in the workspace
-nx show projects --with-target build | xargs -I {} sh -c 'cat {}/nuxt.config.ts 2>/dev/null && echo "Project: {}"' | grep -B1 "Project:"
-
-# Find all files that may need updates
-find . -name "*.vue" -o -name "*.ts" | head -50
-```
-
----
-
-## Section 1: Configuration Updates
-
-### 1.1 Directory Structure (Optional but Recommended)
-
-**Search Pattern**: Check `nuxt.config.ts` for `srcDir` configuration
-
-Nuxt 4 introduces a new default directory structure using `app/` instead of `src/`.
-
-**If adopting new structure:**
-
-```typescript
-// Before (Nuxt 3 with srcDir)
-export default defineNuxtConfig({
-  srcDir: 'src',
-});
-
-// After (Nuxt 4 - remove srcDir, move files to app/)
-export default defineNuxtConfig({
-  // srcDir removed - app/ is now the default
-});
-```
-
-**Action Items:**
-
-- [ ] Move `src/` contents to `app/` directory
-- [ ] Keep `server/`, `public/`, `layers/`, `modules/` at project root
-- [ ] Remove `srcDir` from `nuxt.config.ts`
-
-**OR to keep existing structure:**
-
-```typescript
-export default defineNuxtConfig({
-  srcDir: '.',
-  dir: { app: 'app' },
-});
-```
-
-### 1.2 Remove Deprecated `generate` Configuration
-
-**Search Pattern**: `grep -r "generate:" --include="nuxt.config.ts"`
-
-```typescript
-// Before
-export default defineNuxtConfig({
-  generate: {
-    exclude: ['/admin'],
-    routes: ['/sitemap.xml'],
-  },
-});
-
-// After
-export default defineNuxtConfig({
-  nitro: {
-    prerender: {
-      ignore: ['/admin'],
-      routes: ['/sitemap.xml'],
-    },
-  },
-});
-```
-
-### 1.3 TypeScript Configuration
-
-**Search Pattern**: Check `tsconfig.json` files
-
-Nuxt 4 sets `noUncheckedIndexedAccess: true` by default.
-
-**To override if needed:**
-
-```typescript
-export default defineNuxtConfig({
-  typescript: {
-    tsConfig: {
-      compilerOptions: {
-        noUncheckedIndexedAccess: false,
-      },
-    },
-  },
-});
-```
-
----
-
-## Section 2: Data Fetching Updates
-
-### 2.1 Default Values Changed from `null` to `undefined`
-
-**Search Pattern**: `grep -rn "!== null\|=== null" --include="*.vue" --include="*.ts"`
-
-```typescript
-// Before (Nuxt 3)
-const { data } = await useAsyncData('key', () => fetch('/api/data'));
-if (data.value !== null) {
-  /* ... */
-}
-
-// After (Nuxt 4)
-const { data } = await useAsyncData('key', () => fetch('/api/data'));
-if (data.value !== undefined) {
-  /* ... */
-}
-```
-
-**Automation available:**
-
-```bash
-npx codemod@latest nuxt/4/default-data-error-value
-```
-
-### 2.2 `getCachedData` Context Parameter
-
-**Search Pattern**: `grep -rn "getCachedData" --include="*.vue" --include="*.ts"`
-
-```typescript
-// Before
-getCachedData: (key, nuxtApp) => cachedData[key];
-
-// After
-getCachedData: (key, nuxtApp, ctx) => {
-  // ctx.cause: 'initial' | 'refresh:hook' | 'refresh:manual' | 'watch'
-  if (ctx.cause === 'refresh:manual') return undefined;
-  return cachedData[key];
-};
-```
-
-### 2.3 Shallow Data Reactivity
-
-**Search Pattern**: `grep -rn "useAsyncData\|useFetch" --include="*.vue" --include="*.ts"`
-
-Data from `useAsyncData`/`useFetch` is now `shallowRef` (not deep reactive).
-
-```typescript
-// If deep reactivity is needed:
-const { data } = useFetch('/api/test', { deep: true });
-```
-
-**Automation available:**
-
-```bash
-npx codemod@latest nuxt/4/shallow-function-reactivity
-```
-
-### 2.4 Removed `dedupe` Boolean Values
-
-**Search Pattern**: `grep -rn "dedupe: true\|dedupe: false" --include="*.vue" --include="*.ts"`
-
-```typescript
-// Before
-refresh({ dedupe: true });
-refresh({ dedupe: false });
-
-// After
-refresh({ dedupe: 'cancel' });
-refresh({ dedupe: 'defer' });
-```
-
-**Automation available:**
-
-```bash
-npx codemod@latest nuxt/4/deprecated-dedupe-value
-```
-
-### 2.5 Unique Keys for Shared Prerender Data
-
-**Search Pattern**: Check dynamic route files `[*.vue` in `pages/`
-
-```typescript
-// Before (unsafe for dynamic routes)
-const { data } = await useAsyncData(async () =>
-  $fetch(`/api/page/${route.params.slug}`)
-);
-
-// After (safe - key includes slug)
-const { data } = await useAsyncData(route.params.slug, async () =>
-  $fetch(`/api/page/${route.params.slug}`)
-);
-```
-
----
-
-## Section 3: Unhead v2 Migration
-
-### 3.1 Remove Deprecated Props
-
-**Search Pattern**: `grep -rn "hid:\|vmid:\|children:\|body:" --include="*.vue" --include="*.ts"`
-
-```typescript
-// Before
-useHead({
-  meta: [{ name: 'description', hid: 'description', content: 'My page' }],
-  script: [{ children: 'console.log("hello")' }],
-});
-
-// After
-useHead({
-  meta: [{ name: 'description', content: 'My page' }],
-  script: [{ innerHTML: 'console.log("hello")' }],
-});
-```
-
----
-
-## Section 4: Component and Routing Changes
-
-### 4.1 Normalized Component Names
-
-**Search Pattern**: Check test files using `findComponent` and templates with `<KeepAlive>`
-
-```typescript
-// Component in SomeFolder/MyComponent.vue
-// Before: findComponent({ name: 'MyComponent' })
-// After: findComponent({ name: 'SomeFolderMyComponent' })
-```
-
-**To disable if needed:**
-
-```typescript
-export default defineNuxtConfig({
-  experimental: {
-    normalizeComponentNames: false,
-  },
-});
-```
-
-### 4.2 Route Metadata Deduplication
-
-**Search Pattern**: `grep -rn "route.meta.name\|route.meta.path" --include="*.vue" --include="*.ts"`
-
-```typescript
-// Before
-const name = route.meta.name;
-
-// After
-const name = route.name;
-```
-
----
-
-## Section 5: Removed Experimental Flags
-
-These flags are now hardcoded and cannot be configured:
-
-- `experimental.treeshakeClientOnly` → always `true`
-- `experimental.configSchema` → always `true`
-- `experimental.polyfillVueUseHead` → always `false`
-- `experimental.respectNoSSRHeader` → always `false`
-
-**Action Items:**
-
-- [ ] Remove these from `nuxt.config.ts` if present
-
----
-
-## Section 6: Error Handling
-
-### 6.1 Parsed `error.data`
-
-**Search Pattern**: `grep -rn "JSON.parse.*error.data\|error.data.*JSON.parse" --include="*.vue" --include="*.ts"`
-
-```typescript
-// Before
-const data = JSON.parse(error.data);
-
-// After (data is already parsed)
-const data = error.data;
-```
-
----
-
-## Section 7: Module and Build Changes
-
-### 7.1 Absolute Watch Paths in `builder:watch`
-
-**Search Pattern**: Check custom modules using `builder:watch` hook
-
-```typescript
-import { relative, resolve } from 'node:fs';
-
-nuxt.hook('builder:watch', async (event, path) => {
-  // Convert to relative path for backward/forward compatibility
-  path = relative(nuxt.options.srcDir, resolve(nuxt.options.srcDir, path));
-});
-```
-
-### 7.2 Template Compilation Changes
-
-**Search Pattern**: Check modules using `addTemplate` with EJS syntax
-
-```typescript
-// Before (using lodash template)
-addTemplate({
-  fileName: 'plugin.js',
-  src: './runtime/plugin.ejs',
-});
-
-// After (using getContents)
-import { template } from 'es-toolkit/compat';
-
-addTemplate({
-  fileName: 'plugin.js',
-  getContents({ options }) {
-    const contents = readFileSync('./runtime/plugin.ejs', 'utf-8');
-    return template(contents)({ options });
-  },
-});
-```
-
----
-
-## Section 8: ESLint Configuration (Flat Config Only)
-
-> **Note:** This section only applies if your workspace uses ESLint flat config (`eslint.config.js`, `eslint.config.mjs`, or `eslint.config.cjs`). If you're using legacy `.eslintrc.json`, no changes are required.
-
-### 8.1 Migrate to `createConfigForNuxt`
-
-**Search Pattern**: Check for `eslint.config.js`, `eslint.config.mjs`, or `eslint.config.cjs` in Nuxt project directories
-
-For workspaces using ESLint flat config, Nuxt 4 requires updating to `@nuxt/eslint-config` version `^1.10.0` and using `createConfigForNuxt` from `@nuxt/eslint-config/flat`.
-
-**Before (Nuxt 3 flat config):**
-
-```javascript
-import baseConfig from '../../eslint.config.mjs';
-
-export default [
-  ...baseConfig,
-  {
-    files: ['**/*.vue'],
-    languageOptions: {
-      parserOptions: { parser: '@typescript-eslint/parser' },
-    },
-  },
-  {
-    ignores: ['.nuxt/**', '.output/**', 'node_modules'],
-  },
-];
-```
-
-**After (Nuxt 4 flat config - eslint.config.mjs):**
-
-```javascript
-import { createConfigForNuxt } from '@nuxt/eslint-config/flat';
-import baseConfig from '../../eslint.config.mjs';
-
-export default createConfigForNuxt({
-  features: {
-    typescript: true,
-  },
-})
-  .prepend(...baseConfig)
-  .append(
-    {
-      files: ['**/*.ts', '**/*.tsx', '**/*.js', '**/*.jsx', '**/*.vue'],
-      rules: {},
-    },
-    {
-      ignores: ['.nuxt/**', '.output/**', 'node_modules'],
-    }
-  );
-```
-
-**For CJS (eslint.config.cjs):**
-
-```javascript
-const { createConfigForNuxt } = require('@nuxt/eslint-config/flat');
-const baseConfig = require('../../eslint.config.cjs');
-
-module.exports = createConfigForNuxt({
-  features: {
-    typescript: true,
-  },
-})
-  .prepend(...baseConfig)
-  .append(
-    {
-      files: ['**/*.ts', '**/*.tsx', '**/*.js', '**/*.jsx', '**/*.vue'],
-      rules: {},
-    },
-    {
-      ignores: ['.nuxt/**', '.output/**', 'node_modules'],
-    }
-  );
-```
-
-**Action Items (Flat Config Only):**
-
-- [ ] Update `@nuxt/eslint-config` to `^1.10.0` in `package.json`
-- [ ] Replace manual Vue/TypeScript parser config with `createConfigForNuxt`
-- [ ] Use `features.typescript: true` option for TypeScript support
-- [ ] Remove `@typescript-eslint/parser` from devDependencies (handled automatically)
-- [ ] Use `.prepend()` for base configs and `.append()` for project-specific rules/ignores
-
-### 8.2 Understanding the New Config Structure
-
-The `createConfigForNuxt` function returns a chainable config builder:
-
-- **`features.typescript: true`** - Enables TypeScript support with proper Vue file parsing
-- **`.prepend(...configs)`** - Adds configs at the beginning (useful for workspace base configs)
-- **`.append(...configs)`** - Adds configs at the end (for project-specific rules and ignores)
-
----
-
-## Post-Migration Validation
-
-After completing the migration, run these commands:
-
-```bash
-# 1. Install updated dependencies
-npm install
-
-# 2. Run Nuxt prepare
-npx nuxi prepare
-
-# 3. Type check
-npx nuxi typecheck
-
-# 4. Build the application
-nx build <project-name>
-
-# 5. Run tests
-nx test <project-name>
-
-# 6. Start dev server to verify
-nx serve <project-name>
-```
-
----
-
-## Quick Migration Commands
-
-Nuxt provides codemods to automate many changes:
-
-```bash
-# Run the full migration recipe
-npx codemod@0.18.7 nuxt/4/migration-recipe
-
-# Or run individual codemods:
-npx codemod@latest nuxt/4/file-structure
-npx codemod@latest nuxt/4/default-data-error-value
-npx codemod@latest nuxt/4/shallow-function-reactivity
-npx codemod@latest nuxt/4/deprecated-dedupe-value
-npx codemod@latest nuxt/4/template-compilation-changes
-npx codemod@latest nuxt/4/absolute-watch-path
-```
-
----
-
-## Common Issues and Solutions
-
-### Issue: White flash on initial load
-
-**Solution:** This is expected behavior - SPA loading template now renders outside `#__nuxt`. To revert:
-
-```typescript
-experimental: {
-  spaLoadingTemplateLocation: 'within';
-}
-```
-
-### Issue: Global CSS not inlined
-
-**Solution:** Only component CSS is inlined by default. To inline all CSS:
-
-```typescript
-features: {
-  inlineStyles: true;
-}
-```
-
-### Issue: Middleware index files being registered
-
-**Solution:** Filter unwanted middleware:
-
-```typescript
-hooks: {
-  'app:resolve'(app) {
-    app.middleware = app.middleware.filter(mw => !/\/index\.[^/]+$/.test(mw.path))
-  }
-}
-```
-
----
-
-## Files to Review
-
-```bash
-# Find all Vue files
-find . -name "*.vue" -not -path "./node_modules/*"
-
-# Find all nuxt config files
-find . -name "nuxt.config.*" -not -path "./node_modules/*"
-
-# Find composables using data fetching
-grep -rn "useAsyncData\|useFetch\|getCachedData" --include="*.vue" --include="*.ts" | grep -v node_modules
-```
-
----
-
-## Notes for AI Agent
-
-1. **Work systematically** through each section
-2. **Run codemods first** where available, then manually fix remaining issues
-3. **Test incrementally** - run `nx build` and `nx test` after each major change
-4. **Document changes** as you make them for user review
-5. **Handle errors gracefully** - if a file doesn't exist or a pattern isn't found, continue to the next item
-
----
-
-## References
-
-- [Official Nuxt 4 Upgrade Guide](https://nuxt.com/docs/4.x/getting-started/upgrade)
-- [Nuxt 4 Announcement Blog](https://nuxt.com/blog/v4)
-- [Nuxt GitHub Repository](https://github.com/nuxt/nuxt)