weifuwu 0.94.0 → 0.95.0

package/dist/level5/client/components/NavMenu/NavMenu.css

@@ -0,0 +1,109 @@
+/* weifuwu/client/components — NavMenu 顶部导航（shadcn NavigationMenu 对齐） */
+
+.wf-navmenu {
+  display: flex;
+  align-items: center;
+  gap: 2px;
+  padding: 0 var(--wf-space-md);
+  background: var(--wf-color-bg-secondary);
+  border-bottom: var(--wf-border-width) solid var(--wf-color-border-light);
+  font-family: var(--wf-font-sans);
+  font-size: var(--wf-font-size-sm);
+  min-height: 48px;
+}
+
+.wf-navmenu-item {
+  position: relative;
+  display: inline-flex;
+  align-items: center;
+  gap: var(--wf-space-sm);
+  padding: var(--wf-space-sm) var(--wf-space-md);
+  border-radius: var(--wf-surface-radius);
+  color: var(--wf-color-text-secondary);
+  cursor: pointer;
+  transition: background-color var(--wf-dur-fast) var(--wf-ease-out),
+              color var(--wf-dur-fast) var(--wf-ease-out);
+}
+
+.wf-navmenu-item:hover {
+  background: var(--wf-state-hover);
+  color: var(--wf-color-text);
+}
+
+.wf-navmenu-item:active {
+  background: var(--wf-state-pressed);
+}
+
+.wf-navmenu-item--active {
+  color: var(--wf-color-primary-text);
+  font-weight: 600;
+}
+
+.wf-navmenu-item--disabled {
+  color: var(--wf-color-text-disabled);
+  cursor: not-allowed;
+}
+
+.wf-navmenu-arrow {
+  font-size: var(--wf-font-size-xs);
+  opacity: 0.6;
+}
+
+/* ── 子菜单弹出 ── */
+.wf-navmenu-sub {
+  position: absolute;
+  top: calc(100% + 6px);
+  left: 0;
+  min-width: var(--wf-navmenu-min-width);
+  padding: var(--wf-space-sm);
+  border-radius: var(--wf-surface-radius);
+  background: var(--wf-surface-bg);
+  box-shadow: var(--wf-surface-shadow);
+  border: var(--wf-border-width) solid var(--wf-color-border-light);
+  z-index: var(--wf-z-dropdown);
+  animation: wf-navmenu-in var(--wf-dur-fast) var(--wf-ease-standard);
+}
+
+@keyframes wf-navmenu-in {
+  from { opacity: 0; transform: translateY(calc(var(--wf-motion-sm) * -1)); }
+  to { opacity: 1; transform: translateY(0); }
+}
+
+.wf-navmenu-sub-item {
+  position: relative;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: var(--wf-gap-md);
+  padding: var(--wf-space-sm) var(--wf-space);
+  border-radius: var(--wf-radius);
+  color: var(--wf-color-text);
+  cursor: pointer;
+  white-space: nowrap;
+  transition: background var(--wf-dur-fast) var(--wf-ease-standard);
+}
+
+.wf-navmenu-sub-item:hover {
+  background: var(--wf-state-hover);
+}
+
+.wf-navmenu-sub-item:active {
+  background: var(--wf-state-pressed);
+}
+
+.wf-navmenu-sub-item--disabled {
+  color: var(--wf-color-text-disabled);
+  cursor: not-allowed;
+}
+
+.wf-navmenu-sub-arrow {
+  color: var(--wf-color-text-tertiary);
+}
+
+/* ── 语义标记类（DOM 钩子——无样式：测试定位/用户扩展——:where 零优先级显式声明） ── */
+:where(.wf-navmenu-label) {}
+:where(.wf-navmenu-nested) {}
+:where(.wf-navmenu-sub--nested) {}
+:where(.wf-navmenu-sub--open) {}
+:where(.wf-navmenu-sub-item--open) {}
+:where(.wf-navmenu-sub-label) {}

package/dist/level5/client/components/NavMenu/NavMenu.d.ts

