@xihan-ui/styles 3.1.0 → 4.0.0

package/dist/css/code-view.css

@@ -0,0 +1,374 @@
+/*
+ * Copyright (c) 2021-Present XiHanFun and contributors.
+ * Licensed under the MIT License. See LICENSE in the project root for license information.
+ */
+
+/* 定义 code view 样式。 */
+
+/* 独立皮肤同时传递引入折叠条的动作控件配方；full bundle 递归去重。 */
+@import '../family/action-control.css';
+
+@layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  .xh-scope-code-view {
+    --xh-code-view-skin: 1;
+  }
+
+  /* 一张静态内容面：--xh-border-default 描边 + surface 底 + 无影（边界只由描边承担），
+     overflow: hidden 让内部 <pre> 的滚动内容沿圆角收边；不设 display，排布由作者决定。
+     color 给整段未着色的代码定基线，字号在这里消费一次，缺省即 md 档（与面内按钮同档）。 */
+  .xh-scope-code-view[data-part='root'] {
+    /* 尺寸缺省档：不写 data-size 时的取值。三档都只写这个私有槽，
+       公开槽留在读处当首选，作者在祖先上设的覆盖才赢得过档位声明 */
+    --xh-_code-view-font-size: var(--xh-control-font-md);
+
+    overflow: hidden;
+    border: var(--xh-stroke-thin) solid var(--xh-code-view-border, var(--xh-border-default));
+    border-radius: var(--xh-code-view-radius, var(--xh-shape-surface));
+    background: var(--xh-code-view-bg, var(--xh-bg-surface));
+    box-shadow: var(--xh-code-view-shadow, none);
+    color: var(--xh-code-view-fg, var(--xh-fg-muted));
+    font-size: var(--xh-code-view-font-size, var(--xh-_code-view-font-size));
+  }
+
+  /* min-block-size 给头部条一个不随内容塌陷的定高：只放文件名时与放进按钮时一样高 */
+  .xh-scope-code-view[data-part='header'] {
+    display: flex;
+    min-block-size: var(--xh-code-view-header-h, var(--xh-control-h-lg));
+    align-items: center;
+    gap: var(--xh-code-view-header-gap, var(--xh-space-2));
+    padding-inline: var(--xh-code-view-header-px, var(--xh-space-4));
+    padding-block: var(--xh-code-view-header-py, var(--xh-space-2));
+    border-block-end: var(--xh-stroke-thin) solid var(--xh-code-view-header-border, var(--xh-border-subtle));
+    color: var(--xh-code-view-header-fg, var(--xh-fg-muted));
+    font-size: var(--xh-code-view-header-font-size, var(--xh-text-secondary-size));
+    line-height: var(--xh-leading-tight);
+  }
+
+  /* 上面声明的 display 会盖掉 UA 的 [hidden]{display:none}，这里补回 */
+  .xh-scope-code-view[data-part='header'][hidden] {
+    display: none;
+  }
+
+  /* 文件名占满剩余宽度并单行截断：长路径不该把语言角标挤出去 */
+  .xh-scope-code-view[data-part='filename'] {
+    display: block;
+    overflow: hidden;
+    flex: 1 1 auto;
+    color: var(--xh-code-view-filename-fg, var(--xh-fg-default));
+    font-family: var(--xh-code-view-font, var(--xh-font-family-mono));
+    text-overflow: ellipsis;
+    white-space: nowrap;
+  }
+
+  .xh-scope-code-view[data-part='filename'][hidden] {
+    display: none;
+  }
+
+  /* user-select: none 让它不被框选带走 */
+  .xh-scope-code-view[data-part='lang-label'] {
+    display: block;
+    flex: 0 0 auto;
+    color: var(--xh-code-view-label-fg, var(--xh-fg-subtle));
+    font-size: var(--xh-code-view-label-font-size, var(--xh-text-caption-size));
+    line-height: var(--xh-leading-none);
+    user-select: none;
+  }
+
+  .xh-scope-code-view[data-part='lang-label'][hidden] {
+    display: none;
+  }
+
+  /* margin: 0 去掉 UA 给 <pre> 的默认外边距。
+     --xh-code-view-line-height 的兜底须与连接层内联 min-block-size 用的一致，
+     且因参与 calc 乘法必须是长度而非无单位倍数。 */
+  .xh-scope-code-view[data-part='pre'] {
+    /* 逻辑属性 overflow-inline 尚无可用实现，写物理轴 */
+    overflow-x: auto;
+    padding-block: var(--xh-code-view-py, var(--xh-space-3));
+    margin: 0;
+    line-height: var(--xh-code-view-line-height, var(--xh-text-code-leading));
+  }
+
+  /* 折叠时 <pre> 的高度被连接层写死，超出部分沿圆角收边 */
+  .xh-scope-code-view[data-part='root'][data-clamped] [data-part='pre']:where(.xh-scope-code-view) {
+    overflow-y: hidden;
+  }
+
+  .xh-scope-code-view[data-part='code'] {
+    display: block;
+    font-family: var(--xh-code-view-font, var(--xh-font-family-mono));
+  }
+
+  .xh-scope-code-view[data-part='code'][hidden] {
+    display: none;
+  }
+
+  /* 一行是一个块：行号槽与正文并排，空行也要占满一行高 */
+  .xh-scope-code-view[data-part='line'] {
+    display: flex;
+    min-block-size: var(--xh-code-view-line-height, var(--xh-text-code-leading));
+    padding-inline-end: var(--xh-code-view-px, var(--xh-space-3));
+    /* 标出来的那几行换的是底色与那条内阴影色条，两样一起过渡才是同一个动作 */
+    transition:
+      background-color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter),
+      box-shadow var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+  }
+
+  .xh-scope-code-view[data-part='line'][hidden] {
+    display: none;
+  }
+
+  /* 高亮行是强调不是选中：中性淡底 + 行首强调条，不用品牌淡底（品牌淡底只表达选中 / 当前） */
+  .xh-scope-code-view[data-part='line'][data-highlighted] {
+    background: var(--xh-code-view-highlight-bg, var(--xh-bg-subtle));
+    box-shadow: inset var(--xh-code-view-highlight-bar, var(--xh-stroke-thick)) 0 0 0 var(--xh-code-view-highlight-fg, var(--xh-border-strong));
+  }
+
+  /* 行号是画上去的不是写上去的：复制代码不带它，读屏也不逐行念数字。
+     节点本身由适配器按 lineNumbers 决定渲不渲，槽宽按 root 上的位数枚举定，见下方 data-digits 各档。
+     行与行之间无间隙，逐行的右边框首尾相接连成一条分隔线；行号比正文小一档、右对齐，多位数才齐。 */
+  .xh-scope-code-view[data-part='line-number'] {
+    display: block;
+    box-sizing: content-box;
+    flex: 0 0 auto;
+    padding-inline-start: var(--xh-code-view-px, var(--xh-space-3));
+    padding-inline-end: var(--xh-code-view-gutter-gap, var(--xh-space-1));
+    border-inline-end: var(--xh-stroke-thin) solid var(--xh-code-view-gutter-border, var(--xh-border-subtle));
+    color: var(--xh-code-view-number-fg, var(--xh-fg-subtle));
+    font-size: var(--xh-code-view-number-font-size, var(--xh-text-caption-size));
+    inline-size: var(--xh-_code-view-gutter);
+    text-align: end;
+    user-select: none;
+  }
+
+  .xh-scope-code-view[data-part='line-number']::before {
+    content: attr(data-line-number);
+  }
+
+  .xh-scope-code-view[data-part='line-number'][hidden] {
+    display: none;
+  }
+
+  /* white-space: pre 保留缩进不自动换行，长行改为横向滚动 */
+  .xh-scope-code-view[data-part='line-content'] {
+    display: block;
+    flex: 1 1 auto;
+    white-space: pre;
+  }
+
+  .xh-scope-code-view[data-part='line-content'][hidden] {
+    display: none;
+  }
+
+  /* 开了换行：pre-wrap 仍保留缩进与连续空白，只是允许行尾折下来；
+     anywhere 让没有空格的长串（url、base64）也能断，否则照样撑出横向滚动 */
+  .xh-scope-code-view[data-part='code'][data-wrap] [data-part='line-content']:where(.xh-scope-code-view) {
+    white-space: pre-wrap;
+    overflow-wrap: anywhere;
+  }
+
+  /* 没开行号时正文自带左内衬；开了行号则由行号槽的内衬顶开 */
+  .xh-scope-code-view[data-part='root']:not([data-line-numbers]) [data-part='line-content']:where(.xh-scope-code-view) {
+    padding-inline-start: var(--xh-code-view-px, var(--xh-space-3));
+  }
+
+  /* 行号槽宽按位数分档：连接层写不了 CSS 自定义属性，只能发 data-digits 让这里自己设 */
+  .xh-scope-code-view[data-part='root'] {
+    --xh-_code-view-gutter: 1ch;
+  }
+
+  .xh-scope-code-view[data-part='root'][data-digits='2'] {
+    --xh-_code-view-gutter: 2ch;
+  }
+
+  .xh-scope-code-view[data-part='root'][data-digits='3'] {
+    --xh-_code-view-gutter: 3ch;
+  }
+
+  .xh-scope-code-view[data-part='root'][data-digits='4'] {
+    --xh-_code-view-gutter: 4ch;
+  }
+
+  .xh-scope-code-view[data-part='root'][data-digits='5'] {
+    --xh-_code-view-gutter: 5ch;
+  }
+
+  .xh-scope-code-view[data-part='root'][data-digits='6'] {
+    --xh-_code-view-gutter: 6ch;
+  }
+
+  .xh-scope-code-view[data-part='root'][data-digits='7'] {
+    --xh-_code-view-gutter: 7ch;
+  }
+
+  /* 折叠条是铺满一行的 disclosure trigger，盒型、悬停与按下面由 Action Control 的 disclosure-trigger 档给
+     （ghost 形态：白底承载 hover 100 → pressed 200，按下只换面不缩放）；这里只把使用者槽映射到
+     桥接槽：圆角归零贴住卡边，内衬沿用代码区的横向内距与折叠条自己的纵向内距，字号与头部条同档。
+     顶边是与头部条同一支的内部分隔线：配方按状态写 border-color 简写，四个状态的边色槽都映射到
+     这支分隔色，再把四边宽归零、只留顶边一条 */
+  .xh-scope-code-view[data-part='fold-trigger'] {
+    --xh-action-radius: 0;
+    --xh-action-padding-inline: var(--xh-code-view-px, var(--xh-space-3));
+    --xh-action-padding-block: var(--xh-code-view-fold-py, var(--xh-space-2));
+    --xh-action-font-size: var(--xh-code-view-header-font-size, var(--xh-text-secondary-size));
+    --xh-action-fg-rest: var(--xh-code-view-fold-fg, var(--xh-fg-muted));
+    --xh-action-bg-hover: var(--xh-code-view-fold-bg-hover, var(--xh-_action-variant-bg-hover));
+    --xh-action-border-rest: var(--xh-code-view-header-border, var(--xh-border-subtle));
+    --xh-action-border-hover: var(--xh-code-view-header-border, var(--xh-border-subtle));
+    --xh-action-border-pressed: var(--xh-code-view-header-border, var(--xh-border-subtle));
+    --xh-action-border-focus-visible: var(--xh-code-view-header-border, var(--xh-border-subtle));
+
+    border-width: 0;
+    border-block-start-width: var(--xh-stroke-thin);
+  }
+
+  .xh-scope-code-view[data-part='fold-trigger'][hidden] {
+    display: none;
+  }
+
+  /* 按块折叠：每行正文都让出一列（一行高的正方格），块头的折叠钮定位在这一列里；
+     没有钮的行也让，缩进才对得齐 */
+  .xh-scope-code-view[data-part='root'][data-block-folding] {
+    --xh-_code-view-fold-col: var(--xh-code-view-fold-col, var(--xh-code-view-line-height, var(--xh-text-code-leading)));
+  }
+
+  .xh-scope-code-view[data-part='root'][data-block-folding] [data-part='line-content']:where(.xh-scope-code-view) {
+    position: relative;
+    padding-inline-start: var(--xh-_code-view-fold-col);
+  }
+
+  .xh-scope-code-view[data-part='root'][data-block-folding]:not([data-line-numbers]) [data-part='line-content']:where(.xh-scope-code-view) {
+    padding-inline-start: calc(var(--xh-code-view-px, var(--xh-space-3)) + var(--xh-_code-view-fold-col));
+  }
+
+  /* 行首折叠钮是 disclosure trigger：接 Action Control icon 档、ghost 形态，边长压到一行高，
+     按下只换面不缩放；静息取次级字色，不和正文抢 */
+  .xh-scope-code-view[data-part='line-fold-trigger'] {
+    --xh-action-visual-size: var(--xh-_code-view-fold-col);
+    --xh-action-min-inline-size: var(--xh-_code-view-fold-col);
+    --xh-action-radius: var(--xh-code-view-line-fold-trigger-radius, var(--xh-shape-control));
+    --xh-action-fg-rest: var(--xh-code-view-line-fold-trigger-fg, var(--xh-fg-subtle));
+    --xh-action-scale-pressed: none;
+    --xh-icon-size: var(--xh-code-view-icon-size, var(--xh-glyph-size-sm));
+
+    position: absolute;
+    inset-block-start: 0;
+    inset-inline-start: 0;
+    block-size: var(--xh-_code-view-fold-col);
+  }
+
+  .xh-scope-code-view[data-part='root'][data-block-folding]:not([data-line-numbers]) [data-part='line-fold-trigger']:where(.xh-scope-code-view) {
+    inset-inline-start: var(--xh-code-view-px, var(--xh-space-3));
+  }
+
+  .xh-scope-code-view[data-part='line-fold-trigger'][hidden] {
+    display: none;
+  }
+
+  /* 展开时朝下；收起时转向行尾那一侧（RTL 跟着换向） */
+  .xh-scope-code-view[data-part='line-fold-trigger']::before {
+    content: '';
+    display: block;
+    inline-size: var(--xh-icon-size, var(--xh-glyph-size-sm));
+    block-size: var(--xh-icon-size, var(--xh-glyph-size-sm));
+    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;
+    transition: rotate var(--xh-motion-duration-expand) var(--xh-motion-ease-enter-strong);
+  }
+
+  .xh-scope-code-view[data-part='line-fold-trigger'][data-state='closed']::before {
+    rotate: calc(-90deg * var(--xh-direction-sign));
+    transition-duration: var(--xh-motion-duration-collapse);
+  }
+
+  /* 折叠着的块头：正文后面一枚省略号，示意下面收起了几行；画上去的，复制不带它 */
+  .xh-scope-code-view[data-part='line-content'][data-folded]::after {
+    content: '';
+    display: inline-block;
+    inline-size: var(--xh-icon-size, var(--xh-glyph-size-sm));
+    block-size: var(--xh-icon-size, var(--xh-glyph-size-sm));
+    margin-inline-start: var(--xh-code-view-folded-gap, var(--xh-space-1));
+    vertical-align: var(--xh-glyph-baseline-shift);
+    background-color: var(--xh-code-view-folded-fg, var(--xh-fg-subtle));
+    -webkit-mask: var(--xh-glyph-mark-ellipsis) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-ellipsis) center / contain no-repeat;
+  }
+
+  /* 尺寸档写私有槽、由 root 基础规则消费一次：缺省与阶梯是同一个口子，
+     作者设的 --xh-code-view-font-size 排在读处首选，不会被这三条盖掉。
+     行号槽宽以 ch 计，随字号一起走 */
+  .xh-scope-code-view[data-part='root'][data-size='sm'] {
+    --xh-_code-view-font-size: var(--xh-control-font-sm);
+  }
+
+  .xh-scope-code-view[data-part='root'][data-size='md'] {
+    --xh-_code-view-font-size: var(--xh-control-font-md);
+  }
+
+  .xh-scope-code-view[data-part='root'][data-size='lg'] {
+    --xh-_code-view-font-size: var(--xh-control-font-lg);
+  }
+
+  /* 记号本身不带任何布局，只上色：它是行内片段，多一点盒模型都会破坏对齐 */
+  .xh-scope-code-view[data-part='token'][data-kind='comment'] {
+    color: var(--xh-code-view-comment-fg, var(--xh-fg-muted));
+    font-style: italic;
+  }
+
+  .xh-scope-code-view[data-part='token'][data-kind='string'] {
+    color: var(--xh-code-view-string-fg, var(--xh-syntax-string));
+  }
+
+  .xh-scope-code-view[data-part='token'][data-kind='number'] {
+    color: var(--xh-code-view-number-token-fg, var(--xh-syntax-number));
+  }
+
+  .xh-scope-code-view[data-part='token'][data-kind='keyword'] {
+    color: var(--xh-code-view-keyword-fg, var(--xh-syntax-keyword));
+    font-weight: var(--xh-code-view-keyword-weight, var(--xh-font-weight-semibold));
+  }
+
+  .xh-scope-code-view[data-part='token'][data-kind='punctuation'] {
+    color: var(--xh-code-view-punctuation-fg, var(--xh-fg-subtle));
+  }
+
+  /*
+   * 打印：标出来的那几行只有一层淡底加一条写在 inset 阴影上的实心条，
+   * 底多数打印机丢掉、投影本就不该上纸，标了哪几行在纸上完全读不出来。
+   * 改画一圈内收的实边把那几行框出来。用 outline 不用 border：
+   * 行是横排 flex，加边会把行号与正文一起往里推，没标的行不加边就对不齐了。
+   */
+  @media print {
+    .xh-scope-code-view[data-part='line'][data-highlighted] {
+      outline: var(--xh-code-view-highlight-bar, var(--xh-stroke-thick)) solid currentColor;
+      outline-offset: calc(-1 * var(--xh-code-view-highlight-bar, var(--xh-stroke-thick)));
+    }
+  }
+
+  @media (forced-colors: active) {
+    /* 兜底字形是 mask 挖出来的一块底色，这一档里底色被系统换成 Canvas，字形跟着消失。
+       字形退出强制换色、直接写系统色（不能取 currentColor：退出强制换色的伪元素读到的是被系统换掉之前的作者色）：
+       按钮面上取 ButtonText，悬停与按下时家族把按钮涂成 Highlight、字形换 HighlightText；
+       落在 Canvas 面上的取 CanvasText；
+       禁用取 GrayText */
+    .xh-scope-code-view[data-part='line-fold-trigger']::before {
+      forced-color-adjust: none;
+      background-color: ButtonText;
+    }
+
+    .xh-scope-code-view[data-part='line-content'][data-folded]::after {
+      forced-color-adjust: none;
+      background-color: CanvasText;
+    }
+
+    .xh-scope-code-view[data-part='line-fold-trigger']:not([data-disabled]):not([data-loading]):is(:hover, :active, [data-pressed])::before {
+      background-color: HighlightText;
+    }
+
+    .xh-scope-code-view[data-part='line-fold-trigger'][data-disabled]::before {
+      background-color: GrayText;
+    }
+  }
+}

