@rsbuild/core 1.0.1-beta.13 → 1.0.1-beta.15

package/dist-types/helpers/fs.d.ts

@@ -1,3 +1,4 @@
+import type { Rspack } from '../types';
 export declare const isFileSync: (filePath: string) => boolean | undefined;
 export declare function isEmptyDir(path: string): boolean;
 /**
@@ -8,4 +9,5 @@ export declare function isEmptyDir(path: string): boolean;
 export declare const findExists: (files: string[]) => string | false;
 export declare function pathExists(path: string): Promise<boolean>;
 export declare function isFileExists(file: string): Promise<boolean>;
+export declare function fileExistsByCompilation(compilation: Rspack.Compilation, filePath: string): Promise<boolean>;
 export declare function emptyDir(dir: string): Promise<void>;

package/dist-types/helpers/index.d.ts

@@ -19,7 +19,7 @@ export declare const removeTailingSlash: (s: string) => string;
 export declare const addTrailingSlash: (s: string) => string;
 export declare const formatPublicPath: (publicPath: string, withSlash?: boolean) => string;
 export declare const getPublicPathFromChain: (chain: RspackChain, withSlash?: boolean) => string;
-export declare const getPublicPathFromCompiler: (compiler: Rspack.Compiler) => string;
+export declare const getPublicPathFromCompiler: (compiler: Rspack.Compiler | Rspack.Compilation) => string;
 export declare const canParse: (url: string) => boolean;
 export declare const ensureAssetPrefix: (url: string, assetPrefix?: Rspack.PublicPath) => string;
 export declare function getFilename(config: NormalizedConfig | NormalizedEnvironmentConfig, type: 'js', isProd: boolean, isServer?: boolean): NonNullable<FilenameConfig['js']>;

package/dist-types/index.d.ts

@@ -15,7 +15,7 @@ export { logger } from './logger';
 export { mergeRsbuildConfig } from './mergeConfig';
 export { ensureAssetPrefix } from './helpers';
 export { PLUGIN_SWC_NAME, PLUGIN_CSS_NAME } from './constants';
-export type { AliasStrategy, BuildOptions, BundlerPluginInstance, CacheGroup, CacheGroups, ClientConfig, ConfigChain, ConfigChainWithContext, ConsoleType, CreateCompiler, CreateCompilerOptions, CreateRsbuildOptions, ResolvedCreateRsbuildOptions, CrossOrigin, CSSLoaderOptions, CSSModules, CSSModulesLocalsConvention, Decorators, DevConfig, DistPathConfig, EnvironmentContext, EnvironmentConfig, FilenameConfig, HtmlConfig, HtmlRspackPlugin, HtmlBasicTag, HtmlTagHandler, HtmlTagDescriptor, InspectConfigOptions, InspectConfigResult, LegalComments, Minify, ModifyBundlerChainFn, ModifyBundlerChainUtils, ModifyChainUtils, ModifyRspackConfigFn, ModifyRspackConfigUtils, ModifyRsbuildConfigFn, ModifyWebpackChainFn, ModifyWebpackChainUtils, ModifyWebpackConfigUtils, ModuleFederationConfig, MergedEnvironmentConfig, NormalizedConfig, NormalizedDevConfig, NormalizedEnvironmentConfig, NormalizedHtmlConfig, NormalizedModuleFederationConfig, NormalizedOutputConfig, NormalizedPerformanceConfig, NormalizedSecurityConfig, NormalizedServerConfig, NormalizedSourceConfig, NormalizedToolsConfig, OnAfterBuildFn, OnAfterCreateCompilerFn, OnAfterStartDevServerFn, OnAfterStartProdServerFn, OnBeforeBuildFn, OnBeforeCreateCompilerFn, OnBeforeStartDevServerFn, OnBeforeStartProdServerFn, OnCloseDevServerFn, OnDevCompileDoneFn, OnExitFn, OutputConfig, OutputStructure, PerformanceConfig, PluginManager, Polyfill, PostCSSLoaderOptions, PostCSSPlugin, PreconnectOption, PrintUrls, PublicDir, PublicDirOptions, RequestHandler, RsbuildConfig, RsbuildContext, RsbuildEntry, RsbuildInstance, RsbuildMode, RsbuildPlugin, RsbuildPluginAPI, RsbuildPlugins, RsbuildProvider, RsbuildTarget, RspackChain, RspackRule, ScriptInject, ScriptLoading, SecurityConfig, ServerAPIs, ServerConfig, SourceConfig, SplitChunks, StyleLoaderOptions, ToolsConfig, TransformFn, TransformHandler, TransformImport, WatchFiles, } from './types';
+export type { AppIcon, AppIconItem, AliasStrategy, BuildOptions, BundlerPluginInstance, CacheGroup, CacheGroups, ClientConfig, ConfigChain, ConfigChainWithContext, ConsoleType, CreateCompiler, CreateCompilerOptions, CreateRsbuildOptions, ResolvedCreateRsbuildOptions, CrossOrigin, CSSLoaderOptions, CSSModules, CSSModulesLocalsConvention, Decorators, DevConfig, DistPathConfig, EnvironmentContext, EnvironmentConfig, FilenameConfig, HtmlConfig, HtmlRspackPlugin, HtmlBasicTag, HtmlTagHandler, HtmlTagDescriptor, InspectConfigOptions, InspectConfigResult, LegalComments, Minify, ModifyBundlerChainFn, ModifyBundlerChainUtils, ModifyChainUtils, ModifyRspackConfigFn, ModifyRspackConfigUtils, ModifyRsbuildConfigFn, ModifyWebpackChainFn, ModifyWebpackChainUtils, ModifyWebpackConfigUtils, ModuleFederationConfig, MergedEnvironmentConfig, NormalizedConfig, NormalizedDevConfig, NormalizedEnvironmentConfig, NormalizedHtmlConfig, NormalizedModuleFederationConfig, NormalizedOutputConfig, NormalizedPerformanceConfig, NormalizedSecurityConfig, NormalizedServerConfig, NormalizedSourceConfig, NormalizedToolsConfig, OnAfterBuildFn, OnAfterCreateCompilerFn, OnAfterStartDevServerFn, OnAfterStartProdServerFn, OnBeforeBuildFn, OnBeforeCreateCompilerFn, OnBeforeStartDevServerFn, OnBeforeStartProdServerFn, OnCloseDevServerFn, OnDevCompileDoneFn, OnExitFn, OutputConfig, OutputStructure, PerformanceConfig, PluginManager, Polyfill, PostCSSLoaderOptions, PostCSSPlugin, PreconnectOption, PrintUrls, PublicDir, PublicDirOptions, RequestHandler, RsbuildConfig, RsbuildContext, RsbuildEntry, RsbuildEntryDescription, RsbuildInstance, RsbuildMode, RsbuildPlugin, RsbuildPluginAPI, RsbuildPlugins, RsbuildProvider, RsbuildTarget, RspackChain, RspackRule, ScriptInject, ScriptLoading, SecurityConfig, ServerAPIs, ServerConfig, SourceConfig, SplitChunks, StyleLoaderOptions, ToolsConfig, TransformFn, TransformHandler, TransformImport, WatchFiles, } from './types';
 export type { ChainIdentifier } from './configChain';
 export { 
 /**

package/dist-types/server/devServer.d.ts

@@ -1,7 +1,9 @@
+import type { Server } from 'node:http';
+import type { Http2SecureServer } from 'node:http2';
 import type Connect from '../../compiled/connect';
 import type { CreateDevMiddlewareReturns } from '../provider/createCompiler';
 import type { CreateDevServerOptions, EnvironmentAPI, InternalContext, NormalizedConfig, StartDevServerOptions } from '../types';
-import { type UpgradeEvent } from './helper';
+type HTTPServer = Server | Http2SecureServer;
 export type RsbuildDevServer = {
     /**
      * Use rsbuild inner server to listen
@@ -35,11 +37,13 @@ export type RsbuildDevServer = {
      */
     afterListen: () => Promise<void>;
     /**
-     * Subscribe http upgrade event
+     * Activate socket connection
      *
      * It will used when you use custom server
      */
