knip 5.2.2 → 5.3.1

package/dist/ConfigurationChief.js

@@ -21,7 +21,7 @@ import { toRegexOrString } from './util/regex.js';
 import { _require } from './util/require.js';
 import { unwrapFunction } from './util/unwrap-function.js';
 import { byPathDepth } from './util/workspace.js';
-const { config: rawConfigArg, workspace: rawWorkspaceArg, include = [], exclude = [], dependencies = false, exports = false, } = parsedArgValues;
+const { config: rawConfigArg, workspace: rawWorkspaceArg, include = [], exclude = [], dependencies = false, exports = false, files = false, } = parsedArgValues;
 const workspaceArg = rawWorkspaceArg ? toPosix(rawWorkspaceArg).replace(/^\.\//, '').replace(/\/$/, '') : undefined;
 const getDefaultWorkspaceConfig = (extensions) => {
     const exts = [...DEFAULT_EXTENSIONS, ...(extensions ?? [])].map(ext => ext.slice(1)).join(',');
@@ -352,7 +352,7 @@ export class ConfigurationChief {
         return { entry, project, paths, ignore, isIncludeEntryExports, ...plugins };
     }
     getIncludedIssueTypes() {
-        const cliArgs = { include, exclude, dependencies, exports };
+        const cliArgs = { include, exclude, dependencies, exports, files };
         const excludesFromRules = getKeysByValue(this.config.rules, 'off');
         const config = {
             include: this.config.include ?? [],

package/dist/ProjectPrincipal.d.ts

@@ -4,7 +4,7 @@ import { createCustomModuleResolver } from './typescript/resolveModuleNames.js';
 import { SourceFileManager } from './typescript/SourceFileManager.js';
 import type { SyncCompilers, AsyncCompilers } from './compilers/types.js';
 import type { PrincipalOptions } from './PrincipalFactory.js';
-import type { SerializableExportMember } from './types/exports.js';
+import type { SerializableExport, SerializableExportMember } from './types/exports.js';
 import type { UnresolvedImport } from './types/imports.js';
 import type { ProgramMaybe53 } from './typescript/SourceFile.js';
 import type { ReferencedDependencies } from './WorkspaceWorker.js';
@@ -61,4 +61,5 @@ export declare class ProjectPrincipal {
     };
     resolveModule(specifier: string, filePath?: string): ts.ResolvedModuleFull | undefined;
     findUnusedMembers(filePath: string, members: SerializableExportMember[]): SerializableExportMember[];
+    hasReferences(filePath: string, exportedItem: SerializableExport): boolean;
 }

package/dist/ProjectPrincipal.js

@@ -203,4 +203,19 @@ export class ProjectPrincipal {
             return externalRefs.length === 0 && internalRefs.length === 0;
         });
     }
+    hasReferences(filePath, exportedItem) {
+        if (exportedItem.jsDocTags.includes('@public'))
+            return false;
+        if (!this.findReferences) {
+            const languageService = ts.createLanguageService(this.backend.languageServiceHost, ts.createDocumentRegistry());
+            this.findReferences = timerify(languageService.findReferences);
+        }
+        const referencedSymbols = this.findReferences(filePath, exportedItem.pos);
+        const files = (referencedSymbols ?? [])
+            .flatMap(refs => refs.references)
+            .filter(ref => !ref.isDefinition)
+            .map(ref => ref.fileName);
+        const externalRefs = files.filter(f => f !== filePath);
+        return externalRefs.length > 0;
+    }
 }

package/dist/cli.js

@@ -9,7 +9,7 @@ import { runPreprocessors, runReporters } from './util/reporter.js';
 import { splitTags } from './util/tag.js';
 import { version } from './version.js';
 import { main } from './index.js';
