外观
设计原则
- 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,不暴露 publicrequest()。 - HTTP 内部可以复用成熟请求库,但公开契约不暴露底层请求库类型。
- 公共 API 通过
package.json#exports暴露。 - 新增 runtime 模块前,需要先明确职责边界并同步设计文档。