@xihan-ui/styles 1.0.0-alpha.2 → 1.0.0-alpha.3

package/css/download-trigger.css

@@ -0,0 +1,76 @@
+@layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  [data-scope='download-trigger'] {
+    --xh-download-trigger-skin: 1;
+  }
+
+  /*
+   * 触发器就是这一个原生按钮，两个适配器都由组件自己渲染它，
+   * 所以外观得由设计系统给出一份完整的中性按钮：底色、描边、高度、字号都上令牌，
+   * 要换成品牌样式的作者改 --xh-download-trigger-* 这一族槽位，或直接写自己的类名。
+   */
+  [data-scope='download-trigger'][data-part='root'] {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    gap: var(--xh-download-trigger-gap, var(--xh-control-gap-md));
+    block-size: var(--xh-download-trigger-h, var(--xh-control-h-md));
+    padding-inline: var(--xh-download-trigger-px, var(--xh-control-px-md));
+    padding-block: 0;
+    border: var(--xh-stroke-thin) solid var(--xh-download-trigger-border, var(--xh-border-control));
+    border-radius: var(--xh-download-trigger-radius, var(--xh-shape-control));
+    background: var(--xh-download-trigger-bg, var(--xh-bg-canvas));
+    color: var(--xh-download-trigger-fg, var(--xh-fg-default));
+    /* 表单控件不继承页面字体，只给字号会让按钮用 UA 默认字族 */
+    font-family: inherit;
+    font-size: var(--xh-download-trigger-font-size, var(--xh-text-label-size));
+    font-weight: var(--xh-download-trigger-font-weight, var(--xh-text-label-weight));
+    line-height: var(--xh-leading-none);
+    white-space: nowrap;
+    cursor: pointer;
+    /* 导出键常被连点，触屏上默认会当成双击缩放 */
+    user-select: none;
+    touch-action: manipulation;
+    transition:
+      background var(--xh-motion-duration-micro) var(--xh-motion-ease-enter),
+      border-color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+  }
+
+  /* 上面声明了 display，会盖掉 UA 的 [hidden] 规则，收起态要在这里接回来 */
+  [data-scope='download-trigger'][data-part='root'][hidden] {
+    display: none;
+  }
+
+  [data-scope='download-trigger'][data-part='root']:hover {
+    border-color: var(--xh-download-trigger-border-hover, var(--xh-border-control-hover));
+    background: var(--xh-download-trigger-bg-hover, var(--xh-bg-subtle-hover));
+  }
+
+  [data-scope='download-trigger'][data-part='root']:active {
+    background: var(--xh-download-trigger-bg-active, var(--xh-bg-subtle-active));
+  }
+
+  [data-scope='download-trigger'][data-part='root']:focus-visible {
+    outline: var(--xh-ring-width) solid var(--xh-ring-focus);
+    outline-offset: var(--xh-ring-offset);
+  }
+
+  /* 取数在途：按钮留在原地不动，只换指针形状——位置一变，正要再点的人就点空了 */
+  [data-scope='download-trigger'][data-part='root'][data-state='preparing'] {
+    cursor: progress;
+  }
+
+  /*
+   * 单体原生控件的禁用走 :disabled。前景与底色一起换，禁用前后两侧都由令牌管着；
+   * 用了 fg-disabled 就不再叠 opacity——两样一起用会压到读不出来。
+   * 这条排在悬停与按下之后，特异度相同、后写的赢。
+   * 描边仍按可操作区那一档：这是一颗独立按钮，四周没有别的结构标出它的位置，
+   * 描边一压下去整颗按钮在页面上就没影了。
+   */
+  [data-scope='download-trigger'][data-part='root']:disabled {
+    border-color: var(--xh-download-trigger-border-disabled, var(--xh-border-control));
+    background: var(--xh-download-trigger-bg-disabled, var(--xh-bg-muted));
+    color: var(--xh-fg-disabled);
+    cursor: not-allowed;
+  }
+}

package/css/drawer.css

