@aws/nx-plugin 1.0.0-rc.54 → 1.0.0-rc.56

package/src/ts/agent/react-connection/generator.d.ts

@@ -5,6 +5,192 @@
 import { type Tree } from '@nx/devkit';
 import type { ResolvedConnectionOptions } from '../../../connection/generator';
 import { type NxGeneratorInfo } from '../../../utils/nx';
+/** The metadata this generator records, which its predicates read. */
+export interface TsAgentReactConnectionMetadata {
+    readonly auth: string;
+    readonly protocol: string;
+    /** The AG-UI theme module, which the website's `ux` selects. */
+    readonly theme: string;
+}
+export declare const DEPENDENCIES: import("../../../utils/declared-dependencies").DependencyDeclaration<readonly [{
+    readonly name: "@trpc/client";
+    readonly when: (m: TsAgentReactConnectionMetadata) => boolean;
+}, {
+    readonly name: "@tanstack/react-query";
+    readonly when: (m: TsAgentReactConnectionMetadata) => boolean;
+}, {
+    readonly name: "@tanstack/react-query-devtools";
+    readonly when: (m: TsAgentReactConnectionMetadata) => boolean;
+}, {
+    readonly name: "@trpc/tanstack-react-query";
+    readonly when: (m: TsAgentReactConnectionMetadata) => boolean;
+}, {
+    readonly name: "oidc-client-ts";
+    readonly when: (m: TsAgentReactConnectionMetadata) => boolean;
+}, {
+    readonly name: "aws4fetch";
+    readonly when: (m: TsAgentReactConnectionMetadata) => boolean;
+}, {
+    readonly name: "@aws-sdk/credential-provider-cognito-identity";
+    readonly when: (m: TsAgentReactConnectionMetadata) => boolean;
+}, {
+    readonly name: "react-oidc-context";
+    readonly when: (m: TsAgentReactConnectionMetadata) => boolean;
+}, {
+    readonly name: "@smithy/types";
+    readonly when: (m: TsAgentReactConnectionMetadata) => boolean;
+    readonly dev: true;
+}, Omit<{
+    readonly name: "@copilotkit/react-core";
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "@ag-ui/client";
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "@cloudscape-design/chat-components";
+    readonly when: (m: import("../../react-website/agui/generator").AgUiMetadata) => boolean;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "lucide-react";
+    readonly when: (m: import("../../react-website/agui/generator").AgUiMetadata) => boolean;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "oidc-client-ts";
+    readonly when: (m: import("../../react-website/agui/generator").AgUiMetadata) => boolean;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "aws4fetch";
+    readonly when: (m: import("../../react-website/agui/generator").AgUiMetadata) => boolean;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "@aws-sdk/credential-provider-cognito-identity";
+    readonly when: (m: import("../../react-website/agui/generator").AgUiMetadata) => boolean;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "react-oidc-context";
+    readonly when: (m: import("../../react-website/agui/generator").AgUiMetadata) => boolean;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "@smithy/types";
+    readonly when: (m: import("../../react-website/agui/generator").AgUiMetadata) => boolean;
+    readonly dev: true;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "react";
+} & {
+    versionOnly: true;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "react-dom";
+} & {
+    versionOnly: true;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "class-variance-authority";
+} & {
+    versionOnly: true;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "clsx";
+} & {
+    versionOnly: true;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "tailwind-merge";
+} & {
+    versionOnly: true;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "lucide-react";
+} & {
+    versionOnly: true;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "tw-animate-css";
+} & {
+    versionOnly: true;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "radix-ui";
+} & {
+    versionOnly: true;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "vite";
+} & {
+    versionOnly: true;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "vitest";
+} & {
+    versionOnly: true;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "@vitest/coverage-v8";
+} & {
+    versionOnly: true;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}], readonly import("../../../utils/declared-dependencies").DeclaredPyDependency<"a2a-sdk" | "ag-ui-langgraph" | "ag-ui-protocol" | "ag-ui-strands" | "aws-lambda-powertools" | "aws-lambda-powertools[tracer]" | "aws-lambda-powertools[parser]" | "aws-opentelemetry-distro" | "bedrock-agentcore" | "boto3" | "checkov" | "fastapi" | "fastapi[standard]" | "httpx" | "langchain" | "langchain-aws" | "langchain-mcp-adapters" | "langgraph" | "mcp" | "pip-check-updates" | "pip-licenses" | "ruff" | "strands-agents" | "strands-agents[a2a]" | "strands-agents-tools" | "ty" | "pynamodb" | "uvicorn" | "sqlmodel" | "alembic" | "aiomysql" | "asyncpg" | "greenlet", TsAgentReactConnectionMetadata>[]>;
 export declare const TS_AGENT_REACT_CONNECTION_GENERATOR_INFO: NxGeneratorInfo;
 export declare function tsAgentReactConnectionGenerator(tree: Tree, options: ResolvedConnectionOptions): Promise<() => Promise<void>>;
 export default tsAgentReactConnectionGenerator;

package/src/ts/agent/react-connection/generator.js

@@ -3,17 +3,68 @@
  * SPDX-License-Identifier: Apache-2.0
  */ import { generateFiles, joinPathFragments, OverwriteStrategy, updateJson } from "@nx/devkit";
 import { addAgentRuntimeToConnectionNamespace } from "../../../connection/agent-runtime-config.js";
+import { addTsDependencies } from "../../../utils/add-dependencies.js";
 import { addSingleImport, applyGritQL } from "../../../utils/ast.js";
-import { addDependenciesToPackageJson } from "../../../utils/dependencies.js";
+import { declareDependencies, onlyWhen, ownedElsewhere } from "../../../utils/declared-dependencies.js";
 import { formatFilesInSubtree } from "../../../utils/format.js";
 import { installDependencies } from "../../../utils/install.js";
 import { addGeneratorMetricsIfApplicable } from "../../../utils/metrics.js";
 import { kebabCase, toClassName } from "../../../utils/names.js";
-import { getGeneratorInfo, readProjectConfigurationUnqualified } from "../../../utils/nx.js";
-import { withVersions } from "../../../utils/versions.js";
-import { addAgUiReactConnection } from "../../react-website/agui/generator.js";
+import { addComponentGeneratorMetadata, getGeneratorInfo, readProjectConfigurationUnqualified } from "../../../utils/nx.js";
+import { toProjectRelativePath } from "../../../utils/paths.js";
+import { DEPENDENCIES as AGUI_DEPENDENCIES, addAgUiReactConnection, resolveAgUiTheme } from "../../react-website/agui/generator.js";
 import { runtimeConfigGenerator } from "../../react-website/runtime-config/generator.js";
 import { addTsAgentTargetToLocalDev } from "./local-dev.js";
