@aws/nx-plugin 1.0.0-rc.97 → 1.0.0

package/src/ts/nx-plugin/utils.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../packages/nx-plugin/src/ts/nx-plugin/utils.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport {\n  joinPathFragments,\n  type ProjectConfiguration,\n  type Tree,\n  updateJson,\n  writeJson,\n} from '@nx/devkit';\nimport type { PackageJson } from 'nx/src/utils/package-json';\nimport {\n  type DependencyDeclaration,\n  forDependencies,\n  type MustDeclare,\n} from '../../utils/declared-dependencies.js';\nimport { addDependenciesToPackageJson } from '../../utils/dependencies.js';\nimport { isEsmWorkspace } from '../../utils/module-format.js';\nimport {\n  nxPluginSelfDependency,\n  readProjectConfigurationUnqualified,\n} from '../../utils/nx.js';\nimport { type ITsDepVersion, withVersions } from '../../utils/versions.js';\n\n/** Dependencies a caller must declare to configure an Nx Plugin project. */\nexport const NX_PLUGIN_DEPENDENCIES = [\n  { name: '@nx/devkit' },\n] as const satisfies readonly { name: ITsDepVersion }[];\n\n/**\n * Read the configuration of a project which can host Nx Plugin generators or\n * migrations, ie a TypeScript project.\n */\nexport const readNxPluginProject = (\n  tree: Tree,\n  projectName: string,\n): ProjectConfiguration => {\n  const project = readProjectConfigurationUnqualified(tree, projectName);\n\n  const tsConfigPath = joinPathFragments(project.root, 'tsconfig.json');\n  if (!tree.exists(tsConfigPath)) {\n    throw new Error(\n      `Selected plugin project ${projectName} is not a TypeScript project`,\n    );\n  }\n\n  return project;\n};\n\n/** `package.json` field pointing Nx at one of a plugin's manifests. */\ntype NxPluginManifestField = 'generators' | 'nx-migrations';\n\n/**\n * Create the plugin project's package.json if absent and point it at the given\n * manifest, returning its path.\n */\nexport const configureNxPluginPackageJson = <\n  TField extends NxPluginManifestField,\n>(\n  tree: Tree,\n  project: ProjectConfiguration,\n  manifestField: TField,\n  manifestValue: PackageJson[TField],\n): string => {\n  const pluginPackageJsonPath = joinPathFragments(project.root, 'package.json');\n  if (!tree.exists(pluginPackageJsonPath)) {\n    writeJson(tree, pluginPackageJsonPath, {\n      name: project.name,\n    });\n  }\n  const esm = isEsmWorkspace(tree);\n  updateJson(tree, pluginPackageJsonPath, (pkg) => {\n    // Match the plugin's module system to the workspace. Nx loads `.ts` files\n    // via Node's native type stripping, as ESM (workspace root is\n    // `type: module`) or CommonJS accordingly.\n    pkg.type ??= esm ? 'module' : 'commonjs';\n    pkg.main ??= esm ? './src/index.js' : './src/index';\n    pkg[manifestField] ??= manifestValue;\n    return pkg;\n  });\n  return pluginPackageJsonPath;\n};\n\n/**\n * Declare the dependencies the plugin's `.ts` files import on both the\n * workspace and the plugin, since both must resolve for Nx to load them. A\n * no-op inside the plugin's own monorepo, where they are already present.\n */\nexport const addNxPluginDependencies = <const D extends DependencyDeclaration>(\n  tree: Tree,\n  pluginPackageJsonPath: string,\n  declaration: D & MustDeclare<typeof NX_PLUGIN_DEPENDENCIES, D>,\n): void => {\n  const selfDependency = nxPluginSelfDependency(tree);\n  if (Object.keys(selfDependency).length === 0) {\n    return;\n  }\n  const deps = {\n    ...withVersions(\n      forDependencies<typeof NX_PLUGIN_DEPENDENCIES>(declaration),\n      ['@nx/devkit'],\n    ),\n    ...selfDependency,\n  };\n  addDependenciesToPackageJson(tree, {}, deps);\n  addDependenciesToPackageJson(tree, deps, {}, pluginPackageJsonPath);\n};\n\n/**\n * Configures a TypeScript project as an Nx Plugin\n */\nexport const configureTsProjectAsNxPlugin = <\n  const D extends DependencyDeclaration,\n>(\n  tree: Tree,\n  projectName: string,\n  declaration: D & MustDeclare<typeof NX_PLUGIN_DEPENDENCIES, D>,\n) => {\n  const project = readNxPluginProject(tree, projectName);\n\n  // Create an empty generators.json if one dosn't exist\n  const generatorsJsonPath = joinPathFragments(project.root, 'generators.json');\n  if (!tree.exists(generatorsJsonPath)) {\n    writeJson(tree, generatorsJsonPath, {\n      generators: {},\n    });\n  }\n\n  const pluginPackageJsonPath = configureNxPluginPackageJson(\n    tree,\n    project,\n    'generators',\n    './generators.json',\n  );\n\n  addNxPluginDependencies(\n    tree,\n    pluginPackageJsonPath,\n    forDependencies<typeof NX_PLUGIN_DEPENDENCIES>(declaration),\n  );\n};\n"],"names":["joinPathFragments","updateJson","writeJson","forDependencies","addDependenciesToPackageJson","isEsmWorkspace","nxPluginSelfDependency","readProjectConfigurationUnqualified","withVersions","NX_PLUGIN_DEPENDENCIES","name","readNxPluginProject","tree","projectName","project","tsConfigPath","root","exists","Error","configureNxPluginPackageJson","manifestField","manifestValue","pluginPackageJsonPath","esm","pkg","type","main","addNxPluginDependencies","declaration","selfDependency","Object","keys","length","deps","configureTsProjectAsNxPlugin","generatorsJsonPath","generators"],"mappings":"AAAA;;;CAGC,GACD,SACEA,iBAAiB,EAGjBC,UAAU,EACVC,SAAS,QACJ,aAAa;AAEpB,SAEEC,eAAe,QAEV,uCAAuC;AAC9C,SAASC,4BAA4B,QAAQ,8BAA8B;AAC3E,SAASC,cAAc,QAAQ,+BAA+B;AAC9D,SACEC,sBAAsB,EACtBC,mCAAmC,QAC9B,oBAAoB;AAC3B,SAA6BC,YAAY,QAAQ,0BAA0B;AAE3E,0EAA0E,GAC1E,OAAO,MAAMC,yBAAyB;IACpC;QAAEC,MAAM;IAAa;CACtB,CAAuD;AAExD;;;CAGC,GACD,OAAO,MAAMC,sBAAsB,CACjCC,MACAC;IAEA,MAAMC,UAAUP,oCAAoCK,MAAMC;IAE1D,MAAME,eAAef,kBAAkBc,QAAQE,IAAI,EAAE;IACrD,IAAI,CAACJ,KAAKK,MAAM,CAACF,eAAe;QAC9B,MAAM,IAAIG,MACR,CAAC,wBAAwB,EAAEL,YAAY,4BAA4B,CAAC;IAExE;IAEA,OAAOC;AACT,EAAE;AAKF;;;CAGC,GACD,OAAO,MAAMK,+BAA+B,CAG1CP,MACAE,SACAM,eACAC;IAEA,MAAMC,wBAAwBtB,kBAAkBc,QAAQE,IAAI,EAAE;IAC9D,IAAI,CAACJ,KAAKK,MAAM,CAACK,wBAAwB;QACvCpB,UAAUU,MAAMU,uBAAuB;YACrCZ,MAAMI,QAAQJ,IAAI;QACpB;IACF;IACA,MAAMa,MAAMlB,eAAeO;IAC3BX,WAAWW,MAAMU,uBAAuB,CAACE;QACvC,0EAA0E;QAC1E,8DAA8D;QAC9D,2CAA2C;QAC3CA,IAAIC,IAAI,KAAKF,MAAM,WAAW;QAC9BC,IAAIE,IAAI,KAAKH,MAAM,mBAAmB;QACtCC,GAAG,CAACJ,cAAc,KAAKC;QACvB,OAAOG;IACT;IACA,OAAOF;AACT,EAAE;AAEF;;;;CAIC,GACD,OAAO,MAAMK,0BAA0B,CACrCf,MACAU,uBACAM;IAEA,MAAMC,iBAAiBvB,uBAAuBM;IAC9C,IAAIkB,OAAOC,IAAI,CAACF,gBAAgBG,MAAM,KAAK,GAAG;QAC5C;IACF;IACA,MAAMC,OAAO;QACX,GAAGzB,aACDL,gBAA+CyB,cAC/C;YAAC;SAAa,CACf;QACD,GAAGC,cAAc;IACnB;IACAzB,6BAA6BQ,MAAM,CAAC,GAAGqB;IACvC7B,6BAA6BQ,MAAMqB,MAAM,CAAC,GAAGX;AAC/C,EAAE;AAEF;;CAEC,GACD,OAAO,MAAMY,+BAA+B,CAG1CtB,MACAC,aACAe;IAEA,MAAMd,UAAUH,oBAAoBC,MAAMC;IAE1C,sDAAsD;IACtD,MAAMsB,qBAAqBnC,kBAAkBc,QAAQE,IAAI,EAAE;IAC3D,IAAI,CAACJ,KAAKK,MAAM,CAACkB,qBAAqB;QACpCjC,UAAUU,MAAMuB,oBAAoB;YAClCC,YAAY,CAAC;QACf;IACF;IAEA,MAAMd,wBAAwBH,6BAC5BP,MACAE,SACA,cACA;IAGFa,wBACEf,MACAU,uBACAnB,gBAA+CyB;AAEnD,EAAE"}
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/ts/nx-plugin/utils.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport {\n  joinPathFragments,\n  type ProjectConfiguration,\n  type Tree,\n  updateJson,\n  updateProjectConfiguration,\n  writeJson,\n} from '@nx/devkit';\nimport type { PackageJson } from 'nx/src/utils/package-json';\nimport {\n  type DependencyDeclaration,\n  forDependencies,\n  type MustDeclare,\n} from '../../utils/declared-dependencies.js';\nimport { addDependenciesToPackageJson } from '../../utils/dependencies.js';\nimport { isEsmWorkspace } from '../../utils/module-format.js';\nimport {\n  nxPluginSelfDependency,\n  readProjectConfigurationUnqualified,\n} from '../../utils/nx.js';\nimport { type ITsDepVersion, withVersions } from '../../utils/versions.js';\n\n/** Dependencies a caller must declare to configure an Nx Plugin project. */\nexport const NX_PLUGIN_DEPENDENCIES = [\n  { name: '@nx/devkit' },\n] as const satisfies readonly { name: ITsDepVersion }[];\n\n/**\n * Read the configuration of a project which can host Nx Plugin generators or\n * migrations, ie a TypeScript project.\n */\nexport const readNxPluginProject = (\n  tree: Tree,\n  projectName: string,\n): ProjectConfiguration => {\n  const project = readProjectConfigurationUnqualified(tree, projectName);\n\n  const tsConfigPath = joinPathFragments(project.root, 'tsconfig.json');\n  if (!tree.exists(tsConfigPath)) {\n    throw new Error(\n      `Selected plugin project ${projectName} is not a TypeScript project`,\n    );\n  }\n\n  return project;\n};\n\n/** `package.json` field pointing Nx at one of a plugin's manifests. */\ntype NxPluginManifestField = 'generators' | 'nx-migrations';\n\n/**\n * The manifests Nx reads from a published plugin, copied beside the compiled\n * code by the `package` target. `nx migrate` resolves `migrations.json` from the\n * tarball, so it ships even though only `ts#nx-migration` writes it.\n */\nexport const NX_PLUGIN_MANIFESTS = [\n  'generators.json',\n  'executors.json',\n  'migrations.json',\n] as const;\n\n/** The `package` target assets that copy the plugin's manifests into dist. */\nexport const nxPluginManifestAssets = (): {\n  input: string;\n  glob: string;\n  output: string;\n}[] =>\n  NX_PLUGIN_MANIFESTS.map((glob) => ({\n    input: './{projectRoot}',\n    glob,\n    output: '.',\n  }));\n\n/**\n * Ensure the plugin's `package` target copies every manifest into dist, so a\n * manifest added after the project was generated is still published.\n *\n * Anchored to the `generators.json` asset the target is vended with: a `package`\n * target without it belongs to something other than an Nx Plugin, or has been\n * rewritten, so it is left as it is.\n */\nexport const addNxPluginManifestAssets = (\n  tree: Tree,\n  project: ProjectConfiguration,\n): void => {\n  const assets = project.targets?.package?.options?.assets;\n  if (!Array.isArray(assets)) {\n    return;\n  }\n  const globs = new Set(\n    assets\n      .filter((asset) => typeof asset === 'object' && asset !== null)\n      .map((asset) => asset.glob),\n  );\n  if (!globs.has('generators.json')) {\n    return;\n  }\n  const missing = nxPluginManifestAssets().filter(\n    (asset) => !globs.has(asset.glob),\n  );\n  if (missing.length === 0) {\n    return;\n  }\n  project.targets.package.options.assets = [...assets, ...missing];\n  updateProjectConfiguration(tree, project.name, project);\n};\n\n/**\n * Create the plugin project's package.json if absent and point it at the given\n * manifest, returning its path.\n */\nexport const configureNxPluginPackageJson = <\n  TField extends NxPluginManifestField,\n>(\n  tree: Tree,\n  project: ProjectConfiguration,\n  manifestField: TField,\n  manifestValue: PackageJson[TField],\n): string => {\n  const pluginPackageJsonPath = joinPathFragments(project.root, 'package.json');\n  if (!tree.exists(pluginPackageJsonPath)) {\n    writeJson(tree, pluginPackageJsonPath, {\n      name: project.name,\n    });\n  }\n  const esm = isEsmWorkspace(tree);\n  updateJson(tree, pluginPackageJsonPath, (pkg) => {\n    // Match the plugin's module system to the workspace. Nx loads `.ts` files\n    // via Node's native type stripping, as ESM (workspace root is\n    // `type: module`) or CommonJS accordingly.\n    pkg.type ??= esm ? 'module' : 'commonjs';\n    pkg.main ??= esm ? './src/index.js' : './src/index';\n    pkg[manifestField] ??= manifestValue;\n    return pkg;\n  });\n  return pluginPackageJsonPath;\n};\n\n/**\n * Declare the dependencies the plugin's `.ts` files import on both the\n * workspace and the plugin, since both must resolve for Nx to load them. A\n * no-op inside the plugin's own monorepo, where they are already present.\n */\nexport const addNxPluginDependencies = <const D extends DependencyDeclaration>(\n  tree: Tree,\n  pluginPackageJsonPath: string,\n  declaration: D & MustDeclare<typeof NX_PLUGIN_DEPENDENCIES, D>,\n): void => {\n  const selfDependency = nxPluginSelfDependency(tree);\n  if (Object.keys(selfDependency).length === 0) {\n    return;\n  }\n  const deps = {\n    ...withVersions(\n      forDependencies<typeof NX_PLUGIN_DEPENDENCIES>(declaration),\n      ['@nx/devkit'],\n    ),\n    ...selfDependency,\n  };\n  addDependenciesToPackageJson(tree, {}, deps);\n  addDependenciesToPackageJson(tree, deps, {}, pluginPackageJsonPath);\n};\n\n/**\n * Configures a TypeScript project as an Nx Plugin\n */\nexport const configureTsProjectAsNxPlugin = <\n  const D extends DependencyDeclaration,\n>(\n  tree: Tree,\n  projectName: string,\n  declaration: D & MustDeclare<typeof NX_PLUGIN_DEPENDENCIES, D>,\n) => {\n  const project = readNxPluginProject(tree, projectName);\n\n  // Create an empty generators.json if one dosn't exist\n  const generatorsJsonPath = joinPathFragments(project.root, 'generators.json');\n  if (!tree.exists(generatorsJsonPath)) {\n    writeJson(tree, generatorsJsonPath, {\n      generators: {},\n    });\n  }\n\n  const pluginPackageJsonPath = configureNxPluginPackageJson(\n    tree,\n    project,\n    'generators',\n    './generators.json',\n  );\n\n  addNxPluginDependencies(\n    tree,\n    pluginPackageJsonPath,\n    forDependencies<typeof NX_PLUGIN_DEPENDENCIES>(declaration),\n  );\n};\n"],"names":["joinPathFragments","updateJson","updateProjectConfiguration","writeJson","forDependencies","addDependenciesToPackageJson","isEsmWorkspace","nxPluginSelfDependency","readProjectConfigurationUnqualified","withVersions","NX_PLUGIN_DEPENDENCIES","name","readNxPluginProject","tree","projectName","project","tsConfigPath","root","exists","Error","NX_PLUGIN_MANIFESTS","nxPluginManifestAssets","map","glob","input","output","addNxPluginManifestAssets","assets","targets","package","options","Array","isArray","globs","Set","filter","asset","has","missing","length","configureNxPluginPackageJson","manifestField","manifestValue","pluginPackageJsonPath","esm","pkg","type","main","addNxPluginDependencies","declaration","selfDependency","Object","keys","deps","configureTsProjectAsNxPlugin","generatorsJsonPath","generators"],"mappings":"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"}

package/src/ts/rdb/__snapshots__/generator.spec.ts.snap

@@ -99,8 +99,8 @@ export const handler = async (
 `;
 
 exports[`ts#rdb generator > should add mysql prisma dependencies when engine is MySQL > packages/db/src/index.ts 1`] = `
-"export * from './prisma.js';
-// Export your library code here
+"// Export your library code here
+export * from './prisma.js';
 "
 `;
 
@@ -848,7 +848,7 @@ terraform {
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = "6.62.0"
+      version = "6.63.0"
     }
     null = {
       source  = "hashicorp/null"
@@ -1519,7 +1519,7 @@ exports[`ts#rdb generator > should generate terraform modules when iac is Terraf
     }
     aws = {
       source  = "hashicorp/aws"
-      version = "6.62.0"
+      version = "6.63.0"
     }
     external = {
       source  = "hashicorp/external"
@@ -2214,7 +2214,7 @@ terraform {
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = "6.62.0"
+      version = "6.63.0"
     }
     null = {
       source  = "hashicorp/null"
@@ -2885,7 +2885,7 @@ exports[`ts#rdb generator > should generate terraform modules with MySQL engine
     }
     aws = {
       source  = "hashicorp/aws"
-      version = "6.62.0"
+      version = "6.63.0"
     }
     external = {
       source  = "hashicorp/external"
@@ -3679,8 +3679,8 @@ export const handler = async (
 `;
 
 exports[`ts#rdb generator > should generate the aurora shared construct > packages/db/src/index.ts 1`] = `
-"export * from './prisma.js';
-// Export your library code here
+"// Export your library code here
+export * from './prisma.js';
 "
 `;
 
@@ -4540,8 +4540,8 @@ WORKDIR \${LAMBDA_TASK_ROOT}
 # HIGH/CRITICAL vulnerabilities into the image.
 RUN printf 'allow-scripts[]=prisma\\nallow-scripts[]=@prisma/engines\\n' > .npmrc \\
     && npm init -y \\
-    && npm pkg set "overrides.deepmerge-ts=8.0.0" \\
-    && npm pkg set "overrides.mysql2=3.22.0" \\
+    && npm pkg set "overrides.deepmerge-ts=8.0.2" \\
+    && npm pkg set "overrides.mysql2=3.24.3" \\
     && npm install prisma@7.10.0 \\
     && rm .npmrc \\
     && npm uninstall -g npm

package/src/ts/react-website/agui/generator.d.ts

@@ -50,11 +50,7 @@ export declare const DEPENDENCIES: import("../../../utils/declared-dependencies.
 } & {
     versionOnly: true;
 }, {
-    readonly name: "clsx";
-} & {
-    versionOnly: true;
-}, {
-    readonly name: "tailwind-merge";
+    readonly name: "cn";
 } & {
     versionOnly: true;
 }, {

package/src/ts/react-website/app/__snapshots__/generator.spec.ts.snap

@@ -1,10 +1,10 @@
 // Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
 
 exports[`react-website generator > TailwindCSS integration > should configure vite with TailwindCSS plugin by default > vite.config.mts-with-tailwind 1`] = `
-"import tailwindcss from '@tailwindcss/vite';
+"/// <reference types='vitest' />
+import tailwindcss from '@tailwindcss/vite';
 import { resolve } from 'path';
 import { tanstackRouter } from '@tanstack/router-plugin/vite';
-/// <reference types='vitest' />
 import { defineConfig } from 'vite';
 import react from '@vitejs/plugin-react';
 
@@ -59,9 +59,9 @@ export default defineConfig(() => ({
 `;
 
 exports[`react-website generator > TailwindCSS integration > should configure vite without TailwindCSS plugin when disabled > vite.config.mts-without-tailwind 1`] = `
-"import { resolve } from 'path';
+"/// <reference types='vitest' />
+import { resolve } from 'path';
 import { tanstackRouter } from '@tanstack/router-plugin/vite';
-/// <reference types='vitest' />
 import { defineConfig } from 'vite';
 import react from '@vitejs/plugin-react';
 
@@ -131,7 +131,7 @@ exports[`react-website generator > TailwindCSS integration > terraform iac > sho
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = "6.62.0"
+      version = "6.63.0"
       configuration_aliases = [aws.us_east_1]
     }
     null = {
@@ -745,7 +745,7 @@ resource "null_resource" "upload_website_files" {
   provisioner "local-exec" {
     command = <<-EOT
       cd "$ROOT_PATH"
-      uv run --with boto3==1.43.83 python3 -c "
+      uv run --with boto3==1.43.89 python3 -c "
 import os
 import sys
 import boto3
@@ -868,7 +868,7 @@ resource "null_resource" "cloudfront_invalidation" {
 
   provisioner "local-exec" {
     command = <<-EOT
-      uv run --with boto3==1.43.83 python3 -c "
+      uv run --with boto3==1.43.89 python3 -c "
 import boto3
 import os
 import sys
@@ -954,7 +954,7 @@ output "waf_web_acl_arn" {
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = "6.62.0"
+      version = "6.63.0"
       configuration_aliases = [aws.us_east_1]
     }
   }
@@ -1060,7 +1060,7 @@ runtime-config.json"
 
 exports[`react-website generator > Tanstack router integration > should generate website with no router correctly > biome.json 1`] = `
 "{
-  "$schema": "https://biomejs.dev/schemas/2.5.11/schema.json",
+  "$schema": "https://biomejs.dev/schemas/2.5.12/schema.json",
   "root": true,
   "formatter": {
     "enabled": true,
@@ -2325,18 +2325,18 @@ exports[`react-website generator > Tanstack router integration > should generate
   - test-app
   - packages/common/*
 catalog:
-  '@types/node': 26.4.0
+  '@types/node': 26.4.1
   vite: 8.2.2
   vitest: 4.1.11
   '@vitest/coverage-v8': 4.1.11
-  jsdom: 27.4.0
+  jsdom: 29.1.1
   '@nx/vitest': 23.2.0
   constructs: 10.8.1
-  aws-cdk-lib: 2.267.0
+  aws-cdk-lib: 2.268.0
   react: 19.2.8
   react-dom: 19.2.8
-  '@cloudscape-design/components': 3.0.1356
-  '@cloudscape-design/board-components': 3.0.221
+  '@cloudscape-design/components': 3.0.1359
+  '@cloudscape-design/board-components': 3.0.222
   '@cloudscape-design/global-styles': 1.0.67
   tailwindcss: 4.3.3
   '@nx/react': 23.2.0
@@ -2827,8 +2827,8 @@ exports[`react-website generator > Tanstack router integration > should generate
 `;
 
 exports[`react-website generator > Tanstack router integration > should generate website with no router correctly > test-app/vite.config.mts 1`] = `
-"import tailwindcss from '@tailwindcss/vite';
-/// <reference types='vitest' />
+"/// <reference types='vitest' />
+import tailwindcss from '@tailwindcss/vite';
 import { defineConfig } from 'vite';
 import react from '@vitejs/plugin-react';
 
@@ -2936,7 +2936,7 @@ runtime-config.json"
 
 exports[`react-website generator > Tanstack router integration > should generate website with router correctly > biome.json 1`] = `
 "{
-  "$schema": "https://biomejs.dev/schemas/2.5.11/schema.json",
+  "$schema": "https://biomejs.dev/schemas/2.5.12/schema.json",
   "root": true,
   "formatter": {
     "enabled": true,
@@ -4205,18 +4205,18 @@ exports[`react-website generator > Tanstack router integration > should generate
   - test-app
   - packages/common/*
 catalog:
-  '@types/node': 26.4.0
+  '@types/node': 26.4.1
   vite: 8.2.2
   vitest: 4.1.11
   '@vitest/coverage-v8': 4.1.11
-  jsdom: 27.4.0
+  jsdom: 29.1.1
   '@nx/vitest': 23.2.0
   constructs: 10.8.1
-  aws-cdk-lib: 2.267.0
+  aws-cdk-lib: 2.268.0
   react: 19.2.8
   react-dom: 19.2.8
-  '@cloudscape-design/components': 3.0.1356
-  '@cloudscape-design/board-components': 3.0.221
+  '@cloudscape-design/components': 3.0.1359
+  '@cloudscape-design/board-components': 3.0.222
   '@cloudscape-design/global-styles': 1.0.67
   tailwindcss: 4.3.3
   '@tanstack/react-router': 1.170.32
@@ -4897,10 +4897,10 @@ exports[`react-website generator > Tanstack router integration > should generate
 `;
 
 exports[`react-website generator > Tanstack router integration > should generate website with router correctly > test-app/vite.config.mts 1`] = `
-"import tailwindcss from '@tailwindcss/vite';
+"/// <reference types='vitest' />
+import tailwindcss from '@tailwindcss/vite';
 import { resolve } from 'path';
 import { tanstackRouter } from '@tanstack/router-plugin/vite';
-/// <reference types='vitest' />
 import { defineConfig } from 'vite';
 import react from '@vitejs/plugin-react';
 
@@ -5026,10 +5026,10 @@ exports[`react-website generator > should configure TypeScript correctly > tscon
 `;
 
 exports[`react-website generator > should configure vite correctly > vite.config.mts 1`] = `
-"import tailwindcss from '@tailwindcss/vite';
+"/// <reference types='vitest' />
+import tailwindcss from '@tailwindcss/vite';
 import { resolve } from 'path';
 import { tanstackRouter } from '@tanstack/router-plugin/vite';
-/// <reference types='vitest' />
 import { defineConfig } from 'vite';
 import react from '@vitejs/plugin-react';
 

package/src/ts/react-website/app/generator.d.ts

@@ -96,11 +96,7 @@ export declare const DEPENDENCIES: import("../../../utils/declared-dependencies.
 } & {
     versionOnly: true;
 }, {
-    readonly name: "clsx";
-} & {
-    versionOnly: true;
-}, {
-    readonly name: "tailwind-merge";
+    readonly name: "cn";
 } & {
     versionOnly: true;
 }, {

package/src/ts/react-website/cognito-auth/__snapshots__/generator.terraform.spec.ts.snap

@@ -6,7 +6,7 @@ exports[`cognito-auth generator terraform iac > should generate terraform files
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = "6.62.0"
+      version = "6.63.0"
     }
     null = {
       source  = "hashicorp/null"
@@ -67,7 +67,7 @@ resource "null_resource" "add_callback_url" {
 
   provisioner "local-exec" {
     command = <<-EOT
-      uv run --with boto3==1.43.83 python -c "
+      uv run --with boto3==1.43.89 python -c "
 import boto3
 import os
 import sys

package/src/utils/ast.js

@@ -3,6 +3,8 @@
  * SPDX-License-Identifier: Apache-2.0
  */ import { QueryBuilder } from "@getgrit/gritql";
 import * as path from "path";
+import { LANGUAGE_COMMENT_SYNTAX, readLicenseConfig } from "../license/config.js";
+import { parseFile } from "../license/sync/generator.js";
 import { updateGitIgnore } from "./git.js";
 import { isEsmWorkspace } from "./module-format.js";
 const GRIT_DIR = '.grit';
@@ -31,6 +33,49 @@ const assertFilePath = (tree, filePath)=>{
         throw new Error(`No file located at ${filePath}`);
     }
 };
+/**
+ * Insert `statement` at the top of a file, below any hashbang and leading
+ * comment block. Keeps a license header first in the file, so `license#sync`
+ * doesn't see it displaced and prepend a second one.
+ *
+ * The leading comment is skipped whatever it says — a header, a placeholder or a
+ * note — so nothing here has to identify a license.
+ *
+ * Splits the file with the sync generator's own `parseFile`, resolving the
+ * comment syntax the way the sync does: the workspace's configured
+ * `commentSyntax` for the extension first, then the built-in table. That way an
+ * extension only the user's config covers is still recognised. An extension
+ * neither covers has no comment syntax to find, so the statement goes at the top.
+ */ const insertBelowLeadingComments = async (tree, filePath, contents, statement)=>{
+    const extension = filePath.split('.').pop() ?? '';
+    let syntax;
+    try {
+        syntax = (await readLicenseConfig(tree))?.source?.header?.commentSyntax?.[extension];
+    } catch  {
+    // Reading the config evaluates it, which throws on a config that doesn't
+    // load — including this file itself while a generator is mid-edit. A config
+    // we can't read must not stop an import being added, so fall back to the
+    // defaults. (A config that simply doesn't exist reads as undefined.)
+    }
+    syntax ??= LANGUAGE_COMMENT_SYNTAX[extension];
+    if (!syntax) {
+        return `${statement}\n${contents}`;
+    }
+    const { hashbang, header, body } = parseFile(contents, syntax);
+    if (!hashbang && !header) {
+        return `${statement}\n${contents}`;
+    }
+    return [
+        ...hashbang ? [
+            hashbang
+        ] : [],
+        ...header ? [
+            header
+        ] : [],
+        statement,
+        body
+    ].join('\n');
+};
 export const addDestructuredImport = async (tree, filePath, variableNames, from)=>{
     assertFilePath(tree, filePath);
     from = normalizeModuleSpecifier(tree, from);
@@ -44,16 +89,10 @@ export const addDestructuredImport = async (tree, filePath, variableNames, from)
             await applyGritQL(tree, filePath, `\`import { $imports } from '${from}'\` => \`import { $imports, ${variableName} } from '${from}'\` where { $imports <: not contains \`${localName}\` }`);
         }
     } else {
-        // No existing import — prepend a new one (after shebang if present)
+        // No existing import — add a new one below any hashbang and leading comment
         const specifiers = variableNames.join(', ');
         const contents = tree.read(filePath).toString();
-        const newImport = `import { ${specifiers} } from '${from}';\n`;
-        if (contents.startsWith('#!')) {
-            const newlineIndex = contents.indexOf('\n');
-            tree.write(filePath, `${contents.substring(0, newlineIndex + 1)}${newImport}${contents.substring(newlineIndex + 1)}`);
-        } else {
-            tree.write(filePath, `${newImport}${contents}`);
-        }
+        tree.write(filePath, await insertBelowLeadingComments(tree, filePath, contents, `import { ${specifiers} } from '${from}';`));
     }
 };
 /**
@@ -93,10 +132,11 @@ export const addDestructuredImport = async (tree, filePath, variableNames, from)
     if (allAlreadyPresent) {
         return;
     }
-    // No existing `from <module> import` line — prepend one. Ruff's import
-    // sorter will place it in the right group on the next formatter pass.
+    // No existing `from <module> import` line — add one below any hashbang and
+    // leading comment. Ruff's import sorter will place it in the right group on
+    // the next formatter pass.
     const specifiers = variableNames.join(', ');
-    tree.write(filePath, `from ${from} import ${specifiers}\n${beforeContents}`);
+    tree.write(filePath, await insertBelowLeadingComments(tree, filePath, beforeContents, `from ${from} import ${specifiers}`));
 };
 /**
  * Adds an `import <variableName> from '<from>'; statement to the beginning of the file,
@@ -115,9 +155,9 @@ export const addDestructuredImport = async (tree, filePath, variableNames, from)
     if (identifierTaken) {
         throw new Error(`Cannot import ${variableName} from '${from}' in ${filePath}: ${variableName} is already imported from a different module. Rename the project so its generated identifier does not collide.`);
     }
-    // Prepend new import to file
+    // Add the import below any hashbang and leading comment
     const contents = tree.read(filePath).toString();
-    tree.write(filePath, `import ${variableName} from '${from}';\n${contents}`);
+    tree.write(filePath, await insertBelowLeadingComments(tree, filePath, contents, `import ${variableName} from '${from}';`));
 };
 /**
  * Adds an `export * from '<from>'; statement to the given TypeScript file.
@@ -135,8 +175,7 @@ export const addDestructuredImport = async (tree, filePath, variableNames, from)
     if (alreadyExported) {
         return;
     }
-    // Prepend new export to file
-    tree.write(filePath, `export * from '${from}';\n${contents}`);
+    tree.write(filePath, await insertBelowLeadingComments(tree, filePath, contents, `export * from '${from}';`));
 };
 /**
  * Adds an `export { <names> } from '<from>';` statement to the given TypeScript
@@ -169,7 +208,7 @@ export const addDestructuredImport = async (tree, filePath, variableNames, from)
     if (missing.length === 0) {
         return;
     }
-    tree.write(filePath, `export { ${missing.join(', ')} } from '${from}';\n${contents}`);
+    tree.write(filePath, await insertBelowLeadingComments(tree, filePath, contents, `export { ${missing.join(', ')} } from '${from}';`));
 };
 /**
  * Return whether or not the given identifier is exported in the source file.

package/src/utils/ast.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../packages/nx-plugin/src/utils/ast.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { QueryBuilder } from '@getgrit/gritql';\nimport type { Tree } from '@nx/devkit';\nimport * as path from 'path';\nimport { updateGitIgnore } from './git.js';\nimport { isEsmWorkspace } from './module-format.js';\n\nconst GRIT_DIR = '.grit';\n\n/**\n * Normalize a relative module specifier for the workspace's module format.\n * ESM (`nodenext`) requires an explicit `.js` extension on relative imports;\n * CommonJS (`node16`) resolves them extensionless. Callers always pass the ESM\n * form (with `.js`); this strips the extension for CommonJS workspaces.\n */\nconst normalizeModuleSpecifier = (tree: Tree, from: string): string => {\n  if (isEsmWorkspace(tree)) {\n    return from;\n  }\n  const isRelative = from.startsWith('./') || from.startsWith('../');\n  return isRelative && from.endsWith('.js')\n    ? from.slice(0, -'.js'.length)\n    : from;\n};\n\n// Pin the gritql native library's \"global\" stdlib directory to <workspace>/.grit so it doesn't try to write to /usr/local/.grit (or wherever node's grandparent resolves to).\nconst ensureGritDir = (tree: Tree) => {\n  process.env.GRIT_GLOBAL_DIR ??= path.join(tree.root, GRIT_DIR);\n  updateGitIgnore(tree, '.', (patterns) => [...patterns, GRIT_DIR]);\n};\n\nconst assertFilePath = (tree: Tree, filePath: string) => {\n  if (!tree.exists(filePath)) {\n    throw new Error(`No file located at ${filePath}`);\n  }\n};\n\nexport const addDestructuredImport = async (\n  tree: Tree,\n  filePath: string,\n  variableNames: string[],\n  from: string,\n) => {\n  assertFilePath(tree, filePath);\n  from = normalizeModuleSpecifier(tree, from);\n\n  // Check if there's an existing import from this module\n  const hasExistingImport = await matchGritQL(\n    tree,\n    filePath,\n    `\\`import { $_ } from '${from}'\\``,\n  );\n\n  if (hasExistingImport) {\n    // For each new variable, use GritQL rewrite to add it if not already present\n    for (const variableName of variableNames) {\n      const localName = variableName.includes(' as ')\n        ? variableName.split(' as ')[1]\n        : variableName;\n      // Use rewrite (=>) which correctly handles comma-separated import specifier lists\n      await applyGritQL(\n        tree,\n        filePath,\n        `\\`import { $imports } from '${from}'\\` => \\`import { $imports, ${variableName} } from '${from}'\\` where { $imports <: not contains \\`${localName}\\` }`,\n      );\n    }\n  } else {\n    // No existing import — prepend a new one (after shebang if present)\n    const specifiers = variableNames.join(', ');\n    const contents = tree.read(filePath)!.toString();\n    const newImport = `import { ${specifiers} } from '${from}';\\n`;\n    if (contents.startsWith('#!')) {\n      const newlineIndex = contents.indexOf('\\n');\n      tree.write(\n        filePath,\n        `${contents.substring(0, newlineIndex + 1)}${newImport}${contents.substring(newlineIndex + 1)}`,\n      );\n    } else {\n      tree.write(filePath, `${newImport}${contents}`);\n    }\n  }\n};\n\n/**\n * Ensure a Python `from <module> import <name1>, <name2>, ...` statement\n * exists in the given file. If the module already has a `from <module> import`\n * line, any missing names are appended; otherwise a fresh import statement is\n * prepended to the file (ruff's import sorter will reorder it into place on\n * the next format pass).\n *\n * We try to append first (which only succeeds if an import-from for the\n * module already exists AND the name isn't yet in the list). If nothing\n * was rewritten after trying every requested name, we fall back to checking\n * whether the module is imported at all; if not, we prepend a fresh\n * `from <module> import ...` line.\n */\nexport const addPythonDestructuredImport = async (\n  tree: Tree,\n  filePath: string,\n  variableNames: string[],\n  from: string,\n) => {\n  assertFilePath(tree, filePath);\n\n  // Determine whether there's any `from <module> import ...` line in the file.\n  // We detect this by attempting a no-op transformation — the file is unchanged,\n  // but a successful match tells us the line exists.\n  const beforeContents = tree.read(filePath)!.toString();\n  let moduleAlreadyImported = false;\n  for (const variableName of variableNames) {\n    // Appends the name if the import-from exists and the name isn't already there.\n    const appended = await applyGritQL(\n      tree,\n      filePath,\n      `language python\\n\\`from ${from} import $names\\` where { $names <: not contains \\`${variableName}\\`, $names += \\`, ${variableName}\\` }`,\n    );\n    if (appended) {\n      moduleAlreadyImported = true;\n    }\n  }\n\n  // If the append succeeded for at least one name, we know the module line\n  // exists; we're done. If nothing was appended we need to distinguish\n  // between \"module not imported\" (need to add a new line) and \"module\n  // imported but all names already present\" (no-op).\n  if (moduleAlreadyImported) {\n    return;\n  }\n\n  const allAlreadyPresent = await matchGritQL(\n    tree,\n    filePath,\n    `language python\\n\\`from ${from} import $names\\` where { ${variableNames\n      .map((n) => `$names <: contains \\`${n}\\``)\n      .join(', ')} }`,\n  );\n  if (allAlreadyPresent) {\n    return;\n  }\n\n  // No existing `from <module> import` line — prepend one. Ruff's import\n  // sorter will place it in the right group on the next formatter pass.\n  const specifiers = variableNames.join(', ');\n  tree.write(filePath, `from ${from} import ${specifiers}\\n${beforeContents}`);\n};\n\n/**\n * Adds an `import <variableName> from '<from>'; statement to the beginning of the file,\n * if it doesn't already exist\n */\nexport const addSingleImport = async (\n  tree: Tree,\n  filePath: string,\n  variableName: string,\n  from: string,\n) => {\n  assertFilePath(tree, filePath);\n  from = normalizeModuleSpecifier(tree, from);\n\n  // Check if default import already exists using GritQL\n  const alreadyImported = await matchGritQL(\n    tree,\n    filePath,\n    `\\`import ${variableName} from '${from}'\\``,\n  );\n  if (alreadyImported) {\n    return;\n  }\n\n  // The same identifier bound to a different module would be a duplicate\n  // declaration, so refuse rather than emit a file that cannot compile.\n  const identifierTaken = await matchGritQL(\n    tree,\n    filePath,\n    `\\`import ${variableName} from $module\\``,\n  );\n  if (identifierTaken) {\n    throw new Error(\n      `Cannot import ${variableName} from '${from}' in ${filePath}: ${variableName} is already imported from a different module. Rename the project so its generated identifier does not collide.`,\n    );\n  }\n\n  // Prepend new import to file\n  const contents = tree.read(filePath)!.toString();\n  tree.write(filePath, `import ${variableName} from '${from}';\\n${contents}`);\n};\n\n/**\n * Adds an `export * from '<from>'; statement to the given TypeScript file.\n * Note that this will create the file if it does not exist in the tree.\n */\nexport const addStarExport = async (\n  tree: Tree,\n  filePath: string,\n  from: string,\n) => {\n  from = normalizeModuleSpecifier(tree, from);\n  const contents = tree.read(filePath)?.toString() ?? '';\n\n  // For empty/non-existent files, just write the export\n  if (!contents.trim()) {\n    tree.write(filePath, `export * from '${from}';\\n`);\n    return;\n  }\n\n  // Check if already exported using GritQL\n  const alreadyExported = await matchGritQL(\n    tree,\n    filePath,\n    `\\`export * from '${from}'\\``,\n  );\n  if (alreadyExported) {\n    return;\n  }\n\n  // Prepend new export to file\n  tree.write(filePath, `export * from '${from}';\\n${contents}`);\n};\n\n/**\n * Adds an `export { <names> } from '<from>';` statement to the given TypeScript\n * file, merging into an existing re-export of the same module when there is one.\n * Note that this will create the file if it does not exist in the tree.\n *\n * Adding to whatever is already there is what lets a barrel the user curates —\n * their own entities, models or components — survive a generator re-run while\n * the generated entry is still registered.\n */\nexport const addNamedExport = async (\n  tree: Tree,\n  filePath: string,\n  names: string[],\n  from: string,\n) => {\n  from = normalizeModuleSpecifier(tree, from);\n  const contents = tree.read(filePath)?.toString() ?? '';\n\n  if (!contents.trim()) {\n    tree.write(filePath, `export { ${names.join(', ')} } from '${from}';\\n`);\n    return;\n  }\n\n  const hasExistingExport = await matchGritQL(\n    tree,\n    filePath,\n    `\\`export { $_ } from '${from}'\\``,\n  );\n\n  if (hasExistingExport) {\n    for (const name of names) {\n      await applyGritQL(\n        tree,\n        filePath,\n        `\\`export { $names } from '${from}'\\` => \\`export { $names, ${name} } from '${from}'\\` where { $names <: not contains \\`${name}\\` }`,\n      );\n    }\n    return;\n  }\n\n  const missing: string[] = [];\n  for (const name of names) {\n    if (!(await matchGritQL(tree, filePath, `\\`${name}\\``))) {\n      missing.push(name);\n    }\n  }\n  if (missing.length === 0) {\n    return;\n  }\n\n  tree.write(\n    filePath,\n    `export { ${missing.join(', ')} } from '${from}';\\n${contents}`,\n  );\n};\n\n/**\n * Return whether or not the given identifier is exported in the source file.\n * Checks for both `export { Identifier }` and `export type Identifier = ...`.\n */\nexport const hasExportDeclaration = async (\n  tree: Tree,\n  source: string,\n  identifierName: string,\n): Promise<boolean> => {\n  ensureGritDir(tree);\n  const patterns = [\n    `\\`export type ${identifierName} = $_\\``,\n    `\\`export { ${identifierName} }\\``,\n    `\\`export type { ${identifierName} } from $_\\``,\n  ];\n\n  for (const pattern of patterns) {\n    try {\n      const q = new QueryBuilder(`$p => $p where { $p <: ${pattern} }`);\n      const result = await q.applyToFile({\n        path: 'check.ts',\n        content: source,\n      });\n      if (result !== null) return true;\n    } catch {\n      // Pattern didn't match, try next\n    }\n  }\n\n  return false;\n};\n\n/**\n * Apply a GritQL pattern to a file in the Nx tree.\n */\nexport const applyGritQL = async (\n  tree: Tree,\n  filePath: string,\n  pattern: string,\n): Promise<boolean> => {\n  if (!tree.exists(filePath)) throw new Error(`No file at ${filePath}`);\n  ensureGritDir(tree);\n  const source = tree.read(filePath)!.toString();\n  const query = new QueryBuilder(pattern);\n  const result = await query.applyToFile({ path: filePath, content: source });\n  if (result && result.content !== source) {\n    tree.write(filePath, result.content);\n    return true;\n  }\n  return false;\n};\n\n/**\n * Check whether a GritQL pattern matches anywhere in a file.\n * Returns true if the pattern matches at least once.\n *\n * Accepts raw GritQL, including patterns that start with a `language <name>`\n * header (e.g. `language python\\n\\`print($_)\\``) — the pattern is passed\n * straight through to QueryBuilder without any wrapping rewrite.\n */\nexport const matchGritQL = async (\n  tree: Tree,\n  filePath: string,\n  pattern: string,\n): Promise<boolean> => {\n  if (!tree.exists(filePath)) return false;\n  ensureGritDir(tree);\n  const source = tree.read(filePath)!.toString();\n  let matched = false;\n  try {\n    const query = new QueryBuilder(pattern);\n    query.filter(() => {\n      matched = true;\n      return true;\n    });\n    await query.applyToFile({ path: filePath, content: source });\n  } catch {\n    return false;\n  }\n  return matched;\n};\n\n/**\n * Capture the source text of the first match of a GritQL pattern.\n *\n * For example `` `dependencyCheck: $_` `` returns the whole\n * `dependencyCheck: { ... }` property text. Returns undefined if nothing\n * matches. The file is not modified.\n */\nexport const captureGritQL = async (\n  tree: Tree,\n  filePath: string,\n  pattern: string,\n): Promise<string | undefined> => {\n  if (!tree.exists(filePath)) return undefined;\n  ensureGritDir(tree);\n  const source = tree.read(filePath)!.toString();\n  let captured: string | undefined;\n  try {\n    const query = new QueryBuilder(pattern);\n    query.filter((node) => {\n      captured ??= node.text();\n      return true;\n    });\n    await query.applyToFile({ path: filePath, content: source });\n  } catch {\n    return undefined;\n  }\n  return captured;\n};\n\n/**\n * Like `captureGritQL`, but returns one metavariable's binding (e.g. `mod`\n * for `$mod`) instead of the whole matched node.\n */\nexport const captureGritQLVariable = async (\n  tree: Tree,\n  filePath: string,\n  pattern: string,\n  variableName: string,\n): Promise<string | undefined> => {\n  if (!tree.exists(filePath)) return undefined;\n  ensureGritDir(tree);\n  const source = tree.read(filePath)!.toString();\n  // The underlying binding lookup requires the `$` sigil.\n  const name = variableName.startsWith('$') ? variableName : `$${variableName}`;\n  let captured: string | undefined;\n  try {\n    const query = new QueryBuilder(pattern);\n    query.filter((node) => {\n      captured ??= node.var(name) ?? undefined;\n      return true;\n    });\n    await query.applyToFile({ path: filePath, content: source });\n  } catch {\n    return undefined;\n  }\n  return captured;\n};\n\n/**\n * Like {@link captureAllGritQL}, but returns one metavariable's binding for every\n * match rather than the whole matched node.\n *\n * This is what lets a caller work on the value a pattern isolated — matching\n * `` `runtime: $value` `` and reading `$value` gives `Runtime.NODEJS_24_X` alone,\n * so nothing downstream has to re-derive the assignment around it.\n *\n * A match whose metavariable is unbound contributes nothing, so the result holds\n * only real bindings. Returns undefined if the pattern could not be applied,\n * which an empty array cannot express.\n */\nexport const captureAllGritQLVariable = async (\n  tree: Tree,\n  filePath: string,\n  pattern: string,\n  variableName: string,\n): Promise<string[] | undefined> => {\n  if (!tree.exists(filePath)) return undefined;\n  ensureGritDir(tree);\n  const source = tree.read(filePath)!.toString();\n  // The underlying binding lookup requires the `$` sigil.\n  const name = variableName.startsWith('$') ? variableName : `$${variableName}`;\n  const captured: string[] = [];\n  try {\n    const query = new QueryBuilder(pattern);\n    query.filter((node) => {\n      const bound = node.var(name);\n      if (bound !== null && bound !== undefined) {\n        captured.push(bound);\n      }\n      return true;\n    });\n    await query.applyToFile({ path: filePath, content: source });\n  } catch {\n    return undefined;\n  }\n  return captured;\n};\n\n/**\n * Return the text of every node matching the GritQL pattern, in document order.\n */\nexport const captureAllGritQL = async (\n  tree: Tree,\n  filePath: string,\n  pattern: string,\n): Promise<string[]> => {\n  if (!tree.exists(filePath)) return [];\n  ensureGritDir(tree);\n  const source = tree.read(filePath)!.toString();\n  const captured: string[] = [];\n  try {\n    const query = new QueryBuilder(pattern);\n    query.filter((node) => {\n      captured.push(node.text());\n      return true;\n    });\n    await query.applyToFile({ path: filePath, content: source });\n  } catch {\n    return [];\n  }\n  return captured;\n};\n\n/**\n * A unique token that is a valid identifier, so it can stand in for an array\n * element or object property inside a GritQL rewrite.\n */\nexport const GRIT_INSERT_PLACEHOLDER = '__GRIT_INSERT_PLACEHOLDER__';\n\n/**\n * Apply a GritQL rewrite that inserts {@link GRIT_INSERT_PLACEHOLDER}, then\n * replace the placeholder with `text`. Routing user-provided text through a\n * placeholder keeps it out of the GritQL pattern, where quotes, backticks or\n * `${...}` would otherwise break parsing.\n *\n * Any separator (e.g. a leading `, ` when appending to an array) must be part\n * of the GritQL pattern, not `text`. The one adjustment made here: if the\n * placeholder lands after a trailing line comment (`// ...`) — which would\n * comment out the text — the text is moved to its own line.\n *\n * The caller formats afterwards. Returns true if the pattern matched and the\n * file changed.\n */\nexport const insertViaGritQL = async (\n  tree: Tree,\n  filePath: string,\n  pattern: string,\n  text: string,\n): Promise<boolean> => {\n  if (!(await applyGritQL(tree, filePath, pattern))) return false;\n  const content = tree.read(filePath)!.toString();\n  const at = content.indexOf(GRIT_INSERT_PLACEHOLDER);\n  const lineSoFar = content.slice(content.lastIndexOf('\\n', at) + 1, at);\n  const replacement = lineSoFar.includes('//') ? `\\n${text}` : text;\n\n  // Function replacer so `$` in `text` isn't treated as a replacement pattern.\n  tree.write(\n    filePath,\n    content.replace(GRIT_INSERT_PLACEHOLDER, () => replacement),\n  );\n  return true;\n};\n\n/**\n * Append `entry` to an array, skipping arrays that already contain it, e.g.\n * `` appendToArrayViaGritQL(tree, file, 'tools:', 'myTool', { scope: 'new Agent($_)' }) ``\n * turns `tools: [a, b]` into `tools: [a, b, myTool]`.\n *\n * `arrayPrefix` is whatever precedes the array literal, including its separator —\n * `'tools:'` for an object property, `'tools='` for a keyword argument or\n * assignment, `'\"tools\":'` for a quoted key. Which separator applies depends on\n * the construct rather than the language, so the caller states it.\n *\n * Appends after the last *element* rather than rewriting the element list with\n * `=>`. GritQL binds a `[$items]` list to its trailing comma too, so\n * `` `[$items]` => `[$items, entry]` `` emits the sparse array `[a, b, , entry]`\n * once the formatter has wrapped the array — a hole that is `undefined` at\n * runtime. (Accumulating with `$items += \", entry\"` is safe by comparison, since\n * it appends within the list rather than re-emitting it; both forms appear in\n * this repo.)\n *\n * `scope` limits the match to an enclosing pattern, so same-named arrays\n * elsewhere in the file are left alone. `skipIfContains` overrides what the\n * append dedupes on, for when the rendered entry is not the identifier to match.\n *\n * The caller formats afterwards. Returns true if the entry was appended.\n */\nexport const appendToArrayViaGritQL = async (\n  tree: Tree,\n  filePath: string,\n  arrayPrefix: string,\n  entry: string,\n  options: { scope?: string; skipIfContains?: string; language?: 'py' } = {},\n): Promise<boolean> => {\n  const { scope, skipIfContains, language } = options;\n  const within = (variable: string) =>\n    scope ? `${variable} <: within \\`${scope}\\`, ` : '';\n  const pattern =\n    `or {` +\n    // An empty array has no last element to append after.\n    ` \\`${arrayPrefix}$arr\\` where { $arr <: \\`[]\\`, ${within('$arr')}` +\n    ` $arr => \\`[${GRIT_INSERT_PLACEHOLDER}]\\` },` +\n    // Dedupe on the list, append after its last element.\n    ` \\`${arrayPrefix}[$items]\\` where {` +\n    ` $items <: not contains \\`${skipIfContains ?? entry}\\`, ${within('$items')}` +\n    ` $items <: [$..., $last], $last += \\`, ${GRIT_INSERT_PLACEHOLDER}\\` }` +\n    ` }`;\n\n  return insertViaGritQL(\n    tree,\n    filePath,\n    language === 'py' ? `language python\\n${pattern}` : pattern,\n    entry,\n  );\n};\n"],"names":["QueryBuilder","path","updateGitIgnore","isEsmWorkspace","GRIT_DIR","normalizeModuleSpecifier","tree","from","isRelative","startsWith","endsWith","slice","length","ensureGritDir","process","env","GRIT_GLOBAL_DIR","join","root","patterns","assertFilePath","filePath","exists","Error","addDestructuredImport","variableNames","hasExistingImport","matchGritQL","variableName","localName","includes","split","applyGritQL","specifiers","contents","read","toString","newImport","newlineIndex","indexOf","write","substring","addPythonDestructuredImport","beforeContents","moduleAlreadyImported","appended","allAlreadyPresent","map","n","addSingleImport","alreadyImported","identifierTaken","addStarExport","trim","alreadyExported","addNamedExport","names","hasExistingExport","name","missing","push","hasExportDeclaration","source","identifierName","pattern","q","result","applyToFile","content","query","matched","filter","captureGritQL","undefined","captured","node","text","captureGritQLVariable","var","captureAllGritQLVariable","bound","captureAllGritQL","GRIT_INSERT_PLACEHOLDER","insertViaGritQL","at","lineSoFar","lastIndexOf","replacement","replace","appendToArrayViaGritQL","arrayPrefix","entry","options","scope","skipIfContains","language","within","variable"],"mappings":"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"}
+{"version":3,"sources":["../../../../../packages/nx-plugin/src/utils/ast.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { QueryBuilder } from '@getgrit/gritql';\nimport type { Tree } from '@nx/devkit';\nimport * as path from 'path';\nimport {\n  LANGUAGE_COMMENT_SYNTAX,\n  readLicenseConfig,\n} from '../license/config.js';\nimport type { CommentSyntax } from '../license/config-types.js';\nimport { parseFile } from '../license/sync/generator.js';\nimport { updateGitIgnore } from './git.js';\nimport { isEsmWorkspace } from './module-format.js';\n\nconst GRIT_DIR = '.grit';\n\n/**\n * Normalize a relative module specifier for the workspace's module format.\n * ESM (`nodenext`) requires an explicit `.js` extension on relative imports;\n * CommonJS (`node16`) resolves them extensionless. Callers always pass the ESM\n * form (with `.js`); this strips the extension for CommonJS workspaces.\n */\nconst normalizeModuleSpecifier = (tree: Tree, from: string): string => {\n  if (isEsmWorkspace(tree)) {\n    return from;\n  }\n  const isRelative = from.startsWith('./') || from.startsWith('../');\n  return isRelative && from.endsWith('.js')\n    ? from.slice(0, -'.js'.length)\n    : from;\n};\n\n// Pin the gritql native library's \"global\" stdlib directory to <workspace>/.grit so it doesn't try to write to /usr/local/.grit (or wherever node's grandparent resolves to).\nconst ensureGritDir = (tree: Tree) => {\n  process.env.GRIT_GLOBAL_DIR ??= path.join(tree.root, GRIT_DIR);\n  updateGitIgnore(tree, '.', (patterns) => [...patterns, GRIT_DIR]);\n};\n\nconst assertFilePath = (tree: Tree, filePath: string) => {\n  if (!tree.exists(filePath)) {\n    throw new Error(`No file located at ${filePath}`);\n  }\n};\n\n/**\n * Insert `statement` at the top of a file, below any hashbang and leading\n * comment block. Keeps a license header first in the file, so `license#sync`\n * doesn't see it displaced and prepend a second one.\n *\n * The leading comment is skipped whatever it says — a header, a placeholder or a\n * note — so nothing here has to identify a license.\n *\n * Splits the file with the sync generator's own `parseFile`, resolving the\n * comment syntax the way the sync does: the workspace's configured\n * `commentSyntax` for the extension first, then the built-in table. That way an\n * extension only the user's config covers is still recognised. An extension\n * neither covers has no comment syntax to find, so the statement goes at the top.\n */\nconst insertBelowLeadingComments = async (\n  tree: Tree,\n  filePath: string,\n  contents: string,\n  statement: string,\n): Promise<string> => {\n  const extension = filePath.split('.').pop() ?? '';\n  let syntax: CommentSyntax | undefined;\n  try {\n    syntax = (await readLicenseConfig(tree))?.source?.header?.commentSyntax?.[\n      extension\n    ];\n  } catch {\n    // Reading the config evaluates it, which throws on a config that doesn't\n    // load — including this file itself while a generator is mid-edit. A config\n    // we can't read must not stop an import being added, so fall back to the\n    // defaults. (A config that simply doesn't exist reads as undefined.)\n  }\n  syntax ??= LANGUAGE_COMMENT_SYNTAX[extension];\n  if (!syntax) {\n    return `${statement}\\n${contents}`;\n  }\n\n  const { hashbang, header, body } = parseFile(contents, syntax);\n  if (!hashbang && !header) {\n    return `${statement}\\n${contents}`;\n  }\n  return [\n    ...(hashbang ? [hashbang] : []),\n    ...(header ? [header] : []),\n    statement,\n    body,\n  ].join('\\n');\n};\n\nexport const addDestructuredImport = async (\n  tree: Tree,\n  filePath: string,\n  variableNames: string[],\n  from: string,\n) => {\n  assertFilePath(tree, filePath);\n  from = normalizeModuleSpecifier(tree, from);\n\n  // Check if there's an existing import from this module\n  const hasExistingImport = await matchGritQL(\n    tree,\n    filePath,\n    `\\`import { $_ } from '${from}'\\``,\n  );\n\n  if (hasExistingImport) {\n    // For each new variable, use GritQL rewrite to add it if not already present\n    for (const variableName of variableNames) {\n      const localName = variableName.includes(' as ')\n        ? variableName.split(' as ')[1]\n        : variableName;\n      // Use rewrite (=>) which correctly handles comma-separated import specifier lists\n      await applyGritQL(\n        tree,\n        filePath,\n        `\\`import { $imports } from '${from}'\\` => \\`import { $imports, ${variableName} } from '${from}'\\` where { $imports <: not contains \\`${localName}\\` }`,\n      );\n    }\n  } else {\n    // No existing import — add a new one below any hashbang and leading comment\n    const specifiers = variableNames.join(', ');\n    const contents = tree.read(filePath)!.toString();\n    tree.write(\n      filePath,\n      await insertBelowLeadingComments(\n        tree,\n        filePath,\n        contents,\n        `import { ${specifiers} } from '${from}';`,\n      ),\n    );\n  }\n};\n\n/**\n * Ensure a Python `from <module> import <name1>, <name2>, ...` statement\n * exists in the given file. If the module already has a `from <module> import`\n * line, any missing names are appended; otherwise a fresh import statement is\n * prepended to the file (ruff's import sorter will reorder it into place on\n * the next format pass).\n *\n * We try to append first (which only succeeds if an import-from for the\n * module already exists AND the name isn't yet in the list). If nothing\n * was rewritten after trying every requested name, we fall back to checking\n * whether the module is imported at all; if not, we prepend a fresh\n * `from <module> import ...` line.\n */\nexport const addPythonDestructuredImport = async (\n  tree: Tree,\n  filePath: string,\n  variableNames: string[],\n  from: string,\n) => {\n  assertFilePath(tree, filePath);\n\n  // Determine whether there's any `from <module> import ...` line in the file.\n  // We detect this by attempting a no-op transformation — the file is unchanged,\n  // but a successful match tells us the line exists.\n  const beforeContents = tree.read(filePath)!.toString();\n  let moduleAlreadyImported = false;\n  for (const variableName of variableNames) {\n    // Appends the name if the import-from exists and the name isn't already there.\n    const appended = await applyGritQL(\n      tree,\n      filePath,\n      `language python\\n\\`from ${from} import $names\\` where { $names <: not contains \\`${variableName}\\`, $names += \\`, ${variableName}\\` }`,\n    );\n    if (appended) {\n      moduleAlreadyImported = true;\n    }\n  }\n\n  // If the append succeeded for at least one name, we know the module line\n  // exists; we're done. If nothing was appended we need to distinguish\n  // between \"module not imported\" (need to add a new line) and \"module\n  // imported but all names already present\" (no-op).\n  if (moduleAlreadyImported) {\n    return;\n  }\n\n  const allAlreadyPresent = await matchGritQL(\n    tree,\n    filePath,\n    `language python\\n\\`from ${from} import $names\\` where { ${variableNames\n      .map((n) => `$names <: contains \\`${n}\\``)\n      .join(', ')} }`,\n  );\n  if (allAlreadyPresent) {\n    return;\n  }\n\n  // No existing `from <module> import` line — add one below any hashbang and\n  // leading comment. Ruff's import sorter will place it in the right group on\n  // the next formatter pass.\n  const specifiers = variableNames.join(', ');\n  tree.write(\n    filePath,\n    await insertBelowLeadingComments(\n      tree,\n      filePath,\n      beforeContents,\n      `from ${from} import ${specifiers}`,\n    ),\n  );\n};\n\n/**\n * Adds an `import <variableName> from '<from>'; statement to the beginning of the file,\n * if it doesn't already exist\n */\nexport const addSingleImport = async (\n  tree: Tree,\n  filePath: string,\n  variableName: string,\n  from: string,\n) => {\n  assertFilePath(tree, filePath);\n  from = normalizeModuleSpecifier(tree, from);\n\n  // Check if default import already exists using GritQL\n  const alreadyImported = await matchGritQL(\n    tree,\n    filePath,\n    `\\`import ${variableName} from '${from}'\\``,\n  );\n  if (alreadyImported) {\n    return;\n  }\n\n  // The same identifier bound to a different module would be a duplicate\n  // declaration, so refuse rather than emit a file that cannot compile.\n  const identifierTaken = await matchGritQL(\n    tree,\n    filePath,\n    `\\`import ${variableName} from $module\\``,\n  );\n  if (identifierTaken) {\n    throw new Error(\n      `Cannot import ${variableName} from '${from}' in ${filePath}: ${variableName} is already imported from a different module. Rename the project so its generated identifier does not collide.`,\n    );\n  }\n\n  // Add the import below any hashbang and leading comment\n  const contents = tree.read(filePath)!.toString();\n  tree.write(\n    filePath,\n    await insertBelowLeadingComments(\n      tree,\n      filePath,\n      contents,\n      `import ${variableName} from '${from}';`,\n    ),\n  );\n};\n\n/**\n * Adds an `export * from '<from>'; statement to the given TypeScript file.\n * Note that this will create the file if it does not exist in the tree.\n */\nexport const addStarExport = async (\n  tree: Tree,\n  filePath: string,\n  from: string,\n) => {\n  from = normalizeModuleSpecifier(tree, from);\n  const contents = tree.read(filePath)?.toString() ?? '';\n\n  // For empty/non-existent files, just write the export\n  if (!contents.trim()) {\n    tree.write(filePath, `export * from '${from}';\\n`);\n    return;\n  }\n\n  // Check if already exported using GritQL\n  const alreadyExported = await matchGritQL(\n    tree,\n    filePath,\n    `\\`export * from '${from}'\\``,\n  );\n  if (alreadyExported) {\n    return;\n  }\n\n  tree.write(\n    filePath,\n    await insertBelowLeadingComments(\n      tree,\n      filePath,\n      contents,\n      `export * from '${from}';`,\n    ),\n  );\n};\n\n/**\n * Adds an `export { <names> } from '<from>';` statement to the given TypeScript\n * file, merging into an existing re-export of the same module when there is one.\n * Note that this will create the file if it does not exist in the tree.\n *\n * Adding to whatever is already there is what lets a barrel the user curates —\n * their own entities, models or components — survive a generator re-run while\n * the generated entry is still registered.\n */\nexport const addNamedExport = async (\n  tree: Tree,\n  filePath: string,\n  names: string[],\n  from: string,\n) => {\n  from = normalizeModuleSpecifier(tree, from);\n  const contents = tree.read(filePath)?.toString() ?? '';\n\n  if (!contents.trim()) {\n    tree.write(filePath, `export { ${names.join(', ')} } from '${from}';\\n`);\n    return;\n  }\n\n  const hasExistingExport = await matchGritQL(\n    tree,\n    filePath,\n    `\\`export { $_ } from '${from}'\\``,\n  );\n\n  if (hasExistingExport) {\n    for (const name of names) {\n      await applyGritQL(\n        tree,\n        filePath,\n        `\\`export { $names } from '${from}'\\` => \\`export { $names, ${name} } from '${from}'\\` where { $names <: not contains \\`${name}\\` }`,\n      );\n    }\n    return;\n  }\n\n  const missing: string[] = [];\n  for (const name of names) {\n    if (!(await matchGritQL(tree, filePath, `\\`${name}\\``))) {\n      missing.push(name);\n    }\n  }\n  if (missing.length === 0) {\n    return;\n  }\n\n  tree.write(\n    filePath,\n    await insertBelowLeadingComments(\n      tree,\n      filePath,\n      contents,\n      `export { ${missing.join(', ')} } from '${from}';`,\n    ),\n  );\n};\n\n/**\n * Return whether or not the given identifier is exported in the source file.\n * Checks for both `export { Identifier }` and `export type Identifier = ...`.\n */\nexport const hasExportDeclaration = async (\n  tree: Tree,\n  source: string,\n  identifierName: string,\n): Promise<boolean> => {\n  ensureGritDir(tree);\n  const patterns = [\n    `\\`export type ${identifierName} = $_\\``,\n    `\\`export { ${identifierName} }\\``,\n    `\\`export type { ${identifierName} } from $_\\``,\n  ];\n\n  for (const pattern of patterns) {\n    try {\n      const q = new QueryBuilder(`$p => $p where { $p <: ${pattern} }`);\n      const result = await q.applyToFile({\n        path: 'check.ts',\n        content: source,\n      });\n      if (result !== null) return true;\n    } catch {\n      // Pattern didn't match, try next\n    }\n  }\n\n  return false;\n};\n\n/**\n * Apply a GritQL pattern to a file in the Nx tree.\n */\nexport const applyGritQL = async (\n  tree: Tree,\n  filePath: string,\n  pattern: string,\n): Promise<boolean> => {\n  if (!tree.exists(filePath)) throw new Error(`No file at ${filePath}`);\n  ensureGritDir(tree);\n  const source = tree.read(filePath)!.toString();\n  const query = new QueryBuilder(pattern);\n  const result = await query.applyToFile({ path: filePath, content: source });\n  if (result && result.content !== source) {\n    tree.write(filePath, result.content);\n    return true;\n  }\n  return false;\n};\n\n/**\n * Check whether a GritQL pattern matches anywhere in a file.\n * Returns true if the pattern matches at least once.\n *\n * Accepts raw GritQL, including patterns that start with a `language <name>`\n * header (e.g. `language python\\n\\`print($_)\\``) — the pattern is passed\n * straight through to QueryBuilder without any wrapping rewrite.\n */\nexport const matchGritQL = async (\n  tree: Tree,\n  filePath: string,\n  pattern: string,\n): Promise<boolean> => {\n  if (!tree.exists(filePath)) return false;\n  ensureGritDir(tree);\n  const source = tree.read(filePath)!.toString();\n  let matched = false;\n  try {\n    const query = new QueryBuilder(pattern);\n    query.filter(() => {\n      matched = true;\n      return true;\n    });\n    await query.applyToFile({ path: filePath, content: source });\n  } catch {\n    return false;\n  }\n  return matched;\n};\n\n/**\n * Capture the source text of the first match of a GritQL pattern.\n *\n * For example `` `dependencyCheck: $_` `` returns the whole\n * `dependencyCheck: { ... }` property text. Returns undefined if nothing\n * matches. The file is not modified.\n */\nexport const captureGritQL = async (\n  tree: Tree,\n  filePath: string,\n  pattern: string,\n): Promise<string | undefined> => {\n  if (!tree.exists(filePath)) return undefined;\n  ensureGritDir(tree);\n  const source = tree.read(filePath)!.toString();\n  let captured: string | undefined;\n  try {\n    const query = new QueryBuilder(pattern);\n    query.filter((node) => {\n      captured ??= node.text();\n      return true;\n    });\n    await query.applyToFile({ path: filePath, content: source });\n  } catch {\n    return undefined;\n  }\n  return captured;\n};\n\n/**\n * Like `captureGritQL`, but returns one metavariable's binding (e.g. `mod`\n * for `$mod`) instead of the whole matched node.\n */\nexport const captureGritQLVariable = async (\n  tree: Tree,\n  filePath: string,\n  pattern: string,\n  variableName: string,\n): Promise<string | undefined> => {\n  if (!tree.exists(filePath)) return undefined;\n  ensureGritDir(tree);\n  const source = tree.read(filePath)!.toString();\n  // The underlying binding lookup requires the `$` sigil.\n  const name = variableName.startsWith('$') ? variableName : `$${variableName}`;\n  let captured: string | undefined;\n  try {\n    const query = new QueryBuilder(pattern);\n    query.filter((node) => {\n      captured ??= node.var(name) ?? undefined;\n      return true;\n    });\n    await query.applyToFile({ path: filePath, content: source });\n  } catch {\n    return undefined;\n  }\n  return captured;\n};\n\n/**\n * Like {@link captureAllGritQL}, but returns one metavariable's binding for every\n * match rather than the whole matched node.\n *\n * This is what lets a caller work on the value a pattern isolated — matching\n * `` `runtime: $value` `` and reading `$value` gives `Runtime.NODEJS_24_X` alone,\n * so nothing downstream has to re-derive the assignment around it.\n *\n * A match whose metavariable is unbound contributes nothing, so the result holds\n * only real bindings. Returns undefined if the pattern could not be applied,\n * which an empty array cannot express.\n */\nexport const captureAllGritQLVariable = async (\n  tree: Tree,\n  filePath: string,\n  pattern: string,\n  variableName: string,\n): Promise<string[] | undefined> => {\n  if (!tree.exists(filePath)) return undefined;\n  ensureGritDir(tree);\n  const source = tree.read(filePath)!.toString();\n  // The underlying binding lookup requires the `$` sigil.\n  const name = variableName.startsWith('$') ? variableName : `$${variableName}`;\n  const captured: string[] = [];\n  try {\n    const query = new QueryBuilder(pattern);\n    query.filter((node) => {\n      const bound = node.var(name);\n      if (bound !== null && bound !== undefined) {\n        captured.push(bound);\n      }\n      return true;\n    });\n    await query.applyToFile({ path: filePath, content: source });\n  } catch {\n    return undefined;\n  }\n  return captured;\n};\n\n/**\n * Return the text of every node matching the GritQL pattern, in document order.\n */\nexport const captureAllGritQL = async (\n  tree: Tree,\n  filePath: string,\n  pattern: string,\n): Promise<string[]> => {\n  if (!tree.exists(filePath)) return [];\n  ensureGritDir(tree);\n  const source = tree.read(filePath)!.toString();\n  const captured: string[] = [];\n  try {\n    const query = new QueryBuilder(pattern);\n    query.filter((node) => {\n      captured.push(node.text());\n      return true;\n    });\n    await query.applyToFile({ path: filePath, content: source });\n  } catch {\n    return [];\n  }\n  return captured;\n};\n\n/**\n * A unique token that is a valid identifier, so it can stand in for an array\n * element or object property inside a GritQL rewrite.\n */\nexport const GRIT_INSERT_PLACEHOLDER = '__GRIT_INSERT_PLACEHOLDER__';\n\n/**\n * Apply a GritQL rewrite that inserts {@link GRIT_INSERT_PLACEHOLDER}, then\n * replace the placeholder with `text`. Routing user-provided text through a\n * placeholder keeps it out of the GritQL pattern, where quotes, backticks or\n * `${...}` would otherwise break parsing.\n *\n * Any separator (e.g. a leading `, ` when appending to an array) must be part\n * of the GritQL pattern, not `text`. The one adjustment made here: if the\n * placeholder lands after a trailing line comment (`// ...`) — which would\n * comment out the text — the text is moved to its own line.\n *\n * The caller formats afterwards. Returns true if the pattern matched and the\n * file changed.\n */\nexport const insertViaGritQL = async (\n  tree: Tree,\n  filePath: string,\n  pattern: string,\n  text: string,\n): Promise<boolean> => {\n  if (!(await applyGritQL(tree, filePath, pattern))) return false;\n  const content = tree.read(filePath)!.toString();\n  const at = content.indexOf(GRIT_INSERT_PLACEHOLDER);\n  const lineSoFar = content.slice(content.lastIndexOf('\\n', at) + 1, at);\n  const replacement = lineSoFar.includes('//') ? `\\n${text}` : text;\n\n  // Function replacer so `$` in `text` isn't treated as a replacement pattern.\n  tree.write(\n    filePath,\n    content.replace(GRIT_INSERT_PLACEHOLDER, () => replacement),\n  );\n  return true;\n};\n\n/**\n * Append `entry` to an array, skipping arrays that already contain it, e.g.\n * `` appendToArrayViaGritQL(tree, file, 'tools:', 'myTool', { scope: 'new Agent($_)' }) ``\n * turns `tools: [a, b]` into `tools: [a, b, myTool]`.\n *\n * `arrayPrefix` is whatever precedes the array literal, including its separator —\n * `'tools:'` for an object property, `'tools='` for a keyword argument or\n * assignment, `'\"tools\":'` for a quoted key. Which separator applies depends on\n * the construct rather than the language, so the caller states it.\n *\n * Appends after the last *element* rather than rewriting the element list with\n * `=>`. GritQL binds a `[$items]` list to its trailing comma too, so\n * `` `[$items]` => `[$items, entry]` `` emits the sparse array `[a, b, , entry]`\n * once the formatter has wrapped the array — a hole that is `undefined` at\n * runtime. (Accumulating with `$items += \", entry\"` is safe by comparison, since\n * it appends within the list rather than re-emitting it; both forms appear in\n * this repo.)\n *\n * `scope` limits the match to an enclosing pattern, so same-named arrays\n * elsewhere in the file are left alone. `skipIfContains` overrides what the\n * append dedupes on, for when the rendered entry is not the identifier to match.\n *\n * The caller formats afterwards. Returns true if the entry was appended.\n */\nexport const appendToArrayViaGritQL = async (\n  tree: Tree,\n  filePath: string,\n  arrayPrefix: string,\n  entry: string,\n  options: { scope?: string; skipIfContains?: string; language?: 'py' } = {},\n): Promise<boolean> => {\n  const { scope, skipIfContains, language } = options;\n  const within = (variable: string) =>\n    scope ? `${variable} <: within \\`${scope}\\`, ` : '';\n  const pattern =\n    `or {` +\n    // An empty array has no last element to append after.\n    ` \\`${arrayPrefix}$arr\\` where { $arr <: \\`[]\\`, ${within('$arr')}` +\n    ` $arr => \\`[${GRIT_INSERT_PLACEHOLDER}]\\` },` +\n    // Dedupe on the list, append after its last element.\n    ` \\`${arrayPrefix}[$items]\\` where {` +\n    ` $items <: not contains \\`${skipIfContains ?? entry}\\`, ${within('$items')}` +\n    ` $items <: [$..., $last], $last += \\`, ${GRIT_INSERT_PLACEHOLDER}\\` }` +\n    ` }`;\n\n  return insertViaGritQL(\n    tree,\n    filePath,\n    language === 'py' ? `language python\\n${pattern}` : pattern,\n    entry,\n  );\n};\n"],"names":["QueryBuilder","path","LANGUAGE_COMMENT_SYNTAX","readLicenseConfig","parseFile","updateGitIgnore","isEsmWorkspace","GRIT_DIR","normalizeModuleSpecifier","tree","from","isRelative","startsWith","endsWith","slice","length","ensureGritDir","process","env","GRIT_GLOBAL_DIR","join","root","patterns","assertFilePath","filePath","exists","Error","insertBelowLeadingComments","contents","statement","extension","split","pop","syntax","source","header","commentSyntax","hashbang","body","addDestructuredImport","variableNames","hasExistingImport","matchGritQL","variableName","localName","includes","applyGritQL","specifiers","read","toString","write","addPythonDestructuredImport","beforeContents","moduleAlreadyImported","appended","allAlreadyPresent","map","n","addSingleImport","alreadyImported","identifierTaken","addStarExport","trim","alreadyExported","addNamedExport","names","hasExistingExport","name","missing","push","hasExportDeclaration","identifierName","pattern","q","result","applyToFile","content","query","matched","filter","captureGritQL","undefined","captured","node","text","captureGritQLVariable","var","captureAllGritQLVariable","bound","captureAllGritQL","GRIT_INSERT_PLACEHOLDER","insertViaGritQL","at","indexOf","lineSoFar","lastIndexOf","replacement","replace","appendToArrayViaGritQL","arrayPrefix","entry","options","scope","skipIfContains","language","within","variable"],"mappings":"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"}

package/src/utils/dependencies.d.ts

@@ -16,3 +16,13 @@ export declare const catalogsEnabled: (tree: Tree) => boolean;
  * and the root for shared tooling.
  */
 export declare const addDependenciesToPackageJson: (tree: Tree, dependencies: Record<string, string>, devDependencies: Record<string, string>, packageJsonPath?: string) => GeneratorCallback;
+/**
+ * Drop-in replacement for devkit's `removeDependenciesFromPackageJson` that
+ * also drops the package manager's catalog entry, which devkit leaves behind
+ * pointing at a package nothing declares any more.
+ *
+ * The entry is only dropped once no manifest in the workspace declares the
+ * package, so removing it from one project leaves another project's reference
+ * resolvable.
+ */
+export declare const removeDependenciesFromPackageJson: (tree: Tree, dependencies: string[], devDependencies: string[], packageJsonPath?: string) => GeneratorCallback;