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

package/css/accordion.css

@@ -12,7 +12,7 @@
     --xh-_accordion-trigger-h: var(--xh-control-h-md);
     --xh-_accordion-trigger-px: var(--xh-control-px-md);
     --xh-_accordion-trigger-gap: var(--xh-control-gap-md);
-    --xh-_accordion-trigger-font-size: var(--xh-text-label-size);
+    --xh-_accordion-trigger-font-size: var(--xh-control-font-md);
 
     /* 语气落在展开着的标题上，指示器写在标题里、跟着继承这个色，不另立规则。
        没写 data-tone 时 --xh-_tone-fg 没被声明，退回原来的前景色。
@@ -45,10 +45,25 @@
   }
 
   [data-scope='accordion'][data-part='item'] {
-    border-block-end: var(--xh-stroke-thin) solid var(--xh-accordion-item-border, var(--xh-border-default));
     min-inline-size: 0;
   }
 
+  /* 分隔线画在后一条的起始边，条与条之间才只有一条，末条也不会留一条悬空线
+     （根没有外框接住它）。只认自己的直接子条目：套在条目里的另一份手风琴由它自己的根管。
+     横排时换成行内轴那一侧 */
+  [data-scope='accordion'][data-part='root']
+    > [data-scope='accordion'][data-part='item']
+    + [data-scope='accordion'][data-part='item'] {
+    border-block-start: var(--xh-stroke-thin) solid var(--xh-accordion-item-border, var(--xh-border-subtle));
+  }
+
+  [data-scope='accordion'][data-part='root'][data-orientation='horizontal']
+    > [data-scope='accordion'][data-part='item']
+    + [data-scope='accordion'][data-part='item'] {
+    border-block-start: 0;
+    border-inline-start: var(--xh-stroke-thin) solid var(--xh-accordion-item-border, var(--xh-border-subtle));
+  }
+
   [data-scope='accordion'][data-part='header'] {
     margin: 0;
     font: inherit;
@@ -161,4 +176,12 @@
       padding-block: 0;
     }
   }
+
+  /* 声明过任何 display 就盖掉了 UA 的 [hidden]{display:none}，收起态得自己还回去。
+     写在文件末尾：兜底必须排在该部件所有 display 声明之后 */
+  [data-scope='accordion'][data-part='root'][hidden],
+  [data-scope='accordion'][data-part='trigger'][hidden],
+  [data-scope='accordion'][data-part='indicator'][hidden] {
+    display: none;
+  }
 }

package/css/alert.css

@@ -8,13 +8,11 @@
     /* 作者塞进指示符槽的图标跟着字号走，与皮肤画的兜底字形同一把尺 */
     --xh-icon-size: var(--xh-alert-icon-size, var(--xh-glyph-size-text));
 
-    /* 强调色随语气走，底色/描边/图标色都由它推导出来，换语气不必逐条属性各写一遍。
-       没写 data-tone 时 --xh-_tone 没被声明，退回原来的 info 蓝 */
-    --xh-_alert-accent: var(--xh-_tone-soft, var(--xh-color-info-500));
-    /* 底色与描边由语气色兑进当前表面色得到：表面色本身跟着深浅模式翻，
-       兑出来的淡底也就跟着翻，不必为深色再写一套选择器 */
-    --xh-_alert-tint: color-mix(in oklab, var(--xh-_alert-accent) 12%, var(--xh-bg-surface));
-    --xh-_alert-edge: color-mix(in oklab, var(--xh-_alert-accent) 32%, var(--xh-bg-surface));
+    /* 底色、描边、图标色一律取语气层派生好的槽：连接层给 alert 兜了 tone=info 的缺省，
+       data-tone 恒在，语气层的槽也就恒被声明。此前这里自己又兑了一遍（12% / 32%），
+       与语气层的公式差一档，图标压上去只有 1.79–2.47 */
+    --xh-_alert-tint: var(--xh-_tone-subtle);
+    --xh-_alert-edge: var(--xh-_tone-border);
 
     display: flex;
     /* 说明用 flex: 1 1 100% 独占一行，容器不换行的话它只会挤在标题旁边 */
@@ -44,8 +42,8 @@
     flex: none;
     /* 与首行文字对齐：图标框高取一行正文的行高 */
     block-size: calc(var(--xh-text-body-size) * var(--xh-leading-normal));
