@aws/nx-plugin 1.0.0-rc.9 → 1.0.0-rc.90

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

@@ -0,0 +1,34 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type GeneratorCallback, type Tree } from '@nx/devkit';
+import { type NxGeneratorInfo } from '../../utils/nx.js';
+import type { TsDcrProxyGeneratorSchema } from './schema';
+export declare const DEPENDENCIES: import("../../utils/declared-dependencies.js").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.js").IacMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "aws-cdk-lib";
+    readonly when: (m: import("../../utils/shared-constructs-constants.js").IacMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "@types/node";
+} & {
+    versionOnly: true;
+}], readonly import("../../utils/declared-dependencies.js").DeclaredPyDependency<"a2a-sdk" | "ag-ui-langgraph" | "ag-ui-protocol" | "ag-ui-strands" | "aiosqlite" | "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" | "langgraph-checkpoint-aws" | "langgraph-checkpoint-sqlite" | "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;

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

@@ -0,0 +1,115 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ import { generateFiles, joinPathFragments, OverwriteStrategy, updateProjectConfiguration } from "@nx/devkit";
+import tsProjectGenerator from "../lib/generator.js";
+import { addTsDependencies } from "../../utils/add-dependencies.js";
+import { addTypeScriptBundleTarget, BUNDLE_DEPENDENCIES } from "../../utils/bundle/bundle.js";
+import { addDcrProxyInfra, DCR_PROXY_HANDLERS } from "../../utils/dcr-proxy-constructs/dcr-proxy-constructs.js";
+import { declareDependencies, ownedElsewhere } from "../../utils/declared-dependencies.js";
+import { formatFilesInSubtree } from "../../utils/format.js";
+import { resolveIac } from "../../utils/iac.js";
+import { installDependencies } from "../../utils/install.js";
+import { addGeneratorMetricsIfApplicable } from "../../utils/metrics.js";
+import { kebabCase, toClassName } from "../../utils/names.js";
+import { getNpmScopePrefix } from "../../utils/npm-scope.js";
+import { addGeneratorMetadata, getGeneratorInfo, readProjectConfigurationUnqualified } from "../../utils/nx.js";
+import { sortObjectKeys } from "../../utils/object.js";
+import { SHARED_CONSTRUCTS_DEPENDENCIES, sharedConstructsGenerator } from "../../utils/shared-constructs.js";
+export const DEPENDENCIES = declareDependencies()({
+    ts: [
+        // Handler imports: @aws-sdk/client-secrets-manager (token handler) and
+        // @types/aws-lambda (handler signatures).
+        {
+            name: '@aws-sdk/client-secrets-manager'
+        },
+        {
+            name: '@types/aws-lambda',
+            dev: true
+        },
+        ...ownedElsewhere(BUNDLE_DEPENDENCIES),
+        ...ownedElsewhere(SHARED_CONSTRUCTS_DEPENDENCIES)
+    ]
+});
+export const TS_DCR_PROXY_GENERATOR_INFO = getGeneratorInfo(import.meta.filename);
+export const tsDcrProxyGenerator = async (tree, options)=>{
+    const name = kebabCase(options.name ? options.name : 'dcr-proxy');
+    const nameClassName = toClassName(name);
+    const iac = await resolveIac(tree, options.iac);
+    // The handlers live in a standalone TypeScript project so they can be bundled
+    // (rolldown) into deployable artifacts referenced by both CDK and Terraform.
+    const namespace = getNpmScopePrefix(tree);
+    const proxyProjectName = `${namespace}${name}`;
+    let projectExists;
+    try {
+        readProjectConfigurationUnqualified(tree, proxyProjectName);
+        projectExists = true;
+    } catch  {
+        projectExists = false;
+    }
+    if (!projectExists) {
+        await tsProjectGenerator(tree, {
+            name,
+            directory: options.directory,
+            subDirectory: options.subDirectory,
+            preferInstallDependencies: false
+        });
+    }
+    const projectConfig = readProjectConfigurationUnqualified(tree, proxyProjectName);
+    const proxyRoot = projectConfig.root;
+    // Place the Lambda handlers in the project source
+    generateFiles(tree, joinPathFragments(import.meta.dirname, '..', '..', 'utils', 'dcr-proxy-constructs', 'files', 'project'), proxyRoot, {
+        nameClassName,
+        nameKebabCase: name
+    }, {
+        overwriteStrategy: OverwriteStrategy.KeepExisting
+    });
+    addTsDependencies(tree, DEPENDENCIES, {
+        projectRoot: proxyRoot
+    });
+    // Bundle each handler independently to dist/<root>/bundle/<handler>/index.js
+    for (const handler of DCR_PROXY_HANDLERS){
+        await addTypeScriptBundleTarget(tree, projectConfig, {
+            targetFilePath: `src/handlers/${handler}.ts`,
+            bundleOutputDir: handler,
+            external: [
+                /@aws-sdk\/.*/
+            ],
+            platform: 'node'
+        }, DEPENDENCIES);
+    }
+    projectConfig.targets = sortObjectKeys(projectConfig.targets);
+    updateProjectConfiguration(tree, projectConfig.name, projectConfig);
+    // Recorded over the `ts#project` id the underlying generator wrote, so the
+    // version sync attributes this project's dependencies to this generator.
+    // After the write above, which would otherwise revert it.
+    addGeneratorMetadata(tree, projectConfig.name, TS_DCR_PROXY_GENERATOR_INFO, {
+        iac
+    });
+    const bundlePathsFromRoot = Object.fromEntries(DCR_PROXY_HANDLERS.map((handler)=>[
+            handler,
+            joinPathFragments('dist', proxyRoot, 'bundle', handler)
+        ]));
+    await sharedConstructsGenerator(tree, {
+        iac
+    }, DEPENDENCIES);
+    await addDcrProxyInfra(tree, {
+        dcrProxyNameClassName: nameClassName,
+        dcrProxyNameKebabCase: name,
+        proxyProjectName,
+        bundlePathsFromRoot,
+        iac
+    });
+    await addGeneratorMetricsIfApplicable(tree, [
+        TS_DCR_PROXY_GENERATOR_INFO
+    ]);
+    await formatFilesInSubtree(tree);
+    return ()=>installDependencies(tree, options.preferInstallDependencies, {
+            languages: [
+                'typescript'
+            ]
+        });
+};
+export default tsDcrProxyGenerator;
+
+//# sourceMappingURL=generator.js.map

