@xihan-ui/styles 1.0.0 → 2.0.0

package/css/tour.css

@@ -1,50 +1,15 @@
-@layer xihan.motion {
-  /* 动画名的查找只认「文档里有没有这个名字」：引用别处文件里的名字，那份文件不一定在场，
-     动画会静默地整个不跑。每份皮肤都能单独引入，所以它用到的关键帧都写在自己身上。 */
-  @keyframes xh-fade-in {
-    from {
-      opacity: 0;
-    }
-
-    to {
-      opacity: 1;
-    }
-  }
-
-  @keyframes xh-fade-out {
-    from {
-      opacity: 1;
-    }
+/*
+ * Copyright (c) 2021-Present XiHanFun and contributors.
+ * Licensed under the MIT License. See LICENSE in the project root for license information.
+ */
 
-    to {
-      opacity: 0;
-    }
-  }
+/* 定义 tour 样式。 */
 
-  @keyframes xh-pop-in {
-    from {
-      opacity: 0;
-      scale: var(--xh-motion-scale-enter);
-    }
-
-    to {
-      opacity: 1;
-      scale: 1;
-    }
-  }
-
-  @keyframes xh-pop-out {
-    from {
-      opacity: 1;
-      scale: 1;
-    }
-
-    to {
-      opacity: 0;
-      scale: var(--xh-motion-scale-enter);
-    }
-  }
+/* 共享关键帧由 family/motion.css 提供，本皮肤 @import 它，单独引入仍成立。 */
+@import '../family/motion.css';
+@import '../family/action-control.css';
 
+@layer xihan.motion {
   /* 高亮框落定时那一下呼吸：换步时视线要跟着它走，纯位移太容易被漏看 */
   @keyframes xh-tour-spotlight-in {
     from {
@@ -58,7 +23,7 @@
     }
   }
 
-  /* 退场反向放大淡出，与进场对称 */
+  /* 退场反向放大淡出，幅度比进场浅一档 */
   @keyframes xh-tour-spotlight-out {
     from {
       opacity: 1;
@@ -67,7 +32,7 @@
 
     to {
       opacity: 0;
-      scale: calc(2 - var(--xh-motion-scale-enter));
+      scale: calc(2 - var(--xh-motion-scale-exit));
     }
   }
 }
@@ -81,8 +46,8 @@
   /* 根节点只是几个浮层的归属容器，不参与排版。
      这里不给 display，UA 的 [hidden]{display:none} 就仍然压得住 */
   [data-scope='tour'][data-part='root'] {
-    /* 作者塞进指示符槽的图标跟着字号走，与皮肤画的兜底字形同一把尺 */
-    --xh-icon-size: var(--xh-tour-icon-size, var(--xh-glyph-size-text));
+    /* 作者塞进部件里的图标按控件档取字形尺（md = 20px）；四颗按钮各自再按 sm 档收一档 */
+    --xh-icon-size: var(--xh-tour-icon-size, var(--xh-glyph-size-md));
 
     color: var(--xh-tour-fg, var(--xh-fg-default));
   }
@@ -90,14 +55,14 @@
   /* 浮层被搬到 portal 落点，继承不到 root 上的槽：这把尺在被搬走的那一侧再声明一次，
      关闭钮与条目里作者塞的图标才和皮肤画的兜底字形一样大 */
   [data-scope='tour'][data-part='content'] {
-    --xh-icon-size: var(--xh-tour-icon-size, var(--xh-glyph-size-text));
+    --xh-icon-size: var(--xh-tour-icon-size, var(--xh-glyph-size-md));
   }
 
   /* 遮罩：整页压暗，把注意力逼到高亮框那一块上 */
   [data-scope='tour'][data-part='backdrop'] {
     position: fixed;
     inset: 0;
-    z-index: var(--xh-tour-backdrop-layer, var(--xh-layer-modal));
+    z-index: var(--xh-tour-backdrop-layer, var(--xh-_layer, var(--xh-layer-modal)));
     background: var(--xh-tour-backdrop-bg, var(--xh-bg-overlay));
   }
 
@@ -117,18 +82,29 @@
      这里只管长相：一圈描边 + 一片铺满视口的投影当暗幕，中间那块因此是亮的——
      这就是"洞"。不吃指针：它盖在目标上面，吃了的话目标就再也点不动了 */
   [data-scope='tour'][data-part='spotlight'] {
-    z-index: var(--xh-tour-spotlight-layer, var(--xh-layer-modal));
+    --xh-_tour-spotlight-shroud: transparent;
+    --xh-_tour-spotlight-radius: var(--xh-shape-surface);
+
+    z-index: var(--xh-tour-spotlight-layer, var(--xh-_layer, var(--xh-layer-modal)));
     pointer-events: none;
-    border-radius: var(--xh-tour-spotlight-radius, var(--xh-shape-surface));
+    border-radius: var(
+      --xh-tour-spotlight-radius,
+      var(--xh-_tour-spotlight-radius, var(--xh-shape-surface))
+    );
     box-shadow:
       0 0 0 var(--xh-stroke-thick) var(--xh-tour-spotlight-ring, var(--xh-ring-focus)),
-      0 0 0 100vmax var(--xh-tour-spotlight-shroud, var(--xh-bg-overlay));
+      0 0 0 100vmax var(--xh-_tour-spotlight-shroud);
     /* 换步时框自己滑过去，用户的视线跟得上；逻辑属性照样可过渡 */
     transition:
-      inset-inline-start var(--xh-motion-duration-enter) var(--xh-motion-ease-enter),
-      inset-block-start var(--xh-motion-duration-enter) var(--xh-motion-ease-enter),
-      inline-size var(--xh-motion-duration-enter) var(--xh-motion-ease-enter),
-      block-size var(--xh-motion-duration-enter) var(--xh-motion-ease-enter);
+      inset-inline-start var(--xh-motion-duration-enter) var(--xh-motion-ease-continuous),
+      inset-block-start var(--xh-motion-duration-enter) var(--xh-motion-ease-continuous),
+      inline-size var(--xh-motion-duration-enter) var(--xh-motion-ease-continuous),
+      block-size var(--xh-motion-duration-enter) var(--xh-motion-ease-continuous),
+      border-radius var(--xh-motion-duration-enter) var(--xh-motion-ease-continuous);
+  }
+
+  [data-scope='tour'][data-part='spotlight'][data-dimmed] {
+    --xh-_tour-spotlight-shroud: var(--xh-tour-spotlight-shroud, var(--xh-bg-overlay));
   }
 
   [data-scope='tour'][data-part='spotlight'][hidden] {
@@ -136,7 +112,7 @@
   }
 
   [data-scope='tour'][data-part='spotlight'][data-state='open'] {
-    animation: xh-tour-spotlight-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter);
+    animation: xh-tour-spotlight-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter-strong);
   }
 
   /* 退场与气泡并行播，同一段时长；收起那一帧 hidden 由宿主押后到气泡的退场结束 */
