@xihan-ui/styles 1.0.0-alpha.2 → 1.0.0

package/css/tooltip.css

@@ -1,13 +1,27 @@
 @layer xihan.motion {
   /* 动画名的查找只认「文档里有没有这个名字」：引用别处文件里的名字，那份文件不一定在场，
      动画会静默地整个不跑。每份皮肤都能单独引入，所以它用到的关键帧都写在自己身上。 */
-  @keyframes xh-fade-in {
+  @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);
     }
   }
 }
@@ -40,7 +54,7 @@
     position: fixed;
     inset-block-start: 0;
     inset-inline-start: 0;
-    z-index: var(--xh-layer-tooltip);
+    z-index: var(--xh-tooltip-layer, var(--xh-layer-tooltip));
     /* 浮层不承载交互：指针必须能穿过去点到底下的东西 */
     pointer-events: none;
   }
@@ -55,25 +69,36 @@
        箭头是它的后代，语气槽一并继承 */
     --xh-_tooltip-py: var(--xh-space-1);
     --xh-_tooltip-px: var(--xh-space-2);
-    --xh-_tooltip-font-size: var(--xh-font-size-sm);
+    --xh-_tooltip-font-size: var(--xh-control-caption-md);
 
     /* 与 positioner 相反：浮层本体要能接指针，指针停在提示上就不该收起
        （长文案需要停留细看）。positioner 仍是 none，空白区域照样点得穿。 */
+    /* 显式声明 display 是为了盖掉 UA 的 [hidden]{display:none}：收起那一帧 content 仍带 hidden，
+       盒子得先在,退场动画才播得出来。真正的收起由宿主在退场结束后落成内联 display */
+    display: block;
     pointer-events: auto;
     max-inline-size: var(--xh-tooltip-max-w, var(--xh-overlay-max-w));
     padding-block: var(--xh-tooltip-py, var(--xh-_tooltip-py));
     padding-inline: var(--xh-tooltip-px, var(--xh-_tooltip-px));
+    /* 这里刻意用 control 而不是浮层那档 surface：提示气泡通常只有一行字、高度接近控件，
+       8px 圆角在这个尺寸上占比过大，看着会发胖。档位定义里为此单列了一条 */
     border-radius: var(--xh-tooltip-radius, var(--xh-shape-control));
     /* 实心底与其上的文字色随语气走。没写 data-tone 时两个槽都没被声明，退回原来的取值 */
     background: var(--xh-tooltip-bg, var(--xh-_tone, var(--xh-fg-default)));
     color: var(--xh-tooltip-fg, var(--xh-_tone-on, var(--xh-bg-surface)));
     font-size: var(--xh-tooltip-font-size, var(--xh-_tooltip-font-size));
     line-height: var(--xh-leading-normal);
-    box-shadow: var(--xh-tooltip-shadow, var(--xh-elevation-2));
+    box-shadow: var(--xh-tooltip-shadow, var(--xh-elevation-floating));
   }
 
   [data-scope='tooltip'][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='tooltip'][data-part='content'][data-state='closed'] {
+    animation: xh-pop-out var(--xh-motion-duration-exit) var(--xh-motion-ease-exit) forwards;
   }
 
   /* —— 尺寸 —— */
@@ -82,46 +107,30 @@
   [data-scope='tooltip'][data-part='content'][data-size='sm'] {
     --xh-_tooltip-py: var(--xh-space-0_5);
     --xh-_tooltip-px: var(--xh-space-1_5);
-    --xh-_tooltip-font-size: var(--xh-font-size-xs);
+    --xh-_tooltip-font-size: var(--xh-control-caption-sm);
   }
 
   [data-scope='tooltip'][data-part='content'][data-size='lg'] {
     --xh-_tooltip-py: var(--xh-space-1_5);
     --xh-_tooltip-px: var(--xh-space-2_5);
-    --xh-_tooltip-font-size: var(--xh-font-size-md);
+    --xh-_tooltip-font-size: var(--xh-control-caption-lg);
   }
 
