@xihan-ui/styles 3.1.0 → 4.0.0

package/dist/css/question-flow.css

@@ -0,0 +1,579 @@
+/*
+ * Copyright (c) 2021-Present XiHanFun and contributors.
+ * Licensed under the MIT License. See LICENSE in the project root for license information.
+ */
+
+/* 定义 question flow 样式。 */
+
+/* 共享关键帧由 family/motion.css 提供，本皮肤 @import 它，单独引入仍成立；
+   独立皮肤同时传递引入选项行与四颗钮的动作控件配方，full bundle 递归去重。 */
+@import '../family/motion.css';
+@import '../family/action-control.css';
+@import '../family/check-mark.css';
+
+@layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  .xh-scope-question-flow {
+    --xh-question-flow-skin: 1;
+  }
+
+  /* 一张静态内容面：--xh-border-default 描边 + surface 底 + 无影（边界只由描边承担）。
+     三个视觉轴都落在 root 上：形态管底与描边怎么画，语气管用哪族颜色，尺寸管内衬、按钮高度与字号 */
+  .xh-scope-question-flow[data-part='root'] {
+    /* 作者塞进翻页钮的图标按档取尺，与皮肤画的兜底字形同一把尺 */
+    --xh-icon-size: var(--xh-question-flow-icon-size, var(--xh-glyph-size-md));
+    /* 尺寸缺省档：不写 data-size 时按中档走 */
+    --xh-_question-flow-p: var(--xh-space-4);
+    --xh-_question-flow-gap: var(--xh-space-3);
+    --xh-_question-flow-h: var(--xh-control-h-md);
+    --xh-_question-flow-px: var(--xh-control-px-md);
+    --xh-_question-flow-font-size: var(--xh-control-font-md);
+    --xh-_question-flow-indicator: var(--xh-control-indicator-md);
+
+    display: flex;
+    flex-direction: column;
+    gap: var(--xh-question-flow-gap, var(--xh-_question-flow-gap));
+    padding: var(--xh-question-flow-padding, var(--xh-_question-flow-p));
+    border: var(--xh-stroke-thin) solid var(--xh-question-flow-border, var(--xh-border-default));
+    border-radius: var(--xh-question-flow-radius, var(--xh-shape-surface));
+    background: var(--xh-question-flow-bg, var(--xh-bg-surface));
+    box-shadow: var(--xh-question-flow-shadow, none);
+  }
+
+  /* 卡片出现时滑入；落在首帧就在的列表条目里（历史消息）时直接呈现，不跟着整屏一起入场 */
+  .xh-scope-question-flow[data-part='root']:not([data-scope][data-part='item'][data-instant] :where(.xh-scope-question-flow)) {
+    animation: xh-item-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter-strong);
+  }
+
+  /* 上面声明的 display 会盖掉 UA 的 [hidden]{display:none}，这里补回 */
+  .xh-scope-question-flow[data-part='root'][hidden] {
+    display: none;
+  }
+
+  /* —— 形态 —— */
+  /* 描边式是缺省档，写在上面那条基础规则里 */
+  /* 填充式：底色顶替描边表达边界。描边只退成透明而不去掉，
+     1px 的位置留着，与 outline 档并排时基线对得上；
+     淡底承载面向选项行与几颗中性钮下发 hover 200 → pressed 300 */
+  .xh-scope-question-flow[data-part='root'][data-variant='subtle'] {
+    --xh-action-host-bg-hover: var(--xh-bg-subtle-hover);
+    --xh-action-host-bg-pressed: var(--xh-bg-subtle-active);
+
+    border-color: transparent;
+    background: var(--xh-question-flow-bg, var(--xh-_tone-subtle, var(--xh-bg-subtle)));
+  }
+
+  /* 无壳：底与描边都透明，影一并收掉——底都不画了，一圈投影就成了没有来处的暗边 */
+  .xh-scope-question-flow[data-part='root'][data-variant='ghost'] {
+    border-color: transparent;
+    background: transparent;
+    box-shadow: none;
+  }
+
+  /* —— 尺寸 —— */
+  .xh-scope-question-flow[data-part='root'][data-size='sm'] {
+    --xh-_question-flow-p: var(--xh-space-3);
+    --xh-_question-flow-gap: var(--xh-space-2);
+    --xh-_question-flow-h: var(--xh-control-h-sm);
+    --xh-_question-flow-px: var(--xh-control-px-sm);
+    --xh-_question-flow-font-size: var(--xh-control-font-sm);
+    --xh-_question-flow-indicator: var(--xh-control-indicator-sm);
+    --xh-icon-size: var(--xh-question-flow-icon-size, var(--xh-glyph-size-sm));
+  }
+
+  .xh-scope-question-flow[data-part='root'][data-size='md'] {
+    --xh-_question-flow-p: var(--xh-space-4);
+    --xh-_question-flow-gap: var(--xh-space-3);
+    --xh-_question-flow-h: var(--xh-control-h-md);
+    --xh-_question-flow-px: var(--xh-control-px-md);
+    --xh-_question-flow-font-size: var(--xh-control-font-md);
+    --xh-_question-flow-indicator: var(--xh-control-indicator-md);
+    --xh-icon-size: var(--xh-question-flow-icon-size, var(--xh-glyph-size-md));
+  }
+
+  .xh-scope-question-flow[data-part='root'][data-size='lg'] {
+    --xh-_question-flow-p: var(--xh-space-5);
+    --xh-_question-flow-gap: var(--xh-space-4);
+    --xh-_question-flow-h: var(--xh-control-h-lg);
+    --xh-_question-flow-px: var(--xh-control-px-lg);
+    --xh-_question-flow-font-size: var(--xh-control-font-lg);
+    --xh-_question-flow-indicator: var(--xh-control-indicator-lg);
+    --xh-icon-size: var(--xh-question-flow-icon-size, var(--xh-glyph-size-lg));
+  }
+
+  /* 视口定高并裁切：高度由机器量出来写进私有槽，量到之前按内容撑开。
+     换题时高度过渡到新那一题，卡片跟着长高或收矮 */
+  .xh-scope-question-flow[data-part='viewport'] {
+    --xh-_question-flow-viewport-h: auto;
+
+    display: block;
+    overflow: hidden;
+    block-size: var(--xh-question-flow-viewport-h, var(--xh-_question-flow-viewport-h));
+    transition: block-size var(--xh-motion-duration-move) var(--xh-motion-ease-continuous);
+  }
+
+  .xh-scope-question-flow[data-part='viewport'][hidden] {
+    display: none;
+  }
+
+  /* 轨道把全部题目纵向排开，靠位移把当前题推进视口 */
+  .xh-scope-question-flow[data-part='track'] {
+    --xh-_question-flow-track-y: 0;
+
+    display: flex;
+    flex-direction: column;
+    gap: var(--xh-question-flow-track-gap, var(--xh-_question-flow-gap));
+    translate: 0 var(--xh-question-flow-track-y, var(--xh-_question-flow-track-y));
+    transition: translate var(--xh-motion-duration-move) var(--xh-motion-ease-continuous);
+  }
+
+  .xh-scope-question-flow[data-part='track'][hidden] {
+    display: none;
+  }
+
+  /* 一题的整块。非当前题淡出并让开指针：它仍留在轨道上，高度才有得可量 */
+  .xh-scope-question-flow[data-part='question'] {
+    display: flex;
+    flex-direction: column;
+    gap: var(--xh-question-flow-question-gap, var(--xh-space-2));
+    opacity: 0;
+    pointer-events: none;
+    transition: opacity var(--xh-motion-duration-enter) var(--xh-motion-ease-enter-strong);
+  }
+
+  .xh-scope-question-flow[data-part='question'][hidden] {
+    display: none;
+  }
+
+  .xh-scope-question-flow[data-part='question'][data-current] {
+    opacity: 1;
+    pointer-events: auto;
+  }
+
+  /* 题干就是这一题的标题，也是选项组的可访问名：走 Surface 标题档 14/600 */
+  .xh-scope-question-flow[data-part='prompt'] {
+    display: block;
+    margin: 0;
+    color: var(--xh-question-flow-prompt-fg, var(--xh-fg-default));
+    font-size: var(--xh-question-flow-prompt-font-size, var(--xh-text-label-size));
+    font-weight: var(--xh-question-flow-prompt-font-weight, var(--xh-font-weight-semibold));
+    line-height: var(--xh-leading-tight);
+  }
+
+  .xh-scope-question-flow[data-part='prompt'][hidden] {
+    display: none;
+  }
+
+  .xh-scope-question-flow[data-part='group'] {
+    display: flex;
+    flex-direction: column;
+    gap: var(--xh-question-flow-group-gap, var(--xh-space-1));
+  }
+
+  .xh-scope-question-flow[data-part='group'][hidden] {
+    display: none;
+  }
+
+  /* 一个选项：整行可点、可聚焦，记号在左。盒型、悬停 / 按下 / 禁用面由 Action Control 的 row 档给
+     （ghost 形态：白底承载 hover 100 → pressed 200，按下只换面不缩放；禁用守卫认 data-disabled），
+     这里只把使用者槽映射到桥接槽，内衬与间距沿用本组件的档位；字色三态同一支，选中档在下面换一档。
+     行高不吃家族的单行档：row 档允许换行、高度随内容，一条会折行的选项文案走正文行高 */
+  .xh-scope-question-flow[data-part='item'] {
+    --xh-action-gap: var(--xh-question-flow-item-gap, var(--xh-space-1_5));
+    --xh-action-padding-inline: var(--xh-question-flow-item-px, var(--xh-space-2));
+    --xh-action-padding-block: var(--xh-question-flow-item-py, var(--xh-space-1));
+    --xh-action-radius: var(--xh-question-flow-item-radius, var(--xh-_action-profile-radius));
+    --xh-action-font-size: var(--xh-question-flow-item-font-size, var(--xh-_question-flow-font-size));
+    --xh-action-bg-rest: var(--xh-question-flow-item-bg, var(--xh-_action-variant-bg-rest));
+    --xh-action-bg-hover: var(--xh-question-flow-item-bg-hover, var(--xh-_action-variant-bg-hover));
+    --xh-action-fg-rest: var(--xh-question-flow-item-fg, var(--xh-fg-muted));
+    --xh-action-fg-hover: var(--xh-question-flow-item-fg, var(--xh-fg-muted));
+    --xh-action-fg-pressed: var(--xh-question-flow-item-fg, var(--xh-fg-muted));
+
+    line-height: var(--xh-leading-normal);
+  }
+
+  .xh-scope-question-flow[data-part='item'][hidden] {
+    display: none;
+  }
+
+  /* 当前题的选项按位次错开开幕，换题时随 data-current 重跑：一道题的选项总是同一批一起露面，
+     位次就是到达顺序。落在首帧就在的列表条目里（历史消息）时直接呈现。
+     backwards 不能省：等待期间起帧不生效的话，后面几条会先露一下再跳回去。
+     第 6 条起并到同一拍上 */
+  .xh-scope-question-flow[data-part='question'][data-current] [data-part='item']:where(.xh-scope-question-flow):not([data-scope][data-part='item'][data-instant] :where(.xh-scope-question-flow)) {
+    animation: xh-rise-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter-strong) backwards;
+  }
+
+  .xh-scope-question-flow[data-part='question'][data-current] [data-part='item']:where(.xh-scope-question-flow):nth-child(2):not([data-scope][data-part='item'][data-instant] :where(.xh-scope-question-flow)) {
+    animation-delay: calc(var(--xh-motion-stagger-step) * 1);
+  }
+
+  .xh-scope-question-flow[data-part='question'][data-current] [data-part='item']:where(.xh-scope-question-flow):nth-child(3):not([data-scope][data-part='item'][data-instant] :where(.xh-scope-question-flow)) {
+    animation-delay: calc(var(--xh-motion-stagger-step) * 2);
+  }
+
+  .xh-scope-question-flow[data-part='question'][data-current] [data-part='item']:where(.xh-scope-question-flow):nth-child(4):not([data-scope][data-part='item'][data-instant] :where(.xh-scope-question-flow)) {
+    animation-delay: calc(var(--xh-motion-stagger-step) * 3);
+  }
+
+  .xh-scope-question-flow[data-part='question'][data-current] [data-part='item']:where(.xh-scope-question-flow):nth-child(5):not([data-scope][data-part='item'][data-instant] :where(.xh-scope-question-flow)) {
+    animation-delay: calc(var(--xh-motion-stagger-step) * 4);
+  }
+
+  .xh-scope-question-flow[data-part='question'][data-current] [data-part='item']:where(.xh-scope-question-flow):nth-child(n + 6):not([data-scope][data-part='item'][data-instant] :where(.xh-scope-question-flow)) {
+    animation-delay: calc(var(--xh-motion-stagger-step) * 5);
+  }
+
+  /* 选中的那条读起来更重一档（禁用项无论选没选都是家族给的禁用色） */
+  .xh-scope-question-flow[data-part='item'][data-state='checked'] {
+    --xh-action-fg-rest: var(--xh-question-flow-item-fg-checked, var(--xh-fg-default));
+    --xh-action-fg-hover: var(--xh-question-flow-item-fg-checked, var(--xh-fg-default));
+    --xh-action-fg-pressed: var(--xh-question-flow-item-fg-checked, var(--xh-fg-default));
+  }
+
+  /* 记号盒：多选是圆角方格，单选是圆。选中态填色，纯装饰不进可访问名 */
+  .xh-scope-question-flow[data-part='item-indicator'] {
+    /* 盒里那枚记号按盒比例量（与 Checkbox 同一比例），作者塞进来的图标读同一把尺。
+       根上那把是展示型图标档，比指示符盒还大一档，画进这个盒里会溢出四个像素 */
+    --xh-_question-flow-indicator-glyph: calc(var(--xh-question-flow-indicator-size, var(--xh-_question-flow-indicator)) * 0.75);
+    --xh-icon-size: var(--xh-question-flow-indicator-icon-size, var(--xh-_question-flow-indicator-glyph));
+
+    display: inline-flex;
+    flex: none;
+    align-items: center;
+    justify-content: center;
+    border: var(--xh-stroke-thin) solid var(--xh-question-flow-indicator-border, var(--xh-border-strong));
+    border-radius: var(--xh-question-flow-indicator-radius, var(--xh-shape-inset));
+    background: var(--xh-question-flow-indicator-bg, transparent);
+    color: var(--xh-question-flow-indicator-fg, var(--xh-_tone-on, var(--xh-fg-on-brand)));
+    inline-size: var(--xh-question-flow-indicator-size, var(--xh-_question-flow-indicator));
+    block-size: var(--xh-question-flow-indicator-size, var(--xh-_question-flow-indicator));
+    transition:
+      background-color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter),
+      border-color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter),
+      color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+  }
+
+  .xh-scope-question-flow[data-part='item-indicator'][hidden] {
+    display: none;
+  }
+
+  /* 单选那一档把方格收成圆：正方盒取 circle */
+  .xh-scope-question-flow[data-part='item-indicator'][data-select-mode='single'] {
+    border-radius: var(--xh-question-flow-indicator-radius-single, var(--xh-shape-circle));
+  }
+
+  /* 多选的记号是勾选格：没写内容时勾由勾选标记配方画在 ::before 上，常驻、按状态淡变并轻缩放；
+     作者往部件里塞了自己的图形，配方与下面的圆点都不画。
+     单选那一档画实心点，由伪元素自己的底色画；直径按记号盒的一半量，与其余单选控件的圆点同源——
+     盒换档时点跟着换。圆点与 RadioGroup 同一套动效：没选中时缩放为 0（盒留在原位，翻面时整行不跳），
+     选中时落位略涨过 1 再收回、收起走强减速不过冲，换色走 micro */
+  .xh-scope-question-flow[data-part='item-indicator'][data-select-mode='single']:empty::before {
+    content: '';
+    display: inline-block;
+    inline-size: var(--xh-question-flow-dot-size, calc(var(--xh-question-flow-indicator-size, var(--xh-_question-flow-indicator)) / 2));
+    block-size: var(--xh-question-flow-dot-size, calc(var(--xh-question-flow-indicator-size, var(--xh-_question-flow-indicator)) / 2));
+    border-radius: var(--xh-question-flow-dot-radius, var(--xh-shape-circle));
+    background-color: currentColor;
+    scale: 0;
+    transition:
+      scale var(--xh-motion-duration-nudge) var(--xh-motion-ease-enter-strong),
+      background-color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+  }
+
+  .xh-scope-question-flow[data-part='item-indicator'][data-select-mode='single'][data-state='checked']:empty::before {
+    scale: 1;
+    transition:
+      scale var(--xh-motion-duration-nudge) var(--xh-motion-ease-settle),
+      background-color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+  }
+
+  .xh-scope-question-flow[data-part='item-indicator'][data-state='checked'] {
+    border-color: var(--xh-question-flow-indicator-border-checked, var(--xh-_tone, var(--xh-bg-brand)));
+    background: var(--xh-question-flow-indicator-bg-checked, var(--xh-_tone, var(--xh-bg-brand)));
+  }
+
+  .xh-scope-question-flow[data-part='item-text'] {
+    display: block;
+    flex: 1 1 auto;
+  }
+
+  .xh-scope-question-flow[data-part='item-text'][hidden] {
+    display: none;
+  }
+
+  /* 选项带一行说明：说明另起一行、与文字左缘对齐，两行之间不留行距；字色取次级、字号小一档 */
+  .xh-scope-question-flow[data-part='item']:has(> [data-part='item-description']) {
+    flex-wrap: wrap;
+    row-gap: 0;
+  }
+
+  .xh-scope-question-flow[data-part='item-description'] {
+    display: block;
+    flex: 1 0 100%;
+    padding-inline-start: calc(var(--xh-question-flow-indicator-size, var(--xh-_question-flow-indicator)) + var(--xh-question-flow-item-gap, var(--xh-space-1_5)));
+    color: var(--xh-question-flow-item-description-fg, var(--xh-fg-subtle));
+    font-size: var(--xh-question-flow-item-description-font-size, var(--xh-text-caption-size));
+    text-align: start;
+  }
+
+  .xh-scope-question-flow[data-part='item-description'][hidden] {
+    display: none;
+  }
+
+  /* 题目说明（含多选的数量要求）：题干下一行的次级文字 */
+  .xh-scope-question-flow[data-part='description'] {
+    display: block;
+    margin: 0;
+    color: var(--xh-question-flow-description-fg, var(--xh-fg-muted));
+    font-size: var(--xh-question-flow-description-font-size, var(--xh-text-secondary-size));
+    line-height: var(--xh-leading-normal);
+  }
+
+  .xh-scope-question-flow[data-part='description'][hidden] {
+    display: none;
+  }
+
+  /* 自由文本：与选项同等算数的一条答案，占满整行。框照字段外壳：字段淡底 + 控件描边，悬停描边升一档 */
+  .xh-scope-question-flow[data-part='note'] {
+    display: block;
+    inline-size: 100%;
+    padding-inline: var(--xh-question-flow-note-px, var(--xh-space-2));
+    padding-block: var(--xh-question-flow-note-py, var(--xh-space-1_5));
+    border: var(--xh-stroke-thin) solid var(--xh-question-flow-note-border, var(--xh-border-control));
+    border-radius: var(--xh-question-flow-note-radius, var(--xh-shape-control));
+    background: var(--xh-question-flow-note-bg, var(--xh-bg-field));
+    color: var(--xh-question-flow-note-fg, var(--xh-fg-default));
+    font-family: inherit;
+    font-size: var(--xh-question-flow-note-font-size, var(--xh-_question-flow-font-size));
+    transition:
+      background-color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter),
+      border-color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+  }
+
+  .xh-scope-question-flow[data-part='note'][hidden] {
+    display: none;
+  }
+
+  .xh-scope-question-flow[data-part='note']::placeholder {
+    color: var(--xh-question-flow-placeholder-fg, var(--xh-fg-subtle));
+  }
+
+  .xh-scope-question-flow[data-part='note']:hover:not(:disabled, :focus, [data-invalid]) {
+    border-color: var(--xh-question-flow-note-border-hover, var(--xh-border-strong));
+  }
+
+  /* 聚焦换承载面底 + 品牌描边，不画环：焦点由描边换色与底色差标出，强制色档补一圈 Highlight 环 */
+  .xh-scope-question-flow[data-part='note']:focus-within {
+    border-color: var(--xh-question-flow-note-border-focus, var(--xh-border-control-focus));
+    background: var(--xh-question-flow-note-bg-focus, var(--xh-bg-surface));
+  }
+
+  .xh-scope-question-flow[data-part='note']:focus-visible {
+    outline: none;
+  }
+
+  .xh-scope-question-flow[data-part='note']:disabled {
+    border-color: var(--xh-question-flow-note-border-disabled, var(--xh-border-default));
+    background: var(--xh-question-flow-note-bg-disabled, var(--xh-bg-subtle));
+    color: var(--xh-fg-disabled);
+  }
+
+  /* 页脚：左边步进，右边动作。
+     两侧的钮都不收缩、文案也不折行，一行摆不下时整条页脚顶出卡片；
+     允许换行后摆不下的那一组落到下一行 */
+  .xh-scope-question-flow[data-part='footer'] {
+    display: flex;
+    flex-wrap: wrap;
+    align-items: center;
+    justify-content: space-between;
+    gap: var(--xh-question-flow-footer-gap, var(--xh-space-3));
+  }
+
+  .xh-scope-question-flow[data-part='footer'][hidden] {
+    display: none;
+  }
+
+  /* 两颗翻页钮是方形图标钮，中间夹着计数：盒几何、悬停 / 按下与 0.97 按压、焦点环、禁用面全由
+     Action Control 的 icon 档 xs 位给（24px = --xh-control-action-size；ghost 形态，白底 100 → 200），
+     组件只映射既有使用者槽：尺寸、内衬、圆角（inset）、底与字色 */
+  .xh-scope-question-flow[data-part='prev-trigger'],
+  .xh-scope-question-flow[data-part='next-trigger'] {
+    --xh-action-visual-size: var(--xh-question-flow-step-size, var(--xh-_action-profile-visual-size));
+    --xh-action-padding-inline: var(--xh-question-flow-step-padding, var(--xh-_action-profile-padding-inline));
+    --xh-action-radius: var(--xh-question-flow-step-radius, var(--xh-shape-inset));
+    --xh-action-bg-rest: var(--xh-question-flow-step-bg, var(--xh-_action-variant-bg-rest));
+    --xh-action-bg-hover: var(--xh-question-flow-step-bg-hover, var(--xh-_action-variant-bg-hover));
+    --xh-action-fg-rest: var(--xh-question-flow-step-fg, var(--xh-fg-subtle));
+    --xh-action-fg-hover: var(--xh-question-flow-step-fg-hover, var(--xh-fg-default));
+    --xh-action-fg-pressed: var(--xh-question-flow-step-fg-hover, var(--xh-fg-default));
+  }
+
+  /* 家族那条 display 会把 UA 的 [hidden]{display:none} 盖掉 */
+  .xh-scope-question-flow[data-part='prev-trigger'][hidden],
+  .xh-scope-question-flow[data-part='next-trigger'][hidden] {
+    display: none;
+  }
+
+  /* 没写内容就由皮肤画箭头；作者往按钮里塞了自己的图形，这两条即不命中 */
+  .xh-scope-question-flow[data-part='prev-trigger']:empty::before {
+    content: '';
+    display: inline-block;
+    inline-size: var(--xh-icon-size, var(--xh-glyph-size-md));
+    block-size: var(--xh-icon-size, var(--xh-glyph-size-md));
+    vertical-align: var(--xh-glyph-baseline-shift);
+    background-color: currentColor;
+    -webkit-mask: var(--xh-glyph-mark-chevron-up) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-chevron-up) center / contain no-repeat;
+  }
+
+  .xh-scope-question-flow[data-part='next-trigger']:empty::before {
+    content: '';
+    display: inline-block;
+    inline-size: var(--xh-icon-size, var(--xh-glyph-size-md));
+    block-size: var(--xh-icon-size, var(--xh-glyph-size-md));
+    vertical-align: var(--xh-glyph-baseline-shift);
+    background-color: currentColor;
+    -webkit-mask: var(--xh-glyph-mark-chevron-down) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-chevron-down) center / contain no-repeat;
+  }
+
+  /* 给眼睛看的 N / M：等宽数字，换题时不左右晃 */
+  .xh-scope-question-flow[data-part='counter'] {
+    display: inline-flex;
+    align-items: center;
+    color: var(--xh-question-flow-counter-fg, var(--xh-fg-subtle));
+    font-size: var(--xh-question-flow-counter-font-size, var(--xh-text-caption-size));
+    font-variant-numeric: tabular-nums;
+  }
+
+  .xh-scope-question-flow[data-part='counter'][hidden] {
+    display: none;
+  }
+
+  /* 两颗动作钮是离散动作控件：盒几何、悬停 / 按下与 0.97 按压、焦点环、禁用面全由 Action Control 的 text 档给，
+     组件只映射既有使用者槽。跳过走 ghost 档：安静的文字钮（白底 100 → 200）；提交走 solid 档：这一组里的主要动作，
+     与 Button 缺省同为品牌实心。两颗共用的几何与字号写在一起 */
+  .xh-scope-question-flow[data-part='skip-trigger'],
+  .xh-scope-question-flow[data-part='submit-trigger'] {
+    --xh-action-gap: var(--xh-question-flow-action-gap, var(--xh-space-1));
+    --xh-action-visual-size: var(--xh-question-flow-action-h, var(--xh-_question-flow-h));
+    --xh-action-padding-inline: var(--xh-question-flow-action-px, var(--xh-_question-flow-px));
+    --xh-action-radius: var(--xh-question-flow-action-radius, var(--xh-shape-control));
+    --xh-action-font-size: var(--xh-question-flow-action-font-size, var(--xh-text-label-size));
+
+    font-weight: var(--xh-question-flow-action-font-weight, var(--xh-text-label-weight));
+  }
+
+  /* 家族那条 display 会把 UA 的 [hidden]{display:none} 盖掉 */
+  .xh-scope-question-flow[data-part='skip-trigger'][hidden],
+  .xh-scope-question-flow[data-part='submit-trigger'][hidden] {
+    display: none;
+  }
+
+  /* 跳过钮：底与字色映到 ghost 档的桥接槽，悬停时字色提到正文档 */
+  .xh-scope-question-flow[data-part='skip-trigger'] {
+    --xh-action-bg-rest: var(--xh-question-flow-skip-bg, var(--xh-_action-variant-bg-rest));
+    --xh-action-bg-hover: var(--xh-question-flow-skip-bg-hover, var(--xh-_action-variant-bg-hover));
+    --xh-action-fg-rest: var(--xh-question-flow-skip-fg, var(--xh-fg-muted));
+    --xh-action-fg-hover: var(--xh-question-flow-skip-fg-hover, var(--xh-fg-default));
+    --xh-action-fg-pressed: var(--xh-question-flow-skip-fg-hover, var(--xh-fg-default));
+  }
+
+  /* 提交钮：品牌实心，内顶高光把实心块顶出一道边，与跳过那颗的描边同一档厚度（三态同一支，
+     答不动时的置灰面由家族收掉、高光随之撤掉，出口一直在那里只是按不动）；底 / 字与置灰底映到 solid 档的桥接槽 */
+  .xh-scope-question-flow[data-part='submit-trigger'] {
+    --xh-action-bg-rest: var(--xh-question-flow-submit-bg, var(--xh-_action-variant-bg-rest));
+    --xh-action-bg-hover: var(--xh-question-flow-submit-bg-hover, var(--xh-_action-variant-bg-hover));
+    --xh-action-bg-pressed: var(--xh-question-flow-submit-bg-active, var(--xh-_action-variant-bg-pressed));
+    --xh-action-bg-disabled: var(--xh-question-flow-submit-bg-off, var(--xh-_action-variant-bg-disabled));
+    --xh-action-fg-rest: var(--xh-question-flow-submit-fg, var(--xh-_action-variant-fg-rest));
+    --xh-action-fg-hover: var(--xh-question-flow-submit-fg, var(--xh-_action-variant-fg-hover));
+    --xh-action-fg-pressed: var(--xh-question-flow-submit-fg, var(--xh-_action-variant-fg-pressed));
+    --xh-action-highlight-rest: transparent;
+    --xh-action-shadow-rest: var(--xh-question-flow-submit-shadow, var(--xh-_highlight-tone));
+    --xh-action-shadow-hover: var(--xh-question-flow-submit-shadow, var(--xh-_highlight-tone));
+    --xh-action-shadow-pressed: var(--xh-question-flow-submit-shadow, var(--xh-_highlight-tone));
+  }
+
+  /* 面是实心的，环色与面同族，画在面里就看不出来；环改取面自己的前景色——
+     那一族色本来就要在这块面上把字读清楚，与面的对比是按可读性定的。
+     置灰档的底换成置灰底、字换成置灰色，环取过来就跟底一起糊了，那一档走公共层的环 */
+  .xh-scope-question-flow[data-part='submit-trigger']:not([data-disabled]) {
+    --xh-action-ring-color-focus-visible: currentColor;
+  }
+
+  /* 交卷之后才露出的那一格：与 Tag 的 sm 档同一副方签——control 圆角、块尺寸取 chip 档、竖向内衬为 0 */
+  .xh-scope-question-flow[data-part='result'] {
+    display: inline-flex;
+    align-self: flex-start;
+    align-items: center;
+    box-sizing: border-box;
+    gap: var(--xh-question-flow-result-gap, var(--xh-space-1));
+    min-block-size: var(--xh-question-flow-result-h, var(--xh-chip-h-sm));
+    padding-inline: var(--xh-question-flow-result-px, var(--xh-space-1_5));
+    padding-block: var(--xh-question-flow-result-py, 0);
+    border: var(--xh-stroke-thin) solid transparent;
+    border-radius: var(--xh-question-flow-result-radius, var(--xh-shape-control));
+    background: var(--xh-question-flow-result-bg, var(--xh-_tone-subtle));
+    color: var(--xh-question-flow-result-fg, var(--xh-_tone-fg));
+    font-size: var(--xh-question-flow-result-font-size, var(--xh-text-caption-size));
+    font-weight: var(--xh-question-flow-result-font-weight, var(--xh-font-weight-medium));
+    line-height: var(--xh-control-indicator-md);
+  }
+
+  /* 落定结果弹出；落在首帧就在的列表条目里（历史消息）时直接呈现，不跟着整屏一起入场 */
+  .xh-scope-question-flow[data-part='result']:not([data-scope][data-part='item'][data-instant] :where(.xh-scope-question-flow)) {
+    animation: xh-pop-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter-strong);
+  }
+
+  .xh-scope-question-flow[data-part='result'][hidden] {
+    display: none;
+  }
+
+  /* 视觉隐藏的播报区：不能 display:none，那样读屏就取不到它了 */
+  .xh-scope-question-flow[data-part='live-region'] {
+    position: absolute;
+    inline-size: 1px;
+    block-size: 1px;
+    padding: 0;
+    margin: -1px;
+    border: 0;
+    overflow: hidden;
+    clip-path: inset(50%);
+    white-space: nowrap;
+  }
+
+  @media (forced-colors: active) {
+    /* 兜底字形是 mask 挖出来的一块底色，这一档里底色被系统换成 Canvas，字形跟着消失。
+       字形退出强制换色、直接写系统色（不能取 currentColor：退出强制换色的伪元素读到的是被系统换掉之前的作者色）：
+       按钮面上取 ButtonText，悬停与按下时家族把按钮涂成 Highlight、字形换 HighlightText；
+       落在勾选盒自己的实心面上（这一档里是 Canvas），整行悬停不换面，取 CanvasText；
+       禁用取 GrayText */
+    .xh-scope-question-flow[data-part='item-indicator'][data-select-mode='single']:empty::before {
+      forced-color-adjust: none;
+      background-color: CanvasText;
+    }
+
+    /* 备注框聚焦不画环、描边又被换成系统色，补一圈 Highlight 环 */
+    .xh-scope-question-flow[data-part='note']:focus {
+      outline: var(--xh-ring-width) solid Highlight;
+      outline-offset: var(--xh-ring-offset);
+    }
+
+    .xh-scope-question-flow:is([data-part='prev-trigger'], [data-part='next-trigger']):empty::before {
+      forced-color-adjust: none;
+      background-color: ButtonText;
+    }
+
+    .xh-scope-question-flow:is([data-part='prev-trigger'], [data-part='next-trigger']):not([data-disabled]):not([data-loading]):is(:hover, :active, [data-pressed]):empty::before {
+      background-color: HighlightText;
+    }
+
+    .xh-scope-question-flow[data-part='item'][data-disabled] .xh-scope-question-flow[data-part='item-indicator'][data-select-mode='single']:empty::before,
+    .xh-scope-question-flow:is([data-part='prev-trigger'], [data-part='next-trigger'])[data-disabled]:empty::before {
+      background-color: GrayText;
+    }
+  }
+}