@xihan-ui/styles 1.0.0-alpha.1 → 1.0.0-alpha.3

package/css/time-picker.css

@@ -1,11 +1,102 @@
 @layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  [data-scope='time-picker'] {
+    --xh-time-picker-skin: 1;
+  }
+
+  /* 坐标由定位引擎写进 style（inset-inline-start / inset-block-start），这里只定位模式与层级 */
+  [data-scope='time-picker'][data-part='positioner'] {
+    position: fixed;
+    z-index: var(--xh-time-picker-layer, var(--xh-layer-popover));
+    /* 空壳不吃指针，交互只发生在 content 里 */
+    pointer-events: none;
+  }
+
+  /* 锚点被滚出可视区：整个浮层随之收起 */
+  [data-scope='time-picker'][data-part='positioner'][data-hidden] {
+    visibility: hidden;
+  }
+
+  /* 私有槽同时声明在根与 positioner 上：浮层被搬到 portal 落点，不是根的后代，继承不过去 */
+  [data-scope='time-picker']:is([data-part='root'], [data-part='positioner']) {
+    /* 尺寸档只换这几个私有槽，标题、输入行与浮层里的格子都从这两处继承它们，
+       换档不必给每个部件各写一条选择器 */
+    --xh-_time-picker-control-h: var(--xh-control-h-md);
+    --xh-_time-picker-control-px: var(--xh-control-px-md);
+    --xh-_time-picker-gap: var(--xh-control-gap-md);
+    --xh-_time-picker-font-size: var(--xh-text-body-size);
+    --xh-_time-picker-label-font-size: var(--xh-text-label-size);
+    --xh-_time-picker-item-px: var(--xh-control-px-md);
+
+    /* 形态档只换这三个私有槽：底色与两档描边 */
+    --xh-_time-picker-control-bg: var(--xh-bg-canvas);
+    --xh-_time-picker-control-border: var(--xh-border-control);
+    --xh-_time-picker-control-border-hover: var(--xh-border-control-hover);
+
+    /* 聚焦环、段位反白与列里的选中随语气走。没写 data-tone 时这几个 --xh-_tone* 没被声明，
+       退回原来的焦点色与品牌色 */
+    --xh-_time-picker-ring: var(--xh-ring-focus);
+    --xh-_time-picker-accent: var(--xh-_tone, var(--xh-bg-brand));
+    --xh-_time-picker-accent-hover: var(--xh-_tone-hover, var(--xh-bg-brand-hover));
+    --xh-_time-picker-accent-fg: var(--xh-_tone-on, var(--xh-fg-on-brand));
+  }
+
   /* 与文本框、时间输入同一套堆叠：标签一行、控件一行 */
   [data-scope='time-picker'][data-part='root'] {
+    /* 作者塞进指示符槽的图标跟着字号走，与皮肤画的兜底字形同一把尺 */
+    --xh-icon-size: var(--xh-time-picker-icon-size, var(--xh-glyph-size-md));
+
     display: inline-flex;
     flex-direction: column;
     gap: var(--xh-time-picker-gap, var(--xh-space-1));
   }
 
