knip 6.42.1 → 6.44.0

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/exports.js

@@ -88,7 +88,7 @@ export function handleExportNamed(node, s) {
                 }
                 else if (declarator.id.type === 'Identifier') {
                     const name = declarator.id.name;
-                    const fix = s.getFix(exportStart, exportStart + 7);
+                    const fix = decl.declarations.length === 1 ? s.getFix(exportStart, exportStart + 7) : undefined;
                     const jsDocTags = s.getJSDocTags(exportStart);
                     let isReExport = false;
                     if (declarator.init?.type === 'Identifier') {
@@ -235,11 +235,12 @@ export function handleExportDefault(node, s) {
     if (s.skipExports || s.isInNamespace(node))
         return;
     const decl = node.declaration;
-    const hasDeclarationBody = decl.type === 'ClassDeclaration' || decl.type === 'FunctionDeclaration';
+    const isNamedDeclaration = (decl.type === 'ClassDeclaration' || decl.type === 'FunctionDeclaration') && decl.id;
+    const start = decl.type === 'ClassDeclaration' ? Math.min(node.start, decl.decorators[0]?.start ?? node.start) : node.start;
     const fix = s.options.isFixExports
-        ? hasDeclarationBody
+        ? isNamedDeclaration
             ? [node.start, decl.start, FIX_FLAGS.NONE]
-            : [node.start, node.end + 1, FIX_FLAGS.NONE]
+            : [start, node.end + 1, FIX_FLAGS.NONE]
         : undefined;
     let type = SYMBOL_TYPE.UNKNOWN;
     let pos = decl.start;

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,16 +267,30 @@ 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]);
-        if (node.kind !== 'global' && state.isModuleFile && isStringLiteral(node.id)) {
+        if (node.kind === 'global' || !isStringLiteral(node.id))
+            return;
+        if (state.isModuleFile) {
             const specifier = getStringValue(node.id);
             for (const name of collectAugmentationRefs(node))
                 state.addImport(specifier, name, undefined, undefined, node.id.start, IMPORT_FLAGS.TYPE_ONLY | IMPORT_FLAGS.AUGMENT);
         }
+        else if (node.body?.type === 'TSModuleBlock') {
+            for (const stmt of node.body.body) {
+                if ((stmt.type === 'ImportDeclaration' ||
+                    stmt.type === 'ExportAllDeclaration' ||
+                    stmt.type === 'ExportNamedDeclaration') &&
+                    stmt.source) {
+                    state.addImport(stmt.source.value, undefined, undefined, undefined, stmt.source.start, IMPORT_FLAGS.TYPE_ONLY | IMPORT_FLAGS.OPAQUE);
+                }
+            }
+        }
     },
     TSInterfaceDeclaration(node) {
         if (state.scopeDepth > 0 || state.isInNamespace(node))
@@ -307,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);
@@ -315,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]);
@@ -368,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);
     },
@@ -821,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;
@@ -91,6 +92,11 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
             entry?: string | string[] | undefined;
             project?: string | string[] | undefined;
         } | undefined;
+        buf?: string | boolean | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
         bumpp?: string | boolean | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;
@@ -191,6 +197,11 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
             entry?: string | string[] | undefined;
             project?: string | string[] | undefined;
         } | undefined;
+        'electron-forge'?: string | boolean | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
         'electron-vite'?: string | boolean | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;
@@ -316,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;
@@ -331,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;
@@ -371,6 +392,16 @@ 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;
+            project?: string | string[] | undefined;
+        } | undefined;
         mdx?: string | boolean | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;
@@ -596,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;
@@ -1098,6 +1134,11 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
                 entry?: string | string[] | undefined;
                 project?: string | string[] | undefined;
             } | undefined;
+            buf?: string | boolean | string[] | {
+                config?: string | string[] | undefined;
+                entry?: string | string[] | undefined;
+                project?: string | string[] | undefined;
+            } | undefined;
             bumpp?: string | boolean | string[] | {
                 config?: string | string[] | undefined;
                 entry?: string | string[] | undefined;
@@ -1198,6 +1239,11 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
                 entry?: string | string[] | undefined;
                 project?: string | string[] | undefined;
             } | undefined;
+            'electron-forge'?: string | boolean | string[] | {
+                config?: string | string[] | undefined;
+                entry?: string | string[] | undefined;
+                project?: string | string[] | undefined;
+            } | undefined;
             'electron-vite'?: string | boolean | string[] | {
                 config?: string | string[] | undefined;
                 entry?: string | string[] | undefined;
@@ -1323,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;
@@ -1338,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;
@@ -1378,6 +1434,16 @@ 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;
+                project?: string | string[] | undefined;
+            } | undefined;
             mdx?: string | boolean | string[] | {
                 config?: string | string[] | undefined;
                 entry?: string | string[] | undefined;
@@ -1603,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;