@robot-admin/naive-ui-components 0.3.0

package/dist/constants3.d.ts

@@ -0,0 +1,475 @@
+import * as vue from "vue";
+
+//#region src/components/C_NotificationCenter/types.d.ts
+/** 消息类别 */
+type NotificationCategory = "system" | "business" | "alarm";
+/** 消息优先级 */
+type NotificationPriority = "low" | "normal" | "high" | "urgent";
+/** 消息状态 */
+type NotificationStatus = "unread" | "read" | "archived";
+/** 单条通知消息 */
+interface NotificationMessage {
+  /** 消息唯一 ID */
+  id: string;
+  /** 消息标题 */
+  title: string;
+  /** 消息摘要（列表中展示） */
+  summary: string;
+  /** 消息详情（富文本 / 纯文本） */
+  content?: string;
+  /** 消息类别 */
+  category: NotificationCategory;
+  /** 优先级 */
+  priority: NotificationPriority;
+  /** 消息状态 */
+  status: NotificationStatus;
+  /** 发送时间（ISO 8601） */
+  timestamp: string;
+  /** 发送者信息 */
+  sender?: NotificationSender;
+  /** 关联操作链接 */
+  actionUrl?: string;
+  /** 关联操作按钮文本 */
+  actionText?: string;
+  /** 附加数据（业务扩展） */
+  extra?: Record<string, unknown>;
+}
+/** 发送者信息 */
+interface NotificationSender {
+  /** 发送者名称 */
+  name: string;
+  /** 发送者头像 URL */
+  avatar?: string;
+}
+/** 拉取消息列表函数 */
+type FetchNotificationsFn = (params: {
+  category?: NotificationCategory;
+  status?: NotificationStatus;
+  page?: number;
+  pageSize?: number;
+}) => Promise<{
+  list: NotificationMessage[];
+  total: number;
+  unreadCount: number;
+}>;
+/** 标记已读函数 */
+type MarkAsReadFn = (ids: string[]) => Promise<void>;
+/** 标记全部已读函数 */
+type MarkAllReadFn = (category?: NotificationCategory) => Promise<void>;
+/** 删除消息函数 */
+type DeleteNotificationFn = (ids: string[]) => Promise<void>;
+/** 清空消息函数 */
+type ClearNotificationsFn = (category?: NotificationCategory) => Promise<void>;
+/** WebSocket 配置 */
+interface NotificationWSConfig {
+  /** WebSocket 地址（ws:// 或 wss://） */
+  url: string;
+  /** 自动重连 */
+  autoReconnect?: boolean;
+  /** 重连间隔（ms） */
+  reconnectInterval?: number;
+  /** 最大重连次数 */
+  maxReconnectAttempts?: number;
+  /** 心跳间隔（ms），0 表示不发心跳 */
+  heartbeatInterval?: number;
+  /** 心跳消息内容 */
+  heartbeatMessage?: string;
+  /** 鉴权 token 获取函数 */
+  getToken?: () => string | undefined;
+}
+/** WebSocket 连接状态 */
+type WSConnectionStatus = "connecting" | "connected" | "disconnected" | "reconnecting";
+/** WebSocket 推送消息负载 */
+interface WSNotificationPayload {
+  /** 事件类型 */
+  type: "new_message" | "read_sync" | "count_update";
+  /** 推送的消息数据 */
+  data: NotificationMessage | NotificationMessage[] | {
+    unreadCount: number;
+  };
+}
+/** 组件 Props */
+interface NotificationCenterProps {
+  /** 拉取消息列表 */
+  fetchNotifications?: FetchNotificationsFn;
+  /** 标记已读 */
+  markAsRead?: MarkAsReadFn;
+  /** 标记全部已读 */
+  markAllRead?: MarkAllReadFn;
+  /** 删除消息 */
+  deleteNotification?: DeleteNotificationFn;
+  /** 清空消息 */
+  clearNotifications?: ClearNotificationsFn;
+  /** WebSocket 配置 */
+  wsConfig?: NotificationWSConfig;
+  /** 是否启用桌面通知 */
+  desktopNotification?: boolean;
+  /** 角标最大显示数 */
+  maxBadgeCount?: number;
+  /** 自动轮询间隔（ms），0 表示不轮询 */
+  pollingInterval?: number;
+  /** 每页条数 */
+  pageSize?: number;
+  /** 消息持久化缓存 key */
+  storageKey?: string;
+}
+/** 组件 Emits */
+interface NotificationCenterEmits {
+  /** 点击消息 */
+  itemClick: [message: NotificationMessage];
+  /** 消息已读 */
+  read: [ids: string[]];
+  /** 全部已读 */
+  allRead: [category?: NotificationCategory];
+  /** 删除消息 */
+  delete: [ids: string[]];
+  /** 未读数变化 */
+  unreadChange: [count: number];
+  /** WebSocket 连接状态变化 */
+  wsStatusChange: [status: WSConnectionStatus];
+  /** 收到新消息 */
+  newMessage: [message: NotificationMessage];
+}
+/** 组件 Expose */
+interface NotificationCenterExpose {
+  /** 刷新消息列表 */
+  refresh: () => Promise<void>;
+  /** 手动连接 WebSocket */
+  connectWS: () => void;
+  /** 手动断开 WebSocket */
+  disconnectWS: () => void;
+  /** 获取未读数 */
+  getUnreadCount: () => number;
+  /** 获取当前消息列表 */
+  getMessages: () => NotificationMessage[];
+  /** 手动标记已读 */
+  markRead: (ids: string[]) => Promise<void>;
+  /** 手动标记全部已读 */
+  markAllAsRead: (category?: NotificationCategory) => Promise<void>;
+}
+//#endregion
+//#region src/components/C_NotificationCenter/index.vue.d.ts
+declare const __VLS_export: vue.DefineComponent<NotificationCenterProps, NotificationCenterExpose, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
+  delete: (ids: string[]) => any;
+  read: (ids: string[]) => any;
+  itemClick: (message: NotificationMessage) => any;
+  allRead: (category?: NotificationCategory | undefined) => any;
+  unreadChange: (count: number) => any;
+  wsStatusChange: (status: string) => any;
+  newMessage: (message: NotificationMessage) => any;
+  navigate: (url: string) => any;
+}, string, vue.PublicProps, Readonly<NotificationCenterProps> & Readonly<{
+  onDelete?: ((ids: string[]) => any) | undefined;
+  onRead?: ((ids: string[]) => any) | undefined;
+  onItemClick?: ((message: NotificationMessage) => any) | undefined;
+  onAllRead?: ((category?: NotificationCategory | undefined) => any) | undefined;
+  onUnreadChange?: ((count: number) => any) | undefined;
+  onWsStatusChange?: ((status: string) => any) | undefined;
+  onNewMessage?: ((message: NotificationMessage) => any) | undefined;
+  onNavigate?: ((url: string) => any) | undefined;
+}>, {
+  desktopNotification: boolean;
+  maxBadgeCount: number;
+  pollingInterval: number;
+  pageSize: number;
+  storageKey: string;
+}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+//#endregion
+//#region src/components/C_NotificationCenter/composables/useNotificationCore.d.ts
+/**
+ * 通知中心核心状态管理
+ *
+ * 统一管理消息列表、未读数、分类过滤、已读标记、
+ * API 交互、WebSocket 桥接、轮询调度和本地缓存。
+ */
+declare function useNotificationCore(props: NotificationCenterProps): {
+  messages: vue.Ref<{
+    id: string;
+    title: string;
+    summary: string;
+    content?: string | undefined;
+    category: NotificationCategory;
+    priority: NotificationPriority;
+    status: NotificationStatus;
+    timestamp: string;
+    sender?: {
+      name: string;
+      avatar?: string | undefined;
+    } | undefined;
+    actionUrl?: string | undefined;
+    actionText?: string | undefined;
+    extra?: Record<string, unknown> | undefined;
+  }[], NotificationMessage[] | {
+    id: string;
+    title: string;
+    summary: string;
+    content?: string | undefined;
+    category: NotificationCategory;
+    priority: NotificationPriority;
+    status: NotificationStatus;
+    timestamp: string;
+    sender?: {
+      name: string;
+      avatar?: string | undefined;
+    } | undefined;
+    actionUrl?: string | undefined;
+    actionText?: string | undefined;
+    extra?: Record<string, unknown> | undefined;
+  }[]>;
+  activeCategory: vue.Ref<NotificationCategory | "all", NotificationCategory | "all">;
+  loading: vue.Ref<boolean, boolean>;
+  total: vue.Ref<number, number>;
+  page: vue.Ref<number, number>;
+  selectedMessage: vue.Ref<{
+    id: string;
+    title: string;
+    summary: string;
+    content?: string | undefined;
+    category: NotificationCategory;
+    priority: NotificationPriority;
+    status: NotificationStatus;
+    timestamp: string;
+    sender?: {
+      name: string;
+      avatar?: string | undefined;
+    } | undefined;
+    actionUrl?: string | undefined;
+    actionText?: string | undefined;
+    extra?: Record<string, unknown> | undefined;
+  } | null, NotificationMessage | {
+    id: string;
+    title: string;
+    summary: string;
+    content?: string | undefined;
+    category: NotificationCategory;
+    priority: NotificationPriority;
+    status: NotificationStatus;
+    timestamp: string;
+    sender?: {
+      name: string;
+      avatar?: string | undefined;
+    } | undefined;
+    actionUrl?: string | undefined;
+    actionText?: string | undefined;
+    extra?: Record<string, unknown> | undefined;
+  } | null>;
+  popoverVisible: vue.Ref<boolean, boolean>;
+  wsStatus: vue.Ref<WSConnectionStatus, WSConnectionStatus>;
+  unreadCount: vue.ComputedRef<number>;
+  unreadByCategory: vue.ComputedRef<Record<string, number>>;
+  filteredMessages: vue.ComputedRef<{
+    id: string;
+    title: string;
+    summary: string;
+    content?: string | undefined;
+    category: NotificationCategory;
+    priority: NotificationPriority;
+    status: NotificationStatus;
+    timestamp: string;
+    sender?: {
+      name: string;
+      avatar?: string | undefined;
+    } | undefined;
+    actionUrl?: string | undefined;
+    actionText?: string | undefined;
+    extra?: Record<string, unknown> | undefined;
+  }[]>;
+  hasMore: vue.ComputedRef<boolean>;
+  fetchMessages: (reset?: boolean) => Promise<void>;
+  loadMore: () => Promise<void>;
+  markAsRead: (ids: string[]) => Promise<void>;
+  markAllAsRead: (category?: NotificationCategory) => Promise<void>;
+  deleteMessages: (ids: string[]) => Promise<void>;
+  clearMessages: (category?: NotificationCategory) => Promise<void>;
+  selectMessage: (msg: NotificationMessage) => void;
+  clearSelection: () => void;
+  switchCategory: (category: NotificationCategory | "all") => void;
+  connectWS: (config: NotificationWSConfig) => void;
+  disconnectWS: () => void;
+};
+//#endregion
+//#region src/components/C_NotificationCenter/composables/useNotificationFormat.d.ts
+/**
+ * 通知时间格式化（单例）
+ *
+ * 将 ISO 时间戳格式化为人类友好的相对时间描述，
+ * 如 "刚刚"、"5分钟前"、"昨天 14:30" 等。
+ */
+declare function useNotificationFormat(): {
+  formatRelativeTime: (timestamp: string) => string;
+  formatFullDate: (date: Date) => string;
+};
+//#endregion
+//#region src/components/C_NotificationCenter/composables/useNotificationWS.d.ts
+/**
+ * WebSocket 连接管理
+ *
+ * 管理 WebSocket 的建连、重连、心跳保活、消息解析。
+ * 支持自动重连、鉴权 token、心跳检测。
+ */
+declare function useNotificationWS(onMessage: (payload: WSNotificationPayload) => void, onStatusChange?: (status: WSConnectionStatus) => void): {
+  /** WebSocket 连接状态 */status: Readonly<vue.Ref<WSConnectionStatus, WSConnectionStatus>>;
+  connect: (config: NotificationWSConfig) => void;
+  disconnect: () => void;
+  reconnect: () => void;
+};
+//#endregion
+//#region src/components/C_NotificationCenter/constants.d.ts
+/** 默认角标最大显示数 */
+declare const DEFAULT_MAX_BADGE_COUNT = 99;
+/** 默认每页条数 */
+declare const DEFAULT_PAGE_SIZE = 20;
+/** 默认轮询间隔（ms）：60 秒 */
+declare const DEFAULT_POLLING_INTERVAL = 60000;
+/** 默认缓存 key */
+declare const DEFAULT_STORAGE_KEY = "notification_center";
+/** WebSocket 默认重连间隔（ms） */
+declare const DEFAULT_WS_RECONNECT_INTERVAL = 3000;
+/** WebSocket 默认最大重连次数 */
+declare const DEFAULT_WS_MAX_RECONNECT = 5;
+/** WebSocket 默认心跳间隔（ms） */
+declare const DEFAULT_WS_HEARTBEAT_INTERVAL = 30000;
+/** WebSocket 默认心跳消息 */
+declare const DEFAULT_WS_HEARTBEAT_MESSAGE = "ping";
+/** 分类标签映射 */
+declare const CATEGORY_MAP: Record<NotificationCategory, {
+  label: string;
+  icon: string;
+  color: string;
+}>;
+/** 分类 Tab 列表 */
+declare const CATEGORY_TABS: {
+  key: NotificationCategory | "all";
+  label: string;
+}[];
+/** 优先级标签映射 */
+declare const PRIORITY_MAP: Record<NotificationPriority, {
+  label: string;
+  type: "default" | "info" | "success" | "warning" | "error";
+}>;
+/** 模拟消息列表 */
+declare const MOCK_MESSAGES: ({
+  id: string;
+  title: string;
+  summary: string;
+  content: string;
+  category: "system";
+  priority: "high";
+  status: "unread";
+  timestamp: string;
+  sender: {
+    name: string;
+    avatar: string;
+  };
+  actionUrl?: undefined;
+  actionText?: undefined;
+} | {
+  id: string;
+  title: string;
+  summary: string;
+  category: "business";
+  priority: "urgent";
+  status: "unread";
+  timestamp: string;
+  sender: {
+    name: string;
+    avatar: string;
+  };
+  actionUrl: string;
+  actionText: string;
+  content?: undefined;
+} | {
+  id: string;
+  title: string;
+  summary: string;
+  category: "alarm";
+  priority: "urgent";
+  status: "unread";
+  timestamp: string;
+  sender: {
+    name: string;
+    avatar?: undefined;
+  };
+  actionUrl: string;
+  actionText: string;
+  content?: undefined;
+} | {
+  id: string;
+  title: string;
+  summary: string;
+  category: "system";
+  priority: "normal";
+  status: "unread";
+  timestamp: string;
+  sender: {
+    name: string;
+    avatar?: undefined;
+  };
+  content?: undefined;
+  actionUrl?: undefined;
+  actionText?: undefined;
+} | {
+  id: string;
+  title: string;
+  summary: string;
+  category: "business";
+  priority: "high";
+  status: "read";
+  timestamp: string;
+  sender: {
+    name: string;
+    avatar?: undefined;
+  };
+  content?: undefined;
+  actionUrl?: undefined;
+  actionText?: undefined;
+} | {
+  id: string;
+  title: string;
+  summary: string;
+  category: "alarm";
+  priority: "high";
+  status: "read";
+  timestamp: string;
+  sender: {
+    name: string;
+    avatar?: undefined;
+  };
+  content?: undefined;
+  actionUrl?: undefined;
+  actionText?: undefined;
+} | {
+  id: string;
+  title: string;
+  summary: string;
+  category: "business";
+  priority: "normal";
+  status: "read";
+  timestamp: string;
+  sender: {
+    name: string;
+    avatar?: undefined;
+  };
+  content?: undefined;
+  actionUrl?: undefined;
+  actionText?: undefined;
+} | {
+  id: string;
+  title: string;
+  summary: string;
+  category: "system";
+  priority: "high";
+  status: "unread";
+  timestamp: string;
+  sender: {
+    name: string;
+    avatar?: undefined;
+  };
+  content?: undefined;
+  actionUrl?: undefined;
+  actionText?: undefined;
+})[];
+//#endregion
+export { NotificationWSConfig as A, NotificationCenterEmits as C, NotificationPriority as D, NotificationMessage as E, WSNotificationPayload as M, NotificationSender as O, NotificationCategory as S, NotificationCenterProps as T, ClearNotificationsFn as _, DEFAULT_POLLING_INTERVAL as a, MarkAllReadFn as b, DEFAULT_WS_HEARTBEAT_MESSAGE as c, MOCK_MESSAGES as d, PRIORITY_MAP as f, _default as g, useNotificationCore as h, DEFAULT_PAGE_SIZE as i, WSConnectionStatus as j, NotificationStatus as k, DEFAULT_WS_MAX_RECONNECT as l, useNotificationFormat as m, CATEGORY_TABS as n, DEFAULT_STORAGE_KEY as o, useNotificationWS as p, DEFAULT_MAX_BADGE_COUNT as r, DEFAULT_WS_HEARTBEAT_INTERVAL as s, CATEGORY_MAP as t, DEFAULT_WS_RECONNECT_INTERVAL as u, DeleteNotificationFn as v, NotificationCenterExpose as w, MarkAsReadFn as x, FetchNotificationsFn as y };
+//# sourceMappingURL=constants3.d.ts.map

package/dist/constants3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants3.d.ts","names":[],"sources":["../src/components/C_NotificationCenter/types.ts","../src/components/C_NotificationCenter/index.vue","../src/components/C_NotificationCenter/composables/useNotificationCore.ts","../src/components/C_NotificationCenter/composables/useNotificationFormat.ts","../src/components/C_NotificationCenter/composables/useNotificationWS.ts","../src/components/C_NotificationCenter/constants.ts"],"mappings":"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"}