fix(dts-plugin): infer root dir from tsconfig references to fix Vite 8 new template dev server failure (#4543)

eezhal92 · 2heal1 · web-flow · commit 95282ac9b21c · 2026-03-17T18:43:55.000+08:00
Co-authored-by: Hanric &lt;hanric.zhang@gmail.com&gt;
diff --git a/.changeset/quiet-clouds-report.md b/.changeset/quiet-clouds-report.md
@@ -0,0 +1,5 @@
+---
+'@module-federation/dts-plugin': patch
+---
+
+Infer root dir from "references" property for solution-style tsconfig
diff --git a/packages/dts-plugin/src/core/configurations/remotePlugin.test.ts b/packages/dts-plugin/src/core/configurations/remotePlugin.test.ts
@@ -204,4 +204,32 @@ describe('hostPlugin', () => {
       });
     });
   });
+
+  describe('successfully parse tsconfig with project references', () => {
+    it.each([
+      {
+        tsConfigFile: './testconfig-reference.test.json',
+        expectedRootDir: resolve(__dirname),
+      },
+      {
+        tsConfigFile: './testconfig-reference-2.test.json',
+        expectedRootDir: resolve(__dirname),
+      },
+      {
+        tsConfigFile: './testconfig-reference-relative.test.json',
+        expectedRootDir: resolve(__dirname, '..'),
+      },
+    ])(
+      'infers rootDir from project references',
+      ({ tsConfigFile, expectedRootDir }) => {
+        const tsConfigPath = join(__dirname, tsConfigFile);
+        const { tsConfig } = retrieveRemoteConfig({
+          moduleFederationConfig,
+          tsConfigPath,
+        });
+
+        expect(tsConfig.compilerOptions.rootDir).toBe(expectedRootDir);
+      },
+    );
+  });
 });
diff --git a/packages/dts-plugin/src/core/configurations/remotePlugin.ts b/packages/dts-plugin/src/core/configurations/remotePlugin.ts
@@ -1,5 +1,5 @@
 import { existsSync } from 'fs';
-import { dirname, join, resolve, extname } from 'path';
+import { dirname, join, resolve, extname, isAbsolute } from 'path';
 import { utils } from '@module-federation/managers';
 import typescript from 'typescript';
 
@@ -49,6 +49,26 @@ function getEffectiveRootDir(
     return commonRoot;
   }
 
+  // if there are project references, infer the commonRoot from references
+  if (parsedCommandLine.projectReferences.length) {
+    const relativeReferences = parsedCommandLine.projectReferences.filter(
+      (reference) => !isAbsolute(reference.originalPath ?? reference.path),
+    );
+    const referencesForRoot = relativeReferences.length
+      ? relativeReferences
+      : parsedCommandLine.projectReferences;
+
+    const commonRoot = referencesForRoot
+      .map((reference) => dirname(reference.path))
+      .reduce((commonPath, filePath) => {
+        while (!filePath.startsWith(commonPath)) {
+          commonPath = dirname(commonPath);
+        }
+        return commonPath;
+      }, dirname(referencesForRoot[0].path));
+    return commonRoot;
+  }
+
   throw new Error(
     'Can not get effective rootDir, please set compilerOptions.rootDir !',
   );
diff --git a/packages/dts-plugin/src/core/configurations/testconfig-reference-2.test.json b/packages/dts-plugin/src/core/configurations/testconfig-reference-2.test.json
@@ -0,0 +1,7 @@
+{
+  "files": [],
+  "references": [
+    { "path": "./testconfig.app.test.json" },
+    { "path": "./testconfig.node.test.json" }
+  ]
+}
diff --git a/packages/dts-plugin/src/core/configurations/testconfig-reference-relative.test.json b/packages/dts-plugin/src/core/configurations/testconfig-reference-relative.test.json
@@ -0,0 +1,7 @@
+{
+  "files": [],
+  "references": [
+    { "path": "../shared/testconfig.shared.test.json" },
+    { "path": "testconfig.local.test.json" }
+  ]
+}
diff --git a/packages/dts-plugin/src/core/configurations/testconfig-reference.test.json b/packages/dts-plugin/src/core/configurations/testconfig-reference.test.json
@@ -0,0 +1,4 @@
+{
+  "files": [],
+  "references": [{ "path": "./testconfig.test.json" }]
+}

-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +---
 +'@module-federation/dts-plugin': patch
 +---
++
 +Infer root dir from "references" property for solution-style tsconfig