v16.2.2

🐛 fixes

• b196bbb fix(init): uses backticks in the prefix example
• cabbf2e chore: makes sources type:module ready & publish as type:module (#915)

👷 maintenance

• 3959d33 chore(package.json): removes mention of !.hbs in files list
• 2a6b6d4/ 525281d chore: corrects typo in config & re-baseline
• 24aec38/ 1dcb73d chore(cache): migrates to watskeburt 4 (#914 / #912)
• 1afc27f build(npm): updates external dependencies

v16.2.1

📖 documentation

• b32fb10 doc: adds list of contributors to package.json
• 1488c99 doc(init-config): trims down the amount of comments in the .dependency-cruiser.js --init generates
• 69572ac doc: copy tweaks

👷 maintenance

• 45e7a27 build(npm): updates external dependencies
• 0e3e538 chore: restores package.json after packaging

v16.2.0

✨ features

• 0f9fac9/ 231ad6e feat(report): adds a reporter that combines a dot reporter with executing dot and running the wrap-stream-in-html command (#907)

📖 documentation

• 0fd4519 doc: rewrites copy on experimental features (which in some cases weren't experimental anymore)

👷 maintenance

• b592264 refactor(cli|report): moves responsibility to ensure output ends on an EOL to the individual reporters (#908)
• af96c16 chore: for the local depcruise:graph:view commands use the experimental all-in-one reporter
• bba4ee1 build(npm): updates external dependencies

v16.1.0

✨ features

• 54fb588 feat(init): adds 'types' to the enhanced resolve export condition names
• 24b3b2e feat(manifest): on publish removes devDependencies & scripts (#905)

🐛 fixes

• 49fb96f fix(init): also shows an error if config file already exists with one shot configs

👷 maintenance

• 263ef24 / bb4ec36 build(npm): updates external dependencies & devDependencies
• 04b0274 chore: happy 2024
• fbba9ea test(cli): precises (and denoises) e2e test emitting to stdout
• daa8a1e test(enrich): adds a few test cases for cycle detection
• 1a5d994 chore: tweaks the rules that mandate type-only ness for more precission
• b9d4d2b refactor(cli): makes stderr, stdout configurable - so we can test their uses more easily (#898)
• 3d31cc3 refactor(init-config): makes stderr, stdout configurable - so we can test their uses more easily (#897)

v16.1.0-beta-1

• 46cb50e ci: on publish remove devDependencies & scripts
• 263ef24 build(npm): updates external dependencies
• bb4ec36 ci(deps): bump actions/cache from 3 to 4 (#904)
• 54fb588 feat(init): adds 'types' to the enhanced resolve export condition names
• 04b0274 chore: happy 2024
• 49fb96f fix(init): also shows an error if config file already exists with one shot configs
• fbba9ea test(cli): precises (and denoises) e2e test emitting to stdout
• daa8a1e test(enrich): adds a few test cases for cycle detection
• 1a5d994 chore: tweaks the rules that mandate type-only ness for more precission
• b9d4d2b refactor(cli): makes stderr, stdout configurable - so we can test their uses more easily (#898)
• 3d31cc3 refactor(init-config): makes stderr, stdout configurable - so we can test their uses more easily (#897)

v16.0.0

⚡ Is this release breaking for me?

TL;DR: Not likely, if you only use the command line interface

👩 I use the command line interface

When you have rules defined on dependency type type-only or on the
aliased-* ones, dependency-cruiser might start to report issues it didn't
in previous versions as it now more precisely detects those.

• 03bdda2 fix(resolve)!: makes alias type derivation more correct and precise BREAKING (#867)
• 19033e8 feat(extract)!: detect 'type-only' with inline imports/exports - BREAKING (#875) (@alvaro-cuesta)

🤖 I use the API

Changes in data structures. Click for details.

• 05d9795 feat!: restructures the via* sub-restrictions to also accept & validate against dependency types (BREAKING for API users) (#894). See rules-reference.md#circular for details.

  • before: in rules cycles can be restricted with the restrictions via, viaOnly, viaNot and viaSomeNot, each of which would accept a regular expression (or an array of them) to match against the module names in the cycle.
  • after: in rules cycles can be restricted with the restrictions via and viaOnly each of which takes an object with the following properties:
    • path: a regular expression (or an array of them) to match against the module names in the cycle.
    • pathNot: a regular expression (or an array of them) to match against the module names in the cycle.
    • dependencyTypes: an array of strings (dependency types) match against the dependency types in the cycle.
    • dependencyTypesNot: an array of strings (dependency types) match against the dependency types in the cycle.

• c6421e3 feat!: makes entries in 'cycle' contain more information (BREAKING for API users) (#888)

  • before: a cycle in the dependency graph would be reported as an array of strings (the module names)
  • after: a cycle in the dependency graph is reported as an array of objects with the following properties:
    • name: the name of the module
    • dependencyTypes: the types of dependency the module has with the previous
      module in the cycle.

• e8cda75 feat!: makes entries in reachability via's contain more information (BREAKING for API users) (#895)

  • before: a route ('via') in the dependency graph would be reported as an array of strings (the module names)
  • after: a route ('via') in the dependency graph is reported as an array of objects with the following properties:
    • name: the name of the module
    • dependencyTypes: the types of dependency the module has with the previous
      module in the route.

❤️ Thanks

• @camillef - for raising the clear & complete issue that asks to check against dependency types over the entire cycle for circular dependencies
• @alvaro-cuesta - for the PR that made the type-only detection more precise
• @throrin19 - for raising #863 that led to better detection of aliased-* dependencies and for testing the fixes
• @stelescuraul - on adding a test case for workspace aliases on that issue and for testing the fixes for them
• @martinslota - for a PR that made sure the output ends with a newline
• @quentindemetz - for a PR that fixed a typo in the options reference

✨ features

✨ finer grained dependency types

In addition to the dependency types dependency-cruiser already distinguished
(local, npm, npm-dev, core, type-only unknown, etc) this release adds a few
that enables rules (and styling) against a few more fine grained ones. E.g.
whether it's a triple slash reference, and if so, what kind (triple-slash-file-reference,
triple-slash-type-reference) whether the dependency is defined in a normal
import, in a dynamic one or instead by way of a (re-)export statement (import,
dynamic-import, export). See rules-reference.md#dependencytypes-and-dependencytypesnot
for the entire list.

• 11127b5 feat(extract): adds more granularity to dependency types (#884)
• 6d4c72c fix(extract): prevents classifying core modules as aliased-tsconfig-base-url (#886)
• 03bdda2 fix(resolve)!: makes alias type derivation more correct and precise BREAKING (#867)
• 0278445 feat(extract): adds "pre-compilation-only" to the dependencyTypes as well, when detected (#892)

✨ finer grained control on cycle rules

As asked in #695 dependency-cruiser now allows you to restrict cycles based on
the dependency types as well as the module names. See rules-reference.md#circular with
attributes in the via and viaOnly sub-restrictions.

  // ...

  // log an error for all circular dependencies which consist of only non-`type-only`
  // dependencies, so e.g.
  // violation : a -import-> b -import->           c -import-> a 
  // OK        : a -import-> b -import,type-only-> c -import-> a
  {
    name: 'no-circular-at-runtime',
    severity: 'error',
    from: {
    },
    to: {
      circular: true,
      viaOnly: {
        dependencyTypesNot: ['type-only']
      }
    }
  },

  // ...

• 05d9795 feat!: restructures the via* sub-restrictions to also accept & validate against dependency types (BREAKING for API users) (#894)
• c6421e3 feat!: makes entries in 'cycle' contain more information (BREAKING for API users) (#888)

The old notation for via and viaOnly still works, but is deprecated. To ensure
future working we've added these features to dependency-cruiser that guarantee
that the old notation will still work.

• 433e0dc refactor(graph-utl): normalizes name attribute of dependencies on construction to simplify processing (#887)
• 20e5b94 feat(config-utl): makes possibly old format known violations forward compatible (#890)
• 7ddf2db feat(cache): adds cache format version & checks against it (#891)

✨ detection of type-only dependencies within the curly brackets

This PR/ commit enables dependency-cruiser to detect type-only dependencies
that are

    // ...
    import type { SomeType } from 'some-module' // was already detected
    import { type SomeType } from 'some-module' // now also detected as type only
    // ...
    ```

• 19033e8 feat(extract)!: detect 'type-only' with inline imports/exports - BREAKING (#875)(@alvaro-cuesta)

✨ others

• 7abbe47 feat(report/dot): adds ability to match arrays for conditional coloring (#882)
• 17c7e1c Ensure trailing newline is written to files and stdout (#879) (@martinslota)
• e8cda75 feat!: makes entries in reachability via's contain more information (BREAKING for API users) (#895)

👷 maintenance

📖 documentation

• 1af5706 doc(cli): point to picomatch instead of node-glob
• 83fafe1 doc: updates alerts to use GH markdown alerts
• 97e7c03 doc(options-reference): fix typo in swc dependency (#893) (@quentindemetz)
• 52dee75 doc(types): swaps the comments for via and viaOnly

🧹 chores

• 92c5782 ci: sets up semantic PR title check
• 33978af chore(ci): ensures our own dependency graphs only show red lines when the severity tells it so
• 27485a4 ci: adds a few rules to own .dependency-cruiser.json
• f0d1fe3 build: ensures dependencies on .d.[cm]?ts$ are type only always
• c5eea78 chore(test): raises branch coverage limit

♻️ LCM

• 83a5589 ci(deps): bump actions/stale from 8 to 9 (#885)
• 875813e ci(deps): bump github/codeql-action from 2 to 3 (#889)
• bfb3e2b build(npm): updates external dependencies

v16.0.0-beta-6

features

finer grained dependency types

• 11127b5 feat(extract): adds more granularity to dependency types (#884)
• 6d4c72c fix(extract): prevents classifying core modules as aliased-tsconfig-base-url (#886)
• 03bdda2 fix(resolve)!: makes alias type derivation more correct and precise BREAKING (#867)
• 0278445 feat(extract): adds "pre-compilation-only" to the dependencyTypes as well, when detected (#892)

finer grained control on cycle rules

• 05d9795 feat!: restructures the via* sub-restrictions to also accept & validate against dependency types (BREAKING for API users) (#894)
• 433e0dc refactor(graph-utl): normalizes name attribute of dependencies on construction to simplify processing (#887)
• c6421e3 feat!: makes entries in 'cycle' contain more information (BREAKING for API users) (#888)
• 20e5b94 feat(config-utl): makes possibly old format known violations forward compatible (#890)
• 7ddf2db feat(cache): adds cache format version & checks against it (#891)

other

• 19033e8 feat(extract)!: detect 'type-only' with inline imports/exports - BREAKING (#875)
• 76db5f0 feat(init): reduces the moduleSystems in the template to cjs and es6
• 7abbe47 feat(report/dot): adds ability to match arrays for conditional coloring (#882)
• 17c7e1c Ensure trailing newline is written to files and stdout (#879)

maintenance

documentation

• 1af5706 doc(cli): point to picomatch instead of node-glob
• 83fafe1 doc: updates alerts to use GH markdown alerts
• 97e7c03 doc(options-reference): fix typo in swc dependency (#893)

chores

• 92c5782 ci: sets up semantic PR title check
• 33978af chore(ci): ensures our own dependency graphs only show red lines when the severity tells it so
• 27485a4 ci: adds a few rules to own .dependency-cruiser.json
• f0d1fe3 build: ensures dependencies on .d.[cm]?ts$ are type only always

LCM

• 83a5589 ci(deps): bump actions/stale from 8 to 9 (#885)
• 875813e ci(deps): bump github/codeql-action from 2 to 3 (#889)

v16.0.0-beta-5

features

finer grained dependency types

• 11127b5 feat(extract): adds more granularity to dependency types (#884)
• 6d4c72c fix(extract): prevents classifying core modules as aliased-tsconfig-base-url (#886)
• 03bdda2 fix(resolve)!: makes alias type derivation more correct and precise BREAKING (#867)

finer grained control on cycle rules

• 433e0dc refactor(graph-utl): normalizes name attribute of dependencies on construction to simplify processing (#887)
• c6421e3 feat!: makes entries in 'cycle' contain more information (BREAKING for API users) (#888)
• 20e5b94 feat(config-utl): makes possibly old format known violations forward compatible (#890)
• 7ddf2db feat(cache): adds cache format version & checks against it (#891)

other

• 19033e8 feat(extract)!: detect 'type-only' with inline imports/exports - BREAKING (#875)
• 76db5f0 feat(init): reduces the moduleSystems in the template to cjs and es6
• 7abbe47 feat(report/dot): adds ability to match arrays for conditional coloring (#882)
• 17c7e1c Ensure trailing newline is written to files and stdout (#879)

maintenance

documentation

• 1af5706 doc(cli): point to picomatch instead of node-glob
• 83fafe1 doc: updates alerts to use GH markdown alerts

chores

• 92c5782 ci: sets up semantic PR title check
• 33978af chore(ci): ensures our own dependency graphs only show red lines when the severity tells it so
• 27485a4 ci: adds a few rules to own .dependency-cruiser.json
• f0d1fe3 build: ensures dependencies on .d.[cm]?ts$ are type only always

LCM

• 83a5589 ci(deps): bump actions/stale from 8 to 9 (#885)
• 875813e ci(deps): bump github/codeql-action from 2 to 3 (#889)

v16.0.0-beta-4

• 6d4c72c fix(extract): prevents classifying core modules as aliased-tsconfig-base-url (#886)
• 27485a4 ci: adds a few rules to own .dependency-cruiser.json
• 76db5f0 feat(init): reduces the moduleSystems in the template to cjs and es6
• 11127b5 feat(extract): adds more granularity to dependency types (#884)
• 83a5589 ci(deps): bump actions/stale from 8 to 9 (#885)
• 03bdda2 fix(resolve)!: makes alias type derivation more correct and precise BREAKING (#867)
• 83fafe1 doc: updates alerts to use GH markdown alerts
• 7abbe47 feat(report/dot): adds ability to match arrays for conditional coloring (#882)
• 33978af chore(ci): ensures our own dependency graphs only show red lines when the severity tells it so
• f0d1fe3 build: ensures dependencies on .d.[cm]?ts$ are type only always
• 92c5782 ci: sets up semantic PR title check
• 1af5706 doc(cli): point to picomatch instead of node-glob
• 17c7e1c Ensure trailing newline is written to files and stdout (#879)
• 19033e8 feat(extract)!: detect 'type-only' with inline imports/exports - BREAKING (#875)

v16.0.0-beta-3

• 76db5f0 feat(init): reduces the moduleSystems in the template to cjs and es6
• 11127b5 feat(extract): adds more granularity to dependency types (#884)
• 83a5589 ci(deps): bump actions/stale from 8 to 9 (#885)
• 03bdda2 fix(resolve)!: makes alias type derivation more correct and precise BREAKING (#867)
• 83fafe1 doc: updates alerts to use GH markdown alerts
• 7abbe47 feat(report/dot): adds ability to match arrays for conditional coloring (#882)
• 33978af chore(ci): ensures our own dependency graphs only show red lines when the severity tells it so
• f0d1fe3 build: ensures dependencies on .d.[cm]?ts$ are type only always
• 92c5782 ci: sets up semantic PR title check
• 1af5706 doc(cli): point to picomatch instead of node-glob
• 17c7e1c Ensure trailing newline is written to files and stdout (#879)
• 19033e8 feat(extract)!: detect 'type-only' with inline imports/exports - BREAKING (#875)