@icen.ai/ui 0.9.0 → 0.10.0

package/dist/components/popover.css

@@ -1,70 +1,82 @@
+@layer icen.components {
 /*
  * @icen.ai/ui — Component: popover（锚定浮层，与 behaviors/popover 配套）
  *
  * 完整契约：
- *   <button class="popover-trigger pressable" data-popover-target="id" aria-haspopup="dialog">…</button>
- *   <div class="popover [--sm|--lg]" id="id" data-side="top|bottom|left|right" role="dialog" hidden>
- *     <div class="popover-header">           可选
- *       <h3 class="popover-title">…</h3>
- *       <button class="popover-close" aria-label="关闭">…</button>
+ *   <button class="popover-trigger icen-pressable" data-icen-popover-target="id" aria-haspopup="dialog">…</button>
+ *   <div class="icen-popover [--sm|--lg]" id="id" data-icen-side="top|bottom|left|right" role="dialog" hidden>
+ *     <div class="icen-popover-header">           可选
+ *       <h3 class="icen-popover-title">…</h3>
+ *       <button class="icen-popover-close" aria-label="关闭">…</button>
  *     </div>
- *     <div class="popover-body">…</div>
- *     <div class="popover-footer">           可选
- *       <button class="btn">取消</button>
+ *     <div class="icen-popover-body">…</div>
+ *     <div class="icen-popover-footer">           可选
+ *       <button class="icen-btn">取消</button>
  *     </div>
  *   </div>
  *
- * behavior：面板 portal 到 document.body 按 fixed 定位；data-side 由布局函数写入；
- *           ESC / 外部点击关闭；焦点 trap 可选。
+ * behavior：面板 portal 到 document.body 按 fixed 定位；data-icen-side 由布局函数写入；
+ *           ESC / 外部点击关闭；initPopover() 提供 data-icen-popover-target 声明式委托；
+ *           退场为淡出过渡（[data-icen-state='closing']），重开从当前位置续接。
  */
 
-.popover {
+.icen-popover {
   position: fixed;
-  z-index: var(--z-popover);
-  min-width: 200px;
-  max-width: min(360px, calc(100vw - 32px));
-  padding: var(--density-space-sm);
-  background: var(--token-card-strong);
-  color: var(--token-text);
-  border: 1px solid var(--token-outline);
-  box-shadow: var(--token-shadow-overlay);
-  border-radius: var(--radius-lg);
+  z-index: var(--icen-z-popover);
+  min-inline-size: 200px;
+  max-inline-size: min(360px, calc(100vw - 32px));
+  padding: var(--icen-density-space-sm);
+  background: var(--icen-token-card-strong);
+  color: var(--icen-token-text);
+  border: 1px solid var(--icen-token-outline);
+  box-shadow: var(--icen-token-shadow-overlay);
+  border-radius: var(--icen-radius-lg);
   animation: icen-popover-in var(--icen-tx-fast);
   transform-origin: top center;
+  /* 退场走过渡（可中断回弹）；与菜单同收敛配方 */
+  transition:
+    opacity var(--icen-tx-fast) var(--icen-ease-out),
+    transform var(--icen-tx-fast) var(--icen-ease-out);
+}
+.icen-popover[data-icen-state='closing'] {
+  animation: none; /* 打断可能仍在跑的进场 */
+  pointer-events: none;
+  opacity: 0;
+  transform: scale(0.99);
 }
-.popover[data-side='top'] {
+.icen-popover[data-icen-side='top'] {
   animation-name: icen-popover-in-top;
   transform-origin: bottom center;
 }
-.popover[data-side='left'] {
+.icen-popover[data-icen-side='left'] {
   animation-name: icen-popover-in-left;
   transform-origin: right center;
 }
-.popover[data-side='right'] {
+.icen-popover[data-icen-side='right'] {
   animation-name: icen-popover-in-right;
   transform-origin: left center;
 }
 
-.popover--sm { min-width: 160px; max-width: 240px; }
-.popover--lg { min-width: 280px; max-width: min(480px, calc(100vw - 32px)); }
+.icen-popover--sm { min-inline-size: 160px; max-inline-size: 240px; }
+.icen-popover--lg { min-inline-size: 280px; max-inline-size: min(480px, calc(100vw - 32px)); }
 
-.popover-header {
+.icen-popover-header {
   display: flex;
   align-items: flex-start;
   justify-content: space-between;
-  gap: var(--density-space-sm);
-  padding: var(--density-space-xs) var(--density-space-xs) var(--density-space-sm);
-  border-bottom: 1px solid var(--token-line-soft);
-  margin-bottom: var(--density-space-sm);
+  gap: var(--icen-density-space-sm);
+  padding: var(--icen-density-space-xs) var(--icen-density-space-xs) var(--icen-density-space-sm);
+  border-bottom: 1px solid var(--icen-token-line-soft);
+  margin-bottom: var(--icen-density-space-sm);
 }
-.popover-title {
+.icen-popover-title {
   margin: 0;
-  font-size: var(--density-font-size-sm);
+  font-size: var(--icen-density-font-size-sm);
   font-weight: 600;
-  font-family: var(--font-heading);
+  font-family: var(--icen-font-heading);
   line-height: 1.3;
 }
-.popover-close {
+.icen-popover-close {
   display: inline-flex;
   align-items: center;
   justify-content: center;
@@ -74,54 +86,56 @@
   border: none;
   background: transparent;
   cursor: pointer;
-  color: var(--token-text-faint);
-  border-radius: var(--radius-sm);
+  color: var(--icen-token-text-faint);
+  border-radius: var(--icen-radius-sm);
   flex-shrink: 0;
   transition:
     background-color var(--icen-tx-fast),
     color var(--icen-tx-fast);
 }
-.popover-close:hover {
-  background: var(--token-surface-hover);
-  color: var(--token-text);
+.icen-popover-close:hover {
+  background: var(--icen-token-surface-hover);
+  color: var(--icen-token-text);
 }
-.popover-close:focus-visible {
+.icen-popover-close:focus-visible {
   outline: none;
   box-shadow: var(--icen-ring);
 }
 
-.popover-body {
-  font-size: var(--density-font-size-sm);
+.icen-popover-body {
+  font-size: var(--icen-density-font-size-sm);
   line-height: 1.5;
 }
 
-.popover-footer {
+.icen-popover-footer {
   display: flex;
   justify-content: flex-end;
-  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);
+  gap: var(--icen-density-space-xs);
+  margin-top: var(--icen-density-space-sm);
+  padding-top: var(--icen-density-space-sm);
+  border-top: 1px solid var(--icen-token-line-soft);
 }
 
-/* ── 进场动画（按侧别反向位移 8px） ── */
+/* ── 进场动画（与菜单同配方：fade + scale(.985)，按侧别反向位移 3px） ── */
 @keyframes icen-popover-in {
-  from { opacity: 0; transform: scale(0.95) translateY(-8px); }
+  from { opacity: 0; transform: scale(0.985) translateY(-3px); }
   to { opacity: 1; transform: scale(1) translateY(0); }
 }
 @keyframes icen-popover-in-top {
-  from { opacity: 0; transform: scale(0.95) translateY(8px); }
+  from { opacity: 0; transform: scale(0.985) translateY(3px); }
   to { opacity: 1; transform: scale(1) translateY(0); }
 }
 @keyframes icen-popover-in-left {
-  from { opacity: 0; transform: scale(0.95) translateX(8px); }
+  from { opacity: 0; transform: scale(0.985) translateX(3px); }
   to { opacity: 1; transform: scale(1) translateX(0); }
 }
 @keyframes icen-popover-in-right {
-  from { opacity: 0; transform: scale(0.95) translateX(-8px); }
+  from { opacity: 0; transform: scale(0.985) translateX(-3px); }
   to { opacity: 1; transform: scale(1) translateX(0); }
 }
 
 @media (prefers-reduced-motion: reduce) {
-  .popover { animation: none; }
+  .icen-popover { animation: none; transition: none; }
+}
+
 }

package/dist/components/scroll-area.css

@@ -1,112 +1,115 @@
-/*
- * @icen.ai/ui — Component: scroll-area（自定义滚动容器）
- *
- * 全局 base.css 已经提供细薄滚动条（所有元素默认生效）。
- * 本组件提供"显式带视觉边界的滚动区"——常用于：
- *   - 侧边栏长列表
- *   - 下拉面板内的滚动区
- *   - 需要限定高度并强调"这里可以滚"的容器
- *
- * 完整契约：
- *   <div class="scroll-area [--sm|--lg] [--both]">
- *     任意超长内容…
- *   </div>
- *
- *   横向专用：<div class="scroll-area scroll-area--x">…</div>
- *   垂直专用：<div class="scroll-area scroll-area--y">…</div>
- *
- * 变体：
- *   --x  仅横向滚动（纵向裁剪）
- *   --y  仅纵向滚动（横向裁剪）
- *   --both 双向滚动
- *   --sm  窄滚动条（6px 宽）
- *   --lg  正常滚动条（10px 宽，默认 8px）
- *   --inset  内嵌阴影式（类似 code 编辑器）
- */
+@layer icen.components {
+/*
+ * @icen.ai/ui — Component: scroll-area（自定义滚动容器）
+ *
+ * 全局 base.css 已经提供细薄滚动条（所有元素默认生效）。
+ * 本组件提供"显式带视觉边界的滚动区"——常用于：
+ *   - 侧边栏长列表
+ *   - 下拉面板内的滚动区
+ *   - 需要限定高度并强调"这里可以滚"的容器
+ *
+ * 完整契约：
+ *   <div class="icen-scroll-area [--sm|--lg] [--both]">
+ *     任意超长内容…
+ *   </div>
+ *
+ *   横向专用：<div class="icen-scroll-area icen-scroll-area--x">…</div>
+ *   垂直专用：<div class="icen-scroll-area icen-scroll-area--y">…</div>
+ *
+ * 变体：
+ *   --x  仅横向滚动（纵向裁剪）
+ *   --y  仅纵向滚动（横向裁剪）
+ *   --both 双向滚动
+ *   --sm  窄滚动条（6px 宽）
+ *   --lg  正常滚动条（10px 宽，默认 8px）
+ *   --inset  内嵌阴影式（类似 code 编辑器）
+ */
+
+.icen-scroll-area {
+  overflow: auto;
+  overscroll-behavior: contain;
+  -webkit-overflow-scrolling: touch;
+  scroll-behavior: smooth;
+}
+
+.icen-scroll-area--x { overflow-x: auto; overflow-y: hidden; }
+.icen-scroll-area--y { overflow-x: hidden; overflow-y: auto; }
+.icen-scroll-area--both { overflow: auto; }
+
+/* ── 尺寸变体：覆盖全局滚动条宽度 ── */
+.icen-scroll-area--sm {
+  scrollbar-width: thin;
+}
+.icen-scroll-area--sm::-webkit-scrollbar {
+  width: 6px;
+  height: 6px;
+}
+.icen-scroll-area--sm::-webkit-scrollbar-thumb {
+  background: color-mix(in srgb, var(--icen-token-text-faint) 28%, transparent);
+  border-radius: 3px;
 /* guard:allow-radius 微构件（bar/dot/track/指示器等图形级，不属容器圆角面） */
+  border: 0;
+}
+
+.icen-scroll-area--lg {
+  scrollbar-width: auto;
+}
+.icen-scroll-area--lg::-webkit-scrollbar {
+  width: 12px;
+  height: 12px;
+}
+.icen-scroll-area--lg::-webkit-scrollbar-thumb {
+  background: color-mix(in srgb, var(--icen-token-text-faint) 35%, transparent);
+  border-radius: var(--icen-radius-xs);
+  border: 2px solid transparent;
+  background-clip: padding-box;
+}
+.icen-scroll-area--lg::-webkit-scrollbar-thumb:hover {
+  background: color-mix(in srgb, var(--icen-token-text-faint) 50%, transparent);
+  background-clip: padding-box;
+}
+
+/* ── 内嵌变体：带视觉边界 ── */
+.icen-scroll-area--inset {
+  background: var(--icen-token-bg-soft);
+  border: 1px solid var(--icen-token-line-soft);
+  border-radius: var(--icen-radius-md);
+  box-shadow: var(--icen-token-shadow-inset);
+  padding: var(--icen-density-space-sm);
+}
+.icen-scroll-area--inset:focus-visible {
+  outline: none;
+  border-color: var(--icen-control-focus-border);
+  box-shadow: var(--icen-control-focus-shadow);
+}
+
+/* ── 渐隐遮罩（可选）：上下边缘渐隐，暗示可滚动 ── */
+.icen-scroll-area--fade {
+  -webkit-mask-image: linear-gradient(
+    to bottom,
+    transparent 0,
+    transparent 0,
+    #000 var(--icen-density-space-sm),
+    #000 calc(100% - var(--icen-density-space-sm)),
+    transparent 100%
+  );
+  mask-image: linear-gradient(
+    to bottom,
+    transparent 0,
+    #000 var(--icen-density-space-sm),
+    #000 calc(100% - var(--icen-density-space-sm)),
+    transparent 100%
+  );
+}
+
+/* ── 可被键盘聚焦的滚动容器 ── */
+.icen-scroll-area[tabindex='0']:focus-visible {
+  outline: none;
+  box-shadow: var(--icen-ring-soft);
+  border-radius: var(--icen-radius-md);
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .icen-scroll-area { scroll-behavior: auto; }
+}
 
-.scroll-area {
-  overflow: auto;
-  overscroll-behavior: contain;
-  -webkit-overflow-scrolling: touch;
-  scroll-behavior: smooth;
-}
-
-.scroll-area--x { overflow-x: auto; overflow-y: hidden; }
-.scroll-area--y { overflow-x: hidden; overflow-y: auto; }
-.scroll-area--both { overflow: auto; }
-
-/* ── 尺寸变体：覆盖全局滚动条宽度 ── */
-.scroll-area--sm {
-  scrollbar-width: thin;
-}
-.scroll-area--sm::-webkit-scrollbar {
-  width: 6px;
-  height: 6px;
-}
-.scroll-area--sm::-webkit-scrollbar-thumb {
-  background: color-mix(in srgb, var(--token-text-faint) 28%, transparent);
-  border-radius: 3px;
-  border: 0;
-}
-
-.scroll-area--lg {
-  scrollbar-width: auto;
-}
-.scroll-area--lg::-webkit-scrollbar {
-  width: 12px;
-  height: 12px;
-}
-.scroll-area--lg::-webkit-scrollbar-thumb {
-  background: color-mix(in srgb, var(--token-text-faint) 35%, transparent);
-  border-radius: 6px;
-  border: 2px solid transparent;
-  background-clip: padding-box;
-}
-.scroll-area--lg::-webkit-scrollbar-thumb:hover {
-  background: color-mix(in srgb, var(--token-text-faint) 50%, transparent);
-  background-clip: padding-box;
-}
-
-/* ── 内嵌变体：带视觉边界 ── */
-.scroll-area--inset {
-  background: var(--token-bg-soft);
-  border: 1px solid var(--token-line-soft);
-  border-radius: var(--radius-md);
-  box-shadow: var(--token-shadow-inset);
-  padding: var(--density-space-sm);
-}
-.scroll-area--inset:focus-visible {
-  outline: none;
-  border-color: var(--icen-control-focus-border);
-  box-shadow: var(--icen-control-focus-shadow);
-}
-
-/* ── 渐隐遮罩（可选）：上下边缘渐隐，暗示可滚动 ── */
-.scroll-area--fade {
-  -webkit-mask-image: linear-gradient(
-    to bottom,
-    transparent 0,
-    transparent 0,
-    #000 var(--density-space-sm),
-    #000 calc(100% - var(--density-space-sm)),
-    transparent 100%
-  );
-  mask-image: linear-gradient(
-    to bottom,
-    transparent 0,
-    #000 var(--density-space-sm),
-    #000 calc(100% - var(--density-space-sm)),
-    transparent 100%
-  );
-}
-
-/* ── 可被键盘聚焦的滚动容器 ── */
-.scroll-area[tabindex='0']:focus-visible {
-  outline: none;
-  box-shadow: var(--icen-ring-soft);
-  border-radius: var(--radius-md);
-}
-
-@media (prefers-reduced-motion: reduce) {
-  .scroll-area { scroll-behavior: auto; }
 }