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

package/src/utils/module-format.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type Tree } from '@nx/devkit';
+/**
+ * The module format for generated TypeScript code and configuration.
+ */
+export type ModuleFormat = 'esm' | 'cjs';
+/**
+ * Whether the workspace targets ES modules, read from the tree so shared
+ * helpers needn't thread it through call sites. An explicit root `type` wins
+ * (`module`/`commonjs`); when absent (e.g. an adopted Nx workspace) infer ESM
+ * from any sibling project declaring `type: "module"`, else CJS. No root
+ * package.json defaults to ESM.
+ */
+export declare const isEsmWorkspace: (tree: Tree) => boolean;
+/**
+ * Returns the `esm` template variable for `generateFiles` substitutions,
+ * inferred from the workspace root package.json. Spread into the substitution
+ * object wherever a template contains `<% if (esm) { %>` conditionals.
+ */
+export declare const esmVars: (tree: Tree) => {
+    esm: boolean;
+};

package/src/utils/module-format.js

@@ -0,0 +1,45 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ import { getProjects, joinPathFragments, readJson } from "@nx/devkit";
+/**
+ * Whether the workspace targets ES modules, read from the tree so shared
+ * helpers needn't thread it through call sites. An explicit root `type` wins
+ * (`module`/`commonjs`); when absent (e.g. an adopted Nx workspace) infer ESM
+ * from any sibling project declaring `type: "module"`, else CJS. No root
+ * package.json defaults to ESM.
+ */ export const isEsmWorkspace = (tree)=>{
+    if (!tree.exists('package.json')) {
+        return true;
+    }
+    const rootType = readJson(tree, 'package.json').type;
+    if (rootType === 'module') {
+        return true;
+    }
+    if (rootType === 'commonjs') {
+        return false;
+    }
+    // Root `type` is absent: infer from sibling projects' own manifests.
+    return hasEsmProject(tree);
+};
+/** Whether any non-root project declares `type: "module"` in its own manifest. */ const hasEsmProject = (tree)=>{
+    for (const project of getProjects(tree).values()){
+        if (project.root === '.' || project.root === '') {
+            continue;
+        }
+        const packageJsonPath = joinPathFragments(project.root, 'package.json');
+        if (tree.exists(packageJsonPath) && readJson(tree, packageJsonPath).type === 'module') {
+            return true;
+        }
+    }
+    return false;
+};
+/**
+ * Returns the `esm` template variable for `generateFiles` substitutions,
+ * inferred from the workspace root package.json. Spread into the substitution
+ * object wherever a template contains `<% if (esm) { %>` conditionals.
+ */ export const esmVars = (tree)=>({
+        esm: isEsmWorkspace(tree)
+    });
+
+//# sourceMappingURL=module-format.js.map

