@nx/devkit 23.0.0-beta.2 → 23.0.0-beta.20

package/{src → dist/src}/generators/update-ts-configs-to-js.d.ts

@@ -2,4 +2,3 @@ import { Tree } from 'nx/src/devkit-exports';
 export declare function updateTsConfigsToJs(tree: Tree, options: {
     projectRoot: string;
 }): void;
-//# sourceMappingURL=update-ts-configs-to-js.d.ts.map

package/{src → dist/src}/generators/visit-not-ignored-files.d.ts

@@ -3,4 +3,3 @@ import type { Tree } from 'nx/src/devkit-exports';
  * Utility to act on all files in a tree that are not ignored by git.
  */
 export declare function visitNotIgnoredFiles(tree: Tree, dirPath: string, visitor: (path: string) => void): void;
-//# sourceMappingURL=visit-not-ignored-files.d.ts.map

package/dist/src/migrations/update-23-0-0/update-deep-imports.d.ts

@@ -0,0 +1,4 @@
+import { type Tree } from 'nx/src/devkit-exports';
+export declare const DEVKIT_INTERNAL_SYMBOLS: ReadonlySet<string>;
+export default function updateDevkitDeepImports(tree: Tree): Promise<void>;
+export declare function rewriteDevkitDeepImports(source: string): string;

package/dist/src/migrations/update-23-0-0/update-deep-imports.js

