@xihan-ui/styles 2.1.0 → 3.1.0

package/css/clipboard.css

@@ -5,27 +5,10 @@
 
 /* 定义 clipboard 样式。 */
 
+/* 共享关键帧由 family/motion.css 提供，本皮肤 @import 它，单独引入仍成立。 */
+@import '../family/motion.css';
 @import '../family/action-control.css';
-
-@layer xihan.motion {
-  @keyframes xh-clipboard-rotate {
-    to {
-      rotate: 360deg;
-    }
-  }
-
-  @keyframes xh-clipboard-loading-reveal {
-    to {
-      opacity: 1;
-    }
-  }
-
-  @keyframes xh-clipboard-loading-hide {
-    to {
-      opacity: 0;
-    }
-  }
-}
+@import '../family/loading-ring.css';
 
 @layer xihan.components {
   /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
@@ -148,14 +131,15 @@
      字改用 -webkit-text-fill-color 接回来，那是这个态下唯一还听样式表的前景通道。
      不去拉长 transition 把系统底推迟显现：那只是把它藏起来，减弱动效通道一关过渡就当场露出。
      两个选择器名分写两条：一条选择器列表里只要有一个名字不被认识，整条规则就被丢弃。
-     铺的底跟着这个框自己那档压低的底走，不然填过之后它会比没填时亮一块。 */
+     铺的底跟着这个框自己那档压低的底走，不然填过之后它会比没填时亮一块。
+     压低的底是墨色按比例透明，盖不住平台底：铺它叠在缺省面上的不透明档。 */
   [data-scope='clipboard'][data-part='input']:autofill {
-    box-shadow: inset 0 0 0 100vmax var(--xh-clipboard-input-autofill-bg, var(--xh-bg-subtle));
+    box-shadow: inset 0 0 0 100vmax var(--xh-clipboard-input-autofill-bg, var(--xh-bg-subtle-opaque));
     -webkit-text-fill-color: var(--xh-clipboard-input-autofill-fg, var(--xh-fg-default));
   }
 
   [data-scope='clipboard'][data-part='input']:-webkit-autofill {
-    box-shadow: inset 0 0 0 100vmax var(--xh-clipboard-input-autofill-bg, var(--xh-bg-subtle));
+    box-shadow: inset 0 0 0 100vmax var(--xh-clipboard-input-autofill-bg, var(--xh-bg-subtle-opaque));
     -webkit-text-fill-color: var(--xh-clipboard-input-autofill-fg, var(--xh-fg-default));
   }
 
@@ -203,9 +187,10 @@
     --xh-action-border-focus-visible: var(--xh-clipboard-copy-trigger-border, var(--xh-border-control));
   }
 
