@dt-frames/ui 3.0.1 → 4.0.1

package/dist/es/layout/src/components/tabbar/tabsView/ToolScreen.d.ts

@@ -0,0 +1,9 @@
+type __VLS_PublicProps = {
+    'screen'?: boolean;
+};
+declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:screen": (value: boolean) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    "onUpdate:screen"?: ((value: boolean) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/es/layout/src/components/tabbar/tabsView/ToolsMore.d.ts

@@ -0,0 +1,6 @@
+import { DropdownMenuItem } from './types';
+type __VLS_Props = {
+    menus: DropdownMenuItem[];
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/es/layout/src/components/tabbar/tabsView/types.d.ts

@@ -0,0 +1,68 @@
+import { RouteLocationNormalized } from 'vue-router';
+import { TabsStyleType } from '../../../types/perferences.type';
+import { RouteMeta } from '../../../types/route.type';
+export type EmitType = (name: string, ...args: any[]) => void;
+export interface TabDefinition extends RouteLocationNormalized {
+    key?: string;
+    meta: RouteMeta;
+}
+export type TabsEmits = {
+    close: [string];
+    sortTabs: [number, number];
+    unpin: [TabDefinition];
+};
+export type IContextMenuItem = {
+    disabled?: boolean;
+    handler: () => void;
+    icon?: string | object;
+    inset?: boolean;
+    key: string;
+    separator?: boolean;
+    shortcut?: string;
+    text: string;
+};
+export type TabsProps = {
+    active?: string;
+    contentClass?: string;
+    contextMenus?: (data: any) => IContextMenuItem[];
+    draggable?: boolean;
+    gap?: number;
+    maxWidth?: number;
+    middleClickToClose?: boolean;
+    minWidth?: number;
+    showIcon?: boolean;
+    styleType?: TabsStyleType;
+    tabs?: TabDefinition[];
+    wheelable?: boolean;
+};
+export interface TabConfig extends TabDefinition {
+    affixTab: boolean;
+    closable: boolean;
+    icon: string;
+    key: string;
+    title: string;
+}
+export type DropdownMenuItem = {
+    disabled?: boolean;
+    /**
+     * 点击事件处理
+     * @param data
+     */
+    handler: (data: any) => void;
+    /**
+     * 图标
+     */
+    icon?: string | object;
+    /**
+     * 标题
+     */
+    label: string;
+    /**
+     * 是否是分割线
+     */
+    separator?: boolean;
+    /**
+     * 唯一标识
+     */
+    value: string;
+};

package/dist/es/layout/src/const/constants.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 内容区域的组件ID
+ */
+export declare const ELEMENT_ID_MAIN_CONTENT = "__dt_main_content";
+/** layout content 组件的高度 */
+export declare const CSS_VARIABLE_LAYOUT_CONTENT_HEIGHT = "--dt-content-height";
+/** layout content 组件的宽度 */
+export declare const CSS_VARIABLE_LAYOUT_CONTENT_WIDTH = "--dt-content-width";
+/** layout header 组件的高度 */
+export declare const CSS_VARIABLE_LAYOUT_HEADER_HEIGHT = "--dt-header-height";
+/** layout footer 组件的高度 */
+export declare const CSS_VARIABLE_LAYOUT_FOOTER_HEIGHT = "--dt-footer-height";
+export declare const DEFAULT_NAMESPACE = "dt";

package/dist/es/layout/src/const/preferences.config.d.ts

@@ -0,0 +1,8 @@
+import { BuiltinThemePreset, Preferences } from '../types/perferences.type';
+declare const defaultPreferences: Preferences;
+declare const BUILT_IN_THEME_PRESETS: BuiltinThemePreset[];
+declare const PERFERENCES_TABS: {
+    label: string;
+    value: string;
+}[];
+export { defaultPreferences, BUILT_IN_THEME_PRESETS, PERFERENCES_TABS };

package/dist/es/layout/src/hooks/useContext.d.ts

@@ -0,0 +1,6 @@
+import { MenuProvider, SubMenuProvider } from '../components/menu/basic-menu/type';
+declare function createMenuContext(injectMenuData: MenuProvider): void;
+declare function useMenuContext(): MenuProvider;
+declare function createSubMenuContext(injectSubMenuData: SubMenuProvider): void;
+declare function useSubMenuContext(): SubMenuProvider;
+export { createMenuContext, useMenuContext, createSubMenuContext, useSubMenuContext };

package/dist/es/layout/src/hooks/useDesignTokens.d.ts

@@ -0,0 +1 @@
+export declare function useDesignTokens(): void;

package/dist/es/layout/src/hooks/useExtraMenu.d.ts

@@ -0,0 +1,12 @@
+import { ComputedRef } from 'vue';
+import { MenuRecordRaw } from '../types/menu.type';
+declare function useExtraMenu(useRootMenus?: ComputedRef<MenuRecordRaw[]>): {
+    extraActiveMenu: import('vue').Ref<string, string>;
+    extraMenus: ComputedRef;
+    handleDefaultSelect: (menu: MenuRecordRaw, rootMenu?: MenuRecordRaw) => Promise<void>;
+    handleMenuMouseEnter: (menu: MenuRecordRaw) => void;
+    handleMixedMenuSelect: (menu: MenuRecordRaw) => Promise<void>;
+    handleSideMouseLeave: () => void;
+    sidebarExtraVisible: import('vue').Ref<boolean, boolean>;
+};
+export { useExtraMenu };

package/dist/es/layout/src/hooks/useLayoutStyle.d.ts

@@ -0,0 +1,36 @@
+import { CSSProperties } from 'vue';
+export interface VisibleDomRect {
+    bottom: number;
+    height: number;
+    left: number;
+    right: number;
+    top: number;
+    width: number;
+}
+export declare function useLayoutContentStyle(): {
+    contentElement: import('vue').Ref<HTMLDivElement | null, HTMLDivElement | null>;
+    overlayStyle: import('vue').ComputedRef<CSSProperties>;
+    visibleDomRect: import('vue').Ref<{
+        bottom: number;
+        height: number;
+        left: number;
+        right: number;
+        top: number;
+        width: number;
+    } | null, VisibleDomRect | {
+        bottom: number;
+        height: number;
+        left: number;
+        right: number;
+        top: number;
+        width: number;
+    } | null>;
+};
+export declare function useLayoutHeaderStyle(): {
+    getLayoutHeaderHeight: () => number;
+    setLayoutHeaderHeight: (height: number) => void;
+};
+export declare function useLayoutFooterStyle(): {
+    getLayoutFooterHeight: () => number;
+    setLayoutFooterHeight: (height: number) => void;
+};

package/dist/es/layout/src/hooks/useMenu.d.ts

@@ -0,0 +1,4 @@
+declare function useMenu(): {
+    sidebarVisible: import('vue').ComputedRef<boolean | undefined>;
+};
+export { useMenu };

package/dist/es/layout/src/hooks/useMixedMenu.d.ts

@@ -0,0 +1,13 @@
+import { MenuRecordRaw } from '../types/menu.type';
+declare function useMixedMenu(): {
+    handleMenuSelect: (key: string, mode?: string) => void;
+    handleMenuOpen: (key: string, parentsPath: string[]) => void;
+    headerActive: import('vue').ComputedRef<string>;
+    headerMenus: import('vue').ComputedRef<MenuRecordRaw[]>;
+    sidebarActive: import('vue').ComputedRef<string>;
+    sidebarMenus: import('vue').ComputedRef<MenuRecordRaw[]>;
+    mixHeaderMenus: import('vue').ComputedRef<MenuRecordRaw[]>;
+    mixExtraMenus: import('vue').Ref<any[], any[]>;
+    sidebarVisible: import('vue').ComputedRef<boolean | undefined>;
+};
+export { useMixedMenu };

package/dist/es/layout/src/hooks/useNavigation.d.ts

@@ -0,0 +1,5 @@
+declare function useNavigation(): {
+    navigation: (path: string) => Promise<void>;
+    willOpenedByWindow: (path: string) => boolean;
+};
+export { useNavigation };

package/dist/es/layout/src/hooks/useTheme.d.ts

@@ -0,0 +1,34 @@
+export declare function useTheme(): {
+    theme: import('../..').Preferences;
+    savePreferences: (preference: import('../..').Preferences) => void;
+    initPreferences: (preference: import('../..').Preferences) => Promise<void>;
+    resetPreferences: () => void;
+    updatePreferences: (updates: import('../..').Preferences) => void;
+    initPlatform: () => void;
+    loadPreferences: () => import('../..').Preferences;
+    loadCachedPreferences: () => import('../..').Preferences | null;
+    handleUpdates: (updates: import('../..').Preferences) => void;
+    updateColorMode: (preference: import('../..').Preferences) => void;
+    useBasicLayout: (isUse?: boolean) => void;
+    currentLayout: import('vue').ComputedRef<import('../types/perferences.type').LayoutType | undefined>;
+    isFullContent: import('vue').ComputedRef<boolean>;
+    isSidebarMixedNav: import('vue').ComputedRef<boolean>;
+    isHeaderNav: import('vue').ComputedRef<boolean>;
+    isMixedNav: import('vue').ComputedRef<boolean>;
+    isHeaderMixedNav: import('vue').ComputedRef<boolean>;
+    keepAlive: import('vue').ComputedRef<boolean | undefined>;
+    themeButtonPosition: import('vue').ComputedRef<{
+        fixed: boolean;
+        header: boolean;
+    }>;
+    isDark: import('vue').ComputedRef<boolean>;
+    isSideMode: import('vue').ComputedRef<boolean>;
+    isSideNav: import('vue').ComputedRef<boolean>;
+    isHeaderSidebarNav: import('vue').ComputedRef<boolean>;
+    preferencesButtonPosition: import('vue').ComputedRef<{
+        fixed: boolean;
+        header: boolean;
+    }>;
+    contentIsMaximize: import('vue').ComputedRef<boolean | undefined>;
+    diffPreference: Partial<import('../..').Preferences>;
+};

package/dist/es/layout/src/index.d.ts

@@ -0,0 +1,28 @@
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: Partial<Record<string, (_: {}) => any>> & {
+        'logo-text'?(_: {}): any;
+        'logo-text'?(_: {}): any;
+        'user-dropdown'?(_: {}): any;
+        notification?(_: {}): any;
+        extra?(_: {}): any;
+        'lock-screen'?(_: {}): any;
+    };
+    refs: {};
+    rootEl: any;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    clearPreferencesAndLogout: () => any;
+    clickLogo: () => any;
+}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{
+    onClearPreferencesAndLogout?: (() => any) | undefined;
+    onClickLogo?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, 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/es/layout/src/layout.d.ts

@@ -0,0 +1,71 @@
+import { ThemeModeType } from './types/perferences.type';
+interface Props {
+    /**
+     * header 顶栏主题
+     */
+    headerTheme?: ThemeModeType;
+    /**
+     * 侧边栏
+     * @default dark
+     */
+    sidebarTheme?: ThemeModeType;
+}
+type __VLS_Props = Props;
+type __VLS_PublicProps = {
+    'sidebarCollapse'?: boolean;
+    'sidebarExtraVisible'?: boolean;
+    'sidebarExtraCollapse'?: boolean;
+    'sidebarExpandOnHover'?: boolean;
+    'sidebarEnable'?: boolean;
+} & __VLS_Props;
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        logo?(_: {}): any;
+        logo?(_: {}): any;
+        'mixed-menu'?(_: {}): any;
+        menu?(_: {}): any;
+        'side-extra'?(_: {}): any;
+        'side-extra-title'?(_: {}): any;
+        header?(_: {}): any;
+        tabbar?(_: {}): any;
+        content?(_: {}): any;
+        'content-overlay'?(_: {}): any;
+        footer?(_: {}): any;
+        extra?(_: {}): any;
+    };
+    refs: {
+        contentRef: HTMLDivElement;
+    };
+    rootEl: any;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    sideMouseLeave: () => any;
+    toggleSidebar: () => any;
+    "update:sidebarCollapse": (value: boolean) => any;
+    "update:sidebarExtraVisible": (value: boolean) => any;
+    "update:sidebarExtraCollapse": (value: boolean) => any;
+    "update:sidebarExpandOnHover": (value: boolean) => any;
+    "update:sidebarEnable": (value: boolean) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    onSideMouseLeave?: (() => any) | undefined;
+    onToggleSidebar?: (() => any) | undefined;
+    "onUpdate:sidebarCollapse"?: ((value: boolean) => any) | undefined;
+    "onUpdate:sidebarExtraVisible"?: ((value: boolean) => any) | undefined;
+    "onUpdate:sidebarExtraCollapse"?: ((value: boolean) => any) | undefined;
+    "onUpdate:sidebarExpandOnHover"?: ((value: boolean) => any) | undefined;
+    "onUpdate:sidebarEnable"?: ((value: boolean) => any) | undefined;
+}>, {
+    headerTheme: ThemeModeType;
+    sidebarTheme: ThemeModeType;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    contentRef: HTMLDivElement;
+}, 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/es/layout/src/stores/preferences.store.d.ts

