artalk 2.8.7 → 2.9.0

package/dist/main.d.ts

@@ -1,3 +1,6 @@
+import { Marked } from 'marked';
+import { MarkedOptions } from 'marked';
+
 /**
  * 通用操作按钮
  */
@@ -92,10 +95,10 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
          })` Internal Server Error
          */
         loginByEmail: (data: HandlerRequestAuthEmailLogin, params?: RequestParams) => Promise<HttpResponse<HandlerResponseUserLogin, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
         /**
-         * @description Register by email and verify code (if user exists, will update user, like forget password. Need send email verify code first)
+         * @description Register by email and verify code (if user exists, will update user, like forget or change password. Need send email verify code first)
          *
          * @tags Auth
          * @name RegisterByEmail
@@ -112,7 +115,7 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
          })` Internal Server Error
          */
         registerByEmail: (data: HandlerRequestAuthEmailRegister, params?: RequestParams) => Promise<HttpResponse<HandlerResponseUserLogin, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
         /**
          * @description Send email including verify code to user
@@ -135,9 +138,9 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
          })` Internal Server Error
          */
         sendVerifyEmail: (data: HandlerRequestAuthEmailSend, params?: RequestParams) => Promise<HttpResponse<HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
         /**
          * @description Get all users with same email, if there are more than one user with same email, need merge
@@ -158,7 +161,7 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
          })` Internal Server Error
          */
         checkDataMerge: (params?: RequestParams) => Promise<HttpResponse<HandlerResponseAuthDataMergeCheck, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
         /**
          * @description This function is to solve the problem of multiple users with the same email address, should be called after user login and then check, and perform data merge.
@@ -179,7 +182,7 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
          })` Internal Server Error
          */
         applyDataMerge: (data: HandlerRequestAuthDataMergeApply, params?: RequestParams) => Promise<HttpResponse<HandlerResponseAuthDataMergeApply, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
     };
     cache: {
@@ -205,9 +208,9 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
          })` Forbidden
          */
         flushCache: (params?: RequestParams) => Promise<HttpResponse<HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
         /**
          * @description Cache warming helps you to pre-load the cache to improve the performance of the first request
@@ -231,9 +234,9 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
          })` Forbidden
          */
         warmUpCache: (params?: RequestParams) => Promise<HttpResponse<HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
     };
     captcha: {
@@ -251,7 +254,7 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
          })` Internal Server Error
          */
         getCaptcha: (params?: RequestParams) => Promise<HttpResponse<HandlerResponseCaptchaGet, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
         /**
          * @description Get the status of the user's captcha verification
@@ -277,7 +280,7 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
          })` Forbidden
          */
         verifyCaptcha: (data: HandlerParamsCaptchaVerify, params?: RequestParams) => Promise<HttpResponse<HandlerMap, HandlerMap & {
-            img_data?: string | undefined;
+            img_data?: string;
         }>>;
     };
     comments: {
@@ -309,19 +312,19 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
             /** The comment page_key */
             page_key: string;
             /** The scope of comments */
-            scope?: 'page' | 'user' | 'site';
+            scope?: "page" | "user" | "site";
             /** Search keywords */
             search?: string;
             /** The site name of your content scope */
             site_name?: string;
             /** Sort by condition */
-            sort_by?: 'date_asc' | 'date_desc' | 'vote';
+            sort_by?: "date_asc" | "date_desc" | "vote";
             /** Message center show type */
-            type?: 'all' | 'mentions' | 'mine' | 'pending';
+            type?: "all" | "mentions" | "mine" | "pending";
             /** Only show comments by admin */
             view_only_admin?: boolean;
         }, params?: RequestParams) => Promise<HttpResponse<HandlerResponseCommentList, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
         /**
          * @description Create a new comment
@@ -342,7 +345,7 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
          })` Internal Server Error
          */
         createComment: (comment: HandlerParamsCommentCreate, params?: RequestParams) => Promise<HttpResponse<HandlerResponseCommentCreate, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
         /**
          * @description Get the detail of a comment by comment id
@@ -362,7 +365,7 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
          })` Internal Server Error
          */
         getComment: (id: number, params?: RequestParams) => Promise<HttpResponse<HandlerResponseCommentGet, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
         /**
          * @description Update a specific comment
@@ -391,7 +394,7 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
          })` Internal Server Error
          */
         updateComment: (id: number, comment: HandlerParamsCommentUpdate, params?: RequestParams) => Promise<HttpResponse<HandlerResponseCommentUpdate, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
         /**
          * @description Delete a specific comment
@@ -416,7 +419,7 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
          })` Internal Server Error
          */
         deleteComment: (id: number, params?: RequestParams) => Promise<HttpResponse<HandlerMap, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
     };
     conf: {
@@ -444,7 +447,7 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
          })` Not Found
          */
         getSocialLoginProviders: (params?: RequestParams) => Promise<HttpResponse<HandlerResponseConfAuthProviders, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
         /**
          * @description Get Domain Info
@@ -484,7 +487,7 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
             /** The user name */
             name: string;
         }, params?: RequestParams) => Promise<HttpResponse<HandlerResponseNotifyList, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
         /**
          * @description Mark all notifies as read for user
@@ -504,7 +507,7 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
          })` Internal Server Error
          */
         markAllNotifyRead: (options: HandlerParamsNotifyReadAll, params?: RequestParams) => Promise<HttpResponse<HandlerMap, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
         /**
          * @description Mark specific notification as read for user
@@ -528,7 +531,7 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
          })` Internal Server Error
          */
         markNotifyRead: (commentId: number, notifyKey: string, params?: RequestParams) => Promise<HttpResponse<HandlerMap, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
     };
     pages: {
@@ -551,10 +554,12 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
             limit?: number;
             /** The offset for pagination */
             offset?: number;
+            /** Search keywords */
+            search?: string;
             /** The site name of your content scope */
             site_name?: string;
         }, params?: RequestParams) => Promise<HttpResponse<HandlerResponsePageList, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
         /**
          * @description Fetch the data of all pages
@@ -575,7 +580,7 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
          })` Internal Server Error
          */
         fetchAllPages: (options: HandlerParamsPageFetchAll, params?: RequestParams) => Promise<HttpResponse<HandlerMap, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
         /**
          * @description Get the status of the task of fetching all pages
@@ -625,7 +630,7 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
          })` Internal Server Error
          */
         updatePage: (id: number, page: HandlerParamsPageUpdate, params?: RequestParams) => Promise<HttpResponse<HandlerResponsePageUpdate, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
         /**
          * @description Delete a specific page
@@ -650,7 +655,7 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
          })` Internal Server Error
          */
         deletePage: (id: number, params?: RequestParams) => Promise<HttpResponse<HandlerMap, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
         /**
          * @description Fetch the data of a specific page
@@ -671,7 +676,7 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
          })` Internal Server Error
          */
         fetchPage: (id: number, params?: RequestParams) => Promise<HttpResponse<HandlerResponsePageFetch, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
     };
     sendEmail: {
@@ -691,7 +696,7 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
          * @response `500` `HandlerMap` Internal Server Error
          */
         sendEmail: (email: HandlerParamsEmailSend, params?: RequestParams) => Promise<HttpResponse<HandlerMap, HandlerMap | (HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         })>>;
     };
     settings: {
@@ -714,7 +719,7 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
          })` Internal Server Error
          */
         getSettings: (params?: RequestParams) => Promise<HttpResponse<HandlerResponseSettingGet, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
         /**
          * @description Apply settings and restart the server
@@ -735,7 +740,7 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
          })` Internal Server Error
          */
         applySettings: (settings: HandlerParamsSettingApply, params?: RequestParams) => Promise<HttpResponse<HandlerMap, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
         /**
          * @description Get config templates in different languages for rendering the settings page in the frontend
@@ -784,7 +789,7 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
          })` Internal Server Error
          */
         createSite: (site: HandlerParamsSiteCreate, params?: RequestParams) => Promise<HttpResponse<HandlerResponseSiteCreate, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
         /**
          * @description Update a specific site
@@ -820,7 +825,7 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
          })` Internal Server Error
          */
         deleteSite: (id: number, params?: RequestParams) => Promise<HttpResponse<HandlerMap, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
     };
     stats: {
@@ -849,7 +854,7 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
 
          })` Internal Server Error
          */
-        getStats: (type: 'latest_comments' | 'latest_pages' | 'pv_most_pages' | 'comment_most_pages' | 'page_pv' | 'site_pv' | 'page_comment' | 'site_comment' | 'rand_comments' | 'rand_pages', query?: {
+        getStats: (type: "latest_comments" | "latest_pages" | "pv_most_pages" | "comment_most_pages" | "page_pv" | "site_pv" | "page_comment" | "site_comment" | "rand_comments" | "rand_pages", query?: {
             /** The limit for pagination */
             limit?: number;
             /** multiple page keys separated by commas */
@@ -857,7 +862,7 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
             /** The site name of your content scope */
             site_name?: string;
         }, params?: RequestParams) => Promise<HttpResponse<CommonJSONResult, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
     };
     transfer: {
@@ -876,7 +881,7 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
          })` Internal Server Error
          */
         exportArtrans: (params?: RequestParams) => Promise<HttpResponse<HandlerResponseTransferExport, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
         /**
          * @description Import data to Artalk
@@ -913,9 +918,9 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
              */
             file: File;
         }, params?: RequestParams) => Promise<HttpResponse<HandlerResponseTransferUpload & {
-            filename?: string | undefined;
+            filename?: string;
         }, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
     };
     upload: {
@@ -948,7 +953,7 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
              */
             file: File;
         }, params?: RequestParams) => Promise<HttpResponse<HandlerResponseUpload, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
     };
     user: {
@@ -972,7 +977,28 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
             /** The username */
             name?: string;
         }, params?: RequestParams) => Promise<HttpResponse<HandlerResponseUserInfo, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
