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

package/css/text-field.css

@@ -1,15 +1,24 @@
 @layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  [data-scope='text-field'] {
+    --xh-text-field-skin: 1;
+  }
+
   /* root 只负责纵向堆叠：标签一行、输入行一行。
-     输入框与清空按钮中间那层包裹是作者自己写的、不在角色表里，
-     所以尺寸与间距一律长在各自的角色节点上，不去假设那层存在 */
+     输入框与清空按钮收进 control 部件即得一体式：视觉盒画在 control 上，框内两件都退成透明分段。
+     不写 control 时退回两件并排的观感（下方 input 与清空按钮的基础规则原样生效） */
   [data-scope='text-field'][data-part='root'] {
+    /* 作者塞进来的图标跟着控件的尺寸档走；它自己写了 size 时仍以作者的为准 */
+    --xh-icon-size: var(--xh-text-field-icon-size, var(--xh-glyph-size-md));
+
     /* 尺寸档只换这几个私有槽，标题、输入框与清空按钮都从 root 继承它们，
        换档不必给每个部件各写一条选择器 */
     --xh-_text-field-h: var(--xh-control-h-md);
     --xh-_text-field-px: var(--xh-control-px-md);
+    --xh-_text-field-gap: var(--xh-control-gap-md);
     --xh-_text-field-font-size: var(--xh-text-body-size);
     --xh-_text-field-label-font-size: var(--xh-text-label-size);
-    --xh-_text-field-clear-font-size: var(--xh-font-size-sm);
+    --xh-_text-field-action-font-size: var(--xh-text-secondary-size);
 
     /* 形态档只换这三个私有槽：底、常态描边、悬停描边 */
     --xh-_text-field-bg: var(--xh-bg-canvas);
@@ -19,7 +28,7 @@
     /* 语气只落在聚焦这一处：环与聚焦态描边。正文颜色不归它管。
        没写 data-tone 时 --xh-_tone 没被声明，退回原来的聚焦环色与常态描边 */
     --xh-_text-field-ring: var(--xh-ring-focus);
-    --xh-_text-field-border-focus: var(--xh-text-field-input-border, var(--xh-_tone, var(--xh-border-control)));
+    --xh-_text-field-border-focus: var(--xh-text-field-input-border, var(--xh-_tone, var(--xh-border-control-focus)));
 
     display: inline-flex;
     flex-direction: column;
@@ -34,19 +43,23 @@
   /* —— 尺寸 —— */
   /* 缺省档写在上面的基础规则里 */
   [data-scope='text-field'][data-part='root'][data-size='sm'] {
+    --xh-icon-size: var(--xh-text-field-icon-size, var(--xh-glyph-size-sm));
     --xh-_text-field-h: var(--xh-control-h-sm);
     --xh-_text-field-px: var(--xh-control-px-sm);
-    --xh-_text-field-font-size: var(--xh-font-size-sm);
-    --xh-_text-field-label-font-size: var(--xh-font-size-sm);
-    --xh-_text-field-clear-font-size: var(--xh-font-size-xs);
+    --xh-_text-field-gap: var(--xh-control-gap-sm);
+    --xh-_text-field-font-size: var(--xh-control-font-sm);
+    --xh-_text-field-label-font-size: var(--xh-control-font-sm);
+    --xh-_text-field-action-font-size: var(--xh-control-caption-sm);
   }
 
   [data-scope='text-field'][data-part='root'][data-size='lg'] {
+    --xh-icon-size: var(--xh-text-field-icon-size, var(--xh-glyph-size-lg));
     --xh-_text-field-h: var(--xh-control-h-lg);
     --xh-_text-field-px: var(--xh-control-px-lg);
-    --xh-_text-field-font-size: var(--xh-font-size-lg);
-    --xh-_text-field-label-font-size: var(--xh-font-size-lg);
-    --xh-_text-field-clear-font-size: var(--xh-font-size-md);
+    --xh-_text-field-gap: var(--xh-control-gap-lg);
+    --xh-_text-field-font-size: var(--xh-control-font-lg);
+    --xh-_text-field-label-font-size: var(--xh-control-font-lg);
+    --xh-_text-field-action-font-size: var(--xh-control-caption-lg);
   }
 
   /* —— 形态 —— */
@@ -56,7 +69,7 @@
     --xh-_text-field-bg: var(--xh-bg-canvas);
     --xh-_text-field-border: var(--xh-border-control);
     --xh-_text-field-border-hover: var(--xh-border-control-hover);
-    --xh-_text-field-border-focus: var(--xh-text-field-input-border, var(--xh-_tone, var(--xh-border-control)));
+    --xh-_text-field-border-focus: var(--xh-text-field-input-border, var(--xh-_tone, var(--xh-border-control-focus)));
   }
 
   /* 填充式：底色顶替描边表达边界。描边只退成透明而不去掉，1px 的位置留着，
@@ -65,15 +78,15 @@
     --xh-_text-field-bg: var(--xh-_tone-subtle, var(--xh-bg-subtle));
     --xh-_text-field-border: transparent;
     --xh-_text-field-border-hover: var(--xh-_tone-border, var(--xh-border-control-hover));
-    --xh-_text-field-border-focus: var(--xh-_tone, var(--xh-border-control));
+    --xh-_text-field-border-focus: var(--xh-_tone, var(--xh-border-control-focus));
   }
 
-  /* 无框：底与描边都透明，平时只看得见字，悬停与聚焦才浮出边界 */
+  /* 无框：底与常态描边透明，悬停与聚焦浮出描边 */
   [data-scope='text-field'][data-part='root'][data-variant='ghost'] {
     --xh-_text-field-bg: transparent;
     --xh-_text-field-border: transparent;
     --xh-_text-field-border-hover: var(--xh-_tone-border, var(--xh-border-control-hover));
-    --xh-_text-field-border-focus: var(--xh-_tone, var(--xh-border-control));
+    --xh-_text-field-border-focus: var(--xh-_tone, var(--xh-border-control-focus));
   }
 
   [data-scope='text-field'][data-part='label'] {
@@ -87,7 +100,103 @@
     color: var(--xh-text-field-label-fg-disabled, var(--xh-fg-subtle));
   }
 
