@rslib/core 0.5.3 → 0.5.5

package/dist/index.js

@@ -89,7 +89,7 @@ function getAbsolutePath(base, filepath) {
 const readPackageJson = (rootPath)=>{
     const pkgJsonPath = __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__["default"].join(rootPath, './package.json');
     if (!__WEBPACK_EXTERNAL_MODULE_node_fs_5ea92f0c__["default"].existsSync(pkgJsonPath)) {
-        __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.warn(`package.json does not exist in the ${rootPath} directory`);
+        __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.warn(`The \`package.json\` file does not exist in the ${rootPath} directory`);
         return;
     }
     try {
@@ -147,7 +147,31 @@ const windowsSlashRegex = /\\/g;
 function normalizeSlash(p) {
     return p.replace(windowsSlashRegex, '/');
 }
-if (process.env.DEBUG) __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.level = 'verbose';
+const isDebug = ()=>{
+    if (!process.env.DEBUG) return false;
+    const values = process.env.DEBUG.toLocaleLowerCase().split(',');
+    return [
+        'rslib',
+        'rs*',
+        'rstack',
+        '*'
+    ].some((key)=>values.includes(key));
+};
+if (isDebug()) __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.level = 'verbose';
+function getTime() {
+    const now = new Date();
+    const hours = String(now.getHours()).padStart(2, '0');
+    const minutes = String(now.getMinutes()).padStart(2, '0');
+    const seconds = String(now.getSeconds()).padStart(2, '0');
+    return `${hours}:${minutes}:${seconds}`;
+}
+__WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.override({
+    debug: (message, ...args)=>{
+        if ('verbose' !== __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.level) return;
+        const time = __WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__["default"].gray(`${getTime()}`);
+        console.log(`  ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__["default"].green('rslib')} ${time} ${message}`, ...args);
+    }
+});
 function initNodeEnv() {
     if (!process.env.NODE_ENV) {
         const command = process.argv[2] ?? '';
@@ -160,7 +184,7 @@ function prepareCli() {
     initNodeEnv();
     const { npm_execpath } = process.env;
     if (!npm_execpath || npm_execpath.includes('npx-cli.js') || npm_execpath.includes('.bun')) console.log();
-    __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.greet(`  Rslib v0.5.3\n`);
+    __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.greet(`  Rslib v0.5.5\n`);
 }
 const DEFAULT_CONFIG_NAME = 'rslib.config';
 const DEFAULT_CONFIG_EXTENSIONS = [
@@ -523,18 +547,20 @@ class EntryChunkPlugin {
     shebangInjectedAssets = new Set();
     enabledImportMetaUrlShim;
     contextToWatch = null;
-    contextWatched = false;
     constructor({ enabledImportMetaUrlShim = true, contextToWatch }){
         this.enabledImportMetaUrlShim = enabledImportMetaUrlShim;
         this.contextToWatch = contextToWatch;
     }
     apply(compiler) {
-        compiler.hooks.afterCompile.tap(EntryChunkPlugin_PLUGIN_NAME, (compilation)=>{
-            if (this.contextWatched || null === this.contextToWatch) return;
-            const contextDep = compilation.contextDependencies;
-            contextDep.add(this.contextToWatch);
-            this.contextWatched = true;
-        });
+        compiler.hooks.afterCompile.tapPromise(EntryChunkPlugin_PLUGIN_NAME, (compilation)=>new Promise((resolve)=>{
+                if (null === this.contextToWatch) {
+                    resolve();
+                    return;
+                }
+                const contextDep = compilation.contextDependencies;
+                if (!contextDep.has(this.contextToWatch)) contextDep.add(this.contextToWatch);
+                resolve();
+            }));
         compiler.hooks.make.tap(EntryChunkPlugin_PLUGIN_NAME, (compilation)=>{
             const entries = {};
             for (const [key, value] of compilation.entries){
@@ -669,7 +695,7 @@ const getDefaultExtension = (options)=>{
         dtsExtension
     };
     if (!pkgJson) {
-        __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.warn('autoExtension configuration will not be applied due to read package.json failed');
+        __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.warn('The `autoExtension` configuration will not be applied due to read package.json failed');
         return {
             jsExtension,
             dtsExtension
@@ -1462,7 +1488,7 @@ const composeExternalsWarnConfig = (format, ...externalsArray)=>{
                     };
                     if (contextInfo.issuer && 'commonjs' === dependencyType) {
                         matchUserExternals(externals, request, _callback);
-                        if (shouldWarn) __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.warn(composeModuleImportWarn(request));
+                        if (shouldWarn) __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.warn(composeModuleImportWarn(request, contextInfo.issuer));
                     }
                     callback();
                 }
@@ -1477,7 +1503,7 @@ const composeAutoExternalConfig = (options)=>{
     const autoExternal = getAutoExternalDefaultValue(format, options.autoExternal);
     if (false === autoExternal) return {};
     if (!pkgJson) {
-        __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.warn('autoExternal configuration will not be applied due to read package.json failed');
+        __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.warn('The `autoExternal` configuration will not be applied due to read package.json failed');
         return {};
     }
     const userExternalKeys = userExternals && isObject(userExternals) ? Object.keys(userExternals) : [];
@@ -1852,7 +1878,7 @@ const composeShimsConfig = (format, shims)=>{
         enabledShims
     };
 };
-const composeModuleImportWarn = (request)=>`The externalized commonjs request ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__["default"].green(`"${request}"`)} will use ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__["default"].blue('"module"')} external type in ESM format. If you want to specify other external type, consider setting the request and type with ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__["default"].blue('"output.externals"')}.`;
+const composeModuleImportWarn = (request, issuer)=>`The externalized commonjs request ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__["default"].green(`"${request}"`)} from ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__["default"].green(issuer)} will use ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__["default"].blue('"module"')} external type in ESM format. If you want to specify other external type, consider setting the request and type with ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__["default"].blue('"output.externals"')}.`;
 const composeExternalsConfig = (format, externals)=>{
     const externalsTypeMap = {
         esm: 'module-import',
@@ -1885,10 +1911,16 @@ const composeAutoExtensionConfig = (config, autoExtension, pkgJson)=>{
         pkgJson,
         autoExtension
     });
+    const filenameHash = config.output?.filenameHash ?? false;
+    const getHash = ()=>{
+        if ('string' == typeof filenameHash) return filenameHash ? `.[${filenameHash}]` : '';
+        return filenameHash ? '.[contenthash:8]' : '';
+    };
+    const hash = getHash();
     const updatedConfig = {
         output: {
             filename: {
-                js: `[name]${jsExtension}`,
+                js: `[name]${hash}${jsExtension}`,
                 ...config.output?.filename
             }
         }
@@ -2238,7 +2270,7 @@ async function composeLibRsbuildConfig(config, root, sharedPlugins) {
 async function composeCreateRsbuildConfig(rslibConfig) {
     const constantRsbuildConfig = await createConstantRsbuildConfig();
     const { lib: libConfigsArray, mode, root, plugins: sharedPlugins, dev, server, ...sharedRsbuildConfig } = rslibConfig;
-    if (!libConfigsArray) throw new Error(`Expect lib field to be an array, but got ${libConfigsArray}.`);
+    if (!Array.isArray(libConfigsArray) || 0 === libConfigsArray.length) throw new Error(`Expect "lib" field to be a non-empty array, but got: ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__["default"].cyan(JSON.stringify(libConfigsArray))}.`);
     const libConfigPromises = libConfigsArray.map(async (libConfig)=>{
         const userConfig = (0, __WEBPACK_EXTERNAL_MODULE__rsbuild_core_1b356efc__.mergeRsbuildConfig)(sharedRsbuildConfig, libConfig);
         const libRsbuildConfig = await composeLibRsbuildConfig(userConfig, root, sharedPlugins);
@@ -2339,8 +2371,8 @@ const beforeRestart = async ({ filePath, clear = true } = {})=>{
     if (clear) clearConsole();
     if (filePath) {
         const filename = __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__["default"].basename(filePath);
-        __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.info(`Restart because ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__["default"].yellow(filename)} is changed.\n`);
-    } else __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.info('Restarting...\n');
+        __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.info(`restart because ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__["default"].yellow(filename)} is changed.\n`);
+    } else __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.info('restarting...\n');
     for (const cleaner of cleaners)await cleaner();
     cleaners = [];
 };
@@ -2449,7 +2481,7 @@ const repeatableOption = (value, previous)=>(previous ?? []).concat([
         value
     ]);
 function runCli() {
-    __WEBPACK_EXTERNAL_MODULE__compiled_commander_index_js_bca3ceaa__.program.name('rslib').usage('<command> [options]').version("0.5.3");
+    __WEBPACK_EXTERNAL_MODULE__compiled_commander_index_js_bca3ceaa__.program.name('rslib').usage('<command> [options]').version("0.5.5");
     const buildCommand = __WEBPACK_EXTERNAL_MODULE__compiled_commander_index_js_bca3ceaa__.program.command('build');
     const inspectCommand = __WEBPACK_EXTERNAL_MODULE__compiled_commander_index_js_bca3ceaa__.program.command('inspect');
     const mfDevCommand = __WEBPACK_EXTERNAL_MODULE__compiled_commander_index_js_bca3ceaa__.program.command('mf-dev');
@@ -2510,6 +2542,6 @@ function runCli() {
     });
     __WEBPACK_EXTERNAL_MODULE__compiled_commander_index_js_bca3ceaa__.program.parse();
 }
-const src_rslib_entry_version = "0.5.3";
+const src_rslib_entry_version = "0.5.5";
 var __webpack_exports__logger = __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger;
 export { build, defineConfig, inspect, loadConfig, prepareCli, runCli, startMFDevServer, composeCreateRsbuildConfig as unstable_composeCreateRsbuildConfig, src_rslib_entry_version as version, __webpack_exports__logger as logger };

package/dist-types/config.d.ts

@@ -27,7 +27,7 @@ export declare function composeMinifyConfig(config: LibConfig): EnvironmentConfi
 export declare function composeBannerFooterConfig(banner: BannerAndFooter, footer: BannerAndFooter): EnvironmentConfig;
 export declare function composeDecoratorsConfig(compilerOptions?: Record<string, any>, version?: NonNullable<NonNullable<EnvironmentConfig['source']>['decorators']>['version']): EnvironmentConfig;
 export declare function createConstantRsbuildConfig(): Promise<EnvironmentConfig>;
-export declare const composeModuleImportWarn: (request: string) => string;
+export declare const composeModuleImportWarn: (request: string, issuer: string) => string;
 export declare const appendEntryQuery: (entries: RsbuildConfigEntry) => RsbuildEntry;
 export declare const resolveEntryPath: (entries: RsbuildConfigEntry, root: string) => RsbuildEntry;
 export declare function composeCreateRsbuildConfig(rslibConfig: RslibConfig): Promise<RsbuildConfigWithLibInfo[]>;

package/dist-types/types/config.d.ts

@@ -1,4 +1,4 @@
-import type { EnvironmentConfig, RsbuildConfig, Rspack } from '@rsbuild/core';
+import type { EnvironmentConfig, OutputConfig, RsbuildConfig, Rspack } from '@rsbuild/core';
 import type { GetAsyncFunctionFromUnion } from './utils';
 export type Format = 'esm' | 'cjs' | 'umd' | 'mf';
 export type FixedEcmaVersions = 'es5' | 'es6' | 'es2015' | 'es2016' | 'es2017' | 'es2018' | 'es2019' | 'es2020' | 'es2021' | 'es2022' | 'es2023';
@@ -16,31 +16,31 @@ export type RsbuildConfigOutputTarget = NonNullable<EnvironmentConfig['output']>
 export type Syntax = EcmaScriptVersion | string[];
 export type Dts = {
     /**
-     * Whether to bundle the DTS files.
+     * Whether to bundle the declaration files.
      * @defaultValue `false`
      * @see {@link https://lib.rsbuild.dev/config/lib/dts#dtsbundle}
      */
     bundle?: boolean;
     /**
-     * The output directory of DTS files.
+     * The output directory of declaration files.
      * @defaultValue {@link https://lib.rsbuild.dev/config/lib/dts#default-value}
      * @see {@link https://lib.rsbuild.dev/config/lib/dts#dtsdistpath}
      */
     distPath?: string;
     /**
-     * Whether to generate DTS files with building the project references.
+     * Whether to generate declaration files with building the project references.
      * @defaultValue `false`
      * @see {@link https://lib.rsbuild.dev/config/lib/dts#dtsbuild}
      */
     build?: boolean;
     /**
-     * Whether to abort the build process when an error occurs during DTS generation.
+     * Whether to abort the build process when an error occurs during declaration files generation.
      * @defaultValue `true`
      * @see {@link https://lib.rsbuild.dev/config/lib/dts#dtsabortonerror}
      */
     abortOnError?: boolean;
     /**
-     * Whether to automatically set the DTS file extension based on the {@link format} option.
+     * Whether to automatically set the declaration file extension based on the {@link format} option.
      * @defaultValue `false`
      * @see {@link https://lib.rsbuild.dev/config/lib/dts#dtsautoextension}
      */
@@ -211,13 +211,13 @@ export interface LibConfig extends EnvironmentConfig {
      */
     externalHelpers?: boolean;
     /**
-     * Inject content into the top of each JavaScript, CSS or DTS file.
+     * Inject content into the top of each JavaScript, CSS or declaration file.
      * @defaultValue `{}`
      * @see {@link https://lib.rsbuild.dev/config/lib/banner}
      */
     banner?: BannerAndFooter;
     /**
-     * Inject content into the bottom of each JavaScript, CSS or DTS file.
+     * Inject content into the bottom of each JavaScript, CSS or declaration file.
      * @defaultValue `{}`
      * @see {@link https://lib.rsbuild.dev/config/lib/footer}
      */
@@ -259,10 +259,38 @@ export interface LibConfig extends EnvironmentConfig {
      * @see {@link https://lib.rsbuild.dev/config/lib/out-base}
      */
     outBase?: string;
+    /**
+     * @inheritdoc
+     */
+    output?: RslibOutputConfig;
 }
 export type LibOnlyConfig = Omit<LibConfig, keyof EnvironmentConfig>;
+interface RslibOutputConfig extends OutputConfig {
+    /**
+     * @override
+     * @default 'node'
+     */
+    target?: OutputConfig['target'];
+    /**
+     * @override
+     * @default false
+     */
+    filenameHash?: OutputConfig['filenameHash'];
+    /**
+     * @override
+     * When minify is not specified, Rslib will use a sane default for minify options.
+     * The default options will only perform dead code elimination and unused code elimination.
+     *
+     * @see {@link https://lib.rsbuild.dev/config/rsbuild/output#outputminify}
+     */
+    minify?: OutputConfig['minify'];
+}
 export interface RslibConfig extends RsbuildConfig {
     lib: LibConfig[];
+    /**
+     * @inheritdoc
+     */
+    output?: RslibOutputConfig;
 }
 export type ConfigParams = {
     env: string;
@@ -272,3 +300,4 @@ export type ConfigParams = {
 export type RslibConfigSyncFn = (env: ConfigParams) => RslibConfig;
 export type RslibConfigAsyncFn = (env: ConfigParams) => Promise<RslibConfig>;
 export type RslibConfigExport = RslibConfig | RslibConfigSyncFn | RslibConfigAsyncFn;
+export {};

package/dist-types/utils/logger.d.ts

@@ -1,5 +1,18 @@
+/**
+ * Logging message case convention:
+ *
+ * Info, ready, success and debug messages:
+ * - Start with lowercase
+ * - Example: "info  build started..."
+ *
+ * Errors and warnings:
+ * - Start with uppercase
+ * - Example: "error  Failed to build"
+ *
+ * This convention helps distinguish between normal operations
+ * and important alerts that require attention.
+ */
 import { type Logger, logger } from '../../compiled/rslog';
 export declare const isDebug: () => boolean;
-export declare const debug: (message: string | (() => string)) => void;
 export { logger };
 export type { Logger };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rslib/core",
-  "version": "0.5.3",
+  "version": "0.5.5",
   "description": "The Rsbuild-based library development tool.",
   "homepage": "https://lib.rsbuild.dev",
   "bugs": {
@@ -36,12 +36,12 @@
     "types.d.ts"
   ],
   "dependencies": {
-    "@rsbuild/core": "~1.2.13",
+    "@rsbuild/core": "~1.2.19",
     "tinyglobby": "^0.2.12",
-    "rsbuild-plugin-dts": "0.5.3"
+    "rsbuild-plugin-dts": "0.5.5"
   },
   "devDependencies": {
-    "@module-federation/rsbuild-plugin": "^0.9.1",
+    "@module-federation/rsbuild-plugin": "^0.11.1",
     "@types/fs-extra": "^11.0.4",
     "chokidar": "^4.0.3",
     "commander": "^13.1.0",
@@ -50,7 +50,7 @@
     "picocolors": "1.1.1",
     "prebundle": "1.2.7",
     "rsbuild-plugin-publint": "^0.3.0",
-    "rslib": "npm:@rslib/core@0.5.2",
+    "rslib": "npm:@rslib/core@0.5.4",
     "rslog": "^1.2.3",
     "tsconfck": "3.1.5",
     "typescript": "^5.8.2",