@@ -118,6 +118,9 @@
   /* root 留在页面原地，只是 data-side / data-state 的落点，不该凭空多出一层盒子把
      trigger 从作者的 flex / grid 行里挤出去，故 display: contents。 */
   [data-scope='drawer'][data-part='root'] {
+    /* 作者塞进指示符槽的图标跟着字号走，与皮肤画的兜底字形同一把尺 */
+    --xh-icon-size: var(--xh-drawer-icon-size, var(--xh-glyph-size-text));
+
     display: contents;
   }
 
@@ -177,10 +180,18 @@
   [data-scope='drawer'][data-part='backdrop'] {
     position: fixed;
     inset: 0;
-    z-index: var(--xh-layer-drawer);
+    z-index: var(--xh-drawer-backdrop-layer, var(--xh-layer-drawer));
     background: var(--xh-drawer-backdrop-bg, var(--xh-bg-overlay));
   }
 
+  /* 挂在局部容器里：遮罩与定位层从视口坐标换成容器坐标，只罩住那个容器。
+     作者要给那个容器加 position（relative 之类），否则 absolute 会往上找到别的定位祖先——
+     这一条写进了示例与 props 说明 */
+  [data-scope='drawer'][data-part='backdrop'][data-contained],
+  [data-scope='drawer'][data-part='positioner'][data-contained] {
+    position: absolute;
+  }
+
   [data-scope='drawer'][data-part='backdrop'][data-state='open'] {
     animation: xh-fade-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter);
   }
@@ -196,7 +207,7 @@
   [data-scope='drawer'][data-part='positioner'] {
     position: fixed;
     inset: 0;
-    z-index: var(--xh-layer-drawer);
+    z-index: var(--xh-drawer-layer, var(--xh-layer-drawer));
     pointer-events: none;
   }
 
@@ -212,18 +223,18 @@
     /* 尺寸档只换这一个私有槽：左右放置时它是面板宽度、上下放置时是面板高度，
        两种取法都在下面「四条边」那两条规则里。声明在 content 而不是 root：
        content 会被 portal 到 body，root 上的槽位继承不过来（data-side 也是同一个道理） */
-    --xh-_drawer-size: 20rem;
+    --xh-_drawer-size: var(--xh-overlay-drawer-w-md);
 
     position: fixed;
-    z-index: var(--xh-layer-drawer);
+    z-index: var(--xh-drawer-layer, var(--xh-layer-drawer));
     display: flex;
     flex-direction: column;
     gap: var(--xh-drawer-gap, var(--xh-stack-gap-md));
-    padding-block: var(--xh-drawer-py, var(--xh-section-py));
-    padding-inline: var(--xh-drawer-px, var(--xh-control-px-lg));
+    padding-block: var(--xh-drawer-py, var(--xh-surface-py-md));
+    padding-inline: var(--xh-drawer-px, var(--xh-surface-px-md));
     background: var(--xh-drawer-bg, var(--xh-bg-surface));
     color: var(--xh-drawer-fg, var(--xh-fg-default));
-    box-shadow: var(--xh-drawer-shadow, var(--xh-elevation-3));
+    box-shadow: var(--xh-drawer-shadow, var(--xh-elevation-sheet));
     overflow: auto;
     /* 尺寸是照视口那条边算出来的，padding 再往外顶就会把面板挤出屏幕、
        逼出一条横向滚动条。reset 层已有同款兜底，这里显式写一遍表明尺寸算法依赖它 */