@@ -0,0 +1,323 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEVKIT_INTERNAL_SYMBOLS = void 0;
+exports.default = updateDevkitDeepImports;
+exports.rewriteDevkitDeepImports = rewriteDevkitDeepImports;
+const devkit_exports_1 = require("nx/src/devkit-exports");
+const format_files_1 = require("../../generators/format-files");
+const visit_not_ignored_files_1 = require("../../generators/visit-not-ignored-files");
+const package_json_1 = require("../../utils/package-json");
+const string_change_1 = require("../../utils/string-change");
+const versions_1 = require("../../utils/versions");
+const TS_EXTENSIONS = ['.ts', '.tsx', '.cts', '.mts'];
+const DEEP_IMPORT_PREFIX = '@nx/devkit/src/';
+const PUBLIC_SPECIFIER = '@nx/devkit';
+const INTERNAL_SPECIFIER = '@nx/devkit/internal';
+// Names re-exported from `@nx/devkit/internal` (see packages/devkit/internal.ts
+// at the time this migration was authored). Anything imported from a
+// `@nx/devkit/src/...` path whose name is NOT in this set is assumed to be
+// part of the stable public `@nx/devkit` API.
+exports.DEVKIT_INTERNAL_SYMBOLS = new Set([
+    'signalToCode',
+    'createProjectRootMappingsFromProjectConfigurations',
+    'PluginCache',
+    'safeWriteFileCache',
+    'determineArtifactNameAndDirectoryOptions',
+    'getRelativeCwd',
+    'FileExtensionType',
+    'getE2EWebServerInfo',
+    'E2EWebServerDetails',
+    'forEachExecutorOptions',
+    'AggregatedLog',
+    'migrateProjectExecutorsToPlugin',
+    'migrateProjectExecutorsToPluginV1',
+    'NoTargetsToMigrateError',
+    'InferredTargetConfiguration',
+    'processTargetOutputs',
+    'deleteMatchingProperties',
+    'toProjectRelativePath',
+    'determineProjectNameAndRootOptions',
+    'ensureRootProjectName',
+    'resolveImportPath',
+    'promptWhenInteractive',
+    'addBuildTargetDefaults',
+    'addE2eCiTargetDefaults',
+    'addPlugin',
+    'createAsyncIterable',
+    'combineAsyncIterables',
+    'mapAsyncIterable',
+    'calculateHashForCreateNodes',
+    'calculateHashesForCreateNodes',
+    'getCatalogManager',
+    'loadConfigFile',
+    'clearRequireCache',
+    'findPluginForConfigFile',
+    'getNamedInputs',
+    'logShowProjectCommand',
+    'eachValueFrom',
+    'checkAndCleanWithSemver',
+    'camelize',
+    'capitalize',
+    'classify',
+    'dasherize',
+    'emitPluginWorkerLog',
+    'throwForUnsupportedVersion',
+]);
+// Methods on `jest` and `vi` that take a module specifier as their first
+// argument. Calls like `jest.mock('@nx/devkit/src/...')` are rewritten so the
+// mock target lines up with the rewritten import.
+const MOCK_HELPER_METHODS = new Set([
+    'mock',
+    'unmock',
+    'doMock',
+    'dontMock',
+    'requireActual',
+    'requireMock',
+    'importActual',
+    'importMock',
+]);
+let ts;
+async function updateDevkitDeepImports(tree) {
+    let touchedCount = 0;
+    (0, visit_not_ignored_files_1.visitNotIgnoredFiles)(tree, '.', (filePath) => {
+        if (!TS_EXTENSIONS.some((ext) => filePath.endsWith(ext))) {
+            return;
+        }
+        const original = tree.read(filePath, 'utf-8');
+        if (!original || !original.includes(DEEP_IMPORT_PREFIX)) {
+            return;
+        }
+        const updated = rewriteDevkitDeepImports(original);
+        if (updated !== original) {
+            tree.write(filePath, updated);
+            touchedCount += 1;
+        }
+    });
+    if (touchedCount > 0) {
+        devkit_exports_1.logger.info(`Rewrote @nx/devkit deep imports in ${touchedCount} file(s).`);
+    }
+    await (0, format_files_1.formatFiles)(tree);
+}
+function rewriteDevkitDeepImports(source) {
+    ts ??= (0, package_json_1.ensurePackage)('typescript', versions_1.typescriptVersion);
+    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))
+            continue;
+        if (!ts.isStringLiteral(stmt.moduleSpecifier))
+            continue;
+        if (!stmt.moduleSpecifier.text.startsWith(DEEP_IMPORT_PREFIX))
+            continue;
+        const replacement = buildReplacement(stmt, sourceFile);
+        changes.push({
+            type: string_change_1.ChangeType.Delete,
+            start: stmt.getStart(sourceFile),
+            length: stmt.getEnd() - stmt.getStart(sourceFile),
+        }, {
+            type: string_change_1.ChangeType.Insert,
+            index: stmt.getStart(sourceFile),
+            text: replacement,
+        });
+    }
+    // Pass 2: rewrite `require('@nx/devkit/src/...')`, dynamic
+    // `import('@nx/devkit/src/...')`, and `jest.mock(...)` / `vi.mock(...)`-style
+    // calls. We can't bucket these by symbol (no named binding to inspect), so
+    // we route them at `/internal` as a best guess. Walking the AST instead of
+    // string-replacing keeps us out of unrelated string literals — template
+    // strings, `typeof import('...')` type queries, comments, etc.
+    collectCallExpressionRewrites(sourceFile, changes);
+    let updated = changes.length > 0 ? (0, string_change_1.applyChangesToString)(source, changes) : source;
+    // Final pass: collapse any duplicate `@nx/devkit` and `@nx/devkit/internal`
+    // named-only imports into a single declaration. This handles both the
+    // imports we just emitted AND any that the user already had, so we never
+    // leave the file with two `from '@nx/devkit'` lines.
+    updated = collapseDevkitImports(updated);
+    return updated;
+}
+function collapseDevkitImports(source) {
+    const sourceFile = ts.createSourceFile('tmp.ts', source, ts.ScriptTarget.Latest, 
+    /* setParentNodes */ true, ts.ScriptKind.TSX);
+    const groups = new Map();
+    for (const stmt of sourceFile.statements) {
+        if (!ts.isImportDeclaration(stmt))
+            continue;
+        if (!ts.isStringLiteral(stmt.moduleSpecifier))
+            continue;
+        const specifier = stmt.moduleSpecifier.text;
+        if (specifier !== PUBLIC_SPECIFIER && specifier !== INTERNAL_SPECIFIER) {
+            continue;
+        }
+        const importClause = stmt.importClause;
+        if (!importClause)
+            continue; // skip side-effect imports
+        if (importClause.name)
+            continue; // skip default imports
+        const namedBindings = importClause.namedBindings;
+        if (!namedBindings || !ts.isNamedImports(namedBindings))
+            continue;
+        const typeOnly = !!importClause.isTypeOnly;
+        const key = `${specifier}\x00${typeOnly ? 'type' : 'value'}`;
+        if (!groups.has(key)) {
+            groups.set(key, { decls: [], specifier, typeOnly });
+        }
+        groups.get(key).decls.push(stmt);
+    }
+    const changes = [];
+    for (const { decls, specifier, typeOnly } of groups.values()) {
+        if (decls.length < 2)
+            continue;
+        const seen = new Set();
+        const merged = [];
+        for (const decl of decls) {
+            const named = decl.importClause.namedBindings;
+            for (const el of named.elements) {
+                const text = renderSpecifierFromNode(el, typeOnly);
+                if (!seen.has(text)) {
+                    seen.add(text);
+                    merged.push(text);
+                }
+            }
+        }
+        // Replace the first declaration with the merged one in place.
+        const first = decls[0];
+        changes.push({
+            type: string_change_1.ChangeType.Delete,
+            start: first.getStart(sourceFile),
+            length: first.getEnd() - first.getStart(sourceFile),
+        }, {
+            type: string_change_1.ChangeType.Insert,
+            index: first.getStart(sourceFile),
+            text: renderImport(merged, specifier, typeOnly),
+        });
+        // Delete every other declaration in this group (and consume one trailing
+        // newline so we don't leave behind a blank line that prettier has to clean
+        // up later).
+        for (let i = 1; i < decls.length; i++) {
+            const decl = decls[i];
+            const start = decl.getStart(sourceFile);
+            let end = decl.getEnd();
+            if (source[end] === '\n') {
+                end += 1;
+            }
+            else if (source[end] === '\r' && source[end + 1] === '\n') {
+                end += 2;
+            }
+            changes.push({
+                type: string_change_1.ChangeType.Delete,
+                start,
+                length: end - start,
+            });
+        }
+    }
+    return changes.length > 0 ? (0, string_change_1.applyChangesToString)(source, changes) : source;
+}
+function renderSpecifierFromNode(el, parentIsTypeOnly) {
+    const aliasText = el.propertyName ? ` as ${el.name.text}` : '';
+    const typePrefix = !parentIsTypeOnly && el.isTypeOnly ? 'type ' : '';
+    return `${typePrefix}${(el.propertyName ?? el.name).text}${aliasText}`;
+}
+function buildReplacement(decl, sourceFile) {
+    const importClause = decl.importClause;
+    // `import '@nx/devkit/src/...';` (side-effect) — no clause to bucket.
+    if (!importClause) {
+        return `import '${INTERNAL_SPECIFIER}';`;
+    }
+    const namedBindings = importClause.namedBindings;
+    const isNamedImport = namedBindings && ts.isNamedImports(namedBindings) && !importClause.name;
+    // Default / namespace / mixed-default-and-named — can't bucket reliably.
+    // Preserve the import shape, swap the specifier.
+    if (!isNamedImport) {
+        const before = source(decl, sourceFile).slice(0, decl.moduleSpecifier.getStart(sourceFile) - decl.getStart(sourceFile));
+        const after = source(decl, sourceFile).slice(decl.moduleSpecifier.getEnd() - decl.getStart(sourceFile));
+        return `${before}'${INTERNAL_SPECIFIER}'${after}`;
+    }
+    const isTypeOnlyImport = importClause.isTypeOnly;
+    const elements = namedBindings.elements;
+    const publik = [];
+    const internal = [];
+    for (const el of elements) {
+        bucketSpecifier(el, isTypeOnlyImport, publik, internal);
+    }
+    const lines = [];
+    if (publik.length > 0) {
+        lines.push(renderImport(publik, PUBLIC_SPECIFIER, isTypeOnlyImport));
+    }
+    if (internal.length > 0) {
+        lines.push(renderImport(internal, INTERNAL_SPECIFIER, isTypeOnlyImport));
+    }
+    if (lines.length === 0) {
+        // Defensive: empty `import {} from '...'` — point at /internal.
+        lines.push(`import {} from '${INTERNAL_SPECIFIER}';`);
+    }
+    return lines.join('\n');
+}
+function bucketSpecifier(el, parentIsTypeOnly, publik, internal) {
+    const lookupName = (el.propertyName ?? el.name).text;
+    const elementIsTypeOnly = el.isTypeOnly;
+    const aliasText = el.propertyName ? ` as ${el.name.text}` : '';
+    // Inline `type` is illegal when the parent import is already `import type`.
+    const typePrefix = !parentIsTypeOnly && elementIsTypeOnly ? 'type ' : '';
+    const text = `${typePrefix}${(el.propertyName ?? el.name).text}${aliasText}`;
+    if (exports.DEVKIT_INTERNAL_SYMBOLS.has(lookupName)) {
+        internal.push(text);
+    }
+    else {
+        publik.push(text);
+    }
+}
+function renderImport(specifiers, from, typeOnly) {
+    const prefix = typeOnly ? 'import type' : 'import';
+    return `${prefix} { ${specifiers.join(', ')} } from '${from}';`;
+}
+function source(decl, sourceFile) {
+    return sourceFile.text.slice(decl.getStart(sourceFile), decl.getEnd());
+}
+function collectCallExpressionRewrites(sourceFile, changes) {
+    const visit = (node) => {
+        if (ts.isCallExpression(node) &&
+            shouldRewriteCallExpression(node) &&
+            node.arguments.length >= 1 &&
+            ts.isStringLiteral(node.arguments[0]) &&
+            node.arguments[0].text.startsWith(DEEP_IMPORT_PREFIX)) {
+            const arg = node.arguments[0];
+            const start = arg.getStart(sourceFile);
+            const end = arg.getEnd();
+            const quote = sourceFile.text.charAt(start);
+            changes.push({
+                type: string_change_1.ChangeType.Delete,
+                start,
+                length: end - start,
+            }, {
+                type: string_change_1.ChangeType.Insert,
+                index: start,
+                text: `${quote}${INTERNAL_SPECIFIER}${quote}`,
+            });
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(sourceFile);
+}
+function shouldRewriteCallExpression(call) {
+    const callee = call.expression;
+    // `require('...')`
+    if (ts.isIdentifier(callee) && callee.text === 'require')
+        return true;
+    // dynamic `import('...')` — the runtime form parses as a CallExpression
+    // whose callee is the `import` keyword. The type-position form
+    // (`typeof import('...')`) parses as `ImportTypeNode`, not a CallExpression,
+    // so we don't touch it.
+    if (callee.kind === ts.SyntaxKind.ImportKeyword)
+        return true;
+    // `jest.mock(...)` / `vi.mock(...)` and friends.
+    if (ts.isPropertyAccessExpression(callee)) {
+        const obj = callee.expression;
+        if (ts.isIdentifier(obj) &&
+            (obj.text === 'jest' || obj.text === 'vi') &&
+            MOCK_HELPER_METHODS.has(callee.name.text)) {
+            return true;
+        }
+    }
+    return false;
+}

package/dist/src/migrations/update-23-0-0/update-deep-imports.md

@@ -0,0 +1,43 @@
+#### Update `@nx/devkit` deep imports
+
+`@nx/devkit` now ships a strict `exports` map, so deep imports like `@nx/devkit/src/utils/...` and `@nx/devkit/src/generators/...` are no longer reachable through Node module resolution.
+
+This migration scans every `.ts`, `.tsx`, `.cts`, and `.mts` file in your workspace and rewrites those deep imports to one of the supported entry points:
+
+- Symbols that are part of the stable `@nx/devkit` public API are routed to `@nx/devkit`.
+- Symbols that were previously only reachable through deep imports are routed to `@nx/devkit/internal`.
+
+After rewriting, the migration **collapses duplicate imports** so a file never ends up with two `import ... from '@nx/devkit'` (or `@nx/devkit/internal`) lines — including merging into any matching import you already had.
+
+#### Sample Code Changes
+
+##### Before
+
+```ts
+import { Tree } from '@nx/devkit';
+import { dasherize, names } from '@nx/devkit/src/utils/string-utils';
+import { addPlugin } from '@nx/devkit/src/utils/add-plugin';
+```
+
+##### After
+
+```ts
+import { Tree, names } from '@nx/devkit';
+import { dasherize, addPlugin } from '@nx/devkit/internal';
+```
+
+`names` was already in the public API, so it joins the existing `@nx/devkit` import. `dasherize` and `addPlugin` move to `@nx/devkit/internal`, and the two `/internal` imports are collapsed into one.
+
+#### Fallback for non-named imports
+
+For deep-import shapes that can't be split by symbol — default imports, namespace imports, side-effect imports, `require(...)` calls, dynamic `import(...)`, and `jest.mock(...)` / `vi.mock(...)`-style mock-helper calls — the migration rewrites the specifier to `@nx/devkit/internal` as a best guess, since most symbols that previously lived under `@nx/devkit/src/...` ended up there.
+
+```ts
+// Before
+const { dasherize } = require('@nx/devkit/src/utils/string-utils');
+
+// After
+const { dasherize } = require('@nx/devkit/internal');
+```
+
+If the symbol you're after is part of the stable public API instead, the rewritten import will fail to resolve against `@nx/devkit/internal` — switch it to `@nx/devkit` by hand. The migration also leaves `typeof import('@nx/devkit/src/...')` type queries and any deep-import strings inside template literals or comments untouched, so you'll need to update those by hand.

package/{src → dist/src}/tasks/install-packages-task.d.ts

@@ -8,4 +8,3 @@ import { PackageManager, Tree } from 'nx/src/devkit-exports';
  * unless install already ran this generator cycle.
  */
 export declare function installPackagesTask(tree: Tree, ensureInstall?: boolean, cwd?: string, packageManager?: PackageManager): void;
-//# sourceMappingURL=install-packages-task.d.ts.map

package/{src → dist/src}/utils/add-plugin.d.ts

@@ -11,4 +11,3 @@ export declare function addPlugin<PluginOptions>(tree: Tree, graph: ProjectGraph
  */
 export declare function addPluginV1<PluginOptions>(tree: Tree, graph: ProjectGraph, pluginName: string, createNodesTuple: CreateNodesV2<PluginOptions>, options: Partial<Record<keyof PluginOptions, PluginOptions[keyof PluginOptions][]>>, shouldUpdatePackageJsonScripts: boolean): Promise<void>;
 export declare function generateCombinations<T>(input: Record<string, T[]>): Record<string, T>[];
-//# sourceMappingURL=add-plugin.d.ts.map

package/{src → dist/src}/utils/async-iterable/combine-async-iterables.d.ts

@@ -1,4 +1,3 @@
 export declare function combineAsyncIterables<T = any>(..._iterators: {
     0: AsyncIterable<T>;
 } & AsyncIterable<T>[]): AsyncGenerator<T>;
-//# sourceMappingURL=combine-async-iterables.d.ts.map

package/{src → dist/src}/utils/async-iterable/create-async-iterable.d.ts

@@ -5,4 +5,3 @@ export interface AsyncPushCallbacks<T> {
     registerCleanup?: (cb: () => void | Promise<void>) => void;
 }
 export declare function createAsyncIterable<T = unknown>(listener: (ls: AsyncPushCallbacks<T>) => void): AsyncIterable<T>;
-//# sourceMappingURL=create-async-iterable.d.ts.map

package/{src → dist/src}/utils/async-iterable/index.d.ts

@@ -2,4 +2,3 @@ export * from './create-async-iterable';
 export * from './combine-async-iterables';
 export * from './map-async-iteratable';
 export * from './tap-async-iteratable';
-//# sourceMappingURL=index.d.ts.map

package/{src → dist/src}/utils/async-iterable/map-async-iteratable.d.ts

@@ -1,2 +1 @@
 export declare function mapAsyncIterable<T = any, I = any, O = any>(data: AsyncIterable<T> | AsyncIterableIterator<T>, transform: (input: I, index?: number, data?: AsyncIterable<T> | AsyncIterableIterator<T>) => O): AsyncIterable<O> | AsyncIterableIterator<O>;
-//# sourceMappingURL=map-async-iteratable.d.ts.map

package/{src → dist/src}/utils/async-iterable/tap-async-iteratable.d.ts

@@ -1,2 +1 @@
 export declare function tapAsyncIterable<T = any, I = any, O = any>(data: AsyncIterable<T> | AsyncIterableIterator<T>, fn: (input: I) => void): AsyncIterable<T> | AsyncIterableIterator<T>;
-//# sourceMappingURL=tap-async-iteratable.d.ts.map

package/{src → dist/src}/utils/binary-extensions.d.ts

@@ -1,2 +1 @@
 export declare function isBinaryPath(path: string): boolean;
-//# sourceMappingURL=binary-extensions.d.ts.map

package/{src → dist/src}/utils/calculate-hash-for-create-nodes.d.ts

@@ -1,4 +1,8 @@
 import { CreateNodesContextV2 } from 'nx/src/devkit-exports';
+/**
+ * @deprecated Use {@link calculateHashesForCreateNodes} instead, which batches
+ * workspace-context hashing across multiple project roots in a single call.
+ * This will be removed in Nx 24.
+ */
 export declare function calculateHashForCreateNodes(projectRoot: string, options: object, context: CreateNodesContextV2, additionalGlobs?: string[]): Promise<string>;
 export declare function calculateHashesForCreateNodes(projectRoots: string[], options: object, context: CreateNodesContextV2, additionalGlobs?: string[][]): Promise<string[]>;
-//# sourceMappingURL=calculate-hash-for-create-nodes.d.ts.map

package/{src → dist/src}/utils/calculate-hash-for-create-nodes.js

@@ -5,6 +5,11 @@ exports.calculateHashesForCreateNodes = calculateHashesForCreateNodes;
 const path_1 = require("path");
 const devkit_exports_1 = require("nx/src/devkit-exports");
 const devkit_internals_1 = require("nx/src/devkit-internals");
+/**
+ * @deprecated Use {@link calculateHashesForCreateNodes} instead, which batches
+ * workspace-context hashing across multiple project roots in a single call.
+ * This will be removed in Nx 24.
+ */
 async function calculateHashForCreateNodes(projectRoot, options, context, additionalGlobs = []) {
     return (0, devkit_exports_1.hashArray)([
         await (0, devkit_internals_1.hashWithWorkspaceContext)(context.workspaceRoot, [
@@ -15,14 +20,16 @@ async function calculateHashForCreateNodes(projectRoot, options, context, additi
     ]);
 }
 async function calculateHashesForCreateNodes(projectRoots, options, context, additionalGlobs = []) {
+    if (projectRoots.length === 0) {
+        return [];
+    }
     if (additionalGlobs.length &&
         additionalGlobs.length !== projectRoots.length) {
-        throw new Error('If additionalGlobs is provided, it must be the same length as projectRoots');
+        throw new Error(`calculateHashesForCreateNodes: projectRoots.length (${projectRoots.length}) !== additionalGlobs.length (${additionalGlobs.length})`);
     }
-    return (0, devkit_internals_1.hashMultiGlobWithWorkspaceContext)(context.workspaceRoot, projectRoots.map((projectRoot, idx) => [
+    const hashes = await (0, devkit_internals_1.hashMultiGlobWithWorkspaceContext)(context.workspaceRoot, projectRoots.map((projectRoot, idx) => [
         (0, path_1.join)(projectRoot, '**/*'),
         ...(additionalGlobs.length ? additionalGlobs[idx] : []),
-    ])).then((hashes) => {
-        return hashes.map((hash) => (0, devkit_exports_1.hashArray)([hash, (0, devkit_internals_1.hashObject)(options)]));
-    });
+    ]));
+    return hashes.map((hash) => (0, devkit_exports_1.hashArray)([hash, (0, devkit_internals_1.hashObject)(options)]));
 }

package/{src → dist/src}/utils/catalog/index.d.ts

@@ -7,4 +7,3 @@ export { type CatalogManager, getCatalogManager };
  * Returns Map of package name -> catalog name (undefined for default catalog)
  */
 export declare function getCatalogDependenciesFromPackageJson(tree: Tree, packageJsonPath: string, manager: CatalogManager): Map<string, string | undefined>;
-//# sourceMappingURL=index.d.ts.map

package/{src → dist/src}/utils/catalog/manager-factory.d.ts

@@ -3,4 +3,3 @@ import type { CatalogManager } from './manager';
  * Factory function to get the appropriate catalog manager based on the package manager
  */
 export declare function getCatalogManager(workspaceRoot: string): CatalogManager | null;
-//# sourceMappingURL=manager-factory.d.ts.map

package/{src → dist/src}/utils/catalog/manager.d.ts

@@ -38,4 +38,3 @@ export interface CatalogManager {
         catalogName?: string;
     }>): void;
 }
-//# sourceMappingURL=manager.d.ts.map

package/{src → dist/src}/utils/catalog/pnpm-manager.d.ts

@@ -19,4 +19,3 @@ export declare class PnpmCatalogManager implements CatalogManager {
         catalogName?: string;
     }>): void;
 }
-//# sourceMappingURL=pnpm-manager.d.ts.map

package/{src → dist/src}/utils/catalog/types.d.ts

@@ -9,4 +9,3 @@ export interface CatalogDefinitions {
     catalog?: CatalogEntry;
     catalogs?: Record<string, CatalogEntry>;
 }
-//# sourceMappingURL=types.d.ts.map

package/{src → dist/src}/utils/catalog/yarn-manager.d.ts

@@ -19,4 +19,3 @@ export declare class YarnCatalogManager implements CatalogManager {
         catalogName?: string;
     }>): void;
 }
