@storm-software/workspace-tools 1.228.0 → 1.229.0

package/dist/chunk-PMDV5GKD.js

@@ -0,0 +1,240 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } }
+
+
+var _chunkHI4G4OOGjs = require('./chunk-HI4G4OOG.js');
+
+
+var _chunkNCVJPQSPjs = require('./chunk-NCVJPQSP.js');
+
+
+var _chunk3GQAWCBQjs = require('./chunk-3GQAWCBQ.js');
+
+// src/generators/preset/generator.ts
+var _devkit = require('@nx/devkit');
+var _path = require('path'); var path = _interopRequireWildcard(_path);
+async function presetGeneratorFn(tree, options) {
+  const projectRoot = ".";
+  options.description ??= `\u26A1The ${options.namespace ? options.namespace : options.name} monorepo contains utility applications, tools, and various libraries to create modern and scalable web applications.`;
+  options.namespace ??= options.organization;
+  _devkit.addProjectConfiguration.call(void 0, tree, `@${options.namespace}/${options.name}`, {
+    root: projectRoot,
+    projectType: "application",
+    targets: {
+      "local-registry": {
+        executor: "@nx/js:verdaccio",
+        options: {
+          port: 4873,
+          config: ".verdaccio/config.yml",
+          storage: "tmp/local-registry/storage"
+        }
+      }
+    }
+  });
+  _devkit.updateJson.call(void 0, tree, "package.json", (json) => {
+    json.scripts = json.scripts || {};
+    json.version = "0.0.0";
+    json.triggerEmptyDevReleaseByIncrementingThisNumber = 0;
+    json.private = true;
+    json.keywords ??= [
+      options.name,
+      options.namespace,
+      "storm",
+      "storm-stack",
+      "storm-ops",
+      "acidic",
+      "acidic-engine",
+      "cyclone-ui",
+      "rust",
+      "nx",
+      "graphql",
+      "sullivanpj",
+      "monorepo"
+    ];
+    json.homepage ??= "https://stormsoftware.com";
+    json.bugs ??= {
+      url: `https://github.com/${options.organization}/${options.name}/issues`,
+      email: "support@stormsoftware.com"
+    };
+    json.license = "Apache-2.0";
+    json.author ??= {
+      name: "Storm Software",
+      email: "contact@stormsoftware.com",
+      url: "https://stormsoftware.com"
+    };
+    json.maintainers ??= [
+      {
+        "name": "Storm Software",
+        "email": "contact@stormsoftware.com",
+        "url": "https://stormsoftware.com"
+      },
+      {
+        "name": "Pat Sullivan",
+        "email": "admin@stormsoftware.com",
+        "url": "https://patsullivan.org"
+      }
+    ];
+    json.funding ??= {
+      type: "github",
+      url: "https://github.com/sponsors/storm-software"
+    };
+    json.namespace ??= `@${options.namespace}`;
+    json.description ??= options.description;
+    options.repositoryUrl ??= `https://github.com/${options.organization}/${options.name}`;
+    json.repository ??= {
+      type: "github",
+      url: `${options.repositoryUrl}.git`
+    };
+    json.packageManager ??= "pnpm@9.15.2";
+    json.engines ??= {
+      "node": ">=20.11.0",
+      "pnpm": ">=9.15.2"
+    };
+    json.prettier = "@storm-software/prettier/config.json";
+    json.nx ??= {
+      "includedScripts": [
+        "lint-sherif",
+        "lint-knip",
+        "lint-ls",
+        "lint",
+        "format",
+        "format-sherif",
+        "format-readme",
+        "format-prettier",
+        "format-toml",
+        "commit",
+        "release"
+      ]
+    };
+    json.scripts.adr = "pnpm log4brains adr new";
+    json.scripts["adr-preview"] = "pnpm log4brains preview";
+    json.scripts.prepare = "pnpm add lefthook -w && pnpm lefthook install";
+    json.scripts.preinstall = "npx -y only-allow pnpm";
+    json.scripts["install-csb"] = "corepack enable && pnpm install --no-frozen-lockfile";
+    json.scripts.clean = "rimraf dist && rimraf --glob packages/**/dist && rimraf --glob tools/**/dist && rimraf --glob docs/**/dist && rimraf --glob apps/**/dist && rimraf --glob libs/**/dist";
+    json.scripts.nuke = "nx clear-cache && rimraf .nx/cache && rimraf .nx/workspace-data && pnpm clean && rimraf pnpm-lock.yaml && rimraf --glob packages/**/node_modules && rimraf --glob tools/**/node_modules && rimraf node_modules";
+    json.scripts.prebuild = "pnpm clean";
+    json.scripts.build = "nx affected -t build --parallel=5";
+    json.scripts["build-all"] = "nx run-many -t build --all --parallel=5";
+    json.scripts["build-prod"] = "nx run-many -t build --all --prod --parallel=5";
+    json.scripts["build-tools"] = "nx run-many -t build --projects=tools/* --parallel=5";
+    json.scripts["build-docs"] = "nx run-many -t build --projects=docs/* --parallel=5";
+    if (!options.includeApps) {
+      json.scripts["build-packages"] = "nx run-many -t build --projects=packages/* --parallel=5";
+    } else {
+      json.scripts["build-apps"] = "nx run-many -t build --projects=apps/* --parallel=5";
+      json.scripts["build-libs"] = "nx run-many -t build --projects=libs/* --parallel=5";
+      json.scripts["build-storybook"] = "storybook build -s public";
+    }
+    json.scripts.nx = "nx";
+    json.scripts.graph = "nx graph";
+    json.scripts.lint = "pnpm storm-lint all --skip-cspell --skip-alex";
+    if (options.includeApps) {
+      json.scripts.start = "nx serve";
+      json.scripts.storybook = "pnpm storybook dev -p 6006";
+    }
+    json.scripts.help = "nx help";
+    json.scripts["dep-graph"] = "nx dep-graph";
+    json.scripts["local-registry"] = `nx local-registry @${options.namespace}/${options.name}`;
+    json.scripts.e2e = "nx e2e";
+    if (options.includeApps) {
+      json.scripts.test = "nx test && pnpm test-storybook";
+      json.scripts["test-storybook"] = "pnpm test-storybook";
+    } else {
+      json.scripts.test = "nx test";
+    }
+    json.scripts.lint = "pnpm storm-lint all --skip-cspell --skip-alex";
+    json.scripts.commit = "pnpm storm-git commit";
+    json.scripts["api-extractor"] = 'pnpm storm-docs api-extractor --outputPath="docs/api-reference" --clean';
+    json.scripts.release = "pnpm storm-git release";
+    json.scripts.format = "nx format:write";
+    json.scripts["format-sherif"] = "pnpm exec sherif -f -i typescript -i react -i react-dom";
+    json.scripts["format-toml"] = 'pnpm exec taplo format --config="./node_modules/@storm-software/linting-tools/taplo/config.toml" --cache-path="./node_modules/.cache/storm/taplo"';
+    json.scripts["format-readme"] = 'pnpm storm-git readme --templates="tools/readme-templates"';
+    json.scripts["format-prettier"] = "pnpm exec prettier --write --ignore-unknown --no-error-on-unmatched-pattern --cache && git update-index";
+    json.scripts.lint = "pnpm storm-lint all --skip-cspell";
+    json.scripts["lint-knip"] = "pnpm exec knip";
+    json.scripts["lint-sherif"] = "pnpm exec sherif -i typescript -i react -i react-dom";
+    json.scripts["lint-ls"] = 'pnpm exec ls-lint --config="./node_modules/@storm-software/linting-tools/ls-lint/ls-lint.yml"';
+    json.packageManager ??= `pnpm@${_chunkHI4G4OOGjs.pnpmVersion}`;
+    json.engines = {
+      node: `>=${_chunkHI4G4OOGjs.nodeVersion}`,
+      pnpm: `>=${_chunkHI4G4OOGjs.pnpmVersion}`
+    };
+    return json;
+  });
+  _devkit.generateFiles.call(void 0, tree, path.join(__dirname, "files"), projectRoot, {
+    ...options,
+    pnpmVersion: _chunkHI4G4OOGjs.pnpmVersion,
+    nodeVersion: _chunkHI4G4OOGjs.nodeVersion
+  });
+  await _devkit.formatFiles.call(void 0, tree);
+  let dependencies = {
+    "@ls-lint/ls-lint": "2.2.3",
+    "@ltd/j-toml": "1.38.0",
+    "@nx/devkit": "^20.2.2",
+    "@nx/eslint-plugin": "^20.2.2",
+    "@nx/js": "^20.2.2",
+    "@nx/workspace": "^20.2.2",
+    "@storm-software/config": "latest",
+    "@storm-software/git-tools": "latest",
+    "@storm-software/linting-tools": "latest",
+    "@storm-software/testing-tools": "latest",
+    "@storm-software/workspace-tools": "latest",
+    "@storm-software/eslint": "latest",
+    "@storm-software/cspell": "latest",
+    "@storm-software/prettier": "latest",
+    "@taplo/cli": "0.7.0",
+    "@types/node": "^20.14.10",
+    "copyfiles": "2.4.1",
+    "eslint": "9.5.0",
+    "jest": "29.7.0",
+    "jest-environment-node": "29.7.0",
+    "knip": "5.25.2",
+    "lefthook": "1.6.18",
+    "nx": "^20.2.2",
+    "prettier": "3.3.2",
+    "prettier-plugin-prisma": "5.0.0",
+    "rimraf": "5.0.7",
+    "sherif": "0.10.0",
+    "ts-jest": "29.1.5",
+    "ts-node": "10.9.2",
+    "tslib": "2.6.3",
+    "typescript": "5.5.3",
+    "verdaccio": "5.31.1"
+  };
+  if (options.includeApps) {
+    dependencies = {
+      ...dependencies,
+      react: "latest",
+      "react-dom": "latest",
+      storybook: "latest",
+      "@storybook/addons": "latest",
+      "@nx/react": "latest",
+      "@nx/next": "latest",
+      "@nx/node": "latest",
+      "@nx/storybook": "latest",
+      "jest-environment-jsdom": "29.7.0"
+    };
+  }
+  if (options.includeRust) {
+    dependencies = {
+      ...dependencies,
+      "@monodon/rust": "1.4.0"
+    };
+  }
+  if (options.nxCloud) {
+    dependencies = {
+      ...dependencies,
+      "nx-cloud": "latest"
+    };
+  }
+  await Promise.resolve(_devkit.addDependenciesToPackageJson.call(void 0, tree, dependencies, {}, _devkit.joinPathFragments.call(void 0, projectRoot, "package.json")));
+  return null;
+}
+_chunk3GQAWCBQjs.__name.call(void 0, presetGeneratorFn, "presetGeneratorFn");
+var generator_default = _chunkNCVJPQSPjs.withRunGenerator.call(void 0, "Storm Workspace Preset Generator", presetGeneratorFn);
+
+
+
+
+exports.presetGeneratorFn = presetGeneratorFn; exports.generator_default = generator_default;

