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

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';