@aws/nx-plugin 0.18.3 → 0.19.0

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

@@ -0,0 +1,263 @@
+// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
+
+exports[`nx-generator generator > within @aws/nx-plugin > should add guide page to docs > guide-page.mdx 1`] = `
+"---
+title: foo#bar
+description: Some description
+---
+
+import { FileTree } from '@astrojs/starlight/components';
+import RunGenerator from '@components/run-generator.astro';
+import GeneratorParameters from '@components/generator-parameters.astro';
+import schema from '../../../../../../packages/nx-plugin/src/foo-bar/schema.json';
+
+TODO: Add an overview of your generator here.
+
+## Usage
+
+### Generate a foo#bar
+
+You can generate a foo#bar in two ways:
+
+<RunGenerator generator="foo#bar" />
+
+### Options
+
+<GeneratorParameters schema={schema} />
+
+## Generator Output
+
+The generator will create the following project files:
+
+<FileTree>
+  - todo.txt Update this section with what your generator generates!
+</FileTree>
+
+## TODO: More Docs!
+
+Add more documentation detailing things like:
+
+- How to work with the project/code you've generated
+- What new project.json targets have been added and how to run them (using the NxCommands component)
+- Best practices when working with your generated project/code
+
+See the existing guides for concrete examples.
+"
+`;
+
+exports[`nx-generator generator > within @aws/nx-plugin > should generate an example schema, generator and test > generator.spec.ts 1`] = `
+"import { Tree } from '@nx/devkit';
+import { fooBarGenerator, FOO_BAR_GENERATOR_INFO } from './generator';
+import { createTreeUsingTsSolutionSetup } from '../utils/test';
+import { expectHasMetricTags } from '../utils/metrics.spec';
+import { sharedConstructsGenerator } from '../utils/shared-constructs';
+
+describe('foo#bar generator', () => {
+  let tree: Tree;
+
+  beforeEach(() => {
+    tree = createTreeUsingTsSolutionSetup();
+  });
+
+  it('should run successfully', async () => {
+    await fooBarGenerator(tree, { exampleOption: 'example' });
+
+    // TODO: check the tree is updated as expected
+  });
+
+  it('should add generator metric to app.ts', async () => {
+    await sharedConstructsGenerator(tree);
+
+    await fooBarGenerator(tree, { exampleOption: 'example' });
+
+    expectHasMetricTags(tree, FOO_BAR_GENERATOR_INFO.metric);
+  });
+});
+"
+`;
+
+exports[`nx-generator generator > within @aws/nx-plugin > should generate an example schema, generator and test > generator.ts 1`] = `
+"import { GeneratorCallback, Tree, installPackagesTask } from '@nx/devkit';
+import { FooBarGeneratorSchema } from './schema';
+import { NxGeneratorInfo, getGeneratorInfo } from '../utils/nx';
+import { addGeneratorMetricsIfApplicable } from '../utils/metrics';
+import { formatFilesInSubtree } from '../utils/format';
+
+export const FOO_BAR_GENERATOR_INFO: NxGeneratorInfo =
+  getGeneratorInfo(__filename);
+
+export const fooBarGenerator = async (
+  tree: Tree,
+  options: FooBarGeneratorSchema,
+): Promise<GeneratorCallback> => {
+  // TODO: implement your generator here
+
+  await addGeneratorMetricsIfApplicable(tree, [FOO_BAR_GENERATOR_INFO]);
+
+  await formatFilesInSubtree(tree);
+  return () => {
+    installPackagesTask(tree);
+  };
+};
+
+export default fooBarGenerator;
+"
+`;
+
+exports[`nx-generator generator > within @aws/nx-plugin > should generate an example schema, generator and test > schema.d.ts 1`] = `
+"/**
+ * TypeScript types for options defined in schema.json
+ * Update this to match schema.json if you make changes.
+ */
+export interface FooBarGeneratorSchema {
+  // Replace with your options
+  exampleOption: string;
+}
+"
+`;
+
+exports[`nx-generator generator > within @aws/nx-plugin > should generate an example schema, generator and test > schema.json 1`] = `
+"{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "foo#bar",
+  "title": "foo#bar",
+  "description": "<Describe your generator here!>",
+  "type": "object",
+  "properties": {
+    "exampleOption": {
+      "type": "string",
+      "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!"
+    }
+  },
+  "required": ["exampleOption"]
+}
+"
+`;
+
+exports[`nx-generator generator > within @aws/nx-plugin > should update generators.json > generators.json 1`] = `
+"{
+  "generators": {
+    "existing": {
+      "factory": "./some/generator",
+      "schema": "./some/schema.json",
+      "description": "existing generator",
+      "metric": "g40"
+    },
+    "another": {
+      "factory": "./some/other/generator",
+      "schema": "./some/other/schema.json",
+      "description": "other existing generator",
+      "metric": "g41"
+    },
+    "foo#bar": {
+      "factory": "./src/foo-bar/generator",
+      "schema": "./src/foo-bar/schema.json",
+      "description": "Some description",
+      "metric": "g42"
+    }
+  }
+}
+"
+`;
+
+exports[`nx-generator generator > within another workspace > should generate an example schema, generator and test > local-generator.spec.ts 1`] = `
+"import { createTreeWithEmptyWorkspace } from '@nx/devkit/testing';
+import { Tree } from '@nx/devkit';
+import { fooBarGenerator } from './generator';
+
+describe('foo#bar generator', () => {
+  let tree: Tree;
+
+  beforeEach(() => {
+    tree = createTreeWithEmptyWorkspace();
+  });
+
+  it('should run successfully', async () => {
+    await fooBarGenerator(tree, { exampleOption: 'example' });
+
+    // TODO: check the tree is updated as expected
+  });
+});
+"
+`;
+
+exports[`nx-generator generator > within another workspace > should generate an example schema, generator and test > local-generator.ts 1`] = `
+"import {
+  GeneratorCallback,
+  Tree,
+  generateFiles,
+  joinPathFragments,
+} from '@nx/devkit';
+import { FooBarGeneratorSchema } from './schema';
+
+export const fooBarGenerator = async (
+  tree: Tree,
+  options: FooBarGeneratorSchema,
+): Promise<GeneratorCallback | void> => {
+  // TODO: implement your generator here, for example:
+  generateFiles(
+    tree,
+    joinPathFragments(__dirname, 'files'),
+    'target/dir',
+    options,
+  );
+};
+
+export default fooBarGenerator;
+"
+`;
+
+exports[`nx-generator generator > within another workspace > should generate an example schema, generator and test > local-schema.d.ts 1`] = `
+"/**
+ * TypeScript types for options defined in schema.json
+ * Update this to match schema.json if you make changes.
+ */
+export interface FooBarGeneratorSchema {
+  // Replace with your options
+  exampleOption: string;
+}
+"
+`;
+
+exports[`nx-generator generator > within another workspace > should generate an example schema, generator and test > local-schema.json 1`] = `
+"{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "foo#bar",
+  "title": "foo#bar",
+  "description": "<Describe your generator here!>",
+  "type": "object",
+  "properties": {
+    "exampleOption": {
+      "type": "string",
+      "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!"
+    }
+  },
+  "required": ["exampleOption"]
+}
+"
+`;
+
+exports[`nx-generator generator > within another workspace > should generate an example template file > hello.ts.template 1`] = `
+"
+export const hello = () => {
+  return '<%- exampleOption %>';
+};
+"
+`;
+
+exports[`nx-generator generator > within another workspace > should update generators.json > local-generators.json 1`] = `
+"{
+  "generators": {
+    "foo#bar": {
+      "factory": "./src/foo-bar/generator",
+      "schema": "./src/foo-bar/schema.json",
+      "description": "Some description"
+    }
+  }
+}
+"
+`;

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

