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

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

@@ -1,58 +1,124 @@
-"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 format_1 = require("../../utils/format");
-const metrics_1 = require("../../utils/metrics");
-const names_1 = require("../../utils/names");
-const npm_scope_1 = require("../../utils/npm-scope");
-const nx_1 = require("../../utils/nx");
-const pkg_manager_1 = require("../../utils/pkg-manager");
-const versions_1 = require("../../utils/versions");
-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 { addTsDependencies } from "../../utils/add-dependencies.js";
+import { declareDependencies } from "../../utils/declared-dependencies.js";
+import { formatFilesInSubtree } from "../../utils/format.js";
+import { installDependencies } from "../../utils/install.js";
+import { addGeneratorMetricsIfApplicable } from "../../utils/metrics.js";
+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";
+// Each entry names the branch it belongs to, so the same declaration drives both
+// adding and the version sync.
+export const DEPENDENCIES = declareDependencies()({
+    ts: [
+        {
+            name: 'astro'
+        },
+        // Astro leaves `cookie` external in the prerender bundle, so the emitted
+        // `dist` entry imports it directly. Node resolves that from `dist`, which
+        // cannot reach astro's own nested copy, so the docs project declares it to
+        // keep a compatible one in reach.
+        {
+            name: 'cookie'
+        },
+        {
+            name: '@astrojs/starlight'
+        },
+        {
+            name: 'starlight-blog',
+            when: (m)=>m.includeBlog
+        },
+        {
+            name: '@strands-agents/sdk',
+            when: (m)=>m.includeTranslation
+        },
+        {
+            name: 'commander',
+            when: (m)=>m.includeTranslation
+        },
+        {
+            name: 'fast-glob',
+            when: (m)=>m.includeTranslation
+        },
+        {
+            name: 'fs-extra',
+            when: (m)=>m.includeTranslation
+        },
+        {
+            name: 'simple-git',
+            when: (m)=>m.includeTranslation
+        },
+        {
+            name: '@types/fs-extra',
+            when: (m)=>m.includeTranslation,
+            dev: true
+        },
+        // The translate target runs its script from the workspace root via tsx.
+        {
+            name: 'tsx',
+            when: (m)=>m.includeTranslation,
+            dev: true,
+            root: true
+        }
+    ]
+});
+export const TS_ASTRO_DOCS_GENERATOR_INFO = getGeneratorInfo(import.meta.filename);
+export const tsAstroDocsGenerator = async (tree, schema)=>{
     const includeTranslation = !(schema.noTranslation ?? false);
     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 alreadyExists = (0, nx_1.projectExists)(tree, fullyQualifiedName);
+    const dir = joinPathFragments(schema.directory || '.', schema.subDirectory || docsNameKebabCase);
+    const alreadyExists = projectExists(tree, fullyQualifiedName);
     const targets = {
+        // Inputs are left to Nx's implicit `["default", "^default"]`. Astro resolves
+        // imports from a dependency's source rather than its build output, and this
+        // target declares no `dependsOn` for `default`'s transitive
+        // `dependentTasksOutputFiles` to resolve against — so `^default` is the only
+        // thing keeping a dependency's content in the hash.
         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'] = {
@@ -60,58 +126,66 @@ const tsAstroDocsGenerator = async (tree, schema) => {
             options: {
                 command: 'tsx ./scripts/translate.ts',
                 cwd: dir,
-                forwardAllArgs: true,
-            },
+                forwardAllArgs: true
+            }
         };
     }
     if (!alreadyExists) {
-        (0, devkit_1.addProjectConfiguration)(tree, fullyQualifiedName, {
+        addProjectConfiguration(tree, fullyQualifiedName, {
             name: fullyQualifiedName,
             root: dir,
-            sourceRoot: (0, devkit_1.joinPathFragments)(dir, 'src'),
+            sourceRoot: joinPathFragments(dir, 'src'),
             projectType: 'application',
-            targets,
+            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, {
+    // Recorded here and read by the declaration's predicates, so the packages
+    // added below are exactly the ones the version sync will own.
+    const metadata = {
         framework: 'astro',
         includeTranslation,
-        includeBlog,
-    });
-    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');
-    }
-    (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);
-        }
+        includeBlog
     };
+    addGeneratorMetadata(tree, fullyQualifiedName, TS_ASTRO_DOCS_GENERATOR_INFO, metadata);
+    addTsDependencies(tree, DEPENDENCIES, {
+        metadata,
+        projectRoot: dir
+    });
+    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 { addTsDependencies } from '../../utils/add-dependencies.js';\nimport { declareDependencies } from '../../utils/declared-dependencies.js';\nimport { formatFilesInSubtree } from '../../utils/format.js';\nimport { installDependencies } from '../../utils/install.js';\nimport { addGeneratorMetricsIfApplicable } from '../../utils/metrics.js';\nimport { isEsmWorkspace } from '../../utils/module-format.js';\nimport { toKebabCase } from '../../utils/names.js';\nimport { getNpmScopePrefix } from '../../utils/npm-scope.js';\nimport {\n  addGeneratorMetadata,\n  getGeneratorInfo,\n  type NxGeneratorInfo,\n  projectExists,\n} from '../../utils/nx.js';\nimport { getPackageManagerDisplayCommands } from '../../utils/pkg-manager.js';\nimport { ensureProjectPackageJson } from '../../utils/project-package-json.js';\nimport type { TsAstroDocsGeneratorSchema } from './schema';\n\n/** The metadata this generator records, which its predicates read. */\nexport interface TsAstroDocsMetadata {\n  readonly framework: string;\n  readonly includeTranslation: boolean;\n  readonly includeBlog: boolean;\n}\n\n// Each entry names the branch it belongs to, so the same declaration drives both\n// adding and the version sync.\nexport const DEPENDENCIES = declareDependencies<TsAstroDocsMetadata>()({\n  ts: [\n    { name: 'astro' },\n    // Astro leaves `cookie` external in the prerender bundle, so the emitted\n    // `dist` entry imports it directly. Node resolves that from `dist`, which\n    // cannot reach astro's own nested copy, so the docs project declares it to\n    // keep a compatible one in reach.\n    { name: 'cookie' },\n    { name: '@astrojs/starlight' },\n    { name: 'starlight-blog', when: (m) => m.includeBlog },\n    { name: '@strands-agents/sdk', when: (m) => m.includeTranslation },\n    { name: 'commander', when: (m) => m.includeTranslation },\n    { name: 'fast-glob', when: (m) => m.includeTranslation },\n    { name: 'fs-extra', when: (m) => m.includeTranslation },\n    { name: 'simple-git', when: (m) => m.includeTranslation },\n    { name: '@types/fs-extra', when: (m) => m.includeTranslation, dev: true },\n    // The translate target runs its script from the workspace root via tsx.\n    { name: 'tsx', when: (m) => m.includeTranslation, dev: true, root: true },\n  ],\n});\n\nexport const TS_ASTRO_DOCS_GENERATOR_INFO: NxGeneratorInfo = getGeneratorInfo(\n  import.meta.filename,\n);\n\nexport const tsAstroDocsGenerator = async (\n  tree: Tree,\n  schema: TsAstroDocsGeneratorSchema,\n): Promise<GeneratorCallback> => {\n  const includeTranslation = !(schema.noTranslation ?? false);\n  const includeBlog = !(schema.noBlog ?? false);\n  const npmScopePrefix = getNpmScopePrefix(tree);\n  const docsNameKebabCase = toKebabCase(schema.name);\n  const fullyQualifiedName = `${npmScopePrefix}${docsNameKebabCase}`;\n  // NB: interactive nx generator cli can pass empty string\n  const dir = joinPathFragments(\n    schema.directory || '.',\n    schema.subDirectory || docsNameKebabCase,\n  );\n\n  const alreadyExists = projectExists(tree, fullyQualifiedName);\n\n  const targets: ProjectConfiguration['targets'] = {\n    // Inputs are left to Nx's implicit `[\"default\", \"^default\"]`. Astro resolves\n    // imports from a dependency's source rather than its build output, and this\n    // target declares no `dependsOn` for `default`'s transitive\n    // `dependentTasksOutputFiles` to resolve against — so `^default` is the only\n    // thing keeping a dependency's content in the hash.\n    build: {\n      executor: 'nx:run-commands',\n      options: {\n        command: 'astro build',\n        cwd: dir,\n      },\n      outputs: [`{workspaceRoot}/${dir}/dist`],\n      cache: true,\n    },\n    start: {\n      executor: 'nx:run-commands',\n      options: {\n        command: 'astro dev',\n        cwd: dir,\n      },\n      continuous: true,\n    },\n    serve: {\n      dependsOn: ['start'],\n    },\n    preview: {\n      executor: 'nx:run-commands',\n      options: {\n        command: 'astro preview',\n        cwd: dir,\n      },\n      dependsOn: ['build'],\n      continuous: true,\n    },\n  };\n\n  if (includeTranslation) {\n    targets['translate'] = {\n      executor: 'nx:run-commands',\n      options: {\n        command: 'tsx ./scripts/translate.ts',\n        cwd: dir,\n        forwardAllArgs: true,\n      },\n    };\n  }\n\n  if (!alreadyExists) {\n    addProjectConfiguration(tree, fullyQualifiedName, {\n      name: fullyQualifiedName,\n      root: dir,\n      sourceRoot: joinPathFragments(dir, 'src'),\n      projectType: 'application',\n      targets,\n    });\n  }\n\n  ensureProjectPackageJson(tree, { dir, fullyQualifiedName });\n\n  const templateOptions = {\n    fullyQualifiedName,\n    title: schema.name,\n    includeTranslation,\n    includeBlog,\n    esm: isEsmWorkspace(tree),\n    pkgMgrCmd: getPackageManagerDisplayCommands().exec,\n    today: new Date().toISOString().slice(0, 10),\n  };\n\n  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files', 'base'),\n    dir,\n    templateOptions,\n    { overwriteStrategy: OverwriteStrategy.KeepExisting },\n  );\n\n  // The sample blog post is always emitted above — drop it if the user opted out.\n  if (!includeBlog) {\n    tree.delete(\n      joinPathFragments(\n        dir,\n        'src',\n        'content',\n        'docs',\n        'en',\n        'blog',\n        'welcome.mdx',\n      ),\n    );\n  }\n\n  if (includeTranslation) {\n    generateFiles(\n      tree,\n      joinPathFragments(import.meta.dirname, 'files', 'translation'),\n      dir,\n      templateOptions,\n      { overwriteStrategy: OverwriteStrategy.KeepExisting },\n    );\n  }\n\n  // Recorded here and read by the declaration's predicates, so the packages\n  // added below are exactly the ones the version sync will own.\n  const metadata: TsAstroDocsMetadata = {\n    framework: 'astro',\n    includeTranslation,\n    includeBlog,\n  };\n  addGeneratorMetadata(\n    tree,\n    fullyQualifiedName,\n    TS_ASTRO_DOCS_GENERATOR_INFO,\n    metadata,\n  );\n\n  addTsDependencies(tree, DEPENDENCIES, { metadata, projectRoot: dir });\n\n  await addGeneratorMetricsIfApplicable(tree, [TS_ASTRO_DOCS_GENERATOR_INFO]);\n\n  await formatFilesInSubtree(tree);\n  return () =>\n    installDependencies(tree, schema.preferInstallDependencies, {\n      languages: ['typescript'],\n    });\n};\n\nexport default tsAstroDocsGenerator;\n"],"names":["addProjectConfiguration","generateFiles","joinPathFragments","OverwriteStrategy","addTsDependencies","declareDependencies","formatFilesInSubtree","installDependencies","addGeneratorMetricsIfApplicable","isEsmWorkspace","toKebabCase","getNpmScopePrefix","addGeneratorMetadata","getGeneratorInfo","projectExists","getPackageManagerDisplayCommands","ensureProjectPackageJson","DEPENDENCIES","ts","name","when","m","includeBlog","includeTranslation","dev","root","TS_ASTRO_DOCS_GENERATOR_INFO","filename","tsAstroDocsGenerator","tree","schema","noTranslation","noBlog","npmScopePrefix","docsNameKebabCase","fullyQualifiedName","dir","directory","subDirectory","alreadyExists","targets","build","executor","options","command","cwd","outputs","cache","start","continuous","serve","dependsOn","preview","forwardAllArgs","sourceRoot","projectType","templateOptions","title","esm","pkgMgrCmd","exec","today","Date","toISOString","slice","dirname","overwriteStrategy","KeepExisting","delete","metadata","framework","projectRoot","preferInstallDependencies","languages"],"mappings":"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"}

package/src/ts/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"]