@robot-admin/naive-ui-components 0.17.6 → 0.18.0

package/dist/index24.vue.d.cts

@@ -1,19 +1,96 @@
+import { i as TagItem } from "./types.cjs";
 import * as vue from "vue";
+import { Ref } from "vue";
 
-//#region src/components/C_Theme/types.d.ts
-type ThemeMode = 'system' | 'light' | 'dark';
+//#region src/components/C_TagsView/useTagsView.d.ts
+interface UseTagsViewOptions {
+  /** localStorage 持久化 key，传空字符串则不持久化 */
+  persistKey?: string;
+  /** 首页路径，用于 removeAll 后的回退 */
+  homePath?: string;
+}
+/**
+ * 标签页管理 composable
+ *
+ * 独立于组件使用 — 可在任何地方管理标签状态
+ *
+ * @example 独立使用
+ * ```ts
+ * const tags = useTagsView({ persistKey: 'my-tags' })
+ * tags.addTag({ path: '/home', title: '首页', meta: { affix: true } })
+ * ```
+ */
+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;
+};
+//#endregion
+//#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_Theme/index.vue.d.ts
+//#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 = {
-  modelValue?: ThemeMode;
+  /**
+   * 标签文本格式化函数（用于 i18n）
+   */
+  labelFormatter?: (label: string) => string; /** 首页路径 */
+  homePath?: string; /** 首页标题（原始文本） */
+  homeTitle?: string; /** 首页图标 */
+  homeIcon?: string; /** 持久化 localStorage key，传空字符串禁用 */
+  persistKey?: string; /** 右键菜单文案（国际化适配） */
+  contextMenuLabels?: LegacyContextMenuLabels; /** useTagsView 配置项（优先级最高） */
+  tagsViewOptions?: UseTagsViewOptions;
 };
-declare const __VLS_export: vue.DefineComponent<__VLS_Props, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
-  "update:modelValue": (mode: ThemeMode) => any;
+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<{
-  "onUpdate:modelValue"?: ((mode: ThemeMode) => any) | undefined;
+  onClose?: ((fallbackPath: string) => any) | undefined;
+  onCloseAll?: (() => any) | undefined;
 }>, {
-  modelValue: ThemeMode;
+  persistKey: string;
+  homePath: string;
+  homeTitle: string;
+  homeIcon: string;
+  contextMenuLabels: LegacyContextMenuLabels;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 //#endregion
-export { ThemeMode as n, _default as t };
+export { useTagsView as i, ContextMenuLabels as n, UseTagsViewOptions as r, _default as t };

package/dist/index24.vue.d.ts

@@ -1,19 +1,96 @@
+import { s as TagItem } from "./public.js";
 import * as vue from "vue";
+import { Ref } from "vue";
 
-//#region src/components/C_Theme/types.d.ts
-type ThemeMode = 'system' | 'light' | 'dark';
+//#region src/components/C_TagsView/useTagsView.d.ts
+interface UseTagsViewOptions {
+  /** localStorage 持久化 key，传空字符串则不持久化 */
+  persistKey?: string;
+  /** 首页路径，用于 removeAll 后的回退 */
+  homePath?: string;
+}
+/**
+ * 标签页管理 composable
+ *
+ * 独立于组件使用 — 可在任何地方管理标签状态
+ *
+ * @example 独立使用
+ * ```ts
+ * const tags = useTagsView({ persistKey: 'my-tags' })
+ * tags.addTag({ path: '/home', title: '首页', meta: { affix: true } })
+ * ```
+ */
+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;
+};
+//#endregion
+//#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_Theme/index.vue.d.ts
+//#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 = {
-  modelValue?: ThemeMode;
+  /**
+   * 标签文本格式化函数（用于 i18n）
+   */
+  labelFormatter?: (label: string) => string; /** 首页路径 */
+  homePath?: string; /** 首页标题（原始文本） */
+  homeTitle?: string; /** 首页图标 */
+  homeIcon?: string; /** 持久化 localStorage key，传空字符串禁用 */
+  persistKey?: string; /** 右键菜单文案（国际化适配） */
+  contextMenuLabels?: LegacyContextMenuLabels; /** useTagsView 配置项（优先级最高） */
+  tagsViewOptions?: UseTagsViewOptions;
 };
-declare const __VLS_export: vue.DefineComponent<__VLS_Props, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
-  "update:modelValue": (mode: ThemeMode) => any;
+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<{
-  "onUpdate:modelValue"?: ((mode: ThemeMode) => any) | undefined;
+  onClose?: ((fallbackPath: string) => any) | undefined;
+  onCloseAll?: (() => any) | undefined;
 }>, {
-  modelValue: ThemeMode;
+  persistKey: string;
+  homePath: string;
+  homeTitle: string;
+  homeIcon: string;
+  contextMenuLabels: LegacyContextMenuLabels;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 //#endregion
-export { ThemeMode as n, _default as t };
+export { useTagsView as i, ContextMenuLabels as n, UseTagsViewOptions as r, _default as t };