@xihan-ui/styles 3.1.0 → 4.0.0

package/dist/css/alert.css

@@ -0,0 +1,246 @@
+/*
+ * Copyright (c) 2021-Present XiHanFun and contributors.
+ * Licensed under the MIT License. See LICENSE in the project root for license information.
+ */
+
+/* 定义 alert 样式。 */
+
+/* Alert 独立皮肤同时传递引入关闭钮的动作控件配方；full bundle 递归去重。 */
+@import '../family/action-control.css';
+/* 淡出的关键帧由 family/motion.css 提供，本皮肤 @import 它，单独引入仍成立。 */
+@import '../family/motion.css';
+
+@layer xihan.motion {
+  /* 关闭时收起占位：从连接层量下的整块高度收到 0，内缩与描边一起收掉 */
+  @keyframes xh-alert-collapse {
+    from {
+      block-size: var(--xh-_alert-exit-block-size);
+    }
+
+    to {
+      block-size: 0;
+      padding-block: 0;
+      border-block-width: 0;
+    }
+  }
+}
+
+@layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  .xh-scope-alert {
+    --xh-alert-skin: 1;
+  }
+
+  /* 提示本体是一块语气淡底面（淡底形态：透明边位 + 语气 12% 淡底、无影），语气由底色与图标表达；
+     标题与正文仍取正文色，彩色只落在底与图标上，不让整段文字变色抢走层级。 */
+  .xh-scope-alert[data-part='root'] {
+    /* 作者塞进指示符槽的图标与皮肤画的兜底字形同一把尺：Feedback 指示符统一 md 档 */
+    --xh-icon-size: var(--xh-alert-icon-size, var(--xh-glyph-size-md));
+
+    display: flex;
+    align-items: flex-start;
+    /* 指示符盒自带 --xh-space-1 内衬：与间距合起来，字形到正文 12px，与 Notification 同一个距离 */
+    gap: var(--xh-alert-gap, var(--xh-space-2));
+    padding-block: var(--xh-alert-py, var(--xh-space-2));
+    padding-inline: var(--xh-alert-px, var(--xh-surface-px-sm));
+    border: var(--xh-stroke-thin) solid var(--xh-alert-border, transparent);
+    border-radius: var(--xh-alert-radius, var(--xh-shape-control));
+    background: var(--xh-alert-bg, var(--xh-_tone-subtle, var(--xh-bg-subtle)));
+    box-shadow: var(--xh-alert-shadow, none);
+    color: var(--xh-alert-fg, var(--xh-fg-default));
+    font-size: var(--xh-alert-font-size, var(--xh-text-body-size));
+    line-height: var(--xh-alert-leading, var(--xh-leading-normal));
+  }
+
+  /* 横幅：页面顶部的通栏，贴着页面或容器的边铺满整行。面本身就是语气淡底，不另画边；贴边铺满的栏不取圆角：
+     圆了会在两个角露出底下的页面。面与语气规则与页内提示相同，横幅不换底色 */
+  .xh-scope-alert[data-part='root'][data-banner] {
+    inline-size: 100%;
+    border-block-start-width: 0;
+    border-inline-width: 0;
+    border-radius: 0;
+  }
+
+  /* 关闭的退场：先淡出，再把占位收起——下面的内容跟着一路平移上来，而不是整块跳上来。
+     收占位接在淡出之后（延迟一个 exit），播完连接层才写 hidden。收起态常挂 hidden，这条只在退场途中命中；
+     减弱动效下收占位瞬时完成，淡出照常 */
+  .xh-scope-alert[data-part='root'][data-state='closed'] {
+    box-sizing: border-box;
+    overflow: hidden;
+    animation:
+      xh-fade-out var(--xh-motion-duration-exit) var(--xh-motion-ease-exit) forwards,
+      xh-alert-collapse var(--xh-motion-duration-collapse) var(--xh-motion-ease-exit) var(--xh-motion-duration-exit) forwards;
+  }
+
+  /* 收起态连接层给的是 hidden 属性，而上面声明了 display——
+     漏掉这条，关掉的提示还会一直摊在页面上 */
+  .xh-scope-alert[data-part='root'][hidden] {
+    display: none;
+  }
+
+  .xh-scope-alert[data-part='indicator'] {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    flex: none;
+    padding: var(--xh-alert-indicator-p, var(--xh-space-1));
+    color: var(--xh-alert-indicator-fg, var(--xh-_tone-fg));
+  }
+
+  /* 必需的文本列：标题与说明在这里排成一列。 */
+  .xh-scope-alert[data-part='content'] {
+    display: flex;
+    /* 伸缩基准取 0 而不是 auto：取 auto 时基准是这一列的 max-content——
+       一段长说明就能把基准撑到比整行还宽，root 那条换行随即把图标、文本列、叉拆成三行 */
+    flex: 1 1 0;
+    flex-direction: column;
+    gap: var(--xh-alert-content-gap, var(--xh-space-1));
+    min-inline-size: 0;
+  }
+
+  /* 列里的两段文字不再参与 root 那一行的伸缩：宽度由列自己给 */
+  .xh-scope-alert[data-part='content'] [data-part='title']:where(.xh-scope-alert),
+  .xh-scope-alert[data-part='content'] [data-part='description']:where(.xh-scope-alert) {
+    flex: none;
+  }
+
+  /* 操作与关闭入口都留在尾端，不把说明挤到下一行。 */
+  .xh-scope-alert[data-part='action'] {
+    display: flex;
+    flex: none;
+    align-items: center;
+    align-self: center;
+    gap: var(--xh-alert-action-gap, var(--xh-space-2));
+    margin-inline-start: auto;
+  }
+
+  /* 标题与说明摞成一列，占满 root 剩下的横向空间，
+     关闭按钮才推得到行尾 */
+  .xh-scope-alert[data-part='title'],
+  .xh-scope-alert[data-part='description'] {
+    margin: 0;
+    min-inline-size: 0;
+  }
+
+  .xh-scope-alert[data-part='title'] {
+    flex: none;
+    color: var(--xh-alert-title-fg, var(--xh-fg-default));
+    font-size: var(--xh-alert-title-font-size, var(--xh-text-heading-3-size));
+    font-weight: var(--xh-alert-title-font-weight, var(--xh-text-heading-3-weight));
+    line-height: var(--xh-alert-title-leading, var(--xh-leading-tight));
+  }
+
+  .xh-scope-alert[data-part='description'] {
+    flex: none;
+    color: var(--xh-alert-description-fg, var(--xh-fg-muted));
+    font-size: var(--xh-alert-description-font-size, var(--xh-text-secondary-size));
+  }
+
+  /* 没写标题时说明自己占满这一行，否则它会挤在标题旁边 */
+  .xh-scope-alert[data-part='title']:empty {
+    display: none;
+  }
+
+  /* 关闭钮是只有字形的离散动作钮：盒几何、悬停 / 按下与按压、粗指针热区、焦点环、禁用面全由
+     Action Control 的 icon ghost 档给（连接层投 sm：与此前 --xh-control-h-sm 同尺寸），组件只映射既有使用者槽。
+     静息透明；提示本体是语气淡底（12%），叉的悬停 / 按下沿语气淡底再升一档、两档（20% / 28%）。
+     closable=false 时连接层同时给 hidden 与 disabled / data-disabled，家族按后者收掉反馈 */
+  .xh-scope-alert[data-part='close-trigger'] {
+    --xh-action-visual-size: var(--xh-alert-close-size, var(--xh-_action-profile-visual-size));
+    --xh-action-min-inline-size: var(--xh-alert-close-size, var(--xh-_action-profile-visual-size));
+    --xh-action-radius: var(--xh-alert-close-radius, var(--xh-shape-control));
+    --xh-action-bg-hover: var(--xh-alert-close-bg-hover, var(--xh-_tone-subtle-hover, var(--xh-_action-variant-bg-hover)));
+    --xh-action-bg-pressed: var(--xh-alert-close-bg-active, var(--xh-_tone-subtle-active, var(--xh-_action-variant-bg-pressed)));
+    --xh-action-fg-rest: var(--xh-alert-close-fg, var(--xh-fg-muted));
+    --xh-action-fg-hover: var(--xh-alert-close-fg-hover, var(--xh-fg-default));
+    --xh-action-fg-pressed: var(--xh-alert-close-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;
+    /* 叉的字形按钮档取值（sm → 16px），与 root 上给指示符的 md 档分开 */
+    --xh-icon-size: var(--xh-alert-icon-size, var(--xh-_action-profile-glyph-size));
+
+    flex: none;
+    align-self: center;
+    border-width: 0;
+  }
+
+  /* closable=false 时连接层同时给了 hidden 与 disabled，这条是它真正收起的那一半；
+     家族那条 display 会把 UA 的 [hidden]{display:none} 盖掉 */
+  .xh-scope-alert[data-part='close-trigger'][hidden] {
+    display: none;
+  }
+
+  /* 没写内容就由皮肤画兜底字形；作者往部件里塞了自己的图形，这几条即不命中 */
+  .xh-scope-alert[data-part='close-trigger']:empty::before {
+    content: '';
+    display: inline-block;
+    inline-size: var(--xh-icon-size, var(--xh-glyph-size-text));
+    block-size: var(--xh-icon-size, var(--xh-glyph-size-text));
+    vertical-align: var(--xh-glyph-baseline-shift);
+    background-color: currentColor;
+    -webkit-mask: var(--xh-glyph-mark-close) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-close) center / contain no-repeat;
+  }
+
+  /*
+   * 打印：底色被丢掉，六档语气那层淡底一起没了，剩下的描边兑了 40% 的底色，在纸上几乎印不出。
+   * 描边换成正文色把这块提示框出来，标题加重一档——纸上分得出「这是一段提示」，
+   * 靠的是框与字重这两条无色通道，不是那层底。
+   * 关闭钮在纸上按不动，一并收起。
+   */
+  @media print {
+    .xh-scope-alert[data-part='root'] {
+      border-color: currentColor;
+    }
+
+    .xh-scope-alert[data-part='title'] {
+      font-weight: var(--xh-font-weight-bold);
+    }
+
+    .xh-scope-alert[data-part='close-trigger'] {
+      display: none;
+    }
+  }
+
+  @media (forced-colors: active) {
+    .xh-scope-alert[data-part='root'] {
+      border-color: CanvasText;
+    }
+  }
+
+  /* 声明过任何 display 就盖掉了 UA 的 [hidden]{display:none}，收起态得自己还回去。
+     写在文件末尾：兜底必须排在该部件所有 display 声明之后 */
+  .xh-scope-alert[data-part='indicator'][hidden] {
+    display: none;
+  }
+
+  .xh-scope-alert[data-part='content'][hidden] {
+    display: none;
+  }
+
+  .xh-scope-alert[data-part='action'][hidden] {
+    display: none;
+  }
+
+  @media (forced-colors: active) {
+    /* 兜底字形是 mask 挖出来的一块底色，这一档里底色被系统换成 Canvas，字形跟着消失。
+       字形退出强制换色、直接写系统色（不能取 currentColor：退出强制换色的伪元素读到的是被系统换掉之前的作者色）：
+       按钮面上取 ButtonText，悬停与按下时家族把按钮涂成 Highlight、字形换 HighlightText；
+       禁用取 GrayText */
+    .xh-scope-alert[data-part='close-trigger']:empty::before {
+      forced-color-adjust: none;
+      background-color: ButtonText;
+    }
+
+    .xh-scope-alert[data-part='close-trigger']:not([data-disabled]):not([data-loading]):is(:hover, :active, [data-pressed]):empty::before {
+      background-color: HighlightText;
+    }
+
+    .xh-scope-alert[data-part='close-trigger'][data-disabled]:empty::before {
+      background-color: GrayText;
+    }
+  }
+}