+  /* —— 一体式 control：输入框与清空按钮同框 —— */
+  /* control 是唯一的视觉盒：描边、底色、圆角、聚焦环全画在它身上，框内两件都退成透明分段。
+     :focus-within 而不是 :focus——持有焦点的是框里的输入框，被聚焦的"控件"在眼里是整个框 */
+  [data-scope='text-field'][data-part='control'] {
+    display: inline-flex;
+    align-items: center;
+    gap: var(--xh-text-field-control-gap, var(--xh-_text-field-gap));
+    min-inline-size: var(--xh-text-field-control-min-w, var(--xh-control-min-w));
+    block-size: var(--xh-text-field-control-h, var(--xh-_text-field-h));
+    padding-inline: var(--xh-text-field-control-px, var(--xh-_text-field-px));
+    border: var(--xh-stroke-thin) solid var(--xh-text-field-control-border, var(--xh-_text-field-border));
+    border-radius: var(--xh-text-field-control-radius, var(--xh-shape-control));
+    background: var(--xh-text-field-control-bg, var(--xh-_text-field-bg));
+    color: var(--xh-text-field-control-fg, var(--xh-fg-default));
+    transition: border-color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+  }
+
+  [data-scope='text-field'][data-part='control'][hidden] {
+    display: none;
+  }
+
+  /* hover 只在中性态换描边：invalid 与 at-limit 正拿边框颜色说事，
+     被 hover 盖掉那条信息就没了 */
+  [data-scope='text-field'][data-part='control']:hover:not([data-disabled], [data-invalid], [data-at-limit]) {
+    border-color: var(--xh-text-field-control-border-hover, var(--xh-_text-field-border-hover));
+  }
+
+  [data-scope='text-field'][data-part='control']:focus-within:not([data-disabled]) {
+    border-color: var(--xh-text-field-control-border-focus, var(--xh-_text-field-border-focus));
+    outline: var(--xh-ring-width) solid var(--xh-_text-field-ring);
+    outline-offset: var(--xh-ring-offset);
+  }
+
+  /* 顶到字数上限：再敲进不去，边框先给个提示。放在 invalid 之前，
+     两者同时成立时按源序让 invalid 赢 */
+  [data-scope='text-field'][data-part='control'][data-at-limit] {
+    border-color: var(--xh-text-field-control-border-at-limit, var(--xh-border-at-limit));
+  }
+
+  [data-scope='text-field'][data-part='control'][data-invalid] {
+    border-color: var(--xh-text-field-control-border-invalid, var(--xh-border-invalid));
+
+    /* 校验失败时环也跟着变红：两圈等宽相邻却一红一蓝，读的人不知道哪个才是当前状态 */
+    --xh-_text-field-ring: var(--xh-ring-invalid);
+  }
+
+  /* 只读仍可聚焦、可复制，所以不置灰，只把底色压下去表示"改不动" */
+  [data-scope='text-field'][data-part='control'][data-readonly] {
+    background: var(--xh-text-field-control-bg-readonly, var(--xh-bg-subtle));
+  }
+
+  [data-scope='text-field'][data-part='control'][data-disabled] {
+    background: var(--xh-text-field-control-bg-disabled, var(--xh-bg-subtle));
+    color: var(--xh-fg-disabled);
+    cursor: not-allowed;
+  }
+
+  /* 盒内 input：无边框无底无圆角，观感全归 control；行内内衬也归 control，
+     这里再留一份就是框内套了一圈空白。它占满剩余宽度，把清空按钮顶到最右 */
+  [data-scope='text-field'][data-part='control'] [data-part='input'] {
+    flex: 1 1 auto;
+    min-inline-size: 0;
+    block-size: 100%;
+    padding-inline: 0;
+    border: 0;
+    border-radius: 0;
+    background: transparent;
+  }
+
+  /* 盒内 input 不再自己画各态，全部交还 control。hover 这条带上与基础规则同样的
+     :not 条件：基础 hover 的特异度里有它们，不带就打不过 */
+  [data-scope='text-field'][data-part='control'] [data-part='input']:hover:not(:disabled, [data-invalid], [data-at-limit]) {
+    border-color: transparent;
+  }
+
+  [data-scope='text-field'][data-part='control'] [data-part='input']:focus-visible {
+    border-color: transparent;
+    outline: none;
+  }
+
+  [data-scope='text-field'][data-part='control'] [data-part='input'][data-at-limit],
+  [data-scope='text-field'][data-part='control'] [data-part='input'][data-invalid] {
+    border-color: transparent;
+  }
+
+  [data-scope='text-field'][data-part='control'] [data-part='input']:disabled,
+  [data-scope='text-field'][data-part='control'] [data-part='input'][readonly] {
+    background: transparent;
+  }
+
+  /* 尾部动作钮不参与分宽，宽度由它自己的方钮尺寸决定 */
+  [data-scope='text-field'][data-part='control'] [data-part='clear-trigger'] {
+    flex: none;
+  }
+
   [data-scope='text-field'][data-part='input'] {
+    min-inline-size: var(--xh-text-field-input-min-w, var(--xh-control-min-w));
     block-size: var(--xh-text-field-input-h, var(--xh-_text-field-h));
     padding-inline: var(--xh-text-field-input-px, var(--xh-_text-field-px));
     padding-block: 0;
@@ -136,11 +245,14 @@
   /* 顶到字数上限：再敲进不去，边框先给个提示。放在 invalid 之前，
      两者同时成立时按源序让 invalid 赢——真出错比"写满了"要紧 */
   [data-scope='text-field'][data-part='input'][data-at-limit] {
-    border-color: var(--xh-text-field-input-border-at-limit, var(--xh-color-warning-600));
+    border-color: var(--xh-text-field-input-border-at-limit, var(--xh-border-at-limit));
   }
 
   [data-scope='text-field'][data-part='input'][data-invalid] {
-    border-color: var(--xh-text-field-input-border-invalid, var(--xh-color-danger-500));
+    border-color: var(--xh-text-field-input-border-invalid, var(--xh-border-invalid));
+
+    /* 校验失败时环也跟着变红：两圈等宽相邻却一红一蓝，读的人不知道哪个才是当前状态 */
+    --xh-_text-field-ring: var(--xh-ring-invalid);
   }
 
   /* 只读仍可聚焦、可复制，所以不置灰，只把底色压下去表示"改不动" */
@@ -155,41 +267,42 @@
     cursor: not-allowed;
   }
 
