@xihan-ui/styles 1.0.0-alpha.0

package/css/navigation-menu.css

@@ -0,0 +1,270 @@
+@layer xihan.motion {
+  /* 面板往下探一小截再落位：纯淡入看不出它是从哪条 trigger 长出来的 */
+  @keyframes xh-navigation-menu-in {
+    from {
+      opacity: 0;
+      translate: 0 -4px;
+    }
+
+    to {
+      opacity: 1;
+      translate: 0 0;
+    }
+  }
+}
+
+@layer xihan.components {
+  /* 根节点是 nav 地标，不参与排版；给 relative 是为了让共享外壳（viewport）有个定位参照系。
+     这里不给 display，UA 的 [hidden]{display:none} 就仍然压得住 */
+  [data-scope='navigation-menu'][data-part='root'] {
+    /* 尺寸档只换这五个私有槽，trigger 与面板里的链接都从 root 继承它们，
+       换档不必给每个部件各写一条选择器。面板与共享外壳都是 root 的后代，一并继承。
+       trigger 写的是 font: inherit，字号跟着 root 这一档走，不另立槽 */
+    --xh-_navigation-menu-font-size: var(--xh-text-label-size);
+    --xh-_navigation-menu-trigger-h: var(--xh-control-h-md);
+    --xh-_navigation-menu-trigger-px: var(--xh-control-px-md);
+    --xh-_navigation-menu-trigger-gap: var(--xh-control-gap-md);
+    --xh-_navigation-menu-link-p: var(--xh-space-2);
+    --xh-_navigation-menu-link-font-size: var(--xh-text-body-size);
+
+    /* 语气落在三处：条目的高亮底、展开着的 trigger 与当前链接的文字色、指示条。
+       没写 data-tone 时这几个 --xh-_tone-* 都没被声明，各自退回原来的取值。
+       聚焦环不在其列，它恒是 --xh-ring-focus */
+    --xh-_navigation-menu-highlight-bg: var(--xh-_tone-subtle-hover, var(--xh-bg-subtle-hover));
+    --xh-_navigation-menu-open-fg: var(--xh-_tone-fg, var(--xh-fg-default));
+    --xh-_navigation-menu-current-fg: var(--xh-_tone-fg, var(--xh-fg-brand));
+    --xh-_navigation-menu-accent: var(--xh-_tone, var(--xh-fg-brand));
+
+    position: relative;
+    color: var(--xh-navigation-menu-fg, var(--xh-fg-default));
+    font-size: var(--xh-navigation-menu-font-size, var(--xh-_navigation-menu-font-size));
+  }
+
+  /* —— 尺寸 —— */
+  /* 缺省档写在上面的基础规则里。链接的内边距不在控件内边距那把尺上（它比控件矮一档），
+     三档一律取空间尺，缺省档的取值原样保留 */
+  [data-scope='navigation-menu'][data-part='root'][data-size='sm'] {
+    --xh-_navigation-menu-font-size: var(--xh-font-size-sm);
+    --xh-_navigation-menu-trigger-h: var(--xh-control-h-sm);
+    --xh-_navigation-menu-trigger-px: var(--xh-control-px-sm);
+    --xh-_navigation-menu-trigger-gap: var(--xh-control-gap-sm);
+    --xh-_navigation-menu-link-p: var(--xh-space-1_5);
+    --xh-_navigation-menu-link-font-size: var(--xh-font-size-sm);
+  }
+
+  [data-scope='navigation-menu'][data-part='root'][data-size='lg'] {
+    --xh-_navigation-menu-font-size: var(--xh-font-size-lg);
+    --xh-_navigation-menu-trigger-h: var(--xh-control-h-lg);
+    --xh-_navigation-menu-trigger-px: var(--xh-control-px-lg);
+    --xh-_navigation-menu-trigger-gap: var(--xh-control-gap-lg);
+    --xh-_navigation-menu-link-p: var(--xh-space-3);
+    --xh-_navigation-menu-link-font-size: var(--xh-font-size-lg);
+  }
+
+  /* 指示条的定位参照系（它是 absolute，量出来的偏移就是相对这里的）。
+     ul 的项目符号与内外边距是 UA 给的，库里没有全局 preflight，只能在这儿自己抹平 */
+  [data-scope='navigation-menu'][data-part='list'] {
+    position: relative;
+    display: flex;
+    align-items: center;
+    gap: var(--xh-navigation-menu-gap, var(--xh-space-1));
+    margin: 0;
+    padding: 0;
+    list-style: none;
+  }
+
+  [data-scope='navigation-menu'][data-part='list'][hidden] {
+    display: none;
+  }
+
+  [data-scope='navigation-menu'][data-part='list'][data-orientation='vertical'] {
+    flex-direction: column;
+    align-items: stretch;
+  }
+
+  /* 一项一个 li，面板就住在里面：给 relative 让面板贴着自己这一项落位 */
+  [data-scope='navigation-menu'][data-part='item'] {
+    position: relative;
+    display: flex;
+    /* 库里没有全局 preflight，列表项的外边距在这里自己抹平 */
+    margin: 0;
+  }
+
+  [data-scope='navigation-menu'][data-part='item'][hidden] {
+    display: none;
+  }
+
+  [data-scope='navigation-menu'][data-part='trigger'] {
+    display: inline-flex;
+    align-items: center;
+    gap: var(--xh-navigation-menu-trigger-gap, var(--xh-_navigation-menu-trigger-gap));
+    block-size: var(--xh-navigation-menu-trigger-h, var(--xh-_navigation-menu-trigger-h));
+    padding-inline: var(--xh-navigation-menu-trigger-px, var(--xh-_navigation-menu-trigger-px));
+    border: 0;
+    border-radius: var(--xh-navigation-menu-trigger-radius, var(--xh-shape-control));
+    background: transparent;
+    color: var(--xh-navigation-menu-trigger-fg, var(--xh-fg-muted));
+    font: inherit;
+    font-weight: var(--xh-navigation-menu-trigger-font-weight, var(--xh-text-label-weight));
+    line-height: var(--xh-leading-none);
+    white-space: nowrap;
+    cursor: pointer;
+    transition: color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+  }
+
+  [data-scope='navigation-menu'][data-part='trigger'][hidden] {
+    display: none;
+  }
+
+  [data-scope='navigation-menu'][data-part='trigger']:hover {
+    background: var(--xh-navigation-menu-trigger-bg-hover, var(--xh-_navigation-menu-highlight-bg));
+  }
+
+  [data-scope='navigation-menu'][data-part='trigger']:focus-visible {
+    outline: var(--xh-ring-width) solid var(--xh-ring-focus);
+    outline-offset: var(--xh-ring-offset);
+  }
+
+  [data-scope='navigation-menu'][data-part='trigger'][data-state='open'] {
+    color: var(--xh-navigation-menu-trigger-fg-open, var(--xh-_navigation-menu-open-fg));
+  }
+
+  /* 集合条目用 data-disabled，不用 :disabled：它带的是 aria-disabled，
+     仍可聚焦、仍是方向键的起点 */
+  [data-scope='navigation-menu'][data-part='trigger'][data-disabled] {
+    color: var(--xh-fg-disabled);
+    cursor: not-allowed;
+  }
+
+  /* 竖排：入口占满整项的宽度，面板才从入口右缘长出来 */
+  [data-scope='navigation-menu'][data-part='trigger'][data-orientation='vertical'] {
+    flex: 1;
+  }
+
+  /* 面板贴着自己那一项落位：横排从 trigger 底下长出来 */
+  [data-scope='navigation-menu'][data-part='content'] {
+    position: absolute;
+    z-index: var(--xh-layer-popover);
+    inset-block-start: calc(100% + var(--xh-navigation-menu-content-offset, var(--xh-space-1)));
+    inset-inline-start: 0;
+    display: flex;
+    flex-direction: column;
+    gap: var(--xh-navigation-menu-content-gap, var(--xh-space-1));
+    min-inline-size: var(--xh-navigation-menu-content-min-w, var(--xh-overlay-min-w));
+    padding: var(--xh-navigation-menu-content-p, var(--xh-space-2));
+    border: var(--xh-stroke-thin) solid var(--xh-navigation-menu-content-border, var(--xh-border-default));
+    border-radius: var(--xh-navigation-menu-content-radius, var(--xh-shape-surface));
+    background: var(--xh-navigation-menu-content-bg, var(--xh-bg-surface));
+    box-shadow: var(--xh-navigation-menu-content-shadow, var(--xh-elevation-2));
+  }
+
+  /* display 会盖掉 hidden 属性的 UA 规则，收起态显式让位 */
+  [data-scope='navigation-menu'][data-part='content'][hidden] {
+    display: none;
+  }
+
+  /* 竖排导航：面板改从侧边长出来 */
+  [data-scope='navigation-menu'][data-part='content'][data-orientation='vertical'] {
+    inset-block-start: 0;
+    inset-inline-start: calc(100% + var(--xh-navigation-menu-content-offset, var(--xh-space-1)));
+  }
+
+  [data-scope='navigation-menu'][data-part='content'][data-state='open'] {
+    animation: xh-navigation-menu-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter);
+  }
+
+  /* 面板整批塞进共享外壳时，落位归外壳管，面板自己回到静态流里——
+     不还原的话它会以外壳为参照再往下掉一整个身位 */
+  [data-scope='navigation-menu'][data-part='viewport'] [data-scope='navigation-menu'][data-part='content'] {
+    position: static;
+    border: 0;
+    border-radius: 0;
+    background: transparent;
+    box-shadow: none;
+  }
+
+  [data-scope='navigation-menu'][data-part='link'] {
+    display: flex;
+    align-items: center;
+    padding-block: var(--xh-navigation-menu-link-py, var(--xh-_navigation-menu-link-p));
+    padding-inline: var(--xh-navigation-menu-link-px, var(--xh-_navigation-menu-link-p));
+    border-radius: var(--xh-navigation-menu-link-radius, var(--xh-shape-control));
+    color: var(--xh-navigation-menu-link-fg, var(--xh-fg-default));
+    font-size: var(--xh-navigation-menu-link-font-size, var(--xh-_navigation-menu-link-font-size));
+    text-decoration: none;
+  }
+
+  [data-scope='navigation-menu'][data-part='link'][hidden] {
+    display: none;
+  }
+
+  [data-scope='navigation-menu'][data-part='link']:hover {
+    background: var(--xh-navigation-menu-link-bg-hover, var(--xh-_navigation-menu-highlight-bg));
+  }
+
+  [data-scope='navigation-menu'][data-part='link']:focus-visible {
+    outline: var(--xh-ring-width) solid var(--xh-ring-focus);
+    outline-offset: var(--xh-ring-offset);
+  }
+
+  /* 指向当前页面的那一条：颜色与字重都变，不加下划线（下划线是"可点"的信号，它已经在这儿了） */
+  [data-scope='navigation-menu'][data-part='link'][data-current] {
+    color: var(--xh-navigation-menu-link-fg-current, var(--xh-_navigation-menu-current-fg));
+    font-weight: var(--xh-navigation-menu-link-font-weight-current, var(--xh-font-weight-medium));
+  }
+
+  /* 主轴上的位置与长度由连接层写成内联样式（它量得到，样式表量不到）；
+     这里只管交叉轴的贴边与粗细，以及长什么样 */
+  [data-scope='navigation-menu'][data-part='indicator'] {
+    position: absolute;
+    display: block;
+    /* 指示条也是列表项，宿主给 li 的外边距会把绝对定位的它推离入口 */
+    margin: 0;
+    inset-block-end: calc(var(--xh-navigation-menu-indicator-thickness, var(--xh-stroke-thick)) * -1);
+    block-size: var(--xh-navigation-menu-indicator-thickness, var(--xh-stroke-thick));
+    border-radius: var(--xh-navigation-menu-indicator-radius, var(--xh-radius-full));
+    background: var(--xh-navigation-menu-indicator-color, var(--xh-_navigation-menu-accent));
+    transition:
+      inset-inline-start var(--xh-motion-duration-enter) var(--xh-motion-ease-enter),
+      inline-size var(--xh-motion-duration-enter) var(--xh-motion-ease-enter);
+  }
+
+  [data-scope='navigation-menu'][data-part='indicator'][hidden] {
+    display: none;
+  }
+
+  /* 竖排：指示条改贴在起始缘，交叉轴换成内联轴 */
+  [data-scope='navigation-menu'][data-part='indicator'][data-orientation='vertical'] {
+    inset-block-end: auto;
+    inset-inline-start: 0;
+    inline-size: var(--xh-navigation-menu-indicator-thickness, var(--xh-stroke-thick));
+    block-size: auto;
+    transition:
+      inset-block-start var(--xh-motion-duration-enter) var(--xh-motion-ease-enter),
+      block-size var(--xh-motion-duration-enter) var(--xh-motion-ease-enter);
+  }
+
+  /* 共享面板外壳：只管落位与统一的面板外观，里面装哪一份内容归 content */
+  [data-scope='navigation-menu'][data-part='viewport'] {
+    position: absolute;
+    z-index: var(--xh-layer-popover);
+    inset-block-start: calc(100% + var(--xh-navigation-menu-content-offset, var(--xh-space-1)));
+    inset-inline-start: 0;
+    display: block;
+    padding: var(--xh-navigation-menu-content-p, var(--xh-space-2));
+    border: var(--xh-stroke-thin) solid var(--xh-navigation-menu-content-border, var(--xh-border-default));
+    border-radius: var(--xh-navigation-menu-content-radius, var(--xh-shape-surface));
+    background: var(--xh-navigation-menu-content-bg, var(--xh-bg-surface));
+    box-shadow: var(--xh-navigation-menu-content-shadow, var(--xh-elevation-2));
+  }
+
+  [data-scope='navigation-menu'][data-part='viewport'][hidden] {
+    display: none;
+  }
+
+  /* 竖排导航：共享外壳跟着面板改从侧边长出来 */
+  [data-scope='navigation-menu'][data-part='viewport'][data-orientation='vertical'] {
+    inset-block-start: 0;
+    inset-inline-start: calc(100% + var(--xh-navigation-menu-content-offset, var(--xh-space-1)));
+  }
+}