@@ -0,0 +1,8 @@
+/**
+ * TypeScript types for options defined in schema.json
+ * Update this to match schema.json if you make changes.
+ */
+export interface <%- namePascalCase %>GeneratorSchema {
+  // Replace with your options
+  exampleOption: string;
+}

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

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "<%- name %>",
+  "title": "<%- name %>",
+  "description": "<Describe your generator here!>",
+  "type": "object",
+  "properties": {
+    "exampleOption": {
+      "type": "string",
+      "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!"
+    }
+  },
+  "required": ["exampleOption"]
+}

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

@@ -0,0 +1,4 @@
+
+export const hello = () => {
+  return '<%%- exampleOption %>';
+};

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

@@ -0,0 +1,17 @@
+import { createTreeWithEmptyWorkspace } from '@nx/devkit/testing';
+import { Tree } from '@nx/devkit';
+import { <%- nameCamelCase %>Generator } from './generator';
+
+describe('<%- name %> generator', () => {
+  let tree: Tree;
+
+  beforeEach(() => {
+    tree = createTreeWithEmptyWorkspace();
+  });
+
+  it('should run successfully', async () => {
+    await <%- nameCamelCase %>Generator(tree, { exampleOption: 'example' });
+
+    // TODO: check the tree is updated as expected
+  });
+});

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

