@icen.ai/ui 0.8.1 → 0.10.0

package/dist/components/kb-ground.css

@@ -0,0 +1,578 @@
+@layer icen.components {
+/*
+ * @icen.ai/ui — kb-ground.css（证据域：kb-citation / kb-sources / kb-passage / kb-conflict）
+ * 共享原语在 kb.css（.icen-kb-row/.icen-kb-quote/.icen-kb-badge/.icen-kb-num…），本文件只做本域专属结构。
+ * DOM 契约见 docs/spec/kb-family.md §5.1–5.4；behaviors/kb-citation.ts 等。
+ *
+ * 视觉音调（spec §2 硬约束）：
+ *   - 字号：标题 13px/600 · 正文 13px · 元信息 11.5px · 徽标 10.5px；数字一律 .icen-kb-num
+ *   - 节奏：行 28px（data-icen-density="compact" 收 24px）· 区块 16px · 组内 8px
+ *   - 圆角：容器 --icen-radius-md · 行内（角标/chip）--icen-radius-sm 或全圆
+ *   - 色彩：证据域主角是 accent，但角标默认 faint 弱化、hover/激活才点亮；
+ *     阴影只用 --icen-token-shadow-overlay（不自造阴影层），z 尺只借 --icen-z-* 标尺
+ *   - 动效：滑入 200ms / hover 反馈 --icen-tx-fast / 折叠 160ms；reduced-motion 全退化为瞬时
+ */
+
+/* ══════════════════════════════════════════════
+   §5.1 kb-citation 行内引用角标
+   ══════════════════════════════════════════════ */
+
+.icen-kb-citation {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-width: 16px;
+  height: 16px;
+  margin: 0 1px;
+  padding: 0 3px;
+  border: 1px solid var(--icen-token-line-soft);
+  border-radius: var(--icen-radius-sm);
+  background: transparent;
+  color: var(--icen-token-text-faint);
+  font-family: var(--icen-font-mono);
+  font-variant-numeric: tabular-nums;
+  font-size: 10px;
+  line-height: 1;
+  vertical-align: 2px; /* 上标视感，与正文基线对齐 */
+  cursor: pointer;
+  transition: color var(--icen-tx-fast), border-color var(--icen-tx-fast),
+    background-color var(--icen-tx-fast);
+}
+/* hover 点亮 accent：引用是证据域主角，但默认弱化、悬停才给注意力 */
+.icen-kb-citation:hover {
+  color: var(--icen-token-accent);
+  border-color: color-mix(in srgb, var(--icen-token-accent) 45%, transparent);
+  background: color-mix(in srgb, var(--icen-token-accent) 8%, transparent);
+}
+.icen-kb-citation:focus-visible {
+  outline: none;
+  box-shadow: var(--icen-ring);
+}
+/* 无效编号：灰显不可点（不信任模型生成编号的降级态） */
+.icen-kb-citation.is-dead {
+  pointer-events: none;
+  cursor: default;
+  opacity: 0.5;
+  border-color: transparent;
+  background: transparent;
+}
+
+/* ── hover 引用卡（openPopover portal 挂 body；left/top/width 由 popover 布局引擎内联） ── */
+
+.icen-kb-citation-card {
+  position: fixed;
+  z-index: var(--icen-z-popover);
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  max-width: 340px;
+  padding: 10px 12px;
+  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-overlay);
+  animation: kb-ground-card-in var(--icen-tx-fast);
+}
+@keyframes kb-ground-card-in {
+  from { opacity: 0; transform: translateY(2px); }
+  to { opacity: 1; transform: none; }
+}
+.icen-kb-citation-card-head {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  min-width: 0;
+}
+.icen-kb-citation-card-icon {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  flex: 0 0 auto;
+  width: 14px;
+  height: 14px;
+  color: var(--icen-token-text-muted);
+}
+.icen-kb-citation-card-icon > svg { width: 14px; height: 14px; }
+.icen-kb-citation-card-title {
+  min-width: 0;
+  font-size: 13px;
+  font-weight: 600;
+  color: var(--icen-token-text);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.icen-kb-citation-card-domain {
+  font-family: var(--icen-font-mono);
+  font-size: 11px;
+  color: var(--icen-token-text-faint);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+/* 受限来源：citedText 视觉打码（原文未下发，blur 只是提示层） */
+.icen-kb-citation-card-quote.icen-kb-citation-card-masked {
+  filter: blur(4px);
+  user-select: none;
+}
+.icen-kb-citation-card-badges {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  flex-wrap: wrap;
+}
+
+/* ══════════════════════════════════════════════
+   §5.2 kb-sources 来源列表（--row 横排 / --rail 纵列）
+   ══════════════════════════════════════════════ */
+
+.icen-kb-sources {
+  display: flex;
+  gap: 8px;
+  min-width: 0;
+}
+/* 答案上方横排：内容宽、可换行 */
+.icen-kb-sources--row {
+  flex-direction: row;
+  flex-wrap: wrap;
+  align-items: stretch;
+}
+/* 侧栏纵列：整行宽。side 收进 main（kb-sources.ts rail DOM）——标题独占两行、
+   meta 行与徽章行各自换行，绝不把标题挤成一行省略号再压徽章 */
+.icen-kb-sources--rail {
+  flex-direction: column;
+}
+.icen-kb-sources--rail .icen-kb-source {
+  grid-template-columns: auto minmax(0, 1fr);
+  align-items: flex-start;
+}
+.icen-kb-sources--rail .icen-kb-source-title {
+  display: -webkit-box;
+  -webkit-box-orient: vertical;
+  -webkit-line-clamp: 2;
+  line-clamp: 2;
+  white-space: normal;
+  overflow: hidden;
+}
+.icen-kb-sources--rail .icen-kb-source-sub {
+  white-space: normal;
+  word-break: break-word;
+  overflow: visible;
+  text-overflow: unset;
+}
+.icen-kb-sources--rail .icen-kb-source-main .icen-kb-source-side {
+  flex-wrap: wrap;
+  align-items: center;
+  margin-top: 3px;
+}
+
+.icen-kb-source {
+  --kb-source-tint: var(--icen-token-accent);
+  position: relative;
+  display: grid;
+  grid-template-columns: auto 1fr auto;
+  align-items: center;
+  gap: 10px;
+  min-height: 28px;
+  padding-block: 4px;
+  padding-inline: 10px 8px;
+  border: 1px solid transparent;
+  border-radius: var(--icen-radius-sm);
+  background: transparent;
+  font: inherit;
+  text-align: start;
+  cursor: pointer;
+  transition: background-color var(--icen-tx-fast), border-color var(--icen-tx-fast),
+    transform var(--icen-tx-fast);
+}
+.icen-kb-sources--row .icen-kb-source { inline-size: auto; }
+.icen-kb-sources--rail .icen-kb-source { inline-size: 100%; }
+/* hover 浮起（1px 上移 = 轻量层级暗示，不进阴影层）；仅可悬停设备生效（触屏关闭抬升） */
+@media (hover: hover) and (pointer: fine) {
+  .icen-kb-source:hover {
+    background: var(--icen-token-bg-soft);
+    border-color: var(--icen-token-line-soft);
+    transform: translateY(-1px);
+  }
+}
+.icen-kb-source:focus-visible {
+  outline: none;
+  box-shadow: var(--icen-ring);
+}
+/* 当前阅读位：起始缘 2px accent 证据线（宿主或 kb-passage 锚定驱动，RTL 镜像） */
+.icen-kb-source.is-active {
+  background: var(--icen-token-bg-soft);
+  border-color: color-mix(in srgb, var(--kb-source-tint) 30%, transparent);
+}
+.icen-kb-source.is-active::before {
+  content: '';
+  position: absolute;
+  inset-inline-start: 0;
+  top: 5px;
+  bottom: 5px;
+  width: 2px;
+  border-radius: 1px; /* guard:allow-radius 微构件（bar/dot/track/指示器等图形级，不属容器圆角面）  */
+  background: var(--kb-source-tint);
+}
+
+.icen-kb-source-icon {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  flex: 0 0 auto;
+  width: 16px;
+  height: 16px;
+  color: var(--icen-token-text-muted);
+}
+.icen-kb-source-icon > svg { width: 14px; height: 14px; }
+.icen-kb-source-main {
+  min-width: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 1px;
+}
+.icen-kb-source-title {
+  font-size: 13px;
+  line-height: 1.4;
+  color: var(--icen-token-text);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.icen-kb-source-sub {
+  font-size: 11.5px;
+  line-height: 1.4;
+  color: var(--icen-token-text-faint);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.icen-kb-source-side {
+  display: inline-flex;
+  align-items: center;
+  gap: 8px;
+  flex: 0 0 auto;
+}
+.icen-kb-source-badges {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  flex-wrap: wrap;
+}
+.icen-kb-source-badges .icen-kb-dot { width: 6px; height: 6px; }
+
+/* 受限行内的申请访问按钮（行壳已降级为 role=button，嵌套合法） */
+.icen-kb-source-request {
+  flex: 0 0 auto;
+  padding: 2.5px 7px;
+  border: 1px solid var(--icen-token-line-soft);
+  border-radius: var(--icen-radius-full);
+  background: transparent;
+  color: var(--icen-token-text-muted);
+  font-size: 10.5px;
+  line-height: 1;
+  letter-spacing: 0.3px;
+  cursor: pointer;
+  transition: color var(--icen-tx-fast), border-color var(--icen-tx-fast);
+}
+.icen-kb-source-request:hover {
+  color: var(--icen-token-accent);
+  border-color: color-mix(in srgb, var(--icen-token-accent) 45%, transparent);
+}
+.icen-kb-source-request:focus-visible {
+  outline: none;
+  box-shadow: var(--icen-ring);
+}
+
+/* 密度 compact：行高 28 → 24 */
+[data-icen-density='compact'] .icen-kb-source { min-height: 24px; gap: 8px; }
+
+/* ══════════════════════════════════════════════
+   §5.3 kb-passage 原文定位抽屉（行内末端侧 340px，RTL 镜像到左侧）
+   ══════════════════════════════════════════════ */
+
+.icen-kb-passage {
+  --kb-passage-duration: 200ms;
+  position: fixed;
+  inset-block: 0;
+  inset-inline-end: 0;
+  inline-size: min(340px, 92vw);
+  z-index: var(--icen-z-chrome);
+  display: flex;
+  flex-direction: column;
+  background: var(--icen-token-surface);
+  border-inline-start: 1px solid var(--icen-token-line-soft);
+  box-shadow: var(--icen-token-shadow-overlay);
+  transform: translateX(100%); /* guard:allow-physical 隐藏位沿物理右缘滑出（LTR 抽屉侧），RTL 镜像规则翻为 translateX(-100%) */
+  transition: transform var(--kb-passage-duration) var(--icen-ease-out);
+}
+.icen-kb-passage[hidden] { display: none; }
+.icen-kb-passage.is-open { transform: translateX(0); }
+
+.icen-kb-passage-head {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 10px 12px;
+  border-bottom: 1px solid var(--icen-token-line-soft);
+}
+.icen-kb-passage-icon {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  flex: 0 0 auto;
+  width: 16px;
+  height: 16px;
+  color: var(--icen-token-text-muted);
+}
+.icen-kb-passage-icon > svg { width: 16px; height: 16px; }
+.icen-kb-passage-titlewrap {
+  flex: 1 1 auto;
+  min-width: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+}
+.icen-kb-passage-title {
+  font-size: 13px;
+  font-weight: 600;
+  line-height: 1.4;
+  color: var(--icen-token-text);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.icen-kb-passage-loc {
+  font-family: var(--icen-font-mono);
+  font-size: 11px;
+  letter-spacing: 0.3px;
+  color: var(--icen-token-text-faint);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.icen-kb-passage-close {
+  flex: 0 0 auto;
+  width: 24px;
+  height: 24px;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  border: none;
+  border-radius: var(--icen-radius-sm);
+  background: transparent;
+  color: var(--icen-token-text-faint);
+  font-size: 14px;
+  line-height: 1;
+  cursor: pointer;
+  transition: color var(--icen-tx-fast), background-color var(--icen-tx-fast);
+}
+.icen-kb-passage-close:hover { color: var(--icen-token-text); background: var(--icen-token-bg-soft); }
+.icen-kb-passage-close:focus-visible { outline: none; box-shadow: var(--icen-ring); }
+
+.icen-kb-passage-body {
+  flex: 1 1 auto;
+  min-height: 0;
+  overflow-y: auto;
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 12px;
+  font-size: 13px;
+  line-height: 1.7;
+  color: var(--icen-token-text);
+}
+.icen-kb-passage-text { min-inline-size: 0; word-break: break-word; white-space: pre-wrap; }
+/* 多命中分色 mark（.kb-passage-hit）与基础 mark 底色均由 kb.css 统一供给 */
+
+/* 上下文（默认隐藏，expand 展开；弱化为 faint 引导体；引导线沿 inline-start，RTL 镜像） */
+.icen-kb-passage-context {
+  position: relative;
+  padding-block: 2px;
+  padding-inline-start: 12px;
+  font-size: 12.5px;
+  line-height: 1.7;
+  color: var(--icen-token-text-faint);
+  white-space: pre-wrap;
+  word-break: break-word;
+}
+.icen-kb-passage-context::before {
+  content: '';
+  position: absolute;
+  inset-inline-start: 0;
+  top: 4px;
+  bottom: 4px;
+  width: 2px;
+  border-radius: 1px; /* guard:allow-radius 微构件（bar/dot/track/指示器等图形级，不属容器圆角面）  */
+  background: var(--icen-token-line-soft);
+}
+.icen-kb-passage-context[hidden] { display: none; }
+.icen-kb-passage.is-expanded .icen-kb-passage-context { animation: kb-ground-card-in var(--icen-tx-fast); }
+
+.icen-kb-passage-expand {
+  align-self: flex-start;
+  padding: 2px 8px;
+  border: none;
+  border-radius: var(--icen-radius-sm);
+  background: transparent;
+  color: var(--icen-token-text-muted);
+  font-size: 11.5px;
+  cursor: pointer;
+  transition: color var(--icen-tx-fast), background-color var(--icen-tx-fast);
+}
+.icen-kb-passage-expand:hover { color: var(--icen-token-text); background: var(--icen-token-bg-soft); }
+.icen-kb-passage-expand:focus-visible { outline: none; box-shadow: var(--icen-ring); }
+
+/* 受限正文：citedText 打码 + 申请访问 */
+.icen-kb-passage-masked {
+  filter: blur(4px);
+  user-select: none;
+  font-size: 12.5px;
+  line-height: 1.7;
+  color: var(--icen-token-text-muted);
+  white-space: pre-wrap;
+  word-break: break-word;
+}
+.icen-kb-passage-request {
+  display: inline-flex;
+  align-items: center;
+  gap: 5px;
+  align-self: flex-start;
+  margin-top: 4px;
+  padding: 4px 10px;
+  border: 1px solid color-mix(in srgb, var(--icen-token-accent) 45%, transparent);
+  border-radius: var(--icen-radius-full);
+  background: var(--icen-token-accent-subtle);
+  color: var(--icen-token-accent);
+  font-size: 11.5px;
+  cursor: pointer;
+  transition: background-color var(--icen-tx-fast), border-color var(--icen-tx-fast);
+}
+.icen-kb-passage-request > svg { width: 12px; height: 12px; }
+.icen-kb-passage-request:hover {
+  border-color: var(--icen-token-accent);
+}
+.icen-kb-passage-request:focus-visible { outline: none; box-shadow: var(--icen-ring); }
+
+/* 跳转锚定宿主（[data-icen-kb-loc]）：命中项 .is-current 高亮 */
+[data-icen-kb-loc].is-current {
+  background: color-mix(in srgb, var(--icen-token-accent) 10%, transparent);
+  box-shadow: inset 2px 0 0 var(--icen-token-accent);
+  border-radius: var(--icen-radius-sm);
+}
+
+/* ══════════════════════════════════════════════
+   §5.4 kb-conflict 来源冲突组
+   ══════════════════════════════════════════════ */
+
+.icen-kb-conflict {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 10px 12px;
+  border: 1px solid var(--icen-token-line-soft);
+  border-radius: var(--icen-radius-md);
+  background: var(--icen-token-bg-soft);
+}
+.icen-kb-conflict + .icen-kb-conflict { margin-top: 16px; } /* 区块间距纪律 */
+.icen-kb-conflict-claim {
+  display: flex;
+  align-items: baseline;
+  gap: 8px;
+  font-size: 13px;
+  font-weight: 600;
+  color: var(--icen-token-text);
+}
+.icen-kb-conflict-claim .icen-kb-dot { align-self: center; }
+.icen-kb-conflict-versions {
+  display: flex;
+  flex-direction: row;
+  flex-wrap: wrap;
+  gap: 8px;
+}
+
+.icen-kb-conflict-ver {
+  flex: 1 1 160px;
+  min-inline-size: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  padding: 8px 10px;
+  border: 1px solid var(--icen-token-line-soft);
+  border-radius: var(--icen-radius-md);
+  background: var(--icen-token-surface);
+  font: inherit;
+  text-align: start;
+  cursor: pointer;
+  transition: border-color var(--icen-tx-fast), background-color var(--icen-tx-fast);
+}
+/* is-current：最新/官方版本，accent 高亮（唯一主角） */
+.icen-kb-conflict-ver.is-current {
+  border-color: color-mix(in srgb, var(--icen-token-accent) 45%, transparent);
+  background: color-mix(in srgb, var(--icen-token-accent) 6%, var(--icen-token-surface));
+}
+/* 其余版本：faded 退后 */
+.icen-kb-conflict-ver.is-older { /* 不降透明：透明会折进文字对比度；旧版语义由 muted 文案承担 */ }
+.icen-kb-conflict-ver:hover {
+  border-color: color-mix(in srgb, var(--icen-token-accent) 45%, transparent);
+}
+.icen-kb-conflict-ver.is-older:hover { /* hover 反馈由底色承担 */ }
+.icen-kb-conflict-ver:focus-visible { outline: none; box-shadow: var(--icen-ring); }
+
+.icen-kb-conflict-ver-head {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  min-inline-size: 0;
+}
+.icen-kb-conflict-ver-date { font-size: 11px; }
+.icen-kb-conflict-ver-badges {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  margin-inline-start: auto;
+}
+.icen-kb-conflict-ver-badges .icen-kb-dot { width: 6px; height: 6px; }
+.icen-kb-conflict-ver-title {
+  font-size: 12.5px;
+  line-height: 1.4;
+  color: var(--icen-token-text);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.icen-kb-conflict-ver-sub {
+  font-size: 11.5px;
+  line-height: 1.4;
+  color: var(--icen-token-text-muted);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+/* ══════════════════════════════════════════════
+   动效守卫（reduced-motion：全退化为瞬时）
+   ══════════════════════════════════════════════ */
+
+@media (prefers-reduced-motion: reduce) {
+  .icen-kb-citation,
+  .icen-kb-source,
+  .icen-kb-source-request,
+  .icen-kb-passage,
+  .icen-kb-passage-close,
+  .icen-kb-passage-expand,
+  .icen-kb-passage-request,
+  .icen-kb-conflict-ver {
+    transition: none;
+  }
+  .icen-kb-citation-card,
+  .icen-kb-passage.is-expanded .icen-kb-passage-context {
+    animation: none;
+  }
+}
+
+/* ── RTL：kb-passage 抽屉隐藏位镜像（抽屉改贴行内末端左侧，滑出方向同步翻转） ── */
+:is([dir='rtl']) .icen-kb-passage { transform: translateX(-100%); }
+:is([dir='rtl']) .icen-kb-passage.is-open { transform: translateX(0); }
+
+}

package/dist/components/kb-hittest.mjs

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