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

package/src/ts/astro-docs/files/translation/scripts/translate.ts.template

@@ -44,8 +44,9 @@ interface TranslateConfig {
   translationCommitMessage?: string;
 }
 
-const PROJECT_ROOT = path.resolve(__dirname, '..');
-const CONFIG_PATH = path.resolve(__dirname, 'translate.config.json');
+const SCRIPTS_DIR = <% if (esm) { %>import.meta.dirname<% } else { %>__dirname<% } %>;
+const PROJECT_ROOT = path.resolve(SCRIPTS_DIR, '..');
+const CONFIG_PATH = path.resolve(SCRIPTS_DIR, 'translate.config.json');
 const config: TranslateConfig = JSON.parse(
   fs.readFileSync(CONFIG_PATH, 'utf-8'),
 );

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

@@ -2,9 +2,9 @@
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
-import { GeneratorCallback, Tree } from '@nx/devkit';
-import { TsAstroDocsGeneratorSchema } from './schema';
-import { NxGeneratorInfo } from '../../utils/nx';
+import { type GeneratorCallback, type Tree } from '@nx/devkit';
+import { type NxGeneratorInfo } from '../../utils/nx';
+import type { TsAstroDocsGeneratorSchema } from './schema';
 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

@@ -1,57 +1,62 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.tsAstroDocsGenerator = exports.TS_ASTRO_DOCS_GENERATOR_INFO = void 0;
 /**
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
- */
-const devkit_1 = require("@nx/devkit");
-const nx_1 = require("../../utils/nx");
-const metrics_1 = require("../../utils/metrics");
-const format_1 = require("../../utils/format");
-const npm_scope_1 = require("../../utils/npm-scope");
-const names_1 = require("../../utils/names");
-const versions_1 = require("../../utils/versions");
-const pkg_manager_1 = require("../../utils/pkg-manager");
-exports.TS_ASTRO_DOCS_GENERATOR_INFO = (0, nx_1.getGeneratorInfo)(__filename);
-const tsAstroDocsGenerator = async (tree, schema) => {
+ */ import { addDependenciesToPackageJson, addProjectConfiguration, generateFiles, joinPathFragments, OverwriteStrategy } from "@nx/devkit";
+import { formatFilesInSubtree } from "../../utils/format.js";
+import { installDependencies } from "../../utils/install.js";
+import { addGeneratorMetricsIfApplicable } from "../../utils/metrics.js";
+import { isEsmWorkspace } from "../../utils/module-format.js";
+import { toKebabCase } from "../../utils/names.js";
+import { getNpmScopePrefix } from "../../utils/npm-scope.js";
+import { addGeneratorMetadata, getGeneratorInfo, projectExists } from "../../utils/nx.js";
+import { getPackageManagerDisplayCommands } from "../../utils/pkg-manager.js";
+import { withVersions } from "../../utils/versions.js";
+export const TS_ASTRO_DOCS_GENERATOR_INFO = getGeneratorInfo(import.meta.filename);
+export const tsAstroDocsGenerator = async (tree, schema)=>{
     const includeTranslation = !(schema.noTranslation ?? false);
     const includeBlog = !(schema.noBlog ?? false);
-    const npmScopePrefix = (0, npm_scope_1.getNpmScopePrefix)(tree);
-    const docsNameKebabCase = (0, names_1.toKebabCase)(schema.name);
+    const npmScopePrefix = getNpmScopePrefix(tree);
+    const docsNameKebabCase = toKebabCase(schema.name);
     const fullyQualifiedName = `${npmScopePrefix}${docsNameKebabCase}`;
     // NB: interactive nx generator cli can pass empty string
-    const dir = (0, devkit_1.joinPathFragments)(schema.directory || '.', schema.subDirectory || docsNameKebabCase);
+    const dir = joinPathFragments(schema.directory || '.', schema.subDirectory || docsNameKebabCase);
+    const alreadyExists = projectExists(tree, fullyQualifiedName);
     const targets = {
         build: {
             executor: 'nx:run-commands',
             options: {
                 command: 'astro build',
-                cwd: dir,
+                cwd: dir
             },
-            outputs: [`{workspaceRoot}/${dir}/dist`],
-            cache: true,
+            outputs: [
+                `{workspaceRoot}/${dir}/dist`
+            ],
+            cache: true
         },
         start: {
             executor: 'nx:run-commands',
             options: {
                 command: 'astro dev',
-                cwd: dir,
+                cwd: dir
             },
-            continuous: true,
+            continuous: true
         },
         serve: {
-            dependsOn: ['start'],
+            dependsOn: [
+                'start'
+            ]
         },
         preview: {
             executor: 'nx:run-commands',
             options: {
                 command: 'astro preview',
-                cwd: dir,
+                cwd: dir
             },
-            dependsOn: ['build'],
-            continuous: true,
-        },
+            dependsOn: [
+                'build'
+            ],
+            continuous: true
+        }
     };
     if (includeTranslation) {
         targets['translate'] = {
@@ -59,39 +64,49 @@ const tsAstroDocsGenerator = async (tree, schema) => {
             options: {
                 command: 'tsx ./scripts/translate.ts',
                 cwd: dir,
-                forwardAllArgs: true,
-            },
+                forwardAllArgs: true
+            }
         };
     }
-    (0, devkit_1.addProjectConfiguration)(tree, fullyQualifiedName, {
-        name: fullyQualifiedName,
-        root: dir,
-        sourceRoot: (0, devkit_1.joinPathFragments)(dir, 'src'),
-        projectType: 'application',
-        targets,
-    });
+    if (!alreadyExists) {
+        addProjectConfiguration(tree, fullyQualifiedName, {
+            name: fullyQualifiedName,
+            root: dir,
+            sourceRoot: joinPathFragments(dir, 'src'),
+            projectType: 'application',
+            targets
+        });
+    }
     const templateOptions = {
         fullyQualifiedName,
         title: schema.name,
         includeTranslation,
         includeBlog,
-        pkgMgrCmd: (0, pkg_manager_1.getPackageManagerDisplayCommands)().exec,
-        today: new Date().toISOString().slice(0, 10),
+        esm: isEsmWorkspace(tree),
+        pkgMgrCmd: getPackageManagerDisplayCommands().exec,
+        today: new Date().toISOString().slice(0, 10)
     };
-    (0, devkit_1.generateFiles)(tree, (0, devkit_1.joinPathFragments)(__dirname, 'files', 'base'), dir, templateOptions, { overwriteStrategy: devkit_1.OverwriteStrategy.KeepExisting });
+    generateFiles(tree, joinPathFragments(import.meta.dirname, 'files', 'base'), dir, templateOptions, {
+        overwriteStrategy: OverwriteStrategy.KeepExisting
+    });
     // The sample blog post is always emitted above — drop it if the user opted out.
     if (!includeBlog) {
-        tree.delete((0, devkit_1.joinPathFragments)(dir, 'src', 'content', 'docs', 'en', 'blog', 'welcome.mdx'));
+        tree.delete(joinPathFragments(dir, 'src', 'content', 'docs', 'en', 'blog', 'welcome.mdx'));
     }
     if (includeTranslation) {
-        (0, devkit_1.generateFiles)(tree, (0, devkit_1.joinPathFragments)(__dirname, 'files', 'translation'), dir, templateOptions, { overwriteStrategy: devkit_1.OverwriteStrategy.KeepExisting });
+        generateFiles(tree, joinPathFragments(import.meta.dirname, 'files', 'translation'), dir, templateOptions, {
+            overwriteStrategy: OverwriteStrategy.KeepExisting
+        });
     }
-    (0, nx_1.addGeneratorMetadata)(tree, fullyQualifiedName, exports.TS_ASTRO_DOCS_GENERATOR_INFO, {
+    addGeneratorMetadata(tree, fullyQualifiedName, TS_ASTRO_DOCS_GENERATOR_INFO, {
         framework: 'astro',
         includeTranslation,
-        includeBlog,
+        includeBlog
     });
-    const dependencies = ['astro', '@astrojs/starlight'];
+    const dependencies = [
+        'astro',
+        '@astrojs/starlight'
+    ];
     const devDependencies = [];
     if (includeBlog) {
         dependencies.push('starlight-blog');
@@ -100,15 +115,17 @@ const tsAstroDocsGenerator = async (tree, schema) => {
         dependencies.push('@strands-agents/sdk', 'commander', 'fast-glob', 'fs-extra', 'simple-git');
         devDependencies.push('tsx', '@types/fs-extra');
     }
-    (0, devkit_1.addDependenciesToPackageJson)(tree, (0, versions_1.withVersions)(dependencies), (0, versions_1.withVersions)(devDependencies));
-    await (0, metrics_1.addGeneratorMetricsIfApplicable)(tree, [exports.TS_ASTRO_DOCS_GENERATOR_INFO]);
-    await (0, format_1.formatFilesInSubtree)(tree);
-    return () => {
-        if (!schema.skipInstall) {
-            (0, devkit_1.installPackagesTask)(tree);
-        }
-    };
+    addDependenciesToPackageJson(tree, withVersions(dependencies), withVersions(devDependencies));
+    await addGeneratorMetricsIfApplicable(tree, [
+        TS_ASTRO_DOCS_GENERATOR_INFO
+    ]);
+    await formatFilesInSubtree(tree);
+    return ()=>installDependencies(tree, schema.preferInstallDependencies, {
+            languages: [
+                'typescript'
+            ]
+        });
 };
-exports.tsAstroDocsGenerator = tsAstroDocsGenerator;
-exports.default = exports.tsAstroDocsGenerator;
+export default tsAstroDocsGenerator;
+
 //# sourceMappingURL=generator.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../packages/nx-plugin/src/ts/astro-docs/generator.ts"],"names":[],"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  addDependenciesToPackageJson,\n  addProjectConfiguration,\n  type GeneratorCallback,\n  generateFiles,\n  joinPathFragments,\n  OverwriteStrategy,\n  type ProjectConfiguration,\n  type Tree,\n} from '@nx/devkit';\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 { 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  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('tsx', '@types/fs-extra');\n  }\n\n  addDependenciesToPackageJson(\n    tree,\n    withVersions(dependencies),\n    withVersions(devDependencies),\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":["addDependenciesToPackageJson","addProjectConfiguration","generateFiles","joinPathFragments","OverwriteStrategy","formatFilesInSubtree","installDependencies","addGeneratorMetricsIfApplicable","isEsmWorkspace","toKebabCase","getNpmScopePrefix","addGeneratorMetadata","getGeneratorInfo","projectExists","getPackageManagerDisplayCommands","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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"}

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/ts/astro-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 TsAstroDocsGeneratorSchema {\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   * 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  /**\n   * Whether to prefer installing dependencies after the generator runs.\n   */\n  preferInstallDependencies?: boolean;\n}\n"],"names":[],"mappings":"AAAA;;;CAGC,GACD,WAyBC"}

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

@@ -24,7 +24,7 @@ export interface TsAstroDocsGeneratorSchema {
    */
   noBlog?: boolean;
   /**
-   * Skip installing dependencies after the generator runs.
+   * Whether to prefer installing dependencies after the generator runs.
    */
-  skipInstall?: boolean;
+  preferInstallDependencies?: boolean;
 }

package/src/ts/astro-docs/schema.json

@@ -52,10 +52,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"]

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

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

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":";;;AAMA,uCAAmE;AACnE,uDAA+D;AAElD,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';\nimport { tsAstroDocsGenerator } from '../astro-docs/generator';\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,oBAAiB;AACxE,SAASC,oBAAoB,QAAQ,6BAA0B;AAG/D,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"]