@nx/next 23.0.0-beta.21 → 23.0.0-beta.23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nx/next",
-  "version": "23.0.0-beta.21",
+  "version": "23.0.0-beta.23",
   "private": false,
   "description": "The Next.js plugin for Nx contains executors and generators for managing Next.js applications and libraries within an Nx workspace. It provides:\n\n\n- Scaffolding for creating, building, serving, linting, and testing Next.js applications.\n\n- Integration with building, serving, and exporting a Next.js application.\n\n- Integration with React libraries within the workspace. \n\nWhen using Next.js in Nx, you get the out-of-the-box support for TypeScript, Playwright, Cypress, and Jest. No need to configure anything: watch mode, source maps, and typings just work.",
   "repository": {
@@ -36,7 +36,7 @@
     "next": ">=14.0.0 <17.0.0"
   },
   "dependencies": {
-    "@nx/devkit": "23.0.0-beta.21",
+    "@nx/devkit": "23.0.0-beta.23",
     "@babel/plugin-proposal-decorators": "^7.22.7",
     "@svgr/webpack": "^8.0.1",
     "copy-webpack-plugin": "^14.0.0",
@@ -44,17 +44,17 @@
     "semver": "^7.6.3",
     "tslib": "^2.3.0",
     "webpack-merge": "^5.8.0",
-    "@nx/js": "23.0.0-beta.21",
-    "@nx/eslint": "23.0.0-beta.21",
-    "@nx/react": "23.0.0-beta.21",
-    "@nx/web": "23.0.0-beta.21",
-    "@nx/webpack": "23.0.0-beta.21",
+    "@nx/js": "23.0.0-beta.23",
+    "@nx/eslint": "23.0.0-beta.23",
+    "@nx/react": "23.0.0-beta.23",
+    "@nx/web": "23.0.0-beta.23",
+    "@nx/webpack": "23.0.0-beta.23",
     "@phenomnomnominal/tsquery": "~6.2.0"
   },
   "devDependencies": {
-    "@nx/cypress": "23.0.0-beta.21",
-    "@nx/playwright": "23.0.0-beta.21",
-    "nx": "23.0.0-beta.21"
+    "@nx/cypress": "23.0.0-beta.23",
+    "@nx/playwright": "23.0.0-beta.23",
+    "nx": "23.0.0-beta.23"
   },
   "publishConfig": {
     "access": "public"

package/plugins/with-nx.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"with-nx.d.ts","sourceRoot":"","sources":["../../../../packages/next/plugins/with-nx.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AACvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAGL,KAAK,uBAAuB,EAE7B,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C,EAAE,CAAC,EAAE;QACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAC9B,gBAAgB,CAAC,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QACvD,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;KAC7B,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AA+ED;;GAEG;AACH,iBAAS,MAAM,CACb,WAAW,GAAS,aAAa,EACjC,OAAO,GAAE,aAAkC,GAC1C,YAAY,CAkHd;AAED,wBAAgB,aAAa,CAC3B,UAAU,GAAS,aAAa,EAChC,OAAO,GAAE,aAAkC,GAC1C,UAAU,CAiIZ;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,uBAAuB,EAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAC9B,IAAI,GAAG,MAAM,CAcf;AAGD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,QAM3D;AASD,OAAO,EAAE,MAAM,EAAE,CAAC"}
+{"version":3,"file":"with-nx.d.ts","sourceRoot":"","sources":["../../../../packages/next/plugins/with-nx.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AACvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAGL,KAAK,uBAAuB,EAE7B,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C,EAAE,CAAC,EAAE;QACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAC9B,gBAAgB,CAAC,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QACvD,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;KAC7B,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AA+ED;;GAEG;AACH,iBAAS,MAAM,CACb,WAAW,GAAS,aAAa,EACjC,OAAO,GAAE,aAAkC,GAC1C,YAAY,CA4Hd;AAED,wBAAgB,aAAa,CAC3B,UAAU,GAAS,aAAa,EAChC,OAAO,GAAE,aAAkC,GAC1C,UAAU,CAiIZ;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,uBAAuB,EAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAC9B,IAAI,GAAG,MAAM,CAcf;AAGD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,QAM3D;AASD,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/plugins/with-nx.js

@@ -113,6 +113,13 @@ function withNx(_nextConfig = {}, context = getWithNxContext()) {
         }
         else {
             const { readCachedProjectGraph, joinPathFragments, offsetFromRoot, workspaceRoot, } = require('@nx/devkit');
+            // Resolved from the workspace (not bundled) so the deprecation warning is
+            // not inlined into production builds. Reached only on the active Nx-task
+            // path; the production-server phase returns above.
+            const { warnWithNxDeprecation } = require(require.resolve('@nx/next/src/utils/deprecation', {
+                paths: [workspaceRoot],
+            }));
+            warnWithNxDeprecation();
             // Since this is invoked by an Nx task, the graph is already cached.
             const graph = readCachedProjectGraph();
             const originalTarget = {

package/src/generators/application/files/common/next.config.js__tmpl__

@@ -1,4 +1,14 @@
 //@ts-check
+<% if (addPlugin) { -%>
+
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  // Next.js options go here
+  // See: https://nextjs.org/docs/app/api-reference/config/next-config-js
+};
+
+module.exports = nextConfig;
+<% } else { -%>
 
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const { composePlugins, withNx } = require('@nx/next');
@@ -8,7 +18,7 @@ const { composePlugins, withNx } = require('@nx/next');
  **/
 const nextConfig = {
   // Use this to set Nx-specific options
-  // See: https://nx.dev/recipes/next/next-config-setup
+  // See: https://nx.dev/docs/technologies/react/next/Guides/next-config-setup
   nx: {},
 };
 
@@ -18,3 +28,4 @@ const plugins = [
 ];
 
 module.exports = composePlugins(...plugins)(nextConfig);
+<% } -%>

package/src/plugins/plugin.d.ts

@@ -1,4 +1,4 @@
-import { CreateDependencies, CreateNodesV2 } from '@nx/devkit';
+import { CreateDependencies, CreateNodes } from '@nx/devkit';
 export interface NextPluginOptions {
     buildTargetName?: string;
     devTargetName?: string;
@@ -14,6 +14,6 @@ export interface NextPluginOptions {
  * @deprecated The 'createDependencies' function is now a no-op. This functionality is included in 'createNodesV2'.
  */
 export declare const createDependencies: CreateDependencies;
-export declare const createNodes: CreateNodesV2<NextPluginOptions>;
-export declare const createNodesV2: CreateNodesV2<NextPluginOptions>;
+export declare const createNodes: CreateNodes<NextPluginOptions>;
+export declare const createNodesV2: CreateNodes<NextPluginOptions>;
 //# sourceMappingURL=plugin.d.ts.map

package/src/plugins/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../../packages/next/src/plugins/plugin.ts"],"names":[],"mappings":"AAMA,OAAO,EAEL,kBAAkB,EAIlB,aAAa,EAKd,MAAM,YAAY,CAAC;AAWpB,MAAM,WAAW,iBAAiB;IAChC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAMD;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,kBAEhC,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,aAAa,CAAC,iBAAiB,CA6DxD,CAAC;AAEF,eAAO,MAAM,aAAa,kCAAc,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../../packages/next/src/plugins/plugin.ts"],"names":[],"mappings":"AAMA,OAAO,EAEL,kBAAkB,EAIlB,WAAW,EAKZ,MAAM,YAAY,CAAC;AAWpB,MAAM,WAAW,iBAAiB;IAChC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAMD;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,kBAEhC,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,iBAAiB,CA6DtD,CAAC;AAEF,eAAO,MAAM,aAAa,gCAAc,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"compose-plugins.d.ts","sourceRoot":"","sources":["../../../../../packages/next/src/utils/compose-plugins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AACvC,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,6BAA6B,EAC9B,MAAM,UAAU,CAAC;AAElB,wBAAgB,cAAc,CAC5B,GAAG,OAAO,EAAE,CAAC,UAAU,GAAG,6BAA6B,CAAC,EAAE,GACzD,CAAC,UAAU,EAAE,UAAU,KAAK,YAAY,CAoB1C"}
+{"version":3,"file":"compose-plugins.d.ts","sourceRoot":"","sources":["../../../../../packages/next/src/utils/compose-plugins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AACvC,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,6BAA6B,EAC9B,MAAM,UAAU,CAAC;AAGlB,wBAAgB,cAAc,CAC5B,GAAG,OAAO,EAAE,CAAC,UAAU,GAAG,6BAA6B,CAAC,EAAE,GACzD,CAAC,UAAU,EAAE,UAAU,KAAK,YAAY,CAqB1C"}

package/src/utils/compose-plugins.js

@@ -1,9 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.composePlugins = composePlugins;
+const deprecation_1 = require("./deprecation");
 function composePlugins(...plugins) {
     return function (baseConfig) {
         return async function combined(phase, context) {
+            (0, deprecation_1.warnComposePluginsDeprecation)(phase);
             let config = baseConfig;
             for (const plugin of plugins) {
                 const fn = await plugin;

package/src/utils/deprecation.d.ts

@@ -1,6 +1,13 @@
+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;
+export declare function warnComposePluginsDeprecation(phase: string): void;
 //# sourceMappingURL=deprecation.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"deprecation.d.ts","sourceRoot":"","sources":["../../../../../packages/next/src/utils/deprecation.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,uCAAuC,4PACuM,CAAC;AAE5P,eAAO,MAAM,wCAAwC,6PACuM,CAAC;AAE7P,wBAAgB,gCAAgC,IAAI,IAAI,CAEvD;AAED,wBAAgB,iCAAiC,IAAI,IAAI,CAExD;AAMD,wBAAgB,0BAA0B,IAAI,IAAI,CAIjD"}
+{"version":3,"file":"deprecation.d.ts","sourceRoot":"","sources":["../../../../../packages/next/src/utils/deprecation.ts"],"names":[],"mappings":"AAEA,OAAO,CAAC,MAAM,CAAC;IAGb,IAAI,iBAAiB,EAAE,OAAO,CAAC;CAChC;AAKD,eAAO,MAAM,uCAAuC,4PACuM,CAAC;AAE5P,eAAO,MAAM,wCAAwC,6PACuM,CAAC;AAE7P,wBAAgB,gCAAgC,IAAI,IAAI,CAEvD;AAED,wBAAgB,iCAAiC,IAAI,IAAI,CAExD;AAMD,wBAAgB,0BAA0B,IAAI,IAAI,CAIjD;AAKD,eAAO,MAAM,0BAA0B,QAG+D,CAAC;AAEvG,eAAO,MAAM,mCAAmC,QAGsD,CAAC;AAGvG,wBAAgB,qBAAqB,IAAI,IAAI,CAI5C;AAOD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAYjE"}

package/src/utils/deprecation.js

@@ -1,9 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NEXT_SERVER_EXECUTOR_DEPRECATION_MESSAGE = exports.NEXT_BUILD_EXECUTOR_DEPRECATION_MESSAGE = void 0;
+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.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
@@ -23,3 +25,36 @@ function warnNextServerExecutorDeprecation() {
 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.';
+let warnedWithNx = false;
+function warnWithNxDeprecation() {
+    if (warnedWithNx)
+        return;
+    warnedWithNx = true;
+    devkit_1.logger.warn(exports.WITHNX_DEPRECATION_MESSAGE);
+}
+let warnedComposePlugins = false;
+// Only nudge during interactive Nx task execution: skip production server start
+// (PHASE_PRODUCTION_SERVER), internal graph-creation passes, and direct
+// (non-Nx) `next` invocations. `next/constants` is required lazily so the helper
+// stays loadable in contexts where Next is not present.
+function warnComposePluginsDeprecation(phase) {
+    if (warnedComposePlugins)
+        return;
+    const { PHASE_PRODUCTION_SERVER } = require('next/constants');
+    if (phase === PHASE_PRODUCTION_SERVER ||
+        global.NX_GRAPH_CREATION ||
+        !process.env.NX_TASK_TARGET_TARGET) {
+        return;
+    }
+    warnedComposePlugins = true;
+    devkit_1.logger.warn(exports.COMPOSE_PLUGINS_DEPRECATION_MESSAGE);
+}