@xihan-ui/styles 2.1.0 → 3.1.0

package/css/number-field.css

@@ -227,4 +227,26 @@
   [data-scope='number-field'][data-part='control'][hidden] {
     display: none;
   }
+
+  @media (forced-colors: active) {
+    /* 兜底字形是 mask 挖出来的一块底色，这一档里底色被系统换成 Canvas，字形跟着消失。
+       字形退出强制换色、直接写系统色（不能取 currentColor：退出强制换色的伪元素读到的是被系统换掉之前的作者色）：
+       按钮面上取 ButtonText，悬停与按下时家族把按钮涂成 Highlight、字形换 HighlightText；
+       禁用取 GrayText */
+    [data-scope='number-field'][data-part='control'] [data-part='increment-trigger']:empty::before,
+    [data-scope='number-field'][data-part='control'] [data-part='decrement-trigger']:empty::before {
+      forced-color-adjust: none;
+      background-color: ButtonText;
+    }
+
+    [data-scope='number-field'][data-part='control'] [data-part='increment-trigger']:not([data-disabled]):not([data-loading]):is(:hover, :active, [data-pressed]):empty::before,
+    [data-scope='number-field'][data-part='control'] [data-part='decrement-trigger']:not([data-disabled]):not([data-loading]):is(:hover, :active, [data-pressed]):empty::before {
+      background-color: HighlightText;
+    }
+
+    [data-scope='number-field'][data-part='control'] [data-part='increment-trigger'][data-disabled]:empty::before,
+    [data-scope='number-field'][data-part='control'] [data-part='decrement-trigger'][data-disabled]:empty::before {
+      background-color: GrayText;
+    }
+  }
 }

package/css/page-header.css

@@ -153,7 +153,9 @@
     grid-row: span 2;
   }
 
