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

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

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

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

@@ -1,143 +1,148 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TS_AGENT_REACT_CONNECTION_GENERATOR_INFO = void 0;
-exports.tsAgentReactConnectionGenerator = tsAgentReactConnectionGenerator;
 /**
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
- */
-const devkit_1 = require("@nx/devkit");
-const generator_1 = require("../../react-website/runtime-config/generator");
-const npm_scope_1 = require("../../../utils/npm-scope");
-const versions_1 = require("../../../utils/versions");
-const ast_1 = require("../../../utils/ast");
-const names_1 = require("../../../utils/names");
-const format_1 = require("../../../utils/format");
-const nx_1 = require("../../../utils/nx");
-const metrics_1 = require("../../../utils/metrics");
-const serve_local_1 = require("./serve-local");
-const agent_runtime_config_1 = require("../../../connection/agent-runtime-config");
-const generator_2 = require("../../react-website/agui/generator");
-exports.TS_AGENT_REACT_CONNECTION_GENERATOR_INFO = (0, nx_1.getGeneratorInfo)(__filename);
-async function tsAgentReactConnectionGenerator(tree, options) {
-    const frontendProjectConfig = (0, nx_1.readProjectConfigurationUnqualified)(tree, options.sourceProject);
-    const agentProjectConfig = (0, nx_1.readProjectConfigurationUnqualified)(tree, options.targetProject);
+ */ import { addDependenciesToPackageJson, generateFiles, joinPathFragments, OverwriteStrategy, updateJson } from "@nx/devkit";
+import { addAgentRuntimeToConnectionNamespace } from "../../../connection/agent-runtime-config.js";
+import { addSingleImport, applyGritQL } from "../../../utils/ast.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 { toScopeAlias } from "../../../utils/npm-scope.js";
+import { getGeneratorInfo, readProjectConfigurationUnqualified } from "../../../utils/nx.js";
+import { withVersions } from "../../../utils/versions.js";
+import { addAgUiReactConnection } from "../../react-website/agui/generator.js";
+import { runtimeConfigGenerator } from "../../react-website/runtime-config/generator.js";
+import { addTsAgentTargetToLocalDev } from "./local-dev.js";
+export const TS_AGENT_REACT_CONNECTION_GENERATOR_INFO = getGeneratorInfo(import.meta.filename);
+export async function tsAgentReactConnectionGenerator(tree, options) {
+    const frontendProjectConfig = readProjectConfigurationUnqualified(tree, options.sourceProject);
+    const agentProjectConfig = readProjectConfigurationUnqualified(tree, options.targetProject);
     const targetComponent = options.targetComponent;
     // Extract agent metadata from the target component or project metadata
     const metadata = agentProjectConfig.metadata;
     const agentName = targetComponent?.name ?? 'agent';
-    const agentNameClassName = targetComponent?.rc ?? (0, names_1.toClassName)(agentName);
+    const agentNameClassName = targetComponent?.rc ?? toClassName(agentName);
     const agentPort = targetComponent?.port ?? metadata?.ports?.[0] ?? 8081;
     const auth = (targetComponent?.auth ?? metadata?.auth ?? 'iam').toLowerCase();
-    const agentProjectAlias = (0, npm_scope_1.toScopeAlias)(agentProjectConfig.name);
+    const agentProjectAlias = toScopeAlias(agentProjectConfig.name);
     const agentPath = targetComponent?.path ?? 'src/agent';
     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.`);
+        throw new Error(`Cannot connect a React website to an A2A agent. ` + `Consider generating an agent with the HTTP or AG-UI protocol instead.`);
     }
     if (targetComponent?.protocol === 'ag-ui') {
-        await (0, generator_2.addAgUiReactConnection)(tree, {
+        await addAgUiReactConnection(tree, {
             frontendProjectConfig,
             agentName,
             agentNameClassName,
-            auth: auth,
+            auth: auth
         });
-        await (0, serve_local_1.addTsAgentTargetToServeLocal)(tree, frontendProjectConfig.name, agentProjectConfig.name, {
+        await addTsAgentTargetToLocalDev(tree, frontendProjectConfig.name, agentProjectConfig.name, {
             agentName,
             agentNameClassName,
             port: agentPort,
-            targetComponent,
+            targetComponent
         });
-        await (0, metrics_1.addGeneratorMetricsIfApplicable)(tree, [
-            exports.TS_AGENT_REACT_CONNECTION_GENERATOR_INFO,
+        await addGeneratorMetricsIfApplicable(tree, [
+            TS_AGENT_REACT_CONNECTION_GENERATOR_INFO
         ]);
-        await (0, format_1.formatFilesInSubtree)(tree);
-        return () => {
-            (0, devkit_1.installPackagesTask)(tree);
-        };
+        await formatFilesInSubtree(tree);
+        return ()=>installDependencies(tree, options.preferInstallDependencies, {
+                languages: [
+                    'typescript'
+                ]
+            });
     }
     // Ensure the agent project has a wildcard path entry in tsconfig.base.json
     // so that deep imports (e.g., for the router type) resolve correctly
     ensureWildcardPathEntry(tree, agentProjectConfig.name, agentProjectConfig.root);
-    (0, devkit_1.generateFiles)(tree, (0, devkit_1.joinPathFragments)(__dirname, 'files'), frontendProjectConfig.root, {
+    generateFiles(tree, joinPathFragments(import.meta.dirname, 'files'), frontendProjectConfig.root, {
         agentName,
         agentNameClassName,
         auth,
         agentProjectAlias,
-        agentPath,
+        agentPath
     }, {
-        overwriteStrategy: devkit_1.OverwriteStrategy.KeepExisting,
+        overwriteStrategy: OverwriteStrategy.KeepExisting
     });
     // Generate the tanstack query provider if it does not exist already
-    (0, devkit_1.generateFiles)(tree, (0, devkit_1.joinPathFragments)(__dirname, '../../../utils/files/website/components/tanstack-query'), (0, devkit_1.joinPathFragments)(frontendProjectConfig.sourceRoot, 'components'), {}, {
-        overwriteStrategy: devkit_1.OverwriteStrategy.KeepExisting,
+    generateFiles(tree, joinPathFragments(import.meta.dirname, '../../../utils/files/website/components/tanstack-query'), joinPathFragments(frontendProjectConfig.sourceRoot, 'components'), {}, {
+        overwriteStrategy: OverwriteStrategy.KeepExisting
     });
     if (auth === 'iam') {
-        (0, devkit_1.generateFiles)(tree, (0, devkit_1.joinPathFragments)(__dirname, '../../../utils/files/website/hooks/sigv4'), (0, devkit_1.joinPathFragments)(frontendProjectConfig.sourceRoot, 'hooks'), {}, {
-            overwriteStrategy: devkit_1.OverwriteStrategy.KeepExisting,
+        generateFiles(tree, joinPathFragments(import.meta.dirname, '../../../utils/files/website/hooks/sigv4'), joinPathFragments(frontendProjectConfig.sourceRoot, 'hooks'), {}, {
+            overwriteStrategy: OverwriteStrategy.KeepExisting
         });
     }
-    await (0, generator_1.runtimeConfigGenerator)(tree, {
+    await runtimeConfigGenerator(tree, {
         project: frontendProjectConfig.name,
+        preferInstallDependencies: false
     });
     // update main.tsx
-    const mainTsxPath = (0, devkit_1.joinPathFragments)(frontendProjectConfig.sourceRoot, 'main.tsx');
-    await (0, ast_1.addSingleImport)(tree, mainTsxPath, 'QueryClientProvider', './components/QueryClientProvider');
+    const mainTsxPath = joinPathFragments(frontendProjectConfig.sourceRoot, 'main.tsx');
+    await addSingleImport(tree, mainTsxPath, 'QueryClientProvider', './components/QueryClientProvider');
     const clientProviderName = `${agentNameClassName}AgentClientProvider`;
-    await (0, ast_1.addSingleImport)(tree, mainTsxPath, clientProviderName, `./components/${clientProviderName}`);
+    await addSingleImport(tree, mainTsxPath, clientProviderName, `./components/${clientProviderName}`);
     // Wrap <App /> in QueryClientProvider if not already present
-    await (0, ast_1.applyGritQL)(tree, mainTsxPath, '`<App />` => `<QueryClientProvider><App /></QueryClientProvider>` where { $program <: not contains `<QueryClientProvider>$_</QueryClientProvider>` }');
+    await applyGritQL(tree, mainTsxPath, '`<App />` => `<QueryClientProvider><App /></QueryClientProvider>` where { $program <: not contains `<QueryClientProvider>$_</QueryClientProvider>` }');
     // Wrap <App /> in the agent client provider if not already present
-    await (0, ast_1.applyGritQL)(tree, mainTsxPath, `\`<App />\` => \`<${clientProviderName}><App /></${clientProviderName}>\` where { $program <: not contains \`<${clientProviderName}>$_</${clientProviderName}>\` }`);
-    await (0, serve_local_1.addTsAgentTargetToServeLocal)(tree, frontendProjectConfig.name, agentProjectConfig.name, {
+    await applyGritQL(tree, mainTsxPath, `\`<App />\` => \`<${clientProviderName}><App /></${clientProviderName}>\` where { $program <: not contains \`<${clientProviderName}>$_</${clientProviderName}>\` }`);
+    await addTsAgentTargetToLocalDev(tree, frontendProjectConfig.name, agentProjectConfig.name, {
         agentName,
         agentNameClassName,
         port: agentPort,
-        targetComponent,
+        targetComponent
     });
     // Expose the agent's runtime ARN to the frontend via the 'connection'
     // namespace (which is published to runtime-config.json). The agent construct
     // itself only registers to the 'agentcore' namespace by default.
-    await (0, agent_runtime_config_1.addAgentRuntimeToConnectionNamespace)(tree, {
-        agentNameKebabCase: (0, names_1.kebabCase)(agentNameClassName),
-        agentNameClassName,
+    await addAgentRuntimeToConnectionNamespace(tree, {
+        agentNameKebabCase: kebabCase(agentNameClassName),
+        agentNameClassName
     });
-    (0, devkit_1.addDependenciesToPackageJson)(tree, (0, versions_1.withVersions)([
+    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'] : []),
-    ]), (0, versions_1.withVersions)(['@smithy/types']));
-    await (0, metrics_1.addGeneratorMetricsIfApplicable)(tree, [
-        exports.TS_AGENT_REACT_CONNECTION_GENERATOR_INFO,
+        ...auth === 'iam' ? [
+            'oidc-client-ts',
+            'aws4fetch',
+            '@aws-sdk/credential-provider-cognito-identity',
+            'react-oidc-context'
+        ] : [],
+        ...auth === 'cognito' ? [
+            'react-oidc-context'
+        ] : []
+    ]), withVersions([
+        '@smithy/types'
+    ]));
+    await addGeneratorMetricsIfApplicable(tree, [
+        TS_AGENT_REACT_CONNECTION_GENERATOR_INFO
     ]);
-    await (0, format_1.formatFilesInSubtree)(tree);
-    return () => {
-        (0, devkit_1.installPackagesTask)(tree);
-    };
+    await formatFilesInSubtree(tree);
+    return ()=>installDependencies(tree, options.preferInstallDependencies, {
+            languages: [
+                'typescript'
+            ]
+        });
 }
-exports.default = tsAgentReactConnectionGenerator;
+export default tsAgentReactConnectionGenerator;
 /**
  * Ensures a wildcard path entry exists in tsconfig.base.json for the given project,
  * allowing deep imports (e.g., `:scope/project/src/agent/router.js`).
  * Both the scope alias and npm package name forms are added.
- */
-function ensureWildcardPathEntry(tree, projectName, projectRoot) {
-    const tsconfigPath = ['tsconfig.base.json', 'tsconfig.json'].find((p) => tree.exists(p));
-    if (!tsconfigPath)
-        return;
-    const wildcardValue = [`./${projectRoot}/*`];
-    const scopeAlias = (0, npm_scope_1.toScopeAlias)(projectName);
-    (0, devkit_1.updateJson)(tree, tsconfigPath, (json) => {
+ */ function ensureWildcardPathEntry(tree, projectName, projectRoot) {
+    const tsconfigPath = [
+        'tsconfig.base.json',
+        'tsconfig.json'
+    ].find((p)=>tree.exists(p));
+    if (!tsconfigPath) return;
+    const wildcardValue = [
+        `./${projectRoot}/*`
+    ];
+    const scopeAlias = toScopeAlias(projectName);
+    updateJson(tree, tsconfigPath, (json)=>{
         const paths = json.compilerOptions?.paths ?? {};
         // Add wildcard for the scope alias (used by generated templates)
         const scopeWildcardKey = `${scopeAlias}/*`;
@@ -151,9 +156,10 @@ function ensureWildcardPathEntry(tree, projectName, projectRoot) {
         }
         json.compilerOptions = {
             ...json.compilerOptions,
-            paths,
+            paths
         };
         return json;
     });
 }
+
 //# sourceMappingURL=generator.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../../packages/nx-plugin/src/ts/agent/react-connection/generator.ts"],"names":[],"mappings":"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"}
+{"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  addDependenciesToPackageJson,\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 { formatFilesInSubtree } from '../../../utils/format';\nimport { installDependencies } from '../../../utils/install';\nimport { addGeneratorMetricsIfApplicable } from '../../../utils/metrics';\nimport { kebabCase, toClassName } from '../../../utils/names';\nimport { toScopeAlias } from '../../../utils/npm-scope';\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 = toScopeAlias(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  );\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 * Both the scope alias and npm package name forms are added.\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  const wildcardValue = [`./${projectRoot}/*`];\n  const scopeAlias = toScopeAlias(projectName);\n\n  updateJson(tree, tsconfigPath, (json) => {\n    const paths = json.compilerOptions?.paths ?? {};\n    // Add wildcard for the scope alias (used by generated templates)\n    const scopeWildcardKey = `${scopeAlias}/*`;\n    if (!paths[scopeWildcardKey]) {\n      paths[scopeWildcardKey] = wildcardValue;\n    }\n    // Also add wildcard for the npm package name\n    const npmWildcardKey = `${projectName}/*`;\n    if (!paths[npmWildcardKey]) {\n      paths[npmWildcardKey] = wildcardValue;\n    }\n    json.compilerOptions = {\n      ...json.compilerOptions,\n      paths,\n    };\n    return json;\n  });\n}\n"],"names":["addDependenciesToPackageJson","generateFiles","joinPathFragments","OverwriteStrategy","updateJson","addAgentRuntimeToConnectionNamespace","addSingleImport","applyGritQL","formatFilesInSubtree","installDependencies","addGeneratorMetricsIfApplicable","kebabCase","toClassName","toScopeAlias","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","wildcardValue","scopeAlias","json","paths","compilerOptions","scopeWildcardKey","npmWildcardKey"],"mappings":"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"}

package/src/ts/agent/react-connection/local-dev.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Tree } from '@nx/devkit';
+import type { ComponentMetadata } from '../../../utils/nx';
+export interface TsAgentLocalDevOptions {
+    agentName: string;
+    agentNameClassName: string;
+    port: number;
+    targetComponent?: ComponentMetadata;
+}
+export declare const addTsAgentTargetToLocalDev: (tree: Tree, sourceProjectName: string, targetProjectName: string, options: TsAgentLocalDevOptions) => Promise<void>;

package/src/ts/agent/react-connection/local-dev.js

@@ -0,0 +1,17 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ import { addAgentTargetToLocalDev } from "../../../connection/agent-local-dev.js";
+export const addTsAgentTargetToLocalDev = async (tree, sourceProjectName, targetProjectName, options)=>{
+    const protocol = options.targetComponent?.protocol ?? 'http';
+    const localUrl = protocol === 'ag-ui' ? `http://localhost:${options.port}/invocations` : `ws://localhost:${options.port}/ws`;
+    await addAgentTargetToLocalDev(tree, sourceProjectName, targetProjectName, {
+        agentNameClassName: options.agentNameClassName,
+        port: options.port,
+        targetComponent: options.targetComponent,
+        runtimeConfigNamespace: 'agentRuntimes',
+        localUrl
+    });
+};
+
+//# sourceMappingURL=local-dev.js.map

package/src/ts/agent/react-connection/local-dev.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../packages/nx-plugin/src/ts/agent/react-connection/local-dev.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport type { Tree } from '@nx/devkit';\nimport { addAgentTargetToLocalDev } from '../../../connection/agent-local-dev';\nimport type { ComponentMetadata } from '../../../utils/nx';\n\nexport interface TsAgentLocalDevOptions {\n  agentName: string;\n  agentNameClassName: string;\n  port: number;\n  targetComponent?: ComponentMetadata;\n}\n\nexport const addTsAgentTargetToLocalDev = async (\n  tree: Tree,\n  sourceProjectName: string,\n  targetProjectName: string,\n  options: TsAgentLocalDevOptions,\n) => {\n  const protocol = options.targetComponent?.protocol ?? 'http';\n  const localUrl =\n    protocol === 'ag-ui'\n      ? `http://localhost:${options.port}/invocations`\n      : `ws://localhost:${options.port}/ws`;\n\n  await addAgentTargetToLocalDev(tree, sourceProjectName, targetProjectName, {\n    agentNameClassName: options.agentNameClassName,\n    port: options.port,\n    targetComponent: options.targetComponent,\n    runtimeConfigNamespace: 'agentRuntimes',\n    localUrl,\n  });\n};\n"],"names":["addAgentTargetToLocalDev","addTsAgentTargetToLocalDev","tree","sourceProjectName","targetProjectName","options","protocol","targetComponent","localUrl","port","agentNameClassName","runtimeConfigNamespace"],"mappings":"AAAA;;;CAGC,GAED,SAASA,wBAAwB,QAAQ,yCAAsC;AAU/E,OAAO,MAAMC,6BAA6B,OACxCC,MACAC,mBACAC,mBACAC;IAEA,MAAMC,WAAWD,QAAQE,eAAe,EAAED,YAAY;IACtD,MAAME,WACJF,aAAa,UACT,CAAC,iBAAiB,EAAED,QAAQI,IAAI,CAAC,YAAY,CAAC,GAC9C,CAAC,eAAe,EAAEJ,QAAQI,IAAI,CAAC,GAAG,CAAC;IAEzC,MAAMT,yBAAyBE,MAAMC,mBAAmBC,mBAAmB;QACzEM,oBAAoBL,QAAQK,kBAAkB;QAC9CD,MAAMJ,QAAQI,IAAI;QAClBF,iBAAiBF,QAAQE,eAAe;QACxCI,wBAAwB;QACxBH;IACF;AACF,EAAE"}

package/src/ts/agent/react-connection/schema.d.js

@@ -0,0 +1,8 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ /**
+ * TypeScript types for options defined in schema.json
+ */ export { };
+
+//# sourceMappingURL=schema.d.js.map

package/src/ts/agent/react-connection/schema.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../packages/nx-plugin/src/ts/agent/react-connection/schema.d.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport { ComponentMetadata } from '../../../utils/nx';\n\n/**\n * TypeScript types for options defined in schema.json\n */\nexport interface TsAgentReactConnectionGeneratorSchema {\n  sourceProject: string;\n  targetProject: string;\n  sourceComponent?: ComponentMetadata;\n  targetComponent?: ComponentMetadata;\n  preferInstallDependencies?: boolean;\n}\n"],"names":[],"mappings":"AAAA;;;CAGC,GAGD;;CAEC,GACD,WAMC"}

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

@@ -12,4 +12,5 @@ export interface TsAgentReactConnectionGeneratorSchema {
   targetProject: string;
   sourceComponent?: ComponentMetadata;
   targetComponent?: ComponentMetadata;
+  preferInstallDependencies?: boolean;
 }

package/src/ts/agent/react-connection/schema.json

@@ -20,6 +20,11 @@
     "targetComponent": {
       "type": "string",
       "description": "The Agent component name"
+    },
+    "preferInstallDependencies": {
+      "type": "boolean",
+      "description": "Whether to prefer installing dependencies after the generator runs. Set to false to defer installing when batching multiple generators (an install still runs if needed so subsequent generators can compute the Nx project graph); install once at the end.",
+      "default": true
     }
   },
   "required": ["sourceProject", "targetProject"]

package/src/ts/agent/schema.d.js

@@ -0,0 +1,6 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ export { };
+
+//# sourceMappingURL=schema.d.js.map

package/src/ts/agent/schema.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/ts/agent/schema.d.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { IacOption } from '../../utils/iac';\n\nexport type TsAgentFramework = 'strands';\nexport type TsAgentInfra = 'agentcore' | 'none';\nexport type AgentProtocol = 'http' | 'a2a' | 'ag-ui';\n\nexport type TsAgentAuth = 'iam' | 'cognito';\n\nexport interface TsAgentGeneratorSchema {\n  project: string;\n  framework?: TsAgentFramework;\n  name?: string;\n  infra?: TsAgentInfra;\n  auth?: TsAgentAuth;\n  protocol?: AgentProtocol;\n  iac: IacOption;\n  preferInstallDependencies?: boolean;\n}\n"],"names":[],"mappings":"AAAA;;;CAGC,GAUD,WASC"}

package/src/ts/agent/schema.d.ts

@@ -19,4 +19,5 @@ export interface TsAgentGeneratorSchema {
   auth?: TsAgentAuth;
   protocol?: AgentProtocol;
   iac: IacOption;
+  preferInstallDependencies?: boolean;
 }

package/src/ts/agent/schema.json

@@ -59,6 +59,11 @@
       "enum": ["agentcore", "none"],
       "default": "agentcore",
       "x-priority": "important"
+    },
+    "preferInstallDependencies": {
+      "type": "boolean",
+      "description": "Whether to prefer installing dependencies after the generator runs. Set to false to defer installing when batching multiple generators (an install still runs if needed so subsequent generators can compute the Nx project graph); install once at the end.",
+      "default": true
     }
   },
   "required": ["project"]

package/src/ts/api/generator.d.ts

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

package/src/ts/api/generator.js

@@ -1,16 +1,15 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TS_API_GENERATOR_INFO = void 0;
-exports.tsApiGenerator = tsApiGenerator;
-const nx_1 = require("../../utils/nx");
-const generator_1 = require("../../trpc/backend/generator");
-const generator_2 = require("../../smithy/ts/api/generator");
-exports.TS_API_GENERATOR_INFO = (0, nx_1.getGeneratorInfo)(__filename);
-async function tsApiGenerator(tree, options) {
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ import { tsSmithyApiGenerator } from "../../smithy/ts/api/generator.js";
+import { tsTrpcApiGenerator } from "../../trpc/backend/generator.js";
+import { getGeneratorInfo } from "../../utils/nx.js";
+export const TS_API_GENERATOR_INFO = getGeneratorInfo(import.meta.filename);
+export async function tsApiGenerator(tree, options) {
     const framework = options.framework ?? 'trpc';
-    switch (framework) {
+    switch(framework){
         case 'trpc':
-            return (0, generator_1.tsTrpcApiGenerator)(tree, {
+            return tsTrpcApiGenerator(tree, {
                 name: options.name,
                 infra: options.infra,
                 integrationPattern: options.integrationPattern,
@@ -18,21 +17,22 @@ async function tsApiGenerator(tree, options) {
                 directory: options.directory,
                 subDirectory: options.subDirectory,
                 iac: options.iac,
+                preferInstallDependencies: options.preferInstallDependencies
             });
         case 'smithy':
-            return (0, generator_2.tsSmithyApiGenerator)(tree, {
+            return tsSmithyApiGenerator(tree, {
                 name: options.name,
                 namespace: options.namespace,
-                infra: options.infra === 'none'
-                    ? 'none'
-                    : (options.infra ?? 'rest-lambda'),
+                infra: options.infra === 'none' ? 'none' : options.infra ?? 'rest-lambda',
                 integrationPattern: options.integrationPattern,
                 auth: options.auth,
                 directory: options.directory,
                 subDirectory: options.subDirectory,
                 iac: options.iac,
+                preferInstallDependencies: options.preferInstallDependencies
             });
     }
 }
-exports.default = tsApiGenerator;
+export default tsApiGenerator;
+
 //# sourceMappingURL=generator.js.map

package/src/ts/api/generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../packages/nx-plugin/src/ts/api/generator.ts"],"names":[],"mappings":";;;AAaA,wCAgCC;AAvCD,uCAAmE;AACnE,4DAAkE;AAClE,6DAAqE;AAExD,QAAA,qBAAqB,GAChC,IAAA,qBAAgB,EAAC,UAAU,CAAC,CAAC;AAExB,KAAK,UAAU,cAAc,CAClC,IAAU,EACV,OAA6B;IAE7B,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC;IAE9C,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,MAAM;YACT,OAAO,IAAA,8BAAkB,EAAC,IAAI,EAAE;gBAC9B,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;gBAC9C,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,GAAG,EAAE,OAAO,CAAC,GAAG;aACjB,CAAC,CAAC;QACL,KAAK,QAAQ;YACX,OAAO,IAAA,gCAAoB,EAAC,IAAI,EAAE;gBAChC,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,KAAK,EACH,OAAO,CAAC,KAAK,KAAK,MAAM;oBACtB,CAAC,CAAC,MAAM;oBACR,CAAC,CAAE,CAAC,OAAO,CAAC,KAAK,IAAI,aAAa,CAAmB;gBACzD,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;gBAC9C,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,GAAG,EAAE,OAAO,CAAC,GAAG;aACjB,CAAC,CAAC;IACP,CAAC;AACH,CAAC;AAED,kBAAe,cAAc,CAAC"}
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/ts/api/generator.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport type { Tree } from '@nx/devkit';\nimport { tsSmithyApiGenerator } from '../../smithy/ts/api/generator';\nimport { tsTrpcApiGenerator } from '../../trpc/backend/generator';\nimport { getGeneratorInfo, type NxGeneratorInfo } from '../../utils/nx';\nimport type { TsApiGeneratorSchema } from './schema';\n\nexport const TS_API_GENERATOR_INFO: NxGeneratorInfo = getGeneratorInfo(\n  import.meta.filename,\n);\n\nexport async function tsApiGenerator(\n  tree: Tree,\n  options: TsApiGeneratorSchema,\n) {\n  const framework = options.framework ?? 'trpc';\n\n  switch (framework) {\n    case 'trpc':\n      return tsTrpcApiGenerator(tree, {\n        name: options.name,\n        infra: options.infra,\n        integrationPattern: options.integrationPattern,\n        auth: options.auth,\n        directory: options.directory,\n        subDirectory: options.subDirectory,\n        iac: options.iac,\n        preferInstallDependencies: options.preferInstallDependencies,\n      });\n    case 'smithy':\n      return tsSmithyApiGenerator(tree, {\n        name: options.name,\n        namespace: options.namespace,\n        infra:\n          options.infra === 'none'\n            ? 'none'\n            : ((options.infra ?? 'rest-lambda') as 'rest-lambda'),\n        integrationPattern: options.integrationPattern,\n        auth: options.auth,\n        directory: options.directory,\n        subDirectory: options.subDirectory,\n        iac: options.iac,\n        preferInstallDependencies: options.preferInstallDependencies,\n      });\n  }\n}\n\nexport default tsApiGenerator;\n"],"names":["tsSmithyApiGenerator","tsTrpcApiGenerator","getGeneratorInfo","TS_API_GENERATOR_INFO","filename","tsApiGenerator","tree","options","framework","name","infra","integrationPattern","auth","directory","subDirectory","iac","preferInstallDependencies","namespace"],"mappings":"AAAA;;;CAGC,GAED,SAASA,oBAAoB,QAAQ,mCAAgC;AACrE,SAASC,kBAAkB,QAAQ,kCAA+B;AAClE,SAASC,gBAAgB,QAA8B,oBAAiB;AAGxE,OAAO,MAAMC,wBAAyCD,iBACpD,YAAYE,QAAQ,EACpB;AAEF,OAAO,eAAeC,eACpBC,IAAU,EACVC,OAA6B;IAE7B,MAAMC,YAAYD,QAAQC,SAAS,IAAI;IAEvC,OAAQA;QACN,KAAK;YACH,OAAOP,mBAAmBK,MAAM;gBAC9BG,MAAMF,QAAQE,IAAI;gBAClBC,OAAOH,QAAQG,KAAK;gBACpBC,oBAAoBJ,QAAQI,kBAAkB;gBAC9CC,MAAML,QAAQK,IAAI;gBAClBC,WAAWN,QAAQM,SAAS;gBAC5BC,cAAcP,QAAQO,YAAY;gBAClCC,KAAKR,QAAQQ,GAAG;gBAChBC,2BAA2BT,QAAQS,yBAAyB;YAC9D;QACF,KAAK;YACH,OAAOhB,qBAAqBM,MAAM;gBAChCG,MAAMF,QAAQE,IAAI;gBAClBQ,WAAWV,QAAQU,SAAS;gBAC5BP,OACEH,QAAQG,KAAK,KAAK,SACd,SACEH,QAAQG,KAAK,IAAI;gBACzBC,oBAAoBJ,QAAQI,kBAAkB;gBAC9CC,MAAML,QAAQK,IAAI;gBAClBC,WAAWN,QAAQM,SAAS;gBAC5BC,cAAcP,QAAQO,YAAY;gBAClCC,KAAKR,QAAQQ,GAAG;gBAChBC,2BAA2BT,QAAQS,yBAAyB;YAC9D;IACJ;AACF;AAEA,eAAeX,eAAe"}

package/src/ts/api/schema.d.js

@@ -0,0 +1,6 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ export { };
+
+//# sourceMappingURL=schema.d.js.map

package/src/ts/api/schema.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/ts/api/schema.d.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { IacOption } from '../../utils/iac';\nimport { TsProjectGeneratorSchema } from '../lib/schema';\n\nexport interface TsApiGeneratorSchema {\n  name: string;\n  framework?: 'trpc' | 'smithy';\n  namespace?: string;\n  infra: 'rest-lambda' | 'http-lambda' | 'none';\n  integrationPattern?: 'isolated' | 'shared';\n  auth: 'iam' | 'cognito' | 'custom';\n  directory?: TsProjectGeneratorSchema['directory'];\n  subDirectory?: TsProjectGeneratorSchema['subDirectory'];\n  iac: IacOption;\n  preferInstallDependencies?: boolean;\n}\n"],"names":[],"mappings":"AAAA;;;CAGC,GAKD,WAWC"}

package/src/ts/api/schema.d.ts

@@ -2,8 +2,9 @@
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
-import { TsProjectGeneratorSchema } from '../lib/schema';
+
 import { IacOption } from '../../utils/iac';
+import { TsProjectGeneratorSchema } from '../lib/schema';
 
 export interface TsApiGeneratorSchema {
   name: string;
@@ -15,4 +16,5 @@ export interface TsApiGeneratorSchema {
   directory?: TsProjectGeneratorSchema['directory'];
   subDirectory?: TsProjectGeneratorSchema['subDirectory'];
   iac: IacOption;
+  preferInstallDependencies?: boolean;
 }

package/src/ts/api/schema.json

@@ -99,6 +99,11 @@
       "enum": ["rest-lambda", "http-lambda", "none"],
       "x-prompt": "What infrastructure would you like to deploy your API with?",
       "x-priority": "important"
+    },
+    "preferInstallDependencies": {
+      "type": "boolean",
+      "description": "Whether to prefer installing dependencies after the generator runs. Set to false to defer installing when batching multiple generators (an install still runs if needed so subsequent generators can compute the Nx project graph); install once at the end.",
+      "default": true
     }
   },
   "required": ["name"]

package/src/ts/astro-docs/__snapshots__/generator.spec.ts.snap

@@ -78,8 +78,7 @@ import { CardGrid, Card } from '@astrojs/starlight/components';
     Reusable content fragments used across the docs.
   </Card>
   <Card title="Localised" icon="translate">
-    Localisation is configured out of the box — add target locales in
-    \`astro.config.mjs\`.
+    Localisation is configured out of the box — add target locales in \`astro.config.mjs\`.
   </Card>
 </CardGrid>
 "
@@ -120,35 +119,41 @@ exports[`ts#astro-docs generator > should generate a docs site with default opti
   "$schema": "../node_modules/nx/schemas/project-schema.json",
   "sourceRoot": "docs/src",
   "projectType": "application",
+  "metadata": {
+    "generator": "ts#astro-docs",
+    "framework": "astro",
+    "includeTranslation": true,
+    "includeBlog": true
+  },
   "targets": {
     "build": {
       "executor": "nx:run-commands",
+      "outputs": ["{workspaceRoot}/docs/dist"],
+      "cache": true,
       "options": {
         "command": "astro build",
         "cwd": "docs"
-      },
-      "outputs": ["{workspaceRoot}/docs/dist"],
-      "cache": true
+      }
     },
     "start": {
       "executor": "nx:run-commands",
+      "continuous": true,
       "options": {
         "command": "astro dev",
         "cwd": "docs"
-      },
-      "continuous": true
+      }
     },
     "serve": {
       "dependsOn": ["start"]
     },
     "preview": {
       "executor": "nx:run-commands",
+      "dependsOn": ["build"],
+      "continuous": true,
       "options": {
         "command": "astro preview",
         "cwd": "docs"
-      },
-      "dependsOn": ["build"],
-      "continuous": true
+      }
     },
     "translate": {
       "executor": "nx:run-commands",
@@ -158,12 +163,6 @@ exports[`ts#astro-docs generator > should generate a docs site with default opti
         "forwardAllArgs": true
       }
     }
-  },
-  "metadata": {
-    "generator": "ts#astro-docs",
-    "framework": "astro",
-    "includeTranslation": true,
-    "includeBlog": true
   }
 }
 "