@robot-admin/naive-ui-components 0.13.5 → 0.13.7

package/dist/index26.vue.d.cts

@@ -1,111 +1,96 @@
+import { i as TagItem } from "./types.cjs";
 import * as vue from "vue";
+import { Ref } from "vue";
 
-//#region src/components/C_Timeline/types.d.ts
+//#region src/components/C_TagsView/useTagsView.d.ts
+interface UseTagsViewOptions {
+  /** localStorage 持久化 key，传空字符串则不持久化 */
+  persistKey?: string;
+  /** 首页路径，用于 removeAll 后的回退 */
+  homePath?: string;
+}
 /**
- * @Description: 时间线组件类型定义
+ * 标签页管理 composable
+ *
+ * 独立于组件使用 — 可在任何地方管理标签状态
+ *
+ * @example 独立使用
+ * ```ts
+ * const tags = useTagsView({ persistKey: 'my-tags' })
+ * tags.addTag({ path: '/home', title: '首页', meta: { affix: true } })
+ * ```
  */
-/** 单条时间线节点 */
-interface TimelineItem {
-  /** 唯一标识 */
-  id: string | number;
-  /** 标题 */
-  title: string;
-  /** 描述内容（支持 HTML 字符串） */
-  content?: string;
-  /** 时间标签 */
-  time?: string;
-  /** 节点颜色（CSS 颜色值） */
-  color?: string;
-  /** 节点图标（Iconify 图标名） */
-  icon?: string;
-  /** 节点状态 */
-  status?: 'default' | 'success' | 'warning' | 'error' | 'info';
-  /** 是否可展开/折叠详情 */
-  collapsible?: boolean;
-  /** 初始是否展开 */
-  defaultExpanded?: boolean;
-  /** 附加标签组 */
-  tags?: Array<{
-    text: string;
-    type?: string;
-  }>;
-  /** 自定义额外数据 */
-  extra?: Record<string, unknown>;
-}
-/** 组件 Props */
-interface TimelineProps {
-  /** 时间线数据 */
-  items: TimelineItem[];
-  /** 布局方向 */
-  mode?: 'vertical' | 'horizontal';
-  /** 垂直模式下时间标签位置 */
-  labelPlacement?: 'left' | 'right' | 'alternate';
-  /** 是否显示尾部加载更多指示 */
-  pending?: boolean;
-  /** 加载更多文案 */
-  pendingText?: string;
-  /** 是否反转排列（最新在前） */
-  reverse?: boolean;
-  /** 节点大小 */
-  size?: 'small' | 'medium' | 'large';
-  /** 连接线样式 */
-  lineType?: 'solid' | 'dashed' | 'dotted';
-  /** 是否显示时间标签 */
-  showTime?: boolean;
-}
-/** 默认 Props */
-declare const DEFAULT_TIMELINE_PROPS: {
-  mode: "vertical";
-  labelPlacement: "right";
-  pending: boolean;
-  pendingText: string;
-  reverse: boolean;
-  size: "medium";
-  lineType: "solid";
-  showTime: boolean;
+declare function useTagsView(options?: UseTagsViewOptions): {
+  tagsViewList: Ref<TagItem[], TagItem[]>;
+  activeTag: Ref<string, string>;
+  homePath: string;
+  initTags: (tags?: TagItem[]) => void;
+  setActiveTag: (path: string) => void;
+  addTag: (tag: TagItem) => void;
+  removeTag: (index: number) => string | null;
+  removeOtherTags: (index: number) => void;
+  removeLeftTags: (index: number) => void;
+  removeRightTags: (index: number) => void;
+  removeAllTags: () => void;
 };
-/** 状态 → 颜色映射 */
-declare const STATUS_COLOR_MAP: Record<string, string>;
 //#endregion
-//#region src/components/C_Timeline/index.vue.d.ts
-declare var __VLS_1: {
-    item: TimelineItem;
-    index: number;
-  }, __VLS_8: {
-    item: TimelineItem;
-    index: number;
-  };
-type __VLS_Slots = {} & {
-  dot?: (props: typeof __VLS_1) => any;
-} & {
-  title?: (props: typeof __VLS_8) => any;
+//#region src/components/C_TagsView/types.d.ts
+interface ContextMenuLabels {
+  close?: string;
+  closeOthers?: string;
+  closeLeft?: string;
+  closeRight?: string;
+  closeAll?: string;
+}
+//#endregion
+//#region src/components/C_TagsView/index.vue.d.ts
+interface LegacyContextMenuLabels extends ContextMenuLabels {
+  close?: string;
+  closeOthers?: string;
+  closeLeft?: string;
+  closeRight?: string;
+  closeAll?: string;
+}
+type __VLS_Props = {
+  /**
+   * 标签文本格式化函数（用于 i18n）
+   */
+  labelFormatter?: (label: string) => string; /** 首页路径 */
+  homePath?: string; /** 首页标题（原始文本） */
+  homeTitle?: string; /** 首页图标 */
+  homeIcon?: string; /** 持久化 localStorage key，传空字符串禁用 */
+  persistKey?: string; /** 右键菜单文案（国际化适配） */
+  contextMenuLabels?: LegacyContextMenuLabels; /** useTagsView 配置项（优先级最高） */
+  tagsViewOptions?: UseTagsViewOptions;
 };
-declare const __VLS_base: vue.DefineComponent<TimelineProps, {
-  /** 展开全部 */expandAll: () => void; /** 折叠全部 */
-  collapseAll: () => void;
-}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
-  expand: (item: TimelineItem, expanded: boolean) => any;
-  "item-click": (item: TimelineItem, index: number) => any;
-}, string, vue.PublicProps, Readonly<TimelineProps> & Readonly<{
-  onExpand?: ((item: TimelineItem, expanded: boolean) => any) | undefined;
-  "onItem-click"?: ((item: TimelineItem, index: number) => any) | undefined;
+declare const __VLS_export: vue.DefineComponent<__VLS_Props, {
+  /** useTagsView composable 实例 */tags: {
+    tagsViewList: vue.Ref<TagItem[], TagItem[]>;
+    activeTag: vue.Ref<string, string>;
+    homePath: string;
+    initTags: (tags?: TagItem[]) => void;
+    setActiveTag: (path: string) => void;
+    addTag: (tag: TagItem) => void;
+    removeTag: (index: number) => string | null;
+    removeOtherTags: (index: number) => void;
+    removeLeftTags: (index: number) => void;
+    removeRightTags: (index: number) => void;
+    removeAllTags: () => void;
+  }; /** 滚动到指定标签 */
+  scrollToTag: (path: string) => void;
+}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
+  close: (fallbackPath: string) => any;
+  closeAll: () => any;
+}, string, vue.PublicProps, Readonly<__VLS_Props> & Readonly<{
+  onClose?: ((fallbackPath: string) => any) | undefined;
+  onCloseAll?: (() => any) | undefined;
 }>, {
-  size: "small" | "medium" | "large";
-  reverse: boolean;
-  items: TimelineItem[];
-  mode: "vertical" | "horizontal";
-  labelPlacement: "left" | "right" | "alternate";
-  pending: boolean;
-  pendingText: string;
-  lineType: "solid" | "dashed" | "dotted";
-  showTime: boolean;
+  persistKey: string;
+  homePath: string;
+  homeTitle: string;
+  homeIcon: string;
+  contextMenuLabels: LegacyContextMenuLabels;
 }, {}, {}, {}, 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 { TimelineProps as a, TimelineItem as i, DEFAULT_TIMELINE_PROPS as n, STATUS_COLOR_MAP as r, _default as t };
+export { useTagsView as i, ContextMenuLabels as n, UseTagsViewOptions as r, _default as t };

package/dist/index26.vue.d.ts

@@ -1,111 +1,96 @@
+import { s as TagItem } from "./public.js";
 import * as vue from "vue";
+import { Ref } from "vue";
 
-//#region src/components/C_Timeline/types.d.ts
+//#region src/components/C_TagsView/useTagsView.d.ts
+interface UseTagsViewOptions {
+  /** localStorage 持久化 key，传空字符串则不持久化 */
+  persistKey?: string;
+  /** 首页路径，用于 removeAll 后的回退 */
+  homePath?: string;
+}
 /**
- * @Description: 时间线组件类型定义
+ * 标签页管理 composable
+ *
+ * 独立于组件使用 — 可在任何地方管理标签状态
+ *
+ * @example 独立使用
+ * ```ts
+ * const tags = useTagsView({ persistKey: 'my-tags' })
+ * tags.addTag({ path: '/home', title: '首页', meta: { affix: true } })
+ * ```
  */
-/** 单条时间线节点 */
-interface TimelineItem {
-  /** 唯一标识 */
-  id: string | number;
-  /** 标题 */
-  title: string;
-  /** 描述内容（支持 HTML 字符串） */
-  content?: string;
-  /** 时间标签 */
-  time?: string;
-  /** 节点颜色（CSS 颜色值） */
-  color?: string;
-  /** 节点图标（Iconify 图标名） */
-  icon?: string;
-  /** 节点状态 */
-  status?: 'default' | 'success' | 'warning' | 'error' | 'info';
-  /** 是否可展开/折叠详情 */
-  collapsible?: boolean;
-  /** 初始是否展开 */
-  defaultExpanded?: boolean;
-  /** 附加标签组 */
-  tags?: Array<{
-    text: string;
-    type?: string;
-  }>;
-  /** 自定义额外数据 */
-  extra?: Record<string, unknown>;
-}
-/** 组件 Props */
-interface TimelineProps {
-  /** 时间线数据 */
-  items: TimelineItem[];
-  /** 布局方向 */
-  mode?: 'vertical' | 'horizontal';
-  /** 垂直模式下时间标签位置 */
-  labelPlacement?: 'left' | 'right' | 'alternate';
-  /** 是否显示尾部加载更多指示 */
-  pending?: boolean;
-  /** 加载更多文案 */
-  pendingText?: string;
-  /** 是否反转排列（最新在前） */
-  reverse?: boolean;
-  /** 节点大小 */
-  size?: 'small' | 'medium' | 'large';
-  /** 连接线样式 */
-  lineType?: 'solid' | 'dashed' | 'dotted';
-  /** 是否显示时间标签 */
-  showTime?: boolean;
-}
-/** 默认 Props */
-declare const DEFAULT_TIMELINE_PROPS: {
-  mode: "vertical";
-  labelPlacement: "right";
-  pending: boolean;
-  pendingText: string;
-  reverse: boolean;
-  size: "medium";
-  lineType: "solid";
-  showTime: boolean;
+declare function useTagsView(options?: UseTagsViewOptions): {
+  tagsViewList: Ref<TagItem[], TagItem[]>;
+  activeTag: Ref<string, string>;
+  homePath: string;
+  initTags: (tags?: TagItem[]) => void;
+  setActiveTag: (path: string) => void;
+  addTag: (tag: TagItem) => void;
+  removeTag: (index: number) => string | null;
+  removeOtherTags: (index: number) => void;
+  removeLeftTags: (index: number) => void;
+  removeRightTags: (index: number) => void;
+  removeAllTags: () => void;
 };
-/** 状态 → 颜色映射 */
-declare const STATUS_COLOR_MAP: Record<string, string>;
 //#endregion
-//#region src/components/C_Timeline/index.vue.d.ts
-declare var __VLS_1: {
-    item: TimelineItem;
-    index: number;
-  }, __VLS_8: {
-    item: TimelineItem;
-    index: number;
-  };
-type __VLS_Slots = {} & {
-  dot?: (props: typeof __VLS_1) => any;
-} & {
-  title?: (props: typeof __VLS_8) => any;
+//#region src/components/C_TagsView/types.d.ts
+interface ContextMenuLabels {
+  close?: string;
+  closeOthers?: string;
+  closeLeft?: string;
+  closeRight?: string;
+  closeAll?: string;
+}
+//#endregion
+//#region src/components/C_TagsView/index.vue.d.ts
+interface LegacyContextMenuLabels extends ContextMenuLabels {
+  close?: string;
+  closeOthers?: string;
+  closeLeft?: string;
+  closeRight?: string;
+  closeAll?: string;
+}
+type __VLS_Props = {
+  /**
+   * 标签文本格式化函数（用于 i18n）
+   */
+  labelFormatter?: (label: string) => string; /** 首页路径 */
+  homePath?: string; /** 首页标题（原始文本） */
+  homeTitle?: string; /** 首页图标 */
+  homeIcon?: string; /** 持久化 localStorage key，传空字符串禁用 */
+  persistKey?: string; /** 右键菜单文案（国际化适配） */
+  contextMenuLabels?: LegacyContextMenuLabels; /** useTagsView 配置项（优先级最高） */
+  tagsViewOptions?: UseTagsViewOptions;
 };
-declare const __VLS_base: vue.DefineComponent<TimelineProps, {
-  /** 展开全部 */expandAll: () => void; /** 折叠全部 */
-  collapseAll: () => void;
-}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
-  expand: (item: TimelineItem, expanded: boolean) => any;
-  "item-click": (item: TimelineItem, index: number) => any;
-}, string, vue.PublicProps, Readonly<TimelineProps> & Readonly<{
-  onExpand?: ((item: TimelineItem, expanded: boolean) => any) | undefined;
-  "onItem-click"?: ((item: TimelineItem, index: number) => any) | undefined;
+declare const __VLS_export: vue.DefineComponent<__VLS_Props, {
+  /** useTagsView composable 实例 */tags: {
+    tagsViewList: vue.Ref<TagItem[], TagItem[]>;
+    activeTag: vue.Ref<string, string>;
+    homePath: string;
+    initTags: (tags?: TagItem[]) => void;
+    setActiveTag: (path: string) => void;
+    addTag: (tag: TagItem) => void;
+    removeTag: (index: number) => string | null;
+    removeOtherTags: (index: number) => void;
+    removeLeftTags: (index: number) => void;
+    removeRightTags: (index: number) => void;
+    removeAllTags: () => void;
+  }; /** 滚动到指定标签 */
+  scrollToTag: (path: string) => void;
+}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
+  close: (fallbackPath: string) => any;
+  closeAll: () => any;
+}, string, vue.PublicProps, Readonly<__VLS_Props> & Readonly<{
+  onClose?: ((fallbackPath: string) => any) | undefined;
+  onCloseAll?: (() => any) | undefined;
 }>, {
-  size: "small" | "medium" | "large";
-  reverse: boolean;
-  items: TimelineItem[];
-  mode: "vertical" | "horizontal";
-  labelPlacement: "left" | "right" | "alternate";
-  pending: boolean;
-  pendingText: string;
-  lineType: "solid" | "dashed" | "dotted";
-  showTime: boolean;
+  persistKey: string;
+  homePath: string;
+  homeTitle: string;
+  homeIcon: string;
+  contextMenuLabels: LegacyContextMenuLabels;
 }, {}, {}, {}, 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 { TimelineProps as a, TimelineItem as i, DEFAULT_TIMELINE_PROPS as n, STATUS_COLOR_MAP as r, _default as t };
+export { useTagsView as i, ContextMenuLabels as n, UseTagsViewOptions as r, _default as t };

package/dist/index27.vue.d.cts

@@ -1,80 +1,111 @@
 import * as vue from "vue";
 
-//#region src/components/C_Transfer/types.d.ts
+//#region src/components/C_Timeline/types.d.ts
 /**
- * @Description: 穿梭框组件类型定义
+ * @Description: 时间线组件类型定义
  */
-/** 穿梭框数据项 */
-interface TransferItem {
+/** 单条时间线节点 */
+interface TimelineItem {
   /** 唯一标识 */
-  key: string | number;
-  /** 显示标签 */
-  label: string;
-  /** 是否禁用 */
-  disabled?: boolean;
-  /** 分组名称 */
-  group?: string;
-  /** 描述信息（用于详细模式） */
-  description?: string;
-  /** 图标（Iconify） */
+  id: string | number;
+  /** 标题 */
+  title: string;
+  /** 描述内容（支持 HTML 字符串） */
+  content?: string;
+  /** 时间标签 */
+  time?: string;
+  /** 节点颜色（CSS 颜色值） */
+  color?: string;
+  /** 节点图标（Iconify 图标名） */
   icon?: string;
-  /** 额外数据 */
+  /** 节点状态 */
+  status?: 'default' | 'success' | 'warning' | 'error' | 'info';
+  /** 是否可展开/折叠详情 */
+  collapsible?: boolean;
+  /** 初始是否展开 */
+  defaultExpanded?: boolean;
+  /** 附加标签组 */
+  tags?: Array<{
+    text: string;
+    type?: string;
+  }>;
+  /** 自定义额外数据 */
   extra?: Record<string, unknown>;
 }
 /** 组件 Props */
-interface TransferProps {
-  /** 数据源 */
-  data: TransferItem[];
-  /** 右侧已选 key 列表 (v-model) */
-  modelValue: Array<string | number>;
-  /** 左右栏标题 */
-  titles?: [string, string];
-  /** 是否可搜索 */
-  filterable?: boolean;
-  /** 搜索占位符 */
-  filterPlaceholder?: string;
-  /** 自定义筛选函数 */
-  filterMethod?: (query: string, item: TransferItem) => boolean;
-  /** 是否显示全选复选框 */
-  showSelectAll?: boolean;
-  /** 左侧空状态描述 */
-  sourceEmptyText?: string;
-  /** 右侧空状态描述 */
-  targetEmptyText?: string;
-  /** 尺寸 */
+interface TimelineProps {
+  /** 时间线数据 */
+  items: TimelineItem[];
+  /** 布局方向 */
+  mode?: 'vertical' | 'horizontal';
+  /** 垂直模式下时间标签位置 */
+  labelPlacement?: 'left' | 'right' | 'alternate';
+  /** 是否显示尾部加载更多指示 */
+  pending?: boolean;
+  /** 加载更多文案 */
+  pendingText?: string;
+  /** 是否反转排列（最新在前） */
+  reverse?: boolean;
+  /** 节点大小 */
   size?: 'small' | 'medium' | 'large';
+  /** 连接线样式 */
+  lineType?: 'solid' | 'dashed' | 'dotted';
+  /** 是否显示时间标签 */
+  showTime?: boolean;
 }
 /** 默认 Props */
-declare const DEFAULT_TRANSFER_PROPS: Partial<TransferProps>;
+declare const DEFAULT_TIMELINE_PROPS: {
+  mode: "vertical";
+  labelPlacement: "right";
+  pending: boolean;
+  pendingText: string;
+  reverse: boolean;
+  size: "medium";
+  lineType: "solid";
+  showTime: boolean;
+};
+/** 状态 → 颜色映射 */
+declare const STATUS_COLOR_MAP: Record<string, string>;
 //#endregion
-//#region src/components/C_Transfer/index.vue.d.ts
-type __VLS_Props = {
-  data: TransferProps['data'];
-  modelValue: TransferProps['modelValue'];
-  titles?: TransferProps['titles'];
-  filterable?: boolean;
-  filterPlaceholder?: string;
-  filterMethod?: TransferProps['filterMethod'];
-  showSelectAll?: boolean;
-  sourceEmptyText?: string;
-  targetEmptyText?: string;
-  size?: TransferProps['size'];
+//#region src/components/C_Timeline/index.vue.d.ts
+declare var __VLS_1: {
+    item: TimelineItem;
+    index: number;
+  }, __VLS_8: {
+    item: TimelineItem;
+    index: number;
+  };
+type __VLS_Slots = {} & {
+  dot?: (props: typeof __VLS_1) => any;
+} & {
+  title?: (props: typeof __VLS_8) => any;
 };
-declare const __VLS_export: vue.DefineComponent<__VLS_Props, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
-  "update:modelValue": (value: (string | number)[]) => any;
-  change: (targetKeys: (string | number)[], direction: "left" | "right", moveKeys: (string | number)[]) => any;
-}, string, vue.PublicProps, Readonly<__VLS_Props> & Readonly<{
-  "onUpdate:modelValue"?: ((value: (string | number)[]) => any) | undefined;
-  onChange?: ((targetKeys: (string | number)[], direction: "left" | "right", moveKeys: (string | number)[]) => any) | undefined;
+declare const __VLS_base: vue.DefineComponent<TimelineProps, {
+  /** 展开全部 */expandAll: () => void; /** 折叠全部 */
+  collapseAll: () => void;
+}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
+  "item-click": (item: TimelineItem, index: number) => any;
+  expand: (item: TimelineItem, expanded: boolean) => any;
+}, string, vue.PublicProps, Readonly<TimelineProps> & Readonly<{
+  "onItem-click"?: ((item: TimelineItem, index: number) => any) | undefined;
+  onExpand?: ((item: TimelineItem, expanded: boolean) => any) | undefined;
 }>, {
-  titles: [string, string];
-  filterable: boolean;
-  filterPlaceholder: string;
-  showSelectAll: boolean;
-  sourceEmptyText: string;
-  targetEmptyText: string;
+  reverse: boolean;
   size: "small" | "medium" | "large";
+  items: TimelineItem[];
+  mode: "vertical" | "horizontal";
+  labelPlacement: "left" | "right" | "alternate";
+  pending: boolean;
+  pendingText: string;
+  lineType: "solid" | "dashed" | "dotted";
+  showTime: boolean;
 }, {}, {}, {}, 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 { TransferProps as i, DEFAULT_TRANSFER_PROPS as n, TransferItem as r, _default as t };
+export { TimelineProps as a, TimelineItem as i, DEFAULT_TIMELINE_PROPS as n, STATUS_COLOR_MAP as r, _default as t };