-  @media (max-width: 640px) {
+  /* 窄于 sm 断点时标题区占满第二列、操作区换到下一行。写成 min-width 的补集：640px 本身归宽档，
+     与其余皮肤在同一宽度切换 */
+  @media not all and (min-width: 640px) {
     [data-scope='page-header'][data-part='root'] {
       grid-template-columns: auto minmax(0, 1fr);
     }

package/css/pagination.css

@@ -8,6 +8,7 @@
 /* 共享关键帧由 family/motion.css 提供，本皮肤 @import 它，单独引入仍成立；四类格子接 Action Control 配方，同理 */
 @import '../family/motion.css';
 @import '../family/action-control.css';
+@import '../family/field-chrome.css';
 
 @layer xihan.components {
   /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
@@ -69,12 +70,14 @@
     display: none;
   }
 
-  /* 四类格子接 Action Control 的 text 档，缺省中性的 ghost 形态（只有 Button 品牌实心）：盒型、三档几何、
+  /* 各类格子接 Action Control 的 text 档，缺省中性的 ghost 形态（只有 Button 品牌实心）：盒型、三档几何、
      透明描边（省略号也占一条，两者内容盒等高，一行里对得齐）、悬停 100 → 按下 200（画布承载）、禁用面、按压缩放与
      过渡都由家族给；这里只把使用者槽映射到桥接槽并保留分页自己的排版。
      等宽的关键：1 与 10 的内容宽度不同，靠最小宽度把它们撑到同一格，行宽才不会随当前页左右抖动 */
+  [data-scope='pagination'][data-part='first-trigger'],
   [data-scope='pagination'][data-part='prev-trigger'],
   [data-scope='pagination'][data-part='next-trigger'],
+  [data-scope='pagination'][data-part='last-trigger'],
   [data-scope='pagination'][data-part='item'],
   [data-scope='pagination'][data-part='ellipsis-trigger'] {
     --xh-action-min-inline-size: var(--xh-pagination-item-min-size, var(--xh-_pagination-item-size));
@@ -88,7 +91,7 @@
     --xh-action-fg-rest: var(--xh-pagination-item-fg, var(--xh-_action-variant-fg-rest));
     --xh-action-fg-hover: var(--xh-pagination-item-fg, var(--xh-_action-variant-fg-hover));
     --xh-action-fg-pressed: var(--xh-pagination-item-fg, var(--xh-_action-variant-fg-pressed));
-    /* 作者塞进上一页/下一页的图标按档取字形尺，与皮肤画的兜底字形同一把尺 */
+    /* 作者塞进翻页钮的图标按档取字形尺，与皮肤画的兜底字形同一把尺 */
     --xh-icon-size: var(--xh-pagination-icon-size, var(--xh-_action-profile-glyph-size));
 
     flex: none;
@@ -97,15 +100,17 @@
     font-variant-numeric: tabular-nums;
   }
 
+  [data-scope='pagination'][data-part='first-trigger'][hidden],
   [data-scope='pagination'][data-part='prev-trigger'][hidden],
   [data-scope='pagination'][data-part='next-trigger'][hidden],
+  [data-scope='pagination'][data-part='last-trigger'][hidden],
   [data-scope='pagination'][data-part='item'][hidden],
   [data-scope='pagination'][data-part='ellipsis-trigger'][hidden] {
     display: none;
   }
 
-  /* 首末页的上一页 / 下一页是原生 disabled（不可聚焦、进不了 Tab 序列），连接层同时给 data-disabled，
-     家族按 data-disabled 画禁用面（透明底 + --xh-fg-disabled）；分页条目从不禁用 */
+  /* 到头那一侧的翻页钮是原生 disabled（不可聚焦、进不了 Tab 序列），连接层同时给 data-disabled，
+     家族按 data-disabled 画禁用面（透明底 + --xh-fg-disabled）；整组 disabled 时页码与省略位同样如此 */
 
   /* 当前页（格状当前）：data-current 与 aria-current='page' 由连接层成对给出，样式挂在 data 钩子上，
      无障碍语义留给 aria。实心品牌面 + 配对前景、不加粗——字重一变字形就变宽，页码格子会跟着长一点，
@@ -135,6 +140,12 @@
     --xh-action-ring-color-focus-visible: currentColor;
   }
 
+  /* 整组禁用时当前页不跟着透明：实心品牌面退成淡底、字取禁用色，格子仍标得出位置，又一眼看得出按不动 */
+  [data-scope='pagination'][data-part='item'][data-current][data-disabled] {
+    --xh-action-bg-disabled: var(--xh-bg-subtle);
+    --xh-action-border-disabled: var(--xh-bg-subtle);
+  }
+
   /* 省略位是可展开的按钮：折进去的那几页只有它一个入口，指针与键盘都得点得到，
      所以它与页码同一副骨架、同一条阶梯。这里只把字色压淡一档与页码区分开，三态都压——
      家族的悬停 / 按下规则比基础块特定，只映射静息那一支会在悬停时被换回缺省字色 */
@@ -144,8 +155,13 @@
     --xh-action-fg-pressed: var(--xh-pagination-ellipsis-trigger-fg, var(--xh-fg-subtle));
   }
   /* 每页条数控制器的挂载点：里头装的是库里的 select，控件本身的描边、底色、聚焦环与
-     浮层都归 select 那份皮肤，这一格只把它摆进分页行 */
+     浮层都归 select 那份皮肤，这一格只把它摆进分页行。
+     在分页行里按内容定宽：选项是「10 条 / 页」一类短串，字段缺省宽在这一行里过宽；
+     地板一并放开，盒子刚好装下回显与箭头 */
   [data-scope='pagination'][data-part='page-size-select'] {
+    --xh-select-control-w: var(--xh-pagination-page-size-select-w, max-content);
+    --xh-select-control-min-w: 0px;
+
     display: inline-flex;
     flex: none;
     align-items: center;
@@ -171,35 +187,47 @@
     display: none;
   }
 
-  /* 跳页输入框：与每页条数控制器同一副外观，宽度按页码位数留够 */
+  /* 跳页输入框自身就是字段外壳（连接层投影 data-xh-field-chrome）：静息描边、悬停升控件悬停边、
+     聚焦换聚焦边加环、禁用面都由字段家族给，这里只把使用者槽映到家族桥接槽，
+     高度、内衬与圆角跟页码格子同一把尺，宽度按页码位数留够 */
   [data-scope='pagination'][data-part='jumper'] {
+    --xh-field-control-height: var(--xh-pagination-item-h, var(--xh-_pagination-item-size));
+    --xh-field-control-padding-inline: var(--xh-pagination-item-px, var(--xh-_pagination-item-px));
+    --xh-field-control-min-inline-size: 0;
+    --xh-field-control-radius: var(--xh-pagination-item-radius, var(--xh-shape-control));
+    --xh-field-bg-rest: var(--xh-pagination-jumper-bg, var(--xh-_field-variant-bg-rest));
+    --xh-field-bg-hover: var(--xh-pagination-jumper-bg-hover, var(--xh-_field-variant-bg-hover));
+    --xh-field-bg-disabled: var(--xh-pagination-jumper-bg-disabled, var(--xh-_field-variant-bg-disabled));
+    --xh-field-fg-rest: var(--xh-pagination-item-fg, var(--xh-fg-default));
+    --xh-field-border-rest: var(--xh-pagination-jumper-border, var(--xh-_field-variant-border-rest));
+    --xh-field-border-hover: var(--xh-pagination-jumper-border-hover, var(--xh-_field-variant-border-hover));
+    --xh-field-border-focus: var(--xh-pagination-jumper-border-focus, var(--xh-_field-variant-border-focus));
+    --xh-field-border-invalid: var(--xh-pagination-jumper-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: none;
+
     flex: none;
     inline-size: var(--xh-pagination-jumper-w, calc(var(--xh-space-8) * 2));
-    block-size: var(--xh-pagination-item-h, var(--xh-_pagination-item-size));
-    padding-inline: var(--xh-pagination-item-px, var(--xh-_pagination-item-px));
-    border: var(--xh-stroke-thin) solid var(--xh-pagination-jumper-border, var(--xh-border-default));
-    border-radius: var(--xh-pagination-item-radius, var(--xh-shape-control));
-    background: var(--xh-pagination-jumper-bg, var(--xh-bg-surface));
-    color: var(--xh-pagination-item-fg, var(--xh-fg-default));
+    /* 表单控件不继承页面字体，只给字号会让框里用 UA 默认字族 */
+    font-family: inherit;
     font-size: var(--xh-pagination-font-size, var(--xh-_pagination-font-size));
     line-height: var(--xh-leading-none);
     appearance: none;
-    transition:
-      background var(--xh-motion-duration-micro) var(--xh-motion-ease-enter),
-      border-color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
   }
 
   [data-scope='pagination'][data-part='jumper'][hidden] {
     display: none;
   }
 
-  [data-scope='pagination'][data-part='jumper']:hover:not(:disabled) {
-    border-color: var(--xh-pagination-jumper-border-hover, var(--xh-border-strong));
-    background: var(--xh-pagination-jumper-bg-hover, var(--xh-bg-subtle-hover));
+  /* 越界的页码（超出 1 到总页数）：浏览器的约束校验在用户动过之后判失败，与字段家族的校验失败同一副边与环。
+     家族的失败档认 data-invalid，跳页框的取值不进状态机，失败由原生约束给出 */
+  [data-scope='pagination'][data-part='jumper']:user-invalid {
+    border-color: var(--xh-field-border-invalid, var(--xh-_field-variant-border-invalid));
   }
 
-  [data-scope='pagination'][data-part='jumper']:disabled {
-    color: var(--xh-fg-disabled);
+  [data-scope='pagination'][data-part='jumper']:user-invalid:focus-within {
+    outline-color: var(--xh-field-ring-invalid, var(--xh-ring-invalid));
   }
 
   /* 摊开省略位的定位层。三处坐标系必须同为 fixed：机器交给引擎的 strategy、
@@ -215,12 +243,35 @@
     /* 页码面板的自绘条浮在内容之上：轨道不上底色，实色轨道会在面板右缘糊一条竖灰带 */
     --xh-scrollbar-track-bg: transparent;
 
+    /* 面板从锚点一侧短移入，方向按实际落位只激活一支 */
+    --xh-_overlay-enter-up: 0;
+    --xh-_overlay-enter-down: 0;
+    --xh-_overlay-enter-left: 0;
+    --xh-_overlay-enter-right: 0;
+
     position: fixed;
     z-index: var(--xh-pagination-layer, var(--xh-_layer, var(--xh-layer-popover)));
     /* 空壳不吃指针：省略位与面板之间那段间隙要能点得穿 */
     pointer-events: none;
   }
 
+  /* 物理 placement 与定位引擎同一套，不随书写方向翻 */
+  [data-scope='pagination'][data-part='positioner'][data-placement^='top'] {
+    --xh-_overlay-enter-down: 1;
+  }
+
+  [data-scope='pagination'][data-part='positioner'][data-placement^='bottom'] {
+    --xh-_overlay-enter-up: 1;
+  }
+
+  [data-scope='pagination'][data-part='positioner'][data-placement^='left'] {
+    --xh-_overlay-enter-right: 1;
+  }
+
+  [data-scope='pagination'][data-part='positioner'][data-placement^='right'] {
+    --xh-_overlay-enter-left: 1;
+  }
+
   /* 锚点被滚出可视区：整个浮层随之收起 */
   [data-scope='pagination'][data-part='positioner'][data-hidden] {
     visibility: hidden;
@@ -250,21 +301,39 @@
     pointer-events: auto;
   }
 
+  /* 摊开的页码面板锚定在省略位上、从中挑一页，与菜单同属锚定列表：从锚点一侧短移淡入，不缩放 */
   [data-scope='pagination'][data-part='content'][data-state='open'] {
-    animation: xh-pop-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter-strong);
+    animation: xh-overlay-slide-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter-strong);
   }
 
   /* 退场：收起那一帧 hidden 由退场闸门押后，这里才播得出来。forwards 把末态钉住，
      免得动画结束到真收起之间闪一下原样 */
   [data-scope='pagination'][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;
   }
 
   /* 这里刻意没有 [data-part='content'][hidden] { display: none }：
      补了退场就一帧都播不出来，真正的收起由适配器落成内联 display */
 
-  /* 没写内容就由皮肤画兜底字形：上一页/下一页默认就是两枚箭头，
-     作者往部件里塞了自己的图形或文字，这两条即不命中 */
+  /* 没写内容就由皮肤画兜底字形：上一页 / 下一页默认就是两枚箭头，首页 / 末页是两枚双箭头，
+     作者往部件里塞了自己的图形或文字，这几条即不命中 */
+  [data-scope='pagination'][data-part='first-trigger']:empty::before,
+  [data-scope='pagination'][data-part='last-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-chevrons-left) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-chevrons-left) center / contain no-repeat;
+  }
+
+  [data-scope='pagination'][data-part='last-trigger']:empty::before {
+    -webkit-mask-image: var(--xh-glyph-mark-chevrons-right);
+    mask-image: var(--xh-glyph-mark-chevrons-right);
+  }
+
   [data-scope='pagination'][data-part='prev-trigger']:empty::before {
     content: '';
     display: inline-block;
@@ -310,20 +379,34 @@
     mask-image: var(--xh-glyph-mark-chevron-left);
   }
 
+  [dir='rtl'] [data-scope='pagination'][data-part='first-trigger']:empty::before {
+    -webkit-mask-image: var(--xh-glyph-mark-chevrons-right);
+    mask-image: var(--xh-glyph-mark-chevrons-right);
+  }
+
+  [dir='rtl'] [data-scope='pagination'][data-part='last-trigger']:empty::before {
+    -webkit-mask-image: var(--xh-glyph-mark-chevrons-left);
+    mask-image: var(--xh-glyph-mark-chevrons-left);
+  }
+
   /* 手指落点：命中区由绝对定位的伪元素向块轴两侧外扩，格子的盒一点不动——
      加高格子会把整条 nav 撑高，行宽也会跟着当前页抖。
      只扩块轴：格与格在行内轴上只隔一格间距，往两侧扩会与相邻格的命中区叠上。
      取 8px 是按最矮的 sm 档算的（28 + 8 × 2 = 44），md 与 lg 档更宽裕。
      用 ::after：::before 已经被两枚箭头的兜底字形占着 */
   @media (pointer: coarse) {
+    [data-scope='pagination'][data-part='first-trigger'],
     [data-scope='pagination'][data-part='prev-trigger'],
     [data-scope='pagination'][data-part='next-trigger'],
+    [data-scope='pagination'][data-part='last-trigger'],
     [data-scope='pagination'][data-part='item'] {
       position: relative;
     }
 
+    [data-scope='pagination'][data-part='first-trigger']::after,
     [data-scope='pagination'][data-part='prev-trigger']::after,
     [data-scope='pagination'][data-part='next-trigger']::after,
+    [data-scope='pagination'][data-part='last-trigger']::after,
     [data-scope='pagination'][data-part='item']::after {
       content: '';
       position: absolute;
@@ -345,4 +428,23 @@
       font-weight: var(--xh-font-weight-semibold);
     }
   }
+
+  @media (forced-colors: active) {
+    /* 兜底字形是 mask 挖出来的一块底色，这一档里底色被系统换成 Canvas，字形跟着消失。
+       字形退出强制换色、直接写系统色（不能取 currentColor：退出强制换色的伪元素读到的是被系统换掉之前的作者色）：
+       按钮面上取 ButtonText，悬停与按下时家族把按钮涂成 Highlight、字形换 HighlightText；
+       禁用取 GrayText */
+    [data-scope='pagination']:is([data-part='first-trigger'], [data-part='last-trigger'], [data-part='prev-trigger'], [data-part='next-trigger'], [data-part='ellipsis-trigger']):empty::before {
+      forced-color-adjust: none;
+      background-color: ButtonText;
+    }
+
+    [data-scope='pagination']:is([data-part='first-trigger'], [data-part='last-trigger'], [data-part='prev-trigger'], [data-part='next-trigger'], [data-part='ellipsis-trigger']):not([data-disabled]):not([data-loading]):is(:hover, :active, [data-pressed]):empty::before {
+      background-color: HighlightText;
+    }
+
+    [data-scope='pagination']:is([data-part='first-trigger'], [data-part='last-trigger'], [data-part='prev-trigger'], [data-part='next-trigger'], [data-part='ellipsis-trigger'])[data-disabled]:empty::before {
+      background-color: GrayText;
+    }
+  }
 }