@@ -254,11 +265,11 @@
   /* 只有面板厚度分档；中间档不写规则，缺省即中档。
      data-size 与 data-side 一样同时打在 root 与 content 上，这里只认 content 自己那一份。 */
   [data-scope='drawer'][data-part='content'][data-size='sm'] {
-    --xh-_drawer-size: 16rem;
+    --xh-_drawer-size: var(--xh-overlay-drawer-w-sm);
   }
 
   [data-scope='drawer'][data-part='content'][data-size='lg'] {
-    --xh-_drawer-size: 28rem;
+    --xh-_drawer-size: var(--xh-overlay-drawer-w-lg);
   }
 
   /* —— 四条边 ——
@@ -358,7 +369,7 @@
      否则长标题会直接钻到按钮底下。只在真有关闭按钮时让位。 */
   [data-scope='drawer'][data-part='content']:has([data-scope='drawer'][data-part='close-trigger'])
     [data-scope='drawer'][data-part='title'] {
-    padding-inline-end: calc(var(--xh-control-h-sm) + var(--xh-space-3));
+    padding-inline-end: calc(var(--xh-drawer-close-size, var(--xh-control-h-sm)) + var(--xh-space-3));
   }
 
   [data-scope='drawer'][data-part='close-trigger'] {
@@ -368,13 +379,16 @@
     display: inline-flex;
     align-items: center;
     justify-content: center;
-    block-size: var(--xh-control-h-sm);
-    inline-size: var(--xh-control-h-sm);
+    block-size: var(--xh-drawer-close-size, var(--xh-control-h-sm));
+    inline-size: var(--xh-drawer-close-size, var(--xh-control-h-sm));
     border: 0;
-    border-radius: var(--xh-shape-control);
+    border-radius: var(--xh-drawer-close-radius, var(--xh-shape-control));
     background: transparent;
     color: var(--xh-fg-muted);
     cursor: pointer;
+    transition:
+      background-color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter),
+      scale var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
   }
 
   [data-scope='drawer'][data-part='close-trigger'][hidden] {
@@ -382,12 +396,29 @@
   }
 
   [data-scope='drawer'][data-part='close-trigger']:hover {
-    background: var(--xh-bg-subtle);
+    background: var(--xh-drawer-close-bg-hover, var(--xh-bg-subtle-hover));
     color: var(--xh-fg-default);
   }
 
+  [data-scope='drawer'][data-part='close-trigger']:active {
+    background: var(--xh-drawer-close-bg-active, var(--xh-bg-subtle-active));
+    scale: var(--xh-motion-scale-press);
+  }
+
   [data-scope='drawer'][data-part='close-trigger']:focus-visible {
     outline: var(--xh-ring-width) solid var(--xh-ring-focus);
     outline-offset: var(--xh-ring-offset);
   }
+
+  /* 没写内容就由皮肤画兜底字形；作者往部件里塞了自己的图形，这几条即不命中 */
+  [data-scope='drawer'][data-part='close-trigger']:empty::before {
+    content: '';
+    display: inline-block;
+    inline-size: var(--xh-icon-size, var(--xh-glyph-size-text));
+    block-size: var(--xh-icon-size, var(--xh-glyph-size-text));
+    vertical-align: var(--xh-glyph-baseline-shift);
+    background-color: currentColor;
+    -webkit-mask: var(--xh-glyph-mark-close) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-close) center / contain no-repeat;
+  }
 }

package/css/dynamic-input.css

@@ -6,6 +6,9 @@
 
   /* 一行一条，纵向堆叠；新增把手跟在最后一行下面 */
   [data-scope='dynamic-input'][data-part='root'] {
+    /* 作者塞进指示符槽的图标跟着字号走，与皮肤画的兜底字形同一把尺 */
+    --xh-icon-size: var(--xh-dynamic-input-icon-size, var(--xh-glyph-size-text));
+
     display: flex;
     flex-direction: column;
     gap: var(--xh-dynamic-input-gap, var(--xh-space-2));
@@ -47,55 +50,69 @@
   }
 
   /* —— 行内三个把手 —— */