@@ -0,0 +1,28 @@
+/** NavMenu：顶部导航：多级 hover 弹出 + 键盘（shadcn NavigationMenu）（showcase /components/navmenu） */
+/**
+ * weifuwu/client/components — NavMenu 顶部导航
+ *
+ * 三库等价：shadcn NavigationMenu（特有——antd/EP 用 Menu 横向模式）。
+ * 顶部水平导航 + 多级 hover 弹出 + 键盘（→ 进入子菜单 / ← 返回 / Escape 关闭）：
+ *
+ *   <NavMenu items={[{ key, label, children: [...] }]} activeKey onSelect />
+ *
+ * 弹层纪律（）：子菜单/嵌套子菜单全部经 openPopup 内核
+ * （createPortal + fixed + 视口夹紧 + Escape + 外部点击）——不 absolute 定位。
+ *
+ * 裁剪（CS-05，见 docs/client.md）：不做 hover 延迟微调/子菜单动画曲线定制；
+ * 折叠态交还 useBreakpoint 由用户驱动。
+ */
+import type { Component, VNodeChild } from '../../../../level6/client/vdom/index.ts';
+export interface NavMenuItem {
+    key: string;
+    label?: VNodeChild;
+    children?: NavMenuItem[];
+    disabled?: boolean;
+}
+export interface NavMenuProps {
+    items: NavMenuItem[];
+    activeKey?: string;
+    onSelect?: (key: string) => void;
+}
+export declare const NavMenu: Component<NavMenuProps>;

package/dist/level5/client/components/NavMenu/NavMenu.ts

