@4399ywkf/core 5.0.26 → 5.0.28

package/dist/index.d.ts

@@ -1,14 +1,14 @@
-import { G as GeneratorContext, b as PluginHooks, Y as YwkfConfig, c as PluginConfig, e as YwkfPlugin } from './schema-runIYOB7.js';
-export { B as BuildHooks, C as CodeInjection, D as DevServerConfig, E as EnvConfig, f as GeneratedFile, g as GeneratorHooks, H as HtmlConfig, M as MicroFrontendConfig, O as OutputConfig, P as PerformanceConfig, h as PluginContext, R as RouterConfig, i as RouterHooks, j as RuntimeHooks, S as StyleConfig, T as ToolsConfig, d as defaultConfig, a as defineConfig } from './schema-runIYOB7.js';
+import { G as GeneratorContext, e as PluginHooks, Y as YwkfConfig, f as PluginConfig } from './schema-CMyZyL6E.js';
+export { A as AnalyticsPluginOptions, h as BiomePluginOptions, j as BrowserCheckPluginOptions, k as BrowserMinVersions, y as BuildHooks, C as CodeInjection, D as DevServerConfig, E as EnvConfig, m as GarfishPluginOptions, F as GeneratedFile, J as GeneratorHooks, H as HtmlConfig, I as I18nPluginOptions, M as MicroFrontendConfig, q as MockPluginOptions, b as OutputConfig, P as PerformanceConfig, K as PluginContext, s as ReactQueryPluginOptions, R as RouterConfig, L as RouterHooks, N as RuntimeHooks, S as StyleConfig, u as TailwindPluginOptions, v as ThemePluginOptions, T as ToolsConfig, Q as YwkfPlugin, Z as ZustandPluginOptions, g as analyticsPlugin, i as biomePlugin, l as browserCheckPlugin, d as defaultConfig, a as defineConfig, n as garfishPlugin, o as getDefaultBiomeConfig, p as i18nPlugin, r as mockPlugin, t as reactQueryPlugin, w as tailwindPlugin, x as themePlugin, z as zustandPlugin } from './schema-CMyZyL6E.js';
 import { Compiler } from '@rspack/core';
 export { PluginManager, createPlugin, definePlugin } from './plugin/index.js';
 export { ConventionalRouteGenerator, ConventionalRoutePlugin, ConventionalRoutePluginOptions, GeneratorOptions, RouteConfig, generateConventionalRoutes } from './router/index.js';
 export { createBaseConfig, createDevConfig, createProdConfig, createRspackConfig } from './rspack/index.js';
 export { AppContext, AppContextProvider, ErrorBoundary, RootProvider, bootstrap, createMicroApp, createProvider, getMicroAppPublicPath, isMicroAppEnv, unmount, useApp, useAppName, useBasename, useEnv, useIsDev } from './runtime/index.js';
-export { a as AntdConfig, A as AppConfig, b as AppContextValue, L as LifecycleHooks, M as MicroAppConfig, P as ProviderConfig } from './types-DbUq-VY8.js';
+export { A as AntdConfig, a as AppConfig, b as AppContextValue, L as LifecycleHooks, M as MicroAppConfig, P as ProviderConfig } from './types-BYqzyGAY.js';
+import 'react/jsx-runtime';
 import 'react';
 import 'react-router';
