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

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/layout.css

@@ -1,109 +1,112 @@
+@layer icen.components {
 /*
  * @icen.ai/ui — Component: layout（布局原语，全部是工具类，无 JS）
  * stack / divider / surface / text / grid / center / container / aspect / visually-hidden
- * 全部消费 --token-* 与 --density-*；档位类名与 opengal primitives/layout(-containers) 一一对应。
+ * 全部消费 --icen-token-* 与 --icen-density-*；档位类名与 opengal primitives/layout(-containers) 一一对应。
  */
 
 /* ── Stack：flex 堆叠（默认列向，gap = density-space-sm） ── */
-.stack { display: flex; flex-direction: column; gap: var(--density-space-sm); }
-.stack--row { flex-direction: row; }
-.stack--inline { display: inline-flex; }
-.stack--wrap { flex-wrap: wrap; }
-.stack--gap-0 { gap: 0; }
-.stack--gap-1 { gap: var(--density-space-xs); }
-.stack--gap-2 { gap: var(--density-space-sm); }
-.stack--gap-3 { gap: var(--density-space-md); }
-.stack--gap-4 { gap: var(--density-space-lg); }
-.stack--gap-6 { gap: var(--density-space-xl); }
-.stack--gap-8 { gap: var(--density-space-2xl); }
-.stack--gap-12 { gap: var(--density-space-3xl); }
-.stack--gap-16 { gap: var(--density-space-4xl); }
-.stack--items-start { align-items: flex-start; }
-.stack--items-center { align-items: center; }
-.stack--items-end { align-items: flex-end; }
-.stack--items-stretch { align-items: stretch; }
-.stack--items-baseline { align-items: baseline; }
-.stack--justify-start { justify-content: flex-start; }
-.stack--justify-center { justify-content: center; }
-.stack--justify-end { justify-content: flex-end; }
-.stack--justify-between { justify-content: space-between; }
-.stack--justify-around { justify-content: space-around; }
-.stack--justify-evenly { justify-content: space-evenly; }
+.icen-stack { display: flex; flex-direction: column; gap: var(--icen-density-space-sm); }
+.icen-stack--row { flex-direction: row; }
+.icen-stack--inline { display: inline-flex; }
+.icen-stack--wrap { flex-wrap: wrap; }
+.icen-stack--gap-0 { gap: 0; }
+.icen-stack--gap-1 { gap: var(--icen-density-space-xs); }
+.icen-stack--gap-2 { gap: var(--icen-density-space-sm); }
+.icen-stack--gap-3 { gap: var(--icen-density-space-md); }
+.icen-stack--gap-4 { gap: var(--icen-density-space-lg); }
+.icen-stack--gap-6 { gap: var(--icen-density-space-xl); }
+.icen-stack--gap-8 { gap: var(--icen-density-space-2xl); }
+.icen-stack--gap-12 { gap: var(--icen-density-space-3xl); }
+.icen-stack--gap-16 { gap: var(--icen-density-space-4xl); }
+.icen-stack--items-start { align-items: flex-start; }
+.icen-stack--items-center { align-items: center; }
+.icen-stack--items-end { align-items: flex-end; }
+.icen-stack--items-stretch { align-items: stretch; }
+.icen-stack--items-baseline { align-items: baseline; }
+.icen-stack--justify-start { justify-content: flex-start; }
+.icen-stack--justify-center { justify-content: center; }
+.icen-stack--justify-end { justify-content: flex-end; }
+.icen-stack--justify-between { justify-content: space-between; }
+.icen-stack--justify-around { justify-content: space-around; }
+.icen-stack--justify-evenly { justify-content: space-evenly; }
 
 /* ── Divider：分隔线 ── */
-.divider { background: var(--token-outline-soft); height: 1px; width: 100%; }
-.divider--vertical { width: 1px; height: 100%; align-self: stretch; }
+.icen-divider { background: var(--icen-token-outline-soft); height: 1px; width: 100%; }
+.icen-divider--vertical { width: 1px; height: 100%; align-self: stretch; }
 
 /* ── Surface：卡片容器（默认 inset 阴影 + density-space-lg padding） ── */
-.surface {
-  border-radius: var(--radius-lg);
-  background: var(--token-card);
-  border: 1px solid var(--token-outline-soft);
-  box-shadow: var(--token-shadow-inset);
-  padding: var(--density-space-lg);
+.icen-surface {
+  border-radius: var(--icen-radius-lg);
+  background: var(--icen-token-card);
+  border: 1px solid var(--icen-token-outline-soft);
+  box-shadow: var(--icen-token-shadow-inset);
+  padding: var(--icen-density-space-lg);
 }
-.surface--elevated { box-shadow: var(--token-shadow-card); }
-.surface--overlay {
-  background: var(--token-card-strong);
-  border-color: var(--token-outline);
-  box-shadow: var(--token-shadow-overlay);
+.icen-surface--elevated { box-shadow: var(--icen-token-shadow-card); }
+.icen-surface--overlay {
+  background: var(--icen-token-card-strong);
+  border-color: var(--icen-token-outline);
+  box-shadow: var(--icen-token-shadow-overlay);
 }
-.surface--p-none { padding: 0; }
-.surface--p-sm { padding: var(--density-space-md); }
-.surface--p-md { padding: var(--density-space-lg); }
-.surface--p-lg { padding: calc(var(--density-space-lg) + var(--density-space-xs)); }
+.icen-surface--p-none { padding: 0; }
+.icen-surface--p-sm { padding: var(--icen-density-space-md); }
+.icen-surface--p-md { padding: var(--icen-density-space-lg); }
+.icen-surface--p-lg { padding: calc(var(--icen-density-space-lg) + var(--icen-density-space-xs)); }
 
 /* ── Text：字号 / 语义色 / 截断 ── */
-.text--xs { font-size: var(--density-font-size-xs); }
-.text--sm { font-size: var(--density-font-size-sm); }
-.text--base { font-size: var(--density-font-size-md); }
-.text--md { font-size: var(--density-font-size-lg); }
-.text--lg { font-size: var(--density-font-size-lg); }
-.text--xl { font-size: var(--density-font-size-xl); }
-.text--2xl { font-size: var(--density-font-size-2xl); }
-.text--muted { color: var(--token-text-muted); }
-.text--faint { color: var(--token-text-faint); }
-.text--accent { color: var(--token-accent); }
-.text--success { color: var(--token-success); }
-.text--warning { color: var(--token-warning); }
-.text--error { color: var(--token-error); }
-.text--truncate { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.icen-text--xs { font-size: var(--icen-density-font-size-xs); }
+.icen-text--sm { font-size: var(--icen-density-font-size-sm); }
+.icen-text--base { font-size: var(--icen-density-font-size-md); }
+.icen-text--md { font-size: var(--icen-density-font-size-lg); }
+.icen-text--lg { font-size: var(--icen-density-font-size-lg); }
+.icen-text--xl { font-size: var(--icen-density-font-size-xl); }
+.icen-text--2xl { font-size: var(--icen-density-font-size-2xl); }
+.icen-text--muted { color: var(--icen-token-text-muted); }
+.icen-text--faint { color: var(--icen-token-text-faint); }
+.icen-text--accent { color: var(--icen-token-accent-text, var(--icen-token-accent-deep, var(--icen-token-accent))); }
+.icen-text--success { color: var(--icen-token-success); }
+.icen-text--warning { color: var(--icen-token-warning); }
+.icen-text--error { color: var(--icen-token-error); }
+.icen-text--truncate { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
 
 /* ── Grid：栅格（默认 gap = density-space-md） ── */
-.grid { display: grid; gap: var(--density-space-md); }
-.grid--cols-1 { grid-template-columns: repeat(1, minmax(0, 1fr)); }
-.grid--cols-2 { grid-template-columns: repeat(2, minmax(0, 1fr)); }
-.grid--cols-3 { grid-template-columns: repeat(3, minmax(0, 1fr)); }
-.grid--cols-4 { grid-template-columns: repeat(4, minmax(0, 1fr)); }
-.grid--cols-6 { grid-template-columns: repeat(6, minmax(0, 1fr)); }
-.grid--cols-12 { grid-template-columns: repeat(12, minmax(0, 1fr)); }
-.grid--gap-0 { gap: 0; }
-.grid--gap-4 { gap: var(--density-space-xs); }
-.grid--gap-8 { gap: var(--density-space-sm); }
-.grid--gap-12 { gap: var(--density-space-md); }
-.grid--gap-16 { gap: var(--density-space-lg); }
-.grid--gap-24 { gap: var(--density-space-xl); }
+.icen-grid { display: grid; gap: var(--icen-density-space-md); }
+.icen-grid--cols-1 { grid-template-columns: repeat(1, minmax(0, 1fr)); }
+.icen-grid--cols-2 { grid-template-columns: repeat(2, minmax(0, 1fr)); }
+.icen-grid--cols-3 { grid-template-columns: repeat(3, minmax(0, 1fr)); }
+.icen-grid--cols-4 { grid-template-columns: repeat(4, minmax(0, 1fr)); }
+.icen-grid--cols-6 { grid-template-columns: repeat(6, minmax(0, 1fr)); }
+.icen-grid--cols-12 { grid-template-columns: repeat(12, minmax(0, 1fr)); }
+.icen-grid--gap-0 { gap: 0; }
+.icen-grid--gap-4 { gap: var(--icen-density-space-xs); }
+.icen-grid--gap-8 { gap: var(--icen-density-space-sm); }
+.icen-grid--gap-12 { gap: var(--icen-density-space-md); }
+.icen-grid--gap-16 { gap: var(--icen-density-space-lg); }
+.icen-grid--gap-24 { gap: var(--icen-density-space-xl); }
 
 /* ── Center：flex 居中盒 ── */
-.center { display: flex; align-items: center; justify-content: center; }
+.icen-center { display: flex; align-items: center; justify-content: center; }
 
 /* ── Container：限宽容器（默认 960px） ── */
-.container { width: 100%; margin-inline: auto; padding-inline: var(--density-space-lg); max-width: 960px; }
-.container--sm { max-width: 480px; }
-.container--md { max-width: 720px; }
-.container--lg { max-width: 960px; }
-.container--xl { max-width: 1200px; }
-.container--full { max-width: none; }
+.icen-container { width: 100%; margin-inline: auto; padding-inline: var(--icen-density-space-lg); max-width: 960px; }
+.icen-container--sm { max-width: 480px; }
+.icen-container--md { max-width: 720px; }
+.icen-container--lg { max-width: 960px; }
+.icen-container--xl { max-width: 1200px; }
+.icen-container--full { max-width: none; }
 
 /* ── Aspect：固定比例盒（aspect-ratio，内容 absolute inset:0 铺满） ── */
-.aspect { position: relative; width: 100%; overflow: hidden; aspect-ratio: 16 / 9; }
-.aspect--square { aspect-ratio: 1 / 1; }
-.aspect--4-3 { aspect-ratio: 4 / 3; }
-.aspect--2-3 { aspect-ratio: 2 / 3; }
-.aspect > * { position: absolute; inset: 0; }
+.icen-aspect { position: relative; width: 100%; overflow: hidden; aspect-ratio: 16 / 9; }
+.icen-aspect--square { aspect-ratio: 1 / 1; }
+.icen-aspect--4-3 { aspect-ratio: 4 / 3; }
+.icen-aspect--2-3 { aspect-ratio: 2 / 3; }
+.icen-aspect > * { position: absolute; inset: 0; }
 
 /* ── VisuallyHidden：屏幕阅读器专用文本（sr-only 等价） ── */
-.visually-hidden {
+.icen-visually-hidden {
   position: absolute; width: 1px; height: 1px; margin: -1px; padding: 0;
   overflow: hidden; clip: rect(0 0 0 0); white-space: nowrap; border: 0;
 }
+
+}

package/dist/components/material-chinese.css

@@ -0,0 +1,73 @@
+@layer icen.components {
+/* 中式 material adapter. DOM contract: html[data-icen-style="chinese"] with
+ * existing ICEN components or [data-icen-material="content|chrome|floating"].
+ * No additional wrappers, decorative pseudo-elements or JavaScript required.
+ */
+:root[data-icen-style="chinese"] {
+  --icen-press: scale(.995);
+  --icen-press-soft: scale(.995);
+  --icen-hover-border: var(--icen-token-line);
+  --icen-hover-border-strong: var(--icen-token-line-strong);
+  --icen-ring: 0 0 0 2px var(--icen-token-surface), 0 0 0 4px var(--icen-token-accent);
+  --icen-ring-soft: 0 0 0 3px var(--icen-token-accent-subtle);
+  --icen-control-focus-shadow: var(--icen-ring-soft);
+  --icen-control-focus-border: var(--icen-token-accent);
+}
+:root[data-icen-style="chinese"] :is([data-icen-material],.icen-menu,.icen-popover,.icen-select-panel,.icen-date-picker-panel,.icen-autocomplete-panel,.icen-cascader-panel,.icen-tree-select-panel,.icen-mentions-panel,.icen-ai-composer-popup,.icen-command-palette,.icen-card--glass,.icen-nav) {
+  background: var(--icen-token-surface);
+  border-color: var(--icen-token-line);
+  backdrop-filter: none;
+  -webkit-backdrop-filter: none;
+}
+:root[data-icen-style="chinese"] :is(h1,h2,h3,h4,h5,h6,.icen-card-title,.icen-modal-title) {
+  font-family: var(--icen-font-heading);
+  font-weight: 500;
+  letter-spacing: var(--icen-letter-spacing-heading);
+  line-height: var(--icen-line-height-heading);
+}
+:root[data-icen-style="chinese"] :is(.icen-btn,.icen-page-tab,.icen-segmented-item) {
+  font-family: var(--icen-font-body);
+  letter-spacing: .025em;
+  font-weight: 500;
+}
+:root[data-icen-style="chinese"] :is(.icen-card,.icen-panel,[data-icen-material="content"]) {
+  border-color: var(--icen-token-line-soft);
+  box-shadow: none;
+}
+:root[data-icen-style="chinese"] .icen-card--elevated { box-shadow: var(--icen-token-shadow-card); }
+:root[data-icen-style="chinese"] :is(.icen-card.is-selected,.icen-card--interactive:focus-within) { box-shadow: var(--icen-ring); }
+:root[data-icen-style="chinese"] .icen-panel-title {
+  padding-block: var(--icen-density-space-md);
+  color: var(--icen-token-text);
+  letter-spacing: .06em;
+  text-transform: none;
+}
+:root[data-icen-style="chinese"] :is(.icen-card-desc,.icen-modal-desc,.icen-panel-subtitle) { line-height: var(--icen-line-height-body); }
+:root[data-icen-style="chinese"] .icen-segmented {
+  background: var(--icen-token-bg-soft);
+  border-color: var(--icen-token-line-soft);
+}
+:root[data-icen-style="chinese"] :is(.icen-segmented-item.is-active,.icen-segmented-item[aria-checked="true"],.icen-toggle-group-btn.is-active) {
+  box-shadow: inset 0 0 0 1px var(--icen-token-line), var(--icen-token-shadow-card);
+}
+/* A quiet ink rule makes navigation legible without changing its layout. */
+:root[data-icen-style="chinese"] .icen-tabs:not(.icen-tabs--cards):not(.icen-tabs--segment):not(.icen-tabs--vertical) .icen-page-tab { border-block-end-width: 1px; }
+:root[data-icen-style="chinese"] :is(.icen-btn,.icen-menu-item,.icen-select-option,.icen-segmented-item):focus-visible {
+  outline: 2px solid var(--icen-token-accent);
+  outline-offset: 3px;
+}
+@media (prefers-reduced-motion: reduce) {
+  :root[data-icen-style="chinese"] { --icen-press: none; --icen-press-soft: none; }
+}
+@media (forced-colors: active) {
+  :root[data-icen-style="chinese"] :is([data-icen-material],.icen-card,.icen-panel,.icen-menu,.icen-popover,.icen-select-panel,.icen-date-picker-panel,.icen-autocomplete-panel,.icen-cascader-panel,.icen-tree-select-panel,.icen-mentions-panel,.icen-ai-composer-popup,.icen-command-palette,.icen-modal,.icen-nav) {
+    background: Canvas;
+    color: CanvasText;
+    border-color: CanvasText;
+    box-shadow: none;
+  }
+  :root[data-icen-style="chinese"] :focus-visible { outline: 2px solid Highlight; outline-offset: 3px; }
+  :root[data-icen-style="chinese"] :is(.icen-card.is-selected,.icen-card--interactive:focus-within) { box-shadow: none; outline: 2px solid Highlight; outline-offset: 2px; }
+}
+
+}

package/dist/components/material-soviet.css

@@ -0,0 +1,76 @@
+@layer icen.components {
+/* 苏式 material adapter. DOM contract: html[data-icen-style="soviet"] with
+ * existing ICEN components or [data-icen-material="content|chrome|floating"].
+ * Structural emphasis belongs to frame/header/action, not long-form text.
+ */
+:root[data-icen-style="soviet"] {
+  --icen-press: translateY(1px);
+  --icen-press-soft: translateY(1px);
+  --icen-hover-border: var(--icen-token-line-strong);
+  --icen-hover-border-strong: var(--icen-token-text);
+  --icen-ring: 0 0 0 2px var(--icen-token-surface), 0 0 0 4px var(--icen-token-accent);
+  --icen-ring-soft: 0 0 0 2px var(--icen-token-accent-subtle);
+  --icen-control-focus-shadow: inset 0 -2px 0 var(--icen-token-accent);
+  --icen-control-focus-border: var(--icen-token-accent);
+}
+:root[data-icen-style="soviet"] :is([data-icen-material],.icen-menu,.icen-popover,.icen-select-panel,.icen-date-picker-panel,.icen-autocomplete-panel,.icen-cascader-panel,.icen-tree-select-panel,.icen-mentions-panel,.icen-ai-composer-popup,.icen-command-palette,.icen-card--glass,.icen-nav) {
+  background: var(--icen-token-surface);
+  border-color: var(--icen-token-line-strong);
+  backdrop-filter: none;
+  -webkit-backdrop-filter: none;
+}
+:root[data-icen-style="soviet"] :is(h1,h2,h3,h4,h5,h6,.icen-card-title,.icen-modal-title) {
+  font-family: var(--icen-font-heading);
+  font-weight: 750;
+  letter-spacing: var(--icen-letter-spacing-heading);
+  line-height: var(--icen-line-height-heading);
+}
+/* Only display text is condensed; labels, forms and paragraphs stay comfortable. */
+:root[data-icen-style="soviet"] :is(h1,h2) { font-stretch: condensed; }
+:root[data-icen-style="soviet"] :is(.icen-btn,.icen-page-tab,.icen-panel-title,.icen-table th) {
+  font-family: var(--icen-font-body);
+  font-weight: 650;
+  letter-spacing: .035em;
+}
+:root[data-icen-style="soviet"] :is(.icen-btn,.icen-input-wrap,.icen-textarea-wrap,.icen-select-trigger,.icen-segmented) { border-width: 2px; }
+:root[data-icen-style="soviet"] :is(.icen-btn-ghost,.icen-btn-link) { border-color: transparent; }
+:root[data-icen-style="soviet"] :is(.icen-card,.icen-panel,[data-icen-material="content"]) {
+  border-color: var(--icen-token-line);
+  border-block-start: 3px solid var(--icen-token-line-strong);
+  box-shadow: none;
+}
+:root[data-icen-style="soviet"] .icen-card--elevated { box-shadow: var(--icen-token-shadow-card); }
+:root[data-icen-style="soviet"] :is(.icen-card.is-selected,.icen-card--interactive:focus-within) { box-shadow: var(--icen-ring); }
+:root[data-icen-style="soviet"] .icen-panel-title {
+  color: var(--icen-token-text);
+  padding-block: var(--icen-density-space-md);
+  border-block-end: 2px solid var(--icen-token-line);
+}
+:root[data-icen-style="soviet"] .icen-panel.is-collapsed .icen-panel-title { border-block-end-color: transparent; }
+:root[data-icen-style="soviet"] .icen-modal { border: 2px solid var(--icen-token-line-strong); }
+:root[data-icen-style="soviet"] :is(.icen-switch,.icen-switch-thumb) { border-radius: var(--icen-radius-sm); }
+:root[data-icen-style="soviet"] :is(.icen-segmented-item.is-active,.icen-segmented-item[aria-checked="true"],.icen-toggle-group-btn.is-active) {
+  background: var(--icen-token-surface);
+  box-shadow: inset 0 -3px 0 var(--icen-token-accent), inset 0 0 0 1px var(--icen-token-line);
+}
+:root[data-icen-style="soviet"] .icen-tabs:not(.icen-tabs--cards):not(.icen-tabs--segment):not(.icen-tabs--vertical) .icen-page-tab { border-block-end-width: 3px; }
+:root[data-icen-style="soviet"] :is(.icen-btn,.icen-menu-item,.icen-select-option,.icen-segmented-item):focus-visible {
+  outline: 2px solid var(--icen-token-accent);
+  outline-offset: 3px;
+}
+@media (prefers-reduced-motion: reduce) {
+  :root[data-icen-style="soviet"] { --icen-press: none; --icen-press-soft: none; }
+}
+@media (forced-colors: active) {
+  :root[data-icen-style="soviet"] :is([data-icen-material],.icen-card,.icen-panel,.icen-menu,.icen-popover,.icen-select-panel,.icen-date-picker-panel,.icen-autocomplete-panel,.icen-cascader-panel,.icen-tree-select-panel,.icen-mentions-panel,.icen-ai-composer-popup,.icen-command-palette,.icen-modal,.icen-nav) {
+    background: Canvas;
+    color: CanvasText;
+    border-color: CanvasText;
+    box-shadow: none;
+  }
+  :root[data-icen-style="soviet"] :is(.icen-segmented-item[aria-checked="true"],.icen-segmented-item.is-active,.icen-toggle-group-btn.is-active) { outline: 2px solid Highlight; outline-offset: -2px; }
+  :root[data-icen-style="soviet"] :focus-visible { outline: 2px solid Highlight; outline-offset: 3px; }
+  :root[data-icen-style="soviet"] :is(.icen-card.is-selected,.icen-card--interactive:focus-within) { box-shadow: none; outline: 2px solid Highlight; outline-offset: 2px; }
+}
+
+}