@xihan-ui/styles 2.0.0 → 2.1.0

package/css/toggle.css

@@ -14,7 +14,7 @@
 
   /* 未按下的四档形态由家族形态矩阵按 data-xh-action-variant 给出（缺省 subtle 由连接层显式投影；solid 未按下时
      投 ghost，只在按下时才是品牌实心）；公开槽桥接到矩阵之前：使用者槽 → 形态矩阵 → 家族缺省。
-     按下（on）是 §7.3 无滑块开关的选中面：品牌淡底 12 → 悬停 20 → 按压 28，前景 fg-on-brand-subtle，
+     按下（on）是无滑块开关的选中面：品牌淡底 12 → 悬停 20 → 按压 28，前景 fg-on-brand-subtle，
      私有槽在下面的 data-state='on' 块里接到桥接槽上。 */
   [data-scope='toggle'][data-part='root'] {
     --xh-_toggle-bg-on: var(--xh-toggle-bg-on, var(--xh-_tone-subtle, var(--xh-bg-brand-subtle)));
@@ -97,7 +97,7 @@
     --xh-action-border-disabled: var(--xh-_toggle-border-on);
   }
 
-  /* 使用者的 --xh-toggle-shadow 只落在按下面上：矩阵各态无影，淡底与阴影互斥（§5.3） */
+  /* 使用者的 --xh-toggle-shadow 只落在按下面上：矩阵各态无影，淡底与阴影互斥 */
   [data-scope='toggle'][data-part='root'][data-state='on'] {
     --xh-action-shadow-rest: var(--xh-toggle-shadow, none);
     --xh-action-shadow-hover: var(--xh-toggle-shadow, none);

package/css/tool-call.css

@@ -16,7 +16,7 @@
     --xh-tool-call-skin: 1;
   }
 
-  /* 一张静态内容面：--xh-border-default 描边 + surface 底 + 无影（§5.3 边界只由描边承担）；
+  /* 一张静态内容面：--xh-border-default 描边 + surface 底 + 无影（边界只由描边承担）；
      审批位与详情区的内部分隔线走另一支 --xh-tool-call-divider（subtle）。
      卡片建出来时淡入并向上收一段，一屏若干张的错峰交给外层容器排 */
   [data-scope='tool-call'][data-part='root'] {
@@ -29,7 +29,7 @@
     /* 影另落一份进私有槽给语气档：它要把影与左侧色条叠成一条 box-shadow，缺省无影写成零影占位 */
     --xh-_tool-call-shadow: var(--xh-tool-call-shadow, 0 0 0 transparent);
 
-    /* 作者塞进指示符里的图标与皮肤画的兜底字形同一把尺：md 档（§6.5），开关上另按家族档取值 */
+    /* 作者塞进指示符里的图标与皮肤画的兜底字形同一把尺：md 档，开关上另按家族档取值 */
     --xh-icon-size: var(--xh-tool-call-icon-size, var(--xh-glyph-size-md));
 
     display: block;
@@ -49,7 +49,7 @@
   /* —— 形态 —— */
   /* 缺省档即 outline，写在上面那条基础规则里 */
   /* 底色分区：描边让位给底色，嵌在别人的面里时不再多一圈线；
-     淡底承载面向开关下发 hover 200 → pressed 300（§7.2） */
+     淡底承载面向开关下发 hover 200 → pressed 300 */
   [data-scope='tool-call'][data-part='root'][data-variant='subtle'] {
     --xh-action-host-bg-hover: var(--xh-bg-subtle-hover);
     --xh-action-host-bg-pressed: var(--xh-bg-subtle-active);
@@ -84,7 +84,7 @@
   }
 
   /* 开关铺满一行，盒型、悬停 / 按下 / 禁用面由 Action Control 的 disclosure-trigger 档给（ghost 形态：
-     白底承载 hover 100 → pressed 200，按下只换面不缩放，§9.2）；这里只把使用者槽映射到桥接槽：
+     白底承载 hover 100 → pressed 200，按下只换面不缩放）；这里只把使用者槽映射到桥接槽：
      圆角归零贴住卡边，内衬与字号沿用卡片的档位（不取 profile 的 md 档内衬，几何不变），
      字形按开关自己的档位取 --xh-_action-profile-glyph-size */
   [data-scope='tool-call'][data-part='trigger'] {
@@ -309,7 +309,7 @@
     animation: xh-disclosure-expand var(--xh-motion-duration-enter) var(--xh-motion-ease-enter-strong);
   }
 
-  /* 退场走 exit 档曲线（§9.4） */
+  /* 退场走 exit 档曲线 */
   [data-scope='tool-call'][data-part='content'][data-state='closed'] {
     animation: xh-disclosure-collapse var(--xh-motion-duration-exit) var(--xh-motion-ease-exit) forwards;
   }

package/css/toolbar.css

@@ -69,7 +69,7 @@
   }
 
   /* 淡底档：带内距、换成 subtle 底，描边让位给底色但留住 1px 边位（与 outline 几何一致），无影；
-     淡底承载面向条目下发 hover 200 → pressed 300（§7.2） */
+     淡底承载面向条目下发 hover 200 → pressed 300 */
   [data-scope='toolbar'][data-part='root'][data-variant='subtle'] {
     --xh-_toolbar-root-p: var(--xh-_toolbar-p);
     --xh-_toolbar-root-border-width: var(--xh-stroke-thin);
@@ -78,7 +78,7 @@
     --xh-action-host-bg-pressed: var(--xh-bg-subtle-active);
   }
 