-  /* 箭头是旋转 45° 的方块，按自报的落定朝向贴在 content 对侧边上；
+  /* 箭头的底色与描边色，几何在 overlay-arrow.css。
      交叉轴落点由定位引擎经内联自定义属性写进来，没给时退回居中 */
   [data-scope='tooltip'][data-part='arrow'] {
-    --xh-_tooltip-arrow-size: var(--xh-tooltip-arrow-size, var(--xh-overlay-arrow-size));
     --xh-_tooltip-arrow-x: 50%;
     --xh-_tooltip-arrow-y: 50%;
+    --xh-_overlay-arrow-size: var(--xh-tooltip-arrow-size, var(--xh-overlay-arrow-size));
+    --xh-_overlay-arrow-x: var(--xh-_tooltip-arrow-x);
+    --xh-_overlay-arrow-y: var(--xh-_tooltip-arrow-y);
 
-    position: absolute;
-    inline-size: var(--xh-_tooltip-arrow-size);
-    block-size: var(--xh-_tooltip-arrow-size);
     background: var(--xh-tooltip-bg, var(--xh-_tone, var(--xh-fg-default)));
-    transform: rotate(45deg);
-  }
-
-  [data-scope='tooltip'][data-part='arrow'][data-placement^='bottom'] {
-    inset-block-start: calc(var(--xh-_tooltip-arrow-size) / -2);
-    inset-inline-start: calc(var(--xh-_tooltip-arrow-x) - var(--xh-_tooltip-arrow-size) / 2);
-  }
-
-  [data-scope='tooltip'][data-part='arrow'][data-placement^='top'] {
-    inset-block-end: calc(var(--xh-_tooltip-arrow-size) / -2);
-    inset-inline-start: calc(var(--xh-_tooltip-arrow-x) - var(--xh-_tooltip-arrow-size) / 2);
-  }
-
-  [data-scope='tooltip'][data-part='arrow'][data-placement^='left'] {
-    inset-block-start: calc(var(--xh-_tooltip-arrow-y) - var(--xh-_tooltip-arrow-size) / 2);
-    inset-inline-end: calc(var(--xh-_tooltip-arrow-size) / -2);
   }
 
-  [data-scope='tooltip'][data-part='arrow'][data-placement^='right'] {
-    inset-block-start: calc(var(--xh-_tooltip-arrow-y) - var(--xh-_tooltip-arrow-size) / 2);
-    inset-inline-start: calc(var(--xh-_tooltip-arrow-size) / -2);
+  /* 声明过任何 display 就盖掉了 UA 的 [hidden]{display:none}，收起态得自己还回去。
+     写在文件末尾：兜底必须排在该部件所有 display 声明之后 */
+  [data-scope='tooltip'][data-part='trigger'][hidden] {
+    display: none;
   }
 }

package/css/tour.css

@@ -21,16 +21,27 @@
     }
   }
 
-  /* 气泡贴着目标探出来：纯淡入分不清它是从哪个元素长出来的 */
-  @keyframes xh-tour-content-in {
+  @keyframes xh-pop-in {
     from {
       opacity: 0;
-      translate: 0 var(--xh-motion-distance-sm);
+      scale: var(--xh-motion-scale-enter);
     }
 
     to {
       opacity: 1;
-      translate: 0 0;
+      scale: 1;
+    }
+  }
+
+  @keyframes xh-pop-out {
+    from {
+      opacity: 1;
+      scale: 1;
+    }
+
+    to {
+      opacity: 0;
+      scale: var(--xh-motion-scale-enter);
     }
   }
 
@@ -46,6 +57,19 @@
       scale: 1;
     }
   }
