@icen.ai/ui 0.8.0 → 0.9.0

package/dist/components/kb-segment.mjs

@@ -0,0 +1,4 @@
+// @icen.ai/ui — kit: kb-segment（CSS + behavior 一行入口；构建产物，勿手改）
+import './kb-ingest.css';
+import './kb.css';
+export * from '../behaviors/kb-segment.mjs';

package/dist/components/kb-sources.mjs

@@ -0,0 +1,4 @@
+// @icen.ai/ui — kit: kb-sources（CSS + behavior 一行入口；构建产物，勿手改）
+import './kb-ground.css';
+import './kb.css';
+export * from '../behaviors/kb-sources.mjs';

package/dist/components/kb-sql.mjs

@@ -0,0 +1,4 @@
+// @icen.ai/ui — kit: kb-sql（CSS + behavior 一行入口；构建产物，勿手改）
+import './kb-data.css';
+import './kb.css';
+export * from '../behaviors/kb-sql.mjs';

package/dist/components/kb-trace.mjs

@@ -0,0 +1,4 @@
+// @icen.ai/ui — kit: kb-trace（CSS + behavior 一行入口；构建产物，勿手改）
+import './kb-ops.css';
+import './kb.css';
+export * from '../behaviors/kb-trace.mjs';

package/dist/components/kb-visibility.mjs

@@ -0,0 +1,4 @@
+// @icen.ai/ui — kit: kb-visibility（CSS + behavior 一行入口；构建产物，勿手改）
+import './kb-perm.css';
+import './kb.css';
+export * from '../behaviors/kb-visibility.mjs';

package/dist/components/kb-who-can.mjs

@@ -0,0 +1,4 @@
+// @icen.ai/ui — kit: kb-who-can（CSS + behavior 一行入口；构建产物，勿手改）
+import './kb-perm.css';
+import './kb.css';
+export * from '../behaviors/kb-who-can.mjs';

package/dist/components/kb.css

