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

package/css/popover.css

@@ -1,8 +1,45 @@
+@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 {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  [data-scope='popover'] {
+    --xh-popover-skin: 1;
+  }
+
   /* 坐标由定位引擎写进 style（inset-inline-start / inset-block-start），这里只定位模式与层级 */
   [data-scope='popover'][data-part='positioner'] {
+    /* 落定那一侧的可用高度，由定位引擎经内联自定义属性写进来，内容层继承它限高；
+       引擎没算（尚未落位 / 无引擎 / 贴边归零）时不额外限高 */
+    --xh-_popover-available-h: 100vh;
+
     position: fixed;
-    z-index: var(--xh-layer-popover);
+    z-index: var(--xh-popover-layer, var(--xh-layer-popover));
     /* 空壳不吃指针，交互只发生在 content 上 */
     pointer-events: none;
   }
@@ -13,6 +50,9 @@
   }
 
   [data-scope='popover'][data-part='content'] {
+    /* 作者塞进指示符槽的图标跟着字号走，与皮肤画的兜底字形同一把尺 */
+    --xh-icon-size: var(--xh-popover-icon-size, var(--xh-glyph-size-text));
+
     /* 尺寸档只换这两个私有槽。popover 没有 root 部件，size 落在浮层树最外层的 content 上。
        语气不接：面板是内容容器，语气该由里面的内容表达 */
     --xh-_popover-py: var(--xh-space-3);
@@ -25,27 +65,37 @@
     gap: var(--xh-popover-gap, var(--xh-space-2));
     inline-size: max-content;
     max-inline-size: var(--xh-popover-max-w, var(--xh-_popover-max-w));
+    /* 内容由作者给，长度不可预知：不限高就整块伸出视口且滚不到 */
+    max-block-size: min(var(--xh-popover-max-h, var(--xh-overlay-max-h)), var(--xh-_popover-available-h));
+    overflow-y: auto;
     padding-block: var(--xh-popover-py, var(--xh-_popover-py));
     padding-inline: var(--xh-popover-px, var(--xh-_popover-px));
     border: var(--xh-stroke-thin) solid var(--xh-popover-border, var(--xh-border-default));
     border-radius: var(--xh-popover-radius, var(--xh-shape-surface));
     background: var(--xh-popover-bg, var(--xh-bg-surface));
     color: var(--xh-popover-fg, var(--xh-fg-default));
-    box-shadow: var(--xh-popover-shadow, var(--xh-elevation-2));
+    box-shadow: var(--xh-popover-shadow, var(--xh-elevation-floating));
     pointer-events: auto;
   }
 
