@nx/next 24.0.0-beta.1 → 24.0.0-beta.3

package/dist/src/generators/custom-server/custom-server.js

@@ -15,21 +15,13 @@ async function customServerGenerator(host, options) {
     const hasPlugin = nxJson.plugins?.some((p) => typeof p === 'string'
         ? p === '@nx/next/plugin'
         : p.plugin === '@nx/next/plugin');
-    if (project.targets?.build?.executor !== '@nx/next:build' && !hasPlugin) {
-        devkit_1.logger.error(`Project ${options.project} is not a Next.js project. Did you generate it with "nx g @nx/next:app"?`);
+    if (!hasPlugin) {
+        devkit_1.logger.error(`The "@nx/next/plugin" plugin is not registered in nx.json. Did you generate ${options.project} with "nx g @nx/next:app"?`);
         return;
     }
     // In Nx 18 next artifacts are inside the project root .next/ & dist/ (for custom server)
     const outputPath = `dist/${project.root}-server`;
     const root = project.root;
-    if ((!root ||
-        !outputPath ||
-        !project.targets?.build?.configurations?.development ||
-        !project.targets?.build?.configurations?.production) &&
-        !hasPlugin) {
-        devkit_1.logger.error(`Project ${options.project} has invalid config. Did you generate it with "nx g @nx/next:app"?`);
-        return;
-    }
     if (project.targets?.['build-custom-server'] ||
         project.targets?.['serve-custom-server']) {
         devkit_1.logger.warn(`Project ${options.project} has custom server targets already: build-custom-server, serve-custom-server. Remove these targets from project and try again.`);
@@ -37,14 +29,11 @@ async function customServerGenerator(host, options) {
     }
     // In Nx 18 next artifacts are inside the project root .next/ & dist/ (for custom server)
     // So we need ensure the mapping is correct from dist to the project root
-    const projectPathFromDist = hasPlugin
-        ? `../../${(0, devkit_1.offsetFromRoot)(project.root)}${project.root}`
-        : `${(0, devkit_1.offsetFromRoot)(`dist/${project.root}`)}${project.root}`;
+    const projectPathFromDist = `../../${(0, devkit_1.offsetFromRoot)(project.root)}${project.root}`;
     const offset = (0, devkit_1.offsetFromRoot)(project.root);
     const isTsSolution = (0, internal_2.isUsingTsSolutionSetup)(host);
     (0, devkit_1.generateFiles)(host, (0, path_1.join)(__dirname, 'files'), project.root, {
         ...options,
-        hasPlugin,
         projectPathFromDist,
         offsetFromRoot: offset,
         projectRoot: project.root,
@@ -53,17 +42,9 @@ async function customServerGenerator(host, options) {
             : './tsconfig.json',
         tmpl: '',
     });
-    if (!hasPlugin) {
-        project.targets.build.dependsOn = ['build-custom-server'];
-        project.targets.serve.options.customServerTarget = `${options.project}:serve-custom-server`;
-        project.targets.serve.configurations.development.customServerTarget = `${options.project}:serve-custom-server:development`;
-        project.targets.serve.configurations.production.customServerTarget = `${options.project}:serve-custom-server:production`;
-    }
-    else {
-        project.targets['build'] = {
-            dependsOn: ['^build', 'build-custom-server'],
-        };
-    }
+    project.targets['build'] = {
+        dependsOn: ['^build', 'build-custom-server'],
+    };
     project.targets['build-custom-server'] = {
         executor: options.compiler === 'tsc' ? '@nx/js:tsc' : '@nx/js:swc',
         defaultConfiguration: 'production',

package/dist/src/generators/custom-server/files/server/main.ts__tmpl__

@@ -11,12 +11,12 @@ import * as path from 'path';
 import next from 'next';
 
 // Next.js server options:
-// - The environment variable is set by `@nx/next:server` when running the dev server.
-// - The fallback `__dirname` is for production builds.
+// - `NX_NEXT_DIR` overrides the Next.js app directory.
+// - The fallback resolves the app directory from the built server's location.
 // - Feel free to change this to suit your needs.
 
 const dev = process.env.NODE_ENV === 'development';
-const dir = process.env.NX_NEXT_DIR || <%- hasPlugin ? `path.join(__dirname, '${projectPathFromDist}')` : `path.join(__dirname, dev ? '..' : '', '${projectPathFromDist}')`; %> 
+const dir = process.env.NX_NEXT_DIR || path.join(__dirname, '<%- projectPathFromDist %>');
 
 // HTTP Server options:
 // - Feel free to change this to suit your needs.

package/dist/src/generators/custom-server/files/tsconfig.server.json__tmpl__

@@ -5,7 +5,7 @@
     "moduleResolution": "nodenext",
     "noEmit": false,
     "incremental": true,
-    <% if(hasPlugin && compiler === 'tsc') { %>
+    <% if(compiler === 'tsc') { %>
     "tsBuildInfoFile": "<%= offsetFromRoot %>tmp/buildcache/<%= projectRoot %>/server",
     <% } %>
     "types": [

package/dist/src/generators/cypress-component-configuration/cypress-component-configuration.js

@@ -10,10 +10,7 @@ const path_1 = require("path");
 const versions_1 = require("../../utils/versions");
 const assert_supported_next_version_1 = require("../../utils/assert-supported-next-version");
 function cypressComponentConfiguration(tree, options) {
-    return cypressComponentConfigurationInternal(tree, {
-        addPlugin: false,
-        ...options,
-    });
+    return cypressComponentConfigurationInternal(tree, options);
 }
 async function cypressComponentConfigurationInternal(tree, options) {
     (0, assert_supported_next_version_1.assertSupportedNextVersion)(tree);
@@ -24,24 +21,14 @@ async function cypressComponentConfigurationInternal(tree, options) {
         skipFormat: true,
         framework: 'next',
         jsx: true,
-        addPlugin: options.addPlugin,
     }));
     const { webpackInitGenerator } = (0, devkit_1.ensurePackage)('@nx/webpack', versions_1.nxVersion);
     tasks.push(await webpackInitGenerator(tree, {
         skipFormat: true,
-        addPlugin: options.addPlugin,
     }));
     const { ensureDependencies, } = require('@nx/webpack/internal');
     tasks.push(ensureDependencies(tree, { compiler: 'swc', uiFramework: 'react' }));
     const projectConfig = (0, devkit_1.readProjectConfiguration)(tree, options.project);
-    if (projectConfig.targets?.['component-test']?.executor ===
-        '@nx/cypress:cypress') {
-        projectConfig.targets['component-test'].options = {
-            ...projectConfig.targets['component-test'].options,
-            skipServe: true,
-        };
-        (0, devkit_1.updateProjectConfiguration)(tree, options.project, projectConfig);
-    }
     await addFiles(tree, projectConfig, options);
     if (!options.skipFormat) {
         await (0, devkit_1.formatFiles)(tree);

package/dist/src/generators/cypress-component-configuration/schema.d.ts

@@ -2,5 +2,4 @@ export interface CypressComponentConfigurationGeneratorSchema {
   project: string;
   generateTests: boolean;
   skipFormat?: boolean;
-  addPlugin?: boolean;
 }

package/dist/src/generators/init/init.js

@@ -33,37 +33,23 @@ async function updateDependencies(host, schema) {
     return (0, devkit_1.runTasksInSerial)(...tasks);
 }
 function nextInitGenerator(tree, schema) {
-    return nextInitGeneratorInternal(tree, { addPlugin: false, ...schema });
+    return nextInitGeneratorInternal(tree, schema);
 }
 async function nextInitGeneratorInternal(host, schema) {
     (0, assert_supported_next_version_1.assertSupportedNextVersion)(host);
-    const nxJson = (0, devkit_1.readNxJson)(host);
-    const addPluginDefault = process.env.NX_ADD_PLUGINS !== 'false' &&
-        nxJson.useInferencePlugins !== false;
-    schema.addPlugin ??= addPluginDefault;
-    if (schema.addPlugin) {
-        const { createNodesV2, } = require('../../plugins/plugin');
-        await (0, internal_1.addPlugin)(host, await (0, devkit_1.createProjectGraphAsync)(), '@nx/next/plugin', createNodesV2, {
-            startTargetName: ['start', 'next:start', 'next-start'],
-            buildTargetName: ['build', 'next:build', 'next-build'],
-            devTargetName: ['dev', 'next:dev', 'next-dev'],
-            serveStaticTargetName: [
-                'serve-static',
-                'next:serve-static',
-                'next-serve-static',
-            ],
-            buildDepsTargetName: [
-                'build-deps',
-                'next:build-deps',
-                'next-build-deps',
-            ],
-            watchDepsTargetName: [
-                'watch-deps',
-                'next:watch-deps',
-                'next-watch-deps',
-            ],
-        }, schema.updatePackageScripts);
-    }
+    const { createNodesV2, } = require('../../plugins/plugin');
+    await (0, internal_1.addPlugin)(host, await (0, devkit_1.createProjectGraphAsync)(), '@nx/next/plugin', createNodesV2, {
+        startTargetName: ['start', 'next:start', 'next-start'],
+        buildTargetName: ['build', 'next:build', 'next-build'],
+        devTargetName: ['dev', 'next:dev', 'next-dev'],
+        serveStaticTargetName: [
+            'serve-static',
+            'next:serve-static',
+            'next-serve-static',
+        ],
+        buildDepsTargetName: ['build-deps', 'next:build-deps', 'next-build-deps'],
+        watchDepsTargetName: ['watch-deps', 'next:watch-deps', 'next-watch-deps'],
+    }, schema.updatePackageScripts);
     (0, add_gitignore_entry_1.addGitIgnoreEntry)(host);
     let installTask = () => { };
     if (!schema.skipPackageJson) {

package/dist/src/generators/init/schema.d.ts

@@ -3,5 +3,4 @@ export interface InitSchema {
   skipPackageJson?: boolean;
   keepExistingVersions?: boolean;
   updatePackageScripts?: boolean;
-  addPlugin?: boolean;
 }

package/dist/src/generators/library/lib/add-rollup-server-entry.js

@@ -10,22 +10,13 @@ const devkit_1 = require("@nx/devkit");
 function addRollupServerEntry(tree, options) {
     const serverEntry = `src/server.${options.js ? 'js' : 'ts'}`;
     const rollupConfigPath = (0, devkit_1.joinPathFragments)(options.projectRoot, 'rollup.config.cjs');
-    if (tree.exists(rollupConfigPath)) {
-        const content = tree.read(rollupConfigPath, 'utf-8');
-        const updated = content.replace(/^(\s*)main: .*\n/m, (line, indent) => line + `${indent}additionalEntryPoints: ['./${serverEntry}'],\n`);
-        if (updated === content) {
-            throw new Error(`Could not add the server entry to ${rollupConfigPath}: "main" option not found.`);
-        }
-        tree.write(rollupConfigPath, updated);
-        return;
+    if (!tree.exists(rollupConfigPath)) {
+        throw new Error(`Could not add the server entry: ${rollupConfigPath} not found.`);
     }
-    const project = (0, devkit_1.readProjectConfiguration)(tree, options.projectName);
-    const build = project.targets?.build;
-    if (build?.executor !== '@nx/rollup:rollup') {
-        throw new Error(`Could not add the server entry to the "build" target of "${options.projectName}": expected the @nx/rollup:rollup executor.`);
+    const content = tree.read(rollupConfigPath, 'utf-8');
+    const updated = content.replace(/^(\s*)main: .*\n/m, (line, indent) => line + `${indent}additionalEntryPoints: ['./${serverEntry}'],\n`);
+    if (updated === content) {
+        throw new Error(`Could not add the server entry to ${rollupConfigPath}: "main" option not found.`);
     }
-    build.options.additionalEntryPoints = [
-        (0, devkit_1.joinPathFragments)(options.projectRoot, serverEntry),
-    ];
-    (0, devkit_1.updateProjectConfiguration)(tree, options.projectName, project);
+    tree.write(rollupConfigPath, updated);
 }

package/dist/src/generators/library/lib/normalize-options.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.normalizeOptions = normalizeOptions;
-const devkit_1 = require("@nx/devkit");
 const internal_1 = require("@nx/devkit/internal");
 const internal_2 = require("@nx/js/internal");
 async function normalizeOptions(host, options) {
@@ -12,10 +11,6 @@ async function normalizeOptions(host, options) {
         directory: options.directory,
         importPath: options.importPath,
     });
-    const nxJson = (0, devkit_1.readNxJson)(host);
-    const addPlugin = process.env.NX_ADD_PLUGINS !== 'false' &&
-        nxJson.useInferencePlugins !== false;
-    options.addPlugin ??= addPlugin;
     const isUsingTsSolutionConfig = (0, internal_2.isUsingTsSolutionSetup)(host);
     return {
         ...options,

package/dist/src/generators/library/library.js

@@ -15,7 +15,6 @@ const versions_1 = require("../../utils/versions");
 const internal_2 = require("@nx/js/internal");
 async function libraryGenerator(host, rawOptions) {
     return await libraryGeneratorInternal(host, {
-        addPlugin: false,
         useProjectJson: true,
         ...rawOptions,
     });
@@ -23,7 +22,7 @@ async function libraryGenerator(host, rawOptions) {
 async function libraryGeneratorInternal(host, rawOptions) {
     (0, assert_supported_next_version_1.assertSupportedNextVersion)(host);
     const tasks = [];
-    const addTsPlugin = (0, internal_2.shouldConfigureTsSolutionSetup)(host, rawOptions.addPlugin);
+    const addTsPlugin = (0, internal_2.shouldConfigureTsSolutionSetup)(host);
     const jsInitTask = await (0, js_1.initGenerator)(host, {
         js: rawOptions.js,
         addTsPlugin,

package/dist/src/generators/library/schema.d.ts

@@ -29,6 +29,5 @@ export interface Schema {
    */
   setParserOptionsProject?: boolean;
   skipPackageJson?: boolean;
-  addPlugin?: boolean;
   useProjectJson?: boolean;
 }

package/dist/src/migrations/update-24-0-0/finish-inferred-conversion.md

@@ -0,0 +1,12 @@
+# Replace removed @nx/next executors with inferred tasks
+
+Nx 24 removed `@nx/next:build`, `@nx/next:server` (including old `@nrwl` aliases).
+
+Before changing anything, check for leftover work: a project target, a package.json target or a `targetDefaults` entry still uses a removed executor, or the advisory context reports a conversion error. If none applies, make no changes and stop. Treat each advisory-context item as pending work.
+
+1. Inspect all affected projects and workspace defaults. Repair config-loading errors first. Do not restore executor registrations or install older Nx packages.
+2. Move executor options into next.config and Next CLI flags. Preserve webpack callbacks, transpilePackages, workspace libraries, assets, output directory, environment settings and the intended Webpack/Turbopack mode. Build every migrated Next application unless expensive validation was explicitly skipped.
+3. Register `@nx/next/plugin` with options/includes that preserve custom target names and mixed inferred/explicit projects. Replace remaining removed-executor targets, including those in package.json and filtered targetDefaults. Transfer their behavior before removing obsolete defaults. Preserve configurations, dependencies, cache inputs/outputs and environment behavior. Do not silently delete unsupported options or unrelated targets. Migrate old @nrwl aliases too.
+4. Run project graph creation with the daemon and graph cache disabled (`NX_DAEMON=false NX_CACHE_PROJECT_GRAPH=false`), using the workspace package manager. Inspect resolved project targets and verify each migrated entrypoint exists and is inferred (a thin alias to an inferred target is acceptable). Resolve graph errors before completing this migration, even if task validation was skipped. Configs must load for subsequent migrations.
+5. By default run relevant real builds/tests with task cache disabled, including alternate configurations. Honor an existing preference to skip expensive task validation; otherwise offer that option when validation is slow. Skipping expensive tasks never skips conversion or the graph check. Report each skipped task as unverified. Never weaken assertions or change application behavior to make checks pass.
+6. Report converted projects, graph validation, task results and any skipped checks. Unconverted targets or a broken graph mean the migration is incomplete. Investigate task failures and distinguish missing environment prerequisites from conversion regressions; do not claim a working workspace with unresolved regressions.

package/dist/src/migrations/update-24-0-0/migrate-config-helpers.md

@@ -0,0 +1,80 @@
+# Migrate Next.js config helpers
+
+Remove `withNx` and `composePlugins` from Next.js configurations. Compatibility
+exports are inert stubs so old imports do not strand graph creation. Helper behavior was removed in Nx 24. Preserve
+application behavior; successful config loading is not proof of equivalence.
+
+## Inspect before changing
+
+Find all `next.config.*` files and imported configuration helpers, including
+aliased imports from `@nx/next` and `@nx/next/plugins/with-nx`. Read project targets,
+configuration overrides, package scripts, tsconfigs, and workspace package exports.
+Record the installed Next version and whether each command uses webpack or
+Turbopack. Preserve both; do not switch bundlers or upgrade Next as part of this
+migration. Handle explicit and inferred targets without changing their types. Nx 24
+removed the `@nx/next` build and serve executors, and a separate migration converts
+their targets, so do not add them back.
+
+Record existing output locations, build/serve/export commands, and custom behavior.
+Build a baseline before edits if possible; otherwise use an isolated checkout of
+the old lockfile. Do not downgrade the working workspace or silently skip validation.
+
+## Unwrap the configuration
+
+Preserve the original export form and Next's config-function contract, including
+phase, defaultConfig, async results, and the order of third-party wrappers. Replace
+Nx composition with direct composition of the remaining wrappers. Inspect wrapper
+APIs rather than assume every wrapper accepts the same arguments or returns an
+object. Do not discard custom webpack callbacks or overwrite other wrappers.
+
+Remove the `nx` property from the final Next config only after accounting for every
+option it contains. Merely deleting `withNx` does not migrate those options.
+`@nx/next:convert-to-inferred` does not finish this job: its existing config rewrite
+preserves `withNx` and moves executor options into `nx`.
+
+## Preserve required behavior
+
+Test whether each behavior is needed on this workspace's installed Next version
+and existing bundler. Prefer native options. If no native equivalent preserves the
+behavior, inline the necessary implementation in a local, user-owned config helper.
+The user will maintain that code; do not import Nx's deprecated wrapper or private
+implementation as the replacement.
+
+- **Workspace libraries:** verify both tsconfig paths and package-manager workspace
+  dependencies, including TypeScript/JSX sources and package exports. Add explicit
+  `transpilePackages` entries only where required, merging existing entries. Do not
+  assume all workspace libraries are transpiled without configuration.
+- **Output paths:** preserve build output and standalone deployment expectations,
+  explicit `distDir`, the `outputPath` the removed executor set, and any
+  `NX_NEXT_OUTPUT_PATH` behavior. Keep development output compatible with the
+  existing bundler. Check Nx's declared cache outputs still cover actual files.
+- **Static export:** preserve `output: 'export'`, the export destination, and the
+  commands that serve it. Do not replace a static export with a server deployment.
+- **File replacements/assets:** account for options in both targets and `nx` config.
+  Preserve workspace-relative paths, configuration selection, copy destinations,
+  and ignores. Use native facilities or inline the required code, then check output.
+- **ESM imports:** test `.js` specifiers pointing to TypeScript sources. Keep or
+  inline `extensionAlias` only where the installed webpack setup needs it; do not
+  assume a webpack option affects Turbopack.
+- **CSS/SCSS modules:** test imports from shared libraries under the existing
+  bundler. Remove obsolete loader patches only after verifying native support.
+- **Babel:** preserve opted-in `babelUpwardRootMode` behavior and custom transforms.
+  Inline required webpack behavior if native configuration is insufficient.
+- **Legacy lint behavior:** retain the effective build behavior where supported;
+  do not emit removed Next options on versions that reject them.
+
+Avoid patches to Next internals when native configuration works. If behavior cannot
+be preserved, describe the exact blocker and ask for a decision rather than silently
+changing the application.
+
+## Acceptance
+
+Recreate the graph without its disk cache. Run affected builds without task-cache
+reuse, relevant tests, production startup/static serving, and dev behavior. Check
+shared-library rendering, CSS/SCSS, copied assets, aliases, output locations, and
+configuration-specific behavior against the baseline. Use semantic comparisons
+where generated hashes differ.
+
+Search configs and imported helpers for remaining Nx wrappers. Already migrated
+configs should be unchanged. Report evidence and unresolved differences; never
+remove custom behavior or weaken tests to obtain a successful build.

package/dist/src/migrations/update-24-0-0/remove-deprecated-executors.d.ts

@@ -0,0 +1,6 @@
+import type { Tree } from '@nx/devkit';
+export default function update(tree: Tree): Promise<{
+    nextSteps?: string[];
+    agentContext?: string[];
+    skipAgentic?: boolean;
+}>;

package/dist/src/migrations/update-24-0-0/remove-deprecated-executors.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = update;
+const internal_1 = require("@nx/devkit/internal");
+function update(tree) {
+    return (0, internal_1.migrateRemovedExecutors)(tree, [
+        '@nx/next:build',
+        '@nx/next:server',
+        '@nrwl/next:build',
+        '@nrwl/next:server',
+    ], async (tree, options) => {
+        const { convertToInferred } = require('../../generators/convert-to-inferred/convert-to-inferred');
+        // The callback only prints the options the converter could not carry
+        // over; migrateRemovedExecutors discards it.
+        const flushLogs = await convertToInferred(tree, options);
+        flushLogs();
+    });
+}

package/dist/src/migrations/update-24-0-0/remove-deprecated-executors.md

@@ -0,0 +1,89 @@
+#### Convert `@nx/next` build and server targets to inferred tasks
+
+Nx 24 removes the `@nx/next:build` and `@nx/next:server` executors and their `@nrwl` aliases. The migration registers `@nx/next/plugin` in `nx.json` and converts the targets that use those executors to inferred tasks. It moves build options into `next.config.*`. A target with nothing left to override is removed from project configuration. When several projects share the same remaining options, those options move to a `targetDefaults` entry scoped to the plugin. `targetDefaults` entries keyed by a removed executor are removed once no target uses that executor.
+
+The migration lists the targets the converter cannot convert safely. In agentic runs, an AI prompt finishes them and validates the project graph.
+
+#### Sample code changes
+
+##### Before
+
+```json title="apps/my-app/project.json"
+{
+  "name": "my-app",
+  "targets": {
+    "build": {
+      "executor": "@nx/next:build",
+      "defaultConfiguration": "production",
+      "options": {
+        "outputPath": "dist/apps/my-app"
+      },
+      "configurations": {
+        "development": {
+          "outputPath": "apps/my-app"
+        },
+        "production": {}
+      }
+    },
+    "serve": {
+      "executor": "@nx/next:server",
+      "defaultConfiguration": "development",
+      "options": {
+        "dev": true,
+        "port": 4200
+      },
+      "configurations": {
+        "development": {
+          "buildTarget": "my-app:build:development",
+          "dev": true
+        },
+        "production": {
+          "buildTarget": "my-app:build:production",
+          "dev": false
+        }
+      }
+    }
+  }
+}
+```
+
+##### After
+
+```json title="apps/my-app/project.json"
+{
+  "name": "my-app",
+  "targets": {
+    "build": {
+      "configurations": {
+        "development": {}
+      }
+    },
+    "serve": {
+      "configurations": {
+        "development": {},
+        "production": {}
+      },
+      "defaultConfiguration": "development",
+      "options": {
+        "port": 4200
+      }
+    }
+  }
+}
+```
+
+```json title="nx.json"
+{
+  "plugins": [
+    {
+      "plugin": "@nx/next/plugin",
+      "options": {
+        "buildTargetName": "build",
+        "devTargetName": "serve",
+        "serveStaticTargetName": "serve-static",
+        "startTargetName": "start"
+      }
+    }
+  ]
+}
+```

package/dist/src/utils/compose-plugins.d.ts

@@ -1,3 +1,8 @@
 import type { NextConfig } from 'next';
 import type { NextConfigFn, NextPlugin, NextPluginThatReturnsConfigFn } from './config';
-export declare function composePlugins(...plugins: (NextPlugin | NextPluginThatReturnsConfigFn)[]): (baseConfig: NextConfig) => NextConfigFn;
+/**
+ * @deprecated Export the Next.js config directly and compose
+ * any other wrappers yourself.
+ * This inert stub will be removed in Nx v25.
+ */
+export declare function composePlugins(..._plugins: (NextPlugin | NextPluginThatReturnsConfigFn)[]): (baseConfig: NextConfig) => NextConfigFn;

package/dist/src/utils/compose-plugins.js

@@ -1,34 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.composePlugins = composePlugins;
-function composePlugins(...plugins) {
-    return function (baseConfig) {
-        return async function combined(phase, context) {
-            const { PHASE_PRODUCTION_SERVER, } = require('next/constants');
-            // Copied verbatim into the build output (see create-next-config-file.ts),
-            // so this must load without @nx/next or @nx/devkit installed. Warn only on
-            // the active Nx-task path, resolved from the workspace like with-nx.ts.
-            if (phase !== PHASE_PRODUCTION_SERVER &&
-                !global.NX_GRAPH_CREATION &&
-                process.env.NX_TASK_TARGET_TARGET) {
-                const { workspaceRoot } = require('@nx/devkit');
-                const { warnComposePluginsDeprecation } = require(require.resolve('@nx/next/src/utils/deprecation', {
-                    paths: [workspaceRoot],
-                }));
-                warnComposePluginsDeprecation(phase);
-            }
-            let config = baseConfig;
-            for (const plugin of plugins) {
-                const fn = await plugin;
-                const configOrFn = fn(config);
-                if (typeof configOrFn === 'function') {
-                    config = await configOrFn(phase, context);
-                }
-                else {
-                    config = configOrFn;
-                }
-            }
-            return config;
-        };
+// TODO(v25): remove the inert config-helper stubs in this file.
+/**
+ * @deprecated Export the Next.js config directly and compose
+ * any other wrappers yourself.
+ * This inert stub will be removed in Nx v25.
+ */
+function composePlugins(..._plugins) {
+    return (baseConfig) => async (phase) => {
+        const { PHASE_PRODUCTION_SERVER } = require('next/constants');
+        // Copied into production builds, so only resolve the warning on Nx task runs.
+        if (phase !== PHASE_PRODUCTION_SERVER &&
+            !global.NX_GRAPH_CREATION &&
+            process.env.NX_TASK_TARGET_TARGET) {
+            const { workspaceRoot } = require('@nx/devkit');
+            const { warnComposePluginsDeprecation } = require(require.resolve('@nx/next/src/utils/deprecation', {
+                paths: [workspaceRoot],
+            }));
+            warnComposePluginsDeprecation(phase);
+        }
+        return baseConfig;
     };
 }

package/dist/src/utils/deprecation.d.ts

@@ -1,11 +1,6 @@
 declare global {
     var NX_GRAPH_CREATION: boolean;
 }
-export declare const NEXT_BUILD_EXECUTOR_DEPRECATION_MESSAGE = "The `@nx/next:build` executor is deprecated and will be removed in Nx v24. Run `nx g @nx/next:convert-to-inferred` to migrate to the `@nx/next/plugin` inferred targets. See https://nx.dev/docs/guides/tasks--caching/convert-to-inferred for details.";
-export declare const NEXT_SERVER_EXECUTOR_DEPRECATION_MESSAGE = "The `@nx/next:server` executor is deprecated and will be removed in Nx v24. Run `nx g @nx/next:convert-to-inferred` to migrate to the `@nx/next/plugin` inferred targets. See https://nx.dev/docs/guides/tasks--caching/convert-to-inferred for details.";
-export declare function warnNextBuildExecutorDeprecation(): void;
-export declare function warnNextServerExecutorDeprecation(): void;
-export declare function warnNextExecutorGenerating(): void;
 export declare const WITHNX_DEPRECATION_MESSAGE: string;
 export declare const COMPOSE_PLUGINS_DEPRECATION_MESSAGE: string;
 export declare function warnWithNxDeprecation(): void;

package/dist/src/utils/deprecation.js

@@ -1,39 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.COMPOSE_PLUGINS_DEPRECATION_MESSAGE = exports.WITHNX_DEPRECATION_MESSAGE = exports.NEXT_SERVER_EXECUTOR_DEPRECATION_MESSAGE = exports.NEXT_BUILD_EXECUTOR_DEPRECATION_MESSAGE = void 0;
-exports.warnNextBuildExecutorDeprecation = warnNextBuildExecutorDeprecation;
-exports.warnNextServerExecutorDeprecation = warnNextServerExecutorDeprecation;
-exports.warnNextExecutorGenerating = warnNextExecutorGenerating;
+exports.COMPOSE_PLUGINS_DEPRECATION_MESSAGE = exports.WITHNX_DEPRECATION_MESSAGE = void 0;
 exports.warnWithNxDeprecation = warnWithNxDeprecation;
 exports.warnComposePluginsDeprecation = warnComposePluginsDeprecation;
 const devkit_1 = require("@nx/devkit");
-// TODO(v24): Remove the @nx/next:build and @nx/next:server executors. The
-// inferred plugin (@nx/next/plugin) and the convert-to-inferred generator
-// stay supported.
-exports.NEXT_BUILD_EXECUTOR_DEPRECATION_MESSAGE = 'The `@nx/next:build` executor is deprecated and will be removed in Nx v24. Run `nx g @nx/next:convert-to-inferred` to migrate to the `@nx/next/plugin` inferred targets. See https://nx.dev/docs/guides/tasks--caching/convert-to-inferred for details.';
-exports.NEXT_SERVER_EXECUTOR_DEPRECATION_MESSAGE = 'The `@nx/next:server` executor is deprecated and will be removed in Nx v24. Run `nx g @nx/next:convert-to-inferred` to migrate to the `@nx/next/plugin` inferred targets. See https://nx.dev/docs/guides/tasks--caching/convert-to-inferred for details.';
-function warnNextBuildExecutorDeprecation() {
-    devkit_1.logger.warn(exports.NEXT_BUILD_EXECUTOR_DEPRECATION_MESSAGE);
-}
-function warnNextServerExecutorDeprecation() {
-    devkit_1.logger.warn(exports.NEXT_SERVER_EXECUTOR_DEPRECATION_MESSAGE);
-}
-// Fired when the @nx/next:application generator is about to generate targets
-// that use the deprecated executors — i.e. when @nx/next/plugin isn't
-// registered in nx.json. Surfaces the deprecation at generation time rather
-// than only when the user later runs the generated targets.
-function warnNextExecutorGenerating() {
-    devkit_1.logger.warn('Generating targets that use the deprecated `@nx/next:build` and `@nx/next:server` executors. These executors will be removed in Nx v24. Run `nx g @nx/next:convert-to-inferred` next to migrate these targets to the `@nx/next/plugin` inferred plugin and prevent future generators from emitting executor targets. See https://nx.dev/docs/guides/tasks--caching/convert-to-inferred for details.');
-}
-// TODO(v24): Remove the `withNx`/`composePlugins` config wrappers. Modern
-// workspaces resolve libraries via package manager workspaces and Next.js
-// transpiles workspace source automatically, so a plain `next.config.js` works.
-exports.WITHNX_DEPRECATION_MESSAGE = '[Nx] `withNx()` from `@nx/next` is deprecated and will be removed in Nx v24. ' +
-    'A plain `next.config.js` is now the recommended pattern; Next.js transpiles workspace libraries automatically. ' +
-    'See https://nx.dev/docs/technologies/react/next/Guides/next-config-setup for the migration recipe.';
-exports.COMPOSE_PLUGINS_DEPRECATION_MESSAGE = '[Nx] `composePlugins()` from `@nx/next` is deprecated and will be removed in Nx v24. ' +
-    'Compose Next.js plugins directly in your `next.config.js` and remove the `@nx/next` import. ' +
-    'See https://nx.dev/docs/technologies/react/next/Guides/next-config-setup for the migration recipe.';
+// Helper behavior was removed in v24; exports remain only as inert stubs.
+// Keep old configs loadable; preserve required wrapper behavior in user config.
+exports.WITHNX_DEPRECATION_MESSAGE = '[Nx] `withNx()` from `@nx/next` was removed in Nx v24. The remaining export is an inert compatibility stub and does not configure builds. ' +
+    'Migrate to native Next.js configuration and inline any remaining required behavior. ' +
+    'Follow the config-helper migration instructions generated by `nx migrate`.';
+exports.COMPOSE_PLUGINS_DEPRECATION_MESSAGE = '[Nx] `composePlugins()` from `@nx/next` was removed in Nx v24. The remaining export is an inert compatibility stub and does not configure builds. ' +
+    'Compose Next.js plugins directly, preserving their order and config-function behavior. ' +
+    'Follow the config-helper migration instructions generated by `nx migrate`.';
 let warnedWithNx = false;
 function warnWithNxDeprecation() {
     if (warnedWithNx)

package/executors.json

@@ -1,14 +1,3 @@
 {
-  "executors": {
-    "build": {
-      "implementation": "./dist/src/executors/build/build.impl",
-      "schema": "./dist/src/executors/build/schema.json",
-      "description": "Build a Next.js application."
-    },
-    "server": {
-      "implementation": "./dist/src/executors/server/server.impl",
-      "schema": "./dist/src/executors/server/schema.json",
-      "description": "Serve a Next.js application."
-    }
-  }
+  "executors": {}
 }