@robot-admin/naive-ui-components 0.10.3 → 0.11.0

package/dist/index5.vue.d.cts

@@ -0,0 +1,133 @@
+import { n as RouteItem } from "./types.cjs";
+import * as vue from "vue";
+import { Ref, VNode } from "vue";
+import * as naive_ui0 from "naive-ui";
+import { DropdownProps, MenuInst, MenuOption } from "naive-ui";
+import * as naive_ui_es_menu_src_interface0 from "naive-ui/es/menu/src/interface";
+
+//#region src/components/_shared/menuAdapter.d.ts
+/**
+ * 菜单适配器配置
+ */
+interface MenuAdapterConfig {
+  /**
+   * 标签文本格式化函数（用于 i18n）
+   * 默认：原样返回 title
+   */
+  labelFormatter?: (title: string) => string;
+  /**
+   * 获取菜单项的唯一 key
+   * 默认：`normalizePath(route.path)`
+   */
+  getKey?: (route: RouteItem) => string;
+  /**
+   * 获取显示文本
+   * 默认：`route.meta?.title || route.name || ''`
+   */
+  getLabel?: (route: RouteItem) => string;
+  /**
+   * 路由过滤器 — return false 排除该项
+   * 默认：排除 `meta.hidden === true`
+   */
+  filter?: (route: RouteItem) => boolean;
+  /**
+   * 自定义图标渲染
+   * 默认：字符串 → Iconify Icon；函数 → 直接调用
+   */
+  renderIcon?: (icon: string | (() => VNode) | undefined) => (() => VNode) | undefined;
+  /**
+   * 是否递归处理 children
+   * 默认：true
+   */
+  recursive?: boolean;
+}
+/**
+ * 将路由数据转换为 NMenu 的 MenuOption[]
+ *
+ * 支持的输入格式：
+ * 1. **Vue Router RouteRecordRaw** — 直接传 `router.getRoutes()` 或手写路由表
+ * 2. **后端 JSON 路由表** — `{ path, meta: { title, icon }, children }`
+ * 3. **自定义格式** — 通过 config 完全自定义 key/label/icon 的取值逻辑
+ *
+ * @param routes 路由数据数组
+ * @param config 适配器配置
+ * @returns NMenu 可直接使用的 MenuOption[]
+ */
+declare function createMenuOptions(routes: RouteItem[], config?: MenuAdapterConfig): MenuOption[];
+/**
+ * 将路由树扁平化为一维数组（常用于搜索、快捷导航）
+ *
+ * @param routes 路由数据数组
+ * @param filter 过滤器（默认排除 hidden）
+ * @returns 扁平化后的路由数组
+ */
+declare function flattenRoutes(routes: RouteItem[], filter?: (route: RouteItem) => boolean): RouteItem[];
+//#endregion
+//#region src/components/C_Menu/types.d.ts
+type MenuValue = string | null;
+interface MenuProps {
+  options?: MenuOption[];
+  routes?: RouteItem[];
+  adapterConfig?: MenuAdapterConfig;
+  labelFormatter?: (label: string) => string;
+  /** @deprecated Use modelValue. */
+  value?: MenuValue;
+  modelValue?: MenuValue;
+  expandedKeys?: string[];
+  defaultExpandedKeys?: string[];
+  mode?: 'vertical' | 'horizontal';
+  collapsed?: boolean;
+  collapsedWidth?: number;
+  collapsedIconSize?: number;
+  inverted?: boolean;
+  themeOverrides?: Record<string, any>;
+  indent?: number;
+  rootIndent?: number;
+  dropdownProps?: DropdownProps;
+}
+interface MenuEmits {
+  select: [key: string];
+  'update:modelValue': [key: MenuValue];
+  /** @deprecated Use update:modelValue. */
+  'update:value': [key: MenuValue];
+  'update:expandedKeys': [keys: string[]];
+}
+interface MenuExpose {
+  showOption: (key: string) => void;
+  menuRef: Ref<MenuInst | null>;
+}
+//#endregion
+//#region src/components/C_Menu/index.vue.d.ts
+declare const __VLS_export: vue.DefineComponent<MenuProps, {
+  showOption: (key: string) => void | undefined;
+  menuRef: vue.Ref<{
+    showOption: (key?: naive_ui_es_menu_src_interface0.Key) => void;
+    deriveResponsiveState: () => void;
+  } | null, MenuInst | {
+    showOption: (key?: naive_ui_es_menu_src_interface0.Key) => void;
+    deriveResponsiveState: () => void;
+  } | null>;
+}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
+  "update:modelValue": (key: MenuValue) => any;
+  select: (key: string) => any;
+  "update:value": (key: MenuValue) => any;
+  "update:expandedKeys": (keys: string[]) => any;
+}, string, vue.PublicProps, Readonly<MenuProps> & Readonly<{
+  "onUpdate:modelValue"?: ((key: MenuValue) => any) | undefined;
+  onSelect?: ((key: string) => any) | undefined;
+  "onUpdate:value"?: ((key: MenuValue) => any) | undefined;
+  "onUpdate:expandedKeys"?: ((keys: string[]) => any) | undefined;
+}>, {
+  mode: "vertical" | "horizontal";
+  defaultExpandedKeys: string[];
+  collapsed: boolean;
+  collapsedWidth: number;
+  collapsedIconSize: number;
+  inverted: boolean;
+  indent: number;
+  rootIndent: number;
+  dropdownProps: naive_ui0.DropdownProps;
+}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+//#endregion
+export { MenuValue as a, flattenRoutes as c, MenuProps as i, MenuEmits as n, MenuAdapterConfig as o, MenuExpose as r, createMenuOptions as s, _default as t };

