@rsdk/depdoc.cli 6.0.0-next.42 → 6.0.0-next.43

package/DEPDOC_MODEL.md

@@ -19,6 +19,7 @@ autofixable.
 | Public type surface | Imports that appear in emitted `dist/**/*.d.ts`. |
 | Private dev surface | Test, build, lint, type-only, and tooling usage that does not reach runtime or public `.d.ts`. |
 | Mirror | A `library` package has the same dependency name and range in both `peerDependencies` and `devDependencies`. |
+| Ignored import | A module specifier that appears in source but is provided virtually or resolved as an internal alias, so it is not a package dependency. |
 
 ## Invariants
 
@@ -86,6 +87,7 @@ autofixable.
 | V3 | The constraints config does not describe the whole model. | It contains versions, overrides, root-only rules, manual required dependencies, and workspace-specific exceptions. |
 | V4 | The last matching rule wins. | Enables broad rules plus specific overrides. |
 | V5 | `rootOnly` means the dependency belongs only to the root dev environment. | Workspace declarations and source usage are forbidden unless a more specific override exists. `required` + `rootOnly` means required for the selected workspace but physically owned by root `devDependencies`. |
+| V6 | Concrete dependency rules must describe packages that exist in the repo model. | Wildcard policy rules are allowed, but concrete stale `depdoc.yml` entries are reported. |
 
 ## Placement Formula
 
@@ -114,8 +116,9 @@ guess something that an earlier phase can derive.
 1. Read root `package.json`.
 2. Read every workspace `package.json`.
 3. Build the set of local workspace package names.
-4. Read dependency rules: version rules, section overrides, `rootOnly` rules,
-   manual `required` dependencies, and workspace-specific exceptions.
+4. Read ignored import patterns and dependency rules: version rules, section
+   overrides, `rootOnly` rules, manual `required` dependencies, and
+   workspace-specific exceptions.
 5. Read package manager metadata overrides, such as `packageExtensions`.
 
 ### Phase 2. Validate Basic Shape
@@ -136,16 +139,21 @@ guess something that an earlier phase can derive.
 1. Scan source imports for every workspace from `src/`, `test/`, `tests/`,
    `__tests__/`, concrete package entry-points, and relative imports reachable
    from those entry-points.
-2. Classify each import as local or external.
-3. Classify each import as runtime, type-only, test-only, or tooling-only.
-4. Scan emitted `dist/**/*.d.ts` imports when `dist/` exists.
-5. In `--with-dts` mode, require `dist/` for workspaces with `src/`; without
+2. Ignore module specifiers from `ignoredImports` and every `compilerOptions.paths`
+   alias collected from root-level `tsconfig*.json` files in the workspace.
+   For example, `@docusaurus/router` can be ignored as a virtual Docusaurus
+   runtime module, and `~app/*` / `~shared/*` are ignored when declared as
+   TypeScript path aliases.
+3. Classify each import as local or external.
+4. Classify each import as runtime, type-only, test-only, or tooling-only.
+5. Scan emitted `dist/**/*.d.ts` imports when `dist/` exists.
+6. In `--with-dts` mode, require `dist/` for workspaces with `src/`; without
    `--with-dts`, missing `dist/` is allowed so local source-only checks remain
    usable before build.
-6. Mark all dependencies found in emitted `.d.ts` as public type surface.
-7. Skip generated entry-point roots such as `dist/`, `build/`, `coverage/`, and
+7. Mark all dependencies found in emitted `.d.ts` as public type surface.
+8. Skip generated entry-point roots such as `dist/`, `build/`, `coverage/`, and
    `node_modules/`.
-8. Warn when a workspace has scanned source files and declared dependencies,
+9. Warn when a workspace has scanned source files and declared dependencies,
    but zero collected source or `.d.ts` package usage.
 
 ### Phase 4. Derive Required Public/Runtime Deps
