@xihan-ui/styles 1.0.0-alpha.1 → 1.0.0-alpha.3

package/css/tree-select.css

@@ -1,9 +1,59 @@
+@layer xihan.motion {
+  /* 动画名的查找只认「文档里有没有这个名字」：引用别处文件里的名字，那份文件不一定在场，
+     动画会静默地整个不跑。每份皮肤都能单独引入，所以它用到的关键帧都写在自己身上。 */
+  @keyframes xh-pop-in {
+    from {
+      opacity: 0;
+      scale: var(--xh-motion-scale-enter);
+    }
+
+    to {
+      opacity: 1;
+      scale: 1;
+    }
+  }
+  @keyframes xh-pop-out {
+    from {
+      opacity: 1;
+      scale: 1;
+    }
+
+    to {
+      opacity: 0;
+      scale: var(--xh-motion-scale-enter);
+    }
+  }
+}
+
 @layer xihan.components {
-  /* 解剖里没有把「触发器 + 清空按钮」裹在一起的 control 部件，一行是靠 flex-wrap 分出来的：
-     标签占满整行把后面的挤到下一行，触发器与清空按钮就并排落在同一行上。
-     这样作者少写标签、少写清空按钮，剩下的部件也不会塌 */
-  [data-scope='tree-select'][data-part='root'] {
-    /* 尺寸档只换这几个私有槽，触发框与树里的行都从 root 继承它们，换档不必给每个部件各写一条选择器 */
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  [data-scope='tree-select'] {
+    --xh-tree-select-skin: 1;
+  }
+
+  /* 坐标由定位引擎写进 style（inset-inline-start / inset-block-start），这里只定位模式与层级 */
+  [data-scope='tree-select'][data-part='positioner'] {
+    /* 落定那一侧的可用高度，由定位引擎经内联自定义属性写进来，内容层继承它限高；
+       引擎没算（尚未落位 / 无引擎）时不额外限高 */
+    --xh-_tree-select-available-h: 100vh;
+
+    position: fixed;
+    z-index: var(--xh-tree-select-layer, var(--xh-layer-popover));
+    /* 空壳不吃指针，交互只发生在 content 里 */
+    pointer-events: none;
+  }
+
+  /* 锚点被滚出可视区：整个浮层随之收起 */
+  [data-scope='tree-select'][data-part='positioner'][data-hidden] {
+    visibility: hidden;
+  }
+
+  /* 私有槽同时声明在根与 positioner 上：浮层被搬到 portal 落点，不是根的后代，继承不过去 */
+  [data-scope='tree-select']:is([data-part='root'], [data-part='positioner']) {
+    /* 作者塞进指示符槽的图标跟着尺寸档走，与皮肤画的兜底字形同一把尺 */
+    --xh-icon-size: var(--xh-tree-select-icon-size, var(--xh-glyph-size-md));
+
+    /* 尺寸档只换这几个私有槽，盒与树里的行都从这两处继承它们，换档不必给每个部件各写一条选择器 */
     --xh-_tree-select-h: var(--xh-control-h-md);
     --xh-_tree-select-px: var(--xh-control-px-md);
     --xh-_tree-select-gap: var(--xh-control-gap-md);
@@ -19,9 +69,14 @@
     /* 选中行的文字色随语气走，没写 data-tone 时退回品牌强调色 */
     --xh-_tree-select-selected-fg: var(--xh-_tone-fg, var(--xh-fg-brand-strong));
 
+    /* 聚焦环恒用固定环色；校验失败时换成告警环色 */
+    --xh-_tree-select-ring: var(--xh-ring-focus);
+  }
+
+  /* 标签一行、盒一行的两行堆叠 */
+  [data-scope='tree-select'][data-part='root'] {
     display: inline-flex;
-    flex-wrap: wrap;
-    align-items: center;
+    flex-direction: column;
     gap: var(--xh-tree-select-gap, var(--xh-space-1));
   }
 
@@ -33,48 +88,48 @@
   /* —— 形态 —— */
   /* 形态只决定描边与底色怎么用；用哪族颜色由 data-tone 决定，没写 tone 就沿用原来的中性配色 */
   /* outline 就是缺省那一身：描边加画布底，写出来只为让三档并列可读 */
-  [data-scope='tree-select'][data-part='root'][data-variant='outline'] {
+  [data-scope='tree-select']:is([data-part='root'], [data-part='positioner'])[data-variant='outline'] {
     --xh-_tree-select-border: var(--xh-border-control);
     --xh-_tree-select-border-hover: var(--xh-border-control-hover);
     --xh-_tree-select-bg: var(--xh-bg-canvas);
   }
 
   /* subtle 是填充式：底色接过「这里能点」的表达，描边随之让位 */
-  [data-scope='tree-select'][data-part='root'][data-variant='subtle'] {
+  [data-scope='tree-select']:is([data-part='root'], [data-part='positioner'])[data-variant='subtle'] {
     --xh-_tree-select-border: transparent;
     --xh-_tree-select-border-hover: var(--xh-_tone-border, var(--xh-border-control-hover));
     --xh-_tree-select-bg: var(--xh-_tone-subtle, var(--xh-bg-subtle));
   }
 
-  /* ghost 无框无底，可见反馈只在聚焦时给；边框宽度仍占位，切换形态不引起布局抖动 */
-  [data-scope='tree-select'][data-part='root'][data-variant='ghost'] {
+  /* 无框：底与常态描边透明，悬停浮出描边，聚焦由焦点环表达 */
+  [data-scope='tree-select']:is([data-part='root'], [data-part='positioner'])[data-variant='ghost'] {
     --xh-_tree-select-border: transparent;
-    --xh-_tree-select-border-hover: transparent;
+    --xh-_tree-select-border-hover: var(--xh-_tone-border, var(--xh-border-control-hover));
     --xh-_tree-select-bg: transparent;
   }
 
   /* —— 尺寸 —— */
   /* 缺省档写在上面的基础规则里 */
-  [data-scope='tree-select'][data-part='root'][data-size='sm'] {
+  [data-scope='tree-select']:is([data-part='root'], [data-part='positioner'])[data-size='sm'] {
+    --xh-icon-size: var(--xh-tree-select-icon-size, var(--xh-glyph-size-sm));
     --xh-_tree-select-h: var(--xh-control-h-sm);
     --xh-_tree-select-px: var(--xh-control-px-sm);
     --xh-_tree-select-gap: var(--xh-control-gap-sm);
-    --xh-_tree-select-font-size: var(--xh-font-size-sm);
-    --xh-_tree-select-label-font-size: var(--xh-font-size-sm);
+    --xh-_tree-select-font-size: var(--xh-control-font-sm);
+    --xh-_tree-select-label-font-size: var(--xh-control-font-sm);
   }
 
-  [data-scope='tree-select'][data-part='root'][data-size='lg'] {
+  [data-scope='tree-select']:is([data-part='root'], [data-part='positioner'])[data-size='lg'] {
+    --xh-icon-size: var(--xh-tree-select-icon-size, var(--xh-glyph-size-lg));
     --xh-_tree-select-h: var(--xh-control-h-lg);
     --xh-_tree-select-px: var(--xh-control-px-lg);
     --xh-_tree-select-gap: var(--xh-control-gap-lg);
-    --xh-_tree-select-font-size: var(--xh-font-size-lg);
-    --xh-_tree-select-label-font-size: var(--xh-font-size-lg);
+    --xh-_tree-select-font-size: var(--xh-control-font-lg);
+    --xh-_tree-select-label-font-size: var(--xh-control-font-lg);
   }
 
   [data-scope='tree-select'][data-part='label'] {
-    /* 占满整行，把触发器那一行挤下去 */
-    flex-basis: 100%;
-    color: var(--xh-tree-select-label-fg, var(--xh-fg-muted));
+    color: var(--xh-tree-select-label-fg, var(--xh-fg-default));
     font-size: var(--xh-tree-select-label-font-size, var(--xh-_tree-select-label-font-size));
     font-weight: var(--xh-tree-select-label-font-weight, var(--xh-text-label-weight));
     line-height: var(--xh-leading-none);
@@ -85,63 +140,88 @@
     color: var(--xh-fg-subtle);
   }
 
-  /* 画成一个框的就是 trigger 自己（不像 combobox 那样另有 control）：
-     值回显与展开箭头都长在它里面，清空按钮贴在框外与它并排 */
-  [data-scope='tree-select'][data-part='trigger'] {
+  /* 盒：描边、底色、控件高度与行内内衬都落在这一层，触发按钮与清空按钮在里面并排 */
+  [data-scope='tree-select'][data-part='control'] {
     display: inline-flex;
-    flex: 1;
     align-items: center;
-    justify-content: space-between;
-    gap: var(--xh-tree-select-trigger-gap, var(--xh-_tree-select-gap));
-    min-inline-size: var(--xh-tree-select-trigger-min-w, 12rem);
-    block-size: var(--xh-tree-select-trigger-h, var(--xh-_tree-select-h));
-    padding-inline: var(--xh-tree-select-trigger-px, var(--xh-_tree-select-px));
-    border: var(--xh-stroke-thin) solid var(--xh-tree-select-trigger-border, var(--xh-_tree-select-border));
-    border-radius: var(--xh-tree-select-trigger-radius, var(--xh-shape-control));
-    background: var(--xh-tree-select-trigger-bg, var(--xh-_tree-select-bg));
-    color: var(--xh-tree-select-trigger-fg, var(--xh-fg-default));
-    font-family: inherit;
-    font-size: var(--xh-tree-select-trigger-font-size, var(--xh-_tree-select-font-size));
-    line-height: var(--xh-leading-none);
-    text-align: start;
+    gap: var(--xh-tree-select-control-gap, var(--xh-_tree-select-gap));
+    min-inline-size: var(--xh-tree-select-control-min-w, var(--xh-control-min-w));
+    block-size: var(--xh-tree-select-control-h, var(--xh-_tree-select-h));
+    padding-inline: var(--xh-tree-select-control-px, var(--xh-_tree-select-px));
+    border: var(--xh-stroke-thin) solid var(--xh-tree-select-control-border, var(--xh-_tree-select-border));
+    border-radius: var(--xh-tree-select-control-radius, var(--xh-shape-control));
+    background: var(--xh-tree-select-control-bg, var(--xh-_tree-select-bg));
+    color: var(--xh-tree-select-control-fg, var(--xh-fg-default));
     cursor: pointer;
     transition: border-color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
   }
 
-  [data-scope='tree-select'][data-part='trigger'][hidden] {
+  [data-scope='tree-select'][data-part='control'][hidden] {
     display: none;
   }
 
   /* hover 只在中性态换描边：invalid 正拿边框颜色说事，被 hover 盖掉那条信息就没了 */
-  [data-scope='tree-select'][data-part='trigger']:hover:not(:disabled, [data-invalid]) {
-    border-color: var(--xh-tree-select-trigger-border-hover, var(--xh-_tree-select-border-hover));
+  [data-scope='tree-select'][data-part='control']:hover:not([data-disabled], [data-invalid]) {
+    border-color: var(--xh-tree-select-control-border-hover, var(--xh-_tree-select-border-hover));
   }
 
-  /* trigger 是整个控件唯一的 Tab 停靠点（展开后停靠点才移进树里），落焦必须看得见 */
-  [data-scope='tree-select'][data-part='trigger']:focus-visible {
-    outline: var(--xh-ring-width) solid var(--xh-ring-focus);
+  /* Tab 停靠点是盒里的 trigger（展开后才移进树里），环画在盒上 */
+  [data-scope='tree-select'][data-part='control']:focus-within:not([data-disabled]) {
+    border-color: var(--xh-tree-select-control-border-focus, var(--xh-_tone, var(--xh-border-control-focus)));
+    outline: var(--xh-ring-width) solid var(--xh-_tree-select-ring);
     outline-offset: var(--xh-ring-offset);
   }
 
-  [data-scope='tree-select'][data-part='trigger'][data-invalid] {
-    border-color: var(--xh-tree-select-trigger-border-invalid, var(--xh-color-danger-500));
+  [data-scope='tree-select'][data-part='control'][data-invalid] {
+    border-color: var(--xh-tree-select-control-border-invalid, var(--xh-border-invalid));
+
+    /* 校验失败时环也跟着变红：两圈等宽相邻却一红一蓝，读的人不知道哪个才是当前状态 */
+    --xh-_tree-select-ring: var(--xh-ring-invalid);
   }
 
   /* 只读仍可聚焦、浮层仍展得开、树仍能浏览，所以不置灰，只把底色压下去表示「改不动」 */
-  [data-scope='tree-select'][data-part='trigger'][data-readonly] {
-    background: var(--xh-tree-select-trigger-bg-readonly, var(--xh-bg-subtle));
+  [data-scope='tree-select'][data-part='control'][data-readonly] {
+    background: var(--xh-tree-select-control-bg-readonly, var(--xh-bg-subtle));
+  }
+
+  [data-scope='tree-select'][data-part='control'][data-disabled] {
+    background: var(--xh-tree-select-control-bg-disabled, var(--xh-bg-subtle));
+    color: var(--xh-fg-disabled);
+    cursor: not-allowed;
+  }
+
+  /* 盒内那颗可聚焦的按钮：不画描边不铺底也不自带高度，只占满剩余宽度、排布回显与箭头 */
+  [data-scope='tree-select'][data-part='trigger'] {
+    display: inline-flex;
+    flex: 1 1 auto;
+    align-items: center;
+    justify-content: space-between;
+    gap: var(--xh-tree-select-trigger-gap, var(--xh-_tree-select-gap));
+    min-inline-size: 0;
+    padding: 0;
+    border: 0;
+    background: transparent;
+    color: var(--xh-tree-select-trigger-fg, var(--xh-fg-default));
+    font-family: inherit;
+    font-size: var(--xh-tree-select-trigger-font-size, var(--xh-_tree-select-font-size));
+    line-height: var(--xh-leading-none);
+    text-align: start;
+    cursor: pointer;
+  }
+
+  [data-scope='tree-select'][data-part='trigger'][hidden] {
+    display: none;
   }
 
   /* trigger 是单体控件，用原生 disabled（树里的集合条目一律 aria-disabled，写 :disabled 永不命中） */
   [data-scope='tree-select'][data-part='trigger']:disabled {
-    background: var(--xh-tree-select-trigger-bg-disabled, var(--xh-bg-subtle));
     color: var(--xh-fg-disabled);
     cursor: not-allowed;
   }
 
-  /* 多选时值会连成很长一串，必须能截断；框宽由 trigger 定，这里得允许自己被压缩 */
+  /* 多选时值会连成很长一串，必须能截断；框宽由盒定，这里得允许自己被压缩 */
   [data-scope='tree-select'][data-part='value-text'] {
-    flex: 1;
+    flex: 1 1 auto;
     min-inline-size: 0;
     overflow: hidden;
     /* 行高留出文字的上下伸展空间，本行那层 overflow:hidden 才不会把字削掉；
@@ -160,6 +240,12 @@
     color: var(--xh-fg-disabled);
   }
 
+  /* 有值时清空钮顶上来，箭头让位：两个图标并排堆着，用户分不清点哪个。
+     让位而不是禁用——禁用的图标还占着位置，看着像坏了 */
+  [data-scope='tree-select'][data-part='indicator'][data-clearable] {
+    display: none;
+  }
+
   [data-scope='tree-select'][data-part='indicator'] {
     display: inline-flex;
     flex: none;
@@ -181,7 +267,7 @@
     color: var(--xh-fg-disabled);
   }
 
-  /* 贴在触发框旁边的小方钮，不撑高那一行 */
+  /* 盒内靠右的小方钮，不撑高那一行 */
   [data-scope='tree-select'][data-part='clear-trigger'] {
     display: inline-flex;
     flex: none;
@@ -195,24 +281,25 @@
     background: var(--xh-tree-select-action-bg, transparent);
     color: var(--xh-tree-select-action-fg, var(--xh-fg-muted));
     font-family: inherit;
-    font-size: var(--xh-tree-select-action-font-size, var(--xh-font-size-sm));
+    font-size: var(--xh-tree-select-action-font-size, var(--xh-text-secondary-size));
     line-height: var(--xh-leading-none);
     cursor: pointer;
     user-select: none;
-    transition: background var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+    transition: background var(--xh-motion-duration-micro) var(--xh-motion-ease-enter), scale var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
   }
 
   [data-scope='tree-select'][data-part='clear-trigger'][hidden] {
     display: none;
   }
 
-  [data-scope='tree-select'][data-part='clear-trigger']:hover:not(:disabled) {
+  [data-scope='tree-select'][data-part='clear-trigger']:hover {
     background: var(--xh-tree-select-action-bg-hover, var(--xh-bg-subtle-hover));
     color: var(--xh-tree-select-action-fg-hover, var(--xh-fg-default));
   }
 
-  [data-scope='tree-select'][data-part='clear-trigger']:active:not(:disabled) {
+  [data-scope='tree-select'][data-part='clear-trigger']:active {
     background: var(--xh-tree-select-action-bg-active, var(--xh-bg-subtle-active));
+    scale: var(--xh-motion-scale-press);
   }
 
   /* 清空按钮退出了 Tab 序列（tabindex=-1），正常操作走不到这里；
@@ -222,48 +309,29 @@
     outline-offset: var(--xh-ring-offset);
   }
 
-  /* 无选中、只读、整控件禁用三种情况下都按不动，用的是原生 disabled */
-  [data-scope='tree-select'][data-part='clear-trigger']:disabled {
-    background: var(--xh-tree-select-action-bg, transparent);
-    color: var(--xh-fg-disabled);
-    cursor: not-allowed;
-  }
-
-  /* 坐标由定位引擎写进 style（inset-inline-start / inset-block-start），这里只定位模式与层级 */
-  [data-scope='tree-select'][data-part='positioner'] {
-    position: fixed;
-    z-index: var(--xh-layer-popover);
-    /* 空壳不吃指针，交互只发生在 content 里 */
-    pointer-events: none;
-  }
-
-  /* 锚点被滚出可视区：整个浮层随之收起 */
-  [data-scope='tree-select'][data-part='positioner'][data-hidden] {
-    visibility: hidden;
-  }
-
   [data-scope='tree-select'][data-part='content'] {
     display: flex;
     flex-direction: column;
     min-inline-size: var(--xh-tree-select-content-min-w, var(--xh-overlay-min-w));
     max-inline-size: var(--xh-tree-select-content-max-w, var(--xh-overlay-max-w));
-    max-block-size: var(--xh-tree-select-content-max-h, var(--xh-overlay-max-h));
+    max-block-size: min(var(--xh-tree-select-content-max-h, var(--xh-overlay-max-h)), var(--xh-_tree-select-available-h));
     padding-block: var(--xh-tree-select-content-py, var(--xh-space-1));
     padding-inline: var(--xh-tree-select-content-px, var(--xh-space-1));
     border: var(--xh-stroke-thin) solid var(--xh-tree-select-content-border, var(--xh-border-default));
     border-radius: var(--xh-tree-select-content-radius, var(--xh-shape-surface));
     background: var(--xh-tree-select-content-bg, var(--xh-bg-surface));
     color: var(--xh-tree-select-content-fg, var(--xh-fg-default));
-    box-shadow: var(--xh-tree-select-content-shadow, var(--xh-elevation-2));
+    box-shadow: var(--xh-tree-select-content-shadow, var(--xh-elevation-floating));
     /* 两轴一起给：深层节点靠缩进往行末推，横向溢出是常态，得够得着 */
     overflow: auto;
     pointer-events: auto;
   }
 
-  /* 收起态的唯一开关：display 盖掉了 UA 的 [hidden]{display:none}，漏了这条浮层就收不起来 */
-  [data-scope='tree-select'][data-part='content'][hidden] {
-    display: none;
-  }
+  /* 这里刻意没有 [data-part='content'][hidden] { display: none }，与 dialog 一致：
+     收起态连接层会给 content 打 hidden，而上面那条 display 正是要盖掉 UA 的
+     [hidden]{display:none}——退场动画得先能播。presence 读的是 content 的 animationName，
+     真正的收起由宿主在退场结束后落成内联 display:none（Vue 那边直接不渲染）。
+     其余声明了 display 的角色节点仍补 [hidden]，那几处没有退场动画。 */
 
   /* 容器只是焦点域的兜底落点，落焦不画环：高亮永远长在行上 */
   [data-scope='tree-select'][data-part='content']:focus-visible {
@@ -271,7 +339,13 @@
   }
 
   [data-scope='tree-select'][data-part='content'][data-state='open'] {
-    animation: xh-fade-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter);
+    animation: xh-pop-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter);
+  }
+
+  /* 退场：收起那一帧 hidden 由退场闸门押后，这里才播得出来。forwards 把末态钉住，
+     免得动画结束到真收起之间闪一下原样 */
+  [data-scope='tree-select'][data-part='content'][data-state='closed'] {
+    animation: xh-pop-out var(--xh-motion-duration-exit) var(--xh-motion-ease-exit) forwards;
   }
 
   /* 边框、底色与滚动都归 content，树本身只把行竖着排开 */
@@ -446,4 +520,50 @@
   [data-scope='tree-select'][data-part='branch-content'][hidden] {
     display: none;
   }
+
+  /* 没写内容就由皮肤画兜底字形；作者往部件里塞了自己的图形，这几条即不命中 */
+  [data-scope='tree-select'][data-part='indicator']: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-chevron-down) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-chevron-down) center / contain no-repeat;
+  }
+
+  [data-scope='tree-select'][data-part='item-indicator']: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-select'][data-part='branch-trigger']:empty::before,
+  [data-scope='tree-select'][data-part='branch-indicator']: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-chevron-right) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-chevron-right) center / contain no-repeat;
+  }
+
+  [data-scope='tree-select'][data-part='clear-trigger']: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-close) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-close) center / contain no-repeat;
+  }
 }

package/css/tree.css

@@ -1,5 +1,13 @@
 @layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  [data-scope='tree'] {
+    --xh-tree-skin: 1;
+  }
+
   [data-scope='tree'][data-part='root'] {
+    /* 作者塞进指示符槽的图标跟着字号走，与皮肤画的兜底字形同一把尺 */
+    --xh-icon-size: var(--xh-tree-icon-size, var(--xh-glyph-size-text));
+
     display: flex;
     flex-direction: column;
     gap: var(--xh-tree-gap, var(--xh-space-2));
@@ -25,7 +33,7 @@
   [data-scope='tree'][data-part='tree'] {
     display: flex;
     flex-direction: column;
-    max-block-size: var(--xh-tree-max-h, 20rem);
+    max-block-size: var(--xh-tree-max-h, var(--xh-viewport-h-lg));
     padding-block: var(--xh-tree-py, var(--xh-space-1));
     padding-inline: var(--xh-tree-px, var(--xh-space-1));
     border: var(--xh-stroke-thin) solid var(--xh-tree-border, var(--xh-border-default));
@@ -97,6 +105,63 @@
     background: var(--xh-tree-row-bg-hover, var(--xh-bg-subtle));
   }
 
+  /* 勾选把手：勾选态只画在它身上，不碰行底色——底色那条通道归高亮 */
+  [data-scope='tree'][data-part='item-checkbox'],
+  [data-scope='tree'][data-part='branch-checkbox'] {
+    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, var(--xh-bg-canvas));
+    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-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-subtle));
+  }
+
   /* 选中只换文字色与字重，配合行尾的 ✓ 标记；底色整条通道留给高亮，
      两者因此能同时看见 */
   [data-scope='tree'][data-part='item'][data-selected],
@@ -204,4 +269,28 @@
   [data-scope='tree'][data-part='branch-content'][hidden] {
     display: none;
   }
+
+  /* 没写内容就由皮肤画兜底字形；作者往部件里塞了自己的图形，这几条即不命中 */
+  [data-scope='tree'][data-part='branch-trigger']:empty::before,
+  [data-scope='tree'][data-part='branch-indicator']: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-chevron-right) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-chevron-right) center / contain no-repeat;
+  }
+
+  [data-scope='tree'][data-part='item-indicator']: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;
+  }
 }