@@ -0,0 +1,252 @@
+/*
+ * @icen.ai/ui — kb 族共享视觉基座（与 docs/spec/kb-family.md §2 配套）
+ *
+ * 每个 kb-* 组件的 kit 入口经 EXTRA_CSS 引入本文件；六个域文件（kb-ground/kb-ingest/
+ * kb-search/kb-data/kb-ops/kb-agent.css）不再重复定义这里的原语。
+ *
+ * 设计纪律（族内一致性硬约束）：
+ *   - 数字一律 .kb-num（等宽 + tabular-nums）；元信息 .kb-meta（11.5px faint）
+ *   - 证据引用体 .kb-quote（左侧 2px 证据线，颜色只用层级色不用装饰色）
+ *   - 行基元 .kb-row（28px 节奏，data-density="compact" 收 24px）
+ *   - 分数条 .kb-score（序数呈现：条长=排序信号，不标榜比例语义）
+ *   - 状态点 .kb-dot（语义色，只此一处给状态上色）
+ *   - 徽标 .kb-badge（official 线框 accent / fresh·stale 中性+警示 / restricted 锁形）
+ *   - 折叠摘要行 .kb-fold-head（状态徽章 + 计数/时长，muted 内容体 .kb-fold-body）
+ *   - 动效 ≤240ms ease-out；流式脉冲 1.6s；reduced-motion 走全局规则
+ */
+
+.kb-row {
+  display: grid;
+  grid-template-columns: auto 1fr auto;
+  align-items: center;
+  gap: 10px;
+  min-height: 28px;
+  padding: 2px 8px;
+  border-radius: var(--radius-sm, 6px);
+}
+.kb-row:hover { background: var(--token-bg-soft); }
+.kb-row-main { min-width: 0; display: flex; flex-direction: column; gap: 1px; }
+.kb-row-title {
+  font-size: 13px;
+  color: var(--token-text);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.kb-row-sub { font-size: 11.5px; color: var(--token-text-faint); white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+.kb-row-side { display: inline-flex; align-items: center; gap: 8px; }
+
+/* 密度：compact 档（管理台/密集列表） */
+[data-density='compact'] .kb-row { min-height: 24px; gap: 8px; }
+
+/* 数字与元信息 */
+.kb-num {
+  font-family: var(--font-mono, ui-monospace, SFMono-Regular, Menlo, Consolas, monospace);
+  font-variant-numeric: tabular-nums;
+  font-size: 12px;
+  color: var(--token-text-muted);
+  white-space: nowrap;
+}
+.kb-meta {
+  font-family: var(--font-mono, ui-monospace, SFMono-Regular, Menlo, Consolas, monospace);
+  font-size: 11px;
+  letter-spacing: 0.3px;
+  color: var(--token-text-faint);
+  white-space: nowrap;
+}
+
+/* 状态点（族内状态色的唯一入口） */
+.kb-dot {
+  width: 7px;
+  height: 7px;
+  border-radius: 50%;
+  flex: 0 0 auto;
+  background: var(--token-text-faint);
+  opacity: 0.6;
+}
+.kb-dot.is-ok { background: var(--token-success); opacity: 1; }
+.kb-dot.is-warn { background: var(--token-warning); opacity: 1; }
+.kb-dot.is-err { background: var(--token-danger, var(--token-error)); opacity: 1; }
+.kb-dot.is-live { background: var(--token-accent); opacity: 1; animation: kb-pulse 1.6s ease-in-out infinite; }
+
+@keyframes kb-pulse {
+  0%, 100% { box-shadow: 0 0 0 0 color-mix(in srgb, var(--token-accent) 35%, transparent); }
+  50% { box-shadow: 0 0 0 4px color-mix(in srgb, var(--token-accent) 0%, transparent); }
+}
+
+/* 分数条（序数纪律：null 分数不渲染条） */
+.kb-score { display: inline-flex; align-items: center; gap: 6px; min-width: 88px; }
+.kb-score-bar {
+  flex: 1 1 auto;
+  height: 3px;
+  border-radius: 2px;
+  background: var(--token-line-soft);
+  overflow: hidden;
+  min-width: 40px;
+}
+.kb-score-bar > i { display: block; height: 100%; border-radius: 2px; background: var(--token-accent); opacity: 0.75; }
+.kb-score-value { font-family: var(--font-mono, ui-monospace, monospace); font-variant-numeric: tabular-nums; font-size: 11.5px; color: var(--token-text-muted); min-width: 34px; text-align: right; }
+
+/* 证据引用体（原文摘录、citedText、chunk 预览） */
+.kb-quote {
+  position: relative;
+  padding: 2px 0 2px 12px;
+  font-size: 12.5px;
+  line-height: 1.7;
+  color: var(--token-text-muted);
+}
+.kb-quote::before {
+  content: '';
+  position: absolute;
+  left: 0;
+  top: 4px;
+  bottom: 4px;
+  width: 2px;
+  border-radius: 1px;
+  background: var(--token-line);
+}
+.kb-quote mark,
+.kb-passage-body mark,
+.kb-hit mark {
+  background: color-mix(in srgb, var(--token-accent) 18%, transparent);
+  color: inherit;
+  border-radius: 2px;
+  padding: 0 2px;
+}
+/* 多命中分色（data-hit 轮转 3 色） */
+.kb-quote mark[data-hit='1'],
+.kb-passage-body mark[data-hit='1'] { background: color-mix(in srgb, var(--token-warning) 22%, transparent); }
+.kb-quote mark[data-hit='2'],
+.kb-passage-body mark[data-hit='2'] { background: color-mix(in srgb, var(--token-info, var(--token-accent)) 20%, transparent); }
+
+/* 徽标（来源元数据：官方/新鲜度/权限） */
+.kb-badge {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  font-size: 10.5px;
+  line-height: 1;
+  letter-spacing: 0.3px;
+  color: var(--token-text-faint);
+  border: 1px solid var(--token-line-soft);
+  border-radius: 999px;
+  padding: 2.5px 7px;
+  white-space: nowrap;
+}
+.kb-badge svg { width: 10px; height: 10px; }
+.kb-badge--official {
+  color: var(--token-accent);
+  border-color: color-mix(in srgb, var(--token-accent) 45%, transparent);
+  background: var(--token-accent-subtle, transparent);
+}
+.kb-badge--stale { color: var(--token-warning); border-color: color-mix(in srgb, var(--token-warning) 40%, transparent); }
+.kb-badge--restricted { color: var(--token-text-faint); }
+.kb-badge--trusted {
+  color: var(--token-success);
+  border-color: color-mix(in srgb, var(--token-success) 45%, transparent);
+  background: color-mix(in srgb, var(--token-success) 8%, transparent);
+}
+.kb-badge--admin { font-family: var(--font-mono, monospace); }
+
+/* 中性 chip（表名/关键词/过滤值；展示性标签用 tag.css 的 .tag，这里只做 kb 域自持变体） */
+.kb-chip {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  font-family: var(--font-mono, ui-monospace, monospace);
+  font-size: 11px;
+  color: var(--token-text-muted);
+  background: var(--token-bg-soft);
+  border: 1px solid var(--token-line-soft);
+  border-radius: var(--radius-sm, 6px);
+  padding: 2px 7px;
+  max-width: 220px;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+/* 折叠两段式（摘要行 + muted 内容体；与 ai 族渐进披露同构） */
+.kb-fold-head {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  width: 100%;
+  min-height: 28px;
+  padding: 2px 8px;
+  border: none;
+  background: none;
+  border-radius: var(--radius-sm, 6px);
+  font: inherit;
+  font-size: 12.5px;
+  color: var(--token-text-muted);
+  cursor: pointer;
+  text-align: left;
+}
+.kb-fold-head:hover { color: var(--token-text); background: var(--token-bg-soft); }
+.kb-fold-head:focus-visible { outline: 2px solid var(--token-accent); outline-offset: -2px; }
+.kb-fold-caret {
+  display: inline-block;
+  width: 1em;
+  color: var(--token-text-faint);
+  font-size: 10px;
+  transition: transform 0.16s ease-out;
+  flex: 0 0 auto;
+}
+.kb-fold-head[aria-expanded='true'] .kb-fold-caret { transform: rotate(90deg); }
+.kb-fold-count { margin-left: auto; }
+
+/* 键位提示（标注队列快捷键等） */
+.kb-key {
+  font-family: var(--font-mono, ui-monospace, monospace);
+  font-size: 10px;
+  color: var(--token-text-faint);
+  border: 1px solid var(--token-line-soft);
+  border-bottom-width: 2px;
+  border-radius: 4px;
+  padding: 1px 5px;
+  background: var(--token-bg-soft);
+}
+
+/* 空态/无死路行动（组件空态的最小底座；复杂空态用 empty.css） */
+.kb-empty {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 8px;
+  padding: 28px 16px;
+  color: var(--token-text-faint);
+  font-size: 12.5px;
+  text-align: center;
+}
+
+/* 截断/边界声明（诚实呈现） */
+.kb-notice {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  font-size: 11.5px;
+  color: var(--token-text-faint);
+  padding: 4px 8px;
+}
+.kb-notice svg { width: 12px; height: 12px; flex: 0 0 auto; }
+/* flex 容器内 hidden 会被 display 覆盖——notice 显隐必须显式归零 */
+.kb-notice[hidden] { display: none; }
+
+/* 检索过滤层徽标（权限域注入检索域的共享原语，放基座使 kit/kb-retrieval 与 kit/kb-* 均自持；
+   三态：pre ✓ 安全基线 / post ⚠ 缺陷层 / none ✕ fail-open 危险——spec §9.0-1/§9.7） */
+.kb-layer-chip {
+  font-family: var(--font-mono, ui-monospace, monospace);
+  font-size: 11px;
+  cursor: pointer;
+}
+.kb-layer-chip[data-layer='pre'] { color: var(--token-success); border-color: color-mix(in srgb, var(--token-success) 45%, transparent); }
+.kb-layer-chip[data-layer='post'] { color: var(--token-warning); border-color: color-mix(in srgb, var(--token-warning) 45%, transparent); }
+.kb-layer-chip[data-layer='none'] { color: var(--token-error, #c0392b); border-color: color-mix(in srgb, var(--token-error, #c0392b) 45%, transparent); }
+.kb-layer-chip:focus-visible { outline: 2px solid var(--token-accent); outline-offset: 1px; }
+
+
+/* 动效守卫：kb-pulse（.kb-dot.is-live 的存活脉冲）在减少动效偏好下停帧（保持静态高亮，不隐状态） */
+@media (prefers-reduced-motion: reduce) {
+  .kb-dot.is-live { animation: none; }
+}

package/dist/components/kb.mjs

@@ -0,0 +1,9 @@
+// @icen.ai/ui — kit: kb（CSS + behavior 一行入口；构建产物，勿手改）
+import './kb.css';
+import './kb-ground.css';
+import './kb-ingest.css';
+import './kb-search.css';
+import './kb-data.css';
+import './kb-ops.css';
+import './kb-agent.css';
+import './kb-perm.css';

package/dist/components/notification.css

@@ -9,7 +9,7 @@
  *
  * 完整契约（由 behavior 渲染）：
  *   <div class="notification-container" role="region" aria-label="通知" data-position="top-right">
- *     <div class="notification [notification--success|warning|error|info]
+ *     <div class="notification [notification--success|warning|error]
  *          [.is-priority] [.is-unread] [.is-progress] [.is-clickable] [.is-paused]
  *          [.has-avatar]" role="alert|button">
  *       <span class="notification-icon">…svg 或 img.notification-avatar…</span>
@@ -81,7 +81,7 @@
 .notification.notification--success { border-left-color: var(--token-success); }
 .notification.notification--warning { border-left-color: var(--token-warning); }
 .notification.notification--error   { border-left-color: var(--token-error); }
-.notification.notification--info    { border-left-color: var(--token-info); }
+/* info 为基类默认配色（基类左侧边即 --token-info），无修饰类 */
 
 /* ── 优先级：高优先级强调（左侧加粗 + 更强阴影）── */
 .notification.is-priority {
@@ -138,7 +138,6 @@
 .notification--success .notification-icon { color: var(--token-success); }
 .notification--warning .notification-icon { color: var(--token-warning); }
 .notification--error   .notification-icon { color: var(--token-error); }
-.notification--info    .notification-icon { color: var(--token-info); }
 
 /* 头像（圆形图） */
 .notification-avatar {

package/dist/components/pagination.css

@@ -10,7 +10,9 @@
  *     <button class="page-btn motion" aria-label="下一页">›</button>
  *   </nav>
  *
- * 翻页逻辑由消费方实现，这里只提供静态样式契约。
+ * 点击接线由 behaviors/controls.ts 的 initPagination() 提供（.page-btn 激活位移 +
+ * icen:page-change，上下页按钮按 aria-label / data-dir 推断方向）；总页数与省略号
+ * 折叠策略由消费方维护，这里只提供样式契约。
  */
 
 .pagination {

package/dist/components/pagination.mjs

@@ -1,2 +1,3 @@
 // @icen.ai/ui — kit: pagination（CSS + behavior 一行入口；构建产物，勿手改）
 import './pagination.css';
+export { initPagination } from '../behaviors/controls.mjs';

package/dist/components/rating.mjs

@@ -1,2 +1,3 @@
 // @icen.ai/ui — kit: rating（CSS + behavior 一行入口；构建产物，勿手改）
 import './media.css';
+export { initRating } from '../behaviors/controls.mjs';

package/dist/components/segmented.css

@@ -28,7 +28,15 @@
  *        …
  *      </div>
  *
- * segmented/toggle 是纯 CSS 状态组件（.is-active）；stepper/otp 由 behaviors/input.ts 接线。
+ * segmented / stepper 由 behaviors/controls.ts 接线（initSegmented / initStepper，
+ * 派 icen:segmented-change / icen:stepper-change）；otp 由 behaviors/input.ts 的
+ * initInput 接线；toggle-group 为纯 CSS 状态组件（.is-active，使用方自行驱动）。
+ *
+ * 增强段（正文"增强"段）：
+ *   变体：segmented--block / segmented--ghost / toggle-group--block / toggle-group--ghost
+ *   槽位：stepper-unit（步进器单位后缀）/ otp-separator（OTP 分组分隔符）
+ *   状态类（消费方施加）：.otp.is-complete（behavior 接线中）/ .otp.is-error /
+ *         .segmented.is-error / .segmented.is-disabled / .toggle-group.is-error / .toggle-group.is-disabled
  */
 
 /* ── 分段控件（排他单选） ── */

package/dist/components/segmented.mjs

@@ -1,3 +1,3 @@
 // @icen.ai/ui — kit: segmented（CSS + behavior 一行入口；构建产物，勿手改）
 import './segmented.css';
-export { initInput } from '../behaviors/input.mjs';
+export { initInput, initSegmented, initStepper } from '../behaviors/controls.mjs';

package/dist/components/select.css

@@ -4,14 +4,24 @@
  *
  * 完整契约：
  *   <div class="select [data-disabled] [.is-open]" data-select
- *        [data-select-search] [data-select-multiple] [data-select-max="3"]>
+ *        [data-select-search] [data-select-multiple] [data-select-max="3"]
+ *        [data-panel-width="220"] [data-panel-min="200"]
+ *        [data-panel-max="360"] [data-panel-max-height="320"]>
+ *     <!-- 选项 .select-option 内支持任意 HTML（色卡 / 图标 / 多行）；
+ *          面板尺寸为全库统一 PanelSizing 契约（behaviors/popover.ts） -->
  *     <button class="select-trigger pressable focus-ring [--sm|--lg]" aria-haspopup="listbox"
  *             aria-expanded="false" [disabled]>
  *       <span class="select-leading">…</span>           可选前缀
- *       <span class="select-value is-empty">占位</span>
- *       <button class="select-clear" aria-label="清除">×</button>  ← 多选时可选
+ *       <span class="select-value is-empty">占位</span>   多选有选中时 behavior 隐藏它
+ *       <span class="select-chips">                     ← 多选选中态由 behavior 渲染（勿手写）
+ *         <span class="select-chip">标签<span class="select-chip-x" role="button" tabindex="-1">×</span></span>
+ *         <span class="select-chip select-chip--more">+2</span>
+ *       </span>
  *       <svg class="select-chevron">…</svg>
  *     </button>
+ *     <button class="select-clear" aria-label="清除全部" hidden>×</button>  ← 多选可选：
+ *         与 trigger 同级（不能嵌套在 button 内），绝对定位叠进 trigger 右侧；
+ *         behavior 在有选中时自动显示
  *     <div class="select-panel" hidden role="listbox">
  *       <div class="select-search">                      ← data-select-search 时 behavior 自动注入
  *         <input class="select-search-input" placeholder="搜索…" />
@@ -209,8 +219,13 @@
   box-shadow: var(--icen-control-focus-shadow);
 }
 
-/* ── 多选清除按钮 ── */
+/* ── 多选清除按钮（与 trigger 同级，绝对定位叠进 trigger 右侧、chevron 左侧） ── */
 .select-clear {
+  position: absolute;
+  top: 50%;
+  right: calc(var(--density-space-sm) + 20px);
+  transform: translateY(-50%);
+  z-index: 1;
   display: inline-flex;
   align-items: center;
   justify-content: center;
@@ -231,6 +246,53 @@
   color: var(--token-text);
   background: var(--token-fill-1);
 }
+/* 有清除钮时 trigger 右侧让位（clear 18px + chevron 14px + 间距） */
+.select:has(.select-clear) .select-trigger { padding-right: 52px; }
+
+/* ── 多选 chips（tag 式展示；× 仅 hover 对应 chip 时出现） ── */
+.select-chips {
+  display: inline-flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 4px;
+  flex: 1;
+  min-width: 0;
+}
+.select-chip {
+  display: inline-flex;
+  align-items: center;
+  max-width: 100%;
+  font-size: var(--density-font-size-xs);
+  line-height: 1.6;
+  color: var(--token-text);
+  background: var(--token-fill-2);
+  border-radius: var(--radius-sm);
+  padding: 0 7px;
+  white-space: nowrap;
+}
+.select-chip-x {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 0;
+  opacity: 0;
+  overflow: hidden;
+  margin-left: 0;
+  color: var(--token-text-faint);
+  border-radius: var(--radius-full);
+  font-size: var(--density-font-size-md);
+  line-height: 1;
+  cursor: pointer;
+  transition:
+    width var(--icen-tx-fast),
+    opacity var(--icen-tx-fast),
+    margin-left var(--icen-tx-fast),
+    color var(--icen-tx-fast);
+}
+.select-chip:hover .select-chip-x,
+.select-chip-x:focus-visible { width: 12px; opacity: 1; margin-left: 4px; }
+.select-chip-x:hover { color: var(--token-error); }
+.select-chip--more { color: var(--token-text-muted); background: var(--token-fill-1); }
 
 /* ── 多选 trigger 高度自适应（chips 可能换行） ── */
 .select[data-select-multiple] .select-trigger {
@@ -263,5 +325,6 @@
 @media (prefers-reduced-motion: reduce) {
   .select-panel { animation: none; }
   .select-search-input,
+  .select-chip-x,
   .select-clear { transition: none; }
 }

package/dist/components/steps.css

@@ -2,7 +2,8 @@
  * @icen.ai/ui — Component: steps（步骤条，横向默认 / .steps--vertical 垂直）
  *
  * 完整契约：
- *   <ol class="steps [steps--vertical] [steps--sm|steps--lg]" aria-label="进度">
+ *   <ol class="steps [steps--vertical] [steps--sm|steps--lg] [steps--dots|steps--progress|steps--connected]"
+ *        aria-label="进度">
  *     <li class="step [step--finish|step--process|step--wait] [.step--error]">
  *       <span class="step-line"></span>                   ← 横向：右半段连线；末步自动隐藏
  *       <span class="step-dot">[✓ | ! | 数字]</span>
@@ -14,7 +15,11 @@
  *   </ol>
  *
  * 四态：finish / process / wait / error（错误用 error 色 dot + 描边）。
- * 点击 .step[role=button] 由使用方实现跳转。
+ * 变体与增强（正文下半段）：--dots 纯点紧凑 / --progress 步骤间填充进度线 / --connected 虚线连接；
+ *   dot 内可放 svg.step-dot-icon；step-desc 旁可加 .step-extra 富化描述；
+ *   可点击步骤标 .step--clickable（与 controls.ts initSteps 的 JSDoc 同口径）。
+ * 点击 .step[role=button] 由 behaviors/controls.ts 的 initSteps() 接线（激活态位移 +
+ * icen:step-change）；跳转业务仍由使用方监听事件实现。
  */
 
 .steps {
@@ -141,7 +146,9 @@
   padding: 0;
   font-size: 0;
 }
-.steps--dots .step-line { top: 20px; }
+/* 线 top = dot 高度一半：默认 32→16 / sm 24→12 / lg 40→20 / dots 10→5；
+   本块位于尺寸变体之后，同等特异性下靠源顺序生效，dots 与 --sm/--lg 叠加时以 5px 为准 */
+.steps--dots .step-line { top: 5px; }
 .steps--dots .step-title,
 .steps--dots .step-desc { display: none; }
 .steps--dots .step { flex: none; }
@@ -171,8 +178,11 @@
 }
 
 /* ── 进度条变体（步骤间的填充进度，非离散连线） ── */
+/* 高度 1px→3px 时线只向下扩张 2px，整体上移 1px 使线心与 1px 基线居中一致；
+   用 translateY 而非改 top，可同时适配 --sm(12px)/--lg(20px) 的不同基线 */
 .steps--progress .step-line {
   height: 3px;
+  transform: translateY(-1px);
   border-radius: var(--radius-full);
   background: var(--token-fill-2);
   overflow: hidden;

package/dist/components/steps.mjs

@@ -1,2 +1,3 @@
 // @icen.ai/ui — kit: steps（CSS + behavior 一行入口；构建产物，勿手改）
 import './steps.css';
+export { initSteps } from '../behaviors/controls.mjs';

package/dist/components/switch.css

@@ -1,6 +1,8 @@
 /*
  * @icen.ai/ui — Component: switch / checkbox / radio（开关 / 勾选 / 单选行）
- * 纯 CSS 状态组件：状态全走 aria-checked / .is-selected；交互由使用方或演示页脚本切换。
+ * 状态组件：状态全走 aria-checked / .is-selected；交互由 behaviors/controls.ts 的
+ * initSwitch() 接线（点击 / Space / Enter 翻转并派 icen:switch-change / icen:check-change），
+ * 不接线时亦可由使用方自行驱动状态。
  *
  * 完整契约：
  *   <button class="switch [--sm|--lg]" role="switch" aria-checked="true|false" [disabled]>

package/dist/components/switch.mjs

@@ -1,2 +1,3 @@
 // @icen.ai/ui — kit: switch（CSS + behavior 一行入口；构建产物，勿手改）
 import './switch.css';
+export { initSwitch } from '../behaviors/controls.mjs';

package/dist/components/table.mjs

@@ -1,2 +1,3 @@
 // @icen.ai/ui — kit: table（CSS + behavior 一行入口；构建产物，勿手改）
 import './table.css';
+export { initTableSort } from '../behaviors/controls.mjs';

package/dist/components/tabs.css

@@ -221,3 +221,26 @@
 @media (prefers-reduced-motion: reduce) {
   .page-tab, .tabs a, .page-tab-close { transition: none; }
 }
+
+/* ── 指示条（[data-tabs-ink]，与 behaviors/tabs 配套；本节为追加）── */
+/* tablist（.tabs）挂 data-tabs-ink 时，行为层创建并移动 .tabs-ink：
+   宽 / translateX 由 JS 内联写入（布局定位，同 popover 模式）；
+   此处只负责视觉（高度 / 圆角 / 背景）与位移过渡（--duration / --ease token）。 */
+.tabs[data-tabs-ink] {
+  position: relative;
+}
+.tabs-ink {
+  position: absolute;
+  bottom: -1px; /* 盖在容器 1px 底边线上，与活动 tab 的 2px 下划线同高 */
+  left: 0;
+  height: 2px;
+  border-radius: var(--radius-full);
+  background: var(--token-accent);
+  pointer-events: none;
+  transition:
+    width var(--duration-normal) var(--ease-out),
+    transform var(--duration-normal) var(--ease-out);
+}
+@media (prefers-reduced-motion: reduce) {
+  .tabs-ink { transition: none; }
+}

package/dist/components/tag-input.css

@@ -70,12 +70,7 @@
   max-width: 100%;
   animation: tag-pop var(--icen-tx-fast);
 }
-.tag-chip-label {
-  white-space: nowrap;
-  overflow: hidden;
-  text-overflow: ellipsis;
-  max-width: 200px;
-}
+/* readonly 变体（消费方手写标记，behavior 不产出） */
 .tag-chip--readonly { background: var(--token-fill-2); color: var(--token-text-muted); }
 
 @keyframes tag-pop {

package/dist/components/upload.css

@@ -195,21 +195,6 @@
   box-shadow: var(--icen-ring);
 }
 
-/* 进度条（behavior 可选注入 .upload-list-item-progress） */
-.upload-list-item-progress {
-  height: 2px;
-  width: 100%;
-  background: var(--token-fill-2);
-  border-radius: var(--radius-full);
-  overflow: hidden;
-  margin-top: 2px;
-}
-.upload-list-item-progress-bar {
-  height: 100%;
-  background: var(--token-accent);
-  border-radius: var(--radius-full);
-  transition: width var(--icen-tx-normal) var(--ease-out);
-}
 .upload-list-item.is-error {
   border-color: var(--token-error);
 }