-  /* 附着式工具面：一张静态内容面，--xh-border-default 描边 + surface 底 + 无影（§5.3 边界只由描边承担）。 */
+  /* 附着式工具面：一张静态内容面，--xh-border-default 描边 + surface 底 + 无影（边界只由描边承担）。 */
   [data-scope='toolbar'][data-part='root'][data-variant='outline'] {
     --xh-_toolbar-root-p: var(--xh-_toolbar-p);
     --xh-_toolbar-root-border-width: var(--xh-stroke-thin);
@@ -145,7 +145,7 @@
 
   /* 默认条目是一枚无描边工具按钮：盒型、三档几何、悬停 / 按下 / 禁用面与按压缩放由 Action Control 的
      text 档给（ghost 形态：ghost 根按画布承载 hover 100 → pressed 200，subtle 根与分组由 host 槽下发
-     200 → 300，§7.2）；这里只把使用者槽映射到桥接槽（-gap / -h / -px / -radius / -bg / -bg-hover /
+     200 → 300）；这里只把使用者槽映射到桥接槽（-gap / -h / -px / -radius / -bg / -bg-hover /
      -bg-active / -bg-disabled / -fg / -font-size 保留为第一参数）。作者仍可用类名或内联样式完整覆盖。 */
   [data-scope='toolbar'][data-part='item'] {
     --xh-action-gap: var(--xh-toolbar-item-gap, var(--xh-control-gap-sm));
@@ -165,7 +165,7 @@
     touch-action: manipulation;
   }
 
-  /* 无滑块开关的按下态（§7.3）：品牌淡底 + 淡底前景，hover / 按下沿 12% → 20% → 28% 三档走；
+  /* 无滑块开关的按下态：品牌淡底 + 淡底前景，hover / 按下沿 12% → 20% → 28% 三档走；
      三态都经桥接槽交给家族画，禁用面仍由家族按 data-disabled 给 */
   [data-scope='toolbar'][data-part='item'][aria-pressed='true'] {
     --xh-action-bg-rest: var(--xh-toolbar-item-bg-pressed, var(--xh-bg-brand-subtle));

package/css/tooltip.css

@@ -75,10 +75,10 @@
     --xh-_tooltip-py: var(--xh-space-1);
     --xh-_tooltip-px: var(--xh-space-2);
     --xh-_tooltip-font-size: var(--xh-control-caption-md);
-    /* Tooltip 保留反白身份（真源 §8.4 登记的反白 compact frosted）：短提示要与可交互的普通主题浮层一眼分开。
+    /* Tooltip 保留反白身份（登记的反白 compact frosted）：短提示要与可交互的普通主题浮层一眼分开。
        94% 是六种 tone 在纯黑/纯白最坏底色上仍托住 4.5:1 正文的首个安全档。
        边不取 --xh-material-frosted-border：那是深色 14% 的透明边，压在反白深底上看不见，
-       §8.1 要求的 1px 可见边界由 on 色 20% 拼色承担；§8.1 禁玻璃高光，顶光缺省不画 */
+       浮层要的 1px 可见边界由 on 色 20% 拼色承担；浮层不用玻璃高光，顶光缺省不画 */
     --xh-_tooltip-solid: var(--xh-_tone, var(--xh-fg-default));
     --xh-_tooltip-on: var(--xh-_tone-on, var(--xh-bg-surface));
     --xh-_tooltip-border: color-mix(in oklab, var(--xh-_tooltip-on) 20%, transparent);
@@ -106,7 +106,7 @@
     text-wrap: pretty;
     --xh-_tooltip-elevation-shadow: var(--xh-tooltip-shadow, var(--xh-material-frosted-compact-shadow));
 
-    /* 顶光槽缺省透明（§8.1 不用顶部高光），使用者要加自行灌色 */
+    /* 顶光槽缺省透明（不用顶部高光），使用者要加自行灌色 */
     box-shadow:
       inset 0 var(--xh-stroke-thin) 0 var(--xh-tooltip-highlight, transparent),
       var(--xh-_tooltip-elevation-shadow);
@@ -126,11 +126,9 @@
     pointer-events: none;
   }
 
-  /* 入场走 enter 档（§9.5：锚定列表族的 tooltip 入场 --xh-motion-duration-enter），退场仍是 exit */
+  /* 入场走 enter 档（锚定列表族的 tooltip 入场 --xh-motion-duration-enter），退场仍是 exit */
   [data-scope='tooltip'][data-part='content'][data-state='open'] {
     animation: xh-overlay-slide-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter-strong);
-    /* 只在开着的这一档挂：合成层随 data-state 一起收走，收起后不再占着 */
-    will-change: opacity, translate;
   }
 
   /* 退场：收起那一帧 hidden 由退场闸门押后，这里才播得出来。forwards 把末态钉住，

package/css/tour.css

@@ -191,7 +191,7 @@
     padding-inline: var(--xh-tour-px, var(--xh-surface-px-md));
     /* 引导步骤的正文长度由作者定，矮视口下不限高气泡会整块伸出视口 */
     max-block-size: min(var(--xh-tour-max-h, var(--xh-overlay-max-h)), var(--xh-_tour-available-h));
