@quiteer/naive-extra 0.0.1

package/dist/components/layout/layout-parts/LayoutTransition.vue.d.ts

@@ -0,0 +1,58 @@
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+/**
+ * 通用布局过渡组件
+ *
+ * 为侧边栏、头部、底部、内容区域提供统一的进场/出场动画能力，
+ * 通过 `mode` 控制动画类型，适配宽度/高度/位移/透明等常见过渡。
+ *
+ * @param props.mode - 动画模式：'fade' | 'slide-x' | 'slide-y' | 'scale' | 'width' | 'height'
+ * @param props.duration - 过渡时长（毫秒），默认 250
+ * @param props.easing - 缓动函数，默认 cubic-bezier(0.25,0.46,0.45,0.94)
+ * @returns 无返回值（渲染一个 <Transition> 包裹的插槽）
+ *
+ * @example
+ * ```vue
+ * <LayoutTransition mode="width">
+ *   <AppSidebar v-if="showSider" />
+ * </LayoutTransition>
+ * ```
+ *
+ * @remarks
+ * - width/height 模式使用 scrollWidth/scrollHeight 进行展开动画，before-leave 固定当前尺寸避免抖动
+ * - slide-x/slide-y 使用 transform 与 opacity 联合过渡
+ * - scale 使用轻微缩放与透明度过渡
+ *
+ * @security
+ * - 仅修改元素内联样式；不涉及外部副作用
+ *
+ * @performance
+ * - 依赖浏览器原生过渡；时间复杂度与节点尺寸无关
+ */
+type __VLS_Props = {
+    mode?: 'fade' | 'slide-x' | 'slide-y' | 'scale' | 'width' | 'height';
+    duration?: number;
+    easing?: string;
+    appear?: boolean;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {}): any;
+    };
+    refs: {};
+    rootEl: any;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: DefineComponent<__VLS_Props, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    duration: number;
+    mode: "fade" | "slide-x" | "slide-y" | "scale" | "width" | "height";
+    easing: string;
+    appear: boolean;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/layout/props.d.ts

@@ -0,0 +1,35 @@
+import { MenuOption } from 'naive-ui';
+import { RouteRecordRaw } from 'vue-router';
+import { LayoutType } from './types';
+export type Props = Partial<{
+    /** @description 布局类型 */
+    type: LayoutType;
+    /** @description 是否显示边框 */
+    bordered: boolean;
+    /** @description 反色样式（Header/Sider/Footer/Menu） */
+    inverted: boolean;
+    /** @description 是否折叠侧边栏 */
+    isCollapsed: boolean;
+    /** @description 是否显示底部 */
+    showFooter: boolean;
+    /** @description 头部高度 */
+    headerHeight: number;
+    /** @description 底部高度 */
+    footerHeight: number;
+    /** @description 底部是否占满宽度 */
+    footerFull: boolean;
+    /** @description 侧边栏宽度 */
+    siderWidth: number;
+    /** @description 侧边栏混合模式的宽度 */
+    siderMixedWidth: number;
+    /** @description 折叠侧边栏宽度 */
+    collapsedWidth: number;
+    /** @description 当前激活的路由键 */
+    activeKey: string;
+    /** @description 菜单路由 */
+    menuOptions: MenuOption[];
+    /** @description 基础路由 */
+    baseRoutes: RouteRecordRaw[];
+    /** @description 是否开启手风琴模式 */
+    accordion: boolean;
+}>;

package/dist/components/layout/types.d.ts