+
+  /* 退场反向放大淡出，与进场对称 */
+  @keyframes xh-tour-spotlight-out {
+    from {
+      opacity: 1;
+      scale: 1;
+    }
+
+    to {
+      opacity: 0;
+      scale: calc(2 - var(--xh-motion-scale-enter));
+    }
+  }
 }
 
 @layer xihan.components {
@@ -57,14 +81,23 @@
   /* 根节点只是几个浮层的归属容器，不参与排版。
      这里不给 display，UA 的 [hidden]{display:none} 就仍然压得住 */
   [data-scope='tour'][data-part='root'] {
+    /* 作者塞进指示符槽的图标跟着字号走，与皮肤画的兜底字形同一把尺 */
+    --xh-icon-size: var(--xh-tour-icon-size, var(--xh-glyph-size-text));
+
     color: var(--xh-tour-fg, var(--xh-fg-default));
   }
 
+  /* 浮层被搬到 portal 落点，继承不到 root 上的槽：这把尺在被搬走的那一侧再声明一次，
+     关闭钮与条目里作者塞的图标才和皮肤画的兜底字形一样大 */
+  [data-scope='tour'][data-part='content'] {
+    --xh-icon-size: var(--xh-tour-icon-size, var(--xh-glyph-size-text));
+  }
+
   /* 遮罩：整页压暗，把注意力逼到高亮框那一块上 */
   [data-scope='tour'][data-part='backdrop'] {
     position: fixed;
     inset: 0;
-    z-index: var(--xh-tour-backdrop-z, var(--xh-layer-modal));
+    z-index: var(--xh-tour-backdrop-layer, var(--xh-layer-modal));
     background: var(--xh-tour-backdrop-bg, var(--xh-bg-overlay));
   }
 
@@ -77,14 +110,14 @@
   }
 
   [data-scope='tour'][data-part='backdrop'][data-state='closed'] {
-    animation: xh-fade-out var(--xh-motion-duration-exit) var(--xh-motion-ease-exit);
+    animation: xh-fade-out var(--xh-motion-duration-exit) var(--xh-motion-ease-exit) forwards;
   }
 
   /* 挖洞的高亮框。位置与尺寸由连接层量出来写进内联 style（position/inset/尺寸那几条轴归它），
      这里只管长相：一圈描边 + 一片铺满视口的投影当暗幕，中间那块因此是亮的——
      这就是"洞"。不吃指针：它盖在目标上面，吃了的话目标就再也点不动了 */
   [data-scope='tour'][data-part='spotlight'] {
-    z-index: var(--xh-tour-spotlight-z, var(--xh-layer-modal));
+    z-index: var(--xh-tour-spotlight-layer, var(--xh-layer-modal));
     pointer-events: none;
     border-radius: var(--xh-tour-spotlight-radius, var(--xh-shape-surface));
     box-shadow:
@@ -106,18 +139,29 @@
     animation: xh-tour-spotlight-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter);
   }
 