package/css/number-animation.css

@@ -0,0 +1,32 @@
+@layer xihan.components {
+  [data-scope='number-animation'][data-part='root'] {
+    /* 不写尺寸就跟着上下文的字号走：这个数常常摆在别人的标题、卡片标题或统计数值槽里，
+       自带一个字号只会跟摆放它的地方打架。三个档位各自换掉这个私有槽 */
+    --xh-_number-animation-size: inherit;
+
+    display: inline-block;
+    color: var(--xh-number-animation-fg, var(--xh-_tone-fg, var(--xh-fg-default)));
+    font-size: var(--xh-number-animation-font-size, var(--xh-_number-animation-size));
+    /* 等宽数字：逐位宽度一致，逐帧换数时后面的字符不会左右挪动，整块也不会一跳一跳地变宽 */
+    font-variant-numeric: tabular-nums;
+    line-height: var(--xh-leading-tight);
+  }
+
+  /* 上面声明了 display，会盖掉 UA 的 [hidden] 规则，收起态要在这里接回来 */
+  [data-scope='number-animation'][data-part='root'][hidden] {
+    display: none;
+  }
+
+  /* —— 尺寸 —— */
+  [data-scope='number-animation'][data-part='root'][data-size='sm'] {
+    --xh-_number-animation-size: var(--xh-font-size-lg);
+  }
+
+  [data-scope='number-animation'][data-part='root'][data-size='md'] {
+    --xh-_number-animation-size: var(--xh-font-size-2xl);
+  }
+
+  [data-scope='number-animation'][data-part='root'][data-size='lg'] {
+    --xh-_number-animation-size: var(--xh-font-size-3xl);
+  }
+}

