@storm-software/testing-tools 1.112.1 → 1.113.0

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-1.111.17-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-1.112.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 -->

package/dist/index.cjs

@@ -1,6 +1,8 @@
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -14,30 +16,146 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  getJestConfig: () => getJestConfig
+  declarePackage: () => declarePackage,
+  declarePreset: () => declarePreset,
+  declareWorkspace: () => declareWorkspace
 });
 module.exports = __toCommonJS(index_exports);
 
-// src/jest/config/package.ts
+// src/jest/declare-package.ts
 var import_node_path = require("path");
-function getJestConfig(projectDir, isNode = true, displayName) {
+function declarePackage(options) {
   return {
-    displayName: displayName ? displayName : projectDir.replaceAll("\\", "-").replaceAll("/", "-"),
+    displayName: options.displayName ? options.displayName : options.projectRoot.replaceAll("\\", "-").replaceAll("/", "-"),
     preset: "@storm-software/testing-tools/jest/preset",
-    testEnvironment: isNode ? "node" : "jsdom",
+    testEnvironment: options.isNode ? "node" : "jsdom",
     transform: {
       "^.+\\.[tj]s$": ["ts-jest", { tsconfig: "<rootDir>/tsconfig.spec.json" }]
     },
     moduleFileExtensions: ["ts", "js", "html"],
-    coverageDirectory: (0, import_node_path.join)("../../coverage", projectDir)
+    coverageDirectory: (0, import_node_path.join)("<rootDir>/coverage", options.projectRoot)
   };
 }
+
+// src/jest/declare-preset.ts
+var import_preset = __toESM(require("@nx/jest/preset"), 1);
+var import_defu = __toESM(require("defu"), 1);
+function declarePreset(config = {}) {
+  return (0, import_defu.default)(
+    config,
+    {
+      collectCoverage: true,
+      testTimeout: 3e4,
+      clearMocks: true,
+      testMatch: ["**/+(*.)+(spec|test).+(ts|js)?(x)"],
+      transform: {
+        "^.+\\.(ts|js|mts|mjs|cts|cjs|html)$": [
+          "ts-jest",
+          { tsconfig: "<rootDir>/tsconfig.spec.json" }
+        ]
+      },
+      snapshotFormat: {
+        printBasicPrototype: false
+      },
+      globals: {
+        "ts-jest": {
+          isolatedModules: true,
+          diagnostics: {
+            exclude: ["**"]
+          }
+        }
+      },
+      moduleFileExtensions: ["ts", "js", "html"],
+      coverageReporters: [
+        "json",
+        "lcov",
+        "text",
+        "clover",
+        "text-summary",
+        "html"
+      ],
+      maxWorkers: 1
+    },
+    import_preset.default ?? {}
+  );
+}
+
+// src/jest/declare-workspace.ts
+var import_jest = require("@nx/jest");
+var import_defu2 = __toESM(require("defu"), 1);
+function declareWorkspace(config = {}) {
+  return async () => (0, import_defu2.default)(config, {
+    /**
+     * When the projects configuration is provided with an array of paths or glob patterns, Jest will run tests in all of the specified projects at the same time.
+     * This is great for monorepos or when working on multiple projects at the same time.
+     */
+    projects: [...await (0, import_jest.getJestProjectsAsync)(), "<rootDir>/jest.config.ts"],
+    /**
+     * Indicates whether the coverage information should be collected while executing the test. Because this retrofits all
+     * executed files with coverage collection statements, it may significantly slow down your tests. Default: false
+     */
+    collectCoverage: process.env.CI ? true : false,
+    /**
+     * An array of glob patterns indicating a set of files for which coverage information should be collected.
+     * If a file matches the specified glob pattern, coverage information will be collected for it even if no tests exist
+     * for this file and it's never required in the test suite. Default: undefined
+     */
+    // collectCoverageFrom: ["**/*(!*.spec).tsx", "**/*(!*.spec).ts"],
+    /**
+     * The directory where Jest should output its coverage files. Default: undefined
+     */
+    coverageDirectory: "<rootDir>/coverage",
+    /**
+     * An array of regexp pattern strings that are matched against all file paths before executing the test. If the file path
+     * matches any of the patterns, coverage information will be skipped.
+     */
+    coveragePathIgnorePatterns: [
+      "\\.spec\\.ts$",
+      "\\.test\\.ts$",
+      "<rootDir>/dist",
+      "<rootDir>/tests",
+      "<rootDir>/__generated__",
+      "<rootDir>/node_modules"
+    ],
+    /**
+     * The test environment that will be used for testing. The default environment in Jest is a Node.js environment.
+     * If you are building a web app, you can use a browser-like environment through jsdom instead.
+     */
+    testEnvironment: "jest-environment-jsdom",
+    /**
+     * A list of reporter names that Jest uses when writing coverage reports. Any istanbul reporter can be used.
+     * Default: ["json", "lcov", "text"]
+     */
+    coverageReporters: ["lcov", "json"],
+    /**
+     * Setup files that run before each test suite.
+     *
+     * @remarks
+     * This is useful for setting up global variables or configurations that your tests need.
+     */
+    setupFiles: ["./node_modules/@storm-software/testing-tools/jest/setup"],
+    moduleNameMapper: {
+      "\\.(jpg|jpeg|png|gif|eot|otf|webp|svg|ttf|woff|woff2|mp4|webm|wav|mp3|m4a|aac|oga)$": "@storm-software/testing-tools/jest/__mocks__/file.mock.js",
+      "\\.(css|less)$": "@storm-software/testing-tools/jest/__mocks__/style.mock.js"
+    }
+  });
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  getJestConfig
+  declarePackage,
+  declarePreset,
+  declareWorkspace
 });