package/css/password-input.css

@@ -279,9 +279,10 @@
   }
 
   /* 强度条：一条底槽，填充按档位加长。档位由调用方打分后经 strength 传进来，
-     0 与 1 判弱、2 判中、3 与 4 判强，三段各取一族语义色 */
+     0 与 1 判弱、2 判中、3 与 4 判强，三段各取一族语义色。
+     私有槽记的是填到轨道的比例（0–1）：填充铺满轨道、按比例往行首平移藏起未完成的那一截，由轨道裁掉 */
   [data-scope='password-input'][data-part='strength-meter'] {
-    --xh-_password-input-strength-fill: 0%;
+    --xh-_password-input-strength-fill: 0;
     --xh-_password-input-strength-fg: var(--xh-fg-muted);
 
     display: block;
@@ -297,33 +298,39 @@
     display: none;
   }
 
-  /* 没写内容就由皮肤画填充；作者往部件里塞了自己的分段，这几条即不命中 */
+  /* 没写内容就由皮肤画填充；作者往部件里塞了自己的分段，这几条即不命中。
+     填充不动 inline-size：铺满轨道、按比例平移，只走合成（数值角色 move / continuous）；前端圆角保留，
+     行首由轨道圆角裁出。平移乘书写方向的符号，rtl 下从行首（右侧）长出。换档时底色走 micro 淡变 */
   [data-scope='password-input'][data-part='strength-meter']:empty::before {
     content: '';
     display: block;
-    inline-size: var(--xh-_password-input-strength-fill);
+    inline-size: 100%;
     block-size: 100%;
     border-radius: inherit;
     background: var(--xh-password-input-strength-fg, var(--xh-_password-input-strength-fg));
+    translate: calc((var(--xh-_password-input-strength-fill) - 1) * 100% * var(--xh-direction-sign)) 0;
+    transition:
+      translate var(--xh-motion-duration-move) var(--xh-motion-ease-continuous),
+      background-color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
   }
 
   [data-scope='password-input'][data-part='strength-meter'][data-level='1'] {
-    --xh-_password-input-strength-fill: 25%;
+    --xh-_password-input-strength-fill: 0.25;
     --xh-_password-input-strength-fg: var(--xh-fg-danger);
   }
 
   [data-scope='password-input'][data-part='strength-meter'][data-level='2'] {
-    --xh-_password-input-strength-fill: 50%;
+    --xh-_password-input-strength-fill: 0.5;
     --xh-_password-input-strength-fg: var(--xh-fg-warning);
   }
 
   [data-scope='password-input'][data-part='strength-meter'][data-level='3'] {
-    --xh-_password-input-strength-fill: 75%;
+    --xh-_password-input-strength-fill: 0.75;
     --xh-_password-input-strength-fg: var(--xh-fg-success);
   }
 
   [data-scope='password-input'][data-part='strength-meter'][data-level='4'] {
-    --xh-_password-input-strength-fill: 100%;
+    --xh-_password-input-strength-fill: 1;
     --xh-_password-input-strength-fg: var(--xh-fg-success);
   }
 
