@aws/nx-plugin 1.0.0-rc.4 → 1.0.0-rc.41

package/src/ts/nx-generator/files/common/schema.json.template

@@ -10,6 +10,11 @@
       "description": "An example option. Refer to https://nx.dev/extending-nx/recipes/generator-options for more info",
       "x-priority": "important",
       "x-prompt": "This is an example option!"
+    },
+    "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": ["exampleOption"]

package/src/ts/nx-generator/files/local/generator.ts.template

@@ -1,9 +1,9 @@
-import { GeneratorCallback, Tree, generateFiles, joinPathFragments } from "@nx/devkit";
-import { <%- namePascalCase %>GeneratorSchema } from './schema';
+import { type GeneratorCallback, type Tree, generateFiles, joinPathFragments } from "@nx/devkit";
+import type { <%- namePascalCase %>GeneratorSchema } from './schema<% if (esm) { %>.js<% } %>';
 
 export const <%- nameCamelCase %>Generator = async (tree: Tree, options: <%- namePascalCase %>GeneratorSchema): Promise<GeneratorCallback | void> => {
   // TODO: implement your generator here, for example:
-  generateFiles(tree, joinPathFragments(__dirname, 'files'), 'target/dir', options);
+  generateFiles(tree, joinPathFragments(<% if (esm) { %>import.meta.dirname<% } else { %>__dirname<% } %>, 'files'), 'target/dir', options);
 };
 
 export default <%- nameCamelCase %>Generator;

package/src/ts/nx-generator/files/nx-plugin-for-aws/generator/generator.ts.template

@@ -1,11 +1,12 @@
-import { GeneratorCallback, Tree, installPackagesTask } from "@nx/devkit";
-import { <%- namePascalCase %>GeneratorSchema } from './schema';
-import { NxGeneratorInfo, getGeneratorInfo } from '<%- pathToProjectSourceRoot %>utils/nx';
+import { type GeneratorCallback, type Tree } from "@nx/devkit";
+import type { <%- namePascalCase %>GeneratorSchema } from './schema<% if (esm) { %>.js<% } %>';
+import { type NxGeneratorInfo, getGeneratorInfo } from '<%- pathToProjectSourceRoot %>utils/nx';
 import { addGeneratorMetricsIfApplicable } from '<%- pathToProjectSourceRoot %>utils/metrics';
 import { formatFilesInSubtree } from '<%- pathToProjectSourceRoot %>utils/format';
+import { installDependencies } from '<%- pathToProjectSourceRoot %>utils/install';
 
 export const <%- nameUpperSnakeCase %>_GENERATOR_INFO: NxGeneratorInfo =