package/dist/index.d.cts

@@ -1,2 +1,4 @@
-export { getJestConfig } from './jest/config/package.cjs';
+export { DeclarePackageConfigOptions, declarePackage } from './jest/declare-package.cjs';
+export { declarePreset } from './jest/declare-preset.cjs';
+export { declareWorkspace } from './jest/declare-workspace.cjs';
 import 'jest';

package/dist/index.d.ts

@@ -1,2 +1,4 @@
-export { getJestConfig } from './jest/config/package.js';
+export { DeclarePackageConfigOptions, declarePackage } from './jest/declare-package.js';
+export { declarePreset } from './jest/declare-preset.js';
+export { declareWorkspace } from './jest/declare-workspace.js';
 import 'jest';

package/dist/index.js

@@ -1,17 +1,123 @@
-// src/jest/config/package.ts
+// src/jest/declare-package.ts
 import { join } from "node:path";
-function getJestConfig(projectDir, isNode = true, displayName) {
+function declarePackage(options) {
   return {
-    displayName: displayName ? displayName : projectDir.replaceAll("\\", "-").replaceAll("/", "-"),
+    displayName: options.displayName ? options.displayName : options.projectRoot.replaceAll("\\", "-").replaceAll("/", "-"),
     preset: "@storm-software/testing-tools/jest/preset",
-    testEnvironment: isNode ? "node" : "jsdom",
+    testEnvironment: options.isNode ? "node" : "jsdom",
     transform: {
       "^.+\\.[tj]s$": ["ts-jest", { tsconfig: "<rootDir>/tsconfig.spec.json" }]
     },
     moduleFileExtensions: ["ts", "js", "html"],
-    coverageDirectory: join("../../coverage", projectDir)
+    coverageDirectory: join("<rootDir>/coverage", options.projectRoot)
   };
 }
+
+// src/jest/declare-preset.ts
+import nxPreset from "@nx/jest/preset";
+import defu from "defu";
+function declarePreset(config = {}) {
+  return defu(
+    config,
+    {
+      collectCoverage: true,
+      testTimeout: 3e4,
+      clearMocks: true,
+      testMatch: ["**/+(*.)+(spec|test).+(ts|js)?(x)"],
+      transform: {
+        "^.+\\.(ts|js|mts|mjs|cts|cjs|html)$": [
+          "ts-jest",
+          { tsconfig: "<rootDir>/tsconfig.spec.json" }
+        ]
+      },
+      snapshotFormat: {
+        printBasicPrototype: false
+      },
+      globals: {
+        "ts-jest": {
+          isolatedModules: true,
+          diagnostics: {
+            exclude: ["**"]
+          }
+        }
+      },
+      moduleFileExtensions: ["ts", "js", "html"],
+      coverageReporters: [
+        "json",
+        "lcov",
+        "text",
+        "clover",
+        "text-summary",
+        "html"
+      ],
+      maxWorkers: 1
+    },
+    nxPreset ?? {}
+  );
+}
+
+// src/jest/declare-workspace.ts
+import { getJestProjectsAsync } from "@nx/jest";
+import defu2 from "defu";
+function declareWorkspace(config = {}) {
+  return async () => defu2(config, {
+    /**
+     * When the projects configuration is provided with an array of paths or glob patterns, Jest will run tests in all of the specified projects at the same time.
+     * This is great for monorepos or when working on multiple projects at the same time.
+     */
+    projects: [...await getJestProjectsAsync(), "<rootDir>/jest.config.ts"],
+    /**
+     * Indicates whether the coverage information should be collected while executing the test. Because this retrofits all
+     * executed files with coverage collection statements, it may significantly slow down your tests. Default: false
+     */
+    collectCoverage: process.env.CI ? true : false,
+    /**
+     * An array of glob patterns indicating a set of files for which coverage information should be collected.
+     * If a file matches the specified glob pattern, coverage information will be collected for it even if no tests exist
+     * for this file and it's never required in the test suite. Default: undefined
+     */
+    // collectCoverageFrom: ["**/*(!*.spec).tsx", "**/*(!*.spec).ts"],
+    /**
+     * The directory where Jest should output its coverage files. Default: undefined
+     */
+    coverageDirectory: "<rootDir>/coverage",
+    /**
+     * An array of regexp pattern strings that are matched against all file paths before executing the test. If the file path
+     * matches any of the patterns, coverage information will be skipped.
+     */
+    coveragePathIgnorePatterns: [
+      "\\.spec\\.ts$",
+      "\\.test\\.ts$",
+      "<rootDir>/dist",
+      "<rootDir>/tests",
+      "<rootDir>/__generated__",
+      "<rootDir>/node_modules"
+    ],
+    /**
+     * The test environment that will be used for testing. The default environment in Jest is a Node.js environment.
+     * If you are building a web app, you can use a browser-like environment through jsdom instead.
+     */
+    testEnvironment: "jest-environment-jsdom",
+    /**
+     * A list of reporter names that Jest uses when writing coverage reports. Any istanbul reporter can be used.
+     * Default: ["json", "lcov", "text"]
+     */
+    coverageReporters: ["lcov", "json"],
+    /**
+     * Setup files that run before each test suite.
+     *
+     * @remarks
+     * This is useful for setting up global variables or configurations that your tests need.
+     */
+    setupFiles: ["./node_modules/@storm-software/testing-tools/jest/setup"],
+    moduleNameMapper: {
+      "\\.(jpg|jpeg|png|gif|eot|otf|webp|svg|ttf|woff|woff2|mp4|webm|wav|mp3|m4a|aac|oga)$": "@storm-software/testing-tools/jest/__mocks__/file.mock.js",
+      "\\.(css|less)$": "@storm-software/testing-tools/jest/__mocks__/style.mock.js"
+    }
+  });
+}
 export {
-  getJestConfig
+  declarePackage,
+  declarePreset,
+  declareWorkspace
 };

package/dist/jest/{config/package.cjs → declare-package.cjs}

@@ -16,26 +16,26 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/jest/config/package.ts
-var package_exports = {};
-__export(package_exports, {
-  getJestConfig: () => getJestConfig
+// src/jest/declare-package.ts
+var declare_package_exports = {};
+__export(declare_package_exports, {
+  declarePackage: () => declarePackage
 });
-module.exports = __toCommonJS(package_exports);
+module.exports = __toCommonJS(declare_package_exports);
 var import_node_path = require("path");
-function getJestConfig(projectDir, isNode = true, displayName) {
+function declarePackage(options) {
   return {
-    displayName: displayName ? displayName : projectDir.replaceAll("\\", "-").replaceAll("/", "-"),
+    displayName: options.displayName ? options.displayName : options.projectRoot.replaceAll("\\", "-").replaceAll("/", "-"),
     preset: "@storm-software/testing-tools/jest/preset",
-    testEnvironment: isNode ? "node" : "jsdom",
+    testEnvironment: options.isNode ? "node" : "jsdom",
     transform: {
       "^.+\\.[tj]s$": ["ts-jest", { tsconfig: "<rootDir>/tsconfig.spec.json" }]
     },
     moduleFileExtensions: ["ts", "js", "html"],
-    coverageDirectory: (0, import_node_path.join)("../../coverage", projectDir)
+    coverageDirectory: (0, import_node_path.join)("<rootDir>/coverage", options.projectRoot)
   };
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  getJestConfig
+  declarePackage
 });

package/dist/jest/declare-package.d.cts

@@ -0,0 +1,18 @@
+import { Config } from 'jest';
+
+type DeclarePackageConfigOptions = Config & {
+    projectRoot: string;
+    isNode?: boolean;
+    displayName?: string;
+};
+/**
+ * Config for Jest unit tests
+ *
+ * @remarks Please see [the Jest documentation](https://jestjs.io/docs/configuration#projects-arraystring--projectconfig) for more information.
+ *
+ * @param options The options for the Jest configuration
+ * @returns The Jest configuration
+ */
+declare function declarePackage(options: DeclarePackageConfigOptions): Config;
+
+export { type DeclarePackageConfigOptions, declarePackage };

package/dist/jest/declare-package.d.ts

@@ -0,0 +1,18 @@
+import { Config } from 'jest';
+
+type DeclarePackageConfigOptions = Config & {
+    projectRoot: string;
+    isNode?: boolean;
+    displayName?: string;
+};
+/**
+ * Config for Jest unit tests
+ *
+ * @remarks Please see [the Jest documentation](https://jestjs.io/docs/configuration#projects-arraystring--projectconfig) for more information.
+ *
+ * @param options The options for the Jest configuration
+ * @returns The Jest configuration
+ */
+declare function declarePackage(options: DeclarePackageConfigOptions): Config;
+
+export { type DeclarePackageConfigOptions, declarePackage };

package/dist/jest/declare-package.js

@@ -0,0 +1,17 @@
+// src/jest/declare-package.ts
+import { join } from "node:path";
+function declarePackage(options) {
+  return {
+    displayName: options.displayName ? options.displayName : options.projectRoot.replaceAll("\\", "-").replaceAll("/", "-"),
+    preset: "@storm-software/testing-tools/jest/preset",
+    testEnvironment: options.isNode ? "node" : "jsdom",
+    transform: {
+      "^.+\\.[tj]s$": ["ts-jest", { tsconfig: "<rootDir>/tsconfig.spec.json" }]
+    },
+    moduleFileExtensions: ["ts", "js", "html"],
+    coverageDirectory: join("<rootDir>/coverage", options.projectRoot)
+  };
+}
+export {
+  declarePackage
+};

package/dist/jest/declare-preset.cjs

@@ -0,0 +1,79 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/jest/declare-preset.ts
+var declare_preset_exports = {};
+__export(declare_preset_exports, {
+  declarePreset: () => declarePreset
+});
+module.exports = __toCommonJS(declare_preset_exports);
+var import_preset = __toESM(require("@nx/jest/preset"), 1);
+var import_defu = __toESM(require("defu"), 1);
+function declarePreset(config = {}) {
+  return (0, import_defu.default)(
+    config,
+    {
+      collectCoverage: true,
+      testTimeout: 3e4,
+      clearMocks: true,
+      testMatch: ["**/+(*.)+(spec|test).+(ts|js)?(x)"],
+      transform: {
+        "^.+\\.(ts|js|mts|mjs|cts|cjs|html)$": [
+          "ts-jest",
+          { tsconfig: "<rootDir>/tsconfig.spec.json" }
+        ]
+      },
+      snapshotFormat: {
+        printBasicPrototype: false
+      },
+      globals: {
+        "ts-jest": {
+          isolatedModules: true,
+          diagnostics: {
+            exclude: ["**"]
+          }
+        }
+      },
+      moduleFileExtensions: ["ts", "js", "html"],
+      coverageReporters: [
+        "json",
+        "lcov",
+        "text",
+        "clover",
+        "text-summary",
+        "html"
+      ],
+      maxWorkers: 1
+    },
+    import_preset.default ?? {}
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  declarePreset
+});

package/dist/jest/declare-preset.d.cts

@@ -0,0 +1,5 @@
+import { Config } from 'jest';
+
+declare function declarePreset(config?: Partial<Config>): Config;
+
+export { declarePreset };

package/dist/jest/declare-preset.d.ts

@@ -0,0 +1,5 @@
+import { Config } from 'jest';
+
+declare function declarePreset(config?: Partial<Config>): Config;
+
+export { declarePreset };

package/dist/jest/declare-preset.js

@@ -0,0 +1,45 @@
+// src/jest/declare-preset.ts
+import nxPreset from "@nx/jest/preset";
+import defu from "defu";
+function declarePreset(config = {}) {
+  return defu(
+    config,
+    {
+      collectCoverage: true,
+      testTimeout: 3e4,
+      clearMocks: true,
+      testMatch: ["**/+(*.)+(spec|test).+(ts|js)?(x)"],
+      transform: {
+        "^.+\\.(ts|js|mts|mjs|cts|cjs|html)$": [
+          "ts-jest",
+          { tsconfig: "<rootDir>/tsconfig.spec.json" }
+        ]
+      },
+      snapshotFormat: {
+        printBasicPrototype: false
+      },
+      globals: {
+        "ts-jest": {
+          isolatedModules: true,
+          diagnostics: {
+            exclude: ["**"]
+          }
+        }
+      },
+      moduleFileExtensions: ["ts", "js", "html"],
+      coverageReporters: [
+        "json",
+        "lcov",
+        "text",
+        "clover",
+        "text-summary",
+        "html"
+      ],
+      maxWorkers: 1
+    },
+    nxPreset ?? {}
+  );
+}
+export {
+  declarePreset
+};

package/dist/jest/declare-workspace.cjs

@@ -0,0 +1,97 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/jest/declare-workspace.ts
+var declare_workspace_exports = {};
+__export(declare_workspace_exports, {
+  declareWorkspace: () => declareWorkspace
+});
+module.exports = __toCommonJS(declare_workspace_exports);
+var import_jest = require("@nx/jest");
+var import_defu = __toESM(require("defu"), 1);
+function declareWorkspace(config = {}) {
+  return async () => (0, import_defu.default)(config, {
+    /**
+     * When the projects configuration is provided with an array of paths or glob patterns, Jest will run tests in all of the specified projects at the same time.
+     * This is great for monorepos or when working on multiple projects at the same time.
+     */
+    projects: [...await (0, import_jest.getJestProjectsAsync)(), "<rootDir>/jest.config.ts"],
+    /**
+     * Indicates whether the coverage information should be collected while executing the test. Because this retrofits all
+     * executed files with coverage collection statements, it may significantly slow down your tests. Default: false
+     */
+    collectCoverage: process.env.CI ? true : false,
+    /**
+     * An array of glob patterns indicating a set of files for which coverage information should be collected.
+     * If a file matches the specified glob pattern, coverage information will be collected for it even if no tests exist
+     * for this file and it's never required in the test suite. Default: undefined
+     */
+    // collectCoverageFrom: ["**/*(!*.spec).tsx", "**/*(!*.spec).ts"],
+    /**
+     * The directory where Jest should output its coverage files. Default: undefined
+     */
+    coverageDirectory: "<rootDir>/coverage",
+    /**
+     * An array of regexp pattern strings that are matched against all file paths before executing the test. If the file path
+     * matches any of the patterns, coverage information will be skipped.
+     */
+    coveragePathIgnorePatterns: [
+      "\\.spec\\.ts$",
+      "\\.test\\.ts$",
+      "<rootDir>/dist",
+      "<rootDir>/tests",
+      "<rootDir>/__generated__",
+      "<rootDir>/node_modules"
+    ],
+    /**
+     * The test environment that will be used for testing. The default environment in Jest is a Node.js environment.
+     * If you are building a web app, you can use a browser-like environment through jsdom instead.
+     */
+    testEnvironment: "jest-environment-jsdom",
+    /**
+     * A list of reporter names that Jest uses when writing coverage reports. Any istanbul reporter can be used.
+     * Default: ["json", "lcov", "text"]
+     */
+    coverageReporters: ["lcov", "json"],
+    /**
+     * Setup files that run before each test suite.
+     *
+     * @remarks
+     * This is useful for setting up global variables or configurations that your tests need.
+     */
+    setupFiles: ["./node_modules/@storm-software/testing-tools/jest/setup"],
+    moduleNameMapper: {
+      "\\.(jpg|jpeg|png|gif|eot|otf|webp|svg|ttf|woff|woff2|mp4|webm|wav|mp3|m4a|aac|oga)$": "@storm-software/testing-tools/jest/__mocks__/file.mock.js",
+      "\\.(css|less)$": "@storm-software/testing-tools/jest/__mocks__/style.mock.js"
+    }
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  declareWorkspace
+});

package/dist/jest/declare-workspace.d.cts

@@ -0,0 +1,10 @@
+import { Config } from 'jest';
+
+/**
+ * Config for Jest unit tests
+ *
+ * https://jestjs.io/docs/configuration#projects-arraystring--projectconfig
+ */
+declare function declareWorkspace(config?: Partial<Config>): () => Promise<Config>;
+
+export { declareWorkspace };