跳转到内容

设计原则

  • import 本包没有运行时副作用。
  • 后续涉及浏览器全局对象时,必须延迟访问。
  • runtime core 保持框架无关。
  • logger、bridge、auth、analytics 通过 adapter 或 plugin 接入。
  • 业务方优先从根入口使用稳定 API,模块化 public subpath 只作为兼容和高级场景保留。
  • 通用 runtime 能力只沉淀基础能力,不吞掉业务 repository。
  • IndexedDB 封装保留 database、version、store、index 和 migration 语义,不做 ORM。
  • Clipboard 只封装文本写入剪贴板,不接管 toast、埋点、粘贴输入或特殊工具事件。
  • HTTP 只通过 createHttp().createApi() 创建业务 HTTP API,不暴露 public request()
  • HTTP 内部可以复用成熟请求库,但公开契约不暴露底层请求库类型。
  • 公共 API 通过 package.json#exports 暴露。
  • 新增 runtime 模块前,需要先明确职责边界并同步设计文档。

让基础能力保持简单,让业务开发更加专注。