knip 5.59.1 → 5.60.1

package/dist/ConfigurationChief.d.ts

@@ -1,7 +1,11 @@
+import type { z } from 'zod';
+import { knipConfigurationSchema } from './schema/configuration.js';
 import type { Configuration, IgnorePatterns, WorkspaceConfiguration } from './types/config.js';
+import type { ConfigurationHints } from './types/issues.js';
 import type { PackageJson, WorkspacePackage } from './types/package-json.js';
 import { type WorkspaceGraph } from './util/create-workspace-graph.js';
 import { type CLIArguments } from './util/get-included-issue-types.js';
+export declare const isDefaultPattern: (type: "entry" | "project", id: string) => boolean;
 type ConfigurationManagerOptions = {
     cwd: string;
     isProduction: boolean;
@@ -42,8 +46,10 @@ export declare class ConfigurationChief {
     includedWorkspaces: Workspace[];
     resolvedConfigFilePath?: string;
     rawConfig?: any;
+    parsedConfig?: z.infer<typeof knipConfigurationSchema>;
     constructor({ cwd, isProduction, isStrict, isIncludeEntryExports, workspace }: ConfigurationManagerOptions);
     init(): Promise<void>;
+    getConfigurationHints(): ConfigurationHints;
     private loadResolvedConfigurationFile;
     getRules(): import("./types/issues.js").Rules;
     getFilters(): {

package/dist/ConfigurationChief.js

@@ -19,14 +19,22 @@ import { getKeysByValue } from './util/object.js';
 import { join, relative } from './util/path.js';
 import { normalizePluginConfig } from './util/plugin.js';
 import { toRegexOrString } from './util/regex.js';
+import { ELLIPSIS } from './util/string.js';
 import { splitTags } from './util/tag.js';
 import { unwrapFunction } from './util/unwrap-function.js';
 import { byPathDepth } from './util/workspace.js';
 const { config: rawConfigArg } = parsedArgValues;
+const defaultBaseFilenamePattern = '{index,cli,main}';
+export const isDefaultPattern = (type, id) => {
+    if (type === 'project')
+        return id.startsWith('**/*.{js,mjs,cjs,jsx,ts,tsx,mts,cts');
+    return (id.startsWith('{index,cli,main}.{js,mjs,cjs,jsx,ts,tsx,mts,cts') ||
+        id.startsWith('src/{index,cli,main}.{js,mjs,cjs,jsx,ts,tsx,mts,cts'));
+};
 const getDefaultWorkspaceConfig = (extensions = []) => {
     const exts = [...DEFAULT_EXTENSIONS, ...extensions].map(ext => ext.slice(1)).join(',');
     return {
-        entry: [`{index,cli,main}.{${exts}}!`, `src/{index,cli,main}.{${exts}}!`],
+        entry: [`${defaultBaseFilenamePattern}.{${exts}}!`, `src/${defaultBaseFilenamePattern}.{${exts}}!`],
         project: [`**/*.{${exts}}!`],
     };
 };
@@ -69,6 +77,7 @@ export class ConfigurationChief {
     includedWorkspaces = [];
     resolvedConfigFilePath;
     rawConfig;
+    parsedConfig;
     constructor({ cwd, isProduction, isStrict, isIncludeEntryExports, workspace }) {
         this.cwd = cwd;
         this.isProduction = isProduction;
@@ -101,10 +110,29 @@ export class ConfigurationChief {
         this.rawConfig = this.resolvedConfigFilePath
             ? await this.loadResolvedConfigurationFile(this.resolvedConfigFilePath)
             : manifest.knip;
-        const parsedConfig = this.rawConfig ? knipConfigurationSchema.parse(partitionCompilers(this.rawConfig)) : {};
-        this.config = this.normalize(parsedConfig);
+        this.parsedConfig = this.rawConfig ? knipConfigurationSchema.parse(partitionCompilers(this.rawConfig)) : {};
+        this.config = this.normalize(this.parsedConfig);
         await this.setWorkspaces();
     }
+    getConfigurationHints() {
+        const hints = new Set();
+        const config = this.parsedConfig;
+        if (config) {
+            if (this.workspacePackages.size > 1) {
+                const entry = arrayify(config.entry);
+                if (entry.length > 0) {
+                    const identifier = `[${entry[0]}${entry.length > 1 ? `, ${ELLIPSIS}` : ''}]`;
+                    hints.add({ type: 'entry-top-level', identifier });
+                }
+                const project = arrayify(config.project);
+                if (project.length > 0) {
+                    const identifier = `[${project[0]}${project.length > 1 ? `, ${ELLIPSIS}` : ''}]`;
+                    hints.add({ type: 'project-top-level', identifier });
+                }
+            }
+        }
+        return hints;
+    }
     async loadResolvedConfigurationFile(configPath) {
         const loadedValue = await _load(configPath);
         try {

package/dist/DependencyDeputy.d.ts

@@ -16,7 +16,7 @@ export declare class DependencyDeputy {
     installedBinaries: Map<string, InstalledBinaries>;
     hasTypesIncluded: Map<string, Set<string>>;
     constructor({ isProduction, isStrict }: Options);
-    addWorkspace({ name, cwd, dir, manifestPath, manifestStr, manifest, ignoreDependencies, ignoreBinaries, ignoreUnresolved, }: {
+    addWorkspace({ name, cwd, dir, manifestPath, manifestStr, manifest, ignoreDependencies: id, ignoreBinaries: ib, ignoreUnresolved: iu, }: {
         name: string;
         cwd: string;
         dir: string;
@@ -39,9 +39,9 @@ export declare class DependencyDeputy {
         ignoreDependencies: (string | RegExp)[];
         ignoreBinaries: (string | RegExp)[];
         ignoreUnresolved: (string | RegExp)[];
-        usedIgnoreDependencies: Set<string | RegExp>;
-        usedIgnoreBinaries: Set<string | RegExp>;
-        usedIgnoreUnresolved: Set<string | RegExp>;
+        unusedIgnoreDependencies: Set<string | RegExp>;
+        unusedIgnoreBinaries: Set<string | RegExp>;
+        unusedIgnoreUnresolved: Set<string | RegExp>;
     } | undefined;
     getProductionDependencies(workspaceName: string): DependencyArray;
     getDevDependencies(workspaceName: string): DependencyArray;

package/dist/DependencyDeputy.js

@@ -22,7 +22,7 @@ export class DependencyDeputy {
         this.installedBinaries = new Map();
         this.hasTypesIncluded = new Map();
     }
-    addWorkspace({ name, cwd, dir, manifestPath, manifestStr, manifest, ignoreDependencies, ignoreBinaries, ignoreUnresolved, }) {
+    addWorkspace({ name, cwd, dir, manifestPath, manifestStr, manifest, ignoreDependencies: id, ignoreBinaries: ib, ignoreUnresolved: iu, }) {
         const dependencies = Object.keys(manifest.dependencies ?? {});
         const peerDependencies = Object.keys(manifest.peerDependencies ?? {});
         const optionalDependencies = Object.keys(manifest.optionalDependencies ?? {});
@@ -46,16 +46,19 @@ export class DependencyDeputy {
         this.setHostDependencies(name, hostDependencies);
         this.setInstalledBinaries(name, installedBinaries);
         this.setHasTypesIncluded(name, hasTypesIncluded);
+        const ignoreDependencies = id.map(toRegexOrString);
+        const ignoreBinaries = ib.map(toRegexOrString);
+        const ignoreUnresolved = iu.map(toRegexOrString);
         this._manifests.set(name, {
             workspaceDir: dir,
             manifestPath,
             manifestStr,
-            ignoreDependencies: ignoreDependencies.map(toRegexOrString),
-            ignoreBinaries: ignoreBinaries.map(toRegexOrString),
-            ignoreUnresolved: ignoreUnresolved.map(toRegexOrString),
-            usedIgnoreDependencies: new Set(),
-            usedIgnoreBinaries: new Set(),
-            usedIgnoreUnresolved: new Set(),
+            ignoreDependencies,
+            ignoreBinaries,
+            ignoreUnresolved,
+            unusedIgnoreDependencies: new Set(ignoreDependencies),
+            unusedIgnoreBinaries: new Set(ignoreBinaries),
+            unusedIgnoreUnresolved: new Set(ignoreUnresolved),
             dependencies,
             devDependencies,
             peerDependencies: new Set(peerDependencies),
@@ -241,7 +244,7 @@ export class DependencyDeputy {
                         if (ignoreItem) {
                             delete issueSet[issueKey];
                             counters[type]--;
-                            manifest.usedIgnoreDependencies.add(ignoreItem);
+                            manifest.unusedIgnoreDependencies.delete(ignoreItem);
                         }
                         else if (issue.workspace !== ROOT_WORKSPACE_NAME) {
                             const manifest = this.getWorkspaceManifest(ROOT_WORKSPACE_NAME);
@@ -250,7 +253,7 @@ export class DependencyDeputy {
                                 if (ignoreItem) {
                                     delete issueSet[issueKey];
                                     counters[type]--;
-                                    manifest.usedIgnoreDependencies.add(ignoreItem);
+                                    manifest.unusedIgnoreDependencies.delete(ignoreItem);
                                 }
                             }
                         }
@@ -275,7 +278,7 @@ export class DependencyDeputy {
                     if (ignoreItem) {
                         delete issueSet[issueKey];
                         counters[type]--;
-                        manifest.usedIgnoreBinaries.add(ignoreItem);
+                        manifest.unusedIgnoreBinaries.delete(ignoreItem);
                     }
                     else {
                         const manifest = this.getWorkspaceManifest(ROOT_WORKSPACE_NAME);
@@ -284,7 +287,7 @@ export class DependencyDeputy {
                             if (ignoreItem) {
                                 delete issueSet[issueKey];
                                 counters[type]--;
-                                manifest.usedIgnoreBinaries.add(ignoreItem);
+                                manifest.unusedIgnoreBinaries.delete(ignoreItem);
                             }
                         }
                     }
@@ -303,7 +306,7 @@ export class DependencyDeputy {
                     if (ignoreItem) {
                         delete issueSet[issueKey];
                         counters.unresolved--;
-                        manifest.usedIgnoreUnresolved.add(ignoreItem);
+                        manifest.unusedIgnoreUnresolved.delete(ignoreItem);
                     }
                     else {
                         const manifest = this.getWorkspaceManifest(ROOT_WORKSPACE_NAME);
@@ -312,7 +315,7 @@ export class DependencyDeputy {
                             if (ignoreItem) {
                                 delete issueSet[issueKey];
                                 counters.unresolved--;
-                                manifest.usedIgnoreUnresolved.add(ignoreItem);
+                                manifest.unusedIgnoreUnresolved.delete(ignoreItem);
                             }
                         }
                     }
@@ -332,20 +335,14 @@ export class DependencyDeputy {
     getConfigurationHints() {
         const configurationHints = new Set();
         for (const [workspaceName, manifest] of this._manifests.entries()) {
-            for (const identifier of manifest.ignoreDependencies) {
-                if (!manifest.usedIgnoreDependencies.has(identifier)) {
-                    configurationHints.add({ workspaceName, identifier, type: 'ignoreDependencies' });
-                }
+            for (const identifier of manifest.unusedIgnoreDependencies) {
+                configurationHints.add({ workspaceName, identifier, type: 'ignoreDependencies' });
             }
-            for (const identifier of manifest.ignoreBinaries) {
-                if (!manifest.usedIgnoreBinaries.has(identifier)) {
-                    configurationHints.add({ workspaceName, identifier, type: 'ignoreBinaries' });
-                }
+            for (const identifier of manifest.unusedIgnoreBinaries) {
+                configurationHints.add({ workspaceName, identifier, type: 'ignoreBinaries' });
             }
-            for (const identifier of manifest.ignoreUnresolved) {
-                if (!manifest.usedIgnoreUnresolved.has(identifier)) {
-                    configurationHints.add({ workspaceName, identifier, type: 'ignoreUnresolved' });
-                }
+            for (const identifier of manifest.unusedIgnoreUnresolved) {
+                configurationHints.add({ workspaceName, identifier, type: 'ignoreUnresolved' });
             }
         }
         return configurationHints;

package/dist/WorkspaceWorker.d.ts

@@ -1,7 +1,8 @@
 import { CacheConsultant } from './CacheConsultant.js';
-import type { Workspace } from './ConfigurationChief.js';
+import { type Workspace } from './ConfigurationChief.js';
 import type { PluginName } from './types/PluginNames.js';
 import type { Configuration, GetReferencedInternalFilePath, GetSourceFile, WorkspaceConfiguration } from './types/config.js';
+import type { ConfigurationHints } from './types/issues.js';
 import type { PackageJson } from './types/package-json.js';
 import type { DependencySet } from './types/workspace.js';
 import { type Input } from './util/input.js';
@@ -63,6 +64,7 @@ export declare class WorkspaceWorker {
     private getConfigurationFilePatterns;
     getIgnorePatterns(): string[];
     runPlugins(): Promise<Input[]>;
+    getConfigurationHints(type: 'entry' | 'project', patterns: string[], filePaths: string[], includedPaths: Set<string>): ConfigurationHints;
     onDispose(): void;
 }
 export {};

package/dist/WorkspaceWorker.js

@@ -1,8 +1,11 @@
+import picomatch from 'picomatch';
 import { CacheConsultant } from './CacheConsultant.js';
+import { isDefaultPattern } from './ConfigurationChief.js';
 import { _getInputsFromScripts } from './binaries/index.js';
 import { ROOT_WORKSPACE_NAME } from './constants.js';
 import { getFilteredScripts } from './manifest/helpers.js';
 import { PluginEntries, Plugins } from './plugins.js';
+import { timerify } from './util/Performance.js';
 import { compact } from './util/array.js';
 import { debugLogArray, debugLogObject } from './util/debug.js';
 import { _glob, hasNoProductionSuffix, hasProductionSuffix, negate, prependDirToPattern } from './util/glob.js';
@@ -10,6 +13,7 @@ import { isConfig, toConfig, toDebugString, toEntry, toProductionEntry, } from '
 import { getKeysByValue } from './util/object.js';
 import { basename, dirname, join } from './util/path.js';
 import { loadConfigForPlugin } from './util/plugin.js';
+import { ELLIPSIS } from './util/string.js';
 const nullConfig = { config: null, entry: null, project: null };
 const initEnabledPluginsMap = () => Object.keys(Plugins).reduce((enabled, pluginName) => ({ ...enabled, [pluginName]: false }), {});
 export class WorkspaceWorker {
@@ -50,6 +54,7 @@ export class WorkspaceWorker {
         this.findWorkspaceByFilePath = findWorkspaceByFilePath;
         this.getSourceFile = getSourceFile;
         this.cache = new CacheConsultant({ name: `plugins-${name}`, isEnabled: isCache, cacheLocation, isProduction });
+        this.getConfigurationHints = timerify(this.getConfigurationHints.bind(this), 'worker.getConfigurationHints');
     }
     async init() {
         this.enabledPlugins = await this.determineEnabledPlugins();
@@ -337,6 +342,34 @@ export class WorkspaceWorker {
         debugLogArray(wsName, 'Plugin dependencies', () => compact(inputs.map(toDebugString)));
         return inputs;
     }
+    getConfigurationHints(type, patterns, filePaths, includedPaths) {
+        const hints = new Set();
+        const entries = this.config[type].filter(pattern => !pattern.startsWith('!'));
+        const workspaceName = this.name;
+        const userDefinedPatterns = entries.filter(id => !isDefaultPattern(type, id));
+        if (userDefinedPatterns.length === 0)
+            return hints;
+        if (filePaths.length === 0) {
+            const identifier = `[${entries[0]}${entries.length > 1 ? `, ${ELLIPSIS}` : ''}]`;
+            hints.add({ type: `${type}-empty`, identifier, workspaceName });
+            return hints;
+        }
+        for (const pattern of patterns) {
+            if (pattern.startsWith('!'))
+                continue;
+            const filePathOrPattern = join(this.dir, pattern.replace(/!$/, ''));
+            if (includedPaths.has(filePathOrPattern)) {
+                hints.add({ type: `${type}-redundant`, identifier: pattern, workspaceName });
+            }
+            else {
+                const matcher = picomatch(filePathOrPattern);
+                if (!filePaths.some(filePath => matcher(filePath))) {
+                    hints.add({ type: `${type}-empty`, identifier: pattern, workspaceName });
+                }
+            }
+        }
+        return hints;
+    }
     onDispose() {
         this.cache.reconcile();
     }

package/dist/cli.js

@@ -23,7 +23,7 @@ const isShowProgress = isNoProgress === false && process.stdout.isTTY && typeof
 const workspace = rawWorkspaceArg ? toPosix(rawWorkspaceArg).replace(/^\.\//, '').replace(/\/$/, '') : undefined;
 const run = async () => {
     try {
-        const { report, issues, counters, rules, tagHints, configurationHints, isTreatConfigHintsAsErrors } = await main({
+        const { report, issues, counters, rules, tagHints, configurationHints, isTreatConfigHintsAsErrors, includedWorkspaces, } = await main({
             cacheLocation,
             cwd,
             excludedIssueTypes,
@@ -65,6 +65,7 @@ const run = async () => {
             isShowProgress,
             options: reporterOptions,
             preprocessorOptions,
+            includedWorkspaces,
         };
         const finalData = await runPreprocessors(preprocessor, initialData);
         await runReporters(reporter, finalData);

package/dist/graph/analyze.js

@@ -45,7 +45,7 @@ export const analyze = async (options) => {
                             const { isReferenced, reExportingEntryFile, traceNode } = isIdentifierReferenced(filePath, identifier, isIncludeEntryExports);
                             if ((isReferenced || exportedItem.refs[1]) && isIgnored) {
                                 for (const tagName of exportedItem.jsDocTags) {
-                                    if (tags[1].includes(tagName.replace(/^\@/, ''))) {
+                                    if (tags[1].includes(tagName.replace(/^@/, ''))) {
                                         collector.addTagHint({ type: 'tag', filePath, identifier, tagName });
                                     }
                                 }
@@ -96,7 +96,7 @@ export const analyze = async (options) => {
                                             }
                                             else if (isIgnored) {
                                                 for (const tagName of exportedItem.jsDocTags) {
-                                                    if (tags[1].includes(tagName.replace(/^\@/, ''))) {
+                                                    if (tags[1].includes(tagName.replace(/^@/, ''))) {
                                                         collector.addTagHint({ type: 'tag', filePath, identifier: id, tagName });
                                                     }
                                                 }
@@ -110,7 +110,7 @@ export const analyze = async (options) => {
                                         if (shouldIgnoreTags(member.jsDocTags)) {
                                             const identifier = `${exportedItem.identifier}.${member.identifier}`;
                                             for (const tagName of exportedItem.jsDocTags) {
-                                                if (tags[1].includes(tagName.replace(/^\@/, ''))) {
+                                                if (tags[1].includes(tagName.replace(/^@/, ''))) {
                                                     collector.addTagHint({ type: 'tag', filePath, identifier, tagName });
                                                 }
                                             }

package/dist/graph/build.js

@@ -179,12 +179,6 @@ export async function build({ cacheLocation, chief, collector, cwd, deputy, fact
             }
         }
         else {
-            {
-                const label = 'entry paths';
-                const patterns = worker.getEntryFilePatterns();
-                const workspaceEntryPaths = await _glob({ ...sharedGlobOptions, patterns, gitignore: false, label });
-                principal.addEntryPaths(workspaceEntryPaths);
-            }
             {
                 const label = 'entry paths from plugins (skip exports analysis)';
                 const patterns = worker.getPluginEntryFilePatterns([
@@ -201,11 +195,13 @@ export async function build({ cacheLocation, chief, collector, cwd, deputy, fact
                 principal.addEntryPaths(pluginWorkspaceEntryPaths);
             }
             {
-                const label = 'project paths';
-                const patterns = worker.getProjectFilePatterns([...productionPatternsSkipExports, ...projectFilePatterns]);
-                const workspaceProjectPaths = await _glob({ ...sharedGlobOptions, patterns, label });
-                for (const projectPath of workspaceProjectPaths)
-                    principal.addProjectPath(projectPath);
+                const label = 'entry paths';
+                const patterns = worker.getEntryFilePatterns();
+                const entryPaths = await _glob({ ...sharedGlobOptions, patterns, gitignore: false, label });
+                const hints = worker.getConfigurationHints('entry', patterns, entryPaths, principal.entryPaths);
+                for (const hint of hints)
+                    collector.addConfigurationHint(hint);
+                principal.addEntryPaths(entryPaths);
             }
             {
                 const label = 'project paths from plugins';
@@ -220,6 +216,16 @@ export async function build({ cacheLocation, chief, collector, cwd, deputy, fact
                 const configurationEntryPaths = await _glob({ ...sharedGlobOptions, patterns, label });
                 principal.addEntryPaths(configurationEntryPaths, { skipExportsAnalysis: true });
             }
+            {
+                const label = 'project paths';
+                const patterns = worker.getProjectFilePatterns([...productionPatternsSkipExports, ...projectFilePatterns]);
+                const projectPaths = await _glob({ ...sharedGlobOptions, patterns, label });
+                const hints = worker.getConfigurationHints('project', config.project, projectPaths, principal.projectPaths);
+                for (const hint of hints)
+                    collector.addConfigurationHint(hint);
+                for (const projectPath of projectPaths)
+                    principal.addProjectPath(projectPath);
+            }
         }
         if (chief.resolvedConfigFilePath) {
             principal.addEntryPath(chief.resolvedConfigFilePath, { skipExportsAnalysis: true });

package/dist/index.d.ts

@@ -9,4 +9,5 @@ export declare const main: (unresolvedConfiguration: CommandLineOptions) => Prom
     tagHints: Set<import("./types/issues.js").TagHint>;
     configurationHints: Set<import("./types/issues.js").ConfigurationHint>;
     isTreatConfigHintsAsErrors: boolean;
+    includedWorkspaces: import("./ConfigurationChief.js").Workspace[];
 }>;

package/dist/index.js

@@ -81,6 +81,8 @@ export const main = async (unresolvedConfiguration) => {
         unreferencedFiles,
     });
     const { issues, counters, tagHints, configurationHints } = collector.getIssues();
+    for (const hint of chief.getConfigurationHints())
+        collector.addConfigurationHint(hint);
     if (isWatch) {
         const isIgnored = (filePath) => filePath.startsWith(cacheLocation) || filePath.includes('/.git/') || isGitIgnored(filePath);
         const watchHandler = await getWatchHandler({
@@ -122,5 +124,6 @@ export const main = async (unresolvedConfiguration) => {
         tagHints,
         configurationHints,
         isTreatConfigHintsAsErrors: chief.config.isTreatConfigHintsAsErrors,
+        includedWorkspaces: chief.includedWorkspaces,
     };
 };

package/dist/plugins/eleventy/helpers.d.ts

@@ -74,6 +74,14 @@ export declare class DummyEleventyConfig {
     setDataFileSuffixes(): void;
     setDataFileBaseName(): void;
     getMergingConfigObject(): void;
+    isVirtualTemplate(): void;
+    setInputDirectory(): void;
+    setOutputDirectory(): void;
+    setDataDirectory(): void;
+    setIncludesDirectory(): void;
+    setLayoutsDirectory(): void;
+    setFreezeReservedData(): void;
+    addDateParsing(): void;
     _uniqueId: {};
     events: {};
     benchmarkManager: {};

package/dist/plugins/eleventy/helpers.js

@@ -83,6 +83,14 @@ export class DummyEleventyConfig {
     setDataFileSuffixes() { }
     setDataFileBaseName() { }
     getMergingConfigObject() { }
+    isVirtualTemplate() { }
+    setInputDirectory() { }
+    setOutputDirectory() { }
+    setDataDirectory() { }
+    setIncludesDirectory() { }
+    setLayoutsDirectory() { }
+    setFreezeReservedData() { }
+    addDateParsing() { }
     _uniqueId = {};
     events = {};
     benchmarkManager = {};

package/dist/plugins/eleventy/index.js

@@ -16,7 +16,7 @@ const resolveConfig = async (localConfig, options) => {
         localConfig = (await localConfig(dummyUserConfig));
     const inputDir = localConfig?.dir?.input || defaultEleventyConfig.dir.input;
     const dataDir = localConfig?.dir?.data || defaultEleventyConfig.dir.data;
-    const templateFormats = localConfig.templateFormats || defaultEleventyConfig.templateFormats;
+    const templateFormats = localConfig?.templateFormats || defaultEleventyConfig.templateFormats;
     const exts = DEFAULT_EXTENSIONS.map(extname => extname.slice(1)).join(',');
     const copiedEntries = new Set();
     const copiedPackages = new Set();

package/dist/plugins/index.d.ts

@@ -394,6 +394,7 @@ export declare const Plugins: {
             positional: boolean;
             nodeImportArgs: boolean;
             resolve: string[];
+            boolean: string[];
             args: (args: string[]) => string[];
         };
     };

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

@@ -10,6 +10,7 @@ declare const _default: {
         positional: boolean;
         nodeImportArgs: boolean;
         resolve: string[];
+        boolean: string[];
         args: (args: string[]) => string[];
     };
 };

package/dist/plugins/node/index.js

@@ -16,6 +16,7 @@ const args = {
     positional: true,
     nodeImportArgs: true,
     resolve: ['test-reporter'],
+    boolean: ['deprecation', 'experimental-strip-types', 'harmony', 'test-only', 'test', 'warnings', 'watch'],
     args: (args) => args.filter(arg => !/--test-reporter[= ](spec|tap|dot|junit|lcov)/.test(arg)),
 };
 export default {

package/dist/plugins/storybook/index.js

@@ -4,11 +4,11 @@ import { hasDependency } from '../../util/plugin.js';
 const title = 'Storybook';
 const enablers = [/^@storybook\//, '@nrwl/storybook'];
 const isEnabled = ({ dependencies }) => hasDependency(dependencies, enablers);
-const config = ['.storybook/{main,test-runner}.{js,ts,mts}'];
+const config = ['.{storybook,rnstorybook}/{main,test-runner}.{js,ts,mts}'];
 const stories = ['**/*.@(mdx|stories.@(mdx|js|jsx|mjs|ts|tsx))'];
-const restEntry = ['.storybook/{manager,preview}.{js,jsx,ts,tsx}'];
+const restEntry = ['.{storybook,rnstorybook}/{manager,preview,index,vitest.setup}.{js,jsx,ts,tsx}'];
 const entry = [...restEntry, ...stories];
-const project = ['.storybook/**/*.{js,jsx,ts,tsx,mts}'];
+const project = ['.{storybook,rnstorybook}/**/*.{js,jsx,ts,tsx,mts}'];
 const resolveConfig = async (localConfig, options) => {
     const { cwd, configFileDir } = options;
     const strs = typeof localConfig?.stories === 'function' ? await localConfig.stories(stories) : localConfig?.stories;

package/dist/reporters/codeclimate.js

@@ -1,7 +1,7 @@
 import { createHash } from 'node:crypto';
 import { ISSUE_TYPE_TITLE } from '../constants.js';
 import { toRelative } from '../util/path.js';
-import { getIssueTypeTitle } from './util.js';
+import { getIssueTypeTitle } from './util/util.js';
 export default async ({ report, issues }) => {
     const entries = [];
     for (const [type, isReportType] of Object.entries(report)) {

package/dist/reporters/codeowners.js

@@ -1,6 +1,6 @@
 import { createOwnershipEngine } from '../util/codeowners.js';
 import { relative, resolve } from '../util/path.js';
-import { getColoredTitle, getIssueLine, getIssueTypeTitle } from './util.js';
+import { getColoredTitle, getIssueLine, getIssueTypeTitle } from './util/util.js';
 const logIssueRecord = (issues) => {
     const sortedByFilePath = issues.sort((a, b) => (a.owner < b.owner ? -1 : 1));
     for (const { filePath, symbols, owner, parentSymbol } of sortedByFilePath) {

package/dist/reporters/compact.js

@@ -1,5 +1,5 @@
 import { toRelative } from '../util/path.js';
-import { getColoredTitle, getIssueLine, getIssueTypeTitle } from './util.js';
+import { getColoredTitle, getIssueLine, getIssueTypeTitle } from './util/util.js';
 const logIssueSet = (issues) => {
     for (const filePath of issues.sort())
         console.log(toRelative(filePath));

package/dist/reporters/disclosure.js

@@ -1,4 +1,4 @@
-import { getIssueTypeTitle, getTableForType } from './util.js';
+import { getIssueTypeTitle, getTableForType } from './util/util.js';
 export default ({ report, issues }) => {
     const reportMultipleGroups = Object.values(report).filter(Boolean).length > 1;
     for (let [reportType, isReportType] of Object.entries(report)) {

package/dist/reporters/index.d.ts

@@ -1,5 +1,5 @@
 declare const _default: {
-    symbols: ({ report, issues, tagHints, configurationHints, isDisableConfigHints, isTreatConfigHintsAsErrors, isShowProgress, }: import("../index.js").ReporterOptions) => void;
+    symbols: (options: import("../index.js").ReporterOptions) => void;
     compact: ({ report, issues, isShowProgress }: import("../index.js").ReporterOptions) => void;
     codeowners: ({ report, issues, isShowProgress, options }: import("../index.js").ReporterOptions) => void;
     disclosure: ({ report, issues }: import("../index.js").ReporterOptions) => void;

package/dist/reporters/json.js

@@ -1,7 +1,7 @@
 import { createOwnershipEngine } from '../util/codeowners.js';
 import { isFile } from '../util/fs.js';
 import { relative, resolve } from '../util/path.js';
-import { convert } from './util.js';
+import { convert } from './util/util.js';
 export default async ({ report, issues, options }) => {
     let opts = {};
     try {

package/dist/reporters/markdown.js

@@ -1,5 +1,5 @@
 import { relative, toRelative } from '../util/path.js';
-import { getIssueTypeTitle } from './util.js';
+import { getIssueTypeTitle } from './util/util.js';
 export default ({ report, issues }) => {
     console.log('# Knip report\n');
     const getFilePath = (issue) => {

package/dist/reporters/symbols.d.ts

@@ -1,3 +1,3 @@
 import type { ReporterOptions } from '../types/issues.js';
-declare const _default: ({ report, issues, tagHints, configurationHints, isDisableConfigHints, isTreatConfigHintsAsErrors, isShowProgress, }: ReporterOptions) => void;
+declare const _default: (options: ReporterOptions) => void;
 export default _default;

package/dist/reporters/symbols.js

@@ -1,7 +1,7 @@
-import { ROOT_WORKSPACE_NAME } from '../constants.js';
-import { toRelative } from '../util/path.js';
-import { dim, getColoredTitle, getDimmedTitle, getIssueTypeTitle, getTableForType, plain } from './util.js';
-export default ({ report, issues, tagHints, configurationHints, isDisableConfigHints, isTreatConfigHintsAsErrors, isShowProgress, }) => {
+import { printConfigurationHints } from './util/configuration-hints.js';
+import { getColoredTitle, getIssueTypeTitle, getTableForType } from './util/util.js';
+export default (options) => {
+    const { report, issues, isDisableConfigHints, isShowProgress } = options;
     const reportMultipleGroups = Object.values(report).filter(Boolean).length > 1;
     let totalIssues = 0;
     for (let [reportType, isReportType] of Object.entries(report)) {
@@ -18,25 +18,7 @@ export default ({ report, issues, tagHints, configurationHints, isDisableConfigH
         }
     }
     if (!isDisableConfigHints) {
-        if (configurationHints.size > 0) {
-            const getTitle = isTreatConfigHintsAsErrors ? getColoredTitle : getDimmedTitle;
-            console.log(getTitle('Configuration hints', configurationHints.size));
-            const style = isTreatConfigHintsAsErrors ? plain : dim;
-            for (const hint of configurationHints) {
-                const { type, workspaceName, identifier } = hint;
-                const message = `Unused item in ${type}`;
-                const workspace = workspaceName && workspaceName !== ROOT_WORKSPACE_NAME ? ` (workspace: ${workspaceName})` : '';
-                console.warn(style(`${message}${workspace}:`), identifier);
-            }
-        }
-        if (tagHints.size > 0) {
-            console.log(getColoredTitle('Tag issues', tagHints.size));
-            for (const hint of tagHints) {
-                const { filePath, identifier, tagName } = hint;
-                const message = `Unused tag in ${toRelative(filePath)}:`;
-                console.warn(dim(message), `${identifier} → ${tagName}`);
-            }
-        }
+        printConfigurationHints(options);
     }
     if (totalIssues === 0 && isShowProgress) {
         console.log('✂️  Excellent, Knip found no issues.');

package/dist/reporters/util/configuration-hints.d.ts

@@ -0,0 +1,2 @@
+import type { ReporterOptions } from '../../types/issues.js';
+export declare const printConfigurationHints: ({ counters, issues, tagHints, configurationHints, isTreatConfigHintsAsErrors, includedWorkspaces, }: ReporterOptions) => void;

package/dist/reporters/util/configuration-hints.js

@@ -0,0 +1,62 @@
+import { toRelative } from '../../util/path.js';
+import { byPathDepth } from '../../util/workspace.js';
+import { bright, dim, getColoredTitle, getDimmedTitle, plain, yellow } from './util.js';
+const id = (id) => bright(id.toString() + (id === '.' ? ' (root)' : ''));
+const type = (id) => yellow(id.split('-').at(0));
+const workspace = ({ isRootOnly, workspaceName: id }) => isRootOnly ? '' : id === '.' ? ` in root ${yellow('"."')} workspace` : ` in ${yellow(id ?? '.')}`;
+const unused = (options) => `Remove from ${type(options.type)}${options.workspaceName === '.' ? '' : `${workspace(options)}`}: ${id(options.identifier)}`;
+const empty = (options) => `Refine ${type(options.type)}${workspace(options)}: ${id(options.identifier)} (no files found)`;
+const remove = (options) => `Remove ${type(options.type)}${workspace(options)}: ${id(options.identifier)}`;
+const add = (options) => `Add to or refine in ${yellow('workspaces')}: ${id(options.identifier)} (${options.size} unused files)`;
+const topLevel = (options) => `Remove or move unused top-level ${type(options.type)} to ${yellow('"."')}: ${id(options.identifier)}`;
+const hintPrinters = new Map([
+    ['ignoreBinaries', { print: unused }],
+    ['ignoreDependencies', { print: unused }],
+    ['ignoreUnresolved', { print: unused }],
+    ['ignoreWorkspaces', { print: unused }],
+    ['entry-empty', { print: empty }],
+    ['project-empty', { print: empty }],
+    ['entry-redundant', { print: remove }],
+    ['project-redundant', { print: remove }],
+    ['workspace-unconfigured', { print: add }],
+    ['entry-top-level', { print: topLevel }],
+    ['project-top-level', { print: topLevel }],
+]);
+export const printConfigurationHints = ({ counters, issues, tagHints, configurationHints, isTreatConfigHintsAsErrors, includedWorkspaces, }) => {
+    if (counters.files > 20) {
+        const workspaces = includedWorkspaces
+            .map(workspace => workspace.dir)
+            .sort(byPathDepth)
+            .reverse()
+            .map(dir => ({ dir, size: 0 }));
+        for (const filePath of issues.files) {
+            const workspace = workspaces.find(ws => filePath.startsWith(ws.dir));
+            if (workspace)
+                workspace.size++;
+        }
+        const hlWorkspaces = workspaces.sort((a, b) => b.size - a.size).filter(ws => ws.size > 1);
+        for (const { dir, size } of hlWorkspaces) {
+            const identifier = toRelative(dir) || '.';
+            configurationHints.add({ type: 'workspace-unconfigured', workspaceName: identifier, identifier, size });
+        }
+    }
+    if (configurationHints.size > 0) {
+        const getTitle = isTreatConfigHintsAsErrors ? getColoredTitle : getDimmedTitle;
+        const style = isTreatConfigHintsAsErrors ? plain : dim;
+        console.log(getTitle('Configuration hints', configurationHints.size));
+        const isRootOnly = includedWorkspaces.length === 1 && includedWorkspaces[0].name === '.';
+        for (const hint of configurationHints) {
+            const hintPrinter = hintPrinters.get(hint.type);
+            if (hintPrinter)
+                console.warn(style(hintPrinter.print({ ...hint, isRootOnly })));
+        }
+    }
+    if (tagHints.size > 0) {
+        console.log(getColoredTitle('Tag issues', tagHints.size));
+        for (const hint of tagHints) {
+            const { filePath, identifier, tagName } = hint;
+            const message = `Unused tag in ${toRelative(filePath)}:`;
+            console.warn(dim(message), `${identifier} → ${tagName}`);
+        }
+    }
+};

package/dist/reporters/{util.d.ts → util/util.d.ts}

@@ -1,8 +1,10 @@
-import { ISSUE_TYPE_TITLE } from '../constants.js';
-import { type Issue, type IssueSeverity, type IssueSymbol } from '../types/issues.js';
-import { Table } from '../util/table.js';
+import { ISSUE_TYPE_TITLE } from '../../constants.js';
+import { type Issue, type IssueSeverity, type IssueSymbol } from '../../types/issues.js';
+import { Table } from '../../util/table.js';
 export declare const plain: (text: string) => string;
 export declare const dim: import("picocolors/types.js").Formatter;
+export declare const bright: import("picocolors/types.js").Formatter;
+export declare const yellow: import("picocolors/types.js").Formatter;
 export declare const getIssueTypeTitle: (reportType: keyof typeof ISSUE_TYPE_TITLE) => string;
 export declare const getColoredTitle: (title: string, count: number) => string;
 export declare const getDimmedTitle: (title: string, count: number) => string;

package/dist/reporters/{util.js → util/util.js}

@@ -1,14 +1,15 @@
 import picocolors from 'picocolors';
-import { ISSUE_TYPE_TITLE } from '../constants.js';
-import { SymbolType } from '../types/issues.js';
-import { relative } from '../util/path.js';
-import { Table } from '../util/table.js';
+import { ISSUE_TYPE_TITLE } from '../../constants.js';
+import { SymbolType } from '../../types/issues.js';
+import { relative } from '../../util/path.js';
+import { Table } from '../../util/table.js';
 export const plain = (text) => text;
 export const dim = picocolors.gray;
-const bright = picocolors.whiteBright;
+export const bright = picocolors.whiteBright;
+export const yellow = picocolors.yellow;
 export const getIssueTypeTitle = (reportType) => ISSUE_TYPE_TITLE[reportType];
 export const getColoredTitle = (title, count) => `${picocolors.yellowBright(picocolors.underline(title))} (${count})`;
-export const getDimmedTitle = (title, count) => `${picocolors.yellow(`${picocolors.underline(title)} (${count})`)}`;
+export const getDimmedTitle = (title, count) => `${yellow(`${picocolors.underline(title)} (${count})`)}`;
 export const getIssueLine = ({ owner, filePath, symbols, parentSymbol, severity }) => {
     const symbol = symbols ? `: ${symbols.map(s => s.symbol).join(', ')}` : '';
     const parent = parentSymbol ? ` (${parentSymbol})` : '';

package/dist/reporters/watch.js

@@ -1,7 +1,7 @@
 import picocolors from 'picocolors';
 import { perfObserver } from '../util/Performance.js';
 import { prettyMilliseconds } from '../util/string.js';
-import { getIssueTypeTitle, getTableForType } from './util.js';
+import { getIssueTypeTitle, getTableForType } from './util/util.js';
 export default ({ report, issues, streamer, startTime, size, isDebug }) => {
     const reportMultipleGroups = Object.values(report).filter(Boolean).length > 1;
     let totalIssues = 0;

package/dist/types/issues.d.ts

@@ -1,3 +1,4 @@
+import type { Workspace } from '../ConfigurationChief.js';
 export declare enum SymbolType {
     VARIABLE = "variable",
     TYPE = "type",
@@ -67,16 +68,19 @@ export type ReporterOptions = {
     isShowProgress: boolean;
     options: string;
     preprocessorOptions: string;
+    includedWorkspaces: Workspace[];
 };
 export type Reporter = (options: ReporterOptions) => void;
 export type Preprocessor = (options: ReporterOptions) => ReporterOptions;
 export type IssueSeverity = 'error' | 'warn' | 'off';
 export type Rules = Record<IssueType, IssueSeverity>;
 export type ConfigurationHints = Set<ConfigurationHint>;
+export type ConfigurationHintType = 'ignoreBinaries' | 'ignoreDependencies' | 'ignoreUnresolved' | 'ignoreWorkspaces' | 'entry-redundant' | 'project-redundant' | 'entry-top-level' | 'project-top-level' | 'entry-empty' | 'project-empty' | 'workspace-unconfigured';
 export type ConfigurationHint = {
-    type: 'ignoreBinaries' | 'ignoreDependencies' | 'ignoreUnresolved' | 'ignoreWorkspaces';
+    type: ConfigurationHintType;
     identifier: string | RegExp;
     workspaceName?: string;
+    size?: number;
 };
 type TagHints = Set<TagHint>;
 export type TagHint = {

package/dist/types/workspace.d.ts

@@ -12,9 +12,9 @@ type WorkspaceManifest = {
     ignoreDependencies: (string | RegExp)[];
     ignoreBinaries: (string | RegExp)[];
     ignoreUnresolved: (string | RegExp)[];
-    usedIgnoreDependencies: Set<string | RegExp>;
-    usedIgnoreBinaries: Set<string | RegExp>;
-    usedIgnoreUnresolved: Set<string | RegExp>;
+    unusedIgnoreDependencies: Set<string | RegExp>;
+    unusedIgnoreBinaries: Set<string | RegExp>;
+    unusedIgnoreUnresolved: Set<string | RegExp>;
 };
 export type WorkspaceManifests = Map<string, WorkspaceManifest>;
 export type HostDependencies = Map<string, Array<{

package/dist/util/regex.d.ts

@@ -1,3 +1,3 @@
 export declare const toRegexOrString: (value: string | RegExp) => string | RegExp;
-export declare const findMatch: (haystack: undefined | (string | RegExp)[], needle: string) => string | RegExp | undefined;
+export declare const findMatch: (haystack: (string | RegExp)[], needle: string) => string | RegExp | undefined;
 export declare const isIdChar: (text: string) => boolean;

package/dist/util/regex.js

@@ -1,6 +1,6 @@
 const isRegexLikeMatch = /[*+\\(|{^$]/;
 const isRegexLike = (value) => isRegexLikeMatch.test(value);
 export const toRegexOrString = (value) => typeof value === 'string' && isRegexLike(value) ? new RegExp(value) : value;
-export const findMatch = (haystack, needle) => haystack?.find(n => (typeof n === 'string' ? n === needle : n.test(needle)));
+export const findMatch = (haystack, needle) => haystack.find(n => (typeof n === 'string' ? n === needle : n.test(needle)));
 const idCharMatch = /[a-zA-Z0-9$_]/;
 export const isIdChar = (text) => idCharMatch.test(text);

package/dist/util/string.d.ts

@@ -1,3 +1,4 @@
+export declare const ELLIPSIS = "\u2026";
 export declare const truncate: (text: string, width: number) => string;
 export declare const truncateStart: (text: string, width: number) => string;
 export declare const pad: (text: string, width: number, fillString?: string, align?: "left" | "center" | "right") => string;

package/dist/util/string.js

@@ -1,6 +1,6 @@
 import { stripVTControlCharacters } from 'node:util';
 const CONTROL_CHARACTERS = /\u001b\[[0-9;]+m/g;
-const ELLIPSIS = '…';
+export const ELLIPSIS = '…';
 const getTruncatedParts = (input, limit, fromStart) => {
     const parts = [];
     let width = 0;

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const version = "5.59.1";
+export declare const version = "5.60.1";

package/dist/version.js

@@ -1 +1 @@
-export const version = '5.59.1';
+export const version = '5.60.1';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "knip",
-  "version": "5.59.1",
+  "version": "5.60.1",
   "description": "Find and fix unused dependencies, exports and files in your TypeScript and JavaScript projects",
   "homepage": "https://knip.dev",
   "repository": {
@@ -63,15 +63,15 @@
   "dependencies": {
     "@nodelib/fs.walk": "^1.2.3",
     "fast-glob": "^3.3.3",
-    "formatly": "^0.2.3",
+    "formatly": "^0.2.4",
     "jiti": "^2.4.2",
     "js-yaml": "^4.1.0",
     "minimist": "^1.2.8",
-    "oxc-resolver": "^9.0.2",
-    "picocolors": "^1.1.0",
+    "oxc-resolver": "^11.1.0",
+    "picocolors": "^1.1.1",
     "picomatch": "^4.0.1",
-    "smol-toml": "^1.3.1",
-    "strip-json-comments": "5.0.1",
+    "smol-toml": "^1.3.4",
+    "strip-json-comments": "5.0.2",
     "zod": "^3.22.4",
     "zod-validation-error": "^3.0.3"
   },
@@ -81,16 +81,16 @@
   },
   "devDependencies": {
     "@jest/types": "^29.6.3",
-    "@release-it/bumper": "^7.0.2",
-    "@types/bun": "1.2.4",
+    "@release-it/bumper": "^7.0.5",
+    "@types/bun": "1.2.15",
     "@types/js-yaml": "^4.0.9",
     "@types/minimist": "^1.2.5",
     "@types/picomatch": "3.0.1",
     "@types/webpack": "^5.28.5",
-    "@wdio/types": "^9.5.0",
+    "@wdio/types": "^9.15.0",
     "codeclimate-types": "^0.3.1",
     "glob": "^11.0.2",
-    "release-it": "^19.0.1",
+    "release-it": "^19.0.3",
     "tsx": "^4.19.4",
     "type-fest": "^4.31.0",
     "typescript": "^5.5.2"