@@ -0,0 +1,9 @@
+import { GeneratorCallback, Tree, generateFiles, joinPathFragments } from "@nx/devkit";
+import { <%- namePascalCase %>GeneratorSchema } from './schema';
+
+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);
+};
+
+export default <%- nameCamelCase %>Generator;

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

@@ -0,0 +1,41 @@
+---
+title: <%- name %>
+description: <%- description ?? 'TODO - A short description of your generator' %>
+---
+
+import { FileTree } from '@astrojs/starlight/components';
+import RunGenerator from '@components/run-generator.astro';
+import GeneratorParameters from '@components/generator-parameters.astro';
+import schema from '../../../../../../packages/nx-plugin/src/<%- generatorSubDir %>/schema.json';
+
+TODO: Add an overview of your generator here.
+
+## Usage
+
+### Generate a <%- name %>
+
+You can generate a <%- name %> in two ways:
+
+<RunGenerator generator="<%- name %>" />
+
+### Options
+
+<GeneratorParameters schema={schema} />
+
+## Generator Output
+
+The generator will create the following project files:
+
+<FileTree>
+ - todo.txt Update this section with what your generator generates!
+</FileTree>
+
+## TODO: More Docs!
+
+Add more documentation detailing things like:
+
+- How to work with the project/code you've generated
+- What new project.json targets have been added and how to run them (using the NxCommands component)
+- Best practices when working with your generated project/code
+
+See the existing guides for concrete examples.

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

@@ -0,0 +1,27 @@
+import { Tree } from '@nx/devkit';
+import { <%- nameCamelCase %>Generator, <%- nameUpperSnakeCase %>_GENERATOR_INFO } from './generator';
+import { createTreeUsingTsSolutionSetup } from '<%- pathToProjectSourceRoot %>utils/test';
+import { expectHasMetricTags } from '<%- pathToProjectSourceRoot %>utils/metrics.spec';
+import { sharedConstructsGenerator } from '<%- pathToProjectSourceRoot %>utils/shared-constructs';
+
+describe('<%- name %> generator', () => {
+  let tree: Tree;
+
+  beforeEach(() => {
+    tree = createTreeUsingTsSolutionSetup();
+  });
+
+  it('should run successfully', async () => {
+    await <%- nameCamelCase %>Generator(tree, { exampleOption: 'example' });
+
+    // TODO: check the tree is updated as expected
+  });
+
+  it('should add generator metric to app.ts', async () => {
+    await sharedConstructsGenerator(tree);
+
+    await <%- nameCamelCase %>Generator(tree, { exampleOption: 'example' });
+
+    expectHasMetricTags(tree, <%- nameUpperSnakeCase %>_GENERATOR_INFO.metric);
+  });
+});

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

@@ -0,0 +1,22 @@
+import { GeneratorCallback, Tree, installPackagesTask } from "@nx/devkit";
+import { <%- namePascalCase %>GeneratorSchema } from './schema';
+import { NxGeneratorInfo, getGeneratorInfo } from '<%- pathToProjectSourceRoot %>utils/nx';
+import { addGeneratorMetricsIfApplicable } from '<%- pathToProjectSourceRoot %>utils/metrics';
+import { formatFilesInSubtree } from '<%- pathToProjectSourceRoot %>utils/format';
+
+export const <%- nameUpperSnakeCase %>_GENERATOR_INFO: NxGeneratorInfo =
+  getGeneratorInfo(__filename);
+
+export const <%- nameCamelCase %>Generator = async (tree: Tree, options: <%- namePascalCase %>GeneratorSchema): Promise<GeneratorCallback> => {
+
+  // TODO: implement your generator here
+
+  await addGeneratorMetricsIfApplicable(tree, [<%- nameUpperSnakeCase %>_GENERATOR_INFO]);
+
+  await formatFilesInSubtree(tree);
+  return () => {
+    installPackagesTask(tree);
+  };
+};
+
+export default <%- nameCamelCase %>Generator;

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