@@ -0,0 +1,59 @@
+import { RouteRecordRedirectOption } from 'vue-router';
+/**
+ * 应用布局类型枚举（格式：[主要]-[侧边栏模式]-[菜单选项]）
+ * 用于动态切换页面整体结构，省略 "layout" 后缀以保持简洁
+ */
+export type LayoutType = 'side-menu' | 'side-menu/2' | 'side-mixed-menu' | 'side-group-menu' | 'top-menu' | 'top-menu/2' | 'top-group-menu/2' | 'top-mixed-menu/2' | 'blank';
+export interface RouteMeta {
+    /**
+     * 页面标题（用于 document.title 或 tab 标签）
+     */
+    title?: string;
+    /**
+     * 是否需要认证（true: 需登录，false: 免登录）
+     * @default true
+     */
+    requiresAuth?: boolean;
+    /**
+     * 所需权限（字符串数组或字符串）
+     */
+    permissions?: string | string[];
+    /**
+     * 所属角色（如 'admin', 'user'）
+     */
+    roles?: string[];
+    /**
+     * 是否在侧边栏菜单中显示
+     * @default false
+     */
+    hideMenu?: boolean;
+    /**
+     * 侧边栏菜单选中
+     * @default string
+     */
+    activeMenu?: RouteRecordRedirectOption;
+    /**
+     * 菜单图标（Iconify 格式，如 'mdi:home'）
+     */
+    icon?: string;
+    /**
+     * 使用的布局名称（如 'blank', 'main'）
+     */
+    layout?: LayoutType;
+    /**
+     * 是否开启 keep-alive 缓存
+     */
+    keepAlive?: boolean;
+    /**
+     * 页面过渡动画名
+     */
+    transition?: string;
+    /**
+     * 排序
+     */
+    order?: number;
+    /**
+     * 外链
+     */
+    href?: string;
+}

package/dist/components/layout/utils.d.ts

@@ -0,0 +1,97 @@
+import { MenuOption } from 'naive-ui';
+import { RendererNode, RendererElement } from 'vue';
+type AnyMenuOption = MenuOption & {
+    key?: string | number;
+    children?: AnyMenuOption[];
+    href?: string;
+};
+export declare function renderMenuLabel(option: AnyMenuOption): string | globalThis.VNode< RendererNode, RendererElement, {
+    [key: string]: any;
+}>;
+export declare function findNodeByKey(options: AnyMenuOption[], key: string | number): AnyMenuOption | null;
+export declare function findFirstLeaf(node: AnyMenuOption | null | undefined): AnyMenuOption | null;
+/** 解析 activeKey 对应的末端（叶子）key */
+export declare function resolveLeafKeyFromMenu(options: AnyMenuOption[], activeKey: string | number): string;
+/** 从子节点 key 解析顶层父级 key */
+export declare function resolveTopParentKeyFromMenu(options: AnyMenuOption[], childKey: string | number): string;
+export declare function isTopLevelKey(options: AnyMenuOption[], key: string | number): boolean;
+export declare function isLeafKey(options: AnyMenuOption[], key: string | number): boolean;
+/**
+ * 从 activeKey 解析出主菜单与子菜单的键
+ *
+ * 解析传入的活跃键在菜单树中的位置，并分别返回顶层父级的 key（主菜单）
+ * 与该分支上的末端叶子 key（子菜单）。
+ *
+ * @param options - 菜单树，需包含 `key` 与可选的 `children`
+ * @param activeKey - 当前激活的菜单键（路径）
+ * @returns 返回对象 `{ mainKey, subKey }`，可能为 `null` 值
+ * @throws {TypeError} 当 `options` 非数组或 `activeKey` 非字符串/数字时在编译期提示
+ *
+ * @example
+ * ```ts
+ * const { mainKey, subKey } = resolveMainSubFromActive(menuOptions, '/dashboard/analysis')
+ * ```
+ *
+ * @remarks
+ * - mainKey 与 subKey 均进行字符串化处理，确保比较与 includes 一致性
+ *
+ * @security
+ * - 纯函数，无副作用
+ *
+ * @performance
+ * - O(n) 遍历一次菜单树
+ */
+export declare function resolveMainSubFromActive(options: AnyMenuOption[], activeKey: string | number): {
+    mainKey: string | null;
+    subKey: string | null;
+};
+/**
+ * 合并主/子菜单键为最终 activeKey
+ *
+ * 当存在子菜单键时优先返回子菜单键；否则返回主菜单分支上的第一个叶子键，
+ * 若主菜单键也不存在则返回 `null`。
+ *
+ * @param options - 菜单树，需包含 `key` 与可选的 `children`
+ * @param mainKey - 顶层父级 key（主菜单）
+ * @param subKey - 末端叶子 key（子菜单）
+ * @returns 最终用于路由跳转的 activeKey（字符串）或 `null`
+ * @throws {TypeError} 当参数类型不符合预期在编译期提示
+ *
+ * @example
+ * ```ts
+ * const active = resolveActiveKeyFromPair(menuOptions, '/dashboard', '/dashboard/analysis')
+ * ```
+ *
+ * @remarks
+ * - 若 `subKey` 不存在，将尝试从 `mainKey` 分支解析第一个叶子以保证跳转到可达页面
+ *
+ * @security
+ * - 纯函数，无副作用
+ *
+ * @performance
+ * - O(n)（在需要从 `mainKey` 分支解析叶子时）
+ */
+export declare function resolveActiveKeyFromPair(options: AnyMenuOption[], mainKey: string | number | null | undefined, subKey: string | number | null | undefined): string | null;
+/**
+ * 递归更新菜单树的每个节点
+ *
+ * 对传入的菜单树做一次深度遍历，并对每个节点应用 `updater`，返回新的树结构。
+ * 该方法默认以不可变方式工作：不会修改原始节点引用，而是为每个节点创建浅拷贝并递归重建 children。
+ *
+ * @param options - 菜单树数组（MenuOption[]），允许为空数组
+ * @param updater - 节点更新函数，接收当前节点并返回更新后的节点
+ * @returns 新的菜单树数组（保持树形结构）
+ *
+ * @throws {TypeError} 当 updater 不是函数时抛出
+ *
+ * @example
+ * ```ts
+ * const next = updateMenuTree(menuOptions, (item) => {
+ *   if (typeof item.key === 'string')
+ *     return { ...item, key: item.key.replace('/old', '/new') }
+ *   return item
+ * })
+ * ```
+ */
+export declare function updateMenuTree(options: AnyMenuOption[], updater: (item: AnyMenuOption) => AnyMenuOption): AnyMenuOption[];
+export {};

