@4399ywkf/core 4.0.84 → 5.0.0

package/dist/schema-BuqmN_ra.d.ts

@@ -0,0 +1,390 @@
+import { Configuration } from '@rspack/core';
+import { A as AppConfig, P as ProviderConfig } from './types-BZV_2QtD.js';
+
+/**
+ * 路由项定义
+ */
+interface RouteItem {
+    /** 路由路径 */
+    path: string;
+    /** 组件文件路径（相对于 src） */
+    component: string;
+    /** 是否为 index 路由 */
+    index?: boolean;
+    /** 是否为布局组件 */
+    isLayout?: boolean;
+    /** 子路由 */
+    children?: RouteItem[];
+    /** 路由元信息 */
+    meta?: RouteMeta;
+}
+/**
+ * 路由元信息
+ */
+interface RouteMeta {
+    /** 页面标题 */
+    title?: string;
+    /** 是否需要登录 */
+    auth?: boolean;
+    /** 自定义数据 */
+    [key: string]: unknown;
+}
+
+/**
+ * 插件上下文
+ */
+interface PluginContext {
+    /** 工作目录 */
+    cwd: string;
+    /** 是否开发模式 */
+    isDev: boolean;
+    /** 是否生产模式 */
+    isProd: boolean;
+    /** 用户配置 */
+    config: Required<YwkfConfig>;
+    /** 日志工具 */
+    logger: PluginLogger;
+}
+/**
+ * 插件日志工具
+ */
+interface PluginLogger {
+    info: (message: string) => void;
+    warn: (message: string) => void;
+    error: (message: string) => void;
+    debug: (message: string) => void;
+}
+/**
+ * 构建阶段钩子
+ */
+interface BuildHooks {
+    /**
+     * 修改 Rspack 配置
+     */
+    modifyRspackConfig?: (config: Configuration, context: PluginContext) => Configuration | void | Promise<Configuration | void>;
+    /**
+     * 构建开始前
+     */
+    beforeBuild?: (context: PluginContext) => void | Promise<void>;
+    /**
+     * 构建完成后
+     */
+    afterBuild?: (context: PluginContext, stats: {
+        success: boolean;
+        errors?: string[];
+    }) => void | Promise<void>;
+    /**
+     * 开发服务器启动前
+     */
+    beforeDevServer?: (context: PluginContext) => void | Promise<void>;
+    /**
+     * 开发服务器启动后
+     */
+    afterDevServer?: (context: PluginContext, server: {
+        port: number;
+        host: string;
+    }) => void | Promise<void>;
+}
+/**
+ * 路由阶段钩子
+ */
+interface RouterHooks {
+    /**
+     * 修改路由配置
+     */
+    modifyRoutes?: (routes: RouteItem[], context: PluginContext) => RouteItem[] | void | Promise<RouteItem[] | void>;
+    /**
+     * 路由生成后
+     */
+    afterRoutesGenerated?: (routes: RouteItem[], context: PluginContext) => void | Promise<void>;
+}
+/**
+ * 运行时阶段钩子
+ */
+interface RuntimeHooks {
+    /**
+     * 修改运行时配置
+     */
+    modifyAppConfig?: (appConfig: AppConfig, context: PluginContext) => AppConfig | void;
+    /**
+     * 添加 Provider
+     */
+    addProvider?: (context: PluginContext) => ProviderConfig | ProviderConfig[];
+    /**
+     * 应用渲染前
+     */
+    beforeRender?: (context: PluginContext) => void;
+    /**
+     * 应用渲染后
+     */
+    afterRender?: (context: PluginContext) => void;
+}
+/**
+ * 生成的文件
+ */
+interface GeneratedFile {
+    /** 文件路径（相对于 .ywkf 目录） */
+    path: string;
+    /** 文件内容 */
+    content: string;
+}
+/**
+ * 代码生成器上下文
+ */
+interface GeneratorContext {
+    /** 工作目录 */
+    cwd: string;
+    /** 输出目录（.ywkf） */
+    outputDir: string;
+    /** 用户配置 */
+    config: Required<YwkfConfig>;
+    /** 是否开发模式 */
+    isDev: boolean;
+}
+/**
+ * 代码注入点
+ */
+interface CodeInjection {
+    /** 导入语句 */
+    imports?: string[];
+    /** 顶层代码（在函数外部） */
+    topLevel?: string[];
+    /** 导出语句 */
+    exports?: string[];
+}
+/**
+ * 代码生成阶段钩子
+ */
+interface GeneratorHooks {
+    /**
+     * 修改入口文件代码
+     */
+    modifyEntryCode?: (code: string, context: GeneratorContext) => string | void;
+    /**
+     * 修改启动文件代码
+     */
+    modifyBootstrapCode?: (code: string, context: GeneratorContext) => string | void;
+    /**
+     * 注入入口代码
+     * 返回需要注入到入口文件的代码片段
+     */
+    injectEntry?: (context: GeneratorContext) => CodeInjection | void;
+    /**
+     * 注入启动代码
+     * 返回需要注入到启动文件的代码片段
+     */
+    injectBootstrap?: (context: GeneratorContext) => CodeInjection | void;
+    /**
+     * 生成额外文件
+     */
+    generateFiles?: (context: GeneratorContext) => GeneratedFile[] | void;
+    /**
+     * 代码生成完成后
+     */
+    afterGenerate?: (context: GeneratorContext) => void | Promise<void>;
+}
+/**
+ * 插件钩子集合
+ */
+interface PluginHooks extends BuildHooks, RouterHooks, RuntimeHooks, GeneratorHooks {
+}
+/**
+ * 插件定义
+ */
+interface YwkfPlugin {
+    /** 插件名称 */
+    name: string;
+    /** 插件版本 */
+    version?: string;
+    /** 插件描述 */
+    description?: string;
+    /**
+     * 插件初始化
+     * @returns 插件钩子
+     */
+    setup: (context: PluginContext) => PluginHooks | Promise<PluginHooks>;
+}
+/**
+ * 插件配置（用户在 ywkf.config.ts 中使用）
+ */
+type PluginConfig = string | YwkfPlugin | [string, Record<string, unknown>] | [YwkfPlugin, Record<string, unknown>];
+/**
+ * 创建插件的辅助函数类型
+ */
+type DefinePlugin = (options?: Record<string, unknown>) => YwkfPlugin;
+/**
+ * 插件 API（传递给插件的 setup 函数）
+ */
+interface PluginAPI {
+    /** 获取配置 */
+    getConfig: () => Required<YwkfConfig>;
+    /** 获取工作目录 */
+    getCwd: () => string;
+    /** 是否开发环境 */
+    isDev: () => boolean;
+    /** 添加 Rspack 插件 */
+    addRspackPlugin: (plugin: unknown) => void;
+    /** 修改 Rspack 配置 */
+    modifyRspackConfig: (modifier: (config: Configuration) => Configuration | void) => void;
+}
+
+/**
+ * 开发服务器配置
+ */
+interface DevServerConfig {
+    /** 开发服务器端口 */
+    port?: number;
+    /** 开发服务器主机 */
+    host?: string;
+    /** 代理配置 */
+    proxy?: Record<string, string | object>;
+    /** 是否开启 HTTPS */
+    https?: boolean;
+}
+/**
+ * 输出配置
+ */
+interface OutputConfig {
+    /** 输出目录 */
+    path?: string;
+    /** 公共路径 */
+    publicPath?: string;
+    /** 是否清理输出目录 */
+    clean?: boolean;
+}
+/**
+ * HTML 配置
+ */
+interface HtmlConfig {
+    /** 页面标题 */
+    title?: string;
+    /** HTML 模板路径 */
+    template?: string;
+    /** favicon 路径 */
+    favicon?: string;
+    /** 挂载根元素 ID */
+    mountRoot?: string;
+}
+/**
+ * 样式配置
+ */
+interface StyleConfig {
+    /** 是否启用 CSS Modules */
+    cssModules?: boolean;
+    /** Less 配置 */
+    less?: {
+        /** 是否启用 */
+        enabled?: boolean;
+        /** Less 选项 */
+        lessOptions?: Record<string, unknown>;
+    };
+    /** Sass 配置 */
+    sass?: {
+        /** 是否启用 */
+        enabled?: boolean;
+        /** Sass 选项 */
+        sassOptions?: Record<string, unknown>;
+    };
+    /** 是否启用 TailwindCSS */
+    tailwindcss?: boolean;
+}
+/**
+ * 路由配置
+ */
+interface RouterConfig {
+    /** 路由基础路径 */
+    basename?: string;
+    /** 是否启用约定式路由 */
+    conventional?: boolean;
+    /** 约定式路由扫描目录 */
+    pagesDir?: string;
+    /** 排除的文件/目录模式 */
+    exclude?: (string | RegExp)[];
+}
+/**
+ * 微前端配置
+ */
+interface MicroFrontendConfig {
+    /** 是否启用微前端模式 */
+    enabled?: boolean;
+    /** 应用名称（用于 UMD 导出） */
+    name?: string;
+    /** 微前端框架类型 */
+    framework?: "qiankun" | "garfish";
+}
+/**
+ * 性能配置
+ */
+interface PerformanceConfig {
+    /** 是否启用 Rsdoctor 分析 */
+    rsdoctor?: boolean;
+    /** 是否开启代码分割 */
+    splitChunks?: boolean;
+    /** 是否移除 console */
+    dropConsole?: boolean;
+}
+/**
+ * 工具链配置
+ */
+interface ToolsConfig {
+    /**
+     * 自定义 Rspack 配置
+     * @param config 当前配置
+     * @param context 上下文信息
+     * @returns 修改后的配置
+     */
+    rspack?: (config: Configuration, context: {
+        isDev: boolean;
+        isProd: boolean;
+    }) => Configuration | void;
+}
+/**
+ * 环境变量配置
+ */
+interface EnvConfig {
+    /** 公共环境变量文件路径 */
+    publicEnvFile?: string;
+    /** 环境特定的变量文件目录 */
+    envDir?: string;
+}
+/**
+ * 框架完整配置
+ */
+interface YwkfConfig {
+    /** 应用名称 */
+    appName?: string;
+    /** 应用中文名 */
+    appCName?: string;
+    /** 开发服务器配置 */
+    dev?: DevServerConfig;
+    /** 输出配置 */
+    output?: OutputConfig;
+    /** HTML 配置 */
+    html?: HtmlConfig;
+    /** 样式配置 */
+    style?: StyleConfig;
+    /** 路由配置 */
+    router?: RouterConfig;
+    /** 微前端配置 */
+    microFrontend?: MicroFrontendConfig;
+    /** 性能配置 */
+    performance?: PerformanceConfig;
+    /** 工具链配置 */
+    tools?: ToolsConfig;
+    /** 环境变量配置 */
+    env?: EnvConfig;
+    /** 路径别名 */
+    alias?: Record<string, string>;
+    /** 插件列表 */
+    plugins?: PluginConfig[];
+}
+/**
+ * 定义配置的辅助函数（提供类型提示）
+ */
+declare function defineConfig(config: YwkfConfig): YwkfConfig;
+/**
+ * 默认配置
+ */
+declare const defaultConfig: Required<YwkfConfig>;
+
+export { type BuildHooks as B, type CodeInjection as C, type DevServerConfig as D, type EnvConfig as E, type GeneratorContext as G, type HtmlConfig as H, type MicroFrontendConfig as M, type OutputConfig as O, type PerformanceConfig as P, type RouterConfig as R, type StyleConfig as S, type ToolsConfig as T, type YwkfConfig as Y, defaultConfig as a, type PluginHooks as b, type PluginConfig as c, defineConfig as d, type YwkfPlugin as e, type PluginContext as f, type RouterHooks as g, type RuntimeHooks as h, type GeneratorHooks as i, type GeneratedFile as j, type RouteItem as k, type PluginLogger as l, type PluginAPI as m, type DefinePlugin as n };