+        }>>;
+        /**
+         * @description Update user profile when user is logged in
+         *
+         * @tags Auth
+         * @name UpdateProfile
+         * @summary Update user profile
+         * @request POST:/user
+         * @secure
+         * @response `200` `HandlerResponseUserInfoUpdate` OK
+         * @response `400` `(HandlerMap & {
+         msg?: string,
+
+         })` Bad Request
+         * @response `500` `(HandlerMap & {
+         msg?: string,
+
+         })` Internal Server Error
+         */
+        updateProfile: (data: HandlerRequestUserInfoUpdate, params?: RequestParams) => Promise<HttpResponse<HandlerResponseUserInfoUpdate, HandlerMap & {
+            msg?: string;
         }>>;
         /**
          * @description Login user by name or email
@@ -1001,11 +1027,11 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
          */
         login: (user: HandlerParamsUserLogin, params?: RequestParams) => Promise<HttpResponse<HandlerResponseUserLogin, (HandlerMap & {
             data?: {
-                need_name_select?: string[] | undefined;
-            } | undefined;
-            msg?: string | undefined;
+                need_name_select?: string[];
+            };
+            msg?: string;
         }) | (HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         })>>;
         /**
          * @description Get user login status by header Authorization
@@ -1048,7 +1074,7 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
          })` Internal Server Error
          */
         createUser: (user: HandlerParamsUserCreate, params?: RequestParams) => Promise<HttpResponse<HandlerResponseUserCreate, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
         /**
          * @description Update a specific user
@@ -1077,7 +1103,7 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
          })` Internal Server Error
          */
         updateUser: (id: number, user: HandlerParamsUserUpdate, params?: RequestParams) => Promise<HttpResponse<HandlerResponseUserUpdate, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
         /**
          * @description Delete a specific user
@@ -1102,7 +1128,7 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
          })` Internal Server Error
          */
         deleteUser: (id: number, params?: RequestParams) => Promise<HttpResponse<HandlerMap, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
         /**
          * @description Get a list of users by some conditions
@@ -1118,13 +1144,15 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
 
          })` Forbidden
          */