-  getGeneratorInfo(__filename);
+  getGeneratorInfo(<% if (esm) { %>import.meta.filename<% } else { %>__filename<% } %>);
 
 export const <%- nameCamelCase %>Generator = async (tree: Tree, options: <%- namePascalCase %>GeneratorSchema): Promise<GeneratorCallback> => {
 
@@ -14,9 +15,7 @@ export const <%- nameCamelCase %>Generator = async (tree: Tree, options: <%- nam
   await addGeneratorMetricsIfApplicable(tree, [<%- nameUpperSnakeCase %>_GENERATOR_INFO]);
 
   await formatFilesInSubtree(tree);
-  return () => {
-    installPackagesTask(tree);
-  };
+  return () => installDependencies(tree, options.preferInstallDependencies, { languages: ['typescript'] });
 };
 
 export default <%- nameCamelCase %>Generator;

package/src/ts/nx-generator/generator.d.ts

@@ -2,8 +2,8 @@
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
-import { GeneratorCallback, Tree } from '@nx/devkit';
-import { TsNxGeneratorGeneratorSchema } from './schema';
+import { type GeneratorCallback, type Tree } from '@nx/devkit';
+import type { TsNxGeneratorGeneratorSchema } from './schema';
 export declare const NX_GENERATOR_GENERATOR_INFO: import("../../utils/generators").GeneratorInfo;
 export declare const tsNxGeneratorGenerator: (tree: Tree, options: TsNxGeneratorGeneratorSchema) => Promise<GeneratorCallback | void>;
 export default tsNxGeneratorGenerator;

package/src/ts/nx-generator/generator.js

@@ -1,116 +1,156 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.tsNxGeneratorGenerator = exports.NX_GENERATOR_GENERATOR_INFO = void 0;
-const tslib_1 = require("tslib");
 /**
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
- */
-const devkit_1 = require("@nx/devkit");
-const names_1 = require("../../utils/names");
-const lodash_camelcase_1 = tslib_1.__importDefault(require("lodash.camelcase"));
-const paths_1 = require("../../utils/paths");
-const ast_1 = require("../../utils/ast");
-const nx_1 = require("../../utils/nx");
-const metrics_1 = require("../../utils/metrics");
-const format_1 = require("../../utils/format");
-const package_json_1 = tslib_1.__importDefault(require("../../../package.json"));
-const utils_1 = require("../nx-plugin/utils");
-const object_1 = require("../../utils/object");
-exports.NX_GENERATOR_GENERATOR_INFO = (0, nx_1.getGeneratorInfo)(__filename);
-const tsNxGeneratorGenerator = async (tree, options) => {
+ */ import { generateFiles, joinPathFragments, OverwriteStrategy, readJson, writeJson } from "@nx/devkit";
+import camelCase from "lodash.camelcase";
+import PackageJson from "../../../package.json" with {
+    type: 'json'
+};
+import { addStarExport, applyGritQL } from "../../utils/ast.js";
+import { formatFilesInSubtree } from "../../utils/format.js";
+import { installDependencies } from "../../utils/install.js";
+import { addGeneratorMetricsIfApplicable } from "../../utils/metrics.js";
+import { esmVars } from "../../utils/module-format.js";
+import { kebabCase, pascalCase, snakeCase } from "../../utils/names.js";
+import { addComponentGeneratorMetadata, getGeneratorInfo, readProjectConfigurationUnqualified } from "../../utils/nx.js";
+import { sortObjectKeys } from "../../utils/object.js";
+import { getRelativePathToRootByDirectory } from "../../utils/paths.js";
+import { configureTsProjectAsNxPlugin } from "../nx-plugin/utils.js";
+export const NX_GENERATOR_GENERATOR_INFO = getGeneratorInfo(import.meta.filename);
+export const tsNxGeneratorGenerator = async (tree, options)=>{
     const { name, directory, project: pluginProject, description } = options;
-    const plugin = (0, nx_1.readProjectConfigurationUnqualified)(tree, pluginProject);
-    const sourceRoot = plugin.sourceRoot ?? (0, devkit_1.joinPathFragments)(plugin.root, 'src');
+    const plugin = readProjectConfigurationUnqualified(tree, pluginProject);
+    const sourceRoot = plugin.sourceRoot ?? joinPathFragments(plugin.root, 'src');
     const sourceRootParts = sourceRoot.split('/');
     const srcDir = sourceRootParts[sourceRootParts.length - 1];
-    const generatorSubDir = directory ?? (0, names_1.kebabCase)(name);
-    const generatorDir = (0, devkit_1.joinPathFragments)(sourceRoot, generatorSubDir);
-    const rootPackageJson = tree.exists('package.json')
-        ? (0, devkit_1.readJson)(tree, 'package.json')
-        : undefined;
+    const generatorSubDir = directory ?? kebabCase(name);
+    const generatorDir = joinPathFragments(sourceRoot, generatorSubDir);
+    const rootPackageJson = tree.exists('package.json') ? readJson(tree, 'package.json') : undefined;
     const isNxPluginForAws = rootPackageJson?.name === '@aws/nx-plugin-source';
     // Configure the targeted project as an Nx Plugin
-    (0, utils_1.configureTsProjectAsNxPlugin)(tree, pluginProject);
+    configureTsProjectAsNxPlugin(tree, pluginProject);
     const enhancedOptions = {
         name,
         description,
-        namePascalCase: (0, names_1.pascalCase)(name),
-        nameCamelCase: (0, lodash_camelcase_1.default)(name),
-        nameKebabCase: (0, names_1.kebabCase)(name),
-        nameUpperSnakeCase: (0, names_1.snakeCase)(name).toUpperCase(),
+        namePascalCase: pascalCase(name),
+        nameCamelCase: camelCase(name),
+        nameKebabCase: kebabCase(name),
+        nameUpperSnakeCase: snakeCase(name).toUpperCase(),
         isNxPluginForAws,
-        pathToProjectSourceRoot: (0, paths_1.getRelativePathToRootByDirectory)(generatorSubDir),
+        pathToProjectSourceRoot: getRelativePathToRootByDirectory(generatorSubDir),
         generatorDir,
         generatorSubDir,
+        ...esmVars(tree)
     };
-    // Add the common files
-    (0, devkit_1.generateFiles)(tree, (0, devkit_1.joinPathFragments)(__dirname, 'files', 'common'), generatorDir, {
-        ...enhancedOptions,
+    // Add the common files, preserving any the user has already implemented
+    generateFiles(tree, joinPathFragments(import.meta.dirname, 'files', 'common'), generatorDir, {
+        ...enhancedOptions
+    }, {
+        overwriteStrategy: OverwriteStrategy.KeepExisting
     });
     // Add the files specific to this repo vs a local generator in another project
     if (isNxPluginForAws) {
         // Generators should be in the @aws/nx-plugin project
-        if (pluginProject !== package_json_1.default.name) {
-            throw new Error(`Generators should be added to the ${package_json_1.default.name} project.`);
+        if (pluginProject !== PackageJson.name) {
+            throw new Error(`Generators should be added to the ${PackageJson.name} project.`);
         }
         // Add the generator
-        (0, devkit_1.generateFiles)(tree, (0, devkit_1.joinPathFragments)(__dirname, 'files', 'nx-plugin-for-aws', 'generator'), generatorDir, {
-            ...enhancedOptions,
+        generateFiles(tree, joinPathFragments(import.meta.dirname, 'files', 'nx-plugin-for-aws', 'generator'), generatorDir, {
+            ...enhancedOptions
+        }, {
+            overwriteStrategy: OverwriteStrategy.KeepExisting
         });
         // Generate guide page in docs
-        (0, devkit_1.generateFiles)(tree, (0, devkit_1.joinPathFragments)(__dirname, 'files', 'nx-plugin-for-aws', 'docs'), (0, devkit_1.joinPathFragments)('docs', 'src', 'content', 'docs', 'en', 'guides'), {
-            ...enhancedOptions,
+        generateFiles(tree, joinPathFragments(import.meta.dirname, 'files', 'nx-plugin-for-aws', 'docs'), joinPathFragments('docs', 'src', 'content', 'docs', 'en', 'guides'), {
+            ...enhancedOptions
+        }, {
+            overwriteStrategy: OverwriteStrategy.KeepExisting
         });
         // Update the docs config to add the page entry to the Generator guides sidebar section
-        await (0, ast_1.applyGritQL)(tree, (0, devkit_1.joinPathFragments)('docs', 'astro.config.mjs'), `\`items: [$items]\` where { $items <: within \`sidebar: [$_]\`, $items <: contains \`'ts#project'\`, $items <: not contains \`'/guides/${enhancedOptions.nameKebabCase}'\`, $items += \`, { label: '${name}', link: '/guides/${enhancedOptions.nameKebabCase}' }\` }`);
-    }
-    else {
+        await applyGritQL(tree, joinPathFragments('docs', 'astro.config.mjs'), `\`items: [$items]\` where { $items <: within \`sidebar: [$_]\`, $items <: contains \`'ts#project'\`, $items <: not contains \`'/guides/${enhancedOptions.nameKebabCase}'\`, $items += \`, { label: '${name}', link: '/guides/${enhancedOptions.nameKebabCase}' }\` }`);
+        // Expose the generator from the SDK for known prefixes (ts# / py#)
+        addSdkExport(tree, plugin.root, name, generatorSubDir, enhancedOptions);
+    } else {
         // Local generator in a project other than nx-plugin-for-aws
-        (0, devkit_1.generateFiles)(tree, (0, devkit_1.joinPathFragments)(__dirname, 'files', 'local'), generatorDir, {
-            ...enhancedOptions,
+        generateFiles(tree, joinPathFragments(import.meta.dirname, 'files', 'local'), generatorDir, {
+            ...enhancedOptions
+        }, {
+            overwriteStrategy: OverwriteStrategy.KeepExisting
         });
-        const indexPath = (0, devkit_1.joinPathFragments)(sourceRoot, 'index.ts');
+        const indexPath = joinPathFragments(sourceRoot, 'index.ts');
         if (tree.exists(indexPath)) {
-            await (0, ast_1.addStarExport)(tree, indexPath, `./${generatorSubDir}/generator`);
+            // ESM projects require the explicit `.js` extension; `addStarExport`
+            // strips it for CommonJS workspaces.
+            await addStarExport(tree, indexPath, `./${generatorSubDir}/generator.js`);
         }
-        (0, nx_1.addComponentGeneratorMetadata)(tree, plugin.name, exports.NX_GENERATOR_GENERATOR_INFO, (0, devkit_1.joinPathFragments)(srcDir, generatorSubDir), name);
+        addComponentGeneratorMetadata(tree, plugin.name, NX_GENERATOR_GENERATOR_INFO, joinPathFragments(srcDir, generatorSubDir), name);
     }
     const factoryBasePath = `./${srcDir}/${generatorSubDir}`;
     // Update generators.json
-    const generatorsJsonPath = (0, devkit_1.joinPathFragments)(plugin.root, 'generators.json');
-    const generatorsJson = tree.exists(generatorsJsonPath)
-        ? (0, devkit_1.readJson)(tree, generatorsJsonPath)
-        : { generators: {} };
-    const existingGenerators = Object.values(generatorsJson?.generators ?? {});
-    (0, devkit_1.writeJson)(tree, generatorsJsonPath, {
+    const generatorsJsonPath = joinPathFragments(plugin.root, 'generators.json');
+    const generatorsJson = tree.exists(generatorsJsonPath) ? readJson(tree, generatorsJsonPath) : {
+        generators: {}
+    };
+    // Metrics are only tracked within the @aws/nx-plugin repo. Reuse the existing
+    // metric for a same-name re-run, otherwise allocate a new one.
+    let metric;
+    if (isNxPluginForAws) {
+        const existingMetrics = Object.values(generatorsJson?.generators ?? {}).map((g)=>g.metric).filter((m)=>typeof m === 'string');
+        metric = generatorsJson?.generators?.[name]?.metric ?? (existingMetrics.length > 0 ? incrementMetric(existingMetrics) : 'g1');
+    }
+    writeJson(tree, generatorsJsonPath, {
         ...generatorsJson,
-        generators: (0, object_1.sortObjectKeys)({
+        generators: sortObjectKeys({
             ...generatorsJson?.generators,
             [name]: {
                 factory: `${factoryBasePath}/generator`,
                 schema: `${factoryBasePath}/schema.json`,
                 description: description ?? 'TODO: Add short description of the generator',
-                ...(isNxPluginForAws
-                    ? {
-                        metric: existingGenerators.length > 0
-                            ? incrementMetric(Object.values(existingGenerators).map((g) => g.metric))
-                            : 'g1',
-                    }
-                    : {}),
-            },
-        }),
+                ...isNxPluginForAws ? {
+                    metric
+                } : {}
+            }
+        })
     });
-    await (0, metrics_1.addGeneratorMetricsIfApplicable)(tree, [exports.NX_GENERATOR_GENERATOR_INFO]);
-    await (0, format_1.formatFilesInSubtree)(tree);
-    return () => {
-        (0, devkit_1.installPackagesTask)(tree);
-    };
+    await addGeneratorMetricsIfApplicable(tree, [
+        NX_GENERATOR_GENERATOR_INFO
+    ]);
+    await formatFilesInSubtree(tree);
+    return ()=>installDependencies(tree, options.preferInstallDependencies, {
+            languages: [
+                'typescript'
+            ]
+        });
 };
-exports.tsNxGeneratorGenerator = tsNxGeneratorGenerator;
-const incrementMetric = (metrics) => {
-    const maxMetric = Math.max(...metrics.map((m) => Number(m.slice(1))));
+const incrementMetric = (metrics)=>{
+    const maxMetric = Math.max(...metrics.map((m)=>Number(m.slice(1))));
     return `g${maxMetric + 1}`;
 };
-exports.default = exports.tsNxGeneratorGenerator;
+// Maps a generator name prefix to the SDK entry point that should re-export it
+const SDK_EXPORT_PREFIXES = {
+    'ts#': 'ts',
+    'py#': 'py'
+};
+// Re-exports a generated generator from the matching SDK entry point so it is
+// available programmatically as part of @aws/nx-plugin's SDK
+const addSdkExport = (tree, pluginRoot, name, generatorSubDir, options)=>{
+    const prefix = Object.keys(SDK_EXPORT_PREFIXES).find((p)=>name.startsWith(p));
+    if (!prefix) {
+        return;
+    }
+    const sdkPath = joinPathFragments(pluginRoot, 'src', 'sdk', `${SDK_EXPORT_PREFIXES[prefix]}.ts`);
+    const generatorExport = `${options.nameCamelCase}Generator`;
+    const schemaExport = `${options.namePascalCase}GeneratorSchema`;
+    const moduleBase = `../${generatorSubDir}`;
+    const contents = tree.exists(sdkPath) ? tree.read(sdkPath).toString() : '';
+    // Idempotent: skip if this generator is already exported
+    if (contents.includes(`${moduleBase}/generator`)) {
+        return;
+    }
+    const block = `// ${options.namePascalCase} Generator\nexport { ${generatorExport} } from '${moduleBase}/generator';\nexport type { ${schemaExport} } from '${moduleBase}/schema';\n`;
+    const prefixContents = contents.trim() ? `${contents.replace(/\s*$/, '')}\n\n` : '';
+    tree.write(sdkPath, `${prefixContents}${block}`);
+};
+export default tsNxGeneratorGenerator;
+
 //# sourceMappingURL=generator.js.map

package/src/ts/nx-generator/generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../packages/nx-plugin/src/ts/nx-generator/generator.ts"],"names":[],"mappings":"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"}
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/ts/nx-generator/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  OverwriteStrategy,\n  readJson,\n  type Tree,\n  writeJson,\n} from '@nx/devkit';\nimport camelCase from 'lodash.camelcase';\nimport PackageJson from '../../../package.json' with { type: 'json' };\nimport { addStarExport, applyGritQL } from '../../utils/ast';\nimport { formatFilesInSubtree } from '../../utils/format';\nimport { installDependencies } from '../../utils/install';\nimport { addGeneratorMetricsIfApplicable } from '../../utils/metrics';\nimport { esmVars } from '../../utils/module-format';\nimport { kebabCase, pascalCase, snakeCase } from '../../utils/names';\nimport {\n  addComponentGeneratorMetadata,\n  getGeneratorInfo,\n  readProjectConfigurationUnqualified,\n} from '../../utils/nx';\nimport { sortObjectKeys } from '../../utils/object';\nimport { getRelativePathToRootByDirectory } from '../../utils/paths';\nimport { configureTsProjectAsNxPlugin } from '../nx-plugin/utils';\nimport type { TsNxGeneratorGeneratorSchema } from './schema';\n\nexport const NX_GENERATOR_GENERATOR_INFO = getGeneratorInfo(\n  import.meta.filename,\n);\n\nexport const tsNxGeneratorGenerator = async (\n  tree: Tree,\n  options: TsNxGeneratorGeneratorSchema,\n): Promise<GeneratorCallback | void> => {\n  const { name, directory, project: pluginProject, description } = options;\n\n  const plugin = readProjectConfigurationUnqualified(tree, pluginProject);\n  const sourceRoot = plugin.sourceRoot ?? joinPathFragments(plugin.root, 'src');\n  const sourceRootParts = sourceRoot.split('/');\n  const srcDir = sourceRootParts[sourceRootParts.length - 1];\n  const generatorSubDir = directory ?? kebabCase(name);\n  const generatorDir = joinPathFragments(sourceRoot, generatorSubDir);\n\n  const rootPackageJson = tree.exists('package.json')\n    ? readJson(tree, 'package.json')\n    : undefined;\n  const isNxPluginForAws = rootPackageJson?.name === '@aws/nx-plugin-source';\n\n  // Configure the targeted project as an Nx Plugin\n  configureTsProjectAsNxPlugin(tree, pluginProject);\n\n  const enhancedOptions = {\n    name,\n    description,\n    namePascalCase: pascalCase(name),\n    nameCamelCase: camelCase(name),\n    nameKebabCase: kebabCase(name),\n    nameUpperSnakeCase: snakeCase(name).toUpperCase(),\n    isNxPluginForAws,\n    pathToProjectSourceRoot: getRelativePathToRootByDirectory(generatorSubDir),\n    generatorDir,\n    generatorSubDir,\n    ...esmVars(tree),\n  };\n\n  // Add the common files, preserving any the user has already implemented\n  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files', 'common'),\n    generatorDir,\n    {\n      ...enhancedOptions,\n    },\n    { overwriteStrategy: OverwriteStrategy.KeepExisting },\n  );\n\n  // Add the files specific to this repo vs a local generator in another project\n  if (isNxPluginForAws) {\n    // Generators should be in the @aws/nx-plugin project\n    if (pluginProject !== PackageJson.name) {\n      throw new Error(\n        `Generators should be added to the ${PackageJson.name} project.`,\n      );\n    }\n\n    // Add the generator\n    generateFiles(\n      tree,\n      joinPathFragments(\n        import.meta.dirname,\n        'files',\n        'nx-plugin-for-aws',\n        'generator',\n      ),\n      generatorDir,\n      {\n        ...enhancedOptions,\n      },\n      { overwriteStrategy: OverwriteStrategy.KeepExisting },\n    );\n\n    // Generate guide page in docs\n    generateFiles(\n      tree,\n      joinPathFragments(\n        import.meta.dirname,\n        'files',\n        'nx-plugin-for-aws',\n        'docs',\n      ),\n      joinPathFragments('docs', 'src', 'content', 'docs', 'en', 'guides'),\n      {\n        ...enhancedOptions,\n      },\n      { overwriteStrategy: OverwriteStrategy.KeepExisting },\n    );\n\n    // Update the docs config to add the page entry to the Generator guides sidebar section\n    await applyGritQL(\n      tree,\n      joinPathFragments('docs', 'astro.config.mjs'),\n      `\\`items: [$items]\\` where { $items <: within \\`sidebar: [$_]\\`, $items <: contains \\`'ts#project'\\`, $items <: not contains \\`'/guides/${enhancedOptions.nameKebabCase}'\\`, $items += \\`, { label: '${name}', link: '/guides/${enhancedOptions.nameKebabCase}' }\\` }`,\n    );\n\n    // Expose the generator from the SDK for known prefixes (ts# / py#)\n    addSdkExport(tree, plugin.root, name, generatorSubDir, enhancedOptions);\n  } else {\n    // Local generator in a project other than nx-plugin-for-aws\n    generateFiles(\n      tree,\n      joinPathFragments(import.meta.dirname, 'files', 'local'),\n      generatorDir,\n      {\n        ...enhancedOptions,\n      },\n      { overwriteStrategy: OverwriteStrategy.KeepExisting },\n    );\n\n    const indexPath = joinPathFragments(sourceRoot, 'index.ts');\n    if (tree.exists(indexPath)) {\n      // ESM projects require the explicit `.js` extension; `addStarExport`\n      // strips it for CommonJS workspaces.\n      await addStarExport(tree, indexPath, `./${generatorSubDir}/generator.js`);\n    }\n\n    addComponentGeneratorMetadata(\n      tree,\n      plugin.name,\n      NX_GENERATOR_GENERATOR_INFO,\n      joinPathFragments(srcDir, generatorSubDir),\n      name,\n    );\n  }\n\n  const factoryBasePath = `./${srcDir}/${generatorSubDir}`;\n\n  // Update generators.json\n  const generatorsJsonPath = joinPathFragments(plugin.root, 'generators.json');\n  const generatorsJson = tree.exists(generatorsJsonPath)\n    ? readJson(tree, generatorsJsonPath)\n    : { generators: {} };\n  // Metrics are only tracked within the @aws/nx-plugin repo. Reuse the existing\n  // metric for a same-name re-run, otherwise allocate a new one.\n  let metric: string | undefined;\n  if (isNxPluginForAws) {\n    const existingMetrics = Object.values(generatorsJson?.generators ?? {})\n      .map((g: any) => g.metric)\n      .filter((m): m is string => typeof m === 'string');\n    metric =\n      generatorsJson?.generators?.[name]?.metric ??\n      (existingMetrics.length > 0 ? incrementMetric(existingMetrics) : 'g1');\n  }\n  writeJson(tree, generatorsJsonPath, {\n    ...generatorsJson,\n    generators: sortObjectKeys({\n      ...generatorsJson?.generators,\n      [name]: {\n        factory: `${factoryBasePath}/generator`,\n        schema: `${factoryBasePath}/schema.json`,\n        description:\n          description ?? 'TODO: Add short description of the generator',\n        ...(isNxPluginForAws ? { metric } : {}),\n      },\n    }),\n  });\n\n  await addGeneratorMetricsIfApplicable(tree, [NX_GENERATOR_GENERATOR_INFO]);\n\n  await formatFilesInSubtree(tree);\n\n  return () =>\n    installDependencies(tree, options.preferInstallDependencies, {\n      languages: ['typescript'],\n    });\n};\n\nconst incrementMetric = (metrics: string[]): string => {\n  const maxMetric = Math.max(...metrics.map((m) => Number(m.slice(1))));\n  return `g${maxMetric + 1}`;\n};\n\n// Maps a generator name prefix to the SDK entry point that should re-export it\nconst SDK_EXPORT_PREFIXES: Record<string, string> = {\n  'ts#': 'ts',\n  'py#': 'py',\n};\n\n// Re-exports a generated generator from the matching SDK entry point so it is\n// available programmatically as part of @aws/nx-plugin's SDK\nconst addSdkExport = (\n  tree: Tree,\n  pluginRoot: string,\n  name: string,\n  generatorSubDir: string,\n  options: { nameCamelCase: string; namePascalCase: string },\n): void => {\n  const prefix = Object.keys(SDK_EXPORT_PREFIXES).find((p) =>\n    name.startsWith(p),\n  );\n  if (!prefix) {\n    return;\n  }\n\n  const sdkPath = joinPathFragments(\n    pluginRoot,\n    'src',\n    'sdk',\n    `${SDK_EXPORT_PREFIXES[prefix]}.ts`,\n  );\n  const generatorExport = `${options.nameCamelCase}Generator`;\n  const schemaExport = `${options.namePascalCase}GeneratorSchema`;\n  const moduleBase = `../${generatorSubDir}`;\n\n  const contents = tree.exists(sdkPath) ? tree.read(sdkPath).toString() : '';\n  // Idempotent: skip if this generator is already exported\n  if (contents.includes(`${moduleBase}/generator`)) {\n    return;\n  }\n\n  const block = `// ${options.namePascalCase} Generator\\nexport { ${generatorExport} } from '${moduleBase}/generator';\\nexport type { ${schemaExport} } from '${moduleBase}/schema';\\n`;\n\n  const prefixContents = contents.trim()\n    ? `${contents.replace(/\\s*$/, '')}\\n\\n`\n    : '';\n  tree.write(sdkPath, `${prefixContents}${block}`);\n};\n\nexport default tsNxGeneratorGenerator;\n"],"names":["generateFiles","joinPathFragments","OverwriteStrategy","readJson","writeJson","camelCase","PackageJson","type","addStarExport","applyGritQL","formatFilesInSubtree","installDependencies","addGeneratorMetricsIfApplicable","esmVars","kebabCase","pascalCase","snakeCase","addComponentGeneratorMetadata","getGeneratorInfo","readProjectConfigurationUnqualified","sortObjectKeys","getRelativePathToRootByDirectory","configureTsProjectAsNxPlugin","NX_GENERATOR_GENERATOR_INFO","filename","tsNxGeneratorGenerator","tree","options","name","directory","project","pluginProject","description","plugin","sourceRoot","root","sourceRootParts","split","srcDir","length","generatorSubDir","generatorDir","rootPackageJson","exists","undefined","isNxPluginForAws","enhancedOptions","namePascalCase","nameCamelCase","nameKebabCase","nameUpperSnakeCase","toUpperCase","pathToProjectSourceRoot","dirname","overwriteStrategy","KeepExisting","Error","addSdkExport","indexPath","factoryBasePath","generatorsJsonPath","generatorsJson","generators","metric","existingMetrics","Object","values","map","g","filter","m","incrementMetric","factory","schema","preferInstallDependencies","languages","metrics","maxMetric","Math","max","Number","slice","SDK_EXPORT_PREFIXES","pluginRoot","prefix","keys","find","p","startsWith","sdkPath","generatorExport","schemaExport","moduleBase","contents","read","toString","includes","block","prefixContents","trim","replace","write"],"mappings":"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"}

package/src/ts/nx-generator/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/nx-generator/schema.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/ts/nx-generator/schema.d.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\n\nexport interface TsNxGeneratorGeneratorSchema {\n  project: string;\n  name: string;\n  directory?: string;\n  description?: string;\n  preferInstallDependencies?: boolean;\n}\n"],"names":[],"mappings":"AAAA;;;CAGC,GAED,WAMC"}

package/src/ts/nx-generator/schema.d.ts

@@ -8,4 +8,5 @@ export interface TsNxGeneratorGeneratorSchema {
   name: string;
   directory?: string;
   description?: string;
+  preferInstallDependencies?: boolean;
 }

package/src/ts/nx-generator/schema.json

@@ -32,6 +32,11 @@
       "type": "string",
       "description": "The directory within the plugin project's source folder to add the generator to (default: <name>)",
       "x-prompt": "Choose the directory you would like to generate the generator in relative to the project's source folder (default: <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": ["project", "name"]

package/src/ts/nx-plugin/__snapshots__/generator.spec.ts.snap

@@ -2,7 +2,7 @@
 
 exports[`ts#nx-plugin generator > should generate MCP server files > test-plugin/src/mcp-server/http.ts 1`] = `
 "#!/usr/bin/env node
-import { createServer } from './server';
+import { createServer } from './server.js';
 import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
 import express, { Request, Response } from 'express';
 
@@ -90,7 +90,7 @@ void (async () => {
 `;
 
 exports[`ts#nx-plugin generator > should generate MCP server files > test-plugin/src/mcp-server/index.ts 1`] = `
-"export * from './server';
+"export * from './server.js';
 "
 `;
 
@@ -157,11 +157,11 @@ export const PackageManagerSchema = z.enum(PACKAGE_MANAGERS);
 
 exports[`ts#nx-plugin generator > should generate MCP server files > test-plugin/src/mcp-server/server.ts 1`] = `
 "import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { registerCreateWorkspaceCommandTool } from './tools/create-workspace-command';
-import { registerGeneralGuidanceTool } from './tools/general-guidance';
-import { registerListGeneratorsTool } from './tools/list-generators';
-import { registerGeneratorGuideTool } from './tools/generator-guide';
-import { getPackageName } from './utils';
+import { registerCreateWorkspaceCommandTool } from './tools/create-workspace-command.js';
+import { registerGeneralGuidanceTool } from './tools/general-guidance.js';
+import { registerListGeneratorsTool } from './tools/list-generators.js';
+import { registerGeneratorGuideTool } from './tools/generator-guide.js';
+import { getPackageName } from './utils.js';
 
 /**
  * Create the MCP Server
@@ -203,7 +203,7 @@ This server provides resources and tools for quickly scaffolding projects using
 exports[`ts#nx-plugin generator > should generate MCP server files > test-plugin/src/mcp-server/stdio.ts 1`] = `
 "#!/usr/bin/env node
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { createServer } from './server';
+import { createServer } from './server.js';
 
 export const startMcpServer = async () => {
   const transport = new StdioServerTransport();
@@ -225,12 +225,12 @@ void (async () => {
 exports[`ts#nx-plugin generator > should generate MCP server files > test-plugin/src/mcp-server/tools/create-workspace-command.ts 1`] = `
 "import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
-import { PackageManagerSchema } from '../schema';
+import { PackageManagerSchema } from '../schema.js';
 import {
   buildCreateCommand,
   buildInstallCommand,
   getPackageName,
-} from '../utils';
+} from '../utils.js';
 
 /**
  * Registers a tool which tells a model how to create an Nx workspace
@@ -316,7 +316,10 @@ export const registerGeneralGuidanceTool = (server: McpServer) => {
         {
           type: 'text' as const,
           text: fs.readFileSync(
-            path.resolve(__dirname, '../resources/GENERAL_GUIDANCE.md'),
+            path.resolve(
+              import.meta.dirname,
+              '../resources/GENERAL_GUIDANCE.md',
+            ),
             'utf-8',
           ),
         },
@@ -330,8 +333,8 @@ export const registerGeneralGuidanceTool = (server: McpServer) => {
 exports[`ts#nx-plugin generator > should generate MCP server files > test-plugin/src/mcp-server/tools/generator-guide.ts 1`] = `
 "import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
-import { renderGeneratorInfo, listGenerators } from '../utils';
-import { PackageManagerSchema } from '../schema';
+import { renderGeneratorInfo, listGenerators } from '../utils.js';
+import { PackageManagerSchema } from '../schema.js';
 import * as fs from 'fs';
 import * as path from 'path';
 
@@ -379,8 +382,8 @@ export const registerGeneratorGuideTool = (server: McpServer) => {
 
 exports[`ts#nx-plugin generator > should generate MCP server files > test-plugin/src/mcp-server/tools/list-generators.ts 1`] = `
 "import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { PackageManagerSchema } from '../schema';
-import { renderGeneratorInfo, listGenerators } from '../utils';
+import { PackageManagerSchema } from '../schema.js';
+import { renderGeneratorInfo, listGenerators } from '../utils.js';
 
 /**
  * Registers a tool which lists details about the available generators
@@ -423,20 +426,29 @@ export interface NxGeneratorInfo {
 
 export const getPackageName = (): string =>
   JSON.parse(
-    fs.readFileSync(path.resolve(__dirname, '../../package.json'), 'utf-8'),
+    fs.readFileSync(
+      path.resolve(import.meta.dirname, '../../package.json'),
+      'utf-8',
+    ),
   ).name;
 
 export const listGenerators = (): NxGeneratorInfo[] =>
   Object.entries(
     JSON.parse(
       fs.readFileSync(
-        path.resolve(__dirname, '../../generators.json'),
+        path.resolve(import.meta.dirname, '../../generators.json'),
         'utf-8',
       ),
     ).generators,
   ).map(([id, info]: any) => ({
     id,
-    resolvedPath: path.resolve(__dirname, '..', '..', info.factory, '..'),
+    resolvedPath: path.resolve(
+      import.meta.dirname,
+      '..',
+      '..',
+      info.factory,
+      '..',
+    ),
     description: info.description,
   }));
 

package/src/ts/nx-plugin/files/mcp-server/server.ts.template

@@ -1,9 +1,9 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { registerCreateWorkspaceCommandTool } from './tools/create-workspace-command';
-import { registerGeneralGuidanceTool } from './tools/general-guidance';
-import { registerListGeneratorsTool } from './tools/list-generators';
-import { registerGeneratorGuideTool } from './tools/generator-guide';
-import { getPackageName } from './utils';
+import { registerCreateWorkspaceCommandTool } from './tools/create-workspace-command<% if (esm) { %>.js<% } %>';
+import { registerGeneralGuidanceTool } from './tools/general-guidance<% if (esm) { %>.js<% } %>';
+import { registerListGeneratorsTool } from './tools/list-generators<% if (esm) { %>.js<% } %>';
+import { registerGeneratorGuideTool } from './tools/generator-guide<% if (esm) { %>.js<% } %>';
+import { getPackageName } from './utils<% if (esm) { %>.js<% } %>';
 
 /**
  * Create the MCP Server

package/src/ts/nx-plugin/files/mcp-server/tools/create-workspace-command.ts.template

@@ -1,7 +1,7 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
-import { PackageManagerSchema } from '../schema';
-import { buildCreateCommand, buildInstallCommand, getPackageName } from '../utils';
+import { PackageManagerSchema } from '../schema<% if (esm) { %>.js<% } %>';
+import { buildCreateCommand, buildInstallCommand, getPackageName } from '../utils<% if (esm) { %>.js<% } %>';
 
 /**
  * Registers a tool which tells a model how to create an Nx workspace

package/src/ts/nx-plugin/files/mcp-server/tools/general-guidance.ts.template

@@ -16,7 +16,7 @@ export const registerGeneralGuidanceTool = (server: McpServer) => {
         {
           type: 'text' as const,
           text: fs.readFileSync(
-            path.resolve(__dirname, '../resources/GENERAL_GUIDANCE.md'),
+            path.resolve(<% if (esm) { %>import.meta.dirname<% } else { %>__dirname<% } %>, '../resources/GENERAL_GUIDANCE.md'),
             'utf-8',
           ),
         },

package/src/ts/nx-plugin/files/mcp-server/tools/generator-guide.ts.template

@@ -1,7 +1,7 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
-import { renderGeneratorInfo, listGenerators } from '../utils';
-import { PackageManagerSchema } from '../schema';
+import { renderGeneratorInfo, listGenerators } from '../utils<% if (esm) { %>.js<% } %>';
+import { PackageManagerSchema } from '../schema<% if (esm) { %>.js<% } %>';
 import * as fs from 'fs';
 import * as path from 'path';
 

package/src/ts/nx-plugin/files/mcp-server/tools/list-generators.ts.template

@@ -1,6 +1,6 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { PackageManagerSchema } from '../schema';
-import { renderGeneratorInfo, listGenerators } from '../utils';
+import { PackageManagerSchema } from '../schema<% if (esm) { %>.js<% } %>';
+import { renderGeneratorInfo, listGenerators } from '../utils<% if (esm) { %>.js<% } %>';
 
 /**
  * Registers a tool which lists details about the available generators

package/src/ts/nx-plugin/files/mcp-server/utils.ts.template

@@ -9,20 +9,20 @@ export interface NxGeneratorInfo {
 
 export const getPackageName = (): string =>
   JSON.parse(
-    fs.readFileSync(path.resolve(__dirname, '../../package.json'), 'utf-8'),
+    fs.readFileSync(path.resolve(<% if (esm) { %>import.meta.dirname<% } else { %>__dirname<% } %>, '../../package.json'), 'utf-8'),
   ).name;
 
 export const listGenerators = (): NxGeneratorInfo[] =>
   Object.entries(
     JSON.parse(
       fs.readFileSync(
-        path.resolve(__dirname, '../../generators.json'),
+        path.resolve(<% if (esm) { %>import.meta.dirname<% } else { %>__dirname<% } %>, '../../generators.json'),
         'utf-8',
       ),
     ).generators,
   ).map(([id, info]: any) => ({
     id,
-    resolvedPath: path.resolve(__dirname, '..', '..', info.factory, '..'),
+    resolvedPath: path.resolve(<% if (esm) { %>import.meta.dirname<% } else { %>__dirname<% } %>, '..', '..', info.factory, '..'),
     description: info.description,
   }));
 

package/src/ts/nx-plugin/generator.d.ts

@@ -2,9 +2,9 @@
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
-import { GeneratorCallback, Tree } from '@nx/devkit';
-import { TsNxPluginGeneratorSchema } from './schema';
-import { NxGeneratorInfo } from '../../utils/nx';
+import { type GeneratorCallback, type Tree } from '@nx/devkit';
+import { type NxGeneratorInfo } from '../../utils/nx';
+import type { TsNxPluginGeneratorSchema } from './schema';
 export declare const TS_NX_PLUGIN_GENERATOR_INFO: NxGeneratorInfo;
 export declare const tsNxPluginGenerator: (tree: Tree, options: TsNxPluginGeneratorSchema) => Promise<GeneratorCallback>;
 export default tsNxPluginGenerator;