@storm-software/projen 0.11.0 → 0.12.0

package/.eslintrc.json

@@ -0,0 +1,40 @@
+{
+  "extends": ["../../.eslintrc.json"],
+  "ignorePatterns": ["!**/*"],
+  "overrides": [
+    {
+      "files": ["*.ts", "*.tsx", "*.js", "*.jsx"],
+      "parserOptions": {
+        "project": ["packages/pulumi-tools/tsconfig.*?.json"]
+      },
+      "rules": {}
+    },
+    {
+      "files": ["*.ts", "*.tsx"],
+      "rules": {}
+    },
+    {
+      "files": ["*.js", "*.jsx"],
+      "rules": {}
+    },
+    {
+      "files": ["*.json"],
+      "parser": "jsonc-eslint-parser",
+      "rules": {
+        "@nx/dependency-checks": [
+          "error",
+          {
+            "ignoredFiles": ["{projectRoot}/eslint.config.{js,cjs,mjs}"]
+          }
+        ]
+      }
+    },
+    {
+      "files": ["./package.json", "./executors.json", "./generators.json"],
+      "parser": "jsonc-eslint-parser",
+      "rules": {
+        "@nx/nx-plugin-checks": "error"
+      }
+    }
+  ]
+}

package/CHANGELOG.md

@@ -2,6 +2,34 @@
 
 # Changelog for Storm Ops - Projen
 