-  [data-scope='dynamic-input'][data-part='remove-trigger'],
+  [data-scope='dynamic-input'][data-part='item-delete-trigger'],
   [data-scope='dynamic-input'][data-part='move-up-trigger'],
   [data-scope='dynamic-input'][data-part='move-down-trigger'] {
     display: inline-flex;
     flex: none;
     align-items: center;
     justify-content: center;
-    inline-size: var(--xh-dynamic-input-trigger-size, var(--xh-control-action-size));
-    block-size: var(--xh-dynamic-input-trigger-size, var(--xh-control-action-size));
     padding: 0;
     border: 0;
-    border-radius: var(--xh-dynamic-input-trigger-radius, var(--xh-shape-control));
     background: var(--xh-dynamic-input-trigger-bg, transparent);
     color: var(--xh-dynamic-input-trigger-fg, var(--xh-fg-muted));
     font-family: inherit;
-    font-size: var(--xh-dynamic-input-trigger-font-size, var(--xh-font-size-sm));
+    font-size: var(--xh-dynamic-input-trigger-font-size, var(--xh-text-secondary-size));
     line-height: var(--xh-leading-none);
     cursor: pointer;
-    transition: background var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+    transition:
+      background var(--xh-motion-duration-micro) var(--xh-motion-ease-enter),
+      scale var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+  }
+
+  /* 行级删除把手：命中区取行内动作按钮尺寸，圆角取控件圆角 */
+  [data-scope='dynamic-input'][data-part='item-delete-trigger'] {
+    inline-size: var(--xh-dynamic-input-trigger-size, var(--xh-control-action-size));
+    block-size: var(--xh-dynamic-input-trigger-size, var(--xh-control-action-size));
+    border-radius: var(--xh-dynamic-input-trigger-radius, var(--xh-shape-control));
+  }
+
+  [data-scope='dynamic-input'][data-part='move-up-trigger'],
+  [data-scope='dynamic-input'][data-part='move-down-trigger'] {
+    inline-size: var(--xh-dynamic-input-trigger-size, var(--xh-control-action-size));
+    block-size: var(--xh-dynamic-input-trigger-size, var(--xh-control-action-size));
+    border-radius: var(--xh-dynamic-input-trigger-radius, var(--xh-shape-control));
   }
 
   /* 不换序时连接层给换序把手写 hidden；上面那条 display 会把 UA 的 [hidden]{display:none}
      盖掉，少了这条把手还留在原地。删除把手同样声明了 display，作者自己收起它时要的是同一条 */
-  [data-scope='dynamic-input'][data-part='remove-trigger'][hidden],
+  [data-scope='dynamic-input'][data-part='item-delete-trigger'][hidden],
   [data-scope='dynamic-input'][data-part='move-up-trigger'][hidden],
   [data-scope='dynamic-input'][data-part='move-down-trigger'][hidden] {
     display: none;
   }
 
   /* 按不动的把手不给悬停与按下反馈：它仍然可聚焦、可点，反馈会让人以为点得动 */
-  [data-scope='dynamic-input'][data-part='remove-trigger']:hover:not([aria-disabled='true']),
+  [data-scope='dynamic-input'][data-part='item-delete-trigger']:hover:not([aria-disabled='true']),
   [data-scope='dynamic-input'][data-part='move-up-trigger']:hover:not([aria-disabled='true']),
   [data-scope='dynamic-input'][data-part='move-down-trigger']:hover:not([aria-disabled='true']) {
     background: var(--xh-dynamic-input-trigger-bg-hover, var(--xh-bg-subtle-hover));
     color: var(--xh-dynamic-input-trigger-fg-hover, var(--xh-fg-default));
   }
 
