@nx/nuxt 23.0.0-beta.23 → 23.0.0-beta.24

package/migrations.json

@@ -4,6 +4,12 @@
       "version": "22.2.0-beta.0",
       "description": "Create AI Instructions to help migrate workspaces to Nuxt 4.",
       "prompt": "./src/migrations/update-22-2-0/ai-instructions-for-nuxt-4.md"
+    },
+    "update-23-0-0-migrate-create-nodes-v2-import": {
+      "version": "23.0.0-beta.24",
+      "description": "Rename imports of `createNodesV2` from `@nx/nuxt/plugin` to the canonical `createNodes` export.",
+      "implementation": "./dist/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes",
+      "documentation": "./dist/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes.md"
     }
   },
   "packageJsonUpdates": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nx/nuxt",
-  "version": "23.0.0-beta.23",
+  "version": "23.0.0-beta.24",
   "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": {
@@ -44,16 +44,16 @@
   },
   "dependencies": {
     "tslib": "^2.3.0",
-    "@nx/devkit": "23.0.0-beta.23",
-    "@nx/js": "23.0.0-beta.23",
-    "@nx/eslint": "23.0.0-beta.23",
-    "@nx/vue": "23.0.0-beta.23",
-    "@nx/vite": "23.0.0-beta.23",
-    "@nx/vitest": "23.0.0-beta.23",
+    "@nx/devkit": "23.0.0-beta.24",
+    "@nx/js": "23.0.0-beta.24",
+    "@nx/eslint": "23.0.0-beta.24",
+    "@nx/vue": "23.0.0-beta.24",
+    "@nx/vite": "23.0.0-beta.24",
+    "@nx/vitest": "23.0.0-beta.24",
     "semver": "^7.6.3"
   },
   "devDependencies": {
-    "nx": "23.0.0-beta.23"
+    "nx": "23.0.0-beta.24"
   },
   "peerDependencies": {
     "nuxt": ">=3.0.0 <5.0.0",

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

@@ -0,0 +1,531 @@
+# 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)

package/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes.d.ts

@@ -0,0 +1,10 @@
+import { type Tree } from '@nx/devkit';
+export default function migrateCreateNodesV2ToCreateNodes(tree: Tree): Promise<void>;
+/**
+ * Rewrites named imports and re-exports of `createNodesV2` to `createNodes`
+ * when they come from one of the given module specifiers. Only the named
+ * bindings are touched — the module specifier, the `import`/`export` keyword,
+ * any `type` modifier, and any default import are left untouched.
+ */
+export declare function rewriteCreateNodesV2Imports(source: string, specifiers: ReadonlySet<string>): string;
+//# sourceMappingURL=migrate-create-nodes-v2-to-create-nodes.d.ts.map

package/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-create-nodes-v2-to-create-nodes.d.ts","sourceRoot":"","sources":["../../../../../../packages/nuxt/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,IAAI,EAEV,MAAM,YAAY,CAAC;AAsBpB,wBAA8B,iCAAiC,CAC7D,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,IAAI,CAAC,CAyBf;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,GAC9B,MAAM,CAoBR"}

package/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = migrateCreateNodesV2ToCreateNodes;
+exports.rewriteCreateNodesV2Imports = rewriteCreateNodesV2Imports;
+const devkit_1 = require("@nx/devkit");
+const TS_EXTENSIONS = ['.ts', '.tsx', '.cts', '.mts'];
+const DEPRECATED_NAME = 'createNodesV2';
+const CANONICAL_NAME = 'createNodes';
+// Module specifiers from which `@nx/nuxt` publicly exposes `createNodesV2`.
+// A named import or re-export of `createNodesV2` from one of these is rewritten
+// to the canonical `createNodes` export.
+const TARGET_SPECIFIERS = new Set(['@nx/nuxt/plugin']);
+let ts;
+async function migrateCreateNodesV2ToCreateNodes(tree) {
+    let touchedCount = 0;
+    (0, devkit_1.visitNotIgnoredFiles)(tree, '.', (filePath) => {
+        if (!TS_EXTENSIONS.some((ext) => filePath.endsWith(ext))) {
+            return;
+        }
+        const original = tree.read(filePath, 'utf-8');
+        if (!original || !original.includes(DEPRECATED_NAME)) {
+            return;
+        }
+        const updated = rewriteCreateNodesV2Imports(original, TARGET_SPECIFIERS);
+        if (updated !== original) {
+            tree.write(filePath, updated);
+            touchedCount += 1;
+        }
+    });
+    if (touchedCount > 0) {
+        devkit_1.logger.info(`Renamed \`${DEPRECATED_NAME}\` imports to \`${CANONICAL_NAME}\` in ${touchedCount} file(s).`);
+    }
+    await (0, devkit_1.formatFiles)(tree);
+}
+/**
+ * Rewrites named imports and re-exports of `createNodesV2` to `createNodes`
+ * when they come from one of the given module specifiers. Only the named
+ * bindings are touched — the module specifier, the `import`/`export` keyword,
+ * any `type` modifier, and any default import are left untouched.
+ */
+function rewriteCreateNodesV2Imports(source, specifiers) {
+    ts ??= (0, devkit_1.ensurePackage)('typescript', '*');
+    const sourceFile = ts.createSourceFile('tmp.ts', source, ts.ScriptTarget.Latest, 
+    /* setParentNodes */ true, ts.ScriptKind.TSX);
+    const changes = [];
+    for (const stmt of sourceFile.statements) {
+        if (ts.isImportDeclaration(stmt)) {
+            collectImportRewrite(sourceFile, stmt, specifiers, changes);
+        }
+        else if (ts.isExportDeclaration(stmt)) {
+            collectExportRewrite(sourceFile, stmt, specifiers, changes);
+        }
+    }
+    return changes.length > 0 ? (0, devkit_1.applyChangesToString)(source, changes) : source;
+}
+function isTargetSpecifier(node, specifiers) {
+    return ts.isStringLiteral(node) && specifiers.has(node.text);
+}
+function collectImportRewrite(sourceFile, stmt, specifiers, changes) {
+    if (!isTargetSpecifier(stmt.moduleSpecifier, specifiers)) {
+        return;
+    }
+    const namedBindings = stmt.importClause?.namedBindings;
+    // Only `import { ... }` carries renameable named bindings. `import x`,
+    // `import * as ns`, and side-effect imports reference the module wholesale
+    // and keep working through the `createNodesV2` runtime alias, so we leave
+    // them be. A mixed `import def, { createNodesV2 }` still has its named
+    // bindings rewritten below — the default binding is untouched.
+    if (!namedBindings || !ts.isNamedImports(namedBindings)) {
+        return;
+    }
+    rewriteNamedBindings(sourceFile, namedBindings, changes);
+}
+function collectExportRewrite(sourceFile, stmt, specifiers, changes) {
+    if (!stmt.moduleSpecifier ||
+        !isTargetSpecifier(stmt.moduleSpecifier, specifiers)) {
+        return;
+    }
+    // `export { ... } from '...'` can be rewritten; `export * from '...'` has no
+    // named bindings to rename.
+    if (!stmt.exportClause || !ts.isNamedExports(stmt.exportClause)) {
+        return;
+    }
+    rewriteNamedBindings(sourceFile, stmt.exportClause, changes);
+}
+/**
+ * Re-renders the `{ ... }` of a named import/export, renaming any
+ * `createNodesV2` specifier to `createNodes`. If renaming would collide with a
+ * `createNodes` that is already present (e.g. `{ createNodes, createNodesV2 }`),
+ * the duplicate is dropped. Returns without recording a change when the binding
+ * list contains no `createNodesV2`.
+ */
+function rewriteNamedBindings(sourceFile, namedBindings, changes) {
+    const elements = namedBindings.elements;
+    const hasDeprecated = elements.some((el) => (el.propertyName ?? el.name).text === DEPRECATED_NAME);
+    if (!hasDeprecated) {
+        return;
+    }
+    const seen = new Set();
+    const rendered = [];
+    for (const el of elements) {
+        const text = renderSpecifier(el);
+        if (!seen.has(text)) {
+            seen.add(text);
+            rendered.push(text);
+        }
+    }
+    const start = namedBindings.getStart(sourceFile);
+    changes.push({
+        type: devkit_1.ChangeType.Delete,
+        start,
+        length: namedBindings.getEnd() - start,
+    }, {
+        type: devkit_1.ChangeType.Insert,
+        index: start,
+        text: `{ ${rendered.join(', ')} }`,
+    });
+}
+function renderSpecifier(el) {
+    const typePrefix = el.isTypeOnly ? 'type ' : '';
+    const rename = (name) => name === DEPRECATED_NAME ? CANONICAL_NAME : name;
+    // `{ name }` — no alias, so the local binding follows the rename.
+    if (!el.propertyName) {
+        return `${typePrefix}${rename(el.name.text)}`;
+    }
+    // `{ propertyName as name }` — only the imported (left) side is renamed; the
+    // local alias is preserved. A now-redundant alias such as
+    // `createNodesV2 as createNodes` collapses to `createNodes`.
+    const canonicalImported = rename(el.propertyName.text);
+    const localName = el.name.text;
+    return canonicalImported === localName
+        ? `${typePrefix}${localName}`
+        : `${typePrefix}${canonicalImported} as ${localName}`;
+}

package/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes.md

@@ -0,0 +1,25 @@
+#### Rename `createNodesV2` imports to `createNodes`
+
+`@nx/nuxt` renamed its primary inferred-plugin export from `createNodesV2` to `createNodes`. The `createNodesV2` name is preserved as a deprecated alias for now, but new code should use `createNodes`.
+
+This migration scans every `.ts`, `.tsx`, `.cts`, and `.mts` file in your workspace and rewrites named imports and re-exports of `createNodesV2` from `@nx/nuxt/plugin` to `createNodes`.
+
+#### Sample Code Changes
+
+##### Before
+
+```ts
+import { createNodesV2 } from '@nx/nuxt/plugin';
+```
+
+##### After
+
+```ts
+import { createNodes } from '@nx/nuxt/plugin';
+```
+
+Aliases are preserved (`createNodesV2 as cn` becomes `createNodes as cn`), and if a file already imports both names (`{ createNodes, createNodesV2 }`) the redundant binding is dropped.
+
+#### What is not rewritten
+
+Only static `import`/`export` named bindings from `@nx/nuxt/plugin` are rewritten. Namespace imports, dynamic `import(...)`, `require(...)` destructuring, and property access such as `plugin.createNodesV2` are left untouched — they keep working through the `createNodesV2` runtime alias. Update those by hand if you want to drop the deprecated name everywhere.