@xihan-ui/styles 2.0.0 → 2.1.0

package/css/clipboard.css

@@ -138,7 +138,7 @@
     border-end-end-radius: 0;
   }
 
-  /* 焦点边一律 --xh-border-control-focus，不随 tone（§7.2 第 5 条） */
+  /* 焦点边一律 --xh-border-control-focus，不随 tone */
   [data-scope='clipboard'][data-part='input']:focus-visible {
     border-color: var(--xh-clipboard-input-border-focus, var(--xh-border-control-focus));
   }
@@ -159,7 +159,7 @@
     -webkit-text-fill-color: var(--xh-clipboard-input-autofill-fg, var(--xh-fg-default));
   }
 
-  /* 复制钮是定尺的独立动作按钮（§9.1）：盒型、四态面、0.97 按压与粗指针命中区由家族配方给出，
+  /* 复制钮是定尺的独立动作按钮：盒型、四态面、0.97 按压与粗指针命中区由家族配方给出，
      这里只把公开槽桥接到矩阵之前（使用者槽 → 形态矩阵 → 家族缺省）与几何槽映射。
      叠格布局要保留：两侧指示器叠在同一格，切换时不抖宽度 */
   [data-scope='clipboard'][data-part='copy-trigger'] {
@@ -179,7 +179,7 @@
     --xh-action-border-pressed: var(--xh-clipboard-copy-trigger-border-hover, var(--xh-_action-variant-border-pressed));
     --xh-action-border-focus-visible: var(--xh-clipboard-copy-trigger-border, var(--xh-_action-variant-border-focus-visible));
     --xh-action-border-disabled: var(--xh-clipboard-copy-trigger-border-disabled, var(--xh-_action-variant-border-disabled));
-    /* 矩阵各态无影（§8.3 淡底与阴影互斥）：solid 也不再悬停抬影，使用者槽仍可自行加 */
+    /* 矩阵各态无影（淡底与阴影互斥）：solid 也不再悬停抬影，使用者槽仍可自行加 */
     --xh-action-shadow-hover: var(--xh-clipboard-copy-trigger-shadow-hover, none);
     --xh-action-radius: var(--xh-clipboard-copy-trigger-radius, var(--xh-shape-control));
     --xh-action-visual-size: var(--xh-clipboard-copy-trigger-h, var(--xh-_clipboard-h));
@@ -245,7 +245,7 @@
     margin: auto;
     border: var(--xh-stroke-thin) solid transparent;
     border-block-start-color: currentColor;
-    /* 正圆的加载环：正方盒取 circle（§6.3） */
+    /* 正圆的加载环：正方盒取 circle */
     border-radius: var(--xh-shape-circle);
     opacity: 0;
     animation:

package/css/code-view.css

@@ -14,7 +14,7 @@
     --xh-code-view-skin: 1;
   }
 
-  /* 一张静态内容面：--xh-border-default 描边 + surface 底 + 无影（§5.3 边界只由描边承担），
+  /* 一张静态内容面：--xh-border-default 描边 + surface 底 + 无影（边界只由描边承担），
      overflow: hidden 让内部 <pre> 的滚动内容沿圆角收边；不设 display，排布由作者决定。
      color 给整段未着色的代码定基线，字号在这里消费一次，缺省即 sm 档。 */
   [data-scope='code-view'][data-part='root'] {
@@ -202,7 +202,7 @@
   }
 
   /* 折叠条是铺满一行的 disclosure trigger，盒型、悬停与按下面由 Action Control 的 disclosure-trigger 档给
-     （ghost 形态：白底承载 hover 100 → pressed 200，按下只换面不缩放，§9.2）；这里只把使用者槽映射到
+     （ghost 形态：白底承载 hover 100 → pressed 200，按下只换面不缩放）；这里只把使用者槽映射到
      桥接槽：圆角归零贴住卡边，内衬沿用代码区的横向内距与折叠条自己的纵向内距，字号与头部条同档。
      顶边是与头部条同一支的内部分隔线：配方按状态写 border-color 简写，四个状态的边色槽都映射到
      这支分隔色，再把四边宽归零、只留顶边一条 */

package/css/collapsible.css

@@ -19,7 +19,7 @@
   /* 根容器自己不排版，这条只声明尺寸档的私有槽：正文与标题行从 root 继承它们，
      换档不必给部件各写一条选择器；触发器的三档几何由家族 disclosure-trigger 档给 */
   [data-scope='collapsible'][data-part='root'] {
-    /* 作者塞进正文里的图标与皮肤画的兜底字形同一把尺：md 档（§6.5），触发器上另按家族档取值 */
+    /* 作者塞进正文里的图标与皮肤画的兜底字形同一把尺：md 档，触发器上另按家族档取值 */
     --xh-icon-size: var(--xh-collapsible-icon-size, var(--xh-glyph-size-md));
 
     --xh-_collapsible-trigger-gap: var(--xh-control-gap-md);
@@ -59,7 +59,7 @@
   }
 
   /* 触发器铺满一行，盒型、三档几何、悬停 / 按下 / 禁用面由 Action Control 的 disclosure-trigger 档给
-     （ghost 形态：根无壳，按画布承载 hover 100 → pressed 200；按下只换面不缩放，§9.2）；
+     （ghost 形态：根无壳，按画布承载 hover 100 → pressed 200；按下只换面不缩放）；
      这里只把使用者槽映射到桥接槽：字色三态同值（家族的 hover / pressed 字色规则比皮肤更特定，不映射会被换回
      缺省字色），字形按触发器自己的档位取 --xh-_action-profile-glyph-size；边归零贴住标题行，几何与迁移前一致 */
   [data-scope='collapsible'][data-part='trigger'] {
@@ -81,7 +81,7 @@
   }
 
   /* 展开着的那一档单开一个槽：与常态共用一个的话，作者一改常态字色就把展开态也改掉了。
-     悬停 / 按下的面与收起态同档（§7.3 open 与家族 hover 同档中性） */
+     悬停 / 按下的面与收起态同档（open 与家族 hover 同档中性） */
   [data-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));