+/** The tRPC-over-HTTP path, which the AG-UI path takes none of. */ const isHttp = (m)=>m.protocol !== 'ag-ui';
+/** The AG-UI path, whose packages `addAgUiReactConnection` adds. */ const isAgUi = (m)=>!isHttp(m);
+// Each entry names the protocol path it belongs to: the HTTP path's client and
+// auth packages are added here, the AG-UI path's by `addAgUiReactConnection` on
+// this generator's behalf.
+export const DEPENDENCIES = declareDependencies()({
+    ts: [
+        {
+            name: '@trpc/client',
+            when: isHttp
+        },
+        {
+            name: '@tanstack/react-query',
+            when: isHttp
+        },
+        {
+            name: '@tanstack/react-query-devtools',
+            when: isHttp
+        },
+        {
+            name: '@trpc/tanstack-react-query',
+            when: isHttp
+        },
+        {
+            name: 'oidc-client-ts',
+            when: (m)=>isHttp(m) && m.auth === 'iam'
+        },
+        {
+            name: 'aws4fetch',
+            when: (m)=>isHttp(m) && m.auth === 'iam'
+        },
+        {
+            name: '@aws-sdk/credential-provider-cognito-identity',
+            when: (m)=>isHttp(m) && m.auth === 'iam'
+        },
+        {
+            name: 'react-oidc-context',
+            when: (m)=>isHttp(m) && (m.auth === 'iam' || m.auth === 'cognito')
+        },
+        {
+            name: '@smithy/types',
+            when: isHttp,
+            dev: true
+        },
+        // `addAgUiReactConnection` adds these itself, so they are declared for
+        // ownership only. Gated on the AG-UI path, and within it on each entry's
+        // own theme or auth condition, which the metadata below records.
+        ...ownedElsewhere(onlyWhen(AGUI_DEPENDENCIES.ts, isAgUi))
+    ]
+});
 export const TS_AGENT_REACT_CONNECTION_GENERATOR_INFO = getGeneratorInfo(import.meta.filename);
 export async function tsAgentReactConnectionGenerator(tree, options) {
     const frontendProjectConfig = readProjectConfigurationUnqualified(tree, options.sourceProject);
@@ -27,6 +78,13 @@ export async function tsAgentReactConnectionGenerator(tree, options) {
     const auth = (targetComponent?.auth ?? metadata?.auth ?? 'iam').toLowerCase();
     const agentProjectAlias = agentProjectConfig.name;
     const agentPath = targetComponent?.path ?? 'src/agent';
+    // Recorded below and read by the declaration's predicates, so the packages
+    // added here are exactly the ones the version sync will own.
+    const connectionMetadata = {
+        auth,
+        protocol: targetComponent?.protocol ?? 'http',
+        theme: resolveAgUiTheme(frontendProjectConfig)
+    };
     if ((targetComponent?.protocol ?? '').toLowerCase() === 'a2a') {
         throw new Error(`Cannot connect a React website to an A2A agent. ` + `Consider generating an agent with the HTTP or AG-UI protocol instead.`);
     }
@@ -43,6 +101,8 @@ export async function tsAgentReactConnectionGenerator(tree, options) {
             port: agentPort,
             targetComponent
         });
+        // Recorded so the version sync knows this connection's dependencies are ours.
+        addComponentGeneratorMetadata(tree, frontendProjectConfig.name, TS_AGENT_REACT_CONNECTION_GENERATOR_INFO, toProjectRelativePath(frontendProjectConfig, joinPathFragments(frontendProjectConfig.sourceRoot, 'hooks', `useAgui${agentNameClassName}`)), agentNameClassName, connectionMetadata);
         await addGeneratorMetricsIfApplicable(tree, [
             TS_AGENT_REACT_CONNECTION_GENERATOR_INFO
         ]);
@@ -100,23 +160,12 @@ export async function tsAgentReactConnectionGenerator(tree, options) {
         agentNameKebabCase: kebabCase(agentNameClassName),
         agentNameClassName
     });
-    addDependenciesToPackageJson(tree, withVersions([
-        '@trpc/client',
-        '@tanstack/react-query',
-        '@tanstack/react-query-devtools',
-        '@trpc/tanstack-react-query',
-        ...auth === 'iam' ? [
-            'oidc-client-ts',
-            'aws4fetch',
-            '@aws-sdk/credential-provider-cognito-identity',
-            'react-oidc-context'
-        ] : [],
-        ...auth === 'cognito' ? [
-            'react-oidc-context'
-        ] : []
-    ]), withVersions([
-        '@smithy/types'
-    ]), joinPathFragments(frontendProjectConfig.root, 'package.json'));
+    addTsDependencies(tree, DEPENDENCIES, {
+        metadata: connectionMetadata,
+        projectRoot: frontendProjectConfig.root
+    });
+    // Recorded so the version sync knows this connection's dependencies are ours.
+    addComponentGeneratorMetadata(tree, frontendProjectConfig.name, TS_AGENT_REACT_CONNECTION_GENERATOR_INFO, toProjectRelativePath(frontendProjectConfig, joinPathFragments(frontendProjectConfig.sourceRoot, 'components', clientProviderName)), agentNameClassName, connectionMetadata);
     await addGeneratorMetricsIfApplicable(tree, [
         TS_AGENT_REACT_CONNECTION_GENERATOR_INFO
     ]);

