@xihan-ui/styles 1.0.0-alpha.0

package/css/combobox.css

@@ -0,0 +1,433 @@
+@layer xihan.components {
+  [data-scope='combobox'][data-part='root'] {
+    /* 尺寸档只换这五个私有槽，输入行、标题与候选都从 root 继承它们，
+       换档不必给每个部件各写一条选择器。浮层在 positioner 里、也是 root 的后代，一并继承 */
+    --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);
+
+    /* 形态档只换这三个槽：缺省即 outline（描边 + 画布底） */
+    --xh-_combobox-control-bg: var(--xh-bg-canvas);
+    --xh-_combobox-control-border: var(--xh-border-default);
+    --xh-_combobox-control-border-hover: var(--xh-border-strong);
+
+    /* 强调色随语气走，只落在聚焦与选中上，正文文字色不动。
+       没写 data-tone 时 --xh-_tone 没被声明，三处都退回原来的取值 */
+    --xh-_combobox-ring: var(--xh-ring-focus);
+    --xh-_combobox-accent: var(--xh-_tone, var(--xh-bg-brand));
+    --xh-_combobox-item-highlight-bg: var(--xh-_tone-subtle-hover, var(--xh-bg-subtle-hover));
+    --xh-_combobox-item-selected-fg: var(--xh-_tone-fg, var(--xh-fg-brand-strong));
+
+    display: inline-flex;
+    flex-direction: column;
+    gap: var(--xh-combobox-gap, var(--xh-stack-gap-md));
+  }
+
+  /* 只要声明了 display 就盖掉了 UA 的 [hidden]{display:none}，收起态得自己还回去 */
+  [data-scope='combobox'][data-part='root'][hidden] {
+    display: none;
+  }
+
+  /* —— 尺寸 —— */
+  /* 缺省档写在上面的基础规则里 */
+  [data-scope='combobox'][data-part='root'][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);
+  }
+
+  [data-scope='combobox'][data-part='root'][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);
+  }
+
+  /* —— 形态 —— */
+  /* 输入类不做 solid：实心底压着可编辑的文字，读起来像块不可点的色板。
+     形态只决定描边与底色怎么用，用哪族颜色由 data-tone 决定 */
+  [data-scope='combobox'][data-part='root'][data-variant='outline'] {
+    --xh-_combobox-control-bg: var(--xh-bg-canvas);
+    --xh-_combobox-control-border: var(--xh-border-default);
+    --xh-_combobox-control-border-hover: var(--xh-border-strong);
+  }
+
+  /* 填充式：底色顶替描边，悬停时才浮出一道淡边 */
+  [data-scope='combobox'][data-part='root'][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-default));
+  }
+
+  [data-scope='combobox'][data-part='root'][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-default));
+  }
+
+  [data-scope='combobox'][data-part='label'] {
+    color: var(--xh-combobox-label-fg, var(--xh-fg-muted));
+    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);
+  }
+
+  [data-scope='combobox'][data-part='label'][data-disabled] {
+    color: var(--xh-fg-subtle);
+  }
+
+  /* 画成一个框的是 control 而不是 input：输入框、展开按钮、清空按钮三者要看起来是一体的，
+     边框长在里面任何一个身上都会把另外两个割在框外 */
+  [data-scope='combobox'][data-part='control'] {
+    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));
+    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));
+    border-radius: var(--xh-combobox-control-radius, var(--xh-shape-control));
+    background: var(--xh-combobox-control-bg, var(--xh-_combobox-control-bg));
+    color: var(--xh-combobox-control-fg, var(--xh-fg-default));
+    transition: border-color var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+  }
+
+  [data-scope='combobox'][data-part='control'][hidden] {
+    display: none;
+  }
+
+  /* hover 只在中性态换描边：invalid 正拿边框颜色说事，被 hover 盖掉那条信息就没了 */
+  [data-scope='combobox'][data-part='control']:hover:not([data-disabled], [data-invalid]) {
+    border-color: var(--xh-combobox-control-border-hover, var(--xh-_combobox-control-border-hover));
+  }
+
+  /* 焦点环画在 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));
+    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));
+  }
+
+  /* 只读仍可聚焦、可复制，所以不置灰，只把底色压下去表示"改不动" */
+  [data-scope='combobox'][data-part='control'][data-readonly] {
+    background: var(--xh-combobox-control-bg-readonly, var(--xh-bg-subtle));
+  }
+
+  [data-scope='combobox'][data-part='control'][data-disabled] {
+    background: var(--xh-combobox-control-bg-disabled, var(--xh-bg-subtle));
+    color: var(--xh-fg-disabled);
+    cursor: not-allowed;
+  }
+
+  /* input 是单体表单控件，禁用走原生 disabled（候选那边一律 aria-disabled）。
+     它自己不画框也不画环，两者都归 control */
+  [data-scope='combobox'][data-part='input'] {
+    flex: 1;
+    min-inline-size: 0;
+    block-size: 100%;
+    padding: 0;
+    border: 0;
+    background: transparent;
+    color: inherit;
+    /* 表单控件不继承页面字体，只给字号会让输入框用 UA 默认字族，与周围文本对不上 */
+    font-family: inherit;
+    font-size: var(--xh-combobox-input-font-size, var(--xh-_combobox-font-size));
+    line-height: var(--xh-leading-normal);
+  }
+
+  [data-scope='combobox'][data-part='input'][hidden] {
+    display: none;
+  }
+
+  /* 多行宿主：输入行不再是固定一行高，改由 textarea 自己的行数撑开。
+     两个按钮跟着贴到顶上对齐首行，不然它们会浮在整块文字的正中间 */
+  [data-scope='combobox'][data-part='control']:has([data-part='input'][data-multiline]) {
+    align-items: start;
+    block-size: auto;
+    padding-block: var(--xh-field-py);
+  }
+
+  [data-scope='combobox'][data-part='input'][data-multiline] {
+    block-size: auto;
+    /* 只许纵向拉伸：横向拉宽会把浮层与输入行的对齐拽歪 */
+    resize: vertical;
+  }
+
+  [data-scope='combobox'][data-part='input']::placeholder {
+    color: var(--xh-combobox-placeholder-fg, var(--xh-fg-subtle));
+  }
+
+  /* 焦点环已由 control 的 :focus-within 画好，这里再画一圈会套成两层 */
+  [data-scope='combobox'][data-part='input']:focus-visible {
+    outline: none;
+  }
+
+  [data-scope='combobox'][data-part='input']:disabled {
+    color: var(--xh-fg-disabled);
+    cursor: not-allowed;
+  }
+
+  /* 两个按钮同一副长相：贴在框内右侧的小方钮，不占宽度也不撑高 control */
+  [data-scope='combobox'][data-part='trigger'],
+  [data-scope='combobox'][data-part='clear-trigger'] {
+    display: inline-flex;
+    flex: none;
+    align-items: center;
+    justify-content: center;
+    inline-size: var(--xh-combobox-action-size, var(--xh-control-action-size));
+    block-size: var(--xh-combobox-action-size, var(--xh-control-action-size));
+    padding: 0;
+    border: 0;
+    border-radius: var(--xh-combobox-action-radius, var(--xh-shape-control));
+    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));
+    line-height: var(--xh-leading-none);
+    cursor: pointer;
+    user-select: none;
+    transition: background 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;
+  }
+
+  /* 展开时箭头翻个面，指向与列表的去向一致；transition 要重写全份，只补一条会覆盖掉上面那条 */
+  [data-scope='combobox'][data-part='trigger'] {
+    transition:
+      background var(--xh-motion-duration-micro) var(--xh-motion-ease-enter),
+      rotate var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+  }
+
+  /* 没写内容就由皮肤画箭头；作者往部件里塞了自己的图形，这条规则即不命中 */
+  [data-scope='combobox'][data-part='trigger']:empty::before {
+    content: '▾';
+  }
+
+  /* 同上：没写内容就由皮肤画叉 */
+  [data-scope='combobox'][data-part='clear-trigger']:empty::before {
+    content: '✕';
+  }
+
+  [data-scope='combobox'][data-part='trigger'][data-state='open'] {
+    rotate: 180deg;
+  }
+
+  [data-scope='combobox'][data-part='trigger']:hover:not(:disabled),
+  [data-scope='combobox'][data-part='clear-trigger']:hover:not(:disabled) {
+    background: var(--xh-combobox-action-bg-hover, var(--xh-bg-subtle-hover));
+    color: var(--xh-combobox-action-fg-hover, var(--xh-fg-default));
+  }
+
+  [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));
+  }
+
+  /* 两个按钮都退出了 Tab 序列（tabindex=-1），正常操作走不到这里；
+     留着是给程序化聚焦兜底，落焦时得看得见 */
+  [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);
+  }
+
+  [data-scope='combobox'][data-part='trigger']:disabled,
+  [data-scope='combobox'][data-part='clear-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));
+    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));
+    overflow-y: auto;
+    pointer-events: auto;
+  }
+
+  /* display 会盖掉 hidden 属性的 UA 规则，收起态显式让位 */
+  [data-scope='combobox'][data-part='content'][hidden] {
+    display: none;
+  }
+
+  /* 列表从不承载焦点（焦点恒在输入框，高亮走 aria-activedescendant），
+     可滚动容器在某些浏览器里会被自动塞进 Tab 序列，落焦时不画环 */
+  [data-scope='combobox'][data-part='content']:focus-visible {
+    outline: none;
+  }
+
+  [data-scope='combobox'][data-part='content'][data-state='open'] {
+    animation: xh-fade-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter);
+  }
+
+  [data-scope='combobox'][data-part='item-group'] {
+    display: flex;
+    flex-direction: column;
+  }
+
+  [data-scope='combobox'][data-part='item-group'][hidden] {
+    display: none;
+  }
+
+  /* 组间留白只加在后继分组上：首组顶上已经有 content 的内边距，再加一层会显得头重 */
+  [data-scope='combobox'][data-part='item-group'] + [data-scope='combobox'][data-part='item-group'] {
+    margin-block-start: var(--xh-combobox-group-gap, var(--xh-space-2));
+  }
+
+  /* 分组标题不是候选、进不了导航，画成小号次要文字，内缩与候选对齐（同一个 padding-inline） */
+  [data-scope='combobox'][data-part='item-group-label'] {
+    display: block;
+    padding-block: var(--xh-combobox-group-label-py, var(--xh-space-1));
+    padding-inline: var(--xh-combobox-group-label-px, var(--xh-control-px-sm));
+    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-weight: var(--xh-combobox-group-label-font-weight, var(--xh-font-weight-medium));
+    line-height: var(--xh-leading-none);
+    user-select: none;
+  }
+
+  [data-scope='combobox'][data-part='item-group-label'][hidden] {
+    display: none;
+  }
+
+  [data-scope='combobox'][data-part='item'] {
+    display: flex;
+    align-items: center;
+    gap: var(--xh-combobox-item-gap, var(--xh-_combobox-gap));
+    padding-block: var(--xh-combobox-item-py, var(--xh-space-1));
+    padding-inline: var(--xh-combobox-item-px, var(--xh-control-px-sm));
+    border-radius: var(--xh-combobox-item-radius, var(--xh-shape-control));
+    color: var(--xh-combobox-item-fg, var(--xh-fg-default));
+    font-size: var(--xh-combobox-item-font-size, var(--xh-_combobox-font-size));
+    /* 行高留出文字的上下伸展空间，行内那层 overflow:hidden 才不会把字削掉 */
+    line-height: var(--xh-combobox-item-leading, var(--xh-leading-normal));
+    white-space: nowrap;
+    cursor: pointer;
+    user-select: none;
+  }
+
+  /* 候选按需收起（作者自己藏掉某几条）时要让位，有 display 就得补这条 */
+  [data-scope='combobox'][data-part='item'][hidden] {
+    display: none;
+  }
+
+  /* 只认 data-highlighted，不写 :hover：指针划过时连接层已经把高亮搬过来了，
+     两套底色各画各的会出现"鼠标停在 A 上、回车提交的却是 B" */
+  [data-scope='combobox'][data-part='item'][data-highlighted]:not([data-disabled]) {
+    background: var(--xh-combobox-item-bg-highlight, var(--xh-_combobox-item-highlight-bg));
+  }
+
+  /* 选中只换文字色与字重，配合行尾的 ✓ 标记；底色整条通道留给高亮，
+     两者因此能同时看见 */
+  [data-scope='combobox'][data-part='item'][data-state='checked'] {
+    color: var(--xh-combobox-item-fg-selected, var(--xh-_combobox-item-selected-fg));
+    font-weight: var(--xh-combobox-item-font-weight-selected, var(--xh-font-weight-medium));
+  }
+
+  /* 禁用走 aria-disabled 而非原生 disabled（原生 disabled 不派 click，禁用守卫就走不到），
+     所以只能靠 data-disabled 表达，写 :disabled 永远不命中 */
+  [data-scope='combobox'][data-part='item'][data-disabled] {
+    color: var(--xh-fg-disabled);
+    cursor: not-allowed;
+  }
+
+  [data-scope='combobox'][data-part='item-text'] {
+    flex: 1;
+    /* 弹性项默认 min-width: auto 不肯收缩到内容以下，省略号因此永不生效 */
+    min-inline-size: 0;
+    overflow: hidden;
+    white-space: nowrap;
+    text-overflow: ellipsis;
+  }
+
+  [data-scope='combobox'][data-part='item-text'][hidden] {
+    display: none;
+  }
+
+  /* 勾选标记只在选中项上出现；未选中时占位不塌，切换选中不引起行宽抖动 */
+  [data-scope='combobox'][data-part='item-indicator'] {
+    display: inline-flex;
+    flex: none;
+    align-items: center;
+    justify-content: center;
+    inline-size: var(--xh-combobox-item-indicator-size, var(--xh-control-indicator-size));
+    color: var(--xh-combobox-item-indicator-fg, var(--xh-_combobox-accent));
+    visibility: hidden;
+  }
+
+  [data-scope='combobox'][data-part='item-indicator'][hidden] {
+    display: none;
+  }
+
+  /* 同上：没写内容就由皮肤画勾 */
+  [data-scope='combobox'][data-part='item-indicator']:empty::before {
+    content: '✓';
+  }
+
+  [data-scope='combobox'][data-part='item-indicator'][data-state='checked'] {
+    visibility: visible;
+  }
+
+  [data-scope='combobox'][data-part='item-indicator'][data-disabled] {
+    color: var(--xh-fg-disabled);
+  }
+
+  /* 空态提示是列表之外的一句状态播报（role=status），不进 role=listbox。
+     它与 content 是兄弟，因此要自带浮层的那身皮，否则会光秃秃地飘在页面上 */
+  [data-scope='combobox'][data-part='empty'] {
+    display: block;
+    padding-block: var(--xh-combobox-empty-py, var(--xh-space-3));
+    padding-inline: var(--xh-combobox-empty-px, var(--xh-control-px-md));
+    border: var(--xh-stroke-thin) solid var(--xh-combobox-empty-border, var(--xh-border-default));
+    border-radius: var(--xh-combobox-empty-radius, var(--xh-shape-surface));
+    background: var(--xh-combobox-empty-bg, var(--xh-bg-surface));
+    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));
+    text-align: center;
+    pointer-events: auto;
+  }
+
+  /* 漏了这条，候选一有结果空态提示就永远撤不下去（上面那条 display 盖掉了 UA 的 [hidden] 规则） */
+  [data-scope='combobox'][data-part='empty'][hidden] {
+    display: none;
+  }
+}