@@ -101,7 +101,7 @@
     justify-content: center;
     color: var(--xh-collapsible-indicator-fg, var(--xh-fg-muted));
     line-height: var(--xh-leading-none);
-    /* 指示器与正文同档转向（§9.4）：正文 enter 档展开，箭头也用同一段时长翻过去 */
+    /* 指示器与正文同档转向：正文 enter 档展开，箭头也用同一段时长翻过去 */
     transition: rotate var(--xh-motion-duration-enter) var(--xh-motion-ease-enter-strong);
   }
 

package/css/color-picker.css

@@ -217,9 +217,9 @@
     padding-inline: var(--xh-color-picker-content-px, var(--xh-space-3));
     max-block-size: min(var(--xh-color-picker-max-h, var(--xh-viewport-h-md)), var(--xh-_color-picker-available-h));
     overflow-y: auto;
-    /* 浮层滚动面：滚到头不把页面一起带走（§6.6） */
+    /* 浮层滚动面：滚到头不把页面一起带走 */
     overscroll-behavior: contain;
-    /* 面域 + 滑杆 + 通道输入的表单型多列面板，走 floating 材质（§8.4）——实体底 + --xh-border-default 描边 +
+    /* 面域 + 滑杆 + 通道输入的表单型多列面板，走 floating 材质——实体底 + --xh-border-default 描边 +
        --xh-elevation-floating 落影，不透景、不画顶部边界光 */
     border: var(--xh-stroke-thin) solid var(--xh-color-picker-content-border, var(--xh-border-default));
     border-radius: var(--xh-color-picker-content-radius, var(--xh-shape-overlay));
@@ -229,9 +229,7 @@
     pointer-events: auto;
   }
 
-  /* 在场那一档才提前备好合成层：属性随 data-state 一起消失，收起后不长期占着 */
   [data-scope='color-picker'][data-part='content'][data-state='open'] {
-    will-change: opacity, translate;
     animation: xh-overlay-slide-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter-strong);
   }
 

package/css/color-slider.css

@@ -23,7 +23,7 @@
 
     display: flex;
     flex-direction: column;
-    /* 字段标签贴控件（§6.4 复合单字段） */
+    /* 字段标签贴控件（复合单字段） */
     gap: var(--xh-color-slider-gap, var(--xh-space-1));
   }
 
@@ -33,10 +33,10 @@
     align-items: center;
   }
 
-  /* 禁用不整体压暗（§7.2 第 9 条）：标签是文字，换到禁用前景；颜色带与拇指画的是颜色本身，换不得色，
+  /* 禁用不整体压暗：标签是文字，换到禁用前景；颜色带与拇指画的是颜色本身，换不得色，
      压暗只做一次、落在 control 上（track / thumb 各自再叠一层 opacity 会越叠越黑），拇指另收掉抬升 */
 
-  /* 字段标签：14 / 500 / fg-default（§6.4），禁用换到 --xh-fg-subtle */
+  /* 字段标签：14 / 500 / fg-default，禁用换到 --xh-fg-subtle */
   [data-scope='color-slider'][data-part='label'] {
     color: var(--xh-color-slider-label-fg, var(--xh-fg-default));
     font-size: var(--xh-color-slider-label-font-size, var(--xh-text-label-size));
@@ -122,7 +122,7 @@
   }
 
   /* 圆点浮在轨道之上：轨道是流内的，拇指是绝对定位的，天然后来居上。
-     拇指填的是当前那一档的颜色（连接层写进私有槽），拇指是可拖起的 raised 面（§8）：
+     拇指填的是当前那一档的颜色（连接层写进私有槽），拇指是可拖起的 raised 面：
      --xh-border-default 描边把它从任何底色里框出来，raised 影只是加成、不作边界。
      box-sizing 必须显式写：描边要吃进直径里，否则下面按半个直径回拉的负外边距就对不上圆心。 */
   [data-scope='color-slider'][data-part='thumb'] {

package/css/color-swatch-picker.css

@@ -51,7 +51,7 @@
     --xh-_color-swatch-picker-indicator: var(--xh-control-indicator-lg);
   }
 
