@icen.ai/ui 0.4.0 → 0.5.0

package/dist/components/content.css

@@ -375,3 +375,217 @@
     transition: none;
   }
 }
+
+/* ── list 增强 ── */
+
+/* 列表项带前置图标/头像 */
+.list-item-leading {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  flex-shrink: 0;
+  margin-right: var(--density-space-sm);
+}
+.list-item-leading svg { width: 16px; height: 16px; color: var(--token-text-faint); }
+.list-item-content {
+  flex: 1;
+  min-width: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 1px;
+}
+.list-item-title {
+  font-size: var(--density-font-size-md);
+  color: var(--token-text);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.list-item-meta {
+  font-size: var(--density-font-size-xs);
+  color: var(--token-text-faint);
+}
+.list-item-trailing {
+  flex-shrink: 0;
+  margin-left: var(--density-space-sm);
+  font-size: var(--density-font-size-xs);
+  color: var(--token-text-faint);
+}
+.list-item--selectable {
+  cursor: pointer;
+}
+.list-item.is-selected {
+  background: var(--token-accent-subtle);
+}
+.list-item.is-selected .list-item-title { color: var(--token-accent); font-weight: 500; }
+
+/* 列表项 flex 布局（leading + content + trailing） */
+.list-item--flex {
+  display: flex;
+  align-items: center;
+}
+
+/* 斑马列表 */
+.list--striped .list-item:nth-child(odd) {
+  background: color-mix(in srgb, var(--token-bg-soft) 40%, transparent);
+}
+
+/* ── timeline 增强 ── */
+
+/* 右侧时间线（dot 在右） */
+.timeline--right .timeline-item { flex-direction: row-reverse; }
+.timeline--right .timeline-item:not(:last-child)::after {
+  left: auto;
+  right: 13.5px;
+}
+.timeline--right .timeline-body { text-align: right; }
+.timeline--right .timeline-time { margin-left: 0; margin-right: auto; }
+
+/* 交替时间线（奇左偶右） */
+.timeline--alternate .timeline-item:nth-child(even) { flex-direction: row-reverse; }
+.timeline--alternate .timeline-item:nth-child(even):not(:last-child)::after {
+  left: auto; right: 13.5px;
+}
+.timeline--alternate .timeline-item:nth-child(even) .timeline-body { text-align: right; }
+.timeline--alternate .timeline-item:nth-child(even) .timeline-time {
+  margin-left: 0; margin-right: auto;
+}
+
+/* 自定义 dot 尺寸 */
+.timeline-dot--sm { width: 20px; height: 20px; }
+.timeline-dot--sm svg { width: 10px; height: 10px; }
+.timeline-dot--sm ~ .timeline-item:not(:last-child)::after,
+.timeline--sm .timeline-item:not(:last-child)::after { left: 10px; top: 24px; }
+
+/* 时间线自定义内容槽（放标签、卡片等） */
+.timeline-extra {
+  margin-top: var(--density-space-xs);
+  padding: var(--density-space-sm);
+  background: var(--token-bg-soft);
+  border-radius: var(--radius-sm);
+  font-size: var(--density-font-size-sm);
+}
+
+/* ── desc 增强 ── */
+
+/* 行内描述（label: value 在同一行） */
+.desc--inline .desc-item {
+  display: flex;
+  align-items: baseline;
+  gap: var(--density-space-sm);
+  padding: 4px 0;
+}
+.desc--inline .desc-item dt {
+  flex-shrink: 0;
+  min-width: 80px;
+}
+.desc--inline .desc-item dd {
+  flex: 1;
+}
+
+/* 垂直描述（label 在上，value 在下） */
+.desc--vertical .desc-item {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+}
+
+/* 可复制描述值 */
+.desc-copy {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--density-space-xs);
+}
+.desc-copy-btn {
+  display: inline-flex;
+  align-items: center;
+  padding: 2px;
+  border: 0;
+  border-radius: var(--radius-xs);
+  background: transparent;
+  color: var(--token-text-faint);
+  cursor: pointer;
+  transition: color var(--icen-tx-fast), background-color var(--icen-tx-fast);
+}
+.desc-copy-btn:hover { color: var(--token-accent); background: var(--token-fill-1); }
+.desc-copy-btn svg { width: 12px; height: 12px; }
+
+/* ── tree 增强 ── */
+
+/* 带连接线的树 */
+.tree--lined ul {
+  position: relative;
+  margin-left: 7px;
+  padding-left: 0;
+  border-left: 1px solid var(--token-outline-soft);
+}
+.tree--lined .tree-node {
+  position: relative;
+}
+.tree--lined ul > li > .tree-node::before {
+  content: '';
+  position: absolute;
+  left: -8px;
+  top: 50%;
+  width: 8px;
+  height: 1px;
+  background: var(--token-outline-soft);
+}
+
+/* 树节点复选框（checkbox tree） */
+.tree-checkbox {
+  width: 14px;
+  height: 14px;
+  flex-shrink: 0;
+  margin-right: 2px;
+}
+
+/* 树拖拽视觉态 */
+.tree-node.is-dragging {
+  opacity: 0.5;
+}
+.tree-node.is-drop-target {
+  box-shadow: inset 0 -2px var(--token-accent);
+}
+
+/* 树搜索高亮 */
+.tree-label mark {
+  background: color-mix(in srgb, var(--token-warning) 30%, transparent);
+  color: inherit;
+  border-radius: 2px;
+  padding: 0 1px;
+}
+
+/* ── kbd 增强 ── */
+
+/* 大号 kbd（展示用） */
+.kbd--lg {
+  height: 28px;
+  min-width: 28px;
+  padding: 0 var(--density-space-sm);
+  font-size: var(--density-font-size-md);
+}
+
+/* kbd 按下态（动画反馈） */
+.kbd.is-pressed {
+  transform: translateY(1px);
+  box-shadow: none;
+}
+
+/* ── code-inline 增强 ── */
+.code-inline--success { color: var(--token-success); }
+.code-inline--warning { color: var(--token-warning); }
+.code-inline--error   { color: var(--token-error); }
+
+/* 代码块（多行，非行内） */
+.code-block {
+  padding: var(--density-space-sm) var(--density-space-md);
+  background: var(--token-bg-soft);
+  border: 1px solid var(--token-outline-soft);
+  border-radius: var(--radius-md);
+  font-family: var(--font-mono);
+  font-size: var(--density-font-size-sm);
+  color: var(--token-text);
+  overflow-x: auto;
+  line-height: 1.6;
+}