@@ -214,8 +222,11 @@ For each manifest:
 3. Report dependencies with the wrong version range.
 4. Report forbidden dependencies.
 5. Report stale dependencies that are not required by the derived graph.
-6. Report missing or incorrect library peer/dev mirrors.
-7. Report root-only violations.
+6. Report stale concrete dependency rules from `depdoc.yml` when no matching
+   source usage, `.d.ts` usage, manifest declaration, or expected dependency
+   exists in the matching workspace scope.
+7. Report missing or incorrect library peer/dev mirrors.
+8. Report root-only violations.
 
 ### Phase 9. Autofix
 

package/__tests__/compatibility.test.ts

@@ -4,8 +4,8 @@ import { tmpdir } from 'node:os';
 import { resolve } from 'node:path';
 
 // Paths relative to this test file:
-//   __tests__/ -> depdoc/ -> packages/ -> monorepo root
-const MONOREPO_ROOT = resolve(__dirname, '../../..');
+//   __tests__/ -> depdoc/ -> dx/ -> packages/ -> monorepo root
+const MONOREPO_ROOT = resolve(__dirname, '../../../..');
 const YARN_BIN = resolve(MONOREPO_ROOT, '.yarn/releases/yarn-4.5.3.cjs');
 const YARN_CACHE = resolve(MONOREPO_ROOT, '.yarn/cache');
 // Reuse the main project's tsc instead of installing typescript in each temp monorepo.