package/src/utils/module-format.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/nx-plugin/src/utils/module-format.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport {\n  getProjects,\n  joinPathFragments,\n  readJson,\n  type Tree,\n} from '@nx/devkit';\n\n/**\n * The module format for generated TypeScript code and configuration.\n */\nexport type ModuleFormat = 'esm' | 'cjs';\n\n/**\n * Whether the workspace targets ES modules, read from the tree so shared\n * helpers needn't thread it through call sites. An explicit root `type` wins\n * (`module`/`commonjs`); when absent (e.g. an adopted Nx workspace) infer ESM\n * from any sibling project declaring `type: \"module\"`, else CJS. No root\n * package.json defaults to ESM.\n */\nexport const isEsmWorkspace = (tree: Tree): boolean => {\n  if (!tree.exists('package.json')) {\n    return true;\n  }\n  const rootType = readJson(tree, 'package.json').type;\n  if (rootType === 'module') {\n    return true;\n  }\n  if (rootType === 'commonjs') {\n    return false;\n  }\n  // Root `type` is absent: infer from sibling projects' own manifests.\n  return hasEsmProject(tree);\n};\n\n/** Whether any non-root project declares `type: \"module\"` in its own manifest. */\nconst hasEsmProject = (tree: Tree): boolean => {\n  for (const project of getProjects(tree).values()) {\n    if (project.root === '.' || project.root === '') {\n      continue;\n    }\n    const packageJsonPath = joinPathFragments(project.root, 'package.json');\n    if (\n      tree.exists(packageJsonPath) &&\n      readJson(tree, packageJsonPath).type === 'module'\n    ) {\n      return true;\n    }\n  }\n  return false;\n};\n\n/**\n * Returns the `esm` template variable for `generateFiles` substitutions,\n * inferred from the workspace root package.json. Spread into the substitution\n * object wherever a template contains `<% if (esm) { %>` conditionals.\n */\nexport const esmVars = (tree: Tree): { esm: boolean } => ({\n  esm: isEsmWorkspace(tree),\n});\n"],"names":["getProjects","joinPathFragments","readJson","isEsmWorkspace","tree","exists","rootType","type","hasEsmProject","project","values","root","packageJsonPath","esmVars","esm"],"mappings":"AAAA;;;CAGC,GACD,SACEA,WAAW,EACXC,iBAAiB,EACjBC,QAAQ,QAEH,aAAa;AAOpB;;;;;;CAMC,GACD,OAAO,MAAMC,iBAAiB,CAACC;IAC7B,IAAI,CAACA,KAAKC,MAAM,CAAC,iBAAiB;QAChC,OAAO;IACT;IACA,MAAMC,WAAWJ,SAASE,MAAM,gBAAgBG,IAAI;IACpD,IAAID,aAAa,UAAU;QACzB,OAAO;IACT;IACA,IAAIA,aAAa,YAAY;QAC3B,OAAO;IACT;IACA,qEAAqE;IACrE,OAAOE,cAAcJ;AACvB,EAAE;AAEF,gFAAgF,GAChF,MAAMI,gBAAgB,CAACJ;IACrB,KAAK,MAAMK,WAAWT,YAAYI,MAAMM,MAAM,GAAI;QAChD,IAAID,QAAQE,IAAI,KAAK,OAAOF,QAAQE,IAAI,KAAK,IAAI;YAC/C;QACF;QACA,MAAMC,kBAAkBX,kBAAkBQ,QAAQE,IAAI,EAAE;QACxD,IACEP,KAAKC,MAAM,CAACO,oBACZV,SAASE,MAAMQ,iBAAiBL,IAAI,KAAK,UACzC;YACA,OAAO;QACT;IACF;IACA,OAAO;AACT;AAEA;;;;CAIC,GACD,OAAO,MAAMM,UAAU,CAACT,OAAkC,CAAA;QACxDU,KAAKX,eAAeC;IACtB,CAAA,EAAG"}

package/src/utils/names.d.ts

@@ -1,3 +1,9 @@
+/**
+ * camelCase that first transliterates accents and strips any character that is
+ * not a valid identifier character, so inputs like `getFoo≠Bar` or `café` yield
+ * valid JS/TS identifiers rather than leaking the raw symbol into generated code.
+ */
+export declare const camelCase: (str: string) => string;
 export declare const toClassName: (str?: string) => string;
 export declare const toKebabCase: (str?: string) => string;
 export declare const toSnakeCase: (str?: string) => string;
@@ -5,4 +11,20 @@ export declare const upperFirst: (str: string) => string;
 export declare const pascalCase: (str: string) => string;
 export declare const snakeCase: (str: string) => string;
 export declare const kebabCase: (str: string) => string;
+/**
+ * Normalise a string to a PEP 503 distribution name.
+ *
+ * PEP 503 (https://peps.python.org/pep-0503/#normalized-names) defines the
+ * canonical form of a Python project distribution name: lower-cased, with any
+ * run of `.`, `_` or `-` collapsed to a single `-`. This is the name uv writes
+ * into `uv.lock` and the form `@nxlv/python` expects when inferring workspace
+ * dependency edges from `[project].dependencies` / `[tool.uv.sources]`.
+ *
+ * Importantly this is NOT kebab-case: it does not split on camelCase humps,
+ * spaces or other punctuation, so a dotted nx id like `scope.my_lib` becomes
+ * `scope-my-lib` (and only those three separators are touched).
+ *
+ * eg. `sojourner.agent_connection` -> `sojourner-agent-connection`
+ */
+export declare const normalizeDistributionName: (str: string) => string;
 export declare const toDotNotation: (str: string) => string;

package/src/utils/names.js

@@ -1,66 +1,62 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.toDotNotation = exports.kebabCase = exports.snakeCase = exports.pascalCase = exports.upperFirst = exports.toSnakeCase = exports.toKebabCase = exports.toClassName = void 0;
-const tslib_1 = require("tslib");
 /**
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
- */
-const lodash_camelcase_1 = tslib_1.__importDefault(require("lodash.camelcase"));
-const lodash_deburr_1 = tslib_1.__importDefault(require("lodash.deburr"));
-const toClassName = (str) => {
+ */ import lodashCamelCase from "lodash.camelcase";
+import deburr from "lodash.deburr";
+/**
+ * camelCase that first transliterates accents and strips any character that is
+ * not a valid identifier character, so inputs like `getFoo≠Bar` or `café` yield
+ * valid JS/TS identifiers rather than leaking the raw symbol into generated code.
+ */ export const camelCase = (str)=>lodashCamelCase(deburr(str ?? '').replace(/[^a-zA-Z0-9]+/g, ' '));
+export const toClassName = (str)=>{
     if (!str) {
         return str;
     }
     const words = str.replace(/[^a-zA-Z0-9]/g, ' ').split(/\s+/);
-    return words
-        .map((word, index) => {
+    return words.map((word, index)=>{
         if (index === 0 && /^\d/.test(word)) {
             return '_' + word;
         }
         return word.charAt(0).toUpperCase() + word.slice(1);
-    })
-        .join('');
+    }).join('');
 };
-exports.toClassName = toClassName;
-const toKebabCase = (str) => str?.split('/').map(exports.kebabCase).join('/');
-exports.toKebabCase = toKebabCase;
-const toSnakeCase = (str) => str?.split('/').map(exports.snakeCase).join('/');
-exports.toSnakeCase = toSnakeCase;
-const upperFirst = (str) => str.charAt(0).toUpperCase() + str.slice(1);
-exports.upperFirst = upperFirst;
-const pascalCase = (str) => (0, exports.upperFirst)((0, lodash_camelcase_1.default)(str));
-exports.pascalCase = pascalCase;
-const snakeCase = (str) => {
-    return ((0, lodash_deburr_1.default)(str)
-        // Replace series of special characters with underscores
-        .replace(/[^a-zA-Z0-9]+/g, '_')
-        // Replace capital letters preceded by lowercase or numbers with underscore + lowercase
-        .replace(/([a-z0-9])([A-Z])/g, '$1_$2')
-        // Convert to lowercase
-        .toLowerCase()
-        // Remove leading/trailing underscores
-        .replace(/^_+|_+$/g, ''));
+export const toKebabCase = (str)=>str?.split('/').map(kebabCase).join('/');
+export const toSnakeCase = (str)=>str?.split('/').map(snakeCase).join('/');
+export const upperFirst = (str)=>str.charAt(0).toUpperCase() + str.slice(1);
+export const pascalCase = (str)=>upperFirst(camelCase(str));
+export const snakeCase = (str)=>{
+    return deburr(str)// Replace series of special characters with underscores
+    .replace(/[^a-zA-Z0-9]+/g, '_')// Replace capital letters preceded by lowercase or numbers with underscore + lowercase
+    .replace(/([a-z0-9])([A-Z])/g, '$1_$2')// Convert to lowercase
+    .toLowerCase()// Remove leading/trailing underscores
+    .replace(/^_+|_+$/g, '');
 };
-exports.snakeCase = snakeCase;
-const kebabCase = (str) => {
-    return ((0, lodash_deburr_1.default)(str)
-        // Replace series of special characters with hyphens
-        .replace(/[^a-zA-Z0-9]+/g, '-')
-        // Replace capital letters preceded by lowercase or numbers with hyphen + lowercase
-        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
-        // Convert to lowercase
-        .toLowerCase()
-        // Remove leading/trailing hyphens
-        .replace(/^-+|-+$/g, ''));
+export const kebabCase = (str)=>{
+    return deburr(str)// Replace series of special characters with hyphens
+    .replace(/[^a-zA-Z0-9]+/g, '-')// Replace capital letters preceded by lowercase or numbers with hyphen + lowercase
+    .replace(/([a-z0-9])([A-Z])/g, '$1-$2')// Convert to lowercase
+    .toLowerCase()// Remove leading/trailing hyphens
+    .replace(/^-+|-+$/g, '');
 };
-exports.kebabCase = kebabCase;
+/**
+ * Normalise a string to a PEP 503 distribution name.
+ *
+ * PEP 503 (https://peps.python.org/pep-0503/#normalized-names) defines the
+ * canonical form of a Python project distribution name: lower-cased, with any
+ * run of `.`, `_` or `-` collapsed to a single `-`. This is the name uv writes
+ * into `uv.lock` and the form `@nxlv/python` expects when inferring workspace
+ * dependency edges from `[project].dependencies` / `[tool.uv.sources]`.
+ *
+ * Importantly this is NOT kebab-case: it does not split on camelCase humps,
+ * spaces or other punctuation, so a dotted nx id like `scope.my_lib` becomes
+ * `scope-my-lib` (and only those three separators are touched).
+ *
+ * eg. `sojourner.agent_connection` -> `sojourner-agent-connection`
+ */ export const normalizeDistributionName = (str)=>str.toLowerCase().replace(/[._-]+/g, '-');
 // Convert a string to a dot notation string (eg. lambda_handler/my_handler.py -> lambda_handler.my_handler)
-const toDotNotation = (str) => str
-    ?.replace(/^\/|\/$/g, '') // Remove leading/trailing slashes
+export const toDotNotation = (str)=>str?.replace(/^\/|\/$/g, '') // Remove leading/trailing slashes
     .replace(/\.[^/.]+$/g, '') // Remove any file extensions
-    .split('/')
-    .filter(Boolean) // Remove empty segments (in case of double slashes)
+    .split('/').filter(Boolean) // Remove empty segments (in case of double slashes)
     .join('.');
-exports.toDotNotation = toDotNotation;
+
 //# sourceMappingURL=names.js.map

package/src/utils/names.js.map

@@ -1 +1 @@
-{"version":3,"file":"names.js","sourceRoot":"","sources":["../../../../../packages/nx-plugin/src/utils/names.ts"],"names":[],"mappings":"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"}
+{"version":3,"sources":["../../../../../packages/nx-plugin/src/utils/names.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport lodashCamelCase from 'lodash.camelcase';\nimport deburr from 'lodash.deburr';\n\n/**\n * camelCase that first transliterates accents and strips any character that is\n * not a valid identifier character, so inputs like `getFoo≠Bar` or `café` yield\n * valid JS/TS identifiers rather than leaking the raw symbol into generated code.\n */\nexport const camelCase = (str: string): string =>\n  lodashCamelCase(deburr(str ?? '').replace(/[^a-zA-Z0-9]+/g, ' '));\n\nexport const toClassName = (str?: string): string => {\n  if (!str) {\n    return str;\n  }\n  const words = str.replace(/[^a-zA-Z0-9]/g, ' ').split(/\\s+/);\n  return words\n    .map((word, index) => {\n      if (index === 0 && /^\\d/.test(word)) {\n        return '_' + word;\n      }\n      return word.charAt(0).toUpperCase() + word.slice(1);\n    })\n    .join('');\n};\n\nexport const toKebabCase = (str?: string): string =>\n  str?.split('/').map(kebabCase).join('/');\n\nexport const toSnakeCase = (str?: string): string =>\n  str?.split('/').map(snakeCase).join('/');\n\nexport const upperFirst = (str: string): string =>\n  str.charAt(0).toUpperCase() + str.slice(1);\n\nexport const pascalCase = (str: string): string => upperFirst(camelCase(str));\n\nexport const snakeCase = (str: string): string => {\n  return (\n    deburr(str)\n      // Replace series of special characters with underscores\n      .replace(/[^a-zA-Z0-9]+/g, '_')\n      // Replace capital letters preceded by lowercase or numbers with underscore + lowercase\n      .replace(/([a-z0-9])([A-Z])/g, '$1_$2')\n      // Convert to lowercase\n      .toLowerCase()\n      // Remove leading/trailing underscores\n      .replace(/^_+|_+$/g, '')\n  );\n};\n\nexport const kebabCase = (str: string): string => {\n  return (\n    deburr(str)\n      // Replace series of special characters with hyphens\n      .replace(/[^a-zA-Z0-9]+/g, '-')\n      // Replace capital letters preceded by lowercase or numbers with hyphen + lowercase\n      .replace(/([a-z0-9])([A-Z])/g, '$1-$2')\n      // Convert to lowercase\n      .toLowerCase()\n      // Remove leading/trailing hyphens\n      .replace(/^-+|-+$/g, '')\n  );\n};\n\n/**\n * Normalise a string to a PEP 503 distribution name.\n *\n * PEP 503 (https://peps.python.org/pep-0503/#normalized-names) defines the\n * canonical form of a Python project distribution name: lower-cased, with any\n * run of `.`, `_` or `-` collapsed to a single `-`. This is the name uv writes\n * into `uv.lock` and the form `@nxlv/python` expects when inferring workspace\n * dependency edges from `[project].dependencies` / `[tool.uv.sources]`.\n *\n * Importantly this is NOT kebab-case: it does not split on camelCase humps,\n * spaces or other punctuation, so a dotted nx id like `scope.my_lib` becomes\n * `scope-my-lib` (and only those three separators are touched).\n *\n * eg. `sojourner.agent_connection` -> `sojourner-agent-connection`\n */\nexport const normalizeDistributionName = (str: string): string =>\n  str.toLowerCase().replace(/[._-]+/g, '-');\n\n// Convert a string to a dot notation string (eg. lambda_handler/my_handler.py -> lambda_handler.my_handler)\nexport const toDotNotation = (str: string): string =>\n  str\n    ?.replace(/^\\/|\\/$/g, '') // Remove leading/trailing slashes\n    .replace(/\\.[^/.]+$/g, '') // Remove any file extensions\n    .split('/')\n    .filter(Boolean) // Remove empty segments (in case of double slashes)\n    .join('.');\n"],"names":["lodashCamelCase","deburr","camelCase","str","replace","toClassName","words","split","map","word","index","test","charAt","toUpperCase","slice","join","toKebabCase","kebabCase","toSnakeCase","snakeCase","upperFirst","pascalCase","toLowerCase","normalizeDistributionName","toDotNotation","filter","Boolean"],"mappings":"AAAA;;;CAGC,GACD,OAAOA,qBAAqB,mBAAmB;AAC/C,OAAOC,YAAY,gBAAgB;AAEnC;;;;CAIC,GACD,OAAO,MAAMC,YAAY,CAACC,MACxBH,gBAAgBC,OAAOE,OAAO,IAAIC,OAAO,CAAC,kBAAkB,MAAM;AAEpE,OAAO,MAAMC,cAAc,CAACF;IAC1B,IAAI,CAACA,KAAK;QACR,OAAOA;IACT;IACA,MAAMG,QAAQH,IAAIC,OAAO,CAAC,iBAAiB,KAAKG,KAAK,CAAC;IACtD,OAAOD,MACJE,GAAG,CAAC,CAACC,MAAMC;QACV,IAAIA,UAAU,KAAK,MAAMC,IAAI,CAACF,OAAO;YACnC,OAAO,MAAMA;QACf;QACA,OAAOA,KAAKG,MAAM,CAAC,GAAGC,WAAW,KAAKJ,KAAKK,KAAK,CAAC;IACnD,GACCC,IAAI,CAAC;AACV,EAAE;AAEF,OAAO,MAAMC,cAAc,CAACb,MAC1BA,KAAKI,MAAM,KAAKC,IAAIS,WAAWF,KAAK,KAAK;AAE3C,OAAO,MAAMG,cAAc,CAACf,MAC1BA,KAAKI,MAAM,KAAKC,IAAIW,WAAWJ,KAAK,KAAK;AAE3C,OAAO,MAAMK,aAAa,CAACjB,MACzBA,IAAIS,MAAM,CAAC,GAAGC,WAAW,KAAKV,IAAIW,KAAK,CAAC,GAAG;AAE7C,OAAO,MAAMO,aAAa,CAAClB,MAAwBiB,WAAWlB,UAAUC,MAAM;AAE9E,OAAO,MAAMgB,YAAY,CAAChB;IACxB,OACEF,OAAOE,IACL,wDAAwD;KACvDC,OAAO,CAAC,kBAAkB,IAC3B,uFAAuF;KACtFA,OAAO,CAAC,sBAAsB,QAC/B,uBAAuB;KACtBkB,WAAW,EACZ,sCAAsC;KACrClB,OAAO,CAAC,YAAY;AAE3B,EAAE;AAEF,OAAO,MAAMa,YAAY,CAACd;IACxB,OACEF,OAAOE,IACL,oDAAoD;KACnDC,OAAO,CAAC,kBAAkB,IAC3B,mFAAmF;KAClFA,OAAO,CAAC,sBAAsB,QAC/B,uBAAuB;KACtBkB,WAAW,EACZ,kCAAkC;KACjClB,OAAO,CAAC,YAAY;AAE3B,EAAE;AAEF;;;;;;;;;;;;;;CAcC,GACD,OAAO,MAAMmB,4BAA4B,CAACpB,MACxCA,IAAImB,WAAW,GAAGlB,OAAO,CAAC,WAAW,KAAK;AAE5C,4GAA4G;AAC5G,OAAO,MAAMoB,gBAAgB,CAACrB,MAC5BA,KACIC,QAAQ,YAAY,IAAI,kCAAkC;KAC3DA,QAAQ,cAAc,IAAI,6BAA6B;KACvDG,MAAM,KACNkB,OAAOC,SAAS,oDAAoD;KACpEX,KAAK,KAAK"}

package/src/utils/npm-scope.d.ts

@@ -5,7 +5,3 @@
 import { type Tree } from '@nx/devkit';
 export declare function getNpmScope(tree: Tree): string | undefined;
 export declare function getNpmScopePrefix(tree: Tree): string | undefined;
-/**
- * Returns a safe import alias for local packages to avoid the potential for sniping attacks
- */
-export declare function toScopeAlias(npmScopeOrPackageName: string): string;

package/src/utils/npm-scope.js

@@ -1,29 +1,16 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getNpmScope = getNpmScope;
-exports.getNpmScopePrefix = getNpmScopePrefix;
-exports.toScopeAlias = toScopeAlias;
 /**
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
- */
-const devkit_1 = require("@nx/devkit");
-function getNpmScope(tree) {
-    const { name } = tree.exists('package.json')
-        ? (0, devkit_1.readJson)(tree, 'package.json')
-        : { name: null };
+ */ import { readJson } from "@nx/devkit";
+export function getNpmScope(tree) {
+    const { name } = tree.exists('package.json') ? readJson(tree, 'package.json') : {
+        name: null
+    };
     return name?.startsWith('@') ? name.split('/')[0].substring(1) : 'monorepo';
 }
-function getNpmScopePrefix(tree) {
+export function getNpmScopePrefix(tree) {
     const npmScope = getNpmScope(tree);
     return `@${npmScope}/`;
 }
-/**
- * Returns a safe import alias for local packages to avoid the potential for sniping attacks
- */
-function toScopeAlias(npmScopeOrPackageName) {
-    return npmScopeOrPackageName.startsWith('@')
-        ? `:${npmScopeOrPackageName.slice(1)}`
-        : npmScopeOrPackageName;
-}
+
 //# sourceMappingURL=npm-scope.js.map

package/src/utils/npm-scope.js.map

@@ -1 +1 @@
-{"version":3,"file":"npm-scope.js","sourceRoot":"","sources":["../../../../../packages/nx-plugin/src/utils/npm-scope.ts"],"names":[],"mappings":";;AAKA,kCAOC;AACD,8CAGC;AAID,oCAIC;AAxBD;;;GAGG;AACH,uCAAiD;AACjD,SAAgB,WAAW,CAAC,IAAU;IACpC,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;QAC1C,CAAC,CAAC,IAAA,iBAAQ,EAEL,IAAI,EAAE,cAAc,CAAC;QAC1B,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACnB,OAAO,IAAI,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;AAC9E,CAAC;AACD,SAAgB,iBAAiB,CAAC,IAAU;IAC1C,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,IAAI,QAAQ,GAAG,CAAC;AACzB,CAAC;AACD;;GAEG;AACH,SAAgB,YAAY,CAAC,qBAA6B;IACxD,OAAO,qBAAqB,CAAC,UAAU,CAAC,GAAG,CAAC;QAC1C,CAAC,CAAC,IAAI,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QACtC,CAAC,CAAC,qBAAqB,CAAC;AAC5B,CAAC"}
+{"version":3,"sources":["../../../../../packages/nx-plugin/src/utils/npm-scope.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport { readJson, type Tree } from '@nx/devkit';\nexport function getNpmScope(tree: Tree): string | undefined {\n  const { name } = tree.exists('package.json')\n    ? readJson<{\n        name?: string;\n      }>(tree, 'package.json')\n    : { name: null };\n  return name?.startsWith('@') ? name.split('/')[0].substring(1) : 'monorepo';\n}\nexport function getNpmScopePrefix(tree: Tree): string | undefined {\n  const npmScope = getNpmScope(tree);\n  return `@${npmScope}/`;\n}\n"],"names":["readJson","getNpmScope","tree","name","exists","startsWith","split","substring","getNpmScopePrefix","npmScope"],"mappings":"AAAA;;;CAGC,GACD,SAASA,QAAQ,QAAmB,aAAa;AACjD,OAAO,SAASC,YAAYC,IAAU;IACpC,MAAM,EAAEC,IAAI,EAAE,GAAGD,KAAKE,MAAM,CAAC,kBACzBJ,SAEGE,MAAM,kBACT;QAAEC,MAAM;IAAK;IACjB,OAAOA,MAAME,WAAW,OAAOF,KAAKG,KAAK,CAAC,IAAI,CAAC,EAAE,CAACC,SAAS,CAAC,KAAK;AACnE;AACA,OAAO,SAASC,kBAAkBN,IAAU;IAC1C,MAAMO,WAAWR,YAAYC;IAC7B,OAAO,CAAC,CAAC,EAAEO,SAAS,CAAC,CAAC;AACxB"}

package/src/utils/nx.d.ts

@@ -2,24 +2,47 @@
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
-import { type ProjectConfiguration, type Tree } from '@nx/devkit';
-export type { GeneratorInfo, NxGeneratorInfo } from './generators';
-export { buildGeneratorInfoList } from './generators';
-import { type GeneratorInfo } from './generators';
+import { type ProjectConfiguration, type TargetConfiguration, type TargetDefaultValue, type Tree } from '@nx/devkit';
+export type { GeneratorInfo, NxGeneratorInfo } from './generators.js';
+export { buildGeneratorInfoList } from './generators.js';
+import { type GeneratorInfo } from './generators.js';
 /**
  * List Nx Plugin for AWS generators
  * @param includeHidden include hidden generators (default false)
  */
 export declare const listGenerators: (includeHidden?: boolean) => GeneratorInfo[];
 /**
- * Return generator information. Call this from a generator method with __filename
+ * Return generator information. Call this from a generator method with import.meta.filename
  */
 export declare const getGeneratorInfo: (generatorFileName: string) => GeneratorInfo;
 export declare const getPackageVersion: () => string;
+/**
+ * True inside the plugin's own monorepo, where the plugin is the source rather
+ * than a dependency.
+ */
+export declare const isNxPluginForAwsWorkspace: (tree: Tree) => boolean;
+/**
+ * The `@aws/nx-plugin` devDependency entry for a workspace the plugin generates
+ * into, keyed to the version the running generators come from. Empty inside the
+ * plugin's own monorepo.
+ */
+export declare const nxPluginSelfDependency: (tree: Tree) => Record<string, string>;
+/**
+ * The `@aws/nx-plugin-mcp` devDependency entry, keyed to the running generators'
+ * version — the two packages are released in lockstep. Declaring it pins the MCP
+ * server the vended config runs in the workspace's lockfile, so upgrading it
+ * upgrades the server. Empty inside the plugin's own monorepo.
+ */
+export declare const nxPluginMcpDependency: (tree: Tree) => Record<string, string>;
 /**
  * Read a project configuration where the project name may not be fully qualified (ie may omit the scope prefix)
  */
 export declare const readProjectConfigurationUnqualified: (tree: Tree, projectName: string) => ProjectConfiguration;
+/**
+ * Returns whether a project with the given name already exists in the workspace.
+ * The project name may be unqualified (ie may omit the scope prefix).
+ */
+export declare const projectExists: (tree: Tree, projectName: string) => boolean;
 /**
  * Add metadata about the generator that generated the project to the project.json
  */
@@ -34,17 +57,49 @@ export declare const addGeneratorMetadata: (tree: Tree, projectName: string, inf
 export interface ComponentMetadata {
     readonly generator: string;
     readonly name?: string;
+    /**
+     * What this entry wires up. For a connection that is the target — the thing
+     * being connected to — paired with `sourcePath` below.
+     */
     readonly path?: string;
+    /**
+     * The component the connection is made *from*, when both ends are components
+     * of a project rather than whole projects.
+     *
+     * A connection records the project it lives on and the target it reaches, which
+     * alone can't tell which of several components on that project is wired up.
+     * Recorded as a path for the same reason `path` is: it identifies a component
+     * within its project without depending on a name that may repeat.
+     */
+    readonly sourcePath?: string;
     [key: string]: any;
 }
 /**
  * Add metadata about the generator that generated the component to the project.json
+ *
+ * A connection between two components passes the source's path as
+ * `additionalMetadata.sourcePath`, so the pair is identifiable rather than just
+ * the two projects.
  */
 export declare const addComponentGeneratorMetadata: (tree: Tree, projectName: string, info: {
     id: string;
 }, componentPath: string, componentName?: string, additionalMetadata?: {
     [key: string]: any;
 }) => void;
+/**
+ * Merge a generator's own config into an `nx.json` `targetDefaults` value,
+ * preserving whatever the workspace already had. `apply` receives the config to
+ * layer onto and returns the merged config (e.g. `(base) => ({ cache: true,
+ * ...base })`); it must be idempotent so re-running the generator is a no-op.
+ *
+ * Nx 23.1 widened each value to either a config object or an ordered array of
+ * filtered entries. The plugin only contributes unfiltered (catch-all) config,
+ * so the input's shape is preserved: an object (or unset) stays an object;
+ * an array keeps the user's filtered entries and `apply` merges into its first
+ * unfiltered entry, prepending one as the base if none exists (Nx layers later
+ * matches on top, so our catch-all must stay first to not override a filter).
+ */
+export declare const mergeTargetDefault: (value: TargetDefaultValue | undefined, apply: (base: Partial<TargetConfiguration>) => Partial<TargetConfiguration>) => TargetDefaultValue;
 /**
  * A single entry in an Nx `dependsOn` array.
  * Matches the shape accepted by Nx without requiring a devkit type import.
@@ -54,12 +109,28 @@ export type TargetDependency = string | {
     target: string;
     params?: 'ignore' | 'forward';
 };
+/**
+ * Reorder a target's keys to match Nx's own serialization order. Nx reorders
+ * target properties when it rewrites an existing project.json, so applying the
+ * same order when first authoring a target keeps generators idempotent.
+ */
+export declare const normalizeTargetKeyOrder: <T extends object>(target: T) => T;
 /**
  * Mutate the project to add the dependency to the target if not already present
  * Adds the target if not present.
  *
  * Accepts either a string target name (e.g. `'build'`) or a dependency config
- * object (e.g. `{ projects: ['foo'], target: 'serve-local' }`). Deduplicates
+ * object (e.g. `{ projects: ['foo'], target: 'dev' }`). Deduplicates
  * using deep equality so re-running a generator does not grow `dependsOn`.
  */
 export declare const addDependencyToTargetIfNotPresent: (project: ProjectConfiguration, target: string, dependency: TargetDependency) => void;
+/**
+ * Register a component's `<name>-dev` target under the project-level `dev`
+ * target, so `nx run <project>:dev` starts every component in the project.
+ *
+ * Component generators author their own continuous `<name>-dev` runner and call
+ * this to aggregate it. Every component added to the project accumulates its
+ * `<name>-dev` under `dev`. Nx keys tasks by `project:target`, so any
+ * dependencies shared between components run exactly once.
+ */
+export declare const addComponentDevTarget: (targets: Record<string, ProjectConfiguration["targets"][string]>, componentDevTargetName: string) => void;