+## [0.12.0](https://github.com/storm-software/storm-ops/releases/tag/projen%400.12.0) (2025-05-06)
+
+### Features
+
+- **workspace-tools:** Update the publish executor source code
+  ([527dcfe84](https://github.com/storm-software/storm-ops/commit/527dcfe84))
+
+### Miscellaneous
+
+- **monorepo:** Regenerate README markdown files
+  ([d58a4014e](https://github.com/storm-software/storm-ops/commit/d58a4014e))
+
+## [0.11.2](https://github.com/storm-software/storm-ops/releases/tag/projen%400.11.2) (2025-05-05)
+
+### Miscellaneous
+
+- **workspace-tools:** Skip git checks during publish
+  ([7fdcbfc9a](https://github.com/storm-software/storm-ops/commit/7fdcbfc9a))
+- **monorepo:** Regenerate README markdown files
+  ([fb8ab0609](https://github.com/storm-software/storm-ops/commit/fb8ab0609))
+
+## [0.11.1](https://github.com/storm-software/storm-ops/releases/tag/projen%400.11.1) (2025-05-05)
+
+### Miscellaneous
+
+- **monorepo:** Regenerate README markdown files
+  ([372776939](https://github.com/storm-software/storm-ops/commit/372776939))
+
 ## [0.11.0](https://github.com/storm-software/storm-ops/releases/tag/projen%400.11.0) (2025-05-05)
 
 ### Features

package/README.md

@@ -21,7 +21,7 @@ This package is part of the <b>⚡Storm-Ops</b> monorepo. The Storm-Ops packages
 
 <h3 align="center">💻 Visit <a href="https://stormsoftware.com" target="_blank">stormsoftware.com</a> to stay up to date with this developer</h3><br />
 
-[![Version](https://img.shields.io/badge/version-0.10.5-1fb2a6.svg?style=for-the-badge&color=1fb2a6)](https://prettier.io/)&nbsp;[![Nx](https://img.shields.io/badge/Nx-17.0.2-lightgrey?style=for-the-badge&logo=nx&logoWidth=20&&color=1fb2a6)](http://nx.dev/)&nbsp;[![NextJs](https://img.shields.io/badge/Next.js-14.0.2-lightgrey?style=for-the-badge&logo=nextdotjs&logoWidth=20&color=1fb2a6)](https://nextjs.org/)&nbsp;[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg?style=for-the-badge&logo=commitlint&color=1fb2a6)](http://commitizen.github.io/cz-cli/)&nbsp;![Semantic-Release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=for-the-badge&color=1fb2a6)&nbsp;[![documented with Fumadocs](https://img.shields.io/badge/documented_with-fumadocs-success.svg?style=for-the-badge&logo=readthedocs&color=1fb2a6)](https://fumadocs.vercel.app/)&nbsp;![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/storm-software/storm-ops/cr.yml?style=for-the-badge&logo=github-actions&color=1fb2a6)
+[![Version](https://img.shields.io/badge/version-0.11.1-1fb2a6.svg?style=for-the-badge&color=1fb2a6)](https://prettier.io/)&nbsp;[![Nx](https://img.shields.io/badge/Nx-17.0.2-lightgrey?style=for-the-badge&logo=nx&logoWidth=20&&color=1fb2a6)](http://nx.dev/)&nbsp;[![NextJs](https://img.shields.io/badge/Next.js-14.0.2-lightgrey?style=for-the-badge&logo=nextdotjs&logoWidth=20&color=1fb2a6)](https://nextjs.org/)&nbsp;[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg?style=for-the-badge&logo=commitlint&color=1fb2a6)](http://commitizen.github.io/cz-cli/)&nbsp;![Semantic-Release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=for-the-badge&color=1fb2a6)&nbsp;[![documented with Fumadocs](https://img.shields.io/badge/documented_with-fumadocs-success.svg?style=for-the-badge&logo=readthedocs&color=1fb2a6)](https://fumadocs.vercel.app/)&nbsp;![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/storm-software/storm-ops/cr.yml?style=for-the-badge&logo=github-actions&color=1fb2a6)
 
 <!-- prettier-ignore-start -->
 <!-- markdownlint-disable -->
@@ -40,6 +40,7 @@ This package is part of the <b>⚡Storm-Ops</b> monorepo. The Storm-Ops packages
 
 <!-- START doctoc -->
 <!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
+
 ## Table of Contents
 
 - [Storm Projen Tools](#storm-projen-tools)

package/dist/{chunk-VHNXR7ZZ.mjs → chunk-QEFNN2AM.mjs}

@@ -13,7 +13,7 @@ init_esm_shims();
 import {
   addDependenciesToPackageJson as addDependenciesToPackageJson4,
   formatFiles as formatFiles9,
-  readJsonFile as readJsonFile4,
+  readJsonFile as readJsonFile5,
   runTasksInSerial
 } from "@nx/devkit";
 
@@ -2691,8 +2691,16 @@ var executor_default6 = withRunExecutor(
 
 // ../workspace-tools/src/executors/npm-publish/executor.ts
 init_esm_shims();
+import {
+  detectPackageManager,
+  readJsonFile
+} from "@nx/devkit";
+import { exec } from "child_process";
+import * as columnify from "columnify";
+import { existsSync as existsSync8 } from "fs";
 import { execSync as execSync3 } from "node:child_process";
-import { readFile as readFile6 } from "node:fs/promises";
+import { env as appendLocalEnv } from "npm-run-path";
+import { join as join3, relative as relative3 } from "path";
 
 // ../workspace-tools/src/utils/pnpm-deps-update.ts
 init_esm_shims();
@@ -4088,8 +4096,8 @@ var DEFAULT_COMMIT_QUESTIONS = {
 init_esm_shims();
 
 // ../workspace-tools/src/generators/release-version/generator.ts
-import { exec, execSync as execSync4 } from "node:child_process";
-import { relative as relative3 } from "node:path";
+import { exec as exec2, execSync as execSync4 } from "node:child_process";
+import { relative as relative4 } from "node:path";
 import { IMPLICIT_DEFAULT_RELEASE_GROUP } from "nx/src/command-line/release/config/config";
 import {
   getFirstGitCommit,
@@ -4500,11 +4508,11 @@ import { retrieveProjectConfigurationsWithoutPluginInference } from "nx/src/proj
 init_esm_shims();
 import {
   output as output2,
-  readJsonFile,
+  readJsonFile as readJsonFile2,
   workspaceRoot as workspaceRoot2
 } from "@nx/devkit";
-import { existsSync as existsSync8 } from "node:fs";
-import { join as join4 } from "node:path";
+import { existsSync as existsSync9 } from "node:fs";
+import { join as join5 } from "node:path";
 import {
   getNpmLockfileDependencies,
   getNpmLockfileNodes
@@ -4520,24 +4528,24 @@ import {
 var YARN_LOCK_FILE = "yarn.lock";
 var NPM_LOCK_FILE = "package-lock.json";
 var PNPM_LOCK_FILE = "pnpm-lock.yaml";
-var YARN_LOCK_PATH = join4(workspaceRoot2, YARN_LOCK_FILE);
-var NPM_LOCK_PATH = join4(workspaceRoot2, NPM_LOCK_FILE);
-var PNPM_LOCK_PATH = join4(workspaceRoot2, PNPM_LOCK_FILE);
+var YARN_LOCK_PATH = join5(workspaceRoot2, YARN_LOCK_FILE);
+var NPM_LOCK_PATH = join5(workspaceRoot2, NPM_LOCK_FILE);
+var PNPM_LOCK_PATH = join5(workspaceRoot2, PNPM_LOCK_FILE);
 
 // ../workspace-tools/src/utils/package-helpers.ts
 init_esm_shims();
 import {
   joinPathFragments as joinPathFragments6,
-  readJsonFile as readJsonFile2
+  readJsonFile as readJsonFile3
 } from "@nx/devkit";
-import { existsSync as existsSync9 } from "node:fs";
+import { existsSync as existsSync10 } from "node:fs";
 
 // ../workspace-tools/src/utils/plugin-helpers.ts
 init_esm_shims();
-import { readJsonFile as readJsonFile3 } from "@nx/devkit";
+import { readJsonFile as readJsonFile4 } from "@nx/devkit";
 import defu6 from "defu";
-import { existsSync as existsSync10 } from "node:fs";
-import { dirname, join as join5 } from "node:path";
+import { existsSync as existsSync11 } from "node:fs";
+import { dirname, join as join6 } from "node:path";
 
 // ../workspace-tools/src/utils/typia-transform.ts
 init_esm_shims();
@@ -4558,7 +4566,7 @@ var generator_default6 = withRunGenerator(
 );
 function addProjenDeps(tree, options) {
   return () => {
-    const packageJson = readJsonFile4(`${options.directory}/package.json`);
+    const packageJson = readJsonFile5(`${options.directory}/package.json`);
     packageJson.dependencies["projen"] ??= "^0.91.6";
     if (packageJson) {
       addDependenciesToPackageJson4(

package/dist/{chunk-RRTPMNWO.js → chunk-XXUM5XR7.js}

@@ -2693,6 +2693,14 @@ _chunkBG73ZJERjs.init_cjs_shims.call(void 0, );
 
 
 
+
+
+var _columnify = require('columnify'); var columnify = _interopRequireWildcard(_columnify);
+
+
+var _npmrunpath = require('npm-run-path');
+
+
 // ../workspace-tools/src/utils/pnpm-deps-update.ts
 _chunkBG73ZJERjs.init_cjs_shims.call(void 0, );
 

package/dist/generators.js

@@ -1,9 +1,9 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});require('./chunk-NG74QN4S.js');
 
 
-var _chunkRRTPMNWOjs = require('./chunk-RRTPMNWO.js');
+var _chunkXXUM5XR7js = require('./chunk-XXUM5XR7.js');
 require('./chunk-NNSWWAGP.js');
 require('./chunk-BG73ZJER.js');
 
 
-exports.initGeneratorFn = _chunkRRTPMNWOjs.initGeneratorFn;
+exports.initGeneratorFn = _chunkXXUM5XR7js.initGeneratorFn;

package/dist/generators.mjs

@@ -1,7 +1,7 @@
 import "./chunk-ZVRRJOP5.mjs";
 import {
   initGeneratorFn
-} from "./chunk-VHNXR7ZZ.mjs";
+} from "./chunk-QEFNN2AM.mjs";
 import "./chunk-PEM26WKS.mjs";
 import "./chunk-SHIGQSVE.mjs";
 export {

package/dist/index.js

@@ -4,7 +4,7 @@
 var _chunkDUNMCAJEjs = require('./chunk-DUNMCAJE.js');
 
 
-var _chunkRRTPMNWOjs = require('./chunk-RRTPMNWO.js');
+var _chunkXXUM5XR7js = require('./chunk-XXUM5XR7.js');
 require('./chunk-NNSWWAGP.js');
 
 
@@ -16,10 +16,10 @@ var _chunkBG73ZJERjs = require('./chunk-BG73ZJER.js');
 // index.ts
 var index_exports = {};
 _chunkBG73ZJERjs.__export.call(void 0, index_exports, {
-  initGeneratorFn: () => _chunkRRTPMNWOjs.initGeneratorFn
+  initGeneratorFn: () => _chunkXXUM5XR7js.initGeneratorFn
 });
 _chunkBG73ZJERjs.init_cjs_shims.call(void 0, );
 _chunkBG73ZJERjs.__reExport.call(void 0, index_exports, _chunkBG73ZJERjs.__toESM.call(void 0, _chunkDUNMCAJEjs.require_components.call(void 0, )));
 
 
-exports.initGeneratorFn = _chunkRRTPMNWOjs.initGeneratorFn;
+exports.initGeneratorFn = _chunkXXUM5XR7js.initGeneratorFn;

package/dist/index.mjs

@@ -4,7 +4,7 @@ import {
 } from "./chunk-NVTKHBEW.mjs";
 import {
   initGeneratorFn
-} from "./chunk-VHNXR7ZZ.mjs";
+} from "./chunk-QEFNN2AM.mjs";
 import "./chunk-PEM26WKS.mjs";
 import {
   __export,

package/dist/src/generators/init/generator.js

@@ -1,10 +1,10 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
 
-var _chunkRRTPMNWOjs = require('../../../chunk-RRTPMNWO.js');
+var _chunkXXUM5XR7js = require('../../../chunk-XXUM5XR7.js');
 require('../../../chunk-NNSWWAGP.js');
 require('../../../chunk-BG73ZJER.js');
 
 
 
-exports.default = _chunkRRTPMNWOjs.generator_default; exports.initGeneratorFn = _chunkRRTPMNWOjs.initGeneratorFn;
+exports.default = _chunkXXUM5XR7js.generator_default; exports.initGeneratorFn = _chunkXXUM5XR7js.initGeneratorFn;

package/dist/src/generators/init/generator.mjs

@@ -1,7 +1,7 @@
 import {
   generator_default,
   initGeneratorFn
-} from "../../../chunk-VHNXR7ZZ.mjs";
+} from "../../../chunk-QEFNN2AM.mjs";
 import "../../../chunk-PEM26WKS.mjs";
 import "../../../chunk-SHIGQSVE.mjs";
 export {

package/generators.ts

@@ -0,0 +1,2 @@
+export * from "./src/generators/init/generator";
+export { type InitGeneratorSchema } from "./src/generators/init/schema.d";

package/index.ts

@@ -0,0 +1,2 @@
+export * from "./generators";
+export * from "./src/components";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@storm-software/projen",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "type": "commonjs",
   "description": "Tools for managing Projen configuration automation within a Nx workspace.",
   "repository": {

package/project.json

@@ -0,0 +1,57 @@
+{
+  "name": "projen",
+  "$schema": "../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "packages/projen/src",
+  "projectType": "library",
+  "implicitDependencies": ["workspace-tools", "config-tools", "config"],
+  "targets": {
+    "build-untyped": {
+      "executor": "nx:run-commands",
+      "dependsOn": ["clean", "^build"],
+      "inputs": [
+        "{projectRoot}/src/**/untyped.ts",
+        "{projectRoot}/src/**/*.untyped.ts"
+      ],
+      "outputs": [
+        "{projectRoot}/src/**/schema.d.ts",
+        "{projectRoot}/src/**/*.schema.d.ts",
+        "{projectRoot}/src/**/schema.md",
+        "{projectRoot}/src/**/*.schema.md",
+        "{projectRoot}/src/**/schema.json",
+        "{projectRoot}/src/**/*.schema.json"
+      ],
+      "options": {
+        "commands": [
+          "node dist/packages/untyped/bin/untyped.cjs generate --entry=\"packages/projen/**/{untyped.ts,*.untyped.ts}\" "
+        ]
+      }
+    },
+    "build-base": {
+      "executor": "nx:run-commands",
+      "dependsOn": ["build-untyped", "clean", "^build"],
+      "options": {
+        "command": "tsup-node --config=tsup.config.ts",
+        "cwd": "{projectRoot}"
+      }
+    },
+    "build": {
+      "executor": "nx:run-commands",
+      "dependsOn": ["build-base", "build-untyped"],
+      "options": {
+        "commands": [
+          "pnpm copyfiles LICENSE dist/packages/projen",
+          "pnpm copyfiles --up=2 ./packages/projen/*.md ./packages/projen/executors.json ./packages/projen/generators.json ./packages/projen/package.json dist/packages/projen",
+          "pnpm copyfiles --up=3 \"./packages/projen/dist/**/*\" dist/packages/projen/dist",
+          "pnpm copyfiles --up=3 \"./packages/projen/src/**/*schema.d.ts\" dist/packages/projen/dist/src",
+          "pnpm copyfiles --up=3 \"./packages/projen/src/**/*schema.json\" dist/packages/projen/dist/src",
+          "pnpm copyfiles --up=3 \"./packages/projen/src/**/*.md\" dist/packages/projen/docs/api",
+          "pnpm copyfiles --up=4 \"./packages/projen/src/generators/*/files/**/*\" dist/packages/projen/dist/src/generators"
+        ]
+      }
+    },
+
+    "nx-release-publish": {
+      "executor": "@storm-software/workspace-tools:npm-publish"
+    }
+  }
+}

package/src/components/nx-workspace.ts

@@ -0,0 +1,659 @@
+import {
+  NX_DEFAULT_BUILD_OUTPUTS as BASE_NX_DEFAULT_BUILD_OUTPUTS,
+  NxWorkspace
+} from "@aws/pdk/monorepo/components/nx-workspace";
+import { Nx } from "@aws/pdk/monorepo/nx-types";
+import { ProjectUtils } from "@aws/pdk/monorepo/utils";
+import { asUndefinedIfEmpty } from "@aws/pdk/monorepo/utils/common";
+import { NxJsonConfiguration } from "@nx/devkit";
+import { StormWorkspaceConfig } from "@storm-software/config";
+import { joinPaths } from "@storm-software/config-tools/utilities/correct-paths";
+import { readFileSync } from "node:fs";
+import { JsonFile, Project } from "projen";
+import { Obj } from "projen/lib/util";
+
+/**
+ * Default NX outputs to cache
+ */
+export const NX_DEFAULT_BUILD_OUTPUTS: string[] = [
+  ...BASE_NX_DEFAULT_BUILD_OUTPUTS,
+  "{workspaceRoot}/dist/{projectRoot}"
+];
+
+/**
+ * Component which manages the workspace specific NX Config for the root monorepo.
+ */
+export class StormNxWorkspace extends NxWorkspace {
+  /**
+   * Retrieves the singleton instance associated with project root.
+   *
+   * @param scope project instance.
+   */
+  static override of(scope: Project): NxWorkspace | undefined {
+    return scope.root.components.find(c =>
+      ProjectUtils.isNamedInstanceOf(c, NxWorkspace)
+    ) as NxWorkspace | undefined;
+  }
+
+  /**
+   * Raw nx.json file to support overrides that aren't handled
+   * directly.
+   *
+   * **Attention:** any overrides applied here will not be visible
+   * in the properties and only included in final synthesized output,
+   * and likely to override native handling.
+   * @advanced
+   */
+  public override readonly nxJson: JsonFile;
+
+  /**
+   * Automatically infer NxProject targets based on project type.
+   * @experimental
+   */
+  public override autoInferProjectTargets = true;
+
+  /**
+   * List of cacheable operations.
+   */
+  public override cacheableOperations: string[] = [
+    "lint-sherif",
+    "lint-knip",
+    "lint-ls",
+    "lint",
+    "format-readme",
+    "format-toml",
+    "format-prettier",
+    "format",
+    "clean",
+    "build-base",
+    "build",
+    "test",
+    "e2e",
+    "docs",
+    "nx-release-publish"
+  ];
+
+  /**
+   * Some presets use the extends property to hide some default options in a separate json file.
+   * The json file specified in the extends property is located in your node_modules folder.
+   * The Nx preset files are specified in the nx package.
+   *
+   * @default "@storm-software/workspace-tools/config/base.json"
+   */
+  public override extends = "@storm-software/workspace-tools/config/base.json";
+
+  /**
+   * Plugins for extending the project graph
+   */
+  public nxPlugins: NxJsonConfiguration["plugins"] = [
+    {
+      plugin: "@nx/eslint/plugin",
+      exclude: ["packages/**/__fixtures__/**/*"],
+      options: {
+        targetName: "lint",
+        useFlatConfig: true
+      }
+    },
+    "@storm-software/workspace-tools/plugins/typescript",
+    "@storm-software/workspace-tools/plugins/typescript/untyped",
+    "@storm-software/workspace-tools/plugins/typescript/tsup"
+  ];
+
+  /**
+   * Default options for `nx affected`
+   */
+  public override affected: Nx.INxAffectedConfig = {
+    defaultBase: "main"
+  };
+
+  /**
+   * Named inputs
+   * @see https://nx.dev/reference/nx-json#inputs-&-namedinputs
+   */
+  public override namedInputs: Nx.INamedInputs = {
+    // https://nx.dev/more-concepts/customizing-inputs#defaults
+    sharedGlobals: [
+      "{workspaceRoot}/.github/**/*",
+      "{workspaceRoot}/assets/**/*",
+      "{workspaceRoot}/tsconfig.*.json",
+      "{workspaceRoot}/.npmrc",
+      "{workspaceRoot}/.npmignore",
+      "{workspaceRoot}/package.json",
+      "{workspaceRoot}/pnpm-workspace.yaml",
+      "{workspaceRoot}/pnpm-lock.yaml",
+      "{workspaceRoot}/package-lock.yaml",
+      "{workspaceRoot}/yarn-lock.yaml",
+      "{workspaceRoot}/bun.lockb",
+      "{workspaceRoot}/LICENSE",
+      "{workspaceRoot}/.gitattributes",
+      "{workspaceRoot}/.gitignore",
+      "{workspaceRoot}/nx.json",
+      "{workspaceRoot}/.nxignore",
+      "{workspaceRoot}/storm-workspace.json",
+      "{workspaceRoot}/storm-workspace.*.json",
+      "{workspaceRoot}/.storm-workspace/config.json",
+      "{workspaceRoot}/.storm-workspace/config.*.json",
+      "{workspaceRoot}/storm-workspace.yaml",
+      "{workspaceRoot}/storm-workspace.*.yaml",
+      "{workspaceRoot}/.storm-workspace/config.yaml",
+      "{workspaceRoot}/.storm-workspace/config.*.yaml",
+      "{workspaceRoot}/storm-workspace.toml",
+      "{workspaceRoot}/storm-workspace.*.toml",
+      "{workspaceRoot}/.storm-workspace/config.toml",
+      "{workspaceRoot}/.storm-workspace/config.*.toml",
+      "{workspaceRoot}/storm-workspace.config.js",
+      "{workspaceRoot}/.storm-workspace/config.js",
+      "{workspaceRoot}/.storm-workspace/config.*.js",
+      "{workspaceRoot}/storm-workspace.config.ts",
+      "{workspaceRoot}/.storm-workspace/config.ts",
+      "{workspaceRoot}/.storm-workspace/config.*.ts",
+      "{workspaceRoot}/.env",
+      "{workspaceRoot}/.env.local"
+    ],
+    default: ["sharedGlobals", "{projectRoot}/**/*"],
+    production: [
+      "{projectRoot}/**/*",
+      "!{projectRoot}/tools/**/*",
+      "!{projectRoot}/scripts/**/*",
+      "!{projectRoot}/node_modules/**/*",
+      "!{projectRoot}/api-extractor.json",
+      "!{projectRoot}/tsdoc.json",
+      "!{projectRoot}/typedoc.json",
+      "!{projectRoot}/.eslint-doc-generatorrc.js",
+      "!{projectRoot}/.eslint-doc-generatorrc.json",
+      "!{projectRoot}/.storybook/**/*",
+      "!{projectRoot}/tsconfig.storybook.json",
+      "!{projectRoot}/jest.config.ts",
+      "!{projectRoot}/tsconfig.spec.json",
+      "!{projectRoot}/src/test-setup.[jt]s",
+      "!{projectRoot}/test-setup.[jt]s",
+      "!{projectRoot}/tsconfig.spec.json",
+      "!{projectRoot}/.eslintignore",
+      "!{projectRoot}/.eslintrc.json",
+      "!{projectRoot}/.eslintrc.cjs",
+      "!{projectRoot}/eslint.config.js",
+      "!{projectRoot}/eslint.config.cjs",
+      "!{projectRoot}/eslint.config.mjs",
+      "!{projectRoot}/biome.toml",
+      "!{projectRoot}/biome.json",
+      "!{projectRoot}/lefthook.yaml",
+      "!{projectRoot}/.markdownlint.json",
+      "!{projectRoot}/.markdownlint-cli2.cjs",
+      "!{projectRoot}/.prettierrc",
+      "!{projectRoot}/.prettierignore",
+      "!{projectRoot}/docs/**/*",
+      "!{projectRoot}/**/*.stories.@(js|jsx|ts|tsx|mdx)",
+      "!{projectRoot}/benches/**/*",
+      "!{projectRoot}/e2e/**/*",
+      "!{projectRoot}/tests/**/*",
+      "!{projectRoot}/testing/**/*",
+      "!{projectRoot}/**/?(*.)+(spec|test).[jt]s?(x)?(.snap)",
+      "!{projectRoot}/tsconfig.spec.json"
+    ],
+    testing: [
+      "sharedGlobals",
+      "{workspaceRoot}/jest.config.ts",
+      "{workspaceRoot}/jest.preset.js",
+      "{workspaceRoot}/benches/**/*",
+      "{workspaceRoot}/e2e/**/*",
+      "{workspaceRoot}/tests/**/*",
+      "{workspaceRoot}/testing/**/*",
+      "{workspaceRoot}/coverage/**/*",
+      "{projectRoot}/project.json",
+      "{projectRoot}/README.md",
+      "{projectRoot}/CHANGELOG.md",
+      "{projectRoot}/.env",
+      "{projectRoot}/.env.local",
+      "{projectRoot}/jest.config.ts",
+      "{projectRoot}/tsconfig.spec.json",
+      "{projectRoot}/src/test-setup.[jt]s",
+      "{projectRoot}/test-setup.[jt]s",
+      "{projectRoot}/tsconfig.spec.json",
+      "{workspaceRoot}/jest.config.ts",
+      "{workspaceRoot}/jest.preset.js",
+      "{workspaceRoot}/benches/**/*",
+      "{workspaceRoot}/e2e/**/*",
+      "{workspaceRoot}/tests/**/*",
+      "{workspaceRoot}/testing/**/*",
+      "{workspaceRoot}/coverage/**/*",
+      "{projectRoot}/benches/**/*",
+      "{projectRoot}/e2e/**/*",
+      "{projectRoot}/tests/**/*",
+      "{projectRoot}/testing/**/*",
+      "{projectRoot}/**/?(*.)+(spec|test).[jt]s?(x)?(.snap)",
+      "{projectRoot}/tsconfig.spec.json"
+    ],
+    linting: [
+      "sharedGlobals",
+      "{workspaceRoot}/.eslintignore",
+      "{workspaceRoot}/eslintrc.json",
+      "{workspaceRoot}/.eslintrc.json",
+      "{workspaceRoot}/.eslintrc.cjs",
+      "{workspaceRoot}/eslint.config.js",
+      "{workspaceRoot}/eslint.config.cjs",
+      "{workspaceRoot}/eslint.config.mjs",
+      "{workspaceRoot}/biome.toml",
+      "{workspaceRoot}/biome.json",
+      "{workspaceRoot}/lefthook.yaml",
+      "{workspaceRoot}/.markdownlint.json",
+      "{workspaceRoot}/.markdownlint-cli2.cjs",
+      "{workspaceRoot}/.prettierrc",
+      "{workspaceRoot}/prettier.config.js",
+      "{workspaceRoot}/.prettierignore",
+      "{projectRoot}/project.json",
+      "{projectRoot}/README.md",
+      "{projectRoot}/CHANGELOG.md",
+      "{projectRoot}/.env",
+      "{projectRoot}/.env.local",
+      "{projectRoot}/.eslintignore",
+      "{projectRoot}/.eslintrc",
+      "{projectRoot}/.eslintrc.json",
+      "{projectRoot}/.eslintrc.cjs",
+      "{projectRoot}/eslint.config.js",
+      "{projectRoot}/eslint.config.cjs",
+      "{projectRoot}/eslint.config.mjs",
+      "{projectRoot}/biome.toml",
+      "{projectRoot}/biome.json",
+      "{projectRoot}/lefthook.yaml",
+      "{projectRoot}/.markdownlint.json",
+      "{projectRoot}/.markdownlint-cli2.cjs",
+      "{projectRoot}/.prettierrc",
+      "{projectRoot}/.prettierignore"
+    ],
+    documentation: [
+      "sharedGlobals",
+      "{workspaceRoot}/api-extractor.json",
+      "{workspaceRoot}/tsdoc.json",
+      "{workspaceRoot}/typedoc.json",
+      "{workspaceRoot}/.eslint-doc-generatorrc.js",
+      "{workspaceRoot}/.eslint-doc-generatorrc.json",
+      "{workspaceRoot}/contentlayer.config.ts",
+      "{workspaceRoot}/*.md",
+      "{workspaceRoot}/*.mdx",
+      "{workspaceRoot}/docs/**/*",
+      "{workspaceRoot}/.storybook/**/*",
+      "{projectRoot}/project.json",
+      "{projectRoot}/README.md",
+      "{projectRoot}/CHANGELOG.md",
+      "{projectRoot}/.env",
+      "{projectRoot}/.env.local",
+      "{projectRoot}/api-extractor.json",
+      "{projectRoot}/tsdoc.json",
+      "{projectRoot}/typedoc.json",
+      "{projectRoot}/.eslint-doc-generatorrc.js",
+      "{projectRoot}/.eslint-doc-generatorrc.json",
+      "{projectRoot}/contentlayer.config.ts",
+      "{projectRoot}/.storybook/**/*",
+      "{projectRoot}/tsconfig.storybook.json",
+      "{projectRoot}/README.md",
+      "{projectRoot}/docs/**/*",
+      "{projectRoot}/**/*.stories.@(js|jsx|ts|tsx|mdx)",
+      "!{projectRoot}/benches/**/*",
+      "!{projectRoot}/e2e/**/*",
+      "!{projectRoot}/tests/**/*",
+      "!{projectRoot}/testing/**/*",
+      "!{projectRoot}/**/?(*.)+(spec|test).[jt]s?(x)?(.snap)",
+      "!{projectRoot}/tsconfig.spec.json"
+    ],
+    rust: [
+      "sharedGlobals",
+      "{workspaceRoot}/Cargo.toml",
+      "{workspaceRoot}/Cargo.lock",
+      "{workspaceRoot}/.cargo/config.toml",
+      "{workspaceRoot}/rust-toolchain",
+      "{workspaceRoot}/rustfmt.toml",
+      "{workspaceRoot}/deny.toml",
+      "{projectRoot}/Cargo.toml",
+      "{projectRoot}/.cargo/config.toml",
+      "{projectRoot}/project.json",
+      "{projectRoot}/README.md",
+      "{projectRoot}/CHANGELOG.md",
+      "{projectRoot}/.env",
+      "{projectRoot}/.env.local",
+      "{projectRoot}/**/*.rs",
+      "{projectRoot}/**/*.proto",
+      "{projectRoot}/**/*.acid",
+      "{projectRoot}/**/*.acidic",
+      "{projectRoot}/**/*.prisma",
+      "{projectRoot}/src/**/*.json",
+      "{projectRoot}/src/**/*.jsonc",
+      "{projectRoot}/src/**/*.yaml",
+      "{projectRoot}/src/**/*.yml",
+      "{projectRoot}/src/**/*.toml",
+      "!{projectRoot}/README.md",
+      "!{projectRoot}/docs/**/*",
+      "!{projectRoot}/benches/**/*",
+      "!{projectRoot}/e2e/**/*",
+      "!{projectRoot}/tests/**/*",
+      "!{projectRoot}/testing/**/*"
+    ],
+    typescript: [
+      "sharedGlobals",
+      "!{projectRoot}/tsconfig.spec.json",
+      "!{projectRoot}/tsconfig.storybook.json",
+      "!{projectRoot}/**/?(*.)+(spec|test).[jt]s?(x)?(.snap)",
+      "!{projectRoot}/**/*.stories.@(js|jsx|ts|tsx|mdx)",
+      "!{projectRoot}/node_modules/**/*",
+      "!{projectRoot}/benches/**/*",
+      "!{projectRoot}/e2e/**/*",
+      "!{projectRoot}/tests/**/*",
+      "!{projectRoot}/testing/**/*",
+      "!{projectRoot}/**/?(*.)+(spec|test).[jt]s?(x)?(.snap)",
+      "!{projectRoot}/tsconfig.spec.json",
+      "!{projectRoot}/**/?(*.)+(spec|test).[jt]s?(x)?(.snap)",
+      "!{projectRoot}/**/*.stories.@(js|jsx|ts|tsx|mdx)",
+      "!{projectRoot}/node_modules/**/*",
+      "{projectRoot}/package.json",
+      "{projectRoot}/tsconfig.json",
+      "{projectRoot}/tsconfig.*.json",
+      "{projectRoot}/project.json",
+      "{projectRoot}/README.md",
+      "{projectRoot}/CHANGELOG.md",
+      "{projectRoot}/.env",
+      "{projectRoot}/.env.*",
+      "{projectRoot}/README.md",
+      "{projectRoot}/docs/**/*",
+      "{projectRoot}/**/*.stories.@(js|jsx|ts|tsx|mdx)",
+      "{projectRoot}/**/*.proto",
+      "{projectRoot}/**/*.acid",
+      "{projectRoot}/**/*.acidic",
+      "{projectRoot}/**/*.prisma",
+      "{projectRoot}/src/**/*.cts",
+      "{projectRoot}/src/**/*.mts",
+      "{projectRoot}/src/**/*.ts",
+      "{projectRoot}/src/**/*.tsx",
+      "{projectRoot}/src/**/*.graphql",
+      "{projectRoot}/src/**/*.gql",
+      "{projectRoot}/src/**/*.js",
+      "{projectRoot}/src/**/*.cjs",
+      "{projectRoot}/src/**/*.mjs",
+      "{projectRoot}/src/**/*.jsx",
+      "{projectRoot}/src/**/*.json",
+      "{projectRoot}/src/**/*.jsonc",
+      "{projectRoot}/src/**/*.yaml",
+      "{projectRoot}/src/**/*.yml",
+      "{projectRoot}/src/**/*.toml",
+      "{projectRoot}/src/**/*.md",
+      "{projectRoot}/src/**/*.mdx",
+      "{projectRoot}/build.*.[jt]s?(x)",
+      "{projectRoot}/tsup.*.[jt]s?(x)",
+      "{projectRoot}/contentlayer.*.[jt]s?(x)",
+      "{projectRoot}/bin/**/*",
+      "{projectRoot}/tools/**/*",
+      "{projectRoot}/helpers/**/*",
+      "{projectRoot}/scripts/**/*"
+    ]
+  };
+
+  /**
+   * Dependencies between different target names across all projects
+   *
+   * @see https://nx.dev/reference/nx-json#target-defaults
+   */
+  public override targetDefaults: Nx.ITargetDefaults = {
+    "lint-ls": {
+      outputs: ["{projectRoot}/**/*"],
+      inputs: ["linting", "default", "^production"],
+      dependsOn: ["^lint-ls"],
+      executor: "nx:run-commands",
+      options: {
+        command:
+          'pnpm exec ls-lint --config="./node_modules/@storm-software/linting-tools/ls-lint/.ls-lint.yml" ',
+        color: true
+      }
+    },
+    "lint-sherif": {
+      outputs: ["{projectRoot}/package.json"],
+      inputs: ["{workspaceRoot}/package.json", "{projectRoot}/package.json"],
+      executor: "nx:run-commands",
+      options: {
+        command: "pnpm exec sherif -i react -i react-dom -i typescript"
+      }
+    },
+    "lint-knip": {
+      inputs: ["linting", "default", "^production"],
+      executor: "nx:run-commands",
+      options: {
+        command: "pnpm exec knip"
+      }
+    },
+    lint: {
+      outputs: ["{projectRoot}"],
+      inputs: ["linting", "default", "^production"],
+      dependsOn: ["lint-ls", "lint-sherif", "lint-knip", "lint-docs", "^lint"],
+      executor: "nx:run-commands",
+      options: {
+        command: 'echo Linted the project files in "{projectRoot}" '
+      }
+    },
+    "format-toml": {
+      inputs: ["linting", "{projectRoot}/**/*.toml"],
+      outputs: ["{projectRoot}/**/*.toml"],
+      dependsOn: ["^format-toml"],
+      executor: "nx:run-commands",
+      options: {
+        command:
+          'pnpm exec taplo format --colors="always" --config="./node_modules/@storm-software/linting-tools/taplo/config.toml" --cache-path="./tmp/taplo/{projectRoot}"',
+        color: true
+      }
+    },
+    "format-readme": {
+      inputs: [
+        "linting",
+        "documentation",
+        "{projectRoot}/{README.md,package.json,Cargo.toml,executors.json,generators.json}",
+        "default",
+        "^production"
+      ],
+      outputs: ["{projectRoot}/README.md"],
+      dependsOn: ["^format-readme"],
+      executor: "nx:run-commands",
+      options: {
+        command:
+          'pnpm exec storm-git readme-gen --templates="./tools/readme-templates" --project="{projectName}"',
+        color: true
+      }
+    },
+    "format-prettier": {
+      inputs: ["linting", "default", "^production"],
+      dependsOn: ["^format-prettier"],
+      executor: "nx:run-commands",
+      options: {
+        command:
+          'pnpm exec prettier "{projectRoot}/**/*" --write --ignore-unknown --no-error-on-unmatched-pattern --config="./node_modules/@storm-software/prettier/config.json" --ignore-path="./node_modules/@storm-software/prettier/.prettierignore" --cache --cache-location="./tmp/prettier/{projectRoot}" ',
+        color: true
+      }
+    },
+    format: {
+      inputs: ["linting", "default", "^production"],
+      outputs: ["{projectRoot}"],
+      dependsOn: ["format-toml", "format-readme", "format-prettier", "^format"],
+      executor: "nx:run-commands",
+      options: {
+        command: 'echo Formatted the project files in "{projectRoot}" '
+      }
+    },
+    clean: {
+      inputs: ["default", "^production"],
+      outputs: NX_DEFAULT_BUILD_OUTPUTS,
+      dependsOn: ["^clean"],
+      executor: "nx:run-commands",
+      options: {
+        commands: [
+          "pnpm exec rimraf --glob {projectRoot}/dist",
+          "pnpm exec rimraf dist/{projectRoot}"
+        ]
+      }
+    },
+    "build-untyped": {
+      dependsOn: ["^build"]
+    },
+    "build-base": {
+      dependsOn: ["build-untyped", "^build"]
+    },
+    "build-local": {
+      inputs: ["default", "^production"],
+      dependsOn: ["build-base", "build-untyped", "^build"]
+    },
+    build: {
+      inputs: ["default", "^production"],
+      outputs: NX_DEFAULT_BUILD_OUTPUTS,
+      dependsOn: ["build-base", "build-untyped", "^build"]
+    },
+    rebuild: {
+      inputs: ["default", "^production"],
+      executor: "nx:run-commands",
+      dependsOn: ["clean", "^build"],
+      options: {
+        command: "pnpm exec nx run {projectName}:build",
+        color: true,
+        cwd: "{workspaceRoot}"
+      }
+    },
+    docs: {
+      outputs: ["{options.outputPath}"],
+      inputs: ["linting", "documentation", "default", "^production"],
+      dependsOn: ["build", "format-readme", "lint-docs", "^docs"]
+    },
+    test: {
+      inputs: ["testing", "default", "^production"],
+      dependsOn: ["build", "^test"]
+    },
+    e2e: {
+      inputs: ["testing", "default", "^production"],
+      dependsOn: ["test", "^e2e"]
+    },
+    "nx-release-publish": {
+      inputs: ["default", "^production"],
+      dependsOn: ["build", "^nx-release-publish"]
+    }
+  };
+
+  /**
+   * Configuration for Nx releases
+   */
+  public release: Obj<any> = {};
+
+  /**
+   * The number of parallel tasks to run.
+   *
+   * @defaultValue 5
+   */
+  public parallel = 5;
+
+  /**
+   * Should the daemon be used to run tasks?
+   *
+   * @defaultValue true
+   */
+  public useDaemonProcess = true;
+
+  /**
+   * Set this to false to disable adding inference plugins when generating new projects
+   *
+   * @defaultValue true
+   */
+  public useInferencePlugins = true;
+
+  /**
+   * The default base branch for new projects.
+   *
+   * @defaultValue "main"
+   */
+  public defaultBase = "main";
+
+  /**
+   * The CLI configuration for the workspace.
+   */
+  public cli: NxJsonConfiguration["cli"] | undefined;
+
+  constructor(project: Project) {
+    super(project);
+
+    let StormWorkspaceConfig!: StormWorkspaceConfig;
+    if (project.root.outdir) {
+      const StormWorkspaceConfigJson = readFileSync(
+        joinPaths(project.root.outdir, "storm-workspace.json"),
+        "utf8"
+      );
+      StormWorkspaceConfig = JSON.parse(StormWorkspaceConfigJson);
+    }
+
+    if (StormWorkspaceConfig?.namespace) {
+      this.npmScope = StormWorkspaceConfig?.namespace;
+    }
+
+    if (StormWorkspaceConfig?.branch) {
+      this.defaultBase = StormWorkspaceConfig?.branch;
+      this.affected = {
+        defaultBase: StormWorkspaceConfig?.branch
+      };
+    }
+
+    if (StormWorkspaceConfig?.packageManager) {
+      this.cli = {
+        packageManager: StormWorkspaceConfig?.packageManager
+      };
+    }
+
+    this.nxJson = new JsonFile(project, "nx.json", {
+      obj: {
+        extends: () => this.extends,
+        npmScope: () => this.npmScope,
+        affected: () => asUndefinedIfEmpty(this.affected),
+        workspaceLayout: () => asUndefinedIfEmpty(this.workspaceLayout),
+        plugins: () => asUndefinedIfEmpty(this.nxPlugins),
+        namedInputs: () => asUndefinedIfEmpty(this.namedInputs),
+        targetDefaults: () => asUndefinedIfEmpty(this.targetDefaults),
+        tasksRunnerOptions: () => asUndefinedIfEmpty(this.tasksRunnerOptions),
+        parallel: () => this.parallel,
+        useDaemonProcess: () => this.useDaemonProcess,
+        useInferencePlugins: () => this.useInferencePlugins,
+        release: () => asUndefinedIfEmpty(this.release)
+      }
+    });
+  }
+
+  /**
+   * Adds a release group to the workspace.
+   *
+   * @param name The name of the release group
+   * @param projects The projects in the release group
+   * @param projectsRelationship The relationship between the projects
+   * @param releaseTagPattern The release tag pattern
+   * @param groupPreVersionCommand The command to run before versioning
+   */
+  public addReleaseGroup(
+    name: string,
+    projects: string[] | string,
+    projectsRelationship: "fixed" | "independent" = "independent",
+    releaseTagPattern = "{projectName}@{version}",
+    groupPreVersionCommand = "pnpm build"
+  ) {
+    this.release ??= {
+      groups: {},
+      changelog: {
+        entryWhenNoChanges: false,
+        renderOptions: {
+          authors: false,
+          commitReferences: true,
+          versionTitleDate: true
+        }
+      }
+    };
+
+    this.release.groups[name] = {
+      projects,
+      projectsRelationship,
+      releaseTagPattern,
+      version: {
+        groupPreVersionCommand,
+        generator: "@storm-software/workspace-tools:release-version",
+        generatorOptions: {
+          currentVersionResolver: "git-tag",
+          specifierSource: "conventional-commits"
+        }
+      }
+    };
+  }
+}

package/src/generators/init/generator.ts

@@ -0,0 +1,53 @@
+import {
+  addDependenciesToPackageJson,
+  formatFiles,
+  GeneratorCallback,
+  readJsonFile,
+  runTasksInSerial,
+  type Tree
+} from "@nx/devkit";
+import { StormWorkspaceConfig } from "@storm-software/config";
+import {
+  initGenerator as baseInitGenerator,
+  withRunGenerator
+} from "@storm-software/workspace-tools";
+import type { InitGeneratorSchema } from "./schema";
+
+export async function initGeneratorFn(
+  tree: Tree,
+  options: InitGeneratorSchema,
+  config: StormWorkspaceConfig
+) {
+  const task = baseInitGenerator(tree, options);
+
+  await runTasksInSerial(addProjenDeps(tree, options))();
+
+  if (!options.skipFormat) {
+    await formatFiles(tree);
+  }
+
+  return task;
+}
+
+export default withRunGenerator<InitGeneratorSchema>(
+  "Initialize Storm Projen workspace",
+  initGeneratorFn
+);
+
+function addProjenDeps(
+  tree: Tree,
+  options: InitGeneratorSchema
+): GeneratorCallback {
+  return () => {
+    const packageJson = readJsonFile(`${options.directory}/package.json`);
+    packageJson.dependencies["projen"] ??= "^0.91.6";
+
+    if (packageJson) {
+      addDependenciesToPackageJson(
+        tree,
+        packageJson.dependencies || {},
+        packageJson.devDependencies || {}
+      )();
+    }
+  };
+}

package/src/generators/init/untyped.ts

@@ -0,0 +1,25 @@
+import baseGeneratorSchema from "@storm-software/workspace-tools/base/base-generator.untyped";
+import { defineUntypedSchema } from "untyped";
+
+export default defineUntypedSchema({
+  ...baseGeneratorSchema,
+  $schema: {
+    id: "InitGeneratorSchema",
+    title: "Init Generator",
+    description: "A type definition for the Projen init generator schema",
+  },
+  directory: {
+    $schema: {
+      title: "Directory",
+      type: "string",
+      description: "The directory to initialize the workspace in",
+    },
+  },
+  skipFormat: {
+    $schema: {
+      title: "Skip Format",
+      type: "boolean",
+      description: "Skip formatting the generated files",
+    },
+  },
+});

package/tsconfig.json

@@ -0,0 +1,30 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "../../dist/out-tsc",
+    "rootDir": "../..",
+    "target": "ESNext",
+    "module": "ESNext",
+    "lib": ["ESNext"],
+    "skipLibCheck": true,
+    "skipDefaultLibCheck": true,
+    "moduleResolution": "Bundler",
+    "moduleDetection": "force",
+    "types": ["node"]
+  },
+  "include": [
+    "executors.ts",
+    "generators.ts",
+    "index.ts",
+    "src/**/*.ts",
+    "src/**/*.d.ts",
+    "src/**/*.json",
+    "tsup.config.ts"
+  ],
+  "exclude": [
+    "jest.config.ts",
+    "src/generators/**/files/**/*",
+    "src/**/*.spec.ts",
+    "src/**/*.test.ts"
+  ]
+}

package/tsup.config.ts

@@ -0,0 +1,23 @@
+import { defineConfig } from "tsup";
+
+export default defineConfig([
+  {
+    name: "projen",
+    target: "node22",
+    entryPoints: [
+      "./*.ts",
+      "./src/components/*.ts",
+      "./src/executors/*/executor.ts",
+      "./src/generators/*/generator.ts",
+    ],
+    outDir: "dist",
+    format: ["cjs", "esm"],
+    platform: "node",
+    splitting: true,
+    clean: true,
+    dts: true,
+    sourcemap: false,
+    shims: true,
+    tsconfig: "./tsconfig.json",
+  },
+]);