-  /* 标题独占一行，格子从下一行起排。复合单字段的标签（§6.4）：14 / 500 / fg-default，不随档；
+  /* 标题独占一行，格子从下一行起排。复合单字段的标签：14 / 500 / fg-default，不随档；
      与格子的距离贴控件 space-1——容器的 gap 归格子之间，标签在它之上补一段差值把距离收成目标值 */
   [data-scope='color-swatch-picker'][data-part='label'] {
     flex-basis: 100%;
@@ -80,7 +80,7 @@
     flex: none;
     inline-size: var(--xh-color-swatch-picker-item-size, var(--xh-_color-swatch-picker-cell));
     block-size: var(--xh-color-swatch-picker-item-size, var(--xh-_color-swatch-picker-cell));
-    /* 色块 item 的身份是 inset（§6.3：嵌在 control 内的小块） */
+    /* 色块 item 的身份是 inset（嵌在 control 内的小块） */
     border-radius: var(--xh-color-swatch-picker-item-radius, var(--xh-shape-inset));
     outline: none;
     cursor: pointer;
@@ -88,12 +88,12 @@
   }
 
   /* 指到哪一格：描边换到控件的悬停边（border-strong 只留给 contrast-more 与登记的强调边）；
-     选中的那一格保留自己的品牌描边（§9.3 选中身份不被悬停盖掉） */
+     选中的那一格保留自己的品牌描边（选中身份不被悬停盖掉） */
   [data-scope='color-swatch-picker'][data-part='item']:not([data-disabled], [data-readonly], [data-state='checked']):hover {
     --xh-_color-swatch-picker-edge: var(--xh-color-swatch-picker-swatch-border-hover, var(--xh-border-control-hover));
   }
 
-  /* 这一格的底色就是它要展示的那个颜色，换底等于把展示物盖掉（§9.1 的「同时换底」在这里落不下去），
+  /* 这一格的底色就是它要展示的那个颜色，换底等于把展示物盖掉（的「同时换底」在这里落不下去），
      交互回执只能落在别处：按下去看下压，描边同时换到品牌色作第二通道（按住即将选中的那一格）。
      置灰与只读的都不压；指针 :active 与 Headless 投影的 data-pressed 看见同一副按压面 */
   [data-scope='color-swatch-picker'][data-part='item']:not([data-disabled], [data-readonly]):is(:active, [data-pressed]) {
@@ -162,7 +162,7 @@
     inline-size: var(--xh-color-swatch-picker-indicator-size, var(--xh-_color-swatch-picker-indicator));
     block-size: var(--xh-color-swatch-picker-indicator-size, var(--xh-_color-swatch-picker-indicator));
     border: var(--xh-stroke-thin) solid var(--xh-color-swatch-picker-indicator-border, var(--xh-bg-canvas));
-    /* 正方盒取 circle（§6.3：宽高同槽的盒不得用 pill 冒充圆） */
+    /* 正方盒取 circle（宽高同槽的盒不得用 pill 冒充圆） */
     border-radius: var(--xh-shape-circle);
     background: var(--xh-color-swatch-picker-indicator-bg, var(--xh-_color-swatch-picker-accent));
     opacity: 0;

package/css/combobox.css

@@ -85,7 +85,7 @@
 
     /* 作者塞进指示符槽的图标跟着控件的尺寸档走；它自己写了 size 时仍以作者的为准。
        浮层条目里自绘的状态字形（勾选标记所在的标记盒与盒里的勾）不读这支：它们是指示符，走
-       --xh-control-indicator-* 一族——标记盒在自己身上把 --xh-icon-size 改接到盒的尺（§6.5） */
+       --xh-control-indicator-* 一族——标记盒在自己身上把 --xh-icon-size 改接到盒的尺 */
     --xh-icon-size: var(--xh-combobox-icon-size, var(--xh-glyph-size-md));
 
     /* 语气只落在勾选标记上，单选与多选正文使用同一颜色。 */
@@ -323,8 +323,6 @@
 
   [data-scope='combobox'][data-part='content'][data-state='open'] {
     animation: xh-overlay-slide-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter-strong);
-    /* 只在开着的这一档挂：合成层随 data-state 一起收走，收起后不再占着 */
-    will-change: opacity, translate;
   }
 
   /* 退场：收起那一帧 hidden 由退场闸门押后，这里才播得出来。forwards 把末态钉住，
@@ -425,7 +423,7 @@
 
   /* 勾选标记落在家族网格的 indicator 列，只在选中项上显形（家族按 aria-selected / data-state=checked 给）；
      未选中时占位不塌，切换选中不引起行宽抖动。
-     盒与盒里的勾是指示符（§6.5）：盒按指示符档取尺，并在自己身上把 --xh-icon-size 改接到盒的尺，皮肤画的
+     盒与盒里的勾是指示符：盒按指示符档取尺，并在自己身上把 --xh-icon-size 改接到盒的尺，皮肤画的
      兜底勾与作者塞进盒里的 XhIcon 读同一把尺、与盒同边长（勾选标记不是勾选格，不取 × 0.75，与 Select /
      Listbox / Menu 族同口径）；不读 root / positioner 按档下发的 --xh-icon-size——那支只管作者放进条目里的
      图标，按图标档取的 20px 比 16 / 14 的指示符档大一圈 */

package/css/command.css

