knip 6.23.0 → 6.25.0

package/dist/typescript/glob-imports.js

@@ -0,0 +1,49 @@
+import { existsSync } from 'node:fs';
+import { _syncGlob } from '../util/glob.js';
+import { dirname, isAbsolute, join, toRelative } from '../util/path.js';
+function resolveBaseDir(base, dir, resolveGlobPattern) {
+    if (base.startsWith('.'))
+        return join(dir, base);
+    if (isAbsolute(base))
+        return base;
+    for (const resolved of resolveGlobPattern(base, dir)) {
+        if (resolved !== base && existsSync(resolved))
+            return resolved;
+    }
+    return undefined;
+}
+export function resolveImportGlobs(items, containingFile, resolveGlobPattern, workspaceRoot) {
+    const filePaths = [];
+    const dir = dirname(containingFile);
+    for (const { patterns, base, filter } of items) {
+        if (base !== undefined) {
+            const cwd = resolveBaseDir(base, dir, resolveGlobPattern);
+            if (!cwd)
+                continue;
+            for (const filePath of _syncGlob({ patterns, cwd })) {
+                if (!filter || filter.test(`./${toRelative(filePath, cwd)}`))
+                    filePaths.push(filePath);
+            }
+        }
+        else {
+            const resolved = [];
+            for (const pattern of patterns) {
+                const isNegated = pattern[0] === '!';
+                const specifier = isNegated ? pattern.slice(1) : pattern;
+                if (specifier[0] === '/') {
+                    const rooted = join(workspaceRoot, specifier);
+                    resolved.push(isNegated ? `!${rooted}` : rooted);
+                }
+                else {
+                    for (const p of resolveGlobPattern(pattern, dir))
+                        resolved.push(p);
+                }
+            }
+            if (resolved.length === 0)
+                continue;
+            for (const filePath of _syncGlob({ patterns: resolved, cwd: dir }))
+                filePaths.push(filePath);
+        }
+    }
+    return filePaths;
+}

package/dist/typescript/resolve-module-names.d.ts

@@ -9,6 +9,8 @@ type ScopedRootDirs = Array<{
     rootDirs: string[];
 }>;
 export declare function clearModuleResolutionCaches(): void;
