knip 6.43.0 → 6.44.0

package/dist/types/config.d.ts

@@ -17,6 +17,7 @@ export interface GetInputsFromScriptsOptions extends BaseOptions {
     optionalBinaries?: boolean;
     containingFilePath: string;
     expandedScripts?: Set<string>;
+    manifestDir?: string;
 }
 export type GetInputsFromScripts<T = GetInputsFromScriptsOptions> = (npmScripts: string | string[] | Set<string>, options: T) => Input[];
 export type GetInputsFromScriptsPartial = (npmScripts: string | string[] | Set<string>, options?: Partial<GetInputsFromScriptsOptions>) => Input[];

package/dist/types/issues.d.ts

@@ -71,6 +71,10 @@ export type ReporterOptions = {
     selectedWorkspaces: string[] | undefined;
     configFilePath: string | undefined;
     maxShowIssues?: number;
+    write?: (output: string) => void;
+};
+export type InternalReporterOptions = ReporterOptions & {
+    write: (output: string) => void;
 };
 export type Reporter = (options: ReporterOptions) => void;
 export type Preprocessor = (options: ReporterOptions) => ReporterOptions;

package/dist/types/package-json.d.ts

@@ -28,9 +28,6 @@ type Dependencies = Record<string, string>;
 type TypesVersions = Record<string, Record<string, string[]>>;
 export type PackageExtensions = Record<string, {
     peerDependencies?: Dependencies;
-    peerDependenciesMeta?: Record<string, {
-        optional?: boolean;
-    }>;
 }>;
 export type PackageJson = {
     name?: string;

package/dist/typescript/get-imports-and-exports.js

@@ -26,6 +26,7 @@ const getImportsAndExports = (filePath, sourceText, resolveModule, options, igno
     const scripts = new Set();
     const importGlobs = [];
     const handledImportExpressions = new Set();
+    const caughtImportExpressions = new Set();
     const importAliases = new Map();
     const addImportAlias = (aliasName, id, importFilePath) => {
         const aliases = importAliases.get(aliasName);
@@ -342,6 +343,7 @@ const getImportsAndExports = (filePath, sourceText, resolveModule, options, igno
         programFiles,
         entryFiles,
         handledImportExpressions,
+        caughtImportExpressions,
         visitor,
         getJSDocTags,
     });

package/dist/typescript/visitors/calls.js

@@ -1,5 +1,6 @@
 import { IMPORT_FLAGS, OPAQUE } from '../../constants.js';
 import { addValue } from '../../util/module-graph.js';
+import { isStartsLikePackageName } from '../../util/modules.js';
 import { getSafeScriptFromArgs, getScriptFromArg, getStringValue, isStringLiteral } from '../ast-nodes.js';
 import { isShadowed } from './walk.js';
 function getRegisteredCustomElement(node, s) {
@@ -136,23 +137,26 @@ export function handleCallExpression(node, s) {
         s.addImport(specifier, undefined, undefined, undefined, node.arguments[0].start, IMPORT_FLAGS.ENTRY);
         return;
     }
-    if (s.hasNodeModuleImport &&
-        ((node.callee.type === 'MemberExpression' &&
-            node.callee.object.type === 'Identifier' &&
-            node.callee.object.name === 'module' &&
-            !node.callee.computed &&
-            node.callee.property.name === 'register') ||
-            (node.callee.type === 'Identifier' && node.callee.name === 'register')) &&
-        node.arguments.length >= 1 &&
-        isStringLiteral(node.arguments[0])) {
+    if (s.hasNodeModuleImport && node.arguments.length >= 1 && isStringLiteral(node.arguments[0])) {
+        const { callee } = node;
+        const nodeModuleMethod = callee.type === 'Identifier'
+            ? callee.name
+            : callee.type === 'MemberExpression' &&
+                !callee.computed &&
+                callee.object.type === 'Identifier' &&
+                callee.object.name === 'module' &&
+                callee.property.type === 'Identifier' &&
+                callee.property.name;
         const specifier = getStringValue(node.arguments[0]);
         const arg1 = node.arguments[1];
-        if (specifier &&
+        if ((nodeModuleMethod === 'register' &&
+            specifier &&
             (!specifier.startsWith('.') ||
                 (arg1?.type === 'MemberExpression' &&
                     !arg1.computed &&
                     arg1.object.type === 'MetaProperty' &&
-                    arg1.property.name === 'url'))) {
+                    arg1.property.name === 'url'))) ||
+            (nodeModuleMethod === 'findPackageJSON' && isStartsLikePackageName(specifier) && !URL.canParse(specifier))) {
             s.addImport(specifier, undefined, undefined, undefined, node.arguments[0].start, IMPORT_FLAGS.ENTRY);
             return;
         }

package/dist/typescript/visitors/imports.d.ts

@@ -1,4 +1,5 @@
-import type { ImportExpression, VariableDeclarator } from 'oxc-parser';
+import type { ArrayExpression, Expression, ImportExpression, VariableDeclarator } from 'oxc-parser';
 import type { WalkState } from './walk.ts';
+export declare function getPromiseAllElements(expression: Expression): ArrayExpression['elements'] | undefined;
 export declare function handleVariableDeclarator(node: VariableDeclarator, s: WalkState): void;
 export declare function handleImportExpression(node: ImportExpression, s: WalkState): void;

package/dist/typescript/visitors/imports.js

@@ -2,6 +2,17 @@ import { IMPORT_FLAGS, IMPORT_STAR, OPAQUE } from '../../constants.js';
 import { addValue } from '../../util/module-graph.js';
 import { isInNodeModules } from '../../util/path.js';
 import { getStringValue, isStringLiteral } from '../ast-nodes.js';
+export function getPromiseAllElements(expression) {
+    if (expression.type === 'CallExpression' &&
+        expression.callee.type === 'MemberExpression' &&
+        !expression.callee.computed &&
+        expression.callee.object.type === 'Identifier' &&
+        expression.callee.object.name === 'Promise' &&
+        expression.callee.property.name === 'all' &&
+        expression.arguments[0]?.type === 'ArrayExpression') {
+        return expression.arguments[0].elements;
+    }
+}
 export function handleVariableDeclarator(node, s) {
     const init = node.init;
     if (!init)
@@ -16,6 +27,7 @@ export function handleVariableDeclarator(node, s) {
     if (importExpr && isStringLiteral(importExpr.source)) {
         s.handledImportExpressions.add(importExpr.start);
         const specifier = getStringValue(importExpr.source);
+        const caughtFlag = init.type === 'AwaitExpression' && s.caughtTryBlockEnds.length > 0 ? IMPORT_FLAGS.CAUGHT : IMPORT_FLAGS.NONE;
         if (node.id.type === 'ObjectPattern') {
             for (const prop of node.id.properties) {
                 if (prop.type === 'Property') {
@@ -26,16 +38,16 @@ export function handleVariableDeclarator(node, s) {
                             : undefined;
                     const localName = prop.value?.type === 'Identifier' ? prop.value.name : importedName;
                     const alias = localName !== importedName ? localName : undefined;
-                    s.addImport(specifier, importedName, alias, undefined, prop.key?.start ?? prop.start, IMPORT_FLAGS.DYNAMIC);
+                    s.addImport(specifier, importedName, alias, undefined, prop.key?.start ?? prop.start, IMPORT_FLAGS.DYNAMIC | caughtFlag);
                 }
                 else if (prop.type === 'RestElement' && prop.argument?.type === 'Identifier') {
-                    s.addImport(specifier, IMPORT_STAR, prop.argument.name, undefined, prop.start, IMPORT_FLAGS.DYNAMIC);
+                    s.addImport(specifier, IMPORT_STAR, prop.argument.name, undefined, prop.start, IMPORT_FLAGS.DYNAMIC | caughtFlag);
                 }
             }
         }
         else if (node.id.type === 'Identifier') {
             if (init.type === 'AwaitExpression') {
-                s.addImport(specifier, 'default', node.id.name, undefined, importExpr.source.start, IMPORT_FLAGS.DYNAMIC);
+                s.addImport(specifier, 'default', node.id.name, undefined, importExpr.source.start, IMPORT_FLAGS.DYNAMIC | caughtFlag);
                 const resolved = s.resolveModule(specifier, s.filePath);
                 if (resolved && !resolved.isExternalLibraryImport && !isInNodeModules(resolved.resolvedFileName)) {
                     s.localImportMap.set(node.id.name, {
@@ -47,11 +59,11 @@ export function handleVariableDeclarator(node, s) {
                 }
             }
             else {
-                s.addImport(specifier, undefined, undefined, undefined, importExpr.source.start, IMPORT_FLAGS.DYNAMIC | IMPORT_FLAGS.OPAQUE);
+                s.addImport(specifier, undefined, undefined, undefined, importExpr.source.start, IMPORT_FLAGS.DYNAMIC | IMPORT_FLAGS.OPAQUE | caughtFlag);
             }
         }
         else {
-            s.addImport(specifier, undefined, undefined, undefined, importExpr.source.start, IMPORT_FLAGS.DYNAMIC | IMPORT_FLAGS.OPAQUE);
+            s.addImport(specifier, undefined, undefined, undefined, importExpr.source.start, IMPORT_FLAGS.DYNAMIC | IMPORT_FLAGS.OPAQUE | caughtFlag);
         }
         return;
     }
@@ -87,16 +99,8 @@ export function handleVariableDeclarator(node, s) {
         }
         return;
     }
-    if (init.type === 'AwaitExpression' &&
-        init.argument.type === 'CallExpression' &&
-        init.argument.callee.type === 'MemberExpression' &&
-        !init.argument.callee.computed &&
-        init.argument.callee.object.type === 'Identifier' &&
-        init.argument.callee.object.name === 'Promise' &&
-        init.argument.callee.property.name === 'all' &&
-        init.argument.arguments[0]?.type === 'ArrayExpression' &&
-        node.id.type === 'ArrayPattern') {
-        const imports = init.argument.arguments[0].elements;
+    const imports = init.type === 'AwaitExpression' ? getPromiseAllElements(init.argument) : undefined;
+    if (imports && node.id.type === 'ArrayPattern') {
         const bindings = node.id.elements;
         for (let i = 0; i < imports.length; i++) {
             const imp = imports[i];
@@ -106,6 +110,7 @@ export function handleVariableDeclarator(node, s) {
             if (imp?.type === 'ImportExpression' && isStringLiteral(imp.source)) {
                 s.handledImportExpressions.add(imp.start);
                 const specifier = getStringValue(imp.source);
+                const caughtFlag = s.caughtTryBlockEnds.length > 0 ? IMPORT_FLAGS.CAUGHT : IMPORT_FLAGS.NONE;
                 if (binding?.type === 'ObjectPattern') {
                     for (const prop of binding.properties) {
                         if (prop.type === 'Property') {
@@ -114,12 +119,12 @@ export function handleVariableDeclarator(node, s) {
                                 : prop.key?.type === 'Literal' && typeof prop.key.value === 'string'
                                     ? prop.key.value
                                     : undefined;
-                            s.addImport(specifier, importedName, undefined, undefined, prop.key?.start ?? prop.start, IMPORT_FLAGS.NONE);
+                            s.addImport(specifier, importedName, undefined, undefined, prop.key?.start ?? prop.start, caughtFlag);
                         }
                     }
                 }
                 else if (binding?.type === 'Identifier') {
-                    s.addImport(specifier, 'default', binding.name, undefined, imp.source.start, IMPORT_FLAGS.DYNAMIC);
+                    s.addImport(specifier, 'default', binding.name, undefined, imp.source.start, IMPORT_FLAGS.DYNAMIC | caughtFlag);
                     const resolved = s.resolveModule(specifier, s.filePath);
                     if (resolved && !resolved.isExternalLibraryImport && !isInNodeModules(resolved.resolvedFileName)) {
                         s.localImportMap.set(binding.name, {
@@ -131,7 +136,7 @@ export function handleVariableDeclarator(node, s) {
                     }
                 }
                 else {
-                    s.addImport(specifier, undefined, undefined, undefined, imp.source.start, IMPORT_FLAGS.DYNAMIC | IMPORT_FLAGS.SIDE_EFFECTS);
+                    s.addImport(specifier, undefined, undefined, undefined, imp.source.start, IMPORT_FLAGS.DYNAMIC | IMPORT_FLAGS.SIDE_EFFECTS | caughtFlag);
                 }
             }
         }
@@ -268,6 +273,7 @@ export function handleImportExpression(node, s) {
         return;
     const specifier = getStringValue(node.source);
     if (specifier) {
-        s.addImport(specifier, undefined, undefined, undefined, node.source.start, IMPORT_FLAGS.DYNAMIC | IMPORT_FLAGS.OPAQUE);
+        const caughtFlag = s.caughtImportExpressions.has(node.start) ? IMPORT_FLAGS.CAUGHT : IMPORT_FLAGS.NONE;
+        s.addImport(specifier, undefined, undefined, undefined, node.source.start, IMPORT_FLAGS.DYNAMIC | IMPORT_FLAGS.OPAQUE | caughtFlag);
     }
 }

package/dist/typescript/visitors/members.js

@@ -2,6 +2,7 @@ import { OPAQUE } from '../../constants.js';
 import { addValue } from '../../util/module-graph.js';
 import { getStringValue, isStringLiteral } from '../ast-nodes.js';
 import { isShadowed } from './walk.js';
+const chainNames = [];
 function markWholeObjectRead(internalImport, id) {
     (internalImport.enumerated ??= new Set()).add(id);
 }
@@ -9,7 +10,10 @@ function isNumericKey(value) {
     return value != null && Number.isFinite(Number(value)) && String(Number(value)) === value;
 }
 export function handleMemberExpression(node, s) {
-    if (node.object.type === 'MemberExpression' && node.object.object.type === 'MemberExpression') {
+    if (node.object.type === 'MemberExpression' &&
+        node.object.object.type === 'MemberExpression' &&
+        !node.computed &&
+        node.property.type === 'Identifier') {
         s.chainedMemberExprs.add(node.object);
     }
     if (node.object.type === 'Identifier') {
@@ -143,34 +147,27 @@ export function handleMemberExpression(node, s) {
         }
     }
     if (node.object.type === 'MemberExpression' &&
-        !node.object.computed &&
         node.object.object.type === 'MemberExpression' &&
-        !node.object.object.computed &&
-        node.object.object.object.type === 'Identifier' &&
-        node.object.object.property.type === 'Identifier' &&
-        node.object.property.type === 'Identifier' &&
-        !node.computed &&
-        node.property.type === 'Identifier') {
-        const rootName = node.object.object.object.name;
-        if (!isShadowed(rootName, node.object.object.object.start)) {
-            const _import = s.localImportMap.get(rootName);
-            if (_import) {
-                const internalImport = s.internal.get(_import.filePath);
-                if (internalImport) {
-                    const a = node.object.object.property.name;
-                    const b = node.object.property.name;
-                    const c = node.property.name;
-                    s.addNsMemberRefs(internalImport, rootName, a);
-                    s.addNsMemberRefs(internalImport, rootName, `${a}.${b}`);
-                    s.addNsMemberRefs(internalImport, rootName, `${a}.${b}.${c}`);
+        !s.chainedMemberExprs.has(node)) {
+        chainNames.length = 0;
+        let root = node;
+        while (root.type === 'MemberExpression' && !root.computed && root.property.type === 'Identifier') {
+            chainNames.push(root.property.name);
+            root = root.object;
+        }
+        if (root.type === 'Identifier' && !isShadowed(root.name, root.start)) {
+            const _import = s.localImportMap.get(root.name);
+            const internalImport = _import && s.internal.get(_import.filePath);
+            if (internalImport || !_import) {
+                let path = '';
+                for (let i = chainNames.length - 1; i >= 0; i--) {
+                    path = path ? `${path}.${chainNames[i]}` : chainNames[i];
+                    if (internalImport)
+                        s.addNsMemberRefs(internalImport, root.name, path);
+                    else
+                        s.memberRefsInFile.push(root.name, path);
                 }
             }
-            else {
-                const a = node.object.object.property.name;
-                const b = node.object.property.name;
-                const c = node.property.name;
-                s.memberRefsInFile.push(rootName, a, rootName, `${a}.${b}`, rootName, `${a}.${b}.${c}`);
-            }
         }
     }
     if (node.object.type === 'MemberExpression' &&

package/dist/typescript/visitors/walk.d.ts

@@ -44,6 +44,7 @@ interface WalkContext {
     programFiles: Set<string>;
     entryFiles: Set<string>;
     handledImportExpressions: Set<number>;
+    caughtImportExpressions: Set<number>;
     visitor: Visitor;
     getJSDocTags: (nodeStart: number) => Set<string>;
 }
@@ -53,6 +54,8 @@ export interface WalkState extends WalkContext {
     isJS: boolean;
     isModuleFile: boolean;
     handledImportExpressions: Set<number>;
+    caughtTryBlockEnds: number[];
+    functionCaughtTryBlockEnds: number[][];
     bareExprRefs: Set<string>;
     accessedAliases: Set<string>;
     nsContainers: Map<string, Map<string, string>>;

package/dist/typescript/visitors/walk.js

@@ -7,7 +7,7 @@ import { collectAugmentationRefs, getLineAndCol, getStringValue, isStringLiteral
 import { EMPTY_TAGS } from './jsdoc.js';
 import { handleCallExpression, handleNewExpression, trackCustomElementRegistry } from './calls.js';
 import { handleExportAssignment, handleExportDefault, handleExportNamed, handleExpressionStatement, } from './exports.js';
-import { handleImportExpression, handleVariableDeclarator } from './imports.js';
+import { getPromiseAllElements, handleImportExpression, handleVariableDeclarator } from './imports.js';
 import { handleJSXMemberExpression, handleMemberExpression } from './members.js';
 let state;
 const _getFix = (start, end, flags) => state.options.isFixExports ? [start, end, flags ?? FIX_FLAGS.NONE] : undefined;
@@ -267,8 +267,10 @@ const coreVisitorObject = {
         state.scopeEnds[state.scopeDepth] = node.end;
         state.scopeDepth++;
     },
-    'BlockStatement:exit'() {
+    'BlockStatement:exit'(node) {
         state.scopeDepth--;
+        if (state.caughtTryBlockEnds[state.caughtTryBlockEnds.length - 1] === node.end)
+            state.caughtTryBlockEnds.pop();
     },
     TSModuleDeclaration(node) {
         state.nsRanges.push([node.start, node.end]);
@@ -319,6 +321,8 @@ const coreVisitorObject = {
         state.staticBlockDepth--;
     },
     FunctionDeclaration(node) {
+        state.functionCaughtTryBlockEnds.push(state.caughtTryBlockEnds);
+        state.caughtTryBlockEnds = [];
         if (node.id?.name) {
             state.localDeclarationTypes.set(node.id.name, SYMBOL_TYPE.FUNCTION);
             state.localDeclarations.set(node.id.name, node);
@@ -327,12 +331,25 @@ const coreVisitorObject = {
         }
         _addParamShadows(node.params, node.body);
     },
+    'FunctionDeclaration:exit'() {
+        state.caughtTryBlockEnds = state.functionCaughtTryBlockEnds.pop();
+    },
     FunctionExpression(node) {
+        state.functionCaughtTryBlockEnds.push(state.caughtTryBlockEnds);
+        state.caughtTryBlockEnds = [];
         _addParamShadows(node.params, node.body);
     },
+    'FunctionExpression:exit'() {
+        state.caughtTryBlockEnds = state.functionCaughtTryBlockEnds.pop();
+    },
     ArrowFunctionExpression(node) {
+        state.functionCaughtTryBlockEnds.push(state.caughtTryBlockEnds);
+        state.caughtTryBlockEnds = [];
         _addParamShadows(node.params, node.body);
     },
+    'ArrowFunctionExpression:exit'() {
+        state.caughtTryBlockEnds = state.functionCaughtTryBlockEnds.pop();
+    },
     CatchClause(node) {
         if (node.param?.type === 'Identifier' && node.body) {
             _addShadowRange(node.param.name, [node.body.start, node.body.end]);
@@ -380,6 +397,27 @@ const coreVisitorObject = {
     ImportExpression(node) {
         handleImportExpression(node, state);
     },
+    TryStatement(node) {
+        if (node.handler)
+            state.caughtTryBlockEnds.push(node.block.end);
+    },
+    AwaitExpression(node) {
+        if (state.caughtTryBlockEnds.length === 0)
+            return;
+        const { argument } = node;
+        if (argument.type === 'ImportExpression') {
+            state.caughtImportExpressions.add(argument.start);
+        }
+        else {
+            const elements = getPromiseAllElements(argument);
+            if (!elements)
+                return;
+            for (const element of elements) {
+                if (element?.type === 'ImportExpression')
+                    state.caughtImportExpressions.add(element.start);
+            }
+        }
+    },
     CallExpression(node) {
         handleCallExpression(node, state);
     },
@@ -833,6 +871,8 @@ function walkAST(program, sourceText, filePath, hasModuleSyntax, ctx) {
         localToExports: new Map(),
         customElementRegistries: new Set(),
         classNameStack: [],
+        caughtTryBlockEnds: [],
+        functionCaughtTryBlockEnds: [],
         staticBlockDepth: 0,
         addExport: _addExport,
         getFix: _getFix,

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,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 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      --output-file            Write reporter output to a file instead of stdout ([reporter=]path), can be repeated\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 --reporter symbols --reporter json --output-file json=knip.json\n$ knip --tags=-lintignore\n\nWebsite: https://knip.dev";
 export type ParsedCLIArgs = ReturnType<typeof parseCLIArgs>;
 export declare const parseNumericOption: (value: string | undefined, option: string) => number | undefined;
 export default function parseCLIArgs(): {
@@ -29,6 +29,7 @@ export default function parseCLIArgs(): {
     'no-gitignore'?: boolean | undefined;
     'no-progress'?: boolean | undefined;
     'no-tag-hints'?: boolean | undefined;
+    'output-file'?: string[] | undefined;
     performance?: boolean | undefined;
     'performance-fn'?: string | undefined;
     production?: boolean | undefined;

package/dist/util/cli-arguments.js

@@ -44,6 +44,7 @@ Output
       --preprocessor-options   Pass extra options to the preprocessor (as JSON string, see --reporter-options example)
       --reporter               Select reporter (default: symbols), can be repeated (3)
       --reporter-options       Pass extra options to the reporter (as JSON string, see example)
+      --output-file            Write reporter output to a file instead of stdout ([reporter=]path), can be repeated
       --no-config-hints        Suppress configuration hints
       --no-tag-hints           Suppress tag hints
       --treat-config-hints-as-errors   Exit with non-zero code (1) if there are any configuration hints
@@ -77,6 +78,7 @@ $ knip --workspace @myorg/* --workspace '!@myorg/legacy'
 $ knip --workspace './apps/*' --workspace '@shared/utils'
 $ knip -c ./config/knip.json --reporter compact
 $ knip --reporter codeowners --reporter-options '{"path":".github/CODEOWNERS"}'
+$ knip --reporter symbols --reporter json --output-file json=knip.json
 $ knip --tags=-lintignore
 
 Website: https://knip.dev`;
@@ -118,6 +120,7 @@ export default function parseCLIArgs() {
             'no-gitignore': { type: 'boolean' },
             'no-progress': { type: 'boolean', short: 'n' },
             'no-tag-hints': { type: 'boolean' },
+            'output-file': { type: 'string', multiple: true },
             performance: { type: 'boolean' },
             'performance-fn': { type: 'string' },
             production: { type: 'boolean', short: 'p' },

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

@@ -60,7 +60,7 @@ export const createInputHandler = (deputy, chief, isGitIgnored, addIssue, extern
                 isDevOnly: isConfig(input),
                 isTypeOnly: input.isTypeOnly,
             });
-            if (input.isTypeOnly && input.containingFilePath) {
+            if (input.alsoReferenceOwner && input.containingFilePath) {
                 const owningWorkspace = chief.findWorkspaceByFilePath(input.containingFilePath);
                 if (owningWorkspace && owningWorkspace !== inputWorkspace) {
                     const isOwnerHandled = deputy.maybeAddReferencedExternalDependency(owningWorkspace, packageName, {

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

@@ -4,8 +4,9 @@ interface CreateOptions extends Partial<Options> {
     args?: ParsedCLIArgs;
 }
 export declare const createOptions: (options: CreateOptions) => Promise<{
+    createdFrom: CreateOptions;
     cacheLocation: string;
-    catalog: import("../CatalogCounselor.ts").CatalogContainer;
+    catalog: import("../CatalogCounselor.ts").CatalogContainer[];
     config: string | undefined;
     configFilePath: string | undefined;
     cwd: string;
@@ -326,6 +327,11 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
             entry?: string | string[] | undefined;
             project?: string | string[] | undefined;
         } | undefined;
+        'kysely-codegen'?: string | boolean | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
         ladle?: string | boolean | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;
@@ -341,6 +347,11 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
             entry?: string | string[] | undefined;
             project?: string | string[] | undefined;
         } | undefined;
+        lingui?: string | boolean | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
         'lint-staged'?: string | boolean | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;
@@ -381,6 +392,11 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
             entry?: string | string[] | undefined;
             project?: string | string[] | undefined;
         } | undefined;
+        mastra?: string | boolean | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
         mcp?: string | boolean | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;
@@ -611,6 +627,11 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
             entry?: string | string[] | undefined;
             project?: string | string[] | undefined;
         } | undefined;
+        purgecss?: string | boolean | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
         quasar?: string | boolean | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;
@@ -1348,6 +1369,11 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
                 entry?: string | string[] | undefined;
                 project?: string | string[] | undefined;
             } | undefined;
+            'kysely-codegen'?: string | boolean | string[] | {
+                config?: string | string[] | undefined;
+                entry?: string | string[] | undefined;
+                project?: string | string[] | undefined;
+            } | undefined;
             ladle?: string | boolean | string[] | {
                 config?: string | string[] | undefined;
                 entry?: string | string[] | undefined;
@@ -1363,6 +1389,11 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
                 entry?: string | string[] | undefined;
                 project?: string | string[] | undefined;
             } | undefined;
+            lingui?: string | boolean | string[] | {
+                config?: string | string[] | undefined;
+                entry?: string | string[] | undefined;
+                project?: string | string[] | undefined;
+            } | undefined;
             'lint-staged'?: string | boolean | string[] | {
                 config?: string | string[] | undefined;
                 entry?: string | string[] | undefined;
@@ -1403,6 +1434,11 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
                 entry?: string | string[] | undefined;
                 project?: string | string[] | undefined;
             } | undefined;
+            mastra?: string | boolean | string[] | {
+                config?: string | string[] | undefined;
+                entry?: string | string[] | undefined;
+                project?: string | string[] | undefined;
+            } | undefined;
             mcp?: string | boolean | string[] | {
                 config?: string | string[] | undefined;
                 entry?: string | string[] | undefined;
@@ -1633,6 +1669,11 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
                 entry?: string | string[] | undefined;
                 project?: string | string[] | undefined;
             } | undefined;
+            purgecss?: string | boolean | string[] | {
+                config?: string | string[] | undefined;
+                entry?: string | string[] | undefined;
+                project?: string | string[] | undefined;
+            } | undefined;
             quasar?: string | boolean | string[] | {
                 config?: string | string[] | undefined;
                 entry?: string | string[] | undefined;

package/dist/util/create-options.js

@@ -60,6 +60,16 @@ export const createOptions = async (options) => {
         configFilePath = manifestPath;
     const pnpmWorkspacePath = findFile(cwd, 'pnpm-workspace.yaml');
     const pnpmWorkspace = pnpmWorkspacePath && (await _load(pnpmWorkspacePath));
+    const catalog = [await getCatalogContainer(cwd, manifest, manifestPath, pnpmWorkspacePath, pnpmWorkspace)];
+    for (const source in pnpmWorkspace?.include) {
+        if (!source.startsWith('.'))
+            continue;
+        const filePath = join(cwd, source);
+        const included = await _load(filePath);
+        if (!included)
+            continue;
+        catalog.push({ filePath, catalog: included.catalog, catalogs: included.catalogs, overrides: included.overrides });
+    }
     const workspaces = pnpmWorkspace?.packages ??
         (manifest.workspaces
             ? Array.isArray(manifest.workspaces)
@@ -102,8 +112,9 @@ export const createOptions = async (options) => {
     const preprocessorOptions = args['preprocessor-options'] ??
         (parsedConfig.preprocessorOptions ? JSON.stringify(parsedConfig.preprocessorOptions) : '');
     return {
+        createdFrom: options,
         cacheLocation: args['cache-location'] ?? join(cwd, 'node_modules', '.cache', 'knip'),
-        catalog: await getCatalogContainer(cwd, manifest, manifestPath, pnpmWorkspacePath, pnpmWorkspace),
+        catalog,
         config: args.config,
         configFilePath,
         cwd,
@@ -145,7 +156,7 @@ export const createOptions = async (options) => {
             includedIssueTypes.enumMembers ||
             includedIssueTypes.namespaceMembers,
         isReportValues: includedIssueTypes.exports || includedIssueTypes.nsExports,
-        isSession: options.isSession ?? false,
+        isSession: options.isSession ?? args.watch ?? options.isWatch ?? false,
         isShowProgress: !isDebug &&
             !isTrace &&
             args['no-progress'] !== true &&

package/dist/util/file-entry-cache.d.ts

@@ -14,8 +14,10 @@ export declare class FileEntryCache<T> {
     filePath: string;
     cache: Map<string, MetaData<T>>;
     normalizedEntries: Map<string, FileDescriptor<T>>;
+    private isDirty;
     constructor(cacheId: string, _path: string);
     getFileDescriptor(filePath: string): FileDescriptor<T>;
+    setFileData(filePath: string, data: T): void;
     removeEntry(entryName: string): void;
     reconcile(): void;
 }