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

package/css/card.css

@@ -27,7 +27,7 @@
   }
 
   [data-scope='card'][data-part='root'][data-variant='elevated'] {
-    box-shadow: var(--xh-elevation-2);
+    box-shadow: var(--xh-card-shadow, var(--xh-elevation-raised));
   }
 
   [data-scope='card'][data-part='root'][data-variant='ghost'] {
@@ -47,7 +47,7 @@
   @media (hover: hover) {
     [data-scope='card'][data-part='root'][data-hoverable]:hover {
       border-color: var(--xh-card-border, var(--xh-border-strong));
-      box-shadow: var(--xh-elevation-2);
+      box-shadow: var(--xh-card-shadow, var(--xh-elevation-raised));
     }
   }
 
@@ -74,18 +74,18 @@
   }
 
   [data-scope='card'][data-part='title'] {
-    font-size: var(--xh-card-title-font-size, var(--xh-font-size-md));
+    font-size: var(--xh-card-title-font-size, var(--xh-text-label-size));
     font-weight: var(--xh-font-weight-medium);
     line-height: var(--xh-leading-tight);
   }
 
   [data-scope='card'][data-part='root'][data-size='lg'] [data-part='title'] {
-    font-size: var(--xh-card-title-font-size, var(--xh-font-size-lg));
+    font-size: var(--xh-card-title-font-size, var(--xh-control-font-lg));
   }
 
   [data-scope='card'][data-part='description'] {
     color: var(--xh-fg-muted);
-    font-size: var(--xh-font-size-sm);
+    font-size: var(--xh-text-secondary-size);
     line-height: var(--xh-leading-normal);
   }
 

package/css/carousel.css

@@ -7,6 +7,9 @@
   /* 根节点是 region 地标：把上一张 / 视口 / 下一张排成一行，指示点另起一行。
      两端按钮浮在视口上还是排在两侧由作者定，这里只给最朴素的一版排布 */
   [data-scope='carousel'][data-part='root'] {
+    /* 作者塞进指示符槽的图标跟着字号走，与皮肤画的兜底字形同一把尺 */
+    --xh-icon-size: var(--xh-carousel-icon-size, var(--xh-glyph-size-text));
+
     display: flex;
     flex-wrap: wrap;
     align-items: center;
@@ -168,7 +171,7 @@
     /* 圆点本身没有文字，按钮里的文案（页码）交给作者，默认不显示 */
     padding: 0;
     border: 0;
-    border-radius: var(--xh-carousel-indicator-radius, var(--xh-radius-full));
+    border-radius: var(--xh-carousel-indicator-radius, var(--xh-shape-pill));
     background: var(--xh-carousel-indicator-bg, var(--xh-border-control));
     font-size: 0;
     cursor: pointer;
@@ -179,20 +182,48 @@
     display: none;
   }
 
-  [data-scope='carousel'][data-part='indicator']:hover:not([data-selected]) {
+  [data-scope='carousel'][data-part='indicator']:hover:not([data-current]) {
     background: var(--xh-carousel-indicator-bg-hover, var(--xh-fg-subtle));
   }
 
-  /* 当前页：data-selected 与 aria-current='true' 由连接层成对给出，
+  /* 当前页：data-current 与 aria-current='true' 由连接层成对给出，
      样式挂在 data 钩子上，无障碍语义留给 aria，两边各司其职 */
-  [data-scope='carousel'][data-part='indicator'][data-selected] {
+  [data-scope='carousel'][data-part='indicator'][data-current] {
     background: var(--xh-carousel-indicator-bg-selected, var(--xh-bg-brand));
   }
 
-  /* 减少动效：位移立刻到位。翻页本身照常发生，只是不再有滑动的过程 */
+  /* 减少动效：位移立刻到位。翻页本身照常发生，只是不再有滑动的过程。
+     两条规则是同一件事的两个触发条件：系统偏好与作者打的 data-motion */
   @media (prefers-reduced-motion: reduce) {
     [data-scope='carousel'][data-part='item-group'] {
       transition: none;
     }
   }
+
+  :where([data-motion='reduce']) [data-scope='carousel'][data-part='item-group'] {
+    transition: none;
+  }
+
+  /* 没写内容就由皮肤画兜底字形；作者往部件里塞了自己的图形，这几条即不命中 */
+  [data-scope='carousel'][data-part='prev-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='carousel'][data-part='next-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;
+  }
 }

package/css/cascader.css

@@ -4,11 +4,25 @@
     --xh-cascader-skin: 1;
   }
 