package/dist/types-BZV_2QtD.d.ts

@@ -0,0 +1,97 @@
+import { ReactNode } from 'react';
+import { createBrowserRouter } from 'react-router';
+
+/** 路由实例类型 */
+type RouterInstance = ReturnType<typeof createBrowserRouter>;
+/**
+ * 应用配置
+ */
+interface AppConfig {
+    /** 应用名称 */
+    appName?: string;
+    /** 路由实例（手动配置时使用） */
+    router?: RouterInstance;
+    /** 路由 basename */
+    basename?: string;
+    /**
+     * 使用约定式路由
+     * 设为 true 时，框架自动从 @ywkf/routes 加载生成的路由
+     * 无需手动配置 router
+     */
+    conventionalRoutes?: boolean;
+    /** 根元素 ID */
+    rootId?: string;
+    /** 是否启用严格模式 */
+    strictMode?: boolean;
+    /** Ant Design 配置 */
+    antd?: AntdConfig;
+    /** 自定义 Providers */
+    providers?: ProviderConfig[];
+    /** 生命周期钩子 */
+    lifecycle?: LifecycleHooks;
+}
+/**
+ * Ant Design 配置
+ */
+interface AntdConfig {
+    /** 是否启用 */
+    enabled?: boolean;
+    /** 主题配置 */
+    theme?: Record<string, unknown>;
+    /** 语言包 */
+    locale?: object;
+    /** ConfigProvider props */
+    configProvider?: Record<string, unknown>;
+}
+/**
+ * Provider 配置
+ */
+interface ProviderConfig {
+    /** Provider 组件 */
+    component: React.ComponentType<{
+        children: ReactNode;
+    }>;
+    /** Provider props */
+    props?: Record<string, unknown>;
+    /** 排序权重（越小越外层） */
+    order?: number;
+}
+/**
+ * 生命周期钩子
+ */
+interface LifecycleHooks {
+    /** 应用挂载前 */
+    onBeforeMount?: () => void | Promise<void>;
+    /** 应用挂载后 */
+    onMounted?: () => void;
+    /** 应用卸载时 */
+    onUnmount?: () => void;
+    /** 全局错误处理 */
+    onError?: (error: Error, errorInfo?: React.ErrorInfo) => void;
+}
+/**
+ * 应用上下文数据
+ */
+interface AppContextValue {
+    /** 应用名称 */
+    appName: string;
+    /** 路由 basename */
+    basename: string;
+    /** 是否开发环境 */
+    isDev: boolean;
+    /** 环境变量 */
+    env: Record<string, string | undefined>;
+}
+/**
+ * 微前端相关配置
+ */
+interface MicroAppConfig {
+    /** 是否作为子应用运行 */
+    isMicroApp?: boolean;
+    /** 微前端框架类型 */
+    framework?: "qiankun" | "garfish";
+    /** 主应用传递的 props */
+    masterProps?: Record<string, unknown>;
+}
+
+export type { AppConfig as A, LifecycleHooks as L, MicroAppConfig as M, ProviderConfig as P, AntdConfig as a, AppContextValue as b };

