@huyooo/ui 0.10.3 → 0.10.7

package/dist/components/User/UserPanel.vue.d.ts

@@ -1,216 +1,41 @@
-interface VisibleOptions {
-    messages?: boolean;
-    setting?: boolean;
-    subscription?: boolean;
-    feedBack?: boolean;
-    invitations?: boolean;
-    homePage?: boolean;
-    signOut?: boolean;
-}
 type __VLS_Props = {
     position?: "tl" | "tr" | "bl" | "br" | "top" | "bottom" | "left" | "right" | "lt" | "lb" | "rt" | "rb";
+    /** 下拉弹层 X 轴偏移（透传到 CSS 变量 --dropdown-translate-x） */
     dropdownOffsetX?: string;
+    /** 下拉弹层 Y 轴偏移（透传到 CSS 变量 --dropdown-translate-y） */
     dropdownOffsetY?: string;
-    /** 控制各个下拉选项的显示隐藏 */
-    visibleOptions?: VisibleOptions;
 };
 type __VLS_PublicProps = {
     modelValue?: boolean;
 } & __VLS_Props;
-declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-    signIn: (...args: any[]) => void;
-    signOut: (...args: any[]) => void;
-    toHomePage: (...args: any[]) => void;
-    "update:modelValue": (value: boolean) => void;
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        trigger?(_: {
+            user: import('../../user').UserProfileType | null;
+        }): any;
+        header?(_: {
+            user: import('../../user').UserProfileType | null;
+        }): any;
+        items?(_: {}): any;
+    };
+    refs: {};
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:modelValue": (value: boolean) => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
-    onSignIn?: ((...args: any[]) => any) | undefined;
-    onSignOut?: ((...args: any[]) => any) | undefined;
     "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