+  /* 退场与气泡并行播，同一段时长；收起那一帧 hidden 由宿主押后到气泡的退场结束 */
+  [data-scope='tour'][data-part='spotlight'][data-state='closed'] {
+    animation: xh-tour-spotlight-out var(--xh-motion-duration-exit) var(--xh-motion-ease-exit) forwards;
+  }
+
   /* 高亮框在场时遮罩让位：暗幕已经由那圈铺满视口的投影负责，
      两层叠加会把页面压得过暗，而且洞里也会跟着变暗——洞就白挖了。
-     居中步的高亮框带 hidden，此时遮罩照常压暗（那一步本来就没有要突出的元素） */
-  [data-scope='tour'][data-part='root']:has([data-scope='tour'][data-part='spotlight']:not([hidden]))
-    [data-scope='tour'][data-part='backdrop'] {
+     居中步的高亮框带 hidden，此时遮罩照常压暗（那一步本来就没有要突出的元素）。
+     两条兄弟选择器各管一个方向，谁写在前面都算数：遮罩与高亮框同为浮层落点里的兄弟，
+     不再共有 root 这个祖先 */
+  [data-scope='tour'][data-part='backdrop']:has(~ [data-scope='tour'][data-part='spotlight']:not([hidden])),
+  [data-scope='tour'][data-part='spotlight']:not([hidden]) ~ [data-scope='tour'][data-part='backdrop'] {
     background: transparent;
   }
 
   /* 空壳不吃指针，交互只发生在 content 上。
      锚定步的坐标由定位引擎写进内联 style，这里不碰那两条轴 */
   [data-scope='tour'][data-part='positioner'] {
-    z-index: var(--xh-tour-positioner-z, var(--xh-layer-popover));
+    /* 落定那一侧的可用高度，由定位引擎经内联自定义属性写进来，气泡继承它限高；
+       居中步与尚未落位时不额外限高 */
+    --xh-_tour-available-h: 100vh;
+
+    z-index: var(--xh-tour-positioner-layer, var(--xh-layer-popover));
     pointer-events: none;
   }
 
@@ -127,7 +171,7 @@
     display: flex;
     align-items: center;
     justify-content: center;
-    padding: var(--xh-space-4);
+    padding: var(--xh-tour-positioner-padding, var(--xh-space-4));
   }
 
   /* 必须排在 data-position='center' 之后：两条选择器的特指度相同（都是三个属性），
@@ -142,21 +186,22 @@
     flex-direction: column;
     gap: var(--xh-tour-gap, var(--xh-space-2));
     inline-size: max-content;
-    max-inline-size: var(--xh-tour-max-w, 22rem);
-    padding-block: var(--xh-tour-py, var(--xh-space-4));
-    padding-inline: var(--xh-tour-px, var(--xh-control-px-lg));
+    max-inline-size: var(--xh-tour-max-w, var(--xh-overlay-max-w-lg));
+    padding-block: var(--xh-tour-py, var(--xh-surface-py-md));
+    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));
     border: var(--xh-stroke-thin) solid var(--xh-tour-border, var(--xh-border-default));
     border-radius: var(--xh-tour-radius, var(--xh-shape-surface));
     background: var(--xh-tour-bg, var(--xh-bg-surface));
     color: var(--xh-tour-fg, var(--xh-fg-default));
-    box-shadow: var(--xh-tour-shadow, var(--xh-elevation-3));
+    box-shadow: var(--xh-tour-shadow, var(--xh-elevation-sheet));
     pointer-events: auto;
   }
 
-  /* display 会盖掉 hidden 属性的 UA 规则，收起态显式让位 */
-  [data-scope='tour'][data-part='content'][hidden] {
-    display: none;
-  }
+  /* 这里刻意没有 [data-part='content'][hidden] { display: none }，与 popover 一致：
+     收起态连接层会给 content 打 hidden，补上这条退场动画就一帧都播不出来。
+     真正的收起由退场闸门落成内联 display，节点始终留在原地。 */
 
   /* 焦点落在气泡本身（Enter/Space 归"下一步"管），但它是纯容器，不画焦点环 */
   [data-scope='tour'][data-part='content']:focus-visible {
@@ -164,7 +209,13 @@
   }
 
   [data-scope='tour'][data-part='content'][data-state='open'] {
-    animation: xh-tour-content-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='tour'][data-part='content'][data-state='closed'] {
+    animation: xh-pop-out var(--xh-motion-duration-exit) var(--xh-motion-ease-exit) forwards;
   }
 
   [data-scope='tour'][data-part='title'] {
@@ -178,7 +229,7 @@
      否则长标题会直接钻到按钮底下。只在真有关闭按钮时让位。 */
   [data-scope='tour'][data-part='content']:has([data-scope='tour'][data-part='close-trigger'])
     [data-scope='tour'][data-part='title'] {
-    padding-inline-end: calc(var(--xh-control-h-sm) + var(--xh-space-2));
+    padding-inline-end: calc(var(--xh-tour-close-size, var(--xh-control-h-sm)) + var(--xh-space-2));
   }
 
   [data-scope='tour'][data-part='description'] {
@@ -190,7 +241,7 @@
 
   /* "第 m 步，共 n 步"：辅助信息，字号压一档，与按钮排在同一行的两端 */
   [data-scope='tour'][data-part='progress-text'] {
-    font-size: var(--xh-tour-progress-font-size, var(--xh-font-size-xs));
+    font-size: var(--xh-tour-progress-font-size, var(--xh-text-caption-size));
     color: var(--xh-tour-progress-fg, var(--xh-fg-subtle));
   }
 
@@ -201,10 +252,10 @@
     align-items: center;
     justify-content: center;
     block-size: var(--xh-control-h-sm);
-    padding-inline: var(--xh-control-px-md);
+    padding-inline: var(--xh-tour-skip-trigger-px, var(--xh-control-px-md));
     border: var(--xh-stroke-thin) solid transparent;
-    border-radius: var(--xh-shape-control);
-    font-size: var(--xh-font-size-sm);
+    border-radius: var(--xh-tour-action-radius, var(--xh-shape-control));
+    font-size: var(--xh-text-secondary-size);
     cursor: pointer;
   }
 
@@ -254,13 +305,16 @@
     display: inline-flex;
     align-items: center;
     justify-content: center;
-    block-size: var(--xh-control-h-sm);
-    inline-size: var(--xh-control-h-sm);
+    block-size: var(--xh-tour-close-size, var(--xh-control-h-sm));
+    inline-size: var(--xh-tour-close-size, var(--xh-control-h-sm));
     border: 0;
-    border-radius: var(--xh-shape-control);
+    border-radius: var(--xh-tour-close-radius, var(--xh-shape-control));
     background: transparent;
     color: var(--xh-fg-muted);
     cursor: pointer;
+    transition:
+      background-color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter),
+      scale var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
   }
 
   [data-scope='tour'][data-part='close-trigger'][hidden] {
@@ -268,10 +322,15 @@
   }
 
   [data-scope='tour'][data-part='close-trigger']:hover {
-    background: var(--xh-bg-subtle);
+    background: var(--xh-tour-close-bg-hover, var(--xh-bg-subtle-hover));
     color: var(--xh-fg-default);
   }
 
