feat(builder): support custom logger

.changeset/shy-countries-run.md

@@ -0,0 +1,12 @@
+---
+'@modern-js/builder-shared': patch
+'@modern-js/plugin-tailwindcss': patch
+'@modern-js/module-tools-docs': patch
+'@modern-js/main-doc': patch
+'@modern-js/utils': patch
+'@modern-js/doc-core': patch
+---
+
+feat(builder): support custom logger in dev server
+
+feat(builder): 支持自定义 logger

packages/builder/builder-shared/src/devServer.ts

@@ -9,7 +9,7 @@ import type {
 } from './types';
 import type { ModernDevServerOptions, Server } from '@modern-js/server';
 import { merge } from '@modern-js/utils/lodash';
-import { logger, debug } from './logger';
+import { logger as defaultLogger, debug } from './logger';
 import { DEFAULT_PORT } from './constants';
 import { createAsyncHook } from './createHook';
 import { getServerOptions, printServerURLs } from './prodServer';
@@ -95,10 +95,14 @@ export async function startDevServer<
     printURLs = true,
     strictPort = false,
     serverOptions = {},
+    logger: customLogger,
+    getPortSilently,
   }: StartDevServerOptions & {
     defaultPort?: number;
   } = {},
 ) {
+  const logger = customLogger ?? defaultLogger;
+
   logger.info('Starting dev server...');
 
   if (!process.env.NODE_ENV) {
@@ -112,6 +116,7 @@ export async function startDevServer<
 
   const port = await getPort(builderConfig.dev?.port || DEFAULT_PORT, {
     strictPort,
+    slient: getPortSilently,
   });
 
   const host =
@@ -165,7 +170,7 @@ export async function startDevServer<
             }
           }
 
-          await printServerURLs(urls, 'Dev server');
+          await printServerURLs(urls, 'Dev server', logger);
         }
 
         await options.context.hooks.onAfterStartDevServerHook.call({ port });

packages/builder/builder-shared/src/prodServer.ts

@@ -1,5 +1,8 @@
-import prodServer, { type ModernServerOptions } from '@modern-js/prod-server';
-import { logger } from './logger';
+import prodServer, {
+  Logger,
+  type ModernServerOptions,
+} from '@modern-js/prod-server';
+import { logger as defaultLogger } from './logger';
 import { DEFAULT_PORT } from './constants';
 import type {
   BuilderContext,
@@ -32,6 +35,7 @@ export const getServerOptions = (
 export async function printServerURLs(
   urls: Array<{ url: string; label: string }>,
   name = 'Server',
+  logger: Logger = defaultLogger,
 ) {
   const { chalk } = await import('@modern-js/utils');
   let message = `${name} running at:\n\n`;

packages/builder/builder-shared/src/types/provider.ts

@@ -4,6 +4,7 @@ import type { Compiler, MultiCompiler } from 'webpack';
 import type { BuilderMode, CreateBuilderOptions } from './builder';
 import type { Server, ModernDevServerOptions } from '@modern-js/server';
 import type { AddressUrl } from '@modern-js/utils';
+import { Logger } from '@modern-js/prod-server';
 
 export type Bundler = 'webpack' | 'rspack';
 
@@ -12,7 +13,9 @@ export type CreateCompilerOptions = { watch?: boolean };
 export type StartDevServerOptions = {
   compiler?: Compiler | MultiCompiler;
   printURLs?: boolean | ((urls: AddressUrl[]) => AddressUrl[]);
+  logger?: Logger;
   strictPort?: boolean;
+  getPortSilently?: boolean;
   serverOptions?: Partial<Omit<ModernDevServerOptions, 'config'>> & {
     config?: Partial<ModernDevServerOptions['config']>;
   };

packages/toolkit/utils/src/cli/port.ts

@@ -15,9 +15,11 @@ export const getPort = async (
   {
     tryLimits = 20,
     strictPort = false,
+    slient = false,
   }: {
     tryLimits?: number;
     strictPort?: boolean;
+    slient?: boolean;
   } = {},
 ): Promise<number> => {
   if (typeof port === 'string') {
@@ -63,7 +65,7 @@ export const getPort = async (
       throw new Error(
         `Port "${original}" is occupied, please choose another one.`,
       );
-    } else {
+    } else if (!slient) {
       logger.info(
         `Something is already running on port ${original}. ${chalk.yellow(
           `Use port ${port} instead.`,