qimenjs

QimenJS 是一个模块化的 TypeScript 基础设施库，名字取自“奇门遁甲”——古代排兵布阵的术数体系。它通过能力组合（Ability）和数据管道（Pipeline）构建灵活的前端架构，提供事件系统、数据管道、实体管理、国际化、HTTP 客户端等 38 个独立子包，覆盖前端应用的基础层到 UI 层。 当前版本为 0.2.0，处于初始开发阶段，核心 API 和 UI 组件层已可用，框架流程已跑通，但 API 可能在后续版本中发生变化。 包列表按层次组织： - **基础层 (Layer 0)**：包含统一错误体系、日志系统、通用工具函数、异步工具、运行时环境检测、哈希与编解码、国际化、请求/事件上下文、跨包共享基础类型。 - **核心层 (Layer 1)**：包含注册表、事件总线、缓存管理、数据管道、能力组合、任务调度。 - **数据层 (Layer 2)**：包含数据处理器框架、验证引擎、DOM 事件适配（8 种手势识别）、MIME 类型解析、命名正则模式注册器、Schema 定义、权限系统。 - **服务层 (Layer 3)**：包含 HTTP 客户端（4 阶段管道 + 拦截器 + SSE 流式）、OAuth2 认证（密码/授权码/客户端凭证模式 + 401 自动刷新）、ABP 框架数据处理器、Spring Data 数据处理器、系统能力集。 - **应用层 (Layer 4)**：包含实体管理框架（5 种 Manager + Ability 组合架构）、路由系统（纯事件模式 + RouteAbility 组件能力）。 - **UI 层**：包含组件核心基础设施、UI 组件能力定义、UI 组件实现（Icon/Button/Toggle/Tabs/Card/Menu/Nav/Panel 等）、高级 UI 组件（Step/Timeline/Rating/PropertyGrid/OneTimePassword 等）、JSON 驱动的布局定义系统、主题资源（亮暗色 + 10 个中国风预设 + 用户自定义）、中国风图标库（102 个 SVG + 字体图标）、命令式 API（toast/msgbox）。 架构特点包括分层设计（依赖方向单一，不跨层引用）、能力组合（实体管理器通过 AbilityDefinition 动态组合能力）、管道式处理（数据请求/响应通过可插拔的处理器管道，ABP/Spring 开箱即用）、环境适配（核心包环境无关，浏览器/Node.js 通用）、类型安全（完整的 TypeScript 类型定义）。 示例目录 `examples/full-stack/` 包含完整的全栈演示，涵盖 OAuth2 认证、ABP API 用户管理、Spring Data 订单管理、36 个 QimenJS 子包的功能演示页面、国际化（i18n 预编译 + 动态语言切换）。 文档包括架构说明、包说明、最佳实践、API 参考。开发命令包括安装依赖、构建、运行测试、代码检查、生成 API 文档。版本号遵循 SemVer 规范，0.x.x 表示初始开发阶段。 本项目是 AI 辅助开发的项目，大部分代码由 AI 生成，感谢华为 CodeArts、Trae CN、ChatGPT、DeepSeek、Gemini、通义千问、FitEncode 等工具的贡献。许可证为 MIT。