@@ -0,0 +1,66 @@
+import { Preferences } from '../types/perferences.type';
+/**
+ * 深层递归所有属性为可选
+ */
+type PerferceState = {
+    initialPreferences: Preferences;
+    isInitialized: boolean;
+    state: Preferences;
+};
+export declare const useThemeStore: import('pinia').StoreDefinition<"dt-theme", PerferceState, {
+    theme(): Preferences;
+    diffPreference(): Partial<Preferences>;
+}, {
+    /**
+     * 避免频繁的操作缓存
+     */
+    savePreferences: (preference: Preferences) => void;
+    /**
+     * 覆盖偏好设置
+     * overrides  要覆盖的偏好设置
+     * namespace  命名空间
+     */
+    initPreferences(preference: Preferences): Promise<void>;
+    /**
+     * 重置偏好设置
+     * 偏好设置将被重置为初始值，并从 localStorage 中移除。
+     *
+     * @example
+     * 假设 initialPreferences 为 { theme: 'light', language: 'en' }
+     * 当前 state 为 { theme: 'dark', language: 'fr' }
+     * this.resetPreferences();
+     * 调用后，state 将被重置为 { theme: 'light', language: 'en' }
+     * 并且 localStorage 中的对应项将被移除
+     */
+    resetPreferences(): void;
+    /**
+     * 更新偏好设置
+     * @param updates - 要更新的偏好设置
+     */
+    updatePreferences(updates: Preferences): void;
+    isMacOs(): boolean;
+    /**
+     * 设置平台
+     */
+    initPlatform(): void;
+    /**
+     * 获取主题
+     */
+    loadPreferences(): Preferences;
+    /**
+     * 加载主题
+     */
+    loadCachedPreferences(): Preferences | null;
+    /**
+     * 处理更新的键值
+     * 根据更新的键值执行相应的操作。
+     * @param {DeepPartial<Preferences>} updates - 部分更新的偏好设置
+     */
+    handleUpdates(updates: Preferences): void;
+    /**
+     * 更新页面颜色模式（灰色、色弱）
+     * @param preference
+     */
+    updateColorMode(preference: Preferences): void;
+}>;
+export {};