@@ -0,0 +1,9 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { GeneratorCallback, Tree } from '@nx/devkit';
+import { NxGeneratorGeneratorSchema } from './schema';
+export declare const NX_GENERATOR_GENERATOR_INFO: import("../../utils/nx").NxGeneratorInfo;
+export declare const nxGeneratorGenerator: (tree: Tree, options: NxGeneratorGeneratorSchema) => Promise<GeneratorCallback | void>;
+export default nxGeneratorGenerator;

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

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nxGeneratorGenerator = 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 lodash_kebabcase_1 = tslib_1.__importDefault(require("lodash.kebabcase"));
+const names_1 = require("../../utils/names");
+const lodash_camelcase_1 = tslib_1.__importDefault(require("lodash.camelcase"));
+const paths_1 = require("../../utils/paths");
+const lodash_snakecase_1 = tslib_1.__importDefault(require("lodash.snakecase"));
+const ast_1 = require("../../utils/ast");
+const typescript_1 = require("typescript");
+const package_json_1 = tslib_1.__importDefault(require("../../../package.json"));
+const nx_1 = require("../../utils/nx");
+const metrics_1 = require("../../utils/metrics");
+const versions_1 = require("../../utils/versions");
+const format_1 = require("../../utils/format");
+exports.NX_GENERATOR_GENERATOR_INFO = (0, nx_1.getGeneratorInfo)(__filename);
+const nxGeneratorGenerator = (tree, options) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b;
+    const { name, directory, pluginProject, description } = options;
+    const plugin = (0, devkit_1.readProjectConfiguration)(tree, pluginProject);
+    const sourceRoot = (_a = plugin.sourceRoot) !== null && _a !== void 0 ? _a : (0, devkit_1.joinPathFragments)(plugin.root, 'src');
+    const sourceRootParts = sourceRoot.split('/');
+    const srcDir = sourceRootParts[sourceRootParts.length - 1];
+    const generatorSubDir = directory !== null && directory !== void 0 ? directory : (0, lodash_kebabcase_1.default)(name);
+    const generatorDir = (0, devkit_1.joinPathFragments)(sourceRoot, generatorSubDir);
+    const rootPackageJson = tree.exists('package.json')
+        ? (0, devkit_1.readJson)(tree, 'package.json')
+        : undefined;
+    const isNxPluginForAws = (rootPackageJson === null || rootPackageJson === void 0 ? void 0 : rootPackageJson.name) === '@aws/nx-plugin-source';
+    const tsConfigPath = (0, devkit_1.joinPathFragments)(plugin.root, 'tsconfig.json');
+    if (!tree.exists(tsConfigPath)) {
+        throw new Error(`Selected plugin project ${pluginProject} is not a TypeScript project`);
+    }
+    // Generators must use commonjs as a limitation of nx
+    // https://github.com/nrwl/nx/issues/15682
+    (0, devkit_1.updateJson)(tree, tsConfigPath, (tsConfig) => {
+        var _a, _b;
+        var _c;
+        (_a = tsConfig.compilerOptions) !== null && _a !== void 0 ? _a : (tsConfig.compilerOptions = {});
+        (_b = (_c = tsConfig.compilerOptions).module) !== null && _b !== void 0 ? _b : (_c.module = 'commonjs');
+        return tsConfig;
+    });
+    const enhancedOptions = {
+        name,
+        description,
+        namePascalCase: (0, names_1.pascalCase)(name),
+        nameCamelCase: (0, lodash_camelcase_1.default)(name),
+        nameKebabCase: (0, lodash_kebabcase_1.default)(name),
+        nameUpperSnakeCase: (0, lodash_snakecase_1.default)(name).toUpperCase(),
+        isNxPluginForAws,
+        pathToProjectSourceRoot: (0, paths_1.getRelativePathToRootByDirectory)(generatorSubDir),
+        generatorDir,
+        generatorSubDir,
+    };
+    // Add the common files
+    (0, devkit_1.generateFiles)(tree, (0, devkit_1.joinPathFragments)(__dirname, 'files', 'common'), generatorDir, Object.assign({}, enhancedOptions));
+    // 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.`);
+        }
+        // Add the generator
+        (0, devkit_1.generateFiles)(tree, (0, devkit_1.joinPathFragments)(__dirname, 'files', 'nx-plugin-for-aws', 'generator'), generatorDir, Object.assign({}, enhancedOptions));
+        // 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'), Object.assign({}, enhancedOptions));
+        // Update the docs config to add the page entry
+        (0, ast_1.replace)(tree, (0, devkit_1.joinPathFragments)('docs', 'astro.config.mjs'), 'PropertyAssignment:has(Identifier[name="integrations"]) PropertyAssignment:has(Identifier[name="sidebar"]) ObjectLiteralExpression:has(PropertyAssignment:has(StringLiteral[value="Guides"])) PropertyAssignment:has(Identifier[name="items"]) > ArrayLiteralExpression', (node) => {
+            return typescript_1.factory.createArrayLiteralExpression([
+                ...node.elements,
+                typescript_1.factory.createObjectLiteralExpression([
+                    typescript_1.factory.createPropertyAssignment('label', typescript_1.factory.createStringLiteral(name, true)),
+                    typescript_1.factory.createPropertyAssignment('link', typescript_1.factory.createStringLiteral(`/guides/${enhancedOptions.nameKebabCase}`, true)),
+                ]),
+            ]);
+        });
+    }
+    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, Object.assign({}, enhancedOptions));
+        const indexPath = (0, devkit_1.joinPathFragments)(sourceRoot, 'index.ts');
+        if (tree.exists(indexPath)) {
+            (0, ast_1.addStarExport)(tree, indexPath, `./${generatorSubDir}/generator`);
+        }
+    }
+    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((_b = generatorsJson === null || generatorsJson === void 0 ? void 0 : generatorsJson.generators) !== null && _b !== void 0 ? _b : {});
+    (0, devkit_1.writeJson)(tree, generatorsJsonPath, Object.assign(Object.assign({}, generatorsJson), { generators: Object.assign(Object.assign({}, generatorsJson === null || generatorsJson === void 0 ? void 0 : generatorsJson.generators), { [name]: Object.assign({ factory: `${factoryBasePath}/generator`, schema: `${factoryBasePath}/schema.json`, description: description !== null && description !== void 0 ? description : 'TODO: Add short description of the generator' }, (isNxPluginForAws
+                ? {
+                    metric: existingGenerators.length > 0
+                        ? incrementMetric(existingGenerators[existingGenerators.length - 1].metric)
+                        : 'g1',
+                }
+                : {})) }) }));
+    // Add the "generators" and "main" entries to package.json
+    const pluginPackageJsonPath = (0, devkit_1.joinPathFragments)(plugin.root, 'package.json');
+    if (!tree.exists(pluginPackageJsonPath)) {
+        // Write a simple package.json to ensure the generator can be found by the Nx VSCode extension
+        (0, devkit_1.writeJson)(tree, pluginPackageJsonPath, {
+            name: plugin.name,
+        });
+    }
+    (0, devkit_1.updateJson)(tree, pluginPackageJsonPath, (pkg) => {
+        var _a, _b;
+        (_a = pkg.main) !== null && _a !== void 0 ? _a : (pkg.main = './src/index.js');
+        (_b = pkg.generators) !== null && _b !== void 0 ? _b : (pkg.generators = './generators.json');
+        return pkg;
+    });
+    if (!isNxPluginForAws) {
+        // Add the required dependencies to the root package.json, and project's package.json
+        const deps = (0, versions_1.withVersions)(['@nx/devkit']);
+        (0, devkit_1.addDependenciesToPackageJson)(tree, {}, deps);
+        (0, devkit_1.addDependenciesToPackageJson)(tree, deps, {}, pluginPackageJsonPath);
+    }
+    yield (0, metrics_1.addGeneratorMetricsIfApplicable)(tree, [exports.NX_GENERATOR_GENERATOR_INFO]);
+    yield (0, format_1.formatFilesInSubtree)(tree);
+    return () => {
+        (0, devkit_1.installPackagesTask)(tree);
+    };
+});
+exports.nxGeneratorGenerator = nxGeneratorGenerator;
+const incrementMetric = (metric) => {
+    return `g${Number(metric.slice(1)) + 1}`;
+};
+exports.default = exports.nxGeneratorGenerator;
+//# sourceMappingURL=generator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../packages/nx-plugin/src/ts/nx-generator/generator.ts"],"names":[],"mappings":";;;;AAAA;;;GAGG;AACH,uCAWoB;AAEpB,gFAAyC;AACzC,6CAA+C;AAC/C,gFAAyC;AACzC,6CAAqE;AACrE,gFAAyC;AACzC,yCAAyD;AACzD,2CAA6D;AAC7D,iFAA8D;AAC9D,uCAAkD;AAClD,iDAAsE;AACtE,mDAAoD;AACpD,+CAA0D;AAE7C,QAAA,2BAA2B,GAAG,IAAA,qBAAgB,EAAC,UAAU,CAAC,CAAC;AAEjE,MAAM,oBAAoB,GAAG,CAClC,IAAU,EACV,OAAmC,EACA,EAAE;;IACrC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAEhE,MAAM,MAAM,GAAG,IAAA,iCAAwB,EAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAC7D,MAAM,UAAU,GAAG,MAAA,MAAM,CAAC,UAAU,mCAAI,IAAA,0BAAiB,EAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC9E,MAAM,eAAe,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,eAAe,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3D,MAAM,eAAe,GAAG,SAAS,aAAT,SAAS,cAAT,SAAS,GAAI,IAAA,0BAAS,EAAC,IAAI,CAAC,CAAC;IACrD,MAAM,YAAY,GAAG,IAAA,0BAAiB,EAAC,UAAU,EAAE,eAAe,CAAC,CAAC;IAEpE,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;QACjD,CAAC,CAAC,IAAA,iBAAQ,EAAC,IAAI,EAAE,cAAc,CAAC;QAChC,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,gBAAgB,GAAG,CAAA,eAAe,aAAf,eAAe,uBAAf,eAAe,CAAE,IAAI,MAAK,uBAAuB,CAAC;IAE3E,MAAM,YAAY,GAAG,IAAA,0BAAiB,EAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IACrE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CACb,2BAA2B,aAAa,8BAA8B,CACvE,CAAC;IACJ,CAAC;IAED,qDAAqD;IACrD,0CAA0C;IAC1C,IAAA,mBAAU,EAAC,IAAI,EAAE,YAAY,EAAE,CAAC,QAAQ,EAAE,EAAE;;;QAC1C,MAAA,QAAQ,CAAC,eAAe,oCAAxB,QAAQ,CAAC,eAAe,GAAK,EAAE,EAAC;QAChC,YAAA,QAAQ,CAAC,eAAe,EAAC,MAAM,uCAAN,MAAM,GAAK,UAAU,EAAC;QAC/C,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,MAAM,eAAe,GAAG;QACtB,IAAI;QACJ,WAAW;QACX,cAAc,EAAE,IAAA,kBAAU,EAAC,IAAI,CAAC;QAChC,aAAa,EAAE,IAAA,0BAAS,EAAC,IAAI,CAAC;QAC9B,aAAa,EAAE,IAAA,0BAAS,EAAC,IAAI,CAAC;QAC9B,kBAAkB,EAAE,IAAA,0BAAS,EAAC,IAAI,CAAC,CAAC,WAAW,EAAE;QACjD,gBAAgB;QAChB,uBAAuB,EAAE,IAAA,wCAAgC,EAAC,eAAe,CAAC;QAC1E,YAAY;QACZ,eAAe;KAChB,CAAC;IAEF,uBAAuB;IACvB,IAAA,sBAAa,EACX,IAAI,EACJ,IAAA,0BAAiB,EAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC,EAC/C,YAAY,oBAEP,eAAe,EAErB,CAAC;IAEF,8EAA8E;IAC9E,IAAI,gBAAgB,EAAE,CAAC;QACrB,qDAAqD;QACrD,IAAI,aAAa,KAAK,sBAAyB,CAAC,IAAI,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CACb,qCAAqC,sBAAyB,CAAC,IAAI,WAAW,CAC/E,CAAC;QACJ,CAAC;QAED,oBAAoB;QACpB,IAAA,sBAAa,EACX,IAAI,EACJ,IAAA,0BAAiB,EAAC,SAAS,EAAE,OAAO,EAAE,mBAAmB,EAAE,WAAW,CAAC,EACvE,YAAY,oBAEP,eAAe,EAErB,CAAC;QAEF,8BAA8B;QAC9B,IAAA,sBAAa,EACX,IAAI,EACJ,IAAA,0BAAiB,EAAC,SAAS,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,CAAC,EAClE,IAAA,0BAAiB,EAAC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,oBAE9D,eAAe,EAErB,CAAC;QAEF,+CAA+C;QAC/C,IAAA,aAAO,EACL,IAAI,EACJ,IAAA,0BAAiB,EAAC,MAAM,EAAE,kBAAkB,CAAC,EAC7C,yQAAyQ,EACzQ,CAAC,IAA4B,EAAE,EAAE;YAC/B,OAAO,oBAAO,CAAC,4BAA4B,CAAC;gBAC1C,GAAG,IAAI,CAAC,QAAQ;gBAChB,oBAAO,CAAC,6BAA6B,CAAC;oBACpC,oBAAO,CAAC,wBAAwB,CAC9B,OAAO,EACP,oBAAO,CAAC,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,CACxC;oBACD,oBAAO,CAAC,wBAAwB,CAC9B,MAAM,EACN,oBAAO,CAAC,mBAAmB,CACzB,WAAW,eAAe,CAAC,aAAa,EAAE,EAC1C,IAAI,CACL,CACF;iBACF,CAAC;aACH,CAAC,CAAC;QACL,CAAC,CACF,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,4DAA4D;QAC5D,IAAA,sBAAa,EACX,IAAI,EACJ,IAAA,0BAAiB,EAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,EAC9C,YAAY,oBAEP,eAAe,EAErB,CAAC;QAEF,MAAM,SAAS,GAAG,IAAA,0BAAiB,EAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAC5D,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,IAAA,mBAAa,EAAC,IAAI,EAAE,SAAS,EAAE,KAAK,eAAe,YAAY,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,MAAM,eAAe,GAAG,KAAK,MAAM,IAAI,eAAe,EAAE,CAAC;IAEzD,yBAAyB;IACzB,MAAM,kBAAkB,GAAG,IAAA,0BAAiB,EAAC,MAAM,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;IAC7E,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC;QACpD,CAAC,CAAC,IAAA,iBAAQ,EAAC,IAAI,EAAE,kBAAkB,CAAC;QACpC,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IACvB,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CACtC,MAAA,cAAc,aAAd,cAAc,uBAAd,cAAc,CAAE,UAAU,mCAAI,EAAE,CACxB,CAAC;IACX,IAAA,kBAAS,EAAC,IAAI,EAAE,kBAAkB,kCAC7B,cAAc,KACjB,UAAU,kCACL,cAAc,aAAd,cAAc,uBAAd,cAAc,CAAE,UAAU,KAC7B,CAAC,IAAI,CAAC,kBACJ,OAAO,EAAE,GAAG,eAAe,YAAY,EACvC,MAAM,EAAE,GAAG,eAAe,cAAc,EACxC,WAAW,EACT,WAAW,aAAX,WAAW,cAAX,WAAW,GAAI,8CAA8C,IAC5D,CAAC,gBAAgB;gBAClB,CAAC,CAAC;oBACE,MAAM,EACJ,kBAAkB,CAAC,MAAM,GAAG,CAAC;wBAC3B,CAAC,CAAC,eAAe,CACb,kBAAkB,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CACzD;wBACH,CAAC,CAAC,IAAI;iBACX;gBACH,CAAC,CAAC,EAAE,CAAC,QAGX,CAAC;IAEH,0DAA0D;IAC1D,MAAM,qBAAqB,GAAG,IAAA,0BAAiB,EAAC,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IAC7E,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,qBAAqB,CAAC,EAAE,CAAC;QACxC,8FAA8F;QAC9F,IAAA,kBAAS,EAAC,IAAI,EAAE,qBAAqB,EAAE;YACrC,IAAI,EAAE,MAAM,CAAC,IAAI;SAClB,CAAC,CAAC;IACL,CAAC;IACD,IAAA,mBAAU,EAAC,IAAI,EAAE,qBAAqB,EAAE,CAAC,GAAG,EAAE,EAAE;;QAC9C,MAAA,GAAG,CAAC,IAAI,oCAAR,GAAG,CAAC,IAAI,GAAK,gBAAgB,EAAC;QAC9B,MAAA,GAAG,CAAC,UAAU,oCAAd,GAAG,CAAC,UAAU,GAAK,mBAAmB,EAAC;QACvC,OAAO,GAAG,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,qFAAqF;QACrF,MAAM,IAAI,GAAG,IAAA,uBAAY,EAAC,CAAC,YAAY,CAAC,CAAC,CAAC;QAC1C,IAAA,qCAA4B,EAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;QAC7C,IAAA,qCAA4B,EAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,qBAAqB,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,IAAA,yCAA+B,EAAC,IAAI,EAAE,CAAC,mCAA2B,CAAC,CAAC,CAAC;IAE3E,MAAM,IAAA,6BAAoB,EAAC,IAAI,CAAC,CAAC;IAEjC,OAAO,GAAG,EAAE;QACV,IAAA,4BAAmB,EAAC,IAAI,CAAC,CAAC;IAC5B,CAAC,CAAC;AACJ,CAAC,CAAA,CAAC;AA3LW,QAAA,oBAAoB,wBA2L/B;AAEF,MAAM,eAAe,GAAG,CAAC,MAAc,EAAU,EAAE;IACjD,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;AAC3C,CAAC,CAAC;AAEF,kBAAe,4BAAoB,CAAC"}

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

