@xihan-ui/styles 3.1.0 → 4.0.0

package/dist/css/tags-input.css

@@ -0,0 +1,341 @@
+/*
+ * Copyright (c) 2021-Present XiHanFun and contributors.
+ * Licensed under the MIT License. See LICENSE in the project root for license information.
+ */
+
+/* TagsInput 独立皮肤同时传递引入字段视觉盒与字段内动作；full bundle 递归去重。 */
+@import '../family/field-chrome.css';
+@import '../family/action-control.css';
+/* 标签的进场与退场取共享关键帧。 */
+@import '../family/motion.css';
+
+@layer xihan.components {
+  /* 皮肤在场的标记：开发模式下按 scope 探一次，取不到就说明这份皮肤没被引入。 */
+  .xh-scope-tags-input {
+    --xh-tags-input-skin: 1;
+  }
+
+  /* root 只负责纵向堆叠：标题一行、控件一行。可见的那个"框"长在 control 上，
+     因为标签、输入框、清空按钮都在它里面，边框必须把三者一起圈住。
+     组件层只把既有公开槽映射到家族合同；形态三档由家族按 control 上的 data-variant 生成，皮肤不再声明 */
+  .xh-scope-tags-input[data-part='root'] {
+    /* 作者塞进来的图标跟着控件的尺寸档走；它自己写了 size 时仍以作者的为准 */
+    --xh-icon-size: var(--xh-tags-input-icon-size, var(--xh-glyph-size-md));
+
+    /* 尺寸档只换这几个私有槽，标题、框、输入框与就地编辑框都从 root 继承它们，
+       换档不必给每个部件各写一条选择器。标签本身是 tag，档位由 data-size 传下去，不走这些槽；
+       就地编辑框的块尺寸、行框、内衬与字号照 tag 那一档写（块尺寸取状态 chip 档、竖向内衬为 0），
+       换进换出时与标签一样高 */
+    --xh-_tags-input-control-h: var(--xh-control-h-md);
+    --xh-_tags-input-control-px: var(--xh-control-px-md);
+    --xh-_tags-input-control-gap: var(--xh-space-1);
+    --xh-_tags-input-input-font-size: var(--xh-control-font-md);
+    --xh-_tags-input-item-font-size: var(--xh-control-caption-md);
+    --xh-_tags-input-item-h: var(--xh-chip-h-md);
+    --xh-_tags-input-item-py: 0;
+    --xh-_tags-input-item-px: var(--xh-space-2);
+    --xh-_tags-input-item-line-h: var(--xh-control-indicator-md);
+    /* 光标走到的那颗标签是「当前项」，不是选中：淡底 + 淡底前景，随语气走。
+       没写 data-tone 时 --xh-_tone-* 没被声明，退回品牌淡底 */
+    --xh-_tags-input-accent: var(--xh-_tone-subtle, var(--xh-bg-brand-subtle));
+    --xh-_tags-input-accent-fg: var(--xh-_tone-fg, var(--xh-fg-on-brand-subtle));
+
+    display: inline-flex;
+    flex-direction: column;
+    gap: var(--xh-tags-input-gap, var(--xh-space-1));
+    /* 不传尺寸时一律这么宽，宽度不随内容走；父容器给不出这么宽时整件跟着收，地板同步让步，不越出父容器。
+       地板不高过缺省宽：使用者把缺省宽钉到底线以下时不必再放开底线 */
+    inline-size: var(--xh-tags-input-control-w, var(--xh-control-w));
+    min-inline-size: min(var(--xh-tags-input-control-w, var(--xh-control-w)), var(--xh-tags-input-control-min-w, var(--xh-control-min-w)), 100%);
+    max-inline-size: 100%;
+  }
+
+  /* 只要声明了 display 就盖掉了 UA 的 [hidden]{display:none}，收起态得自己还回去 */
+  .xh-scope-tags-input[data-part='root'][hidden] {
+    display: none;
+  }
+
+  /* —— 尺寸 —— */
+  .xh-scope-tags-input[data-part='root'][data-size='sm'] {
+    --xh-icon-size: var(--xh-tags-input-icon-size, var(--xh-glyph-size-sm));
+    --xh-_tags-input-control-h: var(--xh-control-h-sm);
+    --xh-_tags-input-control-px: var(--xh-control-px-sm);
+    --xh-_tags-input-input-font-size: var(--xh-control-font-sm);
+    --xh-_tags-input-item-font-size: var(--xh-control-caption-sm);
+    --xh-_tags-input-item-h: var(--xh-chip-h-sm);
+    --xh-_tags-input-item-px: var(--xh-space-1_5);
+  }
+
+  .xh-scope-tags-input[data-part='root'][data-size='lg'] {
+    --xh-icon-size: var(--xh-tags-input-icon-size, var(--xh-glyph-size-lg));
+    --xh-_tags-input-control-h: var(--xh-control-h-lg);
+    --xh-_tags-input-control-px: var(--xh-control-px-lg);
+    --xh-_tags-input-input-font-size: var(--xh-control-font-lg);
+    --xh-_tags-input-item-font-size: var(--xh-control-caption-lg);
+    --xh-_tags-input-item-h: var(--xh-chip-h-lg);
+    --xh-_tags-input-item-px: var(--xh-space-3);
+    --xh-_tags-input-item-line-h: var(--xh-control-indicator-lg);
+  }
+
+  .xh-scope-tags-input[data-part='label'] {
+    /* 竖排时标签与控件之间的距离：根的 gap 之上补一段差值，--xh-tags-input-label-gap 给多少最终就是多少 */
+    margin-block-end: calc(var(--xh-tags-input-label-gap, var(--xh-space-2)) - var(--xh-tags-input-gap, var(--xh-space-1)));
+    color: var(--xh-tags-input-label-fg, var(--xh-fg-muted));
+    font-size: var(--xh-tags-input-label-font-size, var(--xh-text-label-size));
+    font-weight: var(--xh-tags-input-label-font-weight, var(--xh-text-label-weight));
+  }
+
+  .xh-scope-tags-input[data-part='label'][data-disabled] {
+    color: var(--xh-tags-input-label-fg-disabled, var(--xh-fg-muted));
+  }
+
+  /* 标签换行排，输入框跟在最后一个标签后面：描边、底色、圆角、聚焦环、五态与悬停由 Field Chrome
+     家族画在 control 上，可换行、自动高、半档纵向内衬与「只有一个标签时仍像普通输入框」的最小高
+     由家族按 multi-tag 布局给。组件只映射既有公开槽；只读时盒上不是文本光标 */
+  .xh-scope-tags-input[data-part='control'] {
+    --xh-field-control-height: var(--xh-tags-input-control-h, var(--xh-_tags-input-control-h));
+    --xh-field-control-padding-inline: var(--xh-tags-input-control-px, var(--xh-_tags-input-control-px));
+    --xh-field-control-gap: var(--xh-tags-input-control-gap, var(--xh-_tags-input-control-gap));
+    --xh-field-control-min-inline-size: var(--xh-tags-input-control-min-w, var(--xh-control-min-w));
+    --xh-field-control-radius: var(--xh-tags-input-control-radius, var(--xh-shape-control));
+    --xh-field-bg-rest: var(--xh-tags-input-control-bg, var(--xh-_field-variant-bg-rest));
+    --xh-field-bg-hover: var(--xh-tags-input-control-bg-hover, var(--xh-_field-variant-bg-hover));
+    --xh-field-bg-read-only: var(--xh-tags-input-control-bg-readonly, var(--xh-_field-variant-bg-read-only));
+    --xh-field-bg-disabled: var(--xh-tags-input-control-bg-disabled, var(--xh-_field-variant-bg-disabled));
+    --xh-field-fg-rest: var(--xh-tags-input-control-fg, var(--xh-fg-default));
+    --xh-field-border-rest: var(--xh-tags-input-control-border, var(--xh-_field-variant-border-rest));
+    --xh-field-border-hover: var(--xh-tags-input-control-border-hover, var(--xh-_field-variant-border-hover));
+    --xh-field-border-focus: var(--xh-tags-input-control-border-focus, var(--xh-_field-variant-border-focus));
+    --xh-field-border-invalid: var(--xh-tags-input-control-border-invalid, var(--xh-_field-variant-border-invalid));
+    --xh-field-shadow-rest: var(--xh-tags-input-control-shadow, none);
+    --xh-field-cursor-read-only: default;
+    /* 家族 chrome 会重写 --xh-icon-size，使用者图标槽必须经桥接槽下发才能在盒内生效 */
+    --xh-field-glyph-size: var(--xh-tags-input-icon-size, var(--xh-_field-size-glyph-size));
+
+    /* 标签一多就换行，行数没有尽头：框到这个高度就不再长，剩下的标签在框内滚出来。
+       上限取滚动面最小的那一档，与页面上其它滚动面用同一把尺 */
+    max-block-size: var(--xh-tags-input-control-max-h, var(--xh-viewport-h-sm));
+    overflow-y: auto;
+    /* 删掉的标签由替身绝对定位在原处播完退场，定位基准是这个框（随框内滚动一起走） */
+    position: relative;
+  }
+
+  .xh-scope-tags-input[data-part='control'][hidden] {
+    display: none;
+  }
+
+  /* 盒里有标签时起始内衬收到 --xh-space-1，标签之间、标签与输入框之间隔 --xh-space-1（盒的 gap 缺省就是它）：
+     标签自带内距，行首再留一整段控件内衬就显得空。标签自己的面（没聚焦时白底 + 描边）写在 tag.css 的字段宿主档 */
+  .xh-scope-tags-input[data-part='control']:has(> .xh-scope-tags-input[data-part='item']) {
+    padding-inline-start: var(--xh-tags-input-control-ps, var(--xh-space-1));
+  }
+
+  /* 顶到上限是 TagsInput 独有状态：再加进不去，边框先给个提示；invalid 同时出现时由 Field Chrome 的
+     错误态优先——真出错比"装满了"要紧 */
+  .xh-scope-tags-input[data-part='control'][data-at-max]:not([data-invalid]) {
+    border-color: var(--xh-tags-input-control-border-at-max, var(--xh-border-at-limit));
+  }
+
+  /* 输入框贴着标签排：无边框无底无圆角无落影由家族重置，那两样归 control。
+     min-inline-size 保证标签占满一行后它还能换到下一行继续输入，而不是被挤成零宽；
+     占位与自动填充的颜色经桥接槽下发 */
+  .xh-scope-tags-input[data-part='input'] {
+    --xh-field-input-fg: var(--xh-tags-input-input-fg, var(--xh-fg-default));
+    --xh-field-input-font-size: var(--xh-tags-input-input-font-size, var(--xh-_tags-input-input-font-size));
+    --xh-field-placeholder-fg: var(--xh-tags-input-placeholder-fg, var(--xh-fg-subtle));
+    --xh-field-autofill-bg: var(--xh-tags-input-input-autofill-bg, var(--xh-bg-canvas));
+    --xh-field-autofill-fg: var(--xh-tags-input-input-autofill-fg, var(--xh-fg-default));
+
+    /* 撑满剩余宽度由家族的 flex: 1 1 auto 给，这里只换起算宽 */
+    flex-basis: var(--xh-tags-input-input-basis, 6rem);
+    min-inline-size: var(--xh-tags-input-input-min-w, var(--xh-control-input-min-w));
+    /* 行盒收到标签那一行的高度以内，输入框不去顶高整个框 */
+    block-size: auto;
+    line-height: var(--xh-leading-tight);
+  }
+
+  /* 一个标签一个条目。条目只是壳：可见的胶囊是里面 tag 的 root（就地编辑时换成 item-input），
+     样子全归 tag.css，这里只管它在行里怎么占位——不缩、不超过一行；
+     长标签由壳的上限压住，截断落在 tag 自己的 label 上 */
+  .xh-scope-tags-input[data-part='item'] {
+    display: inline-flex;
+    flex: none;
+    align-items: center;
+    max-inline-size: 100%;
+    /* 前面的标签增删、其余标签换到新位置时，由列表动效先反向补偿、再沿这条过渡滑过去 */
+    transition: translate var(--xh-motion-duration-move) var(--xh-motion-ease-continuous);
+  }
+
+  /* 新落下的标签原地弹出，同一批按到达顺序错开；首帧就在的直接呈现（自己或 control 带 data-instant）。
+     横排胶囊不用竖向上浮：与来源方向不符，还会探出字段外壳的底边 */
+  .xh-scope-tags-input[data-part='item']:not([data-instant], [data-instant] > :where(.xh-scope-tags-input)) {
+    animation: xh-pop-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter-strong) backwards;
+    animation-delay: calc(var(--xh-_stagger-index, 0) * var(--xh-motion-stagger-step));
+  }
+
+  /* 删掉的标签：替身留在原处淡出，播完即移除 */
+  .xh-scope-tags-input[data-part='item'][data-state='closed'] {
+    animation: xh-fade-out var(--xh-motion-duration-exit) var(--xh-motion-ease-exit) forwards;
+  }
+
+  .xh-scope-tags-input[data-part='item'][hidden] {
+    display: none;
+  }
+
+  /* 双击标签是进就地编辑，不是选字：选区一闪再换成编辑框，看起来像点错了 */
+  .xh-scope-tags-input[data-part='item'] > .xh-scope-tag[data-part='root'] {
+    user-select: none;
+  }
+
+  /* 光标走到这颗标签上（退格第一下、方向键）：整颗换成「当前项」的淡底，与"删掉它"这件事对得上。
+     反白画在 tag 的 root 上，描边一并收成透明——描边档的标签反白后不留一圈异色边；
+     禁用态下不给高亮：那时候本来就走不进标签 */
+  .xh-scope-tags-input[data-part='item'][data-highlighted]:not([data-disabled]) > .xh-scope-tag[data-part='root'] {
+    border-color: transparent;
+    background: var(--xh-tags-input-item-bg-highlight, var(--xh-_tags-input-accent));
+    color: var(--xh-tags-input-item-fg-highlight, var(--xh-_tags-input-accent-fg));
+  }
+
+  /* 反白的面是语气淡底，环压上去与面同族看不出来；叉自己的面是透空的，环取它的字色——
+     上面那条反白规则已经把它换成配对的那支色 */
+  .xh-scope-tags-input[data-part='item'][data-highlighted]:not([data-disabled]) > .xh-scope-tag[data-part='root']
+    .xh-scope-tag[data-part='close-trigger']:focus-visible {
+    --xh-_ring-color: currentColor;
+  }
+
+  /* 就地编辑框：尺寸对齐胶囊，看起来像是在原地把标签改了，而不是另开一个框。
+     阶梯照 tag 的档走：行框取指示符档，竖向内衬、横向内衬与字号随档从 root 的私有槽取。
+     不声明 display —— 收起态靠 UA 的 [hidden]{display:none} 就够，
+     自己加一条 display 反而要再补一条 [hidden] 规则去抵消它 */
+  .xh-scope-tags-input[data-part='item-input'] {
+    /* 宽随正在改的那几个字走，不取原生 input 按 20 个字符算出来的宽：字段缺省宽只有 16rem，
+       一个 20 字符宽的编辑框会把后面的输入框挤到下一行，进编辑态时框就长高了 */
+    field-sizing: content;
+    inline-size: auto;
+    min-inline-size: 3ch;
+    max-inline-size: 100%;
+    box-sizing: border-box;
+    min-block-size: var(--xh-tags-input-item-h, var(--xh-_tags-input-item-h));
+    padding-block: var(--xh-tags-input-item-py, var(--xh-_tags-input-item-py));
+    padding-inline: var(--xh-tags-input-item-px, var(--xh-_tags-input-item-px));
+    border: var(--xh-stroke-thin) solid var(--xh-tags-input-item-input-border, var(--xh-border-control));
+    border-radius: var(--xh-tags-input-item-radius, var(--xh-shape-control));
+    background: var(--xh-tags-input-item-input-bg, var(--xh-bg-field));
+    color: var(--xh-tags-input-item-input-fg, var(--xh-fg-default));
+    font-family: inherit;
+    font-size: var(--xh-tags-input-item-font-size, var(--xh-_tags-input-item-font-size));
+    /* 行框不低于胶囊里那一行的高，编辑框与它换掉的标签一样高，换进换出时行不跳 */
+    line-height: max(calc(var(--xh-leading-none) * 1em), var(--xh-_tags-input-item-line-h));
+  }
+
+  /* 它是真正持有焦点的那个节点，照字段外壳标出焦点：换承载面底 + 品牌描边，不画环；
+     外层 control 同时按 :focus-within 换成聚焦面，两层一起说明焦点在框内 */
+  .xh-scope-tags-input[data-part='item-input']:focus-within {
+    border-color: var(--xh-tags-input-item-input-border-focus, var(--xh-border-control-focus));
+    background: var(--xh-tags-input-item-input-bg-focus, var(--xh-bg-surface));
+  }
+
+  .xh-scope-tags-input[data-part='item-input']:focus-visible {
+    outline: none;
+  }
+
+  /* 校验失败时描边跟着外框换无效色，两层相邻不至于一红一蓝 */
+  .xh-scope-tags-input[data-part='control'][data-invalid] .xh-scope-tags-input[data-part='item-input'] {
+    border-color: var(--xh-tags-input-item-input-border-invalid, var(--xh-border-invalid));
+  }
+
+  .xh-scope-tags-input[data-part='item-input']:disabled {
+    color: var(--xh-fg-disabled);
+  }
+
+  /* 清空按钮贴在框的末端，与输入框同一行：正方视觉盒、inset 圆角、悬停 100 / 按下 200 与 0.97 按压、
+     粗指针热区与 :focus-visible 关环全由 Action Control 的 field-inset ghost 档给，组件只映射既有覆盖槽。
+     没值可清时连接层给 hidden 收起 */
+  .xh-scope-tags-input[data-part='clear-trigger'] {
+    --xh-action-visual-size: var(--xh-tags-input-action-size, var(--xh-_action-profile-visual-size));
+    --xh-action-min-inline-size: var(--xh-tags-input-action-size, var(--xh-_action-profile-visual-size));
+    --xh-action-radius: var(--xh-tags-input-action-radius, var(--xh-shape-inset));
+    /* 底色阶梯由 ghost 档给（透明 → 100 → 200），使用者槽只作覆盖入口 */
+    --xh-action-bg-rest: var(--xh-tags-input-action-bg, var(--xh-_action-variant-bg-rest));
+    --xh-action-bg-hover: var(--xh-tags-input-action-bg-hover, var(--xh-_action-variant-bg-hover));
+    --xh-action-bg-pressed: var(--xh-tags-input-action-bg-active, var(--xh-_action-variant-bg-pressed));
+    --xh-action-fg-rest: var(--xh-tags-input-action-fg, var(--xh-fg-muted));
+    --xh-action-fg-hover: var(--xh-tags-input-action-fg-hover, var(--xh-fg-default));
+    --xh-action-border-rest: transparent;
+    --xh-action-highlight-rest: transparent;
+    --xh-action-shadow-rest: none;
+    --xh-action-shadow-hover: none;
+    --xh-action-shadow-pressed: none;
+    --xh-action-font-size: var(--xh-tags-input-action-font-size, var(--xh-text-secondary-size));
+    /* 配方尚未把 profile 字形档灌进 --xh-icon-size，钮内字形先按 field-inset 档逐钮取值 */
+    --xh-icon-size: var(--xh-_action-profile-glyph-size);
+
+    border-width: 0;
+  }
+
+  /* 没值可清时连接层只打 hidden；家族那条 display 会盖掉 UA 规则，少了这条按钮就一直杵着 */
+  .xh-scope-tags-input[data-part='clear-trigger'][hidden] {
+    display: none;
+  }
+
+  /* 没写内容就由皮肤画兜底字形；作者往部件里塞了自己的图形，这几条即不命中 */
+  .xh-scope-tags-input[data-part='clear-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;
+  }
+
+  /* 计数：排在控件行下面靠尾端的一行小字，与标题分列 root 的两端。它是次级标注，取说明档字号，不随控件档 */
+  .xh-scope-tags-input[data-part='count'] {
+    align-self: flex-end;
+    color: var(--xh-tags-input-count-fg, var(--xh-fg-muted));
+    font-size: var(--xh-tags-input-count-font-size, var(--xh-text-caption-size));
+    font-variant-numeric: tabular-nums;
+    line-height: var(--xh-leading-normal);
+  }
+
+  /* 没开 showCount 时连接层给的是 hidden 属性；上面那条 align-self 不影响显隐，
+     但作者层给这个 part 声明任何一条 display 都会盖掉 UA 规则，这条把它还回去 */
+  .xh-scope-tags-input[data-part='count'][hidden] {
+    display: none;
+  }
+
+  /* 顶到上限：数字先于框被看见，与越界那一档同族颜色 */
+  .xh-scope-tags-input[data-part='count'][data-at-max] {
+    color: var(--xh-tags-input-count-fg-at-max, var(--xh-fg-warning));
+  }
+
+  .xh-scope-tags-input[data-part='count'][data-disabled] {
+    color: var(--xh-tags-input-count-fg-disabled, var(--xh-fg-disabled));
+  }
+
+  @media (forced-colors: active) {
+    /* 兜底字形是 mask 挖出来的一块底色，这一档里底色被系统换成 Canvas，字形跟着消失。
+       字形退出强制换色、直接写系统色（不能取 currentColor：退出强制换色的伪元素读到的是被系统换掉之前的作者色）：
+       按钮面上取 ButtonText，悬停与按下时家族把按钮涂成 Highlight、字形换 HighlightText；
+       禁用取 GrayText */
+    .xh-scope-tags-input[data-part='clear-trigger']:empty::before {
+      forced-color-adjust: none;
+      background-color: ButtonText;
+    }
+
+    .xh-scope-tags-input[data-part='clear-trigger']:not([data-disabled]):not([data-loading]):is(:hover, :active, [data-pressed]):empty::before {
+      background-color: HighlightText;
+    }
+
+    .xh-scope-tags-input[data-part='clear-trigger'][data-disabled]:empty::before {
+      background-color: GrayText;
+    }
+
+    /* 就地编辑框聚焦不画环、描边又被换成系统色，补一圈 Highlight 环 */
+    .xh-scope-tags-input[data-part='item-input']:focus {
+      outline: var(--xh-ring-width) solid Highlight;
+      outline-offset: var(--xh-ring-offset);
+    }
+  }
+}