+  /* 与输入框共用的那条边只画一次：墨色描边半透明，两条叠在一起会加深。输入框的末端边就是这条共边 */
   [data-scope='clipboard'][data-part='control'] > [data-scope='clipboard'][data-part='copy-trigger']:not(:first-child) {
     position: relative;
-    margin-inline-start: calc(-1 * var(--xh-stroke-thin));
+    border-inline-start-width: 0;
     border-start-start-radius: 0;
     border-end-start-radius: 0;
     border-start-end-radius: var(
@@ -230,50 +215,22 @@
     display: none;
   }
 
-  /* 快速写入不显示瞬时圆环；超过一个 micro 周期后才平滑换成加载状态。 */
-  [data-scope='clipboard'][data-part='root'][data-state='copying']
-    [data-scope='clipboard'][data-part='copy-trigger'][aria-busy='true'] {
-    cursor: progress;
-  }
-
-  [data-scope='clipboard'][data-part='copy-trigger'][aria-busy='true']::before {
-    content: '';
-    position: absolute;
-    inset: 0;
-    inline-size: 1em;
-    block-size: 1em;
-    margin: auto;
-    border: var(--xh-stroke-thin) solid transparent;
-    border-block-start-color: currentColor;
-    /* 正圆的加载环：正方盒取 circle */
-    border-radius: var(--xh-shape-circle);
-    opacity: 0;
-    animation:
-      xh-clipboard-rotate var(--xh-clipboard-loading-duration, var(--xh-spin-duration)) var(--xh-motion-ease-loop) infinite,
-      xh-clipboard-loading-reveal var(--xh-motion-duration-micro) var(--xh-motion-ease-enter) var(--xh-motion-duration-micro) forwards;
+  /* 写入在途：环由加载环配方压在钮正中（连接层投影 data-xh-loading-ring="overlay"），直径取钮的图标档，
+     起始边取钮的真实前景、转速认使用者槽。进入在途等一个 micro 才起淡，快速写入什么都不闪；
+     钮里原有的文字与字形随前景淡到透明留位，同样等这一个 micro，退出在途不等、按 micro 淡回 */
+  [data-scope='clipboard'][data-part='copy-trigger'] {
+    --xh-_loading-ring-fg: var(--xh-clipboard-copy-trigger-fg, var(--xh-_action-variant-fg-loading));
+    --xh-_loading-ring-duration: var(--xh-clipboard-loading-duration, var(--xh-motion-loop-spin));
   }
 
-  [data-scope='clipboard'][data-part='copy-trigger'][aria-busy='true']
-    > [data-scope='clipboard'][data-part='indicator']:not([data-copied]) {
-    animation: xh-clipboard-loading-hide var(--xh-motion-duration-micro) var(--xh-motion-ease-enter)
-      var(--xh-motion-duration-micro) forwards;
+  [data-scope='clipboard'][data-part='copy-trigger']::before {
+    --xh-icon-size: var(--xh-_action-profile-glyph-size);
   }
 
-  @media (prefers-reduced-motion: reduce) {
-    [data-scope='clipboard'][data-part='copy-trigger'][aria-busy='true']::before {
-      animation: none;
-    }
-
-    [data-scope='clipboard'][data-part='copy-trigger'][aria-busy='true']
-      > [data-scope='clipboard'][data-part='indicator']:not([data-copied]) {
-      animation: none;
-    }
-  }
+  [data-scope='clipboard'][data-part='copy-trigger'][data-loading] {
+    --xh-action-fg-loading: transparent;
 
-  :where([data-motion='reduce']) [data-scope='clipboard'][data-part='copy-trigger'][aria-busy='true']::before,
-  :where([data-motion='reduce']) [data-scope='clipboard'][data-part='copy-trigger'][aria-busy='true']
-    > [data-scope='clipboard'][data-part='indicator']:not([data-copied]) {
-    animation: none;
+    transition-delay: var(--xh-motion-duration-micro);
   }
 
   /* 复制成功只换前景与内容，轮廓和尺寸保持稳定；各态前景经桥接槽换，悬停与按下不退回平时的字色 */

package/css/code-view.css

@@ -16,11 +16,11 @@
 
   /* 一张静态内容面：--xh-border-default 描边 + surface 底 + 无影（边界只由描边承担），
      overflow: hidden 让内部 <pre> 的滚动内容沿圆角收边；不设 display，排布由作者决定。
-     color 给整段未着色的代码定基线，字号在这里消费一次，缺省即 sm 档。 */
+     color 给整段未着色的代码定基线，字号在这里消费一次，缺省即 md 档（与面内按钮同档）。 */
   [data-scope='code-view'][data-part='root'] {
     /* 尺寸缺省档：不写 data-size 时的取值。三档都只写这个私有槽，
        公开槽留在读处当首选，作者在祖先上设的覆盖才赢得过档位声明 */
-    --xh-_code-view-font-size: var(--xh-control-font-sm);
+    --xh-_code-view-font-size: var(--xh-control-font-md);
 
     overflow: hidden;
     border: var(--xh-stroke-thin) solid var(--xh-code-view-border, var(--xh-border-default));
@@ -111,7 +111,7 @@
     padding-inline-end: var(--xh-code-view-px, var(--xh-space-3));
     /* 标出来的那几行换的是底色与那条内阴影色条，两样一起过渡才是同一个动作 */
     transition:
-      background var(--xh-motion-duration-micro) var(--xh-motion-ease-enter),
+      background-color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter),
       box-shadow var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
   }
 
@@ -119,9 +119,10 @@
     display: none;
   }
 
+  /* 高亮行是强调不是选中：中性淡底 + 行首强调条，不用品牌淡底（品牌淡底只表达选中 / 当前） */
   [data-scope='code-view'][data-part='line'][data-highlighted] {
-    background: var(--xh-code-view-highlight-bg, var(--xh-bg-brand-subtle));
-    box-shadow: inset var(--xh-code-view-highlight-bar, var(--xh-stroke-thick)) 0 0 0 var(--xh-code-view-highlight-fg, var(--xh-bg-brand));
+    background: var(--xh-code-view-highlight-bg, var(--xh-bg-subtle));
+    box-shadow: inset var(--xh-code-view-highlight-bar, var(--xh-stroke-thick)) 0 0 0 var(--xh-code-view-highlight-fg, var(--xh-border-strong));
   }
 
   /* 行号是画上去的不是写上去的：复制代码不带它，读屏也不逐行念数字。
@@ -133,7 +134,7 @@
     flex: 0 0 auto;
     padding-inline-start: var(--xh-code-view-px, var(--xh-space-3));
     padding-inline-end: var(--xh-code-view-gutter-gap, var(--xh-space-1));
-    border-inline-end: var(--xh-stroke-thin) solid var(--xh-code-view-gutter-border, var(--xh-border-default));
+    border-inline-end: var(--xh-stroke-thin) solid var(--xh-code-view-gutter-border, var(--xh-border-subtle));
     color: var(--xh-code-view-number-fg, var(--xh-fg-subtle));
     font-size: var(--xh-code-view-number-font-size, var(--xh-text-caption-size));
     inline-size: var(--xh-_code-view-gutter);
@@ -226,6 +227,75 @@
     display: none;
   }
 
+  /* 按块折叠：每行正文都让出一列（一行高的正方格），块头的折叠钮定位在这一列里；
+     没有钮的行也让，缩进才对得齐 */
+  [data-scope='code-view'][data-part='root'][data-block-folding] {
+    --xh-_code-view-fold-col: var(--xh-code-view-fold-col, var(--xh-code-view-line-height, var(--xh-text-code-leading)));
+  }
+
+  [data-scope='code-view'][data-part='root'][data-block-folding] [data-part='line-content'] {
+    position: relative;
+    padding-inline-start: var(--xh-_code-view-fold-col);
+  }
+
+  [data-scope='code-view'][data-part='root'][data-block-folding]:not([data-line-numbers]) [data-part='line-content'] {
+    padding-inline-start: calc(var(--xh-code-view-px, var(--xh-space-3)) + var(--xh-_code-view-fold-col));
+  }
+
+  /* 行首折叠钮是 disclosure trigger：接 Action Control icon 档、ghost 形态，边长压到一行高，
+     按下只换面不缩放；静息取次级字色，不和正文抢 */
+  [data-scope='code-view'][data-part='line-fold-trigger'] {
+    --xh-action-visual-size: var(--xh-_code-view-fold-col);
+    --xh-action-min-inline-size: var(--xh-_code-view-fold-col);
+    --xh-action-radius: var(--xh-code-view-line-fold-trigger-radius, var(--xh-shape-control));
+    --xh-action-fg-rest: var(--xh-code-view-line-fold-trigger-fg, var(--xh-fg-subtle));
+    --xh-action-scale-pressed: none;
+    --xh-icon-size: var(--xh-code-view-icon-size, var(--xh-glyph-size-sm));
+
+    position: absolute;
+    inset-block-start: 0;
+    inset-inline-start: 0;
+    block-size: var(--xh-_code-view-fold-col);
+  }
+
+  [data-scope='code-view'][data-part='root'][data-block-folding]:not([data-line-numbers]) [data-part='line-fold-trigger'] {
+    inset-inline-start: var(--xh-code-view-px, var(--xh-space-3));
+  }
+
+  [data-scope='code-view'][data-part='line-fold-trigger'][hidden] {
+    display: none;
+  }
+
+  /* 展开时朝下；收起时转向行尾那一侧（RTL 跟着换向） */
+  [data-scope='code-view'][data-part='line-fold-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-chevron-down) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-chevron-down) center / contain no-repeat;
+    transition: rotate var(--xh-motion-duration-expand) var(--xh-motion-ease-enter-strong);
+  }
+
+  [data-scope='code-view'][data-part='line-fold-trigger'][data-state='closed']::before {
+    rotate: calc(-90deg * var(--xh-direction-sign));
+    transition-duration: var(--xh-motion-duration-collapse);
+  }
+
+  /* 折叠着的块头：正文后面一枚省略号，示意下面收起了几行；画上去的，复制不带它 */
+  [data-scope='code-view'][data-part='line-content'][data-folded]::after {
+    content: '';
+    display: inline-block;
+    inline-size: var(--xh-icon-size, var(--xh-glyph-size-sm));
+    block-size: var(--xh-icon-size, var(--xh-glyph-size-sm));
+    margin-inline-start: var(--xh-code-view-folded-gap, var(--xh-space-1));
+    vertical-align: var(--xh-glyph-baseline-shift);
+    background-color: var(--xh-code-view-folded-fg, var(--xh-fg-subtle));
+    -webkit-mask: var(--xh-glyph-mark-ellipsis) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-ellipsis) center / contain no-repeat;
+  }
+
   /* 尺寸档写私有槽、由 root 基础规则消费一次：缺省与阶梯是同一个口子，
      作者设的 --xh-code-view-font-size 排在读处首选，不会被这三条盖掉。
      行号槽宽以 ch 计，随字号一起走 */
@@ -276,4 +346,29 @@
       outline-offset: calc(-1 * var(--xh-code-view-highlight-bar, var(--xh-stroke-thick)));
     }
   }
