@xihan-ui/styles 2.0.0 → 3.0.0

package/css/code-view.css

@@ -14,13 +14,13 @@
     --xh-code-view-skin: 1;
   }
 
-  /* 一张静态内容面：--xh-border-default 描边 + surface 底 + 无影（§5.3 边界只由描边承担），
+  /* 一张静态内容面：--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);
@@ -202,7 +203,7 @@
   }
 
   /* 折叠条是铺满一行的 disclosure trigger，盒型、悬停与按下面由 Action Control 的 disclosure-trigger 档给
-     （ghost 形态：白底承载 hover 100 → pressed 200，按下只换面不缩放，§9.2）；这里只把使用者槽映射到
+     （ghost 形态：白底承载 hover 100 → pressed 200，按下只换面不缩放）；这里只把使用者槽映射到
      桥接槽：圆角归零贴住卡边，内衬沿用代码区的横向内距与折叠条自己的纵向内距，字号与头部条同档。
      顶边是与头部条同一支的内部分隔线：配方按状态写 border-color 简写，四个状态的边色槽都映射到
      这支分隔色，再把四边宽归零、只留顶边一条 */
@@ -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

@@ -19,7 +19,7 @@
   /* 根容器自己不排版，这条只声明尺寸档的私有槽：正文与标题行从 root 继承它们，
      换档不必给部件各写一条选择器；触发器的三档几何由家族 disclosure-trigger 档给 */
   [data-scope='collapsible'][data-part='root'] {
-    /* 作者塞进正文里的图标与皮肤画的兜底字形同一把尺：md 档（§6.5），触发器上另按家族档取值 */
+    /* 作者塞进正文里的图标与皮肤画的兜底字形同一把尺：md 档，触发器上另按家族档取值 */
     --xh-icon-size: var(--xh-collapsible-icon-size, var(--xh-glyph-size-md));
 
     --xh-_collapsible-trigger-gap: var(--xh-control-gap-md);
@@ -59,7 +59,7 @@
   }
 
   /* 触发器铺满一行，盒型、三档几何、悬停 / 按下 / 禁用面由 Action Control 的 disclosure-trigger 档给
-     （ghost 形态：根无壳，按画布承载 hover 100 → pressed 200；按下只换面不缩放，§9.2）；
+     （ghost 形态：根无壳，按画布承载 hover 100 → pressed 200；按下只换面不缩放）；
      这里只把使用者槽映射到桥接槽：字色三态同值（家族的 hover / pressed 字色规则比皮肤更特定，不映射会被换回
      缺省字色），字形按触发器自己的档位取 --xh-_action-profile-glyph-size；边归零贴住标题行，几何与迁移前一致 */
   [data-scope='collapsible'][data-part='trigger'] {
@@ -81,7 +81,7 @@
   }
 
   /* 展开着的那一档单开一个槽：与常态共用一个的话，作者一改常态字色就把展开态也改掉了。
-     悬停 / 按下的面与收起态同档（§7.3 open 与家族 hover 同档中性） */
+     悬停 / 按下的面与收起态同档（open 与家族 hover 同档中性） */
   [data-scope='collapsible'][data-part='trigger'][data-state='open'] {
     --xh-action-fg-rest: var(--xh-collapsible-trigger-fg-open, var(--xh-_collapsible-open-fg));
     --xh-action-fg-hover: var(--xh-collapsible-trigger-fg-open, var(--xh-_collapsible-open-fg));
@@ -101,8 +101,12 @@
     justify-content: center;
     color: var(--xh-collapsible-indicator-fg, var(--xh-fg-muted));
     line-height: var(--xh-leading-none);
-    /* 指示器与正文同档转向（§9.4）：正文 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;
+    }
+  }
 }

package/css/color-picker.css

@@ -5,10 +5,10 @@
 
 /* 定义 color picker 样式。 */
 
+@import '../family/field-chrome.css';
 @import '../family/swatch.css';
 @import '../family/motion.css';
 
-
 @layer xihan.components {
   /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
   [data-scope='color-picker'] {
@@ -23,11 +23,10 @@
 
   /* 标签一行、盒一行的两行堆叠 */
   [data-scope='color-picker'][data-part='root'] {
-    /* 盒的度量与标签字号走私有槽中转，与同族的下拉选择一处对一处 */
+    /* 盒的度量走私有槽中转，与同族的下拉选择一处对一处 */
     --xh-_color-picker-h: var(--xh-control-h-md);
     --xh-_color-picker-px: var(--xh-control-px-md);
     --xh-_color-picker-gap: var(--xh-control-gap-md);
-    --xh-_color-picker-label-font-size: var(--xh-control-font-md);
 
     /* 聚焦环恒用固定环色 */
     --xh-_color-picker-ring: var(--xh-ring-focus);
@@ -50,70 +49,47 @@
     --xh-_color-picker-h: var(--xh-control-h-sm);
     --xh-_color-picker-px: var(--xh-control-px-sm);
     --xh-_color-picker-gap: var(--xh-control-gap-sm);
-    --xh-_color-picker-label-font-size: var(--xh-control-font-sm);
   }
 
   [data-scope='color-picker']:is([data-part='root'], [data-part='positioner'])[data-size='lg'] {
     --xh-_color-picker-h: var(--xh-control-h-lg);
     --xh-_color-picker-px: var(--xh-control-px-lg);
     --xh-_color-picker-gap: var(--xh-control-gap-lg);
-    --xh-_color-picker-label-font-size: var(--xh-control-font-lg);
   }
 
   [data-scope='color-picker'][data-part='label'] {
     color: var(--xh-color-picker-label-fg, var(--xh-fg-default));
-    font-size: var(--xh-color-picker-label-font-size, var(--xh-_color-picker-label-font-size));
+    /* 字段标签不随档：与同族字段同一档标签字号 */
+    font-size: var(--xh-color-picker-label-font-size, var(--xh-text-label-size));
     font-weight: var(--xh-color-picker-label-font-weight, var(--xh-text-label-weight));
   }
 
-  /* 盒：描边、底色、控件高度与行内内衬都落在这一层，
-     另加一档静态落影把它从页面里抬起一层 */
+  /* 盒：接字段外壳家族（data-xh-field-chrome），描边、底色、控件高度、行内内衬、悬停与聚焦面
+     都由家族按 data-variant 与状态画，与同族的下拉选择一处对一处；这里只把组件自己的覆盖槽桥接进去。
+     静息无影、悬停取家族的 45% 淡底、聚焦边一律 --xh-border-control-focus（不随语气） */
   [data-scope='color-picker'][data-part='control'] {
-    display: inline-flex;
-    align-items: center;
-    gap: var(--xh-color-picker-control-gap, var(--xh-_color-picker-gap));
-    min-inline-size: min(var(--xh-color-picker-control-min-w, var(--xh-control-min-w)), 100%);
-    block-size: var(--xh-color-picker-control-h, var(--xh-_color-picker-h));
-    padding-inline: var(--xh-color-picker-control-px, var(--xh-_color-picker-px));
-    border: var(--xh-stroke-thin) solid var(--xh-color-picker-control-border, var(--xh-border-control));
-    border-radius: var(--xh-color-picker-control-radius, var(--xh-shape-control));
-    background: var(--xh-color-picker-control-bg, transparent);
-    box-shadow: var(--xh-color-picker-control-shadow, var(--xh-elevation-raised));
-    color: var(--xh-color-picker-control-fg, var(--xh-fg-default));
-    cursor: pointer;
-    transition:
-      background var(--xh-motion-duration-micro) var(--xh-motion-ease-enter),
-      border-color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+    --xh-field-control-height: var(--xh-color-picker-control-h, var(--xh-_color-picker-h));
+    --xh-field-control-padding-inline: var(--xh-color-picker-control-px, var(--xh-_color-picker-px));
+    --xh-field-control-gap: var(--xh-color-picker-control-gap, var(--xh-_color-picker-gap));
+    --xh-field-control-min-inline-size: var(--xh-color-picker-control-min-w, var(--xh-control-min-w));
+    --xh-field-control-radius: var(--xh-color-picker-control-radius, var(--xh-shape-control));
+    --xh-field-bg-rest: var(--xh-color-picker-control-bg, var(--xh-_field-variant-bg-rest));
+    --xh-field-bg-hover: var(--xh-color-picker-control-bg-hover, var(--xh-_field-variant-bg-hover));
+    --xh-field-bg-read-only: var(--xh-color-picker-control-bg-readonly, var(--xh-_field-variant-bg-read-only));
+    --xh-field-bg-disabled: var(--xh-color-picker-control-bg-disabled, var(--xh-_field-variant-bg-disabled));
+    --xh-field-fg-rest: var(--xh-color-picker-control-fg, var(--xh-fg-default));
+    --xh-field-border-rest: var(--xh-color-picker-control-border, var(--xh-_field-variant-border-rest));
+    --xh-field-border-hover: var(--xh-color-picker-control-border-hover, var(--xh-_field-variant-border-hover));
+    --xh-field-border-focus: var(--xh-color-picker-control-border-focus, var(--xh-_field-variant-border-focus));
+    --xh-field-ring-focus: var(--xh-_color-picker-ring);
+    --xh-field-shadow-rest: var(--xh-color-picker-control-shadow, none);
+    --xh-field-cursor-rest: pointer;
   }
 
   [data-scope='color-picker'][data-part='control'][hidden] {
     display: none;
   }
 
-  /* 悬停换描边的同时换填充：这个盒里大半面积是那块色样，只挪一圈 1px 的描边读不出来。
-     只读档摘掉：它正拿压低一档的底色说「改不动」，被悬停的填充盖掉那条信息就没了 */
-  [data-scope='color-picker'][data-part='control']:hover:not([data-disabled], [data-readonly]) {
-    border-color: var(--xh-color-picker-control-border-hover, var(--xh-border-control-hover));
-    background: var(--xh-color-picker-control-bg-hover, var(--xh-bg-subtle));
-  }
-
-  /* Tab 停靠点是盒里的 trigger，环画在盒上 */
-  [data-scope='color-picker'][data-part='control']:focus-within:not([data-disabled]) {
-    border-color: var(--xh-color-picker-control-border-focus, var(--xh-_tone, var(--xh-border-control-focus)));
-    outline: var(--xh-ring-width) solid var(--xh-_color-picker-ring);
-    outline-offset: var(--xh-ring-offset);
-  }
-
-  [data-scope='color-picker'][data-part='control'][data-disabled] {
-    background: var(--xh-color-picker-control-bg-disabled, var(--xh-bg-subtle));
-    color: var(--xh-fg-disabled);
-  }
-
-  /* 只读仍可聚焦、浮层照开，只是改不动：不置灰，只把底色压下去 */
-  [data-scope='color-picker'][data-part='control'][data-readonly] {
-    background: var(--xh-color-picker-control-bg-readonly, var(--xh-bg-subtle));
-  }
-
   /* 盒内那颗可聚焦的按钮：不画描边不铺底也不自带高度，只占满剩余宽度、排布色块与值文本 */
   [data-scope='color-picker'][data-part='trigger'] {
     display: inline-flex;
@@ -217,9 +193,9 @@
     padding-inline: var(--xh-color-picker-content-px, var(--xh-space-3));
     max-block-size: min(var(--xh-color-picker-max-h, var(--xh-viewport-h-md)), var(--xh-_color-picker-available-h));
     overflow-y: auto;
-    /* 浮层滚动面：滚到头不把页面一起带走（§6.6） */
+    /* 浮层滚动面：滚到头不把页面一起带走 */
     overscroll-behavior: contain;
-    /* 面域 + 滑杆 + 通道输入的表单型多列面板，走 floating 材质（§8.4）——实体底 + --xh-border-default 描边 +
+    /* 面域 + 滑杆 + 通道输入的表单型多列面板，走 floating 材质——实体底 + --xh-border-default 描边 +
        --xh-elevation-floating 落影，不透景、不画顶部边界光 */
     border: var(--xh-stroke-thin) solid var(--xh-color-picker-content-border, var(--xh-border-default));
     border-radius: var(--xh-color-picker-content-radius, var(--xh-shape-overlay));
@@ -229,15 +205,14 @@
     pointer-events: auto;
   }
 
-  /* 在场那一档才提前备好合成层：属性随 data-state 一起消失，收起后不长期占着 */
-  [data-scope='color-picker'][data-part='content'][data-state='open'] {
-    will-change: opacity, translate;
+  /* 挂载时就开着的那一段（data-instant）属于首帧，直接呈现；常驻形态的取色面一直在，没有进退场 */
+  [data-scope='color-picker'][data-part='content'][data-state='open']:not([data-instant], [data-inline]) {
     animation: xh-overlay-slide-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter-strong);
   }
 
   /* 退场：收起那一帧 hidden 由退场闸门押后，这里才播得出来。forwards 把末态钉住，
      免得动画结束到真收起之间闪一下原样 */
-  [data-scope='color-picker'][data-part='content'][data-state='closed'] {
+  [data-scope='color-picker'][data-part='content'][data-state='closed']:not([data-inline]) {
     animation: xh-overlay-slide-out var(--xh-motion-duration-exit) var(--xh-motion-ease-exit) forwards;
   }
 
@@ -246,6 +221,22 @@
     outline: none;
   }
 
+  /* 常驻形态：根不再取字段缺省宽，跟着取色面走 */
+  [data-scope='color-picker'][data-part='root'][data-inline] {
+    inline-size: auto;
+    min-inline-size: 0;
+  }
+
+  /* 常驻形态的取色面是页面里的静态内容面（solid）：surface 圆角、border-default 描边、实体底、不落影。
+     没有定位层给出可用宽高，不限高也不自己滚；它一直在，没有进退场 */
+  [data-scope='color-picker'][data-part='content'][data-inline] {
+    max-inline-size: 100%;
+    max-block-size: none;
+    overflow-y: visible;
+    border-radius: var(--xh-color-picker-content-radius, var(--xh-shape-surface));
+    box-shadow: var(--xh-color-picker-content-shadow, none);
+  }
+
   /* 二维取色区。底色是当前色相（连接层内联给），两层渐变盖在上面：
      横轴由白到透明 = 饱和度，纵轴由透明到黑 = 明度。
      两层都收在一个 ::before 里：它是盒树里的第一个子节点，作者写的拇指排在它后面，
@@ -303,7 +294,7 @@
     background: transparent;
     box-shadow: var(--xh-color-picker-thumb-shadow, var(--xh-elevation-raised));
     cursor: grab;
-    transition: scale var(--xh-motion-duration-micro) var(--xh-motion-ease-enter-strong);
+    transition: scale var(--xh-motion-duration-nudge) var(--xh-motion-ease-enter-strong);
   }
 
   /* 取色区的纵轴也由连接层给（inset-block-start），回拉同样按 block-start 那侧 */
@@ -366,7 +357,8 @@
   }
 
   [data-scope='color-picker'][data-part='channel-input']:focus-visible {
-    border-color: var(--xh-color-picker-input-border-focus, var(--xh-_tone, var(--xh-border-control-focus)));
+    /* 焦点边一律 --xh-border-control-focus，不随语气 */
+    border-color: var(--xh-color-picker-input-border-focus, var(--xh-border-control-focus));
     outline: var(--xh-ring-width) solid var(--xh-ring-focus);
     outline-offset: var(--xh-ring-offset);
   }
@@ -403,13 +395,14 @@
     cursor: pointer;
     user-select: none;
     transition:
-      background var(--xh-motion-duration-micro) var(--xh-motion-ease-enter),
+      background-color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter),
       border-color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter),
       scale var(--xh-motion-duration-release) var(--xh-motion-ease-release);
   }
 
   [data-scope='color-picker'][data-part='eye-dropper-trigger']:hover:not(:disabled) {
-    background: var(--xh-color-picker-action-bg-hover, var(--xh-bg-subtle-hover));
+    /* 坐在浮层白底上：白底承载阶梯 hover 100 → pressed 200 */
+    background: var(--xh-color-picker-action-bg-hover, var(--xh-bg-subtle));
     color: var(--xh-color-picker-action-fg-hover, var(--xh-fg-default));
   }
 
