feat: enables matching transitive dependencies in 'required' rules

[sverweij]

Description

• adds the reachable attribute to the 'required' rules schema
• adds reachable detection to the enrich step
• processes reachable in validating against 'required' rules
• update the documentation

Motivation and Context

See #973

How Has This Been Tested?

• green ci
• additional automated non-regression tests

Example usage

/** @type {import('dependency-cruiser').IConfiguration} */
export default {
  required: [
    {
      name: "must-reach-meta-cjs",
      comment: "all modules much reach, somehow, meta.cjs",
      module: {
        path: "^src/",
      },
      to: {
        path: "^src/meta[.]cjs$",
        reachable: true,
      }
    }
  ],
  options: {
    // ...
  }
}

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• Documentation only change
• Refactor (non-breaking change which fixes an issue without changing functionality)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)

Checklist

• 📖

  • My change doesn't require a documentation update, or ...
  • it does and I have updated it

• ⚖️

  • The contribution will be subject to The MIT license, and I'm OK with that.
  • The contribution is my own original work.
  • I am ok with the stuff in CONTRIBUTING.md.

[codeclimate]

Code Climate has analyzed commit 8b207cf and detected 0 issues on this pull request.

View more on Code Climate.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud