dependency-cruiser 11.7.0-beta-1 → 11.8.0

package/bin/depcruise-fmt.js

@@ -46,6 +46,10 @@ try {
         "regex to collapse to a pattern E.g. ^packages/[^/]+/ would collapse to " +
         "modules/ folders directly under your packages folder. "
     )
+    .option(
+      "-P, --prefix <prefix>",
+      "prefix to use for links in the dot and err-html reporters"
+    )
     .option(
       "-e, --exit-code",
       "exit with a non-zero exit code when the input json contains error level " +

package/bin/dependency-cruise.js

@@ -53,7 +53,7 @@ try {
     )
     .option(
       "--ts-config [file]",
-      "use a typescript configuration (e.g. tsconfig.json)"
+      "use a TypeScript configuration (e.g. tsconfig.json) or it's JavaScript counterpart (e.g. jsconfig.json)"
     )
     .option(
       "--webpack-config [file]",

package/configs/plugins/mermaid-reporter-plugin.js

@@ -0,0 +1,111 @@
+const ACORN_DUMMY_VALUE = "✖";
+
+/* eslint-disable security/detect-object-injection */
+const mermaidNode = (pNode, pText) => {
+  const lNode = pNode
+    .replace(ACORN_DUMMY_VALUE, "__unknown__")
+    .replace(/^\.$|^\.\//g, "__currentPath__")
+    .replace(/^\.{2}$|^\.{2}\//g, "__prevPath__")
+    .replace(/[[\]/.@]/g, "_");
+  const lText = pText ? `["${pText}"]` : "";
+  return `${lNode}${lText}`;
+};
+
+const mermaidEdge = (pFrom, pTo) => {
+  const lFromNode = mermaidNode(pFrom.node);
+  const lToNode = mermaidNode(pTo.node);
+  return `${lFromNode} --> ${lToNode}`;
+};
+
+const mermaidEdges = (pEdges) => {
+  return pEdges.map((pEdge) => mermaidEdge(pEdge.from, pEdge.to)).join("\n");
+};
+
+const convertedEdgeSources = (pCruiseResult) => {
+  return pCruiseResult.modules.flatMap((pModule) => {
+    const lFrom = {
+      node: pModule.source,
+      text: pModule.source.split("/").slice(-1)[0],
+    };
+
+    return pModule.dependencies.map((pDep) => {
+      return {
+        from: lFrom,
+        to: {
+          node: pDep.resolved,
+          text: pDep.resolved.split("/").slice(-1)[0],
+        },
+      };
+    });
+  });
+};
+
+const indent = (pDepth = 0) => {
+  return "  ".repeat(pDepth);
+};
+
+const mermaidSubgraph = (pNode, pText, pChildren, pDepth) => {
+  return `${indent(pDepth)}subgraph ${mermaidNode(pNode, pText)}
+${pChildren}
+${indent(pDepth)}end`;
+};
+
+const mermaidSubgraphs = (pSource, pDepth = 0) => {
+  return Object.keys(pSource)
+    .map((pName) => {
+      const source = pSource[pName];
+      const children = mermaidSubgraphs(source.children, pDepth + 1);
+      if (children === "")
+        return `${indent(pDepth)}${mermaidNode(source.node, source.text)}`;
+
+      return mermaidSubgraph(source.node, source.text, children, pDepth);
+    })
+    .join("\n");
+};
+
+const convertedSubgraphSources = (pCruiseResult) => {
+  let lTree = {};
+
+  pCruiseResult.modules.forEach((pModule) => {
+    const paths = pModule.source.split("/");
+
+    paths.reduce((pChildren, pCurrentPath, pIndex) => {
+      if (!pChildren[pCurrentPath]) {
+        pChildren[pCurrentPath] = {
+          node: paths.slice(0, pIndex + 1).join("/"),
+          text: pCurrentPath,
+          children: {},
+        };
+      }
+      return pChildren[pCurrentPath].children;
+    }, lTree);
+  });
+
+  return lTree;
+};
+
+const renderMermaidThing = (pCruiseResult) => {
+  const subgraphs = convertedSubgraphSources(pCruiseResult);
+  const edges = convertedEdgeSources(pCruiseResult);
+
+  return `flowchart LR
+
+${mermaidSubgraphs(subgraphs)}
+${mermaidEdges(edges)}
+`;
+};
+
+/**
+ * mermaid reporter plugin
+ *
+ * @param {import('../../types/dependency-cruiser').ICruiseResult} pCruiseResult -
+ *      the output of a dependency-cruise adhering to dependency-cruiser's
+ *      cruise result schema
+ * @return {import('../../types/dependency-cruiser').IReporterOutput} -
+ *      output: a string
+ *      exitCode: 0
+ */
+module.exports = (pCruiseResult) => ({
+  output: renderMermaidThing(pCruiseResult),
+  exitCode: 0,
+});

package/configs/rules/no-duplicate-dependency-types.js

@@ -11,5 +11,9 @@ module.exports = {
   from: {},
   to: {
     moreThanOneDependencyType: true,
+    // as it's pretty common to have a type import be a type only import
+    // _and_ (e.g.) a devDependency - don't consider type-only dependency
+    // types for this rule
+    dependencyTypesNot: ["type-only"],
   },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dependency-cruiser",
-  "version": "11.7.0-beta-1",
+  "version": "11.8.0",
   "description": "Validate and visualize dependencies. With your rules. JavaScript, TypeScript, CoffeeScript. ES6, CommonJS, AMD.",
   "keywords": [
     "static analysis",
@@ -51,7 +51,8 @@
     "./config-utl/extract-ts-config": "./src/config-utl/extract-ts-config.js",
     "./config-utl/extract-webpack-resolve-config": "./src/config-utl/extract-webpack-resolve-config.js",
     "./sample-reporter-plugin": "./configs/plugins/stats-reporter-plugin.js",
-    "./sample-3d-reporter-plugin": "./configs/plugins/3d-reporter-plugin.js"
+    "./sample-3d-reporter-plugin": "./configs/plugins/3d-reporter-plugin.js",
+    "./mermaid-reporter-plugin": "./configs/plugins/mermaid-reporter-plugin.js"
   },
   "types": "types/dependency-cruiser.d.ts",
   "files": [
@@ -98,7 +99,7 @@
     "lint:prettier": "prettier --loglevel warn --check \"src/**/*.js\" \"configs/**/*.js\" \"tools/**/*.mjs\" \"bin/*\" \"types/*.d.ts\" \"test/**/*.spec.{cjs,js}\" \"test/**/*.{spec,utl}.mjs\"",
     "lint:prettier:fix": "prettier --loglevel warn --write \"src/**/*.js\" \"configs/**/*.js\" \"tools/**/*.mjs\" \"bin/*\" \"types/*.d.ts\" \"test/**/*.spec.{cjs,js}\" \"test/**/*.{spec,utl}.mjs\"",
     "lint:types": "npm-run-all lint:types:tsc lint:types:lint",
-    "lint:types:tsc": "tsc --noEmit --strict --types --noUnusedLocals --noUnusedParameters types/dependency-cruiser.d.ts",
+    "lint:types:tsc": "tsc --project types/tsconfig.json",
     "lint:types:lint": "eslint --no-ignore --config types/.eslintrc.json types/*.d.ts",
     "lint:types:fix": "eslint --no-ignore --config types/.eslintrc.json --fix types/*.d.ts",
     "scm:push": "run-p --aggregate-output scm:push:*",
@@ -135,63 +136,65 @@
     "version": "npm-run-all build depcruise:graph:doc scm:stage"
   },
   "dependencies": {
-    "acorn": "8.7.0",
+    "acorn": "8.7.1",
     "acorn-jsx": "5.3.2",
     "acorn-jsx-walk": "2.0.0",
     "acorn-loose": "8.3.0",
     "acorn-walk": "8.2.0",
     "ajv": "8.11.0",
     "chalk": "^4.1.2",
-    "commander": "9.2.0",
+    "commander": "9.3.0",
     "enhanced-resolve": "5.9.3",
     "figures": "^3.2.0",
     "get-stream": "^6.0.1",
     "glob": "7.2.0",
     "handlebars": "4.7.7",
     "indent-string": "^4.0.0",
-    "inquirer": "8.2.2",
+    "inquirer": "8.2.4",
     "json5": "2.2.1",
     "lodash": "4.17.21",
     "safe-regex": "2.1.1",
     "semver": "^7.3.7",
     "semver-try-require": "^5.0.2",
-    "teamcity-service-messages": "0.1.12",
+    "teamcity-service-messages": "0.1.14",
     "tsconfig-paths-webpack-plugin": "3.5.2",
     "wrap-ansi": "^7.0.0"
   },
   "devDependencies": {
-    "@babel/core": "7.17.9",
-    "@babel/plugin-transform-modules-commonjs": "7.17.9",
-    "@babel/preset-typescript": "7.16.7",
-    "@swc/core": "1.2.167",
-    "@typescript-eslint/eslint-plugin": "5.19.0",
-    "@typescript-eslint/parser": "5.19.0",
-    "@vue/compiler-sfc": "3.2.33",
-    "c8": "7.11.0",
+    "@babel/core": "7.18.2",
+    "@babel/plugin-transform-modules-commonjs": "7.18.2",
+    "@babel/preset-typescript": "7.17.12",
+    "@swc/core": "1.2.194",
+    "@types/lodash": "4.14.182",
+    "@types/node": "17.0.36",
+    "@typescript-eslint/eslint-plugin": "5.26.0",
+    "@typescript-eslint/parser": "5.26.0",
+    "@vue/compiler-sfc": "3.2.36",
+    "c8": "7.11.3",
     "chai": "4.3.6",
     "chai-json-schema": "1.5.1",
-    "coffeescript": "2.6.1",
-    "eslint": "^8.13.0",
+    "coffeescript": "2.7.0",
+    "eslint": "^8.16.0",
     "eslint-config-moving-meadow": "3.0.0",
     "eslint-config-prettier": "8.5.0",
-    "eslint-plugin-budapestian": "3.0.1",
+    "eslint-plugin-budapestian": "3.0.2",
     "eslint-plugin-import": "2.26.0",
     "eslint-plugin-mocha": "^9.0.0",
     "eslint-plugin-node": "11.1.0",
-    "eslint-plugin-security": "1.4.0",
+    "eslint-plugin-security": "1.5.0",
     "eslint-plugin-unicorn": "^42.0.0",
     "husky": "^4.3.8",
     "intercept-stdout": "0.1.2",
     "lint-staged": "12.3.4",
-    "mocha": "9.2.2",
+    "mocha": "10.0.0",
     "normalize-newline": "^3.0.0",
     "npm-run-all": "4.1.5",
     "prettier": "2.6.2",
     "proxyquire": "2.1.3",
     "shx": "0.3.4",
-    "svelte": "3.47.0",
+    "svelte": "3.48.0",
     "symlink-dir": "5.0.1",
-    "typescript": "4.6.3",
+    "typescript": "4.7.2",
     "upem": "^7.0.0",
     "vue-template-compiler": "2.6.14",
     "yarn": "1.22.18"
@@ -206,7 +209,7 @@
       {
         "package": "eslint-plugin-mocha",
         "policy": "wanted",
-        "because": "version 10 dropped support for node 12, which we still do support"
+        "because": "version 10 bumps into https://github.com/lo1tuma/eslint-plugin-mocha/issues/322"
       },
       {
         "package": "figures",

package/src/cli/format.js

@@ -12,9 +12,16 @@ const KNOWN_FMT_OPTIONS = [
   "includeOnly",
   "outputTo",
   "outputType",
+  "prefix",
   "version",
 ];
 
+/**
+ *
+ * @param {string} pResultFile the name of the file with cruise results
+ * @param {import("../../types/dependency-cruiser").IFormatOptions} pOptions
+ * @returns {Number} an exitCode
+ */
 module.exports = async (pResultFile, pOptions) => {
   const lOptions = normalizeOptions(pOptions, KNOWN_FMT_OPTIONS);
 

package/src/cli/init-config/config.js.template.js

@@ -1 +1 @@
-var Handlebars=require("handlebars/runtime"),template=Handlebars.template,templates=Handlebars.templates=Handlebars.templates||{};templates["config.js.template.hbs"]=template({1:function(e,n,o,t,s){var i,r=null!=n?n:e.nullContext||{},a=e.hooks.helperMissing,l="function",c=e.escapeExpression,e=e.lookupProperty||function(e,n){if(Object.prototype.hasOwnProperty.call(e,n))return e[n]};return"  'extends': '"+c(typeof(i=null!=(i=e(o,"preset")||(null!=n?e(n,"preset"):n))?i:a)==l?i.call(r,{name:"preset",hash:{},data:s,loc:{start:{line:4,column:14},end:{line:4,column:24}}}):i)+"',\n  /*\n     the '"+c(typeof(i=null!=(i=e(o,"preset")||(null!=n?e(n,"preset"):n))?i:a)==l?i.call(r,{name:"preset",hash:{},data:s,loc:{start:{line:6,column:10},end:{line:6,column:20}}}):i)+"' preset\n     contains these rules:\n     no-circular          - flags all circular dependencies\n     no-orphans           - flags orphan modules (except typescript .d.ts files)\n     no-deprecated-core   - flags dependencies on deprecated node 'core' modules\n     no-deprecated-npm    - flags dependencies on deprecated npm modules\n     no-non-package-json  - flags (npm) dependencies that don't occur in package.json\n     not-to-unresolvable  - flags dependencies that can't be resolved`\n     no-duplicate-dep-types - flags dependencies that occur more than once in package.json\n\n     If you need to, you can override these rules. E.g. to ignore the\n     no-duplicate-dep-types rule, you can set its severity to \"ignore\" by\n     adding this to the 'forbidden' section:\n     {\n      name: 'no-duplicate-dep-types',\n      severity: 'ignore'\n     }\n\n     Also, by default, the preset does not follow any external modules (things in\n     node_modules or in yarn's plug'n'play magic). If you want to have that\n     differently, just override it the options.doNotFollow key.\n   */\n  forbidden: [\n"},3:function(e,n,o,t,s){return"  forbidden: [\n    /* rules from the 'recommended' preset: */\n    {\n      name: 'no-circular',\n      severity: 'warn',\n      comment:\n        'This dependency is part of a circular relationship. You might want to revise ' +\n        'your solution (i.e. use dependency inversion, make sure the modules have a single responsibility) ',\n      from: {},\n      to: {\n        circular: true\n      }\n    },\n    {\n      name: 'no-orphans',\n      comment:\n        \"This is an orphan module - it's likely not used (anymore?). Either use it or \" +\n        \"remove it. If it's logical this module is an orphan (i.e. it's a config file), \" +\n        \"add an exception for it in your dependency-cruiser configuration. By default \" +\n        \"this rule does not scrutinize dotfiles (e.g. .eslintrc.js), TypeScript declaration \" +\n        \"files (.d.ts), tsconfig.json and some of the babel and webpack configs.\",\n      severity: 'warn',\n      from: {\n        orphan: true,\n        pathNot: [\n          '(^|/)\\\\.[^/]+\\\\.(js|cjs|mjs|ts|json)$', // dot files\n          '\\\\.d\\\\.ts$',                            // TypeScript declaration files\n          '(^|/)tsconfig\\\\.json$',                 // TypeScript config\n          '(^|/)(babel|webpack)\\\\.config\\\\.(js|cjs|mjs|ts|json)$' // other configs\n        ]\n      },\n      to: {},\n    },\n    {\n      name: 'no-deprecated-core',\n      comment:\n        'A module depends on a node core module that has been deprecated. Find an alternative - these are ' +\n        \"bound to exist - node doesn't deprecate lightly.\",\n      severity: 'warn',\n      from: {},\n      to: {\n        dependencyTypes: [\n          'core'\n        ],\n        path: [\n          '^(v8\\/tools\\/codemap)$',\n          '^(v8\\/tools\\/consarray)$',\n          '^(v8\\/tools\\/csvparser)$',\n          '^(v8\\/tools\\/logreader)$',\n          '^(v8\\/tools\\/profile_view)$',\n          '^(v8\\/tools\\/profile)$',\n          '^(v8\\/tools\\/SourceMap)$',\n          '^(v8\\/tools\\/splaytree)$',\n          '^(v8\\/tools\\/tickprocessor-driver)$',\n          '^(v8\\/tools\\/tickprocessor)$',\n          '^(node-inspect\\/lib\\/_inspect)$',\n          '^(node-inspect\\/lib\\/internal\\/inspect_client)$',\n          '^(node-inspect\\/lib\\/internal\\/inspect_repl)$',\n          '^(async_hooks)$',\n          '^(punycode)$',\n          '^(domain)$',\n          '^(constants)$',\n          '^(sys)$',\n          '^(_linklist)$',\n          '^(_stream_wrap)$'\n        ],\n      }\n    },\n    {\n      name: 'not-to-deprecated',\n      comment:\n        'This module uses a (version of an) npm module that has been deprecated. Either upgrade to a later ' +\n        'version of that module, or find an alternative. Deprecated modules are a security risk.',\n      severity: 'warn',\n      from: {},\n      to: {\n        dependencyTypes: [\n          'deprecated'\n        ]\n      }\n    },\n    {\n      name: 'no-non-package-json',\n      severity: 'error',\n      comment:\n        \"This module depends on an npm package that isn't in the 'dependencies' section of your package.json. \" +\n        \"That's problematic as the package either (1) won't be available on live (2 - worse) will be \" +\n        \"available on live with an non-guaranteed version. Fix it by adding the package to the dependencies \" +\n        \"in your package.json.\",\n      from: {},\n      to: {\n        dependencyTypes: [\n          'npm-no-pkg',\n          'npm-unknown'\n        ]\n      }\n    },\n    {\n      name: 'not-to-unresolvable',\n      comment:\n        \"This module depends on a module that cannot be found ('resolved to disk'). If it's an npm \" +\n        'module: add it to your package.json. In all other cases you likely already know what to do.',\n      severity: 'error',\n      from: {},\n      to: {\n        couldNotResolve: true\n      }\n    },\n    {\n      name: 'no-duplicate-dep-types',\n      comment:\n        \"Likeley this module depends on an external ('npm') package that occurs more than once \" +\n        \"in your package.json i.e. bot as a devDependencies and in dependencies. This will cause \" +\n        \"maintenance problems later on.\",\n      severity: 'warn',\n      from: {},\n      to: {\n        moreThanOneDependencyType: true\n      }\n    },\n\n    /* rules you might want to tweak for your specific situation: */\n"},5:function(e,n,o,t,s){var i,r=null!=n?n:e.nullContext||{},a=e.hooks.helperMissing,l="function",c=e.escapeExpression,e=e.lookupProperty||function(e,n){if(Object.prototype.hasOwnProperty.call(e,n))return e[n]};return"    {\n      name: 'not-to-test',\n      comment:\n        \"This module depends on code within a folder that should only contain tests. As tests don't \" +\n        \"implement functionality this is odd. Either you're writing a test outside the test folder \" +\n        \"or there's something in the test folder that isn't a test.\",\n      severity: 'error',\n      from: {\n        pathNot: '"+c(typeof(i=null!=(i=e(o,"testLocationRE")||(null!=n?e(n,"testLocationRE"):n))?i:a)==l?i.call(r,{name:"testLocationRE",hash:{},data:s,loc:{start:{line:162,column:18},end:{line:162,column:36}}}):i)+"'\n      },\n      to: {\n        path: '"+c(typeof(i=null!=(i=e(o,"testLocationRE")||(null!=n?e(n,"testLocationRE"):n))?i:a)==l?i.call(r,{name:"testLocationRE",hash:{},data:s,loc:{start:{line:165,column:15},end:{line:165,column:33}}}):i)+"'\n      }\n    },\n"},7:function(e,n,o,t,s){return"    tsPreCompilationDeps: true,\n"},9:function(e,n,o,t,s){return"    // tsPreCompilationDeps: false,\n"},11:function(e,n,o,t,s){return"    combinedDependencies: true,\n"},13:function(e,n,o,t,s){return"    // combinedDependencies: false,\n"},15:function(e,n,o,t,s){var i=e.lookupProperty||function(e,n){if(Object.prototype.hasOwnProperty.call(e,n))return e[n]};return"    tsConfig: {\n      fileName: '"+e.escapeExpression("function"==typeof(o=null!=(o=i(o,"tsConfig")||(null!=n?i(n,"tsConfig"):n))?o:e.hooks.helperMissing)?o.call(null!=n?n:e.nullContext||{},{name:"tsConfig",hash:{},data:s,loc:{start:{line:316,column:17},end:{line:316,column:29}}}):o)+"'\n    },\n"},17:function(e,n,o,t,s){return"    // tsConfig: {\n    //  fileName: './tsconfig.json'\n    // },\n"},19:function(e,n,o,t,s){var i=e.lookupProperty||function(e,n){if(Object.prototype.hasOwnProperty.call(e,n))return e[n]};return"    webpackConfig: {\n      fileName: '"+e.escapeExpression("function"==typeof(o=null!=(o=i(o,"webpackConfig")||(null!=n?i(n,"webpackConfig"):n))?o:e.hooks.helperMissing)?o.call(null!=n?n:e.nullContext||{},{name:"webpackConfig",hash:{},data:s,loc:{start:{line:336,column:17},end:{line:336,column:34}}}):o)+"',\n      // env: {},\n      // args: {},\n    },\n"},21:function(e,n,o,t,s){return"    // webpackConfig: {\n    //  fileName: './webpack.config.js',\n    //  env: {},\n    //  args: {},\n    // },\n"},23:function(e,n,o,t,s){var i=e.lookupProperty||function(e,n){if(Object.prototype.hasOwnProperty.call(e,n))return e[n]};return"    babelConfig: {\n      fileName: '"+e.escapeExpression("function"==typeof(o=null!=(o=i(o,"babelConfig")||(null!=n?i(n,"babelConfig"):n))?o:e.hooks.helperMissing)?o.call(null!=n?n:e.nullContext||{},{name:"babelConfig",hash:{},data:s,loc:{start:{line:356,column:17},end:{line:356,column:32}}}):o)+"'\n    },\n"},25:function(e,n,o,t,s){return"    // babelConfig: {\n    //   fileName: './.babelrc'\n    // },\n"},compiler:[8,">= 4.3.0"],main:function(e,n,o,t,s){var i=null!=n?n:e.nullContext||{},r=e.hooks.helperMissing,a="function",l=e.escapeExpression,c=e.lookupProperty||function(e,n){if(Object.prototype.hasOwnProperty.call(e,n))return e[n]},p="/** @type {import('dependency-cruiser').IConfiguration} */\nmodule.exports = {\n"+(null!=(h=c(o,"if").call(i,null!=n?c(n,"preset"):n,{name:"if",hash:{},fn:e.program(1,s,0),inverse:e.program(3,s,0),data:s,loc:{start:{line:3,column:0},end:{line:152,column:7}}}))?h:""),d=null!=(d=c(o,"hasTestsOutsideSource")||(null!=n?c(n,"hasTestsOutsideSource"):n))?d:r,u={name:"hasTestsOutsideSource",hash:{},fn:e.program(5,s,0),inverse:e.noop,data:s,loc:{start:{line:153,column:4},end:{line:168,column:30}}},h=typeof d==a?d.call(i,u):d;return null!=(h=c(o,"hasTestsOutsideSource")?h:e.hooks.blockHelperMissing.call(n,h,u))&&(p+=h),p+"    {\n      name: 'not-to-spec',\n      comment:\n        'This module depends on a spec (test) file. The sole responsibility of a spec file is to test code. ' +\n        \"If there's something in a spec that's of use to other modules, it doesn't have that single \" +\n        'responsibility anymore. Factor it out into (e.g.) a separate utility/ helper or a mock.',\n      severity: 'error',\n      from: {},\n      to: {\n        path: '\\\\.(spec|test)\\\\.(js|mjs|cjs|ts|ls|coffee|litcoffee|coffee\\\\.md)$'\n      }\n    },\n    {\n      name: 'not-to-dev-dep',\n      severity: 'error',\n      comment:\n        \"This module depends on an npm package from the 'devDependencies' section of your \" +\n        'package.json. It looks like something that ships to production, though. To prevent problems ' +\n        \"with npm packages that aren't there on production declare it (only!) in the 'dependencies'\" +\n        'section of your package.json. If this module is development only - add it to the ' +\n        'from.pathNot re of the not-to-dev-dep rule in the dependency-cruiser configuration',\n      from: {\n        path: '"+l(typeof(d=null!=(d=c(o,"sourceLocationRE")||(null!=n?c(n,"sourceLocationRE"):n))?d:r)==a?d.call(i,{name:"sourceLocationRE",hash:{},data:s,loc:{start:{line:191,column:15},end:{line:191,column:35}}}):d)+"',\n        pathNot: '\\\\.(spec|test)\\\\.(js|mjs|cjs|ts|ls|coffee|litcoffee|coffee\\\\.md)$'\n      },\n      to: {\n        dependencyTypes: [\n          'npm-dev'\n        ]\n      }\n    },\n    {\n      name: 'optional-deps-used',\n      severity: 'info',\n      comment:\n        \"This module depends on an npm package that is declared as an optional dependency \" +\n        \"in your package.json. As this makes sense in limited situations only, it's flagged here. \" +\n        \"If you're using an optional dependency here by design - add an exception to your\" +\n        \"depdency-cruiser configuration.\",\n      from: {},\n      to: {\n        dependencyTypes: [\n          'npm-optional'\n        ]\n      }\n    },\n    {\n      name: 'peer-deps-used',\n      comment:\n        \"This module depends on an npm package that is declared as a peer dependency \" +\n        \"in your package.json. This makes sense if your package is e.g. a plugin, but in \" +\n        \"other cases - maybe not so much. If the use of a peer dependency is intentional \" +\n        \"add an exception to your dependency-cruiser configuration.\",\n      severity: 'warn',\n      from: {},\n      to: {\n        dependencyTypes: [\n          'npm-peer'\n        ]\n      }\n    }\n  ],\n  options: {\n\n    /* conditions specifying which files not to follow further when encountered:\n       - path: a regular expression to match\n       - dependencyTypes: see https://github.com/sverweij/dependency-cruiser/blob/master/doc/rules-reference.md#dependencytypes-and-dependencytypesnot\n       for a complete list\n    */\n    doNotFollow: {\n      path: 'node_modules',\n      dependencyTypes: [\n        'npm',\n        'npm-dev',\n        'npm-optional',\n        'npm-peer',\n        'npm-bundled',\n        'npm-no-pkg'\n      ]\n    },\n\n    /* conditions specifying which dependencies to exclude\n       - path: a regular expression to match\n       - dynamic: a boolean indicating whether to ignore dynamic (true) or static (false) dependencies.\n          leave out if you want to exclude neither (recommended!)\n    */\n    // exclude : {\n    //   path: '',\n    //   dynamic: true\n    // },\n\n    /* pattern specifying which files to include (regular expression)\n       dependency-cruiser will skip everything not matching this pattern\n    */\n    // includeOnly : '',\n\n    /* dependency-cruiser will include modules matching against the focus\n       regular expression in its output, as well as their neighbours (direct\n       dependencies and dependents)\n    */\n    // focus : '',\n\n    /* list of module systems to cruise */\n    // moduleSystems: ['amd', 'cjs', 'es6', 'tsd'],\n\n    /* prefix for links in html and svg output (e.g. 'https://github.com/you/yourrepo/blob/develop/'\n       to open it on your online repo or `vscode://file/${process.cwd()}/` to \n       open it in visual studio code),\n     */\n    // prefix: '',\n\n    /* false (the default): ignore dependencies that only exist before typescript-to-javascript compilation\n       true: also detect dependencies that only exist before typescript-to-javascript compilation\n       \"specify\": for each dependency identify whether it only exists before compilation or also after\n     */\n"+(null!=(h=c(o,"if").call(i,null!=n?c(n,"tsPreCompilationDeps"):n,{name:"if",hash:{},fn:e.program(7,s,0),inverse:e.program(9,s,0),data:s,loc:{start:{line:284,column:4},end:{line:288,column:11}}}))?h:"")+'    \n    /* list of extensions (typically non-parseable) to scan. Empty by default. */\n    // extraExtensionsToScan: [".json", ".jpg", ".png", ".svg", ".webp"],\n\n    /* if true combines the package.jsons found from the module up to the base\n       folder the cruise is initiated from. Useful for how (some) mono-repos\n       manage dependencies & dependency definitions.\n     */\n'+(null!=(h=c(o,"if").call(i,null!=n?c(n,"combinedDependencies"):n,{name:"if",hash:{},fn:e.program(11,s,0),inverse:e.program(13,s,0),data:s,loc:{start:{line:297,column:4},end:{line:301,column:11}}}))?h:"")+"\n    /* if true leave symlinks untouched, otherwise use the realpath */\n    // preserveSymlinks: false,\n\n    /* TypeScript project file ('tsconfig.json') to use for\n       (1) compilation and\n       (2) resolution (e.g. with the paths property)\n\n       The (optional) fileName attribute specifies which file to take (relative to\n       dependency-cruiser's current working directory). When not provided\n       defaults to './tsconfig.json'.\n     */\n"+(null!=(h=c(o,"if").call(i,null!=n?c(n,"useTsConfig"):n,{name:"if",hash:{},fn:e.program(15,s,0),inverse:e.program(17,s,0),data:s,loc:{start:{line:314,column:4},end:{line:322,column:11}}}))?h:"")+"\n    /* Webpack configuration to use to get resolve options from.\n\n       The (optional) fileName attribute specifies which file to take (relative\n       to dependency-cruiser's current working directory. When not provided defaults\n       to './webpack.conf.js'.\n\n       The (optional) `env` and `args` attributes contain the parameters to be passed if\n       your webpack config is a function and takes them (see webpack documentation\n       for details)\n     */\n"+(null!=(h=c(o,"if").call(i,null!=n?c(n,"useWebpackConfig"):n,{name:"if",hash:{},fn:e.program(19,s,0),inverse:e.program(21,s,0),data:s,loc:{start:{line:334,column:4},end:{line:346,column:11}}}))?h:"")+"\n    /* Babel config ('.babelrc', '.babelrc.json', '.babelrc.json5', ...) to use\n      for compilation (and whatever other naughty things babel plugins do to\n      source code). This feature is well tested and usable, but might change\n      behavior a bit over time (e.g. more precise results for used module \n      systems) without dependency-cruiser getting a major version bump.\n     */\n"+(null!=(h=c(o,"if").call(i,null!=n?c(n,"useBabelConfig"):n,{name:"if",hash:{},fn:e.program(23,s,0),inverse:e.program(25,s,0),data:s,loc:{start:{line:354,column:4},end:{line:362,column:11}}}))?h:"")+'\n    /* List of strings you have in use in addition to cjs/ es6 requires\n       & imports to declare module dependencies. Use this e.g. if you\'ve\n       redeclared require, use a require-wrapper or use window.require as\n       a hack.\n    */\n    // exoticRequireStrings: [],\n    /* options to pass on to enhanced-resolve, the package dependency-cruiser\n       uses to resolve module references to disk. You can set most of these\n       options in a webpack.conf.js - this section is here for those\n       projects that don\'t have a separate webpack config file.\n\n       Note: settings in webpack.conf.js override the ones specified here.\n     */\n    enhancedResolveOptions: {\n      /* List of strings to consider as \'exports\' fields in package.json. Use\n         [\'exports\'] when you use packages that use such a field and your environment\n         supports it (e.g. node ^12.19 || >=14.7 or recent versions of webpack).\n\n        If you have an `exportsFields` attribute in your webpack config, that one\n         will have precedence over the one specified here.\n      */ \n      exportsFields: ["exports"],\n      /* List of conditions to check for in the exports field. e.g. use [\'imports\']\n         if you\'re only interested in exposed es6 modules, [\'require\'] for commonjs,\n         or all conditions at once `([\'import\', \'require\', \'node\', \'default\']`)\n         if anything goes for you. Only works when the \'exportsFields\' array is\n         non-empty.\n\n        If you have a \'conditionNames\' attribute in your webpack config, that one will\n        have precedence over the one specified here.\n      */\n      conditionNames: ["import", "require", "node", "default"]\n    },\n    reporterOptions: {\n      dot: {\n        /* pattern of modules that can be consolidated in the detailed\n           graphical dependency graph. The default pattern in this configuration\n           collapses everything in node_modules to one folder deep so you see\n           the external modules, but not the innards your app depends upon.\n         */\n        collapsePattern: \'node_modules/[^/]+\',\n\n        /* Options to tweak the appearance of your graph.See\n           https://github.com/sverweij/dependency-cruiser/blob/master/doc/options-reference.md#reporteroptions\n           for details and some examples. If you don\'t specify a theme\n           don\'t worry - dependency-cruiser will fall back to the default one.\n        */\n        // theme: {\n        //   graph: {\n        //     /* use splines: "ortho" for straight lines. Be aware though\n        //       graphviz might take a long time calculating ortho(gonal)\n        //       routings.\n        //    */\n        //     splines: "true"\n        //   },\n        //   modules: [\n        //     {\n        //       criteria: { source: "^src/model" },\n        //       attributes: { fillcolor: "#ccccff" }\n        //     },\n        //     {\n        //       criteria: { source: "^src/view" },\n        //       attributes: { fillcolor: "#ccffcc" }\n        //     }\n        //   ],\n        //   dependencies: [\n        //     {\n        //       criteria: { "rules[0].severity": "error" },\n        //       attributes: { fontcolor: "red", color: "red" }\n        //     },\n        //     {\n        //       criteria: { "rules[0].severity": "warn" },\n        //       attributes: { fontcolor: "orange", color: "orange" }\n        //     },\n        //     {\n        //       criteria: { "rules[0].severity": "info" },\n        //       attributes: { fontcolor: "blue", color: "blue" }\n        //     },\n        //     {\n        //       criteria: { resolved: "^src/model" },\n        //       attributes: { color: "#0000ff77" }\n        //     },\n        //     {\n        //       criteria: { resolved: "^src/view" },\n        //       attributes: { color: "#00770077" }\n        //     }\n        //   ]\n        // }\n      },\n      archi: {\n        /* pattern of modules that can be consolidated in the high level\n          graphical dependency graph. If you use the high level graphical\n          dependency graph reporter (`archi`) you probably want to tweak\n          this collapsePattern to your situation.\n        */\n        collapsePattern: \'^(packages|src|lib|app|bin|test(s?)|spec(s?))/[^/]+|node_modules/[^/]+\',\n\n        /* Options to tweak the appearance of your graph.See\n           https://github.com/sverweij/dependency-cruiser/blob/master/doc/options-reference.md#reporteroptions\n           for details and some examples. If you don\'t specify a theme\n           for \'archi\' dependency-cruiser will use the one specified in the\n           dot section (see above), if any, and otherwise use the default one.\n         */\n        // theme: {\n        // },\n      }\n    }\n  }\n};\n// generated: dependency-cruiser@'+l(typeof(d=null!=(d=c(o,"version")||(null!=n?c(n,"version"):n))?d:r)==a?d.call(i,{name:"version",hash:{},data:s,loc:{start:{line:473,column:33},end:{line:473,column:44}}}):d)+" on "+l(typeof(d=null!=(d=c(o,"date")||(null!=n?c(n,"date"):n))?d:r)==a?d.call(i,{name:"date",hash:{},data:s,loc:{start:{line:473,column:48},end:{line:473,column:56}}}):d)+"\n"},useData:!0});
+var Handlebars=require("handlebars/runtime"),template=Handlebars.template,templates=Handlebars.templates=Handlebars.templates||{};templates["config.js.template.hbs"]=template({1:function(e,n,o,t,s){var i,r=null!=n?n:e.nullContext||{},a=e.hooks.helperMissing,l="function",c=e.escapeExpression,e=e.lookupProperty||function(e,n){if(Object.prototype.hasOwnProperty.call(e,n))return e[n]};return"  'extends': '"+c(typeof(i=null!=(i=e(o,"preset")||(null!=n?e(n,"preset"):n))?i:a)==l?i.call(r,{name:"preset",hash:{},data:s,loc:{start:{line:4,column:14},end:{line:4,column:24}}}):i)+"',\n  /*\n     the '"+c(typeof(i=null!=(i=e(o,"preset")||(null!=n?e(n,"preset"):n))?i:a)==l?i.call(r,{name:"preset",hash:{},data:s,loc:{start:{line:6,column:10},end:{line:6,column:20}}}):i)+"' preset\n     contains these rules:\n     no-circular          - flags all circular dependencies\n     no-orphans           - flags orphan modules (except typescript .d.ts files)\n     no-deprecated-core   - flags dependencies on deprecated node 'core' modules\n     no-deprecated-npm    - flags dependencies on deprecated npm modules\n     no-non-package-json  - flags (npm) dependencies that don't occur in package.json\n     not-to-unresolvable  - flags dependencies that can't be resolved`\n     no-duplicate-dep-types - flags dependencies that occur more than once in package.json\n\n     If you need to, you can override these rules. E.g. to ignore the\n     no-duplicate-dep-types rule, you can set its severity to \"ignore\" by\n     adding this to the 'forbidden' section:\n     {\n      name: 'no-duplicate-dep-types',\n      severity: 'ignore'\n     }\n\n     Also, by default, the preset does not follow any external modules (things in\n     node_modules or in yarn's plug'n'play magic). If you want to have that\n     differently, just override it the options.doNotFollow key.\n   */\n  forbidden: [\n"},3:function(e,n,o,t,s){return"  forbidden: [\n    /* rules from the 'recommended' preset: */\n    {\n      name: 'no-circular',\n      severity: 'warn',\n      comment:\n        'This dependency is part of a circular relationship. You might want to revise ' +\n        'your solution (i.e. use dependency inversion, make sure the modules have a single responsibility) ',\n      from: {},\n      to: {\n        circular: true\n      }\n    },\n    {\n      name: 'no-orphans',\n      comment:\n        \"This is an orphan module - it's likely not used (anymore?). Either use it or \" +\n        \"remove it. If it's logical this module is an orphan (i.e. it's a config file), \" +\n        \"add an exception for it in your dependency-cruiser configuration. By default \" +\n        \"this rule does not scrutinize dotfiles (e.g. .eslintrc.js), TypeScript declaration \" +\n        \"files (.d.ts), tsconfig.json and some of the babel and webpack configs.\",\n      severity: 'warn',\n      from: {\n        orphan: true,\n        pathNot: [\n          '(^|/)\\\\.[^/]+\\\\.(js|cjs|mjs|ts|json)$', // dot files\n          '\\\\.d\\\\.ts$',                            // TypeScript declaration files\n          '(^|/)tsconfig\\\\.json$',                 // TypeScript config\n          '(^|/)(babel|webpack)\\\\.config\\\\.(js|cjs|mjs|ts|json)$' // other configs\n        ]\n      },\n      to: {},\n    },\n    {\n      name: 'no-deprecated-core',\n      comment:\n        'A module depends on a node core module that has been deprecated. Find an alternative - these are ' +\n        \"bound to exist - node doesn't deprecate lightly.\",\n      severity: 'warn',\n      from: {},\n      to: {\n        dependencyTypes: [\n          'core'\n        ],\n        path: [\n          '^(v8\\/tools\\/codemap)$',\n          '^(v8\\/tools\\/consarray)$',\n          '^(v8\\/tools\\/csvparser)$',\n          '^(v8\\/tools\\/logreader)$',\n          '^(v8\\/tools\\/profile_view)$',\n          '^(v8\\/tools\\/profile)$',\n          '^(v8\\/tools\\/SourceMap)$',\n          '^(v8\\/tools\\/splaytree)$',\n          '^(v8\\/tools\\/tickprocessor-driver)$',\n          '^(v8\\/tools\\/tickprocessor)$',\n          '^(node-inspect\\/lib\\/_inspect)$',\n          '^(node-inspect\\/lib\\/internal\\/inspect_client)$',\n          '^(node-inspect\\/lib\\/internal\\/inspect_repl)$',\n          '^(async_hooks)$',\n          '^(punycode)$',\n          '^(domain)$',\n          '^(constants)$',\n          '^(sys)$',\n          '^(_linklist)$',\n          '^(_stream_wrap)$'\n        ],\n      }\n    },\n    {\n      name: 'not-to-deprecated',\n      comment:\n        'This module uses a (version of an) npm module that has been deprecated. Either upgrade to a later ' +\n        'version of that module, or find an alternative. Deprecated modules are a security risk.',\n      severity: 'warn',\n      from: {},\n      to: {\n        dependencyTypes: [\n          'deprecated'\n        ]\n      }\n    },\n    {\n      name: 'no-non-package-json',\n      severity: 'error',\n      comment:\n        \"This module depends on an npm package that isn't in the 'dependencies' section of your package.json. \" +\n        \"That's problematic as the package either (1) won't be available on live (2 - worse) will be \" +\n        \"available on live with an non-guaranteed version. Fix it by adding the package to the dependencies \" +\n        \"in your package.json.\",\n      from: {},\n      to: {\n        dependencyTypes: [\n          'npm-no-pkg',\n          'npm-unknown'\n        ]\n      }\n    },\n    {\n      name: 'not-to-unresolvable',\n      comment:\n        \"This module depends on a module that cannot be found ('resolved to disk'). If it's an npm \" +\n        'module: add it to your package.json. In all other cases you likely already know what to do.',\n      severity: 'error',\n      from: {},\n      to: {\n        couldNotResolve: true\n      }\n    },\n    {\n      name: 'no-duplicate-dep-types',\n      comment:\n        \"Likeley this module depends on an external ('npm') package that occurs more than once \" +\n        \"in your package.json i.e. bot as a devDependencies and in dependencies. This will cause \" +\n        \"maintenance problems later on.\",\n      severity: 'warn',\n      from: {},\n      to: {\n        moreThanOneDependencyType: true,\n        // as it's pretty common to have a type import be a type only import \n        // _and_ (e.g.) a devDependency - don't consider type-only dependency\n        // types for this rule\n        dependencyTypesNot: [\"type-only\"]\n      }\n    },\n\n    /* rules you might want to tweak for your specific situation: */\n"},5:function(e,n,o,t,s){var i,r=null!=n?n:e.nullContext||{},a=e.hooks.helperMissing,l="function",c=e.escapeExpression,e=e.lookupProperty||function(e,n){if(Object.prototype.hasOwnProperty.call(e,n))return e[n]};return"    {\n      name: 'not-to-test',\n      comment:\n        \"This module depends on code within a folder that should only contain tests. As tests don't \" +\n        \"implement functionality this is odd. Either you're writing a test outside the test folder \" +\n        \"or there's something in the test folder that isn't a test.\",\n      severity: 'error',\n      from: {\n        pathNot: '"+c(typeof(i=null!=(i=e(o,"testLocationRE")||(null!=n?e(n,"testLocationRE"):n))?i:a)==l?i.call(r,{name:"testLocationRE",hash:{},data:s,loc:{start:{line:166,column:18},end:{line:166,column:36}}}):i)+"'\n      },\n      to: {\n        path: '"+c(typeof(i=null!=(i=e(o,"testLocationRE")||(null!=n?e(n,"testLocationRE"):n))?i:a)==l?i.call(r,{name:"testLocationRE",hash:{},data:s,loc:{start:{line:169,column:15},end:{line:169,column:33}}}):i)+"'\n      }\n    },\n"},7:function(e,n,o,t,s){return"    tsPreCompilationDeps: true,\n"},9:function(e,n,o,t,s){return"    // tsPreCompilationDeps: false,\n"},11:function(e,n,o,t,s){return"    combinedDependencies: true,\n"},13:function(e,n,o,t,s){return"    // combinedDependencies: false,\n"},15:function(e,n,o,t,s){var i=e.lookupProperty||function(e,n){if(Object.prototype.hasOwnProperty.call(e,n))return e[n]};return"    tsConfig: {\n      fileName: '"+e.escapeExpression("function"==typeof(o=null!=(o=i(o,"tsConfig")||(null!=n?i(n,"tsConfig"):n))?o:e.hooks.helperMissing)?o.call(null!=n?n:e.nullContext||{},{name:"tsConfig",hash:{},data:s,loc:{start:{line:312,column:17},end:{line:312,column:29}}}):o)+"'\n    },\n"},17:function(e,n,o,t,s){var i=e.lookupProperty||function(e,n){if(Object.prototype.hasOwnProperty.call(e,n))return e[n]};return null!=(o=i(o,"if").call(null!=n?n:e.nullContext||{},null!=n?i(n,"useJsConfig"):n,{name:"if",hash:{},fn:e.program(18,s,0),inverse:e.program(20,s,0),data:s,loc:{start:{line:315,column:6},end:{line:323,column:13}}}))?o:""},18:function(e,n,o,t,s){var i=e.lookupProperty||function(e,n){if(Object.prototype.hasOwnProperty.call(e,n))return e[n]};return"    tsConfig: {\n      fileName: '"+e.escapeExpression("function"==typeof(o=null!=(o=i(o,"jsConfig")||(null!=n?i(n,"jsConfig"):n))?o:e.hooks.helperMissing)?o.call(null!=n?n:e.nullContext||{},{name:"jsConfig",hash:{},data:s,loc:{start:{line:317,column:17},end:{line:317,column:29}}}):o)+"'\n    },\n"},20:function(e,n,o,t,s){return"    // tsConfig: {\n    //  fileName: './tsconfig.json'\n    // },\n"},22:function(e,n,o,t,s){var i=e.lookupProperty||function(e,n){if(Object.prototype.hasOwnProperty.call(e,n))return e[n]};return"    webpackConfig: {\n      fileName: '"+e.escapeExpression("function"==typeof(o=null!=(o=i(o,"webpackConfig")||(null!=n?i(n,"webpackConfig"):n))?o:e.hooks.helperMissing)?o.call(null!=n?n:e.nullContext||{},{name:"webpackConfig",hash:{},data:s,loc:{start:{line:338,column:17},end:{line:338,column:34}}}):o)+"',\n      // env: {},\n      // args: {},\n    },\n"},24:function(e,n,o,t,s){return"    // webpackConfig: {\n    //  fileName: './webpack.config.js',\n    //  env: {},\n    //  args: {},\n    // },\n"},26:function(e,n,o,t,s){var i=e.lookupProperty||function(e,n){if(Object.prototype.hasOwnProperty.call(e,n))return e[n]};return"    babelConfig: {\n      fileName: '"+e.escapeExpression("function"==typeof(o=null!=(o=i(o,"babelConfig")||(null!=n?i(n,"babelConfig"):n))?o:e.hooks.helperMissing)?o.call(null!=n?n:e.nullContext||{},{name:"babelConfig",hash:{},data:s,loc:{start:{line:358,column:17},end:{line:358,column:32}}}):o)+"'\n    },\n"},28:function(e,n,o,t,s){return"    // babelConfig: {\n    //   fileName: './.babelrc'\n    // },\n"},compiler:[8,">= 4.3.0"],main:function(e,n,o,t,s){var i=null!=n?n:e.nullContext||{},r=e.hooks.helperMissing,a="function",l=e.escapeExpression,c=e.lookupProperty||function(e,n){if(Object.prototype.hasOwnProperty.call(e,n))return e[n]},p="/** @type {import('dependency-cruiser').IConfiguration} */\nmodule.exports = {\n"+(null!=(h=c(o,"if").call(i,null!=n?c(n,"preset"):n,{name:"if",hash:{},fn:e.program(1,s,0),inverse:e.program(3,s,0),data:s,loc:{start:{line:3,column:0},end:{line:156,column:7}}}))?h:""),d=null!=(d=c(o,"hasTestsOutsideSource")||(null!=n?c(n,"hasTestsOutsideSource"):n))?d:r,u={name:"hasTestsOutsideSource",hash:{},fn:e.program(5,s,0),inverse:e.noop,data:s,loc:{start:{line:157,column:4},end:{line:172,column:30}}},h=typeof d==a?d.call(i,u):d;return null!=(h=c(o,"hasTestsOutsideSource")?h:e.hooks.blockHelperMissing.call(n,h,u))&&(p+=h),p+"    {\n      name: 'not-to-spec',\n      comment:\n        'This module depends on a spec (test) file. The sole responsibility of a spec file is to test code. ' +\n        \"If there's something in a spec that's of use to other modules, it doesn't have that single \" +\n        'responsibility anymore. Factor it out into (e.g.) a separate utility/ helper or a mock.',\n      severity: 'error',\n      from: {},\n      to: {\n        path: '\\\\.(spec|test)\\\\.(js|mjs|cjs|ts|ls|coffee|litcoffee|coffee\\\\.md)$'\n      }\n    },\n    {\n      name: 'not-to-dev-dep',\n      severity: 'error',\n      comment:\n        \"This module depends on an npm package from the 'devDependencies' section of your \" +\n        'package.json. It looks like something that ships to production, though. To prevent problems ' +\n        \"with npm packages that aren't there on production declare it (only!) in the 'dependencies'\" +\n        'section of your package.json. If this module is development only - add it to the ' +\n        'from.pathNot re of the not-to-dev-dep rule in the dependency-cruiser configuration',\n      from: {\n        path: '"+l(typeof(d=null!=(d=c(o,"sourceLocationRE")||(null!=n?c(n,"sourceLocationRE"):n))?d:r)==a?d.call(i,{name:"sourceLocationRE",hash:{},data:s,loc:{start:{line:195,column:15},end:{line:195,column:35}}}):d)+"',\n        pathNot: '\\\\.(spec|test)\\\\.(js|mjs|cjs|ts|ls|coffee|litcoffee|coffee\\\\.md)$'\n      },\n      to: {\n        dependencyTypes: [\n          'npm-dev'\n        ]\n      }\n    },\n    {\n      name: 'optional-deps-used',\n      severity: 'info',\n      comment:\n        \"This module depends on an npm package that is declared as an optional dependency \" +\n        \"in your package.json. As this makes sense in limited situations only, it's flagged here. \" +\n        \"If you're using an optional dependency here by design - add an exception to your\" +\n        \"depdency-cruiser configuration.\",\n      from: {},\n      to: {\n        dependencyTypes: [\n          'npm-optional'\n        ]\n      }\n    },\n    {\n      name: 'peer-deps-used',\n      comment:\n        \"This module depends on an npm package that is declared as a peer dependency \" +\n        \"in your package.json. This makes sense if your package is e.g. a plugin, but in \" +\n        \"other cases - maybe not so much. If the use of a peer dependency is intentional \" +\n        \"add an exception to your dependency-cruiser configuration.\",\n      severity: 'warn',\n      from: {},\n      to: {\n        dependencyTypes: [\n          'npm-peer'\n        ]\n      }\n    }\n  ],\n  options: {\n\n    /* conditions specifying which files not to follow further when encountered:\n       - path: a regular expression to match\n       - dependencyTypes: see https://github.com/sverweij/dependency-cruiser/blob/master/doc/rules-reference.md#dependencytypes-and-dependencytypesnot\n       for a complete list\n    */\n    doNotFollow: {\n      path: 'node_modules'\n    },\n\n    /* conditions specifying which dependencies to exclude\n       - path: a regular expression to match\n       - dynamic: a boolean indicating whether to ignore dynamic (true) or static (false) dependencies.\n          leave out if you want to exclude neither (recommended!)\n    */\n    // exclude : {\n    //   path: '',\n    //   dynamic: true\n    // },\n\n    /* pattern specifying which files to include (regular expression)\n       dependency-cruiser will skip everything not matching this pattern\n    */\n    // includeOnly : '',\n\n    /* dependency-cruiser will include modules matching against the focus\n       regular expression in its output, as well as their neighbours (direct\n       dependencies and dependents)\n    */\n    // focus : '',\n\n    /* list of module systems to cruise */\n    // moduleSystems: ['amd', 'cjs', 'es6', 'tsd'],\n\n    /* prefix for links in html and svg output (e.g. 'https://github.com/you/yourrepo/blob/develop/'\n       to open it on your online repo or `vscode://file/${process.cwd()}/` to \n       open it in visual studio code),\n     */\n    // prefix: '',\n\n    /* false (the default): ignore dependencies that only exist before typescript-to-javascript compilation\n       true: also detect dependencies that only exist before typescript-to-javascript compilation\n       \"specify\": for each dependency identify whether it only exists before compilation or also after\n     */\n"+(null!=(h=c(o,"if").call(i,null!=n?c(n,"tsPreCompilationDeps"):n,{name:"if",hash:{},fn:e.program(7,s,0),inverse:e.program(9,s,0),data:s,loc:{start:{line:280,column:4},end:{line:284,column:11}}}))?h:"")+'    \n    /* list of extensions (typically non-parseable) to scan. Empty by default. */\n    // extraExtensionsToScan: [".json", ".jpg", ".png", ".svg", ".webp"],\n\n    /* if true combines the package.jsons found from the module up to the base\n       folder the cruise is initiated from. Useful for how (some) mono-repos\n       manage dependencies & dependency definitions.\n     */\n'+(null!=(h=c(o,"if").call(i,null!=n?c(n,"combinedDependencies"):n,{name:"if",hash:{},fn:e.program(11,s,0),inverse:e.program(13,s,0),data:s,loc:{start:{line:293,column:4},end:{line:297,column:11}}}))?h:"")+"\n    /* if true leave symlinks untouched, otherwise use the realpath */\n    // preserveSymlinks: false,\n\n    /* TypeScript project file ('tsconfig.json') to use for\n       (1) compilation and\n       (2) resolution (e.g. with the paths property)\n\n       The (optional) fileName attribute specifies which file to take (relative to\n       dependency-cruiser's current working directory). When not provided\n       defaults to './tsconfig.json'.\n     */\n"+(null!=(h=c(o,"if").call(i,null!=n?c(n,"useTsConfig"):n,{name:"if",hash:{},fn:e.program(15,s,0),inverse:e.program(17,s,0),data:s,loc:{start:{line:310,column:4},end:{line:324,column:11}}}))?h:"")+"\n    /* Webpack configuration to use to get resolve options from.\n\n       The (optional) fileName attribute specifies which file to take (relative\n       to dependency-cruiser's current working directory. When not provided defaults\n       to './webpack.conf.js'.\n\n       The (optional) `env` and `args` attributes contain the parameters to be passed if\n       your webpack config is a function and takes them (see webpack documentation\n       for details)\n     */\n"+(null!=(h=c(o,"if").call(i,null!=n?c(n,"useWebpackConfig"):n,{name:"if",hash:{},fn:e.program(22,s,0),inverse:e.program(24,s,0),data:s,loc:{start:{line:336,column:4},end:{line:348,column:11}}}))?h:"")+"\n    /* Babel config ('.babelrc', '.babelrc.json', '.babelrc.json5', ...) to use\n      for compilation (and whatever other naughty things babel plugins do to\n      source code). This feature is well tested and usable, but might change\n      behavior a bit over time (e.g. more precise results for used module \n      systems) without dependency-cruiser getting a major version bump.\n     */\n"+(null!=(h=c(o,"if").call(i,null!=n?c(n,"useBabelConfig"):n,{name:"if",hash:{},fn:e.program(26,s,0),inverse:e.program(28,s,0),data:s,loc:{start:{line:356,column:4},end:{line:364,column:11}}}))?h:"")+'\n    /* List of strings you have in use in addition to cjs/ es6 requires\n       & imports to declare module dependencies. Use this e.g. if you\'ve\n       redeclared require, use a require-wrapper or use window.require as\n       a hack.\n    */\n    // exoticRequireStrings: [],\n    /* options to pass on to enhanced-resolve, the package dependency-cruiser\n       uses to resolve module references to disk. You can set most of these\n       options in a webpack.conf.js - this section is here for those\n       projects that don\'t have a separate webpack config file.\n\n       Note: settings in webpack.conf.js override the ones specified here.\n     */\n    enhancedResolveOptions: {\n      /* List of strings to consider as \'exports\' fields in package.json. Use\n         [\'exports\'] when you use packages that use such a field and your environment\n         supports it (e.g. node ^12.19 || >=14.7 or recent versions of webpack).\n\n        If you have an `exportsFields` attribute in your webpack config, that one\n         will have precedence over the one specified here.\n      */ \n      exportsFields: ["exports"],\n      /* List of conditions to check for in the exports field. e.g. use [\'imports\']\n         if you\'re only interested in exposed es6 modules, [\'require\'] for commonjs,\n         or all conditions at once `([\'import\', \'require\', \'node\', \'default\']`)\n         if anything goes for you. Only works when the \'exportsFields\' array is\n         non-empty.\n\n        If you have a \'conditionNames\' attribute in your webpack config, that one will\n        have precedence over the one specified here.\n      */\n      conditionNames: ["import", "require", "node", "default"]\n    },\n    reporterOptions: {\n      dot: {\n        /* pattern of modules that can be consolidated in the detailed\n           graphical dependency graph. The default pattern in this configuration\n           collapses everything in node_modules to one folder deep so you see\n           the external modules, but not the innards your app depends upon.\n         */\n        collapsePattern: \'node_modules/[^/]+\',\n\n        /* Options to tweak the appearance of your graph.See\n           https://github.com/sverweij/dependency-cruiser/blob/master/doc/options-reference.md#reporteroptions\n           for details and some examples. If you don\'t specify a theme\n           don\'t worry - dependency-cruiser will fall back to the default one.\n        */\n        // theme: {\n        //   graph: {\n        //     /* use splines: "ortho" for straight lines. Be aware though\n        //       graphviz might take a long time calculating ortho(gonal)\n        //       routings.\n        //    */\n        //     splines: "true"\n        //   },\n        //   modules: [\n        //     {\n        //       criteria: { source: "^src/model" },\n        //       attributes: { fillcolor: "#ccccff" }\n        //     },\n        //     {\n        //       criteria: { source: "^src/view" },\n        //       attributes: { fillcolor: "#ccffcc" }\n        //     }\n        //   ],\n        //   dependencies: [\n        //     {\n        //       criteria: { "rules[0].severity": "error" },\n        //       attributes: { fontcolor: "red", color: "red" }\n        //     },\n        //     {\n        //       criteria: { "rules[0].severity": "warn" },\n        //       attributes: { fontcolor: "orange", color: "orange" }\n        //     },\n        //     {\n        //       criteria: { "rules[0].severity": "info" },\n        //       attributes: { fontcolor: "blue", color: "blue" }\n        //     },\n        //     {\n        //       criteria: { resolved: "^src/model" },\n        //       attributes: { color: "#0000ff77" }\n        //     },\n        //     {\n        //       criteria: { resolved: "^src/view" },\n        //       attributes: { color: "#00770077" }\n        //     }\n        //   ]\n        // }\n      },\n      archi: {\n        /* pattern of modules that can be consolidated in the high level\n          graphical dependency graph. If you use the high level graphical\n          dependency graph reporter (`archi`) you probably want to tweak\n          this collapsePattern to your situation.\n        */\n        collapsePattern: \'^(packages|src|lib|app|bin|test(s?)|spec(s?))/[^/]+|node_modules/[^/]+\',\n\n        /* Options to tweak the appearance of your graph.See\n           https://github.com/sverweij/dependency-cruiser/blob/master/doc/options-reference.md#reporteroptions\n           for details and some examples. If you don\'t specify a theme\n           for \'archi\' dependency-cruiser will use the one specified in the\n           dot section (see above), if any, and otherwise use the default one.\n         */\n        // theme: {\n        // },\n      }\n    }\n  }\n};\n// generated: dependency-cruiser@'+l(typeof(d=null!=(d=c(o,"version")||(null!=n?c(n,"version"):n))?d:r)==a?d.call(i,{name:"version",hash:{},data:s,loc:{start:{line:475,column:33},end:{line:475,column:44}}}):d)+" on "+l(typeof(d=null!=(d=c(o,"date")||(null!=n?c(n,"date"):n))?d:r)==a?d.call(i,{name:"date",hash:{},data:s,loc:{start:{line:475,column:48},end:{line:475,column:56}}}):d)+"\n"},useData:!0});

package/src/cli/init-config/environment-helpers.js

@@ -7,7 +7,8 @@ const { DEFAULT_CONFIG_FILE_NAME } = require("../defaults");
 const LIKELY_SOURCE_FOLDERS = ["src", "lib", "app", "bin", "sources"];
 const LIKELY_TEST_FOLDERS = ["test", "spec", "tests", "specs", "bdd"];
 const LIKELY_PACKAGES_FOLDERS = ["packages"];
-const TSCONFIG_CANDIDATE_PATTERN = /.*[tj]sconfig.*\.json$/gi;
+const TSCONFIG_CANDIDATE_PATTERN = /.*tsconfig.*\.json$/gi;
+const JSCONFIG_CANDIDATE_PATTERN = /.*jsconfig.*\.json$/gi;
 const WEBPACK_CANDIDATE_PATTERN = /.*webpack.*\.c?js(on)?$/gi;
 const BABEL_CONFIG_CANDIDATE_PATTERN = /^\.babelrc$|.*babel.*\.json/gi;
 
@@ -119,6 +120,10 @@ const getTSConfigCandidates = (pFolderName = process.cwd()) =>
   getMatchingFileNames(TSCONFIG_CANDIDATE_PATTERN, pFolderName);
 const hasTSConfigCandidates = (pFolderName = process.cwd()) =>
   getTSConfigCandidates(pFolderName).length > 0;
+const getJSConfigCandidates = (pFolderName = process.cwd()) =>
+  getMatchingFileNames(JSCONFIG_CANDIDATE_PATTERN, pFolderName);
+const hasJSConfigCandidates = (pFolderName = process.cwd()) =>
+  getJSConfigCandidates(pFolderName).length > 0;
 
 const getWebpackConfigCandidates = () =>
   getMatchingFileNames(WEBPACK_CANDIDATE_PATTERN);
@@ -149,6 +154,8 @@ module.exports = {
   hasWebpackConfigCandidates,
   getTSConfigCandidates,
   hasTSConfigCandidates,
+  getJSConfigCandidates,
+  hasJSConfigCandidates,
   getSourceFolderCandidates,
   getTestFolderCandidates,
   getMonoRepoPackagesCandidates,

package/src/cli/init-config/get-user-input.js

@@ -4,6 +4,8 @@ const {
   getTestFolderCandidates,
   hasBabelConfigCandidates,
   getBabelConfigCandidates,
+  hasJSConfigCandidates,
+  getJSConfigCandidates,
   hasTSConfigCandidates,
   getTSConfigCandidates,
   hasWebpackConfigCandidates,
@@ -67,6 +69,20 @@ const INQUIRER_QUESTIONS = [
     validate: validateLocation,
     when: (pAnswers) => pAnswers.hasTestsOutsideSource && !pAnswers.isMonoRepo,
   },
+  {
+    name: "useJsConfig",
+    type: "confirm",
+    message: "Looks like you're using a 'jsconfig.json'. Use that?",
+    default: true,
+    when: () => hasJSConfigCandidates() && !hasTSConfigCandidates(),
+  },
+  {
+    name: "jsConfig",
+    type: "list",
+    message: "Full path to your 'jsconfig.json':",
+    choices: getJSConfigCandidates(),
+    when: (pAnswers) => pAnswers.useJsConfig,
+  },
   {
     name: "useTsConfig",
     type: "confirm",

package/src/cli/init-config/index.js

@@ -13,6 +13,8 @@ const {
   hasTSConfigCandidates,
   getTSConfigCandidates,
   getDefaultConfigFileName,
+  hasJSConfigCandidates,
+  getJSConfigCandidates,
 } = require("./environment-helpers");
 const {
   writeRunScriptsToManifest,
@@ -32,6 +34,8 @@ function getOneshotConfig(pOneShotConfigId) {
   const lBaseConfig = {
     isMonoRepo: isLikelyMonoRepo(),
     combinedDependencies: false,
+    useJsConfig: hasJSConfigCandidates() && !hasTSConfigCandidates(),
+    jsConfig: getJSConfigCandidates().shift(),
     useTsConfig: hasTSConfigCandidates(),
     tsConfig: getTSConfigCandidates().shift(),
     tsPreCompilationDeps: hasTSConfigCandidates(),

package/src/enrich/index.js

@@ -3,6 +3,19 @@ const aggregateToFolders = require("./derive/folders");
 const summarize = require("./summarize");
 const clearCaches = require("./clear-caches");
 
+/**
+ * Enriches the passed modules with things like cycle detection, validations,
+ * metrics, folders and reachability & dependents analysis.
+ *
+ * Also adds a summary to the cruise result with common stats and the options
+ * used in the cruise, so consumers of the cruise result (reporters, depcruise-fmt,
+ * caching) can use that.
+ *
+ * @param {import("../../types/dependency-cruiser").IModule[]} pModules
+ * @param {import("../../types/dependency-cruiser").ICruiseOptions} pOptions
+ * @param {string[]} pFileAndDirectoryArray
+ * @returns {import("../../types/dependency-cruiser").ICruiseResult}
+ */
 module.exports = function enrich(pModules, pOptions, pFileAndDirectoryArray) {
   clearCaches();
   const lModules = enrichModules(pModules, pOptions);

package/src/extract/ast-extractors/swc-dependency-visitor.js

@@ -148,7 +148,9 @@ if (VisitorModule) {
     visitExportAllDeclration(pNode) {
       this.pushImportExportSource(pNode);
       /* c8 ignore start */
+      // @ts-ignore
       if (super.visitExportAllDeclration) {
+        // @ts-ignore
         return super.visitExportAllDeclration(pNode);
       } else {
         /* c8 ignore stop */
@@ -166,7 +168,9 @@ if (VisitorModule) {
     visitExportNamedDeclration(pNode) {
       this.pushImportExportSource(pNode);
       /* c8 ignore start */
+      // @ts-ignore
       if (super.visitExportNamedDeclration) {
+        // @ts-ignore
         return super.visitExportNamedDeclration(pNode);
       } else {
         /* c8 ignore stop */

package/src/extract/gather-initial-sources.js

@@ -84,7 +84,7 @@ function gatherScannableFilesFromDirectory(pDirectoryName, pOptions) {
  *
  * @param  {string[]} pFileAndDirectoryArray globs and/ or paths to files or
  *                               directories to be gathered
- * @param  {import('../../types/options').ICruiseOptions} pOptions options that
+ * @param  {import('../../types/dependency-cruiser').ICruiseOptions} pOptions options that
  *                               influence what needs to be gathered/ scanned
  *                               notably useful attributes:
  *                               - exclude - regexp of what to exclude

package/src/extract/get-dependencies.js

@@ -108,13 +108,13 @@ function extractWithTsc(
 
 /**
  *
- * @param {import('../../types/options').ICruiseOptions} pCruiseOptions
+ * @param {import('../../types/dependency-cruiser').ICruiseOptions} pCruiseOptions
  * @param {string} pFileName
  * @param {any} pTranspileOptions
- * @returns {Partial<import('../../types/cruise-result').IDependency[]>}
+ * @returns {import('../../types/cruise-result').IDependency[]}
  */
 function extractDependencies(pCruiseOptions, pFileName, pTranspileOptions) {
-  /** @type Partial<import('../../types/cruise-result').IDependency[]> */
+  /** @type import('../../types/cruise-result').IDependency[] */
   let lDependencies = [];
 
   if (!pCruiseOptions.extraExtensionsToScan.includes(path.extname(pFileName))) {
@@ -179,8 +179,15 @@ function matchesPattern(pFullPathToFile, pPattern) {
   return RegExp(pPattern, "g").test(pFullPathToFile);
 }
 
+/**
+ *
+ * @param {import("../../types/dependency-cruiser").IDependency} pDependency
+ * @returns {string}
+ */
 function getDependencyUniqueKey(pDependency) {
-  return `${pDependency.module} ${pDependency.moduleSystem}`;
+  return `${pDependency.module} ${pDependency.moduleSystem} ${(
+    pDependency.dependencyTypes || []
+  ).includes("type-only")}`;
 }
 
 function compareDeps(pLeft, pRight) {
@@ -201,9 +208,9 @@ function compareDeps(pLeft, pRight) {
  *
  *
  * @param  {string} pFileName path to the file
- * @param  {import("../../../types/dependency-cruiser").ICruiseOptions} pCruiseOptions cruise options
- * @param {import("../../types/resolve-options").IResolveOptions} pResolveOptions  webpack 'enhanced-resolve' options
- * @param  {any} pTranspileOptions       an object with tsconfig ('typescript project') options
+ * @param  {import("../../types/dependency-cruiser").ICruiseOptions} pCruiseOptions cruise options
+ * @param {import("../../types/dependency-cruiser").IResolveOptions} pResolveOptions  webpack 'enhanced-resolve' options
+ * @param  {import("../../types/dependency-cruiser").ITranspileOptions} pTranspileOptions       an object with tsconfig ('typescript project') options
  *                               ('flattened' so there's no need for file access on any
  *                               'extends' option in there)
  * @return {import("../../types/dependency-cruiser").IDependency[]} an array of dependency objects (see above)

package/src/extract/index.js

@@ -136,6 +136,16 @@ function filterExcludedDynamicDependencies(pModule, pExclude) {
   };
 }
 
+/**
+ * Recursively runs through the modules matching the pFileDirectoryArray and
+ * returns an array of all the modules it finds that way.
+ *
+ * @param {string[]} pFileDirectoryArray
+ * @param {import("../../types/dependency-cruiser").ICruiseOptions} pCruiseOptions
+ * @param {import("../../types/dependency-cruiser").IResolveOptions} pResolveOptions
+ * @param {import("../../types/dependency-cruiser").ITranspileOptions} pTranspileOptions
+ * @returns {Partial<import("../../types/dependency-cruiser").IModule[]>}
+ */
 module.exports = function extract(
   pFileDirectoryArray,
   pCruiseOptions,

package/src/extract/parse/to-javascript-ast.js

@@ -7,6 +7,7 @@ const _memoize = require("lodash/memoize");
 const transpile = require("../transpile");
 const getExtension = require("../utl/get-extension");
 
+/** @type acorn.Options */
 const ACORN_OPTIONS = {
   sourceType: "module",
   ecmaVersion: 11,
@@ -33,6 +34,11 @@ function getASTFromSource(pFileRecord, pTranspileOptions) {
     if (needsJSXTreatment(pFileRecord, pTranspileOptions)) {
       return acornJsxParser.parse(lJavaScriptSource, {
         ...ACORN_OPTIONS,
+        // @ts-ignore
+        // acornJsxParser.parse takes an acorn.Options which doesn't include
+        // allowNamespacedObjects. acornJsx.Options doesn't include sourceType
+        // though, so a bit rock < this code > hard place hence ignore it
+        // type wise
         allowNamespacedObjects: true,
       });
     }
@@ -55,7 +61,7 @@ function getASTFromSource(pFileRecord, pTranspileOptions) {
  * @param {string} pFileName      path to the file to be parsed
  * @param {any} pTranspileOptions options for the transpiler(s) - a tsconfig or
  *                                a babel config
- * @returns {any}              the abstract syntax tree
+ * @returns {acorn.Node}              the abstract syntax tree
  */
 function getAST(pFileName, pTranspileOptions) {
   return getASTFromSource(
@@ -87,7 +93,7 @@ module.exports = {
    *
    * @param {string} pFileName - the name of the file to compile
    * @param {any} pTranspileOptions - options for the transpiler(s) - typically a tsconfig or a babel config
-   * @return {any} - a (typescript) AST
+   * @return {acorn.Node} - a (javascript) AST
    */
   getASTCached,