@xihan-ui/styles 3.1.0 → 4.0.0

package/dist/css/diff-view.css

@@ -0,0 +1,513 @@
+/*
+ * Copyright (c) 2021-Present XiHanFun and contributors.
+ * Licensed under the MIT License. See LICENSE in the project root for license information.
+ */
+
+/* 定义 diff view 样式。 */
+
+/* 共享关键帧由 family/motion.css 提供，本皮肤 @import 它，单独引入仍成立。 */
+@import '../family/motion.css';
+/* 独立皮肤同时传递引入折叠格按钮的动作控件配方；full bundle 递归去重。 */
+@import '../family/action-control.css';
+
+@layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  .xh-scope-diff-view {
+    --xh-diff-view-skin: 1;
+  }
+
+  /* 一张静态内容面：--xh-border-default 描边 + surface 底 + 无影（边界只由描边承担）；
+     头部、行号列与并排接缝的内部分隔线走另一支 --xh-diff-view-divider（subtle） */
+  .xh-scope-diff-view[data-part='root'] {
+    /* 作者塞进部件里的图标与皮肤画的兜底字形同一把尺：md 档，随 data-size 换档 */
+    --xh-icon-size: var(--xh-diff-view-icon-size, var(--xh-glyph-size-md));
+
+    /* 尺寸缺省档：不写 data-size 时的取值。三档都只写这三个私有槽，
+       公开槽留在读处当首选，作者在祖先上设的覆盖才赢得过档位声明 */
+    --xh-_diff-view-font-size: var(--xh-control-font-md);
+    --xh-_diff-view-px: var(--xh-space-3);
+    --xh-_diff-view-py: var(--xh-space-2);
+
+    display: block;
+    overflow: hidden;
+    border: var(--xh-stroke-thin) solid var(--xh-diff-view-border, var(--xh-border-default));
+    border-radius: var(--xh-diff-view-radius, var(--xh-shape-surface));
+    background: var(--xh-diff-view-bg, var(--xh-bg-surface));
+    box-shadow: var(--xh-diff-view-shadow, none);
+  }
+
+  /* 上面声明的 display 会盖掉 UA 的 [hidden]{display:none}，这里补回 */
+  .xh-scope-diff-view[data-part='root'][hidden] {
+    display: none;
+  }
+
+  .xh-scope-diff-view[data-part='header'] {
+    display: flex;
+    align-items: center;
+    gap: var(--xh-diff-view-header-gap, var(--xh-space-2));
+    padding-inline: var(--xh-diff-view-px, var(--xh-_diff-view-px));
+    padding-block: var(--xh-diff-view-py, var(--xh-_diff-view-py));
+    border-block-end: var(--xh-stroke-thin) solid var(--xh-diff-view-divider, var(--xh-border-subtle));
+    color: var(--xh-diff-view-header-fg, var(--xh-fg-muted));
+    font-family: var(--xh-diff-view-font, var(--xh-font-family-mono));
+    font-size: var(--xh-diff-view-header-font-size, var(--xh-text-secondary-size));
+  }
+
+  .xh-scope-diff-view[data-part='header'][hidden] {
+    display: none;
+  }
+
+  /* 增删统计整组顶到右侧：头部是 flex，自动外边距吃掉中间的空当。
+     第二个之后的不再顶，与前一个之间只留头部本来的间隙 */
+  .xh-scope-diff-view[data-part='summary'] {
+    margin-inline-start: auto;
+  }
+
+  .xh-scope-diff-view[data-part='summary'] ~ .xh-scope-diff-view[data-part='summary'] {
+    margin-inline-start: 0;
+  }
+
+  .xh-scope-diff-view[data-part='summary'][data-change='added'] {
+    color: var(--xh-diff-view-added-fg, var(--xh-diff-added-fg));
+  }
+
+  .xh-scope-diff-view[data-part='summary'][data-change='removed'] {
+    color: var(--xh-diff-view-removed-fg, var(--xh-diff-removed-fg));
+  }
+
+  /* 唯一的 Tab 停靠点；两轴都可能溢出 */
+  .xh-scope-diff-view[data-part='viewport'] {
+    overflow: auto;
+    max-block-size: var(--xh-diff-view-max-h, var(--xh-viewport-max-h));
+  }
+
+  .xh-scope-diff-view[data-part='body'] {
+    display: block;
+    font-family: var(--xh-diff-view-font, var(--xh-font-family-mono));
+    font-size: var(--xh-diff-view-font-size, var(--xh-_diff-view-font-size));
+    line-height: var(--xh-diff-view-line-height, var(--xh-text-code-leading));
+    min-inline-size: max-content;
+  }
+
+  .xh-scope-diff-view[data-part='body'][hidden] {
+    display: none;
+  }
+
+  /* 一行：行号与内容并排 */
+  .xh-scope-diff-view[data-part='row'],
+  .xh-scope-diff-view[data-part='gap'] {
+    display: flex;
+    min-block-size: var(--xh-diff-view-line-height, var(--xh-text-code-leading));
+  }
+
+  .xh-scope-diff-view[data-part='row'][hidden],
+  .xh-scope-diff-view[data-part='gap'][hidden] {
+    display: none;
+  }
+
+  /* 变更类型不只靠颜色：新增行画一条实心色条 */
+  .xh-scope-diff-view[data-part='row'][data-change='added'] {
+    background: var(--xh-diff-view-added-bg, var(--xh-diff-added-bg));
+    box-shadow: inset var(--xh-diff-view-change-bar, var(--xh-stroke-thick)) 0 0 0 var(--xh-diff-view-added-fg, var(--xh-diff-added-fg));
+  }
+
+  /* 删除行的色条改画斜纹：与新增行的实心条在灰度与高对比度下也分得开。
+     45 度、1.5px 实 1.5px 空是纹理几何，不是设计尺度上的档位 */
+  .xh-scope-diff-view[data-part='row'][data-change='removed'] {
+    background:
+      repeating-linear-gradient(
+          45deg,
+          var(--xh-diff-view-removed-fg, var(--xh-diff-removed-fg)) 0,
+          var(--xh-diff-view-removed-fg, var(--xh-diff-removed-fg)) 1.5px,
+          transparent 1.5px,
+          transparent 3px
+        )
+        left / var(--xh-diff-view-change-bar, var(--xh-stroke-thick)) 100% no-repeat,
+      var(--xh-diff-view-removed-bg, var(--xh-diff-removed-bg));
+  }
+
+  /* 点开折叠格才露出来的那几行播一次入场；收起是硬切，不占一段退场窗口 */
+  .xh-scope-diff-view[data-part='row'][data-revealed] {
+    animation: xh-drop-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter-strong);
+  }
+
+  /* 行号是画上去的不是写上去的：复制差异不带它，读屏也不逐行念数字 */
+  .xh-scope-diff-view[data-part='line-number'] {
+    display: block;
+    box-sizing: content-box;
+    flex: 0 0 auto;
+    padding-inline: var(--xh-diff-view-px, var(--xh-_diff-view-px));
+    border-inline-end: var(--xh-stroke-thin) solid var(--xh-diff-view-divider, var(--xh-border-subtle));
+    color: var(--xh-diff-view-number-fg, var(--xh-fg-subtle));
+    inline-size: var(--xh-diff-view-gutter, 4ch);
+    text-align: end;
+    user-select: none;
+  }
+
+  .xh-scope-diff-view[data-part='line-number']::before {
+    content: attr(data-line-number);
+  }
+
+  .xh-scope-diff-view[data-part='line-number'][hidden] {
+    display: none;
+  }
+
+  /* 行号跟着行的变更类型走：一眼扫下来数字本身就分出了增删 */
+  .xh-scope-diff-view[data-part='line-number'][data-change='added'] {
+    color: var(--xh-diff-view-added-fg, var(--xh-diff-added-fg));
+  }
+
+  .xh-scope-diff-view[data-part='line-number'][data-change='removed'] {
+    color: var(--xh-diff-view-removed-fg, var(--xh-diff-removed-fg));
+  }
+
+  /* 窄档的并排视图：一行的两侧改成上下两段，旧行在上、新行在下。
+     行由横排 flex 换成两列栅格——行号一列、正文一列，一行里的四个格按 DOM 次序
+     自然落成两行，正文列因此只按单侧的最长行撑宽，不再是两侧之和 */
+  .xh-scope-diff-view[data-part='root'][data-view='split'] [data-part='row']:where(.xh-scope-diff-view):not([hidden]) {
+    display: grid;
+    grid-template-columns: auto minmax(0, 1fr);
+  }
+
+  /* white-space: pre 保留缩进；每一侧各占一半宽 */
+  .xh-scope-diff-view[data-part='line-content'] {
+    display: block;
+    flex: 1 1 0;
+    min-inline-size: 0;
+    padding-inline-end: var(--xh-diff-view-px, var(--xh-_diff-view-px));
+    white-space: pre;
+  }
+
+  .xh-scope-diff-view[data-part='line-content'][hidden] {
+    display: none;
+  }
+
+  .xh-scope-diff-view[data-part='line-content'][data-change='added'] {
+    color: var(--xh-diff-view-added-fg, var(--xh-diff-added-fg));
+  }
+
+  .xh-scope-diff-view[data-part='line-content'][data-change='removed'] {
+    color: var(--xh-diff-view-removed-fg, var(--xh-diff-removed-fg));
+  }
+
+  /* 并排视图里空的那一侧只有底色，没有内容 */
+  .xh-scope-diff-view[data-part='line-content'][data-empty] {
+    background: var(--xh-diff-view-empty-bg, var(--xh-bg-subtle));
+  }
+
+  /* 开了换行：pre-wrap 仍保留缩进与连续空白，只是允许行尾折下来；
+     anywhere 让没有空格的长串（url、base64）也能断 */
+  .xh-scope-diff-view[data-part='root'][data-wrap] [data-part='line-content']:where(.xh-scope-diff-view) {
+    white-space: pre-wrap;
+    overflow-wrap: anywhere;
+  }
+
+  /* 正文原本按最长行撑宽，不解除就折不下来 */
+  .xh-scope-diff-view[data-part='root'][data-wrap] [data-part='body']:where(.xh-scope-diff-view) {
+    min-inline-size: 0;
+  }
+
+  /* 变更类型的读屏文字：视觉隐藏，不能 display:none——那样读屏就取不到它了。
+     变更不该只靠颜色传达 */
+  .xh-scope-diff-view[data-part='change-label'] {
+    position: absolute;
+    inline-size: 1px;
+    block-size: 1px;
+    padding: 0;
+    margin: -1px;
+    border: 0;
+    overflow: hidden;
+    clip-path: inset(50%);
+    white-space: nowrap;
+  }
+
+  /* 词级片段：只有真正动过的那几段上底色，其余段落是纯包裹。
+     不给内衬——等宽列要逐字对齐，多一像素整份差异就错位 */
+  .xh-scope-diff-view[data-part='inline-change'][data-change] {
+    border-radius: var(--xh-diff-view-inline-change-radius, var(--xh-shape-inset));
+    /* 片段跨行时两半各自收边，否则圆角只画在整段的首尾。两条都写：WebKit 只认带前缀那条 */
+    -webkit-box-decoration-break: clone;
+    box-decoration-break: clone;
+  }
+
+  .xh-scope-diff-view[data-part='inline-change'][data-change='added'] {
+    background: color-mix(in oklab, var(--xh-diff-view-added-fg, var(--xh-diff-added-fg)) 18%, transparent);
+  }
+
+  .xh-scope-diff-view[data-part='inline-change'][data-change='removed'] {
+    background: color-mix(in oklab, var(--xh-diff-view-removed-fg, var(--xh-diff-removed-fg)) 18%, transparent);
+  }
+
+  .xh-scope-diff-view[data-part='token'][data-kind='comment'] {
+    color: var(--xh-diff-view-comment-fg, var(--xh-fg-muted));
+    font-style: italic;
+  }
+
+  .xh-scope-diff-view[data-part='token'][data-kind='string'] {
+    color: var(--xh-diff-view-string-fg, var(--xh-syntax-string));
+  }
+
+  .xh-scope-diff-view[data-part='token'][data-kind='number'] {
+    color: var(--xh-diff-view-number-token-fg, var(--xh-syntax-number));
+  }
+
+  .xh-scope-diff-view[data-part='token'][data-kind='keyword'] {
+    color: var(--xh-diff-view-keyword-fg, var(--xh-syntax-keyword));
+    font-weight: var(--xh-diff-view-keyword-weight, var(--xh-font-weight-semibold));
+  }
+
+  .xh-scope-diff-view[data-part='token'][data-kind='punctuation'] {
+    color: var(--xh-diff-view-punctuation-fg, var(--xh-fg-subtle));
+  }
+
+  /* 折起来的那一行：整行都是展开按钮。行是淡底承载面，向按钮下发 hover 200 → pressed 300 */
+  .xh-scope-diff-view[data-part='gap'] {
+    --xh-action-host-bg-hover: var(--xh-bg-subtle-hover);
+    --xh-action-host-bg-pressed: var(--xh-bg-subtle-active);
+
+    background: var(--xh-diff-view-gap-bg, var(--xh-bg-subtle));
+  }
+
+  .xh-scope-diff-view[data-part='gap-cell'] {
+    display: block;
+    flex: 1 1 auto;
+  }
+
+  .xh-scope-diff-view[data-part='gap-cell'][hidden] {
+    display: none;
+  }
+
+  /* 展开按钮铺满折叠格，盒型、悬停与按下面由 Action Control 的 disclosure-trigger 档给（ghost 形态，
+     按下只换面不缩放）；这里只把使用者槽映射到桥接槽：圆角归零贴住格边、纵向内衬归零、
+     高度锚在代码行高上让折叠格与相邻代码行同高，字号跟着正文走 */
+  .xh-scope-diff-view[data-part='gap-trigger'] {
+    --xh-action-radius: 0;
+    --xh-action-visual-size: var(--xh-diff-view-line-height, var(--xh-text-code-leading));
+    --xh-action-padding-inline: var(--xh-diff-view-px, var(--xh-_diff-view-px));
+    --xh-action-padding-block: 0;
+    --xh-action-font-size: var(--xh-diff-view-font-size, var(--xh-_diff-view-font-size));
+    --xh-action-fg-rest: var(--xh-diff-view-gap-fg, var(--xh-fg-muted));
+    --xh-action-bg-hover: var(--xh-diff-view-gap-bg-hover, var(--xh-_action-variant-bg-hover));
+
+    border-width: 0;
+  }
+
+  .xh-scope-diff-view[data-part='gap-trigger'][hidden] {
+    display: none;
+  }
+
+  .xh-scope-diff-view[data-part='empty'] {
+    display: block;
+    padding-inline: var(--xh-diff-view-px, var(--xh-_diff-view-px));
+    padding-block: var(--xh-diff-view-py, var(--xh-_diff-view-py));
+    color: var(--xh-diff-view-empty-fg, var(--xh-fg-muted));
+    font-size: var(--xh-diff-view-header-font-size, var(--xh-text-secondary-size));
+  }
+
+  .xh-scope-diff-view[data-part='empty'][hidden] {
+    display: none;
+  }
+
+  /* 截断提示条：这份差异不完整。它比 empty 显眼一档——空差异只是没东西可看，
+     被砍过的差异看着像完整的，读的人不主动往这儿看就不会知道 */
+  .xh-scope-diff-view[data-part='truncation'] {
+    display: flex;
+    align-items: center;
+    gap: var(--xh-diff-view-truncation-gap, var(--xh-space-2));
+    padding-inline: var(--xh-diff-view-px, var(--xh-_diff-view-px));
+    padding-block: var(--xh-diff-view-py, var(--xh-_diff-view-py));
+    border-block-start: var(--xh-stroke-thin) solid
+      var(--xh-diff-view-truncation-border, var(--xh-border-subtle));
+    background: var(--xh-diff-view-truncation-bg,
+      color-mix(in oklab, var(--xh-fg-warning) 12%, var(--xh-bg-surface)));
+    color: var(--xh-diff-view-truncation-fg,
+      color-mix(in oklab, var(--xh-fg-warning) 60%, var(--xh-fg-default)));
+    font-size: var(--xh-diff-view-header-font-size, var(--xh-text-secondary-size));
+  }
+
+  .xh-scope-diff-view[data-part='truncation'][hidden] {
+    display: none;
+  }
+
+  /* 提示条的文字由适配器填，所以字形不走 :empty 那条兜底路径，恒画一枚；
+     不要它就把 --xh-glyph-mark-warning 在子树上置 none */
+  .xh-scope-diff-view[data-part='truncation']::before {
+    content: '';
+    flex: none;
+    display: inline-block;
+    inline-size: var(--xh-icon-size, var(--xh-glyph-size-md));
+    block-size: var(--xh-icon-size, var(--xh-glyph-size-md));
+    vertical-align: var(--xh-glyph-baseline-shift);
+    background-color: currentColor;
+    -webkit-mask: var(--xh-glyph-mark-warning) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-warning) center / contain no-repeat;
+  }
+
+  /* 行评论：每格正文让出一列（一行高的正方格）给评论钮，没有钮的空侧也让，两侧代码才对得齐 */
+  .xh-scope-diff-view[data-part='root'][data-commentable] {
+    --xh-_diff-view-comment-col: var(--xh-diff-view-comment-col, var(--xh-diff-view-line-height, var(--xh-text-code-leading)));
+  }
+
+  .xh-scope-diff-view[data-part='root'][data-commentable] [data-part='line-content']:where(.xh-scope-diff-view) {
+    position: relative;
+    padding-inline-start: var(--xh-_diff-view-comment-col);
+  }
+
+  /* 评论钮接 Action Control icon 档、ghost 形态，边长压到一行高 */
+  .xh-scope-diff-view[data-part='comment-trigger'] {
+    --xh-action-visual-size: var(--xh-_diff-view-comment-col);
+    --xh-action-min-inline-size: var(--xh-_diff-view-comment-col);
+    --xh-action-radius: var(--xh-diff-view-comment-trigger-radius, var(--xh-shape-control));
+    --xh-action-fg-rest: var(--xh-diff-view-comment-trigger-fg, var(--xh-fg-muted));
+    --xh-icon-size: var(--xh-diff-view-comment-trigger-icon-size, var(--xh-glyph-size-sm));
+
+    position: absolute;
+    inset-block-start: 0;
+    inset-inline-start: 0;
+    block-size: var(--xh-_diff-view-comment-col);
+  }
+
+  .xh-scope-diff-view[data-part='comment-trigger'][hidden] {
+    display: none;
+  }
+
+  .xh-scope-diff-view[data-part='comment-trigger']::before {
+    content: '';
+    display: block;
+    inline-size: var(--xh-icon-size, var(--xh-glyph-size-sm));
+    block-size: var(--xh-icon-size, var(--xh-glyph-size-sm));
+    background-color: currentColor;
+    -webkit-mask: var(--xh-glyph-mark-plus) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-plus) center / contain no-repeat;
+  }
+
+  /* 指针设备上平时透明（仍可聚焦），悬停到这一行或焦点进了视口才显出来；触屏上常显 */
+  @media (hover: hover) and (pointer: fine) {
+    .xh-scope-diff-view[data-part='comment-trigger'] {
+      --xh-action-opacity-rest: 0;
+    }
+
+    .xh-scope-diff-view[data-part='row']:hover [data-part='comment-trigger']:where(.xh-scope-diff-view),
+    .xh-scope-diff-view[data-part='viewport']:focus-within [data-part='comment-trigger']:where(.xh-scope-diff-view) {
+      --xh-action-opacity-rest: 1;
+    }
+  }
+
+  /* 挂在正文格里、代码下方的评论：一张静态内容面，文字按正文排，不随代码的变更色 */
+  .xh-scope-diff-view[data-part='comment-thread'] {
+    display: block;
+    box-sizing: border-box;
+    max-inline-size: var(--xh-diff-view-comment-thread-max-w, var(--xh-measure-prose));
+    margin-block: var(--xh-diff-view-comment-thread-my, var(--xh-space-2));
+    padding: var(--xh-diff-view-comment-thread-p, var(--xh-space-3));
+    border: var(--xh-stroke-thin) solid var(--xh-diff-view-comment-thread-border, var(--xh-border-default));
+    border-radius: var(--xh-diff-view-comment-thread-radius, var(--xh-shape-surface));
+    background: var(--xh-diff-view-comment-thread-bg, var(--xh-bg-surface));
+    color: var(--xh-diff-view-comment-thread-fg, var(--xh-fg-default));
+    white-space: normal;
+  }
+
+  .xh-scope-diff-view[data-part='comment-thread'][hidden] {
+    display: none;
+  }
+
+  /* 尺寸档改字号、内衬与图标档 */
+  .xh-scope-diff-view[data-part='root'][data-size='sm'] {
+    --xh-icon-size: var(--xh-diff-view-icon-size, var(--xh-glyph-size-sm));
+    --xh-_diff-view-font-size: var(--xh-control-font-sm);
+    --xh-_diff-view-px: var(--xh-space-2);
+    --xh-_diff-view-py: var(--xh-space-1);
+  }
+
+  .xh-scope-diff-view[data-part='root'][data-size='md'] {
+    --xh-_diff-view-font-size: var(--xh-control-font-md);
+    --xh-_diff-view-px: var(--xh-space-3);
+    --xh-_diff-view-py: var(--xh-space-2);
+  }
+
+  .xh-scope-diff-view[data-part='root'][data-size='lg'] {
+    --xh-icon-size: var(--xh-diff-view-icon-size, var(--xh-glyph-size-lg));
+    --xh-_diff-view-font-size: var(--xh-control-font-lg);
+    --xh-_diff-view-px: var(--xh-space-4);
+    --xh-_diff-view-py: var(--xh-space-3);
+  }
+
+  /* 宽档：视口放得下两列，并排视图回到一行两侧 */
+  @media (min-width: 1024px) {
+    .xh-scope-diff-view[data-part='root'][data-view='split'] [data-part='row']:where(.xh-scope-diff-view):not([hidden]) {
+      display: flex;
+    }
+
+    /* 两列之间的接缝：新侧的行号槽再补一条左边线。只在并排时是接缝，
+       堆叠时它落在段首，成了一条与任何东西都不相接的竖线 */
+    .xh-scope-diff-view[data-part='root'][data-view='split'] [data-part='line-number'][data-side='new']:where(.xh-scope-diff-view) {
+      border-inline-start: var(--xh-stroke-thin) solid var(--xh-diff-view-divider, var(--xh-border-subtle));
+    }
+  }
+
+  /*
+   * 高对比档：新增行那条实心色条写在 box-shadow 上、删除行那条斜纹写在渐变上，
+   * 这一档里两者一起被丢弃，只剩两个被系统换成同色的底。
+   * 改画两圈内收的环，实线对新增、虚线对删除，两档在纯系统色下仍分得开。
+   * 用 outline 不用 border：行是横排 flex，加边会把行号与内容一起往里推，
+   * 没有变更的行不加边，同一屏上的行首就对不齐了。
+   */
+  @media (forced-colors: active) {
+    .xh-scope-diff-view[data-part='row'][data-change='added'] {
+      outline: var(--xh-stroke-thick) solid CanvasText;
+      outline-offset: calc(-1 * var(--xh-stroke-thick));
+    }
+
+    .xh-scope-diff-view[data-part='row'][data-change='removed'] {
+      outline: var(--xh-stroke-thick) dashed CanvasText;
+      outline-offset: calc(-1 * var(--xh-stroke-thick));
+    }
+  }
+
+  /*
+   * 打印：底色与背景图一起被丢掉，新增行那条实心色条写在 box-shadow 上、
+   * 删除行那条斜纹写在渐变上，两者在纸上都不出现，两种变更就此糊成一样。
+   * 与高对比档同一套办法：实线环对新增、虚线环对删除，都是印得出来的通道。
+   */
+  @media print {
+    .xh-scope-diff-view[data-part='row'][data-change='added'] {
+      outline: var(--xh-stroke-thick) solid currentColor;
+      outline-offset: calc(-1 * var(--xh-stroke-thick));
+    }
+
+    .xh-scope-diff-view[data-part='row'][data-change='removed'] {
+      outline: var(--xh-stroke-thick) dashed currentColor;
+      outline-offset: calc(-1 * var(--xh-stroke-thick));
+    }
+
+    /* 纸上按不了评论钮 */
+    .xh-scope-diff-view[data-part='comment-trigger'] {
+      display: none;
+    }
+  }
+
+  @media (forced-colors: active) {
+    /* 兜底字形是 mask 挖出来的一块底色，这一档里底色被系统换成 Canvas，字形跟着消失。
+       字形退出强制换色、直接写系统色（不能取 currentColor：退出强制换色的伪元素读到的是被系统换掉之前的作者色）：
+       按钮面上取 ButtonText，悬停与按下时家族把按钮涂成 Highlight、字形换 HighlightText；
+       落在 Canvas 面上的取 CanvasText；
+       禁用取 GrayText */
+    .xh-scope-diff-view[data-part='truncation']::before {
+      forced-color-adjust: none;
+      background-color: CanvasText;
+    }
+
+    .xh-scope-diff-view[data-part='comment-trigger']::before {
+      forced-color-adjust: none;
+      background-color: ButtonText;
+    }
+
+    .xh-scope-diff-view[data-part='comment-trigger']:not([data-disabled]):not([data-loading]):is(:hover, :active, [data-pressed])::before {
+      background-color: HighlightText;
+    }
+
+    .xh-scope-diff-view[data-part='comment-trigger'][data-disabled]::before {
+      background-color: GrayText;
+    }
+  }
+}