package/css/composer.css

@@ -0,0 +1,127 @@
+@layer xihan.components {
+  /* 边框画在 root 上，内部 textarea 无边框；align-items: flex-end 让按钮随输入框长高贴着底边 */
+  [data-scope='composer'][data-part='root'] {
+    /* 输入与发送按钮共用的控件高度 */
+    --xh-_composer-control-h: var(--xh-composer-submit-h, var(--xh-control-h-md));
+
+    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));
+    border: var(--xh-stroke-thin) solid var(--xh-composer-border, var(--xh-border-default));
+    border-radius: var(--xh-composer-radius, var(--xh-shape-surface));
+    background: var(--xh-composer-bg, var(--xh-bg-surface));
+  }
+
+  /* 上面声明的 display 会盖掉 UA 的 [hidden]{display:none}，这里补回 */
+  [data-scope='composer'][data-part='root'][hidden] {
+    display: none;
+  }
+
+  /* 焦点环画在整个框上；用 focus-within 使焦点落在发送按钮时同样点亮 */
+  [data-scope='composer'][data-part='root']:focus-within {
+    outline: var(--xh-ring-width) solid var(--xh-ring-focus);
+    outline-offset: var(--xh-ring-offset);
+  }
+
+  /* 禁用态罩住整框，内部 textarea 与按钮另有原生 disabled 管交互 */
+  [data-scope='composer'][data-part='root'][data-disabled] {
+    cursor: not-allowed;
+    opacity: var(--xh-state-disabled-opacity);
+  }
+
+  /* 无边框透明底，融进 root 的框里；min-inline-size: 0 防止长内容把弹性子项撑出容器 */
+  [data-scope='composer'][data-part='input'] {
+    flex: 1;
+    min-inline-size: 0;
+    /* 上下留白把单行文本盒撑到控件高度，文字中线与按钮中线对齐 */
+    padding-block: calc((var(--xh-_composer-control-h) - 1lh) / 2);
+    padding-inline: 0;
+    border: 0;
+    background: transparent;
+    color: var(--xh-composer-input-fg, var(--xh-fg-default));
+    /* 表单控件默认不继承页面字族，显式继承 */
+    font-family: inherit;
+    font-size: var(--xh-composer-input-font-size, var(--xh-text-body-size));
+    line-height: var(--xh-leading-normal);
+    /* 高度由 field-sizing 随内容变，不支持的引擎退化为 rows 定下的固定行数；
+       配套禁用 resize，避免拖拽写死的高度盖掉它。 */
+    field-sizing: content;
+    resize: none;
+  }
+
+  /* 焦点环已画在 root 上，这里去掉自身的环 */
+  [data-scope='composer'][data-part='input']:focus-visible {
+    outline: none;
+  }
+
+  [data-scope='composer'][data-part='input']::placeholder {
+    color: var(--xh-composer-placeholder-fg, var(--xh-fg-subtle));
+  }
+
+  /* textarea 是单体表单控件，禁用走原生 disabled */
+  [data-scope='composer'][data-part='input']:disabled {
+    color: var(--xh-fg-disabled);
+    cursor: not-allowed;
+  }
+
+  /* 私有变量槽位，send 与 stop 两个模式只换这几个配色值 */
+  [data-scope='composer'][data-part='submit-trigger'] {
+    --xh-_bg: var(--xh-composer-send-bg, var(--xh-bg-brand));
+    --xh-_bg-hover: var(--xh-composer-send-bg-hover, var(--xh-bg-brand-hover));
+    --xh-_bg-active: var(--xh-composer-send-bg-active, var(--xh-bg-brand-active));
+    --xh-_fg: var(--xh-composer-send-fg, var(--xh-fg-on-brand));
+
+    display: inline-flex;
+    /* 按钮不参与弹性伸缩 */
+    flex: none;
+    align-items: center;
+    justify-content: center;
+    min-inline-size: var(--xh-_composer-control-h);
+    block-size: var(--xh-_composer-control-h);
+    padding-inline: var(--xh-composer-submit-px, var(--xh-control-px-md));
+    border: 0;
+    border-radius: var(--xh-composer-submit-radius, var(--xh-shape-control));
+    background: var(--xh-_bg);
+    color: var(--xh-_fg);
+    font-family: inherit;
+    font-size: var(--xh-composer-submit-font-size, var(--xh-text-label-size));
+    font-weight: var(--xh-composer-submit-font-weight, var(--xh-text-label-weight));
+    line-height: var(--xh-leading-none);
+    white-space: nowrap;
+    cursor: pointer;
+    user-select: none;
+    transition: background var(--xh-motion-duration-micro) var(--xh-motion-ease-enter);
+  }
+
+  [data-scope='composer'][data-part='submit-trigger'][hidden] {
+    display: none;
+  }
+
+  [data-scope='composer'][data-part='submit-trigger']:hover:not(:disabled) {
+    background: var(--xh-_bg-hover);
+  }
+
+  [data-scope='composer'][data-part='submit-trigger']:active:not(:disabled) {
+    background: var(--xh-_bg-active);
+  }
+
+  [data-scope='composer'][data-part='submit-trigger']:focus-visible {
+    outline: var(--xh-ring-width) solid var(--xh-ring-focus);
+    outline-offset: var(--xh-ring-offset);
+  }
+
+  /* 停止模式只换配色，从主色降到中性；文案与可访问名由连接层切换 */
+  [data-scope='composer'][data-part='submit-trigger'][data-mode='stop'] {
+    --xh-_bg: var(--xh-composer-stop-bg, var(--xh-bg-subtle));
+    --xh-_bg-hover: var(--xh-composer-stop-bg-hover, var(--xh-bg-subtle-hover));
+    --xh-_bg-active: var(--xh-composer-stop-bg-active, var(--xh-bg-subtle-active));
+    --xh-_fg: var(--xh-composer-stop-fg, var(--xh-fg-default));
+  }
+
+  /* 禁用走原生 disabled，输入为空时按钮转灰但不收起 */
+  [data-scope='composer'][data-part='submit-trigger']:disabled {
+    color: var(--xh-fg-disabled);
+    cursor: not-allowed;
+  }
+}