@@ -19,7 +19,7 @@
      谁先命中谁给出这一档的取值；条目、检索框与提示条都从面板继承下去 */
   [data-scope='command']:is([data-part='positioner'], [data-part='content']) {
     /* 条目外的字形（分组标题、底部提示条）按档取尺，缺省 md，随 data-size 换档；命令里的图标由家族随
-       data-xh-collection-size 下发（§6.5） */
+       data-xh-collection-size 下发 */
     --xh-icon-size: var(--xh-command-icon-size, var(--xh-glyph-size-md));
 
     /* 尺寸档只换这六个私有槽，换档不必给每个部件各写一条选择器 */
@@ -118,7 +118,7 @@
     max-inline-size: var(--xh-command-max-w, var(--xh-_command-max-w));
     /* 封顶才有可滚的余量：不封顶结果列表会一路撑到视口外，滚动条永远出不来 */
     max-block-size: var(--xh-command-max-h, var(--xh-overlay-max-h));
-    /* 模态命令面板与 Dialog 同档：overlay 圆角 + sheet 三件套（material-elevated 的边 / 底 / 影，§8.4），
+    /* 模态命令面板与 Dialog 同档：overlay 圆角 + sheet 三件套（material-elevated 的边 / 底 / 影），
        边界由描边承担，不再只靠落影 */
     border: var(--xh-stroke-thin) solid var(--xh-command-border, var(--xh-material-elevated-border));
     border-radius: var(--xh-command-radius, var(--xh-shape-overlay));
@@ -148,8 +148,6 @@
 
   [data-scope='command'][data-part='content'][data-state='open'] {
     animation: xh-overlay-pop-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter-strong);
-    /* 只在开着的这一档挂：合成层随 data-state 一起收走，收起后不再占着 */
-    will-change: opacity, scale, translate;
   }
 
   /* 退场：收起那一帧 hidden 由退场闸门押后，这里才播得出来。forwards 把末态钉住，
@@ -205,7 +203,7 @@
     min-block-size: 0;
     padding-block: var(--xh-command-list-py, var(--xh-space-2));
     padding-inline: var(--xh-command-list-px, var(--xh-space-2));
-    /* 模态面板里的滚动面：到底后不把滚动链穿透给页面（§6.6） */
+    /* 模态面板里的滚动面：到底后不把滚动链穿透给页面 */
     overflow-y: auto;
     overscroll-behavior: contain;
   }

package/css/context-menu.css

@@ -63,7 +63,7 @@
   /* 私有槽同时声明在根与 positioner 上：浮层被搬到 portal 落点，不是根的后代，继承不过去 */
   [data-scope='context-menu']:is([data-part='root'], [data-part='positioner']) {
     /* 条目外的字形（分组标题等）按档取尺，缺省 md，随 data-size 换档；同样声明在 positioner 上，被搬走的浮层
-       才拿得到；条目里作者放的图标由家族随 data-xh-collection-size 下发（§6.5）。菜单自绘的状态字形（标记位的盒、
+       才拿得到；条目里作者放的图标由家族随 data-xh-collection-size 下发。菜单自绘的状态字形（标记位的盒、
        盒里兜底的勾、子菜单的展开 chevron）不读这支：它们是指示符，走 --xh-control-indicator-* 一族——标记位在
        自己身上把 --xh-icon-size 改接到盒的尺，子菜单箭头走 --xh-context-menu-submenu-indicator-size */
     --xh-icon-size: var(--xh-context-menu-icon-size, var(--xh-glyph-size-md));
@@ -102,7 +102,7 @@
     -webkit-backdrop-filter: var(--xh-context-menu-backdrop, var(--xh-material-frosted-backdrop));
     backdrop-filter: var(--xh-context-menu-backdrop, var(--xh-material-frosted-backdrop));
     /* 条目超过上限就在菜单内部滚；内收焦点环不会被内边距缘裁掉。
-       浮层滚动面：到底后不把滚动链穿透给页面（§6.6） */
+       浮层滚动面：到底后不把滚动链穿透给页面 */
     overflow-y: auto;
     overscroll-behavior: contain;
     pointer-events: auto;
@@ -178,8 +178,6 @@
 
   /* 首帧落位后从锚点一侧淡入短移，不缩放整张面。 */
   [data-scope='context-menu'][data-part='content'][data-state='open'] {
-    /* 在场那一档才提前备好合成层：属性随 data-state 一起消失，收起后不长期占着 */
-    will-change: opacity, translate;
     animation: xh-overlay-slide-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter-strong);
   }
 
@@ -260,7 +258,7 @@
   }
 
   /* 子菜单箭头留在主行末端；description 即使写在它前面，也由 order 独占下一行。
-     箭头是指示符（§6.5）：与标记位的盒同走 --xh-control-indicator-size，不读 --xh-icon-size——
+     箭头是指示符：与标记位的盒同走 --xh-control-indicator-size，不读 --xh-icon-size——
      按图标档取的 20px 会比 16px 的标记位盒大一圈 */
   [data-scope='context-menu'][data-part='item'][aria-haspopup='menu']::after {
     content: '';
@@ -292,7 +290,7 @@
     display: none;
   }
 