-    inline-size: var(--xh-alert-icon-size, var(--xh-control-indicator-size));
-    color: var(--xh-alert-icon-fg, var(--xh-_alert-accent));
+    inline-size: var(--xh-alert-icon-box, var(--xh-control-indicator-size));
+    color: var(--xh-alert-icon-fg, var(--xh-_tone-fg));
   }
 
   /* 标题与说明摞成一列，占满 root 剩下的横向空间，
@@ -135,4 +133,10 @@
     -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='alert'][data-part='icon'][hidden] {
+    display: none;
+  }
 }

package/css/anchor.css

@@ -8,7 +8,7 @@
      这里不给 display，UA 的 [hidden]{display:none} 就仍然压得住 */
   [data-scope='anchor'][data-part='root'] {
     /* 尺寸档只换这两个私有槽，链接从 root 继承它们，换档不必给每个部件各写一条选择器 */
-    --xh-_anchor-font-size: var(--xh-text-label-size);
+    --xh-_anchor-font-size: var(--xh-control-font-md);
     --xh-_anchor-link-px: var(--xh-control-px-md);
     /* 当前那一节的指示条与文字随语气走。没写 data-tone 时这两个槽都没被声明，退回原来的品牌色。
        指示条是装饰性的色条，取柔和档；文字要压在普通背景上读，取语气的文字档。

package/css/avatar-group.css

@@ -7,9 +7,13 @@
   /* 一排叠放的头像：后一枚压在前一枚上。
      组内共用的直径与字号在容器上写一次，沿继承流给每一枚；自己写了档位的那一枚仍按自己的档走 */
   [data-scope='avatar-group'][data-part='root'] {
+    /* 组件内那几档层号只在自己人之间排序：建一个层叠上下文把它们关起来，
+       既不让页面上的层号插进来，也不让它们漏出去压住别人 */
+    isolation: isolate;
+
     /* 私有槽位：整组共用的直径、字号与叠放量，换档只改这三个 */
     --xh-_avatar-group-size: var(--xh-avatar-group-size, var(--xh-control-h-md));
-    --xh-_avatar-group-font-size: var(--xh-avatar-group-font-size, var(--xh-text-secondary-size));
+    --xh-_avatar-group-font-size: var(--xh-avatar-group-font-size, var(--xh-control-caption-md));
     --xh-_avatar-group-overlap: var(--xh-avatar-group-overlap, var(--xh-space-2_5));
 
     /* 流给组内每一枚 */

package/css/avatar.css

@@ -57,4 +57,10 @@
   [data-scope='avatar'][data-part='fallback'][hidden] {
     display: none;
   }
+
+  /* 声明过任何 display 就盖掉了 UA 的 [hidden]{display:none}，收起态得自己还回去。
+     写在文件末尾：兜底必须排在该部件所有 display 声明之后 */
+  [data-scope='avatar'][data-part='root'][hidden] {
+    display: none;
+  }
 }

package/css/back-top.css

@@ -78,4 +78,10 @@
     -webkit-mask: var(--xh-glyph-mark-chevron-up) center / contain no-repeat;
     mask: var(--xh-glyph-mark-chevron-up) center / contain no-repeat;
   }
+
+  /* 声明过任何 display 就盖掉了 UA 的 [hidden]{display:none}，收起态得自己还回去。
+     写在文件末尾：兜底必须排在该部件所有 display 声明之后 */
+  [data-scope='back-top'][data-part='trigger'][hidden] {
+    display: none;
+  }
 }

package/css/badge.css

@@ -4,66 +4,124 @@
     --xh-badge-skin: 1;
   }
 