-import 'react/jsx-runtime';
 
 /**
  * 执行生产构建
@@ -142,486 +142,4 @@ declare class YwkfGeneratorPlugin {
     private watchConfig;
 }
 
-interface AnalyticsPluginOptions {
-    /** 是否启用构建分析 */
-    buildAnalysis?: boolean;
-    /** 是否输出构建时间 */
-    timing?: boolean;
-    /** 是否分析 bundle 大小 */
-    bundleSize?: boolean;
-    /** 大文件警告阈值（KB） */
-    sizeWarningThreshold?: number;
-}
-/**
- * 构建分析插件
- *
- * @example
- * ```ts
- * import { analyticsPlugin } from "@4399ywkf/core/plugin";
- *
- * export default defineConfig({
- *   plugins: [
- *     analyticsPlugin({
- *       timing: true,
- *       bundleSize: true,
- *       sizeWarningThreshold: 500, // 500KB
- *     }),
- *   ],
- * });
- * ```
- */
-declare const analyticsPlugin: (options?: AnalyticsPluginOptions | undefined) => YwkfPlugin;
-
-interface BiomePluginOptions {
-    /**
-     * 是否在项目根目录生成 biome.json（仅在文件不存在时）
-     * @default true
-     */
-    scaffold?: boolean;
-    /**
-     * biome.json 的 formatter 缩进风格
-     * @default "space"
-     */
-    indentStyle?: "space" | "tab";
-    /**
-     * JS/TS formatter 引号风格
-     * @default "double"
-     */
-    quoteStyle?: "double" | "single";
-    /**
-     * 箭头函数参数括号
-     * @default "always"
-     */
-    arrowParentheses?: "always" | "asNeeded";
-    /**
-     * JS/TS 行宽
-     * @default 100
-     */
-    lineWidth?: number;
-    /**
-     * 是否启用 organizeImports
-     * @default true
-     */
-    organizeImports?: boolean;
-    /**
-     * 额外忽略的文件 glob
-     */
-    ignore?: string[];
-    /**
-     * 自定义 linter 规则覆盖（浅合并到默认规则上）
-     */
-    rules?: Record<string, Record<string, string>>;
-}
-/**
- * Biome 代码规范插件
- *
- * 在 setup 阶段自动生成 biome.json，为项目提供统一的
- * Lint / Format / Import Sorting 规范。
- *
- * 默认配置参考 modern.js 的 biome 方案，并适配 React + Ant Design 项目。
- *
- * @example
- * ```ts
- * import { defineConfig, biomePlugin } from "@4399ywkf/core";
- *
- * export default defineConfig({
- *   plugins: [
- *     biomePlugin(),
- *   ],
- * });
- * ```
- */
-declare const biomePlugin: (options?: BiomePluginOptions | undefined) => YwkfPlugin;
-/**
- * 生成默认 biome.json 配置内容（纯数据，供 CLI 脚手架使用）
- */
-declare function getDefaultBiomeConfig(): Record<string, unknown>;
-
-interface GarfishPluginOptions {
-    /** 应用名称（微前端标识） */
-    appName?: string;
-    /** 是否作为主应用 */
-    master?: boolean;
-    /** 子应用列表（主应用模式） */
-    apps?: {
-        name: string;
-        entry: string;
-        activeRule: string;
-        basename?: string;
-    }[];
-    /** 沙箱配置 */
-    sandbox?: {
-        /** 是否开启 JS 沙箱 */
-        open?: boolean;
-        /** 是否开启快照沙箱 */
-        snapshot?: boolean;
-        /** 样式隔离 */
-        strictStyleIsolation?: boolean;
-    };
-}
-/**
- * Garfish 微前端插件
- *
- * 通过插件方式启用微前端功能，支持子应用和主应用两种模式。
- *
- * @example
- * ```ts
- * // ywkf.config.ts - 子应用模式
- * import { defineConfig, garfishPlugin } from "@4399ywkf/core";
- *
- * export default defineConfig({
- *   plugins: [
- *     garfishPlugin({
- *       appName: "sub-app",
- *     }),
- *   ],
- * });
- * ```
- *
- * @example
- * ```ts
- * // ywkf.config.ts - 主应用模式
- * import { defineConfig, garfishPlugin } from "@4399ywkf/core";
- *
- * export default defineConfig({
- *   plugins: [
- *     garfishPlugin({
- *       master: true,
- *       apps: [
- *         { name: "sub-app", entry: "http://localhost:3001", activeRule: "/sub" },
- *       ],
- *     }),
- *   ],
- * });
- * ```
- */
-declare const garfishPlugin: (options?: GarfishPluginOptions | undefined) => YwkfPlugin;
-
-interface I18nPluginOptions {
-    /**
-     * 默认语言
-     * @default "zh-CN"
-     */
-    defaultLocale?: string;
-    /**
-     * 支持的语言列表
-     * @default ["zh-CN", "en-US"]
-     */
-    locales?: string[];
-    /**
-     * 翻译 JSON 文件目录（相对于项目根目录）
-     * 非默认语言的 JSON 翻译文件存放位置
-     * @default "locales"
-     */
-    localesDir?: string;
-    /**
-     * 默认语言 TS 源文件目录（相对于项目根目录）
-     * 开发者在此编写 TypeScript 翻译源文件，作为 i18n 的 single source of truth
-     * @default "src/locales/default"
-     */
-    sourceDir?: string;
-    /**
-     * 默认命名空间
-     * @default ["common"]
-     */
-    defaultNS?: string[];
-    /**
-     * 是否自动生成初始脚手架文件
-     * @default true
-     */
-    autoScaffold?: boolean;
-}
-/**
- * 国际化插件（TS-first 工作流）
- *
- * 开发流程：
- * 1. 开发者在 src/locales/default/ 中编写 TypeScript 翻译源文件（有类型推导 + IDE 补全）
- * 2. 运行 `pnpm i18n:gen` 将 TS 源文件转换为 locales/{defaultLocale}/*.json
- * 3. 运行 `pnpm i18n` 使用 @lobehub/i18n-cli 将默认语言 JSON 翻译为其他语言
- * 4. 运行时：开发模式下默认语言直接 import TS，其他场景懒加载 JSON
- *
- * @example
- * ```ts
- * import { defineConfig, i18nPlugin } from "@4399ywkf/core";
- *
- * export default defineConfig({
- *   plugins: [
- *     i18nPlugin({
- *       defaultLocale: "zh-CN",
- *       locales: ["zh-CN", "en-US", "ja-JP"],
- *     }),
- *   ],
- * });
- * ```
- */
-declare const i18nPlugin: (options?: I18nPluginOptions | undefined) => YwkfPlugin;
-
-interface MockPluginOptions {
-    /** Mock 文件目录 */
-    mockDir?: string;
-    /** 是否在生产环境启用 */
-    enableInProd?: boolean;
-    /** 延迟时间（模拟网络延迟） */
-    delay?: number;
-    /** 前缀路径 */
-    prefix?: string;
-}
-/**
- * Mock 数据插件
- *
- * @example
- * ```ts
- * // ywkf.config.ts
- * import { mockPlugin } from "@4399ywkf/core/plugin";
- *
- * export default defineConfig({
- *   plugins: [
- *     mockPlugin({
- *       mockDir: "mock",
- *       prefix: "/api",
- *     }),
- *   ],
- * });
- * ```
- *
- * Mock 文件示例 (mock/user.ts):
- * ```ts
- * export default {
- *   "GET /api/users": [
- *     { id: 1, name: "张三" },
- *   ],
- *   "POST /api/users": (req, res) => {
- *     res.json({ success: true });
- *   },
- * };
- * ```
- */
-declare const mockPlugin: (options?: MockPluginOptions | undefined) => YwkfPlugin;
-
-interface ReactQueryPluginOptions {
-    /**
-     * 默认 staleTime（毫秒）
-     * @default 5 * 60 * 1000 (5 分钟)
-     */
-    staleTime?: number;
-    /**
-     * 默认 gcTime（毫秒）
-     * @default 10 * 60 * 1000 (10 分钟)
-     */
-    gcTime?: number;
-    /**
-     * 默认重试次数
-     * @default 1
-     */
-    retry?: number | boolean;
-    /**
-     * 是否开启 React Query DevTools（仅开发模式生效）
-     * @default true
-     */
-    devtools?: boolean;
-    /**
-     * axios baseURL
-     * @default ""
-     */
-    baseURL?: string;
-    /**
-     * 请求超时时间（毫秒）
-     * @default 15000
-     */
-    timeout?: number;
-}
-/**
- * React Query + Axios 请求层插件
- *
- * - 自动注入 QueryClientProvider
- * - 生成 .ywkf/query-client.ts（QueryClient 实例 + 默认配置）
- * - 生成 .ywkf/request.ts（axios 封装 + 拦截器骨架）
- * - 开发模式可选开启 React Query DevTools
- *
- * @example
- * ```ts
- * import { defineConfig, reactQueryPlugin } from "@4399ywkf/core";
- *
- * export default defineConfig({
- *   plugins: [
- *     reactQueryPlugin({ staleTime: 5 * 60 * 1000 }),
- *   ],
- * });
- * ```
- */
-declare const reactQueryPlugin: (options?: ReactQueryPluginOptions | undefined) => YwkfPlugin;
-
-interface TailwindPluginOptions {
-    /**
-     * 自定义暗色模式选择器
-     * @default '&:where([data-theme="dark"], [data-theme="dark"] *)'
-     */
-    darkModeSelector?: string;
-    /**
-     * 是否生成 postcss.config.js（如果不存在）
-     * @default true
-     */
-    autoConfig?: boolean;
-    /**
-     * 额外的 CSS 内容（追加到 index.css 之后）
-     */
-    extraCSS?: string;
-}
-/**
- * Tailwind CSS 插件
- *
- * 自动配置 Tailwind CSS：
- * - 注入 `@import "tailwindcss"` 到 index.css
- * - 确保 postcss.config.js 存在
- * - 修改 Rspack 配置添加 postcss-loader
- *
- * @example
- * ```ts
- * import { defineConfig, tailwindPlugin } from "@4399ywkf/core";
- *
- * export default defineConfig({
- *   plugins: [
- *     tailwindPlugin(),
- *   ],
- * });
- * ```
- */
-declare const tailwindPlugin: (options?: TailwindPluginOptions | undefined) => YwkfPlugin;
-
-interface ThemePluginOptions {
-    /**
-     * 是否启用暗色模式切换能力
-     * @default true
-     */
-    darkMode?: boolean;
-    /**
-     * 默认主题模式（运行时可通过 useThemeStore 动态切换）
-     * @default "light"
-     */
-    defaultAppearance?: "light" | "dark" | "auto";
-    /**
-     * 主色调（Lobe-UI 命名预设，运行时可通过 useThemeStore 动态切换）
-     *
-     * 不设置时使用 Lobe-UI 默认 primary 色阶（黑色系），
-     * 可选值："blue" | "cyan" | "geekblue" | "gold" | "green" | "lime"
-     *       | "magenta" | "orange" | "purple" | "red" | "volcano" | "yellow"
-     *
-     * @default undefined
-     */
-    primaryColor?: string;
-    /**
-     * 中性色（Lobe-UI 命名预设）
-     *
-     * 可选值："mauve" | "olive" | "sage" | "sand" | "slate"
-     *
-     * @default undefined
-     */
-    neutralColor?: string;
-    /**
-     * antd 组件前缀
-     *
-     * 支持三种配置方式（优先级从高到低）：
-     * 1. 运行时环境变量 process.env.YWKF_PREFIX_CLS
-     * 2. 插件选项中直接指定
-     * 3. 默认值 "ant"
-     *
-     * @default "ant"
-     */
-    prefixCls?: string;
-    /**
-     * 是否启用 CSS 变量
-     * @default true
-     */
-    cssVar?: boolean;
-    /**
-     * 是否注入全局样式重置
-     * @default true
-     */
-    globalReset?: boolean;
-    /**
-     * 是否启用外部主题注入（微前端场景）
-     *
-     * 启用后：
-     * - 应用启动时读取 window.__YWKF_THEME__ 作为初始覆盖
-     * - 监听 ywkf:theme-change 自定义事件，实现运行时主题同步
-     *
-     * @default false
-     */
-    externalTheme?: boolean;
-    /**
-     * 将 Tooltip / Dropdown / Modal 等弹层的挂载节点限定在 ThemeWrapper 容器内
-     *
-     * 解决问题：antd 弹层默认挂载到 document.body，在以下场景会导致样式失效：
-     * - 微前端子应用使用 StyleProvider 将样式注入到子应用容器，弹层挂载 body 后脱离样式范围
-     * - CSS 变量作用域被限定在特定容器，body 上的弹层无法继承
-     *
-     * 启用后会在 ThemeWrapper 内创建一个 `data-ywkf-root` 容器作为弹层挂载点，
-     * 该容器始终是 StyleProvider 的子孙节点，样式链路不会断裂。
-     *
-     * @default true
-     */
-    scopePopupContainer?: boolean;
-}
-/**
- * 响应式主题系统插件
- *
- * 基于 antd-style + @4399ywkf/theme-system + Zustand 提供运行时可变的主题管理：
- * - 使用 Lobe-UI 色彩体系（13 阶色阶 + 自定义算法）
- * - 支持 PrimaryColors / NeutralColors 命名预设
- * - 亮/暗色/跟随系统自动切换
- * - 支持微前端场景主应用注入主题
- *
- * @example
- * ```ts
- * import { defineConfig, themePlugin } from "@4399ywkf/core";
- *
- * export default defineConfig({
- *   plugins: [
- *     themePlugin({
- *       defaultAppearance: "light",
- *       primaryColor: "geekblue",
- *       neutralColor: "slate",
- *       prefixCls: "my-app",
- *     }),
- *   ],
- * });
- * ```
- */
-declare const themePlugin: (options?: ThemePluginOptions | undefined) => YwkfPlugin;
-
-interface ZustandPluginOptions {
-    /**
-     * 是否自动生成 store 脚手架（仅在 store/ 目录不存在时）
-     * @default true
-     */
-    scaffold?: boolean;
-    /**
-     * store 目录路径（相对于项目根目录）
-     * @default "store"
-     */
-    storeDir?: string;
-}
-/**
- * Zustand 状态管理插件
- *
- * 采用扁平域/Slice 架构：
- * - store/{domain}/slices/ 按业务域拆分
- * - 每个 slice 拆为 initialState.ts + actions.ts
- * - 域级 store.ts 聚合所有 slice
- * - 使用 StateCreator<Store, [['zustand/devtools', never]], [], Action> 标准范式
- * - 内置 devtools + subscribeWithSelector 中间件
- *
- * @example
- * ```ts
- * import { defineConfig, zustandPlugin } from "@4399ywkf/core";
- *
- * export default defineConfig({
- *   plugins: [
- *     zustandPlugin(),
- *   ],
- * });
- * ```
- */
-declare const zustandPlugin: (options?: ZustandPluginOptions | undefined) => YwkfPlugin;
-
-export { type AnalyticsPluginOptions, type BiomePluginOptions, type GarfishPluginOptions, GeneratorContext, type I18nPluginOptions, type MockPluginOptions, PluginConfig, PluginHooks, type ReactQueryPluginOptions, type TailwindPluginOptions, type ThemePluginOptions, YwkfConfig, YwkfGenerator, YwkfGeneratorPlugin, type YwkfGeneratorPluginOptions, YwkfPlugin, type ZustandPluginOptions, analyticsPlugin, biomePlugin, build, dev, garfishPlugin, getDefaultBiomeConfig, i18nPlugin, mockPlugin, reactQueryPlugin, tailwindPlugin, themePlugin, zustandPlugin };
+export { GeneratorContext, PluginConfig, PluginHooks, YwkfConfig, YwkfGenerator, YwkfGeneratorPlugin, type YwkfGeneratorPluginOptions, build, dev };