@aws/nx-plugin 1.0.0-rc.5 → 1.0.0-rc.50

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
   }
 }
 "

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,64 @@
-"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 { addProjectConfiguration, generateFiles, joinPathFragments, OverwriteStrategy } from "@nx/devkit";
+import { addDependenciesToPackageJson } from "../../utils/dependencies.js";
+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 { ensureProjectPackageJson } from "../../utils/project-package-json.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,56 +66,75 @@ 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
+        });
+    }
+    ensureProjectPackageJson(tree, {
+        dir,
+        fullyQualifiedName
     });
     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');
     }
     if (includeTranslation) {
         dependencies.push('@strands-agents/sdk', 'commander', 'fast-glob', 'fs-extra', 'simple-git');
-        devDependencies.push('tsx', '@types/fs-extra');
+        devDependencies.push('@types/fs-extra');
+        addDependenciesToPackageJson(tree, {}, withVersions([
+            'tsx'
+        ]));
     }
-    (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), joinPathFragments(dir, 'package.json'));
+    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  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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"}

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"]