@@ -0,0 +1,11 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export interface NxGeneratorGeneratorSchema {
+  pluginProject: string;
+  name: string;
+  directory?: string;
+  description?: string;
+}

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

@@ -0,0 +1,38 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "TsGenerator",
+  "title": "Create an Nx Generator",
+  "description": "Create a TypeScript Nx Generator",
+  "type": "object",
+  "properties": {
+    "pluginProject": {
+      "type": "string",
+      "description": "TypeScript project to add the generator to. We recommend creating a ts#project in a top-level 'tools' directory.",
+      "x-priority": "important",
+      "x-prompt": "Choose the TypeScript project to add the generator to",
+      "x-dropdown": "projects",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      }
+    },
+    "name": {
+      "type": "string",
+      "description": "Generator name",
+      "x-priority": "important",
+      "x-prompt": "Choose a name for your generator, eg (ts#cool-project)"
+    },
+    "description": {
+      "type": "string",
+      "description": "A description of your generator",
+      "x-prompt": "Describe your new generator",
+      "x-priority": "important"
+    },
+    "directory": {
+      "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>)"
+    }
+  },
+  "required": ["pluginProject", "name"]
+}

package/src/utils/versions.d.ts

@@ -12,6 +12,8 @@ export declare const VERSIONS: {
     readonly '@aws-lambda-powertools/metrics': "^2.17.0";
     readonly '@aws-lambda-powertools/tracer': "^2.17.0";
     readonly '@nxlv/python': "^20.12.0";
+    readonly '@nx/devkit': "~20.6.4";
+    readonly '@modelcontextprotocol/sdk': "^1.10.2";
     readonly '@tanstack/react-router': "^1.114.27";
     readonly '@tanstack/router-plugin': "^1.114.27";
     readonly '@cloudscape-design/board-components': "^3.0.94";
@@ -44,5 +46,5 @@ export declare const VERSIONS: {
  * Add versions to the given dependencies
  */
 export declare const withVersions: (deps: (keyof typeof VERSIONS)[]) => {
-    [k: string]: "^0.0.60" | "^2.185.0-alpha.0" | "^3.775.0" | "^2.17.0" | "^20.12.0" | "^1.114.27" | "^3.0.94" | "^3.0.928" | "^1.0.38" | "^5.74.3" | "11.0.0" | "^22.13.13" | "^8.10.148" | "^4.2.0" | "^1.0.20" | "^2.1006.0" | "^2.185.0" | "^3.10.3" | "^10.4.2" | "^0.25.1" | "^5.2.5" | "^2.4.0" | "^3.2.0" | "^3.5.3" | "^0.5.21" | "^4.19.3" | "^5.1.4" | "^3.24.2";
+    [k: string]: "^0.0.60" | "^2.185.0-alpha.0" | "^3.775.0" | "^2.17.0" | "^20.12.0" | "~20.6.4" | "^1.10.2" | "^1.114.27" | "^3.0.94" | "^3.0.928" | "^1.0.38" | "^5.74.3" | "11.0.0" | "^22.13.13" | "^8.10.148" | "^4.2.0" | "^1.0.20" | "^2.1006.0" | "^2.185.0" | "^3.10.3" | "^10.4.2" | "^0.25.1" | "^5.2.5" | "^2.4.0" | "^3.2.0" | "^3.5.3" | "^0.5.21" | "^4.19.3" | "^5.1.4" | "^3.24.2";
 };

package/src/utils/versions.js

@@ -15,6 +15,8 @@ exports.VERSIONS = {
     '@aws-lambda-powertools/metrics': '^2.17.0',
     '@aws-lambda-powertools/tracer': '^2.17.0',
     '@nxlv/python': '^20.12.0',
+    '@nx/devkit': '~20.6.4',
+    '@modelcontextprotocol/sdk': '^1.10.2',
     '@tanstack/react-router': '^1.114.27',
     '@tanstack/router-plugin': '^1.114.27',
     '@cloudscape-design/board-components': '^3.0.94',