-  /* 清空按钮画成输入框右侧的小方钮：它是 input 的兄弟节点而不是子节点，
-     没法叠进框内，只能与框等高、贴着排，靠同一套边角与高度看起来是一体的 */
+  /* 清空按钮是 input 的兄弟节点而不是子节点，由作者与 input 排成一行；
+     它按行内动作钮的尺寸画，在作者那一行里居中即与框对齐 */
   [data-scope='text-field'][data-part='clear-trigger'] {
     display: inline-flex;
     flex: none;
     align-items: center;
     justify-content: center;
-    inline-size: var(--xh-text-field-clear-size, var(--xh-_text-field-h));
-    block-size: var(--xh-text-field-clear-size, var(--xh-_text-field-h));
+    inline-size: var(--xh-text-field-action-size, var(--xh-control-action-size));
+    block-size: var(--xh-text-field-action-size, var(--xh-control-action-size));
     padding: 0;
     border: 0;
-    border-radius: var(--xh-text-field-clear-radius, var(--xh-shape-control));
-    background: var(--xh-text-field-clear-bg, transparent);
-    color: var(--xh-text-field-clear-fg, var(--xh-fg-muted));
+    border-radius: var(--xh-text-field-action-radius, var(--xh-shape-control));
+    background: var(--xh-text-field-action-bg, transparent);
+    color: var(--xh-text-field-action-fg, var(--xh-fg-muted));
     font-family: inherit;
-    font-size: var(--xh-text-field-clear-font-size, var(--xh-_text-field-clear-font-size));
+    font-size: var(--xh-text-field-action-font-size, var(--xh-_text-field-action-font-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);
   }
 
-  /* 没开 clearable 时连接层给的是 hidden 属性；上面那条 display 会把 UA 规则盖掉，
+  /* 没开 clearable 或清不了时连接层给的是 hidden 属性；上面那条 display 会把 UA 规则盖掉，
      少了这条按钮就一直杵在那儿 */
   [data-scope='text-field'][data-part='clear-trigger'][hidden] {
     display: none;
   }
 
-  [data-scope='text-field'][data-part='clear-trigger']:hover:not(:disabled) {
-    background: var(--xh-text-field-clear-bg-hover, var(--xh-bg-subtle-hover));
-    color: var(--xh-text-field-clear-fg-hover, var(--xh-fg-default));
+  [data-scope='text-field'][data-part='clear-trigger']:hover {
+    background: var(--xh-text-field-action-bg-hover, var(--xh-bg-subtle-hover));
+    color: var(--xh-text-field-action-fg-hover, var(--xh-fg-default));
   }
 
-  [data-scope='text-field'][data-part='clear-trigger']:active:not(:disabled) {
-    background: var(--xh-text-field-clear-bg-active, var(--xh-bg-subtle-active));
+  [data-scope='text-field'][data-part='clear-trigger']:active {
+    background: var(--xh-text-field-action-bg-active, var(--xh-bg-subtle-active));
+    scale: var(--xh-motion-scale-press);
   }
 
   /* 按钮不占 Tab 位（tabindex=-1）也不抢焦点，正常操作走不到这里；
@@ -199,10 +312,15 @@
     outline-offset: var(--xh-ring-offset);
   }
 
-  /* 框里没字、只读或禁用时按钮转灰但不收起：位置留着，敲进第一个字就亮 */
-  [data-scope='text-field'][data-part='clear-trigger']:disabled {
-    background: var(--xh-text-field-clear-bg, transparent);
-    color: var(--xh-fg-disabled);
-    cursor: not-allowed;
+  /* 没写内容就由皮肤画兜底字形；作者往部件里塞了自己的图形，这几条即不命中 */
+  [data-scope='text-field'][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;
   }
 }

package/css/thread.css

@@ -1,4 +1,9 @@
 @layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  [data-scope='thread'] {
+    --xh-thread-skin: 1;
+  }
+
   /* 自建定位上下文，作为绝对定位的回到底部按钮的参照系；
      block-size: 100% 让高度由外部决定，使滚动发生在内部。 */
   [data-scope='thread'][data-part='root'] {
@@ -61,7 +66,7 @@
     border-radius: var(--xh-thread-scroll-button-radius, var(--xh-shape-pill));
     background: var(--xh-thread-scroll-button-bg, var(--xh-bg-surface));
     color: var(--xh-thread-scroll-button-fg, var(--xh-fg-default));
-    box-shadow: var(--xh-thread-scroll-button-shadow, var(--xh-elevation-2));
+    box-shadow: var(--xh-thread-scroll-button-shadow, var(--xh-elevation-sheet));
     /* 按钮默认不继承页面字族，显式继承 */
     font-family: inherit;
     font-size: var(--xh-thread-scroll-button-font-size, var(--xh-text-label-size));

package/css/time-field.css

@@ -1,9 +1,18 @@
 @layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  [data-scope='time-field'] {
+    --xh-time-field-skin: 1;
+  }
+
   /* 与文本框、数字框同一套堆叠：标签一行、控件一行 */
   [data-scope='time-field'][data-part='root'] {
+    /* 作者塞进来的图标跟着控件的尺寸档走；它自己写了 size 时仍以作者的为准 */
+    --xh-icon-size: var(--xh-time-field-icon-size, var(--xh-glyph-size-md));
+
     /* 尺寸档只换这四个私有槽，标题与控件都从 root 继承它们，换档不必给每个部件各写一条选择器 */
     --xh-_time-field-control-h: var(--xh-control-h-md);
     --xh-_time-field-control-px: var(--xh-control-px-md);
+    --xh-_time-field-gap: var(--xh-control-gap-md);
     --xh-_time-field-font-size: var(--xh-text-body-size);
     --xh-_time-field-label-font-size: var(--xh-text-label-size);
     /* 形态档只换这三个私有槽：底色与两档描边 */
@@ -22,17 +31,21 @@
 
   /* —— 尺寸 —— */
   [data-scope='time-field'][data-part='root'][data-size='sm'] {
+    --xh-icon-size: var(--xh-time-field-icon-size, var(--xh-glyph-size-sm));
     --xh-_time-field-control-h: var(--xh-control-h-sm);
     --xh-_time-field-control-px: var(--xh-control-px-sm);
-    --xh-_time-field-font-size: var(--xh-font-size-sm);
-    --xh-_time-field-label-font-size: var(--xh-font-size-sm);
+    --xh-_time-field-gap: var(--xh-control-gap-sm);
+    --xh-_time-field-font-size: var(--xh-control-font-sm);
+    --xh-_time-field-label-font-size: var(--xh-control-font-sm);
   }
 
   [data-scope='time-field'][data-part='root'][data-size='lg'] {
+    --xh-icon-size: var(--xh-time-field-icon-size, var(--xh-glyph-size-lg));
     --xh-_time-field-control-h: var(--xh-control-h-lg);
     --xh-_time-field-control-px: var(--xh-control-px-lg);
-    --xh-_time-field-font-size: var(--xh-font-size-lg);
-    --xh-_time-field-label-font-size: var(--xh-font-size-lg);
+    --xh-_time-field-gap: var(--xh-control-gap-lg);
+    --xh-_time-field-font-size: var(--xh-control-font-lg);
+    --xh-_time-field-label-font-size: var(--xh-control-font-lg);
   }
 
   /* —— 形态 —— */
@@ -50,11 +63,11 @@
     --xh-_time-field-control-border-hover: var(--xh-_tone-border, var(--xh-border-control-hover));
   }
 
-  /* 无框式：底与边都让开，可见反馈只剩聚焦那一档 */
+  /* 无框：底与常态描边透明，悬停与聚焦浮出描边 */
   [data-scope='time-field'][data-part='root'][data-variant='ghost'] {
     --xh-_time-field-control-bg: transparent;
     --xh-_time-field-control-border: transparent;
-    --xh-_time-field-control-border-hover: transparent;
+    --xh-_time-field-control-border-hover: var(--xh-_tone-border, var(--xh-border-control-hover));
   }
 
   /* 声明了 display 就盖掉了 UA 的 [hidden]{display:none}，收起态得自己还回去 */
@@ -67,9 +80,6 @@
     font-size: var(--xh-time-field-label-font-size, var(--xh-_time-field-label-font-size));
     font-weight: var(--xh-time-field-label-font-weight, var(--xh-text-label-weight));
     line-height: var(--xh-leading-none);
-    /* 点标题会把焦点送到第一段（段不是能被 for 指向的原生控件，这条由连接层接管），
-       指针得如实反映它可点 */
-    cursor: pointer;
   }
 
   [data-scope='time-field'][data-part='label'][data-disabled] {
@@ -81,7 +91,9 @@
      段自己只管一小块可聚焦的高亮区 */
   [data-scope='time-field'][data-part='control'] {
     display: inline-flex;
+    min-inline-size: var(--xh-time-field-control-min-w, var(--xh-control-min-w));
     align-items: center;
+    gap: var(--xh-time-field-control-gap, var(--xh-_time-field-gap));
     block-size: var(--xh-time-field-control-h, var(--xh-_time-field-control-h));
     padding-inline: var(--xh-time-field-control-px, var(--xh-_time-field-control-px));
     padding-block: 0;
@@ -110,11 +122,16 @@
   /* 焦点真正落在段上，但整块看起来才是一个控件：段内有焦点时整框亮起来。
      control 自己不占 Tab 位，所以这里写的是 focus-within 而不是 focus-visible */
   [data-scope='time-field'][data-part='control']:focus-within:not([data-disabled]) {
-    border-color: var(--xh-time-field-control-border-focus, var(--xh-_time-field-ring));
+    border-color: var(--xh-time-field-control-border-focus, var(--xh-_tone, var(--xh-border-control-focus)));
+    outline: var(--xh-ring-width) solid var(--xh-_time-field-ring);
+    outline-offset: var(--xh-ring-offset);
   }
 
   [data-scope='time-field'][data-part='control'][data-invalid] {
-    border-color: var(--xh-time-field-control-border-invalid, var(--xh-color-danger-500));
+    border-color: var(--xh-time-field-control-border-invalid, var(--xh-border-invalid));
+
+    /* 校验失败时环也跟着变红：两圈等宽相邻却一红一蓝，读的人不知道哪个才是当前状态 */
+    --xh-_time-field-ring: var(--xh-ring-invalid);
   }
 
   /* 只读仍可聚焦、可换段，所以不置灰，只把底色压下去表示"改不动" */
@@ -129,13 +146,25 @@
     cursor: not-allowed;
   }
 
-  /* 段是一小块可聚焦区，紧挨着排；分隔符由作者写在段与段之间的普通节点里，
-     不在角色表内，所以间距只能长在段自己身上 */
+  /* 段位与作者写在段间的分隔符都在这一层里：它占满盒里剩下的宽度，
+     清空钮因此靠在框内末端 */
+  [data-scope='time-field'][data-part='segment-group'] {
+    display: inline-flex;
+    flex: 1 1 auto;
+    align-items: center;
+    min-inline-size: 0;
+  }
+
+  [data-scope='time-field'][data-part='segment-group'][hidden] {
+    display: none;
+  }
+
+  /* 段是一小块可聚焦区，紧挨着排；间距长在段自己身上 */
   [data-scope='time-field'][data-part='segment'] {
     display: inline-block;
-    padding-inline: var(--xh-time-field-segment-px, var(--xh-space-0_5));
+    padding-inline: var(--xh-time-field-segment-px, var(--xh-space-1));
     padding-block: 0;
-    border-radius: var(--xh-time-field-segment-radius, var(--xh-radius-sm));
+    border-radius: var(--xh-time-field-segment-radius, var(--xh-shape-inset));
     color: inherit;
     font-variant-numeric: inherit;
     text-align: center;
@@ -154,7 +183,7 @@
 
   /* 还没填的段压成弱色：一行里哪几段是占位符，一眼要看得出来 */
   [data-scope='time-field'][data-part='segment'][data-placeholder] {
-    color: var(--xh-time-field-segment-fg-placeholder, var(--xh-fg-subtle));
+    color: var(--xh-time-field-placeholder-fg, var(--xh-fg-subtle));
   }
 
   /* 一行段长得差不多，光有边框亮起来看不出正在改哪一段：当前段必须自己有底色。
@@ -182,6 +211,63 @@
     cursor: not-allowed;
   }
 
+  /* 清空按钮贴在框内末端：不占宽度也不撑高 control，有值时才显形。
+     靠段位外壳的 flex:1 顶到末端，自己不写 margin */
+  [data-scope='time-field'][data-part='clear-trigger'] {
+    display: inline-flex;
+    flex: none;
+    align-items: center;
+    justify-content: center;
+    inline-size: var(--xh-time-field-action-size, var(--xh-control-action-size));
+    block-size: var(--xh-time-field-action-size, var(--xh-control-action-size));
+    padding: 0;
+    border: 0;
+    border-radius: var(--xh-time-field-action-radius, var(--xh-shape-control));
+    background: var(--xh-time-field-action-bg, transparent);
+    color: var(--xh-time-field-action-fg, var(--xh-fg-muted));
+    font-family: inherit;
+    font-size: var(--xh-time-field-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),
+      scale var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+  }
+
+  /* 没值时连接层给的是 hidden 属性；上面那条 display 会把 UA 规则盖掉 */
+  [data-scope='time-field'][data-part='clear-trigger'][hidden] {
+    display: none;
+  }
+
+  [data-scope='time-field'][data-part='clear-trigger']:hover {
+    background: var(--xh-time-field-action-bg-hover, var(--xh-bg-subtle-hover));
+    color: var(--xh-time-field-action-fg-hover, var(--xh-fg-default));
+  }
+
+  [data-scope='time-field'][data-part='clear-trigger']:active {
+    background: var(--xh-time-field-action-bg-active, var(--xh-bg-subtle-active));
+    scale: var(--xh-motion-scale-press);
+  }
+
+  /* 按钮不占 Tab 位（tabindex=-1），这条是给程序化聚焦兜底：落焦时得看得见 */
+  [data-scope='time-field'][data-part='clear-trigger']:focus-visible {
+    outline: var(--xh-ring-width) solid var(--xh-_time-field-ring);
+    outline-offset: var(--xh-ring-offset);
+  }
+
+  /* 没写内容就由皮肤画兜底字形；作者往部件里塞了自己的图形，这条即不命中 */
+  [data-scope='time-field'][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;
+  }
+
   /* 连接层把它写成 type=hidden，UA 自己就不渲染；这里的视觉隐藏是给元素升级前那一瞬兜底
      （作者手写的是一个普通 input，升级完成前它是可见的文本框）。
      刻意不写 display：写了反而会盖掉 UA 对 type=hidden 的收起，把它显出来 */