@@ -144,13 +120,9 @@
     animation: xh-tour-spotlight-out var(--xh-motion-duration-exit) var(--xh-motion-ease-exit) forwards;
   }
 
-  /* 高亮框在场时遮罩让位：暗幕已经由那圈铺满视口的投影负责，
-     两层叠加会把页面压得过暗，而且洞里也会跟着变暗——洞就白挖了。
-     居中步的高亮框带 hidden，此时遮罩照常压暗（那一步本来就没有要突出的元素）。
-     两条兄弟选择器各管一个方向，谁写在前面都算数：遮罩与高亮框同为浮层落点里的兄弟，
-     不再共有 root 这个祖先 */
-  [data-scope='tour'][data-part='backdrop']:has(~ [data-scope='tour'][data-part='spotlight']:not([hidden])),
-  [data-scope='tour'][data-part='spotlight']:not([hidden]) ~ [data-scope='tour'][data-part='backdrop'] {
+  /* 锚定步的暗幕由 Spotlight 自己挖洞，Backdrop 只负责拦截背景交互。状态直接由连接层给，
+     不依赖两个 Portal shell 在落点里的相对顺序。 */
+  [data-scope='tour'][data-part='backdrop'][data-position='anchored'] {
     background: transparent;
   }
 
@@ -160,8 +132,11 @@
     /* 落定那一侧的可用高度，由定位引擎经内联自定义属性写进来，气泡继承它限高；
        居中步与尚未落位时不额外限高 */
     --xh-_tour-available-h: 100vh;
+    /* 落定那一侧的可用宽度，同样由定位引擎经内联自定义属性写进来，行内轴据此夹取；
+       引擎没算（尚未落位 / 无引擎 / 贴边归零）时退到视口宽 */
+    --xh-_tour-available-w: 100vw;
 
-    z-index: var(--xh-tour-positioner-layer, var(--xh-layer-popover));
+    z-index: var(--xh-tour-positioner-layer, var(--xh-_layer, var(--xh-layer-popover)));
     pointer-events: none;
   }
 