package/src/ts/dcr-proxy/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/ts/dcr-proxy/generator.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport {\n  type GeneratorCallback,\n  generateFiles,\n  joinPathFragments,\n  OverwriteStrategy,\n  type Tree,\n  updateProjectConfiguration,\n} from '@nx/devkit';\nimport tsProjectGenerator from '../../ts/lib/generator.js';\nimport { addTsDependencies } from '../../utils/add-dependencies.js';\nimport {\n  addTypeScriptBundleTarget,\n  BUNDLE_DEPENDENCIES,\n} from '../../utils/bundle/bundle.js';\nimport {\n  addDcrProxyInfra,\n  DCR_PROXY_HANDLERS,\n  type DcrProxyHandler,\n} from '../../utils/dcr-proxy-constructs/dcr-proxy-constructs.js';\nimport {\n  declareDependencies,\n  ownedElsewhere,\n} from '../../utils/declared-dependencies.js';\nimport { formatFilesInSubtree } from '../../utils/format.js';\nimport { resolveIac } from '../../utils/iac.js';\nimport { installDependencies } from '../../utils/install.js';\nimport { addGeneratorMetricsIfApplicable } from '../../utils/metrics.js';\nimport { kebabCase, toClassName } from '../../utils/names.js';\nimport { getNpmScopePrefix } from '../../utils/npm-scope.js';\nimport {\n  addGeneratorMetadata,\n  getGeneratorInfo,\n  type NxGeneratorInfo,\n  readProjectConfigurationUnqualified,\n} from '../../utils/nx.js';\nimport { sortObjectKeys } from '../../utils/object.js';\nimport {\n  SHARED_CONSTRUCTS_DEPENDENCIES,\n  sharedConstructsGenerator,\n} from '../../utils/shared-constructs.js';\nimport type { TsDcrProxyGeneratorSchema } from './schema';\n\nexport const DEPENDENCIES = declareDependencies()({\n  ts: [\n    // Handler imports: @aws-sdk/client-secrets-manager (token handler) and\n    // @types/aws-lambda (handler signatures).\n    { name: '@aws-sdk/client-secrets-manager' },\n    { name: '@types/aws-lambda', dev: true },\n    ...ownedElsewhere(BUNDLE_DEPENDENCIES),\n    ...ownedElsewhere(SHARED_CONSTRUCTS_DEPENDENCIES),\n  ],\n});\n\nexport const TS_DCR_PROXY_GENERATOR_INFO: NxGeneratorInfo = getGeneratorInfo(\n  import.meta.filename,\n);\n\nexport const tsDcrProxyGenerator = async (\n  tree: Tree,\n  options: TsDcrProxyGeneratorSchema,\n): Promise<GeneratorCallback> => {\n  const name = kebabCase(options.name ? options.name : 'dcr-proxy');\n  const nameClassName = toClassName(name);\n\n  const iac = await resolveIac(tree, options.iac);\n\n  // The handlers live in a standalone TypeScript project so they can be bundled\n  // (rolldown) into deployable artifacts referenced by both CDK and Terraform.\n  const namespace = getNpmScopePrefix(tree);\n  const proxyProjectName = `${namespace}${name}`;\n\n  let projectExists: boolean;\n  try {\n    readProjectConfigurationUnqualified(tree, proxyProjectName);\n    projectExists = true;\n  } catch {\n    projectExists = false;\n  }\n\n  if (!projectExists) {\n    await tsProjectGenerator(tree, {\n      name,\n      directory: options.directory,\n      subDirectory: options.subDirectory,\n      preferInstallDependencies: false,\n    });\n  }\n\n  const projectConfig = readProjectConfigurationUnqualified(\n    tree,\n    proxyProjectName,\n  );\n  const proxyRoot = projectConfig.root;\n\n  // Place the Lambda handlers in the project source\n  generateFiles(\n    tree,\n    joinPathFragments(\n      import.meta.dirname,\n      '..',\n      '..',\n      'utils',\n      'dcr-proxy-constructs',\n      'files',\n      'project',\n    ),\n    proxyRoot,\n    { nameClassName, nameKebabCase: name },\n    {\n      overwriteStrategy: OverwriteStrategy.KeepExisting,\n    },\n  );\n\n  addTsDependencies(tree, DEPENDENCIES, { projectRoot: proxyRoot });\n\n  // Bundle each handler independently to dist/<root>/bundle/<handler>/index.js\n  for (const handler of DCR_PROXY_HANDLERS) {\n    await addTypeScriptBundleTarget(\n      tree,\n      projectConfig,\n      {\n        targetFilePath: `src/handlers/${handler}.ts`,\n        bundleOutputDir: handler,\n        external: [/@aws-sdk\\/.*/], // lambda runtime provides the aws sdk\n        platform: 'node',\n      },\n      DEPENDENCIES,\n    );\n  }\n\n  projectConfig.targets = sortObjectKeys(projectConfig.targets);\n  updateProjectConfiguration(tree, projectConfig.name, projectConfig);\n\n  // Recorded over the `ts#project` id the underlying generator wrote, so the\n  // version sync attributes this project's dependencies to this generator.\n  // After the write above, which would otherwise revert it.\n  addGeneratorMetadata(tree, projectConfig.name, TS_DCR_PROXY_GENERATOR_INFO, {\n    iac,\n  });\n\n  const bundlePathsFromRoot = Object.fromEntries(\n    DCR_PROXY_HANDLERS.map((handler) => [\n      handler,\n      joinPathFragments('dist', proxyRoot, 'bundle', handler),\n    ]),\n  ) as Record<DcrProxyHandler, string>;\n\n  await sharedConstructsGenerator(tree, { iac }, DEPENDENCIES);\n\n  await addDcrProxyInfra(tree, {\n    dcrProxyNameClassName: nameClassName,\n    dcrProxyNameKebabCase: name,\n    proxyProjectName,\n    bundlePathsFromRoot,\n    iac,\n  });\n\n  await addGeneratorMetricsIfApplicable(tree, [TS_DCR_PROXY_GENERATOR_INFO]);\n\n  await formatFilesInSubtree(tree);\n  return () =>\n    installDependencies(tree, options.preferInstallDependencies, {\n      languages: ['typescript'],\n    });\n};\n\nexport default tsDcrProxyGenerator;\n"],"names":["generateFiles","joinPathFragments","OverwriteStrategy","updateProjectConfiguration","tsProjectGenerator","addTsDependencies","addTypeScriptBundleTarget","BUNDLE_DEPENDENCIES","addDcrProxyInfra","DCR_PROXY_HANDLERS","declareDependencies","ownedElsewhere","formatFilesInSubtree","resolveIac","installDependencies","addGeneratorMetricsIfApplicable","kebabCase","toClassName","getNpmScopePrefix","addGeneratorMetadata","getGeneratorInfo","readProjectConfigurationUnqualified","sortObjectKeys","SHARED_CONSTRUCTS_DEPENDENCIES","sharedConstructsGenerator","DEPENDENCIES","ts","name","dev","TS_DCR_PROXY_GENERATOR_INFO","filename","tsDcrProxyGenerator","tree","options","nameClassName","iac","namespace","proxyProjectName","projectExists","directory","subDirectory","preferInstallDependencies","projectConfig","proxyRoot","root","dirname","nameKebabCase","overwriteStrategy","KeepExisting","projectRoot","handler","targetFilePath","bundleOutputDir","external","platform","targets","bundlePathsFromRoot","Object","fromEntries","map","dcrProxyNameClassName","dcrProxyNameKebabCase","languages"],"mappings":"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"}

package/src/ts/dcr-proxy/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/dcr-proxy/schema.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/ts/dcr-proxy/schema.d.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport type { IacOption } from '../../utils/iac.js';\n\nexport interface TsDcrProxyGeneratorSchema {\n  name?: string;\n  directory?: string;\n  subDirectory?: string;\n  iac: IacOption;\n  preferInstallDependencies?: boolean;\n}\n"],"names":[],"mappings":"AAAA;;;CAGC,GAGD,WAMC"}

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

@@ -0,0 +1,13 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { IacOption } from '../../utils/iac.js';
+
+export interface TsDcrProxyGeneratorSchema {
+  name?: string;
+  directory?: string;
+  subDirectory?: string;
+  iac: IacOption;
+  preferInstallDependencies?: boolean;
+}

package/src/ts/dcr-proxy/schema.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "ts#dcr-proxy",
+  "title": "ts#dcr-proxy",
+  "description": "Generate an OAuth Dynamic Client Registration (DCR) proxy construct for Cognito-authenticated MCP servers",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "The name of your DCR proxy, used for its TypeScript handler project, the construct/module class name, and its directory under common/constructs or common/terraform",
+      "default": "dcr-proxy",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What would you like to call your DCR proxy?",
+      "x-priority": "important"
+    },
+    "directory": {
+      "description": "The directory to store the DCR proxy handler project in.",
+      "type": "string",
+      "alias": "dir",
+      "x-priority": "important",
+      "default": "packages"
+    },
+    "subDirectory": {
+      "type": "string",
+      "description": "The sub directory the handler project is placed in. By default this is the project name."
+    },
+    "iac": {
+      "type": "string",
+      "description": "The preferred IaC provider (cdk or terraform). By default this is inherited from your initial selection.",
+      "enum": ["inherit", "cdk", "terraform"],
+      "x-priority": "important",
+      "default": "inherit",
+      "x-prompt": "Which provider would you like to manage your infrastructure? (default: inherit)"
+    },
+    "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
+    }
+  }
+}

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

