@aws/nx-plugin 1.0.0-rc.8 → 1.0.0-rc.80

package/src/ts/lib/generator.js

@@ -1,120 +1,127 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.tsProjectGenerator = exports.getTsLibDetails = exports.TS_LIB_GENERATOR_INFO = void 0;
 /**
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
- */
-const devkit_1 = require("@nx/devkit");
-const js_1 = require("@nx/js");
-const format_1 = require("../../utils/format");
-const metrics_1 = require("../../utils/metrics");
-const names_1 = require("../../utils/names");
-const npm_scope_1 = require("../../utils/npm-scope");
-const nx_1 = require("../../utils/nx");
-const object_1 = require("../../utils/object");
-const pkg_manager_1 = require("../../utils/pkg-manager");
-const ts_project_utils_1 = require("./ts-project-utils");
-exports.TS_LIB_GENERATOR_INFO = (0, nx_1.getGeneratorInfo)(__filename);
+ */ import { generateFiles, joinPathFragments, OverwriteStrategy, readProjectConfiguration, updateJson, updateProjectConfiguration } from "@nx/devkit";
+import { libraryGenerator } from "@nx/js";
+import { declareDependencies } from "../../utils/declared-dependencies.js";
+import { formatFilesInSubtree } from "../../utils/format.js";
+import { installDependencies } from "../../utils/install.js";
+import { addGeneratorMetricsIfApplicable } from "../../utils/metrics.js";
+import { isEsmWorkspace } from "../../utils/module-format.js";
+import { toKebabCase } from "../../utils/names.js";
+import { getNpmScopePrefix } from "../../utils/npm-scope.js";
+import { addGeneratorMetadata, getGeneratorInfo, mergeTargetDefault, projectExists } from "../../utils/nx.js";
+import { sortObjectKeys } from "../../utils/object.js";
+import { getPackageManagerDisplayCommands } from "../../utils/pkg-manager.js";
+import { configureTsProject } from "./ts-project-utils.js";
+import { VITEST_DEPENDENCIES } from "./vitest.js";
+export const DEPENDENCIES = declareDependencies()({
+    ts: [
+        ...VITEST_DEPENDENCIES
+    ]
+});
+export const TS_LIB_GENERATOR_INFO = getGeneratorInfo(import.meta.filename);
 /**
  * Returns details about the TS library to be created
- */
-const getTsLibDetails = (tree, schema) => {
-    const scope = (0, npm_scope_1.getNpmScopePrefix)(tree);
-    const normalizedName = (0, names_1.toKebabCase)(schema.name);
+ */ export const getTsLibDetails = (tree, schema)=>{
+    const scope = getNpmScopePrefix(tree);
+    const normalizedName = toKebabCase(schema.name);
     const fullyQualifiedName = `${scope}${normalizedName}`;
     // NB: interactive nx generator cli can pass empty string
-    const dir = (0, devkit_1.joinPathFragments)(schema.directory || '.', schema.subDirectory || normalizedName);
-    return { dir, fullyQualifiedName };
+    const dir = joinPathFragments(schema.directory || '.', schema.subDirectory || normalizedName);
+    return {
+        dir,
+        fullyQualifiedName
+    };
 };
-exports.getTsLibDetails = getTsLibDetails;
 /**
  * Generates a typescript project
- */
-const tsProjectGenerator = async (tree, schema) => {
-    const { fullyQualifiedName, dir } = (0, exports.getTsLibDetails)(tree, schema);
-    await (0, js_1.libraryGenerator)(tree, {
-        ...schema,
-        name: fullyQualifiedName,
-        directory: dir,
-        skipPackageJson: true,
-        bundler: 'tsc', // TODO: consider supporting others
-        linter: 'none',
-        unitTestRunner: 'vitest',
-    });
-    // Replace with simpler sample source code
-    tree.delete((0, devkit_1.joinPathFragments)(dir, 'src'));
-    (0, devkit_1.generateFiles)(tree, (0, devkit_1.joinPathFragments)(__dirname, 'files'), (0, devkit_1.joinPathFragments)(dir), {
-        fullyQualifiedName,
-        pkgMgrCmd: (0, pkg_manager_1.getPackageManagerDisplayCommands)().exec,
-    }, {
-        overwriteStrategy: devkit_1.OverwriteStrategy.KeepExisting,
-    });
-    await (0, ts_project_utils_1.configureTsProject)(tree, {
+ */ export const tsProjectGenerator = async (tree, schema)=>{
+    const { fullyQualifiedName, dir } = getTsLibDetails(tree, schema);
+    // The module format is workspace-wide, established by the preset when the
+    // workspace is created, so vending generators always infer it from the tree.
+    const esm = isEsmWorkspace(tree);
+    // Only scaffold the project on first run; on re-run skip creation so user
+    // edits are preserved, but continue to (re)apply the configuration below.
+    if (!projectExists(tree, fullyQualifiedName)) {
+        await libraryGenerator(tree, {
+            ...schema,
+            name: fullyQualifiedName,
+            directory: dir,
+            skipPackageJson: true,
+            bundler: 'tsc',
+            linter: 'none',
+            unitTestRunner: 'vitest',
+            // Register the @nx/vitest plugin so the test target is inferred rather
+            // than emitting the deprecated @nx/vitest:test executor target.
+            addPlugin: true
+        });
+        // Replace with simpler sample source code
+        tree.delete(joinPathFragments(dir, 'src'));
+        generateFiles(tree, joinPathFragments(import.meta.dirname, 'files'), joinPathFragments(dir), {
+            fullyQualifiedName,
+            esm,
+            pkgMgrCmd: getPackageManagerDisplayCommands().exec
+        }, {
+            overwriteStrategy: OverwriteStrategy.KeepExisting
+        });
+    }
+    await configureTsProject(tree, {
         dir,
         fullyQualifiedName,
-    });
-    const projectConfiguration = (0, devkit_1.readProjectConfiguration)(tree, fullyQualifiedName);
+        esm
+    }, DEPENDENCIES);
+    const projectConfiguration = readProjectConfiguration(tree, fullyQualifiedName);
     const targets = projectConfiguration.targets;
     targets['compile'] = {
         executor: 'nx:run-commands',
-        outputs: ['{workspaceRoot}/dist/{projectRoot}/tsc'],
+        outputs: [
+            '{workspaceRoot}/dist/{projectRoot}/tsc'
+        ],
         options: {
             command: 'tsc --build tsconfig.lib.json',
-            cwd: '{projectRoot}',
-        },
+            cwd: '{projectRoot}'
+        }
     };
     targets['build'] = {
-        dependsOn: ['lint', 'compile', 'test'],
+        dependsOn: [
+            'lint',
+            'compile',
+            'test'
+        ]
     };
-    targets['test'] = {
-        executor: '@nx/vitest:test',
-        outputs: ['{options.reportsDirectory}'],
-        options: {
-            reportsDirectory: '{workspaceRoot}/coverage/{projectRoot}',
-        },
-    };
-    projectConfiguration.targets = (0, object_1.sortObjectKeys)(targets);
-    (0, devkit_1.updateProjectConfiguration)(tree, fullyQualifiedName, projectConfiguration);
-    (0, nx_1.addGeneratorMetadata)(tree, fullyQualifiedName, exports.TS_LIB_GENERATOR_INFO);
-    (0, devkit_1.updateJson)(tree, 'nx.json', (nxJson) => {
+    projectConfiguration.targets = sortObjectKeys(targets);
+    updateProjectConfiguration(tree, fullyQualifiedName, projectConfiguration);
+    addGeneratorMetadata(tree, fullyQualifiedName, TS_LIB_GENERATOR_INFO);
+    updateJson(tree, 'nx.json', (nxJson)=>{
         nxJson.namedInputs = {
             ...nxJson.namedInputs,
             default: [
-                ...(nxJson.namedInputs?.default ?? []).filter((input) => typeof input !== 'object' ||
-                    !('dependentTasksOutputFiles' in input) ||
-                    !(input.dependentTasksOutputFiles === '**/*' && input.transitive)),
+                ...(nxJson.namedInputs?.default ?? []).filter((input)=>typeof input !== 'object' || !('dependentTasksOutputFiles' in input) || !(input.dependentTasksOutputFiles === '**/*' && input.transitive)),
                 {
                     dependentTasksOutputFiles: '**/*',
-                    transitive: true,
-                },
-            ],
+                    transitive: true
+                }
+            ]
         };
+        const withDefaultInput = (base)=>({
+                ...base,
+                inputs: [
+                    ...(base.inputs ?? []).filter((i)=>i !== 'default'),
+                    'default'
+                ]
+            });
         nxJson.targetDefaults = {
             ...nxJson.targetDefaults,
-            compile: {
-                cache: true,
-                ...nxJson.targetDefaults?.compile,
-                inputs: [
-                    ...(nxJson.targetDefaults?.compile?.inputs ?? []).filter((i) => i !== 'default'),
-                    'default',
-                ],
-            },
-            build: {
-                cache: true,
-                ...nxJson.targetDefaults?.build,
-                inputs: [
-                    ...(nxJson.targetDefaults?.build?.inputs ?? []).filter((i) => i !== 'default'),
-                    'default',
-                ],
-            },
-            test: {
-                ...nxJson.targetDefaults?.test,
-                inputs: [
-                    ...(nxJson.targetDefaults?.test?.inputs ?? []).filter((i) => i !== 'default'),
-                    'default',
-                ],
-            },
+            compile: mergeTargetDefault(nxJson.targetDefaults?.compile, (base)=>({
+                    cache: true,
+                    ...withDefaultInput(base)
+                })),
+            build: mergeTargetDefault(nxJson.targetDefaults?.build, (base)=>({
+                    cache: true,
+                    ...withDefaultInput(base)
+                })),
+            test: mergeTargetDefault(nxJson.targetDefaults?.test, withDefaultInput)
         };
         // Ensure we only declare a single typescript plugin with the correct settings
         nxJson.plugins = [
@@ -122,28 +129,33 @@ const tsProjectGenerator = async (tree, schema) => {
                 plugin: '@nx/js/typescript',
                 options: {
                     typecheck: {
-                        targetName: 'typecheck',
+                        targetName: 'typecheck'
                     },
                     build: {
                         targetName: 'compile',
                         configName: 'tsconfig.lib.json',
                         buildDepsName: 'build-deps',
-                        watchDepsName: 'watch-deps',
-                    },
-                },
+                        watchDepsName: 'watch-deps'
+                    }
+                }
             },
-            ...(nxJson.plugins ?? []).filter((p) => typeof p === 'string' || p.plugin !== '@nx/js/typescript'),
+            ...(nxJson.plugins ?? []).filter((p)=>typeof p === 'string' || p.plugin !== '@nx/js/typescript')
         ];
         return nxJson;
     });