-        getUsers: (type?: 'all' | 'admin' | 'in_conf', query?: {
+        getUsers: (type?: "all" | "admin" | "in_conf", query?: {
             /** The limit for pagination */
             limit?: number;
             /** The offset for pagination */
             offset?: number;
+            /** Search keywords */
+            search?: string;
         }, params?: RequestParams) => Promise<HttpResponse<HandlerResponseAdminUserList, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
     };
     version: {
@@ -1155,7 +1183,7 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
          })` Forbidden
          */
         syncVotes: (params?: RequestParams) => Promise<HttpResponse<HandlerMap, HandlerMap & {
-            msg?: string | undefined;
+            msg?: string;
         }>>;
         /**
          * @description Vote for a specific comment or page
@@ -1178,8 +1206,8 @@ declare class Api_2<SecurityDataType extends unknown> extends HttpClient<Securit
 
          })` Internal Server Error
          */
-        vote: (type: 'comment_up' | 'comment_down' | 'page_up' | 'page_down', targetId: number, vote: HandlerParamsVote, params?: RequestParams) => Promise<HttpResponse<HandlerResponseVote, HandlerMap & {
-            msg?: string | undefined;
+        vote: (type: "comment_up" | "comment_down" | "page_up" | "page_down", targetId: number, vote: HandlerParamsVote, params?: RequestParams) => Promise<HttpResponse<HandlerResponseVote, HandlerMap & {
+            msg?: string;
         }>>;
     };
 }