@@ -180,36 +155,64 @@
     display: none;
   }
 
+  /* 缩放原点与进场位移按落定的那一侧给：气泡从贴着锚点的那条边涨开、沿主轴退让一小段。
+     两个槽由 content 继承。只认锚定步：居中步没有锚点，data-placement 仍带着缺省值。
+     placement 是物理方向（引擎按 top / right / bottom / left 出值），origin 与 translate
+     也是物理量，两边同轴，不随书写方向翻 */
+  [data-scope='tour'][data-part='positioner'][data-position='anchored'][data-placement^='top'] {
+    --xh-_overlay-origin-y: 100%;
+    --xh-_overlay-enter-down: 1;
+  }
+
+  [data-scope='tour'][data-part='positioner'][data-position='anchored'][data-placement^='bottom'] {
+    --xh-_overlay-origin-y: 0;
+    --xh-_overlay-enter-up: 1;
+  }
+
+  [data-scope='tour'][data-part='positioner'][data-position='anchored'][data-placement^='left'] {
+    --xh-_overlay-origin-x: 100%;
+    --xh-_overlay-enter-right: 1;
+  }
+
+  [data-scope='tour'][data-part='positioner'][data-position='anchored'][data-placement^='right'] {
+    --xh-_overlay-origin-x: 0;
+    --xh-_overlay-enter-left: 1;
+  }
+
   [data-scope='tour'][data-part='content'] {
     position: relative;
     display: flex;
     flex-direction: column;
     gap: var(--xh-tour-gap, var(--xh-space-2));
     inline-size: max-content;
-    max-inline-size: var(--xh-tour-max-w, var(--xh-overlay-max-w-lg));
+    /* 静态档与落位后的可用宽度取小：窄视口下面板伸出去，最右侧的内容就点不到了 */
+    max-inline-size: min(var(--xh-tour-max-w, var(--xh-overlay-max-w-lg)), var(--xh-_tour-available-w));
     padding-block: var(--xh-tour-py, var(--xh-surface-py-md));
     padding-inline: var(--xh-tour-px, var(--xh-surface-px-md));
     /* 引导步骤的正文长度由作者定，矮视口下不限高气泡会整块伸出视口 */
     max-block-size: min(var(--xh-tour-max-h, var(--xh-overlay-max-h)), var(--xh-_tour-available-h));
-    border: var(--xh-stroke-thin) solid var(--xh-tour-border, var(--xh-border-default));
-    border-radius: var(--xh-tour-radius, var(--xh-shape-surface));
-    background: var(--xh-tour-bg, var(--xh-bg-surface));
-    color: var(--xh-tour-fg, var(--xh-fg-default));
-    box-shadow: var(--xh-tour-shadow, var(--xh-elevation-sheet));
+    /* M4 sheet 三件套（§8.4），与 dialog 同源：1px 描边是它的边界，不透明底，影只是加成 */
+    border: var(--xh-stroke-thin) solid var(--xh-tour-border, var(--xh-material-elevated-border));
+    border-radius: var(--xh-tour-radius, var(--xh-shape-overlay));
+    background: var(--xh-tour-bg, var(--xh-material-elevated-bg));
+    color: var(--xh-tour-fg, var(--xh-material-elevated-fg));
+    box-shadow: var(--xh-tour-shadow, var(--xh-material-elevated-shadow));
     pointer-events: auto;
+    /* 进退场的缩放锚在贴着锚点的那条边上；两个分量由 positioner 按 placement 写进私有槽 */
+    transform-origin: var(--xh-_overlay-origin-x, 50%) var(--xh-_overlay-origin-y, 50%);
   }
 
   /* 这里刻意没有 [data-part='content'][hidden] { display: none }，与 popover 一致：
      收起态连接层会给 content 打 hidden，补上这条退场动画就一帧都播不出来。
      真正的收起由退场闸门落成内联 display，节点始终留在原地。 */
 
