@xihan-ui/styles 3.1.0 → 4.0.0

package/css/typography.css

@@ -27,12 +27,13 @@
     --xh-_typography-body-size: var(--xh-text-body-size);
     --xh-_typography-block-gap: var(--xh-space-4);
     --xh-_typography-heading-gap: var(--xh-space-6);
-    --xh-_typography-h1: var(--xh-font-size-3xl);
-    --xh-_typography-h2: var(--xh-font-size-2xl);
-    --xh-_typography-h3: var(--xh-font-size-xl);
-    --xh-_typography-h4: var(--xh-font-size-lg);
-    --xh-_typography-h5: var(--xh-font-size-md);
-    --xh-_typography-h6: var(--xh-font-size-sm);
+    /* 六级标题沿字号阶梯从 36 逐档降到 16：最小的 h6 仍比正文大一号 */
+    --xh-_typography-h1: var(--xh-font-size-5xl);
+    --xh-_typography-h2: var(--xh-font-size-4xl);
+    --xh-_typography-h3: var(--xh-font-size-3xl);
+    --xh-_typography-h4: var(--xh-font-size-2xl);
+    --xh-_typography-h5: var(--xh-font-size-xl);
+    --xh-_typography-h6: var(--xh-font-size-lg);
     /* 读行宽度：整块正文不收窄就会拉成一行行难读的长句 */
     --xh-_typography-measure: 68ch;
     /* 行内代码跟着所在那行的字号缩：以「随文字走」的字形尺寸为基数按比例收一点，不取固定档位 */
@@ -64,15 +65,15 @@
     --xh-_typography-body-size: var(--xh-font-size-sm);
     --xh-_typography-block-gap: var(--xh-space-3);
     --xh-_typography-heading-gap: var(--xh-space-5);
-    --xh-_typography-h1: var(--xh-font-size-2xl);
-    --xh-_typography-h2: var(--xh-font-size-xl);
-    --xh-_typography-h3: var(--xh-font-size-lg);
-    --xh-_typography-h4: var(--xh-font-size-md);
-    --xh-_typography-h5: var(--xh-font-size-sm);
-    --xh-_typography-h6: var(--xh-font-size-xs);
+    --xh-_typography-h1: var(--xh-font-size-4xl);
+    --xh-_typography-h2: var(--xh-font-size-3xl);
+    --xh-_typography-h3: var(--xh-font-size-2xl);
+    --xh-_typography-h4: var(--xh-font-size-xl);
+    --xh-_typography-h5: var(--xh-font-size-lg);
+    --xh-_typography-h6: var(--xh-font-size-md);
   }
 
