knip 6.29.0 → 6.30.0

package/dist/typescript/get-published-type-dependencies.js

@@ -0,0 +1,155 @@
+import { readFileSync } from 'node:fs';
+import { IS_DTS } from '../constants.js';
+import { isFile } from '../util/fs.js';
+import { _syncGlob } from '../util/glob.js';
+import { getDefinitelyTypedFor, getPackageNameFromModuleSpecifier, isDefinitelyTyped, isStartsLikePackageName, sanitizeSpecifier, } from '../util/modules.js';
+import { getPublishedTypeManifest, getPublishedTypeEntrySpecifiers, getPublishedTypeExportSpecifiers, isPublishedTypeExportTarget, toDeclarationSpecifier, } from '../util/package-json.js';
+import { dirname, join, relative } from '../util/path.js';
+import { _resolveDeclarationSync } from '../util/resolve.js';
+import { _getImportsAndExports } from './get-imports-and-exports.js';
+import { buildVisitor } from './visitors/walk.js';
+const options = {
+    skipTypeOnly: false,
+    isFixExports: false,
+    isFixTypes: false,
+    isReportExports: false,
+    tags: [[], []],
+};
+const resolveNothing = () => undefined;
+const toGlobPattern = (specifier) => {
+    const index = specifier.indexOf('*');
+    return `${specifier.slice(0, index)}**/*${specifier.slice(index + 1).replaceAll('*', '**')}`;
+};
+const isInWorkspace = (filePath, workspaceDir) => filePath === workspaceDir || filePath.startsWith(`${workspaceDir}/`);
+const toDeclarationPath = (filePath) => {
+    if (IS_DTS.test(filePath))
+        return filePath;
+    const candidate = toDeclarationSpecifier(filePath);
+    if (candidate && isFile(candidate))
+        return candidate;
+};
+const getDeclarationPaths = (specifiers, workspaceDir) => {
+    const paths = new Set();
+    const patterns = [];
+    for (const specifier of specifiers) {
+        if (specifier.includes('*')) {
+            patterns.push(toGlobPattern(specifier));
+        }
+        else if (IS_DTS.test(specifier)) {
+            const filePath = join(workspaceDir, specifier);
+            if (isFile(filePath))
+                paths.add(filePath);
+        }
+    }
+    if (patterns.length > 0) {
+        for (const filePath of _syncGlob({ cwd: workspaceDir, patterns })) {
+            if (IS_DTS.test(filePath))
+                paths.add(filePath);
+        }
+    }
+    return paths;
+};
+const getPublishedTypeEntryPaths = (manifest, workspaceDir) => {
+    const { candidates, versioned } = getPublishedTypeEntrySpecifiers(manifest);
+    const paths = getDeclarationPaths(versioned, workspaceDir);
+    for (const specifier of candidates) {
+        const filePath = join(workspaceDir, specifier);
+        if (!isFile(filePath))
+            continue;
+        paths.add(filePath);
+        break;
+    }
+    for (const filePath of getDeclarationPaths(getPublishedTypeExportSpecifiers(manifest.exports), workspaceDir)) {
+        if (isPublishedTypeExportTarget(manifest.exports, `./${relative(workspaceDir, filePath)}`))
+            paths.add(filePath);
+    }
+    return paths;
+};
+export const createPublishedTypeDependencyAnalyzer = () => {
+    const visitor = buildVisitor([]);
+    const packageJsonCache = new Map();
+    const packageTypesCache = new Map();
+    const loadPackageJson = (filePath) => {
+        if (packageJsonCache.has(filePath))
+            return packageJsonCache.get(filePath);
+        let manifest;
+        try {
+            manifest = JSON.parse(readFileSync(filePath, 'utf8'));
+        }
+        catch { }
+        packageJsonCache.set(filePath, manifest);
+        return manifest;
+    };
+    const packageProvidesTypes = (packageJsonPath, resolvedPath) => {
+        const cached = packageTypesCache.get(packageJsonPath);
+        if (cached !== undefined)
+            return cached;
+        const manifest = loadPackageJson(packageJsonPath);
+        const hasTypes = toDeclarationPath(resolvedPath) !== undefined ||
+            Boolean(manifest && (manifest.types || manifest.typings || manifest.typesVersions)) ||
+            isFile(join(dirname(packageJsonPath), 'index.d.ts'));
+        packageTypesCache.set(packageJsonPath, hasTypes);
+        return hasTypes;
+    };
+    const getExternalDependency = (packageName, containingFile, declaredDependencies) => {
+        const resolved = _resolveDeclarationSync(packageName, containingFile);
+        if (isDefinitelyTyped(packageName))
+            return { packageName, isResolved: resolved !== undefined };
+        if (resolved?.packageJsonPath) {
+            const installedName = loadPackageJson(resolved.packageJsonPath)?.name;
+            if (installedName && isDefinitelyTyped(installedName))
+                return { packageName: installedName, isResolved: true };
+            if (packageProvidesTypes(resolved.packageJsonPath, resolved.path))
+                return { packageName, isResolved: true };
+        }
+        const typesPackageName = getDefinitelyTypedFor(packageName);
+        if (_resolveDeclarationSync(typesPackageName, containingFile) || declaredDependencies.has(typesPackageName))
+            return { packageName: typesPackageName, isResolved: true };
+        return { packageName, isResolved: resolved !== undefined };
+    };
+    return (workspace, manifest) => {
+        const dependencies = [];
+        const declaredDependencies = new Set([
+            ...Object.keys(manifest.dependencies ?? {}),
+            ...Object.keys(manifest.devDependencies ?? {}),
+            ...Object.keys(manifest.peerDependencies ?? {}),
+            ...Object.keys(manifest.optionalDependencies ?? {}),
+        ]);
+        const files = getPublishedTypeEntryPaths(getPublishedTypeManifest(manifest), workspace.dir);
+        for (const filePath of files) {
+            let file;
+            try {
+                file = _getImportsAndExports(filePath, readFileSync(filePath, 'utf8'), resolveNothing, options, false, true, visitor, undefined);
+            }
+            catch {
+                continue;
+            }
+            for (const _import of file.imports.unresolved) {
+                const specifier = sanitizeSpecifier(_import.specifier);
+                const packageName = isStartsLikePackageName(specifier)
+                    ? getPackageNameFromModuleSpecifier(specifier)
+                    : undefined;
+                if (!packageName || packageName === workspace.pkgName) {
+                    if (!packageName && !specifier.startsWith('.'))
+                        continue;
+                    const resolved = _resolveDeclarationSync(specifier, filePath);
+                    const declarationPath = resolved && toDeclarationPath(resolved.path);
+                    if (declarationPath && isInWorkspace(declarationPath, workspace.dir))
+                        files.add(declarationPath);
+                    continue;
+                }
+                const external = getExternalDependency(packageName, filePath, declaredDependencies);
+                dependencies.push({
+                    containingFilePath: filePath,
+                    packageName: external.packageName,
+                    specifier,
+                    pos: _import.pos,
+                    line: _import.line,
+                    col: _import.col,
+                    isResolved: external.isResolved,
+                });
+            }
+        }
+        return dependencies;
+    };
+};