@@ -0,0 +1,291 @@
+/** NavMenu：顶部导航：多级 hover 弹出 + 键盘（shadcn NavigationMenu）（showcase /components/navmenu） */
+/**
+ * weifuwu/client/components — NavMenu 顶部导航
+ *
+ * 三库等价：shadcn NavigationMenu（特有——antd/EP 用 Menu 横向模式）。
+ * 顶部水平导航 + 多级 hover 弹出 + 键盘（→ 进入子菜单 / ← 返回 / Escape 关闭）：
+ *
+ *   <NavMenu items={[{ key, label, children: [...] }]} activeKey onSelect />
+ *
+ * 弹层纪律（）：子菜单/嵌套子菜单全部经 openPopup 内核
+ * （createPortal + fixed + 视口夹紧 + Escape + 外部点击）——不 absolute 定位。
+ *
+ * 裁剪（CS-05，见 docs/client.md）：不做 hover 延迟微调/子菜单动画曲线定制；
+ * 折叠态交还 useBreakpoint 由用户驱动。
+ */
+
+import type {Component, VNodeChild} from '../../../../level6/client/vdom/index.ts'
+import type { UIContext } from '../../../../level6/client/vdom/index.ts'
+import { h, createItem } from '../../../../level6/client/vdom/index.ts'
+import { Icon } from '../Icon/Icon.ts'
+
+export interface NavMenuItem {
+  key: string
+  label?: VNodeChild
+  children?: NavMenuItem[]
+  disabled?: boolean
+}
+
+export interface NavMenuProps {
+  items: NavMenuItem[]
+  activeKey?: string
+  onSelect?: (key: string)=> void
+}
+
+/** hover 关闭延迟：覆盖 pointer 穿越 trigger→面板 间隙（fixed 面板与触发项间 gap
+ * 区域不属于面板——mouseout relatedTarget 是页面元素——进入面板前不误关） */
+const HOVER_CLOSE_DELAY = 120
+
+export const NavMenu: Component<NavMenuProps> = (_init, ctx: UIContext)=> {
+  // 交互子项状态捆绑（createItem 多槽——active 类 + open 布尔（ariaText
+  // undefined 移除——hasChildren gated：无子项 = 不可展开语义））
+  const navItem = createItem({ cls: 'wf-navmenu-item', role: 'menuitem', states: { active: {}, open: { ariaText: { key: 'aria-expanded', value: 'true' } } } })
+  // ── mount（只一次）──
+  let openKey: string | null = null
+  let nestedKey: string | null = null
+  const itemEls = new Map<string, HTMLElement>()
+  const nestedEls = new Map<string, HTMLElement>()
+  // 稳定 ref 缓存：ref 函数必须持久（内联 ref 每次渲染新引用 → ref 回调重复执行，
+  // 违反 ref 纪律）——按 key 缓存同一函数实例
+  const itemRefCache = new Map<string, (el: HTMLElement | null)=> void>()
+  const itemRef = (key: string)=> {
+    let fn = itemRefCache.get(key)
+    if (!fn) {
+      fn = (el)=> { if (el) itemEls.set(key, el) }
+      itemRefCache.set(key, fn)
+    }
+    return fn
+  }
+  const nestedRefCache = new Map<string, (el: HTMLElement | null)=> void>()
+  const nestedRef = (key: string)=> {
+    let fn = nestedRefCache.get(key)
+    if (!fn) {
+      fn = (el)=> { if (el) nestedEls.set(key, el) }
+      nestedRefCache.set(key, fn)
+    }
+    return fn
+  }
+
+  // ── hover 自动关闭（shadcn NavigationMenu 行为）──
+  // 菜单域 = 导航条 + 已展开面板（顶层 + 嵌套）。pointer 离开域 → 延迟关闭；
+  // 延迟覆盖 trigger→panel 间隙穿越：fixed 面板与触发项之间有 gap，pointer 移入
+  // 面板前会短暂落在页面元素上（mouseout relatedTarget 是页面元素而非面板）——
+  // 即时关闭会误关，进入面板的 mouseenter 会 cancel。
+  let navEl: HTMLElement | null = null
+  let subPanelEl: HTMLElement | null = null
+  let nestedPanelEl: HTMLElement | null = null
+  let closeTimer: ReturnType<typeof setTimeout> | undefined
+  const navRef = (el: HTMLElement | null)=> { navEl = el }
+  const subPanelRef = (el: HTMLElement | null)=> { subPanelEl = el }
+  const nestedPanelRef = (el: HTMLElement | null)=> { nestedPanelEl = el }
+  const inMenuDomain = (rt: unknown): boolean => {
+    if (!rt || typeof rt !== 'object') return false
+    const node = rt as Node
+    return !!(
+      (navEl && navEl.contains(node)) ||
+      (subPanelEl && subPanelEl.contains(node)) ||
+      (nestedPanelEl && nestedPanelEl.contains(node))
+    )
+  }
+  const cancelClose = ()=> { clearTimeout(closeTimer); closeTimer = undefined }
+  const scheduleClose = ()=> {
+    if (closeTimer) return
+    closeTimer = setTimeout(()=> {
+      closeTimer = undefined
+      if (openKey !== null || nestedKey !== null) {
+        openKey = null; nestedKey = null
+        ctx.render()
+      }
+    }, HOVER_CLOSE_DELAY)
+  }
+  const onDomainLeave = (e: any)=> { if (!inMenuDomain(e?.relatedTarget ?? null)) scheduleClose() }
+  const onDomainEnter = ()=> cancelClose()
+  ctx.ui.onUnmount?.(()=> { clearTimeout(closeTimer) })
+
+  // 命令式弹窗（唯一形态 openPopup——多候选项共享 handle：匹配项调用 sync +
+  // 渲染末尾兜底关闭——NavMenu 特殊模式）
+  /** 顶层子菜单句柄 */
+  let subHandle: import('../../../../level3/vdom/hooks/popup-manager.ts').PopupHandle | null = null
+  const syncSub = (content: import('../../../../level6/client/vdom/index.ts').VNode): void => {
+    if (openKey && !subHandle)
+      subHandle = ctx.ui.openPopup({
+        key: 'wf-navmenu-sub',
+        anchor: ()=> (openKey ? itemEls.get(openKey) ?? null : null),
+        placement: 'bottom',
+        center: false, // 子菜单左对齐触发项
+        gap: 4,
+        content: ()=> content,
+        onClose: ()=> { subHandle = null; if (openKey) { openKey = null; nestedKey = null; ctx.render() } },
+      })
+    else if (subHandle) subHandle.update(content)
+  }
+  /** 嵌套子菜单句柄（第二级——right 弹出） */
+  let nestedHandle: import('../../../../level3/vdom/hooks/popup-manager.ts').PopupHandle | null = null
+  const syncNested = (content: import('../../../../level6/client/vdom/index.ts').VNode): void => {
+    if (nestedKey && !nestedHandle)
+      nestedHandle = ctx.ui.openPopup({
+        key: 'wf-navmenu-nested',
+        anchor: ()=> (nestedKey ? nestedEls.get(nestedKey) ?? null : null),
+        placement: 'right',
+        center: false,
+        gap: 4,
+        content: ()=> content,
+        onClose: ()=> { nestedHandle = null; if (nestedKey) { nestedKey = null; ctx.render() } },
+      })
+    else if (nestedHandle) nestedHandle.update(content)
+  }
+  const syncNestedFallback = (): void => {
+    if (!nestedKey && nestedHandle) { nestedHandle.close(); nestedHandle = null }
+  }
+  const syncSubFallback = (): void => {
+    if (!openKey && subHandle) { subHandle.close(); subHandle = null }
+  }
+
+  const renderSub = (
+    items: NavMenuItem[],
+    activeKey: string | undefined,
+    onSelect: ((key: string)=> void) | undefined,
+    depth: number,
+  ): any[] =>
+    items.map(item => {
+      const hasNested = !!item.children?.length
+      const activate = ()=> {
+        if (item.disabled) return
+        if (hasNested) {
+          // 嵌套 hover 已展开——点击收起（或直接选中）
+          nestedKey = nestedKey === item.key ? null : item.key
+          ctx.render()
+        } else {
+          onSelect?.(item.key)
+          openKey = null
+          nestedKey = null
+          ctx.render()
+        }
+      }
+      const subChildren: any[] = [
+        h('span', { class: 'wf-navmenu-sub-label' }, item.label),
+        hasNested
+          ? h('span', { class: 'wf-navmenu-sub-arrow' }, h(Icon, { name: 'chevron-right' }))
+          : null,
+      ]
+      // 命令式同步（匹配项调用——nestedHandle 共享——关闭由兜底处理）
+      if (nestedKey === item.key) {
+        syncNested(h('div', {
+          class: 'wf-navmenu-sub wf-navmenu-sub--nested wf-navmenu-sub--open',
+          role: 'menu',
+          ref: nestedPanelRef,
+          onMouseEnter: ()=> { cancelClose(); if (nestedKey !== item.key) { nestedKey = item.key; ctx.render() } },
+          onMouseLeave: onDomainLeave,
+        }, renderSub(item.children || [], activeKey, onSelect, depth + 1)))
+      }
+      syncNestedFallback()
+      return h('div', {
+        class: `wf-navmenu-sub-item${item.disabled ? ' wf-navmenu-sub-item--disabled' : ''}${hasNested && nestedKey === item.key ? ' wf-navmenu-sub-item--open' : ''}`,
+        key: item.key,
+        role: 'menuitem',
+        tabIndex: item.disabled ? undefined : 0, // P1：可聚焦才可操作（否则 keydown 死代码）
+        'aria-haspopup': hasNested ? 'menu' : undefined,
+        'aria-disabled': item.disabled ? 'true' : undefined,
+        ref: nestedRef(item.key),
+        onClick: activate,
+        onKeyDown: (e: any)=> {
+          if (e.key === 'Enter' || e.key === ' ') { e.preventDefault?.(); activate() }
+        },
+        onMouseEnter: ()=> {
+          cancelClose() // 移回菜单域——取消延迟关闭
+          if (item.disabled) return
+          if (hasNested) {
+            if (nestedKey !== item.key) { nestedKey = item.key; ctx.render() }
+          } else if (nestedKey !== null) {
+            // 叶子子项 hover：关闭已展开的嵌套子菜单（shadcn NavigationMenu 行为）
+            nestedKey = null
+            ctx.render()
+          }
+        },
+      }, subChildren)
+    })
+
+  // ── render（每次 dirty/props 变化）──
+  return (props: NavMenuProps)=> {
+    const { items, activeKey, onSelect } = props
+
+    const navVn = h('nav', {
+      class: 'wf-navmenu',
+      role: 'navigation',
+      'aria-label': '主导航',
+      ref: navRef,
+      onMouseLeave: onDomainLeave,
+    }, items.map(item => {
+      const hasChildren = !!item.children?.length
+      const isOpen = openKey === item.key
+            const itemChildren: any[] = [
+        h('span', { class: 'wf-navmenu-label' }, item.label),
+        hasChildren && h('span', { class: 'wf-navmenu-arrow' }, h(Icon, { name: 'chevron-down' })),
+      ]
+      // 命令式同步（匹配项调用——subHandle 共享——关闭由兜底处理）
+      if (isOpen) {
+        syncSub(h('div', {
+          class: 'wf-navmenu-sub wf-navmenu-sub--open',
+          role: 'menu',
+          ref: subPanelRef,
+          onMouseEnter: onDomainEnter,
+          onMouseLeave: onDomainLeave,
+        }, renderSub(item.children || [], activeKey, onSelect, 1)))
+      }
+      syncSubFallback()
+      return h('div', navItem({ active: activeKey === item.key, open: hasChildren && isOpen }, {
+        key: item.key,
+        class: [item.disabled ? 'wf-navmenu-item--disabled' : ''],
+        'aria-haspopup': hasChildren ? 'menu' : undefined,
+        ref: itemRef(item.key),
+        tabIndex: item.disabled ? undefined : 0, // P1：可聚焦才可操作
+        onClick: ()=> {
+          if (item.disabled) return
+          if (hasChildren) {
+            openKey = isOpen ? null : item.key
+            nestedKey = null
+            ctx.render()
+          } else {
+            onSelect?.(item.key)
+            // 点击叶子项：关闭已展开的子菜单（shadcn NavigationMenu 行为）
+            openKey = null
+            nestedKey = null
+            ctx.render()
+          }
+        },
+        onMouseEnter: ()=> {
+          cancelClose() // 移回菜单域——取消延迟关闭
+          // hover 打开子菜单（桌面主通道；移动端点击切换）
+          if (item.disabled) return
+          if (hasChildren) {
+            if (openKey !== item.key) { openKey = item.key; nestedKey = null; ctx.render() }
+          } else if (openKey !== null || nestedKey !== null) {
+            // 叶子项 hover：关闭已展开的子菜单（shadcn NavigationMenu 行为）
+            openKey = null; nestedKey = null
+            ctx.render()
+          }
+        },
+        onKeyDown: (e: any)=> {
+          if (e.key === 'Enter' || e.key === ' ') {
+            e.preventDefault?.()
+            if (item.disabled) return
+            if (hasChildren) { openKey = isOpen ? null : item.key; nestedKey = null; ctx.render() }
+            else { onSelect?.(item.key); openKey = null; nestedKey = null; ctx.render() }
+          } else if (e.key === 'ArrowRight' && hasChildren) {
+            openKey = item.key
+            ctx.render()
+          } else if (e.key === 'Escape') {
+            openKey = null
+            nestedKey = null
+            ctx.render()
+          }
+        },
+      }), itemChildren)
+    }))
+    // 顶层关闭兜底（nested fallback 只在 renderSub 内——顶层子菜单关闭后
+    // renderSub 不再被调——nestedHandle 残留（点击叶子项嵌套面板残留实证）——
+    // **必须在 return 前**（return 后 = 死代码——同 SheetGrid 教训）
+    syncNestedFallback()
+    return navVn
+  }
+}