@@ -356,4 +363,29 @@
       color: ButtonText;
     }
   }
+
+  @media (forced-colors: active) {
+    /* 兜底字形是 mask 挖出来的一块底色，这一档里底色被系统换成 Canvas，字形跟着消失。
+       字形退出强制换色、直接写系统色（不能取 currentColor：退出强制换色的伪元素读到的是被系统换掉之前的作者色）：
+       按钮面上取 ButtonText，悬停与按下时家族把按钮涂成 Highlight、字形换 HighlightText；
+       落在 Canvas 面上的取 CanvasText；
+       禁用取 GrayText */
+    [data-scope='password-input'][data-part='visibility-trigger']:empty::before {
+      forced-color-adjust: none;
+      background-color: ButtonText;
+    }
+
+    [data-scope='password-input'][data-part='caps-lock-indicator'][data-state='visible']::before {
+      forced-color-adjust: none;
+      background-color: CanvasText;
+    }
+
+    [data-scope='password-input'][data-part='visibility-trigger']:not([data-disabled]):not([data-loading]):is(:hover, :active, [data-pressed]):empty::before {
+      background-color: HighlightText;
+    }
+
+    [data-scope='password-input'][data-part='visibility-trigger'][data-disabled]:empty::before {
+      background-color: GrayText;
+    }
+  }
 }