-  /* 标记位（勾选符号 / 图标）按作者写入的槽位留在主行，不为没写的条目强制占列。盒是指示符（§6.5）：按指示符档
+  /* 标记位（勾选符号 / 图标）按作者写入的槽位留在主行，不为没写的条目强制占列。盒是指示符：按指示符档
      取尺，与 Menu / Cascader 的标记位同走 --xh-control-indicator-size，不读家族按档下发的 --xh-icon-size——
      按图标档取的 20px 会比同一行 16px 的指示符档大一圈。盒在自己身上把 --xh-icon-size 改接到盒的尺，
      皮肤画的兜底勾与作者塞进标记位的 XhIcon 读同一把尺、与盒同边长（行尾标记不是勾选格，不取 × 0.75）；

package/css/date-picker.css

@@ -292,8 +292,6 @@
   }
 
   [data-scope='date-picker'][data-part='content'][data-state='open'] {
-    /* 只在展开态挂着：随状态属性一起消失，不长期占着合成层 */
-    will-change: opacity, translate;
     animation: xh-overlay-slide-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter-strong);
   }
 

package/css/date-range-picker.css

@@ -313,8 +313,6 @@
   }
 
   [data-scope='date-range-picker'][data-part='content'][data-state='open'] {
-    /* 只在展开态挂着：随状态属性一起消失，不长期占着合成层 */
-    will-change: opacity, translate;
     animation: xh-overlay-slide-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter-strong);
   }
 

package/css/descriptions.css

@@ -15,7 +15,7 @@
     /* 一个尺寸档只换这几个私有槽，每一格与格内两段都从根上继承它们，
        换档不必给每个部件各写一条选择器 */
     --xh-_descriptions-gap: var(--xh-space-3);
-    /* 标签是每一格的集合标题：叠着排时与取值隔 space-2（§6.4 集合标题与集合的间距） */
+    /* 标签是每一格的集合标题：叠着排时与取值隔 space-2（集合标题与集合的间距） */
     --xh-_descriptions-pair-gap: var(--xh-space-2);
     --xh-_descriptions-label-gap: var(--xh-space-2);
     --xh-_descriptions-py: var(--xh-space-2);

package/css/dialog.css

@@ -48,7 +48,7 @@
   }
 
   /*
-   * 触发器是页面上的独立文字按钮（§9.1）：盒型、md 档几何、outline 四态面、0.97 按压并换底与粗指针命中区
+   * 触发器是页面上的独立文字按钮：盒型、md 档几何、outline 四态面、0.97 按压并换底与粗指针命中区
    * 由家族配方按连接层投影的 data-xh-action-variant / -size 给出。皮肤没有自己的外观规则，
    * 只把作者塞进按钮的图标接到随档字形尺（md = 20px）。
    */
