用途:为 LlamaFarm 前端应用提供统一的 TypeScript 编码规范,适用于 designer/(React 18 + TanStack Query + TailwindCSS + Radix UI,Vite 构建)与 electron-app/(Electron 28 + electron-vite,含 electron-updater、axios)两个子系统。
主要能力:给出惯用 TypeScript 模式、严格类型与泛型/工具类型用法、Vitest 测试模式,以及 XSS 防护与输入校验等安全要点。核心原则包括始终启用严格模式、无明确理由不使用 any、对象形状优先用 interface、联合/交叉类型用 type、公开函数显式标注返回类型、使用 readonly 与 as const 保证不可变、显式处理 null/undefined 并避免非空断言。
配置:两个项目均使用严格 TypeScript,开启 strict、noUnusedLocals、noUnusedParameters、noFallthroughCasesInSwitch。
用法示例:React 组件用 interface Props 定义只读属性并标注返回类型;TanStack Query 通过 projectKeys 工厂生成查询键,配合 useQuery 与 enabled 控制请求;错误处理可继承 Error 定义 ApiError 类并携带 status 与 response。
相关文档:patterns.md、typing.md、testing.md、security.md。检查清单按 Typing、Patterns、Testing、Security 分类列出关键项数量。
限制:资料未提供安装命令、版本要求、收费方式及具体使用步骤,暂未提供。