+  /* —— 尺寸 —— */
+  /* 缺省档写在上面的基础规则里 */
+  [data-scope='time-picker']:is([data-part='root'], [data-part='positioner'])[data-size='sm'] {
+    --xh-icon-size: var(--xh-time-picker-icon-size, var(--xh-glyph-size-sm));
+    --xh-_time-picker-control-h: var(--xh-control-h-sm);
+    --xh-_time-picker-control-px: var(--xh-control-px-sm);
+    --xh-_time-picker-gap: var(--xh-control-gap-sm);
+    --xh-_time-picker-font-size: var(--xh-control-font-sm);
+    --xh-_time-picker-label-font-size: var(--xh-control-font-sm);
+    --xh-_time-picker-item-px: var(--xh-control-px-sm);
+  }
+
+  [data-scope='time-picker']:is([data-part='root'], [data-part='positioner'])[data-size='lg'] {
+    --xh-icon-size: var(--xh-time-picker-icon-size, var(--xh-glyph-size-lg));
+    --xh-_time-picker-control-h: var(--xh-control-h-lg);
+    --xh-_time-picker-control-px: var(--xh-control-px-lg);
+    --xh-_time-picker-gap: var(--xh-control-gap-lg);
+    --xh-_time-picker-font-size: var(--xh-control-font-lg);
+    --xh-_time-picker-label-font-size: var(--xh-control-font-lg);
+    --xh-_time-picker-item-px: var(--xh-control-px-lg);
+  }
+
+  /* —— 形态 —— */
+  /* 输入类不做实心档：填满一个要往里打字的框，字与底就没法同时读。
+     形态只决定底与描边怎么画，用哪族颜色由 data-tone 决定 */
+  [data-scope='time-picker']:is([data-part='root'], [data-part='positioner'])[data-variant='outline'] {
+    --xh-_time-picker-control-bg: var(--xh-bg-canvas);
+    --xh-_time-picker-control-border: var(--xh-border-control);
+    --xh-_time-picker-control-border-hover: var(--xh-border-control-hover);
+  }
+
+  /* 填充式：底色顶替描边表达边界。描边只退成透明而不去掉，1px 的位置留着，
+     与 outline 档并排时基线对得上、聚焦画描边也不引起跳动 */
+  [data-scope='time-picker']:is([data-part='root'], [data-part='positioner'])[data-variant='subtle'] {
+    --xh-_time-picker-control-bg: var(--xh-_tone-subtle, var(--xh-bg-subtle));
+    --xh-_time-picker-control-border: transparent;
+    --xh-_time-picker-control-border-hover: var(--xh-_tone-border, var(--xh-border-control-hover));
+  }
+
+  /* 无框：底与常态描边透明，悬停与聚焦浮出描边 */
+  [data-scope='time-picker']:is([data-part='root'], [data-part='positioner'])[data-variant='ghost'] {
+    --xh-_time-picker-control-bg: transparent;
+    --xh-_time-picker-control-border: transparent;
+    --xh-_time-picker-control-border-hover: var(--xh-_tone-border, var(--xh-border-control-hover));
+  }
+
   /* 声明了 display 就盖掉了 UA 的 [hidden]{display:none}，收起态得自己还回去 */
   [data-scope='time-picker'][data-part='root'][hidden] {
     display: none;
@@ -13,12 +104,9 @@
 
   [data-scope='time-picker'][data-part='label'] {
     color: var(--xh-time-picker-label-fg, var(--xh-fg-default));
-    font-size: var(--xh-time-picker-label-font-size, var(--xh-text-label-size));
+    font-size: var(--xh-time-picker-label-font-size, var(--xh-_time-picker-label-font-size));
     font-weight: var(--xh-time-picker-label-font-weight, var(--xh-text-label-weight));
     line-height: var(--xh-leading-none);
-    /* 点标题会把焦点送到第一段（段不是能被 for 指向的原生控件，这条由连接层接管），
-       指针得如实反映它可点 */
-    cursor: pointer;
   }
 
   [data-scope='time-picker'][data-part='label'][data-disabled] {
@@ -29,19 +117,20 @@
   /* 画成一个框的是 control：几段文字、展开按钮、清空按钮要看起来是一体的，
      边框长在其中任何一个身上都会把另外几个割在框外 */
   [data-scope='time-picker'][data-part='control'] {
+    min-inline-size: var(--xh-time-picker-control-min-w, var(--xh-control-min-w));
     display: inline-flex;
     align-items: center;
-    gap: var(--xh-time-picker-control-gap, var(--xh-control-gap-md));
-    block-size: var(--xh-time-picker-control-h, var(--xh-control-h-md));
-    padding-inline: var(--xh-time-picker-control-px, var(--xh-control-px-md));
+    gap: var(--xh-time-picker-control-gap, var(--xh-_time-picker-gap));
+    block-size: var(--xh-time-picker-control-h, var(--xh-_time-picker-control-h));
+    padding-inline: var(--xh-time-picker-control-px, var(--xh-_time-picker-control-px));
     padding-block: 0;
-    border: var(--xh-stroke-thin) solid var(--xh-time-picker-control-border, var(--xh-border-control));
+    border: var(--xh-stroke-thin) solid var(--xh-time-picker-control-border, var(--xh-_time-picker-control-border));
     border-radius: var(--xh-time-picker-control-radius, var(--xh-shape-control));
-    background: var(--xh-time-picker-control-bg, var(--xh-bg-canvas));
+    background: var(--xh-time-picker-control-bg, var(--xh-_time-picker-control-bg));
     color: var(--xh-time-picker-control-fg, var(--xh-fg-default));
     /* 表单控件不继承页面字体，只给字号会让它用 UA 默认字族，与周围文本对不上 */
     font-family: inherit;
-    font-size: var(--xh-time-picker-font-size, var(--xh-text-body-size));
+    font-size: var(--xh-time-picker-font-size, var(--xh-_time-picker-font-size));
     /* 等宽数字：各位字宽不一时逐段填入会让整行左右跳 */
     font-variant-numeric: tabular-nums;
     line-height: var(--xh-leading-normal);
@@ -54,17 +143,22 @@
 
   /* hover 只在中性态换描边：invalid 正拿边框颜色说事，被 hover 盖掉那条信息就没了 */
   [data-scope='time-picker'][data-part='control']:hover:not([data-disabled], [data-invalid]) {
-    border-color: var(--xh-time-picker-control-border-hover, var(--xh-border-control-hover));
+    border-color: var(--xh-time-picker-control-border-hover, var(--xh-_time-picker-control-border-hover));
   }
 
   /* 焦点真正落在段或按钮上，但整块看起来才是一个控件：内部有焦点时整框亮起来。
      control 自己不占 Tab 位，所以这里写的是 focus-within 而不是 focus-visible */
   [data-scope='time-picker'][data-part='control']:focus-within:not([data-disabled]) {
-    border-color: var(--xh-time-picker-control-border-focus, var(--xh-ring-focus));
+    border-color: var(--xh-time-picker-control-border-focus, var(--xh-_tone, var(--xh-border-control-focus)));
+    outline: var(--xh-ring-width) solid var(--xh-_time-picker-ring);
+    outline-offset: var(--xh-ring-offset);
   }
 
   [data-scope='time-picker'][data-part='control'][data-invalid] {
-    border-color: var(--xh-time-picker-control-border-invalid, var(--xh-color-danger-500));
+    border-color: var(--xh-time-picker-control-border-invalid, var(--xh-border-invalid));
+
+    /* 校验失败时环也跟着变红：两圈等宽相邻却一红一蓝，读的人不知道哪个才是当前状态 */
+    --xh-_time-picker-ring: var(--xh-ring-invalid);
   }
 
   /* 只读仍可聚焦、可换段，所以不置灰，只把底色压下去表示"改不动" */
@@ -79,13 +173,25 @@
     cursor: not-allowed;
   }
 
-  /* 每一段是一小块可聚焦区，紧挨着排；分隔符由作者写在段与段之间的普通节点里，
-     不在角色表内，所以间距只能长在段自己身上 */
+  /* 段位与作者写在段间的分隔符都在这一层里：它占满盒里剩下的宽度，
+     尾部按钮因此靠在框内末端 */
+  [data-scope='time-picker'][data-part='segment-group'] {
+    display: inline-flex;
+    flex: 1 1 auto;
+    align-items: center;
+    min-inline-size: 0;
+  }
+
+  [data-scope='time-picker'][data-part='segment-group'][hidden] {
+    display: none;
+  }
+
+  /* 每一段是一小块可聚焦区，紧挨着排；间距长在段自己身上 */
   [data-scope='time-picker'][data-part='input'] {
     display: inline-block;
-    padding-inline: var(--xh-time-picker-segment-px, var(--xh-space-0_5));
+    padding-inline: var(--xh-time-picker-segment-px, var(--xh-space-1));
     padding-block: 0;
-    border-radius: var(--xh-time-picker-segment-radius, var(--xh-radius-sm));
+    border-radius: var(--xh-time-picker-segment-radius, var(--xh-shape-inset));
     color: inherit;
     font-variant-numeric: inherit;
     text-align: center;
@@ -104,21 +210,21 @@
 
   /* 还没填的段压成弱色：一行里哪几段是占位符，一眼要看得出来 */
   [data-scope='time-picker'][data-part='input'][data-placeholder] {
-    color: var(--xh-time-picker-segment-fg-placeholder, var(--xh-fg-subtle));
+    color: var(--xh-time-picker-placeholder-fg, var(--xh-fg-subtle));
   }
 
   /* 一行段长得差不多，光有边框亮起来看不出正在改哪一段：当前段必须自己有底色。
      data-focus 由机器给（它知道谁是当前段），:focus-visible 兜住机器状态还没回流的那一帧 */
   [data-scope='time-picker'][data-part='input'][data-focus]:not([data-disabled]),
   [data-scope='time-picker'][data-part='input']:focus-visible {
-    background: var(--xh-time-picker-segment-bg-focus, var(--xh-bg-brand));
-    color: var(--xh-time-picker-segment-fg-focus, var(--xh-fg-on-brand));
+    background: var(--xh-time-picker-segment-bg-focus, var(--xh-_time-picker-accent));
+    color: var(--xh-time-picker-segment-fg-focus, var(--xh-_time-picker-accent-fg));
     outline: none;
   }
 
   /* 焦点态用了品牌底色之后，占位符那条弱色会被它盖住，这里明确让位给焦点态 */
   [data-scope='time-picker'][data-part='input'][data-focus][data-placeholder]:not([data-disabled]) {
-    color: var(--xh-time-picker-segment-fg-focus, var(--xh-fg-on-brand));
+    color: var(--xh-time-picker-segment-fg-focus, var(--xh-_time-picker-accent-fg));
   }
 
   [data-scope='time-picker'][data-part='input']:hover:not([data-focus], [data-disabled]) {
@@ -146,82 +252,75 @@
     background: var(--xh-time-picker-action-bg, transparent);
     color: var(--xh-time-picker-action-fg, var(--xh-fg-muted));
     font-family: inherit;
-    font-size: var(--xh-time-picker-action-font-size, var(--xh-font-size-sm));
+    font-size: var(--xh-time-picker-action-font-size, var(--xh-text-secondary-size));
     line-height: var(--xh-leading-none);
     cursor: pointer;
     user-select: none;
-    transition: background var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+    transition:
+      background var(--xh-motion-duration-micro) var(--xh-motion-ease-enter),
+      scale var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
   }
 
+
   [data-scope='time-picker'][data-part='trigger'][hidden],
   [data-scope='time-picker'][data-part='clear-trigger'][hidden] {
     display: none;
   }
 
-  /* 触发器把整行推到最右：它与清空按钮之间不留缝，两者一起靠框内末端 */
-  [data-scope='time-picker'][data-part='trigger'] {
-    margin-inline-start: auto;
-  }
-
   [data-scope='time-picker'][data-part='trigger']:hover:not(:disabled),
-  [data-scope='time-picker'][data-part='clear-trigger']:hover:not(:disabled) {
+  [data-scope='time-picker'][data-part='clear-trigger']:hover {
     background: var(--xh-time-picker-action-bg-hover, var(--xh-bg-subtle-hover));
     color: var(--xh-time-picker-action-fg-hover, var(--xh-fg-default));
   }
 
-  [data-scope='time-picker'][data-part='trigger']:active:not(:disabled),
-  [data-scope='time-picker'][data-part='clear-trigger']:active:not(:disabled) {
+  [data-scope='time-picker'][data-part='trigger']:active:not(:disabled) {
     background: var(--xh-time-picker-action-bg-active, var(--xh-bg-subtle-active));
   }
 
-  /* 触发器是常规 Tab 停靠点，落焦必须看得见；清空按钮退出了 Tab 序列，
-     这条是给程序化聚焦兜底 */
-  [data-scope='time-picker'][data-part='trigger']:focus-visible,
+  /* 清空钮按下时换底并微缩，给指针一个按到了的反馈 */
+  [data-scope='time-picker'][data-part='clear-trigger']:active {
+    background: var(--xh-time-picker-action-bg-active, var(--xh-bg-subtle-active));
+    scale: var(--xh-motion-scale-press);
+  }
+
+  /* 清空按钮退出了 Tab 序列，这条是给程序化聚焦兜底；
+     展开钮是常规 Tab 停靠点，它落焦时环由盒的 :focus-within 画，这里不再套一圈 */
   [data-scope='time-picker'][data-part='clear-trigger']:focus-visible {
-    outline: var(--xh-ring-width) solid var(--xh-ring-focus);
+    outline: var(--xh-ring-width) solid var(--xh-_time-picker-ring);
     outline-offset: var(--xh-ring-offset);
   }
 
-  /* 两个按钮都是单体控件，禁用走原生 :disabled（列里的格一律 data-disabled） */
-  [data-scope='time-picker'][data-part='trigger']:disabled,
-  [data-scope='time-picker'][data-part='clear-trigger']:disabled {
+  /* 下拉钮是单体控件，禁用走原生 :disabled（列里的格一律 data-disabled）；
+     清空钮没值即收起，不做灰态 */
+  [data-scope='time-picker'][data-part='trigger']:disabled {
     background: var(--xh-time-picker-action-bg, transparent);
     color: var(--xh-fg-disabled);
     cursor: not-allowed;
   }
 
-  /* 坐标由定位引擎写进 style（inset-inline-start / inset-block-start），这里只定位模式与层级 */
-  [data-scope='time-picker'][data-part='positioner'] {
-    position: fixed;
-    z-index: var(--xh-layer-popover);
-    /* 空壳不吃指针，交互只发生在 content 里 */
-    pointer-events: none;
-  }
-
-  /* 锚点被滚出可视区：整个浮层随之收起 */
-  [data-scope='time-picker'][data-part='positioner'][data-hidden] {
-    visibility: hidden;
-  }
-
   /* 几列并排：整体高度由列自己撑，滚动发生在列里而不是整个面板上——
      整面板滚会让时列与分列一起走，挑分的时候时就看不见了 */
   [data-scope='time-picker'][data-part='content'] {
     display: flex;
     align-items: stretch;
-    padding: var(--xh-time-picker-content-p, var(--xh-space-1));
+    padding-block: var(--xh-time-picker-content-py, var(--xh-space-1));
+    padding-inline: var(--xh-time-picker-content-px, var(--xh-space-1));
+    /* 列自己定高，面板整体不该再长过页内滚动面那一档 */
+    max-block-size: var(--xh-time-picker-content-max-h, var(--xh-viewport-h-lg));
     border: var(--xh-stroke-thin) solid var(--xh-time-picker-content-border, var(--xh-border-default));
     border-radius: var(--xh-time-picker-content-radius, var(--xh-shape-surface));
     background: var(--xh-time-picker-content-bg, var(--xh-bg-surface));
     color: var(--xh-time-picker-content-fg, var(--xh-fg-default));
     font-variant-numeric: tabular-nums;
-    box-shadow: var(--xh-time-picker-content-shadow, var(--xh-elevation-2));
+    box-shadow: var(--xh-time-picker-content-shadow, var(--xh-elevation-floating));
     pointer-events: auto;
   }
 
-  /* display 会盖掉 hidden 属性的 UA 规则，收起态显式让位 */
-  [data-scope='time-picker'][data-part='content'][hidden] {
-    display: none;
-  }
+  /* 这里刻意没有 [data-part='content'][hidden] { display: none }，与 dialog 一致：
+     收起态连接层会给 content 打 hidden，而上面那条 display 正是要盖掉 UA 的
+     [hidden]{display:none}——退场动画得先能播。presence 读的是 content 的 animationName，
+     真正的收起由宿主在退场结束后落成内联 display:none（Vue 那边直接不渲染）。
+     其余声明了 display 的角色节点仍补 [hidden]，那几处没有退场动画。 */
 
   /* 面板本身不承载焦点（焦点在某一列的某一格上），落焦时不画环 */
   [data-scope='time-picker'][data-part='content']:focus-visible {
@@ -229,7 +328,68 @@
   }
 
   [data-scope='time-picker'][data-part='content'][data-state='open'] {
-    animation: xh-time-picker-panel-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter);
+    animation: xh-pop-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter);
+  }
+
+  /* 退场：收起那一帧 hidden 由退场闸门押后，这里才播得出来。forwards 把末态钉住，
+     免得动画结束到真收起之间闪一下原样 */
+  [data-scope='time-picker'][data-part='content'][data-state='closed'] {
+    animation: xh-pop-out var(--xh-motion-duration-exit) var(--xh-motion-ease-exit) forwards;
+  }
+
+  /* 快捷选项也是一列，与时分秒那几列并排，排在行内起始一侧 */
+  [data-scope='time-picker'][data-part='presets'] {
+    display: flex;
+    flex: none;
+    flex-direction: column;
+    gap: var(--xh-time-picker-presets-gap, var(--xh-space-0_5));
+    max-block-size: var(--xh-time-picker-presets-h, var(--xh-viewport-h-sm));
+    padding-inline: var(--xh-time-picker-presets-px, var(--xh-space-1));
+    overflow-y: auto;
+    border-inline-end: var(--xh-stroke-thin) solid var(--xh-time-picker-column-divider, var(--xh-border-subtle));
+    scrollbar-width: thin;
+  }
+
+  [data-scope='time-picker'][data-part='presets'][hidden] {
+    display: none;
+  }
+
+  [data-scope='time-picker'][data-part='preset'] {
+    padding-block: var(--xh-time-picker-preset-py, var(--xh-space-1));
+    padding-inline: var(--xh-time-picker-preset-px, var(--xh-space-3));
+    border-radius: var(--xh-shape-control);
+    font-size: var(--xh-text-secondary-size);
+    line-height: var(--xh-leading-normal);
+    white-space: nowrap;
+    cursor: pointer;
+    user-select: none;
+  }
+
+  /* 悬停与键盘锚点共用中性轻档，命中那一条才走品牌底；禁用的不响应悬停 */
+  [data-scope='time-picker'][data-part='preset']:hover:not([data-disabled]) {
+    background: var(--xh-time-picker-preset-bg-hover, var(--xh-bg-subtle));
+  }
+
+  [data-scope='time-picker'][data-part='preset']:focus-visible,
+  [data-scope='time-picker'][data-part='presets']:focus-visible {
+    outline: var(--xh-ring-width) solid var(--xh-ring-focus);
+    outline-offset: calc(-1 * var(--xh-ring-width));
+  }
+
+  /* 命中的那一条与选中的格子同一副实心底：同一份浮层里两种「选中」不该长成两个样 */
+  [data-scope='time-picker'][data-part='preset'][data-state='checked'] {
+    background: var(--xh-time-picker-preset-bg-checked, var(--xh-_time-picker-accent));
+    color: var(--xh-time-picker-preset-fg-checked, var(--xh-_time-picker-accent-fg));
+    font-weight: var(--xh-font-weight-medium);
+  }
+
+  [data-scope='time-picker'][data-part='preset'][data-state='checked']:hover:not([data-disabled]) {
+    background: var(--xh-time-picker-preset-bg-checked-hover, var(--xh-_time-picker-accent-hover));
+  }
+
+  [data-scope='time-picker'][data-part='preset'][data-disabled] {
+    color: var(--xh-time-picker-preset-fg-disabled, var(--xh-fg-disabled));
+    cursor: not-allowed;
   }
 
   /* 一列一个滚动区：列与列之间用细分隔线，视觉上"时 | 分 | 秒"三栏分明 */
@@ -239,7 +399,8 @@
     flex-direction: column;
     gap: var(--xh-time-picker-column-gap, var(--xh-space-0_5));
     min-inline-size: var(--xh-time-picker-column-min-w, 3.5rem);
-    max-block-size: var(--xh-time-picker-column-max-h, 12rem);
+    /* 几列并排：定高而不是随内容收，否则时列与分列的可选值一多一少就错位 */
+    block-size: var(--xh-time-picker-column-h, var(--xh-viewport-h-sm));
     padding-inline: var(--xh-time-picker-column-px, var(--xh-space-1));
     overflow-y: auto;
     /* 滚动容器在某些浏览器里会被自动塞进 Tab 序列，是否画环见下方按 tabindex 分档的两条 */
@@ -258,7 +419,7 @@
   /* 焦点落在列上有两种情形：指针打开、这一段还空着、还没有任何格当锚点，或整列被界裁空。
      那一刻它认领着 Tab 位，环画在列内沿；有锚点时环长在格上，列不再画 */
   [data-scope='time-picker'][data-part='column'][tabindex='0']:focus-visible {
-    outline: var(--xh-ring-width) solid var(--xh-ring-focus);
+    outline: var(--xh-ring-width) solid var(--xh-_time-picker-ring);
     outline-offset: calc(-1 * var(--xh-ring-width));
   }
 
@@ -272,10 +433,10 @@
     align-items: center;
     justify-content: center;
     padding-block: var(--xh-time-picker-item-py, var(--xh-space-1_5));
-    padding-inline: var(--xh-time-picker-item-px, var(--xh-control-px-md));
+    padding-inline: var(--xh-time-picker-item-px, var(--xh-_time-picker-item-px));
     border-radius: var(--xh-time-picker-item-radius, var(--xh-shape-control));
     color: var(--xh-time-picker-item-fg, var(--xh-fg-default));
-    font-size: var(--xh-time-picker-item-font-size, var(--xh-text-body-size));
+    font-size: var(--xh-time-picker-item-font-size, var(--xh-_time-picker-font-size));
     /* 居中的单个数字格没有截断层，行高保持紧排，列内多露几格 */
     line-height: var(--xh-leading-none);
     white-space: nowrap;
@@ -298,8 +459,8 @@
   }
 
   [data-scope='time-picker'][data-part='item'][data-state='checked'] {
-    background: var(--xh-time-picker-item-bg-checked, var(--xh-bg-brand));
-    color: var(--xh-time-picker-item-fg-checked, var(--xh-fg-on-brand));
+    background: var(--xh-time-picker-item-bg-checked, var(--xh-_time-picker-accent));
+    color: var(--xh-time-picker-item-fg-checked, var(--xh-_time-picker-accent-fg));
     font-weight: var(--xh-time-picker-item-weight-checked, var(--xh-font-weight-medium));
   }
 
@@ -307,11 +468,11 @@
      不写这条就只有底色被换走、文字仍是品牌底上的反白色 */
   [data-scope='time-picker'][data-part='item'][data-state='checked'][data-highlighted]:not([data-disabled]),
   [data-scope='time-picker'][data-part='item'][data-state='checked']:hover:not([data-disabled]) {
-    background: var(--xh-time-picker-item-bg-checked-hover, var(--xh-bg-brand-hover));
+    background: var(--xh-time-picker-item-bg-checked-hover, var(--xh-_time-picker-accent-hover));
   }
 
   [data-scope='time-picker'][data-part='item']:focus-visible {
-    outline: var(--xh-ring-width) solid var(--xh-ring-focus);
+    outline: var(--xh-ring-width) solid var(--xh-_time-picker-ring);
     /* 往内收：选项在滚动列里挨着排，环画在外沿会被列的溢出裁掉 */
     outline-offset: calc(-1 * var(--xh-ring-offset));
   }
@@ -338,20 +499,54 @@
     white-space: nowrap;
     pointer-events: none;
   }
+
+  /* 没写内容就由皮肤画兜底字形；作者往部件里塞了自己的图形，这几条即不命中 */
+  [data-scope='time-picker'][data-part='clear-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;
+  }
+
+  [data-scope='time-picker'][data-part='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-chevron-down) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-chevron-down) center / contain no-repeat;
+  }
 }
 
 @layer xihan.motion {
   /* 浮层进场：淡入 + 轻微上浮，方向与它从输入行下方展开一致。
      关键帧写在自己文件里并带组件前缀，不去动共享的 motion.css */
-  @keyframes xh-time-picker-panel-in {
+  @keyframes xh-pop-in {
     from {
       opacity: 0;
-      translate: 0 calc(-1 * var(--xh-space-1));
+      scale: var(--xh-motion-scale-enter);
     }
 
     to {
       opacity: 1;
-      translate: 0 0;
+      scale: 1;
+    }
+  }
+  @keyframes xh-pop-out {
+    from {
+      opacity: 1;
+      scale: 1;
+    }
+
+    to {
+      opacity: 0;
+      scale: var(--xh-motion-scale-enter);
     }
   }
 }

package/css/time.css

@@ -1,4 +1,9 @@
 @layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  [data-scope='time'] {
+    --xh-time-skin: 1;
+  }
+
   [data-scope='time'][data-part='root'] {
     color: var(--xh-time-fg, var(--xh-fg-default));
     /* 等宽数字：秒数跳动时后面的字符不会左右挪 */

package/css/timeline.css

@@ -1,12 +1,17 @@
 @layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  [data-scope='timeline'] {
+    --xh-timeline-skin: 1;
+  }
+
   [data-scope='timeline'][data-part='root'] {
     /* 尺寸档只换这几个私有槽，条目、圆点与文字都从 root 继承它们，
        换档不必给每个部件各写一条选择器 */
-    --xh-_timeline-dot-size: 10px;
+    --xh-_timeline-dot-size: var(--xh-space-2_5);
     --xh-_timeline-gutter: var(--xh-space-3);
     --xh-_timeline-item-gap: var(--xh-space-5);
     --xh-_timeline-title-font-size: var(--xh-text-label-size);
-    --xh-_timeline-caption-font-size: var(--xh-font-size-xs);
+    --xh-_timeline-caption-font-size: var(--xh-text-caption-size);
     /* 标题首行占多高。圆点按它居中下移，圆心才落在标题这一行的中线上 */
     --xh-_timeline-line-h: calc(
       var(--xh-timeline-title-font-size, var(--xh-_timeline-title-font-size)) * var(--xh-leading-tight)
@@ -34,21 +39,21 @@
   }
 
   /* —— 尺寸 —— */
-  /* 缺省档写在上面的基础规则里。圆点直径不在控件高度那把尺上，两侧直接给像素 */
+  /* 缺省档写在上面的基础规则里。圆点直径不在控件高度那把尺上，三档走空间尺相邻的三格 */
   [data-scope='timeline'][data-part='root'][data-size='sm'] {
-    --xh-_timeline-dot-size: 8px;
+    --xh-_timeline-dot-size: var(--xh-space-2);
     --xh-_timeline-gutter: var(--xh-space-2);
     --xh-_timeline-item-gap: var(--xh-space-4);
-    --xh-_timeline-title-font-size: var(--xh-font-size-sm);
+    --xh-_timeline-title-font-size: var(--xh-control-font-sm);
     /* 字号档最小就是 xs，时刻文本不再往下走，故不重声明 caption */
   }
 
   [data-scope='timeline'][data-part='root'][data-size='lg'] {
-    --xh-_timeline-dot-size: 12px;
+    --xh-_timeline-dot-size: var(--xh-space-3);
     --xh-_timeline-gutter: var(--xh-space-4);
     --xh-_timeline-item-gap: var(--xh-space-6);
-    --xh-_timeline-title-font-size: var(--xh-font-size-lg);
-    --xh-_timeline-caption-font-size: var(--xh-font-size-sm);
+    --xh-_timeline-title-font-size: var(--xh-control-font-lg);
+    --xh-_timeline-caption-font-size: var(--xh-text-secondary-size);
   }
 
   /* —— 条目 —— */
@@ -87,7 +92,7 @@
     justify-content: center;
     inline-size: var(--xh-timeline-indicator-size, var(--xh-_timeline-dot-size));
     block-size: var(--xh-timeline-indicator-size, var(--xh-_timeline-dot-size));
-    border-radius: var(--xh-radius-full);
+    border-radius: var(--xh-shape-pill);
     /* 使用者令牌排在语气之前；两者都没有时退回一个中性的实心点 */
     background: var(--xh-timeline-indicator-bg, var(--xh-_tone-soft, var(--xh-fg-muted)));
     color: var(--xh-timeline-indicator-fg, var(--xh-_tone-on, var(--xh-fg-on-brand)));
@@ -115,7 +120,7 @@
 
   /* —— 连线 —— */
   [data-scope='timeline'][data-part='connector'] {
-    border-radius: var(--xh-radius-full);
+    border-radius: var(--xh-shape-pill);
     background: var(--xh-timeline-connector-bg, var(--xh-border-default));
   }