@@ -3,7 +3,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { GeneratorCallback, Tree } from '@nx/devkit';
-import { type NxGeneratorInfo } from '../../utils/nx';
+import { type NxGeneratorInfo } from '../../utils/nx.js';
 import type { TsDocsGeneratorSchema } from './schema';
 export declare const TS_DOCS_GENERATOR_INFO: NxGeneratorInfo;
 export declare const tsDocsGenerator: (tree: Tree, schema: TsDocsGeneratorSchema) => Promise<GeneratorCallback>;

package/src/ts/docs/generator.js

@@ -1,13 +1,13 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.tsDocsGenerator = exports.TS_DOCS_GENERATOR_INFO = void 0;
-const nx_1 = require("../../utils/nx");
-const generator_1 = require("../astro-docs/generator");
-exports.TS_DOCS_GENERATOR_INFO = (0, nx_1.getGeneratorInfo)(__filename);
-const tsDocsGenerator = async (tree, schema) => {
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ import { getGeneratorInfo } from "../../utils/nx.js";
+import { tsAstroDocsGenerator } from "../astro-docs/generator.js";
+export const TS_DOCS_GENERATOR_INFO = getGeneratorInfo(import.meta.filename);
+export const tsDocsGenerator = async (tree, schema)=>{
     const { framework: _framework, ...rest } = schema;
-    return (0, generator_1.tsAstroDocsGenerator)(tree, rest);
+    return tsAstroDocsGenerator(tree, rest);
 };
-exports.tsDocsGenerator = tsDocsGenerator;
-exports.default = exports.tsDocsGenerator;
+export default tsDocsGenerator;
+
 //# sourceMappingURL=generator.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../packages/nx-plugin/src/ts/docs/generator.ts"],"names":[],"mappings":";;;AAKA,uCAAwE;AACxE,uDAA+D;AAGlD,QAAA,sBAAsB,GACjC,IAAA,qBAAgB,EAAC,UAAU,CAAC,CAAC;AAExB,MAAM,eAAe,GAAG,KAAK,EAClC,IAAU,EACV,MAA6B,EACD,EAAE;IAC9B,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IAClD,OAAO,IAAA,gCAAoB,EAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAC1C,CAAC,CAAC;AANW,QAAA,eAAe,mBAM1B;AAEF,kBAAe,uBAAe,CAAC"}
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/ts/docs/generator.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport type { GeneratorCallback, Tree } from '@nx/devkit';\nimport { getGeneratorInfo, type NxGeneratorInfo } from '../../utils/nx.js';\nimport { tsAstroDocsGenerator } from '../astro-docs/generator.js';\nimport type { TsDocsGeneratorSchema } from './schema';\n\nexport const TS_DOCS_GENERATOR_INFO: NxGeneratorInfo = getGeneratorInfo(\n  import.meta.filename,\n);\n\nexport const tsDocsGenerator = async (\n  tree: Tree,\n  schema: TsDocsGeneratorSchema,\n): Promise<GeneratorCallback> => {\n  const { framework: _framework, ...rest } = schema;\n  return tsAstroDocsGenerator(tree, rest);\n};\n\nexport default tsDocsGenerator;\n"],"names":["getGeneratorInfo","tsAstroDocsGenerator","TS_DOCS_GENERATOR_INFO","filename","tsDocsGenerator","tree","schema","framework","_framework","rest"],"mappings":"AAAA;;;CAGC,GAED,SAASA,gBAAgB,QAA8B,oBAAoB;AAC3E,SAASC,oBAAoB,QAAQ,6BAA6B;AAGlE,OAAO,MAAMC,yBAA0CF,iBACrD,YAAYG,QAAQ,EACpB;AAEF,OAAO,MAAMC,kBAAkB,OAC7BC,MACAC;IAEA,MAAM,EAAEC,WAAWC,UAAU,EAAE,GAAGC,MAAM,GAAGH;IAC3C,OAAOL,qBAAqBI,MAAMI;AACpC,EAAE;AAEF,eAAeL,gBAAgB"}

package/src/ts/docs/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/docs/schema.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/ts/docs/schema.d.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nexport interface TsDocsGeneratorSchema {\n  /**\n   * The name of the docs project. Defaults to 'docs'.\n   */\n  name: string;\n  /**\n   * The parent directory the docs project is placed in. Defaults to '.' (workspace root).\n   */\n  directory?: string;\n  /**\n   * The sub directory the docs project is placed in. Defaults to the kebab-case project name.\n   */\n  subDirectory?: string;\n  /**\n   * The documentation framework to use. Defaults to 'astro'.\n   */\n  framework?: 'astro';\n  /**\n   * Opt out of the automated documentation translation pipeline.\n   */\n  noTranslation?: boolean;\n  /**\n   * Opt out of the starlight-blog plugin and sample blog post.\n   */\n  noBlog?: boolean;\n  preferInstallDependencies?: boolean;\n}\n"],"names":[],"mappings":"AAAA;;;CAGC,GACD,WA0BC"}

package/src/ts/docs/schema.d.ts

@@ -27,8 +27,5 @@ export interface TsDocsGeneratorSchema {
    * Opt out of the starlight-blog plugin and sample blog post.
    */
   noBlog?: boolean;
-  /**
-   * Skip installing dependencies after the generator runs.
-   */
-  skipInstall?: boolean;
+  preferInstallDependencies?: boolean;
 }

package/src/ts/docs/schema.json

@@ -60,10 +60,10 @@
       "default": false,
       "x-prompt": "Would you like to opt out of the blog?"
     },
-    "skipInstall": {
-      "description": "Skip installing dependencies after the generator runs.",
+    "preferInstallDependencies": {
       "type": "boolean",
-      "default": false
+      "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"]