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

package/css/combobox.css

@@ -1,13 +1,66 @@
+@layer xihan.motion {
+  /* 动画名的查找只认「文档里有没有这个名字」：引用别处文件里的名字，那份文件不一定在场，
+     动画会静默地整个不跑。每份皮肤都能单独引入，所以它用到的关键帧都写在自己身上。 */
+  @keyframes xh-pop-in {
+    from {
+      opacity: 0;
+      scale: var(--xh-motion-scale-enter);
+    }
+
+    to {
+      opacity: 1;
+      scale: 1;
+    }
+  }
+  @keyframes xh-pop-out {
+    from {
+      opacity: 1;
+      scale: 1;
+    }
+
+    to {
+      opacity: 0;
+      scale: var(--xh-motion-scale-enter);
+    }
+  }
+}
+
 @layer xihan.components {
-  [data-scope='combobox'][data-part='root'] {
-    /* 尺寸档只换这五个私有槽，输入行、标题与候选都从 root 继承它们，
-       换档不必给每个部件各写一条选择器。浮层在 positioner 里、也是 root 的后代，一并继承 */
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  [data-scope='combobox'] {
+    --xh-combobox-skin: 1;
+  }
+
+  /* 坐标由定位引擎写进 style（inset-inline-start / inset-block-start），这里只定位模式与层级 */
+  [data-scope='combobox'][data-part='positioner'] {
+    /* 落定那一侧的可用高度，由定位引擎经内联自定义属性写进来，内容层继承它限高；
+       引擎没算（尚未落位 / 无引擎）时不额外限高 */
+    --xh-_combobox-available-h: 100vh;
+
+    position: fixed;
+    z-index: var(--xh-combobox-layer, var(--xh-layer-popover));
+    /* 空壳不吃指针，交互只发生在 content 与 empty 上 */
+    pointer-events: none;
+  }
+
+  /* 锚点被滚出可视区：整个浮层随之收起 */
+  [data-scope='combobox'][data-part='positioner'][data-hidden] {
+    visibility: hidden;
+  }
+
+  /* 私有槽同时声明在根与 positioner 上：浮层被搬到 portal 落点，不是根的后代，继承不过去 */
+  [data-scope='combobox']:is([data-part='root'], [data-part='positioner']) {
+    /* 尺寸档只换这五个私有槽，输入行、标题与候选都从这两处继承它们，
+       换档不必给每个部件各写一条选择器 */
     --xh-_combobox-h: var(--xh-control-h-md);
     --xh-_combobox-px: var(--xh-control-px-md);
     --xh-_combobox-gap: var(--xh-control-gap-md);
     --xh-_combobox-font-size: var(--xh-text-body-size);
     --xh-_combobox-label-font-size: var(--xh-text-label-size);
 
+    /* 作者塞进指示符槽的图标跟着控件的尺寸档走；它自己写了 size 时仍以作者的为准 */
+    --xh-icon-size: var(--xh-combobox-icon-size, var(--xh-glyph-size-md));
+
     /* 形态档只换这三个槽：缺省即 outline（描边 + 画布底） */
     --xh-_combobox-control-bg: var(--xh-bg-canvas);
     --xh-_combobox-control-border: var(--xh-border-control);
@@ -18,10 +71,12 @@
     --xh-_combobox-ring: var(--xh-ring-focus);
     --xh-_combobox-accent: var(--xh-_tone, var(--xh-bg-brand));
     --xh-_combobox-item-selected-fg: var(--xh-_tone-fg, var(--xh-fg-brand-strong));
+  }
 
+  [data-scope='combobox'][data-part='root'] {
     display: inline-flex;
     flex-direction: column;
-    gap: var(--xh-combobox-gap, var(--xh-stack-gap-md));
+    gap: var(--xh-combobox-gap, var(--xh-space-1));
   }
 
   /* 只要声明了 display 就盖掉了 UA 的 [hidden]{display:none}，收起态得自己还回去 */
@@ -31,46 +86,51 @@
 
   /* —— 尺寸 —— */
   /* 缺省档写在上面的基础规则里 */
-  [data-scope='combobox'][data-part='root'][data-size='sm'] {
+  [data-scope='combobox']:is([data-part='root'], [data-part='positioner'])[data-size='sm'] {
     --xh-_combobox-h: var(--xh-control-h-sm);
     --xh-_combobox-px: var(--xh-control-px-sm);
     --xh-_combobox-gap: var(--xh-control-gap-sm);
-    --xh-_combobox-font-size: var(--xh-font-size-sm);
-    --xh-_combobox-label-font-size: var(--xh-font-size-sm);
+    --xh-_combobox-font-size: var(--xh-control-font-sm);
+    --xh-_combobox-label-font-size: var(--xh-control-font-sm);
+
+    --xh-icon-size: var(--xh-combobox-icon-size, var(--xh-glyph-size-sm));
   }
 
-  [data-scope='combobox'][data-part='root'][data-size='lg'] {
+  [data-scope='combobox']:is([data-part='root'], [data-part='positioner'])[data-size='lg'] {
     --xh-_combobox-h: var(--xh-control-h-lg);
     --xh-_combobox-px: var(--xh-control-px-lg);
     --xh-_combobox-gap: var(--xh-control-gap-lg);
-    --xh-_combobox-font-size: var(--xh-font-size-lg);
-    --xh-_combobox-label-font-size: var(--xh-font-size-lg);
+    --xh-_combobox-font-size: var(--xh-control-font-lg);
+    --xh-_combobox-label-font-size: var(--xh-control-font-lg);
+
+    --xh-icon-size: var(--xh-combobox-icon-size, var(--xh-glyph-size-lg));
   }
 
   /* —— 形态 —— */
   /* 输入类不做 solid：实心底压着可编辑的文字，读起来像块不可点的色板。
      形态只决定描边与底色怎么用，用哪族颜色由 data-tone 决定 */
-  [data-scope='combobox'][data-part='root'][data-variant='outline'] {
+  [data-scope='combobox']:is([data-part='root'], [data-part='positioner'])[data-variant='outline'] {
     --xh-_combobox-control-bg: var(--xh-bg-canvas);
     --xh-_combobox-control-border: var(--xh-border-control);
     --xh-_combobox-control-border-hover: var(--xh-border-control-hover);
   }
 
   /* 填充式：底色顶替描边，悬停时才浮出一道淡边 */
-  [data-scope='combobox'][data-part='root'][data-variant='subtle'] {
+  [data-scope='combobox']:is([data-part='root'], [data-part='positioner'])[data-variant='subtle'] {
     --xh-_combobox-control-bg: var(--xh-_tone-subtle, var(--xh-bg-subtle));
     --xh-_combobox-control-border: transparent;
     --xh-_combobox-control-border-hover: var(--xh-_tone-border, var(--xh-border-control-hover));
   }
 
-  [data-scope='combobox'][data-part='root'][data-variant='ghost'] {
+  /* 无框：底与常态描边透明，悬停与聚焦浮出描边 */
+  [data-scope='combobox']:is([data-part='root'], [data-part='positioner'])[data-variant='ghost'] {
     --xh-_combobox-control-bg: transparent;
     --xh-_combobox-control-border: transparent;
     --xh-_combobox-control-border-hover: var(--xh-_tone-border, var(--xh-border-control-hover));
   }
 
   [data-scope='combobox'][data-part='label'] {
-    color: var(--xh-combobox-label-fg, var(--xh-fg-muted));
+    color: var(--xh-combobox-label-fg, var(--xh-fg-default));
     font-size: var(--xh-combobox-label-font-size, var(--xh-_combobox-label-font-size));
     font-weight: var(--xh-combobox-label-font-weight, var(--xh-text-label-weight));
     line-height: var(--xh-leading-none);
@@ -86,7 +146,7 @@
     display: inline-flex;
     align-items: center;
     gap: var(--xh-combobox-control-gap, var(--xh-_combobox-gap));
-    min-inline-size: var(--xh-combobox-control-min-w, var(--xh-overlay-min-w));
+    min-inline-size: var(--xh-combobox-control-min-w, var(--xh-control-min-w));
     block-size: var(--xh-combobox-control-h, var(--xh-_combobox-h));
     padding-inline: var(--xh-combobox-control-px, var(--xh-_combobox-px));
     border: var(--xh-stroke-thin) solid var(--xh-combobox-control-border, var(--xh-_combobox-control-border));
@@ -108,14 +168,17 @@
   /* 焦点环画在 control 上而不是 input 上：视觉上的「框」是 control，
      环若长在里面那个透明的 input 身上，就会缩在文字区里、与框错开一圈。
      input 是这里唯一可聚焦的常规节点，:focus-within 与它的 :focus-visible 等价 */
-  [data-scope='combobox'][data-part='control']:focus-within {
-    border-color: var(--xh-combobox-control-border-focus, var(--xh-_combobox-ring));
+  [data-scope='combobox'][data-part='control']:focus-within:not([data-disabled]) {
+    border-color: var(--xh-combobox-control-border-focus, var(--xh-_tone, var(--xh-border-control-focus)));
     outline: var(--xh-ring-width) solid var(--xh-_combobox-ring);
     outline-offset: var(--xh-ring-offset);
   }
 
   [data-scope='combobox'][data-part='control'][data-invalid] {
-    border-color: var(--xh-combobox-control-border-invalid, var(--xh-color-danger-500));
+    border-color: var(--xh-combobox-control-border-invalid, var(--xh-border-invalid));
+
+    /* 校验失败时环也跟着变红：两圈等宽相邻却一红一蓝，读的人不知道哪个才是当前状态 */
+    --xh-_combobox-ring: var(--xh-ring-invalid);
   }
 
   /* 只读仍可聚焦、可复制，所以不置灰，只把底色压下去表示"改不动" */
@@ -192,13 +255,14 @@
     background: var(--xh-combobox-action-bg, transparent);
     color: var(--xh-combobox-action-fg, var(--xh-fg-muted));
     font-family: inherit;
-    font-size: var(--xh-combobox-action-font-size, var(--xh-font-size-sm));
+    font-size: var(--xh-combobox-action-font-size, var(--xh-text-secondary-size));
     line-height: var(--xh-leading-none);
     cursor: pointer;
     user-select: none;
-    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='combobox'][data-part='trigger'][hidden],
   [data-scope='combobox'][data-part='clear-trigger'][hidden] {
     display: none;
@@ -213,12 +277,26 @@
 
   /* 没写内容就由皮肤画箭头；作者往部件里塞了自己的图形，这条规则即不命中 */
   [data-scope='combobox'][data-part='trigger']:empty::before {
-    content: '▾';
+    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='combobox'][data-part='clear-trigger']:empty::before {
-    content: '✕';
+    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;
   }
 
   [data-scope='combobox'][data-part='trigger'][data-state='open']:empty::before,
@@ -235,57 +313,43 @@
   [data-scope='combobox'][data-part='trigger']:active:not(:disabled),
   [data-scope='combobox'][data-part='clear-trigger']:active:not(:disabled) {
     background: var(--xh-combobox-action-bg-active, var(--xh-bg-subtle-active));
+    scale: var(--xh-motion-scale-press);
   }
 
-  /* 两个按钮都退出了 Tab 序列（tabindex=-1），正常操作走不到这里；
-     留着是给程序化聚焦兜底，落焦时得看得见 */
+  /* 两个按钮都在盒里，盒的 :focus-within 已经画了一圈；这里再画一圈就是框里套框 */
   [data-scope='combobox'][data-part='trigger']:focus-visible,
   [data-scope='combobox'][data-part='clear-trigger']:focus-visible {
-    outline: var(--xh-ring-width) solid var(--xh-_combobox-ring);
-    outline-offset: var(--xh-ring-offset);
+    outline: none;
   }
 
-  [data-scope='combobox'][data-part='trigger']:disabled,
-  [data-scope='combobox'][data-part='clear-trigger']:disabled {
+  [data-scope='combobox'][data-part='trigger']:disabled {
     background: var(--xh-combobox-action-bg, transparent);
     color: var(--xh-fg-disabled);
     cursor: not-allowed;
   }
 
-  /* 坐标由定位引擎写进 style（inset-inline-start / inset-block-start），这里只定位模式与层级 */
-  [data-scope='combobox'][data-part='positioner'] {
-    position: fixed;
-    z-index: var(--xh-layer-popover);
-    /* 空壳不吃指针，交互只发生在 content 与 empty 上 */
-    pointer-events: none;
-  }
-
-  /* 锚点被滚出可视区：整个浮层随之收起 */
-  [data-scope='combobox'][data-part='positioner'][data-hidden] {
-    visibility: hidden;
-  }
-
   [data-scope='combobox'][data-part='content'] {
     display: flex;
     flex-direction: column;
     min-inline-size: var(--xh-combobox-content-min-w, var(--xh-overlay-min-w));
-    max-inline-size: var(--xh-combobox-content-max-w, 24rem);
-    max-block-size: var(--xh-combobox-content-max-h, var(--xh-overlay-max-h));
+    max-inline-size: var(--xh-combobox-content-max-w, var(--xh-overlay-max-w));
+    max-block-size: min(var(--xh-combobox-content-max-h, var(--xh-overlay-max-h)), var(--xh-_combobox-available-h));
     padding-block: var(--xh-combobox-content-py, var(--xh-space-1));
     padding-inline: var(--xh-combobox-content-px, var(--xh-space-1));
     border: var(--xh-stroke-thin) solid var(--xh-combobox-content-border, var(--xh-border-default));
     border-radius: var(--xh-combobox-content-radius, var(--xh-shape-surface));
     background: var(--xh-combobox-content-bg, var(--xh-bg-surface));
     color: var(--xh-combobox-content-fg, var(--xh-fg-default));
-    box-shadow: var(--xh-combobox-content-shadow, var(--xh-elevation-2));
+    box-shadow: var(--xh-combobox-content-shadow, var(--xh-elevation-floating));
     overflow-y: auto;
     pointer-events: auto;
   }
 
-  /* display 会盖掉 hidden 属性的 UA 规则，收起态显式让位 */
-  [data-scope='combobox'][data-part='content'][hidden] {
-    display: none;
-  }
+  /* 这里刻意没有 [data-part='content'][hidden] { display: none }，与 dialog 一致：
+     收起态连接层会给 content 打 hidden，而上面那条 display 正是要盖掉 UA 的
+     [hidden]{display:none}——退场动画得先能播。presence 读的是 content 的 animationName，
+     真正的收起由宿主在退场结束后落成内联 display:none（Vue 那边直接不渲染）。
+     其余声明了 display 的角色节点仍补 [hidden]，那几处没有退场动画。 */
 
   /* 列表从不承载焦点（焦点恒在输入框，高亮走 aria-activedescendant），
      可滚动容器在某些浏览器里会被自动塞进 Tab 序列，落焦时不画环 */
@@ -294,7 +358,13 @@
   }
 
   [data-scope='combobox'][data-part='content'][data-state='open'] {
-    animation: xh-fade-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter);
+    animation: xh-pop-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter);
+  }
+
+  /* 退场：收起那一帧 hidden 由退场闸门押后，这里才播得出来。forwards 把末态钉住，
+     免得动画结束到真收起之间闪一下原样 */
+  [data-scope='combobox'][data-part='content'][data-state='closed'] {
+    animation: xh-pop-out var(--xh-motion-duration-exit) var(--xh-motion-ease-exit) forwards;
   }
 
   [data-scope='combobox'][data-part='item-group'] {
@@ -317,7 +387,7 @@
     padding-block: var(--xh-combobox-group-label-py, var(--xh-space-1));
     padding-inline: var(--xh-combobox-group-label-px, var(--xh-control-px-md));
     color: var(--xh-combobox-group-label-fg, var(--xh-fg-subtle));
-    font-size: var(--xh-combobox-group-label-font-size, var(--xh-font-size-xs));
+    font-size: var(--xh-combobox-group-label-font-size, var(--xh-text-caption-size));
     font-weight: var(--xh-combobox-group-label-font-weight, var(--xh-font-weight-medium));
     line-height: var(--xh-leading-none);
     user-select: none;
@@ -355,6 +425,9 @@
      两套底色各画各的会出现"鼠标停在 A 上、回车提交的却是 B" */
   [data-scope='combobox'][data-part='item'][data-highlighted]:not([data-disabled]) {
     background: var(--xh-combobox-item-bg-hover, var(--xh-bg-subtle));
+    /* 焦点恒在输入框，高亮条目自带内收环；列表是滚动容器，环画在外沿会被裁掉 */
+    outline: var(--xh-ring-width) solid var(--xh-ring-focus);
+    outline-offset: calc(-1 * var(--xh-ring-width));
   }
 
   /* 选中只换文字色与字重，配合行尾的 ✓ 标记；底色整条通道留给高亮，
@@ -401,7 +474,14 @@
 
   /* 同上：没写内容就由皮肤画勾 */
   [data-scope='combobox'][data-part='item-indicator']:empty::before {
-    content: '✓';
+    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-check) center / contain no-repeat;
+    mask: var(--xh-glyph-mark-check) center / contain no-repeat;
   }
 
   [data-scope='combobox'][data-part='item-indicator'][data-state='checked'] {
@@ -424,7 +504,7 @@
     color: var(--xh-combobox-empty-fg, var(--xh-fg-subtle));
     font-size: var(--xh-combobox-empty-font-size, var(--xh-_combobox-font-size));
     line-height: var(--xh-leading-none);
-    box-shadow: var(--xh-combobox-empty-shadow, var(--xh-elevation-2));
+    box-shadow: var(--xh-combobox-empty-shadow, var(--xh-elevation-floating));
     text-align: center;
     pointer-events: auto;
   }

package/css/composer.css

@@ -1,4 +1,9 @@
 @layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  [data-scope='composer'] {
+    --xh-composer-skin: 1;
+  }
+
   /* 边框画在 root 上，内部 textarea 无边框；align-items: flex-end 让按钮随输入框长高贴着底边 */
   [data-scope='composer'][data-part='root'] {
     /* 输入与发送按钮共用的控件高度 */
@@ -7,7 +12,8 @@
     display: flex;
     align-items: flex-end;
     gap: var(--xh-composer-gap, var(--xh-control-gap-md));
-    padding: var(--xh-composer-p, var(--xh-space-2));
+    /* 整框的内衬走控件内边距尺的小档，密度收紧时随之收窄 */
+    padding: var(--xh-composer-p, var(--xh-control-px-sm));
     border: var(--xh-stroke-thin) solid var(--xh-composer-border, var(--xh-border-control));
     border-radius: var(--xh-composer-radius, var(--xh-shape-surface));
     background: var(--xh-composer-bg, var(--xh-bg-surface));
@@ -20,14 +26,15 @@
 
   /* 焦点环画在整个框上；用 focus-within 使焦点落在发送按钮时同样点亮 */
   [data-scope='composer'][data-part='root']:focus-within {
+    border-color: var(--xh-composer-root-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);
   }
 
-  /* 禁用态罩住整框，内部 textarea 与按钮另有原生 disabled 管交互 */
+  /* 禁用态只换光标与底色；文字由 textarea 与按钮各自走 fg-disabled，整框不再压 opacity，两者叠起来会压到读不出 */
   [data-scope='composer'][data-part='root'][data-disabled] {
     cursor: not-allowed;
-    opacity: var(--xh-state-disabled-opacity);
+    background: var(--xh-composer-bg-disabled, var(--xh-bg-subtle));
   }
 
   /* 无边框透明底，融进 root 的框里；min-inline-size: 0 防止长内容把弹性子项撑出容器 */