+export type ResolveGlobPattern = (pattern: string, dir: string) => string[];
+export declare function createGlobAliasResolver(scopedPaths: ScopedPaths | undefined): ResolveGlobPattern;
 export declare function createCustomModuleResolver(compilerOptions: {
     scopedPaths?: ScopedPaths;
     scopedRootDirs?: ScopedRootDirs;

package/dist/typescript/resolve-module-names.js

@@ -3,7 +3,7 @@ import { isBuiltin } from 'node:module';
 import { DEFAULT_EXTENSIONS, DTS_EXTENSIONS } from '../constants.js';
 import { sanitizeSpecifier } from '../util/modules.js';
 import { timerify } from '../util/Performance.js';
-import { dirname, extname, isAbsolute, isInNodeModules, join } from '../util/path.js';
+import { dirname, extname, isAbsolute, isInNodeModules, join, toPosix } from '../util/path.js';
 import { _createSyncModuleResolver, _resolveModuleSync } from '../util/resolve.js';
 function pickStringTarget(value) {
     if (typeof value === 'string')
@@ -56,6 +56,40 @@ function compileRootDirs(scopedRootDirs) {
     scoped.sort((a, b) => b.scope.length - a.scope.length);
     return scoped;
 }
+export function createGlobAliasResolver(scopedPaths) {
+    const mappings = compilePathMappings(scopedPaths);
+    return (pattern, dir) => {
+        if (!mappings)
+            return [pattern];
+        const isNegated = pattern[0] === '!';
+        const specifier = isNegated ? pattern.slice(1) : pattern;
+        let best;
+        for (const mapping of mappings) {
+            const { prefix, wildcard, scope } = mapping;
+            if (dir !== scope && !dir.startsWith(`${scope}/`))
+                continue;
+            const matches = wildcard
+                ? specifier.startsWith(prefix)
+                : specifier === prefix || specifier.startsWith(`${prefix}/`);
+            if (!matches)
+                continue;
+            if (!best ||
+                scope.length > best.scope.length ||
+                (scope.length === best.scope.length && prefix.length > best.prefix.length))
+                best = mapping;
+        }
+        if (!best)
+            return [pattern];
+        const captured = specifier.slice(best.prefix.length);
+        const resolved = [];
+        for (const value of best.values) {
+            const starIdx = value.indexOf('*');
+            const mapped = toPosix(starIdx >= 0 ? value.slice(0, starIdx) + captured + value.slice(starIdx + 1) : value + captured);
+            resolved.push(isNegated ? `!${mapped}` : mapped);
+        }
+        return resolved;
+    };
+}
 export function createCustomModuleResolver(compilerOptions, customCompilerExtensions, toSourceFilePath, findWorkspaceManifestImports, tsConfigFile) {
     const customCompilerExtensionsSet = new Set(customCompilerExtensions);
     const hasCustomExts = customCompilerExtensionsSet.size > 0;

package/dist/typescript/visitors/calls.js

@@ -1,6 +1,6 @@
 import { IMPORT_FLAGS, OPAQUE } from '../../constants.js';
 import { addValue } from '../../util/module-graph.js';
-import { getSafeScriptFromArgs, getStringValue, isStringLiteral } from '../ast-nodes.js';
+import { getSafeScriptFromArgs, getScriptFromArg, getStringValue, isStringLiteral } from '../ast-nodes.js';
 import { isShadowed } from './walk.js';
 function getRegisteredCustomElement(node, s) {
     const callee = node.callee;
@@ -162,11 +162,9 @@ export function handleCallExpression(node, s) {
         if (method) {
             const arg = node.arguments[0];
             if (CHILD_PROCESS_COMMAND_METHODS.has(method)) {
-                if (isStringLiteral(arg)) {
-                    const command = getStringValue(arg);
-                    if (command)
-                        s.scripts.add(command);
-                }
+                const command = getScriptFromArg(arg);
+                if (command)
+                    s.scripts.add(command);
                 return;
             }
             if (CHILD_PROCESS_FILE_METHODS.has(method)) {

package/dist/typescript/visitors/imports.js

@@ -26,16 +26,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.NONE);
+                    s.addImport(specifier, importedName, alias, undefined, prop.key?.start ?? prop.start, IMPORT_FLAGS.DYNAMIC);
                 }
                 else if (prop.type === 'RestElement' && prop.argument?.type === 'Identifier') {
-                    s.addImport(specifier, IMPORT_STAR, prop.argument.name, undefined, prop.start, IMPORT_FLAGS.NONE);
+                    s.addImport(specifier, IMPORT_STAR, prop.argument.name, undefined, prop.start, IMPORT_FLAGS.DYNAMIC);
                 }
             }
         }
         else if (node.id.type === 'Identifier') {
             if (init.type === 'AwaitExpression') {
-                s.addImport(specifier, 'default', node.id.name, undefined, importExpr.source.start, IMPORT_FLAGS.NONE);
+                s.addImport(specifier, 'default', node.id.name, undefined, importExpr.source.start, IMPORT_FLAGS.DYNAMIC);
                 const resolved = s.resolveModule(specifier, s.filePath);
                 if (resolved && !resolved.isExternalLibraryImport && !isInNodeModules(resolved.resolvedFileName)) {
                     s.localImportMap.set(node.id.name, {
@@ -47,11 +47,11 @@ export function handleVariableDeclarator(node, s) {
                 }
             }
             else {
-                s.addImport(specifier, undefined, undefined, undefined, importExpr.source.start, IMPORT_FLAGS.OPAQUE);
+                s.addImport(specifier, undefined, undefined, undefined, importExpr.source.start, IMPORT_FLAGS.DYNAMIC | IMPORT_FLAGS.OPAQUE);
             }
         }
         else {
-            s.addImport(specifier, undefined, undefined, undefined, importExpr.source.start, IMPORT_FLAGS.OPAQUE);
+            s.addImport(specifier, undefined, undefined, undefined, importExpr.source.start, IMPORT_FLAGS.DYNAMIC | IMPORT_FLAGS.OPAQUE);
         }
         return;
     }
@@ -117,10 +117,10 @@ export function handleVariableDeclarator(node, s) {
                     }
                 }
                 else if (binding?.type === 'Identifier') {
-                    s.addImport(specifier, 'default', binding.name, undefined, imp.source.start, IMPORT_FLAGS.NONE);
+                    s.addImport(specifier, 'default', binding.name, undefined, imp.source.start, IMPORT_FLAGS.DYNAMIC);
                 }
                 else {
-                    s.addImport(specifier, undefined, undefined, undefined, imp.source.start, IMPORT_FLAGS.SIDE_EFFECTS);
+                    s.addImport(specifier, undefined, undefined, undefined, imp.source.start, IMPORT_FLAGS.DYNAMIC | IMPORT_FLAGS.SIDE_EFFECTS);
                 }
             }
         }
@@ -257,6 +257,6 @@ export function handleImportExpression(node, s) {
         return;
     const specifier = getStringValue(node.source);
     if (specifier) {
-        s.addImport(specifier, undefined, undefined, undefined, node.source.start, IMPORT_FLAGS.OPAQUE);
+        s.addImport(specifier, undefined, undefined, undefined, node.source.start, IMPORT_FLAGS.DYNAMIC | IMPORT_FLAGS.OPAQUE);
     }
 }

package/dist/typescript/visitors/script-visitors.js

@@ -1,12 +1,12 @@
+import { getScriptFromTemplate } from '../ast-nodes.js';
 export function createBunShellVisitor(ctx) {
     return {
         TaggedTemplateExpression(node) {
             const tag = node.tag;
             if (tag.type === 'Identifier' && tag.name === '$') {
-                for (const q of node.quasi.quasis) {
-                    if (q.value.raw)
-                        ctx.addScript(q.value.raw);
-                }
+                const script = getScriptFromTemplate(node.quasi);
+                if (script)
+                    ctx.addScript(script);
             }
         },
     };

package/dist/typescript/visitors/walk.js

@@ -3,7 +3,7 @@ import { FIX_FLAGS, IMPORT_FLAGS, OPAQUE, SYMBOL_TYPE } from '../../constants.js
 import { addValue } from '../../util/module-graph.js';
 import { isInNodeModules } from '../../util/path.js';
 import { timerify } from '../../util/Performance.js';
-import { getLineAndCol, getStringValue, isStringLiteral } from '../ast-nodes.js';
+import { collectAugmentationRefs, getLineAndCol, getStringValue, isStringLiteral, } from '../ast-nodes.js';
 import { EMPTY_TAGS } from './jsdoc.js';
 import { handleCallExpression, handleNewExpression, trackCustomElementRegistry } from './calls.js';
 import { handleExportAssignment, handleExportDefault, handleExportNamed, handleExpressionStatement, } from './exports.js';
@@ -211,6 +211,11 @@ const coreVisitorObject = {
     },
     TSModuleDeclaration(node) {
         state.nsRanges.push([node.start, node.end]);
+        if (node.kind !== 'global' && isStringLiteral(node.id)) {
+            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);
+        }
     },
     ClassDeclaration(node) {
         state.classNameStack.push(node.id?.name ?? '');

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

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

package/dist/util/cli-arguments.js

@@ -29,6 +29,7 @@ Scope
       --dependencies           Shortcut for --include dependencies,unlisted,binaries,unresolved,catalog
       --exports                Shortcut for --include exports,nsExports,types,nsTypes,enumMembers,namespaceMembers,duplicates
       --files                  Shortcut for --include files
+      --cycles                 Shortcut for --include cycles (circular dependencies)
       --tags                   Include or exclude tagged exports
 
 Fix
@@ -62,9 +63,9 @@ Troubleshooting
       --trace-export [name]    Show trace output for named export(s)
       --trace-file [file]      Show trace output for exports in file
 
-(1) Issue types: files, dependencies, unlisted, unresolved, exports, nsExports, types, nsTypes, enumMembers, namespaceMembers, duplicates, catalog
+(1) Issue types: files, dependencies, unlisted, unresolved, exports, nsExports, types, nsTypes, enumMembers, namespaceMembers, duplicates, catalog, cycles
 (2) Fixable issue types: dependencies, exports, types, files, catalog
-(3) Built-in reporters: symbols (default), compact, codeowners, json, codeclimate, markdown, disclosure, github-actions
+(3) Built-in reporters: symbols (default), compact, codeowners, cycles, json, codeclimate, markdown, disclosure, github-actions
 
 Examples:
 
@@ -84,6 +85,7 @@ export default function parseCLIArgs() {
             cache: { type: 'boolean' },
             'cache-location': { type: 'string' },
             config: { type: 'string', short: 'c' },
+            cycles: { type: 'boolean' },
             debug: { type: 'boolean', short: 'd' },
             dependencies: { type: 'boolean' },
             directory: { type: 'string', short: 'D' },

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

@@ -9,6 +9,7 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
     config: string | undefined;
     configFilePath: string | undefined;
     cwd: string;
+    cycles: boolean;
     dependencies: boolean;
     exports: boolean;
     files: boolean;
@@ -30,6 +31,7 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
     isProduction: boolean;
     isReportDependencies: boolean;
     isReportExports: boolean;
+    isReportCycles: boolean;
     isReportFiles: boolean;
     isReportTypes: boolean;
     isReportValues: boolean;
@@ -193,6 +195,11 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
             entry?: string | string[] | undefined;
             project?: string | string[] | undefined;
         } | undefined;
+        eve?: string | boolean | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
         execa?: string | boolean | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;
@@ -213,6 +220,11 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
             entry?: string | string[] | undefined;
             project?: string | string[] | undefined;
         } | undefined;
+        fumadocs?: string | boolean | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
         gatsby?: string | boolean | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;
@@ -829,7 +841,7 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
             project?: string | string[] | undefined;
         } | undefined;
         $schema?: string | undefined;
-        rules?: Partial<Record<"binaries" | "catalog" | "dependencies" | "devDependencies" | "duplicates" | "enumMembers" | "exports" | "files" | "namespaceMembers" | "nsExports" | "nsTypes" | "optionalPeerDependencies" | "types" | "unlisted" | "unresolved", "error" | "off" | "warn">> | undefined;
+        rules?: Partial<Record<"binaries" | "catalog" | "cycles" | "dependencies" | "devDependencies" | "duplicates" | "enumMembers" | "exports" | "files" | "namespaceMembers" | "nsExports" | "nsTypes" | "optionalPeerDependencies" | "types" | "unlisted" | "unresolved", "error" | "off" | "warn">> | undefined;
         entry?: string | string[] | undefined;
         project?: string | string[] | undefined;
         paths?: Record<string, string[]> | undefined;
@@ -840,7 +852,11 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
         ignoreMembers?: (string | RegExp)[] | undefined;
         ignoreUnresolved?: (string | RegExp)[] | undefined;
         ignoreExportsUsedInFile?: boolean | Record<string, boolean | undefined> | undefined;
-        ignoreIssues?: Record<string, ("binaries" | "catalog" | "dependencies" | "devDependencies" | "duplicates" | "enumMembers" | "exports" | "files" | "namespaceMembers" | "nsExports" | "nsTypes" | "optionalPeerDependencies" | "types" | "unlisted" | "unresolved")[]> | undefined;
+        ignoreIssues?: Record<string, ("binaries" | "catalog" | "cycles" | "dependencies" | "devDependencies" | "duplicates" | "enumMembers" | "exports" | "files" | "namespaceMembers" | "nsExports" | "nsTypes" | "optionalPeerDependencies" | "types" | "unlisted" | "unresolved")[]> | undefined;
+        cycles?: {
+            allow?: string[][] | undefined;
+            dynamicImports?: boolean | undefined;
+        } | undefined;
         ignoreWorkspaces?: string[] | undefined;
         includeEntryExports?: boolean | undefined;
         compilers?: Record<string, true | import("../compilers/types.ts").CompilerAsync | import("../compilers/types.ts").CompilerSync> | undefined;
@@ -849,8 +865,8 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
         tags?: string[] | undefined;
         treatConfigHintsAsErrors?: boolean | undefined;
         treatTagHintsAsErrors?: boolean | undefined;
-        include?: ("binaries" | "catalog" | "dependencies" | "devDependencies" | "duplicates" | "enumMembers" | "exports" | "files" | "namespaceMembers" | "nsExports" | "nsTypes" | "optionalPeerDependencies" | "types" | "unlisted" | "unresolved")[] | undefined;
-        exclude?: ("binaries" | "catalog" | "dependencies" | "devDependencies" | "duplicates" | "enumMembers" | "exports" | "files" | "namespaceMembers" | "nsExports" | "nsTypes" | "optionalPeerDependencies" | "types" | "unlisted" | "unresolved")[] | undefined;
+        include?: ("binaries" | "catalog" | "cycles" | "dependencies" | "devDependencies" | "duplicates" | "enumMembers" | "exports" | "files" | "namespaceMembers" | "nsExports" | "nsTypes" | "optionalPeerDependencies" | "types" | "unlisted" | "unresolved")[] | undefined;
+        exclude?: ("binaries" | "catalog" | "cycles" | "dependencies" | "devDependencies" | "duplicates" | "enumMembers" | "exports" | "files" | "namespaceMembers" | "nsExports" | "nsTypes" | "optionalPeerDependencies" | "types" | "unlisted" | "unresolved")[] | undefined;
         workspaces?: Record<string, {
             angular?: string | boolean | string[] | {
                 config?: string | string[] | undefined;
@@ -1002,6 +1018,11 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
                 entry?: string | string[] | undefined;
                 project?: string | string[] | undefined;
             } | undefined;
+            eve?: string | boolean | string[] | {
+                config?: string | string[] | undefined;
+                entry?: string | string[] | undefined;
+                project?: string | string[] | undefined;
+            } | undefined;
             execa?: string | boolean | string[] | {
                 config?: string | string[] | undefined;
                 entry?: string | string[] | undefined;
@@ -1022,6 +1043,11 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
                 entry?: string | string[] | undefined;
                 project?: string | string[] | undefined;
             } | undefined;
+            fumadocs?: string | boolean | string[] | {
+                config?: string | string[] | undefined;
+                entry?: string | string[] | undefined;
+                project?: string | string[] | undefined;
+            } | undefined;
             gatsby?: string | boolean | string[] | {
                 config?: string | string[] | undefined;
                 entry?: string | string[] | undefined;
@@ -1647,13 +1673,14 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
             ignoreMembers?: (string | RegExp)[] | undefined;
             ignoreUnresolved?: (string | RegExp)[] | undefined;
             ignoreExportsUsedInFile?: boolean | Record<string, boolean | undefined> | undefined;
-            ignoreIssues?: Record<string, ("binaries" | "catalog" | "dependencies" | "devDependencies" | "duplicates" | "enumMembers" | "exports" | "files" | "namespaceMembers" | "nsExports" | "nsTypes" | "optionalPeerDependencies" | "types" | "unlisted" | "unresolved")[]> | undefined;
+            ignoreIssues?: Record<string, ("binaries" | "catalog" | "cycles" | "dependencies" | "devDependencies" | "duplicates" | "enumMembers" | "exports" | "files" | "namespaceMembers" | "nsExports" | "nsTypes" | "optionalPeerDependencies" | "types" | "unlisted" | "unresolved")[]> | undefined;
             includeEntryExports?: boolean | undefined;
         }> | undefined;
     };
     rules: {
         binaries: import("../types/issues.ts").IssueSeverity;
         catalog: import("../types/issues.ts").IssueSeverity;
+        cycles: import("../types/issues.ts").IssueSeverity;
         dependencies: import("../types/issues.ts").IssueSeverity;
         devDependencies: import("../types/issues.ts").IssueSeverity;
         duplicates: import("../types/issues.ts").IssueSeverity;

package/dist/util/create-options.js

@@ -4,7 +4,7 @@ import { knipConfigurationSchema } from '../schema/configuration.js';
 import { getCatalogContainer } from './catalog.js';
 import { ConfigurationError } from './errors.js';
 import { findFile, loadJSON } from './fs.js';
-import { getIncludedIssueTypes, shorthandDeps, shorthandExports, shorthandFiles } from './get-included-issue-types.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';
@@ -82,6 +82,7 @@ export const createOptions = async (options) => {
             ...(args.dependencies ? shorthandDeps : []),
             ...(args.exports ? shorthandExports : []),
             ...(args.files ? shorthandFiles : []),
+            ...(args.cycles ? shorthandCycles : []),
         ],
     });
     for (const [key, value] of Object.entries(includedIssueTypes)) {
@@ -98,6 +99,7 @@ export const createOptions = async (options) => {
         config: args.config,
         configFilePath,
         cwd,
+        cycles: args.cycles ?? false,
         dependencies: args.dependencies ?? false,
         exports: args.exports ?? false,
         files: args.files ?? false,
@@ -128,6 +130,7 @@ export const createOptions = async (options) => {
             includedIssueTypes.enumMembers ||
             includedIssueTypes.namespaceMembers ||
             includedIssueTypes.duplicates,
+        isReportCycles: includedIssueTypes.cycles,
         isReportFiles: includedIssueTypes.files,
         isReportTypes: includedIssueTypes.types ||
             includedIssueTypes.nsTypes ||

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

@@ -10,5 +10,6 @@ export declare const defaultExcludedIssueTypes: string[];
 export declare const shorthandDeps: string[];
 export declare const shorthandExports: string[];
 export declare const shorthandFiles: string[];
+export declare const shorthandCycles: string[];
 export declare const getIncludedIssueTypes: (options: GetIncludedIssueTypesOptions) => Report;
 export {};

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

@@ -1,11 +1,13 @@
 import { ISSUE_TYPES } from '../constants.js';
 import { ConfigurationError } from './errors.js';
-export const defaultExcludedIssueTypes = ['nsExports', 'nsTypes'];
+export const defaultExcludedIssueTypes = ['nsExports', 'nsTypes', 'cycles'];
+const defaultAddOnIssueTypes = ['nsExports', 'nsTypes'];
 const defaultIssueTypes = ISSUE_TYPES.filter(type => !defaultExcludedIssueTypes.includes(type));
 const normalize = (values) => values.flatMap(value => value.split(','));
 export const shorthandDeps = ['dependencies', 'unlisted', 'binaries', 'unresolved', 'catalog'];
 export const shorthandExports = ['exports', 'types', 'enumMembers', 'namespaceMembers', 'duplicates'];
 export const shorthandFiles = ['files'];
+export const shorthandCycles = ['cycles'];
 export const getIncludedIssueTypes = (options) => {
     const incl = normalize(options.includeOverrides ?? []);
     const excl = normalize(options.excludeOverrides ?? []);
@@ -28,7 +30,7 @@ export const getIncludedIssueTypes = (options) => {
             _exclude.push('devDependencies', 'optionalPeerDependencies');
     }
     const included = (_include.length > 0
-        ? _include.some(type => !defaultExcludedIssueTypes.includes(type))
+        ? _include.some(type => !defaultAddOnIssueTypes.includes(type))
             ? _include
             : [..._include, ...defaultIssueTypes]
         : defaultIssueTypes).filter(group => !_exclude.includes(group));

package/dist/util/issue-initializers.js

@@ -5,4 +5,4 @@ export const initCounters = () => ({
     processed: 0,
     total: 0,
 });
-export const defaultRules = Object.fromEntries(ISSUE_TYPES.map(issueType => [issueType, 'error']));
+export const defaultRules = Object.fromEntries(ISSUE_TYPES.map(issueType => [issueType, issueType === 'cycles' ? 'warn' : 'error']));

package/dist/util/load-tsconfig.js

@@ -2,7 +2,7 @@ import { parseTsconfig } from 'get-tsconfig';
 import { compact } from './array.js';
 import { isFile } from './fs.js';
 import { _syncGlob } from './glob.js';
-import { dirname, isAbsolute, join, toAbsolute } from './path.js';
+import { dirname, isAbsolute, join, toAbsolute, toPosix } from './path.js';
 const hasGlobChar = (p) => p.includes('*') || p.includes('?');
 const hasExtension = (p) => {
     const last = p.lastIndexOf('/');
@@ -17,7 +17,20 @@ const resolvePatterns = (patterns, dir, expandDirs = false) => {
         return expandDirs && !hasGlobChar(p) && !hasExtension(p) ? join(resolved, '**/*') : resolved;
     });
 };
-const pathsBaseDir = (baseUrl, dir) => (baseUrl ? toAbsolute(baseUrl, dir) : dir);
+const getImplicitBaseUrl = (compilerOptions) => {
+    for (const symbol of Object.getOwnPropertySymbols(compilerOptions)) {
+        if (symbol.description === 'implicitBaseUrl') {
+            const value = Reflect.get(compilerOptions, symbol);
+            if (typeof value === 'string')
+                return toPosix(value);
+        }
+    }
+};
+const pathsBaseDir = (compilerOptions, dir) => {
+    if (compilerOptions?.baseUrl)
+        return toAbsolute(compilerOptions.baseUrl, dir);
+    return (compilerOptions && getImplicitBaseUrl(compilerOptions)) ?? dir;
+};
 const collectPaths = (acc, paths, baseDir) => {
     if (!paths)
         return;
@@ -74,7 +87,7 @@ const walkReferences = (target, references, dir, visited, pairs, paths) => {
         const refConfig = parseTsconfig(refPath);
         const refDir = dirname(refPath);
         const refOpts = refConfig.compilerOptions;
-        collectPaths(paths, refOpts?.paths, pathsBaseDir(refOpts?.baseUrl, refDir));
+        collectPaths(paths, refOpts?.paths, pathsBaseDir(refOpts, refDir));
         const refOutDir = refOpts?.outDir ? absDir(refOpts.outDir, refDir) : undefined;
         const refRootDir = refOpts?.rootDir ? absDir(refOpts.rootDir, refDir) : undefined;
         if (refOutDir && refRootDir && refOutDir !== refRootDir)
@@ -109,7 +122,7 @@ export const loadTSConfig = async (tsConfigFilePath) => {
         if (compilerOptions.rootDirs)
             compilerOptions.rootDirs = compilerOptions.rootDirs.map(d => absDir(d, dir));
         const tsconfigPaths = {};
-        collectPaths(tsconfigPaths, compilerOptions.paths, pathsBaseDir(compilerOptions.baseUrl, dir));
+        collectPaths(tsconfigPaths, compilerOptions.paths, pathsBaseDir(compilerOptions, dir));
         const sourceMapPairs = [];
         if (config.references?.length) {
             walkReferences(compilerOptions, config.references, dir, new Set([tsConfigFilePath]), sourceMapPairs, tsconfigPaths);

package/dist/util/module-graph.js

@@ -47,6 +47,7 @@ export const createFileNode = () => ({
     exports: new Map(),
     duplicates: new Set(),
     scripts: new Set(),
+    importGlobs: [],
     importedBy: undefined,
     internalImportCache: undefined,
 });

package/dist/util/modules.js

@@ -1,5 +1,6 @@
+import { readFileSync } from 'node:fs';
 import { DT_SCOPE, PROTOCOL_VIRTUAL } from '../constants.js';
-import { isAbsolute, isInNodeModules, toPosix } from './path.js';
+import { isAbsolute, isInNodeModules, join, toPosix } from './path.js';
 export const getPackageNameFromModuleSpecifier = (specifier) => {
     if (!isStartsLikePackageName(specifier))
         return;
@@ -18,13 +19,33 @@ export const getPackageNameFromModuleSpecifier = (specifier) => {
     return specifier;
 };
 const lastPackageNameMatch = /(?<=node_modules\/)(@[^/]+\/[^/]+|[^/]+)/g;
+const yarnPnpmStorePackageRoot = /^(.*\/node_modules\/\.store\/[^/]+\/package)(?:\/|$)/;
+const yarnPnpmStoreNameCache = new Map();
+const getPackageNameFromYarnPnpmStore = (posixPath) => {
+    const match = posixPath.match(yarnPnpmStorePackageRoot);
+    if (!match)
+        return;
+    const root = match[1];
+    if (yarnPnpmStoreNameCache.has(root))
+        return yarnPnpmStoreNameCache.get(root);
+    let name;
+    try {
+        name = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8')).name;
+    }
+    catch { }
+    yarnPnpmStoreNameCache.set(root, name);
+    return name;
+};
 export const getPackageNameFromFilePath = (value) => {
     const name = value.startsWith('file://') ? value.slice(7) : value;
     if (name.includes('node_modules/.bin/'))
         return extractBinary(name);
-    const match = toPosix(name).match(lastPackageNameMatch);
-    if (match)
-        return match[match.length - 1];
+    const posixPath = toPosix(name);
+    const match = posixPath.match(lastPackageNameMatch);
+    if (match) {
+        const last = match[match.length - 1];
+        return last === '.store' ? (getPackageNameFromYarnPnpmStore(posixPath) ?? last) : last;
+    }
     return name;
 };
 export const getPackageNameFromSpecifier = (specifier) => isInNodeModules(specifier) ? getPackageNameFromFilePath(specifier) : getPackageNameFromModuleSpecifier(specifier);

package/dist/util/scripts.d.ts

@@ -0,0 +1,7 @@
+import { type Command, type Node } from 'unbash';
+export interface ScriptCommand {
+    binary: string;
+    args: string[];
+}
+export declare function walkCommands(node: Node): Generator<Command>;
+export declare const getScriptCommands: (script: string) => ScriptCommand[];