package/package.json

@@ -1,49 +1,100 @@
 {
   "name": "@4399ywkf/core",
-  "version": "4.0.84",
-  "homepage": "https://github.com/umijs/umi/tree/master/packages/core#readme",
-  "bugs": "https://github.com/umijs/umi/issues",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/umijs/umi"
+  "version": "5.0.0",
+  "description": "4399运维客服前端框架核心",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./config": {
+      "types": "./dist/config/index.d.ts",
+      "import": "./dist/config/index.js"
+    },
+    "./rspack": {
+      "types": "./dist/rspack/index.d.ts",
+      "import": "./dist/rspack/index.js"
+    },
+    "./router": {
+      "types": "./dist/router/index.d.ts",
+      "import": "./dist/router/index.js"
+    },
+    "./runtime": {
+      "types": "./dist/runtime/index.d.ts",
+      "import": "./dist/runtime/index.js"
+    },
+    "./plugin": {
+      "types": "./dist/plugin/index.d.ts",
+      "import": "./dist/plugin/index.js"
+    }
+  },
+  "bin": {
+    "ywkf": "./dist/cli/index.js"
   },
-  "license": "MIT",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
   "files": [
-    "dist",
-    "compiled"
+    "dist"
   ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit"
+  },
   "dependencies": {
-    "@4399ywkf/bundler-utils": "4.0.84",
-    "@4399ywkf/utils": "4.0.84"
+    "@rsdoctor/rspack-plugin": "^1.1.0",
+    "@rspack/cli": "^1.3.6",
+    "@rspack/core": "^1.3.6",
+    "@svgr/webpack": "^8.1.0",
+    "@tailwindcss/postcss": "^4.2.1",
+    "assert": "^2.1.0",
+    "autoprefixer": "^10.4.27",
+    "browserify-zlib": "^0.2.0",
+    "buffer": "^6.0.3",
+    "chalk": "^5.4.1",
+    "commander": "^13.1.0",
+    "crypto-browserify": "^3.12.1",
+    "css-loader": "^7.1.2",
+    "deepmerge": "^4.3.1",
+    "dotenv": "^16.5.0",
+    "esbuild-register": "^3.6.0",
+    "jiti": "^2.4.2",
+    "less": "^4.3.0",
+    "less-loader": "^12.3.0",
+    "ora": "^8.2.0",
+    "path-browserify": "^1.0.1",
+    "postcss": "^8.5.3",
+    "postcss-loader": "^8.1.1",
+    "process": "^0.11.10",
+    "querystring-es3": "^0.2.1",
+    "sass": "^1.86.0",
+    "sass-loader": "^16.0.5",
+    "stream-browserify": "^3.0.0",
+    "style-loader": "^4.0.0",
+    "url": "^0.11.4",
+    "util": "^0.12.5",
+    "webpack-merge": "^6.0.1"
   },
   "devDependencies": {
-    "dotenv": "16.0.0",
-    "dotenv-expand": "8.0.3",
-    "just-diff": "5.2.0"
+    "@types/node": "^22.13.10",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "antd": "^6.3.1",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "react-router": "^7.13.1",
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.2"
   },
