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

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;
@@ -30,26 +34,27 @@
 
   /* —— 尺寸 —— */
   /* 高度、内边距、间距、字号在容器上写一次，沿继承流给组内每一段。
-     三档都写出来：自定义属性会一路继承，组里再套一组时内层不写就会沿用外层的档 */
+     三档都写出来：自定义属性会一路继承，组里再套一组时内层不写就会沿用外层的档。
+     写私有槽而非 --xh-button-*：后者是使用者的入口，组内某一枚自己写了档位时要压得住容器 */
   [data-scope='button-group'][data-part='root'][data-size='sm'] {
-    --xh-button-h: var(--xh-control-h-sm);
-    --xh-button-px: var(--xh-control-px-sm);
-    --xh-button-gap: var(--xh-control-gap-sm);
-    --xh-button-font-size: var(--xh-font-size-sm);
+    --xh-_button-group-h: var(--xh-control-h-sm);
+    --xh-_button-group-px: var(--xh-control-px-sm);
+    --xh-_button-group-gap: var(--xh-control-gap-sm);
+    --xh-_button-group-font-size: var(--xh-control-font-sm);
   }
 
   [data-scope='button-group'][data-part='root'][data-size='md'] {
-    --xh-button-h: var(--xh-control-h-md);
-    --xh-button-px: var(--xh-control-px-md);
-    --xh-button-gap: var(--xh-control-gap-md);
-    --xh-button-font-size: var(--xh-font-size-md);
+    --xh-_button-group-h: var(--xh-control-h-md);
+    --xh-_button-group-px: var(--xh-control-px-md);
+    --xh-_button-group-gap: var(--xh-control-gap-md);
+    --xh-_button-group-font-size: var(--xh-control-font-md);
   }
 
   [data-scope='button-group'][data-part='root'][data-size='lg'] {
-    --xh-button-h: var(--xh-control-h-lg);
-    --xh-button-px: var(--xh-control-px-lg);
-    --xh-button-gap: var(--xh-control-gap-lg);
-    --xh-button-font-size: var(--xh-font-size-lg);
+    --xh-_button-group-h: var(--xh-control-h-lg);
+    --xh-_button-group-px: var(--xh-control-px-lg);
+    --xh-_button-group-gap: var(--xh-control-gap-lg);
+    --xh-_button-group-font-size: var(--xh-control-font-lg);
   }
 
   /* —— 形态 —— */

package/css/button.css

@@ -21,17 +21,21 @@
     --xh-_bg-active: var(--xh-button-bg-active, var(--xh-bg-subtle-active));
     --xh-_fg: var(--xh-button-fg, var(--xh-fg-default));
 
+    /* 作者塞进来的图标跟着按钮的尺寸档走：xh-icon 的直径读的就是这个继承槽，
+       它自己显式写了 size 时特异性更高，仍以作者写的为准 */
+    --xh-icon-size: var(--xh-button-icon-size, var(--xh-glyph-size-md));
+
     display: inline-flex;
     align-items: center;
     justify-content: center;
-    gap: var(--xh-button-gap, var(--xh-control-gap-md));
-    block-size: var(--xh-button-h, var(--xh-control-h-md));
-    padding-inline: var(--xh-button-px, var(--xh-control-px-md));
+    gap: var(--xh-button-gap, var(--xh-_button-group-gap, var(--xh-control-gap-md)));
+    block-size: var(--xh-button-h, var(--xh-_button-group-h, var(--xh-control-h-md)));
+    padding-inline: var(--xh-button-px, var(--xh-_button-group-px, var(--xh-control-px-md)));
     border: var(--xh-stroke-thin) solid transparent;
     border-radius: var(--xh-button-radius, var(--xh-shape-control));
     background: var(--xh-_bg);
     color: var(--xh-_fg);
-    font-size: var(--xh-button-font-size, var(--xh-text-label-size));
+    font-size: var(--xh-button-font-size, var(--xh-_button-group-font-size, var(--xh-text-label-size)));
     font-weight: var(--xh-button-font-weight, var(--xh-text-label-weight));
     line-height: var(--xh-leading-none);
     white-space: nowrap;