@@ -112,7 +112,7 @@
   }
 
   [data-scope='dialog'][data-part='content'] {
-    /* 作者塞进面板里的图标按控件档取（§6.5）；语气徽记与关闭钮另有各自的尺 */
+    /* 作者塞进面板里的图标按控件档取；语气徽记与关闭钮另有各自的尺 */
     --xh-icon-size: var(--xh-dialog-icon-size, var(--xh-glyph-size-md));
 
     /* 尺寸档只换这一个私有槽。它声明在 content 而不是别处：dialog 的解剖里没有 root，
@@ -180,8 +180,6 @@
 
   [data-scope='dialog'][data-part='content'][data-state='open'] {
     animation: xh-dialog-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter-strong);
-    /* 只在开着的这一档挂：合成层随 data-state 一起收走，收起后不再占着 */
-    will-change: opacity, scale, translate;
   }
 
   [data-scope='dialog'][data-part='content'][data-state='closed'] {
@@ -262,7 +260,7 @@
 
   /* 正文段：面板里唯一会滚的一段。最小高度归零，
      否则弹性项按内容撑高，容器再矮也不产生溢出，滚动条永远出不来。
-     模态 body 是原生细条滚动面（§6.6）：细条由 reset 层统一给，滚到头不把页面一起带走 */
+     模态 body 是原生细条滚动面：细条由 reset 层统一给，滚到头不把页面一起带走 */
   [data-scope='dialog'][data-part='body'] {
     flex: 1 1 auto;
     min-block-size: 0;
@@ -305,7 +303,7 @@
     color: var(--xh-dialog-title-fg, var(--xh-fg-default));
   }
 
-  /* 说明文字走说明档（§6.4）：13px + fg-muted */
+  /* 说明文字走说明档：13px + fg-muted */
   [data-scope='dialog'][data-part='description'] {
     margin: 0;
     font-size: var(--xh-dialog-description-font-size, var(--xh-text-secondary-size));
@@ -320,7 +318,7 @@
   }
 
   /*
-   * 关闭钮是面板角落的单图标钮（§9.1）：正方盒、sm 档几何、ghost 四态面、0.97 按压并换底与粗指针命中区
+   * 关闭钮是面板角落的单图标钮：正方盒、sm 档几何、ghost 四态面、0.97 按压并换底与粗指针命中区
    * 由家族配方给出——白面上走画布承载阶梯悬停 --xh-bg-subtle（100）→ 按下 --xh-bg-subtle-hover（200），
    * 焦点面透明吃库环。这里只把公开槽桥接到矩阵之前（使用者槽 → 形态矩阵 → 家族缺省）与摆放，
    * 聚焦档的 -bg-focus / -fg-focus 两槽同样桥到配方的 focus-visible 面，缺省仍是透明底与悬停字色；

package/css/diff-view.css

@@ -14,10 +14,10 @@
     --xh-diff-view-skin: 1;
   }
 
-  /* 一张静态内容面：--xh-border-default 描边 + surface 底 + 无影（§5.3 边界只由描边承担）；
+  /* 一张静态内容面：--xh-border-default 描边 + surface 底 + 无影（边界只由描边承担）；
      头部、行号列与并排接缝的内部分隔线走另一支 --xh-diff-view-divider（subtle） */
   [data-scope='diff-view'][data-part='root'] {
-    /* 作者塞进部件里的图标与皮肤画的兜底字形同一把尺：md 档，随 data-size 换档（§6.5） */
+    /* 作者塞进部件里的图标与皮肤画的兜底字形同一把尺：md 档，随 data-size 换档 */
     --xh-icon-size: var(--xh-diff-view-icon-size, var(--xh-glyph-size-md));
 
     /* 尺寸缺省档：不写 data-size 时的取值。三档都只写这三个私有槽，
@@ -258,7 +258,7 @@
     color: var(--xh-diff-view-punctuation-fg, var(--xh-fg-subtle));
   }
 
-  /* 折起来的那一行：整行都是展开按钮。行是淡底承载面，向按钮下发 hover 200 → pressed 300（§7.2） */
+  /* 折起来的那一行：整行都是展开按钮。行是淡底承载面，向按钮下发 hover 200 → pressed 300 */
   [data-scope='diff-view'][data-part='gap'] {
     --xh-action-host-bg-hover: var(--xh-bg-subtle-hover);
     --xh-action-host-bg-pressed: var(--xh-bg-subtle-active);
@@ -276,7 +276,7 @@
   }
 
   /* 展开按钮铺满折叠格，盒型、悬停与按下面由 Action Control 的 disclosure-trigger 档给（ghost 形态，
-     按下只换面不缩放，§9.2）；这里只把使用者槽映射到桥接槽：圆角归零贴住格边、纵向内衬归零、
+     按下只换面不缩放）；这里只把使用者槽映射到桥接槽：圆角归零贴住格边、纵向内衬归零、
      高度锚在代码行高上让折叠格与相邻代码行同高，字号跟着正文走 */
   [data-scope='diff-view'][data-part='gap-trigger'] {
     --xh-action-radius: 0;

package/css/download-trigger.css

@@ -35,7 +35,7 @@
   }
 
   /*
-   * 触发器就是这一个原生按钮，是定尺的独立动作按钮（§9.1）：盒型、三档几何、四态面、0.97 按压与粗指针
+   * 触发器就是这一个原生按钮，是定尺的独立动作按钮：盒型、三档几何、四态面、0.97 按压与粗指针
    * 命中区由家族配方按 data-xh-action-variant / -size 给出（缺省 subtle 由连接层显式投影，只有 solid 才品牌实心）。
    * 这里只把公开槽桥接到矩阵之前（使用者槽 → 形态矩阵 → 家族缺省）与几何槽映射；
    * 要换成品牌样式的作者改 --xh-download-trigger-* 这一族槽位，或直接写自己的类名。
@@ -57,7 +57,7 @@
     --xh-action-border-pressed: var(--xh-download-trigger-border-hover, var(--xh-_action-variant-border-pressed));
     --xh-action-border-focus-visible: var(--xh-download-trigger-border, var(--xh-_action-variant-border-focus-visible));
     --xh-action-border-disabled: var(--xh-download-trigger-border-disabled, var(--xh-_action-variant-border-disabled));
-    /* 矩阵各态无影（§8.3 淡底与阴影互斥）：solid 也不再悬停抬影，使用者槽仍可自行加 */
+    /* 矩阵各态无影（淡底与阴影互斥）：solid 也不再悬停抬影，使用者槽仍可自行加 */
     --xh-action-shadow-hover: var(--xh-download-trigger-shadow-hover, none);
     --xh-action-radius: var(--xh-download-trigger-radius, var(--xh-shape-control));
     --xh-action-visual-size: var(--xh-download-trigger-h, var(--xh-_action-profile-visual-size));
@@ -121,7 +121,7 @@
     margin: auto;
     border: var(--xh-stroke-thin) solid transparent;
     border-block-start-color: var(--xh-_download-trigger-loading-fg);
-    /* 正圆的加载环：正方盒取 circle（§6.3） */
+    /* 正圆的加载环：正方盒取 circle */
     border-radius: var(--xh-shape-circle);
     opacity: 0;
     animation:

package/css/drawer.css

@@ -107,7 +107,7 @@
   /* root 留在页面原地，只是 data-side / data-state 的落点，不该凭空多出一层盒子把
      trigger 从作者的 flex / grid 行里挤出去，故 display: contents。 */
   [data-scope='drawer'][data-part='root'] {
-    /* 作者塞进面板里的图标按控件档取（§6.5）；触发器与关闭钮另由家族配方按各自的档下发字形尺 */
+    /* 作者塞进面板里的图标按控件档取；触发器与关闭钮另由家族配方按各自的档下发字形尺 */
     --xh-icon-size: var(--xh-drawer-icon-size, var(--xh-glyph-size-md));
 
     display: contents;
@@ -125,7 +125,7 @@
   }
 
   /*
-   * 触发器是页面上的独立文字按钮（§9.1）：盒型、md 档几何、outline 四态面、0.97 按压并换底与粗指针命中区
+   * 触发器是页面上的独立文字按钮：盒型、md 档几何、outline 四态面、0.97 按压并换底与粗指针命中区
    * 由家族配方按连接层投影的 data-xh-action-variant / -size 给出（此前自写描边盒型，hover 落 200 / active 落 300）。
    * 这里只把公开槽桥接到矩阵之前（使用者槽 → 形态矩阵 → 家族缺省）与几何槽映射。
    */
@@ -159,7 +159,7 @@
   }
 
   /* 抽屉展开期间触发按钮压住不弹起：面板贴在视口边上，它和按钮往往离得很远，
-     按钮自己得说明"这一扇是我开的"。open 与家族 hover 同档中性（§7.2 第 8 条）：
+     按钮自己得说明"这一扇是我开的"。open 与家族 hover 同档中性：
      白底承载的 --xh-bg-subtle（100）+ 悬停描边，聚焦时这块面留着 */
   [data-scope='drawer'][data-part='trigger'][data-state='open'] {
     --xh-action-bg-rest: var(--xh-drawer-trigger-bg-open, var(--xh-bg-subtle));
@@ -259,13 +259,13 @@
       env(safe-area-inset-left),
       env(safe-area-inset-right)
     );
-    /* M4 sheet 三件套（§8.4）：任何浮层不得只靠 box-shadow 分层，亮色下面板与页面同色，
+    /* M4 sheet 三件套：任何浮层不得只靠 box-shadow 分层，亮色下面板与页面同色，
        1px 描边才是它的边界；影只是加成 */
     border: var(--xh-stroke-thin) solid var(--xh-drawer-border, var(--xh-material-elevated-border));
     background: var(--xh-drawer-bg, var(--xh-material-elevated-bg));
     color: var(--xh-drawer-fg, var(--xh-material-elevated-fg));
     box-shadow: var(--xh-drawer-shadow, var(--xh-material-elevated-shadow));
-    /* 作者不用 header / body / footer 三段时它是唯一的滚动层：模态面滚到头不把页面一起带走（§6.6） */
+    /* 作者不用 header / body / footer 三段时它是唯一的滚动层：模态面滚到头不把页面一起带走 */
     overflow: auto;
     overscroll-behavior: contain;
     /* 尺寸是照视口那条边算出来的，padding 再往外顶就会把面板挤出屏幕、
@@ -350,13 +350,7 @@
     border-start-end-radius: var(--xh-drawer-radius, var(--xh-shape-overlay));
   }
 
-  /* 展开期间面板整块推到一屏之外再推回来：只在开着的这一档挂，
-     合成层随 data-state 一起收走，收起后不再占着 */
-  [data-scope='drawer'][data-part='content'][data-state='open'] {
-    will-change: translate;
-  }
-
-  /* 滑入/滑出按边配对。入场是整面板从画外推入的大尺度位移（§9.5）：走 --xh-motion-duration-slide
+  /* 滑入/滑出按边配对。入场是整面板从画外推入的大尺度位移：走 --xh-motion-duration-slide
      与 --xh-motion-ease-slide；退场仍走 exit 档。退场一律 forwards：presence 要等 animationend 才卸载，
      不定住终态，面板会在最后一帧弹回原位再消失。 */
   [data-scope='drawer'][data-part='content'][data-side='right'][data-state='open'] {
@@ -413,7 +407,7 @@
 
   /* 正文段：面板里唯一会滚的一段。最小高度归零，
      否则弹性项按内容撑高，容器再矮也不产生溢出，滚动条永远出不来。
-     模态 body 是原生细条滚动面（§6.6）：细条由 reset 层统一给，滚到头不把页面一起带走 */
+     模态 body 是原生细条滚动面：细条由 reset 层统一给，滚到头不把页面一起带走 */
   [data-scope='drawer'][data-part='body'] {
     flex: 1 1 auto;
     min-block-size: 0;
@@ -451,7 +445,7 @@
     color: var(--xh-drawer-title-fg, var(--xh-fg-default));
   }
 
-  /* 说明文字走说明档（§6.4）：13px + fg-muted */
+  /* 说明文字走说明档：13px + fg-muted */
   [data-scope='drawer'][data-part='description'] {
     margin: 0;
     font-size: var(--xh-drawer-description-font-size, var(--xh-text-secondary-size));
@@ -466,7 +460,7 @@
   }
 
   /*
-   * 关闭钮是面板角落的单图标钮（§9.1）：正方盒、sm 档几何、ghost 四态面、0.97 按压并换底与粗指针命中区
+   * 关闭钮是面板角落的单图标钮：正方盒、sm 档几何、ghost 四态面、0.97 按压并换底与粗指针命中区
    * 由家族配方给出——白面上走画布承载阶梯悬停 --xh-bg-subtle（100）→ 按下 --xh-bg-subtle-hover（200），
    * 焦点面透明吃库环。这里只把公开槽桥接到矩阵之前（使用者槽 → 形态矩阵 → 家族缺省）与摆放，
    * 聚焦档的 -bg-focus / -fg-focus 两槽同样桥到配方的 focus-visible 面（与 dialog 一致），缺省仍是透明底与悬停字色；

package/css/empty-state.css

@@ -20,7 +20,7 @@
     --xh-_empty-state-gap: var(--xh-stack-gap-md);
     --xh-_empty-state-py: var(--xh-section-py-md);
     --xh-_empty-state-icon-size: var(--xh-glyph-size-2xl);
-    /* 标题走 Surface / Feedback 标题档 14/600（§6.4）；sm 同档只缩图形与留白，lg 升到页面级 heading-3 */
+    /* 标题走 Surface / Feedback 标题档 14/600；sm 同档只缩图形与留白，lg 升到页面级 heading-3 */
     --xh-_empty-state-title-size: var(--xh-text-label-size);
     /* 图标区的强调色：由 data-status（状态码）或 data-tone（语气）换掉；两样都没写就退成中性 */
     --xh-_empty-state-accent: var(--xh-fg-subtle);

package/css/field.css

@@ -100,7 +100,7 @@
     --xh-field-border-hover: var(--xh-field-control-border-hover, var(--xh-_field-variant-border-hover));
     --xh-field-border-focus: var(--xh-field-control-border-focus, var(--xh-_field-variant-border-focus));
     --xh-field-border-invalid: var(--xh-field-control-border-invalid, var(--xh-_field-variant-border-invalid));
-    /* 焦点环与家族同一支公共环，不再留逐组件的环色槽（§7.2.5 焦点边与环一律公共） */
+    /* 焦点环与家族同一支公共环，不再留逐组件的环色槽（焦点边与环一律公共） */
     --xh-field-ring-focus: var(--xh-ring-focus);
     --xh-field-ring-invalid: var(--xh-ring-invalid);
     --xh-field-shadow-rest: var(--xh-field-control-shadow, none);

package/css/fieldset.css

@@ -31,7 +31,7 @@
   [data-scope='fieldset'][data-part='legend'] {
     padding: 0;
     margin-block-end: var(--xh-fieldset-legend-gap, var(--xh-space-2));
-    /* 组标题是「一组字段的标题」，归集合标题角色（§6.4）：fg-muted，与组 --xh-space-2，字号字重同字段标签 */
+    /* 组标题是「一组字段的标题」，归集合标题角色：fg-muted，与组 --xh-space-2，字号字重同字段标签 */
     color: var(--xh-fieldset-legend-fg, var(--xh-fg-muted));
     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));

package/css/file-upload.css

@@ -14,7 +14,7 @@
   [data-scope='file-upload'][data-part='root'] {
     /* 作者放进缩略图槽、删除钮与清空钮里的图标跟着字号走，与皮肤画的兜底叉同一把尺。
        条目行首自绘的状态标记（传完的勾、失败的警示）不读这支：它们是指示符，与同一行里 icon 档的
-       删除钮并排、走 --xh-control-indicator-* 一族（§6.5），尺寸由 --xh-file-upload-item-mark-size 单独控 */
+       删除钮并排、走 --xh-control-indicator-* 一族，尺寸由 --xh-file-upload-item-mark-size 单独控 */
     --xh-icon-size: var(--xh-file-upload-icon-size, var(--xh-glyph-size-text));
 
     display: flex;

package/css/float-button.css

@@ -84,7 +84,7 @@
   /* —— 形态：给展开列表里原生动作项用的面 ——
      触发器的面由 Action Control 形态矩阵按 data-xh-action-variant 给（solid / subtle / ghost），
      原生动作项读不到矩阵，这几块私有槽按矩阵同一张表镜像；ghost 与 outline 的悬停 / 按下走画布承载的
-     阶梯（100 → 200，§7.2 第 3 条）。缺省 outline（连接层不传 variant 时显式落）是磨砂面：背景、边缘、
+     阶梯（100 → 200）。缺省 outline（连接层不传 variant 时显式落）是磨砂面：背景、边缘、
      顶光、投影与磨砂从同一份 M2 配方取，高对比、减少透明度、打印和强制色便能一起降级——钮浮在正文
      之上，透空的面在任何内容上都读不出边界，所以 outline 这一档面留着 */
   [data-scope='float-button'][data-part='root'][data-variant='solid'] {
@@ -128,7 +128,7 @@
   }
 
   /* —— 触发器 ——
-     浮在内容之上的单图标圆钮，接 Action Control floating 档（§4.1）：盒型（md = box-lg 48px，圆形）、
+     浮在内容之上的单图标圆钮，接 Action Control floating 档：盒型（md = box-lg 48px，圆形）、
      四态面、0.97 按压与 44px 命中区由家族配方按 data-xh-action-variant / -size 给出。
      这里只把公开槽桥接到矩阵之前（使用者槽 → 形态矩阵 → 家族缺省）与几何槽映射 */
   [data-scope='float-button'][data-part='trigger'] {
@@ -146,7 +146,7 @@
     --xh-action-border-pressed: var(--xh-float-button-border-hover, var(--xh-_action-variant-border-pressed));
     --xh-action-border-focus-visible: var(--xh-float-button-border, var(--xh-_action-variant-border-focus-visible));
     --xh-action-border-disabled: var(--xh-float-button-border, var(--xh-_action-variant-border-disabled));
-    /* 矩阵各态无影（§8.3 淡底与阴影互斥）；outline 那一档的磨砂投影在下面另桥接 */
+    /* 矩阵各态无影（淡底与阴影互斥）；outline 那一档的磨砂投影在下面另桥接 */
     --xh-action-shadow-rest: var(--xh-float-button-shadow, none);
     --xh-action-shadow-hover: var(--xh-float-button-shadow, none);
     --xh-action-shadow-pressed: var(--xh-float-button-shadow, none);