兼容与使用边界

React 首发

本版本只提供 React 包，peer 范围为 React / React DOM 19。没有 Vue、Nuxt 或移动原生适配包，不能直接复用 Web 材质渲染为 Apple 原生 Liquid Glass。

采用 ESM 与独立 CSS 入口。组件包与官网沿用现有锁文件，Vite、Base UI 和 Motion 工具链没有在本轮整体升级。

静态正文与客户端交互

官网在构建时生成每条路由的 HTML，使用一致的 React renderToString / hydrateRoot。可索引的说明、API 与源码不依赖所有示例加载。

重型示例在接近视口时作为客户端 island 加载；Portal 与浏览器交互只在浏览器执行。应用使用 SSR 时需要保持首帧主题、初始状态和 ID 一致。

现代浏览器与材质降级

不支持 backdrop-filter 或请求减少透明时，材质应回退到稳定背景。系统高对比度和 forced colors 保留边界与状态。

自动 Chromium、Firefox 与 Playwright WebKit 的结果只覆盖对应自动化引擎；真实 Safari/iOS、人工读屏和实际背景对比度仍需在业务场景中验证。

Alpha 边界

Sheet 当前为单展开位与拖动关闭；Slider 示例为单值。三套 recipes 是本地组件组合，AI 工作台使用静态 fixture，没有模型密钥、消息后端或真实文件上传。