package/dist/index5.vue.d.ts

@@ -1,4 +1,4 @@
-import { i as BreadcrumbItem } from "./menuAdapter.js";
+import { i as BreadcrumbItem } from "./public.js";
 import * as vue from "vue";
 
 //#region src/components/C_Breadcrumb/index.vue.d.ts
@@ -26,5 +26,4 @@ declare const __VLS_export: vue.DefineComponent<__VLS_Props, {}, {}, {}, {}, vue
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 //#endregion
-export { _default as t };
-//# sourceMappingURL=index5.vue.d.ts.map
+export { _default as t };

package/dist/index6.vue.d.cts

@@ -0,0 +1,29 @@
+import { t as BreadcrumbItem } from "./types.cjs";
+import * as vue from "vue";
+
+//#region src/components/C_Breadcrumb/index.vue.d.ts
+type __VLS_Props = {
+  /**
+   * 手动传入面包屑数据
+   * 不传时自动从 `route.matched` 生成（零配置）
+   */
+  items?: BreadcrumbItem[]; /** 是否显示图标 */
+  showIcon?: boolean; /** 图标大小 (px)，默认 16 */
+  iconSize?: number;
+  /**
+   * 标签文本格式化函数（用于 i18n）
+   * 仅在自动模式下生效
+   */
+  labelFormatter?: (label: string) => string;
+};
+declare const __VLS_export: vue.DefineComponent<__VLS_Props, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
+  select: (path: string) => any;
+}, string, vue.PublicProps, Readonly<__VLS_Props> & Readonly<{
+  onSelect?: ((path: string) => any) | undefined;
+}>, {
+  showIcon: boolean;
+  iconSize: number;
+}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+//#endregion
+export { _default as t };

package/dist/index6.vue.d.ts

@@ -1,45 +1,32 @@
 import * as vue from "vue";
 