-  [data-scope='dynamic-input'][data-part='remove-trigger']:active:not([aria-disabled='true']),
-  [data-scope='dynamic-input'][data-part='move-up-trigger']:active:not([aria-disabled='true']),
-  [data-scope='dynamic-input'][data-part='move-down-trigger']:active:not([aria-disabled='true']) {
+  [data-scope='dynamic-input'][data-part='item-delete-trigger']:not([aria-disabled='true']):active,
+  [data-scope='dynamic-input'][data-part='move-up-trigger']:not([aria-disabled='true']):active,
+  [data-scope='dynamic-input'][data-part='move-down-trigger']:not([aria-disabled='true']):active {
     background: var(--xh-dynamic-input-trigger-bg-active, var(--xh-bg-subtle-active));
+    scale: var(--xh-motion-scale-press);
   }
 
   /* 删除把手悬停转危险色：它是这一行里唯一不可撤销的动作 */
-  [data-scope='dynamic-input'][data-part='remove-trigger']:hover:not([aria-disabled='true']) {
-    color: var(--xh-dynamic-input-remove-fg-hover, var(--xh-fg-danger-hover));
+  [data-scope='dynamic-input'][data-part='item-delete-trigger']:hover:not([aria-disabled='true']) {
+    color: var(--xh-dynamic-input-item-delete-fg-hover, var(--xh-fg-danger-hover));
   }
 
-  [data-scope='dynamic-input'][data-part='remove-trigger']:focus-visible,
+  [data-scope='dynamic-input'][data-part='item-delete-trigger']:focus-visible,
   [data-scope='dynamic-input'][data-part='move-up-trigger']:focus-visible,
   [data-scope='dynamic-input'][data-part='move-down-trigger']:focus-visible {
     outline: var(--xh-ring-width) solid var(--xh-ring-focus);
@@ -104,7 +121,7 @@
 
   /* 到上下限、或整份禁用时用 aria-disabled 表达（原生 disabled 不派 click，禁用守卫走不到），
      所以样式也得认这个属性，写 :disabled 永远不命中 */
-  [data-scope='dynamic-input'][data-part='remove-trigger'][aria-disabled='true'],
+  [data-scope='dynamic-input'][data-part='item-delete-trigger'][aria-disabled='true'],
   [data-scope='dynamic-input'][data-part='move-up-trigger'][aria-disabled='true'],
   [data-scope='dynamic-input'][data-part='move-down-trigger'][aria-disabled='true'] {
     background: transparent;
@@ -144,7 +161,7 @@
     background: var(--xh-dynamic-input-add-bg-hover, var(--xh-bg-subtle-hover));
   }
 
-  [data-scope='dynamic-input'][data-part='add-trigger']:active:not([aria-disabled='true']) {
+  [data-scope='dynamic-input'][data-part='add-trigger']:not([aria-disabled='true']):active {
     background: var(--xh-dynamic-input-add-bg-active, var(--xh-bg-subtle-active));
   }
 
@@ -154,9 +171,43 @@
   }
 
   [data-scope='dynamic-input'][data-part='add-trigger'][aria-disabled='true'] {
-    border-color: var(--xh-border-subtle);
+    border-color: var(--xh-dynamic-input-add-border-disabled, var(--xh-border-subtle));
     background: transparent;
     color: var(--xh-fg-disabled);
     cursor: not-allowed;
   }
+
+  /* 没写内容就由皮肤画兜底字形；作者往部件里塞了自己的图形，这几条即不命中 */
+  [data-scope='dynamic-input'][data-part='move-up-trigger']:empty::before {
+    content: '';
+    display: inline-block;
+    inline-size: var(--xh-icon-size, var(--xh-glyph-size-text));
+    block-size: var(--xh-icon-size, var(--xh-glyph-size-text));
+    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;
+  }
+
+  [data-scope='dynamic-input'][data-part='move-down-trigger']:empty::before {
+    content: '';
+    display: inline-block;
+    inline-size: var(--xh-icon-size, var(--xh-glyph-size-text));
+    block-size: var(--xh-icon-size, var(--xh-glyph-size-text));
+    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;
+  }
+
+  [data-scope='dynamic-input'][data-part='item-delete-trigger']:empty::before {
+    content: '';
+    display: inline-block;
+    inline-size: var(--xh-icon-size, var(--xh-glyph-size-text));
+    block-size: var(--xh-icon-size, var(--xh-glyph-size-text));
+    vertical-align: var(--xh-glyph-baseline-shift);
+    background-color: currentColor;
+    -webkit-mask: var(--xh-glyph-mark-close) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-close) center / contain no-repeat;
+  }
 }

package/css/editable.css

@@ -34,8 +34,7 @@
     cursor: not-allowed;
   }
 
-  /* 预览区与输入框轮流上场，两者在同一处落脚：
-     area 定死最小宽高，切换形态时这一块不会忽大忽小地跳 */
+  /* 预览区与输入框轮流上场，两者在同一处落脚：area 给这一处定最小宽高 */
   [data-scope='editable'][data-part='area'] {
     display: inline-flex;
     align-items: center;
@@ -47,21 +46,23 @@
     display: none;
   }
 
