@xihan-ui/styles 1.0.0 → 2.0.0

package/css/select.css

@@ -1,29 +1,13 @@
-@layer xihan.motion {
-  /* 动画名的查找只认「文档里有没有这个名字」：引用别处文件里的名字，那份文件不一定在场，
-     动画会静默地整个不跑。每份皮肤都能单独引入，所以它用到的关键帧都写在自己身上。 */
-  @keyframes xh-pop-in {
-    from {
-      opacity: 0;
-      scale: var(--xh-motion-scale-enter);
-    }
+/*
+ * Copyright (c) 2021-Present XiHanFun and contributors.
+ * Licensed under the MIT License. See LICENSE in the project root for license information.
+ */
 
-    to {
-      opacity: 1;
-      scale: 1;
-    }
-  }
-  @keyframes xh-pop-out {
-    from {
-      opacity: 1;
-      scale: 1;
-    }
-
-    to {
-      opacity: 0;
-      scale: var(--xh-motion-scale-enter);
-    }
-  }
-}
+/* Select 独立皮肤同时传递引入字段视觉盒、字段内动作与浮层集合行；full bundle 递归去重。 */
+@import '../family/field-chrome.css';
+@import '../family/action-control.css';
+@import '../family/collection-item.css';
+@import '../family/motion.css';
 
 @layer xihan.components {
   /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
@@ -36,9 +20,22 @@
     /* 落定那一侧的可用高度，由定位引擎经内联自定义属性写进来，内容层继承它限高；
        引擎没算（尚未落位 / 无引擎）时不额外限高 */
     --xh-_select-available-h: 100vh;
+    /* 落定那一侧的可用宽度，同样由定位引擎经内联自定义属性写进来，行内轴据此夹取；
+       引擎没算（尚未落位 / 无引擎 / 贴边归零）时退到视口宽 */
+    --xh-_select-available-w: 100vw;
+    /* 触发器实测宽度，由定位引擎经内联自定义属性写进来，内容层拿它当最小宽的下界；
+       引擎没算（尚未落位 / 无引擎）时为 0，max 取静态档，等于不抬宽 */
+    --xh-_select-anchor-w: 0px;
+    /* WC 嵌套层仍在父层 DOM 内；先截断父 positioner 的方向，再按本层 placement 开一侧。 */
+    --xh-_overlay-enter-up: 0;
+    --xh-_overlay-enter-down: 0;
+    --xh-_overlay-enter-left: 0;
+    --xh-_overlay-enter-right: 0;
+    /* 列表的自绘条浮在内容之上：轨道不上底色，实色轨道会在列表右缘糊一条竖灰带 */
+    --xh-scrollbar-track-bg: transparent;
 
     position: fixed;
-    z-index: var(--xh-select-layer, var(--xh-layer-popover));
+    z-index: var(--xh-select-layer, var(--xh-_layer, var(--xh-layer-popover)));
     /* 空壳不吃指针，交互只发生在 content 上 */
     pointer-events: none;
   }
@@ -48,32 +45,42 @@
     visibility: hidden;
   }
 
+  /* 进场位移按落定的一侧给。placement 与 translate 都是物理量，不随书写方向翻。 */
+  [data-scope='select'][data-part='positioner'][data-placement^='top'] {
+    --xh-_overlay-enter-down: 1;
+  }
+
+  [data-scope='select'][data-part='positioner'][data-placement^='bottom'] {
+    --xh-_overlay-enter-up: 1;
+  }
+
+  [data-scope='select'][data-part='positioner'][data-placement^='left'] {
+    --xh-_overlay-enter-right: 1;
+  }
+
+  [data-scope='select'][data-part='positioner'][data-placement^='right'] {
+    --xh-_overlay-enter-left: 1;
+  }
+
   /* 私有槽同时声明在根与 positioner 上：浮层被搬到 portal 落点，不是根的后代，继承不过去 */
   [data-scope='select']:is([data-part='root'], [data-part='positioner']) {
-    /* 尺寸档只换这五个私有槽，触发器、标题与条目都从这两处继承它们，
-       换档不必给每个部件各写一条选择器 */
+    /* 尺寸档只换这几个私有槽，触发器与条目都从这两处继承它们，
+       换档不必给每个部件各写一条选择器；形态三档由家族按 control 上的 data-variant 生成，皮肤不再声明 */
     --xh-_select-h: var(--xh-control-h-md);
     --xh-_select-px: var(--xh-control-px-md);
     --xh-_select-item-py: var(--xh-list-option-py-md);
     --xh-_select-item-px: var(--xh-control-px-md);
     --xh-_select-gap: var(--xh-control-gap-md);
     --xh-_select-font-size: var(--xh-control-font-md);
-    --xh-_select-label-font-size: var(--xh-control-font-md);
 
-    /* 形态档只换这三个槽：缺省即 outline（描边 + 画布底） */
-    --xh-_select-control-bg: var(--xh-bg-canvas);
-    --xh-_select-control-border: var(--xh-border-control);
-    --xh-_select-control-border-hover: var(--xh-border-control-hover);
-
-    /* 聚焦环恒用固定环色；强调色随语气走，只落在勾选标记与选中文字上，正文文字色不动。
-       没写 data-tone 时 --xh-_tone 没被声明，两处都退回原来的取值 */
-    --xh-_select-ring: var(--xh-ring-focus);
+    /* 语气只落在勾选标记上，单选与多选正文使用同一颜色。 */
     --xh-_select-accent: var(--xh-_tone, var(--xh-fg-brand));
-    --xh-_select-item-selected-fg: var(--xh-_tone-fg, var(--xh-fg-brand-strong));
   }
 
   [data-scope='select'][data-part='root'] {
-    /* 作者塞进指示符槽的图标跟着控件的尺寸档走；它自己写了 size 时仍以作者的为准 */
+    /* 作者塞进指示符槽的图标跟着控件的尺寸档走；它自己写了 size 时仍以作者的为准。
+       浮层条目里自绘的状态字形（勾选标记所在的标记盒与盒里的勾）不读这支：它们是指示符，走
+       --xh-control-indicator-* 一族——标记盒在自己身上把 --xh-icon-size 改接到盒的尺（§6.5） */
     --xh-icon-size: var(--xh-select-icon-size, var(--xh-glyph-size-md));
 
     display: inline-flex;
@@ -81,6 +88,12 @@
     gap: var(--xh-select-gap, var(--xh-space-1));
     /* 隐藏 select 以此为定位基准：它必须留在布局里，原生校验提示要有处可贴 */
     position: relative;
+
+    /* 不传尺寸时一律这么宽，宽度不随内容走；父容器给不出这么宽时整件跟着收，地板同步让步，不越出父容器。
+       地板不高过缺省宽：使用者把缺省宽钉到底线以下时不必再放开底线 */
+    inline-size: var(--xh-select-control-w, var(--xh-control-w));
+    min-inline-size: min(var(--xh-select-control-w, var(--xh-control-w)), var(--xh-select-control-min-w, var(--xh-control-min-w)), 100%);
+    max-inline-size: 100%;
   }
 
   /* —— 尺寸 —— */