-const { debug: isDebug = false, trace: isTrace = false, help: isHelp, 'max-issues': maxIssues = '0', 'no-config-hints': noConfigHints = false, 'no-exit-code': noExitCode = false, 'no-gitignore': isNoGitIgnore = false, 'no-progress': isNoProgress = isDebug || isTrace || false, 'include-entry-exports': isIncludeEntryExports = false, 'isolate-workspaces': isIsolateWorkspaces = false, performance: isObservePerf = false, production: isProduction = false, 'reporter-options': reporterOptions = '', 'preprocessor-options': preprocessorOptions = '', strict: isStrict = false, fix: isFix = false, 'fix-type': fixTypes = [], tsConfig, version: isVersion, 'experimental-tags': experimentalTags = [], tags = [], } = parsedArgValues;
+const { debug: isDebug = false, trace: isTrace = false, help: isHelp, 'max-issues': maxIssues = '0', 'no-config-hints': noConfigHints = false, 'no-exit-code': noExitCode = false, 'no-gitignore': isNoGitIgnore = false, 'no-progress': isNoProgress = isDebug || isTrace || false, 'include-entry-exports': isIncludeEntryExports = false, 'include-libs': isIncludeLibs = false, 'isolate-workspaces': isIsolateWorkspaces = false, performance: isObservePerf = false, production: isProduction = false, 'reporter-options': reporterOptions = '', 'preprocessor-options': preprocessorOptions = '', strict: isStrict = false, fix: isFix = false, 'fix-type': fixTypes = [], tsConfig, version: isVersion, 'experimental-tags': experimentalTags = [], tags = [], } = parsedArgValues;
 if (isHelp) {
     console.log(helpText);
     process.exit(0);
@@ -30,6 +30,7 @@ const run = async () => {
             isStrict,
             isShowProgress,
             isIncludeEntryExports,
+            isIncludeLibs,
             isIsolateWorkspaces,
             tags: tags.length > 0 ? splitTags(tags) : splitTags(experimentalTags),
             isFix: isFix || fixTypes.length > 0,

package/dist/index.js

@@ -1,4 +1,3 @@
-import micromatch from 'micromatch';
 import { _getDependenciesFromScripts } from './binaries/index.js';
 import { getCompilerExtensions, getIncludedCompilers } from './compilers/index.js';
 import { ConfigurationChief } from './ConfigurationChief.js';
@@ -12,16 +11,15 @@ import { ProjectPrincipal } from './ProjectPrincipal.js';
 import { debugLogObject, debugLogArray, debugLog, exportLookupLog } from './util/debug.js';
 import { _glob, negate } from './util/glob.js';
 import { getGitIgnoredFn } from './util/globby.js';
-import { getEntryPathFromManifest, getPackageNameFromFilePath, getPackageNameFromModuleSpecifier, normalizeSpecifierFromFilePath, } from './util/modules.js';
-import { dirname, isInNodeModules, join, isInternal } from './util/path.js';
-import { fromBinary, isBinary } from './util/protocols.js';
-import { _resolveSpecifier } from './util/require.js';
+import { getHandler } from './util/handleReferencedDependency.js';
+import { getEntryPathFromManifest, getPackageNameFromModuleSpecifier } from './util/modules.js';
+import { dirname, join } from './util/path.js';
 import { shouldIgnore } from './util/tag.js';
 import { loadTSConfig } from './util/tsconfig-loader.js';
 import { getType, getHasStrictlyNsReferences } from './util/type.js';
 import { WorkspaceWorker } from './WorkspaceWorker.js';
 export const main = async (unresolvedConfiguration) => {
-    const { cwd, tsConfigFile, gitignore, isStrict, isProduction, isShowProgress, isIncludeEntryExports, isIsolateWorkspaces, tags, isFix, fixTypes, } = unresolvedConfiguration;
+    const { cwd, tsConfigFile, gitignore, isStrict, isProduction, isShowProgress, isIncludeEntryExports, isIncludeLibs, isIsolateWorkspaces, tags, isFix, fixTypes, } = unresolvedConfiguration;
     debugLogObject('*', 'Unresolved configuration (from CLI arguments)', unresolvedConfiguration);
     const chief = new ConfigurationChief({ cwd, isProduction, isStrict, isIncludeEntryExports });
     const deputy = new DependencyDeputy({ isProduction, isStrict });
@@ -40,54 +38,13 @@ export const main = async (unresolvedConfiguration) => {
     const isReportValues = report.exports || report.nsExports || report.classMembers;
     const isReportTypes = report.types || report.nsTypes || report.enumMembers;
     const isReportClassMembers = report.classMembers;
+    const isSkipLibs = !isIncludeLibs && !isReportClassMembers;
     const collector = new IssueCollector({ cwd, rules, filters });
     const enabledPluginsStore = new Map();
     deputy.setIgnored(chief.config.ignoreBinaries, chief.config.ignoreDependencies);
     const o = () => workspaces.map(w => ({ pkgName: w.pkgName, name: w.name, config: w.config, ancestors: w.ancestors }));
     debugLogObject('*', 'Included workspaces', () => workspaces.map(w => w.pkgName));
     debugLogObject('*', 'Included workspace configs', o);
-    const handleReferencedDependency = ({ specifier, containingFilePath, principal, workspace, }) => {
-        if (isInternal(specifier)) {
-            const filePath = principal.resolveModule(specifier, containingFilePath)?.resolvedFileName;
-            if (filePath) {
-                const ignorePatterns = workspace.config?.ignore.map(pattern => join(workspace.dir, pattern)) ?? [];
-                const isIgnored = micromatch.isMatch(filePath, ignorePatterns);
-                if (!isIgnored)
-                    principal.addEntryPath(filePath);
-            }
-            else {
-                collector.addIssue({ type: 'unresolved', filePath: containingFilePath, symbol: specifier });
-            }
-        }
-        else {
-            if (isBinary(specifier)) {
-                const binaryName = fromBinary(specifier);
-                const isHandled = deputy.maybeAddReferencedBinary(workspace, binaryName);
-                if (!isHandled)
-                    collector.addIssue({ type: 'binaries', filePath: containingFilePath, symbol: binaryName });
-            }
-            else {
-                const packageName = isInNodeModules(specifier)
-                    ? getPackageNameFromFilePath(specifier)
-                    : getPackageNameFromModuleSpecifier(specifier);
-                const isHandled = packageName && deputy.maybeAddReferencedExternalDependency(workspace, packageName);
-                if (!isHandled)
-                    collector.addIssue({ type: 'unlisted', filePath: containingFilePath, symbol: specifier });
-                if (packageName && specifier !== packageName) {
-                    const otherWorkspace = chief.availableWorkspaceManifests.find(w => w.manifest.name === packageName);
-                    if (otherWorkspace) {
-                        const filePath = _resolveSpecifier(otherWorkspace.dir, normalizeSpecifierFromFilePath(specifier));
-                        if (filePath) {
-                            principal.addEntryPath(filePath, { skipExportsAnalysis: true });
-                        }
-                        else {
-                            collector.addIssue({ type: 'unresolved', filePath: containingFilePath, symbol: specifier });
-                        }
-                    }
-                }
-            }
-        }
-    };
     for (const workspace of workspaces) {
         const { name, dir, ancestors, pkgName, manifestPath } = workspace;
         streamer.cast(`Analyzing workspace ${name}...`);
@@ -112,7 +69,7 @@ export const main = async (unresolvedConfiguration) => {
             pkgName,
             isGitIgnored,
             isIsolateWorkspaces,
-            isSkipLibs: !isReportClassMembers,
+            isSkipLibs,
         });
         const worker = new WorkspaceWorker({
             name,
@@ -213,10 +170,11 @@ export const main = async (unresolvedConfiguration) => {
     const exportedClasses = new Set();
     for (const principal of principals) {
         principal.init();
+        const handleReferencedDependency = getHandler(collector, deputy, chief);
         principal.referencedDependencies.forEach(([containingFilePath, specifier, workspaceName]) => {
             const workspace = chief.findWorkspaceByName(workspaceName);
             if (workspace)
-                handleReferencedDependency({ specifier, containingFilePath, principal, workspace });
+                handleReferencedDependency(specifier, containingFilePath, workspace, principal);
         });
         const specifierFilePaths = new Set();
         const analyzeSourceFile = (filePath, _principal = principal) => {
@@ -227,6 +185,7 @@ export const main = async (unresolvedConfiguration) => {
                     isFixExports: fixer.isEnabled && fixer.isFixUnusedExports,
                     isFixTypes: fixer.isEnabled && fixer.isFixUnusedTypes,
                     ignoreExportsUsedInFile: Boolean(chief.config.ignoreExportsUsedInFile),
+                    isReportClassMembers,
                     tags,
                 });
                 const { internal, external, unresolved } = imports;
@@ -287,7 +246,7 @@ export const main = async (unresolvedConfiguration) => {
                     manifestScriptNames: new Set(),
                     dependencies: deputy.getDependencies(workspace.name),
                 }).forEach(specifier => {
-                    handleReferencedDependency({ specifier, containingFilePath: filePath, principal: _principal, workspace });
+                    handleReferencedDependency(specifier, filePath, workspace, _principal);
                 });
             }
         };
@@ -467,6 +426,11 @@ export const main = async (unresolvedConfiguration) => {
                     if (hasStrictlyNsReferences && ((!report.nsTypes && isType) || (!report.nsExports && !isType)))
                         continue;
                     if (!isExportedItemReferenced(exportedItem)) {
+                        if (!isSkipLibs) {
+                            const principal = factory.getPrincipalByPackageName(workspace.pkgName);
+                            if (principal?.hasReferences(filePath, exportedItem))
+                                continue;
+                        }
                         const type = getType(hasStrictlyNsReferences, isType);
                         collector.addIssue({
                             type,

package/dist/types/cli.d.ts

@@ -6,6 +6,7 @@ export interface CommandLineOptions {
     isProduction: boolean;
     isShowProgress: boolean;
     isIncludeEntryExports: boolean;
+    isIncludeLibs: boolean;
     isIsolateWorkspaces: boolean;
     tags: Tags;
     isFix: boolean;

package/dist/typescript/getImportsAndExports.d.ts

@@ -9,6 +9,7 @@ export type GetImportsAndExportsOptions = {
     skipExports: boolean;
     isFixExports: boolean;
     isFixTypes: boolean;
+    isReportClassMembers: boolean;
     ignoreExportsUsedInFile: boolean;
     tags: Tags;
 };

package/dist/typescript/visitors/exports/exportKeyword.js

@@ -3,7 +3,7 @@ import { SymbolType } from '../../../types/issues.js';
 import { compact } from '../../../util/array.js';
 import { isGetOrSetAccessorDeclaration, isPrivateMember, stripQuotes } from '../../ast-helpers.js';
 import { exportVisitor as visit } from '../index.js';
-export default visit(() => true, (node, { isFixExports, isFixTypes }) => {
+export default visit(() => true, (node, { isFixExports, isFixTypes, isReportClassMembers }) => {
     const exportKeyword = node.modifiers?.find(mod => mod.kind === ts.SyntaxKind.ExportKeyword);
     if (exportKeyword) {
         if (ts.isVariableStatement(node)) {
@@ -67,18 +67,20 @@ export default visit(() => true, (node, { isFixExports, isFixTypes }) => {
         if (ts.isClassDeclaration(node) && node.name) {
             const identifier = defaultKeyword ? 'default' : node.name.getText();
             const pos = (node.name ?? node).getStart();
-            const members = node.members
-                .filter((member) => (ts.isPropertyDeclaration(member) ||
-                ts.isMethodDeclaration(member) ||
-                isGetOrSetAccessorDeclaration(member)) &&
-                !isPrivateMember(member))
-                .map(member => ({
-                node: member,
-                identifier: member.name.getText(),
-                pos: member.name.getStart(),
-                type: SymbolType.MEMBER,
-                fix: undefined,
-            }));
+            const members = isReportClassMembers
+                ? node.members
+                    .filter((member) => (ts.isPropertyDeclaration(member) ||
+                    ts.isMethodDeclaration(member) ||
+                    isGetOrSetAccessorDeclaration(member)) &&
+                    !isPrivateMember(member))
+                    .map(member => ({
+                    node: member,
+                    identifier: member.name.getText(),
+                    pos: member.name.getStart() + (ts.isComputedPropertyName(member.name) ? 1 : 0),
+                    type: SymbolType.MEMBER,
+                    fix: undefined,
+                }))
+                : [];
             const fix = isFixExports
                 ? [exportKeyword.getStart(), (defaultKeyword ?? exportKeyword).getEnd() + 1]
                 : undefined;

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

@@ -1,4 +1,4 @@
-export declare const helpText = "\u2702\uFE0F  Find unused files, dependencies and exports in your JavaScript and TypeScript projects\n\nUsage: knip [options]\n\nOptions:\n  -c, --config [file]      Configuration file path (default: [.]knip.json[c], knip.js, knip.ts or package.json#knip)\n  -t, --tsConfig [file]    TypeScript configuration path (default: tsconfig.json)\n  --production             Analyze only production source files (e.g. no tests, devDependencies, exported types)\n  --strict                 Consider only direct dependencies of workspace (not devDependencies, not other workspaces)\n  -W, --workspace [dir]    Analyze a single workspace (default: analyze all configured workspaces)\n  --directory [dir]        Run process from a different directory (default: cwd)\n  --no-gitignore           Don't use .gitignore\n  --include                Report only 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\n  --exports                Shortcut for --include exports,nsExports,classMembers,types,nsTypes,enumMembers,duplicates\n  --fix                    Fix issues\n  --fix-type               Fix only issues of type, can be comma-separated or repeated (2)\n  --include-entry-exports  Include entry files when reporting unused exports\n  --isolate-workspaces     Isolate workspaces into separate programs (default: false)\n  -n, --no-progress        Don't show dynamic progress updates (automatically enabled in CI environments)\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: symbols, compact, codeowners, json, can be repeated (default: symbols)\n  --reporter-options       Pass extra options to the reporter (as JSON string, see example)\n  --tags                   Include or exclude tagged exports\n  --no-config-hints        Suppress configuration hints\n  --no-exit-code           Always exit with code zero (0)\n  --max-issues             Maximum number of issues before non-zero exit code (default: 0)\n  -d, --debug              Show debug output\n  --performance            Measure count and running time of expensive functions and display stats table\n  -h, --help               Print this help text\n  -V, --version            Print version\n\n(1) Issue types: files, dependencies, unlisted, unresolved, exports, nsExports, classMembers, types, nsTypes, enumMembers, duplicates\n(2) Fixable issue types: dependencies, exports, types\n\nExamples:\n\n$ knip\n$ knip --production\n$ knip --workspace packages/client --include files,dependencies\n$ knip -c ./config/knip.json --reporter compact\n$ knip --reporter codeowners --reporter-options '{\"path\":\".github/CODEOWNERS\"}'\n$ knip --tags=-knipignore\n\nWebsite: https://knip.dev";
+export declare const helpText = "\u2702\uFE0F  Find unused files, dependencies and exports in your JavaScript and TypeScript projects\n\nUsage: knip [options]\n\nOptions:\n  -c, --config [file]      Configuration file path (default: [.]knip.json[c], knip.js, knip.ts or package.json#knip)\n  -t, --tsConfig [file]    TypeScript configuration path (default: tsconfig.json)\n  --production             Analyze only production source files (e.g. no tests, devDependencies, exported types)\n  --strict                 Consider only direct dependencies of workspace (not devDependencies, not other workspaces)\n  -W, --workspace [dir]    Analyze a single workspace (default: analyze all configured workspaces)\n  --directory [dir]        Run process from a different directory (default: cwd)\n  --no-gitignore           Don't use .gitignore\n  --include                Report only 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\n  --exports                Shortcut for --include exports,nsExports,classMembers,types,nsTypes,enumMembers,duplicates\n  --files                  Shortcut for --include files\n  --fix                    Fix issues\n  --fix-type               Fix only issues of type, can be comma-separated or repeated (2)\n  --include-libs           Include type definitions from dependencies (default: false; implied with classMembers)\n  --include-entry-exports  Include entry files when reporting unused exports\n  --isolate-workspaces     Isolate workspaces into separate programs (default: false)\n  -n, --no-progress        Don't show dynamic progress updates (automatically enabled in CI environments)\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: symbols, compact, codeowners, json, can be repeated (default: symbols)\n  --reporter-options       Pass extra options to the reporter (as JSON string, see example)\n  --tags                   Include or exclude tagged exports\n  --no-config-hints        Suppress configuration hints\n  --no-exit-code           Always exit with code zero (0)\n  --max-issues             Maximum number of issues before non-zero exit code (default: 0)\n  -d, --debug              Show debug output\n  --performance            Measure count and running time of expensive functions and display stats table\n  -h, --help               Print this help text\n  -V, --version            Print version\n\n(1) Issue types: files, dependencies, unlisted, unresolved, exports, nsExports, classMembers, types, nsTypes, enumMembers, duplicates\n(2) Fixable issue types: dependencies, exports, types\n\nExamples:\n\n$ knip\n$ knip --production\n$ knip --workspace packages/client --include files,dependencies\n$ knip -c ./config/knip.json --reporter compact\n$ knip --reporter codeowners --reporter-options '{\"path\":\".github/CODEOWNERS\"}'\n$ knip --tags=-knipignore\n\nWebsite: https://knip.dev";
 declare const _default: {
     config: string | undefined;
     debug: boolean | undefined;
@@ -8,11 +8,13 @@ declare const _default: {
     exports: boolean | undefined;
     tags: string[] | undefined;
     'experimental-tags': string[] | undefined;
+    files: boolean | undefined;
     fix: boolean | undefined;
     'fix-type': string[] | undefined;
     help: boolean | undefined;
     'ignore-internal': boolean | undefined;
     include: string[] | undefined;
+    'include-libs': boolean | undefined;
     'include-entry-exports': boolean | undefined;
     'isolate-workspaces': boolean | undefined;
     'max-issues': string | undefined;

package/dist/util/cli-arguments.js

@@ -15,8 +15,10 @@ Options:
   --exclude                Exclude provided issue type(s) from report, can be comma-separated or repeated (1)
   --dependencies           Shortcut for --include dependencies,unlisted,binaries,unresolved
   --exports                Shortcut for --include exports,nsExports,classMembers,types,nsTypes,enumMembers,duplicates
+  --files                  Shortcut for --include files
   --fix                    Fix issues
   --fix-type               Fix only issues of type, can be comma-separated or repeated (2)
+  --include-libs           Include type definitions from dependencies (default: false; implied with classMembers)
   --include-entry-exports  Include entry files when reporting unused exports
   --isolate-workspaces     Isolate workspaces into separate programs (default: false)
   -n, --no-progress        Don't show dynamic progress updates (automatically enabled in CI environments)
@@ -58,11 +60,13 @@ try {
             exports: { type: 'boolean' },
             tags: { type: 'string', multiple: true },
             'experimental-tags': { type: 'string', multiple: true },
+            files: { type: 'boolean' },
             fix: { type: 'boolean' },
             'fix-type': { type: 'string', multiple: true },
             help: { type: 'boolean', short: 'h' },
             'ignore-internal': { type: 'boolean' },
             include: { type: 'string', multiple: true },
+            'include-libs': { type: 'boolean' },
             'include-entry-exports': { type: 'boolean' },
             'isolate-workspaces': { type: 'boolean' },
             'max-issues': { type: 'string' },

package/dist/util/get-included-issue-types.d.ts

@@ -4,6 +4,7 @@ type CLIArguments = {
     exclude: string[];
     dependencies: boolean;
     exports: boolean;
+    files: boolean;
 };
 type Options = {
     isProduction?: boolean;

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

@@ -16,8 +16,10 @@ export const getIncludedIssueTypes = (cliArgs, { include = [], exclude = [], isP
         incl = [...incl, 'dependencies', 'optionalPeerDependencies', 'unlisted', 'binaries', 'unresolved'];
     }
     if (cliArgs.exports) {
-        const exports = ['exports', 'nsExports', 'classMembers', 'types', 'nsTypes', 'enumMembers', 'duplicates'];
-        incl = [...incl, ...exports];
+        incl = [...incl, 'exports', 'nsExports', 'classMembers', 'types', 'nsTypes', 'enumMembers', 'duplicates'];
+    }
+    if (cliArgs.files) {
+        incl = [...incl, 'files'];
     }
     const _include = [...incl, ...includes];
     const _exclude = [...excl, ...excludes];

package/dist/util/handleReferencedDependency.d.ts

@@ -0,0 +1,5 @@
+import { ProjectPrincipal } from '../ProjectPrincipal.js';
+import type { ConfigurationChief, Workspace } from '../ConfigurationChief.js';
+import type { DependencyDeputy } from '../DependencyDeputy.js';
+import type { IssueCollector } from '../IssueCollector.js';
+export declare const getHandler: (collector: IssueCollector, deputy: DependencyDeputy, chief: ConfigurationChief) => (specifier: string, containingFilePath: string, workspace: Workspace, principal: ProjectPrincipal) => void;

package/dist/util/handleReferencedDependency.js

@@ -0,0 +1,48 @@
+import micromatch from 'micromatch';
+import { ProjectPrincipal } from '../ProjectPrincipal.js';
+import { getPackageNameFromFilePath, getPackageNameFromModuleSpecifier, normalizeSpecifierFromFilePath, } from './modules.js';
+import { isInNodeModules, join, isInternal } from './path.js';
+import { fromBinary, isBinary } from './protocols.js';
+import { _resolveSpecifier } from './require.js';
+export const getHandler = (collector, deputy, chief) => (specifier, containingFilePath, workspace, principal) => {
+    if (isInternal(specifier)) {
+        const filePath = principal.resolveModule(specifier, containingFilePath)?.resolvedFileName;
+        if (filePath) {
+            const ignorePatterns = workspace.config?.ignore.map(pattern => join(workspace.dir, pattern)) ?? [];
+            const isIgnored = micromatch.isMatch(filePath, ignorePatterns);
+            if (!isIgnored)
+                principal.addEntryPath(filePath);
+        }
+        else {
+            collector.addIssue({ type: 'unresolved', filePath: containingFilePath, symbol: specifier });
+        }
+    }
+    else {
+        if (isBinary(specifier)) {
+            const binaryName = fromBinary(specifier);
+            const isHandled = deputy.maybeAddReferencedBinary(workspace, binaryName);
+            if (!isHandled)
+                collector.addIssue({ type: 'binaries', filePath: containingFilePath, symbol: binaryName });
+        }
+        else {
+            const packageName = isInNodeModules(specifier)
+                ? getPackageNameFromFilePath(specifier)
+                : getPackageNameFromModuleSpecifier(specifier);
+            const isHandled = packageName && deputy.maybeAddReferencedExternalDependency(workspace, packageName);
+            if (!isHandled)
+                collector.addIssue({ type: 'unlisted', filePath: containingFilePath, symbol: specifier });
+            if (packageName && specifier !== packageName) {
+                const otherWorkspace = chief.availableWorkspaceManifests.find(w => w.manifest.name === packageName);
+                if (otherWorkspace) {
+                    const filePath = _resolveSpecifier(otherWorkspace.dir, normalizeSpecifierFromFilePath(specifier));
+                    if (filePath) {
+                        principal.addEntryPath(filePath, { skipExportsAnalysis: true });
+                    }
+                    else {
+                        collector.addIssue({ type: 'unresolved', filePath: containingFilePath, symbol: specifier });
+                    }
+                }
+            }
+        }
+    }
+};

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const version = "5.2.2";
+export declare const version = "5.3.1";

package/dist/version.js

@@ -1 +1 @@
-export const version = '5.2.2';
+export const version = '5.3.1';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "knip",
-  "version": "5.2.2",
+  "version": "5.3.1",
   "description": "Find unused files, dependencies and exports in your TypeScript and JavaScript projects",
   "homepage": "https://knip.dev",
   "repository": {