-  /* 预览区的内边距与边框要和输入框对齐：只有描边是透明的，
-     否则从预览切到编辑时文字会左右挪一下 */
+  /* 预览区的高度、内边距与边框都和输入框取同一档，只有描边是透明的：
+     单行值定在控件档上，多行值才往下长 */
   [data-scope='editable'][data-part='preview'] {
-    display: inline-block;
+    display: inline-flex;
+    align-items: center;
     inline-size: 100%;
+    min-block-size: var(--xh-editable-preview-min-h, var(--xh-control-h-md));
     padding-inline: var(--xh-editable-preview-px, var(--xh-control-px-md));
     padding-block: 0;
     border: var(--xh-stroke-thin) solid transparent;
     border-radius: var(--xh-editable-preview-radius, var(--xh-shape-control));
     color: var(--xh-editable-preview-fg, var(--xh-fg-default));
     font-size: var(--xh-editable-preview-font-size, var(--xh-text-body-size));
-    line-height: var(--xh-editable-preview-line-height, var(--xh-control-h-md));
-    /* 值里的换行与连续空格照原样显示，但过长的行仍要能断开 */
+    line-height: var(--xh-leading-normal);
+    /* 值里的换行与连续空格照原样显示，过长的行断开而不撑破弹性行 */
     white-space: pre-wrap;
-    overflow-wrap: break-word;
+    overflow-wrap: anywhere;
   }
 
   /* 编辑态由连接层给 hidden；上面那条 display 会盖掉 UA 规则，少了这条就收不起来 */
@@ -140,12 +141,13 @@
   }
 
   [data-scope='editable'][data-part='input']:focus-visible {
+    border-color: var(--xh-editable-input-border-focus, var(--xh-_tone, var(--xh-border-control-focus)));
     outline: var(--xh-ring-width) solid var(--xh-ring-focus);
     outline-offset: var(--xh-ring-offset);
   }
 
   [data-scope='editable'][data-part='input'][data-invalid] {
-    border-color: var(--xh-editable-input-border-invalid, var(--xh-color-danger-500));
+    border-color: var(--xh-editable-input-border-invalid, var(--xh-border-invalid));
   }
 
   /* 只读仍可聚焦、可复制，不置灰，只把底色压下去表示"改不动" */
@@ -188,7 +190,7 @@
     background: var(--xh-editable-trigger-bg, var(--xh-bg-subtle));
     color: var(--xh-editable-trigger-fg, var(--xh-fg-default));
     font-family: inherit;
-    font-size: var(--xh-editable-trigger-font-size, var(--xh-font-size-sm));
+    font-size: var(--xh-editable-trigger-font-size, var(--xh-text-secondary-size));
     line-height: var(--xh-leading-none);
     white-space: nowrap;
     cursor: pointer;

package/css/ellipsis.css

@@ -27,7 +27,7 @@
   }
 
   /* 铺开：裁剪整个撤掉。写在两档之后，压得住上面同权重的那两条 */