package/dist/chunk-PS2NPPRM.mjs

@@ -0,0 +1,267 @@
+import {
+  pnpmCatalogUpdate
+} from "./chunk-DLQLZTCZ.mjs";
+import {
+  joinPaths
+} from "./chunk-PVTEDLBL.mjs";
+import {
+  __name
+} from "./chunk-XUV4U54K.mjs";
+
+// src/executors/npm-publish/executor.ts
+import { execSync } from "node:child_process";
+import fs from "node:fs/promises";
+var LARGE_BUFFER = 1024 * 1e6;
+async function npmPublishExecutorFn(options, context) {
+  const isDryRun = process.env.NX_DRY_RUN === "true" || options.dryRun || false;
+  if (!context.projectName) {
+    throw new Error("The `npm-publish` executor requires a `projectName`.");
+  }
+  const projectConfig = context.projectsConfigurations?.projects?.[context.projectName];
+  if (!projectConfig) {
+    throw new Error(`Could not find project configuration for \`${context.projectName}\``);
+  }
+  const packageRoot = joinPaths(context.root, options.packageRoot || joinPaths("dist", projectConfig.root));
+  const packageJsonPath = joinPaths(packageRoot, "package.json");
+  const packageJsonFile = await fs.readFile(packageJsonPath, "utf8");
+  if (!packageJsonFile) {
+    throw new Error(`Could not find \`package.json\` at ${packageJsonPath}`);
+  }
+  const packageJson = JSON.parse(packageJsonFile);
+  const packageName = packageJson.name;
+  console.info(`\u{1F680}  Running Storm NPM Publish executor on the ${packageName} package`);
+  const packageTxt = packageName === context.projectName ? `package "${packageName}"` : `package "${packageName}" from project "${context.projectName}"`;
+  if (packageJson.private === true) {
+    console.warn(`Skipped ${packageTxt}, because it has \`"private": true\` in ${packageJsonPath}`);
+    return {
+      success: true
+    };
+  }
+  await pnpmCatalogUpdate(packageRoot, context.root);
+  const npmPublishCommandSegments = [
+    `npm publish --json`
+  ];
+  const npmViewCommandSegments = [
+    `npm view ${packageName} versions dist-tags --json`
+  ];
+  const registry = options.registry ? options.registry : execSync("npm config get registry", {
+    cwd: packageRoot,
+    env: {
+      ...process.env,
+      FORCE_COLOR: "true"
+    },
+    maxBuffer: LARGE_BUFFER,
+    killSignal: "SIGTERM"
+  }).toString().trim();
+  if (registry) {
+    npmPublishCommandSegments.push(`--registry="${registry}" `);
+    npmViewCommandSegments.push(`--registry="${registry}" `);
+  }
+  if (options.otp) {
+    npmPublishCommandSegments.push(`--otp="${options.otp}" `);
+  }
+  if (isDryRun) {
+    npmPublishCommandSegments.push("--dry-run");
+  }
+  npmPublishCommandSegments.push("--provenance --access=public ");
+  const tag = options.tag || execSync("npm config get tag", {
+    cwd: packageRoot,
+    env: {
+      ...process.env,
+      FORCE_COLOR: "true"
+    },
+    maxBuffer: LARGE_BUFFER,
+    killSignal: "SIGTERM"
+  }).toString().trim();
+  if (tag) {
+    npmPublishCommandSegments.push(`--tag="${tag}" `);
+  }
+  if (!isDryRun) {
+    const currentVersion = packageJson.version;
+    try {
+      try {
+        const result = execSync(npmViewCommandSegments.join(" "), {
+          cwd: packageRoot,
+          env: {
+            ...process.env,
+            FORCE_COLOR: "true"
+          },
+          maxBuffer: LARGE_BUFFER,
+          killSignal: "SIGTERM"
+        });
+        const resultJson = JSON.parse(result.toString());
+        const distTags = resultJson["dist-tags"] || {};
+        if (distTags[tag] === currentVersion) {
+          console.warn(`Skipped ${packageTxt} because v${currentVersion} already exists in ${registry} with tag "${tag}"`);
+          return {
+            success: true
+          };
+        }
+      } catch (err) {
+        console.warn("\n ********************** \n");
+        console.warn(`An error occurred while checking for existing dist-tags
+${JSON.stringify(err)}
+
+Note: If this is the first time this package has been published to NPM, this can be ignored.
+
+`);
+        console.info("");
+      }
+      try {
+        if (!isDryRun) {
+          const command = `npm dist-tag add ${packageName}@${currentVersion} ${tag} --registry="${registry}" `;
+          console.info(`Adding the dist-tag ${tag} - preparing to run the following:
+${command}
+`);
+          const result = execSync(command, {
+            cwd: packageRoot,
+            env: {
+              ...process.env,
+              FORCE_COLOR: "true"
+            },
+            maxBuffer: LARGE_BUFFER,
+            killSignal: "SIGTERM"
+          });
+          console.info(`Added the dist-tag ${tag} to v${currentVersion} for registry "${registry}"
+
+Execution response: ${result.toString()}
+`);
+        } else {
+          console.info(`Would add the dist-tag ${tag} to v${currentVersion} for registry "${registry}", but [dry-run] was set.
+`);
+        }
+        return {
+          success: true
+        };
+      } catch (err) {
+        try {
+          console.warn("\n ********************** \n");
+          let error = err;
+          if (Buffer.isBuffer(error)) {
+            error = error.toString();
+          }
+          console.warn(`An error occurred while adding dist-tags:
+${error}
+
+Note: If this is the first time this package has been published to NPM, this can be ignored.
+
+`);
+          console.info("");
+          const stdoutData = JSON.parse(err.stdout?.toString() || "{}");
+          if (stdoutData?.error && !(stdoutData.error?.code?.includes("E404") && stdoutData.error?.summary?.includes("no such package available")) && !(err.stderr?.toString().includes("E404") && err.stderr?.toString().includes("no such package available"))) {
+            console.error("npm dist-tag add error please see below for more information:");
+            if (stdoutData.error.summary) {
+              console.error(stdoutData.error?.summary);
+            }
+            if (stdoutData.error.detail) {
+              console.error(stdoutData.error?.detail);
+            }
+            if (context.isVerbose) {
+              console.error(`npm dist-tag add stdout: ${JSON.stringify(stdoutData, null, 2)}`);
+            }
+            return {
+              success: false
+            };
+          }
+        } catch (err2) {
+          console.error(`Something unexpected went wrong when processing the npm dist-tag add output
+${JSON.stringify(err2)}`);
+          return {
+            success: false
+          };
+        }
+      }
+    } catch (err) {
+      let error = err;
+      if (Buffer.isBuffer(error)) {
+        error = error.toString();
+      }
+      console.error("\n ********************** \n");
+      console.info("");
+      console.error("An error occured trying to run the npm dist-tag add command.");
+      console.error(error);
+      console.info("");
+      const stdoutData = JSON.parse(err.stdout?.toString() || "{}");
+      if (!(stdoutData.error?.code?.includes("E404") && stdoutData.error?.summary?.toLowerCase().includes("not found")) && !(err.stderr?.toString().includes("E404") && err.stderr?.toString().toLowerCase().includes("not found"))) {
+        console.error(`Something unexpected went wrong when checking for existing dist-tags.
+
+Error: ${JSON.stringify(err)}
+`);
+        return {
+          success: false
+        };
+      }
+    }
+  }
+  try {
+    const cwd = packageRoot;
+    const command = npmPublishCommandSegments.join(" ");
+    console.info(`Running publish command "${command}" in current working directory: "${cwd}" `);
+    const result = execSync(command, {
+      cwd,
+      env: {
+        ...process.env,
+        FORCE_COLOR: "true"
+      },
+      maxBuffer: LARGE_BUFFER,
+      killSignal: "SIGTERM"
+    });
+    if (isDryRun) {
+      console.info(`Would publish to ${registry} with tag "${tag}", but [dry-run] was set ${result ? `
+
+Execution response: ${result.toString()}` : ""}
+`);
+    } else {
+      console.info(`Published to ${registry} with tag "${tag}" ${result ? `
+
+Execution response: ${result.toString()}` : ""}
+`);
+    }
+    return {
+      success: true
+    };
+  } catch (err) {
+    try {
+      console.error("\n ********************** \n");
+      console.info("");
+      console.error("An error occured running pnpm publish.");
+      console.error("Please see below for more information:");
+      console.info("");
+      const stdoutData = JSON.parse(err.stdout?.toString() || "{}");
+      if (stdoutData.error.summary) {
+        console.error(stdoutData.error.summary);
+        console.error(stdoutData.error.summary);
+      }
+      if (stdoutData.error.detail) {
+        console.error(stdoutData.error.detail);
+      }
+      if (context.isVerbose) {
+        console.error(`npm publish stdout:
+${JSON.stringify(stdoutData, null, 2)}`);
+      }
+      console.error("\n ********************** \n");
+      return {
+        success: false
+      };
+    } catch (err2) {
+      let error = err2;
+      if (Buffer.isBuffer(error)) {
+        error = error.toString();
+      }
+      console.error(`Something unexpected went wrong when processing the npm publish output
+
+Error: ${JSON.stringify(error)}
+`);
+      console.error("\n ********************** \n");
+      return {
+        success: false
+      };
+    }
+  }
+}
+__name(npmPublishExecutorFn, "npmPublishExecutorFn");
+
+export {
+  LARGE_BUFFER,
+  npmPublishExecutorFn
+};

