rsbuild-plugin-dts 0.4.0 → 0.5.0-alpha.0

package/README.md

@@ -163,6 +163,77 @@ pluginDts({
 });
 ```
 
+### redirect
+
+- **Type:**
+
+```ts
+type DtsRedirect = {
+  path?: boolean;
+  extension?: boolean;
+};
+```
+
+- **Default:**
+
+```ts
+const defaultRedirect = {
+  path: true,
+  extension: false,
+};
+```
+
+Controls the redirect of the import paths of output TypeScript declaration files.
+
+```js
+pluginDts({
+  redirect: {
+    path: true,
+    extension: false,
+  },
+});
+```
+
+#### redirect.path
+
+- **Type:** `boolean`
+- **Default:** `true`
+
+Whether to automatically redirect the import paths of TypeScript declaration output files.
+
+- When set to `true`, Rslib will redirect the import path in the DTS output file to the corresponding relative path based on the [compilerOptions.paths](https://typescriptlang.org/tsconfig#paths) configured in `tsconfig.json`.
+
+```ts
+// `compilerOptions.paths` is set to `{ "@/*": ["src/*"] }`
+import { foo } from '@/foo'; // source code of './src/bar.ts' ↓
+import { foo } from './foo'; // expected output of './dist/bar.d.ts'
+
+import { foo } from '@/foo'; // source code of './src/utils/index.ts' ↓
+import { foo } from '../foo'; // expected output './dist/utils/index.d.ts'
+```
+
+- When set to `false`, the original import path will remain unchanged.
+
+#### redirect.extension
+
+- **Type:** `boolean`
+- **Default:** `false`
+
+Whether to automatically redirect the file extension to import paths based on the TypeScript declaration output files.
+
+- When set to `true`, the import paths in DTS files will be redirected to the corresponding JavaScript extension which can be resolved to corresponding DTS file. The extension of the DTS output file is related to the `dtsExtension` configuration.
+
+```ts
+// `dtsExtension` is set to `.d.mts`
+import { foo } from './foo'; // source code of './src/bar.ts' ↓
+import { foo } from './foo.mjs'; // expected output of './dist/bar.d.mts'
+
+import { foo } from './foo.ts'; // source code of './src/utils/index.ts' ↓
+import { foo } from './foo.mjs'; // expected output './dist/utils/index.d.mts'
+```
+
+- When set to `false`, the file extension will remain unchanged from the original import path in the rewritten import path of the output file (regardless of whether it is specified or specified as any value).
+
 ## Contributing
 
 Please read the [Contributing Guide](https://github.com/web-infra-dev/rslib/blob/main/CONTRIBUTING.md).

package/dist/dts.js

@@ -52,13 +52,12 @@ const calcBundledPackages = (options)=>{
     return Array.from(new Set(bundledPackages));
 };
 async function generateDts(data) {
-    const { bundle, dtsEntry, tsconfigPath, tsConfigResult, distPath, rootDistPath, cleanDistPath, name, cwd, build, isWatch, dtsExtension = '.d.ts', autoExternal = true, userExternals, banner, footer } = data;
+    const { bundle, dtsEntry, dtsEmitPath, tsconfigPath, tsConfigResult, name, cwd, build, isWatch, dtsExtension = '.d.ts', autoExternal = true, userExternals, banner, footer, redirect = {
+        path: true,
+        extension: false
+    } } = data;
     __WEBPACK_EXTERNAL_MODULE__rsbuild_core_1b356efc__.logger.start(`Generating DTS... ${__WEBPACK_EXTERNAL_MODULE_picocolors__["default"].gray(`(${name})`)}`);
     const { options: rawCompilerOptions, fileNames } = tsConfigResult;
-    const dtsEmitPath = distPath ?? rawCompilerOptions.declarationDir ?? rootDistPath;
-    if (false !== cleanDistPath) await (0, __WEBPACK_EXTERNAL_MODULE__utils_js_d88b7fe1__.cleanDtsFiles)(dtsEmitPath);
-    if (bundle) await (0, __WEBPACK_EXTERNAL_MODULE__utils_js_d88b7fe1__.clearTempDeclarationDir)(cwd);
-    if (rawCompilerOptions.composite || rawCompilerOptions.incremental || build) await (0, __WEBPACK_EXTERNAL_MODULE__utils_js_d88b7fe1__.cleanTsBuildInfoFile)(tsconfigPath, rawCompilerOptions);
     const rootDir = rawCompilerOptions.rootDir ?? (rawCompilerOptions.composite ? (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.dirname)(tsconfigPath) : await (0, __WEBPACK_EXTERNAL_MODULE__utils_js_d88b7fe1__.calcLongestCommonPath)(fileNames.filter((fileName)=>!/\.d\.(ts|mts|cts)$/.test(fileName)))) ?? (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.dirname)(tsconfigPath);
     const resolvedDtsEmitPath = (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.normalize)((0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.resolve)((0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.dirname)(tsconfigPath), dtsEmitPath));
     if (build) {
@@ -109,6 +108,8 @@ async function generateDts(data) {
         tsConfigResult,
         declarationDir,
         dtsExtension,
+        redirect,
+        rootDir,
         banner,
         footer
     }, onComplete, bundle, isWatch, build);

package/dist/index.d.ts

@@ -1,5 +1,9 @@
 import { type RsbuildConfig, type RsbuildPlugin } from '@rsbuild/core';
 import ts from 'typescript';
+export type DtsRedirect = {
+    path?: boolean;
+    extension?: boolean;
+};
 export type PluginDtsOptions = {
     bundle?: boolean;
     distPath?: string;
@@ -13,6 +17,7 @@ export type PluginDtsOptions = {
     };
     banner?: string;
     footer?: string;
+    redirect?: DtsRedirect;
 };
 export type DtsEntry = {
     name?: string;
@@ -23,11 +28,10 @@ export type DtsGenOptions = PluginDtsOptions & {
     cwd: string;
     isWatch: boolean;
     dtsEntry: DtsEntry;
+    dtsEmitPath: string;
     build?: boolean;
     tsconfigPath: string;
     tsConfigResult: ts.ParsedCommandLine;
-    rootDistPath: string;
-    cleanDistPath: NonNullable<RsbuildConfig['output']>['cleanDistPath'];
     userExternals?: NonNullable<RsbuildConfig['output']>['externals'];
 };
 export declare const PLUGIN_DTS_NAME = "rsbuild:dts";

package/dist/index.js

@@ -2,6 +2,7 @@ import * as __WEBPACK_EXTERNAL_MODULE_node_child_process_27f17141__ from "node:c
 import * as __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__ from "node:path";
 import * as __WEBPACK_EXTERNAL_MODULE_node_url_e96de089__ from "node:url";
 import * as __WEBPACK_EXTERNAL_MODULE__rsbuild_core_1b356efc__ from "@rsbuild/core";
+import * as __WEBPACK_EXTERNAL_MODULE_picocolors__ from "picocolors";
 import * as __WEBPACK_EXTERNAL_MODULE_typescript__ from "typescript";
 import * as __WEBPACK_EXTERNAL_MODULE__utils_js_d88b7fe1__ from "./utils.js";
 const src_rslib_entry_filename = (0, __WEBPACK_EXTERNAL_MODULE_node_url_e96de089__.fileURLToPath)(import.meta.url);
@@ -13,6 +14,9 @@ const pluginDts = (options = {})=>({
             options.bundle = options.bundle ?? false;
             options.abortOnError = options.abortOnError ?? true;
             options.build = options.build ?? false;
+            options.redirect = options.redirect ?? {};
+            options.redirect.path = options.redirect.path ?? true;
+            options.redirect.extension = options.redirect.extension ?? false;
             const dtsPromises = [];
             let promisesResult = [];
             let childProcesses = [];
@@ -23,10 +27,15 @@ const pluginDts = (options = {})=>({
                 const cwd = api.context.rootPath;
                 const tsconfigPath = __WEBPACK_EXTERNAL_MODULE_typescript__["default"].findConfigFile(cwd, __WEBPACK_EXTERNAL_MODULE_typescript__["default"].sys.fileExists, config.source.tsconfigPath);
                 if (!tsconfigPath) {
-                    __WEBPACK_EXTERNAL_MODULE__rsbuild_core_1b356efc__.logger.error(`tsconfig.json not found in ${cwd}`);
+                    __WEBPACK_EXTERNAL_MODULE__rsbuild_core_1b356efc__.logger.error(`Failed to resolve tsconfig file ${__WEBPACK_EXTERNAL_MODULE_picocolors__["default"].cyan(`"${config.source.tsconfigPath}"`)} from ${__WEBPACK_EXTERNAL_MODULE_picocolors__["default"].cyan(cwd)}. Please ensure that the file exists.`);
                     throw new Error();
                 }
                 const tsConfigResult = (0, __WEBPACK_EXTERNAL_MODULE__utils_js_d88b7fe1__.loadTsconfig)(tsconfigPath);
+                const { options: rawCompilerOptions } = tsConfigResult;
+                const dtsEmitPath = options.distPath ?? rawCompilerOptions.declarationDir ?? config.output?.distPath?.root;
+                if (false !== config.output.cleanDistPath) await (0, __WEBPACK_EXTERNAL_MODULE__utils_js_d88b7fe1__.cleanDtsFiles)(dtsEmitPath);
+                if (options.bundle) await (0, __WEBPACK_EXTERNAL_MODULE__utils_js_d88b7fe1__.clearTempDeclarationDir)(cwd);
+                if (rawCompilerOptions.composite || rawCompilerOptions.incremental || options.build) await (0, __WEBPACK_EXTERNAL_MODULE__utils_js_d88b7fe1__.cleanTsBuildInfoFile)(tsconfigPath, rawCompilerOptions);
                 const jsExtension = (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.extname)(src_rslib_entry_filename);
                 const childProcess = (0, __WEBPACK_EXTERNAL_MODULE_node_child_process_27f17141__.fork)((0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.join)(src_rslib_entry_dirname, `./dts${jsExtension}`), [], {
                     stdio: 'inherit'
@@ -35,11 +44,10 @@ const pluginDts = (options = {})=>({
                 const dtsGenOptions = {
                     ...options,
                     dtsEntry,
-                    rootDistPath: config.output?.distPath?.root,
+                    dtsEmitPath,
                     userExternals: config.output.externals,
                     tsconfigPath,
                     tsConfigResult,
-                    cleanDistPath: config.output.cleanDistPath,
                     name: environment.name,
                     cwd,
                     isWatch

package/dist/tsc.d.ts

@@ -1,4 +1,5 @@
 import ts from 'typescript';
+import type { DtsRedirect } from './index';
 export type EmitDtsOptions = {
     name: string;
     cwd: string;
@@ -6,6 +7,8 @@ export type EmitDtsOptions = {
     tsConfigResult: ts.ParsedCommandLine;
     declarationDir: string;
     dtsExtension: string;
+    rootDir: string;
+    redirect: DtsRedirect;
     banner?: string;
     footer?: string;
 };

package/dist/tsc.js

@@ -2,14 +2,14 @@ import * as __WEBPACK_EXTERNAL_MODULE__rsbuild_core_1b356efc__ from "@rsbuild/co
 import * as __WEBPACK_EXTERNAL_MODULE_picocolors__ from "picocolors";
 import * as __WEBPACK_EXTERNAL_MODULE_typescript__ from "typescript";
 import * as __WEBPACK_EXTERNAL_MODULE__utils_js_d88b7fe1__ from "./utils.js";
-async function handleDiagnosticsAndProcessFiles(diagnostics, configPath, host, bundle, declarationDir, dtsExtension, banner, footer, name) {
+async function handleDiagnosticsAndProcessFiles(diagnostics, configPath, host, bundle, declarationDir, dtsExtension, redirect, rootDir, banner, footer, name) {
     const diagnosticMessages = [];
     for (const diagnostic of diagnostics){
         const fileLoc = (0, __WEBPACK_EXTERNAL_MODULE__utils_js_d88b7fe1__.getFileLoc)(diagnostic, configPath);
         const message = `${fileLoc} - ${__WEBPACK_EXTERNAL_MODULE_picocolors__["default"].red('error')} ${__WEBPACK_EXTERNAL_MODULE_picocolors__["default"].gray(`TS${diagnostic.code}:`)} ${__WEBPACK_EXTERNAL_MODULE_typescript__["default"].flattenDiagnosticMessageText(diagnostic.messageText, host.getNewLine())}`;
         diagnosticMessages.push(message);
     }
-    await (0, __WEBPACK_EXTERNAL_MODULE__utils_js_d88b7fe1__.processDtsFiles)(bundle, declarationDir, dtsExtension, banner, footer);
+    await (0, __WEBPACK_EXTERNAL_MODULE__utils_js_d88b7fe1__.processDtsFiles)(bundle, declarationDir, dtsExtension, redirect, configPath, rootDir, banner, footer);
     if (diagnosticMessages.length) {
         __WEBPACK_EXTERNAL_MODULE__rsbuild_core_1b356efc__.logger.error(`Failed to emit declaration files. ${__WEBPACK_EXTERNAL_MODULE_picocolors__["default"].gray(`(${name})`)}`);
         for (const message of diagnosticMessages)__WEBPACK_EXTERNAL_MODULE__rsbuild_core_1b356efc__.logger.error(message);
@@ -18,7 +18,7 @@ async function handleDiagnosticsAndProcessFiles(diagnostics, configPath, host, b
 }
 async function emitDts(options, onComplete, bundle = false, isWatch = false, build = false) {
     const start = Date.now();
-    const { configPath, tsConfigResult, declarationDir, name, dtsExtension, banner, footer } = options;
+    const { configPath, tsConfigResult, declarationDir, name, dtsExtension, rootDir, banner, footer, redirect } = options;
     const { options: rawCompilerOptions, fileNames, projectReferences } = tsConfigResult;
     const compilerOptions = {
         ...rawCompilerOptions,
@@ -47,11 +47,11 @@ async function emitDts(options, onComplete, bundle = false, isWatch = false, bui
                 __WEBPACK_EXTERNAL_MODULE__rsbuild_core_1b356efc__.logger.info(message);
                 onComplete(true);
             }
-            await (0, __WEBPACK_EXTERNAL_MODULE__utils_js_d88b7fe1__.processDtsFiles)(bundle, declarationDir, dtsExtension, banner, footer);
+            await (0, __WEBPACK_EXTERNAL_MODULE__utils_js_d88b7fe1__.processDtsFiles)(bundle, declarationDir, dtsExtension, redirect, configPath, rootDir, banner, footer);
         }
         if (6193 === diagnostic.code) {
             __WEBPACK_EXTERNAL_MODULE__rsbuild_core_1b356efc__.logger.error(message);
-            await (0, __WEBPACK_EXTERNAL_MODULE__utils_js_d88b7fe1__.processDtsFiles)(bundle, declarationDir, dtsExtension, banner, footer);
+            await (0, __WEBPACK_EXTERNAL_MODULE__utils_js_d88b7fe1__.processDtsFiles)(bundle, declarationDir, dtsExtension, redirect, configPath, rootDir, banner, footer);
         }
     };
     const system = {
@@ -84,7 +84,7 @@ async function emitDts(options, onComplete, bundle = false, isWatch = false, bui
                 });
                 program.emit();
                 const allDiagnostics = program.getSemanticDiagnostics().concat(program.getConfigFileParsingDiagnostics());
-                await handleDiagnosticsAndProcessFiles(allDiagnostics, configPath, host, bundle, declarationDir, dtsExtension, banner, footer, name);
+                await handleDiagnosticsAndProcessFiles(allDiagnostics, configPath, host, bundle, declarationDir, dtsExtension, redirect, rootDir, banner, footer, name);
             } else {
                 let errorNumber = 0;
                 const reportErrorSummary = (errorCount)=>{
@@ -95,7 +95,7 @@ async function emitDts(options, onComplete, bundle = false, isWatch = false, bui
                     configPath
                 ], compilerOptions);
                 solutionBuilder.build();
-                await (0, __WEBPACK_EXTERNAL_MODULE__utils_js_d88b7fe1__.processDtsFiles)(bundle, declarationDir, dtsExtension, banner, footer);
+                await (0, __WEBPACK_EXTERNAL_MODULE__utils_js_d88b7fe1__.processDtsFiles)(bundle, declarationDir, dtsExtension, redirect, configPath, rootDir, banner, footer);
                 if (errorNumber > 0) {
                     __WEBPACK_EXTERNAL_MODULE__rsbuild_core_1b356efc__.logger.error(`Failed to emit declaration files. ${__WEBPACK_EXTERNAL_MODULE_picocolors__["default"].gray(`(${name})`)}`);
                     throw new Error('DTS generation failed');
@@ -112,7 +112,7 @@ async function emitDts(options, onComplete, bundle = false, isWatch = false, bui
             });
             const emitResult = program.emit();
             const allDiagnostics = __WEBPACK_EXTERNAL_MODULE_typescript__["default"].getPreEmitDiagnostics(program).concat(emitResult.diagnostics);
-            await handleDiagnosticsAndProcessFiles(allDiagnostics, configPath, host, bundle, declarationDir, dtsExtension, banner, footer, name);
+            await handleDiagnosticsAndProcessFiles(allDiagnostics, configPath, host, bundle, declarationDir, dtsExtension, redirect, rootDir, banner, footer, name);
         }
         __WEBPACK_EXTERNAL_MODULE__rsbuild_core_1b356efc__.logger.ready(`DTS generated in ${(0, __WEBPACK_EXTERNAL_MODULE__utils_js_d88b7fe1__.getTimeCost)(start)} ${__WEBPACK_EXTERNAL_MODULE_picocolors__["default"].gray(`(${name})`)}`);
     }

package/dist/utils.d.ts

@@ -1,6 +1,8 @@
 import { type RsbuildConfig } from '@rsbuild/core';
+import { type MatchPath } from 'tsconfig-paths';
 import ts from 'typescript';
-import type { DtsEntry } from './index';
+import type { DtsEntry, DtsRedirect } from './index';
+export declare const JS_EXTENSIONS_PATTERN: RegExp;
 export declare function loadTsconfig(tsconfigPath: string): ts.ParsedCommandLine;
 export declare const TEMP_FOLDER = ".rslib";
 export declare const TEMP_DTS_DIR: string;
@@ -11,8 +13,9 @@ export declare function clearTempDeclarationDir(cwd: string): Promise<void>;
 export declare function getFileLoc(diagnostic: ts.Diagnostic, configPath: string): string;
 export declare const prettyTime: (seconds: number) => string;
 export declare function getTimeCost(start: number): string;
-export declare function addBannerAndFooter(file: string, banner?: string, footer?: string): Promise<void>;
-export declare function processDtsFiles(bundle: boolean, dir: string, dtsExtension: string, banner?: string, footer?: string): Promise<void>;
+export declare function addBannerAndFooter(dtsFile: string, banner?: string, footer?: string): Promise<void>;
+export declare function redirectDtsImports(dtsFile: string, dtsExtension: string, redirect: DtsRedirect, matchPath: MatchPath, outDir: string, rootDir: string): Promise<void>;
+export declare function processDtsFiles(bundle: boolean, dir: string, dtsExtension: string, redirect: DtsRedirect, tsconfigPath: string, rootDir: string, banner?: string, footer?: string): Promise<void>;
 export declare function processSourceEntry(bundle: boolean, entryConfig: NonNullable<RsbuildConfig['source']>['entry']): DtsEntry;
 export declare function calcLongestCommonPath(absPaths: string[]): Promise<string | null>;
 export declare function cleanDtsFiles(dir: string): Promise<void>;

package/dist/utils.js

@@ -2,11 +2,28 @@ import * as __WEBPACK_EXTERNAL_MODULE_node_fs_5ea92f0c__ from "node:fs";
 import * as __WEBPACK_EXTERNAL_MODULE_node_fs_promises_153e37e0__ from "node:fs/promises";
 import * as __WEBPACK_EXTERNAL_MODULE_node_os_74b4b876__ from "node:os";
 import * as __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__ from "node:path";
+import * as __WEBPACK_EXTERNAL_MODULE__ast_grep_napi_5dd5d9b1__ from "@ast-grep/napi";
 import * as __WEBPACK_EXTERNAL_MODULE__rsbuild_core_1b356efc__ from "@rsbuild/core";
 import * as __WEBPACK_EXTERNAL_MODULE_magic_string_758c1a52__ from "magic-string";
 import * as __WEBPACK_EXTERNAL_MODULE_picocolors__ from "picocolors";
 import * as __WEBPACK_EXTERNAL_MODULE_tinyglobby__ from "tinyglobby";
+import * as __WEBPACK_EXTERNAL_MODULE_tsconfig_paths_df62e9eb__ from "tsconfig-paths";
 import * as __WEBPACK_EXTERNAL_MODULE_typescript__ from "typescript";
+const JS_EXTENSIONS = [
+    'js',
+    'mjs',
+    'jsx',
+    '(?<!\\.d\\.)ts',
+    '(?<!\\.d\\.)mts',
+    '(?<!\\.d\\.)cts',
+    'tsx',
+    'cjs',
+    'cjsx',
+    'mjsx',
+    'mtsx',
+    'ctsx'
+];
+const JS_EXTENSIONS_PATTERN = new RegExp(`\\.(${JS_EXTENSIONS.join('|')})$`);
 function loadTsconfig(tsconfigPath) {
     const configFile = __WEBPACK_EXTERNAL_MODULE_typescript__["default"].readConfigFile(tsconfigPath, __WEBPACK_EXTERNAL_MODULE_typescript__["default"].sys.readFile);
     const configFileContent = __WEBPACK_EXTERNAL_MODULE_typescript__["default"].parseJsonConfigFileContent(configFile.config, __WEBPACK_EXTERNAL_MODULE_typescript__["default"].sys, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__["default"].dirname(tsconfigPath));
@@ -68,21 +85,124 @@ function getTimeCost(start) {
     const second = (Date.now() - start) / 1000;
     return prettyTime(second);
 }
-async function addBannerAndFooter(file, banner, footer) {
-    if (!banner && !footer) return;
-    const content = await __WEBPACK_EXTERNAL_MODULE_node_fs_promises_153e37e0__["default"].readFile(file, 'utf-8');
+async function addBannerAndFooter(dtsFile, banner, footer) {
+    const content = await __WEBPACK_EXTERNAL_MODULE_node_fs_promises_153e37e0__["default"].readFile(dtsFile, 'utf-8');
     const code = new __WEBPACK_EXTERNAL_MODULE_magic_string_758c1a52__["default"](content);
     if (banner && !content.trimStart().startsWith(banner.trim())) code.prepend(`${banner}\n`);
     if (footer && !content.trimEnd().endsWith(footer.trim())) code.append(`\n${footer}\n`);
-    if (code.hasChanged()) await __WEBPACK_EXTERNAL_MODULE_node_fs_promises_153e37e0__["default"].writeFile(file, code.toString());
+    if (code.hasChanged()) await __WEBPACK_EXTERNAL_MODULE_node_fs_promises_153e37e0__["default"].writeFile(dtsFile, code.toString());
 }
-async function processDtsFiles(bundle, dir, dtsExtension, banner, footer) {
+async function redirectDtsImports(dtsFile, dtsExtension, redirect, matchPath, outDir, rootDir) {
+    const content = await __WEBPACK_EXTERNAL_MODULE_node_fs_promises_153e37e0__["default"].readFile(dtsFile, 'utf-8');
+    const code = new __WEBPACK_EXTERNAL_MODULE_magic_string_758c1a52__["default"](content);
+    const sgNode = (await (0, __WEBPACK_EXTERNAL_MODULE__ast_grep_napi_5dd5d9b1__.parseAsync)("typescript", content)).root();
+    const matcher = {
+        rule: {
+            kind: 'string_fragment',
+            any: [
+                {
+                    inside: {
+                        stopBy: 'end',
+                        kind: 'import_statement',
+                        field: 'source'
+                    }
+                },
+                {
+                    inside: {
+                        stopBy: 'end',
+                        kind: 'export_statement',
+                        field: 'source'
+                    }
+                },
+                {
+                    inside: {
+                        kind: 'string',
+                        inside: {
+                            kind: 'arguments',
+                            inside: {
+                                kind: 'call_expression',
+                                has: {
+                                    field: 'function',
+                                    regex: '^(import|require)$'
+                                }
+                            }
+                        }
+                    }
+                }
+            ]
+        }
+    };
+    const matchModule = sgNode.findAll(matcher).map((matchNode)=>({
+            n: matchNode.text(),
+            s: matchNode.range().start.index,
+            e: matchNode.range().end.index
+        }));
+    const extensions = dtsExtension.replace(/\.d\.ts$/, '.js').replace(/\.d\.cts$/, '.cjs').replace(/\.d\.mts$/, '.mjs');
+    for (const imp of matchModule){
+        const { n: importPath, s: start, e: end } = imp;
+        if (!!importPath) try {
+            const absoluteImportPath = matchPath(importPath, void 0, void 0, [
+                '.jsx',
+                '.tsx',
+                '.js',
+                '.ts',
+                '.mjs',
+                '.mts',
+                '.cjs',
+                '.cts'
+            ]);
+            let redirectImportPath = importPath;
+            if (absoluteImportPath && redirect.path) {
+                const isOutsideRootdir = !(0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.normalize)(absoluteImportPath).startsWith((0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.normalize)(rootDir) + __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__["default"].sep);
+                if (isOutsideRootdir) {
+                    const relativePath = (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.relative)((0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.dirname)(dtsFile), absoluteImportPath);
+                    redirectImportPath = relativePath.startsWith('..') ? relativePath : `./${relativePath}`;
+                } else {
+                    const originalFilePath = (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.resolve)(rootDir, (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.relative)(outDir, dtsFile));
+                    const originalSourceDir = (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.dirname)(originalFilePath);
+                    const relativePath = (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.relative)(originalSourceDir, absoluteImportPath);
+                    redirectImportPath = relativePath.startsWith('..') ? relativePath : `./${relativePath}`;
+                }
+            }
+            const ext = (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.extname)(redirectImportPath);
+            if (ext) {
+                if (JS_EXTENSIONS_PATTERN.test(redirectImportPath)) {
+                    if (redirect.extension) redirectImportPath = redirectImportPath.replace(/\.[^.]+$/, extensions);
+                }
+            } else {
+                if (absoluteImportPath && (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.normalize)(absoluteImportPath).startsWith((0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.normalize)(rootDir))) {
+                    if (redirect.extension) redirectImportPath = `${redirectImportPath}${extensions}`;
+                }
+                if (!absoluteImportPath && importPath.startsWith('.')) {
+                    if (redirect.extension) redirectImportPath = `${redirectImportPath}${extensions}`;
+                }
+            }
+            const normalizedRedirectImportPath = redirectImportPath.split(__WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__["default"].sep).join('/');
+            code.overwrite(start, end, normalizedRedirectImportPath);
+        } catch (err) {
+            __WEBPACK_EXTERNAL_MODULE__rsbuild_core_1b356efc__.logger.debug(err);
+        }
+    }
+    if (code.hasChanged()) await __WEBPACK_EXTERNAL_MODULE_node_fs_promises_153e37e0__["default"].writeFile(dtsFile, code.toString());
+}
+async function processDtsFiles(bundle, dir, dtsExtension, redirect, tsconfigPath, rootDir, banner, footer) {
     if (bundle) return;
+    let matchPath;
+    if (redirect.path || redirect.extension) {
+        const result = (0, __WEBPACK_EXTERNAL_MODULE_tsconfig_paths_df62e9eb__.loadConfig)(tsconfigPath);
+        if ('failed' === result.resultType) {
+            __WEBPACK_EXTERNAL_MODULE__rsbuild_core_1b356efc__.logger.error(result.message);
+            return;
+        }
+        const { absoluteBaseUrl, paths, mainFields, addMatchAll } = result;
+        matchPath = (0, __WEBPACK_EXTERNAL_MODULE_tsconfig_paths_df62e9eb__.createMatchPath)(absoluteBaseUrl, paths, mainFields, addMatchAll);
+    }
     const dtsFiles = await (0, __WEBPACK_EXTERNAL_MODULE_tinyglobby__.glob)(convertPath((0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.join)(dir, '/**/*.d.ts')), {
         absolute: true
     });
     for (const file of dtsFiles)try {
-        await addBannerAndFooter(file, banner, footer);
+        if (banner || footer) await addBannerAndFooter(file, banner, footer);
+        if ((redirect.path || redirect.extension) && matchPath) await redirectDtsImports(file, dtsExtension, redirect, matchPath, dir, rootDir);
         const newFile = file.replace('.d.ts', dtsExtension);
         __WEBPACK_EXTERNAL_MODULE_node_fs_5ea92f0c__["default"].renameSync(file, newFile);
     } catch (error) {
@@ -140,4 +260,4 @@ async function cleanTsBuildInfoFile(tsconfigPath, compilerOptions) {
         force: true
     });
 }
-export { TEMP_DTS_DIR, TEMP_FOLDER, addBannerAndFooter, calcLongestCommonPath, cleanDtsFiles, cleanTsBuildInfoFile, clearTempDeclarationDir, emptyDir, ensureTempDeclarationDir, getFileLoc, getTimeCost, loadTsconfig, pathExists, prettyTime, processDtsFiles, processSourceEntry };
+export { JS_EXTENSIONS_PATTERN, TEMP_DTS_DIR, TEMP_FOLDER, addBannerAndFooter, calcLongestCommonPath, cleanDtsFiles, cleanTsBuildInfoFile, clearTempDeclarationDir, emptyDir, ensureTempDeclarationDir, getFileLoc, getTimeCost, loadTsconfig, pathExists, prettyTime, processDtsFiles, processSourceEntry, redirectDtsImports };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rsbuild-plugin-dts",
-  "version": "0.4.0",
+  "version": "0.5.0-alpha.0",
   "description": "Rsbuild plugin that supports emitting declaration files for TypeScript.",
   "homepage": "https://lib.rsbuild.dev",
   "bugs": {
@@ -25,15 +25,17 @@
     "dist"
   ],
   "dependencies": {
+    "@ast-grep/napi": "^0.35.0",
     "magic-string": "^0.30.17",
     "picocolors": "1.1.1",
-    "tinyglobby": "^0.2.10"
+    "tinyglobby": "^0.2.10",
+    "tsconfig-paths": "^4.2.0"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.49.1",
-    "@rsbuild/core": "~1.2.3",
-    "rsbuild-plugin-publint": "^0.2.1",
-    "rslib": "npm:@rslib/core@0.3.2",
+    "@microsoft/api-extractor": "^7.50.0",
+    "@rsbuild/core": "~1.2.8",
+    "rsbuild-plugin-publint": "^0.3.0",
+    "rslib": "npm:@rslib/core@0.4.1",
     "typescript": "^5.7.3",
     "@rslib/tsconfig": "0.0.1"
   },