@@ -95,19 +99,52 @@
 
   /* —— 尺寸 —— */
   [data-scope='button'][data-part='root'][data-size='sm'] {
-    block-size: var(--xh-control-h-sm);
-    padding-inline: var(--xh-control-px-sm);
-    font-size: var(--xh-font-size-sm);
+    --xh-icon-size: var(--xh-button-icon-size, var(--xh-glyph-size-sm));
+
+    block-size: var(--xh-button-h, var(--xh-control-h-sm));
+    padding-inline: var(--xh-button-px, var(--xh-control-px-sm));
+    font-size: var(--xh-button-font-size, var(--xh-control-font-sm));
   }
 
   [data-scope='button'][data-part='root'][data-size='lg'] {
-    block-size: var(--xh-control-h-lg);
-    padding-inline: var(--xh-control-px-lg);
-    font-size: var(--xh-font-size-lg);
+    --xh-icon-size: var(--xh-button-icon-size, var(--xh-glyph-size-lg));
+
+    block-size: var(--xh-button-h, var(--xh-control-h-lg));
+    padding-inline: var(--xh-button-px, var(--xh-control-px-lg));
+    font-size: var(--xh-button-font-size, var(--xh-control-font-lg));
+  }
+
+  /* 只有图标：左右内距清零，宽度靠比例跟住当前档的高度——换尺寸档时仍是正方形，
+     不必把档位抄进行内样式。写在尺寸档之后，压得住三档各自的 padding-inline */
+  [data-scope='button'][data-part='root'][data-icon-only] {
+    padding-inline: 0;
+    aspect-ratio: 1;
+  }
+
+  [data-scope='button'][data-part='root'][data-full-width] {
+    inline-size: 100%;
   }
 
   [data-scope='button'][data-part='indicator'] {
     display: inline-flex;
-    animation: xh-spin 0.6s linear infinite;
+    animation: xh-spin var(--xh-button-spin-duration, var(--xh-spin-duration)) linear infinite;
+  }
+
+  /* 减少动效：指示器停转，"还在忙"由按钮自身的挂起样式与指示器图标继续表达。
+     两条规则是同一件事的两个触发条件：系统偏好与作者打的 data-motion */
+  @media (prefers-reduced-motion: reduce) {
+    [data-scope='button'][data-part='indicator'] {
+      animation: none;
+    }
+  }
+
+  :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

@@ -5,6 +5,9 @@
   }
 
   [data-scope='calendar'][data-part='root'] {
+    /* 作者塞进指示符槽的图标跟着字号走，与皮肤画的兜底字形同一把尺 */
+    --xh-icon-size: var(--xh-calendar-icon-size, var(--xh-glyph-size-text));
+
     display: flex;
     flex-direction: column;
     gap: var(--xh-calendar-gap, var(--xh-space-3));
@@ -37,7 +40,49 @@
     user-select: none;
   }
 
+  /* 标题里的年与月：点它们逐级钻上去（年 → 十年格、月 → 月格）。
+     长得像标题而不像按钮——它本来就是标题，只是可点 */
+  [data-scope='calendar'][data-part='heading-year-trigger']:not([hidden]),
+  [data-scope='calendar'][data-part='heading-month-trigger']:not([hidden]) {
+    display: inline-flex;
+    align-items: center;
+    padding-inline: var(--xh-calendar-heading-trigger-px, var(--xh-space-1));
+    border: var(--xh-stroke-thin) solid transparent;
+    border-radius: var(--xh-calendar-heading-trigger-radius, var(--xh-shape-control));
+    background: transparent;
+    color: var(--xh-calendar-heading-fg, var(--xh-fg-default));
+    font-size: var(--xh-calendar-heading-font-size, var(--xh-text-label-size));
+    font-weight: var(--xh-calendar-heading-font-weight, var(--xh-font-weight-semibold));
+    line-height: var(--xh-leading-none);
+    cursor: pointer;
+    transition: color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+  }
+
+  [data-scope='calendar'][data-part='heading-year-trigger'][hidden],
+  [data-scope='calendar'][data-part='heading-month-trigger'][hidden] {
+    display: none;
+  }
+
+  [data-scope='calendar'][data-part='heading-year-trigger']:hover:not(:disabled),
+  [data-scope='calendar'][data-part='heading-month-trigger']:hover:not(:disabled) {
+    color: var(--xh-calendar-heading-trigger-fg-hover, var(--xh-fg-brand));
+  }
+
+  /* 到顶那一层（年视图的年那一截）只作标题显示：不再是可点的东西，光标也别装成能点 */
+  [data-scope='calendar'][data-part='heading-year-trigger']:disabled,
+  [data-scope='calendar'][data-part='heading-month-trigger']:disabled {
+    cursor: default;
+  }
+
+  [data-scope='calendar'][data-part='heading-year-trigger']:focus-visible,
+  [data-scope='calendar'][data-part='heading-month-trigger']:focus-visible {
+    outline: var(--xh-ring-width) solid var(--xh-ring-focus);
+    outline-offset: var(--xh-ring-offset);
+  }
+
+  [data-scope='calendar'][data-part='prev-year-trigger'],
   [data-scope='calendar'][data-part='prev-trigger'],
+  [data-scope='calendar'][data-part='next-year-trigger'],
   [data-scope='calendar'][data-part='next-trigger'] {
     display: inline-flex;
     flex: none;
@@ -53,25 +98,33 @@
     transition: background var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
   }
 