package/dist/es/layout/src/stores/useTabbar.store.d.ts

@@ -0,0 +1,185 @@
+import { ComputedRef } from 'vue';
+import { RouteLocationNormalized, RouteRecordNormalized, Router } from 'vue-router';
+interface TabDefinition extends RouteLocationNormalized {
+    /**
+     * 标签页的key
+     */
+    key?: string;
+}
+type TabbarState = {
+    /**
+     * 当前打开的标签页列表缓存
+     */
+    cachedTabs: Set<string>;
+    /**
+     * 拖拽结束的索引
+     */
+    dragEndIndex: number;
+    /**
+     * 需要排除缓存的标签页
+     */
+    excludeCachedTabs: Set<string>;
+    /**
+     * 标签右键菜单列表
+     */
+    menuList: string[];
+    /**
+     * 是否刷新
+     */
+    renderRouteView?: boolean;
+    /**
+     * 当前打开的标签页列表
+     */
+    tabs: TabDefinition[];
+    /**
+     * 更新时间，用于一些更新场景，使用watch深度监听的话，会损耗性能
+     */
+    updateTime?: number;
+};
+export declare const useTabbarStore: import('pinia').StoreDefinition<"layout-tabs", TabbarState, {
+    affixTabs(): TabDefinition[];
+    getCachedTabs(): string[];
+    getExcludeCachedTabs(): string[];
+    getMenuList(): string[];
+    getTabs(): TabDefinition[];
+}, {
+    /**
+     * 根据key 批量关闭
+     * @param keys
+     */
+    _bulkCloseByKeys(keys: string[]): Promise<void>;
+    /**
+     * 关闭标签页
+     * @param tab
+     */
+    _close(tab: TabDefinition): void;
+    /**
+     * 跳转到默认标签页
+     */
+    _goToDefaultTab(router: Router): Promise<void>;
+    /**
+     * 跳转到标签页
+     * @param tab
+     * @param router
+     */
+    _goToTab(tab: TabDefinition, router: Router): Promise<void>;
+    /**
+     * 添加标签页
+     * @param routeTab
+     */
+    addTab(routeTab: TabDefinition): TabDefinition | undefined;
+    /**
+     * 关闭所有标签页
+     * @param router
+     */
+    closeAllTabs(router: Router): Promise<void>;
+    /**
+     * 关闭左侧标签页
+     * @param tab
+     */
+    closeLeftTabs(tab: TabDefinition): Promise<void>;
+    /**
+     * 关闭其他标签页
+     * @param tab
+     */
+    closeOtherTabs(tab: TabDefinition): Promise<void>;
+    /**
+     * 关闭右侧标签页
+     * @param tab
+     */
+    closeRightTabs(tab: TabDefinition): Promise<void>;
+    /**
+     * 关闭标签页
+     * @param tab
+     * @param router
+     */
+    closeTab(tab: TabDefinition, router: Router): Promise<void>;
+    /**
+     * 通过key关闭标签页
+     * @param key
+     * @param router
+     */
+    closeTabByKey(key: string, router: Router): Promise<void>;
+    /**
+     * 根据tab的key获取tab
+     * @param key
+     */
+    getTabByKey(key: string): TabDefinition;
+    /**
+     * 新窗口打开标签页
+     * @param tab
+     */
+    openTabInNewWindow(tab: TabDefinition): Promise<void>;
+    pinTab(tab: TabDefinition): Promise<void>;
+    /**
+     * 刷新标签页
+     * @param router
+     */
+    refresh(router: Router | string): Promise<void>;
+    /**
+     * 根据路由名称刷新指定标签页
+     * @param name
+     */
+    refreshByName(name: string): Promise<void>;
+    /**
+     * 重置标签页标题
+     * @param tab
+     */
+    resetTabTitle(tab: TabDefinition): Promise<void>;
+    /**
+     * 设置固定标签页
+     * @param tabs
+     */
+    setAffixTabs(tabs: RouteRecordNormalized[]): void;
+    /**
+     * 更新菜单列表
+     * @param list
+     */
+    setMenuList(list: string[]): void;
+    /**
+     * 设置标签页标题
+     *
+     * 支持设置静态标题字符串或计算属性作为动态标题
+     * 当标题为计算属性时,标题会随计算属性值变化而自动更新
+     * 适用于需要根据状态或多语言动态更新标题的场景
+     *
+     * @param {TabDefinition} tab - 标签页对象
+     * @param {ComputedRef<string> | string} title - 标题内容,支持静态字符串或计算属性
+     *
+     * @example
+     * // 设置静态标题
+     * setTabTitle(tab, '新标签页');
+     *
+     * @example
+     * // 设置动态标题
+     * setTabTitle(tab, computed(() => t('common.dashboard')));
+     */
+    setTabTitle(tab: TabDefinition, title: ComputedRef<string> | string): Promise<void>;
+    setUpdateTime(): void;
+    /**
+     * 设置标签页顺序
+     * @param oldIndex
+     * @param newIndex
+     */
+    sortTabs(oldIndex: number, newIndex: number): Promise<void>;
+    /**
+     * 切换固定标签页
+     * @param tab
+     */
+    toggleTabPin(tab: TabDefinition): Promise<void>;
+    /**
+     * 取消固定标签页
+     * @param tab
+     */
+    unpinTab(tab: TabDefinition): Promise<void>;
+    /**
+     * 根据当前打开的选项卡更新缓存
+     */
+    updateCacheTabs(): Promise<void>;
+}>;
+/**
+ * 从route获取tab页的key
+ * @param tab
+ */
+declare function getTabKey(tab: RouteLocationNormalized | RouteRecordNormalized): string;
+export { getTabKey };

package/dist/es/layout/src/types/basic.type.d.ts

@@ -0,0 +1,5 @@
+interface SelectOption {
+    label: string;
+    value: string;
+}
+export type { SelectOption };