package/dist/typescript/visitors/calls.js

@@ -221,6 +221,14 @@ export function handleCallExpression(node, s) {
     for (const arg of node.arguments) {
         if (arg.type === 'Identifier')
             markRefIfNs(arg.name);
+        else if (arg.type === 'ArrowFunctionExpression' && arg.expression) {
+            const body = arg.body.type === 'AwaitExpression' ? arg.body.argument : arg.body;
+            if (body.type === 'ImportExpression' && isStringLiteral(body.source)) {
+                s.handledImportExpressions.add(body.start);
+                const specifier = getStringValue(body.source);
+                s.addImport(specifier, undefined, undefined, undefined, body.source.start, IMPORT_FLAGS.DYNAMIC | IMPORT_FLAGS.LOADER);
+            }
+        }
         else if (arg.type === 'ArrayExpression') {
             for (const el of arg.elements ?? []) {
                 if (el?.type === 'Identifier')

package/dist/util/catalog.d.ts

@@ -1,6 +1,11 @@
 import type { CatalogContainer } from '../CatalogCounselor.ts';
 import type { PackageJson } from '../types/package-json.ts';
 export declare const DEFAULT_CATALOG = "default";
+export type CatalogReference = {
+    catalogName: string;
+    packageName: string;
+};
+export declare const getCatalogReference: (specifier: string) => CatalogReference | undefined;
 export declare const getCatalogContainer: (cwd: string, manifest: PackageJson, manifestPath: string, pnpmWorkspacePath?: string, pnpmWorkspace?: any) => Promise<CatalogContainer>;
 export declare const parseCatalog: (container: CatalogContainer) => Set<string>;
-export declare const extractCatalogReferences: (manifest: PackageJson) => Set<string>;
+export declare const extractCatalogReferences: (manifest: PackageJson) => CatalogReference[];

package/dist/util/catalog.js

@@ -1,7 +1,21 @@
 import { isFile } from './fs.js';
 import { _load } from './loader.js';
+import { getPackageNameFromModuleSpecifier } from './modules.js';
 import { basename, join } from './path.js';
 export const DEFAULT_CATALOG = 'default';
+const CATALOG_PROTOCOL = '@catalog:';
+export const getCatalogReference = (specifier) => {
+    const protocolIndex = specifier.lastIndexOf(CATALOG_PROTOCOL);
+    if (protocolIndex <= 0)
+        return;
+    const packageName = specifier.slice(0, protocolIndex);
+    if (getPackageNameFromModuleSpecifier(packageName) !== packageName)
+        return;
+    return {
+        catalogName: specifier.slice(protocolIndex + CATALOG_PROTOCOL.length) || DEFAULT_CATALOG,
+        packageName,
+    };
+};
 export const getCatalogContainer = async (cwd, manifest, manifestPath, pnpmWorkspacePath, pnpmWorkspace) => {
     const filePath = pnpmWorkspacePath ?? (isFile(cwd, '.yarnrc.yml') ? join(cwd, '.yarnrc.yml') : manifestPath);
     const yarnWorkspace = basename(filePath) === '.yarnrc.yml' ? await _load(filePath) : undefined;
@@ -43,14 +57,14 @@ export const parseCatalog = (container) => {
     return entries;
 };
 export const extractCatalogReferences = (manifest) => {
-    const catalogReferences = new Set();
+    const catalogReferences = [];
     const checkDependencies = (dependencies) => {
         if (!dependencies)
             return;
         for (const [name, version] of Object.entries(dependencies)) {
             if (typeof version === 'string' && version.startsWith('catalog:')) {
                 const catalogName = version.slice('catalog:'.length) || DEFAULT_CATALOG;
-                catalogReferences.add([catalogName, name].join(':'));
+                catalogReferences.push({ catalogName, packageName: name });
             }
         }
     };

package/dist/util/cli-arguments.d.ts

@@ -1,4 +1,4 @@
-export declare const helpText = "\u2702\uFE0F  Find unused dependencies, exports and files in your JavaScript and TypeScript projects\n\nUsage: knip [options]\n\nOptions:\n  -h, --help                   Print this help text\n  -V, --version                Print version\n  -n, --no-progress            Don't show dynamic progress updates (automatically enabled in CI environments)\n  -c, --config [file]          Configuration file path\n                               (default: [.]knip.json[c], knip.(js|ts), knip.config.(js|ts) or package.json#knip)\n      --use-tsconfig-files     Use tsconfig.json to define project files (override `project` patterns)\n  -t, --tsConfig [file]        TypeScript configuration path (default: tsconfig.json)\n\nMode\n      --cache                  Enable caching\n      --cache-location         Change cache location (default: node_modules/.cache/knip)\n      --include-entry-exports  Include entry files when reporting unused exports\n      --no-gitignore           Don't respect .gitignore\n  -p, --production             Analyze only production source files (e.g. no test files, devDependencies)\n  -s, --strict                 Consider only direct dependencies of workspace (not devDependencies, not other workspaces)\n  -w, --watch                  Watch mode\n\nScope\n  -W, --workspace [filter]     Filter workspaces by name, directory, or glob (can be repeated)\n  -D, --directory [dir]        Run process from a different directory (default: cwd)\n      --include                Include provided issue type(s), can be comma-separated or repeated (1)\n      --exclude                Exclude provided issue type(s) from report, can be comma-separated or repeated (1)\n      --dependencies           Shortcut for --include dependencies,unlisted,binaries,unresolved,catalog\n      --exports                Shortcut for --include exports,nsExports,types,nsTypes,enumMembers,namespaceMembers,duplicates\n      --files                  Shortcut for --include files\n      --cycles                 Shortcut for --include cycles (circular dependencies)\n      --tags                   Include or exclude tagged exports\n\nFix\n  -f, --fix                    Fix issues (modifies files in your repo)\n      --fix-type               Fix only issues of type, can be comma-separated or repeated (2)\n      --allow-remove-files     Allow Knip to remove files (with --fix)\n  -F, --format                 Format modified files after --fix using the local formatter\n\nOutput\n      --preprocessor           Preprocess the results before providing it to the reporter(s), can be repeated\n      --preprocessor-options   Pass extra options to the preprocessor (as JSON string, see --reporter-options example)\n      --reporter               Select reporter (default: symbols), can be repeated (3)\n      --reporter-options       Pass extra options to the reporter (as JSON string, see example)\n      --no-config-hints        Suppress configuration hints\n      --no-tag-hints           Suppress tag hints\n      --treat-config-hints-as-errors   Exit with non-zero code (1) if there are any configuration hints\n      --treat-tag-hints-as-errors      Exit with non-zero code (1) if there are any tag hints\n      --max-issues             Maximum number of total issues before non-zero exit code (default: 0)\n      --max-show-issues        Maximum number of issues to display per type\n      --no-exit-code           Always exit with code zero (0)\n\nTroubleshooting\n  -d, --debug                  Show debug output\n      --memory                 Measure memory usage and display data table\n      --memory-realtime        Log memory usage in realtime\n      --performance            Measure count and running time of key functions and display stats table\n      --performance-fn [name]  Measure only function [name]\n  -u, --duration               Print total running time (zero overhead, no instrumentation)\n      --trace                  Show trace output\n      --trace-dependency [name]  Show files that import the named dependency\n      --trace-export [name]    Show trace output for named export(s)\n      --trace-file [file]      Show trace output for exports in file\n\n(1) Issue types: files, dependencies, unlisted, unresolved, exports, nsExports, types, nsTypes, enumMembers, namespaceMembers, duplicates, catalog, cycles\n(2) Fixable issue types: dependencies, exports, types, files, catalog\n(3) Built-in reporters: symbols (default), compact, codeowners, cycles, json, codeclimate, markdown, disclosure, github-actions\n\nExamples:\n\n$ knip\n$ knip --production\n$ knip --workspace packages/client --include files,dependencies\n$ knip --workspace @myorg/* --workspace '!@myorg/legacy'\n$ knip --workspace './apps/*' --workspace '@shared/utils'\n$ knip -c ./config/knip.json --reporter compact\n$ knip --reporter codeowners --reporter-options '{\"path\":\".github/CODEOWNERS\"}'\n$ knip --tags=-lintignore\n\nWebsite: https://knip.dev";
+export declare const helpText = "\u2702\uFE0F  Find unused dependencies, exports and files in your JavaScript and TypeScript projects\n\nUsage: knip [options]\n\nOptions:\n  -h, --help                   Print this help text\n  -V, --version                Print version\n  -n, --no-progress            Don't show dynamic progress updates (automatically enabled in CI environments)\n  -c, --config [file]          Configuration file path\n                               (default: [.]knip.json[c], knip.(js|ts), knip.config.(js|ts) or package.json#knip)\n      --use-tsconfig-files     Use tsconfig.json to define project files (override `project` patterns)\n  -t, --tsConfig [file]        TypeScript configuration path (default: tsconfig.json)\n\nMode\n      --cache                  Enable caching\n      --cache-location         Change cache location (default: node_modules/.cache/knip)\n      --include-entry-exports  Include entry files when reporting unused exports\n      --no-gitignore           Don't respect .gitignore\n  -p, --production             Analyze only production source files (e.g. no test files, devDependencies)\n  -s, --strict                 Consider only direct dependencies of workspace (not devDependencies, not other workspaces)\n  -w, --watch                  Watch mode\n\nScope\n  -W, --workspace [filter]     Filter workspaces by name, directory, or glob (can be repeated)\n  -D, --directory [dir]        Run process from a different directory (default: cwd)\n      --include                Include provided issue type(s), can be comma-separated or repeated (1)\n      --exclude                Exclude provided issue type(s) from report, can be comma-separated or repeated (1)\n      --dependencies           Shortcut for --include dependencies,unlisted,binaries,unresolved,catalog,catalogReferences\n      --exports                Shortcut for --include exports,nsExports,types,nsTypes,enumMembers,namespaceMembers,duplicates\n      --files                  Shortcut for --include files\n      --cycles                 Shortcut for --include cycles (circular dependencies)\n      --tags                   Include or exclude tagged exports\n\nFix\n  -f, --fix                    Fix issues (modifies files in your repo)\n      --fix-type               Fix only issues of type, can be comma-separated or repeated (2)\n      --allow-remove-files     Allow Knip to remove files (with --fix)\n  -F, --format                 Format modified files after --fix using the local formatter\n\nOutput\n      --preprocessor           Preprocess the results before providing it to the reporter(s), can be repeated\n      --preprocessor-options   Pass extra options to the preprocessor (as JSON string, see --reporter-options example)\n      --reporter               Select reporter (default: symbols), can be repeated (3)\n      --reporter-options       Pass extra options to the reporter (as JSON string, see example)\n      --no-config-hints        Suppress configuration hints\n      --no-tag-hints           Suppress tag hints\n      --treat-config-hints-as-errors   Exit with non-zero code (1) if there are any configuration hints\n      --treat-tag-hints-as-errors      Exit with non-zero code (1) if there are any tag hints\n      --max-issues             Maximum number of total issues before non-zero exit code (default: 0)\n      --max-show-issues        Maximum number of issues to display per type\n      --no-exit-code           Always exit with code zero (0)\n\nTroubleshooting\n  -d, --debug                  Show debug output\n      --memory                 Measure memory usage and display data table\n      --memory-realtime        Log memory usage in realtime\n      --performance            Measure count and running time of key functions and display stats table\n      --performance-fn [name]  Measure only function [name]\n  -u, --duration               Print total running time (zero overhead, no instrumentation)\n      --trace                  Show trace output\n      --trace-dependency [name]  Show files that import the named dependency\n      --trace-export [name]    Show trace output for named export(s)\n      --trace-file [file]      Show trace output for exports in file\n\n(1) Issue types: files, dependencies, unlisted, unresolved, exports, nsExports, types, nsTypes, enumMembers, namespaceMembers, duplicates, catalog, catalogReferences, cycles\n(2) Fixable issue types: dependencies, exports, types, files, catalog\n(3) Built-in reporters: symbols (default), compact, codeowners, cycles, json, codeclimate, markdown, disclosure, github-actions, sarif\n\nExamples:\n\n$ knip\n$ knip --production\n$ knip --workspace packages/client --include files,dependencies\n$ knip --workspace @myorg/* --workspace '!@myorg/legacy'\n$ knip --workspace './apps/*' --workspace '@shared/utils'\n$ knip -c ./config/knip.json --reporter compact\n$ knip --reporter codeowners --reporter-options '{\"path\":\".github/CODEOWNERS\"}'\n$ knip --tags=-lintignore\n\nWebsite: https://knip.dev";
 export type ParsedCLIArgs = ReturnType<typeof parseCLIArgs>;
 export default function parseCLIArgs(): {
     cache?: boolean | undefined;

package/dist/util/cli-arguments.js

@@ -26,7 +26,7 @@ Scope
   -D, --directory [dir]        Run process from a different directory (default: cwd)
       --include                Include provided issue type(s), can be comma-separated or repeated (1)
       --exclude                Exclude provided issue type(s) from report, can be comma-separated or repeated (1)
-      --dependencies           Shortcut for --include dependencies,unlisted,binaries,unresolved,catalog
+      --dependencies           Shortcut for --include dependencies,unlisted,binaries,unresolved,catalog,catalogReferences
       --exports                Shortcut for --include exports,nsExports,types,nsTypes,enumMembers,namespaceMembers,duplicates
       --files                  Shortcut for --include files
       --cycles                 Shortcut for --include cycles (circular dependencies)
@@ -63,9 +63,9 @@ Troubleshooting
       --trace-export [name]    Show trace output for named export(s)
       --trace-file [file]      Show trace output for exports in file
 
-(1) Issue types: files, dependencies, unlisted, unresolved, exports, nsExports, types, nsTypes, enumMembers, namespaceMembers, duplicates, catalog, cycles
+(1) Issue types: files, dependencies, unlisted, unresolved, exports, nsExports, types, nsTypes, enumMembers, namespaceMembers, duplicates, catalog, catalogReferences, cycles
 (2) Fixable issue types: dependencies, exports, types, files, catalog
-(3) Built-in reporters: symbols (default), compact, codeowners, cycles, json, codeclimate, markdown, disclosure, github-actions
+(3) Built-in reporters: symbols (default), compact, codeowners, cycles, json, codeclimate, markdown, disclosure, github-actions, sarif
 
 Examples:
 

package/dist/util/codeowners.js

@@ -12,7 +12,7 @@ export function parseCodeowners(content) {
         return { owners, match: picomatch(expandIgnorePatterns([pattern], true)) };
     });
     return (filePath) => {
-        for (const matcher of [...matchers].reverse()) {
+        for (const matcher of matchers.toReversed()) {
             if (matcher.match(filePath)) {
                 return matcher.owners;
             }

package/dist/util/create-input-handler.js

@@ -55,11 +55,17 @@ export const createInputHandler = (deputy, chief, isGitIgnored, addIssue, extern
         const isWorkspace = chief.workspacesByPkgName.has(packageName);
         const inputWorkspace = getWorkspaceFor(input, chief, workspace);
         if (inputWorkspace) {
-            let isHandled = deputy.maybeAddReferencedExternalDependency(inputWorkspace, packageName, isConfig(input), input.isTypeOnly);
+            let isHandled = deputy.maybeAddReferencedExternalDependency(inputWorkspace, packageName, {
+                isDevOnly: isConfig(input),
+                isTypeOnly: input.isTypeOnly,
+            });
             if (input.isTypeOnly && input.containingFilePath) {
                 const owningWorkspace = chief.findWorkspaceByFilePath(input.containingFilePath);
                 if (owningWorkspace && owningWorkspace !== inputWorkspace) {
-                    const isOwnerHandled = deputy.maybeAddReferencedExternalDependency(owningWorkspace, packageName, isConfig(input), input.isTypeOnly);
+                    const isOwnerHandled = deputy.maybeAddReferencedExternalDependency(owningWorkspace, packageName, {
+                        isDevOnly: isConfig(input),
+                        isTypeOnly: input.isTypeOnly,
+                    });
                     isHandled = isHandled || isOwnerHandled;
                 }
             }

package/dist/util/create-options.d.ts

@@ -936,7 +936,7 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
             project?: string | string[] | undefined;
         } | undefined;
         $schema?: string | undefined;
-        rules?: Partial<Record<"binaries" | "catalog" | "cycles" | "dependencies" | "devDependencies" | "duplicates" | "enumMembers" | "exports" | "files" | "namespaceMembers" | "nsExports" | "nsTypes" | "optionalPeerDependencies" | "types" | "unlisted" | "unresolved", "error" | "off" | "warn">> | undefined;
+        rules?: Partial<Record<"binaries" | "catalog" | "catalogReferences" | "cycles" | "dependencies" | "devDependencies" | "duplicates" | "enumMembers" | "exports" | "files" | "namespaceMembers" | "nsExports" | "nsTypes" | "optionalPeerDependencies" | "types" | "unlisted" | "unresolved", "error" | "off" | "warn">> | undefined;
         entry?: string | string[] | undefined;
         project?: string | string[] | undefined;
         paths?: Record<string, string[]> | undefined;
@@ -947,7 +947,7 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
         ignoreMembers?: (string | RegExp)[] | undefined;
         ignoreUnresolved?: (string | RegExp)[] | undefined;
         ignoreExportsUsedInFile?: boolean | Record<string, boolean | undefined> | undefined;
-        ignoreIssues?: Record<string, ("binaries" | "catalog" | "cycles" | "dependencies" | "devDependencies" | "duplicates" | "enumMembers" | "exports" | "files" | "namespaceMembers" | "nsExports" | "nsTypes" | "optionalPeerDependencies" | "types" | "unlisted" | "unresolved")[]> | undefined;
+        ignoreIssues?: Record<string, ("binaries" | "catalog" | "catalogReferences" | "cycles" | "dependencies" | "devDependencies" | "duplicates" | "enumMembers" | "exports" | "files" | "namespaceMembers" | "nsExports" | "nsTypes" | "optionalPeerDependencies" | "types" | "unlisted" | "unresolved")[]> | undefined;
         cycles?: {
             allow?: string[][] | undefined;
             dynamicImports?: boolean | undefined;
@@ -960,8 +960,8 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
         tags?: string[] | undefined;
         treatConfigHintsAsErrors?: boolean | undefined;
         treatTagHintsAsErrors?: boolean | undefined;
-        include?: ("binaries" | "catalog" | "cycles" | "dependencies" | "devDependencies" | "duplicates" | "enumMembers" | "exports" | "files" | "namespaceMembers" | "nsExports" | "nsTypes" | "optionalPeerDependencies" | "types" | "unlisted" | "unresolved")[] | undefined;
-        exclude?: ("binaries" | "catalog" | "cycles" | "dependencies" | "devDependencies" | "duplicates" | "enumMembers" | "exports" | "files" | "namespaceMembers" | "nsExports" | "nsTypes" | "optionalPeerDependencies" | "types" | "unlisted" | "unresolved")[] | undefined;
+        include?: ("binaries" | "catalog" | "catalogReferences" | "cycles" | "dependencies" | "devDependencies" | "duplicates" | "enumMembers" | "exports" | "files" | "namespaceMembers" | "nsExports" | "nsTypes" | "optionalPeerDependencies" | "types" | "unlisted" | "unresolved")[] | undefined;
+        exclude?: ("binaries" | "catalog" | "catalogReferences" | "cycles" | "dependencies" | "devDependencies" | "duplicates" | "enumMembers" | "exports" | "files" | "namespaceMembers" | "nsExports" | "nsTypes" | "optionalPeerDependencies" | "types" | "unlisted" | "unresolved")[] | undefined;
         workspaces?: Record<string, {
             angular?: string | boolean | string[] | {
                 config?: string | string[] | undefined;
@@ -1863,13 +1863,14 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
             ignoreMembers?: (string | RegExp)[] | undefined;
             ignoreUnresolved?: (string | RegExp)[] | undefined;
             ignoreExportsUsedInFile?: boolean | Record<string, boolean | undefined> | undefined;
-            ignoreIssues?: Record<string, ("binaries" | "catalog" | "cycles" | "dependencies" | "devDependencies" | "duplicates" | "enumMembers" | "exports" | "files" | "namespaceMembers" | "nsExports" | "nsTypes" | "optionalPeerDependencies" | "types" | "unlisted" | "unresolved")[]> | undefined;
+            ignoreIssues?: Record<string, ("binaries" | "catalog" | "catalogReferences" | "cycles" | "dependencies" | "devDependencies" | "duplicates" | "enumMembers" | "exports" | "files" | "namespaceMembers" | "nsExports" | "nsTypes" | "optionalPeerDependencies" | "types" | "unlisted" | "unresolved")[]> | undefined;
             includeEntryExports?: boolean | undefined;
         }> | undefined;
     };
     rules: {
         binaries: import("../types/issues.ts").IssueSeverity;
         catalog: import("../types/issues.ts").IssueSeverity;
+        catalogReferences: import("../types/issues.ts").IssueSeverity;
         cycles: import("../types/issues.ts").IssueSeverity;
         dependencies: import("../types/issues.ts").IssueSeverity;
         devDependencies: import("../types/issues.ts").IssueSeverity;

package/dist/util/disk-cache.js

@@ -7,7 +7,7 @@ import { isDirectory, isFile } from './fs.js';
 import { dirname } from './path.js';
 export const mtimeMatches = (filePath, mtimeMs) => {
     try {
-        return fs.statSync(filePath).mtimeMs === mtimeMs;
+        return fs.statSync(filePath, { throwIfNoEntry: false })?.mtimeMs === mtimeMs;
     }
     catch {
         return false;

package/dist/util/errors.js

@@ -1,4 +1,5 @@
 import { core } from 'zod/mini';
+import { substringBefore } from './string.js';
 const isZodErrorLike = (error) => error instanceof core.$ZodError;
 export class ConfigurationError extends Error {
 }
@@ -13,11 +14,11 @@ export const formatCauseMessage = (error, cwd) => {
     let root = error;
     while (root.cause instanceof Error)
         root = root.cause;
-    return root.message.split('\n', 1)[0].replace(`${cwd}/`, '');
+    return substringBefore(root.message, '\n').replace(`${cwd}/`, '');
 };
 export const getKnownErrors = (error) => {
     if (isZodErrorLike(error))
-        return [...error.issues].map(error => {
+        return Array.from(error.issues, error => {
             let message = error.message;
             const details = [];
             if (error.path.length > 0)

package/dist/util/file-entry-cache.js

@@ -31,12 +31,16 @@ export class FileEntryCache {
             return existing;
         let fstat;
         try {
-            fstat = fs.statSync(filePath);
+            fstat = fs.statSync(filePath, { throwIfNoEntry: false });
         }
         catch (error) {
             this.removeEntry(filePath);
             return { key: filePath, notFound: true, err: error };
         }
+        if (!fstat) {
+            this.removeEntry(filePath);
+            return { key: filePath, notFound: true };
+        }
         let meta = this.cache.get(filePath);
         const cSize = fstat.size;
         const cTime = fstat.mtime.getTime();

package/dist/util/fs.js

@@ -7,7 +7,7 @@ import { LoaderError } from './errors.js';
 import { extname, join, toPosix } from './path.js';
 export const isDirectory = (cwdOrPath, name) => {
     try {
-        return statSync(name ? join(cwdOrPath, name) : cwdOrPath).isDirectory();
+        return statSync(name ? join(cwdOrPath, name) : cwdOrPath, { throwIfNoEntry: false })?.isDirectory() ?? false;
     }
     catch {
         return false;
@@ -15,7 +15,7 @@ export const isDirectory = (cwdOrPath, name) => {
 };
 export const isFile = (cwdOrPath, name) => {
     try {
-        return statSync(name ? join(cwdOrPath, name) : cwdOrPath).isFile();
+        return statSync(name ? join(cwdOrPath, name) : cwdOrPath, { throwIfNoEntry: false })?.isFile() ?? false;
     }
     catch {
         return false;

package/dist/util/get-included-issue-types.js

@@ -4,7 +4,7 @@ export const defaultExcludedIssueTypes = ['nsExports', 'nsTypes', 'cycles'];
 const defaultAddOnIssueTypes = ['nsExports', 'nsTypes'];
 const defaultIssueTypes = ISSUE_TYPES.filter(type => !defaultExcludedIssueTypes.includes(type));
 const normalize = (values) => values.flatMap(value => value.split(','));
-export const shorthandDeps = ['dependencies', 'unlisted', 'binaries', 'unresolved', 'catalog'];
+export const shorthandDeps = ['dependencies', 'unlisted', 'binaries', 'unresolved', 'catalog', 'catalogReferences'];
 export const shorthandExports = ['exports', 'types', 'enumMembers', 'namespaceMembers', 'duplicates'];
 export const shorthandFiles = ['files'];
 export const shorthandCycles = ['cycles'];
@@ -22,6 +22,7 @@ export const getIncludedIssueTypes = (options) => {
     if (options.isProduction) {
         _exclude.push('devDependencies');
         _exclude.push('catalog');
+        _exclude.push('catalogReferences');
     }
     else {
         if (_include.includes('dependencies'))

package/dist/util/gitignore-cache.js

@@ -50,7 +50,10 @@ export const setCachedGitignore = (cwd, workspaceDirs, gitignoreFiles, ignores,
     for (const file of gitignoreFiles) {
         const abs = path.isAbsolute(file) ? file : path.resolve(cwd, file);
         try {
-            mtimes.push(fs.statSync(abs).mtimeMs);
+            const stat = fs.statSync(abs, { throwIfNoEntry: false });
+            if (!stat)
+                continue;
+            mtimes.push(stat.mtimeMs);
             validFiles.push(file);
         }
         catch {

package/dist/util/glob-cache.js

@@ -33,8 +33,8 @@ const statDirMtime = (dir) => {
     let mtime = dirMtimeCache.get(dir);
     if (mtime === undefined) {
         try {
-            const stat = fs.statSync(dir);
-            mtime = stat.isDirectory() ? stat.mtimeMs : Number.NaN;
+            const stat = fs.statSync(dir, { throwIfNoEntry: false });
+            mtime = stat?.isDirectory() ? stat.mtimeMs : Number.NaN;
         }
         catch {
             mtime = Number.NaN;

package/dist/util/glob-core.js

@@ -293,7 +293,9 @@ export async function getGitIgnoredHandler(options, workspaceDirs) {
         return () => false;
     const { ignores, unignores } = await _parseFindGitignores(options.cwd, workspaceDirs);
     gitignoreFingerprint = hashIgnores(ignores, unignores);
-    const matcher = picomatch(expandIgnorePatterns(ignores), { ignore: expandIgnorePatterns(unignores) });
+    const ignoreMatcher = picomatch(expandIgnorePatterns(ignores));
+    const unignoreMatcher = unignores.size > 0 ? picomatch(expandIgnorePatterns(unignores)) : undefined;
+    const matcher = unignoreMatcher ? (path) => ignoreMatcher(path) && !unignoreMatcher(path) : ignoreMatcher;
     const cache = new Map();
     const isGitIgnored = (filePath) => {
         let result = cache.get(filePath);

package/dist/util/input.d.ts

@@ -1,6 +1,6 @@
 import type { IssueType } from '../types/issues.ts';
 import type { PluginName } from '../types/PluginNames.ts';
-type InputType = 'binary' | 'entry' | 'project' | 'config' | 'dependency' | 'deferResolve' | 'deferResolveEntry' | 'alias' | 'ignore';
+type InputType = 'binary' | 'catalog' | 'entry' | 'project' | 'config' | 'dependency' | 'deferResolve' | 'deferResolveEntry' | 'alias' | 'ignore';
 export interface Input {
     type: InputType;
     specifier: string;
@@ -18,6 +18,10 @@ export interface ConfigInput extends Input {
     containingFilePath?: string;
     pluginName: PluginName;
 }
+export interface CatalogInput extends Input {
+    type: 'catalog';
+    catalogName: string;
+}
 interface AliasInput extends Input {
     type: 'alias';
     prefixes: string[];
@@ -36,6 +40,8 @@ type Options = {
 export declare const fromBinary: (input: Input) => string;
 export declare const toBinary: (specifier: string, options?: Options) => Input;
 export declare const isBinary: (input: Input) => boolean;
+export declare const toCatalog: (specifier: string, catalogName: string) => CatalogInput;
+export declare const isCatalog: (input: Input) => input is CatalogInput;
 export declare const toEntry: (specifier: string) => Input;
 export declare const isEntry: (input: Input) => boolean;
 export declare const toProject: (specifier: string) => Input;

package/dist/util/input.js

@@ -6,6 +6,12 @@ export const toBinary = (specifier, options = {}) => ({
     ...options,
 });
 export const isBinary = (input) => input.type === 'binary';
+export const toCatalog = (specifier, catalogName) => ({
+    type: 'catalog',
+    specifier,
+    catalogName,
+});
+export const isCatalog = (input) => input.type === 'catalog';
 export const toEntry = (specifier) => ({ type: 'entry', specifier });
 export const isEntry = (input) => input.type === 'entry' && !input.production;
 export const toProject = (specifier) => ({ type: 'project', specifier });