-    /* M4 sheet 三件套（§8.4），与 dialog 同源：1px 描边是它的边界，不透明底，影只是加成 */
+    /* M4 sheet 三件套，与 dialog 同源：1px 描边是它的边界，不透明底，影只是加成 */
     border: var(--xh-stroke-thin) solid var(--xh-tour-border, var(--xh-material-elevated-border));
     border-radius: var(--xh-tour-radius, var(--xh-shape-overlay));
     background: var(--xh-tour-bg, var(--xh-material-elevated-bg));
@@ -211,8 +211,6 @@
 
   [data-scope='tour'][data-part='content'][data-state='open'] {
     animation: xh-overlay-pop-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter-strong);
-    /* 只在开着的这一档挂：合成层随 data-state 一起收走，收起后不再占着 */
-    will-change: opacity, scale, translate;
   }
 
   /* 退场：收起那一帧 hidden 由退场闸门押后，这里才播得出来。forwards 把末态钉住，
@@ -235,7 +233,7 @@
     padding-inline-end: calc(var(--xh-tour-close-size, var(--xh-control-h-sm)) + var(--xh-surface-action-inset));
   }
 
-  /* 说明文字走说明档（§6.4）：13px + fg-muted */
+  /* 说明文字走说明档：13px + fg-muted */
   [data-scope='tour'][data-part='description'] {
     margin: 0;
     font-size: var(--xh-text-secondary-size);
@@ -260,7 +258,7 @@
     display: none;
   }
 
-  /* 圆点：8px 正圆取 circle（§6.3 分页点统一款），未走到的一档取中性描边色。
+  /* 圆点：8px 正圆取 circle（分页点统一款），未走到的一档取中性描边色。
      宽度与底色都随状态换，换步那一下能看出进度在推进 */
   [data-scope='tour'][data-part='progress-dot'] {
     inline-size: var(--xh-space-2);
@@ -286,7 +284,7 @@
 
   /*
    * —— 末行三颗按钮 ——
-   * 上一步 / 下一步 / 跳过都是气泡末行的文字按钮（§9.1）：盒型、sm 档几何、四态面、0.97 按压并换底、粗指针命中区与
+   * 上一步 / 下一步 / 跳过都是气泡末行的文字按钮：盒型、sm 档几何、四态面、0.97 按压并换底、粗指针命中区与
    * 强制色由家族配方按连接层投影的 data-xh-action-variant / -size 给出。这里只把公开槽桥接到矩阵之前
    * （使用者槽 → 形态矩阵 → 家族缺省）与几何映射；内衬与圆角槽三颗共用。
    */
@@ -305,7 +303,7 @@
     display: none;
   }
 