package/css/number-field.css

@@ -0,0 +1,219 @@
+@layer xihan.components {
+  /* 与文本框同一套堆叠：标签一行、输入行一行。
+     加减钮与输入框中间那层包裹归作者，这里不碰，三者各自把高度对齐即可成一体 */
+  [data-scope='number-field'][data-part='root'] {
+    /* 尺寸档只换这几个私有槽，标题、输入框与加减钮都从 root 继承它们，
+       换档不必给每个部件各写一条选择器 */
+    --xh-_number-field-h: var(--xh-control-h-md);
+    --xh-_number-field-px: var(--xh-control-px-md);
+    --xh-_number-field-font-size: var(--xh-text-body-size);
+    --xh-_number-field-label-font-size: var(--xh-text-label-size);
+    --xh-_number-field-trigger-font-size: var(--xh-text-body-size);
+
+    /* 形态档只换这几个私有槽：输入框的底与描边，加减钮的底与描边 */
+    --xh-_number-field-bg: var(--xh-bg-canvas);
+    --xh-_number-field-border: var(--xh-border-default);
+    --xh-_number-field-border-hover: var(--xh-border-strong);
+    --xh-_number-field-trigger-bg: var(--xh-bg-subtle);
+    --xh-_number-field-trigger-bg-hover: var(--xh-bg-subtle-hover);
+    --xh-_number-field-trigger-bg-active: var(--xh-bg-subtle-active);
+    --xh-_number-field-trigger-border: var(--xh-border-default);
+    --xh-_number-field-trigger-border-hover: var(--xh-border-strong);
+
+    /* 语气只落在聚焦这一处：环与聚焦态描边。框里的数字不归它管。
+       没写 data-tone 时 --xh-_tone 没被声明，退回原来的聚焦环色与常态描边 */
+    --xh-_number-field-ring: var(--xh-ring-focus);
+    --xh-_number-field-border-focus: var(--xh-number-field-input-border, var(--xh-_tone, var(--xh-border-default)));
+
+    display: inline-flex;
+    flex-direction: column;
+    gap: var(--xh-number-field-gap, var(--xh-space-1));
+  }
+
+  /* 声明了 display 就盖掉了 UA 的 [hidden]{display:none}，收起态得自己还回去 */
+  [data-scope='number-field'][data-part='root'][hidden] {
+    display: none;
+  }
+
+  /* —— 尺寸 —— */
+  /* 缺省档写在上面的基础规则里 */
+  [data-scope='number-field'][data-part='root'][data-size='sm'] {
+    --xh-_number-field-h: var(--xh-control-h-sm);
+    --xh-_number-field-px: var(--xh-control-px-sm);
+    --xh-_number-field-font-size: var(--xh-font-size-sm);
+    --xh-_number-field-label-font-size: var(--xh-font-size-sm);
+    --xh-_number-field-trigger-font-size: var(--xh-font-size-sm);
+  }
+
+  [data-scope='number-field'][data-part='root'][data-size='lg'] {
+    --xh-_number-field-h: var(--xh-control-h-lg);
+    --xh-_number-field-px: var(--xh-control-px-lg);
+    --xh-_number-field-font-size: var(--xh-font-size-lg);
+    --xh-_number-field-label-font-size: var(--xh-font-size-lg);
+    --xh-_number-field-trigger-font-size: var(--xh-font-size-lg);
+  }
+
+  /* —— 形态 —— */
+  /* 形态只决定底与描边怎么画；用哪族颜色由 data-tone 决定。
+     输入框没有实心档：填满一个要往里打字的框，字与底就没法同时读 */
+  [data-scope='number-field'][data-part='root'][data-variant='outline'] {
+    --xh-_number-field-bg: var(--xh-bg-canvas);
+    --xh-_number-field-border: var(--xh-border-default);
+    --xh-_number-field-border-hover: var(--xh-border-strong);
+    --xh-_number-field-trigger-bg: var(--xh-bg-subtle);
+    --xh-_number-field-trigger-bg-hover: var(--xh-bg-subtle-hover);
+    --xh-_number-field-trigger-bg-active: var(--xh-bg-subtle-active);
+    --xh-_number-field-trigger-border: var(--xh-border-default);
+    --xh-_number-field-trigger-border-hover: var(--xh-border-strong);
+    --xh-_number-field-border-focus: var(--xh-number-field-input-border, var(--xh-_tone, var(--xh-border-default)));
+  }
+
+  /* 填充式：底色顶替描边表达边界。描边只退成透明而不去掉，1px 的位置留着，
+     与 outline 档并排时基线对得上、聚焦画描边也不引起跳动 */
+  [data-scope='number-field'][data-part='root'][data-variant='subtle'] {
+    --xh-_number-field-bg: var(--xh-_tone-subtle, var(--xh-bg-subtle));
+    --xh-_number-field-border: transparent;
+    --xh-_number-field-border-hover: var(--xh-_tone-border, var(--xh-border-default));
+    --xh-_number-field-trigger-bg: var(--xh-_tone-subtle, var(--xh-bg-subtle));
+    --xh-_number-field-trigger-bg-hover: var(--xh-_tone-subtle-hover, var(--xh-bg-subtle-hover));
+    --xh-_number-field-trigger-bg-active: var(--xh-_tone-subtle-active, var(--xh-bg-subtle-active));
+    --xh-_number-field-trigger-border: transparent;
+    --xh-_number-field-trigger-border-hover: var(--xh-_tone-border, var(--xh-border-default));
+    --xh-_number-field-border-focus: var(--xh-_tone, var(--xh-border-default));
+  }
+
+  /* 无框：底与描边都透明，平时只看得见数字，悬停与聚焦才浮出边界 */
+  [data-scope='number-field'][data-part='root'][data-variant='ghost'] {
+    --xh-_number-field-bg: transparent;
+    --xh-_number-field-border: transparent;
+    --xh-_number-field-border-hover: var(--xh-_tone-border, var(--xh-border-default));
+    --xh-_number-field-trigger-bg: transparent;
+    --xh-_number-field-trigger-bg-hover: var(--xh-_tone-subtle, var(--xh-bg-subtle-hover));
+    --xh-_number-field-trigger-bg-active: var(--xh-_tone-subtle-active, var(--xh-bg-subtle-active));
+    --xh-_number-field-trigger-border: transparent;
+    --xh-_number-field-trigger-border-hover: var(--xh-_tone-border, var(--xh-border-default));
+    --xh-_number-field-border-focus: var(--xh-_tone, var(--xh-border-default));
+  }
+
+  [data-scope='number-field'][data-part='label'] {
+    color: var(--xh-number-field-label-fg, var(--xh-fg-default));
+    font-size: var(--xh-number-field-label-font-size, var(--xh-_number-field-label-font-size));
+    font-weight: var(--xh-number-field-label-font-weight, var(--xh-text-label-weight));
+    line-height: var(--xh-leading-none);
+  }
+
+  [data-scope='number-field'][data-part='label'][data-disabled] {
+    color: var(--xh-number-field-label-fg-disabled, var(--xh-fg-subtle));
+  }
+
+  [data-scope='number-field'][data-part='input'] {
+    block-size: var(--xh-number-field-input-h, var(--xh-_number-field-h));
+    padding-inline: var(--xh-number-field-input-px, var(--xh-_number-field-px));
+    padding-block: 0;
+    border: var(--xh-stroke-thin) solid var(--xh-number-field-input-border, var(--xh-_number-field-border));
+    border-radius: var(--xh-number-field-input-radius, var(--xh-shape-control));
+    background: var(--xh-number-field-input-bg, var(--xh-_number-field-bg));
+    color: var(--xh-number-field-input-fg, var(--xh-fg-default));
+    /* 表单控件不继承页面字体，只给字号会让输入框用 UA 默认字族 */
+    font-family: inherit;
+    font-size: var(--xh-number-field-input-font-size, var(--xh-_number-field-font-size));
+    /* 等宽数字：按住加减钮连发时字宽一变，框里的数字就会左右抖 */
+    font-variant-numeric: tabular-nums;
+    line-height: var(--xh-leading-normal);
+    transition: border-color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+  }
+
+  [data-scope='number-field'][data-part='input']::placeholder {
+    color: var(--xh-number-field-placeholder-fg, var(--xh-fg-subtle));
+  }
+
+  /* hover 只在中性态换描边：invalid 正拿边框颜色说事，被 hover 盖掉那条信息就没了 */
+  [data-scope='number-field'][data-part='input']:hover:not(:disabled, [data-invalid]) {
+    border-color: var(--xh-number-field-input-border-hover, var(--xh-_number-field-border-hover));
+  }
+
+  /* 聚焦态描边与环共用一族语气色。这条特异度低于上面的 hover、也低于下面的 invalid，
+     两者仍按原来的次序赢过它 */
+  [data-scope='number-field'][data-part='input']:focus-visible {
+    border-color: var(--xh-number-field-input-border-focus, var(--xh-_number-field-border-focus));
+    outline: var(--xh-ring-width) solid var(--xh-_number-field-ring);
+    outline-offset: var(--xh-ring-offset);
+  }
+
+  [data-scope='number-field'][data-part='input'][data-invalid] {
+    border-color: var(--xh-number-field-input-border-invalid, var(--xh-color-danger-500));
+  }
+
+  /* 只读仍可聚焦、可复制，不置灰，只把底色压下去表示"改不动" */
+  [data-scope='number-field'][data-part='input'][readonly] {
+    background: var(--xh-number-field-input-bg-readonly, var(--xh-bg-subtle));
+  }
+
+  /* input 是单体表单控件，禁用走原生 disabled */
+  [data-scope='number-field'][data-part='input']:disabled {
+    background: var(--xh-number-field-input-bg-disabled, var(--xh-bg-subtle));
+    color: var(--xh-fg-disabled);
+    cursor: not-allowed;
+  }
+
+  /* 两个方向共用一份皮肤：加减钮是同一种东西，只是朝向不同，
+     分开写迟早会一边改了另一边忘了 */
+  [data-scope='number-field'][data-part='increment-trigger'],
+  [data-scope='number-field'][data-part='decrement-trigger'] {
+    display: inline-flex;
+    flex: none;
+    align-items: center;
+    justify-content: center;
+    inline-size: var(--xh-number-field-trigger-size, var(--xh-_number-field-h));
+    block-size: var(--xh-number-field-trigger-size, var(--xh-_number-field-h));
+    padding: 0;
+    border: var(--xh-stroke-thin) solid var(--xh-number-field-trigger-border, var(--xh-_number-field-trigger-border));
+    border-radius: var(--xh-number-field-trigger-radius, var(--xh-shape-control));
+    background: var(--xh-number-field-trigger-bg, var(--xh-_number-field-trigger-bg));
+    color: var(--xh-number-field-trigger-fg, var(--xh-fg-default));
+    font-family: inherit;
+    font-size: var(--xh-number-field-trigger-font-size, var(--xh-_number-field-trigger-font-size));
+    line-height: var(--xh-leading-none);
+    cursor: pointer;
+    /* 按住不放会连发，长按期间浏览器默认会去选中按钮里的符号、
+       触屏上还会当成双击缩放，两条都得先掐掉 */
+    user-select: none;
+    touch-action: manipulation;
+    transition: background var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+  }
+
+  /* 上面给了 display，UA 的 [hidden]{display:none} 已被盖掉，这里补回来 */
+  [data-scope='number-field'][data-part='increment-trigger'][hidden],
+  [data-scope='number-field'][data-part='decrement-trigger'][hidden] {
+    display: none;
+  }
+
+  [data-scope='number-field'][data-part='increment-trigger']:hover:not(:disabled),
+  [data-scope='number-field'][data-part='decrement-trigger']:hover:not(:disabled) {
+    border-color: var(--xh-number-field-trigger-border-hover, var(--xh-_number-field-trigger-border-hover));
+    background: var(--xh-number-field-trigger-bg-hover, var(--xh-_number-field-trigger-bg-hover));
+  }
+
+  /* 连发期间按钮一直是按下态：:active 在指针没松开时始终成立，正好对上 */
+  [data-scope='number-field'][data-part='increment-trigger']:active:not(:disabled),
+  [data-scope='number-field'][data-part='decrement-trigger']:active:not(:disabled) {
+    background: var(--xh-number-field-trigger-bg-active, var(--xh-_number-field-trigger-bg-active));
+  }
+
+  /* 按钮不占 Tab 位（tabindex=-1），留这条是给程序化聚焦兜底 */
+  [data-scope='number-field'][data-part='increment-trigger']:focus-visible,
+  [data-scope='number-field'][data-part='decrement-trigger']:focus-visible {
+    outline: var(--xh-ring-width) solid var(--xh-_number-field-ring);
+    outline-offset: var(--xh-ring-offset);
+  }
+
+  /* 贴到 min / max 时连接层给对应那一侧落原生 disabled：单体控件用 :disabled，
+     不是集合条目那套 aria-disabled */
+  [data-scope='number-field'][data-part='increment-trigger']:disabled,
+  [data-scope='number-field'][data-part='decrement-trigger']:disabled {
+    border-color: var(--xh-number-field-trigger-border-disabled, var(--xh-border-subtle));
+    background: var(--xh-number-field-trigger-bg-disabled, var(--xh-bg-muted));
+    color: var(--xh-fg-disabled);
+    cursor: not-allowed;
+  }
+}

