Add --isolate-workspaces flag (undocumented)

Author: webpro

packages/knip/src/PrincipalFactory.ts

@@ -16,6 +16,7 @@ export type PrincipalOptions = {
   compilers: [SyncCompilers, AsyncCompilers];
   pkgName: string;
   isGitIgnored: GlobbyFilterFunction;
+  isIsolateWorkspaces: boolean;
 };
 
 const mapToAbsolutePaths = (paths: NonNullable<Paths>, cwd: string): Paths =>
@@ -42,10 +43,10 @@ export class PrincipalFactory {
   principals: Principals = new Set();
 
   public getPrincipal(options: PrincipalOptions) {
-    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;
     } else {

packages/knip/src/cli.ts

@@ -18,6 +18,7 @@ const {
   '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 = '',
@@ -52,6 +53,7 @@ const run = async () => {
       isStrict,
       isShowProgress,
       isIncludeEntryExports,
+      isIsolateWorkspaces,
     });
 
     const initialData: ReporterOptions = {

packages/knip/src/index.ts

@@ -36,8 +36,16 @@ export type { RawConfiguration as KnipConfig } from './types/config.js';
 export type { Preprocessor, Reporter, ReporterOptions } from './types/issues.js';
 
 export const main = async (unresolvedConfiguration: CommandLineOptions) => {
-  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);
 
@@ -130,7 +138,15 @@ export const main = async (unresolvedConfiguration: CommandLineOptions) => {
 
     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,

packages/knip/src/types/cli.ts

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

packages/knip/src/util/cli-arguments.ts

@@ -17,6 +17,7 @@ Options:
   --dependencies           Shortcut for --include dependencies,unlisted,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)
@@ -56,6 +57,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' },

packages/knip/test/helpers/baseArguments.ts

@@ -5,6 +5,7 @@ const baseArguments = {
   isProduction: false,
   isShowProgress: false,
   isIncludeEntryExports: false,
+  isIsolateWorkspaces: false,
 };
 
 export default baseArguments;