veltra-styles

生成物

文件	内容
generated/theme-tokens.md	`Theme` 类型与 `light`/`dark` 预设 TS
generated/scss-api.md	`_mixins`、`_functions`、`_vars` 完整 SCSS
generated/theme-ts-api.md	`UITheme`、`loadTheme`、`helper` 等 TS
generated/manifest.json	同步时间与输出文件列表
references/theming-guide.md	快速开始、暗色、自定义主题、组件 token

运行 bun run sync-veltra-styles 或 bun run sync-skills 重新生成 generated/。

Theme 类型（theme/type.ts）描述颜色、字号、边框等嵌套 token 树。
UITheme 类（theme/ui-theme.ts）持有 theme 对象，将其拍平为 --u-* CSS 变量并注入文档（内置主题走 injectBuiltInThemes，自定义走 render()）。
loadTheme()（load-theme.ts）在浏览器侧初始化：默认注册 light/dark、同步 useConfig 的文档尺寸 class；可选传入自定义 UITheme。