@xihan-ui/styles 3.1.0 → 4.0.0

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

@@ -0,0 +1,949 @@
+/*
+ * Copyright (c) 2021-Present XiHanFun and contributors.
+ * Licensed under the MIT License. See LICENSE in the project root for license information.
+ */
+
+/* DateRangePicker 独立皮肤同时传递引入字段视觉盒、字段内动作与浮层集合行；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-date-range-picker {
+    --xh-date-range-picker-skin: 1;
+  }
+
+  /* 坐标由定位引擎写进 style（inset-inline-start / inset-block-start），这里只定位模式与层级 */
+  .xh-scope-date-range-picker[data-part='positioner'] {
+    /* 落定那一侧的可用高度，由定位引擎经内联自定义属性写进来，内容层继承它限高；
+       引擎没算（尚未落位 / 无引擎 / 贴边归零）时不额外限高 */
+    --xh-_date-range-picker-available-h: 100vh;
+    /* 落定那一侧的可用宽度，同样由定位引擎经内联自定义属性写进来，内容层据此夹住行内轴；
+       引擎没算（尚未落位 / 无引擎 / 贴边归零）时退到视口宽 */
+    --xh-_date-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-date-range-picker-layer, var(--xh-_layer, var(--xh-layer-popover)));
+    /* 空壳不吃指针，交互只发生在 content 里 */
+    pointer-events: none;
+  }
+
+  /* 锚点被滚出可视区：整个浮层随之收起 */
+  .xh-scope-date-range-picker[data-part='positioner'][data-hidden] {
+    visibility: hidden;
+  }
+
+  /* 短位移按实际落位的物理方向给，不随书写方向翻转。 */
+  .xh-scope-date-range-picker[data-part='positioner'][data-placement^='top'] {
+    --xh-_overlay-enter-down: 1;
+  }
+
+  .xh-scope-date-range-picker[data-part='positioner'][data-placement^='bottom'] {
+    --xh-_overlay-enter-up: 1;
+  }
+
+  .xh-scope-date-range-picker[data-part='positioner'][data-placement^='left'] {
+    --xh-_overlay-enter-right: 1;
+  }
+
+  .xh-scope-date-range-picker[data-part='positioner'][data-placement^='right'] {
+    --xh-_overlay-enter-left: 1;
+  }
+
+  /* 私有槽同时声明在根与 positioner 上：浮层被搬到 portal 落点，不是根的后代，继承不过去 */
+  .xh-scope-date-range-picker:is([data-part='root'], [data-part='positioner']) {
+    /* 尺寸档只换这几个私有槽，标题、输入行与浮层里的部件都从这两处继承它们，
+       换档不必给每个部件各写一条选择器；形态三档由家族按 control 上的 data-variant 生成，皮肤不再声明 */
+    --xh-_date-range-picker-control-h: var(--xh-control-h-md);
+    --xh-_date-range-picker-control-px: var(--xh-control-px-md);
+    --xh-_date-range-picker-gap: var(--xh-control-gap-md);
+    --xh-_date-range-picker-font-size: var(--xh-control-font-md);
+
+    /* 选中对号随语气走。没写 data-tone 时这几个 --xh-_tone* 没被声明，退回品牌色 */
+    /* 内嵌日期段沿用日期输入的轻强调焦点：当前段是「当前项」，淡底 + 淡底前景，不另画一套实心选择态。 */
+    --xh-_date-field-segment-bg: var(--xh-_tone-subtle, var(--xh-bg-brand-subtle));
+    --xh-_date-field-segment-fg: var(--xh-_tone-fg, var(--xh-fg-on-brand-subtle));
+    /* 对号画在普通面上，取语气前景角色，不拿实心强调底色充当前景。 */
+    --xh-_date-range-picker-check-fg: var(--xh-_tone, var(--xh-fg-brand));
+    /* 时间列与预设的对号与 Select 等列表的对号同一把尺：指示符档，随密度收放 */
+    --xh-_date-range-picker-time-item-check-size: var(--xh-control-indicator-size);
+  }
+
+  /* 375px 复合面板要同时容下日历与两组时间列；手机档用正式小指示符，平板起恢复 16px。 */
+  @media not all and (min-width: 768px) {
+    .xh-scope-date-range-picker:is([data-part='root'], [data-part='positioner']) {
+      --xh-_date-range-picker-time-item-check-size: var(--xh-control-indicator-sm);
+    }
+  }
+
+  /* 与文本框、分段日期同一套堆叠：标签一行、输入行一行 */
+  .xh-scope-date-range-picker[data-part='root'] {
+    /* 作者塞进指示符槽的图标跟着字号走，与皮肤画的兜底字形同一把尺 */
+    --xh-icon-size: var(--xh-date-range-picker-icon-size, var(--xh-glyph-size-md));
+
+    display: inline-flex;
+    flex-direction: column;
+    gap: var(--xh-date-range-picker-gap, var(--xh-space-1));
+
+    /* 与别的字段同一个缺省宽：放在一排筛选条件里不比相邻的字段宽出一截。
+       起止两组按日带时刻的段位放不进时由两组各自收住（见 segment-group），分隔符与日历钮始终留在框里；
+       要整段都露出来，经这条槽钉宽。父容器给不出这么宽时整件跟着收，地板同步让步，不越出父容器 */
+    inline-size: var(--xh-date-range-picker-control-w, var(--xh-control-w));
+    min-inline-size: min(var(--xh-date-range-picker-control-w, var(--xh-control-w)), var(--xh-date-range-picker-control-min-w, var(--xh-control-min-w)), 100%);
+    max-inline-size: 100%;
+  }
+
+  /* —— 尺寸 —— */
+  /* 缺省档写在上面的基础规则里 */
+  .xh-scope-date-range-picker:is([data-part='root'], [data-part='positioner'])[data-size='sm'] {
+    --xh-icon-size: var(--xh-date-range-picker-icon-size, var(--xh-glyph-size-sm));
+    --xh-_date-range-picker-control-h: var(--xh-control-h-sm);
+    --xh-_date-range-picker-control-px: var(--xh-control-px-sm);
+    --xh-_date-range-picker-gap: var(--xh-control-gap-sm);
+    --xh-_date-range-picker-font-size: var(--xh-control-font-sm);
+  }
+
+  .xh-scope-date-range-picker:is([data-part='root'], [data-part='positioner'])[data-size='lg'] {
+    --xh-icon-size: var(--xh-date-range-picker-icon-size, var(--xh-glyph-size-lg));
+    --xh-_date-range-picker-control-h: var(--xh-control-h-lg);
+    --xh-_date-range-picker-control-px: var(--xh-control-px-lg);
+    --xh-_date-range-picker-gap: var(--xh-control-gap-lg);
+    --xh-_date-range-picker-font-size: var(--xh-control-font-lg);
+  }
+
+  /* 只要声明了 display 就盖掉了 UA 的 [hidden]{display:none}，收起态得自己还回去 */
+  .xh-scope-date-range-picker[data-part='root'][hidden] {
+    display: none;
+  }
+
+  .xh-scope-date-range-picker[data-part='label'] {
+    /* 竖排时标签与控件之间的距离：根的 gap 之上补一段差值，--xh-date-range-picker-label-gap 给多少最终就是多少 */
+    margin-block-end: calc(var(--xh-date-range-picker-label-gap, var(--xh-space-2)) - var(--xh-date-range-picker-gap, var(--xh-space-1)));
+    color: var(--xh-date-range-picker-label-fg, var(--xh-fg-muted));
+    font-size: var(--xh-date-range-picker-label-font-size, var(--xh-text-label-size));
+    font-weight: var(--xh-date-range-picker-label-font-weight, var(--xh-text-label-weight));
+    line-height: var(--xh-leading-none);
+  }
+
+  .xh-scope-date-range-picker[data-part='label'][hidden] {
+    display: none;
+  }
+
+  .xh-scope-date-range-picker[data-part='label'][data-disabled] {
+    color: var(--xh-date-range-picker-label-fg-disabled, var(--xh-fg-muted));
+  }
+
+  /* 画成一个框的是 control 而不是 input：段位、清空按钮、日历按钮三者要看起来是一体的，
+     边框长在里面任何一个身上都会把另外两个割在框外。描边、底色、圆角、聚焦环、五态与悬停由
+     Field Chrome 家族画在 control 上（焦点落在段或按钮上，家族 :focus-within 让整框亮起来）；
+     组件只映射既有公开槽（shadow 缺省 none：字段静息描边式、无影）。打开中不另画环，由浮层本身承担 */
+  .xh-scope-date-range-picker[data-part='control'] {
+    --xh-field-control-height: var(--xh-date-range-picker-control-h, var(--xh-_date-range-picker-control-h));
+    --xh-field-control-padding-inline: var(--xh-date-range-picker-control-px, var(--xh-_date-range-picker-control-px));
+    --xh-field-control-gap: var(--xh-date-range-picker-control-gap, var(--xh-_date-range-picker-gap));
+    --xh-field-control-min-inline-size: var(--xh-date-range-picker-control-min-w, var(--xh-control-min-w));
+    --xh-field-control-radius: var(--xh-date-range-picker-control-radius, var(--xh-shape-control));
+    --xh-field-bg-rest: var(--xh-date-range-picker-control-bg, var(--xh-_field-variant-bg-rest));
+    --xh-field-bg-hover: var(--xh-date-range-picker-control-bg-hover, var(--xh-_field-variant-bg-hover));
+    --xh-field-bg-read-only: var(--xh-date-range-picker-control-bg-readonly, var(--xh-_field-variant-bg-read-only));
+    --xh-field-bg-disabled: var(--xh-date-range-picker-control-bg-disabled, var(--xh-_field-variant-bg-disabled));
+    --xh-field-fg-rest: var(--xh-date-range-picker-control-fg, var(--xh-fg-default));
+    --xh-field-border-rest: var(--xh-date-range-picker-control-border, var(--xh-_field-variant-border-rest));
+    --xh-field-border-hover: var(--xh-date-range-picker-control-border-hover, var(--xh-_field-variant-border-hover));
+    --xh-field-border-focus: var(--xh-date-range-picker-control-border-focus, var(--xh-_field-variant-border-focus));
+    --xh-field-border-invalid: var(--xh-date-range-picker-control-border-invalid, var(--xh-_field-variant-border-invalid));
+    --xh-field-shadow-rest: var(--xh-date-range-picker-control-shadow, none);
+    /* 段位靠键盘编辑，盒上不是文本光标 */
+    --xh-field-cursor-rest: default;
+    /* 家族 chrome 会重写 --xh-icon-size，使用者图标槽必须经桥接槽下发才能在盒内生效 */
+    --xh-field-glyph-size: var(--xh-date-range-picker-icon-size, var(--xh-_field-size-glyph-size));
+  }
+
+  .xh-scope-date-range-picker[data-part='control'][hidden] {
+    display: none;
+  }
+
+  /* 段位与作者写在段间的分隔符都在这一层里：段位自己那身皮由 date-field 那份样式负责
+     （它们戴的是那一份解剖的标记），这里只管把一排段位横过来、占满输入行剩下的宽度。
+     框比两组段位窄时（缺省宽里放按日带时刻的区间），两组按各自内容宽的比例一起收、各在组内裁掉放不下的段位：
+     不裁的话终点那组会被挤成零宽、段位与日历钮一起冒出框外。裁掉的段位仍可聚焦，键盘走到它时组跟着滚过去 */
+  .xh-scope-date-range-picker[data-part='segment-group'] {
+    display: inline-flex;
+    flex: 1 1 auto;
+    align-items: center;
+    min-inline-size: 0;
+    overflow: hidden;
+    block-size: 100%;
+    color: inherit;
+    /* 表单控件不继承页面字体，只给字号会让段位用 UA 默认字族，与周围文本对不上 */
+    font-family: inherit;
+    font-size: var(--xh-date-range-picker-font-size, var(--xh-_date-range-picker-font-size));
+    line-height: var(--xh-leading-none);
+  }
+
+  .xh-scope-date-range-picker[data-part='segment-group'][hidden] {
+    display: none;
+  }
+
+  /* 起点那组只占自己的宽度，分隔符紧跟在起点后面；剩下的宽度全给终点那组。
+     放不下时它同样收缩，与终点那组一起让，不把终点那组挤成零宽 */
+  .xh-scope-date-range-picker[data-part='segment-group'][data-index='0']:has(+ [data-part='range-separator']) {
+    flex: 0 1 auto;
+  }
+
+  .xh-scope-date-range-picker[data-part='range-separator'] {
+    display: inline-flex;
+    flex: none;
+    align-items: center;
+    justify-content: center;
+    /* 两侧各留一个小间距：把输入行的常规间距收回来，再补上自己那一份 */
+    --xh-_date-range-picker-range-separator-mx: calc(var(--xh-date-range-picker-range-separator-px, var(--xh-space-1)) - var(--xh-date-range-picker-control-gap, var(--xh-_date-range-picker-gap)));
+
+    margin-inline: var(--xh-date-range-picker-range-separator-mx, var(--xh-_date-range-picker-range-separator-mx));
+    padding-inline: var(--xh-date-range-picker-range-separator-px, var(--xh-space-1));
+    color: var(--xh-date-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-date-range-picker[data-part='range-separator'][hidden] {
+    display: none;
+  }
+
+  .xh-scope-date-range-picker[data-part='segment-group'] > :not([data-scope]) {
+    color: var(--xh-date-range-picker-literal-fg, var(--xh-fg-subtle));
+  }
+
+  /* 整条占位：一段都没填、焦点也不在段上时，段位与分隔符让位给一句占位文字，焦点一进到段上就换回段位。
+     段位只是淡出（仍可聚焦、仍在读屏树里），文字以生成内容压在同一行上、不吃指针，点下去落到底下的段位 */
+  .xh-scope-date-range-picker[data-part='segment-group'][data-placeholder-shown] {
+    position: relative;
+    color: transparent;
+  }
+
+  /* 段位与分隔符（后者是不带解剖的文字节点）一起淡出：显隐写在 segment-group 自己的私有槽上，
+     子节点只读槽——主体无特征的规则不挂在 data-placeholder-shown 后面，输入时翻转只让这一组失效 */
+  .xh-scope-date-range-picker[data-part='segment-group'][data-placeholder-shown] {
+    --xh-_date-range-picker-segment-opacity: 0;
+  }
+
+  .xh-scope-date-range-picker[data-part='segment-group'] > * {
+    opacity: var(--xh-_date-range-picker-segment-opacity, 1);
+  }
+
+  .xh-scope-date-range-picker[data-part='segment-group'][data-placeholder-shown]::before {
+    content: attr(data-placeholder-text);
+    position: absolute;
+    inset-inline: 0;
+    inset-block-start: 50%;
+    overflow: hidden;
+    color: var(--xh-date-range-picker-placeholder-fg, var(--xh-fg-subtle));
+    white-space: nowrap;
+    text-overflow: ellipsis;
+    pointer-events: none;
+    translate: 0 -50%;
+  }
+
+  /* 容器自己不占 Tab 位、也不承载焦点，环由 control 画，这里不再套一圈 */
+  .xh-scope-date-range-picker[data-part='segment-group']:focus-visible {
+    outline: none;
+  }
+
+  /* 两个按钮同一副长相：贴在框内末端的小方钮，不占宽度也不撑高 control。正方视觉盒、inset 圆角、
+     悬停 100 / 按下 200 与 0.97 按压、粗指针热区、禁用面与 :focus-visible 关环（盒的 :focus-within
+     已画了一圈）全由 Action Control 的 field-inset ghost 档给，组件只映射既有覆盖槽。
+     打开中与悬停同档：日历钮不另上底，方向由浮层本身承担 */
+  .xh-scope-date-range-picker[data-part='trigger'],
+  .xh-scope-date-range-picker[data-part='clear-trigger'] {
+    --xh-action-visual-size: var(--xh-date-range-picker-action-size, var(--xh-_action-profile-visual-size));
+    --xh-action-min-inline-size: var(--xh-date-range-picker-action-size, var(--xh-_action-profile-visual-size));
+    --xh-action-radius: var(--xh-date-range-picker-action-radius, var(--xh-shape-inset));
+    /* 底色阶梯由 ghost 档给（透明 → 100 → 200），使用者槽只作覆盖入口 */
+    --xh-action-bg-rest: var(--xh-date-range-picker-action-bg, var(--xh-_action-variant-bg-rest));
+    --xh-action-bg-hover: var(--xh-date-range-picker-action-bg-hover, var(--xh-_action-variant-bg-hover));
+    --xh-action-bg-pressed: var(--xh-date-range-picker-action-bg-active, var(--xh-_action-variant-bg-pressed));
+    --xh-action-fg-rest: var(--xh-date-range-picker-action-fg, var(--xh-fg-muted));
+    --xh-action-fg-hover: var(--xh-date-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-date-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-date-range-picker[data-part='trigger'][hidden],
+  .xh-scope-date-range-picker[data-part='clear-trigger'][hidden] {
+    display: none;
+  }
+
+  /* 打开中与悬停同档：日历钮的静息底换到悬停那一支中性面，不用品牌色、不另画环；方向由浮层本身承担 */
+  .xh-scope-date-range-picker[data-part='trigger'][data-state='open'] {
+    --xh-action-bg-rest: var(--xh-date-range-picker-action-bg-hover, var(--xh-_action-variant-bg-hover));
+    --xh-action-fg-rest: var(--xh-date-range-picker-action-fg-hover, var(--xh-fg-default));
+  }
+
+  /* 有值时清空钮顶上来，日历钮让位：两颗并排堆着用户分不清点哪个 */
+  .xh-scope-date-range-picker[data-part='control']:has(
+      > .xh-scope-date-range-picker[data-part='clear-trigger']:not([hidden])
+    )
+    > .xh-scope-date-range-picker[data-part='trigger'] {
+    display: none;
+  }
+
+  /* 浮层：含两张日历网格的锚定面板，走 floating 材质——实体底 + --xh-border-default 描边 +
+     --xh-elevation-floating 落影，不透景、不画顶光。面板自己不留内衬：标题栏、网格、快捷选项列与时间列各带内衬，
+     分隔线才能从面板一边通到另一边 */
+  .xh-scope-date-range-picker[data-part='content'] {
+    position: relative;
+    display: block;
+    /* 行内轴只有落位后的可用宽度这一个上限：不夹住，浮层就会被定位层的包含块压窄，
+       网格轨道跟着缩到比日期钮还窄，相邻两颗日期钮互相盖住 */
+    max-inline-size: var(--xh-_date-range-picker-available-w);
+    padding-block: var(--xh-date-range-picker-content-py, var(--xh-space-0));
+    padding-inline: var(--xh-date-range-picker-content-px, var(--xh-space-0));
+    border: var(--xh-stroke-thin) solid var(--xh-date-range-picker-content-border, var(--xh-border-default));
+    border-radius: var(--xh-date-range-picker-content-radius, var(--xh-shape-overlay));
+    background: var(--xh-date-range-picker-content-bg, var(--xh-bg-surface));
+    color: var(--xh-date-range-picker-content-fg, var(--xh-fg-default));
+    /* 日历是定高结构：网格、时间列与底栏都按 px 排，天然高度就是它们的和，缺省不另设上限
+       （按 rem 的滚动面档会随根字号缩小，根字号低于 16px 时底栏就被挤到滚动里）；
+       可用高度是定位引擎算出的视口余量，视口真放不下时再收一截 */
+    max-block-size: min(var(--xh-date-range-picker-max-h, var(--xh-_date-range-picker-available-h)), var(--xh-_date-range-picker-available-h));
+    /* 两轴都滚：块轴放不下时面板内自己竖滚，行内轴放不下时面板内自己横滚，
+       日历那几块保持各自的天然宽度，不被压 */
+    overflow: auto;
+    /* 浮层滚动面：滚到头不把页面一起带走 */
+    overscroll-behavior: contain;
+    box-shadow: var(--xh-date-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]，那几处没有退场动画。 */
+
+  /* 浮层壳不承载焦点（焦点直接落到聚焦日那一格），但它写着 tabindex=-1，
+     程序化落焦时不该再画一圈环 */
+  .xh-scope-date-range-picker[data-part='content']:focus-visible {
+    outline: none;
+  }
+
+  /* 挂载时就开着的那一段（data-instant）属于首帧，直接呈现 */
+  .xh-scope-date-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-date-range-picker[data-part='content'][data-state='closed'] {
+    animation: xh-overlay-slide-out var(--xh-motion-duration-exit) var(--xh-motion-ease-exit) forwards;
+  }
+
+  /* 内嵌日历的挂载点同时充当日历的根节点：日历那份样式的 root 规则落在
+     .xh-scope-calendar-range-picker[data-part='root'] 上，而这里没有那个节点，
+     所以网格外层该有的排布得在这儿补齐（网格内部的皮仍归 calendar-range-picker 那一份） */
+  /* 真的摆了两张日历才横过来。写成 :has 而不是无条件 flex 行：
+     作者可能在 content 里再包一层自己的块，无条件横排会把它并到日历旁边去。
+     不加 :not([hidden])：content 收起态带 hidden 但仍在播退场动画，
+     排除掉会让它在那几帧退回 block、两张日历竖着堆一下。
+     并排放不下就折行，第二张月历落到第一张下面：视口窄与面板被夹窄都命中这一条 */
+  .xh-scope-date-range-picker[data-part='content']:has(> [data-part='calendar'] + [data-part='calendar']) {
+    display: flex;
+    flex-wrap: wrap;
+    align-items: flex-start;
+  }
+
+  /* 快捷选项列摆在日历的行内起始一侧，同样只在它真在场时才横过来。
+     与上一条同理：不加 :not([hidden])，退场那几帧塌回 block 会让两块竖着堆一下。
+     一并折行：选项条在手机档占满一行，日历落到它下面 */
+  .xh-scope-date-range-picker[data-part='content']:has(> [data-part='preset-group']) {
+    display: flex;
+    flex-wrap: wrap;
+    align-items: stretch;
+  }
+
+  /* 两张日历并排时不画竖线、不另留空当：各自左右 16 的内衬合成 32 的空白就是两张网格的界，
+     两条标题栏的下沿分隔线首尾相接连成一条 */
+
+  .xh-scope-date-range-picker[data-part='calendar'] {
+    display: flex;
+    /* 面板被夹窄时不跟着缩：日期钮的宽度是定死的，网格轨道再窄下去就会与右邻的钮叠在一起。
+       撑出去的那截交给面板自己横滚 */
+    min-inline-size: max-content;
+    flex-direction: column;
+    gap: var(--xh-date-range-picker-calendar-gap, var(--xh-space-0));
+    /* 数字等宽：1 与 7 的字形宽度在比例字体里并不相同，不定住会让整张网格随月份抖动 */
+    font-variant-numeric: tabular-nums;
+  }
+
+  /* 浮层里的日历标题取常规字重：面板标题栏只是年月的读数，不压过网格 */
+  .xh-scope-date-range-picker[data-part='calendar'] .xh-scope-calendar-range-picker[data-part='heading'],
+  .xh-scope-date-range-picker[data-part='calendar'] .xh-scope-calendar-range-picker[data-part='heading-year-trigger'],
+  .xh-scope-date-range-picker[data-part='calendar'] .xh-scope-calendar-range-picker[data-part='heading-month-trigger'] {
+    font-weight: var(--xh-date-range-picker-heading-font-weight, var(--xh-font-weight-regular));
+  }
+
+  .xh-scope-date-range-picker[data-part='calendar'][hidden] {
+    display: none;
+  }
+
+  /* —— 快捷选项：一条按钮式条目 —— */
+  /* 手机档：整条压在面板顶部占满一行，条目横着排，放不下就这一条自己横滚 */
+  .xh-scope-date-range-picker[data-part='preset-group'] {
+    display: flex;
+    /* 独占面板的一整行，后面的日历折到它下面 */
+    flex: 0 0 100%;
+    /* 这一条的另一轴由并排的那块给：不写就按内容收，分隔线只画到最后一条选项 */
+    align-self: stretch;
+    flex-direction: row;
+    gap: var(--xh-date-range-picker-preset-group-gap, var(--xh-space-1));
+    /* 选项多起来时这一条自己滚，不把整张面板撑大 */
+    max-block-size: var(--xh-date-range-picker-preset-group-h, var(--xh-viewport-h-lg));
+    padding-block: var(--xh-date-range-picker-preset-group-py, var(--xh-space-2_5));
+    padding-inline: var(--xh-date-range-picker-preset-group-px, var(--xh-space-2));
+    overflow-x: auto;
+    overflow-y: hidden;
+    /* 浮层滚动面：滚到头不把页面一起带走 */
+    overscroll-behavior: contain;
+    border-block-end: var(--xh-stroke-thin) solid var(--xh-date-range-picker-column-divider, var(--xh-material-solid-border));
+  }
+
+  /* 平板起：换成贴在日历行内起始一侧的竖列，滚动轴与分隔线一起转过来 */
+  @media (min-width: 768px) {
+    .xh-scope-date-range-picker[data-part='preset-group'] {
+      flex: none;
+      flex-direction: column;
+      overflow: auto;
+      border-block-end: none;
+      border-inline-end: var(--xh-stroke-thin) solid var(--xh-date-range-picker-column-divider, var(--xh-material-solid-border));
+    }
+  }
+
+  .xh-scope-date-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-date-range-picker[data-part='preset'] {
+    --xh-collection-block-padding: 0;
+    --xh-collection-inline-padding: var(--xh-date-range-picker-preset-px, var(--xh-space-2));
+    --xh-collection-font-size: var(--xh-date-range-picker-preset-font-size, var(--xh-text-caption-size));
+    --xh-collection-radius: var(--xh-date-range-picker-preset-radius, var(--xh-shape-control));
+    --xh-collection-fg-rest: var(--xh-date-range-picker-preset-fg, var(--xh-fg-muted));
+    --xh-collection-fg-selected: var(--xh-date-range-picker-preset-fg, var(--xh-fg-muted));
+    /* 悬停 / 高亮 / 按下时字换正文色：底升到 200 / 300 之后，次级前景在暗色下不足 4.5:1 */
+    --xh-collection-fg-hover: var(--xh-date-range-picker-preset-fg-hover, var(--xh-fg-default));
+    --xh-collection-fg-keyboard-highlight: var(--xh-date-range-picker-preset-fg-hover, var(--xh-fg-default));
+    --xh-collection-fg-pressed: var(--xh-date-range-picker-preset-fg-hover, var(--xh-fg-default));
+    --xh-collection-fg-selected-highlight: var(--xh-date-range-picker-preset-fg-hover, var(--xh-fg-default));
+    --xh-collection-fg-selected-hover: var(--xh-date-range-picker-preset-fg-hover, var(--xh-fg-default));
+    --xh-collection-fg-selected-pressed: var(--xh-date-range-picker-preset-fg-hover, var(--xh-fg-default));
+    --xh-collection-fg-disabled: var(--xh-date-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-date-range-picker-preset-bg, var(--xh-bg-subtle));
+    --xh-collection-bg-selected: var(--xh-date-range-picker-preset-bg, var(--xh-bg-subtle));
+    --xh-collection-bg-hover: var(--xh-date-range-picker-preset-bg-hover, var(--xh-bg-subtle-hover));
+    --xh-collection-bg-keyboard-highlight: var(--xh-date-range-picker-preset-bg-hover, var(--xh-bg-subtle-hover));
+    --xh-collection-bg-selected-highlight: var(--xh-date-range-picker-preset-bg-hover, var(--xh-bg-subtle-hover));
+    --xh-collection-bg-selected-hover: var(--xh-date-range-picker-preset-bg-hover, var(--xh-bg-subtle-hover));
+    --xh-collection-bg-pressed: var(--xh-date-range-picker-preset-bg-pressed, var(--xh-bg-subtle-active));
+    --xh-collection-bg-selected-pressed: var(--xh-date-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-date-range-picker-preset-h, var(--xh-control-action-size));
+    /* 对号的末端轨始终留着，切换选中时文字与整列宽度都不移动。 */
+    padding-inline-end: calc(
+      var(--xh-date-range-picker-preset-px, var(--xh-space-2)) +
+        var(--xh-date-range-picker-preset-check-size, var(--xh-control-indicator-sm)) +
+        var(--xh-space-1)
+    );
+    /* 一行字在 24 高的钮里垂直居中 */
+    line-height: var(--xh-date-range-picker-preset-h, var(--xh-control-action-size));
+    white-space: nowrap;
+    user-select: none;
+  }
+
+  /* 键盘焦点出现时环才接回并立即到位，不压在背景过渡的中间帧上 */
+  .xh-scope-date-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;
+  }
+
+  /* 上面给了 display，UA 的 [hidden]{display:none} 已被盖掉，这里补回来 */
+  .xh-scope-date-range-picker[data-part='preset'][hidden] {
+    display: none;
+  }
+
+  .xh-scope-date-range-picker[data-part='preset']::after {
+    content: '';
+    position: absolute;
+    inset-block-start: 50%;
+    inset-inline-end: var(--xh-date-range-picker-preset-px, var(--xh-space-2));
+    inline-size: var(--xh-date-range-picker-preset-check-size, var(--xh-control-indicator-sm));
+    block-size: var(--xh-date-range-picker-preset-check-size, var(--xh-control-indicator-sm));
+    translate: 0 -50%;
+    background-color: var(--xh-date-range-picker-preset-check-fg, var(--xh-_date-range-picker-check-fg));
+    opacity: 0;
+    pointer-events: none;
+    transition: opacity var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+    -webkit-mask: var(--xh-glyph-mark-check) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-check) center / contain no-repeat;
+  }
+
+  .xh-scope-date-range-picker[data-part='preset'][data-state='checked']::after {
+    opacity: 1;
+  }
+
+  .xh-scope-date-range-picker[data-part='preset'][data-disabled]::after {
+    background-color: var(--xh-date-range-picker-preset-fg-disabled, var(--xh-fg-disabled));
+  }
+
+  /* —— showTime：起止各一组时间列贴在日历旁边、逐列滚动，确认按钮收口 ——
+     与日历同处一条可折行的行内流：放得下就并排，放不下时两组时间列折到日历下面，组内几列仍横着排 */
+  .xh-scope-date-range-picker[data-part='content']:has(> [data-part='column-group']) {
+    display: flex;
+    flex-wrap: wrap;
+    align-items: flex-start;
+  }
+
+  /* 确认按钮沉到所在那一行的底边：它是整块面板的出口，不跟日历顶边对齐。面板不留内衬，
+     钮自己与底边、末边各让一档空当 */
+  .xh-scope-date-range-picker[data-part='content']:has(> [data-part='column-group']) > [data-part='confirm-trigger']:where(.xh-scope-date-range-picker) {
+    align-self: flex-end;
+    margin: var(--xh-date-range-picker-confirm-trigger-margin, var(--xh-space-2));
+  }
+
+  /* 一端的几列成组并排，小标题落在与日历标题栏等高的顶带里（不含它下沿那道线）；
+     组的行内起始边画一道整高的竖线，日历与起点组、起点组与终点组之间各一道，组内列与列之间不画线 */
+  .xh-scope-date-range-picker[data-part='column-group'] {
+    --xh-_date-range-picker-column-group-offset: var(
+      --xh-date-range-picker-column-group-offset,
+      calc(var(--xh-control-action-size) + 2 * var(--xh-space-2))
+    );
+
+    position: relative;
+    display: flex;
+    flex: none;
+    flex-wrap: nowrap;
+    align-items: stretch;
+    min-inline-size: 0;
+    /* 让出与日历标题栏等高的一带放小标题；列自己的上沿描边接着标题栏的分隔线画过去 */
+    padding-block-start: var(--xh-_date-range-picker-column-group-offset);
+    border-inline-start: var(--xh-stroke-thin) solid var(--xh-date-range-picker-column-divider, var(--xh-material-solid-border));
+  }
+
+  .xh-scope-date-range-picker[data-part='column-group'][hidden] {
+    display: none;
+  }
+
+  .xh-scope-date-range-picker[data-part='column-group'] + .xh-scope-date-range-picker[data-part='column-group'] {
+    margin-inline-start: var(--xh-date-range-picker-column-group-gap, var(--xh-space-0));
+  }
+
+  /* 组的小标题：辅助文本档、次要前景，起止两组同一副样式（与时间范围选择器一致）。正在编辑的那一端虽然投影了
+     data-editing，这里不拿它分档：并排的两个标题一深一浅，读起来像一个可用、一个不可用 */
+  .xh-scope-date-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-_date-range-picker-column-group-offset);
+    padding-inline: var(--xh-date-range-picker-column-group-label-px, var(--xh-space-1));
+    color: var(--xh-date-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-date-range-picker[data-part='column-group-label'][hidden] {
+    display: none;
+  }
+
+  /* 时间列：列高与日历网格同高（再加列顶那道线），列底与网格底边对齐；列与列之间不画线 */
+  .xh-scope-date-range-picker[data-part='time-column'] {
+    --xh-_date-range-picker-time-column-h: var(--xh-date-range-picker-time-column-h, var(--xh-overlay-calendar-column-h));
+    --xh-_date-range-picker-time-column-py: var(--xh-date-range-picker-time-column-py, var(--xh-space-1));
+
+    display: flex;
+    flex: none;
+    flex-direction: column;
+    gap: var(--xh-date-range-picker-time-column-gap, var(--xh-space-2));
+    min-inline-size: var(--xh-date-range-picker-time-column-min-w, var(--xh-overlay-column-min-w));
+    /* 几列并排：定高而不是随内容收，否则时列与分列的可选值一多一少就错位 */
+    block-size: calc(var(--xh-_date-range-picker-time-column-h) + var(--xh-stroke-thin));
+    /* 列底留出一截空白：末尾几格（23 时、55–59 分）也能滚到列顶，各列的选中落在同一行 */
+    padding-block: var(--xh-_date-range-picker-time-column-py)
+      calc(var(--xh-_date-range-picker-time-column-h) - var(--xh-date-range-picker-time-item-h, var(--xh-control-action-size)) - var(--xh-_date-range-picker-time-column-py));
+    padding-inline: var(--xh-date-range-picker-time-column-px, 0);
+    overflow-x: hidden;
+    overflow-y: auto;
+    /* 浮层滚动面：滚到头不把页面一起带走 */
+    overscroll-behavior: contain;
+    border-block-start: var(--xh-stroke-thin) solid var(--xh-date-range-picker-column-divider, var(--xh-material-solid-border));
+  }
+
+  .xh-scope-date-range-picker[data-part='time-column'][hidden] {
+    display: none;
+  }
+
+  /* 粗指针下日历格长到 44 见方（行距从 36 加到 44），网格多出六行的那截；列高跟着加，列底仍与网格底边对齐 */
+  @media (pointer: coarse) {
+    .xh-scope-date-range-picker[data-part='time-column'] {
+      --xh-_date-range-picker-time-column-h: var(--xh-date-range-picker-time-column-h, var(--xh-overlay-calendar-column-h-coarse));
+    }
+  }
+
+  /* 时间格：24 高的通栏条，列内间距 8 撑出 32 的行距；悬停 / 高亮 100、按下 200 由 Collection Item 家族按
+     overlay 语境给，选中透明底 + 中等字重 + 末端对号（对号集合的选中），不上品牌淡底、不变字色。
+     格里只有数字、没有正文部件，保持自己的居中排版与等宽标记轨，家族只给状态面 */
+  .xh-scope-date-range-picker[data-part='time-item'] {
+    --xh-_date-range-picker-time-item-rail: max(
+      var(--xh-date-range-picker-time-item-px, var(--xh-space-0_5)),
+      calc(var(--xh-date-range-picker-time-item-check-size, var(--xh-_date-range-picker-time-item-check-size)) + var(--xh-space-0_5))
+    );
+    --xh-collection-block-padding: 0;
+    --xh-collection-inline-padding: var(--xh-_date-range-picker-time-item-rail);
+    --xh-collection-font-size: var(--xh-date-range-picker-time-item-font-size, var(--xh-_date-range-picker-font-size));
+    /* 浮层里的列表是通栏行：格铺满列宽、不取圆角 */
+    --xh-collection-radius: var(--xh-date-range-picker-time-item-radius, 0);
+    --xh-collection-fg-rest: var(--xh-date-range-picker-time-item-fg, var(--xh-material-frosted-fg));
+    --xh-collection-fg-hover: var(--xh-date-range-picker-time-item-fg, var(--xh-material-frosted-fg));
+    --xh-collection-fg-keyboard-highlight: var(--xh-date-range-picker-time-item-fg, var(--xh-material-frosted-fg));
+    --xh-collection-fg-pressed: var(--xh-date-range-picker-time-item-fg, var(--xh-material-frosted-fg));
+    --xh-collection-fg-selected: var(--xh-date-range-picker-time-item-fg-selected, var(--xh-date-range-picker-time-item-fg, var(--xh-material-frosted-fg)));
+    --xh-collection-fg-selected-highlight: var(--xh-date-range-picker-time-item-fg-selected, var(--xh-date-range-picker-time-item-fg, var(--xh-material-frosted-fg)));
+    --xh-collection-fg-selected-hover: var(--xh-date-range-picker-time-item-fg-selected, var(--xh-date-range-picker-time-item-fg, var(--xh-material-frosted-fg)));
+    --xh-collection-fg-selected-pressed: var(--xh-date-range-picker-time-item-fg-selected, var(--xh-date-range-picker-time-item-fg, var(--xh-material-frosted-fg)));
+    --xh-collection-font-weight-selected: var(--xh-date-range-picker-time-item-font-weight-selected, var(--xh-font-weight-medium));
+    --xh-collection-font-weight-selected-highlight: var(--xh-date-range-picker-time-item-font-weight-selected, var(--xh-font-weight-medium));
+    --xh-collection-font-weight-selected-hover: var(--xh-date-range-picker-time-item-font-weight-selected, var(--xh-font-weight-medium));
+    --xh-collection-font-weight-selected-pressed: var(--xh-date-range-picker-time-item-font-weight-selected, var(--xh-font-weight-medium));
+    --xh-collection-bg-hover: var(--xh-date-range-picker-time-item-bg-hover, var(--xh-bg-subtle));
+    --xh-collection-bg-keyboard-highlight: var(--xh-date-range-picker-time-item-bg-hover, var(--xh-bg-subtle));
+    --xh-collection-bg-selected-highlight: var(--xh-date-range-picker-time-item-bg-hover, var(--xh-bg-subtle));
+    --xh-collection-bg-selected-hover: var(--xh-date-range-picker-time-item-bg-hover, var(--xh-bg-subtle));
+    --xh-collection-bg-pressed: var(--xh-date-range-picker-time-item-bg-pressed, var(--xh-bg-subtle-hover));
+    --xh-collection-bg-selected-pressed: var(--xh-date-range-picker-time-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-date-range-picker-time-item-h, var(--xh-control-action-size));
+    font-variant-numeric: tabular-nums;
+    line-height: var(--xh-leading-normal);
+    text-align: center;
+    white-space: nowrap;
+    user-select: none;
+  }
+
+  /* 命中区向上下各补半个列内间距：两格之间那 8px 缝归上下两格各一半，指针落在缝里不落空 */
+  .xh-scope-date-range-picker[data-part='time-item']::before {
+    content: '';
+    position: absolute;
+    inset-block: calc(-0.5 * var(--xh-date-range-picker-time-column-gap, var(--xh-space-2)));
+    inset-inline: 0;
+  }
+
+  .xh-scope-date-range-picker[data-part='time-item'][hidden] {
+    display: none;
+  }
+
+  /* 键盘焦点出现时环才接回并立即到位，不压在背景过渡的中间帧上 */
+  .xh-scope-date-range-picker[data-part='time-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;
+  }
+
+  .xh-scope-date-range-picker[data-part='time-item']::after {
+    content: '';
+    position: absolute;
+    inset-block-start: 50%;
+    /* 标记占轨道末端，内缘与正文之间恒留一档间隙；与 padding 读同一个 rail，避免重叠。 */
+    inset-inline-end: calc(
+      var(--xh-_date-range-picker-time-item-rail) -
+        var(--xh-date-range-picker-time-item-check-size, var(--xh-_date-range-picker-time-item-check-size)) -
+        var(--xh-space-1)
+    );
+    inline-size: var(--xh-date-range-picker-time-item-check-size, var(--xh-_date-range-picker-time-item-check-size));
+    block-size: var(--xh-date-range-picker-time-item-check-size, var(--xh-_date-range-picker-time-item-check-size));
+    translate: 0 -50%;
+    background-color: var(--xh-date-range-picker-time-item-check-fg, var(--xh-_date-range-picker-check-fg));
+    opacity: 0;
+    pointer-events: none;
+    transition: opacity var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+    -webkit-mask: var(--xh-glyph-mark-check) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-check) center / contain no-repeat;
+  }
+
+  .xh-scope-date-range-picker[data-part='time-item'][data-state='checked']::after {
+    opacity: 1;
+  }
+
+  /* 界外、早于同一天的起点与被判为不可用的格走 aria-disabled，家族按它给禁用面；选中标记跟着降级 */
+  .xh-scope-date-range-picker[data-part='time-item'][data-disabled]::after {
+    background-color: var(--xh-fg-disabled);
+  }
+
+  @media not all and (min-width: 768px) {
+    .xh-scope-date-range-picker[data-part='time-column'] {
+      min-inline-size: var(--xh-date-range-picker-time-column-min-w-mobile, var(--xh-overlay-column-min-w));
+    }
+
+    .xh-scope-date-range-picker[data-part='time-item'] {
+      --xh-_date-range-picker-time-item-rail: var(
+        --xh-date-range-picker-time-item-check-size,
+        var(--xh-_date-range-picker-time-item-check-size)
+      );
+    }
+
+    .xh-scope-date-range-picker[data-part='time-item']::after {
+      inset-inline-end: 0;
+    }
+  }
+
+  /* 列整体禁用时格没有自己的 aria-disabled，禁用面按列的 aria-disabled 映射到家族槽：
+     字色降级、悬停 / 高亮 / 按下不换面、光标 not-allowed */
+  .xh-scope-date-range-picker[data-part='time-column'][aria-disabled='true'] [data-part='time-item']:where(.xh-scope-date-range-picker) {
+    --xh-collection-fg-rest: var(--xh-fg-disabled);
+    --xh-collection-fg-hover: var(--xh-fg-disabled);
+    --xh-collection-fg-keyboard-highlight: var(--xh-fg-disabled);
+    --xh-collection-fg-pressed: var(--xh-fg-disabled);
+    --xh-collection-fg-selected: var(--xh-fg-disabled);
+    --xh-collection-bg-hover: transparent;
+    --xh-collection-bg-keyboard-highlight: transparent;
+    --xh-collection-bg-pressed: transparent;
+    --xh-collection-bg-selected-hover: transparent;
+    --xh-collection-bg-selected-highlight: transparent;
+    --xh-collection-bg-selected-pressed: transparent;
+    --xh-collection-cursor-rest: not-allowed;
+    --xh-collection-cursor-hover: not-allowed;
+    --xh-collection-cursor-keyboard-highlight: not-allowed;
+    --xh-collection-cursor-pressed: not-allowed;
+    --xh-collection-cursor-selected: not-allowed;
+  }
+
+  .xh-scope-date-range-picker[data-part='time-column'][aria-disabled='true'] [data-part='time-item']:where(.xh-scope-date-range-picker)::after {
+    background-color: var(--xh-fg-disabled);
+  }
+
+  /* 确认钮是面板里唯一的主要动作：品牌实心、悬停 / 按下换面、焦点环全由 Action Control 的 text solid 档给，
+     xs 档 24 高、字取说明档 12px；槽名统一按部件取 --xh-date-range-picker-confirm-trigger-*，只映射到家族桥接槽 */
+  .xh-scope-date-range-picker[data-part='confirm-trigger'] {
+    --xh-action-visual-size: var(--xh-date-range-picker-confirm-trigger-h, var(--xh-_action-profile-visual-size));
+    --xh-action-padding-inline: var(--xh-date-range-picker-confirm-trigger-px, var(--xh-space-2));
+    --xh-action-radius: var(--xh-date-range-picker-confirm-trigger-radius, var(--xh-shape-control));
+    --xh-action-bg-rest: var(--xh-date-range-picker-confirm-trigger-bg, var(--xh-_action-variant-bg-rest));
+    --xh-action-bg-hover: var(--xh-date-range-picker-confirm-trigger-bg-hover, var(--xh-_action-variant-bg-hover));
+    --xh-action-bg-pressed: var(--xh-date-range-picker-confirm-trigger-bg-active, var(--xh-_action-variant-bg-pressed));
+    --xh-action-fg-rest: var(--xh-date-range-picker-confirm-trigger-fg, var(--xh-_action-variant-fg-rest));
+    --xh-action-fg-hover: var(--xh-date-range-picker-confirm-trigger-fg, var(--xh-_action-variant-fg-hover));
+    --xh-action-fg-pressed: var(--xh-date-range-picker-confirm-trigger-fg, var(--xh-_action-variant-fg-pressed));
+    --xh-action-border-rest: transparent;
+    --xh-action-highlight-rest: transparent;
+    --xh-action-shadow-rest: var(--xh-date-range-picker-confirm-trigger-shadow, none);
+    --xh-action-shadow-hover: var(--xh-date-range-picker-confirm-trigger-shadow, none);
+    --xh-action-shadow-pressed: var(--xh-date-range-picker-confirm-trigger-shadow, none);
+    --xh-action-font-size: var(--xh-date-range-picker-confirm-trigger-font-size, var(--xh-text-caption-size));
+
+    border-width: 0;
+  }
+
+  /* 收起时连接层给的是 hidden 属性；家族那条 display 会把 UA 规则盖掉 */
+  .xh-scope-date-range-picker[data-part='confirm-trigger'][hidden] {
+    display: none;
+  }
+
+  /* 底栏：面板底部通栏的一条操作区，上沿一道 border-default 线与日历、时间组隔开，四周 8 的内衬；
+     面板换行排布（并排两张日历、快捷选项列、起止两组时间列）时独占一整行，落在它们下面。
+     首个子节点落在撑满余宽的那条轨道上，其后的各自按内容宽排在行尾：作者另放的文字与链接排在行首，
+     确认钮总落在行尾；只放了确认钮时它独占那条轨道，靠 justify-self 贴到行尾。
+     底栏不参与撑宽：面板换行排布时，Chrome 把每个子项的固有宽相加当作面板的固有宽，
+     底栏的字与钮会把面板多撑出一截、日历与时间组末端空出一块。inline-size 包含让它的内容不计入固有宽，
+     行内内衬也就不能写在它自己身上（内衬照样计入），改由两端各一个定宽占位让出（见下面那条） */
+  .xh-scope-date-range-picker[data-part='footer'] {
+    /* 两端占位的宽：占位与相邻项之间本来就隔着一道 gap，占位自己只补到内衬的差额 */
+    --xh-_date-range-picker-footer-inset: max(
+      var(--xh-space-0),
+      calc(var(--xh-date-range-picker-footer-px, var(--xh-space-2)) - var(--xh-date-range-picker-footer-gap, var(--xh-space-2)))
+    );
+
+    display: grid;
+    contain: inline-size;
+    flex-basis: 100%;
+    grid-auto-flow: column;
+    grid-template-columns: minmax(0, 1fr);
+    align-items: center;
+    gap: var(--xh-date-range-picker-footer-gap, var(--xh-space-2));
+    padding-block: var(--xh-date-range-picker-footer-py, var(--xh-space-2));
+    border-block-start: var(--xh-stroke-thin) solid var(--xh-date-range-picker-footer-border, var(--xh-material-solid-border));
+    color: var(--xh-date-range-picker-footer-fg, var(--xh-fg-muted));
+    font-size: var(--xh-date-range-picker-footer-font-size, var(--xh-text-caption-size));
+  }
+
+  /* 上面给了 display，UA 的 [hidden]{display:none} 已被盖掉，这里补回来 */
+  .xh-scope-date-range-picker[data-part='footer'][hidden] {
+    display: none;
+  }
+
+  /* 底栏里只放了确认钮、而确认钮按状态收起（没开 showTime）时，底栏一并让位，不留一条空栏 */
+  .xh-scope-date-range-picker[data-part='footer']:has(> .xh-scope-date-range-picker[data-part='confirm-trigger'][hidden]:only-child) {
+    display: none;
+  }
+
+  .xh-scope-date-range-picker[data-part='footer'] > .xh-scope-date-range-picker[data-part='confirm-trigger'] {
+    justify-self: end;
+  }
+
+  /* 行首行尾的内衬由两端的定宽占位让出，不挂在首末子节点上：首个子节点可能是裸文本，
+     末一个可能是按状态收起的确认钮，外边距都接不住。占位与其余子项一样在 inline-size 包含之内，不计入面板的固有宽 */
+  .xh-scope-date-range-picker[data-part='footer']::before,
+  .xh-scope-date-range-picker[data-part='footer']::after {
+    content: '';
+    inline-size: var(--xh-_date-range-picker-footer-inset);
+  }
+
+  /* 行首占位落在那条撑满余宽的显式轨道之前（在它前面长出一条隐式列），首个子节点仍落在那条轨道上。
+     占位不进显式轨道：尺寸包含照样计入显式轨道与轨道间的 gap，多一条显式列面板就多撑出一道 gap */
+  .xh-scope-date-range-picker[data-part='footer']::before {
+    grid-column: span 1 / 1;
+  }
+
+  /* 没写内容就由皮肤画兜底字形；作者往部件里塞了自己的图形，这几条即不命中 */
+  .xh-scope-date-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-date-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-calendar) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-calendar) center / contain no-repeat;
+  }
+
+  @media (forced-colors: active) {
+    /* 整条占位的文字照系统的弱色画；段位让位时的透明字不被强制换色顶回来 */
+    .xh-scope-date-range-picker[data-part='segment-group'][data-placeholder-shown] {
+      forced-color-adjust: none;
+    }
+
+    .xh-scope-date-range-picker[data-part='segment-group'][data-placeholder-shown]::before {
+      color: GrayText;
+    }
+
+    /* 系统接管底色后仍保住末端对号；禁用标记改用系统失效色。 */
+    .xh-scope-date-range-picker[data-part='preset']::after,
+    .xh-scope-date-range-picker[data-part='time-item']::after {
+      forced-color-adjust: none;
+      background-color: CanvasText;
+    }
+
+    /* 按下与没被高亮时的悬停，家族把条目涂成 Highlight，对号跟着换 HighlightText */
+    .xh-scope-date-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-date-range-picker[data-part='time-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-date-range-picker[data-part='preset'][data-disabled]::after,
+    .xh-scope-date-range-picker[data-part='time-item'][data-disabled]::after,
+    .xh-scope-date-range-picker[data-part='time-column'][aria-disabled='true'] [data-part='time-item']:where(.xh-scope-date-range-picker)::after {
+      background-color: GrayText;
+    }
+
+    .xh-scope-date-range-picker[data-part='preset'][data-disabled],
+    .xh-scope-date-range-picker[data-part='time-item'][data-disabled],
+    .xh-scope-date-range-picker[data-part='time-column'][aria-disabled='true'] [data-part='time-item']:where(.xh-scope-date-range-picker) {
+      color: GrayText;
+    }
+  }
+
+  @media (forced-colors: active) {
+    /* 兜底字形是 mask 挖出来的一块底色，这一档里底色被系统换成 Canvas，字形跟着消失。
+       字形退出强制换色、直接写系统色（不能取 currentColor：退出强制换色的伪元素读到的是被系统换掉之前的作者色）：
+       按钮面上取 ButtonText，悬停与按下时家族把按钮涂成 Highlight、字形换 HighlightText；
+       禁用取 GrayText */
+    .xh-scope-date-range-picker:is([data-part='clear-trigger'], [data-part='trigger']):empty::before {
+      forced-color-adjust: none;
+      background-color: ButtonText;
+    }
+
+    .xh-scope-date-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-date-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-date-range-picker[data-part='positioner'] {
+      display: none;
+    }
+  }
+}