+  [data-scope='tour'][data-part='close-trigger']:active {
+    background: var(--xh-tour-close-bg-active, var(--xh-bg-subtle-active));
+    scale: var(--xh-motion-scale-press);
+  }
+
   [data-scope='tour'][data-part='prev-trigger']:focus-visible,
   [data-scope='tour'][data-part='next-trigger']:focus-visible,
   [data-scope='tour'][data-part='skip-trigger']:focus-visible,
@@ -280,50 +339,42 @@
     outline-offset: var(--xh-ring-offset);
   }
 
-  /* 箭头是旋转 45° 的方块，只保留朝向目标那两条边的描边；
-     交叉轴落点由定位引擎经内联自定义属性写进来，没给时退回居中。居中步没有锚点，连接层会给它发 hidden */
+  /* 箭头的底色与描边色，几何在 overlay-arrow.css。
+     交叉轴落点由定位引擎经内联自定义属性写进来，没给时退回居中 */
   [data-scope='tour'][data-part='arrow'] {
-    --xh-_tour-arrow-size: var(--xh-tour-arrow-size, var(--xh-overlay-arrow-size));
     --xh-_tour-arrow-x: 50%;
     --xh-_tour-arrow-y: 50%;
+    --xh-_overlay-arrow-size: var(--xh-tour-arrow-size, var(--xh-overlay-arrow-size));
+    --xh-_overlay-arrow-x: var(--xh-_tour-arrow-x);
+    --xh-_overlay-arrow-y: var(--xh-_tour-arrow-y);
 
-    position: absolute;
-    inline-size: var(--xh-_tour-arrow-size);
-    block-size: var(--xh-_tour-arrow-size);
     background: var(--xh-tour-bg, var(--xh-bg-surface));
     border: var(--xh-stroke-thin) solid var(--xh-tour-border, var(--xh-border-default));
-    rotate: 45deg;
   }
 
+  /* 居中步没有锚点，连接层会给箭头发 hidden */
   [data-scope='tour'][data-part='arrow'][hidden] {
     display: none;
   }
 