+  [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'][hidden],
   [data-scope='calendar'][data-part='next-trigger'][hidden] {
     display: none;
   }
 
+  [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']: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']:disabled,
   [data-scope='calendar'][data-part='prev-trigger']:disabled,
+  [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']:focus-visible,
   [data-scope='calendar'][data-part='prev-trigger']:focus-visible,
+  [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);
@@ -83,6 +136,27 @@
     gap: var(--xh-calendar-grid-gap, var(--xh-space-1));
   }
 
+  /* 粗粒度视图：格子直接铺进网格，不再有周行那一层。
+     月 3 列 × 4 行、季度 4 列一行、年 3 列——与常见日期控件同一套排布 */
+  [data-scope='calendar'][data-part='grid'][data-view='month'],
+  [data-scope='calendar'][data-part='grid'][data-view='year'] {
+    display: grid;
+    grid-template-columns: repeat(3, minmax(0, 1fr));
+    gap: var(--xh-calendar-period-gap, var(--xh-space-1));
+  }
+
+  [data-scope='calendar'][data-part='grid'][data-view='quarter'] {
+    display: grid;
+    grid-template-columns: repeat(4, minmax(0, 1fr));
+    gap: var(--xh-calendar-period-gap, var(--xh-space-1));
+  }
+
+  /* 粗粒度的格子比日子宽，文字居中、留出上下气口 */
+  [data-scope='calendar'][data-part='grid']:is([data-view='month'], [data-view='quarter'], [data-view='year']) [data-part='cell-trigger'] {
+    padding-block: var(--xh-calendar-period-py, var(--xh-space-2));
+    inline-size: 100%;
+  }
+
   [data-scope='calendar'][data-part='grid'][hidden] {
     display: none;
   }
@@ -110,6 +184,26 @@
     grid-template-columns: repeat(7, minmax(0, 1fr));
   }
 
+  /* 摆了周序号格的行多让出行首一列。写 :not([hidden]) 而不是靠顺序压过下面那条兜底——
+     同特指度的规则谁在后面谁赢,收起态会被这条 display 掀开 */
+  [data-scope='calendar'][data-part='week-row']:not([hidden]):has(> [data-part='week-number']) {
+    display: grid;
+    grid-template-columns: var(--xh-calendar-week-number-w, 2.25rem) repeat(7, minmax(0, 1fr));
+  }
+
+  /* 周序号只是行的标号:比日子小一号、颜色压下去,不跟着选中态走 */
+  [data-scope='calendar'][data-part='week-number'] {
+    display: grid;
+    place-items: center;
+    color: var(--xh-calendar-week-number-fg, var(--xh-fg-subtle));
+    font-size: var(--xh-calendar-week-number-font-size, var(--xh-text-caption-size));
+    font-variant-numeric: tabular-nums;
+    user-select: none;
+  }
+
+  [data-scope='calendar'][data-part='week-number'][hidden] {
+    display: none;
+  }
   [data-scope='calendar'][data-part='week-row'][hidden] {
     display: none;
   }
@@ -120,7 +214,7 @@
     justify-content: center;
     block-size: var(--xh-calendar-week-day-h, var(--xh-control-h-sm));
     color: var(--xh-calendar-week-day-fg, var(--xh-fg-subtle));
-    font-size: var(--xh-calendar-week-day-font-size, var(--xh-font-size-xs));
+    font-size: var(--xh-calendar-week-day-font-size, var(--xh-text-caption-size));
     font-weight: var(--xh-calendar-week-day-font-weight, var(--xh-font-weight-medium));
     line-height: var(--xh-leading-none);
     user-select: none;
@@ -130,35 +224,60 @@
     display: none;
   }
 
-  /* 格子是区间底色的画布：连续背景铺在这一层，圆角的选中片留给 trigger。
+  /* 格子是区间底色的画布：底色由格子的 ::before 铺出来，圆角的选中片留给 trigger。
      铺在 trigger 上会被格间空隙切断，区间看起来就是一串断开的圆点 */
   [data-scope='calendar'][data-part='cell'] {
+    position: relative;
     display: flex;
     align-items: center;
     justify-content: center;
-    padding: var(--xh-calendar-cell-gap, 2px);
+    padding: var(--xh-calendar-cell-gap, var(--xh-space-0_5));
   }
 
   [data-scope='calendar'][data-part='cell'][hidden] {
     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;
@@ -203,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] {
@@ -221,4 +341,27 @@
     outline: var(--xh-ring-width) solid var(--xh-ring-focus);
     outline-offset: calc(-1 * var(--xh-ring-width));
   }
+
+  /* 没写内容就由皮肤画兜底字形；作者往部件里塞了自己的图形，这几条即不命中 */
+  [data-scope='calendar'][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='calendar'][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/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));
     }
   }
 
@@ -67,25 +67,25 @@
   [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'] {
-    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);
   }
 
@@ -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/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;
+  }
 }