package/css/page-header.css

@@ -0,0 +1,85 @@
+@layer xihan.components {
+  [data-scope='page-header'][data-part='root'] {
+    /* 尺寸档只换这三个私有槽，各段从根上继承它们，换档不必给每个部件各写一条选择器 */
+    --xh-_page-header-py: var(--xh-space-4);
+    --xh-_page-header-row-gap: var(--xh-space-2);
+    --xh-_page-header-title-size: var(--xh-font-size-xl);
+
+    /* 一行排不下就折行；返回位、标题、副标题排在同一行，操作贴到行尾，页脚整行另起 */
+    display: flex;
+    flex-wrap: wrap;
+    align-items: center;
+    column-gap: var(--xh-page-header-column-gap, var(--xh-space-3));
+    row-gap: var(--xh-page-header-row-gap, var(--xh-_page-header-row-gap));
+    padding-block: var(--xh-page-header-py, var(--xh-_page-header-py));
+    color: var(--xh-page-header-fg, var(--xh-fg-default));
+  }
+
+  /* 上面声明了 display，会盖掉 UA 的 [hidden] 规则，收起态要在这里接回来 */
+  [data-scope='page-header'][data-part='root'][hidden] {
+    display: none;
+  }
+
+  /* —— 尺寸 —— */
+  [data-scope='page-header'][data-part='root'][data-size='sm'] {
+    --xh-_page-header-py: var(--xh-space-3);
+    --xh-_page-header-row-gap: var(--xh-space-1);
+    --xh-_page-header-title-size: var(--xh-font-size-lg);
+  }
+
+  [data-scope='page-header'][data-part='root'][data-size='lg'] {
+    --xh-_page-header-py: var(--xh-space-6);
+    --xh-_page-header-row-gap: var(--xh-space-3);
+    --xh-_page-header-title-size: var(--xh-font-size-2xl);
+  }
+
+  /* —— 分隔线 —— */
+  [data-scope='page-header'][data-part='root'][data-bordered] {
+    border-block-end: var(--xh-stroke-thin) solid var(--xh-page-header-border, var(--xh-border-subtle));
+  }
+
+  /* —— 各段 —— */
+  /* 返回位只摆位置与对齐，外观归作者自己的按钮 */
+  [data-scope='page-header'][data-part='back-trigger'] {
+    display: inline-flex;
+    flex: none;
+    align-items: center;
+    justify-content: center;
+  }
+
+  [data-scope='page-header'][data-part='title'] {
+    margin: 0;
+    flex: none;
+    color: var(--xh-page-header-title-fg, var(--xh-fg-default));
+    font-size: var(--xh-page-header-title-font-size, var(--xh-_page-header-title-size));
+    font-weight: var(--xh-page-header-title-font-weight, var(--xh-font-weight-semibold));
+    line-height: var(--xh-leading-tight);
+  }
+
+  /* 副标题吃掉标题与操作之间的剩余宽度，长文本在这里收窄换行 */
+  [data-scope='page-header'][data-part='subtitle'] {
+    margin: 0;
+    flex: 1 1 auto;
+    min-inline-size: 0;
+    color: var(--xh-page-header-subtitle-fg, var(--xh-fg-muted));
+    font-size: var(--xh-page-header-subtitle-font-size, var(--xh-font-size-sm));
+    line-height: var(--xh-leading-normal);
+  }
+
+  /* 操作区贴到行尾，没有副标题占位时也一样靠边 */
+  [data-scope='page-header'][data-part='extra'] {
+    display: flex;
+    flex-wrap: wrap;
+    align-items: center;
+    gap: var(--xh-page-header-extra-gap, var(--xh-space-2));
+    margin-inline-start: auto;
+  }
+
+  /* 页脚占满一整行，前面有内容时自然被挤到下一行 */
+  [data-scope='page-header'][data-part='footer'] {
+    flex: 1 0 100%;
+    color: var(--xh-page-header-footer-fg, var(--xh-fg-muted));
+    font-size: var(--xh-page-header-footer-font-size, var(--xh-font-size-sm));
+    line-height: var(--xh-leading-normal);
+  }
+}