package/css/pie-chart.css

@@ -0,0 +1,247 @@
+/*
+ * Copyright (c) 2021-Present XiHanFun and contributors.
+ * Licensed under the MIT License. See LICENSE in the project root for license information.
+ */
+
+/* 定义 pie chart 样式。 */
+
+/* 淡入关键帧由 family/motion.css 提供；标题、视口、图例、提示框、空态、焦点环与引导线走 Chart 家族配方。
+   本皮肤 @import 它们，单独引入仍成立。 */
+@import '../family/motion.css';
+@import '../family/chart.css';
+@import '../family/loading-ring.css';
+
+@layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  [data-scope='pie-chart'] {
+    --xh-pie-chart-skin: 1;
+  }
+
+  /* 几何要用的像素值以这里的私有槽为真源：机器挂载后从计算样式读它们，作者覆盖组件槽即改变几何 */
+  [data-scope='pie-chart'][data-part='root'] {
+    --xh-_chart-metric-bar-max: var(--xh-chart-bar-max);
+    --xh-_chart-metric-gap: var(--xh-pie-chart-slice-gap, var(--xh-chart-gap));
+    --xh-_chart-metric-line-width: var(--xh-chart-line-width);
+    --xh-_chart-metric-point-size: var(--xh-chart-point-size);
+    --xh-_chart-metric-hit-min: var(--xh-chart-hit-min);
+    --xh-_chart-metric-tick-length: var(--xh-chart-tick-length);
+    --xh-_chart-metric-label-gap: var(--xh-chart-label-gap);
+    --xh-_chart-metric-radius: var(--xh-pie-chart-slice-radius, var(--xh-shape-inset));
+    --xh-_chart-metric-font-size: var(--xh-text-caption-size);
+    --xh-_chart-metric-leading: var(--xh-leading-tight);
+    --xh-_chart-gap: var(--xh-pie-chart-gap, var(--xh-space-3));
+  }
+
+  /* —— 家族配方的组件槽：标题、视口、图例、提示框与空态由 family/chart.css 画，本图表的覆盖槽写在
+     对应部件上接进配方的私有槽，作者在部件或它的祖先上覆盖都生效 —— */
+  [data-scope='pie-chart'][data-part='viewport'] {
+    --xh-_chart-height: var(--xh-pie-chart-height, var(--xh-chart-height));
+  }
+
+  [data-scope='pie-chart'][data-part='legend'] {
+    --xh-_chart-legend-gap: var(--xh-pie-chart-legend-gap, var(--xh-space-1));
+  }
+
+  [data-scope='pie-chart'][data-part='legend-swatch'] {
+    --xh-_chart-legend-swatch-radius: var(--xh-pie-chart-legend-swatch-radius, var(--xh-shape-inset));
+  }
+
+  [data-scope='pie-chart'][data-part='tooltip'] {
+    --xh-_chart-tooltip-gap: var(--xh-pie-chart-tooltip-gap, var(--xh-space-1));
+    --xh-_chart-tooltip-py: var(--xh-pie-chart-tooltip-py, var(--xh-surface-pad-sm));
+    --xh-_chart-tooltip-px: var(--xh-pie-chart-tooltip-px, var(--xh-surface-pad-sm));
+    --xh-_chart-tooltip-radius: var(--xh-pie-chart-tooltip-radius, var(--xh-shape-overlay));
+    --xh-_chart-tooltip-shadow: var(--xh-pie-chart-tooltip-shadow, var(--xh-material-frosted-shadow));
+  }
+
+  [data-scope='pie-chart'][data-part='tooltip-row'] {
+    --xh-_chart-tooltip-row-gap: var(--xh-pie-chart-tooltip-row-gap, var(--xh-space-2));
+  }
+
+  [data-scope='pie-chart'][data-part='tooltip-swatch'] {
+    --xh-_chart-tooltip-swatch-radius: var(--xh-pie-chart-tooltip-swatch-radius, var(--xh-shape-inset));
+  }
+
+  [data-scope='pie-chart'][data-part='empty'][data-state='loading'] {
+    --xh-_chart-empty-gap: var(--xh-pie-chart-empty-gap, var(--xh-space-2));
+  }
+
+  /* —— 色槽：身份由色槽承担，作者可以在扇区上覆盖 --xh-pie-chart-series-color ——
+     扇区、内侧标签、图例项与提示框的行都带着色槽，各自从这里取系列色与配对的前景色 */
+  [data-scope='pie-chart'][data-xh-chart-slot='1'] {
+    --xh-_chart-series: var(--xh-pie-chart-series-color, var(--xh-chart-categorical-1));
+    --xh-_chart-on-series: var(--xh-chart-on-categorical-1);
+  }
+
+  [data-scope='pie-chart'][data-xh-chart-slot='2'] {
+    --xh-_chart-series: var(--xh-pie-chart-series-color, var(--xh-chart-categorical-2));
+    --xh-_chart-on-series: var(--xh-chart-on-categorical-2);
+  }
+
+  [data-scope='pie-chart'][data-xh-chart-slot='3'] {
+    --xh-_chart-series: var(--xh-pie-chart-series-color, var(--xh-chart-categorical-3));
+    --xh-_chart-on-series: var(--xh-chart-on-categorical-3);
+  }
+
+  [data-scope='pie-chart'][data-xh-chart-slot='4'] {
+    --xh-_chart-series: var(--xh-pie-chart-series-color, var(--xh-chart-categorical-4));
+    --xh-_chart-on-series: var(--xh-chart-on-categorical-4);
+  }
+
+  [data-scope='pie-chart'][data-xh-chart-slot='5'] {
+    --xh-_chart-series: var(--xh-pie-chart-series-color, var(--xh-chart-categorical-5));
+    --xh-_chart-on-series: var(--xh-chart-on-categorical-5);
+  }
+
+  [data-scope='pie-chart'][data-xh-chart-slot='6'] {
+    --xh-_chart-series: var(--xh-pie-chart-series-color, var(--xh-chart-categorical-6));
+    --xh-_chart-on-series: var(--xh-chart-on-categorical-6);
+  }
+
+  [data-scope='pie-chart'][data-xh-chart-slot='7'] {
+    --xh-_chart-series: var(--xh-pie-chart-series-color, var(--xh-chart-categorical-7));
+    --xh-_chart-on-series: var(--xh-chart-on-categorical-7);
+  }
+
+  [data-scope='pie-chart'][data-xh-chart-slot='8'] {
+    --xh-_chart-series: var(--xh-pie-chart-series-color, var(--xh-chart-categorical-8));
+    --xh-_chart-on-series: var(--xh-chart-on-categorical-8);
+  }
+
+  /* 合并出来的「其他」取中性色：它不是一个类目，不占分类色 */
+  [data-scope='pie-chart'][data-xh-chart-slot='other'] {
+    --xh-_chart-series: var(--xh-chart-categorical-other);
+  }
+
+  /* —— 扇区：相邻扇区之间的间隙由几何留出，不画描边；悬停时其余扇区淡出，被指着的不位移 —— */
+  [data-scope='pie-chart'][data-part='slice'] {
+    fill: var(--xh-_chart-series);
+    stroke: none;
+    transition: opacity var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+  }
+
+  [data-scope='pie-chart'][data-part='slice'][data-dimmed],
+  [data-scope='pie-chart'][data-part='slice-label'][data-dimmed] {
+    opacity: var(--xh-chart-dim-alpha);
+  }
+
+  /* 外侧标签是标注：标注字色，不取扇区色；引导线的画法在配方里 */
+  [data-scope='pie-chart'][data-part='slice-label'] {
+    fill: var(--xh-chart-label);
+  }
+
+  /* 内侧标签压在扇区色上：取与色槽配对的前景色 */
+  [data-scope='pie-chart'][data-part='slice-label'][data-xh-chart-slot] {
+    fill: var(--xh-_chart-on-series);
+    font-weight: var(--xh-font-weight-medium);
+  }
+
+  /* —— 环形中心：叠在视口上，圆心与内径由几何给出；文字不超出内圈 —— */
+  /* 首次出现：外侧标签等扫开的边缘到了才淡入，连接层写入它占入场时长的比例，乘上入场时长就是延迟；
+     环形中心等整圈扫完再淡入 */
+  [data-scope='pie-chart'][data-part='slice-label'][data-drawing] {
+    animation: xh-fade-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter) both;
+    animation-delay: calc(var(--xh-motion-duration-reveal) * var(--xh-_chart-reveal-at));
+  }
+
+  [data-scope='pie-chart'][data-part='center'][data-drawing] {
+    animation: xh-fade-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter) both;
+    animation-delay: var(--xh-motion-duration-reveal);
+  }
+
+  [data-scope='pie-chart'][data-part='center'] {
+    position: absolute;
+    inset-block-start: var(--xh-_chart-center-y, 50%);
+    /* stylelint-disable-next-line property-disallowed-list -- 绘图区不随 RTL 镜像，圆心横坐标由连接层按物理左缘写入 */
+    left: var(--xh-_chart-center-x, 50%);
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    gap: var(--xh-pie-chart-center-gap, var(--xh-space-0_5));
+    max-inline-size: calc(var(--xh-_chart-center-size, 0px) * 0.8);
+    text-align: center;
+    /* 中心不接指针：它压在内圈的空洞上，不挡扇区的命中 */
+    pointer-events: none;
+    translate: -50% -50%;
+  }
+
+  [data-scope='pie-chart'][data-part='center'][data-placement='top'] {
+    translate: -50% -100%;
+  }
+
+  [data-scope='pie-chart'][data-part='center'][hidden] {
+    display: none;
+  }
+
+  [data-scope='pie-chart'][data-part='center-value'] {
+    color: var(--xh-fg-default);
+    font-size: var(--xh-pie-chart-center-value-font-size, var(--xh-text-heading-3-size));
+    font-weight: var(--xh-font-weight-semibold);
+    line-height: var(--xh-leading-tight);
+    font-variant-numeric: tabular-nums;
+  }
+
+  [data-scope='pie-chart'][data-part='center-label'] {
+    color: var(--xh-fg-muted);
+    font-size: var(--xh-text-secondary-size);
+  }
+
+  /* —— 纹理：颜色不可用或不可靠时（强制色、打印、祖先写了 data-xh-chart-patterns），扇区改用本色槽在 defs 里的
+     纹理填充、描出轮廓（「其他」不带纹理）；压在扇区上的标签改用标签色、描一圈承载面色。色标的纹理在配方里 —— */
+  :where([data-xh-chart-patterns]) [data-scope='pie-chart'][data-part='slice'][data-xh-chart-pattern] {
+    fill: var(--xh-_chart-pattern);
+    stroke: var(--xh-_chart-series);
+    stroke-width: var(--xh-stroke-thin);
+  }
+
+  :where([data-xh-chart-patterns]) [data-scope='pie-chart'][data-part='slice-label'][data-xh-chart-slot] {
+    fill: var(--xh-chart-label);
+    stroke: var(--xh-chart-surface);
+    stroke-width: var(--xh-stroke-thick);
+    paint-order: stroke;
+  }
+
+  /* 强制色：扇区改成系统色的面与描边；纹理总是开启；焦点环、引导线与色标在配方里 */
+  @media (forced-colors: active) {
+    [data-scope='pie-chart'][data-part='slice'] {
+      fill: Canvas;
+      stroke: CanvasText;
+      stroke-width: var(--xh-stroke-thin);
+    }
+
+    [data-scope='pie-chart'][data-part='slice-label'],
+    [data-scope='pie-chart'][data-part='slice-label'][data-xh-chart-slot] {
+      fill: CanvasText;
+    }
+
+    [data-scope='pie-chart'][data-part='slice'][data-xh-chart-pattern] {
+      forced-color-adjust: none;
+      fill: var(--xh-_chart-pattern);
+      stroke: CanvasText;
+      stroke-width: var(--xh-stroke-thin);
+    }
+
+    [data-scope='pie-chart'][data-part='slice-label'][data-xh-chart-slot] {
+      fill: CanvasText;
+      stroke: Canvas;
+      stroke-width: var(--xh-stroke-thick);
+      paint-order: stroke;
+    }
+  }
+
+  /* 打印：纹理开启；提示框与焦点环在配方里 */
+  @media print {
+    [data-scope='pie-chart'][data-part='slice'][data-xh-chart-pattern] {
+      fill: var(--xh-_chart-pattern);
+      stroke: var(--xh-_chart-series);
+      stroke-width: var(--xh-stroke-thin);
+    }
+
+    [data-scope='pie-chart'][data-part='slice-label'][data-xh-chart-slot] {
+      fill: var(--xh-chart-label);
+      stroke: var(--xh-chart-surface);
+      stroke-width: var(--xh-stroke-thick);
+      paint-order: stroke;
+    }
+  }
+}