包与公开入口
业务应用先按包选择确定直接依赖。以下状态以当前仓库的 0.1.0-beta.1 分发记录为准。
业务直接使用
| 包 | 作用 | 状态 |
|---|---|---|
@pwa-platform/vite | Vite 构建插件，生成并校验平台产物 | npm beta |
@pwa-platform/vue | createPwa()、usePwa() | npm beta |
@pwa-platform/react | PwaProvider、usePwa() | npm beta |
@pwa-platform/contracts | 配置 TypeScript 类型；仅在直接导入类型时单独安装 | npm beta |
@pwa-platform/vite 是构建配置中明确允许直接使用的底层入口。其余常规运行时能力应通过 Vue 或 React 绑定调用。
随上层自动安装
core 编译策略；client-runtime 负责页面侧注册与生命周期；sw-runtime 负责 worker 行为；engine-workbox 封装缓存引擎；build-verifier 核对产物。这些包虽已随首批分发，但业务应用不应把它们当成配置 API。
当前不供外部项目安装
nuxt、push、offline-write、entry-resilience、browser-test-harness、examples-browser-e2e 和 release-tools 仍是工作区私有包。前四者属于可选能力；后三者服务于平台测试与治理。
源仓库中的包边界文档定义每个入口允许的依赖和职责，若需要维护平台本身，应以该文档为准。