-  [data-scope='ellipsis'][data-part='root'][data-expanded] {
+  [data-scope='ellipsis'][data-part='root'][data-state='open'] {
     display: block;
     overflow: visible;
     white-space: normal;

package/css/empty-state.css

@@ -9,8 +9,8 @@
        换档不必给每个部件各写一条选择器 */
     --xh-_empty-state-gap: var(--xh-stack-gap-md);
     --xh-_empty-state-py: var(--xh-section-py);
-    --xh-_empty-state-icon-size: 2.5rem;
-    --xh-_empty-state-title-size: var(--xh-font-size-lg);
+    --xh-_empty-state-icon-size: var(--xh-glyph-size-2xl);
+    --xh-_empty-state-title-size: var(--xh-control-font-lg);
     /* 说明的读行宽度：整句话不收窄就会拉成一条难读的长行 */
     --xh-_empty-state-measure: 32rem;
 
@@ -33,15 +33,15 @@
   [data-scope='empty-state'][data-part='root'][data-size='sm'] {
     --xh-_empty-state-gap: var(--xh-space-2);
     --xh-_empty-state-py: var(--xh-space-4);
-    --xh-_empty-state-icon-size: 2rem;
-    --xh-_empty-state-title-size: var(--xh-font-size-md);
+    --xh-_empty-state-icon-size: var(--xh-glyph-size-xl);
+    --xh-_empty-state-title-size: var(--xh-control-font-md);
   }
 
   [data-scope='empty-state'][data-part='root'][data-size='lg'] {
     --xh-_empty-state-gap: var(--xh-space-6);
     --xh-_empty-state-py: var(--xh-space-8);
-    --xh-_empty-state-icon-size: 3.5rem;
-    --xh-_empty-state-title-size: var(--xh-font-size-xl);
+    --xh-_empty-state-icon-size: var(--xh-glyph-size-3xl);
+    --xh-_empty-state-title-size: var(--xh-text-heading-3-size);
   }
 
   [data-scope='empty-state'][data-part='icon'] {
@@ -53,7 +53,7 @@
     inline-size: var(--xh-empty-state-icon-size, var(--xh-_empty-state-icon-size));
     color: var(--xh-empty-state-icon-fg, var(--xh-fg-subtle));
     /* 图标常是一个字形，字号跟着图标框走，line-height 不再另占高度 */
-    font-size: var(--xh-empty-state-icon-font-size, var(--xh-font-size-3xl));
+    font-size: var(--xh-empty-state-icon-font-size, var(--xh-text-heading-1-size));
     line-height: var(--xh-leading-none);
   }
 

package/css/field.css

@@ -22,8 +22,10 @@
   [data-scope='form'][data-part='root'][data-layout='horizontal'] [data-scope='field'][data-part='label'] {
     grid-column: 1;
     justify-self: end;
-    /* 与控件的首行文字对齐：按控件高度撑一行再居中 */
-    line-height: var(--xh-control-h-md);
+    /* 与控件的首行文字对齐：行高保持正文行距（标签折行时每行不会撑成一个控件高），
+       上下留白把单行文本盒撑到控件高度；配的是哪一档控件由 --xh-field-control-h 告诉它 */
+    line-height: var(--xh-field-label-leading, var(--xh-leading-normal));
+    padding-block: calc((var(--xh-field-control-h, var(--xh-control-h-md)) - 1lh) / 2);
   }
 
   [data-scope='form'][data-part='root'][data-layout='horizontal'][data-label-align='start'] [data-scope='field'][data-part='label'] {
@@ -47,7 +49,7 @@
 
   /* 必填星号：跟着根上的 data-required 亮，选填不标 */
   [data-scope='field'][data-part='root'][data-required] [data-part='label']::after {
-    content: '*';
+    content: var(--xh-glyph-mark-required);
     margin-inline-start: var(--xh-space-1);
     color: var(--xh-field-label-star, var(--xh-fg-danger));
   }
@@ -65,12 +67,13 @@
   }
 
   [data-scope='field'][data-part='control']:focus-visible {
+    border-color: var(--xh-field-control-border-focus, var(--xh-_tone, var(--xh-border-control-focus)));
     outline: var(--xh-ring-width) solid var(--xh-ring-focus);
     outline-offset: var(--xh-ring-offset);
   }
 
   [data-scope='field'][data-part='control'][data-invalid] {
-    border-color: var(--xh-field-control-border-invalid, var(--xh-color-danger-500));
+    border-color: var(--xh-field-control-border-invalid, var(--xh-border-invalid));
   }
 
   /* 禁用由作者在控件上落原生 disabled，样式统一走 data-disabled */
@@ -83,7 +86,7 @@
   [data-scope='field'][data-part='description'] {
     margin: 0;
     color: var(--xh-field-description-fg, var(--xh-fg-muted));
-    font-size: var(--xh-field-description-font-size, var(--xh-font-size-sm));
+    font-size: var(--xh-field-description-font-size, var(--xh-text-secondary-size));
     line-height: var(--xh-leading-normal);
   }
 
@@ -95,7 +98,7 @@
   [data-scope='field'][data-part='error-text'] {
     margin: 0;
     color: var(--xh-field-error-fg, var(--xh-fg-danger));
-    font-size: var(--xh-field-error-font-size, var(--xh-font-size-sm));
+    font-size: var(--xh-field-error-font-size, var(--xh-text-secondary-size));
     line-height: var(--xh-leading-normal);
   }
 }

package/css/fieldset.css

@@ -0,0 +1,69 @@
+@layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  [data-scope='fieldset'] {
+    --xh-fieldset-skin: 1;
+  }
+
+  /* 抹掉 UA 给 <fieldset> 的边框、内外边距与 min-content 下限，间距全部改由令牌给。
+     display 落在 fieldset 的匿名内容盒上：首个 <legend> 不在这个盒子里，
+     所以 gap 只作用于组内各块，legend 与内容之间的留白由 legend 自己的下外边距给。 */
+  [data-scope='fieldset'][data-part='root'] {
+    display: flex;
+    flex-direction: column;
+    gap: var(--xh-fieldset-gap, var(--xh-space-4));
+    margin: 0;
+    border: 0;
+    padding: 0;
+    min-inline-size: 0;
+  }
+
+  [data-scope='fieldset'][data-part='root'][hidden] {
+    display: none;
+  }
+
+  [data-scope='fieldset'][data-part='legend'] {
+    padding: 0;
+    margin-block-end: var(--xh-fieldset-legend-gap, var(--xh-space-2));
+    color: var(--xh-fieldset-legend-fg, var(--xh-fg-default));
+    font-size: var(--xh-fieldset-legend-font-size, var(--xh-text-label-size));
+    font-weight: var(--xh-fieldset-legend-font-weight, var(--xh-text-label-weight));
+    line-height: var(--xh-leading-tight);
+  }
+
+  /* 整组无效时组标题转警示色：没渲染错误文案的字段集上，这是屏幕上唯一变化的东西 */
+  [data-scope='fieldset'][data-part='root'][data-invalid] > [data-scope='fieldset'][data-part='legend'] {
+    color: var(--xh-fieldset-legend-fg-invalid, var(--xh-fg-danger));
+  }
+
+  /* 整组禁用时组标题跟着变淡；组内控件由原生 fieldset[disabled] 各自呈现禁用态。
+     选择器与上一条同权重且排在后面，禁用与无效同时为真时以禁用为准。 */
+  [data-scope='fieldset'][data-part='root'] > [data-scope='fieldset'][data-part='legend'][data-disabled] {
+    color: var(--xh-fieldset-legend-fg-disabled, var(--xh-fg-subtle));
+  }
+
+  /* 必填星号：跟着根上的 data-required 亮，选填不标 */
+  [data-scope='fieldset'][data-part='root'][data-required] > [data-scope='fieldset'][data-part='legend']::after {
+    content: var(--xh-glyph-mark-required);
+    margin-inline-start: var(--xh-space-1);
+    color: var(--xh-fieldset-legend-star, var(--xh-fg-danger));
+  }
+
+  [data-scope='fieldset'][data-part='helper-text'] {
+    margin: 0;
+    color: var(--xh-fieldset-helper-fg, var(--xh-fg-muted));
+    font-size: var(--xh-fieldset-helper-font-size, var(--xh-text-secondary-size));
+    line-height: var(--xh-leading-normal);
+  }
+
+  [data-scope='fieldset'][data-part='helper-text'][data-disabled] {
+    color: var(--xh-fieldset-helper-fg-disabled, var(--xh-fg-subtle));
+  }
+
+  /* 不 invalid 时节点带 hidden：此处不声明 display，交给浏览器的 [hidden] 规则收起 */
+  [data-scope='fieldset'][data-part='error-text'] {
+    margin: 0;
+    color: var(--xh-fieldset-error-fg, var(--xh-fg-danger));
+    font-size: var(--xh-fieldset-error-font-size, var(--xh-text-secondary-size));
+    line-height: var(--xh-leading-normal);
+  }
+}