-    onToHomePage?: ((...args: any[]) => any) | undefined;
 }>, {
     position: "tl" | "tr" | "bl" | "br" | "top" | "bottom" | "left" | "right" | "lt" | "lb" | "rt" | "rb";
     dropdownOffsetX: string;
     dropdownOffsetY: string;
-    visibleOptions: VisibleOptions;
-}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
-    AuthModalRef: import('vue').CreateComponentPublicInstanceWithMixins<Readonly<import('vue').ExtractPropTypes<{
-        size: {
-            type: import('vue').PropType<import('../../authkit').FormSizeType>;
-            required: true;
-        };
-        appId: {
-            type: StringConstructor;
-            default: () => string;
-        };
-    }>> & Readonly<{
-        onConfirm?: ((...args: any[]) => any) | undefined;
-        onClose?: ((...args: any[]) => any) | undefined;
-        onToUserServiceAgreement?: ((...args: any[]) => any) | undefined;
-        onToPrivacyPolicy?: ((...args: any[]) => any) | undefined;
-    }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-        confirm: (...args: any[]) => void;
-        close: (...args: any[]) => void;
-        toUserServiceAgreement: (...args: any[]) => void;
-        toPrivacyPolicy: (...args: any[]) => void;
-    }, import('vue').PublicProps, {
-        appId: string;
-    }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
-        P: {};
-        B: {};
-        D: {};
-        C: {};
-        M: {};
-        Defaults: {};
-    }, Readonly<import('vue').ExtractPropTypes<{
-        size: {
-            type: import('vue').PropType<import('../../authkit').FormSizeType>;
-            required: true;
-        };
-        appId: {
-            type: StringConstructor;
-            default: () => string;
-        };
-    }>> & Readonly<{
-        onConfirm?: ((...args: any[]) => any) | undefined;
-        onClose?: ((...args: any[]) => any) | undefined;
-        onToUserServiceAgreement?: ((...args: any[]) => any) | undefined;
-        onToPrivacyPolicy?: ((...args: any[]) => any) | undefined;
-    }>, {}, {}, {}, {}, {
-        appId: string;
-    }> | null;
-    AppSettingRef: import('vue').CreateComponentPublicInstanceWithMixins<Readonly<{}> & Readonly<{
-        onConfirm?: ((...args: any[]) => any) | undefined;
-        onCancel?: ((...args: any[]) => any) | undefined;
-    }>, {
-        setData: (_data: unknown, state: false) => void;
-    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-        confirm: (...args: any[]) => void;
-        cancel: (...args: any[]) => void;
-    }, import('vue').PublicProps, {}, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
-        P: {};
-        B: {};
-        D: {};
-        C: {};
-        M: {};
-        Defaults: {};
-    }, Readonly<{}> & Readonly<{
-        onConfirm?: ((...args: any[]) => any) | undefined;
-        onCancel?: ((...args: any[]) => any) | undefined;
-    }>, {
-        setData: (_data: unknown, state: false) => void;
-    }, {}, {}, {}, {}> | null;
-    RefereesRef: import('vue').CreateComponentPublicInstanceWithMixins<Readonly<{}> & Readonly<{
-        onCancel?: ((...args: any[]) => any) | undefined;
-    }>, {
-        setData: (state: false) => void;
-    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-        cancel: (...args: any[]) => void;
-    }, import('vue').PublicProps, {}, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
-        P: {};
-        B: {};
-        D: {};
-        C: {};
-        M: {};
-        Defaults: {};
-    }, Readonly<{}> & Readonly<{
-        onCancel?: ((...args: any[]) => any) | undefined;
-    }>, {
-        setData: (state: false) => void;
-    }, {}, {}, {}, {}> | null;
-    SubscriptionsRef: import('vue').CreateComponentPublicInstanceWithMixins<Readonly<{}> & Readonly<{
-        onConfirm?: ((...args: any[]) => any) | undefined;
-        onCancel?: ((...args: any[]) => any) | undefined;
-    }>, {
-        setData: (_data: unknown, state: boolean) => void;
-    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-        confirm: (...args: any[]) => void;
-        cancel: (...args: any[]) => void;
-    }, import('vue').PublicProps, {}, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
-        P: {};
-        B: {};
-        D: {};
-        C: {};
-        M: {};
-        Defaults: {};
-    }, Readonly<{}> & Readonly<{
-        onConfirm?: ((...args: any[]) => any) | undefined;
-        onCancel?: ((...args: any[]) => any) | undefined;
-    }>, {
-        setData: (_data: unknown, state: boolean) => void;
-    }, {}, {}, {}, {}> | null;
-    MessageHandleRef: import('vue').CreateComponentPublicInstanceWithMixins<Readonly<{}> & Readonly<{}>, {
-        openNotification: () => void;
-    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, import('vue').PublicProps, {}, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {
-        MessageNotificationsRef: import('vue').CreateComponentPublicInstanceWithMixins<Readonly<import('vue').ExtractPropTypes<{
-            menus: {
-                type: import('vue').PropType<any[]>;
-                required: true;
-            };
-            selectedKeys: {
-                type: import('vue').PropType<string[]>;
-            };
-        }>> & Readonly<{
-            onCancel?: ((...args: any[]) => any) | undefined;
-            onChange?: ((...args: any[]) => any) | undefined;
-            "onUpdate:selectedKeys"?: ((value: string[]) => any) | undefined;
-        }>, {
-            setData: (state: false) => void;
-        }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-            cancel: (...args: any[]) => void;
-            change: (...args: any[]) => void;
-            "update:selectedKeys": (value: string[]) => void;
-        }, import('vue').PublicProps, {}, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
-            P: {};
-            B: {};
-            D: {};
-            C: {};
-            M: {};
-            Defaults: {};
-        }, Readonly<import('vue').ExtractPropTypes<{
-            menus: {
-                type: import('vue').PropType<any[]>;
-                required: true;
-            };
-            selectedKeys: {
-                type: import('vue').PropType<string[]>;
-            };
-        }>> & Readonly<{
-            onCancel?: ((...args: any[]) => any) | undefined;
-            onChange?: ((...args: any[]) => any) | undefined;
-            "onUpdate:selectedKeys"?: ((value: string[]) => any) | undefined;
-        }>, {
-            setData: (state: false) => void;
-        }, {}, {}, {}, {}> | null;
-    }, any, import('vue').ComponentProvideOptions, {
-        P: {};
-        B: {};
-        D: {};
-        C: {};
-        M: {};
-        Defaults: {};
-    }, Readonly<{}> & Readonly<{}>, {
-        openNotification: () => void;
-    }, {}, {}, {}, {}> | null;
-    FeedBackModalRef: import('vue').CreateComponentPublicInstanceWithMixins<Readonly<{}> & Readonly<{
-        onConfirm?: ((...args: any[]) => any) | undefined;
-        onCancel?: ((...args: any[]) => any) | undefined;
-    }>, {
-        setData: (state: boolean) => void;
-    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-        confirm: (...args: any[]) => void;
-        cancel: (...args: any[]) => void;
-    }, import('vue').PublicProps, {}, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
-        P: {};
-        B: {};
-        D: {};
-        C: {};
-        M: {};
-        Defaults: {};
-    }, Readonly<{}> & Readonly<{
-        onConfirm?: ((...args: any[]) => any) | undefined;
-        onCancel?: ((...args: any[]) => any) | undefined;
-    }>, {
-        setData: (state: boolean) => void;
-    }, {}, {}, {}, {}> | null;
-}, HTMLDivElement>;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+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/User/UserPanelItem.vue.d.ts