-  [data-scope='tour'][data-part='arrow'][data-placement^='bottom'] {
-    inset-block-start: calc(var(--xh-_tour-arrow-size) / -2);
-    inset-inline-start: calc(var(--xh-_tour-arrow-x) - var(--xh-_tour-arrow-size) / 2);
-    border-block-end: 0;
-    border-inline-end: 0;
-  }
-
-  [data-scope='tour'][data-part='arrow'][data-placement^='top'] {
-    inset-block-end: calc(var(--xh-_tour-arrow-size) / -2);
-    inset-inline-start: calc(var(--xh-_tour-arrow-x) - var(--xh-_tour-arrow-size) / 2);
-    border-block-start: 0;
-    border-inline-start: 0;
-  }
-
-  [data-scope='tour'][data-part='arrow'][data-placement^='right'] {
-    inset-inline-start: calc(var(--xh-_tour-arrow-size) / -2);
-    inset-block-start: calc(var(--xh-_tour-arrow-y) - var(--xh-_tour-arrow-size) / 2);
-    border-block-start: 0;
-    border-inline-end: 0;
+  /* 没写内容就由皮肤画兜底字形；作者往部件里塞了自己的图形，这几条即不命中 */
+  [data-scope='tour'][data-part='close-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;
   }
+}
 