package/dist/components/copy.css

@@ -0,0 +1,93 @@
+/*
+ * @icen.ai/ui — Component: copy（复制按钮，与 behaviors/copy 配套）
+ *
+ * 完整契约：
+ *   文本变体（成功后文本 1.4s 内变「已复制」再还原）：
+ *   <button class="copy-btn" data-copy="复制的文本">复制</button>
+ *   <button class="copy-btn copy-btn--ghost" data-copy="…">复制链接</button>
+ *
+ *   图标变体（带 data-copy-icon，仅加 .done 类；由 CSS 显隐子 svg）：
+ *   <button class="copy-btn copy-btn--icon" data-copy="…" data-copy-icon aria-label="复制">
+ *     <svg class="copy-icon-clipboard">…</svg>
+ *     <svg class="copy-icon-check" hidden>…</svg>
+ *   </button>
+ *
+ * behavior 自动处理：
+ *   - 文本变体：成功后 textContent = '已复制' + 加 .done 类，1.4s 后还原
+ *   - 图标变体（带 data-copy-icon）：仅加 .done 类（不改文本），由 CSS 切换 svg 显隐
+ *
+ * 与 toast.ok 区别：copy 是"原地反馈"（按钮自身闪烁），toast 是"全局通知"。
+ */
+
+.copy-btn {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: var(--density-space-xs);
+  height: var(--density-input-height-sm);
+  padding: 0 var(--density-space-sm);
+  background: var(--token-control);
+  color: var(--token-text-muted);
+  border: 1px solid var(--token-outline-soft);
+  border-radius: var(--radius-sm);
+  font: inherit;
+  font-size: var(--density-font-size-sm);
+  cursor: pointer;
+  -webkit-tap-highlight-color: transparent;
+  transition:
+    color var(--icen-tx-fast),
+    border-color var(--icen-tx-fast),
+    background-color var(--icen-tx-fast);
+}
+.copy-btn:hover {
+  color: var(--token-text);
+  border-color: var(--icen-hover-border);
+}
+.copy-btn:focus-visible {
+  outline: none;
+  box-shadow: var(--icen-ring);
+}
+.copy-btn:disabled,
+.copy-btn[aria-disabled='true'] {
+  opacity: var(--icen-disabled-opacity);
+  cursor: not-allowed;
+  pointer-events: none;
+}
+
+/* ghost 变体：透明底，纯描边 / hover 才显底 */
+.copy-btn--ghost {
+  background: transparent;
+  border-color: var(--token-line-soft);
+}
+.copy-btn--ghost:hover {
+  background: var(--token-fill-1);
+  border-color: var(--token-accent);
+}
+
+/* ── 成功闪烁态（behavior 1.4s 后移除）── */
+.copy-btn.done {
+  color: var(--token-success);
+  border-color: color-mix(in srgb, var(--token-success) 40%, transparent);
+  background: color-mix(in srgb, var(--token-success) 10%, transparent);
+}
+
+/* ── 图标变体：方形按钮，仅放 svg ── */
+.copy-btn--icon {
+  width: 28px;
+  height: 28px;
+  padding: 0;
+}
+.copy-btn--icon svg {
+  width: 14px;
+  height: 14px;
+  flex-shrink: 0;
+}
+
+/* .done 时显隐切换：剪贴板 → 对勾 */
+.copy-btn[data-copy-icon] .copy-icon-check { display: none; }
+.copy-btn[data-copy-icon].done .copy-icon-clipboard { display: none; }
+.copy-btn[data-copy-icon].done .copy-icon-check { display: inline-block; }
+
+@media (prefers-reduced-motion: reduce) {
+  .copy-btn { transition: none; }
+}