@@ -92,7 +105,6 @@
     --xh-_select-item-px: var(--xh-control-px-sm);
     --xh-_select-gap: var(--xh-control-gap-sm);
     --xh-_select-font-size: var(--xh-control-font-sm);
-    --xh-_select-label-font-size: var(--xh-control-font-sm);
   }
 
   /* 图标只跟着盒那一侧换档：浮层里的勾选标记有自己的指示符盒，换成整档图标会撑破它 */
@@ -111,89 +123,43 @@
     --xh-_select-item-px: var(--xh-control-px-lg);
     --xh-_select-gap: var(--xh-control-gap-lg);
     --xh-_select-font-size: var(--xh-control-font-lg);
-    --xh-_select-label-font-size: var(--xh-control-font-lg);
-  }
-
-  /* —— 形态 —— */
-  /* 输入类不做 solid：实心底压着可编辑的值，读起来像块不可点的色板。
-     形态只决定描边与底色怎么用，用哪族颜色由 data-tone 决定 */
-  [data-scope='select']:is([data-part='root'], [data-part='positioner'])[data-variant='outline'] {
-    --xh-_select-control-bg: var(--xh-bg-canvas);
-    --xh-_select-control-border: var(--xh-border-control);
-    --xh-_select-control-border-hover: var(--xh-border-control-hover);
-  }
-
-  /* 填充式：底色顶替描边，悬停时才浮出一道淡边 */
-  [data-scope='select']:is([data-part='root'], [data-part='positioner'])[data-variant='subtle'] {
-    --xh-_select-control-bg: var(--xh-_tone-subtle, var(--xh-bg-subtle));
-    --xh-_select-control-border: transparent;
-    --xh-_select-control-border-hover: var(--xh-_tone-border, var(--xh-border-control-hover));
-  }
-
-  /* 无框：底与常态描边透明，悬停浮出描边，聚焦由焦点环表达 */
-  [data-scope='select']:is([data-part='root'], [data-part='positioner'])[data-variant='ghost'] {
-    --xh-_select-control-bg: transparent;
-    --xh-_select-control-border: transparent;
-    --xh-_select-control-border-hover: var(--xh-_tone-border, var(--xh-border-control-hover));
   }
 
   [data-scope='select'][data-part='label'] {
     color: var(--xh-select-label-fg, var(--xh-fg-default));
-    font-size: var(--xh-select-label-font-size, var(--xh-_select-label-font-size));
+    font-size: var(--xh-select-label-font-size, var(--xh-text-label-size));
     font-weight: var(--xh-select-label-font-weight, var(--xh-text-label-weight));
     line-height: var(--xh-leading-none);
   }
 
   [data-scope='select'][data-part='label'][data-disabled] {
-    color: var(--xh-fg-subtle);
+    color: var(--xh-select-label-fg-disabled, var(--xh-fg-subtle));
   }
 