package/dist/chunk-PS55UN6T.mjs

@@ -0,0 +1,59 @@
+import {
+  normalizeOptions,
+  typeScriptLibraryGeneratorFn
+} from "./chunk-XSRDTQ5C.mjs";
+import {
+  withRunGenerator
+} from "./chunk-B3KIYNGT.mjs";
+import {
+  __dirname,
+  __name
+} from "./chunk-XUV4U54K.mjs";
+
+// src/generators/neutral-library/generator.ts
+import { formatFiles, generateFiles, joinPathFragments, names, offsetFromRoot } from "@nx/devkit";
+async function neutralLibraryGeneratorFn(tree, schema, config) {
+  const filesDir = joinPathFragments(__dirname, "./files");
+  const tsLibraryGeneratorOptions = {
+    ...schema,
+    platform: "neutral",
+    devDependencies: {},
+    buildExecutor: "@storm-software/workspace-tools:unbuild"
+  };
+  const options = await normalizeOptions(tree, tsLibraryGeneratorOptions);
+  const { className, name, propertyName } = names(options.projectNames.projectFileName);
+  generateFiles(tree, filesDir, options.projectRoot, {
+    ...schema,
+    dot: ".",
+    className,
+    name,
+    namespace: process.env.STORM_NAMESPACE ?? "storm-software",
+    description: schema.description ?? "",
+    propertyName,
+    js: !!options.js,
+    cliCommand: "nx",
+    strict: void 0,
+    tmpl: "",
+    offsetFromRoot: offsetFromRoot(options.projectRoot),
+    buildable: options.bundler && options.bundler !== "none",
+    hasUnitTestRunner: options.unitTestRunner !== "none"
+  });
+  await typeScriptLibraryGeneratorFn(tree, tsLibraryGeneratorOptions, config);
+  await formatFiles(tree);
+  return null;
+}
+__name(neutralLibraryGeneratorFn, "neutralLibraryGeneratorFn");
+var generator_default = withRunGenerator("TypeScript Library Creator (Neutral Platform)", neutralLibraryGeneratorFn, {
+  hooks: {
+    applyDefaultOptions: /* @__PURE__ */ __name((options) => {
+      options.description ??= "A library used by Storm Software to support either browser or NodeJs applications";
+      options.platform = "neutral";
+      return options;
+    }, "applyDefaultOptions")
+  }
+});
+
+export {
+  neutralLibraryGeneratorFn,
+  generator_default
+};

package/dist/chunk-PVTEDLBL.mjs

@@ -0,0 +1,26 @@
+import {
+  __name
+} from "./chunk-XUV4U54K.mjs";
+
+// ../config-tools/src/utilities/correct-paths.ts
+import { joinPathFragments } from "@nx/devkit";
+var correctPaths = /* @__PURE__ */ __name((path) => {
+  if (!path) {
+    return "";
+  }
+  if (!path.toUpperCase().startsWith("C:") && path.includes("\\")) {
+    path = `C:${path}`;
+  }
+  return path.replaceAll("\\", "/");
+}, "correctPaths");
+var joinPaths = /* @__PURE__ */ __name((...paths) => {
+  if (!paths || paths.length === 0) {
+    return "";
+  }
+  return correctPaths(joinPathFragments(...paths.map((path) => correctPaths(path))));
+}, "joinPaths");
+
+export {
+  correctPaths,
+  joinPaths
+};