-    onHTTPUpgrade: UpgradeEvent;
+    connectWebSocket: (options: {
+        server: HTTPServer;
+    }) => void;
     /**
      * Close the Rsbuild server.
      */
@@ -48,3 +52,4 @@ export type RsbuildDevServer = {
 export declare function createDevServer<Options extends {
     context: InternalContext;
 }>(options: Options, createDevMiddleware: (options: Options, compiler: StartDevServerOptions['compiler']) => Promise<CreateDevMiddlewareReturns>, config: NormalizedConfig, { compiler: customCompiler, getPortSilently, runCompile, }?: CreateDevServerOptions): Promise<RsbuildDevServer>;
+export {};

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

@@ -40,6 +40,39 @@ export type HtmlTagDescriptor = HtmlTag | HtmlTagHandler;
 type ChainedHtmlOption<O> = ConfigChainMergeContext<O, {
     entryName: string;
 }>;
+export type AppIconItem = {
+    /**
+     * The path to the icon, can be a URL, an absolute file path,
+     * or a relative path to the project root.
+     */
+    src: string;
+    /**
+     * The size of the icon.
+     */
+    size: number;
+    /**
+     * Specifies the intended target for which the icon should be generated.
+     * - `apple-touch-icon` for iOS system.
+     * - `web-app-manifest` for web application manifest.
+     */
+    target?: 'apple-touch-icon' | 'web-app-manifest';
+};
+export type AppIcon = {
+    /**
+     * The name of the application.
+     * @see https://developer.mozilla.org/en-US/docs/Web/Manifest/name
+     */
+    name?: string;
+    /**
+     * The list of icons.
+     */
+    icons: AppIconItem[];
+    /**
+     * The filename of the manifest file.
+     * @default 'manifest.webmanifest'
+     */
+    filename?: string;
+};
 export interface HtmlConfig {
     /**
      * Configure the `<meta>` tag of the HTML.
@@ -62,9 +95,18 @@ export interface HtmlConfig {
      */
     favicon?: ChainedHtmlOption<string>;
     /**
-     * Set the file path of the app icon, which can be a relative path or an absolute path.
+     * Set the web application icons to display when added to the home screen of a mobile device.
+     *
+     * @example
+     * appIcon: {
+     *   name: 'My Website',
+     *   icons: [
+     *     { src: './icon-192.png', size: 192 },
+     *     { src: './icon-512.png', size: 512 },
+     *   ]
+     * }
      */
-    appIcon?: string;
+    appIcon?: AppIcon;
     /**
      * Set the id of root element.
      */

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

@@ -193,9 +193,9 @@ export interface OutputConfig {
      */
     filename?: FilenameConfig;
     /**
-     * By default, Rsbuild's output is ASCII-only and will escape all non-ASCII characters.
-     * If you want to output the original characters without using escape sequences,
-     * you can set `output.charset` to `utf8`.
+     * Specify the character encoding format for output files.
+     * Can be `ascii` or `utf8`.
+     * @default 'utf8'
      */
     charset?: Charset;
     /**
@@ -223,8 +223,9 @@ export interface OutputConfig {
     legalComments?: LegalComments;
     /**
      * Whether to clean all files in the dist path before starting compilation.
+     * @default 'auto'
      */
-    cleanDistPath?: boolean;
+    cleanDistPath?: boolean | 'auto';
     /**
      * Allow to custom CSS Modules options.
      */

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

@@ -1,4 +1,3 @@
-import type { EntryDescription } from '@rspack/core';
 import type { Compiler, MultiCompiler } from '@rspack/core';
 import type { RsbuildDevServer } from '../server/devServer';
 import type { StartServerResult } from '../server/helper';
@@ -61,17 +60,20 @@ export type CreateRsbuildOptions = {
     environment?: string[];
 };
 export type ResolvedCreateRsbuildOptions = CreateRsbuildOptions & Required<Omit<CreateRsbuildOptions, 'environment'>>;
+export type CreateDevServer = (options?: CreateDevServerOptions) => Promise<RsbuildDevServer>;
+export type StartDevServer = (options?: StartDevServerOptions) => Promise<StartServerResult>;
+export type Build = (options?: BuildOptions) => Promise<void | {
+    close: () => Promise<void>;
+}>;
 export type ProviderInstance<B extends 'rspack' | 'webpack' = 'rspack'> = {
     readonly bundler: Bundler;
     createCompiler: CreateCompiler;
     /**
-     * It is designed for high-level frameworks that require a custom server
+     * It is designed for upper-level frameworks that require a custom server
      */
-    createDevServer: (options?: CreateDevServerOptions) => Promise<RsbuildDevServer>;
-    startDevServer: (options?: StartDevServerOptions) => Promise<StartServerResult>;
-    build: (options?: BuildOptions) => Promise<void | {
-        close: () => Promise<void>;
-    }>;
+    createDevServer: CreateDevServer;
+    startDevServer: StartDevServer;
+    build: Build;
     initConfigs: () => Promise<B extends 'rspack' ? Rspack.Configuration[] : WebpackConfig[]>;
     inspectConfig: (options?: InspectConfigOptions) => Promise<InspectConfigResult<B>>;
 };
@@ -109,5 +111,13 @@ export type RsbuildInstance = {
     onExit: RsbuildPluginAPI['onExit'];
 };
 export type RsbuildTarget = 'web' | 'node' | 'web-worker';
-export type RsbuildEntry = Record<string, string | string[] | EntryDescription>;
+export type RsbuildEntryDescription = Rspack.EntryDescription & {
+    /**
+     * Whether to generate an HTML file for the entry.
+     *
+     * @default true
+     */
+    html?: boolean;
+};
+export type RsbuildEntry = Record<string, string | string[] | RsbuildEntryDescription>;
 export type RsbuildMode = 'development' | 'production' | 'none';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rsbuild/core",
-  "version": "1.0.1-beta.13",
+  "version": "1.0.1-beta.15",
   "description": "The Rspack-based build tool.",
   "homepage": "https://rsbuild.dev",
   "bugs": {
@@ -46,7 +46,7 @@
     "types.d.ts"
   ],
   "dependencies": {
-    "@rspack/core": "1.0.0-beta.4",
+    "@rspack/core": "1.0.0-beta.5",
     "@rspack/lite-tapable": "1.0.0",
     "@swc/helpers": "0.5.11",
     "caniuse-lite": "^1.0.30001651",
@@ -74,6 +74,7 @@
     "http-proxy-middleware": "^2.0.6",
     "jiti": "^1.21.6",
     "launch-editor-middleware": "^2.8.1",
+    "mrmime": "^2.0.0",
     "on-finished": "2.4.1",
     "open": "^8.4.0",
     "picocolors": "^1.0.1",