@@ -1207,6 +1235,7 @@ declare interface ApiHandlerPayload {
 
 declare interface ApiHandlers {
     add: <T extends PayloadKey>(action: T, handler: (data: ApiHandlerPayload[T]) => Promise<void>) => void;
+    remove: (action: PayloadKey) => void;
     get: () => ApiHandler[];
 }
 
@@ -1262,7 +1291,7 @@ declare class Artalk {
     /** Init Artalk */
     static init(conf: Partial<ArtalkConfig>): Artalk;
     /** Use plugin, the plugin will be used when Artalk.init */
-    static use(plugin: ArtalkPlugin): void;
+    static use<T = any>(plugin: ArtalkPlugin<T>, options?: T): void;
     /** Load count widget */
     static loadCountWidget(c: Partial<ArtalkConfig>): void;
     /** @deprecated Please use `getEl()` instead */
@@ -1365,9 +1394,15 @@ export declare interface ArtalkConfig {
     /** Replacer for marked */
     markedReplacers?: ((raw: string) => string)[];
     /** Marked options */
-    markedOptions?: any;
+    markedOptions?: MarkedOptions;
     /** 列表请求参数修改器 */
     listFetchParamsModifier?: (params: any) => void;
+    /**
+     * Date formatter for custom date format
+     * @param date - Date object
+     * @returns Formatted date string
+     */
+    dateFormatter?: (date: Date) => string;
     remoteConfModifier?: (conf: Partial<ArtalkConfig>) => void;
     listUnreadHighlight?: boolean;
     scrollRelativeTo?: () => HTMLElement;
@@ -1375,7 +1410,7 @@ export declare interface ArtalkConfig {
     beforeSubmit?: (editor: EditorApi, next: () => void) => void;
 }
 
-export declare type ArtalkPlugin = (ctx: ContextApi) => void;
+export declare type ArtalkPlugin<T = any> = (ctx: ContextApi, options?: T) => void;
 
 declare namespace ArtalkType {
     export {
@@ -1406,7 +1441,8 @@ declare namespace ArtalkType {
         ListFetchedArgs,
         EventPayloadMap,
         ArtalkPlugin,
-        SidebarShowPayload
+        SidebarShowPayload,
+        Layer
     }
 }
 export { ArtalkType }
@@ -1631,6 +1667,7 @@ declare interface CommentOptions {
     heightLimit: ArtalkConfig['heightLimit'];
     avatarURLBuilder: ArtalkConfig['avatarURLBuilder'];
     scrollRelativeTo: ArtalkConfig['scrollRelativeTo'];
+    dateFormatter: ArtalkConfig['dateFormatter'];
     getApi: () => Api;
     replyComment: ContextApi['replyComment'];
     editComment: ContextApi['editComment'];
@@ -1684,7 +1721,7 @@ export declare interface ContextApi extends EventManagerFuncs<EventPayloadMap> {
     /** 配置对象 */
     conf: ArtalkConfig;
     /** marked 依赖对象 */
-    getMarked(): any | undefined;
+    getMarked(): Marked | undefined;
     /** 获取 API 以供 HTTP 请求 */
     getApi(): Api;
     /** Get API handlers */
@@ -1774,7 +1811,7 @@ declare class Editor extends Component implements EditorApi {
     getState(): EditorState;
     constructor(ctx: ContextApi);
     getHeaderInputEls(): {
-        nick: HTMLInputElement;
+        name: HTMLInputElement;
         email: HTMLInputElement;
         link: HTMLInputElement;
     };
@@ -1888,16 +1925,13 @@ declare interface EditorEventPayloadMap {
 /**
  * Editor 插件
  */
-declare interface EditorPlug {
+declare class EditorPlug {
+    protected kit: PlugKit;
     $btn?: HTMLElement;
     $panel?: HTMLElement;
     contentTransformer?(rawContent: string): string;
     editorStateEffectWhen?: EditorState;
     editorStateEffect?(comment: CommentData): () => void;
-}
-
-declare class EditorPlug {
-    protected kit: PlugKit;
     constructor(kit: PlugKit);
     /** Use plug btn will add a btn on the bottom of editor */
     useBtn(html?: string): HTMLElement;
@@ -1917,7 +1951,7 @@ export declare type EditorState = 'reply' | 'edit' | 'normal';
 
 declare interface EditorUI extends Record<keyof typeof Sel, HTMLElement> {
     $el: HTMLElement;
-    $nick: HTMLInputElement;
+    $name: HTMLInputElement;
     $email: HTMLInputElement;
     $link: HTMLInputElement;
     $textarea: HTMLTextAreaElement;
@@ -1996,10 +2030,14 @@ declare const en: {
     cancel: string;
     msgCenter: string;
     ctrlCenter: string;
+    userProfile: string;
     noAccountPrompt: string;
     haveAccountPrompt: string;
     forgetPassword: string;
     resetPassword: string;
+    changePassword: string;
+    confirmPassword: string;
+    passwordMismatch: string;
     verificationCode: string;
     verifySend: string;
     verifyResend: string;
@@ -2008,7 +2046,7 @@ declare const en: {
     password: string;
     username: string;
     nextStep: string;
-    skipNotVerify: string;
+    skipVerify: string;
     logoutConfirm: string;
     accountMergeNotice: string;
     accountMergeSelectOne: string;
@@ -2403,6 +2441,13 @@ declare interface HandlerRequestAuthEmailSend {
     email: string;
 }
 
+declare interface HandlerRequestUserInfoUpdate {
+    code?: string;
+    email: string;
+    link?: string;
+    name: string;
+}
+
 declare interface HandlerResponseAdminUserList {
     count: number;
     users: EntityCookedUserForAdmin[];
@@ -2562,6 +2607,7 @@ declare interface HandlerResponsePageUpdate {
 }
 
 declare interface HandlerResponseSettingGet {
+    envs: string[];
     yaml: string;
 }
 
@@ -2628,6 +2674,10 @@ declare interface HandlerResponseUserInfo {
     user: EntityCookedUser;
 }
 
+declare interface HandlerResponseUserInfoUpdate {
+    user: EntityCookedUser;
+}
+
 declare interface HandlerResponseUserLogin {
     token: string;
     user: EntityCookedUser;
@@ -2690,7 +2740,17 @@ export declare type I18nKeys = keyof I18n;
 
 export declare const init: typeof Artalk.init;
 
-declare class Layer {
+export declare interface Layer {
+    show: () => void;
+    hide: () => void;
+    destroy: () => void;
+    setOnAfterHide(func: () => void): void;
+    setAllowMaskClose(allow: boolean): void;
+    getAllowMaskClose(): boolean;
+    getEl: () => HTMLElement;
+}
+
+declare class Layer_2 implements Layer {
     private $el;
     private opts;
     private allowMaskClose;
@@ -2701,15 +2761,15 @@ declare class Layer {
     getAllowMaskClose(): boolean;
     getEl(): HTMLElement;
     show(): void;
-    hide(): Promise<void>;
-    destroy(): Promise<void>;
+    hide(): void;
+    destroy(): void;
 }
 
 declare class LayerManager {
     private wrap;
     constructor(ctx: ContextApi);
     getEl(): HTMLElement;
-    create(name: string, el?: HTMLElement): Layer;
+    create(name: string, el?: HTMLElement): Layer_2;
 }
 
 declare interface LayerOptions {
@@ -2795,20 +2855,21 @@ declare namespace ListNest {
 export declare const loadCountWidget: typeof Artalk.loadCountWidget;
 
 /**
- * 本地持久化用户数据
- * @note 始终保持一层结构，不支持多层结构
+ * Local User Data (in localStorage)
+ *
+ * @note Keep flat for easy handling
  */
 export declare interface LocalUser {
-    /** 昵称 */
-    nick: string;
-    /** 邮箱 */
+    /** Username (aka. Nickname) */
+    name: string;
+    /** Email */
     email: string;
-    /** 链接 */
+    /** Link (aka. Website) */
     link: string;
-    /** TOKEN */
+    /** Token (for authorization) */
     token: string;
-    /** 是否为管理员 */
-    isAdmin: boolean;
+    /** Admin flag */
+    is_admin: boolean;
 }
 
 declare function makeNestCommentNodeList(srcData: CommentData[], sortBy?: SortByType, nestMax?: number): CommentNode_2[];
@@ -2962,7 +3023,7 @@ declare type ResponseFormat = keyof Omit<Body, 'body' | 'bodyUsed'>;
 
 declare const Sel: {
     $header: string;
-    $nick: string;
+    $name: string;
     $email: string;
     $link: string;
     $textareaWrap: string;
@@ -2993,14 +3054,14 @@ declare const services: {
 };
 
 declare class SidebarLayer extends Component {
-    layer?: Layer;
+    layer?: Layer_2;
     $header: HTMLElement;
     $closeBtn: HTMLElement;
     $iframeWrap: HTMLElement;
     $iframe?: HTMLIFrameElement;
     constructor(ctx: ContextApi);
-    /** Refresh iFrame on show */
-    private refreshOnShow;
+    /** Refresh iFrame when show */
+    private refreshWhenShow;
     /** Animation timer */
     private animTimer?;
     /** 显示 */
@@ -3063,7 +3124,7 @@ declare class User {
     /**
      * Logout
      *
-     * @description Logout will clear login status, but not clear user data (nick, email, link)
+     * @description Logout will clear login status, but not clear user data (name, email, link)
      */
     logout(): void;
     /** Check if user has filled basic data */