package/dist/components/provider/index.d.ts

@@ -0,0 +1,3 @@
+import { default as QuiProvider } from './index.vue';
+export { QuiProvider };
+export type { ProviderProps } from './props';

package/dist/components/provider/index.vue.d.ts

@@ -0,0 +1,19 @@
+import { ProviderProps } from './props';
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {}): any;
+    };
+    refs: {};
+    rootEl: any;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: DefineComponent<ProviderProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<ProviderProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/provider/props.d.ts

@@ -0,0 +1,33 @@
+import { ConfigProviderProps, DialogProviderProps, LoadingBarProviderProps, MessageProviderProps, NotificationProviderProps } from 'naive-ui';
+import { NaiveExtraThemeConfig } from '../../const';
+export interface ProviderProps {
+    /**
+     * NaiveExtra 主题配置
+     */
+    config?: NaiveExtraThemeConfig;
+    /**
+     * Config Provider Props
+     * 透传 NConfigProvider 的所有属性 (优先级高于 config)
+     */
+    configProviderProps?: ConfigProviderProps;
+    /**
+     * Loading Bar Provider Props
+     * 透传 NLoadingBarProvider 的所有属性
+     */
+    loadingBarProviderProps?: LoadingBarProviderProps;
+    /**
+     * Dialog Provider Props
+     * 透传 NDialogProvider 的所有属性
+     */
+    dialogProviderProps?: DialogProviderProps;
+    /**
+     * Notification Provider Props
+     * 透传 NNotificationProvider 的所有属性
+     */
+    notificationProviderProps?: NotificationProviderProps;
+    /**
+     * Message Provider Props
+     * 透传 NMessageProvider 的所有属性
+     */
+    messageProviderProps?: MessageProviderProps;
+}

package/dist/components/search-bar/index.d.ts

@@ -0,0 +1,3 @@
+import { default as QuiSearchBar } from './index.vue';
+export { QuiSearchBar };
+export type { Props as SearchBarProps } from './props';