package/dist/css/collapsible.css

@@ -0,0 +1,200 @@
+/*
+ * Copyright (c) 2021-Present XiHanFun and contributors.
+ * Licensed under the MIT License. See LICENSE in the project root for license information.
+ */
+
+/* 定义 collapsible 样式。 */
+
+/* 共享关键帧由 family/motion.css 提供，本皮肤 @import 它，单独引入仍成立；
+   独立皮肤同时传递引入触发器的动作控件配方，full bundle 递归去重。 */
+@import '../family/motion.css';
+@import '../family/action-control.css';
+
+@layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  .xh-scope-collapsible {
+    --xh-collapsible-skin: 1;
+  }
+
+  /* 根容器自己不排版，这条只声明尺寸档的私有槽：正文与标题行从 root 继承它们，
+     换档不必给部件各写一条选择器；触发器的三档几何由家族 disclosure-trigger 档给 */
+  .xh-scope-collapsible[data-part='root'] {
+    /* 作者塞进正文里的图标与皮肤画的兜底字形同一把尺：md 档，触发器上另按家族档取值 */
+    --xh-icon-size: var(--xh-collapsible-icon-size, var(--xh-glyph-size-md));
+
+    /* 触发器比家族 disclosure-trigger 档收一截：md 上下 10px + 一行正文行高 21px = 41px 高，横向 12px；
+       正文与触发器同一条起点，上下各留 8px */
+    --xh-_collapsible-trigger-gap: var(--xh-control-gap-md);
+    --xh-_collapsible-trigger-py: var(--xh-space-2_5);
+    --xh-_collapsible-trigger-px: var(--xh-space-3);
+    --xh-_collapsible-content-px: var(--xh-space-3);
+    --xh-_collapsible-content-pt: var(--xh-space-2);
+    --xh-_collapsible-content-pb: var(--xh-space-2);
+
+    /* 语气落在展开着的触发器上，指示器写在触发器里、跟着继承这个色，不另立规则。
+       没写 data-tone 时 --xh-_tone-fg 没被声明，退回原来的前景色。
+       聚焦环不在其列，它恒是 --xh-ring-focus */
+    --xh-_collapsible-open-fg: var(--xh-_tone-fg, var(--xh-fg-default));
+  }
+
+  /* 触发器与其同排内容住的那一行；触发器自己已经是整行宽，这里只负责把两者摆平 */
+  .xh-scope-collapsible[data-part='header'] {
+    display: flex;
+    align-items: center;
+    gap: var(--xh-collapsible-header-gap, var(--xh-_collapsible-trigger-gap));
+    inline-size: 100%;
+  }
+
+  .xh-scope-collapsible[data-part='header'][hidden] {
+    display: none;
+  }
+
+  /* —— 尺寸 —— */
+  /* 缺省档写在上面那条里 */
+  .xh-scope-collapsible[data-part='root'][data-size='sm'] {
+    --xh-_collapsible-trigger-gap: var(--xh-control-gap-sm);
+    --xh-_collapsible-trigger-py: var(--xh-space-1_5);
+    --xh-_collapsible-trigger-px: var(--xh-space-2_5);
+    --xh-_collapsible-content-px: var(--xh-space-2_5);
+    --xh-_collapsible-content-pt: var(--xh-space-1_5);
+    --xh-_collapsible-content-pb: var(--xh-space-1_5);
+  }
+
+  .xh-scope-collapsible[data-part='root'][data-size='lg'] {
+    --xh-_collapsible-trigger-gap: var(--xh-control-gap-lg);
+    --xh-_collapsible-trigger-py: var(--xh-space-3);
+    --xh-_collapsible-trigger-px: var(--xh-space-4);
+    --xh-_collapsible-content-px: var(--xh-space-4);
+    --xh-_collapsible-content-pt: var(--xh-space-3);
+    --xh-_collapsible-content-pb: var(--xh-space-3);
+  }
+
+  /* 触发器铺满一行，盒型、三档几何、悬停 / 按下 / 禁用面由 Action Control 的 disclosure-trigger 档给
+     （ghost 形态：根无壳，按画布承载 hover 100 → pressed 200；按下只换面不缩放）；
+     这里只把使用者槽映射到桥接槽：字色三态同值（家族的 hover / pressed 字色规则比皮肤更特定，不映射会被换回
+     缺省字色），字形按触发器自己的档位取 --xh-_action-profile-glyph-size；边归零贴住标题行，几何与迁移前一致 */
+  .xh-scope-collapsible[data-part='trigger'] {
+    --xh-action-gap: var(--xh-collapsible-trigger-gap, var(--xh-_action-profile-gap));
+    --xh-action-visual-size: var(--xh-collapsible-trigger-h, var(--xh-_action-profile-visual-size));
+    --xh-action-padding-block: var(--xh-collapsible-trigger-py, var(--xh-_collapsible-trigger-py));
+    --xh-action-padding-inline: var(--xh-collapsible-trigger-px, var(--xh-_collapsible-trigger-px));
+    --xh-action-radius: var(--xh-collapsible-trigger-radius, var(--xh-_action-profile-radius));
+    --xh-action-bg-rest: var(--xh-collapsible-trigger-bg, var(--xh-_action-variant-bg-rest));
+    --xh-action-bg-hover: var(--xh-collapsible-trigger-bg-hover, var(--xh-_action-variant-bg-hover));
+    --xh-action-fg-rest: var(--xh-collapsible-trigger-fg, var(--xh-_action-variant-fg-rest));
+    --xh-action-fg-hover: var(--xh-collapsible-trigger-fg, var(--xh-_action-variant-fg-hover));
+    --xh-action-fg-pressed: var(--xh-collapsible-trigger-fg, var(--xh-_action-variant-fg-pressed));
+    --xh-action-font-size: var(--xh-collapsible-trigger-font-size, var(--xh-_action-profile-font-size));
+    --xh-icon-size: var(--xh-collapsible-icon-size, var(--xh-glyph-size-sm));
+
+    border-width: 0;
+    font-weight: var(--xh-collapsible-trigger-font-weight, var(--xh-text-label-weight));
+    line-height: var(--xh-leading-normal);
+  }
+
+  /* 展开着的那一档单开一个槽：与常态共用一个的话，作者一改常态字色就把展开态也改掉了。
+     悬停 / 按下的面与收起态同档（open 与家族 hover 同档中性） */
+  .xh-scope-collapsible[data-part='trigger'][data-state='open'] {
+    --xh-action-fg-rest: var(--xh-collapsible-trigger-fg-open, var(--xh-_collapsible-open-fg));
+    --xh-action-fg-hover: var(--xh-collapsible-trigger-fg-open, var(--xh-_collapsible-open-fg));
+    --xh-action-fg-pressed: var(--xh-collapsible-trigger-fg-open, var(--xh-_collapsible-open-fg));
+
+    font-weight: var(--xh-collapsible-trigger-font-weight-open, var(--xh-font-weight-medium));
+  }
+
+  /* 禁用前景换成禁用色，不靠 opacity 压暗（家族按 data-disabled 给禁用面与指针，字色槽在这里保留优先） */
+  .xh-scope-collapsible[data-part='trigger'][data-disabled] {
+    --xh-action-fg-disabled: var(--xh-collapsible-trigger-fg-disabled, var(--xh-_action-variant-fg-disabled));
+  }
+
+  /* 开合方向的标记，排在触发器行尾（触发器是 space-between 两端对齐） */
+  .xh-scope-collapsible[data-part='indicator'] {
+    display: inline-flex;
+    flex: none;
+    align-items: center;
+    justify-content: center;
+    color: var(--xh-collapsible-indicator-fg, var(--xh-fg-subtle));
+    line-height: var(--xh-leading-none);
+  }
+
+  /* 指示器与正文同档转向：收起时取 collapse 档，展开时（下面的打开态）取 expand 档。
+     首帧就在的朝向直接呈现（data-instant），第一次开合起才转 */
+  .xh-scope-collapsible[data-part='indicator']:not([data-instant]) {
+    transition: rotate var(--xh-motion-duration-collapse) var(--xh-motion-ease-enter-strong);
+  }
+
+  /* 没写内容就由皮肤画；作者往部件里塞了自己的图形，这条规则即不命中 */
+  .xh-scope-collapsible[data-part='indicator']: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;
+  }
+
+  .xh-scope-collapsible[data-part='indicator'][data-state='open'] {
+    rotate: 180deg;
+  }
+
+  .xh-scope-collapsible[data-part='indicator'][data-state='open']:not([data-instant]) {
+    transition: rotate var(--xh-motion-duration-expand) var(--xh-motion-ease-enter-strong);
+  }
+
+  /* 这里刻意没有 [data-part='content'][hidden] { display: none }：补了动画一帧都播不出来。
+     收起由适配器在退场结束后写内联 display 落成，退场窗口内靠 connect 发的 inert 挡住焦点 */
+  .xh-scope-collapsible[data-part='content'] {
+    /* 行高与内缩同帧动的共享关键帧读这两条槽，两端内缩一起收放 */
+    --xh-_disclosure-pt: var(--xh-collapsible-content-pt, var(--xh-_collapsible-content-pt));
+    --xh-_disclosure-pb: var(--xh-collapsible-content-pb, var(--xh-_collapsible-content-pb));
+
+    display: grid;
+    grid-template-rows: 1fr;
+    overflow: clip;
+    padding-block-start: var(--xh-collapsible-content-pt, var(--xh-_collapsible-content-pt));
+    padding-block-end: var(--xh-collapsible-content-pb, var(--xh-_collapsible-content-pb));
+    padding-inline: var(--xh-collapsible-content-px, var(--xh-_collapsible-content-px));
+    color: var(--xh-collapsible-content-fg, var(--xh-fg-default));
+    font-size: var(--xh-collapsible-content-font-size, var(--xh-text-body-size));
+    line-height: var(--xh-leading-normal);
+  }
+
+  /* 展开与收起只在开合时播：首帧就在的展开 / 收起直接呈现（data-instant） */
+  .xh-scope-collapsible[data-part='content'][data-state='open']:not([data-instant]) {
+    animation: xh-disclosure-expand var(--xh-motion-duration-expand) var(--xh-motion-ease-enter-strong);
+  }
+
+  .xh-scope-collapsible[data-part='content'][data-state='closed']:not([data-instant]) {
+    animation: xh-disclosure-collapse var(--xh-motion-duration-collapse) var(--xh-motion-ease-exit) forwards;
+  }
+
+  @media (forced-colors: active) {
+    /* 兜底字形是 mask 挖出来的一块底色，这一档里底色被系统换成 Canvas，字形跟着消失。
+       字形退出强制换色、直接写系统色（不能取 currentColor：退出强制换色的伪元素读到的是被系统换掉之前的作者色）：
+       按钮面上取 ButtonText，悬停与按下时家族把按钮涂成 Highlight、字形换 HighlightText；
+       禁用取 GrayText */
+    .xh-scope-collapsible[data-part='indicator']:empty::before {
+      forced-color-adjust: none;
+      background-color: ButtonText;
+    }
+
+    .xh-scope-collapsible[data-part='trigger']:not([data-disabled]):not([data-loading]):is(:hover, :active, [data-pressed]) .xh-scope-collapsible[data-part='indicator']:empty::before {
+      background-color: HighlightText;
+    }
+
+    .xh-scope-collapsible[data-part='trigger'][data-disabled] .xh-scope-collapsible[data-part='indicator']:empty::before {
+      background-color: GrayText;
+    }
+  }
+}
+
+@layer xihan.motion {
+  /* 声明过任何 display 就盖掉了 UA 的 [hidden]{display:none}，收起态得自己还回去。
+     写在文件末尾：兜底必须排在该部件所有 display 声明之后 */
+  .xh-scope-collapsible[data-part='trigger'][hidden],
+  .xh-scope-collapsible[data-part='indicator'][hidden] {
+    display: none;
+  }
+}