@@ -0,0 +1,38 @@
+type __VLS_Props = {
+    /** 唯一值，传给 Doption（用于 Arco Dropdown 内部识别），不显式传也可工作 */
+    value?: string;
+    /** iconify 图标名，例如 lucide:settings */
+    icon?: string;
+    /** 危险态（红色），常用于退出登录 */
+    danger?: boolean;
+    /** 禁用态 */
+    disabled?: boolean;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        icon?(_: {}): any;
+        default?(_: {}): any;
+        suffix?(_: {}): any;
+    };
+    refs: {};
+    rootEl: any;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    click: (event: MouseEvent) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onClick?: ((event: MouseEvent) => any) | undefined;
+}>, {
+    disabled: boolean;
+    value: string;
+    icon: string;
+    danger: boolean;
+}, {}, {}, {}, string, import('vue').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/composables/Authkit/useAuthkitAuth.d.ts

@@ -1,11 +1,35 @@
-declare function handleOAuthCallback(): boolean;
-declare function initializeAuth(): boolean;
+/**
+ * 登录成功后触发的数据负载
+ * - signIn 成功：来自接口返回的 data
+ * - OAuth 回调成功：来自 URL 参数 + token
+ */
+export interface SignInResult {
+    jwtToken: string;
+    userId?: string | null;
+    appId?: string | null;
+    /** 接口返回的其他字段透传 */
+    [key: string]: unknown;
+}
+type SignInListener = (data: SignInResult) => void | Promise<void>;
+type VoidListener = () => void | Promise<void>;
+type Cleanup = () => void;
+/**
+ * 恢复一次会话：先尝试 OAuth 回调（一次性），再尝试 localStorage token。
+ * 任一路径成功返回 true，宿主据此判断是否需要拉取 userProfile。
+ */
+declare function restoreSession(): boolean;
 declare function getToken(): string | null;
 declare function setToken(token: string): void;
+/** 清除 token 并广播 onSignOut（让所有订阅者集中清理依赖 token 的状态） */
 declare function clearAuth(): void;
