@icen.ai/ui 0.9.0 → 0.11.0

package/dist/behaviors/nav.d.mts

@@ -1,5 +1,5 @@
 /**
- * 为 root 下每个 .nav[data-scroll-reactive] 初始化（root 自身匹配也算）。
+ * 为 root 下每个 .icen-nav[data-icen-scroll-reactive] 初始化（root 自身匹配也算）。
  * 返回销毁函数：移除本次初始化挂上的全部 window scroll/resize 与 nav click 监听。
  */
 declare function initNav(root?: ParentNode): () => void;

package/dist/behaviors/nav.mjs

@@ -10,7 +10,7 @@ function prefersReducedMotion() {
   if (typeof window === "undefined" || typeof window.matchMedia !== "function") return false;
   return window.matchMedia("(prefers-reduced-motion: reduce)").matches;
 }
-var NAV_ITEM_SELECTOR = ".nav-btn, .nav-link";
+var NAV_ITEM_SELECTOR = ".icen-nav-btn, .icen-nav-link";
 function isNavItemDisabled(item) {
   return item.classList.contains("is-disabled") || item.getAttribute("aria-disabled") === "true" || item instanceof HTMLButtonElement && item.disabled;
 }
@@ -18,10 +18,10 @@ function setup(nav) {
   const el = nav;
   if (el.__icenNavInit) return void 0;
   el.__icenNavInit = true;
-  const rawThreshold = nav.dataset.navThreshold;
+  const rawThreshold = nav.dataset.icenNavThreshold;
   const parsedThreshold = rawThreshold === void 0 || rawThreshold === "" ? NaN : Number(rawThreshold);
   const threshold = Number.isFinite(parsedThreshold) ? parsedThreshold : 12;
-  const hideOnScroll = nav.hasAttribute("data-nav-hide-on-scroll");
+  const hideOnScroll = nav.hasAttribute("data-icen-nav-hide-on-scroll");
   let ticking = false;
   let lastY = window.scrollY;
   let hidden = false;
@@ -54,7 +54,7 @@ function setup(nav) {
     const target = ev.target;
     if (!(target instanceof Element)) return;
     const item = target.closest(NAV_ITEM_SELECTOR);
-    if (!item || item.closest(".nav") !== nav) return;
+    if (!item || item.closest(".icen-nav") !== nav) return;
     if (isNavItemDisabled(item)) return;
     const items = Array.from(nav.querySelectorAll(NAV_ITEM_SELECTOR));
     const index = items.indexOf(item);
@@ -81,8 +81,8 @@ function initNav(root) {
   if (typeof document !== "undefined" && typeof window !== "undefined") {
     const scope = root ?? document;
     const navs = [];
-    if (scope instanceof Element && scope.matches(".nav[data-scroll-reactive]")) navs.push(scope);
-    navs.push(...Array.from(scope.querySelectorAll(".nav[data-scroll-reactive]")));
+    if (scope instanceof Element && scope.matches(".icen-nav[data-icen-scroll-reactive]")) navs.push(scope);
+    navs.push(...Array.from(scope.querySelectorAll(".icen-nav[data-icen-scroll-reactive]")));
     for (const n of navs) {
       const cleanup = setup(n);
       if (cleanup) cleanups.push(cleanup);

package/dist/behaviors/notification.d.mts

@@ -1,9 +1,12 @@
+import { FeedbackAction } from './feedback.mjs';
+import { IconName } from './icons.mjs';
+
 type NotificationKind = 'success' | 'warning' | 'error' | 'info';
 interface NotificationAction {
     /** 按钮文字 */
     label: string;
-    /** 点击回调；返回 false 阻止通知关闭 */
-    onClick?: () => void | Promise<void> | boolean;
+    /** 同步/异步操作；false 保持打开，reject 提供重试反馈；关闭时 abort signal。 */
+    onClick?: FeedbackAction;
     /** 视觉变体：默认 ghost / primary 实底 / danger 危险色 */
     type?: 'primary' | 'ghost' | 'danger';
     /** 点击后是否保持通知打开（默认 false） */
@@ -24,6 +27,8 @@ interface NotificationOptions {
     showCountdown?: boolean;
     /** 自定义图标：SVG 字符串 / 图片 URL / false（关闭） */
     icon?: string | false;
+    /** Shared ICEN symbol; icon:false still disables the slot. */
+    iconName?: IconName;
     /** 头像 URL（会覆盖 kind 图标） */
     avatar?: string;
     /** 优先级：normal（默认）/ high（置顶） */
@@ -32,17 +37,19 @@ interface NotificationOptions {
     unread?: boolean;
     /** 多动作按钮（actions 优先于 actionLabel） */
     actions?: NotificationAction[];
-    /** 兼容旧版单按钮 */
+    /** 单按钮简写（actions 的快捷形态） */
     actionLabel?: string;
-    onAction?: () => void | Promise<void> | boolean;
-    /** 进度（0–1）；progress > 0 时显示进度条。推荐用 notify.progress() 返回的 handle.setProgress */
+    onAction?: FeedbackAction;
+    /** Inline copy for a rejected action; defaults to localized retry guidance. */
+    actionError?: string;
+    /** 进度（0–1）；progress > 0 时显示进度条。推荐用 notify.icen-progress() 返回的 handle.setProgress */
     progress?: number;
     /** 进度条下方文字（如「正在导出 64%」） */
     progressLabel?: string;
     /** 详情链接（绝对 / 相对路径） */
     link?: string;
     linkLabel?: string;
-    /** 分组键：同 tag 的多条会聚合显示计数 */
+    /** 同一容器内相同 tag 自动折叠为最新通知，可展开原始卡片；高优先级优先呈现。 */
     tag?: string;
     /** 自定义数据（持久化时保留） */
     data?: unknown;
@@ -60,7 +67,7 @@ interface NotificationConfig {
     maxStack?: number;
     /** hover 暂停倒计时，默认 true */
     pauseOnHover?: boolean;
-    /** 持久化：true 用默认 key / 字符串=自定义 key / 不传=不持久化 */
+    /** 持久化常驻通知；true 用默认 key，字符串用自定义 key。卸载保留，dismiss/clear 删除。函数动作不序列化。 */
     persist?: boolean | string;
     /** 声音提示：true 用默认蜂鸣 / 字符串=data URL / 不传=无声 */
     sound?: boolean | string;
@@ -88,6 +95,7 @@ interface NotificationHandle {
 }
 /** update 接受的局部字段（title 在 push 时传，update 时也接受） */
 interface NotificationUpdatePatch {
+    iconName?: IconName;
     title?: string;
     description?: string;
     duration?: number;
@@ -159,7 +167,7 @@ interface NotificationCenterHandle {
     dismiss(id?: string): void;
     clear(): void;
     markAllRead(): void;
-    /** 销毁容器：移除 DOM、清掉其所有 timer 与监听器；之后 push 返回 null */
+    /** 卸载界面并停止运行时，保留持久快照；清除快照请先 clear。之后 push 返回 null。 */
     destroy(): void;
     get(id: string): NotificationRecord | null;
     getAll(): NotificationRecord[];