package/dist/components/copy.mjs

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

package/dist/components/date-picker.css

@@ -0,0 +1,244 @@
+/*
+ * @icen.ai/ui — Component: date-picker（日期选择，与 behaviors/date-picker 配套）
+ *
+ * 契约：
+ *   <div class="date-picker" data-date-picker data-date-picker-input="id">
+ *     <button class="date-picker-trigger" type="button" aria-haspopup="dialog">
+ *       <span class="date-picker-value">2026-07-29</span>
+ *       <svg class="date-picker-icon">…日历 svg…</svg>
+ *     </button>
+ *     <input type="hidden" id="id" name="date" value="2026-07-29" />
+ *   </div>
+ *
+ *   或直接挂到普通 input（behavior 自动包裹触发器外观）：
+ *   <input class="date-picker-input" data-date-picker value="2026-07-29" />
+ *
+ * behavior 渲染面板（portal 到 body）：
+ *   <div class="date-picker-panel" role="dialog">
+ *     <div class="date-picker-head">
+ *       <button class="date-picker-nav" data-prev>‹</button>
+ *       <span class="date-picker-title">2026 年 7 月</span>
+ *       <button class="date-picker-nav" data-next>›</button>
+ *     </div>
+ *     <div class="date-picker-weekdays">
+ *       <span>一</span><span>二</span><span>三</span><span>四</span><span>五</span><span>六</span><span>日</span>
+ *     </div>
+ *     <div class="date-picker-grid">
+ *       <button class="date-picker-cell [.is-outside] [.is-today] [.is-selected] [.is-disabled]">15</button>
+ *       …
+ *     </div>
+ *     <div class="date-picker-foot">
+ *       <button class="date-picker-today">今天</button>
+ *       <button class="date-picker-clear">清除</button>
+ *     </div>
+ *   </div>
+ *
+ * 可选 data-*：
+ *   data-date-picker-format="yyyy-mm-dd"  显示格式
+ *   data-date-picker-min="2026-01-01"     最小可选日期
+ *   data-date-picker-max="2026-12-31"     最大可选日期
+ *   data-date-picker-week-start="0"       周首日（0=周日，1=周一，默认 1）
+ */
+
+.date-picker {
+  display: inline-block;
+  position: relative;
+}
+
+.date-picker-trigger {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--density-space-xs);
+  width: 100%;
+  height: var(--density-input-height-md);
+  padding: 0 var(--density-space-sm);
+  background: var(--token-control);
+  border: 1px solid var(--token-outline-soft);
+  border-radius: var(--radius-md);
+  box-shadow: var(--token-shadow-inset);
+  color: var(--token-text);
+  font: inherit;
+  font-size: var(--density-font-size-md);
+  cursor: pointer;
+  -webkit-tap-highlight-color: transparent;
+  transition: border-color var(--icen-tx-fast), box-shadow var(--icen-tx-fast);
+}
+.date-picker-trigger:hover { border-color: var(--icen-hover-border); }
+.date-picker-trigger.is-open {
+  border-color: var(--icen-control-focus-border);
+  box-shadow: var(--icen-control-focus-shadow);
+}
+.date-picker-trigger:focus-visible {
+  outline: none;
+  border-color: var(--icen-control-focus-border);
+  box-shadow: var(--icen-control-focus-shadow);
+}
+.date-picker-value {
+  flex: 1;
+  min-width: 0;
+  text-align: left;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  font-variant-numeric: tabular-nums;
+}
+.date-picker-value.is-empty { color: color-mix(in srgb, var(--token-text-faint) 60%, transparent); }
+.date-picker-icon { display: inline-flex; color: var(--token-text-faint); flex-shrink: 0; }
+.date-picker-icon svg { width: 14px; height: 14px; }
+
+/* 尺寸 */
+.date-picker-trigger.date-picker-trigger--sm { height: var(--density-input-height-sm); font-size: var(--density-font-size-sm); }
+.date-picker-trigger.date-picker-trigger--lg { height: var(--density-input-height-lg); font-size: var(--density-font-size-lg); }
+
+/* ── 面板 ── */
+.date-picker-panel {
+  position: fixed;
+  z-index: var(--z-popover);
+  width: 280px;
+  padding: var(--density-space-sm);
+  background: var(--token-card-strong);
+  border: 1px solid var(--token-outline);
+  border-radius: var(--radius-md);
+  box-shadow: var(--token-shadow-overlay);
+  font-size: var(--density-font-size-sm);
+  animation: icen-dp-in var(--icen-tx-fast);
+}
+@keyframes icen-dp-in {
+  from { opacity: 0; transform: scale(0.96) translateY(-4px); }
+  to { opacity: 1; transform: scale(1) translateY(0); }
+}
+
+.date-picker-head {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  margin-bottom: var(--density-space-sm);
+}
+.date-picker-title {
+  font-weight: 600;
+  color: var(--token-text);
+  font-variant-numeric: tabular-nums;
+  flex: 1;
+  text-align: center;
+}
+.date-picker-nav {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 24px;
+  height: 24px;
+  padding: 0;
+  border: 0;
+  border-radius: var(--radius-xs);
+  background: transparent;
+  color: var(--token-text-muted);
+  font-size: var(--density-font-size-md);
+  cursor: pointer;
+  -webkit-tap-highlight-color: transparent;
+  transition: color var(--icen-tx-fast), background-color var(--icen-tx-fast);
+}
+.date-picker-nav:hover { color: var(--token-text); background: var(--token-fill-1); }
+.date-picker-nav:focus-visible {
+  outline: none;
+  box-shadow: var(--icen-ring);
+}
+
+.date-picker-weekdays {
+  display: grid;
+  grid-template-columns: repeat(7, 1fr);
+  gap: 2px;
+  margin-bottom: 4px;
+}
+.date-picker-weekdays > span {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  height: 24px;
+  font-size: var(--density-font-size-xs);
+  color: var(--token-text-faint);
+  font-weight: 500;
+}
+
+.date-picker-grid {
+  display: grid;
+  grid-template-columns: repeat(7, 1fr);
+  gap: 2px;
+}
+.date-picker-cell {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  height: 30px;
+  padding: 0;
+  border: 0;
+  border-radius: var(--radius-sm);
+  background: transparent;
+  color: var(--token-text);
+  font: inherit;
+  font-size: var(--density-font-size-sm);
+  font-variant-numeric: tabular-nums;
+  cursor: pointer;
+  -webkit-tap-highlight-color: transparent;
+  transition: background-color var(--icen-tx-fast), color var(--icen-tx-fast);
+}
+.date-picker-cell:hover { background: var(--token-fill-1); }
+.date-picker-cell.is-today {
+  border: 1px solid var(--token-accent);
+  color: var(--token-accent);
+  font-weight: 600;
+}
+.date-picker-cell.is-selected {
+  background: var(--token-accent);
+  color: var(--token-on-accent, #fff);
+  font-weight: 600;
+}
+.date-picker-cell.is-selected.is-today { border-color: var(--token-on-accent, #fff); }
+.date-picker-cell.is-outside {
+  color: var(--token-text-faint);
+  opacity: 0.55;
+}
+.date-picker-cell.is-disabled {
+  color: var(--token-text-faint);
+  opacity: 0.35;
+  cursor: not-allowed;
+  pointer-events: none;
+}
+.date-picker-cell:focus-visible {
+  outline: none;
+  box-shadow: var(--icen-ring);
+}
+
+.date-picker-foot {
+  display: flex;
+  justify-content: space-between;
+  gap: var(--density-space-xs);
+  margin-top: var(--density-space-sm);
+  padding-top: var(--density-space-sm);
+  border-top: 1px solid var(--token-line-soft);
+}
+.date-picker-today,
+.date-picker-clear {
+  padding: 4px var(--density-space-sm);
+  border: 0;
+  border-radius: var(--radius-xs);
+  background: transparent;
+  color: var(--token-accent);
+  font: inherit;
+  font-size: var(--density-font-size-xs);
+  cursor: pointer;
+  -webkit-tap-highlight-color: transparent;
+  transition: background-color var(--icen-tx-fast);
+}
+.date-picker-today:hover,
+.date-picker-clear:hover { background: var(--token-fill-1); }
+.date-picker-today:focus-visible,
+.date-picker-clear:focus-visible {
+  outline: none;
+  box-shadow: var(--icen-ring);
+}
+.date-picker-clear { color: var(--token-text-muted); }
+
+@media (prefers-reduced-motion: reduce) {
+  .date-picker-panel { animation: none; }
+  .date-picker-cell { transition: none; }
+}

package/dist/components/date-picker.mjs

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

package/dist/components/empty.css

@@ -1,16 +1,25 @@
 /*
- * @icen.ai/ui — Component: empty（空状态 / 无数据 / 404 占位）
+ * @icen.ai/ui — Component: empty（空状态 / 无数据 / 404 / 错误 / 维护中）
  *
  * 完整契约：
- *   <div class="empty [.empty--sm|.empty--lg]">
+ *   <div class="empty [.empty--sm|.empty--lg]
+ *        [.empty--error|.empty--404|.empty--search|.empty--maintenance|.empty--network]">
  *     <div class="empty-icon">…svg…</div>            ← 可选，缺省显示默认占位
  *     <h3 class="empty-title">暂无数据</h3>
  *     <p class="empty-desc">描述文案（可选）</p>
  *     <div class="empty-action">                       ← 可选：操作按钮位
  *       <button class="btn btn-primary">…</button>
+ *       <button class="btn">…</button>
  *     </div>
  *   </div>
  *
+ * 类型预设（改图标底色与基调）：
+ *   .empty--error        错误（红底图标）
+ *   .empty--404          404（中性大字）
+ *   .empty--search       搜索无结果
+ *   .empty--maintenance  维护中（warning 底）
+ *   .empty--network      网络错误（info 底）
+ *
  * 规格源自 opengal src/presentation/ui/data/display.tsx 的 EmptyState。
  */
 
@@ -25,6 +34,7 @@
 .empty--sm { padding: var(--density-space-md); }
 .empty--lg { padding: 64px var(--density-space-md); }
 
+/* ── 图标 ── */
 .empty-icon {
   width: 48px;
   height: 48px;
@@ -44,6 +54,28 @@
 .empty--lg .empty-icon svg { width: 32px; height: 32px; }
 .empty--sm .empty-icon svg { width: 18px; height: 18px; }
 
+/* ── 类型预设 ── */
+.empty--error .empty-icon {
+  background: color-mix(in srgb, var(--token-error) 10%, transparent);
+  border-color: color-mix(in srgb, var(--token-error) 20%, transparent);
+  color: var(--token-error);
+}
+.empty--maintenance .empty-icon {
+  background: color-mix(in srgb, var(--token-warning) 10%, transparent);
+  border-color: color-mix(in srgb, var(--token-warning) 20%, transparent);
+  color: var(--token-warning);
+}
+.empty--network .empty-icon {
+  background: color-mix(in srgb, var(--token-info) 10%, transparent);
+  border-color: color-mix(in srgb, var(--token-info) 20%, transparent);
+  color: var(--token-info);
+}
+.empty--search .empty-icon {
+  background: var(--token-fill-1);
+  color: var(--token-text-muted);
+}
+
+/* ── 标题与描述 ── */
 .empty-title {
   font-size: var(--density-font-size-md);
   font-weight: 500;
@@ -51,15 +83,53 @@
   margin: 0;
   line-height: 1.4;
 }
+.empty--error .empty-title { color: var(--token-error); }
 .empty-desc {
   font-size: var(--density-font-size-sm);
   color: var(--token-text-muted);
   margin: 4px 0 0;
-  max-width: 240px;
+  max-width: 280px;
   line-height: 1.5;
 }
+
+/* ── 操作区 ── */
 .empty-action {
   margin-top: var(--density-space-md);
   display: flex;
   gap: var(--density-space-xs);
+  flex-wrap: wrap;
+  justify-content: center;
+}
+
+/* ── 404 大数字 ── */
+.empty--404 .empty-title {
+  font-size: 72px;
+  font-weight: 800;
+  font-family: var(--font-heading);
+  line-height: 1;
+  letter-spacing: -0.02em;
+  color: var(--token-text-faint);
+  margin-bottom: var(--density-space-sm);
+}
+.empty--404 .empty-icon { display: none; }
+
+/* ── 插画背景（使用方可用渐变背景替代图标） ── */
+.empty--illustrated {
+  background: radial-gradient(ellipse at center,
+    color-mix(in srgb, var(--token-accent) 6%, transparent) 0%,
+    transparent 70%);
+  border-radius: var(--radius-lg);
+}
+
+/* ── 内嵌模式（empty 嵌入卡片/面板内时无 padding） ── */
+.empty--inline {
+  padding: var(--density-space-md) var(--density-space-sm);
+}
+
+@media (max-width: 480px) {
+  .empty--404 .empty-title { font-size: 56px; }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .empty { animation: none; }
 }