knip 5.42.0 → 5.42.1

package/dist/ConfigurationChief.d.ts

@@ -83,6 +83,7 @@ export declare class ConfigurationChief {
         cspell?: (boolean | import("./types/config.js").EnsuredPluginConfiguration) | undefined;
         cucumber?: (boolean | import("./types/config.js").EnsuredPluginConfiguration) | undefined;
         cypress?: (boolean | import("./types/config.js").EnsuredPluginConfiguration) | undefined;
+        "dependency-cruiser"?: (boolean | import("./types/config.js").EnsuredPluginConfiguration) | undefined;
         dotenv?: (boolean | import("./types/config.js").EnsuredPluginConfiguration) | undefined;
         drizzle?: (boolean | import("./types/config.js").EnsuredPluginConfiguration) | undefined;
         eleventy?: (boolean | import("./types/config.js").EnsuredPluginConfiguration) | undefined;

package/dist/ConfigurationValidator.d.ts

@@ -184,6 +184,19 @@ export declare const ConfigurationValidator: z.ZodObject<z.objectUtil.extendShap
             entry?: string | string[] | undefined;
             project?: string | string[] | undefined;
         }>]>>;
+        'dependency-cruiser': z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, z.ZodObject<{
+            config: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+            entry: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+            project: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+        }, "strip", z.ZodTypeAny, {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        }, {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        }>]>>;
         dotenv: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, z.ZodObject<{
             config: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
             entry: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
@@ -1266,6 +1279,11 @@ export declare const ConfigurationValidator: z.ZodObject<z.objectUtil.extendShap
             entry?: string | string[] | undefined;
             project?: string | string[] | undefined;
         } | undefined;
+        'dependency-cruiser'?: string | boolean | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
         dotenv?: string | boolean | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;
@@ -1725,6 +1743,11 @@ export declare const ConfigurationValidator: z.ZodObject<z.objectUtil.extendShap
             entry?: string | string[] | undefined;
             project?: string | string[] | undefined;
         } | undefined;
+        'dependency-cruiser'?: string | boolean | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
         dotenv?: string | boolean | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;
@@ -2274,6 +2297,19 @@ export declare const ConfigurationValidator: z.ZodObject<z.objectUtil.extendShap
         entry?: string | string[] | undefined;
         project?: string | string[] | undefined;
     }>]>>;
+    'dependency-cruiser': z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, z.ZodObject<{
+        config: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+        entry: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+        project: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    }, "strip", z.ZodTypeAny, {
+        config?: string | string[] | undefined;
+        entry?: string | string[] | undefined;
+        project?: string | string[] | undefined;
+    }, {
+        config?: string | string[] | undefined;
+        entry?: string | string[] | undefined;
+        project?: string | string[] | undefined;
+    }>]>>;
     dotenv: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, z.ZodObject<{
         config: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
         entry: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
@@ -3358,6 +3394,11 @@ export declare const ConfigurationValidator: z.ZodObject<z.objectUtil.extendShap
         entry?: string | string[] | undefined;
         project?: string | string[] | undefined;
     } | undefined;
+    'dependency-cruiser'?: string | boolean | string[] | {
+        config?: string | string[] | undefined;
+        entry?: string | string[] | undefined;
+        project?: string | string[] | undefined;
+    } | undefined;
     dotenv?: string | boolean | string[] | {
         config?: string | string[] | undefined;
         entry?: string | string[] | undefined;
@@ -3823,6 +3864,11 @@ export declare const ConfigurationValidator: z.ZodObject<z.objectUtil.extendShap
             entry?: string | string[] | undefined;
             project?: string | string[] | undefined;
         } | undefined;
+        'dependency-cruiser'?: string | boolean | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
         dotenv?: string | boolean | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;
@@ -4285,6 +4331,11 @@ export declare const ConfigurationValidator: z.ZodObject<z.objectUtil.extendShap
         entry?: string | string[] | undefined;
         project?: string | string[] | undefined;
     } | undefined;
+    'dependency-cruiser'?: string | boolean | string[] | {
+        config?: string | string[] | undefined;
+        entry?: string | string[] | undefined;
+        project?: string | string[] | undefined;
+    } | undefined;
     dotenv?: string | boolean | string[] | {
         config?: string | string[] | undefined;
         entry?: string | string[] | undefined;
@@ -4750,6 +4801,11 @@ export declare const ConfigurationValidator: z.ZodObject<z.objectUtil.extendShap
             entry?: string | string[] | undefined;
             project?: string | string[] | undefined;
         } | undefined;
+        'dependency-cruiser'?: string | boolean | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
         dotenv?: string | boolean | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;

package/dist/IssueCollector.js