package/dist/css/text-field.css

@@ -0,0 +1,197 @@
+/*
+ * Copyright (c) 2021-Present XiHanFun and contributors.
+ * Licensed under the MIT License. See LICENSE in the project root for license information.
+ */
+
+/* TextField 独立皮肤同时传递引入字段视觉盒与字段内动作；full bundle 递归去重。 */
+@import '../family/field-chrome.css';
+@import '../family/action-control.css';
+
+@layer xihan.components {
+  .xh-scope-text-field {
+    --xh-text-field-skin: 1;
+  }
+
+  /* 组件层只把既有公开槽映射到家族合同，并保留 label/count 等 TextField 专属结构；
+     形态三档由家族按 control 上的 data-variant 生成，皮肤不再声明。 */
+  .xh-scope-text-field[data-part='root'] {
+    --xh-_text-field-h: var(--xh-control-h-md);
+    --xh-_text-field-px: var(--xh-control-px-md);
+    --xh-_text-field-gap: var(--xh-control-gap-md);
+    --xh-_text-field-font-size: var(--xh-control-font-md);
+    --xh-_text-field-action-font-size: var(--xh-control-caption-md);
+
+    --xh-icon-size: var(--xh-text-field-icon-size, var(--xh-glyph-size-md));
+
+    display: inline-flex;
+    flex-direction: column;
+    gap: var(--xh-text-field-gap, var(--xh-space-1));
+    /* 不传尺寸时一律这么宽，宽度不随内容走；父容器给不出这么宽时整件跟着收，地板同步让步，不越出父容器。
+       地板不高过缺省宽：使用者把缺省宽钉到底线以下时不必再放开底线 */
+    inline-size: var(--xh-text-field-control-w, var(--xh-control-w));
+    min-inline-size: min(var(--xh-text-field-control-w, var(--xh-control-w)), var(--xh-text-field-control-min-w, var(--xh-control-min-w)), 100%);
+    max-inline-size: 100%;
+  }
+
+  .xh-scope-text-field[data-part='root'][hidden] {
+    display: none;
+  }
+
+  .xh-scope-text-field[data-part='root'][data-size='sm'] {
+    --xh-_text-field-h: var(--xh-control-h-sm);
+    --xh-_text-field-px: var(--xh-control-px-sm);
+    --xh-_text-field-gap: var(--xh-control-gap-sm);
+    --xh-_text-field-font-size: var(--xh-control-font-sm);
+    --xh-_text-field-action-font-size: var(--xh-control-caption-sm);
+    --xh-icon-size: var(--xh-text-field-icon-size, var(--xh-glyph-size-sm));
+  }
+
+  .xh-scope-text-field[data-part='root'][data-size='lg'] {
+    --xh-_text-field-h: var(--xh-control-h-lg);
+    --xh-_text-field-px: var(--xh-control-px-lg);
+    --xh-_text-field-gap: var(--xh-control-gap-lg);
+    --xh-_text-field-font-size: var(--xh-control-font-lg);
+    --xh-_text-field-action-font-size: var(--xh-control-caption-lg);
+    --xh-icon-size: var(--xh-text-field-icon-size, var(--xh-glyph-size-lg));
+  }
+
+  .xh-scope-text-field[data-part='label'] {
+    /* 竖排时标签与控件之间的距离：根的 gap 之上补一段差值，--xh-text-field-label-gap 给多少最终就是多少 */
+    margin-block-end: calc(var(--xh-text-field-label-gap, var(--xh-space-2)) - var(--xh-text-field-gap, var(--xh-space-1)));
+    color: var(--xh-text-field-label-fg, var(--xh-fg-muted));
+    font-size: var(--xh-text-field-label-font-size, var(--xh-text-label-size));
+    font-weight: var(--xh-text-field-label-font-weight, var(--xh-text-label-weight));
+  }
+
+  .xh-scope-text-field[data-part='label'][data-disabled] {
+    color: var(--xh-text-field-label-fg-disabled, var(--xh-fg-muted));
+  }
+
+  .xh-scope-text-field[data-part='control'] {
+    --xh-field-control-height: var(--xh-text-field-control-h, var(--xh-_text-field-h));
+    --xh-field-control-padding-inline: var(--xh-text-field-control-px, var(--xh-_text-field-px));
+    --xh-field-control-gap: var(--xh-text-field-control-gap, var(--xh-_text-field-gap));
+    --xh-field-control-min-inline-size: var(--xh-text-field-control-min-w, var(--xh-control-min-w));
+    --xh-field-control-radius: var(--xh-text-field-control-radius, var(--xh-shape-control));
+    --xh-field-bg-rest: var(--xh-text-field-control-bg, var(--xh-_field-variant-bg-rest));
+    --xh-field-bg-hover: var(--xh-text-field-control-bg-hover, var(--xh-_field-variant-bg-hover));
+    --xh-field-bg-read-only: var(--xh-text-field-control-bg-readonly, var(--xh-_field-variant-bg-read-only));
+    --xh-field-bg-disabled: var(--xh-text-field-control-bg-disabled, var(--xh-_field-variant-bg-disabled));
+    --xh-field-fg-rest: var(--xh-text-field-control-fg, var(--xh-fg-default));
+    --xh-field-border-rest: var(--xh-text-field-control-border, var(--xh-_field-variant-border-rest));
+    --xh-field-border-hover: var(--xh-text-field-control-border-hover, var(--xh-_field-variant-border-hover));
+    --xh-field-border-focus: var(--xh-text-field-control-border-focus, var(--xh-_field-variant-border-focus));
+    --xh-field-border-invalid: var(--xh-text-field-control-border-invalid, var(--xh-_field-variant-border-invalid));
+    --xh-field-shadow-rest: var(--xh-text-field-control-shadow, none);
+    /* 家族 chrome 会重写 --xh-icon-size，使用者图标槽必须经桥接槽下发才能在盒内生效 */
+    --xh-field-glyph-size: var(--xh-text-field-icon-size, var(--xh-_field-size-glyph-size));
+  }
+
+  .xh-scope-text-field[data-part='prefix'],
+  .xh-scope-text-field[data-part='suffix'] {
+    --xh-field-affix-fg: var(--xh-text-field-affix-fg, var(--xh-fg-muted));
+    --xh-field-affix-fg-disabled: var(--xh-text-field-affix-fg-disabled, var(--xh-fg-disabled));
+    --xh-field-affix-font-size: var(--xh-text-field-affix-font-size, var(--xh-_text-field-font-size));
+  }
+
+  .xh-scope-text-field[data-part='input'] {
+    --xh-field-input-fg: var(--xh-text-field-input-fg, var(--xh-fg-default));
+    --xh-field-input-font-size: var(--xh-text-field-input-font-size, var(--xh-_text-field-font-size));
+    --xh-field-placeholder-fg: var(--xh-text-field-placeholder-fg, var(--xh-fg-subtle));
+    --xh-field-autofill-bg: var(--xh-text-field-input-autofill-bg, var(--xh-bg-canvas));
+    --xh-field-autofill-fg: var(--xh-text-field-input-autofill-fg, var(--xh-fg-default));
+    --xh-field-textarea-padding-block: var(--xh-text-field-textarea-py, var(--xh-space-1));
+  }
+
+  .xh-scope-text-field[data-part='control'][hidden] {
+    display: none;
+  }
+
+  /* autoSize 的量高值写在 textarea 上；外壳只负责滚动上限，不能复制量高算法。 */
+  .xh-scope-text-field[data-part='control']:has([data-xh-field-input][data-xh-field-auto-size]) {
+    max-block-size: var(--xh-text-field-control-max-h, var(--xh-viewport-h-sm));
+    overflow-y: auto;
+  }
+
+  /* 字数上限是 TextField 独有状态；invalid 同时出现时由 Field Chrome 的错误态优先。 */
+  .xh-scope-text-field[data-part='control'][data-at-max]:not([data-invalid]) {
+    border-color: var(--xh-text-field-control-border-at-max, var(--xh-border-at-limit));
+  }
+
+  /* clear 的视觉、悬停/按压阶梯与粗指针热区来自 field-inset ghost 档，组件只映射既有覆盖槽。 */
+  .xh-scope-text-field[data-part='clear-trigger'] {
+    --xh-action-visual-size: var(--xh-text-field-action-size, var(--xh-_action-profile-visual-size));
+    --xh-action-min-inline-size: var(--xh-text-field-action-size, var(--xh-_action-profile-visual-size));
+    --xh-action-radius: var(--xh-text-field-action-radius, var(--xh-shape-inset));
+    /* 底色阶梯由 ghost 档给（透明 → 100 → 200），使用者槽只作覆盖入口 */
+    --xh-action-bg-rest: var(--xh-text-field-action-bg, var(--xh-_action-variant-bg-rest));
+    --xh-action-bg-hover: var(--xh-text-field-action-bg-hover, var(--xh-_action-variant-bg-hover));
+    --xh-action-bg-pressed: var(--xh-text-field-action-bg-active, var(--xh-_action-variant-bg-pressed));
+    --xh-action-fg-rest: var(--xh-text-field-action-fg, var(--xh-fg-muted));
+    --xh-action-fg-hover: var(--xh-text-field-action-fg-hover, var(--xh-fg-default));
+    --xh-action-border-rest: transparent;
+    --xh-action-highlight-rest: transparent;
+    --xh-action-shadow-rest: none;
+    --xh-action-shadow-hover: none;
+    --xh-action-shadow-pressed: none;
+    --xh-action-font-size: var(--xh-text-field-action-font-size, var(--xh-_text-field-action-font-size));
+    /* 配方尚未把 profile 字形档灌进 --xh-icon-size，钮内字形先按 field-inset 档逐钮取值 */
+    --xh-icon-size: var(--xh-_action-profile-glyph-size);
+
+    border-width: 0;
+  }
+
+  .xh-scope-text-field[data-part='clear-trigger'][hidden] {
+    display: none;
+  }
+
+  .xh-scope-text-field[data-part='clear-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;
+  }
+
+  .xh-scope-text-field[data-part='count'] {
+    align-self: flex-end;
+    color: var(--xh-text-field-count-fg, var(--xh-fg-muted));
+    font-size: var(--xh-text-field-count-font-size, var(--xh-_text-field-action-font-size));
+    font-variant-numeric: tabular-nums;
+    line-height: var(--xh-leading-normal);
+  }
+
+  .xh-scope-text-field[data-part='count'][hidden] {
+    display: none;
+  }
+
+  .xh-scope-text-field[data-part='count'][data-at-max] {
+    color: var(--xh-text-field-count-fg-at-max, var(--xh-fg-warning));
+  }
+
+  .xh-scope-text-field[data-part='count'][data-disabled] {
+    color: var(--xh-text-field-count-fg-disabled, var(--xh-fg-disabled));
+  }
+
+  @media (forced-colors: active) {
+    /* 兜底字形是 mask 挖出来的一块底色，这一档里底色被系统换成 Canvas，字形跟着消失。
+       字形退出强制换色、直接写系统色（不能取 currentColor：退出强制换色的伪元素读到的是被系统换掉之前的作者色）：
+       按钮面上取 ButtonText，悬停与按下时家族把按钮涂成 Highlight、字形换 HighlightText；
+       禁用取 GrayText */
+    .xh-scope-text-field[data-part='clear-trigger']:empty::before {
+      forced-color-adjust: none;
+      background-color: ButtonText;
+    }
+
+    .xh-scope-text-field[data-part='clear-trigger']:not([data-disabled]):not([data-loading]):is(:hover, :active, [data-pressed]):empty::before {
+      background-color: HighlightText;
+    }
+
+    .xh-scope-text-field[data-part='clear-trigger'][data-disabled]:empty::before {
+      background-color: GrayText;
+    }
+  }
+}