@xihan-ui/styles 3.1.0 → 4.0.0

package/dist/css/time-range-picker.css

@@ -0,0 +1,775 @@
+/*
+ * Copyright (c) 2021-Present XiHanFun and contributors.
+ * Licensed under the MIT License. See LICENSE in the project root for license information.
+ */
+
+/* TimeRangePicker 独立皮肤同时传递引入字段视觉盒、字段内动作与浮层集合行；full bundle 递归去重。 */
+@import '../family/field-chrome.css';
+@import '../family/action-control.css';
+@import '../family/collection-item.css';
+
+@import './scrollbar.css';
+
+/* 共享关键帧由 family/motion.css 提供，本皮肤 @import 它，单独引入仍成立。 */
+@import '../family/motion.css';
+
+@layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  .xh-scope-time-range-picker {
+    --xh-time-range-picker-skin: 1;
+  }
+
+  /* 坐标由定位引擎写进 style（inset-inline-start / inset-block-start），这里只定位模式与层级 */
+  .xh-scope-time-range-picker[data-part='positioner'] {
+    /* 落定那一侧的可用宽度，由定位引擎经内联自定义属性写进来，内容层据此夹住行内轴；
+       引擎没算（尚未落位 / 无引擎 / 贴边归零）时退到视口宽 */
+    --xh-_time-range-picker-available-w: 100vw;
+
+    /* 每个浮层独立声明方向，避免嵌套浮层继承祖先的进场位移。 */
+    --xh-_overlay-enter-up: 0;
+    --xh-_overlay-enter-down: 0;
+    --xh-_overlay-enter-left: 0;
+    --xh-_overlay-enter-right: 0;
+
+    /* 面板的自绘横条浮在内容之上：轨道不上底色，实色轨道会在面板底缘糊出一条灰带 */
+    --xh-scrollbar-track-bg: transparent;
+
+    position: fixed;
+    z-index: var(--xh-time-range-picker-layer, var(--xh-_layer, var(--xh-layer-popover)));
+    /* 空壳不吃指针，交互只发生在 content 里 */
+    pointer-events: none;
+  }
+
+  /* 锚点被滚出可视区：整个浮层随之收起 */
+  .xh-scope-time-range-picker[data-part='positioner'][data-hidden] {
+    visibility: hidden;
+  }
+
+  /* 短位移沿实际落位的物理方向，不随书写方向翻转。 */
+  .xh-scope-time-range-picker[data-part='positioner'][data-placement^='top'] {
+    --xh-_overlay-enter-down: 1;
+  }
+
+  .xh-scope-time-range-picker[data-part='positioner'][data-placement^='bottom'] {
+    --xh-_overlay-enter-up: 1;
+  }
+
+  .xh-scope-time-range-picker[data-part='positioner'][data-placement^='left'] {
+    --xh-_overlay-enter-right: 1;
+  }
+
+  .xh-scope-time-range-picker[data-part='positioner'][data-placement^='right'] {
+    --xh-_overlay-enter-left: 1;
+  }
+
+  /* 私有槽同时声明在根与 positioner 上：浮层被搬到 portal 落点，不是根的后代，继承不过去 */
+  .xh-scope-time-range-picker:is([data-part='root'], [data-part='positioner']) {
+    /* 尺寸档只换这几个私有槽，标题、输入行与浮层里的格子都从这两处继承它们，
+       换档不必给每个部件各写一条选择器；形态三档由家族按 control 上的 data-variant 生成，皮肤不再声明 */
+    --xh-_time-range-picker-control-h: var(--xh-control-h-md);
+    --xh-_time-range-picker-control-px: var(--xh-control-px-md);
+    --xh-_time-range-picker-gap: var(--xh-control-gap-md);
+    --xh-_time-range-picker-font-size: var(--xh-control-font-md);
+
+    /* 段位强调随语气走：当前段是「当前项」，淡底 + 淡底前景；对号使用普通表面上的前景色。
+       没写 data-tone 时这几个 --xh-_tone* 没被声明，退回品牌色 */
+    --xh-_time-range-picker-segment-bg: var(--xh-_tone-subtle, var(--xh-bg-brand-subtle));
+    --xh-_time-range-picker-segment-fg: var(--xh-_tone-fg, var(--xh-fg-on-brand-subtle));
+    --xh-_time-range-picker-check-fg: var(--xh-_tone, var(--xh-fg-brand));
+  }
+
+  /* 与文本框、时间输入同一套堆叠：标签一行、控件一行 */
+  .xh-scope-time-range-picker[data-part='root'] {
+    /* 作者塞进指示符槽的图标跟着字号走，与皮肤画的兜底字形同一把尺 */
+    --xh-icon-size: var(--xh-time-range-picker-icon-size, var(--xh-glyph-size-md));
+
+    display: inline-flex;
+    flex-direction: column;
+    gap: var(--xh-time-range-picker-gap, var(--xh-space-1));
+
+    /* 不传尺寸时一律这么宽，宽度不随内容走；父容器给不出这么宽时整件跟着收，地板同步让步，不越出父容器。
+       地板不高过缺省宽：使用者把缺省宽钉到底线以下时不必再放开底线 */
+    inline-size: var(--xh-time-range-picker-control-w, var(--xh-control-w));
+    min-inline-size: min(var(--xh-time-range-picker-control-w, var(--xh-control-w)), var(--xh-time-range-picker-control-min-w, var(--xh-control-min-w)), 100%);
+    max-inline-size: 100%;
+  }
+
+  /* —— 尺寸 —— */
+  /* 缺省档写在上面的基础规则里 */
+  .xh-scope-time-range-picker:is([data-part='root'], [data-part='positioner'])[data-size='sm'] {
+    --xh-icon-size: var(--xh-time-range-picker-icon-size, var(--xh-glyph-size-sm));
+    --xh-_time-range-picker-control-h: var(--xh-control-h-sm);
+    --xh-_time-range-picker-control-px: var(--xh-control-px-sm);
+    --xh-_time-range-picker-gap: var(--xh-control-gap-sm);
+    --xh-_time-range-picker-font-size: var(--xh-control-font-sm);
+  }
+
+  .xh-scope-time-range-picker:is([data-part='root'], [data-part='positioner'])[data-size='lg'] {
+    --xh-icon-size: var(--xh-time-range-picker-icon-size, var(--xh-glyph-size-lg));
+    --xh-_time-range-picker-control-h: var(--xh-control-h-lg);
+    --xh-_time-range-picker-control-px: var(--xh-control-px-lg);
+    --xh-_time-range-picker-gap: var(--xh-control-gap-lg);
+    --xh-_time-range-picker-font-size: var(--xh-control-font-lg);
+  }
+
+  /* 声明了 display 就盖掉了 UA 的 [hidden]{display:none}，收起态得自己还回去 */
+  .xh-scope-time-range-picker[data-part='root'][hidden] {
+    display: none;
+  }
+
+  .xh-scope-time-range-picker[data-part='label'] {
+    /* 竖排时标签与控件之间的距离：根的 gap 之上补一段差值，--xh-time-range-picker-label-gap 给多少最终就是多少 */
+    margin-block-end: calc(var(--xh-time-range-picker-label-gap, var(--xh-space-2)) - var(--xh-time-range-picker-gap, var(--xh-space-1)));
+    color: var(--xh-time-range-picker-label-fg, var(--xh-fg-muted));
+    font-size: var(--xh-time-range-picker-label-font-size, var(--xh-text-label-size));
+    font-weight: var(--xh-time-range-picker-label-font-weight, var(--xh-text-label-weight));
+    line-height: var(--xh-leading-none);
+  }
+
+  .xh-scope-time-range-picker[data-part='label'][data-disabled] {
+    color: var(--xh-time-range-picker-label-fg-disabled, var(--xh-fg-muted));
+  }
+
+  /* 画成一个框的是 control：几段文字、展开按钮、清空按钮要看起来是一体的，
+     边框长在其中任何一个身上都会把另外几个割在框外。描边、底色、圆角、聚焦环、五态与悬停由
+     Field Chrome 家族画在 control 上（焦点落在段或按钮上，家族 :focus-within 让整框亮起来）；
+     组件只映射既有公开槽（shadow 缺省 none：字段静息描边式、无影）。打开中不另画环，由浮层本身承担 */
+  .xh-scope-time-range-picker[data-part='control'] {
+    --xh-field-control-height: var(--xh-time-range-picker-control-h, var(--xh-_time-range-picker-control-h));
+    --xh-field-control-padding-inline: var(--xh-time-range-picker-control-px, var(--xh-_time-range-picker-control-px));
+    --xh-field-control-gap: var(--xh-time-range-picker-control-gap, var(--xh-_time-range-picker-gap));
+    --xh-field-control-min-inline-size: var(--xh-time-range-picker-control-min-w, var(--xh-control-min-w));
+    --xh-field-control-radius: var(--xh-time-range-picker-control-radius, var(--xh-shape-control));
+    --xh-field-bg-rest: var(--xh-time-range-picker-control-bg, var(--xh-_field-variant-bg-rest));
+    --xh-field-bg-hover: var(--xh-time-range-picker-control-bg-hover, var(--xh-_field-variant-bg-hover));
+    --xh-field-bg-read-only: var(--xh-time-range-picker-control-bg-readonly, var(--xh-_field-variant-bg-read-only));
+    --xh-field-bg-disabled: var(--xh-time-range-picker-control-bg-disabled, var(--xh-_field-variant-bg-disabled));
+    --xh-field-fg-rest: var(--xh-time-range-picker-control-fg, var(--xh-fg-default));
+    --xh-field-border-rest: var(--xh-time-range-picker-control-border, var(--xh-_field-variant-border-rest));
+    --xh-field-border-hover: var(--xh-time-range-picker-control-border-hover, var(--xh-_field-variant-border-hover));
+    --xh-field-border-focus: var(--xh-time-range-picker-control-border-focus, var(--xh-_field-variant-border-focus));
+    --xh-field-border-invalid: var(--xh-time-range-picker-control-border-invalid, var(--xh-_field-variant-border-invalid));
+    --xh-field-shadow-rest: var(--xh-time-range-picker-control-shadow, none);
+    /* 段位靠键盘编辑，盒上不是文本光标 */
+    --xh-field-cursor-rest: default;
+    /* 家族 chrome 会重写 --xh-icon-size，使用者图标槽必须经桥接槽下发才能在盒内生效 */
+    --xh-field-glyph-size: var(--xh-time-range-picker-icon-size, var(--xh-_field-size-glyph-size));
+
+    /* 表单控件不继承页面字体，只给字号会让它用 UA 默认字族，与周围文本对不上 */
+    font-family: inherit;
+    font-size: var(--xh-time-range-picker-font-size, var(--xh-_time-range-picker-font-size));
+    /* 等宽数字：各位字宽不一时逐段填入会让整行左右跳 */
+    font-variant-numeric: tabular-nums;
+    line-height: var(--xh-leading-normal);
+  }
+
+  .xh-scope-time-range-picker[data-part='control'][hidden] {
+    display: none;
+  }
+
+  /* 起止各一组段位与作者写在段间的分隔符都在各自这一层里：起点那组只占自己的宽度，
+     分隔符紧跟在它后面，剩下的宽度全给终点那组，尾部按钮因此靠在框内末端 */
+  .xh-scope-time-range-picker[data-part='segment-group'] {
+    display: inline-flex;
+    flex: 1 1 auto;
+    align-items: center;
+    min-inline-size: 0;
+  }
+
+  .xh-scope-time-range-picker[data-part='segment-group'][data-index='0']:has(+ [data-part='range-separator']) {
+    flex: 0 0 auto;
+  }
+
+  .xh-scope-time-range-picker[data-part='segment-group'][hidden] {
+    display: none;
+  }
+
+  .xh-scope-time-range-picker[data-part='range-separator'] {
+    display: inline-flex;
+    flex: none;
+    align-items: center;
+    justify-content: center;
+    /* 两侧各留一个小间距：把输入行的常规间距收回来，再补上自己那一份 */
+    --xh-_time-range-picker-range-separator-mx: calc(var(--xh-time-range-picker-range-separator-px, var(--xh-space-1)) - var(--xh-time-range-picker-control-gap, var(--xh-_time-range-picker-gap)));
+
+    margin-inline: var(--xh-time-range-picker-range-separator-mx, var(--xh-_time-range-picker-range-separator-mx));
+    padding-inline: var(--xh-time-range-picker-range-separator-px, var(--xh-space-1));
+    color: var(--xh-time-range-picker-range-separator-fg, var(--xh-fg-subtle));
+    font: inherit;
+    line-height: var(--xh-leading-none);
+    pointer-events: none;
+    user-select: none;
+  }
+
+  /* 作者自己给分隔符加 hidden 时也真的收起：上面那条 display 会盖掉 UA 的兜底 */
+  .xh-scope-time-range-picker[data-part='range-separator'][hidden] {
+    display: none;
+  }
+
+  .xh-scope-time-range-picker[data-part='segment-group'] > :not([data-scope]) {
+    color: var(--xh-time-range-picker-literal-fg, var(--xh-fg-subtle));
+  }
+
+  /* 每一段是一小块可聚焦区，紧挨着排；间距长在段自己身上 */
+  .xh-scope-time-range-picker[data-part='segment'] {
+    display: inline-block;
+    padding-inline: var(--xh-time-range-picker-segment-px, var(--xh-space-0_5));
+    padding-block: 0;
+    border-radius: var(--xh-time-range-picker-segment-radius, var(--xh-shape-inset));
+    color: inherit;
+    font-variant-numeric: inherit;
+    text-align: center;
+    /* 段是 role=spinbutton 的展示节点，双击选中一段文字只会碍事 */
+    user-select: none;
+    transition:
+      background-color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter),
+      color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+  }
+
+  /* granularity / hourCycle 关掉的段由连接层打 hidden；上面那条 display 会把 UA 规则盖掉，
+     少了这条，收起的段会一直杵在那儿 */
+  .xh-scope-time-range-picker[data-part='segment'][hidden] {
+    display: none;
+  }
+
+  /* 还没填的段压成弱色：一行里哪几段是占位符，一眼要看得出来 */
+  .xh-scope-time-range-picker[data-part='segment'][data-placeholder] {
+    color: var(--xh-time-range-picker-placeholder-fg, var(--xh-fg-subtle));
+  }
+
+  /* 一行段长得差不多，光有边框亮起来看不出正在改哪一段：当前段必须自己有底色。
+     data-focus 由机器给（它知道谁是当前段），:focus-visible 兜住机器状态还没回流的那一帧 */
+  .xh-scope-time-range-picker[data-part='segment'][data-focus]:not([data-disabled]),
+  .xh-scope-time-range-picker[data-part='segment']:focus-visible {
+    background: var(--xh-time-range-picker-segment-bg-focus, var(--xh-_time-range-picker-segment-bg));
+    color: var(--xh-time-range-picker-segment-fg-focus, var(--xh-_time-range-picker-segment-fg));
+    outline: none;
+  }
+
+  /* 焦点态用了品牌底色之后，占位符那条弱色会被它盖住，这里明确让位给焦点态 */
+  .xh-scope-time-range-picker[data-part='segment'][data-focus][data-placeholder]:not([data-disabled]) {
+    color: var(--xh-time-range-picker-segment-fg-focus, var(--xh-_time-range-picker-segment-fg));
+  }
+
+  .xh-scope-time-range-picker[data-part='segment'][data-invalid] {
+    color: var(--xh-time-range-picker-segment-fg-invalid, var(--xh-fg-danger));
+  }
+
+  .xh-scope-time-range-picker[data-part='segment'][data-invalid]:is([data-focus], :focus-visible) {
+    background: var(
+      --xh-time-range-picker-segment-bg-invalid-focus,
+      var(--xh-bg-subtle)
+    );
+    color: var(--xh-time-range-picker-segment-fg-invalid-focus, var(--xh-fg-danger));
+  }
+
+  .xh-scope-time-range-picker[data-part='segment']:hover:not([data-focus], [data-disabled]) {
+    background: var(--xh-time-range-picker-segment-bg-hover, var(--xh-bg-subtle));
+  }
+
+  /* 段是集合条目形态（role=spinbutton 的 span），禁用走 data-disabled 而不是 :disabled */
+  .xh-scope-time-range-picker[data-part='segment'][data-disabled] {
+    color: var(--xh-fg-disabled);
+  }
+
+  /* 两个按钮同一副长相：贴在框内末端的小方钮，不占宽度也不撑高 control。正方视觉盒、inset 圆角、
+     悬停 100 / 按下 200 与 0.97 按压、粗指针热区、禁用面与 :focus-visible 关环（盒的 :focus-within
+     已画了一圈）全由 Action Control 的 field-inset ghost 档给，组件只映射既有覆盖槽。
+     打开中与悬停同档：展开钮不另上底，方向由浮层本身承担 */
+  .xh-scope-time-range-picker[data-part='trigger'],
+  .xh-scope-time-range-picker[data-part='clear-trigger'] {
+    --xh-action-visual-size: var(--xh-time-range-picker-action-size, var(--xh-_action-profile-visual-size));
+    --xh-action-min-inline-size: var(--xh-time-range-picker-action-size, var(--xh-_action-profile-visual-size));
+    --xh-action-radius: var(--xh-time-range-picker-action-radius, var(--xh-shape-inset));
+    /* 底色阶梯由 ghost 档给（透明 → 100 → 200），使用者槽只作覆盖入口 */
+    --xh-action-bg-rest: var(--xh-time-range-picker-action-bg, var(--xh-_action-variant-bg-rest));
+    --xh-action-bg-hover: var(--xh-time-range-picker-action-bg-hover, var(--xh-_action-variant-bg-hover));
+    --xh-action-bg-pressed: var(--xh-time-range-picker-action-bg-active, var(--xh-_action-variant-bg-pressed));
+    --xh-action-fg-rest: var(--xh-time-range-picker-action-fg, var(--xh-fg-muted));
+    --xh-action-fg-hover: var(--xh-time-range-picker-action-fg-hover, var(--xh-fg-default));
+    --xh-action-border-rest: transparent;
+    --xh-action-highlight-rest: transparent;
+    --xh-action-shadow-rest: none;
+    --xh-action-shadow-hover: none;
+    --xh-action-shadow-pressed: none;
+    --xh-action-font-size: var(--xh-time-range-picker-action-font-size, var(--xh-text-secondary-size));
+    /* 配方尚未把 profile 字形档灌进 --xh-icon-size，钮内字形先按 field-inset 档逐钮取值 */
+    --xh-icon-size: var(--xh-_action-profile-glyph-size);
+
+    border-width: 0;
+  }
+
+  /* 没值时连接层给的是 hidden 属性；家族那条 display 会把 UA 规则盖掉 */
+  .xh-scope-time-range-picker[data-part='trigger'][hidden],
+  .xh-scope-time-range-picker[data-part='clear-trigger'][hidden] {
+    display: none;
+  }
+
+  /* 打开中与悬停同档：展开钮的静息底换到悬停那一支中性面，不用品牌色、不另画环；方向由浮层本身承担 */
+  .xh-scope-time-range-picker[data-part='trigger'][data-state='open'] {
+    --xh-action-bg-rest: var(--xh-time-range-picker-action-bg-hover, var(--xh-_action-variant-bg-hover));
+    --xh-action-fg-rest: var(--xh-time-range-picker-action-fg-hover, var(--xh-fg-default));
+  }
+
+  /* 有值时清空钮顶上来，展开钮让位：两颗并排堆着用户分不清点哪个 */
+  .xh-scope-time-range-picker[data-part='control']:has(
+      > .xh-scope-time-range-picker[data-part='clear-trigger']:not([hidden])
+    )
+    > .xh-scope-time-range-picker[data-part='trigger'] {
+    display: none;
+  }
+
+  /* 几列并排：整体高度由列自己撑，滚动发生在列里而不是整个面板上——
+     整面板滚会让时列与分列一起走，挑分的时候时就看不见了。
+     含多列的锚定面板走 floating 材质：实体底 + --xh-border-default 描边 + --xh-elevation-floating 落影，
+     不透景、不画顶光。面板自己不留内衬：各列与快捷选项列自带内衬，列间分隔线从面板顶边通到底边 */
+  .xh-scope-time-range-picker[data-part='content'] {
+    position: relative;
+    display: flex;
+    align-items: stretch;
+    padding-block: var(--xh-time-range-picker-content-py, var(--xh-space-0));
+    padding-inline: var(--xh-time-range-picker-content-px, var(--xh-space-0));
+    /* 行内轴的上限是落位后的可用宽度：两组时列并排，秒与上下午都开时八列合计会越过最窄视口，
+       放不下时面板内自己横滚，每一列保持自己的宽度不被压 */
+    max-inline-size: var(--xh-_time-range-picker-available-w);
+    overflow-x: auto;
+    /* 浮层滚动面：滚到头不把页面一起带走 */
+    overscroll-behavior: contain;
+    /* 两组时列都按 px 定高（列取 --xh-overlay-time-column-h），面板的天然高度就是它们的和，缺省不另设上限：
+       按 rem 的滚动面档会随根字号缩小，根字号很小时面板出竖滚 */
+    max-block-size: var(--xh-time-range-picker-content-max-h, none);
+    border: var(--xh-stroke-thin) solid var(--xh-time-range-picker-content-border, var(--xh-border-default));
+    border-radius: var(--xh-time-range-picker-content-radius, var(--xh-shape-overlay));
+    background: var(--xh-time-range-picker-content-bg, var(--xh-bg-surface));
+    color: var(--xh-time-range-picker-content-fg, var(--xh-fg-default));
+    font-variant-numeric: tabular-nums;
+    box-shadow: var(--xh-time-range-picker-content-shadow, var(--xh-elevation-floating));
+    pointer-events: auto;
+    /* 快捷选项列与各时间列的条子贴在各自的盒子上、挂在这一层里（它已是定位盒）：轨道不画底 */
+    --xh-scrollbar-track-bg: transparent;
+  }
+
+  /* 这里刻意没有 [data-part='content'][hidden] { display: none }，与 dialog 一致：
+     收起态连接层会给 content 打 hidden，而上面那条 display 正是要盖掉 UA 的
+     [hidden]{display:none}——退场动画得先能播。presence 读的是 content 的 animationName，
+     真正的收起由宿主在退场结束后落成内联 display:none（Vue 那边直接不渲染）。
+     其余声明了 display 的角色节点仍补 [hidden]，那几处没有退场动画。 */
+
+  /* 面板本身不承载焦点（焦点在某一列的某一格上），落焦时不画环 */
+  .xh-scope-time-range-picker[data-part='content']:focus-visible {
+    outline: none;
+  }
+
+  /* 挂载时就开着的那一段（data-instant）属于首帧，直接呈现 */
+  .xh-scope-time-range-picker[data-part='content'][data-state='open']:not([data-instant]) {
+    animation: xh-overlay-slide-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter-strong);
+  }
+
+  /* 退场：收起那一帧 hidden 由退场闸门押后，这里才播得出来。forwards 把末态钉住，
+     免得动画结束到真收起之间闪一下原样 */
+  .xh-scope-time-range-picker[data-part='content'][data-state='closed'] {
+    animation: xh-overlay-slide-out var(--xh-motion-duration-exit) var(--xh-motion-ease-exit) forwards;
+  }
+
+  /* 快捷选项也是一列，与时分秒那几列并排，排在行内起始一侧；限高与时间列同一档 */
+  .xh-scope-time-range-picker[data-part='preset-group'] {
+    display: flex;
+    flex: none;
+    flex-direction: column;
+    gap: var(--xh-time-range-picker-preset-group-gap, var(--xh-space-1));
+    max-block-size: var(--xh-time-range-picker-preset-group-h, var(--xh-overlay-time-column-h));
+    padding-block: var(--xh-time-range-picker-preset-group-py, var(--xh-space-2_5));
+    padding-inline: var(--xh-time-range-picker-preset-group-px, var(--xh-space-2));
+    overflow-y: auto;
+    /* 浮层滚动面：滚到头不把页面一起带走 */
+    overscroll-behavior: contain;
+    border-inline-end: var(--xh-stroke-thin) solid var(--xh-time-range-picker-column-divider, var(--xh-material-solid-border));
+  }
+
+  .xh-scope-time-range-picker[data-part='preset-group'][hidden] {
+    display: none;
+  }
+
+  /* 快捷选项：每一项是一颗 24 高的淡底小钮——静息 100、悬停 / 高亮 200、按下 300（淡底承载阶梯），
+     字取说明档 12px、次级前景；禁用面由 Collection Item 家族按 overlay 语境给。headless 把它投成 listbox 的
+     option、当前值落在哪一项就报 aria-selected，选中仍画行尾对号（面与字不变），对号是这条状态唯一的视觉通道。
+     选项没有正文部件，匿名文本进不了家族网格的 text 列，行保持块级排版，末端为对号预留固定轨 */
+  .xh-scope-time-range-picker[data-part='preset'] {
+    --xh-collection-block-padding: 0;
+    --xh-collection-inline-padding: var(--xh-time-range-picker-preset-px, var(--xh-space-2));
+    --xh-collection-font-size: var(--xh-time-range-picker-preset-font-size, var(--xh-text-caption-size));
+    --xh-collection-radius: var(--xh-time-range-picker-preset-radius, var(--xh-shape-control));
+    --xh-collection-fg-rest: var(--xh-time-range-picker-preset-fg, var(--xh-fg-muted));
+    --xh-collection-fg-selected: var(--xh-time-range-picker-preset-fg, var(--xh-fg-muted));
+    /* 悬停 / 高亮 / 按下时字换正文色：底升到 200 / 300 之后，次级前景在暗色下不足 4.5:1 */
+    --xh-collection-fg-hover: var(--xh-time-range-picker-preset-fg-hover, var(--xh-fg-default));
+    --xh-collection-fg-keyboard-highlight: var(--xh-time-range-picker-preset-fg-hover, var(--xh-fg-default));
+    --xh-collection-fg-pressed: var(--xh-time-range-picker-preset-fg-hover, var(--xh-fg-default));
+    --xh-collection-fg-selected-highlight: var(--xh-time-range-picker-preset-fg-hover, var(--xh-fg-default));
+    --xh-collection-fg-selected-hover: var(--xh-time-range-picker-preset-fg-hover, var(--xh-fg-default));
+    --xh-collection-fg-selected-pressed: var(--xh-time-range-picker-preset-fg-hover, var(--xh-fg-default));
+    --xh-collection-fg-disabled: var(--xh-time-range-picker-preset-fg-disabled, var(--xh-fg-disabled));
+    --xh-collection-font-weight-selected: var(--xh-font-weight-regular);
+    --xh-collection-font-weight-selected-highlight: var(--xh-font-weight-regular);
+    --xh-collection-font-weight-selected-hover: var(--xh-font-weight-regular);
+    --xh-collection-font-weight-selected-pressed: var(--xh-font-weight-regular);
+    --xh-collection-bg-rest: var(--xh-time-range-picker-preset-bg, var(--xh-bg-subtle));
+    --xh-collection-bg-selected: var(--xh-time-range-picker-preset-bg, var(--xh-bg-subtle));
+    --xh-collection-bg-hover: var(--xh-time-range-picker-preset-bg-hover, var(--xh-bg-subtle-hover));
+    --xh-collection-bg-keyboard-highlight: var(--xh-time-range-picker-preset-bg-hover, var(--xh-bg-subtle-hover));
+    --xh-collection-bg-selected-highlight: var(--xh-time-range-picker-preset-bg-hover, var(--xh-bg-subtle-hover));
+    --xh-collection-bg-selected-hover: var(--xh-time-range-picker-preset-bg-hover, var(--xh-bg-subtle-hover));
+    --xh-collection-bg-pressed: var(--xh-time-range-picker-preset-bg-pressed, var(--xh-bg-subtle-active));
+    --xh-collection-bg-selected-pressed: var(--xh-time-range-picker-preset-bg-pressed, var(--xh-bg-subtle-active));
+    --xh-collection-outline-keyboard-highlight: transparent;
+    --xh-collection-outline-selected-highlight: transparent;
+
+    position: relative;
+    display: block;
+    flex: none;
+    block-size: var(--xh-time-range-picker-preset-h, var(--xh-control-action-size));
+    /* 对号的末端轨始终留着，切换选中时文字与整列宽度都不移动。 */
+    padding-inline-end: calc(
+      var(--xh-time-range-picker-preset-px, var(--xh-space-2))
+      + var(--xh-time-range-picker-preset-check-size, var(--xh-control-indicator-sm))
+      + var(--xh-space-1)
+    );
+    /* 一行字在 24 高的钮里垂直居中 */
+    line-height: var(--xh-time-range-picker-preset-h, var(--xh-control-action-size));
+    white-space: nowrap;
+    user-select: none;
+  }
+
+  /* 键盘焦点出现时环才接回并立即到位，不压在背景过渡的中间帧上 */
+  .xh-scope-time-range-picker[data-part='preset']:focus-visible:not(:hover) {
+    --xh-collection-outline-keyboard-highlight: var(--xh-ring-focus);
+    --xh-collection-outline-selected-highlight: var(--xh-ring-focus);
+
+    transition: none;
+  }
+
+  /* 对号是 preset 自身的正式选中出口：全部条目恒留末端轨，不依赖作者补节点。 */
+  .xh-scope-time-range-picker[data-part='preset']::after {
+    content: '';
+    position: absolute;
+    inset-block-start: 50%;
+    inset-inline-end: var(--xh-time-range-picker-preset-px, var(--xh-space-2));
+    inline-size: var(--xh-time-range-picker-preset-check-size, var(--xh-control-indicator-sm));
+    block-size: var(--xh-time-range-picker-preset-check-size, var(--xh-control-indicator-sm));
+    background-color: var(--xh-time-range-picker-preset-check-fg, var(--xh-_time-range-picker-check-fg));
+    opacity: 0;
+    translate: 0 -50%;
+    -webkit-mask: var(--xh-glyph-mark-check) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-check) center / contain no-repeat;
+    pointer-events: none;
+    transition: opacity var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+  }
+
+  /* 命中只显示对号；正文不反白、不增重，底色通道留给临时交互状态。 */
+  .xh-scope-time-range-picker[data-part='preset'][data-state='checked']::after {
+    opacity: 1;
+  }
+
+  /* 上面给了 display，UA 的 [hidden]{display:none} 已被盖掉，这里补回来 */
+  .xh-scope-time-range-picker[data-part='preset'][hidden] {
+    display: none;
+  }
+
+  .xh-scope-time-range-picker[data-part='preset'][data-disabled]::after {
+    background-color: var(--xh-time-range-picker-preset-fg-disabled, var(--xh-fg-disabled));
+  }
+
+  /* 一端的几列成组并排，小标题独占顶上一行；两组之间不另留空当，只隔一道竖线，眼睛先分起止、再分时分 */
+  .xh-scope-time-range-picker[data-part='column-group'] {
+    --xh-_time-range-picker-column-group-label-py: var(
+      --xh-time-range-picker-column-group-py,
+      var(--xh-time-range-picker-column-group-label-py, var(--xh-space-1))
+    );
+    --xh-_time-range-picker-column-group-label-h: calc(
+      1lh
+      + var(--xh-_time-range-picker-column-group-label-py)
+      + var(--xh-_time-range-picker-column-group-label-py)
+    );
+
+    position: relative;
+    display: flex;
+    flex: none;
+    flex-wrap: nowrap;
+    align-content: flex-start;
+    align-items: stretch;
+    min-inline-size: 0;
+    padding-block-start: var(--xh-_time-range-picker-column-group-label-h);
+    font-size: var(--xh-text-caption-size);
+    line-height: var(--xh-leading-normal);
+  }
+
+  .xh-scope-time-range-picker[data-part='column-group'][hidden] {
+    display: none;
+  }
+
+  .xh-scope-time-range-picker[data-part='column-group'] + .xh-scope-time-range-picker[data-part='column-group'] {
+    margin-inline-start: var(--xh-time-range-picker-column-group-gap, var(--xh-space-0));
+    padding-inline-start: var(--xh-time-range-picker-column-group-gap, var(--xh-space-0));
+    border-inline-start: var(--xh-stroke-thin) solid var(--xh-time-range-picker-column-group-divider, var(--xh-material-solid-border));
+  }
+
+  /* 组顶上的小标题：独占一行，字号走辅助文本档 */
+  .xh-scope-time-range-picker[data-part='column-group-label'] {
+    position: absolute;
+    inset-block-start: 0;
+    inset-inline: 0;
+    display: flex;
+    box-sizing: border-box;
+    align-items: center;
+    justify-content: center;
+    block-size: var(--xh-_time-range-picker-column-group-label-h);
+    padding-block: var(--xh-time-range-picker-column-group-label-py, var(--xh-space-1));
+    padding-inline: var(--xh-time-range-picker-column-group-label-px, var(--xh-space-1));
+    color: var(--xh-time-range-picker-column-group-label-fg, var(--xh-fg-subtle));
+    font-size: var(--xh-text-caption-size);
+    line-height: var(--xh-leading-normal);
+    text-align: center;
+    user-select: none;
+  }
+
+  .xh-scope-time-range-picker[data-part='column-group-label'][hidden] {
+    display: none;
+  }
+
+  /* 一列一个滚动区：列与列之间用细分隔线，视觉上"时 | 分 | 秒"三栏分明。列宽取时间列档（两位数字加两侧对号轨），
+     列高是七格整行；列顶留 4，列底留出一截空白，末尾几格（23 时、55–59 分）也能滚到列顶，各列的选中落在同一行 */
+  .xh-scope-time-range-picker[data-part='column'] {
+    --xh-_time-range-picker-column-h: var(--xh-time-range-picker-column-h, var(--xh-overlay-time-column-h));
+    --xh-_time-range-picker-column-py: var(--xh-time-range-picker-column-py, var(--xh-space-1));
+
+    display: flex;
+    flex: none;
+    flex-direction: column;
+    gap: var(--xh-time-range-picker-column-gap, var(--xh-space-2));
+    min-inline-size: var(--xh-time-range-picker-column-min-w, var(--xh-overlay-time-column-w));
+    /* 几列并排：定高而不是随内容收，否则时列与分列的可选值一多一少就错位 */
+    block-size: var(--xh-_time-range-picker-column-h);
+    padding-block: var(--xh-_time-range-picker-column-py)
+      calc(var(--xh-_time-range-picker-column-h) - var(--xh-time-range-picker-item-h, var(--xh-control-action-size)) - var(--xh-_time-range-picker-column-py));
+    padding-inline: var(--xh-time-range-picker-column-px, 0);
+    overflow-y: auto;
+    /* 浮层滚动面：滚到头不把页面一起带走 */
+    overscroll-behavior: contain;
+    /* 滚动容器在某些浏览器里会被自动塞进 Tab 序列，是否画环见下方按 tabindex 分档的两条 */
+  }
+
+  /* 组里的列顶画一道线：组顶小标题那一带与列分开，起止两组的线在组边接上 */
+  .xh-scope-time-range-picker[data-part='column-group'] > .xh-scope-time-range-picker[data-part='column'] {
+    border-block-start: var(--xh-stroke-thin) solid var(--xh-time-range-picker-column-divider, var(--xh-material-solid-border));
+  }
+
+  /* granularity 关掉的列（精度不到秒时的秒列）由连接层打 hidden */
+  .xh-scope-time-range-picker[data-part='column'][hidden] {
+    display: none;
+  }
+
+  /* 每列后面紧跟着它自己的贴层条子节点，相邻选择器接不到下一列，按「前面有过列」取第二列起 */
+  .xh-scope-time-range-picker[data-part='column'] ~ .xh-scope-time-range-picker[data-part='column'] {
+    border-inline-start: var(--xh-stroke-thin) solid var(--xh-time-range-picker-column-divider, var(--xh-material-solid-border));
+  }
+
+  /* 焦点落在列上有两种情形：指针打开、这一段还空着、还没有任何格当锚点，或整列被界裁空。
+     那一刻它认领着 Tab 位，环画在列内沿；有锚点时环长在格上，列不再画 */
+  .xh-scope-time-range-picker[data-part='column'][tabindex='0']:focus-visible {
+    outline: var(--xh-ring-width) solid var(--xh-ring-focus);
+    outline-offset: var(--xh-ring-offset);
+  }
+
+  .xh-scope-time-range-picker[data-part='column']:not([tabindex='0']):focus-visible {
+    outline: none;
+  }
+
+  /* 时间格：24 高的通栏条，列内间距 8 撑出 32 的行距；悬停 / 高亮 100、按下 200 由 Collection Item 家族按
+     overlay 语境给，选中透明底 + 中等字重 + 末端对号（对号集合的选中），不上品牌淡底、不变字色。格里只有数字、没有正文部件，保持自己的
+     居中排版与等宽标记轨，家族只给状态面。行的字色与字重按值选择族的同一套映射写（--xh-time-range-picker-item-fg
+     / -fg-selected / -font-weight-selected 使用者槽，缺省落家族配方的行字色 --xh-material-frosted-fg：
+     它在各主题与 forced-colors 下都等于 --xh-fg-default，floating 面板上的面色仍由 content 自己给） */
+  .xh-scope-time-range-picker[data-part='item'] {
+    --xh-_time-range-picker-item-rail: max(
+      var(--xh-time-range-picker-item-px, var(--xh-space-0_5)),
+      calc(var(--xh-time-range-picker-item-check-size, var(--xh-control-indicator-size)) + var(--xh-space-0_5))
+    );
+    --xh-collection-block-padding: 0;
+    /* 两侧留同宽轨：对号绝对落在末端，数字仍在整格的数学中心。 */
+    --xh-collection-inline-padding: var(--xh-_time-range-picker-item-rail);
+    --xh-collection-font-size: var(--xh-time-range-picker-item-font-size, var(--xh-_time-range-picker-font-size));
+    /* 浮层里的列表是通栏行：格铺满列宽、不取圆角 */
+    --xh-collection-radius: var(--xh-time-range-picker-item-radius, 0);
+    --xh-collection-fg-rest: var(--xh-time-range-picker-item-fg, var(--xh-material-frosted-fg));
+    --xh-collection-fg-hover: var(--xh-time-range-picker-item-fg, var(--xh-material-frosted-fg));
+    --xh-collection-fg-keyboard-highlight: var(--xh-time-range-picker-item-fg, var(--xh-material-frosted-fg));
+    --xh-collection-fg-pressed: var(--xh-time-range-picker-item-fg, var(--xh-material-frosted-fg));
+    --xh-collection-fg-selected: var(--xh-time-range-picker-item-fg-selected, var(--xh-time-range-picker-item-fg, var(--xh-material-frosted-fg)));
+    --xh-collection-fg-selected-highlight: var(--xh-time-range-picker-item-fg-selected, var(--xh-time-range-picker-item-fg, var(--xh-material-frosted-fg)));
+    --xh-collection-fg-selected-hover: var(--xh-time-range-picker-item-fg-selected, var(--xh-time-range-picker-item-fg, var(--xh-material-frosted-fg)));
+    --xh-collection-fg-selected-pressed: var(--xh-time-range-picker-item-fg-selected, var(--xh-time-range-picker-item-fg, var(--xh-material-frosted-fg)));
+    --xh-collection-font-weight-selected: var(--xh-time-range-picker-item-font-weight-selected, var(--xh-font-weight-medium));
+    --xh-collection-font-weight-selected-highlight: var(--xh-time-range-picker-item-font-weight-selected, var(--xh-font-weight-medium));
+    --xh-collection-font-weight-selected-hover: var(--xh-time-range-picker-item-font-weight-selected, var(--xh-font-weight-medium));
+    --xh-collection-font-weight-selected-pressed: var(--xh-time-range-picker-item-font-weight-selected, var(--xh-font-weight-medium));
+    --xh-collection-bg-hover: var(--xh-time-range-picker-item-bg-hover, var(--xh-bg-subtle));
+    --xh-collection-bg-keyboard-highlight: var(--xh-time-range-picker-item-bg-hover, var(--xh-bg-subtle));
+    --xh-collection-bg-selected-highlight: var(--xh-time-range-picker-item-bg-hover, var(--xh-bg-subtle));
+    --xh-collection-bg-selected-hover: var(--xh-time-range-picker-item-bg-hover, var(--xh-bg-subtle));
+    --xh-collection-bg-pressed: var(--xh-time-range-picker-item-bg-pressed, var(--xh-bg-subtle-hover));
+    --xh-collection-bg-selected-pressed: var(--xh-time-range-picker-item-bg-pressed, var(--xh-bg-subtle-hover));
+    --xh-collection-outline-keyboard-highlight: transparent;
+    --xh-collection-outline-selected-highlight: transparent;
+
+    position: relative;
+    display: flex;
+    flex: none;
+    align-items: center;
+    justify-content: center;
+    block-size: var(--xh-time-range-picker-item-h, var(--xh-control-action-size));
+    /* 居中的单个数字格没有截断层，行高保持紧排，列内多露几格 */
+    line-height: var(--xh-leading-normal);
+    white-space: nowrap;
+    user-select: none;
+  }
+
+  /* 键盘焦点出现时环才接回并立即到位，不压在背景过渡的中间帧上 */
+  .xh-scope-time-range-picker[data-part='item']:focus-visible:not(:hover) {
+    --xh-collection-outline-keyboard-highlight: var(--xh-ring-focus);
+    --xh-collection-outline-selected-highlight: var(--xh-ring-focus);
+
+    transition: none;
+  }
+
+  /* 作者自己藏掉某几格时要让位，有 display 就得补这条 */
+  /* 命中区向上下各补半个列内间距：两格之间那 8px 缝归上下两格各一半，指针落在缝里不落空 */
+  .xh-scope-time-range-picker[data-part='item']::before {
+    content: '';
+    position: absolute;
+    inset-block: calc(-0.5 * var(--xh-time-range-picker-column-gap, var(--xh-space-2)));
+    inset-inline: 0;
+  }
+
+  .xh-scope-time-range-picker[data-part='item'][hidden] {
+    display: none;
+  }
+
+  .xh-scope-time-range-picker[data-part='item']::after {
+    content: '';
+    position: absolute;
+    inset-block-start: 50%;
+    inset-inline-end: var(--xh-space-0_5);
+    inline-size: var(--xh-time-range-picker-item-check-size, var(--xh-control-indicator-size));
+    block-size: var(--xh-time-range-picker-item-check-size, var(--xh-control-indicator-size));
+    background-color: var(--xh-time-range-picker-item-check-fg, var(--xh-_time-range-picker-check-fg));
+    opacity: 0;
+    translate: 0 -50%;
+    -webkit-mask: var(--xh-glyph-mark-check) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-check) center / contain no-repeat;
+    pointer-events: none;
+    transition: opacity var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+  }
+
+  /* 选中只画对号，正文与静止底保持普通态；悬停 / 高亮 / 按下面由家族给 */
+  .xh-scope-time-range-picker[data-part='item'][data-state='checked']::after {
+    opacity: 1;
+  }
+
+  /* 禁用走 aria-disabled 而非原生 disabled，家族按 aria-disabled 给禁用面；标记跟着降级 */
+  .xh-scope-time-range-picker[data-part='item'][data-disabled]::after {
+    background-color: var(--xh-fg-disabled);
+  }
+
+  @media (forced-colors: active) {
+    .xh-scope-time-range-picker[data-part='segment'][data-invalid]:is([data-focus], :focus-visible) {
+      outline: var(--xh-ring-width) solid Highlight;
+      outline-offset: var(--xh-ring-offset);
+    }
+
+    /* mask 保留对号轮廓，系统色接管墨色；关闭自动调整避免伪元素底被系统抹成透明。 */
+    .xh-scope-time-range-picker[data-part='preset']::after,
+    .xh-scope-time-range-picker[data-part='item']::after {
+      background-color: CanvasText;
+      forced-color-adjust: none;
+    }
+
+    /* 按下与没被高亮时的悬停，家族把条目涂成 Highlight，对号跟着换 HighlightText */
+    .xh-scope-time-range-picker[data-part='preset']:not([aria-disabled='true'], [data-disabled], [aria-busy='true'], [data-error]):is(:active, [data-pressed], :hover:not(:focus-visible, [data-highlighted]))::after,
+    .xh-scope-time-range-picker[data-part='item']:not([aria-disabled='true'], [data-disabled], [aria-busy='true'], [data-error]):is(:active, [data-pressed], :hover:not(:focus-visible, [data-highlighted]))::after {
+      background-color: HighlightText;
+    }
+
+    .xh-scope-time-range-picker[data-part='preset'][data-disabled]::after,
+    .xh-scope-time-range-picker[data-part='item'][data-disabled]::after {
+      background-color: GrayText;
+    }
+  }
+
+  /* 连接层把它写成 type=hidden，UA 自己就不渲染；这里的视觉隐藏是给元素升级前那一瞬兜底
+     （作者手写的是一个普通 input，升级完成前它是可见的文本框）。
+     刻意不写 display：写了反而会盖掉 UA 对 type=hidden 的收起，把它显出来 */
+  .xh-scope-time-range-picker[data-part='hidden-input'] {
+    position: absolute;
+    inline-size: 1px;
+    block-size: 1px;
+    padding: 0;
+    margin: -1px;
+    border: 0;
+    overflow: hidden;
+    clip-path: inset(50%);
+    white-space: nowrap;
+    pointer-events: none;
+  }
+
+  /* 没写内容就由皮肤画兜底字形；作者往部件里塞了自己的图形，这几条即不命中 */
+  .xh-scope-time-range-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;
+  }
+
+  .xh-scope-time-range-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-clock) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-clock) center / contain no-repeat;
+  }
+
+  @media (forced-colors: active) {
+    /* 兜底字形是 mask 挖出来的一块底色，这一档里底色被系统换成 Canvas，字形跟着消失。
+       字形退出强制换色、直接写系统色（不能取 currentColor：退出强制换色的伪元素读到的是被系统换掉之前的作者色）：
+       按钮面上取 ButtonText，悬停与按下时家族把按钮涂成 Highlight、字形换 HighlightText；
+       禁用取 GrayText */
+    .xh-scope-time-range-picker:is([data-part='clear-trigger'], [data-part='trigger']):empty::before {
+      forced-color-adjust: none;
+      background-color: ButtonText;
+    }
+
+    .xh-scope-time-range-picker:is([data-part='clear-trigger'], [data-part='trigger']):not([data-disabled]):not([data-loading]):is(:hover, :active, [data-pressed]):empty::before {
+      background-color: HighlightText;
+    }
+
+    .xh-scope-time-range-picker:is([data-part='clear-trigger'], [data-part='trigger'])[data-disabled]:empty::before {
+      background-color: GrayText;
+    }
+  }
+}
+
+@layer xihan.motion {
+  @media print {
+    /* 打印：定位层与遮罩是交互期才存在的东西，落到纸上只会盖住底下的正文。
+       收起写在这份皮肤里而不是 reset：reset 层排在组件层之前，组件层里任何一条 display 都压得住它。 */
+    .xh-scope-time-range-picker[data-part='positioner'] {
+      display: none;
+    }
+  }
+}