+
+  @media (forced-colors: active) {
+    /* 兜底字形是 mask 挖出来的一块底色，这一档里底色被系统换成 Canvas，字形跟着消失。
+       字形退出强制换色、直接写系统色（不能取 currentColor：退出强制换色的伪元素读到的是被系统换掉之前的作者色）：
+       按钮面上取 ButtonText，悬停与按下时家族把按钮涂成 Highlight、字形换 HighlightText；
+       落在 Canvas 面上的取 CanvasText；
+       禁用取 GrayText */
+    [data-scope='code-view'][data-part='line-fold-trigger']::before {
+      forced-color-adjust: none;
+      background-color: ButtonText;
+    }
+
+    [data-scope='code-view'][data-part='line-content'][data-folded]::after {
+      forced-color-adjust: none;
+      background-color: CanvasText;
+    }
+
+    [data-scope='code-view'][data-part='line-fold-trigger']:not([data-disabled]):not([data-loading]):is(:hover, :active, [data-pressed])::before {
+      background-color: HighlightText;
+    }
+
+    [data-scope='code-view'][data-part='line-fold-trigger'][data-disabled]::before {
+      background-color: GrayText;
+    }
+  }
 }

package/css/collapsible.css

@@ -101,8 +101,12 @@
     justify-content: center;
     color: var(--xh-collapsible-indicator-fg, var(--xh-fg-muted));
     line-height: var(--xh-leading-none);