-declare function addSignInCallback(cb: (data: any) => void): void;
-declare function addSignUpCallback(cb: () => void): void;
-declare function addResetPasswordCallback(cb: () => void): void;
+/** 注册登录成功监听，返回 cleanup */
+declare function onSignIn(listener: SignInListener): Cleanup;
+/** 注册注册成功监听，返回 cleanup */
+declare function onSignUp(listener: VoidListener): Cleanup;
+/** 注册重置密码成功监听，返回 cleanup */
+declare function onResetPassword(listener: VoidListener): Cleanup;
+/** 注册登出监听，返回 cleanup */
+declare function onSignOut(listener: VoidListener): Cleanup;
 export declare function useAuthkitAuth(): {
     signInSubmit: (state: {
         email: string;
@@ -31,14 +55,14 @@ export declare function useAuthkitAuth(): {
     switchSignUp: () => void;
     switchResetPassword: () => void;
     switchSignIn: () => void;
-    addSignInCallback: typeof addSignInCallback;
-    addSignUpCallback: typeof addSignUpCallback;
-    addResetPasswordCallback: typeof addResetPasswordCallback;
+    onSignIn: typeof onSignIn;
+    onSignUp: typeof onSignUp;
+    onResetPassword: typeof onResetPassword;
+    onSignOut: typeof onSignOut;
     jwtToken: Readonly<import('vue').Ref<string | null, string | null>>;
     getToken: typeof getToken;
     setToken: typeof setToken;
-    initializeAuth: typeof initializeAuth;
+    restoreSession: typeof restoreSession;
     clearAuth: typeof clearAuth;
-    handleOAuthCallback: typeof handleOAuthCallback;
 };
 export {};

package/dist/composables/Authkit/useAuthkitAuthModal.d.ts

@@ -1,3 +1,22 @@
-export declare function useAuthkitAuthModal(): {
-    show: import('vue').Ref<boolean, boolean>;
-};
+import { ComputedRef } from 'vue';
+export type AuthModalView = "signIn" | "signUp" | "resetPassword";
+export interface OpenAuthModalOptions {
+    /** 打开时切换到指定视图，缺省保持当前视图 */
+    view?: AuthModalView;
+}
+export interface UseAuthkitAuthModalReturn {
+    /** 打开弹窗，可选指定视图 */
+    open: (options?: OpenAuthModalOptions) => void;
+    /** 关闭弹窗 */
+    close: () => void;
+    /** 当前是否打开（只读响应式） */
+    isOpen: ComputedRef<boolean>;
+    /** 当前视图（只读响应式） */
+    view: ComputedRef<AuthModalView>;
+}
+/**
+ * 函数式 API：通过 open()/close() 控制全局唯一的认证弹窗。
+ * - open() 不改视图；open({ view: 'signUp' }) 切到注册
+ * - isOpen / view 仅暴露 readonly computed，禁止外部直接 mutate（用 open/close 维护状态机）
+ */
+export declare function useAuthkitAuthModal(): UseAuthkitAuthModalReturn;

package/dist/composables/Authkit/useLegalLinks.d.ts

@@ -0,0 +1,34 @@
+import { ComputedRef } from 'vue';
+import { LegalDocKey } from '../../utils/legalLinks';
+export interface LegalLink {
+    /** 后端字段 key（与 aboutUs 一致） */
+    key: LegalDocKey;
+    /** UI 展示文案 */
+    label: string;
+    /** 外链 URL（统一指向 ones 关于我们详情页） */
+    url: string;
+    /** 后端是否配置了内容（content 非空） */
+    configured: boolean;
+    /** 在新标签打开链接 */
+    open: () => void;
+}
+export interface UseLegalLinksReturn {
+    /** 所有法律文档（含未配置项） */
+    all: ComputedRef<LegalLink[]>;
+    /** 后端已配置的法律文档（用于直接渲染列表） */
+    items: ComputedRef<LegalLink[]>;
+    /** 取单个文档：返回完整 LegalLink 对象，用于读 URL / 自定义渲染 */
+    getLink: (key: LegalDocKey) => LegalLink | undefined;
+    /** 一行打开指定文档（最常用语法糖；未配置时静默 noop） */
+    openLegalLink: (key: LegalDocKey) => void;
+}
+/**
+ * 数据驱动的法律链接：
+ * - 来源：appsAuthPageInfo 接口返回的 aboutUs 配置
+ * - URL：统一指向 ones.huyooo.com/AboutUsDetails?type=xxx&appId=yyy
+ * - 渲染：消费者按需用 items（已配置的）渲染列表，或 getLink(key) 取单项
+ *
+ * 桌面端（Electron）调用 window.open 会被主进程拦截路由到默认浏览器，与 Web 行为一致，
+ * 因此库内不需要任何 openExternal 抽象。
+ */
+export declare function useLegalLinks(): UseLegalLinksReturn;

package/dist/composables/Authkit/useOauth.d.ts

@@ -17,5 +17,4 @@ export declare function useOauth(): {
     startOauth: typeof startOauth;
     getOauthCallbackUrl: typeof getOauthCallbackUrl;
 };
-export declare const useAuthkitOAuth: typeof useOauth;
 export {};

package/dist/composables.d.ts

@@ -1,5 +1,6 @@
-export { useAuthkitAuth } from './composables/Authkit/useAuthkitAuth';
-export { useAuthkitAuthModal } from './composables/Authkit/useAuthkitAuthModal';
+export { useAuthkitAuth, type SignInResult, } from './composables/Authkit/useAuthkitAuth';
+export { useAuthkitAuthModal, type AuthModalView, type OpenAuthModalOptions, type UseAuthkitAuthModalReturn, } from './composables/Authkit/useAuthkitAuthModal';
+export { useLegalLinks, type LegalLink, type UseLegalLinksReturn, } from './composables/Authkit/useLegalLinks';
 export { useAuthkitUsersProfile } from './composables/Authkit/useAuthkitUsersProfile';
 export { useAuthkitAppsAuthPageInfo } from './composables/Authkit/useAuthkitAppsAuthPageInfo';
 export { useAuthkitCreateAndUpdate } from './composables/Authkit/useAuthkitCreateAndUpdate';

package/dist/composables.js

@@ -1,36 +1,38 @@
-import { u as a, a as o } from "./useAuthkitUsersProfile-BqW74gfs.js";
-import { g as u, a as r, b as i, s as f, c as n, d as l, u as h } from "./apiClients-DJchWBAG.js";
-import { u as p } from "./useAuthkitAppsAuthPageInfo-C3EHOtlk.js";
-import { u as d } from "./useAuthkitCreateAndUpdate-CPkogY7K.js";
-import { u as x } from "./useMessageNotifications-SIM85vdb.js";
-import { u as C, a as c } from "./useDownloads-COXmopbe.js";
-import { u as k } from "./useTableHandle-CWu0LbeI.js";
-import { f as O, a as w, g as E, u as S, b as T, c as U, d as R, e as v, w as D } from "./useSEO-DeAU9YEc.js";
-import { u as y } from "./useUploadCos-BO3W_uqs.js";
+import { u as a, a as o } from "./useAuthkitUsersProfile-Cx8NXjlt.js";
+import { g as u, a as r, b as i, s as f, c as n, d as l, u as h } from "./apiClients-ANEApCyY.js";
+import { u as p } from "./useLegalLinks-BIF45kUt.js";
+import { u as g } from "./useAuthkitAppsAuthPageInfo-Da2yJTT-.js";
+import { u as x } from "./useAuthkitCreateAndUpdate-BLs5vQOu.js";
+import { u as C } from "./useMessageNotifications-CavBmgO7.js";
+import { u as k, a as P } from "./useDownloads-DT5W2af6.js";
+import { u as O } from "./useTableHandle--NSbZ-57.js";
+import { f as E, a as S, g as T, u as U, b as R, c as v, d as D, e as G, w as L } from "./useSEO-MPXQf0dn.js";
+import { u as H } from "./useUploadCos-D6y0INvP.js";
 export {
-  O as findActiveMenuPath,
-  w as findMenuPath,
-  E as getPathOnly,
+  E as findActiveMenuPath,
+  S as findMenuPath,
+  T as getPathOnly,
   u as globalConfig,
   r as globalSEOConfig,
   i as globalThemeRef,
   f as setGlobalConfig,
   n as setGlobalSEOConfig,
   l as setTheme,
-  S as useActiveDoc,
-  T as useAuthMenu,
-  p as useAuthkitAppsAuthPageInfo,
+  U as useActiveDoc,
+  R as useAuthMenu,
+  g as useAuthkitAppsAuthPageInfo,
   a as useAuthkitAuth,
   h as useAuthkitAuthModal,
-  d as useAuthkitCreateAndUpdate,
+  x as useAuthkitCreateAndUpdate,
   o as useAuthkitUsersProfile,
-  C as useCommonCreateAndUpdate,
-  c as useDownloads,
-  x as useMessageNotifications,
-  U as useRoutePermission,
-  R as useRouteSEO,
-  v as useSEO,
-  k as useTableHandle,
-  y as useUploadCos,
-  D as withViewTransition
+  k as useCommonCreateAndUpdate,
+  P as useDownloads,
+  p as useLegalLinks,
+  C as useMessageNotifications,
+  v as useRoutePermission,
+  D as useRouteSEO,
+  G as useSEO,
+  O as useTableHandle,
+  H as useUploadCos,
+  L as withViewTransition
 };