-    await (0, metrics_1.addGeneratorMetricsIfApplicable)(tree, [exports.TS_LIB_GENERATOR_INFO]);
-    await (0, format_1.formatFilesInSubtree)(tree);
-    return () => {
-        if (!schema.skipInstall) {
-            (0, devkit_1.installPackagesTask)(tree);
-        }
-    };
+    await addGeneratorMetricsIfApplicable(tree, [
+        TS_LIB_GENERATOR_INFO
+    ]);
+    await formatFilesInSubtree(tree);
+    // `installDependencies` ensures vitest resolves for the `typescript` language (the
+    // generated vitest.config.mts imports it and Nx loads that config when
+    // computing the project graph), so a deferred install still runs when needed.
+    return ()=>installDependencies(tree, schema.preferInstallDependencies, {
+            languages: [
+                'typescript'
+            ]
+        });
 };
-exports.tsProjectGenerator = tsProjectGenerator;
-exports.default = exports.tsProjectGenerator;
+export default tsProjectGenerator;
+
 //# sourceMappingURL=generator.js.map

package/src/ts/lib/generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../packages/nx-plugin/src/ts/lib/generator.ts"],"names":[],"mappings":"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"}
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/ts/lib/generator.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport {\n  type GeneratorCallback,\n  generateFiles,\n  joinPathFragments,\n  type NxJsonConfiguration,\n  OverwriteStrategy,\n  readProjectConfiguration,\n  type TargetConfiguration,\n  type Tree,\n  updateJson,\n  updateProjectConfiguration,\n} from '@nx/devkit';\nimport { libraryGenerator } from '@nx/js';\nimport { declareDependencies } from '../../utils/declared-dependencies.js';\nimport { formatFilesInSubtree } from '../../utils/format.js';\nimport { installDependencies } from '../../utils/install.js';\nimport { addGeneratorMetricsIfApplicable } from '../../utils/metrics.js';\nimport { isEsmWorkspace } from '../../utils/module-format.js';\nimport { toKebabCase } from '../../utils/names.js';\nimport { getNpmScopePrefix } from '../../utils/npm-scope.js';\nimport {\n  addGeneratorMetadata,\n  getGeneratorInfo,\n  mergeTargetDefault,\n  type NxGeneratorInfo,\n  projectExists,\n} from '../../utils/nx.js';\nimport { sortObjectKeys } from '../../utils/object.js';\nimport { getPackageManagerDisplayCommands } from '../../utils/pkg-manager.js';\nimport type { TsProjectGeneratorSchema } from './schema';\nimport { configureTsProject } from './ts-project-utils.js';\nimport { VITEST_DEPENDENCIES } from './vitest.js';\n\nexport const DEPENDENCIES = declareDependencies()({\n  ts: [...VITEST_DEPENDENCIES],\n});\n\nexport const TS_LIB_GENERATOR_INFO: NxGeneratorInfo = getGeneratorInfo(\n  import.meta.filename,\n);\n\nexport interface TsLibDetails {\n  /**\n   * Full package name including scope (eg @foo/bar)\n   */\n  readonly fullyQualifiedName: string;\n  /**\n   * Directory of the library relative to the root\n   */\n  readonly dir: string;\n}\n\n/**\n * Returns details about the TS library to be created\n */\nexport const getTsLibDetails = (\n  tree: Tree,\n  schema: TsProjectGeneratorSchema,\n): TsLibDetails => {\n  const scope = getNpmScopePrefix(tree);\n  const normalizedName = toKebabCase(schema.name);\n  const fullyQualifiedName = `${scope}${normalizedName}`;\n  // NB: interactive nx generator cli can pass empty string\n  const dir = joinPathFragments(\n    schema.directory || '.',\n    schema.subDirectory || normalizedName,\n  );\n  return { dir, fullyQualifiedName };\n};\n\n/**\n * Generates a typescript project\n */\nexport const tsProjectGenerator = async (\n  tree: Tree,\n  schema: TsProjectGeneratorSchema,\n): Promise<GeneratorCallback> => {\n  const { fullyQualifiedName, dir } = getTsLibDetails(tree, schema);\n  // The module format is workspace-wide, established by the preset when the\n  // workspace is created, so vending generators always infer it from the tree.\n  const esm = isEsmWorkspace(tree);\n\n  // Only scaffold the project on first run; on re-run skip creation so user\n  // edits are preserved, but continue to (re)apply the configuration below.\n  if (!projectExists(tree, fullyQualifiedName)) {\n    await libraryGenerator(tree, {\n      ...schema,\n      name: fullyQualifiedName,\n      directory: dir,\n      skipPackageJson: true,\n      bundler: 'tsc', // TODO: consider supporting others\n      linter: 'none',\n      unitTestRunner: 'vitest',\n      // Register the @nx/vitest plugin so the test target is inferred rather\n      // than emitting the deprecated @nx/vitest:test executor target.\n      addPlugin: true,\n    });\n\n    // Replace with simpler sample source code\n    tree.delete(joinPathFragments(dir, 'src'));\n    generateFiles(\n      tree,\n      joinPathFragments(import.meta.dirname, 'files'),\n      joinPathFragments(dir),\n      {\n        fullyQualifiedName,\n        esm,\n        pkgMgrCmd: getPackageManagerDisplayCommands().exec,\n      },\n      {\n        overwriteStrategy: OverwriteStrategy.KeepExisting,\n      },\n    );\n  }\n  await configureTsProject(\n    tree,\n    {\n      dir,\n      fullyQualifiedName,\n      esm,\n    },\n    DEPENDENCIES,\n  );\n\n  const projectConfiguration = readProjectConfiguration(\n    tree,\n    fullyQualifiedName,\n  );\n  const targets = projectConfiguration.targets;\n\n  targets['compile'] = {\n    executor: 'nx:run-commands',\n    outputs: ['{workspaceRoot}/dist/{projectRoot}/tsc'],\n    options: {\n      command: 'tsc --build tsconfig.lib.json',\n      cwd: '{projectRoot}',\n    },\n  };\n  targets['build'] = {\n    dependsOn: ['lint', 'compile', 'test'],\n  };\n  projectConfiguration.targets = sortObjectKeys(targets);\n\n  updateProjectConfiguration(tree, fullyQualifiedName, projectConfiguration);\n\n  addGeneratorMetadata(tree, fullyQualifiedName, TS_LIB_GENERATOR_INFO);\n\n  updateJson(tree, 'nx.json', (nxJson: NxJsonConfiguration) => {\n    nxJson.namedInputs = {\n      ...nxJson.namedInputs,\n      default: [\n        ...(nxJson.namedInputs?.default ?? []).filter(\n          (input) =>\n            typeof input !== 'object' ||\n            !('dependentTasksOutputFiles' in input) ||\n            !(input.dependentTasksOutputFiles === '**/*' && input.transitive),\n        ),\n        {\n          dependentTasksOutputFiles: '**/*',\n          transitive: true,\n        },\n      ],\n    };\n\n    const withDefaultInput = (base: Partial<TargetConfiguration>) => ({\n      ...base,\n      inputs: [\n        ...(base.inputs ?? []).filter((i) => i !== 'default'),\n        'default',\n      ],\n    });\n\n    nxJson.targetDefaults = {\n      ...nxJson.targetDefaults,\n      compile: mergeTargetDefault(nxJson.targetDefaults?.compile, (base) => ({\n        cache: true,\n        ...withDefaultInput(base),\n      })),\n      build: mergeTargetDefault(nxJson.targetDefaults?.build, (base) => ({\n        cache: true,\n        ...withDefaultInput(base),\n      })),\n      test: mergeTargetDefault(nxJson.targetDefaults?.test, withDefaultInput),\n    };\n\n    // Ensure we only declare a single typescript plugin with the correct settings\n    nxJson.plugins = [\n      {\n        plugin: '@nx/js/typescript',\n        options: {\n          typecheck: {\n            targetName: 'typecheck',\n          },\n          build: {\n            targetName: 'compile',\n            configName: 'tsconfig.lib.json',\n            buildDepsName: 'build-deps',\n            watchDepsName: 'watch-deps',\n          },\n        },\n      },\n      ...(nxJson.plugins ?? []).filter(\n        (p) => typeof p === 'string' || p.plugin !== '@nx/js/typescript',\n      ),\n    ];\n\n    return nxJson;\n  });\n\n  await addGeneratorMetricsIfApplicable(tree, [TS_LIB_GENERATOR_INFO]);\n\n  await formatFilesInSubtree(tree);\n\n  // `installDependencies` ensures vitest resolves for the `typescript` language (the\n  // generated vitest.config.mts imports it and Nx loads that config when\n  // computing the project graph), so a deferred install still runs when needed.\n  return () =>\n    installDependencies(tree, schema.preferInstallDependencies, {\n      languages: ['typescript'],\n    });\n};\nexport default tsProjectGenerator;\n"],"names":["generateFiles","joinPathFragments","OverwriteStrategy","readProjectConfiguration","updateJson","updateProjectConfiguration","libraryGenerator","declareDependencies","formatFilesInSubtree","installDependencies","addGeneratorMetricsIfApplicable","isEsmWorkspace","toKebabCase","getNpmScopePrefix","addGeneratorMetadata","getGeneratorInfo","mergeTargetDefault","projectExists","sortObjectKeys","getPackageManagerDisplayCommands","configureTsProject","VITEST_DEPENDENCIES","DEPENDENCIES","ts","TS_LIB_GENERATOR_INFO","filename","getTsLibDetails","tree","schema","scope","normalizedName","name","fullyQualifiedName","dir","directory","subDirectory","tsProjectGenerator","esm","skipPackageJson","bundler","linter","unitTestRunner","addPlugin","delete","dirname","pkgMgrCmd","exec","overwriteStrategy","KeepExisting","projectConfiguration","targets","executor","outputs","options","command","cwd","dependsOn","nxJson","namedInputs","default","filter","input","dependentTasksOutputFiles","transitive","withDefaultInput","base","inputs","i","targetDefaults","compile","cache","build","test","plugins","plugin","typecheck","targetName","configName","buildDepsName","watchDepsName","p","preferInstallDependencies","languages"],"mappings":"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"}

package/src/ts/lib/grit/vitest-pass-with-no-tests.grit

@@ -1,7 +1,4 @@
-`test: { $props }` => raw`test: {
-    passWithNoTests: true,
-    $props
-  }` where {
+`test: { $props }` => `test: { passWithNoTests: true, $props }` where {
   $props <: within `defineConfig($_)`,
   $props <: not some `passWithNoTests: $_`
 }

package/src/ts/lib/schema.d.js

@@ -0,0 +1,6 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ export { };
+
+//# sourceMappingURL=schema.d.js.map

package/src/ts/lib/schema.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/ts/lib/schema.d.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport { LibraryGeneratorSchema } from '@nx/js/src/utils/schema';\nexport interface TsProjectGeneratorSchema {\n  name: LibraryGeneratorSchema['name'];\n  directory?: string;\n  //   unitTestRunner?: LibraryGeneratorSchema['unitTestRunner'];\n  // TODO: test and consider exposing alternate bundlers\n  // bundler?: LibraryGeneratorSchema['bundler'];\n  subDirectory?: string;\n  preferInstallDependencies?: boolean;\n}\n"],"names":[],"mappings":"AAAA;;;CAGC,GAED,WAQC"}

package/src/ts/lib/schema.d.ts

@@ -10,5 +10,5 @@ export interface TsProjectGeneratorSchema {
   // TODO: test and consider exposing alternate bundlers
   // bundler?: LibraryGeneratorSchema['bundler'];
   subDirectory?: string;
-  skipInstall?: boolean;
+  preferInstallDependencies?: boolean;
 }

package/src/ts/lib/schema.json

@@ -26,6 +26,11 @@
       "type": "string",
       "description": "The sub directory the lib is placed in. By default this is the library name.",
       "x-prompt": "Which sub directory do you want to create the library in? (By default this is the library name)"
+    },
+    "preferInstallDependencies": {
+      "type": "boolean",
+      "description": "Whether to prefer installing dependencies after the generator runs. Set to false to defer installing when batching multiple generators (an install still runs if needed so subsequent generators can compute the Nx project graph); install once at the end.",
+      "default": true
     }
   },
   "required": ["name"]

package/src/ts/lib/ts-project-utils.d.ts

@@ -3,8 +3,20 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { type Tree } from '@nx/devkit';
-import type { ConfigureProjectOptions } from './types';
+import { type DependencyDeclaration, type MustDeclare } from '../../utils/declared-dependencies.js';
+import type { ConfigureProjectOptions } from './types.js';
+import { type VITEST_DEPENDENCIES } from './vitest.js';
+interface TsConfigReference {
+    path: string;
+}
+/**
+ * Merges new TypeScript project references into existing ones, deduplicating by
+ * path and preserving the order of existing references so re-running a
+ * generator neither duplicates nor reorders references.
+ */
+export declare const mergeTsReferences: (existing: TsConfigReference[] | undefined, toAdd: TsConfigReference[]) => TsConfigReference[];
 /**
  * Updates typescript projects
  */
-export declare const configureTsProject: (tree: Tree, options: ConfigureProjectOptions) => Promise<void>;
+export declare const configureTsProject: <const D extends DependencyDeclaration>(tree: Tree, options: ConfigureProjectOptions, declaration: D & MustDeclare<typeof VITEST_DEPENDENCIES, D>) => Promise<void>;
+export {};

package/src/ts/lib/ts-project-utils.js

@@ -1,91 +1,116 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.configureTsProject = void 0;
 /**
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
- */
-const devkit_1 = require("@nx/devkit");
-const path_1 = require("path");
-const config_1 = require("../../license/config");
-const npm_scope_1 = require("../../utils/npm-scope");
-const biome_1 = require("./biome");
-const vitest_1 = require("./vitest");
+ */ import { joinPathFragments, logger, updateJson } from "@nx/devkit";
+import { join, relative } from "path";
+import { addLicenseCheckToLintTarget } from "../../license/config.js";
+import { AWS_NX_PLUGIN_CONFIG_FILE_NAME } from "../../utils/config/utils.js";
+import { forDependencies } from "../../utils/declared-dependencies.js";
+import { isEsmWorkspace } from "../../utils/module-format.js";
+import { ensureProjectPackageJson } from "../../utils/project-package-json.js";
+import { configureBiomeLint } from "./biome.js";
+import { configureVitest } from "./vitest.js";
+/**
+ * Merges new TypeScript project references into existing ones, deduplicating by
+ * path and preserving the order of existing references so re-running a
+ * generator neither duplicates nor reorders references.
+ */ export const mergeTsReferences = (existing, toAdd)=>{
+    const references = [
+        ...existing ?? []
+    ];
+    const existingPaths = new Set(references.map((ref)=>ref.path));
+    for (const ref of toAdd){
+        if (!existingPaths.has(ref.path)) {
+            references.push(ref);
+            existingPaths.add(ref.path);
+        }
+    }
+    return references;
+};
 /**
  * Updates typescript projects
- */
-const configureTsProject = async (tree, options) => {
-    // Remove conflicting commonjs module from tsconfig
-    (0, devkit_1.updateJson)(tree, (0, path_1.join)(options.dir, 'tsconfig.json'), (tsConfig) => ({
-        ...tsConfig,
-        compilerOptions: {
-            ...tsConfig.compilerOptions,
-            module: tsConfig.compilerOptions?.module === 'commonjs'
-                ? undefined
-                : tsConfig.compilerOptions?.module,
-        },
-    }));
-    const outDirToRootRelativePath = (0, path_1.relative)((0, path_1.join)(tree.root, options.dir), tree.root);
-    const distDir = (0, path_1.join)(outDirToRootRelativePath, 'dist', options.dir, 'tsc');
-    // Remove baseUrl and rootDir from the tsconfig.lib.json
-    if (tree.exists((0, path_1.join)(options.dir, 'tsconfig.lib.json'))) {
-        (0, devkit_1.updateJson)(tree, (0, path_1.join)(options.dir, 'tsconfig.lib.json'), (tsConfig) => ({
+ */ export const configureTsProject = async (tree, options, declaration)=>{
+    // Point users at init when the workspace hasn't been configured, since
+    // lint/format targets and workspace dependency sync depend on it.
+    if (!tree.exists(AWS_NX_PLUGIN_CONFIG_FILE_NAME)) {
+        logger.warn(`This workspace has no ${AWS_NX_PLUGIN_CONFIG_FILE_NAME} — run 'nx g @aws/nx-plugin:init' (or 'nx add @aws/nx-plugin') to configure linting, formatting and workspace dependency sync.`);
+    }
+    // When the caller doesn't specify a module format, infer it from the
+    // workspace root package.json (defaulting to ESM for a fresh workspace).
+    const esm = options.esm ?? isEsmWorkspace(tree);
+    // Remove a conflicting `module: commonjs` from the project tsconfig.json
+    // (CommonJS is configured on tsconfig.lib.json below when needed).
+    updateJson(tree, join(options.dir, 'tsconfig.json'), (tsConfig)=>({
             ...tsConfig,
             compilerOptions: {
                 ...tsConfig.compilerOptions,
-                baseUrl: undefined,
-                rootDir: '.',
-                outDir: distDir,
-                tsBuildInfoFile: (0, path_1.join)(distDir, 'tsconfig.lib.tsbuildinfo'),
-            },
+                module: tsConfig.compilerOptions?.module === 'commonjs' ? undefined : tsConfig.compilerOptions?.module
+            }
         }));
+    const outDirToRootRelativePath = relative(join(tree.root, options.dir), tree.root);
+    const distDir = join(outDirToRootRelativePath, 'dist', options.dir, 'tsc');
+    // Remove baseUrl and rootDir from the tsconfig.lib.json
+    if (tree.exists(join(options.dir, 'tsconfig.lib.json'))) {
+        updateJson(tree, join(options.dir, 'tsconfig.lib.json'), (tsConfig)=>({
+                ...tsConfig,
+                compilerOptions: {
+                    ...tsConfig.compilerOptions,
+                    baseUrl: undefined,
+                    rootDir: '.',
+                    outDir: distDir,
+                    tsBuildInfoFile: join(distDir, 'tsconfig.lib.tsbuildinfo'),
+                    // @nx/js configures the lib for ESM (module `nodenext`). CommonJS
+                    // projects use `node16`, which honours the workspace's
+                    // `type: commonjs`, emits CommonJS and resolves extensionless relative
+                    // imports. (Plain `commonjs`/`node` is deprecated in TypeScript 6.)
+                    ...esm ? {} : {
+                        module: 'node16',
+                        moduleResolution: 'node16'
+                    }
+                }
+            }));
     }
     // Update root project tsconfig
-    (0, devkit_1.updateJson)(tree, 'tsconfig.base.json', (tsConfig) => ({
-        ...tsConfig,
-        compilerOptions: {
-            ...tsConfig.compilerOptions,
-            // baseUrl is deprecated in TypeScript 6 — use ./ prefix in paths instead
-            baseUrl: undefined,
-            rootDir: '.',
-            paths: {
-                // Remove any path aliases for this project with the npm scope prefix (eg remove @foo/bar)
-                ...Object.fromEntries(Object.entries(tsConfig.compilerOptions?.paths ?? {}).filter(([k]) => k !== options.fullyQualifiedName)),
-                // Add aliases which begin with colon (eg :foo/bar) to avoid sniping attacks
-                [(0, npm_scope_1.toScopeAlias)(options.fullyQualifiedName)]: [
-                    `./${(0, devkit_1.joinPathFragments)(options.dir, 'src', 'index.ts')}`,
-                ],
-            },
-        },
-    }));
-    if (tree.exists('tsconfig.json')) {
-        (0, devkit_1.updateJson)(tree, 'tsconfig.json', (tsConfig) => ({
+    updateJson(tree, 'tsconfig.base.json', (tsConfig)=>({
             ...tsConfig,
-            references: [
-                // Add project references, ensuring no duplication
-                ...(tsConfig.references ?? []).filter((ref) => ref.path !== `./${options.dir}`),
-                {
-                    path: `./${options.dir}`,
-                },
-            ],
+            compilerOptions: {
+                ...tsConfig.compilerOptions,
+                // baseUrl is deprecated in TypeScript 6 — use ./ prefix in paths instead
+                baseUrl: undefined,
+                rootDir: '.',
+                paths: {
+                    ...tsConfig.compilerOptions?.paths,
+                    [options.fullyQualifiedName]: [
+                        `./${joinPathFragments(options.dir, 'src', 'index.ts')}`
+                    ]
+                }
+            }
         }));
+    if (tree.exists('tsconfig.json')) {
+        updateJson(tree, 'tsconfig.json', (tsConfig)=>({
+                ...tsConfig,
+                // Add project references, deduplicating and preserving existing order
+                references: mergeTsReferences(tsConfig.references, [
+                    {
+                        path: `./${options.dir}`
+                    }
+                ])
+            }));
     }
-    // Update the root package.json
-    (0, devkit_1.updateJson)(tree, 'package.json', (packageJson) => ({
-        ...packageJson,
-        type: 'module',
-    }));
-    // Remove package.json if it exists
-    if (tree.exists((0, path_1.join)(options.dir, 'package.json'))) {
-        tree.delete((0, path_1.join)(options.dir, 'package.json'));
-    }
-    await (0, biome_1.configureBiomeLint)(tree, options);
-    await (0, vitest_1.configureVitest)(tree, options);
+    // Every project carries a minimal private package.json so the workspace
+    // follows the standard npm package layout (see ensureProjectPackageJson).
+    ensureProjectPackageJson(tree, {
+        dir: options.dir,
+        fullyQualifiedName: options.fullyQualifiedName,
+        esm
+    });
+    await configureBiomeLint(tree, options);
+    await configureVitest(tree, options, forDependencies(declaration));
     // If license checking is configured, make this project's lint target depend
     // on the root license-check target. No-op if there's no license-check target
     // (i.e. the license generator hasn't run); the license generator wires up
     // existing projects itself, so this works regardless of generator order.
-    (0, config_1.addLicenseCheckToLintTarget)(tree, options.fullyQualifiedName);
+    addLicenseCheckToLintTarget(tree, options.fullyQualifiedName);
 };
-exports.configureTsProject = configureTsProject;
+
 //# sourceMappingURL=ts-project-utils.js.map

package/src/ts/lib/ts-project-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"ts-project-utils.js","sourceRoot":"","sources":["../../../../../../packages/nx-plugin/src/ts/lib/ts-project-utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/ts/lib/ts-project-utils.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport { joinPathFragments, logger, type Tree, updateJson } from '@nx/devkit';\nimport { join, relative } from 'path';\nimport { addLicenseCheckToLintTarget } from '../../license/config.js';\nimport { AWS_NX_PLUGIN_CONFIG_FILE_NAME } from '../../utils/config/utils.js';\nimport {\n  type DependencyDeclaration,\n  forDependencies,\n  type MustDeclare,\n} from '../../utils/declared-dependencies.js';\nimport { isEsmWorkspace } from '../../utils/module-format.js';\nimport { ensureProjectPackageJson } from '../../utils/project-package-json.js';\nimport { configureBiomeLint } from './biome.js';\nimport type { ConfigureProjectOptions } from './types.js';\nimport { configureVitest, type VITEST_DEPENDENCIES } from './vitest.js';\n\ninterface TsConfigReference {\n  path: string;\n}\n\n/**\n * Merges new TypeScript project references into existing ones, deduplicating by\n * path and preserving the order of existing references so re-running a\n * generator neither duplicates nor reorders references.\n */\nexport const mergeTsReferences = (\n  existing: TsConfigReference[] | undefined,\n  toAdd: TsConfigReference[],\n): TsConfigReference[] => {\n  const references = [...(existing ?? [])];\n  const existingPaths = new Set(references.map((ref) => ref.path));\n  for (const ref of toAdd) {\n    if (!existingPaths.has(ref.path)) {\n      references.push(ref);\n      existingPaths.add(ref.path);\n    }\n  }\n  return references;\n};\n\n/**\n * Updates typescript projects\n */\nexport const configureTsProject = async <const D extends DependencyDeclaration>(\n  tree: Tree,\n  options: ConfigureProjectOptions,\n  declaration: D & MustDeclare<typeof VITEST_DEPENDENCIES, D>,\n) => {\n  // Point users at init when the workspace hasn't been configured, since\n  // lint/format targets and workspace dependency sync depend on it.\n  if (!tree.exists(AWS_NX_PLUGIN_CONFIG_FILE_NAME)) {\n    logger.warn(\n      `This workspace has no ${AWS_NX_PLUGIN_CONFIG_FILE_NAME} — run 'nx g @aws/nx-plugin:init' (or 'nx add @aws/nx-plugin') to configure linting, formatting and workspace dependency sync.`,\n    );\n  }\n\n  // When the caller doesn't specify a module format, infer it from the\n  // workspace root package.json (defaulting to ESM for a fresh workspace).\n  const esm = options.esm ?? isEsmWorkspace(tree);\n\n  // Remove a conflicting `module: commonjs` from the project tsconfig.json\n  // (CommonJS is configured on tsconfig.lib.json below when needed).\n  updateJson(tree, join(options.dir, 'tsconfig.json'), (tsConfig) => ({\n    ...tsConfig,\n    compilerOptions: {\n      ...tsConfig.compilerOptions,\n      module:\n        tsConfig.compilerOptions?.module === 'commonjs'\n          ? undefined\n          : tsConfig.compilerOptions?.module,\n    },\n  }));\n  const outDirToRootRelativePath = relative(\n    join(tree.root, options.dir),\n    tree.root,\n  );\n  const distDir = join(outDirToRootRelativePath, 'dist', options.dir, 'tsc');\n  // Remove baseUrl and rootDir from the tsconfig.lib.json\n  if (tree.exists(join(options.dir, 'tsconfig.lib.json'))) {\n    updateJson(tree, join(options.dir, 'tsconfig.lib.json'), (tsConfig) => ({\n      ...tsConfig,\n      compilerOptions: {\n        ...tsConfig.compilerOptions,\n        baseUrl: undefined,\n        rootDir: '.',\n        outDir: distDir,\n        tsBuildInfoFile: join(distDir, 'tsconfig.lib.tsbuildinfo'),\n        // @nx/js configures the lib for ESM (module `nodenext`). CommonJS\n        // projects use `node16`, which honours the workspace's\n        // `type: commonjs`, emits CommonJS and resolves extensionless relative\n        // imports. (Plain `commonjs`/`node` is deprecated in TypeScript 6.)\n        ...(esm ? {} : { module: 'node16', moduleResolution: 'node16' }),\n      },\n    }));\n  }\n  // Update root project tsconfig\n  updateJson(tree, 'tsconfig.base.json', (tsConfig) => ({\n    ...tsConfig,\n    compilerOptions: {\n      ...tsConfig.compilerOptions,\n      // baseUrl is deprecated in TypeScript 6 — use ./ prefix in paths instead\n      baseUrl: undefined,\n      rootDir: '.',\n      paths: {\n        ...tsConfig.compilerOptions?.paths,\n        [options.fullyQualifiedName]: [\n          `./${joinPathFragments(options.dir, 'src', 'index.ts')}`,\n        ],\n      },\n    },\n  }));\n  if (tree.exists('tsconfig.json')) {\n    updateJson(tree, 'tsconfig.json', (tsConfig) => ({\n      ...tsConfig,\n      // Add project references, deduplicating and preserving existing order\n      references: mergeTsReferences(tsConfig.references, [\n        { path: `./${options.dir}` },\n      ]),\n    }));\n  }\n  // Every project carries a minimal private package.json so the workspace\n  // follows the standard npm package layout (see ensureProjectPackageJson).\n  ensureProjectPackageJson(tree, {\n    dir: options.dir,\n    fullyQualifiedName: options.fullyQualifiedName,\n    esm,\n  });\n\n  await configureBiomeLint(tree, options);\n  await configureVitest(\n    tree,\n    options,\n    forDependencies<typeof VITEST_DEPENDENCIES>(declaration),\n  );\n\n  // If license checking is configured, make this project's lint target depend\n  // on the root license-check target. No-op if there's no license-check target\n  // (i.e. the license generator hasn't run); the license generator wires up\n  // existing projects itself, so this works regardless of generator order.\n  addLicenseCheckToLintTarget(tree, options.fullyQualifiedName);\n};\n"],"names":["joinPathFragments","logger","updateJson","join","relative","addLicenseCheckToLintTarget","AWS_NX_PLUGIN_CONFIG_FILE_NAME","forDependencies","isEsmWorkspace","ensureProjectPackageJson","configureBiomeLint","configureVitest","mergeTsReferences","existing","toAdd","references","existingPaths","Set","map","ref","path","has","push","add","configureTsProject","tree","options","declaration","exists","warn","esm","dir","tsConfig","compilerOptions","module","undefined","outDirToRootRelativePath","root","distDir","baseUrl","rootDir","outDir","tsBuildInfoFile","moduleResolution","paths","fullyQualifiedName"],"mappings":"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"}

package/src/ts/lib/types.d.ts

@@ -11,4 +11,10 @@ export interface ConfigureProjectOptions {
      * Directory of the project relative to the root
      */
     readonly dir: string;
+    /**
+     * Whether the project uses ES modules. When false, the project is configured
+     * for CommonJS (tsconfig `module`/`moduleResolution`, no root `type: module`).
+     * Defaults to true (ESM) when not specified.
+     */
+    readonly esm?: boolean;
 }