-  /* 盒：描边、底色、圆角、控件高度与行内内衬都长在这一层，触发器与清空按钮在里面并排。
-     聚焦环也画在它上面，焦点落在哪颗按钮上，看到的都是同一个框亮起来 */
+  /* 盒：描边、底色、圆角、控件高度、行内内衬、聚焦环、五态与悬停由 Field Chrome 家族画在这一层，
+     触发器与清空按钮在里面并排；焦点落在哪颗按钮上，看到的都是同一个框亮起来（家族 :focus-within）。
+     组件只映射既有公开槽（shadow 缺省 none：字段静息描边式、无影）；盒里是按钮而不是文本光标 */
   [data-scope='select'][data-part='control'] {
-    display: inline-flex;
-    align-items: center;
-    gap: var(--xh-select-control-gap, var(--xh-_select-gap));
-    block-size: var(--xh-select-control-h, var(--xh-_select-h));
-    padding-inline: var(--xh-select-control-px, var(--xh-_select-px));
-    min-inline-size: var(--xh-select-control-min-w, var(--xh-control-min-w));
-    border: var(--xh-stroke-thin) solid var(--xh-select-control-border, var(--xh-_select-control-border));
-    border-radius: var(--xh-select-control-radius, var(--xh-shape-control));
-    background: var(--xh-select-control-bg, var(--xh-_select-control-bg));
-  }
-
-  /* hover 只在中性态换描边：invalid 正拿边框颜色说事，被 hover 盖掉那条信息就没了 */
-  [data-scope='select'][data-part='control']:hover:not([data-disabled], [data-invalid]) {
-    border-color: var(--xh-select-control-border-hover, var(--xh-_select-control-border-hover));
-  }
-
-  [data-scope='select'][data-part='control'][data-invalid] {
-    border-color: var(--xh-select-control-border-invalid, var(--xh-border-invalid));
-
-    /* 校验失败时环也跟着变红：两圈等宽相邻却一红一蓝，读的人不知道哪个才是当前状态 */
-    --xh-_select-ring: var(--xh-ring-invalid);
-  }
-
-  /* 焦点落在盒内任一颗按钮上都画同一圈环；禁用时按钮不可聚焦，守卫只是把这条说死 */
-  [data-scope='select'][data-part='control']:focus-within:not([data-disabled]) {
-    outline: var(--xh-ring-width) solid var(--xh-_select-ring);
-    outline-offset: var(--xh-ring-offset);
-  }
-
-  /* 聚焦态描边色与环共用一族语气色。校验失败时要显式让开，描边保持红色 */
-  [data-scope='select'][data-part='control']:focus-within:not([data-invalid]) {
-    border-color: var(--xh-select-control-border-focus, var(--xh-_tone, var(--xh-border-control-focus)));
-  }
-
-  /* 只读仍可聚焦、浮层仍展得开、条目仍能浏览，所以不置灰，只把底色压下去表示「改不动」 */
-  [data-scope='select'][data-part='control'][data-readonly] {
-    background: var(--xh-select-control-bg-readonly, var(--xh-bg-subtle));
-  }
-
-  [data-scope='select'][data-part='control'][data-disabled] {
-    background: var(--xh-select-control-bg-disabled, var(--xh-bg-subtle));
-    color: var(--xh-fg-disabled);
-    cursor: not-allowed;
+    --xh-field-control-height: var(--xh-select-control-h, var(--xh-_select-h));
+    --xh-field-control-padding-inline: var(--xh-select-control-px, var(--xh-_select-px));
+    --xh-field-control-gap: var(--xh-select-control-gap, var(--xh-_select-gap));
+    --xh-field-control-min-inline-size: var(--xh-select-control-min-w, var(--xh-control-min-w));
+    --xh-field-control-radius: var(--xh-select-control-radius, var(--xh-shape-control));
+    --xh-field-bg-rest: var(--xh-select-control-bg, var(--xh-_field-variant-bg-rest));
+    --xh-field-bg-hover: var(--xh-select-control-bg-hover, var(--xh-_field-variant-bg-hover));
+    --xh-field-bg-read-only: var(--xh-select-control-bg-readonly, var(--xh-_field-variant-bg-read-only));
+    --xh-field-bg-disabled: var(--xh-select-control-bg-disabled, var(--xh-_field-variant-bg-disabled));
+    --xh-field-fg-rest: var(--xh-select-control-fg, var(--xh-fg-default));
+    --xh-field-border-rest: var(--xh-select-control-border, var(--xh-_field-variant-border-rest));
+    --xh-field-border-hover: var(--xh-select-control-border-hover, var(--xh-_field-variant-border-hover));
+    --xh-field-border-focus: var(--xh-select-control-border-focus, var(--xh-_field-variant-border-focus));
+    --xh-field-border-invalid: var(--xh-select-control-border-invalid, var(--xh-_field-variant-border-invalid));
+    --xh-field-ring-focus: var(--xh-ring-focus);
+    --xh-field-ring-invalid: var(--xh-ring-invalid);
+    --xh-field-shadow-rest: var(--xh-select-control-shadow, none);
+    --xh-field-cursor-rest: pointer;
+    /* 家族 chrome 会重写 --xh-icon-size，使用者图标槽必须经桥接槽下发才能在盒内生效 */
+    --xh-field-glyph-size: var(--xh-select-icon-size, var(--xh-_field-size-glyph-size));
   }
 
   /* 触发器退化成盒里那颗可聚焦的按钮：描边、底色与内衬归盒，它只占满剩余一行 */
@@ -215,106 +181,71 @@
     cursor: pointer;
   }
 
-  /* 清空按钮：盒里 trigger 的兄弟节点，排在触发器之后，与展开箭头一样宽；清不了时连接层给 hidden */
+  /* 清空按钮：盒里 trigger 的兄弟节点，排在触发器之后，与展开箭头一样宽；清不了时连接层给 hidden。
+     正方视觉盒、inset 圆角、悬停 100 / 按下 200 与 0.97 按压、粗指针热区与 :focus-visible 关环
+     （盒的 :focus-within 已画了一圈）全由 Action Control 的 field-inset ghost 档给，组件只映射既有覆盖槽 */
   [data-scope='select'][data-part='clear-trigger'] {
-    display: inline-flex;
-    flex: none;
-    align-items: center;
-    justify-content: center;
-    inline-size: var(--xh-select-action-size, var(--xh-control-action-size));
-    block-size: var(--xh-select-action-size, var(--xh-control-action-size));
-    padding: 0;
-    border: 0;
-    border-radius: var(--xh-select-action-radius, var(--xh-shape-control));
-    background: var(--xh-select-action-bg, transparent);
-    color: var(--xh-select-action-fg, var(--xh-fg-muted));
-    font-family: inherit;
-
-    /* 字号行高钉死：继承页面字号会让行框高过按钮，字形被基线顶离正中 */
-    font-size: var(--xh-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), scale var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
-  }
-
+    --xh-action-visual-size: var(--xh-select-action-size, var(--xh-_action-profile-visual-size));
+    --xh-action-min-inline-size: var(--xh-select-action-size, var(--xh-_action-profile-visual-size));
+    --xh-action-radius: var(--xh-select-action-radius, var(--xh-shape-inset));
+    /* 底色阶梯由 ghost 档给（透明 → 100 → 200），使用者槽只作覆盖入口 */
+    --xh-action-bg-rest: var(--xh-select-action-bg, var(--xh-_action-variant-bg-rest));
+    --xh-action-bg-hover: var(--xh-select-action-bg-hover, var(--xh-_action-variant-bg-hover));
+    --xh-action-bg-pressed: var(--xh-select-action-bg-active, var(--xh-_action-variant-bg-pressed));
+    --xh-action-fg-rest: var(--xh-select-action-fg, var(--xh-fg-muted));
+    --xh-action-fg-hover: var(--xh-select-action-fg-hover, var(--xh-fg-default));
+    --xh-action-border-rest: transparent;
+    --xh-action-highlight-rest: transparent;
+    --xh-action-shadow-rest: none;
+    --xh-action-shadow-hover: none;
+    --xh-action-shadow-pressed: none;
+    /* 字号钉死：继承页面字号会让行框高过按钮，字形被基线顶离正中 */
+    --xh-action-font-size: var(--xh-select-action-font-size, var(--xh-text-secondary-size));
+    /* 配方尚未把 profile 字形档灌进 --xh-icon-size，钮内字形先按 field-inset 档逐钮取值 */
+    --xh-icon-size: var(--xh-_action-profile-glyph-size);
+
+    border-width: 0;
+  }
+
+  /* 没值时连接层给的是 hidden 属性；家族那条 display 会把 UA 规则盖掉 */
   [data-scope='select'][data-part='clear-trigger'][hidden] {
     display: none;
   }
 
