@xihan-ui/styles 1.0.0 → 2.0.0

package/README.md

@@ -1,13 +1,13 @@
 # @xihan-ui/styles
 
-默认皮肤：125 份纯 CSS，零 JS。只按 `[data-scope][data-part]` 与 `data-*` 选中，不匹配标签名也不匹配 class——所以整套换掉它不影响任何行为。
+默认皮肤：145 份纯 CSS，零 JS。只按 `[data-scope][data-part]` 与 `data-*` 选中，不匹配标签名也不匹配 class——所以整套换掉它不影响任何行为。
 
 **谁会装它**：不想自己写样式的人装它。要做自己的设计语言，就不装，照解剖文档写一套自己的。
 
 ## 用法
 
 ```ts
-/* 全量 */
+/* 全量：主入口是生成的扁平文件，家族配方在公共层之后只内联一次、排在一切组件皮肤之前，除令牌外没有 @import */
 import '@xihan-ui/styles'
 
 /* 或按需：令牌与层序先行，tone 决定语气轴，缺了它 tone 会静默回落品牌色 */
@@ -16,6 +16,26 @@ import '@xihan-ui/styles/tone.css'
 import '@xihan-ui/styles/button.css'
 ```
 
+单皮肤文件头各自 `@import` 所属家族，单独引入时家族在场；混用多份单皮肤时每份都各带一份家族 `@import`，打包器不去重 `@import`（如 `@tailwindcss/vite` 自带的内联器）就会把家族复制多份。引入的皮肤超过几份时改用主入口。
+
+`button.css` 已传递引入 Action Control Family Recipe；需要给自定义解剖接入同一视觉合同时，也可单独引入 `@xihan-ui/styles/action-control.css`，并使用文档化的 `data-xh-action-*` 角色属性。家族缺省是无顶光、无描边、无投影的平面中性动作；品牌实心、显式边界与海拔必须由消费组件通过状态槽明确映射。
+
+`text-field.css` 已传递引入 Field Chrome 与字段内 Action Control；自定义字段可单独引入
+`@xihan-ui/styles/field-chrome.css`，并由 Headless 投影 `data-xh-field-chrome/input/affix/layout/size`
+角色。家族配方不读取组件名、标签名或未命名空间的业务属性。
+
+`select.css` 已传递引入 Collection Item；自定义集合可单独引入
+`@xihan-ui/styles/collection-item.css`，并用 `data-xh-collection-item/size/context/slot` 投影稳定角色；
+选择、禁用与加载直接读取 `aria-selected/aria-disabled/aria-busy`，路径、高亮、当前与对号继续使用状态词汇表里的
+`data-in-path/data-highlighted/data-current/data-state`。
+Menu、Mention、Command 等导航候选在各自迁移前不会被
+机械标成持久选择。对号在 `aria-selected='true'` 或 `data-state='checked'` 时显示；`overlay` 上下文只画行尾对号，
+`page` 上下文另铺品牌淡底行面并把对号放在行首，`data-current` 画起始侧指示条；pressed 面由家族给出。
+`nav` 上下文给横向导航（Tabs line trigger、Anchor / Breadcrumb link、Menubar / NavigationMenu trigger）：静息透明面 +
+muted 字，hover 100 → pressed 200 只换面，`data-in-path` 与 hover 同档，`data-current` = 透明面 + 品牌深字 + medium，
+2px 指示条由组件自己的滑动 indicator 部件承担；`data-xh-collection-terminal` 标不可点的当前页（面包屑），
+`--xh-fg-default` + medium、cursor default，不响应 hover / pressed。
+
 ## 装
 
 ```bash