-  /* 大档只放大正文与段距：标题档位在 3xl 见顶，六档保持原样 */
+  /* 大档只放大正文与段距：标题档位在 5xl 见顶，六档保持原样 */
   [data-scope='typography'][data-part='root'][data-size='lg'] {
     --xh-_typography-body-size: var(--xh-font-size-lg);
     --xh-_typography-block-gap: var(--xh-space-5);
@@ -123,7 +124,7 @@
   [data-scope='typography'][data-part='heading'] {
     color: var(--xh-typography-heading-fg, var(--xh-fg-default));
     font-size: var(--xh-typography-heading-font-size, var(--xh-_typography-h3));
-    font-weight: var(--xh-typography-heading-font-weight, var(--xh-font-weight-semibold));
+    font-weight: var(--xh-typography-heading-font-weight, var(--xh-font-weight-medium));
     line-height: var(--xh-typography-heading-leading, var(--xh-leading-tight));
     /* 标题折行时把各行拉得一样长 */
     text-wrap: balance;
@@ -177,14 +178,15 @@
   }
 
   [data-scope='typography'][data-part='text'][data-variant='strong'] {
-    font-weight: var(--xh-typography-text-font-weight, var(--xh-font-weight-semibold));
+    font-weight: var(--xh-typography-text-font-weight, var(--xh-font-weight-medium));
   }
 
   [data-scope='typography'][data-part='text'][data-variant='code'] {
     padding-block: var(--xh-typography-code-py, var(--xh-space-0_5));
-    padding-inline: var(--xh-typography-code-px, var(--xh-space-1));
+    padding-inline: var(--xh-typography-code-px, var(--xh-space-2));
     border-radius: var(--xh-typography-code-radius, var(--xh-shape-inset));
     background: var(--xh-typography-code-bg, var(--xh-bg-subtle));
+    color: var(--xh-typography-code-fg, var(--xh-fg-muted));
     font-family: var(--xh-typography-code-font, var(--xh-font-family-mono));
     font-size: var(--xh-typography-code-font-size, var(--xh-_typography-code-size));
   }
@@ -214,8 +216,8 @@
   [data-scope='typography'][data-part='text'][data-marked] {
     padding-inline: var(--xh-typography-mark-px, var(--xh-space-0_5));
     border-radius: var(--xh-typography-mark-radius, var(--xh-shape-inset));
-    background: var(--xh-typography-mark-bg, var(--xh-bg-brand-subtle));
-    color: var(--xh-typography-mark-fg, var(--xh-fg-brand-strong));
+    background: var(--xh-typography-mark-bg, var(--xh-bg-mark));
+    color: var(--xh-typography-mark-fg, var(--xh-fg-default));
     -webkit-box-decoration-break: clone;
     box-decoration-break: clone;
   }
@@ -330,7 +332,7 @@
 
   [data-scope='typography'][data-part='prose'] :where(h1, h2, h3, h4, h5, h6) {
     color: var(--xh-typography-prose-heading-fg, var(--xh-fg-default));
-    font-weight: var(--xh-typography-prose-heading-font-weight, var(--xh-font-weight-semibold));
+    font-weight: var(--xh-typography-prose-heading-font-weight, var(--xh-font-weight-medium));
     line-height: var(--xh-leading-tight);
     text-wrap: balance;
   }
@@ -362,7 +364,7 @@
 
   /* 列表：项目符号要留在容器里面，缩进画在列表自己的起始内衬上 */
   [data-scope='typography'][data-part='prose'] :where(ul, ol) {
-    padding-inline-start: var(--xh-typography-prose-list-ps, var(--xh-space-6));
+    padding-inline-start: var(--xh-typography-prose-list-ps, var(--xh-space-5));
   }
 
   [data-scope='typography'][data-part='prose'] :where(li + li) {
@@ -386,15 +388,16 @@
   }
 
   [data-scope='typography'][data-part='prose'] :where(strong) {
-    font-weight: var(--xh-typography-prose-strong-font-weight, var(--xh-font-weight-semibold));
+    font-weight: var(--xh-typography-prose-strong-font-weight, var(--xh-font-weight-medium));
   }
 
   /* 行内代码与 text 部件的 code 形态同源，同一块正文里两条路写出来一个样 */
   [data-scope='typography'][data-part='prose'] :where(code) {
     padding-block: var(--xh-typography-code-py, var(--xh-space-0_5));
-    padding-inline: var(--xh-typography-code-px, var(--xh-space-1));
+    padding-inline: var(--xh-typography-code-px, var(--xh-space-2));
     border-radius: var(--xh-typography-code-radius, var(--xh-shape-inset));
     background: var(--xh-typography-code-bg, var(--xh-bg-subtle));
+    color: var(--xh-typography-code-fg, var(--xh-fg-muted));
     font-family: var(--xh-typography-code-font, var(--xh-font-family-mono));
     font-size: var(--xh-typography-code-font-size, var(--xh-_typography-code-size));
   }
@@ -418,10 +421,10 @@
   }
 
   [data-scope='typography'][data-part='prose'] :where(blockquote) {
-    padding-inline-start: var(--xh-typography-prose-quote-ps, var(--xh-space-4));
+    padding-inline-start: var(--xh-typography-prose-quote-ps, var(--xh-space-2));
     border-inline-start: var(--xh-stroke-thick) solid
-      var(--xh-typography-prose-quote-border, var(--xh-border-subtle));
-    color: var(--xh-typography-prose-quote-fg, var(--xh-fg-muted));
+      var(--xh-typography-prose-quote-border, var(--xh-border-strong));
+    color: var(--xh-typography-prose-quote-fg, inherit);
   }
 
   [data-scope='typography'][data-part='prose'] :where(hr) {

package/dist/css/accordion.css

@@ -0,0 +1,296 @@
+/*
+ * Copyright (c) 2021-Present XiHanFun and contributors.
+ * Licensed under the MIT License. See LICENSE in the project root for license information.
+ */
+
+/* 定义 accordion 样式。 */
+
+/* 共享关键帧由 family/motion.css 提供，本皮肤 @import 它，单独引入仍成立；
+   独立皮肤同时传递引入标题栏的动作控件配方，full bundle 递归去重。 */
+@import '../family/motion.css';
+@import '../family/action-control.css';
+
+@layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  .xh-scope-accordion {
+    --xh-accordion-skin: 1;
+  }
+
+  .xh-scope-accordion[data-part='root'] {
+    /* 作者塞进正文里的图标与皮肤画的兜底字形同一把尺：md 档，标题栏上另按家族档取值 */
+    --xh-icon-size: var(--xh-accordion-icon-size, var(--xh-glyph-size-md));
+
+    /* 尺寸档只换这几个私有槽，标题栏与正文从 root 继承它们。
+       标题栏比家族 disclosure-trigger 档收一截：md 上下 10px + 一行正文行高 21px = 41px 高，横向 12px；
+       正文与标题栏同一条起点，上下各留 8px */
+    --xh-_accordion-trigger-py: var(--xh-space-2_5);
+    --xh-_accordion-trigger-px: var(--xh-space-3);
+    --xh-_accordion-content-px: var(--xh-space-3);
+    --xh-_accordion-content-pt: var(--xh-space-2);
+    --xh-_accordion-content-pb: var(--xh-space-2);
+
+    /* 语气落在展开着的标题上，指示器写在标题里、跟着继承这个色，不另立规则。
+       没写 data-tone 时 --xh-_tone-fg 没被声明，退回原来的前景色。
+       聚焦环不在其列，它恒是 --xh-ring-focus */
+    --xh-_accordion-open-fg: var(--xh-_tone-fg, var(--xh-fg-default));
+
+    display: flex;
+    flex-direction: column;
+    inline-size: 100%;
+    contain: layout style;
+  }
+
+  .xh-scope-accordion[data-part='root'][data-orientation='horizontal'] {
+    flex-direction: row;
+  }
+
+  /* —— 尺寸 —— */
+  /* 缺省档写在上面的基础规则里 */
+  .xh-scope-accordion[data-part='root'][data-size='sm'] {
+    --xh-_accordion-trigger-py: var(--xh-space-1_5);
+    --xh-_accordion-trigger-px: var(--xh-space-2_5);
+    --xh-_accordion-content-px: var(--xh-space-2_5);
+    --xh-_accordion-content-pt: var(--xh-space-1_5);
+    --xh-_accordion-content-pb: var(--xh-space-1_5);
+  }
+
+  .xh-scope-accordion[data-part='root'][data-size='lg'] {
+    --xh-_accordion-trigger-py: var(--xh-space-3);
+    --xh-_accordion-trigger-px: var(--xh-space-4);
+    --xh-_accordion-content-px: var(--xh-space-4);
+    --xh-_accordion-content-pt: var(--xh-space-3);
+    --xh-_accordion-content-pb: var(--xh-space-3);
+  }
+
+  .xh-scope-accordion[data-part='item'] {
+    position: relative;
+    min-inline-size: 0;
+  }
+
+  /* 分隔线画在后一条的起始边，条与条之间才只有一条，末条也不会留一条悬空线
+     （根没有外框接住它）。只认自己的直接子条目：套在条目里的另一份手风琴由它自己的根管。
+     横排时换成行内轴那一侧 */
+  .xh-scope-accordion[data-part='root']
+    > .xh-scope-accordion[data-part='item']
+    + .xh-scope-accordion[data-part='item'] {
+    border-block-start: var(--xh-stroke-thin) solid var(--xh-accordion-item-border, var(--xh-border-default));
+  }
+
+  .xh-scope-accordion[data-part='root'][data-orientation='horizontal']
+    > .xh-scope-accordion[data-part='item']
+    + .xh-scope-accordion[data-part='item'] {
+    border-block-start: 0;
+    border-inline-start: var(--xh-stroke-thin) solid var(--xh-accordion-item-border, var(--xh-border-default));
+  }
+
+  /* 作者显式渲染的分隔线。渲染了它，上面那条 item + item 的相邻规则就不再命中，
+     两条线不会同时出现 */
+  .xh-scope-accordion[data-part='item-separator'] {
+    flex: none;
+    block-size: var(--xh-stroke-thin);
+    border: 0;
+    margin: 0;
+    background: var(--xh-accordion-item-border, var(--xh-border-default));
+  }
+
+  .xh-scope-accordion[data-part='item-separator'][hidden] {
+    display: none;
+  }
+
+  .xh-scope-accordion[data-part='root'][data-orientation='horizontal']
+    > .xh-scope-accordion[data-part='item-separator'] {
+    block-size: auto;
+    inline-size: var(--xh-stroke-thin);
+  }
+
+  /* —— 形态 —— */
+  /* ghost 档不在这儿：它就是上面那套基础取值，写不写 data-variant 都长一个样 */
+  /* 整份有了一块面，条与条之间就不再靠那条相邻边分开 */
+  .xh-scope-accordion[data-part='root']:is([data-variant='outline'], [data-variant='subtle'])
+    > .xh-scope-accordion[data-part='item']
+    + .xh-scope-accordion[data-part='item'] {
+    border-block-start: 0;
+    border-inline-start: 0;
+  }
+
+  /* outline：一张静态内容面，--xh-border-default 描边 + surface 底 + 无影（边界只由描边承担）；
+     根的外边走 --xh-accordion-border，与条与条之间的分隔线槽 --xh-accordion-item-border 各管各的 */
+  .xh-scope-accordion[data-part='root'][data-variant='outline'] {
+    border: var(--xh-stroke-thin) solid var(--xh-accordion-border, var(--xh-border-default));
+    border-radius: var(--xh-accordion-item-radius, var(--xh-shape-surface));
+    background: var(--xh-accordion-item-bg, var(--xh-bg-surface));
+    box-shadow: var(--xh-accordion-item-shadow, none);
+    overflow: clip;
+  }
+
+  /* subtle：同一块连续表面，底换成淡底，描边让位给底色但留住 1px 边位（三档几何一致）；
+     淡底承载面向标题栏下发 hover 200 → pressed 300 */
+  .xh-scope-accordion[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: var(--xh-stroke-thin) solid transparent;
+    border-radius: var(--xh-accordion-item-radius, var(--xh-shape-surface));
+    background: var(--xh-accordion-item-bg, var(--xh-bg-subtle));
+    box-shadow: var(--xh-accordion-item-shadow, none);
+    overflow: clip;
+  }
+
+  .xh-scope-accordion[data-part='root']:is([data-variant='outline'], [data-variant='subtle'])
+    > .xh-scope-accordion[data-part='item']:not(:last-child)::after {
+    content: '';
+    position: absolute;
+    inset-inline: 0;
+    inset-block-end: 0;
+    block-size: var(--xh-stroke-thin);
+    background: var(--xh-accordion-item-border, var(--xh-border-default));
+    pointer-events: none;
+  }
+
+  .xh-scope-accordion[data-part='header'] {
+    margin: 0;
+    font: inherit;
+  }
+
+  /* 标题栏铺满一行，盒型、三档几何、悬停 / 按下 / 禁用面由 Action Control 的 disclosure-trigger 档给
+     （ghost 形态：白底承载 hover 100 → pressed 200，淡底容器由根下发 host 槽；按下只换面不缩放）；
+     这里只把使用者槽映射到桥接槽：字色三态同值（家族的 hover / pressed 字色规则比皮肤更特定，不映射会被换回
+     缺省字色），字形按标题栏自己的档位取 --xh-_action-profile-glyph-size；边归零贴住条目，几何与迁移前一致 */
+  .xh-scope-accordion[data-part='trigger'] {
+    --xh-action-gap: var(--xh-accordion-trigger-gap, var(--xh-_action-profile-gap));
+    --xh-action-visual-size: var(--xh-accordion-trigger-h, var(--xh-_action-profile-visual-size));
+    --xh-action-padding-block: var(--xh-accordion-trigger-py, var(--xh-_accordion-trigger-py));
+    --xh-action-padding-inline: var(--xh-accordion-trigger-px, var(--xh-_accordion-trigger-px));
+    --xh-action-radius: var(--xh-accordion-trigger-radius, var(--xh-_action-profile-radius));
+    --xh-action-bg-rest: var(--xh-accordion-trigger-bg, var(--xh-_action-variant-bg-rest));
+    --xh-action-bg-hover: var(--xh-accordion-trigger-bg-hover, var(--xh-_action-variant-bg-hover));
+    --xh-action-fg-rest: var(--xh-accordion-trigger-fg, var(--xh-_action-variant-fg-rest));
+    --xh-action-fg-hover: var(--xh-accordion-trigger-fg, var(--xh-_action-variant-fg-hover));
+    --xh-action-fg-pressed: var(--xh-accordion-trigger-fg, var(--xh-_action-variant-fg-pressed));
+    --xh-action-font-size: var(--xh-accordion-trigger-font-size, var(--xh-_action-profile-font-size));
+    --xh-icon-size: var(--xh-accordion-icon-size, var(--xh-glyph-size-sm));
+
+    border-width: 0;
+    font-weight: var(--xh-accordion-trigger-font-weight, var(--xh-text-label-weight));
+    line-height: var(--xh-leading-normal);
+  }
+
+  /* 展开态自带一个槽：与常态共用一个的话，作者一改常态字色，
+     展开那一档的语气高亮就跟着被抹平，再也分不开。悬停 / 按下的面与收起态同档（open 与家族 hover 同档中性） */
+  .xh-scope-accordion[data-part='trigger'][data-state='open'] {
+    --xh-action-fg-rest: var(--xh-accordion-trigger-fg-open, var(--xh-_accordion-open-fg));
+    --xh-action-fg-hover: var(--xh-accordion-trigger-fg-open, var(--xh-_accordion-open-fg));
+    --xh-action-fg-pressed: var(--xh-accordion-trigger-fg-open, var(--xh-_accordion-open-fg));
+
+    font-weight: var(--xh-accordion-trigger-font-weight-open, var(--xh-font-weight-medium));
+  }
+
+  /* 禁用条目走 aria-disabled，仍留在 Tab 序里，只是不可操作；前景换成禁用色，不靠 opacity 压暗
+     （家族按 data-disabled 给禁用面与指针，字色槽在这里保留优先） */
+  .xh-scope-accordion[data-part='trigger'][data-disabled] {
+    --xh-action-fg-disabled: var(--xh-accordion-trigger-fg-disabled, var(--xh-_action-variant-fg-disabled));
+  }
+
+  .xh-scope-accordion[data-part='indicator'] {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    flex: none;
+    color: var(--xh-accordion-indicator-fg, var(--xh-fg-subtle));
+    line-height: var(--xh-leading-none);
+  }
+
+  /* 指示器与正文同档转向：收起时取 collapse 档，展开时（下面的打开态）取 expand 档。
+     首帧就在的朝向直接呈现（data-instant），第一次开合起才转 */
+  .xh-scope-accordion[data-part='indicator']:not([data-instant]) {
+    transition: rotate var(--xh-motion-duration-collapse) var(--xh-motion-ease-enter-strong);
+  }
+
+  /* 没写内容就由皮肤画；作者往部件里塞了自己的图形，这条规则即不命中 */
+  .xh-scope-accordion[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-accordion[data-part='indicator'][data-state='open'] {
+    rotate: 180deg;
+  }
+
+  .xh-scope-accordion[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-accordion[data-part='content'] {
+    /* 行高与内缩同帧动的共享关键帧读这两条槽，两端内缩一起收放 */
+    --xh-_disclosure-pt: var(--xh-accordion-content-pt, var(--xh-_accordion-content-pt));
+    --xh-_disclosure-pb: var(--xh-accordion-content-pb, var(--xh-_accordion-content-pb));
+
+    display: grid;
+    grid-template-rows: 1fr;
+    overflow: clip;
+    padding-block-start: var(--xh-accordion-content-pt, var(--xh-_accordion-content-pt));
+    padding-block-end: var(--xh-accordion-content-pb, var(--xh-_accordion-content-pb));
+    padding-inline: var(--xh-accordion-content-px, var(--xh-_accordion-content-px));
+    /* 正文是标题栏下面一块淡底，与白底标题栏分出层次；淡底容器（subtle）本身已是这层底，正文不再叠一层 */
+    background: var(--xh-accordion-content-bg, var(--xh-bg-muted));
+    color: var(--xh-accordion-content-fg, var(--xh-fg-default));
+    font-size: var(--xh-accordion-content-font-size, var(--xh-text-body-size));
+    line-height: var(--xh-leading-normal);
+  }
+
+  .xh-scope-accordion[data-part='root'][data-variant='subtle'] .xh-scope-accordion[data-part='content'] {
+    background: var(--xh-accordion-content-bg, transparent);
+  }
+
+  /* 展开着的标题栏与正文之间一条分隔线，与条与条之间的线同色 */
+  .xh-scope-accordion[data-part='content'][data-state='open'] {
+    border-block-start: var(--xh-stroke-thin) solid
+      var(--xh-accordion-content-border, var(--xh-accordion-item-border, var(--xh-border-default)));
+  }
+
+  /* 展开与收起只在开合时播：首帧就在的展开 / 收起直接呈现（data-instant） */
+  .xh-scope-accordion[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-accordion[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-accordion[data-part='indicator']:empty::before {
+      forced-color-adjust: none;
+      background-color: ButtonText;
+    }
+
+    .xh-scope-accordion[data-part='trigger']:not([data-disabled]):not([data-loading]):is(:hover, :active, [data-pressed]) .xh-scope-accordion[data-part='indicator']:empty::before {
+      background-color: HighlightText;
+    }
+
+    .xh-scope-accordion[data-part='trigger'][data-disabled] .xh-scope-accordion[data-part='indicator']:empty::before {
+      background-color: GrayText;
+    }
+  }
+}
+
+@layer xihan.motion {
+  /* 声明过任何 display 就盖掉了 UA 的 [hidden]{display:none}，收起态得自己还回去。
+     写在文件末尾：兜底必须排在该部件所有 display 声明之后 */
+  .xh-scope-accordion[data-part='root'][hidden],
+  .xh-scope-accordion[data-part='trigger'][hidden],
+  .xh-scope-accordion[data-part='indicator'][hidden] {
+    display: none;
+  }
+}

package/dist/css/affix.css

@@ -0,0 +1,47 @@
+/*
+ * Copyright (c) 2021-Present XiHanFun and contributors.
+ * Licensed under the MIT License. See LICENSE in the project root for license information.
+ */
+
+/* 定义 affix 样式。 */
+
+@layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  .xh-scope-affix {
+    --xh-affix-skin: 1;
+  }
+
+  /* 占位盒就是 content 在常规流里占的那块地方。
+     这里不声明 display，也不写高度：吸住时冻结的高度由连接层量好写进内联样式（它量得到，样式表量不到），
+     没吸住时高度就该跟着内容走。不给 display，UA 的 [hidden]{display:none} 也仍然压得住 */
+  .xh-scope-affix[data-part='root'] {
+    /* 脱流后 content 不再撑开占位盒，宽度改从父级取 */
+    inline-size: 100%;
+  }
+
+  /* 没吸住时是常规流里普通的一块，不做任何定位 */
+  .xh-scope-affix[data-part='content'] {
+    inline-size: 100%;
+  }
+
+  /*
+   * 吸住：脱离常规流钉在视口上。
+   * 四个落位数（top / bottom / left / width）由连接层写成内联样式——它们是照占位盒的矩形实测出来的
+   * 物理量，换成逻辑属性会在 RTL 下贴反。这里只管「用哪种定位、压在第几层」。
+   * 另一件必须提防的事：fixed 认的是视口，祖先上一旦出现
+   * transform / filter / backdrop-filter / contain，包含块就被抢走，钉住的内容立刻贴错位置——
+   * 所以别往覆盖钩子里加这几个属性。
+   */
+  .xh-scope-affix[data-part='content'][data-fixed] {
+    position: fixed;
+    z-index: var(--xh-affix-layer, var(--xh-layer-sticky));
+  }
+
+  @media print {
+    /* 打印：钉住的是作者自己的内容，不能收起；但保持 fixed 会让部分打印引擎每页重复一次，
+       所以只把它放回正常流。 */
+    .xh-scope-affix[data-part='content'][data-fixed] {
+      position: static;
+    }
+  }
+}