knip 6.43.0 → 6.44.1

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, handleImportThen, 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,7 +397,29 @@ 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) {
+        handleImportThen(node, state);
         handleCallExpression(node, state);
     },
     NewExpression(node) {
@@ -833,6 +872,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

@@ -3,9 +3,10 @@ import { type ParsedCLIArgs } from './cli-arguments.ts';
 interface CreateOptions extends Partial<Options> {
     args?: ParsedCLIArgs;
 }
-export declare const createOptions: (options: CreateOptions) => Promise<{
+export declare const createOptions: (options: CreateOptions, isReload?: boolean) => 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

@@ -8,12 +8,12 @@ import { findFile, loadJSON } from './fs.js';
 import { getIncludedIssueTypes, shorthandCycles, shorthandDeps, shorthandExports, shorthandFiles, } from './get-included-issue-types.js';
 import { defaultRules } from './issue-initializers.js';
 import { loadResolvedConfigFile } from './load-config.js';
-import { _load } from './loader.js';
+import { _load, unload } from './loader.js';
 import { logWarning } from './log.js';
 import { getKeysByValue } from './object.js';
 import { isAbsolute, isInternal, join, resolveCwd, toAbsolute } from './path.js';
 import { splitTags } from './tag.js';
-export const createOptions = async (options) => {
+export const createOptions = async (options, isReload = false) => {
     const { args = {} } = options;
     const cwd = resolveCwd(options.cwd ?? args.directory ?? '.');
     const manifestPath = findFile(cwd, 'package.json');
@@ -32,6 +32,8 @@ export const createOptions = async (options) => {
     if (args.config && !configFilePath && !manifest.knip) {
         throw new ConfigurationError(`Unable to find ${args.config} or package.json#knip`);
     }
+    if (options.isSession && !isReload && configFilePath)
+        unload([configFilePath]);
     const loadedConfig = Object.assign({}, manifest.knip, configFilePath ? await loadResolvedConfigFile(configFilePath, args) : {});
     const validIssueTypes = new Set(ISSUE_TYPES);
     for (const key of ['rules', 'include', 'exclude']) {
@@ -60,6 +62,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 +114,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 +158,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;
 }

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

@@ -18,6 +18,7 @@ export class FileEntryCache {
     filePath;
     cache = new Map();
     normalizedEntries = new Map();
+    isDirty = false;
     constructor(cacheId, _path) {
         this.filePath = path.resolve(_path, cacheId);
         if (isFile(this.filePath))
@@ -58,22 +59,39 @@ export class FileEntryCache {
             meta = { size: cSize, mtime: cTime };
             this.cache.set(filePath, meta);
         }
+        if (changed)
+            this.isDirty = true;
         const fd = { key: filePath, changed, meta };
         this.normalizedEntries.set(filePath, fd);
         return fd;
     }
+    setFileData(filePath, data) {
+        const fd = this.getFileDescriptor(filePath);
+        if (!fd.meta)
+            return;
+        fd.meta.data = data;
+        this.isDirty = true;
+    }
     removeEntry(entryName) {
         if (!isAbsolute(entryName))
             entryName = resolve(entryName);
         this.normalizedEntries.delete(entryName);
-        this.cache.delete(entryName);
+        if (this.cache.delete(entryName))
+            this.isDirty = true;
     }
     reconcile() {
+        for (const filePath of this.cache.keys()) {
+            if (!this.normalizedEntries.has(filePath))
+                this.removeEntry(filePath);
+        }
+        if (!this.isDirty)
+            return;
         try {
             const dir = path.dirname(this.filePath);
             if (!isDirectory(dir))
                 fs.mkdirSync(dir, { recursive: true });
             fs.writeFileSync(this.filePath, serialize(this.cache));
+            this.isDirty = false;
         }
         catch (_err) {
             debugLog('*', `Error writing cache to ${this.filePath}`);

package/dist/util/gitignore-cache.d.ts

@@ -5,6 +5,7 @@ export interface CachedGitignoreResult {
     gitignoreFiles: string[];
     perDirIgnores: Map<string, Gitignores>;
 }
+export declare const clearGitignoreCache: () => void;
 export declare const initGitignoreCache: (cacheLocation: string) => void;
 export declare const isGitignoreCacheEnabled: () => boolean;
 export declare const flushGitignoreCache: () => void;

package/dist/util/gitignore-cache.js

@@ -2,6 +2,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { createDiskCache, mtimeMatches } from './disk-cache.js';
 const store = createDiskCache('gitignore');
+export const clearGitignoreCache = store.clear;
 export const initGitignoreCache = store.init;
 export const isGitignoreCacheEnabled = store.isEnabled;
 export const flushGitignoreCache = store.flush;

package/dist/util/glob-core.js

@@ -1,6 +1,6 @@
 import { createHash } from 'node:crypto';
 import { readdir, readFileSync } from 'node:fs';
-import { escapePath, glob as tinyGlob } from 'tinyglobby';
+import { escapePath, glob as tinyGlob, isDynamicPattern } from 'tinyglobby';
 import picomatch from 'picomatch';
 import { GLOBAL_IGNORE_PATTERNS } from '../constants.js';
 import { compact, partition } from './array.js';
@@ -292,7 +292,9 @@ export async function glob(_patterns, options) {
         }
         cachedGlobIgnores.set(options.dir, compact(_ignore));
     }
-    const ignorePatterns = (cachedIgnores ?? _ignore).concat(negatedPatterns.map(pattern => pattern.slice(1)));
+    const ignores = cachedIgnores ?? _ignore;
+    const isStatic = options.gitignore && !patterns.some(pattern => isDynamicPattern(pattern));
+    const ignorePatterns = (isStatic ? expandIgnorePatterns(ignores) : ignores).concat(negatedPatterns.map(pattern => pattern.slice(1)));
     const { dir, label, ...fgOptions } = {
         ...options,
         ignore: ignorePatterns,

package/dist/util/glob.d.ts

@@ -8,6 +8,7 @@ interface GlobOptions {
 }
 export declare const removeProductionSuffix: (pattern: string) => string;
 export declare const prependDirToPattern: (dir: string, pattern: string) => string;
+export declare const rebasePattern: (pattern: string, base: string, dir: string) => string;
 export declare const negate: (pattern: string) => string;
 export declare const hasProductionSuffix: (pattern: string) => boolean;
 export declare const hasNoProductionSuffix: (pattern: string) => boolean;

package/dist/util/glob.js

@@ -23,6 +23,12 @@ export const prependDirToPattern = (dir, pattern) => {
         return `!${join(dir, pattern.slice(1))}`;
     return join(dir, pattern);
 };
+export const rebasePattern = (pattern, base, dir) => {
+    const isNegated = pattern.startsWith('!');
+    const id = isNegated ? pattern.slice(1) : pattern;
+    const rebased = relative(dir, isAbsolute(id) ? id : join(base, id));
+    return isNegated ? `!${rebased}` : rebased;
+};
 export const negate = (pattern) => pattern.replace(/^!?/, '!');
 export const hasProductionSuffix = (pattern) => pattern.endsWith('!');
 export const hasNoProductionSuffix = (pattern) => !pattern.endsWith('!');

package/dist/util/input.d.ts

@@ -7,6 +7,7 @@ export interface Input {
     production?: boolean;
     optional?: boolean;
     isTypeOnly?: boolean;
+    alsoReferenceOwner?: boolean;
     dir?: string;
     containingFilePath?: string;
     allowIncludeExports?: boolean;
@@ -33,6 +34,7 @@ interface IgnoreInput extends Input {
 type Options = {
     optional?: boolean;
     isTypeOnly?: boolean;
+    alsoReferenceOwner?: boolean;
     dir?: string;
     containingFilePath?: string;
     allowIncludeExports?: boolean;

package/dist/util/loader.d.ts

@@ -1,3 +1,4 @@
 declare const load: (filePath: string) => Promise<any>;
 export declare const _load: typeof load;
+export declare const unload: (filePaths: Iterable<string>) => void;
 export {};

package/dist/util/loader.js

@@ -6,11 +6,25 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
     }
     return path;
 };
+import { createRequire } from 'node:module';
+import { pathToFileURL } from 'node:url';
 import { LoaderError } from './errors.js';
 import { loadFile, loadJSON, loadJSONC, loadTOML, loadYAML, parseJSONC, parseYAML } from './fs.js';
 import { jiti } from './jiti.js';
 import { timerify } from './Performance.js';
-import { extname, isInternal } from './path.js';
+import { extname, isInternal, toNative } from './path.js';
+const versions = new Map();
+const isReloadable = (ext) => ext === '.js' || ext === '.mjs' || ext === '.cjs';
+const reload = async (filePath, version) => {
+    let imported;
+    try {
+        imported = jiti(filePath);
+    }
+    catch {
+        imported = await import(__rewriteRelativeImportExtension(`${pathToFileURL(filePath).href}?v=${version}`));
+    }
+    return imported.default ?? imported;
+};
 const load = async (filePath) => {
     try {
         const ext = extname(filePath);
@@ -42,6 +56,10 @@ const load = async (filePath) => {
         if (ext === '.toml') {
             return await loadTOML(filePath);
         }
+        const version = versions.get(filePath) ?? 0;
+        versions.set(filePath, version);
+        if (version && isReloadable(ext))
+            return await reload(filePath, version);
         return await jiti.import(filePath, { default: true });
     }
     catch (error) {
@@ -49,3 +67,13 @@ const load = async (filePath) => {
     }
 };
 export const _load = timerify(load);
+const { cache } = createRequire(import.meta.url);
+export const unload = (filePaths) => {
+    for (const filePath of filePaths) {
+        delete cache[filePath];
+        delete cache[toNative(filePath)];
+        const version = versions.get(filePath);
+        if (version !== undefined)
+            versions.set(filePath, version + 1);
+    }
+};

package/dist/util/modules.js

@@ -1,5 +1,5 @@
 import { readFileSync } from 'node:fs';
-import { DT_SCOPE, PROTOCOL_VIRTUAL } from '../constants.js';
+import { DT_SCOPE, PROTOCOL_CLOUDFLARE, PROTOCOL_VIRTUAL } from '../constants.js';
 import { isAbsolute, isInNodeModules, join, toPosix } from './path.js';
 export const getPackageNameFromModuleSpecifier = (specifier) => {
     if (!isStartsLikePackageName(specifier) && !isTildePackageName(specifier))
@@ -53,7 +53,9 @@ const isPackageNameStart = (ch) => (ch >= 65 && ch <= 90) || (ch >= 97 && ch <=
 const isPackageScopeStart = (ch) => isPackageNameStart(ch) || ch === 46 || ch === 95 || ch === 126;
 export const isStartsLikePackageName = (specifier) => {
     const ch = specifier.charCodeAt(0);
-    return ch === 64 ? isPackageScopeStart(specifier.charCodeAt(1)) : isPackageNameStart(ch);
+    return ch === 64
+        ? isPackageScopeStart(specifier.charCodeAt(1))
+        : isPackageNameStart(ch) && specifier.charCodeAt(1) !== 58;
 };
 const isTildePackageName = (specifier) => specifier.charCodeAt(0) === 126 && isPackageNameStart(specifier.charCodeAt(1));
 export const stripVersionFromSpecifier = (specifier) => specifier.replace(/(\S+)@.*/, '$1');
@@ -87,6 +89,7 @@ const CHAR_HASH = 35;
 const CHAR_QUESTION = 63;
 export const sanitizeSpecifier = (specifier) => {
     if (specifier.startsWith('node:') ||
+        specifier.startsWith(PROTOCOL_CLOUDFLARE) ||
         isAbsolute(specifier) ||
         specifier.charCodeAt(0) === CHAR_COLON ||
         specifier.startsWith(PROTOCOL_VIRTUAL)) {