.dependency-cruiser.cjs
/* eslint-disable max-lines */
/* eslint-disable no-useless-escape */
'use strict'
/** @type {import('dependency-cruiser').IConfiguration} */
module.exports = {
forbidden: [
/* rules from the 'recommended' preset: */
{
comment:
'This dependency is part of a circular relationship. You might want to revise ' +
'your solution (i.e. use dependency inversion, make sure the modules have a single responsibility) ',
from: {},
name: 'no-circular',
severity: 'warn',
to: {
circular: true,
},
},
{
comment:
'This is an orphan module - it\'s likely not used (anymore?). Either use it or ' +
'remove it. If it\'s logical this module is an orphan (i.e. it\'s a config file), ' +
'add an exception for it in your dependency-cruiser configuration. By default ' +
'this rule does not scrutinize dot-files (e.g. .eslintrc.js), TypeScript declaration ' +
'files (.d.ts), tsconfig.json and some of the babel and webpack configs.',
from: {
orphan: true,
pathNot: [
'(^|/)\\.[^/]+\\.(js|cjs|mjs|ts|json)$', // dot files
'\\.d\\.ts$', // TypeScript declaration files
'(^|/)tsconfig\\.json$', // TypeScript config
'(^|/)(babel|webpack)\\.config\\.(js|cjs|mjs|ts|json)$', // other configs
'components/.*', // components are auto loaded
'pages/.vitepress/cache',
],
},
name: 'no-orphans',
severity: 'warn',
to: {},
},
{
comment:
'A module depends on a node core module that has been deprecated. Find an alternative - these are ' +
'bound to exist - node doesn\'t deprecate lightly.',
from: {},
name: 'no-deprecated-core',
severity: 'warn',
to: {
dependencyTypes: [
'core',
],
path: [
'^(v8\/tools\/codemap)$',
'^(v8\/tools\/consarray)$',
'^(v8\/tools\/csvparser)$',
'^(v8\/tools\/logreader)$',
'^(v8\/tools\/profile_view)$',
'^(v8\/tools\/profile)$',
'^(v8\/tools\/SourceMap)$',
'^(v8\/tools\/splaytree)$',
'^(v8\/tools\/tickprocessor-driver)$',
'^(v8\/tools\/tickprocessor)$',
'^(node-inspect\/lib\/_inspect)$',
'^(node-inspect\/lib\/internal\/inspect_client)$',
'^(node-inspect\/lib\/internal\/inspect_repl)$',
'^(async_hooks)$',
'^(punycode)$',
'^(domain)$',
'^(constants)$',
'^(sys)$',
'^(_linklist)$',
'^(_stream_wrap)$',
],
},
},
{
comment:
'This module uses a (version of an) npm module that has been deprecated. Either upgrade to a later ' +
'version of that module, or find an alternative. Deprecated modules are a security risk.',
from: {},
name: 'not-to-deprecated',
severity: 'warn',
to: {
dependencyTypes: [
'deprecated',
],
},
},
{
comment:
'This module depends on an npm package that isn\'t in the \'dependencies\' section of your package.json. ' +
'That\'s problematic as the package either (1) won\'t be available on live (2 - worse) will be ' +
'available on live with an non-guaranteed version. Fix it by adding the package to the dependencies ' +
'in your package.json.',
from: {
pathNot: [
'components/.*', // components are auto loaded
'pages/.vitepress/cache',
],
},
name: 'no-non-package-json',
severity: 'error',
to: {
dependencyTypes: [
'npm-no-pkg',
'npm-unknown',
],
},
},
{
comment:
'This module depends on a module that cannot be found (\'resolved to disk\'). If it\'s an npm ' +
'module: add it to your package.json. In all other cases you likely already know what to do.',
from: {
pathNot: [
'\\.d\\.ts$', // TypeScript declaration files
],
},
name: 'not-to-unresolvable',
severity: 'error',
to: {
couldNotResolve: true,
pathNot: [
'shuutils',
],
},
},
{
comment:
'Likely this module depends on an external (\'npm\') package that occurs more than once ' +
'in your package.json i.e. bot as a devDependencies and in dependencies. This will cause ' +
'maintenance problems later on.',
from: {},
name: 'no-duplicate-dep-types',
severity: 'warn',
to: {
// types for this rule
dependencyTypesNot: ['type-only'],
// 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
moreThanOneDependencyType: true,
},
},
/* rules you might want to tweak for your specific situation: */
{
comment:
'This module depends on code within a folder that should only contain tests. As tests don\'t ' +
'implement functionality this is odd. Either you\'re writing a test outside the test folder ' +
'or there\'s something in the test folder that isn\'t a test.',
from: {
pathNot: '^(tests)',
},
name: 'not-to-test',
severity: 'error',
to: {
path: '^(tests)',
},
},
{
comment:
'This module depends on a spec (test) file. The sole responsibility of a spec file is to test code. ' +
'If there\'s something in a spec that\'s of use to other modules, it doesn\'t have that single ' +
'responsibility anymore. Factor it out into (e.g.) a separate utility/ helper or a mock.',
from: {},
name: 'not-to-spec',
severity: 'error',
to: {
path: '\\.(spec|test)\\.(js|mjs|cjs|ts|ls|coffee|litcoffee|coffee\\.md)$',
},
},
{
comment:
'This module depends on an npm package from the \'devDependencies\' section of your ' +
'package.json. It looks like something that ships to production, though. To prevent problems ' +
'with npm packages that aren\'t there on production declare it (only!) in the \'dependencies\'' +
'section of your package.json. If this module is development only - add it to the ' +
'from.pathNot re of the not-to-dev-dep rule in the dependency-cruiser configuration',
from: {
path: '^(src)',
pathNot: '\\.(spec|test)\\.(js|mjs|cjs|ts|ls|coffee|litcoffee|coffee\\.md)$',
},
name: 'not-to-dev-dep',
severity: 'error',
to: {
dependencyTypes: [
'npm-dev',
],
},
},
{
comment:
'This module depends on an npm package that is declared as an optional dependency ' +
'in your package.json. As this makes sense in limited situations only, it\'s flagged here. ' +
'If you\'re using an optional dependency here by design - add an exception to your' +
'dependency-cruiser configuration.',
from: {},
name: 'optional-deps-used',
severity: 'info',
to: {
dependencyTypes: [
'npm-optional',
],
},
},
{
comment:
'This module depends on an npm package that is declared as a peer dependency ' +
'in your package.json. This makes sense if your package is e.g. a plugin, but in ' +
'other cases - maybe not so much. If the use of a peer dependency is intentional ' +
'add an exception to your dependency-cruiser configuration.',
from: {},
name: 'peer-deps-used',
severity: 'warn',
to: {
dependencyTypes: [
'npm-peer',
],
},
},
],
options: {
// conditions specifying which files not to follow further when encountered:
// - path: a regular expression to match
// - dependencyTypes: see https://github.com/sverweij/dependency-cruiser/blob/master/doc/rules-reference.md#dependencytypes-and-dependencytypesnot
// for a complete list
//
doNotFollow: {
path: 'node_modules',
},
// conditions specifying which dependencies to exclude
// - path: a regular expression to match
// - dynamic: a boolean indicating whether to ignore dynamic (true) or static (false) dependencies.
// leave out if you want to exclude neither (recommended!)
//
// exclude : {
// path: '',
// dynamic: true
// },
// pattern specifying which files to include (regular expression)
// dependency-cruiser will skip everything not matching this pattern
//
// includeOnly : '',
// dependency-cruiser will include modules matching against the focus
// regular expression in its output, as well as their neighbors (direct
// dependencies and dependents)
//
// focus : '',
/* list of module systems to cruise */
// moduleSystems: ['amd', 'cjs', 'es6', 'tsd'],
// prefix for links in html and svg output (e.g. 'https://github.com/you/yourrepo/blob/develop/'
// to open it on your online repo or `vscode://file/${process.cwd()}/` to
// open it in visual studio code),
//
// prefix: '',
// false (the default): ignore dependencies that only exist before typescript-to-javascript compilation
// true: also detect dependencies that only exist before typescript-to-javascript compilation
// "specify": for each dependency identify whether it only exists before compilation or also after
//
enhancedResolveOptions: {
// List of strings to consider as 'exports' fields in package.json. Use
// ['exports'] when you use packages that use such a field and your environment
// supports it (e.g. node ^12.19 || >=14.7 or recent versions of webpack).
//
// If you have an `exportsFields` attribute in your webpack config, that one
// will have precedence over the one specified here.
//
conditionNames: ['import', 'require', 'node', 'default'],
// List of conditions to check for in the exports field. e.g. use ['imports']
// if you're only interested in exposed es6 modules, ['require'] for commonjs,
// or all conditions at once `(['import', 'require', 'node', 'default']`)
// if anything goes for you. Only works when the 'exportsFields' array is
// non-empty.
//
// If you have a 'conditionNames' attribute in your webpack config, that one will
// have precedence over the one specified here.
//
exportsFields: ['exports'],
//
// The extensions, by default are the same as the ones dependency-cruiser
// can access (run `npx depcruise --info` to see which ones that are in
// _your_ environment. If that list is larger than what you need (e.g.
// it contains .js, .jsx, .ts, .tsx, .cts, .mts - but you don't use
// TypeScript you can pass just the extensions you actually use (e.g.
// [".js", ".jsx"]). This can speed up the most expensive step in
// dependency cruising (module resolution) quite a bit.
//
// extensions: [".js", ".jsx", ".ts", ".tsx", ".d.ts"]
},
//
// list of extensions to scan that aren't javascript or compile-to-javascript.
// Empty by default. Only put extensions in here that you want to take into
// account that are _not_ parsable.
//
// extraExtensionsToScan: [".json", ".jpg", ".png", ".svg", ".webp"],
// if true combines the package.json found from the module up to the base
// folder the cruise is initiated from. Useful for how (some) mono-repos
// manage dependencies & dependency definitions.
//
// combinedDependencies: false,
/* if true leave symlinks untouched, otherwise use the realpath */
// preserveSymlinks: false,
// TypeScript project file ('tsconfig.json') to use for
// (1) compilation and
// (2) resolution (e.g. with the paths property)
//
// The (optional) fileName attribute specifies which file to take (relative to
// dependency-cruiser's current working directory). When not provided
// defaults to './tsconfig.json'.
reporterOptions: {
archi: {
// pattern of modules that can be consolidated in the high level
// graphical dependency graph. If you use the high level graphical
// dependency graph reporter (`archi`) you probably want to tweak
// this collapsePattern to your situation.
//
collapsePattern: '^(packages|src|components|lib|app|bin|test(s?)|spec(s?))/[^/]+|node_modules/[^/]+',
// Options to tweak the appearance of your graph.See
// https://github.com/sverweij/dependency-cruiser/blob/master/doc/options-reference.md#reporteroptions
// for details and some examples. If you don't specify a theme
// for 'archi' dependency-cruiser will use the one specified in the
// dot section (see above), if any, and otherwise use the default one.
//
// theme: {
// },
},
dot: {
// pattern of modules that can be consolidated in the detailed
// graphical dependency graph. The default pattern in this configuration
// collapses everything in node_modules to one folder deep so you see
// the external modules, but not the innards your app depends upon.
//
collapsePattern: 'node_modules/[^/]+',
// Options to tweak the appearance of your graph.See
// https://github.com/sverweij/dependency-cruiser/blob/master/doc/options-reference.md#reporteroptions
// for details and some examples. If you don't specify a theme
// don't worry - dependency-cruiser will fall back to the default one.
//
// theme: {
// graph: {
// /* use splines: "ortho" for straight lines. Be aware though
// graphviz might take a long time calculating ortho(gonal)
// routings.
// */
// splines: "true"
// },
// modules: [
// {
// criteria: { matchesFocus: true },
// attributes: {
// fillcolor: "lime",
// penwidth: 2,
// },
// },
// {
// criteria: { matchesFocus: false },
// attributes: {
// fillcolor: "lightgrey",
// },
// },
// {
// criteria: { matchesReaches: true },
// attributes: {
// fillcolor: "lime",
// penwidth: 2,
// },
// },
// {
// criteria: { matchesReaches: false },
// attributes: {
// fillcolor: "lightgrey",
// },
// },
// {
// criteria: { source: "^src/model" },
// attributes: { fillcolor: "#ccccff" }
// },
// {
// criteria: { source: "^src/view" },
// attributes: { fillcolor: "#ccffcc" }
// },
// ],
// dependencies: [
// {
// criteria: { "rules[0].severity": "error" },
// attributes: { fontcolor: "red", color: "red" }
// },
// {
// criteria: { "rules[0].severity": "warn" },
// attributes: { fontcolor: "orange", color: "orange" }
// },
// {
// criteria: { "rules[0].severity": "info" },
// attributes: { fontcolor: "blue", color: "blue" }
// },
// {
// criteria: { resolved: "^src/model" },
// attributes: { color: "#0000ff77" }
// },
// {
// criteria: { resolved: "^src/view" },
// attributes: { color: "#00770077" }
// }
// ]
// }
},
text: {
highlightFocused: true,
},
},
// Webpack configuration to use to get resolve options from.
//
// The (optional) fileName attribute specifies which file to take (relative
// to dependency-cruiser's current working directory. When not provided defaults
// to './webpack.conf.js'.
//
// The (optional) `env` and `args` attributes contain the parameters to be passed if
// your webpack config is a function and takes them (see webpack documentation
// for details)
//
// webpackConfig: {
// fileName: './webpack.config.js',
// env: {},
// args: {},
// },
// Babel config ('.babelrc', '.babelrc.json', '.babelrc.json5', ...) to use
// for compilation (and whatever other naughty things babel plugins do to
// source code). This feature is well tested and usable, but might change
// behavior a bit over time (e.g. more precise results for used module
// systems) without dependency-cruiser getting a major version bump.
//
// babelConfig: {
// fileName: './.babelrc'
// },
// List of strings you have in use in addition to cjs/ es6 requires
// & imports to declare module dependencies. Use this e.g. if you've
// re-declared require, use a require-wrapper or use window.require as
// a hack.
//
// exoticRequireStrings: [],
// options to pass on to enhanced-resolve, the package dependency-cruiser
// uses to resolve module references to disk. You can set most of these
// options in a webpack.conf.js - this section is here for those
// projects that don't have a separate webpack config file.
//
// Note: settings in webpack.conf.js override the ones specified here.
//
tsConfig: {
fileName: 'tsconfig.json',
},
//
tsPreCompilationDeps: true,
},
}
// generated: dependency-cruiser@12.6.0 on 2023-01-31T12:57:12.267Z