-  /* 解剖里没有把「触发器 + 清空按钮」裹在一起的 control 部件，一行是靠 flex-wrap 分出来的：
-     标签占满整行把后面的挤到下一行，触发器与清空按钮就并排落在同一行上。
-     这样作者少写标签、少写清空按钮，剩下的部件也不会塌 */
-  [data-scope='cascader'][data-part='root'] {
-    /* 尺寸档只换这几个私有槽，触发框与列里的条目都从 root 继承它们，换档不必给每个部件各写一条选择器 */
+  /* 坐标由定位引擎写进 style（inset-inline-start / inset-block-start），这里只定位模式与层级 */
+  [data-scope='cascader'][data-part='positioner'] {
+    position: fixed;
+    z-index: var(--xh-cascader-layer, var(--xh-layer-popover));
+    /* 空壳不吃指针，交互只发生在 content 里 */
+    pointer-events: none;
+  }
+
+  /* 锚点被滚出可视区：整个浮层随之收起 */
+  [data-scope='cascader'][data-part='positioner'][data-hidden] {
+    visibility: hidden;
+  }
+
+  /* 私有槽同时声明在根与 positioner 上：浮层被搬到 portal 落点，不是根的后代，继承不过去 */
+  [data-scope='cascader']:is([data-part='root'], [data-part='positioner']) {
+    /* 作者塞进指示符槽的图标跟着尺寸档走，与皮肤画的兜底字形同一把尺 */
+    --xh-icon-size: var(--xh-cascader-icon-size, var(--xh-glyph-size-md));
+
+    /* 尺寸档只换这几个私有槽，盒与列里的条目都从这两处继承它们，换档不必给每个部件各写一条选择器 */
     --xh-_cascader-h: var(--xh-control-h-md);
     --xh-_cascader-px: var(--xh-control-px-md);
     --xh-_cascader-gap: var(--xh-control-gap-md);
@@ -27,9 +41,14 @@
     /* 展开路径的底色：随语气走淡底，没写 data-tone 时退回品牌淡底 */
     --xh-_cascader-active-bg: var(--xh-_tone-subtle, var(--xh-bg-brand-subtle));
 
+    /* 聚焦环恒用固定环色；校验失败时换成告警环色 */
+    --xh-_cascader-ring: var(--xh-ring-focus);
+  }
+
+  /* 标签一行、盒一行的两行堆叠 */
+  [data-scope='cascader'][data-part='root'] {
     display: inline-flex;
-    flex-wrap: wrap;
-    align-items: center;
+    flex-direction: column;
     gap: var(--xh-cascader-gap, var(--xh-space-1));
   }
 
@@ -41,48 +60,48 @@
   /* —— 形态 —— */
   /* 形态只决定描边与底色怎么用；用哪族颜色由 data-tone 决定，没写 tone 就沿用原来的中性配色 */
   /* outline 就是缺省那一身：描边加画布底，写出来只为让三档并列可读 */
-  [data-scope='cascader'][data-part='root'][data-variant='outline'] {
+  [data-scope='cascader']:is([data-part='root'], [data-part='positioner'])[data-variant='outline'] {
     --xh-_cascader-border: var(--xh-border-control);
     --xh-_cascader-border-hover: var(--xh-border-control-hover);
     --xh-_cascader-bg: var(--xh-bg-canvas);
   }
 
   /* subtle 是填充式：底色接过「这里能点」的表达，描边随之让位 */
-  [data-scope='cascader'][data-part='root'][data-variant='subtle'] {
+  [data-scope='cascader']:is([data-part='root'], [data-part='positioner'])[data-variant='subtle'] {
     --xh-_cascader-border: transparent;
     --xh-_cascader-border-hover: var(--xh-_tone-border, var(--xh-border-control-hover));
     --xh-_cascader-bg: var(--xh-_tone-subtle, var(--xh-bg-subtle));
   }
 
-  /* ghost 无框无底，可见反馈只在聚焦时给；边框宽度仍占位，切换形态不引起布局抖动 */
-  [data-scope='cascader'][data-part='root'][data-variant='ghost'] {
+  /* 无框：底与常态描边透明，悬停浮出描边，聚焦由焦点环表达 */
+  [data-scope='cascader']:is([data-part='root'], [data-part='positioner'])[data-variant='ghost'] {
     --xh-_cascader-border: transparent;
-    --xh-_cascader-border-hover: transparent;
+    --xh-_cascader-border-hover: var(--xh-_tone-border, var(--xh-border-control-hover));
     --xh-_cascader-bg: transparent;
   }
 
   /* —— 尺寸 —— */
   /* 缺省档写在上面的基础规则里 */
-  [data-scope='cascader'][data-part='root'][data-size='sm'] {
+  [data-scope='cascader']:is([data-part='root'], [data-part='positioner'])[data-size='sm'] {
+    --xh-icon-size: var(--xh-cascader-icon-size, var(--xh-glyph-size-sm));
     --xh-_cascader-h: var(--xh-control-h-sm);
     --xh-_cascader-px: var(--xh-control-px-sm);
     --xh-_cascader-gap: var(--xh-control-gap-sm);
-    --xh-_cascader-font-size: var(--xh-font-size-sm);
-    --xh-_cascader-label-font-size: var(--xh-font-size-sm);
+    --xh-_cascader-font-size: var(--xh-control-font-sm);
+    --xh-_cascader-label-font-size: var(--xh-control-font-sm);
   }
 
-  [data-scope='cascader'][data-part='root'][data-size='lg'] {
+  [data-scope='cascader']:is([data-part='root'], [data-part='positioner'])[data-size='lg'] {
+    --xh-icon-size: var(--xh-cascader-icon-size, var(--xh-glyph-size-lg));
     --xh-_cascader-h: var(--xh-control-h-lg);
     --xh-_cascader-px: var(--xh-control-px-lg);
     --xh-_cascader-gap: var(--xh-control-gap-lg);
-    --xh-_cascader-font-size: var(--xh-font-size-lg);
-    --xh-_cascader-label-font-size: var(--xh-font-size-lg);
+    --xh-_cascader-font-size: var(--xh-control-font-lg);
+    --xh-_cascader-label-font-size: var(--xh-control-font-lg);
   }
 
   [data-scope='cascader'][data-part='label'] {
-    /* 占满整行，把触发器那一行挤下去 */
-    flex-basis: 100%;
-    color: var(--xh-cascader-label-fg, var(--xh-fg-muted));
+    color: var(--xh-cascader-label-fg, var(--xh-fg-default));
     font-size: var(--xh-cascader-label-font-size, var(--xh-_cascader-label-font-size));
     font-weight: var(--xh-cascader-label-font-weight, var(--xh-text-label-weight));
     line-height: var(--xh-leading-none);
@@ -93,64 +112,88 @@
     color: var(--xh-fg-subtle);
   }
 
-  /* 画成一个框的就是 trigger 自己：整条路径的回显与展开箭头都长在它里面，
-     清空按钮贴在框外与它并排 */
-  [data-scope='cascader'][data-part='trigger'] {
+  /* 盒：描边、底色、控件高度与行内内衬都落在这一层，触发按钮与清空按钮在里面并排 */
+  [data-scope='cascader'][data-part='control'] {
     display: inline-flex;
-    flex: 1;
     align-items: center;
-    justify-content: space-between;
-    gap: var(--xh-cascader-trigger-gap, var(--xh-_cascader-gap));
-    min-inline-size: var(--xh-cascader-trigger-min-w, 14rem);
-    block-size: var(--xh-cascader-trigger-h, var(--xh-_cascader-h));
-    padding-inline: var(--xh-cascader-trigger-px, var(--xh-_cascader-px));
-    border: var(--xh-stroke-thin) solid var(--xh-cascader-trigger-border, var(--xh-_cascader-border));
-    border-radius: var(--xh-cascader-trigger-radius, var(--xh-shape-control));
-    background: var(--xh-cascader-trigger-bg, var(--xh-_cascader-bg));
-    color: var(--xh-cascader-trigger-fg, var(--xh-fg-default));
-    font-family: inherit;
-    font-size: var(--xh-cascader-trigger-font-size, var(--xh-_cascader-font-size));
-    line-height: var(--xh-leading-none);
-    text-align: start;
+    gap: var(--xh-cascader-control-gap, var(--xh-_cascader-gap));
+    min-inline-size: var(--xh-cascader-control-min-w, var(--xh-control-min-w));
+    block-size: var(--xh-cascader-control-h, var(--xh-_cascader-h));
+    padding-inline: var(--xh-cascader-control-px, var(--xh-_cascader-px));
+    border: var(--xh-stroke-thin) solid var(--xh-cascader-control-border, var(--xh-_cascader-border));
+    border-radius: var(--xh-cascader-control-radius, var(--xh-shape-control));
+    background: var(--xh-cascader-control-bg, var(--xh-_cascader-bg));
+    color: var(--xh-cascader-control-fg, var(--xh-fg-default));
     cursor: pointer;
     transition: border-color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
   }
 
-  [data-scope='cascader'][data-part='trigger'][hidden] {
+  [data-scope='cascader'][data-part='control'][hidden] {
     display: none;
   }
 
   /* hover 只在中性态换描边：invalid 正拿边框颜色说事，被 hover 盖掉那条信息就没了 */
-  [data-scope='cascader'][data-part='trigger']:hover:not(:disabled, [data-invalid]) {
-    border-color: var(--xh-cascader-trigger-border-hover, var(--xh-_cascader-border-hover));
+  [data-scope='cascader'][data-part='control']:hover:not([data-disabled], [data-invalid]) {
+    border-color: var(--xh-cascader-control-border-hover, var(--xh-_cascader-border-hover));
   }
 
-  /* trigger 是整个控件唯一的 Tab 停靠点（展开后停靠点才移进列里），落焦必须看得见。
-     聚焦环恒用固定环色，不随语气走 */
-  [data-scope='cascader'][data-part='trigger']:focus-visible {
-    outline: var(--xh-ring-width) solid var(--xh-ring-focus);
+  /* Tab 停靠点是盒里的 trigger（展开后才移进列里），环画在盒上 */
+  [data-scope='cascader'][data-part='control']:focus-within:not([data-disabled]) {
+    border-color: var(--xh-cascader-control-border-focus, var(--xh-_tone, var(--xh-border-control-focus)));
+    outline: var(--xh-ring-width) solid var(--xh-_cascader-ring);
     outline-offset: var(--xh-ring-offset);
   }
 
-  [data-scope='cascader'][data-part='trigger'][data-invalid] {
-    border-color: var(--xh-cascader-trigger-border-invalid, var(--xh-color-danger-500));
+  [data-scope='cascader'][data-part='control'][data-invalid] {
+    border-color: var(--xh-cascader-control-border-invalid, var(--xh-border-invalid));
+
+    /* 校验失败时环也跟着变红：两圈等宽相邻却一红一蓝，读的人不知道哪个才是当前状态 */
+    --xh-_cascader-ring: var(--xh-ring-invalid);
   }
 
   /* 只读仍可聚焦、浮层仍展得开、列仍能浏览，所以不置灰，只把底色压下去表示「改不动」 */
-  [data-scope='cascader'][data-part='trigger'][data-readonly] {
-    background: var(--xh-cascader-trigger-bg-readonly, var(--xh-bg-subtle));
+  [data-scope='cascader'][data-part='control'][data-readonly] {
+    background: var(--xh-cascader-control-bg-readonly, var(--xh-bg-subtle));
+  }
+
+  [data-scope='cascader'][data-part='control'][data-disabled] {
+    background: var(--xh-cascader-control-bg-disabled, var(--xh-bg-subtle));
+    color: var(--xh-fg-disabled);
+    cursor: not-allowed;
+  }
+
+  /* 盒内那颗可聚焦的按钮：不画描边不铺底也不自带高度，只占满剩余宽度、排布回显与箭头 */
+  [data-scope='cascader'][data-part='trigger'] {
+    display: inline-flex;
+    flex: 1 1 auto;
+    align-items: center;
+    justify-content: space-between;
+    gap: var(--xh-cascader-trigger-gap, var(--xh-_cascader-gap));
+    min-inline-size: 0;
+    padding: 0;
+    border: 0;
+    background: transparent;
+    color: var(--xh-cascader-trigger-fg, var(--xh-fg-default));
+    font-family: inherit;
+    font-size: var(--xh-cascader-trigger-font-size, var(--xh-_cascader-font-size));
+    line-height: var(--xh-leading-none);
+    text-align: start;
+    cursor: pointer;
+  }
+
+  [data-scope='cascader'][data-part='trigger'][hidden] {
+    display: none;
   }
 
   /* trigger 是单体控件，用原生 disabled（列里的集合条目一律 aria-disabled，写 :disabled 永不命中） */
   [data-scope='cascader'][data-part='trigger']:disabled {
-    background: var(--xh-cascader-trigger-bg-disabled, var(--xh-bg-subtle));
     color: var(--xh-fg-disabled);
     cursor: not-allowed;
   }
 
-  /* 路径连起来会很长，必须能截断；框宽由 trigger 定，这里得允许自己被压缩 */
+  /* 路径连起来会很长，必须能截断；框宽由盒定，这里得允许自己被压缩 */
   [data-scope='cascader'][data-part='value-text'] {
-    flex: 1;
+    flex: 1 1 auto;
     min-inline-size: 0;
     overflow: hidden;
     white-space: nowrap;
@@ -166,6 +209,12 @@
     color: var(--xh-fg-disabled);
   }
 
+  /* 有值时清空钮顶上来，箭头让位：两个图标并排堆着，用户分不清点哪个。
+     让位而不是禁用——禁用的图标还占着位置，看着像坏了 */
+  [data-scope='cascader'][data-part='indicator'][data-clearable] {
+    display: none;
+  }
+
   [data-scope='cascader'][data-part='indicator'] {
     display: inline-flex;
     flex: none;
@@ -181,7 +230,14 @@
 
   /* 没写内容就由皮肤画箭头；作者往部件里塞了自己的图形，这条规则即不命中 */
   [data-scope='cascader'][data-part='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-chevron-down) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-chevron-down) center / contain no-repeat;
   }
 
   [data-scope='cascader'][data-part='indicator'][data-state='open'] {
@@ -192,7 +248,7 @@
     color: var(--xh-fg-disabled);
   }
 
-  /* 贴在触发框旁边的小方钮，不撑高那一行 */
+  /* 盒内靠右的小方钮，不撑高那一行 */
   [data-scope='cascader'][data-part='clear-trigger'] {
     display: inline-flex;
     flex: none;
@@ -206,24 +262,25 @@
     background: var(--xh-cascader-action-bg, transparent);
     color: var(--xh-cascader-action-fg, var(--xh-fg-muted));
     font-family: inherit;
-    font-size: var(--xh-cascader-action-font-size, var(--xh-font-size-sm));
+    font-size: var(--xh-cascader-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='cascader'][data-part='clear-trigger'][hidden] {
     display: none;
   }
 
-  [data-scope='cascader'][data-part='clear-trigger']:hover:not(:disabled) {
+  [data-scope='cascader'][data-part='clear-trigger']:hover {
     background: var(--xh-cascader-action-bg-hover, var(--xh-bg-subtle-hover));
     color: var(--xh-cascader-action-fg-hover, var(--xh-fg-default));
   }
 
-  [data-scope='cascader'][data-part='clear-trigger']:active:not(:disabled) {
+  [data-scope='cascader'][data-part='clear-trigger']:active {
     background: var(--xh-cascader-action-bg-active, var(--xh-bg-subtle-active));
+    scale: var(--xh-motion-scale-press);
   }
 
   /* 清空按钮退出了 Tab 序列（tabindex=-1），正常操作走不到这里；
@@ -233,47 +290,28 @@
     outline-offset: var(--xh-ring-offset);
   }
 
-  /* 无选中、只读、整控件禁用三种情况下都按不动，用的是原生 disabled */
-  [data-scope='cascader'][data-part='clear-trigger']:disabled {
-    background: var(--xh-cascader-action-bg, transparent);
-    color: var(--xh-fg-disabled);
-    cursor: not-allowed;
-  }
-
-  /* 坐标由定位引擎写进 style（inset-inline-start / inset-block-start），这里只定位模式与层级 */
-  [data-scope='cascader'][data-part='positioner'] {
-    position: fixed;
-    z-index: var(--xh-layer-popover);
-    /* 空壳不吃指针，交互只发生在 content 里 */
-    pointer-events: none;
-  }
-
-  /* 锚点被滚出可视区：整个浮层随之收起 */
-  [data-scope='cascader'][data-part='positioner'][data-hidden] {
-    visibility: hidden;
-  }
-
   /* 级联的骨架就在这一条上：列沿书写方向并排，一层一列。
      横向随列数增减，因此不设固定宽度，只给每列自己的宽度 */
   [data-scope='cascader'][data-part='content'] {
     display: flex;
     flex-direction: row;
     align-items: stretch;
-    max-inline-size: var(--xh-cascader-content-max-w, 48rem);
+    max-inline-size: var(--xh-cascader-content-max-w, var(--xh-overlay-max-w-xl));
     border: var(--xh-stroke-thin) solid var(--xh-cascader-content-border, var(--xh-border-default));
     border-radius: var(--xh-cascader-content-radius, var(--xh-shape-surface));
     background: var(--xh-cascader-content-bg, var(--xh-bg-surface));
     color: var(--xh-cascader-content-fg, var(--xh-fg-default));
-    box-shadow: var(--xh-cascader-content-shadow, var(--xh-elevation-2));
+    box-shadow: var(--xh-cascader-content-shadow, var(--xh-elevation-floating));
     /* 列多到放不下时整体横向滚动；纵向溢出归每一列自己 */
     overflow-x: auto;
     pointer-events: auto;
   }
 
-  /* 收起态的唯一开关：display 盖掉了 UA 的 [hidden]{display:none}，漏了这条浮层就收不起来 */
-  [data-scope='cascader'][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='cascader'][data-part='content']:focus-visible {
@@ -281,14 +319,13 @@
   }
 
   [data-scope='cascader'][data-part='content'][data-state='open'] {
-    /* 入场横移沿书写方向起始缘：位移量经私有槽供给关键帧，rtl 只翻符号 */
-    --xh-_cascader-slide: calc(-1 * var(--xh-motion-distance-sm));
-
-    animation: xh-cascader-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);
   }
 
-  [dir='rtl'] [data-scope='cascader'][data-part='content'][data-state='open'] {
-    --xh-_cascader-slide: var(--xh-motion-distance-sm);
+  /* 退场：收起那一帧 hidden 由退场闸门押后，这里才播得出来。forwards 把末态钉住，
+     免得动画结束到真收起之间闪一下原样 */
+  [data-scope='cascader'][data-part='content'][data-state='closed'] {
+    animation: xh-pop-out var(--xh-motion-duration-exit) var(--xh-motion-ease-exit) forwards;
   }
 
   /* 一列：宽度由内容撑出、设下限防塌，高度定死——切换展开路径时浮层不上下跳动，
@@ -298,7 +335,7 @@
     flex: none;
     flex-direction: column;
     min-inline-size: var(--xh-cascader-column-min-w, 7rem);
-    block-size: var(--xh-cascader-column-h, 11.25rem);
+    block-size: var(--xh-cascader-column-h, var(--xh-viewport-h-sm));
     padding-block: var(--xh-cascader-column-py, var(--xh-space-1));
     padding-inline: var(--xh-cascader-column-px, var(--xh-space-1));
     overflow-y: auto;
@@ -331,7 +368,7 @@
     display: flex;
     align-items: center;
     gap: var(--xh-cascader-row-gap, var(--xh-_cascader-gap));
-    max-inline-size: var(--xh-cascader-row-max-w, 25rem);
+    max-inline-size: var(--xh-cascader-row-max-w, var(--xh-overlay-max-w));
     padding-block: var(--xh-cascader-row-py, var(--xh-space-1_5));
     padding-inline: var(--xh-cascader-row-px, var(--xh-control-px-md));
     border-radius: var(--xh-cascader-row-radius, var(--xh-shape-control));
@@ -361,14 +398,14 @@
   }
 
   /* 必须排在轻档之后：锚点走到路径上时同特指度靠书写顺序压过轻档 */
-  [data-scope='cascader'][data-part='item']:not([data-disabled])[data-active] {
+  [data-scope='cascader'][data-part='item']:not([data-disabled])[data-in-path] {
     background: var(--xh-cascader-row-bg-active, var(--xh-_cascader-active-bg));
     font-weight: var(--xh-cascader-row-active-font-weight, var(--xh-font-weight-semibold));
   }
 
   /* 选中只换文字色与字重，配合行尾的 ✓ 标记；底色强档归展开路径、轻档归悬停，
      三者因此能同时看见 */
-  [data-scope='cascader'][data-part='item'][data-selected] {
+  [data-scope='cascader']:is([data-part='item'], [data-part='search-item'])[data-state='checked'] {
     color: var(--xh-cascader-row-fg-selected, var(--xh-_cascader-selected-fg));
     font-weight: var(--xh-cascader-row-selected-font-weight, var(--xh-font-weight-medium));
   }
@@ -433,10 +470,17 @@
 
   /* 没写内容就由皮肤画勾；作者往部件里塞了自己的图形，这条规则即不命中 */
   [data-scope='cascader'][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='cascader'][data-part='item-indicator'][data-selected] {
+  [data-scope='cascader'][data-part='item-indicator'][data-state='checked'] {
     visibility: visible;
   }
 
@@ -446,8 +490,15 @@
     visibility: visible;
   }
 
-  [data-scope='cascader'][data-part='item-indicator'][data-indeterminate]:not([data-selected]):empty::before {
-    content: '−';
+  [data-scope='cascader'][data-part='item-indicator'][data-indeterminate]:not([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-minus) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-minus) center / contain no-repeat;
     font-weight: var(--xh-font-weight-semibold);
   }
 
@@ -484,11 +535,12 @@
     display: none;
   }
 
+  /* 与列同高：搜索视图与浏览视图互换时浮层不改高度，候选多了在列表内自己滚 */
   [data-scope='cascader'][data-part='search-list'] {
     display: flex;
     flex-basis: 100%;
     flex-direction: column;
-    max-block-size: var(--xh-cascader-search-max-h, 11.25rem);
+    block-size: var(--xh-cascader-column-h, var(--xh-viewport-h-sm));
     padding: var(--xh-cascader-search-p, var(--xh-space-1));
     overflow-y: auto;
   }
@@ -527,6 +579,12 @@
     background: var(--xh-cascader-row-bg-hover, var(--xh-bg-subtle));
   }
 
+  /* 焦点恒在输入框，环只跟虚拟高亮走，悬停不画；往内收，行是撑满列宽的，环画在外沿会被裁掉 */
+  [data-scope='cascader'][data-part='search-item']:not([data-disabled])[data-highlighted] {
+    outline: var(--xh-ring-width) solid var(--xh-ring-focus);
+    outline-offset: calc(-1 * var(--xh-ring-width));
+  }
+
   [data-scope='cascader'][data-part='search-item'][data-disabled] {
     color: var(--xh-fg-disabled);
     cursor: not-allowed;
@@ -557,21 +615,44 @@
   [data-scope='cascader'][data-part='empty'][hidden] {
     display: none;
   }
+
+  /* 没写内容就由皮肤画兜底字形；作者往部件里塞了自己的图形，这几条即不命中 */
+  [data-scope='cascader'][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;
+  }
 }
 
 @layer xihan.motion {
   /* 浮层是横向长出来的：淡入之外再沿书写方向起始缘推一小段，观感上像列被「拉开」。
      位移量从 content 上的私有槽取，rtl 侧翻符号后同一份关键帧两个方向都对。
      关键帧写在本文件里、名字带组件前缀，不动公共的那一份 */
-  @keyframes xh-cascader-in {
+  @keyframes xh-pop-in {
     from {
       opacity: 0;
-      translate: var(--xh-_cascader-slide, calc(-1 * var(--xh-motion-distance-sm))) 0;
+      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);
     }
   }
 }