-  [data-scope='select'][data-part='clear-trigger']:hover {
-    background: var(--xh-select-action-bg-hover, var(--xh-bg-subtle-hover));
-    color: var(--xh-select-action-fg-hover, var(--xh-fg-default));
-  }
-
-  [data-scope='select'][data-part='clear-trigger']:active {
-    background: var(--xh-select-action-bg-active, var(--xh-bg-subtle-active));
-    scale: var(--xh-motion-scale-press);
-  }
-
-  /* 清空按钮退出了 Tab 序列（tabindex=-1），正常操作走不到这里；留着是给程序化聚焦兜底，落焦时得看得见 */
-  [data-scope='select'][data-part='clear-trigger']:focus-visible {
-    outline: var(--xh-ring-width) solid var(--xh-_select-ring);
-    outline-offset: var(--xh-ring-offset);
-  }
-
-  /* 多选标签：淡底小药丸；放触发器里是纯展示，放外面配 item-delete-trigger 可删 */
-  [data-scope='select'][data-part='tag'] {
+  /* 标签行：触发器里收着可见标签与 +N 那一枚的一行，行里每一枚都是 tag（data-scope="tag"），
+     样子归 tag.css，这里只管行怎么排。它是弹性子项，只缩不涨：
+     得允许自己被压缩并把溢出裁掉，否则标签会冲出盒的右缘、把展开箭头挤到盒外；
+     展开箭头靠触发器的 space-between 留在末端，行本身不必撑开 */
+  [data-scope='select'][data-part='tag-list'] {
     display: inline-flex;
+    flex: 0 1 auto;
     align-items: center;
-    gap: var(--xh-select-tag-gap, var(--xh-space-1));
-    padding-block: 0;
-    padding-inline: var(--xh-select-tag-px, var(--xh-space-2));
-    border-radius: var(--xh-select-tag-radius, var(--xh-shape-pill));
-    background: var(--xh-select-tag-bg, var(--xh-bg-subtle));
-    color: var(--xh-select-tag-fg, var(--xh-fg-default));
-    font-size: var(--xh-select-tag-font-size, var(--xh-text-caption-size));
-    line-height: var(--xh-leading-normal);
-    white-space: nowrap;
-  }
-
-  [data-scope='select'][data-part='tag'][data-disabled] {
-    color: var(--xh-fg-disabled);
-  }
-
-  /* 标签内的删除钮：与指示符同尺寸的小钮，贴着标签文字 */
-  [data-scope='select'][data-part='item-delete-trigger'] {
-    display: inline-grid;
-    place-items: center;
-    inline-size: var(--xh-select-item-delete-size, var(--xh-control-indicator-size));
-    block-size: var(--xh-select-item-delete-size, var(--xh-control-indicator-size));
-    padding: 0;
-    border: none;
-    border-radius: var(--xh-select-item-delete-radius, var(--xh-shape-inset));
-    background: none;
-    color: var(--xh-select-item-delete-fg, var(--xh-fg-subtle));
-    font-size: inherit;
-    cursor: pointer;
-    transition: background var(--xh-motion-duration-micro) var(--xh-motion-ease-enter), scale var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+    gap: var(--xh-select-tag-list-gap, var(--xh-space-1));
+    min-inline-size: 0;
+    overflow: hidden;
   }
 
-  [data-scope='select'][data-part='item-delete-trigger'][hidden] {
+  /* 无选中时连接层给 hidden，占位文字回来 */
+  [data-scope='select'][data-part='tag-list'][hidden] {
     display: none;
   }
 
-  [data-scope='select'][data-part='item-delete-trigger']:hover {
-    background: var(--xh-select-item-delete-bg-hover, var(--xh-bg-subtle-hover));
-    color: var(--xh-select-item-delete-fg-hover, var(--xh-fg-default));
-  }
-
-  [data-scope='select'][data-part='item-delete-trigger']:active {
-    background: var(--xh-select-item-delete-bg-active, var(--xh-bg-subtle-active));
-    scale: var(--xh-motion-scale-press);
+  /* 标签行露面时 value-text 让位：两者是触发器里的同一格，占位文字与标签不同屏。
+     value-text 留在 DOM 里，trigger 的可及名仍从它取到完整的选中项文本 */
+  [data-scope='select'][data-part='trigger']:has([data-part='tag-list']:not([hidden])) [data-part='value-text'] {
+    display: none;
   }
 
-  [data-scope='select'][data-part='item-delete-trigger']:focus-visible {
-    outline: var(--xh-ring-width) solid var(--xh-_select-ring);
-    outline-offset: var(--xh-ring-offset);
+  /* 行里的标签：行装不下时各自缩短，截断落在 tag 自己的 label 上；弹性子项默认最小尺寸是内容尺寸，
+     不归零则长标签把行撑破、省略号永远轮不到。+N 那一枚（带 data-count）不缩，始终完整可见。
+     标签里的删除钮是 tag 的 close-trigger，样子全归 tag.css，这里不画 */
+  [data-scope='select'][data-part='tag-list'] > [data-scope='tag'][data-part='root'] {
+    flex: 0 1 auto;
+    min-inline-size: 0;
   }
 
-  [data-scope='select'][data-part='item-delete-trigger'][data-disabled] {
-    color: var(--xh-fg-disabled);
-    cursor: not-allowed;
+  [data-scope='select'][data-part='tag-list'] > [data-scope='tag'][data-part='root'][data-count] {
+    flex: none;
   }
 
   /* 环画在盒上，按钮自己不再画：两圈套着的环读起来像两个控件 */
@@ -325,7 +256,6 @@
   /* trigger 是单体控件，用原生 disabled（条目那边一律 aria-disabled） */
   [data-scope='select'][data-part='trigger']:disabled {
     color: var(--xh-fg-disabled);
-    cursor: not-allowed;
   }
 
   /* 盒宽由 control 定，这里得允许自己被压缩：弹性子项默认最小尺寸是内容尺寸，
@@ -343,8 +273,10 @@
     color: var(--xh-select-placeholder-fg, var(--xh-fg-subtle));
   }
 
-  /* 有值时清空钮顶上来，箭头让位：两个图标并排堆着，用户分不清点哪个 */
-  [data-scope='select'][data-part='indicator'][data-clearable] {
+  /* 有值时清空钮顶上来，箭头让位：两个图标并排堆着，用户分不清点哪个。
+     判据查的是盒里此刻真有一颗没收起的清空钮，不是「有没有值」——
+     作者没摆清空钮时箭头照常留着，不然让了位没人接，指示符整个消失 */
+  [data-scope='select'][data-part='control']:has([data-part='clear-trigger']:not([hidden])) [data-part='indicator'] {
     display: none;
   }
 
@@ -357,7 +289,7 @@
     inline-size: var(--xh-select-action-size, var(--xh-control-action-size));
     block-size: var(--xh-select-action-size, var(--xh-control-action-size));
     color: var(--xh-select-indicator-fg, var(--xh-fg-muted));
-    transition: rotate var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+    transition: rotate var(--xh-motion-duration-micro) var(--xh-motion-ease-enter-strong);
   }
 
   /* 没写内容就由皮肤画箭头；作者往部件里塞了自己的图形，这条规则即不命中 */
@@ -379,23 +311,44 @@
   /* 浮层外壳：描边、底色、阴影与整体尺寸归它。它自己不滚——滚的是里面的 list，
      底部操作区因此留在视口里，不随条目滚走 */
   [data-scope='select'][data-part='content'] {
+    position: relative;
     display: flex;
     flex-direction: column;
-    min-inline-size: var(--xh-select-content-min-w, var(--xh-overlay-menu-min-w));
-    max-inline-size: var(--xh-select-content-max-w, var(--xh-overlay-max-w));
+    /* 下界跟着触发器走，面板不窄于它；可用宽度的夹取写在这一侧：
+       min-inline-size 恒压过 max-inline-size，锚点比可用区还宽时只夹 max 等于没夹 */
+    min-inline-size: min(
+      max(var(--xh-select-content-min-w, var(--xh-overlay-menu-min-w)), var(--xh-_select-anchor-w)),
+      var(--xh-_select-available-w)
+    );
+    /* 静态档与落位后的可用宽度取小：窄视口下面板伸出去，最右侧的内容就点不到了 */
+    max-inline-size: min(var(--xh-select-content-max-w, var(--xh-overlay-max-w)), var(--xh-_select-available-w));
     max-block-size: min(var(--xh-select-content-max-h, var(--xh-overlay-menu-max-h)), var(--xh-_select-available-h));
     padding-block: var(--xh-select-content-py, var(--xh-space-1));
     padding-inline: var(--xh-select-content-px, var(--xh-space-1));
-    border: var(--xh-stroke-thin) solid var(--xh-select-content-border, var(--xh-border-default));
-    border-radius: var(--xh-select-content-radius, var(--xh-shape-surface));
-    background: var(--xh-select-content-bg, var(--xh-bg-surface));
-    color: var(--xh-select-content-fg, var(--xh-fg-default));
-    box-shadow: var(--xh-select-content-shadow, var(--xh-elevation-floating));
+    border: var(--xh-stroke-thin) solid var(--xh-select-content-border, var(--xh-material-frosted-border));
+    border-radius: var(--xh-select-content-radius, var(--xh-shape-overlay));
+    background: var(--xh-select-content-bg, var(--xh-material-frosted-bg));
+    color: var(--xh-select-content-fg, var(--xh-material-frosted-fg));
+    box-shadow: var(--xh-select-content-shadow, var(--xh-material-frosted-shadow));
+    -webkit-backdrop-filter: var(--xh-select-content-backdrop, var(--xh-material-frosted-backdrop));
+    backdrop-filter: var(--xh-select-content-backdrop, var(--xh-material-frosted-backdrop));
     /* 条目的悬停底色是方角，滚到两端时会探出外壳的圆角 */
     overflow: hidden;
     pointer-events: auto;
   }
 
+  /* 顶光单独叠在真实四边 border 内侧；强制色归零后轮廓仍在。 */
+  [data-scope='select'][data-part='content']::before {
+    content: '';
+    position: absolute;
+    inset-block-start: 0;
+    inset-inline: 0;
+    block-size: var(--xh-stroke-thin);
+    border-radius: inherit;
+    background: var(--xh-select-content-highlight, var(--xh-material-frosted-highlight));
+    pointer-events: none;
+  }
+
   /* 列表框本体：只管滚动，留白归外壳。
      min-block-size: 0 是 flex 子项能真正滚动的前提——不给的话它按内容撑高，
      外壳的 max-block-size 就只会把溢出的部分裁掉而不是交给它滚 */
@@ -406,6 +359,8 @@
     gap: var(--xh-select-list-gap, var(--xh-list-option-gap));
     min-block-size: 0;
     overflow-y: auto;
+    /* 浮层滚动面：滚到头不把页面一起带走 */
+    overscroll-behavior: contain;
   }
 
   /* 底部操作区：贴在列表下沿，用一道分隔线与条目断开。
@@ -417,8 +372,8 @@
     gap: var(--xh-select-footer-gap, var(--xh-space-2));
     padding-block: var(--xh-select-footer-py, var(--xh-space-2));
     padding-inline: var(--xh-select-footer-px, var(--xh-space-2));
-    border-block-start: var(--xh-stroke-thin) solid var(--xh-select-footer-border, var(--xh-border-subtle));
-    color: var(--xh-select-footer-fg, var(--xh-fg-muted));
+    border-block-start: var(--xh-stroke-thin) solid var(--xh-select-footer-border, var(--xh-material-frosted-separator));
+    color: var(--xh-select-footer-fg, var(--xh-material-frosted-fg-muted));
     font-size: var(--xh-select-footer-font-size, var(--xh-text-secondary-size));
   }
 
@@ -433,77 +388,140 @@
      真正的收起由宿主在退场结束后落成内联 display:none（Vue 那边直接不渲染）。
      其余声明了 display 的角色节点仍补 [hidden]，那几处没有退场动画。 */
 
-  /* 焦点落在容器上只有一种情形：指针打开、无选中值、还没有任何条目当锚点。
-     那一刻它认领着 Tab 位，环画在浮层内沿；有锚点时环长在条目上，容器不再画 */
-  [data-scope='select'][data-part='list'][tabindex='0']:focus-visible {
-    outline: var(--xh-ring-width) solid var(--xh-ring-focus);
-    outline-offset: calc(-1 * var(--xh-ring-width));
-  }
-
   [data-scope='select'][data-part='list']:not([tabindex='0']):focus-visible {
     outline: none;
   }
 
   [data-scope='select'][data-part='content'][data-state='open'] {
-    animation: xh-pop-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter);
+    animation: xh-overlay-slide-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter-strong);
+    /* 只在开着的这一档挂：合成层随 data-state 一起收走，收起后不再占着 */
+    will-change: opacity, translate;
   }
 
   /* 退场：收起那一帧 hidden 由退场闸门押后，这里才播得出来。forwards 把末态钉住，
      免得动画结束到真收起之间闪一下原样 */
   [data-scope='select'][data-part='content'][data-state='closed'] {
-    animation: xh-pop-out var(--xh-motion-duration-exit) var(--xh-motion-ease-exit) forwards;
+    animation: xh-overlay-slide-out var(--xh-motion-duration-exit) var(--xh-motion-ease-exit) forwards;
+    will-change: opacity, translate;
   }
 
-  [data-scope='select'][data-part='item'] {
+  /* 空态占位：待在 content 里、list 的兄弟；盒与阴影归 content，这里只画一句居中的次要文字 */
+  [data-scope='select'][data-part='empty'] {
+    display: block;
+    flex: none;
+    padding-block: var(--xh-select-empty-py, var(--xh-space-3));
+    padding-inline: var(--xh-select-empty-px, var(--xh-_select-item-px));
+    color: var(--xh-select-empty-fg, var(--xh-material-frosted-fg-muted));
+    font-size: var(--xh-select-empty-font-size, var(--xh-_select-font-size));
+    line-height: var(--xh-leading-none);
+    text-align: center;
+  }
+
+  /* 上面给了 display，UA 的 [hidden]{display:none} 已被盖掉，这里补回来 */
+  [data-scope='select'][data-part='empty'][hidden] {
+    display: none;
+  }
+
+  /* 在途占位：与空态占位同一个位置、同一副观感，两者不同屏 */
+  [data-scope='select'][data-part='loading'] {
+    display: block;
+    flex: none;
+    padding-block: var(--xh-select-loading-py, var(--xh-space-3));
+    padding-inline: var(--xh-select-loading-px, var(--xh-_select-item-px));
+    color: var(--xh-select-loading-fg, var(--xh-material-frosted-fg-muted));
+    font-size: var(--xh-select-loading-font-size, var(--xh-_select-font-size));
+    line-height: var(--xh-leading-none);
+    text-align: center;
+  }
+
+  [data-scope='select'][data-part='loading'][hidden] {
+    display: none;
+  }
+
+  [data-scope='select'][data-part='group'] {
     display: flex;
-    align-items: center;
-    gap: var(--xh-select-item-gap, var(--xh-_select-gap));
-    padding-block: var(--xh-select-item-py, var(--xh-_select-item-py));
-    padding-inline: var(--xh-select-item-px, var(--xh-_select-item-px));
-    border-radius: var(--xh-select-item-radius, var(--xh-shape-control));
-    color: var(--xh-select-item-fg, var(--xh-fg-default));
-    font-size: var(--xh-select-item-font-size, var(--xh-_select-font-size));
-    /* 行高留出文字的上下伸展空间，行内那层 overflow:hidden 才不会把字削掉 */
-    line-height: var(--xh-select-item-leading, var(--xh-leading-normal));
-    white-space: nowrap;
-    cursor: pointer;
-    user-select: none;
-    transition:
-      background var(--xh-motion-duration-micro) var(--xh-motion-ease-enter),
-      color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+    flex-direction: column;
+    gap: var(--xh-select-group-gap, var(--xh-list-option-gap));
   }
 
-  /* 悬停与键盘锚点共用中性灰轻档：条目本身承载焦点，不另画描边 */
-  [data-scope='select'][data-part='item']:not([data-disabled]):is(:hover, [data-highlighted]) {
-    background: var(--xh-select-item-bg-hover, var(--xh-bg-subtle));
+  [data-scope='select'][data-part='group'][hidden] {
+    display: none;
   }
 
-  /* 选中只换文字色与字重，配合行尾的 ✓ 标记；底色整条通道留给高亮，
-     两者因此能同时看见 */
-  [data-scope='select'][data-part='item'][data-state='checked'] {
-    color: var(--xh-select-item-fg-selected, var(--xh-_select-item-selected-fg));
-    font-weight: var(--xh-select-item-font-weight-selected, var(--xh-font-weight-medium));
+  /* 后继分组用一条实体细线分段；既有 spacing 槽改管线后的内距，总节奏不另造一套。 */
+  [data-scope='select'][data-part='group'] + [data-scope='select'][data-part='group'] {
+    padding-block-start: var(--xh-select-group-spacing, var(--xh-space-1_5));
+    border-block-start: var(--xh-stroke-thin) solid
+      var(--xh-select-group-separator-color, var(--xh-material-frosted-separator));
   }
 
-  /* 键盘走到条目上要画环：轻档底色对白底只有 1.1:1，够不上焦点指示器的对比度要求。
-     指针悬停走的是程序化聚焦，鼠标模态下 :focus-visible 不匹配，不会误画 */
-  [data-scope='select'][data-part='item']:focus-visible {
-    outline: var(--xh-ring-width) solid var(--xh-ring-focus);
-    outline-offset: calc(-1 * var(--xh-ring-width));
+  /* 分组标题不是选项、进不了导航，画成小号次要文字，
+     内缩与条目对齐（同一个 padding-inline），标题与条目文字才在一条竖线上 */
+  [data-scope='select'][data-part='group-label'] {
+    display: block;
+    padding-block: var(--xh-select-group-label-py, var(--xh-space-1));
+    padding-inline: var(--xh-select-group-label-px, var(--xh-_select-item-px));
+    color: var(--xh-select-group-label-fg, var(--xh-material-frosted-fg-muted));
+    font-size: var(--xh-select-group-label-font-size, var(--xh-text-caption-size));
+    font-weight: var(--xh-select-group-label-font-weight, var(--xh-font-weight-medium));
+    line-height: var(--xh-leading-none);
+    user-select: none;
   }
 
-  [data-scope='select'][data-part='item']:focus:not(:focus-visible) {
-    outline: none;
+  [data-scope='select'][data-part='group-label'][hidden] {
+    display: none;
   }
 
-  /* 禁用走 aria-disabled 而非原生 disabled，条目仍可聚焦，样式由 data-disabled 表达 */
-  [data-scope='select'][data-part='item'][data-disabled] {
-    color: var(--xh-fg-disabled);
-    cursor: not-allowed;
+  [data-scope='select'][data-part='item'] {
+    /* 公开 Select 槽只映射到家族合同；网格、尺寸与状态选择器不在组件皮肤复制。pressed 面与 selected 各态由家族按 overlay 上下文给出。 */
+    --xh-collection-block-padding: var(--xh-select-item-py, var(--xh-_select-item-py));
+    --xh-collection-inline-padding: var(--xh-select-item-px, var(--xh-_select-item-px));
+    --xh-collection-gap: var(--xh-select-item-gap, var(--xh-_select-gap));
+    --xh-collection-font-size: var(--xh-select-item-font-size, var(--xh-_select-font-size));
+    --xh-collection-radius: var(--xh-select-item-radius, var(--xh-shape-control));
+    --xh-collection-fg-rest: var(--xh-select-item-fg, var(--xh-material-frosted-fg));
+    --xh-collection-fg-hover: var(--xh-select-item-fg, var(--xh-material-frosted-fg));
+    --xh-collection-fg-keyboard-highlight: var(--xh-select-item-fg, var(--xh-material-frosted-fg));
+    --xh-collection-fg-selected: var(--xh-select-item-fg-selected, var(--xh-select-item-fg, var(--xh-material-frosted-fg)));
+    --xh-collection-fg-selected-highlight: var(--xh-select-item-fg-selected, var(--xh-select-item-fg, var(--xh-material-frosted-fg)));
+    --xh-collection-fg-selected-hover: var(--xh-select-item-fg-selected, var(--xh-select-item-fg, var(--xh-material-frosted-fg)));
+    --xh-collection-fg-selected-pressed: var(--xh-select-item-fg-selected, var(--xh-select-item-fg, var(--xh-material-frosted-fg)));
+    --xh-collection-fg-pressed: var(--xh-select-item-fg, var(--xh-material-frosted-fg));
+    --xh-collection-font-weight-selected: var(--xh-select-item-font-weight-selected, var(--xh-font-weight-regular));
+    --xh-collection-font-weight-selected-highlight: var(--xh-select-item-font-weight-selected, var(--xh-font-weight-regular));
+    --xh-collection-font-weight-selected-hover: var(--xh-select-item-font-weight-selected, var(--xh-font-weight-regular));
+    --xh-collection-font-weight-selected-pressed: var(--xh-select-item-font-weight-selected, var(--xh-font-weight-regular));
+    --xh-collection-bg-hover: var(--xh-select-item-bg-hover, var(--xh-bg-subtle));
+    --xh-collection-bg-keyboard-highlight: var(--xh-select-item-bg-hover, var(--xh-bg-subtle));
+    --xh-collection-bg-selected-highlight: var(--xh-select-item-bg-hover, var(--xh-bg-subtle));
+    --xh-collection-bg-selected-hover: var(--xh-select-item-bg-hover, var(--xh-bg-subtle));
+    --xh-collection-bg-pressed: var(--xh-select-item-bg-pressed, var(--xh-bg-subtle-hover));
+    --xh-collection-bg-selected-pressed: var(--xh-select-item-bg-pressed, var(--xh-bg-subtle-hover));
+    /* data-highlighted 同时覆盖指针与键盘路径；指针只换面，焦点环在 :focus-visible 下再接回。 */
+    --xh-collection-outline-keyboard-highlight: transparent;
+    --xh-collection-outline-selected-highlight: transparent;
+    --xh-collection-indicator-fg-rest: var(--xh-select-item-check-fg, var(--xh-_select-accent));
+    --xh-collection-indicator-fg-checked: var(--xh-select-item-check-fg, var(--xh-_select-accent));
+    --xh-collection-indicator-fg-selected: var(--xh-select-item-check-fg, var(--xh-_select-accent));
+    --xh-collection-indicator-fg-selected-hover: var(--xh-select-item-check-fg, var(--xh-_select-accent));
+    --xh-collection-indicator-fg-selected-highlight: var(--xh-select-item-check-fg, var(--xh-_select-accent));
+    --xh-collection-indicator-fg-selected-pressed: var(--xh-select-item-check-fg, var(--xh-_select-accent));
+
+    /* 行高留出文字的上下伸展空间，行内那层 overflow:hidden 才不会把字削掉 */
+    line-height: var(--xh-select-item-leading, var(--xh-leading-normal));
+    white-space: nowrap;
+    user-select: none;
+  }
+
+  /* 键盘焦点出现时底色立即到位，环不会压在背景过渡的中间帧上。 */
+  [data-scope='select'][data-part='item']:focus-visible:not(:hover) {
+    --xh-collection-outline-keyboard-highlight: var(--xh-ring-focus);
+    --xh-collection-outline-selected-highlight: var(--xh-ring-focus);
+
+    transition: none;
   }
 
   [data-scope='select'][data-part='item-text'] {
-    flex: 1;
     /* 弹性子项默认最小尺寸是内容尺寸，不归零则长文本把行撑破、省略号轮不上 */
     min-inline-size: 0;
     overflow: hidden;
@@ -511,18 +529,22 @@
     text-overflow: ellipsis;
   }
 
-  /* 勾选标记只在选中项上出现；未选中时占位不塌，切换选中不引起行宽抖动 */
+  /* 勾选标记只在选中项上出现；未选中时占位不塌，切换选中不引起行宽抖动。
+     盒与盒里的勾是指示符（§6.5）：盒按指示符档取尺，并在自己身上把 --xh-icon-size 改接到盒的尺，皮肤画的
+     兜底勾与作者塞进盒里的 XhIcon 读同一把尺、与盒同边长（勾选标记不是勾选格，不取 × 0.75，与 Listbox / Menu 族
+     同口径）；不读家族按档下发到行的 --xh-icon-size——那支只管作者放进条目里的图标，按图标档取的 20px 比
+     16 / 14 的指示符档大一圈 */
   [data-scope='select'][data-part='item-indicator'] {
+    --xh-icon-size: var(--xh-select-item-indicator-size, var(--xh-control-indicator-size));
+
     display: inline-flex;
-    flex: none;
     align-items: center;
     justify-content: center;
     inline-size: var(--xh-select-item-indicator-size, var(--xh-control-indicator-size));
-    color: var(--xh-select-item-indicator-fg, var(--xh-_select-accent));
-    visibility: hidden;
+    block-size: var(--xh-select-item-indicator-size, var(--xh-control-indicator-size));
   }
 
-  /* 同上：没写内容就由皮肤画勾 */
+  /* 同上：没写内容就由皮肤画勾。尺寸读标记盒自己改接过的 --xh-icon-size：与盒同边长，随指示符档换档 */
   [data-scope='select'][data-part='item-indicator']:empty::before {
     content: '';
     display: inline-block;
@@ -534,10 +556,6 @@
     mask: var(--xh-glyph-mark-check) center / contain no-repeat;
   }
 
-  [data-scope='select'][data-part='item-indicator'][data-state='checked'] {
-    visibility: visible;
-  }
-
   /* 表单影子：视觉隐藏但留在布局与表单里，原生校验提示需要一个可定位的框 */
   [data-scope='select'][data-part='hidden-select'] {
     pointer-events: none;
@@ -555,27 +573,23 @@
     mask: var(--xh-glyph-mark-close) center / contain no-repeat;
   }
 
-  [data-scope='select'][data-part='item-delete-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;
-  }
-
   /* 声明过任何 display 就盖掉了 UA 的 [hidden]{display:none}，收起态得自己还回去。
      写在文件末尾：兜底必须排在该部件所有 display 声明之后 */
   [data-scope='select'][data-part='root'][hidden],
   [data-scope='select'][data-part='control'][hidden],
   [data-scope='select'][data-part='trigger'][hidden],
-  [data-scope='select'][data-part='tag'][hidden],
   [data-scope='select'][data-part='indicator'][hidden],
   [data-scope='select'][data-part='list'][hidden],
   [data-scope='select'][data-part='item'][hidden],
   [data-scope='select'][data-part='item-indicator'][hidden] {
     display: none;
   }
+
+  @media print {
+    /* 打印：定位层与遮罩是交互期才存在的东西，落到纸上只会盖住底下的正文。
+       收起写在这份皮肤里而不是 reset：reset 层排在组件层之前，组件层里任何一条 display 都压得住它。 */
+    [data-scope='select'][data-part='positioner'] {
+      display: none;
+    }
+  }
 }