@@ -136,13 +136,20 @@ describe('compatibility: yarn-install-clean', () => {
     const { dir, cleanup: c } = createMonorepo(
       { private: true, name: '@compat/root' },
       [
+        {
+          location: 'packages/lodash',
+          manifest: {
+            name: 'lodash',
+            version: '4.17.21',
+          },
+        },
         {
           location: 'packages/lib',
           manifest: {
             name: '@compat/lib',
             version: '1.0.0',
-            peerDependencies: { lodash: '^4.17.21' },
-            devDependencies: { lodash: '^4.17.21' },
+            peerDependencies: { lodash: '*' },
+            devDependencies: { lodash: '*' },
           },
         },
         {
@@ -152,7 +159,7 @@ describe('compatibility: yarn-install-clean', () => {
             version: '1.0.0',
             dependencies: {
               '@compat/lib': 'workspace:*',
-              lodash: '^4.17.21',
+              lodash: '*',
             },
           },
         },
@@ -175,7 +182,7 @@ describe('compatibility: yarn-install-clean', () => {
 });
 
 // ---------------------------------------------------------------------------
-// yarn-peer-requirements-clean: required external peers propagated to service
+// yarn-peer-requirements-clean: required peers propagated to service
 // ---------------------------------------------------------------------------
 
 describe('compatibility: yarn-peer-requirements-clean', () => {
@@ -184,20 +191,45 @@ describe('compatibility: yarn-peer-requirements-clean', () => {
   let cleanup: () => void;
 
   beforeAll(() => {
-    // @nestjs/common requires rxjs (required) and reflect-metadata (required).
-    // The model propagates both into service dependencies (invariant P2 + S1).
+    // @compat/framework requires rxjs and reflect-metadata. The model should
+    // propagate both into service dependencies (invariant P2 + S1).
     const { dir, cleanup: c } = createMonorepo(
       { private: true, name: '@compat/root' },
       [
+        {
+          location: 'packages/framework',
+          manifest: {
+            name: '@compat/framework',
+            version: '1.0.0',
+            peerDependencies: {
+              rxjs: '*',
+              'reflect-metadata': '*',
+            },
+          },
+        },
+        {
+          location: 'packages/rxjs',
+          manifest: {
+            name: 'rxjs',
+            version: '7.8.2',
+          },
+        },
+        {
+          location: 'packages/reflect-metadata',
+          manifest: {
+            name: 'reflect-metadata',
+            version: '0.2.2',
+          },
+        },
         {
           location: 'packages/svc',
           manifest: {
             name: '@compat/svc',
             version: '1.0.0',
             dependencies: {
-              '@nestjs/common': '10.4.8',
-              rxjs: '^7.8.1',
-              'reflect-metadata': '^0.1.12 || ^0.2.0',
+              '@compat/framework': 'workspace:*',
+              rxjs: '*',
+              'reflect-metadata': '*',
             },
           },
         },
@@ -233,12 +265,23 @@ describe('compatibility: missing-peer-detected (negative)', () => {
     const { dir, cleanup: c } = createMonorepo(
       { private: true, name: '@compat/root' },
       [
+        {
+          location: 'packages/framework',
+          manifest: {
+            name: '@compat/framework',
+            version: '1.0.0',
+            peerDependencies: {
+              rxjs: '*',
+              'reflect-metadata': '*',
+            },
+          },
+        },
         {
           location: 'packages/svc',
           manifest: {
             name: '@compat/svc',
             version: '1.0.0',
-            dependencies: { '@nestjs/common': '10.4.8' },
+            dependencies: { '@compat/framework': 'workspace:*' },
           },
         },
       ],
@@ -268,19 +311,35 @@ describe('compatibility: tsc-library-build', () => {
   let cleanup: () => void;
 
   beforeAll(() => {
-    // Library imports rxjs (which ships with bundled types). After install the
+    // Library imports rxjs (provided by a local workspace with types). After install the
     // dev mirror (devDependencies = peerDependencies) makes rxjs available for
     // tsc without any additional @types packages.
     const { dir, cleanup: c } = createMonorepo(
       { private: true, name: '@compat/root' },
       [
+        {
+          location: 'packages/rxjs',
+          manifest: {
+            name: 'rxjs',
+            version: '7.8.2',
+            types: 'index.d.ts',
+          },
+          files: {
+            'index.d.ts': [
+              'export declare class Observable<T> {',
+              '  readonly value?: T;',
+              '}',
+              '',
+            ].join('\n'),
+          },
+        },
         {
           location: 'packages/lib',
           manifest: {
             name: '@compat/lib',
             version: '1.0.0',
-            peerDependencies: { rxjs: '^7.8.1' },
-            devDependencies: { rxjs: '^7.8.1' },
+            peerDependencies: { rxjs: '*' },
+            devDependencies: { rxjs: '*' },
           },
           files: {
             'src/index.ts': [

package/__tests__/config-validation.test.ts

@@ -1,4 +1,7 @@
-import { validateDependencyRules } from '../src/model/config-validation';
+import {
+  validateDependencyRules,
+  validateIgnoredImports,
+} from '../src/model/config-validation';
 
 describe('validateDependencyRules', () => {
   it('rejects required wildcard rules because they cannot expand to concrete deps', () => {
@@ -40,3 +43,15 @@ describe('validateDependencyRules', () => {
     ]);
   });
 });
+
+describe('validateIgnoredImports', () => {
+  it('allows string module specifier patterns', () => {
+    expect(validateIgnoredImports(['@docusaurus/router'])).toEqual([]);
+  });
+
+  it('rejects non-string items', () => {
+    expect(validateIgnoredImports([42])).toEqual([
+      expect.stringContaining('ignoredImports[0] must be a string'),
+    ]);
+  });
+});

package/__tests__/engine.test.ts

@@ -923,6 +923,83 @@ describe('deriveDependencyModel engine', () => {
     });
   });
 
+  describe('stale-depdoc-rules', () => {
+    it('reports stale-rule for unused concrete dependency rules', () => {
+      const root = makeRoot();
+      const ws = makeWorkspace('@test/svc', 'packages/svc', 'service');
+      const result = deriveDependencyModel(emptyFacts([root, ws], [
+        { match: 'unused-lib', version: '^1.0.0' },
+      ]));
+
+      expect(
+        result.violations.some(
+          (v) => v.code === 'stale-rule' && v.dependency === 'unused-lib',
+        ),
+      ).toBe(true);
+    });
+
+    it('does not report required concrete rules as stale', () => {
+      const root = makeRoot();
+      const ws = makeWorkspace('@test/svc', 'packages/svc', 'service');
+      const result = deriveDependencyModel(emptyFacts([root, ws], [
+        { match: 'required-lib', version: '^1.0.0', required: true },
+      ]));
+
+      expect(
+        result.violations.some(
+          (v) => v.code === 'stale-rule' && v.dependency === 'required-lib',
+        ),
+      ).toBe(false);
+    });
+
+    it('does not report root dev baseline rules as stale', () => {
+      const root = makeRoot({
+        name: '@test/root',
+        private: true,
+        devDependencies: { eslint: '^10.0.0' },
+      });
+      const ws = makeWorkspace('@test/svc', 'packages/svc', 'service');
+      const result = deriveDependencyModel(emptyFacts([root, ws], [
+        {
+          match: 'eslint',
+          section: 'devDependencies',
+          version: '^10.0.0',
+          rootOnly: true,
+        },
+      ]));
+
+      expect(
+        result.violations.some(
+          (v) => v.code === 'stale-rule' && v.dependency === 'eslint',
+        ),
+      ).toBe(false);
+    });
+
+    it('does not report wildcard rules as stale', () => {
+      const root = makeRoot();
+      const ws = makeWorkspace('@test/svc', 'packages/svc', 'service');
+      const result = deriveDependencyModel(emptyFacts([root, ws], [
+        { match: '@scope/*', version: '^1.0.0' },
+      ]));
+
+      expect(result.violations.some((v) => v.code === 'stale-rule')).toBe(false);
+    });
+
+    it('reports workspace-scoped stale rules against the matching workspace', () => {
+      const root = makeRoot();
+      const ws = makeWorkspace('@test/svc', 'packages/svc', 'service');
+      const result = deriveDependencyModel(emptyFacts([root, ws], [
+        { match: 'unused-lib', workspace: '@test/svc', version: '^1.0.0' },
+      ]));
+      const violation = result.violations.find(
+        (v) => v.code === 'stale-rule' && v.dependency === 'unused-lib',
+      );
+
+      expect(violation?.workspace).toBe('@test/svc');
+      expect(violation?.workspaceLocation).toBe('packages/svc');
+    });
+  });
+
   describe('dts-mode', () => {
     it('does not report missing dist when withDts is disabled', () => {
       const root = makeRoot();

package/__tests__/fixtures/imports/config/aliases.json

@@ -0,0 +1,8 @@
+{
+  "compilerOptions": {
+    "baseUrl": "..",
+    "paths": {
+      "~shared/*": ["src/shared/*"]
+    }
+  }
+}

package/__tests__/fixtures/imports/src/aliases.ts

@@ -0,0 +1,4 @@
+import { route } from '~app/routes';
+import type { SharedModel } from '~shared/model';
+
+export const aliasRoute = route satisfies SharedModel;

package/__tests__/fixtures/imports/src/virtual.ts

@@ -0,0 +1,3 @@
+import { BrowserOnly } from '@docusaurus/router';
+
+export const virtualRouter = BrowserOnly;

package/__tests__/fixtures/imports/tsconfig.build.json

@@ -0,0 +1,3 @@
+{
+  "extends": "./config/aliases.json"
+}

package/__tests__/fixtures/imports/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "~app/*": ["src/app/*"]
+    }
+  }
+}

package/__tests__/imports.test.ts

@@ -5,6 +5,7 @@ import {
   collectSourceImports,
   getPackageName,
 } from '../src/lib/imports';
+import { collectTsConfigPathAliases } from '../src/collectors/tsconfig-aliases';
 
 const FIXTURES = path.join(__dirname, 'fixtures/imports');
 
@@ -74,6 +75,28 @@ describe('collectSourceImports', () => {
     expect(pkgs.has('require-dep')).toBe(true);
     expect(pkgs.has('dynamic-dep')).toBe(true);
     expect(pkgs.has('reexport-dep')).toBe(true);
+    expect(pkgs.has('@docusaurus/router')).toBe(true);
+  });
+
+  it('ignores configured virtual imports', () => {
+    const filteredEntries = collectSourceImports(srcDir, undefined, {
+      ignoredSpecifiers: ['@docusaurus/router'],
+    });
+    const pkgs = new Set(filteredEntries.map((e) => e.packageName));
+
+    expect(pkgs.has('@docusaurus/router')).toBe(false);
+  });
+
+  it('ignores TS path aliases collected from all workspace tsconfigs', () => {
+    const aliases = collectTsConfigPathAliases(FIXTURES);
+    const filteredEntries = collectSourceImports(srcDir, undefined, {
+      ignoredSpecifiers: aliases,
+    });
+    const pkgs = new Set(filteredEntries.map((e) => e.packageName));
+
+    expect(aliases).toEqual(expect.arrayContaining(['~app/*', '~shared/*']));
+    expect(pkgs.has('~app')).toBe(false);
+    expect(pkgs.has('~shared')).toBe(false);
   });
 
   it('marks import type entries as isTypeOnly', () => {
@@ -215,4 +238,12 @@ describe('collectDtsImports', () => {
   it('returns a set (no duplicates)', () => {
     expect(result).toBeInstanceOf(Set);
   });
+
+  it('ignores TS path aliases in dts imports', () => {
+    const filtered = collectDtsImports(distDir, {
+      ignoredSpecifiers: collectTsConfigPathAliases(FIXTURES),
+    });
+
+    expect(filtered.has('~shared')).toBe(false);
+  });
 });

package/dist/collectors/tsconfig-aliases.d.ts

@@ -0,0 +1 @@
+export declare function collectTsConfigPathAliases(workspaceDir: string): string[];

package/dist/collectors/tsconfig-aliases.js

@@ -0,0 +1,40 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectTsConfigPathAliases = collectTsConfigPathAliases;
+/**
+ * TypeScript path alias collector.
+ *
+ * Depdoc treats `compilerOptions.paths` entries as internal module specifiers:
+ * they are resolved by TypeScript/bundlers, not package manager dependencies.
+ */
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const ts = require("typescript");
+const TSCONFIG_RE = /^tsconfig(?:\..*)?\.json$/;
+function collectTsConfigPathAliases(workspaceDir) {
+    const aliases = new Set();
+    let entries;
+    try {
+        entries = (0, node_fs_1.readdirSync)(workspaceDir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    for (const entry of entries) {
+        if (!entry.isFile() || !TSCONFIG_RE.test(entry.name))
+            continue;
+        const configPath = node_path_1.default.join(workspaceDir, entry.name);
+        const config = ts.readConfigFile(configPath, ts.sys.readFile);
+        if (config.error || !config.config)
+            continue;
+        const parsed = ts.parseJsonConfigFileContent(config.config, ts.sys, node_path_1.default.dirname(configPath), undefined, configPath);
+        for (const alias of Object.keys(parsed.options.paths ?? {})) {
+            aliases.add(alias);
+        }
+    }
+    return [...aliases].sort();
+}
+//# sourceMappingURL=tsconfig-aliases.js.map

package/dist/collectors/tsconfig-aliases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsconfig-aliases.js","sourceRoot":"","sources":["../../src/collectors/tsconfig-aliases.ts"],"names":[],"mappings":";;;;;AAYA,gEAgCC;AA5CD;;;;;GAKG;AACH,qCAAmD;AACnD,0DAA6B;AAC7B,iCAAkC;AAElC,MAAM,WAAW,GAAG,2BAA2B,CAAC;AAEhD,SAAgB,0BAA0B,CAAC,YAAoB;IAC7D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAElC,IAAI,OAAiB,CAAC;IAEtB,IAAI,CAAC;QACH,OAAO,GAAG,IAAA,qBAAW,EAAC,YAAY,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,SAAS;QAE/D,MAAM,UAAU,GAAG,mBAAI,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,EAAE,CAAC,cAAc,CAAC,UAAU,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9D,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,SAAS;QAE7C,MAAM,MAAM,GAAG,EAAE,CAAC,0BAA0B,CAC1C,MAAM,CAAC,MAAM,EACb,EAAE,CAAC,GAAG,EACN,mBAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EACxB,SAAS,EACT,UAAU,CACX,CAAC;QAEF,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;YAC5D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;AAC7B,CAAC"}

package/dist/collectors/workspaces.d.ts

@@ -1,2 +1,2 @@
 import type { WorkspaceContext } from '../model/types';
-export declare function loadWorkspaces(rootDir: string, withDts: boolean): WorkspaceContext[];
+export declare function loadWorkspaces(rootDir: string, withDts: boolean, ignoredImports?: readonly string[]): WorkspaceContext[];

package/dist/collectors/workspaces.js

@@ -17,10 +17,17 @@ const node_path_1 = __importDefault(require("node:path"));
 const imports_1 = require("../lib/imports");
 const package_json_1 = require("../lib/package-json");
 const rules_1 = require("../model/rules");
-function collectUsage(workspace, withDts) {
+const tsconfig_aliases_1 = require("./tsconfig-aliases");
+function collectUsage(workspace, withDts, ignoredImports) {
     const sourceFiles = (0, imports_1.collectSourceFiles)(workspace.dir, workspace.pkg);
+    const ignoredSpecifiers = [
+        ...ignoredImports,
+        ...(0, tsconfig_aliases_1.collectTsConfigPathAliases)(workspace.dir),
+    ];
     workspace.sourceFileCount = sourceFiles.length;
-    for (const entry of (0, imports_1.collectSourceImportsFromFiles)(sourceFiles)) {
+    for (const entry of (0, imports_1.collectSourceImportsFromFiles)(sourceFiles, {
+        ignoredSpecifiers,
+    })) {
         if (!workspace.sourceUsage.has(entry.packageName)) {
             workspace.sourceUsage.set(entry.packageName, {
                 files: new Set(),
@@ -39,10 +46,10 @@ function collectUsage(workspace, withDts) {
     }
     const distDir = node_path_1.default.join(workspace.dir, 'dist');
     if (withDts || (0, node_fs_1.existsSync)(distDir)) {
-        workspace.dtsImports = (0, imports_1.collectDtsImports)(distDir);
+        workspace.dtsImports = (0, imports_1.collectDtsImports)(distDir, { ignoredSpecifiers });
     }
 }
-function loadWorkspaces(rootDir, withDts) {
+function loadWorkspaces(rootDir, withDts, ignoredImports = []) {
     const rootPkg = (0, package_json_1.readPackageJson)(rootDir);
     const raw = (0, node_child_process_1.execSync)('yarn workspaces list --json', {
         cwd: rootDir,
@@ -82,7 +89,7 @@ function loadWorkspaces(rootDir, withDts) {
             hasSrc: (0, node_fs_1.existsSync)(node_path_1.default.join(dir, 'src')),
             hasDist: (0, node_fs_1.existsSync)(node_path_1.default.join(dir, 'dist')),
         };
-        collectUsage(ctx, withDts);
+        collectUsage(ctx, withDts, ignoredImports);
         workspaces.push(ctx);
     }
     return workspaces;

package/dist/collectors/workspaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"workspaces.js","sourceRoot":"","sources":["../../src/collectors/workspaces.ts"],"names":[],"mappings":";;;;;AAsDA,wCAoDC;AA1GD;;;;;;GAMG;AACH,2DAA8C;AAC9C,qCAAqC;AACrC,0DAA6B;AAE7B,4CAIwB;AACxB,sDAAsD;AACtD,0CAAiD;AAQjD,SAAS,YAAY,CAAC,SAA2B,EAAE,OAAgB;IACjE,MAAM,WAAW,GAAG,IAAA,4BAAkB,EAAC,SAAS,CAAC,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC;IAErE,SAAS,CAAC,eAAe,GAAG,WAAW,CAAC,MAAM,CAAC;IAE/C,KAAK,MAAM,KAAK,IAAI,IAAA,uCAA6B,EAAC,WAAW,CAAC,EAAE,CAAC;QAC/D,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;YAClD,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE;gBAC3C,KAAK,EAAE,IAAI,GAAG,EAAE;gBAChB,YAAY,EAAE,IAAI,GAAG,EAAE;gBACvB,aAAa,EAAE,IAAI,GAAG,EAAE;aACzB,CAAC,CAAC;QACL,CAAC;QACD,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAE,CAAC;QAE5D,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACrB,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,mBAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACjD,IAAI,OAAO,IAAI,IAAA,oBAAU,EAAC,OAAO,CAAC,EAAE,CAAC;QACnC,SAAS,CAAC,UAAU,GAAG,IAAA,2BAAiB,EAAC,OAAO,CAAC,CAAC;IACpD,CAAC;AACH,CAAC;AAED,SAAgB,cAAc,CAC5B,OAAe,EACf,OAAgB;IAEhB,MAAM,OAAO,GAAG,IAAA,8BAAe,EAAC,OAAO,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,IAAA,6BAAQ,EAAC,6BAA6B,EAAE;QAClD,GAAG,EAAE,OAAO;KACb,CAAC,CAAC,QAAQ,EAAE,CAAC;IACd,MAAM,MAAM,GAAG,GAAG;SACf,IAAI,EAAE;SACN,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAsB,CAAC;SACpD,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,KAAK,GAAG,CAAC,CAAC;IAEvC,MAAM,IAAI,GAAqB;QAC7B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,GAAG;QACb,GAAG,EAAE,OAAO;QACZ,GAAG,EAAE,OAAO;QACZ,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,IAAI;QACZ,WAAW,EAAE,IAAI,GAAG,EAAE;QACtB,UAAU,EAAE,IAAI,GAAG,EAAE;QACrB,MAAM,EAAE,KAAK;QACb,OAAO,EAAE,KAAK;KACf,CAAC;IAEF,MAAM,UAAU,GAAuB,CAAC,IAAI,CAAC,CAAC;IAE9C,KAAK,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,mBAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,GAAG,GAAG,IAAA,8BAAe,EAAC,GAAG,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,IAAA,uBAAe,EAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9D,MAAM,GAAG,GAAqB;YAC5B,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI;YACzB,QAAQ,EAAE,EAAE,CAAC,QAAQ;YACrB,GAAG;YACH,GAAG;YACH,IAAI;YACJ,MAAM,EAAE,KAAK;YACb,WAAW,EAAE,IAAI,GAAG,EAAE;YACtB,UAAU,EAAE,IAAI,GAAG,EAAE;YACrB,MAAM,EAAE,IAAA,oBAAU,EAAC,mBAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACzC,OAAO,EAAE,IAAA,oBAAU,EAAC,mBAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;SAC5C,CAAC;QAEF,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC3B,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}
+{"version":3,"file":"workspaces.js","sourceRoot":"","sources":["../../src/collectors/workspaces.ts"],"names":[],"mappings":"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"}

package/dist/lib/imports.d.ts

@@ -4,8 +4,11 @@ export interface ImportEntry {
     isTypeOnly: boolean;
     file: string;
 }
+export interface ImportCollectionOptions {
+    ignoredSpecifiers?: readonly string[];
+}
 export declare function getPackageName(specifier: string): string | null;
 export declare function collectSourceFiles(srcDirOrWorkspaceDir: string, pkg?: PackageJson): string[];
-export declare function collectSourceImportsFromFiles(files: string[]): ImportEntry[];
-export declare function collectSourceImports(srcDirOrWorkspaceDir: string, pkg?: PackageJson): ImportEntry[];
-export declare function collectDtsImports(distDir: string): Set<string>;
+export declare function collectSourceImportsFromFiles(files: string[], options?: ImportCollectionOptions): ImportEntry[];
+export declare function collectSourceImports(srcDirOrWorkspaceDir: string, pkg?: PackageJson, options?: ImportCollectionOptions): ImportEntry[];
+export declare function collectDtsImports(distDir: string, options?: ImportCollectionOptions): Set<string>;

package/dist/lib/imports.js

@@ -64,6 +64,18 @@ function getPackageName(specifier) {
     const slash = specifier.indexOf('/');
     return slash === -1 ? specifier : specifier.slice(0, slash);
 }
+function globToRegExp(pattern) {
+    const escaped = pattern.replaceAll(/[-[\]{}()+?.,\\^$|#\s]/g, String.raw `\$&`);
+    return new RegExp(`^${escaped.replaceAll('*', '.*')}$`);
+}
+function matchesSpecifierPattern(specifier, pattern) {
+    return pattern.includes('*')
+        ? globToRegExp(pattern).test(specifier)
+        : specifier === pattern;
+}
+function isIgnoredSpecifier(specifier, options) {
+    return (options.ignoredSpecifiers ?? []).some((pattern) => matchesSpecifierPattern(specifier, pattern));
+}
 function walkFiles(dir, filter) {
     const results = [];
     try {
@@ -109,10 +121,14 @@ function getScriptKind(file) {
 function stringLiteralText(node) {
     return node && ts.isStringLiteralLike(node) ? node.text : null;
 }
-function addImport(results, file, specifier, isTypeOnly) {
+function addImport(results, file, specifier, isTypeOnly, options) {
+    if (isIgnoredSpecifier(specifier, options))
+        return;
     const packageName = getPackageName(specifier);
     if (!packageName)
         return;
+    if (isIgnoredSpecifier(packageName, options))
+        return;
     results.push({ packageName, isTypeOnly, file });
 }
 function addModuleReference(results, specifier, isTypeOnly) {
@@ -203,7 +219,7 @@ function extractModuleReferences(file, content, options = {}) {
 function extractImports(file, content, options = {}) {
     const results = [];
     for (const reference of extractModuleReferences(file, content, options)) {
-        addImport(results, file, reference.specifier, reference.isTypeOnly);
+        addImport(results, file, reference.specifier, reference.isTypeOnly, options);
     }
     return results;
 }
@@ -323,17 +339,17 @@ function collectSourceFiles(srcDirOrWorkspaceDir, pkg) {
     }
     return [...files].sort();
 }
-function collectSourceImportsFromFiles(files) {
-    return files.flatMap((file) => extractImports(file, (0, node_fs_1.readFileSync)(file, 'utf8')));
+function collectSourceImportsFromFiles(files, options = {}) {
+    return files.flatMap((file) => extractImports(file, (0, node_fs_1.readFileSync)(file, 'utf8'), options));
 }
-function collectSourceImports(srcDirOrWorkspaceDir, pkg) {
-    return collectSourceImportsFromFiles(collectSourceFiles(srcDirOrWorkspaceDir, pkg));
+function collectSourceImports(srcDirOrWorkspaceDir, pkg, options = {}) {
+    return collectSourceImportsFromFiles(collectSourceFiles(srcDirOrWorkspaceDir, pkg), options);
 }
-function collectDtsImports(distDir) {
+function collectDtsImports(distDir, options = {}) {
     const files = walkFiles(distDir, (name) => DTS_RE.test(name));
     const result = new Set();
     for (const file of files) {
-        for (const { packageName } of extractImports(file, (0, node_fs_1.readFileSync)(file, 'utf8'), { includeDtsForms: true })) {
+        for (const { packageName } of extractImports(file, (0, node_fs_1.readFileSync)(file, 'utf8'), { ...options, includeDtsForms: true })) {
             result.add(packageName);
         }
     }