@xihan-ui/styles 3.0.0 → 3.2.0

package/dist/css/password-input.css

@@ -0,0 +1,391 @@
+/*
+ * Copyright (c) 2021-Present XiHanFun and contributors.
+ * Licensed under the MIT License. See LICENSE in the project root for license information.
+ */
+
+/* PasswordInput 独立皮肤同时传递引入字段视觉盒与字段内动作；full bundle 递归去重。 */
+@import '../family/field-chrome.css';
+@import '../family/action-control.css';
+
+@layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  .xh-scope-password-input {
+    --xh-password-input-skin: 1;
+  }
+
+  /* root 只负责纵向堆叠：标签一行、输入行一行。
+     输入框、切换钮与大写锁定提示收进 control 部件即得一体式：视觉盒由 Field Chrome 家族画在 control 上，
+     框内三件都退成透明分段，整枚控件从头到尾只有一道描边。
+     不写 control 时是独立输入框和按钮，不再绘制独立外壳（与 text-field 同）。
+     组件层只把既有公开槽映射到家族合同；形态三档由家族按 control 上的 data-variant 生成，皮肤不再声明。 */
+  .xh-scope-password-input[data-part='root'] {
+    /* 作者塞进来的图标跟着控件的尺寸档走；它自己写了 size 时仍以作者的为准 */
+    --xh-icon-size: var(--xh-password-input-icon-size, var(--xh-glyph-size-md));
+
+    /* 尺寸档只换这几个私有槽，输入框、切换钮与提示都从 root 继承它们，
+       换档不必给每个部件各写一条选择器 */
+    --xh-_password-input-h: var(--xh-control-h-md);
+    --xh-_password-input-px: var(--xh-control-px-md);
+    --xh-_password-input-gap: var(--xh-control-gap-md);
+    --xh-_password-input-font-size: var(--xh-control-font-md);
+    /* 提示与切换钮里的字形都比正文小一档，三个尺寸档各自换过，不是一个恒等的中转 */
+    --xh-_password-input-caps-lock-font-size: var(--xh-control-caption-md);
+    --xh-_password-input-trigger-font-size: var(--xh-control-caption-md);
+    /* 切换钮与输入之间那道线的长度：取钮高的一半，线的上下各留一截空白 */
+    --xh-_password-input-divider-h: 50%;
+
+    /* 盒里有两个 Tab 停靠点，切换钮上再画一圈自己的环；环恒用 --xh-ring-focus，校验失败时随盒换红 */
+    --xh-_password-input-ring: var(--xh-ring-focus);
+
+    display: inline-flex;
+    flex-direction: column;
+    gap: var(--xh-password-input-gap, var(--xh-space-1));
+
+    /* 不传尺寸时一律这么宽，宽度不随内容走；父容器给不出这么宽时整件跟着收，地板同步让步，不越出父容器。
+       地板不高过缺省宽：使用者把缺省宽钉到底线以下时不必再放开底线 */
+    inline-size: var(--xh-password-input-control-w, var(--xh-control-w));
+    min-inline-size: min(var(--xh-password-input-control-w, var(--xh-control-w)), var(--xh-password-input-control-min-w, var(--xh-control-min-w)), 100%);
+    max-inline-size: 100%;
+  }
+
+  /* 只要声明了 display 就盖掉了 UA 的 [hidden]{display:none}，收起态得自己还回去 */
+  .xh-scope-password-input[data-part='root'][hidden] {
+    display: none;
+  }
+
+  /* —— 尺寸 —— */
+  /* 缺省档写在上面的基础规则里 */
+  .xh-scope-password-input[data-part='root'][data-size='sm'] {
+    --xh-icon-size: var(--xh-password-input-icon-size, var(--xh-glyph-size-sm));
+    --xh-_password-input-h: var(--xh-control-h-sm);
+    --xh-_password-input-px: var(--xh-control-px-sm);
+    --xh-_password-input-gap: var(--xh-control-gap-sm);
+    --xh-_password-input-font-size: var(--xh-control-font-sm);
+    --xh-_password-input-caps-lock-font-size: var(--xh-control-caption-sm);
+    --xh-_password-input-trigger-font-size: var(--xh-control-caption-sm);
+  }
+
+  .xh-scope-password-input[data-part='root'][data-size='lg'] {
+    --xh-icon-size: var(--xh-password-input-icon-size, var(--xh-glyph-size-lg));
+    --xh-_password-input-h: var(--xh-control-h-lg);
+    --xh-_password-input-px: var(--xh-control-px-lg);
+    --xh-_password-input-gap: var(--xh-control-gap-lg);
+    --xh-_password-input-font-size: var(--xh-control-font-lg);
+    --xh-_password-input-caps-lock-font-size: var(--xh-control-caption-lg);
+    --xh-_password-input-trigger-font-size: var(--xh-control-caption-lg);
+  }
+
+  /* —— 标题 —— */
+  .xh-scope-password-input[data-part='label'] {
+    color: var(--xh-password-input-label-fg, var(--xh-fg-default));
+    font-size: var(--xh-password-input-label-font-size, var(--xh-text-label-size));
+    font-weight: var(--xh-password-input-label-font-weight, var(--xh-text-label-weight));
+  }
+
+  .xh-scope-password-input[data-part='label'][data-disabled] {
+    color: var(--xh-password-input-label-fg-disabled, var(--xh-fg-subtle));
+  }
+
+  /* —— 一体式 control：输入框、切换钮与提示同框 —— */
+  /* control 是唯一的视觉盒：描边、底色、圆角、聚焦环、五态与悬停由 Field Chrome 家族画。
+     :focus-within 而不是 :focus——盒里有两个 Tab 停靠点，输入框与切换钮各占一个 */
+  .xh-scope-password-input[data-part='control'] {
+    --xh-field-control-height: var(--xh-password-input-control-h, var(--xh-_password-input-h));
+    --xh-field-control-padding-inline: var(--xh-password-input-control-px, var(--xh-_password-input-px));
+    --xh-field-control-gap: var(--xh-password-input-control-gap, var(--xh-_password-input-gap));
+    --xh-field-control-min-inline-size: var(--xh-password-input-control-min-w, var(--xh-control-min-w));
+    --xh-field-control-radius: var(--xh-password-input-control-radius, var(--xh-shape-control));
+    --xh-field-bg-rest: var(--xh-password-input-control-bg, var(--xh-_field-variant-bg-rest));
+    --xh-field-bg-hover: var(--xh-password-input-control-bg-hover, var(--xh-_field-variant-bg-hover));
+    --xh-field-bg-read-only: var(--xh-password-input-control-bg-readonly, var(--xh-_field-variant-bg-read-only));
+    --xh-field-bg-disabled: var(--xh-password-input-control-bg-disabled, var(--xh-_field-variant-bg-disabled));
+    --xh-field-fg-rest: var(--xh-password-input-control-fg, var(--xh-fg-default));
+    --xh-field-border-rest: var(--xh-password-input-control-border, var(--xh-_field-variant-border-rest));
+    --xh-field-border-hover: var(--xh-password-input-control-border-hover, var(--xh-_field-variant-border-hover));
+    --xh-field-border-focus: var(--xh-password-input-control-border-focus, var(--xh-_field-variant-border-focus));
+    --xh-field-border-invalid: var(--xh-password-input-control-border-invalid, var(--xh-_field-variant-border-invalid));
+    --xh-field-ring-focus: var(--xh-ring-focus);
+    --xh-field-ring-invalid: var(--xh-ring-invalid);
+    --xh-field-shadow-rest: var(--xh-password-input-control-shadow, none);
+    /* 家族 chrome 会重写 --xh-icon-size，使用者图标槽必须经桥接槽下发才能在盒内生效 */
+    --xh-field-glyph-size: var(--xh-password-input-icon-size, var(--xh-_field-size-glyph-size));
+  }
+
+  .xh-scope-password-input[data-part='control'][hidden] {
+    display: none;
+  }
+
+  /* 校验失败时切换钮自己那圈环也跟着变红：两圈等宽相邻却一红一蓝，读的人不知道哪个才是当前状态 */
+  .xh-scope-password-input[data-part='control'][data-invalid] {
+    --xh-_password-input-ring: var(--xh-ring-invalid);
+  }
+
+  /* —— 输入框 —— */
+  /* 无边框无底无圆角无落影由家族重置，观感全归 control；自动填充由家族用 canvas 实体底与默认前景重绘 */
+  .xh-scope-password-input[data-part='input'] {
+    --xh-field-input-fg: var(--xh-password-input-input-fg, var(--xh-fg-default));
+    --xh-field-input-font-size: var(--xh-password-input-input-font-size, var(--xh-_password-input-font-size));
+    --xh-field-placeholder-fg: var(--xh-password-input-placeholder-fg, var(--xh-fg-subtle));
+    --xh-field-autofill-bg: var(--xh-password-input-input-autofill-bg, var(--xh-bg-canvas));
+    --xh-field-autofill-fg: var(--xh-password-input-input-autofill-fg, var(--xh-fg-default));
+  }
+
+  /* —— 明暗切换钮 —— */
+  /* 正方视觉盒、inset 圆角、悬停 100 / 按下 200 与 0.97 按压、粗指针热区全由 Action Control 的
+     field-inset ghost 档给，组件只映射既有覆盖槽；常态只剩符号，符号取次级前景 */
+  .xh-scope-password-input[data-part='visibility-trigger'] {
+    --xh-action-visual-size: var(--xh-password-input-trigger-size, var(--xh-_action-profile-visual-size));
+    --xh-action-min-inline-size: var(--xh-password-input-trigger-size, var(--xh-_action-profile-visual-size));
+    --xh-action-radius: var(--xh-password-input-trigger-radius, var(--xh-shape-inset));
+    /* 底色阶梯由 ghost 档给（透明 → 100 → 200），使用者槽只作覆盖入口 */
+    --xh-action-bg-rest: var(--xh-password-input-trigger-bg, var(--xh-_action-variant-bg-rest));
+    --xh-action-bg-hover: var(--xh-password-input-trigger-bg-hover, var(--xh-_action-variant-bg-hover));
+    --xh-action-bg-pressed: var(--xh-password-input-trigger-bg-active, var(--xh-_action-variant-bg-pressed));
+    --xh-action-fg-rest: var(--xh-password-input-trigger-fg, var(--xh-fg-muted));
+    --xh-action-fg-hover: var(--xh-password-input-trigger-fg-hover, var(--xh-fg-default));
+    --xh-action-border-rest: transparent;
+    --xh-action-highlight-rest: transparent;
+    --xh-action-shadow-rest: none;
+    --xh-action-shadow-hover: none;
+    --xh-action-shadow-pressed: none;
+    --xh-action-font-size: var(--xh-password-input-trigger-font-size, var(--xh-_password-input-trigger-font-size));
+    /* 配方尚未把 profile 字形档灌进 --xh-icon-size，钮内字形先按 field-inset 档逐钮取值 */
+    --xh-icon-size: var(--xh-_action-profile-glyph-size);
+
+    border-width: 0;
+
+    --xh-_password-input-mark: var(--xh-glyph-mark-eye);
+  }
+
+  .xh-scope-password-input[data-part='visibility-trigger'][hidden] {
+    display: none;
+  }
+
+  /* 显隐动作与输入/状态区之间留一道半高分隔。::before 是兜底字形、::after 在粗指针下是家族给的
+     44px 热区，线只能落在 background-image 上：一条 1px × 半高的渐变贴在靠输入的那一侧，
+     不随按钮悬停底或圆角变化。background-position 是物理轴，RTL 另给两条换边。 */
+  .xh-scope-password-input[data-part='control']
+    > .xh-scope-password-input[data-part='visibility-trigger']:has(~ .xh-scope-password-input[data-part='input']),
+  .xh-scope-password-input[data-part='control']
+    > .xh-scope-password-input[data-part='input'] ~ .xh-scope-password-input[data-part='visibility-trigger'] {
+    background-image: linear-gradient(
+      var(--xh-password-input-visibility-trigger-separator-color, var(--xh-border-subtle)),
+      var(--xh-password-input-visibility-trigger-separator-color, var(--xh-border-subtle))
+    );
+    background-repeat: no-repeat;
+    background-size: var(--xh-stroke-thin) var(--xh-password-input-visibility-trigger-separator-h, var(--xh-_password-input-divider-h));
+  }
+
+  /* 钮排在输入之前：线贴在钮的逻辑末端 */
+  .xh-scope-password-input[data-part='control']
+    > .xh-scope-password-input[data-part='visibility-trigger']:has(~ .xh-scope-password-input[data-part='input']) {
+    background-position: 100% 50%;
+  }
+
+  [dir='rtl'] .xh-scope-password-input[data-part='control']
+    > .xh-scope-password-input[data-part='visibility-trigger']:has(~ .xh-scope-password-input[data-part='input']) {
+    background-position: 0 50%;
+  }
+
+  /* 钮排在输入之后：线贴在钮的逻辑起始侧 */
+  .xh-scope-password-input[data-part='control']
+    > .xh-scope-password-input[data-part='input'] ~ .xh-scope-password-input[data-part='visibility-trigger'] {
+    background-position: 0 50%;
+  }
+
+  [dir='rtl'] .xh-scope-password-input[data-part='control']
+    > .xh-scope-password-input[data-part='input'] ~ .xh-scope-password-input[data-part='visibility-trigger'] {
+    background-position: 100% 50%;
+  }
+
+  /* 盒里有两个 Tab 停靠点，盒子在 :focus-within 上画的那一圈两者完全一样，
+     分不出焦点在框里还是在钮上，所以钮上再画一圈自己的环（家族只对不占 Tab 位的内嵌钮关环）。
+     环往内收，压在按钮自己的方框里，不与盒子外面那一圈叠在一起。
+     指示焦点只能用环不能用底色：可用的几档底色压在盒底上都到不了 3:1，换了色也等于没画 */
+  .xh-scope-password-input[data-part='control'] [data-part='visibility-trigger']:where(.xh-scope-password-input):focus-visible {
+    outline: var(--xh-ring-width) solid var(--xh-_password-input-ring);
+    outline-offset: var(--xh-ring-offset);
+  }
+
+  /* 明暗两态各一枚字形：换的是这个槽，兜底盒的量法只写一遍 */
+  .xh-scope-password-input[data-part='visibility-trigger'][data-state='visible'] {
+    --xh-_password-input-mark: var(--xh-glyph-mark-eye-off);
+  }
+
+  /* 没写内容就由皮肤画兜底字形；作者往部件里塞了自己的图形，这条即不命中 */
+  .xh-scope-password-input[data-part='visibility-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-_password-input-mark) center / contain no-repeat;
+    mask: var(--xh-_password-input-mark) center / contain no-repeat;
+  }
+
+  /* —— 大写锁定提示 —— */
+  /* 贴在切换钮之前的一小块提示，字号比正文小一档，颜色取次级前景：
+     它是提示不是报错，抢不过框里正在输入的内容。
+     槽名按部件取 --xh-password-input-caps-lock-* */
+  /* 这一格恒占一个字形的宽，开合都不变：区内那句话有多长，控件就跟着宽多少，
+     而这个盒是收缩包裹的（见 control 的 inline-flex），一开大写锁定控件当场宽出一整句话。
+     文字留在盒里不动——它是活区域要念的内容——只是被 text-indent 推出可视范围，
+     露出来的是 ::before 画的那枚字形。 */
+  .xh-scope-password-input[data-part='caps-lock-indicator'] {
+    position: relative;
+    display: inline-flex;
+    flex: none;
+    align-items: center;
+    justify-content: center;
+    inline-size: var(--xh-icon-size, var(--xh-glyph-size-text));
+    overflow: hidden;
+    color: var(--xh-password-input-caps-lock-fg, var(--xh-fg-muted));
+    font-size: var(--xh-password-input-caps-lock-font-size, var(--xh-_password-input-caps-lock-font-size));
+    line-height: var(--xh-leading-none);
+    white-space: nowrap;
+    text-indent: 100%;
+  }
+
+  .xh-scope-password-input[data-part='control'][data-disabled]
+    > .xh-scope-password-input[data-part='caps-lock-indicator'] {
+    color: var(--xh-password-input-caps-lock-fg-disabled, var(--xh-fg-disabled));
+  }
+
+  /* 开着时才画字形：这一格的宽两态一样，画不画只换露不露出记号 */
+  .xh-scope-password-input[data-part='caps-lock-indicator'][data-state='visible']::before {
+    content: '';
+    position: absolute;
+    inset: 0;
+    margin: auto;
+    inline-size: var(--xh-icon-size, var(--xh-glyph-size-text));
+    block-size: var(--xh-icon-size, var(--xh-glyph-size-text));
+    background-color: currentColor;
+    -webkit-mask: var(--xh-glyph-mark-arrow-up) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-arrow-up) center / contain no-repeat;
+  }
+
+  /* 作者自己给这个节点写 hidden 时照样收起；上面那条 display 会把 UA 规则盖掉，
+     少了这条它就一直杵在那儿 */
+  .xh-scope-password-input[data-part='caps-lock-indicator'][hidden] {
+    display: none;
+  }
+
+  /* 没开大写锁定时只把这块收成零宽，不用 display / visibility 撤掉它：
+     播报区一旦从渲染树里消失就不再是活区域，重新出现时读屏当作插入了个新节点，多数不念。
+     这一格的宽两态一样，关着时只是不画字形，盒本身照旧在场 */
+  .xh-scope-password-input[data-part='caps-lock-indicator'][data-state='hidden']::before {
+    content: none;
+  }
+
+  /* 强度条：一条底槽，填充按档位加长。档位由调用方打分后经 strength 传进来，
+     0 与 1 判弱、2 判中、3 与 4 判强，三段各取一族语义色。
+     私有槽记的是填到轨道的比例（0–1）：填充铺满轨道、按比例往行首平移藏起未完成的那一截，由轨道裁掉 */
+  .xh-scope-password-input[data-part='strength-meter'] {
+    --xh-_password-input-strength-fill: 0;
+    --xh-_password-input-strength-fg: var(--xh-fg-muted);
+
+    display: block;
+    overflow: hidden;
+    inline-size: 100%;
+    block-size: var(--xh-password-input-strength-thickness, var(--xh-track-thickness));
+    border-radius: var(--xh-password-input-strength-radius, var(--xh-shape-pill));
+    background: var(--xh-password-input-strength-track, var(--xh-bg-subtle-active));
+  }
+
+  /* 没给 strength 时连接层给的是 hidden 属性；上面那条 display 会把 UA 规则盖掉 */
+  .xh-scope-password-input[data-part='strength-meter'][hidden] {
+    display: none;
+  }
+
+  /* 没写内容就由皮肤画填充；作者往部件里塞了自己的分段，这几条即不命中。
+     填充不动 inline-size：铺满轨道、按比例平移，只走合成（数值角色 move / continuous）；前端圆角保留，
+     行首由轨道圆角裁出。平移乘书写方向的符号，rtl 下从行首（右侧）长出。换档时底色走 micro 淡变 */
+  .xh-scope-password-input[data-part='strength-meter']:empty::before {
+    content: '';
+    display: block;
+    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);
+  }
+
+  .xh-scope-password-input[data-part='strength-meter'][data-level='1'] {
+    --xh-_password-input-strength-fill: 0.25;
+    --xh-_password-input-strength-fg: var(--xh-fg-danger);
+  }
+
+  .xh-scope-password-input[data-part='strength-meter'][data-level='2'] {
+    --xh-_password-input-strength-fill: 0.5;
+    --xh-_password-input-strength-fg: var(--xh-fg-warning);
+  }
+
+  .xh-scope-password-input[data-part='strength-meter'][data-level='3'] {
+    --xh-_password-input-strength-fill: 0.75;
+    --xh-_password-input-strength-fg: var(--xh-fg-success);
+  }
+
+  .xh-scope-password-input[data-part='strength-meter'][data-level='4'] {
+    --xh-_password-input-strength-fill: 1;
+    --xh-_password-input-strength-fg: var(--xh-fg-success);
+  }
+
+  .xh-scope-password-input[data-part='strength-meter'][data-disabled] {
+    --xh-_password-input-strength-fg: var(--xh-fg-disabled);
+  }
+
+  /* 高对比档整层丢弃 background-image，分隔线改用系统色重画，并关掉这一颗钮的强制换色 */
+  @media (forced-colors: active) {
+    .xh-scope-password-input[data-part='control']
+      > .xh-scope-password-input[data-part='visibility-trigger']:has(~ .xh-scope-password-input[data-part='input']),
+    .xh-scope-password-input[data-part='control']
+      > .xh-scope-password-input[data-part='input'] ~ .xh-scope-password-input[data-part='visibility-trigger'] {
+      background-image: linear-gradient(CanvasText, CanvasText);
+      forced-color-adjust: none;
+    }
+
+    .xh-scope-password-input[data-part='control'][data-disabled]
+      > .xh-scope-password-input[data-part='visibility-trigger']:has(~ .xh-scope-password-input[data-part='input']),
+    .xh-scope-password-input[data-part='control'][data-disabled]
+      > .xh-scope-password-input[data-part='input'] ~ .xh-scope-password-input[data-part='visibility-trigger'] {
+      background-image: linear-gradient(GrayText, GrayText);
+    }
+
+    /* 关掉强制换色后，上面那圈自留的 :focus-visible 环与家族普通态的焦点底/字都会按作者色落地；
+       家族高对比块的特指度压不过它们，这里用同一选择器把环、底、字改回系统色 */
+    .xh-scope-password-input[data-part='control'] [data-part='visibility-trigger']:where(.xh-scope-password-input):focus-visible {
+      outline-color: Highlight;
+      background-color: ButtonFace;
+      color: ButtonText;
+    }
+  }
+
+  @media (forced-colors: active) {
+    /* 兜底字形是 mask 挖出来的一块底色，这一档里底色被系统换成 Canvas，字形跟着消失。
+       字形退出强制换色、直接写系统色（不能取 currentColor：退出强制换色的伪元素读到的是被系统换掉之前的作者色）：
+       按钮面上取 ButtonText，悬停与按下时家族把按钮涂成 Highlight、字形换 HighlightText；
+       落在 Canvas 面上的取 CanvasText；
+       禁用取 GrayText */
+    .xh-scope-password-input[data-part='visibility-trigger']:empty::before {
+      forced-color-adjust: none;
+      background-color: ButtonText;
+    }
+
+    .xh-scope-password-input[data-part='caps-lock-indicator'][data-state='visible']::before {
+      forced-color-adjust: none;
+      background-color: CanvasText;
+    }
+
+    .xh-scope-password-input[data-part='visibility-trigger']:not([data-disabled]):not([data-loading]):is(:hover, :active, [data-pressed]):empty::before {
+      background-color: HighlightText;
+    }
+
+    .xh-scope-password-input[data-part='visibility-trigger'][data-disabled]:empty::before {
+      background-color: GrayText;
+    }
+  }
+}