@@ -51,11 +51,13 @@ export class IssueCollector {
         if (this.isMatch(issue.filePath))
             return;
         const key = relative(this.cwd, issue.filePath);
-        issue.severity = this.rules[issue.type];
-        const issues = this.issues[issue.type];
+        const { type } = issue;
+        issue.severity = this.rules[type];
+        const issues = this.issues[type];
         issues[key] = issues[key] ?? {};
-        if (!issues[key][issue.symbol]) {
-            issues[key][issue.symbol] = issue;
+        const symbol = type.endsWith('Members') && issue.parentSymbol ? `${issue.parentSymbol}.${issue.symbol}` : issue.symbol;
+        if (!issues[key][symbol]) {
+            issues[key][symbol] = issue;
             this.counters[issue.type]++;
         }
         return issue;

package/dist/binaries/package-manager/bun.js

@@ -2,10 +2,16 @@ import parseArgs from 'minimist';
 import { isFile } from '../../util/fs.js';
 import { toEntry } from '../../util/input.js';
 import { isAbsolute, join } from '../../util/path.js';
-const commands = ['add', 'create', 'init', 'install', 'link', 'pm', 'remove', 'run', 'test', 'update', 'upgrade'];
-export const resolve = (_binary, args, { manifestScriptNames, cwd, fromArgs }) => {
+import { resolveX } from './bunx.js';
+const commands = ['add', 'create', 'init', 'install', 'link', 'pm', 'remove', 'run', 'test', 'update', 'upgrade', 'x'];
+export const resolve = (_binary, args, options) => {
     const parsed = parseArgs(args);
     const [command, script] = parsed._;
+    if (command === 'x') {
+        const argsForX = args.filter(arg => arg !== 'x');
+        return resolveX(argsForX, options);
+    }
+    const { manifestScriptNames, cwd, fromArgs } = options;
     if (command === 'run' && manifestScriptNames.has(script))
         return [];
     if (manifestScriptNames.has(command) || commands.includes(command))

package/dist/binaries/package-manager/bunx.d.ts

@@ -0,0 +1,3 @@
+import type { BinaryResolver, BinaryResolverOptions } from '../../types/config.js';
+export declare const resolveX: (args: string[], options: BinaryResolverOptions) => import("../../util/input.js").Input[];
+export declare const resolve: BinaryResolver;

package/dist/binaries/package-manager/bunx.js

@@ -0,0 +1,18 @@
+import parseArgs from 'minimist';
+import { toDependency } from '../../util/input.js';
+import { stripVersionFromSpecifier } from '../../util/modules.js';
+import { argsFrom } from '../util.js';
+export const resolveX = (args, options) => {
+    const { fromArgs } = options;
+    const parsed = parseArgs(args);
+    const packageSpecifier = parsed._[0];
+    const specifier = packageSpecifier ? stripVersionFromSpecifier(packageSpecifier) : '';
+    const packages = parsed.package && !parsed.yes ? [parsed.package].flat().map(stripVersionFromSpecifier) : [];
+    const command = parsed['shell-mode'] ? fromArgs([parsed['shell-mode']]) : [];
+    const restArgs = argsFrom(args, packageSpecifier);
+    const dependency = specifier ? [toDependency(specifier, { optional: true })] : [];
+    return [...dependency, ...packages.map(id => toDependency(id)), ...command, ...fromArgs(restArgs).slice(1)];
+};
+export const resolve = (_binary, args, options) => {
+    return resolveX(args, options);
+};

package/dist/binaries/package-manager/index.d.ts

@@ -1,8 +1,10 @@
 declare const _default: {
     bun: import("../../types/config.js").BinaryResolver;
+    bunx: import("../../types/config.js").BinaryResolver;
     npm: import("../../types/config.js").BinaryResolver;
     npx: import("../../types/config.js").BinaryResolver;
     pnpm: import("../../types/config.js").BinaryResolver;
+    pnpx: import("../../types/config.js").BinaryResolver;
     yarn: import("../../types/config.js").BinaryResolver;
 };
 export default _default;

package/dist/binaries/package-manager/index.js

@@ -1,12 +1,16 @@
 import * as bun from './bun.js';
+import * as bunx from './bunx.js';
 import * as npm from './npm.js';
 import * as npx from './npx.js';
 import * as pnpm from './pnpm.js';
+import * as pnpx from './pnpx.js';
 import * as yarn from './yarn.js';
 export default {
     bun: bun.resolve,
+    bunx: bunx.resolve,
     npm: npm.resolve,
     npx: npx.resolve,
     pnpm: pnpm.resolve,
+    pnpx: pnpx.resolve,
     yarn: yarn.resolve,
 };

package/dist/binaries/package-manager/npm.js

@@ -1,8 +1,7 @@
 import parseArgs from 'minimist';
-import { toBinary } from '../../util/input.js';
 export const resolve = (_binary, args, options) => {
     const { fromArgs } = options;
     const parsed = parseArgs(args);
     const [command] = parsed._;
-    return [toBinary(_binary), ...(command !== 'exec' ? [] : fromArgs(parsed._.slice(1)))];
+    return command !== 'exec' ? [] : fromArgs(parsed._.slice(1));
 };

package/dist/binaries/package-manager/npx.js

@@ -15,7 +15,12 @@ export const resolve = (_binary, args, options) => {
     const command = parsed.call ? fromArgs([parsed.call]) : [];
     const restArgs = argsFrom(args, packageSpecifier);
     const isBinary = specifier && !packageSpecifier.includes('@') && !isInternal(specifier);
-    const dependency = isBinary ? toBinary(specifier) : toDependency(specifier);
+    const dependency = isBinary ? toBinary(specifier) : toDependency(specifier, { optional: !parsed.no });
     const specifiers = dependency && !parsed.yes ? [dependency] : [];
-    return [toBinary(_binary), ...specifiers, ...packages.map(toDependency), ...command, ...fromArgs(restArgs).slice(1)];
+    return [
+        ...specifiers,
+        ...packages.map(id => toDependency(id, { optional: true })),
+        ...command,
+        ...fromArgs(restArgs).slice(1),
+    ];
 };

package/dist/binaries/package-manager/pnpm.js

@@ -1,5 +1,6 @@
 import parseArgs from 'minimist';
 import { toBinary } from '../../util/input.js';
+import { resolveDlx } from './pnpx.js';
 const commands = [
     'add',
     'audit',
@@ -51,12 +52,17 @@ const commands = [
     'upgrade',
     'why',
 ];
-export const resolve = (_binary, args, { manifestScriptNames, fromArgs }) => {
+export const resolve = (_binary, args, options) => {
     const parsed = parseArgs(args, {
         boolean: ['recursive', 'silent', 'shell-mode'],
         alias: { recursive: 'r', silent: 's', 'shell-mode': 'c' },
     });
     const [command, binary] = parsed._;
+    if (command === 'dlx') {
+        const argsForDlx = args.filter(arg => arg !== 'dlx');
+        return resolveDlx(argsForDlx, options);
+    }
+    const { manifestScriptNames, fromArgs } = options;
     if (manifestScriptNames.has(command) || commands.includes(command))
         return [];
     if (command === 'exec') {

package/dist/binaries/package-manager/pnpx.d.ts

@@ -0,0 +1,3 @@
+import type { BinaryResolver, BinaryResolverOptions } from '../../types/config.js';
+export declare const resolveDlx: (args: string[], options: BinaryResolverOptions) => import("../../util/input.js").Input[];
+export declare const resolve: BinaryResolver;

package/dist/binaries/package-manager/pnpx.js

@@ -0,0 +1,18 @@
+import parseArgs from 'minimist';
+import { toDependency } from '../../util/input.js';
+import { stripVersionFromSpecifier } from '../../util/modules.js';
+export const resolveDlx = (args, options) => {
+    const parsed = parseArgs(args, {
+        boolean: ['silent'],
+        alias: { package: 'p', 'shell-mode': 'c' },
+    });
+    const packageSpecifier = parsed._[0];
+    const specifier = packageSpecifier ? stripVersionFromSpecifier(packageSpecifier) : '';
+    const packages = parsed.package && !parsed.yes ? [parsed.package].flat().map(stripVersionFromSpecifier) : [];
+    const command = parsed['shell-mode'] ? options.fromArgs([parsed['shell-mode']]) : [];
+    const dependency = specifier ? [toDependency(specifier, { optional: true })] : [];
+    return [...dependency, ...packages.map(id => toDependency(id, { optional: true })), ...command];
+};
+export const resolve = (_binary, args, options) => {
+    return resolveDlx(args, options);
+};

package/dist/binaries/package-manager/yarn.js

@@ -42,9 +42,10 @@ export const resolve = (_binary, args, { manifestScriptNames, fromArgs, cwd, roo
         return [];
     if (!dir && command === 'run' && manifestScriptNames.has(binary))
         return [];
-    if (command === 'run' || command === 'exec')
-        return dir ? [{ ...toBinary(binary), dir }] : [toBinary(binary)];
     if (command === 'node')
         return fromArgs(parsed._);
-    return command ? (dir ? [{ ...toBinary(command), dir }] : [toBinary(command)]) : [];
+    const bin = command === 'run' || command === 'exec' ? toBinary(binary) : toBinary(command);
+    if (dir)
+        Object.assign(bin, { dir });
+    return [bin];
 };

package/dist/binaries/plugins.js

@@ -2,6 +2,7 @@ import parseArgs from 'minimist';
 import { pluginArgsMap } from '../plugins.js';
 import { compact } from '../util/array.js';
 import { toBinary, toConfig, toDeferResolve, toDeferResolveEntry, toEntry } from '../util/input.js';
+import { extractBinary } from '../util/modules.js';
 import { resolve as fallbackResolve } from './fallback.js';
 const isGlobLikeMatch = /(^!|[*+\\(|{^$])/;
 const isGlobLike = (value) => isGlobLikeMatch.test(value);
@@ -31,8 +32,12 @@ export const resolve = (binary, _args, options) => {
         const id = parsed._[0];
         if (isGlobLike(id))
             positionals.push(toEntry(id));
-        else
-            positionals.push(toDeferResolveEntry(id));
+        else {
+            if (id.includes('node_modules/.bin/'))
+                positionals.push(toBinary(extractBinary(id)));
+            else
+                positionals.push(toDeferResolveEntry(id));
+        }
     }
     const mapToParsedKey = (id) => parsed[id];
     const resolved = compact(opts.resolve ? opts.resolve.flatMap(mapToParsedKey) : []);

package/dist/compilers/index.d.ts

@@ -73,6 +73,11 @@ export declare const partitionCompilers: (rawLocalConfig: RawConfiguration) => {
         entry?: string | string[] | undefined;
         project?: string | string[] | undefined;
     } | undefined;
+    'dependency-cruiser'?: string | boolean | string[] | {
+        config?: string | string[] | undefined;
+        entry?: string | string[] | undefined;
+        project?: string | string[] | undefined;
+    } | undefined;
     dotenv?: string | boolean | string[] | {
         config?: string | string[] | undefined;
         entry?: string | string[] | undefined;
@@ -536,6 +541,11 @@ export declare const partitionCompilers: (rawLocalConfig: RawConfiguration) => {
             entry?: string | string[] | undefined;
             project?: string | string[] | undefined;
         } | undefined;
+        'dependency-cruiser'?: string | boolean | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
         dotenv?: string | boolean | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;

package/dist/index.js

@@ -251,7 +251,7 @@ export const main = async (unresolvedConfiguration) => {
             graph.set(filePath, file);
             if (scripts && scripts.size > 0) {
                 const dependencies = deputy.getDependencies(workspace.name);
-                const manifestScriptNames = new Set();
+                const manifestScriptNames = new Set(Object.keys(chief.getManifestForWorkspace(workspace.name)?.scripts ?? {}));
                 const rootCwd = cwd;
                 const options = {
                     cwd: dirname(filePath),
@@ -260,11 +260,11 @@ export const main = async (unresolvedConfiguration) => {
                     dependencies,
                     manifestScriptNames,
                 };
-                const specifiers = _getInputsFromScripts(scripts, options);
-                for (const specifier of specifiers) {
-                    specifier.containingFilePath = filePath;
-                    specifier.dir = cwd;
-                    const specifierFilePath = getReferencedInternalFilePath(specifier, workspace);
+                const inputs = _getInputsFromScripts(scripts, options);
+                for (const input of inputs) {
+                    input.containingFilePath = filePath;
+                    input.dir = cwd;
+                    const specifierFilePath = getReferencedInternalFilePath(input, workspace);
                     if (specifierFilePath)
                         analyzeSourceFile(specifierFilePath, principal);
                 }

package/dist/plugins/capacitor/index.js

@@ -11,7 +11,7 @@ const resolveConfig = async (config, { configFileDir }) => {
     const plugins = config.includePlugins ?? [];
     const android = (await exists('android/capacitor.settings.gradle')) ? ['@capacitor/android'] : [];
     const ios = (await exists('ios/App/Podfile')) ? ['@capacitor/ios'] : [];
-    return [...plugins, ...android, ...ios].map(toDependency);
+    return [...plugins, ...android, ...ios].map(id => toDependency(id));
 };
 export default {
     title,

package/dist/plugins/changesets/index.js

@@ -10,7 +10,7 @@ const resolveConfig = config => {
         ? [config.changelog[0]]
         : typeof config.changelog === 'string'
             ? [config.changelog]
-            : []).map(toDependency);
+            : []).map(id => toDependency(id));
 };
 export default {
     title,

package/dist/plugins/commitlint/index.js

@@ -21,7 +21,7 @@ const resolveConfig = async (config) => {
                 ? [parserPreset.path ?? parserPreset]
                 : []
         : [];
-    return [...extendsConfigs, ...plugins, ...formatter, ...parserPresetPaths].map(toDependency);
+    return [...extendsConfigs, ...plugins, ...formatter, ...parserPresetPaths].map(id => toDependency(id));
 };
 export default {
     title,

package/dist/plugins/dependency-cruiser/index.d.ts

@@ -0,0 +1,12 @@
+import type { IsPluginEnabled } from '../../types/config.js';
+declare const _default: {
+    title: string;
+    enablers: string[];
+    isEnabled: IsPluginEnabled;
+    config: string[];
+    args: {
+        binaries: string[];
+        config: boolean;
+    };
+};
+export default _default;

package/dist/plugins/dependency-cruiser/index.js

@@ -0,0 +1,16 @@
+import { hasDependency } from '../../util/plugin.js';
+const title = 'dependency-cruiser';
+const enablers = ['dependency-cruiser'];
+const isEnabled = ({ dependencies }) => hasDependency(dependencies, enablers);
+const config = ['.dependency-cruiser.{js,cjs,mjs,json}'];
+const args = {
+    binaries: ['depcruise', 'dependency-cruise', 'dependency-cruiser', 'depcruise-baseline'],
+    config: true,
+};
+export default {
+    title,
+    enablers,
+    isEnabled,
+    config,
+    args,
+};

package/dist/plugins/expo/helpers.js

@@ -9,7 +9,7 @@ export const getDependencies = async (expoConfig, { manifest }) => {
         return getPackageNameFromModuleSpecifier(pluginName);
     })
         .filter(Boolean) ?? [];
-    const inputs = new Set(pluginPackages.map(toDependency));
+    const inputs = new Set(pluginPackages.map(id => toDependency(id)));
     const allowedPackages = ['expo-atlas', 'expo-dev-client'];
     const allowedProductionPackages = ['expo-insights'];
     const manifestDependencies = Object.keys(manifest.dependencies ?? {});

package/dist/plugins/gatsby/index.js

@@ -26,7 +26,7 @@ const resolveConfig = async (localConfig, options) => {
         if (typeof _config.onCreateBabelConfig === 'function') {
             _config.onCreateBabelConfig({ actions });
         }
-        return Array.from(plugins).map(toDependency);
+        return Array.from(plugins).map(id => toDependency(id));
     }
     return [];
 };

package/dist/plugins/graphql-codegen/index.js

@@ -48,7 +48,7 @@ const resolveConfig = config => {
             return [];
         if (isInternal(plugin))
             return [toEntry(plugin)];
-        return [plugin.includes('codegen-') ? plugin : `@graphql-codegen/${plugin}`].map(toDependency);
+        return [plugin.includes('codegen-') ? plugin : `@graphql-codegen/${plugin}`].map(id => toDependency(id));
     });
     return [...presets, ...flatPlugins, ...nestedPlugins].map(id => (typeof id === 'string' ? toDependency(id) : id));
 };

package/dist/plugins/index.d.ts

@@ -94,6 +94,16 @@ export declare const Plugins: {
         resolveEntryPaths: import("../types/config.js").ResolveEntryPaths;
         resolveConfig: import("../types/config.js").ResolveConfig<import("./cypress/types.js").CypressConfig>;
     };
+    'dependency-cruiser': {
+        title: string;
+        enablers: string[];
+        isEnabled: import("../types/config.js").IsPluginEnabled;
+        config: string[];
+        args: {
+            binaries: string[];
+            config: boolean;
+        };
+    };
     dotenv: {
         title: string;
         args: {
@@ -251,7 +261,6 @@ export declare const Plugins: {
     };
     metro: {
         title: string;
-        note: string;
         enablers: string[];
         isEnabled: import("../types/config.js").IsPluginEnabled;
         config: string[];
@@ -341,7 +350,6 @@ export declare const Plugins: {
     };
     nuxt: {
         title: string;
-        note: string;
         enablers: string[];
         isEnabled: import("../types/config.js").IsPluginEnabled;
         entry: string[];

package/dist/plugins/index.js

@@ -10,6 +10,7 @@ import { default as commitlint } from './commitlint/index.js';
 import { default as cspell } from './cspell/index.js';
 import { default as cucumber } from './cucumber/index.js';
 import { default as cypress } from './cypress/index.js';
+import { default as dependencyCruiser } from './dependency-cruiser/index.js';
 import { default as dotenv } from './dotenv/index.js';
 import { default as drizzle } from './drizzle/index.js';
 import { default as eleventy } from './eleventy/index.js';
@@ -101,6 +102,7 @@ export const Plugins = {
     cspell,
     cucumber,
     cypress,
+    'dependency-cruiser': dependencyCruiser,
     dotenv,
     drizzle,
     eleventy,

package/dist/plugins/lefthook/index.js

@@ -10,7 +10,7 @@ const gitHookPaths = getGitHookPaths();
 const config = ['lefthook.yml', ...gitHookPaths];
 const resolveConfig = async (localConfig, options) => {
     const { manifest, configFileName, cwd, getInputsFromScripts } = options;
-    const inputs = manifest.devDependencies ? Object.keys(manifest.devDependencies).map(toDependency) : [];
+    const inputs = manifest.devDependencies ? Object.keys(manifest.devDependencies).map(id => toDependency(id)) : [];
     if (extname(configFileName) === '.yml') {
         const scripts = findByKeyDeep(localConfig, 'run').flatMap(command => {
             const deps = getInputsFromScripts([command.run], { ...options, knownBinsOnly: true });
@@ -18,7 +18,7 @@ const resolveConfig = async (localConfig, options) => {
             return deps.flatMap(dependency => ({ ...dependency, dir }));
         });
         const lefthook = process.env.CI
-            ? enablers.filter(dependency => inputs.some(d => d.specifier === dependency)).map(toDependency)
+            ? enablers.filter(dependency => inputs.some(d => d.specifier === dependency)).map(id => toDependency(id))
             : [];
         return [...scripts, ...lefthook];
     }

package/dist/plugins/markdownlint/index.js

@@ -14,7 +14,7 @@ const resolveConfig = (config, options) => {
     const uses = scripts
         .filter(script => script.includes('markdownlint '))
         .flatMap(script => getArgumentValues(script, / (--rules|-r)[ =]([^ ]+)/g));
-    return [...extend, ...uses].map(toDependency);
+    return [...extend, ...uses].map(id => toDependency(id));
 };
 export default {
     title,

package/dist/plugins/metro/index.d.ts

@@ -1,11 +1,11 @@
 import type { IsPluginEnabled, ResolveConfig, ResolveEntryPaths } from '../../types/config.js';
 import type { MetroConfig } from './types.js';
 export declare const docs: {
+    note: string;
     production: string[];
 };
 declare const _default: {
     title: string;
-    note: string;
     enablers: string[];
     isEnabled: IsPluginEnabled;
     config: string[];

package/dist/plugins/metro/index.js

@@ -3,8 +3,6 @@ import { toDeferResolve, toProductionEntry } from '../../util/input.js';
 import { join } from '../../util/path.js';
 import { hasDependency } from '../../util/plugin.js';
 const title = 'Metro';
-const note = `False positives for platform-specific unused files?
-Override the entry patterns as shown below to match platforms and extensions.`;
 const enablers = ['metro', 'react-native'];
 const isEnabled = options => hasDependency(options.dependencies, enablers);
 const config = ['metro.config.{js,cjs,json}', 'package.json'];
@@ -12,7 +10,6 @@ const DEFAULT_PLATFORMS = ['ios', 'android', 'windows', 'web'];
 const PLATFORMS = [...DEFAULT_PLATFORMS, 'native', 'default'];
 const DEFAULT_EXTENSIONS = ['js', 'jsx', 'json', 'ts', 'tsx'];
 const production = [`src/**/*.{${PLATFORMS.join(',')}}.{${DEFAULT_EXTENSIONS.join(',')}}`];
-export const docs = { production };
 const resolveEntryPaths = async (config) => {
     const platformEntryPatterns = compact(PLATFORMS.concat(config.resolver?.platforms ?? []));
     const sourceExts = config.resolver?.sourceExts ?? DEFAULT_EXTENSIONS;
@@ -37,9 +34,11 @@ const resolveConfig = async (config) => {
         inputs.push(transformer.babelTransformerPath);
     return [...inputs].map(toDeferResolve);
 };
+const note = `False positives for platform-specific unused files?
+Override the entry patterns as shown below to match platforms and extensions.`;
+export const docs = { note, production };
 export default {
     title,
-    note,
     enablers,
     isEnabled,
     config,

package/dist/plugins/nest/index.js

@@ -6,7 +6,7 @@ const isEnabled = ({ dependencies }) => hasDependency(dependencies, enablers);
 const config = ['nest-cli.json', '.nestcli.json', '.nest-cli.json', 'nest.json'];
 const resolveConfig = async (config) => {
     const inputs = config?.collection ? [config.collection] : [];
-    return [...inputs].map(toDependency);
+    return [...inputs].map(id => toDependency(id));
 };
 export default {
     title,

package/dist/plugins/netlify/index.js

@@ -19,8 +19,8 @@ const resolveEntryPaths = localConfig => {
 };
 const resolveConfig = async (localConfig) => {
     return [
-        ...(localConfig?.plugins?.map(plugin => plugin.package) ?? []).map(toDependency),
-        ...extractFunctionsConfigProperty(localConfig.functions || {}, 'external_node_modules').map(toDependency),
+        ...(localConfig?.plugins?.map(plugin => plugin.package) ?? []).map(id => toDependency(id)),
+        ...extractFunctionsConfigProperty(localConfig.functions || {}, 'external_node_modules').map(id => toDependency(id)),
     ];
 };
 export default {

package/dist/plugins/npm-package-json-lint/index.js

@@ -7,7 +7,7 @@ const isEnabled = ({ dependencies }) => hasDependency(dependencies, enablers);
 const packageJsonPath = 'npmpackagejsonlint';
 const config = ['package.json', ...toCosmiconfig('npmpackagejsonlint')];
 const resolveConfig = localConfig => {
-    return localConfig?.extends ? [localConfig.extends].map(toDependency) : [];
+    return localConfig?.extends ? [localConfig.extends].map(id => toDependency(id)) : [];
 };
 export default {
     title,

package/dist/plugins/nuxt/index.d.ts

@@ -1,8 +1,10 @@
 import type { IsPluginEnabled, ResolveEntryPaths } from '../../types/config.js';
 import type { NuxtConfig } from './types.js';
+export declare const docs: {
+    note: string;
+};
 declare const _default: {
     title: string;
-    note: string;
     enablers: string[];
     isEnabled: IsPluginEnabled;
     entry: string[];

package/dist/plugins/nuxt/index.js

@@ -2,8 +2,6 @@ import { toProductionEntry } from '../../util/input.js';
 import { join } from '../../util/path.js';
 import { hasDependency } from '../../util/plugin.js';
 const title = 'Nuxt';
-const note = `Knip works best with [explicit imports](https://nuxt.com/docs/guide/concepts/auto-imports#explicit-imports).
-Nuxt allows to [disable auto-imports](https://nuxt.com/docs/guide/concepts/auto-imports#disabling-auto-imports).`;
 const enablers = ['nuxt'];
 const isEnabled = ({ dependencies }) => {
     const isEnabled = hasDependency(dependencies, enablers);
@@ -38,9 +36,11 @@ const resolveEntryPaths = async (localConfig) => {
     ];
     return patterns.map(pattern => toProductionEntry(join(srcDir, pattern)));
 };
+const note = `Knip works best with [explicit imports](https://nuxt.com/docs/guide/concepts/auto-imports#explicit-imports).
+Nuxt allows to [disable auto-imports](https://nuxt.com/docs/guide/concepts/auto-imports#disabling-auto-imports).`;
+export const docs = { note };
 export default {
     title,
-    note,
     enablers,
     isEnabled,
     entry,

package/dist/plugins/nx/index.js

@@ -21,7 +21,7 @@ const findNxDependenciesInNxJson = async (localConfig) => {
             .filter(value => value !== undefined)
             .map(value => value.split(':')[0])
         : [];
-    return compact([...targetsDefault, ...plugins, ...generators]).map(toDependency);
+    return compact([...targetsDefault, ...plugins, ...generators]).map(id => toDependency(id));
 };
 const resolveConfig = async (localConfig, options) => {
     const { configFileName } = options;

package/dist/plugins/oclif/index.js

@@ -7,7 +7,7 @@ const config = ['package.json'];
 const resolveConfig = async (config) => {
     const plugins = config?.plugins ?? [];
     const devPlugins = config?.devPlugins ?? [];
-    return [...plugins, ...devPlugins].map(toDependency);
+    return [...plugins, ...devPlugins].map(id => toDependency(id));
 };
 export default {
     title,

package/dist/plugins/prettier/index.js

@@ -13,7 +13,7 @@ const resolveConfig = config => {
     if (typeof config === 'string')
         return [toDeferResolve(config)];
     return Array.isArray(config.plugins)
-        ? config.plugins.filter((plugin) => typeof plugin === 'string').map(toDependency)
+        ? config.plugins.filter((plugin) => typeof plugin === 'string').map(id => toDependency(id))
         : [];
 };
 export default {

package/dist/plugins/release-it/index.js

@@ -14,7 +14,7 @@ const resolveConfig = (config, options) => {
         scripts.push(config.gitlab.releaseNotes);
     }
     const inputs = options.getInputsFromScripts(scripts);
-    return [...plugins.map(toDependency), ...inputs];
+    return [...plugins.map(id => toDependency(id)), ...inputs];
 };
 export default {
     title,

package/dist/plugins/semantic-release/index.js

@@ -7,9 +7,15 @@ const isEnabled = ({ dependencies }) => hasDependency(dependencies, enablers);
 const isRootOnly = true;
 const packageJsonPath = 'release';
 const config = ['package.json', ...toCosmiconfig('release')];
+const excludePackages = [
+    '@semantic-release/commit-analyzer',
+    '@semantic-release/github',
+    '@semantic-release/npm',
+    '@semantic-release/release-notes-generator',
+];
 const resolveConfig = config => {
     const plugins = (config?.plugins ?? []).map(plugin => (Array.isArray(plugin) ? plugin[0] : plugin));
-    return plugins.map(toDeferResolve);
+    return plugins.filter(plugin => !excludePackages.includes(plugin)).map(toDeferResolve);
 };
 export default {
     title,

package/dist/plugins/storybook/index.js

@@ -30,7 +30,11 @@ const resolveConfig = async (localConfig) => {
             : [builder]
         : [];
     const frameworks = localConfig.framework?.name ? [localConfig.framework.name] : [];
-    return [...addons.map(toDeferResolve), ...builderPackages.map(toDependency), ...frameworks.map(toDependency)];
+    return [
+        ...addons.map(toDeferResolve),
+        ...builderPackages.map(id => toDependency(id)),
+        ...frameworks.map(id => toDependency(id)),
+    ];
 };
 export default {
     title,

package/dist/plugins/typescript/index.d.ts

@@ -1,5 +1,8 @@
 import type { TsConfigJson } from 'type-fest';
 import type { IsPluginEnabled, ResolveConfig } from '../../types/config.js';
+export declare const docs: {
+    note: string;
+};
 declare const _default: {
     title: string;
     enablers: string[];

package/dist/plugins/typescript/index.js

@@ -30,6 +30,8 @@ const args = {
     alias: { project: ['p'] },
     config: [['project', (p) => (p.endsWith('.json') ? p : join(p, 'tsconfig.json'))]],
 };
+const note = '[What’s up with that configurable tsconfig.json location?](/reference/faq#whats-up-with-that-configurable-tsconfigjson-location)';
+export const docs = { note };
 export default {
     title,
     enablers,

package/dist/plugins/vitest/index.js

@@ -25,7 +25,7 @@ const findConfigDependencies = (localConfig, options) => {
     const dir = join(configFileDir, testConfig.root ?? '.');
     const setupFiles = [testConfig.setupFiles ?? []].flat().map(specifier => ({ ...toDeferResolve(specifier), dir }));
     const globalSetup = [testConfig.globalSetup ?? []].flat().map(specifier => ({ ...toDeferResolve(specifier), dir }));
-    return [...[...environments, ...reporters, ...coverage].map(toDependency), ...setupFiles, ...globalSetup];
+    return [...[...environments, ...reporters, ...coverage].map(id => toDependency(id)), ...setupFiles, ...globalSetup];
 };
 const getConfigs = async (localConfig) => {
     const configs = [];

package/dist/plugins/webdriver-io/index.js

@@ -23,7 +23,7 @@ const resolveConfig = async (config) => {
         })
             .map(reporter => `@wdio/${reporter}-reporter`)
         : [];
-    return [...frameworks, ...runners, ...reporters].map(toDependency);
+    return [...frameworks, ...runners, ...reporters].map(id => toDependency(id));
 };
 export default {
     title,

package/dist/reporters/symbols.js

@@ -8,6 +8,11 @@ const bright = picocolors.whiteBright;
 const TRUNCATE_WIDTH = 40;
 const truncate = (text) => (text.length > TRUNCATE_WIDTH ? `${text.slice(0, TRUNCATE_WIDTH - 3)}...` : text);
 const truncateStart = (text, width) => (text.length > width ? `...${text.slice(-(width - 3))}` : text);
+const sortByPos = (a, b) => {
+    const [f, r, c] = a.filePath.split(':');
+    const [f2, r2, c2] = b.filePath.split(':');
+    return f === f2 ? (Number(r) === Number(r2) ? Number(c) - Number(c2) : Number(r) - Number(r2)) : f.localeCompare(f2);
+};
 const hl = (issue) => {
     if (issue.specifier && issue.specifier !== issue.symbol && issue.specifier.includes(issue.symbol)) {
         const parts = issue.specifier.split(issue.symbol);
@@ -32,7 +37,7 @@ const logIssueRecord = (issues) => {
         issue.isFixed && table.cell('fixed', print('(removed)'));
         table.newRow();
     }
-    console.log(table.sort(['filePath', 'parentSymbol', 'symbol']).print().trim());
+    console.log(table.sort(sortByPos).print().trim());
 };
 export default ({ report, issues, tagHints, configurationHints, noConfigHints, isShowProgress }) => {
     const reportMultipleGroups = Object.values(report).filter(Boolean).length > 1;

package/dist/schema/plugins.d.ts

@@ -170,6 +170,19 @@ export declare const pluginsSchema: z.ZodObject<{
         entry?: string | string[] | undefined;
         project?: string | string[] | undefined;
     }>]>;
+    'dependency-cruiser': z.ZodUnion<[z.ZodBoolean, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, z.ZodObject<{
+        config: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+        entry: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+        project: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    }, "strip", z.ZodTypeAny, {
+        config?: string | string[] | undefined;
+        entry?: string | string[] | undefined;
+        project?: string | string[] | undefined;
+    }, {
+        config?: string | string[] | undefined;
+        entry?: string | string[] | undefined;
+        project?: string | string[] | undefined;
+    }>]>;
     dotenv: z.ZodUnion<[z.ZodBoolean, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, z.ZodObject<{
         config: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
         entry: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
@@ -1250,6 +1263,11 @@ export declare const pluginsSchema: z.ZodObject<{
         entry?: string | string[] | undefined;
         project?: string | string[] | undefined;
     };
+    'dependency-cruiser': string | boolean | string[] | {
+        config?: string | string[] | undefined;
+        entry?: string | string[] | undefined;
+        project?: string | string[] | undefined;
+    };
     dotenv: string | boolean | string[] | {
         config?: string | string[] | undefined;
         entry?: string | string[] | undefined;
@@ -1701,6 +1719,11 @@ export declare const pluginsSchema: z.ZodObject<{
         entry?: string | string[] | undefined;
         project?: string | string[] | undefined;
     };
+    'dependency-cruiser': string | boolean | string[] | {
+        config?: string | string[] | undefined;
+        entry?: string | string[] | undefined;
+        project?: string | string[] | undefined;
+    };
     dotenv: string | boolean | string[] | {
         config?: string | string[] | undefined;
         entry?: string | string[] | undefined;

package/dist/schema/plugins.js

@@ -22,6 +22,7 @@ export const pluginsSchema = z.object({
     cspell: pluginSchema,
     cucumber: pluginSchema,
     cypress: pluginSchema,
+    'dependency-cruiser': pluginSchema,
     dotenv: pluginSchema,
     drizzle: pluginSchema,
     eleventy: pluginSchema,

package/dist/types/PluginNames.d.ts

@@ -1,2 +1,2 @@
-export type PluginName = 'angular' | 'astro' | 'ava' | 'babel' | 'c8' | 'capacitor' | 'changesets' | 'commitizen' | 'commitlint' | 'cspell' | 'cucumber' | 'cypress' | 'dotenv' | 'drizzle' | 'eleventy' | 'eslint' | 'expo' | 'gatsby' | 'github-actions' | 'glob' | 'graphql-codegen' | 'husky' | 'jest' | 'karma' | 'ladle' | 'lefthook' | 'lint-staged' | 'linthtml' | 'lockfile-lint' | 'lost-pixel' | 'markdownlint' | 'metro' | 'mocha' | 'moonrepo' | 'msw' | 'nest' | 'netlify' | 'next' | 'node' | 'node-test-runner' | 'nodemon' | 'npm-package-json-lint' | 'nuxt' | 'nx' | 'nyc' | 'oclif' | 'playwright' | 'playwright-ct' | 'playwright-test' | 'plop' | 'postcss' | 'preconstruct' | 'prettier' | 'react-cosmos' | 'release-it' | 'remark' | 'remix' | 'rollup' | 'rsbuild' | 'rspack' | 'semantic-release' | 'sentry' | 'simple-git-hooks' | 'size-limit' | 'storybook' | 'stryker' | 'stylelint' | 'svelte' | 'syncpack' | 'tailwind' | 'travis' | 'ts-node' | 'tsup' | 'tsx' | 'typedoc' | 'typescript' | 'unbuild' | 'unocss' | 'vercel-og' | 'vike' | 'vite' | 'vitest' | 'vue' | 'webdriver-io' | 'webpack' | 'wireit' | 'wrangler' | 'xo' | 'yarn' | 'yorkie';
-export declare const pluginNames: readonly ["angular", "astro", "ava", "babel", "c8", "capacitor", "changesets", "commitizen", "commitlint", "cspell", "cucumber", "cypress", "dotenv", "drizzle", "eleventy", "eslint", "expo", "gatsby", "github-actions", "glob", "graphql-codegen", "husky", "jest", "karma", "ladle", "lefthook", "lint-staged", "linthtml", "lockfile-lint", "lost-pixel", "markdownlint", "metro", "mocha", "moonrepo", "msw", "nest", "netlify", "next", "node", "node-test-runner", "nodemon", "npm-package-json-lint", "nuxt", "nx", "nyc", "oclif", "playwright", "playwright-ct", "playwright-test", "plop", "postcss", "preconstruct", "prettier", "react-cosmos", "release-it", "remark", "remix", "rollup", "rsbuild", "rspack", "semantic-release", "sentry", "simple-git-hooks", "size-limit", "storybook", "stryker", "stylelint", "svelte", "syncpack", "tailwind", "travis", "ts-node", "tsup", "tsx", "typedoc", "typescript", "unbuild", "unocss", "vercel-og", "vike", "vite", "vitest", "vue", "webdriver-io", "webpack", "wireit", "wrangler", "xo", "yarn", "yorkie"];
+export type PluginName = 'angular' | 'astro' | 'ava' | 'babel' | 'c8' | 'capacitor' | 'changesets' | 'commitizen' | 'commitlint' | 'cspell' | 'cucumber' | 'cypress' | 'dependency-cruiser' | 'dotenv' | 'drizzle' | 'eleventy' | 'eslint' | 'expo' | 'gatsby' | 'github-actions' | 'glob' | 'graphql-codegen' | 'husky' | 'jest' | 'karma' | 'ladle' | 'lefthook' | 'lint-staged' | 'linthtml' | 'lockfile-lint' | 'lost-pixel' | 'markdownlint' | 'metro' | 'mocha' | 'moonrepo' | 'msw' | 'nest' | 'netlify' | 'next' | 'node' | 'node-test-runner' | 'nodemon' | 'npm-package-json-lint' | 'nuxt' | 'nx' | 'nyc' | 'oclif' | 'playwright' | 'playwright-ct' | 'playwright-test' | 'plop' | 'postcss' | 'preconstruct' | 'prettier' | 'react-cosmos' | 'release-it' | 'remark' | 'remix' | 'rollup' | 'rsbuild' | 'rspack' | 'semantic-release' | 'sentry' | 'simple-git-hooks' | 'size-limit' | 'storybook' | 'stryker' | 'stylelint' | 'svelte' | 'syncpack' | 'tailwind' | 'travis' | 'ts-node' | 'tsup' | 'tsx' | 'typedoc' | 'typescript' | 'unbuild' | 'unocss' | 'vercel-og' | 'vike' | 'vite' | 'vitest' | 'vue' | 'webdriver-io' | 'webpack' | 'wireit' | 'wrangler' | 'xo' | 'yarn' | 'yorkie';
+export declare const pluginNames: readonly ["angular", "astro", "ava", "babel", "c8", "capacitor", "changesets", "commitizen", "commitlint", "cspell", "cucumber", "cypress", "dependency-cruiser", "dotenv", "drizzle", "eleventy", "eslint", "expo", "gatsby", "github-actions", "glob", "graphql-codegen", "husky", "jest", "karma", "ladle", "lefthook", "lint-staged", "linthtml", "lockfile-lint", "lost-pixel", "markdownlint", "metro", "mocha", "moonrepo", "msw", "nest", "netlify", "next", "node", "node-test-runner", "nodemon", "npm-package-json-lint", "nuxt", "nx", "nyc", "oclif", "playwright", "playwright-ct", "playwright-test", "plop", "postcss", "preconstruct", "prettier", "react-cosmos", "release-it", "remark", "remix", "rollup", "rsbuild", "rspack", "semantic-release", "sentry", "simple-git-hooks", "size-limit", "storybook", "stryker", "stylelint", "svelte", "syncpack", "tailwind", "travis", "ts-node", "tsup", "tsx", "typedoc", "typescript", "unbuild", "unocss", "vercel-og", "vike", "vite", "vitest", "vue", "webdriver-io", "webpack", "wireit", "wrangler", "xo", "yarn", "yorkie"];

package/dist/types/PluginNames.js

@@ -11,6 +11,7 @@ export const pluginNames = [
     'cspell',
     'cucumber',
     'cypress',
+    'dependency-cruiser',
     'dotenv',
     'drizzle',
     'eleventy',

package/dist/types/config.d.ts

@@ -15,7 +15,7 @@ export interface GetInputsFromScriptsOptions extends BaseOptions {
 export type GetInputsFromScripts<T = GetInputsFromScriptsOptions> = (npmScripts: string | string[] | Set<string>, options: T) => Input[];
 export type GetInputsFromScriptsPartial = (npmScripts: string | string[] | Set<string>, options?: Partial<GetInputsFromScriptsOptions>) => Input[];
 type FromArgs = (args: string[]) => Input[];
-interface BinaryResolverOptions extends GetInputsFromScriptsOptions {
+export interface BinaryResolverOptions extends GetInputsFromScriptsOptions {
     fromArgs: FromArgs;
 }
 export type BinaryResolver = (binary: string, args: string[], options: BinaryResolverOptions) => Input[];
@@ -92,7 +92,6 @@ export type ResolveConfig<T = any> = (config: T, options: PluginOptions) => Prom
 export type Resolve = (options: PluginOptions) => Promise<Input[]> | Input[];
 export interface Plugin {
     title: string;
-    note?: string;
     args?: Args;
     packageJsonPath?: string | ((manifest: PackageJson) => string);
     enablers?: IgnorePatterns | string;

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

@@ -5,4 +5,4 @@ export declare const isNotJS: (sourceFile: BoundSourceFile) => boolean;
 export declare const isJS: (sourceFile: BoundSourceFile) => boolean;
 export declare const isModule: (sourceFile: BoundSourceFile) => boolean;
 export declare function getImportsFromPragmas(sourceFile: BoundSourceFile): ImportNode[];
-export declare function hasImportSpecifier(node: ts.Statement, name: string): boolean;
+export declare function hasImportSpecifier(node: ts.Statement, name: string, id?: string): boolean;

package/dist/typescript/visitors/helpers.js

@@ -29,11 +29,11 @@ export function getImportsFromPragmas(sourceFile) {
     }
     return importNodes;
 }
-export function hasImportSpecifier(node, name) {
+export function hasImportSpecifier(node, name, id) {
     return (ts.isImportDeclaration(node) &&
         ts.isStringLiteral(node.moduleSpecifier) &&
         node.moduleSpecifier.text === name &&
         !!node.importClause?.namedBindings &&
         ts.isNamedImports(node.importClause.namedBindings) &&
-        node.importClause.namedBindings.elements.some(element => element.name.text === '$'));
+        (!id || node.importClause.namedBindings.elements.some(element => element.name.text === id)));
 }

package/dist/typescript/visitors/scripts/bun.js

@@ -2,7 +2,7 @@ import ts from 'typescript';
 import { stripQuotes } from '../../ast-helpers.js';
 import { hasImportSpecifier } from '../helpers.js';
 import { scriptVisitor as visit } from '../index.js';
-export default visit(sourceFile => sourceFile.statements.some(node => hasImportSpecifier(node, 'bun')), node => {
+export default visit(sourceFile => sourceFile.statements.some(node => hasImportSpecifier(node, 'bun', '$')), node => {
     if (ts.isTaggedTemplateExpression(node) && node.tag.getText() === '$') {
         return stripQuotes(node.template.getText());
     }

package/dist/typescript/visitors/scripts/execa.js

@@ -2,10 +2,33 @@ import ts from 'typescript';
 import { stripQuotes } from '../../ast-helpers.js';
 import { hasImportSpecifier } from '../helpers.js';
 import { scriptVisitor as visit } from '../index.js';
+const tags = new Set(['$', '$sync']);
+const methods = new Set(['execa', 'execaSync', 'execaCommand', 'execaCommandSync', '$sync']);
 export default visit(sourceFile => sourceFile.statements.some(node => hasImportSpecifier(node, 'execa')), node => {
     if (ts.isTaggedTemplateExpression(node)) {
-        if (node.tag.getText() === '$' || (ts.isCallExpression(node.tag) && node.tag.expression.getText() === '$')) {
+        if (tags.has(node.tag.getText()) || (ts.isCallExpression(node.tag) && tags.has(node.tag.expression.getText()))) {
             return stripQuotes(node.template.getText());
         }
     }
+    if (ts.isCallExpression(node)) {
+        const functionName = node.expression.getText();
+        if (methods.has(functionName)) {
+            if (functionName.startsWith('execaCommand')) {
+                if (node.arguments[0] && ts.isStringLiteral(node.arguments[0])) {
+                    return stripQuotes(node.arguments[0].getText());
+                }
+            }
+            else {
+                const [executable, args] = node.arguments;
+                if (executable && ts.isStringLiteral(executable)) {
+                    const executableStr = stripQuotes(executable.getText());
+                    if (args && ts.isArrayLiteralExpression(args)) {
+                        const argStrings = args.elements.filter(ts.isStringLiteral).map(arg => stripQuotes(arg.getText()));
+                        return [executableStr, ...argStrings].join(' ');
+                    }
+                    return executableStr;
+                }
+            }
+        }
+    }
 });

package/dist/util/get-referenced-inputs.js

@@ -35,7 +35,7 @@ export const getReferencedInputsHandler = (collector, deputy, chief, isGitIgnore
             const isHandled = deputy.maybeAddReferencedExternalDependency(inputWorkspace, packageName);
             if (isWorkspace || isDependency(input)) {
                 if (!isHandled) {
-                    if ((deputy.isProduction && input.production) || !deputy.isProduction) {
+                    if (!input.optional && ((deputy.isProduction && input.production) || !deputy.isProduction)) {
                         collector.addIssue({
                             type: 'unlisted',
                             filePath: containingFilePath,
@@ -47,7 +47,7 @@ export const getReferencedInputsHandler = (collector, deputy, chief, isGitIgnore
                     return;
                 }
                 const ref = _resolveSync(specifier, dirname(containingFilePath));
-                if (ref && !isGitIgnored(ref))
+                if (ref && isInternal(ref) && !isGitIgnored(ref))
                     return ref;
             }
             if (isHandled)
@@ -63,6 +63,8 @@ export const getReferencedInputsHandler = (collector, deputy, chief, isGitIgnore
     if (resolvedFilePath && isInternal(resolvedFilePath)) {
         return isGitIgnored(resolvedFilePath) ? undefined : resolvedFilePath;
     }
+    if (input.optional)
+        return;
     if (!isInternal(filePath)) {
         collector.addIssue({
             type: 'unlisted',

package/dist/util/input.d.ts

@@ -4,6 +4,7 @@ export interface Input {
     type: InputType;
     specifier: string;
     production?: boolean;
+    optional?: boolean;
     dir?: string;
     containingFilePath?: string;
 }
@@ -14,6 +15,7 @@ export interface ConfigInput extends Input {
 }
 type Options = {
     production?: boolean;
+    optional?: boolean;
     dir?: string;
     containingFilePath?: string;
 };
@@ -26,7 +28,7 @@ export declare const toProductionEntry: (specifier: string, options?: Options) =
 export declare const isProductionEntry: (input: Input) => boolean;
 export declare const toConfig: (pluginName: PluginName, specifier: string, containingFilePath: string) => ConfigInput;
 export declare const isConfigPattern: (input: Input) => input is ConfigInput;
-export declare const toDependency: (specifier: string) => Input;
+export declare const toDependency: (specifier: string, options?: Options) => Input;
 export declare const isDependency: (input: Input) => boolean;
 export declare const toProductionDependency: (specifier: string) => Input;
 export declare const toDevDependency: (specifier: string) => Input;

package/dist/util/input.js

@@ -22,7 +22,11 @@ export const toConfig = (pluginName, specifier, containingFilePath) => ({
     containingFilePath,
 });
 export const isConfigPattern = (input) => input.type === 'config';
-export const toDependency = (specifier) => ({ type: 'dependency', specifier });
+export const toDependency = (specifier, options = {}) => ({
+    type: 'dependency',
+    specifier,
+    ...options,
+});
 export const isDependency = (input) => input.type === 'dependency';
 export const toProductionDependency = (specifier) => ({
     type: 'dependency',

package/dist/util/modules.js

@@ -19,7 +19,7 @@ export const getPackageNameFromFilePath = (value) => {
 export const getPackageNameFromSpecifier = (specifier) => isInNodeModules(specifier) ? getPackageNameFromFilePath(specifier) : getPackageNameFromModuleSpecifier(specifier);
 export const isStartsLikePackageName = (specifier) => /^(@[a-z0-9._]|[a-z0-9])/i.test(specifier);
 export const stripVersionFromSpecifier = (specifier) => specifier.replace(/(\S+)@.*/, '$1');
-const stripNodeModulesFromPath = (command) => command.replace(/^(\.\/)?node_modules\//, '');
+const stripNodeModulesFromPath = (command) => command.replace(/(?:\.{0,2}\/)*node_modules\//, '');
 export const extractBinary = (command) => stripVersionFromSpecifier(stripNodeModulesFromPath(command)
     .replace(/^(\.bin\/)/, '')
     .replace(/\$\(npm bin\)\/(\w+)/, '$1'));

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const version = "5.42.0";
+export declare const version = "5.42.1";

package/dist/version.js

@@ -1 +1 @@
-export const version = '5.42.0';
+export const version = '5.42.1';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "knip",
-  "version": "5.42.0",
+  "version": "5.42.1",
   "description": "Find unused files, dependencies and exports in your TypeScript and JavaScript projects",
   "homepage": "https://knip.dev",
   "repository": {
@@ -41,6 +41,7 @@
     "lint": "biome lint ../..",
     "format": "biome format --write .",
     "test": "bun test test/*.test.ts test/**/*.test.ts",
+    "test:watch": "bun test test/*.test.ts test/**/*.test.ts --reporter=junit --reporter-outfile=junit.xml || bun test --watch $(grep -o 'name=\"[^\"]*\".*failures=\"[^0]' junit.xml | grep -v 'name=\"bun test\"' | grep -o 'name=\"[^\"]*\"' | cut -d'\"' -f2)",
     "test:node": "glob -c \"npx -y tsx --test --import ./transform-test.js\" \"test/**/*.test.ts\"",
     "watch": "npm link && tsc --watch",
     "prebuild": "npm run generate-plugin-defs && node rmdir.js dist",
@@ -82,7 +83,7 @@
   "devDependencies": {
     "@jest/types": "^29.6.3",
     "@release-it/bumper": "^7.0.0",
-    "@types/bun": "^1.1.15",
+    "@types/bun": "^1.1.16",
     "@types/js-yaml": "^4.0.9",
     "@types/minimist": "^1.2.5",
     "@types/picomatch": "3.0.1",

package/schema.json

@@ -328,6 +328,10 @@
           "title": "Cypress plugin configuration (https://knip.dev/reference/plugins/cypress)",
           "$ref": "#/definitions/plugin"
         },
+        "dependency-cruiser": {
+          "title": "dependency-cruiser plugin configuration (https://knip.dev/reference/plugins/dependency-cruiser)",
+          "$ref": "#/definitions/plugin"
+        },
         "dotenv": {
           "title": "dotenv plugin configuration (https://knip.dev/reference/plugins/dotenv)",
           "$ref": "#/definitions/plugin"