-//#region src/components/C_Captcha/index.vue.d.ts
-interface CaptchaProps {
-  triggerText?: string;
-  images?: string[];
-  disabled?: boolean;
-  theme?: "light" | "dark";
+//#region src/components/C_Cascade/types.d.ts
+interface CascadeItem {
+  label: string;
+  value: string | number;
+  children?: CascadeItem[];
 }
-declare const __VLS_export: vue.DefineComponent<CaptchaProps, {
-  validate: () => boolean;
-  getToken: () => string;
-  getVerificationData: () => {
-    token: string;
-    timestamp: number;
-    type: string;
-  } | null;
-  reset: () => void;
-  show: () => void;
-}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
-  change: (valid: boolean) => any;
-  reset: () => any;
-  success: (data: {
-    token: string;
-    timestamp: number;
-  }) => any;
-  fail: (error: string) => any;
-}, string, vue.PublicProps, Readonly<CaptchaProps> & Readonly<{
-  onChange?: ((valid: boolean) => any) | undefined;
-  onReset?: (() => any) | undefined;
-  onSuccess?: ((data: {
-    token: string;
-    timestamp: number;
-  }) => any) | undefined;
-  onFail?: ((error: string) => any) | undefined;
+interface CascadeValue {
+  primary?: Pick<CascadeItem, 'label' | 'value'> | null;
+  secondary?: Pick<CascadeItem, 'label' | 'value'> | null;
+  tertiary?: Pick<CascadeItem, 'label' | 'value'> | null;
+}
+//#endregion
+//#region src/components/C_Cascade/index.vue.d.ts
+type __VLS_Props = {
+  data: CascadeItem[];
+  placeholders?: string[];
+  modelValue?: CascadeValue;
+};
+declare const __VLS_export: vue.DefineComponent<__VLS_Props, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
+  "update:modelValue": (value: CascadeValue) => any;
+  change: (value: CascadeValue) => any;
+}, string, vue.PublicProps, Readonly<__VLS_Props> & Readonly<{
+  "onUpdate:modelValue"?: ((value: CascadeValue) => any) | undefined;
+  onChange?: ((value: CascadeValue) => any) | undefined;
 }>, {
-  disabled: boolean;
-  theme: "light" | "dark";
-  triggerText: string;
-  images: string[];
+  placeholders: string[];
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 //#endregion
-export { _default as t };
-//# sourceMappingURL=index6.vue.d.ts.map
+export { CascadeItem as n, CascadeValue as r, _default as t };

package/dist/index7.vue.d.cts

@@ -0,0 +1,32 @@
+import * as vue from "vue";
+
+//#region src/components/C_Cascade/types.d.ts
+interface CascadeItem {
+  label: string;
+  value: string | number;
+  children?: CascadeItem[];
+}
+interface CascadeValue {
+  primary?: Pick<CascadeItem, 'label' | 'value'> | null;
+  secondary?: Pick<CascadeItem, 'label' | 'value'> | null;
+  tertiary?: Pick<CascadeItem, 'label' | 'value'> | null;
+}
+//#endregion
+//#region src/components/C_Cascade/index.vue.d.ts
+type __VLS_Props = {
+  data: CascadeItem[];
+  placeholders?: string[];
+  modelValue?: CascadeValue;
+};
+declare const __VLS_export: vue.DefineComponent<__VLS_Props, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
+  "update:modelValue": (value: CascadeValue) => any;
+  change: (value: CascadeValue) => any;
+}, string, vue.PublicProps, Readonly<__VLS_Props> & Readonly<{
+  "onUpdate:modelValue"?: ((value: CascadeValue) => any) | undefined;
+  onChange?: ((value: CascadeValue) => any) | undefined;
+}>, {
+  placeholders: string[];
+}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+//#endregion
+export { CascadeItem as n, CascadeValue as r, _default as t };

package/dist/index7.vue.d.ts

@@ -1,33 +1,127 @@
 import * as vue from "vue";
 