package/src/ts/agent/react-connection/generator.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../packages/nx-plugin/src/ts/agent/react-connection/generator.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport {\n  generateFiles,\n  joinPathFragments,\n  OverwriteStrategy,\n  type Tree,\n  updateJson,\n} from '@nx/devkit';\nimport { addAgentRuntimeToConnectionNamespace } from '../../../connection/agent-runtime-config';\nimport type { ResolvedConnectionOptions } from '../../../connection/generator';\nimport { addSingleImport, applyGritQL } from '../../../utils/ast';\nimport { addDependenciesToPackageJson } from '../../../utils/dependencies';\nimport { formatFilesInSubtree } from '../../../utils/format';\nimport { installDependencies } from '../../../utils/install';\nimport { addGeneratorMetricsIfApplicable } from '../../../utils/metrics';\nimport { kebabCase, toClassName } from '../../../utils/names';\nimport {\n  type ComponentMetadata,\n  getGeneratorInfo,\n  type NxGeneratorInfo,\n  readProjectConfigurationUnqualified,\n} from '../../../utils/nx';\nimport { withVersions } from '../../../utils/versions';\nimport {\n  type AgUiAuth,\n  addAgUiReactConnection,\n} from '../../react-website/agui/generator';\nimport { runtimeConfigGenerator } from '../../react-website/runtime-config/generator';\nimport { addTsAgentTargetToLocalDev } from './local-dev';\n\nexport const TS_AGENT_REACT_CONNECTION_GENERATOR_INFO: NxGeneratorInfo =\n  getGeneratorInfo(import.meta.filename);\n\nexport async function tsAgentReactConnectionGenerator(\n  tree: Tree,\n  options: ResolvedConnectionOptions,\n) {\n  const frontendProjectConfig = readProjectConfigurationUnqualified(\n    tree,\n    options.sourceProject,\n  );\n  const agentProjectConfig = readProjectConfigurationUnqualified(\n    tree,\n    options.targetProject,\n  );\n\n  const targetComponent: ComponentMetadata | undefined =\n    options.targetComponent;\n\n  // Extract agent metadata from the target component or project metadata\n  const metadata = agentProjectConfig.metadata as any;\n  const agentName = targetComponent?.name ?? 'agent';\n  const agentNameClassName = targetComponent?.rc ?? toClassName(agentName);\n  const agentPort = targetComponent?.port ?? metadata?.ports?.[0] ?? 8081;\n  const auth = (targetComponent?.auth ?? metadata?.auth ?? 'iam').toLowerCase();\n  const agentProjectAlias = agentProjectConfig.name;\n  const agentPath = targetComponent?.path ?? 'src/agent';\n\n  if ((targetComponent?.protocol ?? '').toLowerCase() === 'a2a') {\n    throw new Error(\n      `Cannot connect a React website to an A2A agent. ` +\n        `Consider generating an agent with the HTTP or AG-UI protocol instead.`,\n    );\n  }\n\n  if (targetComponent?.protocol === 'ag-ui') {\n    await addAgUiReactConnection(tree, {\n      frontendProjectConfig,\n      agentName,\n      agentNameClassName,\n      auth: auth as AgUiAuth,\n    });\n\n    await addTsAgentTargetToLocalDev(\n      tree,\n      frontendProjectConfig.name,\n      agentProjectConfig.name,\n      {\n        agentName,\n        agentNameClassName,\n        port: agentPort,\n        targetComponent,\n      },\n    );\n\n    await addGeneratorMetricsIfApplicable(tree, [\n      TS_AGENT_REACT_CONNECTION_GENERATOR_INFO,\n    ]);\n\n    await formatFilesInSubtree(tree);\n    return () =>\n      installDependencies(tree, options.preferInstallDependencies, {\n        languages: ['typescript'],\n      });\n  }\n\n  // Ensure the agent project has a wildcard path entry in tsconfig.base.json\n  // so that deep imports (e.g., for the router type) resolve correctly\n  ensureWildcardPathEntry(\n    tree,\n    agentProjectConfig.name,\n    agentProjectConfig.root,\n  );\n\n  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files'),\n    frontendProjectConfig.root,\n    {\n      agentName,\n      agentNameClassName,\n      auth,\n      agentProjectAlias,\n      agentPath,\n    },\n    {\n      overwriteStrategy: OverwriteStrategy.KeepExisting,\n    },\n  );\n\n  // Generate the tanstack query provider if it does not exist already\n  generateFiles(\n    tree,\n    joinPathFragments(\n      import.meta.dirname,\n      '../../../utils/files/website/components/tanstack-query',\n    ),\n    joinPathFragments(frontendProjectConfig.sourceRoot, 'components'),\n    {},\n    {\n      overwriteStrategy: OverwriteStrategy.KeepExisting,\n    },\n  );\n\n  if (auth === 'iam') {\n    generateFiles(\n      tree,\n      joinPathFragments(\n        import.meta.dirname,\n        '../../../utils/files/website/hooks/sigv4',\n      ),\n      joinPathFragments(frontendProjectConfig.sourceRoot, 'hooks'),\n      {},\n      {\n        overwriteStrategy: OverwriteStrategy.KeepExisting,\n      },\n    );\n  }\n\n  await runtimeConfigGenerator(tree, {\n    project: frontendProjectConfig.name,\n    preferInstallDependencies: false,\n  });\n\n  // update main.tsx\n  const mainTsxPath = joinPathFragments(\n    frontendProjectConfig.sourceRoot,\n    'main.tsx',\n  );\n  await addSingleImport(\n    tree,\n    mainTsxPath,\n    'QueryClientProvider',\n    './components/QueryClientProvider',\n  );\n\n  const clientProviderName = `${agentNameClassName}AgentClientProvider`;\n  await addSingleImport(\n    tree,\n    mainTsxPath,\n    clientProviderName,\n    `./components/${clientProviderName}`,\n  );\n\n  // Wrap <App /> in QueryClientProvider if not already present\n  await applyGritQL(\n    tree,\n    mainTsxPath,\n    '`<App />` => `<QueryClientProvider><App /></QueryClientProvider>` where { $program <: not contains `<QueryClientProvider>$_</QueryClientProvider>` }',\n  );\n\n  // Wrap <App /> in the agent client provider if not already present\n  await applyGritQL(\n    tree,\n    mainTsxPath,\n    `\\`<App />\\` => \\`<${clientProviderName}><App /></${clientProviderName}>\\` where { $program <: not contains \\`<${clientProviderName}>$_</${clientProviderName}>\\` }`,\n  );\n\n  await addTsAgentTargetToLocalDev(\n    tree,\n    frontendProjectConfig.name,\n    agentProjectConfig.name,\n    {\n      agentName,\n      agentNameClassName,\n      port: agentPort,\n      targetComponent,\n    },\n  );\n\n  // Expose the agent's runtime ARN to the frontend via the 'connection'\n  // namespace (which is published to runtime-config.json). The agent construct\n  // itself only registers to the 'agentcore' namespace by default.\n  await addAgentRuntimeToConnectionNamespace(tree, {\n    agentNameKebabCase: kebabCase(agentNameClassName),\n    agentNameClassName,\n  });\n\n  addDependenciesToPackageJson(\n    tree,\n    withVersions([\n      '@trpc/client',\n      '@tanstack/react-query',\n      '@tanstack/react-query-devtools',\n      '@trpc/tanstack-react-query',\n      ...((auth === 'iam'\n        ? [\n            'oidc-client-ts',\n            'aws4fetch',\n            '@aws-sdk/credential-provider-cognito-identity',\n            'react-oidc-context',\n          ]\n        : []) as any),\n      ...((auth === 'cognito' ? ['react-oidc-context'] : []) as any),\n    ]),\n    withVersions(['@smithy/types']),\n    joinPathFragments(frontendProjectConfig.root, 'package.json'),\n  );\n\n  await addGeneratorMetricsIfApplicable(tree, [\n    TS_AGENT_REACT_CONNECTION_GENERATOR_INFO,\n  ]);\n\n  await formatFilesInSubtree(tree);\n  return () =>\n    installDependencies(tree, options.preferInstallDependencies, {\n      languages: ['typescript'],\n    });\n}\nexport default tsAgentReactConnectionGenerator;\n\n/**\n * Ensures a wildcard path entry exists in tsconfig.base.json for the given project,\n * allowing deep imports (e.g., `@scope/project/src/agent/router.js`).\n */\nfunction ensureWildcardPathEntry(\n  tree: Tree,\n  projectName: string,\n  projectRoot: string,\n) {\n  const tsconfigPath = ['tsconfig.base.json', 'tsconfig.json'].find((p) =>\n    tree.exists(p),\n  );\n  if (!tsconfigPath) return;\n\n  updateJson(tree, tsconfigPath, (json) => {\n    const paths = json.compilerOptions?.paths ?? {};\n    const wildcardKey = `${projectName}/*`;\n    if (!paths[wildcardKey]) {\n      paths[wildcardKey] = [`./${projectRoot}/*`];\n    }\n    json.compilerOptions = {\n      ...json.compilerOptions,\n      paths,\n    };\n    return json;\n  });\n}\n"],"names":["generateFiles","joinPathFragments","OverwriteStrategy","updateJson","addAgentRuntimeToConnectionNamespace","addSingleImport","applyGritQL","addDependenciesToPackageJson","formatFilesInSubtree","installDependencies","addGeneratorMetricsIfApplicable","kebabCase","toClassName","getGeneratorInfo","readProjectConfigurationUnqualified","withVersions","addAgUiReactConnection","runtimeConfigGenerator","addTsAgentTargetToLocalDev","TS_AGENT_REACT_CONNECTION_GENERATOR_INFO","filename","tsAgentReactConnectionGenerator","tree","options","frontendProjectConfig","sourceProject","agentProjectConfig","targetProject","targetComponent","metadata","agentName","name","agentNameClassName","rc","agentPort","port","ports","auth","toLowerCase","agentProjectAlias","agentPath","path","protocol","Error","preferInstallDependencies","languages","ensureWildcardPathEntry","root","dirname","overwriteStrategy","KeepExisting","sourceRoot","project","mainTsxPath","clientProviderName","agentNameKebabCase","projectName","projectRoot","tsconfigPath","find","p","exists","json","paths","compilerOptions","wildcardKey"],"mappings":"AAAA;;;CAGC,GACD,SACEA,aAAa,EACbC,iBAAiB,EACjBC,iBAAiB,EAEjBC,UAAU,QACL,aAAa;AACpB,SAASC,oCAAoC,QAAQ,8CAA2C;AAEhG,SAASC,eAAe,EAAEC,WAAW,QAAQ,wBAAqB;AAClE,SAASC,4BAA4B,QAAQ,iCAA8B;AAC3E,SAASC,oBAAoB,QAAQ,2BAAwB;AAC7D,SAASC,mBAAmB,QAAQ,4BAAyB;AAC7D,SAASC,+BAA+B,QAAQ,4BAAyB;AACzE,SAASC,SAAS,EAAEC,WAAW,QAAQ,0BAAuB;AAC9D,SAEEC,gBAAgB,EAEhBC,mCAAmC,QAC9B,uBAAoB;AAC3B,SAASC,YAAY,QAAQ,6BAA0B;AACvD,SAEEC,sBAAsB,QACjB,wCAAqC;AAC5C,SAASC,sBAAsB,QAAQ,kDAA+C;AACtF,SAASC,0BAA0B,QAAQ,iBAAc;AAEzD,OAAO,MAAMC,2CACXN,iBAAiB,YAAYO,QAAQ,EAAE;AAEzC,OAAO,eAAeC,gCACpBC,IAAU,EACVC,OAAkC;IAElC,MAAMC,wBAAwBV,oCAC5BQ,MACAC,QAAQE,aAAa;IAEvB,MAAMC,qBAAqBZ,oCACzBQ,MACAC,QAAQI,aAAa;IAGvB,MAAMC,kBACJL,QAAQK,eAAe;IAEzB,uEAAuE;IACvE,MAAMC,WAAWH,mBAAmBG,QAAQ;IAC5C,MAAMC,YAAYF,iBAAiBG,QAAQ;IAC3C,MAAMC,qBAAqBJ,iBAAiBK,MAAMrB,YAAYkB;IAC9D,MAAMI,YAAYN,iBAAiBO,QAAQN,UAAUO,OAAO,CAAC,EAAE,IAAI;IACnE,MAAMC,OAAO,AAACT,CAAAA,iBAAiBS,QAAQR,UAAUQ,QAAQ,KAAI,EAAGC,WAAW;IAC3E,MAAMC,oBAAoBb,mBAAmBK,IAAI;IACjD,MAAMS,YAAYZ,iBAAiBa,QAAQ;IAE3C,IAAI,AAACb,CAAAA,iBAAiBc,YAAY,EAAC,EAAGJ,WAAW,OAAO,OAAO;QAC7D,MAAM,IAAIK,MACR,CAAC,gDAAgD,CAAC,GAChD,CAAC,qEAAqE,CAAC;IAE7E;IAEA,IAAIf,iBAAiBc,aAAa,SAAS;QACzC,MAAM1B,uBAAuBM,MAAM;YACjCE;YACAM;YACAE;YACAK,MAAMA;QACR;QAEA,MAAMnB,2BACJI,MACAE,sBAAsBO,IAAI,EAC1BL,mBAAmBK,IAAI,EACvB;YACED;YACAE;YACAG,MAAMD;YACNN;QACF;QAGF,MAAMlB,gCAAgCY,MAAM;YAC1CH;SACD;QAED,MAAMX,qBAAqBc;QAC3B,OAAO,IACLb,oBAAoBa,MAAMC,QAAQqB,yBAAyB,EAAE;gBAC3DC,WAAW;oBAAC;iBAAa;YAC3B;IACJ;IAEA,2EAA2E;IAC3E,qEAAqE;IACrEC,wBACExB,MACAI,mBAAmBK,IAAI,EACvBL,mBAAmBqB,IAAI;IAGzB/C,cACEsB,MACArB,kBAAkB,YAAY+C,OAAO,EAAE,UACvCxB,sBAAsBuB,IAAI,EAC1B;QACEjB;QACAE;QACAK;QACAE;QACAC;IACF,GACA;QACES,mBAAmB/C,kBAAkBgD,YAAY;IACnD;IAGF,oEAAoE;IACpElD,cACEsB,MACArB,kBACE,YAAY+C,OAAO,EACnB,2DAEF/C,kBAAkBuB,sBAAsB2B,UAAU,EAAE,eACpD,CAAC,GACD;QACEF,mBAAmB/C,kBAAkBgD,YAAY;IACnD;IAGF,IAAIb,SAAS,OAAO;QAClBrC,cACEsB,MACArB,kBACE,YAAY+C,OAAO,EACnB,6CAEF/C,kBAAkBuB,sBAAsB2B,UAAU,EAAE,UACpD,CAAC,GACD;YACEF,mBAAmB/C,kBAAkBgD,YAAY;QACnD;IAEJ;IAEA,MAAMjC,uBAAuBK,MAAM;QACjC8B,SAAS5B,sBAAsBO,IAAI;QACnCa,2BAA2B;IAC7B;IAEA,kBAAkB;IAClB,MAAMS,cAAcpD,kBAClBuB,sBAAsB2B,UAAU,EAChC;IAEF,MAAM9C,gBACJiB,MACA+B,aACA,uBACA;IAGF,MAAMC,qBAAqB,GAAGtB,mBAAmB,mBAAmB,CAAC;IACrE,MAAM3B,gBACJiB,MACA+B,aACAC,oBACA,CAAC,aAAa,EAAEA,oBAAoB;IAGtC,6DAA6D;IAC7D,MAAMhD,YACJgB,MACA+B,aACA;IAGF,mEAAmE;IACnE,MAAM/C,YACJgB,MACA+B,aACA,CAAC,kBAAkB,EAAEC,mBAAmB,UAAU,EAAEA,mBAAmB,wCAAwC,EAAEA,mBAAmB,KAAK,EAAEA,mBAAmB,KAAK,CAAC;IAGtK,MAAMpC,2BACJI,MACAE,sBAAsBO,IAAI,EAC1BL,mBAAmBK,IAAI,EACvB;QACED;QACAE;QACAG,MAAMD;QACNN;IACF;IAGF,sEAAsE;IACtE,6EAA6E;IAC7E,iEAAiE;IACjE,MAAMxB,qCAAqCkB,MAAM;QAC/CiC,oBAAoB5C,UAAUqB;QAC9BA;IACF;IAEAzB,6BACEe,MACAP,aAAa;QACX;QACA;QACA;QACA;WACKsB,SAAS,QACV;YACE;YACA;YACA;YACA;SACD,GACD,EAAE;WACDA,SAAS,YAAY;YAAC;SAAqB,GAAG,EAAE;KACtD,GACDtB,aAAa;QAAC;KAAgB,GAC9Bd,kBAAkBuB,sBAAsBuB,IAAI,EAAE;IAGhD,MAAMrC,gCAAgCY,MAAM;QAC1CH;KACD;IAED,MAAMX,qBAAqBc;IAC3B,OAAO,IACLb,oBAAoBa,MAAMC,QAAQqB,yBAAyB,EAAE;YAC3DC,WAAW;gBAAC;aAAa;QAC3B;AACJ;AACA,eAAexB,gCAAgC;AAE/C;;;CAGC,GACD,SAASyB,wBACPxB,IAAU,EACVkC,WAAmB,EACnBC,WAAmB;IAEnB,MAAMC,eAAe;QAAC;QAAsB;KAAgB,CAACC,IAAI,CAAC,CAACC,IACjEtC,KAAKuC,MAAM,CAACD;IAEd,IAAI,CAACF,cAAc;IAEnBvD,WAAWmB,MAAMoC,cAAc,CAACI;QAC9B,MAAMC,QAAQD,KAAKE,eAAe,EAAED,SAAS,CAAC;QAC9C,MAAME,cAAc,GAAGT,YAAY,EAAE,CAAC;QACtC,IAAI,CAACO,KAAK,CAACE,YAAY,EAAE;YACvBF,KAAK,CAACE,YAAY,GAAG;gBAAC,CAAC,EAAE,EAAER,YAAY,EAAE,CAAC;aAAC;QAC7C;QACAK,KAAKE,eAAe,GAAG;YACrB,GAAGF,KAAKE,eAAe;YACvBD;QACF;QACA,OAAOD;IACT;AACF"}
+{"version":3,"sources":["../../../../../../../packages/nx-plugin/src/ts/agent/react-connection/generator.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport {\n  generateFiles,\n  joinPathFragments,\n  OverwriteStrategy,\n  type Tree,\n  updateJson,\n} from '@nx/devkit';\nimport { addAgentRuntimeToConnectionNamespace } from '../../../connection/agent-runtime-config';\nimport type { ResolvedConnectionOptions } from '../../../connection/generator';\nimport { addTsDependencies } from '../../../utils/add-dependencies';\nimport { addSingleImport, applyGritQL } from '../../../utils/ast';\nimport {\n  declareDependencies,\n  onlyWhen,\n  ownedElsewhere,\n} from '../../../utils/declared-dependencies';\nimport { formatFilesInSubtree } from '../../../utils/format';\nimport { installDependencies } from '../../../utils/install';\nimport { addGeneratorMetricsIfApplicable } from '../../../utils/metrics';\nimport { kebabCase, toClassName } from '../../../utils/names';\nimport {\n  addComponentGeneratorMetadata,\n  type ComponentMetadata,\n  getGeneratorInfo,\n  type NxGeneratorInfo,\n  readProjectConfigurationUnqualified,\n} from '../../../utils/nx';\nimport { toProjectRelativePath } from '../../../utils/paths';\nimport {\n  DEPENDENCIES as AGUI_DEPENDENCIES,\n  type AgUiAuth,\n  addAgUiReactConnection,\n  resolveAgUiTheme,\n} from '../../react-website/agui/generator';\nimport { runtimeConfigGenerator } from '../../react-website/runtime-config/generator';\nimport { addTsAgentTargetToLocalDev } from './local-dev';\n\n/** The metadata this generator records, which its predicates read. */\nexport interface TsAgentReactConnectionMetadata {\n  readonly auth: string;\n  readonly protocol: string;\n  /** The AG-UI theme module, which the website's `ux` selects. */\n  readonly theme: string;\n}\n\n/** The tRPC-over-HTTP path, which the AG-UI path takes none of. */\nconst isHttp = (m: TsAgentReactConnectionMetadata) => m.protocol !== 'ag-ui';\n\n/** The AG-UI path, whose packages `addAgUiReactConnection` adds. */\nconst isAgUi = (m: TsAgentReactConnectionMetadata) => !isHttp(m);\n\n// Each entry names the protocol path it belongs to: the HTTP path's client and\n// auth packages are added here, the AG-UI path's by `addAgUiReactConnection` on\n// this generator's behalf.\nexport const DEPENDENCIES =\n  declareDependencies<TsAgentReactConnectionMetadata>()({\n    ts: [\n      { name: '@trpc/client', when: isHttp },\n      { name: '@tanstack/react-query', when: isHttp },\n      { name: '@tanstack/react-query-devtools', when: isHttp },\n      { name: '@trpc/tanstack-react-query', when: isHttp },\n      { name: 'oidc-client-ts', when: (m) => isHttp(m) && m.auth === 'iam' },\n      { name: 'aws4fetch', when: (m) => isHttp(m) && m.auth === 'iam' },\n      {\n        name: '@aws-sdk/credential-provider-cognito-identity',\n        when: (m) => isHttp(m) && m.auth === 'iam',\n      },\n      {\n        name: 'react-oidc-context',\n        when: (m) => isHttp(m) && (m.auth === 'iam' || m.auth === 'cognito'),\n      },\n      { name: '@smithy/types', when: isHttp, dev: true },\n      // `addAgUiReactConnection` adds these itself, so they are declared for\n      // ownership only. Gated on the AG-UI path, and within it on each entry's\n      // own theme or auth condition, which the metadata below records.\n      ...ownedElsewhere(onlyWhen(AGUI_DEPENDENCIES.ts, isAgUi)),\n    ],\n  });\n\nexport const TS_AGENT_REACT_CONNECTION_GENERATOR_INFO: NxGeneratorInfo =\n  getGeneratorInfo(import.meta.filename);\n\nexport async function tsAgentReactConnectionGenerator(\n  tree: Tree,\n  options: ResolvedConnectionOptions,\n) {\n  const frontendProjectConfig = readProjectConfigurationUnqualified(\n    tree,\n    options.sourceProject,\n  );\n  const agentProjectConfig = readProjectConfigurationUnqualified(\n    tree,\n    options.targetProject,\n  );\n\n  const targetComponent: ComponentMetadata | undefined =\n    options.targetComponent;\n\n  // Extract agent metadata from the target component or project metadata\n  const metadata = agentProjectConfig.metadata as any;\n  const agentName = targetComponent?.name ?? 'agent';\n  const agentNameClassName = targetComponent?.rc ?? toClassName(agentName);\n  const agentPort = targetComponent?.port ?? metadata?.ports?.[0] ?? 8081;\n  const auth = (targetComponent?.auth ?? metadata?.auth ?? 'iam').toLowerCase();\n  const agentProjectAlias = agentProjectConfig.name;\n  const agentPath = targetComponent?.path ?? 'src/agent';\n\n  // Recorded below and read by the declaration's predicates, so the packages\n  // added here are exactly the ones the version sync will own.\n  const connectionMetadata: TsAgentReactConnectionMetadata = {\n    auth,\n    protocol: targetComponent?.protocol ?? 'http',\n    theme: resolveAgUiTheme(frontendProjectConfig),\n  };\n\n  if ((targetComponent?.protocol ?? '').toLowerCase() === 'a2a') {\n    throw new Error(\n      `Cannot connect a React website to an A2A agent. ` +\n        `Consider generating an agent with the HTTP or AG-UI protocol instead.`,\n    );\n  }\n\n  if (targetComponent?.protocol === 'ag-ui') {\n    await addAgUiReactConnection(tree, {\n      frontendProjectConfig,\n      agentName,\n      agentNameClassName,\n      auth: auth as AgUiAuth,\n    });\n\n    await addTsAgentTargetToLocalDev(\n      tree,\n      frontendProjectConfig.name,\n      agentProjectConfig.name,\n      {\n        agentName,\n        agentNameClassName,\n        port: agentPort,\n        targetComponent,\n      },\n    );\n\n    // Recorded so the version sync knows this connection's dependencies are ours.\n    addComponentGeneratorMetadata(\n      tree,\n      frontendProjectConfig.name,\n      TS_AGENT_REACT_CONNECTION_GENERATOR_INFO,\n      toProjectRelativePath(\n        frontendProjectConfig,\n        joinPathFragments(\n          frontendProjectConfig.sourceRoot,\n          'hooks',\n          `useAgui${agentNameClassName}`,\n        ),\n      ),\n      agentNameClassName,\n      connectionMetadata,\n    );\n\n    await addGeneratorMetricsIfApplicable(tree, [\n      TS_AGENT_REACT_CONNECTION_GENERATOR_INFO,\n    ]);\n\n    await formatFilesInSubtree(tree);\n    return () =>\n      installDependencies(tree, options.preferInstallDependencies, {\n        languages: ['typescript'],\n      });\n  }\n\n  // Ensure the agent project has a wildcard path entry in tsconfig.base.json\n  // so that deep imports (e.g., for the router type) resolve correctly\n  ensureWildcardPathEntry(\n    tree,\n    agentProjectConfig.name,\n    agentProjectConfig.root,\n  );\n\n  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files'),\n    frontendProjectConfig.root,\n    {\n      agentName,\n      agentNameClassName,\n      auth,\n      agentProjectAlias,\n      agentPath,\n    },\n    {\n      overwriteStrategy: OverwriteStrategy.KeepExisting,\n    },\n  );\n\n  // Generate the tanstack query provider if it does not exist already\n  generateFiles(\n    tree,\n    joinPathFragments(\n      import.meta.dirname,\n      '../../../utils/files/website/components/tanstack-query',\n    ),\n    joinPathFragments(frontendProjectConfig.sourceRoot, 'components'),\n    {},\n    {\n      overwriteStrategy: OverwriteStrategy.KeepExisting,\n    },\n  );\n\n  if (auth === 'iam') {\n    generateFiles(\n      tree,\n      joinPathFragments(\n        import.meta.dirname,\n        '../../../utils/files/website/hooks/sigv4',\n      ),\n      joinPathFragments(frontendProjectConfig.sourceRoot, 'hooks'),\n      {},\n      {\n        overwriteStrategy: OverwriteStrategy.KeepExisting,\n      },\n    );\n  }\n\n  await runtimeConfigGenerator(tree, {\n    project: frontendProjectConfig.name,\n    preferInstallDependencies: false,\n  });\n\n  // update main.tsx\n  const mainTsxPath = joinPathFragments(\n    frontendProjectConfig.sourceRoot,\n    'main.tsx',\n  );\n  await addSingleImport(\n    tree,\n    mainTsxPath,\n    'QueryClientProvider',\n    './components/QueryClientProvider',\n  );\n\n  const clientProviderName = `${agentNameClassName}AgentClientProvider`;\n  await addSingleImport(\n    tree,\n    mainTsxPath,\n    clientProviderName,\n    `./components/${clientProviderName}`,\n  );\n\n  // Wrap <App /> in QueryClientProvider if not already present\n  await applyGritQL(\n    tree,\n    mainTsxPath,\n    '`<App />` => `<QueryClientProvider><App /></QueryClientProvider>` where { $program <: not contains `<QueryClientProvider>$_</QueryClientProvider>` }',\n  );\n\n  // Wrap <App /> in the agent client provider if not already present\n  await applyGritQL(\n    tree,\n    mainTsxPath,\n    `\\`<App />\\` => \\`<${clientProviderName}><App /></${clientProviderName}>\\` where { $program <: not contains \\`<${clientProviderName}>$_</${clientProviderName}>\\` }`,\n  );\n\n  await addTsAgentTargetToLocalDev(\n    tree,\n    frontendProjectConfig.name,\n    agentProjectConfig.name,\n    {\n      agentName,\n      agentNameClassName,\n      port: agentPort,\n      targetComponent,\n    },\n  );\n\n  // Expose the agent's runtime ARN to the frontend via the 'connection'\n  // namespace (which is published to runtime-config.json). The agent construct\n  // itself only registers to the 'agentcore' namespace by default.\n  await addAgentRuntimeToConnectionNamespace(tree, {\n    agentNameKebabCase: kebabCase(agentNameClassName),\n    agentNameClassName,\n  });\n\n  addTsDependencies(tree, DEPENDENCIES, {\n    metadata: connectionMetadata,\n    projectRoot: frontendProjectConfig.root,\n  });\n\n  // Recorded so the version sync knows this connection's dependencies are ours.\n  addComponentGeneratorMetadata(\n    tree,\n    frontendProjectConfig.name,\n    TS_AGENT_REACT_CONNECTION_GENERATOR_INFO,\n    toProjectRelativePath(\n      frontendProjectConfig,\n      joinPathFragments(\n        frontendProjectConfig.sourceRoot,\n        'components',\n        clientProviderName,\n      ),\n    ),\n    agentNameClassName,\n    connectionMetadata,\n  );\n\n  await addGeneratorMetricsIfApplicable(tree, [\n    TS_AGENT_REACT_CONNECTION_GENERATOR_INFO,\n  ]);\n\n  await formatFilesInSubtree(tree);\n  return () =>\n    installDependencies(tree, options.preferInstallDependencies, {\n      languages: ['typescript'],\n    });\n}\nexport default tsAgentReactConnectionGenerator;\n\n/**\n * Ensures a wildcard path entry exists in tsconfig.base.json for the given project,\n * allowing deep imports (e.g., `@scope/project/src/agent/router.js`).\n */\nfunction ensureWildcardPathEntry(\n  tree: Tree,\n  projectName: string,\n  projectRoot: string,\n) {\n  const tsconfigPath = ['tsconfig.base.json', 'tsconfig.json'].find((p) =>\n    tree.exists(p),\n  );\n  if (!tsconfigPath) return;\n\n  updateJson(tree, tsconfigPath, (json) => {\n    const paths = json.compilerOptions?.paths ?? {};\n    const wildcardKey = `${projectName}/*`;\n    if (!paths[wildcardKey]) {\n      paths[wildcardKey] = [`./${projectRoot}/*`];\n    }\n    json.compilerOptions = {\n      ...json.compilerOptions,\n      paths,\n    };\n    return json;\n  });\n}\n"],"names":["generateFiles","joinPathFragments","OverwriteStrategy","updateJson","addAgentRuntimeToConnectionNamespace","addTsDependencies","addSingleImport","applyGritQL","declareDependencies","onlyWhen","ownedElsewhere","formatFilesInSubtree","installDependencies","addGeneratorMetricsIfApplicable","kebabCase","toClassName","addComponentGeneratorMetadata","getGeneratorInfo","readProjectConfigurationUnqualified","toProjectRelativePath","DEPENDENCIES","AGUI_DEPENDENCIES","addAgUiReactConnection","resolveAgUiTheme","runtimeConfigGenerator","addTsAgentTargetToLocalDev","isHttp","m","protocol","isAgUi","ts","name","when","auth","dev","TS_AGENT_REACT_CONNECTION_GENERATOR_INFO","filename","tsAgentReactConnectionGenerator","tree","options","frontendProjectConfig","sourceProject","agentProjectConfig","targetProject","targetComponent","metadata","agentName","agentNameClassName","rc","agentPort","port","ports","toLowerCase","agentProjectAlias","agentPath","path","connectionMetadata","theme","Error","sourceRoot","preferInstallDependencies","languages","ensureWildcardPathEntry","root","dirname","overwriteStrategy","KeepExisting","project","mainTsxPath","clientProviderName","agentNameKebabCase","projectRoot","projectName","tsconfigPath","find","p","exists","json","paths","compilerOptions","wildcardKey"],"mappings":"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"}

package/src/ts/astro-docs/generator.d.ts

@@ -5,6 +5,44 @@
 import { type GeneratorCallback, type Tree } from '@nx/devkit';
 import { type NxGeneratorInfo } from '../../utils/nx';
 import type { TsAstroDocsGeneratorSchema } from './schema';
+/** The metadata this generator records, which its predicates read. */
+export interface TsAstroDocsMetadata {
+    readonly framework: string;
+    readonly includeTranslation: boolean;
+    readonly includeBlog: boolean;
+}
+export declare const DEPENDENCIES: import("../../utils/declared-dependencies").DependencyDeclaration<readonly [{
+    readonly name: "astro";
+}, {
+    readonly name: "@astrojs/starlight";
+}, {
+    readonly name: "starlight-blog";
+    readonly when: (m: TsAstroDocsMetadata) => boolean;
+}, {
+    readonly name: "@strands-agents/sdk";
+    readonly when: (m: TsAstroDocsMetadata) => boolean;
+}, {
+    readonly name: "commander";
+    readonly when: (m: TsAstroDocsMetadata) => boolean;
+}, {
+    readonly name: "fast-glob";
+    readonly when: (m: TsAstroDocsMetadata) => boolean;
+}, {
+    readonly name: "fs-extra";
+    readonly when: (m: TsAstroDocsMetadata) => boolean;
+}, {
+    readonly name: "simple-git";
+    readonly when: (m: TsAstroDocsMetadata) => boolean;
+}, {
+    readonly name: "@types/fs-extra";
+    readonly when: (m: TsAstroDocsMetadata) => boolean;
+    readonly dev: true;
+}, {
+    readonly name: "tsx";
+    readonly when: (m: TsAstroDocsMetadata) => boolean;
+    readonly dev: true;
+    readonly root: true;
+}], readonly import("../../utils/declared-dependencies").DeclaredPyDependency<"a2a-sdk" | "ag-ui-langgraph" | "ag-ui-protocol" | "ag-ui-strands" | "aws-lambda-powertools" | "aws-lambda-powertools[tracer]" | "aws-lambda-powertools[parser]" | "aws-opentelemetry-distro" | "bedrock-agentcore" | "boto3" | "checkov" | "fastapi" | "fastapi[standard]" | "httpx" | "langchain" | "langchain-aws" | "langchain-mcp-adapters" | "langgraph" | "mcp" | "pip-check-updates" | "pip-licenses" | "ruff" | "strands-agents" | "strands-agents[a2a]" | "strands-agents-tools" | "ty" | "pynamodb" | "uvicorn" | "sqlmodel" | "alembic" | "aiomysql" | "asyncpg" | "greenlet", TsAstroDocsMetadata>[]>;
 export declare const TS_ASTRO_DOCS_GENERATOR_INFO: NxGeneratorInfo;
 export declare const tsAstroDocsGenerator: (tree: Tree, schema: TsAstroDocsGeneratorSchema) => Promise<GeneratorCallback>;
 export default tsAstroDocsGenerator;

package/src/ts/astro-docs/generator.js

@@ -2,7 +2,8 @@
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
  */ import { addProjectConfiguration, generateFiles, joinPathFragments, OverwriteStrategy } from "@nx/devkit";
-import { addDependenciesToPackageJson } from "../../utils/dependencies.js";
+import { addTsDependencies } from "../../utils/add-dependencies.js";
+import { declareDependencies } from "../../utils/declared-dependencies.js";
 import { formatFilesInSubtree } from "../../utils/format.js";
 import { installDependencies } from "../../utils/install.js";
 import { addGeneratorMetricsIfApplicable } from "../../utils/metrics.js";
@@ -12,7 +13,54 @@ import { getNpmScopePrefix } from "../../utils/npm-scope.js";
 import { addGeneratorMetadata, getGeneratorInfo, projectExists } from "../../utils/nx.js";
 import { getPackageManagerDisplayCommands } from "../../utils/pkg-manager.js";
 import { ensureProjectPackageJson } from "../../utils/project-package-json.js";
-import { withVersions } from "../../utils/versions.js";
+// Each entry names the branch it belongs to, so the same declaration drives both
+// adding and the version sync.
+export const DEPENDENCIES = declareDependencies()({
+    ts: [
+        {
+            name: 'astro'
+        },
+        {
+            name: '@astrojs/starlight'
+        },
+        {
+            name: 'starlight-blog',
+            when: (m)=>m.includeBlog
+        },
+        {
+            name: '@strands-agents/sdk',
+            when: (m)=>m.includeTranslation
+        },
+        {
+            name: 'commander',
+            when: (m)=>m.includeTranslation
+        },
+        {
+            name: 'fast-glob',
+            when: (m)=>m.includeTranslation
+        },
+        {
+            name: 'fs-extra',
+            when: (m)=>m.includeTranslation
+        },
+        {
+            name: 'simple-git',
+            when: (m)=>m.includeTranslation
+        },
+        {
+            name: '@types/fs-extra',
+            when: (m)=>m.includeTranslation,
+            dev: true
+        },
+        // The translate target runs its script from the workspace root via tsx.
+        {
+            name: 'tsx',
+            when: (m)=>m.includeTranslation,
+            dev: true,
+            root: true
+        }
+    ]
+});
 export const TS_ASTRO_DOCS_GENERATOR_INFO = getGeneratorInfo(import.meta.filename);
 export const tsAstroDocsGenerator = async (tree, schema)=>{
     const includeTranslation = !(schema.noTranslation ?? false);
@@ -104,27 +152,18 @@ export const tsAstroDocsGenerator = async (tree, schema)=>{
             overwriteStrategy: OverwriteStrategy.KeepExisting
         });
     }
