feat(dts-plugin,sdk,website-new): added option to use a base path when resolving types from relative remote urls

.changeset/bright-brooms-divide.md

@@ -0,0 +1,7 @@
+---
+'@module-federation/dts-plugin': minor
+'@module-federation/sdk': minor
+'@module-federation/website-new': minor
+---
+
+Adding `remoteBasePath` to `DtsHostOptions` enabling types to be resolved from a relative remote path.

apps/website-new/docs/en/configure/dts.mdx

@@ -148,6 +148,7 @@ interface DtsHostOptions {
   deleteTypesFolder?: boolean;
   maxRetries?: number;
   consumeAPITypes?: boolean;
+  remoteBasePath?: string;
 }
 ```
 
@@ -209,6 +210,14 @@ Before loading type files, whether to delete the previously loaded `typesFolder`
 
 `typesFolder` corresponding to `remotes` directory configuration
 
+#### remoteBasePath
+
+- Type: `string`
+- Required: No
+- Default value: `''`
+
+Used as the default base path for relative remote URLs when locating types
+
 ### tsConfigPath
 
 - Type: `string`

apps/website-new/docs/zh/configure/dts.mdx

@@ -148,6 +148,7 @@ interface DtsHostOptions {
   deleteTypesFolder?: boolean;
   maxRetries?: number;
   consumeAPITypes?: boolean;
+  remoteBasePath?: string;
 }
 ```
 
@@ -209,6 +210,15 @@ interface DtsHostOptions {
 
 对应 `remotes` 目录配置的 `typesFolder`
 
+#### remoteBasePath
+
+- 类型：`string`
+- 是否必填：否
+- 默认值：`''`
+
+在定位类型时，用作相对远程 URL 的默认基础路径
+
+
 ### tsConfigPath
 
 - 类型：`string`

packages/dts-plugin/src/core/configurations/hostPlugin.test.ts

@@ -41,6 +41,7 @@ describe('hostPlugin', () => {
           abortOnError: true,
           consumeAPITypes: false,
           runtimePkgs: [],
+          remoteBasePath: 'file:',
         });
 
         expect(mapRemotesToDownload).toStrictEqual({
@@ -66,6 +67,7 @@ describe('hostPlugin', () => {
           abortOnError: true,
           consumeAPITypes: false,
           runtimePkgs: [],
+          remoteBasePath: 'file:',
         };
 
         const { hostOptions, mapRemotesToDownload } =
@@ -143,5 +145,54 @@ describe('hostPlugin', () => {
         },
       });
     });
+
+    it('uses the provided remote base path for relative remote urls', () => {
+      const subpathModuleFederationConfig = {
+        ...moduleFederationConfig,
+        remotes: {
+          moduleFederationTypescript: '/subpatha/mf-manifest.json',
+        },
+      };
+
+      const { mapRemotesToDownload } = retrieveHostConfig({
+        moduleFederationConfig: subpathModuleFederationConfig,
+        remoteBasePath: 'http://localhost:3000',
+      });
+
+      expect(mapRemotesToDownload).toStrictEqual({
+        moduleFederationTypescript: {
+          alias: 'moduleFederationTypescript',
+          apiTypeUrl: 'http://localhost:3000/subpatha/@mf-types.d.ts',
+          name: '/subpatha/mf-manifest.json',
+          url: 'http://localhost:3000/subpatha/mf-manifest.json',
+          zipUrl: 'http://localhost:3000/subpatha/@mf-types.zip',
+        },
+      });
+    });
+
+    it('ignores the provided remote base path for absolute remote urls', () => {
+      const subpathModuleFederationConfig = {
+        ...moduleFederationConfig,
+        remotes: {
+          moduleFederationTypescript:
+            'http://localhost:3333/subpatha/mf-manifest.json',
+        },
+      };
+
+      const { mapRemotesToDownload } = retrieveHostConfig({
+        moduleFederationConfig: subpathModuleFederationConfig,
+        remoteBasePath: 'http://localhost:3000',
+      });
+
+      expect(mapRemotesToDownload).toStrictEqual({
+        moduleFederationTypescript: {
+          alias: 'moduleFederationTypescript',
+          apiTypeUrl: 'http://localhost:3333/subpatha/@mf-types.d.ts',
+          name: 'http://localhost:3333/subpatha/mf-manifest.json',
+          url: 'http://localhost:3333/subpatha/mf-manifest.json',
+          zipUrl: 'http://localhost:3333/subpatha/@mf-types.zip',
+        },
+      });
+    });
   });
 });

packages/dts-plugin/src/core/configurations/hostPlugin.ts

@@ -8,6 +8,8 @@ import { utils } from '@module-federation/managers';
 import { HostOptions, RemoteInfo } from '../interfaces/HostOptions';
 import { validateOptions } from '../lib/utils';
 
+const fileBase = 'file:';
+
 const defaultOptions = {
   typesFolder: '@mf-types',
   remoteTypesFolder: '@mf-types',
@@ -18,18 +20,31 @@ const defaultOptions = {
   abortOnError: true,
   consumeAPITypes: false,
   runtimePkgs: [],
+  remoteBasePath: fileBase,
 } satisfies Partial<HostOptions>;
 
-const buildZipUrl = (hostOptions: Required<HostOptions>, url: string) => {
-  const remoteUrl = new URL(url, 'file:');
-
-  const pathnameWithoutEntry = remoteUrl.pathname
-    .split('/')
-    .slice(0, -1)
-    .join('/');
-  remoteUrl.pathname = `${pathnameWithoutEntry}/${hostOptions.remoteTypesFolder}.zip`;
+const resolveRelativeUrl = (
+  hostOptions: Required<HostOptions>,
+  entryUrl: string,
+  relativeFile?: string,
+) => {
+  let remoteUrl = new URL(entryUrl, hostOptions.remoteBasePath);
+  if (relativeFile) {
+    const pathnameWithoutEntry = remoteUrl.pathname
+      .split('/')
+      .slice(0, -1)
+      .join('/');
+    remoteUrl.pathname = `${pathnameWithoutEntry}/${relativeFile}`;
+  }
+  return remoteUrl.protocol === fileBase ? remoteUrl.pathname : remoteUrl.href;
+};
 
-  return remoteUrl.protocol === 'file:' ? remoteUrl.pathname : remoteUrl.href;
+const buildZipUrl = (hostOptions: Required<HostOptions>, url: string) => {
+  return resolveRelativeUrl(
+    hostOptions,
+    url,
+    `${hostOptions.remoteTypesFolder}.zip`,
+  );
 };
 
 const buildApiTypeUrl = (zipUrl?: string) => {
@@ -63,7 +78,7 @@ export const retrieveRemoteInfo = (options: {
 
   return {
     name: parsedInfo.name || remoteAlias,
-    url: url,
+    url: resolveRelativeUrl(hostOptions, url),
     zipUrl,
     apiTypeUrl: buildApiTypeUrl(zipUrl),
     alias: remoteAlias,

packages/sdk/src/types/plugins/ModuleFederationPlugin.ts

@@ -144,6 +144,10 @@ export interface DtsHostOptions {
   maxRetries?: number;
   consumeAPITypes?: boolean;
   runtimePkgs?: string[];
+  /**
+   * Used as the default base path for relative remote URLs when locating types
+   */
+  remoteBasePath?: string;
 }
 
 export interface DtsRemoteOptions {