package/dist/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 探一次，取不到就说明这份皮肤没被引入。 */
+  .xh-scope-pie-chart {
+    --xh-pie-chart-skin: 1;
+  }
+
+  /* 几何要用的像素值以这里的私有槽为真源：机器挂载后从计算样式读它们，作者覆盖组件槽即改变几何 */
+  .xh-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 画，本图表的覆盖槽写在
+     对应部件上接进配方的私有槽，作者在部件或它的祖先上覆盖都生效 —— */
+  .xh-scope-pie-chart[data-part='viewport'] {
+    --xh-_chart-height: var(--xh-pie-chart-height, var(--xh-chart-height));
+  }
+
+  .xh-scope-pie-chart[data-part='legend'] {
+    --xh-_chart-legend-gap: var(--xh-pie-chart-legend-gap, var(--xh-space-1));
+  }
+
+  .xh-scope-pie-chart[data-part='legend-swatch'] {
+    --xh-_chart-legend-swatch-radius: var(--xh-pie-chart-legend-swatch-radius, var(--xh-shape-inset));
+  }
+
+  .xh-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));
+  }
+
+  .xh-scope-pie-chart[data-part='tooltip-row'] {
+    --xh-_chart-tooltip-row-gap: var(--xh-pie-chart-tooltip-row-gap, var(--xh-space-2));
+  }
+
+  .xh-scope-pie-chart[data-part='tooltip-swatch'] {
+    --xh-_chart-tooltip-swatch-radius: var(--xh-pie-chart-tooltip-swatch-radius, var(--xh-shape-inset));
+  }
+
+  .xh-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 ——
+     扇区、内侧标签、图例项与提示框的行都带着色槽，各自从这里取系列色与配对的前景色 */
+  .xh-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);
+  }
+
+  .xh-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);
+  }
+
+  .xh-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);
+  }
+
+  .xh-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);
+  }
+
+  .xh-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);
+  }
+
+  .xh-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);
+  }
+
+  .xh-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);
+  }
+
+  .xh-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);
+  }
+
+  /* 合并出来的「其他」取中性色：它不是一个类目，不占分类色 */
+  .xh-scope-pie-chart[data-xh-chart-slot='other'] {
+    --xh-_chart-series: var(--xh-chart-categorical-other);
+  }
+
+  /* —— 扇区：相邻扇区之间的间隙由几何留出，不画描边；悬停时其余扇区淡出，被指着的不位移 —— */
+  .xh-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);
+  }
+
+  .xh-scope-pie-chart[data-part='slice'][data-dimmed],
+  .xh-scope-pie-chart[data-part='slice-label'][data-dimmed] {
+    opacity: var(--xh-chart-dim-alpha);
+  }
+
+  /* 外侧标签是标注：标注字色，不取扇区色；引导线的画法在配方里 */
+  .xh-scope-pie-chart[data-part='slice-label'] {
+    fill: var(--xh-chart-label);
+  }
+
+  /* 内侧标签压在扇区色上：取与色槽配对的前景色 */
+  .xh-scope-pie-chart[data-part='slice-label'][data-xh-chart-slot] {
+    fill: var(--xh-_chart-on-series);
+    font-weight: var(--xh-font-weight-medium);
+  }
+
+  /* —— 环形中心：叠在视口上，圆心与内径由几何给出；文字不超出内圈 —— */
+  /* 首次出现：外侧标签等扫开的边缘到了才淡入，连接层写入它占入场时长的比例，乘上入场时长就是延迟；
+     环形中心等整圈扫完再淡入 */
+  .xh-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));
+  }
+
+  .xh-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);
+  }
+
+  .xh-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%;
+  }
+
+  .xh-scope-pie-chart[data-part='center'][data-placement='top'] {
+    translate: -50% -100%;
+  }
+
+  .xh-scope-pie-chart[data-part='center'][hidden] {
+    display: none;
+  }
+
+  .xh-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;
+  }
+
+  .xh-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]) .xh-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]) .xh-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) {
+    .xh-scope-pie-chart[data-part='slice'] {
+      fill: Canvas;
+      stroke: CanvasText;
+      stroke-width: var(--xh-stroke-thin);
+    }
+
+    .xh-scope-pie-chart[data-part='slice-label'],
+    .xh-scope-pie-chart[data-part='slice-label'][data-xh-chart-slot] {
+      fill: CanvasText;
+    }
+
+    .xh-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);
+    }
+
+    .xh-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 {
+    .xh-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);
+    }
+
+    .xh-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;
+    }
+  }
+}