package/dist/css/download-trigger.css

@@ -0,0 +1,151 @@
+/*
+ * Copyright (c) 2021-Present XiHanFun and contributors.
+ * Licensed under the MIT License. See LICENSE in the project root for license information.
+ */
+
+/* 定义 download trigger 样式。 */
+
+/* 共享关键帧由 family/motion.css 提供，本皮肤 @import 它，单独引入仍成立。 */
+@import '../family/motion.css';
+@import '../family/action-control.css';
+@import '../family/loading-ring.css';
+
+@layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  .xh-scope-download-trigger {
+    --xh-download-trigger-skin: 1;
+  }
+
+  /*
+   * 触发器就是这一个原生按钮，是定尺的独立动作按钮：盒型、三档几何、四态面、0.97 按压与粗指针
+   * 命中区由家族配方按 data-xh-action-variant / -size 给出（缺省 subtle 由连接层显式投影，只有 solid 才品牌实心）。
+   * 这里只把公开槽桥接到矩阵之前（使用者槽 → 形态矩阵 → 家族缺省）与几何槽映射；
+   * 要换成品牌样式的作者改 --xh-download-trigger-* 这一族槽位，或直接写自己的类名。
+   */
+  .xh-scope-download-trigger[data-part='root'] {
+    --xh-action-bg-rest: var(--xh-download-trigger-bg, var(--xh-_action-variant-bg-rest));
+    --xh-action-bg-hover: var(--xh-download-trigger-bg-hover, var(--xh-_action-variant-bg-hover));
+    --xh-action-bg-pressed: var(--xh-download-trigger-bg-active, var(--xh-_action-variant-bg-pressed));
+    --xh-action-bg-focus-visible: var(--xh-download-trigger-bg, var(--xh-_action-variant-bg-focus-visible));
+    --xh-action-bg-loading: var(--xh-download-trigger-bg, var(--xh-_action-variant-bg-loading));
+    --xh-action-bg-disabled: var(--xh-download-trigger-bg-disabled, var(--xh-_action-variant-bg-disabled));
+    --xh-action-fg-rest: var(--xh-download-trigger-fg, var(--xh-_action-variant-fg-rest));
+    --xh-action-fg-hover: var(--xh-download-trigger-fg, var(--xh-_action-variant-fg-hover));
+    --xh-action-fg-pressed: var(--xh-download-trigger-fg, var(--xh-_action-variant-fg-pressed));
+    --xh-action-fg-focus-visible: var(--xh-download-trigger-fg, var(--xh-_action-variant-fg-focus-visible));
+    --xh-action-fg-loading: var(--xh-download-trigger-fg, var(--xh-_action-variant-fg-loading));
+    --xh-action-border-rest: var(--xh-download-trigger-border, var(--xh-_action-variant-border-rest));
+    --xh-action-border-hover: var(--xh-download-trigger-border-hover, var(--xh-_action-variant-border-hover));
+    --xh-action-border-pressed: var(--xh-download-trigger-border-hover, var(--xh-_action-variant-border-pressed));
+    --xh-action-border-focus-visible: var(--xh-download-trigger-border, var(--xh-_action-variant-border-focus-visible));
+    --xh-action-border-disabled: var(--xh-download-trigger-border-disabled, var(--xh-_action-variant-border-disabled));
+    /* 矩阵各态无影（淡底与阴影互斥）：solid 也不再悬停抬影，使用者槽仍可自行加 */
+    --xh-action-shadow-hover: var(--xh-download-trigger-shadow-hover, none);
+    --xh-action-radius: var(--xh-download-trigger-radius, var(--xh-shape-control));
+    --xh-action-visual-size: var(--xh-download-trigger-h, var(--xh-_action-profile-visual-size));
+    --xh-action-padding-inline: var(--xh-download-trigger-px, var(--xh-_action-profile-padding-inline));
+    --xh-action-gap: var(--xh-download-trigger-gap, var(--xh-_action-profile-gap));
+    --xh-action-font-size: var(--xh-download-trigger-font-size, var(--xh-_action-profile-font-size));
+    /* 作者塞进来的图标跟着尺寸档走，与皮肤画的兜底字形同一把尺 */
+    --xh-icon-size: var(--xh-download-trigger-icon-size, var(--xh-_action-profile-glyph-size));
+    /* 取数在途那枚圆环的颜色：字被 content-hide 关键帧压成透明，环不能跟着 currentColor 走，取加载态的前景 */
+    --xh-_download-trigger-loading-fg: var(--xh-download-trigger-loading-fg, var(--xh-download-trigger-fg, var(--xh-_action-variant-fg-loading)));
+    /* 取数在途的环由加载环配方压在钮正中（连接层投影 data-xh-loading-ring="overlay"），直径取钮的图标档；
+       起始边取钮在途时的真实前景，转速认使用者槽 */
+    --xh-_loading-ring-fg: var(--xh-_download-trigger-loading-fg);
+    --xh-_loading-ring-duration: var(--xh-download-trigger-loading-duration, var(--xh-motion-loop-spin));
+
+    /* safe：文案放不下时居中改成靠行首排，裁掉的是末尾那截，开头仍然读得到 */
+    justify-content: safe center;
+    font-weight: var(--xh-download-trigger-font-weight, var(--xh-text-label-weight));
+    /* 文案比所在那一栏还长时，按钮的盒收到栏宽为止，多出来的字在行内一轴裁掉，
+       整颗按钮不再撑破侧栏。块轴留 visible：粗指针那一档的命中区是往块轴外扩的伪元素 */
+    max-inline-size: 100%;
+    overflow-x: clip;
+    /* 导出键常被连点，触屏上默认会当成双击缩放 */
+    touch-action: manipulation;
+  }
+
+  /* 上面声明了 display，会盖掉 UA 的 [hidden] 规则，收起态要在这里接回来 */
+  .xh-scope-download-trigger[data-part='root'][hidden] {
+    display: none;
+  }
+
+  /* 面是实心的，环色与面同族，画在面里就看不出来；环改取面自己的前景色——
+     那一族色本来就要在这块面上把字读清楚，与面的对比是按可读性定的 */
+  .xh-scope-download-trigger[data-part='root'][data-xh-action-variant='solid']:focus-visible {
+    --xh-action-ring-color-focus-visible: currentColor;
+  }
+
+  /* 没写内容就由皮肤画兜底字形；作者往按钮里塞了文字或自己的图形，这几条即不命中。
+     字形另起一颗 ::after：::before 是加载环，mask 会把描边裁成字形轮廓、环就此消失。
+     字形取前景色：取数在途时随前景一起淡到透明，把位置让给环 */
+  .xh-scope-download-trigger[data-part='root']:empty::after {
+    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-download) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-download) center / contain no-repeat;
+  }
+
+  /* 取数在途：钮里原有的文字与字形随前景淡到透明留位，进入在途等一个 micro 才起淡（快速取数什么都不闪），
+     与环同一段等待；退出在途不等，按 micro 淡回。环的前景另由私有槽给，不跟着透明 */
+  .xh-scope-download-trigger[data-part='root'][data-loading] {
+    --xh-action-fg-loading: transparent;
+
+    transition-delay: var(--xh-motion-duration-micro);
+  }
+
+  /* 手指落点：配方 text 档用 ::after 把块轴命中区扩到 44px；没写内容的按钮 ::after 已被兜底字形占着，
+     这一档改用不在途时的 ::before 扩——取数在途时 ::before 是加载环，钮也按不动，不再需要热区。字形那条只写了尺寸与 mask，配方的定位、44px 下限与 -50% 平移会从同一个
+     ::after 漏进来：字形被拎出行内流、盒撑到 44px 高，按钮随之收窄一格字形——这里逐项钉回 */
+  @media (pointer: coarse) {
+    .xh-scope-download-trigger[data-part='root']:empty::after {
+      position: static;
+      min-block-size: 0;
+      translate: none;
+    }
+
+    /* 热区收下加载环的几何：环的描边不画、指针照接；退出在途时环在这一档直接收起，不留一圈放大的环淡出 */
+    .xh-scope-download-trigger[data-part='root']:empty:not([data-loading])::before {
+      content: '';
+      position: absolute;
+      border-color: transparent;
+      margin: 0;
+      pointer-events: auto;
+      inset-block: 50% auto;
+      inset-inline: 50% auto;
+      min-block-size: 44px;
+      inline-size: 100%;
+      block-size: 100%;
+      translate: -50% -50%;
+    }
+
+    /* 与家族同一笔：起点是逻辑属性、平移是物理通道，rtl 下行内分量掉头，热区才落回按钮中心 */
+    .xh-scope-download-trigger[data-part='root']:empty:not([data-loading]):dir(rtl)::before {
+      translate: 50% -50%;
+    }
+  }
+
+  @media (forced-colors: active) {
+    /* 兜底字形是 mask 挖出来的一块底色，这一档里底色被系统换成 Canvas，字形跟着消失。
+       字形退出强制换色、直接写系统色（不能取 currentColor：退出强制换色的伪元素读到的是被系统换掉之前的作者色）：
+       按钮面上取 ButtonText，悬停与按下时家族把按钮涂成 Highlight、字形换 HighlightText；
+       禁用取 GrayText */
+    .xh-scope-download-trigger[data-part='root']:empty::after {
+      forced-color-adjust: none;
+      background-color: ButtonText;
+    }
+
+    .xh-scope-download-trigger[data-part='root']:not([data-disabled]):not([data-loading]):is(:hover, :active, [data-pressed]):empty::after {
+      background-color: HighlightText;
+    }
+
+    .xh-scope-download-trigger[data-part='root'][data-disabled]:empty::after {
+      background-color: GrayText;
+    }
+  }
+}