-  "publishConfig": {
-    "access": "public"
+  "peerDependencies": {
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0"
   },
-  "authors": [
-    "chencheng <sorrycc@gmail.com> (https://github.com/sorrycc)"
-  ],
-  "compiledConfig": {
-    "deps": [
-      "dotenv",
-      "just-diff"
-    ],
-    "externals": {
-      "dotenv": "$$LOCAL",
-      "just-diff": "$$LOCAL",
-      "tapable": "@4399ywkf/bundler-utils/compiled/tapable"
-    }
+  "engines": {
+    "node": ">=18.0.0"
   },
-  "scripts": {
-    "build": "umi-scripts father build",
-    "build:deps": "umi-scripts bundleDeps",
-    "dev": "umi-scripts father dev",
-    "test": "umi-scripts jest-turbo"
+  "publishConfig": {
+    "access": "public"
   }
-}
+}

package/README.md

@@ -1,3 +0,0 @@
-# @4399ywkf/core
-
-See our website [umijs](https://umijs.org) for more information.

package/compiled/dotenv/LICENSE

@@ -1,23 +0,0 @@
-Copyright (c) 2015, Scott Motte
-All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are met:
-
-* Redistributions of source code must retain the above copyright notice, this
-  list of conditions and the following disclaimer.
-
-* Redistributions in binary form must reproduce the above copyright notice,
-  this list of conditions and the following disclaimer in the documentation
-  and/or other materials provided with the distribution.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
-FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
-SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
-CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
-OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/compiled/dotenv/index.js

@@ -1 +0,0 @@
-(function(){var e={875:function(e,r,n){const o=n(147);const t=n(17);const s=n(37);const i=/(?:^|^)\s*(?:export\s+)?([\w.-]+)(?:\s*=\s*?|:\s+?)(\s*'(?:\\'|[^'])*'|\s*"(?:\\"|[^"])*"|\s*`(?:\\`|[^`])*`|[^#\r\n]+)?\s*(?:#.*)?(?:$|$)/gm;function parse(e){const r={};let n=e.toString();n=n.replace(/\r\n?/gm,"\n");let o;while((o=i.exec(n))!=null){const e=o[1];let n=o[2]||"";n=n.trim();const t=n[0];n=n.replace(/^(['"`])([\s\S]*)\1$/gm,"$2");if(t==='"'){n=n.replace(/\\n/g,"\n");n=n.replace(/\\r/g,"\r")}r[e]=n}return r}function _log(e){console.log(`[dotenv][DEBUG] ${e}`)}function _resolveHome(e){return e[0]==="~"?t.join(s.homedir(),e.slice(1)):e}function config(e){let r=t.resolve(process.cwd(),".env");let n="utf8";const s=Boolean(e&&e.debug);const i=Boolean(e&&e.override);if(e){if(e.path!=null){r=_resolveHome(e.path)}if(e.encoding!=null){n=e.encoding}}try{const e=c.parse(o.readFileSync(r,{encoding:n}));Object.keys(e).forEach((function(r){if(!Object.prototype.hasOwnProperty.call(process.env,r)){process.env[r]=e[r]}else{if(i===true){process.env[r]=e[r]}if(s){if(i===true){_log(`"${r}" is already defined in \`process.env\` and WAS overwritten`)}else{_log(`"${r}" is already defined in \`process.env\` and was NOT overwritten`)}}}}));return{parsed:e}}catch(e){if(s){_log(`Failed to load ${r} ${e.message}`)}return{error:e}}}const c={config:config,parse:parse};e.exports.config=c.config;e.exports.parse=c.parse;e.exports=c},147:function(e){"use strict";e.exports=require("fs")},37:function(e){"use strict";e.exports=require("os")},17:function(e){"use strict";e.exports=require("path")}};var r={};function __nccwpck_require__(n){var o=r[n];if(o!==undefined){return o.exports}var t=r[n]={exports:{}};var s=true;try{e[n](t,t.exports,__nccwpck_require__);s=false}finally{if(s)delete r[n]}return t.exports}if(typeof __nccwpck_require__!=="undefined")__nccwpck_require__.ab=__dirname+"/";var n=__nccwpck_require__(875);module.exports=n})();