-  /* display 会盖掉 hidden 属性的 UA 规则，收起态显式让位 */
-  [data-scope='popover'][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='popover'][data-part='content']:focus-visible {
     outline: none;
   }
 
   [data-scope='popover'][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 把末态钉住,
+     免得动画结束到 hidden 落下来之间闪一下原样 */
+  [data-scope='popover'][data-part='content'][data-state='closed'] {
+    animation: xh-pop-out var(--xh-motion-duration-exit) var(--xh-motion-ease-exit) forwards;
   }
 
   /* —— 尺寸 —— */
@@ -80,7 +130,7 @@
      否则长标题会直接钻到按钮底下。只在真有关闭按钮时让位。 */
   [data-scope='popover'][data-part='content']:has([data-scope='popover'][data-part='close-trigger'])
     [data-scope='popover'][data-part='title'] {
-    padding-inline-end: calc(var(--xh-control-h-sm) + var(--xh-space-2));
+    padding-inline-end: calc(var(--xh-popover-close-size, var(--xh-control-h-sm)) + var(--xh-space-2));
   }
 
   [data-scope='popover'][data-part='close-trigger'] {
@@ -90,65 +140,59 @@
     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-popover-close-size, var(--xh-control-h-sm));
+    inline-size: var(--xh-popover-close-size, var(--xh-control-h-sm));
     border: 0;
-    border-radius: var(--xh-shape-control);
+    border-radius: var(--xh-popover-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='popover'][data-part='close-trigger'][hidden] {
+    display: none;
   }
 
   [data-scope='popover'][data-part='close-trigger']:hover {
-    background: var(--xh-bg-subtle);
+    background: var(--xh-popover-close-bg-hover, var(--xh-bg-subtle-hover));
     color: var(--xh-fg-default);
   }
 
+  [data-scope='popover'][data-part='close-trigger']:active {
+    background: var(--xh-popover-close-bg-active, var(--xh-bg-subtle-active));
+    scale: var(--xh-motion-scale-press);
+  }
+
   [data-scope='popover'][data-part='close-trigger']:focus-visible {
     outline: var(--xh-ring-width) solid var(--xh-ring-focus);
     outline-offset: var(--xh-ring-offset);
   }
 
-  /* 箭头是旋转 45° 的方块，只保留朝向锚点那两条边的描边；
+  /* 箭头的底色与描边色，几何在 overlay-arrow.css。
      交叉轴落点由定位引擎经内联自定义属性写进来，没给时退回居中 */
   [data-scope='popover'][data-part='arrow'] {
-    --xh-_popover-arrow-size: var(--xh-popover-arrow-size, var(--xh-overlay-arrow-size));
     --xh-_popover-arrow-x: 50%;
     --xh-_popover-arrow-y: 50%;
+    --xh-_overlay-arrow-size: var(--xh-popover-arrow-size, var(--xh-overlay-arrow-size));
+    --xh-_overlay-arrow-x: var(--xh-_popover-arrow-x);
+    --xh-_overlay-arrow-y: var(--xh-_popover-arrow-y);
 
-    position: absolute;
-    inline-size: var(--xh-_popover-arrow-size);
-    block-size: var(--xh-_popover-arrow-size);
     background: var(--xh-popover-bg, var(--xh-bg-surface));
     border: var(--xh-stroke-thin) solid var(--xh-popover-border, var(--xh-border-default));
-    rotate: 45deg;
-  }
-
-  [data-scope='popover'][data-part='arrow'][data-placement^='bottom'] {
-    inset-block-start: calc(var(--xh-_popover-arrow-size) / -2);
-    inset-inline-start: calc(var(--xh-_popover-arrow-x) - var(--xh-_popover-arrow-size) / 2);
-    border-block-end: 0;
-    border-inline-end: 0;
-  }
-
-  [data-scope='popover'][data-part='arrow'][data-placement^='top'] {
-    inset-block-end: calc(var(--xh-_popover-arrow-size) / -2);
-    inset-inline-start: calc(var(--xh-_popover-arrow-x) - var(--xh-_popover-arrow-size) / 2);
-    border-block-start: 0;
-    border-inline-start: 0;
-  }
-
-  [data-scope='popover'][data-part='arrow'][data-placement^='right'] {
-    inset-inline-start: calc(var(--xh-_popover-arrow-size) / -2);
-    inset-block-start: calc(var(--xh-_popover-arrow-y) - var(--xh-_popover-arrow-size) / 2);
-    border-block-start: 0;
-    border-inline-end: 0;
   }
 
-  [data-scope='popover'][data-part='arrow'][data-placement^='left'] {
-    inset-inline-end: calc(var(--xh-_popover-arrow-size) / -2);
-    inset-block-start: calc(var(--xh-_popover-arrow-y) - var(--xh-_popover-arrow-size) / 2);
-    border-block-end: 0;
-    border-inline-start: 0;
+  /* 没写内容就由皮肤画兜底字形；作者往部件里塞了自己的图形，这几条即不命中 */
+  [data-scope='popover'][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;
   }
 }

package/css/popselect.css

@@ -1,73 +1,173 @@
+@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 {
-  [data-scope='popselect'][data-part='root'] {
-    /* 尺寸档只换这四个私有槽，触发器与条目都从 root 继承它们，换档不必给每个部件各写一条选择器。
-       浮层在 positioner 里、也是 root 的后代，一并继承 */
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  [data-scope='popselect'] {
+    --xh-popselect-skin: 1;
+  }
+
+  /* 坐标由定位引擎写进 style（inset-inline-start / inset-block-start），这里只定位模式与层级 */
+  [data-scope='popselect'][data-part='positioner'] {
+    /* 落定那一侧的可用高度，由定位引擎经内联自定义属性写进来，内容层继承它限高；
+       引擎没算（尚未落位 / 无引擎 / 贴边归零）时退回自己那档静态上限 */
+    --xh-_popselect-available-h: 100vh;
+
+    position: fixed;
+    z-index: var(--xh-popselect-layer, var(--xh-layer-popover));
+    /* 空壳不吃指针，交互只发生在 content 上 */
+    pointer-events: none;
+  }
+
+  /* 锚点被滚出可视区：整个浮层随之收起 */
+  [data-scope='popselect'][data-part='positioner'][data-hidden] {
+    visibility: hidden;
+  }
+
+  /* 私有槽同时声明在根与 positioner 上：浮层被搬到 portal 落点，不是根的后代，继承不过去 */
+  [data-scope='popselect']:is([data-part='root'], [data-part='positioner']) {
+    /* 尺寸档只换这四个私有槽，触发器与条目都从这两处继承它们，换档不必给每个部件各写一条选择器 */
     --xh-_popselect-h: var(--xh-control-h-md);
     --xh-_popselect-px: var(--xh-control-px-md);
     --xh-_popselect-gap: var(--xh-control-gap-md);
     --xh-_popselect-font-size: var(--xh-text-body-size);
 
     /* 形态档只换这三个槽：缺省即 outline（描边 + 画布底） */
-    --xh-_popselect-trigger-bg: var(--xh-bg-canvas);
-    --xh-_popselect-trigger-border: var(--xh-border-control);
-    --xh-_popselect-trigger-border-hover: var(--xh-border-control-hover);
+    --xh-_popselect-control-bg: var(--xh-bg-canvas);
+    --xh-_popselect-control-border: var(--xh-border-control);
+    --xh-_popselect-control-border-hover: var(--xh-border-control-hover);
 
     /* 聚焦环恒用固定环色；强调色随语气走，只落在勾选标记与选中文字上，正文文字色不动。
        没写 data-tone 时 --xh-_tone 没被声明，两处都退回原来的取值 */
     --xh-_popselect-ring: var(--xh-ring-focus);
     --xh-_popselect-accent: var(--xh-_tone, var(--xh-bg-brand));
     --xh-_popselect-item-selected-fg: var(--xh-_tone-fg, var(--xh-fg-brand-strong));
+  }
+
+  [data-scope='popselect'][data-part='root'] {
+    /* 作者塞进指示符槽的图标跟着控件的尺寸档走；它自己写了 size 时仍以作者的为准 */
+    --xh-icon-size: var(--xh-popselect-icon-size, var(--xh-glyph-size-md));
 
     display: inline-flex;
+    align-items: center;
+    gap: var(--xh-popselect-root-gap, var(--xh-space-1));
+  }
+
+  /* 图标只跟着盒那一侧换档：浮层里的勾选标记有自己的指示符盒，换成整档图标会撑破它 */
+  [data-scope='popselect'][data-part='root'][data-size='sm'] {
+    --xh-icon-size: var(--xh-popselect-icon-size, var(--xh-glyph-size-sm));
+  }
+
+  [data-scope='popselect'][data-part='root'][data-size='lg'] {
+    --xh-icon-size: var(--xh-popselect-icon-size, var(--xh-glyph-size-lg));
   }
 
   /* —— 尺寸 —— */
   /* 缺省档写在上面的基础规则里 */
-  [data-scope='popselect'][data-part='root'][data-size='sm'] {
+  [data-scope='popselect']:is([data-part='root'], [data-part='positioner'])[data-size='sm'] {
     --xh-_popselect-h: var(--xh-control-h-sm);
     --xh-_popselect-px: var(--xh-control-px-sm);
     --xh-_popselect-gap: var(--xh-control-gap-sm);
-    --xh-_popselect-font-size: var(--xh-font-size-sm);
+    --xh-_popselect-font-size: var(--xh-control-font-sm);
   }
 
-  [data-scope='popselect'][data-part='root'][data-size='lg'] {
+  [data-scope='popselect']:is([data-part='root'], [data-part='positioner'])[data-size='lg'] {
     --xh-_popselect-h: var(--xh-control-h-lg);
     --xh-_popselect-px: var(--xh-control-px-lg);
     --xh-_popselect-gap: var(--xh-control-gap-lg);
-    --xh-_popselect-font-size: var(--xh-font-size-lg);
+    --xh-_popselect-font-size: var(--xh-control-font-lg);
   }
 
   /* —— 形态 —— */
   /* 形态只决定描边与底色怎么用，用哪族颜色由 data-tone 决定 */
-  [data-scope='popselect'][data-part='root'][data-variant='outline'] {
-    --xh-_popselect-trigger-bg: var(--xh-bg-canvas);
-    --xh-_popselect-trigger-border: var(--xh-border-control);
-    --xh-_popselect-trigger-border-hover: var(--xh-border-control-hover);
+  [data-scope='popselect']:is([data-part='root'], [data-part='positioner'])[data-variant='outline'] {
+    --xh-_popselect-control-bg: var(--xh-bg-canvas);
+    --xh-_popselect-control-border: var(--xh-border-control);
+    --xh-_popselect-control-border-hover: var(--xh-border-control-hover);
   }
 
   /* 填充式：底色顶替描边，悬停时才浮出一道淡边 */
-  [data-scope='popselect'][data-part='root'][data-variant='subtle'] {
-    --xh-_popselect-trigger-bg: var(--xh-_tone-subtle, var(--xh-bg-subtle));
-    --xh-_popselect-trigger-border: transparent;
-    --xh-_popselect-trigger-border-hover: var(--xh-_tone-border, var(--xh-border-control-hover));
+  [data-scope='popselect']:is([data-part='root'], [data-part='positioner'])[data-variant='subtle'] {
+    --xh-_popselect-control-bg: var(--xh-_tone-subtle, var(--xh-bg-subtle));
+    --xh-_popselect-control-border: transparent;
+    --xh-_popselect-control-border-hover: var(--xh-_tone-border, var(--xh-border-control-hover));
+  }
+
+  /* 无框：底与常态描边透明，悬停浮出描边，聚焦由焦点环表达 */
+  [data-scope='popselect']:is([data-part='root'], [data-part='positioner'])[data-variant='ghost'] {
+    --xh-_popselect-control-bg: transparent;
+    --xh-_popselect-control-border: transparent;
+    --xh-_popselect-control-border-hover: var(--xh-_tone-border, var(--xh-border-control-hover));
+  }
+
+  /* 盒：描边、底色、圆角、控件高度与行内内衬都长在这一层，触发器与清空按钮在里面并排。
+     聚焦环也画在它上面，焦点落在哪颗按钮上，看到的都是同一个框亮起来 */
+  [data-scope='popselect'][data-part='control'] {
+    display: inline-flex;
+    align-items: center;
+    gap: var(--xh-popselect-control-gap, var(--xh-_popselect-gap));
+    block-size: var(--xh-popselect-control-h, var(--xh-_popselect-h));
+    padding-inline: var(--xh-popselect-control-px, var(--xh-_popselect-px));
+    min-inline-size: var(--xh-popselect-control-min-w, var(--xh-control-min-w));
+    border: var(--xh-stroke-thin) solid var(--xh-popselect-control-border, var(--xh-_popselect-control-border));
+    border-radius: var(--xh-popselect-control-radius, var(--xh-shape-control));
+    background: var(--xh-popselect-control-bg, var(--xh-_popselect-control-bg));
+  }
+
+  [data-scope='popselect'][data-part='control']:hover:not([data-disabled]) {
+    border-color: var(--xh-popselect-control-border-hover, var(--xh-_popselect-control-border-hover));
   }
 
-  [data-scope='popselect'][data-part='root'][data-variant='ghost'] {
-    --xh-_popselect-trigger-bg: transparent;
-    --xh-_popselect-trigger-border: transparent;
-    --xh-_popselect-trigger-border-hover: var(--xh-_tone-border, var(--xh-border-control-hover));
+  /* 焦点落在盒内任一颗按钮上都画同一圈环；禁用时按钮不可聚焦，守卫只是把这条说死。
+     描边色与环共用一族语气色 */
+  [data-scope='popselect'][data-part='control']:focus-within:not([data-disabled]) {
+    border-color: var(--xh-popselect-control-border-focus, var(--xh-_tone, var(--xh-border-control-focus)));
+    outline: var(--xh-ring-width) solid var(--xh-_popselect-ring);
+    outline-offset: var(--xh-ring-offset);
   }
 
+  [data-scope='popselect'][data-part='control'][data-disabled] {
+    background: var(--xh-popselect-control-bg-disabled, var(--xh-bg-subtle));
+    color: var(--xh-fg-disabled);
+    cursor: not-allowed;
+  }
+
+  /* 触发器退化成盒里那颗可聚焦的按钮：描边、底色与内衬归盒，它只占满剩余一行 */
   [data-scope='popselect'][data-part='trigger'] {
     display: inline-flex;
+    flex: 1 1 auto;
     align-items: center;
     justify-content: space-between;
     gap: var(--xh-popselect-trigger-gap, var(--xh-_popselect-gap));
-    block-size: var(--xh-popselect-trigger-h, var(--xh-_popselect-h));
-    padding-inline: var(--xh-popselect-trigger-px, var(--xh-_popselect-px));
-    border: var(--xh-stroke-thin) solid var(--xh-popselect-trigger-border, var(--xh-_popselect-trigger-border));
-    border-radius: var(--xh-popselect-trigger-radius, var(--xh-shape-control));
-    background: var(--xh-popselect-trigger-bg, var(--xh-_popselect-trigger-bg));
+    /* 弹性子项默认最小尺寸是内容尺寸，不归零则长值把盒撑破 */
+    min-inline-size: 0;
+    padding: 0;
+    border: 0;
+    background: transparent;
     color: var(--xh-popselect-trigger-fg, var(--xh-fg-default));
     font-size: var(--xh-popselect-trigger-font-size, var(--xh-_popselect-font-size));
     line-height: var(--xh-leading-none);
@@ -75,13 +175,9 @@
     cursor: pointer;
   }
 
-  [data-scope='popselect'][data-part='trigger']:hover:not(:disabled) {
-    border-color: var(--xh-popselect-trigger-border-hover, var(--xh-_popselect-trigger-border-hover));
-  }
-
+  /* 环画在盒上，按钮自己不再画：两圈套着的环读起来像两个控件 */
   [data-scope='popselect'][data-part='trigger']:focus-visible {
-    outline: var(--xh-ring-width) solid var(--xh-_popselect-ring);
-    outline-offset: var(--xh-ring-offset);
+    outline: none;
   }
 
   /* trigger 是单体控件，用原生 disabled（条目那边一律 aria-disabled） */
@@ -95,39 +191,79 @@
     color: var(--xh-popselect-placeholder-fg, var(--xh-fg-subtle));
   }
 
-  /* 坐标由定位引擎写进 style（inset-inline-start / inset-block-start），这里只定位模式与层级 */
-  [data-scope='popselect'][data-part='positioner'] {
-    position: fixed;
-    z-index: var(--xh-layer-popover);
-    /* 空壳不吃指针，交互只发生在 content 上 */
-    pointer-events: none;
+  /* 清空钮：盒里排在触发器之后的方形小钮，没值即 hidden 收起 */
+  [data-scope='popselect'][data-part='clear-trigger'] {
+    display: inline-grid;
+    flex: none;
+    place-items: center;
+    inline-size: var(--xh-popselect-action-size, var(--xh-control-action-size));
+    block-size: var(--xh-popselect-action-size, var(--xh-control-action-size));
+    padding: 0;
+    border: none;
+    border-radius: var(--xh-popselect-action-radius, var(--xh-shape-control));
+    background: none;
+    color: var(--xh-popselect-clear-fg, var(--xh-fg-subtle));
+    line-height: var(--xh-leading-none);
+    cursor: pointer;
+    transition:
+      background var(--xh-motion-duration-micro) var(--xh-motion-ease-enter),
+      color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter),
+      scale var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
   }
 
-  /* 锚点被滚出可视区：整个浮层随之收起 */
-  [data-scope='popselect'][data-part='positioner'][data-hidden] {
-    visibility: hidden;
+  [data-scope='popselect'][data-part='clear-trigger']:hover {
+    background: var(--xh-popselect-clear-bg-hover, var(--xh-bg-subtle-hover));
+    color: var(--xh-popselect-clear-fg-hover, var(--xh-fg-default));
+  }
+
+  [data-scope='popselect'][data-part='clear-trigger']:active {
+    background: var(--xh-popselect-clear-bg-active, var(--xh-bg-subtle-active));
+    scale: var(--xh-motion-scale-press);
+  }
+
+  [data-scope='popselect'][data-part='clear-trigger']:focus-visible {
+    outline: var(--xh-ring-width) solid var(--xh-_popselect-ring);
+    outline-offset: var(--xh-ring-offset);
+  }
+
+  [data-scope='popselect'][data-part='clear-trigger'][hidden] {
+    display: none;
+  }
+
+  /* 没写内容就由皮肤画叉；作者往部件里塞了自己的图形，这条规则即不命中 */
+  [data-scope='popselect'][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;
   }
 
   [data-scope='popselect'][data-part='content'] {
     display: flex;
     flex-direction: column;
-    min-inline-size: var(--xh-popselect-content-min-w, var(--xh-overlay-min-w));
+    min-inline-size: var(--xh-popselect-content-min-w, var(--xh-overlay-menu-min-w));
     max-inline-size: var(--xh-popselect-content-max-w, var(--xh-overlay-max-w));
-    max-block-size: var(--xh-popselect-content-max-h, var(--xh-overlay-max-h));
-    padding: var(--xh-popselect-content-p, var(--xh-space-1));
+    max-block-size: min(var(--xh-popselect-content-max-h, var(--xh-overlay-menu-max-h)), var(--xh-_popselect-available-h));
+    padding-block: var(--xh-popselect-content-py, var(--xh-space-1));
+    padding-inline: var(--xh-popselect-content-px, var(--xh-space-1));
     border: var(--xh-stroke-thin) solid var(--xh-popselect-content-border, var(--xh-border-default));
     border-radius: var(--xh-popselect-content-radius, var(--xh-shape-surface));
     background: var(--xh-popselect-content-bg, var(--xh-bg-surface));
     color: var(--xh-popselect-content-fg, var(--xh-fg-default));
-    box-shadow: var(--xh-popselect-content-shadow, var(--xh-elevation-2));
+    box-shadow: var(--xh-popselect-content-shadow, var(--xh-elevation-floating));
     overflow-y: auto;
     pointer-events: auto;
   }
 
-  /* display 会盖掉 hidden 属性的 UA 规则，收起态显式让位 */
-  [data-scope='popselect'][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]，那几处没有退场动画。 */
 
   /* 焦点落在容器上只有一种情形：指针打开、无选中值、还没有任何条目当锚点。
      那一刻它认领着 Tab 位，环画在浮层内沿；有锚点时环长在条目上，容器不再画 */
@@ -141,7 +277,13 @@
   }
 
   [data-scope='popselect'][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='popselect'][data-part='content'][data-state='closed'] {
+    animation: xh-pop-out var(--xh-motion-duration-exit) var(--xh-motion-ease-exit) forwards;
   }
 
   [data-scope='popselect'][data-part='item'] {
@@ -213,7 +355,14 @@
 
   /* 没写内容就由皮肤画勾；作者往部件里塞了自己的图形，这条规则即不命中 */
   [data-scope='popselect'][data-part='item-indicator']:empty::before {
-    content: '✓';
+    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='popselect'][data-part='item-indicator'][data-state='checked'] {

package/css/progress.css

@@ -1,8 +1,27 @@
+@layer xihan.motion {
+  /* 动画名的查找只认「文档里有没有这个名字」：引用别处文件里的名字，那份文件不一定在场，
+     动画会静默地整个不跑。每份皮肤都能单独引入，所以它用到的关键帧都写在自己身上。 */
+  @keyframes xh-progress-indeterminate {
+    from {
+      inset-inline-start: -40%;
+    }
+
+    to {
+      inset-inline-start: 100%;
+    }
+  }
+}
+
 @layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  [data-scope='progress'] {
+    --xh-progress-skin: 1;
+  }
+
   /* 私有槽位：组件令牌 → 中档字面量两级回退。厚度写在 root 上而不是 track 上，
      尺寸档才改得动一处就够，track 靠继承拿到值。 */
   [data-scope='progress'][data-part='root'] {
-    --xh-_thickness: var(--xh-progress-thickness, 6px);
+    --xh-_thickness: var(--xh-progress-thickness, var(--xh-track-thickness));
 
     display: inline-block;
     inline-size: 100%;
@@ -90,15 +109,41 @@
     transition: stroke-dashoffset var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
   }
 
-  /* 零进度：圆角端点会在长度为 0 处画出一个圆点，收掉它 */
-  [data-scope='progress'][data-part='range'][data-empty] {
-    visibility: hidden;
+  /* 进度未知：线形条改为一小段来回扫。宽度交给动画，连接层算出的 inline-size 与
+     那条过渡都得让开，否则每帧都在跟动画抢同一个属性 */
+  [data-scope='progress'][data-part='track'][data-state='indeterminate'] {
+    position: relative;
+    overflow: hidden;
   }
 
-  /* 关掉动效的用户不该被进度条的补间晃一下；这里只管本组件 */
+  [data-scope='progress'][data-part='range'][data-state='indeterminate'] {
+    position: absolute;
+    inline-size: 40%;
+    transition: none;
+    animation: xh-progress-indeterminate var(--xh-progress-indeterminate-duration, calc(var(--xh-spin-duration) * 2)) var(--xh-ease-standard) infinite;
+  }
+
+  /* 减弱动效档：不来回扫，改成一条铺满的静态条——进度仍然未知，只是不再动。
+     两条规则是同一件事的两个触发条件：系统偏好与作者打的 data-motion */
   @media (prefers-reduced-motion: reduce) {
-    [data-scope='progress'][data-part='range'] {
-      transition-duration: 0.01ms;
+    [data-scope='progress'][data-part='range'][data-state='indeterminate'] {
+      position: static;
+      inline-size: 100%;
+      opacity: 0.5;
+      animation: none;
     }
   }
+
+  :where([data-motion='reduce']) [data-scope='progress'][data-part='range'][data-state='indeterminate'] {
+    position: static;
+    inline-size: 100%;
+    opacity: 0.5;
+    animation: none;
+  }
+
+  /* 零进度：圆角端点会在长度为 0 处画出一个圆点，收掉它 */
+  [data-scope='progress'][data-part='range'][data-empty] {
+    visibility: hidden;
+  }
+
 }

package/css/qr-code.css

@@ -1,4 +1,9 @@
 @layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  [data-scope='qr-code'] {
+    --xh-qr-code-skin: 1;
+  }
+
   /*
    * 根 <svg>。深浅两色取固定档而不是语义前景/背景：语义色跟着主题走，深色主题下整张码
    * 会翻成浅底深模块的反相图，一部分读码器不认反相码。要换配色改下面这三个覆盖槽。
@@ -12,7 +17,7 @@
    */
   [data-scope='qr-code'][data-part='root'] {
     display: block;
-    border-radius: var(--xh-qr-code-radius, var(--xh-radius-md));
+    border-radius: var(--xh-qr-code-radius, var(--xh-shape-control));
     background: var(--xh-qr-code-bg, var(--xh-color-neutral-0));
 
     /* 模块那条 path 不带自己的填充色，从这里继承下去 */