-    addGeneratorMetadata(tree, fullyQualifiedName, TS_ASTRO_DOCS_GENERATOR_INFO, {
+    // Recorded here and read by the declaration's predicates, so the packages
+    // added below are exactly the ones the version sync will own.
+    const metadata = {
         framework: 'astro',
         includeTranslation,
         includeBlog
+    };
+    addGeneratorMetadata(tree, fullyQualifiedName, TS_ASTRO_DOCS_GENERATOR_INFO, metadata);
+    addTsDependencies(tree, DEPENDENCIES, {
+        metadata,
+        projectRoot: dir
     });
-    const dependencies = [
-        'astro',
-        '@astrojs/starlight'
-    ];
-    const devDependencies = [];
-    if (includeBlog) {
-        dependencies.push('starlight-blog');
-    }
-    if (includeTranslation) {
-        dependencies.push('@strands-agents/sdk', 'commander', 'fast-glob', 'fs-extra', 'simple-git');
-        devDependencies.push('@types/fs-extra');
-        addDependenciesToPackageJson(tree, {}, withVersions([
-            'tsx'
-        ]));
-    }
-    addDependenciesToPackageJson(tree, withVersions(dependencies), withVersions(devDependencies), joinPathFragments(dir, 'package.json'));
     await addGeneratorMetricsIfApplicable(tree, [
         TS_ASTRO_DOCS_GENERATOR_INFO
     ]);

package/src/ts/astro-docs/generator.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../packages/nx-plugin/src/ts/astro-docs/generator.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport {\n  addProjectConfiguration,\n  type GeneratorCallback,\n  generateFiles,\n  joinPathFragments,\n  OverwriteStrategy,\n  type ProjectConfiguration,\n  type Tree,\n} from '@nx/devkit';\nimport { addDependenciesToPackageJson } from '../../utils/dependencies';\nimport { formatFilesInSubtree } from '../../utils/format';\nimport { installDependencies } from '../../utils/install';\nimport { addGeneratorMetricsIfApplicable } from '../../utils/metrics';\nimport { isEsmWorkspace } from '../../utils/module-format';\nimport { toKebabCase } from '../../utils/names';\nimport { getNpmScopePrefix } from '../../utils/npm-scope';\nimport {\n  addGeneratorMetadata,\n  getGeneratorInfo,\n  type NxGeneratorInfo,\n  projectExists,\n} from '../../utils/nx';\nimport { getPackageManagerDisplayCommands } from '../../utils/pkg-manager';\nimport { ensureProjectPackageJson } from '../../utils/project-package-json';\nimport { type ITsDepVersion, withVersions } from '../../utils/versions';\nimport type { TsAstroDocsGeneratorSchema } from './schema';\n\nexport const TS_ASTRO_DOCS_GENERATOR_INFO: NxGeneratorInfo = getGeneratorInfo(\n  import.meta.filename,\n);\n\nexport const tsAstroDocsGenerator = async (\n  tree: Tree,\n  schema: TsAstroDocsGeneratorSchema,\n): Promise<GeneratorCallback> => {\n  const includeTranslation = !(schema.noTranslation ?? false);\n  const includeBlog = !(schema.noBlog ?? false);\n  const npmScopePrefix = getNpmScopePrefix(tree);\n  const docsNameKebabCase = toKebabCase(schema.name);\n  const fullyQualifiedName = `${npmScopePrefix}${docsNameKebabCase}`;\n  // NB: interactive nx generator cli can pass empty string\n  const dir = joinPathFragments(\n    schema.directory || '.',\n    schema.subDirectory || docsNameKebabCase,\n  );\n\n  const alreadyExists = projectExists(tree, fullyQualifiedName);\n\n  const targets: ProjectConfiguration['targets'] = {\n    build: {\n      executor: 'nx:run-commands',\n      options: {\n        command: 'astro build',\n        cwd: dir,\n      },\n      outputs: [`{workspaceRoot}/${dir}/dist`],\n      cache: true,\n    },\n    start: {\n      executor: 'nx:run-commands',\n      options: {\n        command: 'astro dev',\n        cwd: dir,\n      },\n      continuous: true,\n    },\n    serve: {\n      dependsOn: ['start'],\n    },\n    preview: {\n      executor: 'nx:run-commands',\n      options: {\n        command: 'astro preview',\n        cwd: dir,\n      },\n      dependsOn: ['build'],\n      continuous: true,\n    },\n  };\n\n  if (includeTranslation) {\n    targets['translate'] = {\n      executor: 'nx:run-commands',\n      options: {\n        command: 'tsx ./scripts/translate.ts',\n        cwd: dir,\n        forwardAllArgs: true,\n      },\n    };\n  }\n\n  if (!alreadyExists) {\n    addProjectConfiguration(tree, fullyQualifiedName, {\n      name: fullyQualifiedName,\n      root: dir,\n      sourceRoot: joinPathFragments(dir, 'src'),\n      projectType: 'application',\n      targets,\n    });\n  }\n\n  ensureProjectPackageJson(tree, { dir, fullyQualifiedName });\n\n  const templateOptions = {\n    fullyQualifiedName,\n    title: schema.name,\n    includeTranslation,\n    includeBlog,\n    esm: isEsmWorkspace(tree),\n    pkgMgrCmd: getPackageManagerDisplayCommands().exec,\n    today: new Date().toISOString().slice(0, 10),\n  };\n\n  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files', 'base'),\n    dir,\n    templateOptions,\n    { overwriteStrategy: OverwriteStrategy.KeepExisting },\n  );\n\n  // The sample blog post is always emitted above — drop it if the user opted out.\n  if (!includeBlog) {\n    tree.delete(\n      joinPathFragments(\n        dir,\n        'src',\n        'content',\n        'docs',\n        'en',\n        'blog',\n        'welcome.mdx',\n      ),\n    );\n  }\n\n  if (includeTranslation) {\n    generateFiles(\n      tree,\n      joinPathFragments(import.meta.dirname, 'files', 'translation'),\n      dir,\n      templateOptions,\n      { overwriteStrategy: OverwriteStrategy.KeepExisting },\n    );\n  }\n\n  addGeneratorMetadata(tree, fullyQualifiedName, TS_ASTRO_DOCS_GENERATOR_INFO, {\n    framework: 'astro',\n    includeTranslation,\n    includeBlog,\n  });\n\n  const dependencies: ITsDepVersion[] = ['astro', '@astrojs/starlight'];\n  const devDependencies: ITsDepVersion[] = [];\n\n  if (includeBlog) {\n    dependencies.push('starlight-blog');\n  }\n\n  if (includeTranslation) {\n    dependencies.push(\n      '@strands-agents/sdk',\n      'commander',\n      'fast-glob',\n      'fs-extra',\n      'simple-git',\n    );\n    devDependencies.push('@types/fs-extra');\n    addDependenciesToPackageJson(tree, {}, withVersions(['tsx']));\n  }\n\n  addDependenciesToPackageJson(\n    tree,\n    withVersions(dependencies),\n    withVersions(devDependencies),\n    joinPathFragments(dir, 'package.json'),\n  );\n\n  await addGeneratorMetricsIfApplicable(tree, [TS_ASTRO_DOCS_GENERATOR_INFO]);\n\n  await formatFilesInSubtree(tree);\n  return () =>\n    installDependencies(tree, schema.preferInstallDependencies, {\n      languages: ['typescript'],\n    });\n};\n\nexport default tsAstroDocsGenerator;\n"],"names":["addProjectConfiguration","generateFiles","joinPathFragments","OverwriteStrategy","addDependenciesToPackageJson","formatFilesInSubtree","installDependencies","addGeneratorMetricsIfApplicable","isEsmWorkspace","toKebabCase","getNpmScopePrefix","addGeneratorMetadata","getGeneratorInfo","projectExists","getPackageManagerDisplayCommands","ensureProjectPackageJson","withVersions","TS_ASTRO_DOCS_GENERATOR_INFO","filename","tsAstroDocsGenerator","tree","schema","includeTranslation","noTranslation","includeBlog","noBlog","npmScopePrefix","docsNameKebabCase","name","fullyQualifiedName","dir","directory","subDirectory","alreadyExists","targets","build","executor","options","command","cwd","outputs","cache","start","continuous","serve","dependsOn","preview","forwardAllArgs","root","sourceRoot","projectType","templateOptions","title","esm","pkgMgrCmd","exec","today","Date","toISOString","slice","dirname","overwriteStrategy","KeepExisting","delete","framework","dependencies","devDependencies","push","preferInstallDependencies","languages"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/ts/astro-docs/generator.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport {\n  addProjectConfiguration,\n  type GeneratorCallback,\n  generateFiles,\n  joinPathFragments,\n  OverwriteStrategy,\n  type ProjectConfiguration,\n  type Tree,\n} from '@nx/devkit';\nimport { addTsDependencies } from '../../utils/add-dependencies';\nimport { declareDependencies } from '../../utils/declared-dependencies';\nimport { formatFilesInSubtree } from '../../utils/format';\nimport { installDependencies } from '../../utils/install';\nimport { addGeneratorMetricsIfApplicable } from '../../utils/metrics';\nimport { isEsmWorkspace } from '../../utils/module-format';\nimport { toKebabCase } from '../../utils/names';\nimport { getNpmScopePrefix } from '../../utils/npm-scope';\nimport {\n  addGeneratorMetadata,\n  getGeneratorInfo,\n  type NxGeneratorInfo,\n  projectExists,\n} from '../../utils/nx';\nimport { getPackageManagerDisplayCommands } from '../../utils/pkg-manager';\nimport { ensureProjectPackageJson } from '../../utils/project-package-json';\nimport type { TsAstroDocsGeneratorSchema } from './schema';\n\n/** The metadata this generator records, which its predicates read. */\nexport interface TsAstroDocsMetadata {\n  readonly framework: string;\n  readonly includeTranslation: boolean;\n  readonly includeBlog: boolean;\n}\n\n// Each entry names the branch it belongs to, so the same declaration drives both\n// adding and the version sync.\nexport const DEPENDENCIES = declareDependencies<TsAstroDocsMetadata>()({\n  ts: [\n    { name: 'astro' },\n    { name: '@astrojs/starlight' },\n    { name: 'starlight-blog', when: (m) => m.includeBlog },\n    { name: '@strands-agents/sdk', when: (m) => m.includeTranslation },\n    { name: 'commander', when: (m) => m.includeTranslation },\n    { name: 'fast-glob', when: (m) => m.includeTranslation },\n    { name: 'fs-extra', when: (m) => m.includeTranslation },\n    { name: 'simple-git', when: (m) => m.includeTranslation },\n    { name: '@types/fs-extra', when: (m) => m.includeTranslation, dev: true },\n    // The translate target runs its script from the workspace root via tsx.\n    { name: 'tsx', when: (m) => m.includeTranslation, dev: true, root: true },\n  ],\n});\n\nexport const TS_ASTRO_DOCS_GENERATOR_INFO: NxGeneratorInfo = getGeneratorInfo(\n  import.meta.filename,\n);\n\nexport const tsAstroDocsGenerator = async (\n  tree: Tree,\n  schema: TsAstroDocsGeneratorSchema,\n): Promise<GeneratorCallback> => {\n  const includeTranslation = !(schema.noTranslation ?? false);\n  const includeBlog = !(schema.noBlog ?? false);\n  const npmScopePrefix = getNpmScopePrefix(tree);\n  const docsNameKebabCase = toKebabCase(schema.name);\n  const fullyQualifiedName = `${npmScopePrefix}${docsNameKebabCase}`;\n  // NB: interactive nx generator cli can pass empty string\n  const dir = joinPathFragments(\n    schema.directory || '.',\n    schema.subDirectory || docsNameKebabCase,\n  );\n\n  const alreadyExists = projectExists(tree, fullyQualifiedName);\n\n  const targets: ProjectConfiguration['targets'] = {\n    build: {\n      executor: 'nx:run-commands',\n      options: {\n        command: 'astro build',\n        cwd: dir,\n      },\n      outputs: [`{workspaceRoot}/${dir}/dist`],\n      cache: true,\n    },\n    start: {\n      executor: 'nx:run-commands',\n      options: {\n        command: 'astro dev',\n        cwd: dir,\n      },\n      continuous: true,\n    },\n    serve: {\n      dependsOn: ['start'],\n    },\n    preview: {\n      executor: 'nx:run-commands',\n      options: {\n        command: 'astro preview',\n        cwd: dir,\n      },\n      dependsOn: ['build'],\n      continuous: true,\n    },\n  };\n\n  if (includeTranslation) {\n    targets['translate'] = {\n      executor: 'nx:run-commands',\n      options: {\n        command: 'tsx ./scripts/translate.ts',\n        cwd: dir,\n        forwardAllArgs: true,\n      },\n    };\n  }\n\n  if (!alreadyExists) {\n    addProjectConfiguration(tree, fullyQualifiedName, {\n      name: fullyQualifiedName,\n      root: dir,\n      sourceRoot: joinPathFragments(dir, 'src'),\n      projectType: 'application',\n      targets,\n    });\n  }\n\n  ensureProjectPackageJson(tree, { dir, fullyQualifiedName });\n\n  const templateOptions = {\n    fullyQualifiedName,\n    title: schema.name,\n    includeTranslation,\n    includeBlog,\n    esm: isEsmWorkspace(tree),\n    pkgMgrCmd: getPackageManagerDisplayCommands().exec,\n    today: new Date().toISOString().slice(0, 10),\n  };\n\n  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files', 'base'),\n    dir,\n    templateOptions,\n    { overwriteStrategy: OverwriteStrategy.KeepExisting },\n  );\n\n  // The sample blog post is always emitted above — drop it if the user opted out.\n  if (!includeBlog) {\n    tree.delete(\n      joinPathFragments(\n        dir,\n        'src',\n        'content',\n        'docs',\n        'en',\n        'blog',\n        'welcome.mdx',\n      ),\n    );\n  }\n\n  if (includeTranslation) {\n    generateFiles(\n      tree,\n      joinPathFragments(import.meta.dirname, 'files', 'translation'),\n      dir,\n      templateOptions,\n      { overwriteStrategy: OverwriteStrategy.KeepExisting },\n    );\n  }\n\n  // Recorded here and read by the declaration's predicates, so the packages\n  // added below are exactly the ones the version sync will own.\n  const metadata: TsAstroDocsMetadata = {\n    framework: 'astro',\n    includeTranslation,\n    includeBlog,\n  };\n  addGeneratorMetadata(\n    tree,\n    fullyQualifiedName,\n    TS_ASTRO_DOCS_GENERATOR_INFO,\n    metadata,\n  );\n\n  addTsDependencies(tree, DEPENDENCIES, { metadata, projectRoot: dir });\n\n  await addGeneratorMetricsIfApplicable(tree, [TS_ASTRO_DOCS_GENERATOR_INFO]);\n\n  await formatFilesInSubtree(tree);\n  return () =>\n    installDependencies(tree, schema.preferInstallDependencies, {\n      languages: ['typescript'],\n    });\n};\n\nexport default tsAstroDocsGenerator;\n"],"names":["addProjectConfiguration","generateFiles","joinPathFragments","OverwriteStrategy","addTsDependencies","declareDependencies","formatFilesInSubtree","installDependencies","addGeneratorMetricsIfApplicable","isEsmWorkspace","toKebabCase","getNpmScopePrefix","addGeneratorMetadata","getGeneratorInfo","projectExists","getPackageManagerDisplayCommands","ensureProjectPackageJson","DEPENDENCIES","ts","name","when","m","includeBlog","includeTranslation","dev","root","TS_ASTRO_DOCS_GENERATOR_INFO","filename","tsAstroDocsGenerator","tree","schema","noTranslation","noBlog","npmScopePrefix","docsNameKebabCase","fullyQualifiedName","dir","directory","subDirectory","alreadyExists","targets","build","executor","options","command","cwd","outputs","cache","start","continuous","serve","dependsOn","preview","forwardAllArgs","sourceRoot","projectType","templateOptions","title","esm","pkgMgrCmd","exec","today","Date","toISOString","slice","dirname","overwriteStrategy","KeepExisting","delete","metadata","framework","projectRoot","preferInstallDependencies","languages"],"mappings":"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"}

package/src/ts/dcr-proxy/generator.d.ts

@@ -5,6 +5,30 @@
 import { type GeneratorCallback, type Tree } from '@nx/devkit';
 import { type NxGeneratorInfo } from '../../utils/nx';
 import type { TsDcrProxyGeneratorSchema } from './schema';
+export declare const DEPENDENCIES: import("../../utils/declared-dependencies").DependencyDeclaration<readonly [{
+    readonly name: "@aws-sdk/client-secrets-manager";
+}, {
+    readonly name: "@types/aws-lambda";
+    readonly dev: true;
+}, {
+    readonly name: "rolldown";
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "constructs";
+    readonly when: (m: import("../../utils/shared-constructs-constants").IacMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "aws-cdk-lib";
+    readonly when: (m: import("../../utils/shared-constructs-constants").IacMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "@types/node";
+} & {
+    versionOnly: true;
+}], readonly import("../../utils/declared-dependencies").DeclaredPyDependency<"a2a-sdk" | "ag-ui-langgraph" | "ag-ui-protocol" | "ag-ui-strands" | "aws-lambda-powertools" | "aws-lambda-powertools[tracer]" | "aws-lambda-powertools[parser]" | "aws-opentelemetry-distro" | "bedrock-agentcore" | "boto3" | "checkov" | "fastapi" | "fastapi[standard]" | "httpx" | "langchain" | "langchain-aws" | "langchain-mcp-adapters" | "langgraph" | "mcp" | "pip-check-updates" | "pip-licenses" | "ruff" | "strands-agents" | "strands-agents[a2a]" | "strands-agents-tools" | "ty" | "pynamodb" | "uvicorn" | "sqlmodel" | "alembic" | "aiomysql" | "asyncpg" | "greenlet", Record<string, never>>[]>;
 export declare const TS_DCR_PROXY_GENERATOR_INFO: NxGeneratorInfo;
 export declare const tsDcrProxyGenerator: (tree: Tree, options: TsDcrProxyGeneratorSchema) => Promise<GeneratorCallback>;
 export default tsDcrProxyGenerator;