package/dist/level5/client/components/Notification/Notification.css

@@ -0,0 +1,102 @@
+/* weifuwu/client/components — Notification */
+
+.wf-notification-container {
+  position: fixed;
+  z-index: var(--wf-z-toast);
+  display: flex;
+  flex-direction: column;
+  gap: var(--wf-gap-sm);
+  pointer-events: none;
+  max-width: 360px;
+}
+
+.wf-notification--tr { top: var(--wf-space-lg); right: var(--wf-space-lg); align-items: flex-end; }
+.wf-notification--tl { top: var(--wf-space-lg); left: var(--wf-space-lg); align-items: flex-start; }
+.wf-notification--br { bottom: var(--wf-space-lg); right: var(--wf-space-lg); align-items: flex-end; }
+.wf-notification--bl { bottom: var(--wf-space-lg); left: var(--wf-space-lg); align-items: flex-start; }
+
+.wf-notification {
+  display: flex;
+  gap: var(--wf-gap-sm);
+  background: var(--wf-color-bg);
+  border: var(--wf-border-width) solid var(--wf-color-border);
+  border-left-width: 3px;
+  border-radius: var(--wf-radius);
+  box-shadow: var(--wf-shadow-lg);
+  padding: var(--wf-space) var(--wf-space-md);
+  pointer-events: auto;
+  font-family: var(--wf-font-sans);
+  width: 100%;
+}
+
+.wf-notification--success { border-left-color: var(--wf-color-success); }
+.wf-notification--error { border-left-color: var(--wf-color-error); }
+.wf-notification--warning { border-left-color: var(--wf-color-warning); }
+.wf-notification--info { border-left-color: var(--wf-color-info); }
+
+.wf-notification-icon {
+  display: inline-flex;
+  align-items: flex-start;
+  color: var(--wf-color-text-secondary);
+  padding-top: 2px;
+}
+
+.wf-notification--success .wf-notification-icon { color: var(--wf-color-success-text); }
+.wf-notification--error .wf-notification-icon { color: var(--wf-color-error-text); }
+.wf-notification--warning .wf-notification-icon { color: var(--wf-color-warning-text); }
+.wf-notification--info .wf-notification-icon { color: var(--wf-color-info-text); }
+
+.wf-notification-body {
+  flex: 1;
+  min-width: 0;
+}
+
+.wf-notification-title {
+  font-size: var(--wf-font-size-base);
+  font-weight: var(--wf-font-weight-semibold);
+  color: var(--wf-color-text);
+}
+
+.wf-notification-desc {
+  font-size: var(--wf-font-size-sm);
+  color: var(--wf-color-text-secondary);
+  margin-top: 2px;
+  word-break: break-word;
+}
+
+.wf-notification-action {
+  margin-top: var(--wf-gap-sm);
+  border: none;
+  background: none;
+  padding: 0;
+  font-size: var(--wf-font-size-sm);
+  color: var(--wf-color-primary-text);
+  cursor: pointer;
+}
+
+.wf-notification-action:focus-visible {
+  outline: none;
+  box-shadow: var(--wf-focus-ring);
+  border-radius: var(--wf-radius-sm);
+}
+
+.wf-notification-close {
+  border: none;
+  background: none;
+  padding: 2px;
+  cursor: pointer;
+  color: var(--wf-color-text-tertiary);
+  align-self: flex-start;
+}
+
+.wf-notification-close:hover {
+  color: var(--wf-color-text);
+}
+
+.wf-notification-close:focus-visible {
+  outline: none;
+  box-shadow: var(--wf-focus-ring);
+  border-radius: var(--wf-radius-sm);
+}
+/* ── 语义标记类（DOM 钩子——无样式：测试定位/用户扩展——:where 零优先级显式声明） ── */
+:where(.wf-notification-host) {}