-    /* 指示器与正文同档转向：正文 enter 档展开，箭头也用同一段时长翻过去 */
-    transition: rotate var(--xh-motion-duration-enter) var(--xh-motion-ease-enter-strong);
+  }
+
+  /* 指示器与正文同档转向：收起时取 collapse 档，展开时（下面的打开态）取 expand 档。
+     首帧就在的朝向直接呈现（data-instant），第一次开合起才转 */
+  [data-scope='collapsible'][data-part='indicator']:not([data-instant]) {
+    transition: rotate var(--xh-motion-duration-collapse) var(--xh-motion-ease-enter-strong);
   }
 
   /* 没写内容就由皮肤画；作者往部件里塞了自己的图形，这条规则即不命中 */
@@ -121,6 +125,10 @@
     rotate: 180deg;
   }
 
+  [data-scope='collapsible'][data-part='indicator'][data-state='open']:not([data-instant]) {
+    transition: rotate var(--xh-motion-duration-expand) var(--xh-motion-ease-enter-strong);
+  }
+
   /* 这里刻意没有 [data-part='content'][hidden] { display: none }：补了动画一帧都播不出来。
      收起由适配器在退场结束后写内联 display 落成，退场窗口内靠 connect 发的 inert 挡住焦点 */
   [data-scope='collapsible'][data-part='content'] {
@@ -138,14 +146,32 @@
     line-height: var(--xh-leading-normal);
   }
 
-  /* 展开那一档才提前备好行高这条通道：属性随 data-state 一起消失，收起后不长期占着 */
-  [data-scope='collapsible'][data-part='content'][data-state='open'] {
-    will-change: grid-template-rows;
-    animation: xh-disclosure-expand var(--xh-motion-duration-enter) var(--xh-motion-ease-enter-strong);
+  /* 展开与收起只在开合时播：首帧就在的展开 / 收起直接呈现（data-instant） */
+  [data-scope='collapsible'][data-part='content'][data-state='open']:not([data-instant]) {
+    animation: xh-disclosure-expand var(--xh-motion-duration-expand) var(--xh-motion-ease-enter-strong);
   }
 
-  [data-scope='collapsible'][data-part='content'][data-state='closed'] {
-    animation: xh-disclosure-collapse var(--xh-motion-duration-exit) var(--xh-motion-ease-exit) forwards;
+  [data-scope='collapsible'][data-part='content'][data-state='closed']:not([data-instant]) {
+    animation: xh-disclosure-collapse var(--xh-motion-duration-collapse) var(--xh-motion-ease-exit) forwards;
+  }
+
+  @media (forced-colors: active) {
+    /* 兜底字形是 mask 挖出来的一块底色，这一档里底色被系统换成 Canvas，字形跟着消失。
+       字形退出强制换色、直接写系统色（不能取 currentColor：退出强制换色的伪元素读到的是被系统换掉之前的作者色）：
+       按钮面上取 ButtonText，悬停与按下时家族把按钮涂成 Highlight、字形换 HighlightText；
+       禁用取 GrayText */
+    [data-scope='collapsible'][data-part='indicator']:empty::before {
+      forced-color-adjust: none;
+      background-color: ButtonText;
+    }
+
+    [data-scope='collapsible'][data-part='trigger']:not([data-disabled]):not([data-loading]):is(:hover, :active, [data-pressed]) [data-scope='collapsible'][data-part='indicator']:empty::before {
+      background-color: HighlightText;
+    }
+
+    [data-scope='collapsible'][data-part='trigger'][data-disabled] [data-scope='collapsible'][data-part='indicator']:empty::before {
+      background-color: GrayText;
+    }
   }
 }
 

package/css/color-field.css

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