chore(core): build nx to local dist and use nodenext (#34111)

## Current Behavior

The `nx` package compiles its TypeScript output to
`../../dist/packages/nx/` (relative to the package root), which places
build artifacts outside the package directory at the repo root level
(`dist/packages/nx/`). This makes the package structure harder to reason
about, complicates the build pipeline, and doesn't align with how most
packages organize their output.

The package uses `"module": "commonjs"` with basic module resolution,
which limits future migration paths toward ESM.

## Expected Behavior

The `nx` package now builds to a local `dist/` directory within the
package itself (`packages/nx/dist/`). This is a cleaner, more standard
layout — like having your tools in your own toolbox instead of scattered
across the workshop.

### Key changes:

**Build configuration (`packages/nx/tsconfig.lib.json`):**
- `outDir` changed from `../../dist/packages/nx` to `dist` (local to
package)
- `module` changed to `nodenext` with `moduleResolution: nodenext`
- Updated `include` patterns to explicitly list source directories

**Package entry points (`packages/nx/package.json`):**
- `bin` paths updated: `./bin/nx.js` → `./dist/bin/nx.js`
- Added `"type": "commonjs"` explicitly
- Added comprehensive `exports` map with `@nx/nx-source` condition for
dev/test resolution back to TS source
- Added `postinstall` path update to `./dist/bin/post-install`

**Module resolution fixes:**
- Created `src/utils/handle-import.ts` — a CJS-first import utility that
falls back to ESM `import()` for ESM-only packages, providing a single
migration point for future ESM work
- Converted dynamic `await import()` calls to
`require(require.resolve())` pattern where needed to satisfy `nodenext`
extension requirements
- Plugin worker spawn path now uses correct `.ts`/`.js` extension based
on runtime context (source vs compiled)

**Test infrastructure:**
- Added custom `jest-resolver.js` for the `nx` package that resolves
`nx/...` imports using the `@nx/nx-source` exports condition, so tests
run against TS source
- Updated `jest.preset.js` with SWC transformer configuration
- Added chalk mock for test compatibility

**CI and tooling:**
- Conformance check updated to build `workspace-plugin` first (the Nx
Cloud runner lacks `@swc-node/register` for TS resolution)
- Conformance rule paths in `nx.json` now point to compiled
`dist/workspace-plugin/src/...` output
- Added `dist` to eslint ignore patterns to prevent linting compiled
output
- Added workspace-plugin build target and updated its dependencies

**Other fixes:**
- Various import path fixes across `create-nx-workspace`, gradle, and
other packages to work with `nodenext` resolution
- Updated e2e test paths to reference the new dist location
- Fixed `.gitignore` and `.npmignore` for the new output structure

## Related Issue(s)

Internal infrastructure improvement — no external issue.

---------

Co-authored-by: nx-cloud[bot] <71083854+nx-cloud[bot]@users.noreply.github.com>
Co-authored-by: Coly010 <Coly010@users.noreply.github.com>
Co-authored-by: FrozenPandaz <jasonjean1993@gmail.com>

Author: 3 people

.github/workflows/ci.yml

@@ -89,7 +89,7 @@ jobs:
           pnpm nx-cloud record -- nx sync:check
           pids+=($!)
 
-          pnpm nx-cloud record -- nx-cloud conformance:check
+          pnpm nx build workspace-plugin && pnpm nx-cloud record -- pnpm nx conformance:check
           pids+=($!)
 
           pnpm nx run-many -t check-imports check-lock-files check-codeowners --parallel=1 --no-dte &

.gitignore

@@ -131,6 +131,7 @@ packages/angular-rspack/README.md
 packages/angular-rspack-compiler/README.md
 packages/dotnet/README.md
 packages/maven/README.md
+packages/nx/README.md
 
 test-output
 test-results
@@ -145,4 +146,11 @@ test-results
 .nx/polygraph
 .claude/worktrees
 
-.nx/self-healing
+.nx/self-healing
+# Nx Typings Output
+packages/nx/**/*.d.ts
+!packages/nx/src/utils/perf-hooks.d.ts
+!packages/nx/src/ai/set-up-ai-agents/schema.d.ts
+!packages/nx/src/native/index.d.ts
+e2e/**/*.d.ts
+e2e/**/*.d.ts.map

astro-docs/project.json

@@ -20,7 +20,13 @@
       "dependsOn": [
         "prebuild-banner",
         {
-          "projects": ["devkit", "create-nx-workspace", "dotnet", "maven"],
+          "projects": [
+            "nx",
+            "devkit",
+            "create-nx-workspace",
+            "dotnet",
+            "maven"
+          ],
           "target": "build"
         }
       ],
@@ -33,7 +39,13 @@
       "dependsOn": [
         "prebuild-banner",
         {
-          "projects": ["devkit", "create-nx-workspace", "dotnet", "maven"],
+          "projects": [
+            "nx",
+            "devkit",
+            "create-nx-workspace",
+            "dotnet",
+            "maven"
+          ],
           "target": "build"
         }
       ],

astro-docs/src/plugins/utils/get-schema-example-content.ts

@@ -40,7 +40,18 @@ export function getExampleForSchema(
   }
   const exampleFilePath = schema[EXAMPLE_SCHEMA_KEY];
   const schemaDirName = dirname(schemaPath);
-  const docPath = resolvePath(schemaDirName, exampleFilePath);
+  let docPath = resolvePath(schemaDirName, exampleFilePath);
+
+  // If the resolved path doesn't exist and the schema is in a dist/ directory,
+  // try resolving from the source tree instead, since docs files
+  // may not be copied to dist during the build.
+  if (!existsSync(docPath) && schemaPath.includes('/dist/src/')) {
+    const sourceSchemaDir = dirname(schemaPath.replace('/dist/src/', '/src/'));
+    const sourceDocPath = resolvePath(sourceSchemaDir, exampleFilePath);
+    if (existsSync(sourceDocPath)) {
+      docPath = sourceDocPath;
+    }
+  }
 
   if (!existsSync(docPath)) {
     throw new Error(

e2e/angular/tsconfig.spec.json

@@ -13,6 +13,7 @@
     "**/*.test.js",
     "**/*.spec.jsx",
     "**/*.test.jsx",
+    "src/**/*.ts",
     "**/*.d.ts",
     "jest.config.ts"
   ]

e2e/dotnet/tsconfig.json

@@ -1,13 +1,16 @@
 {
   "extends": "../../tsconfig.base.json",
   "compilerOptions": {
-    "allowJs": true
+    "types": ["node", "jest"]
   },
-  "include": ["**/*.ts", "**/*.js"],
-  "exclude": ["node_modules", "dist"],
+  "include": [],
+  "files": [],
   "references": [
     {
       "path": "../utils"
+    },
+    {
+      "path": "./tsconfig.spec.json"
     }
   ]
 }

e2e/esbuild/tsconfig.spec.json

@@ -13,6 +13,7 @@
     "**/*.test.js",
     "**/*.spec.jsx",
     "**/*.test.jsx",
+    "src/**/*.ts",
     "**/*.d.ts",
     "jest.config.ts"
   ]

e2e/expo/src/expo-legacy.test.ts

@@ -200,9 +200,7 @@ describe('@nx/expo (legacy)', () => {
   it('should tsc app', async () => {
     expect(() => {
       const pmc = getPackageManagerCommand();
-      runCommand(
-        `${pmc.runUninstalledPackage} tsc -p apps/${appName}/tsconfig.app.json`
-      );
+      runCommand(`${pmc.exec} tsc -p apps/${appName}/tsconfig.app.json`);
       checkFilesExist(
         `dist/out-tsc/apps/${appName}/src/app/App.js`,
         `dist/out-tsc/apps/${appName}/src/app/App.d.ts`,

e2e/jest/src/jest.test.ts

@@ -31,7 +31,7 @@ describe('Jest', () => {
     const results = await runCLIAsync(`test ${name} --skip-nx-cache`, {
       silenceError: true,
       env: {
-        ...process.env, // need to set this for some reason, or else get "env: node: No such file or directory"
+        ...getStrippedEnvironmentVariables(),
         NODE_ENV: 'foobar',
       },
     });

e2e/maven/src/utils/create-maven-project.ts

@@ -14,7 +14,7 @@ import {
   unlinkSync,
   chmodSync,
 } from 'fs';
-import * as extract from 'extract-zip';
+import extract from 'extract-zip';
 
 async function downloadFile(
   url: string,