package/dist/level5/client/components/Notification/Notification.d.ts

@@ -0,0 +1,74 @@
+/** Notification：队列式通知：notification.success/error/warning 命令式（antd 对齐）（showcase /components/notification） */
+import type { Component } from '../../../../level6/client/vdom/index.ts';
+export type NotificationType = 'success' | 'error' | 'info' | 'warning';
+export type NotificationPosition = 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left';
+export interface NotificationItem {
+    id: string;
+    type: NotificationType;
+    title: string;
+    description?: string;
+    /** 自动关闭时间（ms），0 = 不自动关闭，默认 4500 */
+    duration?: number;
+    action?: {
+        label: string;
+        onClick: () => void;
+    };
+}
+export interface NotificationProps {
+    items?: NotificationItem[];
+    onRemove?: (id: string) => void;
+    position?: NotificationPosition;
+    /** 全局默认自动关闭时间（ms），默认 4500 */
+    duration?: number;
+    /** 最大显示条数，超出移除最早，默认 0 = 不限制 */
+    max?: number;
+}
+export interface NotificationOptions {
+    position?: NotificationPosition;
+    duration?: number;
+    max?: number;
+}
+/** 命令式入口（对齐 antd notification.open 风格——可调用可链式） */
+export declare const notification: NotificationInjected['notification'];
+/**
+ * 命令式中间件：注入 ctx.notification()（AppMiddleware 形态——应用装配）
+ */
+export declare function notificationMiddleware<C extends Record<string, unknown>>(ctx: C): C & NotificationInjected;
+export declare const Notification: Component<NotificationProps>;
+export interface NotificationInjected {
+    notification: {
+        (title: string, opts?: {
+            type?: NotificationType;
+            description?: string;
+            duration?: number;
+            action?: NotificationItem['action'];
+        }): void;
+        open: (opts: {
+            type?: NotificationType;
+            title: string;
+            description?: string;
+            duration?: number;
+            action?: NotificationItem['action'];
+        }) => void;
+        success: (opts: {
+            title: string;
+            description?: string;
+            duration?: number;
+        }) => void;
+        error: (opts: {
+            title: string;
+            description?: string;
+            duration?: number;
+        }) => void;
+        info: (opts: {
+            title: string;
+            description?: string;
+            duration?: number;
+        }) => void;
+        warning: (opts: {
+            title: string;
+            description?: string;
+            duration?: number;
+        }) => void;
+    };
+}