-  /* 焦点落在气泡本身（Enter/Space 归"下一步"管），但它是纯容器，不画焦点环 */
-  [data-scope='tour'][data-part='content']:focus-visible {
-    outline: none;
-  }
+  /* 焦点落在气泡本身，Enter / Space 落在它身上推进下一步：它是可操作目标，
+     环由 focus.css 的默认内收环画，这里不另写 */
 
   [data-scope='tour'][data-part='content'][data-state='open'] {
-    animation: xh-pop-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter);
+    animation: xh-overlay-pop-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter-strong);
+    /* 只在开着的这一档挂：合成层随 data-state 一起收走，收起后不再占着 */
+    will-change: opacity, scale, translate;
   }
 
   /* 退场：收起那一帧 hidden 由退场闸门押后，这里才播得出来。forwards 把末态钉住，
@@ -229,13 +232,14 @@
      否则长标题会直接钻到按钮底下。只在真有关闭按钮时让位。 */
   [data-scope='tour'][data-part='content']:has([data-scope='tour'][data-part='close-trigger'])
     [data-scope='tour'][data-part='title'] {
-    padding-inline-end: calc(var(--xh-tour-close-size, var(--xh-control-h-sm)) + var(--xh-space-2));
+    padding-inline-end: calc(var(--xh-tour-close-size, var(--xh-control-h-sm)) + var(--xh-surface-action-inset));
   }
 
+  /* 说明文字走说明档（§6.4）：13px + fg-muted */
   [data-scope='tour'][data-part='description'] {
     margin: 0;
-    font-size: var(--xh-text-body-size);
-    line-height: var(--xh-text-body-leading);
+    font-size: var(--xh-text-secondary-size);
+    line-height: var(--xh-leading-normal);
     color: var(--xh-tour-description-fg, var(--xh-fg-muted));
   }
 
@@ -245,100 +249,107 @@
     color: var(--xh-tour-progress-fg, var(--xh-fg-subtle));
   }
 