-//# sourceMappingURL=yarn-manager.d.ts.map

package/{src → dist/src}/utils/config-utils.d.ts

@@ -3,4 +3,3 @@ export declare function loadConfigFile<T extends object = any>(configFilePath: s
 export declare function getRootTsConfigPath(): string | null;
 export declare function getRootTsConfigFileName(): string | null;
 export declare function clearRequireCache(): void;
-//# sourceMappingURL=config-utils.d.ts.map

package/{src → dist/src}/utils/config-utils.js

@@ -27,16 +27,71 @@ function isTypeScriptFile(extension) {
 }
 async function loadTypeScriptModule(path, extension, tsconfigFileNames) {
     const tsConfigPath = getTypeScriptConfigPath(path, tsconfigFileNames);
-    if (tsConfigPath) {
-        const unregisterTsProject = (0, devkit_internals_1.registerTsProject)(tsConfigPath);
+    if (!tsConfigPath) {
+        return await loadModuleByExtension(path, extension);
+    }
+    // loadTsFile was added in nx@23. @nx/devkit's peer range supports older
+    // nx majors, so fall back to the legacy registerTsProject + require path
+    // when loadTsFile isn't available on the host nx.
+    if (typeof devkit_internals_1.loadTsFile !== 'function') {
+        const cleanup = (0, devkit_internals_1.registerTsProject)(tsConfigPath);
         try {
             return await loadModuleByExtension(path, extension);
         }
         finally {
-            unregisterTsProject();
+            cleanup();
+        }
+    }
+    // Both .ts and .mts go through loadTsFile first. Node 22.12+ supports
+    // require() of synchronous ESM by default, and loadTsFile's lazy fallback
+    // covers swc/ts-node + tsconfig-paths registration when needed (swc-node
+    // hooks .cts/.mts/.ts via Module._extensions). Async-only ESM modules
+    // (top-level await) throw ERR_REQUIRE_ASYNC_MODULE and fall through to
+    // dynamic import(). ERR_REQUIRE_ESM is the legacy code for the same case
+    // - kept for older Node lines.
+    try {
+        return (0, devkit_internals_1.loadTsFile)(path, tsConfigPath);
+    }
+    catch (e) {
+        if (e?.code !== 'ERR_REQUIRE_ESM' &&
+            e?.code !== 'ERR_REQUIRE_ASYNC_MODULE') {
+            throw e;
+        }
+        // The module must be loaded via dynamic import(). Register
+        // tsconfig-paths first so workspace alias imports resolve, then try a
+        // native dynamic import. Node 22.18+ LTS strips TS types on the ESM
+        // path natively, so pure-ESM TLA configs load without any swc/ts-node
+        // ESM loader. Only escalate to forceRegisterEsmLoader (which throws
+        // when neither @swc-node/register nor ts-node is installed) if the
+        // native attempt hits unsupported TS syntax.
+        const cleanup = (0, devkit_internals_1.registerTsProject)(tsConfigPath);
+        try {
+            return await loadESM(path);
+        }
+        catch (esmErr) {
+            if (esmErr?.code !== 'ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX' ||
+                typeof devkit_internals_1.forceRegisterEsmLoader !== 'function') {
+                throw esmErr;
+            }
+            // Module.register is global and one-shot per process. After this
+            // runs, every subsequent ESM import in the process is routed
+            // through the registered loader, forfeiting Node's native TS
+            // stripping for the dynamic-import path. If neither swc-node nor
+            // ts-node is installed, forceRegisterEsmLoader throws - surface the
+            // original ESM error in that case so the user sees the real
+            // problem, not a misleading "loader missing" message.
+            try {
+                (0, devkit_internals_1.forceRegisterEsmLoader)();
+            }
+            catch {
+                throw esmErr;
+            }
+            return await loadESM(path);
+        }
+        finally {
+            cleanup();
         }
     }
-    return await loadModuleByExtension(path, extension);
 }
 function getTypeScriptConfigPath(path, tsconfigFileNames) {
     const siblingFiles = (0, fs_1.readdirSync)((0, path_1.dirname)(path));

package/{src → dist/src}/utils/convert-nx-executor.d.ts

@@ -5,4 +5,3 @@ import type { Executor } from 'nx/src/devkit-exports';
  * Use this to expose a compatible Angular Builder
  */
 export declare function convertNxExecutor(executor: Executor): any;
-//# sourceMappingURL=convert-nx-executor.d.ts.map

package/{src → dist/src}/utils/find-plugin-for-config-file.d.ts

@@ -1,3 +1,2 @@
 import { type Tree, type PluginConfiguration } from 'nx/src/devkit-exports';
 export declare function findPluginForConfigFile(tree: Tree, pluginName: string, pathToConfigFile: string): Promise<PluginConfiguration>;
-//# sourceMappingURL=find-plugin-for-config-file.d.ts.map

package/dist/src/utils/find-plugin-for-config-file.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findPluginForConfigFile = findPluginForConfigFile;
+const devkit_exports_1 = require("nx/src/devkit-exports");
+const devkit_internals_1 = require("nx/src/devkit-internals");
+async function findPluginForConfigFile(tree, pluginName, pathToConfigFile) {
+    const nxJson = (0, devkit_exports_1.readNxJson)(tree);
+    if (!nxJson.plugins) {
+        return;
+    }
+    const pluginRegistrations = nxJson.plugins.filter((p) => (typeof p === 'string' ? p === pluginName : p.plugin === pluginName));
+    for (const plugin of pluginRegistrations) {
+        if (typeof plugin === 'string') {
+            return plugin;
+        }
+        if (!plugin.include && !plugin.exclude) {
+            return plugin;
+        }
+        if (plugin.include || plugin.exclude) {
+            const resolvedPlugin = await import(pluginName);
+            const pluginGlob = resolvedPlugin.createNodesV2?.[0] ?? resolvedPlugin.createNodes?.[0];
+            const matchingConfigFile = (0, devkit_internals_1.findMatchingConfigFiles)([pathToConfigFile], pluginGlob, plugin.include, plugin.exclude);
+            if (matchingConfigFile.length) {
+                return plugin;
+            }
+        }
+    }
+}

package/{src → dist/src}/utils/get-named-inputs.d.ts

@@ -6,4 +6,3 @@ import { CreateNodesContextV2 } from 'nx/src/devkit-exports';
 export declare function getNamedInputs(directory: string, context: CreateNodesContextV2): {
     [inputName: string]: (string | InputDefinition)[];
 };
-//# sourceMappingURL=get-named-inputs.d.ts.map

package/{src → dist/src}/utils/get-workspace-layout.d.ts

@@ -22,4 +22,3 @@ export declare function extractLayoutDirectory(directory?: string): {
     layoutDirectory: string | null;
     projectDirectory?: string;
 };
-//# sourceMappingURL=get-workspace-layout.d.ts.map