FOSMVVM React View Generator

⚛️ FOSMVVM 架构的 React 视图生成器

为 FOSMVVM 架构自动生成 React 组件及配套测试代码,严格遵循 View-ViewModel 对齐、无业务逻辑、意图导航等架构原则。

收藏
3.6k
安装
1.1k
版本
2.0.6
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心功能

FOSMVVM React View Generator 是一款专为 FOSMVVM 架构设计的代码生成工具,用于自动生成 React 组件及其对应的 Jest 测试文件。该工具遵循 TDD(测试驱动开发)工作流,先生成测试文件(初始状态为失败),再生成实现文件使测试通过。

显著优点

1. 架构严格性:强制践行 View-ViewModel 对齐原则,组件文件名与 ViewModel 名称一致,极大提升代码可发现性和可维护性
2. 零业务逻辑组件:通过 FOSMVVM.viewModelComponent() 包装器确保组件仅负责渲染,所有数据转换和计算均在 ViewModel 层完成

3. 标准化模式:内置 Display-only、Interactive、List、Form 四类组件模板,覆盖常见 UI 场景

4. 无 HTTP 调用:通过 .bind() 模式与 WASM 桥接层通信,消除硬编码 URL 和 fetch 调用

5. 意图驱动导航:使用 FOSMVVM.Linkintent 替代硬编码路由,实现平台无关的导航

潜在局限

1. 上下文依赖:高度依赖对话上下文获取 ViewModel 和 ServerRequest 信息,若前期讨论不充分可能生成不匹配的代码
2. 生态锁定:专为 FOSMVVM 架构设计,无法直接用于标准 React 项目或其他 MVVM 框架

3. 技术栈约束:要求使用特定版本的 FOSMVVM 运行时(通过 script 标签加载),与 npm 模块化生态存在张力

4. TypeScript 支持待验证:文档提及 TypeScript 类型,但未展示完整类型定义示例

适合人群

  • 采用 FOSMVVM 架构的全栈开发团队
  • 需要将 Leaf 模板迁移至 React 的现有项目
  • 追求极致架构一致性、厌恶 "Smart Component" 反模式的工程师
  • 需要同时维护 SwiftUI、Leaf、React 多端 View 的跨平台团队

常规风险

1. 全局命名空间污染:FOSMVVM 对象通过 script 标签注入全局作用域,可能与第三方库冲突
2. 测试脆弱性.bind() 模式的 ServerRequest 调用在单元测试中需要额外 mock 配置

3. WASM 桥接依赖:运行时依赖 WASM 桥接层,调试复杂度高于标准 REST/GraphQL 方案

4. 版本锁定:2026-01-23 初始版本,长期维护承诺和向后兼容性尚待观察

FOSMVVM React View Generator 内容

手动下载zip · 13.1 kB
reference.mdtext/markdown
请选择文件