@icen.ai/ui 0.8.1 → 0.10.0

package/dist/components/kb-metadata.mjs

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

package/dist/components/kb-ops.css

@@ -0,0 +1,554 @@
+@layer icen.components {
+/*
+ * @icen.ai/ui — kb-ops.css（治理域：kb-trace / kb-review / kb-gap / kb-eval）
+ * 共享原语在 kb.css（.icen-kb-row/.icen-kb-num/.icen-kb-score/.icen-kb-dot/.icen-kb-chip/.icen-kb-key/.icen-kb-empty…），
+ * 本文件只做本域专属结构。DOM 契约见 docs/spec/kb-family.md §5.19–5.22 与各 behavior 头注释。
+ *
+ * 治理域纪律（spec §2）：整体 muted，告警才 warning/error；数字一律 .icen-kb-num；
+ * 动效 ≤240ms ease-out、流式脉冲 1.6s；只用 --icen-token-* 与 kb.css 原语。
+ */
+
+/* ═══════════════ kb-trace：span 树 ═══════════════ */
+
+.icen-kb-trace { display: flex; flex-direction: column; gap: 1px; min-width: 0; }
+
+/* 行：caret | kind 徽标（定宽对齐）| name | 耗时条 | elapsed；--depth×16px 缩进 */
+.icen-kb-span {
+  display: grid;
+  grid-template-columns: 14px 64px minmax(0, 1fr) minmax(48px, 128px) 56px;
+  align-items: center;
+  gap: 8px;
+  min-height: 26px;
+  padding-block: 2px;
+  /* 深度缩进沿 inline-start（RTL 下树向左侧生长） */
+  padding-inline: calc(8px + var(--depth, 0) * 16px) 8px;
+  border: none;
+  background: none;
+  border-radius: var(--icen-radius-sm);
+  font: inherit;
+  font-size: 12.5px;
+  color: var(--icen-token-text-muted);
+  cursor: pointer;
+  text-align: start;
+  inline-size: 100%;
+  position: relative;
+}
+.icen-kb-span:hover { background: var(--icen-token-bg-soft); color: var(--icen-token-text); }
+.icen-kb-span:focus-visible { outline: 2px solid var(--icen-token-accent); outline-offset: -2px; }
+
+/* 子 span 行前 1px 竖线（缩进连线，沿 inline-start，RTL 镜像） */
+.icen-kb-span--child::before {
+  content: '';
+  position: absolute;
+  inset-inline-start: calc(var(--depth, 1) * 16px - 4px);
+  top: 0;
+  bottom: 0;
+  width: 1px;
+  background: var(--icen-token-line-soft);
+}
+
+/* caret（有子才显；hidden 占位保持列对齐）：共享 chevron-right mask 指向行进方向，展开旋转 90°；RTL 经 scaleX(-1) 镜像 */
+.icen-kb-span-caret {
+  inline-size: 12px;
+  block-size: 12px;
+  background: var(--icen-token-text-faint);
+  mask: var(--icen-token-icon-chevron-right) center / contain no-repeat;
+  transition: transform 0.16s ease-out;
+}
+.icen-kb-span[aria-expanded='true'] .icen-kb-span-caret { transform: rotate(90deg); }
+
+/* kind 徽标：中性线框；retrieval 为 accent 线框（证据域主角） */
+.icen-kb-span-kind {
+  font-size: 10.5px;
+  line-height: 1;
+  letter-spacing: 0.3px;
+  color: var(--icen-token-text-faint);
+  border: 1px solid var(--icen-token-line-soft);
+  border-radius: var(--icen-radius-full);
+  padding: 2.5px 7px;
+  white-space: nowrap;
+  justify-self: start;
+}
+.icen-kb-span.is-retrieval .icen-kb-span-kind {
+  color: var(--icen-token-accent);
+  border-color: color-mix(in srgb, var(--icen-token-accent) 45%, transparent);
+}
+
+.icen-kb-span-name {
+  min-inline-size: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  color: var(--icen-token-text);
+  font-size: 12.5px;
+}
+.icen-kb-span.is-cancel { opacity: 0.6; }
+
+/* 耗时条：宽度 = elapsedMs / 同级最大（行内 style）；error 红 / running 脉冲 */
+.icen-kb-span-bar {
+  justify-self: start;
+  width: 0%;
+  height: 4px;
+  border-radius: 2px; /* guard:allow-radius 微构件（bar/dot/track/指示器等图形级，不属容器圆角面） */
+  background: var(--icen-token-line);
+  transition: width 0.16s ease-out;
+}
+.icen-kb-span.is-error .icen-kb-span-bar { background: var(--icen-token-error); }
+.icen-kb-span.is-running .icen-kb-span-bar {
+  background: var(--icen-token-accent);
+  animation: kb-ops-pulse 1.6s ease-in-out infinite;
+}
+.icen-kb-span > .icen-kb-num { justify-self: end; }
+
+@keyframes kb-ops-pulse {
+  0%, 100% { opacity: 1; }
+  50% { opacity: 0.35; }
+}
+
+/* 展开体（.kb-fold-body 语义同构）：缩进 depth+1、起始缘 2px 证据线由 border 承担（RTL 镜像） */
+.icen-kb-trace-body {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  margin-block: 0 2px;
+  margin-inline-start: calc(16px + (var(--depth, 0) + 1) * 16px);
+  margin-inline-end: 8px;
+  padding: 6px 10px;
+  border-inline-start: 2px solid var(--icen-token-line-soft);
+  font-size: 12px;
+  color: var(--icen-token-text-muted);
+}
+.icen-kb-trace-detail { white-space: pre-wrap; word-break: break-word; line-height: 1.6; }
+.icen-kb-trace-usage { display: flex; flex-wrap: wrap; gap: 4px 12px; }
+.icen-kb-trace-error { color: var(--icen-token-error); font-size: 12px; word-break: break-word; }
+
+/* retrieval span 内嵌迷你命中列表（rank + title + .icen-kb-score 序数条） */
+.icen-kb-trace-hits { display: flex; flex-direction: column; gap: 2px; }
+.icen-kb-trace-hit {
+  display: grid;
+  grid-template-columns: 18px minmax(0, 1fr) minmax(88px, 140px);
+  align-items: center;
+  gap: 8px;
+  min-height: 22px;
+}
+.icen-kb-trace-hit-rank { text-align: right; /* guard:allow-physical rank 是数字（LTR 文种），物理右对齐惯例，RTL 不镜像 */ color: var(--icen-token-text-faint); }
+.icen-kb-trace-hit-title {
+  font-size: 12px;
+  color: var(--icen-token-text-muted);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+/* 分数条固定轨道（分数条纪律，与 kb-search.css 同规）：bar 定宽 64px、不参与 flex 伸缩，
+   i 定量不缩——跨行条长与百分比严格成比例，禁止轨道随容器/数值文本伸缩 */
+.icen-kb-trace-hit .icen-kb-score-bar {
+  display: block;
+  flex: 0 0 64px;
+  width: 64px;
+  min-width: 0;
+}
+.icen-kb-trace-hit .icen-kb-score-bar > i { display: block; flex: 0 0 auto; }
+
+/* ═══════════════ kb-review：标注队列 ═══════════════ */
+
+.icen-kb-review {
+  display: grid;
+  grid-template-columns: 300px minmax(0, 1fr);
+  gap: 16px;
+  align-items: start;
+}
+
+/* 队列列表（起始缘列，RTL 镜像） */
+.icen-kb-review-queue { display: flex; flex-direction: column; gap: 8px; min-width: 0; }
+.icen-kb-review-filter { display: flex; align-items: center; gap: 8px; font-size: 11.5px; color: var(--icen-token-text-faint); }
+/* 弹层选择器（icen-select）域钩子：面样式随 select.css，此处只管布局 */
+.icen-kb-review-filter-select { flex: 0 1 160px; }
+.icen-kb-review-assign { flex: 0 1 180px; }
+.icen-kb-review-list { display: flex; flex-direction: column; gap: 2px; max-height: 420px; overflow-y: auto; }
+
+.icen-kb-review-item {
+  display: grid;
+  grid-template-columns: auto minmax(0, 1fr) auto auto;
+  align-items: center;
+  gap: 8px;
+  min-height: 28px;
+  padding: 3px 8px;
+  border: none;
+  background: none;
+  border-radius: var(--icen-radius-sm);
+  font: inherit;
+  font-size: 12.5px;
+  color: var(--icen-token-text-muted);
+  cursor: pointer;
+  text-align: start;
+}
+.icen-kb-review-item:hover { background: var(--icen-token-bg-soft); color: var(--icen-token-text); }
+.icen-kb-review-item:focus-visible { outline: 2px solid var(--icen-token-accent); outline-offset: -2px; }
+.icen-kb-review-item.is-active {
+  background: var(--icen-token-bg-soft);
+  color: var(--icen-token-text);
+  box-shadow: inset 2px 0 0 var(--icen-token-accent); /* guard:allow-physical box-shadow 无逻辑属性（inset 起始缘描边），RTL 镜像规则换 -2px */
+}
+.icen-kb-review-item.is-done .icen-kb-review-item-title { color: var(--icen-token-text-faint); }
+.icen-kb-review-item-title {
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.icen-kb-review-item-kind {
+  font-size: 10.5px;
+  line-height: 1;
+  color: var(--icen-token-text-faint);
+  border: 1px solid var(--icen-token-line-soft);
+  border-radius: var(--icen-radius-full);
+  padding: 2px 6px;
+  white-space: nowrap;
+}
+.icen-kb-review-item-assignee { font-size: 11px; color: var(--icen-token-text-faint); white-space: nowrap; }
+
+/* 行内末端列：审查卡（全键盘流挂载点，RTL 镜像） */
+.icen-kb-review-card {
+  position: relative;
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+  padding: 14px;
+  border: 1px solid var(--icen-token-line-soft);
+  border-radius: var(--icen-radius-md);
+  background: var(--icen-token-surface);
+}
+.icen-kb-review-card:focus-visible { outline: 2px solid var(--icen-token-accent); outline-offset: -2px; }
+.icen-kb-review-card-head { display: flex; align-items: center; gap: 8px; min-width: 0; }
+.icen-kb-review-card-kind {
+  font-size: 10.5px;
+  line-height: 1;
+  color: var(--icen-token-text-faint);
+  border: 1px solid var(--icen-token-line-soft);
+  border-radius: var(--icen-radius-full);
+  padding: 2.5px 7px;
+  white-space: nowrap;
+}
+.icen-kb-review-card-title {
+  flex: 1 1 auto;
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  font-size: 13px;
+  font-weight: 600;
+  color: var(--icen-token-text);
+}
+
+/* rubric 行：categorical chips / numeric 滑杆 */
+.icen-kb-review-rubrics { display: flex; flex-direction: column; gap: 10px; }
+.icen-kb-review-rubric {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  padding: 8px 10px;
+  background: var(--icen-token-bg-soft);
+  border-radius: var(--icen-radius-sm);
+}
+.icen-kb-review-rubric-name { font-size: 12.5px; font-weight: 500; color: var(--icen-token-text); }
+.icen-kb-review-rubric-desc { font-size: 11.5px; font-weight: 400; color: var(--icen-token-text-faint); margin-inline-start: 6px; }
+
+.icen-kb-review-chips { display: flex; flex-wrap: wrap; gap: 6px; }
+.icen-kb-review-chip {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  font: inherit;
+  font-size: 12px;
+  color: var(--icen-token-text-muted);
+  background: var(--icen-token-bg);
+  border: 1px solid var(--icen-token-line-soft);
+  border-radius: var(--icen-radius-full);
+  padding: 3px 10px;
+  cursor: pointer;
+}
+.icen-kb-review-chip:hover { border-color: var(--icen-token-line); color: var(--icen-token-text); }
+.icen-kb-review-chip:focus-visible { outline: 2px solid var(--icen-token-accent); outline-offset: 1px; }
+.icen-kb-review-chip.is-on {
+  color: var(--icen-token-accent);
+  border-color: color-mix(in srgb, var(--icen-token-accent) 50%, transparent);
+  background: var(--icen-token-accent-subtle);
+}
+
+.icen-kb-review-slider-row { display: flex; align-items: center; gap: 10px; }
+.icen-kb-review-slider { flex: 1 1 auto; accent-color: var(--icen-token-accent); }
+.icen-kb-review-slider-value { min-inline-size: 34px; text-align: right; /* guard:allow-physical 数值物理右对齐惯例（数字是 LTR 文种），RTL 不镜像 */ }
+
+/* 底部：唯一的 accent 级主行动（一屏一个主行动纪律） */
+.icen-kb-review-foot { display: flex; align-items: center; gap: 10px; }
+.icen-kb-review-submit {
+  display: inline-flex;
+  align-items: center;
+  gap: 8px;
+  font: inherit;
+  font-size: 12.5px;
+  color: var(--icen-token-on-accent);
+  background: var(--icen-token-accent-strong);
+  border: none;
+  border-radius: var(--icen-radius-sm);
+  padding: 6px 14px;
+  cursor: pointer;
+}
+.icen-kb-review-submit:hover { background: var(--icen-token-accent-deep); }
+.icen-kb-review-submit:focus-visible { outline: 2px solid var(--icen-token-accent); outline-offset: 2px; }
+.icen-kb-review-hint { font-size: 11.5px; color: var(--icen-token-text-faint); }
+
+/* 快捷键小浮层（? 切换；复用 .icen-kb-key 键位帽；钉在卡片行内末端上角） */
+.icen-kb-review-keys {
+  position: absolute;
+  top: 8px;
+  inset-inline-end: 8px;
+  z-index: 2;
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  padding: 10px 12px;
+  min-width: 208px;
+  background: var(--icen-token-surface);
+  border: 1px solid var(--icen-token-line-soft);
+  border-radius: var(--icen-radius-md);
+  box-shadow: var(--icen-token-shadow-elevated);
+}
+.icen-kb-review-keys-row { display: flex; align-items: center; gap: 8px; font-size: 12px; color: var(--icen-token-text-muted); }
+.icen-kb-review-keys-row .icen-kb-key { flex: 0 0 auto; }
+
+/* ═══════════════ kb-gap：无答案分析 ═══════════════ */
+
+.icen-kb-gap { display: flex; flex-direction: column; gap: 12px; min-width: 0; }
+
+/* 迷你趋势：纯 div/i 柱（高度行内 %；不依赖 charts） */
+.icen-kb-gap-trend {
+  display: flex;
+  align-items: flex-end;
+  gap: 4px;
+  height: 40px;
+  padding: 2px 2px 0;
+}
+.icen-kb-gap-bar {
+  flex: 1 1 0;
+  min-width: 4px;
+  max-width: 28px;
+  background: var(--icen-token-line);
+  border-radius: 2px 2px 0 0; /* guard:allow-radius 微构件（bar/dot/track/指示器等图形级，不属容器圆角面） */
+  align-self: flex-end;
+}
+.icen-kb-gap-bar:hover { background: var(--icen-token-accent); }
+
+/* 表：query（mono）| 次数 | 占比 | 零点击率 | 最近出现 | 行动钮 */
+.icen-kb-gap-table { display: flex; flex-direction: column; min-width: 0; }
+.icen-kb-gap-row {
+  display: grid;
+  grid-template-columns: minmax(180px, 1fr) 56px 64px 72px 96px auto;
+  align-items: center;
+  gap: 10px;
+  min-height: 32px;
+  padding: 3px 8px;
+  border-bottom: 1px solid var(--icen-token-line-soft);
+}
+.icen-kb-gap-row:last-child { border-bottom: none; }
+.icen-kb-gap-row--head {
+  min-height: 28px;
+  font-size: 11px;
+  color: var(--icen-token-text-faint);
+  border-bottom: 1px solid var(--icen-token-line);
+}
+.icen-kb-gap-query {
+  font-family: var(--icen-font-mono);
+  font-size: 12px;
+  color: var(--icen-token-text);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.icen-kb-gap-num { text-align: right; /* guard:allow-physical 数字物理右对齐惯例（LTR 文种），RTL 不镜像 */ }
+.icen-kb-gap-head-zero { white-space: nowrap; }
+/* 口径注释：「零点击 ≠ 失败」（小字 + title tooltip；不上告警色） */
+.icen-kb-gap-note {
+  margin-inline-start: 6px;
+  font-size: 10.5px;
+  color: var(--icen-token-text-faint);
+  border-bottom: 1px dashed var(--icen-token-line-soft);
+  cursor: help;
+}
+.icen-kb-gap-lastseen { font-size: 11.5px; color: var(--icen-token-text-faint); text-align: end; white-space: nowrap; }
+.icen-kb-gap-actions { display: inline-flex; gap: 6px; justify-self: end; }
+.icen-kb-gap-action {
+  font: inherit;
+  font-size: 11.5px;
+  color: var(--icen-token-text-muted);
+  background: none;
+  border: 1px solid var(--icen-token-line-soft);
+  border-radius: var(--icen-radius-sm);
+  padding: 2px 8px;
+  cursor: pointer;
+  white-space: nowrap;
+}
+.icen-kb-gap-action:hover { color: var(--icen-token-text); border-color: var(--icen-token-line); }
+.icen-kb-gap-action:focus-visible { outline: 2px solid var(--icen-token-accent); outline-offset: 1px; }
+
+/* ═══════════════ kb-eval：评估对比 ═══════════════ */
+
+.icen-kb-eval { display: flex; flex-direction: column; gap: 12px; min-width: 0; }
+
+.icen-kb-eval-bar { display: flex; align-items: center; gap: 10px; flex-wrap: wrap; font-size: 12px; color: var(--icen-token-text-faint); }
+/* 弹层选择器（icen-select）域钩子：面样式随 select.css，此处只管布局 */
+.icen-kb-eval-run { flex: 0 1 220px; }
+
+/* Summary 判级行（告警才上色：improvement 绿 / regression 红 / tradeoff 警示 / tie 中性） */
+.icen-kb-eval-summary { display: flex; align-items: center; gap: 12px; flex-wrap: wrap; font-size: 12.5px; color: var(--icen-token-text-muted); }
+.icen-kb-eval-grade {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  font-size: 11.5px;
+  border: 1px solid var(--icen-token-line-soft);
+  border-radius: var(--icen-radius-full);
+  padding: 2.5px 9px;
+  color: var(--icen-token-text-faint);
+}
+.icen-kb-eval-grade.is-improvement {
+  color: var(--icen-token-success);
+  border-color: color-mix(in srgb, var(--icen-token-success) 45%, transparent);
+  background: color-mix(in srgb, var(--icen-token-success) 8%, transparent);
+}
+.icen-kb-eval-grade.is-regression {
+  color: var(--icen-token-error);
+  border-color: color-mix(in srgb, var(--icen-token-error) 45%, transparent);
+  background: color-mix(in srgb, var(--icen-token-error) 8%, transparent);
+}
+.icen-kb-eval-grade.is-tradeoff {
+  color: var(--icen-token-warning);
+  border-color: color-mix(in srgb, var(--icen-token-warning) 45%, transparent);
+  background: var(--icen-token-warning-muted);
+}
+
+.icen-kb-eval-filter {
+  font: inherit;
+  font-size: 11.5px;
+  color: var(--icen-token-text-muted);
+  background: none;
+  border: 1px solid var(--icen-token-line-soft);
+  border-radius: var(--icen-radius-full);
+  padding: 2px 10px;
+  cursor: pointer;
+  white-space: nowrap;
+}
+.icen-kb-eval-filter:hover { color: var(--icen-token-text); border-color: var(--icen-token-line); }
+.icen-kb-eval-filter:focus-visible { outline: 2px solid var(--icen-token-accent); outline-offset: 1px; }
+.icen-kb-eval-filter.is-on {
+  color: var(--icen-token-accent);
+  border-color: color-mix(in srgb, var(--icen-token-accent) 50%, transparent);
+  background: var(--icen-token-accent-subtle);
+}
+
+/* 结果表：横向滚动容器 + 行内 grid 模板（列由 JS 按指标数生成） */
+.icen-kb-eval-tablewrap { overflow-x: auto; }
+.icen-kb-eval-table { display: flex; flex-direction: column; min-width: max-content; }
+.icen-kb-eval-grid {
+  display: grid;
+  align-items: center;
+  gap: 0;
+}
+.icen-kb-eval-grid--head { border-bottom: 1px solid var(--icen-token-line); }
+.icen-kb-eval-h {
+  font-size: 11px;
+  color: var(--icen-token-text-faint);
+  padding: 4px 8px;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.icen-kb-eval-h--group { text-align: center; border-inline-start: 1px solid var(--icen-token-line-soft); }
+.icen-kb-eval-h--sub { text-align: right; /* guard:allow-physical 指标子列头是数值口径（LTR 文种），物理右对齐惯例，RTL 不镜像 */ border-inline-start: 1px solid var(--icen-token-line-soft); }
+
+.icen-kb-eval-rowline { border-bottom: 1px solid var(--icen-token-line-soft); cursor: pointer; }
+.icen-kb-eval-rowline:hover { background: var(--icen-token-bg-soft); }
+.icen-kb-eval-rowline:focus-visible { outline: 2px solid var(--icen-token-accent); outline-offset: -2px; }
+.icen-kb-eval-item:last-child .icen-kb-eval-rowline { border-bottom: none; }
+
+.icen-kb-eval-cell {
+  min-width: 0;
+  padding: 4px 8px;
+  font-size: 12px;
+  color: var(--icen-token-text-muted);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.icen-kb-eval-cell--input { display: flex; flex-direction: column; gap: 1px; min-width: 0; }
+.icen-kb-eval-key {
+  font-family: var(--icen-font-mono);
+  font-size: 10.5px;
+  color: var(--icen-token-text-faint);
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.icen-kb-eval-num { text-align: right; /* guard:allow-physical 数值物理右对齐惯例（LTR 文种），RTL 不镜像 */ padding: 4px 8px; }
+/* delta 列：宽 64 物理右对齐（数字惯例）；is-up 绿 / is-down 红 */
+.icen-kb-eval-delta { min-width: 64px; }
+.icen-kb-eval-delta.is-up { color: var(--icen-token-success); }
+.icen-kb-eval-delta.is-down { color: var(--icen-token-error); }
+
+/* 展开体：双栏对照 + 字符级 diff（A 独有红 / B 独有绿，color-mix 底色） */
+.icen-kb-eval-detail {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr) minmax(0, 1fr);
+  gap: 10px;
+  padding: 10px 8px;
+  background: var(--icen-token-bg-soft);
+  border-radius: var(--icen-radius-sm);
+}
+.icen-kb-eval-detail-col { min-width: 0; display: flex; flex-direction: column; gap: 4px; }
+.icen-kb-eval-detail-label { font-size: 11px; color: var(--icen-token-text-faint); }
+.icen-kb-eval-detail-pre {
+  margin: 0;
+  font-family: var(--icen-font-mono);
+  font-size: 12px;
+  line-height: 1.6;
+  white-space: pre-wrap;
+  word-break: break-word;
+  color: var(--icen-token-text-muted);
+}
+.icen-kb-eval-detail-expected { grid-column: 1 / -1; min-width: 0; display: flex; flex-direction: column; gap: 4px; }
+.icen-kb-eval-diff-del {
+  background: color-mix(in srgb, var(--icen-token-error) 14%, transparent);
+  color: var(--icen-token-error);
+  border-radius: 2px; /* guard:allow-radius 微构件（bar/dot/track/指示器等图形级，不属容器圆角面） */
+}
+.icen-kb-eval-diff-ins {
+  background: color-mix(in srgb, var(--icen-token-success) 14%, transparent);
+  color: var(--icen-token-success);
+  border-radius: 2px; /* guard:allow-radius 微构件（bar/dot/track/指示器等图形级，不属容器圆角面） */
+}
+
+/* ═══════════════ hidden 属性优先（本文件的 display 声明不得击穿 [hidden]） ═══════════════ */
+
+.icen-kb-span[hidden],
+.icen-kb-trace-body[hidden],
+.icen-kb-review-keys[hidden],
+.icen-kb-eval-detail[hidden],
+.icen-kb-eval-item[hidden],
+.icen-kb-gap-row[hidden] { display: none; }
+
+/* ═══════════════ 动效退化（reduced-motion：瞬时） ═══════════════ */
+
+@media (prefers-reduced-motion: reduce) {
+  .icen-kb-span-caret,
+  .icen-kb-span-bar,
+  .icen-kb-gap-bar { transition: none; }
+  .icen-kb-span.is-running .icen-kb-span-bar { animation: none; }
+}
+
+/* ── RTL：方向性指示镜像 ── */
+/* trace 树 caret：共享 chevron mask 经 scaleX(-1) 翻转向左 */
+:is([dir='rtl']) .icen-kb-span-caret { transform: scaleX(-1); }
+:is([dir='rtl']) .icen-kb-span[aria-expanded='true'] .icen-kb-span-caret { transform: rotate(90deg) scaleX(-1); }
+/* review 队列激活描边：box-shadow 无逻辑属性，inset 起始缘 2px 在 RTL 下取负 */
+:is([dir='rtl']) .icen-kb-review-item.is-active { box-shadow: inset -2px 0 0 var(--icen-token-accent); }
+
+}

package/dist/components/kb-passage.mjs

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