package/css/typography.css

@@ -1,4 +1,9 @@
 @layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  [data-scope='typography'] {
+    --xh-typography-skin: 1;
+  }
+
   [data-scope='typography'][data-part='root'] {
     /* 尺寸档只换这几个私有槽，各段从根上继承它们，换档不必给每个部件各写一条选择器 */
     --xh-_typography-body-size: var(--xh-text-body-size);
@@ -12,8 +17,8 @@
     --xh-_typography-h6: var(--xh-font-size-sm);
     /* 读行宽度：整块正文不收窄就会拉成一行行难读的长句 */
     --xh-_typography-measure: 68ch;
-    /* 行内代码跟着所在那行的字号缩，用相对单位而不是档位 */
-    --xh-_typography-code-size: 0.9em;
+    /* 行内代码跟着所在那行的字号缩：以「随文字走」的字形尺寸为基数按比例收一点，不取固定档位 */
+    --xh-_typography-code-size: calc(var(--xh-glyph-size-text) * 0.9);
 
     /* 建块级格式化上下文，段落的外边距不越过根往外塌 */
     display: flow-root;
@@ -118,7 +123,7 @@
   [data-scope='typography'][data-part='text'][data-variant='code'] {
     padding-block: var(--xh-typography-code-py, var(--xh-space-0_5));
     padding-inline: var(--xh-typography-code-px, var(--xh-space-1));
-    border-radius: var(--xh-typography-code-radius, var(--xh-radius-sm));
+    border-radius: var(--xh-typography-code-radius, var(--xh-shape-inset));
     background: var(--xh-typography-code-bg, var(--xh-bg-subtle));
     font-family: var(--xh-font-family-mono);
     font-size: var(--xh-typography-code-font-size, var(--xh-_typography-code-size));
@@ -131,7 +136,7 @@
 
   /* —— 行内链接 —— */
   [data-scope='typography'][data-part='link'] {
-    border-radius: var(--xh-typography-link-radius, var(--xh-radius-sm));
+    border-radius: var(--xh-typography-link-radius, var(--xh-shape-inset));
     color: var(--xh-typography-link-fg, var(--xh-fg-brand));
     text-decoration: underline;
     text-underline-offset: var(--xh-typography-link-underline-offset, var(--xh-space-0_5));

package/css/undefined.css

@@ -2,26 +2,36 @@
  * 元素升级前的形态。
  *
  * 收起态由元素在 wire() 里用内联 display 做，而 data-scope / data-part 也是那一刻才打上，
- * 所以 JS 到达之前浮层子树既没有皮肤也没有收起——内容会以裸文本堆在页面流里，
+ * 所以 JS 到达之前这段子树既没有皮肤也没有收起——内容会以裸文本堆在页面流里，
  * 并被搜索引擎与读屏当作正文。SSR / SSG 直出时这段时间尤其长。
  *
  * 这里按作者写的 data-xh-part 选中，那是升级前唯一存在的标记。
+ * 名单与元素的对应由 check-undefined-guard.mjs 双向守着。
  */
 @layer xihan.components {
   :where(
+    xh-accordion,
     xh-cascader,
+    xh-collapsible,
     xh-color-picker,
     xh-combobox,
     xh-context-menu,
     xh-date-picker,
     xh-dialog,
     xh-drawer,
+    xh-floating-panel,
     xh-hover-card,
+    xh-image-viewer,
+    xh-mention,
     xh-menu,
     xh-menubar,
     xh-navigation-menu,
+    xh-popconfirm,
     xh-popover,
+    xh-popselect,
     xh-select,
+    xh-side-nav,
+    xh-steps,
     xh-time-picker,
     xh-tooltip,
     xh-tour,

package/css/virtualizer.css

@@ -1,4 +1,9 @@
 @layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  [data-scope='virtualizer'] {
+    --xh-virtualizer-skin: 1;
+  }
+
   /* 定位分工：条目在**主轴**上的位移、以及 content 在主轴上的总长，
      由连接层每帧写进内联样式（竖向是 inset-block-start / block-size，横向是
      inset-inline-start / inline-size）。这份皮肤一个都不碰：内联优先级高于样式表，
@@ -13,7 +18,9 @@
 
   [data-scope='virtualizer'][data-part='root'] {
     display: block;
-    /* 作者给 root 定了尺寸后，长列表不该漫出这个框 */
+    /* 作者给 root 定了尺寸后，长列表不该漫出这个框；
+       自建定位上下文，作者往里挂的 scrollbar 贴的是这个框 */
+    position: relative;
     overflow: hidden;
   }