rspkify 0.0.0-beta.0

package/bin/index.d.ts

@@ -0,0 +1,948 @@
+import { RuleSetRule, Configuration, LibraryOptions, LoaderContext, WebpackPluginInstance } from '@rspack/core';
+
+type RspackConfiguration = Configuration;
+/** @deprecated 请使用 RspackConfiguration */
+type WebpackConfiguration = Configuration;
+type EntryOption = Configuration['entry'];
+type OutputOption = Configuration['output'];
+/**
+ * Rsify 缓存选项类型
+ */
+type CacheOption = boolean | 'memory' | 'filesystem' | Configuration['cache'];
+/** Rspack 插件实例类型 */
+type RspackPluginInstance = WebpackPluginInstance;
+type BuildTargetsType = 'es5' | 'es6' | string | string[];
+/**
+ * postcss-preset-env 插件选项类型
+ * 简化的类型定义，实际类型由 postcss-preset-env 包提供
+ */
+type PresetEnvOptions = {
+    browsers?: string | string[];
+    stage?: number;
+    features?: Record<string, false | {
+        features: boolean;
+    }>;
+    autoprefixer?: boolean | {
+        grid?: boolean;
+        flexbox?: string;
+    };
+    insertAfter?: string | string[];
+    preserve?: boolean | string;
+    [key: string]: any;
+};
+type CssModuleOptions = {
+    auto?: boolean | RegExp | ((resourcePath: string) => boolean);
+    mode?: 'local' | 'global' | 'pure' | 'icss' | ((resourcePath: string) => 'local' | 'global' | 'pure' | 'icss');
+    localIdentName?: string;
+    localIdentContext?: string;
+    localIdentHashSalt?: string;
+    localIdentHashFunction?: string;
+    localIdentHashDigest?: string;
+    localIdentRegExp?: string | RegExp;
+    getLocalIdent?: (context: LoaderContext<unknown>, localIdentName: string, localName: string) => string;
+    namedExport?: boolean;
+    exportGlobals?: boolean;
+    exportLocalsConvention?: 'as-is' | 'camel-case' | 'camel-case-only' | 'dashes' | 'dashes-only' | ((name: string) => string);
+    exportOnlyLocals?: boolean;
+    getJSON?: ({ resourcePath, imports, exports, replacements }: {
+        resourcePath: string;
+        imports: object[];
+        exports: object[];
+        replacements: object[];
+    }) => Promise<void> | void;
+};
+type BabelType = 'react' | 'react-ts' | 'react-lib' | 'react-ts-lib' | 'react-esm' | 'react-esm-lib' | 'preact' | 'preact-ts' | 'preact-lib' | 'preact-ts-lib' | 'preact-esm' | 'preact-esm-lib' | 'h5' | 'h5-ts' | 'h5-lib' | 'h5-ts-lib' | 'h5-esm' | 'h5-esm-lib' | 'node' | 'node-ts';
+interface PxToRemOptions {
+    rootValue?: number;
+    unitPrecision?: number;
+    propList?: string[];
+    selectorBlackList?: (string | RegExp)[];
+    minPixelValue?: number;
+    mediaQuery?: boolean;
+    exclude?: string | RegExp | ((file: File) => boolean);
+    unit?: string;
+}
+type AssetOutType = {
+    emit?: boolean;
+    filename?: string;
+    publicPath?: string;
+    outputPath?: string;
+};
+type SvgOptions = {
+    symbolId?: string;
+    outputPath?: string;
+    publicPath?: string;
+};
+/**
+ * 图片选项类型（用于自动导入）
+ */
+type ImageOptionType = {
+    /** 是否启用自动导入 */
+    enable?: boolean;
+    /** 导入的文件后缀 */
+    extensions?: string[];
+    /** 导入路径 */
+    path?: string;
+    /** 是否递归搜索 */
+    recursive?: boolean;
+};
+/**
+ * 资源规则类型（继承 AssetOutType 和 RuleItem）
+ * @see https://webpack.js.org/configuration/module/#rule
+ */
+type AssetsImageType = AssetOutType & RuleItem;
+type AssetsVideoType = AssetOutType & RuleItem;
+type AssetsFontType = AssetOutType & RuleItem;
+type AssetsSvgType = {
+    /** 彩色 SVG 图标配置 */
+    colour?: boolean | (RuleItem & SvgOptions);
+    /** 纯色 SVG 图标配置 */
+    pure?: boolean | (RuleItem & SvgOptions);
+} & RuleItem;
+/**
+ * babel-preset-uniify 配置选项
+ * @see https://github.com/user/babel-preset-uniify
+ */
+type BabelPresetOptions = {
+    /** 项目环境类型（必填，由 BabelType 提供） */
+    type?: string;
+    /** 目标环境（'es5' | 'es6' | 'node' | browserslist 格式） */
+    targets?: BuildTargetsType;
+    /** 模块类型（'amd' | 'umd' | 'commonjs' | 'esm' | false | 'auto'） */
+    modules?: 'amd' | 'umd' | 'commonjs' | 'esm' | false | 'auto';
+    /** React 版本（'17' | '18'） */
+    reactVersion?: '17' | '18';
+    /** JSX 导入源（React 17+，如 'react' | '@emotion/react' | '@mui/material'） */
+    jsxImportSource?: string;
+    /** 是否为开发环境（默认根据 NODE_ENV 判断） */
+    development?: boolean;
+    /** 是否使用 transform-runtime 插件 */
+    useTransformRuntime?: boolean;
+    /** 自定义 import 配置 */
+    importConfig?: any;
+    /** 其他自定义选项 */
+    [key: string]: any;
+};
+type BabelBuildType = {
+    /** Babel 框架类型 */
+    type?: BabelType;
+    /** 是否使用 TypeScript（已废弃，请使用 type 中的 -ts 后缀） */
+    ts?: boolean;
+    /** babel-preset-uniify 配置选项 */
+    presetOptions?: BabelPresetOptions;
+    /** Babel loader 自定义选项 */
+    options?: any;
+    /** import 配置（保留兼容性） */
+    importConfig?: any;
+} & RuleItem;
+/** @deprecated 请使用 BabelBuildType */
+type BableBuildType = BabelBuildType;
+type BuildOptions = {
+    stats?: Configuration['stats'];
+    mode?: 'none' | 'development' | 'production';
+    analyze?: boolean;
+    devtool?: string | boolean;
+    target?: BuildTargetsType;
+    compile?: ['web'] | ['web', 'es5'] | ['node'];
+    babel?: BableBuildType;
+    /** 是否在重新构建时清理缓存（仅 filesystem 缓存有效） */
+    clearCacheOnRebuild?: boolean;
+};
+type RuleItem = RuleSetRule;
+interface ExposesConfig {
+    import: string | string[];
+    name?: string;
+}
+interface ExposesObject {
+    [index: string]: string | ExposesConfig | string[];
+}
+interface RemotesConfig {
+    external: string | string[];
+    shareScope?: string;
+}
+interface RemotesObject {
+    [index: string]: string | RemotesConfig | string[];
+}
+interface SharedConfig {
+    eager?: boolean;
+    import?: string | false;
+    packageName?: string;
+    requiredVersion?: string | false;
+    shareKey?: string;
+    shareScope?: string;
+    singleton?: boolean;
+    strictVersion?: boolean;
+    version?: string | false;
+}
+interface SharedObject {
+    [index: string]: string | SharedConfig;
+}
+interface ModuleFederationPluginOptions {
+    exposes?: (string | ExposesObject)[] | ExposesObject;
+    filename?: string;
+    library?: LibraryOptions;
+    name?: string;
+    remoteType?: 'import' | 'var' | 'module' | 'assign' | 'this' | 'window' | 'self' | 'global' | 'commonjs' | 'commonjs2' | 'commonjs-module' | 'commonjs-static' | 'amd' | 'amd-require' | 'umd' | 'umd2' | 'jsonp' | 'system' | 'promise' | 'script' | 'node-commonjs';
+    remotes?: (string | RemotesObject)[] | RemotesObject;
+    runtime?: string | false;
+    shareScope?: string;
+    shared?: (string | SharedObject)[] | SharedObject;
+}
+type ModuleFederationOption = ModuleFederationPluginOptions;
+/**
+ * 共享依赖配置模式
+ * - `true`: 自动从 peerDependencies 读取并设置 singleton
+ * - `string[]`: 指定共享的依赖名称数组
+ * - `SharedObject`: 完整的共享配置对象
+ * - `false`: 禁用自动共享
+ */
+type SharedDependenciesConfig = boolean | string[] | SharedObject | false;
+/**
+ * 模块联邦简化配置选项
+ */
+interface ModuleFederationSimplifiedOptions {
+    /** 应用名称（默认从 package.json 读取） */
+    name?: string;
+    /** 远程模块配置 */
+    remotes?: ModuleFederationPluginOptions['remotes'];
+    /** 暴露的模块配置 */
+    exposes?: ModuleFederationPluginOptions['exposes'];
+    /** 共享依赖配置（默认: true - 自动从 peerDependencies 读取） */
+    shared?: SharedDependenciesConfig;
+    /** 输出文件名（默认: 'remoteEntry.js'） */
+    filename?: string;
+    /** 运行时 chunk 名称 */
+    runtime?: string | false;
+    /** 共享作用域（默认: 'default'） */
+    shareScope?: string;
+    /** 库配置 */
+    library?: LibraryOptions;
+}
+/**
+ * CDN 公共路径类型
+ */
+type PublicPathType = string | ((val: string) => string);
+/**
+ * CDN 资源项类型
+ */
+interface CdnResourceItem {
+    /** 资源路径 */
+    path: string;
+    /** 自定义 publicPath */
+    publicPath?: PublicPathType;
+    /** 注入位置 */
+    inject?: 'head' | 'body';
+    /** 位置（开始或结束） */
+    position?: 'start' | 'end';
+    /** 异步加载 */
+    async?: boolean;
+    /** 延迟加载 */
+    defer?: boolean;
+    /** 跨域设置 */
+    crossorigin?: 'anonymous' | 'use-credentials';
+    /** 完整性校验 */
+    integrity?: string;
+    /** 不支持模块的回退 */
+    nomodule?: boolean;
+}
+/**
+ * CDN 上下文类型
+ */
+interface CdnContext {
+    headTags: any[];
+    bodyTags: any[];
+    compilation?: any;
+    compiler?: any;
+    env?: Record<string, any>;
+}
+/**
+ * CDN 配置
+ */
+interface CdnConfig {
+    /** CDN 公共路径前缀 */
+    publicPath?: PublicPathType;
+    /** 默认注入位置 */
+    inject?: 'head' | 'body';
+    /** 资源列表 */
+    resources?: (CdnResourceItem | string)[] | ((context: CdnContext) => (CdnResourceItem | string)[]);
+}
+/**
+ * SpyPage 监控选项
+ */
+interface SpyPageOptions {
+    version?: string;
+    enablePerformance?: boolean;
+    enableError?: boolean;
+    enableUserBehavior?: boolean;
+}
+/**
+ * 自定义脚本项类型
+ */
+type CustomScriptItemType = string | {
+    /** 脚本类型 */
+    type: 'external' | 'inline';
+    /** 内联脚本内容 */
+    content?: string;
+    /** 外部脚本地址 */
+    src?: string;
+    /** 注入位置 */
+    inject?: 'head' | 'body';
+    /** 位置 */
+    position?: 'start' | 'end';
+    /** 异步加载 */
+    async?: boolean;
+    /** 延迟加载 */
+    defer?: boolean;
+    /** 跨域设置 */
+    crossorigin?: 'anonymous' | 'use-credentials';
+    /** 完整性校验 */
+    integrity?: string;
+    /** 不支持模块的回退 */
+    nomodule?: boolean;
+};
+/**
+ * 脚本注入配置
+ */
+interface ScriptsConfig {
+    /** QQ SDK */
+    qq?: boolean | string;
+    /** 微信 SDK */
+    weixin?: boolean | string;
+    /** SpyPage 监控 */
+    spyPage?: boolean | SpyPageOptions;
+    /** VSCode 集成 */
+    vscode?: boolean | string;
+    /** 自定义脚本 */
+    custom?: CustomScriptItemType[];
+}
+/**
+ * Adapter 配置
+ */
+interface AdapterConfig {
+    type: 'client' | 'h5' | 'h5-landscape' | 'web';
+    options?: {
+        rootValue?: number;
+        [key: string]: any;
+    };
+}
+/**
+ * HTML 配置选项
+ */
+interface HtmlOptions {
+    /** 页面标题 */
+    title?: string;
+    /** 是否压缩 */
+    minify?: boolean;
+    /** 模板路径 */
+    template?: string;
+    /** 输出文件名 */
+    filename?: string | ((name: string) => string);
+    /** 屏幕适配配置 */
+    adapter?: 'h5' | 'h5-landscape' | 'client' | 'web' | AdapterConfig;
+    /** CDN 配置 */
+    cdn?: CdnConfig | false | null;
+    /** 脚本注入配置 */
+    scripts?: ScriptsConfig | false | null;
+    /** HTML 块 */
+    chunks?: string | string[] | ((dirName: string, path: string) => string | string[]);
+}
+/**
+ * 优化配置选项（简化版）
+ */
+interface OptimizationOptions {
+    /** 是否压缩代码 */
+    minimize?: boolean;
+    /** 代码分割配置 */
+    splitChunks?: boolean | {
+        chunks?: 'all' | 'async' | 'initial';
+        maxSize?: number;
+        cacheGroups?: any;
+    };
+    /** 运行时代码分割 */
+    runtimeChunk?: boolean | 'single' | 'multiple';
+}
+/**
+ * Bundle Analyzer 配置选项
+ * 基于 webpack-bundle-analyzer 官方文档
+ * @see https://github.com/webpack/webpack-bundle-analyzer
+ */
+interface AnalyzerOptions {
+    /** 是否启用分析（Webify 自定义选项，不在官方 API 中） */
+    enabled?: boolean;
+    /** 分析模式（默认：server） */
+    analyzerMode?: 'server' | 'static' | 'json' | 'disabled';
+    /** server 模式下的主机（默认：127.0.0.1） */
+    analyzerHost?: string;
+    /** server 模式下的端口，'auto' 表示自动分配（默认：8888） */
+    analyzerPort?: number | 'auto';
+    /** 自定义 server 模式下控制台打印的 URL */
+    analyzerUrl?: (listenHost: string, boundAddress: string) => string;
+    /** 是否自动在浏览器中打开报告（默认：true） */
+    openAnalyzer?: boolean;
+    /** static 模式下的报告文件名（默认：report.html） */
+    reportFilename?: string;
+    /** HTML 报告标题（默认：当前日期时间） */
+    reportTitle?: string | (() => string);
+    /** 报告中默认显示的模块大小类型（默认：parsed） */
+    defaultSizes?: 'stat' | 'parsed' | 'gzip' | 'brotli' | 'zstd';
+    /** 计算压缩大小时使用的算法（默认：gzip） */
+    compressionAlgorithm?: 'gzip' | 'brotli' | 'zstd';
+    /** 是否生成 webpack stats JSON 文件（默认：false） */
+    generateStatsFile?: boolean;
+    /** stats 文件名（默认：stats.json） */
+    statsFilename?: string;
+    /** 传递给 stats.toJson() 的选项（默认：null） */
+    statsOptions?: null | Record<string, any>;
+    /**
+     * 排除特定资源的模式（默认：null）
+     * 可以是字符串、RegExp、函数或数组
+     */
+    excludeAssets?: string | RegExp | ((assetName: string) => boolean) | Array<string | RegExp | ((assetName: string) => boolean)>;
+    /** 控制台日志级别（默认：info） */
+    logLevel?: 'info' | 'warn' | 'error' | 'silent' | 'debug';
+}
+/**
+ * 插件配置选项（简化版）
+ */
+interface PluginOptions {
+    /** BundleAnalyzer 配置（分析包体积） */
+    analyzer?: boolean | AnalyzerOptions;
+    /** IgnorePlugin 配置（忽略模块） */
+    ignore?: string | RegExp | (string | RegExp)[];
+}
+/**
+ * Copy 插件配置模式类型
+ * 基于 Rspack 内置 CopyRspackPlugin
+ * @see https://rspack.dev/plugins/rspack/copy-rspack-plugin
+ */
+type CopyPattern = string | {
+    /** 要复制的源文件或目录（支持通配符，必填） */
+    from: string;
+    /** 输出目标路径（相对 webpack output.path） */
+    to?: string;
+    /** from 路径的解析上下文 */
+    context?: string;
+    /** 传递给 glob 库的选项 */
+    globOptions?: {
+        /** 忽略的文件模式 */
+        ignore?: string | string[];
+        dot?: boolean;
+        [key: string]: any;
+    };
+    /** 过滤函数 (absolutePath) => boolean */
+    filter?: (absolutePath: string) => boolean;
+    /** 强制 to 的类型 */
+    toType?: 'dir' | 'file' | 'template';
+    /** 优先级，允许规则覆盖其他规则 */
+    priority?: number;
+    /** 修改文件信息对象 */
+    info?: Record<string, any> | ((file: Record<string, any>) => Record<string, any>);
+    /** 在复制前修改文件内容 */
+    transform?: ((content: string, absoluteFrom: string) => string | Promise<string>) | {
+        transformer: (content: string, absoluteFrom: string) => string | Promise<string>;
+        cache?: boolean;
+    };
+    /** 修改所有匹配的文件内容（仅在 from 为目录时有效） */
+    transformAll?: (files: {
+        filename: string;
+        content: string;
+    }[]) => Record<string, any>;
+    /** 如果为 true，当 from 匹配不到文件时不会报错 */
+    noErrorOnMissing?: boolean;
+};
+/**
+ * 资源配置选项（扁平化版）
+ * @see https://webpack.js.org/guides/asset-modules/
+ */
+type ImageOptions = AssetOutType & {
+    maxSize?: number;
+    limit?: number;
+};
+type VideoOptions = AssetOutType & {
+    maxSize?: number;
+    limit?: number;
+};
+type FontOptions = AssetOutType & {
+    maxSize?: number;
+    limit?: number;
+};
+type AssetsOptions = {
+    /** 自动导入图片 */
+    autoImport?: ImageOptionType;
+    html?: any;
+    image?: boolean | ImageOptions;
+    video?: boolean | VideoOptions;
+    font?: boolean | FontOptions;
+    svg?: {
+        /** 彩色 SVG 图标配置（向后兼容 sprite） */
+        colour?: boolean | (RuleItem & SvgOptions);
+        sprite?: boolean | (RuleItem & SvgOptions);
+        /** 纯色 SVG 图标配置 */
+        pure?: boolean | (RuleItem & SvgOptions);
+        /** SVG URL Loader 配置 */
+        url?: boolean | AssetOutType;
+    };
+};
+/**
+ * 资源配置类型（完整版）
+ * @see https://webpack.js.org/configuration/module/
+ */
+type AssetsType = {
+    /** 自动导入图片 */
+    autoImport?: ImageOptionType;
+    /** HTML 资源配置 */
+    html?: any;
+    /** 图片资源配置 */
+    image?: boolean | AssetsImageType;
+    /** 视频资源配置 */
+    video?: boolean | AssetsVideoType;
+    /** 字体资源配置 */
+    font?: boolean | AssetsFontType;
+    /** SVG 资源配置 */
+    svg?: AssetsSvgType;
+};
+interface DevOption {
+    /** 开发服务器端口 */
+    port?: string | number;
+    /** 开发服务器主机 */
+    host?: string;
+    /** 是否自动打开浏览器 */
+    open?: boolean | string;
+    /** 是否启用热更新 */
+    hot?: boolean | 'only';
+    /** 是否启用 gzip 压缩 */
+    compress?: boolean;
+    /** 是否启用 History API 回退 */
+    historyApiFallback?: boolean | Record<string, any>;
+    /** 客户端配置 */
+    client?: Record<string, any> | boolean;
+    /** 代理配置 */
+    proxy?: Record<string, any> | Record<string, any>[];
+    /** 代理目标（简化配置） */
+    proxyTarget?: string | {
+        context: string;
+        target: string;
+    } | {
+        context: string;
+        target: string;
+    }[];
+    /** 静态文件配置 */
+    static?: string | boolean | Record<string, any> | (string | Record<string, any>)[];
+    /** 允许的主机 */
+    allowedHosts?: 'all' | 'auto' | string[];
+    /** 请求头配置 */
+    headers?: Record<string, string> | ((req: any, res: any, context: any) => Record<string, string>);
+    /** HTTPS 配置 */
+    https?: boolean | Record<string, any>;
+    /** 服务器配置 */
+    server?: string | Record<string, any>;
+    /** 其他 webpack-dev-server 配置 */
+    [key: string]: any;
+}
+/**
+ * 通用样式配置选项（CSS 和 SCSS 共用）
+ */
+interface BaseStyleOptions {
+    /**
+     * 是否启用 CSS Modules
+     *
+     * 支持多种格式：
+     * - `boolean`: true 启用，false 禁用
+     * - `RegExp`: 正则匹配的文件使用 CSS Modules
+     * - `Function`: 函数返回 true 时使用 CSS Modules
+     * - `CssModuleOptions`: CSS Loader 配置对象（支持 auto 等选项）
+     * - `string[]`: 字符串数组，指定路径下的文件使用 CSS Modules
+     * - `CssModuleItem[]`: 混合配置数组，可指定哪些使用/不使用 CSS Modules
+     */
+    modules?: boolean | RegExp | ((resourcePath: string) => boolean) | CssModuleOptions | string[] | CssModuleItem[];
+    /** 是否压缩 CSS */
+    minimize?: boolean;
+    /** 是否提取为单独文件 */
+    extract?: boolean;
+    /** 文件名 */
+    filename?: string;
+    /** chunk 文件名 */
+    chunkFilename?: string;
+    /** 附加数据（如全局变量） */
+    additionalData?: string | ((content: string, filename: string) => string);
+    /** 是否内联到 JS（开发模式） */
+    inline?: boolean;
+    /** 是否生成 source map */
+    sourceMap?: boolean;
+    /** webpack 规则排除 */
+    exclude?: RuleSetRule['exclude'];
+    /** webpack 规则选项 */
+    innerRule?: Partial<RuleSetRule>;
+    /** 是否使用 ES Module */
+    esModule?: boolean;
+    /** CSS Loader 的 publicPath */
+    publicPath?: string;
+    /** CSS Loader 的 emit 选项 */
+    emit?: boolean;
+    /** PostCSS 配置 */
+    postcss?: {
+        presetEnv?: PresetEnvOptions;
+        pxtoRem?: PxToRemOptions;
+    };
+}
+/**
+ * CSS Modules 配置项（用于数组格式）
+ */
+interface CssModuleItem {
+    /** CSS Modules 配置 */
+    module?: boolean | CssModuleOptions;
+    /** 本地类名前缀 */
+    localName?: string;
+    /** 匹配规则（支持正则和函数） */
+    test?: RegExp | ((path: string) => boolean);
+    /** 额外的数据 */
+    additionalData?: string;
+    [key: string]: any;
+}
+/**
+ * SCSS 配置选项（继承 BaseStyleOptions）
+ * 继承所有 CSS 配置选项，并添加 SCSS 特有选项
+ */
+interface ScssOptions extends BaseStyleOptions {
+    /** SCSS 特有：输出风格 */
+    outputStyle?: 'expanded' | 'compressed' | 'nested' | 'compact';
+    /** SCSS 特有：包含路径 */
+    includePaths?: string[];
+}
+/**
+ * CSS 配置选项（继承 BaseStyleOptions）
+ */
+interface CssOptions extends BaseStyleOptions {
+}
+/**
+ * PostCSS 配置选项（扁平化版）
+ */
+interface PostcssOptions {
+    /** postcss-preset-env 配置 */
+    presetEnv?: PresetEnvOptions;
+    /** postcss-pxtorem 配置 */
+    pxtoRem?: PxToRemOptions;
+    /** rootValue（用于屏幕适配） */
+    rootValue?: number;
+}
+/**
+ * 样式配置选项（扁平化版）
+ */
+interface StyleOptions {
+    /** CSS 配置 */
+    css?: CssOptions;
+    /** SCSS 配置 */
+    scss?: ScssOptions;
+    /** PostCSS 配置 */
+    postcss?: PostcssOptions;
+    /** 样式文件名（全局默认值） */
+    filename?: string;
+    /** chunk 文件名（全局默认值） */
+    chunkFilename?: string;
+    /** 是否内联（全局默认值） */
+    inline?: boolean;
+    /** source map（全局默认值） */
+    sourceMap?: boolean;
+}
+/**
+ * Webify 命令行配置参数
+ * 用于传递 CLI 参数到配置函数
+ */
+interface WebifyCommandLineConfigure {
+    /** 是否启动开发服务 */
+    service: boolean;
+    /** 配置文件路径 */
+    config?: string;
+    /** 开发服务器端口 */
+    port?: number;
+    /** 开发服务器主机 */
+    host?: string;
+    /** 是否自动打开浏览器 */
+    open?: boolean;
+    /** 构建类型 */
+    type?: string;
+    /** 构建模式 */
+    mode?: 'development' | 'production' | 'none';
+    /** 是否启用构建分析 */
+    analyze?: boolean;
+    /** 是否生成构建报告 */
+    report?: boolean;
+    /** 是否显示详细信息 */
+    verbose?: boolean;
+}
+/**
+ * Webify 命令行参数
+ * 与 WebifyCommandLineConfigure 完全一致，保留为类型别名以兼容旧代码
+ */
+type WebifyParams = WebifyCommandLineConfigure;
+/**
+ * Webify 钩子函数
+ */
+interface WebifyHooks {
+    /** 构建前钩子 */
+    beforeBuild?: (config: any) => void | Promise<void>;
+    /** 构建后钩子 */
+    afterBuild?: (stats: any) => void | Promise<void>;
+    /** 错误处理钩子 */
+    onError?: (error: Error) => void | Promise<void>;
+}
+interface WebifyConfigOption {
+    appType?: 'spa' | 'mpa';
+    framework?: 'h5' | 'react' | 'preact' | 'vue';
+    entry?: EntryOption;
+    output?: OutputOption | (() => OutputOption);
+    build?: BuildOptions;
+    cache?: CacheOption;
+    moduleFederation?: Partial<ModuleFederationOption>;
+    /** 优化配置（支持简化版或完整 rspack 配置） */
+    optimization?: boolean | OptimizationOptions | Configuration['optimization'];
+    alias?: Record<string, string>;
+    resolve?: Configuration['resolve'] | (() => Configuration['resolve']);
+    /** 开发服务器配置（统一命名） */
+    dev?: DevOption;
+    html?: HtmlOptions;
+    /** 样式配置（扁平化） */
+    style?: StyleOptions;
+    /** 资源配置（扁平化） */
+    assets?: AssetsOptions;
+    /** ProvidePlugin 配置（替代 global） */
+    provide?: {
+        /** 运行时模块列表（保留兼容性） */
+        runtime?: string[];
+        /** 自定义 ProvidePlugin 映射 */
+        modules?: Record<string, string | string[]>;
+    };
+    /** CopyPlugin 配置（复制静态资源） */
+    copy?: CopyPattern | CopyPattern[];
+    define?: Record<string, string>;
+    /** 扩展规则（自定义 rspack rules） */
+    rules?: RuleSetRule | RuleSetRule[];
+    /** 扩展插件（自定义 rspack plugins） */
+    plugins?: RspackPluginInstance | RspackPluginInstance[];
+    /** 插件配置（简化版） */
+    pluginOptions?: PluginOptions;
+    /** CSS-in-TypeScript 静态编译配置 */
+    cssInTS?: boolean | {
+        /** 类名生成规则 */
+        generateClassName?: (exportName: string, filePath: string, hash: string) => string;
+        /** CSS 输出策略: 'per-file' 每个 .style.ts 生成一个 .css | 'single-bundle' 合并为单个 CSS */
+        outputCSS?: 'per-file' | 'single-bundle';
+        /** 是否为开发模式（自动检测） */
+        devMode?: boolean;
+        /** 样式文件匹配模式，默认 /\.style\.ts$/ */
+        test?: RegExp;
+        /** 是否启用 source map */
+        sourceMap?: boolean;
+    };
+    /** 高级 Rspack 配置 */
+    rspack?: {
+        /** 在最终配置前执行（可修改配置） */
+        before?: (config: Configuration) => Configuration;
+        /** 在最终配置后执行（可修改配置） */
+        after?: (config: Configuration) => Configuration;
+        /** 直接替换配置项 */
+        replace?: {
+            [key in keyof Configuration]?: Configuration[key];
+        };
+    };
+    /** @deprecated 请使用 rspack 字段 */
+    webpack?: {
+        before?: (config: Configuration) => Configuration;
+        after?: (config: Configuration) => Configuration;
+        replace?: {
+            [key in keyof Configuration]?: Configuration[key];
+        };
+    };
+}
+
+declare const rspackConfigPlugin: (useConfig: WebifyConfigOption, userParams: WebifyCommandLineConfigure, configDir?: string) => {
+    devConfig: RspackConfiguration;
+    proConfig: RspackConfiguration;
+};
+/** @deprecated 请使用 rspackConfigPlugin */
+declare const webpckConfigPlugin: (useConfig: WebifyConfigOption, userParams: WebifyCommandLineConfigure, configDir?: string) => {
+    devConfig: RspackConfiguration;
+    proConfig: RspackConfiguration;
+};
+
+/**
+ * 创建远程模块配置
+ *
+ * @example
+ * const remotes = createRemotes({
+ *   app1: 'http://localhost:3001/remoteEntry.js',
+ *   app2: 'http://localhost:3002/remoteEntry.js'
+ * })
+ * // => { app1: 'app1@http://localhost:3001/remoteEntry.js', ... }
+ */
+declare function createRemotes(remotes: Record<string, string>): Record<string, string>;
+/**
+ * 创建暴露模块配置
+ *
+ * @example
+ * const exposes = createExposes({
+ *   './Button': './src/components/Button',
+ *   './utils': './src/utils/index'
+ * })
+ */
+declare function createExposes(exposes: Record<string, string>): Record<string, string>;
+/**
+ * 创建共享依赖配置
+ *
+ * @example
+ * const shared = createShared({
+ *   react: { singleton: true },
+ *   'react-dom': { singleton: true }
+ * })
+ */
+declare function createShared(shared: Record<string, SharedConfig>): SharedObject;
+/**
+ * 创建常用的 React 共享依赖配置
+ *
+ * @param version - React 版本，默认 '*'
+ * @param options - 配置选项
+ *
+ * @example
+ * const shared = createReactShared('^18.0.0')
+ */
+declare function createReactShared(version?: string, options?: {
+    /** 是否单例 */
+    singleton?: boolean;
+    /** 是否严格版本检查 */
+    strictVersion?: boolean;
+    /** 是否 eager 加载 */
+    eager?: boolean;
+}): SharedObject;
+/**
+ * 创建常用的 Vue 共享依赖配置
+ *
+ * @param version - Vue 版本，默认 '*'
+ * @param options - 配置选项
+ *
+ * @example
+ * const shared = createVueShared('^3.0.0')
+ */
+declare function createVueShared(version?: string, options?: {
+    singleton?: boolean;
+    strictVersion?: boolean;
+    eager?: boolean;
+}): SharedObject;
+/**
+ * 从环境变量创建远程模块配置
+ *
+ * @example
+ * // .env 文件
+ * REMOTE_APP1=http://localhost:3001/remoteEntry.js
+ * REMOTE_APP2=http://localhost:3002/remoteEntry.js
+ *
+ * // 使用
+ * const remotes = createRemotesFromEnv('REMOTE_')
+ */
+declare function createRemotesFromEnv(prefix?: string): Record<string, string>;
+/**
+ * 合并多个共享依赖配置
+ *
+ * @description
+ * 当同一个依赖在多个配置中出现时，后面的配置会覆盖前面的
+ *
+ * @example
+ * const shared = mergeShared(
+ *   createReactShared('^18.0.0'),
+ *   { lodash: { singleton: false } }
+ * )
+ */
+declare function mergeShared(...sharedObjects: (SharedObject | undefined)[]): SharedObject;
+/**
+ * 快速创建共享依赖配置（简化版）
+ *
+ * @description
+ * 快速创建单例模式的共享依赖配置
+ *
+ * @example
+ * const shared = createQuickShared(['react', 'react-dom', 'lodash'])
+ * // => {
+ * //   react: { singleton: true, requiredVersion: '*' },
+ * //   'react-dom': { singleton: true, requiredVersion: '*' },
+ * //   lodash: { singleton: true, requiredVersion: '*' }
+ * // }
+ */
+declare function createQuickShared(packages: string[], options?: {
+    singleton?: boolean;
+    strictVersion?: boolean;
+    eager?: boolean;
+    requiredVersion?: string;
+}): SharedObject;
+
+/**
+ * 辅助函数：创建共享依赖配置（从多个来源）
+ *
+ * @example
+ * const shared = createSharedFromPackage(['react', 'react-dom'], {
+ *   peerDependencies: true,  // 从 peerDependencies 读取
+ *   dependencies: false      // 不从 dependencies 读取
+ * })
+ */
+declare function createSharedFromPackage(packages: string[], options?: {
+    peerDependencies?: boolean;
+    dependencies?: boolean;
+    defaultConfig?: SharedConfig;
+}): SharedObject;
+
+interface RspackRunnerOptions {
+    config: Configuration;
+    params: WebifyParams;
+    hooks?: WebifyHooks;
+}
+/**
+ * Rspack 执行器
+ * 使用 @rspack/core 和 @rspack/dev-server 进行构建和开发服务
+ */
+declare class RspackRunner {
+    private config;
+    private params;
+    private hooks?;
+    private server;
+    constructor(options: RspackRunnerOptions);
+    run(): Promise<void>;
+    /**
+     * 运行开发服务器（使用 @rspack/dev-server）
+     */
+    private runDevServer;
+    /**
+     * 运行生产构建（使用 @rspack/core）
+     */
+    private runBuild;
+    stop(): Promise<void>;
+}
+/**
+ * 运行 Rspack 构建
+ */
+declare const runRspackBuild: (params: WebifyParams, userConfig: Configuration, hooks?: WebifyHooks) => Promise<void>;
+/** @deprecated 请使用 runRspackBuild */
+declare const runWebpackBuild: (params: WebifyParams, userConfig: Configuration, hooks?: WebifyHooks) => Promise<void>;
+
+/**
+ * CSS-in-TypeScript 插件配置
+ *
+ * 通过 @webify/css 包提供的 CSSInTSPlugin 实现
+ * 在 .style.ts 文件中用 TS 对象定义样式，编译时生成标准 CSS
+ *
+ * 设计理念：
+ * - .style.ts 编译后的 CSS 写入同目录的 .style.css 文件
+ * - .style.css 文件自然进入 Rspack 标准 CSS 管线
+ * - 复用已有的 css-loader → postcss-loader → CssExtractRspackPlugin 流程
+ * - 与 SCSS Modules 共享 PostCSS、压缩、打包等处理
+ * - 支持两种样式方案并存：SCSS Modules + CSS-in-TS
+ *
+ * @param cssInTS 配置项（true 启用默认配置，对象自定义配置）
+ * @param isService 是否为开发服务模式
+ * @returns RspackPluginInstance 或 undefined
+ */
+declare const setCSSInTSPlugin: (cssInTS: WebifyConfigOption["cssInTS"], isService: boolean) => any | undefined;
+
+/**
+ * defineConfig 辅助函数（类型提示）
+ */
+declare const defineConfig: (config: WebifyConfigOption) => WebifyConfigOption;
+
+export { type AdapterConfig, type AssetsType, type BuildOptions, type CdnConfig, type DevOption, type HtmlOptions, type ModuleFederationOption, type ModuleFederationSimplifiedOptions, type WebifyConfigOption as RsifyConfig, type RspackConfiguration, RspackRunner, type ScriptsConfig, type SharedDependenciesConfig, type StyleOptions, type WebifyConfigOption as WebifyConfig, type WebifyCommandLineConfigure as WebifyParams, type WebpackConfiguration, createExposes, createQuickShared, createReactShared, createRemotes, createRemotesFromEnv, rspackConfigPlugin as createRspackConfig, createShared, createSharedFromPackage, createVueShared, rspackConfigPlugin as createWebpackConfig, defineConfig, mergeShared, rspackConfigPlugin, runRspackBuild, runWebpackBuild, setCSSInTSPlugin, rspackConfigPlugin as webpackConfigPlugin, webpckConfigPlugin };