feat: bump rslog to support customize logger

e2e/cases/javascript-api/custom-logger/index.test.ts

@@ -0,0 +1,17 @@
+import { expect } from '@playwright/test';
+import { build } from '@scripts/shared';
+import { rspackOnlyTest, proxyConsole } from '@scripts/helper';
+
+rspackOnlyTest('should allow to customize logger', async () => {
+  const { logs, restore } = proxyConsole('log');
+
+  await build({
+    cwd: __dirname,
+  });
+
+  expect(
+    logs.find((item) => item.includes('[READY] Client compiled in')),
+  ).toBeTruthy();
+
+  restore();
+});

e2e/cases/javascript-api/custom-logger/rsbuild.config.ts

@@ -0,0 +1,22 @@
+import { logger, defineConfig } from '@rsbuild/core';
+
+const defaultReady = logger.ready;
+
+logger.override({
+  ready: (message) => {
+    console.log(`[READY] ${message}`);
+  },
+});
+
+export default defineConfig({
+  plugins: [
+    {
+      name: 'restore-logger',
+      setup(api) {
+        api.onAfterBuild(() => {
+          logger.ready = defaultReady;
+        });
+      },
+    },
+  ],
+});

e2e/cases/javascript-api/custom-logger/src/index.js

@@ -0,0 +1 @@
+console.log('1');

packages/create-rsbuild/package.json

@@ -28,7 +28,7 @@
   },
   "dependencies": {
     "@clack/prompts": "^0.7.0",
-    "rslog": "^1.1.3"
+    "rslog": "^1.2.0"
   },
   "devDependencies": {
     "@types/node": "16.x",

packages/document/docs/en/api/javascript-api/core.mdx

@@ -175,3 +175,42 @@ logger.debug('This is a debug message');
 // Same as console.log
 logger.log('This is a log message');
 ```
+
+### Custom Logger
+
+You can use the `logger.override` method to override partial or all methods of the default logger:
+
+```ts
+import { logger } from '@rsbuild/core';
+
+logger.override({
+  log: (message) => {
+    console.log(`[log] ${message}`);
+  },
+  info: (message) => {
+    console.log(`[info] ${message}`);
+  },
+  warn: (message) => {
+    console.warn(`[warn] ${message}`);
+  },
+  start: (message) => {
+    console.log(`[start] ${message}`);
+  },
+  ready: (message) => {
+    console.log(`[ready] ${message}`);
+  },
+  error: (message) => {
+    console.error(`[error] ${message}`);
+  },
+  success: (message) => {
+    console.error(`[success] ${message}`);
+  },
+  debug: (message) => {
+    if (process.env.DEBUG) {
+      console.log(`[debug] ${message}`);
+    }
+  },
+});
+
+logger.info('hello'); // [info] hello
+```

packages/document/docs/zh/api/javascript-api/core.mdx

@@ -175,3 +175,42 @@ logger.debug('This is a debug message');
 // Same as console.log
 logger.log('This is a log message');
 ```
+
+### 自定义 Logger
+
+你可以使用 `logger.override` 方法来覆盖默认 logger 的部分或全部方法：
+
+```ts
+import { logger } from '@rsbuild/core';
+
+logger.override({
+  log: (message) => {
+    console.log(`[log] ${message}`);
+  },
+  info: (message) => {
+    console.log(`[info] ${message}`);
+  },
+  warn: (message) => {
+    console.warn(`[warn] ${message}`);
+  },
+  start: (message) => {
+    console.log(`[start] ${message}`);
+  },
+  ready: (message) => {
+    console.log(`[ready] ${message}`);
+  },
+  error: (message) => {
+    console.error(`[error] ${message}`);
+  },
+  success: (message) => {
+    console.error(`[success] ${message}`);
+  },
+  debug: (message) => {
+    if (process.env.DEBUG) {
+      console.log(`[debug] ${message}`);
+    }
+  },
+});
+
+logger.info('hello'); // [info] hello
+```

packages/shared/compiled/rslog/dist/index.d.ts

@@ -42,7 +42,7 @@ declare let LOG_TYPES: {
 };
 
 type LogLevel = 'error' | 'warn' | 'info' | 'log' | 'verbose';
-type LogMessage = number | string | unknown | Error | null;
+type LogMessage = unknown;
 interface LogType {
     label?: string;
     level: LogLevel;
@@ -56,6 +56,7 @@ type LogMethods = keyof typeof LOG_TYPES;
 type Logger = Record<LogMethods, LogFunction> & {
     greet: (message: string) => void;
     level: LogLevel;
+    override: (customLogger: Partial<Record<LogMethods, LogFunction>>) => void;
 };
 
 declare let createLogger: (options?: Options) => Logger;

packages/shared/compiled/rslog/package.json

@@ -1 +1 @@
-{"name":"rslog","version":"1.1.3","types":"./dist/index.d.ts","type":"commonjs"}
+{"name":"rslog","version":"1.2.0","types":"./dist/index.d.ts","type":"commonjs"}

scripts/prebundle/package.json

@@ -61,7 +61,7 @@
     "semver": "^7.5.4",
     "style-loader": "3.3.3",
     "toml-loader": "1.0.0",
-    "rslog": "^1.1.3",
+    "rslog": "^1.2.0",
     "sirv": "^2.0.3",
     "webpack-bundle-analyzer": "4.9.0",
     "webpack-chain": "npm:webpack-5-chain@8.0.1",