knip 3.0.1 → 3.1.0

package/README.md

@@ -14,6 +14,6 @@ Special thanks to the wonderful people who have contributed to this project:
 [![Contributors][4]][3]
 
 [1]: https://knip.dev
-[2]: https://www.npmjs.com/package/knip
+[2]: https://github.com/webpro/knip
 [3]: https://github.com/webpro/knip/graphs/contributors
 [4]: https://contrib.rocks/image?repo=webpro/knip

package/dist/ConfigurationChief.d.ts

@@ -59,6 +59,7 @@ export declare class ConfigurationChief {
     private getAdditionalWorkspaceNames;
     private getAvailableWorkspaceNames;
     private getAvailableWorkspaceManifests;
+    private getAvailableWorkspacePkgNames;
     private getEnabledWorkspaces;
     getWorkspaces(): Workspace[];
     private getDescendentWorkspaces;

package/dist/ConfigurationChief.js

@@ -170,7 +170,7 @@ export class ConfigurationChief {
             .reverse()
             .map(dir => join(this.cwd, dir));
         this.availableWorkspaceManifests = this.getAvailableWorkspaceManifests(this.availableWorkspaceDirs);
-        this.availableWorkspacePkgNames = new Set(this.availableWorkspaceManifests.map(w => w.manifest.name));
+        this.availableWorkspacePkgNames = this.getAvailableWorkspacePkgNames(this.availableWorkspaceManifests);
         this.workspacesGraph = createPkgGraph(this.availableWorkspaceManifests);
         this.enabledWorkspaces = this.getEnabledWorkspaces();
     }
@@ -225,6 +225,17 @@ export class ConfigurationChief {
             return { dir, manifest };
         });
     }