-//#region src/components/C_Cascade/types.d.ts
-interface CascadeItem {
-  label: string;
-  value: string | number;
-  children?: CascadeItem[];
+//#region src/components/C_Chat/types.d.ts
+/**
+ * @Description: C_Chat 通用聊天组件 - 类型定义
+ */
+/** 消息类型 */
+type MessageType = 'text' | 'image' | 'file' | 'system';
+/** 消息发送方 */
+type MessageSender = 'self' | 'other' | 'system';
+/** 消息状态 */
+type MessageStatus = 'sending' | 'sent' | 'failed';
+/** 单条消息 */
+interface ChatMessage {
+  /** 唯一标识 */
+  id: string;
+  /** 消息内容（文本 / 图片 URL / 文件信息 JSON） */
+  content: string;
+  /** 消息类型 */
+  type: MessageType;
+  /** 发送方 */
+  sender: MessageSender;
+  /** 发送时间（ISO 字符串 或 时间戳） */
+  timestamp: string | number;
+  /** 发送者头像 URL */
+  avatar?: string;
+  /** 发送者用户名 */
+  username?: string;
+  /** 消息状态 */
+  status?: MessageStatus;
+  /** 文件名（type = 'file' 时使用） */
+  fileName?: string;
+  /** 文件大小（字节） */
+  fileSize?: number;
 }
-interface CascadeValue {
-  primary?: Pick<CascadeItem, 'label' | 'value'> | null;
-  secondary?: Pick<CascadeItem, 'label' | 'value'> | null;
-  tertiary?: Pick<CascadeItem, 'label' | 'value'> | null;
+/** 联系人 / 会话 */
+interface ChatContact {
+  /** 唯一标识 */
+  id: string;
+  /** 显示名称 */
+  name: string;
+  /** 头像 URL */
+  avatar?: string;
+  /** 最后一条消息摘要 */
+  lastMessage?: string;
+  /** 最后消息时间 */
+  lastTime?: string | number;
+  /** 未读数 */
+  unread?: number;
+  /** 是否在线 */
+  online?: boolean;
 }
+interface ChatProps {
+  /** 联系人列表 */
+  contacts?: ChatContact[];
+  /** 消息列表 */
+  messages?: ChatMessage[];
+  /** 当前选中的联系人 ID */
+  currentContactId?: string;
+  /** 输入框占位符 */
+  placeholder?: string;
+  /** 是否显示联系人侧栏 */
+  showContacts?: boolean;
+  /** 是否显示消息时间戳 */
+  showTimestamp?: boolean;
+  /** 当前用户头像 */
+  selfAvatar?: string;
+  /** 当前用户名 */
+  selfName?: string;
+  /** 是否显示发送按钮 */
+  showSendBtn?: boolean;
+  /** 是否正在加载历史消息 */
+  loadingHistory?: boolean;
+  /** 标题（无联系人模式时显示） */
+  title?: string;
+}
+declare const DEFAULT_CHAT_PROPS: Required<Pick<ChatProps, 'placeholder' | 'showContacts' | 'showTimestamp' | 'showSendBtn' | 'loadingHistory' | 'title'>>;
 //#endregion
-//#region src/components/C_Cascade/index.vue.d.ts
-type __VLS_Props = {
-  data: CascadeItem[];
-  placeholders?: string[];
-  modelValue?: CascadeValue;
+//#region src/components/C_Chat/index.vue.d.ts
+declare var __VLS_18: {}, __VLS_30: {};
+type __VLS_Slots = {} & {
+  header?: (props: typeof __VLS_18) => any;
+} & {
+  'input-actions'?: (props: typeof __VLS_30) => any;
 };
-declare const __VLS_export: vue.DefineComponent<__VLS_Props, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
-  change: (value: CascadeValue) => any;
-  "update:modelValue": (value: CascadeValue) => any;
-}, string, vue.PublicProps, Readonly<__VLS_Props> & Readonly<{
-  onChange?: ((value: CascadeValue) => any) | undefined;
-  "onUpdate:modelValue"?: ((value: CascadeValue) => any) | undefined;
+declare const __VLS_base: vue.DefineComponent<ChatProps, {
+  scrollToBottom: () => void;
+}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
+  send: (content: string) => any;
+  "select-contact": (id: string) => any;
+  "load-more": () => any;
+  "image-preview": (url: string) => any;
+  "file-click": (msg: ChatMessage) => any;
+  "file-upload": () => any;
+  "emoji-click": () => any;
+  resend: (msg: ChatMessage) => any;
+}, string, vue.PublicProps, Readonly<ChatProps> & Readonly<{
+  onSend?: ((content: string) => any) | undefined;
+  "onSelect-contact"?: ((id: string) => any) | undefined;
+  "onLoad-more"?: (() => any) | undefined;
+  "onImage-preview"?: ((url: string) => any) | undefined;
+  "onFile-click"?: ((msg: ChatMessage) => any) | undefined;
+  "onFile-upload"?: (() => any) | undefined;
+  "onEmoji-click"?: (() => any) | undefined;
+  onResend?: ((msg: ChatMessage) => any) | undefined;
 }>, {
-  placeholders: string[];
+  placeholder: string;
+  title: string;
+  messages: ChatMessage[];
+  showContacts: boolean;
+  showTimestamp: boolean;
+  showSendBtn: boolean;
+  loadingHistory: boolean;
+  contacts: ChatContact[];
+  currentContactId: string;
+  selfAvatar: string;
+  selfName: string;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
+type __VLS_WithSlots<T, S> = T & {
+  new (): {
+    $slots: S;
+  };
+};
 //#endregion
-export { CascadeItem as n, CascadeValue as r, _default as t };
-//# sourceMappingURL=index7.vue.d.ts.map
+export { DEFAULT_CHAT_PROPS as a, MessageType as c, ChatProps as i, ChatContact as n, MessageSender as o, ChatMessage as r, MessageStatus as s, _default as t };

package/dist/index8.vue.d.cts

@@ -0,0 +1,127 @@
+import * as vue from "vue";
+
+//#region src/components/C_Chat/types.d.ts
+/**
+ * @Description: C_Chat 通用聊天组件 - 类型定义
+ */
+/** 消息类型 */
+type MessageType = 'text' | 'image' | 'file' | 'system';
+/** 消息发送方 */
+type MessageSender = 'self' | 'other' | 'system';
+/** 消息状态 */
+type MessageStatus = 'sending' | 'sent' | 'failed';
+/** 单条消息 */
+interface ChatMessage {
+  /** 唯一标识 */
+  id: string;
+  /** 消息内容（文本 / 图片 URL / 文件信息 JSON） */
+  content: string;
+  /** 消息类型 */
+  type: MessageType;
+  /** 发送方 */
+  sender: MessageSender;
+  /** 发送时间（ISO 字符串 或 时间戳） */
+  timestamp: string | number;
+  /** 发送者头像 URL */
+  avatar?: string;
+  /** 发送者用户名 */
+  username?: string;
+  /** 消息状态 */
+  status?: MessageStatus;
+  /** 文件名（type = 'file' 时使用） */
+  fileName?: string;
+  /** 文件大小（字节） */
+  fileSize?: number;
+}
+/** 联系人 / 会话 */
+interface ChatContact {
+  /** 唯一标识 */
+  id: string;
+  /** 显示名称 */
+  name: string;
+  /** 头像 URL */
+  avatar?: string;
+  /** 最后一条消息摘要 */
+  lastMessage?: string;
+  /** 最后消息时间 */
+  lastTime?: string | number;
+  /** 未读数 */
+  unread?: number;
+  /** 是否在线 */
+  online?: boolean;
+}
+interface ChatProps {
+  /** 联系人列表 */
+  contacts?: ChatContact[];
+  /** 消息列表 */
+  messages?: ChatMessage[];
+  /** 当前选中的联系人 ID */
+  currentContactId?: string;
+  /** 输入框占位符 */
+  placeholder?: string;
+  /** 是否显示联系人侧栏 */
+  showContacts?: boolean;
+  /** 是否显示消息时间戳 */
+  showTimestamp?: boolean;
+  /** 当前用户头像 */
+  selfAvatar?: string;
+  /** 当前用户名 */
+  selfName?: string;
+  /** 是否显示发送按钮 */
+  showSendBtn?: boolean;
+  /** 是否正在加载历史消息 */
+  loadingHistory?: boolean;
+  /** 标题（无联系人模式时显示） */
+  title?: string;
+}
+declare const DEFAULT_CHAT_PROPS: Required<Pick<ChatProps, 'placeholder' | 'showContacts' | 'showTimestamp' | 'showSendBtn' | 'loadingHistory' | 'title'>>;
+//#endregion
+//#region src/components/C_Chat/index.vue.d.ts
+declare var __VLS_18: {}, __VLS_30: {};
+type __VLS_Slots = {} & {
+  header?: (props: typeof __VLS_18) => any;
+} & {
+  'input-actions'?: (props: typeof __VLS_30) => any;
+};
+declare const __VLS_base: vue.DefineComponent<ChatProps, {
+  scrollToBottom: () => void;
+}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
+  send: (content: string) => any;
+  "select-contact": (id: string) => any;
+  "load-more": () => any;
+  "image-preview": (url: string) => any;
+  "file-click": (msg: ChatMessage) => any;
+  "file-upload": () => any;
+  "emoji-click": () => any;
+  resend: (msg: ChatMessage) => any;
+}, string, vue.PublicProps, Readonly<ChatProps> & Readonly<{
+  onSend?: ((content: string) => any) | undefined;
+  "onSelect-contact"?: ((id: string) => any) | undefined;
+  "onLoad-more"?: (() => any) | undefined;
+  "onImage-preview"?: ((url: string) => any) | undefined;
+  "onFile-click"?: ((msg: ChatMessage) => any) | undefined;
+  "onFile-upload"?: (() => any) | undefined;
+  "onEmoji-click"?: (() => any) | undefined;
+  onResend?: ((msg: ChatMessage) => any) | undefined;
+}>, {
+  placeholder: string;
+  title: string;
+  messages: ChatMessage[];
+  showContacts: boolean;
+  showTimestamp: boolean;
+  showSendBtn: boolean;
+  loadingHistory: boolean;
+  contacts: ChatContact[];
+  currentContactId: string;
+  selfAvatar: string;
+  selfName: string;
+}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+type __VLS_WithSlots<T, S> = T & {
+  new (): {
+    $slots: S;
+  };
+};
+//#endregion
+export { DEFAULT_CHAT_PROPS as a, MessageType as c, ChatProps as i, ChatContact as n, MessageSender as o, ChatMessage as r, MessageStatus as s, _default as t };