+  /* 锚点：被标记的那个东西（按钮、头像、标签页）放进它里面。
+     角标绝对定位在它的角上，所以这一层必须建定位上下文，且不能自己撑出尺寸 */
   [data-scope='badge'][data-part='root'] {
+    position: relative;
+    display: inline-flex;
+    /* 角标探出宿主边界是常态，不能被裁掉 */
+    overflow: visible;
+    vertical-align: middle;
+  }
+
+  /* 锚点也可能被作者整块收起 */
+  [data-scope='badge'][data-part='root'][hidden] {
+    display: none;
+  }
+
+  /* 角标本身。档位换的是圆点直径、两位数时的最小宽度与字号——
+     不是药丸那套内衬与行高：那是 tag 的活 */
+  [data-scope='badge'][data-part='indicator'] {
+    /* 每一档的盒都要大于字号：两位数在等高的盒里会被撑破。
+       字号刻度最小就是 12px，所以往上抬盒子而不是往下压字 */
+    --xh-_badge-dot: var(--xh-space-2);
+    --xh-_badge-min: var(--xh-space-5);
+    --xh-_badge-px: var(--xh-space-1);
+    --xh-_badge-font: var(--xh-text-secondary-size);
+
+    /* 不设 z-index：角标在 DOM 序里排在宿主之后，本来就压在上面 */
+    position: absolute;
     display: inline-flex;
     align-items: center;
-    gap: var(--xh-space-1);
-    padding-inline: var(--xh-space-2);
-    padding-block: var(--xh-space-0_5);
-    border: var(--xh-stroke-thin) solid transparent;
-    border-radius: var(--xh-shape-pill);
-    background: var(--xh-badge-bg, var(--xh-bg-subtle));
-    color: var(--xh-badge-fg, var(--xh-fg-default));
-    font-size: var(--xh-badge-font-size, var(--xh-text-caption-size));
+    justify-content: center;
+    box-sizing: border-box;
+    min-inline-size: var(--xh-badge-min-size, var(--xh-_badge-min));
+    block-size: var(--xh-badge-min-size, var(--xh-_badge-min));
+    padding-inline: var(--xh-badge-px, var(--xh-_badge-px));
+    border: var(--xh-stroke-thin) solid var(--xh-badge-ring, var(--xh-bg-surface));
+    border-radius: var(--xh-badge-radius, var(--xh-shape-pill));
+    /* 角标默认就是实心的：贴在别的东西上，淡底与描边都看不清 */
+    background: var(--xh-badge-bg, var(--xh-_tone, var(--xh-bg-brand)));
+    color: var(--xh-badge-fg, var(--xh-_tone-on, var(--xh-fg-on-brand)));
+    font-size: var(--xh-badge-font-size, var(--xh-_badge-font));
     font-weight: var(--xh-badge-font-weight, var(--xh-font-weight-medium));
     line-height: var(--xh-leading-none);
+    /* 出的是计数，数字必须等宽：不然 9 跳到 10 时角标的宽度会抖一下 */
+    font-variant-numeric: tabular-nums;
     white-space: nowrap;
+    pointer-events: none;
   }
 
   /* 声明了 display 就盖掉了 UA 的 [hidden]{display:none}，收起态得自己还回去。
      计数为 0 且没开 showZero 时连接层会发 hidden */
