rsbuild-plugin-dts 0.0.3 → 0.0.5

package/dist/apiExtractor.d.ts

@@ -4,6 +4,8 @@ export type BundleOptions = {
     cwd: string;
     outDir: string;
     dtsExtension: string;
+    banner?: string;
+    footer?: string;
     dtsEntry: DtsEntry;
     tsconfigPath?: string;
     bundledPackages?: string[];

package/dist/apiExtractor.js

@@ -3,41 +3,19 @@ import * as __WEBPACK_EXTERNAL_MODULE__microsoft_api_extractor__ from "@microsof
 import * as __WEBPACK_EXTERNAL_MODULE__rsbuild_core__ from "@rsbuild/core";
 import * as __WEBPACK_EXTERNAL_MODULE_picocolors__ from "picocolors";
 import * as __WEBPACK_EXTERNAL_MODULE__utils_js__ from "./utils.js";
-
-;// CONCATENATED MODULE: external "node:path"
-
 var external_node_path_namespaceObject = __WEBPACK_EXTERNAL_MODULE_node_path__;
-
-;// CONCATENATED MODULE: external "@microsoft/api-extractor"
-
 var api_extractor_namespaceObject = __WEBPACK_EXTERNAL_MODULE__microsoft_api_extractor__;
-
-;// CONCATENATED MODULE: external "@rsbuild/core"
-
 var core_namespaceObject = __WEBPACK_EXTERNAL_MODULE__rsbuild_core__;
-
-;// CONCATENATED MODULE: external "picocolors"
-
 var external_picocolors_namespaceObject = __WEBPACK_EXTERNAL_MODULE_picocolors__;
-
-;// CONCATENATED MODULE: external "./utils.js"
-
 var external_utils_js_namespaceObject = __WEBPACK_EXTERNAL_MODULE__utils_js__;
-
-;// CONCATENATED MODULE: ./src/apiExtractor.ts
-
-
-
-
-
 async function bundleDts(options) {
-    const { name, cwd, outDir, dtsExtension, dtsEntry = {
+    const { name, cwd, outDir, dtsExtension, banner, footer, dtsEntry = {
         name: 'index',
         path: 'index.d.ts'
     }, tsconfigPath = 'tsconfig.json', bundledPackages = [] } = options;
     try {
         const start = Date.now();
-        const untrimmedFilePath = (0,external_node_path_namespaceObject.join)(cwd, (0,external_node_path_namespaceObject.relative)(cwd, outDir), `${dtsEntry.name}${dtsExtension}`);
+        const untrimmedFilePath = (0, external_node_path_namespaceObject.join)(cwd, (0, external_node_path_namespaceObject.relative)(cwd, outDir), `${dtsEntry.name}${dtsExtension}`);
         const mainEntryPointFilePath = dtsEntry.path;
         const internalConfig = {
             mainEntryPointFilePath,
@@ -47,26 +25,24 @@ async function bundleDts(options) {
                 untrimmedFilePath
             },
             compiler: {
-                tsconfigFilePath: tsconfigPath.includes(cwd) ? tsconfigPath : (0,external_node_path_namespaceObject.join)(cwd, tsconfigPath)
+                tsconfigFilePath: tsconfigPath.includes(cwd) ? tsconfigPath : (0, external_node_path_namespaceObject.join)(cwd, tsconfigPath)
             },
             projectFolder: cwd
         };
         const extractorConfig = api_extractor_namespaceObject.ExtractorConfig.prepare({
             configObject: internalConfig,
-            configObjectFullPath: undefined,
-            packageJsonFullPath: (0,external_node_path_namespaceObject.join)(cwd, 'package.json')
+            configObjectFullPath: void 0,
+            packageJsonFullPath: (0, external_node_path_namespaceObject.join)(cwd, 'package.json')
         });
         const extractorResult = api_extractor_namespaceObject.Extractor.invoke(extractorConfig, {
             localBuild: true
         });
-        if (!extractorResult.succeeded) {
-            throw new Error(`API Extractor error. ${external_picocolors_namespaceObject["default"].gray(`(${name})`)}`);
-        }
-        core_namespaceObject.logger.info(`API Extractor bundle DTS succeeded: ${external_picocolors_namespaceObject["default"].cyan(untrimmedFilePath)} in ${(0,external_utils_js_namespaceObject.getTimeCost)(start)} ${external_picocolors_namespaceObject["default"].gray(`(${name})`)}`);
+        if (!extractorResult.succeeded) throw new Error(`API Extractor error. ${external_picocolors_namespaceObject["default"].gray(`(${name})`)}`);
+        await (0, external_utils_js_namespaceObject.addBannerAndFooter)(untrimmedFilePath, banner, footer);
+        core_namespaceObject.logger.info(`API Extractor bundle DTS succeeded: ${external_picocolors_namespaceObject["default"].cyan(untrimmedFilePath)} in ${(0, external_utils_js_namespaceObject.getTimeCost)(start)} ${external_picocolors_namespaceObject["default"].gray(`(${name})`)}`);
     } catch (e) {
         core_namespaceObject.logger.error('API Extractor Error');
         throw new Error(`${e}`);
     }
 }
-
 export { bundleDts };

package/dist/dts.js

@@ -5,82 +5,41 @@ import * as __WEBPACK_EXTERNAL_MODULE_picocolors__ from "picocolors";
 import * as __WEBPACK_EXTERNAL_MODULE_typescript__ from "typescript";
 import * as __WEBPACK_EXTERNAL_MODULE__tsc_js__ from "./tsc.js";
 import * as __WEBPACK_EXTERNAL_MODULE__utils_js__ from "./utils.js";
-var __webpack_modules__ = ({
-"./apiExtractor": (function (module) {
-module.exports = import("./apiExtractor.js");
-
-}),
-
-});
-/************************************************************************/
-// The module cache
+var __webpack_modules__ = {
+    "./apiExtractor": function(module) {
+        module.exports = import("./apiExtractor.js");
+    }
+};
+/************************************************************************/ // The module cache
 var __webpack_module_cache__ = {};
-
 // The require function
 function __webpack_require__(moduleId) {
-
-// Check if module is in cache
-var cachedModule = __webpack_module_cache__[moduleId];
-if (cachedModule !== undefined) {
-return cachedModule.exports;
-}
-// Create a new module (and put it into the cache)
-var module = (__webpack_module_cache__[moduleId] = {
-exports: {}
-});
-// Execute the module function
-__webpack_modules__[moduleId](module, module.exports, __webpack_require__);
-
-// Return the exports of the module
-return module.exports;
-
-}
-
-/************************************************************************/
-
-;// CONCATENATED MODULE: external "node:fs"
-
+    // Check if module is in cache
+    var cachedModule = __webpack_module_cache__[moduleId];
+    if (void 0 !== cachedModule) return cachedModule.exports;
+    // Create a new module (and put it into the cache)
+    var module = __webpack_module_cache__[moduleId] = {
+        exports: {}
+    };
+    // Execute the module function
+    __webpack_modules__[moduleId](module, module.exports, __webpack_require__);
+    // Return the exports of the module
+    return module.exports;
+} /************************************************************************/ 
 var external_node_fs_namespaceObject = __WEBPACK_EXTERNAL_MODULE_node_fs__;
-
-;// CONCATENATED MODULE: external "node:path"
-
 var external_node_path_namespaceObject = __WEBPACK_EXTERNAL_MODULE_node_path__;
-
-;// CONCATENATED MODULE: external "@rsbuild/core"
-
 var core_namespaceObject = __WEBPACK_EXTERNAL_MODULE__rsbuild_core__;
-
-;// CONCATENATED MODULE: external "picocolors"
-
 var external_picocolors_namespaceObject = __WEBPACK_EXTERNAL_MODULE_picocolors__;
-
-;// CONCATENATED MODULE: external "typescript"
-
 var external_typescript_namespaceObject = __WEBPACK_EXTERNAL_MODULE_typescript__;
-
-;// CONCATENATED MODULE: external "./tsc.js"
-
 var external_tsc_js_namespaceObject = __WEBPACK_EXTERNAL_MODULE__tsc_js__;
-
-;// CONCATENATED MODULE: external "./utils.js"
-
 var external_utils_js_namespaceObject = __WEBPACK_EXTERNAL_MODULE__utils_js__;
-
-;// CONCATENATED MODULE: ./src/dts.ts
-
-
-
-
-
-
-
-const isObject = (obj)=>Object.prototype.toString.call(obj) === '[object Object]';
+const isObject = (obj)=>'[object Object]' === Object.prototype.toString.call(obj);
 // use !externals
 const calcBundledPackages = (options)=>{
     const { autoExternal, cwd, userExternals } = options;
     let pkgJson;
     try {
-        const content = external_node_fs_namespaceObject["default"].readFileSync((0,external_node_path_namespaceObject.join)(cwd, 'package.json'), 'utf-8');
+        const content = external_node_fs_namespaceObject["default"].readFileSync((0, external_node_path_namespaceObject.join)(cwd, 'package.json'), 'utf-8');
         pkgJson = JSON.parse(content);
     } catch (err) {
         core_namespaceObject.logger.warn('The type of third-party packages will not be bundled due to read package.json failed');
@@ -90,7 +49,7 @@ const calcBundledPackages = (options)=>{
         dependencies: true,
         peerDependencies: true,
         devDependencies: false,
-        ...autoExternal === true ? {} : autoExternal
+        ...true === autoExternal ? {} : autoExternal
     } : {
         dependencies: false,
         peerDependencies: false,
@@ -99,20 +58,12 @@ const calcBundledPackages = (options)=>{
     // User externals should not bundled
     // Only handle the case where the externals type is string / (string | RegExp)[] / plain object, function type is too complex.
     const getUserExternalsKeys = (value)=>{
-        if (!value) {
-            return [];
-        }
-        if (typeof value === 'string' || value instanceof RegExp) {
-            return [
-                value
-            ];
-        }
-        if (Array.isArray(value)) {
-            return value.flatMap((v)=>getUserExternalsKeys(v));
-        }
-        if (isObject(userExternals)) {
-            return Object.keys(userExternals);
-        }
+        if (!value) return [];
+        if ('string' == typeof value || value instanceof RegExp) return [
+            value
+        ];
+        if (Array.isArray(value)) return value.flatMap((v)=>getUserExternalsKeys(v));
+        if (isObject(userExternals)) return Object.keys(userExternals);
         return [];
     };
     const externals = getUserExternalsKeys(userExternals);
@@ -124,43 +75,39 @@ const calcBundledPackages = (options)=>{
     ]){
         const deps = pkgJson[type] && Object.keys(pkgJson[type]);
         if (deps) {
-            if (externalOptions[type]) {
-                externals.push(...deps);
-            }
+            if (externalOptions[type]) externals.push(...deps);
             allDeps.push(...deps);
         }
     }
-    const bundledPackages = allDeps.filter((d)=>!externals.some((e)=>typeof e === 'string' ? d === e : e.test(d)));
+    const bundledPackages = allDeps.filter((d)=>!externals.some((e)=>'string' == typeof e ? d === e : e.test(d)));
     return Array.from(new Set(bundledPackages));
 };
 async function generateDts(data) {
-    const { bundle, distPath, dtsEntry, tsconfigPath, name, cwd, isWatch, dtsExtension = '.d.ts', autoExternal = true, userExternals } = data;
+    const { bundle, distPath, dtsEntry, tsconfigPath, name, cwd, isWatch, dtsExtension = '.d.ts', autoExternal = true, userExternals, banner, footer } = data;
     core_namespaceObject.logger.start(`Generating DTS... ${external_picocolors_namespaceObject["default"].gray(`(${name})`)}`);
     const configPath = external_typescript_namespaceObject["default"].findConfigFile(cwd, external_typescript_namespaceObject["default"].sys.fileExists, tsconfigPath);
     if (!configPath) {
         core_namespaceObject.logger.error(`tsconfig.json not found in ${cwd}`);
         throw new Error();
     }
-    const { options: rawCompilerOptions, fileNames } = (0,external_utils_js_namespaceObject.loadTsconfig)(configPath);
-    const rootDir = rawCompilerOptions.rootDir ?? await (0,external_utils_js_namespaceObject.calcLongestCommonPath)(fileNames) ?? (0,external_node_path_namespaceObject.dirname)(configPath);
+    const { options: rawCompilerOptions, fileNames } = (0, external_utils_js_namespaceObject.loadTsconfig)(configPath);
+    const rootDir = rawCompilerOptions.rootDir ?? await (0, external_utils_js_namespaceObject.calcLongestCommonPath)(fileNames) ?? (0, external_node_path_namespaceObject.dirname)(configPath);
     const outDir = distPath ? distPath : rawCompilerOptions.declarationDir || './dist';
     const getDeclarationDir = (bundle, distPath)=>{
-        if (bundle) {
-            return (0,external_utils_js_namespaceObject.ensureTempDeclarationDir)(cwd);
-        }
+        if (bundle) return (0, external_utils_js_namespaceObject.ensureTempDeclarationDir)(cwd);
         return distPath ? distPath : rawCompilerOptions.declarationDir ?? './dist';
     };
     const declarationDir = getDeclarationDir(bundle, distPath);
     const { name: entryName, path: entryPath } = dtsEntry;
     let entry = '';
-    if (bundle === true && entryPath) {
-        const entrySourcePath = (0,external_node_path_namespaceObject.isAbsolute)(entryPath) ? entryPath : (0,external_node_path_namespaceObject.join)(cwd, entryPath);
-        const relativePath = (0,external_node_path_namespaceObject.relative)(rootDir, (0,external_node_path_namespaceObject.dirname)(entrySourcePath));
-        entry = (0,external_node_path_namespaceObject.join)(declarationDir, relativePath, (0,external_node_path_namespaceObject.basename)(entrySourcePath)).replace(/\.(js|mjs|jsx|ts|mts|tsx|cjs|cts|cjsx|ctsx|mjsx|mtsx)$/, '.d.ts');
+    if (true === bundle && entryPath) {
+        const entrySourcePath = (0, external_node_path_namespaceObject.isAbsolute)(entryPath) ? entryPath : (0, external_node_path_namespaceObject.join)(cwd, entryPath);
+        const relativePath = (0, external_node_path_namespaceObject.relative)(rootDir, (0, external_node_path_namespaceObject.dirname)(entrySourcePath));
+        entry = (0, external_node_path_namespaceObject.join)(declarationDir, relativePath, (0, external_node_path_namespaceObject.basename)(entrySourcePath)).replace(/\.(js|mjs|jsx|ts|mts|tsx|cjs|cts|cjsx|ctsx|mjsx|mtsx)$/, '.d.ts');
     }
     const bundleDtsIfNeeded = async ()=>{
-        if (bundle === true) {
-            const { bundleDts } = await Promise.resolve(/* import() */ ).then(__webpack_require__.bind(__webpack_require__, "./apiExtractor"));
+        if (true === bundle) {
+            const { bundleDts } = await Promise.resolve().then(__webpack_require__.bind(__webpack_require__, "./apiExtractor"));
             await bundleDts({
                 name,
                 cwd,
@@ -171,6 +118,8 @@ async function generateDts(data) {
                 },
                 tsconfigPath,
                 dtsExtension,
+                banner,
+                footer,
                 bundledPackages: calcBundledPackages({
                     autoExternal,
                     cwd,
@@ -180,25 +129,21 @@ async function generateDts(data) {
         }
     };
     const onComplete = async (isSuccess)=>{
-        if (isSuccess) {
-            await bundleDtsIfNeeded();
-        }
+        if (isSuccess) await bundleDtsIfNeeded();
     };
-    await (0,external_tsc_js_namespaceObject.emitDts)({
+    await (0, external_tsc_js_namespaceObject.emitDts)({
         name,
         cwd,
         configPath,
         declarationDir,
-        dtsExtension
+        dtsExtension,
+        banner,
+        footer
     }, onComplete, bundle, isWatch);
-    if (!isWatch) {
-        await bundleDtsIfNeeded();
-    }
+    if (!isWatch) await bundleDtsIfNeeded();
 }
 process.on('message', async (data)=>{
-    if (!data.cwd) {
-        return;
-    }
+    if (!data.cwd) return;
     try {
         await generateDts(data);
     } catch (e) {
@@ -207,9 +152,6 @@ process.on('message', async (data)=>{
         process.exit(1);
     }
     process.send('success');
-    if (!data.isWatch) {
-        process.exit();
-    }
+    if (!data.isWatch) process.exit();
 });
-
 export { calcBundledPackages, generateDts };

package/dist/index.d.ts

@@ -9,6 +9,8 @@ export type PluginDtsOptions = {
         devDependencies?: boolean;
         peerDependencies?: boolean;
     };
+    banner?: string;
+    footer?: string;
 };
 export type DtsEntry = {
     name?: string;

package/dist/index.js

@@ -1,33 +1,15 @@
-import {fileURLToPath as __webpack_fileURLToPath__} from "url";
-import {dirname as __webpack_dirname__} from "path";
+import { fileURLToPath as __webpack_fileURLToPath__ } from "url";
+import { dirname as __webpack_dirname__ } from "path";
 import * as __WEBPACK_EXTERNAL_MODULE_node_child_process__ from "node:child_process";
 import * as __WEBPACK_EXTERNAL_MODULE_node_path__ from "node:path";
 import * as __WEBPACK_EXTERNAL_MODULE__rsbuild_core__ from "@rsbuild/core";
 import * as __WEBPACK_EXTERNAL_MODULE__utils_js__ from "./utils.js";
-
-;// CONCATENATED MODULE: external "node:child_process"
-
 var external_node_child_process_namespaceObject = __WEBPACK_EXTERNAL_MODULE_node_child_process__;
-
-;// CONCATENATED MODULE: external "node:path"
-
 var external_node_path_namespaceObject = __WEBPACK_EXTERNAL_MODULE_node_path__;
-
-;// CONCATENATED MODULE: external "@rsbuild/core"
-
 var core_namespaceObject = __WEBPACK_EXTERNAL_MODULE__rsbuild_core__;
-
-;// CONCATENATED MODULE: external "./utils.js"
-
 var external_utils_js_namespaceObject = __WEBPACK_EXTERNAL_MODULE__utils_js__;
-
-;// CONCATENATED MODULE: ./src/index.ts
 var src_filename = __webpack_fileURLToPath__(import.meta.url);
 var src_dirname = __webpack_dirname__(__webpack_fileURLToPath__(import.meta.url));
-
-
-
-
 const PLUGIN_DTS_NAME = 'rsbuild:dts';
 // use ts compiler API to generate bundleless dts
 // use ts compiler API and api-extractor to generate dts bundle
@@ -41,18 +23,16 @@ const pluginDts = (options)=>({
             const dtsPromises = [];
             let promisesResult = [];
             api.onBeforeEnvironmentCompile(({ isWatch, isFirstCompile, environment })=>{
-                if (!isFirstCompile) {
-                    return;
-                }
+                if (!isFirstCompile) return;
                 const { config } = environment;
                 options.distPath = options.distPath ?? config.output?.distPath?.root;
-                const jsExtension = (0,external_node_path_namespaceObject.extname)(src_filename);
-                const childProcess = (0,external_node_child_process_namespaceObject.fork)((0,external_node_path_namespaceObject.join)(src_dirname, `./dts${jsExtension}`), [], {
+                const jsExtension = (0, external_node_path_namespaceObject.extname)(src_filename);
+                const childProcess = (0, external_node_child_process_namespaceObject.fork)((0, external_node_path_namespaceObject.join)(src_dirname, `./dts${jsExtension}`), [], {
                     stdio: 'inherit'
                 });
                 // TODO: @microsoft/api-extractor only support single entry to bundle DTS
                 // use first element of Record<string, string> type entry config
-                const dtsEntry = (0,external_utils_js_namespaceObject.processSourceEntry)(options.bundle, config.source?.entry);
+                const dtsEntry = (0, external_utils_js_namespaceObject.processSourceEntry)(options.bundle, config.source?.entry);
                 const dtsGenOptions = {
                     ...options,
                     dtsEntry,
@@ -65,43 +45,31 @@ const pluginDts = (options)=>({
                 childProcess.send(dtsGenOptions);
                 dtsPromises.push(new Promise((resolve)=>{
                     childProcess.on('message', (message)=>{
-                        if (message === 'success') {
-                            resolve({
-                                status: 'success'
-                            });
-                        } else if (message === 'error') {
-                            resolve({
-                                status: 'error',
-                                errorMessage: `Error occurred in ${environment.name} DTS generation`
-                            });
-                        }
+                        if ('success' === message) resolve({
+                            status: 'success'
+                        });
+                        else if ('error' === message) resolve({
+                            status: 'error',
+                            errorMessage: `Error occurred in ${environment.name} DTS generation`
+                        });
                     });
                 }));
             });
             api.onAfterBuild(async ({ isFirstCompile })=>{
-                if (!isFirstCompile) {
-                    return;
-                }
+                if (!isFirstCompile) return;
                 promisesResult = await Promise.all(dtsPromises);
             });
             api.onAfterBuild({
                 handler: ({ isFirstCompile })=>{
-                    if (!isFirstCompile) {
-                        return;
-                    }
-                    for (const result of promisesResult){
-                        if (result.status === 'error') {
-                            if (options.abortOnError) {
-                                throw new Error(result.errorMessage);
-                            }
-                            result.errorMessage && core_namespaceObject.logger.error(result.errorMessage);
-                            core_namespaceObject.logger.warn('With the `abortOnError` configuration currently turned off, type errors do not cause build failures, but they do not guarantee proper type file output.');
-                        }
+                    if (!isFirstCompile) return;
+                    for (const result of promisesResult)if ('error' === result.status) {
+                        if (options.abortOnError) throw new Error(result.errorMessage);
+                        result.errorMessage && core_namespaceObject.logger.error(result.errorMessage);
+                        core_namespaceObject.logger.warn('With the `abortOnError` configuration currently turned off, type errors do not cause build failures, but they do not guarantee proper type file output.');
                     }
                 },
                 order: 'post'
             });
         }
     });
-
 export { PLUGIN_DTS_NAME, pluginDts };

package/dist/tsc.d.ts

@@ -4,5 +4,7 @@ export type EmitDtsOptions = {
     configPath: string;
     declarationDir: string;
     dtsExtension: string;
+    banner?: string;
+    footer?: string;
 };
 export declare function emitDts(options: EmitDtsOptions, onComplete: (isSuccess: boolean) => void, bundle?: boolean, isWatch?: boolean): Promise<void>;

package/dist/tsc.js

@@ -2,32 +2,14 @@ import * as __WEBPACK_EXTERNAL_MODULE__rsbuild_core__ 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__ from "./utils.js";
-
-;// CONCATENATED MODULE: external "@rsbuild/core"
-
 var core_namespaceObject = __WEBPACK_EXTERNAL_MODULE__rsbuild_core__;
-
-;// CONCATENATED MODULE: external "picocolors"
-
 var external_picocolors_namespaceObject = __WEBPACK_EXTERNAL_MODULE_picocolors__;
-
-;// CONCATENATED MODULE: external "typescript"
-
 var external_typescript_namespaceObject = __WEBPACK_EXTERNAL_MODULE_typescript__;
-
-;// CONCATENATED MODULE: external "./utils.js"
-
 var external_utils_js_namespaceObject = __WEBPACK_EXTERNAL_MODULE__utils_js__;
-
-;// CONCATENATED MODULE: ./src/tsc.ts
-
-
-
-
 async function emitDts(options, onComplete, bundle = false, isWatch = false) {
     const start = Date.now();
-    const { configPath, declarationDir, name, dtsExtension } = options;
-    const { options: rawCompilerOptions, fileNames } = (0,external_utils_js_namespaceObject.loadTsconfig)(configPath);
+    const { configPath, declarationDir, name, dtsExtension, banner, footer } = options;
+    const { options: rawCompilerOptions, fileNames } = (0, external_utils_js_namespaceObject.loadTsconfig)(configPath);
     const compilerOptions = {
         ...rawCompilerOptions,
         noEmit: false,
@@ -35,27 +17,7 @@ async function emitDts(options, onComplete, bundle = false, isWatch = false) {
         declarationDir,
         emitDeclarationOnly: true
     };
-    if (!isWatch) {
-        const host = external_typescript_namespaceObject["default"].createCompilerHost(compilerOptions);
-        const program = external_typescript_namespaceObject["default"].createProgram(fileNames, compilerOptions, host);
-        const emitResult = program.emit();
-        const allDiagnostics = external_typescript_namespaceObject["default"].getPreEmitDiagnostics(program).concat(emitResult.diagnostics);
-        const diagnosticMessages = [];
-        for (const diagnostic of allDiagnostics){
-            const fileLoc = (0,external_utils_js_namespaceObject.getFileLoc)(diagnostic);
-            const message = `${fileLoc} - ${external_picocolors_namespaceObject["default"].red('error')} ${external_picocolors_namespaceObject["default"].gray(`TS${diagnostic.code}:`)} ${external_typescript_namespaceObject["default"].flattenDiagnosticMessageText(diagnostic.messageText, host.getNewLine())}`;
-            diagnosticMessages.push(message);
-        }
-        await (0,external_utils_js_namespaceObject.processDtsFiles)(bundle, declarationDir, dtsExtension);
-        if (diagnosticMessages.length) {
-            core_namespaceObject.logger.error(`Failed to emit declaration files. ${external_picocolors_namespaceObject["default"].gray(`(${name})`)}`);
-            for (const message of diagnosticMessages){
-                core_namespaceObject.logger.error(message);
-            }
-            throw new Error('DTS generation failed');
-        }
-        core_namespaceObject.logger.ready(`DTS generated in ${(0,external_utils_js_namespaceObject.getTimeCost)(start)} ${external_picocolors_namespaceObject["default"].gray(`(${name})`)}`);
-    } else {
+    if (isWatch) {
         const createProgram = external_typescript_namespaceObject["default"].createSemanticDiagnosticsBuilderProgram;
         const formatHost = {
             getCanonicalFileName: (path)=>path,
@@ -63,30 +25,26 @@ async function emitDts(options, onComplete, bundle = false, isWatch = false) {
             getNewLine: ()=>external_typescript_namespaceObject["default"].sys.newLine
         };
         const reportDiagnostic = (diagnostic)=>{
-            const fileLoc = (0,external_utils_js_namespaceObject.getFileLoc)(diagnostic);
+            const fileLoc = (0, external_utils_js_namespaceObject.getFileLoc)(diagnostic);
             core_namespaceObject.logger.error(`${fileLoc} - ${external_picocolors_namespaceObject["default"].red('error')} ${external_picocolors_namespaceObject["default"].gray(`TS${diagnostic.code}:`)}`, external_typescript_namespaceObject["default"].flattenDiagnosticMessageText(diagnostic.messageText, formatHost.getNewLine()));
         };
         const reportWatchStatusChanged = async (diagnostic, _newLine, _options, errorCount)=>{
             const message = `${external_typescript_namespaceObject["default"].flattenDiagnosticMessageText(diagnostic.messageText, formatHost.getNewLine())} ${external_picocolors_namespaceObject["default"].gray(`(${name})`)}`;
             // 6031: File change detected. Starting incremental compilation...
             // 6032: Starting compilation in watch mode...
-            if (diagnostic.code === 6031 || diagnostic.code === 6032) {
-                core_namespaceObject.logger.info(message);
-            }
+            if (6031 === diagnostic.code || 6032 === diagnostic.code) core_namespaceObject.logger.info(message);
             // 6194: 0 errors or 2+ errors!
-            if (diagnostic.code === 6194) {
-                if (errorCount === 0) {
+            if (6194 === diagnostic.code) {
+                if (0 === errorCount) {
                     core_namespaceObject.logger.info(message);
                     onComplete(true);
-                } else {
-                    core_namespaceObject.logger.error(message);
-                }
-                await (0,external_utils_js_namespaceObject.processDtsFiles)(bundle, declarationDir, dtsExtension);
+                } else core_namespaceObject.logger.error(message);
+                await (0, external_utils_js_namespaceObject.processDtsFiles)(bundle, declarationDir, dtsExtension, banner, footer);
             }
             // 6193: 1 error
-            if (diagnostic.code === 6193) {
+            if (6193 === diagnostic.code) {
                 core_namespaceObject.logger.error(message);
-                await (0,external_utils_js_namespaceObject.processDtsFiles)(bundle, declarationDir, dtsExtension);
+                await (0, external_utils_js_namespaceObject.processDtsFiles)(bundle, declarationDir, dtsExtension, banner, footer);
             }
         };
         const system = {
@@ -94,7 +52,24 @@ async function emitDts(options, onComplete, bundle = false, isWatch = false) {
         };
         const host = external_typescript_namespaceObject["default"].createWatchCompilerHost(configPath, compilerOptions, system, createProgram, reportDiagnostic, reportWatchStatusChanged);
         external_typescript_namespaceObject["default"].createWatchProgram(host);
+    } else {
+        const host = external_typescript_namespaceObject["default"].createCompilerHost(compilerOptions);
+        const program = external_typescript_namespaceObject["default"].createProgram(fileNames, compilerOptions, host);
+        const emitResult = program.emit();
+        const allDiagnostics = external_typescript_namespaceObject["default"].getPreEmitDiagnostics(program).concat(emitResult.diagnostics);
+        const diagnosticMessages = [];
+        for (const diagnostic of allDiagnostics){
+            const fileLoc = (0, external_utils_js_namespaceObject.getFileLoc)(diagnostic);
+            const message = `${fileLoc} - ${external_picocolors_namespaceObject["default"].red('error')} ${external_picocolors_namespaceObject["default"].gray(`TS${diagnostic.code}:`)} ${external_typescript_namespaceObject["default"].flattenDiagnosticMessageText(diagnostic.messageText, host.getNewLine())}`;
+            diagnosticMessages.push(message);
+        }
+        await (0, external_utils_js_namespaceObject.processDtsFiles)(bundle, declarationDir, dtsExtension, banner, footer);
+        if (diagnosticMessages.length) {
+            core_namespaceObject.logger.error(`Failed to emit declaration files. ${external_picocolors_namespaceObject["default"].gray(`(${name})`)}`);
+            for (const message of diagnosticMessages)core_namespaceObject.logger.error(message);
+            throw new Error('DTS generation failed');
+        }
+        core_namespaceObject.logger.ready(`DTS generated in ${(0, external_utils_js_namespaceObject.getTimeCost)(start)} ${external_picocolors_namespaceObject["default"].gray(`(${name})`)}`);
     }
 }
-
 export { emitDts };

package/dist/utils.d.ts

@@ -8,6 +8,7 @@ export declare function ensureTempDeclarationDir(cwd: string): string;
 export declare function getFileLoc(diagnostic: ts.Diagnostic): string;
 export declare const prettyTime: (seconds: number) => string;
 export declare function getTimeCost(start: number): string;
-export declare function processDtsFiles(bundle: boolean, dir: string, dtsExtension: string): Promise<void>;
+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 processSourceEntry(bundle: boolean, entryConfig: NonNullable<RsbuildConfig['source']>['entry']): DtsEntry;
 export declare function calcLongestCommonPath(absPaths: string[]): Promise<string | null>;

package/dist/utils.js

@@ -4,50 +4,18 @@ import * as __WEBPACK_EXTERNAL_MODULE_node_os__ from "node:os";
 import * as __WEBPACK_EXTERNAL_MODULE_node_path__ from "node:path";
 import * as __WEBPACK_EXTERNAL_MODULE__rsbuild_core__ from "@rsbuild/core";
 import * as __WEBPACK_EXTERNAL_MODULE_fast_glob__ from "fast-glob";
+import * as __WEBPACK_EXTERNAL_MODULE_magic_string__ from "magic-string";
 import * as __WEBPACK_EXTERNAL_MODULE_picocolors__ from "picocolors";
 import * as __WEBPACK_EXTERNAL_MODULE_typescript__ from "typescript";
-
-;// CONCATENATED MODULE: external "node:fs"
-
 var external_node_fs_namespaceObject = __WEBPACK_EXTERNAL_MODULE_node_fs__;
-
-;// CONCATENATED MODULE: external "node:fs/promises"
-
 var promises_namespaceObject = __WEBPACK_EXTERNAL_MODULE_node_fs_promises__;
-
-;// CONCATENATED MODULE: external "node:os"
-
 var external_node_os_namespaceObject = __WEBPACK_EXTERNAL_MODULE_node_os__;
-
-;// CONCATENATED MODULE: external "node:path"
-
 var external_node_path_namespaceObject = __WEBPACK_EXTERNAL_MODULE_node_path__;
-
-;// CONCATENATED MODULE: external "@rsbuild/core"
-
 var core_namespaceObject = __WEBPACK_EXTERNAL_MODULE__rsbuild_core__;
-
-;// CONCATENATED MODULE: external "fast-glob"
-
 var external_fast_glob_namespaceObject = __WEBPACK_EXTERNAL_MODULE_fast_glob__;
-
-;// CONCATENATED MODULE: external "picocolors"
-
+var external_magic_string_namespaceObject = __WEBPACK_EXTERNAL_MODULE_magic_string__;
 var external_picocolors_namespaceObject = __WEBPACK_EXTERNAL_MODULE_picocolors__;
-
-;// CONCATENATED MODULE: external "typescript"
-
 var external_typescript_namespaceObject = __WEBPACK_EXTERNAL_MODULE_typescript__;
-
-;// CONCATENATED MODULE: ./src/utils.ts
-
-
-
-
-
-
-
-
 const { convertPathToPattern } = external_fast_glob_namespaceObject["default"];
 function loadTsconfig(tsconfigPath) {
     const configFile = external_typescript_namespaceObject["default"].readConfigFile(tsconfigPath, external_typescript_namespaceObject["default"].sys.readFile);
@@ -58,9 +26,7 @@ const TEMP_FOLDER = '.rslib';
 const TEMP_DTS_DIR = `${TEMP_FOLDER}/declarations`;
 function ensureTempDeclarationDir(cwd) {
     const dirPath = external_node_path_namespaceObject["default"].join(cwd, TEMP_DTS_DIR);
-    if (external_node_fs_namespaceObject["default"].existsSync(dirPath)) {
-        return dirPath;
-    }
+    if (external_node_fs_namespaceObject["default"].existsSync(dirPath)) return dirPath;
     external_node_fs_namespaceObject["default"].mkdirSync(dirPath, {
         recursive: true
     });
@@ -81,58 +47,53 @@ const prettyTime = (seconds)=>{
         const digits = seconds >= 0.01 ? 2 : 3;
         return `${format(seconds.toFixed(digits))} s`;
     }
-    if (seconds < 60) {
-        return `${format(seconds.toFixed(1))} s`;
-    }
+    if (seconds < 60) return `${format(seconds.toFixed(1))} s`;
     const minutes = seconds / 60;
     return `${format(minutes.toFixed(2))} m`;
 };
 // fast-glob only accepts posix path
 // https://github.com/mrmlnc/fast-glob#convertpathtopatternpath
 const convertPath = (path)=>{
-    if ((0,external_node_os_namespaceObject.platform)() === 'win32') {
-        return convertPathToPattern(path);
-    }
+    if ('win32' === (0, external_node_os_namespaceObject.platform)()) return convertPathToPattern(path);
     return path;
 };
 function getTimeCost(start) {
     const second = (Date.now() - start) / 1000;
     return prettyTime(second);
 }
-async function processDtsFiles(bundle, dir, dtsExtension) {
-    if (bundle) {
-        return;
-    }
-    const dtsFiles = await (0,external_fast_glob_namespaceObject["default"])(convertPath((0,external_node_path_namespaceObject.join)(dir, '/**/*.d.ts')));
-    for (const file of dtsFiles){
-        try {
-            const newFile = file.replace('.d.ts', dtsExtension);
-            external_node_fs_namespaceObject["default"].renameSync(file, newFile);
-        } catch (error) {
-            core_namespaceObject.logger.error(`Error renaming DTS file ${file}: ${error}`);
-        }
+async function addBannerAndFooter(file, banner, footer) {
+    if (!banner && !footer) return;
+    const content = await promises_namespaceObject["default"].readFile(file, 'utf-8');
+    const code = new external_magic_string_namespaceObject["default"](content);
+    banner && code.prepend(`${banner}\n`);
+    footer && code.append(`\n${footer}\n`);
+    await promises_namespaceObject["default"].writeFile(file, code.toString());
+}
+async function processDtsFiles(bundle, dir, dtsExtension, banner, footer) {
+    if (bundle) return;
+    const dtsFiles = await (0, external_fast_glob_namespaceObject["default"])(convertPath((0, external_node_path_namespaceObject.join)(dir, '/**/*.d.ts')));
+    for (const file of dtsFiles)try {
+        await addBannerAndFooter(file, banner, footer);
+        const newFile = file.replace('.d.ts', dtsExtension);
+        external_node_fs_namespaceObject["default"].renameSync(file, newFile);
+    } catch (error) {
+        core_namespaceObject.logger.error(`Error renaming DTS file ${file}: ${error}`);
     }
 }
 function processSourceEntry(bundle, entryConfig) {
-    if (!bundle) {
-        return {
-            name: undefined,
-            path: undefined
-        };
-    }
-    if (entryConfig && Object.values(entryConfig).every((val)=>typeof val === 'string')) {
-        return {
-            name: Object.keys(entryConfig)[0],
-            path: Object.values(entryConfig)[0]
-        };
-    }
+    if (!bundle) return {
+        name: void 0,
+        path: void 0
+    };
+    if (entryConfig && Object.values(entryConfig).every((val)=>'string' == typeof val)) return {
+        name: Object.keys(entryConfig)[0],
+        path: Object.values(entryConfig)[0]
+    };
     throw new Error('@microsoft/api-extractor only support single entry of Record<string, string> type to bundle DTS, please check your entry config.');
 }
 // same as @rslib/core, we should extract into a single published package to share
 async function calcLongestCommonPath(absPaths) {
-    if (absPaths.length === 0) {
-        return null;
-    }
+    if (0 === absPaths.length) return null;
     // we support two cases
     // 1. /packages-a/src/index.ts
     // 2. D:/packages-a/src/index.ts
@@ -143,17 +104,12 @@ async function calcLongestCommonPath(absPaths) {
         const currentPath = splitPaths[i];
         const minLength = Math.min(lcaFragments.length, currentPath.length);
         let j = 0;
-        while(j < minLength && lcaFragments[j] === currentPath[j]){
-            j++;
-        }
+        while(j < minLength && lcaFragments[j] === currentPath[j])j++;
         lcaFragments = lcaFragments.slice(0, j);
     }
     let lca = lcaFragments.length > 0 ? lcaFragments.join(sep) : sep;
     const stats = await promises_namespaceObject["default"].stat(lca);
-    if (stats?.isFile()) {
-        lca = external_node_path_namespaceObject["default"].dirname(lca);
-    }
+    if (stats?.isFile()) lca = external_node_path_namespaceObject["default"].dirname(lca);
     return lca;
 }
-
-export { TEMP_DTS_DIR, TEMP_FOLDER, calcLongestCommonPath, ensureTempDeclarationDir, getFileLoc, getTimeCost, loadTsconfig, prettyTime, processDtsFiles, processSourceEntry };
+export { TEMP_DTS_DIR, TEMP_FOLDER, addBannerAndFooter, calcLongestCommonPath, ensureTempDeclarationDir, getFileLoc, getTimeCost, loadTsconfig, prettyTime, processDtsFiles, processSourceEntry };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rsbuild-plugin-dts",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "Dts plugin for Rsbuild",
   "homepage": "https://rslib.dev",
   "bugs": {
@@ -26,12 +26,13 @@
   ],
   "dependencies": {
     "fast-glob": "^3.3.2",
-    "picocolors": "1.0.1"
+    "magic-string": "^0.30.11",
+    "picocolors": "1.1.0"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.47.5",
-    "@rsbuild/core": "1.0.1-beta.16",
-    "rslib": "npm:@rslib/core@0.0.2",
+    "@microsoft/api-extractor": "^7.47.7",
+    "@rsbuild/core": "1.0.1-rc.4",
+    "rslib": "npm:@rslib/core@0.0.4",
     "typescript": "^5.5.4",
     "@rslib/tsconfig": "0.0.1"
   },