应用开发者
包选择与安装
按职责选择十一个公开包；使用 package root exports，避免 workspace 或深层导入。从最小组合开始
| 需求 | 安装的包 | 职责 |
|---|---|---|
| 主题定义、校验与导入导出 | @oriatheme/core | 纯 TypeScript Contract；没有 DOM 或框架依赖。 |
| 官方主题与浏览器应用 | @oriatheme/presets + @oriatheme/runtime-dom | 完整预设目录、Runtime、持久化与 Bootstrap。 |
| React / Vue | @oriatheme/react / @oriatheme/vue | 薄适配层；不复制 Runtime 状态机。 |
| 稳定基础色 | @oriatheme/colors | 静态色阶及基础色 CSS subpaths。 |
| Tailwind v4 语义变量 | @oriatheme/tailwind | 静态 @theme inline bridge；Tailwind 仅为构建期依赖。 |
| 可见编辑器源码 | @oriatheme/cli | 将 React/Vue UI 复制到项目源码；桥接包保持 headless。 |
CSS subpaths
colors 与 tailwind 两个包提供公开 CSS 子路径。Runtime 变量不需要静态 OriaTheme stylesheet。
css
@import "@oriatheme/colors/styles.css";
/* Tailwind CSS v4 */
@import "tailwindcss";
@import "@oriatheme/colors/tailwind.css";
@import "@oriatheme/tailwind/oria.css";SSR 与 CLI 边界
除可执行 CLI 外，库 package root 都可在 SSR 模块求值时导入；但 Runtime 的 start、Storage Bootstrap、React Provider 和 Vue plugin 都只应在浏览器环境执行。不要从 src、dist 或 registry template 深层导入。
继续：Runtime、Bootstrap 与动画