package/dist/css/anchor.css

@@ -0,0 +1,252 @@
+/*
+ * Copyright (c) 2021-Present XiHanFun and contributors.
+ * Licensed under the MIT License. See LICENSE in the project root for license information.
+ */
+
+/* 定义 anchor 样式。 */
+
+/* 链接归 Collection Item 导航当前（nav 语境）：面、字色、字重、光标与按压时间线由家族配方按投影的家族角色给，
+   本皮肤只映射桥接槽。2px 指示线由本皮肤画：目录里放了 indicator 部件就由部件在轨道上滑动，
+   没放则当前那一节的链接自画一条静态线 */
+@import '../family/collection-item.css';
+
+@layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  .xh-scope-anchor {
+    --xh-anchor-skin: 1;
+  }
+
+  /* 根节点是 nav 地标，不参与排版：整条目录的布局全在 list 上，
+     这里不给 display，UA 的 [hidden]{display:none} 就仍然压得住 */
+  .xh-scope-anchor[data-part='root'] {
+    /* 尺寸档只换这两个私有槽，链接从 root 继承它们，换档不必给每个部件各写一条选择器 */
+    --xh-_anchor-font-size: var(--xh-control-font-md);
+    --xh-_anchor-link-px: var(--xh-control-px-md);
+    /* 当前那一节的指示条与文字随语气走。没写 data-tone 时这两个槽都没被声明，退回品牌色。
+       指示条是装饰性的色条，取柔和档；文字要压在普通背景上读，取语气的文字档——
+       导航当前页缺省是 --xh-fg-brand，与指示条同一档主色。
+       聚焦环不在其列，它恒是 --xh-ring-focus */
+    --xh-_anchor-accent: var(--xh-_tone-soft, var(--xh-fg-brand));
+    --xh-_anchor-accent-text: var(--xh-_tone-fg, var(--xh-fg-brand));
+
+    color: var(--xh-anchor-fg, var(--xh-fg-muted));
+    font-size: var(--xh-anchor-font-size, var(--xh-_anchor-font-size));
+    line-height: var(--xh-anchor-leading, var(--xh-leading-normal));
+  }
+
+  /* —— 尺寸 —— */
+  /* 缺省档写在上面的基础规则里；链接的内边距三档都走控件内边距那把尺 */
+  .xh-scope-anchor[data-part='root'][data-size='sm'] {
+    --xh-_anchor-font-size: var(--xh-control-font-sm);
+    --xh-_anchor-link-px: var(--xh-control-px-sm);
+  }
+
+  .xh-scope-anchor[data-part='root'][data-size='lg'] {
+    --xh-_anchor-font-size: var(--xh-control-font-lg);
+    --xh-_anchor-link-px: var(--xh-control-px-lg);
+  }
+
+  /* 指示条的定位参照系（它是 absolute，量出来的偏移就是相对这里的）。
+     ul 的项目符号与内外边距是 UA 给的，库里没有全局 preflight，只能在这儿自己抹平 */
+  .xh-scope-anchor[data-part='list'] {
+    position: relative;
+    display: flex;
+    flex-direction: column;
+    gap: var(--xh-anchor-gap, var(--xh-space-1));
+    margin: 0;
+    padding: 0;
+    /* 起始缘的那条轨道：指示条就在它上面滑 */
+    border-inline-start: var(--xh-stroke-thin) solid var(--xh-anchor-track, var(--xh-border-default));
+    list-style: none;
+  }
+
+  .xh-scope-anchor[data-part='list'][hidden] {
+    display: none;
+  }
+
+  /* 横排：轨道从起始缘挪到底边，条目改成一行 */
+  .xh-scope-anchor[data-part='list'][data-orientation='horizontal'] {
+    flex-direction: row;
+    align-items: center;
+    gap: var(--xh-anchor-gap-horizontal, var(--xh-space-2));
+    border-inline-start: 0;
+    border-block-end: var(--xh-stroke-thin) solid var(--xh-anchor-track, var(--xh-border-default));
+  }
+
+  .xh-scope-anchor[data-part='item'] {
+    display: flex;
+    /* 库里没有全局 preflight，列表项的外边距在这里自己抹平 */
+    margin: 0;
+    /* 允许被压缩，链接内部的省略号才有生效的余地 */
+    min-inline-size: 0;
+  }
+
+  .xh-scope-anchor[data-part='item'][hidden] {
+    display: none;
+  }
+
+  /* 链接的几何、字号与面全经家族桥接槽：静息 muted / regular，悬停走白底承载 hover 100 + default 字，
+     按下 pressed 200 只换面；当前那一节（导航当前页）brand-strong 字色（随语气的
+     --xh-_anchor-accent-text）+ medium 字重都跟着变，2px 指示线放了 indicator 部件由部件滑动、没放则由
+     下面的静态线规则画在当前链接自己身上。本条 (0,2,0) 压过家族基础块 (0,1,0)，不能再写 color / background。
+     position: relative 是静态线的定位参照 */
+  .xh-scope-anchor[data-part='link'] {
+    --xh-collection-block-padding: var(--xh-anchor-link-py, var(--xh-space-1));
+    --xh-collection-inline-padding: var(--xh-anchor-link-px, var(--xh-_anchor-link-px));
+    --xh-collection-radius: var(--xh-anchor-link-radius, var(--xh-shape-control));
+    --xh-collection-font-size: var(--xh-anchor-font-size, var(--xh-_anchor-font-size));
+    --xh-collection-fg-rest: var(--xh-anchor-fg, var(--xh-fg-muted));
+    --xh-collection-bg-hover: var(--xh-anchor-link-bg-hover, var(--xh-bg-subtle));
+    --xh-collection-fg-hover: var(--xh-anchor-link-fg-hover, var(--xh-fg-default));
+    --xh-collection-bg-pressed: var(--xh-anchor-link-bg-pressed, var(--xh-bg-subtle-hover));
+    --xh-collection-fg-current: var(--xh-anchor-link-fg-current, var(--xh-_anchor-accent-text));
+    --xh-collection-font-weight-current: var(--xh-anchor-link-font-weight-current, var(--xh-font-weight-medium));
+
+    position: relative;
+    display: inline-flex;
+    align-items: center;
+    /* 一节的标题可能很长，压不住会把整列撑开 */
+    max-inline-size: var(--xh-anchor-link-max-w, var(--xh-nav-link-max-w));
+    /* 行高随 root 的行距槽：家族基础块给条目写了 leading-normal，这里接回 root 那一支 */
+    line-height: var(--xh-anchor-leading, var(--xh-leading-normal));
+    white-space: nowrap;
+    text-decoration: none;
+    text-overflow: ellipsis;
+    overflow: hidden;
+  }
+
+  .xh-scope-anchor[data-part='link'][hidden] {
+    display: none;
+  }
+
+  /* 链接里另有图标时，省略号只裁这一段文字 */
+  .xh-scope-anchor[data-part='link-text'] {
+    min-inline-size: 0;
+    white-space: nowrap;
+    text-overflow: ellipsis;
+    overflow: hidden;
+  }
+
+  /* 当前链接的四个几何量由机器量好、连接层写成私有槽 --xh-_anchor-indicator-x / -y / -w / -h
+     （它量得到，样式表量不到）；这里按排布取主轴那两支，落点交给 translate（只走合成），
+     另管交叉轴的贴边与粗细，以及长什么样。它是可选部件——不渲染它时，
+     当前那一节的链接自画一条同规格的静态线（见下） */
+  .xh-scope-anchor[data-part='indicator'] {
+    /* 还没量到时的落点，量到即被机器写的私有槽盖过 */
+    --xh-_anchor-indicator-x: 0;
+    --xh-_anchor-indicator-y: 0;
+    --xh-_anchor-indicator-w: 0;
+    --xh-_anchor-indicator-h: 0;
+    --xh-_anchor-indicator-stretch: 0;
+
+    position: absolute;
+    display: block;
+    /* 指示条也是列表项，宿主给 li 的外边距会把绝对定位的它推离条目 */
+    margin: 0;
+    inset-block-start: 0;
+    inset-inline-start: calc(var(--xh-anchor-indicator-thickness, var(--xh-stroke-thick)) * -1);
+    inline-size: var(--xh-anchor-indicator-thickness, var(--xh-stroke-thick));
+    block-size: var(--xh-_anchor-indicator-h);
+    border-radius: var(--xh-anchor-indicator-radius, var(--xh-shape-pill));
+    background: var(--xh-anchor-indicator-color, var(--xh-_anchor-accent));
+    translate: 0 var(--xh-_anchor-indicator-y);
+    transition:
+      translate var(--xh-motion-duration-move) var(--xh-motion-ease-continuous),
+      block-size var(--xh-motion-duration-move) var(--xh-motion-ease-continuous);
+  }
+
+  /* display 会盖掉 hidden 属性的 UA 规则，无激活项时显式让位 */
+  .xh-scope-anchor[data-part='indicator'][hidden] {
+    display: none;
+  }
+
+  /* 横排：指示条改躺在底边的轨道上，交叉轴换成块轴 */
+  .xh-scope-anchor[data-part='indicator'][data-orientation='horizontal'] {
+    inset-block-start: auto;
+    inset-inline-start: 0;
+    inset-block-end: calc(var(--xh-anchor-indicator-thickness, var(--xh-stroke-thick)) * -1);
+    inline-size: var(--xh-_anchor-indicator-w);
+    block-size: var(--xh-anchor-indicator-thickness, var(--xh-stroke-thick));
+    translate: var(--xh-_anchor-indicator-x) 0;
+    transition:
+      translate var(--xh-motion-duration-move) var(--xh-motion-ease-continuous),
+      inline-size var(--xh-motion-duration-move) var(--xh-motion-ease-continuous);
+  }
+
+  /* translate 只认物理方向：RTL 下行首在右边，起始缘量出的距离往左推 */
+  .xh-scope-anchor[data-part='indicator'][data-orientation='horizontal']:dir(rtl) {
+    translate: calc(-1 * var(--xh-_anchor-indicator-x)) 0;
+  }
+
+  /* 首次落位与同一项的重量（窗口缩放、换上正式字体）直接到位，只有换项才滑：连接层在这一落点投影
+     data-instant。写在排布那几条之后，同一特异性按先后压过它们单写的过渡 */
+  .xh-scope-anchor[data-part='indicator'][data-instant] {
+    transition: none;
+  }
+
+  /* 液态档：两沿由弹簧逐帧推着走（连接层每一帧写好盒子），几何量不再补过渡；
+     被拉长时在另一个方向上压扁（竖排缺省压行向，横排压块向），表达体积守恒，拉长到目标的两倍时压到 --xh-motion-scale-squash */
+  :where([data-material='liquid']) .xh-scope-anchor[data-part='indicator'] {
+    --xh-_anchor-indicator-squash: max(var(--xh-motion-scale-squash), calc(1 - var(--xh-_anchor-indicator-stretch) * (1 - var(--xh-motion-scale-squash))));
+
+    scale: var(--xh-_anchor-indicator-squash) 1;
+    transition: none;
+  }
+
+  :where([data-material='liquid']) .xh-scope-anchor[data-part='indicator'][data-orientation='horizontal'] {
+    scale: 1 var(--xh-_anchor-indicator-squash);
+    transition: none;
+  }
+
+  /* 目录里没放 indicator 部件时，当前那一节的链接自画一条静态指示线（导航当前页）：
+     与 Tabs line 档同一取法，作者不必为了这条线多放一个部件。
+     线画在当前链接的 ::after 上，以链接盒为定位参照（上面已给 position: relative），
+     厚度 / 颜色 / 圆角与 indicator 部件读同一组槽与缺省——作者改一处，部件与静态线一起改。
+     不做动画：它随 data-current 在链接间跳，滑动只有部件做得到。
+     线贴在链接盒内的那条缘：链接为了省略号收着 overflow，画不到盒外；部件骑在 list 的轨道上（盒外一线宽），
+     两者同侧、差一线宽。主轴两端各退一格 --xh-space-1 避开链接的圆角（overflow 连圆角一起裁，贴满会被
+     切掉两个角），与家族 page 语境的起始侧指示条同一取法。嵌套目录里子级链接随自己的缩进走，部件则始终在
+     外层轨道上。
+     目录里一旦放了 indicator 部件，这条线就收起、位置交给部件滑动，不重复画两条：
+     由 list 按 :has 探一次，把私有槽写成 none，线的 content 读它；链接自己不必再各带一段 :has */
+  .xh-scope-anchor[data-part='list']:has(.xh-scope-anchor[data-part='indicator']) {
+    --xh-_anchor-static-line: none;
+  }
+
+  .xh-scope-anchor[data-part='link'][data-current]::after {
+    content: var(--xh-_anchor-static-line, '');
+    position: absolute;
+    pointer-events: none;
+    border-radius: var(--xh-anchor-indicator-radius, var(--xh-shape-pill));
+    background: var(--xh-anchor-indicator-color, var(--xh-_anchor-accent));
+  }
+
+  /* 竖排（缺省）：贴链接的行向起始缘（与 indicator 部件同一侧，rtl 随逻辑属性镜像） */
+  .xh-scope-anchor[data-part='list'][data-orientation='vertical']
+    .xh-scope-anchor[data-part='link'][data-current]::after {
+    inset-inline-start: 0;
+    inset-block: var(--xh-space-1);
+    inline-size: var(--xh-anchor-indicator-thickness, var(--xh-stroke-thick));
+  }
+
+  /* 横排：贴链接的块向末端（底边） */
+  .xh-scope-anchor[data-part='list'][data-orientation='horizontal']
+    .xh-scope-anchor[data-part='link'][data-current]::after {
+    inset-block-end: 0;
+    inset-inline: var(--xh-space-1);
+    block-size: var(--xh-anchor-indicator-thickness, var(--xh-stroke-thick));
+  }
+
+  @media (forced-colors: active) {
+    /* 指示条画的是一块纯底色，这一档里底色被统一换成 Canvas，条子整根消失，
+       "读到哪一节"就只剩链接自己的字重。换成系统高亮色画回来 */
+    .xh-scope-anchor[data-part='indicator'] {
+      background: Highlight;
+    }
+
+    /* 没放部件时当前链接自画的那条静态线同样是一块纯底色，同一档换成系统高亮色 */
+    .xh-scope-anchor[data-part='link'][data-current]::after {
+      background: Highlight;
+    }
+  }
+}