-  [data-scope='tour'][data-part='prev-trigger'],
-  [data-scope='tour'][data-part='next-trigger'],
-  [data-scope='tour'][data-part='skip-trigger'] {
+  /* 圆点组：一步一颗，横排 */
+  [data-scope='tour'][data-part='progress-indicator'] {
     display: inline-flex;
     align-items: center;
-    justify-content: center;
-    block-size: var(--xh-control-h-sm);
-    padding-inline: var(--xh-tour-skip-trigger-px, var(--xh-control-px-md));
-    border: var(--xh-stroke-thin) solid transparent;
-    border-radius: var(--xh-tour-action-radius, var(--xh-shape-control));
-    font-size: var(--xh-text-secondary-size);
-    cursor: pointer;
+    gap: var(--xh-tour-progress-indicator-gap, var(--xh-space-1));
   }
 
-  [data-scope='tour'][data-part='prev-trigger'][hidden],
-  [data-scope='tour'][data-part='next-trigger'][hidden],
-  [data-scope='tour'][data-part='skip-trigger'][hidden] {
+  [data-scope='tour'][data-part='progress-indicator'][hidden] {
     display: none;
   }
 
-  /* 主按钮：整条引导的主线动作 */
-  [data-scope='tour'][data-part='next-trigger'] {
-    background: var(--xh-tour-next-bg, var(--xh-bg-brand));
-    color: var(--xh-tour-next-fg, var(--xh-fg-on-brand));
+  /* 圆点：8px 正圆取 circle（§6.3 分页点统一款），未走到的一档取中性描边色。
+     宽度与底色都随状态换，换步那一下能看出进度在推进 */
+  [data-scope='tour'][data-part='progress-dot'] {
+    inline-size: var(--xh-space-2);
+    block-size: var(--xh-space-2);
+    border-radius: var(--xh-shape-circle);
+    background: var(--xh-tour-progress-dot-bg, var(--xh-border-default));
+    transition:
+      inline-size var(--xh-motion-duration-micro) var(--xh-motion-ease-continuous),
+      background-color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
   }
 
-  [data-scope='tour'][data-part='next-trigger']:hover {
-    background: var(--xh-tour-next-bg-hover, var(--xh-bg-brand-hover));
+  /* 走过的步：中性色加重一档 */
+  [data-scope='tour'][data-part='progress-dot'][data-complete] {
+    background: var(--xh-tour-progress-dot-bg-complete, var(--xh-border-strong));
   }
 
-  [data-scope='tour'][data-part='prev-trigger'],
-  [data-scope='tour'][data-part='skip-trigger'] {
-    background: transparent;
-    color: var(--xh-fg-muted);
+  /* 当前步：拉成 20px 胶囊并换品牌色；一维对象取 pill */
+  [data-scope='tour'][data-part='progress-dot'][data-current] {
+    inline-size: var(--xh-space-5);
+    border-radius: var(--xh-shape-pill);
+    background: var(--xh-tour-progress-dot-bg-current, var(--xh-bg-brand));
   }
 
-  [data-scope='tour'][data-part='prev-trigger'] {
-    border-color: var(--xh-border-control);
-    color: var(--xh-fg-default);
-  }
-
-  [data-scope='tour'][data-part='prev-trigger']:hover:not(:disabled),
-  [data-scope='tour'][data-part='skip-trigger']:hover {
-    background: var(--xh-bg-subtle);
+  /*
+   * —— 末行三颗按钮 ——
+   * 上一步 / 下一步 / 跳过都是气泡末行的文字按钮（§9.1）：盒型、sm 档几何、四态面、0.97 按压并换底、粗指针命中区与
+   * 强制色由家族配方按连接层投影的 data-xh-action-variant / -size 给出。这里只把公开槽桥接到矩阵之前
+   * （使用者槽 → 形态矩阵 → 家族缺省）与几何映射；内衬与圆角槽三颗共用。
+   */
+  [data-scope='tour'][data-part='prev-trigger'],
+  [data-scope='tour'][data-part='next-trigger'],
+  [data-scope='tour'][data-part='skip-trigger'] {
+    --xh-action-padding-inline: var(--xh-tour-skip-trigger-px, var(--xh-_action-profile-padding-inline));
+    --xh-action-radius: var(--xh-tour-action-radius, var(--xh-shape-control));
+    /* 作者塞进按钮的图标随档取字形尺（sm = 16px） */
+    --xh-icon-size: var(--xh-tour-icon-size, var(--xh-_action-profile-glyph-size));
   }
 
-  /* 单体控件用原生 disabled（集合条目才用 [data-disabled]）：首步的上一步就是这个形态 */
-  [data-scope='tour'][data-part='prev-trigger']:disabled {
-    color: var(--xh-fg-disabled);
-    border-color: var(--xh-border-subtle);
-    cursor: not-allowed;
+  [data-scope='tour'][data-part='prev-trigger'][hidden],
+  [data-scope='tour'][data-part='next-trigger'][hidden],
+  [data-scope='tour'][data-part='skip-trigger'][hidden] {
+    display: none;
   }
 
+  /* 下一步是整条引导的主线动作，显式 solid（§7.2 第 2 条）：底、字与影三组使用者槽桥到配方 solid 列之前 */
+  [data-scope='tour'][data-part='next-trigger'] {
+    --xh-action-bg-rest: var(--xh-tour-next-bg, var(--xh-_action-variant-bg-rest));
+    --xh-action-bg-hover: var(--xh-tour-next-bg-hover, var(--xh-_action-variant-bg-hover));
+    --xh-action-bg-focus-visible: var(--xh-tour-next-bg, var(--xh-_action-variant-bg-focus-visible));
+    --xh-action-fg-rest: var(--xh-tour-next-fg, var(--xh-_action-variant-fg-rest));
+    --xh-action-fg-hover: var(--xh-tour-next-fg, var(--xh-_action-variant-fg-hover));
+    --xh-action-fg-pressed: var(--xh-tour-next-fg, var(--xh-_action-variant-fg-pressed));
+    --xh-action-fg-focus-visible: var(--xh-tour-next-fg, var(--xh-_action-variant-fg-focus-visible));
+    --xh-action-shadow-rest: var(--xh-tour-next-shadow, none);
+  }
+
+  /* 面是实心的，环色与面同族，画在面里就看不出来；环改取面自己的前景色——
+     那一族色本来就要在这块面上把字读清楚，与面的对比是按可读性定的 */
+  [data-scope='tour'][data-part='next-trigger'][data-xh-action-variant='solid']:focus-visible {
+    --xh-action-ring-color-focus-visible: currentColor;
+  }
+
+  /*
+   * 关闭钮是气泡角落的单图标钮（§9.1）：正方盒、sm 档几何、ghost 四态面、0.97 按压并换底与粗指针命中区
+   * 由家族配方给出——白面上走画布承载阶梯悬停 --xh-bg-subtle（100）→ 按下 --xh-bg-subtle-hover（200），
+   * 焦点面透明吃库环。这里只把公开槽桥接到矩阵之前（使用者槽 → 形态矩阵 → 家族缺省）与摆放；
+   * 静息前景取 muted 字色，悬停 / 按下 / 聚焦回到 fg-default。
+   */
   [data-scope='tour'][data-part='close-trigger'] {
+    --xh-action-visual-size: var(--xh-tour-close-size, var(--xh-_action-profile-visual-size));
+    --xh-action-radius: var(--xh-tour-close-radius, var(--xh-shape-control));
+    --xh-action-bg-hover: var(--xh-tour-close-bg-hover, var(--xh-_action-variant-bg-hover));
+    --xh-action-bg-pressed: var(--xh-tour-close-bg-active, var(--xh-_action-variant-bg-pressed));
+    --xh-action-fg-rest: var(--xh-tour-close-fg, var(--xh-fg-muted));
+    --xh-action-fg-hover: var(--xh-tour-close-fg-hover, var(--xh-_action-variant-fg-hover));
+    --xh-action-fg-pressed: var(--xh-tour-close-fg-hover, var(--xh-_action-variant-fg-pressed));
+    --xh-action-fg-focus-visible: var(--xh-tour-close-fg-hover, var(--xh-_action-variant-fg-focus-visible));
+    /* 作者塞进按钮的图标随档取字形尺（sm = 16px），与皮肤画的兜底字形同一把尺 */
+    --xh-icon-size: var(--xh-tour-icon-size, var(--xh-_action-profile-glyph-size));
+
     position: absolute;
-    inset-block-start: var(--xh-space-2);
-    inset-inline-end: var(--xh-space-2);
-    display: inline-flex;
-    align-items: center;
-    justify-content: center;
-    block-size: var(--xh-tour-close-size, var(--xh-control-h-sm));
-    inline-size: var(--xh-tour-close-size, var(--xh-control-h-sm));
-    border: 0;
-    border-radius: var(--xh-tour-close-radius, var(--xh-shape-control));
-    background: transparent;
-    color: var(--xh-fg-muted);
-    cursor: pointer;
-    transition:
-      background-color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter),
-      scale var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+    inset-block-start: var(--xh-surface-action-inset);
+    inset-inline-end: var(--xh-surface-action-inset);
   }
 
   [data-scope='tour'][data-part='close-trigger'][hidden] {
     display: none;
   }
 
-  [data-scope='tour'][data-part='close-trigger']:hover {
-    background: var(--xh-tour-close-bg-hover, var(--xh-bg-subtle-hover));
-    color: var(--xh-fg-default);
-  }
-
-  [data-scope='tour'][data-part='close-trigger']:active {
-    background: var(--xh-tour-close-bg-active, var(--xh-bg-subtle-active));
-    scale: var(--xh-motion-scale-press);
-  }
-
-  [data-scope='tour'][data-part='prev-trigger']:focus-visible,
-  [data-scope='tour'][data-part='next-trigger']:focus-visible,
-  [data-scope='tour'][data-part='skip-trigger']:focus-visible,
-  [data-scope='tour'][data-part='close-trigger']:focus-visible {
-    outline: var(--xh-ring-width) solid var(--xh-ring-focus);
-    outline-offset: var(--xh-ring-offset);
-  }
-
   /* 箭头的底色与描边色，几何在 overlay-arrow.css。
      交叉轴落点由定位引擎经内联自定义属性写进来，没给时退回居中 */
   [data-scope='tour'][data-part='arrow'] {
@@ -348,8 +359,8 @@
     --xh-_overlay-arrow-x: var(--xh-_tour-arrow-x);
     --xh-_overlay-arrow-y: var(--xh-_tour-arrow-y);
 
-    background: var(--xh-tour-bg, var(--xh-bg-surface));
-    border: var(--xh-stroke-thin) solid var(--xh-tour-border, var(--xh-border-default));
+    background: var(--xh-tour-bg, var(--xh-material-elevated-bg));
+    border: var(--xh-stroke-thin) solid var(--xh-tour-border, var(--xh-material-elevated-border));
   }
 
   /* 居中步没有锚点，连接层会给箭头发 hidden */
@@ -371,10 +382,30 @@
 }
 
 @layer xihan.components {
-  /* 气泡限高之后只让正文让步：标题与上下步按钮滚出视线就点不到了 */
+  /* 气泡限高之后只让正文让步：标题与上下步按钮滚出视线就点不到了。
+     模态气泡里的原生细条滚动面（§6.6）：细条由 reset 层统一给，滚到头不把页面一起带走；内容高度不动态变化，不写 gutter */
   [data-scope='tour'][data-part='description'] {
     flex: 1 1 auto;
     min-block-size: 0;
     overflow-y: auto;
+    overscroll-behavior: contain;
+  }
+
+  @media (forced-colors: active) {
+    /* 这一档丢掉底色：走过的那几颗改由一圈描边表出，当前那颗仍靠宽度分辨 */
+    [data-scope='tour'][data-part='progress-dot'][data-complete] {
+      outline: var(--xh-stroke-thin) solid CanvasText;
+    }
+  }
+
+  @media print {
+    /* 打印：定位层与遮罩是交互期才存在的东西，落到纸上只会盖住底下的正文。
+       收起写在这份皮肤里而不是 reset：reset 层排在组件层之前，组件层里任何一条 display 都压得住它。
+       居中那一档的选择器多带一个属性、权重高一级，所以把它一并列出来，靠同权重下的书写顺序压回去。 */
+    [data-scope='tour'][data-part='backdrop'],
+    [data-scope='tour'][data-part='positioner'],
+    [data-scope='tour'][data-part='positioner'][data-position='center'] {
+      display: none;
+    }
   }
 }