@@ -417,7 +410,7 @@
      松手那一刻浮层多半已经被系统的取色镜头盖住，按下的回执只有这一瞬看得见。
      指针 :active 与 Headless 投影的 data-pressed（Space / Enter 与触屏按住）看见同一副按压面 */
   [data-scope='color-picker'][data-part='eye-dropper-trigger']:not(:disabled):is(:active, [data-pressed]) {
-    background: var(--xh-color-picker-action-bg-active, var(--xh-bg-subtle-active));
+    background: var(--xh-color-picker-action-bg-active, var(--xh-bg-subtle-hover));
     scale: var(--xh-motion-scale-press);
     transition-duration: var(--xh-motion-duration-press);
     transition-timing-function: var(--xh-motion-ease-press);
@@ -437,8 +430,9 @@
   /* 预设色板的挂载点，同时充当色板的根节点：color-swatch-picker 那份皮的 root 规则落在
      [data-scope='color-swatch-picker'][data-part='root'] 上，而这里没有那个节点，所以根上挂的那几个私有槽
      （格子边长、间距、徽标尺寸、语气色、图标尺）与排布得在这儿照抄一遍；格子的皮仍归色板那一份。
-     浮层里的色板走小号格子：与滑块的拇指、数值框一个量级，整块面板才不会被色板撑开 */
-  [data-scope='color-picker'][data-part='swatch-picker'] {
+     浮层里的色板走小号格子：与滑块的拇指、数值框一个量级，整块面板才不会被色板撑开。
+     最近使用色是同一台色块选择器，挂载点同一套 */
+  [data-scope='color-picker']:is([data-part='swatch-picker'], [data-part='recent-swatch-picker']) {
     --xh-_color-swatch-picker-cell: var(--xh-color-picker-swatch-cell, var(--xh-control-h-sm));
     --xh-_color-swatch-picker-gap: var(--xh-color-picker-swatch-gap, var(--xh-control-gap-sm));
     --xh-_color-swatch-picker-indicator: var(--xh-control-indicator-sm);
@@ -452,7 +446,7 @@
     gap: var(--xh-color-picker-swatch-picker-gap, var(--xh-_color-swatch-picker-gap));
   }
 
-  [data-scope='color-picker'][data-part='swatch-picker'][data-disabled] {
+  [data-scope='color-picker']:is([data-part='swatch-picker'], [data-part='recent-swatch-picker'])[data-disabled] {
     cursor: not-allowed;
   }
 
@@ -466,7 +460,8 @@
   [data-scope='color-picker'][data-part='hue-slider'][hidden],
   [data-scope='color-picker'][data-part='alpha-slider'][hidden],
   [data-scope='color-picker'][data-part='eye-dropper-trigger'][hidden],
-  [data-scope='color-picker'][data-part='swatch-picker'][hidden] {
+  [data-scope='color-picker'][data-part='swatch-picker'][hidden],
+  [data-scope='color-picker'][data-part='recent-swatch-picker'][hidden] {
     display: none;
   }
 

package/css/color-slider.css

@@ -23,7 +23,7 @@
 
     display: flex;
     flex-direction: column;
-    /* 字段标签贴控件（§6.4 复合单字段） */
+    /* 字段标签贴控件（复合单字段） */
     gap: var(--xh-color-slider-gap, var(--xh-space-1));
   }
 
@@ -33,10 +33,10 @@
     align-items: center;
   }
 
-  /* 禁用不整体压暗（§7.2 第 9 条）：标签是文字，换到禁用前景；颜色带与拇指画的是颜色本身，换不得色，
+  /* 禁用不整体压暗：标签是文字，换到禁用前景；颜色带与拇指画的是颜色本身，换不得色，
      压暗只做一次、落在 control 上（track / thumb 各自再叠一层 opacity 会越叠越黑），拇指另收掉抬升 */
 
-  /* 字段标签：14 / 500 / fg-default（§6.4），禁用换到 --xh-fg-subtle */
+  /* 字段标签：14 / 500 / fg-default，禁用换到 --xh-fg-subtle */
   [data-scope='color-slider'][data-part='label'] {
     color: var(--xh-color-slider-label-fg, var(--xh-fg-default));
     font-size: var(--xh-color-slider-label-font-size, var(--xh-text-label-size));
@@ -122,7 +122,7 @@
   }
 
   /* 圆点浮在轨道之上：轨道是流内的，拇指是绝对定位的，天然后来居上。
-     拇指填的是当前那一档的颜色（连接层写进私有槽），拇指是可拖起的 raised 面（§8）：
+     拇指填的是当前那一档的颜色（连接层写进私有槽），拇指是可拖起的 raised 面：
      --xh-border-default 描边把它从任何底色里框出来，raised 影只是加成、不作边界。
      box-sizing 必须显式写：描边要吃进直径里，否则下面按半个直径回拉的负外边距就对不上圆心。 */
   [data-scope='color-slider'][data-part='thumb'] {
@@ -132,13 +132,14 @@
     box-sizing: border-box;
     inline-size: var(--xh-_thumb-size);
     block-size: var(--xh-_thumb-size);
-    border: var(--xh-stroke-thick) solid var(--xh-color-slider-thumb-border, var(--xh-border-default));
+    /* 描边取装饰边的不透明档：墨色描边半透明，压在当前色上框不住圆点 */
+    border: var(--xh-stroke-thick) solid var(--xh-color-slider-thumb-border, var(--xh-border-default-opaque));
     border-radius: var(--xh-color-slider-thumb-radius, var(--xh-shape-circle));
     background: var(--xh-color-slider-thumb-bg, var(--xh-_color-slider-thumb-color));
     box-shadow: var(--xh-color-slider-thumb-shadow, var(--xh-elevation-raised));
     cursor: grab;
     transition:
-      scale var(--xh-motion-duration-micro) var(--xh-motion-ease-enter-strong),
+      scale var(--xh-motion-duration-nudge) var(--xh-motion-ease-enter-strong),
       box-shadow var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
   }
 
@@ -159,7 +160,10 @@
 
   /* 放大用 scale 而不是改尺寸：变换绕自身中心发生，圆心不动。海拔从 raised 换到 lifted */
   [data-scope='color-slider'][data-part='thumb'][data-dragging] {
-    scale: var(--xh-color-slider-thumb-scale-dragging, var(--xh-motion-scale-drag));
+    /* 放大比例落进私有槽：挂在拇指里的值气泡读同一支反向缩回原尺寸 */
+    --xh-_color-slider-thumb-scale: var(--xh-color-slider-thumb-scale-dragging, var(--xh-motion-scale-drag));
+
+    scale: var(--xh-_color-slider-thumb-scale);
     cursor: grabbing;
     box-shadow: var(--xh-color-slider-thumb-shadow-dragging, var(--xh-elevation-lifted));
   }
@@ -179,14 +183,19 @@
     cursor: not-allowed;
   }
 
-  /* 值气泡：挂在拇指里，跟着拇指一起走位。默认只在推动那一刻露面 */
+  /* 值气泡：挂在拇指里，跟着拇指一起走位。默认只在推动那一刻露面。
+     气泡宽度由文字撑出，只能靠平移回中：两侧 inset 都钉在 50% 再靠自动外边距回中时可用宽度是 0，
+     气泡比它宽，自动外边距按规范取 0，气泡从拇指中线起排、偏出半个自身宽。平移乘书写方向的符号，
+     rtl 下行内分量掉头。拖动时拇指放大，气泡按同一比例反向缩回、与拇指同一段过渡：文字不跟着放大，
+     缩放原点在贴着拇指那一边 */
   [data-scope='color-slider'][data-part='value-text'] {
     position: absolute;
     inset-block-end: 100%;
-    inset-inline: 50%;
+    inset-inline-start: 50%;
     inline-size: max-content;
     margin-block-end: var(--xh-color-slider-value-text-offset, var(--xh-space-2));
-    margin-inline: auto;
+    translate: calc(-50% * var(--xh-direction-sign)) 0;
+    transform-origin: 50% 100%;
     padding-block: var(--xh-color-slider-value-text-py, var(--xh-space-0_5));
     padding-inline: var(--xh-color-slider-value-text-px, var(--xh-space-2));
     border-radius: var(--xh-color-slider-value-text-radius, var(--xh-shape-control));
@@ -199,7 +208,9 @@
     /* 气泡贴在拇指上方，指针要落到拇指上，不能被它挡住 */
     pointer-events: none;
     opacity: 0;
-    transition: opacity var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+    transition:
+      opacity var(--xh-motion-duration-micro) var(--xh-motion-ease-enter),
+      scale var(--xh-motion-duration-nudge) var(--xh-motion-ease-enter-strong);
   }
 
   [data-scope='color-slider'][data-part='value-text'][hidden] {
@@ -208,15 +219,18 @@
 
   [data-scope='color-slider'][data-part='value-text'][data-dragging] {
     opacity: 1;
+    scale: calc(1 / var(--xh-_color-slider-thumb-scale, 1));
   }
 
-  /* 竖排轨道的气泡挪到行侧：压在拇指上方会挡住上一档的值 */
+  /* 竖排轨道的气泡挪到行侧：压在拇指上方会挡住上一档的值；反向缩放的原点换到贴着拇指的行首那一侧 */
   [data-scope='color-slider'][data-part='value-text'][data-orientation='vertical'] {
     inset-block: 50%;
     inset-inline: 100% auto;
     block-size: max-content;
     margin-block: auto;
     margin-inline: var(--xh-color-slider-value-text-offset, var(--xh-space-2)) 0;
+    translate: none;
+    transform-origin: calc(50% - 50% * var(--xh-direction-sign)) 50%;
   }
 
   /* —— 尺寸 —— */
@@ -239,13 +253,6 @@
 
   /* hidden-input 是 type=hidden 的原生输入，浏览器本就不渲染它，这里一条声明都不给。 */
 
-  @media (prefers-reduced-motion: reduce) {
-    [data-scope='color-slider'][data-part='thumb'],
-    [data-scope='color-slider'][data-part='value-text'] {
-      transition: none;
-    }
-  }
-
   /*
    * 高对比档：轨道画的就是颜色本身，被系统换掉之后整条滑杆不再能调色。
    * 轨道与拇指退出强制着色保住原色，各补一圈系统描边把它们从背景里框出来。