-  [data-scope='tour'][data-part='arrow'][data-placement^='left'] {
-    inset-inline-end: calc(var(--xh-_tour-arrow-size) / -2);
-    inset-block-start: calc(var(--xh-_tour-arrow-y) - var(--xh-_tour-arrow-size) / 2);
-    border-block-end: 0;
-    border-inline-start: 0;
+@layer xihan.components {
+  /* 气泡限高之后只让正文让步：标题与上下步按钮滚出视线就点不到了 */
+  [data-scope='tour'][data-part='description'] {
+    flex: 1 1 auto;
+    min-block-size: 0;
+    overflow-y: auto;
   }
 }

package/css/transfer.css

@@ -10,6 +10,9 @@
      中间那栏没有对应的角色节点（anatomy 里两个按钮是 root 的直接子节点），
      所以只能按位置显式安放，不能靠自动流——自动流会把"往左搬"甩到右侧面板的位置上 */
   [data-scope='transfer'][data-part='root'] {
+    /* 作者塞进指示符槽的图标跟着字号走，与皮肤画的兜底字形同一把尺 */
+    --xh-icon-size: var(--xh-transfer-icon-size, var(--xh-glyph-size-text));
+
     display: grid;
     grid-template-rows: 1fr 1fr;
     grid-template-columns: minmax(0, 1fr) auto minmax(0, 1fr);
@@ -84,7 +87,7 @@
   [data-scope='transfer'][data-part='panel-count'] {
     flex: none;
     color: var(--xh-transfer-count-fg, var(--xh-fg-subtle));
-    font-size: var(--xh-transfer-count-font-size, var(--xh-font-size-xs));
+    font-size: var(--xh-transfer-count-font-size, var(--xh-text-caption-size));
     line-height: var(--xh-leading-none);
     font-variant-numeric: tabular-nums;
   }
@@ -120,12 +123,15 @@
     cursor: not-allowed;
   }
 
+  /* 两侧列表定高：高度只由这个槽给，与条目数无关。左右两块因此恒等高，
+     搬走条目、搜索筛掉条目、整侧搬空，面板都停在原地不缩。
+     flex-basis 取 auto 而不是 0，块尺寸才是这一栏真正的主轴基准 */
   [data-scope='transfer'][data-part='list'] {
     display: flex;
-    flex: 1;
+    flex: 1 1 auto;
     flex-direction: column;
-    min-block-size: var(--xh-transfer-list-min-h, 8rem);
-    max-block-size: var(--xh-transfer-list-max-h, 16rem);
+    gap: var(--xh-transfer-list-gap, var(--xh-list-option-gap));
+    block-size: var(--xh-transfer-list-h, var(--xh-viewport-h-md));
     padding-block: var(--xh-transfer-list-py, var(--xh-space-1));
     padding-inline: var(--xh-transfer-list-px, var(--xh-space-1));
     overflow: auto;
@@ -190,13 +196,13 @@
     flex: none;
     align-items: center;
     justify-content: center;
-    inline-size: var(--xh-transfer-checkbox-size, 16px);
-    block-size: var(--xh-transfer-checkbox-size, 16px);
+    inline-size: var(--xh-transfer-checkbox-size, var(--xh-control-indicator-size));
+    block-size: var(--xh-transfer-checkbox-size, var(--xh-control-indicator-size));
     border: var(--xh-stroke-thin) solid var(--xh-transfer-checkbox-border, var(--xh-border-control));
-    border-radius: var(--xh-transfer-checkbox-radius, var(--xh-radius-sm));
+    border-radius: var(--xh-transfer-checkbox-radius, var(--xh-shape-inset));
     background: var(--xh-transfer-checkbox-bg, var(--xh-bg-canvas));
     color: var(--xh-transfer-checkbox-fg, var(--xh-fg-on-brand));
-    font-size: var(--xh-transfer-checkbox-font-size, 12px);
+    font-size: var(--xh-transfer-checkbox-font-size, calc(var(--xh-control-indicator-size) * 0.75));
     line-height: var(--xh-leading-none);
     transition:
       background var(--xh-motion-duration-micro) var(--xh-motion-ease-enter),
@@ -211,24 +217,68 @@
 
   /* 勾中即填色。全选格三态里 all 与 some 都算"有值"，与条目共用同一副填色 */
   [data-scope='transfer'][data-part='item-checkbox'][data-state='checked'],
-  [data-scope='transfer'][data-part='select-all-trigger']:is([data-state='all'], [data-state='some'])::before {
+  [data-scope='transfer'][data-part='select-all-trigger']:is([data-state='checked'], [data-state='indeterminate'])::before {
     border-color: var(--xh-transfer-checkbox-border-checked, var(--xh-bg-brand));
     background: var(--xh-transfer-checkbox-bg-checked, var(--xh-bg-brand));
   }
 
-  /* 勾号由皮肤补，作者不必自己往格子里塞字符 */
-  [data-scope='transfer'][data-part='item-checkbox'][data-state='checked']::before {
-    content: '✓';
+  /* 没写内容就由皮肤画勾；作者往格子里塞了自己的图形，这条规则即不命中。
+     底下两处（全选格的两态）不带这条守卫：触发器里装的是全选那行文字，:empty 恒不命中 */
+  [data-scope='transfer'][data-part='item-checkbox'][data-state='checked']: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;
   }
 
   /* 全选格的三态：all 打勾、some 打横杠、none 留空。
-     some 就是读屏听到的 aria-checked=mixed，两者同源，样式只认 data-state */
-  [data-scope='transfer'][data-part='select-all-trigger'][data-state='all']::before {
-    content: '✓';
-  }
-
-  [data-scope='transfer'][data-part='select-all-trigger'][data-state='some']::before {
-    content: '−';
+     some 就是读屏听到的 aria-checked=mixed，两者同源，样式只认 data-state。
+
+     字形走 ::after 而不是画方框的那颗 ::before：mask 会把所在元素的描边与底色一并裁成
+     字形的轮廓，写在 ::before 上就等于把方框本身裁没了，只剩一枚白勾。条目那一侧是
+     真实节点当方框、它的 ::before 当字形的两层结构，这里没有第二个节点，只能用
+     第二个伪元素补上那一层。
+     方框是行首那颗 ::before、宽度即勾选格尺寸，所以字形按「盒与字形的宽度差之半」
+     内推即落在圆心；纵向靠 inset-block: 0 + margin-block: auto 居中。
+     font-size 与 ::before 同值，--xh-icon-size 的 1em 兜底才和条目那侧量得一样大 */
+  [data-scope='transfer'][data-part='select-all-trigger'][data-state='checked']::after {
+    content: '';
+    position: absolute;
+    inset-block: 0;
+    inset-inline-start: 0;
+    margin-block: auto;
+    margin-inline-start: calc(
+      (var(--xh-transfer-checkbox-size, var(--xh-control-indicator-size)) - var(--xh-icon-size, var(--xh-glyph-size-text))) /
+        2
+    );
+    inline-size: var(--xh-icon-size, var(--xh-glyph-size-text));
+    block-size: var(--xh-icon-size, var(--xh-glyph-size-text));
+    background-color: var(--xh-transfer-checkbox-fg, var(--xh-fg-on-brand));
+    font-size: var(--xh-transfer-checkbox-font-size, calc(var(--xh-control-indicator-size) * 0.75));
+    -webkit-mask: var(--xh-glyph-mark-check) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-check) center / contain no-repeat;
+  }
+
+  [data-scope='transfer'][data-part='select-all-trigger'][data-state='indeterminate']::after {
+    content: '';
+    position: absolute;
+    inset-block: 0;
+    inset-inline-start: 0;
+    margin-block: auto;
+    margin-inline-start: calc(
+      (var(--xh-transfer-checkbox-size, var(--xh-control-indicator-size)) - var(--xh-icon-size, var(--xh-glyph-size-text))) /
+        2
+    );
+    inline-size: var(--xh-icon-size, var(--xh-glyph-size-text));
+    block-size: var(--xh-icon-size, var(--xh-glyph-size-text));
+    background-color: var(--xh-transfer-checkbox-fg, var(--xh-fg-on-brand));
+    font-size: var(--xh-transfer-checkbox-font-size, calc(var(--xh-control-indicator-size) * 0.75));
+    -webkit-mask: var(--xh-glyph-mark-minus) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-minus) center / contain no-repeat;
   }
 
   [data-scope='transfer'][data-part='item-checkbox'][data-disabled] {
@@ -238,7 +288,9 @@
 
   /* 全选格是原生按钮（三态经 aria-checked 上报，激活由平台负责），
      禁用因此写 :disabled，不写 data-disabled */
+  /* position 是给叠在方框上的那颗字形 ::after 当定位基准 */
   [data-scope='transfer'][data-part='select-all-trigger'] {
+    position: relative;
     display: inline-flex;
     flex: none;
     gap: var(--xh-transfer-select-all-gap, var(--xh-control-gap-sm));
@@ -248,15 +300,17 @@
     border-radius: var(--xh-transfer-select-all-radius, var(--xh-shape-control));
     background: none;
     color: var(--xh-transfer-select-all-fg, var(--xh-fg-muted));
-    font-size: var(--xh-transfer-select-all-font-size, var(--xh-font-size-xs));
+    font-size: var(--xh-transfer-select-all-font-size, var(--xh-text-caption-size));
     font-weight: var(--xh-font-weight-medium);
     line-height: var(--xh-leading-none);
     cursor: pointer;
   }
 
+  /* 往内收，与搜索框、条目同一口径：全选格长在面板里，面板收 overflow，
+     环画在外沿会被裁掉 */
   [data-scope='transfer'][data-part='select-all-trigger']:focus-visible {
     outline: var(--xh-ring-width) solid var(--xh-ring-focus);
-    outline-offset: var(--xh-ring-offset);
+    outline-offset: calc(-1 * var(--xh-ring-width));
   }
 
   [data-scope='transfer'][data-part='select-all-trigger']:disabled {
@@ -322,4 +376,27 @@
   [data-scope='transfer'][data-part='to-source-trigger'][hidden] {
     display: none;
   }
+
+  /* 没写内容就由皮肤画兜底字形；作者往部件里塞了自己的图形，这几条即不命中 */
+  [data-scope='transfer'][data-part='to-source-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-chevron-left) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-chevron-left) center / contain no-repeat;
+  }
+
+  [data-scope='transfer'][data-part='to-target-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-chevron-right) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-chevron-right) center / contain no-repeat;
+  }
 }