-  [data-scope='badge'][data-part='root'][hidden] {
+  [data-scope='badge'][data-part='indicator'][hidden] {
     display: none;
   }
 
   /* 圆点形态：只表示「有」，不表示「有几个」——收掉内边距与文字盒 */
-  [data-scope='badge'][data-part='root'][data-dot] {
-    inline-size: var(--xh-badge-dot-size, var(--xh-space-2));
-    block-size: var(--xh-badge-dot-size, var(--xh-space-2));
+  [data-scope='badge'][data-part='indicator'][data-dot] {
+    min-inline-size: var(--xh-badge-dot-size, var(--xh-_badge-dot));
+    inline-size: var(--xh-badge-dot-size, var(--xh-_badge-dot));
+    block-size: var(--xh-badge-dot-size, var(--xh-_badge-dot));
     padding: 0;
     font-size: 0;
   }
 
-  /* —— 变体 —— */
-  /* 形态只决定颜色怎么用；用哪族颜色由 data-tone 决定，没写 tone 就沿用原来的品牌/中性配色 */
-  [data-scope='badge'][data-part='root'][data-variant='solid'] {
-    background: var(--xh-_tone, var(--xh-bg-brand));
-    color: var(--xh-_tone-on, var(--xh-fg-on-brand));
+  /* —— 落点 —— */
+  /* 用 inset 的逻辑属性写，rtl 下 end 自动落到左边；translate 让角标压住宿主的角 */
+  [data-scope='badge'][data-part='indicator'][data-placement='top-end'] {
+    inset-block-start: 0;
+    inset-inline-end: 0;
+    translate: 50% -50%;
+  }
+
+  [data-scope='badge'][data-part='indicator'][data-placement='top-start'] {
+    inset-block-start: 0;
+    inset-inline-start: 0;
+    translate: -50% -50%;
   }
 
-  [data-scope='badge'][data-part='root'][data-variant='subtle'] {
-    background: var(--xh-_tone-subtle, var(--xh-bg-subtle));
-    color: var(--xh-_tone-fg, var(--xh-fg-default));
+  [data-scope='badge'][data-part='indicator'][data-placement='bottom-end'] {
+    inset-block-end: 0;
+    inset-inline-end: 0;
+    translate: 50% 50%;
   }
 
-  [data-scope='badge'][data-part='root'][data-variant='outline'] {
-    border-color: var(--xh-_tone-border, var(--xh-border-default));
-    background: transparent;
-    color: var(--xh-_tone-fg, var(--xh-fg-default));
+  [data-scope='badge'][data-part='indicator'][data-placement='bottom-start'] {
+    inset-block-end: 0;
+    inset-inline-start: 0;
+    translate: -50% 50%;
+  }
+
+  /* rtl 下 translate 的行内轴要跟着翻，否则角标会往宿主外面跑 */
+  [dir='rtl'] [data-scope='badge'][data-part='indicator'][data-placement='top-end'] {
+    translate: -50% -50%;
+  }
+
+  [dir='rtl'] [data-scope='badge'][data-part='indicator'][data-placement='top-start'] {
+    translate: 50% -50%;
+  }
+
+  [dir='rtl'] [data-scope='badge'][data-part='indicator'][data-placement='bottom-end'] {
+    translate: -50% 50%;
+  }
+
+  [dir='rtl'] [data-scope='badge'][data-part='indicator'][data-placement='bottom-start'] {
+    translate: 50% 50%;
   }
 
   /* —— 尺寸 —— */
-  /* 徽标是随文排的药丸，不占控件行高，档位走间距与字号而不是 control-h */
-  [data-scope='badge'][data-part='root'][data-size='sm'] {
-    gap: var(--xh-space-0_5);
-    padding-inline: var(--xh-space-1_5);
-    padding-block: var(--xh-space-0);
-  }
-
-  [data-scope='badge'][data-part='root'][data-size='lg'] {
-    gap: var(--xh-space-1_5);
-    padding-inline: var(--xh-space-3);
-    padding-block: var(--xh-space-1);
-    font-size: var(--xh-text-secondary-size);
+  [data-scope='badge'][data-part='indicator'][data-size='sm'] {
+    --xh-_badge-dot: var(--xh-space-1_5);
+    --xh-_badge-min: var(--xh-space-4);
+    --xh-_badge-px: var(--xh-space-0_5);
+    --xh-_badge-font: var(--xh-text-caption-size);
+  }
+
+  [data-scope='badge'][data-part='indicator'][data-size='lg'] {
+    --xh-_badge-dot: var(--xh-space-2_5);
+    --xh-_badge-min: var(--xh-space-6);
+    --xh-_badge-px: var(--xh-space-1_5);
+    --xh-_badge-font: var(--xh-text-body-size);
   }
 }

package/css/breadcrumb.css

@@ -11,7 +11,7 @@
     --xh-icon-size: var(--xh-breadcrumb-icon-size, var(--xh-glyph-size-text));
 
     /* 尺寸档只换这两个私有槽，列表与链接都从 root 继承它们，换档不必给每个部件各写一条选择器 */
-    --xh-_breadcrumb-font-size: var(--xh-text-label-size);
+    --xh-_breadcrumb-font-size: var(--xh-control-font-md);
     --xh-_breadcrumb-gap: var(--xh-space-2);
     /* 当前项与链接悬停的强调色随语气走。没写 data-tone 时 --xh-_tone-fg 没被声明，
        退回原来的前景色。聚焦环不在其列，它恒是 --xh-ring-focus */

package/css/button-group.css

@@ -8,6 +8,10 @@
      排布只能读 data-orientation——role=group 不收 aria-orientation，连接层根本不输出它。
      圆角槽位在容器上先收成 0，组内每段都取得到，两端的圆角再逐段补回来 */
   [data-scope='button-group'][data-part='root'] {
+    /* 组件内那几档层号只在自己人之间排序：建一个层叠上下文把它们关起来，
+       既不让页面上的层号插进来，也不让它们漏出去压住别人 */
+    isolation: isolate;
+
     --xh-button-radius: 0;
 
     display: inline-flex;

package/css/button.css

@@ -141,4 +141,10 @@
   :where([data-motion='reduce']) [data-scope='button'][data-part='indicator'] {
     animation: none;
   }
+
+  /* 声明过任何 display 就盖掉了 UA 的 [hidden]{display:none}，收起态得自己还回去。
+     写在文件末尾：兜底必须排在该部件所有 display 声明之后 */
+  [data-scope='button'][data-part='root'][hidden] {
+    display: none;
+  }
 }

package/css/calendar.css

@@ -98,33 +98,33 @@
     transition: background var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
   }
 
-  [data-scope='calendar'][data-part='prev-year-trigger'],
+  [data-scope='calendar'][data-part='prev-year-trigger'][hidden],
   [data-scope='calendar'][data-part='prev-trigger'][hidden],
-  [data-scope='calendar'][data-part='next-year-trigger'],
+  [data-scope='calendar'][data-part='next-year-trigger'][hidden],
   [data-scope='calendar'][data-part='next-trigger'][hidden] {
     display: none;
   }
 
-  [data-scope='calendar'][data-part='prev-year-trigger'],
+  [data-scope='calendar'][data-part='prev-year-trigger']:hover:not(:disabled),
   [data-scope='calendar'][data-part='prev-trigger']:hover:not(:disabled),
-  [data-scope='calendar'][data-part='next-year-trigger'],
+  [data-scope='calendar'][data-part='next-year-trigger']:hover:not(:disabled),
   [data-scope='calendar'][data-part='next-trigger']:hover:not(:disabled) {
     background: var(--xh-calendar-nav-bg-hover, var(--xh-bg-subtle-hover));
     color: var(--xh-fg-default);
   }
 
   /* 翻月是单体控件，禁用走原生 :disabled（连接层输出的正是原生 disabled） */
-  [data-scope='calendar'][data-part='prev-year-trigger'],
+  [data-scope='calendar'][data-part='prev-year-trigger']:disabled,
   [data-scope='calendar'][data-part='prev-trigger']:disabled,
-  [data-scope='calendar'][data-part='next-year-trigger'],
+  [data-scope='calendar'][data-part='next-year-trigger']:disabled,
   [data-scope='calendar'][data-part='next-trigger']:disabled {
     color: var(--xh-fg-disabled);
     cursor: not-allowed;
   }
 
-  [data-scope='calendar'][data-part='prev-year-trigger'],
+  [data-scope='calendar'][data-part='prev-year-trigger']:focus-visible,
   [data-scope='calendar'][data-part='prev-trigger']:focus-visible,
-  [data-scope='calendar'][data-part='next-year-trigger'],
+  [data-scope='calendar'][data-part='next-year-trigger']:focus-visible,
   [data-scope='calendar'][data-part='next-trigger']:focus-visible {
     outline: var(--xh-ring-width) solid var(--xh-ring-focus);
     outline-offset: var(--xh-ring-offset);
@@ -224,9 +224,10 @@
     display: none;
   }
 
-  /* 格子是区间底色的画布：连续背景铺在这一层，圆角的选中片留给 trigger。
+  /* 格子是区间底色的画布：底色由格子的 ::before 铺出来，圆角的选中片留给 trigger。
      铺在 trigger 上会被格间空隙切断，区间看起来就是一串断开的圆点 */
   [data-scope='calendar'][data-part='cell'] {
+    position: relative;
     display: flex;
     align-items: center;
     justify-content: center;
@@ -237,22 +238,46 @@
     display: none;
   }
 
-  [data-scope='calendar'][data-part='cell'][data-in-range] {
+  /* 区间底色：横向铺满格子，相邻两格接成一条；纵向收在格子内衬里，行与行之间留出空当 */
+  [data-scope='calendar'][data-part='cell'][data-in-range]::before {
+    content: '';
+    position: absolute;
+    inset-block: var(--xh-calendar-cell-gap, var(--xh-space-0_5));
+    inset-inline: 0;
     background: var(--xh-calendar-range-bg, var(--xh-bg-brand-subtle));
   }
 
-  /* 区间两端各自收圆：中间那些格子保持直角，底色才连成一条 */
-  [data-scope='calendar'][data-part='cell'][data-range-start] {
+  /* 两端那一格只铺半格，另外半格由选中片占满：区间收在圆点上而不是收在格子边上。
+     起止落在同一格时两条一起生效，底色宽度归零，只剩那枚圆点 */
+  [data-scope='calendar'][data-part='cell'][data-in-range][data-range-start]::before {
+    inset-inline-start: 50%;
+  }
+
+  [data-scope='calendar'][data-part='cell'][data-in-range][data-range-end]::before {
+    inset-inline-end: 50%;
+  }
+
+  /* 行首与行尾收圆：区间跨周时每一行各是一条两头圆的横杠。
+     摆了周序号格的行里，行首那一格排在它后面 */
+  [data-scope='calendar'][data-part='week-row'] > [data-part='cell'][data-in-range]:first-child::before,
+  [data-scope='calendar'][data-part='week-row'] > [data-part='week-number'] + [data-part='cell'][data-in-range]::before {
     border-start-start-radius: var(--xh-calendar-cell-radius, var(--xh-shape-pill));
     border-end-start-radius: var(--xh-calendar-cell-radius, var(--xh-shape-pill));
   }
 
-  [data-scope='calendar'][data-part='cell'][data-range-end] {
+  [data-scope='calendar'][data-part='week-row'] > [data-part='cell'][data-in-range]:last-child::before {
     border-start-end-radius: var(--xh-calendar-cell-radius, var(--xh-shape-pill));
     border-end-end-radius: var(--xh-calendar-cell-radius, var(--xh-shape-pill));
   }
 
+  /* 粗粒度的格子之间有间隙，底色本就接不成一条，每一格各自收圆 */
+  [data-scope='calendar'][data-part='grid']:is([data-view='month'], [data-view='quarter'], [data-view='year']) > [data-part='cell'][data-in-range]::before {
+    border-radius: var(--xh-calendar-cell-radius, var(--xh-shape-pill));
+  }
+
   [data-scope='calendar'][data-part='cell-trigger'] {
+    /* 区间底色是格子上绝对定位的伪元素，选中片得定位才排在它之后 */
+    position: relative;
     display: flex;
     flex: 1;
     align-items: center;
@@ -297,6 +322,7 @@
     font-weight: var(--xh-font-weight-medium);
   }
 
+
   /* 不可用走 aria-disabled 而非原生 disabled：格子仍要可聚焦（它还得当方向键的起点），
      所以只能靠 data-disabled 表达，写 :disabled 永远不命中 */
   [data-scope='calendar'][data-part='cell-trigger'][data-disabled] {

package/css/card.css

@@ -67,10 +67,10 @@
   [data-scope='card'][data-part='header'] {
     display: flex;
     flex-direction: column;
-    gap: var(--xh-space-1);
+    gap: var(--xh-card-header-gap, var(--xh-space-1));
     padding: var(--xh-_card-pad);
     /* 头下面若还有别的段，间距由那一段自己的内边距接上，这里不重复留白 */
-    padding-block-end: var(--xh-space-2);
+    padding-block-end: var(--xh-card-header-pb, var(--xh-space-2));
   }
 
   [data-scope='card'][data-part='title'] {
@@ -96,26 +96,35 @@
 
   /* 头与身相邻时，头已经收窄了下边距，身不必再从顶上留一份 */
   [data-scope='card'][data-part='header'] + [data-part='body'] {
-    padding-block-start: var(--xh-space-2);
+    padding-block-start: var(--xh-card-body-pt, var(--xh-space-2));
   }
 
   [data-scope='card'][data-part='footer'] {
     display: flex;
     align-items: center;
-    gap: var(--xh-space-2);
+    gap: var(--xh-card-footer-gap, var(--xh-space-2));
     padding: var(--xh-_card-pad);
-    padding-block-start: var(--xh-space-2);
+    padding-block-start: var(--xh-card-footer-pt, var(--xh-space-2));
   }
 
   /* —— 分段 —— */
   /* 分隔线画在下一段的上边，段与段之间才只有一条 */
   [data-scope='card'][data-part='root'][data-segmented] [data-part='body'],
   [data-scope='card'][data-part='root'][data-segmented] [data-part='footer'] {
-    border-block-start: var(--xh-stroke-thin) solid var(--xh-card-border, var(--xh-border-subtle));
+    border-block-start: var(--xh-stroke-thin) solid var(--xh-card-divider, var(--xh-border-subtle));
     padding-block-start: var(--xh-_card-pad);
   }
 
   [data-scope='card'][data-part='root'][data-segmented] [data-part='header'] {
     padding-block-end: var(--xh-_card-pad);
   }
+
+  /* 声明过任何 display 就盖掉了 UA 的 [hidden]{display:none}，收起态得自己还回去。
+     写在文件末尾：兜底必须排在该部件所有 display 声明之后 */
+  [data-scope='card'][data-part='root'][hidden],
+  [data-scope='card'][data-part='cover'][hidden],
+  [data-scope='card'][data-part='header'][hidden],
+  [data-scope='card'][data-part='footer'][hidden] {
+    display: none;
+  }
 }

package/css/cascader.css

@@ -6,6 +6,9 @@
 
   /* 坐标由定位引擎写进 style（inset-inline-start / inset-block-start），这里只定位模式与层级 */
   [data-scope='cascader'][data-part='positioner'] {
+    /* 列区的自绘条浮在内容之上：轨道不上底色，实色轨道会在列区下缘糊出一条灰带 */
+    --xh-scrollbar-track-bg: transparent;
+
     position: fixed;
     z-index: var(--xh-cascader-layer, var(--xh-layer-popover));
     /* 空壳不吃指针，交互只发生在 content 里 */
@@ -25,9 +28,11 @@
     /* 尺寸档只换这几个私有槽，盒与列里的条目都从这两处继承它们，换档不必给每个部件各写一条选择器 */
     --xh-_cascader-h: var(--xh-control-h-md);
     --xh-_cascader-px: var(--xh-control-px-md);
+    --xh-_cascader-row-py: var(--xh-list-option-py-md);
+    --xh-_cascader-row-px: var(--xh-control-px-md);
     --xh-_cascader-gap: var(--xh-control-gap-md);
-    --xh-_cascader-font-size: var(--xh-text-body-size);
-    --xh-_cascader-label-font-size: var(--xh-text-label-size);
+    --xh-_cascader-font-size: var(--xh-control-font-md);
+    --xh-_cascader-label-font-size: var(--xh-control-font-md);
 
     /* 形态档只换触发框的描边与底色这三个槽，浮层与列不跟着变：
        变的是「这是个输入位」的表达方式，不是弹出内容的表达方式 */
@@ -86,6 +91,8 @@
     --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-row-py: var(--xh-list-option-py-sm);
+    --xh-_cascader-row-px: var(--xh-control-px-sm);
     --xh-_cascader-gap: var(--xh-control-gap-sm);
     --xh-_cascader-font-size: var(--xh-control-font-sm);
     --xh-_cascader-label-font-size: var(--xh-control-font-sm);
@@ -95,6 +102,8 @@
     --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-row-py: var(--xh-list-option-py-lg);
+    --xh-_cascader-row-px: var(--xh-control-px-lg);
     --xh-_cascader-gap: var(--xh-control-gap-lg);
     --xh-_cascader-font-size: var(--xh-control-font-lg);
     --xh-_cascader-label-font-size: var(--xh-control-font-lg);
@@ -334,6 +343,7 @@
     display: flex;
     flex: none;
     flex-direction: column;
+    gap: var(--xh-cascader-column-gap, var(--xh-list-option-gap));
     min-inline-size: var(--xh-cascader-column-min-w, 7rem);
     block-size: var(--xh-cascader-column-h, var(--xh-viewport-h-sm));
     padding-block: var(--xh-cascader-column-py, var(--xh-space-1));
@@ -369,8 +379,8 @@
     align-items: center;
     gap: var(--xh-cascader-row-gap, var(--xh-_cascader-gap));
     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));
+    padding-block: var(--xh-cascader-row-py, var(--xh-_cascader-row-py));
+    padding-inline: var(--xh-cascader-row-px, var(--xh-_cascader-row-px));
     border-radius: var(--xh-cascader-row-radius, var(--xh-shape-control));
     color: var(--xh-cascader-row-fg, var(--xh-fg-default));
     font-size: var(--xh-cascader-row-font-size, var(--xh-_cascader-font-size));
@@ -423,22 +433,17 @@
     cursor: not-allowed;
   }
 
-  /* 分支条目行尾画右向小箭头：不点开也看得出还有下一级。
-     全边框描好后抹掉块末与行首两边，剩下的直角旋成箭头；位置由 item-text 的 flex:1 顶到行尾 */
+  /* 分支条目行尾画右向小箭头：不点开也看得出还有下一级。位置由 item-text 的 flex:1 顶到行尾。
+     与菜单族的子菜单箭头同走字形令牌——此前这里是「描全边框再抹掉两条、把剩下的直角旋 45 度」，
+     作者换掉标记时换不动它，RTL 还得再翻一次旋转角 */
   [data-scope='cascader'][data-part='item'][data-branch]::after {
     content: '';
     flex: none;
-    inline-size: var(--xh-cascader-branch-arrow-size, var(--xh-space-1_5));
-    block-size: var(--xh-cascader-branch-arrow-size, var(--xh-space-1_5));
-    border: var(--xh-glyph-stroke-light) solid var(--xh-cascader-branch-arrow-fg, var(--xh-fg-subtle));
-    border-block-end: 0;
-    border-inline-start: 0;
-    rotate: 45deg;
-  }
-
-  /* rtl 下剩下的是块首与行末（物理左上）两边，反向旋 45 度才指向行进方向 */
-  [dir='rtl'] [data-scope='cascader'][data-part='item'][data-branch]::after {
-    rotate: -45deg;
+    inline-size: var(--xh-cascader-branch-arrow-size, var(--xh-icon-size, var(--xh-glyph-size-text)));
+    block-size: var(--xh-cascader-branch-arrow-size, var(--xh-icon-size, var(--xh-glyph-size-text)));
+    background-color: var(--xh-cascader-branch-arrow-fg, var(--xh-fg-subtle));
+    -webkit-mask: var(--xh-glyph-mark-chevron-right) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-chevron-right) center / contain no-repeat;
   }
 
   [data-scope='cascader'][data-part='item'][data-branch][data-disabled]::after {
@@ -460,7 +465,7 @@
     align-items: center;
     justify-content: center;
     inline-size: var(--xh-cascader-item-indicator-size, var(--xh-control-indicator-size));
-    color: var(--xh-cascader-item-indicator-fg, var(--xh-_tone, var(--xh-bg-brand)));
+    color: var(--xh-cascader-item-indicator-fg, var(--xh-_tone, var(--xh-fg-brand)));
     visibility: hidden;
   }
 
@@ -486,11 +491,11 @@
 
   /* 级联勾选的半选态只在皮肤自绘（:empty）时露面画横杠：
      作者塞了自己的选中图形时，半选放出来会顶着一个语义相反的勾，表达交还作者 */
-  [data-scope='cascader'][data-part='item-indicator'][data-indeterminate]:empty {
+  [data-scope='cascader'][data-part='item-indicator'][data-state='indeterminate']:empty {
     visibility: visible;
   }
 
-  [data-scope='cascader'][data-part='item-indicator'][data-indeterminate]:not([data-state='checked']):empty::before {
+  [data-scope='cascader'][data-part='item-indicator'][data-state='indeterminate']:empty::before {
     content: '';
     display: inline-block;
     inline-size: var(--xh-icon-size, var(--xh-glyph-size-text));
@@ -517,7 +522,7 @@
     padding-block: var(--xh-cascader-input-py, var(--xh-space-2));
     padding-inline: var(--xh-cascader-input-px, var(--xh-control-px-md));
     border: none;
-    border-block-end: var(--xh-stroke-thin) solid var(--xh-cascader-content-border, var(--xh-border-default));
+    border-block-end: var(--xh-stroke-thin) solid var(--xh-cascader-search-divider, var(--xh-border-subtle));
     border-start-start-radius: inherit;
     border-start-end-radius: inherit;
     background: none;
@@ -540,6 +545,7 @@
     display: flex;
     flex-basis: 100%;
     flex-direction: column;
+    gap: var(--xh-cascader-search-list-gap, var(--xh-list-option-gap));
     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;
@@ -561,8 +567,8 @@
 
   /* 候选与列内条目同一套行度量，虚拟高亮与悬停同用轻档 */
   [data-scope='cascader'][data-part='search-item'] {
-    padding-block: var(--xh-cascader-row-py, var(--xh-space-1_5));
-    padding-inline: var(--xh-cascader-row-px, var(--xh-control-px-md));
+    padding-block: var(--xh-cascader-row-py, var(--xh-_cascader-row-py));
+    padding-inline: var(--xh-cascader-row-px, var(--xh-_cascader-row-px));
     overflow: hidden;
     border-radius: var(--xh-cascader-row-radius, var(--xh-shape-control));
     color: var(--xh-cascader-row-fg, var(--xh-fg-default));