+    getAvailableWorkspacePkgNames(availableWorkspaceManifests) {
+        const pkgNames = new Set();
+        for (const { dir, manifest } of availableWorkspaceManifests) {
+            if (!manifest.name)
+                throw new ConfigurationError(`Missing package name in ${join(dir, 'package.json')}`);
+            if (pkgNames.has(manifest.name))
+                throw new ConfigurationError(`Duplicate package name: ${manifest.name}`);
+            pkgNames.add(manifest.name);
+        }
+        return pkgNames;
+    }
     getEnabledWorkspaces() {
         if (workspaceArg && !existsSync(workspaceArg)) {
             throw new ConfigurationError(`Directory does not exist: ${workspaceArg}`);

package/dist/PrincipalFactory.d.ts

@@ -17,6 +17,7 @@ export type PrincipalOptions = {
     compilers: [SyncCompilers, AsyncCompilers];
     pkgName: string;
     isGitIgnored: GlobbyFilterFunction;
+    isIsolateWorkspaces: boolean;
 };
 export declare class PrincipalFactory {
     principals: Principals;

package/dist/PrincipalFactory.js

@@ -16,10 +16,10 @@ const mergePaths = (cwd, compilerOptions, paths = {}) => {
 export class PrincipalFactory {
     principals = new Set();
     getPrincipal(options) {
-        const { cwd, compilerOptions, paths, pkgName } = options;
+        const { cwd, compilerOptions, paths, pkgName, isIsolateWorkspaces } = options;
         options.compilerOptions = mergePaths(cwd, compilerOptions, paths);
         const principal = this.findReusablePrincipal(compilerOptions);
-        if (principal) {
+        if (!isIsolateWorkspaces && principal) {
             this.linkPrincipal(principal, cwd, compilerOptions, pkgName);
             return principal.principal;
         }

package/dist/ProjectPrincipal.js

@@ -11,16 +11,19 @@ import { dirname, extname, isInNodeModules, join } from './util/path.js';
 import { timerify } from './util/Performance.js';
 const baseCompilerOptions = {
     allowJs: true,
-    jsx: ts.JsxEmit.Preserve,
-    jsxImportSource: undefined,
     allowSyntheticDefaultImports: true,
+    declaration: false,
+    declarationMap: false,
     esModuleInterop: true,
+    inlineSourceMap: false,
+    inlineSources: false,
+    jsx: ts.JsxEmit.Preserve,
+    jsxImportSource: undefined,
+    lib: [],
+    noEmit: true,
     skipDefaultLibCheck: true,
     skipLibCheck: true,
-    lib: [],
-    target: ts.ScriptTarget.Latest,
-    module: ts.ModuleKind.CommonJS,
-    moduleResolution: ts.ModuleResolutionKind.NodeNext,
+    sourceMap: false,
 };
 const tsCreateProgram = timerify(ts.createProgram);
 export class ProjectPrincipal {

package/dist/WorkspaceWorker.js

@@ -89,16 +89,18 @@ export class WorkspaceWorker {
         const { entry } = this.config;
         if (entry.length === 0)
             return [];
-        return [entry, this.negatedWorkspacePatterns].flat();
+        const excludeProductionNegations = entry.filter(pattern => !(pattern.startsWith('!') && pattern.endsWith('!')));
+        return [excludeProductionNegations, this.negatedWorkspacePatterns].flat();
     }
     getProjectFilePatterns(testFilePatterns) {
         const { project } = this.config;
         if (project.length === 0)
             return [];
+        const excludeProductionNegations = project.filter(pattern => !(pattern.startsWith('!') && pattern.endsWith('!')));
         const negatedPluginConfigPatterns = this.getPluginConfigPatterns().map(negate);
         const negatedPluginProjectFilePatterns = this.getPluginProjectFilePatterns().map(negate);
         return [
-            project,
+            excludeProductionNegations,
             negatedPluginConfigPatterns,
             negatedPluginProjectFilePatterns,
             testFilePatterns,

package/dist/cli.js

@@ -7,7 +7,7 @@ import { Performance } from './util/Performance.js';
 import { runPreprocessors, runReporters } from './util/reporter.js';
 import { version } from './version.js';
 import { main } from './index.js';
-const { debug: isDebug = false, help: isHelp, 'max-issues': maxIssues = '0', 'no-config-hints': noConfigHints = false, 'no-exit-code': noExitCode = false, 'no-gitignore': isNoGitIgnore = false, 'no-progress': isNoProgress = false, 'include-entry-exports': isIncludeEntryExports = false, performance: isObservePerf = false, production: isProduction = false, 'reporter-options': reporterOptions = '', 'preprocessor-options': preprocessorOptions = '', strict: isStrict = false, tsConfig, version: isVersion, } = parsedArgValues;
+const { debug: isDebug = false, help: isHelp, 'max-issues': maxIssues = '0', 'no-config-hints': noConfigHints = false, 'no-exit-code': noExitCode = false, 'no-gitignore': isNoGitIgnore = false, 'no-progress': isNoProgress = false, 'include-entry-exports': isIncludeEntryExports = false, 'isolate-workspaces': isIsolateWorkspaces = false, performance: isObservePerf = false, production: isProduction = false, 'reporter-options': reporterOptions = '', 'preprocessor-options': preprocessorOptions = '', strict: isStrict = false, tsConfig, version: isVersion, } = parsedArgValues;
 if (isHelp) {
     console.log(helpText);
     process.exit(0);
@@ -28,6 +28,7 @@ const run = async () => {
             isStrict,
             isShowProgress,
             isIncludeEntryExports,
+            isIsolateWorkspaces,
         });
         const initialData = {
             report,

package/dist/index.js

@@ -16,7 +16,7 @@ import { _resolveSpecifier } from './util/require.js';
 import { loadTSConfig } from './util/tsconfig-loader.js';
 import { WorkspaceWorker } from './WorkspaceWorker.js';
 export const main = async (unresolvedConfiguration) => {
-    const { cwd, tsConfigFile, gitignore, isStrict, isProduction, isShowProgress, isIncludeEntryExports } = unresolvedConfiguration;
+    const { cwd, tsConfigFile, gitignore, isStrict, isProduction, isShowProgress, isIncludeEntryExports, isIsolateWorkspaces, } = unresolvedConfiguration;
     debugLogObject('*', 'Unresolved configuration (from CLI arguments)', unresolvedConfiguration);
     const chief = new ConfigurationChief({ cwd, isProduction, isStrict, isIncludeEntryExports });
     const deputy = new DependencyDeputy({ isStrict });
@@ -87,7 +87,15 @@ export const main = async (unresolvedConfiguration) => {
         streamer.cast(`Analyzing workspace ${name}...`);
         deputy.addWorkspace({ name, dir, manifestPath, manifest, ignoreDependencies, ignoreBinaries });
         const { compilerOptions, definitionPaths } = await loadTSConfig(join(dir, tsConfigFile ?? 'tsconfig.json'));
-        const principal = factory.getPrincipal({ cwd: dir, paths, compilerOptions, compilers, pkgName, isGitIgnored });
+        const principal = factory.getPrincipal({
+            cwd: dir,
+            paths,
+            compilerOptions,
+            compilers,
+            pkgName,
+            isGitIgnored,
+            isIsolateWorkspaces,
+        });
         const worker = new WorkspaceWorker({
             name,
             dir,

package/dist/types/cli.d.ts

@@ -6,4 +6,5 @@ export interface CommandLineOptions {
     isProduction: boolean;
     isShowProgress: boolean;
     isIncludeEntryExports: boolean;
+    isIsolateWorkspaces: boolean;
 }

package/dist/typescript/visitors/imports/importDeclaration.js

@@ -17,7 +17,7 @@ export default visit(() => true, (node, options) => {
             if (node.importClause?.namedBindings) {
                 if (ts.isNamespaceImport(node.importClause.namedBindings)) {
                     const symbol = node.importClause.namedBindings.symbol;
-                    imports.push({ symbol, specifier, identifier: '*', pos: symbol.declarations[0].pos ?? node.pos });
+                    imports.push({ symbol, specifier, identifier: '*', pos: symbol?.declarations[0]?.pos ?? node.pos });
                 }
                 if (ts.isNamedImports(node.importClause.namedBindings)) {
                     node.importClause.namedBindings.elements.forEach(element => {

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

@@ -1,4 +1,4 @@
-export declare const helpText = "\u2702\uFE0F  Find unused files, dependencies and exports in your JavaScript and TypeScript projects\n\nUsage: knip [options]\n\nOptions:\n  -c, --config [file]      Configuration file path (default: [.]knip.json[c], knip.js, knip.ts or package.json#knip)\n  -t, --tsConfig [file]    TypeScript configuration path (default: tsconfig.json)\n  --production             Analyze only production source files (e.g. no tests, devDependencies, exported types)\n  --strict                 Consider only direct dependencies of workspace (not devDependencies, not other workspaces)\n  -W, --workspace [dir]    Analyze a single workspace (default: analyze all configured workspaces)\n  --directory [dir]        Run process from a different directory (default: cwd)\n  --no-gitignore           Don't use .gitignore\n  --include                Report only provided issue type(s), can be comma-separated or repeated (1)\n  --exclude                Exclude provided issue type(s) from report, can be comma-separated or repeated (1)\n  --dependencies           Shortcut for --include dependencies,unlisted,unresolved\n  --exports                Shortcut for --include exports,nsExports,classMembers,types,nsTypes,enumMembers,duplicates\n  --include-entry-exports  Include entry files when reporting unused exports\n  -n, --no-progress        Don't show dynamic progress updates (automatically enabled in CI environments)\n  --preprocessor           Preprocess the results before providing it to the reporter(s), can be repeated\n  --preprocessor-options   Pass extra options to the preprocessor (as JSON string, see --reporter-options example)\n  --reporter               Select reporter: symbols, compact, codeowners, json, can be repeated (default: symbols)\n  --reporter-options       Pass extra options to the reporter (as JSON string, see example)\n  --no-config-hints        Suppress configuration hints\n  --no-exit-code           Always exit with code zero (0)\n  --max-issues             Maximum number of issues before non-zero exit code (default: 0)\n  -d, --debug              Show debug output\n  --performance            Measure count and running time of expensive functions and display stats table\n  -h, --help               Print this help text\n  -V, --version            Print version\n\n(1) Issue types: files, dependencies, unlisted, unresolved, exports, nsExports, classMembers, types, nsTypes, enumMembers, duplicates\n\nExamples:\n\n$ knip\n$ knip --production\n$ knip --workspace packages/client --include files,dependencies\n$ knip -c ./config/knip.json --reporter compact\n$ knip --reporter codeowners --reporter-options '{\"path\":\".github/CODEOWNERS\"}'\n\nMore documentation and bug reports: https://github.com/webpro/knip";
+export declare const helpText = "\u2702\uFE0F  Find unused files, dependencies and exports in your JavaScript and TypeScript projects\n\nUsage: knip [options]\n\nOptions:\n  -c, --config [file]      Configuration file path (default: [.]knip.json[c], knip.js, knip.ts or package.json#knip)\n  -t, --tsConfig [file]    TypeScript configuration path (default: tsconfig.json)\n  --production             Analyze only production source files (e.g. no tests, devDependencies, exported types)\n  --strict                 Consider only direct dependencies of workspace (not devDependencies, not other workspaces)\n  -W, --workspace [dir]    Analyze a single workspace (default: analyze all configured workspaces)\n  --directory [dir]        Run process from a different directory (default: cwd)\n  --no-gitignore           Don't use .gitignore\n  --include                Report only provided issue type(s), can be comma-separated or repeated (1)\n  --exclude                Exclude provided issue type(s) from report, can be comma-separated or repeated (1)\n  --dependencies           Shortcut for --include dependencies,unlisted,binaries,unresolved\n  --exports                Shortcut for --include exports,nsExports,classMembers,types,nsTypes,enumMembers,duplicates\n  --include-entry-exports  Include entry files when reporting unused exports\n  --isolate-workspaces     Isolated workspaces in monorepo\n  -n, --no-progress        Don't show dynamic progress updates (automatically enabled in CI environments)\n  --preprocessor           Preprocess the results before providing it to the reporter(s), can be repeated\n  --preprocessor-options   Pass extra options to the preprocessor (as JSON string, see --reporter-options example)\n  --reporter               Select reporter: symbols, compact, codeowners, json, can be repeated (default: symbols)\n  --reporter-options       Pass extra options to the reporter (as JSON string, see example)\n  --no-config-hints        Suppress configuration hints\n  --no-exit-code           Always exit with code zero (0)\n  --max-issues             Maximum number of issues before non-zero exit code (default: 0)\n  -d, --debug              Show debug output\n  --performance            Measure count and running time of expensive functions and display stats table\n  -h, --help               Print this help text\n  -V, --version            Print version\n\n(1) Issue types: files, dependencies, unlisted, unresolved, exports, nsExports, classMembers, types, nsTypes, enumMembers, duplicates\n\nExamples:\n\n$ knip\n$ knip --production\n$ knip --workspace packages/client --include files,dependencies\n$ knip -c ./config/knip.json --reporter compact\n$ knip --reporter codeowners --reporter-options '{\"path\":\".github/CODEOWNERS\"}'\n\nMore documentation and bug reports: https://github.com/webpro/knip";
 declare const _default: {
     config: string | undefined;
     debug: boolean | undefined;
@@ -10,6 +10,7 @@ declare const _default: {
     'ignore-internal': boolean | undefined;
     include: string[] | undefined;
     'include-entry-exports': boolean | undefined;
+    'isolate-workspaces': boolean | undefined;
     'max-issues': string | undefined;
     'no-config-hints': boolean | undefined;
     'no-exit-code': boolean | undefined;

package/dist/util/cli-arguments.js

@@ -13,9 +13,10 @@ Options:
   --no-gitignore           Don't use .gitignore
   --include                Report only provided issue type(s), can be comma-separated or repeated (1)
   --exclude                Exclude provided issue type(s) from report, can be comma-separated or repeated (1)
-  --dependencies           Shortcut for --include dependencies,unlisted,unresolved
+  --dependencies           Shortcut for --include dependencies,unlisted,binaries,unresolved
   --exports                Shortcut for --include exports,nsExports,classMembers,types,nsTypes,enumMembers,duplicates
   --include-entry-exports  Include entry files when reporting unused exports
+  --isolate-workspaces     Isolated workspaces in monorepo
   -n, --no-progress        Don't show dynamic progress updates (automatically enabled in CI environments)
   --preprocessor           Preprocess the results before providing it to the reporter(s), can be repeated
   --preprocessor-options   Pass extra options to the preprocessor (as JSON string, see --reporter-options example)
@@ -54,6 +55,7 @@ try {
             'ignore-internal': { type: 'boolean' },
             include: { type: 'string', multiple: true },
             'include-entry-exports': { type: 'boolean' },
+            'isolate-workspaces': { type: 'boolean' },
             'max-issues': { type: 'string' },
             'no-config-hints': { type: 'boolean' },
             'no-exit-code': { type: 'boolean' },

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

@@ -1,5 +1,10 @@
 import { ISSUE_TYPES } from '../constants.js';
+import { ConfigurationError } from './errors.js';
 export const getIncludedIssueTypes = (cliArgs, { include = [], exclude = [], isProduction = false } = {}) => {
+    [...cliArgs.include, ...cliArgs.exclude, ...include, ...exclude].forEach(type => {
+        if (!ISSUE_TYPES.includes(type))
+            throw new ConfigurationError(`Invalid issue type: ${type}`);
+    });
     if (cliArgs.dependencies) {
         cliArgs.include = [
             ...cliArgs.include,

package/dist/util/tsconfig-loader.js

@@ -1,8 +1,9 @@
 import ts from 'typescript';
 import { isFile } from './fs.js';
+import { FAKE_PATH } from './loader.js';
 import { dirname } from './path.js';
 export const loadTSConfig = async (tsConfigFilePath) => {
-    if (isFile(tsConfigFilePath)) {
+    if (tsConfigFilePath !== FAKE_PATH && isFile(tsConfigFilePath)) {
         const config = ts.readConfigFile(tsConfigFilePath, ts.sys.readFile);
         const parsedConfig = ts.parseJsonConfigFileContent(config.config, ts.sys, dirname(tsConfigFilePath));
         const compilerOptions = parsedConfig.options ?? {};

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const version = "3.0.1";
+export declare const version = "3.1.0";

package/dist/version.js

@@ -1 +1 @@
-export const version = '3.0.1';
+export const version = '3.1.0';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "knip",
-  "version": "3.0.1",
+  "version": "3.1.0",
   "description": "Find unused files, dependencies and exports in your TypeScript and JavaScript projects",
   "homepage": "https://knip.dev",
   "repository": {