-  /* 下一步是整条引导的主线动作，显式 solid（§7.2 第 2 条）：底、字与影三组使用者槽桥到配方 solid 列之前 */
+  /* 下一步是整条引导的主线动作，显式 solid：底、字与影三组使用者槽桥到配方 solid 列之前 */
   [data-scope='tour'][data-part='next-trigger'] {
     --xh-action-bg-rest: var(--xh-tour-next-bg, var(--xh-_action-variant-bg-rest));
     --xh-action-bg-hover: var(--xh-tour-next-bg-hover, var(--xh-_action-variant-bg-hover));
@@ -324,7 +322,7 @@
   }
 
   /*
-   * 关闭钮是气泡角落的单图标钮（§9.1）：正方盒、sm 档几何、ghost 四态面、0.97 按压并换底与粗指针命中区
+   * 关闭钮是气泡角落的单图标钮：正方盒、sm 档几何、ghost 四态面、0.97 按压并换底与粗指针命中区
    * 由家族配方给出——白面上走画布承载阶梯悬停 --xh-bg-subtle（100）→ 按下 --xh-bg-subtle-hover（200），
    * 焦点面透明吃库环。这里只把公开槽桥接到矩阵之前（使用者槽 → 形态矩阵 → 家族缺省）与摆放；
    * 静息前景取 muted 字色，悬停 / 按下 / 聚焦回到 fg-default。
@@ -383,7 +381,7 @@
 
 @layer xihan.components {
   /* 气泡限高之后只让正文让步：标题与上下步按钮滚出视线就点不到了。
-     模态气泡里的原生细条滚动面（§6.6）：细条由 reset 层统一给，滚到头不把页面一起带走；内容高度不动态变化，不写 gutter */
+     模态气泡里的原生细条滚动面：细条由 reset 层统一给，滚到头不把页面一起带走；内容高度不动态变化，不写 gutter */
   [data-scope='tour'][data-part='description'] {
     flex: 1 1 auto;
     min-block-size: 0;

package/css/transfer.css

@@ -22,9 +22,9 @@
      所以只能按位置显式安放，不能靠自动流——自动流会把"往回搬"甩到目标面板的位置上 */
   [data-scope='transfer'][data-part='root'] {
     /* 条目外的字形（空态占位里作者塞的图标）按档取尺，缺省 md；条目内的字形由家族随 data-xh-collection-size
-       下发，搬运钮内的按 Action Control icon 档取，勾选格里的勾按边长比例取（§6.5） */
+       下发，搬运钮内的按 Action Control icon 档取，勾选格里的勾按边长比例取 */
     --xh-icon-size: var(--xh-transfer-icon-size, var(--xh-glyph-size-md));
-    /* 两侧定高小列表的自绘条挂在根上（§6.6）：根是条子的定位盒（面板不定位），轨道底色关掉才不会在列表边缘糊出一条灰带 */
+    /* 两侧定高小列表的自绘条挂在根上：根是条子的定位盒（面板不定位），轨道底色关掉才不会在列表边缘糊出一条灰带 */
     --xh-scrollbar-track-bg: transparent;
 
     /* 尺寸档只换这五个私有槽，面板头、搜索框、条目与勾选格都从 root 继承它们，
@@ -140,7 +140,7 @@
     min-inline-size: 0;
     overflow: hidden;
     color: var(--xh-transfer-panel-title-fg, var(--xh-fg-default));
-    /* 面板标头是 Surface 内的标题：14 / 600（§6.4） */
+    /* 面板标头是 Surface 内的标题：14 / 600 */
     font-size: var(--xh-transfer-panel-title-font-size, var(--xh-text-label-size));
     font-weight: var(--xh-transfer-panel-title-font-weight, var(--xh-font-weight-semibold));
     line-height: var(--xh-leading-none);
@@ -285,7 +285,7 @@
     color: var(--xh-fg-disabled);
   }
 
-  /* 条目走 Collection Item 的 page 语境（页内持久集合，§7.3）：悬停 / 高亮 / 按下面（白底承载 hover 100 →
+  /* 条目走 Collection Item 的 page 语境（页内持久集合）：悬停 / 高亮 / 按下面（白底承载 hover 100 →
      pressed 200）与勾选行的选中面（品牌淡底 + 淡底前景，selected+hover 20% / +pressed 28%）都由家族按
      aria-selected / aria-disabled 给出，标记由行首的勾选方框承担；禁用面（字色降级、not-allowed、不换面）
      也归家族。这里只把公开槽映射到桥接槽。
@@ -448,7 +448,7 @@
   }
 
   /* 全选格是原生按钮（三态经 aria-checked 上报，激活由平台负责），禁用同时打原生 disabled 与 data-disabled。
-     它是「方框 + 文案」的整行命中区（§9.2）：接 Action Control text 档、ghost 形态，悬停 / 按下 / 禁用面与过渡由家族给
+     它是「方框 + 文案」的整行命中区：接 Action Control text 档、ghost 形态，悬停 / 按下 / 禁用面与过渡由家族给
      （白底承载 hover 100 → pressed 200），按下只换面不缩放（--xh-action-scale-pressed: none），勾选回执落在方框上；
      盒随内容收宽、高度取 xs 档的 24px 命中地板（方框 16px 居中其间），text 档的内距与最小宽度归零。
      position 是给叠在方框上的那颗字形 ::after 当定位基准 */
@@ -486,7 +486,7 @@
 
   /* 两颗搬运钮是只有字形的离散动作钮：接 Action Control 的 icon 档、outline 形态（中性描边、透明底，
      白底承载 hover 100 → pressed 200，按下 0.97 并同时换底），盒、焦点环、粗指针热区与禁用面由家族给；
-     此前的 raised 悬停抬升退役（§8.3 边界只由描边承担）。这里只把使用者槽映射到桥接槽；
+     此前的 raised 悬停抬升退役（边界只由描边承担）。这里只把使用者槽映射到桥接槽；
      钮是正方盒，按 sm 档取一个控件高 */
   [data-scope='transfer'][data-part='to-target-trigger'],
   [data-scope='transfer'][data-part='to-source-trigger'] {

package/css/tree-select.css

@@ -69,7 +69,7 @@
   [data-scope='tree-select']:is([data-part='root'], [data-part='positioner']) {
     /* 作者塞进触发器指示符槽 / 清除钮的图标跟着尺寸档走，与皮肤画的兜底字形同一把尺。这支只管作者放进
        盒与行里的图标：面板里自绘的状态字形（展开方向、行尾对号与半选杠）是指示符，各部件在自己身上
-       把 --xh-icon-size 改接到 --xh-control-indicator-* 一族的盒尺（§6.5） */
+       把 --xh-icon-size 改接到 --xh-control-indicator-* 一族的盒尺 */
     --xh-icon-size: var(--xh-tree-select-icon-size, var(--xh-glyph-size-md));
 
     /* 尺寸档只换这几个私有槽，盒与树里的行都从这两处继承它们，换档不必给每个部件各写一条选择器；
@@ -327,8 +327,6 @@
 
   [data-scope='tree-select'][data-part='content'][data-state='open'] {
     animation: xh-overlay-slide-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter-strong);
-    /* 只在开着的这一档挂：合成层随 data-state 一起收走，收起后不再占着 */
-    will-change: opacity, translate;
   }
 
   /* 退场：收起那一帧 hidden 由退场闸门押后，这里才播得出来。forwards 把末态钉住，
@@ -552,7 +550,7 @@
   /* 勾选标记落在家族网格的 indicator 列；未选中时占位不塌，切换选中不引起行宽抖动。
      尺寸槽按各自部件取名：行内的勾与展开箭头分别是 item- 与 branch- 段，
      触发器上那枚箭头是 --xh-tree-select-indicator-*，三处各调各的。
-     盒里的对号 / 半选杠是指示符（§6.5）：在自己身上把 --xh-icon-size 改接到盒的尺，兜底字形与作者
+     盒里的对号 / 半选杠是指示符：在自己身上把 --xh-icon-size 改接到盒的尺，兜底字形与作者
      塞进盒里的 XhIcon 读同一把尺、与盒同边长；不读家族按档下发到行的 --xh-icon-size——那支只管
      作者放进行里的图标，按图标档取的 20px 会比 16 / 14 的盒还大 */
   [data-scope='tree-select'][data-part='item-indicator'] {
@@ -582,7 +580,7 @@
 
   /* 展开箭头与方向指示符：两者都可能被作者用作「点这里展开」的把手，
      所以尺寸与叶子的勾选标记一致，两种行的文字起点才对得齐。
-     盒里的 chevron 是指示符（§6.5）：与盒同边长，--xh-icon-size 在自己身上改接到盒的尺 */
+     盒里的 chevron 是指示符：与盒同边长，--xh-icon-size 在自己身上改接到盒的尺 */
   [data-scope='tree-select'][data-part='branch-trigger'],
   [data-scope='tree-select'][data-part='branch-indicator'] {
     --xh-icon-size: var(--xh-tree-select-branch-indicator-size, var(--xh-control-indicator-size));

package/css/tree.css

@@ -15,8 +15,8 @@
 
   [data-scope='tree'][data-part='root'] {
     /* 行外的字形（空态 / 在途占位里作者塞的图标）按档取尺，树没有 size 轴、固定 md；
-       行内的由家族随 data-xh-collection-size 下发（§6.5）。这支只管作者放进行里的图标：
-       树自绘的状态字形（展开方向、叶子对号、勾选把手里的勾）是指示符，各部件在自己身上
+       行内的由家族随 data-xh-collection-size 下发。这支只管作者放进行里的图标：
+       树自绘的状态字形（展开方向、行尾对号与半选杠）是指示符，各部件在自己身上
        把 --xh-icon-size 改接到 --xh-control-indicator-* 一族的盒尺 */
     --xh-icon-size: var(--xh-tree-icon-size, var(--xh-glyph-size-md));
 
@@ -146,10 +146,10 @@
   }
 
   /* 行：叶子与分支共用同一套盒子，两种行在视觉上必须齐平。
-     行走 Collection Item 的 page 语境（页内持久集合，§7.3）：悬停 / 高亮 / 按下面（白底承载 hover 100 →
-     pressed 200）与选中面（品牌淡底 + 淡底前景 + 前导标记，selected+hover 20% / +pressed 28%）都由家族按
-     aria-selected / data-selected 与 aria-disabled / data-disabled 给出；这里只把公开槽映射到桥接槽。
-     布局保持 flex 而不用家族网格：一行里可以并排多个前导部件（箭头、勾选把手、拖拽把手）与作者自己的图标、
+     行走 Collection Item 的 overlay 语境，与树选择同一种选中读法：悬停 / 高亮 / 按下面（白底承载
+     hover 100 → pressed 200）由家族给，选中不换面、不换字色，只在行尾亮对号，选中叠悬停 / 按下沿用同一条阶梯；
+     家族按 aria-selected / data-selected 与 aria-disabled / data-disabled 给出，这里只把公开槽映射到桥接槽。
+     布局保持 flex 而不用家族网格：一行里可以并排多个前导部件（箭头、拖拽把手）与作者自己的图标、
      按钮，单列的 prefix 放不下；间距统一由行的 gap 给，家族按槽下发的外边距（--xh-collection-gap）归零 */
   [data-scope='tree'][data-part='item'],
   [data-scope='tree'][data-part='branch-control'] {
@@ -160,18 +160,18 @@
     --xh-collection-radius: var(--xh-tree-row-radius, var(--xh-shape-control));
     /* 作者的图标尺槽经桥接槽下发到行，家族缺省按 md 档 */
     --xh-collection-glyph-size: var(--xh-tree-icon-size, var(--xh-_collection-glyph-size));
-    /* 箭头 / 对号盒与叶子的占位同一把尺：指示符档（§6.5），与同一行里的勾选把手、拖拽把手同走
+    /* 箭头 / 对号盒与叶子的占位同一把尺：指示符档，与同一行里的拖拽把手同走
        --xh-control-indicator-size（comfortable 16 / compact 14）。不读家族按档下发的 --xh-icon-size——
-       那支只管作者放进行里的图标，按图标档取的 20px 会比 16px 的勾选把手大一圈 */
+       那支只管作者放进行里的图标，按图标档取的 20px 会比 16px 的指示符盒大一圈 */
     --xh-_tree-indicator-size: var(--xh-tree-indicator-size, var(--xh-control-indicator-size));
     --xh-collection-fg-rest: var(--xh-tree-row-fg, var(--xh-fg-default));
     --xh-collection-fg-hover: var(--xh-tree-row-fg, var(--xh-fg-default));
     --xh-collection-fg-keyboard-highlight: var(--xh-tree-row-fg, var(--xh-fg-default));
     --xh-collection-fg-pressed: var(--xh-tree-row-fg, var(--xh-fg-default));
-    --xh-collection-fg-selected: var(--xh-tree-row-fg-selected, var(--xh-fg-on-brand-subtle));
-    --xh-collection-fg-selected-hover: var(--xh-tree-row-fg-selected, var(--xh-fg-on-brand-subtle));
-    --xh-collection-fg-selected-highlight: var(--xh-tree-row-fg-selected, var(--xh-fg-on-brand-subtle));
-    --xh-collection-fg-selected-pressed: var(--xh-tree-row-fg-selected, var(--xh-fg-on-brand-subtle));
+    --xh-collection-fg-selected: var(--xh-tree-row-fg-selected, var(--xh-tree-row-fg, var(--xh-fg-default)));
+    --xh-collection-fg-selected-hover: var(--xh-tree-row-fg-selected, var(--xh-tree-row-fg, var(--xh-fg-default)));
+    --xh-collection-fg-selected-highlight: var(--xh-tree-row-fg-selected, var(--xh-tree-row-fg, var(--xh-fg-default)));
+    --xh-collection-fg-selected-pressed: var(--xh-tree-row-fg-selected, var(--xh-tree-row-fg, var(--xh-fg-default)));
     --xh-collection-font-weight-selected: var(--xh-tree-row-selected-font-weight, var(--xh-font-weight-regular));
     --xh-collection-font-weight-selected-hover: var(--xh-tree-row-selected-font-weight, var(--xh-font-weight-regular));
     --xh-collection-font-weight-selected-highlight: var(--xh-tree-row-selected-font-weight, var(--xh-font-weight-regular));
@@ -179,11 +179,13 @@
     --xh-collection-bg-hover: var(--xh-tree-row-bg-hover, var(--xh-bg-subtle));
     --xh-collection-bg-keyboard-highlight: var(--xh-tree-row-bg-hover, var(--xh-bg-subtle));
     --xh-collection-bg-pressed: var(--xh-tree-row-bg-pressed, var(--xh-bg-subtle-hover));
-    --xh-collection-bg-selected: var(--xh-tree-row-bg-selected, var(--xh-bg-brand-subtle));
+    --xh-collection-bg-selected-hover: var(--xh-tree-row-bg-hover, var(--xh-bg-subtle));
+    --xh-collection-bg-selected-highlight: var(--xh-tree-row-bg-hover, var(--xh-bg-subtle));
+    --xh-collection-bg-selected-pressed: var(--xh-tree-row-bg-pressed, var(--xh-bg-subtle-hover));
     /* data-highlighted 跟的是连接层记的焦点行（指针点选也会落焦）：只换面，焦点环在 :focus-visible 下再接回 */
     --xh-collection-outline-keyboard-highlight: transparent;
     --xh-collection-outline-selected-highlight: transparent;
-    /* 叶子的对号：槽按本部件取名（item-check-fg），标记部件的旧槽留在兜底位 */
+    /* 行尾对号：槽按本部件取名（item-check-fg），标记部件的旧槽留在兜底位 */
     --xh-collection-indicator-fg-rest: var(--xh-tree-item-check-fg, var(--xh-tree-item-indicator-fg, var(--xh-fg-brand)));
     --xh-collection-indicator-fg-checked: var(--xh-tree-item-check-fg, var(--xh-tree-item-indicator-fg, var(--xh-fg-brand)));
     --xh-collection-indicator-fg-selected: var(--xh-tree-item-check-fg, var(--xh-tree-item-indicator-fg, var(--xh-fg-brand)));
@@ -206,12 +208,9 @@
       box-shadow var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
   }
 
-  /* 分支行的首格是展开箭头，叶子行没有这一格。作者摆了 item-indicator 时由它顶着，
-     没摆（如勾选档首位直接是 item-checkbox）就由行盒自己补出来，
-     否则叶子会比同级分支往行首缩一格，层级关系读不出来。占位宽度与箭头 / 对号盒同一把尺 */
-  [data-orientation='vertical'] > [data-scope='tree'][data-part='item']:not(
-      :has(> [data-scope='tree'][data-part='item-indicator'])
-    ) {
+  /* 分支行的首格是展开箭头，叶子行没有这一格，由行盒自己补出来（对号在行尾，不再替叶子顶这一格），
+     否则叶子会比同级分支往行首缩一格，层级关系读不出来。占位宽度与箭头盒同一把尺 */
+  [data-orientation='vertical'] > [data-scope='tree'][data-part='item'] {
     padding-inline-start: calc(
       var(--xh-tree-row-px, var(--xh-control-px-md)) +
         var(--xh-_tree-indicator-size) +
@@ -242,76 +241,6 @@
     --xh-collection-cursor-rest: not-allowed;
   }
 
-  /* 勾选把手：勾选态只画在它身上，不碰行底色——底色那条通道归高亮 */
-  [data-scope='tree'][data-part='item-checkbox'],
-  [data-scope='tree'][data-part='branch-checkbox'] {
-    /* 方框里的勾按边长的比例取尺（与 Checkbox 同一比例），不吃家族按档下发的行内字形尺 */
-    --xh-icon-size: calc(var(--xh-tree-checkbox-size, var(--xh-control-indicator-size)) * 0.75);
-
-    display: inline-grid;
-    place-items: center;
-    flex: none;
-    inline-size: var(--xh-tree-checkbox-size, var(--xh-control-indicator-size));
-    block-size: var(--xh-tree-checkbox-size, var(--xh-control-indicator-size));
-    border: var(--xh-stroke-thin) solid var(--xh-tree-checkbox-border, var(--xh-border-control));
-    border-radius: var(--xh-tree-checkbox-radius, var(--xh-shape-inset));
-    background: var(--xh-tree-checkbox-bg, transparent);
-    color: var(--xh-tree-checkbox-fg, var(--xh-fg-on-brand));
-  }
-
-  [data-scope='tree'][data-part='item-checkbox'][data-selected],
-  [data-scope='tree'][data-part='branch-checkbox'][data-selected] {
-    border-color: var(--xh-tree-checkbox-border-checked, var(--xh-bg-brand));
-    background: var(--xh-tree-checkbox-bg-checked, var(--xh-bg-brand));
-  }
-
-  /* 面是实心的，环色与面同族，画在面里就看不出来；环改取面自己的前景色——
-     那一族色本来就要在这块面上把字读清楚，与面的对比是按可读性定的。
-     勾满与半选铺的是同一块实心底，两态一起收 */
-  [data-scope='tree'][data-part='item-checkbox'][data-selected]:focus-visible,
-  [data-scope='tree'][data-part='item-checkbox'][data-indeterminate]:focus-visible,
-  [data-scope='tree'][data-part='branch-checkbox'][data-selected]:focus-visible,
-  [data-scope='tree'][data-part='branch-checkbox'][data-indeterminate]:focus-visible {
-    --xh-_ring-color: currentColor;
-  }
-
-  /* 半选：级联勾选下「子树勾了一部分」的第三态，此前发了 data-indeterminate 却没人画 */
-  [data-scope='tree'][data-part='item-checkbox'][data-indeterminate]:not([data-selected]),
-  [data-scope='tree'][data-part='branch-checkbox'][data-indeterminate]:not([data-selected]) {
-    border-color: var(--xh-tree-checkbox-border-checked, var(--xh-bg-brand));
-    background: var(--xh-tree-checkbox-bg-checked, var(--xh-bg-brand));
-  }
-
-  /* 没写内容就由皮肤画；作者往把手里塞了自己的图形，这条规则即不命中 */
-  [data-scope='tree'][data-part='item-checkbox'][data-selected]:empty::before,
-  [data-scope='tree'][data-part='branch-checkbox'][data-selected]:empty::before {
-    content: '';
-    display: inline-block;
-    inline-size: var(--xh-icon-size, var(--xh-glyph-size-text));
-    block-size: var(--xh-icon-size, var(--xh-glyph-size-text));
-    vertical-align: var(--xh-glyph-baseline-shift);
-    background-color: currentColor;
-    -webkit-mask: var(--xh-glyph-mark-check) center / contain no-repeat;
-    mask: var(--xh-glyph-mark-check) center / contain no-repeat;
-  }
-
-  [data-scope='tree'][data-part='item-checkbox'][data-indeterminate]:not([data-selected]):empty::before,
-  [data-scope='tree'][data-part='branch-checkbox'][data-indeterminate]:not([data-selected]):empty::before {
-    content: '';
-    display: inline-block;
-    inline-size: var(--xh-icon-size, var(--xh-glyph-size-text));
-    block-size: var(--xh-icon-size, var(--xh-glyph-size-text));
-    vertical-align: var(--xh-glyph-baseline-shift);
-    background-color: currentColor;
-    -webkit-mask: var(--xh-glyph-mark-minus) center / contain no-repeat;
-    mask: var(--xh-glyph-mark-minus) center / contain no-repeat;
-  }
-
-  [data-scope='tree'][data-part='item-checkbox'][data-disabled],
-  [data-scope='tree'][data-part='branch-checkbox'][data-disabled] {
-    border-color: var(--xh-tree-checkbox-border-disabled, var(--xh-border-default));
-  }
-
   [data-scope='tree'][data-part='item-text'],
   [data-scope='tree'][data-part='branch-text'] {
     flex: 1;
@@ -322,14 +251,16 @@
     text-overflow: ellipsis;
   }
 
-  /* 勾选标记是 page 语境的前导对号：显隐与颜色由家族按行的选中态给；
-     未选中时占位不塌，切换选中不引起行宽抖动。盒尺取指示符档；盒里的对号是指示符（§6.5），
+  /* 选中对号落在行尾，与树选择同位：作者在行里摆在哪儿都排到最后，
+     行尾那一格（item-suffix）在它之前；正文吃满剩余宽度，对号因此贴着行的末端。
+     未选中时占位不塌，切换选中不引起行宽抖动。盒尺取指示符档；盒里的对号是指示符，
      在自己身上把 --xh-icon-size 改接到盒的尺，兜底对号与作者塞进盒里的 XhIcon 读同一把尺、与盒同边长 */
   [data-scope='tree'][data-part='item-indicator'] {
     --xh-icon-size: var(--xh-_tree-indicator-size);
 
     display: inline-flex;
     flex: none;
+    order: 1;
     align-items: center;
     justify-content: center;
     inline-size: var(--xh-_tree-indicator-size);
@@ -339,9 +270,20 @@
     display: none;
   }
 
+  /* 家族只按行的 aria-selected 显示对号：分支行的 aria-selected 在 branch 上、半选没有选中语义，
+     这两档按标记自身的 data-selected / data-indeterminate 显形 */
+  [data-scope='tree'][data-part='item-indicator']:is([data-selected], [data-indeterminate]) {
+    visibility: visible;
+  }
+
+  /* 分支行的禁用不在行的 aria-disabled 上（那在 branch 上），标记按自身的 data-disabled 降级 */
+  [data-scope='tree'][data-part='item-indicator'][data-disabled] {
+    color: var(--xh-fg-disabled);
+  }
+
   /* 展开箭头与方向指示符：两者都可能被作者用作"点这里展开"的把手，
      所以尺寸与叶子的勾选标记一致，两种行的文字起点才对得齐。
-     盒里的 chevron 是指示符（§6.5）：与盒同边长，--xh-icon-size 在自己身上改接到盒的尺 */
+     盒里的 chevron 是指示符：与盒同边长，--xh-icon-size 在自己身上改接到盒的尺 */
   [data-scope='tree'][data-part='branch-trigger'],
   [data-scope='tree'][data-part='branch-indicator'] {
     --xh-icon-size: var(--xh-_tree-indicator-size);
@@ -437,6 +379,11 @@
     mask: var(--xh-glyph-mark-check) center / contain no-repeat;
   }
 
+  [data-scope='tree'][data-part='item-indicator'][data-indeterminate]:not([data-selected]):empty::before {
+    -webkit-mask-image: var(--xh-glyph-mark-minus);
+    mask-image: var(--xh-glyph-mark-minus);
+  }
+
   /* —— 节点拖拽搬家 —— */
   /* 整行都是拖动源，光标换成抓手告诉人这一行按得动。
      这条不写 touch-action：整行关掉纵向手势，树容器自己就滚不动了；
@@ -542,7 +489,7 @@
      禁用的节点从来不做落点，这一段因此不会漏画任何一处高亮 */
   [data-scope='tree'][data-part='item'][data-drop='inside']:not([data-disabled]),
   [data-scope='tree'][data-part='branch-control'][data-drop='inside']:not([data-disabled]) {
-    /* 落点不是选中：品牌淡底专属选中 / 当前（§7.1），落点面取悬停之上一档的中性面 */
+    /* 落点不是选中：品牌淡底专属选中 / 当前，落点面取悬停之上一档的中性面 */
     background: var(--xh-tree-drop-inside-bg, var(--xh-bg-subtle-hover));
     box-shadow: inset 0 0 0 var(--xh-tree-drop-line, var(--xh-stroke-thick))
       var(--xh-tree-drop-fg, var(--xh-border-control-focus));
@@ -561,10 +508,10 @@
     border: 0;
   }
 
-  /* 声明过任何 display 就盖掉了 UA 的 [hidden]{display:none}，收起态得自己还回去。
-     写在文件末尾：兜底必须排在该部件所有 display 声明之后 */
-  [data-scope='tree'][data-part='item-checkbox'][hidden],
-  [data-scope='tree'][data-part='branch-checkbox'][hidden] {
-    display: none;
+  @media print {
+    /* 打印默认丢底色，而对号与半选杠是遮罩出来的一块底色：行本就不换面，丢了它选中在纸上就没了踪影 */
+    [data-scope='tree'][data-part='item-indicator'] {
+      print-color-adjust: exact;
+    }
   }
 }

package/css/virtualizer.css

@@ -42,7 +42,7 @@
     overflow-x: auto;
     overflow-y: auto;
     /* 页内结构容器，滚到尽头把剩余的滚动交给外层（overscroll-behavior 保持 auto）：
-       contain 只给浮层、模态 body 与粘底视口（§6.6）。滚动条走 reset 层的原生细条 */
+       contain 只给浮层、模态 body 与粘底视口。滚动条走 reset 层的原生细条 */
   }
 
   /* 单向列表把另一条轴关掉：那一向既没有内容也没有位移，能滚就成了滚不回来的暗格 */